From 83cb70db17e10ee9c42ba5c20e5547efff6a9118 Mon Sep 17 00:00:00 2001
From: MaxOhn <ohn.m@hotmail.de>
Date: Mon, 19 Aug 2019 22:54:07 +0200
Subject: [PATCH 0001/5547] Added initial AimAssist mod

---
 osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs | 97 +++++++++++++++++++
 osu.Game.Rulesets.Osu/OsuRuleset.cs           |  1 +
 2 files changed, 98 insertions(+)
 create mode 100644 osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs b/osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs
new file mode 100644
index 0000000000..325c5d0c13
--- /dev/null
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.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 System;
+using System.Collections.Generic;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Sprites;
+using osu.Game.Rulesets.Mods;
+using osu.Game.Rulesets.Objects.Drawables;
+using osu.Game.Rulesets.Objects.Types;
+using osu.Game.Rulesets.Osu.Objects.Drawables;
+using osu.Game.Rulesets.UI;
+
+namespace osu.Game.Rulesets.Osu.Mods
+{
+    internal class OsuModAimAssist : Mod, IApplicableToDrawableHitObjects, IUpdatableByPlayfield
+    {
+        public override string Name => "AimAssist";
+        public override string Acronym => "AA";
+        public override IconUsage Icon => FontAwesome.Solid.MousePointer;
+        public override ModType Type => ModType.Fun;
+        public override string Description => "No need to chase the circle, the circle chases you";
+        public override double ScoreMultiplier => 1;
+        public override Type[] IncompatibleMods => new[] { typeof(OsuModAutopilot), typeof(OsuModAutoplay), typeof(OsuModWiggle), typeof(OsuModTransform) };
+
+        private HashSet<DrawableOsuHitObject> movingObjects = new HashSet<DrawableOsuHitObject>();
+        private int updateCounter = 0;
+
+        public void Update(Playfield playfield)
+        {
+            // Avoid crowded judgment displays
+            playfield.DisplayJudgements.Value = false;
+
+            // Object destination updated when cursor updates
+            playfield.Cursor.ActiveCursor.OnUpdate += drawableCursor =>
+            {
+                // ... every 500th cursor update iteration
+                // (lower -> potential lags ; higher -> easier to miss if cursor too fast)
+                if (updateCounter++ < 500) return;
+                updateCounter = 0;
+
+                // First move objects to new destination, then remove them from movingObjects set if they're too old
+                movingObjects.RemoveWhere(d =>
+                {
+                    var currentTime = playfield.Clock.CurrentTime;
+                    var h = d.HitObject;
+                    d.ClearTransforms();
+                    switch (d)
+                    {
+                        case DrawableHitCircle circle:
+                            d.MoveTo(drawableCursor.DrawPosition, Math.Max(0, h.StartTime - currentTime));
+                            return currentTime > h.StartTime;
+                        case DrawableSlider slider:
+
+                            // Move slider to cursor
+                            if (currentTime < h.StartTime)
+                                d.MoveTo(drawableCursor.DrawPosition, Math.Max(0, h.StartTime - currentTime));
+
+                            // Move slider so that sliderball stays on the cursor
+                            else
+                                d.MoveTo(drawableCursor.DrawPosition - slider.Ball.DrawPosition, Math.Max(0, h.StartTime - currentTime));
+                            return currentTime > (h as IHasEndTime).EndTime - 50;
+                        case DrawableSpinner spinner:
+                            // TODO
+                            return true;
+                    }
+                    return true; // never happens(?)
+                });
+            };
+        }
+
+        public void ApplyToDrawableHitObjects(IEnumerable<DrawableHitObject> drawables)
+        {
+            foreach (var drawable in drawables)
+                drawable.ApplyCustomUpdateState += drawableOnApplyCustomUpdateState;
+        }
+
+        private void drawableOnApplyCustomUpdateState(DrawableHitObject drawable, ArmedState state)
+        {
+            if (!(drawable is DrawableOsuHitObject d))
+                return;
+            var h = d.HitObject;
+            using (d.BeginAbsoluteSequence(h.StartTime - h.TimePreempt))
+                movingObjects.Add(d);
+        }
+    }
+
+    /*
+     * TODOs
+     *  - remove object timing glitches / artifacts
+     *  - remove FollowPoints
+     *  - automate sliders
+     *  - combine with OsuModRelax (?)
+     *  - must be some way to make this more effictient
+     *
+     */
+}
diff --git a/osu.Game.Rulesets.Osu/OsuRuleset.cs b/osu.Game.Rulesets.Osu/OsuRuleset.cs
index d50d4f401c..9dbc144501 100644
--- a/osu.Game.Rulesets.Osu/OsuRuleset.cs
+++ b/osu.Game.Rulesets.Osu/OsuRuleset.cs
@@ -136,6 +136,7 @@ namespace osu.Game.Rulesets.Osu
                         new OsuModSpinIn(),
                         new MultiMod(new OsuModGrow(), new OsuModDeflate()),
                         new MultiMod(new ModWindUp(), new ModWindDown()),
+                        new OsuModAimAssist(),
                     };
 
                 case ModType.System:

From 3434458e0a2119e1ee3171b96186f1b2cc4a0a53 Mon Sep 17 00:00:00 2001
From: MaxOhn <ohn.m@hotmail.de>
Date: Mon, 19 Aug 2019 23:51:47 +0200
Subject: [PATCH 0002/5547] Minor formatting changes

---
 osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs | 19 +++++++++++++------
 1 file changed, 13 insertions(+), 6 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs b/osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs
index 325c5d0c13..26f0d64a5d 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs
@@ -23,8 +23,8 @@ namespace osu.Game.Rulesets.Osu.Mods
         public override double ScoreMultiplier => 1;
         public override Type[] IncompatibleMods => new[] { typeof(OsuModAutopilot), typeof(OsuModAutoplay), typeof(OsuModWiggle), typeof(OsuModTransform) };
 
-        private HashSet<DrawableOsuHitObject> movingObjects = new HashSet<DrawableOsuHitObject>();
-        private int updateCounter = 0;
+        private readonly HashSet<DrawableOsuHitObject> movingObjects = new HashSet<DrawableOsuHitObject>();
+        private int updateCounter;
 
         public void Update(Playfield playfield)
         {
@@ -36,7 +36,9 @@ namespace osu.Game.Rulesets.Osu.Mods
             {
                 // ... every 500th cursor update iteration
                 // (lower -> potential lags ; higher -> easier to miss if cursor too fast)
-                if (updateCounter++ < 500) return;
+                if (updateCounter++ < 500)
+                    return;
+
                 updateCounter = 0;
 
                 // First move objects to new destination, then remove them from movingObjects set if they're too old
@@ -45,11 +47,13 @@ namespace osu.Game.Rulesets.Osu.Mods
                     var currentTime = playfield.Clock.CurrentTime;
                     var h = d.HitObject;
                     d.ClearTransforms();
+
                     switch (d)
                     {
                         case DrawableHitCircle circle:
-                            d.MoveTo(drawableCursor.DrawPosition, Math.Max(0, h.StartTime - currentTime));
+                            circle.MoveTo(drawableCursor.DrawPosition, Math.Max(0, h.StartTime - currentTime));
                             return currentTime > h.StartTime;
+
                         case DrawableSlider slider:
 
                             // Move slider to cursor
@@ -59,11 +63,13 @@ namespace osu.Game.Rulesets.Osu.Mods
                             // Move slider so that sliderball stays on the cursor
                             else
                                 d.MoveTo(drawableCursor.DrawPosition - slider.Ball.DrawPosition, Math.Max(0, h.StartTime - currentTime));
-                            return currentTime > (h as IHasEndTime).EndTime - 50;
-                        case DrawableSpinner spinner:
+                            return currentTime > (h as IHasEndTime)?.EndTime - 50;
+
+                        case DrawableSpinner _:
                             // TODO
                             return true;
                     }
+
                     return true; // never happens(?)
                 });
             };
@@ -79,6 +85,7 @@ namespace osu.Game.Rulesets.Osu.Mods
         {
             if (!(drawable is DrawableOsuHitObject d))
                 return;
+
             var h = d.HitObject;
             using (d.BeginAbsoluteSequence(h.StartTime - h.TimePreempt))
                 movingObjects.Add(d);

From 28f78f67b237a952bb403fb802640b7c4d8c47b3 Mon Sep 17 00:00:00 2001
From: MaxOhn <ohn.m@hotmail.de>
Date: Tue, 20 Aug 2019 16:33:56 +0200
Subject: [PATCH 0003/5547] No longer subscribing to OnUpdate

---
 osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs | 70 ++++++++-----------
 1 file changed, 28 insertions(+), 42 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs b/osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs
index 26f0d64a5d..8d0c1fdcfe 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs
@@ -15,7 +15,7 @@ namespace osu.Game.Rulesets.Osu.Mods
 {
     internal class OsuModAimAssist : Mod, IApplicableToDrawableHitObjects, IUpdatableByPlayfield
     {
-        public override string Name => "AimAssist";
+        public override string Name => "Aim Assist";
         public override string Acronym => "AA";
         public override IconUsage Icon => FontAwesome.Solid.MousePointer;
         public override ModType Type => ModType.Fun;
@@ -24,55 +24,45 @@ namespace osu.Game.Rulesets.Osu.Mods
         public override Type[] IncompatibleMods => new[] { typeof(OsuModAutopilot), typeof(OsuModAutoplay), typeof(OsuModWiggle), typeof(OsuModTransform) };
 
         private readonly HashSet<DrawableOsuHitObject> movingObjects = new HashSet<DrawableOsuHitObject>();
-        private int updateCounter;
 
         public void Update(Playfield playfield)
         {
+            var drawableCursor = playfield.Cursor.ActiveCursor;
+
             // Avoid crowded judgment displays
             playfield.DisplayJudgements.Value = false;
 
-            // Object destination updated when cursor updates
-            playfield.Cursor.ActiveCursor.OnUpdate += drawableCursor =>
+            // First move objects to new destination, then remove them from movingObjects set if they're too old
+            movingObjects.RemoveWhere(d =>
             {
-                // ... every 500th cursor update iteration
-                // (lower -> potential lags ; higher -> easier to miss if cursor too fast)
-                if (updateCounter++ < 500)
-                    return;
+                var currentTime = playfield.Clock.CurrentTime;
+                var h = d.HitObject;
 
-                updateCounter = 0;
-
-                // First move objects to new destination, then remove them from movingObjects set if they're too old
-                movingObjects.RemoveWhere(d =>
+                switch (d)
                 {
-                    var currentTime = playfield.Clock.CurrentTime;
-                    var h = d.HitObject;
-                    d.ClearTransforms();
+                    case DrawableHitCircle circle:
+                        circle.MoveTo(drawableCursor.DrawPosition, Math.Max(0, h.StartTime - currentTime - 10));
+                        return currentTime > h.StartTime;
 
-                    switch (d)
-                    {
-                        case DrawableHitCircle circle:
-                            circle.MoveTo(drawableCursor.DrawPosition, Math.Max(0, h.StartTime - currentTime));
-                            return currentTime > h.StartTime;
+                    case DrawableSlider slider:
 
-                        case DrawableSlider slider:
+                        // Move slider to cursor
+                        if (currentTime < h.StartTime)
+                            d.MoveTo(drawableCursor.DrawPosition, Math.Max(0, h.StartTime - currentTime - 10));
 
-                            // Move slider to cursor
-                            if (currentTime < h.StartTime)
-                                d.MoveTo(drawableCursor.DrawPosition, Math.Max(0, h.StartTime - currentTime));
+                        // Move slider so that sliderball stays on the cursor
+                        else
+                            d.MoveTo(drawableCursor.DrawPosition - slider.Ball.DrawPosition);
+                        return currentTime > (h as IHasEndTime)?.EndTime;
 
-                            // Move slider so that sliderball stays on the cursor
-                            else
-                                d.MoveTo(drawableCursor.DrawPosition - slider.Ball.DrawPosition, Math.Max(0, h.StartTime - currentTime));
-                            return currentTime > (h as IHasEndTime)?.EndTime - 50;
+                    case DrawableSpinner _:
+                        // TODO
+                        return true;
 
-                        case DrawableSpinner _:
-                            // TODO
-                            return true;
-                    }
-
-                    return true; // never happens(?)
-                });
-            };
+                    default:
+                        return true;
+                }
+            });
         }
 
         public void ApplyToDrawableHitObjects(IEnumerable<DrawableHitObject> drawables)
@@ -83,11 +73,7 @@ namespace osu.Game.Rulesets.Osu.Mods
 
         private void drawableOnApplyCustomUpdateState(DrawableHitObject drawable, ArmedState state)
         {
-            if (!(drawable is DrawableOsuHitObject d))
-                return;
-
-            var h = d.HitObject;
-            using (d.BeginAbsoluteSequence(h.StartTime - h.TimePreempt))
+            if (drawable is DrawableOsuHitObject d)
                 movingObjects.Add(d);
         }
     }
@@ -96,7 +82,7 @@ namespace osu.Game.Rulesets.Osu.Mods
      * TODOs
      *  - remove object timing glitches / artifacts
      *  - remove FollowPoints
-     *  - automate sliders
+     *  - automate spinners
      *  - combine with OsuModRelax (?)
      *  - must be some way to make this more effictient
      *

From 30f923edde9987bfcfbe866f9bf5258dfdb5b8bf Mon Sep 17 00:00:00 2001
From: MaxOhn <ohn.m@hotmail.de>
Date: Tue, 20 Aug 2019 17:23:50 +0200
Subject: [PATCH 0004/5547] Hiding follow points

---
 osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs | 6 +++---
 osu.Game.Rulesets.Osu/UI/OsuPlayfield.cs      | 6 +++---
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs b/osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs
index 8d0c1fdcfe..54c80525bf 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs
@@ -10,6 +10,7 @@ using osu.Game.Rulesets.Objects.Drawables;
 using osu.Game.Rulesets.Objects.Types;
 using osu.Game.Rulesets.Osu.Objects.Drawables;
 using osu.Game.Rulesets.UI;
+using osu.Game.Rulesets.Osu.UI;
 
 namespace osu.Game.Rulesets.Osu.Mods
 {
@@ -29,8 +30,9 @@ namespace osu.Game.Rulesets.Osu.Mods
         {
             var drawableCursor = playfield.Cursor.ActiveCursor;
 
-            // Avoid crowded judgment displays
+            // Avoid crowded judgment displays and hide follow points
             playfield.DisplayJudgements.Value = false;
+            (playfield as OsuPlayfield)?.ConnectionLayer.Hide();
 
             // First move objects to new destination, then remove them from movingObjects set if they're too old
             movingObjects.RemoveWhere(d =>
@@ -81,10 +83,8 @@ namespace osu.Game.Rulesets.Osu.Mods
     /*
      * TODOs
      *  - remove object timing glitches / artifacts
-     *  - remove FollowPoints
      *  - automate spinners
      *  - combine with OsuModRelax (?)
-     *  - must be some way to make this more effictient
      *
      */
 }
diff --git a/osu.Game.Rulesets.Osu/UI/OsuPlayfield.cs b/osu.Game.Rulesets.Osu/UI/OsuPlayfield.cs
index 9037faf606..64620d3629 100644
--- a/osu.Game.Rulesets.Osu/UI/OsuPlayfield.cs
+++ b/osu.Game.Rulesets.Osu/UI/OsuPlayfield.cs
@@ -20,7 +20,7 @@ namespace osu.Game.Rulesets.Osu.UI
     {
         private readonly ApproachCircleProxyContainer approachCircles;
         private readonly JudgementContainer<DrawableOsuJudgement> judgementLayer;
-        private readonly ConnectionRenderer<OsuHitObject> connectionLayer;
+        public readonly ConnectionRenderer<OsuHitObject> ConnectionLayer;
 
         public static readonly Vector2 BASE_SIZE = new Vector2(512, 384);
 
@@ -30,7 +30,7 @@ namespace osu.Game.Rulesets.Osu.UI
         {
             InternalChildren = new Drawable[]
             {
-                connectionLayer = new FollowPointRenderer
+                ConnectionLayer = new FollowPointRenderer
                 {
                     RelativeSizeAxes = Axes.Both,
                     Depth = 2,
@@ -81,7 +81,7 @@ namespace osu.Game.Rulesets.Osu.UI
 
         public override void PostProcess()
         {
-            connectionLayer.HitObjects = HitObjectContainer.Objects.Select(d => d.HitObject).OfType<OsuHitObject>();
+            ConnectionLayer.HitObjects = HitObjectContainer.Objects.Select(d => d.HitObject).OfType<OsuHitObject>();
         }
 
         private void onNewResult(DrawableHitObject judgedObject, JudgementResult result)

From d4d348390a6ce2dfac7638d61b8800e5439dceaf Mon Sep 17 00:00:00 2001
From: MaxOhn <ohn.m@hotmail.de>
Date: Tue, 20 Aug 2019 23:18:57 +0200
Subject: [PATCH 0005/5547] Change set to list + minor changes

---
 osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs | 39 ++++++++++++-------
 1 file changed, 24 insertions(+), 15 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs b/osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs
index 54c80525bf..1101b93ed1 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs
@@ -24,38 +24,46 @@ namespace osu.Game.Rulesets.Osu.Mods
         public override double ScoreMultiplier => 1;
         public override Type[] IncompatibleMods => new[] { typeof(OsuModAutopilot), typeof(OsuModAutoplay), typeof(OsuModWiggle), typeof(OsuModTransform) };
 
-        private readonly HashSet<DrawableOsuHitObject> movingObjects = new HashSet<DrawableOsuHitObject>();
+        private readonly List<DrawableOsuHitObject> movingObjects = new List<DrawableOsuHitObject>();
 
         public void Update(Playfield playfield)
         {
-            var drawableCursor = playfield.Cursor.ActiveCursor;
+            var cursorPos = playfield.Cursor.ActiveCursor.DrawPosition;
 
-            // Avoid crowded judgment displays and hide follow points
+            // Avoid relocating judgment displays and hide follow points
             playfield.DisplayJudgements.Value = false;
             (playfield as OsuPlayfield)?.ConnectionLayer.Hide();
 
-            // First move objects to new destination, then remove them from movingObjects set if they're too old
-            movingObjects.RemoveWhere(d =>
+            // First move objects to new destination, then remove them from movingObjects list if they're too old
+            movingObjects.RemoveAll(d =>
             {
-                var currentTime = playfield.Clock.CurrentTime;
                 var h = d.HitObject;
+                var currentTime = playfield.Clock.CurrentTime;
+                var endTime = (h as IHasEndTime)?.EndTime ?? h.StartTime;
+                d.ClearTransforms();
 
                 switch (d)
                 {
                     case DrawableHitCircle circle:
-                        circle.MoveTo(drawableCursor.DrawPosition, Math.Max(0, h.StartTime - currentTime - 10));
-                        return currentTime > h.StartTime;
+
+                        // 10ms earlier on the note to reduce chance of missing when clicking early / cursor moves fast
+                        circle.MoveTo(cursorPos, Math.Max(0, endTime - currentTime - 10));
+                        return currentTime > endTime;
 
                     case DrawableSlider slider:
 
                         // Move slider to cursor
                         if (currentTime < h.StartTime)
-                            d.MoveTo(drawableCursor.DrawPosition, Math.Max(0, h.StartTime - currentTime - 10));
-
+                        {
+                            slider.MoveTo(cursorPos, Math.Max(0, h.StartTime - currentTime - 10));
+                            return false;
+                        }
                         // Move slider so that sliderball stays on the cursor
                         else
-                            d.MoveTo(drawableCursor.DrawPosition - slider.Ball.DrawPosition);
-                        return currentTime > (h as IHasEndTime)?.EndTime;
+                        {
+                            slider.MoveTo(cursorPos - slider.Ball.DrawPosition);
+                            return currentTime > endTime;
+                        }
 
                     case DrawableSpinner _:
                         // TODO
@@ -75,14 +83,15 @@ namespace osu.Game.Rulesets.Osu.Mods
 
         private void drawableOnApplyCustomUpdateState(DrawableHitObject drawable, ArmedState state)
         {
-            if (drawable is DrawableOsuHitObject d)
-                movingObjects.Add(d);
+            if (drawable is DrawableOsuHitObject hitobject)
+                movingObjects.Add(hitobject);
         }
     }
 
     /*
      * TODOs
-     *  - remove object timing glitches / artifacts
+     *  - fix sliders reappearing at original position after their EndTime (see https://puu.sh/E7zT4/111cf9cdc8.gif)
+     *  - relocate / hide slider headcircle's explosion, flash, ...
      *  - automate spinners
      *  - combine with OsuModRelax (?)
      *

From 4cd5eb783a017f53682291aaa61eb32e91b72bd9 Mon Sep 17 00:00:00 2001
From: MaxOhn <ohn.m@hotmail.de>
Date: Wed, 21 Aug 2019 21:37:56 +0200
Subject: [PATCH 0006/5547] Add spinner automation

---
 osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs | 64 +++++++++++++++----
 osu.Game.Rulesets.Osu/Mods/OsuModAutopilot.cs |  2 +-
 osu.Game.Rulesets.Osu/Mods/OsuModTransform.cs |  2 +-
 osu.Game.Rulesets.Osu/Mods/OsuModWiggle.cs    |  2 +-
 4 files changed, 54 insertions(+), 16 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs b/osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs
index 1101b93ed1..f70ad2ac7c 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs
@@ -11,6 +11,7 @@ using osu.Game.Rulesets.Objects.Types;
 using osu.Game.Rulesets.Osu.Objects.Drawables;
 using osu.Game.Rulesets.UI;
 using osu.Game.Rulesets.Osu.UI;
+using osuTK;
 
 namespace osu.Game.Rulesets.Osu.Mods
 {
@@ -22,25 +23,30 @@ namespace osu.Game.Rulesets.Osu.Mods
         public override ModType Type => ModType.Fun;
         public override string Description => "No need to chase the circle, the circle chases you";
         public override double ScoreMultiplier => 1;
-        public override Type[] IncompatibleMods => new[] { typeof(OsuModAutopilot), typeof(OsuModAutoplay), typeof(OsuModWiggle), typeof(OsuModTransform) };
+        public override Type[] IncompatibleMods => new[] { typeof(OsuModAutopilot), typeof(OsuModWiggle), typeof(OsuModTransform), typeof(ModAutoplay) };
 
         private readonly List<DrawableOsuHitObject> movingObjects = new List<DrawableOsuHitObject>();
+        private DrawableSpinner activeSpinner;
+        private double spinnerAngle; // in radians
 
         public void Update(Playfield playfield)
         {
             var cursorPos = playfield.Cursor.ActiveCursor.DrawPosition;
+            var currentTime = playfield.Clock.CurrentTime;
 
             // Avoid relocating judgment displays and hide follow points
             playfield.DisplayJudgements.Value = false;
             (playfield as OsuPlayfield)?.ConnectionLayer.Hide();
 
-            // First move objects to new destination, then remove them from movingObjects list if they're too old
+            // If object too old, remove from movingObjects list, otherwise move to new destination
             movingObjects.RemoveAll(d =>
             {
                 var h = d.HitObject;
-                var currentTime = playfield.Clock.CurrentTime;
                 var endTime = (h as IHasEndTime)?.EndTime ?? h.StartTime;
-                d.ClearTransforms();
+
+                // Object no longer required to be moved -> remove from list
+                if (currentTime > endTime)
+                    return true;
 
                 switch (d)
                 {
@@ -48,7 +54,7 @@ namespace osu.Game.Rulesets.Osu.Mods
 
                         // 10ms earlier on the note to reduce chance of missing when clicking early / cursor moves fast
                         circle.MoveTo(cursorPos, Math.Max(0, endTime - currentTime - 10));
-                        return currentTime > endTime;
+                        return false;
 
                     case DrawableSlider slider:
 
@@ -56,23 +62,56 @@ namespace osu.Game.Rulesets.Osu.Mods
                         if (currentTime < h.StartTime)
                         {
                             slider.MoveTo(cursorPos, Math.Max(0, h.StartTime - currentTime - 10));
-                            return false;
                         }
                         // Move slider so that sliderball stays on the cursor
                         else
                         {
+                            slider.HeadCircle.Hide(); // temporary solution to supress HeadCircle's explosion, flash, ... at wrong location
                             slider.MoveTo(cursorPos - slider.Ball.DrawPosition);
-                            return currentTime > endTime;
                         }
 
-                    case DrawableSpinner _:
-                        // TODO
-                        return true;
+                        return false;
+
+                    case DrawableSpinner spinner:
+
+                        // Move spinner to cursor
+                        if (currentTime < h.StartTime)
+                        {
+                            spinner.MoveTo(cursorPos, Math.Max(0, h.StartTime - currentTime - 10));
+                            return false;
+                        }
+                        else
+                        {
+                            spinnerAngle = 0;
+                            activeSpinner = spinner;
+                            return true;
+                        }
 
                     default:
                         return true;
                 }
             });
+
+            if (activeSpinner != null)
+            {
+                if (currentTime > (activeSpinner.HitObject as IHasEndTime)?.EndTime)
+                {
+                    activeSpinner = null;
+                    spinnerAngle = 0;
+                }
+                else
+                {
+                    const float additional_degrees = 4;
+                    const int dist_from_cursor = 30;
+                    spinnerAngle += additional_degrees * Math.PI / 180;
+
+                    // Visual progress
+                    activeSpinner.MoveTo(new Vector2((float)(dist_from_cursor * Math.Cos(spinnerAngle) + cursorPos.X), (float)(dist_from_cursor * Math.Sin(spinnerAngle) + cursorPos.Y)));
+
+                    // Logical progress
+                    activeSpinner.Disc.RotationAbsolute += additional_degrees;
+                }
+            }
         }
 
         public void ApplyToDrawableHitObjects(IEnumerable<DrawableHitObject> drawables)
@@ -91,9 +130,8 @@ namespace osu.Game.Rulesets.Osu.Mods
     /*
      * TODOs
      *  - fix sliders reappearing at original position after their EndTime (see https://puu.sh/E7zT4/111cf9cdc8.gif)
-     *  - relocate / hide slider headcircle's explosion, flash, ...
-     *  - automate spinners
-     *  - combine with OsuModRelax (?)
+     *  - find nicer way to handle slider headcircle explosion, flash, ...
+     *  - add Aim Assist as incompatible mod for Autoplay (?)
      *
      */
 }
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModAutopilot.cs b/osu.Game.Rulesets.Osu/Mods/OsuModAutopilot.cs
index ca72f18e9c..0757547d1c 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModAutopilot.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModAutopilot.cs
@@ -22,7 +22,7 @@ namespace osu.Game.Rulesets.Osu.Mods
         public override ModType Type => ModType.Automation;
         public override string Description => @"Automatic cursor movement - just follow the rhythm.";
         public override double ScoreMultiplier => 1;
-        public override Type[] IncompatibleMods => new[] { typeof(OsuModSpunOut), typeof(ModRelax), typeof(ModSuddenDeath), typeof(ModNoFail), typeof(ModAutoplay) };
+        public override Type[] IncompatibleMods => new[] { typeof(OsuModSpunOut), typeof(ModRelax), typeof(ModSuddenDeath), typeof(ModNoFail), typeof(ModAutoplay), typeof(OsuModAimAssist) };
 
         public bool AllowFail => false;
 
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModTransform.cs b/osu.Game.Rulesets.Osu/Mods/OsuModTransform.cs
index 9b079895fa..7799cdac32 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModTransform.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModTransform.cs
@@ -20,7 +20,7 @@ namespace osu.Game.Rulesets.Osu.Mods
         public override ModType Type => ModType.Fun;
         public override string Description => "Everything rotates. EVERYTHING.";
         public override double ScoreMultiplier => 1;
-        public override Type[] IncompatibleMods => new[] { typeof(OsuModWiggle) };
+        public override Type[] IncompatibleMods => new[] { typeof(OsuModWiggle), typeof(OsuModAimAssist) };
 
         private float theta;
 
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModWiggle.cs b/osu.Game.Rulesets.Osu/Mods/OsuModWiggle.cs
index 17fcd03dd5..a14fd88ff5 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModWiggle.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModWiggle.cs
@@ -21,7 +21,7 @@ namespace osu.Game.Rulesets.Osu.Mods
         public override ModType Type => ModType.Fun;
         public override string Description => "They just won't stay still...";
         public override double ScoreMultiplier => 1;
-        public override Type[] IncompatibleMods => new[] { typeof(OsuModTransform) };
+        public override Type[] IncompatibleMods => new[] { typeof(OsuModTransform), typeof(OsuModAimAssist) };
 
         private const int wiggle_duration = 90; // (ms) Higher = fewer wiggles
         private const int wiggle_strength = 10; // Higher = stronger wiggles

From 508b26ac6973a07a7edb6870ec13e065b055a21c Mon Sep 17 00:00:00 2001
From: Andrei Zavatski <megaman9919@gmail.com>
Date: Sat, 7 Sep 2019 07:31:07 +0300
Subject: [PATCH 0007/5547] Implement basic layout

---
 .../UserInterface/TestScenePageSelector.cs    |  29 +++++
 .../Graphics/UserInterface/PageSelector.cs    | 100 ++++++++++++++++++
 2 files changed, 129 insertions(+)
 create mode 100644 osu.Game.Tests/Visual/UserInterface/TestScenePageSelector.cs
 create mode 100644 osu.Game/Graphics/UserInterface/PageSelector.cs

diff --git a/osu.Game.Tests/Visual/UserInterface/TestScenePageSelector.cs b/osu.Game.Tests/Visual/UserInterface/TestScenePageSelector.cs
new file mode 100644
index 0000000000..9911a23bf1
--- /dev/null
+++ b/osu.Game.Tests/Visual/UserInterface/TestScenePageSelector.cs
@@ -0,0 +1,29 @@
+// 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.Game.Graphics.UserInterface;
+using osu.Framework.Graphics;
+
+namespace osu.Game.Tests.Visual.UserInterface
+{
+    public class TestScenePageSelector : OsuTestScene
+    {
+        public override IReadOnlyList<Type> RequiredTypes => new[]
+        {
+            typeof(PageSelector)
+        };
+
+        public TestScenePageSelector()
+        {
+            PageSelector pageSelector;
+
+            Child = pageSelector = new PageSelector(10)
+            {
+                Anchor = Anchor.Centre,
+                Origin = Anchor.Centre,
+            };
+        }
+    }
+}
diff --git a/osu.Game/Graphics/UserInterface/PageSelector.cs b/osu.Game/Graphics/UserInterface/PageSelector.cs
new file mode 100644
index 0000000000..53f112ed68
--- /dev/null
+++ b/osu.Game/Graphics/UserInterface/PageSelector.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 osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics;
+using osu.Game.Graphics.Containers;
+using osu.Framework.Bindables;
+using osu.Framework.Allocation;
+using osu.Framework.Graphics.Shapes;
+using osu.Framework.Graphics.Sprites;
+
+namespace osu.Game.Graphics.UserInterface
+{
+    public class PageSelector : CompositeDrawable
+    {
+        private BindableInt currentPage = new BindableInt(1);
+
+        private readonly int maxPages;
+        private readonly FillFlowContainer pillsFlow;
+
+        public PageSelector(int maxPages)
+        {
+            this.maxPages = maxPages;
+
+            AutoSizeAxes = Axes.Both;
+            InternalChild = pillsFlow = new FillFlowContainer
+            {
+                AutoSizeAxes = Axes.X,
+                RelativeSizeAxes = Axes.Y,
+                Direction = FillDirection.Horizontal,
+            };
+        }
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            currentPage.BindValueChanged(page => redraw(page.NewValue), true);
+        }
+
+        private void redraw(int newPage)
+        {
+            pillsFlow.Clear();
+
+            for (int i = 0; i < maxPages; i++)
+            {
+                addPagePill(i);
+            }
+        }
+
+        private void addPagePill(int page)
+        {
+            var pill = new Pill(page);
+
+            if (page != currentPage.Value)
+                pill.Action = () => currentPage.Value = page;
+
+            pillsFlow.Add(pill);
+        }
+
+        private class Pill : OsuClickableContainer
+        {
+            private const int height = 20;
+
+            private readonly Box background;
+
+            public Pill(int page)
+            {
+                AutoSizeAxes = Axes.X;
+                Height = height;
+                Child = new CircularContainer
+                {
+                    AutoSizeAxes = Axes.X,
+                    RelativeSizeAxes = Axes.Y,
+                    Masking = true,
+                    Children = new Drawable[]
+                    {
+                        background = new Box
+                        {
+                            RelativeSizeAxes = Axes.Both,
+                        },
+                        new SpriteText
+                        {
+                            Anchor = Anchor.Centre,
+                            Origin = Anchor.Centre,
+                            Text = page.ToString(),
+                            Margin = new MarginPadding { Horizontal = 8 }
+                        }
+                    }
+                };
+            }
+
+            [BackgroundDependencyLoader]
+            private void load(OsuColour colours)
+            {
+                background.Colour = colours.Seafoam;
+            }
+        }
+    }
+}

From f77cd6582d94811874d74315265d4e91b5f81321 Mon Sep 17 00:00:00 2001
From: Andrei Zavatski <megaman9919@gmail.com>
Date: Sat, 7 Sep 2019 08:20:09 +0300
Subject: [PATCH 0008/5547] Implement CurrentPage class

---
 .../Graphics/UserInterface/PageSelector.cs    | 150 ++++++++++++++----
 1 file changed, 119 insertions(+), 31 deletions(-)

diff --git a/osu.Game/Graphics/UserInterface/PageSelector.cs b/osu.Game/Graphics/UserInterface/PageSelector.cs
index 53f112ed68..fef35ab229 100644
--- a/osu.Game/Graphics/UserInterface/PageSelector.cs
+++ b/osu.Game/Graphics/UserInterface/PageSelector.cs
@@ -8,6 +8,9 @@ using osu.Framework.Bindables;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Graphics.Sprites;
+using osu.Framework.Input.Events;
+using osu.Framework.Extensions.Color4Extensions;
+using System;
 
 namespace osu.Game.Graphics.UserInterface
 {
@@ -42,59 +45,144 @@ namespace osu.Game.Graphics.UserInterface
         {
             pillsFlow.Clear();
 
-            for (int i = 0; i < maxPages; i++)
+            for (int i = 1; i <= maxPages; i++)
             {
-                addPagePill(i);
+                if (i == currentPage.Value)
+                    addCurrentPagePill();
+                else
+                    addPagePill(i);
             }
         }
 
         private void addPagePill(int page)
         {
-            var pill = new Pill(page);
-
-            if (page != currentPage.Value)
-                pill.Action = () => currentPage.Value = page;
-
-            pillsFlow.Add(pill);
+            pillsFlow.Add(new Page(page.ToString(), () => currentPage.Value = page));
         }
 
-        private class Pill : OsuClickableContainer
+        private void addCurrentPagePill()
+        {
+            pillsFlow.Add(new CurrentPage(currentPage.Value.ToString()));
+        }
+
+        private abstract class DrawablePage : CompositeDrawable
         {
             private const int height = 20;
+            private const int margin = 8;
 
-            private readonly Box background;
+            protected readonly string Text;
 
-            public Pill(int page)
+            protected DrawablePage(string text)
             {
+                Text = text;
+
                 AutoSizeAxes = Axes.X;
                 Height = height;
-                Child = new CircularContainer
-                {
-                    AutoSizeAxes = Axes.X,
-                    RelativeSizeAxes = Axes.Y,
-                    Masking = true,
-                    Children = new Drawable[]
-                    {
-                        background = new Box
-                        {
-                            RelativeSizeAxes = Axes.Both,
-                        },
-                        new SpriteText
-                        {
-                            Anchor = Anchor.Centre,
-                            Origin = Anchor.Centre,
-                            Text = page.ToString(),
-                            Margin = new MarginPadding { Horizontal = 8 }
-                        }
-                    }
-                };
+
+                var background = CreateBackground();
+
+                if (background != null)
+                    AddInternal(background);
+
+                var content = CreateContent();
+                content.Margin = new MarginPadding { Horizontal = margin };
+
+                AddInternal(content);
+            }
+
+            protected abstract Drawable CreateContent();
+
+            protected virtual Drawable CreateBackground() => null;
+        }
+
+        private abstract class ActivatedDrawablePage : DrawablePage
+        {
+            private readonly Action action;
+
+            public ActivatedDrawablePage(string text, Action action)
+                : base(text)
+            {
+                this.action = action;
+            }
+
+            protected override bool OnClick(ClickEvent e)
+            {
+                action?.Invoke();
+                return base.OnClick(e);
+            }
+        }
+
+        private class Page : ActivatedDrawablePage
+        {
+            private SpriteText text;
+
+            private OsuColour colours;
+
+            public Page(string text, Action action)
+                : base(text, action)
+            {
             }
 
             [BackgroundDependencyLoader]
             private void load(OsuColour colours)
             {
+                this.colours = colours;
+                text.Colour = colours.Seafoam;
+            }
+
+            protected override bool OnHover(HoverEvent e)
+            {
+                text.Colour = colours.Seafoam.Lighten(30f);
+                return base.OnHover(e);
+            }
+
+            protected override void OnHoverLost(HoverLostEvent e)
+            {
+                text.Colour = colours.Seafoam;
+                base.OnHoverLost(e);
+            }
+
+            protected override Drawable CreateContent() => text = new SpriteText
+            {
+                Anchor = Anchor.Centre,
+                Origin = Anchor.Centre,
+                Text = Text
+            };
+        }
+
+        private class CurrentPage : DrawablePage
+        {
+            private SpriteText text;
+
+            private Box background;
+
+            public CurrentPage(string text)
+                : base(text)
+            {
+            }
+
+            [BackgroundDependencyLoader]
+            private void load(OsuColour colours)
+            {
+                text.Colour = colours.GreySeafoam;
                 background.Colour = colours.Seafoam;
             }
+
+            protected override Drawable CreateContent() => text = new SpriteText
+            {
+                Anchor = Anchor.Centre,
+                Origin = Anchor.Centre,
+                Text = Text
+            };
+
+            protected override Drawable CreateBackground() => new CircularContainer
+            {
+                RelativeSizeAxes = Axes.Both,
+                Masking = true,
+                Child = background = new Box
+                {
+                    RelativeSizeAxes = Axes.Both,
+                }
+            };
         }
     }
 }

From cea26baaefb58171ca76b1b3b39a70772d8eb7a5 Mon Sep 17 00:00:00 2001
From: Andrei Zavatski <megaman9919@gmail.com>
Date: Sat, 7 Sep 2019 08:46:16 +0300
Subject: [PATCH 0009/5547] Implement placeholder and correct redraw algorithm

---
 .../UserInterface/TestScenePageSelector.cs    |  4 +-
 .../Graphics/UserInterface/PageSelector.cs    | 63 +++++++++++++++----
 2 files changed, 52 insertions(+), 15 deletions(-)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestScenePageSelector.cs b/osu.Game.Tests/Visual/UserInterface/TestScenePageSelector.cs
index 9911a23bf1..e5efa65c91 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestScenePageSelector.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestScenePageSelector.cs
@@ -17,9 +17,7 @@ namespace osu.Game.Tests.Visual.UserInterface
 
         public TestScenePageSelector()
         {
-            PageSelector pageSelector;
-
-            Child = pageSelector = new PageSelector(10)
+            Child = new PageSelector(200)
             {
                 Anchor = Anchor.Centre,
                 Origin = Anchor.Centre,
diff --git a/osu.Game/Graphics/UserInterface/PageSelector.cs b/osu.Game/Graphics/UserInterface/PageSelector.cs
index fef35ab229..244e87f023 100644
--- a/osu.Game/Graphics/UserInterface/PageSelector.cs
+++ b/osu.Game/Graphics/UserInterface/PageSelector.cs
@@ -3,7 +3,6 @@
 
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics;
-using osu.Game.Graphics.Containers;
 using osu.Framework.Bindables;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics.Shapes;
@@ -16,7 +15,7 @@ namespace osu.Game.Graphics.UserInterface
 {
     public class PageSelector : CompositeDrawable
     {
-        private BindableInt currentPage = new BindableInt(1);
+        public readonly BindableInt CurrentPage = new BindableInt();
 
         private readonly int maxPages;
         private readonly FillFlowContainer pillsFlow;
@@ -38,30 +37,47 @@ namespace osu.Game.Graphics.UserInterface
         {
             base.LoadComplete();
 
-            currentPage.BindValueChanged(page => redraw(page.NewValue), true);
+            CurrentPage.BindValueChanged(_ => redraw(), true);
         }
 
-        private void redraw(int newPage)
+        private void redraw()
         {
             pillsFlow.Clear();
 
-            for (int i = 1; i <= maxPages; i++)
+            if (CurrentPage.Value > 3)
+                addDrawablePage(1);
+
+            if (CurrentPage.Value > 4)
+                addPlaceholder();
+
+            for (int i = Math.Max(CurrentPage.Value - 2, 1); i <= Math.Min(CurrentPage.Value + 2, maxPages); i++)
             {
-                if (i == currentPage.Value)
+                if (i == CurrentPage.Value)
                     addCurrentPagePill();
                 else
-                    addPagePill(i);
+                    addDrawablePage(i);
             }
+
+            if (CurrentPage.Value + 2 < maxPages - 1)
+                addPlaceholder();
+
+            if (CurrentPage.Value + 2 < maxPages)
+                addDrawablePage(maxPages);
         }
 
-        private void addPagePill(int page)
+        private void addDrawablePage(int page)
         {
-            pillsFlow.Add(new Page(page.ToString(), () => currentPage.Value = page));
+            pillsFlow.Add(new Page(page.ToString(), () => CurrentPage.Value = page));
+        }
+
+        private void addPlaceholder()
+        {
+            pillsFlow.Add(new Placeholder());
         }
 
         private void addCurrentPagePill()
         {
-            pillsFlow.Add(new CurrentPage(currentPage.Value.ToString()));
+            pillsFlow.Add(new SelectedPage(CurrentPage.Value.ToString()));
         }
 
         private abstract class DrawablePage : CompositeDrawable
@@ -149,13 +165,13 @@ namespace osu.Game.Graphics.UserInterface
             };
         }
 
-        private class CurrentPage : DrawablePage
+        private class SelectedPage : DrawablePage
         {
             private SpriteText text;
 
             private Box background;
 
-            public CurrentPage(string text)
+            public SelectedPage(string text)
                 : base(text)
             {
             }
@@ -184,5 +200,28 @@ namespace osu.Game.Graphics.UserInterface
                 }
             };
         }
+
+        private class Placeholder : DrawablePage
+        {
+            private SpriteText text;
+
+            public Placeholder()
+                : base("...")
+            {
+            }
+
+            [BackgroundDependencyLoader]
+            private void load(OsuColour colours)
+            {
+                text.Colour = colours.Seafoam;
+            }
+
+            protected override Drawable CreateContent() => text = new SpriteText
+            {
+                Anchor = Anchor.Centre,
+                Origin = Anchor.Centre,
+                Text = Text
+            };
+        }
     }
 }

From 9bd4220e9f6817e3200926c7abce593b6f8e52aa Mon Sep 17 00:00:00 2001
From: Andrei Zavatski <megaman9919@gmail.com>
Date: Sat, 7 Sep 2019 09:20:11 +0300
Subject: [PATCH 0010/5547] Add prev/next buttons

---
 .../Graphics/UserInterface/PageSelector.cs    | 206 ++++++++++++++++--
 1 file changed, 184 insertions(+), 22 deletions(-)

diff --git a/osu.Game/Graphics/UserInterface/PageSelector.cs b/osu.Game/Graphics/UserInterface/PageSelector.cs
index 244e87f023..d93dcdace9 100644
--- a/osu.Game/Graphics/UserInterface/PageSelector.cs
+++ b/osu.Game/Graphics/UserInterface/PageSelector.cs
@@ -10,12 +10,13 @@ using osu.Framework.Graphics.Sprites;
 using osu.Framework.Input.Events;
 using osu.Framework.Extensions.Color4Extensions;
 using System;
+using osuTK;
 
 namespace osu.Game.Graphics.UserInterface
 {
     public class PageSelector : CompositeDrawable
     {
-        public readonly BindableInt CurrentPage = new BindableInt();
+        public readonly BindableInt CurrentPage = new BindableInt(1);
 
         private readonly int maxPages;
         private readonly FillFlowContainer pillsFlow;
@@ -44,6 +45,11 @@ namespace osu.Game.Graphics.UserInterface
         {
             pillsFlow.Clear();
 
+            if (CurrentPage.Value == 1)
+                addPreviousPageButton();
+            else
+                addPreviousPageButton(() => CurrentPage.Value -= 1);
+
             if (CurrentPage.Value > 3)
                 addDrawablePage(1);
 
@@ -63,6 +69,11 @@ namespace osu.Game.Graphics.UserInterface
 
             if (CurrentPage.Value + 2 < maxPages)
                 addDrawablePage(maxPages);
+
+            if (CurrentPage.Value == maxPages)
+                addNextPageButton();
+            else
+                addNextPageButton(() => CurrentPage.Value += 1);
         }
 
         private void addDrawablePage(int page)
@@ -80,12 +91,23 @@ namespace osu.Game.Graphics.UserInterface
             pillsFlow.Add(new SelectedPage(CurrentPage.Value.ToString()));
         }
 
+        private void addPreviousPageButton(Action action = null)
+        {
+            pillsFlow.Add(new PreviousPageButton(action));
+        }
+
+        private void addNextPageButton(Action action = null)
+        {
+            pillsFlow.Add(new NextPageButton(action));
+        }
+
         private abstract class DrawablePage : CompositeDrawable
         {
             private const int height = 20;
             private const int margin = 8;
 
             protected readonly string Text;
+            protected readonly Drawable Content;
 
             protected DrawablePage(string text)
             {
@@ -99,10 +121,10 @@ namespace osu.Game.Graphics.UserInterface
                 if (background != null)
                     AddInternal(background);
 
-                var content = CreateContent();
-                content.Margin = new MarginPadding { Horizontal = margin };
+                Content = CreateContent();
+                Content.Margin = new MarginPadding { Horizontal = margin };
 
-                AddInternal(content);
+                AddInternal(Content);
             }
 
             protected abstract Drawable CreateContent();
@@ -112,25 +134,23 @@ namespace osu.Game.Graphics.UserInterface
 
         private abstract class ActivatedDrawablePage : DrawablePage
         {
-            private readonly Action action;
+            protected readonly Action Action;
 
-            public ActivatedDrawablePage(string text, Action action)
+            public ActivatedDrawablePage(string text, Action action = null)
                 : base(text)
             {
-                this.action = action;
+                Action = action;
             }
 
             protected override bool OnClick(ClickEvent e)
             {
-                action?.Invoke();
+                Action?.Invoke();
                 return base.OnClick(e);
             }
         }
 
         private class Page : ActivatedDrawablePage
         {
-            private SpriteText text;
-
             private OsuColour colours;
 
             public Page(string text, Action action)
@@ -142,22 +162,22 @@ namespace osu.Game.Graphics.UserInterface
             private void load(OsuColour colours)
             {
                 this.colours = colours;
-                text.Colour = colours.Seafoam;
+                Content.Colour = colours.Seafoam;
             }
 
             protected override bool OnHover(HoverEvent e)
             {
-                text.Colour = colours.Seafoam.Lighten(30f);
+                Content.Colour = colours.Seafoam.Lighten(30f);
                 return base.OnHover(e);
             }
 
             protected override void OnHoverLost(HoverLostEvent e)
             {
-                text.Colour = colours.Seafoam;
+                Content.Colour = colours.Seafoam;
                 base.OnHoverLost(e);
             }
 
-            protected override Drawable CreateContent() => text = new SpriteText
+            protected override Drawable CreateContent() => new SpriteText
             {
                 Anchor = Anchor.Centre,
                 Origin = Anchor.Centre,
@@ -167,8 +187,6 @@ namespace osu.Game.Graphics.UserInterface
 
         private class SelectedPage : DrawablePage
         {
-            private SpriteText text;
-
             private Box background;
 
             public SelectedPage(string text)
@@ -179,11 +197,11 @@ namespace osu.Game.Graphics.UserInterface
             [BackgroundDependencyLoader]
             private void load(OsuColour colours)
             {
-                text.Colour = colours.GreySeafoam;
+                Content.Colour = colours.GreySeafoam;
                 background.Colour = colours.Seafoam;
             }
 
-            protected override Drawable CreateContent() => text = new SpriteText
+            protected override Drawable CreateContent() => new SpriteText
             {
                 Anchor = Anchor.Centre,
                 Origin = Anchor.Centre,
@@ -203,8 +221,6 @@ namespace osu.Game.Graphics.UserInterface
 
         private class Placeholder : DrawablePage
         {
-            private SpriteText text;
-
             public Placeholder()
                 : base("...")
             {
@@ -213,15 +229,161 @@ namespace osu.Game.Graphics.UserInterface
             [BackgroundDependencyLoader]
             private void load(OsuColour colours)
             {
-                text.Colour = colours.Seafoam;
+                Content.Colour = colours.Seafoam;
             }
 
-            protected override Drawable CreateContent() => text = new SpriteText
+            protected override Drawable CreateContent() => new SpriteText
             {
                 Anchor = Anchor.Centre,
                 Origin = Anchor.Centre,
                 Text = Text
             };
         }
+
+        private class PreviousPageButton : ActivatedDrawablePage
+        {
+            private OsuColour colours;
+            private Box background;
+
+            public PreviousPageButton(Action action)
+                : base("prev", action)
+            {
+            }
+
+            [BackgroundDependencyLoader]
+            private void load(OsuColour colours)
+            {
+                this.colours = colours;
+                Content.Colour = colours.Seafoam;
+                background.Colour = colours.GreySeafoam;
+
+                if (Action == null)
+                {
+                    Content.FadeColour(colours.GrayA);
+                    background.FadeColour(colours.GrayA);
+                }
+            }
+
+            protected override bool OnHover(HoverEvent e)
+            {
+                Content.Colour = colours.Seafoam.Lighten(30f);
+                return base.OnHover(e);
+            }
+
+            protected override void OnHoverLost(HoverLostEvent e)
+            {
+                Content.Colour = colours.Seafoam;
+                base.OnHoverLost(e);
+            }
+
+            protected override Drawable CreateContent() => new FillFlowContainer
+            {
+                Anchor = Anchor.Centre,
+                Origin = Anchor.Centre,
+                AutoSizeAxes = Axes.X,
+                RelativeSizeAxes = Axes.Y,
+                Direction = FillDirection.Horizontal,
+                Spacing = new Vector2(3),
+                Children = new Drawable[]
+                {
+                    new SpriteIcon
+                    {
+                        Anchor = Anchor.CentreLeft,
+                        Origin = Anchor.CentreLeft,
+                        Icon = FontAwesome.Solid.CaretLeft,
+                        Size = new Vector2(10),
+                    },
+                    new SpriteText
+                    {
+                        Anchor = Anchor.CentreLeft,
+                        Origin = Anchor.CentreLeft,
+                        Text = Text.ToUpper(),
+                    }
+                }
+            };
+
+            protected override Drawable CreateBackground() => new CircularContainer
+            {
+                RelativeSizeAxes = Axes.Both,
+                Masking = true,
+                Child = background = new Box
+                {
+                    RelativeSizeAxes = Axes.Both,
+                }
+            };
+        }
+
+        private class NextPageButton : ActivatedDrawablePage
+        {
+            private OsuColour colours;
+            private Box background;
+
+            public NextPageButton(Action action)
+                : base("next", action)
+            {
+            }
+
+            [BackgroundDependencyLoader]
+            private void load(OsuColour colours)
+            {
+                this.colours = colours;
+                Content.Colour = colours.Seafoam;
+                background.Colour = colours.GreySeafoam;
+
+                if (Action == null)
+                {
+                    Content.FadeColour(colours.GrayA);
+                    background.FadeColour(colours.GrayA);
+                }
+            }
+
+            protected override bool OnHover(HoverEvent e)
+            {
+                Content.Colour = colours.Seafoam.Lighten(30f);
+                return base.OnHover(e);
+            }
+
+            protected override void OnHoverLost(HoverLostEvent e)
+            {
+                Content.Colour = colours.Seafoam;
+                base.OnHoverLost(e);
+            }
+
+            protected override Drawable CreateContent() => new FillFlowContainer
+            {
+                Anchor = Anchor.Centre,
+                Origin = Anchor.Centre,
+                AutoSizeAxes = Axes.X,
+                RelativeSizeAxes = Axes.Y,
+                Direction = FillDirection.Horizontal,
+                Spacing = new Vector2(3),
+                Children = new Drawable[]
+                {
+                    new SpriteText
+                    {
+                        Anchor = Anchor.CentreLeft,
+                        Origin = Anchor.CentreLeft,
+                        Text = Text.ToUpper(),
+                    },
+                    new SpriteIcon
+                    {
+                        Anchor = Anchor.CentreLeft,
+                        Origin = Anchor.CentreLeft,
+                        Icon = FontAwesome.Solid.CaretRight,
+                        Size = new Vector2(10),
+                    },
+                }
+            };
+
+            protected override Drawable CreateBackground() => new CircularContainer
+            {
+                RelativeSizeAxes = Axes.Both,
+                Masking = true,
+                Child = background = new Box
+                {
+                    RelativeSizeAxes = Axes.Both,
+                }
+            };
+        }
     }
 }

From ba18f77b628496569cb5d5718081ea271b51e4f3 Mon Sep 17 00:00:00 2001
From: Andrei Zavatski <megaman9919@gmail.com>
Date: Sat, 7 Sep 2019 22:31:08 +0300
Subject: [PATCH 0011/5547] Use OsuHoverContainer for prev/next buttons

---
 .../Graphics/UserInterface/PageSelector.cs    | 231 ++++++------------
 1 file changed, 78 insertions(+), 153 deletions(-)

diff --git a/osu.Game/Graphics/UserInterface/PageSelector.cs b/osu.Game/Graphics/UserInterface/PageSelector.cs
index d93dcdace9..3ca133d64b 100644
--- a/osu.Game/Graphics/UserInterface/PageSelector.cs
+++ b/osu.Game/Graphics/UserInterface/PageSelector.cs
@@ -11,6 +11,8 @@ using osu.Framework.Input.Events;
 using osu.Framework.Extensions.Color4Extensions;
 using System;
 using osuTK;
+using osu.Game.Graphics.Containers;
+using System.Collections.Generic;
 
 namespace osu.Game.Graphics.UserInterface
 {
@@ -21,16 +23,34 @@ namespace osu.Game.Graphics.UserInterface
         private readonly int maxPages;
         private readonly FillFlowContainer pillsFlow;
 
+        private readonly Button previousPageButton;
+        private readonly Button nextPageButton;
+
         public PageSelector(int maxPages)
         {
             this.maxPages = maxPages;
 
             AutoSizeAxes = Axes.Both;
-            InternalChild = pillsFlow = new FillFlowContainer
+            InternalChild = new FillFlowContainer
             {
-                AutoSizeAxes = Axes.X,
-                RelativeSizeAxes = Axes.Y,
+                AutoSizeAxes = Axes.Both,
                 Direction = FillDirection.Horizontal,
+                Children = new Drawable[]
+                {
+                    previousPageButton = new Button(false, "prev")
+                    {
+                        Action = () => CurrentPage.Value -= 1,
+                    },
+                    pillsFlow = new FillFlowContainer
+                    {
+                        AutoSizeAxes = Axes.Both,
+                        Direction = FillDirection.Horizontal,
+                    },
+                    nextPageButton = new Button(true, "next")
+                    {
+                        Action = () => CurrentPage.Value += 1
+                    }
+                }
             };
         }
 
@@ -43,12 +63,10 @@ namespace osu.Game.Graphics.UserInterface
 
         private void redraw()
         {
-            pillsFlow.Clear();
+            previousPageButton.Enabled.Value = CurrentPage.Value != 1;
+            nextPageButton.Enabled.Value = CurrentPage.Value != maxPages;
 
-            if (CurrentPage.Value == 1)
-                addPreviousPageButton();
-            else
-                addPreviousPageButton(() => CurrentPage.Value -= 1);
+            pillsFlow.Clear();
 
             if (CurrentPage.Value > 3)
                 addDrawablePage(1);
@@ -69,11 +87,6 @@ namespace osu.Game.Graphics.UserInterface
 
             if (CurrentPage.Value + 2 < maxPages)
                 addDrawablePage(maxPages);
-
-            if (CurrentPage.Value == maxPages)
-                addNextPageButton();
-            else
-                addNextPageButton(() => CurrentPage.Value += 1);
         }
 
         private void addDrawablePage(int page)
@@ -91,16 +104,6 @@ namespace osu.Game.Graphics.UserInterface
             pillsFlow.Add(new SelectedPage(CurrentPage.Value.ToString()));
         }
 
-        private void addPreviousPageButton(Action action = null)
-        {
-            pillsFlow.Add(new PreviousPageButton(action));
-        }
-
-        private void addNextPageButton(Action action = null)
-        {
-            pillsFlow.Add(new NextPageButton(action));
-        }
-
         private abstract class DrawablePage : CompositeDrawable
         {
             private const int height = 20;
@@ -240,150 +243,72 @@ namespace osu.Game.Graphics.UserInterface
             };
         }
 
-        private class PreviousPageButton : ActivatedDrawablePage
+        private class Button : OsuHoverContainer
         {
-            private OsuColour colours;
-            private Box background;
+            private const int height = 20;
+            private const int margin = 8;
 
-            public PreviousPageButton(Action action)
-                : base("prev", action)
+            private readonly Anchor alignment;
+            private readonly Box background;
+
+            protected override IEnumerable<Drawable> EffectTargets => new[] { background };
+
+            public Button(bool rightAligned, string text)
             {
-            }
+                alignment = rightAligned ? Anchor.x0 : Anchor.x2;
 
-            [BackgroundDependencyLoader]
-            private void load(OsuColour colours)
-            {
-                this.colours = colours;
-                Content.Colour = colours.Seafoam;
-                background.Colour = colours.GreySeafoam;
+                AutoSizeAxes = Axes.X;
+                Height = height;
 
-                if (Action == null)
+                Child = new CircularContainer
                 {
-                    Content.FadeColour(colours.GrayA);
-                    background.FadeColour(colours.GrayA);
-                }
-            }
-
-            protected override bool OnHover(HoverEvent e)
-            {
-                Content.Colour = colours.Seafoam.Lighten(30f);
-                return base.OnHover(e);
-            }
-
-            protected override void OnHoverLost(HoverLostEvent e)
-            {
-                Content.Colour = colours.Seafoam;
-                base.OnHoverLost(e);
-            }
-
-            protected override Drawable CreateContent() => new FillFlowContainer
-            {
-                Anchor = Anchor.Centre,
-                Origin = Anchor.Centre,
-                AutoSizeAxes = Axes.X,
-                RelativeSizeAxes = Axes.Y,
-                Direction = FillDirection.Horizontal,
-                Spacing = new Vector2(3),
-                Children = new Drawable[]
-                {
-                    new SpriteIcon
+                    AutoSizeAxes = Axes.X,
+                    RelativeSizeAxes = Axes.Y,
+                    Masking = true,
+                    Children = new Drawable[]
                     {
-                        Anchor = Anchor.CentreLeft,
-                        Origin = Anchor.CentreLeft,
-                        Icon = FontAwesome.Solid.CaretLeft,
-                        Size = new Vector2(10),
-                    },
-                    new SpriteText
-                    {
-                        Anchor = Anchor.CentreLeft,
-                        Origin = Anchor.CentreLeft,
-                        Text = Text.ToUpper(),
+                        background = new Box
+                        {
+                            RelativeSizeAxes = Axes.Both,
+                        },
+                        new Container
+                        {
+                            AutoSizeAxes = Axes.Both,
+                            Anchor = Anchor.Centre,
+                            Origin = Anchor.Centre,
+                            Child = new FillFlowContainer
+                            {
+                                AutoSizeAxes = Axes.Both,
+                                Margin = new MarginPadding { Horizontal = margin },
+                                Direction = FillDirection.Horizontal,
+                                Children = new Drawable[]
+                                {
+                                    new SpriteText
+                                    {
+                                        Anchor = Anchor.y1 | alignment,
+                                        Origin = Anchor.y1 | alignment,
+                                        Text = text.ToUpper(),
+                                    },
+                                    new SpriteIcon
+                                    {
+                                        Anchor = Anchor.y1 | alignment,
+                                        Origin = Anchor.y1 | alignment,
+                                        Icon = alignment == Anchor.x2 ? FontAwesome.Solid.ChevronLeft : FontAwesome.Solid.ChevronRight,
+                                        Size = new Vector2(10),
+                                    },
+                                }
+                            }
+                        }
                     }
-                }
-            };
-
-            protected override Drawable CreateBackground() => new CircularContainer
-            {
-                RelativeSizeAxes = Axes.Both,
-                Masking = true,
-                Child = background = new Box
-                {
-                    RelativeSizeAxes = Axes.Both,
-                }
-            };
-        }
-
-        private class NextPageButton : ActivatedDrawablePage
-        {
-            private OsuColour colours;
-            private Box background;
-
-            public NextPageButton(Action action)
-                : base("next", action)
-            {
+                };
             }
 
             [BackgroundDependencyLoader]
             private void load(OsuColour colours)
             {
-                this.colours = colours;
-                Content.Colour = colours.Seafoam;
-                background.Colour = colours.GreySeafoam;
-
-                if (Action == null)
-                {
-                    Content.FadeColour(colours.GrayA);
-                    background.FadeColour(colours.GrayA);
-                }
+                IdleColour = colours.GreySeafoamDark;
+                HoverColour = colours.GrayA;
             }
-
-            protected override bool OnHover(HoverEvent e)
-            {
-                Content.Colour = colours.Seafoam.Lighten(30f);
-                return base.OnHover(e);
-            }
-
-            protected override void OnHoverLost(HoverLostEvent e)
-            {
-                Content.Colour = colours.Seafoam;
-                base.OnHoverLost(e);
-            }
-
-            protected override Drawable CreateContent() => new FillFlowContainer
-            {
-                Anchor = Anchor.Centre,
-                Origin = Anchor.Centre,
-                AutoSizeAxes = Axes.X,
-                RelativeSizeAxes = Axes.Y,
-                Direction = FillDirection.Horizontal,
-                Spacing = new Vector2(3),
-                Children = new Drawable[]
-                {
-                    new SpriteText
-                    {
-                        Anchor = Anchor.CentreLeft,
-                        Origin = Anchor.CentreLeft,
-                        Text = Text.ToUpper(),
-                    },
-                    new SpriteIcon
-                    {
-                        Anchor = Anchor.CentreLeft,
-                        Origin = Anchor.CentreLeft,
-                        Icon = FontAwesome.Solid.CaretRight,
-                        Size = new Vector2(10),
-                    },
-                }
-            };
-
-            protected override Drawable CreateBackground() => new CircularContainer
-            {
-                RelativeSizeAxes = Axes.Both,
-                Masking = true,
-                Child = background = new Box
-                {
-                    RelativeSizeAxes = Axes.Both,
-                }
-            };
         }
     }
 }

From ec8298ac53108d65a7901228bf524ebcae794356 Mon Sep 17 00:00:00 2001
From: Andrei Zavatski <megaman9919@gmail.com>
Date: Sat, 7 Sep 2019 22:33:26 +0300
Subject: [PATCH 0012/5547] Simplify redraw function

---
 .../Graphics/UserInterface/PageSelector.cs    | 20 +++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/osu.Game/Graphics/UserInterface/PageSelector.cs b/osu.Game/Graphics/UserInterface/PageSelector.cs
index 3ca133d64b..0b0c2eec83 100644
--- a/osu.Game/Graphics/UserInterface/PageSelector.cs
+++ b/osu.Game/Graphics/UserInterface/PageSelector.cs
@@ -58,34 +58,34 @@ namespace osu.Game.Graphics.UserInterface
         {
             base.LoadComplete();
 
-            CurrentPage.BindValueChanged(_ => redraw(), true);
+            CurrentPage.BindValueChanged(page => redraw(page.NewValue), true);
         }
 
-        private void redraw()
+        private void redraw(int newPage)
         {
-            previousPageButton.Enabled.Value = CurrentPage.Value != 1;
-            nextPageButton.Enabled.Value = CurrentPage.Value != maxPages;
+            previousPageButton.Enabled.Value = newPage != 1;
+            nextPageButton.Enabled.Value = newPage != maxPages;
 
             pillsFlow.Clear();
 
-            if (CurrentPage.Value > 3)
+            if (newPage > 3)
                 addDrawablePage(1);
 
-            if (CurrentPage.Value > 4)
+            if (newPage > 4)
                 addPlaceholder();
 
-            for (int i = Math.Max(CurrentPage.Value - 2, 1); i <= Math.Min(CurrentPage.Value + 2, maxPages); i++)
+            for (int i = Math.Max(newPage - 2, 1); i <= Math.Min(newPage + 2, maxPages); i++)
             {
-                if (i == CurrentPage.Value)
+                if (i == newPage)
                     addCurrentPagePill();
                 else
                     addDrawablePage(i);
             }
 
-            if (CurrentPage.Value + 2 < maxPages - 1)
+            if (newPage + 2 < maxPages - 1)
                 addPlaceholder();
 
-            if (CurrentPage.Value + 2 < maxPages)
+            if (newPage + 2 < maxPages)
                 addDrawablePage(maxPages);
         }
 

From df29465ba44c974290bdaa775d78b736a2340f8d Mon Sep 17 00:00:00 2001
From: Andrei Zavatski <megaman9919@gmail.com>
Date: Sat, 7 Sep 2019 23:42:30 +0300
Subject: [PATCH 0013/5547] Implement a single PageItem component

---
 .../Graphics/UserInterface/PageSelector.cs    | 237 +++++++-----------
 1 file changed, 86 insertions(+), 151 deletions(-)

diff --git a/osu.Game/Graphics/UserInterface/PageSelector.cs b/osu.Game/Graphics/UserInterface/PageSelector.cs
index 0b0c2eec83..9dea9232ac 100644
--- a/osu.Game/Graphics/UserInterface/PageSelector.cs
+++ b/osu.Game/Graphics/UserInterface/PageSelector.cs
@@ -7,12 +7,12 @@ using osu.Framework.Bindables;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Graphics.Sprites;
-using osu.Framework.Input.Events;
 using osu.Framework.Extensions.Color4Extensions;
 using System;
 using osuTK;
 using osu.Game.Graphics.Containers;
 using System.Collections.Generic;
+using osu.Framework.Extensions.IEnumerableExtensions;
 
 namespace osu.Game.Graphics.UserInterface
 {
@@ -21,7 +21,7 @@ namespace osu.Game.Graphics.UserInterface
         public readonly BindableInt CurrentPage = new BindableInt(1);
 
         private readonly int maxPages;
-        private readonly FillFlowContainer pillsFlow;
+        private readonly FillFlowContainer itemsFlow;
 
         private readonly Button previousPageButton;
         private readonly Button nextPageButton;
@@ -41,7 +41,7 @@ namespace osu.Game.Graphics.UserInterface
                     {
                         Action = () => CurrentPage.Value -= 1,
                     },
-                    pillsFlow = new FillFlowContainer
+                    itemsFlow = new FillFlowContainer
                     {
                         AutoSizeAxes = Axes.Both,
                         Direction = FillDirection.Horizontal,
@@ -66,7 +66,7 @@ namespace osu.Game.Graphics.UserInterface
             previousPageButton.Enabled.Value = newPage != 1;
             nextPageButton.Enabled.Value = newPage != maxPages;
 
-            pillsFlow.Clear();
+            itemsFlow.Clear();
 
             if (newPage > 3)
                 addDrawablePage(1);
@@ -77,7 +77,7 @@ namespace osu.Game.Graphics.UserInterface
             for (int i = Math.Max(newPage - 2, 1); i <= Math.Min(newPage + 2, maxPages); i++)
             {
                 if (i == newPage)
-                    addCurrentPagePill();
+                    addDrawableCurrentPage();
                 else
                     addDrawablePage(i);
             }
@@ -89,137 +89,101 @@ namespace osu.Game.Graphics.UserInterface
                 addDrawablePage(maxPages);
         }
 
-        private void addDrawablePage(int page)
+        private void addDrawablePage(int page) => itemsFlow.Add(new DrawablePage(page.ToString())
         {
-            pillsFlow.Add(new Page(page.ToString(), () => CurrentPage.Value = page));
-        }
+            Action = () => CurrentPage.Value = page,
+        });
 
-        private void addPlaceholder()
-        {
-            pillsFlow.Add(new Placeholder());
-        }
+        private void addPlaceholder() => itemsFlow.Add(new Placeholder());
 
-        private void addCurrentPagePill()
-        {
-            pillsFlow.Add(new SelectedPage(CurrentPage.Value.ToString()));
-        }
+        private void addDrawableCurrentPage() => itemsFlow.Add(new SelectedPage(CurrentPage.Value.ToString()));
 
-        private abstract class DrawablePage : CompositeDrawable
+        private abstract class PageItem : OsuHoverContainer
         {
-            private const int height = 20;
             private const int margin = 8;
+            private const int height = 20;
 
-            protected readonly string Text;
-            protected readonly Drawable Content;
-
-            protected DrawablePage(string text)
+            protected PageItem(string text)
             {
-                Text = text;
-
                 AutoSizeAxes = Axes.X;
                 Height = height;
 
+                var contentContainer = new CircularContainer
+                {
+                    AutoSizeAxes = Axes.X,
+                    RelativeSizeAxes = Axes.Y,
+                    Masking = true,
+                };
+
                 var background = CreateBackground();
-
                 if (background != null)
-                    AddInternal(background);
+                    contentContainer.Add(background);
 
-                Content = CreateContent();
-                Content.Margin = new MarginPadding { Horizontal = margin };
+                var drawableText = CreateText(text);
+                if (drawableText != null)
+                {
+                    drawableText.Margin = new MarginPadding { Horizontal = margin };
+                    contentContainer.Add(drawableText);
+                }
 
-                AddInternal(Content);
+                Add(contentContainer);
             }
 
-            protected abstract Drawable CreateContent();
+            protected abstract Drawable CreateText(string text);
 
-            protected virtual Drawable CreateBackground() => null;
+            protected abstract Drawable CreateBackground();
         }
 
-        private abstract class ActivatedDrawablePage : DrawablePage
+        private class DrawablePage : PageItem
         {
-            protected readonly Action Action;
+            protected SpriteText SpriteText;
 
-            public ActivatedDrawablePage(string text, Action action = null)
+            protected override IEnumerable<Drawable> EffectTargets => new[] { SpriteText };
+
+            public DrawablePage(string text)
                 : base(text)
             {
-                Action = action;
             }
 
-            protected override bool OnClick(ClickEvent e)
+            protected override Drawable CreateBackground() => null;
+
+            protected override Drawable CreateText(string text) => SpriteText = new SpriteText
             {
-                Action?.Invoke();
-                return base.OnClick(e);
-            }
-        }
-
-        private class Page : ActivatedDrawablePage
-        {
-            private OsuColour colours;
-
-            public Page(string text, Action action)
-                : base(text, action)
-            {
-            }
+                Anchor = Anchor.Centre,
+                Origin = Anchor.Centre,
+                Text = text,
+            };
 
             [BackgroundDependencyLoader]
             private void load(OsuColour colours)
             {
-                this.colours = colours;
-                Content.Colour = colours.Seafoam;
+                IdleColour = colours.Seafoam;
+                HoverColour = colours.Seafoam.Lighten(30f);
             }
-
-            protected override bool OnHover(HoverEvent e)
-            {
-                Content.Colour = colours.Seafoam.Lighten(30f);
-                return base.OnHover(e);
-            }
-
-            protected override void OnHoverLost(HoverLostEvent e)
-            {
-                Content.Colour = colours.Seafoam;
-                base.OnHoverLost(e);
-            }
-
-            protected override Drawable CreateContent() => new SpriteText
-            {
-                Anchor = Anchor.Centre,
-                Origin = Anchor.Centre,
-                Text = Text
-            };
         }
 
         private class SelectedPage : DrawablePage
         {
             private Box background;
 
+            protected override IEnumerable<Drawable> EffectTargets => null;
+
             public SelectedPage(string text)
                 : base(text)
             {
             }
 
+            protected override Drawable CreateBackground() => background = new Box
+            {
+                RelativeSizeAxes = Axes.Both,
+            };
+
             [BackgroundDependencyLoader]
             private void load(OsuColour colours)
             {
-                Content.Colour = colours.GreySeafoam;
                 background.Colour = colours.Seafoam;
+                SpriteText.Colour = colours.GreySeafoamDark;
             }
-
-            protected override Drawable CreateContent() => new SpriteText
-            {
-                Anchor = Anchor.Centre,
-                Origin = Anchor.Centre,
-                Text = Text
-            };
-
-            protected override Drawable CreateBackground() => new CircularContainer
-            {
-                RelativeSizeAxes = Axes.Both,
-                Masking = true,
-                Child = background = new Box
-                {
-                    RelativeSizeAxes = Axes.Both,
-                }
-            };
         }
 
         private class Placeholder : DrawablePage
@@ -228,79 +192,28 @@ namespace osu.Game.Graphics.UserInterface
                 : base("...")
             {
             }
-
-            [BackgroundDependencyLoader]
-            private void load(OsuColour colours)
-            {
-                Content.Colour = colours.Seafoam;
-            }
-
-            protected override Drawable CreateContent() => new SpriteText
-            {
-                Anchor = Anchor.Centre,
-                Origin = Anchor.Centre,
-                Text = Text
-            };
         }
 
-        private class Button : OsuHoverContainer
+        private class Button : PageItem
         {
-            private const int height = 20;
-            private const int margin = 8;
-
-            private readonly Anchor alignment;
-            private readonly Box background;
+            private Box background;
+            private FillFlowContainer textContainer;
+            private SpriteIcon icon;
 
             protected override IEnumerable<Drawable> EffectTargets => new[] { background };
 
             public Button(bool rightAligned, string text)
+                : base(text)
             {
-                alignment = rightAligned ? Anchor.x0 : Anchor.x2;
+                var alignment = rightAligned ? Anchor.x0 : Anchor.x2;
 
-                AutoSizeAxes = Axes.X;
-                Height = height;
-
-                Child = new CircularContainer
+                textContainer.ForEach(drawable =>
                 {
-                    AutoSizeAxes = Axes.X,
-                    RelativeSizeAxes = Axes.Y,
-                    Masking = true,
-                    Children = new Drawable[]
-                    {
-                        background = new Box
-                        {
-                            RelativeSizeAxes = Axes.Both,
-                        },
-                        new Container
-                        {
-                            AutoSizeAxes = Axes.Both,
-                            Anchor = Anchor.Centre,
-                            Origin = Anchor.Centre,
-                            Child = new FillFlowContainer
-                            {
-                                AutoSizeAxes = Axes.Both,
-                                Margin = new MarginPadding { Horizontal = margin },
-                                Direction = FillDirection.Horizontal,
-                                Children = new Drawable[]
-                                {
-                                    new SpriteText
-                                    {
-                                        Anchor = Anchor.y1 | alignment,
-                                        Origin = Anchor.y1 | alignment,
-                                        Text = text.ToUpper(),
-                                    },
-                                    new SpriteIcon
-                                    {
-                                        Anchor = Anchor.y1 | alignment,
-                                        Origin = Anchor.y1 | alignment,
-                                        Icon = alignment == Anchor.x2 ? FontAwesome.Solid.ChevronLeft : FontAwesome.Solid.ChevronRight,
-                                        Size = new Vector2(10),
-                                    },
-                                }
-                            }
-                        }
-                    }
-                };
+                    drawable.Anchor = Anchor.y1 | alignment;
+                    drawable.Origin = Anchor.y1 | alignment;
+                });
+
+                icon.Icon = alignment == Anchor.x2 ? FontAwesome.Solid.ChevronLeft : FontAwesome.Solid.ChevronRight;
             }
 
             [BackgroundDependencyLoader]
@@ -309,6 +222,28 @@ namespace osu.Game.Graphics.UserInterface
                 IdleColour = colours.GreySeafoamDark;
                 HoverColour = colours.GrayA;
             }
+
+            protected override Drawable CreateBackground() => background = new Box
+            {
+                RelativeSizeAxes = Axes.Both,
+            };
+
+            protected override Drawable CreateText(string text) => textContainer = new FillFlowContainer
+            {
+                AutoSizeAxes = Axes.Both,
+                Direction = FillDirection.Horizontal,
+                Children = new Drawable[]
+                {
+                    new SpriteText
+                    {
+                        Text = text.ToUpper(),
+                    },
+                    icon = new SpriteIcon
+                    {
+                        Size = new Vector2(10),
+                    },
+                }
+            };
         }
     }
 }

From b0884d16fbcc4a540af86f40aa359a577d39d988 Mon Sep 17 00:00:00 2001
From: Andrei Zavatski <megaman9919@gmail.com>
Date: Sun, 8 Sep 2019 00:13:23 +0300
Subject: [PATCH 0014/5547] Visual adjustments

---
 .../Graphics/UserInterface/PageSelector.cs    | 67 +++++++++++++------
 1 file changed, 45 insertions(+), 22 deletions(-)

diff --git a/osu.Game/Graphics/UserInterface/PageSelector.cs b/osu.Game/Graphics/UserInterface/PageSelector.cs
index 9dea9232ac..9a5ffad0d4 100644
--- a/osu.Game/Graphics/UserInterface/PageSelector.cs
+++ b/osu.Game/Graphics/UserInterface/PageSelector.cs
@@ -13,6 +13,7 @@ using osuTK;
 using osu.Game.Graphics.Containers;
 using System.Collections.Generic;
 using osu.Framework.Extensions.IEnumerableExtensions;
+using osuTK.Graphics;
 
 namespace osu.Game.Graphics.UserInterface
 {
@@ -100,38 +101,47 @@ namespace osu.Game.Graphics.UserInterface
 
         private abstract class PageItem : OsuHoverContainer
         {
-            private const int margin = 8;
+            private const int margin = 10;
             private const int height = 20;
 
+            protected override Container<Drawable> Content => contentContainer;
+
+            private readonly CircularContainer contentContainer;
+
             protected PageItem(string text)
             {
                 AutoSizeAxes = Axes.X;
                 Height = height;
 
-                var contentContainer = new CircularContainer
+                base.Content.Add(contentContainer = new CircularContainer
                 {
                     AutoSizeAxes = Axes.X,
                     RelativeSizeAxes = Axes.Y,
                     Masking = true,
-                };
+                });
 
                 var background = CreateBackground();
                 if (background != null)
-                    contentContainer.Add(background);
+                    Add(background);
 
                 var drawableText = CreateText(text);
                 if (drawableText != null)
                 {
                     drawableText.Margin = new MarginPadding { Horizontal = margin };
-                    contentContainer.Add(drawableText);
+                    Add(drawableText);
                 }
+            }
 
-                Add(contentContainer);
+            [BackgroundDependencyLoader]
+            private void load(OsuColour colours)
+            {
+                IdleColour = colours.Seafoam;
+                HoverColour = colours.Seafoam.Lighten(30f);
             }
 
             protected abstract Drawable CreateText(string text);
 
-            protected abstract Drawable CreateBackground();
+            protected virtual Drawable CreateBackground() => null;
         }
 
         private class DrawablePage : PageItem
@@ -145,28 +155,20 @@ namespace osu.Game.Graphics.UserInterface
             {
             }
 
-            protected override Drawable CreateBackground() => null;
-
             protected override Drawable CreateText(string text) => SpriteText = new SpriteText
             {
                 Anchor = Anchor.Centre,
                 Origin = Anchor.Centre,
                 Text = text,
+                Font = OsuFont.GetFont(size: 12),
             };
-
-            [BackgroundDependencyLoader]
-            private void load(OsuColour colours)
-            {
-                IdleColour = colours.Seafoam;
-                HoverColour = colours.Seafoam.Lighten(30f);
-            }
         }
 
         private class SelectedPage : DrawablePage
         {
             private Box background;
 
-            protected override IEnumerable<Drawable> EffectTargets => null;
+            protected override IEnumerable<Drawable> EffectTargets => new[] { background };
 
             public SelectedPage(string text)
                 : base(text)
@@ -181,7 +183,6 @@ namespace osu.Game.Graphics.UserInterface
             [BackgroundDependencyLoader]
             private void load(OsuColour colours)
             {
-                background.Colour = colours.Seafoam;
                 SpriteText.Colour = colours.GreySeafoamDark;
             }
         }
@@ -196,11 +197,14 @@ namespace osu.Game.Graphics.UserInterface
 
         private class Button : PageItem
         {
+            private const int duration = 100;
+
             private Box background;
             private FillFlowContainer textContainer;
             private SpriteIcon icon;
+            private readonly Box fadeBox;
 
-            protected override IEnumerable<Drawable> EffectTargets => new[] { background };
+            protected override IEnumerable<Drawable> EffectTargets => new[] { textContainer };
 
             public Button(bool rightAligned, string text)
                 : base(text)
@@ -214,13 +218,29 @@ namespace osu.Game.Graphics.UserInterface
                 });
 
                 icon.Icon = alignment == Anchor.x2 ? FontAwesome.Solid.ChevronLeft : FontAwesome.Solid.ChevronRight;
+
+                Add(fadeBox = new Box
+                {
+                    RelativeSizeAxes = Axes.Both,
+                    Colour = Color4.Black.Opacity(100)
+                });
             }
 
             [BackgroundDependencyLoader]
             private void load(OsuColour colours)
             {
-                IdleColour = colours.GreySeafoamDark;
-                HoverColour = colours.GrayA;
+                background.Colour = colours.GreySeafoamDark;
+            }
+
+            protected override void LoadComplete()
+            {
+                base.LoadComplete();
+                Enabled.BindValueChanged(onEnabledChanged, true);
+            }
+
+            private void onEnabledChanged(ValueChangedEvent<bool> enabled)
+            {
+                fadeBox.FadeTo(enabled.NewValue ? 0 : 1, duration);
             }
 
             protected override Drawable CreateBackground() => background = new Box
@@ -231,16 +251,19 @@ namespace osu.Game.Graphics.UserInterface
             protected override Drawable CreateText(string text) => textContainer = new FillFlowContainer
             {
                 AutoSizeAxes = Axes.Both,
+                Anchor = Anchor.Centre,
+                Origin = Anchor.Centre,
                 Direction = FillDirection.Horizontal,
                 Children = new Drawable[]
                 {
                     new SpriteText
                     {
                         Text = text.ToUpper(),
+                        Font = OsuFont.GetFont(size: 12),
                     },
                     icon = new SpriteIcon
                     {
-                        Size = new Vector2(10),
+                        Size = new Vector2(8),
                     },
                 }
             };

From b97f4a81db6a35ba5fac734bbdb0f8b42a948419 Mon Sep 17 00:00:00 2001
From: Andrei Zavatski <megaman9919@gmail.com>
Date: Sun, 8 Sep 2019 00:27:40 +0300
Subject: [PATCH 0015/5547] Add more testing

---
 .../UserInterface/TestScenePageSelector.cs    | 22 +++++++++++++++++++
 .../Graphics/UserInterface/PageSelector.cs    | 18 +++++++++++++--
 2 files changed, 38 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestScenePageSelector.cs b/osu.Game.Tests/Visual/UserInterface/TestScenePageSelector.cs
index e5efa65c91..cb83fbd028 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestScenePageSelector.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestScenePageSelector.cs
@@ -22,6 +22,28 @@ namespace osu.Game.Tests.Visual.UserInterface
                 Anchor = Anchor.Centre,
                 Origin = Anchor.Centre,
             };
+
+            AddStep("1 max pages", () => redraw(1));
+            AddStep("10 max pages", () => redraw(10));
+            AddStep("200 max pages, current 199", () => redraw(200, 199));
+            AddStep("200 max pages, current 201", () => redraw(200, 201));
+            AddStep("200 max pages, current -10", () => redraw(200, -10));
+        }
+
+        private void redraw(int maxPages, int currentPage = 0)
+        {
+            Clear();
+
+            var selector = new PageSelector(maxPages)
+            {
+                Anchor = Anchor.Centre,
+                Origin = Anchor.Centre,
+            };
+
+            if (currentPage != 0)
+                selector.CurrentPage.Value = currentPage;
+
+            Add(selector);
         }
     }
 }
diff --git a/osu.Game/Graphics/UserInterface/PageSelector.cs b/osu.Game/Graphics/UserInterface/PageSelector.cs
index 9a5ffad0d4..79a1680e4b 100644
--- a/osu.Game/Graphics/UserInterface/PageSelector.cs
+++ b/osu.Game/Graphics/UserInterface/PageSelector.cs
@@ -59,11 +59,25 @@ namespace osu.Game.Graphics.UserInterface
         {
             base.LoadComplete();
 
-            CurrentPage.BindValueChanged(page => redraw(page.NewValue), true);
+            CurrentPage.BindValueChanged(_ => redraw(), true);
         }
 
-        private void redraw(int newPage)
+        private void redraw()
         {
+            if (CurrentPage.Value > maxPages)
+            {
+                CurrentPage.Value = maxPages;
+                return;
+            }
+
+            if (CurrentPage.Value < 1)
+            {
+                CurrentPage.Value = 1;
+                return;
+            }
+
+            int newPage = CurrentPage.Value;
+
             previousPageButton.Enabled.Value = newPage != 1;
             nextPageButton.Enabled.Value = newPage != maxPages;
 

From 0451b45fab4ed1a377f99e7f508e7b9c0b451ef6 Mon Sep 17 00:00:00 2001
From: Andrei Zavatski <megaman9919@gmail.com>
Date: Sun, 8 Sep 2019 00:37:11 +0300
Subject: [PATCH 0016/5547] Add missing blank line

---
 osu.Game/Graphics/UserInterface/PageSelector.cs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Game/Graphics/UserInterface/PageSelector.cs b/osu.Game/Graphics/UserInterface/PageSelector.cs
index 79a1680e4b..9db6366ad6 100644
--- a/osu.Game/Graphics/UserInterface/PageSelector.cs
+++ b/osu.Game/Graphics/UserInterface/PageSelector.cs
@@ -139,6 +139,7 @@ namespace osu.Game.Graphics.UserInterface
                     Add(background);
 
                 var drawableText = CreateText(text);
+
                 if (drawableText != null)
                 {
                     drawableText.Margin = new MarginPadding { Horizontal = margin };

From bee7760d29e884dff532828e3bbb1f1d71fd3d6d Mon Sep 17 00:00:00 2001
From: Andrei Zavatski <megaman9919@gmail.com>
Date: Tue, 10 Sep 2019 01:36:25 +0300
Subject: [PATCH 0017/5547] Make MaxPages value a bindable

---
 .../UserInterface/TestScenePageSelector.cs    | 47 ++++++++++---------
 .../Graphics/UserInterface/PageSelector.cs    | 40 ++++++++++++----
 2 files changed, 57 insertions(+), 30 deletions(-)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestScenePageSelector.cs b/osu.Game.Tests/Visual/UserInterface/TestScenePageSelector.cs
index cb83fbd028..14cb27c97e 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestScenePageSelector.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestScenePageSelector.cs
@@ -15,35 +15,40 @@ namespace osu.Game.Tests.Visual.UserInterface
             typeof(PageSelector)
         };
 
+        private readonly PageSelector pageSelector;
+
         public TestScenePageSelector()
         {
-            Child = new PageSelector(200)
+            Child = pageSelector = new PageSelector
             {
                 Anchor = Anchor.Centre,
                 Origin = Anchor.Centre,
             };
 
-            AddStep("1 max pages", () => redraw(1));
-            AddStep("10 max pages", () => redraw(10));
-            AddStep("200 max pages, current 199", () => redraw(200, 199));
-            AddStep("200 max pages, current 201", () => redraw(200, 201));
-            AddStep("200 max pages, current -10", () => redraw(200, -10));
-        }
-
-        private void redraw(int maxPages, int currentPage = 0)
-        {
-            Clear();
-
-            var selector = new PageSelector(maxPages)
+            AddStep("10 max pages", () => setMaxPages(10));
+            AddStep("200 max pages, current 199", () =>
             {
-                Anchor = Anchor.Centre,
-                Origin = Anchor.Centre,
-            };
-
-            if (currentPage != 0)
-                selector.CurrentPage.Value = currentPage;
-
-            Add(selector);
+                setMaxPages(200);
+                setCurrentPage(199);
+            });
+            AddStep("200 max pages, current 201", () =>
+            {
+                setMaxPages(200);
+                setCurrentPage(201);
+            });
+            AddStep("200 max pages, current -10", () =>
+            {
+                setMaxPages(200);
+                setCurrentPage(-10);
+            });
+            AddStep("-10 max pages", () =>
+            {
+                setMaxPages(-10);
+            });
         }
+
+        private void setMaxPages(int maxPages) => pageSelector.MaxPages.Value = maxPages;
+
+        private void setCurrentPage(int currentPage) => pageSelector.CurrentPage.Value = currentPage;
     }
 }
diff --git a/osu.Game/Graphics/UserInterface/PageSelector.cs b/osu.Game/Graphics/UserInterface/PageSelector.cs
index 9db6366ad6..66f51a6dad 100644
--- a/osu.Game/Graphics/UserInterface/PageSelector.cs
+++ b/osu.Game/Graphics/UserInterface/PageSelector.cs
@@ -20,17 +20,15 @@ namespace osu.Game.Graphics.UserInterface
     public class PageSelector : CompositeDrawable
     {
         public readonly BindableInt CurrentPage = new BindableInt(1);
+        public readonly BindableInt MaxPages = new BindableInt(1);
 
-        private readonly int maxPages;
         private readonly FillFlowContainer itemsFlow;
 
         private readonly Button previousPageButton;
         private readonly Button nextPageButton;
 
-        public PageSelector(int maxPages)
+        public PageSelector()
         {
-            this.maxPages = maxPages;
-
             AutoSizeAxes = Axes.Both;
             InternalChild = new FillFlowContainer
             {
@@ -59,24 +57,48 @@ namespace osu.Game.Graphics.UserInterface
         {
             base.LoadComplete();
 
-            CurrentPage.BindValueChanged(_ => redraw(), true);
+            MaxPages.BindValueChanged(pagesAmount => onMaxPagesChanged(pagesAmount.NewValue), true);
+            CurrentPage.BindValueChanged(page => onCurrentPageChanged(page.NewValue), true);
         }
 
-        private void redraw()
+        private void onMaxPagesChanged(int pagesAmount)
         {
-            if (CurrentPage.Value > maxPages)
+            if (pagesAmount < 1)
             {
-                CurrentPage.Value = maxPages;
+                MaxPages.Value = 1;
                 return;
             }
 
-            if (CurrentPage.Value < 1)
+            if (CurrentPage.Value > pagesAmount)
+            {
+                CurrentPage.Value = pagesAmount;
+                return;
+            }
+
+            redraw();
+        }
+
+        private void onCurrentPageChanged(int newPage)
+        {
+            if (newPage > MaxPages.Value)
+            {
+                CurrentPage.Value = MaxPages.Value;
+                return;
+            }
+
+            if (newPage < 1)
             {
                 CurrentPage.Value = 1;
                 return;
             }
 
+            redraw();
+        }
+
+        private void redraw()
+        {
             int newPage = CurrentPage.Value;
+            int maxPages = MaxPages.Value;
 
             previousPageButton.Enabled.Value = newPage != 1;
             nextPageButton.Enabled.Value = newPage != maxPages;

From eb683b079b5c8dd20888a8dab9ce5ac8daf6077a Mon Sep 17 00:00:00 2001
From: Andrei Zavatski <megaman9919@gmail.com>
Date: Tue, 10 Sep 2019 05:12:50 +0300
Subject: [PATCH 0018/5547] Adjust colours

---
 osu.Game/Graphics/UserInterface/PageSelector.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Graphics/UserInterface/PageSelector.cs b/osu.Game/Graphics/UserInterface/PageSelector.cs
index 66f51a6dad..25e6ed654c 100644
--- a/osu.Game/Graphics/UserInterface/PageSelector.cs
+++ b/osu.Game/Graphics/UserInterface/PageSelector.cs
@@ -172,8 +172,8 @@ namespace osu.Game.Graphics.UserInterface
             [BackgroundDependencyLoader]
             private void load(OsuColour colours)
             {
-                IdleColour = colours.Seafoam;
-                HoverColour = colours.Seafoam.Lighten(30f);
+                IdleColour = colours.Lime;
+                HoverColour = colours.Lime.Lighten(20f);
             }
 
             protected abstract Drawable CreateText(string text);

From 41be9b3f8f08dd691a38ab1ff50872d126fe9f2e Mon Sep 17 00:00:00 2001
From: Andrei Zavatski <megaman9919@gmail.com>
Date: Thu, 19 Sep 2019 16:45:38 +0300
Subject: [PATCH 0019/5547] Add asserts to the test scene

---
 osu.Game.Tests/Visual/UserInterface/TestScenePageSelector.cs | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestScenePageSelector.cs b/osu.Game.Tests/Visual/UserInterface/TestScenePageSelector.cs
index 14cb27c97e..3516e23f98 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestScenePageSelector.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestScenePageSelector.cs
@@ -36,15 +36,18 @@ namespace osu.Game.Tests.Visual.UserInterface
                 setMaxPages(200);
                 setCurrentPage(201);
             });
+            AddAssert("Current equals max", () => pageSelector.CurrentPage.Value == pageSelector.MaxPages.Value);
             AddStep("200 max pages, current -10", () =>
             {
                 setMaxPages(200);
                 setCurrentPage(-10);
             });
+            AddAssert("Current is 1", () => pageSelector.CurrentPage.Value == 1);
             AddStep("-10 max pages", () =>
             {
                 setMaxPages(-10);
             });
+            AddAssert("Current is 1, max is 1", () => pageSelector.CurrentPage.Value == 1 && pageSelector.MaxPages.Value == 1);
         }
 
         private void setMaxPages(int maxPages) => pageSelector.MaxPages.Value = maxPages;

From 2c0694257cd82e1dd539e0fb88424db7a6e1daba Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 5 Dec 2019 14:44:34 +0900
Subject: [PATCH 0020/5547] Fix incorrect spritetext usage

---
 osu.Game/Graphics/UserInterface/PageSelector.cs | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Graphics/UserInterface/PageSelector.cs b/osu.Game/Graphics/UserInterface/PageSelector.cs
index 25e6ed654c..c9f0f3c74d 100644
--- a/osu.Game/Graphics/UserInterface/PageSelector.cs
+++ b/osu.Game/Graphics/UserInterface/PageSelector.cs
@@ -13,6 +13,7 @@ using osuTK;
 using osu.Game.Graphics.Containers;
 using System.Collections.Generic;
 using osu.Framework.Extensions.IEnumerableExtensions;
+using osu.Game.Graphics.Sprites;
 using osuTK.Graphics;
 
 namespace osu.Game.Graphics.UserInterface
@@ -192,7 +193,7 @@ namespace osu.Game.Graphics.UserInterface
             {
             }
 
-            protected override Drawable CreateText(string text) => SpriteText = new SpriteText
+            protected override Drawable CreateText(string text) => SpriteText = new OsuSpriteText
             {
                 Anchor = Anchor.Centre,
                 Origin = Anchor.Centre,
@@ -293,7 +294,7 @@ namespace osu.Game.Graphics.UserInterface
                 Direction = FillDirection.Horizontal,
                 Children = new Drawable[]
                 {
-                    new SpriteText
+                    new OsuSpriteText
                     {
                         Text = text.ToUpper(),
                         Font = OsuFont.GetFont(size: 12),

From 6fbbee3093a124021ee80bb053807dba8ec71832 Mon Sep 17 00:00:00 2001
From: Andrei Zavatski <megaman9919@gmail.com>
Date: Sat, 4 Jan 2020 19:03:39 +0300
Subject: [PATCH 0021/5547] Move PageSelector to another namespace and organize
 TestScene

---
 .../UserInterface/TestScenePageSelector.cs     | 18 +++++++++++++-----
 .../{ => PageSelector}/PageSelector.cs         |  2 +-
 2 files changed, 14 insertions(+), 6 deletions(-)
 rename osu.Game/Graphics/UserInterface/{ => PageSelector}/PageSelector.cs (99%)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestScenePageSelector.cs b/osu.Game.Tests/Visual/UserInterface/TestScenePageSelector.cs
index 3516e23f98..59491b7f90 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestScenePageSelector.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestScenePageSelector.cs
@@ -3,8 +3,9 @@
 
 using System;
 using System.Collections.Generic;
-using osu.Game.Graphics.UserInterface;
+using NUnit.Framework;
 using osu.Framework.Graphics;
+using osu.Game.Graphics.UserInterface.PageSelector;
 
 namespace osu.Game.Tests.Visual.UserInterface
 {
@@ -19,12 +20,19 @@ namespace osu.Game.Tests.Visual.UserInterface
 
         public TestScenePageSelector()
         {
-            Child = pageSelector = new PageSelector
+            AddRange(new Drawable[]
             {
-                Anchor = Anchor.Centre,
-                Origin = Anchor.Centre,
-            };
+                pageSelector = new PageSelector
+                {
+                    Anchor = Anchor.Centre,
+                    Origin = Anchor.Centre,
+                }
+            });
+        }
 
+        [Test]
+        public void TestPageSelectorValues()
+        {
             AddStep("10 max pages", () => setMaxPages(10));
             AddStep("200 max pages, current 199", () =>
             {
diff --git a/osu.Game/Graphics/UserInterface/PageSelector.cs b/osu.Game/Graphics/UserInterface/PageSelector/PageSelector.cs
similarity index 99%
rename from osu.Game/Graphics/UserInterface/PageSelector.cs
rename to osu.Game/Graphics/UserInterface/PageSelector/PageSelector.cs
index c9f0f3c74d..6767cb3a75 100644
--- a/osu.Game/Graphics/UserInterface/PageSelector.cs
+++ b/osu.Game/Graphics/UserInterface/PageSelector/PageSelector.cs
@@ -16,7 +16,7 @@ using osu.Framework.Extensions.IEnumerableExtensions;
 using osu.Game.Graphics.Sprites;
 using osuTK.Graphics;
 
-namespace osu.Game.Graphics.UserInterface
+namespace osu.Game.Graphics.UserInterface.PageSelector
 {
     public class PageSelector : CompositeDrawable
     {

From 70387c19f3f4be9413541b2588d1cf0d9de49d60 Mon Sep 17 00:00:00 2001
From: Andrei Zavatski <megaman9919@gmail.com>
Date: Sat, 4 Jan 2020 19:36:05 +0300
Subject: [PATCH 0022/5547] Implement proper DrawablePage component

---
 .../UserInterface/TestScenePageSelector.cs    |  17 ++-
 .../PageSelector/DrawablePage.cs              | 108 ++++++++++++++++++
 .../PageSelector/PageSelector.cs              |   2 +
 3 files changed, 126 insertions(+), 1 deletion(-)
 create mode 100644 osu.Game/Graphics/UserInterface/PageSelector/DrawablePage.cs

diff --git a/osu.Game.Tests/Visual/UserInterface/TestScenePageSelector.cs b/osu.Game.Tests/Visual/UserInterface/TestScenePageSelector.cs
index 59491b7f90..aad640ab58 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestScenePageSelector.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestScenePageSelector.cs
@@ -13,10 +13,12 @@ namespace osu.Game.Tests.Visual.UserInterface
     {
         public override IReadOnlyList<Type> RequiredTypes => new[]
         {
-            typeof(PageSelector)
+            typeof(PageSelector),
+            typeof(DrawablePage)
         };
 
         private readonly PageSelector pageSelector;
+        private readonly DrawablePage drawablePage;
 
         public TestScenePageSelector()
         {
@@ -26,6 +28,12 @@ namespace osu.Game.Tests.Visual.UserInterface
                 {
                     Anchor = Anchor.Centre,
                     Origin = Anchor.Centre,
+                },
+                drawablePage = new DrawablePage(1234)
+                {
+                    Anchor = Anchor.TopCentre,
+                    Origin = Anchor.TopCentre,
+                    Margin = new MarginPadding { Top = 50 },
                 }
             });
         }
@@ -58,6 +66,13 @@ namespace osu.Game.Tests.Visual.UserInterface
             AddAssert("Current is 1, max is 1", () => pageSelector.CurrentPage.Value == 1 && pageSelector.MaxPages.Value == 1);
         }
 
+        [Test]
+        public void TestDrawablePage()
+        {
+            AddStep("Select", () => drawablePage.Selected = true);
+            AddStep("Deselect", () => drawablePage.Selected = false);
+        }
+
         private void setMaxPages(int maxPages) => pageSelector.MaxPages.Value = maxPages;
 
         private void setCurrentPage(int currentPage) => pageSelector.CurrentPage.Value = currentPage;
diff --git a/osu.Game/Graphics/UserInterface/PageSelector/DrawablePage.cs b/osu.Game/Graphics/UserInterface/PageSelector/DrawablePage.cs
new file mode 100644
index 0000000000..fe91874159
--- /dev/null
+++ b/osu.Game/Graphics/UserInterface/PageSelector/DrawablePage.cs
@@ -0,0 +1,108 @@
+// 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.Containers;
+using osu.Framework.Graphics;
+using osu.Framework.Bindables;
+using osu.Framework.Allocation;
+using osu.Framework.Graphics.Shapes;
+using osu.Framework.Extensions.Color4Extensions;
+using osu.Game.Graphics.Containers;
+using osu.Game.Graphics.Sprites;
+using osu.Framework.Input.Events;
+
+namespace osu.Game.Graphics.UserInterface.PageSelector
+{
+    public class DrawablePage : OsuClickableContainer
+    {
+        private const int duration = 200;
+
+        private readonly BindableBool selected = new BindableBool();
+
+        public bool Selected
+        {
+            get => selected.Value;
+            set => selected.Value = value;
+        }
+
+        [Resolved]
+        private OsuColour colours { get; set; }
+
+        private readonly Box background;
+        private readonly OsuSpriteText text;
+
+        public DrawablePage(int page)
+        {
+            AutoSizeAxes = Axes.X;
+            Height = PageSelector.HEIGHT;
+            Child = new CircularContainer
+            {
+                RelativeSizeAxes = Axes.Y,
+                AutoSizeAxes = Axes.X,
+                Masking = true,
+                Children = new Drawable[]
+                {
+                    background = new Box
+                    {
+                        RelativeSizeAxes = Axes.Both,
+                        Alpha = 0,
+                    },
+                    text = new OsuSpriteText
+                    {
+                        Anchor = Anchor.Centre,
+                        Origin = Anchor.Centre,
+                        Text = page.ToString(),
+                        Font = OsuFont.GetFont(size: 12),
+                        Margin = new MarginPadding { Horizontal = 10 }
+                    }
+                }
+            };
+        }
+
+        [BackgroundDependencyLoader]
+        private void load()
+        {
+            background.Colour = colours.Lime;
+        }
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+            selected.BindValueChanged(onSelectedChanged, true);
+        }
+
+        private void onSelectedChanged(ValueChangedEvent<bool> selected)
+        {
+            background.FadeTo(selected.NewValue ? 1 : 0, duration, Easing.OutQuint);
+            text.FadeColour(selected.NewValue ? colours.GreySeafoamDarker : colours.Lime, duration, Easing.OutQuint);
+        }
+
+        protected override bool OnClick(ClickEvent e)
+        {
+            if (!selected.Value)
+                selected.Value = true;
+
+            return base.OnClick(e);
+        }
+
+        protected override bool OnHover(HoverEvent e)
+        {
+            updateHoverState();
+            return base.OnHover(e);
+        }
+
+        protected override void OnHoverLost(HoverLostEvent e)
+        {
+            base.OnHoverLost(e);
+            updateHoverState();
+        }
+
+        private void updateHoverState()
+        {
+            if (selected.Value)
+                return;
+
+            text.FadeColour(IsHovered ? colours.Lime.Lighten(20f) : colours.Lime, duration, Easing.OutQuint);
+        }
+    }
+}
diff --git a/osu.Game/Graphics/UserInterface/PageSelector/PageSelector.cs b/osu.Game/Graphics/UserInterface/PageSelector/PageSelector.cs
index 6767cb3a75..54e3a035ec 100644
--- a/osu.Game/Graphics/UserInterface/PageSelector/PageSelector.cs
+++ b/osu.Game/Graphics/UserInterface/PageSelector/PageSelector.cs
@@ -20,6 +20,8 @@ namespace osu.Game.Graphics.UserInterface.PageSelector
 {
     public class PageSelector : CompositeDrawable
     {
+        public const int HEIGHT = 20;
+
         public readonly BindableInt CurrentPage = new BindableInt(1);
         public readonly BindableInt MaxPages = new BindableInt(1);
 

From 9af9da039da0c696a3277f4f19d5251a7561883f Mon Sep 17 00:00:00 2001
From: Andrei Zavatski <megaman9919@gmail.com>
Date: Sat, 4 Jan 2020 21:14:56 +0300
Subject: [PATCH 0023/5547] Implement proper PageSelectorItem

---
 .../UserInterface/TestScenePageSelector.cs    |   5 +-
 .../PageSelector/DrawablePage.cs              |  79 ++---
 .../PageSelector/PageSelector.cs              | 284 +++---------------
 .../PageSelector/PageSelectorButton.cs        |  77 +++++
 .../PageSelector/PageSelectorItem.cs          |  75 +++++
 5 files changed, 222 insertions(+), 298 deletions(-)
 create mode 100644 osu.Game/Graphics/UserInterface/PageSelector/PageSelectorButton.cs
 create mode 100644 osu.Game/Graphics/UserInterface/PageSelector/PageSelectorItem.cs

diff --git a/osu.Game.Tests/Visual/UserInterface/TestScenePageSelector.cs b/osu.Game.Tests/Visual/UserInterface/TestScenePageSelector.cs
index aad640ab58..33deff58dc 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestScenePageSelector.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestScenePageSelector.cs
@@ -14,7 +14,9 @@ namespace osu.Game.Tests.Visual.UserInterface
         public override IReadOnlyList<Type> RequiredTypes => new[]
         {
             typeof(PageSelector),
-            typeof(DrawablePage)
+            typeof(DrawablePage),
+            typeof(PageSelectorButton),
+            typeof(PageSelectorItem)
         };
 
         private readonly PageSelector pageSelector;
@@ -42,6 +44,7 @@ namespace osu.Game.Tests.Visual.UserInterface
         public void TestPageSelectorValues()
         {
             AddStep("10 max pages", () => setMaxPages(10));
+            AddStep("11 max pages", () => setMaxPages(11));
             AddStep("200 max pages, current 199", () =>
             {
                 setMaxPages(200);
diff --git a/osu.Game/Graphics/UserInterface/PageSelector/DrawablePage.cs b/osu.Game/Graphics/UserInterface/PageSelector/DrawablePage.cs
index fe91874159..20f418085d 100644
--- a/osu.Game/Graphics/UserInterface/PageSelector/DrawablePage.cs
+++ b/osu.Game/Graphics/UserInterface/PageSelector/DrawablePage.cs
@@ -1,22 +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 osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics;
 using osu.Framework.Bindables;
 using osu.Framework.Allocation;
-using osu.Framework.Graphics.Shapes;
 using osu.Framework.Extensions.Color4Extensions;
-using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
-using osu.Framework.Input.Events;
 
 namespace osu.Game.Graphics.UserInterface.PageSelector
 {
-    public class DrawablePage : OsuClickableContainer
+    public class DrawablePage : PageSelectorItem
     {
-        private const int duration = 200;
-
         private readonly BindableBool selected = new BindableBool();
 
         public bool Selected
@@ -25,44 +19,33 @@ namespace osu.Game.Graphics.UserInterface.PageSelector
             set => selected.Value = value;
         }
 
-        [Resolved]
-        private OsuColour colours { get; set; }
+        public int Page { get; private set; }
 
-        private readonly Box background;
-        private readonly OsuSpriteText text;
+        private OsuSpriteText text;
 
         public DrawablePage(int page)
         {
-            AutoSizeAxes = Axes.X;
-            Height = PageSelector.HEIGHT;
-            Child = new CircularContainer
+            Page = page;
+            text.Text = page.ToString();
+
+            Background.Alpha = 0;
+
+            Action = () =>
             {
-                RelativeSizeAxes = Axes.Y,
-                AutoSizeAxes = Axes.X,
-                Masking = true,
-                Children = new Drawable[]
-                {
-                    background = new Box
-                    {
-                        RelativeSizeAxes = Axes.Both,
-                        Alpha = 0,
-                    },
-                    text = new OsuSpriteText
-                    {
-                        Anchor = Anchor.Centre,
-                        Origin = Anchor.Centre,
-                        Text = page.ToString(),
-                        Font = OsuFont.GetFont(size: 12),
-                        Margin = new MarginPadding { Horizontal = 10 }
-                    }
-                }
+                if (!selected.Value)
+                    selected.Value = true;
             };
         }
 
+        protected override Drawable CreateContent() => text = new OsuSpriteText
+        {
+            Font = OsuFont.GetFont(size: 12),
+        };
+
         [BackgroundDependencyLoader]
         private void load()
         {
-            background.Colour = colours.Lime;
+            Background.Colour = Colours.Lime;
         }
 
         protected override void LoadComplete()
@@ -73,36 +56,16 @@ namespace osu.Game.Graphics.UserInterface.PageSelector
 
         private void onSelectedChanged(ValueChangedEvent<bool> selected)
         {
-            background.FadeTo(selected.NewValue ? 1 : 0, duration, Easing.OutQuint);
-            text.FadeColour(selected.NewValue ? colours.GreySeafoamDarker : colours.Lime, duration, Easing.OutQuint);
+            Background.FadeTo(selected.NewValue ? 1 : 0, DURATION, Easing.OutQuint);
+            text.FadeColour(selected.NewValue ? Colours.GreySeafoamDarker : Colours.Lime, DURATION, Easing.OutQuint);
         }
 
-        protected override bool OnClick(ClickEvent e)
-        {
-            if (!selected.Value)
-                selected.Value = true;
-
-            return base.OnClick(e);
-        }
-
-        protected override bool OnHover(HoverEvent e)
-        {
-            updateHoverState();
-            return base.OnHover(e);
-        }
-
-        protected override void OnHoverLost(HoverLostEvent e)
-        {
-            base.OnHoverLost(e);
-            updateHoverState();
-        }
-
-        private void updateHoverState()
+        protected override void UpdateHoverState()
         {
             if (selected.Value)
                 return;
 
-            text.FadeColour(IsHovered ? colours.Lime.Lighten(20f) : colours.Lime, duration, Easing.OutQuint);
+            text.FadeColour(IsHovered ? Colours.Lime.Lighten(20f) : Colours.Lime, DURATION, Easing.OutQuint);
         }
     }
 }
diff --git a/osu.Game/Graphics/UserInterface/PageSelector/PageSelector.cs b/osu.Game/Graphics/UserInterface/PageSelector/PageSelector.cs
index 54e3a035ec..ae6fc2b500 100644
--- a/osu.Game/Graphics/UserInterface/PageSelector/PageSelector.cs
+++ b/osu.Game/Graphics/UserInterface/PageSelector/PageSelector.cs
@@ -4,17 +4,7 @@
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics;
 using osu.Framework.Bindables;
-using osu.Framework.Allocation;
-using osu.Framework.Graphics.Shapes;
-using osu.Framework.Graphics.Sprites;
-using osu.Framework.Extensions.Color4Extensions;
-using System;
-using osuTK;
-using osu.Game.Graphics.Containers;
-using System.Collections.Generic;
 using osu.Framework.Extensions.IEnumerableExtensions;
-using osu.Game.Graphics.Sprites;
-using osuTK.Graphics;
 
 namespace osu.Game.Graphics.UserInterface.PageSelector
 {
@@ -25,10 +15,10 @@ namespace osu.Game.Graphics.UserInterface.PageSelector
         public readonly BindableInt CurrentPage = new BindableInt(1);
         public readonly BindableInt MaxPages = new BindableInt(1);
 
-        private readonly FillFlowContainer itemsFlow;
+        private readonly FillFlowContainer<DrawablePage> itemsFlow;
 
-        private readonly Button previousPageButton;
-        private readonly Button nextPageButton;
+        private readonly PageSelectorButton previousPageButton;
+        private readonly PageSelectorButton nextPageButton;
 
         public PageSelector()
         {
@@ -39,16 +29,16 @@ namespace osu.Game.Graphics.UserInterface.PageSelector
                 Direction = FillDirection.Horizontal,
                 Children = new Drawable[]
                 {
-                    previousPageButton = new Button(false, "prev")
+                    previousPageButton = new PageSelectorButton(false, "prev")
                     {
                         Action = () => CurrentPage.Value -= 1,
                     },
-                    itemsFlow = new FillFlowContainer
+                    itemsFlow = new FillFlowContainer<DrawablePage>
                     {
                         AutoSizeAxes = Axes.Both,
                         Direction = FillDirection.Horizontal,
                     },
-                    nextPageButton = new Button(true, "next")
+                    nextPageButton = new PageSelectorButton(true, "next")
                     {
                         Action = () => CurrentPage.Value += 1
                     }
@@ -60,253 +50,69 @@ namespace osu.Game.Graphics.UserInterface.PageSelector
         {
             base.LoadComplete();
 
-            MaxPages.BindValueChanged(pagesAmount => onMaxPagesChanged(pagesAmount.NewValue), true);
-            CurrentPage.BindValueChanged(page => onCurrentPageChanged(page.NewValue), true);
-        }
-
-        private void onMaxPagesChanged(int pagesAmount)
-        {
-            if (pagesAmount < 1)
-            {
-                MaxPages.Value = 1;
-                return;
-            }
-
-            if (CurrentPage.Value > pagesAmount)
-            {
-                CurrentPage.Value = pagesAmount;
-                return;
-            }
-
+            MaxPages.BindValueChanged(_ => redraw());
+            CurrentPage.BindValueChanged(page => onCurrentPageChanged(page.NewValue));
             redraw();
         }
 
         private void onCurrentPageChanged(int newPage)
         {
-            if (newPage > MaxPages.Value)
-            {
-                CurrentPage.Value = MaxPages.Value;
-                return;
-            }
-
             if (newPage < 1)
             {
                 CurrentPage.Value = 1;
                 return;
             }
 
-            redraw();
+            if (newPage > MaxPages.Value)
+            {
+                CurrentPage.Value = MaxPages.Value;
+                return;
+            }
+
+            itemsFlow.ForEach(page => page.Selected = page.Page == newPage ? true : false);
+            updateButtonsState();
         }
 
         private void redraw()
+        {
+            itemsFlow.Clear();
+
+            if (MaxPages.Value < 1)
+            {
+                MaxPages.Value = 1;
+                return;
+            }
+
+            for (int i = 1; i <= MaxPages.Value; i++)
+                addDrawablePage(i);
+
+            if (CurrentPage.Value > MaxPages.Value)
+            {
+                CurrentPage.Value = MaxPages.Value;
+                return;
+            }
+
+            if (CurrentPage.Value < 1)
+            {
+                CurrentPage.Value = 1;
+                return;
+            }
+
+            CurrentPage.TriggerChange();
+        }
+
+        private void updateButtonsState()
         {
             int newPage = CurrentPage.Value;
             int maxPages = MaxPages.Value;
 
             previousPageButton.Enabled.Value = newPage != 1;
             nextPageButton.Enabled.Value = newPage != maxPages;
-
-            itemsFlow.Clear();
-
-            if (newPage > 3)
-                addDrawablePage(1);
-
-            if (newPage > 4)
-                addPlaceholder();
-
-            for (int i = Math.Max(newPage - 2, 1); i <= Math.Min(newPage + 2, maxPages); i++)
-            {
-                if (i == newPage)
-                    addDrawableCurrentPage();
-                else
-                    addDrawablePage(i);
-            }
-
-            if (newPage + 2 < maxPages - 1)
-                addPlaceholder();
-
-            if (newPage + 2 < maxPages)
-                addDrawablePage(maxPages);
         }
 
-        private void addDrawablePage(int page) => itemsFlow.Add(new DrawablePage(page.ToString())
+        private void addDrawablePage(int page) => itemsFlow.Add(new DrawablePage(page)
         {
             Action = () => CurrentPage.Value = page,
         });
-
-        private void addPlaceholder() => itemsFlow.Add(new Placeholder());
-
-        private void addDrawableCurrentPage() => itemsFlow.Add(new SelectedPage(CurrentPage.Value.ToString()));
-
-        private abstract class PageItem : OsuHoverContainer
-        {
-            private const int margin = 10;
-            private const int height = 20;
-
-            protected override Container<Drawable> Content => contentContainer;
-
-            private readonly CircularContainer contentContainer;
-
-            protected PageItem(string text)
-            {
-                AutoSizeAxes = Axes.X;
-                Height = height;
-
-                base.Content.Add(contentContainer = new CircularContainer
-                {
-                    AutoSizeAxes = Axes.X,
-                    RelativeSizeAxes = Axes.Y,
-                    Masking = true,
-                });
-
-                var background = CreateBackground();
-                if (background != null)
-                    Add(background);
-
-                var drawableText = CreateText(text);
-
-                if (drawableText != null)
-                {
-                    drawableText.Margin = new MarginPadding { Horizontal = margin };
-                    Add(drawableText);
-                }
-            }
-
-            [BackgroundDependencyLoader]
-            private void load(OsuColour colours)
-            {
-                IdleColour = colours.Lime;
-                HoverColour = colours.Lime.Lighten(20f);
-            }
-
-            protected abstract Drawable CreateText(string text);
-
-            protected virtual Drawable CreateBackground() => null;
-        }
-
-        private class DrawablePage : PageItem
-        {
-            protected SpriteText SpriteText;
-
-            protected override IEnumerable<Drawable> EffectTargets => new[] { SpriteText };
-
-            public DrawablePage(string text)
-                : base(text)
-            {
-            }
-
-            protected override Drawable CreateText(string text) => SpriteText = new OsuSpriteText
-            {
-                Anchor = Anchor.Centre,
-                Origin = Anchor.Centre,
-                Text = text,
-                Font = OsuFont.GetFont(size: 12),
-            };
-        }
-
-        private class SelectedPage : DrawablePage
-        {
-            private Box background;
-
-            protected override IEnumerable<Drawable> EffectTargets => new[] { background };
-
-            public SelectedPage(string text)
-                : base(text)
-            {
-            }
-
-            protected override Drawable CreateBackground() => background = new Box
-            {
-                RelativeSizeAxes = Axes.Both,
-            };
-
-            [BackgroundDependencyLoader]
-            private void load(OsuColour colours)
-            {
-                SpriteText.Colour = colours.GreySeafoamDark;
-            }
-        }
-
-        private class Placeholder : DrawablePage
-        {
-            public Placeholder()
-                : base("...")
-            {
-            }
-        }
-
-        private class Button : PageItem
-        {
-            private const int duration = 100;
-
-            private Box background;
-            private FillFlowContainer textContainer;
-            private SpriteIcon icon;
-            private readonly Box fadeBox;
-
-            protected override IEnumerable<Drawable> EffectTargets => new[] { textContainer };
-
-            public Button(bool rightAligned, string text)
-                : base(text)
-            {
-                var alignment = rightAligned ? Anchor.x0 : Anchor.x2;
-
-                textContainer.ForEach(drawable =>
-                {
-                    drawable.Anchor = Anchor.y1 | alignment;
-                    drawable.Origin = Anchor.y1 | alignment;
-                });
-
-                icon.Icon = alignment == Anchor.x2 ? FontAwesome.Solid.ChevronLeft : FontAwesome.Solid.ChevronRight;
-
-                Add(fadeBox = new Box
-                {
-                    RelativeSizeAxes = Axes.Both,
-                    Colour = Color4.Black.Opacity(100)
-                });
-            }
-
-            [BackgroundDependencyLoader]
-            private void load(OsuColour colours)
-            {
-                background.Colour = colours.GreySeafoamDark;
-            }
-
-            protected override void LoadComplete()
-            {
-                base.LoadComplete();
-                Enabled.BindValueChanged(onEnabledChanged, true);
-            }
-
-            private void onEnabledChanged(ValueChangedEvent<bool> enabled)
-            {
-                fadeBox.FadeTo(enabled.NewValue ? 0 : 1, duration);
-            }
-
-            protected override Drawable CreateBackground() => background = new Box
-            {
-                RelativeSizeAxes = Axes.Both,
-            };
-
-            protected override Drawable CreateText(string text) => textContainer = new FillFlowContainer
-            {
-                AutoSizeAxes = Axes.Both,
-                Anchor = Anchor.Centre,
-                Origin = Anchor.Centre,
-                Direction = FillDirection.Horizontal,
-                Children = new Drawable[]
-                {
-                    new OsuSpriteText
-                    {
-                        Text = text.ToUpper(),
-                        Font = OsuFont.GetFont(size: 12),
-                    },
-                    icon = new SpriteIcon
-                    {
-                        Size = new Vector2(8),
-                    },
-                }
-            };
-        }
     }
 }
diff --git a/osu.Game/Graphics/UserInterface/PageSelector/PageSelectorButton.cs b/osu.Game/Graphics/UserInterface/PageSelector/PageSelectorButton.cs
new file mode 100644
index 0000000000..df007b32e0
--- /dev/null
+++ b/osu.Game/Graphics/UserInterface/PageSelector/PageSelectorButton.cs
@@ -0,0 +1,77 @@
+// 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.Containers;
+using osu.Framework.Graphics;
+using osu.Framework.Allocation;
+using osu.Framework.Graphics.Shapes;
+using osu.Framework.Extensions.Color4Extensions;
+using osu.Game.Graphics.Sprites;
+using osu.Framework.Graphics.Sprites;
+using osuTK.Graphics;
+using osuTK;
+using osu.Framework.Extensions.IEnumerableExtensions;
+
+namespace osu.Game.Graphics.UserInterface.PageSelector
+{
+    public class PageSelectorButton : PageSelectorItem
+    {
+        private readonly Box fadeBox;
+        private SpriteIcon icon;
+        private OsuSpriteText name;
+        private FillFlowContainer buttonContent;
+
+        public PageSelectorButton(bool rightAligned, string text)
+        {
+            Add(fadeBox = new Box
+            {
+                RelativeSizeAxes = Axes.Both,
+                Colour = Color4.Black.Opacity(100)
+            });
+
+            var alignment = rightAligned ? Anchor.x0 : Anchor.x2;
+
+            buttonContent.ForEach(drawable =>
+            {
+                drawable.Anchor = Anchor.y1 | alignment;
+                drawable.Origin = Anchor.y1 | alignment;
+            });
+
+            icon.Icon = alignment == Anchor.x2 ? FontAwesome.Solid.ChevronLeft : FontAwesome.Solid.ChevronRight;
+
+            name.Text = text.ToUpper();
+        }
+
+        protected override Drawable CreateContent() => buttonContent = new FillFlowContainer
+        {
+            AutoSizeAxes = Axes.Both,
+            Direction = FillDirection.Horizontal,
+            Children = new Drawable[]
+            {
+                name = new OsuSpriteText
+                {
+                    Font = OsuFont.GetFont(size: 12),
+                },
+                icon = new SpriteIcon
+                {
+                    Size = new Vector2(8),
+                },
+            }
+        };
+
+        [BackgroundDependencyLoader]
+        private void load()
+        {
+            Background.Colour = Colours.GreySeafoamDark;
+            name.Colour = icon.Colour = Colours.Lime;
+        }
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+            Enabled.BindValueChanged(enabled => fadeBox.FadeTo(enabled.NewValue ? 0 : 1, DURATION), true);
+        }
+
+        protected override void UpdateHoverState() => Background.FadeColour(IsHovered ? Colours.GreySeafoam : Colours.GreySeafoamDark, DURATION, Easing.OutQuint);
+    }
+}
diff --git a/osu.Game/Graphics/UserInterface/PageSelector/PageSelectorItem.cs b/osu.Game/Graphics/UserInterface/PageSelector/PageSelectorItem.cs
new file mode 100644
index 0000000000..d457b7ea0e
--- /dev/null
+++ b/osu.Game/Graphics/UserInterface/PageSelector/PageSelectorItem.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 osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics;
+using osu.Framework.Bindables;
+using osu.Framework.Allocation;
+using osu.Framework.Graphics.Shapes;
+using osu.Framework.Extensions.Color4Extensions;
+using osu.Game.Graphics.Containers;
+using osu.Game.Graphics.Sprites;
+using osu.Framework.Input.Events;
+using osu.Framework.Graphics.Sprites;
+using osuTK.Graphics;
+using osuTK;
+using osu.Framework.Extensions.IEnumerableExtensions;
+using JetBrains.Annotations;
+
+namespace osu.Game.Graphics.UserInterface.PageSelector
+{
+    public abstract class PageSelectorItem : OsuClickableContainer
+    {
+        protected const int DURATION = 200;
+
+        [Resolved]
+        protected OsuColour Colours { get; private set; }
+
+        protected override Container<Drawable> Content => content;
+
+        protected readonly Box Background;
+        private readonly CircularContainer content;
+
+        protected PageSelectorItem()
+        {
+            AutoSizeAxes = Axes.X;
+            Height = PageSelector.HEIGHT;
+            base.Content.Add(content = new CircularContainer
+            {
+                RelativeSizeAxes = Axes.Y,
+                AutoSizeAxes = Axes.X,
+                Masking = true,
+                Children = new Drawable[]
+                {
+                    Background = new Box
+                    {
+                        RelativeSizeAxes = Axes.Both
+                    },
+                    CreateContent().With(content =>
+                    {
+                        content.Anchor = Anchor.Centre;
+                        content.Origin = Anchor.Centre;
+                        content.Margin = new MarginPadding { Horizontal = 10 };
+                    })
+                }
+            });
+        }
+
+        [NotNull]
+        protected abstract Drawable CreateContent();
+
+        protected override bool OnHover(HoverEvent e)
+        {
+            UpdateHoverState();
+            return base.OnHover(e);
+        }
+
+        protected override void OnHoverLost(HoverLostEvent e)
+        {
+            base.OnHoverLost(e);
+            UpdateHoverState();
+        }
+
+        protected abstract void UpdateHoverState();
+    }
+}

From b1c5e437ccf2ca260d5b8f177d78144651b1d24d Mon Sep 17 00:00:00 2001
From: Andrei Zavatski <megaman9919@gmail.com>
Date: Sat, 4 Jan 2020 21:22:45 +0300
Subject: [PATCH 0024/5547] Remove usings

---
 .../UserInterface/PageSelector/PageSelectorItem.cs         | 7 -------
 1 file changed, 7 deletions(-)

diff --git a/osu.Game/Graphics/UserInterface/PageSelector/PageSelectorItem.cs b/osu.Game/Graphics/UserInterface/PageSelector/PageSelectorItem.cs
index d457b7ea0e..63eb87a638 100644
--- a/osu.Game/Graphics/UserInterface/PageSelector/PageSelectorItem.cs
+++ b/osu.Game/Graphics/UserInterface/PageSelector/PageSelectorItem.cs
@@ -3,17 +3,10 @@
 
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics;
-using osu.Framework.Bindables;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics.Shapes;
-using osu.Framework.Extensions.Color4Extensions;
 using osu.Game.Graphics.Containers;
-using osu.Game.Graphics.Sprites;
 using osu.Framework.Input.Events;
-using osu.Framework.Graphics.Sprites;
-using osuTK.Graphics;
-using osuTK;
-using osu.Framework.Extensions.IEnumerableExtensions;
 using JetBrains.Annotations;
 
 namespace osu.Game.Graphics.UserInterface.PageSelector

From 37482b2ad474379ed941a5ab3a8c40f813427eaf Mon Sep 17 00:00:00 2001
From: Andrei Zavatski <megaman9919@gmail.com>
Date: Sat, 4 Jan 2020 22:05:34 +0300
Subject: [PATCH 0025/5547] CI fixes

---
 osu.Game/Graphics/UserInterface/PageSelector/PageSelector.cs    | 2 +-
 .../Graphics/UserInterface/PageSelector/PageSelectorItem.cs     | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Graphics/UserInterface/PageSelector/PageSelector.cs b/osu.Game/Graphics/UserInterface/PageSelector/PageSelector.cs
index ae6fc2b500..eaa102bdd2 100644
--- a/osu.Game/Graphics/UserInterface/PageSelector/PageSelector.cs
+++ b/osu.Game/Graphics/UserInterface/PageSelector/PageSelector.cs
@@ -69,7 +69,7 @@ namespace osu.Game.Graphics.UserInterface.PageSelector
                 return;
             }
 
-            itemsFlow.ForEach(page => page.Selected = page.Page == newPage ? true : false);
+            itemsFlow.ForEach(page => page.Selected = page.Page == newPage);
             updateButtonsState();
         }
 
diff --git a/osu.Game/Graphics/UserInterface/PageSelector/PageSelectorItem.cs b/osu.Game/Graphics/UserInterface/PageSelector/PageSelectorItem.cs
index 63eb87a638..5f0bfcdfdb 100644
--- a/osu.Game/Graphics/UserInterface/PageSelector/PageSelectorItem.cs
+++ b/osu.Game/Graphics/UserInterface/PageSelector/PageSelectorItem.cs
@@ -32,7 +32,7 @@ namespace osu.Game.Graphics.UserInterface.PageSelector
                 RelativeSizeAxes = Axes.Y,
                 AutoSizeAxes = Axes.X,
                 Masking = true,
-                Children = new Drawable[]
+                Children = new[]
                 {
                     Background = new Box
                     {

From d3c2dc43bd28812bafffb6d81a596268ed5ddca1 Mon Sep 17 00:00:00 2001
From: Andrei Zavatski <megaman9919@gmail.com>
Date: Sat, 4 Jan 2020 22:25:08 +0300
Subject: [PATCH 0026/5547] TestScene improvements

---
 .../UserInterface/TestScenePageSelector.cs    | 48 +++++++++----------
 .../PageSelector/PageSelector.cs              | 15 ++----
 .../PageSelector/PageSelectorButton.cs        |  1 +
 3 files changed, 27 insertions(+), 37 deletions(-)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestScenePageSelector.cs b/osu.Game.Tests/Visual/UserInterface/TestScenePageSelector.cs
index 33deff58dc..5e1105c834 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestScenePageSelector.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestScenePageSelector.cs
@@ -41,32 +41,30 @@ namespace osu.Game.Tests.Visual.UserInterface
         }
 
         [Test]
-        public void TestPageSelectorValues()
+        public void TestCurrentPageReset()
         {
-            AddStep("10 max pages", () => setMaxPages(10));
-            AddStep("11 max pages", () => setMaxPages(11));
-            AddStep("200 max pages, current 199", () =>
-            {
-                setMaxPages(200);
-                setCurrentPage(199);
-            });
-            AddStep("200 max pages, current 201", () =>
-            {
-                setMaxPages(200);
-                setCurrentPage(201);
-            });
-            AddAssert("Current equals max", () => pageSelector.CurrentPage.Value == pageSelector.MaxPages.Value);
-            AddStep("200 max pages, current -10", () =>
-            {
-                setMaxPages(200);
-                setCurrentPage(-10);
-            });
-            AddAssert("Current is 1", () => pageSelector.CurrentPage.Value == 1);
-            AddStep("-10 max pages", () =>
-            {
-                setMaxPages(-10);
-            });
-            AddAssert("Current is 1, max is 1", () => pageSelector.CurrentPage.Value == 1 && pageSelector.MaxPages.Value == 1);
+            AddStep("Set 10 pages", () => setMaxPages(10));
+            AddStep("Select 5 page", () => setCurrentPage(5));
+            AddStep("Set 11 pages", () => setMaxPages(11));
+            AddAssert("Check 1 page is current", () => pageSelector.CurrentPage.Value == 1);
+        }
+
+        [Test]
+        public void TestUnexistingPageSelection()
+        {
+            AddStep("Set 10 pages", () => setMaxPages(10));
+            AddStep("Select 11 page", () => setCurrentPage(11));
+            AddAssert("Check current equals max", () => pageSelector.CurrentPage.Value == pageSelector.MaxPages.Value);
+
+            AddStep("Select -1 page", () => setCurrentPage(-1));
+            AddAssert("Check current is 1", () => pageSelector.CurrentPage.Value == 1);
+        }
+
+        [Test]
+        public void TestNegativeMaxPages()
+        {
+            AddStep("Set -10 pages", () => setMaxPages(-10));
+            AddAssert("Check current and max is 1", () => pageSelector.CurrentPage.Value == 1 && pageSelector.MaxPages.Value == 1);
         }
 
         [Test]
diff --git a/osu.Game/Graphics/UserInterface/PageSelector/PageSelector.cs b/osu.Game/Graphics/UserInterface/PageSelector/PageSelector.cs
index eaa102bdd2..c2482d6330 100644
--- a/osu.Game/Graphics/UserInterface/PageSelector/PageSelector.cs
+++ b/osu.Game/Graphics/UserInterface/PageSelector/PageSelector.cs
@@ -86,19 +86,10 @@ namespace osu.Game.Graphics.UserInterface.PageSelector
             for (int i = 1; i <= MaxPages.Value; i++)
                 addDrawablePage(i);
 
-            if (CurrentPage.Value > MaxPages.Value)
-            {
-                CurrentPage.Value = MaxPages.Value;
-                return;
-            }
-
-            if (CurrentPage.Value < 1)
-            {
+            if (CurrentPage.Value == 1)
+                CurrentPage.TriggerChange();
+            else
                 CurrentPage.Value = 1;
-                return;
-            }
-
-            CurrentPage.TriggerChange();
         }
 
         private void updateButtonsState()
diff --git a/osu.Game/Graphics/UserInterface/PageSelector/PageSelectorButton.cs b/osu.Game/Graphics/UserInterface/PageSelector/PageSelectorButton.cs
index df007b32e0..e81ce20d27 100644
--- a/osu.Game/Graphics/UserInterface/PageSelector/PageSelectorButton.cs
+++ b/osu.Game/Graphics/UserInterface/PageSelector/PageSelectorButton.cs
@@ -46,6 +46,7 @@ namespace osu.Game.Graphics.UserInterface.PageSelector
         {
             AutoSizeAxes = Axes.Both,
             Direction = FillDirection.Horizontal,
+            Spacing = new Vector2(3, 0),
             Children = new Drawable[]
             {
                 name = new OsuSpriteText

From 753db9599a225784c19e3459b6d830d5f62683c6 Mon Sep 17 00:00:00 2001
From: Andrei Zavatski <megaman9919@gmail.com>
Date: Sat, 4 Jan 2020 22:29:11 +0300
Subject: [PATCH 0027/5547] Move items height out of PageSelector

---
 osu.Game/Graphics/UserInterface/PageSelector/PageSelector.cs    | 2 --
 .../Graphics/UserInterface/PageSelector/PageSelectorItem.cs     | 2 +-
 2 files changed, 1 insertion(+), 3 deletions(-)

diff --git a/osu.Game/Graphics/UserInterface/PageSelector/PageSelector.cs b/osu.Game/Graphics/UserInterface/PageSelector/PageSelector.cs
index c2482d6330..8e055faea3 100644
--- a/osu.Game/Graphics/UserInterface/PageSelector/PageSelector.cs
+++ b/osu.Game/Graphics/UserInterface/PageSelector/PageSelector.cs
@@ -10,8 +10,6 @@ namespace osu.Game.Graphics.UserInterface.PageSelector
 {
     public class PageSelector : CompositeDrawable
     {
-        public const int HEIGHT = 20;
-
         public readonly BindableInt CurrentPage = new BindableInt(1);
         public readonly BindableInt MaxPages = new BindableInt(1);
 
diff --git a/osu.Game/Graphics/UserInterface/PageSelector/PageSelectorItem.cs b/osu.Game/Graphics/UserInterface/PageSelector/PageSelectorItem.cs
index 5f0bfcdfdb..cd61961dbe 100644
--- a/osu.Game/Graphics/UserInterface/PageSelector/PageSelectorItem.cs
+++ b/osu.Game/Graphics/UserInterface/PageSelector/PageSelectorItem.cs
@@ -26,7 +26,7 @@ namespace osu.Game.Graphics.UserInterface.PageSelector
         protected PageSelectorItem()
         {
             AutoSizeAxes = Axes.X;
-            Height = PageSelector.HEIGHT;
+            Height = 20;
             base.Content.Add(content = new CircularContainer
             {
                 RelativeSizeAxes = Axes.Y,

From 20ab415838fab4cca9fcf4675d908670032d1b56 Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Mon, 6 Jan 2020 18:04:27 +0900
Subject: [PATCH 0028/5547] Reword tests

---
 .../UserInterface/TestScenePageSelector.cs    | 19 ++++++++++---------
 1 file changed, 10 insertions(+), 9 deletions(-)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestScenePageSelector.cs b/osu.Game.Tests/Visual/UserInterface/TestScenePageSelector.cs
index 5e1105c834..6494486d4e 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestScenePageSelector.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestScenePageSelector.cs
@@ -41,30 +41,31 @@ namespace osu.Game.Tests.Visual.UserInterface
         }
 
         [Test]
-        public void TestCurrentPageReset()
+        public void TestResetCurrentPage()
         {
             AddStep("Set 10 pages", () => setMaxPages(10));
-            AddStep("Select 5 page", () => setCurrentPage(5));
+            AddStep("Select page 5", () => setCurrentPage(5));
             AddStep("Set 11 pages", () => setMaxPages(11));
-            AddAssert("Check 1 page is current", () => pageSelector.CurrentPage.Value == 1);
+            AddAssert("Page 1 is current", () => pageSelector.CurrentPage.Value == 1);
         }
 
         [Test]
-        public void TestUnexistingPageSelection()
+        public void TestOutOfBoundsSelection()
         {
             AddStep("Set 10 pages", () => setMaxPages(10));
-            AddStep("Select 11 page", () => setCurrentPage(11));
-            AddAssert("Check current equals max", () => pageSelector.CurrentPage.Value == pageSelector.MaxPages.Value);
+            AddStep("Select page 11", () => setCurrentPage(11));
+            AddAssert("Page 10 is current", () => pageSelector.CurrentPage.Value == pageSelector.MaxPages.Value);
 
-            AddStep("Select -1 page", () => setCurrentPage(-1));
-            AddAssert("Check current is 1", () => pageSelector.CurrentPage.Value == 1);
+            AddStep("Select page -1", () => setCurrentPage(-1));
+            AddAssert("Page 1 is current", () => pageSelector.CurrentPage.Value == 1);
         }
 
         [Test]
         public void TestNegativeMaxPages()
         {
             AddStep("Set -10 pages", () => setMaxPages(-10));
-            AddAssert("Check current and max is 1", () => pageSelector.CurrentPage.Value == 1 && pageSelector.MaxPages.Value == 1);
+            AddAssert("Page 1 is current", () => pageSelector.CurrentPage.Value == 1);
+            AddAssert("Max is 1", () => pageSelector.MaxPages.Value == 1);
         }
 
         [Test]

From 0a8fd01b994b4c09ceb3b824ae597630967bf22c Mon Sep 17 00:00:00 2001
From: Naxess <30292137+Naxesss@users.noreply.github.com>
Date: Tue, 13 Jul 2021 03:45:21 +0200
Subject: [PATCH 0029/5547] Add zero byte check and tests

---
 .../Editing/Checks/CheckZeroByteFilesTest.cs  | 86 +++++++++++++++++++
 osu.Game/Rulesets/Edit/BeatmapVerifier.cs     |  3 +
 .../Edit/Checks/CheckZeroByteFiles.cs         | 41 +++++++++
 3 files changed, 130 insertions(+)
 create mode 100644 osu.Game.Tests/Editing/Checks/CheckZeroByteFilesTest.cs
 create mode 100644 osu.Game/Rulesets/Edit/Checks/CheckZeroByteFiles.cs

diff --git a/osu.Game.Tests/Editing/Checks/CheckZeroByteFilesTest.cs b/osu.Game.Tests/Editing/Checks/CheckZeroByteFilesTest.cs
new file mode 100644
index 0000000000..c9adc030c1
--- /dev/null
+++ b/osu.Game.Tests/Editing/Checks/CheckZeroByteFilesTest.cs
@@ -0,0 +1,86 @@
+// 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 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 FileInfo = osu.Game.IO.FileInfo;
+
+namespace osu.Game.Tests.Editing.Checks
+{
+    [TestFixture]
+    public class CheckZeroByteFilesTest
+    {
+        private CheckZeroByteFiles check;
+        private IBeatmap beatmap;
+
+        [SetUp]
+        public void Setup()
+        {
+            check = new CheckZeroByteFiles();
+            beatmap = new Beatmap<HitObject>
+            {
+                BeatmapInfo = new BeatmapInfo
+                {
+                    BeatmapSet = new BeatmapSetInfo
+                    {
+                        Files = new List<BeatmapSetFileInfo>(new[]
+                        {
+                            new BeatmapSetFileInfo
+                            {
+                                Filename = "abc123.jpg",
+                                FileInfo = new FileInfo { Hash = "abcdef" }
+                            }
+                        })
+                    }
+                }
+            };
+        }
+
+        [Test]
+        public void TestNonZeroBytes()
+        {
+            Assert.IsEmpty(check.Run(getContext(byteLength: 44)));
+        }
+
+        [Test]
+        public void TestZeroBytes()
+        {
+            var issues = check.Run(getContext(byteLength: 0)).ToList();
+
+            Assert.That(issues, Has.Count.EqualTo(1));
+            Assert.That(issues.Single().Template is CheckZeroByteFiles.IssueTemplateZeroBytes);
+        }
+
+        [Test]
+        public void TestMissing()
+        {
+            Assert.IsEmpty(check.Run(getContextMissing()));
+        }
+
+        private BeatmapVerifierContext getContext(long byteLength)
+        {
+            var mockStream = new Mock<Stream>();
+            mockStream.Setup(s => s.Length).Returns(byteLength);
+
+            var mockWorkingBeatmap = new Mock<IWorkingBeatmap>();
+            mockWorkingBeatmap.Setup(w => w.GetStream(It.IsAny<string>())).Returns(mockStream.Object);
+
+            return new BeatmapVerifierContext(beatmap, mockWorkingBeatmap.Object);
+        }
+
+        private BeatmapVerifierContext getContextMissing()
+        {
+            var mockWorkingBeatmap = new Mock<IWorkingBeatmap>();
+            mockWorkingBeatmap.Setup(w => w.GetStream(It.IsAny<string>())).Returns((Stream)null);
+
+            return new BeatmapVerifierContext(beatmap, mockWorkingBeatmap.Object);
+        }
+    }
+}
diff --git a/osu.Game/Rulesets/Edit/BeatmapVerifier.cs b/osu.Game/Rulesets/Edit/BeatmapVerifier.cs
index 706eec226c..545fee6264 100644
--- a/osu.Game/Rulesets/Edit/BeatmapVerifier.cs
+++ b/osu.Game/Rulesets/Edit/BeatmapVerifier.cs
@@ -25,6 +25,9 @@ namespace osu.Game.Rulesets.Edit
             new CheckMutedObjects(),
             new CheckFewHitsounds(),
 
+            // Files
+            new CheckZeroByteFiles(),
+
             // Compose
             new CheckUnsnappedObjects(),
             new CheckConcurrentObjects()
diff --git a/osu.Game/Rulesets/Edit/Checks/CheckZeroByteFiles.cs b/osu.Game/Rulesets/Edit/Checks/CheckZeroByteFiles.cs
new file mode 100644
index 0000000000..932d216d94
--- /dev/null
+++ b/osu.Game/Rulesets/Edit/Checks/CheckZeroByteFiles.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 System.Collections.Generic;
+using System.IO;
+using osu.Game.Rulesets.Edit.Checks.Components;
+
+namespace osu.Game.Rulesets.Edit.Checks
+{
+    public class CheckZeroByteFiles : ICheck
+    {
+        public CheckMetadata Metadata => new CheckMetadata(CheckCategory.Files, "Zero-byte files");
+
+        public IEnumerable<IssueTemplate> PossibleTemplates => new IssueTemplate[]
+        {
+            new IssueTemplateZeroBytes(this)
+        };
+
+        public IEnumerable<Issue> Run(BeatmapVerifierContext context)
+        {
+            var beatmapSet = context.Beatmap.BeatmapInfo.BeatmapSet;
+
+            foreach (var file in beatmapSet.Files)
+            {
+                Stream data = context.WorkingBeatmap.GetStream(file.FileInfo.StoragePath);
+                if (data?.Length == 0)
+                    yield return new IssueTemplateZeroBytes(this).Create(file.Filename);
+            }
+        }
+
+        public class IssueTemplateZeroBytes : IssueTemplate
+        {
+            public IssueTemplateZeroBytes(ICheck check)
+                : base(check, IssueType.Problem, "\"{0}\" is a 0-byte file.")
+            {
+            }
+
+            public Issue Create(string filename) => new Issue(this, filename);
+        }
+    }
+}

From a4a1919842769cb68c5c1b4dc503c77918f12859 Mon Sep 17 00:00:00 2001
From: Naxess <30292137+Naxesss@users.noreply.github.com>
Date: Tue, 13 Jul 2021 03:46:45 +0200
Subject: [PATCH 0030/5547] Add too short audio files check and tests

---
 .../Checks/CheckTooShortAudioFilesTest.cs     | 117 ++++++++++++++++++
 osu.Game.Tests/Resources/Samples/blank.wav    | Bin 0 -> 44 bytes
 osu.Game.Tests/Resources/Samples/corrupt.wav  | Bin 0 -> 32334 bytes
 .../Resources/Samples/test-sample-cut.mp3     | Bin 0 -> 2060 bytes
 osu.Game/Rulesets/Edit/BeatmapVerifier.cs     |   1 +
 .../Edit/Checks/CheckTooShortAudioFiles.cs    |  83 +++++++++++++
 6 files changed, 201 insertions(+)
 create mode 100644 osu.Game.Tests/Editing/Checks/CheckTooShortAudioFilesTest.cs
 create mode 100644 osu.Game.Tests/Resources/Samples/blank.wav
 create mode 100644 osu.Game.Tests/Resources/Samples/corrupt.wav
 create mode 100644 osu.Game.Tests/Resources/Samples/test-sample-cut.mp3
 create mode 100644 osu.Game/Rulesets/Edit/Checks/CheckTooShortAudioFiles.cs

diff --git a/osu.Game.Tests/Editing/Checks/CheckTooShortAudioFilesTest.cs b/osu.Game.Tests/Editing/Checks/CheckTooShortAudioFilesTest.cs
new file mode 100644
index 0000000000..e978af5e49
--- /dev/null
+++ b/osu.Game.Tests/Editing/Checks/CheckTooShortAudioFilesTest.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.Collections.Generic;
+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;
+using FileInfo = osu.Game.IO.FileInfo;
+
+namespace osu.Game.Tests.Editing.Checks
+{
+    [TestFixture]
+    public class CheckTooShortAudioFilesTest
+    {
+        private CheckTooShortAudioFiles check;
+        private IBeatmap beatmap;
+
+        [SetUp]
+        public void Setup()
+        {
+            check = new CheckTooShortAudioFiles();
+            beatmap = new Beatmap<HitObject>
+            {
+                BeatmapInfo = new BeatmapInfo
+                {
+                    BeatmapSet = new BeatmapSetInfo
+                    {
+                        Files = new List<BeatmapSetFileInfo>(new[]
+                        {
+                            new BeatmapSetFileInfo
+                            {
+                                Filename = "abc123.wav",
+                                FileInfo = new FileInfo { Hash = "abcdef" }
+                            }
+                        })
+                    }
+                }
+            };
+
+            // 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 TestDifferentExtension()
+        {
+            beatmap.BeatmapInfo.BeatmapSet.Files.Clear();
+            beatmap.BeatmapInfo.BeatmapSet.Files.Add(new BeatmapSetFileInfo
+            {
+                Filename = "abc123.jpg",
+                FileInfo = new FileInfo { Hash = "abcdef" }
+            });
+
+            // Should fail to load, but not produce an error due to the extension not being expected to load.
+            Assert.IsEmpty(check.Run(getContext(null, allowMissing: true)));
+        }
+
+        [Test]
+        public void TestRegularAudioFile()
+        {
+            Assert.IsEmpty(check.Run(getContext("Samples/test-sample.mp3")));
+        }
+
+        [Test]
+        public void TestBlankAudioFile()
+        {
+            // This is a 0 ms duration audio file, commonly used to silence sliderslides/ticks, and so should be fine.
+            Assert.IsEmpty(check.Run(getContext("Samples/blank.wav")));
+        }
+
+        [Test]
+        public void TestTooShortAudioFile()
+        {
+            var issues = check.Run(getContext("Samples/test-sample-cut.mp3")).ToList();
+
+            Assert.That(issues, Has.Count.EqualTo(1));
+            Assert.That(issues.Single().Template is CheckTooShortAudioFiles.IssueTemplateTooShort);
+        }
+
+        [Test]
+        public void TestMissingAudioFile()
+        {
+            Assert.IsEmpty(check.Run(getContext("Samples/missing.mp3", allowMissing: true)));
+        }
+
+        [Test]
+        public void TestCorruptAudioFile()
+        {
+            var issues = check.Run(getContext("Samples/corrupt.wav")).ToList();
+
+            Assert.That(issues, Has.Count.EqualTo(1));
+            Assert.That(issues.Single().Template is CheckTooShortAudioFiles.IssueTemplateBadFormat);
+        }
+
+        private BeatmapVerifierContext getContext(string resourceName, bool allowMissing = false)
+        {
+            Stream resourceStream = string.IsNullOrEmpty(resourceName) ? null : TestResources.OpenResource(resourceName);
+            if (!allowMissing && resourceStream == null)
+                throw new FileNotFoundException($"The requested test resource \"{resourceName}\" does not exist.");
+
+            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/Resources/Samples/blank.wav b/osu.Game.Tests/Resources/Samples/blank.wav
new file mode 100644
index 0000000000000000000000000000000000000000..878bf23ceab94d07389dc32df995862f4da2b0c9
GIT binary patch
literal 44
xcmWIYbaPW-U|<M$40BD(Em05vvKbke7+lscFbHg9VqjqqU`R<UNdyWr006c-2U-9C

literal 0
HcmV?d00001

diff --git a/osu.Game.Tests/Resources/Samples/corrupt.wav b/osu.Game.Tests/Resources/Samples/corrupt.wav
new file mode 100644
index 0000000000000000000000000000000000000000..87c7de4b7bebf42ddfcf55dc4b6b88efe80d8cec
GIT binary patch
literal 32334
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

literal 0
HcmV?d00001

diff --git a/osu.Game.Tests/Resources/Samples/test-sample-cut.mp3 b/osu.Game.Tests/Resources/Samples/test-sample-cut.mp3
new file mode 100644
index 0000000000000000000000000000000000000000..003fe23dca224ef686afad1119e153b6315ccd3a
GIT binary patch
literal 2060
zcmeZtF=l1}0q2m2hzKBU3B<wqX(i=}MX3xvj=ru6#zsk*CB+J5sYS(^`FRS)dX|=Y
zrV1JvB_#z``uaJExv6@^X?l67C7S<#Pe=iog%3nz=A{GW`GJ^;fq{KLLkFqgKgj@S
zR{+Q>#(IVZ1}r;a&NEd|VbSzuV0-{_hg$E}$uNmwOaK3U0T@Ay9So6g85lUsA8^$!
zU|>{uIy-ge90taZhxO`>E_kRcd92GQ?X{z3fx@HrJh~2l79MKsn8*J&;m<#x-9POA
z$^ZZK?3B#Yga6d)|Le)?{gb#BX*WSZDRq~G9{+s3+6O;>C~Wvy{O8Gznw|fjGO{Q9
zsMp|Nv!B9ZRM8Y8-+7REK8vhy^ZWmQ?6d!SrUYM^6=Ypnv}{fj>jW`RLFWgL&wcYr
z;JwhzFDO#hQMYW>(;ewc*EBKDaddsx!pbhjyywQFH7YB%x?Q|>vysig#C5H3myTC|
z?UouP72V8j({s%)P5bVj!pp7qYx>by+VK@~%a54~t=7u9;iUO6Q|!_WYxYXXG=a~X
z-s`PUlW2(cVtXiAbZ5rvhytV92OeitJ8QaveYK8T-pXHgZc=o<gqGR!Ej#$sp89!g
z+I#z3?zPoxUWNR=dHLFsW3sE=_Z3}#I;XDAGHBkFZB_rms&%H{zgM+UXu)R1p7ZZ_
z1_j1%_RcbRVsDbaWapN*I$cHcSb9%?t6i4tX#YaTVMXr!r!7y~g~gp-L^LWfEG<!-
z6!0lb?|k-$-$xdAUvAmt@zXrz|N6V1=KFh2a46$fPEz7#%3y2|=hk)o^zw7Zq*oU8
zrzgGn@FJ$a_|3Aq`}Xs-uK)W}RkZ1P?A7P{k2${l^Y8S1=lIvFb$@)<{Ux__|F21T
zyMGqX)jv1?DJ%nhK4s0kAev=@CDVi$9~A)>X2z}=9E}Snc}<sApa1-4;|~edk29G4
zXK-<z{~5sQ!_nY!cEag10m0dS*DO#u^YzAs0`Wha*IhbkRMBgY;%Jh{{{QQ%15r6F
zX>WEU&bX7zu_8sY_WysLeVjbMb}ZxVU^!IS$l%$qAh4+Z|KD2ES?*b{n-Vn+B<{E)
z;5fsAc?J_J7sLMl|KF`MPn<EO>qCeHLlbL)v_U{J1H)tnXMdop3sNWFo{=4I^zT~x
z?Cxfbn(XvqkYB!PZTH<hX|{2E+0=h7VovwgrA=i&K10MDB=`Sq`ua6Vl51J6w`YgF
z%_(S1S!*K2Dn7G%iDq#`Gxxof%a+~;tNZ_d`umu_$>*;{L%BbCRt4>uZeq4+e&+8P
zUzZ$V3{Yuw@cIAyK*~%8&d92p|Ed=;GQ5wDKYPUin5UM=Ffb@EFqkwqFt9W@_?b!Z
zxGFK~)jKdJ9k>6w(ezfbf8YO|KB)_pl-~bxtZNj|XK7F><8fm1acP_~aY2&ebyxL9
zp^7>M8CC{?@0W}M#kg5a4v1*TA267~{8&yq>8F)d+XRV-J~lqFhJpe?#s(1qUWff%
zE}JYo3XK#sIW!s+m=qe;9)84sg}ueT&r{ICXO`G;jkL~(o<b>$SR}$dCp%^TD=6;#
z^r_{J<>D!hCj@789sJex;vi!IL%gCXcP*bw!vAlEdehidR^<6g^e=i@vFGR`9baK3
zLBT_hc(@FgC?qHBa_$N4D6Ieg>&uGOYv=#}X{B>1A#RG-;whG{p8{Pzyo8sst46_)
G3jqM{$gt`F

literal 0
HcmV?d00001

diff --git a/osu.Game/Rulesets/Edit/BeatmapVerifier.cs b/osu.Game/Rulesets/Edit/BeatmapVerifier.cs
index 545fee6264..768ab3545f 100644
--- a/osu.Game/Rulesets/Edit/BeatmapVerifier.cs
+++ b/osu.Game/Rulesets/Edit/BeatmapVerifier.cs
@@ -24,6 +24,7 @@ namespace osu.Game.Rulesets.Edit
             new CheckAudioQuality(),
             new CheckMutedObjects(),
             new CheckFewHitsounds(),
+            new CheckTooShortAudioFiles(),
 
             // Files
             new CheckZeroByteFiles(),
diff --git a/osu.Game/Rulesets/Edit/Checks/CheckTooShortAudioFiles.cs b/osu.Game/Rulesets/Edit/Checks/CheckTooShortAudioFiles.cs
new file mode 100644
index 0000000000..9a2c714c06
--- /dev/null
+++ b/osu.Game/Rulesets/Edit/Checks/CheckTooShortAudioFiles.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.Collections.Generic;
+using System.IO;
+using System.Linq;
+using ManagedBass;
+using osu.Framework.Audio.Callbacks;
+using osu.Game.Rulesets.Edit.Checks.Components;
+
+namespace osu.Game.Rulesets.Edit.Checks
+{
+    public class CheckTooShortAudioFiles : ICheck
+    {
+        private const int ms_threshold = 25;
+        private const int min_bytes_threshold = 100;
+
+        private readonly string[] audioExtensions = { "mp3", "ogg", "wav" };
+
+        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)
+        {
+            var beatmapSet = context.Beatmap.BeatmapInfo.BeatmapSet;
+
+            foreach (var file in beatmapSet.Files)
+            {
+                Stream data = context.WorkingBeatmap.GetStream(file.FileInfo.StoragePath);
+                if (data == null)
+                    continue;
+
+                var fileCallbacks = new FileCallbacks(new DataStreamFileProcedures(data));
+                int decodeStream = Bass.CreateStream(StreamSystem.NoBuffer, BassFlags.Decode, 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 (hasAudioExtension(file.Filename) && probablyHasAudioData(data))
+                        yield return new IssueTemplateBadFormat(this).Create(file.Filename);
+
+                    continue;
+                }
+
+                long length = Bass.ChannelGetLength(decodeStream);
+                double ms = Bass.ChannelBytes2Seconds(decodeStream, length) * 1000;
+
+                // Extremely short audio files do not play on some soundcards, resulting in nothing being heard in-game for some users.
+                if (ms > 0 && ms < ms_threshold)
+                    yield return new IssueTemplateTooShort(this).Create(file.Filename, ms);
+            }
+        }
+
+        private bool hasAudioExtension(string filename) => audioExtensions.Any(filename.ToLower().EndsWith);
+        private bool probablyHasAudioData(Stream data) => data.Length > min_bytes_threshold;
+
+        public class IssueTemplateTooShort : IssueTemplate
+        {
+            public IssueTemplateTooShort(ICheck check)
+                : base(check, IssueType.Problem, "\"{0}\" is too short ({1:0f} ms), should be at least {2:0f} ms.")
+            {
+            }
+
+            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 c8f58cbf6cb37f862296e8408806de99b4514f28 Mon Sep 17 00:00:00 2001
From: Naxess <30292137+Naxesss@users.noreply.github.com>
Date: Tue, 13 Jul 2021 04:17:41 +0200
Subject: [PATCH 0031/5547] Add audio in video check and tests

---
 .../Editing/Checks/CheckAudioInVideoTest.cs   | 107 ++++++++++++++++++
 .../Videos/test-video-with-audio.mp4          | Bin 0 -> 2316032 bytes
 .../test-video-with-track-but-no-audio.mp4    | Bin 0 -> 2800362 bytes
 .../Resources/Videos/test-video.mp4           | Bin 0 -> 2885141 bytes
 osu.Game.Tests/osu.Game.Tests.csproj          |   3 +
 osu.Game/Rulesets/Edit/BeatmapVerifier.cs     |   1 +
 .../Rulesets/Edit/Checks/CheckAudioInVideo.cs |  87 ++++++++++++++
 7 files changed, 198 insertions(+)
 create mode 100644 osu.Game.Tests/Editing/Checks/CheckAudioInVideoTest.cs
 create mode 100644 osu.Game.Tests/Resources/Videos/test-video-with-audio.mp4
 create mode 100644 osu.Game.Tests/Resources/Videos/test-video-with-track-but-no-audio.mp4
 create mode 100644 osu.Game.Tests/Resources/Videos/test-video.mp4
 create mode 100644 osu.Game/Rulesets/Edit/Checks/CheckAudioInVideo.cs

diff --git a/osu.Game.Tests/Editing/Checks/CheckAudioInVideoTest.cs b/osu.Game.Tests/Editing/Checks/CheckAudioInVideoTest.cs
new file mode 100644
index 0000000000..2dcd37123d
--- /dev/null
+++ b/osu.Game.Tests/Editing/Checks/CheckAudioInVideoTest.cs
@@ -0,0 +1,107 @@
+// 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 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;
+using osuTK.Audio;
+using FileInfo = osu.Game.IO.FileInfo;
+
+namespace osu.Game.Tests.Editing.Checks
+{
+    [TestFixture]
+    public class CheckAudioInVideoTest
+    {
+        private CheckAudioInVideo check;
+        private IBeatmap beatmap;
+
+        [SetUp]
+        public void Setup()
+        {
+            check = new CheckAudioInVideo();
+            beatmap = new Beatmap<HitObject>
+            {
+                BeatmapInfo = new BeatmapInfo
+                {
+                    BeatmapSet = new BeatmapSetInfo
+                    {
+                        Files = new List<BeatmapSetFileInfo>(new[]
+                        {
+                            new BeatmapSetFileInfo
+                            {
+                                Filename = "abc123.mp4",
+                                FileInfo = new FileInfo { Hash = "abcdef" }
+                            }
+                        })
+                    }
+                }
+            };
+
+            // 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 TestRegularVideoFile()
+        {
+            Assert.IsEmpty(check.Run(getContext("Videos/test-video.mp4")));
+        }
+
+        [Test]
+        public void TestVideoFileWithAudio()
+        {
+            var issues = check.Run(getContext("Videos/test-video-with-audio.mp4")).ToList();
+
+            Assert.That(issues, Has.Count.EqualTo(1));
+            Assert.That(issues.Single().Template is CheckAudioInVideo.IssueTemplateHasAudioTrack);
+        }
+
+        [Test]
+        public void TestVideoFileWithTrackButNoAudio()
+        {
+            var issues = check.Run(getContext("Videos/test-video-with-track-but-no-audio.mp4")).ToList();
+
+            Assert.That(issues, Has.Count.EqualTo(1));
+            Assert.That(issues.Single().Template is CheckAudioInVideo.IssueTemplateHasAudioTrack);
+        }
+
+        [Test]
+        public void TestMissingFile()
+        {
+            beatmap.BeatmapInfo.BeatmapSet.Files.Clear();
+
+            var issues = check.Run(getContext("Videos/missing.mp4", allowMissing: true)).ToList();
+
+            Assert.That(issues, Has.Count.EqualTo(1));
+            Assert.That(issues.Single().Template is CheckAudioInVideo.IssueTemplateMissingFile);
+        }
+
+        private BeatmapVerifierContext getContext(string resourceName, bool allowMissing = false)
+        {
+            Stream resourceStream = string.IsNullOrEmpty(resourceName) ? null : TestResources.OpenResource(resourceName);
+            if (!allowMissing && resourceStream == null)
+                throw new FileNotFoundException($"The requested test resource \"{resourceName}\" does not exist.");
+
+            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-with-audio.mp4 b/osu.Game.Tests/Resources/Videos/test-video-with-audio.mp4
new file mode 100644
index 0000000000000000000000000000000000000000..f41c41d388b2029b24247b1671e0a02855073ddf
GIT binary patch
literal 2316032
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%0Ac
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%0DH?#n`z_TgKvmp@b<
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%0DX}p;lw}~&Q37D6lTJoLaTr6J1cOG@2Wb`^XO6;b
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%0DS6Yq;Kxph8_B8uzq*(
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%0DTh^{jT91BYWG{ILk2HbDQ{sh6&OP`j)Rvg>n
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
EfMbo#W&i*H

literal 0
HcmV?d00001

diff --git a/osu.Game.Tests/Resources/Videos/test-video-with-track-but-no-audio.mp4 b/osu.Game.Tests/Resources/Videos/test-video-with-track-but-no-audio.mp4
new file mode 100644
index 0000000000000000000000000000000000000000..000bfc356737ec5ba1b173b181bdb7f6f1b75501
GIT binary patch
literal 2800362
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%0Aiw%dVgBZDd^;L69OaRaDcD
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%0Ai9~nZcL=5!>
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%0A<qoZwcZv<nlO
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%0DYCpM-e>sRi)DE_234fEU5ER<Tj3mI
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%0D*XQWH&
zgkrO{tF!HXK=XQ}H2<l}O8l36OqXQ9ZC5Q_2Q_8rm`3V#Re(=iV96$Bu+FjsGd|-)
z?_DfwK+G}g6;W6B)GZeLU_ULpwz7u3Z0?NBAV!hpa+jcS>Hh%YKpnp?JhlmZ7@s|A
z2!=FVUZOuAXl0|RXsQGAe;qu!GbB7YM06=J__+*E2@G?>xK3@uyPHHl-njhRF6PkG
zGqZRY)dk#`^LS<*zl5X@&=B}<<K>!oX5ZmF@R9?@hr>j;PR*)O+;`qteoI*ru1FSj
zp?!yMn7y8AP+rd+{0cW^c6k)g<saCI><{&J4KcjF1P&q|VvWXIG4Sh&<0HRaF7d3*
z#Z%0X;sYc<2u6(gLBAWeV@7_^jy_aa(VqV?_iT1)arnMR??_7?x7VA{*jEA8Ijjhe
zZTBCt2dRuNulyyg5S$$^mIrB`S^S%HWu~tgFD_H^%;12W(R7%)TN3TlZ-n|Xn3{Bs
zX>s+EgdnDeV>!gGTwt)SJ?4euCg_>2J^A-Pd2}DF<6JMz2=|Z6@C2JxxcqhWnJgyE
zonIPt*m9{UAy}^MEbjZu*B~+izG>ZlldItf&>~<BQe}vVCjcLD_Pb`!AP;ADo2;w5
z@@CJ;%^A`BApsWX`+xbqt2@98r_2qDuA#7S8#(p`()dlwI5GntVf*XFba0Hp?l3==
zOUq(MpgQdFk+SGwcv}7>8GjqNzrXktPVCv*2IdD{JLJXtSKNQg9CNvvUAF#T{EjEt
zrNoNCAmpEr_LCT=NyLe-T4&z?HA-qYN4<08kj0eAJR!$%<KrR&VbE2lJjs~i^dVLZ
zx0a_Yr%j`Knug{DeV*ph>}b!zTpq~@_F%#jE_{8$3zD?|>iNf23S*b}*!cLqYWFgB
zTLXX0$@LZ>mkG!s%A|wQE+e~JN52X7hDeBuNg?IqbC?mh`R!Oz(4jeuXwBNk<)X)>
zi{tPHi?1`l(SN28t*96BZ_Z{+Wbv0Z{7<-q>o~8S#-)JBYks>EI2eboUlSTLZbb7_
zOMD~XjLwMBXn{x;+sn^DbA_q@jPYBRvFUME(6OCdz`^4;h5VD|T|4ZOUlOWt<Ilnt
zoV!-$HRb#bq!M2fHq@_;X4Pwtq?eG`Q;&J+e1v;8Q;&I}c~YAzN4)eMFD(f6+A7iW
z=d3(`5}ActlixYJ?feOWR?>UtLHeYi0U2#=IPHFHc)U}6x0#k(LH`|QX7Ac>;OhP+
zfee#}LVSs_I^TcEHhKW|N%>uvmAieO5Z(gp4z_+{us^%qFgNSB+0J)mY_-YxPKR7)
z!VoN;ustr|wukr$m&^}Ka{CJ|0NI`3dQR@yCIZV~^qw-*J)_@YOS>zxk+a-@H+*U5
zV0GF4Ze{w=e|?lk0olkN^{v_CJeeQ0^?d~FX)M;A$Q5(X(U%|FyF3;elFB%le7>F0
z@dNU@UV)Hk`Hno<R=FFDyOl1{{k;;|*o+eABJ+RY9|T{KB6B(FI8=`TnB4Vuoc|pj
zHtRE_?1d@`UQTBtIs#n;1+Y5V<31TLFO%Cc@r1hUUwrIh`sDL*Pj|k<Fv>tc9<asr
z^7DV?l=m<XXNrEkI=o>n<{90dBGOadTWiT21rPZ*NzgLcUZ39m&YVb}*t|L3a3TpS
zc6-+e)%D2_7jQ97Sbky-=AcIbZN~5IR^i!;nlLgx8X-KG_J7M$%Aog>o7xl2hSqS(
z<Gpf5w59w`QIjl|45k;QlZ58pZOy(bMFOsgdmK`j7%aDy$@63Q$SkKG^Tw&QA?j-8
zzE@kdZrMj!(NjXRy3m_a9+Ou;32L4BZr>ldCO}zUjXC>$#i#7iO%A!+5&>Z;k*8ll
z0rK^P7D=OSZ>Nvl^JuR}XI}r@YD%aOiEdtX(|8K+nn5p1&c5mI2tao)wcXtF!m5<p
z#$9JUQq%+cFGG&JlOea5y-E{n^WuA$L<lzCpP&EoK)1LHHZ-ej5B%BXe`|f75cfm2
z1G2(rv;=*Iy|6Rc$ur%)&eSgRp6&rINs}d<EMQ-RAi+LnmL+X(M5*&X7vC(L3a8ol
zzU_nxr_B6bA_H6P8v73P_ubE?Pp&YR<m2)+zR|C<$)`34TP&^ix7c>(#rAj<dqsAC
z!doh}Gnf_jb|(8<u;X*xo-@c|`ugX28ePl?`#TwLFGK3_g!eGc?6R+zopkErzx=x>
zusHx^J^8;Gyb!i$qXO#F|5FY_XMQCHQp-N?ge^9`>#V{H%f@hMIM1)r|DiX<<c+-W
z_{uB<rnGzKQ{V$DGa=FA)&zR#R#Pk<iX_qc=hAN1srN|8vb6qu?K=MmaOV3J4>w`E
z)~PO@0q+~V>*)#zUlRWx)q3GQ>a3)JIVRl~mYm5Oe6a54?Jg!i>TBaXY~8{47ft3f
zpUusU0<DX#6S2+s(Vc$$vNs<dmwL#<AzznF+dqUUMNC4LL;c(JnUD@VZFcpwJ)l3u
z+*Ih=!*{OV9|2`Fd(MqC@&SsRFV9Lh#tSKt?=()aW=6_r_n(*5o-OhD1(Im@oyID1
z!a!8f`0LM2FeDP1KOFvix(n+G1g4M2U6;ImqLjk2+CO^xpR>X+cG+In=W3F(GEaDN
z%%dJ(CSO~zweObc68Em&Gwu~<wq3E2HKZUcG8=d1O4~jWGq5x4?Q&-6Vb6phYY)mg
z-&ux)8lPi|TfN5iKGY}K|CiOLascZbcVav)5{7qh5xo;n`?MhY7}x=VHU(Gy5SWJY
zY5MnCJRvraAL(t*oqam1kI0+Ww`M?g=XzJX&v(I>u<hNnuX1;E&E*Ojp9tH`h43Bm
z+}ns##SVV|2tnSHKeCU2BVU)}_w@maXfHjKf65_3`@dXL0bwnp-#y=W%>@8}+4S1P
z_pa&f`~=RPv~ORmFf5eO?>jf^WSA#uajEn-$yQbIoSq*bZI;pRUvC?^`Qh-NSoi`Y
z=Tka=pm_h+cFNbnb3OD~Abv@=VR>Ule49bnbDC>62y)Xrx5wi7du+7w^4;P^V<|E#
zXL%Tx%y(Y=Ttgi=_nu;m{5F^)tCRDvv*HByplk1jX7N4~aj_<jDE#Tammi4!Sx6w)
z_gr2-?)(Aw%YPTgUmlsJ@&9>x1o{#usc~4lNA4o0M%Ej>b;<A>1m?J=GvN<$Q^%|~
zdf&A@pg+VqJoSMdy5Tm5b=-7#+Q5%pu1wNkh5TfhTSvZmV=FczWi)%wp?lJv=EAu5
znUkrKfCNmdkA8k#^T|i!?%+E<ItRCA@VC%gEKs6Z&|M$l9|xXM!}9i&WY{GEx$&F6
zYz1u}k1=aKSDKxdvlXqu{~mTniq#_c=%Cq~j(=|6r-6JDZZ|4nYom6Pk1N7iRy>Cq
z=X?$y88m0_gt&RS1D|f&8y0>u!ETJtQ7+lNHy+?8Y;C(~UJbalz)smCids+?be6B*
zlc0e95d2}e);_NDXP^&Y4Q_UO?2~7cJ)Z+Ec2{SvPTlPr*z@BfagSIVTf4==0kb~W
z+7R%4%{)K#^Hrbd1sIlnxKFS*<?+26jDhVP4$e6Iyq;g~<_FHW&lw%VAmIN2{*TIM
zW|EH@%SYn468hcu9j-F4d<ep19#0mMJ{~A48skSxCV6Bucz+R{=qzeJ#+&5iso_Q9
zdEv5>1n!CB10WJOjG2rzVJ;_|yS_>6bRbXT=@ZrA8^5bk5EqS%FXHAlDK8%(ZO@Yx
zw0<GipI}F?hx7-%9uW5s^LM>)IeiWx(c|n0_0~{=?gNiKXgzkguXOcsI5XZn8+Rq7
zs?Qmoc)vV3Z2&to<KBFQ{?@pb;*azPS^D<ivYI{T<>*JR!W;Yxd;Y*n^5h&7evP}9
z1N!xNkl5>&lanCC>RO)rT{eF+!Wg?}@p#copd-{x=i<O*F<M;@hp(G2U^{7QHR^)G
z6XPRb$dL^PUIqwoTeKk_QQ=3ILG|d23vK2lJudI!(A^(|ITb>0ANc)?%px`h(ijPT
zT?X!4%-yj6{~r99!=wZ~jW=0Wc;5A(Bkb^p<`d3g{q}gD+TDOO?yx%AMz`9x+1(D<
zt(LgS5Nvb!%aNldN+{Da{d-rneTm9u14ZBQdmTj*nHi{4tB{PBKyS;!6EA&--YbZ+
zlT9H;KF#aSH>K_o^BW7mY$tOA+1WFCKT;-NFg+#2Y#fXsgK@_KTh|Bo+2cHi<nF+a
zv&?5MpZYQSpa1dW8Rg0Uh-+@q@35!2fO|O<-nw;n_}1>gcW3zT+M1u=uHp1PvIaQE
zi{$>!0DNfjxJpbN#iI{5@shKYW?SYKubP{a_pQS{+jjTXsQ9RTD%Na9QCFuA=Svd#
zbRVlYD$u_=kBFR-L6neOUyO__=K@c)2010Ye6*UH0E3s1#h}(AUQB#E1N?pzY+)o%
zSAh#oU`+4wX<6}}cf34jsHZG3BbK^YKv>**{?#X1OhRJ3vZ=gr=-vKs*Xxb*`OO*O
z4x<J-Jo^GYYXhDv7!Pgt@f2j$y%&4j2M3$GdfY&Kl)gGN;<^8bkjeI}W&P0nWD6xU
zd*@_&&saTLx$_&RL)>kI!GlN`Y-~Bc{asdg&SF4`PUm<TUqDIuw#PLE^m{+bdCacQ
zCR)(G%1@Qy4b(PE23J5rjphfpEO(ab$M{D_0=38s%E++!H?<+#NvPMaOz?)X!N6>G
z)#%s18q9e*Chz`bN=)Ye#lR!+&BN*9+SB`id5muB3t_#g`M)F*{BrhJd4R?B^Ud!W
z`D$)|b$F!m)Em7<YXkm^=+IY_BbP>O(tco0*~!mJTD8wQ|4&m~kT&~U>?J#y?`Ms#
zS^~b$2!3+TWo)n--nDPC4{Q(K&ntS?`#Zt5!2Rs+$Hu4)YsG$GGA(?mzuJ$?4UW%<
z=?*=GJ<J2y;-@d7Zy5rlxdE{@de6s~n8TMK@33uN(jAD6vrYs5fb#+!o?|-bJM9U-
z?0x|Q@Pw34v+;c#Qz8oUy3V;yfR`Qxg!zH#ebT}OQQ6PLxT{jv9{Vhe+32Uq6#hQk
z!5`@X%N&+?H>bYiXTgAgB~F%>b?UL_5?wk=r?ub5;o4_cIe_J@WP|IV;R@aSB#N3G
zb^0Xml%{D{9xNECp?dM-#&IanYtlD8DoxdwvqflV%+c{(I^EFPE93FkN>96ac=X9t
zv^eYSb78fde)stJ5VYnbNbYJb<6LDejKF0Z`+1$)DTM763IB@6#!G|mviSRsG(fZ<
z;*~7ayG!w(ike3dAK$&#H))`^B~EMd=G;HYyt4AqW_Wv>ET{$LjWmD4aF2toByQaj
z1HebHI>&@I4Ef{yiiHIGM=lND0QaAJ)psV9nUJB0XUC>~5c~%oZFcqDn1FzoboGYs
zT|69Da31OF-n;T;vmu~AB>%hlJ|48ii}^kgkzD}am;7a+uR-UXlcB^3`R$#TG#PG9
zWjgzh1Q|e>G90e&Hzb+uZ?KV`z&%`*zSjFZA^ahm13u4}*6abZJJP)*-Dn4F?$plD
zeVsoMZXIY0`ldd;$F4z3QSZs=D7b%)fZflqHfy@M-G-|#2LmJVp48IHCGj!YObfJ6
z&erwE<RlWBKOKH-y@5oghaGutauEVkOU}PO60b|J<zP9@O(ELsk9f_V0jV_ZXnAsc
zFOHl^k1|v-T^v5GKYoA3-jbspD`EK_e7d(>W;z}chCFr{-M|(49{lEP96&~G&t3*=
z-}?XFJ~62TKkiy3h500opO!?Y@<+*0qdf!i>C+GLMuxl54duEf4We@48#!QhB+na&
zCHH;9=pj6G9{iiO5i|LtORJ*K4{sq=!@m6EZboOWG`?63(mcO3{Ur{tFaO>gMEkic
zUlpLJED<{&9s~U*8PDDvA8G$P>HaA1msa)R4dVHW?CkHj1F)}Mi|nBIj{ceK?$j%@
zajtl*a2rr62EgtfhTrc%*B)@ZXC1V~;64is(SB%N4$?1xZ}z&qb!Cp=rk<&OcysOF
z2~9r~1_jl^F8S100G}7&?4$wh6XtLYEpswHUxz{CvYLL7naRxS<jUXGgDRAWtF`zB
z&CjtvYyHD3_-|5|^&jNO-Z$=ldE~}#{Q+v`XRdr-H7hgTBM5R+E>rT!64MU%vZzmr
z$CjiVM#12BhT$#{jV2R{VUr$T6vbDg`yA=TFF<`e_}85?Uf9>g{33V|=xks2Ner*W
z@_T>8T4~X?V#_1>PN>e;{Cqy!kk6KNf(z#A;R|H{`GLH(ER^q@E|BHRXbHFYzglzZ
z97|~4F%86-<Njfsw_A4sPs^ar)0KP!UgglAwb2)h+N}mI)zka6_IO!(+e3VN_xcNE
z;m>QJ&86OJgiCr)`LUI4Kz{LX;J0W4z0P`AHoADrfYsk;=D)|_BkxOpy+tlFhnd#C
z54Wz%)RX`q%<Vqk*RJXB8I$4sAR9M6#Qm?I(*@o*_5>yM9~X?HUbmfYV-Ir13bX78
z*R8UD<K@ievGZoZ6T*mh5r!wL)u-j6KbXia?no5;kO*=|W4$%R;F0Bst`mcUwk1L%
z_v5Ash{B)$A)*?{Xlf*!+-adxK#ohAfcA%EnP1{!EQ^c1I(0bs{_M%$c;K@zdIR!Q
zX+6~@b;NG?W5=(Ox9$NCS+45(?}6KB5;dB60WXU14fiI~HYMcL-kv_RYX8kE${#Nm
z-S>VX2OcUP?0KsbjZlce-jhExJd(z(22N=Io@@BH$q}LhqQmGRHO-&?YmfW*yGSD>
zPshZE;=F7}K10cft}nFKduzq><6BJuhngHuQY0$B#&9ULmm0S%k)7*a0rmXf=rZr>
z|1A=Hd=q>P&OArUhLp-BF>>zzHuv%T-~fimTIuK1M7lQvxSc)tONY=xbn#%cu^fIU
z!57E=9M6Y5X_Ym?T_cisBKQZ%NW%BS%kFq!n~KxCcAQ5U$HD>xaocf&u;lEG^L3ej
z<0&4m;SNFC|5p~(=9J6~_+z^)N?ja*_C_m;;!-2>tiQq?SV1u#pg+}=Tp6>n6F^?G
zr9?T3;<%KEmQzdcQ36judrg=SKGn{t7<sD~$Ke&iTpH|yqm0`gEop_7;IEN?JjoN(
zM5*A$M&^T!)y8WA{&njFCn=@j8o78F1D-k(JFZOe3q?*oJBx%6hx+EV+s9M`uIfBZ
z_z%>*hNcOh1Ku2r`0>V$F5V|jinqgw>eTq04Y@Kb$&qGEjkz<#>uFm`+EFQ<ZQtOY
z8>VZM7(3EtxI}FDsA(c;6wM-;qH=4AzhhL=(>Am5JU*sg#o_fc!VrfO#zc4zf^tkd
zbS`4k>%*LH2~UG0PnfXWrfRvoeA|rG<KaU<Nf#TTMa0~OZZDF<8EpnyBk`DSM>JV9
zKBgKy-@t|GEZvCW`j|51_5T)9IsP+d1TJ46cE-&*|974~I=Bw5jfbMhk23wX{sYS)
zf8DG9jEI-5|Fd2f(8#3C+GUiEYUY`U{QE!uC}lEB9}~s+c1NCTi<*fqUyJK^f+I(F
zTgUz*L)Uymm*RM-lGBB!ouLr=On6cWJO|P)Gsuqt))j|<d@%c6qOT(84E869Pu^c7
z#|JR<ja>?uCxz?>0oNqWaELZ?a6|H*C~@Fd<)rF7d^F|Wu;hOlK<jJ}p2kBPoYy`y
z%P+xw9GJMKcsknzCpo5Y1nvHPQvJ<59Pu0q{y<+W{!n-#H>2@Dj9$16<G-xQoS=Y#
zAF1EwS>&nza^4YgdG8bVt);)qFa9bbZc9H_a0ly<>10d1{quZOjNfkrZ-KNGIQ}j}
zJO%aN9rxFMI%Dy0%I1Onnx2t8LcUx4B?%eP^h~ox5AtF4Gk!{Ou`gU)CigY)7}hS|
ze4iO;KO{=JAJHkWGs&s$1N=?d)#-Rs<2RZ!3v1}o47JeEC8l)QV|_lpD6UBfpf6dR
z2nR4QBxi&v7si_{c`??DhMEtlh&ZlF0yJXj#J+(2<>R_a_OCD?cu0hQ0oIRkg2AS0
zwRJnia&RX1LH#?5_l&guV1D&`aNhy+Iy>y#CE4u{Ao^;CYWbQdKkl=Bv>-)d;Rjs2
za9sqWU0?i6NU4Jc0s5IN=ngtz6Rq)3A9{Id6yqT_&7J}Wwu7o9oM&%{fh%waDd7d_
zANd=`It1SC`Mg{)mO+;Co60x-_$6vZsEgq>&#%Hf5<Q0kp^UfE|K4x_gm^8l@@5bc
zhJPQ&b59H=XfuZJ)-U+EP3XA8Qw>i45yDo%9;K=x5&ZD4lffg{@!c+4;nOXW@f^Ga
zyQ=S>8Oy_Nj4jK+h4}A{_&DP{Jt09e3P{gC`zJo*JpFPLV0q!@{j)b^?c=}kl(Vz}
ziPO5xdw@^_EWX)MWS`OPi<m&`K?jzark=6bGvZ(1TlKgH{xSt}cb`7VaTQQ~@?p0e
z{I3WZWY@%A&i1i^zUDsvq~!kpjFGknr8dFhSeXD}9@TSS{1P6(`foue;8JqUBcxS~
z)<0lN>~B4RpM4ES_?QOz)*9iQGp_gl-=V&pzPPR+WRvw4-4gObds+M?&~jcu6|9~(
zLQy<^SSI*w3P(BD5VR?9rUGAdd+&enhZSfDo{e^);s*f$m8--5jvU_^+d(h!k_pM2
zJbf^PiINO&0L<NZ|Mlu=GSHLxzI}Nec~9W~iPq%*S|yQ5GCy1firpFOlwAED;xkdA
zHzIhf-LU7{u#zV`_{bACKkfA2E$)Jt9D&yLJ#SOfGUKEAJkd+|nq)(;Nz}zDgzjC1
z*Z7_kv<SRy+k&H&cnCK~;%p_?>O{Zg@z@eKOJRy?&7S{WHd-jttr`4ez=K#frAs7h
z+BdO!?_H^Ts9cszf4n<AfOC;jUWn$vpIG_N{xVwtAwAt@y}&pbJPt-z0s3n&a^7QL
zU41;Y3NtMqSLj40j{QH!aS0Sjcb3XWwcS6=Bm|Ae|HJqw<&^salLFk=jb->kB)%MM
z`Yq@tbtKqne>o55?2J0?2)TS`-PXUt5ewP4WVY9@JSO*_?Pg}jHPOl+G~wns`#w)U
zg|G-4Tb-}}m+^dGnTaqi)9{BZ;8kA^I`fPgOaLao+7DlPLLAbr|BB(+=H|2munK#?
zhqF<;y>jeuyhQj%$AJn6?>|;zXV4JzFL7c`m?K)Md3REnz>N`z=EnE@CCLtzOD`1(
zCw%1p@3Z1J64O<7>^i?zPp5T%gsU!?J}g3e18AQBW`5EfcbEBKo$*|5&<UEnKmJHJ
zfFjJ3GLL@%40UbkP5giWLq6m<03n}o0<ZWUV!4E2|8C1nXbOW3TkPS=AjD|Kx#$R8
z0A}K9_;Kls00IDDuBK*~(gCnXiGFv&Vy=n?T#j|u0Mz<)=8&i&1X275PPyj@YTs|R
zHaQsCJK<09-v7q=VkG79vw3)oB-3ykk<U548csHB*C4ZT?>`wk`*>axJB`h43G@c4
z{z32WDi}t7(0T^iX!o0h5H!9!Yma%6AN<8lSaiIwp1q*D{SZcQmj)~#W`gFrA%y?J
z90tDZ)_vOu9iMHf#JD#cLD$T<rD<nhmwj@%aglIFLF4%N1+8cfwhR63o)HeTYwWqp
za{%nX+wR|C%jV9{18-X2XN=64I6NA@#}-d81yk(&T;n<J&%1Vi9q^g$0Uu}mF~_EP
z36l3<nY?lC1y|?dw70?<zYZ(hdS1s&Z;bJ?vC`xzY!CHE%#=+ztCxcbRq|J?uJguC
z9KGY<30*RT-ao<b44vgmsrw;t6_)|Ac2-5rPzCvF-n(&}UzS@=4R}s9pOP(Uis3k5
zXLFtIntxkw3Ozk&NA7?J<#i(;d5OEX##g!x?=K(H?&H@2Ch$LbY=6gb{JuUibGU~g
zyZ~{qbd{D1!){2_!iB#Ihzez+BM7KK2wjEKlqk*de8k8A2nJl9%sU|AqM|B506;R~
z0t{P#53^!#1cB*hco2L6OK4XIKl9v!xNg$>kM<kD5xKE|qV(jIQ<H-M1=B&HN%y}6
zQh*WEZ4{sE4lL>ihiB~m7$aH81b@I`KfaDE00aZp$RPLt2n43i2yk$um1yp}@a}jS
zVM-f5`_hk&bm1wTueqcLxk2#USBBOe6S`aG&Hw>800;8J=u`jWym()a0k*_Bz7OGz
z05jJS-RP1tdg8<Hi}BxQI8z@NaGTvq36@kU)QTUu+cU-6l?8+r7~|f0wad%gEcx(-
zN`4jSJ?7H*2OT!F9=A2_1}#1ub?zWON>UIMSHZ>Vh&~XPu#^M4*2#Lzffw5?$v6jJ
zY`-Oe3<LXH;viey_Q4Ig-yi(t_RJ=D>!p?^cTs_Axj8;1R}OW5!kbOekxqvyLc7cr
zsymZ<oGansT!gH>ONp&Vxr5?pR!bSOSp9(yBxU84KxBgt&3NU@2fQaNo^z<O$WJHQ
zp3ooS|AZjJb^fRS`FLxc+8_Rc3wQK>?Ra7u`%muI%rCkR`7ao~+8_RmEwu;z*MhDR
z@hssV==}e@PVWOek|ZwzR<95L#eKdAFdP67&q8Dz01(eYV^^#V|JCz;&g5Nze<T6B
zLuF2r|9>TF13;hfJjHTk-(EHj00aQRT}%MD>k^O-E+X!M!PG$pahfR8^@|Raw^5vN
zc5sI7!w_H*=>E>zk3;?J6`0?s9>^eZEiG98=0Ic>{Ri;(CrQd&Ln5dR?{LCi6i%Lb
zn{a_G0{9XO)ZbeQSBGR5qmI~T)k9|97Uws9D`I${C6Gwu{rN;w00ZN^cU~|lL<Rpe
zk-x8yCT}H>C;#xeGJgtS0TKGI>;L`&%!uWlCkY%WoHC2h|6E?~8AWi|2|#cC;VXl#
z1YA;I;Ve7c0Nl_ckB4A{48v;j@mM9?^`O5yA0#2yalpTig6j;)0J~BmmmjKLW9!^t
z$#iKE8LxC^MjwgcPN{eg`cC^^u-l0Jth1OnCFZl575i08K3`u=@?~Jhe;?Ka1;AU|
z*Sh^zj@<v6JQ1}CopNsY1kS$PJ$HTK4{$Eu8g=(-AfT95<9lAWo~>ac=54|4Je7gq
z5j(hWe$iA@`=0+ca&}pGM~HAkmWP<+pAvok5aY6}hkNzPZ+2$p3bOYn5j9aiI$s$M
z{aXQ|nPleb$R2TVfszHH%EX)}<cT1|k|pHj$vHlo%lsz*kG8qV{M+H~`@ApqUP1p8
zfDdhV5Py4v5BbyoFP-N+B@jQI{-(cJ8r;AB0Qc9NyubeTLq~$|z?uBfr8TpCAW!pY
zguczhU$F6iWD~pzB0|xiVtKf~2>cC3<J>ZxHGFrE+?Nm`6x4(Wtjqri(ITY(gv|XU
z+HW1<8w?Y0$qsUUhedb+nXB~w+sTc!hxkK$NsLMxMxAvZ7a&JZucwO%8*gBK66PNV
zvLzzF!W;+oc|?t~_ZcaRpd(&viw;0&d-HFE@OEYsFsp!e{bmR2rbyXf^cTm%ni@o@
z?qH{*P0G2<DWRljZwQ&id3w_=aa|C4PGI{)b{qHyN0-4q`=ns=)p1zjE5K*aR(YN;
zFe>+B<KZK|?c#d9W-}&%YbSFs&<=d&zB**%dM<GE&N=U5mVrD}(9p9IiTNPyo>!!@
zxc=BG^w$<lFQNx+EGVQE=8h$o$&P|aL3-o2dW`aWk4)y4GrP$P@12M><eBe9<&0wT
zM4Tr?T(rAFxQ~R&k^^5$;~sR$zx=<z4&_=w`zLrqg6*!SE%tu{03TJVQE&NtUTsgP
z768rkw7-uDT4)l#J+GY_G6AdsnYlIndl7d~s60fR!a>Gc!7pB1D}9>rnvA^c+)s&!
z%WR`i-1<L+C|3*r0UbVmaG!wfF@fHYef}>9@SE=73u>>^-Sh%4!<rxX)I5Lr8lXSo
zA>2qw_zU`jJJmvS2ZK-kZyk#GN*&T?qVU?z`8Xf0nJ?iAk%fT&CtKA{G_FA3EiCK(
z2M#6%<*99N*9qg0Ke^0&d_sCQ>AjoxJS=E9oYvsW302Yw*F?>#0bbX6VPC*z=K#QI
z)ZjKc$;rYK^ilr^QTGCtMQNT%or~O8wP&<?v56qD=y649uO{&vwmL>vQ|r&gcnt4%
zWr2Ut<JoPraA1Gh-JUWbJ#TLKFckdB&!gSp_$ht_yD=&0c97WXqsb#Dm(z;R--O-#
zQgPPw)s+QK-<GVi@SbrQAV?#zz7w@k@sRSi$Q|-aERYCtKuq#R)WD^0_~JXifB1;&
zQrq#L8+hEmk|X%U$MA7+OA9E}!E0px$nwxIvwIbjo-?Xse=u225I^Z|@L5_t=9N-F
zNbA;p>m$jGL}v$^DPTPx6vhbdRN!m!o^JhpJxRF2AH-lxewbuynWI$vi}~F``_!<1
zxDR(yf61|`XZr7!{t}Gtfc=2T5ZdCr@;tq8lx$`GJSMlv@C1HceXsaKjdV6^g9XC`
z6RveSpdb_|1Z6$Y5R=Y$h|GK_1HgLbU-8?6GG_!$C;5b7$RDnql0>imGDAGwS5n~N
z&RM4D2HIL#*T1xj@IcO%haF&kx@4@ZG6VdbZ%9jql_TSaIRz)3Q^fuKsaAlw*Ntjf
zbk)yz@m?K7!cw?I!lxj-{C&hZkb+sm5@;_wz+z1W=bstl$PRA*SBB_fxGz5z;^)$l
zJ}o$SOO@r&=D*wc&6VC{Q1IxYR&%!SNp#C54heY!SPm$c32_iV*0*3X`LnV_-nF|p
zf~h&I(C};GAg*w{=Q;36`Dgm#yxu&K{7*ld4i#o2KU>7VzqWa!CcpAi-@-YzrrdTr
zZ5jAao?P&sh@w0zo)^M)Q*%VJM}xjeAoN~YAcBxUNy*Kzd|!ktl6Eg#6<lHiX00Cg
zu7H3mtTZc4bY@c863bTnrR3JW5QnWXjOdQo7wd=hP`8ie%T0PWJ=!7Pmw$_cE#<qJ
z95rwRxU6cDjY${D`TR`-ylzw(J$^ZB+z?gYHAg}UJYju2Bk%*K<<<7O*V)Ceo#%8&
zG=31-5d^`Ra1t$86br(jZth#J_eelkIb6#Ln%Un=k`G+UhwuL_N-1w2reX2+*8~ky
zB?phiUT<n;h>u6&n9X~m#f&UZFQFHC_(A~ppEIv!03qi!?8;~l!nhrC=5^T%p$LZO
z-)r&pkpQx|_nxEHoys0Vy(lY!^PKa!n9{G8opx*!_(Ec^9hNWaAFm~6Dl!_`_w%=B
z@yyU-MNs3UAA9Wa+6W|Z()<eb$LOyyd-y{|ZsQqHX%LINkSobY<v6Kr(cE{8yhrrR
z79K3Cwf7PDi$g7ZI!oa>@3)#W@%3d~@RAQqGZ80D((>%831Ttaek`QUk=`(cR!h%s
z&3T@HBAwcJ<(&Zw#ruhP-7MplM0YARWOL$kJ@k@M@0Y$?E%`YzQk1v&k0ghpE-oU_
zZ45pTdd_b6gK~EI{1r@?I>3x)XXj=&zTh+L_^F-PeaCc^5P<JKk^hIq$r9yPr)dx$
zS>odHJUq3q1*iX$nwWd~=+7T+U{ReK48qH$Kwwm8n>AFUhfKh~5mvkZ9P;Q0_5TQI
zJJSJA%b?EHm%Ii3EnjQ%yE3pG?6m<nuAu?*QVB`F$fp)mx0Yn<j&<||#&H4h@XFz(
zAs2Zdtx@=#$#3pqLqkYG&7N39u8+-lOWpUq8+V7|AWY9#XKPqeU;#JppYz=Qsq%b(
zO6>j+h<w03p46_7dkj0f9}lyT+xJL&d|CA1SmH#oW9Gs)c~&pNoCg@VpdjUR+5u&F
zGQsaD*GBe$-UL0LB~e|Ge7@w~c;ngYkDicX$C0YW{IXSbDf}oV<=Ipk@P|CMRnH6J
zZzM89T$>I^_|B1XU}6Ne947DQDh-m<c~y~uje2RLPQ37!ME5pZIvF{jdC8m#H%b4J
zzCYMbE65+krgi&f9sD6QvG^<xtDABpTo-}-xt)CqEy2M1T;DZ;2KTejthVsoYL&;p
zx9D_>=59E6?#ruf_>D79FFP)W5y*hyLMKVhD5wsvmi|~T?s`~RpuLOf;-d+j2@=ka
zbP-3z>X^HLKTj`uqlN7JeoCUd0RHcGVij>+oL}d*X1JrotoY^yctieQC1)E!JR`>Z
zMQ!UN$(Rdm+O4)^!3v|L{t)U-n9<kE&bx~$?~1qH_3-6~xK5Pt=Y$&Zdn)IL#rSz~
z!NfiP{y&1EXVe-ujIHB_#q`B7EcJXRd?bUskT`(&sMR0M20YFnEJy<iUFCc4b{+%e
z`+)bKd)IzGgqVX@*y73K2Y}Rb?EKeu$h3ebc=?9}-CXWoGd5#!o1Xo+G*7X`-bing
z;6vBR>EHJs$j_)crg?qvh7hqkVU5jQnSl{!dwQ79_5YKA=aZl#*PjS-gaw4P)xB$;
z0M{;#+WVDkNUmG1%gc(!G@j-Rbo#-U-ne~C-!?QHM)M#9>BsW=5$$pFCNFqJA7@q@
z_y<MALvG&rzGv`kI8~Tgr*?QsG^XQ5ZP%V^E!~&kyEUu#*<H^dHg)MMz*A)7GtPOd
zQt@)|XnS5lX7QDTj$DK4G<mbIoRC>99`jaWLlS5&KN<VFFBY%1x0tFn1S<5r>j1>9
z3-fAB2}L;h=aJ;Yr^yy)mjB_dUU)e<Y%{{c20Yvkx6lseo%(o6XzacJ%QRTy(Y`9L
zpygcbF7V8q6f>@C(R_a(!T{N{+Qj{>)M0!B+nulJ-F)JJd(U3=z0WVV0q-8Y>u~|`
z@R{uz_zts=u<y6V@;4cLW*R=kes0itZo_4h5+1a{IIIp~zL>BHPu*{PIbPI?_L@F<
z_(B4WHQIFUvV;&0x_ZEmUlq9gThqot=dJzgwzjkfutM$L_2%Wu<MH1ZQ!9S6N*G|2
zX~y@TxBPe4Jb<sYs@r)BeZRQ=Gprndc-o`^USxLZ^50DFW9d)vJrJItw_tg~HA;Nn
z_r`2cOV{f%TZ6m4ms8lhy8j=}5D0gZ(2KJHsl{YJbtkdhc^aHnL-$@X2lb|Pt5<Lz
z>#gecUjLb$n@52E$=_?B;R^18p15(><@{zf$H=WS*m0cqW|X_m1Ff{=IQ?@bNHX8z
zcyXyI9ab{m{8v0SQb3$!5*H6%<YAB!>;;!>?C`19+0G040$rR#c2{SU-#|mz7VKYV
zgdkJ)1Uo)yp?U-Rx-(LO_I@I30?v<hNw*RB{}S{DTl~1e<mQ5|eLz>5`*8K!mj{W3
zxvi&@lOE4LC(j8WhfEi9cv+R@=C&*s<1qho0qwQRE&bnFd-#lT4$9GfytgTC;SANI
z-oF_GRnFf1VYdSQ;<xu2m)-U?_Vs*i>#*f6ZW*0=#~ae(Ix^TH^f8zlj!$ptbK)ur
zZy`wP8A@B(@zS@);b*|cels}&b49`3v&s<qWnC$m0POx)7`pH)^UXYmzdGSL;YE5T
zUO#pa5El0P+iq*z1-Cx_*LP0<x9Ri!|M>3bVS$l0J@|*^@+3Fre<vrpd-%u>^H(1~
zJn~)iQBFR2{bpq|`(M&-x~gGX2UW{SC*Bi)_nW=z?)RQ{6VJp^qon!Z`1lZnzCr&<
z-JQeWB<1uUar_vT`QK(%(v{;4F8>MI-r2D)&CrJEP7|vu4TkhjlgZ!E2ebI-5$9Wm
z?6Q^jGl))0&~LLd@jV-)qscn%KEEdsjI?5hU%u0YyT>kYUC9X?Iwi;7;$hCNrT7qk
z&a?h~_k<Yst~4e7Pf3}7A8Zvk{B_FzYz%`Xs&)Ohu*rfF+Q6Bg?!KRV+<wRII+VWn
zi%11h=9%x@xzyZ#Z#P&a<TK05av7%R3;Uj?fXjGGW2mjmZ*pD=G^vo&UMu2zO){%5
zEtX!nHAZ$A_)o^nyz-6Z-izEb=qt`5YFYA(^BslxxwbF7@W*pk8JCEQ>ZZLi;4kH%
z91ymjAD5v79Dm^_Hwm#nb<MECU)D&CaS#{C%+^Id`?c6oY`}>Bad|m+rX!LzWy!Vj
zP9syp$v>5eId-Z}6S0-`M9QV*&Aa5186oAX(Jm&HJll)rt1Aq5CVRmz6=g)++u|nf
zatNLx2VS%)q$|9TZ>Y~^gBqR|v@dXh$K!t|AB|Ha6{ai`X%q8?H*G+lp4pMKZ_M#~
ziEiBWhYohKJW<0B_l}!}fy*Z}J0>+$0lIf!Z9HGg>f0f-3c|dTBr6|;IQYr1#D6cz
zSvffD*X8XD=6*>a@<3+^`L#VTB*cE}nh;0+6Xb#k_YZPo()dHU%{?G>#&DacJ1!{k
ziD%SA>HVo15N`tg3V|=;X(ikTTbsb0tGXhC_#$DpK6W39;5)7;Wa_DAm7ejcOsq`2
zwDRiZ$qaWSn7EE7v^qkvABy1<z+{MR94W{;Mpcd@IeF;dubZ1u2DqO_iTSxpCI-(P
z@t!>U%&ZSqc=;E=9f`!4&aQ4v<d2qLQm{@UvE|9ePj7_mIKaugU}Uw)RsGC<tc}Zf
z)_UXobh*I$PmRrk5dvkz=UgO2^Jvsh`C*l>&>}d&w<NOK^3%<$gy~JZ+dmiOrd))$
zo;rha^!{%FgV7n{Jn{(L$No+t0=rAgbxJHO*O|Db<m8WxoR5SMM>Xbqmy-02N5w@~
z=KdzZx;7qu;<<VM#7Lz_yf28BWen-)yt2kQJC-B&+GrSZTE`XQVNNS!Q}`F@-L_|o
z@CIS|*uFK*$7McTk)`C#cl^8inLC3THP`vNVtKKFANhS;oY>?sfCusX=>sh7-FJZ5
z(Z%QdmY<36{QvUuopLK^jWwQ*B{>Oa#Lzj~^H&kXKsx(mx63qf1$gk*qp%_JODiP8
z@eoA@370`T#3Oq*`AHG@N4iZlp8Q`e<bmK`>QR$5LM3wKhvM=_dMM8NBfz}gZG3+A
zz~Wm&ag-IoEX-&|@jX}|I+Vx9a$0NmJf5Jhmh)^8a?cF#KL|$SJ>-s48o#^lGlcK5
zWx05ZTF^7yKP)#Top2+oz!JGKO@sVIKE;9ivv^;t7&(bSUT~ikWJTah*RCk{OIiF~
zION4@><0Xs!u72IZ_B)z0t}__<m9R0Mdhh!`{aag3Hjjlmx$<fPAcZViQ_Tpo`4sW
z%kGUdNrr&k$q}cGm#Vx;pMt+e-If*h*g^OQvqif(lkUzBy*ZKt?kmOw(0-#YMM@ge
z6}!ve>3p?8UP#KNw1g~2cdRwZHegG`QNs3M-*Y=WXT(qEy<Va*=`gi3Yjy)0xHMVQ
zCkA1cH+<Uy&v#1!XCWHSZlyp00di?LQScHwgbyA=$DaCcUG>b`P*LsZqP~SzsjqD!
zyOPMA3jRxZ9NU5>C@7adeOX9JcQ(>>Uv2iP8KZX3S-X_h-aq+!J!v+8P(;mBR;!bi
ze(%Gi1F#vdA(_uy1`8J;&2a#70-z7=<$6>$Xmg;N#AdeyROF10E>?D!KX^9?`%yuP
zGKhI~%%HUE@QX@bP_`e22AhTWT?2k6-tW5`pxviTVrm-vr3QrF#)Q>H1lpO^gk5Ju
zNZ_fp%BT#nnF(QBuB&L}%;s|*2Zr!^4-ciu`oVC(U0?tJ0001A4_>(~zMgLy=jrNQ
ze*;EG-?Ta}mA{qO?l${g*YT?^){Xq9lgfEFZQ9-KJ#*S`Zri+hkG>DTJf_}8&6{?%
zZu0*S_JQpl*R}!cgVr9i);(~0e!sQrk6e1=)&lyl&Z@q2XZg0O0|Dy*dts#6jQXKX
z>S;Y1d&zrGY3=&{+uH;9PjB1xy=Sx@yV`E{`D13?&HK&!0DA9T?Ev<`e+UEG_P`HV
z_TJb4Jzxj5>jCW#Y#zU?2k{SY+W<L-Pe((5AsWs!)}R0Mav!TgA%53_@Bjb+0ty*K
zfS3^IDM*Bn2nfi8dWZx-PzP8@000sMlo29`5=0_J002Y*K;;Td)B->v<UdA)M*XD;
zKmY&$K)}7g00D6QzyKDQ0IHw@-~dzr000000Wbgn00@ZyZ~y>Bu|b+(=x;U4o8sld
z=3GmC>by<^n~2SNM!cM{UlGaNx$l<}1C&MzLWGS3&Qn=UTd%L;HxW0N`D1w1h)glf
zXaxGJcF+%eTz_E$mPY`st2CR`bW9apI~mQB%*u$t7bH1ZYLgf%;W)s^_+)~f5<&83
z-^50UjLu<#*NDP=z8kpL&ERq5k?|Kn%_@lDH)H?DyYPR_8)|!ef)!pOY)Pz#G91JD
z#Jr5i7#9(Bw#F(ZPcC9J;zmH(l3_xtG`LYzWpwX)+88hq-Do}DvYpCaB$$7jKe!d{
zW?M4KtW!;<4)=*S8BAf^Ps<sVPGF0VhaLoV_cD_`5dfpyzyDcI5jsP$vQ}gLW!hqe
zd&D~UM7|hPTZosFD-ukM)AIBC;V2>7`fbn*hg}fi{7eEp(_g*u8((RBNsll&KOJIg
z6Hy)`5zEcp#C~2kjIk15j3xMpKO#12x`|&2f0}ze;M<b}oZ9~r0=G=kZs9hTbiOH?
zF=ac5=D@3wFJL;&bgy}R$}n%<!5xg8k;{tEJHfn7ae0}5iC&}kDci;`#7JU0x`|g-
zAo6;M-X?rYo2g7UWQf3l$=WqMoub*|FP_<(gn7s*K;uZN19sMc%czkO{$=|uC#%9-
zWL;*N#^r3#uHaUkKQk}BaTuQy@<6wx^HbMPQ}>B{TDXnG%f(Uc#L3Z)w0J|UWZY&t
zn@6OEIE}<b-UNi0&Hddx*~Dasz=O$$tgnd4iKveelaolR8wbC|O|ij*vUg^DO+-x{
zr5k%VoJlNa|CT$WahWE>_>#{KUQ9TK(tv&@KJq~8C4jRyzcMFhguwwE>eK{!(qz6Q
zNqmdX$JD5*I+)w+d7`l-z!9VBv%ljZra6ovC#?Hx+cn|0VR?wg^|goq3&87lw!5E%
zJF*5T>pknt2p53k5y;Q;oTn|O*WxlnWaIg5tanQ>Xa1qPbKOFmL|t3ypo5e*f<dv@
zH()o!8;sL5N9E&dtWSxP6DK9CY~940!=5H4_{?m&4Uru97JFl`w%>01k7!Gf9;67}
zf5HPWCDAZdBD#Fq8^hv6|F%HwyJuQs*opmTL0nXZCzR<^#8UW>oUs0GUQK3l#JS=8
zynNZ0ipMVK>tlS71U1fob=#1y0qwi}tV~Cn;NlY6?g$IEpTu~KoPFuO4|oW>xdlEG
zTc<VH^55X~X`hO>I#UiXE*;$09~?5Jtlw=n*XS=gL@Pk6L<bfkT-FV+i7IKwHzqW{
z5j8C?CR|NoYnwxj8Llg2jnOz#*nbmoAB^GQtB0d0te2?w)+CayG7$7_#zGq%QsM@F
zOl{p517CCn?MZ)(N~+pm4St$E_8WP>U(E*_&-ppIm>;K-dk1^*9wT_45K6uhLy7oC
z!#zg@rvTmZeklax#0Bhev+s&#ZWFQxgkWSqZ$*gl5=ra|CL_damtcTNeIU91_S5^J
zNssw9XW=;XxKSHNW}6)CQ6G~oS^J|$ONoO#Pl=n88eiqd{mISGXTBowJ}2%svenin
z#KmGsD)-_taec!=eHS^!vYsczkJe>{yrC+b!2ewHWe@va2c<m7yxWD}i;uW-Q$lms
z&EIeHc{oRx1UML7(}4hfG4F_r!w#@NxIkbJXM5-d&w5^Y8YA*@)8Z{auCv|PLuCk+
zyZr2mZ>npAFq;$d3~EqWEHzQ!-oDl87?swqZ}+nH;yh38Mr39Uu|6h#6Ykn8&xje}
z$6DbrZ&}8y8ECSTI7rs*{&>3Sk%P2iAr7Hm4|<nq+l2M^FbdyizI^$4{o;H~SE!%I
z!Sn{_C*OuuvxWyAJAc8LWbxS~`-)VsbL(^&$IiUR#EIq^Fi?4wuS?ipK}56`pLm}W
zKOZCp<1B|CHf(|6ApeVitE}Cq6>VmXP6cZcw4ScS5?1TPliNwR@gjU<8_>Y)lQ@`&
zk63Cpw1uemx+YlB@%A#>WA02IXyD@$;!TdVAt&dS+{HE~ZcKu;Kx|C-$&%k31igI+
z3`zLzJzxhrlc3JmdS`)^>H<$T1=?T$5H0GNOlP!sLv%m{#b}mRPN3_0`G<Ep*@}$u
z9}{?+<etxdBgAi;p2u`i6L$d5N3{5u^p+u9?2RT9sg!m5qDlMV{N5XBu@dk*KG{7P
zAy0|pxZxfZFE#|<kKguy{c%-PH*#p5E>|eQWFHA2@dCWwXa4ME)ElxyZ;QfjcNZi?
zpHU-h{RTDK(c7#a@=dlon~d>3CSFWC@9`L)iJRnQwlXwf1H3*eSmlkOywh%YiDNL6
zxuAik;&{~{(zu$$4Xiki5x(PhH#6~F0g*+JFgcmxE&-V$<n!@xceZ(hQLu*8M6%?W
z#Kk~S>+`_I?n}a7&+VLzeo{U3{vtBSfsM7S>;46>fWUige)VX82??aUW5uU?As?lj
zb_3gM_pjl3aGpSGUkF^*Ci>&HIM9(YL&GE$tSYn^jd7j~VIoo>1sdJj+oUKsFc{nI
zTkoi)oBVjySEL_Z)}x6Cd4XO|AJpbYX2})#IMUCPnYV|+rOu=9hk$K9Px>JzOMkgu
z`S5r5T#1(OmNGxC4>8dvnXE~r&6k??a&cZQ%=>taL`&R|^6U`lQTZ!3$s`BI?wnIT
zxw5dTQvmEKfDoGQ?cVs2QD^_e{Fc_*#LW@;v7q8mcjBN_=KoO3u}WYzX0(^B9r;=@
z@jKHOtm%tr{$Bn!Cb1R9V@ua(6hSZABn9I4T3MJCn&b4${JJGUvxyU9&$HHaRZij5
zClw#dlSX8dga^gJHS$<94PVRnF__){p#UqHkumm)JiKCqh<WSYv&gX|&LMzl^|F72
zFGtP<vntC1ChCtPk6hpPkDW8zN8&nRx6<N2OE~%C=EOD+b@301lq$SZ^}-qzFlw5y
zi*`ICn6!w$#v{ajO(i5_684RI`bta2cQNxAm9%T?qWz7O$Oj%bXgzy8{*sao{g&q!
zu6frp4M*haC4UL-U1!Uak}UBbn;W&S!f}j1sh|l2PLfDsCGd~aiR+UC6ls-tc+B+@
z^Uh@p?5+1F^k`V&#ga8<3u)I<Rb8I+_aE|Nd`Y~v4*X9xwegVd=J3KKdLIq8^20Pp
zL;KH%73Jx|cw$%4iTiNbmk)cjwur>KBARRR)02KHU{E}y%8cksF&EPDqszHg9h`Sv
z@gv|TXx7r)%MSkm6jXKoX`-rk41f&gI`M2bRnf0+8O(LHw-R3|ld7XmnnB`5MAFm1
zH5N)d!*w>9%_@P|IpdKJj^_Ouwa&>SQowAh(eLMF>_lcB-`S3GP!px(Q!&>^3^y|Q
z;WF-!g(@AY;`yxO5ijOblIQ-tahM_d@R6j?WO8nEftNY&v&=>7SKWjsL#YHk$8+_#
z$C0?%--agRm;JlGBq9A}JEH>{I~?kr=5}`o8^<*{y*y>{KL|^*qHNuCy>-Zx2+H##
zyj|vn>~3kKv65pa6-oFj_1?d)t})O&kPf0N`||@RlQqQfW8Bso60K(mb7I_b;^XQG
z9^HB2FWN#}Fj}gBYx3S3<?D}(2o7=k!jJ_!lYpH}ZZnugF@_+Zd`?%!gljQ4>jY0P
zYi)c<xv<#%ar(=h{zd2gag(&<fN^;zxC6bWW3ag$j-}vlPD|(uEofh0+uZH;a?qDX
zw*P7_*cUyY#EJabU=wuCp5M{@JOK>1PwndvN=~K^J>pA`2@u-X>!#v7tf_9rd;Ca?
zWoBIrD>kTz#ER_=c_91sy0Ihmg~6~I%SCL(mv(S=mDz)~?!g(-S?se$*b?mW{urc!
z_I^Gxv~=EY6RV?6Uk-LS>iL{i(0zMsz~fHz6J{Mg4$ju`E=Y34;z#J%f*tz0({yc@
zFdg2Lx7Y3wkOzLQwBDivi4rF~K43YXmIQr#@gwtDfhYs=)cdnb4ugQdmv@eAt`G*_
zF6X%1A)t7Y`GCqFEzj-T`6m?S&c^XmKzep!RMhtFAZNb_dyd!Zb`uw*2DfC#YutK+
z_`hHL4f()L*U5v7?*6z#hWwgPq#>m(`0S?)qOp)G;$a)f0?iazkml{}%xKLD!-$N;
zpdxO-{p=Ora}M`EUb_2uLICd+Qdid}OEdT6Z!PV_mNc01Qojgr)n*YZk{#=wBI)5T
zP0Ox299l8`<0V<a4!HSksK=UVN52l!JS9VABp9R({=O!-P95CsZf?<|H#yFBu0Ehp
zRR9ItAUyJ5U`M$wM*!tO8oz5lU5d<;Ca+VEFXSfq`0p7G%oPNnUE$Oo{s9<ZfB)e=
z0g+th$PMQBWP-%Fv}#X}h?5PuXgA_t<MkSt^t+&A+1$l7i6o;tYqeT@d=Wcr+(7T(
zSM&R4fJxS?JqLPCezLf<nw04F;_Qz&oJc}U{NEW&VB7eDOIb6-_>$Ypro{M=guAx5
ziLIFH>_#Q|bwmgs65Q5y8uW$sd9uoE;xnW(?EK}074?4*5ypmMJHx59VYXzR|Htt4
z!rJWHxwRy>XT(NQzI3fwE8Dovc#U!Xzzuz*=KEgxfG=d7y?up<2klPYy=mfn|7H`Z
zf(1|z>i-{;*|njsTbJG196lLb2uy&?*Z^;`aoAIV=4+2H?Pn(e_o(&Fgq(eFdL1wL
zLJrDVfGxYEE1h8poH&qM-1{?bLtC};pWiT-IfwVz{!XaR_=|I9bBYh<4?J+E&LR+v
zo3wN6@oevE2DPSkVP<<*0#RMTyX^7o-Pi*n*Km)0o+`LaMCNX5Eg#OnY~|@I*oepm
zd~Rm6%em)SIf662us7E1{i0kS0oIQ4uKprfKefKjPP3U?8qabMv&CTL=`t8ziDbl4
z8TgSjT+HQat)_F|O<)zS)p4KXo*VeiczJMQFr5&a53OuP%ZQKWOUnqo;m*o3ZF_jV
z&D^mNoXyE5_VE%;e?q%WSbzOrs~$3WO;y=|_oH*SAa_lqh(F2$^>=>P`@h_x0*}S;
zJj{$3(VO+)JGAf8%gYjJq_ntzmS#LE#(pAy^V#pk<h`M|%LGL6T_<Kd(eW5P<Lx?g
z#J~V4F)G;W;~7kGGjeM#-T0SZCkH1H9~upU7U@yp)`BZJ9hwyWt|U%i8s1vr&YxXm
znLx1Tp_Sy}A3ZZx3rsJdM?SfKggEcJxDcJI^Copl5ew|{9P79Uk1c&jykBN)$CUnY
zA0L^u)B+^5@1pgvAtP*nf0=3DPrM=m0nclkFQ(-fUS8P&elG8fQoMeG+>k0~J7O<A
z@x=1EwMYuJAKVL-%)CYCzBrM7B*k+jz}rcZil>&KO<~sQ`7KVgd+Zo#+{eT0<+k!b
ze)~Kj_|ooRN7>z@b_71y6T2~&J!pS@oyM1Q0zS`NnG8q1(cb@zjD9<BH@utu_e9`!
zI;G^d;31dk^KE%;yELzMHf?AF<y6Ab@$f|NWM_+#z|`wz&n>0sz;2y94`xBh*a@8L
z(W4S1X66j{R|BhEyCf{$)B|?z1Fp{rxp>k2Zd3IGaQi|1P9V0!-w+^t?s4v*5gD$D
z-`zA{Vv+GN?CyW~Vi~9Khj$IOF?x<nj{%&`^`^clpB)I<&U_Z!O}g}?flAgP@At6$
zcC{}CWjmey*@%z$4^(&UyMh4AWNBp?-m+BaxOl*OXMXkJd2J8K54m`O^PA3Uen4-_
z6A>Jpxf;uU7W}c&xBg9Sjyq(?_ngyEbRH+j@20TzCUz%WW)mj)U+3h3;gTLNE&-3L
z2C8pwbiisc^FMXFK3*k<!f}C-@W!<>-bi9HL~bJDMVOVEh=|MRW7j?paXuz)CdNNX
z`fWSpw!es=WXw96-jfY(&j?_n63fv9?_Ixx1pBTI@RNig-Op6MZ-;k2frocL6}13<
zJxi#ph>t26HXyGnliC+~{2>8*TJ4zcT3AGK?$O*4V0ajEoCNEGqilg=a^=K~kNNrA
zLPenuUQKbt&ekuF*+L2n_PO6r4lzbxFKeCAwm#qs_EWyr$b=Q;+tjkXT(-IK@GR8U
zdIa)Z`tlZR<uEZEyIwr+raIsc%IDT)ZsQRMKs@-8#A|0K7H?i9?|Hk8jS3nLE6BN*
ztTe<q>;72<=iU57k=AwQ;<BCb;A=VN_2Ca2UCjsC<u6?B!KK{5kF&|T&>d{<H1{wg
z?8gMTH3buZ`(5te^ZybM&S<X82UR<6x}$BL14f;o`#qZaQ?nAO-t071*~AWwep)^D
zLRh)?U-H({(EVZa?a2`z@zy%?arw@f<sfSvvwDVoEb{V<cE@%9E_0@NU}GHh*{Qu>
za>T}bE4;o`$A^b~*6*{$Cd;P{qBhoYBnQS!E=Idlc35yH0Q`2}VT3<mh0FGT%J~1u
z;yv0=_x>}%9_OiqXQpSHut?CpJQ0mV;UiL%$Pe&Bp`&&i=KH0G!dPw<vEg;VUlU)i
zbnW6qXY@F9rhX)5i@2T{>=HHvQCB_o2e+5Uw|O$Ptn486#$kA*>R3eF|M1uNp!r-J
zGjzC-o)|GvL^e*1Cwcn}f9Aey>;qYRR^K(X>Yq2j>zas~T-g#LY`??^uW=U@K|3!8
z9MPo3Zt0#bC&bOofd8Cof>mdWiJ6&`KaNh~@<R+6{v*U>#E7Cc0d3OxPZG0D$2gFO
zfUQ^;mxC2sIRL9<?KW!!isl46IfiSpdVe=^qC}IRLuCFCjd@(Y+{x_Tkf-{PZ@Qng
zFEBmJ-vOMK1XtGZU<Y<nt+x|=efI!&>UHg2L<eX<C8_FjeYTy$fE_-kT5ZY@7nigk
z9V^tG?bXDOh;+?42R>cK<LInyuYjADxyC<KgW$QM^6vGC6*e2)qAnNrH#PTl`S?TL
z5$1QiHN%}~t&KN$68j{}deDD;pBQP}$HVOP$;d^e{^#OC5xY)+>vxkW%=fVCTvpE!
z4Py6v&NAsex1)300%1v@KART_M`#u=mo5jNjfe2s9^d#vB67|3$?glk2NkN&Z(QbC
zGEc~mZXD6Lzvq3)u0QRkEdl%4@V!pvA75u-eR*<qaf;_K-S&G*xfOE<p!baZkX$f^
zWbgpvQVd^pubx|S(f3$9W}=3+GgnpOdcO!uWidNg|55sJ@sM)rnBLd?eJSBkwA$P~
zP2XxcfXvtW`*(MI1KG{5wf9eW&G=~mJZg5oT-_hIyNG!8?_Jw;cy*07wDzc%P9<wg
zd@ovMMhf=3r2olz5D+kza1vZ22Z$fbf3R)GPfACh^x(ktF^w74%zPgo4B3xEk{J23
zWF9aw6S|D1En)hJl4cuM2N55;T1CY1AD5Qo#E;$Tr7=No;D2*x$HYa!4y~)~Bx|VP
z3B8mw>J<S~>K?Ot#QgA#KMZrkbhQfn0bJ3Mn^R$Zj>2b8&JYx2Uhl>x5Qayv#WWY1
z7n1nNIopd>_FKoQa>0z4#XkfyPeK2DL?Op~E9HgWTR*&A<%X@xe}p*svlcLCEjR~{
zjJ4)|AtsI+@Eed*iL%xHf8rq@1OEsKBb|VowLh)<V-tV+W;RTI=Wc@$69M=6KJ34{
zKj0XBGc^q!4)~7}Kl8CPZGkSp$Tm*bn&kFv+2xOfJjP+N^ggcU3v3CEgMMECZt-nz
zc5?wTnR<11JV%Hnie>Z%1)d}!0cP?}+jC0YzzKdy!MbhJCjnn%oqXSLMS%eG-bvqE
z!d^N@*0!pG@si{i$Men$jhWJUgM=?5I!h)ko>nVouJf9-|2`li#5<9ha2mpa8%TWS
zsK1|)yx-yk47yYWP2`<zu88-}U?tv@4c}kjB?N<WLGSS38bHK@OmWxGgmJ+Vm0*9j
z4`h1r!S~G@1>fQ$KO5H-G<Syt(wQ5_z{iIu;?@O$ju)H|5=+ickW@k5A`teL<Oio8
z6dTXQdc)X=8)KUB{SG+w$(VxW_b>R&In4c0?M3pw<YTvcjk*zW_P_etx7Wr50P^qO
zYv(iZ)3LMOw&RZGekYqCAsP=_=EsBeO<pc;XS9(U0}EheDLHLHzAoAApN>6o_oaL!
zgOUx#Axgp1Y}-osL&4q^TYMcwOt;9_;xhWV5;H~qZ|+1B`7u5uzIbqr;%A7!gUM26
zNSM9=M1EJx;5RizOwSYl+kgf)uD&=Owf5xw+dd4W{0|cySpb{YS^2cvK!05Th2<~)
zz{?)hWmy0JG$d5|{w6Mh5_~jMz%oi%m;WElgI?8n*$tQBh`2L(2Bqe{dK8gA5f{%-
zDj}ASBnV%^$`B9ui>o%XbEU)x7XcUO-^cg}GLhaA<+N!<;v>@dv8^Fymw+udHd&+`
zd$o6u8G+8H%m_`Udyu+bgR65KSQKkR|I_5cZos^|Tvw}yg>VaJ$^V=-*!GsWOa5Lm
zPS=4C)tO)AbO#_Un!SH(zL@?`LYInK-P>&O6doHyF8kiRzgO<hi3mX1l3^uTr}%0p
z^BN2a`;UEe`qRm1T*YQj%ZVn?@Cgg#<htCsaUl=Dt;wGC^g1@k3KuNXuhtyE$vHDl
zy|M9>0xm)i{f(Olzr?Rl740pleFu<DcDzX`$*A7HoMYhln9d|!59+mt&sz@o5cN1Q
zzfs6sfagi52=#n;@e)qC%-WET$!8eZ&e`~uA`tVB<T&HXr&~5tqW7JIf^*OO-kle`
z*BJqs(aOE@<8!3l2d6o>3EKP{ewpZ7a@4q_{|Q^HshW|zoM;7}(^lKU5F;C&;XS=m
z_!6LIW4Y6K+51~VFRS19gE2Ao>fTcSN%D*hvBc%cHxlN>|B5g<e3slu&vRM0*ZKo)
zy{Nus-n+-B{6n|7`=KM9w$Txj$gv|G?3dMa;xnPqT=<>EJFTC2;*;g5H_bu9%Z3ii
zOk5*GMjHWyKwhu!vTuS-wXaU5c!>F1@sp~`meL#p_03F?9Dv@rc$q3XIEixun66~9
zb7u1~#0im^ei7koE_lB^GUKjHc*pl^;@m6AE$MME{}+~+-<wSyBMI|(0@b=;XUoTU
z12=tU&;r_7@)-I3LyOTv1KcPLfDfBjv_}5?t9rS={rYS#&%_=g6WXO$y`Qun;g~@{
zCf@=6>PXh#<Gdx~VPsvOR9~<UZ|iO}?B?MAaN=rziPXNiAWYZC-$0`Dx1sVs@e!Ro
z0c*ZMXUH(z=BNITvgh6R0&!9x!}czR2V?dZm75S>FE0>%a>PP0vX?u3gDY$2)!m)k
z_h&2flD4>e#6lm4mBRXX<6ZlCw!S^=HNL;TaoTrVfAWnB)i{YQ&24$*h`agm5Z7G7
zkRBaUpXQRf&y0oU(`!EUjq$p9thTfsuh@iO&CM}H2NZDSL<=<u%1`qUAZLbFOo-bz
zf^XNpcuV`)hKc^X$)Mrj9$GYUyKLQjquvmcS2P}X)|l`|`xspG_OQqe$ejtJPWjhm
z<l1-)mX>MP@0>{Os+dA~Gkad11h~b!BwU#B)9G0Vp9pZqY1GUMDE2R_vEQyh8^+d#
z|6Decp1+a@>C>^JjSPYLIX=8+=t3>y{T>6oCaZdK<DmoOiNs+JUm?aSIdJ(4sp@YH
z8?^L#h>{C0&%_B^pe}O8?013hScpUR)p`Qw@!`hKpMEOm_dEk;j=k)9%6EsvkD}!#
zU3LSk-QY*7l-|@=Xn%6><5|zU+PyOD1jA=N8`q4(_DxpWE^OYp4xdETeXkn()xS`8
zj_5y38+zToUOITXx2eAaaXkc_d}L$s+j+g&M*bXnD2_QnLj&)iepAcc9ENWl+O65G
z>3e|3=DGR2xA*cufnP~xQ9<=ZSB&YBK`i+T_IF*vAui3ufr(7>y@82qn!ft_O6!R)
znh7!SBCFFlV{OL1L?+J&M%CNbXjpu{U_WVg^?Q@XQ46R6`&VyWOWAx6)aKW!^LD);
zAM)?>{%&jBVkPq_TH(`|$L<|LMIz+?tOga6YrnPfd_CZ5W|)ppv)}FEDPqdGnb`bh
z8;BvtbTNTswvT!LBo7F{$v8Q9a6i9r`kAh7S{8v^O=4hzBM9?&0^0e3?Z=Mr5<M_K
zc>oJ)o2rcb=KKEipMAH$5X*GH{qldm@{9M|U*fzXV06G8O#&1DxFLA_6MeaV@jQ^i
z4u`|y2u~LPiLJ2y`n8XQebJFV1TVsH90>?uLU;$3A_7JLAT_O|Fc%je;0plCB&on}
z)?!4DyuzTx>84ySvWmHYdnVLxtneBurUZKjUB{FQ2%E%09}ucPMSQH;=m|>X27A2Y
zR?c4%o~`d(RHCTL=r(CEwf3&RA+TQjRnCWN|I?HjRj2s9m|^^rC)$Mt{FwLrd2s<v
z(IG5z$<Pt$wDj+}eq7}ZC=$t6YHy%R;`@OY;m0V2Sois17UTZ>^Oq7x7&Bfv)15P$
zv1!|7!~{12BJOD4XJaiqxP0A%4Lg|QeV#Ixu0!hYl3y?(+5RFmm(lu3?VP#=BSs9L
zM3OuIlZ#~2`<d}D1}3!be{YOBKyK`^iOxX!xj&lZRmF2yz|;7FF~upTB=guyvGvF5
z+E7Dw_1YfOz+UvbZOhLA+Vs19e*C^*2(L@F+~Q*`PjDaN2!qk>X7<e~Oy-o+y7bA9
zN>d_lL;O(`(+XPO9^v@BG1i2lu<_nh14V0vFFsx9WPjlq63S(e7Ifz}68cAZ$sd@#
zbYcG8_(xk?Lq4+`h0o)%;#qUsTf~d=a<PMjJ>p@UO>tSg-Zf9exfii}i18S{YD289
zAmTD{-V=0yB!08%i}}F*x1R$YNYB#13tccjN&YX*0F{9wKYwuc<KsCY6Lx+i-LC`u
zUoo-JVnm7k{s?vixKeD)94gNl06YCCLD}@=BDXql;MukKLUV?}F)ZRKR%vtmr|uu;
zkJo*x1GLf|>pvy2`F+(n@FriS_l~7jW8Y_#rIF#%+NGYUpWbjnq_V~0MNYGtn@Af2
z?NED@5k_xS6t}>wP+I0bXT*d(++k*;c;Ypu2J%He8c9$a4S2rXf8zN=0XJZz4eqB5
z`_Yjs$cDv!ct-F8zV!dES{+~=$n$`;d1+f}4iKp~O^UexIsI1Jd3V}ahT3uS&9~k&
ziHpZ@pi%WL@U^HBigeTYz9Y--ScvZU1MB7Qul^i(<bel2r~Jxt>DBM|Ox(5%*VF6#
zm72+(U)&$ZHAghOSW!oP|FDc_VGaBv_<;tO2W2x^C_9PqHxc47T(&szhr<!#HN|1a
zpm(Ily8sp4t$%^(yANacpy1da<M^mf;nAD|8<Mt9;Vu{=(pL-~Iu8N(kc1?8lzCOO
z!ex4Q%RL9T6NQ;LV8v06x9}d?^81$~Vr0$q34B0;T_j`ybNf#|K3^h_B#S9A%4x}(
z+JEP^hl;n-qVZ5yfWFe*eLP;}8(v;^<QzDf-tQl!nZ_OJGe6#*0U)WV!_@DA!BJ-r
zRb-l+J$pmOYc?j)Q%BFw?)o!so;6kEpVz;c^TP4VNvQ{|i4P}9p?6Gaug!!!yn_Nl
zgE@$cxRWTu@TcIfp?#htNcxNQf7nZ_f6MV%^6ej=?h(iWf0fAda<gYHBxO&yz!`-#
z@cO%@Zs_<Do_ck2^IpV&C*|Ca57M|z0WjYccG9cQ^Xn0F()sZi*pCq`tlf+kL}ZA?
zL}cP@U=Qz_#ujfe{sFPu;n|3f#Q4#Q!wuqb6aR;_@LoJa8QH%vL0Sc0o&A6t{g72B
zgW(yazpoMB_g*I#9~Hxx@?y@sa_5)7lQrL&*CZOpA?w_UaQ^eIBS}HQ3cpRPUAH$|
zb*5U{Edv|gqBRkGaI;;K<e%PNZyljxB<5m%SjuBU>|o=H@X}08IWH>Ad#f5h$8lH*
zeb4>mJea+I#b7;7RlYKUwu}6k(m@{6^};3KMX7GT6@(#dAs2}85OKvuOlXp0;gvHd
z7vVPtOdBjJT0ik}ui>e=Zx>v%#t-puAK9p=abQZ{dwQ-9Nv<!(Kms5^<S?J&<TmC8
zt;=}S`D1sde~X%V&?xq1r@bU3<m~*=ht>2H&&A=ETfK{aHZswo^F~?-AD&<4(4ar$
z&IAg=9}~h>3C_4}Q59zr`I9@sQCLD2#6|ct;_%`u4@jP*s5&3<{1Gpi!tX7wB=8s}
z`G9{c+q!QkU@sH$`MEg$I2r_ZC75V~26+BX3Eu-~&+o%1rk}qLNsq^Pdo8mA*=_*H
z*IT;luA{_rMw)>WbZSst;o=2QQ#BOOQ#2IK3wF}t-tUUR|0W<Hd*sMDdQ5}cNt_4-
z!CskLM}&MLCjh*$ChGi)%ERLP2=j;kLg*a0e;?QcCSBK?gVTtrW$HRdYDfkW{t)0x
z^|be&I2Goh$B;g>`pkVvXNMH4pXNjUbNn-ZuYY;GxP|FCxJQ9R{C}2Ml!?YLoWo&W
z5cq$BCe5jF&!Z!%xRp?FDk+kY`YX5p!2kHq!-F{$Ne9I9b1)i2nd3ZeR(eEzm!k=|
zZmGA&|A+WLnW%;1Poj-QLwMG)FyC@Ffh%5r)$RVXht3LcSDbGX^5F?Nv492uGPQg;
z^G;-bx8W`cm)!AT=UsW22Y1~u@nzxu1pelZz+(5wyZiJju98Jsm+svNyNxOg|E@>9
zwEn=7&hCBNEBuBnb9euS9(1wO$%2bZFN01eE!&KT0RIR;k@))QdoB3RS|x-Q+ketq
z?N{+QMZvpRa1j3QyuSFH73q~pnxxGVm~Qy$XZN>n!Vtum$d3Wm693F}8FX{i;VyZ2
zh)OhEKh}f@@q^>x3m2O3CtsRclpy0G><q#_bB5ePrnQAdtx-{5_qsdR6@%WBApesn
z>6`I>7|Rsip|bWp>+Gzsn}?~9>yYnU{vGR;*FSu2ADj6{s<fCqrpbsBt7(8b`qXVr
z0)l!;WT?$#Jz}YvU^5EJPf6#3qPo*J`|J&9qX{45GT=EUuuJTBpT{Pql0NQLFdf%*
z5CD_Xi{)gy_42eyZs*qb{O*nWdild^M;UW_|H6<NPWYHVoLr8{Zovq0R)CUfDND^P
z$AGqU&KaGyuK#P4On3(Ry`ldVf$U{8aqoBKHof`!kT?JTjOe@x9<$%XNyg#X5)Mt0
zWEQdS&$20;2m84!!Tox|A~?>m|4XYhd!iUbFdaz$2;iBK`q*wH!R_Kg!5Fi<@E)yn
zxBa>HgWkRI{x|Y_75nLxl8k{VEcoz%n9K9+r18r74D#c#{wIatvWZIf*Ah~E)gn{C
zUSCSrB|bmEv`{n5&+)JkS>4aw6HNDh0q&ly2P+60z=tngwA#ZlRxgMlEjea?^cd9L
zDPJFN@cP@-D?PyM%%T5+34^+it}@~Si2ylUOaQLteuMZOP>6x{mIVH#;FItFdxncx
zfYVyfE)bK2<L^XraoF{MPzCN}u_|x)9C56f4taXXfc9FNUib~G<k<g;#rS1UD^nge
zW&PA%ZtbLh`(7I7G~xf~dd$HI0||P+uXqvlzOnDj?QJRUJ}|>|wLkr)!it@yhySGG
z@I<W=<429hA@TfvuUB(J-Wh#te7puFjXyGo2=$qQ6AF3TNPqfof6(~`%_a!$rj{M=
zhu4GEWO1L{1}kg};M0i400MFo#?b6A-TTMFTsu8nd7;D~?x<8TxI?@|M;BrlB6NxB
zM9Y7Kqf?wLL$be<fveLYuG!~`fs~Ur2H==@dd!I0b%4Ux(D?j#s0MG+n44Jt=>Gu&
z-Uj$J|0Z?pOPd3(OhLucXM(Scw0Q{)k}dmj0Sdw%5EF&AOUO7=s%1!>?~le)rk(G<
z5T_WRfB%f0*}y5&t*0OU)S*{qrRV04{yW33U9kUCr)NCcMp@ut&aE%}*~_o}!54t*
z4UDtCuj(cuUK+tVKyTI?E?{0tOz!!;8&p`&8GrDmsfA=~sjsG$q%6MLIToU`PilF;
za#Y&o@>Gk1@jNvP^y$}pFM3@60JhWXht-yh?*I7SZ~zq>TadV~J4vZq0OQBZv`~Y~
zXtdwZYnnA>Si(!k|0b6XS^StnUI?wG>fd^E`q?en^@e26jmfn7*!q?=b>DN7uCx8^
zos+*3)w_dlb95mcQcv3beLHPV$H88GdjF2@XPyP2i;rE&ug&!O`Ft7$KmXtYBmH#u
z-{s*h9<+*mB;ui!Go=nB#<uoOP9KS(SG=*0eB34K;2eW-CVgfM2gFl*Xb{xHxoz@b
z>yl*K6K9jaF}n@I6^Zzng<JxUCbv)Mq2ySZ0%`yeo9?@>`~VI=(KL<S{$DV0LlaZ~
z@CFx^<^)H5Pg!{Ezn_ou^6&$_-Df;x{bRynAk&J1PnvpoJi%+m?z~PG^M3sQ#zb}K
zudA>50iC%|pK)YCqFi6d-ZN60ieH#EsD(bi<FuGOHpcuCt2g!JD~t+2f5uTFxSD%4
zve+>+Yrmr52M}>#9=Qw+I>cOjI_~zHXkn<1{}Td6;5F^-o4@Y-U4J$Ga&!D%B78xy
zlWXPTtPlXLA6d&i-GCkiq?|gHdUek8fFj)PCI9dJaPSWYBS-%a_{o3~(W#r@0v;)7
zI){Sk696S-`F;jw`rH5V_P8TmZ}|lm4V^F7G_PsjfB)a-Khx9&b^0ao@4NrvWQ$7!
z=i(Wh2hYg?B~KuZCSoPc5PfsPt$I6tzZ>4A?ql>`B6)bN5O$aXr`@;L5gHvGX{L6s
z{~G{edE6rZzuC0-3$kgY1=$9lUC#6P#LcEAh7LgS$I~@ve%EomQ}|2$!voa}c3}<+
z{4EH!Ob@)aXZNzHw96`B62JXCC~CU*-~NH$z0rI?{sP!G?tk&v0}F1p?qD-wJuJO>
z|BV*tl+OW1sdxWk_2-lS<9HK2PqYTakS7~{)_pfMhwY4~W2~(!?)P8|{qs2gVsihk
z<9F@GTnDb-)NG+>XCEnljEG}zl;!XBt9}RcQV9iP_G@BH`^)^p{Em0lK3?EAcE5c`
z@9X_v{JnKtw4d=aaNX?0|N252cOku<Z1X*Fn)~wcUK^%FBX+C)HaQpscP{_`!*JX0
z{;M$2+=lieHkt$VZB`tl6@8|6M!n5hS^C&!^Kq7HkGemvy;`5m(z_{^hy2z5Unx<s
za5sr~$<v#Fy~~$tWNmvM05K|H`Ieb!tNw6fNDJJx-PeD=p#OFJo(Uo_v_>lt5s3*v
zf5db0hGdr#3m_YejDLdzvbHA#Eps4`Y^niG@=M#c;Op)0-<#Ww;cb6hM6z1!3(xxu
z5HZZ*IFQa}BMJkk<<I%~pkvA6bu;l3KwY+J8RFrvv$4&dUq-mk!afcDpx{x^SCU{E
z^`g5!{AOSHX6_{X1KEM^UAq9K_5?d1bu~+=>1m!>3;nz9OjZ#Q<>U1Dh>sDhNFt7i
zjSI275=4IZl+kQwEOn!bA|qTOdMs-@iEfHR_>Lo%It2mRlKHs67z6lD2-+H1{s3#c
zWN-iCG}g^|$B%&vU&?>GeVi>+!mRTOy~Y1MAaRT2C0c0wJoS}}@gpX;%$q?e4VqFk
zey#wwxY^B4UO+A3q!Hrp<Nsa&{;qvIH^36LZzLgTad9Pwr2iRYt2@tl&O5-5dA;8D
z2zz5+$iK#41Zyj9_#yK*v7bhqgtK<-;f&CA<}lh|2)7;E{|&I&51RbHbZR#d9}Ra6
zk0pzNz;5R}4_f&LCK@L(rJ|RU0meFg<B1uX{j-t0R?J8>+rnGBc6q*d%kXYH-CxFX
zm)xIa`AfNgdpu3|ZonWLy)DLB-R<0_L#{&~oo_dNyO8=`CZRL@ou-}1zB9oi$^HR0
z|IUh|%$ELOINj<$e%o<_E2Bt-*!~<uA=(NF``XGpaS6Smm-bg*<+-{QBMpwZ?LP@?
zD>#-P8OovY4g`zDM6C!j!3J0{I=`3qdHy87pT<OB(j&xTIV7^n@jRX6hT$F~&&`Ow
zY+wQ;0090I!>~dO0DtfXZu<SacYsLlOgHR+7q=0CzgQaE{?=X+QmwZC_=4X>d58C)
z)*<Kpjq!dv?0<uyL*n5#P)1)(sEv=sdr<1yJj+wD68vBp?i{&!cumw+<(DQkM*bur
zDQSyfj^GTvcP*}&&xESD*5AaEO5Fb0IPr6Q9k+IPLR*qxfN`Vl^L<r2zy?8`%yEu$
zBW_*c1KGW9Vn~RH6Zd$1<A0@dk`BGEkNSN$rSH8ldtPf<A|&B6-h<ciF}orx4}nVP
z4@&Al$qUTu)l-l%zKxzn&Fj0_Tg)cGma*k65Gr5c4aIJe6{a9xSeeNK!bo^ZX|NfB
zFA<m|6FBzI^2+&7j|{64YLMXZ=i)?gle3?U`|&gKNr~9OmLx_sOtF2~QGXrp|A@u$
zcmjZ7Yf(p|-~r$|U~Jvnzqs+%4jAAAnghjUk%l%A5(*##?$f24y01Q~fGyo~1KnpQ
zYYn@Z-#!98^my2c;{0$HF`%J0!+5{m8iTGMgcbf0)y5>i9GHp-Pk`ja;DiL-n^N-e
zdcbbtehQQ5ej+kirqsFwgU1?l^*<3G!IwA%TeZ6W(18%?tn1ny0T;Wz>%@s4p5_7*
z(>JyLqX#H{$HbSP$;a9tLQ``8JMDMQ+j-lo^3h43{8tXHP7QYw_l|`oHOZ-A(g7!2
zesu7hJR#;qJZhU#06W@f(!~<h9`CkZA_5YnOTt*qM)@jyX*e?$DT3$zC)1?HGEpq(
zB>yKBR@mLNJ6;PoHvDUF8VNQuZzy5>gewH~d5egIBYC+eICq9(c*4MJwB`lfe@`b7
z8PJwhsTZTdOzwK<2}|qo89XG0czh*g4Q@-uOz^MsUfp6~;}ha!h|P(RJm3I?1UQ6Z
z10WanS|+8)0QU;pLV1U-hCl=HU}bLYj*J9=06-pRI@q`2*3kAS0^gSWx8x825Eb`9
z--jRoAS>>GXBzS2AKQ$BWX3+>ABJ1F(U1Kv>%sy85U%jK997Xc<M1tvm;eY4j15;<
zsEah$fB*o1?C<~(9fGqX8gYlo^S+0IV4(S613;~mBF3k+1OYlQAmEwi2YEcfbA@W}
zFS_hy=DYkyiTPu}0#ERqB4PBO@JOa_q$V?9Y8vt01d5rs1>ghy)h74;<QNTG+xxUN
zz(T4pJtsfM{9ymW745VC2F3NDyw>?Ih9<1z@Bd7(YjH2+;l$P-Hogk^n0c)W&VUC$
zEvR2k(4^t0#C)}^v*5lE(Nis686-@R9j|d?61AvK+YV0<J^>lmLEqHe*OKL|u7KZ`
zJ&9i*!-+H_E1);!fLuNip5Qm?{7hYGpL^7Cwp!x6CdB-y5IjA52%gcev&-`s-|B^%
zmLz^WgFE}!hc0KJW8=AE37(V(<Lg43tgkSjSy{)%CD`DQ`x-<`G2iv!+5rbc#qAv3
zQDto8L?HhEUXkRXArn!?g;p))OX$A1D)51KTf)|3KSEvS@hqGZ>q>O)3=C3nbxl`1
zJ~NZ<+@4;=b?g+GxPHaxIXryWpZJ2$Wxw8LS#J|u*zv>hCe4GMK4|!uF2wko<i|4j
zj7V&d0I(RN-b0eruuTE=oBjA9emX*P0muLDfCbofn!zAjwy>o<6|p=ajlVzy>Yz6S
za%4{=2mlBQdzvc_!QT^7aD=&A_DqZVV{$I><KKS@Y?jOhvw$-IgZ|qJT~HD*oqEkJ
zvH*~Gu>8sdj!*>y7>r;ND6-0ohFRtWN$HRVgSp4%4Uk<04Hz737bVRgJ5FeTGzd$d
ztjr}rLj{cylnM%v;U;Xse~}Og26G>q|6IIei24#E#C|Wq9`T|=&=$5cSA=*BYs47H
z#wZbY06QjXbh_@p{6u#m8JH8Peeb^g{G62qmh+p@K6i;Guj-%PdMCJ$g>jbvyEJ+8
zF`dc~(>?3$J<JrlFlQ@*k1l1xOD~6@T$e-nSy*`pLQa7H74D&+*btp`AHJ$Qx}ycy
zih3PvBg9`g!TdzCR}0PAZ*vBDOzI~UP!s&RKehP#<NRigyOv|1*etj5$js;HXoZ6J
zSKWW)um^u~%UI;`JY<AM+rrc`|Ksq>zkt!NDQoi$+`~Jw;c}1HWtG|Bs<`y883nqB
z6%U%gjOEk)yxz^@e}qlX?#}@!%hcl&eguig`qMMT`ublT7^|DZy&hhXWov{gha)yP
z=q(_vW8nzNRlXVFGE5`sXT<(D69yQc6DB9+@f9NYh)w69ulMj><&iUAAJnuqm~nv@
zAQHD}!``oR!aNAS8hdrk*nudm+lQ{}Ga_X5fq8RD%>UwJI1Z`H1@oP?EeI3n{Wzw3
zYTx28i_o8s+9dS{Rz&}B&$t@@<mIDYKeRXPxl@|_y8#XhgOipTlRHqE-zGpPsh}a(
z+xSDQAVcen``pK@LVf}sd?7a}BLeNr>D@uX7l_BP#VS|_JFWtDzTYPjGxKg0{)sPs
z+hMn1d5w}KoPz9ecjv^6g`an8xFCCJ74~!nT{d;g{Q<StThOD0cQKil+8bQPd4(Uo
z-M198S9fm`C+5omi2ZZTy*S5j&4INN%7VTj)6OD32##_l#EwxL&4XM@ZeLvCz#Emz
zCHLbzYMOO2hq;QX1md=hy>h=IHg6Z*+h1IN?vFX-@&a9_LAq}~5Yk)Yg9_*fL@$rw
zlq-gn)vgrtib5iD-c>FBKGn-d+hK{Fu;05r5>$KB((45c<?H>~AMQS%;w{a2y_x4T
zU}Y&|JDTFYG9|?oS)L?J+)Xd=pf_pP#PNmY<^Lp!X5-o7JVt+U0zO#lLrq14tWSxP
z6Bot!Ot0X`rsQY(*AaS<22r`%xUX^2%APFc0ha$0_S;4r<9%~;`sBkkl)mCZ5#+5i
zz$P;{FB{kbjw{-mdX`pnV*60^hSJ_%xW9mFio>Ncl%`SEek4rhwx1g-r^g$e-!yMC
zFX|=In6~r6K0varH0$6TpA4s$n!NQPK6}~YH5@@>X1X=%;${uOsr%Z6AmdH|>+>e+
z%h;h+s4>*ffr9=ZK_bG$`rub7nPMa3IbUa2e2hwELt<_lS`V&!LITdVb-E3ZMBMH5
z`7~>+{t$(97M4bAf4m_o7ukb7U`wNgG!&^aTe$)DR4T3{e^?#r*H^y{MXCa|g7V&C
zO-P36Wf?Q!NRg(q(ezkWW-bW_XN2aB^oRcYxe0yd{V6Y-RccqG_2~_PE`le?kXZD&
zS)52h&jPos)32Tc0hi3Jc0-Sd4p@mO7)Y_1bMH;x@B4`H7d@_j402qz`?S}H!6ql>
zv|IeLnrDr~f~#X~CUuKU#c-Z;N8Nyp%XVNk8LZ#!uZ!D>Zf8Ag%y{8P#xL=9XQ8Os
zXNB?mb-7rDW`4^PCzkOZA_%@IQs20X*wjV*vY5#dH^;*a+&0Ym`4na^W&^DnQuUpQ
z`=vSe@e%Nh&TD;5f0exX;Q6&51%C_Z+R4FRggdyYX15a58`_wU0{wDpHo%_RS&xsc
zyW-jP%r)s`D0HSq*B@PTbf!~5uvicA8c*r@#t%0`jvFe}Yu9U)h=e#H93pc+T=e?D
zL{4Yxp3~ZRh`FDxdu}FZNAa7DN~7Le1BnMneErk-$R%dZwkTFs1i!WCU$j0PaU<W_
z@?)_p-u`|P=$Co@<CF0aILF&*xJT&H649MAj{(${i1S|`lgRHcqz9ZtA$43GcFGYw
zANekS-QB=~5&7t{o;w3=CSZzEwwFJpT1QW=E5naiIv$g6h=e+2<Tl6}qxjTuy)wZU
zdoM4WVCXzg<0Z!f6VIqDHf8$ePw9HAoQ<YFNQpeZ5uXUTKMcfpj1}`=aU8hfW?k_<
zB(ukN5p|vw6BQcC|4!U6i!a9aeghtatO8wcM`sUnaeR0x%-%IL_pHPzWCV3CkY@sa
z##koHl*Sya?v<X{*gzu6pW<d_&h(InGPlhG%_eXkcXC}>9$n-QF|QBHle7RuJ1MLG
zYk*;RE91sO@CW(*fPf%2RMl@@Y>#0V)Rk+HaW|yNYO5%K{}Lp8OzQ$2cZh;`HubZw
zyC4_7z|UVh3aKLEKdx(lb}zBB#Fj5zfZ5J?7j67VsLHpSG~sr89+e8d98WK$xLzhc
z604F4rFI4PoP(cUT)(!whQODFl5jv~1i38|=AIoH<+n1Mc;RM<@fzVC1;360GS_Lc
z2v;v@iI*h*-@gqf_=#Z5xO7Z~wt4|?Njc&nY)^@}j}e0`O=1Zo0p1nxhdd~c3M_nN
z{GJ56pHGR5-jL$;0W)*8X~sr-4p;LY-8nqJC$GRJJV(TZ;7iO&a9vDf@a|xRx<o~+
z+qOdOp2dUqKjK99-y-J0LbhnX5<X^(EhDNn@0%hF_h)wXTnDFTn9S*itIguA0qNQ1
z_cFF|CHxDj<4(`wY9ddNzGw6MgD)2|STWSV^Dn+L2yt{k>~$rbTSr}v1~<F>$ZwwS
z{6>hf_Avs=w6m{)mLd@CkjuAob{h1C*Vcpg_*bSlGV3cmsF<pR^Qmi+`thX9PS&$Q
zIkSWT8A<_PW#7|?6Sr7<*g5v!c;2}9m0B0r)Hg6Q?B%F+qu*!AFPI%{?3=Cwt%7~e
zc6bebw0rFEStsC`oqRrSHM^Pbv*ph(jGHotZR9p^<Q1wv681rMYZ~?HBMw^Dc0&?n
z_)c#(@o}+MRIq`u6<{*ATVMQmbH(yc5_@Nb5#m1|%5B?&YURsBy8w4;>uuNJW8y@N
z<Sg0Cp9Ob5v`f4S`SpX<vi67w0sq%`@uE}ZW+`D+%;F8#c!_NOVVq2n9wP=ggI&i<
zkQjE=y{_@t#IC<BVUfE!pSvFyH0pU|m(2u^C;5iYiEW6yv;EXZ=FRE&$)A64<1QDZ
za-FlQh?3!bJx$Mlkj`*~WG_|`?tgZ9eo~=*pO2N!oxC@0&>ePqH$Ai9Yj%J=pLI5Q
z87CDbLHQ6~iN_#>P-wuHeXz2)Lep#Bu@Ho#3=?LiKts!;H@;Tc%bx*+<=sv4nSp)a
z67<z=>_)i!G}Mp<J|I@*v^7AG8Y^~J6Kb{bB0^gM5L}t~>-WL5f8rreFeUfCyde*w
zWsJ+Gdd#^CnhuYeo}~O=6U2JowZJm=d*MtSl)xr+(e~Yu?_WTdBvVMxYiaf7aQMxR
z0zY)UZH;ivy4nAbbAVxFbIVW>>Y~IJj1GBf0zG0O3)Sn8eqyT*0zvCR{Qp>UfGttU
zjym#U+e~D-aj#xqxUFlC%u)lbfHmv0-)1)Y;5zK?DeZQj36$q;C|tAg+(*6nbdWcP
z^v}d^5=?s^i5W(SOc>5%qK)&T#9*&mUcU@Z!;0i)na7bqur?_+jwB(s02PAE@Gm2w
zfv>W3*JTo+HMpP0c{KWE47|8pXH1+|E;t=~P!6@bv3l*2V~K^aGDLWZZ;sss+}v|E
z=M(X`2p-Yf{ZL<8`zY_ee~l}R+51(jlM0O<{Oq`L1`4*F^HJh_<w^WVLMN5Z!0j#(
z4!yZr%a?pI?(qC2Ro9#6H!XrDubSe1Ns@ztSN#9iPWGklzkw&Aso#RAap7B*4DWqp
z3C$aXw=*~WO@6>*XMoq`qu*zkyhy$HuzBc9!HO9;kMRNr#D4zRbE*|rqZe7gYwnR=
z{B;k={vahcgix(O_CyFj|3Ase?w<IV$P0RHd#PXTSwaYL=iR+{$k%EAimRp$Zl3L<
zPCGpRkj7ib;;+a0m$1p3V8b?N$I36n-wFz)V=pF-xQ`M46CVIM`DzU9O6+ZNBgw0J
z`@XB-OCaw+Ww;mcpH&{4#<cL1%+u$$Bu4QB;uUDF&ps2J?qzJG>bpKHhD5>UkMnVP
ziv%oP&!r@OOoQgu0dW#>9GF5;(h^X(nIa{Mqux6c;%|zbnf(8P?n(%6s50N;V8f=0
z*aRo<5ASw8nkATHaX&Tzyp^-jo*;Y+irO^m?jGRCifC4Tt=qx{l^=6oQSbig#WVRk
zfyWYOG~{ODB-x;6v+?+ItdO4kCe^FFq`uYNhr0CA_f@gGJx9E|U~J5>5i#V)qi*#R
zAB;wK!if1KJVo(T)+2ElB0m?;4Y`<pK%4$MbN}%_5gRfmn*v|@4c{cnZ?3W>E85cW
zGn>0!HJ>*XV{SHrr7_+lk?V@gEvBL|*qA2fkJEpO<$+g0esJ<aCtbz?|L>ZBafHrT
zLius=GRL#};~+MVoq%F7mbLWmAFi}*_4*61%;AAPKT#J-tBCwvaicv<tVbmk_?Vnv
z+ean>CQtm+Ux^cO9}^@*f1knanjFEq;x3$Gn~3on#Q2{R;$m?%5srxc%|*c`CM$@5
zao3km>7s8x7qpepo^SZ*I~Ni^30U*!ypoKar!1=h#m1}-w|Ku-m|smJ4Izao7YGl$
zjz^P<q+%6@2e~tldLQfnzua`!Zt#R^V`Ls0^`Vx=aJwK=<%p9A_le@A_Q!E|@g67f
z`60a%$d+XU#Q2#aBJ??UGgEUMM&dk1{bC}bFl)qQ%}1I)yEBjGiN-C-$>%g}%lL^S
zxf(NYx#L>=Mb~NZ(Gz%W?=AVwc`@Y9GU9wpksc!?M);{P)U3?R$Pu_lNaPb+5U|+G
z@=%}J?_%@ioKKmhnl_Zs1zPR6AA)`maY5!L)F9!7Q`dWJiOHC}Pst-PGb}~Ktl0RU
z5gmj077l@-<Hpa0aX&OwHTeGyCmvIgt62)1g8a%biE$Y*H;M5uRn5k(_>U2WIVYc7
zPopA!V_9!9CdGbt#(0#2hL$zSObEVOaQd3O+Vhs&eOhDXwF7G<jpBSvkrH)j#7$Y_
zc#`O5@M{y|Yl`iS+_F9+Tz`Q}?q`8zcjFr7z?l8JzfhiOX@W0nJhrYB#rZde3DD$-
z@fa|O+(s4V?SgYl*54+5YPHSaW36iBw)k(j7|G<fUva#R#!J}DOiziMlNiUuT?_K)
z$3r)Jv#ui=)59%45iTRmpTar`8EBGRnc_3^WM*fsJ`k#s^ZC^z?_)DT%x2pgW*cKm
zh|S+Ev<y9RX8HLeT0R)%&lBI{DUXfBih{~aADbp6eHMiTO|!Gb-OjVI-EvOo;teO5
z@jfJ&qZG}*#7Lc<7Gb05I$2MyxO8zipA#<`#)oQ=<A>XDdSq_!azc7Wza4l;*3Eo(
z8rPD`qw!K(`gqPlS@53dkXB$nu4#@VHzpO+_=pO$?#+d_Ep`wZboH14It?YPNwYIE
zE0d1-xroaVsE-kYZ^Xp%<xhB9f}6QUj*HFo<J9hg<1JzSzv4a;^U<cUSf3LoC0$R%
z)EhdI$W_rhWK9e0_=|(~1}JzaqKL*sWr);G)OQy#;;_QfCIpJ<1Gj0P#QdJwOp4PV
z9}$ACZEND~<;^D_%iZ24KNInMkjBFtMhy`EEqt48*SL&ECP<925@p7pKNHoAdhP_b
zb!WU}M~KT2gPtNbT>|a10{Jvttw4#eo+MRNmAtk|66*(5`G||N&E3RDKmEblIbbwo
zNBnWW#a}xm^mvR<iIO8P5!;^Xd+|JG67Y0@k-a<>>4Dy)i0I}98(4>+3pZl=aT|c^
zXY!lfpAuLa+b(dQjW>y~+kgaS`>yN%9M|>V{7jJ;HsZOwBBFdROd;zLT?!sw7w6Xs
z#7PvCwgMO8Gw`28`6KfAWPD7q7~DxDU!S8F3@lG}cZ%W$egixXyF3V$N9dSGN7Mib
zY<qy~vQo13J!X}{Q7c}tHHnfV2E3V^FURDDczGfDdY%X3FQRzv_>4?3iSaT-U?bom
z8qMAR|Np;oXFywS5C8xG0008M;;7Q+udbdutcWhmWI8U5^jh1(*)FIv9=}Fja;ltu
zpV>I8Rex_hxz*oRJTLqzDmN37%9-DbafIFlMP0V>zOLZqM`c&`<<K$)eIdu202>{>
z)MHi^U&kD;<DD7xWmWjz7Vz%;TlDwUKzr)HJbswptsPNI)34(LNXvy6^S3+bw%&Kq
zMFEwyRcL2d;{S~Shu1K^k9}V7!yE9n`lz<7D9b<9SLIbfKxaq7-01jWPzCf~@%j8Q
z4C=Owtq;IwfCb_9!!N(n|6lmLE%$~vS`<~6!um3*`)~T&o%LQ8)m9;Gv}JwaXkq{s
z-V|Z>wu|q-D{l${j3~B?YQ!+U{4e}pMYx4l-+n>Ab8~*i*Cor}?eB7Hz?p6qFaQ7m
z00145ZItJ@?e!;Rit;6^w5n9!W%AddB=<wi8PSCLjx0G<N-IatKJ4wb-ZTaFvM;BQ
zq8Qf4Zy^QTz%ang_L;$c2AP}Vb8SG=FcKg-1akszbyZdsTb1E|8iI>?VSW6wzKcSj
zs*I=)fCe~a^}UiSsY>Z<uy!Z3FTSkk%J2ZoJnE|aDEb9h(QQFT+%LyFz$l<9#~{1_
zDzqrWAC36t02x({S=1NfZZ%;*TWANw05kdDMfcx8TaEd19v44?Iy?`z;dD9b_)&ei
z<5dBEH{*?=ZTZ!fRRsVP1>v4{&>7!t_JvhdZ5Gvixn3Cs7Ty6xL6%?@1y|c`;ZR|i
zVL)4L02l^T0B`^RRINdpfT$tKT|m3V_kG?Yh50pZ`8uz@tK_#>962ug#6)s=Xa`7)
z6h!JH;%XvnXFFbmEb$maitrJ+X%6ig#STx!3GrM#z>9gA#ShW;{O4(vvk?h(^*gZX
zJ$kMz@qDJTurr%ZB9+8vh~E)a)o{NgXyaZ#LGc)KkB0v%oY*7J8J-$%3KgHr<mt2W
zVcKQi#M;HISsF1GaTrsV!aN@0`LGEb<s&&(g^6d&{kYhSL`DkYF;N0$;^@Uz(am^`
zoo^6qTWm$15SN;Xjgl`f4UO6Rw#H;iqA`3|HJaJFo+CaaAp>S4!1|?U9vv=q_F=&j
zf6vFpOfJYFPnWx{N`Q60F0VcRaO0QJ|LLdR{Gv(>ok&3(NWV9^Si`X&mv&~LBIEG(
zd$NR6=Efsx1~ZEJAH|{6SuGpl=;Ug9<-Pv-XwpWj43afL^EnxOR<kiP6ufso!PHBm
zm;6i;w=GsA9FY0h3$q{Y7b!6S>Hp^Z2=ZYfogDEJUVuMuukIYi)F2n}xcLdhMR@O;
ze7_|94>l$X`5+NJdjE2U8_xOhFlT9%vf`GZukd>|vLn)69euFw0DQ29`Kkc>`b!i`
z8l}|o?`7}AWDqI9Ep;od;y1-clMnl{eMEdsadiOpI>fzD7RMPhg6i@+9Y^joHQu6e
zC7GBzGUviBwZ2Sgcykj3u|6Urp2|t}aULTlCzk#B?-7%e%TF26fkum)sg(LCRODT3
z0farVUo-Z+_E9TG^Hm=gi?x9c<7B0TJR`hM+z9jQ_|G5u=JW9p5@;|58$Y@{u1^(M
zjq>phI*7Yc>ieD>CleLiv{q;4^30rG?EsK&W`6#;Bt{Rh5`HJb8;BA4F$Up!XIz=e
zBYRBI3TKHCCw=zz&C4P~^D{*Fzc1b2C5<|mW*_{p<2u-4%>1%J_sIt8R><xmJ_k=~
zzAXL)ZgC*p%{oPGGl&;aPfz8M;vp(?F}639sDT8)64IFKh0Q+h>_lgpeO;cTcRYmI
z!U7`d+&$nd_AktY*6n^KY%f2wganG$Z{k8yO7JOlnsxqJ26!t(<iyfs=F)$U@vrJ-
zaD%CsaD{Jih>NsfjRXZZz-*ctOdH}0tUF9ECN#gzwr?4^vp?Y<5=)t}woX49UX5Dl
zVWnjr<CY*r;zvLjjs78T&FqB`v&okg?*ZrR2lvzR8u66Y8PV<}To37{FttHHd(U(t
zxTrT97mS*L2%enLGHZkeXM*#@-3XH($;;;NipC6R<zIyV{<ZqzH8|$p#(A^91P^9i
zK06VRkaGgtyXdtQjNB7B?~}RZ<ip2Vufmn)HZo~pq#$HZ!RmU%3xN}nsyA3U+_r-|
ze{`lX;!FGg#%5wYNBy8y?!>lCq@p1i7d7q(IVZ*)HkrM~On~Y8gMe4&i!k8&j^t7U
zd`OK|JC~ux^K)^!Grtfd-7&2(0)9UZoINLI9%_|SoRJ@dyOx9`y5xZo?A&Lzb_M@2
z$6t)?m(t3?iI2;Ex8V|n?hhVo*foE!rcPg<+`N$~AuaypyogE39JsDe@g5dP)%a>>
z%!l0a-^O@ztkWXI=8R9o9F9cJzUGL#WP<OO8D*;L5fjV8HYexuZi629$Z5&DhMb#W
zn=^yv&t?*<6Hym)kV%*{#Kz(YT`J_pm%bt%j;=kI#^OmT^^zb@#qgV`HRRaL@olF8
zn*w4+Re^(@1{3kj<(7CN9svHaT1ubw$KQ$W>J(?x8@ZRRc@@TZX_nCm>J_?Xs5*?1
zODQES_=vt?jm<cSdo=6Qnj_*#s;`cMJkd@jkG2^o0An!QrT%#f=cmsA#6Ua0I>e5I
zDo6!hB8xt7+a$|lqrKD|H~Rxzn9~0V-z}3Z{JdpRGR`9fSel3vAIXPoKf-!dvY8_z
z#71}!vNfE5Na{0oI$9*p$8F1M8Dt4G#S>XXqtD$h5eQicqgy)VycBC^T*tDQC#}WI
zCcpgO;T|$DGN~AOj%AF1lSH~XDd|yRuvZM(c!-FXe5a(crKiw&Dto))MALg+dp2Px
zM)+~CBuf=prVHUYAn=DWAc$$HR2w{89hVdXTUPwq<nLoG+6lE&&$nElgm|7HAXxfm
z3JCc>IGBix5kCK}bVN9q%2O|KigLm>vwcGAC~RP75v(IWFE`>c#Ap8>);<cf1A<1!
zT<dVaBnB`iKtkB#3eD+1n-Lw*FeI2CZ<F=NRf;>`61V9;&jsQ{_?e<)&we8&BwsWH
z?=`FC;q}IAiH2l%O(VNkr}qOp<g(p&>xKEe1*x+F@e=Vb{r2#0ggM~h6K59bth>v1
ziIb0xT<ga3+n)3YQ7GEL{?8od3Hn?>n&P#GWW++cAMStR92=6wetj$AxM`Nxc=XpN
zGy}G~F%$5Yb%PHp$Va{Sj1XdBY$H5CpSWdlzr^O`#-}+kGGcs3#LCH7ZVgJpzrJkV
zV?Ge+7ausYz?eP%@i~&Wb)gJW$%(E^MjjwblgDoU5!nF0(D!7A$5vLXq<QeL<WHOM
zo&?L)u#ju1{9JX|Z8i9$b#Zv>MkeJ}l(>=l)Bz`Bkps8RpM9qbf@jBFzlj;v0Lxxh
zD3lgsB|m4sJ5`9I@EvbngVxZ>t!4Ioy!%gaCEBdz4W9GVL{4&)c8v_RhIBO)@jURN
zdL<DZfE$0*YyVL+j}3WgI}6h|+Q*XyhUnF@ahg8t;zArF_LloS9s97+TV_J+Uu4R*
zv;pk@2zUqjiNqb6Cm2HZm$h)~RBt!B!<U!3&NlgYZM!mYS(&FZHF%$whUBO6e2bGc
z!-d2NHcsr}TucyRW(r^vH+4Pmmd}$OZU0=8ZkhQo?+*C<0Y=r}KRf6b4eh`%mvmzK
z^qHBeI`eO=---9bm!9Xz$&D}fk1!Vbya_)KotTJ2yMQU*A^+-J1y3utKSKZ2V?ZpI
z+~p>nYM#%;ggh=zItN|TVWlz%uYn*=KMG?yWtqeic5K6PIf#TL&u##9;xGP`S2fVA
zT_P{%uke<`sT@gb3G9eKdySl|NUM@?7PXGK$(8;x`Dbq;_|4HBT|YUOYx?r*ilPLX
z$2wp5jwV0gD=Isaqg);eWPtXx8@`@d1-yPC(@0WrOt))$Q4ofrmUQUc0sky=8btMP
z5=qQLW}4|+vk)L>!~1?SVY3wNxIuj!Y@0NQtY!ll42<yagDCK)q8)R}`VbN8#BbNr
z#B6|n&1UiMK0d)5G_~5f%!<%0F~H9<@ezLrZsyyQaTy_=AH>DB^I$*OL^~RFfcEYd
z9tB0aGmMK9SdvZeT)gy!A~3W@6o|{oj~M<CzDNi@@7CZyS5}NL4lD9$3D*)UBOQd3
z>U_mF-w(^q#N3!xy>iVOe-&B5k;~9FWSFmHgSZY8gtd;{sv6E~*S~m5rT=a<xyF0!
z?};A-XKh<w=+~<jwd}Nj?+a*YnE+~cfeQDm5qGlk-wIpb+<YGyBQi5LBN|=oYJ$mp
zdn8-6B?<*vV#@K~L&swYQXa#hs|ka&D7SCK$L}>lFNvlF8<-jF^o$p>QVq}<QVLdU
z_RlV4MMtYVM~IAqJZ$6x%BPS0VZyeY^gIMP+Va^EwCdB~owfR3OK`skSDP#icRUEy
z>koi<)a3t<kYM~ri8lxt^niGwUab7=K!WaFk!ccf`9@zfqF~?(-pkp3wpnomPdDR5
z5@`Yf{3rVQd2{5F2Zekg$Hq+s)-BUC$#>;(UMX@j9J}S}@%Z>6_Ru?Dv|E#74R2>?
zw<50@xhIL(&UfH7t(#nZ5KHez!ULkr>a71j3J;G}f%shaODElivfVBmlV&0(@e5YD
z<S$L=6qaa#A~hZ<XEDYp;ygfs&<I4)BXf317R(Ds14><QwEZxZ;L-<ep3akonx7Ib
z1)B@aofE)zos9F*>RO1w{6=mgw~-=|*{z0!af$q9+m+;I|A%C;ccpq?6E`Luu>Utx
zZ<mH%_>uL_;{<<}dNdbd#e9pC9xyfM=A9<_kB5n`_tO(ElQXe>pTv)bx3aI9SR!fc
znFGSR2Uh6-9?rkU;ywWOCx4zMcy>pJ`Q7m!kD^`R47|HbZy5ML3iRqTCwCw%%a6)%
zKERHzFXqzY@jo9S?0nz_dZDhauMp?NO+xy<SHL}hN7u(!b$;22m+~K(bMi#M-fLGb
z4<p+)?D3zbiU}?yyWP2}UZu#>g~YTpgeRaa>w>9CPi-%Od0r>uxX1t!kXj?`bu|}f
zer({Zc%pmHiHz}7!WkJrYx0ED-2Lz5@k_bYEGp@6xR8Y6oKLx)vc~jAdK`SOILX)?
zffcBBuOQ^aLOuxThXz#7uWUaEP;_M?UfD}2gg?t}s~ZMcAO8}2V}^O{hXe2V|I6H0
zgg+l0+&G9tv_}@IC;WA(B20e~TyWSU8bkcI_w~u8_wk(Bsm;OymAkqZxwA6&^*R&L
zxc`@pujA>s!y8=HPC|pV`AJZe<gLSk4x=Q*QM&&;zAWuyVz~NMec=l;^>Lcp%I7s&
z;slckx_87)JP>i}J|Y|3Et>dpXNU>M_xP)dwaEb6?VWV20&n(f--r+qq<1)C6mXwr
z2+3v_;7v+>oAme>n2t+FzY!PZV<&@t<}O?q^D%PGxwPDoyPPkU`(9ol7|n_C59Z(E
z1P{+2HlT~s#|x?~ekT(C`=ixgP`n%Y@RdkJ!XzeQ6a#F3m?l{!&FC`Rem`NoXY0mB
zV&j3k)3t_Q##s*e*#hHxJvB<W^=0+P&8$}gK*ii)6La2bvkMat>46Umj9i`sO>+(3
z9wwa3F}aPgDz7*A_&a^r5&M?=Io*}n&S}={kVc=o1kIwmEe*FU^7)BF@ub|u6Ig(R
z10M0&dHbvz21s7GPudlja`+pNEHgNK?mG1jxc7+h;f47re3x_AW5jVjt4fB{O4hm?
zUbF>$o6Go+hSZedAiK}}qPGwChqest|N392Mei`h*l|YG?l_TO03Y!$-b3XFi>@LS
z{_#?5pNs<WngF-*hAhVZQ1E|uMiUOXZ?Oj6?BQfw58)%1Ap1YWmsdD2SvQ}ElHlS+
zR2-a>N(z&bf0?fmCT_FK?mtd}e3C;XJR!%%O<}QIW~&Xsu>@fwMi4#{#+TcG?;MK_
zy={$b{njEAvKLfWMdZ=}+v%nGw>PKPjO-w*xO7uy1N9vxZjA7W2Z3A<nS+7nnV43C
zz#MsbzL$%;$W5Eq7GsajcMJ41v!{&kg%dQgdtOeCz9K(O{I|3!ydlFwHCv|7jb_}!
zJicDP8L>AJgV=~p((r(~8g5Q}NhAJt{v@(96J}03E@5SnGvInkSVfm<{>->s;zapX
zJBmLf!pS-!a`C)ti`|rDvR>Em5t-q#4}svw4zfc}pIhJnWA|43V^Qwe<D`Y~MLal1
zhmsy9NJsG;W7M^dASJ)_^4l*TF)F4TwJ^y1R{W8x0vx=<N8+$!Q)eKifeOgEuW^VF
zUm^xa;=do2un$4id{L~|Yz}PT)><oMh`sN!Fv$Vn+1&4y*@=t%3kdw6USAXQF~o_;
z4jT%&9;M`V3TNWAj|{Z#Ne_4gdFBVNVr;8l-n=2W8@p>ce4|Za2R3sJcCd@gf8}#8
zt>1F(VhO-Tba`pteV%a;hk?R=2wV&y1udE8YU${4?d?Qw5PZPj>kIsR7)zibB@*Ds
z7;@xoy#=~3VJ$#HIS?5Fq`EtojNoe>;7flHXdDJ%ojh@iQj^oKr%Ry(#>7t55Fx+`
zKBK0-ev|3?JdC^#xjZA>)&~uD&^TmytjLA=<DXv{8U<WFlR1#;V<Z7QBrhXi9`j<q
zA5R1m>DFfd^F8qqoqQwA`RC!sFdx(G_n&AQRZkAVUuV4P@5@c>L|V_DcfH~x*{RLC
zx?fV()+BtTn?IJkg}^uLgG0<z;!7iTpO&#1F=`-4P8x1}aMN>@sw?hzh)Wr{doKYP
zp-W!A`>!+O<>PanAV^M$xw{ssXG|!|XKzF|GDHdd2{8gh#4O6ptlRNF7cS`R43hk`
zCkClA_=z*hAduXU;s#U=9JiE?ryz;F)ea<W*`qhUs$+bZ(*GG<nw;2T_;AbIVpq+Y
zoRH}0ct;A%O;|kd486jj#wX?&0|`H#CP<q;_rDNNG?gpjVF)!oV~d1rrhqPv&IZN0
zj4lIlhjjyPzAJ0o8YgFRVk7*%rc<4HJ@N8XbVeFwXocQzH^n1zu4!Ai5{Hqb?v=Zb
zFW@Hltj-(X<M4LChq6s2hR+cBfey?8Zn+wNlj;MloMyMS8yE*>LT1j-8HJH8`R#Yi
z|1;=gO8rpA&C~{eE<>naMug_MoKJ|7QMYS4?|ZNw&!@foNVxFL;rouO001B%s8g*+
zd+~Bjgo$7cyDtN-*E83Mgf8O?0~y{r(wQ5_xTAUaz0<?=m=;d+@l(S?#0Y>K@UNLZ
z3_#-Yr^hR|!XB5u&!P<_lM+AJtK9#r{nx<@0NtkNh`Us9I46Mi?LGDX!cp9yd0E>N
z07EWm{nxa7f6bgXcgzQG6YpUlu<f7$nBUO<_mKgXbyNHP@RV?6`j%F9PTJ1+k&wXE
zF(>LmV;9GF%u5QAV|bfhkBymu?hHMtJ??wv1TGyPT_3~*u@9xcf4E-Qc4fRlIE+?f
z``7$ru}mR3YJX=C3+I*CXN%T&O?1k=C$J^h+}eQpc6No{a4w*it^wVj;ScH2d&vRT
zoieWrYg=cCr!jq<wX~O<y@cI=@$UUZc$^<`T#66a-od(6tQim_*ht}gLqeHf2e7z8
zxihS})*ZNY*y8N#V>c%R{%wCB-d+m|Qdn8lQ>d)DYxt0d>yz<5@`S!A!&VA3>|fKu
zZcnq<C&;du%i<#-GC6lVoB2%H(Xn3--TNCs`PABsnJue#GM{G?!=ji@KQA|o0ld02
zozh#oJ_5fk<fqH~#z85IkNzi7_b)HtHs$g7o193I_+G$0fqS*lo8M9QXSfyh3+nqw
zIWgcJlVA4{#Q!7%CD0I##U0FnytOXg5Zx~~#czSK;v8V(|9|l#xK`|gKHIsU{mZq9
zC&;7hX!wXin6Tney!={z%8MB}36cMUfa~trt)}RIgUf$!;VU3Dv+9?JAhLLfm>>O{
zl<+2QA3tgcxhyzFi+a6c<NP2V*LU6D_((JP%m4wfQImO)0UK|WfBTcjp?|~vmL?JD
z4bZ{#2)mIY8D;U&qC#n)Blo&&GkSWz2umVm{8Q++qI?X=iGdbxhsHo;8kSG}0hn$d
zo!`yzTO;%t<jS%31WUgxv0F#tDlqKeM!9SnWPkK=Aqat)t+v9Qr)ocnt~9fell%jD
zC~ndH*-U+UNSQCh1OcGqvYn-O7(P4l_8kf!d71W$PtofirP}knNJp^1#+f;wXeop#
zjPV<YxmYKuc&Nr4*Rxw0{tkPV(b1YBZl})|+_cL=(-XW%s5i!gkqchlwF4yAm%RQi
z2NRvRh<+#FU=)XBA9=^4doBgv=ld`y0Ynu1bi&gm(ycFm@9A~ZK<UFS1pp|7Jl3`|
zW@Kwy8eeqAjw@JO02ey{NW^;j@QeK}?92UqUk&kB-UR?Cggr6uNC%H#?TaT_iNK%*
z9t;7Gh$b)MBC!`U{8HxZ@VjD^Adk8%L?PsF6|)IfZ2V0hXb5(ER(bmD{NHZPa#k1`
zKV-eAKg2>9isM~A3A}OT2>rdhV0!i<?ysdh7K{k@cwKpRyA~uNSPn4-7Hp}nfSLe=
zX_-Hg2IKn~N{MHA@5I7BI9RRrpk1NPAxGRgTB+aSBQn0vBWXDNOf02+o?JG#X(PcX
z@0@K$LUwoJu(=|P@f_vANSxwf8ifsi(xB|1T#Q(-zM_|p^Tca}ycQ;F<D$UvBfc;s
zCXXckZcMw@A9&`U&>r>T-u6PBPB#gJvZ+JA@Q30Tpg#-5Gw<H7dtL`-?VWsz$au98
zC(|`g;~+p2nlSqNJ1cCo0qh*}x3{CfaB+))&&O`p0Db{xgURDU(~JoFI~gSM$Z=hU
z5RWe5o!RB*x`~^^(vI<SlL;4y(UeonlSl7gvOQ~$jbk0nR&0UL;ft&gh%ba-vhhCn
zSpo5pAMUSuicnByjlmq35Lzs=#Drp^B(z(^LKr#XB(xcB%kl*`|I<%RI8i|kL{>Cs
z-d&%6{sfRh6o;cw6HMTU0*3DZXf6nVKX}*>$^}0YM8hZ?{7TpWIYnTvWR4qyn;n9p
zIm-t8hWc5XQ&<-C`srj&5CkJW9UL^iHLZ*V6If5pbcBqSINkB`Py7@_eeCTl`D3bp
z3INJoNc@Eq0Dvu=c$nSxhEb3%mLwZ`U5~R-;o~(=e?EWyBqAfo7y+bO?-~z^OC*5y
z+S9me3}z?h2q6du(AR4V(QE}`>oBHz?cnv80R(zuJ$vtu-z)<q{L_8%{{;YqBbS#G
z_+l)Knce1j$`1n5zXE95pTub!jg1Y~m=XY@NNM4&9!(JRDTJ(EpHoc~)pfMct<tW&
zB)V9LMq~X-K~4Co^fKJTEzjAXh>XI~j)V->2i}jhl7l^U`Fc600L#%Lc-Ix=81{gL
zkVx>a&G=Xpn$1H2@sJkL{PTAWoH?OT!<{H@hw4FZ<F<`!$l&q2w%yKTbcm?OmIQ0d
ze*cIN5P;Q2-V~}L4?Hj)I7&9>BYO>m)h!J3J^o4rG!Qq$<6Swd$9+5@=MXlHw=}r?
z2@pJfCP8Lz9tkU%P~RCtz-{ZKP!|Jl&4Z7Dvm-~m!^~8eEZ4Y^Noi>Y?_MTucBl&o
zTLyT5h7t}H`ZS5zlvio@&rxYaZnhA^N%8N__D8SD2%h_TwEzdPD?fVhhu-!AW^Q<H
z^?Tibwwu50PSkR^$aK(&u!*e!{;U)*^_3nx%v&u78?#*E<rY>sP&s89thl825{{@0
zO^qVw|Jv~ogf`FX6ZfD}t9b2){ji^B56=b?a=c{W>I>|J_3PH4^4?qcs4UF}Axqe9
zxmk=1Z?Jc@Kk*Tt!;9Yd1*{KlcC{7|f+6?^&>yE~yv*`e1OA-P*FRGwy4;p~r-U~&
z79g<xWo>=F>IjE`f3@Yu*Y3DRIBdOOP53=KCz5_gY9H(GRc4vuBOxo}Y7Gt}fxf8S
zCuHyfyO;;EsY7czf*ouO`LPoEV=byl&7sZwAtN%eY)=Z-h<y^X^Ke$>t?@UJn5EN&
zIke5%qlpnVGbEpk>Dg>GiJKBG(9<EEEqAx)5rpuL9Z&)oHRN)>|H43f1BA{fv(<F}
zfg}nd_z8{hU|IRTC-QIz_rPoE4c}5X@Cd&GOpp+@Fh8z<r9`hh&-s7h5P^6Edh{Q$
zn!cY{AqW$UtH1z!Bgfjl;#f-#4!^{B5_}3F9t;5hN8sLK^o~}0?|?NkaU1ylLLBy-
z1OKU`N7RhX-?k(Wh=alHB<)J?t`&P*aE}Pe^}D|Khg(eg6yP2N04RiTJKBdmsf;yb
zn=yJVQgW9Y(m#;ufn|Vn2#wtY)U*F!?{5cwD$l|-Ls0MrM}-bo<aq&C<U|x5g%!n=
zu%MpCVSed=ucG%7(~cNwU&KaU!q2S0aH|7aPVB>3;<gqhNjiVI+&%M*97G}FCX(^9
z*FD&nyTB{efqJ=vd$MzxGuinliFzPAb0c4G?)$`BMqUS*uUu^mzvf@9INJY=hG1$P
zO7GUnFo~UL{Q=P(oCsdQx9<U${ifS_CugyhRSKPi4G&aW+!K0D<2=dNUH}9G`qKW_
z<p2S}fcuxm(-&p~xakdV_s@hq4g>n-{jZ!MLIPhpVZUqe<Cq&xO=n*|NsY1w%HvBQ
zGc>UxLYa*>P#YG#Kt;0>4W|H>#A{p+2c_Vi;(i|c;SC4tcGDXS?aOZwku;4aqE2hm
z!V3I-a%IMibOdssu!YD8ZE2w0^{n2uvxtOd%sZw{fAAF*U!ow|_dmm_tV*QKBr5F9
zrwgMCHqvin!Kq?CAdv|!1N>CZ*QMa3xDQI=LLRYj7S`AOtc%zSWwigb@Bje(NXmm>
z*mMUSJ!jiL@0l_8%oUxU^Ht~Im>$O7d`QW!DW|X@Yu`RJ5O4kkwn!jt<4LNqC$h4P
zLUJtEo)Cb*PIkrH-ex|u9B#!O-yH)1wdJ5X?Ef&AIK%tw>}_nC1FpjeO&r7f>|8}p
z>H|}jk^86*Yc2A_7kG&JLbm~dH|WcQo_o@CAk!b1u&wieH~q)wNZh)PQ;G2-@Tq8@
zj=gD_vx-+T?%)eb<MCa!+VGTjF0AqRH!3zO@sJ_i;f?9Ejk`P*_Rh)8lx^9XUt|Rv
zm=NqwmTQ58K9~{hh?n6jTkQA8;igz@x-BwS7!Hk(?gY~ADRTGuodg@@zu)oN>yzx(
zZ&T8E?fp9V%;cAY1BN$GKo5BI_o+@7M?5OY=`>lB6Y|T%U+ngGgz$_x5x#FXc$iBF
zg!g|0+kfsIz#bu5QUNZ`H^Y1m^f0?$UN^w+Lsg_-_)Pyr28|!^$Y6D4e52kiz6n^U
z4E6j6NXQU@C(Ix}*Jt8G0X;pA)49q~@P7y%UIX)u5v8Sr3-KWV+!8Z4>O#(l5EQqL
zKimKJf)5O5SBPF16T$(2LjZzk;t%_}u3y~Y2uc7LHl34cqy<Hfh2uqzZQ%T2D^fE6
zU1{AI`n`d`5QR4m4%Jd%G1tP62Z2;{%c)1z;9_p|ukZItg%k&fGT+%mEAY;+AzMff
z@f=uV0UzD@3E6Aq*IM~&<yTq@?Vzo<e-blw776McG`qxE;<gZ-FDULX+be2P(ULLr
z|2tqPnZ6_;^pyt*BLih@N7n4@CA(+6r!Pz0lDMkWiG=ByI3g^QqSfdL3ArG;Zy#<w
zUW>;5CO@st_{cbPOqY#og33%lEkFDQ-N~pf*z-dFCocfsbk5Gc%T)27o3Qk&Os`-H
zaoL~$RuG$`JnxVr?L@oLPfPvPsUx*7E%%AU^@t=2lIRVJV>RwvkCIHD5%;=>FXYBy
zCRtD>y$6z=A<i?zA@<M22!NsVOps@4XV1ap(^l%?SV_XWPe=JYnM-8Qe|?^OAq(0$
z%s;-)#eI{J^wO=nQf{RlQuYB|muB}|*l&~YfS52WnYIS@dhs8RqZeod-z%IpyGyg-
zQ_W1-;K+&|T}zeQJiK3mV$g9uT*QeP)d)brPh4f!(`KrY0^F}+wZ#dv%^1x(Z=Nps
zRtyOJ4|FCEmPB=PYhN9t0pCI|BZifl!)1Y%iHPql@suyPkGyR0v9H21n-1=LYxkgy
zX17wGj;3Odq`HQ`<jUm6J@}Yk68Rww@_D}qx&8hSh{zql9tkZv0WQur!+fh)gI>Ag
zd>Zw^IP@F;l(cC7!~~(dR2JJMQ_cB}9H)Tg41h2FFh9}1gdraYxFK8v-b@lO2ee>>
z|B4d45CjKH0l5LFP;cNr7bw%K{ecM|hu-lq+#{sC5vL<C2}g5J&G9dwJ-KoJ0U!_?
z1??xvVBg=8R0IJ@;y}#O2VbZKHvqcd6+qBi;6K3L9M&sebN^@0uh;?73CU?8LR<*@
z^ZW#8t$&A9051k4DK_{L%+OQ!&K(6)i9;|RdT?L~tmKlC3q8n}kC4v#z(xspbzN~d
zGEoS}ztgyU#YC_RNp=5(p%C^~`Wf@Q`<?iRG#Fl}9cPc~k-%gItZ|<4?p#~wF)~D?
z{^x}n&x^#0k?sPFVDs2&fyv2&UwX-Z4xzH*ArCpMov=Gyyd*(r4@1T+-L+fP5!vU9
z_(=Y;2lX&c{|IBUk>vtvt1;z5Cv={*@tdH)bfZ4(25i?q+Ur0AMcGSS@N>!aiY%M(
zX);0=Ozrjkj+d9L90Q{?b6CEb<B5cMe*`N_&O&c>2#RuRz)L-Pw(LZ7N5Ae;4Gwbt
zBR@_AR~M*&hve<=+sE#tlcaB74~UZK+K=uV(|v9kop<M)L{H}NDI7)-;_~FwDJ-wN
zK6jfUd`u^auI6KxmQ-01iio?K4df1B3m8_Ez<XYCz8m0op^3+!-dY~aQJ_BmC^TfB
z{6H+g1iH7<ARGSpB!<g9eRgAe;~-=^fq)f-t^>W^Gy8CT4q$MEM{n~VQulRz;rL<$
z&LP9FLVpTQY~H4V4PprZRh?)I_5O<z5d>cV4bVR}5N+U(_vk5cqYAq#oxo5=+Z8GY
z)!vRF<!BBk;(p76Yn;UxF#opj{0wWH0abs1wx5yg1k3oO@bTdAS^PWL{u^)u!cjl3
zN{+<u{_sT!Ykn#*tYisO$VRs>aucVP*AqUdFeQMC(HVm`!@RC+!<!3SP=3TSB#r(y
zBk>T$^^lg=k{A`>PI0Ga*>lb!GBhzdGXtG--uuosf1!kFyq9iq$$Fyg@hR3G_{jBl
zxA<}&kBi&}|EB+TUuKTYK)e-X_1I)tS*PosX}9B8aX}`J*F9kuYJ<FKRS(BsGrGne
zBxiFK1G9nfg9_dJfYE;8j#2|j^Z;QyKt#C5QlUSb4x%FA){KB<Ko)0bdY1*{2ju)n
zk@!khQ2Nqtz|XV3>tG$25jEI<eU)$q&j@#5XW591fZ5&WWYfF>+2JbhJ0_jt?rN)9
zPG|$h%mFhx)6bjwXS2ZSP;>JWeWS>{zHTNXP=;8HxR~gSClQ_y+z2;St_2)Nd~JLV
zFhd5Sr;a7pz7UiXF|R>{{t=^pAAlLFeP-iAAV9c45OBa_hzLmti8L^Y4-cfq5Qn}M
zb?C(6J-5OLPDU=c|Lf$=1AtfL25>#*7NTMK_v6t(8#YaLB|q&R9KQgs{_M?v{{=1)
z7xRCB=!Jc5K(Cp)0dOLC5-I~g33Hy|a=<fhiFf~W<2Uma0)#gO8%Mwu!wPx+2MnA=
zN-1SBmiq_3yU3)ay5zE<BWsg4i2Q7X*u9_2fZn2;ng4%*GwORTGQ?5DgZnMJ`96{d
z0KtD03_!yXEJx<zFM!s$=+s7779rdgz8P0)l}&sXOSQ>~S}_+BfBZKCU8lKy7I3EL
zg*P!!C_}iuFBcb%(xgCG{xx&J@q+kA5+!^T@PLy-MkkFxAUnex6aoox1G11xlPLtI
zWe5X%k_<y2o4~H${l_N64Kqw<41`}EA^^o!^f~%&BZNXBtSug_{1DUcj6ZhT!%x5A
z32i`I=yT2`Vt8}F*`&c}@FX5t@8TlhNDM{5pd%2mSV9auN&XRz@$08MPV0RGfT)zm
ztim9`zA~6WyZ|BV{;$9PfEgc!o&QmPhPbdo5Eq1B79fE=5_*BbOtRmI2m*+a(|&fw
zzmAs|1On%TJRolZZR7vdf{<_uH?gT;IFdPF9UFxT{QWz^0Refx$M6HWF}pBrtN4J9
z-FO5`PF44?Ee($RygB%RsUL_EZV0NUyhOePa@5R7U@e1}q{u(y$a|1VDFgh_njaID
zc+z4Ie3=h&VRGgS3^=KT0tN637vz>t#K52;E(HL@TnYgSKNW-^yhkhwJ_Q&@m2v+7
zV^&xot2^51#Ct#IKl}<Xhfd300DkLpaoaz64+0_m<X}qQVgLFW{{je{4F5o0vmL1}
zyZ8>7w9W(q!5o-&WEOd>NS^{%;5Xs4za%$6>z2_;QS2cI@Dd9tzXbTm?sNjrP5!_~
zzSrGz{9AkT|A`Pgn&t2VZ<cABe?NdNrKY^bBtV>pV0Dbihwd5+C}1@45jZ078Rc9)
z5bZPm5RUja`zvgP`Ir(spRWM5BU;8w&kVo1UrZt(6!9F4jS;mt+*Pz4U!61Xz*F>6
z7W=*@9xBry>a@r@rkMv7G{im6+4sG0wmQ5PQe?<TCnIK)ALfIyW#VxDOi|M)>6J-^
zgg8JL8Z~zTyk3!`-#gR_6JwwOq7|eD?Jy`tc<e^}0o?gy)<3t^us?cuVrJ6*1&Bkm
z5QlXv1{HRg`MSMB$q9i8fL!>~nTU0Rri&sFce+mUVkChgZw|znfg%#<At?~-5S&)9
zGwl2e5XBir2u;EhMf?M}32FIQ=gFo9$3v@510-B<YAMK{JIUk;|Nr14W%>362x7a?
z@G=A7Pfm<N)_yNqL&t?h58zmb`R}Iz9=z7Um4p}a1CY70$#Qu9h3J7sJHLk903$cu
zcVGP4*$2N|OZ!&;Czb^WVmloGBo>F5(#ydAM3UjXKX%K@_~{Xf@GM5~_{G!0R>i|W
zEC9z=(r^E0Lw0_tHY(5^YR>v~@wEceaO;PAqWfDiJPHC!{X974NE8APV18aJ0A}Ab
zJ~^+$$bz7M?GL#gKkx<(RTp~zfsTNY!y-pK2V2iqjD|BnYEr<1Q2!HmS?0OnuSP=o
z-^KG@4#(h8iLV2I|5OnBRZ;vVpoO8&C`#l!is$h1E0r354Zi2h|C#eY=|0NJu>ya9
z(%BNs94pZ?OW634KQk6M0@*o|U4IZNFeY-ZP5vKKKNZ93X1<uwHkt5%E`nbNM}d++
zga9e7xetyy&l~9{3?d*s@rmu&JL5q!1A?2toDAj^-&6kxoNS$s#COC93I75wpgkZD
zQb9?EHxtJ@(D$#RqNsp?LkCr+Rwix!3%sz=56f_Yc{{y^+y^GfGtSG%J%@>|ejX;d
zg$$3F?PNc3lKY=K*9*Wz+ekW;Gsx8Nhh_XlQx7;~qIeHGE{;3{ww%;?-g64sEU=7>
zpW{A|6kk^0aorhbZhykHn#UlD|G<boDP!%)tGVcV^x(g}u6VL+{4Hc}_eba88j@T6
zfB4)b^9~;ZqNgLt4yInR=Of+zy!zt=zqgZmP{hzM6CpjZ`rfI!OaJdb_txCXmw>XJ
zf=uFT#8U|jBw0V5{FsR`A$$kF<dWoB;Hl(qEuBa?GXbBEwW;$yXZU|b!<PTyRpIOr
zPaQG|AJzfJ?rX2@d=~Wog{3q0VV;)%8(IZZ509V;8prrQz<&BemQWA)mLCx*{|Ee;
zO(r%-`g^9L1LJ6)fj~f;c-uRF9zM32=)aT60)!LyVk5?r5KEdTgI^mKD%l*wZbFkE
zIi_$9w!sJ&Y-wg@`V8(XES?D7{G(wR!dlOa&Ghj9x)?}-2}g|y>r^E;ijXn5PM_m*
zru3SK8LuDVi6=)V=lms|0BO)33BQWv7E7W_5@PSBCI5jyK$)_ppPAJ@6{w{0K%o_Z
zH{kV#qzjug9^G!=3SelKo*3{`DrO!_*N_p;G--h@JOcMCSqSyvj%u0p&kR4)3P1Pc
z9qBh?GV}yVZv-PgHgg=qr+`F=Ar5#UF39)bezyUFgXRP{=tJm82um+!HuS>hW><W4
z+YPf~j|)R*R>GI5rKiV-g835%re>G}-MUF)skFw;LN#CO=Y@WmJQzU3my;nhJI($+
zxX92@(TMFEE5Q5!tJTsG)vt^A>f`_8xX>74c95@u6LUwdZU937gH;QG6LZh~pWs;o
zK%5*yIa44lJ+?KEMDOJNKvm>+LAvG{2!!BbO*0VntG?y>hzL1}+>a<g9w5*iv}y*H
z)b0F3z=f6`oO)nhvxqK(1bKlfUGW0oo8N>Db~Ivm@F?7j^Ie}u_+UURhWkhdJ0xyA
zk>S;wW^v$fuSsd>U0?1vKojsadSD3!qH*q!f4-U<<ME8UaDYH3z)QQ2e9T*AgaQNb
zCe9!2k4xdE0@GY+9d1W{ARr6j^)pVUVBEGbFd4TuAG7Z!)JT9$;7I(IZPPWsi11-p
z6ar9m#;Kdx!bkPMan-Up{!iB@!})r|1=l%daS;-jsDO=lE-x+CZ}l5BKzoF`IA@TL
zTk+$)>A&J{ufYGX97EXpI9fkD`7sh=c!*X6t=u2<Oy-L2>ReC)XLP7P{!9hXaa0js
zssG|X9BY~aMobM&hcVAGUm%6zBjh4%e-2Io6!$xQ{!4q~*$nZpBxMD$9((cK0tS=F
zJ#csq2T1w*qd+(Ed152t9T^zF->eo(A_Q5p>Wg<|CX#c%222=Kjj#DF8n0faz&kug
z><HJmaqhPI=Z7bQ4==<lhxmXr1n|G(X`I(rz>(4qct6<QTuax#2;Kriezlya79)g2
z2!L6gIQibkfHZ!yJj1{i&n<`$BdvVkBljJ-gXsN42U@`!_>hMX5D@_WgqhaMzre{U
zYzHICl??E8jwzjpz77J}<$%_&ela&4l&lax@<|q-@Qi<iuRgV8kab+P%<#lV2L+<b
zCQqYvIFSzxEMS~^cku!+AM#`fp6<W+<H<KHKc~FGpc^gD!-m(l=L8%OfdF;@qoQp`
zkLs~BXeuQh|B5_12{r)&?XxX}0RWw(Mu_X*pMfK&JODo0vhc{g;OFn>Sp#?o_tEeF
zyc;`!BJc}ai#_KKum1oN-(THuCBDD9@9VHJsd{qx1AqU48Rj;p{c_jm^92|Gzyxi#
zqMJX&a(FQEANa`g>;$drlXJi?&f4bw=@@L*|E#w^m=d>je(|Edz@xCtHd|2u{~gbp
z^~i6gpW}Pi0Uu;hz0&so@tRixqAza#-*2AjF?WJ9Y-<_q<NN@cHL7oa{rvQc1_B!w
z`+fgk{xWNdbZk|=K};f~$PzZ_KOV0^kGo7mCzj8l^B~3PYCqTe_ja+riT~Zd_Lq!+
z8TThozf7S71R1B_kVaomBI$pFG8VTZyy>sK8&_<~EGIsrVdqhGhIams@W?<`lN{QY
z#-n(GKt8rh&XmxPJK;b7{5m9u2zWyg@Q65Zk0|%>#X}%S@Q5&}CO^Ol<ulS|L!fEw
zfsGAX0Pg}ly!YV14I+I5f^Uv-zu)-xho7hvBCsReKg_E^!mPlLK7;Qol>fq#i>1HZ
z%jxg^d?FGee}q<;b`Jo;qQDMq)MrST?Xx{?8ujn@{9+X+PQJH*GU=lE7yMib5s(5B
z+L~Yg-7K%OQ3qR#sxdM(zc2*>s);BR-nC?S1k<OIG}B(Kf43dWdcEI!Yh3&@j&0$c
z0bl5gclY4IAD#Wcpb(plv;sfTwP*`{3{Q0nZ&)NAz=$4aE_e*8{>K&nkNq$EQ#%9w
z(<*lOynp2cdKY-q;0<W^{0b4Yv9NIq_kh|wK-4+@=*UL;kI&0cF4<CN@&Qp5vtRxe
z*1N;@f3Fd5|I~ir^dRteVDI8za3};NfkHPP579CX5797N-EXW73TtK(*I-{B{(<^>
zC^#{XQoJN^^_>I%8z=~Px<aNSJJt}rBZRMJ_%BEUFmucY^gUx2yNCa;^1c1o(FfIN
z*lN$G{x+*b{3zK@!-hJPbKxkZ(LdIPj;QF`L-mN(>0n>?&+r*&E&p-9)HG^N{=e!3
zzK~YECtC^C{x$$=&s{6~==+1)$Wl+vKo7TDl5e;3U3cF9&;E7mAOE34-L4#cQ}jR8
zKh)gg^3AyXb_f6GdVxbU3K5t@;N2(;%qvMJU=O!@l55c8ZcaV_(0a?T|Nd3FoNF~;
z|7%X0>Ar~Wn{_yLzxdr=<*wVOqQJ-lZ1t=9+zQuO3=j0SEm@bK^^c|x+f0rE{m<=z
z{eAwq|NO}BeRBcw9Q#e~zyJM@vInQgwD08bO%aOb%Z0+;28{6@BTzJn7qu4?z)IfH
zW`BtY34l8Gp~YSk@?_x&{yec%d4U6ifDi!)0<4=Q9`Kht+KK+|zt|K34!ccx#t@b3
zPaDq&2=FXaFbE{!EEBXpuo{b(=X?PJ$}G^`IDkQl$XfbP{ICFamzyApw>^|v4BI<^
z6dRLr5q)4M{-Rt1fBM29;aDqBK%q!n=I|e^e}V|##CT+{Gw>17>G(R?4kPgda5{kC
zR_H&a(L@@VLeY&3d2I>?cnw%C42K70w3y`zLZf4<Oye=HL2;>nmP|K$KQQDCZL@@8
zNjLmVkSOnp;2~A#|3CFEC7f=^OY=ZHoic7<GbnCvm%St4Q3!$zP-Vi$G*qgF%mxEL
zGrZyzr}0DZB!))Z9bM!{*`5>k8^IvPz1s!~=lVhstN3Jl_?dTh(%cC@mw~Lih*l2*
zkBI+)MjFAO6QG3DWDkIaG!mMCn~ICqUx8DH>ikGU_Q+DdQGWtXCx);X>pXzQxnz5i
zhr+v`gmDW5oVha>6X6MCthQ!;A|y^7zy|bYsBnj_9=M$TJH>v<nQ2k=T>C1e^-u6D
z!jQ|^;J`T4#z#jBuTIc*_xd2?`eVK%Ga&#_?T<WDy6Za}gDLh}8~d1m;79|&MmQM}
zGas^_!2bxzV-i&MpC14#@4FuyU%-F|0{#);bdz6?CpK>v!~p~D4xjH6aUj4}u$i`*
zONbH^fGp#Pg%{8`AeopPH^2usFVP$SYzZD`cmCOd-;N+|hK5hTZcV-CQ~lTlv6vML
z6D9j#6Vzq`1ST<<5Y-cSe_$KUQ8$P70ldWkR1QdB9!^eq8T=f<Q~=ZNSdgG71i$(l
zE0M4M^NBoRZEctQEE@|Xt>eUmb|d$R87QK|Cg3yPPRf9)9O@$I0jp|fV0v~%+<Vw)
zU~Eq^?&u&H4vPB-lra}*b-c9VO_zk(V(}jdak9b<^QWXdZT}K70F0Gq_b&PetN}cj
z_QBs^cY%QbV`js1VkwjTag7XKGt0S;r*0xX0%7|>@3vOB!K!;5cJ!ZMjNa}REs36E
zj=vv-jQs!Ne_;WEcgB%WXd4Nx@FI7=8N;is_yJKPOdc7f(@)Qy1`sz0(Vtb2@s-#d
z7uIPT<=~oHe(0>6UvIv0xR_JMlOe?WfRS42{r@-HP%UeREnoRvkKypw^3*5oOzhIv
zi3ol`XbE>NHa`Sfz`m#W#upAD-MxQ=w(FLk89(7Kfh?{0NpPXOAQThOk5~gL*4Fjw
zQq{5L{h!46nQ)AlpA+z$x7ScniHPQ>8K$B!IG+;x^TQx`1$-M7&Cmym6UPUN9{55C
zPPQal2R~a9d(t<_PSd5^fDU&KrB?TB3{P{NAKnI|EF#)9$DOt$A~Uic8bDx)t=(Q5
z_k)3TB4%JffflB&ai5$D-3;wT)0a&9xQ(#D77NES^awc(OM?M2LL0*dz?$?2wIG>5
z*q`A%WB?!!X@V2@0A6GZS9<VA7XQ2uQY9IgN$Ldk8Gt}w0e0lS@;{$H?~J0Wu+LGL
z2n-V#ZV+mS-VW#ho@rL_?7$IhPytXmAjR0{6P`wY2!fHY0Xz8L-$idiwjG!P8IrBx
z*?=W6Km|$wt1+J_0IZT%-NJyV97f`a<Yv2n#Qq~Px*RhW51kZz``_OM9l=|cyXgVt
z@o>`NCT5`Tbv+A}?MS=1wI0Mv@q%9(p>ZYZtCKQ`zY+@K1tahy^8>AungI5AN4o>B
zr;2(5KF(tKAnS!@3(d{NjjZBEQ-v-#4WcRbZIAc9cuw!3!kGRw!=ev*=l&ucy5w-u
z`n@b2ofHR6(%6{!5nS_58e@4q)b%v|Tzh3*{f+#bo?(98|KcLPIu4O(rVilgDdPE=
zYnx5+k-uD8IxgHce7UaVZ`aW{+9RZ*@%U?Yb>_+}9^&O2!W!M5iL6CL=ZFw)?6Dfc
zFkgg0Ry1Rru^U0Lf2iI_?q>!Vcisy5!GwDU1{zo&i$`a0$dFY4_1GkD;0JowkbJft
z0#qVnfB+B@z!jY^-De<(000mag7L{tJse@S;4w66YwQ3720#7~2myhpGfe0-Aw+%W
zI0%4X9e`}nqG%i)52SNYAh-B&qk!1S)5gh=x<3MpI}zarJ+Nn*cw`yw&$i+(0S;5z
zevinDUJ9_(f}h~v3jq%&%%73;Y&Y;h^JYL7yR{qNox(EW0$kh2eZy`581?^G|NsB~
z0A7EI4z<+3!adADU?b+FcwuCfvp*39&<0)dZ~e$0m0R20qdWiGVDJ(G#EPB+z<)Mm
zJyrAp7smJkv*?TtkO6HYaUqX~!+cr0XZY|ivBx0p17kp{FLwY|F>?_><<<#ufH4=4
z3EVX@gk{fuds(RCSdyQK1S5W>3R`VG1B<M}@b178nip(20An^N0;K>IW-~U%KuI&+
zQC8*@R46Jipa&pey1}%VlHd30`|x56Wa9ALSQsaKPSH(wfAJ8=-Et7Um;`zBzdwkA
zzJdcM3<N+mnsx0x$VIc~)q(<ucxioQ|32{pG^e>6%=YmxzBS`wc2}lx894ZV6ag>O
zlDB-fG5Qr(YOF#z)627e!a8BuH#H?-u##a6WIl27O>HiE<ljP=LTF!RL+lQ=Vgv*{
z*@Y>YI9|hFyKFJM2WK>33W&QMOTj!Fe3|T){{Jv)%R;J)DKbl>xQLvtpP9WAOq^AY
zjayfdp9uFI^eT*I5H+(1T~8l~iH6!4odfT$*1IP0qcJ9vg<w%D5dSUgajw<&6WGS?
zo?yA|)FI+=|HKJ#nSNd33p6-4h|P(UlMef%yqs5;4MMEZ$P`c`Yn=bV|Nrnb!7M6t
z9W3Leg=gI9!2lo`mU)DK6z~w!D&`d_-*6l98*~A2Y6H>q*V<^?_pcdv0Q1>wO0=6m
zlVg8?N>TvUQ}_S<gE;%!$HDzHx(|Wt2e6D>0mp3N+Nyv5q-F<2n0@>Q{|~he1OdY!
zPzhP#JHVC%yY0USi18dEAQVPf3|B4UjTiSgArZmAf!1d>DxeT!E&N1$)bPrBzwiM@
zNSt87IJ3K92q5q~rN>=M!1B+X;sJsDrce(oFf_Br2a5ptnQ&34{vd7uqlzk|kSQ9P
z7$6gPc0dXJrD)y{fuG-DKm|$wt2kVKuV@1{BLY{BOEcgY0yY5|p~L$x-{BBKJ^+p{
zHpl<3@L}J9i28>4-s=}JS<@jwTo8kioPq<%G|OMR_)msrcsnj=6U%STWt<!<$8`K9
zxHibar$?8XM{oCk#6lev{d^(7k<*{S3rYFD6vjMDGBYLRKHdx)X*J<?$NP_jmP7r{
zZ}F=C8`GH_I!!YT3|dB0xYz>(8k;qq&?+)`{--Lz4P4QGyymzk*#}O94zN*LC3nBc
zF&tKB4sQ5wc_|#{Ao+ur471nk5+21wmMKM0g`G2DWbuM($@`^TW^qjg{qR)+9sl{%
zW%;^Yl3zRa=E@ozLBT)J39d(L{LAB}ceYrq)^zGXFXF2c5?_7)cf;kPJ1gVFLnP0=
zckBKh-UBI{+Tac8+as9#;mTKmZV%gfR5h(uk;@OnZXii-c37BGN>dg{-*58R>5dX8
zrY=K-+5JRBiQ+QENw;hr@SQz9B>cQG_D&-QW@co5pCk=F29Y%qAb)u9L*_KRVXTo*
z<JQ1v!2m#K0N$;8U+3T$(Wx8-lyaH;HW~&wV5LJMrEn{TL<TIN2G@%Ulwm_XL<rC#
z6C(VPX}xGlP+N)^+}vFUw}i29L#L2q?tj5ZfW!qsvQUz-p>CaYF2Mj~K6W%CD=t4Y
z5?IlIo>R&)j7F8`iw6T8YH4M|;miPH2o2RJ#zF0S_-lwX<zFCZ0BDyN$KYT95XfO_
zcqjsjoCp5rXRy_q;nVK;kbrmL$FRq-cR`kJo)II=Igp_3F#|`>cmlaIkMM{<DGx#m
zHFz2OMku}{;J9?L=rIV`2XL}M<R1RQNb$u69#rdfm^=Uf$KKn25UpZ&!`jt=So2|t
z!V2?d9G{Ep62JG!yW|w$y!5`rLLLd%IGzFerxj8#cx7;LJWq*)ei!5LN4hgo;4-sD
zA`_*F@1cicdI)>D5f8@j8S<m=d@RevOKoTL1*?z5Cl$aB9@CIxZ!kx><{BAv&l`%{
zHzTrHITx6B<m|}oHKyYJ7P6fe*F4msue87nU8>GMcKa_y4(0ff|B2zDJw}{Xr7Pdx
z!`KA{%2!IUmW6fud6w6s!1-x5k*-4lU+ZzX>@#`Be-Q{yJ!#T=CGG%bk$JcG)_J?C
z8yE8lSTB$teN8TKL(g{nx|}IoJ+Sw#ZwQ!_yu9BBQ|cf{LSGo|DD$%$6FWZ;BwRYR
ztVxdLtdkiL`FT7Za$(<oB)W4lP`&^Ok`KEOgeU@dc~YPL07$0*f#2o+w*lX10h_l1
zv-TnY0s->nEghf@0SWy?;R(0^AZIbmD_FHDtXmcT@I;{ssIeLDHUQaPoQ*YyEEt2H
z3PH{ra0M~XK-<~lP=5Vwxs&(BDoMlu*aqWgh7^sgbKNogI}+wmxhlY5fEZttcvMY_
zAH`fg2M_Ao#)PQBe`ubf&^&?=K9PL$iZXt*&Y|*PX~v1a@W7F=vOmy3A{#X#f<zW4
zGXh+=&Ih(Gk8KPPkSrO2F4!Fs?8E^!JOd4y-pTIPX>764(LV9uV=^M#p*`R^H(VjW
zH%Ai}(wa|yhTH%=$Vyj`m<rJk{fqwz9NTZ(gTFr+i7<EDm;_*#hgYr^3_%13FwD7(
z6UvXTH6gbFdlF4Z<<v$0|Mdp2RT}3G4SfW&QO^Vxn)of~J}#?_s*d<=?W4OiYxp?=
ziM*c(1bj$Onu<az43ZPe8JOo4F8zOe-W{fSVF<<6>9!SRz6hd0wQLsIm9*jf{RY=v
z@K>nmRvBGit@Zjpx=*_aV@^HiqOzO-1;J%Bd(Nw-gW#7V>PK~$%x4vDL;d<pmw17n
znVBw!4}EdDyMiv^S%X_5PMVB$nSU7|4V!bim*e6qv-Qj^Q2b8P_(EQ||I`ERO`Uvi
z!3pns!X-ODV>0m!6Ce$nbK*-fIDapQVIh0Pc=5E@Gijv+vS_;B9~mJTlYGgisSK0}
zTn^8+)sw~u9p7x0sI2k0Dy1RG$%!4Qr{_$N+8;QYaHW>6DtO(7?_FRmx^I`1MU#cJ
z)>TZr3b6MvwEqcl7&0c4PCH+B*S``I{K>bCKot+=O@NO;2T#tBV|lRqKN5(Kf@a&V
z$Hxn}MhIZ5odLh%ODtbH5$>1^|8SeWcH95l&G|go%vY2^f?(?jNoF(p+(fX|W<$1q
zz40-8*AFg3{y%TlT-S_~gIH$xkplFj#<JvJHKC&F%LnlSe(`T0UB=LS9_%5#k3)L|
zVeA(8QVg>!fuWCs0t%=GSQrG>05B=`xYB#zP2}Va3PvAAkP-M1E?5xhfe|-o13>N|
z{Kbr0g|H6Bv5a-c$CQ9sIsprPB05R_5&+x?dM<M?7zh^>pN>27!44knPk`kNHE**V
z<a%)0XbvafH-0|CC-g#&#p3)BJd6skpKk(v`8h3rkIi&`Aa%IihIXr#>ERTeNiZsp
z(jVm1|9g(o#23bs3zHU7WXWI82v~C#pE7<hi7O@NUwU9LXy$d=QxO-I8ED*a=@uka
zOoe|g^C+(p2yCZIUV_PAHBZXF;IcvMvuG+ZKOa56+LNyU`fhssN?vCEw-DMnaS&7E
zE_4O~{iL^t*SrA!Xp?wwdLO06X?K8(-+{A5jI4X$t|P6(*yIyz>#cmvsXNEz>5q$t
zEhqzJTaA1Euz*=pMxA=Yz%f%y>+)b<@&X>u@gWT6ne4^fDS%(v-)Bfz4$cbsOS2(f
zFR+Ny&74U6#_$rKmQCDm4n}Awq3Rho5kxNV!w0s@SMildT?6oySeAqck)7LM9c0ux
zKM5uJG{^XYcH)_oY7ehlzi}daqJ#C^(eA||0NI6W6=Gnq5<t@P<_;a+Yy3-~)%`*r
zh?ddGbKx!*iM2c=hgg|;spLvbBMQV^wvPlDMrcB8Wv@7I01FY&ZCZzA*Be(~{YlsG
z0d_jcVW2phBfJ1kssm8W`4h|)hhfj<2vz(@AOIj8dxytZ$l&yU;Ya}c9b!@giE+N_
ziDn1n0E`4a+K?rMEMP-|1>IStwm>8u>_0Jt2m}!<JP2V*ODGa4Kqxtgz==IF0if<-
z`GY7GK|(|a8!%H_L<2#d!}BpiQiOrH1_m=@G8!BM1C0@bIYb140Ng+$zcEkD{w34{
z1~LesF#IDXBt4C?Oz*zPwlETq!UnJw<~=Vpm`x0P6@SBjI9SZ}7-K)u<r-i9F7{$m
zSZTU95g)mG<nuJNX~Pu=c!@FzN>e*N`dhR4W2Sqs={SJ&3Ag{OnmSr&&HR#Dm=N;v
zjW~|--r)T${{Pf!X$<B6;vqNz`O&SPI-Ufxj7<ODg=9J>`uLc*AF!Ux;Nnf9RCr&<
zL@j2w|E@?Q>(CCgeV})|e1B38k*Cga3%t><#KO3LSL>NFltq{PN9rk@AR{9#h2akX
z{acI8xO)IOwQv#Z${;@mWnfC5iJJ>P&zEo^6yey<yhLOm7B=*X(u9fVL(KQ*?ML>W
z@^^h{e<FGi_H^^|Zld>R;sijAJDY@giMv<+4ym&<)-(#BQQvs{M3g{hf|lQigex(a
z@mZ$wH|%9ctsxoQ`azaiQr<fjQe?%8t_o&P#m9dSdTY=AYnp>$0UG2#-am+hFA(ID
z=;jgO_a|b!h(l+*{Jl56B%TKNvbcbS;Ewv{A^ks`t<nmzV*3ZLVyTP5J`shY1i^PD
z_RGtqa&bAC85*P>M5~sG<bveD{b}DHj_1u=b8aQ_qdmzLJiNXX?T&y@j)UA+kl$}o
z$OhZdcqElH>OUqsNZA*`PY-C;=B;;{Z@g>nXFkiq@^JZSLRQ?;xIQb594sC5p5Q9n
z*B^GH@2)2#jn)8H=37oLJl#I=nvaTvPOC-!b$WGgQA#03wvT$|BWl|k@kaCL*6Op~
z=}adYDj6S(5;6eg^_AC)*~mbbPiN|*J--6i*yGRplbRY&h%6;<>0t`STZt@$%NTop
zuh;(&AbtiU(>=n6!@Q+)m@VWuu`>E0aK8#(m0&geDIpc&61BOF$hw~M$1DWBJyk4e
zmHy9D_;`}|M=hg1ClSGB;F!MWHJwIhngIXwpNdgWD0}nTz1P^)C&k1|n4|@KNSoPR
zl#Ca#;Rgq12k6Izu_TPs<mBE+d1#)Xsv{A}eb*#nF%x)fh9dShX4Fxrh(hog_chbO
zoWxdSz@{Q~YtvYfP$Xj#OfIHm(S(p!9P?rrB`-bf#6<e~$-%ADCVTM_^o<6t&_hJ9
zb=xbrKvV-+*|Amdb(j}x&7NO5eY3NCo@ti;clQMWtxVQyhWzJzDTA_=2~_g0{PlbJ
zmbXg|XAaEu>gN~9#%&K#t8wr5%J(>shv072tn23bDj-g|#LseKBXAd&tU#)OcE-f~
zsN$K~2GJ|T39ermnDb}`N&wIMzn6){##+JdW~O4dcwc0C_?{v%w?7G8)N(p9d0<d#
z=*8ME8GK~0bR7*z!5sg4chE7N8Sk;rcv9?_L@;zOVTPr!PHg)~GL|#6rUHwSerN()
zzn&a1zHbDMyJ8^@?f{#*MjU;l|EDPDw5MnA(Y(e^KcD8;IKI~{E!YBP&#>Q%prEn*
zXTjS}^Sq7>$3)WI;S?KrKt%gxpAZlPHtzm0EzrO5FKY$)XS7Zx5{Svo&j>N*;AQ^-
zTc&9@5^N{fz#ZyaZXQ{$YIe6`VPx@8W*HN?H&g|`Dba*o3;;<4ChU1>)XjZ2#PZ7|
ze;E$%07x~+Hny!-!U@bK8_*NFIVbwSu~Y=YtpPh_)*M#MOuvzD7uoS6;MTptE71R8
z0iwGEE96#(_B88_$j^Fz#BYKO3w~Sz;<9JA>rnmTv6r9En69!9|IjKJbIKdxW+Mfh
zo<9)?NG~Vr68k;ugxXKD=C*WG^CtF2MjI*2M|@3j_zNm?6Mc>tqn5GO=PvgL8;#k!
zUrb265?wJ6mg)`y74A1M<6su5&F|tNPf!(O$9zLE(T?lEjdb+~uTrUaaWOqBQ4Zyc
z?jj1Z01a{L*w$iM-vGx^;0&9q3=52Q>*w)t5s;eF0n)jf0P(yfn?8PSw60pinw9}Q
zGi(}@(0>G;7F~gF2g$^Oxl0*!V+aygGS;tw`CQuDz^22C!^9T!DKTCqE0@)~8~9Qh
zMXb}uOKup*QJu|A#?02)W|=cQIGFC1>{1Y4fmWBDe^HO1oB!}@ck2>N8{;7Fh>WpR
zz<XQ2wc;T^1V^*{&+6<9ZP}+^yZ`_=m~R3Sr-T+F5b?lT><+VCm57gL&py-IcvO2?
zxR1xyD|7Ptn7jHzO;2v8lb#pD7-g&CCLc1aWf<nM@s42)OFm1-KmK3y(=H|w3Ag}e
ze(SpT{tGK(@JR?_c_)G^BJ+10^2Cp*0-qnOem|cIJN(Fx_TSb8zBJM}*66!ce^tZ?
z1$n;RjYQCYz}cw%AUf>x3YRd>?EMx{4#@(FTLV7G=ST>9F!?8k#6)t?Lu3xdqhLUB
z437RHiThC}!cR5gBWI!LCD{DA#4c#luDhA=2OI3uuV_;gdR-51_>q2MRdDzF{2fs8
zU~iVXh>wWv<BbPfrh7ak$LGG2t)1DSb);LTrOqZ2q3Av4EFU}J${SG%_{iz}K%0n@
z_MFe-D5BzI2f!LJ4n_I;GT2$C-55=PDE9G^>B|{!9RgvGnVWY|1%mA6qgmIqY+wHq
zrZI#sR{wJHZ%Yy-@&9Tk#7DykdV35@)g(+e03~%4-rmH>8m4~{b(EQ|GVSppDcRfR
zzY`=zqGa*`#a=73&A;QYn_yq}I5!_8gai+jf1hQ^W_XOeoNvRvcteiq%Lq3kwV%@N
zYShsY6OeU!{9c`LyO}W}=Cr<eVg$zUosiKY)R7n=h!Y(UBuoL}#`r@9psS)hECsI~
zTI=8Lg2{VW2KbQ#;uT~D#r#BPC_(!%4``$#fP9#i{-C6&!|ShI7sVwlr~FTeu1;&=
zYJf4Dn*)wYCDr@?QTzY(5%{jr@0U22$!=~p2-uNAYZ$yMUi^8e2DXaSCt;%|JL=^P
zC=xil616t}<+mKSB_!grdQB5PButO!9Qm#)HyN(80p*wD`%Ph_)Z#4vtVG;j8;t8?
z^4>p8+?l*;oJg5i!TEQ>ltCq%1020u!w<6cccP}&*PG`4YfByQFZ+lRTaHz;L`{>T
z)+gkGJtIGtdxSB)$qbOf7$k`C0%CDLEDAagQ<(&Txi{tT{9mGRehXTdh3Io$NS_fC
z+_<x-nK0u^;zSLN%q>DP)MnYF$TOOMINU&D6Q`P7?~yTJffFKA{O^4A4Q2o9yO%7~
zM6$8Oa#vhM$5lYdwTJE}H-3K!e-Q{oNoF?Jf?P?oQ<&mJ{JgYiM;QR|z13Ru-oOKF
zy9X{#joVzXsSw;C&rIi}SePovOJA8~I(5Sk=#zPUO`@0nF!2KR;{O~A4wlw7bS+_h
zf4pq$!EBsVdkW1!W7qZXC_hO6QUvE<ACB#mel;x21~zy@6?JOo7UqYWX_o$TLuyEY
zKP8#(6UX8?l_cm7C~I=>5@~suwiD!qw{_RCIGczQ27Hm`zaQRb;tgS>Mr@H1eL5ST
z_n!3iAY4}^bu>Veb7#qlyBM56jNdC9u^BnDMlGm}PABj|iH5jScMCGEkY$wRDPHR;
zSeBg^oA|s)z3nZm;5%0V+Rqt-@xENb&y|p7`b**t55~*2(^vsOuPbgHS3ilvZe`_!
zu$=sNOqd-y*?vfYCfMPnF>+u%*K%TRAWiXAwn&jf`Iuiq_n$EwA;YiMqr)2aywM4M
zH^8^?*cMBljCvOOkTt!j7<%+|-d)czc<s-`3AjUX0xt;h9udJ$7n{bYRyXkyVp_7p
ze04#FOsGD!m)wB>TLCn?;Z9x%>6@(iJ<-gHr*TFm)E`Qc{9P%JzAhv4YXpwFd3Y14
zR(*BflMB}3ej*|xd`4<&9mPM1^iDdNYZ+85Ni1RYF}r+Jnb6_BoiCps;l%r}j?&Gu
zT~{h7LJ4H|`jU}psCyBX5Z^Z@1gi4##}7YgVg%30k(pR0B$#S`<s>S2GYR3`xBeU&
za%Nx0b8zn{+Y|HUj9vb?trUzyw9kkW^J@e6M6OIv&2nO@$)6n#o+H+L?<;++_7D4;
zv}wEZIKE7>sj)wET1`|$R>7o{1TRN#)kI%;@iP)`b{wyEK4~xFM9&f8B*;y>d`x_C
zv$SuYWKZ!=(;@8Wq9^quqp*R^!>!qYD2$O9GvurMOxTc}1NZpSVlm+k4u}vcG)cFJ
z8c8zL&*{JvzWA%yh$QX-N2m6zuM^@)#|giuiGeeC0QMXjM(fc{=RZ44=O4yz4kovZ
zFy2xL_}s&MBU$E3cM4^H5)tsU%myv>wfy@e+Z75S$#2W?0!7^|C~0ux;%4N)bKc2$
z%l_>`cbxZOWu^wdPeSI?rn#iFviLgWr?uslWg~@RX3Kse331l`1C5*K!hWCC%;oa&
zwcJRbi?r4%hxf&DbWUDMjFq+iAa@SrnN^85x|(pMC64mMZ;72LTO?*;pNfcZZv-R*
z{<nGlDpJLb#FpHVmchqF$!Jx0j|gC=lVh2jK$u694*TK+LL6LfGlcQMK~p*paR^}-
z6J};_@j8Sz$=Ykn8WK1=@j_5JLPR)sEV*`3ZxJ?%?jTH%h6;Fy=1R2pQ;*=PdjPXe
zGS9o~s6cXK_g&_i|39csAV8=_Oy$BvQ;n4EL}}vZ@PPefoc%fG9rT<?u^T)5vNJ0Y
zQ5hmN-7l)NPvT-Arr;y1X1#zhYBc<w$p68@10TX(??$|zjXpF9P<*f-r0Z`6VVB;V
z&n6;Bp9o;rgm`vN7OPP6lPFw*%HX!?&ienCe&JpTe3NB$npzb4Zb=|2zY!4MmR4Tx
zO)nD%>_xcH(D^w#YD^<>816_E(9$$Oa6)L;7>F#e;M<_Z+rkMs2qJLX-s$X@xUq_V
zOXdl<C1~Gw|Bo2_8S_}r)BK;B`-Tllcw3W_A1wZgZcJ-G<c;qCgyqI|Z%$6`-b^FJ
zY9qvMAWUo_;$+S6)+fZk_aPe1*9!sw0CH`l00z>vmfR_>Vu3+GJGci3;{|mz@vroW
zInw3DDzB)H536xiR*{X)x~#K0d7i!?Cx(BIl^52FHwtrFYK5AL>{Pxdt09W-w&hew
zplq#<v%m(bMye{e=oC;Fh4EU-<T%dBe#)3Op`)A6?*4YkeTONv;a*fs!+*dogV{?L
zmzv!Vp=^?RZR-o2syli2x4;SB_jy7S^_WSnbPq=WD?k5uqBJ&^@P(5$p9`qRk^~<^
zinJd@pdTPI8<jiU_E)HMSq`6T43Rh-jorJFzj5neZ!e<&MIlYH^V6}(r1<~<0Z3)g
zqJ;#~h{W54)T&)yoGL0Bp@^DCw=6BcJhKnSygl%*KmP##ywsy|?er&?&$FrIZuYi$
zkG}Ky{Qgfd=6SyP=RCe=-#o$P^7(x4CzJ0UZ#lf=8#!FP{EkPq_K#@x{bSn?Y(2kk
z+IhUMD0z=JpU5824`@BN@Bjb@wD!ONdgIps9?%an&JR1!<#~Yec^*$Fd4c75z#d1J
z&-dPcFO}y203Kt>=LeiT;CYWb$^p&?Nz8OQ0Ote3-~a$ekU^TEpocB0z~#xR&EC~O
z!`<%+cUnma<n!mg?gt)hc2;o`*1kN)L<!-HGs)%55Jd3fEVZI%#BL+RVF*Jv2=yHr
z6;Z*MbY%L75-WgX{WZXPKCv12g@D>L3cs5S%alFI_=rP+G{4*MwXl1hG&pglWOo@6
zsEp8t9EiivhFFY|0&kNJ`{D$f$u1|v_?{vnJ?eaHWBwx@2xZ|M-bqv?S3y3jeT?P(
zb7Mh7XemE20z!C4oy>Y`<ItnDM<tFVCyz!HM)e&TIFiFqLw_3)sEj?$!_|~wsDUvN
z0!=lu@f(QTKt^BUD-m%Rt}D4nD^J8|?&OH^5in|2|1{v}y-b)M37#K0^JX+={_*Ld
z>92?<HFBPQBtYn2u>)EIQgDGD96x4w?{OJn3^U6vO-4b?BP>kO!ouK!k#U|PG9kdS
zLIB5lD`knL)en#SWmcvzw{T|%3An;%{cHCKOF0KFtRP8$eA$?X?3jTeDAq%(5H$m@
z2z?t4ekKv@S+O|AjM>r(U_MDP9h>VBEJh;;1f$shKT#hOG(?h{0Oyh2dG`hzM?G{e
zgul&b_whU-iR8ZEtDC|+;{0cVHksCOhzzvnugGrWe|*+&h>7q?vCr5c=|)FzW4;wu
zp$yRiO^*$5J8m`Qyhu)=Cl#=;_-^ZlhHv6TYKKuoe{R_#CGx?0h!Q))JD_57AR(~j
z#Fm)bw-^RekDs3jVVQE2M~w`lLKeitXNVDT9wQCJctA|Jm`4o9a(0h=Pl=ik@fkU-
z6FfkXo;eUaZS7b=u(L*Wv;n>{hP>;EDXn(1xp5&Y16VT-4BCzi$re`UM8wIcX#U}X
zu?y8Po4rH{nj`-ZNJzP?2j*{0KXD=-6<6z<#a1Q~^Lw<`BV5#po*+*MZX#X>qiWL}
zMo5e|iG}dYA&HX{aT?~Cmdo{sB>_E6`jM#okpgZYO~h{yNxi-xOx{jNx7P__Anv3*
z4n9NUgDBw3_)Z-kY6`n=3-}{eyz>WXreZ{wd+{@3OPVXJNiYJP?v-b@yPqX+@)F-H
zF>5?v5SWaS8|CoqnDB>2JEkah8dSj3^3{)_h?Ye^bH9SzBNc)JO2lO`mlNV{BQ6mn
zTc*dtH_LWRzv6g9Q5QQivrz(kK!`}TsCT!onC;PV5nse{I^isMT!-TP`iJ8E4gx=}
z5yO6oqK2~EP7&c*f)|f`|M3@Ozg)aa>x=QE!gu?Kit~BA-To#!8FjD~RcjN9aZJ9H
zWhricBgAi$9JxbN5gGaEmmosZ`yr;=kmHRXnqQfrp{#W?i2P?qGYopo3fTn|_wrU*
zuU`{1FYV6~D|jupn0ZN%0^Jq<Uj0B%X$!xf&3AtBkcJb86T%o<43gF*3<hpYE1djI
z`^1`spYVqfsGV^d3Vl7RA(A8FN!3>+y}t;_D9UFY2SP+3ehqiqv*d^q@>(e$5zpW8
zFS9i<9w10cLlEM~NcI#OSdm;K)FZ)p@J`a1!aNtB|J)&A?_c%Fo72Q!NSomg5jG*e
z%SQ}lwTKmqet69h;x)oJa?1m>GkSsA8Gsi};)CBE=7ezDiH^Qmh83J7?MN<)bAWi*
z){U?G@tA9GP2c#?&B9TJtPNRR_wf+ySkMnaUq`t95Qew2wNruL%TXE9t!A)vR*WAV
zs*w%EO`pbNH~QtJI!+=YI?$1p<+=Eb7QzB%#PJ>&@PL^yJVyT#B;3|K*N7&5!`w%R
z@i#f5-n?EUkaaU25kC{+d`)6Y!e+Wa>N1vikBHhB8{q>78Td=E!aNt4P8Rapf7~Y9
z_x?{W3V0*W4wE<Ga%N&2YZvjJZ>*_hl08z)V~C5VPcQM)Zfs3NM0b2C%`yZM{gD{V
z-MV{5{wg9S92}Vp73q!-Ed1QTv7J12tO$`)7{eYo5O3lp^XG)JvkucUTjDhm5ra?S
zC5Y5Uelx&?d93&a?;0bH_^p^FN2}A%@ul%`fKZ?<0hTxiBu9wcF_#F*5#l2w11A8{
zLN;|{L#yEfjq4zT`~$-_P9Q|<@kr$|mgK_<LqH$I3E(N#I$MnS9m7(2EXfg@_>iA;
zp~kFeGSAVm{9eODO-tDEbdTRvvK2i34cq<roNVmUVZ<80tVpe;1kVarc)tw9#7TyQ
zjTECdxd*sA1bgmkQ`|t9Du~6z>LY&QGk=71P*0wef&)2;c)!iuCz*y7zS93O5!q;<
zPDCo2#4q$oSAy{$+(x*+G!x&+6+)}TTuU#A+(3%v@X2L(N~1$61LI<447q(`MbNRR
z!kig4Aa2j%U8!Rc-X?9rRwbk?*X|%mVW#Ku;!T7sKkzj0{CsDJp`|y&@xSEo)Bmcz
zAV|;BG!Qp^gpT|jsVb<#2XK+Pct9baJ{%qhxB!r@mAI|5@z>7~;finXi^WsVVynb!
zmy;I|Bwh}zD2q%%iuMM#ZQGg_Ng%o#2x8$3L?MP^0yB359%X$*Z`?+IFE^ezi0*hC
zgO?+5dEx~AUP+`#P5iXuH#|gE!2;e9xi7GF(s}U?qaX2bYMRh^Bzj$gGc7UTU$|#>
zVH}NziI+Abhlr97dn3N|zX<YAkBQo$t6#Uo;uNLp3>AeG45^=p)+BZW-zkvBj>!oZ
zJ!~?}=WCWuvQlJD-{p?wKzME}ZyB&S=sbtvy?^M$T$lyZso#5TU2*vA&{Z*tV<BUM
zDNJ^UgHO16EMNGK#qqV{hG8CeKjL0PX`Wz4^}fGxAKXBYmO2h45rA@tjEk%Bm*@Px
zr{U|a4_$ZsMzIFyN8xBg1hE++H|`_zVIB+2C)+>bAqY)s2V|ctz)YpK;`NLe*s{M6
z!~-6gU58!kc6n$1<cX6Soc~ciCT|bdd|Uzj$mgUTTT*x8`&URE?kQXKaK>1HA|>Od
ze_L3HntOnC6LR6gq*P`3cnaHKF|%BhLQXxfxRI5wjT-<$c!UPusbC}{@R+HuQ33wp
zo!N#nSa^{fM!7jdfHld6Ys9z|>?+=#8(pptp;I=ob~gm4cz(H9n&BS?F~&MLFEKPw
zgQ2XD_QJZpU;T>Mpv{c&73kF)6vi7o1X7y+;X0DT{Unwo*n4vvGw%>2A%q^>!&f7{
zd%Us6vBb&ilM6IOelx%-cBKE$)ID{^F`eP{xq%Q_yyg0h|Mw4Fcm2e8kIUn}2VN#3
zY<8cC2v|Yw%;<NukO4a1iag%+Tqso&R^c8bPZ*pFZPYCpKb|AR3HYchX@gh!EpR%t
z!pwmpVAs;{Hanm3(9tWzvp=W*gyD#0UO-T49Tg8KIGj{N!qEW`^%TI-jsFrPC4`?B
zHU=J!mLvMa4uU+{<Oih3Sk4sVbDuJMT~uT`1}bk_&->=-0CmOPPZx6Vu|75+zuLTS
z5--N14=~~b$REUyvYKs(#sGb|EG<p*$xB%a?BAjpU;eaX!^4NSKHeZ9#^*3^=oNF6
zm20csq}hmwwE3;;Pw$V7ti~E{dR@zUQON__p78P2C`lymKR*2bi}BD=WEi`I5o`a)
zz#~#@gNJq%entMVxg=8quE5y;U;rE-aNORY4$FCOvxzK4e2&+p!gzNr|HozI%(~yG
zkpeik<Mh--bOD9R_VXwLH~No9dV9}?U;;fXf7D2x5EBJhMiKEJ#0dHV?Rv!x8=fQl
zS4g=vJ|vhWY#-r011JC&PJ%7Aqo$P-B-4gtR5s-NK1j!*e+kFJhsUGJ5C=Gl;W@wn
zImBB)DdPA>8eD9G;#I%<1u!^>I2b<*m+!s6p{ft`|Mkx`6B&^Cu#d6TDha54Lu8zM
ztsHacpI-DlI)B7sw9Spik(v974u8%dF_OoNIT`=|2wsXdA7@GyXkh`Ng%KVm5%AxK
zlRvs2gd^bx@KXqt#eLbxWC4}t>;FknqsyrD^H-6BcVE0C!Fi8OejrE3%SR<XN<f?S
zvtjH@@|T!_A~qiy0!ATG55O`S;wy{K3k-5GWV1GRcS7+P^w9Lz-To7gj$aP0^gM(X
zfjgjyF;0X3bwBQCAYI@=%iew>JHmcG=wMb6$%1|vfU^Y45BP{rq^^rE8p4R*5m37w
zW?Co@h>wG|HRRp5J1e|wATQw<Ah>gkE*Rz0#&!dbp)E6=>4O5<`8%(FF&vi9f197d
zx8h<Y%2G?>JVt1b5tkD$9~zqQOSVt)_z~+YXex|McNNl<!Sb4TGuLGoC<`ZnKYyfr
zq8$y6;z#k^{-NDRb6nSaKYx$?@SNa+JUTZ>s8|lkcN@6?TPMwg`Q4%Gjr>G(C0|HC
z*&!Y1ejzH^rPSpA*hH_!W#VG09(xxE^QrjjbXiG*wh%|xz2h(gQY&UZP4{jzGXL=q
zhn;x%_<d3F%kcuZ1Y;7~dBNpH>Mtd+h;HQgPefS7lCQ3K>1X`D5jfk~@mUztFv@u>
zwU}XWd3wRgt}YsGZpO%uRI>+6vdJJde;v7HGkEVEk4*=+Kk?kZ!zkFiy4#*3#C&Ck
z0CZIbhI-ByvM@Rs-HJy>!u}ucuj&D79EIm`13p}g#+EYg?<7X-Ezv^18JVx*Ns7CE
zBE=u1J)+(qNV)T~xsh=`Ch;<Id2<ni$eA&n{6yRjyOW5`5#l$^H!xxi<04`E5F|z&
zGQeY?tt|0Grdh-i4B7xM94fGt?%(BvziOOHxgvEF7ns;e!&do+!9>rle6VlxFI`;M
z2y*PHF`0XCLztO0lYA#MSXkMyknrf*vf(&+sjUb7aO)o#9&cbD72qTnE<K7Hd$-k|
zCE-4QJO33StZ){cTVO?agt(D;?>s<}mAeLpP|Uf1xCiU%ySu3~V?qK6(ULj$+VubV
zvD%ymjTZgu%K;<FHow|0>4viJTz?ND*Zw+L`1pyK1C#Q&PP}sVf*|m1n*2;>cdP?^
z;NnH9-Okc6mehH9;s-*B<<^;s-v`&DC4Q6Jix~>Tiy%M{JZNx!6Zml!FE1Dwy2Ou?
z7EJM`iN}<XO?BQ9hpxM&(_MG}6`>7jt_CaKA<<ONmZF-4)J!Kan{uMs@q3K7hT9zV
zxJ2Ck?BRbBASVv)cM@jXY2ZlD5vYMMc@rgd*R$~+BR3NhW@ct)opE~GHVkU8W$^-B
z+`=Xi{Ct<oJq0YMImC&<qo#Wf{2H2go*+oPcQ4NlAW5(opMM8vJQuMuiMW{QGHugz
zil=?G{u7O)c~%dhnodxf<K`DR>nI3P=DlxtR1cu^^zrc1;SP*ZTz3G@X;GsCt7>c)
zHS>v%@ZHBM99{4Vt-JrbKmIN=8|4k~1FaYRvlAKNyEqurFM;qlNW*%2@6DK)?k^+&
zGJL;4)8xlLtLJv|Jgk)seCLGjK}mlv4qwVY5n&FrP#Iuqly3{3$$Jic|AhF|$8rK2
z`D{53t|UpV26X^Y$sk~JI@Lez<FVm{JgWv~OZkUpd@Uak5aGmc;3mcSpM82}>**S|
z;zC+Z<Pf~^x8WXfVeLm(6XJM?h^wLC76U5O+gBI3@!cW%hdT%^GanhwA{t6=ye;_r
zw$F%72emJcW&E)oBVOVzTQo3n5tbvwWW*C$n8bc;1NR`lA<~&;CNTnDI5LMUzwvfh
z_{rfLJG;ktM$Ya8ZC_q>zW0P|?(P5HCh-L6UFMbV6YgSg0Mja$5gE1<us;uz_n41_
zkUQA;_yAX%f8jaKEINcb%O4FZnjcvt%;$&+G5C*&l9>zBHzUMHV&IoE2nwSh57D=8
zLZeOaZuANrW~MQH%k%%PF9`VkZ<xqe@iTbgS&5GD;_f3PN(xveNitlYiTL;&E(4!o
zEMEL_gRCNt^U8@5YewNJfCLx3$B`U%z942aVYG`QIy7X*ti?eNNH}&rq<Vvknh-Q{
zai573OjAC5H4nuTbK(YDWeIo=LC1j<TMNu@EA!ty3d9K8?l&aa?=UsQil@&z2f5_n
zP9P!UF^<6a+(7B)4Xnbv)L4-txC-6BxDIC7U*`kWrnnBwaW71dcy|$>)+dM)2JnaO
z9e!;TdP@=FJRl^z*wG>+iqBz6B+ZiI0zKajSyecALP!|xOe61;`Mh_=he+|ed2E(T
z`|%acySL?{!5^EWiIW_wACiEv(b?kX5y!?~8C*|@lZGLgd_*DP*m!xduyN{z1~<WU
zP9_oX5H;!j&+p+27p??vDc$}2A>T<9yrKgEs$T3Er-28Fgn5jz!6MgS9eE{Nwo&kP
z^soFUFqXsc(=Z^4?zCPe5|O?5P>W5&!DfSslD0UEz^L4$1@GT`iG+6n8&}^V$=qr%
zXxPyK)IiPrcH!Ljhf<jImI4ZrLawqzM{<ZD5<Zq2_P_}R$uQma1NFDQ9}luHFMJ>0
zU|<Xn)wcXC05ML<XPivfM}e_}i!1Rr9v=o8tPS}DZD4Q8|2I&ZI{OeLc2Gbn3+sI^
z&bR&m_m?ntk~WXMfZF+r%e`;-&2HI}9VqYvRSuV>jgG)V(CeQ0P1{p1i3w+>GcR?e
zi4Z0P-4VFTyH8I(lamv1Ka&po;y2v?lfZ%gB24urW(r_B_bl6Zs}+C#3PFfQJDSDa
zE(G-M&f34<<2INv1|s-4nki}rg6oz}{R}7oU0;o7vp4Ufd^g2gL9c)OD(fGmc%n9q
zONq7a2mwgQ+THR&COR{|m?@R)@!x_oH)B_NcsnUVQ8TJ)Xspm4!GZu%5RDrf21nv+
z@}6J``tmr3-z$a#HU1HrMlG>5?P+jq%re~YVkp0kvwH*x-<)SdlT61+n>ddX;zdX7
z0b$4a`X^0-_a#ULEcX2W8EmiX^Vs$YH3T03vgv^jWbOj3HhTb%*;vxQM!lNd`Omo6
zjwU)`0YO#>Rp_z5w*R~0Avm!Vy!Aklz-^Y({Bfo_CN&Wkj$HhZt`fsLuxQ!vO3<nr
z8V_P4G2TF5aXjA|MyGEIP5f-4T{*c^Qr8egZ}X1OECLo+xNZnS$KoAd%=CDjf?|w&
z<boZaiW|Sm-zD3_mVZAar|`@xPmG$oe(w;J$AKfJ2ZLjPpZr>X)C41Je~Now%kH89
z%KM(Fo=<7cA`^g=YQT@MP(FTx)ycLFjQlvX|2C%P`TXoak($HTTm!mI?W&OaXWANu
zk}d-62d=yS;f(!p|LuPh2>8Iwx?A-qzl5-bgQI~PLiP3lMLmk^zw0EaD$S^~Ck4Vb
z)MjW6T#NYnP%LIk)*09T5edUXEvhFULh*<mvgzdrIE;}W5?<+I1mbeH5%`$-ja|)*
z$jm7aCZaGw5ri;|p+^8A>-x|Cf4~302GVBGk=1^}AjBi!L(}SL1AWPz;vn|zO#4&}
z9qv^&`?<&U$A5{4=$)t36V!}|1kCC9ZQKWn2jGGx0V{N2i>n_8{BW@TFL~fP%jybc
zr2Zx^fGtfp--DNlOw_=O?2rF<@QZ?VQ`$xiAA|vkxmXz)aKItrV)+bM(SnOSzs7Nv
zS;SD>!lT4~O9Qyn^7<4pUOGQ<GUf;e9RuDVoHag~57#y(BDJT515@$*fRw#?TX&p9
zX6?rG3veN6%w~RoIQ;WQfEbGLq@R(nG>QHAVqT2gmp{gEhueO8#tA3N@p_L-J18VP
zyN}BpDii?#`iP9-F5R316tfjn7zbCshL5{;@rptZdeeWzi`C14P})jmoO#TqiVO!g
z?*HFYA02>%YtO{M29K5P=03;d1bs9ZKg}1@x<8+c%ka!f8LuXUS3~`#9s$&u&0-PJ
ztne-LB6ts@8sCj)zFP#cKf-eDpL9cIZoF6(Bfr9QR0c9Kq8l9%4g#;tmyVP`LOXXL
zN4EJG4u3z~DC4&04CFY#bN+t=N&{8KTmn^2F#r4?95zdUk6ETEaoibdjmk$QhVJ)K
z9Yk!kEBJwt%~J0L7x@o=hO6dDjz`CE^!|J|(NcHBd?$nAGFiOGj)wrQ<KrW#uslY%
zuN)kTFM~=2_B5ZwkJK)rdr%x^TqHkUV?V`hdDYpQIpDr3Q#fZp#OAO}ixctjqd>hL
zU4tAJ=$;k?XYE_^(NYc1GXcx3D34wz@m^*mkBAc=gk{8%Zhxqc5r-l?K$?j07(yUT
zb9h1aFk%@W1L;LhdWVh)(T61bKA*P$J(G1X{`!mt-7XmtJAhS`K!5)TJ#>`w5qAIw
zJM@Mh_7s1P_WTdy8~i`+gZ>cSBH<qh$<hF3*JyG6mL^OCDeZd0_#lt*Wsrw}50RUI
zTJrgT7%$oh3h)2VNak(21Z~#*00ZEl5RQg0PiMk!ZZKPl{s5Ns<R4zYi1<PpKzXr_
z7eQ8QWYQ~Xg({n>4Mf5_Bh5s`lyoK_Zjb*GKB8y(z_=+mI$oKY7EjOkkx&p-gtFDo
zqdZA6>7*Rd5OPJXvCw9~_mBA_L%xE?Cj2A2fTK;}C=K0pI6H^p$Gk_Xeka5dfBa0m
zU50Gnk7{HQc40hr$81b=17;;d-eoKxphxQ^(&G)8@ctPkQ&0Sk|NqyQhY$Djct!De
z$OyZT`@!Cm(m8#%GK!6k_K3|hUhu%XC32&Y8~*JPyYV8iTTG%;EDQvv76OkF=Y5_|
zCO?V7Ww~vvI3h^$GY}+QRU5|!P>Rm52oHqtn~fk%#*^R}^*CsE<MN1&48NK%7|EQi
zr-URi4<f{N;{76+!p6~>H~*pYsc7a%=a+o(n9#~JGd~{>p-YEV2`pMm5F|x%UQGQ&
zWAKcz8;HvgCxisYL<DE@M0ku}He70+BP<w(LX?3qhRcBQ!+yUn;rG7@7(KuMzoq*_
zmX{jZubaRP8MsiRo9e`b1b8HPz@P+X{a<(t>-|KN|IlFIXFgdxKtq=&{Co@n^MC++
zf4~!sorWKH@0gps4dJrXd>hWO7G4N3nS%0sFbYN8iU2LQIQg(={=1woE@$(J5GPA$
z&?g!Z04E7epN_pD<1u=GL~&W1J(Ro!md#LM<=ubcH5d^nID++mmJ!R(@d8F*dwDxX
zLe(CuqP&k3TECTBmiAZc?6>$%YzXjPVt1GR?~V+^gE#J@gD`3cZxzK-Bwr&>>~*x`
z2JaVP@YFaz3pnCJIw{aLDf&>|-Z%gQ;~kr9qCODPdhZz6&)<Yao_Nk2yTI|rxfaRe
zCt;%n_t`3G!`69~qnn4-9^`4uQ>I>=+<dPcki>>6O^QvQ(GDtA^7?z?@Zj)i$k-On
zUg#JqV(kfKODm7@S8!S4$Y4H9>F31V10(G2PKEqO+zhz-2#*c-4O^D)i2M3>Tg0rG
znK-_CJ?FNthA#-q_>m^*1|P8kVO%3TM?2g{h{i;23_>8fGNJhL2l)H$;Y2`d#0<a+
z*Zhw6Kn6o^rYKb@?ECUQ?|oJbJ6OtKZ{>mXUI_Qw#Q4Y|2FE2UE4PZlMM5DL9|9i_
zwJabI4}1ZpDZer(W8Jm4+z0#q!p?U=U4iEzQ_)s}>q<rTz+s0jC;@7T88{&G;I5!H
zUm9tR)q<Ke%aU}zegc3<$i%+!KN5d)iZsu8t~SP%xIFWS6HInbpCjp<gxczz9|*iH
z^HdA$IEE4bbp+ZRtZ-%VoJ26Z;o#J<O$JyslbXg&ZQt|U^TZFNx||H?_8#QoUH*al
z>-4*H4Jr*ok^~*dGvfFr8BmukB0!S*HqC}Jh#By282}6~75|uf_23PDndBcFYQNAC
z_H*_E%D)g0>V<EInc&*)pd7}T#T}oc>A#6Kp%({RBWMl}#EC2xRJKNK1Z;qxFNEln
z#9EJA0s;{*a_P-4890H`(VpXYAYfNqc#mL6sL;NDJIRTc2-hT;)JKTHZzdi0#AJxe
z1vz3h5v~)NnB_hIX4~sC#lYwzG7f?>FE+vN0U@M-9{=$L@Z+ozf({G;M3_g!1h5xO
zx$`NBdK{=E4B{hm=HN$h&d^l;1!V(J7nrm12RgH9h;#Q<Ah<e>T7on{BKJpC<BnHj
zplHaMC5OaBmi(Z`K;Dr+?*9--AZfNAk@%4g46^0MJWLQnnF9fbshD_dw;zIxu{S77
z#nylOn>HmRrN0s(;iMdp)EvzYVj?rn#RfQu{5g|g_t*GWbHlmaFEeSlA(^2CQq>#H
zZShs-r{);P{z^Ry&^LdcFyeeiiIc;~Qa++YJ!)7eg4`J$z@Xd&e<gc*mLoJ6M`rlE
z+*}UwV@!54Lm1eMIwRnuL`a44Aq>v~uo5$@^+F?9W8e}GL}2iP;~oS?;z0+34+Iwx
z@QvaD90A7p*87TP+(fV;e-HnOG5NeclN=%|huqzv0A=`+Vxj{va8ME8gNRs|Fbu`P
zfM>!mV0^y?A|hbKB20AKg5iU4(;I>bxCeSv6yCxz@|(cM>Up@2o4}878vS7aKri@n
zO|t+T1}>=laRv0f$)j9Bd;-3h58QcpaX!D7!_&{iOTjMZkq7Lnf&o5d<ES+Y@PJyW
zF}-;5V;adbUpyy=i15fu2r)Fk2m?gaHII0OsxwPIcg10tyheU1ATt+<gBU3hA^r+s
z9{^G1x;+HDFc%0t>8SF#a{n{qqJzOqf3lvTb(ygidDs`VH#_x*ezxZDhkk`kf|+7I
zm=E&v({~X6s(44i1wsNmATj}QZMmQSfQ-+doCLm22T;I8Ayq|pD6iroun{%Z{(r(e
z9&^Oa!|5^NL>E8sj3xN*uoFFVm^qc7r?qMBJWL}2LcKpQgn7Mt;1E67cAMem{6qV?
z;F|~fOrt53WipJWI^saE?PJ8hhBz<<C4l>BniVr}Q5WIA03-G258o;n7ltkLL*3AD
z?yM9>bPP8Ar(!_1*`2mu5tXTi2C7f=zwluQb<DW5^ZyB%z97!vHtw2Zp4A<7*$?}_
z?boFq^5K~vf*j3Jph6M59T9jjh@XN8N1n#t8024Nl+wNmA^zGxdtIZwO8OM+U;r&U
zNDch6&-m$Qg*eF{<%0muE4V0!FzgV4v!b61!tjyF_xLD=EyGIsT_lX6SRSu`W;CGl
zAK=0Y_;wauUIw8JxUOwt)oD{q4UV2~heXH>?<7EGNGO{Km^py!mWt5=@bFOx^Wc3m
z6`(-*3&5N}f0~)3hCHoQ-{8U@^blqf27mxW%6J~}0A%i4A2$inLD0b8wyyY}kB>A%
zq5tuQ>OWLC{A}{|6TFz1G4dby$O9j(q44GY0L(p75YOSoF$B{80ss3T2^+ZE;C>OF
zO?&hHIyOrNIy7Ua;7s>Jz{I<$Ilq7^&zm#OaFIMu5I3aoMZ$RWjU!)<(g`>|Dms|l
zyvxT^9wHRV%&dT>SLgXzm7D_KNImadPmZ9iOngKWVoQ8UWE@&akatNk4lN|a{6K+F
zSW-0n<C&Nv+IjdV@ElarFmWlSVWLrz&E6m<kD=%c%phJMKvRJu+|P~lyxN#!Yo@>6
z|HA2HE6q({Xmr8hIfc8&K8xdlH!(>7@3A3`*)hku8v83Rm%x$eJv*^OZdNCR@cH3o
z>*%Py6PM1%V8`0|VU;ud??E?b9hif&9|swTJ2Cgh;DKLIjDvu>GGJTsOJ{waEjVg$
z4F;o<OOS9E%$We_){bQJ;k%80190Y~tpxQ*1}AcM270VUgIE6<!GLqf_D#A7v$8l)
z*SidN1NQ%O5gbfD{GcxXVJllI>(BeEO&^XPpPm`HhyVYLgj*&*D`)=z(?=RJ;fM^C
zFnEM7CPW5S@x#4q&Z}BeC>N!;akgXxxHONv>6=5>jUuU~o>XZ}e7yAs?;gH}_xW(l
zoNhHrssQeETK2u3A~{B+4b5^)LE1MFvRZt<uIntOxfIQ1lvKPBU`+8Z352Q-I4$cg
zvY>x8?)R<`3M-4C->;fq@G|V1&ClRCxK$;<+#&uTJ@B^6om>Cyd4iXlvzah8Hklgp
zcU&O~Z^cb(Al0N_3EoIB49O56F9HSA13LCJG9^ph@Jct)i7fOkv9F~+_}vE&Zo3c9
zUNR$wl+wU<ct=}6e)|GTCFUSF0-7!@2M!D811}f`E%CXo^lfZkiH+v~X6Uz$BW{r8
zlbxr+09T<bQ?$kWR5mTIbrFVr62rRMQ86Yk1KOhvg*+n3%6ap?NPx_oFB2a_--l*M
z&*v2JEKn9t0l!4BOQg*|0OaV&J_Co;(A;i|@LRQ!OKUL^yUC2*fxi#kvH*J~>M;KI
z8a^alp7X#9X}Y5yR}4>DYRLQMaBtX;zGnvgjI!0OB+e}%0de|qmYA5@;a2x6SFkI=
z4_3g>Phd6VbX$;*Ix)}9q&%>?VDTHcAuz-@Hkba;&MjGu{cs7pgU31xrH#FyH}D9b
zk}>`Gzf3Fku|XAnYv+F^CJcOs{y#;%0BrV>^NtSWMCXs-t~dA!+myw=z!lAJ_)7vt
zX#ETrQ=c8t`hFBUa(+60@AwR=#ki3KtxSIq1OZX;5fd>6P<#3%L#{s$HJ^r791rft
zMDUqlm6(_+z<aMox5o^3(5}hAc4*Y>d=|iX<hiT7!LQtYmx67nsR!8c9w29of(4m6
z^eHd|EU@>rcQ@v8tN#U*ytVZ5f|>xy<A`Q=`!}U{h)ckG<k!HJtPJ^iuL{8n`_bDa
zl!-Bjf^2Cq2mF{k(IZ&*VK?{t-~2}-K}{|2##_Yjh!rG+-})%(4MGAqAOR2wpbKbH
zx;0)OtA8Hw^`U-7k9$E<QSXZ4Bk+s<wV$~AC2|-a&f0$<Jq0<rVr^%v_RsLA;k_}6
z8hUnT=c2QZXs~xZOzxtc@_s+77sNtVbPl!TNB_H65FD5Gm+$ueNH7e`$-6GQ!U@4!
zGR}<f{>eNOEYX%K)`Sz)c4}+<AEu9)#9+^l{uRS8Wg!!G2l#_kV9CG8DXV{y3<EOa
z2^$s*w*X9C+7DC1+zj@!NoB908|{{Op?^p{PqZOu1KMaK#7>&2wx9S{<3`PR0}P+6
zKl!KQ8FhUScYpJ|kpY<^1QX0@^&$9icq*cP4j9?eVyt172fX`J^nfv|m;iqMxH<Nx
zsaI2v1h(a?|2$$IO^)dw`0Wq*`qRD!d3&)h<ix>%j(%Saq@a+G!9b|e{$vm#_C0aK
z0Ra#bt?bvWMnAw8@-0js5gJ>>aYvSXp_pPi;x?X84iEF&TtJQ)Wr{l~0RU?8B0NA#
zgj#)kx#9*|J++>~C%LiTE%#gHzQZ8_oE}0+V4)IIvIepINpy>tfP;YlrGTlK{ZIc8
zP7A!U_PBu#L1`_2#CSvr1K>sdVV*U6HZOot;$i51eUZy=MGe;QagZp#`~s;XbI<bm
zgNy(Ej0r}V+M4q3!oUA%_cs40m(2zNnZk+!X6gC=fG%u|jBQW+kYE{u6S;XpcmN_A
zS#w@4lBa|~83%&Jcg+Muc1;hEQT_<Qj=2Ce|HA^>7F8dt`3P8y_R9XVD9V97p??2C
zH0BrG(7XHi{Dl=EN6o*oWbT88FZ2HeF_FRSx&Jc%c9QL3Z$|n7qbX@r3fqySJ46Mg
z6(&iBz%^c6<2Qh5YKlXj^pZ0z*Z&!7y>I&l%W8nT-+ov*OqZ6%z;GFQTwM8t8m#$&
zu(7o5$^ScW{Ty2VuITT-)$qR=<^SV7fH*W?)4-q#|L2+fo*%xc>F*30Wkvn=<*r))
z)-gBcW8;6Kzn`?)hwtrWfPj<urI2I>bw=y|^coKZF)$4lPS!8}&yAPbcmMvL;Pc<1
z3&J7-TTrZ=d;Af;1^94)5(NGbW8RS_JOPJX+yB@;7&b5P5Dq2(5%9+h3Am3C1rdG;
zb~=z{CO?u4Bm6X`041{`dVe)8^3A{#*q`Hg3s|SS2!ePPodLK>MZ@>NO#NH_hk}UM
z@Fn>$#g!5RJqf}<Y-%R~kIR1WH+H+F@BeGTbx@>@7qxk4{okKlbm!dnzuSQORS(w%
zB%Pyu&;3P=X!wF(;G#ATd_0RT&-j-~%6~qQ49q|GgaLe*>D12))?1EO+~<+*14p4h
z|H^;sVTk8J{Z3Y2$>oBGtO2WX&8th>G@_nirQ7}A#{2}M)&u^4o~*s!enuR}Xm<bD
zy>W!ggn`S(W1<hCWX4<g&ryE)`nT|V%B=SP-o!7@)w1Jj_%Ma74J`WQE21tV2{JwD
zGKNTFEB<cj`h(N|lgq|HCS6E2`~5<Z+K0Xo1+CU50JmCm^?})>&#K{qLzy@7e>eHG
z{w6oOKs&Cdg17<8b304f39t`p*wcTS>qFZn{?`C6`hK_T|01&Q`ffO&?$;^9`29j2
z9;yK_D+l<9QkfwaHwz7Rr1*(S6~NXmdYUmxco-llWjqQGb?}e*3t&)x2ISis+eWAl
z>F4~oFo}SIy7lk>?x<%Ps%!gA-^E&!px=y-f#>hvlsA9^w(U)BYxo=!3v=KMeXeq6
z-%I!sJ!ijz2*?4{>x=*Iz#)SqiZ9?-s>!#1z5p<tsrNildQ9((%PRb)Bd_B24%_(~
z?~Rbs9sXuFzK4E)+DTWNcmMi0`u(A<|KP$l8Vkak!5^jsbmZwn*ZjZ$Ag+mq!uc>`
z{nu;$9XMCtj(iyU*KOb5@QGjj8teYPEOH4+;Fcp91v743E#RO`@L{NpK@5H)_CLe{
z%ha&)@|O4tG`na1$Bb;Ij{m9t0A4yAj^mB`;Gid!cSw7y<3roVL_nB~krQ|%c&xl!
zKL{)T03~p$y9n3*+s5D){VMy{fJ*YvZ2y1dZ}1s#G!fc~N<ZO1did=2*`C3JvIoWB
z^9U+n$bKvQ7{WYv(L7*)M$6f?toXA;Q}~QV7<h$?mJECt%Z6pjX#Ow5cX~8Af8rwi
z2}Mi@b^-R2m`8q{Ui?Jc#>XZm2<@0ek;}`1kigt_mhsob*aaJOxKIb{e&2cpUU?50
z@dGpSKq{~EW1^OcCm%1H37&2WV(AurB#?ey9`}NsM1RDF0R(Mz>|)_T$dSNx${li&
zR9Kk3f5h_LLjMFg;y>`fEQ47wyxUNsqbg3T^m^x*Oz#LmBq96a8!a&cV!5}ah{R%e
zj}bSX_&5bPQBbJl9rY(wb3jJvCvhCaoalVY7ohP2JQMVKP9^ufe*i<GxPbjBHK!8a
z2qbgv=tKY7{s<(5GV(`6L9G{A{4r2s1OQtaz-M35PyJDg13m{TKpx1!38r`{0st(*
z(EP)4r6#)T02YO1E+Y;i?uGFQ0F3;Yf5g45yM3GrxCKB+CqzI2+h7jhfDnZ?-Jn*{
zLQI=}`}_Ob$M2TnRDt|9yTBu9_n|cY17akfk@%0u_s2r$K?GIkS-`PBKzdw{`-Q7+
z+yE2x{9fCzqrd^>bUq?n<}aJUVJ43WWf2ITzl8ZZS;8z86rgWgJH$uX|DF&TTPc`m
zQygg<P-0;Se|G=*`)1+jY1amy#KLoZo;oso+2g!;f+x^9ZV|_oV9Mbi5e3{+P<sr4
zgN9b5;P_7j|8G2S7k`ED>1mj1UQ2FBo<Rzk`Z7AWf3R6zjKA>$ZXzQNA_G!+7qjaR
z%zMiW!7qjJGVses#DsaVO+ZYfH`IqcVMo*p^`H-Cx;^E=Pw-a|CRl+nSc3S~6i0~s
zyk|T_M}`1{;sRYm6GjBXa1h}B79A__mIV7|pO1jxl&1tIfShy85A{nB2m&5B6vz;-
z2(aAF(^Cq?aF#SO0P1KEo-{a2*iwswL-?31@CAkKBsdc(wgMaEYM=<7<{$GyoB@LB
zAa26zfglP4U;+1zFPOm$5Zm{M-PA8od6)~KdXv-^nSo{nreH3?fD>b>fKM=JFC9bz
zQ!YTIxd%sN?7?GvAA+07yF1D_R=*QBhVHi$9U4+26E>xV0;ol2^~L?u_-^aF-|w53
zAHfHAg%TB*OtLw|23YPcnB>32XW=S?TGsR$yHbU($jJH(-&f)yeDE7Qg9bh_`6IyK
z&^;_fCn_zdo$Ku1@SE+P62R>Yp~aKTAR+6Gt=w0y@$wFrBOb+vnw1B&nfR9uxj;6*
zq;BhqHM>-w;=6~I@FC#YTb6N;R601Hgl#R%$f-w-qw_asOHUJ$BNq@RHW<TLMtF_H
zc#e07i15HMCIB$gwd+0nOcp?iS%Lf6ajE)oJwhCKI`a@QY=>S~#QI2g45Sf|`zHr{
zA=2UjK=}Be`SSpgu3`USNzLc{BK@DI@c^J-^2<0N2ys0`!W>9I-V*Veu^|C_A}-IW
zZ-E~hp#OsqKoj5y{;8jd+x`HXn<QhN2rvN+s^3@ucW<m(@72Ld7tizr!G{p+(+*xA
zZG+Jas3~YZ({%+c4@|EO_8-O@pkQd8JD?fNBMXO9fXt|I{7Bn}hY1b``l%Wh;SEk&
zjoY;St^^6}eW2ijlY{IH5TxSA!GupYKmmNk0aAb}&xu8SiPk5|05bS6At=}d2J43^
z9lTBN;6Z-9K``EpIseV!yRGrw9@N8DUw;HGJg@%vEXNu_DAB5XJ0=toc|>KDnEb}I
z@zrJ0<~nPRV<4@$_i`NP|A>VCGBTK+GzhqnBBKFo-WeiUlw`>`M~xc{JDwxj1a0ip
z#RGJI#6pk<UL2hTRGR<y$3;=GLFVkPIsMw*HDlIV=j`5QZ_Yx&#@4ynxiB_o%-OA2
zv!^pQ3+xtkii+^(_dkaN51a=$5Aa;>=ic}Gbr%=S5f{b9&LK-&K_Y07(oe76!pYY2
zT{h!h6wsGux^#K079CgWhZ=xaW8WMwotTQ&aMeneO5LNlb{*;sK+n6d$Eaj}ayO)M
zQt+y}Oi)o|Z##@XUmg$5$m<uC5g=E8UP*lm6SZx(#5g&M#|XIpl|w@ncts!O5L9(t
z%KFI>L-z2n5;xT{y}%Hei6@;?-<O#MQMf!LE}NtzF#$O_sgq>slkC#|0>7WtP9I4`
zMcnAVGCiV@p30K)!8l8|psv;vt?oZbq0;3U?S5bd-$?3&vNEjo-+B?mfXA_E4<RW5
z;#5G*%RC%)`J^*@1yO!^6$k+E#>y_~YHMD23mM-2z^8HAP>y75HgU|`dg@fYr>{@V
zqT;}r`%H0$aI1Zggkj)i<WsJ@)m?k+ILL>{mkvjhA(yD@O+O;!7i*jpC#dV`ADHoJ
z84mtpU^~?Yc6hfI1JIK?Ik(7H+;`~aq=iSY15t=q>}i|gC%2H^@Ms;QKv%6A0ZJ>X
z-I?+S*nnN3>kBK&o!Ww*7i++Tz{+Ft5JcNeA<oAR!_|QHk>V}sz;hy{&{;JyGRgBh
zy3dO&$=>|NuWsjQF(1M;EHL&Ck>pyqT5uAV8|Ef`y<D^1y#vuyRD>U2r#_%(mF}G#
zplI0JgK#S}C(Xp(S$d0Hg+pG*b`hQ{>s`!0IB8CAgr@^IeIG{84f##Mh10_y1F~ke
z9dAlyovrKNabPhyX{L??ts1*ioP|Meia>Ta<3;9_>Jicl7M<6#=0wuy<$Kd3s@6`l
zH3L2q#;qZbrcDJ$5ek{y>^zUH6iO30@k)p65wr5aJS#Vbs#BVUzL)=Gh+U167a7L>
zLX!>bS1ns14_iTZGXxnFgu1`5X21UOch<f_7t|hsSTETjK&v6VD>3_X?A}C_fiEQC
znVN`HdZ<C&yj)&kpJAF*2#p{miiUeND$Vz`qx6P;lJY}teH!k_Mq=K5v!Vb!C6Zv~
zWrq2G7}6l&NTl9<c9Ogfqe%++a`EBx`jPgCnRcJ?49&mScU%*ibC!Q)Q3_D?MP>e|
zq07oa;qSHYrt#DZkiE&hsm$B(1^^2-rTTFHOK=*Q(IS0xv1_9&R>ro`EyX~KYBrO(
z*Ee%cyD=#8g84<M2?@Hz&3HQ!gp!(`h=tMFDhH^zSJpb6o4Yqbrg`Z&Ob3(+<RJ~T
z(wQ8fn|q!)6@6{bs~Uu!GXRWr5wDA(q0w$>D7n-Bo@RI*VGvYg03j7>q;ke~2ld6n
zgot;RG@iRO&Ip{Am9Pa6qy?a@Sbgr4lDg@|S3m*35^tcr+QND<sYA`hT}w<CjfPU;
zlwtn3EAcWReSMDwrnm^Q?n`Z7f8n0M2(66hQi=5<igyOez!ntnGkK55z{sgIgRL}^
zvo+!FdER4O%6#(wy8HN=KjLu{K{>Te$N6|SZvAfv0+q{<YpL?#5550j#-G4o>cAl!
zIZMS$*0u&gA^ll0`1ZIF;6dfJm{r**GHH|jKRU$SDRS=E*#?f%R+S6kT8MR5oJ*FT
z30Dv3Tq6Qkux3@1Dd$QMkS+NsH^SZ6jH8U>!7fCd49WdEVZ!aov2^&Jg2H9RolIFi
z>rtIAU9tK!iN8C7{Qd#$GkS~Jb8@8T_xi)7f3j55F^)59EJ`_wiE9^#=Yh5MN4Ucd
zG0G7nFq>U$$*AdIHBllxn2+SS!KxeF<}<z7!%p%mm>PSP^tEZ{Fl}xklPYw+FrD=+
zDc>ku#p;%CMTndFb@OYbqHbaOiG1UcJIQiX%%KcX-Iw{w*@n2g{Y4=qD30%~E1yg&
zgvLa^^tSE(1GE44&P}cd8We{+Wb8xA%Sm5Hm&qBMYFm7LR%c@)SiBlR`6bdz{z$bX
zix_=jV1cKswrz@-bFgyI@_92yz1iqNOo?Bv`P2we1UlkhX$xlkfbtHvk<RSzG|ygZ
zqaEKV4vxBdb1F8S&;KjDQl>_n&3+BU0GSXx7h+d&75kk2n-l*ie*WN2p^1{CD&ij6
zYl^@AeB%N)ug?&POaf7OkOjHX?*r~eSMcB3wkz}-Kc4S3R>nn$O!T}o`kB~$z~8eX
z+ct<5lvn1=kszkf*MdTMe@D8RuHIf(8KDbMIhWQvMW2xq`vw{AM%~t?|JD$Y>$_ut
zajw@f3VFE;db_K!j7;c?vE6*)|NWe9LhQi;k#^b{Bm-Bd@3vy;Z{4{$OeA@RsGPzc
z2`9KCp_>XHFpk{yGKD;g{L~PiLyVwPQP6o$JV{_^lef@eY5|GLPKCTBX}s%Ndr4Tj
zVF&p4&g&+Ac-P}ejbczc?}`<Wtc)oxY9(agozxX|=c`{wI@2L9JntEd#Fv0xYxU#W
z>qOb_O#j218jNsD;g_0_4?`kyvLiG9{5ul-ol<h9?6>Bo=|l5Oi`!+bbUb97x&~Ji
zd(hNZG<I-VcZoR(<s9D;5U2QRYSWfZ(#J+^3^_t|23YH)zYPZ&_GUI(E7z=75k3gi
z>`W=v$sXeknrlBgiy)bp1?AbL2^H!tidX=MZnp4bY8wv_7ruP`UG(=*DUYLp()(JX
zD*g@l=!UY?GmQ<(o!~<|$|>pp4q0arb959o3UQEG@Dt8at?NN-GWFIh$nS`(LsgTv
zcTkjR_535SQ%j<=6~MRpya<H*Icdt2x5aPYKVJfmwDJuS5%<IgG_the10q+z-fCK~
zrY?T|qH8*4p*v5};${wc45b~*xOfk1<_y|rvnborIN?_qv(f$o%8TX}DUlSD9#($Q
zL}WL~29x{jxqy4-vzOV5#ei$u83P|8QT63DmH@Kfr4Iav2kV&gGLf_1{GDobe#Jv9
zTv;=1N_(utmm_jx&?x_Qo#}36uBYlx;J9FzJ8R$Kw3^m05lJv+{j1>ga(qv+W;Q!!
zomlwu4#q5xrYK>(ga&#e^uiO>34F*vet*egjKC;x1|r5s!+c$Xe<**Cqw*oh0{ce}
z8%=}8JHjIe^gDeSvl{dPx$w5V9H}1PKW6Po!<j^;b6*{nOa!JO>dt?(#ec``caewJ
zs|G0Y4k2N3Dd&PGrAZ~9KDKmiZEZcLX(Ene9KK#Z9=DYMN5<Nho!jZC$WVp#Zi06>
zI<D4+=y11Mr0C7RYhoNnSehMYj)5C7=(Z{1ku4j0+iL}C@UJ6!7uTMq_+CJFgH7~I
zhDjLTD>GtsrmPKrKegrCAYXR_m(9t$$4^;C<0JDw81bikkbdEob1tCtU%S2X*IY*c
zVo^W|!&e=(M9w=w`=}v(wRD+>@>ZJ#k|qeJgY#bX1IIm?Av<EL5<WrntaZYb6K1{q
zvOLpC{Pb8;)0$WTwtfuEl(Y)x!>o|c=(z5hQ&Pj>K=~#PE|eUqi);=MC0Y3ez-@4R
zlU{O}QeuZfyOQs^5Chy4X%>y(cSS;lw6hvFkywtk2F7o3VI-qWc#uo<hPZc8(!r5o
zo_e&pgYrHWPxjvft#HuBZ2o(G)0r}ivkKKqbMA2tIqAUA19r-oa=rRYLB*O1KiTEo
z&saK=__b2Vf$)eYV1>5PuNvNAPJ<Da<uZ~Tpwm1ga*eKq({$+GTNynk8AaB7-Lmcx
z*|&4{5eiSNb<Um&nne`3fB)E8%*(uTJ9E1Ieer4)w3vt45BJgPSEEZtZrW21?&;(i
z5^-9P>h`;U6zIUB-}R(f0(n``u|t0sv)28yWAuqr;)5crOv&&yfyM9X2d#4C=t`=R
z%&VBndzuX|hoAqlM^_bLlwwJr0EFJjPu2-$3iY%4eY@hZ$<toxPY5z?ungG(pbJn;
z&y{V}<BdqviRU^ek~OH@o$NNcF*~^jZLy$^ppjXQLokpzpnCcl$w;@KdiurHos#a8
zbcmhZ<_Nhr=xMGHA7EWGpm<#GB*N&9(8`bn1p{@GK;#cu-QpFFB6EXezM#Owxnh&z
zSH!E_ypkd$^ge)H0JvOfEUfhzg%@0PPK-#FrC@XYXN-ymJ$a-*owz^WHX?Wf{A!uh
zI4fsRDm40aI{xe`@8>uK@+_C8uJ~0o1fxO(Tg0X<sh}30L%PB-{OaKUs{hOQU?pKy
z5g(-||MCL6B$Myq@<Okpy~(rGhAOO3;nw#4o?r(4j?*1Svi{c(cz=vqyJG_S{(+u(
z-iAcM>9GIk6?8J(@k5|f-*RmQchhk-h%aNpW$@(c^ZHR8W<lkMppm!i0|ua~^j}}k
z^HlGQ=!?DZzIL`GQG-E?`t<WycKf5SW{>l!DSPA5)nQ~N2lThs!Ms%exRj!5Fq0NN
z=XvO!A*vU`E~6;|a!kt4dxH)ndqk$aNCm_fJX8c}Tm=FArcFS!FNzRMDRoaM6#}*U
zM;4?@bqFOoa}QATPde&8rwqEOc#_#H8Ua;^9g|jjV(Zf~M*qp&@Ol_EoX_U)ZGMG<
zj)iB!t52*e#!M*o%OZA??{631?af=NWB@W#KovV3kj_9I*4w5nPiw!WbyoGHhp#_}
zILXhkff8fksVrtwk7E5>Uj8(mEy?K^MRPRjWY%?JM)^p(DK&FiegUulSVF;7s8pWH
zoc9{9FUr9#ost?7c{4RQ@+M+j3uXHu=|+_AH#p=ZxHB591$_96<|>(oE1WyAq3IGJ
z{tmo4?_)xBI)c&Pv>`&+S7Pi}Xn1ovkG$6i=k!c<zYh`L<-%Gvb^lyaqwcJ(N@Z_t
zlc)j=tq4(L!vmg}&Z)`IqdfGT=)PYsA3}_Do!CnV%qe5$QT|3hjf*0ylA1%~jj5rz
ztcme&$+c!KJJ!Q-BMTqGof-Kh{?+0WC($me$xdCv=L7*osFf~5sWeyj`-ZWWCmWt)
z@F=rhYHa1Lkk@b=qTq%L8!v;l-%UZ3aaZiB;xdNnHKiOB@!x{tZ!xI-CmF^Q{V@^2
z+*<kPR1IfM`fK(mALhHCHSpo*O^o-nxm@^oWYu6sX>s?(f7r>`VMI!a(N3)CofA?T
z+2>W?z8=PRNb;||)#D~=GmUS|icJmM)1iFxh}eT`QrMFLi+GR_Cr$!DEV&D5EZvtT
z^FiQCSXN=mB8=aZG~`@H=}N#c+?idMrY|TJtd<#*7Sjf=tS-@<sMXLO-EhagwNE;-
zd#!#7Um<k?rPRDR<4-+V&&RO<&3gCu!CbFT6eUX4JJ`1h)lIV}3#2;H$`_3ThAz}6
zxdb6$D-n6@3ttHiTlz6DA&Za+hlAWt{`IKCU~1osK!Z294bSLLMXK%so6_HUQ_mUX
zq-Melh9u>#uZaC|Qkd6N^2!yOTBxjB$cf>M%$gso7zJFqAR1Y#5uiwxY<g+uz+?Fz
z+m}D^b%F@`O<qHxkbXKRD)B`7g(V$|DN?WQ=p~?PC*0cx>1nyX`);~!bm%usIPPFe
zE6|>YJ4vZGUQ&Tg-t#*NLlEhfOiV2mt#}6~j=k%|sPjiVDVq^-=i#P;OuC#%DC=lm
zjcm|!?BDw<el!L9e7oEBDM>|GX`cDXytpYfbty_F@cD*?X)3)Sj2C_GS0{IfHl_gN
zuWYXTW#)6)<{hP09NikN&<Z{l<Dye;Dk2GlPY;=V(zmPeCb5_>B37XO$G6W`WAd^v
zlQhAKeDe<S&hbkmR;88#YdgQ^`YsUFWl#{HF8ogagHkem)bIJAJgbtaZ@!O{U8~;;
z!bV4eg5HiBE*RKYkUY=vSXn1cSvP6Q8zJiFN#eihWN*asB2TjShw%i0kanKqziCqg
zFmhJPs2TMH688Z(P0Ig`+umeH2-c@krFUno_S)^?O!)X{0Ax0TvG{UO*ucG1VtE8V
zFOxTnnqWaiTG~=vMF&Y~5%Wk%J$E80B%jAQp*Yx;sgYP75w8VHl8m1jLf;cnFjp#b
zXBi{N*O)tD&ogey`I<q2|2b5;?I&~DsFS_$XB6t#E`FJm%etUAM?aD3Apam3*<*d@
zAxNb;6i(1sPL794Xd7^^4def(N@eG#FT(IKR#X(s9E<Hg^joClehRO)zWoCF+YMVw
zZd1qs$0{Lt<DTTyi}s6EE91HzVPViwTWx|zoMS1N>7!qj49#k7Nt%aCn_xx<Wb(i$
zn=gaaO<9zo=J!-cTEvj~($Df?ep|+ay2j7wN5w?;8Scf=*51HpPoHGX=sXX3Taq{E
z<+I3=wLBCr%)imrCK|9Pkq(hRn>1q-w2E?d$`SZq0VlgqFuYdADqD}fhos+QJa)6v
zgT`a@K_l0aL?Qj6kxBfW;DBqX_m;S%CK40e&ln2DXqrANAuZU0oJm%H)BnA|2kB`e
zw;M<(?TM>4`(m1;ko!HS_Rqr(3Rb85S9E%!8r(SR8+Y*f_HkK)e{M@GEP+lp_>2sb
z@1~c$x9B9>ee{cX-Fv$eX}(#OJ#;|?8ACCWLj;oPLz3iLQUH@SSn)=!pX)eWW>?ku
zACD%AVNH_0;OkCuhMgZSN)^5yMh!*#K+cEo7GMz$6p7t|)f8dfn2rbKkp?mBIr)05
zd?Hz8cg%V5OPtZvVBt}THtH}=)s4Zl9`bY-QprNM6!miWt^QK7sF*QlA){)}`%(0-
z91<U5K-%NnZ{*GM&K~Qj6Rwpa(@ma&6I6V8QGAtg`7Ftce(_y5=vIWfzF61o)8*rb
zr{h60&w9?DZ~A`KcFJ}5hlxk!HI3R?p*IQ4$Dcy@df&L977Xm~lRFeGiLjtJ$y=Gn
zF@EJb^bXd1OCNyI^|2G1QcWSNdb6CkbS~{8X1T|dN6!uRGYJ1vQD1DL;<2P3h1)^1
zOoMR_mV*+S1Sm+qGHZl2-Lvlfn^VYMuojQg#V8?#)Ye*yOh~acLZK(nWTnTw2%;!a
zBcT;9@j<E(Jj0j!T#}&4jgArUeKIQ22HnxSVI<nP^qdolqKQXBfdq`4eo%x=Q~Eva
z?M{ZiPg?d9;4l&Cri>uZXlf*lbMLz#Ki`egwGbpOMMyibi*reZ9_y-!F3BNcocvFm
z{Z<Xu7$%X-r1%Y_S}m($G!&|FmW|-MN*X^rxxDq4JGlsUr-$7SI1)@cP;$QN(N*>s
z?TjG+LCvSqxc27rrlfQpQJevvMYKa64pAg&0f)p02=&%4Bf-p3T*+!;|1R$mAs4Pc
z;2rxkq|A4t_rE1@$00FjWKj37J62P8WpYaXfC$02iM~0!OL+ERA4P*9g%Hm>uL8Kh
zO~~@u24=FbSNZR^^MfKF3kJ`IJ@5v!AAotPIiJ8ts2>|HwHNv+nf;p_f>@tW^Z2*k
zW&LD|FfqQ@E1ca2#`LHtpyx3cd-@AUC}<ry1ad(Rk?0(#q4^ATVIeq^5DEF>|LYx_
zzXdFi#<|}WvL-)_O`p~W{tUUjqvo=AVa=xDwa<`#R4DZ5sd1)$c3{&B(PdO3PU1_Z
zi?AB`;=9vY$dacLH#?W$0F@<Z6FD@n3|q3ZZ6yU483nM&6_TS*qaJUn|JqgiP^uZ>
zybTXo9mqG~Nfm?_*YZvqqOj}&((aI|ySqqckDulOBH5ddn|F@S9n2bPDzzi;4LA%3
z3j{)i^;!#Z&?axPUcr+eetA4muxPz~dUynDe<(_`*xF+0#~G~<pG*WzaJ?xxPr2f2
zJb%Hqsyy7M??AF5vw~jmSq$wJyuTg}57Ogh<_lLS(w&^fR$`s>SvL>gX4=Bu-_3e8
zUnsk1vVZ-@`ng&CXf1>tpB5`RBT}nLsto{m`8md~H0-a4{%!(yyIj}L2Rd!>J}sf{
z$~m`h(UKi~w#qTF@tPd`iI2sKEg2prWM??tg(K(EUiFszt1Qj|F$+?@F|W?JF<*SD
z-XUf@F54B|<1DnUM2j;7Xn*fh(l%_2D826sO&@U(F#BE{!Wq*$+%mivX{xiLsJO}2
zttf&xnG+Gy8Os3Io&rzuph6UC@x`}){wV!{1UNY+4p3E^%o)l=(}PXdei|@n4{xTN
zBpj}Wmxfse<=nnqe2*fmX5Hr|oxWa<rSNy0=*7=4EzE2$ZGWfsxu@;>FLr@0X0IAm
z4E6fn&Q_;dy5+eHr4WNRL#mt3{yZLD|4?ViuO=R_w<2F=J)dz>cxqnq<az0A?_f0z
zUG)Cv?g!0W@AHTIvvQ~UZ$7sEo5IQQ%ev9_?h=fjV=#qm{Mz5&RhYp=bbP88ZWuhQ
zAP#5TEicvx4LJ@9m`kcQtmSuUx|e3Xt&*c2-DFx?KA94oQ(DIgtBj6woK_vyFkKAv
zGL0QR^$xx9`5WzQu=C!7hV{!$>nx|nybzPH2M=t{o-Bpl;;u-&KmFlAS=rgjFA!!v
z?o=0j6KNQO!H%a+gNz?%^ey=5%C2@{{nma2)g4tVBn`VL4|0O<{07`r^U{j|(5hwF
z{4~@?P9P{veM&tWFo;_$6pM?J8Dp1M#DM=!dq*BKemWHFxQkmT5P0}Y?wL)sY1{4$
zLot<gin)gy9}vuk$S`yG@@-zCPgTQ<?&@V2C-6W2MAxdtTbFAMmVe|tPH5jIfqxi>
zkNtZ<VXA!c^@GTN4!hB0Nv;?05ZqcH;BzcpPg?EYmxg+7xqJGR?~^xQx@@)WFnIYB
z<9GBPuYI8<i(y8~UZ~CVwMz3nwk;zgyECJc+g;N3_u;ER>!TE^gXdb1;V)h7LxDXu
z2G-uGu>7X14x0|^8EQMD>PQb~DH1|m^mtZ*AZRm>CoU_n4v(X~nfK_GsQgt`tvDvr
z{cOadmE?|Ygs8gXA_Ur|;~J$22g@+H3Xo-UR{p7=n2yq|9?>3>TKSOy69$O#H-Bkk
z07Y|CIRdO?$M~X^+ci9GUvy_39#HMSC!RdoGR^Gdy<hx^J$9;dS+(0B?DlUSIR@K0
zj`MLjUjRIXQ3v}u9XlTl>>*e3Of<0A@x!|q{)1%lnK^Qj9?V|~2VrDv+9u19o$OZE
zK8sEyz?l<9WSc`2<Mtm>RT{fC8s{-bMBKM$%EiyWjcZiuMLo$YBF2l<eD4sD%aqy7
z&~*t{>vJpwPxFb$vW-J7UYFH$D)~K&l{-p}lRSwNR*rheR&zUClPjotxH4lm`W#yg
zfAa~;(|^%eomH{#$cbe3YT80$XL}3+@65#tKIna;O@#K|*WB8U?~{IGLNfYXW1Ljn
zwp{MFS%6%T$PRcQZT;1|-;R}npl&K2wAk&N*GWq%lFPiP(VIp+ZISqOHvK~--+nvs
zUbPR|8OZ=qUYg#-)<IBcTG?d^8<Vym$b%P>;-H`!wv>Mt<+lWt2`0Oo-GT$hmC}RR
zA3W@U%sDE~h3f^r=4`D395Q9}JGr2`<@rQtl@DpoX4qq=3-$?ZRM%eNYG^^VE+@a5
z8Fr>!;8Otw$c0O)P43H>>)#z60)nV;BjLKDio}lm@s5B?<ctW$ZPohm>S6nha+eeV
zfoEOA>%~lvrquXI4{cK^B$kzw5bJvjiiS8pz$Iqj4c8Z0blH+jvAj^2LA|-*v}s^6
z*DYbzIuHXOn-7<bgG;=#__s1X|4hCy=>3eVmHt>c#$@HiAGe@nQdcPYP3zg6<^U1f
z1(>NY`FOo`c?9?Th0eF{zEq5p$6d4YHj$3lpCpS7E)Ubzu3n2X%;LHGR9ZW|^HqgQ
zseq(bsm>b)#q8F>ZXllsD_U%Izx!_<)Q^*N9Oi;TGE;_{B1cL2Z+;E*d+Xj`9us&f
zy|OH!<$6jFdqYb~k5}unwT+yZeUqGcxw&=D-`?pDL32bAEJ|_h0cMk^BMr6X8Ig+$
ziw#W4zxOWy<e<DpbNB<P)o-Qj%;%sU{`7`(Ki57Ic?fGYSs2`zdeVLJi`s38vBP!i
zZFtj&S@!y}l}T(?U~J{5a(-g}L1;wBO*zvYKCOiK_dPBB^^{zq;(u(R(@!6b8*OhU
z^+*>9f801q5|7q**xy(cOD%Vn6v1efN3cN3<K=YPQQkskSoRJm-je^S5q*mr-zZ1H
zUN{vS9NKShAD@9s5yUPj@EP{vzmhYgx$Q*j``xu<tw{3FX?jx8!Q1@y@2tpkA7;<#
zAEHo9xDP9KNnP5Qij1<R5<}-uXrUDyperQYZS2@aH6k%8VU^2U8>odB-bg7Cr&hs2
zbq`&%Kz2qhaf}N(*>*R1xr^hdL+;E-aA}=p(IN49KbjKPdhJNHLV7=SQcM04HEl?;
zLnZgJW0fG80-l{%9Ah(N;mBN$o84_h@yN_~^csGY!o9AT!t#OB!$429;GsJ)K<DoH
zNG<2a%1kS6<ds%yVN{864!XtxhinCE+-`t$UBmtw#>xef#s}R2D(3;Oy?Z)CeUQx!
z9J~aPX3O`X4t2Zgb0{=D92&>^hBV9X!!d_xloVcni7hNXu?qXq4T_w^iK(G*$Rw;x
zp>eOpwA?(>GVka*3#S+O(<RDLB=b=9weg>5;DP~6(2o=SA34Ly%VX#YS2yR+H;4GN
zw3p>{N*&vq@z7PWh!?RbJZod5Hek5-M{PYc<AJQM_pM{(&^=-O=f-sd&i4V|44@Hl
zi$#AjTH={+PbcZ=baM|6KK^NnF+u-)o@A<j2es-svy2vYUyBn8+|6*lAAV3q60<rQ
zB|EYqQz43K8~#B_3pvWkF!v}c*I$b(h4@!rKNipPufH9c<zrq(GkHRf*(tU!diEMm
z+%k=l3MMn()pD*M|3T*UGVrL8((P=)=VsxgdE>Kktc*>EOIOQBS<w_^d#lAIC{>}Q
z^B<i`prd7{o5JfDoz9bXeYcGfb@sRwF{nwuV^fV_)JKh4Vu|df)^@rsv48Amj1aY^
z+|a#kh|Fcib)2$A+^QsX>b|;mrPo_m34_XMN-X(nt~TD;fYDV$Cizbf8<9AJrVg`q
zUB|^RwaA-MMKrFFlF0P#8PWK+!|F0Tf{G&EyUYQ&bfwYv+Ct;%Ux%}idRcU_KB*&<
zgavOjY5mt!(Gt+e(=UkXdo&tD8dEjh>T_Up(1%N$_z+uUh^ddTAUon|?i$gmJHJiE
zH9=_l(hXg|#q!2MB)A}84qFfngr)*+2d_w;4Z)I5R588?L}2)i%>|6Pq1#)~#w~&}
z2)gsMA^EZ^q*V96;?<{G@NE5^)UhHoH*XKO)mo22z~;+Bz;3B^J>Cse$U*5_P|@?A
zI6!k0>f(9uHfNl@fAmP66GgB5{T=77hqf5hh;IM1b4L&htF0i>+Y3ppZg~%uPzgh1
zUcajoFuEpDmPAN7L@Rzu_(`OBnIQxs_bLbjS@Ba{f3lY!VVVe*?m*0d$01EgbA=?N
z#mJNH?Qg4?V#nYdx?ei7yvhqBzPcFT&`^p^ACgpz%NwOP6%<Pi!hyu(m}z#LZbb7r
z%=lIg_w6O~l9&z4tSV^_mh7m>Swvpif$85#4<n;n4B|Ws81&;=w3W?Hk!6jh$rt_v
z$kEOX?5q>B$|lA2KsUGk;vl0IMA8*cVy!{`eTi`01q{3a@qY_^(1gCmiojwQ{le{2
z&yl#Iw{pMl2!4!d<8n_rp5l_55_%bF`j%K+)e5dUQPaQpIb#1{MOy=aD{Q@U-yz7X
z2sY<^16}<27xpi`$IVLO)xbJ(+UV`0EK`{Fc-MZx(Q@h+U*}?2NMaRNwahxQ_o$!i
zSl@M{r^TTuBJ(FL$&eV@t+u>U0!;8<(p!^}N3$cD1qF=!MOG~8LhMiAd9K_#Xffe`
zNOhx#hXEozRRj_OPN<*Ut|}_9TJl1dypyKOql|Xk0fG45be>KBB=RJNPvRTT3Cbth
z`DrjgOMgdL-rM#3I{k6tA<ATw@=hFTplkU*JFYB|N`FT<(95HVtCU^6<HxX#OG2-p
z0^PVKh1=$JtIZU72i*u|_{>+^*%iy~;DbjC_?m;wK`L={Ffl$axnE2u$b|DSspIJn
zm}P_l_Oe`oy+?X|n>Q7aar(xrW)dxBXnkep*_)D~L<N*%vb@im7#FCxXVNM5(^PG>
zwp`n_b;Gl&pTD!%d;BoBOK(a~$N2ksL^7q-=`7B$x8|2`dh98=LDKD-#1$9M!y$sK
z{OIbL<X7g{iF(6|8G6f4e_OC072Gm7Ts>}K1i~B;m!ay}xybmACtgiwtnAzg(Yn*m
zd^80(M-K?v7GV*b^jjusO%MWCz%jiPzDD@meE_E2n#jf)*!L+?YXkfKcz9^*#P3EM
z^;0S7Hq*4;N*pr2tRZA|1#UCereYM^<Tv{-8gw33&1gq)l@(SUFLK9?dL^7sdvMui
z%S4vi(q=15?`rk4_hs$Z>|}q-qJcrtglU&636|@|S3HLdH}_-?w)*II)jM>&3W`$S
z^$HT`9GzbDGyWHoK#Zc7tuhigY7a!jEday9)!bmr1w1FU`++rNgo7X>)rR=E4XhTL
zzK2|$jJ$Y{a{uxhK19#{?6Wj-Wt1fUVb&)~Fy4rI@>Jscjh62?U1#STGt`KORo|c8
zvedh%OBf=?gLcUqtb64oPe04ybiw-{fMwEonh)E5XS?6~C9OMoC<o#_Pmb{&(I}i{
z_nV3SU_DViwG_waAbtOwp!S6fB%@sFSE2DiruJvxGNj70M2Hj*Kz|-)dy6g-6ON$n
zhI>MhJ-7J$)pPKojJ+%f-p&=lam4lB(K|V^@3B(<v^y+7IITNITXVLCdB{v>jkt!Q
z#mGnQvyc@aU0z+qX@uO!?$JBS!o^w?N$TgU80TcZqiilh&!2=<dYx<mA#qf)ll2X>
zT{grO=EdLLaEDz6k(K}WGRwL<zxoT+|Ki=v8#%Ycs?}+3me{KKavPH0`>76ToW67V
z2dnP(<m=s*RkSUQ_J8{+8o7HS<7wgJZY(nsGS&Wrr7_#<*hSGEU%8R8SPDeR)-SSg
zzjombnOv9S%ZhKlDJ;L>C$C=5+B5~g<L4eGYsVk<jne^=i`(#z1iU_?0;Y#xZ{B54
z%bQSIQ)CD-|L$(z-FA5gI?X-ojMf;mW34)hFBn^Vn8~uea5xIxbkr|9tS6N}-N&1^
zPOaD$$1KN+Y328Km$UpT9QnQ)u72B8e-f6>{ao&*)6=-10aBJDIlVBz;LuNb8zRVy
zc>%5o*qXR~cHwH{Rv$04te&e<hM0d=cV341h(=Fxg7F@%*sxF9I~cT7<<j~eB>qYM
z$S>(+oJr;%5vUr<VpOa&*bnSX?<B*ofv|Y<7jJ6Gif-zp06eMDptoOZ*A;H*gifc7
z#0Iw{`U|umiKy#;WoVwm*n0Z3Ap3hCHaam|-MKL=N%l%){vC*n*NGiQc;VK$U`Oo9
zLuvyGVyi5zap9QGl}0wR%4@e>@wTHRExlm4N*(rS+%&EDt;72%$(X=w;n#x$tsg1d
z8Kr1~or7}S-nX7B8M~&P0xO6Ki2YfOY=FR~H=NVv8(q)6v$bRpgS89raYJz@roPG)
zA^-SC)beJ3Xe69X&Ql?K)&}In?QEcsV|#DALx`V#VfX<D@WujAVrU>lUG9~be%uNP
zi_ITIDA&2;yIUxZ*xAj)zbk?IzX$Wd$X4~fi^rX8-i`_3`S&a6-7K2xC6vV`!XNYV
ztS!;X-qOVI!pE5ME_COy1@B`psAK+Bk7Kv$w*~I;fZt^4>$7wnJN9`Fj&w}j>_<l9
z-1m%5YM2`Vhq{Da{(BV~-Wa$sKHOdHAKhN=h}}q`fb*Xt5?F+{Y+7G5X{<9iTmUlO
z+Wnj{uf?9{x*nobWCppA3;L~G1f`njhv|si9YzHuO+w`ANW@oXG!s~8Ze@h)soMFc
z@7;=j120-4HRLuizHX*@|2vU~(Gx4KnA&dTvR_@t8MhhlPHF5(o)9b$;K#1VTH6F6
z{(2B2#oxoFhOtqDz&Eie94rF2u2fxY^o1YlFy+81Z>0_lI?n9bdG<(OGhoLY+=ml(
z8kF3lLeL>?9sE8^%d42(QZt#ZcN&rtJQqsOeJiJ_t6Uw~tp3ErBa=piz8dU@AJP$9
ze&lB&PBrU`Eu_L<$s7dp@89tuCPcv13RY5UX9KYK8XBHc?oIn+&^Ti=?vMw>H!(N^
z7M>W003|y<k%kWh{AIMs2E}erj{C+up_&B5(9ADs^M{u)RpZ^8XvKP~0<#;-(ngF<
z|No8;L4Y#XZ>q5QCw=XUPe!3gd{{Q+<D=E;z{ReZ&eZnnV=|Y3Yofd9@m0iQZ?1sz
zRY`;h5BZ&qmB*O%?d?H2IS0GumVW<n?%1@=yA1q!<oZRmldATyGt{+OaBQK?FdZXX
z0#4NY#qTQToFD^bPea-rHv6YDR(GSPRtgRegp8%>S&dY`u=a;M{g~C(#XbDFzViqe
zD%sF=ym3Ek{;RAso&?Vq#^qTqli3~o__G-+so>;-%p1n4lUj2ox$z3rB&wC7&|k0_
zaaB`DFOS@NN9WTGi<2P31ou@ExX&y0V3#xtyp7m`TvoKwLLsY6x;XB@qgC)X#uR7=
zagnZLQeXRPg)sMv+Tr~ktxZRK0Y_mL&%Alz{M4y^Fw85?5}>d<zdBjMVjvTdxJba^
z)3DY^iTQb?g~8wa>$*A?g*gwE(2+<UMY-XX@xN+Xy!<>`Hzxtz`EG|tVh`h;8%6ag
zF@}dD;NZ8=yK%#RXQcK2DihR>d!@-}ZQxx}S`<@cp$c2)-~4^WSK3a{bk~xbwtP3e
zH8ySex0C2@uP$}q+boYVdE9jdGqRT$7aSX?pUU^VB#0ob{%{l<i&u5Me!+F;@LWEZ
z2VbQ%2>f#8`)^7U;D$S|URp79oYm{4dZuk}yDA5wqfqL*jP}tEyR>={@>JUJ&$X24
zZ@FVVkAMY#`vd=vaCTr>+#T{3AF8g1j<<Q~L$KF%1bI3uahvd4LNE7^SMrOsCJVty
zC%4x47(md4-$Y}d1II{!ce&9T@-6EV(1W1J(_yK8zdGYYUKr$2KNCh(W2+3wyt=WR
z1(D~E(zM>ON`<g|DXq>*NM5f|aLW<!!L*F3tBPX;uF0YXt0jRiQiDK`3uaz4+}Q~_
z1WK_fF_{x^@jZ-ry=50Jv3gMKJ+Ifzc9gK4z=5MUYd$Mcn@g_|ihpBeo%puqW4{8~
zIy7zbNHm8Q1l&x|nGpBr)ibf4L7jBmJFkT{!Is<(igwp%3GUF&C9P;>jdVbkQ~C!b
zSC0aFa{>exe90`=24H;~;La%Hu*d((a7;j!+PVEyZ}6Hr!sSql#JRz~eV_HuVS6;Y
zy(f=WDr?~t`j*Ti4UA#2)Wc77xXup97Fh0py=morRF>~8R!Q99TUH+?b@CnDR5hM*
ze!z6lv;qAe?%Z<26xT%Cn9|xzwtqI;z%q2izo5Lk*BPyLPW5G7;jca&dGf?6A|`73
zBu;`>p=99Mdzj#AFEyN#n%oh<Sre%YhQB6n2Jhs<^EjvhJZ!hqal3al^_0fF`S)mk
z5jJe$dSGtYu#KQ8xUGEw^hey@m!Bgw2<XL9ePv?X75&fTY@BsI8imVnbNYlFXBGi^
zT2KNQ8ObT6%NN${BFt9jAR!xM_`=NuZPSmoX7n4g=fqwBA~kY0hKu{uV_C?)ke#09
z;JE&ltC&v@e?<1JpZ>$1_v-wU1V_1kBE&mHopEVh*}B(qCow}`@_M{dj*oyMqWtqk
zh0U^h*fZ-o@{Rz-4YE!tyQMY)_~Z{C<o)cQpI{3B!Pdu~t$UW`r(?R!I}hDXidqpk
z$l5tKTUB~yWw^_Esp9(dn)<mm+qf*U)BYf6yCokGmMnVFeud=+(Z{q5_g~eGeOVqk
z^?4RvIX_zStti8itd04Kb-v;1?LRcrNuHbyYfZG=Vh-hJHRUe{qrNH3HU3>Y5^WS6
z_rXTkdK-~wx;7$iJkoHp{Of<iA6#qP&BYz+TDt4v9a~&Jpp`<oY%Fw$(2s9NUpP|X
z#5z*!bfxEZQiUj3PV0NpsCF7T2;q{z<;Igk>1aXqvG!&g7l}a)cZKdrgw~=~vn}?$
z<xu-ot=~7y`91GS5a{=4=R@Dn`#T-K=|i<xqZRK1C#1w`)c)ZS_p2y0;MZM76(6y)
zRZhUXhalR?jDBYwG7^}4K`~92d1`jbn{mvq@utP~1c@)+rv7s8tBthI)Y&~cjfQ4m
z@5t`r(Vq~!@ICsFgcA;04L-G1nM8)<(``jbNEuIUSKjfM;6=Jb>D+@(oOwp%_)Uo<
z#bW6bG1^0!TOr&|7#9?l+_@$dM3XCU>KUJJDg&a4Q|@G0FQW%C#93#*pg$;raIer@
z@A?)F9iIpWQ6?lm<?poDyIRIL(sYvpzWucB1g1K76-}Ku383kuoGr6rpZdhYWY9D<
z8(;BDyxL-@Sn_)q))=NW$I0XV(3?UsJ^W<v%X>}{VChvmy}Up9SXfV#gSomjt;8`g
z+5yfg_w54(LhD?1-txs`msfmhZAFAP3Tv`Ib_%U5$4V=~95&%k$9<X0kZ*y#%{A8z
zbK`}Y0;}D{-+2)z6<Gcf%<W-gk{h+n+lBR{a9zy@vG>yqaRS@HKC9}@5G9GdM`7=G
z1j%)(imB^Wma!)|a-!x_A3Q($+x4GkZ8TXSoPlq4)Z$~WZ3#xs!*2w=NBR<cv4u3R
zLhItZb>(^ThHgA6^BTfaK2s>a^3ep(*=`b>xbt5P%9Ib4(suUg&3Nk^5g^sFYXj70
zT1i`@lW3@x#=kH(KM9ED{8M#@^gDeUdiOzZdCQUI)W2KuI|0J4ZpF>F!-uobvudx&
zzI1Q};B*;F{bT?@?aS-ipaNg+=Vy`LXJD|*@=M`Wem3Q~QFcj?jOM5mz*YHg(YE&(
z_M;Qc7jf3qPLMbG!w`kTpPomzzQ%FGRo7^5d-%<S+PHnm{Z*x!$sL;#%sF4nb<P4C
zJv+R@5h9kzHKpz!G<BHgN{j8Yd*;n`jEfdjX))%2auO1ps}&vX-O?M~bVI#uVD$2X
zcT-Fgg8Vyvj0+TUeK}$v*;9`Hy~@SlRRW`;+C7Fo!g+fuY4!HeuYZrZ$@(w!MU}$Y
z%godT9E@P3T~<=Nw!Hr0aFB4)7}EI4szOepUiYKCpC1!jfRfeq?t@Zbfe-2iEYak$
zy6mJ4Xe>De-^07Zdnoec7)BfRBr<qK1S1hA)FTo>2HD=$DBt^bq6LL+PReaDaZ9@{
zVuDg7^wWC0wJ<^bx{51`YHia5ND2;QeWcI~3;ex-Wq2BdXzo{!sFu1b@@!7{2R18O
zmlDD2T5GL+H2_Db%gTVLafwOsR1-H}ytpnXDC{HuM&;*2pka_=*4@?=_-T5(CG<Tt
znvqDUmZE!7T<m&AVDA425KV4XixfeeM#-sW<0`c8%f&Uz<itZyYKbiQv@zk});(3*
zpdVc_7>!Ovw2#)1;YpJK!}pEU*Fkzcj;%V`PgN=`Uyd58Tt&}mtoEI}x*Gg!;*TOt
z*IbkH5uYh%+0_o6M4dHst`DoLZu$cfaCV*CWZErCq2AllzLv2G-O-_|KQiqJLY78R
zQs3K%&~bKe?J}MHmbgZ~g|b&88A~Y!Dfgl+bxO1(uZQOI>^c(`ca?S6$ee&BJcn9U
znlfypWq8g<%Fn$Wo<BW$wHn;A|KqXOUnJp^>2nyLM}UIjc$Q4kQz5gPCVfHvhb#{9
zj8j@Ye(}TUOy(0)fj<REAT5~Nb0#1&Hj-jJK_Twwsc}&cWU||zBHheB?1$|L`+H6Z
z>Z9H#rGU8}I*f0sTAJYV0{b?NV`l>b%L&HON>5P~)vq6)$p)f3O6eA)W72`aL{_$#
z@Zjs9+O`pj)2OQn;A7&ia0i&#s&;))m7Osx4IxBhwdKGhK8VOj5&*N3J-zV_4B9%{
zL{QhaCxp%Iw~0^d`PxV3i@V~H)Sp_clCpPO?DjtAbaXHyyk6LpUWb{2&EW3ulxBcQ
z4_P6Kp*wsUpJpOTvDx5uj^Gd1=xP#3oQYmox#>H+m4c?pzbm6&-I9fAX79~C7ZN)f
zR47K)AK0pH!<;aFa{pzCoAXj#K7Tdnx0O_+2A%lJ<_NmULn}d#Z=tc&;NitspRYZf
zfr2qI9i3mGofn<assKhRk_J=?W{~x%9gFNEyNOCt!T5c2yw~+EfzkbJ6dQ8Cq)T<;
zoyUEQK{@C(c8c`x#&E6_@P=mRLe*f(=8zad)#iSoOwlOH5fF@Jo;Gr^4Z*|mJIwsZ
zU7{7}U87~}L_s~iv9<qGs6Ntu`?pc_zYou|tAS9*IROf%SuB7RARa;y{(wQOO6|c?
zIG=zh#f@%ITmuP@I%eN!Pab8f?8|$QO6mCmy@8Irf3wmrI6`hPpu@$-LyMU}+WT%k
zaRu-?kV`a%uizD$?%m2>DaAA7Ux%zN+dOT(>KR@T?x=e;Dm|hSBva-}*j#k@;nH{P
zX4U}HX9+TEmQD(H&v|{uZo6G*dW}6Y_`RaOuW3*R{}3~Af8>1wc(@dvxIf~}O^#=A
z`!Vix;&$gmP1Z53w!TourOXld=1HZ*AWL0`+@tPLnx`X{wgonuYortMIG)E}arWVf
z?^2uZfxxplBT!z)>Ok)glq>OsYF01t!bIvOrRyZ_i$oJl`gFKoUkwpw*F2+pqI%Z5
zJK|svjw9fOGw~Ra<9^}Q(4@OWs05#Av}_OCR?=&kLO~$|D`yGq1mrRl%_?~pm<Ql|
zzI%jpNLw&2k_2bb&%H;35qdZQ7(8+rEtfG6tp~7jv*hqU@9s@wX#%}a7c88ZuP$1#
zy-Zt(Dm(qk>mF6>{NEe7)KfBIHI>Z7H}E3{UV;GV6NF;2{`y?V-r@$vkr%Xv#Dh`3
zG8|)%7Y*MTz>z&S0lrGST}O<>3w|omO#;{7s78CV+h%08#zTI(L;8%uZO^VleEV_R
zk7K!g$Fawd@??Fx+s8e!Z`fp#W7al_!j=+plDrS;mb;UrNiJw0E*(oZv2O32ffi&T
zchBz<3R1%gND5hi*5aW;0(_8_Qq!bQ*#pB5LSTkS$~5ZlQxBzl*vk04L4{^_SficL
z;8YN%1e_Y50B#e2M1dSkE#(1+PYUeO%=-U1<1H?=P@}Q2R+_`%;OMfk)r`Nlve0Bh
zZ4d?ZIeh_-!!~eZl99f>?9^_TOe?Pe0V0LqR0<5t&I!_=nqCIr{ba()y|8Untrqru
zNAYFF)UAtJmg}EHR`^eR#;?;F7($Dz40|c_`DD1Xdic6b$-gPt61!Mm{>Tif6lBF<
zWqgqa^spKd1eEW2v(+y?GBE333ZZFFT1C!^_R!U3oYV6N^rsU|wk3#=uLm(&f5jlw
zxE(N8vg1S&|8$u>>6$xsJu)~V#%c$JDP!)en9hVtj3<0%jTGL8qxz=mUBXim9OUG8
z4~TNSLoe}WWTakxTw22*uU3AgV!5u;fd9&wxfQC#uUEcH@ZYzq^(XCcDT{${a>FWh
zV&P@LE}s9(@&FtYpqWEmZ5sE->9Y(b<nm#~yB$~6?B?AK*f_@LzNrt0mD^OO+q5E^
zAK*muS*2@GYY>m^U<lD}qWoAOp<*K_A4vWpiLrssG=;`#1kvsWiR=JcxDg-lX3IW2
zT}`ncGFmyaPmFeC1XlOw!whS*I4IAh+O>W!@oOq~B?_qz!#;yqD~F?9qTR-vd=dOr
z7<7*`F%G)rv8<f|zW8gn9-mu=Gmu2As$RUY5fl;-nsa?ty6(vKu-C{@!9_GZ{9|sU
zVhPOE%l3WeI_ar-U<E;tkmLNLxfVzB2-*>|C9bM2hYuUt>_XN5dmH_{-tW$!{-Ea?
zR!qMLFUx7qK#!l?NH=IOJa@ZCc6(hrLkedAKH8HP&_>Kn6dPh^*~)YF-kj$t{@n=o
z(9@7tndqR0MW_S6`7>4{*r_vf2!v`P8RXeFP4}cYhELd@$FxTLoZ|X?y1(nkjt+>c
zrGNJD%I|qOfK+$p*o`Q{PDTr*;v<!k4JqzFBl79givEHZj(vW}&~o#J+vbipyzXk2
z&c)UEm#neu|6gR5<)E5P<yhqmB^gfB4NsHtcoyE$Z&aUUvLy<&6rhi?XeNBk&;$;k
zbexH5lH%5zT5(=+=Gxu8%GyKwV8?$U8|b8((oBqpBKo~7_t&(28^ZrzUyCl`ysmj6
zaFo5^^}Q`P%nc|gp}{L%ApO{9E^Mi3Vki69GlOENHGQCX4ONjJ>?J}`Rc}s0HkfoM
z!AD<D!Ggxw4CB0C;rn+7HNTy3biT*whPWN~^#wMbep7H<r7kK7>`B?&wI|2|6t?Ag
z0>3rUhU#i_diokhVlxC@D-_AToaRv?U-;1W)HqT~<Jmsfl)vsCPSCc_fl?}<GRfcA
z&*2$cr!q&zq;FFGBi$ald!dx>{aai7MwqmFM=7cia!R!0kEqD=?ZLuxd#9GI%38r^
z&O=8ax_BnnmxyglaJ9Ak>zE)VpBkl*ytTTy4~mMv*>;>gNBT^nUE*U_>O>efjjLY=
zx+4)INU4gq6O30a>Z)IzzW%b3IqXe-PEce3FO&ZmIM&ty>3FSDS=8!fk@&4qYi?cX
z317fB8y`QZ?$uGAjo?c4>(v)3NX53^x}_dV&v-$7-Z<(NGWu(U+xInAKAWFa_8s<z
z8#OgI$2()`bkX;v@!ovGA4RjEqAXFW{jK?lDhm2EVu&-`zxq{|+y|yiu3ywqA-jZ!
z!wa-utr-O$14UQw&sKGPJ^E1%!-Sch&$As|HN;$69EX3G`4U4QjghT*+as0K|Ca<(
zp*tqqlBp+HY=}sIiUP|u%;2yzt}7Gjd1W<<w^^TyB+qlrkpU5}Z0#WN14E38L0Es&
zfhyzdf%n3PZH4r(Hke}6tven}Ph1#m4#^zA$p+nxTK|3%2jE>o)hm}jv{xKo3{Hvu
z=}T=labhb%g4)$-6R%<cNDGe7l`Fb31t(Z?JL+#TGs0^(Gfr?8AR86%4aG9ft8zd=
zkyq!&LKKlk2l`7iMcD{*lNkLW@aUWfXe`$45W3-bv&<La1?kMzvm95uP7z^_bZmYp
z@MXWeBpe~1+4mRMNv|CQu6Z3t3>rjEhW6^G5k$QgWSeXQSN{9+?fS^p|4;XDHz{Vl
zOK^jbBSpG=1ythGq=nK@Obie8Qy8vcX`f%@`|QU5iu$O|c$Lj8*B{KO?U9v&V>{i<
zp%vt%zRdh?Hh|kzdF^1&&Z!ti^8^^NO+GK~rn4kYfu6M1Q-Jf4OlEXS^mf41r-x{E
z6?tKY_;$<GYU-#<V6pZUx66aOx#HKWb)T%k0-+!%!73II%zGc#X0St4jMLO>Yb&x_
zo5ySDEQBLm0=wRejjJ<x>jis%Zk!@=3si0k=z)?|U+CZH?T9+UdofuLOx8pV$7f`G
z?ky%LvWLAX%5OiuUdMXhE;yUzaQ~qt=_V<(%&^{yAMbz@)Mm$9K(FNLb)1r-(jyI&
zyo!~MQ8y-3T~lW^isRm7{427MisDszE5wzMOQ+vDz9KP15F3Zkpg&nxM-akDLv%$J
zys2?%dR4_Hb~G=X<ghYa)PN_?9SkKAz$A21HW%xsPF%VGA5H4kU@tMw9j{$vz-N^5
zhcR7-BJ?DjB$h<n{BwZ*rxnj^P9gq^gw%v$?6})4F!~NL#XGTuOdVFdutw&~o6k@r
z=z<<ov-6LCkwti=Ky?8TvVYL$T8dO3#Zrvg^JFPmiCyGoaMA5K{~mt!$V4KM%q3)>
z_$+#s7;CuOdF_KwLmJrGK^3Ru1t9siItgR~*Q(DyUNHSH$FOpeRmq-7-7JpZ0BPE9
z^)juEeEHF(y+1JC|AI^2rpSjNhhXP<a(xAn;!ZIY3URjIV>**?e5TTTg*$yYB?JpR
zOuNK}J5Bj%9I<WUT}HMieC_mR5<!$-T!Q|?I90gMuCURAcbMl=N9sD%=V&kO;5eEm
zfrgr=;j+LNIUg;HSJwep)=U7BMs2n8JRGhjVAg^Z{<Y=bs7Osvu?SB8ll;o3n2GSI
zlt?@wj$L-ssM5$-(b>pC)-q{0@P9<3&7TDx4Z&nYWFRUZ^f}p~QN{Oo2YMK`aXHNz
z0W^PsUe$C%^nK><03VNumyyPA|Bs`yjBE0L+wgz^Luvz&&JiNr-KijmfTVPYbSRw;
z7!Bf2Iz$DO4(VnRQi4cGZb;Wg4jJs(|9QQ=*mi%m`@8Ep&*SimldQv-15)aWZt=IW
zPLP|b0g3l@KUsUINaxFGD%RW8*QTHd)!i7~-_ENGnJZG~V)|bl75JNE|8UaQyB**;
zDb<$h)}z<r@Q>bKMql-!Q(XW}HZp5B^B(~aDVq^-vU}G{)tH^Ra`!ThyF4-@_^<1*
z`oaDO?Zxh)|5#ZC-ZLko;ZH{MD9(@VA*}2&TJ$g7{s|a#zgRTB1K`Q3nU?nsWZ(!J
zc8#s9ySA7U560cRj;{ROZ*MO|isK_k<}Uf};5yz+gClFiGx$NqRnzl<wSk(wZY`s?
z>>l`pXoK4iOYL0`-<&uyJ2^X!Wdp-g#@X5>3K>8dCEf3+ev<LJy?K@kS=U~Pz1?k%
z{&^F9ULW0q;^@5#qT;lxls3GHv)_QyF=N`>_CEBg#MT0ccn-o(+m2u-v~w!Uk9Kcm
zl?4IsURl2U$I}*^ahlDRTg{E%Tf=uCyuz*U2bLO?3~!0A_0@g<Wn8UoHkUH|xMbbB
zQNM&2IJ`B-;X#A-1K7-k33&B-G^Zrlh;pn+hGd_L;Wa~~dLll!NV&<rSMZiOEe68T
zv2hz!{%c%;+51JO+{%~_(e>C1vmK@TUMRcU8?yfHYW?#a#(Bse-yZz$`F)S5lW+xc
z(~jrjJkd96B6mdD-Pb@veR6^w%^Up@?P>ItbTNjYe%94WyQN+eqyx_nukCshH%-pX
z`fe6FJo9`vN<|{R_RW6PO@w6OK+4iRULNK+BV!SiL~g1c1kwX;C81MruvnR5WjaB8
zU2v|zQ#`Yyg$KT77u!b6@ms3jg?&YkV@k<l_K^HhyyEO=h-kgyeUnoP*Vql7G2e%!
z6bT>jH)>x^O^=a8L>$sf5t<N#OxpRW9y~<U;lGwwBdJ`>W1D~VWsi(cHR(2fX;gjd
z3F-buIJcYy{=@Z3v%eeeUsvUMq3v+%EuMnrp|?Z@zwaAN;oDC?2I)GRZCeGOh|0T=
zd#}#RYl`_DZTrnUxs=)yefbwt=LqU32-cyMcFX{|3;?pJj!43Um2F@^ZS9x5Ttejb
znalTN0l#er{04|XQQ!$Mud$54q*%ej+*4gBgwWLKcL9ply5O(L>|e3IAZMx7=)Pd3
z==U~_-f69PgA@a15Pb*Koqx(W2)SE(d>Boz3aM)wgS&n0V_eWY-b7)8p-O+xLB!w;
zXd>yG0dr!o5>No2#4NpJjMmxO%W5INHUhY;&8hQxa*iGCHh;-GzUhTi3`FZ|-cMA^
z2nkuRaKc6AU(&%&=#Tq(?PU@s*%B4hQunxcGiTb4Nd06RobAd|VESRa6UNwkn1J)t
ztvT&tsbMH`2hhZZ{v3_=VOZ9ZY^cFkzwg4{&+MA)MDzHpS+)C}=k+X-4+MaOPSk$-
z-~&o&gkb<$q>$!fd>=v8!odhri4E0^biRs)off;>e-$SW-+C335%FgKR-NN=d>@0Q
zI$NLF$gY#<ldzzi|BN(D3|4FUuWtx(X7Y=Xg4MId=>zGXHx%+*?_u_9jb8(_>+=#4
z<CL~d<H^J)o^jy654MIF7NJGKI6RowqF~Wtf}P#txtp<JKGOs!Bm=RUUR9Y&@5t1a
zYQ_V`;<NPBqZ0o7191~PooavIGThNM)OU;aCwhz4K8sB!H%H2YGIppgu374ULBj?B
z(zBHZsaV>flYfk8mc}j_%GrAb#1qJ{_&w5w`UfQbxs*g@Ay*(~dHJrOR4~;>X-i)R
zF^BV-3@Fw|CAuwAlogukidzLYgscJEDK7hbMJ0z4Z81$DZ*XEY5q7o?GafK`B~-z<
z1i}?2)9)s&l$choMXEh5QDB6@AH(E|Kjkq+L2vIk%<N&VxM;#Z4Bzd#+)McAZ3pgI
zP`wKYEs97Gm3s!F-RP2|1|^fllxh8Bti5U#HGzfugR3Q8O<(7FTr{ZQ5&j?bk{${0
z^X4*hQ;VL$fh<g4H2K%iGcT$~O*kMTam0jly#MwZ_BfxYXhD0SXOOm2MH@vrbYBTi
zVWP{N@)Xa)uC9I-)qV|!bv14@BkX19Y;%?u@<Q9c&}tI9|DD3*=2m9*buIo)ga{C=
z^-~~0j{r_Sb0ur*V<lV%AvgiZ+l)tW!2~Qf#jV5OA0{WDcd6P}Uol{Z8a141G$AA=
z14L%9*`=Lpeuoj~-ThU|6F+jR%tqWdz#s)A3nMB@_To3=L!N?l7eelQ(;G%X{eZ+X
zPk#|{ju59edps3<lquM#?iwolAoBiWrd{BGNP7lmHMvi+Hu74Soho3qoSxSXCUc9N
z-^Y^@zjBz0Kc@9*J9Ku2d70uR(z+28p!KZXmr8h8I>VM+asGZ+Fj=Sh2gs5=VGg`j
z_e*ph4>FO{t4EO3ZbhyU&3ldSIB*H~lFYPaT>|o7?GEp|`(u%~`;B)_;cFC*Ldj8d
zZ57zRuympNyu_Ahcu${sQ;7X%y7f)*B-~wx$7dX-C1aS^d<8v%?@c17@S{(q?9|m&
zMa3nnY+c7!ZFDwXe)0J$T5O$fq(YRox246<hx(5o9@n9}`zd#j_5*AR#rO6}#OTCq
zWdt}_lq+$Fhy2*~r*M-EXLYA9t`WT09hSjz@ex6&pf%m`nDtAG_mQZ@FgDbw!RHGK
zhAZ{e4eypvb@4+(O6bKHW@MTov1zxw5(vHT=aSSmr$#ZfI$JSH8ubXx2p^?)GC<?h
zbA;v-t}`EM^Msf9Cjb=`iL$!OuXUN58_P<<pme-<K#bVrm*?wy{BnKzH{MuJ`g<p+
zQTETJpsrh;lAh-EjaK=alt;iPA#VL5&{hqt5B!e-PZ<9F7ejn+%eI-+J@6I;?BjJ)
z9RWHFKUa)xQJ%8DWhlOR{QiDP4zH~TJsze;-Rhc)w7GM0Goqm$MJX)DdYZ%%oib0u
zBdSpUpf-_XqO$Yn<IB54?e%N<ezBPUoF`5Ou<Ep-yG9XccKjhiSMzzN<UI$DH*5?+
zsvbq4V+D$Onn{xAIrF=L5kfFKC&a_4c-$V-Ip9z!w2taDddO@txLT#XI{~??d2tnm
ztTe}?G?{q!6llY|s}4SvuhRQH-hYh8;Rmc?hU~-zZ{t%RB#{HK3p-Oq+nq_pAFRH!
z!gzcn{es-AC8a?doId2{91<NB=7lbec$(F~PvSIwJDWA0jSopt^wn>pKFhSIp^L7z
zLHvYxZn0WO0@|Q3E#6Lyt83tM>u`v7-H%x9P<mI^AtV~v_XefLK8{fmHL*M6`Cc#9
zD<>=Nbc~n+Ipktpkq{0jKmV12EI)*P00Jhq`)X5^vvxY`AkHSi`bS&?`emzspqnq5
zLNbdqJBI4xqDIZ>0X+pXYnVC_O4x?$i9YFmsWi40`M!?_`DKPewqibtDPBQ?Ut`O#
zUfxwi1|R}xWkhC7G)V{D^8gK3jur7SZ~I1hCOC&=O7?mdvhhv$(cdfid^Kaq#jbBX
zMN*0x9u|sYBO}r^vJH*=Q;BI<XDpJ8#^iz~wX|M3fb~D&sG?`<NdT>wPeqr=S?aoU
zRxFp_KOU|u&XUWCb*m4bFn{{2DrYRg6p6v{@iWS5Ai3_Ro^i#a14p7lg5$aWc?7ok
zi*n9SOqG@x?qd`y(MaGwcYFLORj5zjf1L)~&thJOXq~FHc!)OGPJRu{yJ^HN%1_rP
z)ziB1Ln)ZNUraX+zII@*^~A%V_O2oCbj6+&Ek7%049R#OK%GcdPOxZ+c0IzzJuN26
zD_RLUx*ohmzL6J`u3k8y2zq-*euUbiV81*P&#vPkZU_>ih7OgO^+?607yd}VwQf)3
zz0GzX-;uAC{Ce%(ilw}Dw}<iBx<xy}J(mRWgi?XEO+Cv^JJRr{IX#cJgZm<$qF!<M
zvMNGVsUVH!Z92not(?W9wquaZYqEccJ7Y9W{gg|M6$}jy(0?2J+gpbYp0eMca0%9a
zYx(v~qcrovTh9QS@<wcPtfZI_8CRO)r*2Tzy^@Gd5<QVZ=xTAt7WFthsU_t+ch3GH
zO-;iW;`Rd>o6T|YSBNUH(q)T=jXgy&^1Vn()=e5IOTh-1iC||O70seNnew=ck7EWl
ze}7vpYW_XcgX!|r*PeZ&AL!~wL+7_&2+dTTWI?j)3eX8xK3-dJfQOT~X16HM<Kcc}
zDXSTgC3uR5y)eVgj=Q;Qyu)`Fgd1et#wh|f6lY#Zl_ZwZbNTyC*#as){2q$Ze_?##
zRezZ7nuI|lSF+5sIx$+kSGyP9gdKS`_~1)E*-QCoN&X$QF4Skx{Z7+wBc}SA{UP_A
z&^tZ0b;49WJEx$M?;*sO9oJ8>zr`RRE#seR9L!0#6j28U{osYYlGMRSm*Tt^vDO1V
z91mm~m4C5MpnL59X5tiy>LfP@NRYIoMb+~}fI8+@Uepr+?v>V3u3o&{is0&SXwj`K
zebmL;h~eaRb%)Sq?O>YN7T?*6Q>EymJ2x>yDlir}Sct@h>Aho#OLraj_E?*bZ7Y)9
znwi$r#m~*97v4r%fo6OUS8b4^@*Rc9Fb9-565P_vP6U7#5S!ZrnQf%`Ifi&jq*`-+
zE5%7@wnk&I7B=caS2tgBbyH~kDpDCLjC&Ky2YF~A_9E;<Us;s)k$YT^ogSv~i`(jJ
z7Fquz8qDbHoz^8t^z6{-@`~JJU2Sl|VRGFiYDc_(r)xBhe$&p);i8M_1CdC?!mPt|
zgZ5hLNR%abo5GS=n%<%%dPo<4`@pkkfuDIJ!{ygf4hVNA3XGdN6fs-pTsg|Oq*ZL2
z@MoVLIBXm5wN$;cmCnlzX>MIQ3HL^*QM#qQDq^(iLO3k`T~{#`K*!&LjENL|vE=(D
z#=U)P`=tUlcurm-61Nq4C@tb|P=K_~UE^4|sbt=kwDA;7?on^zxHg|ncPt=?DQZ8O
zHyKdq!&XvLIEJ__at%-g>04#J`gG?3t{0Ec_R1+-pq>n`MXB*N2BkW~XSuU+E3*=#
zB5ZkaFESvE9<|n7UcAoLdZd;de-UwLJn<{Z!&WAq8gIXP?bGAql<v0|->SD+pcXLk
z@vhPm8=JwdMvkdxo$y)pbRJN7$5xkd&SjFn_LMmubV&Q)K6jR&i8w$=*SI(1BXJ4r
z&-lB|_z06DV`V%9_>;U@{$uSTm#hb9rnB*KiuV1H_zy<-5Hca{CzQ5@&@qYW7t)$_
zpn5V3>lNl+rp0rH>nE5V!GZ2`Z{~$X?LuR4M+Q-Y4gO(W*>1ot-Ie?=Q=l-}1Hwj$
zA<(U$dee3h+Y{y0HY%L*>cXE}MCf&d;j)E0)`+Ip)vNCTdZzywwP?K~xvk`tDmb^>
z9o_t<VeJ{%LbtmaNGnxoeU8WSjD)&RMfkLlhx;5|zIO03R;u9^Np*XKky1lF&<-le
z0-acGi8fFEQ{RV0_(0?Io@eUYl%I9rA)o;F5xf2)Rgf`FWfn)tvQ^{#+}bZ0MswIG
z@Fou!^T?UixaN7J(p%_NnRWq71p@gZjex6A15uz;wV8<X3CNkzq6tC|C*Wa%8b*d*
z*2~*r0-5AO)vz&Qv9NiTZDM1+LAQ{I6BJM0S$f@ZuncBhdRISdma0W_lu^sGP9xzf
z{ohW#oNzIg;J53FCI3)r`HVN3VrYN}PbNM>noq+=!}%A(6rzQpNZ?F@y5sp^T_y9Z
zC0OC*$pP^LbIY6ye45rKY_UH1m-~Crv5E(NfZarSSkc*B`6JwL9&kWNtv?mN#-Lnm
z^S;IQg|T&SpAYzXroJDiHX4MJ*eyD<bW-}ht-=x%O3#KghQD!~U?*V(C@3a*)CnG(
zcGn6?8?4gh;(8L1a(-k_4|;6%{e-M*tn>STV~j_`sRdOJICpw|t)@_VQ;h}2uLG}L
zR9p57GUfhcEg9M%Gay$Or|RU;*Y~65KMs11#FN{Ip7m&VYt;`S>HiN+$fgG>f18b!
z0f5x@uXFGKnOr0&`1-l*Kio4VgM|ty39-R863@q_YTxl_O?+(YJ(_!RA2B8@Nf=I8
zgbIlm&G%HgbyUMBEC>tNYEIHcOP(kR{i5gnWoyQ?d!@lUnQY7$BQ{pEKl=F+UBr)k
z`<6D*c7UI9a*dupSgkGT{u4?Ea!`H_ye;g)=|7Q4qN!Vu%;0rqUqw<loovj$`;TbD
z$?(S(hQHI=qzv$o4w8Pdr;1O0M7V`)EM8F;gK_immm_@Go*#qm*1@$#x(){wkXi_)
za`FYR?Wy>Huv{Y6h)uI8#?KMv#l4XU?zO*>@uBK6RQ@~pw{;NDpOj4q@l??UkI=Pp
z)<(HV5WU{;2~Mb=Lt0&N8P2MGsl^U=aWncoQlS{`JDzNP<ma%jaxPduI<c<PEWe97
zqGwcX)^RAVeK{$b=0srRaemZEnx_)>^dj6ngT{m~+(y8Z-f#GE3Xa?PpRysLuAR!C
zhFO75C{8sM6Jmn4CRNwaI4MrO2XK#w_&<T!a-GqG&*$V#bTRv>;$vI@E*c_HtNvH|
z>#m1e#9u-cXdf^x*(wj;ajI^O&G}<(1^^QE@r^zKfXM+lq^aED-Wg2M>{wH@<Ev6>
zhDTAszbagxfN+lm9f!-wCrg#tzl%99h<%K`_l8d5@(-2;^CRF<=_i`t>oppA5>MTq
zoG3ijTN~Uv_rL3WOANS+L@RTW%&9o95$I$^JY{a14OuX3mE~*UC+6RZ67{pyQsbT_
z3f*Ya4mF+zj4F2tex6^W+b4ofb-<I)F|=`d(^U-{NP5MBA=((VvAp@JArf4Xuazdn
zU+DNg;$be%o}Sa7eK{_gar>=;vodc;c(xoI65*a0N@Ds$G06<kb0u0V;$?re6Ob?j
zdVM)I0Qoi)`mV<BoT~S2Rh&;=$-FGk*JhuX@x!n^_J)@%z*yFnl0>DNWO2TK+sg#`
zz>=1(V}b+S@h=1}j9Jakb72U3edI5(@{khfEjSUW+7q*8Lc|%@c0wG_??US@-Sy3e
zHD|4^X<(`@!cAJT{%wxbXAz&NuR`)o-|}s`sKZ^6ASE@cvK5$p%E2NHg)ie`mNnpl
zxn~yp6j)_-9d<aO-dMrxz6_;2k2GW<z0+wg5%C(*>YUfs_$1i>(pYf{o7A;}dgyI=
zfx)@jDL`6jIHI{(b85c=$v<&0z6v5lg}U&dkiu|cx?A<RMcz|J(u-fGA#Vtc2Vj@D
z@w32I{I0@>tniOIIbEaBcTvo6#Ap&mT$kPtpw2W|<{2DJ`f%P_?}oFF{3e#7Za(`p
zKm^VGE$n1omNk4Q#?n1%^=`7%5Fn&V1MrW_a)%kf#zROm)WxoA>Mwvh02AXM%s@)6
zfFGr7ira3P)o=Fa$kmiMTlM*=$~c=}KC+?A`$A+gp@4T|^CMl?GxczM6Db?}EADRe
zFZ?Bz-SUK)fd~{9Qf)l+!h`|yA2DM;ZSvxXNK?~ODe!Be9W-pzhe~7}l_?_3@g@5w
z<+rqV!lrs+p>SO0f6uL5!u<GlDE2UgYGSmP3BKiDrRfr>Ztxq&v~Is2oHl#3$^yQi
zie45P7ve3ml=bi+b+%r^x}u}U3)JnM1*;+TQTzrL171dJt5QZ+N=z<OY56DU`to@0
z4RS!Vbso?5y5MehP{jJf26bbTo{~oz?~z`;=*0MBcavZoq*=^TFK*^|m5?U2JoAmB
z>vQ*iRhs#N^2ZwYk@{@BrIxS&e|lR61jV~GDMSDti7#x*3=>&U^Ha+4buw<#pSGv{
z?da0kCY+JQk9+Bh_IMs?YXBx}fqeM5;s!|<;*ZLyn?;m@8z&o;C|brO0t~pm?U)+7
zpkJLh)DVVj6IX);H3Vot2d;(XTq^IxCJM_KZz0y?WVuli1lBLSNFgsT_w9%q_`4I(
zfw&+}aCeZ7&7#*hT>XhV7~dC-0V4pY&oTG80zWJg)6`zY3Qt$g?4Ra2s6P~6sB0U(
zApx>pt}V=bc@&$^gdV~kBye-ko`utJ=Ox-s|5(4o(^DBa>_5VAouHIhs5GtAr5VNg
z88QjBqfX^b^x>F7Tu&4EktBC&t0J-!id|5A=a84MW^W7q(oy=EWz?LMPeXUU?nwG>
zO_Y5y_BW5k$D%t>SU^ZF$NfA6t4H9?@%iW<2EC0F&0gv<dde;~TPRtn@Nc<nwvoUG
zqu<>ypF4_q_>I$#!#2l+8(9Ai_Fz+UOX&SsjuL^7DTm>00;7cy6A<a@rT0*F$bb((
zC;TXF8Q)*+e7^EcP96%Um)5=N5~@faiL`j5L4p03fvgl%TN_XqJfNB)nHlttB8@TC
zdL;3LJ9=vL`^yg;47vCF_pb5FUP5cpveHsy)wQG>P5MF7rH}jub1s6<D8f`$v|sW=
zHsv`IKd_`$%4M~LFXAzoiY;#n`&@X<X=X7S3+6&`bc%RFs)RzM+k)TSF9APVV!g&#
zoechJ$_mH)?`_}=303dg21x|LMX?9vr1x*Kk28XDK-lppNrVfE`<@uIJOTZ<(0#9#
zEDG5s!1;Fr9d0Kd^7l|uVY=0OJ#VqNM=TwYX#XUK95U2K4yU8|N>{(UejwdjnSxWj
zDm^AZbe)iy@KcpMqNs0nJb|i2zr(E_*H)q^LPFi5<M|68m(&e4=B;<lD2&ly5YS2E
z=+wpj%TRpB)}k=3fIF1OslD=K>>qrTpn)GvjKmi5<8k4={QNlkwp2clLn1s|p)$bo
zc30CXRGEyrr*bNN>k`vsWA*zU&u-e-Mz=Qn|FzplIsC@T)zyP3M#!65FBcM$7iw&!
zFoe#C)75_BnY*6OW*715$h<w0NXjowF7yMH=qZ_hk?q!96Z(@E@ai7djW5OgT!wZ8
zILWDZi!_5W_fX?9SGN+A;gOZID3r{f14?=72qWiHz#hoHA!jF@pjl2*yV+4Jv5ZxC
zPNQL7_hHa8r;@;Bb&;^8<)p<XGRediWO_zS_RJR7*tD<)bCdxw#CoBnERD}6$S-;+
zEP;bDUchi!+9%^GVD+Dz6`_PDu)=3`rddkpdAazn>Jj8H2~*~cOEK$tQy~iWr>qsI
z(&O*`c@6si+^skb_wfWXe21Nc0xCl8E3sbkqG=3znmn5xwua9L-uj!(y#5vH&ty>`
zp6S+vSy=2UC3@;b@y)$w>L1y`ZQCPx07SYy4HLFzf*J{V6#_4j3?&4Fa@CzYBHSF!
zAgs>+-S57Uwid(5xL{VLrI-lg;5LJV?C5hkuKz&s^aj1~iifH374N)Tm=nv|0<O4;
z=ugb1vnfC?!5GD@N$%L%))MB@)cf9VK34<fP6`+C(<IGZ!D&<oHL258arNeFloW!Z
zmL~?8^jRJHfuGdR7a5^15c9{UwEMYxO20mI>8*eJYAsy>$-J$iWLV)7Ki4&W?IvCf
z+k>8l{rm*lCoy>_$y3LkdQeHs#1!Uyf@)~+@uTA_$7|8wpgX}r5M1U^gW8=zF~Wa2
z`ftv8J@!vpf^W-!EcrPo2}w;RnOpvlq*s<$xM1oqU0t0xeR26Ynd$p?QEh1fE7fMY
zSM^1S>4aQmVz7Jqa4j2GZt!cf^_-HO;E-tCsx%u3(#O^xHo_ko$~68A`8_P}r1F;6
zaJkq^m>|}8>>rv}VM&N9r4<p=E;@ez5*Cm5XwulnW}SBE%hVV}hd-kYF^B4hGD?r^
zu!ouv$~<IU^qwTDQ#UkwCFjE-=mAb9k6P)aR!;R8kThV;vH<=a<pQUFK1E$e@1nJJ
z*AI>^+Q2@NmJFU?{jN<>T99RYtL#kZ7O(Qt4T=x@f3EnBpy;7n;8P<o*|hkuW8#Ua
zre*?4_y<65t@MtYwUAarZU_TSjYNg#9Wd4UqX%=Xm+%yvl>5m#bkRnc??o0x{mhMK
zgi`+NVd&UcCx+)GA$wOQNpQ0I%KBm-vAir0SBm7bXCcLD*N<DJml-Vg!V$wrCIM8v
zGgWL)XRBaeZ?`=xf_}FsK<j@4Eu2o@aGw1Mk_ijvLz2ac+10+M>e`j#ZBnQk^;U{{
z+};Zl<80u_`MxzskXd4w7T}eA6J;T>>-@TFD2EnRB?Yh7FIRXM-FXSyH$y{a1kkaV
z^5dfooQIt!#}KE;RTlmG|CVeE1baKzqA9+As`2@R>UgwkyO3)^PbA3AGNJwu000Dd
zq?79PT5kzdo$hsa&s35Usq<_qel16ayyuzE|8f^n@0l7CV;0Z$R$jPNS63JCqPq1)
z?EQj$bYk<JTdDtSTvv-9md!4t?K$o?q)985#*ZvU@R<Pm23Rw-LKaw&o}VqnD%<4l
zfPqJ51R^DvpCsGWWo)%^2>d|DT!)W1`M!mYW#Yzz_B8CYS4%UQGD$|Ja-k;p^PNtE
z81i@g4jAOt_SW`rh8WA1dQUC);KX2VOT)=7ifA05++fZ`v+H?+UIzd;l;5xhe*OBj
zr;byN6SAco!MT2-%)w#DIf9PP;Dk;MPvxi@X>AW?jLfMpAEL&WBEKzaAd!ESGf4Vz
zv~mR_=#VDn^w~cj6TQ!eBx)wkY{M^#^M_N0N4K~C(jrlzSX#`+I-0}IA><8~WN>VF
zZ19T1mpla<1K2nrS4(+=LXMht*)Z)FRR0<rq2&~hW*Cw$a~o|R1^{d%H1gLgE#wNW
zXBTT9&0Gn6MV)R%s786N+CAFetZ^{k>Rg2)UICfKxuWE9<dXVNw$39WR$e{#L>F1q
zJdT6k3tvSVUG~CvJC3(Df7|BIE^D{hhJBt|ZucmaKMm3SWyfP}{;8dF^tYZS)1+F5
zRe<ueF-m6OxkOuD*%*Sr8V@F57)X3>_^1Z-L)1V2B~KobDF}|72cda`iQRv<l0T!X
zx~sD*%3kBD%(1kV(t9ooq{79MAXho0a@XzFKB<%1TR-P8IQfo?<kBxG6k4%BGQ2$M
zh)1dN>d~~iKk-@}k5JFe-fHNV!Q)wvc#I%3(jCE79243PQ_H>GA!3Sg(Ga(n-qb^m
zz$qLwgNheIU8=GRvsCp9^${+UU2Vc2Y5k<HTEkfs<WUq;j?2*>8w}|=HxO4kKY1oq
z(3+8vHy>?rPA5YY!6iH6$WX2<$a^nl7qTw1GL?^u?!jc1Nyz&qZpdR6UI!((Nm32D
zRVf_*^LT|HkYN4*NDTrzb#X%oTsJv6Ih2~P{ABk8>;coPwmnsQ)DfOONXV-nv?>P9
zpK|Yo$Z>zv#%75#yLdlpt$Q=R7jcgo(<3w_ZF-O6j5X;Prvv7GahaDw8@3jlgUchj
zeV=`EHpTw#X1rY0;k>Bb<pdY~cN_|#w-Ez3vTv>S(4A@&`bG~xm<eMOJpu}v+m9MY
zr##tzC<`Q)XClFlK4dE1+L4g^=%1DI24u$;ezX*PFr@u=qFpF2;?Kj}bRHj-;`$`0
zKIh8icV}HuQzLOAPUhcY6qZGqzn<1=-6uPXG`e@%?TK>BNC6tm&AT)Yyb_Q5c~yc^
zHZpp&Cy?`6c2@5wdSaA4|Eb=s!6~dvjbU@>>ySgjozO=0kiL6SG5dsNGU)6XN#G*&
zrEbL6mgzgp-ItxWj{6rOd7KU*?`4ihMQ$q7l7`UiTX1|*GFlr=XW1eYAc(y2h3&5-
z>I~LvQKygH7q@3F0-ZUd(p+l|=gQJJ7x6if%{4KBIkog9EW3QR|LKOlSRh~}=9zzI
z(Xsf`h>-vymI=sKhYC#&+~p}a!o7;At&}$`=IpHt@EWnAO!~zE)^l-9;F3#4UIxzz
z3`n7D&Ab~{`B_e!95Uc1zeGr%!p9&2`ttc0#!3CuZ}Db;ALq75|M1vn2DrjGPwcqo
zUCER3HDv&fnqX7QYsLwz3x-uxt-X>-GhCqmIPgRp4cX`7*8itefK<wP3i;*`IXeQj
zo0!<nN!lDapF)U1P@*hu>s)fZ_~?BIN?D^ajm#b*25ftLkcQln!W8=edQJn-KgX=$
z*qHaeHj*o1egjRnUgjaXLOGPlD4GVDiCHP#lk*QG1QC#eM5^Bb7eA#!!*19z;i};1
zw#u@GQ-e$^7>=_U^y@$v<_6wmTN?~d*Gmat`Suk`Sq~BMr;<0csF?1fAQy@*6$#hC
z%!9w;IR|VQ+g;L@FAE-ZyxOS2er*T;@E5r~{H5Hb;5nCvl7SawJE$|g)W?9!b-!6`
zEw1F|)%m)x#qhd*JZ#!k>I9X?Ot}{qu3+Is?Uk}F8r=)tMSbb^9PLONx$GAoS0Qc!
zq$J_S)>+>-<5Yqs(mCHD$teejojy>Bz!_@-Z^5HUS6#R)R+uUjzQ&n=$1;@Ve)4>a
z&46Ge{Vjide^~yk>ORheWcBy<?)m9TRP#o*LUzo-!%l%K;p;B}n&U+)CH-vkM=L_F
zS!5S5w$DbU!*xY>%%;YCHWX@oiG0fgFsl?Crd)X`Lxzji)iR=kjW0&-9z9a((pzr=
z5$$F0)W=Zh&^`w_3SHMDLJErQ2{fair;QD4>gobi;h5%$svc<m$)z&vXU~)*`$}A=
zRZ?PzsAA%~h1}KZ-^RDCRC=e6a4P{A%T`4KHoFm%Eqg1&axUERO^CsyWPS!{coDt#
znRz6qDs|48qy8RFtv!z?UtH|IKjSt)t=Y40?feqOEkrG6LNq`h`Sg|-3Mj(=S_u_%
zDtkA@C~dNJw~uT{Vv!D3rQ!w^20I(KEu_9?P8#5myk9DSN4UaohEEC8)rnyr+o*Rx
z1`>uv@<&37@Y(Gce;jY*;v&c+I4zwHy+1{G*?DasKeG~rmV+P3bh3(<Y(U>FO5Fa|
zb{r+I9!hdd5VFuUE$Pg>LU^eloZ0~Oerjn$-7qSc%1*=1OeN^})sUxL0#2W}PIu+!
zj~2PY_vr<N?o~(7OHOYWhj93NYw9tk%Oo6M(&wvCN9ur8{dwlu1?4JTO;+`A*7SOW
zidKZIw7_$rqt)vduDwIg*g|BUf=({sKPM6mUpUbM8On%b?`PcJ%`T(wc9bG<dIoU<
zQ?3v-u*hw1B(o`=ws7!BOCm`P?(5@e=G9<AMy$nbukL|Z(s#-o`eTC3klrDCaTW#j
zP_HcqH2pvmb8F8DN5xHm$0He(U?4bfS%k{{e8X>|Bnh#sxA{rmWoxq`XSx&a%?Xou
zl28U@og4yVST_k@L^>Wd5|hme4!qMYzCs5o=?;n8KYgjlh*`F1k;&FnZ_Ou;jJ_Jk
zw<+<bwA!mWz7f%WxILrAf+&z8;-~!aS13xVQIK5bU0ijFF_yh`4dd6OaO9CXN!Bvz
z1}A(#xZIafvag@th9p_5?7gcETP~Afp^D1ARJDjsC`#tEHRN>)8FFwc69BSE5`LUi
z4HRT(Ll}-u-61r!R`jl~Lk{HXsDZ32BL-GmM`x_P_|3VtSY=(U!vrLimwFy|>T=Fo
zdW4g_?o-G3?L<qu`ABBCR_}jrKH@a3#%Z5L@qnjFUs9@ss-s0^_pFiGjIftrY&rzP
zvcbKXJv91A0p_m~_LY=NbGlV+QZgje1)*Ukv!cTK)=k?VynOEXxjMg<p&g}tCGD`E
zwy1h!sdc4BPjUXDhQKmfx5osmd%WlU2CEfYOw)bXM*9(s2uV(Nb?jJX``BAcalj<_
z+=cv`ipaGO%}99pp+qr6Y|oTs>nqm5D9TRlV80N)oIeKyv0pTf<BS$Od%~Ker)>G2
zvTepXVv`QSjT&-RdGu3dK#ojW{bW8KH6#uT%G_cu3QS09ZFhL~!<7Xs>F&k+n<jc@
zG<0$);nKnIQsc)7N1s2+U7zau!FB+IB=pm6+Rn0T5!nOt(4zrctY)iNl(J7t_z!38
zv1M~8A;HDBl_MRY%f{0D{Ba1}I9qa<pSNq_rK;2zWZe{G_i+^-#+b633Tb{;pK)hO
zHFW+TlHK9I59Sh229&1&!MJ$kgjU-Z+~*U2fHpQX2!m;!ur)?G?wt7SF?v~GXWtSD
z@Y?=pT^2hIc`-GjxpB+N+DX)TOX7<SM?*bTzGS4H*sTm#y8?hgzf{L){xW3nG?U>{
zoQb5IE7<I0xg}UopTE?XW3&Nht(ux=9fK>X*u((=vHgPKMoj2qoo1zb*%<lm0olM*
z>IJmaiV~qf$zZyLp4=F-i09|NlqN?xeIOFA=EiC33?=CI2=MclNja%PH$}%WEGRFE
zG>Rqv22KG1_DeXOjsI5yFD*()$$R8GS(_fk#R$P_VDlobilvl2`BUr0sJAi(TpX{M
zqp0^yG(_)#xiLt=H%4T8`l9bK_Qt$VW=HTkt0#K9eua%4rN)^MFX=f0(qPB<Olc@2
z7L6D#F1&QwZ(uCGR(6r-UP;g*z06bU<kz`4C~4HGp5S~<l(y1?^L2gY&v)xLt>>AP
z^U-QpTeqkhRhNWMN*!}}j8%4i{=^5r0Z!Boo_<a$=TW+H{<-m1Ht$gEDZ53=c*GHg
z3BIJJfz#JI0i{Y`Fc!8ZgfkQq5=$>xd8w|o$!_(yG@|xWVX^z-)aLt7GL)$Ia-Mwj
zq-BPQw2+-|L8cFq(VUJHoH2OvYc4F#v@fT|r}Xj7@YluX=ijk&h7zTpOyd3%V~@=s
zeL*I3$1~JEjIgP}@XkKRJw~VLZE4E-_k3VgY7SZQb_@k`qB8~?_;pWtyv&8ExE-(K
z@;BgHtEN52$(TK%@9d7d^t{?e7rKcsCm;glTqc3d!>AHMgcDDcp7zDJU0&fiVds&!
zd!FsZPS6!`v47`la=elcxs$UKponM_hz(7o>Xp3KDEBC#LI?H;f6pV8!!b;b16Qt6
zXQbC<#q$1V;^#(#9C0f)PofiOXMWS%s+A4HeBY5Mqsw}=L|Bk>91ck6G)17OyuDZ|
z#J4nwtS(%OPIOO{inN`LLi7f~0QLQmVc`r%HL)XLhHkdu0-Y7iDOCR7=LdtLJ5h8^
zDeX*`moh{S+Xc|WV2%cEP*~pdIq=O_>4h}JL-15@*tQj5A~G@vQ_R2SbIn0ims4pp
za@}{*z{Iv&Z4lj1Cjvb$h}^nl`#H50`3UNnbeA&#v-X{J#?+CcUTsNq{*<;utrxb-
z{TSaogJc`!rsNxVw&Qu%FK7ZwyKPS~yz#bwrj<HH)-7En?@GK&-6`qe20x7*Evwv-
zHI_Go7EjEqg>MDEn``UVxMI)^ZDldWrZiWaQ1l*gX~=9kLn>1RAn|3u0YYi3x~cl*
zJ9p=SdrX9bd#(?|TFYCe7t3lwQC=rnt(MJI(7<AFKlI>;-u+Ut#SHl@daC?UQM6pp
zTOE|@1JEkxfa~w=-{g1x4xE=0+l~}dSsa!`@-<&%L`Kn}_*}?^rVcV9^fgU42OEo#
zOk4`*CwJz*8pKralUF$ye~5|gy<7E)pq~htq3lIuq%POsL9h;SmZsMJf7g}m_4>3n
zq1u{YN@Yygl8hNCXJb!P>94@P+*j#}XA-jrZI$A46v4Dv2_GSGtL)pIxwm~pe>!2X
zYRHV=S|zV^qbNt#DdX!QuN-V!WkaZ^;P1&IpFlhhQ<{Mq)us510C)kx2UX7-(zAsL
zZ|UdQi-Lu%f%d5b{Pd+2@AEqB>{FV!g2gbI2M>#gUS@OW<jCK%kcdoSpcn`&k>&fF
z_@31APB%^aHIjzG;suweN;>O45o64h8@*oobO3pkHONaYakZ69{}!iF({80{`g=$(
z2Ji<!G?aQCn10KScz-{>`mBMt4!biatDP>e6cJqs2*&E=(m&@c!}6e6Edb87Bslv$
z><F;)YBCB1ej@9OVV3_MOR+6}doAImQt|%%zg&uYo2SEO&dDHiU7DK9Ysz7Yef-j}
z>lW%;%J=;ZeooexAEaV_b&Opc_+F=lII${4j{*F5b9_I~!B?PuS>I1>y9)kY3*GW|
zq_wzkH-r<V1r!jYV{|D{5)e-K@Qbvrl;3QIgqr<_q+6vlR#Eqi`CmzmxGWZU_WW8B
zGf||1z~xlzYd}X(@on^jD|-&&f3JI6PpbjayH$xQwOqw(D9ub7NBup+!D5P&<>o(e
zvv~dGKvTx&R{r(H*Q3QecS`R_<^PO~ICG#5xA%Qs<{azZ>t^T!C#@<8kHo1Tc{g6*
z84Fj&Fz7X(ZCQ%fQ!2$oA}b}45&M9TA8dM2Vs&k_E3eO|9C$-t|04h<n?UzFU$2t9
z`8e<UJWD}bw0V&0LE-iOkNG4muAXIMe1YYoVP!X25_QV3v!-{CU46tf1HBhFc5Ha8
z4#w%K6a$@?$*)V5d$N6OEB{^oUQ0a_eA-U><+YiWi86{!EJ0k-H!%sMZJgC6H{)P$
zJ)rX`r%Go)7*#R6D!>V>GSYeHHI)i$ldl0vDm{)w_JX`F=HDGui0WP-45)hl^o0RP
zuQopPg8#4wR>YmIh@!8LqaoPQB&Osa{2Nr2!KRS6Pn>_~Viws+A$6jTO!?5Rttvl^
zeWdjob6Bt3Tl&Bq^AC0=h||c+^aU`;jpOU})WmVS8Ufl~yQ&b}&)B!trXo0Yzn*6m
ze@h=rZ^;^2ga_CI*HkVyx&Xa1x14g0)az=r3DOQ*6syW1T%y#3yPOvvuXF>QM=`->
z^4G&~&`6ihpUxou1J^i0Z}{@o$nJc!*3n51xAYE)DBpM(`FWLiyD?+7Pz@}_U>z*F
z54bG6mTg_FXruK$#oIj{P6iIQV;~S_$7U}KlPnyk1D#R+8F<%UJ2)@RFC+VzR?z<K
zO_aci-|IL$Y^O@IX)(svLY&>Gy()E_K@aBO`!KOfzlZJM{k3W3Wo7?47U!wjg5(+L
z^G}WDe3xzRRN0)Zte1onq)WS=-O@@Ftk*KSX*tbP7`_bs=(YdV^?+vW_&#3bV7IcU
z1h(!xAE=1_$^EA8C7^CDd_G1!ELJVt2FYgiFuC5yFE%lr4AuVvz?yD>yh9pdWcS?R
zM!RWUq}96R*2=>8PO+S0=e!?`H0r_UPZD3;fV4v!!Kr;2(rP0^HM15=`Wg<6`6}Cy
zN)l?&Coa+MQz18}7;eg^ZikPfnEEN&R=cB#)URwuqtwQ+C|I&UDu3Tn-POY=sywc|
z*+cK`jKVBx{!blj1S}tpUeVniVUSCFQM=lX(lLji@C`L|<0hIr^Te$Ks$Lv98s)t%
zY*a5E3<DqO!Pqw{-vP-a)@$6SR3%)me<{3lWkp5ltFNr$8|pF%S)?e*Su@2U;j;(C
zDrnB0?v1K}vx)JGH>OjV2q~3y2a5_KrEB6Jy%4JKQ#r(~P||@-xxAlx_2qaC1`?F@
z%?4^Zu~B|t6rygNboK4&AOz(XI9A4%hMWBf$!)?sbz|B0HuZ&w$e%d-i)W<M7_l3T
zpa<gBJkO%|p~3guX#PzbXWeC*xVFsV35$sdpl@1TbVQ6Q(-&CDK|pSUQsg;U=$fxI
z(TW{jR<?@})nLgFr@iRybGNLX)@K-C3tF1t(fc?f>f}^arn~b{ZR0eDrZb1?!6d4H
zwBn|AuZ_f~qDb!YA~8n7CI@d!@uK*AGs1=Snz2TZ5%Qo}bp9YfKjvS%E#3K{*KQHO
z?wTzWt2Z+EcU6%FkVZQpyi1J8!-(r4S04CKgsOQWj>2zxZ`DL6<?nQ}<~n;Xl!=RL
z3}-y=4))>)5|wf?7ocN?JA|rTq&I;4Wh7a*iu2u44kV84`}7w*w{2e<8;D2!j};0I
z>)09P;p0e#wR@uy>~@#G|Fy8@QFOKlfAOML?%!JsOoDC9AJhyGlhiG$vqv_zf<T_(
zN=XFAiLK!8KHc6P2hPuJ?b7QPIwW5;p3za_YE?;QU<tFOPPxTRVy@0AW_JXqtV)=}
zk*n{i%(iF6t`_t5oU)3q-aW-0IxD=~{q#aZ`MvvG&X|A)B`9|xXpz0>HF%OuJ5nm#
zk#=x9O1QHr%UW%Gl;vEBN2a6}%VT>SX_*vVaJYyy3Ng8dq~TnacktCR*!XM!aIEY?
zvd)sXTY~<S@~?Fb{^~pH7Q<HFRf9Uh*2IsMQ~-ba?HoUC;<=h%)7qi<rb@DD(6^q*
ztsP8Ip>Y@Os++Gd6<%WYpCVGVMm0e{1LT?fa|`n|ihGdd(vuMqrz}OO?FoK3bhZt_
zC?Yv&|JV{D|Ma1oj7X<B<oBR1LnXh87RBkX{qTv`X{omlJho-zSjRPX@L#aGzd`ZY
z4=U9URYBf@Q*|L-zqZg@74Y^6`5)|-S;S55K9=0o#hGQ5vc;IApMAZEQ9pICT<!au
zLPPGMHq{EIWrVhW7GcNE?AbPCkI#saH7aQ;G6#e|9>p7jVSOg$p2y$nW6m5z+Uu4=
z41OQp;9_EM`lBDmYkXoqc4V!M+qE$@y;E_yjsN1GwmioI>UB3O`cg8$vF_=W!;B4{
zadVd3FD!RTSoPF+-?z5$EvD%wU3nXk!O0NV`(w8$Lhn4CRWEKSO@!`1oQj?OgM%27
z@(+lF=&&{VUVY^cMa%^-Y)4*|>m${wR6kVRD6<dy;dv$NRIf60!tTwVTzo2!ekd|e
z7Glj*T{AfqQj<~<gkB%fSUjYJMz=;MF>jF+bP}6h#o%SsZrRtviS8|vj&^Rn>#Hj#
z#e_w11!=h}ZR{;@&9bCFqY>lsWHSiR*8Bd?XD9vvC#uaReCul5O!0vUWhLm#6V9Eg
zg4{hjdx>Xbrm#y@RmQ8wF>|)h^6vh-beEKPoIfqkB$@0@r1v$$Eho`98lO4>q5h8M
zdHwll<e2@oWF~xOYxn-KW|!i6<HKCIrg&R7t~nF%(!xfi7=Jc|h!A8;qFBHO?s^Uw
zbW;xTOAUYGc*lM8EfFXizgvt18d`?`a=3|Y*t|JL5E?K#9U<VU|GX=nRhmmcGOdM8
zx<7mZq?h<^Pv!TPiUbX_ty9-_`=&KnQjj+k_uK<NAI*TUOAQLQicfkOWjQ>($`3t#
z*AI46+?v9$Bu$KRUQR$z;?EO&lebcB%0z{=b$QzAIG9X2T#pfhEe6wpe_5`N@Qm7M
zQ(`)qgxM)lf%J)F=Qj%yPrQ8%)MXPmY9pGq2_B&DSEVl;BXoA!WUYtuNdGhVf_P6V
zlGdG5NmbNYXwaJ-Q&C=k;i_$d#HMcMhyEQl1Q}21o^i;js>A^X1bSB6_i_4JXbGDp
zqt>ereema7-EQn>oDp6AO(nkOcdsWLxLbO|&^dv4nan@ftW2m_Ir92I<AC|<zq*zD
z!XT|cg#BALHisUy-8|aVAI5a-2fOe#F(iwOPHCiAbexpO_j1p(&#)1iYuW|T^LyF;
zP7l`r2Iqc01(jU1bl|hnbFc2o7`H7Wn_QA^BOCiIG;h?Jdpg?i<Xk-k0~PTHln+_D
z5TC#({E6H#Jg#PAEN%uQw%3FWzvJMX8N^s)+srUZ#lK$8N5x5WUh*H?^I_fMTzXG=
zo|jF2hHFG&&Ej#5G-Av!VYS$&9Hcc>Bu?h&S1-<449D`8&x*hoMZJlI?v(;Iue;1K
zp`lwBw^An2lViqLbw2uWiqEHpGrL?sgYUEPkBz-U5}|h1F-xsTa@+D}Z)<FS)7X2f
zStP$^HOOS!{6-`JhY1!?j`tEz#BaB*{w2+mZ~=syOwV<ulXy@+vkw}S#?$i(u4}%F
zBac@G+3`pvLd^P@_FLBjDlQg2o8nc3YC8T7Q}xn8FynsPZ=X3@rJaVj)i0Y(=j8`9
z0Kr4|;A;UhhWgWVqoVDhFXo_@nZ_LDn?LV@isu6NE_|@ve<$3-UR^-k{$+j`y?eN}
z(JWJ@K1@ah<NSy|J^uXo%bHowW;i0bwka@ZshG#AS3Szd5T&f02W0$+(mSEQ4zL40
z4e(L2S9ly-?6b`pjd%|@9cyKeCE@p&hl34Y4BEs0&Fcal1^juFpoY?9wAI&+c3T_k
zd1js28T<_mRs0@vynD^L4GTS!D|t$@$L80cIH~{Gx_h%H3f%Q+7!Fw}XS*F=4dCeJ
z=MBk8?Cr%6F-sXH<arE1&A=>&Zz`WQ9!8^x?{-82cMMMo-R?b~*B~cR9tY9Lwprw3
z(v2~BZFQgca9Xm)M3m>gwb!3eJNr(52?_*}`=R+<|9v#1tMuqdAVH*F=f=9dC=d6n
zDVV&89|2ahEz_sTdLiydhIrhZMhg?!*G^0k9w0JZX$T02BL-$X_wFi9z~r?bRR?=Z
zNB6kDIxICjL07GZmTMGD92qdk7W*F;E)QNwM*ewo?p<b@QBvUB<qN{<f0tGp&=oA@
z4ak2D{>vPpo+G$~J`ifq^J|cD)*zyao9Q3isLw0Wr`w_R6czrj&EFn7;g<9~`?_;s
zKHVMleaHw#{At4GWhz{R<CMWs#U?PF6_i2LY<55V3KRL|6^2kT@N>RRasD?|edkaL
zG5n<6`N8FMxXu@)88O~vpTF-zVXL(Gfr1j0nt*hdQ3KuOTZJo09N00}4T_<22p5@`
zxeDz9NHG*lL#5Ya1l;@>%zu)JnMx6AN?>4V*SCbOQm!w{dpaP`A&vDYW*{-Nf>@s^
zDY)R_s%pmK$CM^rzY#7-+qK0ehv>;r+4dY47&PE}^G56Gm(cjl!h`e{PIABh{-a)*
zHg;c+VHiNUd=&H_HWWHOJfNiIuB5Q*3qJ0PM8pvlQ%2D!lcp}9U)ZRQ4&Pgt8Mp6s
zPVl-~7b)rP-IseIQb)g+VziI&Og&Uq)I6d2F_%3Z^UvO`@TyE9zn#V-u@}PZz9ri-
zr9Sqqa|J{Z(YEptCr@=6tXk@T%@|NsU$su;rC0gYME%h^^N;&uRNH_8j=N&*b1&cS
z@GI{>i;L+-W0@!eNM9^wme-2aHGtz4Upy@{t-+eg27W^3^!OVAN$-o*ltr?=rWUZ+
z4iDt+lYPc2uXf#pcu4vygd=mVkm+TVGy!2h!8~5C$6m|LoGst~D_j74!~VDXe}KVX
z8kB~+MP_u;-s-P~A8V8S@b*59W<L7Gw`gP2r|~b+ovEPvH!^d&>&#K?EJ{(EH9Y)}
zO?K_B%LDnCc&-jB<)C*IpXIDEa<wZl((U6kophI&+rD-hlB-~^OOPgs>&D{-lF+(&
zT=Oc+LvZuNFtFnl-;l<B_8I_XH&#CHN(-2M)^GPqZ@Q%P&wi#w(78Hm^rzZsrp^g=
zKny;xZoo|;<p7f(JrU~vCb{!raN(5E_ObMZ+xKj}>+Nl3k5T*crI#KbkGBPHk7fOd
zS#|nh-cL9#vE!gt8pSwWq8~l1tZEXcxD7Jj3{akmxYz@%mv1<nc1yQL?Gy{2nq%{F
zA0&P@PfotLZLVC~C(~(jP&nJEeCPJ^%zgqd(f#|a(1u!KC?#Z_3~VjC8QI5Ud%FLs
ztvIozS?1Wm{J**0HAtiyMxx-sH|m#EIVxtc00++Eq(AD*9g5c|ZVG(`%6#zWKsUkk
z_2J`)nOnpC0w1)BJi=vb4$?%BlPV^AUF@#$gSSP#8Up<ZE_alut?o<5%2+9KaTIIL
zO*^$*5?RN?C@94Mn?fw~*C`$^qmg9rTx~su>p6)3%E6wjbR#50T_7RL8K7D9GkU24
zO(OIo;;<SFe9RIBk&}voBw^ObqT@t!`T<#Nl4DGD>~)t2cn*2wQucz3Y?~9bagf=U
zT3{Nc9d}gUIJ|dVXm}4z;`)!#Jq0%v4J5h9WX8!+K{sPnH{8)94$zpn+88re*}_JW
z{*Er!zu~PiD|YkgmF-}b33+$%!Q+7Ft9DF;WK7Xpc4#b~`41E2g5>6ZH6^b})Re|&
z4Py3Uh3qavw7yo|kv)3x^?7o-Ma-Z5+OZS$;LB%!YWi~cNlm+S=Shadswu}l;Bua0
zvKebiLc3_jJ|Jf2=DQ<{-^!fpIje8we=fOBZy*==bBKlO0)N#l<SdIdp-7@~gKWyQ
zmy!tQoSs;=y?Ap1$5ZcOGpQncuX=I^4T)5`ncKAf)?0!7djEz+=M6cTfJ(p$&TUI9
zkb2GiN4zeDCYP4&(-rYNTCs=8HRTTbCiMRYyFf(0AovUygen34{@BTzIO(l-njneb
zI#Dz;eg)(I8RTi@(G203>W(VI4ZH$h9K-+XGckRn_IdH0F}$_FY<73VOMJkyXJaMn
z)$Qi5GhR`vJ)dU0W>@lG{MDWQ>Ap|Hn%aJ57{C4?kRAD#vj95#WyF>Sd6O~YZvj51
z-f<%&sPjQw`;Wj`?mfBOCV0R1|Cl$sI2zr>c6vMaU^SD9+2bLHbG`eo2HF<54^G3j
z<}YPs5RT1g_n(_97lCWE1)C!AjJe+PcsWB`{8N{Vnm#Nw+f#?}bDq)OxHnrb*D>`h
zwG>lF&pmdtVwC;OZL21a_s%1In2EQ9)|MtS$uwb1nrQ=F@amsK$Yi`Q)P}*21#14i
zLw#HW)F2<mOIckhkAH*vZC8Jf*06dNb9mI2U<ac~h7#$laK3Un)0Dl_5F?2a3b570
zOWNU@>1?bH+gm!#bLf61ZPf7iOYDU3g*o_A10MFXEsan>KQk`Bwt9pG@Fkx-``0}{
z5tGy0J$DhV5%A)Ft{tABjfORHB{eu+&irQdz-u}L>TVFbY~St>7Tl5m%O3phdtg_O
z#KJvBjg66+ISar`qBf)3>_2yjjIcxCBx%B^^CiBpBx{|&HA#q`bw$mPCwWTWVaP8B
zPyif2o+3`$c#J8CgyI4}Ep-_YsGN|1Mp!^h{F#3EMt!9|ocWG^07V4y1cJ2%Fu*``
z7*~o{um&#rUpC|(11)OSZ-W0=mq*9ZJ+NU5E1LZvH}@y|Ng(tez2d1!E8zd+hLAEZ
zUya`J688ukXVQZBMhkXsFbn6ArC)?hH{s2j7)~-qd&l7rz$%l!i|)hxpp&Xv2bvvG
zB0*FPZt>QZ@v#3$#h-3Fo=k6mTIr5HXHnbW;v(QkHI6#;_)-j;W0&xb1dl_VL%@Wv
zx`+~f9D9J3=ymJ^J(b!2;s<gJBL7mZaYNR3SAW~(%uFKz3&y(J?Lz@CC_Q4Z>2`ui
zwH>VN=2yCZlSpvrz%^Gb?VC5Yu`s8%YGawNrt~g*4ZHF;xi4Ae;)#Rw9<g|bGvRxD
z3a9q>e~9rQGT#PMsc{4PrQ|?)<$7HJ)_w%(Ycl>bsSW|;L*18n_zJxrVUDt)OXvYd
z1-o3YPmQe$`PKOAZT7#cqm9&bOxzktt*!%qb*{6WT7UrD_woMs?-6TS6`!nRi{mCs
z^uSSe+U?h%BRm(FBha*x)52}Ha`X6*`TlZFk5bNTmeV@-kAJ;3DaWPK_^mw4`3lW{
z6e`hX1nd#YAN0gT#Uz=jB24f}{c-RGwC~$(o&fgUv#%wD69LBE=si1(F9Gel{jVLL
zI9bfUuboGU5)gq2eDM19&T7!2$mu2Kpycu+wB@qX!ag`yUrseZw!+ds*;s)1`0&A@
z_QVZS`_qC}fR(TiKUdAr;Qs;fm<RnjfFX4(x2S>CLEw?sZQ=e=RJ-`dB6tkcsf705
zt6sI=bkS84DT@yNT9ew!)OiA-$Q`50Kma~EZX|jF__Ia@=<gdSssDf|piO<mWrPIH
z2xN%FVqv5IHVtFC;~yUoB;F6OymyZ)XGrvz^3eVW1O%)QXJ6Ex{*lA~NQFNL@Rho7
zoXB7dZ}Nrzgzs0_@ZyB85FmHf7%t$1;6S^EkpJRix^Hmp@bDh%v<7&+$>4T%0Cix5
zKt}cr90DP(!|TtO{cSC*=>*gD83z9Egy6yr<EkH!iV_Q{USCVTlgGx(U6HQmzY1OF
z^`((Qt<jlgQO3<ek<WR(a3*>`9sx1Gt=yP$WrR?8yZ6R)Ii&c*JYeFnVJyf}rM;Q{
zGIJ!TFZTW6GZ%wU)LMul@cE3vrzk-`aEXJU!<Ips#bQVAp;Q?0r9VvX`v&p0PIcp|
zu2ZT=O3o`01rQR1x<B*3V<0_qJ@DZ1MevS6X!n>=4VVGoP0W#4FR4C8l+OF8fi+-C
z-XI|>E8?~CG!H@D<G8OZpiA_ZJZByu6JzlcNB1vNb5HQAHm5E>I+VTE*I^FDSB}g0
z>V$3X1g}D#xPp;!6G#7W01sqc<+zwf=9JY~FeH25RG;#rDUoFwaeDC)5FY&hT&ISU
zw}1fWfSC9<Ow9H7AvQXkd&pWH%Xo<)r<()Ucd!2u>J8m+V=cYo2n+c+d!9}tMa2GI
zDw@P$EJQ02h9V}at#RILQ=j%3qu_u*M-L%D`9r8+JI<yClmR)s4Wf8_A`l6{7&TQ<
z-}VEczqlc245SZnQ6h7%gb4yypbzW(F?F0E3w{94ky}6eYOv-3CV(D2lkp({q_LI-
z+Ibv7?vMZbtlSW$SVtORh8y(c6#(fsC!@#)CkYSUj|@F~C$St94puDx2uN8Td}%2&
z0d3AI-%F}Qo`hn9KG$pGTk%@MlAHl2`dpUq7yEC+vj1_x(bz^CP#*OA7ZD~4w~IH#
z$5Ja8y`_wJI>pfAdHmU*jG*@N<@nDurf8ORc3e|5i@}hDyD&VvI}Y{b!Tt3ia}=k9
zeVFxa90^{Eb37*x9}{}k>;l>PJtg<r8{?kt1?G=z?1)4uqu#<s=f2KL{b*lj5;7+n
z&1uwp9}*{jYxpVt%(m&Tw;A+0-{5!C@Rw|hQ+KENx?{zkmX*MOAZu>xi3&m`bcF>4
zfqU!>{QK`0xtYHEJ~Y3Z|K09Np6C{NJ)aK}G6aodj=plJ2|Z3rH#ttfx2mofSa2-r
z_P(zf6CNjtO?8=KCG+z{Ym*Ls_>2?sVpwK`F>uCy>bimm_#K5zI~6<7_;yTjAqdTo
ztJC5u{=g1Bt+EmOpmF^V_z(XAFTiE-hzOH+mzSU1A{neBEHV)VP~RsfFFO7@%nnd0
z4|PEgVB#xKN5=t~V}p<1$ArMD`5^0YoIY)4eaN3P+_01Qkqg5!*9Eg#`649x)&9N2
ze)P4C^1dTDK^_D_rvY$4-t7PQjEkt<kS|Zt|IPz4@7-|hAvZursoy1S;d<=lBk+y1
zvvOW1&tYu~XiG@+M(c?S97ZY`lfYH-?kq-VW((%gUm8rz`8+S>dEgU>!?4CHio`EN
zvw$J|jJO4jCwObbleoCX1EjFUMEIF`sA?AzaWOstHvLw(lND*4NJLL?-aVC_Bi~T~
zfOigBIW!U>FPe`$GaMQo2t>t0KM<#)gnS|hVuUXY!#Me$P<vu`{9H033_Mp8;2-u+
z7OR2_Y5ByLo1#%7P2nF7ti*{Ifg4%?A%1}K%pIga!nZB>kcdM*Z8;^627&B@N+2?B
z9cqI5rG!Hviy&|Jt?(ydJv-O)851+ZBK!!6N<fVFBSLH@=;X=&t-lZ?z5+vglk7yj
zm?vsfcyoZ&{TlxhGv)AAYW^ojOrxe%reOb*JWd)(2xD0-LsdWIFi9CKToCZYn9$k8
zgj@neajp0GW5TfqtQglLvmP!H1u<}lXTc0n{uvPl9!O)u5SK74_#Z`hRe_Etf0>3M
z4jzVex<NM?s<7J8?ifUNcfME;GHIBtrhE{If*~f&p15+$n82$<vs@E+X$C=t6TF}|
z^?)5&ku>z7h!P7p5)V($C7Ety1CxlsBLE%GOn;c@D&vSdJ6}w&ge8C$th}@#-Mi#f
zne8g@2k!Orj7X6&m)~F3@VBR_AKhQ*b1UKk*bj3ABMOWim-X`~h`)#u3VZ;TyD>!{
zW!?b6Ea(6%&vM9jo=?5gHfgu#rd|qv_#>~hudfrX`Y>JPj_b=!?mR7#^c5+H&!$25
zrZeSyugADEAmd-6qWbypO^vjf8)-5&(qwGXVt={<2kuO&L5RHBymg2-3?#AQLm<1#
z@DR1}?<${}hrd@0&7cf$#u<x@0!0HNd;`nI8Wv^vW(xQ~^)QcL`H;y#l|}|drqzNr
z%omd~Hl!SGmFzkqDS7K084Ct4<c54R2=THL%xN7xH1&TB!~Ad11XD8dieaYhQUJwa
zOdyUPJib8R|Na3RD|o#h;h1v4BO8pB!Zwl@;g~D#0rm6PBYXjD8JP{C>O`Ol2P`)K
z{u1Y``~7x*Cy@UP!3T_n0*L^C6aVBN-%h&OY#lUG{!>Bj?z}S@>|y7xE*}PIQfmON
zLrA<JELOFcW?vIGfxENG2!a?f@^WGOD(85s1T+vJ@Y(1O3@6d!DDy|xwo(z-<->{M
zJSWEupZ>pmO}z-pV2q{+z6u+7CO!^R{ti>*f7jRWQN#p69S#H6rf=c`-T}aJwwZ&Q
z(=cdKbrV|o-#h*Yb=PfB&xNoO+?o!r@YhW@<b*~Z6QjomD1H=$Q<_Kr7vMp2Bp-h;
zTQ83!+uUa7=YN8#0+0}m##3Ane1ot)h|@`DND!OrE>>LrvgOQv8-M=@S-krGiyq}-
zU%lbCGM~Nv_phydNJDOA=3l{^!zD{`CBxLftgD;Q_q*|nl@~BW3)y^s20k?;B!~CH
z@KIU{{+JiM1Vp_FVs6P`6$;LYW)#II*D&&6eBof+mu&yW{lI>kr20d*eb0pc2bt3<
zz3!+|x#b7{YXOWH4?oPAIC7j=OV==yY+L+pCVoLfI`0~5b-%X#p9fB<WYLw-ehVfb
z&rg%}{6DsbfSfcb@kzx7vT@m0k0w04@(MaOERh=jCk|rVA;j>o;J1n;yiCN*cw@9c
zP7{J1mD~HLK*Ovt{uQYc<4OjXQT_+jOW-dI9pxBEDH%8=qajo;hG3fZYEv6jSf`}&
zLn1=@52MIpaT3WKWTlvmVi-qme~p4QWV~=-<1xlu9WzHR9n=^F=ZqYq&s*3?a;$Vu
zaH4BdFkj%Z$#o-cOkM_bIG6;;)l-6(48q$Ha(!66MZubeRoz9;$%&E~ioymXDycLW
z@+NLqc-;;})!7pPYM?Sr;A^wRe!U0xy6T>B8%w{_pgjQ)5k95uXb2Va*kE?_a$g%`
zW2EIm!G{uTF*kR;K>rv#6(9_Gz!uu=0iR{;Af#!&Jb0qYtHRd*$b0AdhJe+y#v-pk
zi<C#NhnDfRi7-P3K2PwS5x@i>*s>9gjA?Hpza7K6k;F}~G;-oa51JXo_um4>;DAAJ
z|0@;{2nmlSHA#+v$7wN7;Shv0pMNqV%(KH#48UjgrX$|GQ$E}Hkfjn!{ODx-2_As!
zm)l#H+!n0+JV>13C<NO0KmXJKYrjX|P(S!vH7q@dAgg3@`0MDU{uqyrL3ft$E@aHm
zn8%%A-}U~#jtq=7h!Q*Yll|~TuNpmEbNx?Bteksb18(^l<NQcR9{dqD2E_)Eaz6Y(
zLuCM3yP8?dciI>jSp+YM6YxhVAcf#pvljIJBs<^)^HsAgeR<b%o?UYY;^rUh(=<PR
z0ITMCzXjjtbrKO34kWSlj8ovm7Qo3UCJ%r3N6EqK<l*{Sk{hQW2>4T+*@^c7)hnn#
z+C=q5;l5Wlx0WdFUq{mqgs?!5Od0U0`$k8>>&SoSsO-co8viFIs6c;>!&)%NaoV1J
z6cvv7;=}XEx0d*D8@utPbjp~k{56-EFNMh0p5y$!PE2h3_<FUAhQI(?5DW#)CSkm`
z;HV-oFaKO6#K<9j9?NKad3^*T;SV>*M5eT@U*88>1CScpoyVz5q3!s0w^)gm#2OwD
zW=kCeAI%P>2e9_Z(z}1X$xQs1A%h5GH#dgq@o^^LiS;@@A<TcSmxzCpLx$pB0saYk
z7%R<9X$y1WIO|6<b%_eY)XggrLd#)X=Vh#y+pabEkCvHf_W)(zCL{ZjWy6F2lYlLq
zn*-lj{|#~0g{=$a(;D#*Q}Az<whSM4bBVkn86e1>uCEH?Nr?@mhn_vq8*K~ZpzOSS
zNM``G+?Pv8g9Ckbzptua;(jB-B6UK2fB+guGsv7@hHEx?VGz&HJ!*;J@`zkH|L_t$
z){x5EPWxZi2>E+|ko=)P|G*fY`@gOKG5-@cFNAC!32;LO9#~>BJUZ(GS@s8f-kSmc
zAMrH*YlX)MK<7ROec>+rMBVzjoWAS-8AlDtF+bnptPa+K4IaDzuwVJ{FUnsaLgD`z
z3|}f{Xs#9+U&6$!6j4Jw`1nUOXcXKE@sSwI9r`lULahWwt9clQt^WKZ-v^oH9ea;t
zeV^YI3OrB7)#0UViqbX#`ua%6xPeizqp&j|fx$k<zZ1SA&an`Pj}hSy41C@Z@VsIJ
zAvoaC(L=y^0*;nyJr8L=NIN)Y;g~1DNcDmL^WmY!wxoSJ6zPL{$$Qi)y8eW9{+9U8
z#Ek|#jqN_Nq!qVT@E!F%?EwSr3d1*_bc5sFzt&)cPJYc8|HjZRkVP5-_Or%7ZdmbY
zCP+-+{(`ESu|1>Jtv+n*|9955OGWlK+w<!Hmn+Nsks=RRh46M`%72DqVKxj1Twj%;
z5{e+qb=3}p0Tt`+pZ;;_4~O(9R!8LdC`92kQaBU>N>%568IABpnw}htCP&Dmz+L2@
z%EFB352-$U0s<<!1NYQ>q4Q!?R6eSPMv>SdxVqajFsR((Ss@TZEHfLH3{wDev&es*
zL)q+zra#uT`i!?H0_Yr!)}`6(r`jK-rf0wR^+OmG&qMzXz}KrR_sIHuF-SUzARaSJ
z>V_N>)Ww4SHO~IUv5v3tvyYs7H>f{6YjtU85Aj;0i9f^LB6O)bCX0)XKlfvR{3pXE
z5*@^#f8eJ<jTcyA2J8XX4BB?^(t+XmTp|c&hGTMuU<F>HlsM-A9a`7^qf^#`XnSeW
zF8Pw{_Tm2$LqpU`9RH{1jrWdzsdUpfe_tCL)ds2tnw0Uqg(GWE+)}^nI4c=#CPrr?
zG^Wd#tkP!vheqB6JthNu(EES<3^&lc9{(flVR>@GG+;zO;D!leJVq;v@o{>@#DDNx
zh$mAdt<a2CeCx!H{0duTz&h6C$VK-b1K%SZcy2-odjo$i5e$|I9s}k)0o+u8+9c}}
z5D}6lOo{WF0#?t_pW%FU>B)b90Ul3-Z{1l8mDL7xmJqXsA}AhP@G98UxrhT7@PHr%
z93jOSOc7Ra3~9{LZv0;^;D<m<w!~t5Oq||th9c@5K{{4c;|M96vj5`niHWI(XN7u4
z3e{bI6~YE}?nxRtgTKuNxXr2u0T*{2;EsSvB0)s!gaH5`i9ABUGctdN63zvbnVdj(
zBm!rfw+~%LR1epd0b@^w0RX?sVVelMxC0M#leK5;d1t-0xjAo!ArBq(sIGVE@Im2?
zM0k%92n~tw*mMz!+gO0aP;o#RKA9N*zwd#LOOO<O#9;y6H^=9*#WJ3b3{}oAn|p<!
z43QYvMlM{l=!;@vX6{_WGV<eiLJIY52$BszQP6w$EX(n*0Mz&a3&JJv7#QZ2H}FFf
ziQ)v*NJLfcR4|&uqX5QWg#0iHL3BE~9N!a808q22#?S9i{r?ajPY=Q|xFylqU=m!W
z9D0G~!(f;uF|C<@d8uYnx`f6tj4&n|h@mDqeL@02a9ntZ3<pXRqJ+WF2w=XkNyve2
zJ%5L&K`+z?`d`pJGaDi)c-w&dx^`-N{?;&t%b~{`&K1v88h`(Z8&RqOmswfN->fsY
zo@cFq02md%&wBLZSxGAERVF2yPK7<$U%lCwM+N?Rq_4PLe-Vq|lL?<|i9ap=Ve!47
z<DL+?dzCJzqkrckiSoVy#(SMx%J!+mu?eDr0sqGTx-}mTpn5i&<KOOQ&kEVd9BHnD
z{y1=LeK3epE;Zzr4<=2A_{azzqlJ#Y@R?82f9jEej|?Sr%Lp}Nci}ip&+1Wnc8_WI
zSOkxJANB{1)j=PQ@Qkp{#<!>sL;71_U(vS>LontC9u@H+4QCXexrj`0TV@XAxDqzG
z!|C@Mz#*%Udg4d*Lx%kDL$-C!0H*7WZPpw}+L6c^xt7664>>YIR0aJ)=ahBuCEPi!
z1`cOIS%AG{z1Sx>n(h?>$8LTiCpl98HHbB}{AW-dwXFvBf-7?J@FhN|H+@P%<h-?L
zFmC7ItIY7cL?QhdxJWyeVl&Nqikjh13(c%JiRZ<};n@=UOg_M*7Qj0&Qt}-<xI<V*
z@Ql1hZQbd3Ph?Em)DS`#LyPgF3DwhFk<6Hr;&BkignS|+h!POz1xN)$0AOkDkNMKq
zyFTUcH`cqP+yC0|WlQd8-~P}qcAH4s|MK%$04?><9btv|fXuN1Y9vj<0g-oo!ZKrP
z14to1i3NBf@EvRd2jCAM14`Tf!84`ke-byq4`t7=`~C*sH_DgFjl~VZ1pqT1)Zf!3
zuJMFQB`J)x|Nl+mV+m|AvWDT4q~<!b%m!01CzwnPZ3s>%CIxH=8I*H}I7k@Hv-lu>
zZY->WH-2uQi$aeM@eWb88W<!p5W1AZ8R2Guk<)O6pD)T<u)pt`@w_^|7=j(#E%p$n
z6L2&#${9lR{N?^3G9!Y?xyGnO9fBYueaZAtk2{b@oL64}eRa!-gf2ZD<C6l<tY6Rk
z20iaRpNNtIUHyjd{VxCq;R26L{dj)C{%^n&2}YcMn(E#<6L$1WGo#);r|nyZlP~;t
zjDn~nY!CEF{vB&5Av+AhOCTXg+dMB^p3?6=AV7%}G;d3OH2XtwaWVa%9pcuV2e3;}
zz-Zsh&YeVSlH@|A30dAA6ut<bHdX_FasoZjhV$QNmXjo2nZgV4rD~MP>N5n`Z$^2h
zJRCy!Mmz{iCWCGak?7zDkTmxML0|aL!tj*b#{DDj{SWTnBmz7an>RjqkNBCWh9dkS
zbds(kSRs-S6Eq+uDi{dEFvcn%L(W;Y@i9>nZBHCXAOv3uiD(T7a%bZ4Aqb_rla9yQ
zR?^%oM84n0>)>_I;vlCojAV9Zx%xyVjpKkZG0u&>_>e*_K2Z5HIPf5AE)g{UlM_KV
zL;wB&!aPZ^dxk+4^9?b?!E^zHb$om>n;k&^u%NAfM4rI-AY3|Hop|3I5=&^>7{D!K
z6R-jPxe>Ri03!Hdg3<!wdc$GiZNj{u-cU=P%m4xuMpcpmRs)>c!$q|I3IPmgKx=nW
zy>;J*&D0Q$8*}m9LT$Q&Jqms>fP2Gtd#C_&<9s8HLIEQ{PM$G^921c4k2pl+)*fFE
zf|{1&cA>GzGVfF(_gt(b-udO?LK&k^uR6PIn9;V&G#_?yx^oeK-$-Yn$FsxO7Wi@b
z3Ac>2vg>RNl$2RGd;OJd6Uw7`pXA{jV8Ba*ir*uE;3X15xK$hxFYn`I7v-E?VbOYn
zC8UcHf%~V^yeMiE;+U1+Kl+VLC`JG9L5I0uBzH$|pK*~BB0Qg%4*l7<>K|KQToFK5
ztoNM32AiB87XYv9_pj@B5EOeW&iDkP>M-~Ac;DbOQN{dhR^#!`u57Ft68|B6tPN=f
z<kR<Y4c>#z#C;`ia;8DYL;Sw|$;DHdn;F?{3IhKHeqI~v5+Pc>4}WgGshHI_F>w%0
z8<xp)CWF0vU?=7O4__z6g(hdjX054=PhCEfF<^z|=(Q3*UmW5$5#lmJ0%{NwM|*?>
z#zPoxAR{D3u`yg%JuMblB0NZAh9lrjtBo&l_rSd5^oY&<`EP*~_O_UOEt-}?4gFw3
zZ(ZYiQr(|`G&N%gLO2sVT1_7h`smKd-3!42^I^0}#4veSh*#kcC%?!s8fae_X1Sl?
z0E)500TV}!R{P<_fB2Fc`BlqFDwAK#WX5npB(T%>@ghNPfy1!0L+-b+!ZGv^@WK<<
zIPf>#hVF@jOaI^uZl|iIBtT;wYE;JY868k8LBSr~y9Kq-bYa<}4hz#IfEX9KbYVtc
z;sF5Y0PL}1s0#2L*MMyGQv)a?fHC`kVQ+!mum*5<ekEjpsiXo!83-TCqpSZCPep>i
znDAJC8|J<Yytv>n^7>x`6Kl2pa`!dIn5g?e0|y>8B$@w>@JFIh6liU}mDZ5m${owl
zt`{!+ScKRA1lX}qA;YZ{`5(foin*%5+X?%-JQdV=E;J4TWkoEm9f<si`SUT0!Ejl&
zFSFTLl6rR=-|_P|+O@`o=IhX5xh$Ot7|{1?4>%~kD`W$9iQvJ?a1AG4@>lyM^JvqK
z&p#O=XbJKE@x0Hi1!b0YDY}>frGIpBJ$An@i3&}~hm$av71Vmq^@rQ_Ly{HXQer$z
zBhW$kZy0h@f!XocL|+D<@v!gXYGbo|)dPTmC*4`cq(Vb_1O3enp{6RpfXLfmw-5Y4
zZ`i<B)?RF}&)yIp@KeW&Y8$zk$AdL>i{SWM+FR21<@GT*#~rkn!hVzLU_c?*QCtA{
z`_l$lt_%Me?7~%gO7!m0hvu{}nTSos6F>8x`Md+~TW5~y8Gx`3_LX>?XoJ;YOF-iF
z!kisWC73_t#kFj%nv8ip8UzY{m+9vbAAMXQk|TJUhzL|f)c3@QxMKzIhI~xeiMcou
z-Eime5_oQX7>G}%Px9q}R-HhxPl_h|6p0K?hI@cxL#*O8m_g$>ILJUstq26gV}8?>
z&rx=ODR#=hN`)}!B-4Q&rqu3I_xLCh7?tEDddU<BIR>KSBP#>&VS6)WSsdOn6N|Yi
z+xTV}fXiJ5m;bs^Dt0RXRPY!NM{MZ*;TCApYW~~#WEjc#8_msuXu<p-Bxiy#Pj2Wi
z5^w*-aA|kOItjf0#&?7Sg(F7T9iCbj@`3_dC<DA-2@M{aL9apt5$H-bs*l2KZB6q!
z<p+i_Kh5FTvAlPOVoWH*GO&QS3c({o`BXdmUF(gT&UBVib%s3h>{H$qYt%y>Shg%b
z#Hru^n+&20ARwYaMDf^6;DwHi*$l!KtPPs)a~_u*Cw=h}NMq~7O?Q|_JJ5~9g1@ZJ
z<&Axj!k8M{D>hTPec}c4{5Xq3JP0L)#CY7$2y>}u=A{R2cbv@F66o)-m&NY3^A-q{
zmw$-`bcXE6*Ol0^XEpn03iMF|h^Ig({AjK6R($UgS^TeXLYlMbVmHF|K;R&DeY;HB
zkHcah#*)LmyNv&Wxs&*}Xi`!zn}`^i11&*^3{nF$;WN*DoJ3E8n{#F#UJ=sp+XkO7
zIQqik_}_qq^(|VIvJRR0OdWXP2h@k)Jq}K@uqRob6`Zz(`3;!$fqsun_N8qO`Tq~+
z4US*1nfd~K)H}2FN6dNShPmM%c78frYx#pC21f2%d@opPB7flw;DG{HqMxv}6gf42
zd1N(`I99xN8}cQ`I2osIl<#>3qWwKB_gp0*{SS@>O#o4ZA8fV4mN2uK6g5n@D3!t%
zjJOISZR~JV5NadDYm*N9jfn7vgghaFZX-T!_})xvXYnr2OXcSEh?ARTKO{$nLmWsT
z1zV*u*xix_OXO_*Gb=)CtqW)-lD^z3Qxd+MVBqk8*rc(|pk@5$zBF#Gw>(jCSp9P^
z&AW+iwdnf`)2WVW^%XwBe+&gWzHw4&D4IUz$1qg|UEF6`-U<XrB-0&~n77Rj5%O~4
zKMD7Cuz^~S9n>UX{$T7_m_@+v><L<jo8sw@@mux6SR?VjP)5Uend2gc;Q;|2`FX~`
zgW!`@0PX0Scf{)eiLR5+jRLR0&8@e-7le+q2VIZ`usZ1G3ba>eCP2nFL}tQK!|^}(
zQ{yu^MIr^>Fhjj454>J-o<0!Xd+c{=^)EVFi5~Dlo86u3<K_Y@9$p5$@C~@<rdLNZ
z?jHQut_^vfAZNeR9S5D%`Ig$XIKH33nltesN^7|u&vmAcyC->_s)$=IG94H)no}#S
z*lXNXW)9`cHag=~_LIEM&haIJR-ayRukgQ9834DrEVd#LYwuC&qGjM-GjseWDFuWb
zb3v27ux1%hEiA#DZ-p=s?||L^R2D?D*y!pr;ay}J@h~!n^$eZCiA3Y;_uTZiZuRg*
zl*xOstY@?HtB5>+vys!`PjJNByZ+Aj(Zo&nZpcfS?@62B4$grPUK%vZY}X$L!Ay2F
z3LcuUQ{G(&|6JzJ%ZP<0W)C@{7kENwNA8d~RxJtY2WzX_-+S9!Pg-yb^B2TUaJeaz
z_^;-G$DuRMZvAjifX&0XV~SG%>!^&QivnASi_I5Z@n3{;$q}|LTy{0J!<5^#Tf@J>
zCOb9yG9nY@jr6e?sACL41}N_d_cvuv5tExV4GfVQiG*{ACg>0WP!aE?X#3>&!uL<U
zeRDl8#zTuM{^*%^ec$o2Uby|!owL28`M$f9d%)%zPxk!(9+FyR1fgDi#;>3*);4B+
z|M-uMg7|-TZwqLE|NoNFKCvK*pu#&h>Ki)$z3@%0<niyUL+F#Ve~}>uLGX@1knn({
zg=D&eV8J%cy9AoW?f>_!hMWK5MPNS%V?}b1vP`JDM6;pdB7Cg)#Wl^H;VTMztUMuv
z>><D;dMkGT?jW2WfF9NEkFKY`*s&!)<6w>9r;p@SAP-?D><D&k&ZrFfT>wDepD&4<
zyFT|j7)r4HSxstN{3-0$DZSa|mzv-p!U)-0Jc_7aX95em53jShDkcedV!LeQjo$m#
zQ{OOVJ;G|f@c{}iZbzW-eHJAp)_1}+5cqK<_&3%sop8nCMrI1y&v~=LXYaiIhFyxz
zkz`FV$$YclJ+p})Ze8d-UiShbzRsRGazUD*)1d0>BrA2QnDAG+t+HMr1QNG_dEBN;
z+`X7CJ%J0jJ{80*Lu?rrrgZLr7?sX%@1|w_pxyQ>1Rd@F;za(R&gjj4*x<f|NRJZ{
zW(Y{sxA(~`i+&;_9cU&qHm&=JO&T0w-V@}Q*0_tjl;SW;5jEtZUi{WmsSz#+b3pI%
z;yg$9i4RT2TuUmIwx0YTV&uq7*}#MitZ4PZqV@~?F>be?QoN2ChSfr;aj9(t2mE!g
z8uU>k8tbOw3+)5}>K%wAPvUuK<f9CK3iP@<Y@>F8O_`P#W&ih3J2#i`j&2%@5i%0S
z!)Rz{0wzOAkRZMP#z8mYa1q+=Hhuj?S8^T7|DHbPV2Q8OJVbUEG5A6=p(yLH4!&jT
zmzj6#kf8%i__~=^qs+kbG&GF<BLi9pA%Uh2{VJRik>C6!09!U%9O}A)d8nZS=GDgq
z!U>uJ@>oN7d~E_5Z=vpMfa$Pa!oT<n>b_*m>aJ2SFoF$P|NX@Vv6{5*|A{1(uN^iN
z@HM7?2y<-iFfKCiB+NQK2D_{X-}6L#L8a&zc@)f1>ii|cx%1|KZ2T3(`;9w3Z}!7p
zbr?H7?dxXoGkIHHg=fA9w0x?(FFmk-5EZM%fM4x5M&>Mz8?1~)s&6G3Bai<QO^2HP
zOwM8i1Ux#p{VR4dUJ6^{K!o+D9v!v=ZkyVL9uIALNB4kc7Vi!{Muyz~TwbvK07CEs
zR2=P&dEbU4z?rJgD&r>Pf%TZ>x%8<0aE}|!94k2CurcH-lNK4B)z#uc9NZFrsEO#@
z4!e|l22s0zoI2exc%KqpHFp~fVN6UB#CVPJX-Cwt5k9ji%E1{c4DKVuZ;#0g@T<uX
z$q-Q-+Vw949k5PqngAVCzw?Og_1+-%WnI-NY>NV8xuzKk-9io>XZYAfffsH;?n?~_
zBw@W9c<^e$#|>&!Ts1D$NM@ZGk>=`tP6#l?@qis_-9PRvri#?uieNGK#FmRC<+Uw>
zkKF$@JRSr&4XZ)#9gcW2e9RiWIDTXh&42Pcc))-E5D|dW>s59X_h25*Osu&F{fC?(
z!~287_FjPW+L@pJ5biDo^fcL90A<{>+px%8*{`!3{b@h5!|?~0xOcDb#K8s}LU!Qx
z$Vxr5ef*y$W`BaZP1zzrzTAsYt)3<Ke*bfDoM24v58n=4Jei0nlI<@I=AYtAnh3GK
z4{cKl!Be8Y#|JL%2Y6*TCWbyy`iP8?3^MB+a(EAjKrLHij=V5B9JV)=xcu}BZ@kZp
znc-f#_lLumd3i#^!}h|lM0bAVNrE**ZI=^#5OU#hLy{I9rd=IjhOvW(*61^iE&;{1
zNwi`9B)(uN_FuJT5KkJX|M3hVw_ch5qL(kO%i*j{L`E6HGM#I<ulchvU$~FlZy!Gu
z9G&*EYio<}P2fJ|378(10qO_?_(O<n!+2IT>$}z@F980H(xO{^?GW;3zW{{0ntOW0
zEKW22JI6CU)M0*4Za?B6uB>R#tCP}6G|Nxk1cu{DZJAUJ<!EzQNy%CTVlPJFUi9)j
z7+3ItsUcFM;<Xt6{{$M~t~HRC=`SWMq{4daS31Fib1cAhe6m<?v!3`V>fxn?tQ>F2
zK34J@0$ms%>$heS!~DERpUrdnV5?Z;jhWo6Yiz0C#0Bnv3m1Qpf<h&g1bikbWIJfG
z>@3fj{`g12Mh=Xu1Gm9e4}w2>2!9(I85V#?hx0mKCy0UzbbrG$JTFXdGbNy)TyMYJ
z3k|7V*wx&%=TA`(R}3t@Sm=V)N8-1b(Ev#5=NY-!$j!3*<bbyBdR(--Kk%f5dimup
z3fS)s`24TF{*lIXpW`>IZ|A&p;i+OG;TM4_!t9IMB52=Ji)*sybl)Gw)GSYMF!L_(
z(%pX<#7gb;f4CCvH0$o+n=kM`gpI+0aTw^22nmUZ69kb0Y$t#M5gm#v*o397dmaCP
z6!6rBD79V!8XI~&)Y8W5?<>=hrh}gVb?U%6ic`R`8R8=RGQWpRpK7_TB-|$}YrIF{
z9;FOxP)N}JofZ!lHAFA-$KxU79}Scwkhd@D-{Uum$+mSg*IoYbUpUYs)&%bDb8`O@
z6q!Eh%tA5gny<6*&-TsGcogGbc6;BDC}KU#fH(KI3WyLCfRqy2K78kGomRO)nKHjm
z*Wa}N_>G@M;Bz|X2{_*bz8u+u1ZKt?fKt727G%tkUtiXBgtu#HH|%0=+5W=JmNG>A
zL>1kX8GD}75DGoTdHBRfFgMkU=i}<;s6&S^5#e0#4-ZjTV8xN(OXhLEJYMGS4nTL#
zRlbq;q|7WJ;wpdf5R?{o7{EXr3GUAET<7C{Fwi6>?ssgG`c=$oaz(bLF9O-06v)f1
z&-g8n21oXN2|M=SKpNt{HUwXiVtTB4)W?&cev{W8@828#*L{h7v73~aGwLjxkk|O!
zJ-L)nA@)aa_d+cxbXDKZWj|;)eV-KE)ZJa}&a?)7gv{nIv#eF&ncV&&5aeAbgJN$^
zj4a!V`xE*cap}fmODBv^`7BQ{l`bX}fJb|~W>J$8fSs?jy1b=!cQG4)gB~f3T*NWv
z4*iFRW<;<~A~V4CZ|pJs_-cQt)RLc*f+~QOBcvbaCSAlvdGIaOAC-7Jeb^#b3+(9*
z?#$(cS2fy^$>5%*tHeSdfp2l@pLM$c?cKXEWv7z~zLa~`Cy4xQm=f#k>Dqs@HI444
zwaRYh-`_WcED*d9cXOW(r}+M5cUYOc59s7tJg*K<>*m5S7-lEABHmm{Yq(pM`?K*e
zFr;`0L2D*wW<Wq9@dgS2;2{O5m|y@whai~%;JScCz!)4e!7fb$LXn5S%WFp`izt9c
zssu}#1r`H<h8Ch=@Bo1aAeasSh8Ch=@Bo1aB$xotWwA&6CxEyKK<=?=Q~9f@815Vq
z6Lp{s1H1LVz}lLCBlO^6Pw*kZ%B>Forf2U2c;siNz+?0Gz}KT#12xnN<NfgSfFVhv
zXb<s!`~@HU0<ZSLz#{a2gaR^ozY_{Zu#;Zm$tEUtUNeXT{jJvT<O-2p55?rl)%Us6
zHI$FUwk`wSBq6A;FrBK{C_29DA{t{cdomAuUx`}x(PHD5^_9N&mjn<Eef0_7CNno%
zV;hDfq@TrjF#Pg=_{zORdccIX1Rk%C&3R-Ua?G%()deTVIlJ+jg;t>VoYyhJmF9Oq
z0qpy2Nv6*i=*6Sp?H9p>1GLuH;5xeI0rK09e3rOJ!w;JO#%mr>AK}!AbAN{z9k#R;
z2VQ0VAhX7u;z^|2T)*wJFSPKagze)TLX)k~ZY2GjTjT-(QsChJe~8C{2x4>}wz^WM
zFKeJ0+3ubwRQOY5QZk)(J~P@ps^68bb$;lL$CQBazi})QUG`rc9gQ==e5x#Zx6kg|
zd+7Wljb(EU+;7MrhhTQVGX;;qee-zLJSDqn4V~P7e3+|~_@_UGDEmwmZ&1N~fbYTD
z9_7OjSg2#(y0AccTnNFJ_Y?VfZI&Z6Oc7J+1H3ZI?03V}zA@|L_uwqLUw-me7pC9Y
zgInKFI;fxdq9*VmYY%uvSlmq@ld|0*0sxMXiZ7^f*TT*^KG%ZWYpvw-SO7F9Vd0=R
z@TG7S5J|#XQT^E_-Xkv;X|IhL;xa-4Vgif!?|=VZlZnP@F68qi#9{1CC!m{v4geSB
z1=fxro@KVz6utT|0sr6#&MHlBob%8Coq`0k-@HzM0@lDmHTp?wn#|91KoSHa{@85u
z=zuI3ui4CONz0#Lz!(K0jPZ#E(MKM+!U6UG5(6ioFw}RTF&tXIz$GH_goL9>AQ?&n
zYydz-&fQx%fiM|@zc8b2@J0`+wwCiHU}gu#Eyyt5$6<yRtoUG_8H65rpMxIwx?n64
zTCw91uM7bI6#N4p#m8aAk68Eq$G_*IVrIcNo;U=J23bJ~iH^rd07&q4m^7nLsTXhe
z{dGHv|KcGD58!{J-82NMiKBS%1X+Z@AX;Pn**>A{S-<=da2zpuMzj6!Q*HI%atu?;
z>BbB{tlhiAF(CIIvIf8!b3;Iv?j!JyH<@H*f|jj~=4XPgMG|-a-!$%h_5KO+T_{S$
z13Rf_I499%jyJwLs*D;(IMkmxv+s!V%W0y-c!?~=XXAK6-|`M!C%gSlR}@fy<ej@6
zF_@O{9>y~5RM4pOPx#4U>l^|CK?1)jfRXqKmrp;hTeW|P-zS>SA1x)<G<eZM(k3O(
zo@_^mpArdY_uQIh4~)M22Fk4*`SrvG5{@bQk;jB|b}>-V?*A<l?-49OpPEKvmoE{c
z@sSxjt0RIeA|e4U>$d&eLbOFWN^ifzo#i{e3PDTdm4>}Ri(nA%{g6<5tu&QTF!%Xl
zGIMJ;@i={bp}23-HM>o)@!!u+!Z`2`f-j93$7>(^$aMz+ge*UMTZa{2hje~v-w}BN
z%n#mry10+{m`5ATZ#7`QSOVEEB>%@Hd5ndz{U7dSf|u9O{%VI|qyabh|JLWnf|`Ox
zjpz?V6L{HeJLUA;A%F0wi{rlhvgh!Y8NQI-simlLdw_x94`vugjfZWZ$<+o}5^L+W
zzkjyix22!I@Io{`X(4A%y-1Z;{!cxqi9Ej(;wA2`BT*T#Aq^_V(>N;a#zbf0{E*N5
zM3{-X^mIlEA_V-@Mab5W+kggU`>yZ*|M^jjE&uzc@jQG$ryV<YAdkMh5U17zjo^Qa
zQa-pAIA$K)|J{EUCmdh6h|GwJnJ*d})82ECnV*BjRjZsP{sv+17r?*i%LtIlU3)<R
z#0e3BW`>pmN9f*frNCDIEU@p7+ncb)W=$F&6*whe9cwG|un6lXtfRiV+<4BWH=icM
zP>qFdp9Fd<08!!ZztS1c#zWhl^8K<j8wsGhCc&`!h}R}rc!4rR2`^XTY9sJfE|L`9
zFl|#1={U^N!X^+1&xxB5J1*zrL3W3-CLpu^3gR$_5p?HfxR{US;Fj)PbzgXqd&f|0
z@<d78V2HEO_5Z<Eo4~)B3~4N|`FylbuQv&5x3VlgzssvD=H<k^C86JQ?jTNnGZW%(
zh{>5|)X7{&#6uAnKr4cOO#l2tq8;$hHerM}svBT+zcggCTQ$=1#M{91yAifp9gO=n
zB-+DQ1|}|R*8pLAbiaX-s^7itCl!QAKcC(v`MRR_t11%r5vYvVju8J5(cVsKIUor3
zIu8i((h}1kpBB#gQyPP1M=xd`q{-qp5F?1xMj{Zy7)Bx@UAtkPYJ{x=fQ5im!ff%_
zBzUgCMDQIcaS3I_D31Sx(f9LsehLS}F&W;I{JtrUbS-^L3;lCr!$Ag-ah??2k*{}D
z1S0J6KLN9zm={a6W5lxm1@P{$hd!C5UNMJ+Ec@O8*I3yQWT5}Ycy2BTcwrl0<+y+|
zvAp&WD+XIwnc_7OCxnmd#Q2$OQ}u*z5NqVM6E<-OBzc_HIQ};2BLk~w%X$MeX*>t*
zb)62I4=ZUg@#}6CY<Qk*HhD-u@|T`Ev5-R{gEBG(0QcUvCa>Km!@dzPIbcZ8Y}6nP
z54L#Gvrz$UHO5aLg6uO0pN{6)AQ(XVPk3qvgfqN40rPlHpiq2ggenL_;||;s%%cm#
zs5TB!kd5Wu$K{{@n*@(b3m%eN{qUwSI0R3_nTBxNhem(!#$SCycU_0aX6qR|<ERH*
zHzwi+!2j^beEL1%0Y3y3f+i=5E>WQUnTu?DAN)j}rZD>5ckk5D)=93~oV>9glF{=l
zM3-SpTu+G4!gXtgB7B&FAorgchTwpP^)3a1W50$Y@uMCD4@<^8cCaIQ-$NEJCcBeN
z`0ycmS=WqV=g&Mwu_W5R<Kjm1OFm;)Ge#lwRqaU!qIqO!j2c8`i184d)bP57#`Z^W
z_O$|!06utjsgQ<~{C{)}8*^BNh}il3L=tvE6~LqXcY;SiV1fn^&0%v>%PfN~LRX0K
z0z647#uDh9&kEX-MQ!13m?LSOdWa691E?&lfB%ZfpEN{<+yEmt-FIL3NZ((s|0gzZ
zgmg5ZT_eZX5+MGx+rY-psWMn`HlQXF^WiGBiDTya%(q+{zm5Ndd}WfgwM~@#5ny(D
zCEvO4j@ON9yF;Jf`JG~GntK&r6C_3qp$t?&nIbh4kKx!9xKf2|EX<%^%cteaS%`N%
zDSH2sB5Ol_{t%}8GSHb2gx8CR*EW#^6HWo6$6!qKemo_^Qn>*%jqcC+rv(}RTu;C@
zO@E4zGJnt;xStw`2#u%<-G9VQ8JVjsab9n3q=*wFMBZNUJ|;+kH^P2s#|OA_?<jvS
zAIOk+vMz9smn2wGEZmn7mJk!4pO<8Pza^)Pdl7<&KqFBYLLyz=lf=Rt)d&~|Xhg))
zha+A)2{_x3k2A0f%mQz}gihc5-UKa2@44f=Bx0Nhd^UrKw*}$wnajhki}g?1{VvJH
zWn;GY5t<-H;&_c>ZX#?DxA`(T=Z&d`3nU80!~M%!+RjVr;A2ds$L@dQx`B-{jV6c`
zC?Gim8-C}6GGbwTGYrJud&h8=fsG8z5XQ%01RusmTa3Oo61w0&ReH-j^L&y%_U)&_
zd=u4Eu3Li|?Js!mi}cM|&SSo-!cpOQEuc5%A+`qn4>*AhAi*JIh~GDc>4b<ABu4Qw
zL}FqiV1>J!9ZjGD-lcE;x>i}|kMu@kkxqE`$2zJ|J1`<^-ruNRd17Dw2>EgBp7A~>
z#KD##SdH*OkU<2`AC_nho9pODIGtQQ)s(RIjulD|@KwFzSPlDO0=RR#!3uI@wf+^?
z&?#u2FTXt?T1sx;=HfA>>lPlDlVx88Tz@E6G38+=9wvWlws62n$K-|0wHbLK&hgNO
zZb<mevj+ywA_yVI?ZtQlhHz#XmimOBDC(rwmf)fMt%x_8R34~7#%b_}#KeT(|BrX$
zp$sn&CORNb5&MoCFQ|+u#913-9^*CnW!QT^-zBwqI7&MeZd(W{%kdk&&kUI-cSUy*
zsDU<jgg+1?JGrqio+rXEJ-{Iv%`Xt*03>p1B1s4lD5&R*yx!*w+o?TM&wwa(-F4Uv
zdyj?~$X7L)L7P`6Fe$DVrr3ZLCrwq&a<ij_)&iod8#%B=%Vw)KJ@=;N)Gr}(x$k)o
znz=C@q_K>-<fWxSyoo)nQ(IJ}wjc^LcA3>~7SV(F_|)2|fCT7GC=;w9qZqLxD^=Gf
z1*j`h$eqQ)L4?zoDggN`C6yQIAfzD=5(_VuX&5m2Dc@Gx^Mq_2^0rk4F67@LAP#uT
z%T`?7Nik7Cpim2<SiG*gK0zF9<d)0Mi={KFje~u3q@DFBAfV?bTCO`_woz=UwyQVm
zK!8Vc6}H1B0)x38=^7qKIc=Rlthr1!$t(q!n-deEv|0mjtE%BSwMh9y$n`)e)i(;{
zT7(WoQHiEHCUA;Q>M3Ib5)q>2XlES4E(_GG0b<EPGYO}<bQ!e_wO*DY&05qiS|XSe
zswAhqs#zJWI^60K`(OaiC{uceio(u-)4|dvuB5p&4M()c#k8m1?h@TI2MDZaIz9b|
zzN|75>HS^)ye=8<QTH;V7h(<d4}X9m8qd9V|NsATYNSY@0o~_Sx^<I~Pzn?aBbo)#
zhg8#1y-F+3L)SJ^1vP*ON>w#Pg)d5}mh{?-phU*^S<Ik$jq);AIr&yMXm4hhl-NGw
zp}FN=P-QD=mUX%;=+maUWfe|`v6UfzRT^~ZQcXsZ$}Zl{+DwzSCRak6#afz53h7p=
z5UPzk)XY<%Pq1d45*t%Vy9+vU_^Eb)JFgsFd&w*Bjj&^Y#%m@wYhx28Qmr!cAm@Q6
zIiH`jN|2UwCCQ+RBnki(H<z7O>DEp`KqycO`RcT&!-amtK&@)w)1}o5y=`^0AkvJ+
zCO(!>GA2Dzag9lquWSfb>B7~(byl2^t8+Q;<|hR_8D@IzQQqZjGpaa9v+7oUhuHXi
zb#<-9vUW6tofRo9&vyScp$LNBKuH4@(vqYIMOA2cV4a(=TYfqF5sH6Xcne)teKWO5
z7^^Q<J6Dyj42#IJt!eJhe4GFPK^{Sy0O(&It7@EHx~?miyX>DC-Rkaxt6NQb-u`Z;
z#R&L9O4bE_PVW);WBw6^c&WT%@_zf)tAwQfx=*>iU|Zz7-`(E|Vg%KF-^BCft>1lA
z3%t6jhB-I6c!_YimkXRIy|(uM@S=wFZJ%@L_xw~w8{sc5N1FdPNWaU%CtY{hoX|=L
zGV<}6*8~;Cap8knNjw?8vEl>khxpM}fw0kHmoNmccH_T$*}7Nr)wSaw&TOn3wTvJq
zh{T8_Wub^xi3ni~L9@j2!U7e=1o5W7{M)A&5ucM7mHZ>JzG$G!{`oOg`6;DEh{8wy
z63iSO6RSprf-r!DZCD$|z1aT#Z5fSz6Si~X(62iP*f(fyc8A+MCt;0(h-O_nf&k1I
z3uq7k-a8;n^&#jFjHI1^-hlhK%uf;^yD1>JPVzzYM}$knL}r9B_=ub{2x54RLKxm^
z&E<&vCp2p>>xr?qDu|hzYm$kSkn+(U7)y?s*WExnufN`K%NfD6{9kl~Qiq8^KyTlB
z3_U0p<h3s1HSnzl*{e(=;L)A;d`!<D%bpk@=CUjk#Nn7*n{GWd;(X9Nf8zC0lnkIJ
zNPt+x7vbxNT}j5&3J+d5U&^qFVpQF3@0iHxuEg_dqu`&yT$W5QOu&Fv1RwB)>0#h>
zZC=L0uVl%|%a!`%qC6<Pwb2OWsw=)PHu)nr5r(3L&0K9&trI@!;hifbcv=t>1kiw(
z&TK!v&4^KX{40_HH{0quK!F|8Sem~LZhyq!4a9oanEV3Z=A17Yh}<E*E2~Y91IV8c
zdrr>@!zc;Z&y;w`zX{A@G&+M<HDwJ6vk7aPGE~|iJV(h+nben#)=&W+4{iXOVKn^>
zMg+%>-qh&O8}P_jEIm4)56QxF%bGc(<f-9bE<3#gT-$Q8Bf4&zWaZ7cW)Q(Y7n42D
zxQ`Pzmj&{4ho4>&kd7HegvPL>VHh`xOkHn?@cr<^=x+uUk|V@;MoY2VE+T$N^uJGu
z_==`p|E(@*^%3zRd8s~k#oaBHCwxyYOLmD7lb3i;!vYJ5bIXEQLk@Cb+Sl-%{z&vr
zZca9C%fT+X0;qjHv?;k<-a0aQYK!<z(<(+{#|ra!dL0MHco+G4`%4Q<Y9k;?$R>Xk
z7#Q2CBM>g55;B(Q#F+OTU)dA5=6_Ke;GY?DnlqNcf1%fhOMJJYcZv9$)5|UMSxS@Q
z^-#)Q5bIQ{iJyy&2HQuQ2oE;=<i<fBetb+7@^Y~^7nAOqWI2QaHHp6Lj%znGXvell
zoPP;sX+)rNdAT_61mAe<bhGFm9Bv;8v3OW@!aD1N%596SpF_N;mkzAw4_)s(yu6ZY
z5vY$7m%Nc?<D5^4zDVu>mq2L0er7xtQlcoqU}JKIL<cl`u5SCXIM5rNV~G4G=F_}v
z!yn>fzyUP~3-az*{1tUzsm*xWHm2q6N5KIOB6;Wy<-;(XF@j!7O`nLHq*O1PEVs=f
zSZ<k<o3WLTH;x&S7~gkoYlSe8hGZ}vmDg;H61HGkoq17q`=#Zq-d;(6@=dxA%OYHf
zd?h@Q6(*rrD#y&O60G``N(PZ&eZs8`uA#jaxjJP^_)imOMEIT~EVrV6FIV$x9$yI1
zW5ble1Ieb?qkozojJ-wkUHy)R9s$%k6$dhC!v_6#FaQKFhVckEe@}i8r5xp>3rG9V
z%>>jP_$J3oBmra8NBzeV<d%}+GUErcqC5pc7$b<!iSaXXVV-9uCb@GrQ6Ca+T~*wq
z7o@w!jQ<l*h9ioOiG3XwMQ;*nEmt>kn7&E1{|VwLazJ)3@Rx+y&Q1N8(12zy3CE2+
z1)e8+%ffznbK~Ot*<{RTFCU!iI1&Eg{84Lv_`67iJOwJKMQ&{D?2#MdJh@9udGQ$A
zha2Cu4+`XR9V5RsG@1Sohc58J$^$V)-hGx4FqH|#_<j6eE@MCdga82kI=K;s70lK>
zXd*x1KTY*R@jhrWYzPQBdAU3(2nmIv1lUji<^L}U<cAm;Ir%leiJ&;h&v~n#jPQ|8
zX&wrYCeG$z{w^YWJ@4d(GC~-R6PW&;DD2Ya@<YZ^*C?R@0KJgX>Q+K%Z#b+VFJ<cg
z6VEFY4)SMwk?DUC$Ju6%SlL5y3@rcw@pfi3?qI`e8xO=Cr(k|3I6)f#9`c0^^}#*K
z2aWR@a@AEMY+>TKj-)g_r`%wK@?Ijr1uX&-Yd!4$u1hQ5HldxuoV=6o9}Hq)0Wg$C
zq6Eb886o6>;o|R<#nR1Zh|k7e6Y!>E5r#e9^iYQct-v12yf255e9n=5M}LGZK8??_
z_+5txb0(Pkqsfnt#tpxlb8qG2MtOO8waeUgYuH{`-h2n~6Vu_yu|JEMOmIL~1Q4eX
zZ85)egrPnBUz;v8bq(@bc~Kji9uXAqZ#;ep-U9K1w+BF1kaRtMH5>e9l#NF)`3uAR
z&)Z4;v_MFHF-G_S*w3c;C&sBE=sCR^9-ZIitvlt*0>>vbtT17iQ3~e?!d1PLxf6-`
zdPxH=TgeAJL=tnQWbqs)K~X-5{7iD6B8KGs@%(7dwh+%Rh;~0h^Gh+^*#hEgk}>C3
zCN2?%Rk#Liv8e1(<O!nd$gMH?sD?}b;<B8M0?6P%DrXdm5AM^95@4>mG&7nbIrz;H
zLyRGC#QT>=P-hfz0`S~|2UIf*4!v-Oz@Z)wah+ZXo*&<}*9wcqW7k*}Ngz95N)fva
zmK=cMfKegLJR}ow;XmsV5TdyuJTgLf5*}<|5H#!YGRJy5-xZD-o3(+eF`RPZ;w95<
zaoMlS$ECmcM?h*eFq<$C$CQF)`QP$nqYaVaa3&viK53M(9ewj^Zlf^*I8qQ34{~0y
z9M_`xsD^@2M}=qKkHSX{NHq$+P{TS>Y>7G`$qkVAoq>tCLz`Y%dpA)NVK>=nc+IM3
zG3&B_)H;hF#oTq32BEFsCSK&{N`j1>UsL&xHAC=^6~|&wvfhcRbPR}myh8_ElN=uj
z%=vk<C*7Vqmi#Bf|AXa}2mR1>1-<yZtNCAie8K_<+cdNfhtNYg6iWsd_XKQ@=YD}#
zEp7af>3wG3EZa)B%xJ(8Z$BmGef_56&Jg~vcESi_2M!KGXuRI63}`mP$7=#(!xK&&
zc(4~0mtFUL@qS7ef^+Um_{k_VAg4z27t5!9E;xH;P~De=>FJwuYUA-W7aB2ECu$y_
z$4C#U$L<&of+9jYOZ?<kC2f6kcYH_Y$1ZivswgyuGjdbMW0!d$`Da5U2ImdMX2?Rx
zTo?>B5LbjISZEZeV4riCpy5M=V{W$!-(W`%tO$P@m|%vGSrkl!oGQ-ysf@odrX57@
zd%kX2zmj=>iiUL@3|Wa`>=`jMx}sEUh3H;+Z~9N|*B5m6qDk>kk&0r~CLhsBv3Q-~
zcuOF`Pq|Ef2_t*^-*y>;tf>88<dOxXYemKB7?e41a5OPuMAr!Q30OIGVJi((IS$}>
z7r%^;0}6rP!_chi=Q50W<%*l)^zfe_FUyOYHHYC1QaXH1eF22d41$5#-|~3QOOLek
zn#drugDGL@)a`e~&S``wp(2F(_59G%4C=4|6?FW3Fo5QPz$9iL9tAw#fNs0N1Hegn
zVlH&J%(dMta-L5&@Qm<;8=ZiO?$`-E`|qHAW59*;9r-)7dEnL%#Bm!T<cG^0H0W$+
zz}!ai;hR16|5cyxp4%iMdMJ)FrZX$YWmWIK>fa_9g8^gkome>gA>o(b#qAu{^y`St
zJt2>E#7A?1_Txr>xkYxL8HS(&n4&lAt050>=fm);c*C*mmH(T=Qf%>+2^^<GK<BJ9
z6lxIUx`fUWFh2s&01N>BI^cjVH_+m#*IlYpFvFm{x^gk&E#Jt%w=!HZNF5i1B@F2C
zCh_feJ@jvo@B;SPk_31<pH6`1$5?EUOE0{>cl{mzC8Tmw!h6g^Vu29!ot`@zh8+b4
zK7*H`e~~Inm)CNhe-q0IQE9Gg44M&PL;RKZfB5-PFi`vky2k-ji4=x`9!VlSxBHkN
z2|)o;4g>h_0%oJ}7$^FqggL~}Nr-jbS0{2q8YL5s!7EJmFh5>wvDr=?|3LZqvq4(`
zghmP?KPM;oFC-lNMm!_ypiL%&@PzQfK~trT4xh_TiBHRnWBD+dh+o1LAf$!r(M0hw
zWVr5WDDdO)n|9;$GY?35a{!yw9ewKmkJi_RcQ$-v-Tn7KoV{?qD|eVcYz#F7FXDSK
zira`{Syo|1NtRC~5Z%w?x)VtpVF{dUcAHWf3RbKD3tU#v#A^f%-!S&RRFiS9)VzG8
zK!NP7fAAD0cXwMbjQcvQ#l?4y@}(sSQC+b&!B%lUC9L`3A1p|exHTBmO~E+QCG~k{
zF`4nCdkd0B@#9vVZef8X`220H*#W)WGcHIw5Z}IMkPto**<OPTvc|s8w;6#igt5OR
zjTmlU;XXhmQ&vBg@<GkTU_tI~Ihc`xaa`S_4=e<I1MytN$HJD5zFKhYp(yBFnLp;d
zYc}KI8d-82hSCA|Z~5@sb$=H*p}5PD@Y4CfH_2>0S~g_j_<0OPz_Y<tsZ|Z15ilH)
z4_{XFkNEzUAA^+kU8aVFY~YKf3>C)z9dX0GXc;a5Zuq+30I!3@AiLX1arrYCc?7NT
z*q7MLT?S14T0=nFKZGDP?Uvv`5Kh<_DXk9ldUO!m0sw+>;5IMKj-DZHw~K@%N>qcH
z8{wwzg2V(rjTx$2{eSR|SjVWfp=)1h6f~4e=`Orv&jR%D1>JmS3u&-(9=^BV(toSh
zAA0fDk1*gS)Bp1WSBb`hnDD|*mtfx(mC(0I`2M>bgX4O-?2<xiq1!P=C6~f;$%pF8
z%g``L+3|iReE9GHznYy%Qgd?QaYSp0mLDV=@>9*eTUu)o8O!CsS;<7m^4}kg4?oEV
zhHTG>%gy6d_aihq;<}FzPzup}MU0Vyc&okqep&YALx$(`q4?~nOdBzKEV?gs0MPDZ
zwD~zB`E3yY;<OV(qd;np=B#q+Tptr?KpywMlI~@l+NpHBAzly+beIJ?<O#heuQ|d2
zfsp*mcTj-&b~oFaUL)mg8FZV$2gSpC$~5zy00XUPe`O$E5{v`11Ghjk!(1WCFkB~K
zO4<>wAA%A+`M$LLcCrW)gcTsr`U7A-{t<-cj}t=mamU4gPADFiMR@vrqW)aK`uK<w
z`vOc`ub@jzuGl}kPv1ohwarMZB3^0nnT80&%J5)qK@<MkWKh29g|<AkRPj9oTxf+P
zJPHr-+Q&f$BWXIwEgq-k3<@|)Mgzce*nCAf*TYgJESIh)0G^SKK;{p5FzI%G3E5s~
z)=nZ~3tQ1L#6;1*nf1wfCtQ_$9P@F?KbMktQ62_}{MDe__d${&#Lf7b7l?)i9_uUq
zI}SBdnN}6@KoOz^d5>>cpPQ(9;rS+q@>voSL&Z{_qQ|)-o*vhwGagvv2gfH@CQKQ{
z|1MWPP7~gUU}g3t%?!k&xgh-?6%U|}xd@zVidEcy1vj*UHabjVKma{x;($ovOd|QW
z!6!G20Kbm#)DFWBJV-E2<?juKzva`79#<a?&Vg19KCmJ<iF|+M_bWhu!Dktk6CaGW
zJU$3{FHZ`Akv$DmY`DH1UfoP*DF^SI7CLn^@sNuE?QkJxEfZ10IIBW%80Yj?T4>`*
znqu&HPY10!a&VLpd7W*B2)xdu=_lfL+>b_O8syFYH0T`#CvnPs@^ntQFHU$v1{|3)
z;(kf9mx##?<bxw|8X;VC6WhIh5Ut_lB%zpLnTp?32}|ki@f@ulnnFM~_*jhmk?DRr
zH2Eep0LtCh_1;$q@x!+ukT8Z4=%(LDp+G)3!f)XX&T0i9YeaTr#QebP&VLBojhZzg
zK>UJO3Too7dH;-o>lu)uz~U;S^iOpz3_{Bdt2tQ!htQnR+g5sZrhmdQuy_#@dAfvV
zx9>hp!rOm$zArdIA&LY_Bn&41%U~QMqSHQE#dD2fHO5<lXNuOm5sG(eN*t*A&i;UF
z)IY7K-A|)PjPY9Vh))Rka`wx(hYR8ur-xkdfIqm&^MC{2=BfyZ6#vBSpcrlrNdN$9
zLkKW~un$L@!>1>XjT~#x$QeM@0t&W3+IrXs2Y~7MyRz{RL*sId80UR5vB}9#Hu%1i
zQOlJ`3Br9@9u+(yRth1EJ;{uFnkMQi{uzWJR<Gb%)r=q>jPU|r=tlp+3?m3gop=~7
zG_VsN8)!WX-A|AYfH3KtYoIm!9K=RBtgLk=L83nj|AqtgF=G^WFde12orn|SL}!58
zRe542k#vi1#EFD$>})0*W{<*sK7J%4k11jul(=ufh-qas1?jAp-4H-%8|AcPOZvfF
zRs>$RvgCmQ3((`Q-mmeVCV~Kv{P326ZsRi%5WLR3>^(q6I1y?E+VL<*^tv;Y8pEyk
z@s~32OCEY~hX?S4t>X7hTo<$Gkd%H&1aQ<Rlt7<^s~!k4fX6hFtHyeORA>M+0%#CE
z1iKu@8cFSVDAoeiFT~qTazAU$mO=KpsDSw=5vwl*a);~c<0fBz_z^YGZuPFJzDDyu
zEF-Z05~Dz8c6+Z3!VFhA;SN#DK$2ieCt8OC<L)&4{#o3>xtZekt<N?%S0E{DXN;+X
zP~^@h^mcy#SR#D2MqCXq{MS2|@=pc^H8od`@Q=NzDC0Z_giZmof^cGi55QL)K5?Tx
zpaCd`gHWFy8<R&&sS=6BX5Mc%;tQ5bg`y?5O~Xgy;xSy_5cg70j9&mCKPk9=GFRju
zy<iAb^ml;;_zkdv<4-pKh~sh33WTf<@B(8~VaDqJ#6|c+hLq4Hc(lwj_=z|u*ueLx
zY%nBm16sZKu*Vt{`3}7Fi81~q2m@b8yW$~U4Hx2~{f$k_2X?FF((j3edulZhzLAYn
z#LXK4wD79`1)K=q%+LQDtw}+wIs3%EQp3Q!NJd!#F{`!+^vPQs1JNl0?xjwu#w6`s
zzKDzbyu$=Ii8IX)DH}rqz?UQnX~bF(6Hu_n!BtLcMu+kT^~~zbUcK;FK(ev}Ku8iM
zmO>P#z0M%pgb`@S@>c6`aedwa-SM0u?&*JqsVkI*eK|eE3K=Xfq$XmcHJdQr9~W*s
z@0<T!2PzoI<nfkajw#?GXY)D%Ao%Bf(P$h9n$0|6i2V-Myv5@_2+tAc=3UPjtp)u4
zL*CoyWg_oeWv)J}gyVx^T!h1iE>n6MSMt?@6WAZRa!WRe7Vq(pkL{jp-oqXb$5}LL
z&M&mS%@_?w$U6g?Jl6%X{2^9w>og8qn0*R#!}-j=tE-2;&^5+jNc?~Dd;_|*jTLe#
zn_&$Ct3@7nrSPS~O-S2uY`XE5oJnSqvB`-Wmh0;7sJj>?%@`hjgM1_A&0An-8lfln
z&lw&(Pt3_i1Ws2%Z^BUS=Uz|%cx3>;##ji%)JI_-e>qqxNse=uDQw<_GhnS)Z3qyS
zCSEGbD-uIolF8<%X9&^xc|6hLOIgHJOdt`SAWd<eJgdU2B)kCS7&Q@z3Am6`5YQ_7
zjoTQ7=4&?L>OL|65gjlcoCVw<Bo)sRfB%M{-Y^kIoDRPD?h9CGNJgYw4xv=z94`2!
ze|Tq3%ND=?^eRend`It-gia0>{1Dp>jn9JELgRiA2KMo5)erx2#%H%>#w7%eJVex8
z#6l2z<6CTF?{i|E7Co!`&MyE!G_<yq4_f~U0QY&D9R{zAxXl8BXPNUH6F-!^qb3$u
zhkG@`T4rj3rC0>ugZQf9BLwh6nOm4JH{zi)2dwmQp%X@)4b83*)TFSBPofjo&-j^9
z|8z+~=MfMVZX+}>{1CkiBN%=!gm58xcQ=q4_Q`G2UOxw4f)h7vTl{uY=G~MOpG)zu
zjygs6kz#+vWF>v7usj2*bN&i(NKdY*cqtB>SPoJdUXLZs=-EN{QZTCD#dhVyt``F!
zw7i&h61ob$YA29IaWn^1;Ob@#)bNh0y+(n=+YOK2$BW+Zg^N}hFZj$o(;FN(!2<8M
zpicN^M9++s3q%EADAshkj+XkfA$VUUtq}h0XdtTuH;$p+a4?79BO>Ac_;uHGb%nV)
zBf;|ZD**^Y7sX-f$@XOSGIL~y#K**b5}Oes#x@vx_>t4*aRD&sJ>09zeNZD)3)mb3
zn8;xCfB<Fet1?XO-xtCY;Ipv9Bv_m}K?pQ5cmKt6dB2X+G+?sv+F(OMBlw6d;A>79
zqECSIND!TYlz|EUA{6Tg0RBFskllZ+Kma#5fc+2$gM3)@q5t(eC-4DjbstP;?uqju
zZ}6vPG$K#?s88!&{~7uZy>R#`!VKjc*@b4&C4rz^H5!d$fkE(9w|O^SNiY#F;`sU?
z#8Q;a-yeLY*{m6m2K~oH8!EIAn63*W#@do}*Nt_lEc2MLP9Od*K0csyhsV_o!vBo$
z>B?z>R3vM;ER_lxc^sj%RRUjw_)f7f|M|QpQ)|IrV;yROSzlSn@qmZ)ZZ~5TVFSkG
zu=pv);fxAUJMc{RV3p$^2RUB|_ir6GstQsM%guPL!mH^EHJSWH27%IeH!bzt;|TNB
zX)gOIQ9RsLBN-8f@Ql2e>hvXiNvN_x!ygkF#dAFHk{=RY$yX%$i5G-MM!WC81?fJd
z+CP5KMHJ8Z5%aibSO7TXk<%~w23W`A`S<<*y|7{Uei{hy!QjA$eFx$A|8P-GGw=$0
zX9Q4>1-#YW*mz4dsn&ztLM5tKyXVqy$A%CXCil09g(C*4Aa<O&O))DFjG4ut@Gwvf
zj(WxL_?evrdCR6)#1CHoe{g6!!@@o~Rq&OdYPBKa17mn9klS^0CVr)MUnY5cZM0M;
zaq1&vsR0k<{eL)}#JiX3QDAoUO}Jq?Kh0AFk~F}1{xWTWf<sseilOhLGJV->KR+=r
zr=~myhQLAaop2+-vdDpfblr0B?f=st;2(A{|3mXfpZ<s8K6wV3ryIN~5d7BZNf06m
z!i)L8|HOQmzwY!Claf9%a?yEZVm5<65t2L9cSRE)2Ln7%y^j1Maq^r<fK9CeLxXVC
zg?29Iek4SKdp;q<^G>2T8NUx;k>Kx^fCukRMSpS6dm6?OZxA2x945nYcbge&{n$OY
zEpbs0-RJed^<4bDPA`)u{1D8>mLCy@HzrIJSOwql9UW&H+nB~}GsH=PX8V5x(hkR6
z%E1JbP_~(!KS|#kT#*}yg8v(rBNW#OEx$Zw=ZM8bV8aAIb@ce2D+l~X;XBF$e!v4W
zUprVGvPV2XL{>gN9UcJdbsaMN3IO8yB*e3FO2@=&g}eemy+^yOgwkRiX)vGh38nE6
zw+OuK5$j+-9z+$%h4Pw-zPKZef)DS+Vz5EPV(`RVNFa;D5MF=7F;Ou-I&JWUM6(kP
z<`s_~bEbdeW^45<H4)-O0!R#0=m(ffE$kmR0Fk|6|6(gC>hMt-gn{{#bbc^I^1<8p
zqNU~V>QE%DH;eEhdw31RncsWz=)jS8GJn^a_(DwlLe3GocjfF11W(VS!8W-u<4K4s
zd_7~n7S|>q?@5q%l4KlQlNZeSpIkSB52b3LPQEml+W&%R=plHrc|g4tf(X1Z7ltD6
zLG@1t7-mSByaB4Mpgwttgm?lJPHdyz2}Z#5jyZr_nK?>B%Oh)1@BStb;Fg^7GJnJ%
z607*bjq?8D2mtKvwg1cjM}PnJ{L<+R52gu-dKFjU0X##pd`*hPj_^z8-~_E?4Ao75
zUjG7Dus?YJ2=Yyo0SR_-0WUxY2Pnip%m<{e@Rl+f4;`F9h${j<y_xmmW~@CwTnQct
zssrXAN$-rk;&4Yy2`m8v$>-PFoxx21;Vyd|h$S5W{s<#xIvyE8y7RQZ5r(**huUHv
zX^4HMA@-Q@xEpe1Ei;cEmYGXTj~;)|3E|>(6w@OV(<2nqBNAztfdQN{TmD9Op?t5E
z_-(*1uS=dYbMW=tha~QPzF1zd2ebDqKLk0$F@!F-iLgr865tX%pXi-go$cZyIAI__
zv&n%qoz$?ZnD`&Na)cai>Yy*z>7R&(ED~0LJ1qk!W{wCH(FE>VhEurm;f0iu5a*1W
z7lEyA{}B)P$UsK`0azXZTx`vn0ODUNY$W}s_=qs+kk-Q(4*>TMCwUT2v#A<9m&p<0
zBYZt57TOev00CY@2(UWl04OP^seyy@l-j}&jQ@y+JTijtP-X}NNTXqKiD3O_QS-c>
zSco9tmoeQ)2sn!bN|4A4$MD{`a-KfaSj&FDho=?e4k8$^ivY%IY`}mn(`PIz=q+J0
zL#85Lk}d})gB&v_6^sv!Vh`uCVrO6e|G)+JSl(R5?e7`<nD|H^cqiEvNC4aUNTkR6
z@FFCrNFMOu@uZ8G?Yr9kv7~-^c*p`BH1a<Z{{ZrciKp~<0iCi_ANQyl{UQECGyE{L
zNyC3Wy*x}z1n-aMyg$I5V^cSt|HQy{wAK!(reNYzOv6>=wWyd{Y+FhBgAa03YM2fm
za%TS{<bR0>cmse?6|n%uym$)inS+47WY3KpIDxtjna{&+kH9c^m~hp!&+G2xhvuD|
ze+<J;#{ys#@f9D{EAaf{19AWXffIH2{N~*nEXKY%YvoxFdi&oy;WuKn^1tPLuYcl1
z<B6M;z;?9H;S3$=GUg;;BGm5~5FOrv?gO&ZJZ9#m=jv{1Zf@c$tKoRu$l)=wBmKw?
z3w0%w!jlF8PNcHISRiXZtWjt<g@N^?xqpQrz($ppZCB1wqkz3$|FD@Woptu({0)b+
zPyTlQsB!hE3za|j#^58Xz^jO*KjN`_We;HxOS(&}7Ec#Es^7$QfNqEy#yyAV*q2zF
zqJ9jxc?Xu!98fLi-d0z!f>$e^Trj;S3+tB9$(c_sfO*$Ef&qMI(}>>F$ns*<{1A9)
z5@#h!Fir>pou9x87;Pm7!WMqwF`qb}@boB%D<yUc3tV=AA#^Gnp#qz{8tnW<w%mBN
zw--V@kqx*{x<S>!lDYUPq#pm|qHo#nk)ZeTc{pDg6R>w3OpA`0Ot}SvY-Eh>nf^Cl
z2eJNP0YFu=NpHU&JTWW-cpw%JLAkwRu#ZB=2rTp8_}E5RFDF3q4vNu|^q349!f|kT
z9Kpw7nhFGQ7v!<lTJkb1>w)%oo$&YKA!uSue{zaxF{rjrI~4!&c_JZvBeHm{OhdMq
zhB9I7FTxf+($oJNCC^9xu%l~9cU-~feo`AcfyzMm;&nmS!^Z+a>yIE7jAIVk;lX|z
zY=7slyo%|t<bF0bIwT*O-+)%&JiR6n>64FzumCkUCUs{Apwl3<o>Jt|-&l#9pmi3M
z9v0SM^^6Xy9uIXvN1VmO{)12R*jgYmVj#y1$%!Yg@e%L_Mb-Cv<1T4)`~N|GGdRaT
z_v>kPz<5+<EjN2U@UBU3VpqTZJC^`R>uGoZ#5dgjwg<Iuk&o}<y3?06V#pK{uN~f#
ze31a4Oajf=dp$heX|zxhcffDn_#hbqp<B@|f7G3H^KyS!fSe>+us`cPBU<;tKA7};
zNPYsWM|wf;F>7c(T?RbuOgtmKeWU;0eM^s{@At*81lbOnbdcLWs5bu3iNo@e3Hl>}
z-c2HBf|LBPLalik(GmD!I$V$*oNqT_yDzc$(J&%w@LAy>Cx_<*TLbP1vy$WYjo%6L
z;X`=P<oqXsQ{&y7VrA6+Cl1ph%1l(o67#x#JHQ5ZvMOfX?_mXU4}o4U{t3Pa-Wc^N
z!Xh3tOg&;%pA6>lqZ+Kteel(#zjf+|9`D#7RyE)JKT=U{8?$_1xL85)SUMrpb^nKO
zA6p0x%Q%?91A*Lp!+TT&y)2;5`YD?R{aP}tiC^Wz3(|1c84(trT1R*P!&Dq{5mzS9
zVSk5s>q3$79ROe_=qUjka3aqokqz+1s?vfq>Qz7S@2^K=`8=GONqK*VYz!TQU_fD{
zNw#b>yRM@J8uBOqhiLu;to&q%1Uh(65JD5cO7meAO#u_>9sf(&dW&pNBQgG8FABw+
zxHq6Y(J!-I#drVjuPWdFjqq$B(iln_>A>#-^kW!lUIEz9KjTwY4gZJsrB6GAAMYQ~
z|LFgd!G;-_Lh%yt0>7`jzx(9Gg#AdzPyrKFyToNgN$vbdLjnwtd&L@wtA^wsr^ccL
z5)$ix|3&CE{7gqM01}KGb)b#AP2i`jYLNpX7|@*fqTaZQ1-xVjq<EC}{B-VW1FCY~
z9qAch*0-&sO-cmne!gQ#C-(_{I>HZ!{o_W=_>TeW<+O~lMq3C%UK8t?A`<*FfDyJ5
z*?0NOIk}4Xt6viYxC3xjNu%3Laq$D&_cF969|Sr%94p9?KOy~h6Y(LuGXZEL+JD}@
zSI3hdhI1&78&5@*{!cC#@Pxs||KI{I?z@00{^{I*T)Xo50)PL3Gdg+v{lQ+D^92|G
zzyfI9=`^2*FM{*)M8-iQ!`~n=I(3Ne<N<2#Y2W|Oc6T{C{qO;F{Z5njfmiWfNoTfc
z{km)D9@Dw$`}4-#@;_g{^rIK`7w6u7xNP51{w6XGe3>{hFW#Cs>y@Y)SwOhG5SZu&
zlL9`2--a9Mq5r_}03;qEGozZg<adC-C~{k`eShT_xplMV?*>zTw)gel_?XSY%CL<g
z|G)b%OCA6OgG8nf1l=$J{jGK!ZmO)_hUgAKBn`+ProeI&i1j8CG6E80f8X%$gqE*<
zzvkwHO4Z}qH}O5ERqruvaDV!-F_duJfNh?d$I>^tG$>=l33H!a)nT8|B5v9A1nN0w
z%I>#hl%n7DO*H=W^~;&WMdr=><NEh&_s`cZ(p>aEeJsdGnn64F{o+MN^u2+)&sSu}
zhSrQ9n#SC0$k;<ac#jb#5cn>eXI$_+HJEg8t#pwPz8p(I0O6^Jp5Iv!#(Gs+$yeWx
z$Muk2W<SQ<G6ShJ$c`?T6$@0v&w<<J47*#W>qti4b@e3aA(!v^ZvxB<Zl|}@X#F+2
zL2_#A`u_@WC-yk@f@@>+${^RLohVoO@tmve;`?R&dC!<Qdr<Wyy93<)<UCk-r01<;
zi5^k?V2kZH{6r}Y&-q5N1PI82ZX}cg{!$BqWJkw$KVT~kd5$7BoM&YPAH`D{!4t9n
zUql!8`Iyl!cs`vI|LlX5z{SCVt2+#?Off7(Jwq%_cpl74f?W@Dvv3k8Z@?nd2ZMlQ
zWMy0Z-2YHH`-F(P*Nd<5xLXq1DH15gL<Jr8T*OEqC7@r&@15oYfIrl7@uHV+wCVeQ
zjpQ)_=dP8_F6j^6gj~JDi6YrJy(N7TjN{-*Z}@owi>kq9ZNtvh&HKQA<7gm9x%w19
zW9b3fRC?4u+re%F=G}+CA@}S0ri-oAP(43*VrYm{F(5HoV4bV2HX1`<jDJ6`MEkH0
z;2}S9f&R+vqr4I~*y1B%cCZ)Pc#A$m;BVGEmeT?yQv$9;+?B(@Y12H&H*j~|3wqzL
z{J`-~53}9yk)!=Z#Y61VS0Z79c+zKxf;f-MHsjfh!vvLx+8!<>B228M;$WHqFS-t|
zu!%cq9O~bRz8IChZd=~`u@GMfur~99=3c)X7>A$Wvx6>jg`)}TVtRh!V(5lIF-Oec
zHNFmO0SD#X67I1P0h86n8eINpm`i~pai_QH2|Nehp8Q`8B&)K2i`Ee^Bp`gw!h4^D
z{Ax5lixSZ2A-;ZP<%ac$&|UKnhp&b~1&xh1ap0OYMIexsno?h{<#EKd#=pZM%Pi5$
zvZDf5`RkpB+)UfB-{pu5h4ksh>l?3FDfb`vW+o8$WHpKtAY*e+5DEB8UakyyPj|cG
zd)|x7&S<p6P0naSYr<25Au|t!wmld85kVW^ZpWaQ;&Cw|E+g|{6@?&SY-0c;!jPh*
zclS}Z4lDhR0MT_FzR%bKf^|o?06MitJ)Reiq0h0C<Eg)(DI4SEA2!6(VIC2t8?9z_
z;vYbH%!1+NDj@&G^x(4+%!u0qHY1}su*LQb)f_w{sgam`rZ)i4DqnvY-}#0<u=gIb
z3e8S&5WFwVQe(PKO{r7e@W-PV1@sW;ELQ`Lxu`+k_d%`?Va3FMf-8do%nky;e|*!!
z`@6Lt;<2R6&~WwlB_0_X!8k0KoCuieK_TaxXyxSYvn*bk_Hi@Sf`?-7puZD0k6iGN
zcMKpoSp3p;n!LRecxsO#p^h2J5C7n!jjNK4B(5VB1sG~070nzo`{4`F8_5mmhs}a}
zs_TO21W#Tc_lAE237-OBz=dEtHiQTOeL9`iZ|;AJ;fNtR#sGkHu`>9;P^uhf#9kxd
zyAHt!2HFHC@S66H_}n^^d=L0a2GNFPSBGcQuy6=LIY<B40CC+EFv{ROclDowQA$1b
z05nY~e|Aw!{2jF@>3Dyp+!(REOlR>h=Z@r|j_dxoDXESC!Y41B5S#^Z=*>tNeP0*j
zZIqKYsvn2@yCx9(dkIn{7c?$5|2}8@x1tlvKquh8U35LU)o-+L&4s~{LIF>{Cewic
zzBxM7t_+wkR(?Cl19VgaH~<Sk06XBi%NY>q7JqzQo~BD<GICs!;{-1R5vX+l7ZO=?
zOanAkU_gt42Ya>E2oGpuV$eSlU4|d`(PL)+8=E1y=@WYo##k;a@{3v+WfcC`#<4G0
z${~h-ClPmUT&$3WctZriJTmwBexLa-yMhc%MaYuLMD+ld#&NseAG>$aZo*dPnCm%^
z>CMjx?4dw#fdI_FkOOwlFg?Oe?RpKo7iu)O8~L|_odj&af#4vweLuTjl28-1<mR35
zU#)sf-~QMC#1?Uj{6v_KtJfx+HiL@rVIBfU5dLwX%(Va{+46D5cZR1U@gfFz2cC=)
zFa$qFejdx|*ZB)Hm<{*?y%#v0ra$49w?pCnFoAzx&T+QqyCxx*WB=yHu!k3y5Peat
z@KIJgq6BmgW;huv9|W@kwgyXZlCsLbzWk?J@Kvlad772UkeXzc*8?IxCs!%yIK3ha
zOgT*<g!e!A$k+fhjmJtTLdU+SkOi!7;IkSEq!2r5+Zm@1W!r3V7ia#tR~c<Qqm{q_
z6$mH^!Ge_uCTS^S;^2Q^X<EOQK7-`sr%&Nd$@1aO7-6WaK$Ek2RM$Q-ULpjq>va2f
zZDa4Chs=AcHgYvsLL(gr1YsUa?r4sDGWU|>Yq1=&!elqejcNQRxgmNfu`=QTS2?W%
zrM46BAK();3vwx!GH{22ir^efgYX~dKuX+Z<o^*k!642y(co|1E+8lJ;1b)`BSGG8
z+y4j%4f2JX>-jXB4k!T)x=ZiBz>(EFB4U^M30}tUbNS72Fx=!26lsCoy8cZeuLV9_
z$4d#LzsP^zW8lIZNB@UV-k;&@2mb}0G!HP$I|3nj09FhEFfj)*dk!!o)q&5*%aV>J
z9fDTlr~(08wB%%i|KJw)iV+~Ie|~a(#@*ImHZ^vf7<1Ie`RW^;&%VFnL_^51U33kM
z%>M;`8CbT6As^c+8nlCwTwe&!J25wqQ)Hko`K3$4{IGEct;&<`&lT0@E!DVrJHOu<
zY$U|J!HC+xhgbK6I4hfyaMjAU!V|(Z2wDpr9_Z*A?%@%*$Hiq94&5TK#-qomTo6Rd
zy6~j}O&{^V0G!>!G&&jYAgh8YYp^-$;Dd(~*q}Y51P1s>)8f&iHvfez$AN+BwM>@<
z!GPx(3GsgX#iqo#t7DKV(0n`4ATUe)xoku?63RV!pC!j@ZtdU22_mu5GO_=HOf_W>
zY4LnL&=^)(yQWUVGG?fP`!*$!%|ineIL}QX!>PFU!cqWC03}IAR3XTo1CcZO;o5||
zcEkBGb?J_ZMIaLJd}Liw{LvQ}89wndb?G87Mag~qx7@KA1Y_7QB=C|0-~l|d!ieyE
zm~PSh*P?aJ<9YD}y}IsJNX(Hht|AHj*v*C)iz=JJJx$HyIje$f!7r*XV<S>H&tl^l
zR4vZSb7rM!tOO5+Bn=EW2M+lk|1J=%_Ov~PfI3M)-b6Z_hA9usse^Z=%#<5NZ{lL~
z%m4xzj-4>y*UIwYGc_7P@eo<zm+%}-6tTMjXylJ2BZh8bwTJxc_&X#Y1{cS2H<kt@
zUwDQ1(Ye6LXEo`p{1(D&;`fs5m>9T!z#?DWHHk;K!WDdHm2i~70AM5MD+R5t34GnN
z3ECJBUo}i1D?t3Q;la@Uuva!ccsmU@`1+(i5YROQw?A)&6XoWiqZ%B$?hM}g;GPJc
zUf@Lbd)eYEFM|ojJ@LFklU@{-mKy_FIMjdyaQ2ECA_mgDcr+dm02@-=$K${Mf>_{5
z?l?R9ac&QUd9MGJScYXe&D<|70;>nXOtU;cx{70V(P+{-jLEjoAU0EokY$@QSarJo
zsA0wE7x*g1qm2y&z4z=P>9zy|FTPtIo%47Jx7PliBUsV0_go_#nt(b6V<zoK2N3`Q
z@M?9`{#iOHv}Ps>xi7r$9m#nF2gKhdIdl1W7%LuKIaCb9jgJ_r<=}4ImzM>4B+;>E
z1HC%rR<%xEhRah9=nzZcFXBRfwnz-3xEt+n5*PCzRf9sf;yEq@Sr~?)m;NLZc-vwf
z;HFi`mCYs~e~Zmb+RA$Pds(VD5F9uP_u-UeGL}#4iqH&f9tDQTn=5B`^~2!4J~=)-
zIexhQzrH^cVxtkN<2X_!Tk)6>@F9i=U#dci*lNO41#s3J6jgudFUHu{1Wy!vzX7BD
zaEa&oq{m|hu@^t%c{7nb&FdhF)*^0)`}8o`GPs30KU};A>(ThGR)(Tc4fUJp8KGa6
z*7M-PmV-H<*Or75fK&{zL9F@njQ@?slNTwa16VW~lO7Q&=`aez>z8cDj};?h{5?pu
zoa(d!(ChtR?3eP^5e!d%{vYo2n!rLn7<T&>9lTd38xw0tzvHE`pji!IZsurYX3e?v
zzV_vC?Cc;i&EqaM{~oicD*vt*_ER!iae+Zt@?$^h_1zPg{I|4PVl@$$nrP@Tu!ab^
zFS!0oEbt~Ge)T-^@L7bMAB7nY+aZE4G}L`&!h6zS_*S^I?`WCk@M^pNhoK`EhLzF8
zqZ&wux(+Zf&U01}mJ)&k{wHMA*apTw$-zDbJf5gyQRRK#FOAbY6z2<`5;NktdZ>1o
z=cX*ik3aY#slzr0m2g>tj7u=?lR2|0!X{^l+1JgF2jmC%{555iMZqN_lf&DY0|SGy
zpMu%K1S8^Dl2<;$E#>jQpg}0W8ATrJio{Eh(z*J%&A{lB>5mota7%=^E#^|Em_zpZ
z8e-X<1((D54S}9IO|}_6?9uLy^e~lxcqVcw)MH1VToCce-ToJ$w~t_U6cRW1rx}8V
z@5}rlNyBJqH<}&Cn!CDJj4Bo6TF4)YhgVYcINZeh8Mq~fkl$W!kV3<+NzYPgH~$5)
zUorhYv%H+vTa3dz5MrVx=fszLkc%@BEfwN1GC>9>lKal)h@2xYB=B-V3&rK8jU9X?
zk7Ee>%kdH&L$Y(`*%}|N6L6+3ppI#zb98Qwej3<sIQG60@;@EiKMQCKGQV5#^V&Qz
zuvpjsedLa!KM}_?%La@_e+keD=$BtFA0;d!@$_M|QIkdxlq}nYf1vAk=fm<PaP%}H
zJ8Wp(3=q7=Wl{U2qvFTId$0IIx>l13L&=J`ET&vQo-(Kr1PvjuK>kpCf3y;~C1}9I
zS98trEUpuyW!jJszAwYe_LySLgJc(uw(yr*f9+!Uh<R3|5pKO~yEQaGVDBCE!dh3I
z4UfXu(q^y-35^goeX5Vuv5kMO2{|Q;;S228K!@i1yo%VpEY+Q2?AI5EX(shUmfp|h
z!7rEdGdx8T6F)X@hN3Ys7~V_nFlKCW6Xcs}(KwsWDwpfL-|?H@Q1rQ_v6THCKi{q}
z#2zx99hQ8(ROeT6k#~I<(nYXZk^A_VM&S5==Y{h_grC?xQ7p7Td?yUAi|~b?RH8Z8
z!7fn{nT3Y+sRS4JR|@Ml4?%(}9GfCgVJ?^d@P>gSf_x^{WS=WX_{)&gKa601DIFLB
z@U#(hcagI;DdzmFY87sO*FEEBzc_&TI7hgzP>^8i)W>|Z02M)DTz+7{V`AXFj|6Wo
zQ@D=>&r+sQoBxC};XwiSJyayZwKl_Lf4SRn5@6s<@f;R#<2pw9qCDMsjU#t{5R@Ph
zi0>LqYYlQ=dEGFqM)@PUe4N<yzr_5OvQ==7^2)K~iUCyq39o4IMfR;Uj^J=t1zOYy
z+PzHZn<;|@*r6S4F8J$M`C!c5+YKTW_$9oPCFcJ4PP!@KSIJmxGvd_UFLmaGsA}PF
zjkXYT(HL349A4@YH&+|`O_rg>DZ8Nm!_`X`K!O8y>}Ih+2>%lIW;HO#PQkT5?}B+*
z1p6I4E{wyLv^yp&q{m+f>krrRXu#yaDev);p!J|YH}hrXiMy(x8Va$=;$y&x+^bgp
zOe9c&{%OQBq4=qT<`~k?e+W^brdkLJ!O;nSYx2)6`@7huR96^IZf*mriQ~fECoVTS
z;C7|M^~vVd#YRRJsA4=22MDw1{x<}#8};Z-gcWXhiAc*_f+K4q=2jgwg;ETlPJf1Z
zFz>&F^=Yu4Z6_q#ktkb|`_Ac&Klk0=T}5*Ec@6~lUY%!HsS{ZayfU|s@Ps|6u!!Y>
zU*VW|3f7pV;hSNk5Fx^g)Hyr9|B|EG=gEos`uE9)ef%LJ`QnslLN3MS-D;OcZsEmZ
z&A-XPR-9()CY&g=sUHv>NX-_ngnW?U{RIpZuu7OP*Wjym5YcdzBfQe`wrHS99_4U`
z;V!zbWteQ!SH8x`|AHL=L(SVkYWPA(QzkKZX$gN$y6PYCkmNi5Aks@^Bv_t+mYecq
z;LX{t0oWjG1FnK`vEh|$wNZq3nA6DB@?M&1dMq~~d{{lm8R0C~xBl!XA<^)u%iMZj
z0?zf%AhE9h=dNVNivRk&oMu95X8X_5n;K`HerjWLo$!ZoT@di$!!xGEr9hoI`2I{g
z@8LU9X{V7Xc{eK(G8n}2UvWo%5crW^HA<>gQv?AJqyS7WR|ARe)z^R2c%=*g0RT`H
zf)fm$v>x`<Li#ueANX)Q00aR*R|rh;-~b>B1F%wOkaR*3n}Da+!EOU$eh300WrOy{
z@2CAut{O8n;M@@2GOr68nLC&QChhGzN@?kINIn88>qIA*VWcAL|H52XHoTemjKmr<
zTufP46%3XqtHxLl*AIu|SYRN^sMrU%<u{oA9_2Q3Pg+=c9vNyyI*m*7C;l(tKPGuB
z40v|y@Rm83R#os_8}OA<ZIrv1O4IGPG=1_+Si0Iq_`iSdZ^_2SK?B5Ix31Cw{b5P_
zlN`2xUsoXGYC*gFZNLC<ZqGMEc+Sj*HkW)9iuh>^C-{j)HUtFx|NarEe|V1wJwpLd
z;tA12Q@x;Txj0H(VA&&4nbDfRCp^4Q$?rs&{Fwv>%ffxr(>W6GpPD6ZZG1H#KoA=C
z%dQ$u@Bf0HrzK?&7jA0L#&H=ryl%C@d}tg6;;Tmd;es{_20=|@Cy~;F{|MC?b0q3V
zB!(uHm>K<#<mJt2G(dbrxaku$Xq?=sNiQ|z$nI+k8mOER<H?*_g`zQW5n5VhRVitb
zjZ8?A{jU-U_(aghwr}C^L&nbhrRCheCpJ((Ob0={d==&#9R?K>tdHwltBBG|q(zNp
zc-a%@;O4rH<h2LPunGk=gc<>ti}6&IL`r_RN0<NtHWln88hW&{`re2448<|sFZ|d_
zzz?PiVF!TtCcW7`|Eu9XYBjr`g(~-}nZHR<%afTn)s$;0Yejd#ZAZ=L0CgyGfxZw)
z#q&bU>3<2{qCbmh@YfM07|vMEZd^>5kerg}u+_$Sdc0@k=DrB9m4leY-wy4q4G<K_
zBv&wO;eldnGGw}}*ZzJ^NK3&D75yE;cCpFUt%j10gxmq2_d>b<iwr;f*wL{c?uJI0
zm*Rvnb5~H*Mz~TP#*1sX{=?GHiDBaTWuJw#J@4_^8Mp+hxiO`WFCk%%<&p9Mt#G6|
z3}BN4^I;=;zmCixBncp%aRXbw{`3&t*YK7I9xDUDP#yrIgoVk)?Z8L-Kf1%)n*9Iw
zIIHB=UJ5##)?8!P#p7ULuo}<?5jF*yKK>>X`KY8E1$F}(o!ZRTV2z^&elKKbHU)?H
zPoCOVTIGv-sEIi<H+i=wHSc_pqd!lHlM)KEVJe8T7&!MNJHj$zORLMtBp!%QCJBAI
zzY_IJwtg}r#8;q;)G`>pUOLJId{4wd8(?Ia8Q>@AF?sCp%C+w?sO+3G?99(oLmLL4
z^J9Pjbzp??+5#Y8C=q544HZb?{!R-cmnaE%A=n$Owa1-MJPas4G7@0D|H14g$RJx8
zw!na)o9D@VXYMi{xAo-a&GPbL)B^k>aq}3EFgjL;OzlNCBtV#sFEN<q4E<<?a#>aQ
zpNfvcHa0U${$4AtZywOtn(FXr5nhPq!<-V&!3@ULE>iMj_e;S{en0i0#^P&!_(H(%
zhdy4*#7YzY`G40HvbkaY;}PF{mtAva+(stx59VVLH)a@XVNUNRC}RlXIJk@}&5(jb
zus;d*PIm<T)#t_T5b&htRF-aTqeC}>35`$RenB7Eeldfn5i5+9s>kQ7OT%=_6c>q(
z8@_;W>#Y1$Sy{~nUyIKVJSN0nCTU|iCpDWqT}4+!U_37m`0OBTHZqhfG~KPE7#8j0
z4-Bl&aU3T9{CmF?ehN7^q6~9k)Jemjp}@Ux_$2W4^moL~7)FcekFiz5$cEn6e@$KM
zo0vdIYr+>vHz|@6bKm+jg>GQ$;x)oEL8dQr;Y0_$d^_>13<MIJgbt~$w02KjXpka*
zmk7zpR;hSTo*ZuH=DmJOoYh2eb=Di@GK270#&WvIL8zU$epjeqJ9_SM8E}pBXa^pz
z!kFmGauvg}lfxZ>&>Ha(_%(zk9|=RKviJoDU^1m(t`&qZLlLY=X=w#{vrq}2mPQ|V
z>~s`IK}5s4;UWXi=@331{ruh;hvVTI<3M2Li6r3y|4ok?LGJVan_x!f_;*j6SmBqB
z@ZHx2;#2S8m~B6V2zA0%M{8*m+IRR@(?W=N)Ht#*Jwhc;>`(bPPOQ3h5yE;Q+*8jA
zh|3ZAs=%YegTYlH(K0jzX%Lh*{-|Lq1D9d)Lz*hz5s2i|b)Uk#pa5BhAC~zPM^-U4
z6Eplra@`aY!Wf8;5rw#~9-E;J;j~dct`VRb!IW@kv9NG18eTXz!`3I{giX?)Pqzs8
z?+qkAFfeIVo5aLTazcYIHBcI1$SXcJgQ7Wnv?D@XIL_og%Nm^cT0u?!!G6l9(D0gW
zu#5H3xM?__sEn}3;<IKc=c*z~pS`%yK#o2u61`CvLlZ$)4&}f0+uLjs_mUV(n)j2E
ztf%59B73AZ*VXb#7uN~jcW3!#80`t}-mjYobEq8(pYKuaV18{>6M5r@iKt|UvyEg<
zs}5BeWfudm)%hr%zA8vEu6TTzzD{geBH}Te*P^Zyrji@01tHG`oaB!H<=p->aaG57
zNAVe9NVG@&(w1#PZ~w=;@K7U!u^dJa#DwmPt*-=_^~5ty7s6i?hoJ=!0{p(;&Ew1B
zI*=c5K_l$AnJ|tO|M`FM9}rC5H9>q&A@c-?{3L(*_)0W7EeHckIur)VDk5I$c#ac)
z{ypD<o+2?BS3J1LAlDaB&oC221d#^;@8e@{qgR7wxbBr2(W-z{M3T$jztnh(E>}ML
z(?cV|9531eI)iZ+<(Bnxxh!Vo$^VP@GV;rPw1Q#Z4)`O{zi?_0*kp~cgO7UR)W+5_
zcp`t75?N#X)jvxwFOx>{N@;RJ84ln}`*nN9!*zswwg(uLyk>pZBs?XX_~Se)1RBCV
z5yTS@VHr3_9Kizve3B7oL1b=tM`}mg93IBq^b7z7{#;BU#9Oc`u4@7F_eO1B$>UV;
zP1U4(t_eA|?+L&EFZ&6&YP0`0`^4TRFN%*0t%KscW|#i4Rwnwt5rdvi9pS`cWB9Au
zvNUt@NMiDz@iat(ibX49hQjw`O#HHWGT{y4R#(Y=#f20xmQ6iB{<$#sOOui?NW8Md
zVQfqfupt`DU4Os-|8j~ozyJUMpcGI*$p{jr%=DU2N24Hcu7!|7T{cm^h!b&fSH%W_
zlBmSM1OSw1BdYiVfKmdMj#F#BVS36?>$c_5td<OSq-?cghW0nyI_S4f>1?C*JtK7q
zdFtGC!b}uTGIZ=j!*+<GwkfS;k-!^S(|~EeQ?2q?RkNf_Vr{IqQ(+#1m<r!jq!88D
zE4=5J!roWSzN-@WxF9*bBGp$l;+0<sB&A&Qt4<X(<5l-8m(c=}-B+_zhjkRyVaL#C
zVj?MwaH}|&i8YWb%;#niV)2PedlPb7P|-+?tX5HInT1R;!qg1KYlTBPLsfcT3o!#s
znrk*o;^;mhq}8RpUlS1<!pA2j`cPm10Z;;fQ9*ZmqkLPxcM;lUdY)Bg{jqv?gNos>
zER9s;A#SSIFueBhKn@mgc`nh(N2r_5w>=*ij%UcJqU|TDdZaou;YG8Z_H1Og({7cN
z9`3zz5N?<Z#af&Qw;V{}Zxg1COHxR;v~pff2VGGT@oL&vqH_Vh=6hwoh}6jF0us|b
zv)YLD%S%d(7V01rx?qb;z?jjH=Yd+Bh~O&)5OdjT6r&JjFF75;`B346;84NphOmeg
zUKCZ?FRs|V35_6alGzwtA_<nTXC?yKa<qi}g%DtiaHUr0iYLh<Jll*x#KV|551y?x
zcS-O705D%cn;=RT%NOg4?LE0W;_I%f;`dd${8yXFpO#P86Xx-Ka@N{`uZ#0uT)teW
zr0<sz&&^f9<H>3F!54Rbo0p~Hd2@^3aenx(9;?m$&yR1y5G?a`P~Q=E-S|;a?YFjl
z|Kc$#1pHo+H+{n#UuNMJ1Frhvei@4Y0>^D)*XCMP9%*8Lf*c<9tO5K-j|!~}Q_OrJ
zpRGYaQD5f&_(BlJL~oNSiVMqRM40>|XZ|jyt~3S%^~LyG7*SIh{;oVHIg(X}sqFx;
zz9ty%?X?6v(%L`E$3KkXJo4i;7n`0De6duI^6{MV@m?=87W^#;7<Gj@laAFKd9R3A
zv-qzBe^#4&8G1hvKBU<C9Vi2L`7DP4UE)LeCrnha7)CZD1h9rDgr(&TFb=68cg@a>
zY?kpi$(4D~c<F)-?-~Q7hX{NErh_DK01o(0cvX`t4AERC%7yW}o8^{gh9imbtF|w$
zOk~~t`LzUY2%!^({=SwI<f~Kwr9fK0{1bVuG-ueXOd%11K5Y78a2Jly6K6JaOdSl}
zfdObu=J7le_~~e5keHC!@RjmG_3=@VFa_y07|hSR?`)}m7v_NBpWiJ#wa0kWrZxkF
z_a&#|=n;|-t}+Dy`8lsyIVSu^El!sw3D4w9#<OXVBy&(B8n+3k0Lu4wO@04@Q{LZ`
zn{IF8>tTmr%8wf$3!%*Nh9pAZ=Z@=X24!QQsmB3q!3D$2{G5@ooA0?uv__#0?6b-7
z9h=8fbZ6%6hLLCi4kin+HOX`)>ym(P8>R1$00I9mB2yw<+jhkBPJn+dFOpuw!me8$
z{vuK(FOQX!4u|sFVZHMAZE|Mu!)ZFO^3Mr}nH!q)SIgr9dg6Gl!Hpc~ApRyE;SNaU
zmvev)ZcaZPn~1jn={C`x<ZFr3wtdl8CU5(b_rrEpjv~JzQSl)I7s+a+@0(Q`gn41a
z{=do19?yCPPntGu|C`5h^6f%jCAZ%;c-PNgqaW<OS$tKzzyKB|fB`5V3aPJgp*u-P
zmH2BYU@G*B@zlh&2(d7)2-pffAUt(5(nZ(*CU$Oa?Q6p|#A72r;oMFxCiyZXqVsv$
zxw{PTTt-DD6<~1lBY&5T8Ry{}#}M(ca5vFI=Hr)_$^0iv9~q7#ZISrRxaiIvitoVm
z9_W|;s7%}S%^MAmF<&qDNtM?pI~T|J<-@bCo{<E+M+NeQhr{|=#uNb}^fmbt85<hn
zx{VF02ruD;xWDdWMGOoV;ESHNK1mP0xo9}fUy_P#`C~@kWDA0S|1bE?Omsj0dyy=h
z-Zl;hjw_94;oZ-LIV=g0;rLGbWdsJla)AzF`sSWL+-_gZ&20Ditw=D>-z`2SfQD5A
zc^L^+aI~QY89|ZQme}~5UwPDg+6e?P7vC5F_L%uPr{O6KN&yoQ@tR=c5?ap%KX<i1
z2-C;GqsB!lRj^_F+~ELQClQWL{zNHpCFRyaxK3@*dugt1t80j`VJ@w8q|67f{JeQH
zZ<Ecw_(1Hl_Z?S1__*w-S|RAL0@8oIfQF4;4_pyrr-h+w<(yVN00Uxs*$>`g<wnSZ
z7>r*R$g@Zsem6fiG?^cd=Gr0x1t+7zb_f2sKOMNp#ep<=Z(afa1XK=fyxh?C=ht1!
zX(N}D9nbhrLb4)J$=_jk&mB1+Wul6LjUyva==A~nuDLpmjOFB}-{kSLGV^heN@(Yd
z?86CS4mbZC3Z4C!;5dAA+swNYxlICKI42Lnd=uf=H<h5HY&Smp|C1748r{^FH=Bs&
z@r?YlL&0|?GyGR2J7*E%OGRj8Wj8KER}<cTwUd_Gw1W4QA!EMmjkAan@Re*u6o!+n
z{yvAE9!%Xk{Jt90d*dd}b5((|Uo@D4kYJOR!l?AM!Z)_UAV3@<U^J*2RDt}n8F|B=
zJE|neA|H$ZYW^a9jst>{2TB92!QJs*Cxapug#dqch|bw~tJAVh+U2n329yv7$3{WG
zd&UkU0X%A800|4MB;qy6Z8RdJ!AAKeho2J{5r?4-L}ulT1COHdT#+e^kk%x$S0oMH
zxdH+Cd`~=dkQxBC9<15n)vjc#6Uj<=S1fG~K2A(%a*je!wjNtdG_Q(~H(Y3-)?P0h
zjr}ydoHIA@7r5BafvgBCLI9hDqX32Sh9RrDaAC<GEO-sS=Im!NT$tz-5BJQOjMRjz
zyq3_W{wI2|moUTFs0qe%_uZiO5sHYyd{pRYiU1iQ_)2K(hGlRLZfvPzqesFspVaJN
zS?fr=y*Ab-<;JuA^q=GQs)jNkTGazagYn+U<3NP_rQo{0KgYrx;yG4v;Ry{!wY+59
zi;F!MCPfxM8BT<(!w7c-%)HplFPvq&{$0}fxn{smguFEt<iUZ*L*I*>M+b2nql&q=
zA)mrHc_ZH<7kS5i5YXn_k++R!6XG_@9ODWAjT>WJld3_(%^ncxV4Z4!CcMY^=oAOZ
z55fEYn>rIHc&p+vgo-syo4?7J00Mw&fX~S&g26_F=ZWfsUhUEOc|5K0Fy!$IOZNtG
ztGmSms69Sf1s*X-D+mejj1=<NSZeN9F6fSwyqiDnuscGZnw5m&IJ!%@;#q!5>G)1P
zFUEn;JiD(rtL4)oUH2FnUriT;E2Qw9$6)cJZ}Uk!FqazShNAECqVW`(7HnWi(HPt(
zUFy>T_^Va!mx#RMPmN6f7t5B)2nK0;q*EWlc~n?E-Es7(Tcm=bjR)@}u!NQJ>o$0q
z^gAo6TUV|VpfU;#fC2nq3IpL7=t<ZekT_9-(E;8F1Ga8Si6Wfq;-?X+bI0(P8V=e7
zz@r7o5PQM&KP}_{0L{f_dU(_!@csyG<<9s^ESg+wq|-NvzDy-zdVdM-NXlbG+T-K0
zJP^`c&r_A4iru0E*Ab$rkuz++9p|n)7j2O??}RQ{&>}`zWs(Ao4VA$RXm|M$_3(~|
z84m%};t0@Uj)8nmG6nP&M6!SYm{ZM^bm0M504K*~1PJ6k4mkl}TSYzmxbPux1>*a*
zrw|he3gB=)Cq~%FAaQqG5^2U`p17?lb9(u%<pdAnC~XB05wn<t%sc1nl2J@I3?GCe
zpke(rPuncK*SB0JWxj4!`FUb*<+CMoL}cRpkx4F2Z85_<5aAeOg#2j1=lmz8m5mj#
zd|t7^(HI6dh6Au(^V9Os4l*cQ8eEv(|AahiKOMdKnEAV9g5~P(o4P+I$sYv#w2(%G
zWB6AI!W<o2c);Zdm<K-~r;6~>b=nhWK)9&r`hmcQM}m`q^CIzgW7to6;EFYU#$tHW
z*9r2UIEeTmHQ}J&h^fSUd}jQ&zrid!xy6M2?^mtg=9Fl3H#b7@ltcos?f}w}D)NVD
zK}8M36ZlTRigQT7faBqL@l%-RI}Nmd#YTn`(qsuvfn62JhcA8C3G|%-!%|fko+}+m
z^Gou|##0b?&EfkC<&@Q8Ikmdw@t}CFD$5!Ln;2n!`597Y1o^XJvs_n>0vPIYF<sIo
zelwK;b3Qpxuq{EjFkv`%@e>zk*__)R`KXLmiE$Do%yJVj?CSu2Kf*PMSC=LsV2v-t
zWw>oAfuRfV1MwAO&LAvt@FDSWvt|6F1Y}uwPpLy(K7t3~KM8O>5PY%!i>Zv#!}{J{
zD~Uv8P&x;>^7#14_$kN4C+C9+fYLaY{~v6H+My!5TV_?_yJ?RW@B@cayYU_xx8)2A
zgbe`EJ`wToQk*a{C9DuH;VNV)+yY@xPYm+>B_YFy5$HDKldHN4uK0-HLDy;WO#DS7
zn$k-&L`?%cahZPDAcQc^BjG9bl&#`9Fk=|fT-YaQ{W3rR5BsnsGL!r#&kQoZkwp>1
zqxZ*6)Vz`mH3ZKyth{$Yn#h3;qKQUL-^&;(ez_<x)CZr*Zr$=!z<_@V$0mJvVR6fZ
z<A5OD0}g5sqznXn@c8`9RY*d@+EW4m{w_A{YeRs*Sa$dN<l(eU+AkNd6ky<rl?-mU
zN>X!=@v;BD6R<E4kCzR3w>V%!u%Gcb=meneV1aAGIak^&SQ}MngGomCPKmOEq@Vz0
z&_nj`?lwE14<M(KS$D!z>Yl9=lgFly&4&N}C*|`%AM<l+33Bq=KP+K>`FPYzNcikB
zm%YA(|3Q!t78%UZzHZSs-jsYp7mKj4&rb9v*9dLQI~>P+NuPuz7&405K8nN4$&2{B
zqY;oC$Ph8GLVgqDBgN?+bsra*lmlTj8S8(9d#1ruf&^f8YHIwIpgF_~<h;a~KM7qN
z?_EC^WQsmCH+tf@alW(*mR?M>L4GS)hnmCi?Ei7FC+H3QUz;ZY0boxD_`3yo029gg
zTwhJ5Nm}yeo5$iKG0iVD*afGTlEWGW3lgqrO;Jh7+gwIYN#x!l5W$oopRQkVk9@F0
z9}*58{Q2+(!_|Q^gApw=hrU=~A{33}7Gr9wMDSM%Dk8PnV4Zksd_*_|KUjCXZnhj8
zANuZh`-1?8?^wP7!t#zj@Zk7Gi2Zd0TAks=03<r@@R6MMgBR0??0|dwP8=s5gL?3t
zyffVY{cZn<5;Fj*vDLZ&zr$*w(bba}DMMn6ei0qp^Wi(|8R<*Kew%)G{vb%W;BDy?
z2b>jJ<eOH1wEKOYVz0a4Y`^e4yD<Vq<ATW0$j$i!R<!o?Z~r7<a6q)*2~tK=It?hn
zwQ!YcDD4kb@t4B$M<H{5KqGX6$yytbO|O$~z7UvV_G8WR%MQBF$x$0mUo1pL&_PIP
zTvkDYAY5b|5ByYMX|$-Y_zcNpHRXi-H;<GKR-LX`_#r%@kCPMsj-kd4FAM~9R=n1h
zV&@WY-;Bs);DE);ndLy$fC6-iAM<4k$AK%!mk=f6cZt$6(5ukn;oaengsl)L$vV7&
z!<-xd0@p4+A^*EM#!hIw*_}(t<7R&2W`7IwTSG*~6@~=Eu^C~QzW^0b{@Ood_ecUK
z6WIajI3HHWdN7aeLHJ4mCH0R1;lA0DE53S9&Zfh@L%4s5geL5%?SFtjoJTz^IuIYi
zJ`wtG5`KS={Hy=qgg}lb^!tvyg~Md}F%cXcIHiHa;+DjsaSr=k?K~3ljL`w%j%Me>
z6=#kGhweXUZg;{^OWgL1xX}I`T1gQ)#0dq}@YtK$KlMigAR>D|4?sVDAW3r~pZTX{
z10e_SPZ$GlD6TXE7KI@BW2Hm^#CG{400BW#@Jk&YN)6K+$GDIlUmMFK7o?H_Ao1Yv
zG*gm&MtlF^8v_Ah%m5P&jS_x<LxA)6o;qV>4iE?OL_|@@BjR~fQCoix&-*!0mYDD`
zI^$pe$uHPvmxQGN3}~2hiVr}?0BPWXT$TqYKp~m_eB5LZzqy&n7zyFy?;Hh+xyIZe
zaw93uJ0Ial&Tt8M%&>6pOF<IPEeHpsGDw2CW<o%Kr5A*5`b-j0;6Yjd2N(|lCkfbC
z@nS@*5dq4xFC~=ZB{|~nkYPY<3O8I{Qz$1KBv^Ezj#$~xj>iwg$pjdjMe<7eCkbK=
z;rM%=Zvsu|{}_=Y;Q?gWAHR9GA<i*@G?>t|>fr$)$!rL<f#U)$37MQgm-NO>I6z2K
zz#qEKi5Pee*vTPzyxvu-z}M^l72U(+*c?9wQ{Px)aDaf-gakUk`bG9WnQ!o6`9p!G
zq&gCmj6Fy}m%~iI7|9pHSwm8R`63iPAWNb1YT$-25MLl)Ul%9X2a|jwP~tDdf{+T%
z9D>Tg-*w5LO_hJiU_seTF|2-gPt`~Bqf7TQsz5K2!s+GWuMispYCJH1yUcUsm?W%Z
z{wl!L1D(6c4;i2y6MMX{=@c*)0ijYG6Qg2hd~1rU!2sKhzY21Iz0a5VIKD*~>tE*F
ziXH$1;=GexfZ2Jiui+`f0m>@YI$3$IYP+JOln@=^2#?8*uRkPw04FDaN0Vlgd`OU-
z4O#VEKNRQw3p^9-M&TzM2oh^M@uK0yP;f{+hq(a&fi~D5M69Q)gh-6s6>yE<Nf*ON
zo|~9q4L3+05{{2=U?&0tOf?nD5G32R@Rh5_OR5&j$q!~K1EUV2i{fY(4b>hqhqHXl
zvMcf>Vlo|XI*(jtZ;r;e#yVz6F_am=0YZX<Qf<_~yZ4`yj01yyC&z=rL^!|&Z-NT%
zb7JB7MA8+LtEMz*{}V-qP_M;5C8qV<uw<0n+sy%(Mk|V*6h%2CKQ$@Q4H7-uFSvud
zg*%xIlL&t;IG6wooF$Ue>?zp9i3!20U%@_rV*n2A(fzahCl8?D--Z*dAV6ti1iZz=
z!7!(i5X5p@h9c(t6X1d9=A(l^)C=tavBU`qX<e9bc`=BNm`OG>knJbqvIrIn_<fZb
zJpFtvqQSo5gK7X^n_%yXyy`#Y@t2RdZX4;p9l>}&9~a4t$7jS-uRH7`IAE~;3$O)`
zCSDzgEfaCyFK+x8NC+*%><Ys;MhN}86`OHW{{?oMbX{z~a<PKz=HsBF`D1K)7)bBe
zcusRPb01+aQ2eEh<nYULeb5MMzM%{+$(P~ynPy8JNYCFK7<%UL0ZpN0dW^1lU<*7E
zBSXO-#^ag5?_NErrf=K{9>@Pjw`<UQalP(5%G7LU#6;^6Ck7F`yueYoP9Sdsc-OP!
zQ7;`!!~_Do0@B50H6#1!2tvZKWasnw>Wme;Tp9?id@P1&v<*_AQ7;ewBxqO|f5~a_
zQ4{-y7Sr<a5)Uv*MhhRChh{R{XknxS6$Hxx8iYPV%3@JV{108v$(g<)>yjQ#)Fn7t
zA9%M+u@J6F@Z-aVZdq%CIMDpumh~(|_52vaCJZ8fcm5_MNUwn4iLfj2A@5op%luY0
zEupVr_5(-I?+kc>e4|Go<gXASUJ0<$B?eew0JC||aXR7O0AX)Nhc&lvERQX|DU)&I
z$Nbu8SK*!`%|AFJdvl}rMf`6cp6}AzjqxFQ#37V{y&QB-REZ^qmg7Id0SKsx<}4(3
z|B5qN{(8Q{{8kJ+6h*{CbN;8VtV;eaAVKTvlNr~+hl+^=0Voc&R=v~r{xweoQNf#D
zC2pXf|Na0(@08m8;g5bDxT^7hNbNWClu65Pns@lqFz%(|AdY0$UcIUmHj7kD+$Qhh
z_?Wx{*-nG!gUnu7gr{?~?6x8=-l!934Kd&p=OdbzpNWg`2OiyDvB#!vSRH0^-W%gn
zIcN3!YyXSz0hcyQ%&zaU!&7qDh`t(`nOi4MJHv@LaRF`rvDDi7%?}V<jL6Rs;!DK1
ze~1hMXcwjd@sRdCEv(RiD_)|C=d5)x1+!Tz6Tn}Kh!B5c$@08p@o@qVUzQTQ82KW6
zOtS`<5(FGU%f!uK(`f?4?j#rq$&|%XVoOXw_%gyL=Y_n`ga+{5zF11dbNlfzklnca
z5O^DET65v2B2`f<_5T~_@i1S2461idZ~yxE3E6g6cP|2unjhjn@q#7d1O=hhRGuI5
zUpcY=WWW|+01SF%d|+7ZpAaN=0FTqqA55731ys-Y5w|0Mc<=?0(?1>HCS+@;zSs*2
zmH<_!I1Q2y{t*0pX9C__%|DPauZhRKCNLW0##NIL?<OPN%<_H}78`L<`a2yhmd9gd
zWiR;E!`Ldgdk+rwuPXJq`B#;7^FHVJfjoQ=7(Uu$9NDHp!@8z<a(Nk8Mdd|9!~+1f
zzL*>au0*o9L@8l2{^BRE1Z_vJ#6y^R8^2T;O?B7!jJSj3@!OUb@M!J%pHC!2_2CyR
zryT4=H)!{%OK;EX{}DY<aD|)YVL|2U$s#;OWyC{qiBuO>6^16Cmk@f#>_o4XiQY($
z5m(|TubXUyqd1J5_4v@qa{$N5{y)YAXCDYUzzZyVG(ID=)`O0TWa4xxX1j2i$>YM@
zI#V&WlPeZdX1-P>Vz^oauiKB@<zbr5-()0*#QX;pG|U`S(=jgey8jEn7>K2WZ2Q#A
zI^@Qi+dsR%5H|taCWoWn_+pvx1-VSncwr=&*rsp!tN2a>)%s~$MWyX|*un05&cT!`
zo;*YH_D%dm=4Jv0o1mcpu?s&7yBzxwHa;fAO^<eW&iHM|lQvdgG$x0;>s}@n%8E=!
zW+25TI{MWw3u6?RSMs91{~5X64|_McVJtA)fa^&zAG?s{yPw0B?nC!;{>^^)Uks!{
z7F!VIyv2@)MX5|uigErL<zp1l%Z=CN(u4mSV}drAWd<?^kKz8A*%yYjNsa)>I<XNL
zn2(nbdWthy<Ef96p0k8T4H##*Mj|8U<inX;(5nb(RmGo$?C2wGswtc6XVgd8^TMBR
z!i^25M!7LN$>isXtQpf0yG}pPJ$(qEnYikIpI4@5Z^%Y4+cOzI5mVA)58X5|<oWo=
zSH61u9iaogj||We(y{FM)rV72N;?#<hO7o~b+5j#h`A#%6vdC88RMyqeKNVS_wr&@
zkYkCH{Co);z=bWrg4sg+{|~OSW3!R+#={4WNPr{>!Jq_@PxS$GOZOhi*!R>2bE75g
zxIit3gn1)}upe3mUn>&Ax$EOekNElzXP&_2dgG;B0e&DmvW69-3`G6_STfzSa<}=-
z@BiBWXUeX~jnu@#*zImydr8BRv=jj6jUmpSzQjm1N8;d0);OqQZSov-a*I^QtPGLd
zjTwmZNB$9poHfDbj1&5&G;5Lc@Q?l&@bhvGBzLal{nz59V(?d?K#%e_oF{#rKQ+I>
zh5)k?_LnW*_3zXTc=|gZ8`8gsf@~YmMXfO$`YZ50|6x0>A|3F9lU_&mV5L;()ZJuV
z(-+91gl0brd_8td)Js(ISYK)^xStRZJ$>bW5Eu()t!(M3l|W+=4y`ho^26`^M8ghr
zo1|<&Zaj<i1+!Vfe4O>I@BSFHFfhJ0)q|kb=~a7-8e5;wSZ4YiJv1rA<??@@1#l`q
zHowoxz=0~~-{pu9daW5T`x3%dB>x4L1E59m;D7A~FoUOFe||}&Sx9o?AiyV?fB)b&
zZ87|qC?BY%nfPKD&WcE29=Q%)$IpL<@zF2Lz8z{acMe&*=6)`@BLWp@13$yw61=zx
zz50A%^W{za4***{w-j3V%QqVMfg(5>)$h$w#q|Jw-5XN;Pl<<OHhxQV{=@0&+Ax8N
z&!d%!_+hmAc!(+B;3$tQ8n2yEP)0+jUd|%m3hVS`^avSBR6l?CoOB!r;oE@#nW&8M
zUH{=v1h&h~(SYEj^4xdB8<r+W#^r@>S==ER!N6K9vf}4n<lsT_zr}CeZ<hPS;EC&f
z53zk+6D+shKN`I<13BVzU+atM^x*qwW-~t%vxAh}vjFjL{}LAQ;4l!CjeJ${p_6cc
z_<=N997Tk@73VWzQ_1Co0ScP>^uAmeN*n+90|V9PYHjuP(7t$q2dI_*&E>=%zGftR
z7+}U&pTuGG0m$({%cfx`j3#_`P|<M^p98=2ieuEFX9)kzV1`}0!veFFk7?x#%;*CX
zeZ$wA0UoRm{IS@{qIvqm7w-@k@!YFKh|C_pc+kn=e4z#cEzAx6151uR!9A-oh;eQ|
z_pIkXxQJh=QVmf$8J9t<%SRi(!V$6mC!v{K06*ip{{|XSl)&-V)Hig_5_pqDK1@OD
z2U8GRHJ(_AYrrmFq3SFn&Hv+_{5$+)yQcw=Ff1qLqBi5cd2ERN25FSgteQb&Lr)6$
zW`Xl}g@Lp=V#BfT?fr^SSl$7#6PuUtfEHwkhIpyg)?UhqLI`brko;D9|M0AAH^3;6
zIfN5WQ*0dhD2DfKEgkuAf5TGdP(e`K;oU0&(HRZt(&&Gm(hF^A10LvG_YffUk0;9U
zl4r+8Lqtzs3G>Im_57C6PWIwn8jdvUk2?85hPXAOw<JXM`^x`Uhxxa-Mkf)?nTu`_
z5-+r(`tbmojsRjM?~~u>LHOVr=off^{3meYWNnY|C01lt$G$0(ebS-y9eg`|dX%{+
zj-ofq$Am<ag87#UvsMXQ1WkA!^Fbqrd^O$1v-VVIY<>tMAc(+G3PSpo!0-#JOGBaq
z%Tjz-0cBG+)PKZ@2=T(nOM6H;)jYF<0`Ozbd3bv^*p8xMO%pAq8w`MN2=qopm68l0
zn61C?zX{lOtGadL>Hp!3a4;N9X29_DYWP6mem}-|c_VdO$e!>;E8FnA9{Px30k9RZ
z;NE~w!1}-Z*-Ifgz6rUmtWfMldWJkqUNkyCwt0UO;$`Rei41vsZh@3Rco(tz9OaBm
zMz|-)_+cogNRyB^$?pVl8}G?brwPdpi17TCe-SR#FA4M!@sRi#e+$H4!2K)y0Xp~W
zKjyYz0{Z?9aUt;m0^SfYvGGcV@I>JPVJ!znX*?hZyd`a;j}_yt{J`?(2!jX!dC|JO
zT<Pd6P5t_Q|GxJ9f*^`SZ_`Aw;BbcwK;)eUaCllK|HARGKz9erQyN8n#rlxwG#~N2
z_2NJLA=Kjp!GUrn9x@IC?f6zWEB_h?k5xd2LUyz3gs*D%_@55JwLms9i}1DGk-!5y
zbqvIpfrL&T_x=@!Y4jK2rh3$Dt%u|s{|;q5db3o?nbH1E6}DhxXcBR?V2mXgE-Q$u
zM%^#-d0Xo*i{}HD2M7s+{bEhc2gKs|nlbFUNops=V7H3eB2IKDv7LK}5~Xe?PB;zz
zCLZ8Vtzq5^_s~}`{|pi)z}nVDd=Iw{1mof(J|sbC*Z$){7ZF%M*lG{P%XmN|;Ufor
zcmn>_pQ=Cu`md?KuY%YhFZcZ)H~22F&<H{N?Wge5QEoW#zA_+=aPx-%BCy>8RM|dg
z23XG!z(6U(b_rK+Re%`=8?Yu_z53aQcrvNfGynf&KnZz#7(HGTc#I4<oyg%`9a4W1
zxP08m4jl2=$SsYEec*t@>r=#m?oJ9P7$^kZH>-3F{$F4q@*Tl0Cb@C2TryNBa3#cJ
z=MRnwyN~&=Dnu_0#)0ENUoFQ(hwqYtgYqRK?l=;SoL002yhDzXXZh=gU9bNc#)1!!
z7}0|oJI6s|iiHS2njkM5Hl@P|4%%gcILyk>cnt%+xbzK8LBPr|SO3B?j}8k3ItFw@
z0PR3N)v|JQn&M{U!%X4>{nz{94ols`Ji5JNVOW7AzzD6ocdq~ZH6H*80bqr*u&=fn
z<NQECISwJAbYa+H*ZT}RfcS#*SqF&BVm}aHFYuJ=JZsxE@QmDOGzc4CAUwMh4P)kL
z0-74i{G%bvzv1`}gD#ta{Tl=RVF(fa8IuqJ+~nF0D+0wW7yF_&`+hJ8`FO$o_DjHj
z$5H+_2v}SIVPzSn6#VzvCw=mb5FrI+kQ-R)5?FI&tY-8;5c+_k>`o;Kq3Ew8tq!+d
ziqSi(@Qe1KgW+qA&S{2*9?B?DUo8Rn*e-iO0lpg96R_`NK&DYQr~Z1Xfv$Of`K>T1
z(3ga9&~dPK$kA8>ZQt;%povvy4h(`9f~o{}ul^J5sKIG{az=+=hxNY%o1qXa{|Q4#
zp0|TcAZG^@50{#(Mo745c`pB+xI)2N{`ex|EN4%>0K*6{f82Us$=tKk@=e)q5%YM=
z$R~mf!8|he`{n);;E!o3icUz<x}8MCL;sP*nD>p)LC67|Ox`{eIGA@#3%}qwKa{YE
zb^WXS&*Ojj(TqKQBtTd5;egpEW96y4ctk;9Cx73aKlmtwtvdtWrM(_o{lr6X!g!E(
z=;PS^vKp@p!n}4-vxEBQH4MW*h4Pvno&O2r0ib^Xh&jSg`~E=nTG27TYp{TjL7~E4
z6DJ-*L?3cq0<)nPLg)@|E+9a%uX)}wgqAtC5jFfH9RMJ7jooxw6N&B(Rx}wCT}9cw
zx3)iftChi#(v%cGx)U>T2R#46D=s8JBaAkB*Ud<T9rI`e8ipW%&>!%A7O_kl3?d3c
z2H^jeYKoYC;ux>r3+7WYQ>DxR0jOqoK48b+4p><5LDqnwp>H4Hk`i`Ze7@*sk<9)-
z84~Vc@bj@M)y*6P56Tc9ADx*GxOR>ah704ZEkELL8cPGfU<w3FgZ<8y{|a|%ku9JA
z5+j|58&=*ytKhyk6KbFnh0ZSe!wKD>|MJt?@p+Q4HUI%1G4k?Z6B8ZqmIk&Ju6ZT;
z^avaf@<Z3lcJud?(HP=?h}3%F4UA9>RnO(W#KM_Ov58q-<}){Xf4#}uqa#)DW&boi
zu&;3t{|cn+V5*(X)(!eF9smgGvX3{Z6RY+Dzy&0O!$QHBc8_2N_wrp7RA#_7&Jxqz
z^yeBXg1rXR{w5fwao{+fJyT3G@yhZD5G4ja0t^_xb7No2qn*WngdtA_Pc4UUz&csN
zif4ccUraG)N6-KF@PDRNsO2>As(29sCD)krTreal!`G=i&oPKKGY_701$uHg&ijA(
zANiJ^iqC)GG|>B>hC~9Hml%R0*FVGIhT7Uh-VlW0o~{e#>Kl>Yb*ckgBR_2baO6*j
zHX&9BPp%4bg-{7_>_-aE_0rB59v=i$2Iq2tNte%DCE@RXt_(JFfB<PdQMp5Z_)mn)
z6qK19gCLTK-!+1c9)AS<WDq|+ptn9ILpIuY@`5k$u0HInW_OsNN^!-EgbDsKfK8b~
zkg3{MDy2g-5EKXRQVM=aLRP}A3-bgBaweTa4M=3m)-re;3IAQzRX=d_zYovNWu8lu
z7%OpjyCNm=qdXn=i~t1Y<lArN^FY{%Vg#QRs`w1l{X~g2JU*E~xRKv?*Ds`YvdPDI
z`<n*@uh?}BuK<pukqL6_2r``I6TW)!&i@n5h><d5ZSqF}2+??$W8vK3fepcfKpF_K
zuvt__LJv^fR=qq_tqFgESkNS}|DcEn1~Bn6eP!^y1B@1zLm*&Ee^Um=iZZ6)->z(Z
zF>ZJ&v&TtV7p<cGU*+TxD?Uhjtn@DzFa$8yZ9k+LK(YOD_#n~@rHJT5F>$eJj6W8z
z+~R+HSCNR=J!mz;I|3RA1{{F`hMHMRil6I}IXmVv>)$L!9K4u&rTpG`1MVXvH=^++
ztnib(sw1;rSgPdW^`o)Ier^}4unP!uL+w3TfdW0NLtpM-Ks!MECn&ZM;h(Dv#3~1O
zmqm5U<8bS)Uo8a)umwK}ZPP?~%o+D#+x{x4@uSYS&8EO(1Mk6nqZZgvkcIk~Wr{YD
z{tBbQif#lSj`&{(<Pa3Gu!1;YgX;CeP|O^^VXB$nx&K_1G2z#m0`Yj{|IdE}mIH2L
zjC?K75pb&N&?gv`7(?s7@Jkv10oF;-%SEnV6FxOVMs%-2+ruT`mNXzMzyo{2gFw{2
zUw3Wml5<R?zjKgrec`*S&B=$lU&3`X_D@*oV-?9@(Hxryf^JO|@;FUHvUC5YoonER
zsie_`T$1nd-*R$!|AO5(`RKVYknw*nhG#@@09*&uWbwe6`8hmwp><-oM=+uY-v@HT
zQF+D!KN$_6Hs}BFVH*%O8}b2$F8xEqK=4}^_$rQ$9iRX$WFK=5P<8K#<;$heKM}AS
zA{`kjyZA4TgO}wLlmG(aS_s2G_>UbH9HHGmCm(i&=dKd)_rLu0)M(HAnB3MsJw`%)
zh-~-%OkfSO;Vff5lIyO%3U*DSw!&?+1eaCG;o10o_?>W<IbqUl>0}58#pH#6%NuDf
zCZajs_^hMR@k{35pA5senC>G!^KBdAth1z%AWYze<^|t1J2qYlbUbLDmo>g{Td*et
z`1l+Y1&0v{()Z1d1$zJs;-e!n!AsD{Vz6lq!T5i}mPF?SEeHyZi5*aaxM$x9&QBW<
z*x-kRPU&fRcy3*v!g$hlUuERLuSM@agtjn1*8T7fWfnhs9sS#qQ5+OX7!x8R3rj?h
zczG;0u$qKSO<(^-5W~w(TaSpv@I^N0eMjJ<yNu59J>>f2%N40{eOS;DP@q-#d(YIX
zY)l6`6*?)Q|1DX5Dq_Q@cNe0=5JI#tKg83g<&VukJ2T7N$WIEsN(jkqlY$!zcuY3a
zk$fdFHR5NDga`i&>b-E6hrRx|t1+*JAi{1yfN*8ve50;DY5MP@9~##WM?hh4vqo5C
z%C{Rl|0uzyp%T7c3MK-_%XkktG~T%;i*y>|Dqz5c=f;3xuf=pmY|&}fu@H<gpSpWR
z;%QE1ZFbWc3}L?Uv#`s1^@)k*&VI>pTWzI4Xm9R81%dblekNHVB05u~y>ie=*TQkg
z+Hes9Lja%9YlUEo;`4ZJAiT-o;iydGF8q9Kc{oQO0)UX4c5kpPj!w`QzZ(=<=9~}+
z&?qqfAKdjo^dZ(&K=)t)^Vbf=-~YlsI9!KUwNepYyaqMWUlWePU_5-j`{7xaLeh<k
zfvzdon~=BoTG>DYO^|LMQt(I!9b+K^f1aZyei+GL-vnMfP49@NX6cXOE=~xuGdIiO
zDZmsmjbJF1fyMyC;k-DM6<(^2IC%Z@T_yNqu^tkkw5ZQpUZO5LDwNkW#><if0vG0>
z(ro65$sL*Ylp%s1y?yMBCLef$Y0D8DKSLP+2-&li%;`2b9^mRY!BL$Z>rh4i3F(n8
z!-ki2`?fS^{4>l%rYg|OAO0GiI|)_-oNXL^f5B9_sARZxU@dJ6FCB{o(syAx7{H0}
zK^_E8xX@Zs4xYa6k7~7JAj8k{@!O6SsiDe1Y$_Pg|Kmvq;SJ-L*g6@&0+aywFS2~*
zIy!}6hyURmU_2-lEIUr+LwR|#M#T6a$3#8>!|>TUHRt_92xZ+xf&W~*`Fxnt|1LDW
z^J6jJ!!%TiiiWO%Ex*sfMwr4=$Fclyd?i3s1Ts5Z4p{@?$S)FdXN9%Pl*VVH_043F
zMjUr`1&>Q7cFweDK*1L@gdF1!f;wo?<mV*BPv4SW9iVu97mLP+O{Pf89;XdQhPZ#=
zwyXdFT{%8q9d-!e4Q)bbv=L%ipRN(drx<h!z>IC;rZV_$xFW`><?$YWCSJKA%e1&<
z@f;Xoj>_gGAh2&ATE;<B{3j;ph6nG-$&UyQ3&q(}L~~sd;;Bps1%b!LZ4b+b9?uci
zzHN=OMe<C-Q{NMPd*sVoehGJ&?XhG;P;h+Q@V;FRPVpw0n3`Bmnwx1!iHn3Vzddm_
zKJgJ8xeGP>hUFLYt@lobaRL0<f&pL?4jt<88UrALfe#>LJOk>MPE6pjpdD8ykDwa>
z<3@VhpC6dD$;~_E-4y(krrYn2XZ`8Olt(4HDrDr2-iwox`z|K2CC!)eakD+*C+=f8
zv@Hk;hxo4*B#3_z!!U{Wc8hmZqeqs6zn6qEuRu`z77t!L{4|SvxS4?iKw|-%WT1h6
zd7yyX7r`YCG<kLR!xR@7AAL@zLmcw4GyWzTo(t?7Lo<5jl?f1y<39=cq#R&p-zFJu
zmh};YF*0?3lZ+o?c`)(-dxLICO%DuD?y^_Pej}UDz9vE>uNYolxmPEb1aOx->6#h1
zjN9YV+n!!Qgt_4<7)@KrA|Ed#sIwm@B<#-5!3?MJ??iB(c=A4)gfQ9qh{=Rwq6EZn
zmzF%S8O^lG{58)`9Qr=>|1TOBjYxhjG)bT)1NO2m66Uea$qY-$K*rkf99@n1$VP$S
zEC2)Iw!;hDXif+M@W7o;E0f14xx8|qSBW<#hB)fbWDX3DPUIE4Yq<^UM(G&a@?!eu
z*HOWv?}mD@t1>2f|KS^KO)BOL5#af+9G_f}hd}qQ#L2`_W2C;OypqGNTC%I+d9{s<
z=~(s2PM!Cc?~mhwfl7dHePaMe0M&z?7=WMu{x{xi!Y#Bh@V0<V2y8S9jPI>jY|mN$
zJ!2<?3-UxkBy=D@8LzLBRVZw7L~j!W{G5<=$u{FzhI#7`Mczc`*ELEImQG9W9~fs3
zr~nV)sf_KauS**uez+pc5r>lB!SNQ|=Ar1^oSgEA;$~yd3Y)ySt`m|c&NOVfPnQdx
z{1Eth19(L8V@@CA@CM<zVzdwnLt_R!*<lhQJL3z2{!Wr%ejJuXL130q8Go)DsQ>_`
z^ot)4<G}U%<ikie0mb2-*+wo8#qn3ib79zUR0~{^$N0I?zS0KK${&}*JC7YOAo1}A
zAAq;&nXzk{-MFp^CEmar^Jb<O<-CLx5qL|wM}-<cB_f#PIko~dSRD6M3jR&H`KSNH
z#|9(K$C5gJU6f)m9pMh=g%xt*-LD_0&<{>oRCp0M!Ph65fSx80;^?M}a|PRl>xFPZ
zC{*F}@xsEeX;B^B>mp$zlgIkR_@9a9p30+na=*k0myg4%u2>NpM%O?1YT@{eXFh2_
z6am3(A%{3i7!MHqCAtM{1~yc|_>3eyUK(~-Pr9<NtNrzCUlC+Tc_5R-$;no?5x%_>
z!covz>=-Obr9qRLi&Jx2))RmJJ>P>~Xn7X0hP+E)Psyx!s`m^h+x*9P_>BBqYH_sE
zMJg-g@xyZBE|<-w!Zi`Nj8{EjluLj7BhV1~vY`zZ#XVZUf#R_yrM3xTG5npfXru7A
z6{M88A0d88bCZ(QS_BxC=m_{B8p;3w0ssJVZ><6aK&Vzzg>A;@P)fbZf{!GpT->s&
z1n2&4&ja<BWWD`PT({S^2+`eN)?O9t<)=LRJ3BSwGHjX_Gf?vLAgf;udeV!uclCB#
zO1KJL9!$Y-w#BZ!b5+vkY_pDsQqf&B*HYZAdfPGBmmybmO=vXk%C8B1muq;{n~JQB
zOhh%QjiXKNJ*t5<jWljVhbtf?hyk$NZ>6%fNWNU6BDzk*&ZIMT9C8s5v<kZ!gj<WZ
zej=$BokN{~hlMoXFz=%&nsq2O1r~?NnCBT)iE)8bm}?+daF$lJm};2pnz&*)1SCt`
zg^qDhD6VEUxu^)Kp|6l?8y0Y)>FBJ~2xWqV5BhFE6bKE*0datzpa1{>05=(r<6eHV
z*AHm+y?<Qwk6a$v?Y(EU{6Xsh?SOjVdtSe+4{htcr>*NAxUHCMy*k#%9#&_r9=YxM
z?`#ij^`5cqJ)_nhxb?%^J#*Uw*8l)|!R;Q~+6SzAPgwSz(d_{C$G7bs+u8@T_Pt;S
zuJy;Z1J)k7?fYOJ&<|{TL)&{m^@s3)9>26bx3&*#9?*M7w)Vm80QTOw?fZVeAsWm3
z{acT}a%&Kl1~5D6Ny)>KUQkd}P@r9rg<`=~ab*^OHbZ!n6uakxaYuPhr%36v3|4M%
zc`+DX7}0+)s4dI}AqtGc9B8)*AV;LuGd4dyJUH+U91eVgp9Su6%-Sl>9Nb*aTzGMD
z<?;FR;yC>Ixbr!_9~U#>!OAl@UJ0bZ%ZMBthYypVBaaRs<H_>l$mViz9C(~K^5en7
zk0&lJZf++Id;^o7aNXx6k*e6^&yP0_BZ<q8A;XK0CkHNJ$-{}uj~CC1d`)zC<ebw;
zJH6q_lDaej-&?fg;o{J$g#|?l0KM}mjVCSDLSqi^SDZDKy)%fiQE{(AqZz&rgNvJw
z4r7;}KZ0(mBRn^*>(Em1HRpaz_|5!y@Z-QaIeb9mUgs>$ylT#ToB-q=W6#6~m;gKg
z033J+GlviZkR06k4hIvPkaOk4I0J*+2d?jbBf1~^U;7{XJ=4DRgV%eYTC}3;tEEEo
z9<$as003DmL7PBo70s4Pj>_@<M+6Lvb4xWABgBc+Kkc9SI<JnG8<E^h-OQ3}<h)n&
zP<3X5I0&1#_pZO`mzS$vD;MJbiRAvNfnN-8&w>FwNJP9S`(4HO{wf>x%(@y|zB|X1
zi81bhzvky;G9+<vTwapb!d@;+OZY~l`mIU)oZe{xvxvu6*;#A%aSl(55I$z5(lH0!
z{3jjrLjkw`J|I3@U3}Wx@fBL8m*(#NFT3vVgs1Ps{7#T9b5(yWYNGi&xw$I2IVqOe
zvs_=B#z;Ch#9C^5X{X!r6jPGgYiY0eg#>SC6N#=*H3I$fQn<c2XOs{Hm*RUjRs6B}
zO*7XgLm>ykeMVTu1WcK2Sec=Z&E~-vnQ<Qo^9KXa#lvX6Xa=}kDU#sy7x5pA@$Sfb
z1Dn`O$B$~Fphf&xA$kkKoOFfoV~UTo@v%L8+rR}_AdGw#aFNEu?HWPN1Qp$(iSsDV
zE60t7>}nhm;FH6TJiOU`H{V8DaX&AL#&cSJek;0l9zT*8OKs38VT{okJD>1@)kJX>
z(N$#Qqjwo8PHJaFcSh7$0y0Y172UWaeEORL<MQAcP?4BF5e%oE`{)8VEs~!t@$tet
z4AdYdkDxCF`9NTW<M$-}536XxtXmJbYD%g5oACY@|G{Rl*zP`tVoV~yfoLWE9;0bI
z;sVfsHDNvrt-3)YH5As*uvHvO@sZaSD)a`R4Zaye!e8tRcz#eX1v%Ls5GRG42w(bS
zG%t4pIWX)&U)~1;znAL&1d!5{^l$a(oJ=Xrgl&jywe`&`7#QJ?++^J|6%mZ)$(W98
zytjS|IjJfeGfDng!`MuX&6xrcv;^ea8$CD>6~Y&p6UmeX8JZarOn1BM;JQ3w3**`E
zT$B)Pwk$p3d@9Cjhb0eYD~jbNkx57RB<;FXehY5;A@~5?O(}fViXt{9*Uot9&%hFI
zdsC1=9{vcd5K=7)(bql+c2Kj%E*c_euAk$$AHhU{%!W8S!TaRE%}M+cTU5@a_<=Cz
z73PeBC@9eJ@pj5ysuO6^`<6?I<?5!0&k>W862rs^laf71zl!Q%;lb>%b*yXn*b+AZ
zwAWJ}2!Plczc8UtRdDg{FHXOj3juP{+CWHoZSkkeR?y)$BR~1i*EU)*ugflA$Plhd
z60`_g<k?roU7-87UT|sSNM-S0U9>@*hsIbPBIYkTgj5Z+0QEv_6LRUP97}{J5On7G
zw<~;_7z}R!9b99<54Ya<ymVszctmo-M<+|e0Y}zW_(H){q6H<BKJ6C`!4_Kn0ZuN0
zXLMs@Hht$IMIh6Hd+Q*Pjj&DrGcX`fBTfzZL*|)}D~J36Wzpp|VutYSGUn^xUVo#k
z5c?kjyEg9eJV1#!B*qI=9VhrIj+IFuIdA}f$4+Zb#z))n$Bl%J99}>!;0vxjfG#{R
zW!<&#SB4UQf-6VOuaCoZo#rSrB(dN|qwl-kxGar<MidJKzCWnCpEyuDh%Mh8LD>Yn
zW@zkl1ReoE3s45ZzulVscpy6D!?#`hO}>IWmVYKS`-2C>;k2mV_}uE`u#v(n5uRJb
zS)abgI}eiy^bGzGuQYqehLd)0<>8k%4Ps{QT0TgOHO-$Xc&<V8M9bb0lZ1SHV4>uA
zM$WvzS%2a_8(CY(Es`VfTf=Np<&t|J3T8;Om==4e@aAM7lX}s6m;e@-e(9hEOQqi(
zv;?C7e_IeR0Ct6z5~^qb1eluSr!V`^5@EZDd=OB6{;pr^;l%QP?q0sjUz=<W)*uq(
z^26QPOq{YyEPN8-sD*c%G4maX&%6upKgECixX#8+%;ey^q&tI{%p^pvJd-3VW)1na
zYzREv-Vm34I1OFNpAqv*3nYFCCnRgw_`dBRd1m>%d{p=#klhi|Y!HSJN@R`e_*I(m
z64n|(1<T}{nYdlw!8fCs70PCt;vN`;GD8?3=F=J&FVA_X{v%wN^iG$8y(oTe70IQ9
z7uaevF!z&*n8o8+SI&`eU7i}1L?X%0d=ukm7tox{?_5VS#mdB>2|aw)5yJ*)t~<ke
zi4I?5BP;k%8~3rA6mN;$**719-!;!8&NszTV7dgdca(G=i}K+1kU#ENDU5RPOPW~{
zqC8)Z^4g?hJ`%DlhC&u&W@9nh<1|vx!c1*NnF>27(CZV=&EeGge0PLQ2>?plpQXqW
zy?vEHGyV#w5a4!8fH!~wG!YAg|A%|@;o{{EbMxX44>b$9GryD1{l<q!zl+quif$O|
zb^P96;Rz6;<w`+K<6xn#7uO0K0|P8|_$Kr__}-Z;zQKlf6dZ8OKQAhDN(`3)gF}sn
z@1cY;<7d9V1r%srGNru7g5RTHP&IGxLyF7)-zFb~G5iu+gv<k;_sumZe*_%;DojJ5
z9N+*Ipz?++eiI+J7z7W?N7t{2imBcbgfgFStRaf#hFy&s8-tgVf!+!q?{k6zU3@2x
z1RKWZc3wX(+Pwg>h5{R(6+@Jr#;#SMKP?VZ=7Bh$MB$W{dIemV>33XX$M7@YT~H`W
zOG*UrMha8(ycB2{@EieZjG=<P6~#vZR(1yF|C_Y_5|#{^V?!aKu1QcVC4iahKm6m@
z1(~)Dz?la{G1N2&0E$Efc}1Qc-nc^YnK78YW3_j}TMi$sPTMaxjy-%<8FJdp$MR(k
zz@H6s69;%N!wjNW*Wp~KeKmw|?ixCE&?_^2lO%tLxre+kl{}mi*uY@~i_WsE2lx2e
zka!GKG2qX2rwrABuXhoB@q?c`xMa4Lb@t9?B}TX)zG+SmYat5(Xa`%qq=cgf#8OZk
z;QuuL8Ehyis5mO#2nD8S6;)Bn-*Zd=2*`{niG}*R;-j?utYzfNb{bPWPj1Tw_sxeT
z!Twxu`r~!S*$tZh7)lYY5&8ziyQ`Nq$#h1K=FNjyei5Ho4=Kb+(ik>>ElB9}BID+x
zIKlj$N&BS0nosfjcChLw+F0;GAMyIvJcr_FIs-ce5FFwH$GlI?nxB$VBa#2XUhFfW
zM?W7K9!^V9?)*k>jctfA(?bRq-<PQDUkO+m7~mnIhNNo1mk9O{L&3;4Dgq%8&M!E)
zFG>52CUdO!?=M`vGw-~KkRS^Dmmh?=-@WOZ8-JD&_qKg;Sq`DKjCkg=aaJ60Xn7&N
zKgI&RaY<-^&c`GCDWF5?2!07Xf8{bv0(i){Gy=g!F3|z*!@_mv_4Wdch6DL9?k9`K
z+HfOymrI$dQy2j%1PreokO3PrQ#kNIA9aI*_0P+@{B*GPWI0TDAVoQUxkCYGpuDr>
z-2sn2*xpH(GaTwXCy(a4S_%LBzvFm9!<J4vtbGB(ZYy=ZBaKaZp|<Vu5q$CJ&weA%
ztZ}*{+vUg*8~HJ<Kf2gmm`W}xGneS5hnH~T6>tQ(Ci+4+u3sKFP%Oq@3CRfjV~!Cd
z<|sTz<><qSi{zm5XM(v>ZQzZeU)80d1t2w#m4MSOgZv{<<Q%}{95xU>XtM<jV6;?P
zJr{f>hUBG`3YusW;X5W|F@rSnBYf0JhLCz|@TM{Zfrd<D;I!tzKqbe?ds*qw6<m2|
z1syD~FiFW**92aC?}Tc}BIzu|cMNCn?BfK;;2VYE6N2{?=Ar{ilKA+{q!54R@~`6~
z_OTA{WATvmupN3&>X`WKfDD>%fwf=s6~Dq1q1bz#SyExjjBJPD8V+9}i2?!5N4&~E
zzE23k7=x0866En{!9V|({JfH!kVJn5i2R%}5_Ufc`Ity#EAf=!_$u8DfD-~INVp6Z
zf-pVL_3%S{0G&h0#a?hgXNY+qf0xii>ymHYCZadOdu^0>cq_ceU?s_p0tNhLm4TWT
z0v?)H032kMLv<Pe0eQ;TfFa@!g=d=s2b3;AIdgZ<t^OyDh=|Z6#j68=?~0(}Fsu$t
z{IS*ZYU26f8#DjAB7B@?b2H{<=KTnD<~lO|3;VSIK?{UY3u+l(!r5*|<FX1EAPgmd
zx!gGxgX@BMgc36z5$Mng+g^&`mY%i1J{)F-%{|Li5dRHBm;AoI9?d`VctD^Xo;vtv
zb{HhV*s-ZUML!W7C%{~IvHR~HIN(I!kGYt7=H1~g;|RZ8yS>C?aWQ;UZZptPfs^@s
zWE=-KC6Y-y)$X`u&?@q73FZzuX|D+w-~WP~V1$7VliFA%aPPxS6!}oUS*~i}(oB42
z0xW!Kqp*i&yI8S;e-H0`RBd&!{uz+Y`<^c~`DhK;1=l9hjtCLCyEj}#GU7iO5I@0W
zH(`zepfi_Y7}Lx~zyd<LQCwtXJOiC&zB~d7YKB82Km?j_RU};j`oCP-W)&mt;nH(j
zM9%Rw&5Z`Rw;Hp;RiLly#>ea9B@R#;Vc4)}s>Xa|kDz$?_$vnjye|PXZda?<1$@}4
zYCHzZgX)m|v+hxgXByuX(hWZ%Oo%eDVH1n0FqMGSWf&)N7B3071pDe<|HS{_6XU>v
z4V+X~;VtuH!v%rE5r~Pz#A0d?6E7v-6A`$K(K&Gh%*<(gedh)t|IM(*`u;CNjDdw*
z%y40OxiEtTqxetC_0I&{A+Ap^@s`(2r<Bi0)Ly?Y-YfEEt-U{lHy9xJYu%<f;pMTQ
zCo=Wl7003$h#e@(5@>_s?9y@kJsf#Nyu5r6E%8$1+DSHK#UsJ4N^}~2D=esS<QGA4
z`Mgbt;0=^A_=k`Hn!`f|{a@i4nTBhC0uT@-B&-zH0LcgM#OT%l)IG5OF69|s4L&~X
z3FhqXjl-&hhKU4e^2{yZmcSvzp>c8ZX7|TfW=TWri3A+VK3aC`g(|`gE-!6EQCmo_
zDOv;o#K0XT#f29C3C)#Yr{nT|5u@uMU}Q@e7-l|1*b=z$)gS-_paEDA(V*7?Z%q%!
zFtxcn%WzbE)1m5g7w|(=5za*a2>5@0$4iB5B&|Z1g@DWP(HxzNKhy93hj+3KV{?c(
z&Y2K%J|E{)$T3u6l2VQpwU8a0bI$pgQ>7!4QiN@e;p0?MIcy|SF(OmTe!jo|V0*kz
z_kF*f&+FRz4xMf?eKS#GvC*aOm&Je1B0X|Pn1A|}%<pT&f%hrq*X<m{l2(2Zepl<!
zW2Gb^hkA^`GRJ1b$`L$(Jo}ZO3FEn-)2loShYZ~>%DhOAMO3Yxw|z5sz&wz4nJqJS
zMP}v!>1x=HEA0;Ex;ts>&rQGUAq3L5i#OJOMOS`PJTTHan6np><1$&fBl<HvhA0AZ
zNo@wrkW`D5Mn9hxmIV23w4M;V3-?Rvo4v1J9-_({94rDpXc&q7m#!1*uw;B<G%FW!
zuy`0WzZPkZb!98r9r^iEuWW}sVo5pkJLhcYmFx)ma6^ogMH<X;H=}JAHXANi0aiP=
zq{3`)+nGLxt}3({MN5TA*6PY}64%&wghL@Z0zJg!dyc%KY??q_74@l=_=8q~zPhk4
zaO>wo@!ZU(U_jtu+Hqw20Xp0i+3N!5v-5#{ui}b7Ui14seVb_(vctB064P<_l?abY
zvB7=DLyC2wkyy}eDInkp0FJ3X566h#{1I`ly{s&);cC5=4+WV%kX_Xn5WIgf_uc13
z?60R^D=#u9vIH>_6rZ#c_2iH~X0l&>atu~ClMeF%lawa6k6mVr3B3gzU<%q%p=OsB
ztV^^gQUgrc``Uhy#Bs+LapU++7Wm(Dh?Rs7z!P$M)d^3XdYwzG)yQ}g)7I9E;#q-<
zPJfT*vX4Jf<y_m+2rc0`;g&FC4!$&gLX~~^fkgNa^@15B=zh_E;0D*u>mTT|Uw<Xc
z41U^=43ozg>H?k}<WK}Ly>$QE0G?&>P4idqvUeOxwPJGQudbgmsudC?qoZZH{kZfp
zQz(!7YSWdMEP)=9!-ky~Dwh&hBM>TAt$SDZk~sj>=zp^_Df7i+kcG_OW_sl5Bb%qL
z^(w%QztWiiFC_oeVZLCFJd3npsuBGYKDsxru(D>1-E79yDnxk|v8y6U+>E|6iXd=J
z6!RF!T89KRw?2qraK3N_tl#u_KOEXe%|X4Se~8EQ-@{1QHC_kE*aC_!Jbx7ao_rAk
z>%S-!Dtq!2^+U2qxCY9N@w6r+0KGcO-hC(~W*;2<0{8?YmTrYiQM4Z>{eXZWrdE;{
z@mJ#K4T8_f@sNu|IISeWB@pjZZBwa9?A{CI-HJl2`0lXj*L&!Icfz4O|MvB=kUxPC
z^NZ=cV?R$MQ=dYbw~kBnE~L*-SnMBluf(w(2MQkutEj`_G_VQz;1(r#P^tM;YBZnK
zp>h+n#_3Bgj!Wtg9{LU~=pi5tweTHYE{vT2wWHF*ajE|)iMQXtB>P)szQ;|G6fS(h
zN-d)>e132y;8@6+o+5Irny_kEr6DtZPFxyGx@Z5cIKZ;NN7nfDZA^);h$qj7Tjlo`
zU%WHD8yap!%WuY_VYD<MUH!}^g0(o%(Z;Vw^Az@~Q$)&k<KNou;d-A7D3pE1({;8t
zr!&9iWR0etFjo^F@*4hm@$nN`wTYw8CPY~F7%~0uG3}f}01v?mEpYUn!PoyV?M|ft
zaIyjIj6zxG?)oSHO4W91D|U1C&Y~8@lCTM5t3NWWiH7K(f6tZoO0U0qAE_<3D`N$B
z2yng2tGn?Y9B7*cy4ML5?Nl8(8&j5J_)24%dZJ!d#Ioaw@g=B$Kr50txzu+`PD2Et
zRw^|?(0B^j_waKiYyA26IQ92e@_n8@KUwP@7eWo`2-LS9j~>jx4_y8Py@8Gn^X4t|
zH+FP5ZdLIRlN_WXa;?G!-M){&i*Z8U;lK8N5DvKC@6K~O=5!ypjrNGA!8z#Li*g|L
z7F|hXh%4S;Dd^Lu0WqQg+LrbLTPhlG8@_<zZV9yv&&E6Z($oC79(_o$znTbd4M|=q
zEl#6-qa-H}D~e_Ls2g4RD6zI*_1bFR85is4IPha*8Nnl57ZEO=(H`W7;%onP9AgFy
zW<t8POy#jwD%gCE;=5YPkZ`V<C{|KL++nU-<(whY<;FlmfP(hECH@N7N$;wfKzQv3
z2Wg3!)i6e<y!mf|zeTx{QkG_ZgQ5>5rGY(0czsk=&9SL{J-@g^;orn#XUcYBmXdgc
zV>UnVVw5grp^3@N?V}YHJ}&UuyM4j0_KogjFr~~jghLFx*~dwCRTAzsZ>8c6^+pzD
zoUA9<sL8QaYK-a?UuaEt+ShrC2ua^gSENj5rBg3lxt(^^k!egl7|HffSH9fIhO2H8
zE>2(HTg71v0B*?HzhZmw-6E<&)&)%_ookkQFN&{H2d_i=sITba_nu41%XQPc5)_PR
z9*w&Q840?8e^dX(RxDTlhy2IE)O-1^VNus!>1y=2-DjQg(P_?h=3!CW7C|ddKr8%|
z2SwwMXG3b|rQ%Nx0zf-+Di^*yD0FmolZZ*D6n*<kw-23B4Zpfy1fFWo{&zl*DK$%P
z9a}>?T`jxOjfsR{wRqDowzT;ezW)Cn5Gm~;^5*tk8G<Vx(Z@Q^*ILmmvkqpe*MzS7
zuF8cX8i{-!=s*OOAT+`F3j%hYtN;mV0$#bL6HBbGUY9y?)SgiiU#fWvItCqk_4DOZ
zEo+imDrhY~(z733&I%S|@AKYwT}(%Y9{qHMRQdE639PRwoIky!W&9OwHXZIH?k|jw
zT!>T2y3j1Q<&NP!gP2J6*B-DFimqA_J-5eXN>3E(i~t~^GUwqwWRll#_rQOBUr==M
z+C<Eh&clPGj=tAPT&eI=;r??ga-+O^_l=8RJ*$*5vVQZ`mRo+$;4jS;^th!3t-;ic
zKC*}pmuL3*-pajgNK!?7vCL;HWTpFjm3nRWs3JlycGMW}KqB4NKDu-SiyE{=pX9mc
z)KvNBF(h|!TQMCTVfNC^s!OCZH1u$xp~>|U?A6idI7#v3--t7tOLcC2KO{{I5*$H)
zZ2+;XRE<gbP%Qmoy-VuqIPj6^^y1cqWEVlcQz%u+C22D;e*G~4eXOi1RC_bPG0Q;b
zMLLG+A0A7;C)E1$d(J|r+RfDqjj~Z&jucQd0ER6|Ue(D1{D6a=S7rcF*h5S=nwiAw
zTAMnD%<*achW(@O-li?;|8_YI^uS_8(@O|HWfF2oQ{VXbq=4nI(^#c4_z^0o{b391
zv1B{UR^jdjMuH%Rn0s3Fs<*8MkdNz(iQZS}Ia~>+`7JOW&fz0co|PsBwNNF?1S7uZ
zrfCm2Gzv*Nv`$F^WbXb>)GeBG=)(?G)I2pQ2$9%ajU^q>M`{}1PN#xD!`mgDzY#M^
zbA5qVOF5momASMl!a3=&5w~zzpxX}YVX!OFPC0ouw}*eySm_@14nX7Hy)gX30cpd)
zTSC-HZZG^p)4}u_^`3N=+H5o25a)b@wQaQl|MJeqR2|LJBd5IkTa%{}08Lrk`)*5X
zy^xi4=LW-1)ZrR*P0R4&^qFxJ6SLNY3Lj2q+?(iXtcZ;5QW*Yw^3zFhP6aH~Gjo(F
z2+>~9cW`}FQVrEHf<&KpVO@V3IxgovYy4(&bKJhA?mpB9l$qC66%GbG?7mg6_UX8I
z>Ut_^m2*5J<9PuNIM847H-L#{KT^ht{3jQDADJ*zcb#=KDCgi>O?kJjr+$0Gu`Ar6
zFm<BcinROv6lj9Z#mTdbklEgEr{BY{Z+ozorWW@fVaH(q74v4q4tc7Qj&OM{Z~IL^
z&g`9tu2gP*Jz>`aKqkD_X}0zspga<LZ=xs(10t~6Hl2kqZnCOKL$!>wd|K(z{>O~)
zXh!{w4~T?ork5kEjS)h?HOFBpptSkr>tybiLezP(4U8sjp!V~qgoyRchgGCqr@5cP
ztSk#yk3RakH@HWMYtxNMKJJ(Ka+)_Z!0bt@7=U%@Z_C}fwa8vr%OVD^5%$fCbuvfr
z7WjT;`eoh&ib+g*g71Qi!V9iX-c1K<3DPy{$f(q5zdPw|z6L}ILS|1<d{}?~-xXE0
zY077>(wQ|1m^8z-{o(|Pwq^3fUA?1g56PAAB7>d6G_!$CrGWxqyxje;l(VYjwG8)q
zMgVFrt-lB01DL<d-x)2}b#gcj-{QXNeA{olTjV74Uc5jzr5s~DAhpvf%HT<U3}T3O
zaAMP0kVfI{eKT=V?5Ly7p$0}ZJxF5!6}Hh)bFGBOKTI2U&ui;#Ny78`hWia$UUSb&
zesM)oJ4{Ys$A*WN)9FG7#ajP&%LSlcq4q58M580W@Hc}u<#P3$^459-qqj@9tqwh;
zU@$Y*78lvK;6{*@nj4YbG_w=uJ)AZLqPt8dD8iW%7gSiV{zH$>{R)<Uv0(UdXTW0p
zs-$ynnb=puP2k8~6(#uACmY9KSJa-WvjB&fA2TRmKSmxa1uxKFbLIIbW-T8OA}HAy
z3lDxk6@PwSJQ^^v5Ie`^a$&xIeN|6sLpag?resz`(maOOBYX53IJewNVrCSOw?vC?
z4v%DztT5>3Q3c7;ZAq8ehkvgC&>*ah!5Fms8s`Uz<eh3mk`9&Q=jn|cO`Dg$m~MW&
ziZD7Q<;V%tdg;gNU={Zah`h_?mn$FzcZ)c?s4(uHiZhj*mT;hGWm;R8gx@%W5tH2A
z?OXd&ASJbexBh`jP*guA&x}@2GVOV>Yw^&zLBngpcU*x?IKBxaL|L9_{&FIh&-HT5
z;h`R0o*LCT+YUW|LkV&(=Juc_uKto-Jfg2ACyZ<*z`M`)L!d68PFvF*Wlewn^I1gT
z;ze{&@vv(BMshvw&5{5wp72ArdmxrRsLfm+?>b*}nsIy3l$2~N#l631jQP86U&t*c
z=}NlMZs>_P+tbjESq7;=T1OvnN;l_`0~ak$0APQ^Tspl83#F}ALr9w8M=xe~LHpd*
z;3=1|rGKlbThoUWDiBOkKQ!}_y;X9;xgaIyde}rRlzjL|D0`f9?bH2*7!k{~GZvDf
ze*`%~BboLRXF^zBZvwTS*IH579gEwQ*zZ;9rc7<MJlP+eg)&*evRb;vMLch;&0)g<
z!X;{XH#|hg7A*;l{OMKi1n_d4LyUDvO=TN9qMTu*!EWD`TUlu&&rmtu(S3g7CSHP-
z`s=N{!%qk)Z?!4$@{9Z!fw7XzrN_tc{qEqr%<*FW)Q3V#9U;?v0nubhjF!}-|C}$)
z)PxG~ULApiQcA>W<<1bH8q1{HIYC!RB5!J-v?H<=NHxnh{@&5Njk2b`zlah}NuDnr
z*GDBVqm0c!SB^o-u2+Jv;KkQ1g#fR*=7VVB@#UJTX!Z%%`M|w)_FlJ)`<eh1=V$5z
z5&Ir}C+*aq;FVm%=1Gr)bHhrX5o?XdK;P+0U>kg6tk9|{FUjHg);QnzqX5*HmG<(G
ziE82CM?(AB4;`I<sLjud%DS$b4I3NIu{7V>m3Oj)ED>I2wPa)54Wirqh2f!tq_?V~
zZypNe!v6N-MMF24-8lID{iBJyfnUUL9!Vw^q<V^-<BOZ;CA2#8tCufD7W2<(ZBQPg
zM%q=<`F#lX6AaLylw3BubfSb$@Bqy+!FIez){-Kp9dqv<y0XG(9p-Bb_{@pbzp@(n
zoWH;}j)%M&dR#*~8p-lKt1n1Oxo|0;@jhq6S{eVq-xogsl1Nr*m(Hr&gnsO|WhGOD
z@@d5#k4=TWfBb;(R~tg#sS2<U7XlCxNoK$QKG3RDW>tZabwLJBzjDA$jA}#a2nFH{
zEEfozB4)nMB1)jMzb9Wk#`+<atY`X<zgc{te_YwZK3W}Gg;En>C^sfGJKK=u^-bII
z1cAx7(b*JqOH)c=1{YHh?y=?+BLnG}`^^!aKwC%uX|wqt^QxMy*lY$y%0IChDw0VE
zd8ja<)Euox5`~soZy@;4Jx5*0u_VDxdAUy5%C`lZn|3AC&*PWTXWic(b^n)5xUe9;
zI{HaXPBSS9y!gmQBh)YS_`Gr;d`8p)qEK=G6d#-hHQlq(?nGG%9c<s)VYqAF=j4>}
z%xPNGQ$3?46Rc$3U4>K&bzzfxM8?yZkr@%m82$VQNJ%evs4G^_NAUhe@mI@_CW;SV
zn$+%vZ*`3JXVs@P!*|wvxnnzX?VrRH6eaoy4l`@-au?M~P3@jZ9l+%-hKy&-8>&P~
zz3UFxyYZ!fW{|$9GdufXU%Ll=Jz=_qg31dzP)la+n<Z<G7t0D)+qQfn4F?_^GriMO
z?5?*KNk=j>lXF!3?f3R}=GPLt2jZz1-pf|#y|JbQq3BQA(+dXKB>!gCI~}M;t&9Ls
zr27`LR~A;!>mU0!kzct;e$^461P4(&<=T{$I^5wkY_*BpeOas}p-U(?(->&4)dz`J
z*8)k32PX~D6II?l#|?#Q5BZpuin;5zr_sD1JT;)VfFdHFXKVRH982B5{T8Mb0KiMU
zI6Qca!L(|aOE{dJ{x8YC4$!C|ZJVP=@snvX(gz?gJVJHfYLn9BG)Lka|1P!%i81mH
z@%bHivP%wS$K^4lK>bjxvfS6mMnKhh&*dOu?>0nm!CNaPU7}N*>3X@g(7L9rCeZqv
z==_i><>+5V)8Wk;qYb%C(qXwj@C1}y^vo_U?fpJqTT<P-yf>Qr9{ZgDz86_m3CabA
zFyk6$YLfY3AHfI!S~YDI8_0sM2Fl>Z^{zuduH6@hCs>Mp?3kti+65ndtA+a65B^KF
zC48PAPhpa>A-X+kTH+fN_;LD8;?#T{=%c5#%?s(ZYR!MqSr(&?ien<)d#MeRSgXx^
zH6GB(wZYR|o-;|nr-?#|Z%0|PGYTF+@2kD`{x`G2WzQMDTdzrMA9qe_tJbB9M54LF
zKNAjl1XGzG(g1%ekM_)JC*MeyFO)XGr_@+(X=E@G_?OH8%i3g(IBq%gS9XO&F$$so
zOp2c-EJuh;Px!Bv{gU3B<OWTzcstGBqXd2SW)O{a56j3{TTqCBuF&@&^}NY;XG_F?
z?ms|&4bfZdx7H)}wvxi@$B%v-7`r2`l<1$fr(Fg{wak8gbD0o?{%JL!$GZFJmxwX`
zIaodK+6wk!dURDI(vhp3ywr2Ob__nZK~_yE`7qr}aHS&f_>^Yz)w4*JGwNc+9%jxr
zSh8zV_=<zWR0a`#Id5M6H;g=xp7GqNT!66sb}o>o4UcUeI3UX{Ev_UjM)F?rO3)MJ
zsYyI;13E_EEY3Kj6(=g_bNGRJqZ*4;nF`qv<%kBKg?r_Abrc?$Lzbve>=_0?7lG>S
zZZ-lyxoKgfpw&Gjv*GQnXV{jG5;_OvKUyP|pmOECGFU@B-0i}&hBy~;qR09<3JUP$
zMO*3}{U)Mt?gz>d!0?ld5xKP;$BC)SwJmxXQT5-sF^W`&&dE~e-iyp<u}X0i+9Wdj
zuEM|eSMF*Se(hqZprFiik*JdbkWk2lv>y!S{j<dWDFvTPJ+u5>cYmWF32FOqYVAAp
z)`YlyT$VkYjbndF;@Q`=+@Drz21r0f6z<|YEeEmwumAvj-1<-u_}}~DC>E0CHvaw`
zf*;Ub%r0A6g?appJ|mX}N>LoG%DQxt`s>D3s=of1uS@u5eHAQWVngT29j5UO?Esoe
z+25PlSr(coH(Fk<Sy8W<D&SrBksjoM_gW64sc}Nn5>*=Sj>{lK%XpbnoZyA^o4+V|
z@{9_AIt}$^V*G+)b{ogh6)2F?QTZZ4xidpm=Xxt6Q|qROgh^CmdaxDbg<Y!A)$Fu+
zrDtm8&R_C*>A=**i%Q39b2GBj;q3E?&q_+F!C=)2r*1114Yos_$`83o+s#88BEKSc
zs50c7sh2d93J_%~i=M~NFBU4&J)X#lTIFXX6?z-Mx+$=pYCo3Js=&C+t9`^3?bIN>
z;>WIH-RR-(%)&Kd|N0Nxm6fF%?xIK3M9=y2^)y~BkDFMznGpKhVCl%)1o2__lv*Eh
zej?;g1PqenpUIK@5=ax}|8v5La5E>B=ME%5QUZS*Z9q7Uw|MRzD%5ChjiY<n_+dB^
z$_$nTz1ettA`g2=F7gt|=8+9odS|OgmU|g%KU~IT3iu7!pT1f~e$CCw1{@(5Pb~iU
zOjpZb!?`_YS|PYlfdo@$j$MS|?CGbZtDhI!ALK^DWHDL@{=ualhe;$QeKxqdxoWOd
zINs>nKEI-EWU;&5Kpb4vaOk8L^p;b{!Mx#5zA+<*+a^wvj`&y)`J5II`R>6Q0j_}e
zb54R;YibKsq8xf)_{IEai%9lUrN?mnOo}sW2bflgv-|s7w<TI9PO0s?js=&le^7Wn
zD8?Mzb82#^+2fq94Il!fZYpH#JSLNBfxCJY@3D}%!}oY9BUwlK1dl4AXPEQiPJvK-
zKE*PXkmYDp!bHrJwU_&Bwq8(Gx=5W=aMNVvp^hss0a=?y`d|Uv!6TlHkgXFh25%HQ
zh1_Ny$to!-#5qcKhHO;IA%N7oHAbc5g9(3q1zX`nCoLl7L5^T4mn9Op&t5_TngzLW
z5aC?fp>*xE@#qlxOo5*)jX3Tg9cix2=sMoD0}RnxPUL4+Y>&sy-ZR)YByi3I%}}sE
zO+IW!e^JucJvip~o7%TJRAV6JDj;99E#QuZZBC~A8@vDqM|R4BH!IEP{Dg*E3S#v?
z9EJ4WmE!{0bKXUOTW6da6V0!a8>Lpg!vzRyRxHO030=A=H^-dX<sJ*w#JGoJd3E`0
zYwZ8^jK2r&UC2DvbB})%uS+g1%1rvcz!w4shsoED;|Vh<EaRD^i-~Mcbb;++;<M|g
zTx9U=sI60-f=(U@`Zsvffg73qimx}zXMzFQvsSx1G_MWwj^$-)=@{WA_o=1v%%7Wz
z+U7*a<yVIGN#9zql@7w`W4*yb)q?2}^1X?Cj{>yX%1WoAaYpKrZ=(NuIOLHnOQfTb
zU8h|>SGacnNI-|imRRc6{l3Lzm$LrKbC7kR(l2ql;}>DB)UjTsV%jwYm0y8LQLgh!
z^E^+@4qVM!^9h|cFQOMQ;ND`{-JN9V?gcn5dY`9$W-$HLZ+h7N8px6Hn#z-*EOH5L
zZ8oyNx0;qbSNhJ`QT4I%i5>3xbAPe=rFMlz`#V4WZA#O0FCH#uo(ki<BDCBD9MAXV
z&K*OiGB)Ijr>I&o1yf?G`-Wk={H#6WxZMTXoBkQOX7wo8`T_P{wUTfJha2)`IU86W
z`*(<b8dzo9O1y@9L#gU?WK^8i$s4@wpvBuuxU8^~xu+M=-ZxV~sS4&Z{`kcsI#?l{
z6*T&$#lIL>Q~LnT`XG5qrBXG8y?BOiR#V4+dO#(!FU-YMT;!MhrYEs~kw9`Bl`cwr
z>i=Wm;2k6&8y&S3Dhm$`xcfaN_N{7~POVTv@#dG@9h!ENb@l<f|8k<hIdGb63hOj)
z`<{d2&FW750<<g>!sW7nQW2XfV+P=>1B*CuTqQsdWjvaC;CjAWhd=hUGggIv?E2<M
zr0b1q!1IO!^pjwqELu$?Y)=IIy0}HPX;Xk5e9n6zK%l>mV;N4&_^<Q(i1<y6mYhy~
zKF&3Ei{?kj%_vgppKP@>H)2+!sh_Ggd%3jE-GAqUr|a4S)wzOUO5M4tW9gY|<%k>F
z#(3RL!j0?Uk#M!MpKQ3|%gOW+)eMo0Rbz(%A1Kq(WIbrNqW)J1mohVBo}E&8L8kaI
z;-JKU=T##p4p>7Zp5I|qWD5og;(FX~<JcA~SI8)kI2B52)@hD@Q+W<9CM!nI`ZWSe
zbN`wcn3Y>T*0T4VqpSQNv(M#FrIpH^@b;A0E8nJAt`(zSe_=N=nlC<$<2`o1Z#6-e
zn9y8wi`i)uQ{CmeuoxlDBPF!$J}Os<+Lph!%O<9dmwFOrMG1<6bwBhxi&LlmlwNV}
z-Py?g0Wl$Z+L2rz0;19fTay#|ZiSwE(nRMZr}mLg!6H>c`aH(z8S6wHPI&6$8g1YI
zc1K4C$PiZG2trac3EMG}cljc4y1JXyr!O5Y%>(>&QQ&Gi@BQWP+@_;+QIL!jF}Khv
z;q^GvVQHRE#mUel5<G#v#mN4JiXCOnbj|z4oen&(4USy8R0OyPw9cg>vVy8}yU;l*
zF~<k`von{1RoDsFmX(f{T2JPn|1i?%p(%+8qDwvhex&{UqGtSyn3I)^30Mm?0G+7o
z80c3Gx*qkR`_vz{23_=Ra<a*|Xx=~E-1CY#kvif5lU_NG*f3}{c}{OrQ<eYZND(Cz
z+krln1^MupWnGHB?#otc){G%&i_m^UlXPJam;}Tw459sYB2}-6b+Sc17x+ur8rK)_
z+Tj#3CFW;Lt!KJv&`z*$jBOlqlYJ59S4;Yfm~IYAw=3mY=7=~PbM66-i?LP*fz<%n
z!#B8lwX$wQ^s*1hBm6<yqrA2I@F!?x0j%V0x)EI$02?6JdS4nPzBjMjOH|mRLuXa(
zr1I?|4MTpikKM8+Iq(bJyHk+y!6Woo@3ZjF0|f=sJkdYibp7Ycwjs4dnp>P-+2ISt
z$-s3dwVTpz`)!L;)Xo;H{xBC^q8og>Z-0?f3ve>|$MP^{F|E_yTze_Yzr+aZ;YSUZ
zOb<06pbN>7UZ~78&9wu5LrkaKL3JgOZz)(v9e3?Pv&Rxbuw2bFh;@ef?f6hd!p^o{
zPinW;TsLIiyu#@E@)Jyg@CWHUb9`^|)-EsKVuCXDo$0#)mgC!Sm9tmknNPD4M2pdt
zZu=V9Mu(%~OiK-s^j5x7^AOUFaW*Y*THI=N^Ilb;_L1wVD&$nvVfN?Sp1d;{B?d+J
z<hBeU6f=Hdbm{JJ%C&B40_8DC*Xn^ZfJfrnvaA-NOSKxPsT8%q<sU>JqVp!z;jy!5
z-UGzXF=JUWm!hFFNpnwPY6q00Ey>>uZN4sE-g&O#CYF6ttNNBvG0Qn8Ny6a|oZu^W
z2-q(hhg*`_iam#hux9UYxxfznfn}zM%(Kh>X0vC-zr6mFbu5r_wBnzC5jGOVg>a03
z*O*1Wy5jGM=<Du$r!-y`4A`+(F08%cJiDj&ou5@Xg6CUE-AOd7FF51Q;p+l8$;H+H
z?xg($d)7ViQ@519;r94*`5)+P1tTdBB~);?V~ctDW`FV^mxr+PTsg%}CL~~;i(E#b
zr+$@St_MnR?=l6*(l`Faud~a$r@O?)V{OIxt;&`@q$&$6pH&ZpU)jX=cpn-5%)br}
za9;mND9ey`Iw!VNqeI@~*iSq=PaPSc#WZ{F*}@qhsWX_I*D5?}q2a*)OaK~v@Awfm
zKJ15f$jG!@V63zshJS*l<qCIuFjZlE;+bM_w`1-=YW%~{YVD3*AI09IRF$K;q1IY#
zg-yn(!cGHx86r*nokbL{X*9Iv43V;D8@;Gt2F44IhOQUvUDnt$Eob}a17u~-AA|F3
zgBO-fdEaQPtacii$JH>+gbtN(Rry!1|JTRWS8)%J$`#Ru0N0WvF)1j2xD|ue6ViW@
z29yDheM;pS0SCBp1qT5LJl~9o8qg?6l?1AhMix<Z@|%15zIM}YFCr0gg|W$+B=WK6
zZ`!p3jSmV#0Rf^TSqbJaldo_*;GFxZSpe{`4B~)2$ev4nr@Rfl@eRdJjD|!s1?Cis
zL2LXADzuBb;=6v);Cn4CI{#SfO=9wi!Z{TN6#lJFU(IKShvXUcH6yf;rs3rmSS=n8
z`8Kvj@&;DF5nXyKU#4|CML`hwEf3rQ+B(n8SlMk$4B!vZPW91}b|tUkj6NNR>Vh6Q
z;o&z^BR;aY0y=k-ZW&Q@n75*7)Q|RmXyJNdA@S4dqzfCG2}lDcZ-`=bB|nhd%9*uV
z8cBu52;nj)Yq%Z@2DAN|4wv$uA$I(UJ-{LDl((3-lRI(h`{MQ&1ay@Mxt+G+V4D_|
z#xWB6NH(^Qs^NL#lc)4)z=|uy{8qL;v3lBZSozZPgflXlI;$%bu2jB*&TWRIzhSy5
z`MWXci{r<uwej6l8SwSij*Mx~Td$t|6>kcJlsHODV3=m_A2uN((L<y9%|8dUh<8$d
z4nR7q!?*rB^XAIgeROYhYQ|nm>F;SrYtw*0=@1u3p9C=v^Sp@h3&qBNE~>H<7kqMl
zpL+~#|Mv6qK3q=lQvDRsdVoA@Hwo<gi$i3NPgec>NMxPVWj-g|0MJSK52LyoP*n>@
zPRlr1D_AV8t6pImr(aUABK)+VmuYX@o*6_KyHWU=hSE`jz2@e?4uu!(qlt#aRF&e~
z{!!_xn0*wJbK~v=JrCLA{C!oVoy&9qVWQ<In?GM~+pO{uF#tL9`!dL3F<IX80Kk)D
zNm%+7e=<#)^a{Elbwx$l8_FL;dG29VBPQv6#1Y8X_ZlP%B43I)<KmR02$j>`A$0NT
zLea58Ev}m#gK%5R^}gb0*e8M131vB!C@QcV&f~oB0GWzvGR{1_uRCr?wn~Z1JJM)f
z*6|G6Xsj&9aH<vN?>R^S@a&Jw*8Q_Fn(oAfULy`Apj{+AgKIEZQj2N%3CLEi)Mr7r
zW?lN|=d42OvS!7<(biI#&H?&X#nIOCy}I2Tao;fO8hdCCm<Ym12&YjJd(xbh^o)=@
z3V2d?|4#eON%{;+IXdF}t()mFu9qKyNQE%ullA>Q^C(%v^jaWQDoSR6d`}AY7@^a6
zMwONw-1Gc=XYfAnn}Xs*oCVA6iHY~eU22*U(iTLTv@>|@Z-HzR{=?1i{lnba?8rL{
zHirC6I6>s{z@!oaBeK#hUhT?f-1lIoN5ai@Dkxc@E?y0nSg~8YiA~90;fVa8N{4Q3
zDg6syh99t1Tk-DiH&2Xky3maR2w7u6@atGd84E7c;<1Ocl|^&}+^<lNflOpTSSQgi
zn9hb>hD>wA6H+$X_yrt!HxbkED;()LPSQSD|JwApr3ChzuPrhmxM36${rx}Z1qJn`
zv*lRI@urt<{+IYx5K*Nq-qg=-oYiB{AoFAYa%m7SbKaMGM}nI@lS=(ZgUZ*0j`P_+
z@CSIGBrQXLwVjs~bh8VvcVNrhl!haM8@h-a(3|R&yH4_k$awC)hRO-oVsQ%lbJL9>
zU?Wf4@|b(1gdmcg9ldavx}fYABH8N3*4$bGisGA<`;tSV>;nbX6GE-UnO}|)wSD*6
zGTG`ZrhuGX&+idRSc5eS<9|%~-suwBJCT<h(P3&wZQ6CE73gCumzn7CEZc(Ne%AfM
zKBiPnH&7F9a5s%?vRy#G|Dpd+^aUB-IX70|fkhewqrWt^&`P9uoj7^usPCUIt&Rvs
z)=x6Zg(dTP9$<YlCEM<i-hhnO!_Qp4Wx(&SluMBPhf6z%N*{rhw5M)T#qA1d?!qpW
zuH`H-HA}d<C7&Teo`Z^6B-DDE8@|(oYaMHhL6MV9ER(o=;q`o`wt0fGo$bg_et+a6
z0P0=*OSF&@S7<7~-`DoPvE=WWnnGcer^;~bJnK`mWr=;~kki@d1lQ^$1x>;=8+Nr!
zd%%l;qitV5#M-JT2Y%@<IgpdPZe6uUDSfH9da=%c*5TGQ7<<5rTu>29B5@%FRk>LY
zArMB!muzdfXJ|ID%I-(*afZKDY;*4Asm~hwmiqoLekoB9ZD%ofA}7!nwti^xU`e6M
z*hwp$(8r>ku(@Dzp=%ReK%t8Zxy@4}KQ|n~T!1gpK&OHOPHbGSFF-}yXCI+NkZ)@5
zwr~;x%?%1oma~Pt<i0tw6XCzRy!KOtv2x@2sWpA6=R?H<(H482Y<2qZnk1ZW8+$r8
zPqjG*=A(Ba-Och0xWh66j03?Kh8^bDP&!1XU%y=Zw0N9M^Z~FM44g2p=zsX}%!^y8
z@`VGoD#2-$J<`DP=wN636p~W5NvOYOj<2PBVc7TUC{l1fD-m6o9)a>awUNYmUNguU
za?|d-MDmJvymeX=M_a8yX}ReE&v{LRqxEKOYpNq`%x%0f93pKu4?oRe*-*j5QobZq
zz1<lwOD5xb;)j+Rnk0^w%XEr}bB9ejToEL<g@>aIM&$>K_tP#=q1Me2s&AL+4;bHp
z@piG#z0^kN%JHQ;wAT}Dlk}c%tNP3&e=L{PYtj+$ghVEf&kV{Q9sv8MigN`g!*oG4
zI%y#(Gr2Qk9Bj&$am8#lh1PO2jcsz6cqGSiuAsckQ_d)f6IrBbblK!M+VZj{#2;C2
z9ZX|>xT;gf<nmm(i?}R^*q;&`g?xY6p`9Rf{OIPh5_+3l{-rzYcpet7b+qI&rKr_Q
z#1l4YT&l8ODi}XQ(8{X9<~l7tFFk9}yE-tEXwNUADzZ#DJgwxNANv3DNWUV2%JTdD
zqisb72YmlvRfxynaeCrjxS+lc1~%q5O=S7nxTE);QHJJIr?xv4KbkpZh5VVB(pL4l
zPxrOF;oM-r&0R-}j<3FPa)Ia`E^7k}1+z8QhXDXZIXL$BI|)eqqRwW>)bQfCwG|a9
zb7;+RH$ey4rv4J!;uyDgjRL)x828UmGN>tloulh)`>KjBE|JNP*r?%BM#vuoNTjlU
z3b<JD6wmwSUIzQRHh5em<t5Bqp0rFFde?Y6$8kbmS%xFBeGJcuA#Nox|9yb3t!qJw
z$(Pv^k36Wj&^X94Uo=T^qceT1ONRbNUG&XkzBK?CXk85be5(}%{UCjz9my3Jv{?)#
z(VWFfe0Y~H2Sj<M)DqrGDj7WFv!ujpw^|38wLJpY;=G+SWv*P(?B?^k%z)he{$1}K
zIj0#RmCRE^xxKJqcY1AyYEc4`;L%md&Y^-E@yAtx{8CE>yL)Q7vibPf)S&gsB-z@k
zmAUArEw`!q_tYQq^~Q7$KjMgg6_rJ&VkV9K9L|4+>VXe-q;8hEtbd_L%zejoL0N1u
z(zgHSm)`K&-zGFb+v#^)3U5EoN%aHR1wJpWhS&V^(l_5zyt;|Y`zt&5;DF_tbn2AX
z0q{C#^r<o67`&jyP2_`2_3za;(MKO9NAfN#Aj6C;NI!GW-hcG=F+>_C$EArW%@>$Z
z{I^-I!O@BRq?uKrV%qVDyondWjN6%Vq}{n^wVcu`E@yv5r!DOanM0pV?yjUnFVEbA
zBc6K^cWxZ#$Y&=*=r-mM%iWc|o8`oG5nEBSb@;iB+Y*H1m*Xw1<@VaPBB}$EH^yqI
zpJY`+4iz7{ay7VAdi0*<?}1*!b~j{=)b`ggjCswmS&-=nk3_YmJ7}s9x?;w}Am)1*
ztssGT;Bz@4@-iE@{2bIDBycu+xLV>{rOj!ocJ<|b%RU)`yYcY1v=ORd(xz91`{J2T
zuU|v=kNx+mEep9I^HvLOFPy84%Cj+>hDxE+UfAS2??j}BIuXB)!0?Cq?+C6*C+T>i
z_zt2MJWTETwuI3&bK#wpZjRnc+l(`Pp381O`-~h+@_0vbutK=~9O)rxh6`##u|Zrx
zX6A1{^?V)*U2+j^wuVnfbD~@l(F4vg20cA*L<e$xc|`Totmr5fku@75=PIygvuk%}
z;X4IQmpx4L<vH0Uf~|TWv{)~3bsnx~%%0OH8xEY+U>?clCxA%Vf3Nl#K*#^O{fM6N
z@nCs7R1K2>UaIjNvzmkgwIEq>ZD{yA*SP6R*LmI$H}AmxBEDmU(>LIL2K~?m`SB(~
z4{02kO+BS@L^ZwkpNAlzF?bQ;Q)+(3=l;Ht8k(eBBiev+>#&2iJ!ANcc#{1Dpfcve
z2Y+f1NM=Cs{CvEJYy5h|WAsCLkc8l~;pb#AoH-Y(rMN=46bUhS2z~26lrJ#t=fCq%
zfjpxB;Y$6hO<zNzpZQ4h42}!KbCcVpGN_Si)u+|@`Z$EA6J3Vb>!VizkSNWn{_HNP
z*x`cG{)dVzdvmXvGv?OSs*7h8uoJV2Gnqq9B^h6ymC9w$ZcVrWhf4nUQrg7+_1tUz
z_wsOpV=??*imIWjY%6kJSEal@Vd_Cp-JV`tfNq1`1N*74&(dJBb*2~XpmU2vuNuht
zMGb^|8ymxxLWSc4w2DYxWWd}pDns9L6>fseY^?ineips2Orf2ZncGK?wGR%<$@!4U
zHiBF&^C%4Svy&YHZ7MPJ@}50gVw+Kxgm`vm?`3s0d<k6tK>u=r*wslF`=0S*a8Beg
z?b}kPJ0Wb?Q#f`jz$@MV4f#>C$$ATkfYV91F3mM0F~tS%FmjIf&HGYQRMdwbL;G#)
zJ`C^%XmXLKPLhDQQ*gs!DFhFpRA+s47NBw8em;iCj>}fr3A$JZ9+z+%k#0_N<Z}X8
zMgKVSXtA`ln{tC6A34zuP$D8D+BbG`|Kq~_;Sjp`srEkABX2@A!`Gw>JhaCH;GAym
zA=-K2e08LLdalej8322z2b7+^<@1!bJx92(6>nEX^16%DTUzUk@KY8TqDr28lnk3W
zNKf0jl@(B|W_8}lfZuxPfgl8HBC80}(A<!EXyg^^{)4o*zroh224m9+&FIO1%@@E~
z!Zm7E$++_msaJ`YfD9`ky3y$eo>E-qDW%`|LSuxVTR5}=5N#dn16QO=1a53f&WcZ+
zPTH1iiL!M!PE=%6_vjZUm_HJJm<Kjv@-@BBEaiEPp$L%a!>b22uE}P2^19XE@e>P1
z)Us1<ZXDI@*a)-4CYGZdo>^4Rg<r+Rl%8-j;vH>;!@tPp$9<`mpBp<k_X;*a=q@mF
zL%S&S_TRyOwkw6*by~viMJE(GH&>7~PUmu`#5jQttEIv2-6<{K@7g?Q`6gW#Y_*`@
zQt8<)HzNX)73X=i+wb_HrB=V2t=wrHx09yuL2sGm)mNXYsq?9C`6p0h<!3m4+}X!1
zh*5%b<csSu78H6<GWu$C;(c_XF{yx0^PI~LjdOYT&{4v39;h~#(yn^*Yalq{am+~8
zrOOYWH~~&3ph6W#2}&+#K2H7dG~(O`_eK|*>jbf#-E6_p?)-A47y|TDE=y<3?2dXg
zQV1Bz!%`)EC{Q5*)C#upy9As9K7u7DNHbXM#H??zvu21u^(8>7{SjSdFHoj_UZSD@
z<>qbqxRVdVsAa4^#&&+#5u0FlQ^Q*LLg)*%&sQkvDa+5e(?VYLgK`tiBdScN@%(u?
z2XNSeGc>ZN{KkXf$s^Vd-m;5-#x^_Uqu1jfh!M?K{KNTU3trSKxgI@~WW^{xx6$O@
zaRcf2No}D{GHN4x`_i*F2`Ebl#}l{IErP61dw?hR9@!i!XgI~CuqP}Z2Q_D)C9Z7c
zq2zo0iCq2*e?a&wiO~1tJ@vQ!c6Yvfsc7Bjy+L(;ezuHX_JAUG9#7X--t-ZWNCLz3
ziAN^Y&i-;-e|w*17hI=zJxlNXqE3JN8S?GgeV1;d8}jTcqzk=mBk7o^z4NFF-m><N
z*#2zTb!OSfqf{yBxQs0BZpKw@<XC+=Z^i}P(H%M~?l)E!3VKqP{gRt(oQBb*ZNCs2
zmjS}qKhzi4gA)#4o+9{2`|be#&ksQ0a44M?fP0jnTDVQH>u8qXCphLjBgtO`o&Kr6
zgU$UFzQHK|4F8UC7u4+HyC*YTeJsg;;`j%()OGLvZYuObjaaWE01B8+`a6j|(ne#I
zaI@3!-`}uQ;oh0(lI0IV2XnvovV~7<RH|HATpo9tz|w#rEGroneoG1E3gIFGaOdUj
z0dVN1L+$oW<w<UA<p;ttQY6rGG={nP>AmJtEvN+6=T)Ew3$SF@sLl5Y1#`cqoLtVB
z>t}amc+?fdEQs%hzx{rI@(Jgy<7X7L{Mq0RBUIHXH9>>VIEu6FL@kJ43@S)?#~?&T
zUp%?3-8xYy+G>RfKhAvM<&t#oIn&lK`u)B!==)@elnm*MYR}XuMB1_Xw<p9^|CqAV
zcXHRc2XaUE|4MS7NCRx|EZx+s@3<TAsS^RK%{#5RLV@89A$c4=BfPaY+v=MKk|P$u
zzGUAf)-%XiuD=d5LmJCQb<4yYfk%?2EM@E}1`q^|yHe?#n0c2HR}n|Ar`VeRB~`N_
z;td=V0kb1@rAKTxdH0O9#wxovw}z$qdI?!Baw>H?=J{E*ACoW#nl<)zsNcFQtLu{8
z7)mA5O;a3FwtK@wJ1hOp6}rrpLoqR@D?DjD?!vgfiW{RuvS9m3w$zoq3kKa4>Rvy1
z7{#lG4L&_dwj0U%9ur9`MVB9So_)me?lR^tY`8(As%FM6McviMTY+N^0&*Xa+$=tI
z;Sq%V-3z%an>_r7uVFkQ4h%EL6HNc?jBXYV4YMRw8!*qjCn~#3kh1vMwq&SL!hZ7~
zj3}6OT0&M}lXUYhQu#9{Lai0@77mIGPR$;GUACFuj6WnT_^rJC7FY1o1vNRd<VwhR
z={w<0FfBr^`OP{2=%cuBYjSg8)1cV@LxzT{gbZfSnB4yD{v96kw5sTXjo<CZgmL_l
zn+b(=9K}gzJXyo1^c>tN5EP!7H)aGurhd=Nt?d>#?8ZS|I(N<ZJp4EdFw(=Kds|A{
z&;DULC4TdR3xFv2yvi8p1)Pl0qjLP4W4P{pxPkj0hgHw3V7NbzMQVWpBNm~+-jcR!
z*_Ro5S^RIlaY}nX;HYJ=`O%O$W%|d<MquF>r_g*?GRQFZn)K2G-h=FdqqXeO8QAn(
zn5H8oOP+cyt`h?(m&yJuPTcS4E=fPAZ|l1}8kWiIHQ$p+J)6VafEYhfb!}~V8omND
z{7t;wGrv)O3R@aGl%<t=ocEifs=U!9*3(cH&FF00E7_VPMg^7<EIT{4D%J%zk+UWn
zHRs<AJ}YwC<5}Qdv^7iiK{+Gpz>#*KY8XQ%a~_pqv#Sv{WcHCBc%lgM%>r{jx&!i9
zoENQ*uq-i3Q+|Xu6tEQV3*y3m(O(GT?AVv^AQ8sTxtwBQqYZ8@+pg#HS>)xx8TL~5
zoPLRF1sj{6eIMoq2U+(xIvsqjtGe++Mcj;LX}Bq=3WUA{gK<Sn(+7V|_CU2EW;?@f
z`EC?vI6)97nNB+1#n<__(Vo02|4OP^2oIaZAP302$xmun7r3b_%_8w9@EzS9S0j$0
z)XQk#eVJxshBO!)zdHZmu)6Nm9XgsBTidA<OuMFaPwk>OvD9ea(B_bBjFB0#)|dx@
zV<YKDY{CBWHIjy}pJHy^;Zh<5AdR9g{an-jQ@g-kYK2sqJXVd_VaggFG!8dXDYmur
zap^OaQ7p&aEw1vz=Jq=&s{tYD3XSf-eKed-^CL2y-6bP-J5fQi|1pzY{+tOx@FX`2
z851187Hfi2jn#(AgzL}{UiXG?#tPYdD|>-53nFJ`JcCAId#{K?LvA7olXP}^s^t7W
z?@nEGc5Bk^-bVHRzR_Cc_8EKe`B4(dE=C{!0HObeg&{ys&l>ekw<iXv@uXlJa$u=H
z=NzNJ1!o;)tgmBXB{f?^viK78p@-QhHKS2zSe8J!nLBO8sPI42T$0{|vW%y-<H`*j
z-<B=2ql{Zsk_#o9>5TWOm@U@ZP)-P`EF0+TASj9BvSy_*vKLaDQGpo&T}Eb7Q37&3
zr}A%owY%_Kj@PE(gnJ5C;4NBSRnQkNu|%3G*E#EH$FaUsu=Fbce%M8zCi$v6w$ylp
z<l)%$eA>^5NKrdK;?ki1*{)+Lj(6_oYtvdci(|G{$}Zik^>d0iX*=<1<?271r9HSg
zUeAXny*?_t_t`jq`Lx@&%TUL9{FXsC30=A$^tTD`LqB{*>3YA1C$}wLA(ep4Xh=$@
zl;7aE8eW6!z)zYXS6leyar>s0$*TL78Lk2qpp849*)!~+aY=M{kYXZ~+d#VGN(DPF
z!vDVZ&XGP>OWrI<1<f7&5}*dO0bFzXx<6;-At-d4OZ8@HxoW;bt|iJu$RZ2Q4zp*E
z3g$LClV81R*8J6Mo^Z}b?qPs+@TGW;e0=#`-sXZtb4i#F>dcj+o@*`$B;{?$=%<f*
zrIkcVQ{kG2_Dyuq)5Ne~FW#u+<*sXncLW01FGg_0^u9%<bodxmAW2#|Ago~#yZnhI
z()goVLt=98rIfEw%4HLFj!T%NwuIi5`{e-5pH_L;!)^~&%VU+C338Yt1L}RE@|P8y
zKLx5>pW&Q;A%r;QWi3P!bvC{9tvTuh=1AbG3V_E2M(e=ipBC}P{qvyT?hU1KV}KQj
zqHj^EI-%C`vgCiDmx4!ol@w}!vG0y6Y%a;0l`!p69cuv4+cCEu^vSWdfEhUru8Vn@
zKB8tM<Wihalw`MHObc|9_SDR$JR3^pYL^)ktSEP+bRDFYx6O~@*<**)zm1g(`f?&{
z&r=#cEQ%@8z=M*Yy$mzGiH%9f=-4plaDZg{p!}x(+8+|Y+hP%1=oKgurh<qZusO8=
z@p>(~cxJPuA{!9{wLDx5TNe~+eWH6*ON6Rv9CEMdVca7i)8Ab5_BfI4xqtJNiB9qR
zz-iDYM$D5pT$>KHa6x)KL#(ElXKu6dVl#Ds5G(2~!*z5-|3Qkg0-KpI=p=mt%y7Sy
z1iy&T=C(I2$Sf_~K7P+DFJG61i-GDqN^NGBPrebSin-fz{;{4)k01ptJgStBrd;!y
z=7^uF)A}i(f11-im$z;7q`6WRXZJ+%0FETw2Q<WnjJY8l2b{l~^S0IwNI1@*QzG_W
zg^&hAo0!Lgm^BPBh(2K5p(@tBD1{$XV>CQ{nQ^bmV(drI&!+xVF9?uqtgXC^s^PTU
z_RRu`WOQjA&FN!(EL?_1sYv=-C9hAVg75hsOP~9=ekd6-Hk4Atab<a|<l6w9F~|q|
zsGpT*$8DoBu3J+XJU`@aW$2$?pbFGB+PD&2GrGbbrT$T1dG&)yr+P3!@PJ>7mz}#4
z6qgV3R(3v8$>>kTO|)M}soSsg{0t5Nv}ujQdAZ&AkA5}T*kG2+rdQ}y58O3hpj&mj
zTm>4AQ?vbKlO}gAh>J;OyfroSy}z%JA0Aoz?Z^*e^3Bta?Qi9hsn)628TVMUb^eK#
z=QkM;Hhx|FEqh*9^o;FS%y7ophlriiT%q0<wurq0B2SF%){rPSVT`8B_Y!8a>HZ;E
zvPyfBqzFecDCs8Ra!Sz)D}et(NPalELi+RveKc-rk6TbO;NZq1t~spjbnk6ZKkj>W
zt{^J`Vw!H(EOKHQ$*%rmKF%(R`;sRoC__o!`Tk{;3wMAywq@;>#V7J|ZmD?TN`^5m
z|E{<zvX>VE3MhX6{(F-m3o(sm{ip>uLJBWhzr)AsUo42ghktCxJXq@H90v|xlQq=o
z67C-vdvlLt*Qw~5s!RC#r=$Gw4pm&WIrD0ZM`h_)H|6!v=grZbprsyZ=Crm{R_G>@
z=9hVJ*@QN&R3u`%`+azg06;e=`K-<GnA-kJ^Nz^vecmQ{AO7v}S|7Tbl2drn@K6Oi
zd+SCiYu%c_LJ2ek@>{Q2Ln4kY@KVLl|F|6D=zG8f?yA4}tU}dw6*%(C`10A<O)IJT
zC&^NG7F{Jmi^{1daG^=j!S+F4&n{<j^wa>!>pu#gIK~mV@b5;?>o!{+*L!R8T$}T5
zyma8v5W7pvbqxEOm8)8@uUZpQraK>}#}VpZ(SlTBAU9?&_0;A{@tP&K8;c{Tk))Z=
z>LPlM*Ng7U+8OF{nMXd^c;6!)8oMnibDD<ned_W}_AZ=v&#1eCJ~r<<;R`7S$=vXV
z^K)EO$7hN@T(A=ucfai~GW?=>E9@W3aiY-ncWlC;poRE|*0&dlY{eI+uceE3xm+Yt
zE_RHL*<}RM0{q^6_<3~G^NC%cv>{PTlocp+ec#girKRd<$=eIVFXRonBK-weyG8L)
z1@a=WyKcX{3P)pmVbNaYW%MW48b%tv(B5(!gnI3_zTH=a{F|tdwt!zV#GFY8v^!Nz
zOdlPpI7}Ey>11A{_n9(dU@{GAlzBcpg}Z3X_U-TGU;a9f3$`IOU#BMMz@Cb@hV#~Z
zMl2q{dhc}|7jMNLh0NsggIF*95X2+)q2@$d^)gDAKRe^Dz1{y2b{<YmeBa;S5K5?_
zN+)zsdhfj#X`&#~t4MDWYC@3?QAFuQK~PYN_@PJ(9Yl(vf(V3;f<gi)354X~`}+r;
z-I+VHvom*QXYS6q_nh;7y{{P|aX&+t9}4os;1&$?lbu|o{O#pf`XO%^4E3zWViUQR
zg9d?sa>-ls%EoK&^He*2)y;6dh4;HgTJ7LA19CQ<VioiqBCofb`|eKhK<`A0ol~wg
zhCJV_X*(ViPsWRE{OdQz+V{SdU@7GN-P@ZaoXF|^^fr6OfwpzwuaNAGFylc{9XZt2
zaP2a)xA=O=k5hu}8<OjFoV#|z5_R>8s-=IwxQ&%U4<h5W2CIa<ELqMWZSxH!1&<}9
z{Hli4X3@vDtk2|avGzjQBYx%AlL>E!o@+f3-B0hBh<dj$LI`ABONd`9EM&+FJH8*b
zE)^P%#{af)7m4m*HD&g}nk^TG<1Np3m_^du<f!JqRc0FdmRL;kL1>1Xaz`+*N%$AT
zqaSx9)VQq^>YI$twm0iN3g@star_g(-;_P(d~gb`m9?INJByOuZpq9C%7VkppYM4f
zTT7As;weESh|;#bu}*DT8~ic<?vmKB=o9kc)yD_!@z@jnf$^gWx_29l=>jzNug{I<
zz1Fjcj*S*sw;hwkal-8}mc|kHPW0dbHxa3clV0Uwsh>&s-=AyjGHCVEr+7YP?TN@y
zb&AI*TE54lbTe-DUlmpiw<?YlD}Mq@<cQpk^39XCcmYaVXA<zY2Gt;yEYCy*?y9Gy
zz0nT0P2Ib5H%QY1#P=4mg(`n)Boa1iB^Mu&tgW;%+Oqr<zY1v%H}D(8T8ZJ-YTZP_
z5?Ma@g`9ZEx>|7$>HN1dnF81dI4I!rhPMP?Q$Wz#dPKHOtF%XZ=%Rl5Ft{i@Dek7W
zCjHm&OvgyW*4)&O=`G-RYMRStIa$w4f5z4~NPu4^y-no)pHq(UuAQf03zTKAD1g&J
zO18v{<sUCnZTVLm*23PgwSO{tWcL?M-aP04eL%<Gd9kM7lJ2pg3#n6RiYyd4isi=i
z>iv~+eP<-8xmHZ;8aNGgr?BvyA6=MK4vrnV@xu2ri|0UbflczglDJeCdKmNwB2w_*
z1KycHd0*PG5jsip)9D;3`0iORaaC^ZF_W0rIOmv`EcH4Q07l<^#x_gW?><M-OX04O
zOzDA~IxHYO<EIg3ey9IVe-q$<e(<(|_$XfV8XP&kx{_D%MCTIV$9p`*yHSh1KAo;n
zPDsqZ9-b*tDU6Y*z{kpLH4=>%v%4GF)TjK6&~j8NH38HLbjbPSEo<GYDXv<tHPa6C
z<L`udz>!E<W)V+cf-KAgO+M^{;eDz%(@Gy|3(|%$E+67b4S$M@O|T#QuEv`WzfFv(
zvmfTk01rn!bAp|%W0>Mx#{%oVxD4OIkyi>ADGhL3#m)3@Dgeeil7pSgrfu4$gxVyd
zy4)!~)p$AagE(oCBQFes<%5s7QvXuo=aJteRrE*n->i~QMnabu^-aEy5S~)*Pwj9I
zqSk+0oSQ=Hw*;iATOjNckDj}$YU;dhV!r9?adEm#WbvA~nS9>hH?U4H*%t(;Q?C7!
zT<hY<6e{iw7>SJ;@s8@%O`4r_;c2$;J)yL_#3i%oEu=1a)_yrQxK#vGz0ds0TWRAO
z^W>-{w_&x=oYKE+c@`F)bu^*VfC+@iykG0JoP0;0!&8&6P+*$!*Wa=BS;|G^cjYp7
zo@cN4pZFzzmcfvzRNBfu)wFWZDIs-ECqDK=s)D4ka;gSvL|`;oH9bQ;=N&cFAY(y+
zuE1{4;3Zv=c<NVbwe`~*EaV3|T_Jt)7)QZG6jA~7XBRK~rs!|MMums$P!;uBwNE~h
zNuR;wa56E(v+RLAh>lV#*VyOB#^b*<!*ZE;)M$*RkuFH8Imkq=xD1Y9`z}>s=Jw+U
z?S@ys^#I%CBs4t{zSz*agDHi}5EO6748~^TQPS0xiN?fo5B#EV;J-lly9tf%VMq5s
zC4SVNHb*H`%&FgEX_;A>Qmst$+iS0uDx&cx7R1w`YN&xWr&*?$3#251TZw+H@bv@$
zI^S$t>*q;3MazIsqh&@hgG>+?HI?)AC6&P~?Sr@0cUFekWwOx7OD8Pypf$WaSgl#(
zTtJT>lbGmB<iN&0xNVwl63Fn)&SIsIB)*ekN8svr_sJb`HD*4(@g;UdiXhTh_4m$0
zd~cBLZtCXUs?5=&w|x6Pg7omIREid3N|f0t29MzrgU`XG^eL0E`*-bKucc&`k~X=I
zMrdna6Ge8vvs#O~k{{gtG-7GCEp7QojhyhEvO96v*mMTxTGEpEMJdCVfhzoIQzMSs
zTUXfJ$aU4-rVln0H5DuGqdt%dRSnVhJQ@WL7YG;;ong4Il7RgGT3>X&fn?mmZ@k{5
zD_|+duDIJ74cr`LfB61t;+1KIH_A`<HpdgO1-v?C5;cACT?3-OQG69WwauH^I{beR
z`{An3)dqDPC07;lK?Z0wyj=RCYR^HJHY4SSR%tZ);!km!%Ishg@`>7i5A{ul=<L&)
zd95=hs)=S0+L!sqaR|tQtbM)2)l*gbx9Q6i0q>y$1oB`EH)3bvxiYfyG*|@V#DHBb
zi{U^_vlN##oi|7{(_boag~Xxj_qZ6=q6+Q!-<f?~7^DeV|5AHtzGFvG-x4ZyE^^(=
z7Q<Gle?;>V8HP7P)vzSO0T<Oc<1BByGtHoxdaA=BR{tygyu>i`2_yBgdhs*p`4F($
zhJ~}GgNPL@*Lm9X200knv6+AOHX<S7N>5CB)(Vvcz=oG$c$f9NVa0!wle8KtFS1fY
z<rPC!jZsMw;^O1$Wy+fK{&M4c`~e+Q2yBMPgJ)X|qHeEM)!$faNYP6QvOcH@hhU@c
zzfNq@&M)ngVbWt9QWGexH?j>?Ht!*0E8~OfGSm_-mLc@}tOJiz-5>cCOH*hUFI$^(
z?_b+G)*DjsHvoOQzW(J(CKAExzyuBl*KmUX7XXw`NvTOgr!I!#5<k${$$TB$%v(8b
zyP#H{j*nOVxh?hpOwB0c(zbm!gx=^lGK_D2*gpHFukt9hGK!q(qflO3nx9`Z)aqJV
z<GWn0rZ_Mh8JR)Zz^~r*#B4z>xU5U|y~ev(*bq)?F$7Jal(Z0esl)JSR$A3r+Ue63
zht&T`I{F@P*+Ic~g{C(1uvHLZxz<(%QB;iPwx!wL7FNr6sTS_(E%SOP`zlw}d(!&~
zm^)r*GnZu3N4Z>Sn~`-%%d&RDsZBz+m&Z@N%DykqI$P$c_3-jt9ljw{Q68)vd{%{;
z5@6H%4+G0NF`W+*V%^<<ZxEI$tR744TvBI_c(ertCLX7{<g1X^e~+^v1D`+6ij|`F
zb9+Uy(XDb6DOp#%R$||S>Q@fg+I`*LLV%CTqp03%-1Kh3I5oSe5Bgq4rVNiE%}Y}>
z^d(@Nj6jjea1-dr@!_At-GPjwSj+vy=ecNr8JcSQ<`blzPQp-xtobnWwt?-C!V4CM
z+~<^%kU4Woq~s-on;8Hojg3?EA*lce0FXfTB#$n~|4q|*IZf}^$X)<M5#FyPrXP$L
z_(`1;FZ6E2vR>7s3^|KkU$Sp$Ow>$qL0(P-044t$r2jVn01W`}&Ks0_-s7BptS2Wy
zc>VoZOSjK{;r4W7$RxTm1<W>7;U1iK9%?bQy>-Yp0oQ*Uk<>OXbA2{lFlZYWq3t2d
zskk0BdbA!T%lUr~8}2R|ksujeBvP{Ci$goOQ}pil)8$}SIS4-(j8Z+Ns&obyxOF?G
zceg#NHs?HE_}-ff8t$#8G58-+52F1!`RpyDA%ZN2*EsOLiFDQwW#$}@vR2kr#|w1t
zABn|*XGL|cOs&};7~P6+bA|4$K@*EQ!LwrA`hXY*di3i?!Ye~(qr%FJIfe;CIi%ul
z6H6T|v<`Eyo5<7}j13)PdGsA!99Z)g%V45xvs&sCtW`bYE&XU>HBC}hUtq7ZPOtow
z(S~i>ZWqU@?AP*!oSJnw@WJ_0)>a^4aE)Mm-7aJryMcs0+$?H+IFlew{m)O~d`){`
z+9*}|==!@?UO1Cc^4TjgNhu8}nCkEpSgB=+&~i7E;}tg~5U>?==jap`?=E$YknVJP
zQW#MLqR$(Jv)pK{pG|G8Hyb-ngSFwy!b2{OZXp)dS_M+l^~Q78m^?x6mpxsEIaBC-
z6#jjr3m~l=O4^oN2BzE>mKzlDc3%XOZ)11Wbr4x=VnN77%T8Kz%NbvaXHUOoaULt*
zs{}n2XWspGVIo0<;!S=rPd_OVYMlZCJ+zqjFFko+fWOnLzvfn%k>}gw{LMQ*r-@^Y
zrr<vhPBp<s7V91;iXOB6@+n4<Gtx`cyoW+9kL?CUALq6EOj`?=aQ|a4;Pa@Vl&9s&
zgBFHCIjJS5+>~$msh5;&d^Zv>l59+pzdy?cK{Hq2AN7>L2%ml?#$oWFo`h5KUn@Lk
z;6w6#c!|yOsbCd8q27Q<v$Da5<j0pdbcK!2vAn;vDB>a&>`-F)Wj*KCNmu(5tV*C_
zUqRX)+aWmE*iWs-fO8zuJfNQXW3r6D7wQYNB-t1IqyU|GBHjR#GDHkoE{!pObC#$f
zD`<xFK506(gYzbGZt554MtpmolsGXgO(U?*f9!Ya%4Ns?NZ$-T_Yh4_3VBMrg0>-7
z7t*9TKkeI5T@#-#<&p<87@2=EcDVGp_Q+SJy=`%<`&sjA!D;2QiqsswopY-4%8z>e
zuenNBdSEn#^I!9lY{Bk=S3Cva6|C|Uauc(daWr@(;{D4NESU3boTu)`DDUB~KNl1O
zV~2GsBmlLyraI;dwErBKJ8K2Tej&DqByC%jwpUsgWb3MnLGXguV1sR;h_XKNCfYj5
z^j{qqJETIiJ)HUxYxZa2<KG%Gs#t$N5rJT)zwg*ezgpgg%IpA(?*<)GPS3%56YH0L
z@+|1{D{O!~QYUWM*8A*5LzI#UKTKECwN+!L706br*bHVvI-ws1bdfU<a7Zdev*0bq
zaJtUjS-~xjH-l8{PPXHhKT{+bD}I4{<543?ls{_|rZM0|w$rEGY4OU;MO?(@trc%m
zCW{c;TXylE?PrhlIb-7c!!Ew^O0u*x$n_+zXUxMRz%tb4Mo}XpBaw{EZVc2Pb7=&r
zsR9F5sz=bC?%VlXOTA8P$Sgl}$OZt#`pZ;m)H@bRbEY4P_U+<D`&#T!JKI_Fk~heI
zRo;CQHQAs#nj3jmbi19^Wv;vRN!pC7Zv|__J5;~Gn$5(HqTf{Yfa$F*-y^-7@d-&x
zNz|P&XPm<<(d(MOd{A6JONNebgITQR^tgw^X|~#JKUUVu+JKcU2I#|=S#=iacqFx@
zC#$5OgQ3eLxm0Z$PSMFOdu40EVF=t%0z!wT;#6O$MYP-J_-o)<+vKbdNe>`*_~&3b
zLu%Jpz<N5O0!HX~d6i$gvT+*mY8w<u%ReTkrC?cX1zASvpbxbKcw`LETEp0b9Y!TT
zZS=bP=Y@YiKSLjM1^hapjQ^=YKv6}C8w|Q;XOpx8y2%`46qQqh%%2fmdX#)DuR#Aj
zyrR8-3!c`tgZtyHzAJDyYUU39Ok#+t!Og}jame|#$U0a5uld{|1-S8F+*HM-b^Qos
z>w0P_T4dpe&5O4b?>4|m%;LY}NB`c^WLyJ5J^m(<i9lJvkeMR^@kBt_wQlBJJH47v
z;xgn;0r{3->GrrmcuGAD-X||U%8#5G4%;{{0Aw^L>Ylp0)qC-;DccT8<RuWTJ)D`N
z+~J1>;09*5*U)$4tgvCKI<|*<4=uM?B8}56l2!2Av#<5buA1P3r)1gq0K9l_D5MO$
zM5J2^kFO;kQoXIMf8HyT?u|vwdPuPiF=&^h!6D`Cr|m=9%<m`RB!Cqo^S+;Wx9A(~
z0G$QfsFW=@&OE*`jyFbIFI~$DDH0&m9M2h|%2Ubv3!6=H(m4Z~Dd^fU0q=N&{wgY+
z@?Bp;+E6S8N;{v@c{6p3o9|f=hA1KxuIh1N=>^@t!AHvc+kghN@P*gvWedX};n#&4
z<j@SlPOwYz;i~@0A}>5e@K+lS4j6}qHs%380wy<6eZ4F_m)#^!xiaI1=jO6znMys?
zzrIDm?}S6jU#s@HBp=7}STtN6tQPKhj$5P*iHG7hr7T%DO?k;b^}r`3L?=&^;aZn?
zQvCUoF*=ux@UuGISI|bIy($T+cweV_`>REkzN#lSJ|D+vjFi|Ep3Tkj5~@VN+P~G2
z|4~ElSf{RA*18)^Dp_Z+f0wrSccXZ{Q>|Dsmn4kOy^#16lTN|4n7tr}O*zAR+Q>Hq
z!|z)$OLO)Wj!%2)i}9P%Jgos;XY0I-#9Or0rI{?l!$ews|E=-cam6>)NGhl}8nT1O
zhlm`@r%a~xNv<`Sx9jVf$ZIW`68P*Sb*ewyfAzh~n!RJmyEq%=x#48Ad~winHEH1k
z{r-EH2Uu>`V{WLpTJDWw$wQ0G2xg(=EcIo*VPdF`v!}3%8i5bP^-Ics$vjc#${4-U
z$7KW=k9g{d8iyMNr+d6PGwijb%)18=Y*KvWjVmQyemwOF`%E!FC(EX+!>yo8>?&0d
znq``Nu+D2l#v7saSE~I|+PT3OErL2jM(iCYq^|x&SWd64qjXkv<{2fcd`212w_x9g
zHaXKKe*Tv8^-H})hDOS7{mt3iGzrg4WY=$-Z6A4G-*m+F0}6+I*U3sKnSDV)iowFh
zN%l*xLRhT^`49L@=NKQ1RKE6>g^cSaZ#e~39RGF2>4g1G;(@?Vjc~nNgPa+Ao(hO=
zy;UOfmwKNsQinY(hoxO3vroNYuE<RG``&l>o5<@|-69y0E&>s)`c9)YM`UJB!PCcs
zsK+^j1bp%RzWvMW?k13!oZcQ2pzW&%K%e<`wMcQ3tKq=RXN(JR<;?&yWy!N$Jz2l?
zH+g0khfEar-g;${$hsfrL42VX1I_M=ewaFZ<1nHUschk^l4nGAy|@&VQ@6g3DpZ&y
zZAp|W!L!H<pdTK}^Jgcta7Ew;^DDcSi`@tiPF|QI=jMR6?#|jvb_Zltuy~DnrMT4M
zRrBV=xvLzb>ciL{Rn2rz!4qzMhb>qUm8?PP@Liq3GuxaZ$EF80O;^`cDcYONdf|Z0
zjx~DsuIi1k>O<~sEb<Ns+&C{kXkYkI7@+VrQ=w`J!0lJ3!dZ2s`l;<sZDo7eC<~Lr
zaQGH$qGsdpoB0HossROorZ0)(3LD~5H@LYvV1$3zak=*M&iv>~7rrhp{ktN51s&et
zI5GUz&|Zl#P*>=Ii}-T`z#YnxRhlPk{4vE`%cee<h?SP*4d)LOzbW(I!}XipMD?4Y
zrdO6`N8;A@()sPq*Wof`NMWpp`%C@@9b7Z}KB*I6$2QLiYeGr@*T4VLQ)?j}zd5|y
zg|rVzeU6PXkb-l3Q%cnJ&vwHS_{DIlW{WGKsw*VATc*r^R{}2H($K_P|MMmNWc(pW
zm6@WoE%2yq<m)^c7L$o@$|RFdydLffmYFA-U1$VQrJt3sCXqTeTEa2pu{qXr>4ya>
z={)rF2)MPZsKIi`>o9)OLEUGiHrC^fMjl~QvPeOj^al^Yw(81(-<3t$G}fj*#@8^Z
zckjP-X5#rFEP?ntCDhQ`6vR!=VN)v7%-|-rEFKZm-GO5ro+?3}>q`o2qqcZUic|T&
z`YId~n;%l{v^#Q8TNWN7R@Hco+A}=ws1nl}17DStqA0moRZ6}@{0b)h8i%f=3{-zz
z+XKnAY7o1(AD!pEqW4VBzf)=k7sSskr81oIB3K2Mv-k$jhc$z;igapdAloSesTliO
z`}DBYjumlWf?pz&kH<WQCT*_fxBL`6?~0b$k7QMzt0vKu*uFd=){^@z)MxYwA0k|W
zT@>WE(e%?dcb@&g1@m8R7d-l*L=08-y&2ZcBVKC+JGCiR<`Pxl5-8%c4u#nK<P!ZO
z?QzYPH@R{^YEDOx;UF2lll@@7Fh;-iiGg}f_WkXVSSrM3$k`&S&md{E%HZOJ=CqEO
ziFvzu=bf)KABQeX@4t;0nYaxN2WvIx*fP!ZjXT|GCzubg8#Sg&fkAbwR=)~*wy*yF
zaK3J{jQ;mx7W<#S_4hiye~&jK3oYyq#TpE56SPZ^{S@J#$F%uO$8k(vDt$Ka<xqYx
z=To~Bj}&t9n0Ba9NcHoE{r7*D!hQ}xjK!(XI388&$-{e8aL`QT(fqZ$<6p1csw9p-
zVtFi2(-5SBt$?mfR;Z`MJ5Ebt7G9pW`}1#3|M=5BaO_oX5&K~IiBi-?9p|X_M?3tY
z_D$87K8N$f#E<mV8t45=EEjJwLc~^um%bEpn{)KvB4EzfyeHQAHa|{@=q5+UFC9o6
z2eY}}`@>6``fRE+`<z<RH=4-XlMOoHvg5wZNAHo{U*39FgA&xRU%!`DX8iOn(z0Hx
z4B&KN{U}l7)30>V_iHyDTad@MrSFUN+1eV+eo<eR+)qYjplppbT(2cR<sUdHTk8Kq
z?Xd=Fye0x4c=TzL7>lK)$dkAxRYNg0`S|=D(~{hB7UrC>^QJ3D<<?rmjgR-5sxd>H
z)&a3(xB^>RASDN<(YKe56O5GaHF`2k4R)?83GRH0Btx0%)6$Y&NkP)Zc#7arjK+++
zr1pwHJf+x3tinJ!A}^P9!gn6c$WyhrdBAv{aXujj6_f&xGOO6))M;<Wp%T$qu9PE;
z@nndn!ei}+9TFM7o(p(XJOnQ%m>5Qg*1t%KbRN4Mv#Kde?loF}@my#BL=%>Jrv0ym
zNy60YCyv{)Bv;S!ng{e)8gRlK1^${#{C<^&%|cOo{=(bVYy^)qWGx@?SQlZ#4VqWb
zrAYsN8f~v{$M~eoegnj=b$Ct+pg-V-_9JNERv~60w+<gDW9N={e!C?S@3^qeP-;nX
zo4#Mh;3Ahh5Ie7_JfNB36oc~@qV|7*u`go>MWvWcx1g&Pf7+qR#XPXhH-D;sX2ULO
zHhPhV%A1xg2=btVn;u#2aYjFv^Fauyc?zoL?lG(#w!Y%_{&)54=*3P&ru*9D&gQa5
z%ih&o;Yz<4h<5Cy%O3RR@JEPz;8_H?FPc6n<dX<73-MFMo%%`PkJZAzC$K7~fRPB(
zLHA>lt740|U=dwH%saiNFu`%`9}qtE^$5hk+ou_FGkZ@-`5SK^HD+6_r4xA;?#qkb
zmwhR5qx=133{}Q_hPg0RR{?DQ1z*}(Gg;>`KeD`C1|{#N7<?fM4dv!vU2UbAcC)3`
zt-AB%0-nyfd2B&0p3D*l^~ECw#umAs^Xq!Qy&hMHAh6Lz>8!VmpfCK3ThtohNfNlK
z4Px~Kx#dxZRMn2&7?GOB>GU+J1Qn#h!SyDBW+$m+lkDkxXRH;0|3hH?PyZ^O_VpA6
z?N4rJ^6x~<_1JSs1nZyTQ?*P9ourgu)plww!(?~BILs|9X=`0~xi#1Ua_f6L=s>j6
z>>5dsc~k4Ub%_Ah^|gUwOTarYIeJ3x&pi2Zy?za6;XNCeA5oq{q7#Z*G6xw%?A%aX
zB8XIXa5D0BHfuA40`aAwZg-ir*M2c(`lI<4j4oVfT0q&@KiaqdfM|UmbZABedZ)i4
zjyOOKGST-84<t&ZAsdA~6J&;4oOBs}={f7aV_*%eqezNbkWIl?aQ~$NJmR6|pMxa%
zW3ExE>OV(P!v0<?kO7(vSoPLV6n1+^9vOBCap3$lU#8dWHCsJBoD7JPi`@>7NW7cd
zSg-9(L9UkkLLfKf_Va{&KsNLqx5fRim6z=+0ZE0ukgb!#M8x#fW5i~7cS_X_pM(>P
znTRv>%aNn6wn{4}FT11aXPe1KTD~f_=?TA$x#0p~Bt<aK4UzIh-bav^?dM0PN$!WQ
z1p!)$d!E-KeU4u2u0Id{sI;JLCvEV_A<nqSePU@qKjVR(XviIM0+}+>FDO6uFY)fN
z_B45)JQj#E_PYeMr#yuHXM^Y;18DPJ6`f8{d@KEt%!si6rGu^N1k8>=&_)%K_v11U
zA-(@sT}Ih|ELD|EhN@<#B=W(qwM3^QA%OGl{3e1tUeeqX#tn;(6E+DQKPOS+ZzMSj
z{!n~5!?ZGEA>^_D=|FzM-gwk^#_SQzymJ^C@;s_*`M2Xe9IcAn=^R9I^S6}7)bn@@
z1~Q)XC0i{l5!NpiDjh5w5b-l%d6f@QKio&)i#!Q}76>|m6~C|e`)`txffe$%@^nxd
zPJGxxl%$(B@u21uEw<M#!-a7?jHBVeMU;`x5=yms5dECbLCi09a3J8<{-eJc&c&x`
zJ7U)0^8a>Ugb`WKJAa+Y@{DCXaMnOvCW^7a5v^yXjqGh+!%4R=Btgc1`p^)k)s|n&
zysujSj!^jOU`{8W^j3WfGohDhBDa+3y@7sqT*^B1wd*Rch#=!`x@V-iV~D|k+J5cZ
zN8e5b4r20<3L9;!_*ROa#zgQQ?%(HQG6@N!8exxz?@kR?1*1s+ivKfREk~TA$qA=_
z2JS#o5M5T*y4ADA$;A5erZZ(_i&rOf(8=w!YM~NvMId{^5jXXI=fLb!{C8_>PA(P8
z9U8Y^ov35H6&go<Ku<3wu_<T3k3iM$P`OmZIg-a;wO}&IBJVFwPtT2#tPtc*aw8~(
z@#Hm^$-l3cyRecYu%B1LzDS*rbs3YySJN}b)0fd*yYjYyJ=mW)--GEp$Q3sSr`PRL
zpy@?4Al4dTp~3g1@_D_%G(wN&VTw5>=t%BLd9_&eEW{}Ft$rrV{!MlhytnmoON${F
zoQ?>}I>UQ-gq&%fk%v_p)~o;6$R~pTN&&Z@HO(=*VM*1vR%$m4WM)i*`YDiJ-0Mfc
zU^c|Y(&-z|`+6f4NXD&UhVj;`9Uq3=S9i~MlTp7c$cMY;&#B)h*Ch=^_VV#Rw#g>r
zf84oG?M55;=DHZ5ru_7dIH1@Z{2<;Gr}vtbMhD(8ao+z)(`Mn`B<mez#O??1Au*wo
zIJdG8c32bhc<KyM@rrfU4Eo{XGlCd=#b?^Z+0<IKO6Ths<4yMuwPKy*3(RnWuqglT
ze_k(R-;i2o&k%>j7w(*`TtgncB5J&V(AQ3Phh&-(mfVywGd^26p2lZr1+{3A&r;vk
zNlDT${t)L)aCi0VspkWSYv1n?Q0G$)N$gJ!^?pD9+OdT=b;z+ChojCgf3Y83Ga<Kg
z($M(D%v=}DpDW2WWgfHk{=u<d%n~AyoVTpmu7Y3Hu<f3}o?ce%O7RbqEpwkrk;w<{
z-go+YPw{Jycuty?5NqW8aWYBaMTSA{>mlW6N{ejOFptFK68Ry~^2JT{5_%ozI-2iS
zqB3!z0`v!vU17SWzu5<RVb)Z?UB#BARB0r#>Z&;#n*m39&~lYh13P8cOQc)YuoWg#
zhT>2^g}`4j`J)4ftn6$E_48n((Y6#-biFE(Jj8aoGq|X)qPXVJvL<$-`sC_W{2-Y#
zi_%%eBD+7j3<{t1i5#bdYD=N6b~l&kc>EaFeC1bbQJfl=#zztR{_?<|V?z>E6Vgty
zrA45VkAf3!owlsa7>^vS*SUCXKPhMv?iF5J0z|{WM32?nY^y<W3f0%-SR^as4d}1j
z0|br<phODz4QiK|XOf#4sJ^2x!YV@9gPHN`uAd$nD~Qr_PAViW!>|>gZ_DWK#mv6i
z)G|#zoBe=Ufik&(0!x*reo_;{v6*~j<y+eMLQQyQ5Q2%Yns&Z8e9#%A`&E}d@bSSU
zp`UD`g>p3>$dp?b{0T*HW)*jtph*Mv^0(JAr$)oGGw#U;=mQM@P((TFL{1x85Y11h
z9_S2HqqpE0P9f!Vl7M*2`?g(=pAQE#08B#>0q@^B9O+_#1mWo~ES6^Ef1mQUubl40
zS;ro}enltL1{tP?8Hm0}Z4QVtP8!S@h8s04$k2Xs?^Dxp&Z$E$T*XQlo1xW`Q3}(<
zfqD>|`|$DJc1K8%VE@1u%Kl!hvnUrtIQ9<ZA!v7VixNb7?Ybde&f_`3mDmeJwcHMg
z)$TP*fwhq@4Ed}EaPk(z6DfIk@yvc!tl_6$rqq9-i4s6@V&$LpbtPm4&`-EtfAkTl
zGUf7I>i&jd2_?qqgh`t|c<#B?3~{K_VGOqWlAVi^vd5QtBz5Ay!a*YvcK9rr`usPO
z8~WNvkm6Ixj=zHZqz}}qifp~T5DZ=qeo8~mb{jKg7MXt67ONt&d_+mLv1X&<pj2KN
zL8cryVMZ5p%WE<`j(>38#)6^z!JiZU)!M&>g5lWhj(2x3Q3$sG>-U2cB|FYZ(x9Eh
zov;}aM3|79f#;aHPstIA%47#J)Es8ci3~}O*c36jBh|w+vwru1k`HiymY#hVaLi1f
zy^38cNgUGkJ=$zODt0isi_blcNSUk>BkwTvCo5{D5?e56nDrhcwH$=!W*U%)nl!jR
z=VcP@8+3LNfDjuIw4ut%Lefj#*bqzG@BGPJ<kJwtQxQfk$SP#DHul$7RvTWga$|o^
zK`C(E{Yq9=9#eV0S2b>DVD>2gR-g@vq?Y;AnNBY<mH6R#ZbX$2+mHquVOiz6IH<9|
zsJ%P8QLVEg^p!(Z{O_@k$t<b;ylKz#+|-?@-ugwsX)Q{G<OXK50L3{$!}*=7HTt7^
zS{EeQTp)wuCttXbSg$KZ;2c*XvjTr5iMar)`YV_wpW=!=2%zW5EUbPQ4XC0$vlK34
zHj9!|g&gjOU`hJ-{|<z)R~~_@Dqj{q1VtxgZ)m8khG|e5CCiWOEykg}kl}al51|sG
z4sj3f)V;{OgZZt5T=>qMNS4Fc^1O&&nh%AK(ROk5-+0IOx08Y3K;jzG@hon(i;so;
z6AWCa+rtW0j<?gNFVng#BS<A3Y<oDj@a7h<lbrv0C?vs1kn^RsR%S2#*`8e03;Ne7
zVKjK5RGV)7=>^D*<{BqGATuU@YYd65-~~Jrwma)-<3ytI6u|Z_mh~c@VWyR%G9FCd
z1VEyNcxI~$KI|Vx2I}hnug(Y1*Y!JW3WchCj|qL`q!=#+iyN0U7#>lN8zA?B_mdnY
z?cRBu^q;S`5#2Fb<$p9)D=K@=G-jfP;}3)XRnZuH+=c7te!6^#izju%gEj~IvwT$J
zNppWOV;Yr$ni^-9_j|sBf{5wQP`S$8xT^4fNMI+bAh{}5eiu9ZBO$pJ>M^^keW*0O
zeVqAd`<MX4LDi4rXo^1`3*7j4T;-uxp-nPd?LWSRV-W=Gj)4Tvzk{FVXJ^+c4rv;y
zYmR3)Ih2p`Li-vz1iBJzLuNm%cN5;b@k{8XeVW_)oZkC?p9yG(Hr`fgxJTWuZ|z>O
z@pZtboWDG$6o!4P97DxT^(p4ogTG$J%o@FT{#$z$Ot{`%9bhi0wm-|$pV~cTzt|(H
z)oW<~v?{HC_)wGcncZ&_7H6h)?wee4H$4X9>z}{)nk2wm5yh`VV=%L;sj&)ys-I)z
zkGf}}<>k-Tqw#M1+OvSBD{*-S85ITB;X9<S9o)h4U4Un|kHNEBaqhPA$5r}qiNh1x
zXz&D7Wab#Ob%atsu5zl`3J$|eEo*4SMrz2$n%SoE&7^cFz3S?~J#hvE20ECEHRg6T
z@Bm<yXHbre=a|lSnB5RVW$s~InpvLa*B&O8pvmI01GL}dED+qPODizW(P=VUe4NM7
z?e6yVUy%tj)rCJ6#{K^mVSAZnuMNY<|No1qHspjTehh&d_u@&`nA7Pl5;JZaSE)Kj
zo*D+rG;2+d&ycc}O9VWQLwcH79`A=XwWQyF5~L=j#no@+JByL9J&ySA2HJV6<3CrE
z%W`!heqF#dVI{WiPXtgdD*E=|U^ad2)YwB?2mAS+n)Z`UoXV5N{oI4|f!qVaT@uTY
zLeAx}$beDXX6~fEbh}|Sv5TYozZO(u<6e_9F6dfz!q<wvv4te!;^w|bs+PH0Vc_DZ
zRljh^#rN!;6_U;N+o(IXypvPrRrfYX?mER=#~x+gQUw1m@f(Sqnk+TxGJwPO+QCN|
z3@TwdL<ZZ!3pO%K#uPh^`8Rm;V;*;*Seh+cwvG{ulesM&OMwJU#rf$w;hh|tMqP<l
z<W&Hc1={tOO}sR|?#Y}xzn9y%+f>;-$k^+P2}Ab1r(#b9psdZ^iblB7?+*d4xeCu3
z$3ky|B12f0;DQt0QeWT5K7c!4fMj8mKR%m$?k6pjughc6GkWXGTBmv>@ycv*-*3VT
z2F98398{$p2eo&`bQuU=27I9e12Ow+1?renk#70vCl_Bo5}2NfFk*|JvhqA!yTju8
zHbB}GZ&f{K#DkF8^{QvHZ==9(PgVcZ;@vthwV13{nfxK>nONkr%gdf{EFLEyBBy#h
zKgfqpS;^Vn{HJ*2W0A+1%1@iZ^x*z$vV=npAt1jcRa!l5IP|Svp^8YlCcf(KBsEp}
zV}AE*BCN@wcegQGz3*CtpLZu*rxaE^zGwWfn2Oha!*I=5dw7ro9P35YW$pBkNp!z|
z8^1p6y2_i2x8W?Z|2HGQf0ALVm;RID1`B?d<yGN+`c~sL9=_$RD?;8qAGjDMVX;F#
zkHee8nrMtX9z=PpDsr3*C7OvJ^Ia7&_EN$TS9SaMy1QlMpN7ij47;Z8Z+1NV%nhRo
zk8aQ}xnDgL`*JSoe0sWs+2_=WqeT9SxMb$TZ(N)k@zeq)CKrI&Aovo`nOY9Kiv1Ad
zZr^pPOD>C`++|`$u;fkOx58Vtt<#U?PwqdKtTA4@*hi%>b@#|GW0Pg|hxGNmKQKG9
zy*<_EX<F-f<tX&ynnbh3_JXP}$8qTK(TDEE$>p^)eu&bzQAt_W)32m^-$Kn>G6-5G
zDu?;V^NI4}NZsk_tHUS~^GqNxw{CfDJJ9;41$^p82JQ7rw?9CNUOK#U0Y%NYjy&8@
zylCCfkoNgQ{yM19z|6fOLD}7(W^zq*e=2kjf1zoy&A^g}n1TVFNZ`Q6Iz*1}^6mWi
zzw#Q%Inp~GAI+U%9x~_SI?c(*Mf-Md3su=LQJouw*a}jrK3_%=+lcpue5T5dm$cA^
z%E<13S~FW?Og?Y4oLv5XaX(uR{#)C2N5<`B3rRa~*oIg+xK)X)7t5<!)23Y>DR!D*
zOznR632I$iaIIXrF0T~mwUrcP|5aH%`ItMXY~|WI-^+5JDEXlt{>X@>(~(I3#{nj5
z^(FV{WzlFam+*U&fxt%yBj|LBUq%gVlU^aAKFp=6U)ahPRyM50`}inSWnfU{RDNhK
zfzh+i+pemZBtsOLEZ%67nj1(~b4gb;o;F}#`x!EsEiLk;i!~@!l2}0%*Y&|@sD~OG
z#6z{0zx<X~-A&fm{r2{fn#$P7zr#TUAG0~w^OnzGyfkggBURzr_-YxAhqc^Ok(mQ(
zcNNnHagixZ94KzUfAQMJn;LOp^I)1A&xTr*$g}|u-h?E4ej<?`n_o8b41`uKX>j$(
z=i=o_#@omb^c5YtN~jBp)O6n4YUd?h7YFkfn?d9sDZqus&=j$Rz>nF_qnt&k7%+np
z#iyfq@w-GzDtmoE7x#7ush3l3qn-b|0|%;<=q6`+%V)2O<W5N+7b->GEZ1At-GNYP
zLhiBR^M3S!x~ka5Qo=vYycMt!xtjlmYqDiPU&KaNM7x)OzjqSYG9&>_AUO{v8CX{y
zdAsi@YU|pQLbWyc0Ex|Be+qr6F(#yuA>v~4n-lS7ZS^y1!SNTJ+dcb_VNgcraJ;Q#
zu#Tah0L9HYm1$loOu*LCHECPv=vmJss+}cAcUf)O>BSHw;P&W&@fsDoi-&}=r2_7L
zj-V&rby{05tH|sIYknZ_@OO9_NHqJM&odN31RX@C`poJlZSPhVF6U&3<Bm|k@ktah
z>k$xBle8uELI#hj<szf7m3=bGtz+G7-7C=PB_V`NO2)R5(JO4_s}~J{kv5+j7id2!
z$OD15er!$R_}#nJmk>vr&!dXV`HP9kUbi3oVmG?aYjR^<HcCQalTnxTK*)>nC^8bB
zOI*F%@Ae<zck=T2`sx*f6hz-5kE>Jy89MTmyDLwDrtHYoS90hm&~l)c4<rM^EXSSC
zjxLUy2{9?SCEz_qcNkHRT$$;}5NwEtbogU3{~{%>$x$acXh#`e@sPkS>!C))_f5dR
zIZTwxmRE<oP3Bx^%AKSW`1lM6&j^)McoN|{WCTcUqW~y+2zO29Pojjy8xdHCtL>C*
z<gsb#v8x9s_CfVB)=E9~dulWv8gSN%9km4OYq;@L{R#N`Ir5ho&EC$Iw~e(9Acwc5
z4zik47-|_xQWNq?Wo39n(L(txdybD04IG{dgvoHqX;Ky|pA-8;^GEKi^7fZN&oi0#
zuDoz%cnB*a3{zGt#%Qr+Da)~xX{=99UdMJyRLK<{<{nN>P8MtvzkV@`zrP>{%lY?E
zyoUP9!FCdvFhDF+tt1NVyxjY*$`cvzn<neh#*+1T$RksXwpA(1nTwt@T@sZ$KEV}i
z3X^~E0%Vr`omlCHv-|LIIea4TRaWe@V2c03q^FT8IdMD3a2O`7*sFzF5G|?R-jY_m
zQVcURzLj{=9ybj?NXhVQO)!I+EHYCz5~FK&v5y8n_1wgl70o_-XOfW;@vJ%mH?3cJ
z14MKxIA?D?S}mn9b9FKw0;>^4x)W>)=umGw4nB#|OQ;&uQ^8V`e){j5Dkfs}Wwj*)
z0nzW7K02QCqqxE0gZ-R2TA`Gr1_YY};BluM-c&whmg*t><0tIvVc7?^a9iFX2Jtn9
zH%W=7BncAUQk&s-V0}E9(dtC`{3wFYN1a+X6i>Q$xV_V@(Fwm%tjOMW@%@q9R*4ac
z%ApcX9dOvKw;Y~f6MQzEo-{|V+y7gsfEycD_yjWSj{mJ}eDEFhJuW(sdA8tqkb35m
zkFO5Sc~0ovTp<rAY{lH!DN~b5zgH=1*yHhshB3Eb8r}%^Psf{6gg`L^LPQ0EsyAb{
zDE+xg?3AbEHFV|zr{P3zBlF+M&CcE!pj*_w;b)8(){Ki%3mHvW18|UpYimFsrvOlR
z#AR(<xYj9zN?njnjU=oqcTuF9Ezum@IG(9p@n}nKzfh^VqgzDK&RO0ylzwE0hCg$k
zhx$0>vOhGj$S6~L<=<mQ7%FRO(i%Gwxl2irZ--BGjG_N-X2?i1RoB$nX`h-BM2`E{
zToTb$q@E736m&HKMS`p%5l>Y_Xp)7yhy$y!Ra#pI{VrDh%$tIszTYthsFdN2mlhdy
zD?r7!bWpn-ha&ZD>P6ZP&Yaa`9z&T;NqZ|fcH5jys4jX8RGW6{KAz^4@Cuxk(sXP(
zch5w;t0^ec!RVP@Awpv#wePfqr^~hm^)39ekZuQQ<C_}KfF_D?1E%lz=-T$Y9-L8T
zFi)u<t=8W1rJ4Y`(4M{BA?9kZAGsR<<Q*xbpEZXduS?Qwypx<;=wgF`f$^-#>5ix(
zo~>EMXGlF6kd<5)I+@T_IjN1??Edd|guLzaSS0b*>yOM_rfb`A1bGvz-jXA77d7X1
z3+*2(d})YrvE+GO=)8}*rC6>8!)Z~GRrhUxZMae`oqm5&Po;hI8g$Z;u3uP_i;?=<
zeO@C9aahm&mIrrt|IJy*FKnvGFz7ljR?m^-%FQJ%#ki8!nG*W<Q-7z9vcdOQtJS0)
z14F7zWiKf}*y`3_9IZUuHwI{}zTJQ5mHr-5>+YHe+@dR7=h<S=prniz5JBgnFZW(d
z-=rx#@Kv|eDEmQqWU+KjYF_H3PZH&G;>oOeSz;jU2A}Oh6odh`(M@~?QV*{I>$^j0
zkE@W&@Me9lG!QaC^u<?Vva(daz60nDRR<Ndni|0`I+5-0F;qpj8~(9n)!^N$X11EU
z8FueVs4+bb6d=zLSa#Nsc9CDbtjMYBV@RaEU<_jFZco;R2s3qO@4w<=p*SP4ZCqI~
zho=D(@cl>2<OgrN)GnLJ2MRf@%%2c=%LYoYQ-#y!34`dr4&=kJagktN?;1r4VEE{V
zFn3IBem^2T<W7$OQfTXXgBLn&<AkZ^${zQd4JM?nqWPCW6AZ(%Uoqgd4rXf*AsB3!
zn*hQ$#z*nT>&4NSZAkXvJVwI5Kw~JfHmHHOvqKtzH4p7KJAT|nV6S@uOxiqW6q-$H
zc;ThY$|<7jcBZ~?8dCG+;zCS3V(`8tZr;@z-~T%<_ULb5gj+4Yf(@ombg|bz*)Hv;
z!LJt@nrOSgft>!YfpF31Z#5h6mg`%36gkQT3Mt9%ZiJ3kw(r-a(MC+KSANBb2B$iW
z|B$?3aYi$+-3^7#vtbILJ|q4+PYP(Evy(!NU@c<rVAk@l?%JVCM&aaq#zDiIK8@WO
zGPh0D^6sS}u|Lv!Clx$9l(<)Jp_p}@;3Qxre-|9JR?9d%1P7@PDFec(i1bGNf1aLr
zyTRm>m10y)WLePlaTD~^P&jmY;_hO%@))qDoUCQvR$KRykCetRm|M+>{1ZAx^<}+&
zfGFlN%fUnC7LhDq#U2fMLwTZ>rv2q5k9#ou+Czl}+TSc&>!6t-s&&mvfTW8K(NFQ^
z+fe-$@lEd=@mr-2Jbw}2NeESs-Z1__bB&uFPI3-{#05L(y})P1a8kc@T-lz#rKAj8
zTB4LyS$xlS8VO)f%q<aQhrAhB>zT@;)3P75*Eoe5*^&EIn7ecdqFy`73$(aHW#jdK
z5M<c2e}yNVuBDN9#w~*XMbu5U;M^%?^@E_!)c!C5587ac389SJPtbtwM1Y(F1u@w|
zUfj`d7AeZBdYvfb{5@&z8t?Yh&hcoh_!HFloJ4Q;qb(RwM1U$nen*4XQka^qhVY3f
zQgjjmxfdH=(57dIHCr@Dw_fdc&w~rf(e6z=P~<J=ge*SWQZ`qUNA4M!&EqQaai<o5
zlbU~9Ul^srCowc5!}by0^oa47hXKv}n4_ew3rJA4;1$z;>QxYMGnKmla6La2!}lge
z)(EWMe`sW4xYh}+iN3GZqwB_Nweg>)S8kd7wKCphO|*et{6{Br2m?Et;gkXIvkLu0
zk<iP`uQ}2@AU73Qf2Z}7x*5Fvl19c@2@K=hs!IfTdE+;6YY8XR`svwyJ=}J2vgF4C
z>UWbZ9Gbi3i@{iN`lFdgz@O}mm&dR&kMw7C%tf3A89mC4$00?thuXt3ySyx^Gi;Tp
zf>9FdLz6|Ox}{#dIlU1t0pR;;hQSrH0~7ZB$Ijjy)oh+2^%d(W+&nLd9aqBE=|NAU
zxzWJEPy&X7KRf*Jxq1p}NMWx(rbIds=6ur%-^2ryqjRpUwBbvc|6vefz%4&_iIQkE
zQklZu(VXA4qVtj#($xczSR+-vOw_GTwV-4ZT!tGK<q5K@&gT^&us03VZ|ViVm{4$}
z>p`TS`s6=we5r17nNnAtU|6ZoQ`-JMjz+`ShF>P;di-ob%-#N4oU<EfBw3rEmg0Ip
z+ml9X%IZJ&`|md8Mr{llKK7-+g@20-qSBRB$MmCr_5^6g@JEhQyr7dqJ>1shrWI6$
z@N^8}&M9wPfv^WK&|ITMGZWPUaSrJq3yvm)IBQ!FW^^lqKtUB58@3$!LS$2~+kZB3
zDaN((?bXvLnlAONR`pNq$Nuy#5|mxK1*wG)+2S(KiIItAe;c;{@}i?Q^}{^%b+vf-
zN|>P0bF{UFtkqjj*i%4~gGXav+YB$tV?PrFt!=ViHSv~E%2W!a^tNY78cv;}&U=?7
z0<~R1p&n<jUuYL$3>%8($U;3#(ym~$qhk2C_O6zCswwN;@PD3@h~BcZjo0D<oSuHU
zr6~T-Vfo4j%hr99*I|=9!e%9~jbNHd``s{4tDFjbQ!w?I@V{Q0zw*0|Rb8ST`e<hX
zGVGBvmeG#Iti&1LRpHr4#ruU2mmzXBCz-9iR(htJ(fUP%#*3oqpu)g;gQVZNupxG^
z;+FR#yQt^mDNe2>CR2y;2VbQ&{0y!x#v2AFR*0$mdtDlr=)1w#{jRxNQjrog@Sd0Y
zuK!kJoC1u=m)+<UuDqJ4_1^5?)I$M-^euSrlJCHJBQNDl>`i|%IlCSArOcYPRkusH
z!J@g@t@2_b-)Va*Y*2cafy1jy-|w+UQp^$V@xuC5hm!QRB`cgF<s2Uz{#tHGAdFYw
zBQ-jNf?I%mkT1b6f`k8*<uh>Sp}KZSFoD3aDNmdfS!&i~Eqh&hi*vA*Q(hT2_796$
zngi)X;&*mCibd~P-Zs{itLvbEuDq9HOE{t)6qx;zye0d6FoZd=-%o(OO|XFL$|t&B
zdw&LZN8ir<`_@P2?K&h`v@=mCLzfwfH;oEf$ukS`1=t->FeggzC9;PPi8M9XMB^<+
z-6OycYU%q~KRm1fcn<EqDsy$0=b`zksqtKoB|q@Epfl^hd5_S%O1GhHD%BO5Ob6{X
zo6OqXyA&T737fyvOZ7+oyKU;5@@Xm<yx$Y$RU(bNitP>Q`lj8}UiUd?><3cT?#%kR
zq>Qk2<E$HV_D1!9Pio1}&?Q&yT9z98cW5;5GlpZXcr((#5W%d%s7Gd!1PI^;4Qx?^
zPK``?s)oU-;NL%whLI7+pF@T#!)zWXd42u*_vT;Qiw>Nysm~aI8qPlZocrrR!N5=F
z)*R1h9dof~cy`aelmaPI0;$#Es;F*ZS^>^n@y{Vq2%--Y<-K?{k{wxL-qG(UcYe1C
zt43Y-{u2gAx;0-t{^ts2F<hsbL~a@#f8gf%{!%mpDK5D71{2Ps?X#&<v1W8gl3!M?
zrhNG2PCUCiLGr30Md8NLtG3ythV2S%bX)C0_bskje5nC&SMV|8=`CiuVxoZlZq|p8
z#v0y7W(Lp=UkF7jR4|9)$#~H1)CopQ)wxAuMuM+7db0sabsEM631wcZZB~VoN6pZu
z&%Kn{v}U5^*m$S*C0ywDQDygN20eR?*4}C1SKOIL^MIc;AZYGA*3T^;Ua@W{<q2)|
zgtF+fRXIxN(b{i{G?;s7joBRNkERLo=R~DD3!1C^TM5sH%D3vT|5wEB>n;sUgWki+
zlmkzoQ`3>*7B!oUiiG=CJ9?26&t#(FU~3(h@)(u(j27=xx+xb+3D=&!?_FlKf1%@@
zbMORjcyOq8E8sA-z;%-~bi<nnZd~t^xC`<+of19RMK|v`U6u*v7M;e!!KkaB5#QJ~
zF4$mdb3m46-|h3)^qd~Q%k|#uXN$RiC+ksnC$;L~lh=0bX~}AU-WvVE1g6qb^;mss
z8PLOYGRX@F(`&OOgnFh~kci83Vs+;@g-WNqC;pyE9Zu@0Om+8Gqa>_`P@N3a*YZJw
zF6JpCv~<|LC1@eqyFu&HFn(4V!~e9yV-2aFP&=h@Mbpm~2r|{dRL3p{sU*5*$h@>U
z0Usl>+OT^v1;TWQ`<+=-pz;4M?f&*ao^Qx69*=mCR~e{~u?tK5&S>o|PNJA|*0tHv
z*acfkcb9o}@(fLe#h-<qj*m`3wig3bwrboEf?s8-$Hj;#{I;Sw)vZH)#lz4h&+jLK
zZw^{HyOXJt=w9uCG0V>LI4Cwhu*bwge`(53*1!WbZt$s`X2Hrl)9mNvdA4ius6}3m
zL3kp$JCSv-#-DA0Ht59y6ExM5a+vqZ7hCLV`j{%@N$bb#0peG6fF2D^l{CsFYk~xX
z`E_N}N`<NgZz5<vG<Be7SQu5DD0)NJo~2Q&WeN}9h-d}Ct(qrIyxIt?2OoR<oZu_|
z1)+uvx}JKdg;&B_0a^jcdUvOv?l@PTje3VcEv8i$-~A>HDP3<$q4We^;>Wr1#fD<8
z0^;tyrVpEL;L^rdOg4;FJPg+cTRsK|ty{0((N7^xM>lIgjJmZ&wU?M6SsOw~(N`qV
zH1cJU#a;SQOUVD@=&S;o`u_&J(KWhjH2&yrHjq+D1pyIBK~SWXaIn!KCEWv25K%%=
zL2@+Gjnp=}gaIN0#`g05FSd)_?BaaS&N<(Gp66jBV=Y&6EnW!M$5o%VemVZ_%dz`#
zBhA9^=3J(VirYx3!*2<mp0Ob#Ue;%#w-Z|poh6`Z$fUII1@XATUuG&%69ONYPVJop
zflBdIt&++vI*vHfxVs&c5<;uv_bJ*W{i8BQz#V0paG4m*jlA39w|jb%#o6T^_-10~
zT32wfiRE0rJ_S*?n!t=Hpe}E{*X>2XixV{+*{r!bm6=06>lJ)2oepIBQEu}P%0l;&
zukQhAe45VcmiExjN<f?dw-<k}^#tH&lkK##LC`xNSgnW_7%%+k<37H0VJbD29IFkq
z85WXI>?9-6SZ+3g8W7Owy7dNj{bxtIfOyI*P)g)Z+a2K4u{{k{=B?H*`Y~77=6g=c
zuk5bpisot4dlvJhMebE-s#3z``k+7p^B5=PSr=C^P3Ns!6fOWhJ;e-V_)@u)LKj${
zPzdanMIY=m3KMd8si9c9DHxLhB5u#Qv}4V{#Bylko+Iu-zaGFB!US}m0n)QSe}=t&
z)X{F-Y<!zw-AOuPjio$Q+#F(B%5l2%60)a0?*ElYUM4|y+(k`Z*ec9Kt49d=?@Oj|
z?eAYg#X{f_4{q(NzO_6Rc$4AAoeOfhAa?*z8<RE|m6KQgYJKz9Vd3wjgUi@3zc5B@
zUhHZ322yLiUQJnh)x;7?QBl*#wG(x&PJ@G2gfr4(>fV*fyZ9UXFw#h_bxCK&bc`*_
zs~);((cJ*J&s{~34oMXW`eHi4<z&omC)XuB_2Gzd5aWdf>0F{I6)?ACo6CH)wAQwC
zYm7@|n;%P2L1j>%nW013-5@DKC8P<U?pb?poccwZxsYJ<mNp>IH!q7XNlzk{eD&0u
zA`VPVa0Z+6%i$>jX>KLruJ81ja{XKWgo>5C1Oev#VWMF(x41JDBnY0OM;X$e0c@C<
z^gPCTz-b%PK=vQoiY-4Lk}RbS9Xst&Fi&&<id^0kW1wf61%ddoj=E)owhP)Nvt7RM
zrQz-B?AWS&e6<r!Li=1HqIZs%dS2{kHhf=pa<r~U-Y76nbG#J}xkEHW2>e&(yFGX}
zmH`O#oB4Jy76$3Sj`GC-(D10|SyRknvgILKE2p?$0njX#xED|o(SRuN*6^b~u9f3u
zPCb)e)!jcd*a#W^_p^R*8#kpN^KjC}o->w>Q=V|E08!})y81j#e*flk*}uDthgBlY
z+6AvtX_up-@b2~lM)lf~PW-pm2+Y4TZE07}71vB~Mj-v4gmyEb!zB_$fgYI_=$8c#
z3@VI8Ea-uN69MrC_sRrSM&(@lCf{C=5<XHVJY8q=O=UJW(DI3_;+Y1$LazSVe219?
z6e}L1=uO9Vw|_Y=12;1x_e)r!OP@F4^gPy2de3sH0QC7VTUA~c9})7cBYrgm`IMzR
zA^!z*OkF~HEJ^jR-s>#dpyt4kuvd}cx$iB{2454uf@Pad6?F<`E#w6Z0UDD*>m<V4
z<~yDj)t97yaJ)bHJEx30Yt2-Y2U_<Z5-$nD<NAD*_J$=1&BC62P02l>Z(!c#vHY>D
z%vM$B4W&fid!pvo%@Z``M26mP93fY6s3@HeM^|*u`9li)>NnY_cbxU`8OcW>@M89z
zgtL$D@HaeJ*3j3&t#n!noBA;M*}2rM80~!~8d`7Cif@`CjHO%3vprYlJ+|OOSHp)I
z&F>uagq%3L9?$JpWPzdt+rqCEb+P+&8gy22azD?|MVBcXp8>R4iG$oYVe;qjE8LYx
zJS7)5Gt0+UWC@RZD5ZwYOnQ1E>HUyX(_P6}pQ7%-2eqv9cqnXw$4!wxr=hzk#xKC$
z(3b9ojCb;=k~)#D?uZ2MAW`@+;awtj1%!ZcH6arLpO=sXD$R{!LmG8~>Xx3{iEK&&
zo|SJY^5XZxlbE%elU%qpMN3`$AL=xUDSWqQJ^~cQIGnE=d4ZO&h=;Xb7}-DOqdB^K
z_N5J*Zmkeoh+?ARh5q45Z#sJ<GWPuGfM{X}3CsH1xTn=lXV&3P|7FJ^2b+3YK5ir)
zOQrb?Yd-cG+e}W*82t1uu!O{w<P`HsgkA{bQNAb*hiHpvS|+gnYXr(JR4ozfLNnLi
zzGM$J?PXha!?QxczH2I`>McFAVy9#7Na%@wUS1<k561ooU|g5G=1~GZgUC1f;y1+1
zbp&c~X*@=`S~q@D;eBl>F{fL&pBt^>^4r(-t6Nd8emzr*n!QSVU1m2fiqga|MfeXo
z(GaP_6w#ESnh(tqF6b1EZb(G=AuY1#ShXgIh2h>r&ZSg0X@bf4UgJl?P*q)qo_n`s
zPf{$|_UEACmEQs+<jefL&%b-!?B3#1oW$~9IUa=~tG8k-`~<lnEEr0`M~#xY7%H`n
ztw#r3Ux}IHPv7%_Fn;fTn2vK0;RN9!J(?2Bs`9uF9kd<t8b}WSKhZ&0v=K?j<L@n>
z)vrg9{7BfmIse16ctebqriKq?cnY{U*6+$HoGAo={7#dVbFxJf?ZZ4*Vi!xz^RAPx
zQ0ENS&n(7{7xxO@2fQ*wOH7d_X^Yf7=$C)Bk?s(;xfyoVm<!&}9|pr;cT%H8NNiV5
zfICOeO@_V2sdN4EO^NjT{c&eEgoNJU)DokmMI~P27fh>GVZv^OTKZI=x8i&zmV%NL
zpE}2c3~{GU<mH_&%$1MOYC&SW*OR7BOd3w)xP%46gcRQxh#jNzSBRv2RO;TQwGxue
z&7x9K(waM~I_38C7*B$CcH;p4Z{shA$D#PdC2c8#FYn-j0y)CJ@96|TI~pn+LdJcL
zrya-@V<bDu62izAC^3?qvk9CQq^My)8z%jAZqyH!2pahZ`l!(RW0Mh#c3T7y+9t_Q
zjaNW3=FZ>m`a<7m+^ZM-SX%o==2qubb=3}T6Tmg6e%}&9u72Tn*#GRrpX)~JjdUcg
z3Ml_+_IIZXj*Pke1^ORGcLJ^=sSF+W{vm{K2V?&9l{5YN0qm&JxcBr$XXMcdpA)_H
z6z|rXDAHO%&@N=p#=YWXC@HJ7^#vP2yGwqu-$~Cm{4bf`R{$9x5<SgdQ$y#&t8zfX
zk*;rYv9Tk-O%+I>Q7FUJ?Z0ieOc3)URV&noU(_(rKTIe#Pb>v(|Hkf)W@|8Z4JLvU
zulD+&63zORYWD-`l|rWcm^2lGI!4Iu+`w9jfejkF4<&+kK#a-fh9(HY65V8=UQTT{
zk$U=RDQNgfMbHveZAOqNlgJWSPVBTbaw{)&UqS3Ibm@Yi{+1jNbN?O0A?)OY<^6Zq
zNySx%IFwMc%3~mYi0E4RQphj*X@@6vaSgks8D}!kWVj6M0LR|+VLWwI1+|t&hAPXQ
zGbN<9kAt_r@1{e4Z=5Ln_yFB!lC-IR*6YIAa9j5!m|(x~XxO~93Ns<lA?QwmZ>7Wl
z!{RAo0PZWFzgheai|Jc^uy7LK$laYrHBe$p8uRtNT&QCv@d$^48Wbck)F8IUqNiJ=
zD7Aw38JJC95gm*nAr1G&O?`M_>kNs{kJ2^n=Yy8=*E1?_@N{&Hg>qA@$9MLc%8+df
z6`f>A4Ejf^H$Cs794XsXtf;I9C$EDOR-383Dn3B{%E$L;;>yekOLnW;?<U6t0krux
z!_*&m4d`;)6fOhykgO7S>kQDPI?~6Uj83=nnXFizzL6n;oAm5)q9ZkJuRftMvF2Z&
ztZ7s|djXG*%8>|3rJ=cJdOk4c*ToTC`c3?2hQOc|q6J8%#mtF}|Elh+B%Dy48Y$Q-
zW!!z_uRsmB7Y%4;+&iS92ATJ$o&A7^gq)s0wy;0iBp;u(NVe@?faB4Z=)=gXw0_#=
zytb2$llBl&D(ag0%?QxQ(&j=<WqRmkZE`;<<0A~49f*JjSa0L4H7F2@)m<svdsXLP
z(UW$*z-r_*wC4Cfbgg*tRl!zNDc-1s_Z2pDCUcnh#qOc5F!)$(KX;GA<_#jG&a(d~
z{4T~ZOZmLB`u*S7hrMD)Z5$%-)C4biBA$AwC&AqC@Y7@B`PKO70DB16EB^4XLL~eA
z5H&c2y4AnqTg?f{nQ8TzBB>oS_bJr1mg)l-zeuO5*~+J2)l|ot%;TL+t22Os%K0Uq
zy`ME>iwc_$A9xqHSLSb#?b-IVJs`is{w2YI?yq2dc!g*T)8Z|YxwtzMOVtXqwjyBx
zlDl6OkNsOY&jAIwYnK=m_924NZYx>m`{Z2b%+6k<jM1m5Er-=X_9PJ{<Gx)~!<q+y
z)E{g5<UgH={#QQ&tny++Xbd8*uC82PCDXq%lm8gK`mTJtWO6kx^;+-@&@X@eX7Tx%
zU+j3#5th8WW#U+#>-@SGk}Irs_3A25VZJhC-6M4H7|WyKO!F|JnOmK!SYszo(^yUR
z)#C|I*cgdVdAAG`<Q_>yyrJ7e9}<90=`Ve#;YqO@tV40}HMg(%!}J;W+sn5;AV0q8
z<wNqTzDn@>8(&qXK3hnC5LU=`UW<4vf>E9a^mkx~%#+^<M3A#K|AFYznQ-w&Y*POa
zpQge|t|+vWU66D|Ow>5YFTzuD93;g4p`z094s66*Y9~g6Q00(&k)BU~qFZx7o)wmZ
zNg!h((&u3rc}aQ<XPrvvTXs95zTTIQk$O=F=$8@%g<{T*zV0t=J0~jw;kT<Pww8Qd
zl!}^ZAe1?qOIb!}<rcAn1%Ux#E6oV$L7hKC%#8c)$-_S>gsHW-O{T$)caTq|7uFuj
zBITNZtfl_cSko8QP@V68&?AvQ;0iy@3D-l!ia#7WPR(96zpm%c)iPSn<Mnrjhg3ZZ
z=Q(VJQhj2)iuCHTY54Y&ER{@mC%rB1H1Tu1wdz_HO0~=)kr;$a3g<!(=O3D!Jt+;-
z`pdm4w%+ydu$Y*Rzp_0|EOf`cqX?+lC84(!Vxpn|jt@y1bW%-pqew!?A0Xg%xH8BI
zkTl0fa(xb$h&XqAR%@NBS_e@SW+ElDo3Yb&6Da&vUK;HUE{iheWg^bs=V#W^P~U1V
z8tL|v>U*kc4n%bZelPtb#31_nnXrOY+C>pBLMQI_07bP&9>K>)S{Hv)PGjF(2bdr6
z*dYDO&@s-R?HeShb~>E^MbtQZfeHN=dLEN$M8^(-MtpMn_2gG1bKip5`@~f?qG^Bc
ze-x78z1ny`9erCar;fO7D2tFwI#t}M*ZmIFu8CYTQQ!FWS77Or8r(nTW|7}V6S<`i
z_BNP!3+Yj6s-_S4($$|0U6l}74-_|8To~Ut3=5_U#ol|8h9_HTe&6^TkNa;%iIIIb
zzg~~F{y~<!b-z(>DGeDn)yD;gn3_Qu>VSu%51b#UIHNg2Q90kPG?Mn2pvCcM>@5aa
zb>X9;>3<FL+y(nrCs*Idcp_kO9TuAI@Hp1!F-w9r0uiPnFO*UrYLJFs5n6;^75kki
z=17&NlP)t~Vf<bhSMzivcvD`I<iuaz?sk3_Qm@{tX{f26I(rS~Oy%FPh#+FRmZu`O
z`V*lHXr3F-J6eT&^z)Z*QeF8x3lz!Q`Qy(U?z9tFfIFlOGfV(re(UvHr>0WQ{JVf(
zWtn_f7Md}%8{OLHsh;*@sJgG;-fAgv)5p6H82aCLU6&Upa`8pm!hD76%En7n6VJy&
z1vlt##x#~n-tO93#V`DMuObuIK1&&78bLO*E!FjCoAI08OnW^+$i`pzE?$C!y-s<L
z2BJ551_w8_iR?Ll3rLI4p<sfx_;Bj=g)oc*e-#F5+wNO5_<pq;P{Nn-3Q6}e_un4N
zxBPvYFq>TXx$=88>XYxAIOv1Apn0q=RQp&p;EKKU{I&CYNoQ2NNTd@`XzbnhV>c6=
z%?5JxtIp`&2>vrGH{CbkO$cdhRo{u`XW}ZTyeTAP&7B+gvspxWxruY;S)n?q7LMOZ
zYMFYXXU)04_Pn93S|dZNN)|>u&bd{hCY!`^G(qmGO<<`DReRUycnLiwMc0BnG>c<w
zbIVfkraM*=cndXlDCD{aB1wm$VNnPcOrsNJxu<CdUeh!)iLot%jYH^gxSJktDYCqv
zl_JVfGmRD$@&hlxT|@dx6US|3bzVINC;sW0V25!;<g0*7EH&DSlrq3U?U(H;JDI0t
zG)CjnDa-LfPpv2%J!yKYdDSn{5tmr}%;Cm=F%|OT;6#eWZr24j#ztBPpBO^xNq~y&
z$&MxrkXyGGa(3ZpIrd9D;Uo}84w?(B`}aBU#HV;gC4bfJNVrr$pD;Iy$D@n#I;o#5
zuN>}qY>_tIZs{lFrNpKj=nL*IV1UCxGZ*`QXfxfPD?b=y(a`s%j5GGgDS@0c(pOTD
zc`1!KDFA-(U!=|#@yj!!+PT_{d52si2})D~TF#8TKg@h-nRN0`i;3IT8{u1;uqJ`>
zbFsq(5wba3hj)%h<m3Mo$#S;+TS#@V0lM#J`1U!XGQI3m%V3^3$vKFXY!+PunHX3m
zVS7nJ=@M_^qelA}u!555{?;(X^Y}}9i)f4CjW?u2=++BG9q>_T?N)^Pnct9nUjV02
zT|1#F**%n^bmZUl@X-$ZUxCBE_CrX#b<0)$m37DE{od2#7RQzzOIg)L4I;eb?80~9
z(BNzmIw)0lX>isXG#rXcD6o46R;gm85t7h-zo+}H{fDdaQYq1EvqK@W4AWc@Rd0Dd
zZJaf-0+)BRLy0bba9bB9uInNhBcsoop2|s{vh>s?s_|s@BD(_W5uu?Rp*5XU)LAM+
zgDH8@d{ZgbIk<LLu}+cCo2uU~+nRJDzrsWgPjq1L(yyc5q}1r=U%zpaDdBQ0xKvl=
zNRq4E-X%s`iJ-cBEV@_co?lqU)$Jeqo}zcYzH2#yw5KILK1{vBL}JaIqmcJNHY>z%
zp2UFFr^eD$;G^c$JAj-YCVQ)IGZdeS@S%rX+G3EvqV~GWvjG;Hv2^nw-Vr466beQs
zo{rL8d}lww<<g+fG4J8a#>79nh?+@u@b!hG)t0U0fpsE_`qbKIQfebF85M!4b=y2s
z(fa#b|Jk{`+bMT0TRgR2ck4=Jr4w~`FjaTTMNInTE8?{~zmBPYha^;<eeat{zk@CV
zC%;O<gl{NUY7PB8)<%UVfgLSInNiHx{LIJS^}uP7H6@8LuHlc+(}5jV#-WJ~U(%VJ
z%S=~8=cT8(fcJ#W284RF`ey!4*3h@ov^5I;{2+RT+_Kz)oq8W;jTu<=XFRmunINU6
zm}N9VA>&IdP_X>1%QjCPj>lRH$4}7uAX`(o=G+PeYN?51+vNoEk^G#x|HUpjCrc1f
z?G58<Zs5cFK1@GX&5li>wz+A7sqf^^X#U2A292EPzWm9B2DV#YS^uM+Am<A~cMv~z
zx8#Oq-G-;ent^#c^$aKr0)3s!p2EWgE!Pr$z~7&t>-@pvHCr}uCB!D!mHL&L*vEvW
z%bqNd+}PHK-Z4U}4~x&sRgVK9-iT&5NUPYS4K3Uht$(HKv-o(?{ot=eT?@&U+V|qm
zRgc@pm>B33zu!@uFuW7}`3m-yHJT1s6Ma<gJ`1tFL6mM~IruF7@A@tc0kj)TfW@O5
zm3;1)!{r-Cq3}B0vQ1Mue8cavE3cO&Rafw>Kk_q55TgX4c^Y&7DHU5Y%Q>7rOIBXJ
z;(Szorg3WF8&L)m$&}%Xjv2z8=2bFg>M8WMebQAw;zx1Zy%}31fq_|r%x0^IaYiU=
zxq8p?TAQp35n?mocL<xnCT409mMjI7PV1QIeUSAriOGja;Ty4=j9(Ze;E1ujtWr{-
zjEWdU>_4oi_B$!(@S>|oGT@q3PUFUXzrQ*F8v6ZQgiRHCgadsl99;7cUPMJ!)x~24
zEfu#9^LSm)JRsyA*2>!GvUBX;J3)Nba0iUb0}C|oV-PCxDA=&J3QeCT<L56tUQog!
z#SUH?Tj_HF%(Y&VtBX!DZ<r_>v*DV2vD-uWC;mTRn|vx2PoPI0z2V0-^tt92EYr;T
z?r9=D_N`&7%Ih0Z=ICgu&8h&tL=-jX2?Nco4W`}kqeD_tUkArXw#(wlON9fUB>Oa)
zL!-mjYhrTNtdI`M3_<lV@CMQ@3ZjTw$xzoSQzZ%&V7|hcm21g$+nMrE+H19kiCM`f
zeffT0W`)C74axpXrjQ}6_II$cr7Di&m~8i$d4Bby%Ryz232b;4ImF2y8r|JirnX^(
zAYv&%I3ExerK@UtCpia1@>ld08MNdX)gr<8J95j3bKUGUZZ`njtFGosyuKayn~QgZ
zxTyW{d$t}152Jy6W3T^B$>WxMs8q-futs<^^AlX-1UP>7whseTDEqM>XE+BO*M>In
z3U#EzA4?KgEgAcJmsVfNKw`*opZXTKyOk856f;wrBve;1p|%Jt!}>0K7MB_N6_rgL
zyh?f!LAcxb_CAtz?cO8(2_Qf%jg~q8Z9tzfedl$#<N3(<{#S(7W}e<Ba`nGdq0u~E
z23POaXYyDsmpAvuZ=<L@@);%l41zg=toFj!b88HdxJRL>R+bq{cLgkvEMX$1vo@`_
zJrz~9Dc7W_jmnC(sj)6KrZPlCgZg^VqtRBwNv)?nNpvnTp6f5L?l)~AbZ@fe9U8{7
zQ&^d=db)$BuFVudcp;zecSb$7BF$o+{s8(_D5b3t_nqr?4rBgvvGj&;YnKW@)y49x
zsa4<jJAnF)Y0~E^mQ*;&hbCHh<^jF8SjW}p=jRF2j~obm3>3`jfX=C=+wLNYvZ{NS
zZoR7^FL<x-rF(+})i{Ckm(EJS*p0_(O-TBUWfj8dg@@AO$=uYBXEZ~DUdcYxnE2>>
zg_v6AjC<P#0PQxj&3^>0&@hS*rkCJ=|EOz46r3Y%G8<NJuu#zbZL7Wxq`Q8AU-NI1
zV8CNw*xKqRmO?{Yn>3A%*Qt#2WG;m&)?ZUtDX|(0t4clKAysCT_D5JgHq?1*kRa<1
zo3Y>bka>m3q=Vt+XkYNxe4+pPdOOd5S6f#|MM~#MZ#&U?Z@G-eWW<=5C0u_?T1t`?
zm);0xa}GfGvWY3+8u#l3QmM*)6uSD48|NMXdtW8YP3a`0uKGcKQm56Dbm5RJq<%8}
z#SP*c02By!qlmU3gYv2enTCE$$2q6q3_E{ujiXZ(4E!ryXrQD&@yGkrmfZq??g)Dz
z8?x7fgpl(yOz2SJQ0#@igQL5qapK{Me~3c9v;ry!;hLw3-`e%Tp}VnY3~Smu*Bam3
z_aPBLI7UGgOc84q&#{?OLaUX^-nOlx3Xk*h6c}b0wRbVW?6P65oR6g1o1W?bmnH27
zbcC}XLC;W;_lzmz?fCgab6u00n5hX|3ni2i3=xZN83VFy&c=0^AAEoc1YkdHOg>f$
z0Vt$lM0_sg>E8b&PZ46E3(1P!?u6(ZinTB?I={FYy6WbryEq#ONI1i#V9#ho0rcCy
zm?@e1O_s&z>nNraEtx{H;?_)vPu37ePxHTC!$GOPD_#G#G@#s9FRb)-o7^1g2<jRx
z_W8E)6_gQH{>1CL_?rak9t-;EkP6o)$XFb~pU=90m#Y>m4|1Mb_1voCKZJc9YB$q9
zXqLn0r)Un{2{n(E&MZk)I#Q|L$hGjJc_4B!AakFTSO?Rc9~U|Kg{Lxco+X9oed--0
z?=LL)%PG5SB{%!59l7cb#WGIM)dd{gL0{<KPqxT084AJ0a~2*Sg8U@w=9ym(v>bA+
zxN`ru9BV^q3|*ur)?rD?N8Y3p)?x{bc;J8iH2rvdufroZ<xqO4RaLZ787-PZF;Mz%
zRC;iK(at=0*8v}J^O_vp#&OVzr5Q3o9PftQmPY|H(h(UB#soG{-{ot6rAVLa|0ojE
z^PU#o2(mR2-*OYaMSt+VNJp7t1i9<H1^{mREz&em6*CU;St^hna@9TYhBhN9_<=?L
zew>bL&DIu0)FBvN{4pktQ+1m@Pnyyuk!mh4b;d}}6ntsnT1w#zzgZU84;4@cD5^8d
zRW}#1(fnud9*(}lE#A<iSi|+a_oPeoS06u{-9r?>IF>qneL6YrM;t8jC$50ZR9FCE
zLJoA4?9<1<u2e@d%5a>mPr4Sk2MquHL-?Cr0pj})&x3DvWP#9M@lOgHsVZDMl~ZC-
z-6+3y8s%tuG6x_}{z^0=9?;xH>DrXL*PB3)cNz8iaZ_(;E#f7ADIA+Wu5BG!*{+B_
z-T=*^B%ed@KeL&Ygg|8-r}@@hU$R|_GC&F6e-#Fd+qib%;$l;~4kTO<Du%K@<Os^H
zYRk7z7)Ws%zILsX_3oR;5X6ak>8NDK@?2J|m%#UVhO#gq{p>t%R*{N00B|`(woH#Q
zi!Tfu-3~o?ln@(QP~6<3Bupw|5NX=M7m|Z|P(pQ{mH6g~4donMwlQt<RjQyrq4+d4
zghboVA4(Nmv6dGqj5qyge<kWTsq|W1ZQ$b`%!GmKSsn$g`9Mc1jy`geF{br|l;TDn
z;Z=bg761l1C6Z2lFi;1{C<$o-Ma5!r_Z_KTeb~HlW_$6|HGA(mDe+fN=xq*{3oB>*
z9fy-Yx~bHCiPAgrV`Xl7fMUcA@fNdSsszDb&29c7Tt@L;^aMpV34rUFrXjiDL&UWl
z5gG+>38<NBe`E=db+u5XBd>H<3E7lUxW{J!#89kaGhX4?0c0=lkX;*~x7_-IYC52s
zDlbCZx$o$eUt3}*l*#Y<1T98&8GawTk4$Ce-FsQEcD#6yjHd`uNlg^)@V=w~tWD}-
zJ_RUdfB?Xp*rrF3?%ykm)k8>sepc-}F%7&Ce)Y)tjN8aJQS`JiZg?#&My{jT9qhOm
z+^T)6m(K*ULAC(&fAm}kSEirsDCEI)9UO*){;@+*0^G|QS`>PqaV}bo%%IaVQ4;;b
zjv{{CQYooRwSs;F(7*T*O0vV3@<csr3M~V{?22lUs7MGk`8Y=mFVB5I?r4c7>DmtS
z3+N^6q)~XQm3S0A_$=$QJX8hVu@`szG2aFi{l$S|awNW-;19<8>8H_1nv)#8PB8I`
zeg;FBXoZb`<CQKxj@rAnb$ti@1THI^7^UuasEh;Q)u)~J-uYr-;_0abe+F_u@N;~S
zngusc=+oB(b>R!t@479s(34u;?zCzTz#UsgnhbAyBT`Z$^WrbV36O#hvwU*<X4VxT
z;%LhEypr~z<;-4E{<_xkvX9j3T~cHu%}rlghi3Q*oNe&_$dCfmZt#00q&cWarda$y
z-EL@Tqgt3YB)iwY`0ING2gIT!ioLulTY(FI<0y*xu1XnAO$Zy?Ii)$L9~n2>oXUF2
zv$KhGzwUMg2#BJL>!leTgW))b!9e@BLXBDEdFyYi)Nchomb;zvHOmk30A}E5pH<Ml
z3Q`)A9DEHpePUpOvHw$l>ss&WkD-7KS|@afMruEfs!kUAcq{Rw3?B&r)iW7)XTBsC
z?)4Yq5VBQcVW1=B_6BA{L7V?n)5s%kEAB;uQYu}`_?2QJ$Th>+73)Fn2Zre5dqOTA
z;+U?OA7zp);sT<RJr9B4(~#b~C=unD8@~I@>u84l*LgC{?>hn9<;zEaj=an`TAZ$E
zPN;F0OmG2*BVBpr3(KCP`nzxIw20<>1fv3XSLtA-<4t!M%UTb5JWYgOJKa+|xgG>C
z0RVmCEgtd*b3xUSIxN_o9ZY=@!u+C(K)O=&8_AzyjF?a$p6_`+ZGbv*K9;+$wMn}s
zjN!f9`VgUAM@slC<Uv7hQ803})#D@S<zb;Am>c`ee+>VyjIG$q#es&CtIn3}_MHw%
zj#LTE2Wn*)yFD{rYn(T8vOSAn^4y9qo+h05mvX(0Nc*R_62<)V%Vo1gf}`z3OQKRa
zzf3VTu9w<}-Rm);6u=pEAJBaiVlOU=A*Gd1OzKnRH5DXK@IHs-QpBrE*>MyL@oW|i
zMuw+QIdL2GUmJNviiZIGMsm(f<2eWbf0rS%q;-an3YCV?)6RghQ2H(aDeWWK&lO1k
ze%`KpSTsGF>-y<DD$=TkedLIf%r*Y4F69kf`Q9}bg<t_nj-fH@jF>g&%k=oD&8BDZ
z1zO()uUU`e=n<>8cna+RxU9OKX0yWNBP3S)F1P*>$}V1eS>VOCy#z+Wx8nboElOg~
z&56E#@{DM9(PXM{tFiAkKeh11s`|?zsV@eDDWrC(b2mfHSStK02BERvy0=heH|hQv
zbZ-JrZw+^naM#^eZtcxxP#Tx>R(02f%9V3oGLo|{_u7Y!%hlFK>#H?=%n&sYHp4_g
zLS>Pi$F3}1V&zy(T7Jo33KeESaI{vvjh*|_`C|hIOcp;mMJFOZ;4>d4!E>K17@v<r
zc2<ChQP=0oZh??`PMx#vbF<LvLo6=vA15FAFRRuM#@F6Q`Qj|raq(V9O&Lp)J%p!p
zs(gq7qHsux-=uuHxdAo}XpZD~r`LY|;w-F|R-y)wl9Sd3<F+1^ic*76|D|dkHV6pr
zKnYYcqp?3FSd69an0k}Z@I$!>=AOW8Cw`;1{61yfP8X-A0ek07pZLf#^t|XiMur9n
zhVZ~=#PFr@D_m)4ux8MZ!J0(Ou}7uO|JN8T)#z3O3wUCOdY_^xG9ld^D>agl*PM8+
z(!CY1sB{fjX5dRS(DBsx1#=$5XA;xSEdyS188eXoB!I3T)W|1I<VdLBNL~?&ob>B{
z!$K&YEXud)9%^OX9&3ntPOQV-7PjA;@Di}lnZSK*yX7jIfC9&#Izszt9&M*_SKQMm
zV@*l80>7LXlVtRwSi2|BPdblOYUg;DjiAIX)YKn$i*!i5>rlb*(df<emErbTVW7zH
zSdidFhd<A3-Qe}_;s&xlEL7yg2YaL<^FraV9IIB2zBcHCVb9F5qA0jqbYn9i4qr_G
zD+}rILl8%23(r;vgs&82E0Ln|vtQ0W8#w+n&TW=|psAyfF*C^Xky9(y0+JEX(xLXg
z<yovx8Z~IFIZo5PJm2YR*9IB~`;D|0FN>LgF%h8&%sIBu{`gca7Batz+Uu&pWU3&j
zjl3_49Xk>foXjanQJ}n|F_=_rJ8i=-xadlsTD~{UH=cQ<<&LNUyt2fZyY_YW`%ev1
zhp&DTaAX#+imw+^0ztTcq{TT<vPBH`4RoxE0m$|#TfV2AMLulUi(PZs>6GLle_xfB
zm)Q7^&14}k58Il2N63Nuw}P*i>hX&%e6>j;x6Tp4tePWgPk2F|MGp1+*W_08g$>nT
zDt8&%is)W19ZE|*=Zzm={fl2h1cK!K@j12;Z;90g=A<Rb$prsgZ;AQaUr=X;)*j5=
zu#y6%%hWBd<IOmh(4aS{M9~MK28VTclYFmlyRr$Hn+u#b^dQIY>$38jFw9_vpgl4T
z7t<ous47`#w-Whq;_7rZOpttRj)KGEhIgUBcTI!l<}4QkDR#}^m^z(ag_}@5;qrkT
zDekG)iMP~BL8P=>T%=osy<@IaqI1Be^GX>U=~mM_jRT}RdtGBm4E>c0x2=E*65!`8
z7fp_=YZRtq*uVGcC~^DS`Ttg&^^{|!Iy=p}jb-;4_$Cr29>A0H6%3Sy8+_P<VU7LE
zQNa8{r)PDTFY%eK(@l;wCyMaa$7WVs*wQz>bA6WlgERecnmrV={qHnjMj<OgVzgIB
zYzL6T1AD(c>Je_4gY>nENhunBoEP1Dp_Dv2I%HN~Ld+goZ8C$I8b!$=mO^nu&;Hsn
zNl%gZ-u{tum4G*R#4><?0%ueU7zM|oNzsyR9g=KYZcznsRX|ulyM`p`n3TsR`Eq4!
zsTn=eki(A`?zVFmuy>X?I}-pD1`xh;zq&g#^tpq<y|*vZPK`#se%jv*Lp5k4$b>i1
z=6+I-SusqZwwiyBOx{v4@SiTdz?23*2fHB@v1fo4Zom5|i3e7kU{HTgx~gaWDG3!K
z?<eo#=P25cChoQ1hZF_4(1v<;n#Z4Tp#Gg4CR9XkrjN7xn9K0;06(g!j?blzm=ZU#
zgUPy%f6cPd0_?)kBWu;B2_KeFzruPbzbS5GzS|TQK#wiqGeii4u1IW%hY9eRI?4$^
zPYo4|R3<{DRn!^BC8pM#kV|R^`paDu?rvf88)aT<@}Z5?ln!;;5KVf6i4*~*AwwOt
zVb2&G0WxSeT4VwMl;(X>mme5cAzdy1fv}D^>FF{5Vo2ZZk?iqBcyA19l-v>_+SNMg
z+Db9^20918oROjMMx15DZ!-ZAL41vr5(~ee#e4Yw;*}~5E;4U;vBR#%ou}Apb$EOL
z>d^*6?~#YP5h+$en<sjV#eK9oF&cD)Pl^J%=m{pjggwUoJO%)hHb3}NxN`t2{_cde
zb_^}R>7Ou0hs=@C@Le9GE;xbv0a{2;Ew}!Y0x7NngSbqIE8I1>D?NVAE&hI3ROqqi
z7~;+c_$YJrb5!mh%y2+m^HZf5CiCW|&}3fE9RRsYf8yy8I4^3kAKOYwemw9wejT|n
zPq_$V9)nU3jiRW;_7aA=Jb9k5Emz-Vb)wmHo4g@i)Ex<>#UEGY!Se3R#bW<nI2JRK
zeM!|Y@h?RLVbk-dI*-ZXmjI&b%OTEq@pQAupU~R1w{ciRr?@NavAb?JVPWyn1Kf1z
ztq7aHgpyyq@~?;c4O%vPZM^L$R39&=zn<sD(5hXVw*I`mULf~C+yqIhF8LS|Zi7FY
zo4y8>!VT~KO2!t;ny%pZ&QX~xRsp)_I--C5@m>d?Gi`8j+MS{Pm)G@@h7YJ&LDOzM
zC&wtjo%G{<a?v?S!}|o;Oo#`ERMK=rh)zMXX28T-dzeX&JugVDd;fE%N^4^&|INat
zT9xN}{jw(((MoKOO{fHI%ecp}p}?rwh9TtOAb$z`J-NILx|UX}2)w@V^xejHGqjrJ
zdCk{2c8|QSUx8?IT@}Lkv1FZMB5|9>M~J{2=u}+HYRyZ_`MP85b?W8mV9UthhI4lj
zxu^9VmZktCN#-#u(n7FUs7h*QM_Y5%O3%4z8%d-;Ef7`n7ise+=6+Bh#bQ@dy>4_$
z4Wq?^-6D=6?gNIs%HsAz!%@`vgy6}p?s|K9#RJ}iH^!*Yb_q87`LVCd0WXaVtq{FE
zJunu7YKuRtE)cx%Pq;aX@zGF(lZ8A;Q=xjrq77#v_obm1CMk|T3ksR<evS&093{$^
zf3(?a#`YV!dZn|ZAE20fVZs@Ej!xOi$M60^GZh8w<khkhBl?q=1q~x_cg|%+|Cd_P
zZVPc{nli#E=rT!(jc-K-yuKxE2`89MoPBTlgQ!f(KW#g44(YNV_*1VqB|OdMPbGUr
zbJ$KAB1pjNXvUa$m?$v-WkCgiz|pDe11=SIgvZz80WJschH$pAp0(*S3#Tu5;msj5
z^y{pBn5IV_R6+%VslN)`%zSVp$efiRtH2U<f$NfEBSd`awjVf~XVO#a>r@_!3`fR&
zv9Quhql$7V7X0qT{fBf4ul*?E3<>+XwK+Q&Xz%XR2(@(!``H$77C9cPmHa;OfiBIO
z(@`KQC{%kS(DE5Fb4UEdUX0v8iHWOtPjCii<R9<GH-==y&YP3)+8XepECz8VbePSZ
zMAbo6QXmnUwE64y_|2B%Cs~DeTUojjKX!cF=-zn*c09$rS-U*MJ-pL7d1qnQf*#98
zdCHctJ(|%40-!ok(Ee4DV>abYU7bcomX`KeO^8_p?M`@W@#G-fv0cKkY@8+f^#Sw0
zCJWdrTmFw+*X~VNBqFe@#!WFLl-7;{w(@YbLL$J5C050~ix<&z1oKZY&NULGzobwS
z1nQ0Qh3Y*UIu(ag{uN!Nml_a>C$IjX#myECyuLKI^qav-Zpqh{CD8N)-Z?jv$Xw4~
ztDCE$#V-9IKJx4BBJ(T#5esX%-V3z&N0!S8_@VlQv?m`MfHxq|4$%}UA;4j>ck_xU
zQ;H$w)4Cx`hj!34$=5UXR4=JU#+fk;;Kk1`{1Q`ML#WdzyZJv9+X+y`m=uP++D!G&
zX_y%Bv=7RRWb0H!p{R2>Kv0#)v!R|~hH2SO_WOg3UxN84H!4ZF{(!zNC??H5G7<Bd
zpF(&2a=olOV|yR~H5Rf+J#o3dCi`N^Qxz4{Z|IUxIO&}G^^Rx^!_59~m8xZUm&4@v
z(o(5CIKH;e$_N9neXn@Wk3@@xe+5(4aTIf(_kxeToyYbDDu~UnZ<Dx^dHmkf8?E9W
zUm%)?uhtCvM*4jFo5l-52QZAwUcmxna*_OBtgjx%+G`0w)kBv3A9xxnNB<oaYWUI!
zm0sVPrHI@bJ#P-DPm1vs<>iG$xmOy|){*dLB&Vm|Ya&WV_boZL-g_k<aXm5Wc`>42
zQI|ehl`&x|3hNN)zL)NmgeKn`ZI>*qH0K{A<)tpo$rtHx;5!Mk%S<8o>K;zeKdWCN
zk=x1w3U;UN>&4FzlR^`rwIA=x=sy;HT}o3G&;9Q49y%ydaWqPfIVDa0S|6t-tVkUf
z*27w50SUKdePYqnT@hKEzsEAyPAlo*!SGjga0AOovj>MQO)8}4&T2M)MYWoMd=WVw
z{C0C_|Dn(L6`!^v0r;`A0q%AS=5n{_An2DqkT5IuS<akoj!paJ8(#|tdNKO`W7D!R
zlPy#1IhCjjnUfes?<KiFxBE@Xn_;RvoZ0p`9qOxn^913`<n;{|9mgAL81m~F5|ngF
z!rrL%n=?5+b)jn#AH49buGkRhT9G%G>c0b=lqddUI5Ow@b22?<BcDQ>2{4{JeNEcQ
z+SsZU2q;V^s0xYbFwz{|uN%$3e%SR(&fOM8=7fWze`CwbRFvWsHE<~~p_Z0XUM0!#
z-(d~!c+N^yQb%6kbN2S8{EZaU5Odik4`9s3{oPbJCy2}y!b({Jr<x(9K&J|Sos#Vw
z@(Pn#_dKe(x-H+1ZPiuIT-g*N(x4-JuH@U&;)g@NF0d|R8v2g#G(7iKl9Gv1zZPMz
zjAU7l^m+n-E<Vw;byqz*8(W{$uNA+X>teAZr>NK(gSilsyt~!q)r8*>{bnur>T>))
zzamfxSAJfdomfWzO!YhBzdG#b6h1_#sFO?g32;B&xC$<WXe?QL)L%|K7t@;CNcnZH
z+4|IlEy!)Ae987>VmJ#-v0K&SxrwF!iP&*SQOGP)+<yYRjBLYUX?FV_;?EdKy08$E
zr0N^@^XIoz9VIt6lxBD|K157k1l8FMN>AJ^6%vKg{;pT<w|%wVpZfbW^kMEp%vPR5
zLipbjCmPJPXwBpa>uo@wpU|||eL4z&)cZ$DPF8nru-^c^c$fZV;q#U{pZ|wHH4n8t
z<X`9{?;Vata_!WPE^A`^*kmbpRTQos+D#G)Kf9(*Tl*}Rt1@NR=zK4!GPkJdi0<(U
zIEuHoSLG>u<?-V2jevZy9<m=lrP*m`ZVx{S@OzKFppzO!(BGVVp_XV1Oq09)C1gK1
z{cp<Kdxtmg4o;O(n&OvB=`HJAt(z@Eo?dUcCouBk`5nWWxVs&2v!^13Sqk+TVh|HQ
zKlt(AFO)&eQDk8-l<VowI|4dl;jTJUEz-X(d0~(#iL#O|mNoUJQ^UL6i{&A|MaTl5
z>FVc{XJ+23t<K1{x_gICyNN<9FMuARdE-%6X`OK;Eh}O@<*e-P`bK|p{j;UTPO>v)
zz|c`BwY;F~YL2xxA+ST}Ev{SK_9_+P-o35GPo%G^C>fWR_DJL9FVQ(-(%c9uwE|p{
zB-Z@b`M>6E0=L3iQKP}dojY2}RSI^Dc_Rk-LCvVit>83YL~v12n0Y*^HApk&9Y2Oz
zIUk4E3i=7S7Sd%E3y5}YGx`U|xTsNKeAF~$5mZ+RGV|9*ZYbNc+Y1=zQ+>CLJbaL^
zisM1COQkqFVlK`M_y*4728$pn$Nj#nC5lLA8Dk@<J5`;#L$vUrRSIffqVqcs?}aUJ
zI(W^os7t`=da<SP2ebE{JerlQ6^cK3Z7$O#L|Ia*v-sNHNY2;qhe>bloNmbqzhfwW
zDC2d;^Bjgh(Fi!wEc`6_vFesX9!A08_58mQinlXzwOu30mNsNO(&XYUl0bSUts3mw
zKW6I9HWLZ-!T5b!Q?}jcQ^b9{R{vsQ;PE}6859!sKqx{?PZIc{+z_#I^zeRU!o8Aw
zSyLNEbB_;x`rp44E;RKm{EGXJ-HQLY;(YA4#_7$W;CY3V-+V*4AiuuXv$a5$Zf1H(
zo#+_j5AtO<K60+J+jmGh-c0eLlZ7qen}Y%{>zIuJ91a&6CQwiu<g`&qxFJ!w)w{NS
zLf*MCmd6ZcWOQ6Ii0aPZZw|r$)e0D9Dp8n|P#r!0^}yAjRg7j64y+FB<mWF&@H=WE
zGyz)!ni|Cb|3H3(MgpTd@_G-wJ0p<4Ih#tM_^u8Bz_FxXRCcYoD^;U9mpggV^t<J5
z9#*RMCw?FQ4GPZD{%^2UbR<>h_mM-ff~IoRE0$GLIfjic9Z|vNOa5~t#L3z5O%GU7
zUh=Z!zeF(xYDsyhJeGzl%r8V><UX3k>^$}Sq5MhcV02KJ>*_fUe?W)~ZHGagbZ@<G
z=>Uh}&NikXE)MI<Hqt%8dE%Wz%V_G>6*>NEJ6jVVBf_5gyg6SV!D_)0EBqqw2nPXD
zt{M+S+_is4xYerKS|*+%O4CVqNa=IO_46pSMMvI8+Rev@%+DLLbjoK<1@^0nG@$$x
zo7}NTqEIXnomT7QZaxZV(duM8eA>@W{U7tRvv(^+N_oi?Z1Aifeht%pE6*AFPa$De
zE=tjON$Np?3H2>SlTq{Ud5I&7B#e=7Df|>l>hn*U8}jJ~u<KP#$agk^+@fxJ&Yuu;
z3{M3)h}3$qiC<c0h}ZZm4*-_o(Q-44If0c2{e}YV#daRVT5V3sBDmIF8D7J(hj#fa
z&dwKCryH11snzwFYO9BH)VGTJ`DVE={331yZ4ez97ze%*qK>ekzU-o+M_KZIpn2#d
z7*7Sz>={uiYQeMHjU)_xVAJ}GKzD-Ij+pIylupvsBhD`Wt$;ygT~<<?l^Qu6y`8rf
zJg3n|`58PNVtIaWOigUW!gXm)ZJse|w&o2H>ze+;$M!(vAxue~hdNCBK@b7X6r^wL
z)ty@i>=gea`@NJqx|ZtYYNX5`P1;AJ1C|UrDTE@zR_`o}lXdJ9{}mw3imJMAj|oiR
z+v;96ECv^`dz`;|0*bAyS8axuZ8#SiOuy|U(6i8<BRJUMnq&9U(vS4`r_0p34o1<S
zGQfF&9v48X&S1Db_Zi6<@Tn_!Iao9?n?N<6Kj3;JJr-0<d!RAbCL<K(vzbZ(KG~ok
zn+A~o{V|b`B+ft=-x@_CrcF~whLU?!VAM;tCdS9gTc>ciF&937tDNkS%i~?&K_a~(
zW?e`7tEm9bg>=N&&+;mN)RFWtJmD>oEt7&b)skd{)umwe_pks#$V>=K{<9+5Tiafa
z<RZJ@u4Vp8v9D&!#3So|M6<1Q*JT^bb<;Uq*z>}^vG?dZvPbff{xTzVyUJGeIOmR3
zE7{Islr=M1{m3n3KYSl~K#IV<-WicP$p(eK$+%p8u1Ee`=9$>&I-Hb2E^7T40;~Vm
z|Ga?(Oq>RA?4k$xgqDJ9w6`sOyjxjGya~p*68soO($RN$ki>CUJfQ1%CGQ`G>a^Xt
zo`UOr)U@tE_A7YJ-K#g|MHe_#B9BGY(o+peQnG?>SEgikUj9W?&q<);dD*ppUKc)d
zM!L|rSrmXZSKgrY^I>wNFt_IjBLMwIl`T4Z)I&<@YM^*wt>Kai?X6rv)>tQGr6_Tt
z&kI40p(y>aH1uQ%iFflr{|gmXO|3#|o<zkiOgTrc-sD+ndzmx_u$28Lx+oP0rScZk
zkCxcbHWNKPd8?-NA!Y-ivTD+QbZI4W!ME;br-u=9<t3#fPD2uzPF)ma!N|Ydz>49<
z9=o#K?)mhN^N>$^d4ShHhdx&>mp`bgS<swF{{c)+WJ|uks&AJF`u5v8pq+Ty^~#cT
zYB<bX%6zQpT96Pu2+$B-2DFk*gg&^*Jcm#^Xj!1O=_Wv*2Vl7H)V|Cz<T02uz<;Bu
zK98VG#_oQS9wnw%Vfy4I6!Wymii4kEDzb6~W7)+D;B3y`aw&;sItFptmCwV^RO+MV
z9~TEDYRW!td;BePu=m7DJ$Kmv0Dv`&!3VMH`?r%A=A+p0?FwSrE|K79>E`T#6N)D?
zJ-ya5hvfFL!3Vv~!4FBW=mQm{5D#Sx=Z(Ml|89N=&;w@p<t1#40k$Wcdkm?&2#u72
zW+<Qmt2E<hLfkmmqAYsU=6a@z!mqkn7TSB59x62k1LIz&z|~!-<3(SB1_3u~PX*7i
z3Ugv~nb6Um38Z5zn%2J6mvJhW+IvVtCw4F+jFwG+z_^U=T6$ReR{p31h5q`d?*MjN
z+#rp{Ld@3MY-yCj9P?n6d-mry+1@8Ky)O>yZq8rR!`wm7uML30{I-*WR0(fGH=T^w
z!F3uH_>645od@s7mM9ar96RMy@a=$^4dp#I--9O+7026MT>X%mBE*{-_21f_zjWAx
z6kT&GJ8h|0+lJBdwCJ;qchk5Bm4?NT<oiOc=rPcvaaDDhf>6=bkn{M@f869EuYC}L
zU*CY6JNJAacJo_wgicdS?BRtMmx-LH9kD(Y_P*5^*2XC4QqM398sqdP#4NtyYesNi
zb*|$M1bn8U)suvP%1_Q>mUx}Bi;U*}{>Yq*tE3@kGJJjO_5D}_!_!6vN=sUM{3k=%
z#MeE1eOZ9HqHfx2XcfijZQ<mL(GIm^Ke-mM)-*hAfmrppI8iWpfzGe-vCf*m>p>=$
zJxP6iO;WSS>?F<9l{{AFa&g0N<3=AD9%s5gn`6WSIX>?^@d3bJR40%=xYQ8f7ftV-
zMv$i{6#t7iFTv;fgHpk&#3i&p<C!tK7X#djG<`LAjt9(47CnH58J4z)eo4bE=@Y&r
z(kyg>f39BnUEs`V?7<j~96VD5&!Cgu1U`dbZZo$LxmHghwd@ieNXxU_O@FrT+#x{F
zL`ou13*N|R=d^FQ?&c@wUfh9R1icbRUfv#FjmRM8#k}d@h=!JxzJ1@bV_5nd62-#D
z`}aQP*ubOxVtyuSfB4_qZJc?`Pq6_Njso5R4e2-6v{-W%8=jeB9ZED#Y8-4@Uk%lD
zGdwCX*K<Ez-g=4S&X{b)GMn#ly`>`0xsj~P`jM33FJ@<^>8u7IIZ}mD_^3$VXo__3
zdO*V66%-MSrB*;-#J$U)gb1;orlc@;ASO^0qXbpKr6ELmPC^5@s&Wmuh|i3;cu{%O
zyIh~z>m<4I^=a$NMdrDVa*^j1-3)^$Bxj1czaF8TBpKr*4H$owtcW9}<ACjt?s~!x
z2}id1+~i|zas-^lLFR)wTx_swD9~>7d&ultZ}Teb$;l0ZnT3PFCAib@!W3QF^;EFZ
zzGwWrToepy5^Nmic*b<+bu-~ZOU5ID?&TE+hbyzW5Hw08Z3?IpgYT_sYv;_`^oB%b
z0cH1dLvds;L_F!T9wU*^ajfyyY8iK$*0+b<A&9uTba)(APE_IgJpA8_JIT?gw0!{g
z7$17`d$EhrzmTStz3`?nd>fgD%1{dOO{CP=paOwy=gsK0{~`(hGW&w~8q^WecK8Z?
zIKS_|Sbl7<=j<#ao4~?^Nm{cWc%&?z8SN#DWcns)&JMGwdWbFN3jTE=pSpw*aIvCy
ziKZ(_7urTj=+!mpt~v8I?>8}%&D$v6e$3Baq9pScZVm{y%LT)11pk_d&UP*WxSn0s
zZpHhU&WzRz1d1j?P#H(aPa07&^G@-H#J}S=0jh#mAG*AsJ-$hXKTMdp+x?Q(TAO?;
zgs4pMaj>lO;kNMO0?tt*L1VRksl{|kkxG6GiDlWvv5yLgnUCvpMOYU9kF+!YhVqa5
z|7;lR*muTG$iA;5Ye+&WiIKICwG0h2hAdgj8nUEC$<l{JS!V26B1;r9V{E0Ev5pM$
zb^it5bME`M>!<5n=X#&>I<ND7E{`zwv@54ZCmYDwATz+bgvTRia4vu4%LI*;9fKt&
z#!f<5OS5U4Lyjn#hqA7M_23NWFTcq$x1K6_h4shCivsm}!>u0x3BNDq@E{wB$?MEI
z%p5(6WF-zoqA?3zWP%EIS(N;+5u41x2^i@mBvMW3W|JZrWq&_pJH?$mPi^oPNPYt|
z<Y0=#NVS&8(MuYgP@iXBnl0b`Z+DWT(nPdu?pmCmyNoVhn!YaIsh@YNT<cl*q(w=R
z!4dv=X<H=oRgNLqZaeTd02nFnLJr7NO`|k;DOhXrY>K{&$&7nxtA)}$jW_(XVxiGF
zjD@T;+A#PVEsLw|h%R!w!1Kf^ydPmayyh+ox>$-22V*-p&vb5&$m!N3eZaw_`S^Uk
zN|Vbm78TF?eg5DrLgl^w{=uE<A$>p)^@%#g%;&)BCrqYu!prCW&oUDMyv2X*K^+*Z
z<o1LASQtyedTOAUU!RYMWY!wCsI#o*E(a>V$K39<%+l}oR9p0NY%$W!8I&uyD@h1H
z^94JtA}(WR1~=1t1~3L0m+KGJr?pyt$*XTpn~h10t(rRFeJfPKv1TQNT~MUiBzyYo
zM^wnXy0JxKO?yJE5*ok*MnsCkJYn7UaT<??N2Fmo7{31rq!QS}VIolPFKdB4ouC_g
zrvF4+EDEDFWd|%AFK(x~@?l6}ASg>bx97`Shb(~qKHgL{6+hR9Om+f4*Kw=^gvjbf
z-r*m>iL>HapSzUpo*7i=@U-6*>bWeHI1#8l*a@ENORX1TM5kF?Uq?8z5BR!>K4cc=
zpTc&1xN-cq3V5_q#G|Na!5dKYsh8=@q0XRI*+qrh1k?#1rI$M&)NeVFekjMyrzU`$
zbv{IwmE4Fw-l#E}2fsBJg!MQ-B^YdwDBs&TZARv`89!MVC+6FyXF58Jw_nKFQjl|t
zmE`UsMlL2?yaujRbJ)2W&U|>^{OukeCmP^UuY8vM{+5OMDd#CYEm^UvM1O3tSA*Y3
zZkOxj*CoSIW)G=?7ttS<$TA-9Fb&_3axs5>HzJ3lF%`Ytn4WeC*Fs0dua&+yma)&;
zQl{vSk#It^)DjniIvy@)W^4(u?(%V;gp2Q;g=dmIYNLar4PV(vl-~9*lo@|f&BGQ>
zJ`3aMF|0hx>2R(v`$d(5C5$h*3(Yd$_1i-b2OA*Wlw%$1QEj|)_#=jP9Wv=h5$U|w
zxpr`udTjPiCenC#?Dl6sk?&Wcq`v*>BE$!hPTy?!m?5a)>)A0p1H?y0(javS5?hoG
zhj=HY>!ZWOpD=5RPkK>iN|81;eD~GCmU5X<7ceyFGGdob5;o!z>1haSNa(xkyLR&1
zoGdMn$DYH*x-79=to|8!_K}(14Sxk2u=jq{F{6rAm&>S&EVFoURXW(=g;l&JME`ly
ztgl6IJ9aPq8TEHnHq}$darW2R{x>cB(b$<zcJrUL{ehN5CD3+LoVaJOC9}iG$+KPY
z%9)4ATH)oy?qGVeZe4`RK{|vYT$puhZO*<S=k9~H8GW^8lmFhAd{1G}1uZu>E-jMz
zX$5c5Vaxj1k0E0h<XSH<P5>E4uOd!7t#6vqxr0CSI;81osSNN+!O|f#V8+EF^C}0U
zPduzGC;_6(W|3ur@S*_GjwcA*Q2h%5o3MOBEv7(grbaXZ0S_KtT<zv&&1c>)$=k)0
zob&k3!uM&>eD;1T2SYRq)9>@k925=;j$sH|ed5c$5SyOXas2O5rC#PqB^P_sqfYbg
z&uOL%6+V1>xg%9PL`ncrBJom8*fijnK(1W!jqcVC9=6TkoD{0ld}EgW=O$|Xcc6nK
zu2&@~L8Du3ky^pjm>qS>E-4uvoPwFx9AGksd7%^AuRKtDo9){>k3PWO%Y{f{!X>+U
z!$soh6xc_$8PtQb=Omr96BSpwv`O6o?<@VMa!maRYf3&|(6Ds`d}q3H>mH;3Di`oC
z-1i7^?+wUn0L$f6Z2I5#-)CO>V=s$G48NK0O8d!FvA7-O+x!~BN8IA&T{wzvP1F{^
zr1~8cV|8jd#3O6J9|wFNat>&JT`zM9KCG(BzJ!+Xp=WEsjJhGMqAiYL!`(L|D?d-C
z;%GKQ_)f{_Zp4{T39UYjMu0TSf&2KA0j^8JTPqvMUnp6UAG(%q#(h*T2@qy>t8^vV
zo3ReX;0L);+2QOek)*`d-&si=qWI2hTCB1I&p+leI@wA3%0S^cBT8WzzHK~ZG8lNT
zc3ceHk)Vg_>4ieVA-aa|E1G&>Ge7nr@-;ax12><Z(<1kxGDu3?rf;uq(4p};C)k3r
z567Dp;I|0X#!=x@basp_;9SQfICc;i`(9Yg>fng6yH(VOir^T@Vf|65g<#RAOA*Vo
zX^%7jRNw5UY0?FOUHinnt&w<#g?Vb;M`s=CaVzlFwWwt2Z#Kd|BmKA6`A6og;ER$|
zzjEQLpu(K?!JMNo@TG^!Hwp~ljFog={-bL@mS|pig+6=K@n3s@j^~HPv^W}XdeyI$
z-&u^XenszuMaKw@dG7PkgDrQ>F&_|gV91(=>2LLAw$gU%C{)a&2ruY?&YN9G1$@6^
z(>Jlf3*Du7)*$WYRx99ok>l^G<Jr3=c%i2?_}M=oZw-@u#d&x948S!fm9JG<9|B8)
z0-An|EkC+=bo*#4;a*My{i*?2v~a{SiwIPh*tr?@8?z+GLh|PO4X<M?*&=~R$|S2^
z+od$VbpX7$#HEPd&Bu7NGa{P5qMfic$FNBK%58T+Csm-1G46w(>9>e-{h3+u50v%u
zD<-&a`<6Nu)%<M<wv}C^c>AnjrR$N`xy{W)uM6H1a8B@P29*ZCZyDCgNnf<U5X7vw
zuJUfy1t_q0f$7r1vg7l7+QN^dd%F$pslpWaAYNm;?%g2u<<;Uxic~-mzJP`qV27|D
zB*>_zY)=N=s-|4Wmj0@s<7Gk)6G_iS_*GQMaM<YnSS)6Q3E+RbHR=fLk_n*rNYB{8
z?}tZP6!u$ro3{vXk~5-|XzlVn>~wx2C@cACTrRGnYaC!ej!qT)uez$M`Ek*urof$Z
zveJ2u9#I*`Nu0oyEzQ@L-4~N!<1<$)U5Rf>U0$cs=xG$8aWr6cg0?%DE1-Z-Rrabx
zFT6%eZ&scAvNa^D&oUX!0s_W3HR_pk;YFCE=MJ_h`6$qZ5<NN(CODt|H!#_%3uy3R
z=kpvWA(J~Db`Y`Stb2bh=gaLiXRbB}wC~CsXKMsP_}HtnE6d@s`sK53Z67;tvaKAZ
za?m15wsN-S-X}{v1Af}c@7hVF@bbTjW%#B&Kn1eOopbI1=r7#*FqwusGSEA+{A%7U
zd7Tz}1XzoEm6P_lv8SV)hhR3e=@S6u2ly|#+bq!8f|vbmFuPV~7X-uEX@5oRQ7-Sa
zzI=>f59j7^<Rt{?c=CnxOCJ6GVP&WKSistzp|2z2WBCU`;^U#PdY$!#i_hm~9m|^9
zzM^=a=womF!Z!Tv0&>(V%q=z!!UB@Jj-1g7!rZcTorBPguy^guwmV;CavJnD@bPP|
zv~z5&L{529mhBgQKnR!2nUlt~M-Mzv1x~A%7|EPq!8|SX46@PJ<oQu#-6Si(k4doZ
ziy%OU|8|RhQpB9Pcw3ONuy$KSSGVRo%Y_uXEdr7ICEr=>ZI+@-(o1j(ZzFgHVx1S)
z$zbq^^+#P2^WJNEnzFeJmdCVq%p4IT%7D2p+EVO`29=E{;7ox<i&AUE9wxn2O1C=N
zjsJ<-(Zf8^U)g7Z?-PVMCR_KBN%fVo|JwQYaH6LW8%RRvZ{Wubewc*+-Viu{1ALxl
zys|`ro%sf+kdhW1e0st-V8mHvHOsUxB(=#q)P{1?6H~HhRtWHva`MgW*eR#Lk>j%b
zc;RW6{=M|RKUrr)01)S#AUqZX$h1O$PJu7K3<#2CH~_d}gKPY+mtQip%C4tUDkjsr
z!<5Kk<xF>+|8z*3(cPkMi7p2t0RTN`UxB@B{EEr8gL<hwvZhi2Aj10ZzY$R7>B|5$
z0D#|9`(FTns-%4$*laI?0)SpdvH$>HN*1MfnFrzJf6n*BBZlvklB>JHO@mUpa!#WI
zo|j+d+e(z_B&i(bh?&O!E}<PZg?KCQX~L=WV#hXZp;G{hAun3*n%6b${#|Qz=xvE#
z+D$rSc7}k8{N9JKWb^+&hlN3lDLwUNain$1Ubf%HvJ9I|WRt`j)d#p6I`7A%@x{b8
z7DypPcCPj)HR>m|PtQ?Z(dCYGSxZrF!S~-vF;Ry++Gs@sgp0SttI`Ut0ltc{wVgxy
z3C8??`H-rib4BevTX<mvtCQmsOauwMJ0l|YrsfRg(5*q_An=3~Gll6L7&(wHPNuS=
zl3Hg3+&Fs0D-P>X32HEk*!PGNFrDrxNs-)PX=gd4wS~j>=H0_Krz(seO!56+zHDrb
zm|FCvK6r$inR`j^d4I8<i+U7trt33jf9*)0B$a25xr4Ltk3(UBB$YR7DQne(Q=<u8
zJFn-ukh(uibMWwt4v3$*JGy!T4Ok{~UJI}*R~vaQ@qPw9m5s|xv=$D|{mSX5%g|Rd
zQFS~mMUSpf)23XijI=P$_-`xuV@dHGnbu`4(_#uE$TOQ5&xUdf)xT$ry7=!mgNYtp
zh=0Hl9hxs<p*{@pi|O_Zd}33rFa*{M^e0=NJx6_NayI_bK0%Ba^#q{?_A8{|X)2ZC
z_kcC=UvlYDD+ot>e4t_uRGIk9%T2FX;6FG`UBLd^fU)FGK%4eWg9PZyz4IrsV@0UJ
zjD?%V@9!LSgv#upPU^E*84Pk+!uc-6D|s1ZRBH~w8UiS95iukGGlQz7l?C*g1X0S+
zT&Jzx2b4=lM=p0wg5f(>rg>=0*=YvdodFSfJqXQavwbM6siYs8fan%adH8hUek(Vp
zck;ce*E$i;s$N)V;sNIAcnz!ZwPw3Jn0)tX3`A7d2atc=h?%DwL@-IznDSDCB?)UB
z65ufZ;&D9_WOf>i$t)z8v~E*gvh!1E1MP`@>*xB*y~$JC@;vZAZ&4H4*Ol<pdr{d#
z-5YOhXBu$xM?YGqf!zwQY@z9#^u~d=oc(_=JN{R@F>Tm))V<PAv7c549N))=ozK=T
z{QH4tdLv^YNkUSB4Y6!Iqx<eF>*wK=>lNERU~q&t<w}H~Bd82@<>!NF-Lr|Udr>4#
z4g$bSO0}GupJ=JD&~v*@nZxo#9T`#8Qz!A=umSV&n-|aO>$Q7-wYqO5T%Bb;!%>2>
zUtPYWZkj`|o28jQ{Pxy>!lna&OGwRwpGV&w2pd@KB0e-IK7xf$sK3`4>8X^SFNWU5
zB=2&eG)&}1cj^_MHVJ<n;)aCjhCwL{SwPF0>qX1IzWF?T*4BQnI8m!N;ZBN8e;Wq<
z-I8fL()&VG==n}Xi8Lb{Hb?WdhW<xkP%yC`UyzLKhDt7F1Hd|R4=2k}r9z`QX3nr}
z`p4GHMc<*`;D4=k*eOyHm&<E4sABT=rH|lRi()xR=(;1MCh{*;m=>-SjJpg)H!^B-
zn3^EKn-!|DXz8ITaWtX}CiB<i$8w_^I_iyZx#F1fpj7C)wB<5@$oQgA{tKBx{G7gk
z<9hMNdG)afQVN7F|Ji3m_kC==2BSZrLtoDmla_L*?&N7j4~((R{u%!=ABYH%rdZ@~
z@&l1<nz;sX>#es0<NiT{O+9i5dccXgz(@YTY)*c0Yf9lgL;u4Dzm4RoPA4X21L;b}
zgZ=7iY_x%(R|FF#y^C-ov7I%WvsJpP)hwOv!OT?6Zl;WNW{cx|rE8hlvGH*GGvGzC
zo7omJYW0;=kJJSQ<34Qx7gFOa&*CN+?lAgZ1^+1bQa5u-m$IcfwMaw^!vE%Sw(iUF
z<lTh-c%7qIX4MuCkd}TGe4bNcPx!7<tgjf6Ti1UDcJp)i93a-M%>mI*1|op}x_WQy
zGF!B+f7%}WGjwr&MMQH^Z(3caO_Qdw;oQJV3+4RRE%`JtR@Qgx7C(p@(P$CRQI+7D
z+>6T1GM3?Mo?0f;Cq#|^+lwHteKVBQat*q$>H%fKmZxo^ic)k|9e?Z8Qu98$B`Ey9
zwDNgFUp1um-zlx&5mCdqgXv}YV?PL|J^4fZt*mB~;%8JrtrSSl`1gwKTTYk--uBHy
zt>q;!iR+?t`pPl`()8LzHO#-xjsIqy)M5J(N$v8PIT0@KX_bR|IT5R#EL)xD16f%S
z_O*JP3<;N-esv?JXa;Z2_x+RHrFR;iinUAN>V}U&!0rCwi?p`$GD<rcJ+Ieb{9aB_
zMb>j6DqIE9<2)G}dXG;uj_Q`!Z&4QScTo8s58IEO+CXOH7)u%hLhu3FFZ|Ol#u88+
zz`yr5CEskFUVAxiBlSQa<I)>5Yy;f+*bjJl3!gu<8Nn{{-fmKMQ{qz<2&L@P(y64O
z<e_FFUtcez{{+KnW9hVWcQ0Tk{37|aefmGj9)p^|7xAf6gIigdW1h#~xj+FeJ+i?2
zzR(=f$+KFQ-9qS96_RkT%jFgdk4tP1383G2L-S#_?RMud=0q-mQ*v#*EQX3J=|TfN
zsq5O^nwy=vIw>)6gm=U@&E?|=&Di7gap`fNh~Gm?JI^nk>AQS@)YW9tra6>q|0&px
zY``!@gJr65fbp`wU)~$fK&UU*u=A;jvg4Azuw#nFRLG|((GcZbPL$kzNEbN8`2@6*
zAh|#N*oM8}0rn$dgJv->ccLi!Pr~LlT36&zw`qdzVsHNdydcF%IDmsU`~mr_N@@n{
z6%B-{So6nc17jG{+r50nWU~rJ#x0ryZv)>nU6wukyzrf)7s~@->t3F`bdG<0%N0VN
zW%5Kt>>}&%Oa5YR9ulz1UX*kr`(LhH7jwrb?`fy!N@HfV=e>JpVJT{+(s-+0n)Fkq
z><wa}XyGrrCFHy_GhUN|>*_HbQZ<K|n|G`j4R;$}YPtcgnocyx3<<fPjfG%W+uEb;
zDXzt&G!4+)!)q$waQjy(MOrot9!Wh%V-GvJAf@1g2&MXdg%DEf);VC$89jQL)ASi2
zWLXrBQ$^1ucHE63q2eLsyGTWb#GzT*nc!UqYl(d7NANsbjewJ`m-t@d+Bb;}8o`9`
zYXW=ApU`IrLe90VqMLR4qvQu&xCNQaT22VkO2@(A<>fvPvlotdEP?w%<sv6#BW|XD
zu*sZRP=`r`c|Uq!bAwu}nFD*zlb-hY(beNP^;4)>@-nbBJ&JsNxjemL;dx_MES~w*
z(yz@==3ez7aqv#4|74D1{E14-Rzor^U}HbxYjWYLkU%T(*C7P5R2~wrfq9tgh_4!W
zR#~9yx7wDTpyCD;;Q?dcn}(OY)%aeeA=RVa&`o_k3r@;sOVSoSaurq{dA-5+a9wzP
zB!lBsI{hxN0vQJ}V)K0S_C#SaQh1Dcn@U^XLd5epJj1R83@q(`kwQlU)JY6cC~Ho!
z6uTVQr$i4fVp89R8jM3qAHbD=vY~WSXCPO9J^OQi>x|u?XsnLNF=u#Ib3k6NgcjcK
zAC@Q?v!oSic_A$5K^_r@ur3Vu1+lT|apecHT35%AiP+>X9v_}jjvshRze}+k40OlV
z$*_bqk4<nnQByDyN^XZYL!Pk%Tl=Twd-xvg53)$G{YSdIi}K5OMGA?II}7OV1IMB@
zG9E01exqBx3>$)BSZ`&P^@<_bD}%xKlU<(T%7kk|5}D1tXNRZF(Vd5{y__62xmk&p
zt*|3+de_QQ4QG;jwG23xsW-je!K2<W2qK=K_BJ*Wf3`DNlV}+PFPuEzYz(Fp0G%pd
zbDs(|3Ovtgoh!K(84-JCSO=Vlb21mxVr1*#`TF^d%<PP?dl78H!+a$Y_BRBL*t~9G
zJSTB)GxX4J&5R~a3vFV!uzz?g!FDJC6KVS_rCz-tk<YG_@?<LFpNjR%#pQ3EPF@3>
z&gUE+)U%&r*e2Q@NTm4a!;+&xh3+M_mmSTQVy__OVJy;EIKhT8Wws0{eNaO;^}2Ip
ztxehzn@eI%l2{6Tp>SndNGRL*M8!Ap$IIX)*=KjZprrqr_xTPF;(z!N;N2gE*B|?}
zb0EX7;;G)y@C0wmoRwPeE%<30-h*({#<SU{^XCzvJ)wcG(z*9qx$$Y~x46ZzH&4m=
zYd#yLaoNjbB`f6MyyO^%^Jm?SGfLe5mhY;2<SJq<kEX{?|Lex7+8J@tP2}UjsAUe2
zP`BgqLs2doQJ5ahgfL@o=B(x!67FZYO^TTrj@s|yDF$ekeDypHYM1+8EPbp$j97UQ
z8J@lX=kp8&=X0}KuGI2_bG61nJO=SQuadhYUUqRxC-aHW(Jw7EhOW+9cxc4|2kz6(
z-Mx(ez)H@R$P&LkKQEup;bm?qCU@hwXYd|}l1q59G5Z!)2B13XDX~^Op%JMLrNuaZ
zPUN=897fD4(qyxSkI+B8i9IgN0Gb_{5eFF{B^OM4QnkXu5h3b)-G`5)N?7dg(%cVE
zWFnrM5Won7x$TfGlIqguKM&dDPbgA9U>5x}`+>G9`c!G~=KdsGq(7q;n<KIMsCqR=
z$L3%Rlkt@EjMD{+M8^c~rsqaFRhpM~xrsgckbOBGH>uIlyMcZEKkJzP7_!=F(AIqb
zEH3QAU~#Ty!HJ?bl#P>h-@~gWxI6CVJNMN|hN9tsph2bXhN9$)cXhknLrOJzRI5up
z6(!HVYLpYEw9X2f{TaKk6DiH9-=&}te&RVn=l?s9s7kDsaN8acMBOj|#Vs|>fv$=}
zi80~s;2EL14ttm)6Z&?82BJjlmPQ_?ZFQ*rQ)g|dp*-E+j!y%qJJUtZo%@m9eC8rq
zNe?u}EGwd1vr!Dv;(zu%7fGnMzfPAnOVEqB^)UIXfn|RplWj`X(@-Njcv1fV@6ut-
zx3AfULCgjK<(@od^&hl15}Y*J=yER5Mx){)v*;>yGPMx#U%ZtC*Lp*Q&@_GC7t^6L
zXQrUu#@POSftL0qOdb9?yZ1twz(HCwccr=Zl;m+mS}S=8kCqJG-rm#aQ%cZQuN;yJ
zlsQDVw!O{lV_7bWkJt~*2XIEAhf2ibS`An7m5tco%jD=8_y7Xz^_~SK{9ODywG4?G
zkK%TaP-a;<i=EC0OydCiH1IXrk+8p$TU!<dl&?d{ti97hVwY%Lk|=t#)KA{$&RA#S
znM<1NnTN0a1P*+2n8CEpnB3m*Reqs?!xD>6Y_>pZY+EU9<k{sxBNGW8`L@b(Zmvq!
zy)zz5|7;EO{m?RKz99je)R|?a@Br1lTM2A`G$}e+T4&D#0IexlV$bViH&6moS#0zb
zH8s{ilL!#*vgulbDD>A%X)3Q!J>MT@6SFTGx!ke{ecHJpo$Db8ybC1nDv<Uksqy5{
z^Y7vBcn{WE&|*#_XR;6+$|jcTC6OyLeKgLeKS?R81Q?Fw1Nxb81eO7tE4W!ME$P51
z7FscWJmSmWt%p@BS0scBr21Bd^`Fn21&}LW2qibt#c@o;AU~+RSt7W$TYDsgojI|M
zfa}!|xUL_uc(>c1sJaw(5Ls#(bpa}a@;11tw0NIYUV<lc`4hR-p-89nv8+1l%=xNc
zX!=F&G|n5~dV2}aj{77PpXaW|abdJ}y$*P{Ewh7A#&6%C1;ineo#2kOEELv?RJdKK
zUe#t|fJ<e{L|K-UfRNIk@1VwrsgkaX)3}P{a0PqZf5yV=)rndR*3)f9(LO&&Sh#}e
zF_fp#Zk^9)w8~t)ji^YoEFo6{9HTkzhnQLvKddyQ8iOPOXUKx^N$Xp2ep{6hgSM@d
z;FjE*2jrK1(<eO5A-5k%YAM}+IPU-4>l#+@ZFmr>OO^wCH6oRy;v`k2%>BJ-H5b6y
zkk!~7c<&89kv#A!1EKTcO<@7(RX%Aaw2SrPKWggU@Q9pF;FboCk-m0#6X^>~VExCY
zx71^kSh0nx1sWKGyk&c;aV_A%%W@K_=~Q7Uu4bi#){<xC9v6v)e-gw}HZB54C(!?X
zl7|DLpBS7w9b7U@4Mt62Ri_#mvnSm~Y);A!<<`G!#ug;?`ost#*rR#}dw*&${o%?|
zG;&4(;-92-?(q^Wo#)XNjsHmh{$4W28QtrE^VC!Ke#;y<$;gVO9jXmWd^Y%=2+RV2
zXszRL+PGSf`;4b7GV%#m?}fx3I|F0#t0>BiU@h4PwwMD+o;TnD2#W=b1$)E?D(T|O
zxR%5cy5o%r{}D=2CYEnbRejJPV1;PEuQ_R6z3>_uin0ax1As~m{gZ!C4tOd$M&yab
z3}WfYr*qXL7)ku40+>wvgt!jWJkM@XC+@{vsjs<Kh{R=KJecuK8*f_QMmw#Fo)4s{
z{2Ty3H#_wCujY3J=}eH1JM)i0T}_6FNbGZjJm3xo!KH8AOHkAj1z?j?A+jT7AfVY;
zKWGIf%^;9I$B#mwqqEH<B%Huo?HrnQ&HA)<;=3xBaf|*QyhnQENXl1NDnA$bJ%58Y
z)E)pFf2u?e=*htbJDpo(95RYpDsZI&qRf_Wb!s?&)HP1obJQ#U(g>;U(Nkx7+Ek9R
zK!ie>G8^+OcW+DNe9|QPUl59-yW><M+NVFiKjH0mhm*e!)RG$?^(b{Em}=eofDw^o
zjaFbc<(@U8NTg<Bt*d6<MJK5AP`TvoWWo*OHYM#@-kYeGnjgkU6zxU&GUt%EUKfjS
z)C=L978}q`lX2Z%Tu)YC+xfgw?{~eOdt3C&_!L?gX&#&nV-W5Zpax@RZ9X0J`u5Cp
zDuyk;m5z^TnU@}o=`ksMF>8s#`0(<cJ%7Tt@<oRe-e<EWWsfD+asj7doK<6IyPsS2
zv?TE5ByUvnZpM)2`S~|;&r`C!ExwyVE-c29>&;RS2*DDu@2M1j>^y`O^{d0$#PKT%
zz}#U8r_lx_H~%oHfTbGx2XBPG#0CtGZGdcyc}#n&vF}?csbab<EbDf;Lva*<ey{Dh
z8>-yR#(+g>Yg+abzPiUZm0^?{l;sT@Yq%95wX&P8l09(IY=rAJ;MNSmDqI@+$gcTK
zS`jnLDS7b5e%W_o!|mC4uJ|CnKR&y9d_BL$<Ajc?5kqWfI_8eeWv50l0bAx(GYJc4
zs-9>Lh@~D3_)6ic=PmPm`@xsYnB2BESzOwtR|0$oy>qIh^CA-OxV3W))|JlLwQ(SB
zG55gxM*QEk{t(p9iuhWU6EgATKfSSNrlkP+0P)YGYejwJZ(780nYk~y;8wuV^UOC=
zuwf-YembZt=jHAH$WlPzZT5Gt@-79-@mmc!8U2tVH^bkF)%7akrS!On@UmplI|jAT
zA5l1!w3k00!=5dr<5K{1Su(gMK$%dsN(DYIJiC_}^Sc-N)g-b4{Vf&LI)9r`+e`X8
zb^Ib91Rggp>g(S|{lfE8MKG3U`zwNzDTp2ILwQ8PH8M&{333{e5xzLC02Mrc^XVx&
z^@pa^qn={?InmED5c+&0MzwiPlmt_=`4YmZ9(NpGMz+&P0za-yY9vNW8WtsoLJB~9
z`}0A}7V%50k7>iiMl)y0X*sBDBGDudxkvZ{^c&+-?s2X$(0ZsV064iCVY0Vs{y8_v
zpCpbtFYS37V_$Jty9zaf#%FGHbw{5jGE;j-100zJoM!>Zgd5ryJ>8LW!PtgCA1YP%
z?(d{gv%zRdSk4m%6h85=Pq>D|oV7;)H8^RB1zgE@<hTM7!y18QbcxP*y=3Y!-dH4%
zEZytcfOtWpNWFGWzvUYG9jm}X{4eQD&3A2Iweez@2+JE_5y4bpR?HXCOx`_^gzj>f
zbX`!SHDu#d#4H5Gt{nL2yqok`sZ;?$J>5Ea2D#b)Hc5?easv7=&>(WRq!HBUVd_9`
zL+vST%oosVY7e0nW}YhWEhgN70Kgx)5eQNsiIlXm#^Cc?sG%&M@O(3q*opX_RqY`F
z+U`*bFsEcz#xOYx-W2});R1Ff;KeY~Ur>a_NzpZuRQQ7aj$Z9@Q=Xs~j&PK{2Kdl5
zYBqau^Kqy(9Hc(<$3`Try9|@nGbHKvQx0=t_8hGW5hv_R;IV4h)RlZo;9-!n;BNqS
zLZ4^A$297zj;K99@bJBN>C>D-jnWyaM|cj`0XJW!3ej9bieRx7<UHvQVg8V#!#M|{
z8rAvwN+AR{R(e`tLM2+je6E-9hdG|uV^DVXL*nCP%NkII;6R^EpQ<PJz7Cig4K{cY
z&7lul9CfVeVw!T}ad?-)6a7$_Ltk=TGK~01>6|1sdhb#rh39MU1eX!<<vCjkaRG_g
zpuHPLkMJ>)Yz_9$KS;4X#HM7(fst`0xZiEmqLCoZAWj??&cRX_&IEY={F+y6R(Scx
z^2C&9pYY~v{$D_1U>U8(_<X_ia6e09RftbV)(KlJ(3FK47ie&8q@YSqtgnJ3!el3G
zgLsF}61IGRi*YP^`6vUxi;W+=GkdC4NL9*gfPn~UJiwb+GAh^jMM^=ZJB*Tyy7pV+
zPbTZ2u#MFZkWVj$_$K|eEjaCdGt&+TC?_7P@f%epRC<Q3f!SNc!Wrtr{+DEBDa}p!
zbSLRyW}}OasZjFz^%$1*+Rf2lYTV<z5xDs(;4>vDBTi=MoP=Tx0M1mxnxdng3Sf2T
z-mPlZ=etz0pN@X?s)(L|eFzmQ$>(NAM@J!aHnJ7fUBZfrgu_}Xck0ql?2EX`RAY#)
z&UkY;lO{u;x(&;zIi3e^k1LyBa8<QUFS#tP2)!fA9yzIm8{YBvGa;P0pRhZGYcM@;
zwN8Hr3eI>uA+BtELDrMsMdNd*?olH&o-^;F5L*%XzeG0QMqaSdD<;XC6nJ;Uf65bK
zPb@5}2}^Z{O9tbLoAYJ=0pvbkLMcr@?njChM4s+kaNPQkP^A`xT?>0nv7XEc-*ypa
z*|<u%jI`2LfAHF<s@a7z4-vu<u&+(7VY1n8<}~`%v}22$1@;dNbbHuMh;uL};%B{N
zC7HDVV4w~^Uis^#%62|#?$&CUdZ9>abo*@!rn&H><?8mQp$#Y6UYm#{18xG2LR?RB
z_S}WEJ0gr}pEMGG8lYH;^W{m4=6pBrR*EYB^YZ$U;Lt=bj(>-daF?2X_+Z(~9+}U4
zCCe+7bmmLr1g8R5^jErov(+pUN3zl{4PW9jA^^z-jv%q=SS-Vam~yY;a-h6y&xW@6
zZnjv0>_Yfdb)3z6cMApur5GdweD6L}x0g!=q$4vLpsaNl0B{SVSYI>{g*}-eT)^U<
zb9_s*r%*V6AB};wf<4`ra+S;-pMmrQt77%NH#NNO%Xga@>B*B3zzweYMa#<0znk2_
zg+m64%AVHJ-?JYA%nFPenN~6r6-r)LdP8>a4uE<X+eeRWh<Sb22NRB-JxTK|%Iiie
zlAF(IuRzi5a^WGcWqcVo1P@H#nHK)K20Ol4-{9#!q$A^UT3Uc<zj~4Q$*G#C(c2t$
zUt)V!WQX<<`U=YGA;~fP6_LP$7c`5>McDJ(q^UJcz-Vvuw9`a^DN8-eq`DV%{+CYJ
zUiczsL!kPA_P$~$DEh6t4*L<EKZH&1!mO0b@6|$AH6OSTm-b}h8{KD03Ehk8mp$dx
zI;IXV@R1<m575xiJIlcv>*f&G;#RM2Ofv14K$0`48Vh(6iF5+T-zU~ua9y}cycdMn
zP1{%Ezf2G+h-OWF_<TT(0}K5sm3wk6f_r_vkKB^0k>20ZAIYBBX16O$yx<XbaAuz)
zG0~Re;B%%N5!PJ@`3-eo>5Y~QnpeUD8mHrxrN<4}S$!xMd~au>BeJk(yVc>?NSbnr
z+gjr2wAp4s6G(s*(8=51Yd9ejkbDKeY6Zh}02Q8}dJ3C(#{s)jbA1=&38!=FJZ#%U
z(cmeacl8e1K#H~0S{*kGK@u$90Kd8SpOXg4|LA1#GAgmJkt71tA)o<wSi<}xv|l2Z
z9&4*bKJbsi7i>4URn6r7UTo{@eh&Ruv*z}g%#ZT)iaNAB(m&mbX^9!}U?(zkPF+32
z!t2&fkmgJ$TP#<l;}p051a|k$b`ef|`iKNmURMYO{@1#$W9Iep1xLI0>FpRt!)x-1
zQBaG==%<9Rl@DR$#`L`b(l?|9(jpGtH!GVAEKp`;bp{46p@l9JKLXi~Iy*cKBQ@*F
zB3KTkzuj7*DQ>Q7DIq;;lcS{xn)}dsqvW;}^X~gtK^<_;Lm5!{BBaFU)5CfU+AZ;5
z6jC*1y9>`=EjVkpu*PNi>o!jUcMFA0<osPWaBAheXwwTyVeZ%HR;Z$PB^;ObJ;Ke=
zr0iMROcz>x1np;TaC0W~dCQll7-ES9@I0m3K&n~xhHWQ185o(B2pabsI$tt>^U7B8
zf4LSaf%cs@*_A-l{O(h9w0<T)9*l5HqFhTUSLw@ciG&3aq=bgy0%sin>P2~Xeh^b0
zdYe51XrRxau={8~6Ry9>DC6T;i1DC)QSaze?07&OxXWB%PA2K?6SX+fT~fPn!r2~+
zcBPgD%xHgR7aYN-B+deSac%$$LI_lf!MnMa|4oJ)SK3-7Q?!^hQY}uPG>d(Pv1o%A
zcdttQd9ZZ46_H<I^^4Qi33H?;qc0>&0S7YE^sRXOgD8EX^*&AvXwq#!+Snh?D3acP
zA{)a+tX*5l+rB9^nP-cG_oDb-mwj9zuNRt_{oUj2xj@W2z0J8x$*k>XsZIhF2b_4c
z`}raC*OKpL0+<sG*O+$9`a4@Ktz5W-Eh22*b!gqBATagbYMDr$E*|}z<es#ky7q(Q
z!-)NN?d{QtHe!n5QfxcNCM4IY_at`YL{iikUR0^DA8(6QQecG`1a1cT8xlYM`K$SK
zj($dr-#E!P)rz@;nTHrEQ_Tisx1s1;aEcf_JrP_3x5Lk&Qr_Pr;%{rEGY*h^xmOwR
z)P+1Yz)lKtSx5t&-&caE5d7+;4x9Hz_FSD7hXxE`k(S`4Y|7Lv8JF)4fwy>Pjz4=h
z5uu9X*p*^JNe@as`y;DA5PDUa9(3LjYD)LQ4<x-HTL8Urs_{Q|8mI+6KbY}=$;wNK
z;fe-d*&!3vBop>CVG@QJ-GDzVAom?$vEh!Rg~6lLO9W%emHsj!lZkhhS$;^_bJy{c
zQ)ye)3F20niu@0IzH)~rmpGW%K|#v~-O;eMiq6!-UGDZ)+rm8rw}C+}(Dn6J0K3(h
zgd564+qG$mLpE3alpLShc>Inn;IX1`gK)XpgJJzOomS;ZPi<yj4=$E5FPh?9Xkwlj
zj7R;(71geMg)YYE%jwUfA@s{HtqU&38dlp3PQGZMrH^!^&tCdEHmoFXsiMMa72>@q
z>zV(!MYbq)^F<~0oagrlhJGsd?+Ttlpm?^0NuS*YJ$_&`L5tfw=rd2#RtY{G-i?ly
z)=d;7G3aq9Y$z6s=2<@72}D;vbw1S!%P6$tRF^qn_qU5=b@Yf4hQMNaoo<guk?|Z!
zl<Y_9r)L5QC0=dedC-)=p%L3E8-iKBmC#neVa;H>{xmr$<W3SC{<N|kDQM!YN+c^<
z(Bx{m7MUjCBii{XF~g*P<41@Ro}}^dl!5L?79GyA(O~z26V^W<3vwDKht`7<71|36
z-+4U-tB0ju9*C6*S!PL^k9P6;hP$3o%0ozX&0zG~F2q&s4~Gyyb?=w5pg|mecf_;U
z#vqb9AXZ@hpj(tJ6LU5PioGah={iGT+<yU(COp$Ke_B=ntW=yqXgI7?2=_Tc+GA9u
zDZg@N*yfc#tO8hkTsaJPxWsv<LJk-Nul&bOh<+^zUCV*3@>ehKVn{!PDNEx@K-R_v
zKhqk|S5Z%EZq4FioNZ6Ev$+=8l@KEG#X=$XZUfrCv-mDC2m#nxC`6jjW&(UP=nP%s
zoUI8<hU%IVE>z;E9y*QakBzrbeGha@%sQyF-<J`+aml7B!Z%b^^`p$R;fXhqcSqjI
z{|5G#LX4qbQ6=L{2He*K<&g2Oe%@m~d;#DH55GdzfwJmml??J)Mud9<FtZSCrYt})
zua3DvLWtZ<4bhyEyzM5LCgv<DE(PxPU||Mag)UWBUIE6U(NWY(kLIrXQUBagU;1YW
zi8X;#)F@Q~dHywQFixEGyHp+et_pKDGjTotbQqk5_D1`KQ*vVFZPnhZ%Y{GKBcw{I
z!J+)nK$of4Cx@Dt(NDuaw~5&ep1g}1^%pM;)WZ41p*k!8&ma>FQ|m2&k(Tm5$o1eM
zDyWq>SMrG(0swpglUVLBJm(goW=11P!?7Fej-4V;$B5Yku9PDSaM$N?TW1Ez0k|$*
z`$}iB+ZfW$->3)zA@M%$0|fC97Ac}{lQUXyPbAu=?>fAwo4Yi$Ola4VoRuBgT|j%Q
z>%9K+!&$WU2<(Q>&q>BZG6}muU>@1PiT5~s=)UJ_4QgsLP@YPIBaMYkDxW=;ptS2W
z|KyCi$BK0VD82Fz?SI&CaQk^`kAr1`_!CZuh5V&wT?~nw#B;vy+b1)TlGure9|^|i
zpZ!<T(st{FXId0U)#WaNd7N>`HG&IVvjpZlVzG@uRZnR)*hF=#`agW|w!>zl)Mc3u
z7An6<pTz07OEx31DVTv-PF!%6{X{#r$K)$9;H&h|%o*^Pb^#9-aSS24N=>AsRc54p
ztC&ki@tb<)xbR&r9j1%Ika1%vDR$rmwQV=*z~c4|fD<$QF3zmc+>r<n`sHu;43@{2
za{}F8@!L&M@UmxvdP$UNfL96xApT}D*st?HtglHWc!qwGiH-iIEbIAGLq0-?a8Fc<
z#U$kB@7QN1RyWwy$5vO#X9YiPp76~s_GG#Cl&eI@_&&fK+bw!`3M?cU<lX}e+@%oH
z{VUQ}yWOdtArv1GQ1c~O50>L-GKjSGPUO;11@1dcBmB7QW@X0uI6IwtKjTFzfnN(}
z#<{ZFC2>aI{&6h7y_}@OEPgSGJt)|Ms1A|sDX8+Q?!WV6@gntoRcZr$yn3wp?U%%M
z+w2GZJSe28qfxn5EQ3ii7uos-bx(!hH~sTj95+k60}qeo&n<Nxw+ruTI3>&I<{o^O
zK2<2hJ+WDfW<me&6^!J!lH!REGqn@+0pe1smAW){*G*HvOqRdO$7dfIDceb3n}_CN
z7(9qzAh0DL#Gv%IR;XRmOI<Qdgi`t{uWMG0d#Z05>0UByWLYjrq=g=DyElA$!S`u(
z(}Q)jW678hB6@LUkQb(S6x2(y#w3Y#F>)p>U$x9#3y;y42-jjEendVUXakNh3-U%y
z<ts;Het$M;pPe>O3G($naH%PWZ{KlUS7$;Wzl@knIi=h+#(VP9*84PS(eO*xl|2sM
zDnPD{;m$KFar<x`uT*TQaIoZ+I^Gw7;Y?GN5~a^v`!Qf`xpajT+YK0m-r~YBwz3O;
zl*1o)$%SiN0o6`5VhE=(v;B~vB&Zj>x%TZMIZX2T(1W`^Jp5>YZVV3aZZF@YuwIBJ
zSINe)(ZFtwHWtR1gr&|TY@*_lvoFHw-f}()=F62Pk7&ag<7`$!{~3#prjsBYm7GGj
zCp!bLW&yx^oY?Q5NPp0FmQozpV7rR~$nt=Ec=B|dI-Sp%6*zTn&R42xQTGi<f|+F)
zsr}&fS6ZaW=~4nUiq?Z6wTg%{9OlI89y_oafb~95<*r!5ELsI=fWKFH(c$ZBv<|%e
zLU_Mc$15l|8*qcuDaoaxQ_&YiL9t+sNpO`Y-cVd-v{Wu9<$N|*&Q{T&up+Ob+)*z)
zatHM#fwv>uYe0K@#Z<>CMxT5?yJtJ7-chwd{ci9<E!xRT7A}0Xrqsm1$I*6OIrKxz
z;`BH5S~IptmQ|<#=|*La?=w+$44V6DT)zd7l%}ZnWa~m{j;L5mO%*&%A7*9pR!Yg0
zQ)`ia{+4{N+r?gX^2BCDQO+=@RVf{j7X*>$I@rWIWtgXVH=qTAEX2%LpRhLFbo(Uo
zrCZNVL9!9e-H*692xWoR3yysyf6k7;z(3`^ZAkG=1R<OyoPuT;Z3HH4uJx<(x6&#M
zPxb3USY>Vks^h(IsOJp^?fNik$=72JLzBia<G<gd-Sy<&$!gh~c|m@ej(<dZI|!+A
zdiTQ{Ck}n2kvLKzpVU0L1y3M$95ziqCn@tki6ES9sbLm(zby7jLJuXK&&@orUe3B5
z5<vR+_(9PkvjDkkhyM&$m#AnRvN+N3bjacGv{5fMg=*uJ&8A}oDFJl31yI|t6q~j2
zk=&^$&VsE}HH9jU3w66q+)V9+IK9&E?IOS(6Mxo+XbVNrY|Nq5Nk?%*m`%Y|XDTYE
zzV`~3Z}WdD^xJEBqOaKR{^Zcq{GXzeR7D+<?*k`?CF?I=B7puVWWH!?$Ci)yaRTqp
z^+=G=&K;wx7%|_Q82wD%_1|HMs#%Wry2^iSFQ1$8I{2!@7)=x#;Zz9kME@ri^b3{4
zLvc;C1+sr(tBp*u_%N)jb)WkRkI?7LRKQQDSzKBV&3u(|p&eyouhA_8iw7Vr-$orb
zXUv#V4+FOFVYg~O)2_;3C|CSt0W$v(FqhCFTVwMHF;mFZt2?qW=4JQz!U36!cNZ`e
zwV7%wlNwAX6>srVN*!08J8r<8Ds*bm05oOtiE{>ox4dp5)k_9UldA0DDJ%ct%;j!#
zWzalgoi%&vL<4j>jWq6_&*{<kk>WWA^cHi7mt^!Fw%&u9u?jud^5+Dsa^#QbVq<0l
zt)@CzTmH^{I2iL*l~3)Sup%)NW+%1HkHjx9)RR#iQ(F|<Ojh?KVcL_Vjou-k5)WD~
z{I%JwYe1gk>nA{=R5!aH>(u#RZb5v%bu`meK3R{zF-q#00m4ha9xd+Nyg@U`KGJ>;
zBRlMX5I5u`KAJ0=01v)K5>nSbxt1a;1rpmsCj2w+;fKma{J!Pd<^?fXkldHGXcXA4
zc;c7E(-{V7;A${=H!f{e{<<!)e2mg3YgRn2V-%DJ%^G0OWGfOrjD11rexFxL(EiyT
zh_L*#XJsSp_Eoms5<enJ*B%}Ueh5#|!a)dEno-=^Ob=za@N-$OJIzn-?(*yM?elEY
z8`?RZI#^`O$2qBhFkUh9OHT#>*KfSrY3jG>_ELL?43{}>^5s76%#W{>;?1z2-#s`V
zJl1W15m9o*nhu4Un>|Pr^KU^~UI?AU%1=LC!qQm0?~E-)4E*C_CUTeq*>{=We3YR|
zYM+~=YY%+k?F^8+M6qn^;5<>(l06qXl1dPG<;2i!;cwbrv6K+@vU4P0TWijsF2c=c
z%Db56=8P^?B3dBKBU^h>OVM|R#eeG)AZ+HA-&kt%_YUo8MVgBTuXh@7k&+aO<^pVk
z<L}SV$QG;f46+&4<%iz(tUN`4syp<3vzLEc=jXt}fxg+ZOC3L;aDb}>Y};{mp`vpW
z%n(DM99*44ZW@m~5&UQs9&}8^ygZ|+rE^|*FYm>BL76+>FM6K)`K+AvLBtCzBaLWW
zUtqd;Q1H~kQrX3%{bQD^B76U9razcoWk=aA+G|Z8d2G&nYDAf#t-ez7TS_3!7IGcz
zFYk=``gs=`E&x*a8~bMhT_dTd7-zcka=%^t<PBpBi(S`<Rg>#S<QK|!Zf@;}#E(en
zTM3QYLJZflv>(CMq~n}~21kmbI5kzX-az=XCJ39@yxTqLfj=13wy?Bb1?&&)UsGu;
zQ&8K)@C!u!WS)dO%ie*T<?UuEK|fRdqU{efhC{r`;YCRbpm=OVD*%SOY&B70yVdYE
z?b~51x9|~upX>pH>-SDxQF-1kl+!?YFLv#_s|m=Pv&(etRq{SuQ7yn10m;LmeS0HI
zijlKMzqG)@(}Nh(CGV`BTJr{G0wiwEal{5VV%yG9b#}oX#kA&mZAEXNqCX}dcORMn
zK5)@dAA_{~rAgeXa6b3FeMB&wHtXH6EB?m%%8sgocJORmp$qG$`43T(Kf*K}u=^0B
zmnH*QUt>jXsfsW^xc*?!dl*<~gLZU^uU?qe%}k1q$<YlqFZ(=(89YjoyrDIqsHlyI
z3#0BnoO9wnX`G`lLBbk>3T!KATSSg9wR7Is&15J8wtM}jVQ)XPb8HeLw*U1NFUB%S
z6-E9#;VJAIR%oX9MK<MA1?-Bbsw&%K?iQY&h?}Q{#@>j#H)sm;ZG8Re?Dx$0hT<Pn
zY-~9ceG=GfoV3`S2v}@o5zZB)dRR4U&G@ViZW*SX+h&ifC0lp%epsWI@zQpXpM5IT
zdb$lLIrR$)ZcZOtsfJgpY<sVBcG~d-6Td9a{e?5&p<_WDG)hZGYWPvmEnQIjDfYou
zH0W~f3@tMqs$n%9xG5!j`!Qp-D?WCVeEH-)!=fmKwBe8#XFD|TnIJSMD(c!b5RuG1
z+|m4<aCCzUkk>YzAdY)Pw>7HK=l%ux(P&nBd1ZWfdLn#^*kr?X)2Bb(XAZ*{xJBU)
zuR*F_6n<}x#5`Nk32}l6w~BkvRT>v6da)MA){<ft0*&(D<G-l@6-v5>zqv&EJn{DI
z3Zs4Alw^re6U8cDB`97a6n3%l0(L7pBOBs{)#3dK&Kb;7I`LG-vkq8HF1IOu-PwZi
zlbt4hm!Zh9a$ql+VjfY*p=lnI>UOOSW!>Muyqvo9Ei8~U=+9ogLG201+L@UtkvU<d
z{NVUf+L^a}>Rj9EIbh0WOH^TJ6W3RIq=4HX%R0my8rTvxm92)B?)KwLSq^oiUM2xn
zlSa)6-a&aj$P08>!}S&H4>Ns&_gOY>=CibKXfy4lTaRt^5!Wao3nb4Z7eTT~C)_g&
zLoj(FA)xqfN#zr8^|pv1+VIT8lG*ZufE6Ogg@v?lbfl;k)ZecE;QW|pjQQAD{??P6
z(xOLLXlbjlz%P_+s@n|9lyJE9Cx*HRr%d#7e?ZCWgoQDQZ=>#ygor_`dPumG*2$lk
zQT5?9;?||$mE*OY!ixPrUT_R;5TtWd$M}#{74fEO>wL<5S#AtOulQP?;$hZcUsp@l
z;YoL|;V)-C^a+smd4~Q1im6Jt>{a|M#8xYTQk?#lbNtPX#>)>;dt!5F3y}uXwd0+C
ze1D%djHPV8U(K14AREI#VL;c3kY7?c_9{(gx;K@y61Nto8BLwWj8|rqC2mE`4gA&c
zfcxIm>XX#P(>8GJF>aAI{NoZzX6*4FIdJv8r~G?*GHs30cfj@E7->=7ZJ5*Gum+7f
z*Tu6W)Nc7{19w)*-6tmpr(S?z6r{TqONp29%?g6z+*meNfX&B<uoK}~4J{obYjkL?
z-gex}Ed$m?3h+^#)qes&@CxbZwg+RPpex?|K))*(&ayFm?x-2~FMGj_ui1YP)1A9v
z1;l<yugiBrWljRvOwGI)s7V{#m++qTqORkAXWkUv$5i&*tImKgcmT<Fz?T?9PMDk3
zk50VA@s2ZPMvHHktF5ol=0M3|lHBdl^p`0$rAS!ea^I9|!yA!&39-wkeCY&d!n+bL
zz4qv#FW~2=Q?1|m#kp%_i!}*e^GQr&cg4~_E@Q3-+jsriLxkU`3O{^}uYB|_rYFV+
z=Pe<yeOa<@tKRUB5N!^2j+Mh@g!GtgoB>!n(cN10N&I8J^?a+g8;~MoN&;Z0#R)%2
zLg%~=10_7=sb%BG+3+_WSNAYah-PV(U%XEwQj4x9?;eL8j<Jqg4rJ%0gx<l7w{%eL
z<&3VwrQn?^%KIvyEbqOWUV8JOK6;@8`Wgwwm2+_jwqJ1ezH!fz3!0fwZU%XCd{2zt
zkaQT2zDuY6<_w=9%h{$5UB}Ne$DHkN=W5ZAF!J~Re;l26G@I}L#*+ww*tJJuua7;e
zww5kiOHreCRc$pwV$@zm(Nep#rD&_IP0U)QTBBxSk0LRHNPhYL^3QY5oj-DNo+l^w
zeZ8;ideQxiVW}%fpJdXm@X+j9I3p=O-90BCi5)!B!A?~~q?v&oX3dU~IfKkLDOj16
zk#9e8jny=sjOAMyx#BE%`HNA9XfDJn%KuK~%?k#!k(zWPO>7bFK20wdv@TnPxf4@}
zW^hLS(6dveJ&A6Td{O214eY1C(ebdA;3)v1Jsni&UZm-*$LDbhUYBeXwblRNwb6B?
zEr04u<P3HFJbIm3QgT_2rtKf&SaGf7ot{A5<CJLLbUK<)1jzR0xn?>#@bK|(M|y;_
z;Z90zDBDV{^f-Eku;{ZgW}+`+GzS~N7T8tu(<H|wj*?^3Rw@sqKH2ja>DVP?-6qE-
zVV~(e(Kmeb(#VN%fN%CIEnpgZbWFBEsDBTs<nhTDCR<f^BW4sd6`ionNt%2U39o}$
z?W2OcZ%>XEv+?)ZkU45txJuPbULpIspX?%s+KP^kuAI+qlWjZb)e(x~L#=N+I&>fk
zpM_a&Swt)uB`V!|bmWvYZ6hsAbboQ)9Ka(iy)I-2IUe3mo6}EOU+&DN1at!O`?3dC
z%9Ai3P=5`dr6P0n`^Cb-Y$}8(1$6hnh*Q`x9G_ok4|OJn4sl-{AA*+-hBRo8DjZpp
zaW{(KbS8b|1Qjp+Z>-~Vm@$kpZZKRCCa(FEXtHeVbPYm1-aG0Xd7xwN06^DWUJfLe
zKIut{jw}q=G{9t51^(1B$<SpSj9p594-o^uq1%K83#thE>j|K;422;ol3&#M_{YzC
z<o+es(Tw4oWc%aN;<}={V<gh4y6l(-GW)TApU7HmLZ2X5F&2SG!Jx~s5J!2fFb8I0
zyR{QX^#e5b=3AVTjC9OR${?@+664?|E(3O{b~Goa|8j%Kg|aYQjpXHt12sOqj){q5
z?pr9mbEBF7Z$khmA|ITU0H(omYEqT0EnRw66V7fm-RLn(kIYRzMl#Jl?e|w0y!xN=
zL$oMUZx?0MSj$R#yZp)M9UKYdd-Ix}nEP1MxR>fUD;1Sw#O;tZd7_YI{289Q0W!mH
z>roqtI|_R!WH?<fxXTIyH8)<-mO1an--LktvrH0+VN_(s#WhK>TdKM{@y!8SVmN)q
z;rHf8s9CyL8`M7Srm+Sj-XYrM#fjeytj~1@X6bTP=S3}Qphanz07a=F_q;0h;0A#D
ztG3fiFyC@j5^^4|jR)3Ij6SUW+8~vJnZ(|w*Hw78#`5FW#yr(sCIQe0QhnzV8LdCy
z=SiUftd^oI&;P2EnSzsI3}1+mJGQ(DxBs1dXB`&R#AGi%c*gqd)_(qQ+{Jgl^|6m@
zt9i-M_P6X<(T-+=Orba@ZKK;HYa-D`W>R(R{s5)Om@BMTJy1Ey;rNV78Y+J<k^Vw`
z82V`-EOYsyV-;HW1iWht+YfXi8pg^pdg)?Pb7=Ib_u0Hv5Zs-yyk?UAey{M2z@NX%
z`+Idm<GZ<JU{|)bCWY8rs0R+n)A9*g$39ss^n?KU4MM~$h;eMHtci$#MJ;TzG)3s>
z07!(uTsWq6va)+aM+3q|km@)}E%@~T!v0zV3+`?*beO+D$krI&(-VGvB`&2umR>Ng
zp4|73)m=}P;t(^ybFb7GQ<<^f=K$eO2YRik{s7UXr_L&gC~B{-Q5wH!ar(Sa6|isr
z?zjg>*W9d*)%427mx{}|g_3L~W?GW4)u*n&i46#IqN|>HW9+-cuA9PBb}Y1-x3=GN
ze{{mbQahB{e#J8aeX_fzGS>XfdZzpaQ0&wa5Z=)I@qmgs3Rw-UJWyks@UtN|ts}jQ
z+%v@sEEhBoq~--GxRlTXodx3&^JUD;m7o%QD0cMc-<`GBC3~t6g`RTnZrn?1kD#;p
z{M4DUY8f}3JMF`LBV<#j^_7ZYobl7sTYXl!`+R+>^8q^?78blo-Scgcn$xl$YlZSz
z@tj)zoTA)|qqr$LvX0}YI+9GHV%fDRfzVDOi_1HaHe;5+{@oA7WP;E~rg{La{u=I&
zW@3!uk$OB3+3iG!qz~KFJ6V{OsfF-CG=Znx4qk9kj?d<~=2T2~^@K{XxlVCbgcnvD
z^UuSwmJ}c}on3vF;T{2I(K2bBrJSsR5pXW-ye?fRP$mPTh<Ru_rxRz5ZTwv>o$LM5
zDV94zEJ@d}2RoXe6%p$wkQYbfa>Zm@q{eL|IuqJo$i)aL7<OYE<uQ2)N{m;i{0*nA
z`gZdBXCM8Qr`uA7-PxrchfXT!;j@#CfE9nV;N<S}yEH+pn9oZpPohWsODB#)f_#ms
zxiWTZXccS~S_%b~l)~(PCFC7?e`9QZw^Ik~(m$q1(SFuIUXE+dp<rIa0tdDs9`Cb(
zrY>$d;3piJ&Yw(sUj^MnU&{XgAAdaJ<-tJYcI^Xc$3SmAdaPR{_9a@sr>a`ep5f~-
zTELe6!3e>?rO5wEsg@gy7wxU_(?NAhftOdVj)7S*Nea&U&lJ1ZLEO!wi;?^FncUUW
z;7QlsIgn8pZjMa(+1|^bYv;w6pN75_S}BQt`&?!uyX7>wLk3!!6>jUEn$+F?C<8m9
zDiP&!l<h(;%w`L^%l~d`4l7q1`nry7g}Hb%fdpBZ_}();XoRZABzRZ+LwJU!#pPxS
zXpG*Qa$v>#$L%M<#yNHKlbd4Moewo+Z9}gY*9U9)wK>!@Ahh##VuvD(#KTs(wcpjG
z{?p$OW)m^}=@o}f1+sKl$M^6!ix{RBxar0qdlz-IN~f#FbtxfEj9QQu!_FFq^WXG(
zm1mf1LE&U<>Wv`?=qIK1{|hhm*2jQlnfqiW?D}szfZw&3&!tV6MLg)JFzUrF=Au%e
zaA`7HG_3XFIXc?UQF{ZKUWz-_f6wKtr^0v~#X{5biRaIcj4u+NM3cM4=xf<z9lJU*
zHvEOw&2Fy50_uT(`I?*a(hDOw^R-W#0#TKayN^1hn;t(7_ss;zThm9=y#u##U3~Au
zooud%w63elSllo$Qd6@|5@|a=m}?}7JpOX^t)3V*NrXV=#h|=+vmQM93MZ)7&v^YT
zOb<(*X?zF|O$5G_kG)L=V{oU^tHFBVBxY#f3_NTTe}(W3hREan!p{QiM2=AX!9BRb
z8qtB>3(mgQ5URtsVl>6Qr@dZ+W<>QIK5g`UZ2Add^gB4QzjOU>!5mZMh(~_H$5Q@S
z(6<R`C%js#iE#OGxW;?oU>-x)?&8&G?j!xJs8?9E=Egx}uNP#{kp*%_Htcvpc6f#C
z&1=qQ?F+{>WB2Tbm#;RAsMoKJud=WZS@Q?0Q~OFFk%kt(jhJLwB7osxzv|a<8y2fs
zX;maTEw?KS2oq7Y1s-Y%3A%9iZyh}NhVc-FA>E6WT8$N->$2ljk3nILAa7kRW$qnR
zc%g}k1VM5La;1!UINDr8%d^KJ{OD_TkICe>8nVT0gsg7VK@#f``IBM}l)NnEl%t9^
zdReChrMKExb6^HmlNZOB`%Kx=c+b{jiB|^_hdJ&LHH!oxtB{82^o$Nj1DMYMclR&)
z<8K)K)+}7B_}xk`N1sz2%K-XiPHZ9=I1V|wJ+Z-o8|gv?fq<6rz=VtE%OXVeM+q!j
zbD85p;7fl)<rV91GV#w`^#nw8V&36|2^SUm>8Mx=tgq#LX%r5VxKt+7`5>3qhB3^Y
zA<<1yUT#Q$jCq|#q2I)V+*BAfaqId}U8-NVx#=HU=;HQJHw3*9h<D-Kpm}(GKzO<x
z(Y0kYGtmwh=QID|TC_TKu6gj@Y!`Jc?_DuH5&eobIAf8BCGmq>b?n&{SSY(YW0U9)
zgO#BpF5<Vt<KY#L#3?80sVd6wnD3t=FQ(;aU-Hm@r}%TtYeD*DMXgt#-(n*KwbZt0
zJuS_>4#`t8YuhCWn@O!4)KliQPsu&j7%$;RBT5?i<ih@h%=r2uLk&3NpPU5cNXTM~
zVpV=xdANpC&%dIuV*`7|pXN4XuqBP1=P-70gS$s&P6L|4Pf7n;#6Z)p4IAvS7$W1P
zV*=ys1R3c*8nTIQ^0Adpr?%oUy_AyO{|h_OBF^-u;!G4Dx-wPgU2h+zr5PC2=vFf&
zF`N~-rs{dn)H=YJ=ag)T5^FvDvV16Ay1QHk@%g+IhztlrBOghjK{Dgoj`bB^Nd5pY
z12hyT^d)Qvrkm`U7YZX%#p;qzb(lU-alL!WbALUI6S=K&fBQx?5iZ^oSP3Xl)&DdJ
zbr}6elySD=x=K&wj1h|YJnADEJMw|Du_)myQl^%Z3ZTuR3S4urZmJaERXA*qK_-f_
z2&hgbQhdW?9!g5;O4xtuv~g|1-Tmm>*h{J3htpt_`ak3z+sCZ&V9Yj|-4&e(qCHec
z$1<1EZgBtWh_C!G5Z8t5xAzzOiY_hJYsR#NsmR1H<5kBsL*SnIi4|o=2@@T)(Da=r
z-s&wqkeR4zsdT|5oXskjq2AQXHwKLQ#ift{F#M&$@@2*SiUQyY-AXM;89LjLjmM0K
zLsqM5A=3suNHX-d?1dgE!D=4v@bSvLa*2}C2G$<Pl&GIQmCyuG@3KLh7dJWjx=R1y
z0A*&}%hGc#A0{d;2|wJ-zq2sj*=N`gn@by~*Na4vBKD#YxQ92W^9gtQ5$1P3wZR+k
z&7HTW8L!XaP!htED#s0mPUK;1yz;)vy9~p^I66Jhn(`e%#bs(UK5cS-hT}AoCv@av
z=wK(7pEb1Fhas4%Yrl{A(LLYSA{@i73YXOf*H*dCGrNub#UpN5)s~YT#h*gfuQH>V
zRs;}Y<&LT%X-;4jrC2Hfo)a)#6OeUhtE5wxta_spa^^nFxuKAsQR3Zi%v^oalw}tG
zJ>kuIk;qCALY8kdhIS%y67)=$-1DM(6lgB@O;quy6Msc5Zc~dl#Ao>s`g7G2+GmrL
z3tnabqw`RJj6sufdhEUcn^>$hQ^*E8`lUhlX%8M(-bDQ}DMfSf`Kzk8Mt+-FiwyV3
z2_kRL8@w7qoE1)h0<IwbuVK@Kr@A~*(YJM)JuDbYxy*eMwEkefJ;!qKa1mK=`kIF&
zvi!kO=l4&b(ayOUuLsY75i}mQl0O}8t#ati!ezA-bn#i|bTTo)bU*m@_40fE-MRZG
z5!D2*)*pN-Py0@+*Bm;)WZ2l}&tAmY%^bTkVC2k1)%M8z4iNkgXQ09+M+kxi>f6j*
z$DS|kq&K9{y@{Z*_O%44(#3xW3C`Zsl4)4fVt;kIa~cmM^LRP`x5=EVXWZSQ!3W7I
z+@z<wAc(!Wr*-XFmn>s?HA2_VdGQgahL@G<=d^}Z7WV03G^KPu9$2XWVE7aEWm&|G
zw#+}K|1UD>oQ%odaCOCUyIws>d~SE7G1EJ(c8Cq%wmy7^=T2N(URJ^{C>6rTw*(mU
zr#iuw>%$%5uSlp`NEYkp=wq(+jpi`nbehz!=F4Gv{2da_Sr1aXym$%HxS^9Yrpmcm
zccw}v%R?UyLbLnmEd0Z#rHi7JnBlksr;xraJ8vX(!18mD_B)qrCFht-5YiaAav~^q
zRoMp(dKcW(L1_#T;iZqW1anha&V_SP3N(1^(bws*Psj}60b38=c!`g7V(N3fMN=5s
zWz29tb@<N90#3xpE!28rzFdbxPCatdxRci}RSG!&KF6b^a6|BPT9g-z@QlVMo$s`u
z`T<wpqo;x?nMB=4#&v_Me66Cu+E#<q%b{T~`*Z#)xT=LF1MDd~4HXLh>Q{pBVLTJ<
z19E=<5y%EuHco-?eTxa%k_DtGh6$skZx;nl6Oo#@2rm^*)cZzt7@Jei0kyO-dKwgW
z*D;&NknLoGtst<X((G{BV7E~s@3}Izc=x|=(<F$eULf5KxY@xIaU-jZ7iBWEshc6a
zn!~soPih40RPI*`UMb!FE%@rDlzZ)EB4hpT67{DBwM{AG9)>@qDYy%n*mK(WH0YZr
z;n6FL<es8n-|_q-O60<KZ483z{gQoqnun_=YoV8u2)|{}DSLu?kXVu2j=SN~&p+Hb
z-1tv*bi@1VTElK*3v8`GD5Knki8#XEvFG^Y{eNSuwYS>>=D{Z8XgS}z14%^oiC&d5
zm}6lHSPit4{7CUB#kQKl?_i`!Fi`R)sgLi>nyvlipL1(LQ>^LLxhgFFh?3aI$}aqS
z-KazI>u#w^4X)S+FYHUj%Cg(shqnoR4jt9BeGh43;Q;ouE08h;jcC?f1I^z@cUgW(
ztMZn@;9Soe6kjAH4(ZQ)PP46Rj*b85vVT0NO{Q-0)#B-fy}Ayg4yD;;KMbZ(5r&I{
zco1AO8xSf5%<}#*)wdhuI<>d5A7tRv&f5;qW3QfZ8cbYT)?}O8F%X%aV2;lRzlr0F
zU3?A*_~q~7Ys6D5Bmn5u09klRNq+@m$g$p>3O9l#Z?e6k`DhDN5fs|!;M*e;92>1b
zG%?)g#2*`FSHi<dLihap?DS?J7?kMs9#i4Y^kYZ*3zL8{hP9s^^h!G`Kw&^`?mIKw
z^i}CvuM^4{%P~%mEglr_A3r$GXTQ-`rNs=2dt@bU7tOG%XoL#=I}%b=tiw-B3@+`9
zRgM*`nekPXw;_nH{{_;d_1I@VKwRY!tn;9y@?dE{;eJN$8wzI(3otF>(?0lF<bP*)
z^hJsh=Sfapvd`Lf)%vSVIW8m#Y=Z7wbI2{hTL<+HtSlcAgw}>*ue*%goo{hJUtck-
zg2f6(HQ;U(K08x+Lv%{u=4d!-GKG`YIrx=bq7QXXO-1=S+7JGU&<oQ72|+ipAM#Yf
zn>>lS>77<T@5aBI>AzEx@OTVK5TEmte9GIQ(ZN@$Ea+?sZ<0#FVzlMRWW)i5!3c2s
zXA$M<sx8brKuDpvo)$T<XzEVnwn>pKbBzV7YuzzW{Uu4z>oD&m$YYzL9eF*UJ@?)p
zDe2(NShD1S=Z(cdW)RclSUYcNcifE5xSlhAloQikgGa1Y1YRQU^~bQlnZxDhM!hk?
zE#DZ()cgr|%K>xoPc-et4jERh{uPr3_uOG%w&Gv>r*eNk(QxVI*&00`!>dw)*50ya
zv4bJ8%<ALdOtB``VN5>72kzXL_N^mmn&BWhSMXeofknP2fP+l^Ko6v)@u@5J5H7?`
zLl>*S<Cj*UUj#m~3}&v2`O4H2@&2Y}vm=xGn8?yf6!ua=vtftB^f|ACNHC*{d7yRh
z#ZDWZ$Zq#`-47uH&%*o{VXgBRgbF#L>}`;?oT?&ujZb6~%%@6yVniIoN`IclYcb(B
zFUPLn`LpMp`z2!Q-Y&YH1>QT+5?wB<1lu#Zto3Z})5p()JkAA|*3SvW?RY**3vEmP
z2UU4Lf^?$Jo8RU@BLZRB<x3s%uN8CLsT`h+O=iXl>h*hIar6ExCgC4YMpn@N+hlCo
zx4*b9qwWu=(aWE_)>1#n91U|CyD@3BARO93mGOJMtL?K-<N@223QV7%d;{os%iNK^
zLH+)xEL5YHrX$MR5G`2PN+c!x@-H4H9&4tSoT8%=&_yGku<King4gqj+;{RIwyY61
znd9B`q6`uk$gvv7Ius$4SC9^ND<-oiO!j5yKlF<@Qc#D$O7(7dS4~A)+yKsXf!vSl
zW)Ly1Q<C{wHaFpK?hF)c%;uKTL$3Iha(5}h1)p=pedMe7m)=qUmxX{1=5k1PpXoHo
z&Hv{m!<b0LvxLz0(A0sTIZ+F0AgG<X!FzLPb~=QL3^k7RjRGgA2vPz60~$sp!~)3i
zZSt=ist}7x03;858;}MVaE{}5X5{wjmj?iTl}hr^-M~g{dR8~^9R87TDb7eFgZ}_w
z$*rz&HCV)PV#FAk(Sf(DL5an&&lgGu1UPs0v>~X=--e)uCk!p6-Z3rJiNL(~t~hi4
zs6Y!;UFpBTj-X>C0leZmj)lI2VLBOyQ^{_dC*rr_G8foBfe_0MC-xb6TS8yMNT)4(
zW~1FfN_;mK^wa@R4V2mtAQ`Q#43Sb{jj!F-H6-SLk6*lLfygRf+{qERN@87Em1f%#
z)qm<A^Mji?dH36I{R=>hJm32R!eX>Ig~8m-B;&aR&dc9V`1<8rg+%6AbM1BqXWm^f
z+v)TFz<gykaYic4V-_TV1~-1_aB~HNNM2+ZoxP0lxdvk!FpU?9hFudRL_(UVHpdMk
z8=r8{8(w#bt91P^>L140iEs1waJlgMnYEt9coRO$sbIk-!$Dii%BC<bOn~8=&~BDP
ziL`cbbLj|-CU-PMgtVv`H_RgdvuKnT{oxu%7gH}QLT9wDB?T=fz@UBY=@S5q5`=+f
zw{3}~TiOb{1oNJuOIil?&vosD4w4sWxP5{;q?6vd^SrvjjP|7xl>3hclLO@7`PFz>
zLLZQyYFCQta7p%!k)tsZXDegq!@W)EhL%n;wU9QT)TJm7S*mV<<Q^>dqCam};N#D<
zM_|2SJwQaqMjjKvzUQ607)#HaXTM<sB&d|w8(=JODnmt|O#NNQ*GRu>A8)PgNLG!Z
zQAy!OhDAHH9!^<Qh;>TP4aKkDO?E?%xTz#inu&u<^bfbtji6QYHkp`Gs4}$}U<c*$
z@jh(?hm*V`L9RW9mX$jm(RllpQ6#notia+@iZ;z2>cJxn@!>}{BuzX+MCPm44N9qK
zntyjK0ZGHw?Ab>o=zmYR4{y*4$hS1a{#_z9I63G%h6KBf!(w%r;4%I9Hb<DD|FMuX
zu!~3Ezx6Y@E4h)6T#41$dYZ;^Xf7h@tRWAc=K+F}sXG!<m1s@onL9Ka7=iElGSi+d
zu|~G;UNkHC1Ju{>Uz7r({S?Y+qoticLG9N(f*pB(8VX6iy#;p`=hnp*f|Ts|y2c%p
zd=mGNL|I9Of)=}~uTob;zL@Ef<noHw{ZfYB^Kz@XsLTB>GZ&W+D}LtJXOoGBruIF0
zWB)U8<(+Tyr*z?0p_gRchmn{(hky!3X@<EBSwRM)tE6i^hqVq2QmnM?!<mJBM3G$e
zNR7=hKILUiGw`?17`^bvG5a|EMioA$k;1#d-Ka1*+Li)qt-Yapl}oY+PJdRe#Kba;
z7?=jgqJym6xyTGDS-Kfw!?5{^KgT5GYld4!CvE}S!y5DBD7F8GPkL0qR{-H1&s*m?
z3w3ZUTaoQVBELvj8eqfS-kVZZGqd6+A+G56(DD3qm}%(0D|G1xzC)d{XV&NuK4FGQ
z6Hqm!sEW#2G0V&F&fj32Ixa&ldnBQ7tBcb-PU&X*Vsp5yXo<Gx^Gn<V#fI7c9x3Z7
zuGZ^i>$zW>L_d=Wnsj;l$Au4lrJdIbR-dw%;*Yw`LLoF;)ew^EAV<6H{&$!RCrkh9
z{h3z<KP&+U;6L@hIzK~P2JkJkEJ*}z#GmO1-1v3xJ&7~R6!P@i3~QAheYr)cRmAuA
zWHdFf%IP(mwGHPG1lm{lN&cC$q6e5|RU-uRi_Dr`cfd`@j`ulpU@_;DOt;nDWjO@e
zWjRc_i$HV_`jBWp%Z!hu+j5x*j@tk*f=LEYYG;%V#-Vh~_3m<WQnEd=a!r!yVgW*%
zP|a3lqWpmVGfNDHS2YhcZ)`)jZ}?{%@`R@UMJSl&KuoiV9yu1LRuQH92XpphWgV_M
z{DwO~c#FNTUjiXkV93~gR21iMk$|-$Fk^N6U!}WGu|t=2gw4J6W?47RPthFXkZyC(
z*lS&?O`AU3TXJ)k5vKH&%v+*HUMX$Bp*qXs$bC^=#;qTkO@CL&;QL;pG<+>g$UG}?
zb`y``Vd?lE09r(LyZNPUv>g!K0~&Sa#nQ#nJk%e2?e{1ZX%zU#iQqBg5>Z$E>lKp7
z(*Fu6b@rK9JsPLT%HMJeF@J{8%^mU5dwM~aMbKiZNj5?bkGqU4Z~X6wb4HL_NRNRh
zxzf#qjAgb55)AmictxXJ1A{8WC)X-Z5lvW|Sp2g$qP?6qT>*T{URlFgL$-*X*qLV#
zs%V(szO!NPa5tbsaFovd?d@-sGHmr0O(c0t;p`W6(a(U%_8!EOSa6vz3Q7gPS@mbc
zT&-VEv#aZcO83%vyqw@EGdW(wEVI<xo!h%)r&Yp(dZ}<AV6TJ7kdrpU>(25YWBFhi
zPTFzX+CM~*Yp?RvIi)k_6FUL^(f}x=@&3k3Q}!3L--MOnV;yu~C{hd@&nKkENZqqu
zvmYy!Ij5i}$E7M0GMFxp>w6g|H6bQcSGz67a}anF0K6FqwKTo;+$)VAXROChF~VTE
zf6U(Zz;!tYJ9nkO;*=>W^?@8eIE#J}aM}vYy54r2{_M1OM)08^6(DRSTzo-S){i03
z5@DvQisuQtWK1kI{OzwiCyQiNfd4cxl1V*N@-TcS{M5Lv0deC@QN3Cod_Q5J9+?+=
zU7<7i)Z^D%Lka4WpD9KHCklqxPF;ebB@Q5evpR#|ZOUghVASjP-@!7UI*-1V)xtH7
z%fP};zUtHoy~UT)bfF_~cO@$e!fhq^V!&n~Iz0hhx8=ctkoYZCTPY^CJ~QgjX5_b?
zIPCgZ|KE*>CizeN*r~<K90S`<tj3_eH9HgoP}eM=05O?HnJLdF<w@rbz+~h;aj~gc
z{<OXT%6~~t!fT%rOdkZ_$ae_M$w+c@?ei-e3gB0k93S>5F&66~>E`gfjE+3{BQ!jt
zxW0Vw^biIq_~6KXxV^Kwo`a1McGb9i>~MX){S%Tpw~Bs1Z*9e%28|w%HvwM7S%f+J
z2GLOo2;L>?Y%&?Ht2sXTLC^1OgN}|iPvgGcyNypA@Z_8`1_Q~Cggb6$C3U9z`>kg?
z?!3(;aUR3ceGfh#RZt<`5(G+=)Um1s6$?yf6wCoT?G$eJ9TyO;wzW?iRv_kmC=+XK
z4-4eMMhtKk6Px4}$OND?;2syT&<GkF+AfPT5IN^0Q)WVt$o=DpwcK%>Lcu<!<p&}%
zYN`J9Bri``=+^C2U&R+wrGlYQwp#TkUgczlpO0MF(YA+%6xlAf!gAAx)K*Vwf6j%k
zbfPF1FM2s)@oyd?RA2q)=4m_OO0H!=b#D5^d&^3}gts;@DK2iceq6&}ZxWK5zk#(_
zjH%j=>3f(dO5cI8T~BZ|!9IS^`ofQ$8${JWYi^U>yD4#w$x%S-{Z$jZmM9ecN@23@
zD3r;c2G{ir?HD9EVQ8SC*VS(rv)dnY;lwe+O{iurrzJJ-C{0*RiMM=N_L1-kFL<bW
zS~|;Yc)Q6|#X&QMuLtiu57%Lv$kp|Pc1BiQi(Ia>(5r+}%klUFp6~5l5Ka+FZ<a1>
z7*{!A>N~;0lE-6?EDe!M1gRWPNtBmxOcGcxTfun6PlL*+*di*z^?0%aHiSZ<R3L8f
z<Uj8F0?h09@$$F)jtOe?6n<jD!0oEkk>1qQjkukI;X4l&n@qKi{80x5|FG(0jN)sj
zX*%1LM}jGHMck%50~xK4>d9c`xeyJZ4kvYW@mY#3FmP~#^-LvQn$Cbb!{K-JzQpL-
zGI73-N~TPOrO??!Y_y>NdNkeIb+>xQ4T#{Gw{p#T52gQ=-j8XWTNLofR?@}SI7Tx;
zROd)&vxAvn-*5DoLmlq-$Dfx&xNDPZ&Uz<#z}4QlU}g;Pr)V1c@E-yN5IWN2V7js4
zz^Eflu34gCnU}ChH(}{x8Z}R_kTWAT2BdwRH#BWIreJA*!ga2FTHg6?N+kfGjbN4w
zPE_=Y!L$3N?kBZbqhivz)<!%_vYi2+DgJMw#O?01%rV^jWAIlQ6bDn!(8bn**+maT
z>OX1Y^<voM5=@w+qNz!#Hs^Mzi?LQZRDg5O{Ox;Bh##D)IKY1z<N>7;_L2CgSvi+z
zCoYZl#}cjA{nieUVC$P6&uJ|43;X{Ilm8L?-U{8|rS+(LAZ7e$8A%ZReGAaKeHi38
zD1tj#Xga!;858r%jOEY=A6|_eRr_`|IJkz)R{*DP$}6}y^3oK2UKOL&?kh4`n%F;j
zi@fLD6{(8WeGhdFDBy=N&7>qyh4p3qpt57p8O?5{!8vp@s*=}RA>pTnrz6893Gc2b
z#l>Ip%JhtsoQ0i|gb8&~4FbTlJQ(z+L7ZMfe+scBeG>OT!S)(eJT|sc9;ockva|wV
z4dC>fhcFC3)#CK0l!vR_+^~L0&xU<IUV<s#?Kb14zFD3VzmY9_>L7og&i#&|+b$Z_
zZwABu{qYEH3XF&H9mJsT33fhzfOKGU`)~501M6t{yEuDdTUiV*OXdC;GxL_Ix6aKK
zlwyTtwULqyA;bxHbLl&of2B8{V76((*hQPjT%g6WGhQ!Wn6lrJv|PsEv#(&MwM%3j
z-)<zrY;t1fKwdFEFR2`0{<A}5tSn8?r`7}u|B}`zM-#E@5+(GpNrBJE^0YsEVx`go
zmi-V{Tq`@%8GddI*lGECCL5QPve6jOcQfP~!-f)U+nrYqzNu@Ty@NdAc|1;h5kq_2
zJ&Cz2i?x_F@Gdf0ZnE{yNk1lI|Dx|48dhQ6{O9#P9ov4x(`bxhsCgHn$bx|(*aI*U
zM^`?FYxs?(_L~WsG6cSfz9yB}gfmRYYC`VEUJEUd$jScO#6r!5^`6+^R&1cYpYoMY
z%fCNUr%C!%+}lSP$q&@MLVhhV9Zp#?Cb)=zsoFjd>4=eIuWCOpcC9sLg+=H+jbp%n
zTM7*u5ocR&TWEiDwQ{(TW%bib;H!#*gHB9-kMtZ(u%-mXj2vwSYu{6G`=Q5-Nu}ei
zhRS8GFOt|Bk^nR=j{!pivFWATvbl8WsNA>=!u?+Nel!z?9&mP+&1*=H%}*s`a_$eH
z^5kRB;*u+#_y>vnJ4pmlrpOKqK>W&&8JWvHGPoK0ZNkuyh8yRkUmiNFdN)=^K<f(`
zeLX=k_-^g%faR6<I8L>>_v$;Z*RE9WIk?=n+g^HL<JbYIy6MK|*1>=n6=fe{u1BzW
zR8RJry^(a$-Kz)NgJ9g&FoX%}K`wwHjz01(L$?)Rh+7PNwcAzf1@Nzi$mh<(AWI`M
zb&+;3G;i!a9^XLyh@mEr+o}Hr^5XKK-1|p664rOtYU9~!SMA4VVZlwRH5qLUgorJH
z3w;?*yRRld2!J8Lzf!<W`Ps_RB~E6%mCvUko;OX4ZguTEqfvuBlcj9$xPtxLoV{7F
zylfkdAe0Dwk72AfZw*ms76IM1WlOSWV3KkIU!W~;Y8sj+ce<_fx+XOVe*8^SpSuR%
zUq7B^z*GpK(Jy2#60>N8jz8}wzvQ3_eJeV#L7?#jhvyswa4HfOyUd3xKNGK*ioCY%
z+Gy|fNpSgwcen_bRK-n2nQ>rGI4qpV_@Ck;n3BgK%J1tt_|w9*?70~aQ%{WE5S~ul
z#QkI9AgbhyVHraG*l)E9Ep#{v*p2ld8lWmeVK*yQ_g+nWj!Zo8)g9g-iRj4X%sNc`
z5)@|XKiH#muw}GMNXQX=PkuGfP3fgH_S*tRJga3emqp&R@v@Gd1q!u_rG-W~y=T48
zBEID}%Xjm?bn3}TVM+^r!D+`^%!t^}uhu8X<{;hV<)Q!5z$vVRXC_2;qc!v8@}W+|
zx1kiRCpcq;iYwuyqO)M2TC}{kY1)sk)1g(j2M?!z<nw8<XI}^>D=+ctOg}(;cPPp+
z9PP$!1EUxk6pxCJT$j6MO9+8z#WW+M&k4om9AM&>{Y$jy-x)a{pmL@-g6-i!Zo7Zl
z`j+U$;&SVs@PIbQ&Cs0#d{eS|uw8ym)dc2y-c9?m&R!F<4bka5vk#aI6OHhEFj}3w
zqJ2ggkbhq**^8FR3K@CvZnYB}$hWG|hcg^>LVTKQzsZY@^d9x1N{5!XEdJ6Zs;c--
zZ<Nt6ScIi2|7EhO@D+aMqY#BZ_8IuHtUu?#wpsr&)5bA*ZDS_GTSk{)e81q}{M!k*
z`2byeo#berYet6;bPBbNtm%2^2)-%AJF0tnLS72=(&+;H@5L9X@yCK;_Ri=3lHT|w
z-NZJfzA3x&cY@q+ZI6DH{^jRIwc(G0v-v&0#?6hu)7>RoUw6g}^?!>Coyf*WKc6W<
z&o>+4i=G<m{FfqA+5x)}`+g%@U0Qq5iN@Dn{R}$P8dDxyV^+_lDl9D63Jyxl6|`6d
z?z9KZQB7-YWF4Lvjzo}t&mH&7MMgIrPz|m#%ZxA;dn&B2YgbI46we&DyX=H72CUN-
z{t#@SnvIN}EBp0(Li1{KbK>_M)G;bNQ~lLyIATm8&|63E|G!XtPD7q=+>+OCM%wbN
zP_)0O$U6VKX4~Blv%0VkU)oKJ5oh6XsKc{|0^0mPpVoL>7Ih$SEq6RlB@e#^T|H|t
zqr-$F26Dz$4>MdVgPEzvevkbO)7IwS$fEjr7)+t}&UaCbgbTo_stdF_{13v5{U{PL
z;DA{&oLF5lyiPT(-2f1D+0YE1-*YX!Iv|3S4{y`9%BK2BMLEeeQWX|#Fl9Ic1m{NA
zfE%<FI&+x8l3#bASD8^+`?K-7p!cKqee8Gp?#sP<{Pr%Wr7NW4Q{8_CL3z!Za<?2K
zcTqx`Ngli0DQ%pEMk%eTO#w@G<CYIE9!Isw+$FDziZBftDRK+IL(_yNNrmn^X^&D^
z;&Wg44ZNAUe0Ic=mV4Vm(?EsQ<^$x&($rsaOfafEJ(BEceHyJ;-*FT9eJxQ-<=FuJ
z*nNro;QK~z^3)fPQgg&uG#Pg~z8}7?k8ZsrMyxzMo=e&L`+@hL&!Z_dCYt>A5W5`N
zvB2~F-(H4U<=YY33!lA>^RD)|e>lG3^II05=WzQ~jXHzj7{C7?Hfs(}0sZ)<&wA{i
zPwxZnf`)b)IVb5ts+QYntr;vNQ#t>YGSF9t`vU;b4gErl@be%q$kHiv@C!LV4FD$I
zpZu(=%r)R^<z44@Q7BE!RT*WZ6l8Yt^A~WQeY8J&)ZUN@32#%)-+tY_AFnmut!%qH
zD%#ejGOSXuR`s{TQC`kY4o={^Hgkn{QC=PbGcuK1gIDK0uU=j&^QK(Z@)B=dP`utF
zdiA4r-Sc_r#o{`@?TtG&;3VOS#l5b-c_iU&nuGb0)o?%71shPOgvm7G?7;1OZ$HLO
z4rAE-w4S{D{k(+^3k8`?Vpu6~&2uD4wi?4aUJSm5B7Y?hlOWeB^8k})>P-?lV5gT|
zx7HV!K>x$Fnsj?gJo{e}1d(3L3B_1DpY!;F;YrN|vH<q|XEs^O5vXe{kNdbPy6xOO
zccr5|y1@8*^*Xs%|Dg()?Q77i;ObNHt@}%_RY^{r$fSSVhhqKtsWFzf*J<3uUo1j7
zzbXg>uoE3Xvm7;#<d1x#Tu)eR6==vpLSGdeqj$ygQ&+x{(un9U)6=9S*$&5z(mE$;
zlp-F{i-KmJj**rDa-kEENlR0-!<i96{Tm>zjDHHiv40<P$lK;jO71!_FTzj7$o{VI
zwm&6gz!-@IMLZQTaPR-Ne*$Ist~Jx1z$ybGNTQzqA))WwBX8(6etA8ANVl|(Y{nO9
z6D1d}`Kt(A|K6#$1e6J?$CIvQG|GDQtAS(ND^P2$>~uJiyEV)co5V<xFNH;!5J(?W
zzoYc#jw1O<LB>l0+Y&xSiUeKt!{lhf<A+M>ZJl`1=yfH0nAtxC#=I=(b?JeT95S5d
z@)oeZl9jXd6^yh_J|F?)s^uJ<zEAS5b4{5m`lq8Xz(VAoqY7C$gxTI3K#5tLC4j5k
zuX0wGRMXzs^y1=>&fzIZd<oM-Fa;opR#VJ}lTOiZbq|=a^f3YezjazWnHIu65Pt6L
z;}NgrQPqF?v>3R1>?<(Amw5R@H^1b@w8Wy4V$Sn`MrX{+lWQgg>er?xbV%&uMNfVh
zystk8*e`tkZXG2kd=f1$fCGPyI`~bZq~80Rt1m->nNe^s$Idu=x<R*ZOfiKJQ;|96
z%;4U88EO_oI~{2AO?xTe+#SF`<pjZi-W6`CWs+9`x_1zTW@NQj-<H}%olZ~+?T&tj
z)cSNB-&;g38r7EWEz&??-EY+9$P+in&dv%%U*RtEL)@*NIQLL}a?_~}hIM~6#9L;L
zYNqu2y+|f&9)%c*YI*f|jcd%Yb>?xvzl+p6g8QW!R9qbcqgC|}4%WVVFU6D$@8WX7
zBNwKE39vmwQvL!q&yk90ukWj|>N1i#|6v2|&e_$^y2u7tM96I7^OoWVuqB}2!z*~u
z00#yPkGTJfysrmR?94qo)^0zzaXFq~<wkvpiDpMJJeBtQtiGw$fA5y*5<vIVo^i>X
z<?Cto<uL;qO1XWG<aZiO(Ej#BnFu50OdJct>3!P$%y}nMu@jnKx?Qael~o}mR+P(a
zkqMvMS;BtRC-3<0E<Q^pXxEuy`_7TW1o)4m0$z=OfbNCe$XUVc_KM3|gr#+44@yxx
zN<9J0u2_vG?`{yRU|b4G5zff-AGBd)c2o=#z{RHq*5m)`Qxt46#5S`q9U`K1W#|t1
zmaJ$K%J@-&c`&I~|1-I7@1e&vph+)X2g}#<u6jS51nKI;pJ`aTE^TG$#g7dvLrmA*
zqa1;_xU0a3AB9W4WOyk?3i;=39;b}Abr<q4Jh%H1sr$hmeAnbZ8$|Sg@mVY|k!{oR
z1EyYFck$e$b4hj4z3o1m|3581vz*tw2H#0=j;EG0Kf-9gXH=aMN_ZHly(N^<O^kuz
zu4_fm=TIxHd$F?pH)1O9JRov9lVE$gU0nA>bAo=S6QFy_#V&GZh$t<V!|A?I4c4%C
z6tH)D*faGOM(x8t8Qx?%J$=D@`zNPMCPiE=gLIAC?A^Ae=zVc=zy9)BqlOUfG?U%+
zQU0Clo5tE8qG{}_D}zZc&9ZJ?@9+T%)H^5jQFr8NUS)tIr=Ldt+gf&Ja=*Ei|2$*C
z^3$%)*6g9<{s@H+d^OHr<Q{6NIL7E9Ax2GGp!8>GXw)Q9V9esT7XhjjaYcOZ_EU<t
zsVHD+p^4}BU=sVnI)Hn~wHNE_^Ph+D4vToAz$X1=FhuKdk)9Ct&yn6Zo5<i~689%z
z|E<bi0gW8^R_`mO*LQX3D(*@0V2H!>VTOrUMg%@8x2eB%2*Yz$=)F&~B6*$B?6owU
z_IJNd1ctqVRGC^Ez8A_I{edoTD$ek5e$@CwEv)SUMH(%FeOY&D!=Mx^2i#<)D>VN=
zxL;iBAMYZa>FgLaSDfPE_1DxaZ~@=>%(k&mRfBhU7S)o|jf){bX9TLVjm+w@vi4~2
z(^4d!|Mazvs{?~ZvBcn3f5I3mmgQT&3^SbGP?t%HWK#_75N(pVBmEQZ(aXHB$pD^Y
zdVyL9kvz@V^_7nfAjoxT)<^`4wyQYO{0j6Jm^`0$L<b^(5g&A|TYfLW|Jy706-W@t
zSR>XakH8JoX#`2S`+eg~*Q-Yey895^%ec>+Am(V87IOF!%gA(r)A_KC<QhvHt!m$9
z*M0<=r6WGzYgUah8j3-KR9AzXdII-|vY@B_ks(_yV}hWuj!9V9&VpE~yiMjj(M&xv
zR*$pkHPFrR#%Z6oI^IKJRM?yCk_pK@I=RR?>QN%ds^hsAdNnTJ$*O<7V|Km!iBmj+
zx81*(cQR}^ub9KBkXJF#GQiPEKapoWKc!39FCcFuENB`0aXS;0h$qBEP4k){C0O6w
zO><d&2<zq-n0^xs>XG}7No>7oDG6ex_J>7pMnxm;uk_q_W7ef}9GtPwQYp(|)9aXc
ztWAQ&7iqiFX!}9**4zXKTID;yCZ9;mP8z5IquFJ;rotuWy4E&*4T9>;CBbdSYkJ%e
zT|M=$<-##b2E<>YPhjx?(&xU(l{Pl*nN$OjE;xcw<p4y&L6ETIFV@s|X`VLNfDh6e
zDR=l}etXIMYW?@}XD!&cNm*S(!siR3So{?2cWy%%>Ra6mjMU(I8Zt>{&^%t{t479Z
z04}N*zQZ~S|NW?wi4A%@)Qk}Ef7ng9!>vW2lCgQDe7XeY_Q?bqx7uemVStxrAF7Bz
znFr@^pVO{|?@k%XiW6U7;)%{Eas!5nJ>;x<A8;jH-MI9@lCZ8V=aXN*_@2O;r1L{J
zJDq6wRVS0!2_$n$K;`RKN@6Nh>BBRm{fZ1yW+6<faxci3d_XOsId_x18z%6(!+VT8
zxuPl2%(a6CzCc`cwB$k$E_}-&Ph6f6L{O=RRIY31*TL!kn2*a8Qm`<f$Q13qYBCi7
z8PU~Q3fSu?Kn}P@k(zjr@fhQJB>IxQ@*=T`2$Zhzx)=vsAZmP&+x1J8IphPp2G!qi
zrXqm++fAm%m>Sy5P+o3c0^w?PkcsX$)Yi||2_$*CAm5JpJi@uN`C~6>Pg6l^Z^JJ9
zhSHDO{3Zp27@+2a*7TtlPVCg>;tonCWtnQi|FjNYBGjOHn}T9$5cAPVhgJ49I5y6|
zq4&(#Zmaoi8AqJ%%5#+H;@GJrhtjY#deP0ut23#J81vM0+X{y<W&o^CYhXHmJjsbF
zyk_Pc({JLONU)^nZ?wB|X}SQDvnE}VUg~Zelb9Cj%`Iu<1k9STzSMevo+JY85(S6r
zA)jfeo}l7ky~klZ8kwl)dqw17%+C8AH}d=*0?7DLnCjvf%cSt7S@#Hu(!G6y3z&Iz
zkg~%8Z2h_J`4%e;e5=H-T{G{0MjKRA6efl-y(rNA`~H=`s(pIz4YXW83}=G7)}S;0
zy(a}=__Suf^G8Pq)$jaGp1(Ou@_X4P`Br!ZeN3X?m2p;O5TmJP^eE}!9bCQgA?DhH
z_aKi4Q(0_&Ehy*wAvfREY3yb1gjXB^{K4$ry5PiO`j<FKZFkPI;cZ<qb#_eLrwEjA
zhzdC^+2&SQ64e79#&Zw{F)nigOp86+>DdFi-Y>~nDk_+XLk*mkZ0wB72Ecr;G@s$x
z1)3#}<G#)fs*jRaDn}-jiGa-d@j|4V6gs#7;9XLUX}o|X?Qow1rpydR?6W4S80O^`
z)ms@0^*+baP)XgPnYiJ*%}aI&mX`t35|Iq7Z`0VJTW1+NX9QvURbo&Q6IE%ni1R>d
zZUdD3i;cVvcod>mN9h)Q)?w2%OuP=yJiXKM>4Wvs83`Fz38l{v$@_;#{KeL_Qw=!A
z0QSIRH{XHmr_3n>Ojr8Da9gVBhu4oc=^WcZWXBk@{8nym=0Ylg2vALaDjJVVPN@VX
zzSocXMZraMl7VRxBr3j~mr3-lwG3|}K*+Xc)adpP2FjUykW%^z00g<S(Mm2Bt5z(0
zophO2p{zV<`Xj|P@4{-|o4r)>MqZlG+|KcmF}TY&Kg=r4Z4IH6mFV}gNHj^0dbaSJ
zf#oiD`6Q#wdB8qcviZK1fXL%tQXCR@%4TcqxbnNfik#Y#lK1EzUJVY|aeIC<E9DC7
z3*K758U&g3{|9F%g?<IpiVV=`-zUr<CEH#&Y}D@xcH$#Q)3}Jm>ALVt#f`(ui=VLY
zjf1m+`klz=?<M;KxrcG1YvFBUZHL+}yObr$x??lZ%y(D2Y?t}L4vKP#G;WM^oklX_
zBNpeT1pn?(&1xf8BG9|EA9uB#0RX}Ai2a8<?WKZE$L*a@DDP{RMs%IDm!4!k*rA$&
zbqoI5i8S+@)&Bl<CuRo~=^W_{IJtB_$$WB>SjX(U8-Y0)qkLM$Yy^hc2?YRHQ0u=2
zh(8ao7O&tEKOelD{Sv)-Pdx1XyXd%Qn%Ei1tbB1J$!MKDrw{e7OIYvqP2<v*Tn?*7
zMd*K@T1u@%2<NvO(TY<?JN%25+i%@x@mcE4Loj|&{yHeDh2*)zPi^vN>hp=i*R|C9
zAxV&j;9d2*DUI291Y2|tmJbA6%I^nRap5_+zwW3XQ1&MLbXo6Sz(rG7Jp2KSJXc-v
z3pe+Z<d_dZ^)_R~34KODmZL}^&p$W&!LbtdZ|UvxBE4ZNqIRAlSh+A0vwbBCbP29F
zB6JDM*aV)k)43qDFtIf~Qp&nbJI!8Oey@6U04+;~jLS6Rc>m=~cXBv&_6>EWbhgzH
zK3sMbv(8BVwtTi=(JoJE<d=Tz{`F`VS`Qi!vvIh-?3$6WEx%W(d*%)XP7k|2dRP3!
z=95pv>dgE|7}3cB5zp(yb8j+|_ZEL*L1xm2Um4+^oddTzJQU(`5F_VCovf@~1s`fM
zZB5+r_j5X$J-}D$x!*s73_e=|t9>YaYBnvOgWfCV+J5ie=iB(3%rWMB1Ml$1Yppxz
z;bGvuxX{jrhvH=RwPt09hmDLejV!vI%<ErVJ;p}Im}5<z(_J2YJq-6ZMpW6c4~Gno
zG8@j}KXE*3izRVwJ~mc<p#6_b#Rrv$CH1?>r@Xfk)!kloVlwiRXFpNu`1}5PbG0wY
z=hu>K&IIlT$HK+(d$B5VQa(cx@3;3(o?@%RnFP7Ymvtt?nAa3B>y3u~gSAVQA0gll
zs_lLCd#RTacKP|rYN~@!_%6{#ZSTn`VvF0tz;S2nc@%jlB*1~y?E?}a@mj0o`J^r}
zvU4*-#GQxk-H1<4(%<+x=C#MywfkRO<dEZ)*rM<`&{y>UP*`M-Rpk&v{h(VlCMD3r
zNJU9cLg(~BoD5;;l(gz()4d1yaeTbdNluO=N+6QC8DIRKX8cvx*)73i9BaaJy8&Vm
zH2?&cnLE*$a?bmIEk~(cS_&a@`eK@9uAX-eyCR44BDQlCVfnZBb4H1ObC(9AMu&d~
z;oclX%ZcQ4>+Ibr?&RO!vjD!~pa0|DQbDPnR##JNnpWLJiZ&|g4!4e*k;(k~V$c`J
zMa8|QW{d@`A~mW&{Zvt^P9}RDkhR_{^-F*`Rs$#M3z-kE&-1J4Jq&X0TapEGQra*3
z)k>wvh0?G8*MXn)*qeQ)&w*v6Eas`U(?)&5@|)v+2BeKm2YbisjH<|Z)xojsz=wOn
zEX2Y#y^d+Ls9MTB!JD0fvpoEQo7*w2$&}1+`{Gmky{Ep5&8p2Bx4k2LcWOBLjiYwQ
z=>?L%B$%83WKp?8b(iY!cC2%E1m9}`ml@4ftc)u*1cl)~mSkr&z?}+&>Ty#Ce@w_4
z>oI3(N4N{#OlKYx?_5?0$Jdy{qlNG5X1gt~sq|#&S-pK&kRkE-4NXqRQ-8p1<djt8
zN(_u3l7Fq7>5RDJ8QvuIFXcsY5ip~=^11FbGS;yz*itBTZSB~tsP%7ni#pdNHm<hq
zncJG%_UY>f1VcW+0fY(FKfovJ_3H@MR#Ph2Ec)}}d*=t^<-l%qmR|6^L6l`VpMVbC
zyWK!QynMYgrCwj>*4E{?Ix_Djk~Lkh)zg&F%w)IW>u>170}W=I2@@`bK7kk2<XzM~
z{C*ZrMJ*4W85H>mS5bFDOqL|9WzG11?;PrN^IQ@=)3X%8UwfQ@X6{({4bM<<+AL<<
zQa5~X^~sBhCsM3w+e>Q6D$#tc0<SNX_m{&CuhUb(4@i)WZ=jj{j9s4m@43HT1h?7n
zbMdMf4|g9~mgGKvBSy@NI-K5Qb$-v@Z80%%h1MfZk9Aycusb|Dp#{soIAHiuq%sb#
zfo%m@f9<h`>&@_yTZlf*SKWR(?!BC5wB<+K_1Ts_9-J@Nkq;^u7yFGcp(r~dABLJ6
zp-+AjjGt-=y~<;>ayD^Z?UY?|P+n=4-z_m24NsenY?T+y(*RJV_RYEsYgI}mYPJ#Q
zmXaiNI~?D+>s0NT5<1M7;LBPIOT!|E5`p^;4@atXN#e%l1%#Q_Y1WLfp0JN$zN6h&
zs`IawxX3|j3wYJ$&qQ;ReR9GF!#zJ{5G1ys@j_yr#xr~+thsh=FIM-9y`XJuzOy4-
z|23&F${XN{bQ0!}=~R~M-$pxgJe}0^|DpkeW=k>r+fo=;|4+^8Gr1{K_BV|Y0qgrr
zrT`i>K-9oTzPe~wI=^&gG(+V>uuE+)vlrKXEPuznu$ZeNVh<gP<d;4AjgP2M|B&eg
zhtp#%871-8d>iPV|5W(L4@+^nPa(bhPdm)+i1y>fU%bjNb=*x_-{MVeY43k_i_rN?
zi@l%bO*tba@7p2se-xc{SW|BwhgZPp(ak6UF=!k)5NQQe6hx#Oq?^G;NT(nmjg$%!
zqDV<gN{NIbGP?Z10C5|P?cMvwIscyPI_F&HdY<q3eC}I($HlIhr_ir=BY=H>4Y4zQ
zG1JYqiSG_I<z>xJ_aM9(2>a$fdbbN`FU$4oLxkE{Pv4~zCVYSPj*xJ_PL}6$P#uKT
z(LvYpHbuol?lnA~sNyNR@d=%yaC$s#_%+n#C0j;v9&?y}ks%il1{3gs`7+S}3F1xa
zz=Z7ZCnCiUquD-hyilJOn;i^0y64QX!1O2B&XqT$$_)QRmd*8pa!mPc5^QH-g~pnb
zU5PGT=hJJ#;A~%8sPG+Nfe80YypYVR^tdNuEy8V52bePc+i$qJ?Km<snRlGeHfnWM
zSFX8(ELc;@$N$hNi(~xp0t<11caFydGB`MG;YStbb#uk+9UgX#zl7;=VFhDIHpiQM
zH0hx7EvG?;(hoGfqY_|@EX|AhuZBJ!KTQ}N+2mw767=t)Uxj~|4G1_GD$6N_v)#c*
z!t?NHTjK?#?C~rX!d3K$RX>Uf>Px`XWgt-HRvq#6-S*D`V_ETU1`pakj{%rak!JKe
zEDB*QC3Jbc4dE=;KjYJeDAy{pT6)4wGZOR}!fb<gric3>VVa3A*e(%@I1235G62)O
zxW7jN*vj$W*o(|g&Q4jj^!t4^1M(}^kq3k`z|_uo>5?sd4FwS+*2?&Kc>yjYX)o;X
zD_Y!BjmcYR<>~<UH<O9T70aCXW5#(Uw}pqOJKnsW*Q?B!Xjd|Zwls#mc+}9HR5S_N
zBeVotbVZGUb`soE{dZ^30Bn+uDlJug`bmBaRQ|P{DKLqfF@DRu5UeAi{D<EET+(Un
z_A9z{(2FoZ#voGn*B4g}k}~G1?*Ds|^IOs(Y|QQ6Gvow?Vo7}Zxac`i<9dabAmze~
zGJK5JJM8Qa1JW)0LgOh!^!R8xL&TBJ@o)uyWXMUkcYA|%gXuQShrpm4%fCf@H{X#T
zw`3;w&=ddF9Xn~~_S7v<!&4rxJU_r2Zn_4KYII(ElYyiwVuDN%o8~Nee&YXa3T5Fe
zu3(V|p3D8T`R+NAe#TTp77l>MM6ZiNUhU^;CtVD2=+GS5knL79(P_Kb)=0S{=xhK(
zIXsuNI2($a?=2FcnhO7mW*>pkRO{g4q<GCw`@chj1nIO52mb2>Tv?}IvLZ;gbb^~W
z#6;uvwwGxXp`-^{gyR{-+?&CSjVP(KxT$b(z~Feu?N@p|wFez-N#YZ6wr2#B7rNXJ
z*eWzBlnlQ~nSY|I!@+?8vn!*#G{)gB*o>?Q#`QxK+k#13I&QgQT3oIk*mwL&{zdFj
zASh9%&mNiM#a`cSU1^`fD~`}#$1?8(nGE0L8MohK2oFm;+6q^Aw&sZ$i<ACa$?VVb
zEgvQv9YJ(IBO6^NU0M<W&>2w~!YYqRQsLPF&cE^?|B!)Yf0e)dVXA*>cc9|35Vg+K
zoRiNw?+>Ef3UryGhBQBx#P?jQTaZ=LNBUR7!wRxW{Q#`gf4*!JpJZ>In~aOT(FPJq
zW)1})5_WqV8SnSb_sGUf8lPG5FTXvMG==)h8225qClompoHgOxpI+f9N{hj7v;@&E
zZB#TF-av6a9r*O=snuvtAJYrD1Sg*S{6ZJ#m6S#K%AVmduTE`RG|oUIH+Dxw>ko~P
zm{w|j2EC>~Z^%JMg#kk}`<SS5lk`a@)6}V>sb~4ui$MKeowGIBTh988L>0e1zQ*Uv
zhbfyd?%yRR;VxUbOMn7de)f<34>LqmV_ok6-urVig_yo&qoW@Y^~$f47won<vChj0
z_)nSs)c$-=6@*`FMn$~>06dyJ$`fvpLh>O2P!`9iClRKMHJRF*vx#TK&U_vk{;$D5
zLJ1={c15Qheh*H|OJ!FM^TH}k_UDEdSbX%{vL19uDk!dAcSw$>RbgmNVvVn#w0`t~
zAePZ?{s~=2dg($`qQwl~L*41Rchf$`V66fSitZ4m7Irb5WY{ZxWiK5-Qx#BTN_{yr
zy_A<W?)0$B4;Z|jIcP-<l<0)}jHB9coZPhE_EUFg6%f1};e7y0`sv}Dn%MP>Vwia`
z*YTK~Iqr0paCHc*eH;t;Oylsj1>3m@QOLJ=uR}mRiFs@6#8s)<12H!}L&NAglS(^!
zeraV#(czwDjcjjDJ~02=A?ynmvK3yuba(pXPXahnhaXga70JOTH?<}bhcy}m{{>E{
z_<=Wbko8qtlOhHNf&$ngEo)PJ`o@Q|HTk9{0?V$JuPoohTC<Q9N50R-MxNnb`%^uC
zLAGhyB<Fh?B@u1L{s(Ry$Udg1o|<Til(X6rHYN6hhTS!*ZHEBg&@bz{Jhr>7ojJ%N
z`yc#T;*q?#GfH8M;p<xZersAGUA%n@ZA_N-hlSK;R=^pgp2r#_r=v6w7euql7oTGD
zbQK5#Sb6CSU^>+r1e=^iI{WI5{+hPEq&8O{=}g&;%81>~Yj<K*9e6}Z&INF~>nUD+
zk4rR~Ubn~k^8aoVuirD2<(ZJ<6Wl_5*UghZA2(QlI*EGsdZRd{=_Ua{lcPvgAi%mS
z{TWv@NcOQWg?LT(sVkvQ=}IPJ3a&+mESAtpPtS6TRNU0y{aP|6qRTf(d34k<H<kFI
z#%;9oe)6yY?J==Aw7#ARX#?9zI32y*L9&Rj>k2c`D@rMrSD48Ta}`z^CSDc9<8+-6
zStB-n+6bfmN4iFDk|&{{fGf{$JYRF77IegURS475y#i(7Q^h^|EA)7|(kn*(0nHWL
zHBt}8gK8jfK1BcOo3izOo)Cr9)xXNGHDkiQ0=jaVZuNqjhC)|{?v_gn9PHFX+Qr3;
zu)sLSXltwW(D<52@Q(RUq0m^qTg>TjOO*%k*q=Z-K9e`h++Zi^ApsI>(sl0I!r-Yv
z=ZdA4=VOAwD>?h?nf#Y~g})pm$J`=A&w!b+>Le7(HNJ^eS`+NRRL!e<Cr&=+G-9>0
zebj4LKNA_d^!vemfbpX%HU;D3=kxaekT811?Qh3~Up_Dnp5*(rzX<c!#Rs3Pu#G>M
zn8?V;e6kL}-7x77Qc_XU_?w@@@~~t5lH*rzj%+6;cODCosNDci7i@EM<m0h#==c`-
z`l5c{OXPSdv|dFeNqL3ip5|KCQ?X*LHd7?v0#p*~AAS>(V(%P|u_@VLk|m_&BA#0a
zgC=`pRjz67D%Bo-?~kT`bD8HM%vgR#k-E&kXYgo@%EGYYTCaTj*0G;8eoH}t8ON;v
z%@->_9JVr0^8?t^6m`d#@|w<#mM7Mr=|hIbp>8haGW0zh+QE`h<%b(Do)=YbWq{u%
zSa8v8G!;NmR=&T640mf+FW<3iHzQ;qW|~EfzyL=4u*WOE7<a(sQ|XL&_(#-jQM?Vj
zYN9NuMor+<KS6y}a2K2ewNL@;q>s`M&{9&4o3jkpxxQF!-HCN}&ZRl%HHB~jJ(AB4
z)`>T27$CuYSA*hL7tK@xbSv)KA0KBOO3`oEzjo=MZIh`_bG9G$$CJOitDTo806<MW
zY*B~0Qj&cGld*m!38S&}a>}b>^l`Uk;c3OZoXqCYq$Ld$yNe=|n8)5$T0au|R^Oa+
zYgUO}Y(q!xny!cloHZXogrfO)p<*}yFL%||y<u?^b)X!Tt<gK2_UgCzfcgt*vXLUO
z6_UI_gIe0CNplXnde(<4{h-cA%WKQg?CNAxJ)X;iLteU?eWU=QtH@`89c{?M6TLMJ
zlid4aF>g#)*d_&~;b}~IUxsPz<nFxKxE6Ndljf~Mmn=t@-IFrHDEg3=p6W+Wk1uD^
z^1Q4K6oQP$Z@6XW6l?3>nwH9M(Ig}X#~Ac2mjV;=O*W2oC%S?Z!Y|cx6TKJKqCK`$
z?>A>kd~a#M+pkQ#P@<)d-hWlljc)aqaW!}xk01PLMS-}xYx8-QPtYA968)qFly4}C
z#J1l51)exzG|4$NN48pCo;#l>OU8-M9Ga{}c=>2SW%g;P?s}al-lNO!V-8ct0Bkr!
z@6eat4-<$k`Eq&?plzZudxaQ`WV5flRL%5?6hoo^DiW0BYtJ?-d+F+`9h<1z4(F=g
zQOG)0<f9m{3#5yC5i@MY8k3!fUG>=iyvSVE{#t+J{-_{3D+<_;7huwWIIKYK;$&iD
znZ=x2Hs;9Ch|Ww7XTcc5@-bGCnY-bNP)1~*5E}?I?!T1=t~FV`!p{~n#ms3q0RP?V
zWX`MnOOau|JXqHz4`B$ywrM@m0l0}Ii0B?_MN7d2td3%u&%5*61}8Kd>4PSH7Sn_>
zn6KI$Ce>ZHYcR5!B`P;|(1eimCQY22;7=Fm|C36aP>gq?(Az}{<Ux?A=XOlD9JFqG
zhd1w+z6~R{JM}hyC)3*c3TvHw$5C<E;i3JZ!^N72{FKCd-@kNwi|B4NO(SsdF#U&W
zt~br~?p~9L3G9ZxU08uP#U)4n)93kGts|LxM&T+;2lh@sX<8HBerE|!XQctGYW%12
z*$+Lui!ICndT?q-uxr#&{mn-!`?8Hxaf&nGwveL)1pYB09{x<)wSyL$>`ET;CxG|>
zXRNkoO{e4gP53NO@AHZhqBpx!UoBqR)8QMqD{6=SJ=Bnu`BkcRd3@l-+@MAxv8!j?
ztz#WG_v`xLCH7g<i0k4Wk81gaxrLAYdlBtut^$~;!tvMLX2HbKP*R71j^3Idr@d{^
z4LR3F`XQ6V4HiXhb|x*uky|G=vkXR(wC(aQ<v_MFH*p)v8KM=91hLM;qtMS_K~u6}
z#HoPA7dS!x_dD6ngvi#941unim#0*Eb)TLR#B*T`cd^}#$7AVn8p0j{7Da?)=5HoO
zE6gEre92(~HEx8Yr`$rUa=c2=ULaP!`3E*fUmKWQ2C;CvQ@XwUwosYq9FwfpblC>B
zD^GXV8UMwSVNVlS!2-CNKw&!hM}Pl$5)VN#=_X)WIKjTxWj|I%fKLun2VkH?Nkbe!
zM441v?ral-KJQB}#(s9Q)z&-qe-9S=b7|B=(&P?lIDakU$VBhpJANik{5(-H_vl|z
z%k2b%D^PCpmqvod&xU$|(hCox#zb1=Fm0^Zj$q-zUWZSXb+PWffaxex0MK4}t^ahw
z-W5Q@MZCI5-4}LyJdn>4L8eY$cK0hMytaW&^RG8gSKLVy7P;Eles{Uy_SB2&t>>)*
zVEpAg6Pw>G=h#9OiJ!r7oxn^0aOF+7bO`-Wz}MdlZD}`$Q^+Us#LK;ib2~=6S98|a
z&{7Xk`YKu!0opHXQhid0{g$n*7$AVSUnA$WAAeT!Cfbu3X1e}W?#ilw5SwEXm89?w
z`!puZIISG$5&IUSRK}HWPHHjOZ!Ao)wiH^|Symik{E4PF1quLX>HPcb-znkpdE~SM
z<jO9u1dCwEjA0?y8C@=wBobQ|N7%G&rJAYq?T{D^Sd#<p?$aV_)ddlCoi#RU7{k_R
zpzQ}aLfvj>XB}mQgk1g}(I!2lSEjw9ZY1K1%ZPRNR{0M>A?Pt4#`3$Atw0ClBACA$
zD+x%(_g-c4m^a6``;?x2IkuvY3sLU3>St)u<y7jwB%Ij)kU4EfMwpIQGxgVM-OV8l
zQ+mI@pegVhMjhOj><q)3m|+@boaaO|ho8ym<_ZbC@Z6Ww0cNUZKL7X_`^ml-t8XcV
zZo?H55tm9e6cT%Jhe*rwmmhFN6iQja*|TT(_*EuLzoDmR2c2z6(l~0cWcF3%n>0-b
z*9B>&BC3a0D6pvU2bryj#T%fYDf=#NUSB_%s3jf$gNMMYiK(i!cKOLN@Vwg>-+_)7
zzsgkpjq%aPOKs6}xsGQ)J7+J%2%N+J-JlHP4DLMa^*_4u#GA=^r;S4Ei{{h$koAMJ
z0`L!Gal)ob2X1zjE66+{nLWP$o%t4#ML8PZ%afLi!xaa}w)h!nKa6;g(9JBBRo2pj
zpdkqYN-3fia8O;6YGft+d<&Nr(|-lpwvvCdN$$az*$La>Ss$k*pHgG~?eFkqt8+^1
zXx5LG$C{P1jYWu`^nUJeE;(%tO-J2?WxvNlQ2v>qUUAxeIUm-9b)Dm~duiNHv*Cm~
zkXj8<o&vd_omWb1L}+s)q1bmzlGuzImddVik!4+l5-QS4Un|i!<R`9+>)JwC3mAT6
zO1E3i$hg3DBg#&!j&QVLb-)au17Ha(3{{RvTyYNqTtlkV-y}1N>)8FFjgkB_3D>rG
zVspBBFibEmVsaS8#JqPU%k;5==mV&kWi2H5Gh5#uT@RceBv=55f=%1>e8D|=sY0DX
z8hPp5kHe<6uzcx5xXm4@2&aLh%vCj3<F<BO%?U3TidSQR<+r^Kgxl==d7@N!s7d1P
zH^i=$<<J|U&6x~#*QQnbR<A$tc}8ydeC%CPAvn);Qt(pkW1uBE;L9~!$ziAa=X(_z
z9~b6jQ*l6x+w(Oel;;@6Oph<F29z^xZ_~KeYhO>vto?;@YXUfMqQ*P!IygB@@j8qy
zE_o|r;CND8ae=<)ANI6uqO?Bi6At~0D&|rs!1u#$j=Oa|_*9?rKqA-fUpcLHa4n_w
z9@AF!0l{HO<NH4`2I_@a{%vdt{rIU5CdJ8M!;q`%h>-AVpQ^glWA5=gKVAANpix8a
zekUmX8vW1eeLRpQdu-o*9$$aC2a5_E;iuVMK((CWn@W)Ri@`oU8HyuXTs&HAZg-df
z`tfBxbU3tJQL*yY2$>*iw9KDsOY@ui+LQqLh?4&AQQ70T>*uEA-yDAt0CX#lL<_9!
z0wh0?eP|#`Im`l>{dw~FR2}^{WlUXxZDmALXpO7^fB`h_OGvzIkm_0Hzlgje`_DDq
z?D&sZX|kU#;!GhHO}gR~hM8sxGq3>ELV$j9u>(i<DXT>{5pxc256RGKMK!sfb|sb^
z4#V&UuC4DNd_Y}Kd^<aH??JDg$sPr22-C7~;xNm6_7fzMc#Y^SHzxZmp$i~`&Cyo8
z!?`c1h18nlJ()`mu~mpE7&#eJ7Qx9$M;6;RNq{mr%58VR6488%Oey@(*E5!Xhf-Ef
z<JR2Sw1Js)$Bdgav<@4@N(WIx%UAZmClPHv{)O(j>xyaAmg3+cYCzJ#@AS&Fz}?=v
zV$AzPU(wHwdI9P`L<Yt@?(3Dp*BkgA2+X|_g1RN9@x^pS#l#$ML!=lqVDO+>ZL|bV
ztY`ENo-K7_w5PC@TD?+ozo+J9#a6aP?a)~Goz}oMj~*Y)zYLc_44<`0h3F|gR33D#
z(e)mIf<aKc=L2+vm;vs4Kif?3lHAU!9fiTl&dnJhDuBw{KYO+-y0AgHFa&yDd-DN_
z10cnmj&D6MpnM#9nz<DHI-Sz=Jkn!R@-Pl^g(L-F5p4O;e3r9vqJPg1isXfg&}yzo
zqDPpA413QcI#HD*pP@d$^NrqfNI68Or^>D8KPElfrKmr=*8f>1{`n@L0&hCc{}nbn
z`o<<7ubSPW6-OCNQvN|mt=ogW4c@?b{&*Q9k~z|g9;ZN~fq+gGp_Hs)uUWXz=D(#z
zK<0L5DM9rRMxc$F|MNTS@Q1Q`p*!V26l_>#Up6iJ>4du>XtE<Op7JMB?sLNy{CeY2
zA#H&RUQIm=8;|(_2AgTt<1MPti#JX>wy>}(4d@&$d>@-&Fkcm#w3LmzFR#MFuZ++w
zw(m8Q(%IjdvFl6ZS6C_lK-PG$a|r?z$aAJv`;q~I@z*x{mH|4XHc9{MQEfT^=#}s~
z1Y&bvT;}d&Cc6FD%K(ty=c{$G{2jUPyA5#w+YcbzUG1wX3Go5>KSAOs6c!+qCgJbd
zTg>-W0khph^8t#INyj)gfqgP%6KWV<I8!MpRc(>Tqfoc*{p3*{Ox!;93_hAA$4}60
z&WyF~s2K7G<F$uf(J8g+P-W*{J*ibVv)G@`>zL;3)k<og1FVDlPY{sKuc6A#1;&tC
znJODslR+~vT7VJW9Tyl^kVoa|kp3<9IBOT}Al{wC9Ve+W&c6haZ-y1=i5g=mTJK(p
z1yLrZ=-b496z-f|J<lnUaQDr-FQh!NW*r{c7^|*MISwj<Pq;V*9=ofCtKrARZhP-K
zipe8yXe7bt#>Yg&o5$-&pH`-JUsKBh3{UDj0j$}sd#NgRSO6)x>@Hsph1B$;g>vf_
zg(A&-wgVVDje4S;&2@OhM|{`%l$4~8?@LIfFa-VBrVQqjV|b%MJP-MLlk;c?0jj4y
zcPP75%J1nnKQ9tWlXhT04$Mvd2&y$+N>xKzETW^dV<e*0cpstXwhuh7w?+19OVKQW
zNq&X{gfjVyR?vfxf{65Yl*wrrTcyo33N70V6JhG<LovS;-Ip~mpj<exRX%9FMY*u0
zRZ91I$=h>!nGkZ*8ys)?5e;gj&Bqqf?`i$|hW5bvG$xZ~SF}~Qc58}z4(FE#E+pQ0
zpg0~&%7=giScCO&lMerO>pJ^s7YO&#U+Pe0^!o+!4!sV4Aq1bO1HXjKU(UaAfvIb4
z?T?o1-QA>dE2+)<LA033VQk&&KT_uZ0lc9!^|a=&8(P=>w9PY2oDd?sj=~Fth9U#a
z_hZ6*dc8$gC9y?p6*p>4JMn#5V)uuisbePXY`W>)7il0`Aa<H^^~-d2lCr+P3kE`x
z{mi}s*qLB4eOIDl&{0cm0{QvlUTK}zt~6swgXJ+Ds_jo}Z`tmAyrHtbPG9{6e(%(M
zB;Ai{dZKMKjVT$#miAix3E8QZReF0hFknnXfkn2{Bsq<BqFtO&+|=au89wFh*Wlks
z1w=Cet}BM5kjBvuzXGJ{e2t&V;miIdmErI9KOcKLc}@Yxt?pPUDm7ZEpT-<0y|E}e
z)cF-sBf_&{6oXm>IQv$u*u9S$A8seBI1R|9{uPMm@xk$&y$J7-^8oj*B*+rwId0K6
z2#+wCbUPI-{0wzD@7nrf3F8JRu1x)-d=NRX^9_vZLh1M+`8Hj8S;bu5ybz7@gSz^(
z-NMwAt<3c75&S!fv}y^eHw?T#Q5uPU*28Ymv@^<h3(Ata93dG%d;F9Un=%^!s>VN*
zq76KKqbj<gWJb7D4)c_%o3x0VveJUSfvMr2wWDrm*XsYoWzu+1X?;!^pp8GCDp#3h
z%}5q+>u=l?jFdCxNx%t+%>yhGP7aChWT>HLV++4K*;3jLMF-Quz1}Htqas6tO1F*_
zvaCWJA_eB94#O+<RwT1crde}334zkLDlYkOt+xL<-#Qw!gIJs8_Xkp0Dfg96`&&Kr
z4)WGTp4_}&EoP0p!8YXW>$|pb7BDLta>#HT-f{5v`Hd)vGKm?~#k!6ZU5t~|H5q2J
zQ6ZsXNt%7c(Gy-O0Bju-r~Pbyy$Se!!sI7%_cqt%&c+-L^4m+7j1>nkf(NZ-V-J;H
z$d;{k)&J5Z`XL1{{JwM5j1&*K6?|^>!nvIWFO?U>hQEqjdvw}^-eI{xYNVWMS5!So
zMtw|sg@igH*^c~MpFI_RSMk_@7)l@bLv7<|#UJ$NM;bd~B#C73g^D~`r;t$gY|1#_
z<8Vau;&CWhT=}r^i|4rmh3GtX+V_@nj!C$9_xTU8_Ub^eE$pM_RNsBG*XIMtnR+Ae
zi{Azj9<T8O(&J}W##n-M=h3m!*vBgCbv^R9NsoI_o!Wh}Kf_m29^b&TIpJe{mME#g
zfIZj<4t;R@as=?a)^)1Sq5`bVE)}8#eyU~nB<d*N<U3JOpRHvafATRj<bH#XHD404
zleVw&TFyHZ?9{5l$BZA}Rj(HtP5&1JhF;C_TG36H+U@@?qk(2q_6F?bVNV_3T6{jy
z(pr>x*Tu^SQ2cKXP5kzb-D%qq$RvPY_y@SWHPiTiot(|nk}@KRLWOuPYD}Q(X3oeG
zcd|Uh2vLl}bhy08A<EQuk<oR>lLcmMaEJc88rej?J(^Nm!ujsoE?LBBt@bm^;kLhv
z@RJ<%h)Htk$1^WQ!qwQ%?|eK@M<Ym}-Mju*4%fefxqoZc4$QIrC;ImJFYMng9rSW$
z<1L&~R}f6xP7~z>=NXSg+ooU(VJ+bw6d!R;(#3UO(Hh~Y`SnmlJYk-08%%>Ywq5vq
zl-->SOF;iF!Q*=}ra2>?R@sy*?0-FfJxZokxTF7hKi?6`cb0G?Svk=^FOV!r(5Dw>
zD;7~|mD5}2q+F`rZe0C<Cu{8<hK4_b(bGQe(}V50bp3;@V9v0|OxKTq%r-BaoRXuI
zooMusYq$y9`;zAG$E=ZSG_x)_E}sK$Ze<?Hae1r=o)h1GNUD1f_c`?eHEi8pBTrag
zXv%AP+5XP*cRc4`Q2V}9;x#v-$2`~8NQ(V5tWDQmTK{Z}^KufHK!^zsR}4gPIBHf<
zTKvDgQ9Y!3lSHmb=5S7b(tXr2K*`*zON#|#e8@rsh;bwHQZMzDBYAAYr|_>SKX9!S
z!hcf&qt{`9`i*2+;EKJ*ON384Zzi2)Z!po%0;5RMtc_I%!W3B~2H+eC<@@X2<pB1(
zy#Ot$o_u&*k`}D5#e?kAh)K};vC19Y|6biLAakgnxj`{<|5N1Br@hFv&|`Y8$}_gx
z2~Xp<nUa59R^xSi|J=KTe0=@IBU^w$axd@PhjCq;+#}s|j;(Uo(zLUEk0lSE*o}au
z-T-kovOu59_G;83srZ!4uIdrZAk8302e3|y&k|nh_PoM0M&oDj_7qoU58I=2)dH~j
z70WWa^ZL}eZ90bWB%H+P_k&#<o3b3v$<wxi<vQ)&qSb_^Sh{ER#)@P+D<>&U*Jmi+
z<4xO;oRk4`!~qkXGn+j=lfjC=JQYlb`Oi7<#>&*I3d8l~mG$O7*ve6)ru~Zd{#uwE
zfX*daG8;AsuGN-yxxK=HF{e4W^<D$OQNbaC1(YPcWCj?gnTUR3{J`Jd1^(Gacv$hD
z4T{UA+PaEpcZDQ+Bqw&zP?2i&xc&?jb5M(I;6R(vdDK`Ta%bg2K1|*UgmM!?{K4Cd
z1DsRirv$>X6Y27|QUrhL%gG3bOS>g%FZT~7F&k47ek@!VbL3jJDlP9q2ejTsLuEav
zV*2-)pg_W>Wz^IwVi2O=Q6NNSer)XH`}cOuizE(Pd>6i-i>~pudB9`p(fTqD7gMj{
zsyls_vYI^eFakj(Tx73mu`nItTERa(vMLoGaeWw35OO2gT@~X+aqSLj6~UN<lU=_Y
z*>Ndg>o{?d%x*?1`2vtKc&P`;HFhS(;d39PtgmV)bz1N7gl5?u4EE0DT_wrwvPXef
z@hy>5@GVxN+`+%)D4=e_bH7)E&3!E#7x3RarQMQ5tDKblgq`w*H&+!dcvjJx($sMW
zH@p9Ur=HSk(z!`|m!?miuo$hDptV4`^DBCVFL{hK>t#bUXEUcW0(C1~+U!G1z+xDa
zR*rA%J76idinq>RSgGHI04bUeV<iWe`nxMXCZZlKIpx?q^3{OLRnTw~B>sWHGloZe
z=$~T@Q`O7(i`h1y|EVaj`ON{J(Zot10^kq0{76pM=sOR|TML6*UiPgY2gU8((*2fZ
z`3mz30Q~mlsXRS9gD#i}E?`LEpo<VMP0Z-zw5KF(nL;bYEFbi$tVu#?gYMC*!0fl}
zVtwNel$r9EFYvZL=Yz3ND}dT*;rtu+uwS)8xI^%LrGd=s;cb1Zdk0LsG|Aq>ucuxl
zJ0z3g)wtU~U!^H{{Vh4ot2y=cMFWep6TCL!XSKU7bA6Zs3Pgh4Zqkxe^_t=UBxhNt
z!=wX0%uO)rFAXYW7}{ofciCM@xy2n!@X7^%_BX%nA-Z5cglH01n61WdfffkS^I-)F
zfA1w*YWs<i=={TMzatXAG@*urkE$kU3TIZ<P)%iv@Z{Ei0!{|Wn(~_&0wi}f4KbS~
zC@-9CFt+%^ZEZQ5_yE>0ujz>P2ebImbg`rP$;fs|(OzlRXQ8rY>u$1CEx8#wnHrbW
zd%+WHQw%?8do!C|e96BzjDeBaWZ6<ya|`tr$^S3sS*7Z<MgV7k)80`&g>;F@Br%Om
zc2OUa2%|B-N-c1l{j}Hbl9^E3z_J{aJe=r3EhiAN5*F>|TfT~7xv=(z3wEdB<=tir
z>ZJSvjLv2)=`w|_tMEv8_l=p^mABk9@o*YdOqD!Fw{mt%J`q2fFyrWiyYGH;=RUWq
z#`O1SExE{b#5akV42AEy(;YEOf4X?Bp!P5Ah1rn}h3l3B?$0Sl-^Tl-FlTo#Nj%M@
zgsx@ZK00N6rc#KSQ)E3EVGH#-9w&9*P_@I=2Gb_J?6mGlME9-W?Ka6%$EW0*sRGnh
z@=h1u;=m7Qx=w<wpS>#R2aZ_ATC8pIJmdyh5!_==v3Lcx>htcrpE3Ct!*{0^k1XQ{
z7hGF&7=H3y!V8W)75;%$pHs9Y9cge7{JCl8w_dRhA5Q{kIFES7MeJ1&%IjC@3ut>p
z560)MPS&e~fF}sv$q((sDb^CoQTB{{xP?%y`P^(3=Bp8pn`zH%gF0ahy88Z(<1=6B
zyE)1BvCOQGoZgj~?{4oj%gV)32%~W;!2O)L@|=G(1^tdYV=y9Z>@YG6V+MTnxq_ge
zJejuR(7VwhM*A*HZr}Q+A4Sx|fAqB;E)AS%G`fN=!$P>bOMALqu6w2*ZMqtW@c9JS
zd{*DKxmdfBLg0v23n1L;Kh_c-<cCIo$%t!^ygQyb8@Y_@!Q}kwy33z=x$FQ3edMsU
z{~!NH!kC`b@;dH_ZNg8x7Y7o0w0lGJE3t;ZH7>d;^(!R=a5;*DHd<Z9cO^1^mwYYC
z=0RNFe3w?7V4PiAIj_LRmub(xFJEUV&2&fqwcY<P^*$-Mw{i6jgjVWCOeT9DST4v`
z(#3{?z!GFmmZ$zIm}r!E+TKp8y}#Bf_oQOrzO`1*nn(>oktsaQhN#+VDJvvY)0(~G
zcCX%44yI1X<PwUb4_9DUdv1H<4<EBhep;ABuBd5h>Q6d%Z6RCUV#?@TnQeYzJs3FW
zk=4XPi4Qi^a=+_%DjZ^wLs^$w6E<#Qg%jnn6_4%#?UHHbvhcDSgBJtl5R~fNRNeEN
z{2NDoBLuIi=j(W6KfJEYQmY{<+L258nLOOC%&rWQt7O!A9Q=kD<a$K7NoROCaTj^I
z%!EW1+LCBpgAN*S1s_~Y_%7bjyYJSNo%_Zql&HS(#aRMmmVd9Tm_a-DADv+wgAO~l
zlYIU#&fjGIdD=ehxAL|Wx$(KB>zApZ*@-TX2wRud!Us#_vBMSCD+W?p>@QOopuhRr
zEEsYbfCSS7)D`~F?i<p%lKvBMKb!*(I}Sk5iz{e6b&G_qvs<K~d*2Qx74$T=HYMFH
zOXB+kko6T)v?YiGpEowM;+sUL=49>@--HQd{WPnRX`xUEfEV9XD)*1SC$m$!ph56L
zTY+@UJ7D8`Y_}jXk%7?{XE5+4dbekaRFmTI>99LujC#(mThw`i_Gr|+Cpm4mItt)U
z0N20OS0W4CJ`Jy88R~=MHYyDLSt`yA2WW5<R{!jOM_>OoF;TZgCi1VbG1GT9kA5TQ
z3L)e|stCjd28XYLGo63lO!*I>5wG9Jy1K0JdB|^!jdzgF7IGT``dcxmN>$Q)%^V1X
zPL|wuc_vAzyRhk|T2`|5vTsm=AF^&Y_WL~0V4bp|c4Rc8AUCd_U7Rdn4W;%^{fypu
z5?g$+nZdd#=Nn=-wPYu|-sxW0Mw>A!Ocg$V%v)EspL;3ke8?M3^Aa{G6JGtC%-Tpc
z-jhmDsT7Ut4*n^ePxet!JJM)<4V%77xOVhD>}Yo2?~X4nP1rr+cRZXDj#WId`R3v2
zkN;qBF*E$bJ^`{DCFGw+ro@g6pB1c;-VYPhe#F8+6L`}d75bEaB0TsK;CJ>%yP2^F
zn%UYVIIHdV<>7{EF=x{|PM4x#M3?hGLgq&Avo7YI@`@PBHI4e~jB+4GOZ>$JukE|c
z^Q!(kfKa>p@Mr*XE``JrO(AZ78s6robm1KS*@LYnl%%VW)F&%&XIFAI&(+gshJye_
zzK?k1&q@R#nfh#uJ{~kBlFyjq_W6t(4_fIPXCzb%R)1peJw)#K*oB14KCqv*=Q89W
zsoHz9g!GAEcQoi0#hEzLRQw~qmpC?Xe0?F1o&~WVC)2;44Ps9A`>wOwhL_od0M+zg
z<CZ^ty#iFIqtw^MS2MZ0Ftp!kPaxfp77>rNuY09S5bV*(<3Vu-PQQY!F+In*kqNFk
z_b@c^*#64c)f^4YP_ovX5?uzj22(vJj7#UUUr7m@p!w)cz!<|5D~`Mf_gfqFr9_S3
zuf@fb%}(Up*2eg8z^tTld}m22>*iKf*Gsb0^QZPNOUgq3<<k#=O3$Uw7%=0B*wj}R
zD}mc23+G^I+Nq3kGWUO+Ubf7Pt)K6gi<VMo%+r?Z%6cEWj~CsH_H{ood^cV0=)T+N
zY<KoONkAc^*x8x#uRf>n*9@Gj!AE;IEBg=qObfVl@CSWHh}bj(lWZ9mRszvyI=Of|
z^67wm-)KjX(Zw+(_wUpJL9&wskqthWzz!UCPhl^l^ih+y%dRRUJ|e>irdzBej{nfN
zC|`U9z#6=uj(sq>=;HtUDwa>Omzk+Q<9|Wk-G)+BmB1Hr#=XFU+V4dd_b(_xcHN_q
z(Tlq`o8nfX;!6m-p0NY3Q)CxFT@tC({GbO#?RUHGCHbtJ4e-zX`+m!SLJW&82d%dm
zzyEhb4wzo`&#ZggBE{G^z#xiULW=_=_j7o-Cvj)oIGRbCFMbHa@M?N28O1-+V{-@W
zm<f8T<j!CWW#*|{VKGST@L1OVq?%^n+Ov!=&X>CWt+B{QjU`$pXmO})NgJS>{vRa(
z!*NB|4?~csy8k{+n3{=5Kqy=vN{Eg8bZlz8j4M9+df8qtY^3(ZfF;ZIy=l)0J<9TJ
zg7ky_Z>+PqKRGLXGPwPiv&+%zmF54Av*>hk<+7j9LDzWMB}q2e=4r43Mo=!sbqX&+
z!Wyr&J!O7QQ(zNjh|oFlw;>flLdjfHOv=$^+Fs1E4ej!WMFmEdLSth_#v&StV^Hwg
z-(7L%vV~XS>ZVj~zo&J-(9X(%!VE6oA14xtfS6rM@CPf5XU4H9zsupEkTC`6{GCqv
zl!e%IsX+Zq@<PA#1eF;uhyDH2)HD)U>s%*cGK$CV=-}@Ea$3ixYxgon`>gw>`gTF=
z9^(IXF#>S^L01&i5&9l;>gy=E<|m&P#_y?RM%IHV_@=Y}P{O0XTUWvdc6u3PSN`~)
zUczN2{5sUvDdSrR53O8fX%mrMqBAO?JOKqpUm}tWa7O-FP2>jI*NYk|a;hQi0g4a2
zkqr5<B#`21A{hq=`E#mISz1W9B~c21`98M|$kUopmd!#0S{~+ZYo>hNFGG#2efw`e
zXWILb0M0zu&CCcIaBXq_OBwU%pg(Lj$f%hzJX0*g(lyS!6~et(09>W9=n4uT{K@&#
zAG7l_<lDHDYc0OVV&arNCMB9HmoAwcI*=;4dbdg`T<CJbn-@Gq*YD&0bB0Ym0@(Iy
zi{`2z!)YpgWmn*?F(X++!*t+Yq3PFM@<Q2RD$_hgizcfA0+iKcUAm`|z48U#NQDqr
zvjGLx<{>*zcEsO#+M^ip{YFbjE|crAR6uOowWDkb%fmw(i)7_;6{m+N?mu24cKOXX
zy_&AwFtHE66!73`oP!a9myn1MF%;s3l=v^K=X|if8{S^f9Wk7RKGNvLh>LT8;4ews
zR?~~ji&Mgw=Dyj)0rP&|?zlSUT=zI~#9kyt5^u0ak=Pkdr0EA^U-=7$xtg~6&f$#K
ze-?B@L(C3~j92n>oxtm4$sfZD4@h0MiuuF(B5_?(6Pdp@HX5oAnWs|7ji>^je`U*!
znM?W4-gr3MwyxKp_v;Q}l!1F35l;-=J1Mbtap?x$FOe6GF`cg$>IW~-Xbi)ftM@IO
zR!+)R8NqRr9(4-7Jx^fOC85)>yVu_za@ZZ>P@}*6Wov)wRRf5QGnKMaEF>VNQ1ugK
z?ay`Ag$tjvwa1VBDVWZxB=WGp#p9DZx*MsJI!s?w2}zMSaAvR$p3Jo<BrauVi&~i1
zvgnTJ;yPvzUa!`&tV!5mF$q{%^w(Y<M^6_RN%RXuUE(M+k{}c`f_!H|Ok`iuZM~V+
zvyxWxO8NvDD6RkU{gt06PfRg7UgU1o#4_!Rr$s+v06mzS66uY{2@GDB?lcQs#F=}z
zrJ0dKpQ(cX8<PQOZ6QiL(PSW3*Ey$?oi>9}v1LZfO0TN&7U@;wB8)CZ`1*#{K;LbE
z-{#j-2l%<{q0wddIU|8d{%G(9a1j6+c%*l7?-l|<fmqJWc&v^}tLe2{llZ#65PZ@D
zO4-Z#Z;%lo)|!5$b{~Y|!at2l->r3q()~&_f673vw-i`6ilc=n^4!cX%mvVcUi1ol
zK)7&^ldfQV1|K{{1jP4ZEW(;GAGjWJZ0Z|FE<z7JP1(JGIWRTiOzdSKPMqc&(xA=n
z87e6G0>M!$Hoo|?uwSEjESIP}^j4N?Cfm0<C<|;+fm+NvP!;Ii@d(hKok0fZ%j_jP
zA22}XZn`Wz1TTRx#3C>aN)l4z3$n3B5ISGhoI>=~e*UVC(?Gvt8)LH~ZG+nV#oxz%
zdK+<r$AMv?MH=!#c55{NK5aH^wzI;?cZHJSbm6F@NYOX)y*!izjZcw?Zq=3TH)Wog
zIfcr3{fxjcV<$sgKNJ4q$q{Vea-^umav4pXa`WE8^lRysw_+zfM{<7=@A=iFi2qIb
zv5tgF$4U_w!!o|y&g?y6bh{`kW)-3Lkb3l%vZ^Igo54opU=jbco5d@7N&Y2>0u95R
zLl8*|a>s0i)`^%4*sI%*s(S|Yao-^2A)-TVy<yd*QdnudO?397_Unbra6p84N+>$5
z;D|jtJ}Y2uxe;7fs>6od0!U6K>FppPk(UI<DL8s`td(@0+xlW+q~1L-JzI3*{MR%D
zHM=x75D26LRES*v_%}yxz^k-65^OJqKL6a4JjN{63ZaQbQJWrrhF+nNTrC8jLGR)i
zP)|bV6Tf#KlqR80Vsk0UZv6VKPYeCu^gx8K52x2OsYpY^MD~wnr#^J_o!YnW<5ogR
z>h|*aj<nIcT;lw|a`pmV4VXfjm5JPbAht&Uu!_BmDS*aKz3pGNe_w&d-M_g!4bHkk
zwZ!lIP$CL^8u&ai{cxuwDR+mR?3rFcxK_R)`3<oci|iS85?i7HHW@_goh0yYH+F;`
zn?wIZ^G_=&CV*N+aV6*E2$ECJS~ySlM4-8hd{g}SkdH?<Jz=z`+&!UKm}}G<$&BRc
z6H?qd9j&5pWYmT%Ah~ApXv&B_=WC%a;<hVf-6S*G3HRF)ip{Rt2SoCzXT~Lli8e^t
z{y-DVOlO?N$0b9*gbga^pXZKht3}I<!y($(OTB_1gxkQp;;Y3L0eXTjv1p>It+{|T
z9z1=UGUWtcl7b>}dO}iu5;vlzAz2qT1fN)bVc~6e{y~eX@6k|603cU{1MvE}4(wgM
zZ~1E(s!$Nv6Fy7_^U7Nsb@vBrM@N+SD3p;S$Z2Iy9<Nnf6k|GyMbKOoxerA##^s)U
z>+IMX9Rpgn3Z7UCNq75|LPRj!m<sv>jDYw+G-PYQgpw?af!=q}2*+b(G_LxX-bqAT
z6+FeNefMUxou+%nv$V6-f~aeW2aj$msTq(BqY{xvia>{Aov$N1<n~O+i*APP#<4G?
zJ4}UBS2%%sd)reM?kP=f+C6>TcbU(zsUt((Z74+@Lw}1fycsc!7_Z(WjaDRH@NeM$
zHBPh+rOpw!Whm5kO1<xLV<T!#x8E(C1wY}7<O~J4Ezdu@<-AdRjbAXGKHOcy{Xcx#
zEa9ynqBnAAsGoxb`zzn~V@8nEXAEPYdS^cYwd@kdY~_v~2y&KKejOG5x1(ouN!U5j
zl2JrNMM8dcIUXf#8|O><WgomBtC^x%`D|2YaY%1FpQ%Dg$G6Wev1Bv7*1Y46eFId9
zc5$Ss+&%cRp3_IrWpv2m!bNmL1cmvHoxpGklom4w_pxyJC9tD(E$SuPnx}?nRYFEi
zvn!_{NS5htCm@Og@{sdJz}1^rjI}r!N;DT7?v6++G?zM};J%OCuvMZa99<yvum850
z#0ZjAx*mC3t?xLAK%U+K>`3aU)9bHl)7SL6+X%;G$sxBE*}(q+0K`4(d@EK84=;D&
zg}~bqo&nefH`T?_>eD^x;v@dX1e>C!cCEolnBbFQF8bxW%YIwv_Nob(siMH#g2kB^
z`*Q0>8LZ<U<TxNuMLj<FW7QUVbaZnHQV@RK!VDsKrJcRGpXJ6jHq-Q%y!s%#TkH0|
z9THlyrv4F~uo`bG(UjYdnQI$dM#?Jxh?YtFUc&ZmhAfHjPR#`8uV}hhGS$*GJpO^=
zdBl>o!vfaUT~+D>TDp|cFADytme%I&6(mTdr?ar?it4R5vJ*Uq#pW5E5ng1|yK-x{
zPS&<(t0|Wrk$JXXBq%*`_k`<tCBCpD$Q^}1g4}rbd12nl+l{zKufG1Gs#MEUzMw4r
zCg%0{pQJAx2dsW2h@`Phf(n8gy<;%1{WS{daTIJu|D9@$ZZVgWl=9%Fl~Kj{l5)xo
ziGr?gMWz~|oBu%)%^5UirV&ga&z@1ynm!rUzN@`Jd!EF%(}EWWVm&X>jiid$jRVD)
z^H(5xbt);W>!POXQpJE?#LnPZfku3e3c0;n3BkfD1<B)#x<VD)Sw{DlCb_+C;Fw;i
z@ww4{$Ak+Xx)9>cq7ifKCN>w%aJ90MbyQa0ucT}FV}I1oh4BX@cIVHTbrYkTwXyuS
zy0`n7KFD9ip6wBQha4UjcajCZiYSzs_lLqSf&=&S2k!R8PO~`42v+*_tQMwonM>ar
zc(Y773hPa{e8!qVISvo(<NP*#k04h(N&82dprdS{;M_PQvw2iN&_E#QX*C?G6lLev
z-I%pmbL2!gkhoUixW<uPT~M!S8sz2?(`y8`%yHm6gC924gmhZW>3~A_afkh})QnPk
zT4ML?z3n$}5N)?c>K~GUZzOzFnL$>YifM&)8aL2gGM?_6I%`gw>pphd+n#65tkjvr
zym>S&Y-2ACkG-N8@A8Dq@lu5yADUDQjl0t$aAgQ!v9~B-zjC=i_~o-iy;Oz|fL`P1
za5S|9>_~v;KTkjHM_>`G6)Vn~PW_$3{N|!7-^^9__5Cn1G3(@r^`I+uho!age^6b&
zEz25F^LQ08LTZ!XSeCUZq39~ErmT+@zA(P#UR^>D80ypM6F;8+j=tt47#zCHwy}b3
zdE_+gWL9>VJTzJZSbq@}7#ccPc0(Z*TdMOIa#sRuUlpdrxWMJ8M90z)y!M7{_>>{)
za255F>bt#UJ%e$^PU_s*L-&UOjjC2l!k=|te;z3ARAt?S)QpxjSY3jYEb@+sp!TPg
zm@la%OjA~+aZb-by7r3<4>e#Tf^8bJAU_A>h<GXeYum>ZimZwyqg5rVK|DAY$WMnM
z`0c^ZvQ{Z<_F@%6Olewbz%heoST0QSX$BAEk%hM%&r}rvP%M%`QwtFam=x4kVL--8
z59l#E<qya=fv07F0t{ZOle1qlM_;7U+R{t?XpX7Ys<%|Ry}*^0rcXm79U$j4fS_a6
z30bGH$A;9N4&>|A-?{Y`IXEhOF7JlA@GE<Gr+Hy+B!i=zY1%$8=0~*DSpNoFPOPW&
z%!Ki?O|O1~x0{>!3w1r098q@ePDL(Sgih><SVd0k?P)J`hk&@->XmuC-u~REukS#1
zuX^UYBKg=Jf~!Lw+jCD|(`^dD!1djte~xzJf@L?OhKu}CE`V+r+?W4l2OEbsl%|h)
zpT*jz<n4!3az+<>vBui0GT(Nx7j+699uW{ZtGnPf<hGEc^-JuZm9V#fqBPk4UfYxT
zSxd3fVrUoq{o22o(OkumAX?7*_uAU~hU+dsVb-%~bD${YTFQa77EflcN}Qy=rJzVK
z@xXU8EmmmAT{GZ6LlG^(ri7bJLwaHO6<;B4*0az40>BsP;3ma=Z1+QntM=Me=Ckl;
zNy_Jx=l#V1(A1#aZSdAJe;ze%ZpS|=;t;J4!k<1&%d2wTKP?%%sHd^{p}rCt(KmVb
zl){fIsT6h5n4u-zr??4+1=H@=iY!yfiwd!{n>8KyiCH^|RfjCA>hq6xExd{baHgb1
zT#?SZMED%pbQhk_3$c}cyo7|F_%v&<>+4TNH_*F-tjj&)Fi*hl)&g~fsk|*~E_sz=
zqO8A4#;<pL#--zD;7$+K*6NM5UleBlb!^B{Ne!>!9yTzTKwMQTOKdQqcMpSL>=qa{
z%j1qh>1Z<vGA|%O9y6?32m!^W@rC}Vm+8vZ68l@la;*xA(d^j~Lpq6xsMCaOzaA2=
zl{!e!UqIM|uHqB?-H!5;!f@qsKjg_=pUgSc7gP8atd6qS$A99%8Eu-c9^bJx5SD^;
zMQu@wm0uMX0Oh6xnXdPmX?To8k*<hNIiedH+=^f57E8bEk=cKvFF{R|v^zb|8}G$K
zZ2o3>ypRu9Q#kg=716EzVFQ4UwU~YfkyN#pI%YUkO4NUw+KieD!JjL887iC0LjAMD
zd+BRMz%iMrZPTBUOWQ*ZQx8z={zpM25Li032xklh1NX$9?nHk+J?z-un>}_#@==Gp
z7nKaGEF#ZVLtQ8_u%FD7^Hl_PI;<g116la|qg>Ct?BCEE`NZ(=CUaAH9cQ2VABXJL
z9&s6kRuF6_lYdnjT0lB=b{FbCOf7RG<n2`K`&9(201RuN+?3Te%Vry(UAYmf&?tZ>
zu)aSlVd)kG$2Q6P5V)UEK`00n`P}=Oo!Ge_OZwP628CqKe}N(>wM3~UQcfo?gk$ih
z;;K7S|IVlW$Pu|pQ3g7mLYva(C&vjK?Ue3DRJ*o2b27nHK{@D(I!KyYk%f<Pe&GG#
z92@l&Ci`627+ov^hXexX_?XR&`j|mAMsm1eiGQ~o%2|X=dkCTfg<wNb&HY&E(cJ-S
z=Ha}7^bH(<Gx%(Lt)5mu_kDA6{3S}ljsV!B`Xr!=^vjc`+r3xY4o{EU2whNmZ8dF`
z|6ro!Av{)%DnD4)zQ6=jbxWm2x~;JgDLG8#OlU}tL=udjCSQ$u4~VjPZ2rr3Hnt_<
z?do5`$WI=&yDm&}3@}hA+hpTsGw~f81Eap^!dZT>E>6!>|G4|gKoW595po$yUGkO{
zMZi1mHKUZ54Sy>KlJpf!53ZVjiRl_1UlM>C6oozwF#bZO-}9sW8gS$AH1NP{KQFxs
zO*0>&KzGZq(vdp7E+eBjO#xD@#R9xhm(=@d056XUKMo7K3PwDApR8Sc>6{SJMw@!u
z_ZFj(;XF4YjB*`+6d;i$!l`<K%YALmxyf$qdA50qP8sWgHH%ANQxF2)a|3l)0WHS$
zKCFDuh@jj-bwPwbGjf5J`{;EGy?$)4nuY(X9>T-m+p78}&AZ$k@TirZJcRc;RUHR!
zxKoUjvE?Q<re|BSr(GPor&G5A)Y+cyke+kY(em^neQeN=To~VgZ&9ghDD^{l4A@aq
zJ$ZxZEHSGpOX@t3C8X-j)1IXJst@_;$vRLnv;^?+s-L~A2mK7T5AmuQui91Is7{)?
zQk(kdr!y_M+}s+^nU<c>F}%&`h@AdN*}?tWyz9vEwH`}cI?n8AaX(m#ig|0v6=Ch(
zxsgP_I69D>g#c}O#&5@`vBL?aA!<zmgsW*uO}}Bx;1{o@LH1NdN|<0ED<q&P{srr{
zBXM8+fqFHW=j&Z&dqJS~_XHdMf}4D06P0g)OAFUtF4@Cr9$Pwfa8^k{S!MRHT?NKp
zDprYsch_yCngXymz$Hz_ehUvNofdU?-uEznoiK^vUeJR~ePMXH1Or@~BgXV3zBER<
zPmKS0`u|9K&#0!Nu4^=*_bSo}O+e{_bO=QO1q1~Fkt!(CJA@i~hkzm=9TgCfq6pFn
zMT+#U)X+O5)Bqvp=6T-x-aq%p9pk$hNya`oJA3SU_E>waHD{!x>4SAdTQOYHcPVhZ
z%38vB%YJ>(yleGcq*Bo)iPBY%CR1<NuDW-M8q-H}+e89;kq&!NU_&<6)}P|W(-Es6
zpO#1<G$@SeI84H}5WvINGQVI{ep#API;Wfp;AUD{eht}>WLK*mTgQc7SYxXc^T4j_
z3=k68%9@)`(Nnd%kK6!~CJ>^>IkBLPa&MYAnCK6quUvt(9>D<Z5TPUQ@+M1LSNgQE
z-w$*K==@diXZz^+@Pm`7*ZNA+ib~BpU19o#h@8`b;7=HyyJT~>El<^BDH;J<3(xTH
zF8Wb1Y|`+z-M`tCk6)EOzVpGZ>&$Q^IK5Dz(&k<n?%uzqJV&PF3&lGTJr_ztAvRD<
z0)li-@v42|$PVkK1Sx16J6sWj@-4boGcNFN?yTtuKf5UjrVh2p5sj|1k$V^Ukm7cp
z6gI>yyp&tXqIJiX$=7_nLLv`Gil=U<uD=L1=ZrjvprLvjk<6hG8|mGUY#XpOLy(n?
zuUI0v{5;E{tM$d|$gr@Voz>(gYkV4mem)o(vS()6=62AWLe$%TYav&dbD(n~VoKrY
zj7UUdS}K?yetAB$nsGkF7vb8RP-AdyVGX5ykcR!c#(OHVr*mwsrBNLgbou=Dff|E5
zCs{+qQ^AbTg3I&CqPE5mhNI~`RvIIMCk<=sS<&hn=xK(TbsBCnc&%gR!-Zb}<3MU^
z>Wuj8eLrXZQ}Y60lQaD!8`Ip@MQf(Xe^acToKmxtQ{Zw&8kS99NW6krBhWkEXpVG-
zK2GeuCNksqlfLf`T&JDqp_x)71IUUV0ByYL<dxn*2NotLNkL?)keHAxe<dPF2QbLQ
zT{cRVHdH9g-aX63x+LfAc%}I-;TUzus(06tW6Z_M3CtI6x?Y{@>-L-FWug#EW@EdF
z<h<aD+?u<G?-VgVVmj!v;#NBGjOY`k7*#p>A0{;|(!;#BlS!s*$)lzy9B%ZM7)dgB
z1zLqDCKH%~zHr(vOVG$BHX*QKp5aQb)BMFs$(suh?W^&0h3m6HRFcb^tN?mF^GBW|
z^({!J`@nw*#Ts|d9(>|`tVbqgUscT$5Z&m}h;@E;Q<nABV~fjOkpkSHM4jZl{KHn~
z%Rv<xLPWo9XGsr*Y6ukj_<W<R<6bUFxZ_0J7Ydm9*elBdNz{)$PHtxTztS}dq#s>X
zW@as4KYD)Snfi8w2v_>s-rqLMw|_q(wY{UzH`y`jfO@M&B}<B~(#tHY4jsB$<{$|)
zuYCc^2Fbd&dclyeGqUaPZLP<XTSM*G9ECo<%Zj7<R2-8I-4}XpI<Va;-xPD)R8)lR
zS5$J>$(`wFfqkhyw%aT5XpOsaB6c_bZd&KTBwxcXR|QZ@?I^^v(s|D4!@9xVw?+!6
zUYug>*IrqC*khH#%Z#?5|7@5sq}3%i+cF4@m0Ee$HZxNjD<$_WrDBTx$xBTV1(-X%
z@#k%p28e+!3MNa*Wwi-IcxDiE#jfA`S+T;u#dgxE7pBVXzb!%X70`ZvfN_B~+@b$M
ztl~7W@y(JY(`)`$&y7)C3Sr4_6!ry8oVA1=sl5TZRMwd9xk}A)#o=!jObAGk{&YyS
z?h-dO5u7-8Y){;?C2jDiV((S{w!=Swo6WtU6IlC8UbeuP>60bHz7h{h!tnRj0pb3k
z=7#U^FNd0djodlKk##S+Jtt~JveHPW49i!1IPPiYw-_{@o?H<{$Mdy_f8xtnp3PAI
z=GyMKXX=8FUAjy)OJO9o@4eC!%%=U!#9h-0VVXswNV{aylJDi!mbZ)}!5c0rhE^dh
zcM}U5mG7a4(uqll>{R$z*+N$#*ksh}BDuFuIhAm%mPJUb2$gTok4A-3`J&J-oQ@eD
zL6&i|?A_$TBpD2S+~l&?w0J5B_0D1G2^Z0oZ&V5YIPO-j1eC9We{M92r;l~q+bkEo
z3zrwV7mT$y4*s6psdRB$bP(R@Bl7*vEorF}W{7x_!CwP7(5vX}mE1Uu7#PU7pB(mB
z8#m3)Dj6PTEuf2me|pgDv_c4FzREo(oMu^hU+lb+fnwm8*5I`b5*D;g_Hker_<p!Z
z7W!*&<k6pntme5k*H8iMtx@CUZYuH?h^#G>d}4@xawBtpC}I1HX}fA~nXFr1Y0qNE
z48p~i&YyQZ^?Xt&9buOFj@Yq7`*kblB4Aljn0aq$hW0N5&ONR=mZ9LKI6>L_0bLy_
z@<9n11_h%^gPF4eGu0JB%Y_nR{W^?LVcJ2`<doJ&yfW>Fk-B}wCE3zl>nj)?OMDnl
zd}G>=fvFXRmq=r_pRt~?6<n_wyj0*=O^%57MUL?nuaGe?MhR99qEMI1C9{+RM8MQY
zoEZDx8T$M6jak?LQ^sx);v$*F<SxXW_IE|x4l9i@eS>nXy%$ZKSmByG?5xG?Q>{lY
zEI3x)%>BsINR6Z*2$%oteJw#Fh(eeSH!lf(l?*u(OdBY>xLVwebENsiPFe=)N{ii4
zAeB#g_TbJ=>?`6GJ;2;?rmgAfBU>zThPAS#;6f(U8<WJIiup+C*B{_W=@-~^dbI!a
z*g$e^stMIBt61{=_^2l)A%nVh2;lUP>aalZ!z#md?n@SG?HnrXa8bxakm~vXe*BqW
z1HY^xlRCzP9h|l`KQb;~{DhY2+A5@gU4!VzpGH}-1H-KKhtElo66VrNo3!!B2_IBo
zJO#l@7LB_RzcnSYDPo)Z-G#ps=UOS^gV2zmyk*~E*<xlXT2vM*6|hb#?6Vq&5H`1;
zTHiSxuu6^#T2|bBoI|kdG(t0w{j>__y*+imH{%M(NWfO3LX;#*QZ0;D(Y_h;tdV<S
zLoWx5MHujYBYgp>@x7jfT4sI6NA9)v!#L(r5~=<u(^PglU~s3UMPtCZA+3`VH8*+H
zBQno!cj%GN3XP3f{PI_`MjAoMF3Ns@&Oyk|wG*Je4Nv_3=MN11^67Di6<BmHYgyu@
zL1ifzZD3W%!=0+4$eR}#!)JQ`QTz4FsyE+_DsoNb$k&Sv;4Hx$`36F8Rdd+#>f)`S
z#}A_kG)_ln6Y`;NbKiCpzlC%>AW_alWW4!t`0oCM%iAt);U^N%0R>*#QfUmw2IjqF
z5CKMK@-&+&dJ@jZF&I_`0D!l%AWftcv9OQjX-jJJ=c1w;Mk<Z|<{VO?D?H5=p7&-{
zQk0IAD@6x2D^8UvO&RB}HSQZFzwtD_N2W4*9X8iQ4d3n^%N)FXWa9cG!Ny{;uCL-y
zGq?Q_c;{&*e%7~H?GJ~ixn|PX_rIS!U}Zs~L9p4XuIVkFSrLMG?WA#0lZov|t-!`x
zZF8Zf9y>)%X0^$;h?r8{c}`%kbUC{YHQ_HdNpVkM+=|@!*iO3i{b8<y(Fgq>;{|dC
zYgm+ba{G3h9#MfGP*ju-J<(L~`8e~1c(yj>r{~X&$Ns3&Xi>LDr(wn|8nPXRU<I0L
zHMIi;;tZ4$^YmNevOB+?TH@~f^Kv4~yR$}?eKC3C=M6yyWbdr`vx)?gniY#Tmw)Tr
zs4D*%UG8ol?yY&`7*Ev6!X#@+GOgdYR+C~nr>tX*>KcF4u`IlQ+OM57Z+b@UNzl+Z
zA6Wt}y<K@H<B@m&`F?FQc`rgml$=e}BAAxGwxmgrH|DN;{-Dw|_w7F}i;Cl+fNZB$
z#n1Pe<+q%^>222A+jBT7@g8wn$}&H^@o4AizIOQ*rF#++=5n*v>MEo4QR#2`%9x{}
zO&G=lcK@;cLZMi1%;oL%WvZN<+$_YqK@7LBkEdm=-q_WB$(F617n%bX(EZ|o+1@MD
z%ImR=QjmU}-Tsm5U&P65SKpj)2d#<-LDYjYm|nEz7A&7U?Cl?25rcQGU*9vaZHb9n
zd{?oQ>ovl~uRhXuq5r(yt#~i}vk4o!YZIkO3|QT$s7)P9|Eys_PTIB)&5Efv%JKVA
zW$6E>Y~mMoUPkpH-}g7wT93yoqQhgbd}Q@hiO%Gw^Cm@!0;l=<j=0ggDrVk-XqMgO
zXNuy`C<q;vNM!uA_?TURwzLe3`cC!>vzr7}jynTZ0c_QX96{ziN8A2q8@f&Do52u$
z%M$bM>4F1h#205rmFb$40~_%N($&FZ3x=|F(uQ8)Gro5$6n{U$488o;W)?c(P}@md
zukk8Ic$|;3EGUY=2TD7pk;5w#LwL$`os;vtW@T{`8I9*lmii-pcp%ko8TK<FdHBcS
zqF_6vsZ@)qZ1Vy4cE~gvVdeaPzLx)L0gRpeR<Al&R%F6H%dTQal-2<DbBq43K?k15
zSVfyo_Lb)Zrb1tuSD)Od4JEnnduI)N%gdYlGm_N$D2%V@@2EN?+UEj?heHcTHjn?$
z66l8u>qe^$hH_5{G*m|y9Ot<yu;(QW;Rd|n{VHX#FYH&ayU(nD=a_#A9vGu2Ut3Wk
z;~Rvapd*YOhu}jgw+k0Z#uXmKTqGCfUe?`$ui(`InYRBw6}rITRHG>?HE|CF>m5wP
z`1N1=CKSdGUdf!lc7rq*E8J8_YFjT`kvPi-yhneIs;8e-yS3J1HO$&ev&oMuK&*MK
zlSD5T{iTSA3M1xmWJ}_^L<rV#?o{N`i8WQbF=hoN5QLoAr&Ag0Ylm=@q2An_++!1F
zXoe^KG$B4>GH%d#R9FZ=kpIeU{Wvm_w|0)44A0g=LcZgv_+&ml+a#Ndf0FNb-Q&+D
z%;$fO6^Yi!RSy!NH7O`8yrAadDESKpasCp$f(~@m&8>C3$XB2`&7cmk31{aq_PG)P
zZO&H<FP-GDekMN=grxpeC)3$oKSQ3ChZW#ZN#U(vx^*`-poA89Yv@A;_z47nfeuUF
zMIim~VkkvN6IiB)o2X!uL%OF&Bl56K_my826NTZx%D@?b#dB#8>GsEd^>{8SV(<+J
z+U$B<*6W-6qljraeBXO6_^AT(DpuL@$M{Wt{0uyHsXeLMbi!@`+8e?r@7IAgt$5aV
zjzi%tod7dDWd-qYl(jN-FP_LdM+X+qGkLMy{1%;Z7kscguCu6qUOuO_c@ee|(iQ_c
z$oLt@na7svQx+IL*Qo*~#59G_nQV>+^?~-`!ezi`&@1P*VBi@XR}Sn;{)28w;i-#=
z7slIdF1C8Ul0aQ4b4I!;j^)a^uP>BQWk^By>@ai&IOg)~K$|wK5KZGYJInn=YXAJr
z;?SW)%xQnN-E}g*7b^+5G4|2%7RBs7<SCXliXIss4BX5~6Aqb8OK-U*kLKN7?S}A<
zq+V-VgRK`r3Qh356nEEhb5V}X#9L)pttf#7KaZ=9{qrNp(zdb&HB!8(am2SlQL*x8
zAwDajI@(kJ2o0i1+G&I1zh2?Wuj@eRyHWT_kON?Kjo*0QzOCvjKc4{sc)PI1(6G-6
zCsFiWeK2|=?b=2#qz3vonF9v}Mr~)dPQgN0p-2xgdGKNjGQ)5+RiQ_Ik51s5M!m=a
z012P>9e1&nDp@=n{M$UwAB4n*NNtYZ`y7P3MXIzjjR16S`{Wh_yU5<h7socUx1#`(
zrC83geqiHl=?!(B9(rOV{Do3z@v-j~2do-o|7xH95X|%8aPIt|sU1meaVM7#IFG>I
ziE9;4BT&Li;gtQPIrXV`!r#{@4HVykFw)<deqy_NNPJQ~5t5zI=u?p<Wd?C&+L|j%
zo3s8!fM@Ud0+jPicM&hp$)Ib$&k!IpG>?w)RBU~;b~9G%To%AXFf!?TS{c*Z@z#jb
z&4^E_NS*quj2QWL-3O<l9AB${#eqbcE2@D9J%zaVOK5N5YR%rKm#Vhzdz}*G1Q&3s
z=67EZuGh><vN9KcKhqUs8v?|##J9csy_eQ&|M0rx%H#MJx)#>0i|VWyej?|lfbL`a
z;lF$A7qPg%VTK@j_vLc|Y!a$U=ma|CO9m6dLb&R*8NKDd&?$%T?SfgiTWPJ!_;Bah
z26J=E<fkX0p(_hxl2Qac492jBpW5)x|Is@hJ^f44zW=E^8vX3el*M^hmzhS|6*QyA
zA?&gmq<tD-N&C5*=#e%Bb>&0*ZmOQRa$T=KZIAUG9?M|E3rX<A!17z%E!(A$^VO^@
zO0QC5`tq#P-@0l^9$3!r-a^^R2rO^7^gWkGe2|{z37Y+$5+h(AeehU8vf64p<Z^aK
z+dMvnppr0S6_FeLS_@$JSb)<9fU?VTp;$f4r9am<HO>w4A2vOUrq)inxABsW^gcv1
zS*tuDOtz#@zmW<csGBIsZsDW-*GDRYS2#<zxAoTJl)BIa<ZYi6Y8r@}OvgR-ya~R6
z!P-o_+pC}E$eJXZhbUMYE4f6o5(Zz4vj^SE1Q9FYDQh^bK^qxiS!ZUXigJ`{P$8r6
z=slUzV091n<!D(BSgK0|vVEX98a`$|it(qX{p~tM+;x>ozF*E>g=^gC`Yr?y<9P>3
z=(+vmQKE@)_x41Y;S^qoCk|Pm(cag>=TpTVbh6zH{99UfC+E^1M68&Ng}872SRuh`
z_`2ZA^|e*>l!$44>~F$`e?$-`AibP~G`h!xG&;-^(#E{;uxuy&{v3xPg*z*DiwI|5
zaD+VS9IN?R-S)m}+3sM&V^?+LjyYb9y#ZPUq1Wl{g056UO51XdQ;p`v-n1pgzucS|
zdtzpW73w%I)i^KJ4wd=U;jdsSTeU?17#H&K!Y}l_J`XW{*d2X1g=F~7591=A6G&@w
z+W^CMX%s5^4&z?gj|ZTK)_yjK4&$25nY);#b(@I`p|QNt6LIl~PL*vfT&0WVG~(8S
zC9D=~#Da}_HQ?T<6z_!tUD?bnaQM}Fdjg_Q9H)|5=UMML2m|RNVNe?t?xvNHP|`!3
zKy1JCayb+C+Ml>MEFz&#%k|&Qy38wbR4%<SFVb}Hy=CG(Yevgc3`O#wR>&!OupLfB
z4~fmkBf{H_>f9)71wGQ>h0Ce~^FSMgU5YsDl2_JEraGYx!a_}HX|y9eB5YvBoa<<$
z1VS+QkpnGpws;9m0kJ3%*y6lI7~>A*Eb)+r<IvFb<%Bq1qU5a*)0UU=_38=!k`3dD
zce+nfh*6-KyOm8b7x(G}$E=?8vkLW{^YkHyldR(wdqagyUc~f@0s8ii;x3yz&ySa8
zo`x+qH6$la|7s0<!*<V1ZMF$b!!wmAZj5o6r4HP8?>e_xaDd=Og`MS*z_$k&YmV5P
zZhu-J47r<$V_M%C!(~EPjvZ2@f;-v7`36*O@0M1#iAX)bQQi~eQqx_ZA3suK3=Ob?
z$1R^c%zm^G0W4=7_lA)E@}JolEFEhr5wH=l*RPf1<%2M{^JiU@bW?WS#i__9c?OPP
z5lP8$k2!7@6NAs*MHX^>i~f5RfnD1k^92jo|B|dbvPB<;OG7RB{XvV^pyR?iKTBYx
zBzP2ls!p-9@cw-5Ej%!jT~7e3Rc&JyVV0Op?yLb!+1zgbOHAK<3dPy&ZQdn5M_{!D
z&d4p`;qRM?4o1QSZf%3{BhUwbUg2tZPnS=Ra9R4?HF;*yuumEdHBgY>fPxJrEVvv8
zBnZd8JokvC=39Bhn^GCU)!;|c!c<ST=c{yJoF8Tq$G}QPyn4oz2cU_Q>VCpeVCE(A
zk=ww&=waHB=|6hxH~RS@K;udtJbmvOXN&TX7?xS#%GlCBIO4FWk<O}R;9%YbPN_KJ
z1jWHz7pgoar}x!evj&dPuwmva<WghEpDB;TtU7te)!2;|`uz~CEov;V%m(f95r%^!
zWI{_~+lCV)m(49oEj8+?7;Ai)0pW1rh3#v2gYI%z8}(YNJR0%lBXI|{Ej*G)rv@6N
zM0d$-6S=JguB75&4yPKpG(-S>AXCGyCt<*|)9Z)8SNj!D@bSm<wLL6JFiOHs`n%3z
zIZ#dV@v&Y+65>OsPYSB*d=w~IWtgylaM(njxRb})_#s)`21Yl|;aJJ={3|G}p3HS1
zW$igV67p4hGJgNLJUWYV20LQF(swOmG>OdLJ3PYsBTuT|*zz*BUz)*gZxol`qBYE2
z4WssaEU`I=4Z+pC?6W!cM2vitLl!D`xRZ#7fF+RIcjz96>;7v?Cq7yqKj(q;;GH0N
zlHi^o6sbj7Ux*yn<`MChC+|H>bZT`f@`iJWTN*ea3wIbw44#?Ueh6%nV|%_<@6StP
zIbo^93`?HaS**ZL{wx$eg$D&ZdPu%Ej*er?$(O8MJ@AyWXoO;xjxtl;PLX)>Iz5DD
zrJ}U2G+j;=B={(shp-iD4u#v!K1+@8qzJ#0!$_Nvdw_UXlsG~1)03IwI7~bN$6~I&
zbo8o|K8$J=HL8pF#*gRm-~#>HtvDkHJ*8U6^dlnaz*Lo=L)X}puZ7S3KpaiY1^XQa
z@KJ1S)JYFpHm^iuAQAikRNwx<odge*7-DItk;~m7;H*>R68+q;Htu!i8h`*8X>k*2
z${X9pQFp>mZI$Y`K{)Q*$=>8uW`Rk$$@;AG>Nle;yw1?1_>8ygU0WHyP>P?+FCsnx
zjDOW#w_R`U8}^YGhLplm<zD|p#1EFK5Xs0DMzV($#`TnAAr0NoM){DAT&FuO!}Lfo
z?pG|6CnPgg>dICxBN&8ZSpZ<9*KbR7_r^^KEf#V*NwhF+e1w6~@%#u+QbO|KY_cRW
zh~@|e_%RE`Iyu1rpMO)r#_lKTyHeezm^i)uX1#LPSt5LQ9Q04^Teg6Baq}z7t`MX8
zu5vrnGreE2n1`k}h`c}D;kbCymh`5acG|DNCr^|yhc{h&51H)oMWmft^U5Py^4TzM
zvyF{7b6qkZO$(IEDep=gHe%!BeqD-x(%3la>blgo<~=9x`q1lPT-OstZ^rmf!OW0@
z)64dY%U1Zl=aUb^3NK2|g5iIG>rk7u)2DqzWZR3c-!G<}xVS}M{=u~7e~@~{lumrd
z+qc;6+Z9NV&ZCe{MM3dcO+_)U;pn0<)seKA<(33(<K2Zl)^PSfUz0~n<$juxiAF~J
zuZpT}+n%EC*|@FHa*@ZXR?FwFEvV?8#qR&=I=l9qcU$TU>a9N;u~d=Q%HIt_xznaJ
zUl@uGYz87hXKNOl-#4?k9P?{!mwwXD`R8f{+qKsEWGade8;S*jREmyy9P{X9JUQp&
z<>l$62=X2qv{zbT(;G;YuHoZw#U>DVl<UAge`FA}?GvZ&ldpnY_^GJ;OCAK8_h7L6
zr^$!}fvAf#a?}YT9M<j=QDD0657_vtu8n7pWvwn??hKN@p9+e_j-HZ07Sb-4q4JiK
z$6li<g^ZiE(w%KP*_h$x6i2k!ii+L=e)l#hF@<NWLVCEufX?k%NgFY<X<lEmfbSVS
z5l3*=-l-aXh7Y|%s+f75Z=)M{YYEP$9>0@PrXVZ4W{0dZ^7N&@ma=mBco=$eRQH{o
z0~;oU9g{|79G2k;Zd~eo=?Hkzvd;?qN8%f96O2q3go3msaeC+|5T3fVMAddH#G$cv
zMX6o%Ec#W#O$6gEH<(<p*lET6;jPe9ej_pO>4V1L_AI+Bx~C);()R(vQ7%L`U}mEG
zMN047k<hwLJcgA%V<6@?J{0@dQp=P=>A9tm&AZ3|3^?oECr{CrJpOFTM^@+kre7ef
zbDqR!5Q4c&^!zuL*<IV;7SO3LD>sx+3Rj<*K?W@JJ(tcm+}a+ch4{J|0MW2M8s43I
z;%U+J5A}lnWCE+$xu;!jdiJkNV&02?a1OwDmVF`r_;j%&lGxh#7sjt!UAk--I_%z8
zZK$q3pMqPop7aPm(e4{3r;|hq+IYf&@o@c$P40&!mqdQNxB!x1#0l|iVSf)O9p|q~
z<GNl9;B)tN4)}VP%DZ;x@sK#PfIF=cvd1>qEzpfF7D<D+RYRc?j91=Uq0bhLdPe|c
z$X-xPV0tL-_Zg{wNNKl6Z=h3Nq=h&gd=*PKk?C%)Rnhg~7q)5q`XTe^FGnz$X?5zw
zuU?E$k>q8f<2L;OAnUo<#j|J4j04ln=pJ6?t~#sJ;14{oG*hbm*H}FHI!+LI7EerH
zeF<Lz|B8kQFPwvi0rgNhbpe;vEA^OFwBz9volNe&wmA(n8YMWQvnSXv!C{9^is~S-
zeER$ldw}dzyThMH!$)JK_kAri;>reSWZrdxn@5KD(o1uq5}_io|JpI<Jk&MBB((Xs
zn-p`zbzE%AWh5po0nG=@v~TD?6;6{Vg=gz&#>k-Ka!-|O7~uh`-(wD<@C7tx0kecS
zyDn;*{_6`E2Uds11DUXTr=CktFyI}LRS&^?omaJ=SQ(fs#E;tHUf1*7gkX8y!m_|T
zd-Ug%L}ry9=Ie40<lpuVF{zk@sEh~LJAg{J#Q1%^@7&4Rh+Nttl+EgzY4}n)OoQQf
zO{h7^mJ#uytP(uBI0^6pKGVntoB#_jy~lMUKtjz=_TX;(_+>c2+U5R&lXKO^Y{Y@g
z5?q#uCJAc=UyU-V<ajs<oU0pDM*$b8FzWBM;lOJ$DK;(!SCTKDAXd-d(B5cqRxaN3
z7Msn)ZZpys$27vvKPXr~u~UwE`DB0~xN1v#Z<JGRcE77A{Ll3%P&XMBabZB$2F<*6
z_Pu&tmUIg_){UY`s))mFQ}5ytxN!Y>5;QdtghBy-qmz#1ebGONYA%+GdGEdIu`9vW
z*>ITKUy+8y%Qh&DhTAYm98vZu_6hUi9;^^?fA~VX&#*=JQhk2rYPtIb^f!!Tunl@d
zB=_%<{#~?C=*L~Uk6hoHhb)PcwOT^I0Tc%27`+1KD;<34*<4>i*f~-4DCcGYS(qqT
z;^N>B=K7^a)L)Xe*CUuK9)KkH)w4+RalL=i%X<y|39NMwivc*LeFX5MN3}n`>XE@=
z)??3KiP(!k_4oOEVbu5jtx<-43u|<v{A?rucS1+BwO(vl9pRZ*oCucSOYoHit}mZB
zHShk2<^piE%1`XQo12P_YxEBcOft}cORVP3$kQzpW)4g5d#0w*;CPn1bZdbALP_1^
zz}<^y1w4}Pqyc?kvpd9^@x-1G$c-JujwFmPE0!!Y9Hw--8ZMDca2c{aJjkC}Wl-g|
z=Wd~yfBf@tN5Mu(MNf2GLWl79d;aB*0ZM9oHml#$QH`}pTFCcknQu|_6Q=yrnku&z
zM40L#3W^Eg@hskZ<dlIbu)H@QM%I*4zoG947HC2wG~zg!b&g$M;@f3&H(lI~!*stx
zXtCG5coGF=FERZ_6#%Uh{<}{{=<jjS>lIJG{=0M%?|66LIxzZiVdRX)KYTQnO&p28
zm6C!->9o4E0~B@+ul)$pTf@hW1d;+`^Ov>wJFgdyJF!XJ%yzj^dyvrQmdy6I6It#~
zajHQH>aW!3)42QZJfhj4eGPd6n<5zlACjvh-8_>_vg-n~CkZV+#ZreE{^^Q~Y$57Y
zTbGNc;q&Q0*8r}E=;-V?3O2O~9o}{}xiDoOPK^eNS2rg*M@v3_zqmfmA+xY{dTQ?-
zSloT7!0oLaj2C)w8-e8VSiKHhR)+QY*xsGc_{H`4+oLWXgecQ@olngh(W6+sLiXXo
zJ=ngB`<Y14hl4mNTQ$K3$L|ycTj!Ck3<%*Jx+DFZl~N%E%*>1k8y1(cR)*5~T<iGn
zT@NilS=|{(?{rzJ8;$^SBNc(S-L_Hcn)pKji5a1Yv6&Es_XjyEa1sP$RoX@zVC9Tw
zt9sERFUH*tPx|;O_VxhmxA#COURb$@-!@h>^FDxgsuX|8f)_4YtFzIpj-CgPba%Dh
zkS`a@p45$&Ev%NA>mhT$^FVEAM4RabPd952H1DGUl%h+wfh%rp*ZtH-jZ#gmrPL*1
zNvS{nn@&82EcyU|(77MVsnNXNd-RwRC)f1gu7tY!+~T1}Tq)uwa95Wp?8UKoDUQgr
z75FKwoEg6S`x`(aL;6e`eJvc!wMU|;0{P0gboa<-rbi-#0%xFp$AJ~uKI=U5FWkD^
z&*q%Xa6k#BNx8(mg<@yaioY!{jQsG89-tqZS4c|7-&)?SJ_dwJcnTBFU#me@*HCQ<
zOtG;%@)QlXk%D26^;U3oV-%4R2b>#~)k9XQqNcLN8EiscY#9Aw3>W|*j)LH=>hKEC
z*l%^d1;c~FT+l6-?cP=P>NduTc2uo^t%C_YQ2-h`RY=5>#@P%Fnm$>g9p$~ZYKvyU
z>1)X|_o!3g+<w5J=nP5=<PQ%VSbN46exQSmyvVi`NSk~^5f~Uw{y5qmb9Flmf+KM|
zLL+x1E-F=QN$cQXzY&a7y$PP~+SVlnt{TlmD+S|#U1ZJB3)I0^*ME|igb=o_EdXzA
z>w!8{dW6B(_EpN{_G~evj~9inSw%p-*o&ao0Ry?{XWSv4r}P)@0^BX1=|C-7z1^fB
zZ!c>w{jT9SmYC_V9edhsx2d!F3CfCkhox*F)0=7qh;4MRkEOKUXlU1<DJ`(j*PvW9
zi^$a}bQ#JWe#_;AK=hnjvZ8j+fJb6?OBm6r3q@(fF?n0kShA?!KYuX^Rd?&{WNmK%
zaBY(_oMAS3AQA4+BBilILT40?eEoVZd7{^ZVp#8+KeqQ>?Fmv~s(Q2Vpl>8MIan{|
zONxFLbFa7EUG<uEYnLwckC&7UGX*-GY~Uog#R3LU!FTMajICVtb70Q@vDfN#c#ufu
zZxN9npUpEm+FRU&dqg&DX+Uu@7g0nn#tMqmaVe`&cBnFtLlD8E36#=CZ1YHM%J8TS
zFafs7xG`TfBJd)dFhtM1JNa5AEiH_awvYbdBGt7D1s4fHtrbYXjl~qI6B_nVvQ;HK
z{VVa<XMk>1@tc5G^8>+rzr1&<l9%ft(}k#tzLCn4qL7_e9GhpplsecpDv@zow7lJ$
z@a95RTEmJ2uW1ujjAz7-N8CRTY$~TA##C)zE+#*W;VY%HW*in7jhwDeK4!DoTAD>a
zM<OuoyshBPQHExnfG?8TABd<A)B~>ZDA5zr1f5A28<gjY8iA1@vpwsOS?bmTvCWE5
zQ}QjB!nAwJ6?u0*bl}F8)ij%Q7~LCt;~$hS{qA`tcB8~N2tnoKf#LG}tF6>HSHq;@
z=)s7@&lVK3mpc=kTOxmLUl<MG*Q7tLl7&u5)}o0RNzk3`zy+4wFct^uqpKmg;N$26
zfrvnaX#|>AXQiP01NH{x?Xl{Sc7s45u=>cfYPIXxV&kr=*KW{=<yl<)S#SL*kg`u+
ze}+{3g+@HbN!rYvUAMc=OiT|bHLUC{RPK}iJS|wN-USiQsMee!gE|PJerHLX(xsM<
zB{Fgn{+`ACJZnz|ofS;Xf_JaNCT8i)=?U!R)#mgr(`Vs4e@~Hc`g-zukZO%8+-W}u
z-#krT&r>@ag#UZi>N9O-ZpAj`mN^9V9d{s}0r9j~orTjGe2xbxPCj$@YVlhDeR^RU
z$AR9gyKKp=8uqY0{3R;$^`h~~(w~K&mM@&zxs;V#-qz>1&#?Q=Y*aJ#3D;IPGZ*V`
zx@A91Z+ZX3^zOljl?N=986T|KEppu>g=2g(hgn(D`1Sj!5iJz)oEiGo{6UMr>!2}L
zGD~iuPeckNwxjY6_iVTK-%P8A^J%F6+}2IDh27z09NlVSj@Y1l8jTV;&CGyQmovMS
zM(Htu)R>u!o^IVFdXh<fQV`eqE}-CfZaFx1lJ1@^+m~8e7N%7Za?^Gu2H8vdk9Bo%
zW$SyM1OQWCBga-K#>Xl4<ysiORPRyHg~MP+#Ie@rhj~jZzj1{_1PW_9%8_oYGyCgL
zx0XBy^|(&s|3A@7LWchUm<%>5Qt|2B0|rao-v5q8I>c3Ud|h;o7Nb`iwA?ux29DJr
z0r3=;#o_Hq7+*p-dAx_|bVv7}!Yp<BH7;BRDJ?I!`u`BP{D0t1w8oIXbFl<e$XNK=
z?Dy%tyDzOJ%aaM}AtS7hOg~VY+(MYsKVQMB+N!=5h*VrJF=|vefX1(PtpE}rA|O63
zp%R{jomOTyKJNC-!&<g8SPLm%7UnX^$w({zpQ5V&cjdau@a~5zS8XfptPAI!)wkvh
zyWOwcpp4B20Hb)ba{Iw1@Rkye_@ZN(z4)3J&mZ+CYa$qBy4Hw){KzF7@)Jk5iDDX-
zL_V0|sPA&#--aJ3Y$O2I5+KJw8};{I<y?O!_ZNxJakv$A=Wf~8K({tQ2kqrpr1u6L
z8OOo=$esGYcCt?ZPKR7~vPMa}q{cV7Bs|!``@=F|^R(}kXr9#DObl6>A1y%?>m^`f
z{}76^RDFiSNhKpR!r<8fPb!xf-+Rzm{CKt*7z__m+fIh(`=hxO+QB?-oWDULsy4;F
zj$~Q*w2P)F%sj|`X=da)!p-J5$5Rl~1A6^xar%1Vd|j(x)W_w*XblCRs`wTJfw!w>
z6L_LZpYiC_12p@K>fjl<864-zMipl~=drw!;+%X49E)f8`zqmsIe}_TyE{%bEG!gS
z94=Yq3XfXSc6w=>6mgFu?~s7lGGL$gRrWh_j1*9X(X{P09{%bg`nn#r{On{rXa-N@
z7TEODzxHrK4eHJ5PO@ZKfL7gTg(UpTnz4bmDb0NL@Fou`n+*l@fB`IM|7nTvlCItL
zD1ekhr)D#TdD74T+t5}Jq$1QEeyJ|B6#C`rnZkYf%g=a?IJ6yzd#8Qks*JD)lA{q#
z;S9fQ;q?Ot7O!xwy{TxO#vKyt@RSO<;U6((*{ZVumalt+JGp(|(oEFW%bYkZ(&JrB
zXpj~O92QRzU>@evZlg+pKo>IdFeL9ScIQWI6mjD}Kfp5hMQ-+n1$;+}1zkG<C(URQ
z=Ss*y84-EqS9r8S*TR%9b}4+)Qwk^|&`!AIS3&S?bXGIvgbRYjNHQYH3r_b#18<=Z
zQb3|@zvxqWDJ<F=&$~{@!_wV%qJZ^f-0Kq>D4t@L_$Y*F4;Cp#53_)7Zsf>sUWq|H
zuLH|iK1MZX@dwuY-oO1Z1+CXZM<V1gx^rJRwJEHOhNch7?Ol(3#8%a82<Y0Ke}-Pe
zq=Va>06<HC{^?6ZCnWM+e()z?2NSnYv8e5?1MS#xI_=t7c%k$<oY!fkiGsv$i++*Z
zSSX;0zP?DVpbx)C-`g2vjV-*i?Lt!o%;i?Rh|?yzIT9k17P?4=>FsZ}CVxSue_w}%
z?&JGqVr#PFRh%k`X<@W2+?RA$m7vfv;!OW<AX0dE61Lem&<$PhowvU}LwG{g3&>KH
zK^)g+KM$hlfeZN-?3APj8bzfV(#~tInFFLDmI{~WgZ5IgFFKQ=NUrabaU~H*VktRS
zKL%acJ|cTMcF5rB-;41d{W+jH&N;STC`Q839l|%386KQNC8LE@fXmWYiQ{yJ;;NAE
zBW{NAuiAp3A;OmQL<|Q=Yy1k8y3P`Qiva_PmUo!9MWSI;tpRFQJ``cZ)Js~+)dgd?
zbvAbFH`(a=2e81mQsek=Mp19NYRm<PaW&S9fsMw)EdI*&)~si+rqp+twH1HwCl@{m
zVkeMuVV_7)jdwUG#KhK;zJ`X+^V(yD+FY$kX<5RVwk~e+kDs*H6Vb4%H46EnhcEfv
z7uvDf{Ep<G<nIA*JhBRVJ@v6SaVOay?$geCNXC*`jU$NVDW=e=(h8HAa8T8(8S}KB
z9~>NVOV%^5`*2&nSKlBn6Y=}VQG@2*(FyagcGhO6F>i($C0l*=t)am;_KTv;$ijbk
zH6UTJcM{5r=D!VVL3{zSu5ecHtgD%ebDV)uRuzeX(?5Ip={F`L%xPbOdl(_8JHw3H
zm4b&T0w0{Kdcn%rs&54A0dx+V|5X^hQ-OhyDr|N539vA6i4zZ!gMx}F&85r(i-}X0
z;R9bz`c=Gxqvt6lz#osEO8r_p88Kv8J#GcX(s<D+@Td@Lg*=wc{;K~>=*~MH%cLG-
z9!qKcM2Fu4u^Ii<crPMPE2lJpSN~>Qv)-M<90=B+=2|zmw|-RB!!$2%eY6=xdy3n=
zpF;p5Yut>Pf=#^OYaZ84hml_GvRz|{m}#jp)^IH)@eyw9WH{ddzh=+>te=v=oV}Z+
z^_6F}Jmy$a)dyW~yR7&$yVzLj7N$9u-LS)&q~J3=#MR{PsEf!8+6Ub`>x<8Dgjz=7
z^$G9fhD^{<0`pJa;$q#+=)BFyg5UJznPf|Sa2|GMH{9KZ$0XMK9EUjD9tK<e!`@B^
z4n513zTAHp*YQ>$0nS)6-yxvSvI-#j5^)NV%)VY|laLR`7-`_?V2h)5qoaM5aEE}7
zaz%F>S|@hxyLT!E0()aD)PB*OFyE~z=>0&N)xws&0jD*;7>uRzZmSV#dpqLl*asa!
z7o_W_=kkp5uXzaUC-q>HZb$S8=fns$%9&wC6Hvh8D3SixycKnL28Cw@0=df4T>-fy
z2pIzT!D{6b*i2Yqm6RQSQU_Km>#?qHjIFl(DEzo~AZDaf<v0uSV-r>NcXIjGTxW<O
zT~<J^{dPWiZ%)hGhhYp|-_4&!WO3$ZK?S9SmasxyS!x>A&m!b!VKm|{(eV8%HK7D@
zZz3Dt;I6vsUY^OztRx;XcTsBeO7$uzV2U0i6Y@1Jy-n4pQ|5IT-mcR&@gKCnSRHFv
z0p(2THfMe*xDhLf2IAjE!nsMvTn2g(R+DxCy<3ec@K~meSiDdg1XylG5vd-S!w%KZ
z_gvbs>{v}+XO8WSoBNPUr4~@U%eFwsiDbYKB=9nDEsOyX$tobHy8H%@EVOF)rRa3h
z_fqC1b<YTdK^PKbqaH^_d0E}Y8O5i5fB816<8c8499Uhqm5L;35yBpl1e>~e<dNg^
z0t>C!+tKvy?K*IEB7vPYFZ`5M8i&FcN~jY#-~#2%rU2C4{OA0`uUGMmIhZ{>Q2>rM
z2TP*%6wVYzj|pyH37G7ChgKB73!*IJu!%poYA1YJw7soGxrJVfaqq1n%d3Rr#@#Sm
zVc31Ue*{)j!GF;N#}<%-OErEZ#FX1IhKVBlmMhI!5LyEcX^KVwAg;EG!-McRn~{%}
zK*j|s_C+7{H2HxXz$@wLk@D=Uo!Ah<&RK;PfX)akU81`e=JB|;@oO+%GJ3uxQ4HkK
zJ%ZHgjZrYXB8K;3LLq?Jz&{|;cCTeR+JjFeY;`Z>2V~LS0vpX!qmo+K2?wxCYN9Eh
zgGlLjSI`>EtiGOzly8)5oX^Lr);E40u7+6PnWKlHjOLv`l2Xu=<gMh_qZ9;kW1(MP
zXp1m^!GPWgWJ#S!bV^PBEP~0NZU7$&KQabp(JTK!6eGX9Zw}Eo@x*rD8-{S%NTr-W
z&d4`X!PzcrYGuf)Ws%3Ilccpis5~ADlC<)TQ=w^ZvMP`ta;7y2eigM>nom{byuxyL
zpR!O*Fbyh{hlnhAYvC}$ujUpFzH6=A9L{zxpuJrlPr1Z_T5Aep+j&Vx$svDPKta^r
zB|fn%=B&W9M@FmBVMOHN2-h9i?E+3E;_wXVa=v2#imC22kjSuiOdX!L=5ImYYfJDM
za{{)(%xK2d&@U8qHt?@-oJQQ6DS9-XY*AnpV%1eRfXNNd9>9SwO`gECqTTwgRYsb>
zHn5uc)Ez*-GJ7%(p>sA{UY_>jH!w4l=}Ye{V`{<CYCVpy-(5xf>dq}XYi65k`MI(Q
zJ2s0{yeVfgA$JEt+o%La-hXTL@;k%obV|l6#C%%*#pw@?Uuikz^t{I>nWKI+VumI7
z4h&`KhMvPa=$Dp=Eb6N-H69mk(?M4pdst6!0!W=U`FN;mCC6WIOx4EKUpt`BYw=}=
z@qUWUVHD5+hVNoS=5qJd-MXQ~ag0cTZO_n8n>=1Q;j+P-xFu|YjPL5uxvlPG=+O!!
zukZu?#II<qj^PUdR$){LlA!R0ZBS*(q+&9Y1+Nj6(os2Y0Ng!zO>$#)b`+Z~%RbaA
zoVT%?8m9w3&o7IrG|2?B|ALZ=ztCy5EBzWqelT$<V=2>m$8`xs!cVyz0|$=LcMEB;
z;52Sq$|HhbbZKGsGpO(D;%UK`2D`nP9#!KdborBgUy7cn-?Ha6pjyMwJ*09XQ~IT_
z$YNbR#$0~ttcRDpnh6xnY%=u=p)V9hWMNcP=JWCz(5p$wRnE7MHwVe(89WuD3R!t9
zbr@DQhlV|3x=ckCH@g+V{hg1ZS>)b_uXvGIn#>3bn*8eaBxf9mbY`ymYHS8l3`fyH
zK`4ssKT-#>on(`|!mFh2!aX#)f)O3b(zoxsWxu4C`SgrQm#JEet$wG3`_*})-avoW
z+b0_Scb`>+9<+t6pJt^DI6NcbWRWlZSj*Vr5#vuGNJ;gHl_AnmU7*;UXp;@KaiwYu
zZNl#^TTf?La#d=a36g=4R5j0!(!D>EfcG2=iX(RH0_4wZ%f06kD5R*{7?-U^jOWXy
zzi%*d{Jr;_6Vo^msM2qGNAK?Gfep#zvaj5J!!EDkWMZjYU)!a{ok0V?-Qa1Lsz<k9
z{Kxq`a~DuP^L|sJTWl<57FU1t^>`%k-gk8oBkD-x74h@N^`d5L!R1O(wc>9F48{zc
z=!1GZO)uSS`(o2cv+VYdoy&?h5oc~U{fxxJvXmQg)I<#epEQ!z-`*Z80ZVY2Yx4a$
zYIV-o%$&WWXZg6Yaeg+lZftn|ebUX=)Ql3Odlm@=&kK9wNBKm~Jm0B`en`nbb}V+Q
zu{U_yR9gH`SpU#-mrQ{;%glNAj=jPS-tUUq&bs$MQ8MD}(T&n?KVDP#xG1l7HhrrY
zQC*wH_<mu@j7S!Kd2{wiWvDs*YQ*3A=c&)tNZVPs+3?&ccY6TE9+gk_BW??jycJVj
z;ZoH6pe$2~@B3Ta?=7n`hr#}fJh*XRSxxpQ(~LiNT^`Gg-G7@vobO!FtmkoiwI6Em
z`-g3cpW{F0<)-Q0x6`dBf4=BS->ChZVjAZpn)aLksdDpZ<b-d5w)1Ac(cz{ni6(}o
z)DMTAAr)HYm1+1pS(AE7!gvPY!YRSszKyR4{=Uy8Ui@Ag;@d#1V8^Jj9d<`2H9sF-
zRoXhO;NHm6c#2rsUu`IG$1=~Ws@lj4N~`J~%wP>CVZ6ElPnX>dp6Lx)sh152uUrU8
z_t~!;1-7Y3)f9^R5%o&QQry(>9_ID&l*L#xO5JtjAT^wqXL7{Mzonp>8L&X6Bw*Bp
zyH^Nwpxu&8!rj<B%@tNEQQQ)+0!vrX&C^Uv)@*0Scv^Y)_gL(Gy<SR?4~REuC}c*i
z2s3=dP{-RO#UMe2h(Hk#V@cv~cf5osOLN0FQw)`G*ng7E4OIf<Cvi8xr2PE1c!+=W
zaAy_*BS`>8Q4^fX2E`~OU?ryAvnx}O5719o5`Vw^ZvM?wlxYI>QIsWdVPRfRU!mx@
zXKu~|u#&~|c~Qq(DijI0l=%Rwuo6;RiWW-p%-}XqBwu`)z8L%7lSJYhWFj<1Z0uvE
ze*&P%CO@7rG{kgE5dN5Kq&*wL2TF^Jy8&X(O-_-OlX+_sg$M2bAl)p0o=M>m=#_BY
z<)>B#7v()JZ4`s03Rq-Mtd$B6U(yXY-b>F0>!r?6*nItU&aL*m8vl8Tke^1^JmUj<
zVGAgLP)ZC<w3`aB-UwjnD$9V#_#$cbm*Ky`|68R<U3HKcUGZ<w&CKx8;2+;2)H7E{
z<lDo2h=#>m9Vm_qu~QH3*WlTVK#4L2vJNT!1D!@~3&86Q9#2w`2!pR9yYbB2G%+>N
zmr^1_2Ns4~J-1)}<Q*BReqK+m#8KT~|3#1cSFC8O6uA@82i|jbcyBL<Q!Gd&%@(9Y
z%v-4WN=@G9P>;Ss1=PS$W{9J$n>Q7`@iO^8Ux;`Etwd0S`dYk2;g&ggjx<R$<c;Xo
zlb1=rWi3D_0`hh$@AAGey}7yHo*sWN(pw2#{tcqIP8yO<jO!z)q%uCb8+qeL<c;>~
zsy0DWAo)pV9bw3+Wdt9ol5;Tl7Xqj7u51bv2&thTacqMJzbSFPQfc9^<!2BZ!7;p1
zr4s=MzjigIXpUc^#k5@tln3kdK9K~lrAt@@TUE~uBT)2N)%?KvH>&o9)r}-B8){q9
zHKTNQ0C^8cbhi({9nB1!9{s7Z>9O<3?uPv?F<J@d8T!D;Qoy~Y@#yu0+(D_^#l^J^
zx|A{~_6XOGm)6YGw|hYOAvo-VywE#XjL?0F8%6}*u^;%;A%L(3O8zr#2<w5Nr0+k|
z2Nt3Bzez8u49)+|Ai-y+^~Fg)-Yh<ZuxkEirg?tgWnZGmd{<C?bJ=ur-Fj0G!{bLN
zBJ3_<H6)HMfR&pQ_d8V>Jsz98A&F%|7iRDPl3bC4@3(#7^%90k<bMj1>{(b?*h`!d
zvRYV_8|VeMm<iP4C0{Np_es;oV|WC*VF<d0oBt$*q7C9M_#SLA6riQYH(+*!BP%L8
z@s^r|@!<@KfUI(z2BQMs|B<48j)56;-x#MSwH;(hPNRKrTWi$(FWH2;`;e?SaxVVC
zOsPu;R*kxVI`4_X)ES?bXucP9>^#VQtAjEltDsulzB`Aig|c)z$ikNB1Dl=1({c2d
z-W-M-f#gk6Mlj~)PYD?6d@mk8FT|c^i{=W1&>QB6|8|K$H-V=ahG6{f;hsRZgx_%E
zjM9Hw`Jcq5<u29#hEq_Yh%NrT|DkG)-S6+BPgJmKq->&c*xdc^eISAGFsU5rw7k9Q
zH72pJfU#Ow=p`He@6jLTR{%@>3*}qCSehH({__{<L3Fe@yrr^V4R}-*^51xk<r$Kj
z6Gs~{*j#qL6ADrvO|c@oy5au`oWQyv$tqGxBX94Vzqj549rt^Mj%b5jWae3;=N%hZ
zBH~$M$28`$d86u>HLD9WNbm+sy9^f#ju;-eTFqQIhZ7^Hm&>wvZj_XV_n1EbN@`6q
zaaY(&3QX`+-ds_+!}*r+6?KkE7wE3Z{2`$&mb-<&19AUN{ZA~(|5Wk+efZhgYnJcx
zpXiQG7^MrXXx3Vd;5>$y$e=^}VIvdP5Fq%apT$UlM)}q(tkz}yyoS$FI=>1uVpWep
zUv=j(W%GYc_vQnwU2;-S_p@}_jiep#=f~85ww8~giY*2ihOjSgb`@uu)BfWTBP2(@
zyEfBAmJ5)4wkiy<rP=r=OHam}!PZ(8rwIqvpL2?x0|~8-CT)9mJeF;*LvANe_#a@_
zh6Xd|>sQIT+(BaR&i$D=rl|oGjk6_9)j>GN4*~LE$Lj2qU|U8QY%fF(1$NN+Bw<WX
zIZ5I1mttJY#Fa5C+&?faR_wdV%WljY9&JwkbV}o4^4&XmhA&-ednov}MwDJ$;yFD*
zo*OYzx7j`%jf$QLoe)po#wJ^XMb1~BN_?qNQJP^(Y<``a<8~OD9uwk0pHC|=q<v|;
zq`ZkH43BrmlwDU-3n3UFXX9y=w-MJvr03JBS9dmUB$J6n@E(nDv1;?M(xVdMnYsIt
zNu-ns*eME3Z*v+7;23YZJckhkjut^Ia;E&dyw5sp08iGTy+L(OTN52Iitir~Pa^v1
z$KRx7))UX8V#FXeG@fa&Ngh?ks0n+-N|4xYEE?p?{v`jIIP=K}@Xy4%&vQLB?~Yj{
z7b{f{mBM*VvSeH`UxRc_A1cSUF0v)!5z%qY#Dpiw!;rs*E}40Ug<Wu9BibOE1Rjx^
z#rI3;kg034rVVo6iiHLJ-fB3Y3kI?ltoE;b`~>QOk}Rx^eEAnf@nx|03+iWFvZt@s
z?~i79A|VGf{qgb=VU(<q9=u;~!&P%YvXZ3ty^lUBzE-EH$<xfd>FV>^e<YJ-PZ4GL
zB>hbg48=ju6HyymVlHY8p=|&!I|e<??f{tj!j4Z%en$?Dv#IwNQ9i}OfM}un7~>qE
zaO9gDio|-5+SR7ryW(!Ghl5rl@>n#(_GZnOI3L1A#59HcO(8WgG}*`ZUETLx-raZy
znt1&ozDiTlW*ne-(+)(i8*G*kI?RW~IvReT2Pj^;BK$O>6b{mkK`F@$5bMtOw{mQo
zdocb>>qI3%pHHh>bca_s*gh%WME{{R)`==9nqVyRBov{^((?Jz*`cRYQ)+8OEIu4H
z@_+I5Ch$;x@Bi@F_nj<d&r)PfgzQqtR%0~wEk&{=`<k5)qNs@0dyFMb*6d57w3s1;
z8Cy}z@R7kZ^PK7P{r$hs@Bh4B&%9p7aNl$8bI!Hg*LA($=iFl4iBU{*sw$HaRice4
z#%Hd(wF#(fr*IweBlGp1(*JQ?Zet?(4$rB(`mSQX8T%ygx-^Q-zB8?|?=H+wx+uhk
zN+WX`ntne@RJ_L^J+HjUXMPPP0C8`cl@S%ux<#<bKW~{L!eKL%AV%h`UVrW2+q^6P
zfiwgNhUZs+ztCU#YwQ1dt^aX*|6NYTRT)E}0;lqjLD)V<GU5ZpPTZScLv`t4RPS9z
z=DfFgg^}^hr!IQMZFo{)+HoWE29J#91-|#rFM1eV=5vNI->3^WIj%Jb+n;2qg&99g
zKBt@E{Q9nVyEBst6Z*Ip;wcU0I-LC32`sM{EB3o!U3on(wp&!?V8!d%86DV-rYB=(
zU|(;qGIIOrjxrIWjwL4;GyPx{_;NN?=$I@Ae*Vn4?3cVXCLT+7{NxX;5I#*^pFYF&
z_4x)(D57rvTi)S=q1T?2Tw7UPzmjl{;}JQ8Ih27Zg_=~v__})CU%Ak5Gc;P>#qn`B
z-zj_+@lr$OaoBd1ob6)0A&vX$_2~0{IX<>ejSe}GmY5s`CgLxYA543En0IUv@g3^@
zdBa1F>tPX$`AYS4wIh?%<0txW6^_~^d%C+JG*M_;&aJIGChMIqpC12BJ?H>?<rU5)
z?^5PBlvUm2{mg^E`^K#og&8*ax~;Ipn2zG!kXjgn^GkaMoib<;*{HqJJ3355{9$Hz
zXmy-%jG5y#Tg>S5q65*wGrAp9y#D(uNtM8OdK;mv)g6RGgX&&yU+8>y2^$-$&|QmU
z-xTl+-lB5>+1;?mUrw!L@Dd01`mQl5?y@2J<$uSb(prg;y>7Rsf|v!fW3)~jem<Ey
zfNy4H73;eHdS@ZbT2cyc2vaq~%U2wN0YXa0M}4^h>1>NL+ja^3(%Z+(uH3wPm6N-L
zueCPsW5C?1x&VHC5Oy*7?WA&n+C_^~DQyXygFg*P>OG6|uid_eh_zqSdGR7gJH^j2
z%k6S8TQUc8gN9e+OKW!qw}$xq_Zp)T4ixodqwBKG9Nm~prsLuy#W}{IF~&j7$0>7!
z3&b(7p~%^$UUC3&A^CTCz%ZwJ>!ZuUc7Obb&$~VNcwQ-9uZn@vbytj-T1op^=oWlj
zKOn5L1aZIcNJY|7rSM>$j_&hK^EMrbr;k7WJaa)xPqWB$A;m6)cCa+mrj`eJ^`@of
z%i7c+9tPbAsUoiYHZzv0aj{-cse6**zF{2VT2}@wm}Ad)5&AAfYMEYDywKg$nh#@S
z0Blv0)31)>UPZWU-{}6c@0l?Z>IZvrh-Yd2m6E?sZGtzE>$}`F-R?#lQ%XaEmnqFK
z`hen;(hWV%njabg!&(N#N3tV;As!56GGd<Q#8AI?RFGwlUg`Rp*)zj5TF2JCo+#ME
zF4%8!?1te^IlsPh({a}ryh-50h;|_VToX-nohf$9NB@OiC_@8T0~Y*N?VN;5mOZlP
zbDE^E2IKY9{l^>*pRF#vrS?;WFZ50_^BeDmTQ!Xhy-|sR4Y0CW#l60vrjj15P@Hop
zIqdPlDuLCm=8rI|%X@n;PLgzv90KOm&o2FAJRNLrez;Dv?qK%;m?4*AsKE1!-=!(6
z$1|2s*>A=&-w^-3XJ9{hjz554X%j5sPzRA*X8d3yxsNNhG3mZ}$&Q)g^XV>KCnsl)
z!u;R$PQTC*`n-ILrKYJ)vo_PkO%p9I|2DV}*PZqnJT_W^T-x-NMJ>^sAq(e&cw1io
ziFqSB=yV1AeFR<aRc6vwGYmEo<Zd(PSe_&P!#mF%U91N?nChm$u_jv0C9ESXyJ$lX
zX_6m&hsNzV9b}bo^x%phO%MC#{_ElXFP{g#(K|FC0gl)1_eL|MXLvdm#Oj8}(t7`J
zF^w7<;O!~Tx@eqU%=6EQ{As$QRWXiL?9)CZ8iPRny*^rY@!2s}fzGw{<WaS^mUn1`
z{V_#;&dDS$FTa5AT<lJgKKeto@SFxFt)<(HFt!N0gXgt_*XEL4F4bF_6MGno3>O`P
z25Pq-HsOvAc;>wvK3tY?v;FU@E4%&R4CGEx=q(Rhe2e}?c{4lXH5mb8uhMip^Ygmq
zm%gpSkIjP~DL0U_jQ)l_A|v%w$18S2<lr8{K`!=E=8{A1zV@xnue%{UL2;8|P3(H6
zsz6#?ik6>UbPJ5bwP1vw%Rh@nJ%hr`mP2Z{bO~rDGxFbRVaz$Bb(j4g)_B&ce2J7r
zFWHw`KTk8i?$#TC|N3f}{8I1K??3G=*Vs%G8Y@v$aQkQ9`LsbR<!_i_5T!>mQ5iD~
zT|X5mmQwY+r0$7Q`-k328A5mmv1<4+?rFVDnb6;j_6GO?ie-?gE)D1VzN_!9M5>~d
z4f_po+OLm&3_T0HJ_aj;ws}J}PJ3z7le$NqTFS7xXrD~vgnmbMv(6kyo!OJ+&*&(T
zDsbxac!0S1XncKV)TV)uf<Nl?ASe%R95=(klEN7BkkKqas`?lQ`zMPYnU|~sQTbxE
ztS-|!S>pFXW8YuOP<W(T7whyzZ{J^<%~#q(zM=C}@Y4`p;yym!h^dM-sxM!FrD#mZ
z_pnjUAI7YoZ7ks~C+9%dVJ6leB7~EZa#(j~<JQi`uJm5x=Hj+vc``sf5b~?{%<v^S
zzV{DML_#X;S3HN%E5Pf&>`@U*%(fyFNp*5@_a6{4&mZCGl_f<((q0YcBfif+#pz`4
z6F3wOi1siEw*}vl<`aZ%Mdr%N3l!`#pVl_9lH@1la~(GHlDL_)_k`A~oQ>qsp;4p8
z@XfF*PE1BaCs&C*#TW6{Rp%=6nB<(zA4e(my2vv(09^a*OYP*FQ{gBbvvd7MVxHap
zhHKii?MzWK@e8QZi!9aow7i(CXB6_56w?GjgWFO<V6rsma_LD!e$yXK4ERE+Mg1g3
z*=N4%`zzgQmFZQ-et%%d<<Xwzy?+`N9gyFb!+3Y(mD$`&8|Kr}JH^M;q8-U-+j!4g
zMR{Wj(k_%ClC<8ta~_EIW{V^DU;J?4ZERUQ!?q#FG^_W{Tpr4QD1UfxX*Y^%nQ{F`
zLGB^-&KO4VYl(-<kB#bOxK>uNCh@eup1OIBK9{#gbc~(o&^aQNc!;|kKN{;RW-au|
zgX6{1jLYKVAeG7PDbcbZv=W_CIE<S9CT0)*|BN5ZUN7M_NQbiA*3!md`Q##;>?*Nd
zP=l<qe!a`MvOoI#Ax&Dc-jAmzp3wxJ5PV+0{7q;ME#vg}QE86yy$;Glp;tZQmAk0S
z0e7b=$pr>PW`3C?QBfkFa@N<^waqst=O^8VkJH{K78|UPxY9*wX`Lt2y4rEH{+PM{
zNuP5;`n<`k)WLnd6>KG5VwFat5kC)QyMc_}ID^R0{8oUfIfm$D8dLbcvglh?5;;zp
zRgDciPm{luUv^Dt7T9>E&=c_~pPof;JeZa5t)wOMCnY8A(#QpLH>!KRS4cDXlt*$+
zzf@{H<CW&5sO67Vg?(n{+V{J9Yb4)uF<2GGo$99N)2D`qK`bb{HUCarE-GhGNPEq=
z@*;(r5b*!Y-yyrvGs=1P!}8hjRH1H``^|Dw`fSp>L`Fo(q@=CP#$BxgZH6~@Jq}Bi
zV4{+_D|hV`K59CSold`8@7@c$<DX_Fa>sY?cVez`z<pX$`;1TIpPO^Ssqc*KL36yu
z34;D%YAMrX3(i|R8avumznRVrS2^QhY7@**#yZ2hM};Tv&B&w$<$ZZt7|9T#S8)84
z{qKp!omu`Tk4+b8l%(EhS#imXu*sr=nVwJ2b4TtANd05_DeKSB+vLU4>kTO*^YRm~
zrDV_7i9dHP-FnD+@ml2d_nH5AelUcU%})7|ecugh{ppzaV-_vRStJx?1Ov~pefm*s
zMvQ~<#U$L<{86r$Ud9}Ez!@XA^5u-IuTAgeFIo93*3BHZ&v<VVb8yzx$TuT)&w)|q
zT5HeaBDVYaHl(?o4zba#v$K4ZfaYKCMw@?q`<B89z)`^~BfMm%Gt=OH@CMW#<|l)@
zxz1a>?YSGZ9nU<I^6?*r7cPB63Z_xf*DYHFt&W;LZSU6F#rgOqa9@qyo1~nmvMJ#F
zeKlNJSDrERS(;~PfOsL^b&kDrK2P~W^sAI^Z-y;4ziD~v>pmAR=sbi197iw}&&B7h
zW3!X&DA;I~(}$jIQ7%6T?enPw8R(10n7f1z?EBqjSZbfV`=B6<yT!ty#s2=Ekhdw*
zcQv)oAeT>Z`pdp@uQXvV8<qUl%v3@9`8!+g{Mh#o$G#=SZ_vvmI2B)dfwrUBC(n{{
z-S2)Qsr||M&Lp0BhJaEVbWULinJI#-a)_1D(pB;tt>^sA*l>CZGp}ZoO&zQLvo+1f
zbz+yg1~EA=<H7G#CJE)EsjM<dKNidCl&mjLUpv?{qONLpYfj=%mFM1*?CP)iPRB4z
z=+N+QquQO$xBG<LJ;D}q5C5+C@+Mo<Q@#Iiek;fH@v6(qXG?jux(x6W>@3B(<)VbE
zewiO->|I`_WK5i#<C#|oO5XRLlfSn^5Dnj1>65UV3R-DvU^$ZVU`-_skAbBhXf0u;
zzVc&IWsch#-rW~xx+W@>R?y2@^TUF*tRQD*2=!->r|w1~jhlJ&&GA3=|4h(|ukF2I
z(u@en7-y6#QaxT{+|E{Dk{fsIQ|;}y-_FSIWSGtsU0zb?4bJCYxr&vE`@_7MAI2ts
zHc`V#e!RJD9k9e&Dqc4er?S)fH4fOyUK<@<dfGqE{lM`M!1RryrD9)?X;2TApC5kT
zeTl56ts4@o@>S!VmHP^L@hKDBC&cH6tyCuaCs2OUdWkqZ?`!a2uUTp(i8jr2U-u4e
z6OlL`1?m?(2=S+>5!j8RZze&2s^0p&``D$plz5@Ahx5*?GR_Ar*{*q|@{XTV{-I%N
ze75=(@TVC>CfxV#x7^aPUiYZ!RRgCBVXmpke))Af3<V!T4X?hxI`et!7klMDU)gAX
z7%v_FX!z?Wn@@aFjoA3nY@r(#4=PDj^^BM5zSmeh%VrI$;hE>PwXQz*yP-ZM?*5B`
zx)(-jYx|#{doCXD&d-<rVEgK-iTkzq;infB{yB6F6Pr|cpqa6>^;J@f`-%Fp@3N<=
zP1)W%KT(YOTaJ;ClhL#iRlX4m16~jm$neh0Gg?ZaQ|zSM29>wG9cBs#O4KfI{aY=g
z-#-Kh4Nq$A>4nX`zd!%qI@y2!L)d?_z<8J8pzGoQZ8JPk*pX-X%e7#;w!LY*<u9FA
z6BM%!<tlbTEiJ8rg!us*TK|zNphnr31Jl^3zr3+Dmn|ajMzo%s`=))mD{JoB`Z`r^
zef@WQB6IYyDwT8i$zlPYr(}ipc7Svcju~-WQ;Ayt){pcNmfQpo1Hr7>IClJF<K%_-
zFz*{HWN(x48?G_M_dfV7yIfF9H~R!-x%uq>r%arh{D4;A2!q|dkh<oNE(2f!^Qola
zgPyeD9)H4y5-pvM9i$GAa4D%Ob2s=45nqP)3Yx(f9N?s{exqH)S_iSJ<5gP2rlkP!
z;8E7<ufcQ3!eGyj?rN*vE2E0gVTTfN?~bK(fIui044e3;9ZrKWR-ra8UDQ^msL*ke
zl6cko4FIONVp^)e)+-DSKblw^#k{2THqxPs;?e_lE)G67t+^Xsp7j3PdgTA>+trES
zfR`WR!-p_N3ex=1cd5eO5oQ>(N!ooGm?(=F7wwjEr|pP>Yswb@oxnzO%y?_Daqc@$
zk|pEP{&8=t(ma})<<xD<d10Osp#`2me@~1kV9Dxvu{(d+gaHCi7B<*mVU8ByPJX-6
z-95RU`>Q!ws9N}`O2{#Q6G;emHq=5ysrv>+DKjqOWe2!107Xcve0ghokMuQ0``GeX
znli|*ueZ-N2X~5HNGh}G5-ZyTqBaY^&QvYFabg*FO-r@y#$Y|MBntaPZy;k*s77_%
zlzPbF(5sWdPhXeEpr?YpH6GM`dIf)6)|<l|`+0{(PCpIvPd4PqlM~R$xC3*3AT9gx
zV(Iu51#^XskinHy__A<3MKd|&A$s*Q2lE#*$rN4JHy{`N>`R^WHc3=JMiVr@HG({Q
zV)|~F$>Hl$e7owue&ac*DV9I=Na@Q6;wKrNStqlFTQ*o5_%W-bt*2t$rONBNSDH^$
zoZC+%r#kj4pPq7IFa&zJzLPEtPx{sTdKN}86tmczshsCj<RDMHlC9D&`fhG|K84j&
zv7T3%N&f9<=AU}}<nCp0=~F9B1G;$%<WHRAW<5zFVl4JU3>-rw55s1MP<A#ZMB+7r
zj%1inJWu@OKXvLAve}PP+KXDcO%2_Pe!*b{@B5m@7o<5Nd|n+)6Q?dXJxl2;(mQj(
zj3%%+FqBo9M#kB_9qP(`zF82bac_TfE^EQUnp5&&wat!KkD}Lgy#8uiGDkhYoZnN8
zlW05PmmYIl_;K)?v6#m$w{6s|mcR30VK7S(RS{NvS7&|jWT;#b^75~f>A#ndleidZ
z#Gee3HEknlcK7qr>(5Q7x$lpDntiaS>rKx&5}d9>E9SHe@Xv{I3cumBdE}zqQ1kHA
z59of*&z9=4Zo<6mH>-5bADLQ+KD3en_0E`1go(lP0e|GJ<6lmj41Ye8D)bolEZtfD
z=ZlZV$NDP1wV%^W3mUwW!|l@W=FO+?*P3pVWJQ$2FIC$TmP{Q!T%&h*r}oLbgRrs_
zRppEl*X7{+xYfs&YFTyFM-E7R(7vl&7P3&e9DniBQ`w<c=Ps{5ym@_j0`~-Y@E6zq
zDFfu1d$HA(XZ4K_+b<q*#Tqt0Fx=c}PX1CKwt5-Nq7hHvv?}`0gH4@r;)K!J1<fB{
zdOCM~K6jp#!anQCJk59P(bku(e!(RU%EhSwo573dE4piU-qH8bl73-YUiF+=O@66N
zT3{{;&well>dLJUJs&_=?z?pLv%13EPSl@owD2z}V?{}U%y#Z@gig>_V1s^WDTIN$
zP1W~C!jTZ!9*#xKLRHNbP%8BrBuWTEV&k#!eQe^npbaR+yc|WghtNJPHgGt6H^{}e
z2(=GE{p5V+MC&@0v{e-JXSLB#0gesAABE7)tZK+L@B!<r(pINZgi6`T$HL)(DAKlj
zAcPU^J%xay<1tY7G6d}g!5IrA;YeH?_#`<L1V<y>%Awpv>;;NDJP_k1j}C&v_o4a$
zXAC^Wst7{ikK#~{9SU&wz*ZeNM>rONKZbyN>L7ODlqqN*dx49Rh(ThLI07N4(Qpdd
zg}Ta+Sqmu8ZTN%`91QC3SsaHHAau|YG_KH#M8gy1Ak0KR4pZx?3nwKwqjsPP5jZ+f
zr3m9GiFL-faTwk~l24=HIOvg-AT|=Yj80thtblTsv587>xce5|S-uQPi7JNI*`d}U
z%mBDn5(hRAbv|qg8wsy3Z6m)4Y$N{yQve2xamfd5c$UE(4sQi^NkdrhUzJ=e0<L}n
zLyAR5#@~T<1H0Pl>{h$la30occnK^#2qNEdMs)@wHsF=T$lX8`qx}gCF&!S{4o_Hx
zlya~^5MCdGR_&~DEp}~n_4yE*eq9V=1Pi8yv<-(K2)z}E+JGb814&_eBRw!ey>JNa
zb%t=XZB;#O4Z<Qok1@sI(<;3QR8bq*8dHZ#gD}YYEFjWOMF>K9D*nAH9IAigypIj3
z0Q%v3Ql-8Wm0}ORxVDJ)r<?t5kSDzvGCC0I0#m-)atjU*BCK|z2%w4jv{eimA%YG9
zD+=JA-{3(-ZM%{6VER1Ep)Mu(=EV81SO}sb>+FOe2wWdDyNv4u6jeA5L(&J6S^=g9
zLwpd3f)gJ&qrkXVQJx%;aL<0YGin!V11HNPA?ndK+~cLyDyL<r{u?~;8gxws2|<;A
zN4K{MK^RX_p!5?8&Yj4$C5S2rLD)oO{W_|+90l)<1gGxfI@Rc>aRj!ZH-kJSkvIs9
z>$&hr2m+ni3WR`NEY;Pg?Ljy@p*j@YO$iR+c8@}xf)E-G--<+xpb;EvaJZ*9n0g>%
z=azS9(B-<$wHGIkVs;?Vl8R^UYFm9LWQPQDTU$b3xc>lrE8Y_hr^q7dt;8!Ju~EJ5
z&M4xYKnSymgUIVBF!k@Di4#yKP&}wk5X_J}HjpJzeeg|9dBI7-yyfn|*VR8YvOk;q
z%{+8|Zc?n2XKhNc(KT_sk|l!```lLINuq8RT9*a?3I5h8duwC_S2SMUX^jQ;Sf_$S
zC#nPG-A5-XV(L1rfstbWdI{1Uh(2j>l0G_U(;2k{<Pr%w2#-Gp5A3Qyl5fE+v528S
z41`9|?I|d&4IP9xg4%Ab(_IPWI+R>NxnXyKNt!hCnqMQ>D=w;z9Xuw;?GN828X>6W
zQKFXF=3wsO?0=F9mS6MnYRwg-R%cT@v@F)R)Kw`_*Bf%}WxH>Z!%le^HB{cpu=@0S
z!Kz(5{)C{*b?Hs=xs(U&vjqc$J*XZpu?kFi#6A8Fav!47$3nJ7A;Gg>>VZDnfZ+ur
z7D$o69H{&_6ohM40Sf2IfrBvQJuGlEo<dl7<RCn<4uZPURw1BWrvlsR)=<FUg@Bp?
z4V8vZAZs}~<cDD<AEnz;_!da~L+Ph#b`Z4QP+OwZJ>T<GFB2QSe)1L0nw6~Of;8rN
zlN%jY1+7DyX;NX`dPe+ctH2U-3Lj1PYzmd{tvbX0wU$-1GYYvIRG)?c;w{3EAslA+
zD25d2jxbgT>{P=bC;H)VOIi_%d>R58fDQxNSpQd-%h!;*7|(zGZ<jdS0|oSW+eJvv
zid~FNKEY7%HQO86Utdo>S-%to@$J|15ju!B7&PyfoJpPFR+WnbYtFMtnRDi}iQa$M
zw$<VV4cU-}7&y>lRN6MM2dL#1lh6R%8A2@q$?5=;0hR$l<Tjwu@pcf(bs3H52i|EP
zLPx>79}Gl)N;Tn_eKEvum8wlqk~^NHMAg?4mf_nl^gK9l8partq9J>Y$%j^!A5>+t
zj@d<dzCnl#kVN3n#5b^iIXvDHNGwsY4UKq@jemmxmRQ#*goa15ko`QPz7d44`(-&E
z0-T4xoB}&x2e~-?U|Q1%#S8;t?cSUoKxXQbEslzIG*S9fGwaDZmqgJLSC7KqH*2E*
zKVC~5UpU;}VODrEgGphXqK&WQCI|38QQ&V0GZAC_8fw#=I;LPCh9>;58%#~{%S(MX
zNqVmAN#r`?_ce^dbe_{IYwgOIKm6X+VOJJcEfZ-$*xuIH4e>`;e`IyfoV*-nB5?Mw
zr4-u*nbp+9zvL%9#m}^GlW4v@m;h#XFZowBV%OIv;&|xeS^0iTA{?*An>Rw3tX1^d
z=kR3^?eTZ6&T|AY@836Mya+bzv@-Y$gyteSn#VK<`7gnijI`}9_C)S}&A*%;)>AAT
zPkB`e$cF}r$GL0A(u8$NJzoEZKm`_{j>!IVSk<$4=#Wo4eb&N~XwhavqaAurPI@OF
zAaEIWn5c4clX5goOPPdyTC&cW<(TPT`SFa-1+o--`^Eh9jZGq3oN3HT0j((sKfw4F
zUiY+P_N~@N>WMl-8{0T9l16xb*H(_PIxSh0Al%GyLq&~Y&$ZDshubkngH36+E}Eei
z_ok{OQ-kqw=3Sc>Ie$-D^6Xo6LuEhtD=X5{$G&CU4Z8K5$4T|tHFDCITv5Sw>qM9z
z?Cp7&-tFia4PO%ua7auyn#!#x_EEdh%saFD3l~>#w5@D|FIbN{IL}fgsLL;)+{<UM
zQXXoqaBvOAth<$W^tnWTpLhT-`2d5EOmyo?%fbbsC#Wb3oQ}QRpSw>R8K}KMBfW|Y
zAx9T7rCjCUx%<XUb%n~TDsnMYaDtENG6Ts*<f-`X-Kkr-nPN#Kb+?kczdFto2*>=B
zbYkt#>%r$)V$=SkNy)~btAi?l&2}&*XT+z`Lq%kxn;j<3Y4*;QrSa1I%hK*zgwM;b
zu4CnQ8eA8;_>^I>Bz!gLh>q2MXCg<|`pCTUt5UD1M#@_*<IyNXm!H^-Lvxu848hr%
zwc|hBx_rFNzr62ia|{)&n}>e-nXVOhHji%WZ`nV~>Y)NQm*nb}RFl@tS27FscyH6Z
zvS*TrA9!1t*yg>YgFh2FkF@&T+|Ua(S=xFi-hb4gH(B&*X-pwL;8!w=W+<`ewXx36
zp7%mK9UT<kJZlrE@`RQVCeGe})TMBw>|S=KIQL)MBRYUDv+;NQj|DaTwZaT@x&6+K
zfAidEFYRs<)-cZFpXh%d370j`Yv#sVvW8kX*C%y>)2ry5KC_j9u)mxpfRlr@?En2Z
z%%0aOKq#RqSe<J$k_Ggl2<R`HFU!rkaPe4jR@aYJ7YmKO(sAPMIATGK(CC_JDdT)g
zzWOhX&`pU!Xs=#951%L@QgSA%resXtXUiNP1v?$mj-hqY=9wP+%e%@!Jiq}+P?Ejr
z_t@+^fk&L6QNvz=OIdvE1cfRXobkZTer|>z#}85D&u%@ZGr~gGZin|#s<k!u*hPrd
zBYy{b$N^M~<t9JGz9Hq=7KJ`FazbdNHoRp{{b*5p<!RQzFoyQy<1(BUL33Mmksn%u
zyTwIwW!+;IbhXp-P9WsPY%_0i%=Zm)lGl@cp9~@*hJ4>m8%DKgzE~vUIF!_H#8dt}
zOicVRM%MV8Yk01bMmwNHcG@5rriZ89Jv&o5=~bv;<K-s$dhXemV}H`d87fas*#E{q
zyJE~audo+EO>BO!Nh8BgqoNG2uzG~3he());Ae-DjoBX_sEb)W{5$%biDg)gT0K?#
z#uMu=#>vJUJ~4tZhR!qAD^Aim7YGP_0)oFKZ`2|>-6@;o@n2HcUtXpeLF8{K-@3yZ
z{C*HoN5}vETbZGkt>wpxgqDDGC54(c{^wvkLIAJJVDQ80K_P!nA&H6A#POxH5f!lI
zat5yIbGr{yRl-~%Z5{2Yf_V>hhs60ME<9xYt0lbY2ir-qcCs&BE!JwCfkSK?2(_LI
z5P3M@%h0qt2T+U8|A^CkrRpt1BYPrpZhL)K^LF^anNq-UVuQ0mD5iacgWlr@VQapW
zk7*BH(L~0?=+*TT^GvSy%9zh%H`rZv&-e-{s4H>$+&=5}Smajn?IT&g_L)T&%gMcw
zil8_}p)uMD4~SoNR+v5f(Jr<5u*gEAG~V{EUdsdK9}iu!Ro%bsa|&9r>I<v7AMPSY
zb_-v>mAy+F+xotH-=nfmk7=f1l55Y%u_&+UownUYszbbd6#YdI*2y+&QRU5gdGA?5
z!Z7zj_>)@YDr+2t7IK0{e3z0|pR6AM<kSH%itc@x-)MLZyItMdH^bkBtF+&xRaSm^
zwj;C>vwVn}z$QfKpvw1yrz-=Q$ls;o17rVNFu(swDdB(1>aX;GtW;O}VlLNKh!6~^
zNh07Bk{ea1@2qYTr6C8%ZCKFuxMot>0L_@B=}Ja(+Q>DNTqg+fsUbf*qfP50wy5$8
z*Cm4kxkO3_ZtVFto>mdb)^9T3>WrkrA%C*FGz$=w!byS}4pC|33#`h0EQH&2WSO(_
zPrshy2H-FrqY<*~b0)_7yRbdMR_;D11Ja9#+Io-kM`mPw@jp+TZynUsI@^2K-{9Vb
zb+7M*s#Sy%pE^bbUt3F&-aeM@gH5&z;Zb8Nr0Dww{VZ~xKE0H*`O)-Ujvlk7{Ss;M
z08mE(uMOjjY?$^Fu!~=v`O%oz{0g0>OLn)e$Ic&QSIgp7v=C$0=oh;o?x1k!^2-k^
z%U?ILdiAq5RJG<gbaJXfrVb3XVc4Q5kxZQ{tRmgqU2*EP>m4VaaPS!iRIY@T+vD9}
z^)tAaN6$b1)x3xcS-)!7y~UeAIDW{!vLC=a^8Je>k0gN=(xD-sQ+pA>R>1s67toDl
zmM)17tN$&szsJF#q~ym|a7jWdWLCBZ?=n=Z=u|<b{@TlulnrvLm#5$^Ejx#FaYE!x
znCnEsdvd3e+3grnirwIm;oaGr*Az#^c4RkNDW`T6q*hij6mxtBEXY;M_U(4uQkpqm
z4)0+x=4x%P^s0XZ4Y(_^ym?wqS`;h3O(=Yj*)Nn0<pteipIts<*9S;W<S?q1&bsdi
zqxr|9)EwC~AiKYUvM3T+`^MK^oL-Qo8XwNnlV_W6+Df+JNPcP3JbiKgvBA{nz?h-e
z-UlEe;xg>SKWQF$&rox~@+?@2e<U9%Dr)VnPVkmg%=Gph3{?kM%ryA<K!H{BpO1<^
zn_SF$xZ6(Ll$a3*P@48WF$M<sQd-iC%*gfdp4WMMiPz`(2wL{!o4o6k81MVA+BLG-
z+^z4^#^EL3@@Ou;<=PQ5U_VZ{!Oh$YZ@vooDE9r18Y74bth_B!QK}^W+?z_*;js%T
zI8Ssxp(BtYTO|2l@R`ySfF{vC;bux>D=WY-{*}$nUkUA0x}Z-2m~Lh3|9H5+mITE5
z*YfBjFoBit9+yuXnT<DKK1@yGnCGb*b=-)-lT?;7qQ)q;&f5bae$Hqul}^QWQi`5|
z5b^08Kgp%`wK5*CW+rPya{3=U07jtW<TbjJU<00ir=i#F5Fo}}WtLSdA|iB=@w;%v
zspuCL9dw%6q3gRAiI)y%R<Z9^kvTNtl|WB)X*3`Wk3&xP8!~2Cvp?OBt~)c7O=B9K
znS3zT{nF&3T*Nf9$mqATP2F3aNydOsaBPPC(XQ^8*Flx^^Q{YFwt3IOG=xXyRhWrK
zsiJQ;HMG>oN2ZrY)jzHaVejtz$q;7XFqky4H@HO|{av@`FP^WH*`5@tYNi{ND9_bp
zoGz@pL0d?`+bp~@e8IzfhqQF~g+dbNXcPmU#khCdY4k36%Vdt5Yhb6x_H2(L%U(LU
zvZDAQ{dPji9wudHQ)ogQ-@X(vXP{Dl$QCiD4l~^}xOdn-Ym0nqWsvnOWiPFuV{fb$
zNalZA&gf*l(B1z?;;%>qI;ctdgpyhd{G_a0(@(1`;zI^lWxqtMi)B*I!j7@Q3RMe_
z)o^yj=Uf6eBD71{von=x#Dd~?{Vn8VLX0n3l7Zr({|Wc%*kzh%40C@YF0(Ku##c9n
z#1z{1z7&LhF12z#iKVzIdeyq|w1$NGVZdu?hG~AZdhovTO-Z?ss+`z?z>CkN1o~|n
zj;3&#5?Gl&H;P&Q2E!%CylwUF8a(}GG=Wj{d!zrqR>jk4dSDPhLeIrCp|dMP+-Zke
zSiB24SgOF1S!Kq_wA^zFEX;D7HXlM8n*NpF?W@NmCmu>iiCu3>Peq3xRJom}Xy$N@
z_hUHEP_5=o`|UQ?cMC^mh_2Zhg5J-InMMykiVtY-q<cmhi{lf$KHYw?(<KYsbDip0
z8l<HRH-;NyBe4tdx+DCGKcnXqe`?b*-1Euj3GpXFyCG4|(GoS5ov5GM$+NE~5|b)P
zuh@S6q__kza-QRHyl|C9TLJ?a?LVz~QUoA7b)2Xo(Tg%y^ZY{NJ+_vq98Y~hbepyx
zj20ysov|Pn2;^~R8mVLv3UV~rfcg9<a@g+=?gz(!O8g(olJ5@@=s2x`i#K{|5nV5U
zH{`gVcISeds<0cyoJEu+P%VirPI_b!xH#fHlI%?X7}RfrDNrhq#Pf<0Z9i9xx}022
zaq>{73cq;%Iu7JlAk`AT>R37;Rs%9C$9$#$z++~z`55pgFZPW{&je4Hld2@k=uz<=
z2Ti=<H@q{0ZbgSVw<BThD}`!Yzh%ZBb-IflS;SN6L<-!pe~<8XT<-y+fELZ{;;3D{
z^L#O9-Qs#18w3?J*+M2|^2g7`d+Qh5(__Rg-hqP?!im7e3Cen%y%}R-^=HL*zAkL<
ziDKQ07@bJ#bLVdw+*0(mWDJ4kXk+;Mup2eB)GJi=W7nn)_>9BvWa*9Od+2SX4!6#7
z!^KIg;(EK<om}eaYuU$zsyrUwap;OpDSUI`X!=gn?D|f&8#PJbi2w#Ts8y9Lr<JV7
zfkuJahOkmGH*$?|QXiw*eiuLLKY_iUhTKLw75tDmuY$!M#bd{2Xr$TWA@yH4%1Xy*
z%<U!SBn!&Aqp@H?MIU2_k)(vfLQVgA*CEDYhiK)wsQ8aERGY4U8v{9jXIA=PsWo{y
zwfSWAv>5AC{q+d*a)bMyUMcmsG=Kz6VtZC<_IJO*bVjBZ)GqQS-yjD56|9!wkT@Y@
z@O%38+-N0OCa&*cddaw->|<*?*&(H9q;x!6b7B6)5Yd&dUq4PLXrb=rG42_r<*4fJ
z5@}9LpI22Q3gX@_wbc~I#N{TvT>Dg)8j+$-<;rxi8U<;=f;40(cfZQ9fCFb;KFdq8
z07S0Ny!4>=2s2NtDNEn61dI-qA0A$wL{A6^RN!T4u*&q-Xj3P<H_LVbf0H3zFOV|(
zEP8UW&b(|^r^#{1d3_zBx@df+$g~VC*wfcDG4R>%o~x(5o_|SFSE8_HnOt>N;Vifr
z@*Q}3lSj`2kf+al<=K?%&{#@|@t!t4;pTKL!o}9mR<u+~LLi8<k0+`BR^`B>@m#hP
zsT21}eO`%-2On}cU%lQ~8zg9@eOb__o6OC!##zdCS&Sn_!}@!ngR7g#Rqjc%D<9>Z
z3T&MHepL?f&NG;K=2UxspUtPLy;eGNq@hNLxodKIVf2z|v$S-;yrYA^^dpYcR=MU<
zlX^Q-lPcD`UmhoT+?m9`{^pH=F)Mx7xft20uiJKWP@^=|(uLu!ZTrEvkdTSIbB6>x
z8`t{$MjF1xNxgp3dxU1{bVVb~fRRNm=QdkmU1tfSk)N?-tX>rCKwL)JO7@s)$Xvj@
znV43=$3MDW3R}kg6W;lpceQS%sNbV1wqMw-TvTZo5~Ex@?3Z;)>{z|U)y9oyujhD+
z7>Txz<wOX{uaE3fk4_5`SvTMHdAiR3U<<v?iEsBZKkci>>HbZ!`CxEws0HKq;48_v
zlIv{2zk<JHo`rFdS*&Fng-fbw1K)}4cL`#8SMTKf)7U&ser}`M9}zrit!G)~A2cfZ
zYg&d^yt}<-kV7hznEAt_nb>U=QaLc}Fxfq14%;9&X}R$-nx32QH)dgzXwT>C30p$L
zuT*SIhMD)2uAU$!bt(Qlf8rPUY9Va@pY%ZF#`MdLl(~f$r)i#j(v~+{1}eOK>H=kc
zkr`~6_+IKcnw!CsXjvD07@1o9k!+sv@rnA6hWf2GBtu#en>So<Ah=nX-S@jP%<1+?
zP=7XdSBBe1<oN)jWBGku*x@tY-^l4a-?JP7?^&q#AUHeE3!$A5UyRrrOvK0vctn5w
zOT-8N4$Um*Xg>`b(99t%F@?E4*#d6%_H~L`ExoSx=!ur>8EcT|^~t8XQ^leZWzBal
zr}ry|t&0gnf#$skB0m2vfQtV&FC=y!!6$!6Fpt0BEAdk{gU`*EY<;1EXj)jOIfE$R
zDpzLK`tx>-p>-?;nx@==lg&XD5mys!bq5r%$qd#$YtRJ1QP#%r>V{~<mNV2s(_VtZ
zFWh%`#(3sJ6L3da0Z_1=V9zFw3jGbd$Vmkl{77o4^vy3Wkxq6T@eJJ$ugZiI!z28&
z{a)I$d&}p1W_LB-a``90d^c&eD;6CN508j+Jfr}wNH6)Xw(8{o1SS&h6b=u<OP~>O
zB)~eL`d(xmiiI9EQ4~hdR-{d_%r}=p1=b6`O20jqvS-}uNQ4!3F`r`4FX@N`pz#8p
znfgnoSRlSB6;?7tOuH^qxzN}+pPV-t7eM~We2XYekSLkmmZnG~{mi6pBR7zp>Y$z}
zhl0CD1UZG4qM-V02nP@YY$UW;2Y?8?1Sqeroeu-Ur6Qr>{zzo4i1gSBzQe*wpx2gK
zC;!`+B1)De?a22^ZWgnhO)#ywo{^zcmeaUOxgRwv?`Yf^8$a`r$BdO&pqIjY?4T2`
zn*~eixzon`(EOLpmbUu81#SeuEwTYNSD&?tK@l*}+R`fOO<;=+5|r@i2o;0^a2bT_
zI)U19ZtevIS@$q~9EN3Ri+FYx<z~g_rfwUHAW0pc%}GM5j>}*)@x11gt*1V_&xcC1
z?vbvGU%OBuwnN_Fkaz%X8ouOiHtxS3;pq1?MgB`K_b2N2FB@`K#&p$C@ptHj`l<R^
z6!AeM@<lYjtUSfB^bSCnA#4z+HIwZyf00Qfb`$Fiphx7mXl3d{&PaE7kOvunRGq=j
z9!Okk<ck=U`aFPvp`E)FA~)d(JP+tKoQ`u6E8*_(N@!=y04VPR7_lFL#FCIWjGF>F
z(m^$}48V=j?(|bP;Kcw~3j#nCKtXWzbYv?LfHDv^91c&wL9KyZ1)$~)ckWaJP$C_S
z^E?)*u7F@110WAX?nJ>oV{2#bxQB0hMuG=9!w~>vfP2oOHUUNghevt>kSnOZ0;&@N
zaONgFNdN#st!*fv_iCtBR57$0`CRN|TYXwA1W*;5_sEIZIwdj$03$pn&=62_2jI{*
zcmx7qQvhOlkL=&XhN^^P16v?mTb&Su4XoC)M}pA-1ZFn~0y15-3xxjQFz=D|MJP`p
zI2>&=f;~HoH7S@y9efX`0~xVs`mEF8GfZ(Yd^ZvTNLg=!GiH+x)dBQzyFL#B*KWhc
zw_$gX^=|?_tm^?@YNZp&7$6B|Yz;9CuWzfz8=;VN&=4G3B0y~rm^pGeP#%DrL0JS9
zINCA_8tY#})(=D7clv|i?j%WP=rP^kUF!I8K>6tKt<x65p+2&f;{om^fJ9@VVt^k3
zY$+0YKD+i@eG!`P%0j~fp8zlhLJ{`R0P}nq1`skYy%+#V0hB~w02?{ZAC3(T9(FfB
zMAs;{b3sTtN~VTFhXB~b8fvRO@*b)$$G}sw9wKqfv%z%W6sQz7<PCxl3DuEvfJj8}
zrw{;LY&mce1ua5oASeZdB=}k>CVLUrx%d1)JA_vYb_Qp-0?>;J0Hi994S1^jf(IiX
z2SE48<=7yHdNmYx6uckcO2>lOC;&QfIk~j@=(0Hj*xPS-Eu{x`A^g%wnfe1<g)sVy
zH_?_U?Q&{M-}_;ra+%w9MZwX^cQKTQ_PVqBvC`2R*tYtDkk<>d5$lx;*EJiMMb<i}
zE|05^ZtW(LH)A@e0k>B+4QcUGA;y&(vmq+)VjdzY-)<FX4^M7JJH8j1j95kR!wkoQ
zCX&S1UdK@IJF@|m@0T`X7=9)5x#AesZca!w;iP+G7p8yDbyJ0=;u4$dPDM4Zfqe!~
z`A$oHnf^U?S*of0WVC%j?~vF$iJ<g2mO59vJr)dTW%-=V(<K~*C7E@n9{uV{{@u{C
z=9zoRBlD_8&ss7S7Q5m0yRsi_CV0QXVNm(+a0Qx9a5PIT;buFYRKN3E&^4n)W#FE+
z>W5B0+j)9248Jh=;KA23k-I*ZVQbKSA2HwTE`mrr88vn%LSBG4#rBWU>~zehk*BBJ
z$a`!>o#Se*@q3s|UW>QT$@B*cckQ2ctV~6+=`!8DR<U(u^hInge;3d4#R>zK-%3tz
z%x-<Z7{a7s@10Tg?BsjH?@Gp6V&XpRGQl}6>P@k6wsud))viqNrs8H<b?<urY9Dhw
zF(<SU7KUL#{W9h=V!t;1I`$JP3)%cCaQ!pex8SJ$U#JkR_ccS++ExWF^8G~-6@0=x
zGq16oe?|{XzwZfSl1$-wmpgA4cPpX~pJ1A~V$iM8S&(KTzUalbyC-9jaBS~Wg7d=0
z{-U%^k~o~U+FR90Q6FW@OQ6U~e3<WSr~L}QteUN4D5bx=6BB-G6@4!}`B8g_nbeu0
z>oF(gntqu*9FbeRsK&;4gQ;`}gM>fwwF~=DGJ-hYmyI8T6cv{jpu=rHjvfhgtBDQA
zZTkc}T8!V{ZPg>;iD5Z%<3foiS}osxJ}T-^k(1+KdHXb*n&ECHo0?mvp^@D+HAB7D
zmX`Z^n_=OEP=aJY@=)z1xy`ex5?=oAvp>fPUbQMrO)I*{k%eUDNX};-T9$HnF42Bf
zPDqTvrWiQ>nbl=^)4^TqLY1;Ir@zx#t^0Ss<i&7=7CAhmF7S&c-fMNL$vy8J)O6o8
z!A{J)%;<FFSfc*DT1?y}%-z<zDuaZTd5}vPdEdBKHK)DsekggtMb&Lljxcflx(Kr0
zZ9LH58g^mogZa(mMZE}KH~YeqVPVUQOCx0?w|kys!|N0Eam&3^!*!jnGagK|7hFqf
z(x1P@S@PyijelY@j{sq6f&&xO4TBxNX<FV>RTewWMX{WV>NULI$}|CJ6Tq`<Vv}^E
zm;z3qHn$x+PJ3P^k{E?2*<+ygB?w<9u!?~umT;Z?%Y8l{Ft?T=Y9LOSzEy%icJUkM
zh@vBD_PLMr27L!1z?z7JPdL;Gl;r@b3_%526<WtQvJL3v7vwe(NQV^T-77B$_dTTT
zo-|&>UM4@|Z;}?}%<0pYbB|Ymwh<%9=dR$EjUdJ1Fgxz%&wBX2_7uF0chgEVZ|Sf~
zSZ#DGp8yOQWDdY%-$N8DIQ-89e8k=C!J5M}9k{Q3IkU0U5zBW`qM9VIJo{Z#)x$2@
zFlFk+BfJ!()(NNujfb#+L<2%2%;q+H7NvA7G64suEY05{-7w<^HrJe_MYF!!iQ_np
z)c6-yt4~6h^b3qPAfC<z8t;wDvTPj2<u5y>Zu{b{&P4!TvkVRNOKZ725e*o4Cojso
z2@i9dLT@@Z8n&Us0f7J=)Ct~vq5)UHGt$jd4Z|%hYBlioNdF-px4_${q(zUAuE)Ct
zs9|)~FjiqnO7MgU#{_UcgD48<z{dL+Yy^T%Y|%jn(QmYF0kKfl2C~km4cGSEVO{M!
zVNtjmP)N-2LO<<uYrq5#4U7x_B)8!0B(C|y=(yBvKku|&wNr;XMtZhEy@rVxIG{hV
z1HJ|v9lqw!2rlkksmNt)HSmc(VV_8m%=$(WLJpaZVVRB!X3ML!N6)}4udT0jYR^$r
z0Ldn{9xyksfOAl5f6Tc$4(qoF)w)z$4rL9`2|%k&>;phpGEt&pkwT056nG>AXdi$Y
zMZf!ZT0`|YP#s1IL@qc;z5-bc?lv2sB@nfS#g~sel5WIDu$#&e_|oD6%`|WPjk@!9
zV*yVf%UCMjorDEp4+_KsnF^6^@_++`swizMtAKk7K!6T$6e!Oy+9JXk5;syS$nC$<
z@160}YK8uJ>=P*>3W+k3ni<%PbnL*w%i3_-<(N8kBvgA}0ZSK>{|1OyaF~m61Gq%w
z8UX`G_DSMi#k+I#vP}(2kG+d`4-;_@a+|^_@m;%2?y%w@A+dmAgdB)~JA0_WSLx&$
zY)Couk_0B!Z3gHl0$D$cQHrF82JUe4fUp@5FUGq)>$~U|B@tM#@}1mfq~>9bOY<T0
zg5^=c$JxjoDhiz~S!3jf=Yj~^&;$sSx82BX%OKi7p+VF}ZmWYpFaWxn4Y)Az@<5J(
zjTG#}x5zCxf}jtfEdWglaL2$s+~E@`yi(N4F-Z;MhH;m!A$%vdTHsGi<_v8G06B*-
zMt8ag?n0;?<ogl$`}b(X36z^9=x`eZXdoa&Tm;k`B(#J@e2d&fcmlGP4mN0W0{$M0
z(1F84?;zkVb^0iHJzVHpq?C&AAh;B07063AOzhlm_IObB|Eo-W@k&@g4+CryC*lJH
zh|&ND42OY(Xu)j?8wNOLol5jj4%apTwEYf<E!EmyoW#J1cM!-q4nSJT+zmn!Rxwzg
zmjXvX^X|YhfBunfYH2qTO2`1(QAln#7U>1POMDipK8bM!k&89%njo~=w)h-`nED{9
zQ|m<56ELDcG$1$xL9+nJi$D^P4Fb;1z=ogvSDo#~a{F(@yA2Hx3^Jm)uafPCWyRWz
zvzCp`gn=Au5umf>SP~d_tra_vZKPwQt`1^z%@ah1$bkvK#RE)~To86)>U-htktB*I
zpx($~;P7HV?GV8Rd2#@e074<ida!4EC9nwhcnmz_WaLHr+(L3I(9M3%zWaWOGC-#S
z1}5{Sc8|8U#y)>&0CEv{z!Ewn8(LK_u0YlatwI=(M$Ex?kQ6}Cdk6?tf`B3xKQ++{
z$HD<gFK-nPW<VsKb`*tnen~Qjg!dh4LraUwk|My{o{_rIkpXYDNx}c*vi-ml&P@HC
zcsDB%<ZAP<V-g6tYds0uxlsKa+<nbc5fzX1?2Uy$JP2Y$s(WBNRQq7UVMigzOf!aJ
zB}><5M~WGxZT#6t^;m9kHV896U3_e(K4it(%dR-y8r>1v;`@z(fT!BCl)HjWfdVeE
zPL*2wcgSLgqJMT)-8$h)@!<cm@Y(iNxt~zN(i&%f=s3?X91av2j=&;f$2*jO+XO-D
z+A_2O0%Le0;6g%xhP4|Bk9S9)&HvyabHbvLy1>`JeoP|BIIB0L;V`-NWLxdgc}A6Q
zQFgRJYN>JmF6n9GA%*vOOs350eEasKLo-G<b9p8&<PYx|R8ZG)`6!4o&OneB%=irr
z51(NM`RxEr`WttI;+O<=DxX<sH$Hm4=jQTirwW}vhie6-B^?MFzdr@oly5+SK#4>k
zS0N8%{Q?G1mY^0Zkkp}p*Mk<9!C4s4V>;)_9iaqgx9~GkUqpwLwv~|Ejnu|~*IqP|
zeyS>~9$7zv4TuHTu&x(`MDP-0H74Bo2L!4PJG_vA(I`rX7#U2%q{XFKQm8g^sjy1z
zO*>6-PU(#)_UOkQ3Ws=@@LZg#TIt%PQ?^D8Ng7_usf*A?Ii|P`cWoP5#0KTB0=<Oq
zh{EgEE}jhRDyP#Cv+5ws790>?cXeC>irPAnxWjbMG<K^hYmNP^fEq^W1ZFGpLcDvp
zGbYWKY$L_aoH_21L6|S-%6mRW@$x1TBslFS+4g&MyML&Qe9LC*<)A2N$Z*E=z<lL(
z2@5{+bz}9n-2SY2a=>FD@;i|BqM!x6TY(rrK_$|Oxy1A!BsjY5e&K%G!255AY&fSy
z1aMjHOTewJ(k&xv>z~9A|IjUdUHnMakz7E2;@Apu3iB{zH*MRLei%o2czOSEt+$Ta
zQF*to_+1Si@9!`VL0k<Yvds8cU`<O78je^11_DU2<rBTJSm#b52+TpG%V8t6h)rqH
zK3HZ31Fy<OusAJ@Ge_2xOM~|X<#eNz@Z2(u%5KUl;`r2<>lBS>#%_a+mhBI^$$!32
z_I5ljXefTIhh27lUYKaYelCj81a6^p9G}XmSBuCQc~Nq7p8NgD;D5S^8@?2F8B@+H
z2J}@He~BEyw0ToTt{fVBYU?Sl@Tv6C>tHpwo)w>I_=3OrJ%jLL&Hc+;3eKieGKuni
zS($vDwie*Inqgm}i0)|L?&Q=PnTE%DIKdWE2#Ais0ImRd>wiV|0RVvJX<l7n?na*s
ze)g<rwt4T=i^N`3@ULcC_GL?Dury?Xrpl_8z;X8bVbQ^(XD^r$*)+K=y9bMfAKp{-
z$!qYr$<D#)kY(+5Fv?JMhEApm?&jxeI<zctipFZaRJbSjc_N!zQ;JSriDvxHBC86U
z_;B_O)nmHzkb@T^+F$mJf#-NZ{NZ<-G6h%JY)@K7zMh?q=CWEEqA`4AdVGg7Jt;L`
zS)&DQ5@vHXx!`6?k<0)ozVJeWlrp!P%6v`owsK&_$8Vnmq|0YGOPQ4Q{P>GGg4GGz
z!mN@EKU+EZ1lcXZ<QKCzQi?b6L!c>c2PxLC#3nZ)S$QdsS|u+#z|nbXtCB@z-a7m2
z8y~6Bln^)n(~jx{)6*F$!qH(P{-J$!Fz=Xix8rEwL9>*(1a*6&9>b8Jb$`5!fapkW
z8S_aVFaFEbJo{b}w36_A8ttk**b#}Cb%g!2t!ithVc=b3<QR9V6sKtcW3pzy4_JyR
z%qY2YZmpiKF!C<x{n2;uh2}W`&IW5fxp}^BQEBrsbS0Y*ARLPNB&NM5&(zUUXr7Hr
zqU#JH-cF|MZ*~1&_`pNf`Ckf3hjI;%G;1W-{8`8wUg_Dsy-(}C%RKjL`G>%_q&A$a
zc?>98s$(0f+k=16$d19y%`_s<IamG`NBh&$(|{afA@T%&dMkb}fkqIHd+TVTxZN{&
zMb~p9DKEX7Z75mKg-L<oNfo-$MC?1ciktM?ke7M5?>5!wEyd4`2M;?ZF{>h=u9ze)
zKskWdE`Dbk(@Na4^*bOM%6w_x)ii01*3EVK6R(OmZ8D}iYyM-qVUl#IfM=!v;e`LC
zZm^?>mh8-&FyW*CzSpW)>v@UQ!h~w(Kfe3rqGHYcYEq#bKIOZy=fn^7DgN2)n!lJn
ziuYk*(;i*Q(u~p@;401RSBFKx9{bUZ<66+O>&i1Wcw4^d)8(;O_Jc{eV2>(}zvL<6
z<D`!|y7$uVKGCLbytc@v&546&)NE6i*XpQRQ~shR#%(n9oi`itr|)Eu3fosg>OIqv
zzU90TO8)rv{Uyt;g4~XV_L0k`H$;+@#4pX-h>08L7k7GYi~(@RN`iEtKG^BXuGb>1
z*BN`j{m|Y^&0A%u6;=adnL~{W0_}TbCrV;mE+Kw0@CNza*)Z1@!uncVAE&f`!L!)}
zBic3)Yz8}@teY=e&5<t8E{fUx60`hTvksrfWJi-Bi-@03q9*#I)1?NPEM(-qxSj*x
zkuxs{r$T5fIwOD%ir}wLvDywn#g|F%WGNB+`K#&7vl0vXE^wgj!aR>(V8JmU!~DAu
zmEk@eXU)@lY7dOJhDnhX=2+RABUvns+(#Kw6MPKKh}^eaSHDvB2M9n2^4#_p%rXP^
zNt!0&8^Ubf4iX23tfoem*O7b+adpe=ljs>|hi~s5&3<8FFA@+-JQ&KVH@B(lfh`*t
zVWe?p)M$lxzc4fW<Y~}xnz)dsXv0Hw6x$yAR6opp(Z|pVVC_{Z^0m=oj~?AYRc7KU
zDv7Fv2b|W#d(!p=SjD$9HJDVChC3fpbs|>oS{`RkN{^ClW^(%?_4|agy$^Up#?9{Z
z88y-^sQ~PoAiDaGIzZZ!Ps2>o4Nt_zOI}dUHC>7<d5O^W*!3;bnJ|`q^9?LMPMA9m
z_N=*BrNpbmWKPoIy0N~I<)F6f7j1r6WHzLD@W}ofs@zU=*MjQU``xxJ;(gEA1MmJH
zs@?=1s_*|Fw<RQ5Ln)yeQI;f2Wu(wzNxG&cOtdIkP!nmGh-{%<iL@_w%uLdheQc8?
zsdo*PY=acVOp?Kv`+wc~e1DI}-@A9~n7Q|ybI*CbUeD!aoz>H`ZMVh7j-jEEabex`
z^MQ0?ifC^0nJKNrkM_mM%>rAzHZM-PIwYD~$1)PlNZH|C?)Qaq5Qd-8TrT}TEEix$
zoad5)|1VNeJaJv6=McT^$OB%`;=PXL_yqL_)1KyAxZ5-T!o7lE_j?=T$xj>Km9)-F
zT-fcAcA%}8wb$->#P%29yRs^kx&Cm)(b~RyE1Y!n>K?9SMD1!?oBRxE?&eA!Prfqd
zwrIwDOP{QJTqiy%bBLCEvg<{O8@c(S+a{GR&4mi7&WArAFjX_!*V`4ORC4H8(z!QB
zL8YmGK$spld|pJ!@Lw8ob+&^Xi<2Kbv(+Tl3}=E#>8FC_7d)uH<XvFZ)V6(>OM}sa
za3!TVvWHjf(YM>D+I=xx-!9~mwpM*BHjX7(6rHdns_C4K-`<dS#%lS=?oII*?9V8=
z$4>BGD0=JZtIbM?QSwOeE(q+L#^0g3A-K?~bDBMW`J3#mkr=67FhYw6IB!E#ZnI7u
z(T|F%QhC>WX2I&Tk?t=~$Ds#KN^M+fy-9Es$R_hOp5u_YXofq_z}-CxROG|?SEZ|-
z!QflC9{K<GTyW2K0^}TCE?Dj6SX64@ofjC}-xBK}x_0$P=8wgLQV!fFvC4>;TGkrV
z{@gKN%WIDBicKN&B5W*2=&Aia%SSAAI>rcdFP|ViDcb!UektUgG)p_RWmE0mNWImX
zN3tSvJT^8TZ9Yow?=W~h7pEfko%y|4;-wLN1Bcd)qchixm526perw!5cG1nfTv=NI
zjeM$@b@$!Y(?}#8r%vqA(s}I{_}fQU%&%4@sG8_m6HjhW)$_)=0F)ntXTs&|>2J+5
z9yr=~th+U1>Qgy=oE8F$6#o+5$){ua;-xRnti5&q+8lkk!t*&zWpTnST1AtcJp~C7
z@fSwT%D+X?mETTQZix1M^u%F7<=yut-xmijCen0#h6pPC7DaO!uQ~OnnItV=d+&XG
zocs5tU#1;W@z&is=bR&WZEbn+&$Q2Gn4VRp&oSY38=txMso{+{>o0LZ45(S`m0$`n
z|ILV@&aGL%P?-cbg8z{k@F&7SA0OkCze`F(V9n111HrBZbcO3>&rEa0o2t@{^Bzg0
zG`k;iTDGafg2SVo;RBm3?mBl`tX9b-X=Q-ny3WS5yY<<`toMzD>ps-ij4f3yxFVZY
z=xlYYWS8E28E1jnqf>HME!6f~x<;i^Q-nR2>8596`WqG3y|erco^!C+ZI>7}CnvS#
zhW6=)DYspJ_I1V09iL?8KD(AyvRigv_u^hk!65hpW)&{Xe871B!=)|1{_Qnsyz-#R
zP{<kmR^nd*Xp)tpF1vIL6TY0R_7wF!eVFoEFE^yB+%jp|j<o-7oug!^o;mYc1FKwq
z>qu-z_xs49VT~K-ZlBVluz`y$ww|oXYmi&ppzF0K;XChre#WNZBqv)l?HBe5$K@6~
zo(&w@QmI`g9}|4o;lFte_g_REw;C?<FsD`{p660`>K+fe6M4LQ_UBC9#!{X{XQTYV
zb0tL!=h&@M96#Y?x%#?ew}-U{We{sPSuWm{ph;-XT8fW<bN`^MZ^lo2=NeYuz=Bi5
zowuKI5I9}DqvL;V`~FUilYf%+U<JnI9S7>#-@hTINH<piqcr_ZQP9E6)<Ji1_Oz?&
z7azuY<nx^9dbb1~$7hExh`raj)M=zvVx+^k)0Wo$qWRCG$+!Kg3L#6Mx@Tw9D%+cn
zZ!?=MdqcMG)ZXoV=Uy!p@f&5VotIZxJ6m<hERc~ADQw?&Vb_@~B6x|-U%1Aj{5ElZ
z$sVWXFK<gaajsU0nN8NFx2<XjT}&I2pVLJfiko&pu0iuDZ`y-vje6Em4*1Jt;_vq^
zzrmjAU-a6NXQy(QaznwAcS%3W0bhJTyeyx+(WZOtyI<Q}kM^x+krvKwfgW6Q^cByz
z&d5+r?w*rW7B^W$5u10nH?$MlKSUm#t+!LAWfP$vOJ3!jF_zHu!kpjWv|rmYAwO{$
zXQtcoIqPN)tT=5nRzF6cW3~PQyW4@gs{L2suM{6jk|}kDu4_ruk+P)arLWIdDvdwu
zRQS*3$c_s;weprqP4x5$pzhGNR#=Eri(z8w_j;#Bn$-2b%yJqTAIsOliEbuc3!*FG
zl>U3H<O%b!@82INW6~QrFlhvABIZDI_iC%<^zRSuA4&>;zYM#7=*7LVV5=`{jr>i5
z#N3Jfznco@>(mN2V<QLRK8IgFbM45K%@Hp;F%gsI#GHWl`2GI<-#=pBo(`=lOTJ_G
z^SzALHQbvKhF$k8dD^DZ_1o>ne{qLaetmz?wEGXaqm3@X+3ec2Pn$7jknPN}7g*CB
zM#D3$@Z9>#7v^tYKE3!Q{cKs;{hiHGxcBX2L8<wQDEG8W3sl=48`xizyB#^Q`?iUg
zAgXq_mB@TAFSpENWtZN}4KlUN2U1MN(lx`_;LS^gt%tV?1&Z@~lNGwgW=NE#x$U`C
znDkm{WT|mE7zDksy0+AAeEsfL;(G6Iw;PGzM4}**r`Ok=VSB@3Uy-QE-tLQJ#thlL
z1hb;k%72V+;Ff}~{)@YKf}7z#{#E@kB5T+k@bXYqwUeFxk3Bz|8``eTys>xd=vMyb
z)$SF&KVRpS{LkXE+e1#blAVnS&(Vy&$jb4$o}98wTJy$jy@_>orrWgLH&(6qG5Pef
z^$fQxsdnDR2F+E&E2bTHa40*KE6S#I2(8kk{v{D5Y7b@BwMhMjC2d`9TUw$!96Gzb
zcI%fG*A4evIHcyLx@fF=4|B_%mxNPhU(Qr_w3+LzJS-KP4-GfSM(PPHbevQM7&XmT
zCVHDw^XFNyG%T{FwsE$Og@&`XQpTUQ!2+;Km!)AnTx^<NQZ)QmXQ9)Ht-KyhvM_S7
z`O=|%cGHdf*6lU$?W?beY<^T~l(m1kHgeQL*XW?hhhf%#hg%OHS_x<5xIz#SyZ&1=
zp9X6aFp1@_X5;S@r&Z6vrfd#^rB$P)<ny8LV5k4!ey&s-n>g^jdvz2S^Jvp3C%_7W
ze{8z{F}W@}GwDxr`LeT5u=n`taa;6~G;?_;T<dku$2V5A!h0TjpZMzn)^z{N=UhUD
z?cd)VO8j+>{=2D!<0L1q$^MrLQ4|&=fW|$d;>udgcHR(!Q~vnfxJ}1SBA8^jp2&5k
zr?bCij52%6Ddsy5<#+RB)nC4q{q_4nu*c2GprxumXGoxO;uLbBaZyjB;L;IOp2M_4
zJZi=hTU__xyl|qhJwbhKD(V0J5<boPTVsz&B|&MGx4?CMR62*<<t!(=XT<EcWc{4X
zq>NRXaVosyG$4h}44;_J?)$)eF8)mOOpC2o-+t4m`jF}h9;fOF`<*b<L|bVmZOyXa
zGiGR_^WG%YEe)pyyT-4X-Ex+_X<&0n?UB{vc_!J=3hP#yz7@^SQbq69#p!j`zXxv1
z$O`8v&0hPTL(qQ?bm%`ZPRHVMXbW!r;j2$;eb%Y>puRRO3!*%)NII`-MtlV`dPhn3
z>ww61;AuHryoM>ho<+bHw3t^22GPQ@Rfv1?t4+NJ9J4TayOG!S`8~SZlj_XtEDW~D
zB(rh4Rx|iCq&HwPOV%F*D~2zYTY^Vsw5WZayG!@naiM3b_H3h>&LpF@b&6K<qsfP6
z76o6v$)Dzy!|OY<t5(5dk4Ffm(qUG3Rw#HIcvcv`YEXQHGqrj{t=Mnw^sT3^`aBvR
zX*+a2W$H+thOQfi)jS?$FQ4}GJLSTQ?V=N;-*ky)quxaC{CyUBym56U%1#lvQaNTn
zTRUWuW`0nAx!y{@oz9wV*r9TYvFe*ySjzLc>AAnEXpT2+zuH#$<o!&E;>}j8SaYcn
zQ@l<;qn-82_4|WrspNX0NMr34C(}m5Q#vy0_Ws}Q*y@L)=d27dK{3_YZOULQ;>q%F
z$vaBiPGG*9#Z>2bvYfbD?Zu*pD~7Pfrati@x+)v98^5S#s;vEGx|j<hg;^gWeBVK)
zFT1=QN<Y>!x^8NR_z8C@S!g6|df+EAa`?&K7gnvbUdJ`K;&rpf+y5-|>dd+l)z>R;
zd3)armK|GR!RhMh2}*as0|^4z?Rrhi^=hU^5y!ag3)ST`Nm~u|-vALFKZI!t?G}%A
zol@tCCYWJ-nu(HCRMF`bX2n9&(Z;t*i@PLBM|8SP<b`vziB$_F(|$Dz^TMIH4~UO~
zB*3pSqmPe7*iwMp!RQ%<B5D{E_B$APJN;e#K;k>WhH`4@Lw3?73MOVGZ<F<FCG<-d
zy(8V=yvMYHRx4yJj_(8;$)v}My7b|iI65|77yR`rD)@J8TJ@ftWUOXL*(q+;_@lr)
zk$vdT6es-{qrVp}H+1D@2arn!Dz(l;uds@^rBplr&EsP<lP~tk@yEE6Bl<PRZe3b2
ze}$4pnaztmGBQ~*GH(qsj!%&knh`$S0SQ+}Zu8b6w^Cwo4$UH<RCPlA-4%v`5Q7W)
zkq<{!GPF%}Q@TxHsKBpFWWS;H>`GdIFmHuipp%2!T6uq2L;u)qwev{bbyinX(pU%k
z>L@GK?bXi53r~!M;c&!dricu6T`ypv@By=$Y`NRZx(9{W(MKhWN7lr}9Nh+F`*}Sm
zjAlWpCd4QD><VG+-;YZX=^f}!=Dip}LbKjdoj0`-S4Ul^PaVS4f>QRozNJ69u=n)T
zq4mYs2zr4ceoa(cSGefHGN@#$_x^4|YNwxh`-NJ#aB=!)k$vnM%9afxed8m*23k2=
zd&z+0*b~1s5|bLm`8qP|f>est-8R2l*jneldEt9L(Hx*he;_fHjHBq?UOocAR|$ii
zfb(ij_O&qZVtk<bD_UUO?EeeHO=hmv?Op~}109@@ADhy}nFfifr8Pl5GbB;T$Gk$V
zpc0$ENYNe`O(VN!(z8ZrCvB53ThY7^RzKZr8f$RB0yhpB_Z}Fy3wVGQ5X-J`wjM?3
zf#Lx`Cnz-t3v}yD(ytb7EE0+MIhxFgsymv(t2g|Av1G0HG>5Q93WDBY@*NDI<}iv<
zYXH>x>%bHM6!&A~h6aQTHxuz0s^?)~U@$R;3;6vtsDa~QJ8{E>uwJya2_O&vCYU7A
zJcLACMpaJxFU9X#C(%LJQ~P+q|KisCBnR7vf00^oCCUMv_W;0Mk4~~GJrPeHSO)M$
z14x|+jer{^Tn>P1ruw(@!>bAoxB*6(K+!qdhzHAf3<h<XnX5JW(EefMdM2pQL(2y4
z4>4Gt2o1E%tpJ^sf*S)8#V0Ky5rA`N0YlNjv9v_&;L2*|I$7wf66k8*`}8jc?H>^l
zBB)J#FC*7CMm!1U!+FC}mPt;j*o6UOIEL)(<;NZJ6SGhTh`3Sd0K-3!LvCn7T4VST
zF#z;{RRY@77(mhms{|n1D6OM;Bgor~^?=$FXi|a@*POsrPZ??ptP9@6t+kl<OXJar
zFm#v<Kz-ooBL|crTI0tcPz!P|x3(ikvO&@w3VsWI00#>5kQfG_^#J?40I4(nmE@f~
zKQ&4zZ$zA>4sFH0{2N@TS4v?utq>PyhO#V6(T2az;TMET2AcpD3RhoR2>>k<2POd}
zkr2o%w8WO3!<c050gw)eWoR}|GK+cS5XxA&n2=3QQiG9>s<Zfif-Tm>qfEh9<!(zm
zY^l@s&C>v3i4A20ARBR4hawTaXn=ec%D#wRPibN7h|YoW5Wov!M=1nEqY+q1Fg|EM
zAeoKmLle9p0O_b=sq+730jjd&)a@gHmrH;SKm`yI1;UjrnI(1yDj2u46_{mwS8!rr
z1hf<ZPM*D(A<RV4(v~@2S+_IsYi$-hbNGK#>S9YPEvWvYWJ^3~M89Wnhl>s9A1C&K
zLj#x>uxlLQUXeZU?1dps2%`@jE<=3s_>qx=J_h^`IwN7*@JXwT4Qco{yu|!lUbD|V
z*wVMq-myz@_E6tROuS;Z&ct`Dff+kcsTwkb7W%i7;B8xQ47b|Qf-!3(^cnspTm{Y1
z9YWsnzbW5{h?aw1a!F@xVm)5)LZrhd0grDCsUIQv0FGD4cM0LOsPp!{%-k*Z-i7`8
z9tEiMeS(rMd6M;TV9D7&X58qG;tCk)T6Lg$jUjbMLm6OXlHSL<nIaB(59+&=-UPkP
zNK562eYuq;Ak*D?(osg=06P`GFuqGU$3L0ZV(g^_k2mll^7!HXmWVs=V{Syq3$RkP
zLaLOcxgRV=L$A624Pj|4wD?9qDB!WtnU<Nr9vLX%0GK^)#sJPo2S@1_oCbeQ12Pc5
zC-eGX3o?ckS_FiEO#sx3^dc4$MnndeKR9R0#agMQ#1VjO!0_h)8B#h(9!9gkrhx(0
zD_RZ6j&;!*U)-8Sq{SCXDvohAMS3ZVoGg5c%R$YVFmyF3xF1|u$}5n_(Bc9wRdM-L
zWUC)7IH?yE-!R#d6@#({IP)5imqxCDedclsv<!8Ft&h=xL(%_1U>%)wJ%>^E2Q*Nd
zS`_TD@o_0HSTrXIwrM~B$!PsN-U^-Sc^&2D(LC-{;uqZ=0}mb?k&biNiDrP{^6?|C
z#mWqmoaCzItF15@|GhBI4v2jyo6K8ctrT%gtLk!rQUo?KCU~~C(hN*XSesCulFu=n
zg|erSb?GI^#av9JRv<2gBTVy_&75^n#?eOkS+D~AII2eh%CqSvh_*+x*a!r;p+Z<7
z%HSQic!g8*Cc3#9!|Hmj-P+#0$IFu30(@PV{C1LmX~Cj)lFGF3@57dM+1NR;`VoT-
zBn@~t1PpSE*FdqyfXde0j_JALvMT3ghAC77Lf!EtJG|fC(@kk#-}NAean;R2DapR(
zj^Kxz#dI;S1OHOwB4rBOZ|Xk$%a%Jjebs*SsZ)7T^0JpFIu7Nn&bv|6x`y2~TC%gl
z+v)_38#mg#<0m&u+)@0e;(2cDw?C&wJKz;j1+yq^@-2Vjf5!B4eohyyxzl=bS4_wI
z&-35@Io&qB;LnYcLA;}H;h=ompN_ZkZ71W3+T`0tPk$yR%1UJZR22R^wdU5~tgyB<
z-2F0!HS^!XPqX~jgvT@=oZtF%{=30h+xx$N6?RM~+BtMNI+O-JhCamd7fr)%tABHq
zkCnvHb$WKm+`Xl+O<QKu<EQ(g%tlT%H`0b83wnD3hSwWst$nvXICk2msGeV#bnfV&
zl}jm>#U+eNt=AKi!J=UE2hH1ex5>$<D>$D^fl7!>q>JV;5s4@x<3wGX(|t2*CBqKr
zTJ{SPi}M$MW(Y>U_BS^=5rDtsUtS_lw<Xbx_*={VixM5X5Y;ZJ_#!DSP^oV`9bF1@
z7pz?uJlo_tdOaJxpeNXNDRs-G(39%-@4B?=@<X}0Kp?rj+6IhZZmH-_;6Os)w0R>`
zAO8R<p9Yph+$#*Qzkr=P213Ntloxez8ee$`Vu=XofC&TLmx7>=GH*v828QV<utd)K
ztU9XqOhC5{TMz(kuFHle`=lTH)S6%QH}Szu?vXmDiN7U@kg|pQepsU}nC9KYk9I5J
zAiw;$wqfqPmFBA7jM{@d?8mT%7OoCF+JYGM+rs-ZN~}idT!D9v&@?!KrF>}mNvxs)
zm=p-LAhb=R+f`<HMXOn*>Q^Fm0p%{kO+@%{0i+>Dq5{wz2>Lir2%*$Oz}W<ZT2hZK
z8BlOCaPz@zL&WDJ!2^XMJbNGK>3?z}_vb5JI;8uQf@$TpZbzI|%St<2hlTG80ejCu
z`N08jkPV=TK%^1O2%vyJ3ewty^aDe!Rs+?DAB!Y3zmtd~B61ZJO=g-JxGiCgQou}V
z0z6lk^L}`z)jm~*pamhx%AO;f&*Ar<sTeWT-JZKCk?Ec1qI2qpC0H^6A^t=1H}L}j
zhly-#2!QZpkfKBaHotU~a;207p)~7`mq4Uv{N|&8Xoviw0{MxL^L1W;Z3+;-1Kg*D
z%VvG){jXf7B7X0|y+^oGGBXH~QDwHb(=n+AosD&?^1}jvu^_O@W9RzqU+Ow7T=~XO
zWoPy;3|mG`s|_>~y%rqr|2EN_tgEk)@*i|JF`22NB)%UQIw+Wc)4XEa+Ar!-G3=~&
z2I@?|hO^YS)2|F*QsAOF>CY!n5m*ajC_5bvJ)qfdyM`9<N2nA_Brgs&IJA-or1W(0
z0GbY|2>iP%_(tLP4Ol;003${F40N#26~33(o&b-bff9w_AL9EqnZO$YvmlsE&MhxO
zrxF6BYhW!?<L_uBuKDsd*Q&kHvH9&;`{I{p-7Z4-qqOCZ8_n09w_K@TD|tQ;95iqD
zI(ep6*#*kBYCSr^U}y4O`NxsTg1~XcBl~q^W(@lx87>MI3q=Qkj|u@+4HbdV5#?$G
z_;G<DQ_`toDzkUadoRyep>59AlvvEiFfkN`#e_3EkQD?N(rt?;)zMRzrImMjDlmx&
z@YPU;%0uNddF$$<-;!ELV;EQ(Euv~P25f9(26KSqX0Gcn?j^`|`6Tj8+iI<q*txq2
zeJ6Z(1s)0=GCTt+ru3z4C+U)!<y+}a^XERH{l8mG{UJ%_*?=Qg86Qy&zgFpuuF7%J
z7$}7qI*u}!p@E_79><5J%nD>1r9Mm--fOC*C}Iub#{i-{6+xO%6wH1G(4tC{aWJ+j
z6;B}~Bmjg0s02dJg00;i3I#c9`JxW&S?Ad%I6M$oj*y4x0(Yvn1%kP8p!E+_23p)z
z>5{!%R>sD#s?I5FYT{9IT9DCUtw)Pt;m8aQB{d?CW~G;FJEDRoZZxBzuXTcd0qRSW
zm2XD!cy=|mxE=zJB6XM~vLHO3Wo+X@kcpz4qN+U9xU@kcT$+&)(ELv2YYJ`idyz`D
zIERTulVp^d#sV5K*&`is#hDB;JZ!i*5Gn{mTLq!Of?t+CFI39uRI%UmdoXqtT}p0s
z(!OtO8!&*DfW_1(1;hl=$+{5PCXItPQW!-C<x^|sz$uN0V(^tq!iQfx!G??zER$d{
z_<J2zXK@1j#7$tvHAu;VWCZ=xQhb9!t^~_1sRep_l#+hku|>z}v)1YDdsgZxw{QZK
zMD{HQ@#^!ri9)@T3pc-_`4Sd|nQl8L1D(KHY13lIu@CN=gT1KmhD^xlZ%SuR`-SGP
zGSOyXMi`kNrc&%t*M}u$jADtS@Sv~cB!z3loSLk`q^gwYCYTcnNI5817$SSm+8u*^
z$?vgcVR>yMBnoiVVA~jH`1?LmD}m6r&Js+GfcXheB5oMRRca--FhqQK29Y=u@<1gK
zth++XJ#zVw3Ab<{187_fBqcwca5>@w+ZmFRMV7yjvf(s%424+;yf!*39Y!0-POap$
zKGp-rw9sj1A5^oJ+X#ALQJ4YK2GS?N3F^bsf~%QYaEh?g;IqPS$hePwPLi(qr0^vs
zpfkmP$*H_Yx7B#j&o8VBI1-6fe-39HP12Ulk1{emB5tN*N<cs3u+*7UG9Pv^r5KDc
zjAaNrbz;SNVdf2Wa3_pjNYi05fYHi6%ZvfeU-5;A)emS=dM`}h0BBaE<iQ@8N)))s
zc_b!n5tBrr@_|ShhRZ@2cvS9V;C&e^|D3=@3o;*gQ;4d>aIX{%;3sxFLNE(&a2q(#
z;xyn8S}+!_zsyvMptgt6_yzTC!L}~8`HICavl6EN$%?OqsdjtN*HUOtcsm_<bA3JL
zaA*Jr5Ini|s&9AzYKyfBmzfdcIRg-V{SEjoli6n$@xv0$L5swIu-4;E8QSZ3CRU>W
zx?Z`PlH`aco!PYwP=Zc|7x)uSWzi(qR1szyTIg6uSN6j_y<mjFF;ES?{|X%Y3cM;q
z*+U!_*tOxlRWCvrD05E(o~^GB1Jw$iSUQ#R!*I7d60m9^*%ZORvFqSECz-)&#b*~j
zo|m9@J7?7=iF?SK1vb4>Fsh<CLmrL1fJckPD2Q0_x~b5<y^c-{`B1%D;m{6o-o$}-
zcb>zhu}mZmn|k(BYMzN_J&2#qzaU@8#g|ZkNPX=smF0yB@$93(>w}QktQ18bmey5_
zAd!Zu6|2NKK=sQh#rclhMB9S5I}l2VHGLW4M^}F`hU~ESf+Y_gXW+6(B8!L@(KLwE
z^Y}+qsEI<&u>I{seyeECboD#e#HDO<3egG<hI>7O<N?Ok{9ALbx;<RnwRa(p-NH@8
zTDXB)ys=3vtv2O&;dX_cKkO>p)Y0M}uV9H&boo>`|2@9s=Zmc?k+ZRoO<OH}upyx^
z%Vew`Kd>mgR`|&f(FGcHoI0*tDuD#|0;A|*i35XuwuQ68*4Je(T?+{a>oyw%F&YHR
zkPR+o@WBP}ocMShqyv>&kRl_Zona_ji^dNKj)smK!k!Lwbo4SR@E6iJ1%krJNUHBI
zKG1tv3~>6;Hfow2<hJ?)>C=%P#&k2JtYoCsBtgAik`Fvs1lhH}&cQ_cR-&f(^0p{#
z!K&_=erRcHjZT0c%DuoD4|`PX#bNqISu_i*hIT-@AGQ-;ot&0R*z4f(@X|#i`K4Bs
zoK0+NBsTvC`}5G45afHU%ff`0;Rq1kpdykS+`%l6(PImeEIz45hYXZH__JfWI1dSZ
z4q53lP#C7eQHnbR`c>M%B7p6(6a_Xo`ERz($GLl-`Fs8DCl8?v<zgjUpFTDw;jnq3
zoPv!a5APVJl8<*IQb0)7&Y$E@8E$y+`j&Dvs&5<-o!OjTIOmSw`Va>cbigb|knO&7
ztXHZ9yYY5|rCXCDENw#zhJ*ZNpOictt8sMlRq@5Z(hX(}tnf5h3?#{4!TbQU5Eh=V
z<dpC4q}XZjNx%&bqv#{B)x(u4`Eg(e5a;<Z>K>K~;Cz33&(6QY64GIuGDt~pf_nps
zW=|>W_Sd_u?O_mI2nJb<9!EGB;Xs8V4w46B4v`*0yUd0og$ZIhW3Yk*{xtk8;#orl
z=5AV3E0_*a>RcxVmAfvNQLyLaB=7Y4;MhVhOO;(VKStOs>=-Bg!+VMD)oFLd(V;1B
z55+;K0RdyTCZ#$K)45__3?n3kpBwtoJIL+t#{}Vj`s42y{RXR#q|2#a`&gA;jGl5h
zzY5Gx<@~<W+5NuoqUn<H;wdNrlf|##9(iybA+3%4SiWCLC`Z%|S1j>kfTbWJP8$Fx
zJpPe%77(c+Ev2L}|4y<1!mik_x0@3kaV|bk)GbN}DlM<i%wb<ai*qS2U`BL7Y5-=C
z2!v8(-1HO}<hlW&Tn&^r_*ai;6ab+(=mlFTwxRciN?8Orh$?bA7m*?~`6oVj*M$Oo
zSFJ?UUblw}MJ^<I_Clv6*VUak18BLMV~dIE-rLK!B=Ze{?7uyeX5gVyrR{s*CXv_m
z#@$;nk|;5|sj~CX0wV9d*yjBE>f9`<6HwKmwo8EB^^)05)i`K-+=pQ)usPwuPuHEu
z?q#7U_#TGkfE^(Vj5QgeIV{|E6Xp2FhC;^v$bNhQ{L%`=bHCER<A$Ojc?0@CA~69z
zz9mINco}Y7<OnQpM-IM<#BLmfWeNKOEPV*a7?9HAF$$<DEfE@S^a>uH2ttLj*#IMl
zlby-pAm|jI+5iGPsKtdQX)dXA(yH2U|E-|_6Ps3?@;Nz+o;px;^>jB;w$8_l*Tpvv
zMuI#vzP=$|{B^9eQz|D1#vn^X9?2quEd|7G7pwo`#hFm<aD;g&ikN6&Fli>RKY+|~
zKAZ({jwlD%_XAuFJ1V6v%x@6#h*(l1{%F^a1|Za5p<Jy1gdW2TztRqlpoqpV1~`;1
zhsPpk4vLFDkvJzt3+!_+UJ(9*t*AMI*yunJbrDsV4R<#7=$2DxD;#B;P)X^dLJ=9N
zbBPc-1%e>i9nT9Ah3d?^fTYxXzwtc%MvUY$lvYqMj}1dow0{;a==U*H?#fyjfi*NV
zcVbb`>mvGjZ_gTbCk0{aBMtpxH^$2yHV2DQO%`VdZwWCmlmmGZUdL~RU=siOdwOeu
z(DASZ2eF+^3-C;L1VsRo1iLPNQi9@>Nk!2M^FabzX#$}`{QyiHLYc?+R2`*IDe#EG
zGmCOyAqRxQI))i7g&0tH8RW28u(d(4^a{r}xH%K%5|U-mAVBgqhaV;y%>&8H6%NaW
z%nS<z2`9?;>_q%anGqo1fhR$k1UVxr@nRrv%yq-n=gipUp3Q|hq|)i#2k9$1J26Z^
zlL%}bMqR8gY0LvgM8X=I1VcZ%#v7Aa%h&&=YPT*!!r#cKk7A@wtSW4R2XP`Y3i8xG
z<~}&_)#2VBf;JU?Bo0(S1@uEMA;1r`&qzUD<Tf`Q5H7$9grX#<R9x{5Jui3=B;g>=
zF@uc`l)G7c*H)1Ex-iJFbwjv|@M8xzr&gL3#*+F#9AJjR{lomh*2Qjs5`YOr>@enV
zhTzdR867IEbb`WNsmcWz_bAVI17qSNKQ%VR6;FjBsE`H0Uy}<QE6Low?HCLNr4G*0
z9k6P7pZEgDRmoE-yRr`Uj1vi-Q&>__-HkE~)9N1?$*+sd-$wIYF;hRQK$2ja(hs{(
zOYs1n>IkSQQcsdfv8>_yoFwT?(mu*Jw5%7hXTM@*m@gd+akZGVw@~^F^XIgJ&}A`4
zG=VZ4o5BRR|MDVN$Y@!p7YNl6*s1*afs07>gJkCV$Vv@93=v2_*f0D_!C@FYkl}eM
zon#`Q0}8D?gwQz52r6^UMz9uURSw*5f+vU?XsLd3i+92yV{TD=$wImYDC-=?!`CJX
zO<F7eJ*VOw&2lk+=U5tdRFFHBug%L>ePSZGD$a`ptu!bH0!>~qNrFKXhW#Hl5~l@q
z)iEaRvhNAVl5KU_nV^hGM<t%50M7;{Ef(OaL0lw5S>`&}I}!qC6EjYurD!icIru$5
z#RIV$KvB*c!9ka3nRTs_`>mKTN(viQQ`(bCC?CLm!aKu#0HR?8J5?c71n&w#M*Y#?
zbhHnN<<phm4PfS#V8sN04Jx&u9HBBdHjxW9OBR7PJNG#eD$S{mY0)mB%piZ0H~o_Q
z`(9G4=2Mq<038EPPuxOCR#(t`7upmFayQlGYrizvo>`p6VhE1rYs21esj-6}CXm?8
zST-kY119J<-s*A1-l=J{NvhcsxM}aDlTwp=lI*2VOLlP|bsVtj<tmYUx-r>^KR;``
zQ}S0=EM2Corz6Ti(FPS}hzL(|bD*9N8`jhSR}0hyU@l8$MrcL5ilX13PdGc!)_O>u
zV4>%<!daINV!#%(7}gVRHj8X89S5~_I}&;uz8T>ow79=_4-pLP6wd)xO`Jem0wKo%
zM3MrCk0xXa*U4|j$FtHRaE@vc%QFlNWebR_8zdNy1lx)ZnFVEk^pg0#skmf8uK~2S
zrcq&wd1gYw&*1SG2GQj)A#_*xWtL@C>iE77v<0Id_gRXE*4|dtNQl`^*1vk~;ajNP
zC|Bw?V)HH=G&#<h9Xozx!4*SZ`1LnU56-55cJIoy{p6E9OvCi#_aABkM33S$&k!DU
z4lBsgm0uWBo#ic571kUu4zLt&Mh4cVrl0;?9*Cl$aT@5mC68E@>H}bc4d_~3Xo(RZ
zIH<Ri21wD-yCaZQlrrPMBH3gIjKj4oJds3TM|=f|1E|hvB*gAA(m;ljhS6ij@ri{S
z2A~?g6}DQ2E&@p!m`i`i4WuIVUxW6A;=vQ1kd-n+{|3RJ@DY9HBd)C!WxgK-9si7(
z!4P4f(7xQ=#X3sqsNm{pK`yY43>#o|$uxg&(#0T!%$^A76v5HH$7xCPD-+*TA920h
z2F*o1wg5lD<xTmO^7r(>2Ij|k0d4_Mg@biLioTY#TmJSs!S&vj$7sCby+I;&TDJp?
zDe@Dki3ev-#3vTawwf?}fJHosRo&T)&Fe8z(7VzTK1*%$k*V%f2ct_XvsyK7RSmfd
z-(Ko*sqHaiyP`d3Hgw+_s2koK&Z*JCm0K{YV1=Lz@sv1?ZN}AS?uFst!10gUtW(K+
z*hG-MQ0;;Mf=LR%t7HLGT?#LZ4F1A{U|Fy%3>5jw5Le?90&fX65Wk|iXW_7claxk4
zzm9?;ZO2v@+FnmJc;`}fDhyraat1`20A4{T5o*8bQ883)aA)mS3Y9D_g^Z@)8Zl9r
zSeV0o;MHEKRn^>h;K9X1Skm&0W53`3X?r)ieTM$}Zrg*dL70}J9`dp&iaQ!zkmx5T
zuVVQXN}vgQyEZ?rJWLs(+fiZX0rEgu4-_T-D*Vv2>gi1=-YYet%**v8rbvACJocE>
zD}dC!)VM19w6pVSHRa>eOCCn+iM@9}oRBwNkZ<i{n07B{(afd9M&}gEvt6g0)O$`}
z+&D|_)KbmpSr1m61Y#)Ea*2>Wm-d*UrRk9Tjv-`iT)_**=y(O%69QHf{zk|ZQ(<X}
zoJ;^l$z(#($-o7(zqSQ{-#yBy>&o7pKP!>L!d>&hT_Q-2btp8@i2)}7IK>a4C1Z)g
z_>-jjpD-8=s|O7a?&o7f+T{<oZMV-^TwUKtX3MIFws?7l7Qcc|0R?NJy}MiaWi)qS
z$wmBg*>xwNP5^!y;Ec}ZMSn9@?B>SY+$JH&u@zhB-6l!SCuFkb)&*Tp9!yvh-$Jxh
zy}4TQ#AlNtC?ahEV1WYNBG=Ix+rYy`NEi<<SI;BkD5M34M#rN`b{3e!AjpEg`L&zt
zMv*`hU7dL2=soJMX$KStXB2--#y*$I$>;Scca>e7MPW#rAFemMrL|SOV;JjR4GSYM
z5G7nhDgzHc9z3N+-gCv6IC^Rzao#PV@UF!VI&F5)U{1csUU>BWxl_iUG7gmQrb~~|
z(=+AcyL3p~ch~u;Uojyle>i(%rP16o8m4i|g9M*%SAGk7t~AmPQIYM?jIf%y*28xx
z&+3%Rf^(`}yEU67L<G_1S$p_u7rHG=vpSWyx#~ypighJILA>4801yM6*ha=~9yJuv
z?73Juo6?uKqN_`G$+Q*kJ@Fqs@UzEDXN6Y=Rq6}fR=8);CBgj^LGEV3>UEIb)P?7f
zn$FIG)7_ZC3`>DbgvM`egcSDcPm2jCPTm_PCwFz}Wk=DJW$I6zQnXL9_&=q@?UXH9
zKmGLt+9e>6q1$1?t*YU-<IUe19^m2vuV7Wr3j4F!>fWa{$Wc+;gsVOxbH|;WoGUH<
zYwFvJ=gVdSPLlRQ|Nq|ZN%A&1xhDq<!=}Y8d=R`a!D%V;%y3(KUr%K%mbf<4pi1@A
z3$x6)wVL_4`JbEU(4|ehRol?OK3cF#M?QB>s{U0kXIWwOq|M7Q!SpNgU%EB+&HE|Z
zE;JKeTo$i-HLD?U@z+L7;ZKFSxoM);hMnHrkJKuKT00w?_=l6-l&K(@H5tl1KQK8h
z!^Q9C>?u0gowSmEWEcpNvcKA$N1M)JQ*)*S<@Q}O*{z1O{d@9vcYD@XomaQIJ+tgW
zb;qJa-#fAwK+f^(-8n;IoX(fV<-;kp3ztu$-%gr)UN3B!1~j|G1#N(r*Wp?d;SV#R
z%EI#3YcuAu3~Jd8%Br8Kt`}>0t1lU@@y>D1xcANJ+B)pCOt6a8R3b5`WUndZ%gwGT
zy+o6ES?{Q*lieN~hY3Fx&#nog6NPu3-#Wh))qc^*tS5S|-=bu6a#!w}7SgXIQBjW4
z{)M%|589KdVwG8$2hJbq`)}Lbiq+k&T=AaeD$&^rB|h7k$H_JkKkE|L6`r1b`PcWL
zpONwu15H11f}4L>YUjc&!@IEz(HrY?=6wl9dsm;@d3=xVXTjazj?3mwE4WKP++1F;
z=m=YUF2(otnmZ?^Nmp6u&I%thoYD&)8h&1LUQH?d*~z5Be4=5lm+W}zglS`j(3g5w
zvZgwJc4IK7c5!wB`a90XaQ|)<OWdivJ4t5u)+seRk%ZoUoj9bYn)2l1nX8Cs$R&ro
z@xUVNwEFI@di8s6R6S1$tn+u(>4~kE4R`T&>fmP4TQsDCq*VEznHR_#>2(KT(0k_B
zD=y&e)DY;%pV3wzw@F#MeX%Lw?f2fEL=Y(geR1pA!YXHZ1D9-L-Rks#Lh|%~WX8?s
z%i7>~|Ju;w<dqDZRN!XdYrNW&3nfG}(RJ11j=&?oB=A%G0zLEKXWgz!Nou<XDb&?s
zW~H3GhCo;AFEw(-hS^*4*WUOXhDnZ_+G#63-JxY?ke_=z>GXWDUwwh_(w_CdPpbKy
z?G?RlF{$%gaA;RU^7P9=OS@F3sroLpUdL0@ee0|^?aX$)Ei+}lIm>6r>xE~p*d^=H
zVP0FZW1KR-L{ee-HEFlM-;dQ@Df0-EeXv3$lNx%?=biNq-imEB%{8XXyr58hXERIZ
z%WBIrJL-0cDJpBHa&%`uv-u}=`e)0myG5p++qV)h7rn~ight+na|TwA>)W3s3GY9*
z8Y`pD++4&B@ofKcTVP^+cnmiqj;c<v(vNC~c8lkZr%Ly%UIN~ID^_O6-<Es5XVqAJ
z_hFD#{ET^CO_`<XKopFG_q#2>5b|Sj_x`-`TLI77H)2Y)l^%O5;0-$Ke>cMi5+pjF
zifhkF&MnlPD_>8@wM;nJzzH7j1X<8p`6>g~C5tpmTGhFWhJ-g1GP>yLKn$2%ZFcjz
zHP4TpKQ3_*tln7>{Ev{j%=JjhUn=Ue{*Gmvg2mY&d(sftrF1OF1!re7HK_^C?ls!~
zkJt~hi%X4O?S>*hSmV^>_hC{6J?4-H)!uhD_rJ|4!z#s|XR?X=nu%E6`qd8_H~#89
zZhj*AYW$#Y_u8~{4{b%W-nGubL)Yp^7AuUc$0LMF8FM4b%M7?FbJG_-aV+W5o2?&|
zX3%kXN1FaV(_LLM8)SoxGZ$=$|7xCJ%R;95==H3l=PgHX=LtvR3!X(?#xhhd{-DkF
zxpXmnZj`d!3`OU4iY`&$j@;*y5fFXFP-SR-Rrw#o7g_ZddmC|8#b4DLK9zAQM<U)`
zI%0cT`B?wLM;|yoYlRP@YKp7-uKro~>h#MsvD|Pg7mbZDaUEh$7pHBl*a)T)^y>+w
zVd)+X_1Sy;%~$R@pI8{|5_<Z1^)_x@(9y#t@?m@0GKBZqn{O2*G`M~6BF=g6y?b_(
z<2)g<cs#h5({BCq%gMzJ_uq(p=dWFKb#m36KQ}}#n=9J%HUx}@NVQ+rU0b;&?0I;H
z@ry-tns$RsPN~UY{u?Z+scMGoo9>iZYj$cSN4|$?(Av_;mA35>vb5fQZac&vwo1WG
z7j$?XI2}izyNW~1=k30le`4eWOqmn7>4L`USIsKVqH#>l{dC&@5%vDQdiD4(+Bj}b
z4NJr7{rjP;GzSqURpdaw9u<9Ht>P&@Z_Uc#sR`fi!f&2cwlU;~)K()NBfm&(F>4*G
zWZZ#6xnS*`B8X(0{bHL*e>-fOe4%Bld}eOAJ$j)~Uix+azC?$~D}^~)&LMvsKDxRl
z8=SB?DPd>%OR*b@r@M8*Yh3=-{o1=Ha|`=UG|I0tYMejq(zHvPzPy@sbhY)?nj@H0
z=S!6VuR7<t{+n?L=zadNp(L8!fq5SZ3YFr4S@g2@VdXAQsXIPP0beF!-69PWLq6=g
z_4eAAThV$7{-jPzA)<Ww$1!6>1HJP&KRjEDTd7^tL(_=-92d~u{(OF*c<VQh%TI~%
z+%+#^{gl1Z6}9~r9)8d{?P&3J{-zNhtEz*l)12Oncd8fr${E%RuzpPSq4MYRlln0S
zKK(g}1+7*;KwQx}NJ)9soRE9M?eRv$XGRXenly4D*4|0wTQh&vMb9hyRyYurdsvm7
zIwX=g=4m)ynFWvfM=M>dxh*6q{JLXa^QZTdM5#Gt@lV?sT^^r_$jY{fm^FqWG^x?i
z%73$~k^E`@*~E~Sarm5rfCI)Os<~25kqKQ(>8ny>9Mk@f-36}DH<T+@cTRd9`ukV^
zXug9fwchK44T47=9W=YSaM*9sDK4&=NDK+VQttm58uouqi(f69QDM6C*~9@%eD$Vv
zl!vxH9OBNwx8F~bO@DB)G3z}`>rB9r2Nw)AydBqH5R6B>qIRs><hlpUU0EMB=BQlh
zf2)Joo)auPDxMWRZBes({7mH?W6_J+Pj<J?*D9fxvnOmPde6+ouoHpYMx{el`%7)I
zmg}t{4jc|W95>6f>GgU&zvFs`s^(7n5t0>`xfnYwc4?|p;ilFsc_RRr5#j`VFksC`
zI4f96?zeEU#B`4edbM{%UOu7AV?LsPKq~g#f7N?`(wOoaU#IF@2FYO?m%cnM_HA#U
z`mp=tXueKOnvC9<<o+-nQ?x8!5|!`$XogDC$UxE-?wL0(Nx}!hAK%W`61Ln}KmUbl
zaq+b*@Kcr=o-W!qaqqwPdUyXsy%`r8N#abyWbzUFnERE@MIn=?X7{ALut}9JKXd!_
z(WbfWO--uaVzbi2ZDZ|=#V*DR%#(JXpG?|)A>vj;_vY_}m?Oy0&wQm{TR@N!tL%F)
zP;sjQAtdI1vO-7Lih;d`i`?*;ZlBtz%M2O$O^Cjc^?x&bv(Th8X5VkDd#_vwbC8mK
zz46cAZTf#txZ9i)Nx6=f=wp+@XR@Au{u>;<Gk$x)?T+D-A@oG!)3ZITw&?G&#@iJ_
zpTn7Vi!R5+?O!joBlurEtmqXt=-qer*OerfqoPPn+TL56-LGdff)>soIMcMLA>mf!
zoyLocXXx+N6n5#|%$Y4?s+Dzmo$*|H?UCI@I@!b>M~_M~=+SI7d-<^5p3XV?gpXq1
z2;ssF$~ube4ZDUlYix)1K}3jluRd8*c8y*av~W>8>9>z6Au1o9^Z%VWm`b38KYZ;>
zV<T<$XRTAYHbFO!IR~5idxYR^W#LO4ll{uN>_e~HGS&gbtbkcNE!kpIA=~o$^P24X
zOB1(tT>Vuv>#EeUQ-$W8UbN$xMbqN;vJw~Z(#m;d-ihcjg@SL@d08i-6c*gn{O`;B
z8^Z#4##MJMmiS>y+fO?F82sTUZ+<E=-xyY$`u*%AqXU<hdVftC%hC(Da_U3otc0^s
z>q0F*9+4Gk?()kfB;1ZwTGD&{`FAOsUUOA>&AoJQjJaV^h|{ViQLzGw6LfmU_hVSP
zjni5_NhHY~i)aR(sdc+QLGZe!6Y!nS;)1s3&giplAA;L7dS-vj(tB1H&3k6#{%O6b
za<Xqhcu<nI>Icr6y8z8wE94umb`e{xd}1@pURLgxluPUUo_z9bf1RgUdr7P4x}$h2
zSQh9(o62C;f@_Clm1L$XJMTA@sbAOkcwob98{~!^Z_Cj3=5MNRGjH370#{rUzWO0>
zk;)$Wh&|o3uqe}NbDrm2t&a<}5`6T(n7nwW^lirb2!Fd%2iBGc@iNC`CTd^$kDXH*
zE_o%UL}*O+9(bv4J#_T((it^7tEXY*Z`11?9KRo*AFd(a;9kzoP|d%1;KJcu8_p^I
zFYGd?3s*R$D!alj&YZ5j@9^esw;T_`#T4*Pb<2d962cKD)wS^!V-Q8D90^^Lwf}YE
zQl(ukZwT|xjhWh~d_L=z-MBF7%jGSLKd-pqS|J`hac&v&#FYqrd$~{No~?cO_L0r?
zct0suQKpIjogoZU)m4lOcZ$U3hwojqoEwm^u_(%2a3EoKM6RNiwSwvQo4y~XlX{(Z
zuAA$*u=>(mkMP4$&s49eT5b8fZI>@SSocn|aP6F$G_$)WX1{QAU*K(%@kK#U{#G|^
zk=`{A1#8ZFU(xMKdd6^6jm|+wre}1t_sH3$wKeo18S)j|#lkl$Q@Hh_l*BN_=!@&Z
z7B^ba^G~bqQVyz|y=Hgk(9p*uWrHz;A9MC5oZF&eF>-WW+o@0mr5uB+rRq$`1jAn_
z+^E7vpaatnolTk9@-kM-Lg>?Esx+(Ev#aV=cGeb`d+7V-QKtDyhp(T$=UJ{k&0#;^
zW*uStTHE@Q!Kqpc>a?n>>}v+5H_?U1u>zOwAM%cGwM?-3WBhNF^mjD3>KDrjXTVt3
z1+BUgds-cqnrzZQ$uRxy<vAN86waLmo`4%gKidGGnQ}L!u~?r^DHgkDe@yDC(~GvM
zGxt&W8_+My^)Z^IVBRsD+N!wV#cYB3YPMRjtflQw%VX7Tk`=3_As^Wvhrm@yoN`k&
zcfaDtzQT#0y}JFWXBJiRQ#+L(J4JZpJ{vCSnK%8QpRt$!F&DiBa{_1dFmC8w-L<fD
zU99~1vFEa~OH|~3CM|Wr#Gj6v+7zy-?b!bL=Cdb^g=gjnw+)(5u!O63w1XhA?shY6
zplDY11#eZ?-7XiNKu#UM@UcKFQPL$T&kWS_{dyt5@{j$gV8OHHnwcm19RJ4pY(<&+
zZnH#HWj#&nm^U(q^7<XR4Jubyo82~+(?4^odHcD%Ff#k%u1%GAPqcB6M0laC{BrF?
zb4PS^yXQ;2S(qqLHeS)%oti?qj?@feP1rWemdLPDb`M&CKrvgfLgr_NkE9LqAoU`Z
zg*2I^KKA(<$@A0OXkZD0uYRI_4U`fCqOY<J1KSxq;!2^oD}K0d(TQhsdDD}F3+T!l
z6l=d-j9!;eAbHlc`A5`tH=kTero4F3LA65YpC*uRetoW5hOYcNmri_=M*>>qw!lht
z6zX>z{U#(`Y&JkhyEllADazC>$pg<Rr~-`v`Fj+|J5V07r2=1rAEyHKZKythp%emi
z1a>_YfNKe#%^O76P$pWulobkean#>y5l@i2H<y56r@8)%pk7Bs-jwUf1CzaS5J~g%
z#p!Y_v^Bl7)$J)05h^1OBfj+;lIp_#9d~hrbU<Fk_t$kLR~f8lqzo}qQ$VgT0HhI|
z4in0SMu|5P=cn?PcjasOsA)bX`qocvs2=^ibXPVg^CVAG*7`44CnVB{cJpRUb{opA
zd`z5?k)(X|du)x<ETO@IaJ5rMYNB6%`)I!~R`$CYmx_#YeAfZ4l3vij;{)Pa$v`gx
zEIPv$<`ZGl_&D$co<Zp7R=kW#0^|<R9X{U54{#jdY7L?vt~o)UL$nphD)<+JHHrdS
zk3ttV#7JVgL1uU7Xly6;;&t?91Z}Rd1)3Jro<kWmF}heO)cy;+<Tig(As+KPQ3ppt
z(Jw;<rx4Xm&?l(m-|^R+!gDg(YAsy%ak_?z)w@+^0z<0Kf430lSA^D}G8#L}N{16&
zr|2W=BkUhQ^~C<BF?s(iQS^b20iTR_OV=L6L=I3%7mJ0C<Er6CG4lUSh!30@zav?+
zYu{a`8!Wv9O$B4ZuLEZj6q07n;EC72%`r^WeyTQ0oayAGb4pf@HblVzzUzptXw9|&
zKQBkP#dKCNAX#YXEq&7xDg`Wp0g{6%J_qW_P?zs|0vJBpG!bY9YeiR-M?!%4gEu}6
z@$oWY!S{1e>0#jZ4_1WrvKZ;`-71>XPWY1Fdt-@0=*A;%eGYo}A14PG7dU|nO3}(t
zmU%XU`@#YNUtp}dxrPv>PBRXyb2)ob{>9^Tu=Jz)7=@_lU{bq|fW1M_WlScHZlH9v
z{CFijKQ-DpGCnC-zGriymtEh>!;<+HdR3dAPWT91iOTC5ehFPVtR@1Pkv+={8yytv
z8|fCy-?iG!xs++3RpXyhf7@t=>g%;9i6W~H`kp)|21^CF2q$|u%tL0<#qdP14gud0
zs_lR?Xai7N81tSI5<$hgs)COq__Y;RkaWmQ68H@R{!*zDgT6vrJ8k_cLzxlF2N9eD
zh2S&>SX09q9gMm#=q(B&w99-j!9xz41lzjv?3$P~prYa{%gG^kQs3+LRqqR>mxgSv
zL8r?rDC+MHF9@Il400J5130DxP?5vRxm6pMJjK<6YNLjI2Ftvyn#J%I1I2FhDdd|E
zU=sK=Lift-WwC(8bbr}+|B26@pi2%E-NlN_-<#=suroy;OY7T;>u*a<ZmxAIxpVJA
z0zqK9uPgm_5B*gq><M!oma>4y;ZG&$`UjAD`6RH`!`&Kzw^o|YCqHtCLAzCes)TYu
zITr&cZjDYW!1n-c4lpmYSTG3sWWauL(UCikxRRkcuPSAqbKKF!`qJ+bk`9})<byAm
zQ?3R~G!)(h?!Hhj;wx2KF#C-#{)=zQ_H}8%2}m3S%F{A1HxKzs*Zbv*iT8dqq3wk&
ztbm0&cYujJur;ue4<<+B)MRz9hDa9OKr77&{?yP?bZ`je&O@M{D<&{QQQ(9Deu1_;
zhvD>wJrKk*&~6ne_>y}WN9y4s7@(FiLm9dffIDH%0MsV=9Or`vDd3*4Nsw?ngwY8+
zUUxE!!>&MR8VGU{%s!z5F1uz8*oaO6d75=+eR1*m9mf)E{SgxMdktM7zHc>{;#1In
z(lKp6C}J*@7OX|fH>brd2Amk^L9p{lH49Mm+d!cqfcc)l<jB_+=ysa{iAXsV`s?C0
z>-g3<Er-Q{{Ta-%!InFW+{znZhF0R-^l@99BVY+W<X{v{sh)|%;xIl!Ze6tP>g!*8
z>Wc_Kbzv_vW8ybOs$34-2@ZlY<t;dQt{{@5l(MzbfgPQ|z^nYjj;Y!kwmeekZmM(B
z9U&%J3ET4t-WMNmF@3;i{6M7APO1ZrLVGA607*DIMr!-H1L+LNuc?V4ru6j=+y_V<
ztm_Z}<9Y@vKwqQ8>zA4V`eFf}Y~-BoGigjyw#!ckJ3y3O4*(0^BNo{06r}-J2zc|`
zmggNDe?FxFnc{;e0pKa}LvEru%pzJg0Bl5PR|+&TP;mv|aB~ch!_2{0P<@~<2Kp}J
z-7sNP!6+4M@NGlEZ%{A*9`106eaOB1!EBNHKA=h{cXyXLd3j-5qb4POTU!Wsx|`Pn
ziGbWf&`puz#Q29pOK{U!#K2_c8qMEvK`IZIu%{}X{Zi&NG$Q^>yJuv)$^nb4!4!D3
zheU=v7;xMt9gbXRX50rR=%6>ERQLgel+Ye}aL3pS5)3-IsU1P0aGV_!aqLt;n$mzG
zR^jJm$s46C3myao4B9%a^kMGoN?;J!ErN%B9*CV<3f*}&%Hi=Ot%uYyt5fd11BGjx
z?*R9m8CEcyuTW;N8GO<ik5)0`%u(hxv3dwGIM6~)-Ux&e@_|>UZ@7oc@sfaB5(W@k
zD^e3}@jZ*qqysSk1)f|Z^6|E7LnFvxzrK3N1t(K8*t96h2o>07;4m2rj^$`WJ<L3M
zFh}gdVL}(-B$x;Wl0iL^2^#>1t>F)}KoBsDAr#=fSA^m~BN~XaM^NTo_>`97p8%i6
zk>SQ&VWU7Oi{OYY5MRyoBqh2iv=j+OM#A%`0k}kg!;eC1af9DCf}GxgVkPBhR&%`5
z)#*MvO^?X9Tr}B(Z+X)UC*+|G#3|QrSUWW>GMc1x?aS9m+86Futb){I#^93>|Afc!
z*VbcpT0Gnton2##=)y+Oy$RTx9Avl@?OaCk2jU7yL{Uiq37CZN64=7gN_9TI9y{?f
z4;|p@<M=9cR%LA6gVv4K137kksYDy*dW;9{m_e<okFXd(c;3VcG=|Q<>fiv6LUUZ8
z^B@4>jZ-NVBw#{@qK`_<N*&YotxBw=rEVEK?s}j|a1Gd}tU^l~xcQSiZIK`?@!1t4
z(9O8|;Jj>XDj*`J6#+0DAp=XMoMoqb&_z-K4yt3YByw;i0LpN=L}}s&*~wfhtp#Sw
zSmhB6TE5buadb-c-blZ@%_=}Q<Gb?su_C}#LpcN>afcx*NsTKl35zYEzcMUth#TC1
zn}dLW15SCE88W+0ux&xq(IgTk3GpT%qA8%NqrDHgUBE2{02JCghoT>mEr!+4J0<0N
z{TP7x7b8`A0Zm4tS;FI@4#SQ$ZQ8}aB~;DI)`hE=<b22l>*7|xumP@K=6BCYwMVI+
zXA6`lYEl4QG&J>V0G&My8zGD|1i!Wghncvx&>uKlO>n(|960VXHovs{L06&-CR+Z6
z{(WlIox5`#UIt{1ff3}th7gIRu$1|KcV?7(7KM$@b(Gy62J--PM7kw1763v{J41v|
zZN(`$RMBUAaTes7G=;)`1Eg(WC<1E(1pM+qR*k|ii5ES9_+m9bveienRhG9hM_#gn
zk$-*VUhacyMQ1U!u7A8hcJ<VaN0%o%cg)BQ`8JqrrTFUWoz7)Ex_<o?u6R@F07Kx2
zvWFOz0e=1_K<nd^Y^n1)s7d}kT=CM{sVK6*+Ht+9`=1wZ?itv1_t%`1{iKtlx1=tT
zPwHbvyjr~xm(;p3;5qU$kIt^WDnBQ?m+(WX&TUnqd^4gK%sX9KZ-4Y$+5B6%<(HXJ
z%#bZj%Z=8`<!)}$MJ9pQQ`%Y&I}#XdvmqSA^(ACj?jSVA+Yhi7!=u|o7H8{GL@Ttm
z-11l!$CZ@AsEq&!9}0<q1>Rr+X>1JG+(<^9cxtBdJ8^C#_2|gH7+qq~>rXG}zgkH(
z&|sXf7_6_uXgOeC3i0va4z=4?@s{q4ThV1cLdjM4EuX%fwf_GI`}24xzyFUPA6wQK
zTlRemWtV-IB_c6IcCwZwi82h5EnCUHOr=s|&7N)SQbY++ma&Hzgu$5Wd%WJC@AvoT
zuWq^JhH=fg&hk9hc|7iq1q04Ub26i_)gIR>N+Dp4Jr(t?HRIIRLAW~*d4TExgOi%T
zR9A9aYu6u<)^DEr!oki!X!krm0UWQp(Cj%~O|IPrBh(2PV7bB1ml4*$$9g3JcA#b$
zK)esX0+b-98e<}ez`$MCJ(V7Zk{<S=apo}jbrNuuK*US)_;|3mfQl9IpWYv=o4|H0
z<WS+)oC)Spe{kgcb_uh*G!_IFCt#K>1k=LTI;6GGwz-L=K}FaEA>~p;boAGnP9s4Q
zTbI0>YSqyg6wB&|dF(+K0Hy#SBn#s3jSjsW+$sUIst?Osvm6LTcBf$}00jV6s8i*l
znlhLxPc4(7V3brXfJ_8TQxTA9fi>uK+Z89aR9X8m$I${T`T1oaa0O_@9Dox7;gI>P
zK8dvn%pcpFZ#eZ>SC-WC;-g|8)Iu^jkph)|<48F2bahYakonP}o;In}ntv)FJ?%lr
z5QPx%I;UnN@CR6<fL&$?VTC%?2fPP@)pl8ML+<!BVSw~_{voEq>W8z?<yl&ws=E%n
zt3_a{`JZJ1M}P7_+T~eU*X!7`0+qd3Xq_2QxE;g5bON-36D(z?>EB&dP=Cuo|9E|c
zzwD*cuok~EZlpEeBMLu^9CWIrTLaSAy;E-xM5%(fk><C~8jI{uzbq{b^rAHXT_M7q
zZ(s<_cc-5KhO`s%Dp0Hd2Lec~z?ADXSpBHtasW0K@JrJ$d*FK<v&Q*?V1u)v)8IBU
z7P?eI$)cjJ^An+<h61t}u=~T1fab~xl<lW67wisufc1{dst8I4l?rGVtI+X!1fr)U
zCmYk)yLVb~fMO6qNGrqiH3@$I8S1@Fe=1pjC(?NaR0;D;?^VI<0ak2~;Z5`c?;YGj
z5eDuuLNaE&m6EC#`O=v72Fn4IIs7m5o>1>;tcE(Ur1?AEvIAWf)SqKOkimgilLeRv
z+xpW>PpCR-hfY^FXG@ZBb2-?9`+?bs1$Uq`|J>>BSoqZr0LgTkJ%)hV9GhqhHWTev
z{Q}lq+JSs(-2s?Y+GW64mjM^@+(PD~GH5HCgl+n5U^i>Of+^RCmh&rXTY1-iehb<Q
zB-jw%hRhc{iWamdJlaQEJA!x64EAx1bCf6x-~aRIIPHy~@WtRcfF;5Kc*;(*cZjEo
ztO`3Cum%DW_pV=){V+?|0R&DiR;>)t?W~|^PX_+C6tH~+GAXcu0A?sYFh#h4vb!FL
zO%k_x?Px>XF)K?Ih!CI*2CsrElxul~g7&sgkq?MUkUj$Dsl!GG9pp433>1vxb%1FK
z4l~mflPiD)Xj`u1e9xK{o#b<49j-j^w#QBfhYOhKn%CYDN_D{S2QNwE5*_o14<bbw
z9s1RJ_g-TApV4^~jb1e?Hx^8B0h)T?AP@qhufnz)11tFtn$EOUx$y~d!PDM`KuHG#
zR2BY7Yxxs6skM4^8gM%Lv%LyR{R?(tU{-Yi;z>+BFmk<9j4rej6kAX^4F67#;+N05
zes>)BdH`!-Ed1#n=pP6>R?6U`KnBK=@M0i*WCsogU>|ROY4OT3**oSDnge|u__#%Q
zhtR@H+LF0e;=QN!J@8<Jg8ZHyKivi&aX?BT3Ek2b%|JF|D*sEA5t+fX2b2Mc>{UMt
z5Lz>4m&lApoel^v%e#bvX<UNuR7eX3kRF0o_4_}_5<GYYZnkCsgRcNGq00+l&n=l9
zPQA8zgER+X!%GQ0a*3{O0Ng#~pFA*chf}XW1jPvf&i9mM$_ntKE6{e|KNp!=)GH4(
zzZG^M&!7jFa)s?0S?P%jJs>uM3IgE=o(*hgfw>gahe$97ckve0@9ZI1+d(~C=F&W|
zg_yfGuM-yv2HdIR1>8LhPQ`^dyK1R70Ylh*3E|c|e$a~L)@yX>Ay|{iY%pyjvCw0i
z)9r%niH;@9%Owfil~YwRX1&ZV67fJ-=d{cKK#S7~(k>KaDmzMm%56B=9j}-8)u~AT
z>r=YtMqfpYS>w5z$_q<>cwe;J@xLx`!<yVS7rt;rJlPj9YRU(_$i{dsxuyZ+BLOd{
zUro_v)wGti+ILOGS3nRC(BBOpFk6U2Wl%~0b?Vo(CQA@^)aFlzn~eb1OX3Kkc38s7
zzZPgL__B-gMjFxZC}mW2T1Z&&vH}5_ZMO^yelR@;T5ewl-k7rNvJX;#2lI74k108r
z^Y*T`5&SWrC!IbD*ND-jr#C(U#)Y?nM%BfX6>>uTko_U4$Bp7hu9DAbcnCOa{ebNf
zJd6P<csm9#n#-@d`<$TT4y8c(eh4BCngLS)X#PSmm3!q9(FM++Xx>GE>Vbps2{l`+
z9vfn?#Xis$@%5hwxl;$~$y^CQhI3HUd3u_gfvrVw7MN5gY*g&r1}V+10&@!u04fY(
zCr)ldJ7a!*7;IOlL*;8w&T8{$#;KRADp2ARYd!<nUn7w9HTe0KmNqu7bjx0#G-r|%
z;vU9=*%-PTm`~pOpEsXe*b%W3HH_<?xc^S$i&~}M;*81#MBP^AWXReIhFFzm{DrU6
zW~)ZM{qAOggVTB=vEkhuui9mIw?VtdPf-GQf3bZFGnzzU{%Xz4;Fk46zC<M@6(6*=
zY?}s{Dft(YQc@GI1U<L!f-Gec-qu;(5xYIQaWPw}ucd7}$*9*OU2{TS`Zk|Z^N-fM
zTv6wUH>Xtk<9681)(ecr8>1JZZoYf{_ex~z!m{4w8eZrUU!GKV@SS3$ua0M7TJ3Pd
zu+Zl$#l`o^QImeHcZkN1MP-z=7@B?!etEq*0z<#4Xt)__vis$0g!db>*JhO|4{d+X
zKFDS&!A^X=qF<Dp@j*rB4iY~5XZAActj7>!IT>2>g^XoEJmq(O#<}YM8i;3gT=wF>
zFy8yWG`!}xi(|6wkNcOdJ`BS}4O|~>cCK5u{b2M*MkFV=xA&h>O-z<_YqDT`#LF7S
zb25KqL-r5H36&X+-u)Jl{8Q5J2lP$2#O(z<l_kAGYa{H(V%?K{uH8w!s7!0^Hz0BL
z=jg=@i|HDwu$c*j))|JMRAgwL0jG->IV$e8ze88X+|o@nn@5^cCeQs%rn5_+JAb17
zEuc>#Pclg|;9lcv8T+=;f!SC(7gpbEtP_tb!bj6SymOPj*6vVVt2gPUwOGjH_2;UM
ziE@Rk;}4wYuC;c7)WOPm{>Sfbi&P<T<~bUV6J6QfrF6?Vaf3r!X?CUu0c&%B=wNu-
z5@EM;y4D}Q-`r0}nDy$JytsD$#p3O)a<L`$E{$^6TDso{+vwY^vrz&5VGnj6-_uQA
z+zA|PX%rFX&gl+b`&&0%^E)Y^v1F?J_Zyd_=FHsJ#eu};Yo_pf$uFdB@5R#%6q?Jb
zu<cHtJ36ApiYSG*HvLL}E+;IdwxyXkppaXC&^dU{9DW6-xW-UUBS-oBNu>Dn#cNz1
zO0hV&!;ND$)*E*Y#I1=}2E=s*2N-CLt|Uw9A7MmT9x3u`evF%3iTHfHrIPb$Ih>C%
zEg)g`kUvnOF!BJnnr9EG4bY_}ojVVhbaIM@zRm4wa#$Lh9MA2xYDWd6C72a`UB(|4
z)8H*Bx_LWC2N}b3qIoyHHA+hImLC**eA0aRRqcpRi;s5!UGzPKqV&zsvgRDw;Bv@r
z$j8GYgHE->BXw#OgExcW+SEEamU=^9SN_~18yZ<%UE%G{rH)%xS4;C&F;>i7W%RZ*
z$fbBQxC&E;E%VOZWAu3W?K@A$Y~7{JAQ;T&yIukLa}!UIXkjmA#>FTYhliJiq&wxt
zQ{D%hv|Z_fuu#QsMn3=eK2gy{bUjuL&cSzmJ^2;`JLbM}<%)C4eQCDo*-ltYCJf%6
zbwQJi=E3#ujubbR|NEfNZCEE!<_2Oc4XZhGE4*J^9b(*y7Au+$Pn-IxJU61A7+^bh
zA?SH@!d}jWi=H&Mnh*Ppj52ovmg|DK6$M{d1(^n0IuBHpu2r!T<P}Tu)1xkPQaNE6
z;3Q=AVR|m_HFOhWGP6f+22nbiQVTV90O84|ygpeuE_2bO;1vJ5lG9xOWyACV7EK-9
z5&z{KKP*l&$piMkEA)61Eua`4|8cY*_2;r-;`x+5x6+gcEv<54G4agLr=nnFcf9rc
zm)l#SvnS-9yA8X(F!_Y1lwUHVdVB4Yj9|DXO&{|G#`z?*=we~Kswbtq%5~k+2p7^h
z-94UOJ-0cb?WqsT2dk`$^AuSzeL5%PKSz=meF$8XldkXHoL4+v*@kt1YW4R=D@IsQ
zB<)iR(PNrevO<>SGuPkI3RrgFD@@%kPH5>Je)N&?Lj9?FfxkqxLYX8tYM;N`=h*+r
z^dd=A_fvc61^zE}-r=7t>q>J)0&Aa=qUU>?IvM8nhnP#L_7<{H?=c3iXl7mSFtZ3p
zoS|l(H%!6LzEDp|zec`<-2H61uLnK%C9cww{s@1tf76{*x?gEMd)29i{Na;+UFYhn
zy}2xJdKik-yfwS_E&N2P>%Mbj)X~!N*6{voJ-<6JFTfk5y5&_Ec#ul$XE+H?5S-Y;
z{$wplp?%EjKW-8beIjLJfcw)<(&?EuW8Ktsu8mCZ4X0+&jA0;m91&RUTzVSIe2DJT
zO;=Ddx<tO#x6VNJ!#XOyx^L6R{2oKp=%8la(={pXCwv5^%Fl|LTaKb|rH<Y*Ok>rr
ztf*f^A;P7jFXHLHo$)%OcJg?FymTS)Xp^ZcQZIcd8toXCa@RVME1GHS;Q9SI>X{O9
z#QEaCE2W!oev$k~1B%&hfmS-?$XGLVpH&1!+kIGnSuR%7f~4KRz`ZpC=@C9X`J6h3
zu6Rqm5+D+&gmy|5nMPCENrdJdwrYNiX0QxZ!`=-(o@y$(hGKYp@a?t*j#=PzIsE_k
zhmesT&64%+gHl9owr)xt^`Pb8`wu4@SGrSljz$PE85CaQH!txB_V=!u3xwmgx!x4(
z!Da&`3n+Swve}=#GcSHH<C}Tut)JiEF17isG-Kh<?_7pgS~*o_u)nvIMlZcB8hT%f
zY9oOONvkI*flF5|Gn_P>QWL`1FBk@iqKMQo9x9uM)g}i%6uuGns{ZycbTH@1hk_|!
zG@pJOf0QMW5$z^aLpL6?4S&}CDdqc*(2f4vCpVP)8lunNwKvV0JuZZOvGefx+k7v?
z6YV!S@TL;ezlofG(-3`hYvFu;#y9b+SUR6r?-l!@OYT?7BcSjHE`Mj*Dz^{oe)HGK
zUa)!f54|;d;BtX3LS%ea<@-#U{0+!CrMUnl264?Xr0#e;*@4+9^}PMj-{<h9!8^WQ
z<+rDiub19{yrrYctQ`5+<V)w1P~(|rC{cczG1Qtj>4Y)Hs577=ctIn>wuV|*(Tqu0
zUMyPr=3Dy-YR{4a%64}o8^R(0!c+LCq)Zk3rq;jvJpRb_H<^PCzjCCOsz2Q>Q#jKn
z$;c2pC{46o;nsKN>3)JSEZyZcE&pGG2A+XD{$mumHjWrAQKtC*VDJ~p|H?x{>!{{O
z^JmP;v+I~Lu3pd<VX^nuC0EJ0biN8tNHO)l_rbo>W1^+Qkc-%eJ%myHu_}^E_z@dM
zxL2~g`S;zo7;V>w5nlp>u1B0P8gGpRw@V?(U$1jN+)~4M_!v04YQp|`U3E-XDS*kR
zO8Y_+WD_##3_jIcpMxm`$sRA={O<jBoFw1a<tys|DNg+pS4oqpG5Nw2XOzvaFE94`
zX4Nw+@eC)7&w^ga^7y1!6DDZ=@CNVc$D2ts`uEE_>8}V-`{T>AT8jTJz|XKc3T(^z
zGb~rHlC5Ri)97e*CZp@p_qAM8q_KpUVwkg*l5CID4_Jz4?-;?!=UVU&-#<*CvB}N*
z@m~&e|E8^XD8{}tUr2A)qZEK?xV%pgSXz)3eE*!$(A|u#PR|H}Dc#Py#K;&w>fyOI
z1Z{Ce&fF$v?-{6{ViZDsYs1zZ7mVy1|GeE86F8dE-nv6#ZX2sT5Ww-0Y5OKw{pesQ
z`q6(-&)V0J6)?QYqTF&VZX=mU@*8oyIW#-%)<5-nL4`07`qE#Qkn+8IUc~I84{YFf
zp7#n<V(LX9@t<b%^ciO&1IwfC+$bE)H3<E4kHfu+@BKjwaXL!1UDRAH{X}&hpT^E#
zl6n$IeLP`~im;F*+vS(;6q$a({JG&Sb{BSKd?c)%_SIz-6+5^BO#fDa=+Kl*%_g(I
zSSShAXK0k|FyODdBg}H+0dv0n2h6YT=-cehdF-f|jeIw?nX@?E`yaP%g>=DTTb2#y
zUu+EAD4&sE|IO#@6P9qa#vtH7*c_NEl**Hbg%0khP`^Pn(7zch#u8@<>75<zWRCyl
zeo9}PzD>c@sFZ%#E`kpVpykhtV(k)N@6ajdYti2>5F|5lxr#)sSC?&}s>)&7p0+30
z`*v&#OYQ9f3Dou{8{%^X9hWu`C*$7Gp9SIF4vB)yv8t`K1lWa)iX^eXb_ShQ9n!Te
zEMc}EI^v2xy!Z%P>CzANPzI4bA7AXj9+S~1cmxazN9p*L8>9b`8?R4sYhNZT4BdJo
zet&C&XV+#1;^Psl@KF#}swO0U9~O)j-g-Sy(6P<@ruybZg4uqcHp~*L9s1=g&R2G|
zN^CwRywr8J1v!~d-b%sIK;=^{%Fw4JT1xs`ke#x{&B-HX^<xNoLSp?fiA8NhckL{T
zkSr5We?*{pme(GiH90bVyUb*Bk?Ve5+V0^^dt2u&pmNQP-?UCU|B#)0c(O@L`|;Ly
zrmoLH@_8FUS=@`>dK%chBDA4>v1VV}W@`jq;v%W!1PXnW;6U*wMS(I#Wj(CHxwZ6P
zaMdG{7?)o)lwC%)J83~$McsATlbR%*JSrl%(or5!k?ZACEEm#JD9&z7QkRWC+h$6A
zt}v4z0&`-y*&#>wT4AL<gM#<h3YkD;DFl)E)%?)wTO~IxpB>QUHY(GNVkVFN)J5;9
zno1l$APq)dotkYq`Mau<wH=wkxUOQ2{JyJ3RT%tW7SFt8_LWcRsp8+C=UeYrM{Z@T
zxUkTiO`yyr!4LKa@hWh>UzCDI!>)dRXzj`Vnx)k)cs&@;T%Fg~+`iN2nw877NVT)8
z*UfpXMN|7m^Ngvi$8@sncP;NbG_w651LJ*dmlj?C&f#PBo#sSi51HB=LU95=KV9Jg
zk?|h;O9<3+uYV``B`$TonF%-U$4$!B8J?+!%!uq;|FA}Py<Wt;TE+`n?ue`uQKjD(
zu0LxzD%YX-(3<eTb@~E|ku=_Mbc^IeF7R=uZae`$Xzfh%`M#zXrF~(4ru!t>o17{}
zxwCZ15_3+VvX7FuY9_z!?J7Mne{X-zt@&^O8o6^a7fz!CbGxN|37_85!4HW>*0x3;
z&{6Ck+NUR!&Z6e2526;x*+)$l4X4|Jg_k)c$t_lVG-?$8$!8Vi(U2AuvB&%PF5ylo
z)u%zU1tIEJw+O#h<J04OCDWpR&ohgY@m74d)^2CucQ;=6Hj*&0XLObnY10-%{5vzD
z>wlljs%}#8Dv9by!veMcWxR#c`LE{a+gm~Cn|*<p5D|ZulVb>b@Qc?w`F;21!II9s
zk1qZbGgDhbhv*hk+rN)qqQQc4htQHTX+HJjmvR5h(DchZo~_kM?V@(t5NWxiov1D1
zPaVD?IOl;Aq=mgt{B=h?ydZjf<7FEXT~iT$0BCgsW`Vi1DMNb4KP;P_rBkm6Yz1TU
zy~87Tj|wPm))GyI<E{VH_0RC_7rH@crcN_;!Z(3BPX4O2uF}6E2g&!_jZ#mh_`dT7
zY4vCPl|i~bd%u1mJ8vU-c9<mUd8Xv<z2788v{XdWiRaa|x!&WA4YYd{_T~r=fv0{|
zDxP6A^SO@a9FdIQ<%QzvdBR`M$Q_>Jn-qU?hKVMhvX8tM<>1tXZ;!WT6RkbtslVOz
zIj8>wzu(GPy3O1+yLeZae4(e2z<xBU{m=TX)mCli+C5{fc0VU9qRlgUxb9cW_)egx
zKuXiur-YHfzMQk-de-dN^RS;tGxhiyvR^*-*jD$a-AvF}0^391c%69atnEqgz;5V$
zecPKKqXMX{BbBAzhy(UD#kKoxPmgiXT0;-w&e66!Q^V|Z`!V13-Qjhftu0NRlt1!j
zFH8>fAX&?n7ILjRs;}4D1Z?gocodjx-M7SsS&#AVGsrbG2W<WHLYXq^Y%i#M@jRE0
z&S$Ef{7UL)lxoXhGTMIEF?dbuZ7gyzMTcHWYQxTPf9mdjh5c+j<L(c$kg00%%?|z7
zesLetXEzyh#i=om8ZbR6Lno0WC{+hVoQyod_H_GPzrC?f$SfXM$<(@OGW+f@s~Xx!
zj^O4wFxYl}lz`XO-8%$Fw`Yl#iWCJ}kR+EtecFRoZwSWbQm3G@vLDXpY;$fx8~@Ir
zjIzgetz|@`dpoP-xbd+#F-dJn3aHPIcc5)_ET);6C*)X@mV0wp_ebU#36p8mW>V>A
z1{SR;GLOr*e?ZMP(6j90<+D*xKp08X%d2-k{LJ6JLTHfi{DkHpmn^AGs02G~=%srf
z$rvf({j0`bh^S32^<0e)IvC>V6}3FKDM!mz(@9eJ`?{fZlMOX9XiR**z}u8Mw(di1
z=<go<3&p;n7M*lp+J5ZCu|!L_dRF?78(aAHD%}KcWI5IHNU70AM3m`+{-%zA5m^%u
zzBg|a#+FEH|JirzfCLMF+kf`k$>PvoMTjYJ()VnO*i7B104avQMPisV(3+Eydol#Q
zTZR4fR7I|wH&*=6#QI^VOHd&EeIGOdSw?SW$~{W(qka_Nl==c~+?d44RAjM7@<5&V
zlfIT7o%h~4FrI}16}0LEAX!%YSi@2^R<v_s@49vXe~J3p1DgeC{jl^x;#-~e7eqTR
zB&}Js)VHkm_FDh2hLSzaQq&zBWRcI~tVkf+dawF*A13c;Uf}d%If*}#CJGgAW%^5E
zYoB^KZKHqe(X%zV3EZgbB~(wGXWk_(5}`QCQj<VsuS7ixV_sh!)=%&tYk0sEDp{>v
ztf_et{PeNT>&>l8E4g8nKfLm0LbxB+AHQ%8&R9ha;Qs9|-noh#AKk~hm8kzkEoJeY
zr+GGu`u0aie5x6$mdCyQ;}SLrEoj4T{_-_Fp2VAW7`IEBVmGPUwR+SViF2_p7-xE{
zXOBOO%e%X`)E~FgGETZ>R$?#9d~F#%tk#~n14X?a8dzo3f`AfEcX-514DpMESJs{V
zecdF?XGBW=8u9p|flR$rB=Ut@WZ&Ei_7uix2jfcW9fpAtTIopj^!`1sS=3jE6LlZ^
z(^!(0eioW<Wld#-OlYF8#ZVa0lcK`XH1T+be*4Egt>XmT=P)0gsn;o8PbY$9-}SC}
z92V)2-J5B%hDg``VQpuBrB5DDCa8Tbn}z=B%ZgIrx5ouOrgx6Lbt<a3^b2A=X-t~j
z4{<JWVa*jfL$TFPVNTIJW;FU-E?&$~^oqd2A348@(sdU23YYA~lr!fo+*IC%r64`O
zTxXuP<ccX=Kt%?f*y9*({~O^MAF-PvWDgvX58OPNdeSO~C(GCkH9Gi}#M+0gpiI9{
zA0_5w0jrnxwnh#dtg)K1{hoH|i0K(19}1O`vm+!Xs>&o?&}28v#`A@b>F}aL(2a+}
z?%Iqeidh<ENbUQZQA}hu-)HBA1?Mon9+v(@??}-EsOqREn4Fg5(_LS<s!GnhAyYaJ
zH3hc*Nmv*mO;ArqNrDrx&CEvG)AiR*KgdYFLOtT2ujJ7sAo~;4ty(#l>gjuEK!qSM
z(!DaHH;q1bj)6~6EpY1M&SW5q2)xzYaN@6r0h4G#?7L^*Ug=y+g3rbFJy2?HKlKXg
z=VsFheTDU@ajy0!cPrJ9>+~FSBdM=8aO!T|#Xi#U=n5d$+TDdx^L!mcGUbY4Mgi;T
z5I_tmlL`_(hcYg;wjsc)j6A+%v8~x^DNnB{fA|oS6o*naU3Ni?1<S*g3-TT;ldnFT
zO{e-M7On0Y$Tn(s1SLMGCq9eVVIp`1xYO{B8i}h<DSSIJ`^m~r<mE8TrUu`OrJ%%*
zxD$(}<l%AD&VH5yUmDfdW{D3<U`dQOb8KYCZe1@j_;}k~a$vG_`>f;ZBN)c_7m@0E
zF~v)r4<zdghK9UU)@Eea{N5@K5vxWETU;UaZE{+CgIWWAdS#oLd9GQs8V}00{@B%L
z-y&bmqIxt_J+`HLddv_1P`fW8+Hb8urxzX5dCxSk$5D1{42%7qvwJv^lsJ_QL<BCX
zW6@PH9SEhydCJ5`vG3nRe_OE}CS^rD9Br;f#r@F8hDfMHICCER!9VILx^d~T2na9r
z!6W&7i9{W}7+a6=>2K};m(dtwH6)@rG5YUY|7IhptjEUW>C@<M!U_G%M#`lN#Bk85
z80lY`MS<LGS*edFWCmBVq{B98DBaoL^v{ype(1gNX_P$-OR;Qxv5Vt@hxdXUR+RzS
zQ`60Icl6(x?H5Ugh1I=kx7M?Vw}v-J5SLtiXd^kDdjWI8VA@UUJl<-W+?|oxy%wFE
z*2by_uE$Anu8O;kcY~p3avL1ba?T5jfHrUqI<0ZPEtnpThq&~m3ScLW07W)fierJs
z5mxN}`fhFI1Vm$65o8eRFz*>n{#5q+RV;(%m2!Q85KSmhR>qsclv})#A_MVNOE>yL
z2rj=k$0Bl19g7C-5*$Ezdc#VOf3pAIQ6>~i4f1pAoj}UK-^s~Ii&@A~j*HT%sY~}w
z&2#*hPrd0&?$7l;{TF5;(sN(p3i4UFPyv<d5=VnjuoPUmpHdK<oK_(M6M^vO^xw0x
zZqaC=tFOP+tC09MkPIkRei~{7Kr2XZvelqFnPPcEo}Il!a~bh)VjAHcuL*aqPqea-
zG`gGO67C)6b}^Rxl46K%_#{ps-so<v?B$oZM`Cb}xl)>&ehgnSp#|cKJ=2RfcJYQL
z6G_^|h~TeTAD-L>;(K6_{=YzxRuk`7`dS?pE@mnz2d}cOb!dn*#z62|E9==7O?0gu
zjtBC{9L&$tv!e>Mm2i=2D)3jM32UcX9w4bp8!so70iVr@YkZuq;YHW@o^^Pg$c_KS
zih{@z9m-3xY`@@@g1`zd5ls_u)V>GpeCJ_{-L);FYl3+NHgAF_RR9=yv@~|xy01%H
z6i#3X)<#lBtRBRL=#DH$uO{UoDlNIQ=Fdxx-F<~GI#Zi}CSe|YX%7KBYg?!8t^aI3
zj}?-L7Y-mnOUibNP=P~iB_~66b5C=*h~VIZm*q!2A%|4wTlK%h!m_~0Dqz$tjro8d
z{v6gbmwtQxT>p*)M5<;}o7FM?@8z^9hkV4k1;pzG62(F@GcjEOu;I;#2;iDHlxp5`
z$gq&<@m%Vpt#_f+rn&0mW(O@yAL@tSzd9Rn0`b{Assv}Z3}-IyOujJ8b77VI1atvc
z5s^cB1CBk1v!^!7|1&0mxLZUQIPJcf6!bRHE}4+$*FxLGypqrep>BBVpz+ocm$v3!
z>2Z#Sv}CLSKrcY{z5Fba3SQud{YmX9a*E#L@GUsHC0ZJfqrgRb&l@|QdY&jXJ_hp(
zr^gD^CNKjyVVMh{g<W|&WOu{s1HZ7d69Sp10K%u6fNW!}6;Q^8!)S>IUx*q%iA8%h
zNXOqor^nB|puLC^MRwO+1!W|Xfn{1oy668Fz7++&eEzivpzs1l?87nIZ2@rp4)hZv
zS39LmrX$C(%ylAEEa;MF<^S`4>x275sGTz(j}kvMqa{%1umfqurjp>p&z_5GWd#UC
zm$L16{dGkbj++Q@ERJw@vO5?v1##iFSU#&rz<36-0D#m5`k(9IgcO9sH<5AGj}{WH
z4pk)VbjLEQ4TYc|Tl{|)NHh)|XYbA|CFS3TVi^b~)x57l6UPKZE*RwnS;<g7VNUh>
zf4dI4=OO?AKdT3<SX)ewKXZ(tJ)sHBYK$cDbO)iZq%^U7$mOCP!65Mie|O1+LB4nG
ztQBp3ADcl;!Et4~4iFz8oNg|IBm|IqUU|oV@idPEWC1@?r8sw#zz>Z=L?P5$Wb^Q}
z|6IaeKafcRVK-1-*Y^U6N~L)H7+{%UI++HXOjH_UDG-SNbtjOxz4iZD*gl1_&8i^W
z<<{>e^(mkcF^_Z-$3?iT^a0D$c<KLadM6>ab*F=^okrW4|3I5u=Z3(%V;h3XhTNq>
z^<mn9QeZ_Ox5~tN1YWO*<WL1)Uj&$(iTQOWzorV?`mY;_k;vw{Z)(a2or|_WPxetA
z^fthnJs3j*ok31>6;Nn@!A#KlHJ2CWgY<9*49J5(DDpe3nZw<kY-u#%l*mTL^6IQS
zfm(69Sn{#(oK|@>rOvDWSuAn=FEtI&f8PE=!C!@Y{OQr6MI`lm!&BXr6L%M+(h2&4
zB#{gw8H4`~jY<iXF~2xfkZkTkNe&zmE&~<U?8sO~qalt*Y66KV(BZ>pRLcN10~l!_
z;{!-ciBlE3p}?8q55!2G`DKVQ*`$grdz;p2o8R>lUn=Y_+5t|k|IYFw*=f-FfPoCM
zxkE9h((f9;vU)&4=J->PYvFjt^eR)Ml*`431T$LuOltv7Z@707>(lzpbg%-_4a{qP
zc>3onYY@4H*p#ta$ljylBf2VxFME2os7vOv#M$yDG%ar19C9G)CUBs8?xVDMA4>3W
z`ZI6yA?yIB%D<b{uT}uWRv9O*T72O2T`e|fk0Ka2jK3zOr{an_W%}8!#BvPDMj`~d
za%oQ2b7x_N56tL)k$~J(eX4kZ9)j3yKznI51|+xqs)3rSv;~*Jx2<{qNx0x+_m3;U
zJFXfS14B?kNj3-c(6Tna)0}pI4W2;s+i`Q9WzvAUuJ@Vd#UY}Y`};Tv-MLZSvP-B3
zRYQgz%&Jk_s~x0`l~@XYXBtg|L82az#DGZ>hvo<p^f7wVNd@8xJ8x2o>Ipr%2!F4i
z%c|gkUO}{>a*uM4N`S`np9STSx6Y@Og-=`Pc2lf=@XlvxUVr9S$$fqH5R1b^QrtRb
zZJT}CPC~$89Z|_<n<);FPOokpgJTT)y0c^32+)%<LwSj^nHWOhG*DEAu<*;g3VM^N
zUeLS-ByEX*nUwtVB>{A)!ltxW)f#43mmd|bm}>_?0BpvWn`LY!?gdod+s|qn0gk8s
z@ZEFsJ|yy!!EyCSkzaG=9lOo?UU#CNv_s-&X`0=S0CW}Smp-qd4IBcCsO~cu%vW5p
zr#`{mjk|XJKcL7EKh1fPG|bbF7+hHjv=;^5thk)g#U4TmU{)L+<J8wqZ5P)bBYF_7
z<L3D>tlF=K<1}48cl19BIZlm%w<c&o%l%7c{k@ueXeJ0Q2k{e_H_Jm5qC`iJ*-KI<
zYh|o)4pbZ${loJ<O7cGYD(*1ud^(-r6JlOj-5}j2l)`t=C2Mn!Zm5cxLI6WIts{$g
zET?$=Kl~5#ybi-B5o_A6%h8KbSN*lQ!dnsNnlXvl^<Q`9$pOE!6^_@uZ3JL<H^TD9
z>=yo&#D7%_5fj0jf{FYZ|C2@E1*B<k6ZWiuu7iE*x@Q%@rplCcJwc$A0fW2wP}x4b
zxk}+O(d(73xLwiPob4$ftr?;)a5O3#L)r#<PTS<hjztO9kA;K}Zav9jR=CG*-k)t*
zXe@iF>;MCX=bVpikK6dhW42}N=v8d5<f1i5X?gil%ZeT(wnyGbQE^KeLopvXoJ`z6
zpEkPpIvE+5<;vOAF+H^SN-k^lt;!QnxokUB+|v=e=d9j5iMV&InCyI2MgXC^Eq#2)
zxv#O=x$m}KGsqqA3@x+yh%F*1fF%wTU2XoXL?H(NL&|(sp97|PfUE-WS1m-Sh-PSS
zC;|cc(pZ$=81ng8lzQ3P7aJf~x8qA?c=GN**$|-CUYu>{9Yfwb-cu6yp<i$FYpJ*e
zoJVQ+`K>EnW<L~u{Ofyw&(^%n%_YvB^2k86pa5|^=AYf1yE&O2+dyMMPX1V3hUS9B
zCAoPdN#rGW2Jr7{#L|q541dGZs)XM`avD783Ha#O+|kKAG(g9;_JJK>D*+(#3T9LN
zIRR6J0T49I7Dza-s7GKb9oDxH1OxjdR$6T*!#CaH?~#_zSX+$%zG^`=IJrfBnWTlt
zHB>(gU-bGYZZcpP(!cYR$N!EMOZX-Paxk!`;XHsFzK5{d*mq64Kw8hAKlT{n{_e7f
zS<e)e#xa_BKCZv+d0h8ueQC@;|8p5m9jKv}@V^J6)Ghn+^gm<}#k}VOGaV{r-@iY7
zr}<^I^9vszma&$TqK13WHc`3-VBI_NZO~(sNq?W7>;uqK$>X0fZ|BRdRgk0i@Nu2d
z>zOY~Uj0r^8Tnf6=AQ`k<L3(>dJkDg23x)EYw8zTZ?nheDC4F<I+&!Jv!dT~Upt0p
zSM0v5_uaV*;I|d#z0>i{pM=fPKuMg!fKJB^O%fJ|(~Kb51fCX0Z{~yG?L4QUF0U|+
z_EKenL3df&bbsIN?d<}`-y>q0P6A@`EcAx+wFplvkkLz5J*iB7y}LP;xY#b<yxZTi
zhp6gOi=&De>=G$aktQ6iVcL_xgbF~*c0(0F(6*haU+++`=;Xhx>{5_Ocb+_5A`|RK
z_fNFD{2^dY)lFfai%ab0@<}y|S6p-xc*)&!PlQ8l?|eEl$WKU|6d*GYEV`PwO}S%`
zh|ammP3Jc91qJbJg*uBF&@rq2sgZD&*sOPXSk*rnqo`3N`;luobfY7$Xvh+xwT)s`
z{7BN?<T1;$B(c=meVf410lDYc_93I$Q}6iORSb^aJA{sb!w&;l#CADVlz{zWxZCtN
z0vQ%JxEYaKw4Qm+PM}P{{)La_BIwl;a?wl19G{;IjA3aGUz~aH+^&8nMZx^l_9dsF
z2w{!-p#sv<bAZMz+ngy|>_20E_~Bcw(i0xyeZHC}lCp@;RnwueGG!oqs2)HVd+bUO
z^qHRM0uBd2^E4eZmmH4*CDpvfDII*{sAMhuNzV>2rt&5L@cIY!=h7tlU?4a1-?2i3
zCw)|Q$sV%<%Gj!2V1zjI!-52w^&a=IM4-|xLpVlWFHrnA@Ow_V$rhO@jpLWiJa-F-
z1Oe2yvfXdYjut<ZmD};Dc4<vcAqu{bsbz<-;@#PPIa$fPYmiSKw1-cSc!&R7E04?B
z^^}*BirnxK!^idcX{y`$d8iSNK*ENShZ&Bm;VoPpmt#+?rQuF91*-OE&4kvGTT*=a
zc}^29V#c%r{e4IF7o^@s+EINhA8|{MtG|Jq>K=G<x~u_g?t4ibpB<v|m0G>S(s(;?
ze1ho@VNdD4&HJjRr}UIe1+sTQl!Ayg%_>O*-@mB+&Zykzo$X~&wpZKqkz>H>_l$nb
z%MHcqWD2x<A$R@CXcyrERR?zS+5u(r7ZUQ%8Q;~rCuxdG!fU5~Bz4D2W^OiFG*_BD
z0Dd4loQ$TvFZY#p_*|dooj(n?3_jU@q`luY?+=Rp=BoZh#arHw<OUWf#F1k5ppy`Y
z2`cWxi~+;Km(d(uGMj(z>oDH}Dp~GvgMDXNuAcyVn#sqFKgsE7IaKh*(Wdu3xlnL^
z^WNH>?L+=y&2R7a{k0WpQ@No2$j_DPrAqHD{Y~A=A7-Pty372K*-D>p<$a#$8M7_2
z5LsBO_iVt_cZH7ooMk|#^~D<)j6JLxYE%*ko#=A-@%oB9u$utKo=_p|)<I}@fB47c
zs$--?g`E|3w?2)bVuO&+_0Olp<o`O;HgCd@QV`G+%zYZ&8J^nHV=8_T*=AF;4vdpK
zeq~^a1oP(cTG>Zz`{{!3B2eL*YOS-p$j}atl~pY3a=f(kFovUIoyhE4q_uvd$juUL
zX8N~do_eP+6m!;if0^^j)8Xp23n}{W>1%yPgS>a2MLe_gZNp-xpXw9%<f6%xhqofv
zrRSx}o^I!F;TUE_R0O!PW_^%ez%~Xju49w5UEw1G>p0pWJBMoZ`gxH&zJYAd!NSY7
z3>WrP)3ZM-)wN1s)|3=1L2Kx#KCA>edtYL*|7bh~_vfvAMt^^}_gx{9O~P_u^E!@h
z;<97LDWnp!IA+Tp##~8)aOPx5%lQJ-p!PZcNh$UTw6uHx_<z}Dhh_G09;Q#d!A|qU
zRqz5SN{_o_GguqA!PAD{gHS;I_+sXPF=UPYyW9j0eMb(@VJ@KGufKl29@S?1QQ1*C
z+GN@TwLN3@bNm1TOCcyaF;$6c)j1qDFqPp3-#3vl?H|W)DYX<6^eLThPVBJUdFw~%
z+*q|p(-vsButVp~Rm{TXteBx_j_z`phzWR-MHo!8xG<O$dJ{YM=-fUbd99KdudVnz
z5oM#Kh3KO4)-1~ei`r1lE#r6r5u>O8<;-W{S9l)F8<#3vMkl>!{%X!i_rY+0Lm&&`
zS7A8EI70MdPl-=Zdtp__*fL}6=g=O-nhDYJ%Ia{9^Csbw#FFHmcI~bdi%_At5aX?i
z7%Jx+uCxpn5cUVa#y(kgF3bhzY#aMQqF<;)NW|S8+dyw%3%dc=QMQvyJ#9I#AvtmN
zdCA$*d0BvMfQ$_67kB0a<w1W-X9m03Lya*XFUba>zyb^)q5?ldRZseObB7>LVRmT3
zJdT3y8t-mCLHqag9$74P^y7C5LYWz!2Evr&*Qh9;_>%SSfec|4cfsZ|{Dq3?D;Oac
zNbN^lk5`ndoGzYuj#5xSnlmyK|CIHb>YqR4zx9-Yuo7X^WRer{aPLBa-sie{k^|K`
z-JCFcji3V^Sta(}D;czcYL^i?1fJ+$kz}v=VL=X*cE!}CCN%Uyon$Zru~=9<3PPTL
z!PJ;b8;Ft5w;GXaf6}2Cz0^dMkEX854T5W%K?Ez^z#WsRJjEoq?+MKJ3l;)FG9QK5
zYuU=J??2*pYg&n-7_o)dgzLiCXh6m*;NSeQadotMsV<CKr1-@2O}+H7E-cOZ%=;Ar
z{tRsN8Z}u%v~r+PYK<sa7uvuLB2ZH@!Z18}q7E-qU`p#IUSg&^Bg~#kjIo=YF0e~q
z2@1cBC^c!GghXjj_KI}pEkLqynwy*9R`(Q{;$+HN3OZndRxr+Bh7A~{Q{nA&D(iN2
zX8^dbugV{bf}f7)Lvq=h6Z!xB@2rz|T=l%aeO?lpw$~waAxGJTHb{53^HHTwrViKB
zn2ZZeE-rm%^iUk}La&FPA;Hq2(UcK*ed)5)O=6%QjyLp0uIY9U`!b4oRml7Y(yIm3
z68kQ?{qc_5xE#mAi9VwgoX4Xx-plXDblA&Bxas(#7QSWbT=L;&#W8Sp3yusl7g092
zsHA))tl@erU-nqG?s63^M>&^msh=htf<O;H3{XW6BzC8B5(`239BS=)KIFfc)zzby
z+{5$gAg<|MTENmLODbd|34K)!bj*@<u%7<!*%uUd>)d>S)l9s4J(@!tPJ@VoaTBu|
z%&w6q;h#>&bUxS-ciYd2ymum;^OFIt#5fMKO5nB=Ogk}w!*J6$;pfJ)|6(W8T7{lM
za96y_e1FsM-#H@zxTp}d(7WAzL*BhFz2~2bMMB`nCd!>VP(&o<)lQOtN0&2=%?ty*
z{2J6lGxv4z)^B+7&s1D5?5^%Z6LmN7aE2%wd^BaMEPjrr=mLgJyF_{<>LUEj{5$UN
zMAa8s8~mfZz85dQ^uM(A@5zECNc>F`KB&2`;`8u^p#1lZ@F3RL)yglJ>{lj8MUmJu
z9IWwI>LPxgyE<B}M~j~;u7uYeMRX_%y3!2fuao_jG7IumID&BUzg3ky-4(6LBaEI9
zi4^*0$nfD?uXq((ZgqSp_z_;n7?(vheXoP`qi-LAeN-FSwu1yZE(u<vAuQkh7qt;i
z-aqg(X6ssr{6h4Xu9m`IRek=I{tl&#0X<1;_&DXz!Zf2>9|k?HJ<+J0DZ?kw^-$d)
zzr`k&m+OCDjXE=h;fXdJ@5QBd#_e<w$;V0d&{dk-Z|A+YPTA2*ct$T{3gG3}4Ma7K
zFf{@-yErC(t_S>FHrROFn+Yy{MzUSUnNH!W*&buQ3-QA=<{n<+C3)B9Le;9+D;5ku
zSJD<<Fc5l4z^05nH|#4@^18e{%r{95uQ+oPt@)n8{%A4HxN_&ua2K~nt&`m|b``)6
zM^<Ys51K`%Yg^pvw{5enmk4#d_Lwr=Y983gfb-6lh6)k-A0BEX)gG)BKILbbRnOxX
zN+-aR(oh6$P?=W7>DTw~#+AQNiIiMN%qv78`I)rcojpe;L0zsh5Iac<{9SnzP4zxd
zniD!8!lK@;l|=bR{Gf)I^ofQ@@#8yr3MGtd9tU$HI={FZM|4&hU<dRUFLK@Mp)?)g
zqz_aVi+eDk(;*}%Dz7c_wUzgbswz#8Af+nY?Yx%E<GXTDk-ahmGhk8)if<cA|5kP5
z4CPr^Hfx$PBk%pP=Yle;{JPQaSduj2IC`Athi=*R=`+mVHB^=V)LrRwdy_$SVF2A1
zT*Xzy>#n$beEy-a4vni-w<nz`6BRyFN8IR)IiWoOqbV0MzxG9z;a0vqA<0A9E!D(h
z9#?zs?#mX%EHty#e0e7>%W^NDfCjfrHMxawgsb>jdqr98iczViXVB!j%KDXVZmx4k
zA+@(g2?amq87%}W75ltQJjkkhHW>!r6<Vn&N^d`{y5O7b%`lli{0g(UKq0YI?&?YO
zN_rsVWRpRxf5zUWo;$xfFq}IdQf}FzLsGbYF%*H%Z26dK578_=6J6eTCEq(5qu%JP
zNfc7KGdVm#%lD)E;t<*dEJ97ugBD!vSN%0G+8_AYI>fz|y<5YQd@e!%*g7br!@~Tb
z*)t~)iRLT<?9vR@nah|l9pBJ5Qp4eVe&t40<kT^44%X{u=V<<l|A-*mIv93i7h5M;
zl&Oz%Ht7mFjGLqnIo;@In~DmAsb^9ws5VlNkyDaoG)WWW#Y*A)Q7~;4X$2N6BuEJ@
z2Jlz489uj}EP&>jSgF2qzM^=<uLF_Ec_?tgK5rY?M))rVI@eMvt<3en8S!in6!gwf
zJAQZJf0`krsm4eYI$dh@V2|81V(%g0-9fx}Qj?I*_i~esf+&722v$eS;z~U_6a;VZ
zTx+rs=aizjj^&AYTut|k7(jkI#hhlKik9qbI&X^dt!I>Od;w!S$#kEjr#7#mNfW6E
z-gOAaBwcY!-!gx3A%2i>Y;leChu_Eb*gF&QyIkn$5T~*5BEU2yW>h$f6c7y3Q>NY^
z-+F+7r>)*i>u{f&OG^!Nx7OuZE#a%z87~v0dr+pDQ1;3z6W*clg2F^5qD$(cJ=I&<
zl=lY`PQizqT#8CJItI`(9uyMu`@c0!lZU%hH*TqoOD$U|5pQX4tPoiuiz4FEHr+&8
ziqd^oeycYBmES^hF>MZ`x$=1n+w{-<T(;})G7i&zu-1@I%m?*Gxvy{&NWlW8$8(aO
z2d|gKQ1TLJcvx|l!9!BOvFVci*HSCH2W@k?AP$?sgWQsZJiOjqY-~8^;Ez90Ls4C%
z_cm`v{}#elgk!D**odCd>8lY{qUE<LcTpF$&(<Z9=v}@YcalAP@2(_m0T7;A!dY*=
zILs?CWWWVGBp6^jVVQ0C-%5P+NlZr_<U)s>D3U#{=wM3&MWC>ED->j&hj=&OiP@A-
zIdg_rmgDqH-^q#pqaNlS`~s&TLv<*dwlxcmvR6g>C4c$p7wFO#vHjF2Qh@N!6*h|0
z#q|Xf@L@6vcuJUJiO*R|7Vk~X+j+@z&jM47%y4x5eRsOZwG}xF-3d+GJ_gO+;lqr=
zkqnK>tho|$UqWy?qS;=cy_5|tkV4O*5dJPHoo(-5YQ~CXo1FW?x~!-zu9A=YW-rlq
z=IVC%&!Ievc8&N@3xUROu_5E$yhSIYmUim%I>G5k42wzRc-NCtFbwlrD`uUwRV7;C
ztoSFS7K&$6r5jmWWZ|5CatI#&1+xr2A-36cRU3YDILDwna%Eln10NsB5A4n{d$xI1
zNy7>Jf+^3FwmF#(W4tH@dc%t?{3=%ZFoKq}k6S*td?8Inx})+<6cW2wJ9!Ltumm*G
z0zf9ZIp8$fAllR}d5mTp#XKR#4gl<-4zDoc5**tzFz<=+u#Oy8McEX8Jk*Z-``UXq
znjtixDsl!mh>rI=Y4kr<5{)}eyx}!^CPMRMjA7ZLZ1}T@uIxydv!s}RiF}oh<Y)^4
zf^yD@c-U{uCd5zuj;&H>cAa2^1&`c~-Y=w0{FL}aZqw%an~&(YRfa}|5(;7am4V;*
z^wgD(^?Wjcu^+TWyE_Xx3ri{GSwAvjB!ygPJY7APv{z}@L~4rN7QBah39F9<1>;vn
zs@+1CQXM1V)Dv7@oS$2!<Vo*p(@T#l-z;F-5q@Q?$+%Wnh5FSD!b6hE@4$FM8TXm`
zE$8%sfeII~Q1LU#@CtW*md;@fkm(G#!jI(^W}#sa!Z$qx9u*GH>rip+d5?>f;Nmxu
z=exqqH#c%7WRFS%*k>VGh{4T{lL|}Z!w$sLSIEE<_XZ629A{wnUV;I}Ndwnqi&Mlu
z-pIYz9mRBC0(Zxt+14~%?Tz&F;JROWqdyesdmb?~Kc3TgC#VTq@XS@@-Fy8giu=Hj
z5|z~br6yBg63?viNxizmIF`4tI4~Y*;x(`LshwQh3q5SnUi3p}Lr|h8NMDo#uYSLv
zft=&Z_4@Q^j*2+Xg8mSm^ApVvVc28>8NXQcxy%fSAdf07+%<RoB{EpqFw!z{AzU;q
z5fRVY`wnWSfAb`cGU#)-X!zOt7A{oUa{PS7G|oDM%Y~I+@dW8uhs(v6%=EsarPlJo
zg_klc%HGY=4n+!ndJ+8tN42x(J+EbJ7wH!17iEDlQKM4m9L)M}{Rhd}UDRQU$wS0?
zhkQzyzVqe_K{7_r#z0B&AC8T}wv+bsOd5PfcU~NMHyN5h!Al2u9~DX@+?_qd&a*LZ
zsB?(2U)1>1_V+J(n#A_oR;W+wmMiY%rnA)_fgFlxcrZ6LGv1x%7Rw96flZ$fnD}3<
zzgSYZ^u9(b`!OQ~<Wn!8IXx=&C*yaf_Y$h9Y5$EuNnfQ2+3a5;i0;Y9I8%=c?kQHu
zDkW^;<+huYsNpp2&*q_B!ne1CW;+b$bKoz()-sTDvw&TU$sSe*QfA%O97uP}oe<aQ
z8K+Y{)2BjP$bXAra_%i_sotFSc^G>ujOu|a%thoCVn%P-C^sC&kqo0+iY5zx0khyf
z^G!zh1>;Hy%ZWDIJ*Ja}{a>d?H`_ctr(5a&opKXt0GOi;XCgG!H+o<4!;No>=|k=*
z)o!vy{1{ui05}J3Q$6iPYZDw6ONV^uDdKuquycB+c4Enkx6a~;fsZ?)DcLJ2VS>qh
zJA*R}*9I2Cw4*gXeAkH6z5Vb;Sxt<_H7Utx@hU~yi^GpZ4P0Hgx_>ogvxVgOji44>
z|C|+z`Oa-7J>huvlQ>W5N(%b12~y13wOzF#YoBl<>m##I;yCvLgfD&MYhA{k+$XZG
zYtdN6>m2s8D%h-@?G1Y>=1NXT#c)V@+hO}9%0ZC2Hu}>%u`AY_{oQOOORhl@a{8Ns
znwJdzhotqh6sWJmq+f7_tBg}@uF}r#V)7qa;WH*$$QglOE9pg-F**xj?C2n%#3NYA
zy-9x&5W##yvx%KfNc2Ek^1@AHh^HfFLEqt5@Qw1|3OU;;#W(i{W0LiLR%LxZlI`(+
zZ44TNAGAe<JDWqtGfMU<a@v+w<2gN=2d&%~4YjRbctM=G`1KPlrGKL<o$PP(r7wzT
zaHh_yy@<0+8ctK1yGEs&k_U+5y7L^d(Sq~xvxcl7C>XA9R@JTg_zLLGNmieph6~cp
zhRuk9hjE#dbU&{e`9cLGNg~``PG?*K#DHd!_lY@+1@)18HT^U@`jv?~W_wAcTfRmT
z-`oHQZaVqM+30K|AI6*U#^IzqCayhQ^St45iu8A3F5MzcPAV2<0y{gSeQmMu>+reJ
zV&PrdNY!mwm2O4tm+&A*=4HzFXP$ZBuTzo{S?e|1DPva@=R`_I@i!AIEaqJXzv;QV
zH$Ak_n|YIbum8PyxS_7pI+56+5_MyG`CmE%iGNO^QA2hg+o60tfd1#d_@s<`@kuGj
zw;#%K4F$QPja&W}&+`3IY3xs_3UA~rnV}&MztWE;TlXy#e*sIW4n9XSS7h9Fmrv+-
zf=L+6ldbSu@dcVuadF&tzEAfO?!wApwEmiT_hD4U1R(a%Z*>Q-;!`=y|IGv)(R3PE
z+I3&q)T!IDO#(!jAG5+iP=8KYC`9)l*D{RNBYAV{XR7KKS3Ppr_05Bbb|qIf-;uwC
zFIA|1n@i5UvZ!V=9Y;0km$Kq6HI8j=F3~S&oHAIkJ{&gIT^wQcmwey1koe26nFF{h
z40B~=P;A7918p7drVIVgRl3QWoNG6H3-3PO&Y~yrT)f35Vts@8eR)T7;ATpFexyoa
z&Xa4GMug~S4HxXY!f6k(W^~ZIyZiT}&ULfge|Q^2hKGZ9gH-ruuky7alqvibZFsM?
zw%CfA+63E68(nuhpu2$6+Yh8@3+U16piP=QdfaZq1C04!gC8Z7w*V-%G<WA2q}e=&
z`pPyxk|rv>w~PG23(eg7VUjjIWD@a6IGLx&qvZW*+KC&%Dg@&;SI76cOT}7T(~3Ce
z8)4VuWJkEC^1>O%^XA<z4ihPdDjxI+3e)4yco{u{8}DmVJbB7H7%!fGjS#lzEUF;R
z*%s+{F#F^wfxAsHPEUz?>!E<G_Lx^}UZr_pH@P15i|2Jg6pEp5+j<7v*naasbMTJ|
zd^)jj<ge!y=0)ju-`ysIU!@?+k~jP6TQgicfDO^UWcRe7KSEpTjr@D_Tk0N?qr4Fl
ztM}Aq&whL!S)DC#K`ho~x%yX;<qQ<j^3UdmF1?H;X`ya>^jad@Wh>DSJGErH*+B)-
zXNxk(>GSQW%VsZ;@7L!lk=r|J5!lZ@M;@fVg8`>B0Hy!G2;M^|b?WhUY|zQ)FPi54
zuH6r{>;=&T>;8BeeCIU`2e;hd%JdRFM;5D|3(Zzo7=EUHA;7O{!Run3e!va6eNGlE
zy)B@dra3l7+Mx)uA~{kyVe*9Q3Z7k}1;=47czb4o>sx>KJfyFwh(tTx2b%7#!ct~=
z>;H$b_YP|EiTZfygdPZ0>0LqTN)JsyX(EOuy$AwQMT(KoAxINMItW%m6A|e>f=CmU
zqSS<@ppbxQz?j_S_rCAk`{#9rF@xhwp51+R_nh-RpD&>l7qoa0A9|R58}><lc{kDJ
zT(Is)^4N0dmq7IyzpYt1b138TIp-7pk(yA(ne5oE4;Be@iP6%xCjMvLpi)`7LDdcg
zPq)Qf_>I=zuQOcMcZAUmNnkVOaGpBYvvOyT-teNR`xFSBJ^IP`s}Mr!?&2R`mUf}p
z?f(G830za8>QGpV2Pz|qt0s3oN7g4f_Xs=p=jilVh_1N@;;z1kecZ`VdZn$_**~PK
z?iXmT!Fu&}$YTNGlCo!fhR~Mto3^;Lq=MJ)^nZ<+`ykEQL*PSwE1a!ga<H-?YU30k
z_T)I<gTcyKeLA^z5>Hf6OzRBZY!I>_X1LLIlCXAt_^){MVGbI4+U}WZxk^h8M;k3)
zLyth!2WmoFU<p-G4!M)2(>h2C;dIMaMvYX^?>_wI6hiRQKVhf2b}$31NcCP9|GEt?
zPZzP?WND-EUIb7MD$e$98QmwGUk~6BZ+gic!$$whO8p@g)-UkZ1hL)T?d%=U>Fi!y
z-gk#w^By9FJb}0^c#JYBr(8Q>%%rz?)IeQvB%PY!!{NguE%EechIZEp4m-fqf@MBv
z5O+~LwYsQGrjo1V$v>9s!8o@xw$(7mz#RTthn_>hC4KDfQ9~&yo40?O7Dt;c-(oJb
zy|~-jk0??aGv)b~DLskgwSN~CtqXN$?3O$K6R*~G=MyPgih<j2l*>7HOXebM^9zeW
zf>g8^e!ibc>GnOHv~D0edH9E55V#AAPm1|~zRd1!AQI7b*RpaFhol*D_{(?qkb)Y#
zKDh)DP*h(rh}Gf9I&Wik1aE@~md4}PiWH=><o=B?C`!TN|9+CsbF7CECkg4N7zk|n
zO<Ybt&uev4pete7g=i?-UGJiJl#-j_K`V^}t*c3Knpo+am#6j5Do=&doT#tpl8}+r
zt~f;8-)J8J16<>lOdZo!u4T_M-PsTL#}<#R1#{zzBzc17V2#M=d%yn0<&h2UQ-p2o
zM-1-oc-6Fr5Rzr6kS-Q)J1x)J@Z~|tE?;H;-ZF76G=w!luqJ00F0(9dAh;7P!6@FF
z7&Q!kWUe}7tmCP0LrE)^9ML1K%u4<gEh3P4C#8n(71z?xNfdc@`w*8COZCQ^`3vrO
zpYUhyd3Z3ArJ;tmsQluQY{fvJjS!g7=`H&-y{jIbG>1qyFBboo=^?{pOdAcFQKM`P
zY?}X3X^$5QDQBZc-Fs-`2m8Dxhe7w_ed&L1qmAa75vlWyq$@W5k;)@&k`|)UhllA#
z^_fDUUCSqGSKjRGh<yqd`(!$qRza{`Bq6uim9hwj80K+13amDWIw78usdeC%L+0It
z8vo{x_*F5vTiEaBBUS%pM3WFdwEI(5dVWcu@4Pjg>%F5pnBOam@w1Fh5_P#luSb!Q
zf99<|OyAIFt<U4}34RwK#Zdmw)w$zMq+*-+IrLH#XK{#q5$VRmbO(WfYdyOMwfYk8
zGD*q1+<3w##kqnLf&X_}W?cSshSNi4Cw`f^_0`{@u%|!nI`<9~SwD7HqLRcJMV8j5
z+k!|6;Zvnn|98dypHp_Ixl-M4*gM+8Jw0sUjRKz545}IUrR04X3yp!u9Uy-!5z83v
z1`>($@hOevyVRv<C3nKp?#11vj2(P;(@D)799w!(*Jo<~oC=Ox>nNQ^su2=&rLtMb
zpD3dE8BEwB&<l7zrHJ%d?9l(CqG(h$+=W7bQ!9>VIZlQkdgM(1hjY^5v$z~ilz!Rb
zw13nN8A>Wvp4KBv!i!ZXqN93bD=*-VEpl$nc1Z~GC;_F*7JpG{vnx-!&oyv`^PR@f
zqzPl-Z(231BMpRRVR(Utjz&Q$J?i-C9BpSoy?92tTG#Y5xJrYyfI8VdAHgyHR<MEP
zE@^J(=1NA&68|5(H&Q`}HbV&h_*D$thkt)Zf!FI*ZP^RzK<V*qAw$J<M}e<(pj71`
zOA+7Xre589zTec-Iet6l(FMd)VHYX>L<LW6RbuNv>@TizKk|pwPYc?e9#Tt>hi<>(
z>lQxUnJrFb^@ExX3B{n`IJ>g8I*W<rlTlG&T|=+rvdv7`obsj5$6ff%{c8g50$quz
zP1!7^3Y~k-ytDHsd`Nytfp4ho#={^pf^D7e?e8y^8HFRpvA=(=cubgo0&>|?5RzS<
zs1#!quit`olEO9Q%_j|ik#vPVJ~C1=6aD8@UByrIgkJc|;(ycYl+h;}k^&~n?v|#E
zSs_~~k~i$y+`L>+ctt^qvUKn+4|!>W8V4JEvX2^Hl@*8r@mSUA_%JqkmeOf=IQg}P
zK2m+u1Oy~q_9w275CU(o;vO<nDUJH-GgA5{(RDW(>6sKnfBiSy9OB6bZ<J01%%!~b
z6sVSp&H+&H=*-}7rC9j?t=xVHkIHG78&>;~oXhl;BTxmLr_Os)IaXLY1AgaGLwCIo
zx(b`>cM6;S7Q+b!Y`30s<%_yO3=v-ya@G|1K7X9Ke<AN&Q}h38lmhOK?&(XPx=G4I
z^-T)@E%$Ury2r0YiXznBQyHD#-YmV~)#2Bb`zG8?iYRfBO4}`@KKmEeA7;!=B8h9)
zCi@cTK9l4^vF_z$OB1PdHaL~UJ-gW@F)sh@G-`$8qvef?lm!}f_F?4=;}mt-*}qd$
z9;WZ!L_=GC2+Ffb_nn#~(?9bUd%;A8($UVPayXiJXl&l2iNCGabR5e~%>93^xU2X~
z+nhsGir{1SbqWc#tDi~M;f?i>s~P1tV1EnusPHmXv`BoY%NUhVf&5-{w_3{9DVdcz
zG#{fP*1<!pQp;hx)qb_<hj_sHh|0jUK-DjxL0@?&|JHBJUZLHU@XKD|ZO9m!-TP4z
zV>V%72Q{?)Li|<wDnhb3`#g=rZQWS!yblYmLX&#MNoUxrsuNHs3UBK}N}Z3Tlk@;r
z=VcX0X!zEHG~BG7#{lr3YOQcQs){redgb#*Ltl>0>6hT^pMN&n$&WnJI+ZAV=_qq|
zk5^s2z-1v0ezLNc7`=qZ`aPII^Xmncp;P~47}syk)CJ>zNiU<`bDV$^Lci%zQ}|KT
zVP9+mxb>&<(s38|FU3%*fG=Hvh1POLFvO4sy?32l+fQSVM{R&6It6u1TU>4Blf<So
zG&$D4_^tOO<9zJUnV0zZdp18xcQs^nx+3X&LDKej5=Ed-_U2PPROg`eVDAt?JX(UG
zH6_O{A}F@|_B<&Cdpa6w(DVmWw*?VsPPa9Z?B|c|r2_YY)3$8#1uKU1Oj>5D!R!W2
zS+1esjO<3uz>nuRG_hOz@2a&qlrP<HGwK?~?bK^ra8_<5?SE}B;FV}Bxn<g8MF#zE
zeN6Kad*zXC<6r9UmEFKuLb44F-#UMi2rI2hxfd6++h4gqme2&oK3<EqnRW_9ERLql
zL~8G_T^xH6DTDjq$t{i%T&JGx`Q#xJ%F9vJ$4_P+hP%+Vxe_r2z5B<@p1cjd*RfB~
z2C=wNWL3?;iac7LBetq`<uME=thzA9S`-HRU^FkB7dAO`g{j!YXJ1XQZx+s&sztKC
zPRB1;VKo{_ED_3Ol~+$Fx&bec$*ibTpQv3`DD$ouZqCOf2~T1-EjPJquy?)wZcSpH
zT}1&Mw5z0*=h1$G=voJr)BuhJER$$$>H-UAA;n~>@nEsFl-#?G!ky>3Ltaw#TqcR1
zt4$4Mx%DKcrm{}ihDtdrDhHcdhE^?GlTrvq`#|*LCTm$)zE3u759lHZK7&{@uwUAA
z$~IT<NbZa0^!gtKwZNcJG4-I9U?9}RE*NHTN&VA)e{TVmIv+yS2uvRwq2Qx4q0yje
zs1^Z(O0Bj?YtNuVcWB&${~1-1mN|cqo5}w;a;IFKr1nFgW`|R<T5`B_xsUwk!f-+o
zsgjl}-1lGQ2pS2rzU#3<n)Can(^(lfnoN=!<bTNbQdhr*8i$5Ue>E_gQGB$sIuI>O
z(pDqT|HMLY@Ac<-q=UKl-(S%65BcCn){)kCPPTWEe_?xBB{Wx`L_^K`gY8iOPto(A
zNO?Q4v?$l_w)kS&jF6H}hMZPGNG6duJ$PpF-H(~Tv?vv~Bl0P@d&(b`4HG&0IWg^t
zm_Gwy+hrtT^KkTscj~I)kB#LNaJnU@?@Dyaz@TD6_Fnr}f#$4~!du(%^W0LxIPKip
zB_d;mdu+p9K(ids5YHgiOuh)Y6$f2Qd{4qP<2kBD&Ycx5GuY7*z0Ov$e>?u`oi0jr
z<@mG-@vi-g9%t=F*d7Am7spAH)ZYgM1|JN<w)zZW3__%4pjZHp!6LYy9OvxtxB<oL
zDdBlrp?4dcu`I5OX@g=SuJ#>s_(&J%bYL<m^HQDWBie$Uoz7*UUCJA3-(}iIs64)z
z7fq*?1|&2iBW_nN!bg^bgN4pYtVjm;{rgT~6lLUqkRcinqMji{qD~N0djYVq22gJp
z+|7f1zoQb^J_H$<*kotMi@xt?rQ%HzIoT{Zs$(znwDyI(qnVnrdVJ&D*n*L8h}`Rt
zse$S;hHxl?uQlt>%1N4G9zjwMQ<R3D3`^%W*Vrdr3WfF5P{{SzeEOvGV{iAcIq(Cj
z_=K7@Fe@S$?h!QqBwk;*xxF9l+fLeLZv|O@A1yFb6>(5vl5ldTr(bgEjYHKpf%?!r
zo}W3KJAuUS0jV}3D{t9>K=VDY{L)--;1|4n?-RwHx{fsoOP>&H{Sa|-``^H>cg5P6
z_1TV=&@|AM@H>ZOr+8mW5=?_Ysa6AHk3c0dDj_6g1AHpUi~yfDN0;?)+P7nBxzR5w
z6dckc5i5PdQwL^|mmv^Af72#G@V2Cf<%AlS6Rnl2bAWV&Op(~&#g(2$O0Qa=_i<B^
znWjx*sj}$gwN&%7<^m9yb0Gsw{*$vy(o%g!As&98dmL+YL{^3fQ8EK`Mxwk-6DQFt
zEK6ENckiGFA7?Dh&gs3$#&r!XN6(qUX%3#SOp%666?Ys<Kb*+y?W=Ze^LJkOSW-yG
z#i%82NSBjT0wYML^Vvps8*uMFLmen#(ISp4V)fl0j1!Cp2pm)rm5{FZL)=JRTl%&p
z-PLFBbUei0gm-;LPfpM#-gzJOxBq>=U4@in9ldR+bD9XAL4MQ0FwKSE$Smrd&sLYe
zkGfnB&!k2Pna@;;Z){6SyS<$Mhl84Q(O}YAs$v;Q92+?l2zmv!MnmJfM>y-cl2}wi
z+e^s&d&po-waCh4#^!V()r*+MFnGRHe(~N9@q~)+Yh6*PJ53)**H2g@ujQDWgAF@V
zf3~)khl!0R=WK~&#d)u4Wizl<{9KDKY(M<+Sl?l*NAA;KKMimSarA6D>xn_BNA)No
zOg2({>#I7G<H^>7MkbfZ<oyO978`7!6ZpnOMBR6Z%DY|ZS~<&I@8F2&7jpniJpk&T
zd4eTRyDuW5OQ%EfYO(kq6sgH~NOn60Sq9EXEF6-^%AMVEifAqM_{H=8Lg3%XyYkg#
z5;~^{1EXMyi9DW3ZM5k2XO+WUijU-e`%-!jeH{*?Z2(VkK<rq8`g#&Lsk}9Ocs+e5
z%9}dfOJb#gGLUS`m{YGY_fZ5ByKb(;38dPu*HeGmu4u(@m-e%S{eie*QKRu~bn!b3
zqekCK^;I1o8guGe_(R-RSVo>`_rLba!oeJs@h1fO`%HS2p}douL^fM}aTdw7w<F1u
zJPbU2IX4cgb>oxdPn5+m#Y-ozNKIz1pq{UV9`KI#(j?5zer4>9mwtR?y?ck=fZvdb
zM#t<!wjI3FfRSQPLZK{BJx?IR)JX%bOMWS3Y6%O3+)x=@I7|FZOn-r;7-fy4pf>#p
zLIb!me5{POrpc94j7so$AAZDC5mW!1u-49p;5GNgalS))52+agWg^Wo#Ml(975P@L
zJ#2iUv1)1E-a&-+N?z~@o74H>yNP4xYnXzY7tGK5vR=AYf$(KUlWf#@QW-TvqEBbJ
z@LMDKJf1On%VAgagnkQt7+GdTu@9Qd(Z<<|8YAOFo|fsom%1G_YzU7xOSAtlX5gDw
zWo@|Q_jNggu=UQd)V|MMYcexIv~@?tCn{@nYMFXj6<Pmlfd8xIj^MMHraH;6ob18S
zy6jS=(t*QHxdNL`{kQ}7WQBsFptk<1{G%GJ7IzrX+|RV^MY>6wojd#NIdJ1mY@mhR
zE~g+PnW;v?*10=0!+|ATe;(2i$Mst~Mz~0c8^GANt;{vd6=C0`2|J2*DZiTb?RZmQ
z*y?CZW<lT)e%Im?7_`V{>6^#vYn|_v>&z=L7Tu#tPDv{?QMktq20VDViF^n|T^cCp
zxK1Oy3ge6E($NV&MI2-{6@R*CB+;b&Eem-Dk>C_MX{D#P;d|b1<-=}e3qjB0z_2c)
zk7MHM=?j!OFOd~KbHp>GjiZ#!J81Mx4Y*dRHO;oFupd71XC;zDf+zZ}o}&Z|mlvvH
z?KC^6YnE)1_DIk%SYv|r^zVN5(#5}q7hwC;<oa}hBW)qtWmYA3oS?UQ`m*}=(F0mt
z`vMcuJ`owp$y7;6BS@~5%9WMuDrd6P$!c0zzo=KwGQGIO<pK}~42ISNX9hevvG<jk
zM%wsUTXM^2zTNpV;-MQQ7E#OL6KzB_ne^E0lcSN=cNt;NL(Uza!EwZ@`-N*jy9u-y
zEANGLxy*f>R>oB0ltv}rS-u^DXIAUqkEu)(aMAX8DfqMZAuZ{2^<svBn%aDGZD#5q
zzf0(sWkpthXr+0gH2zikLM>9*Mw_T-N4iq?D%cbKR9(dI@yCG@r*H9<Y432&!Lm|W
zre~42K76DSp1O!5&Me)PD6XVEPx@0;BO>a+X-zt0w@$S!9em=%VD;wKYd2VtiBef{
z>b2JpvDOBpwa~(`cn3pXQuiMA&kU{9)YDP}*>#}o@IF@j45b>#@1rSlm{}Kz7nSJA
zd)PQ}IajbV_5B}5T<yZ)1#RqE86umJnyCUuJ5pQ@pvonTUU|dQ_YVmwme6$5pvorJ
zvz~0H$dtG+&ELM<`I1O7xxhIe5?z@N$i|>cOk|&`K6cieg+?<}m$uKW0CBJqO&`CM
zSicy}bfBE%Tu2fXdd_m4<9?jFDzBLm5ZHaJymyVUM~q-3baGy@D1MN}`=qG~bL5X*
zK7vae4IKZHVLwkr@<QR|GN{j<MiF02C`}@)?>c=`5}ZMRMQ-*v4w}A{YtxH^dAAM5
z6E&`7z;%>p=N&&*A$Z^Mi3O$ReqMdeoLhG%TKw)B*qYu=fW;Ql>f-ovA~w7x>0z{|
zch!nE*I7cmNl0pO5Go$QLL4v%B@QfRS6DELUK|`l+As8y?suIC_fEJNy0II1QD5ZJ
zO2XnTUC*@QB-_A*q<pd70W0ax9VqP3fULmX9r{sN?_MU?a8c;$L~c53#)YuN-_6O$
zM{+Btcwf$0+4P;Fk!HB-KNiMxi##3*`aOU`BW--nKM)P%yFaXJ(KAvcvy?}xhd!P>
zG2~N0PtG6hGi36Vg+h}a)#?fv%Pxx*yXi{m_Depk6r1)g)MCJ-SqM}P<j(wf3gkrW
zgK{6axmhfQo7aRSay2^P9KjQZ-c0&AIAM<Q+3PJXGV`LWRkP~!Z+3bIn8M<qYWFB4
zGxd}Ep=qi|SB%%*-KldTR%iy1q>*mzhDQ8fIff{Zp-Lij^fpzavi~YPRR4;Fy|*cI
zU4d&G$W-Rnkna6rMZp>~Hm=Ja5RpanjyTi7r!CB0YVOIQ-s}mTa>|Pju2)?`VP+w-
zh}m;M$_~1v3on@;6(4HB-KljJC2EJW+{aC#0!TSvV<2sVkS5QiAvVL+`mI2_QVz)*
zR(CA+M;c+pc=4KT;_PE6?iq*-^*jQvkdJUNxo#fV0zkc>1;<V9Dy;wPxDusYC)z*~
z?hL5l1GGF24iKcxfRl+8O92DN4HW}%8d;{8OV@K;pEth4ZVI#FunIk>zN<7vBA!$w
z2jinzSOcvftqPhVDCZL8EQ^#Hft)gYBH4PTILokb*hwmn@DSEym4Nh<5a6xSSJ??n
z4j6j;px^8IONTG951z~EyR(@o!3jCpnO(PhMTC4v@spWZn=;$VmoS~Y(IyT!;UsyV
zcV^GK#Z&4w#`Os2(P|_GpzC~e1m!5QW6xLSWFM5K55OyEaM%#tKAB9WNEf}0(8_x=
zkrTD8C9C2xaWPX<pJ#M?YKPkI!bAE~`A&wotNWSdt|;;FWnsi_`l@lW=E}F!hUR+%
zC6~LzCA%B!-@W5H`MDTz>#oUjvmO>twwqe(p;Mh|h1eBaL4*LT&KMl(*o)T%W+C5<
z@+u^2^ZBbaK|{b}>`jx%RC%+?7X~)mI4;;(a6z%cr7y2+7z($^=R-h;@D1f+Qpc<_
z7IeAk;IwC*4>g>V=`_X>jUC%S%zRSdv&^|41;$<U8?SwrZQxzJS1t6bf8V_|Vs9q1
zEr1<Nx7V7k_i}NIJbdN#5t}aSWuckFBi%B)WFE%@TEj{hpkf1MvpRXZ#?s_lzRH>7
zcd=%D0X1`czpb?u{PrPgHK*B}ZASIgG7fz#-w5srbV~|Mh4-)LtDbV%i6L2Qt2PVU
zM}POloqkO7bLh!BZCzvX%HhZU->xyqSCyD)NqM2nt>fjWffK?)spib!`alxOm%5<q
zHh8>z9|l}%`4@_?6*Tmxe{(Y!%)qx+ulBN%pux2t?@8&FAEd9odF5shgHx)^KmA+{
zcd53c1{?bEx6V%%QA45kMc011Ud($w?AeoWj@t5lQ%AJeiON9Np3QKEHj9hwi<?!K
zD}EiCcvyaQ^|8!$awv0)K9Ko-&nposDJ~!xd8r@uN}s99IVqqD`v24lotvDS*R~l1
zQWcNd&<ak<2F}|$8UCit2Z_wiAM7}re!{mMx<UxzpP{sJ$1rTj<u47&ed5#+=YOC(
z!AlqPj4_=`<OWQ0ZeSDzd|&Qiwrg~N%gbTpE4==Jd*^Aqi+lRHldn|Cej))8;pu6c
z%SV{}e3l<wx$g;1*_rQ(e`vqz_uJNCviy<!5AVWXOXpfis`F(qBOZOm@3mRqkc4r>
zGFjf36c|RnjubR8E8pKq4~24zsco+`Cn>)ll*ud$3gjqsn*58iFo~p>;mXeZ$X=C)
zJ5l`c0{YKl_9QkAmI}tW*d(~GP{65kq~DK&{guSS)FsZkRy&?0rOUIU!G{@bHs_s0
z1(hC@swIssE2T)T+O~tGlxvwL;PB3aPvAuBkj?A_Qm;FIJpajH*f}{6XXAr8F}~DM
z?sF~3+XUXYoA*+Z_|`u*3uo>ParBtvK(Jzu@g=-l?Xis=^~h<Lg=tI=Xu*F$E7bWc
zWwq<%-;yP2Ya%P~oc2uU6s&{(L$Y@-?Z}PC$ESn*5Cx);ybU1gk@XRQ?tHHHnCkN*
zph4Ps8VQ6}<d)e1&0tj1`i8#p;P=qO0(W$p{mdGRkj1Ti`5Ye5kI~3;+E?wVT{10`
zufe5)YOX@FbAAzI<inaDU6t8PdV3SS5tpMjT=EL=boK~>>ET<#d_3UnH%wFXzK+9P
zsodl;$<IGXXX|Q$eWUo+&HAMt?F#k3U_DfIO<p``{A{K*i#4uQ?6py4ugWJG_f4uk
z5@m`hAgQsJY>f0v4G?#e!={Q(4*9$tNIEpjLf>nyB#q-&HY;gE28cs`MrLgDyP-m<
zHepSoHrqMboEgLtgp!+DxW1YKJJQ!-LJMRlZlD;HalW_S=;xQJo*>DmWtr<g)^ZD;
zw$`^r+PBoZODAgfjjX&%8sbQ}mq|F;5_#6+Y)MDi9~e>Pc_f;s$)vGjgrn6%IB*{u
zuk72u;k!(y7E#DH9K*ri+DnEqU^=#PQkj0BXCy8*2^#Ed!d?(X6?~+3PP`(-ixb|8
z6`e}0`2C66n0)Y`(F&jtl)2kJN@OUEa2~Os^}TgxIQiMvf1Z0IYgjUDb(M26;g?s+
zve2eJ7dF~f%-C4&-+L+5TF`^_%-<%bnO5k-cKLM|6=$}|OVNA|ob96}he#PdB59i{
zWZ_9Kdg$k}$i_7_b5M>e`M1$dHX}So6Te}Zu9bXd=)B+Pww-%#<^V(@v2V_K@Dbbs
z#z>rt5!0t?g9DS1Fyx;~_8mGiHjr!3XZS+>{_0Gl=F1{?m-|X5H4imaQ*H34AMdv@
zrq#^dxoNnudQMidN;E+ZLZS9ZC0#bgzwy`;en=Y$I6J$nK-u|e@80c*$So-Dny$F=
z*D-w<IAGR<QVoEN+$sXF4|EdL)TWCE3>_}}|9Vr4ZVQG&RSqPE-Ql3=xUCbL&(dxs
zHsmT|bILQj<;Cwi%5Yzj^?OOLQ8@>0Zp4ARkgEd%6z<*R9FwBxa<mJfygM}8SJdDx
zJD=jZSar8t_IfgSZO%p;S(<G2yFtv$&E>GSk#?@z?&lF^^C`SEnG0(lx}tKY0`E|9
zr?;Ia*1V8Y$4W8HEF(!>dw;A)`W);OtEU=gh!x--?LiRbVS-_@l1-Slj6vy9NSUTY
zn5JSQ8JKrWM-4=}VL+>1biTuth_GkI0v0jR8Q&IK$){ku8+fUigT>!3XDzXyp9q=2
zy&b!oEdHwPPeqL}VxalsUsTey>X&mus`frnXz5&MI5#Grr-H%n^Y==j^MN&ED;!rV
zOXJ_i%;<4!8M0{?l7VC4eutyzYH7O?9kunZ?(UO`Dz&+1C8X2uF=1ldn7T$RSS?@J
z@KQ$v_JT(e!5+^e9}O!MzgF2C3cc`l+<&9GX1VQe@xhgFzY@|FhR!T)YOY0d@Xtjz
zogV&xqQ!>iz<tDKRjumb<`~)Xdf>yD0{2Y9s2z*Q+x@Xyk$T_s)SNWS16mrKXR%}?
znA@Sse*WiAv&!6q-c~M!_wYRH(2(^3v)Ivdx*6fV@R@7t!P<h18MqE*66E*OA<V_o
zlgcS&R^m~U@s0ZyXh!W9=FdZUPA#6K<4g}d`FdwuCVuhPeMuGs`GNzYkvrPEp9VMr
zf!F}jh=}@0J?bwPAeCQ=vV)9QY}e|Lt*@V%+wevoYPbNK^LStj<?7{%=hc5^a#pIj
z?RIhcCK<}IRT~R>%%MFBQOp(zZ1~o+k9SYpd$TN%RYa8u6!+uHjG|JMI%YR8yCv}f
zKKVOefrr;6PFA8?^8`|j-xxzK*d*9N0v}1uw7=tfd_Sh;-Phr8wTbnZqc$_nDr?qN
zeWA9#lro!j6bhIr;mU`(lwRDrzFF{R-JM&5qxj~V=G`l6_!i9UPA%!EsisFli$U>e
zkyxt+mBl>l!so=Z#qadUmSy(9`3-oWInVAssXJ{Bc6qSVMBlZH>ZLeuSs%B^o!GMj
zC;;wkk`8W{_oc(CMO0as6J8W?9XO!P5E-V!+HNq&M2o`;>H~q8!4z<4dWjAHDtV`t
zxv{{_?xzMiuhva&Yc5m21AFSifTs9^U4RJ@J24951C4Sd@?3NNth-43uFQ*#-QJmU
zKr8^Qhh@MTHQ=!$!W@ns%S)IPI~S*lX*22{rT^zQz|WZ}dJcv8cZiw9;1tjMoILmM
zsz}ivkUBtWzam+#k8;-a9N&1<A|^f(Rd1IJh}|p6a!7M&WU-*BylEJ{_RHu7$M*#k
z`avU$&2SfW5E*|T7Y)2fK5q3!%mcF=cY(FkYk_aK{A25a57KvJFID41b99QbF9BPW
z&t-Qb>m9D_%>s;xVZr}M#D_2ItiFIB0=vaJleSWxDtIvHfA?~YPC^9otdx#Wr1pSI
zpjPS;_H4LUd&`S5UUMnOEc#=1jp@mK{OJw=p}-IfwrX(+8ubBf@diqm)te4?23#Eq
zQo<aEQPlTHyA<9&6v&?GGj>1Hp1Xv+6tX=j-C%a|_qfnM2YhV3gRC^-s>c^;!}`St
zga+mK(*0bMd*O)p!K(*PldPJqz4WEF#hi7E`HQJ1UKtq?^31c*I%6o*ahu?joGnl!
z9qp!-Xmf9dFV^+>fs2^Px&vZ5q+=#|TYLG~UTUCS?pa0o8)`-$`yFb?E}1L?tnl~%
z1AtWVb^7Ym$&ChJF9_L<Txg-_eL2jDnnk_D#B-N+;G%a0bf>A}z6K_*SKx1P&pnrg
zRHz|n5CNgN>+RbL5#ytLc;7)$aS7mmf+;e>K)1E$vb^{w6L%mN$z)66Xn8C?u%p4d
zEoAAa7S!pDfnxTBsiU;t{-;jVNPV;)tR{?UI_|(Jrlkfn_D{#b)>2;p*ur#lX~PTW
z(l<!;cp{;|R`R~&nTVJwtN^0t()R9EcNX9mV=H(Geq?a`J<Cc2vWbuHf^B)dp%I1`
z!!!fUD`b2zv@7afh0gN6C$sBStF2~y+_#b93xV8EvPmhqrn)0yjK!)*{Y38YX{5=t
zOA%C;7Z6x%h0OqH0UAaV-}U(lODJ~V^TM-I6gB<wkh6rp8|ZNi6I=>mP`~S?YnGyH
z`V15eE9X&bps5nQ3+3J$dVS$uo}vn#fwRqtz@^3!6sl`|WijUZE4A`CNBSH+#qFa`
z3Se2dM}97wH-4;w%KS-d`+fezk5fUFl~ODfO%i&6&J6(#p#2+IG)6k-m)10SNpE1L
zVglMP@Vu8JmCRytb^dp1PX7!+%`8*k>khXP=%3x9%^B+*vZ0+ZVP1mSow~j@RNSrR
z_5wZiS7-KIi_vGhAW-RZ+wtAa{(f!wppk6Qv0c*)J6mrG-t^-(x?e~;GiUu;ZX=bP
z<MKJlPhSc4h5Ro}yRj6nFBpk=K#9vfBzBRfr_sQ<9iB|cd}%(}c<l(f+J;7MJH}_f
zMpP?49iZ2jby9190cX&V6GFOH%iEgeNI6$W<Dvdlztw$53AcYYZz284%YzRKJYnq_
z8y~JT;y9i?s3fbM1(8{CIMa_x1=u?oL)fs@dr8Yy7aJ_8(A7=0i3>B>#!`v~+PT<X
zS2$4&wvo8);*dSWIiw{SaXU_br}8!rvVd{uC`+(-A>hSxbxFjgi<ul``*v}|B2q5F
z%vxN2=ltq3oC*(eLspK?`-UHZ?&j7qNjdEEX(YL%UW6zLil;Cr^ugAt$;}_TW<)Nd
zrbt>ER+Vd(pqO-Mvq=;~p9yra0fY>1*c8!fB`F>MpmHD<xY;~MF^Dp=gwblx7Uv`r
zRcM_6gQxAo$f~Zt&j}$pVA8&^U8=PoUaW@Gjh+)b@27l!aZGjLkXU5Cv%#a&zW;u<
zU>1Rmbd35!{7`gb=y&*Mi-#V9`wHv!(TiI|>4xW62LKzw<jGooUgopAqNnB>W_v5z
zdVs66Nvl&Isz1Zhb91s%<bV2RN*6w9`HcZA5oW7N3FJq&fh%xh2KdRVB}$5qFiN;w
zC&<2k?m(^jP_JrYD1Zo-lURly`w2sWK3lXa+m;WcsQia|0c<U9Jb$z%BY3c=w>Lp(
z3|2~<_i@c8NGslK+rUj{aLZeh8aoU0esLTQSEC+n&_EBU4vo~6*{^#j7a3QL`t<$-
zNp0>rxkL?RnJ@o-&Bxgac3?}T;R1cz?*>-`)AnViDs;watMWhl`%t*a?j=sm*nEcI
zMJp7yc(t8I5)z+%9d)_|JAJL;IUdtu@1heAb$|8|zS-OF8|16lPu(tnV?Fyf2lTl$
zKW-};*PcDp8;D-p9LVpZ&k=}J3b@MpoZfV_;&GU-g`oVEvV-DtIy$TE0t0`KFymL1
zn#XenT&s2wNW*rCy+DT%R|l4$@!M`J9)Uw1)<>>KKA3gSE;>Cuxfbfs2eFd6qhDfp
zLz=9ch-Xba+x7~G#YmTF=X5wQtSb_abWh}B5CcRLcqQQIWLFpGe0VAVW?<tuO-*ET
zOqhNRm|aySn*{v-d1QQj;MTjg9;XES#BSOr2UtR*`4x}yqzzB^NMCxJ>f%7niCSy2
zu~m(9v3%vJhF!9BNo)$=b8tTs=^}-LWyvWfg<LPw{TN+HlUe^wzo$RO?Mpa)<$iSV
z7*WqL0OBUxTmkT5k-%Kg)w`?+R9UBQTR5qJzV7lFUiVSzFPRw$(-Oe&vOQayK|Guh
z68Sl&8?@PP&#JY4OS<;{M<T23R59(w;T?TBhY<w+L6nV#gWnn!EG2dBP&#<Sn(XdA
zfH?6RlTs#H#}QwSKn%GLo)(;qX5vpz`~krvPh&E;>1wPsbg}c_wTH+bHLu=sObX=G
zumMNY1I4UoD*6&gmE-kSb?L14i)R2ql0iTZ75b41Y2JUO`F;8CtD!$+v*Bo!RD;Fh
zN#(`5%|{KiQtIFDj1J{qqELy94FCmzX~8oBhvBjU=Q?XSA_Hb7YH}91Pfdr1mOCHz
zCU&w%&*_CnUw<DaAL*N&T`L*_#3{M{KKM9>GE-@}`bZZOImE2X1!qSS%W5?DpcwDe
z(n^xV5o~i)|Lp(NDgRUIrEk*@-SyIjuOuc1!qb8DOP}YpTXXv9T6{R)rz^YO>RKa%
z0W^kjjVV-O&&jR85o)>;B3To&O@GaoBJRQ)C_fX$Q(R5o?Fw=x9)Ge4DTY(=Lqc)|
ztQ}!4d&iYE4C&aw^`u4efg2{YH1S-P(tb?zN3O|bw``ob<lGi%CtUDV9bOH>sjp_!
z16}Q0yQ4T>IPU6s1$Ef_!GTMZD*E&Fd5XA9Jt7?42cdLU36h@Kb*B$$LB@?%s*|_g
zdb9p7S`17R6*%R=0KMoNCGMpm_drSgQ%(^Pgh`f6hwpF8_@CkJojAo0;_-)%f@{7}
z<TzFs1hz=-)RVZLXI+)#a)$xsY*|Yv$)~8Jkv$y~y^}J#lFZYeMil?P*~Yp!(Gu7X
zxnkv_aJ&D!sN0gqmr|>r?0#{g5L1Np03zVL&Y3L}uA7fnk_%=NxeJ_MaNLj<*4>BX
z2ygViq_U@%4NeDgw$c9le$HWrI$&rs`nJ;b5Mp5w2bDbIStayJs9&l0ZSVO)pyc46
zvpE)WxP=f!c`wV}&3ZjeCC5oWFz390`7tv_nsif(6zYf?840|{esCO>yU5kY0Oq8d
zq@|&P%SCYpl<PZ7z?C{Y0=h4U{SIu*o~ksd2+dVz`oB_wNt`ZEGu;^KV0ou@0w)W#
z)y`)Sv&VK+aXv}s;l>1xreu71Iw9?T77}q*Kq`z;HtqDwjpKD-L?tbA5O1{R9|>g1
zUen2W=EdtK5ymR=Yv=5+wv~|>cLHmJqOuTHv&-f`1z;S+Y`jY7j=SXv&8)OR)!!X;
zBnicmZg%xhm+p(e5HR4`T<>~|Grp-<EbxKTLx)wFH~de8yn>l3aE?7kZ!T@qAELwr
zamccNYs&&Q@AK=UTph#&ZrIo5*}Vr=XoH$E-^(oaV`6$o_jOp>?ksQY?W58MZ4@td
z#avE9Fo>s4;8v$tpYpCr!N8UUG^H~;b5XSCV%=o#-v6uP*IkLr>Mn_%eg7y~Eo0<9
z1HPAmCa<lOL+fup-J4S*_x0nF^&kWMDF3ub`p*(4CYBegjcLLIq~6jnS#D<e#iAz`
zLo_$MpQ{(qIOASdtt}$S!MTs3?aagt7jDRB;S5h*JF~~gp*PZAPa|PevYy<1X7x6j
zNsTNPY{NqfcNxzd6LIC$(ry3I7H{>y`lnbaBmP_6_gE{sf2pY6$k!z^vO|Hcj$a<0
zE|JN$=Qw5Iy!d@}`VRcdgNhbZPB~Rzdi98!{iJNvF1fXzU(gh4X^<?{QT!R&_3gnj
z!?v^>wx~e3BryJ}kn)VGE5eOWi1rdK)B5?@1U}~6`P1)U?pOLg-UyvT_#xI9u0MGs
zyfh!sMfcs>`K#T4)S6cK)^`M_ZVb{|I65MX6neOS$m!B9Y`$(CTIL0QvpzC1n8WEJ
zEG%5csZ07;JSA{rS=5i2S%rWbEaXZm9*yU;$r)XXI1Ix_Z1(T3jtnNH(S&Y1NO{I0
zc-gK%X7FC|Xu7_&u4X%NeGEw>+#ZhK9E%Xn1}d4hG)|==eZ$fGBD|JxOndg(VDHlW
zc=~ir0u7C?yJ4wht^*A-7fsgL8e#hDS*Lla-)PSn@SfV`B8I?LXp|z`K3+K`b*qKn
z<B`r~&rfztr)pXafA|cnKB)ck?yT92WDzfAiQ#AADds5p-WA(nvQ(Mu-_kR8Cd9A*
z85~}r7q|Vpx1O-A8c!3?SbZd!T$Ck7e?@1KCN-?Q6K3ADcCVefVtx4d2@t=E)1A{|
zza)L}=Fca>R+yKT;y!F9@lf0CQUUo=?y!{}u9w4siIw6C<9#$9bV7}N*nIK2RfUUV
zMhkfVq}1XoJPJQEein&C(4%J!_USWVf1qz6P47OiD~ZD&2}V{l&|&@U?h|sEx~&}9
zrDRevMVdJvK}lqVcs91OxhUuFI}s~%EowgU4SFK}55f02Uq=!!`8yD65VcG2Q1i#v
zOz^*BH=x|`xe}~dVDfKWFxDJuB5m?F$pd|f`9nl}wiPbpHf`E7h&YeZ^|dcl-6rgX
z?=yF3lrQVgg%xy+Pty^cFXN?H@^m?0JkEluXLxcLl$|LsN^Fp?u4424{>{8!TciO+
zN24X=6UrbOzZ=YShkyN1gHX_`=C^VJV?Dc>&xyPSJ~UPjS+k9j;5|&jS{W<6p1-CY
zAy4_AjfIw%-=NIl_l=E`<h7grL1K>v&Hi>tLHRYCWl~Pk$px9pW8j-l>9?PWD<|j#
z36e}WxMHc)KN^4bOcO+V0c3XX*tGTk&!6;cntsxUooKT_DnJdxscVmnrEPZB6lrL|
z|E5SOw$ATT|E=Y$XO%{J-o=W6U*025%}nN_z$a?SFZQ6<;BQ#!Vz00UFhgM%Wz2>c
zOqK6bn3&0WG|iBNYPpg<670?@b4<IUCV5zARxax#og=?AZ;i=ula-4peLSs1-eE8&
z4FkjPQTlj>3B^`Yx+bkug`+Ut1>M%9c=M+ZnQ87@oYB>+b}NgThZaAj^Z-J4s4$J>
z9p8jLn)ngq8ycfFbevNqS$ON4QL5_H>5r^up1mode&(cQi!XY|YrA`HX&yzEe^g)5
z`0v~&BCD69JS6{wKUpyCQSk6Pf>#@Js!bxkKes#i(eMyMF)xqLxz!>$l5K*;Eq0A>
zuHBl^n^iw?+!Cady%kb?udhmcq(AF4eCCG<?cK-w<AGPHf}Oo1BPV<=+nq7%e$Pt0
zplbW0T7b3w&2K8%YdMit^JyHriD8Cs{W$dQ=WE!+`*R^5TTV?KZ1b99GTfMHQVim`
zSK_TD?0GLUirN5z^^(NY*+Etj)#bmYi_hi;FdTNW^YbBCor5H(>-5zp^$tmVuM_PJ
zFTu2wLN816L|2?=l0-D;t@GBVN^iBv^SA~)y7(c*#rzb*VbjGxqlNkJqSCyHF9fwh
znXlOOX>z+JUC&`LE%8@&v=HQ0m6v|k?z!NEc%*}7kho}4Ow&-OZ8+HW>dLrDpFeb2
zaylVb=$(t?RFd@9pyIW?AO3Y4n%ZvCytQHCSl$(EvEqY^_b;dxpOeDIi$qj$4tzTi
z`<ZMq$M<UOjrGWT;mh<q(?OM7t>n`O`@nVF(EL;>M@A5aBXzX@p{1V?b(VoH$f!Bx
zfwYIaUEK0toUd45$jx3VB#~R#{q>9>gy12WoCj@+t;PoSS$c)Jn5FOUd!(iFTmtqG
zX-sPqhVTTYoK0u_F5!zH3p^bN!$M~1CV79Ffb5NEuw<Fsk7`#C%!6|+{R;QW;7%>D
zeBEg1vBtdga-Qu^&u9QHpEb!V7VY4b4$jU0F4Z0O<w|i50)Zi6Fo)ha`Kjij3xhc}
zmB}v`P9+&KkbbA8;pCYn8pp3nW%F<F4u$c#T~~}#a^C8Kl1>SL9CWf(eY7UF<|!J2
z*T5#7*y)(e+^}1HaE{JfU#|=V4`>i~^|Qn_mSAer?@b5vNQq|$sqmv%R;^G+u{S0Y
z#DFpQiU*@+fzX81L_5LkO&DLL7jHXD8^cmq1Zr=G-xu7zsqFjR;Rk@@8vw|bnE$OM
zG>+CI5k7D8Rm|Q3!J_TjFESM`@|It|g;J(KC35~V);&~9NNsC8-x>mywlUFEzJ^t7
z%$yE%ZX6Y3)EM@*j3|*AW;XW3CI`?Qw6nwnH05j5B~J|^4RW(}_4b&F(-T)sdl$CR
zLl6q!>27t@Uo|ggkT*kr^>p+bGvkTmiUmU8Wl(!kf=W+g8n{7v67wE74)eJ|GyAip
z?_Y~Yv*-PZA(n0Siw5Bp^sy9n=IPjDo8nr8UFdL?6UhjJIZ^yj^<Ra0*d~$+WwpZ8
z?E>d+#OfU{I3PQlVa8|8^pn<54{go^+Cws^sFMpCN1ZWi^+-Xi$M8-wKDd@(=cUdW
zh3$ojai(RocdFWdSu7gv5jVet9$`+CRlBk*3R>LUO9jYF&R$`X6))}1vFk#3Jn+Y1
z4Ygz162y1dNGS9keBU{sEge+HSww2@pr7aRuTgH3vDgFq%4rtBfVMqIznrn?W6yC5
zMil_&zXJ8%j+bi<qlrZ`OfOl_=ENik*g8^kO><(XTUC<fUsgNPi!!g8Wb=5#GIQ9D
z34(wE04A@tqmgBWR;XvY9hFKME1Ex~=3#2_2QNAlySI9QsdZbK99D_@MkHpSK|_hk
zoi;goGZ0>Ri0LgwT#a&?J#J+<Bj%XH{Z{Pw0gli_)j-?lGr$5lhO36*xJ?Z#I+krJ
znKukiCv3yIA{!jv(@bSd9o)mR5M}Fq;Mh3s0l%}3Cx5$nj?gVfDl_Iss=w+&KPJ*1
zl13N)Eie=kxVKzb+KlqP=RvvVKPc&%$Crx~?6m+a>*bn&*c()$SQ0x)WXmW+@K#)J
zH>iMI@!IplZ-dFX5Xkvpg3VoQJjpfzj6u~HHx)q?c`B>qXw^q2+Pn3aO7gj_>l%x}
z3~JJ(P#=7`MqNdoA8a{^)AM=jy0`6UHTZE1g+rn6s&`^@hZk+FA`k(97rVaoLXJvJ
zwH++t%s&-EsX`>Z$$0ut9p^%8|LOTAMZSsiXQ5XtA1QOU5~UHihqzd#6Q6Pu@IuIH
z7wT6{kB%r46Ni66;Ql|OMmDYfyY)oh3O%Th){iZMu-K$^gHV@9t4kvRyzYA`=RbWp
ztZnS6?W-aRxz+A{IsHo7v`Gokb-@H1F01oC+njdCpIsO%;G(Hm+g(@pdauZpJ`i%c
zb0fBTSk>CB2Ls6+js1KMA#|y{eN5Wj2XJt99!FZN@B<v6vpUY&AJ#Oouh2`8pRJ<E
zfCq8=F;Whb&)>r?z1Hxuwu-tk9Ys+XzXvZw^!RVM6UlQej$ZG}#$ctG{F0W2pzXoh
zZej(?Eu|}mTSYR2E^R&rtFT?iBI}^<-w$gM*?r^Ya|MG%ETy01xSW?ZvJUFky4>q`
zdi@9<O4?g>=T_Knx+U~dPi}st+PvNKsz-nX_~G%2A|EF_a$xs~x|ef~dj>1Z{$Uf0
z;gxvl2BiVX?FP)>Y}em5JWA5q)ph2^<FgGmwqhNPIK@TpdPS4lEr6$rJ5^L%=ISq(
zEei)7w@Rzu8=a@^+oZ8%?U+i4ef1BrNF)*A){+5$ZM1xyoejh#v1RHX#HKB_zdf+=
z-ZTQ?fCT{Y!$|k!$Pzx#7B(xpuow~0I$m!z+^^={5JZCMWo!N0BmT&UcH{Rp@6AaT
zzc+9B`@&7@J6ASTTu2G(+Xy^zH=QiZQ0qJ$tqgpw9aTzX`B0P)vWbNAoBDZNrvi7}
zIW<xPq(mUI(B!+a#iPAbcA|o@4H8!}hI|2S{dg1@?kHR}wXON@^W>12@FW`Vi<v<N
z;q=vtn#2<5bvB)KzL2Q{CvX3pcg6*I4A<8F0~q{DEYcwHBFB9RY({-R=g!BMyPb%J
zqZ-Xi82>;gt<${^J4h86ODaRb^l%PlrbS9~1-*%+NYP5okW-cE*!Ei4z)RtLa`%~}
zX2(qJq3#DF%=oCW)Xw-1W>&^Nf1}<@tEDk{yBblqTS;nUak`J?EJr~Iifu~VXfG}2
zZ@%wrl?LJvm5<D!!S9JnCtoG`7EsJ-8_%G~GOian!k`5_mTuC0%Pd?8=k~vW)FpM)
zxk2(K0_jrJ^(9|I4@C%!BC@TlfbzH>5{NTIgU5s;eu43r++5YtsJn#WYlS8EdU&J|
z!pcWp?E3AK&C9HtSBei(<@W!KBHT-zdw$fGQ!d@21k4<s8mCy<J7$(o<sB~T^XxhG
zo23&bM_io_<irq|**r0pZG<`p*OD>ctcC*|GShA99%C9{TcV<dh@%^ZVK$~iC#WL3
zlm&BTphI>hZDAT}>WT@;w|x6&M>b&Y8k?<^OxH2$ss`@q$KcHpGGObR5Q4{NDa_V?
zSW5P`+-F~*W2QJvp{Q_g+$m`u%{m~-c%5kYaKj(pPPUY*ULXADK#cQ00g366zTl<S
z6D0>;1;YMqlf#2b#vtf@XS?Io!2K5Q)6aC5-HC8-3Oj*<r|`w;EK`%{5YdHk>@pyQ
z=IB7{@OXgA`CH}MoW&fKKAZ3Od$*yh0CdSgAj{JrZds;7``#be83&g|Cy7hNoV6^t
zXV<7!dg}Plw7fl;CEno(Lh~@?#BDeM6K}c<-rJpju$P^$t%q$?mm%9Ki~+T$$Z|s^
z%z^oE0fbzEOPQrmSJmU0F6%byT15R`AYvRrmZ_;aW>?3te{8vwR>&DD<8bEFMd~gc
zBM}(SSAssw(CSpxk>Tf5e4H%wvGl-^`GYMzT#VC;1PagKnX$Alw9iu6<7DM}k7l`n
zHf|b26mYtRO|EryfM-a<(boTs%r-Yk`K{JDWY2$#Vx6xhrlS^nxojTrxi4q3IQOM7
z>qFZ(xxuipDy?=?Nx9{@(>$L^@-jh%Ni1!d#qDR8;zSmDS*8=Fjjyasyx9Ad;O7L;
zo?OevNxm3x$YrYN*>#7{x@*`5qJjK3y*>w=evT;(M;N|Rwjs+4kyoUDWN}>byCM@(
z+JEE@F+HV%shhqfbKyf>>hn<O-{pLg4Nbt;FknD3f9K`|I5g!w^9Leb5pi3!Mk;aQ
zoyUn@Y+iE@@6fk~#y^y}6rTmUL?LX<e=j>OGtEgdx=iwBdZreYJJ(dZ+9pB45xRos
zP4>D4vgTm=m02!aGu-Uqze7Ivl#MRHR1!AvB(<#=Ae+;-n%Ho30E~Y6(WM#91#&M1
z+B=&)SejXwoJ9~o^{T@GryU<?WjXYk?>~N-JC&N)+C*K3A)dYRS%|~b0^@>?hS!ue
z^LxaDh8Bc-PwmN!`L&vt5wbjl^6*+&&-3o&<?Uo}A@g+bpb`Q)Nri{cBzqrXOe!B%
zeNk~KB0TgLbpaaNzzc{mFK^L6<k#s?kTZ7RTQ$Z#Ze~igAs(@O82qGG6@R8&z0)Lc
zp^(|sElk(qIriUHTc(>7$>PnMsnb}$A*glxGIy#c<78rXZ0>*X@^qqL*bb|%1m7|O
z$CcNT$$dO9xIN!dx2;;GGm-m|_A<aRBafes7>U{HSxarJh?>L;tk(xfUfN!N)yRE5
z{<a&Q?81M!lvmxO^n(+c2X~R#s7r!+4}+O593FeCJ&SM{&~ETo!Zc<+cR!!6jmcGr
zXR_bf>7`N`L%gYnwa#lZ0F8`k9EhD?n-rK1Fc$2RKp?IGHNsX4xDz{QT<wJ6J1|>`
z(JZBpl<KJcm|b$5d5lD!SRvSNt|uO-!(q;#Vp<>28`(G%BY~(csP|jlZsgSCtXDx)
zCM&8LyiLkDP__K=MOIriJG+KB_wBv5>R7!K3cU^Sa)<BzoCWqB4vux64{QLn7x|9`
z3F4H){Q)_la<rp|T$U`Vai-1KR;=3|sFMAUfRBt3`BNe*Ma}trN+i%@4IE>~ffP{(
zB<0dCi_AYvzuf<jSW;gQ(B;N)xt~~opq1Iv*r79sIbq!t<#(@>AS-Itd=I9{FiCRA
z7LO_@<XNRXLWQ`raeX@IrX`ZUZZ4N_>xF_H5){(99q<RPfonC7dXodHTzQ-#YifBW
z0cTm`DOtvON-<GiwzfXZvFlX42BJljB6N3e7^+NkZ10kIGR#Qi&M~-q2H7&E>=%k0
zPVT4&r@{xfav+sL{M%{;_;6QHxZNGMw49z@vaih^QayY$TEgB792T7aZS}JFY=0hs
z^VQ3Ya|wM;)qe3|#36yM?bCA-S_{nD%cOcQ#=-PT-*9jGY5CI3*_2JJz<dEZ+%Rxs
z1_RN|I!2Tn7wf>7s*K@7@ApNZ*U&J5WH!v(zw0yAjMp<Az`p}Y=mmuRNKl~$AP=uz
zy;2l)01iSxXjpq^eesYSr8Qu0Eiq32p0$N-;9ta&omHGprOgRt|43g`b5pQ-_>y#F
zmTFy0TY!A|Ui!>qdbw(1xUsa55>cbRAWU!1QaRE%lnE7ut~|fgvKJn^Uh}AP9Yb-R
zUB@&6Ij=hwTu@N5{z|(V4NwfG9@#{A(1aMfk2;@2!$4d*MnJ2>*9eLP30(;(w(&C^
z_2JXeb*^FB4VIwV8n!1tul?nR`SxG;k<5&F?M;UI=0>y-LytgWu$r4d*~GyQ0w)!Q
zRta|_Dut#_62%AC>+Pd}W6ETSt)}^kmdPQh|3ov<EBe#%sl?OEGI*_d+TL<6P+bLD
zj@E8yKHif735F=C8u|7|;i#{yD(J7n+*_*MJ8)M*Aj_?|l<eK4oHI>h#M^2HmFt;m
zR34-M>>bOZK;s^8OmK~?zdIc{jwlhmSVfkZw(sSxM<9@(N621z3Ln$t>?U-X9^Qbb
z0?(k<@uW`WD4#N!3#VUXDqDK%J8$E`2J|g2X5pl8CPlx+4W_IoeyJ}7MJUrubfP><
z!=JOLN4m-!zkN67_X2wVAEw>{tjYHc``=)&(HkM%ElQ`vC<&z$0YPMh0!pit#72jN
ziqbM{9jQnoosx=_659|^;0v3G3>e${;P3s1$AL3o2RyrXKi7R-=lMASzPhk9pstaA
zQX($q2#EMwwg$hhO&y<guPO&xhMPEnnJd{gnDyz@BheN8_ZdCuT=D~s8vB%<-%l=G
z;`PxBa0j;I<J>1y@t2wb;Er|E>VM@MAn}rFj0~?4B^=S|TDE+yVWj+eTusSkfuYC5
zo6WU1YWA-UpWN1=HaHzlx3A~7PK6XW<(1$l>t81{jr`Hw5j(fhTNO@2-<`T$+k+dZ
z@<lCG^<=H9E@XqUZ*$7rZ;CQkttv>Vm#$tL_2GU!>_%O1>GPE+v~;7!K5}!{$JufJ
zH^*0WC(5*`>ZX6pDlQL*B5VSdj0?L0=c|_;hcQ77yxrM`^onY}aQeR2Db<np8a_y^
zhm;~M6i@~`zc~kF4EZ0i^rUk>3&)OkTSlu&csC46vo|v45Vq})&#%c!xGzBgdqHRx
zyRnEnPQY<h^Jc~WoWZ;f+}h0x)cY3az8By4Gf6a!^PH}5k8^SQ$zlQc1#y@P>ko)E
zz9WaqYrl*<q&8|YFf$HLxm%m=StbdvudNZu-q9;nE~A~Sn7Pot;d@E_4wx$<K#2+>
zn(#9cPKE|t>zHTuzdmyULwEeGYT>Y_5KmzQF*`JCbX|Ub*$>@j1wwpKlJ^3!CA@4G
z2xYiD%rq^x0g^7Xq_ZS(Y+58K9a->>;vw00;2;(|*az@=&~JwPC=mB`44664Qb9=a
zlfc`+OSN0jQ(@pD#fzUVHF})|X}W$-iu-6SO=q|FW_Xrt)G@x%leOB(+(%^z>{`IT
zt;!hvTj)j_oOLwCy(aJQm1{fIF~n4^8rJpE7%!!YV{$u@rFcIFSnQj*ERZh962Ajt
z1ix&PtqK)k{+!(9hrj#z{%@o>Fp~`rD9U)G+zv>B;+5QRGfPhH*8^75fO3_B8=Vf>
zKV8)!=PN_=z_n&+-J_T`3=zI_ty<~j@(n!+Ah7q#-gU0G@B2@{*~tZnnb<|~<-EkB
z)PE}!a2iX;fjP$s{PHM@<tV4WkT}^xH&V}!T-?-`Tw9`FM_9OcvGJzuTs_U>sde3N
zr<=JmvQF_x9PZa?Zl0RlX&^j+n`-$3cN%B`0H}S~2}h<xkRzM86L2gyJp}W#qnCjq
z!o|K92nZp1opPU8{~$0p(ABtf)W!?>U4Ip*>H&H!yg|_3Nk4*4gC9P43_NRvTP4gR
zf1O<T<67^9s6I2<t7dN>Jk2{?pqkqS?&mu80s&9#CAI3oW6=LS@OQ8Yec}rRnJU$>
zTPyz2O<c6387_iOK95T_e!GkR@xd$MBI<`K9vr3i=0Q%tPhnx|^QCyvFi>2HIgD+E
z22%D#aPD-XcojpyM<MBwkbGk+Zufd@_Ei)7APd8JPHss4W7A{|8*DX{RyWMZ&%0P&
zLW8lrK4BEa6v_4dZbBujGc@&^5u<k%9vDQtBQpX63&?vY2n<q0lVyL&vMVq)d<Ut}
z@u{wTpzC+4(|>_j=YL*>6@hpgtUxa(-k`QKJiPkAlfD-Kq#pCh%h8!0V(RBPEv#=8
ztbCpeC1P@8sr0Qy{ZpdpcQ$B=$u0%7AZ-8)J}QT>-jh6MN$=!WN7&_cNmMJa<s<2-
zydeKe{SJpG^X@TB^MDB_cdnHIJ@P@0yz$>4Pe{H9GsxPL+w6<#OJWVfk#rRZgke3s
zN8j|a0X<@;BD{b7Y|x7AjfCeLX`e$dGZ&;KF`nlF9(zC$8SRL!!^MuX@0>D?kxDZZ
zhRwv=A9jYjzlgkHC|A70-X1Caex({f%{%pldssykJv{;<Z=8mgyYPHNtu*+nx2Kle
zYO<zna%5C>$z4mDgdc6~`a<cnh|?OCHCd@d-O;e{Jhkk$qCh-P#CLh}AG6PibgkvQ
zJc78UUU?k_`>>uu<M@otv9J@JLT1%upUGoZYt^a|3)=IR7kGEl-ozbzqUgbWaUw}0
zsvtr<j!ri8%`f2Ibz==6O>WbB{YcMh24d)xc3g#wF1EN7tDkjj_?u?GO*rQ*Jx&qP
zmFRvwXAh)lkU8sqLF@?I-q+UKrCwbRM-4qQZ$|)QZQwqX!mDojlcIe{CpqwR4>3*i
zgl;|pGV1m+d$vsrAuW_TIz?^7=p>s$VZuj0Qw)IzU;8!RZRD-8{;9{8)Pp;#HB44m
zM-yD%r5P+3b66&tHiM7h;p{0>73n+zpl?B4-qr0K=@%$`o=@W>7}nZOm-9V^#xl(*
zF+csr(D>mh^QtEZ&WtMBi_!K4F)+FOYN~jY1<ai$vtT>mCZD8%S^)%{O_{5Nd8UTM
zf797e9PJ_AqL3Uo-g%_L9%_4YjfKZNqyiKam=`a&0II!2yQay=Fh5vDXVy!PHfGBE
zd}W{4QE6QJdr-qHV{?%rA^j@m-BK^2^RgfQq4^`yZdqMl**oXC`<@0%$w~Mk!4&{_
zp<<I<c%MIG@wr9P)4}(~@tvZ&@`A5G1D%So2v6v#dmueDy*ysUbRHTPFXF%s27U3G
zvDNVxUO}mbvYbHmL)i<XX7xb6QOk5G#=~Xac2NguJ8dp3a=Ni)W3T1!A%{W%kymu@
zG^YaS<0|)}#b)qlO)wpyJSJhTIS%t=(w{*cfVr^N{irlvhQ3;U1v7(JKbVWr1`6Rx
zJLA7qp{I;MD+$-{SCTB<Ky5qp8spBs-HW_m+C@6q@?63iJyGh7@v9E%Dl0TLj-;_+
z5sa_NAhX|O7)7iI<k1r(!1jE3!$NukJ<XZ~<!A!Q6nmO#S6`mi>Y(G#vG9~}*n4un
zwz(F(DfWkLsfh6c@E)y9aFCc*sc8G9bC2RY+<mLokQ6zncLs#}Z`5dY5#gH8(r0;y
zq=6cYCwQCrWR;>_e2ru1DCy!1b2|tUZrksn4zi#<JL9O57@7m}G#rF!9NvY2;?AjG
zR5+Sx>$^31L*#>ZoJqH2G<Wx3=DOTkl|M-(rH~l<o%VBp!y>?qtiRRrR9EhXcZY0v
zEYP>cQBgraBpa$b+^u$~XC9T_9r2xih^zP3n6qE$Lc@?ekniDgxuE-4a^mO@2s7|L
z<n{w1H2Udqb@Fjq1)tk$S}&kn;|X^ob56PR1~{WLCxG4&8aOa#`t@XfrAgdhdiIF#
zvubTtS!@gt%Ci>TcT>})8v$f7#<B`7CRg*KfHxr#oDg1<gPRJNvL4Du_L>bNPX_X&
z?RYXWw!4&r)Im3Bk2Lw?r(_=g=X<zmB_YcC_2e6WWATUW!l}fNY1Q2qQzfN)Ga&PM
z-ukP>`)Kgm6^iO>TGHW5C1_9EWFxaU9CANJ`aB(z_58*@B&O?86G1-JH78PltuV4v
z;gqYdvEaK}tBBuBe<?iL;M;|lFyhcqFc46DE$Lw3<SbX_Pw}VC;>>yp%l5tLGah!%
zM;x>9AsLIn6fyZLfAz+04FDj4H@#$j4+}FEDUsKltn8>^Z?wHkmGfY@;1P$WGN73*
zqkBk#cek}kWV45*E=MNgFMY*x^tVCY0q#b+iO(%h0LuQzZAk9IF3}{UJEwNm-eGl|
z3VM6bqBiXmr@@53`2-eo`o1Q^n;SErCX=I1e}*UdogAm}7JpW&TWLW8g&-c%vr0Gv
z@{H7%E|_=}!5CyV?+ucEx50E)haOD5S!&+y$ul65%AWg#7C3?GjxP5PKow|mu<Y3G
z0{zbZJTacfr#>0X5o0x)eJk=j{ooqQ8(9`E7cv~PuCETTa|%!`URjUEtBi`o8gKyv
znCbC*)lv_?tfF|dfgDp-d3)u0;(2)|4+&W(;MbF#zp)<DeLnI61;>31>0U1$%!(1W
z0b>%U4DV(8W28mJ44uS>X5;Cu1|dqeT5EvzIORNp#WBwXv83aa`SVEpLYj>9khyaB
z^L?sPj$9ml1E{TKm<9!yy7C@ZU33UG4MZ{{nr*ncJtqT={;Hmkuo5l72)+MpgZ|bJ
zV&vF+WWB{m<Gxto>w~6y_TbfxF-o0+tsC0FK;ij;tcA{AIEo@W5@I#E@aVFr^tZl-
zRrKsrvB+@}n-vQSC(x*&q!1aT&lvOm_r#~|Xu1r|RtkDn$A5uwTSR`C-Jy@YcD#?>
zu@_>h3kHzpAB{k_hbOuI&aD-~t_-pa+$tWxD8V%uYVPc~Y1;bpk(`<BgSi&KPMOS3
z>6kmW%a!n_yv7a_e$CJ*9jYwpVS{!?^?S$3t4hyCxw3!>*0lXb%LWj0iIOpRZ-!#I
zHFSx{#)w5YRpBUh%@*8NYhx*?M({k|A=$hlCtPnwcT}`&;gOxd`wlrhL8|;?K&>wC
z)aU$B;`H8aQqKJ1`-HC<@(4anrFogqHmW;MtRDc^z*|+F{(=-K%Aj5c_6gkj5VW@h
z*B8C$h%da;6{`C0Ap9QxjHKYsf`kYZ5Tk%sZ*=eKFrCrh9+?8?m~zNcpQngu`~o~e
z-O9Y!qe#*z@7rj(3M^Q=jf>1J9sB*<J6Hdl-@Rdi3OUC;>Fy@WvAZ3+YyCNKQ)p#e
zdl0W?Y7YRu%6EM6<^6jX7sDH(7p$)uGu~|oOnLlin`-r7;by1gtE<J{Xl<r?rr70S
z(ZkLj40<Bw{&)aaqCgE;ypoH|dGD^W=4+04InuYG?!m}(WT$@^5(2{953hsBr%jLy
z)M2KVLBj!NgH5sU*8DO<8}OwB44*Uaj1R1(vtT#vD4AmkoQ{875!-cT-gFXd+jB(T
z)8#j`$d_tA)aTIJ$lks$P}s_5o_qMJU7F^ssjk|g<+67b6(Q!!&-B=2>PnE=#I7J6
zh?gR^-M!Xhy@&a;IzgUAN60Ufm`ofsU7}|Wv5Ip=QjN=SypygnLxA19-<?qeCjTQP
zH04^VJxiey8@8m|Zfi;Oi>RpNRL|OD&T4Ubx2kxvy3Op#(NuP?`@CM>=&v39zBes$
z_=|*nj0}E}psw*T<FBhPXzqVfA}Dw%OP*Xz`O8o+Ky2$bPL3Cu=Z(^>=^dU5Gm<e|
zZ^~wooyfA6QkDPj*7L9!Z*joDP7kkQ?JvoabQ!&R$z}>i4C@XXp}=K~?De0HHDSAQ
zli1R!cJ*$6iIz=;4=8-RS^9kEfRJlTV7KR)QO3PFQx4`r?cSwRLtfW~$kSvLp{71i
z^8tG%D^Sh8V)_iD5&|QzH<X(-f+tL67c0^?j28a;NEi=Iza|fj>t%(Rh%eJIW$kQJ
zbyY-jKoomAjpM7;K36YnB~_Xvc%@aG)}i4Uh<Xi{Z|0n&O0b1i{ydWcw~vkWzVX2>
zj_}KZ^@57dvpSHogt0KwQ1fR3vSki;>IBA8v?%kc{YV>#Ibj+E6-zK?g{&!+PtCHH
zF_M|A=*uyZQBfztR26F>hia-ysS__R6oSNh7{u(6zkg4mH5U!7_nfG+f0j8W$lv-F
zxZKQmqdd_ng2h<a>M8exUTyJgVMex=Bg1RN0P}YVd6dl<U$`Dpy-hbIz#jQfCvVAL
z&p<YG;Xbe5XHtj#kNz;KrMbS^yG7%s$jz&Q8wI$glF{{?#$KoJYL$lL26jKo3=jY4
z?whTf)&4oL05|MUgzBf4TNQcfW!4IxpLnD0RyOf!v`ar_Js0Z9vu@+$)Ek9mfa&gQ
zIXS>39CQ-q-8@a$Qw&6T!4u`rVTSmh<w=8vG?2Ps_=lqf9$G<FWOu0CUd{e%-WLxv
zOz9w>iw$+jrm8jbO-qwW<5<b>?|r6Rk`*j&ddiu5S#n)(0Q4U;Nn@G#Civ-ml-<%&
zdgrfKmxatr@?~~*yx^r*990-*=kLwZ>U8kQR`O}zx^IiHzDZ+lzk<=L*4WQ~9Ps!V
zp7k1xiF!>?`213=^E&`W7~Uo8vYl9UDb!8~(XGjkiW`|dIZk7}srcUY0)%}FC7{dB
zY2VKC8<5GzMu=SvQj?R=8W&3PjjihoyqCo9M%DoGG;y=`Ac+pe4=VI*(h}3R10vgF
z(z7%+N)Y+&?MEm|g1D^H?RMara_nb>32?LDVsarb(l_8zfbVH&YJ3S<=%M1+%hEk3
zOMBwDvl9SlU>ebEhIFdk&3dPd@C$;?8fXN|bOo*(2Ufb8M)*Y8M$_Zp_I3<Qs|A<8
z5IDZZpsf?>21$$1F#n`a8uU>+vNSSH4D9j>J%qE$XL;hZN?$q<unmwL_fHFmWZ?SZ
zLqotyvY8pl+UVY|@E_cCodN=2bL8~JTiR#8#1mB>e(63v4>_#}etj1xEKLk=6i*^a
zcT^Fl?TyGvcbF&doDrgNziUi2lk$A+c9^$>HVcM)|1zj&c=grBmN_LCG1TWGAY$l9
z7C+tjdSQN;EEfJyJpBhkl+}3J<~$PLn0U8ya^yWEt+OE1x=T5pD|sU=xSZpL!To^=
zm)xNsG;F`n%q{h)3WMK4`_B=2`1tTuS9%6+q<3UMSs|Ou=RW7un-0kJD=mq-87J$X
z>=5e4Vdt5QSZ}kgv3fezIzEX!-08FeuOjoy09(Mm-kU(4#N3kn@EK0&G*t!{;d<Nn
zKcQNmN<}w)Qj!#nY?fMg4_9pH6o0^6b+o-l!jv|to*hj)!+<<ZH~Pvt{eGPA(CVbm
zq80{w0u4lHI7`M#v208i)x4t5b#W%wK=>gp>QOY9sWj!2`WU_IoSfzaMVCh-&uBk(
z8=Foz#U0BMkziDdoN@28uVFmUCQ0o0Xqc5(7?FVFGEpWE?{JcJZMQ}Hx%6yueDUhD
zYBmYY8pBWgR}_N?l>0}d$6h7PIi3&RJ=gm^jnL07wfynT;C<wBvNHU>+_IJ4)69H-
zpEd*2Y6+20j4_ZG>=WnAd7@2HQzMIoKC>|rEAOO`)%ef!@DIuA2&<Zp86Bn*-%ZZ~
zY<nXFRQIuH0H-IrS&+Io*M-IP)+?V{cRx;#(_|21J<j-Y0b;1WcI`68@)k$-axa$*
z!)Q<KZ(qXfi8-cc&-TgF@7RD)22M(?C#!Y#3ZdH=I~E=jkByvwQqL^Xt2)SPSlN*#
zchOJ$@4s1eutrAcHV|v+&)!?!i)-U0s!t}H7G#objKmzO`A_n{jc0O$vk%A0i~Y<q
zLV^XaJfDYWbPuK<vfB8YCAZ~yUSO8%L`E9rVl$Xe&Ks+dygh_WI!i5kB!0|>A!j9G
z7m<ngeLC}q-h`J|F8Qobe65i^Y7wb!yDoQlN6izt2d(z;sh0_Nj8JAf7Qdc4YD<$a
z_pk;VBvS<6hpOi<c34Uu|CD<zp9K~H%fpXtUH@>J6vy;Xm)1<u7#<R{_Ji;kO3e((
zo^X`#^DsW&9{63nOT%U*>x{rVi;zDW=k%{wZsUy^U}lgd!Brrede~M_SsMP3+@?TT
zEux&PK6Sl0Qz+XwEas=&+;aoR`mADfcY%-~=;r=Yk-y7FeV+HL0MzLcYuM!~uYuE_
zdA%F+zYfQQq$ou)Xq4xNkz1d_eIQ0RP>eB~FCD)V?6#YAD_tUQbDbu=hLw2zjbeKI
zj%`kZ<$N$rA~w@?U!2^q(^i(t!p1aXAL1h)$+0MS>RO-7E?u}O_-=xHZBb|Tn!Noz
zO7E?Kj<WBGA*!!m?9nL~1wZ3C(FibQ81q0)-*_--d<5-rCDN$Zh__RE=F724;{cm-
zMk*|2IQS=uFLP^lhI6F^5ai&0z;v@_fTMBM^xplBB`E>ZtwdGQ@Y*FV?2!xA!j#>j
z32rh{dyCc9Wz9j<_WVCNB!NG&g}WT<De~+QGGpv{l{Y`Uc}nDB&WB#53qUg)D!WBi
z7X8OQUF)`dwHx@O?SE+%zz8=C_<ttWFR-2r5o|9HkaCj{@DRSmV7RkG|NU$IBeItf
zEZiDtOSBdp3wNDP(HF50x}FbV<8DfcO6g$*x2S=Y$IG5mpFgJ}Kj~ptp#63~*5BND
z>;e-h$PPQ%2G2;s-N5!}?l~wVcsePqfEYo#<G-cX-@!`}n$RzUDmn5`X$-2BcMW@_
zNJNl&4YR{<##@rlbn>ZIlKfyoeOZ}Tic{_WG9AzM_l4mc<$h;1tjsow`I8mv7lzh=
zYjHHw5ITLi(ZF5<&itEvL+6cEo{=C^8RNH=@<-Po842=&*SAk^s-|C)oFE=<zNbg$
z+22QQnZ3edQ|9B;>knrBOI^@k<U6r<_AJV6h#Sm8snmVtT>ipQ$-(Y05k7cc@()%V
zk{usfB*Ea-enYPUi0tTWX7VrErldr@{J&Q)t93gyQbePP)lYAd#=6W?DDdlOiDTZ=
zSv_8y{gXO}UaNK{oqBdVhN3Fm+L&u0p=Hf$(PAB98Y^|)`3=3xL(>Y$PS^HHV!Nz*
zdx<q9a%yW<GP>pVek|Ws;18+S5%B`b8rh_m+cu8sK4}-Vtc$Tx&#>Q8w^731+5Z9n
zVEGbX98KRU%H=6lxdMkK*mKT7E!-bAsP!~ht}1ef0RaN|%<b>2Z=?>wfikZQdvCaP
zi)<HiX3c#gohopi`3y2j6*#$_AwDvydZz*y`J|)wj(_h(N4BHS5Wi{;N9di0jy3Nc
zn_Fqer4BGW+YPjEPam-Mr~;;J{BU4IO{D`OoR7;cmml{kgcCixuB7LFbZfQCpG%}L
z{~TnAh()LEmmvq%^(<q{Neap9{9A4E7^#tqEtc(u-Ubd7)x@TkFs1t?boz!1I~a0_
z1s(jhA9t@~On@EAurO)FeiqH4_(1x%s~FRvoEPZct1t9!>0S5!nH0k4^^LK11Ot>?
zfU^_+zD?lWw(g0KU&h#e`!77jbRs&|4Szl-{(3@ZlDf$)Ga{^z=g8Rl_B1*piu+Rb
zCv>U_3Us)C@Umo6g1dh8zaY97XA{d(AXkHE2aS<!KoH4)K;uSNM~?k99Bei68=+?w
zWfZ3VDn8>Uw!4qjAcYE6EA^bbCLW~D)lkGkD#?9joui}vuzBCA`npszm3GX}+(uCO
zHrQQPt@hvWY)0<&Py(AeE3eTbBRejrVRzotB!QehE-9(fHepk7Se@=X3HcJ9t?~OG
zD#ukKTc4m<WA$<VcNElGr+GA5w0<VN_-c1EsTH4yn6Q7)E;Cc^XuoTND)HT*X&;fg
z!tzeco_XlyS}qxs)?sy>xpIlBXd3JmSzEGb#?<d=*q!G)+sGUAB#f28*`1og%gk0u
zMwaE$cj){f;>BVtvB21B4v;%B2>?b!%a6bAeHfup6!I8ftz4RGF^dRFo`>LmYmbdr
z(NNhDi*>tQV%s;&gL8pZ0Gzr#eT>q(hs~WG)%3>S83EM$rt0GbL)_Uox`KRiyM<H!
zCK~zwt)m?ZfE7M&8~htKjwd=hIevr<kZL_)jUSc}xUFqY1;}PY4IR*bjgQaG0S;A`
z6S0t(y)|Y~qucGcCX83|yc3O%X2COkl>5w8gHB7iJuj-OHNcs*Cxyx=$Wne5Yn2P5
zI$!7O)c%$5sA*wRSq3p8z`=)=!DGyBPqnEd5X(O##zUIEexk}gXn1YUp!4t(nl##P
zM!9u9G<%T>Pd;l>@ro{J6EAC<*B%+q%49;9i{1gDzFAOHn%)KbhZ%$AF3jC{eV+#P
zRKnCv-Y+Sjn}CpkRq34KCh(XUh@8D!5+;Wy6tVq$$?-Oo-F@0DvE>JyrHQ>|yJHKv
z%>ch-u=nqc)fY`YN99{sSc0gi-_g(4FAYiCj;UkspN(Bedz2&b;9K!*E|teisHRri
zZwz^7iJcPbD0vp*(e!#ioK6rXDCvr`Z!u@x_(RW53x-x2?td)|T`1$rD$-92jdTbc
zBGQ@atu#pKg(=OVsSd#WhG&MpPfz?F_BzODQ3m1smm=3H<{!}=weAO0%v=k5;VE*%
zFat&HIO%md@k3JT=JX$X0*xTmQ03@t77;$88$4R$LbXwJshqgpDs5&?Z{KSR*x*!P
z)c<;);$CM!ccbp1NufOLTYJeQ$a;H{NPp{Y+o$XMiU7r>>+`V_b!UGDncnl0ODgsp
zksnwpnQM{9|GKv1+#5{?gEKCik^;`E|C>dkfqN3eD!t;u((xwrZ#O~=B_{dOlOy96
z7PndP4<>bK=;M__xgs!f^aM+%7OIlMOaj5#H38d!ODq2^>EKmOL3JKp|DB&X{lv`0
zbulV!Ya`Dm*}$+&0-p2hW9K>duQ5NR`j-;8z{9X)lT(t}0iUt7-|L4)mB!7X&boy;
zfyu(V+sK4aGnE9My-_cCx++Gw%+t@hgH)*UDd*IuvxKB=A|&xLthj!Arcg&a?)P%P
z8$y0!00yy6j+qusc}@nskZ1Vd7tkRxB=dafEW=o0UPjb)oAfJtE{U7E>BJ)bP?&Jq
znfBb>1ocL^U+4ft^$|knP@~5z-J|v8!@6_ho$8<$mW>DYU5B@3IfIWVr%S5?885Qy
zN|Le=w<r4+H2ff{_P=SOuME2e^$1vy6aU2*<Nq$1Wjc))*r>a{x3(LeFD$|1fJCLu
z?dU<Tqgg}2HE7rA538GY!Q(w?N*l|8l&{PB?G!@ZCdGfgXbd*Dd|jX;)jE#isTkP`
zz$sXSDC}FB2k0eXA+^^rbY_KXB=1yX?^KJpqmwD}9i$fmPanpA|F}iDwopuwBiPCm
zGeB*AQFpOpblIj!G;I2>ef#jR?Y2IVpQzG0XjN5bq|+m>amT(=H+W=AMCV%2-42T4
zM;=1wLLtXgrHIviM?#{EPMec?KdxvmRW$qw)qc87M1K!o-u(7pTK@P4+{1S#2bteE
z8v^9iX!^+lH@PRbfyFcq&^w52mRNB?c`7>_%I#ogy1jn4(!w9#E1(q1=RRVj#D~?I
z;ba9THg=tAa@8jin@k&kVibD(c{NpW0UN*<O#?*}zTDhdDYMVJF)Gmvh7C1k2cO_v
z3YKCCTFHjQ@?|dNPLmXL19hRjFMvAfSSd#Y6f#8;k;7Is%im5g{hrpl4Iq7(G*p!?
z74`-1)r|?TMXC0m&N@|&_()b!(J9!bgc+;9nGqSEwiF5e=E?q1PeXV^C9;70LeMq;
z8a)+KkZ3{}N2(+@*mKHAcZ1<h%P*(JCXIDnUeqsAr4T$_^z#ukIE-?wi0Qw011s|~
zAf&)F6QqtlXl$R2SxIa6@SYh&Oa;22P{gQGmXhh<OX>*9Nqo@21lQgCuA%kIB1(7a
z7lCgB)|n7Ba_4qL?Lft<$XVHC5JwU#*kFY<WunyY>_Gntl|fa;<}*Xk_6p6tBh`dg
z{zUZVZ0KMPbN#9Hu+<KzF1Ggs#i_JM?Q(IU&8;xi4ob)pV{f+>>BWW2-X?0OYi);e
zT*k|Y31JqOI!5Z)S;=-*-?!f2?LT}EzA*(*or&&q@`@ATL#e6|t<l=OqmDn5tv%q&
zmCmv8p0M_5_@b4z))F-+wnbGuuDojPBgItq{om#13SKqM-yUkQCfgCp+*Hv$6HEc$
z*=}5GKBs&r?u!SU@JgZr#?z)CucwSX8GlfOpW@4}g2#+>_%hY5Y^ILNv!1&jhwgcI
zB`|@t_d5t9-aTjhHGL?Ced{v6eU|B)IY^Q?AgNiO^)hBxnIzJV?VLMr`MXXzr^nsk
zydGmqIv>`iWj%5Fdt-ukva+P9azIaGP@k{qTX1ufQgei&y5lg{^&Bw-onZH*-}wnk
zoL-oKNw`|bWsbLRp62d#*Q)%5|E)bm<<VVk1T<F96|htrzN>p8&p&@C(kSVCN;-SX
zEF@9buA%p#5-=^!T9^SyQZ4~8w1ISp{+s?q_7m;(S^srDWX@8;Xia`U0>;nSMw)<w
zYydd=?XTCCKaXm0i4op!ax0dmrYK^-XPfdWXQd$0#5x~Bvu<txxAH;@o=Wcb|Ej&6
zy(IC(b3YQg93&E$Vpf)Uk7q^ycL&~p3-{bY(|0u)8=nUAp%bwPhe6EC9JzkcTg~b>
zg^J#c*8T-2$Gg^A(0BimTpQ%|#=Dj(jZ5AwpU#%Lj3rCdbgs;XyYeJ6b*9**qMIqq
zTx;B{<~QF`yluR5=Pk++;-K_v-0d=Od>l1DGIa3%qjhzz<x4N6bk%lA7YL6&uE60V
znu%Gb?0X1$XAAr}CyLHOIes0C!zNC7&hnzH9JlC$DK0QdVJ_I2q@o~qYh@J*{&)gP
zHAgr@TB9fRW=35LQKDbnS@`?>3^v^DyE0m;rGJldk`($yX*OlPQYgeUycdu46m{pl
zun&xuu_7b2w@VKItr*Y+U<Ku617Il20U!1f_*-S3>Z*;5f|3(FQL_U(-BIX7c0hBr
zwgUhJ4J^Bi6?=(9HNcu46p%g<ZEXM0IH&??J1b&BrxOW+2ISXNtKmhkSYc;N?#s0s
zo2&r@uSYg&S=t{>tDvO>cs|UH?}yb_X8HvTZX#z{b)X|jAYG9G&_F<nBv?EdZ@Eo{
z!qP4EhZxw4734^CW<(N<Eqy{2ckNGdQWX_cB>GfugcgX|&Oj5-GcXOJqqj33=0=-F
z!S+6H)7NM!&jiJv?<9%Aq|o2eW91bvk9|BRBz37jMic)=jYw~8>h0aW-js*jc#Z_3
zv&Z|RtQWp<+!^^rvi=*s^Jz35ao>^y?i|Ie<$3-Cqfo8vH>&3*97<Lds!_huq|1pd
zO=QHU;<KVFkI1f)f(VU`o(x^07ZCpFtaaCKvHmeM6p*c#{WHn0EPB|}ST!*@mDLNz
zA<_-2A=4<W0C!2ZJqE*-Rj1i}vIN%A3|A@6KNXHTee+q&bPn2x0te^v^eOOsEDsA6
zS8_%h=@lnP2z*{J|5q%~q)lTj1cC<u#VI>IG3(#UvQLvIi@IENToAH((enZWQ~9%6
za6o4&@e!k(s>*%j9=Nx^Utg2w^iHL-oB>qI@@-QexkoYp0YiQ>5LbSz?)yjEhwXI_
zf5I20XQgJp?CCh99W}BSBWA<22f@<z8eDT<;=M#~Z6hTvnDE?I5i&v3K^TyQZEuH>
z<mS1?-ki^hiJ-)ASp&4H4hZX#HXPF1t$WfL<(s}*GiKeGO9};R9<<&#{CVcy+;)-^
ze;u%pkcn|C*TL0YPfwG~ydL%&KOcX4M6y?>)}EA%mRu73WTo3$PTY=O)1XS@!+li1
z-{$>wvR;SMd*^wb=Db=|$L_8cE3)0AoErKg!t_U`1+3HZMxHXZn-Q{&*a>jAS#TNn
zwGi@SGyso%b{X*D7iMfHM~3p(2(A&qacgaz9&LV4l4jM$QzWhsqOtgahw$jPROzjs
zu)`K1%e#z5z12?~4|^ZBR2rM&>aT{UlB_-iHy#GPh8G3jY_wKMu?7j2Y&6qpXd3$u
zG+>3my}MfvfCaVd>N4i-0qHQ#XD_J;qO#!RZU3*vlPDl$Z3)_6<Za#`19IOhO~Qgt
zj}wh#cqxh*>7SQUL3kuoga3S{4?UbB8zi^G@Cv`sc)pWOru!$M%{VvCVc~<I{_RZ(
zC<p~o(+qu#Ew*$`Yy?BBmz8e?M0O@F+qB_lmy(R-@tI%mQtoR)>Clos$J)m;(Zw4n
z&kpqE$puT-D2{nK5^B3K?si8XMu{FK;;<yvA8S;0VT`${0fUr8A(q4sf^&}(bI%a@
zQ_Uf@jC7T2;vQYX?1JAInJ~G3g6GAKBB0yLu&&gmR&USI?KaPlF7?5WGSFD%J<0<k
zN04-dgi)D+a0B{<9P+4!ljIo)=h7&bAvgN%-%=B#PQxb#1+5#8CIo=TwsBJFlKR=H
z(3gp$b}Zu8n#}Pjxg4>-o8mgX+u$FQz{q?_GeO`@mC;A!|M48Ik~@3`2<M@x7_n<u
z==DV27UTRYe04?5Zd1PZHc=usa8olrZm|8`(rB!S`pXdahc74hm9+LAS8Al~qbcd*
z-?!>rGEO`DN44OlTz-6i8?EG&*_pICZy^oUVULAR{4eYCUz_xQ5oeSfVArE$_nO;Q
zIm=89u`D5<_@A)?GyNJx(8URp?;d|(u^Z^~d4gJGjXyW#RS(2Q(XRHMx$1#^D0Qv|
zpEDW-(5F;NzA`p@ZjXDr?r^dX({u)$H0UJE{nT~nNygsU$?x%s_aSuJvLR)^5Og<y
z<yJB_5Bry$7HMz8h|+qVJ{^{+3d#hj3hS%Eukb+^91_<5Odm$E9==RFitK!G=9btc
zvk8_?&jg5lcktv=fE)EZu;6HjMMx=4nyib(yaTKCQeg1Gi#TOvTsdNm$hCbv(c)#f
z><`Z;;76k3hou_K@Wm^${k+51tSl!jtQ{#}cswMrDs9y`vWKymCS$e4;Ok1kK!5N$
z)xkFof;m^c$k)rfAD(m+jG<3!gH$2X82J0U2g4i2x8+$yQK^hoJ(+wYmfFkF#t@j4
zIEX=jaoR5(!UdHGMR78D3ca`<ifdZ(08%KQURKqHFmBup!NNQf{)Q)WZf!+ZYeea;
z`f5jI>6}Q`%uwGC%i5sk-zA2jwHfQ1@X-30Gds))q!&?yMrayWa?X0Nn#>{p$|wJk
zuSL7jp%QGdilTyd4&p<Jmhq}E<CtZ&5o7=DA3XB%MgQ$Yzg)rVL{-jc8X>j>gCj%b
zza!nd)W|c)FQw+(ohpu_XSNX+JO>JJhs!d&Za9*f>#3d!n={<Da)5MSmD@0EOGZAw
zc!qGgZW{;ar&;ml8s~M%e2A}Xt$*zL07Yy_h@)?hGB@BxN+19BPHx)Q;F_ISg_G-)
z%aT)SDE#K=+YCB=TAuwdS%!bz;Qy^a{{3O_xT^pRQBuFxb{PaQZLhD>$XvLwz4V?Y
zP$J#VzXOYZ-=LoF>3T&R*whbxR0Skg7zXs-!wEf|e)S{C#Oa!d=__;+Jk_tZf^VnG
z@9fY1WlvjS)4`FD!uH8f*prPkp@YAjP<W-Pg`8ox>{H9Fk6oB^Ait#{{Tj;-kazgT
z-@cn1nZ0x*IFSLO*z>&+74UKKxt+Xe!4_V2V{}uhE=dGPZ-ol#)x}5R@f=3XA~eY;
zU~xq#D?eLT<{tw^ew~*jA2=|h)XBn~5EV&zy|&PKS8B`>d*V;S&t`wKcEr2VlcB~^
zG?3Lk8`F*4IG$7iCW$0yp-4kE7XsDE0C?+Fwf)<zSxD8LeT7!8+}ug1->L_>Wud|;
zgr1=AoHh}><CQO$v{EE~sRUBuu^1&l@HiOFx}=<x+oN+ibwjV{=y#7*S+hxR)7K6@
z_hqe`^pWJi>^sD`IeG?7+HDzRjJ(%Yr+bpAVQb=#O8qyLeoxVgNPp{v@3j(KB<UIk
zN=KEn|3p}%n<-il;@8>sF&X+$)NGlS!md?!<;#cwSGNIwN0&~753g#l{_5r~$<=_t
zw~cDhnMYcF!zaO9a`+!e2}O2;^h=KM_utw1v20v!{emYX0)m~3T__lx8$a3fsm5AD
zup?kuqug)nZX9xpTi4@myx(Y|PtYt&ZsYk?6487+$}d7uBwwckXsoai`ZRVA_Q;U+
z+UjLdI$gm9tPyTTjrm~Ly+wynj2}C-Z^-7vq$Av_{_%UT0ygGhuQ&hyD@=_F)C)vC
zE+E0YDMJmiUM2@1=Wy+|H|@A_yH~nQjF{vAb;6sDR4~kxcv)G)T1Sj6;}1XAXaifm
z%4c_^VTE~(E++aehHJX^>g}R!D&wZZ!7P_)&0exxsHU1#{42(CR#1armQi~GVy1(l
z^flV-XZ#PHJ^S8^o^ZHk?kbFj!i}4c#PjlG`7WyvO=Sx$7NFFb_<M|)Qs6sHcUQds
zs3gxCunDo>8!sYLE_|*nyuy<5BLATWm<+zC9H`BmDUeFOAbeTuCYl77Zu&!fxWWM8
zYCHSie-~O&Q~@wV;A|5&$2&R$dKjX*{qr{M4&m2lIu!IHByCgI%TxpgVt-BOVU4xE
z-wEFre=u;y7o(RnV%4e4`_k8#L4(UkS%5o%RgVA8smkg0C5${q6B3`g%oyRaZ+`i9
zWRB&ttAh9%%7)_!sLk5CfjXs~<tOt+xx|1rj<YZKZl@Q-N^;bzJRm%ZihKh<O|0m*
zO-Kym8-2<Au5K9mS4VI>i!}1_EF4aZKBqdg`z(^sw^+nZx%fq!J2Il6PA+A|x$@-R
z=<=&^CL@uVWr?(W68BqMV|{Hku&{IE96AC8AlBO1<c!Y9-xB#64Pj1i2>$LD>&J{_
zX`dAf&Ikc3cYW?PTvFfO*{lBUM;{`*X{O%c5jR{*5;>@@-|_4SPgt1-o`hS2L&($g
z@8-lx_R>x>E1G=we6NFTXGSH*J^DT+OEM*thhvJ1y!Bb1t(6wISl2QR9GAk|&rO#<
zS0j(~iUTcy+y74=eVBzxwFa75y%A`{C{H*pFQdv~iX&cq{st7+dhq4<)J>17?C6tS
zmVLII6$FrR@J$tF#(1{3M#gN(Wt6Z+KsyQ=J(7_I36`=JM)N@>$GD3Vvb$#v9=x$u
z=X<&c*-+`AfkUC-bZ}`PUJ9eXm5}#}KjOzYCEs}3eH&Au+p~!s5o>@L{2K3MiXsc&
zpfCt9fpCny7Wop~F8U<Ii5nfr0Us3R7qdjZ_UTeYnQ-b4DxC`bRh%&Zk%VJ4h5CDb
ztpgqUl@5p`;uhQFC`nEJl$!kM=kWwYyoNHxlx@H)lR;%xm|#!avD8Xf%nuD8|4$3k
z$zU~K^j6~o<Dm6vID^VmNcXd6{l1Zh9WQJ<-4n&+4qmc*f)Qlv)8>T&=Uk0nwBQtY
z^BokGaUB@G3zu&Wa!INfG2M5?!^X=jH(5;}SBR3FF&ksX4h$~F@w*b!AIanD6d34K
zVkOvQ>Id}mP<_eh8)KovIVpMC8V1=*a`)~E6UM}Y92h=b6!SA4?T=M&T4C%s;*FZy
z&iV<55Z{b^JE5GlhsYH|zM*W6C&&83iy0x?Id6RgyVwTmkyBwi=|4R0gce@lZMq6G
zYWaDWQcNzXwtvtyOl(_xo;tpaYi?Btwh8O;!`GZ)y&MvDUfnECG9hnCCsd`0m-I?c
zAEP-sXSf=}Mm4~c=lpt-x1dqCZ;EP{AC0no((l2lme}*4>o07E|E-ZX5t81Sl7~ER
zX*)Tmfopj(H?B3B8$<bMdozZDy|>=-rVh|&{cEK1A|G=%<w$2#S5zP~hfdkA<knYo
z2X|2R09GTg8~!`ElRW^3)RB0vXGZO^`9i=2WXt6KNmH(^mb?PD?j{+*HpK?)ks(<N
zR~2s?K)hM|HT~tKqO7P=UQP*5mYDUcW-U9NmmucGJhLNmm`Af>#Ceuw6qdlEuN1!X
z6rb`K3C{hqvgFH9ijmI>OErNhQ46j3^qTmEity^4%&Zbdr<g&Pi1#=w4Mf0Mt_~wk
z65>u62&)Y^O(oe>GTodlj9K>8;Y<TNkIU<o5D6KWk;6mrc(uIZlo|q9ieh-?i%r+J
zhn*@WUu@tUN#e3L8Cw#7n5G?6?IRP3UrW+b+G)gdr2lSFMDBn+ncxE)oflOD@?0pI
zmB>*%nDzBb3RE|xY6S_2Evfw5sqFt3liWy3e4U_H33Q0fB$8@9Iiug%o9ijCwI!YA
zm_@s?35Aw7?I(7^0vQpKcey_oG(ubA!6Y#Lj0^|@YXWtgBa~``Mx%^u5@otNds&`>
zO4WLNoUprUx8hAi81anD1R-;1(N~z5pUVqKNzR@pbm>gN4k|HfB6+!xS6#?V&HDy3
z#Sv2y4{bu}3Q;aTHT%9ln0o?|3u1l8EkdL0moTXxY_vxODF;hqz_t7UL61@VUO}}r
zgS7?NWmtd-rA9{#aFj6#l~PZ*6s6to6&huH)pJ)dr7sN|%XbMTR*ZI!sTkoBV6va;
z{R<V*zBriD#Ym#PHK%!S#;~;gvD?Ui2OAi%5~g}j6o_-YASzV_uyxSIw!gz`dQa2?
zJTjnrYzx@z-npvFUrrfM$Ulf2Pn!@s8~7}i26&P-+zRah30(%<W&$<jwCr>R7%4j?
zFQ9kOfOqkD<*_s+Vi}RAjo|u<lo8$wi@+J7TDssKV7N@a3wYQGEYc$dF-Hq$D}fD@
zdw9C)QYm2823*Nbfafg3p%)1zJz|Lz3a6*O?yn~=L<_xllcel+VMaDc*mc8G4@ebs
z@)nKP0sM~<L1#YI4}@KG@@!H4Km82#BE$PHUsnu)O8MqPr6grL;Or2SK~t&AUQ+oh
z%vUIoat2i;!%OA4o+#l`22aLLzdg9b@n6ObDvu0L#fZsgYN`u~_r|k$A}zI`pGRZ+
zR_mI_uq^vkAQKA?iP_=tHbCLWkjWuW`Sj;08`Oef1ZJ<yyu<+K3LT<Vxbt1(F@W3~
z2m9hxvS&eH7I*$)p1VhTTsb7D+ebgwP~EbM-d)2k?cFEw=tO=}TJpEe`G+u%>j3G5
z?HbD^DbKbkmx5uI(7i>=#5U6;nNNH!`)E4xbfP@=7A5+c@7XMr(QnJF*8OTLwh%wp
z`OB()UCyqB7G1uism1Fq?aBzhh=VSpPJJ-&A(7jk=j~acEqsE#f*Cc<tbRQ*Lo}sk
zq2d$1j*X{wp~OhJ`DB~i2Edvm3!<4BsIarH2XE&*F2SR`bU@MvTPgHbKrr5BW8+<T
zIQcpg7{-`V6m*>MLdVs}ajm2au(qH7MfWBHsx6+%?R1Bvbp0fTo4DgmD3+yoypJc5
zKU<L|Bj6V`&+Aa-9SeM&<+S`cNee*>ue#Oa%nd+7vZ+{t1Y!u&tLyE5Ojq0k(ggA=
zJY?!?y0xlYs(iu&O(_qjn;v_xb6ky;J$nX+(n&l&vfF!>tnv8@&!Mr{Lo+N7#ZvVi
zWAWF}eisQUpGl4dCy>Z|pBch`+oa)Tgv%0ZuuHwOM(XDHE|5=PmH!}2kJ-i8blrpj
zp9gRiSP}S*g+g(jVXCav@k^->k?-_`YwQ~~E+O#xSE?W#!R>c;2sUZ?=NX{@Z8w=!
zT-QXQM*_N}TcaW>q9p6myFZh#Bv?NL8P}-s1VMjP-L9b6<9>mHX$Mqay`pDqA=;}P
zHy5u;?eAa~2+=z<p18W+?=0M(UWG3<UfY*ul+R)>gZ)TVOE*H?7xK99=W)xR_nW%$
z6a(;o9%Hqf!wYs@Ti0zOKUIag&U?f+9o?+2ibrbUHr!9*Wfl^|(bSj@l9T8&<>}3@
z!p&=0Ok7JmU!P`<>p#AvgRwaIt)L^tJ$A)-NnX)zM}cZ=d3=8$i^a0WKRP}QQ;&9>
zX;K%2#t9>khT`0)ZSIL6`i4|4MU~|MH^V|mHpA{N^|s5Gm$5WJ59m};)J}UW_hwkA
z*OMK5u6Ae+xjnZHcxC;LPiJf0OkaR!-zadZhF8~nR0w}`(F!*WmE)}=o4@hm>hxw|
z=}YvrU!%$4Dx6SSK{W+V6g!`k!GIpuLlsd1o6-H*QM!;Il7dw#%s(URM%2PBr`06u
z4*n!M{1%ydJU8g_s^W#2KMjd154n0OpMd$zIt7l_K(U5DV|o*iYMj+K5n2DnSj@Ps
zMSQrwjr+EVTH}VG?;dKU)|thLZPT-+xP@{WvpByCKiy9NW=rkLk6@O|)&rDIhu3Gb
z@hzPg>1C}1knNbX03#@r(ymqL+^)aP;xm+hvAkeoS>_w>KVomh;u=A6YGaF4QMCcW
z5Rin`&7@@mgM|d0@BFw;B|3I}Vm7)}<@fnJD$Z}3eZzSu<5;US$$QyS)~I4Jjs7XY
zHzNWfMvS|S7rS1mMXhU3c>lcSd-2jQaC2UIl<nUk!KEK_#@;m^6r}|3{ZQJUw1)zn
zCnG2w0!+36?vGK6_2kRvhwk#k)jnQK+2yCzrg;79LX+9B5a_HTP;ZVCb&~*X2f>EH
zY3S)pYMPgdk6RMGD{1WZ{=w?>)npP=#fDZZ9qO`g*SvV)ig&FScI>AjY2=`na@^jb
z=<c5Z5R?(%FOl6*VcYb)SG2_0-&_E1BzbGUJ`Y~120f4r<GR-so`@ioq}>pw$B-Fg
z<+j&6hwFS?nHnO5H(_$Pn-+fAtp-+AochS=Ykus^9i;p~*TQdm7LcoVL-&lM6F5iA
zr;5?6;g=K?GyL+H9Lr@~IQ50%>yUn$xYc_EAxRPU^IsSF4M=~t1;`}`e$l<6XV6@P
zoa|JX$XDMYAqibx1DH$3x`iC?#210qrq5;wf?#6e>*ibtO3O4gvJzDQ(B_xdwd~q>
z!=yt`1fE-*!!LzG{m7+!Gkyv#(UsZ)dw1aU#%O3?AYaUT+t53Hlos=k>b+-H;NmO}
z0_X_np5G$}AnUY6gNlB<|Fm3n-o*F<p4gG0<w6#8yZ6vd{aLKJty7S6P5S6M>@NE0
zey#@5U<|U<I73aV-s{##|EgJFb$2@&Lh~6n)7bWBm?QCjZF{g%L{@Pkdh5AHD-y$p
zWwf4<*~t44mwwBotlSO)r+GmwW7WC1#%`?VPPXn1Nr5)qat>OCu$awRWzn!<4_mtP
z7y8iX+1?>%4>_LcR*MlEl;(P<KgpZQXPm7h5@EvsTsnJ6E(Qs?epxu8*EsStiKRVe
z92=%HGYK?OLV$*bcELWq|KKVo{nIj&y**(B)&bt0qMhunY}q&+xa@oWMFGhR%aA{J
zY?F??ttovuCs|?q{>w|iSrpZ>K`^okzZ7@L>V6r3f9d8Fakqf|9RpAvk;$rFSlHFi
zU8%7Kul}`nr6JiliLpKkHC>j8554L4rrWe*lE8dUE7!J1xx$^Ew*%@9fH3<<g}z1=
zfJBGNl4K=+L)G-p$CSp6kYy7PD_vb1RLy()y*ayA-#)Z<h27h`c}|#=(ao*G%}XWM
zdDA>kO&=0D%%b#ub+WrWy2renE@(!UZ(;rx-_rE)hNXoUq5EglW&$MiKf^_3ZS?2v
zW_p*iiweU>rv3X*<caTJh_@fb8Og}H;ijL-<ffQPPwJCZ&tDbHN}+vd$z2kk=x!d3
z*#KLvMER|~(3}<0t4S;~Ng8>U_+JDEglC^OvM*||`&Q<^xOSF#_UK2fNKO@8r5#@a
z`?-5$0LtradUqPvuHt6x*JfVta$&AFeNsJgo<4*~94a;YER@H3T!azD;Z3(e7i?bv
zK&qbHf(WCUgE@LvD$htBol-!&UX+{V1_)xWHgpFE(nsk$ME-QDq|<s@${iXnPE}}#
zXXkH;l8IZ=^r6T>7++||^Ms({la?jR^X3r%&8G9j`rnwfBmp(`8ZXKdzgQiNlC6dW
zvX2_l1fXhN=3M60Y*z(o?BW_3OQXSyvOD<91s7)VQ2Lr9nHP;Ty$hJ<#ekQd)Qu7N
z7Ct(PuiBK|^agk&1&g<zkj2xrocx{PoFW2PBzBCv)|opYPMkR%@TA9u^SD|7%xG{<
zC4~D4GrwwRsdp%a?-m*AeeP0Oz?oJc@UcU|g@FUmcM5d?$~#LVwkApWPRW4vnC{EB
zM0N3Z_S4d!mSm@D&kHGDVGK7D?MV-m--&BGG$$*ok%bh?o91@AFZ-S{d74)^F$it*
z#YR_)hVtmhuhAqwb1uK%ourykuihyy-b(@<R_p!l`Fj94`tM<}C9nBMr!Xg!Q(7pC
zptcD;oK7096%<X?;WHGcWG&i&eV3W7d8SsBW=k3*H&UOs%M00%6uhQD&c%TkIzK(?
zZPLd#1iKyf1LBK%APvK9z2!SG{v@s*M`i$UAx_xKDI`F@WVj97paG<ghyxSvH-9d2
zRGru_j|}>W??^It(7@ZS9O>S8cCc)CAW)2z00bd2{7LwawA>x7BHRpt10cWy?p09M
zQuqRzARUM9O6zv53QzA_qdX9tBA&1@{uqEews*%TA4A>7D1dSk<SVpsZ;^Gevo7#@
zNC)wI7sj$qD8OmKJ_Au*kIKV6)s-Ssnn}Zx`@49eze2BPcXNRI`BbJ<d9H(h5{m=2
z<s$l#R#2PC$$EEbyZY*Sa*;<;M|iIq2Cbd{@>&b0Co})X|Hk6G8vJ<&JUPCJcQ<zF
z$aESDspu>|r3n3LGdkASqM-F~-Oue&^e;cuw6lbT(Q6wCiJN=lV+0Dd`xPJI<Su|i
zVsp-(+(lE$niQ)mruEMAhKIVQc_s@9>ZNX$FFYQb8{<mfL1`MCb;02%nYs3lsqzLm
zt!E}|K_*{|b_lG-Mu&yhn@R0KpA>r7KGsJ)A#}Z4w2X-mZrG$(T7A4(PqBBaa>)<}
z%rVx19g7vfy%EV|Bw<nU1V9G0)MQo#;I>*Q2h;UVPM5;9&1vi$GU}#0p?e*`Nh4N2
z-(7Ob$;r8*D*;zuTDqN%Vus*IB{j5=eX2r7&K`ZYho`2v-!SWND$K371CHRw6|=Ur
zJ-(Vc4_P{ISVEo59O5!u+S#AZ1%xWt{|Vugr6IO;i7c^-sTcKT&>wepx-8@eBY~sR
z{vn&L@zzSs64f%j+xc~`f<4|oiHjNX+kU9Hf~Co=kbbzx*Yh?SbwJ0C&z7ocT*e~Z
z!^4wDl(Zjae08GwF{ZWtgift>7zw|BLe!)ApAlI?IN@p#X(Nrf(;svhKUTX2z`9q!
z1|yV_XB9piQw_jXqJG)SfUcdW0HBws<mmQ_Vj>Fu+!ffCdtrc?x+X*J3lW(&%nyX(
z<yTPJE1U}8u+aBrT$#A)`iyBbfpxmR>i;nI)?rQk|Ns9+4x~GzOF^Y1q)R|SLLDF=
z9TJk#u#Fx{ii9)<=q4p1DLFtIl@O^h5EKwLLWYd(dw9J+*YEEi7k}*H0xotq=XoCI
z@w`87w+CiGDUa=$X|V)|L;FN)xX><TMF6ESeK)(b#9Zcf*tFlzTpgKX6*T+f;PWj7
z0a44kif3iY#(quty=6vMi6l>7Aj>77sDW{>iDVORP(ezg-jIQV@{70*+bj!aG`Mi*
zo#Bc(D2?)LnL;5^*qEre?Xj%(mlyiY{9ccdWa8yMFLR%2Ek9I1x%Y2rpfJR8_GR7?
zM1*C>lakiR!deu-PuxV;SiNR>?z0dEAj4wKrUArGjnoUMquk>GO$tTV;Qeqc+i8hm
zB$$&_EJ2O|j0TftLs|~syO0<h$)p!hqt&GWzo_#jYDxS-;czXg!*5g`@&41104X8~
z7*3gn0y2SE2`JPaRR>Ue001Hx&fK--oS$8>5+k1sp#5`Ch{^EFP}@P<`!-G9i;#Yt
zmQ5fRniJ?DiUoqf-e;jVSh6cM^A*nS#Sx#=kCY^Q4o2wP-+59s@VzFgOw7<aTCk4H
zb?7@;3b3+x$C?0cJXn4DJ(Aj)U|{$m{B!~{S3fdD;bic<>c2|;^06%zwIe_m^*)I$
zE8@pS-qdfL0W|6HRZ-a>r_M59cTNo?2Dcsf1F+Aq-OlH;u0oG~3lwOsSOUknSA#l(
zsf12fNqA%fi^?3TiW5iLV16q~DS7lNS^kZ<WsbY=+gWpjnvuaBzWgdhpxx}aA?GA5
z4ixzPhxVw7c|`GM7CbB5_V>SCV*329{mHaV1VIFN0$^j`_oDKpd|7*P`7X?wQILYU
z!AYy+GE-KGW9yJbUBQXn5SrPZzjhpi$eh&p>gISuocjg+&+&f0=YJ!ZA_@y??WetC
zDT{t3C1kN!J`OZa8sP6tyE$?`E|d-f1n`=9=Fa|GrTcs3z?ABLPpup4Jp(Y9Cbhje
z^cmo@;pk+ff&r$SI?7->8KT_z->qs3GL|5i1kMn`FP(WUF1AyMH1fBy-tWQj_ps*^
zjUCez1$EHNkZC}US9fOg8U%tON$-V(gzODpzIp52W8OiMr4g?)S$4*m13kskQnH+D
z-}GaS6VodlM3~?`_`gi2QO0k`jwwAGUZYwF^%3J|IPur7;Z>ffqQ!E~Gp&5h;$lQ!
zR$cYKSqkrM{V?nFk7D|ugGQq_7TBD!t#>!O*aDe<5j0S>K{H^9Dl8=)P9iC7EB9l&
zi%^)hzQ<I~k75Q6O2RnF?=MhBtf4s1b<sM`{ae>bJS*+*=oE&!Rlr&1Sa+r(B!dC*
z61rXcRzhUaN+y$T)hG25PHi=nG!f{urx$-%`GB7B<u%&zaro6I2&d+(vX~)+lWo~C
zc2KwV<+F(rzB2ZSS*fr+DAaY7MspQEMtS`4Pb2kj+gtLu&|2UM{!g*8!gyxmrO?sT
zob|?GhR6T@yZVnwqzw!uzp3Q^7>`7s?-X(XnxhUw^RMnXvf#hAQV-%33iSchdYt#t
z?v=S3p?Z1b9tx4wpicfY@3_5DsFZZueLg9FKNFGGt+u+=ZDw0#_E){bbsSexK0#x-
z{Ty6>xFyX7DZYN)wK#&ijK2qLv5V>O3YVr45)EZec81{`x9+;y$Z)ihwo?C>wwfV?
z4#toljZttHc2d(e`d2#6ke_$_D1UphM!u0n1B<f<;@E_IVs=ei_g&H#H9-aZ;bpuJ
z=E<BuU<J@PpgEu5^=<;^r$L4{XOi{;PC@*`v6CDv|A4E3(>Dra%8yFHJm4FVo5*pb
z)f>{RH89r?j1i~|?3TmA02EV`DqC)T)4fGT&e_vlVrG&bAW(@q+oU?HsSV~xrwjn<
zXX8H?Ht>aijeBW0AOgtm(7DyM%&aLwneNb6h6x7gKedy9r0Xb#lB-jXffcu<FvIu7
zkBKBn&Lv5XE$E$G#C(0n9&w5ONPGHcH*P2WhJJR~m@qS}x;PcLG4qLmEC(ISw;Dzi
zkLi{ZNgtU!k8^jGk5OnK<ss^e%A%a4o;aUS(qr6s&k95d05V}5uw_74x)Qkyp9!Qq
z8L01qx^{pRcaP0yyU2eMc^B6xzzBoZ=Nlcnp`0-J=~u4OM99CZe(7!^i5TQ=Ims2Q
zLX=L7em!lOZsnWq?96SP5$4P$pUza0O*GWRX&I}O$X2kk+KAY8QTnb70z{e`Ut&>>
zpOctNEoX+$Hu^TiO6=76SmVR7UmXXdvfBrw?QbUo4z$^$CxAui^x7*)AZ~2Mp&j@+
znSUnizXM8!vs{3T0%YW4U#3v{uXRe!xN|;l9gP-&X?bFq;lY{x<LuDm3zO}F^|-#?
zhB5pq!;URehL?#Y^O_sPcwHH&01V*qp^2GjI<-dRN(asIn<L_p-=otAK%En5*sI9%
zyrvY!z6sn^o6^oWs%J|QlDvuPFkvTvst04W>x)Uw6`rv14n93sX%fSa;Z*FgpEDaf
zUMPPx@*Mmj)#AXuQ+&(CBSp6@oxVsI=M4G<j`=>YIYp%$HycLDh}b7u0*87FzB~^s
z-Tk(;XpF{8gGkuB(zTS<8WoHOt=0|St^}dBqu%>wNm2t%tO5SySf0}!V=0>m*0;I9
z1<DrzQao8`o}qAies9hQZ*xwIrKCYtEbUP>N8fJB+#{KkV=g7|WbTPf41{c1%K%sR
zeK!#(h9L~~M5nHpruq3Mf|ABL&23QIWl)ZRF;WS?eao+wXn(dzHs12T@W?TVvIw=2
zI^$6*tA!O%Ry!Pl0nnN*61Sf^#L2o2==$Hgk$fZTrBf|C9%z7BA_nZj9`Kwz3G_AD
zDNh2ErTU^P1)du^Z66aN|Eo53g)LfDZh4cppakywVFZC`zrC5}MX1M$5I{WeeGiNZ
zhq)@V7u6)?w4KwZu+v2IW}QN<Ub82yr3!oZ!IBm<zrrcY3Grbn2<_ijDX~m3U#mga
zcK&3~|98g7Q`BIsa8kHdv!dLVFL(EuXY5m;*o&DXN+OWlQzM1{tf!<bribf3es<-e
zNNwt00IQW=1dF`45!*%P?Uv^Lm8hu<FDM?_hc^PZ8I!ZraxDPu5}6o=!TgrH^^7TP
zGjhdY?<5WjdLt)4kBp1j0?$-7a3m3ti2`a<N0a|u`v2X=PB($&Wujwi&yg0c`AWFE
zKwc1gli6FQ`J8|I+r;-cg!bccrRm|6%=fRm-pp>+5sQ-&lKoo{dn2z2{O@HZrcAR-
zp*B@W$gRc3i2Q;9j4qov3h2alS`NfxiJ~;RDqg?YZX%Qe+R@0yH=7>4Hkljy*Z^YU
zGxewjc^uWFi$eeGzDMKlKd3d5WaF0SzoE?9R-4dbj**ua*j%FEUGW7#38cA!U+0wL
z1>QAfCYeIVS_Mc1|L=0sEq_U<m-Oh?Gs3=r0m=<VSsA-54&6J3eCC_3d2EeeSyvk&
z3I75G_T~0EEUmAx#<P&`0#)Y!-u^TckS@mo6*Ut7;{Uv8h5)Z5jj3(!(r!84E#O_t
zMfRHO(|)uPFUcgsS$pC|LHbXO^i+=577Tl<Ep++kEB1D3?k-Yr`i_MQPra41ByF1P
z?{cqcdYFXLut<vC4^EVJ2^@YQPP|B~?(`zg;OX6UdIi+O`DuDbYAC<V?${wsf!5Iz
zop!u8mHj2#UYhIgt}Te|Y_Pu*tzfE|rM?WuNv_Y#W32K*3`79zYpSo*|Nhp=&SeUq
z<dO@I8JqJXVSgk>)c$)1qvHL=O5kqS$=YeEm2G;}A&sT6-Pt<qBD@lrz-h@=E=NUm
z04Gw9GN<|&*(p$d?6mYOj1~1?Spx*;C6K^1JR|d@2O+t*6PaA)WZ$I;n8$^}l$3xX
zUGof=#Ao(bi^KC&DK&_#YOO&T>B9TMKSj(<?zxzDYvpc64Bmjrk$BXTWb?ta0B>l7
z9(pEEZldH%o!xKncmB7*(}TE(6;=P=MNAUqr?uPM%dF;eypdU#i1WKQPVEE6*4Q#!
z@1F@k@7Y3!0M0CTZYwNs<>qTs!Hjn69kJ7izrR`u@(rxC%0-5lMDP_Er<WJ&kX<?e
z^Slk$Z1alpv<XOL*4oX2lo)q&^Z!bb8RT2@QkM66?PBZOX1X+=U~0w8${xy9T4GYp
zK`9B0&-tUD^I!J@0-u;#K-Z+Nm(jv{!~dUdnu9k%1d;%<gdT_0qY-p~ad?+PA(}2b
zPXOm7sGs}*zFg+iXt<GND?K;cadv8+bvVi=@RGrjINh2Cizp*vD#pdFP)xib899<&
zOIJrDrE7Tv)b#{2>JBl13IE;5B-#)kX())lD1E)nR<7s5?F$t))32O8r$ZXNn@vTh
zSB$}`=+{xqK4yc3ffIdq-vx&TzKni#%^8>TjlnQ3rYD2(5>j-$xBMj0^p1h8O|0X2
zt1V||M=BO|1XrY0a4%Zr*<J7hD?Zam<`dae+J-N2`1(C2QKlhwiPW!@G{npsYX&W=
z=fhsPcs*nG6mXh1^q1z}Z`+JCg&-Qc;=!ni3u@2xuQ4zg5683!XFo9BakE*dEQ)8i
z(T(i9cPB%e=1nS9nrMOO`=7s^2MYN(a~<>Jxnx=X$$H&VF4?OMfv(tpmvd++bxhjP
zL4R-_%xKnDXpg`+{;-KbJ-C-(#}L{eSCBWSuQYm@ZIaGBY35n7!K8(uJ1B$g+%=*5
zr>x2<-*evlB`7_2{cijc_7FC*UU8pc)*yjPblL`6m_OplVUrtoTLC{!bvzzc@5`Ni
z`%7DqlO`28!gn(%<cqAqu!}MKQ?4TGWFM&&Vb!s&TOnpsX&w>@`^SVVdNF~~eh3Hz
z3h|RbVng3}tygV@1doIDp35Fl-xnL&dLg_eXh=Nd^!`^i-DoTKGbGkhW#fGKe%>P*
z3x}N#4uTdO+@oJ_%B9xirGm?j(s6W}owi&YEWuu573%41C|Lsz1gmP?rQf&tstiUj
z*%cjH_Z53y%ZTUS{ag9g=jNof##No{52_%8%k{s47>wgM@8tAa@;r8DUuIT`e2ZY{
zed?9bmEJJ3^F|5!w{E$2glwF3StKWU_s*BBUmYJt1Rf=iJRe*B6;5_IdG7H%IOKs&
zH}HNyuP@xWojQBYW8r$>m&<*z%u)e2`U-OMR&4c7VY-fnsVe%;x=Wo$0e??-1Br26
z&P2o6zk|7B>src%zo_RA%UZNU=S8~zero(d|MBl9m%oS@SPST|tl<wRdiVZT+59~H
zN8xYte-R*7$HQ(`$G<&WC$PqO;qQO5?4p-uo3^wo4ksSOxcptl&@EXknaBl7<ZTc#
zoyPCXMh|`fQO|?7MEbWrx&Fy=n5P~EY1L_tYfUJRYGJjyqgp^9YYY8ieW`dCo0Z}t
ze7r?F$zvv!`UCaSk1ABru`zH*K6&P62LZ-=B@#AXC%hhse8`iUIm6`DHE0#KFrPxb
zPe*f&1sjq+m9Ged=P!AiT2npu>(m&*c+pV(kb^MC#i-#lYSB1_oJ33~*Lm47F@#5?
zC~;)%L-6GX_Fwo6e&Rp4BXho$i$4I-9-k1Vis8iZ2YokgQG^*RszfYrCvD$5?9#I6
zyUH$ZK5TjlUzNP+frUS|fY4hfuGVmx*@kYcz6OEN5PDRm@jX7b3U$i=pAWL>!p;|$
zRN8y17n5R*+Yk*6EH+jC`Wrp(jNjJbe4))`q8Vb#g6+{c_<;Kgn7(r17?pgbu=3D3
zIXD_PHk8bjFUKW%Me1Z&NB72K#Y5|I%HVf4H%Zy<2nCSWw+y{f_<&Vqr7whfRN-29
zkIWX2fbZ5XY#w}}r;n&h;dW19BW(7)&mt>DiiQ5p*1z0+-;)(wfhExoE8qS>mVRM8
zxzbMQ0=Z_y3g%86E5FWqoH`Jd!s_3rwEh`PNwmvC`M#|q?q(&N*Mu!&SuPCD>VZTk
zB8HyAkRXf6tv7#L1AALu^Vbo}Y_gttz2?iJ;NA`nFGh-UvD6W=%d@0Bsd<}q8n+G#
zgJ9Hn-y)RXYSYWKf)kvo*!AvW+^OzbB|jnCgb<weB7JsR<?bv=N`hpxrTOhZgu+SW
zq0v)mm-BqTM>@?~wO+xU5ClDU+E>9h<#A%an(Pt^zIQ)>lZ^TFr1=9#dP-wVVyYF|
zlDT_R{JU>huQM`eFvBUU_+iNjq@&R9Ak1qDZ&)IKozS~pRx%x=OrkpoBr5;jfgZ%L
z@U<IDvvVVmJyM-!2Y7wo-hrNK^S>ANTvk*Tj^9h#<3&+-WTau`ICT~fXY1?uZYtns
zL1O;7TL&%5r4C$T=K4L|@lG6j?GIc(lK3Ek^CF;vI#eS^0ZkB1_n-3XE>?GMJf(&w
z{AO|ty|~^-c;0NtWUy%1c={oG`24C*R%<N?vUpw?A-~cuAsVd55I957{+5tsR_Cy|
z<fL*$@s5|&o4DfnI7o3vYcd+sb2KV;k080X&ZNb4V_Jt%-$;9_a`7)tA7Ya7&tb7)
ztIJ@j^2Cw0JKb#$h@l0a!znTvus~?i)`#nOYQLY2v_H5F4D!CgyQ<hC@36UXU*cOX
z7XNRuSDsdwMMoT~KWS}CIR>B|VwS2do82zCQu4uR!d0P&Q^{eUNSdo#KhGx8s?VE&
zzmCqSfJ6%v9tsyV2)PbktEY%vk+x|a>4bDdIpPf%{{?!}@hkYCTh&Gf@!irZUDAYg
zk#NyGq~jT(psG4qovQkhiZWI=l$A}>O_$}vfvQY=#X!&JyS?};G&}_@oggMEQ#;W9
zLIGBvP3BL&H-13OM(lw?#UJ=TpM!aXxf0}Vy?g%!2I1zlP1SqET9$XYRD;U{kuz79
zhB`&Or^z?)$HXU=K)r!60U8YhoqTvq>J*GIma71rOMC555x=^?HCY0&A6`t-zadHY
zT$62UN(qxtNHR@-j&|nsmh@JQZD+*N$ZQfP-~f3slZhEs2V}9{s%M(5k2-AWD&%?g
zB>y){ADO(uN;OcSKWPc{5%HNQ;f0khhW*$buY;YXg456cyqyn7N(`sDQ=hKdvGG<7
zIv#s-NXi5dCqF+>xRb^!J*1VL812o^!3g{LtS%wD{3%UJLmi4cX;GfR=FqYyHH}V7
zfl-T%cn$BqcW5`}$3B?0)?*214WTeiCDUmU`u6qsL@~nXilb;m=<Y7bXWyAd3Ggai
z+2!DNrVvWCuKV4$kqS(EQHw(7+8@iJ@p-l=;>Bm1FDnpiNx?b+#i8$_!&Fx(I|9=U
z%OoDCZ(H{aN?$lkc#uufQxEzUfB@gdIyLPOAN+(0D=H)#r|9J*miXp^c2DnWx8mHJ
ztR#HThgG#KW8DoRDEvcZD*It}-prc1K$kp_R_xls7Aoxv;dhmkVdp+H6mX?thI=q3
zK-KrN#;ZHgO>vZ{@I)6ofFIl2AuP1jgoZhX`M&D81(7y<QziP(f(B%WGtrxNIN|E8
z{9P7?l8Lmo>;vb-LG^`iRq#!XoUZVAuzNWpb1lW;>}iH`b}^x3-L{zqmZnO+wM=$)
zgP`4Xm^<#$1vXF)@W`<rP5c9ehTUhFB8p|O6XR`XP_KJ#0qpC`Ht0{XxwO)o=puBd
zJ&M#;69Ki`zH!mFRko|ZKBdK?>BDSV+DujTL`oI0#m%2d2O`;n`OYKF)smNNNm_ak
z<;lK<Vd$vK6s52udpP}9uvM*Lb;Tdg8^ITE-?RYIRkc-X)2|8B(9I?^&LbHb=IDf;
zj%|Y0+HWTLI*F%B2m$y~kXK;addv#%KMGl9h}lN4mjnBf@xqA>fPA8e*4Vz|1B6zI
zkR^_NFEkF-wuR)xcp;0=8kv2cvgQttreo{*PmZ5rXl8m(yr(1VXC&4((a6n@<@ZBu
z8ux9Q7j5^UemiXi1<>Or=XQa2B&i`5jeB0~pJl8*N?=T3_14H48GhBE3pWxVC2ZHR
zz4aHIg$8A!YY6WapwRqbU@HLAg$cRgIx-|h5Wp~O*34p@*`ZD-3nx@7`t5O(0}g1n
zJ3mFAY<9AbrB?xQ4}8+AkTz7Q{3@ywh3W#NTyQlg0T4%!KG}|;PUmdb0V*x6!*vY{
zopY{N=AyD{#1T}KOF9V>E6SSP9qoR>${zjYyesDddWY(8@<6kp;k@3MuQgvQYd*UZ
zoc)Dh0<w0qbp@2(Qh=I~yzkrO%pS~^k1p&F8$!)W2j(Wdd&!=mF4U~?b`W_S=@;(S
z+J;(3Z6!78O%@XBBj<>yI(y=9ot)xU$#?#iaWCM&e6neu_Io@N?p7;1na8^q^>(%4
zPay|=(CUj*W9_}y>*zs!D%|x!{m(I1>5f_$0_>D;YdqhZm0ML-ROYU6{VF~D*=@*Z
zxclu%_8`qr)wx{)`{B&%HJ)6OQ02K?8VMY#{w~JVLL9&^(|Y`pNr?DmvG|cfv;_->
z+I<MzCf5ajzmV1|CcB09Ms}im7=TTU$5SpIg!tTi@c=X@3F`CBMq}lga&3JrFmkoi
z-bJBc$z6cOA=I~vf1sKt^5*zzP0*hu`4tuw<y@zKO9n3&finyZ{7<HBp{SwWXkfph
z{}5_l%Q2Xd_@(5n8<aF%H(-PA3%8|V)sj?I4jm?30m0OUEMEVu?uaaL9;=C!vY)jp
zjg|S>Hp|HXB$3>LS^U}4gziIC*Et_%PDMX>U=(ZGkp^+AmrOUNq;aow){8xSpE}QF
zPC=#|8fBl`zE-}L9BT_Lrg14+A&7^iUaGgO3ZobRGn2Te_s%aMA<$3}(?W%?4v9o2
zv()1EG7vl1wFY772U%&+(|dsQC-N~z1)bN<dkR4$3w3C}necr~;}pJUYaP2N1=vj%
zZPgf7r|=7h-n}|XnmixWbCm@oEeYQYpVvTb8Z_#G+6KNC>d)`u)%!7+YDL1b`supf
zR*|roGp~qP^lDBaGKacit~cX2MXTBM`Fa~FCzZcsD{W}J`rN>=UJE!*`q94IL5Bs3
z)0>AX{3(@A7v+q?Ue3Ys_G-|?-44B?G!ADqM&wi(ThAcGSHh(4ml*RZ(bz|!PywY;
zvHjW<mHan4XBo&dJH5PfC#ASt*1`hK_@C^njnZ>^y0^Ipu^O=jFwJdSNs=h?**{Dk
z3auM7`B61u-j-g~l-o8Pn|D9N_Cd#je?(#9Iw54kyqhw{@q0ojV@)lmJ)kdq{@Tww
zJ6S(%xxW}E^^2Rk<IWZCxjRlfk3h$eQh6pt+JDNPP60c@`u}rT0TkJlPN8jCiP|kE
zi08CFF%G=(6y2fBoyZVmjhszLvz)qhc*jkL6IBy-g)US4=9h2kmJ3eO%9D!&)Kky-
z*gOWWJ-9xT)juNFv8MdscG33v9MXM_AlS<%Cq<8Ah=@`@`&n-L8o7LN3zQYWvspe3
z%2W~k@@#C-z*dErzKK45??&E|A)45ujz{%(mU(Mzx)=`a-zBK*dvdXele2k6&{|&B
zcj-hUL~47fRu8>(MX%`Ez*jZc*SB{j_(w#ytjcy--sJUCFSm>%I+*YcOm-T|Wa$7@
zgM@5H_%mzIO;mBvwX7AvpJOR07WWJ3q1)q%I+CC6a$#`<nwbVZ61L8+oWp)5fO9S7
z&Fl4{^86+znH3#0iU7WBTh+m4%WnPKPiubPeuyff$#w{MKj^SJ%zBe^Kk?VFj>0i9
z%>#{^<+q>nLrtr9wKCaf&*pzb=LgmS<=1A*E{(jv3tOIBMbTa@qyCTFV>r_3ga2()
z25&`v&dI>G3O2T@=i~v%bonn4#k4B$>CeVJv)6-0UTNe8c<=zaIAQ@6`>)ebU{l)|
zg+{&c9cI4gjPnJ8o!|_m=9J^zT;bQFoE#j3wcN}DFR9}^GnO$)L9(G&Hl_{d3r&*U
zPcQ~8$P%`o&&UNnXTU6969Nr!(>ia4e=92HV9H8>Cjs^^K!QeL`&ZZD8(Pec@yo&t
zoxj6S8|Nl5x$Wr~^miihZLqMUjNvTQvFUzr$ZCSxlc{f1PFEIEuJb_?&2ZtL`!5gN
zmSI>sbgb%d#N@m$jNS|TZpmnw3$4{@tGFn7hw#P(pOt@e8G19l^Lf!p#)dLrcaVYN
z%g{BkaniTFnX8F!WtK5xn<*Ahzk)FjV2Lc?*wc@VDKy4q?p|9}w@O^!764^wZK1<M
zhf%~Fy6LKXNr^Hc=v|5N3ydE&bvZ<3UI{iKvToJj-=MTh<Pe*Wnkf!34;wU&RU84~
z;SL2U&EpfQo<sd=&qmvC;A>p%E-EQfUa@*6BQ75pCg%)Vu<Ysx5WmT<iv%Jp3@gYl
z0#D9fnc(VOOxHGMd277-%eg(!Px)KWJ_B!kHyL&EQlET$_`ZE`;Ev~YVg|d%D)&VH
zW)rFt@T;I^)1vDDTH)g+L&r&XnXP(*sK_qqTX%PK(<?d!oXkqJ*{g5f@>$3?tWN(S
z?v!TB-@uj%oujp1=C-@{RN(@U#P^x)Wgl8x2nqM9T%5>O?!CUgiOwAHN+~J){6?}5
zK|gZUqt9dz*nURUghJs`w!j!QQSh%_m}iTg_uBY10{*LjyJ~^-xyHOP&K!dqTY9Fj
z^TAa*{z@dlXkgG_^@E-oOnuS871(Xv$b)V*mcit%D|6Q&GjE>ytpnr0M}^D<$-tP5
zX;Ff<l0J{;KO~E8`b?XZG%02d%Cyrhu|U7;^;QlWWl5mM0w7y{|9=ya@Q$@F17Y~A
zRPIm()}N_Y2-;;6J?WKD0K-mctuSiBz@(|ze^a(UOxN(3>6FTd+>Y>V8nYj8(JzwW
z1gM*i0gTG4QqL@e7lvc+i|_&{Gfo(glv)1+;4H-1)ns-pZY{&$6=RKXp<!gsv~5lv
z@I%gvwntE05MamTdU^cLwBvbZ<Z<2F&Xx`vLc4i_;b7{#ex1@!m)_sopMrV>_T~E@
zHAihZ^J}yB+DC|P4}54+EBe-YsrdV&W}lA|Dht;S@{Df0Q>8$RoSN&_I8>U7Qq=-R
zshrKEaI!OvL<0r)Y{4ye73#3?os~c5ve1?BoL_&e?;>GN+cTadZ<g<Id-c=Wd7O&i
zd{M+6I{mwa$RZ+nV`238_8L(6gDIn}glQoOU^`ZtS*Of53hE44zr?6vBQ+MZDY_{I
z6qc$Ps_E5Qmph%rRt#o}M*cRd9*aCWTK7{ayjCukql0-)h%l2lw!qNbE|DcwD$_CH
zz5n!s#=Vi{3;&-EiQ(Nm<+z^r;(w#vN2OW8;<Au~Az;;Lp<g8Fo%(erkz+*D(%v~7
z?1*lpG4%4xD}g*m_ct5T#wEj1{0nRYnsy?;k|w`J2AYYAxi^7N=O{uOjtz>Lc6CpE
zRgSCvwG_X<ghnR)u@x}4y)ARBm5ooAatj&GRsW^%H9944us6}`Ag)<v)8e5GK|}^B
z1i>B4wz0n%W#p?d!r}rki_mh+v>&QG>0sK{@%rX_#_yJ#xLebaPeYwQklB)#XyncB
z>3f$r`S&t}$ZjOf5Hn`PA^{q&%>`$Rg-fRP5A=8WN4>JYwuevKx`Oyjo<3wvaNMM#
zZ>$qD2T5_ea0kEdG1{%LBfXyvUVV{&(enwlx7E!s*4c3Zy5?~$x_Ga`Leh)L7ZZ%_
z)C|hK-TJCr-4F!gY31OI;D@Is2jo{dr@AlZ=)(=zO)J-<$d^D0*!}t-CKmr?5vB{E
zQ3%f->dnZK)7aiaY){cH0(<2tNuBD?CG~SpodI+`i;@0CMV?-t^j*-~4&J{-@~ro3
zm__r#u%BjI>b(Iuz>T_q=632Ak0?*A&snN>QoMnnOXUY}p3*fWqEpDRDL>+%FTLnF
z=<0|qXp-7=k4V6R4AP4Wku@~m%ixSI)JgMcftv=7Q|vBU#G4JhZ=wP1B}6-+;alR%
z#~RVYuOggome{_D<!q+_6}`G*&gv@jU31~@SNRfoavC{#TYmXkIVg1SdB;=rP?rzz
zk#<s-TI&~|0R`adD>l&>L($10t?5XiTO!<3*((x{Ck7t&#XfeWmI;z_Rjjhp9`E9W
zx|tUyX2_?HKy>4mii;cDd99}=u7N>u1MX2q%<Cqh!?*?;^V(P1pH)uA{hq8yWDswD
zza7L|Q?}30c|;-+w`qSjF1e@{bC+iMu-FWC)yg95e#bWAjF>XK?c57gii3*{ITPaa
zU`Mvyry_aJY!zpJ0Hhh{syV`cPV;#8;g;7+;KUreADMG+uG!NWLdb7@Q{ed;=e5>1
z<Ys0UYNCr=!*JRk*Z47F#Ug;{BbnFyR9O25&acMCpUnu;qillfKY|Xr;3SQ&VD-m<
z9Kuc}8ab9m&<(pERO;KRyn1wz4Hs(I+xIqz;dH!nV@p*YlW*h$+xOc|+A`_@^&Uox
zxPq=SjfrCk-K~A9A}tk62cNGcey!|cJovThR1SV~DSo>zlCIS?@s~TSejxS&minpU
zq|35ps3X*7=LJ_VLe;JixCQA^TXo3%0lCrkD%>xp6%QH?6QLHZGy^{O7`f_yGCKFM
zfIfP4cPj@zth}yabvfSW`iTbCEye}30o~n$@JYUh@LlbqbY6r>0eB+0k5wefSVg~C
z-{|eWfg66LcE$@nTFaC_i2;t5=?*K`L0-AHu72~Okij6P-U8#F6r#007NG4V(jtHL
zw=yE$y>R004N<u6zDi1fFkCvHKvx8Ep*6VBssnMa2jRP%DSdok_N+e_{yieHxO|~>
zTMT<ay5(7_TC3$;rlfCWP%(4yc6fqm@~zlzz`$I^I40h_EnIFRg!c)F0<!erEUhIh
zL&o^~+0L=#J_pftdwyNo&Sc4afcIYQP+I7v|FIp_A1A(3e<kHAbMS4K?dfI2=3nP0
z1@>yyha8^J$T4D3n5Za!j{J&79+%IJl+P;P<ch9M9^x}24af2HHd7iO-wm0{<nwjP
z`cQ;&=9cbh$Hw$@t}fYV$^G@Fy>>T<^uu?#;4ax0Q9K1dz;XsQlic{<oYIANgqvPu
zuG~i|#@j?YlxR3(Oh*1DOspjdne|kgAG;<z$5u1G;b_WK)1_O6ujG8kAQ_frf1vG<
zCW7O?T*ZR?pc=Jo)i$V)Pp!8{Imu0MXAY84qoPNL$r!3uX5Y^`JM)t9%OF?e;69s#
zU4~gAgMuqQ4-lfP$Zn1}8kH;s$fG{kc#&nE-+X6&aBde`>mURRys93r3>&%hj6u|n
zx0~fn%DYTw#74R4^G}p|aP!ndRuT>4I{LchJ%>qoEJhR<Co^Z6Gncv-K;qMxYlPc@
z)c@V_w``y5j`|ay32)I&>%k)!5Z2vnFCx_?_E=wD)Z<rHutOh+e09$xSr0@XNbv>h
z(Y|yUZwF_`Yad~GR<8=uoTrM9<QV7abm5vxx&&Tct2o~b0vS67PxibbNs55>lt+Lt
zjZ+cNSUhoY(>H-Hv$q?>*`}w<Uqzz`dW~NLF^q(OXns=qdE$>_%oBy3`yPW4qCN^+
zuZlnT`mM2WM44cNKKB=c_dvfXryK<>pI_r~@v;XlHX+lftDA3?qTuKKKiqVB=4gP}
zItDm>%yXM7te^cXdyZ)>_}RV%&yq`HVSs4_eB#cq|4P{|U{Wz7qK6OU*{MrSqz~xn
z(OKEi-6Hb2|LaZfVsQZ<6zctI%9q{L{qeBgA~}dond$|8-cySiUEjP+Vz_=K>OjtK
zTxdR30n})`f(qw~Ed9`hx#jN^`Mu)W<VfASq`*rW?)kL2;-Q#&UM4WdEcVMYJJ;S_
zipmP})xL?EdnsJtd$dMUWmy+;ht;~{vh%)15n6xnZHP?uyk#p>I^ZZRe@8h@uIK*j
z5~1uRdHGTxh2Yv@=5igd$euU~o|`^k>r}PhQ;QAmsTZ%K(P%p6`vON?wAM*_d9=eb
zLUt&iD+pBchrGm#dOXyW5h3RU2ooP^{$7<koQ{C74*SJVr*|rMhs9i?w|&28%-q}e
zS;%e_e$Ba8^=;Cn`ySo#C(&T~e@pREbpyWY3Q>xl3sU2(Z~RhMWwL$p?@OS?`S(Mj
zqxjuVZK3##2xwi>_V{;FxGlrjerPz8<O)eNf$U_K#t*g1Vw^buAbJS*yH>{&GIwLe
zboYC?3(61{9RA1a_dWO6F~u6OrY0uR-HKI~R*HFgC43h>gF0LNBw^yRf3U1KmogNB
z(6J__aK|Z(iS1ke$&w^(8}ZiINz9O!8w*V0!E-q%E6^%%>1AWDqvsu|afSY$xnh9W
zBzq#m@W;kK_Z;$AwyW6s0|hXiI%ir$RsPK2(2mT3-b=Sd7|hPhLujb%z)8XkjN4@(
z5jZ34-4Xfzs(drei;s8^@3ebxcJnr^iMD@6l%*r;cKx7FU|a?Ma{+SXZ~12~9iUgM
z4jF!^%QUyg+Udf;J6nI}V{+x77EdquFOcU!$eQA@{n*W8G^tyZ$Ml5WCjNmCk@fSa
z=C>>wmdJie+F2i*t8%Xi0PbS0NMPPdAg*L{fKBu2gZ4mL-!27?9R)5TwAQ$9tSl~0
z1pKCF<EM>foKsVtHoR0%`xE96@eqzTj{&J)6G{FxYW4(s&V!K}%ch)vUU!m)#k`5f
z9`XUcti0z{s3Fx6MCFiMf$-QXW4=Uxhx6of{3VWhj);y&p()kW-_T^uVKNQi@TNLE
z{S@;1iV^F;5$O8JS8yS<Zk?Is{RTBbIH^QM{_<^NS;JIsne;=yw9FZo?x5uOb^C-Y
zy@vuc5A~eCQ8;^T=zozlBwZarql+`nlo1MrVY>F}4Vw0=DT^e!8O*?4%dCrK+(j9*
z*GHev@E>9)Xg7X%e#Q13{GqC|cD%-V^67>=d{sWMTgX#YeG3$JcdpvuaT$o!cU}Yd
zlK;2bo*l1PJ<IA+Lu(kFUQ>WDX+`JeX3MCc3*r@(pyQ{mPg(Ncdh#~;y`pMxw2@1m
zx!U*0()Qm9I3Xg|ZYuYuBN8DFbi&dtk5L*!&IZ@S)eD3@T7A*DTR_=h{nbnBn%22T
zjs;9QS6<B_UQV5CjjFv*AG#-!<Su0^wm7=C+1RHJj`~_Mh&Q6(k@&5e4GAnAdh*^v
zP7t@~0|q^zZ~ydei=YNrcTq9M3yC1j_B$3I$qM14edOleS{4xsmM$)^@`M@*;Jo;L
zYk@9z7V=|#O!ui55UVu^-jlb2-$^t^$}F9xl0(?@!kxOyI7N74Z5Wn^jgzCK9NE4@
z3fwkGu=#~ex(J%4>y6hyI7~DSD3UBj5x?tZxhA^VpU8kRVv?2r25C_zkZD%6zDAq_
z-4V4C!E<l@q3_bMXyy}SR}(m=yjey4p68)FGHtJenpEUNy?Xg^NjDWMf}Qo2iU6<V
z^UMuo=7H$K-yY$)UkPQ1Emw(8;F$>qJFl-ZoGv2Hb(cRYG$>@EIv$8}GY}$O(38A<
zWJ#G8U{?AEqR?`)Q}nyFRcb+eMZ~hOCY4ts0aW}=*F|}-h2e`L9NfU<t)y9w=LA(B
z>~*)~hB--ketdybfb6TQsr!31Bv@AtBiz5K;aPH@I01x}GF#PPMK&6nv=^#lQol<l
zR0StShTi?QRY4Jp(+Z&Z5*S=m*c&5bbX#q!Y>RVo1Uzl+l{qQjqyKd131;>A^$Sbl
zwm7W`4P3Ajds2nk&&N!oVaoLM-84|j7hMH^F8U8W482{1e|1}|6g-`FnbC25dPK4M
zXGbwJ-v)>DyLrvoKo}h(GJ(j76Mk%^6n~=+gkGBf^R}{F>O1%Kq$}y%$}3@+<a$~I
zns^HO$s%65CJ3%i^z;4T7G7k4DGjXa;V|ZUB76P|MczsuL4PXzrYBvD64%YKDwiw7
zH}1N8xoA($n8iijq6F4kp;8ylQS+;#w@>@S-yAY^mq(ZGo%qP1Cj}i>%SDh4#aV~W
z604})KJ;<qbJWYbs`KUP-NpAPNerLLNfM1es5lMPD*hzwbq^OFfdw{-viO__Jvj!!
z5u_mjLa7b-)cow|QiFnbq)Je4e4fNtKJ2$)A398f3_<vgz~mvzt0{^o>6C&l0#zjJ
z;oSmdU3PiiX^sno#>hmUZ+kQKuk^~F_PjEOR!Q)kJ)KK4X`OdgJxa40xs?P?O-KuJ
zP3DIG8I&SINzyAyua}8`$W9Lzi5D7JgjSh3UJwyT6J~vRODy%e{KilzWg5ilkf$oL
zv?P*7$6=b2txdtQ4+~~vx&}3A#6S)nF3Z1`QVmi^IHgK{vD(CNh)irm=8~v;si@hA
z$#{fiQdVn(I!G;L0mO0ZYSF{1%Va9>3fG|X77_NOn+vHfGKOH5$rMMbkN8B5{1Ce5
zC8{TZeYZ}f{phenJe^<|;acc2G8DmbIQE6zFxu_{Y_K(Ay{_Za&o|?#Nh17Q9^<B#
z4_kO;AhEi^=Ps*6@IP6-#G?f{_2OOAo{39ZfI)(I(v*XjUk*C1fD8-%&^eD}^Jn~i
z7&@F%v^={n@=mm?Z3~mEKxh5()B0|yEvI%W7GNzz<kBg8zN$pM(K0PjKkq0+i9{sj
z76q8nQ=0HHuXye-&B4w;;Y1Qi-EQ}OhHHi3b|zGWfuLH_C5=Z21ibe=?N6qOJJ-7w
z$8YhMinJ$A9qDo?2ZX!&usAl154VgwB^C}N0%|h$>aFl2?lD$EN4I8Q+4YUy_Z#z?
zrrUT~@J?|UlBL>&yMB1x<3VHzAO@0`ZrU57<PMeH_q|~JhS-LaZL90)XWXLdH=<^;
zM3T57FLdw;s*x6<M%45u;)O~<N50r;$3lZE;^OAg{+q@tY;H1%yXVnah)Qb2s4z+J
zm##VbTNX*LXB#iI6wY^KnN8bzqj1Br2NDkhy_BEiKVS`kUnG%w%smUpPwj8Gu=B^X
zagKmFanzvp`Bg;Hww$_Tq#}nCE&o$`Jgqn*Rkqj>dwcyNXQF_y>aRrSsoQtys~YMB
zBMlkckQNY_n4F=Dviia28{OAVukmI5_{h$u6e&YPJd(QJ+^gAk9DlAJqsw!N)1SoM
zBIq7Vw-_u@apf)eilofASLgKY^sTCv0kxlQl-Z#NN9A#(>%OmgrM}_}@(^`K^6&3H
z@Sx^bDv|h=5UyJj%Fi_S4x^-Q!o+&C2x>3y1=`6{MRQs<Ur`;Vg@@Y&WS0zYs?XDp
z;*Y8^NnypfuhxCkB5q{P(Pu-^;I}N1rzw&;7-0o(?hix!ol8nt5?2G%nuOZrd~VPO
znEd9a_&v=ZkP=%gI*&7UkI0}A?D&SLo|wGR^;;@4>N&El=dS=k<f*wcyEGbut2|%b
zKhZz!i>?hoDKkYXG#>UJcRB;JygagO^xQvtu9x##r6wuuhi7>(wy^m+0SZLut`yX-
z7>d=>PfQ*geJzj4Oe%PyV>Sy~U8t&~bU$RB6gkTJyiB7U8DOGb4slcRFhLS&)@b^E
z<T6QMm1u$tBs39<<liB>(wUATiJ<QC@n!H5a-GRQ6wOqfX`zh$8$fz|K%mx{+_0d4
z6tbMv;0u1ZO4U>P1>SI5rfM&*8$YuZRQZauOpU7$HcDc=7L}Ljx!Av{B2Lb=lGw5W
z`jL<z)6wNOSKXE%Y*j1$`Ai@6j7SL6wtDOd=zR32zrv$TgdcCPqnxhjuEsP6)Clg#
zoXV>1A$*+f;)u6HTKd3_HH>|QZPxVapylf=C3IR_mE^n#Cf11O=DkT)2Sb9<#B9{%
zm7{A>eoz_t%O5UmR-cK(Ep0xge!_GtRrhjYU-)y~+7y3i*2bO@IXMvE?^`}LZ6n>l
z3qmB&Gnc96_v)?S%RrFy&&biyq|84QLZ={>asDHh)ye6CSqiTEO<TP%H9@?p4WB$h
z7QvhazcIOYqL9l>N!|(NNs@`>W2^7+uJUhK{zYT(Zjv3;fo9E!i|pX<44rR|)Y3Q^
zll81R8iM#gv@+JKAly!~JiLJHIeW=Bfd-?F2F>p-1<B3C-ca+c&G*jQq6BL3A1L39
z+io4WB(?h2Z_Qgv(_;gDJ%h!!@~nG4)0A7DsIueef{Onjn9HhY;+`&bzIE^S->4jT
zGGWr$N4}fw^4<^$arH=XMXC|AlSF?0tPQ5R)vFrw!_G~s!+=Gg_+Q@=>~x8J0%~7l
z@@Z9i!sk)=s&I?^Y;SC{{X4TKk1<7Gon&I0P|220p7bOwiHqCUY9?*n)(_DqIE2R8
zj!0?;8NPiQ-5Uu`-i($%Q)V1{2TLen8gxN3PuL%@3%sh7)Q)>R#LixHDL+{2U*ms#
za0A>m%sZ1v&99yzo;~ylY)DJ6)x&$@=Z_GExKQwwUDu^;5?GIz#U|AqoO8?Yz26oG
zCqg;gwhkY|E<kxF-9JN&fYg6aQTBIg7Tu;KJiJnU3SB0dP7IIk(o=Olg$twnO|(JJ
zg7jt+D5R3QG<J~9hqk3UVYJtqq!d`gx8YEgL*#M2jBhyBvEe+0O*3N^T66!_XZ!<h
z<kh+NxX4mmtlncO`x$fn){aYYqFH4U@-~mLPoGFC)b1JX-7;Ky;ju)d8(<7tP8j-#
z7s;aLQ^FN57`2xxC1VlhP3k47U$_Jm+1Og@BE@JpAVeCYbLY9X$>+PN{v)0c**`z>
z=OqSaC9;LcW8JYr>3$aU#<uyrqHE5y-xddZdCINOls%CS3N2`DfySu`SFi#K35bs;
zed)0fqENbRRSUc3@OOGlFUp%suV}1fFGc$8D=MFZ6i8fMk~BBWG4W&htAG^aW_+!v
zwJk9dD~&xm>DG?9ris&B?a<~CW%%)u;y{tN)@P-I<&yCCrnG_GaAwngLOeyQ@IOa1
zf8-S@jy#Up$*`2l4+dVBpI3I@jZ7Dq<D3R=Znk~s2NK>|BeHg|n+^;5B8*OQs~zI~
zQ)?>kjM;P(t}!!NNt4ai%&%km-8njV3hk51oJo3H+cAq%zjJ@>Nd{l5PZRw^6y*R=
z6O-itKID|4ht+?jbbpNixL2s<+uQySyeY&BL#&bl{?gdftY!P%(n!STw|0D0nok0C
zTn?(k$}v%gfRzX1k{V_`=SD1NaiP81RLPp!;$0B#emvZe;N?759kF%w4@natQ1iDk
z4yM*$qkFz6@kEXE$C9+03@~gDqj@O<#K2N>sy!OS>xq|9WiFC^t?MG6<`c88CaK4J
zXycwJV1GsjJ}?~51kzXegSpp*<?>0Q0UCwhp?#TZTVzo0UdO1YWJHqVZ9P+9LxY0I
zcw6@f4@_6D%h~}vEQ8ym%8Q;1W~Vd>lX}TE<Gm=hljU-fR{tf#SuJv9_5=ipGlKLr
zPWSM>rg8=xJq(jEM5-U1Fb|n$e-d&;8^IK@yU$NsdtJ*ul1%k1`~KYY9wK6StoxO-
zI0r5h5#9E}RX%Tve7%aE*OhVhB?z-c2&IEhSyGXtr$n=VGqlBhV%i+fJLsd$@do_d
z3CcP0m(S^4(vqrOu(2SWQR9{vgkP^%3Jh@Y1ZAuW<hptE%v7m3>-*;`nEzhc`HrC{
zBC4{2SG<!CjM}1J;6O3<3{jp%4w9tRV1Vx}cZC)t*&2U5I8RR&<vt2_c)W;}wEjIU
z?Uw096z!!2Z9{JV_*6l+{Qcus$IGwthAv7G9uM<iv;f#iRs<jb0s!qq!&f^e?OhpP
z43*m4OtNFv<_06&B-j(5=t~<1y{eK*#Un4Z&VAhZbLZ;iPOkaZr&K0YkDMc7+Iuj)
zMbX=o?#5i1?*0OBt@%ZQ22Gu*c~(D$fi@_o4A+xYLEM>lG3_w;m!J=kcVBXk%(l&v
z1}lrgEz=ek=Q*|*T^Qd!%<CY-Ck7@jDNOVZgLUreA1M@Mir)H8p`0!8@kWg5x4I$n
zQw#rT(4=wQdSFRT*PsQuw>NL+5FWx0A44BQk-gHdbvR=eoKb>X>`A&@L=)rcFkq5O
zPPQ-=gRP^Hsqu~_!@1Mn*~FdASFL~~C(Dx779b$&iGIeB3weSiY4$zwfw7iAtPa5+
zH%m`TRlBol5B01PRk$)6rAUkcl{|VSvVUjt(0a6*LV80PsFkNO7R`UbQ*ZrvFz)>8
zECM4Ss&X_~F##!bIrAQ!o!W1)d?3jLv!(CV(wGaN;iHI&qm8tb=^EB%qR58{B&`aq
zn6R{5P2czfW1^SYdCN$eBt}qm-xWQ^tTa&gJDpun1-?KtHiZglJuzWU5Wi6%%4#cJ
zgaHI$65<kp)v=~BQ@-U1twt@?EAgUrVAXkQ?WI*0ur6q8K2hvkuJTkw8Z7}G((5%>
zu}hdaV5>V){f;U~)464C*eR-{=`g+=vm1F-H`CY|vAUQBvmHKO7XIb89y`&&){#E6
z#D5h%M!3>Kl|u#j#k6K3rQZ%6;u>H92izT(lMb@tYHw{hcs6uja($cFp>Rhn)2j2_
z72b5VKRxb~r^$D{vpr9Tc?Z0FSod~zj$*nPU9x=0XR*F2ChOD-Q#m!$flue&+8uru
zcY7&rI+S3}v^jIQ%f@&h{+g7O@zGC-)KlUeFaPD$Y9c1#^ImbDh5V`3W&Px`b3JOb
z%Z%5dmp>cTG*o+U7K|4AXBvI)!z7dovvJ-Ozdm-uUCjHLJTg~2VsS}^077$n7Qh11
zFPS5E?o5$%7=qOqdY(0i9F|AA>Pu7w1Jw8O#>P`@1;^U&zb9@D0|_oKd-TlaKP}>d
zwbF-5&!U!GQtlHr6CFUWi9IRK%~3ZE^WeP6p}&Oyn?dwPIIxIXC^dAQX<EdB8FjC1
z&ZaO&Y*>w$a0(_cS;TV0;V%$c_C9itocf)R^u)(9{^0McsKo&c3QMx-J=O_eumoQP
zc!=x%qk3<`oFkC?of5qPh^os1gcCCBvK-(+2{tFeHnw&mdRSUeTsd&?tmJsa3drE}
z^8{y9R~oGjJI;^>v-?}^!tWl47z8GLk8LY<+JAqq5B$%olH2_IgK1m*lheyOZJHag
zyQTYpq=iNplp;>#y78@(_U`Wmwyg0_X<<)@3ba>w;m`MVfz#mi`0*mB%19o`_>1M%
zC5`u(pxo`M-|*G-=jhd=PdmGe7fcT*01{pGsJB%wd3t;`f!7vXvcdB-D<tu}ksAeb
z*OL;61K%~~3z~vc`Gsst<SQ*;iMJ*GUKIWe+c_y%C*Cf($gj@ETJsAW4Qs9q(iO`F
z|BF(7`<r&~r6yAa0aSY`I(SneJiM5tB&UeUlJf}<K-WnIMstlHg30ofMlZ#FOA`_o
z)to}%>CQ6at(;e-?d=UaJO6;8Ik08&5p@!U<M9KMrg?Xv;M%wg-h~Tw5F&8d-R@Y9
zJ;O(d^MZ<DGPaLGQ{4VhUUfDB;jmc!u^1TT&Z^FaW456Mu|*Lf-;eGd$WZ?609Xkk
z7th(`8KCLKCibMrFhj(&9oT?@*HUAfu>XubL=tWb8Xxa~^I49;5KHhJv4JG6>nCfU
zmV1PDn-i%6;W1q^Ow!vXN%-RxEnPsr;lgkn^7|p7xarmQTyE!X-**tDW@PqcvE1QQ
zt10t9^)Fl}kh>DA<MMdtFV+sMAkAdZ@O4yyXPC3(0`;5M;jA!-(PKn(ns89`G$!8Y
z?p59~(l^tMg@#g+X`!dgJKp;;>wF8A!a9tF<!tOhW?kc~xR)QW@2q0SW$gN?0A&!2
z4T48_?vwf1WPeU5WwNu~JRhbwfoDPLaq0!%F&}z{sa3|CVU@AjD`gSmBrsE&Doy5x
zr3sN2=kFp$;1ui2MxTtDIKDIypXVrR-EgtCDBX2Gay%bTuiMQ9(GvqN<;uS3h|&Cn
zi&d|n;w4wjbdm8nUL&(4E@H&3N@YETxI5}mAxyH5ga@CA2==9!BfI-0Dop>uZs_I7
z7gUMmh8w@^oeuYLsE@c~tQ8aOjCY8LSi6(IeOL~Y!6aWH$+rkzX<V`UEW=9pc|ptc
zQV*|#o^n$d{rZc<K8EMIXL7IV2NLq51`D~ZyrV1SJx{9}+xy9VkqrDF=!sqAvBE)~
z1Ni1Lzs}e8`M8fmUC56`0lVX5QC^QSfyG4j^kdPWPDtRZW!f)&-l;d<aR1hyxf0YV
zAL@0|JFdb{UhuBQ-H*&RxmVac6hjbKD5mVg@#?sxxn*Dy3h;p8^LN{aLyT=MS~i{y
za}REa*iRHxs&7sdxWU0-B=l^FIm?d^xT@K8=v~hAoNo(}3Sa?ur`vP4$<(rdy4fBt
zeG{0T?+E;OW~BSSZwHo}NIsBWP!MfAZ(M(@vC>Ea0vhwD<xn`QcvW(?IoP44wseWi
z7_hT5l-n+SJF&ac^%k7+n20b77j!T5_}SnP$)#f<bd-X>CMQXgZ<u+YI~dcKd7zvy
z;Z5WK8Sxg=u0kKKfE7a%LhE{CKTqme=wCxVM(m1TLz(;eU`@(|yW`&&o6}v1w|LOe
z%+HD4@`9L)v$Ma5snE0D78W<BVkV1F<X1p$fuJnEfGU0tJeb_-Fa%#{{(y!iWcMhT
zH810{keq#>pWQO>(=L*@X3v#D1EyDl`*6ith@p7BsLy5mEZ-+sU9Xb9=6Y@*&LcHs
zxqO_=UooHf_WBE}2zd9dV}91wuc|nGQ?^JWgT@rMrW*AdeWh4N5RGBQI{@-Sw_t;7
zJnS_x<9lze<1Bu-f5Q8Ok}%@J-1Yycdhcj9|2O_Wi6GPnYVX~mwo=qCRl6FiHbw1G
zMFp{AD^+`x&e&Rtsu@+a+FBh-#43t}dJ7`?-u-;f?|aVAUk=)H=k}8O^}4R-^?2Zm
zP!?o2Kf(h&Q*!kmg%1HPzdneD-eiQ@dW-Z$1-~bP|I~g?Id{fITB^UZ#87>$eY*g!
z{9G(}XOa{4rpSs2HhaHdA2;#=@E0MqINx=AQ#9ZOC&5Siqq1=S)eVg+8htQVp{6R~
zGW^0IqJCj^j|Y*KtjrJHZSmhI>H{*pmnVR2+tk#AF?LTqs`*k`x@r64zUALHF4kTX
z*(7yzzKsf>=Kk$*BY`BK#Mpa2^XI+Ag_F(6v9SM0H@~Zu2k-vs{SmJK8A{zUy?Nu`
zE(FLu|5Kf;QK?BU{nS02Tj3?Q?*(sli-+eiujN8nX_dDvUOnMxCx1Rgau|T8*_vMn
zB7_)kdTKs<RDvyC1s<4Q4)Gdu;-kzxOhRzlo4@g=v4xrry&VKVHkyzGLf90>U)TDu
zIyIa+^AEZ7$5Z>?^6g~=OL4~i#IlSfz2nUMwH43Rzx#px?oaA_l7Qe6TH=_!uG{EU
zxVQo?dN{}k(1N55FS^?R@+x381HpAZrGGmp>-4q^>%_npbN^-t0hCoV@MsKY33%L%
z?FGgX{~tgfx5~396)4s{d^APi1bJNECFSz>vxax#nYXLIzvkIilA8$~K|bM4GgqOo
zK|YpMgpA#n<;<XeOtz=FDD~I6xX?=LG^4<S9x1{m&F8J<BXT{LPGT*4D#B-Rov0)r
z!mZN)QO|6wNoWwe{!#mM8HJwIbk<S*NV(m+2Q*|qE?w;H3+f=zX(EW!gz|Wp_pdFU
z#|3T$m*G}d6|LFWJ~&;i^VWDSUaU{q<e5K-T%RF>L8BW};mhF^i7KJ7Xxrywnx!vk
zI3DeUOfHoZCWwt@Asj<u*ZggT)|n4_TSbNZ#LDQJMyYUk;Ro*_b-oCeUmNy<Wv_lQ
z*3C(;cpD$NTge;W?%=t9aFN+I=(ERN<3Esz0@eTS7f06_aWid`^~O{xQSj%-v;(Zu
zXZs)Z(>-j5=U68AzO1)F!KPl6ou)FAsY>&crW?17v4!uP^(1rrWTzA)W3BJzWn%Y7
z23S&WKGW8=lq6<_z&qXIUiE}DP~v(1{ayeFMR|8|`FOt-jFiV=VCpJ*n;A!6kbM`)
zq|LgSmPkm5nsnbndx)s-Z^!r~O;`B(QqE`6FoIS^V%(YIlx}^BVnpFu9}jz|{VbXZ
zTPN#U^cn=k)52j^>@*VQ;Lb=4BKD)Lc`%8_w^ni^QE_s)5=%U%EhhEkq38wLq6xVJ
zw|3=?gaMNQA4@g15rf)2@b;2I4pY@-t+ihDyT6l>ep+9Dtv`=h=WsA^5LGepyVv%h
zY>6zY92oz2k8Sr@?Zy2F>0hNy;8ADaVi6Ik=sMlu1LY?nNp60$|Hb%3CqBH7Sk}_4
z-twP%M)F*^kjH`dDL)!5XUHdIu;$%?n=eStMj|*S50lXDlz(fLD8w^{X2Y185<^qx
zUc1Bj*MWR40&{}FTBimKKFsFYW=`KY`#5`JufikUigAwqT%sNw4bF`6i)2LmQ3jh4
zU8y7UdYNW1xqe6Nk0+O3!o!{tEb()m*3>Ww-kvDe|8{XDEDFa+C%pWf1A6Iqj=Rd5
z(W|4uWg8tOI;JN=#7QdetPcyr0F%r!=!};8N<s=!9Ydq^+F#GE3`?`gaa?a0kP%x@
zs(^c2%clK^<K^dz;6`T(D;$o?`1%XqRe8(UcK>hez^#zH>2iYkf#%=d%TZAQblllZ
zJW_uITwCsixtd+XrHVTFPTUSyMH8C9=hSvH8?GM}?WOn(hjML4TXM9@r8u57SuM!3
za>%K@)6U=bizG(V3fphcOGHe*zI7l71@}wQ)#biM%lG!^S$0o!Sh8(|9_0-_Xbixc
zBEAp+1p;mqIQZ#Szg|vFxi4Z7IUAk1zV!m@D$zYF43IIlx}HUC->Vo}c`F;tHBW{o
zN{9}cGY;?)w?~?V&OJ~y)@Brmkse}@Ln=d7tx|G}K~G9EIGYAN;I=6<u)T-H6RhjW
z-L!zm7wu?}MWsOREykv}m9WuFi)!7X-zgEz?B@y$tMt7t`%C7v`q{uEk5U|?FbRU9
zg&y<c{bV&$m_7y4%#QcmVyp@{|6BHYar9pk!3v6$K-ZH&W`~S-!k<yT)9Oib@!IN<
zeY8fVgA+RmY_zt<KeZpYP6j%Z9y*?4lQ2&fc{eLCo6QH+S^<wrlEPm8%*VU8U00l8
z|9i!z;QVT-)O>#P2wTQ2`vBzm`4t-6hX$)DaNAz?vFOM~AR80on_IAaQo+9A>a)8I
zR;#P+I?@^Jf#bF*3uBAaSh5MOzw%ayWB}j4wK=HWJ&&E$42@fPBpun%nQ=w7p1Bh|
zQoNc&{I8YnDkVPNv=+<Qbji<cW$PkoP?{At9(_|r#pzr{ix&jNcTN;pG4%7jR=md)
zEYT<dR`h}X>;)wOSN!CQq8!)<$)L6<i{}DlFJOAkZ>dC)7nmKRd{r;Pk_I589+Q~l
z-J_C0`Y{))(7T|gUZIeg+nO9p-~BHmDYDx~<yz!MFKdgHa4+Wf;-Ylkj<fI_ZUe?k
z`8=W;l7cBT=YHd4A!w*j>;T$b-XQ2N*TGw%&K$<&dzVdHRLq-U_A)$e&j*~svZ|9@
z9E+LA6ROES_F0RwZKWmt?2ujbj#ODKNYiduD5jl>vO7LlV-}_y`+&50<7vvZX)Vp!
zw#V~OdOe5#Oal7`?>RMfmd}QCZ`L$1l&WMet*!5q7p*7Zp4(Jv^%xoerwjpTDbjVb
zW)69&R4=9~i7qD7(iZpNdQ=VAgIFy_X8cq17Z==2<9R#;X3})#Oyb^kLNuh#(A!E(
z6;+NpE>P^EBz?nj>GIh{nxx|rDYAcALPg2CU#WfrD*e8xAIv>ttVp6ICeiSS-h@Ow
zW~r2(yKcC!D720_PQ*Q#$MphyCC5Q}ph=G&B-nWPhDri(Rb-n|<lyb!BX@YI)OOkM
zT>1t{)aB4`o1ie<y=ONEUjLwgo`O*(<BjHp<S$L^gaujTgQ&s$NxvVII`KDmN{-&;
z&~j9q<m6l_9zmF9yDvWL;`v@*WgYW##wPUnlg=^1a>b*0zP`oUcV)rX-o&2N8j-oS
zR5@Y_<gJlbg>8+|`DQ}~R_Y3>=STmVC=`6NXE_}kL0_g)#A?0gs*7ztjuHWDM0If?
z2AwfTe?TZbSs$hSoc%4i6U_VW1z=@U_yLeh5*)IyVQi|})d+={*O_yo_7D^t!a?o_
z@%CKi0~wL?$h|l7g>gy$C=Z62Ab8L2&Jr#m|HozOSv;Q&@;vz3rlIj4JW%P;RXSn7
zNjz9tq7E75i@Xq(2a03yZ1?+DCY0JT>qFpwpfLKW;k*?BT*Muy52xdK;wLqr;#1NT
zv|=`AtQU3mx1ul?s7n6aEKda5-LSr9i1f;}MXe)*r^3Nxnc0S8yuv*vr8KuibF`Uc
z=0UgYG;P&zjx-rj_&RBP`^_>3y-8%jO+PQ4^Y0{Owyn^N8+lB>s%V<N2ih#T9{YGT
z!P*`5oka_uj5XX-%VBa5CaM?~@QTPwWB1@UnmI<%*wy7iLSIZ<%TE*(U@ojtCRz8k
zi^(O|X8lPM_CUwLUS6bVb^vx>10})Xe$o|!^<NA{X}}D)+na@ZG#H(^<>KDb2}ho8
z^HiPu+{ccHdRBxl9xEt2rGE>p7EL){8G68SZ%CxSgyBbxatKaY&nU@JOH)wWiyFGt
zp;FPYhc$|dTY{y9349Kxudo7~Ec_{Y$wNxfq9MV|@`=4q4N4Ee?6e?995^-H_OfZG
zZ#LM(tPLD^n>{)G=<BtrEf)sR<xrq}R008!Kprs{%f&!o$es7ydaWrQ$Bld8v{0|S
zV>%)JSxr6?MT?E$-n$|um!<)h(%JP!d#r7bcH8=(C8ZA*<(bYM94Zle>KyS#gd*-P
zx}&X=R!rI&9WND-YHu5?l}<qF#-wFXG8)G+Cvd*8<E7fO{5`!T?<75;{eqb2-glge
zUTgMPvSg!eV;J9Tqy|FIY)3al5SY`LJ32G+jH!P)pq2Wh!h>jW0E~0c|16)i#}MUx
z_=ynj^$FUuxwjmWcD;uPU{vy?`8vF(3rw>Q5a6)JdUcc1+RZXZ(@($syPFuHNu6x6
zQlq`x>AiIJc5Ac8_i)0H_D2;e?#Ewg5(QFJtM{y>J(eG@l9WA=AdkcO5b9|kg-K&R
ztG4)5zz9Bb?hOliGZ$tkQVX-p*^;3WZY&TCCqkaqvG4p3`EsV0B%PF~kt0vb5t@iI
z!$OTnpA$g}OLd2~R6wd?3Eerzu{lD4xDXrquP1_lSk1c1HKvFKPpKL2VC8PKJLt7K
zQDo%m_sho}p;}bXEs!;9Ka;OTQok?W%U~SMqRsqe%33n0GVW1@^&sRz4bUKyQdD*l
z(Sc7$s8+(<y?aKieRy?gtqnUOU%##G{4}RD@R6r`_wn<PtP(hz_Mm+nINmaOha!Gp
z;6dx55UC?#Wz?B{y-DD{zt;+=o*iQ;MtU|YOTK(Z?oriquF+zml0?BdB2CAf`D}po
zq&n=QtUS}Q3})U{#Dw+En|8dY+l8DPl2aFtwPx*yXCv$Ix{~&pw?@(O^>}$HwpqJ&
z7gq^x_g?c(MFDl4O${CRT<3gczGs@A=mXN;5h~=~6>GYc{H@|>104Z6PIblvs<r9b
z?~)(KR02f9!S3%(J`(2zp~fM!eeB?+FVBXK2yEcQP}OH|=IS}pm&)QsqBmB5s(&TH
z;w|tA(X39&tSUsK6oVF8dc%j=!(6=e6tL7O4X0d%GNA(bS1^F!&PFG6@rpTt-qJZ_
z(3*z+`B^$imn5VQlfW@n0bi<+Wg$yh14N|q?iK11m0}?M*n8oG5(My6FjQ(v-Z&gm
z@ZYVcEof0_^t71k2*hd^-m;WVG7`rdlYWoSObIQ@%jtlIAM=+)NMv(eL$`1b;=~=t
z<!fZjmyaen?kW(Va5_*09p4QjG@1tq&vC}p%xVof#D(>?^};`;H0{pASag(+U`)|r
zR)t<P(!@oj!nVlyz;q<J5WO;_o+4X97+(gD)Db>pK1lAdbz=bFozr~l{q;BZ&~Qe{
zYdidERk!$tl!)LgEYdB9A7aO7EI^Tx|0WR|{{)y&PwcM0TN=jU2_!N6Dzx4)(9pU1
z&mF5Z!yQ$un=`R|?OE%y(TS2x&FrrAXpXqKzDv37Nl9}(j37Vh58*=|SIx*&rtH+A
zr*9;Ssnvn1142PZ6G_Vx!MDF6S=)S#=)|ZCb-L78dx9PtH`rP;OzKA;&4q>L9;>p4
zJ^12_74C<c%(b{sKcP9AyJO_k86eT3EN=1eVKs$c(vRozly%&cZYz-49tN?+zU!s(
zlLYGozEijNLr|f5x0Z*&vd-k1Xu*3exTa$2-aemxv=<tfdZH$ZY*o4I(TV2j)?L*z
z--IjOffxk3Tr^4x`YCjs>u=B1g?JV)%nX|Rjd`jT{A$q0%HZJ88VaWodGxZ{mj!#g
z%=94ABPT3lC^pw7wtTd2b$P9r%(*Vuy;d@x{l3!hg1ztS_Xh|QNinr}7mG)GtRsJH
zW(H?&-V7f9J{;(*sUucDn#=i`DAH8&Zj|q*+;Of}wX>4y)&q+_I>1oxlq$X>{t)`{
zv&@|HHLL;WTxgPV;&y&MZCoQqmaf8T0)ND}py5T?(^1y?rDea0PE;NO(P+m>s1n~(
z<t9FujkHk?u(5WBfW&9mHAkR%oGr51rL~9m41o%3NWt0V?_VA#*v+2eby@FCl_m{9
z92p2<dLR*SKfEVl*?~P3oa7)-%`D>$f<Ubnsps=9h=9dccR>&uA&BGX!_Z?(82j}a
z$*`FRfZFLM4b&I4{WF6qPxB!n*tsdUhh_Pu8?uRwDNPIs-l+qb<DFCWcG42d4UA?L
z!+NekZcnp%xd;7b@tRb_UOgtAHxw0yooR~gy8j)LdtK8klI?Z7<aSAb<vb!0Dkh%%
zRQ0jh<6jjpF|fV$*d+*?={Rj+`ZYqh*Hr%x)_PPhC=m8YL-7WU5Q`j$9b`Zx(fzVc
z)5|MosQ*o1?q^9SjL&ejYBh0;dm;RUGF0aa)UJF7yRrkML=UG56~-CMUfBQ@wk_|<
zRTyo;y>KszrEy?m^&mIT$O?P#xLO~7Lq(Zh>GN3aq7BZKOE2YmL~l9Vxp!|_r7NU}
zZQm6*t)g~bz0(nq)q1f$hY``6<mpsdmgkSf><ca&py4XXU6^I|BmhR2%F5!AsUIOD
z7UU0K*4%2hVY{M{+3YBaHRxpn9#5p~GfxAj`7Bb|HljRhtLrr|bXklcnY_F{`Dc9@
z&8h*9b0Kr<iw_63{Cdp)dgf#D&+2sS#KI%pcbfIiKSl}6dMwE%bXH2a;7;(D{wp92
z=z@sG=+E($!UWJN=o^5Finq|akMV*}yU~JK>_3oJeOJ@bP2#y;jxb$GXv-jfLQ>fm
z6U=(o;WQE1!s)M|u09y^$l;^@MNw+JZaxU2dY^CN)*V6y;l@N|1g=>|T}$I`H?rTi
z)p5#R>Ut%WHX?9$^!nn&>vzg3cLG;~tW0f94nr#=UEHK-kEq^mFOIRa8t@3#u#>*k
zG7x-fr!@CsTT_(BYg#u6JM;fy_?Bm>3+7h!rQba7DZcs6S;Z(}#m1JxHy@i?p+Cx|
zdSC4u8SHct*&#U5=-K-Hp@4MZp_A5vB|fw`bGN>x8VK3y2<ycpv7(RL5tZKPiNPYU
zU7f$rX>V>B)m`So-ALv#Sk~~-@K<PFP^0O9!dq{Aa6|oSzl;a`MLV$wv}ZT)UcZ?V
zND$|HTO-QXd&xXu<w}c{np0F#T*uj~(ZL9w5uaQ9pynE*=D)h!e8j4-IN9$U1<U2q
z#46sla07jFcW<)Mmz>yD>SfHcwesgZR_n9zmQbq?mAWh1{TY9zoA&<D@a;6X6-?Qj
zw;OY=DRfoXyEGOL$kn#%S2Or`rn`N8pG5ZRX8s*=$(`}e#a35i%+RafH;eu9l6Vo*
z`voEfe@jZ1Wsi(HMmgl$E}ZjZo;9kbbzP3|?*(Wc<*ez+9{t@*9PN&uutb6HBC0Hq
zvh6U4iI;-}7gPVit1#oNGxrJVfQyf$CZ8M4Tvaeu<96{L`WKBMs=v9cXf6GNueGw7
z_3KYV|2?I@Gf6Vu&nBNzA_wjSDq1yS2DP``5ie}1M+>kIjoT-^fk1rVOPwJ=0Ul**
z<(cn!kBG3X(fbgvw)tio99ohqb^G$&WqXK=yZ$?B^6fsGD_1<pC7FAOUWYyfK~2J=
z@I95$$6W1{l>roS!I*^k`Q+s%-!K)sb~MBETg)I&m4tr4%a0;hTpjkRKS9o1mQ|Bs
zB!HXsX4Qs`Mj@A!ryJWu`A7==FXI+P*tKMZr15-pmcQcxjGjY_*A;}D5}s{pm<-uj
zvZ)&yN}ok|*?=D6JG?<wxkFkto)Le7m&!bD_ch&pH4h^lY}+go3UrUgnXlg2M}%pl
zH%2GjyU{8nCZ4j5d0SY}ee9|DMcWVq<ePl%{Nkj9@G9=@iph63#&5mD7P^EKs=ILv
z)&mpu6fsQ+D|RszFqk8m^>IC6T(7YZT~JRldCcG2P39!aNqv*<cvNcR&@xt)j{59j
zUtMS-rJGHf$5@HVG9CrF8vE`7$FfqbL$}N9D(~p(<btWfX;FIjw^a?3d=D`k7<{`O
zop(1`a>b_NGXR$xb2^)MwsgLRH^q>B>PH#3CFH8*>j$s2csN_wH@1Z%0<c_Gi{e=1
zwEz{C`(a8t(l#0a5F>LFwnFUkQ+N_|Sr_~<iPPg6<!v987NR^?-vFN&o_i-*osqbv
zCeeH5*9+h*Zs_-XIh((GIEI)SYXqjIU(LqL)C2fIZPOUhi$tqY#MxY1l=@7MOTetF
zMA1*{T<Nm*G)0kU4QxCV)^Oef!8`q8=PlWu0gG0<l_4O$%z|Nib50OV9-iwB_7i6Q
zhm`J>ubZ$5R_YiE&30{{wZCM)KaUud3R@_0gNu}gV10l%+DUU#Cgj#PCG=*0<kuL^
z{llA~fOo-FJmYbDlZB&UMUiWq=L4WzGLZ~=%oG!UHQa?@gR7ODVdd#%)NFu0_|ivU
zHuPKNy+i!w8>%MyK$b3Hl{aC1OPb8#5jWWM4RmB$%ACLbb~eJ}K>>^Mar;dk(jH&7
zv&^8U@F?F?3tG=GZZun+>eX8nMJ}N^_H8ac+vNzMGGcTNu_1sKpUEdB>ogmZwKa8p
zjCAQU&&SOPBf6=9{pIooK3?sIO6>97lUvCcnpmTiG01-ZpDU*amumYSi)}p<A!;Vk
zEYGd!I8?vS4F;}SL^=bKK7siVYHB^op;w)98?U(2?*Uf*^PSF(5`;i<%}g<VyxR5G
zpD%+)?FF)?2`~=v5X)YgqzzewQq!B>QXK+{@JN3}zwZ!g`4F;7mQGPD_@o(4ijoUi
zUDj;+F`9Ix9-%H(?|jXo>fx&uwOb=hCr@^!>K(8fDZQq*3Q~z2;affCvlwAEf{Vko
zAMe>aKRD`N&$%Iu*6Hmua_^tT5G7{A<T(feshN`YoG_xs=&MSb4N4F|x<XiQfQJ-r
z`mI(MPRvVa+G@>XqYZw#2NaQ6TEX)6Krv<De!EL(ak-GQ!eyR!b^`m~XNGIAr0zyU
zWwYG((X`bM(<&yvsu&)Wsm_SWt5}DICwyw<L|>9=&_b1V$0y*wEuCz?*pHfxn~j`6
z%&Q{=QzTaBo(Ki`>+^IOdEXS-GS>e78hd9Tc?%$HH%1~5BjFxDpHakRrj2=2Id4W-
zlpP0{?Y3uREM3-cz6|9=GpweMRk>c(%Fb96bLD8N|Hs3p^5@M(PwA-|SgKl5$9%Wc
zIe=tarPYH*FBd0HwwH!;Fj-niyVI;j<j@5XFF`6L-V6g^Fai)q2&~}n*cj%y2hbDY
zoxr4!dO~`i!)22+l`~TU_k=z%T#<cQ#WB}i&+-yhsR8H^rsQ|55>9<7(y0~7RZTzc
zzNMxr{-MSOb^OwO+bi}ar^xN`!YA(8!QFOr#^{(=Wh_=6{*aiR>h1^7`8uua+MR>1
zW@clNTq~}8mjUaG2fJP-YsS-0|6Snu>K!Q=jW*1iGZ)L-kN&OD1S3BA#Ie)-i6Pn;
zK=szIH{NnKZ=dNgI(OMtEl1#r8QTO<5PIIC<#_I8yY55I!hTt0+z*QnmCOoj*fHlI
zAg*Drf=$_~>V8>b`BJ8-o=qBBU?`!O5{mt%_<A*Z4=)})VQ<}}k{XRDg`A|9lXO%3
zF;`^Mk3z-2I8aY>Z{Rf78Y1K*2jl|=ete;nXyTx8l=ioiH`Y(?QcK_T5ezZ57f#+z
z02o#xUwIN=bEe)_BF8sjJh@1{pl{pv3t<<cz8Ww2mWW0CYJ1=NPWO?qa;?Uh&AYOl
z$B)_ZDk7{t`Xt^R3S;+*iGra+pmHcxyo>WW&7EH%@=ZZ@wZZMj4;sW#see&aHs<et
z!$S=v)CPGu+jx^%#0Po1WE}w#Mz6V68KIAkZ~mTR^xhfnsY|3oA9hZ@{RZKt&T<sL
zM*r1~{*r~T`Ki1qMtfZ0L**BJ^0a<z)ft~gnDT?U9jH(8ct-+ftSU!mRXcjlCplDr
z|NHRXWS(Rl+0VZ-6HDguoqrU&l<8n*7S9WD%%c-|e$v7few%Y3%FY}Ucvmbu%Edse
zHO)9VI|TY5>h0VTw0QA5`J|>UZTINpu)3Pi5&e9RddzZ6zJlU+eYmx!OVvHc)V@hg
z(uo=Jyn`*z^6XklhI<X5l;rCV+XVrFDV1Kt^wHjc-o^iqKZ|=>%szyB%87N?X!Al)
z*@lznJcazTUWww;09)@@0wSU!)j7puOY?2DK=g&wD=J_0cXXd$iCc?IDvtX+yGC#c
z(hACz+jUO_+%4sRlg?<O!u|nuxm`q``t!R+SFGEzdI2XD;B<%TjepG;v{dc0J9*25
z==GoVtSH?s6hAbtb?tuc3j5tk$54nXoLC^(a?t3(BaX>8^Cm;RLT!d)$i@u(f>66#
zt=g=LqI?qza1aO{ewW3t>I&}H>BfimZas6ay8>$@uf7Kd`aDidMWjVsyLQ*D@;hwS
zr8}jfe`atqCezO->jneD%grLVQsI=;chzUX=2ea-!$T=<u-RvJDJb|tvzo!veCq;>
z>(>|9ppdV$3m+-$-}hlj5bu6axSzbW{*(aWn`js2&ex>G8xVI(i%+Q#F0)-$uur2Q
z69yv0bUqa~&1wH7w!C}{D<nKb5(-hEzZZf3BXEoyDcL7PYrC?-g-d9N^f(aNEo)$T
z6?CADBwHy8NvG#WCy#?zbrnRws|WPO)%n_a!Z;zCk34_7cDsT%UT`{B(O{!lRj}Iq
zbX|ym%gflxtsNzAi)V})VG#mdEc7Bcf#WM-6A$+B5Nyg6Q=mWci(x+qWWKIn?jgb1
z4_5s_=e3tB_P813>c^Ak=ANyQhqiV|s6GuMU#wE@AM^+XqiBkd%RhLRsQ*#>6UjG7
zaHu=IRhY)o_VIW8N3#Hm*sUGC98wzpVZy-sGy3_K1S$u1<kkv3TSxXU`qWr6nT`kP
ziFaax>|xH93(o@+!RS}9@w&r@&Y(;efv<w3htRaZCkpR!yuH2=1^tRt9$0;q?md>z
zW^{MUIoiYN!B&;xH+v`)F;6DR`_K~=W-}-7p^ixm<kk97iKhCqDZD)z0zyL#Z!1zx
z@;(|+7tTlApwH+mj4AUA#%Uus>tFSe0ae5Qau{A<q2pufSSL+x%580*wP)7PAyR)9
zcc{O5pz+2zy5ydK?^lokiy;hjFJc}vyEn+9Aj&G@zz4f55)2dXi4c7I-_M`H=Z7A!
z=EEeZT~H8=RRI{)g|W&p^l$1VC7e;IIEN_km05F<oEj?6oBBi$5**lv+7_2@<E2)U
zhmoy}KXm13f{HVWw5++G`Yx?euHw=~-Kb<=G7O?f!x4FK`d@spiS=s07oB;kAWP$`
zeP=p%Ws??zFDE?Jgq2T`)IzZ8U7YZPVzN=SAOCU4B_kB_STuK#x@QF{2J9l#kvn)0
zN*UyTZvQtq+>l0B&?v8fz}m7AB&f=IGyEHC;NVE^1x6`^k*B8z|C5XVEoy3!<lj?s
zGd*2|OP#1#clx)|p$P}R^P@~rjtoHwSSyLl%4QnXpj^HLQguJ-`ezLoJzcJ0zS}Vs
zo!?la*^wvv1GUX*s1uh!C9=W6OBowtQGHnjq{txJSU2nf-Qd$?UBR(0!XN4n8Hl>c
z;0Iq3B)!j<Zv9cdahvQ5X5Eb0*`%+TzbAb2h9lkW4>up5|2iAbb`Vx%##Hc_Sa9<r
zvm2FSrbvUS98y08L>T`iz3@926_F}v?cCj?qEJs5gEE{wPl2Efkeo5>1-9D%`wR%w
zxH4(8@WJchPe1-I!v`d6E<6*VZoYUi(9gxNd8up&htd*wOj9uY^^MWFjO(-}4RRi<
z^rzOdzvh=;Ee#KVE`GWR7KqZ!n&BDE8NJt>=mq>|y)fu4*E*MyJ}5+D(8t{S(R1$p
znsy-V^Dpm1QoLlJVSPserw18Hf*5LQmkxj=-yOyGz#+GLIqb9k!^$|HX9sk~5}ur)
z+TdjP%l{>WfD1>$W#a<=y@pE+ws^i5AC^&JL!cEN0P_yhOZ>mlpdL8bFcHMWlj@L)
zRiM*M5>A4fA%J1OY#7bAXqn2<?8`DOBeajDzpJhNu@+H>ZzUPeJMJ${;l+w~-VVU*
zEZY&aoktyu63WNwlAk2?h2Mu7FnH8y_uo*zZx1Q_&(oV*bDTY8=N%tMgECuTX4cG?
zH8MO2(~LND`tTBzb@HzM;JN~|%wr;#MXwc`l!;ENh)~dYAK-l5h<!&UV<0X%-xRau
zr!<US)5RsP?Hfc*;dP+7asSuck`yiK8r<;<ptxnnyd2sLos`CgMHl~ai^TN6ugCck
zg(6>iE8m#kZU4W|A#vOY;L(WoUJM)niPH9bp2@s?F6F-Fyx<dUB9BUkk(bwo0MA(%
zAuDHd`dSheSHrjPv$<H_)i0tuYe<*DAJZy~7mQpk8(``*Dr)p7dBW4J!{m`7OUpT8
zhoIYbF8!w&Fi|2%20#Qt^_dxgEh_%dX<lnyEpp$#9gvsQ1KlmVmfDnPAB6$8Rw_w^
ztrFp%w{h_IUo!MxD|?DCrK8<k?$`?hGlY&;fDB}Q%v;vchR58&_nc}H2?&CryHP65
zLNwXW`|^XPcK%<HE{CqtdzgGP40;$gyzv3SFelEeElx|<gb{PGSk*s_hAZ(E7Fan@
zT!9UkH>1Z7-$g3^N~9Yah#agn+C_4wD&F`k+=Jx*oIvHR3~)i%y#x}_4gao&pyyh@
z2DDh_-rI2`P_8Zw2Hz2Cr{ek<E(82tS@VzTi`6S=RMUg5CE4Q#PrLj(Z%CLT7Y3bO
zMWanF5;oA%0+Z7GJbq{HgVBkq62<Jut6c;eKJHL3=kB|rzJr8bX{I@bmF*@UnGtg<
z^}ERX(+I>11fg0T0YJpv3Z0r{5rB@%`XMIdtm8k*R$n$|t9{mP)c0VI4X;)iaZJtJ
zYHzrK=ZqGSYF`HC<(8u#N@6G$YRBF_J?8^2rps^ayshq|Fe;V<NwCwPoer!_-KNS`
z%E}nWtI#kQ<4{yA;19(ELGRw}S6%*n=n45N#YYZdqqWk@S%boHZs;c2n@YSqGx>z#
zGR}*<`*#82Q#c_NfU6+}<LuSAM~+(~W|5VE&Ee9xkJ46?E2h?`G2k(<-2N9!B3l)1
z0mAZ+@itDWSN!|f@S#-#slG3Q-uGb#(pn5nrY{mB)5Jsdf&vC;frS}2kI0a7D^5{O
zZgXgutsJO^mK6;=nTr><g|T9KjI1vC*Oxn?ck7P>ZsXOQ=DIN5yOklus@&MIQKqx7
zNQ7W1rXN(szP$6zYYT>}tA>4h0jA%BvPFw<V&>gAX6@QMP?cOS+w@8b<`L-L8{?0G
z*IZEVCU>>&&z8Ka>>Es9F(!lYC78Esbdb0h6t+kuSq4rZ;>Fr$<AdwhW&<+D!?goh
zcc-c|=R%bKy1FW0GZgq$X3V=^q(<@V0h3sS%78`>XK=DT9+^PpS6bG@%susqBJI|n
zdm&U$nkwLW!Z%G*AS94hfQ(A3MHV&DDZ;MX4y-B`JD%Xl5ANENjO!6jr5OepO4ry9
zqeV-O)ziFK(~$B0*Tx-kTw!9JpD<;d4Y#xW+f$vhPrA<n6v7Q9V4VF1WI*Fb&isQ#
zoG{{w$MIUf6ufSK%8y@aI!HhRj4o-X6^_c#BK!3vse1Ilk1Tc<gneZ5sIT>3(<)bt
zEO4;*Z|eNBF_|D#u|9}sVjogoW&TYX-@}qJA~B4e4PJdz@^uQp{&a)QBLIy3BBocf
z-Qn;m!Z%)=w2NtR)zhgbW%{{P=2wu5MysR?x86>asVJ>T5I>^|2J1hhdw|!&j$h4G
zQaLU^$h@;fYHB!>98G>2iYj9RP73BK0&%8H>m2FjEslpKv&-lTMUGcjP3K;$VfNU7
z8(MAo(ZtTgI_joa9sZfB1pXB!@{9b9SaZwHL{8vR%)i*9K%_l{fc{D20U|*yU_bH}
zCzV9ZTLNAqf-K!=@5Z}g%=FMVR^{2O{XbDa_GC&nckZ1VaILOWfG&Ws?8cDo+8aHz
zLE`GaqTK#*`-yZ-J$j!SBVFtf83;T?bJp&cy{<?jQ$_0+akaCBk^Shu`1K!p^H?uK
zQ7C;80+3K30KDiJ0zr%cprazjd~I0t@Rvge1Ce8%i^K?F`y@urlu28UF15F7m>J;q
zvz^YBagfD<&O(Q`AwCk*oXW|oT24J#ZK~^1!{CX}>wd&NU1HcqxJ}F=CC%0Q13ix~
zycfoMT(U=yi~+L?Kt1IkOCq-Z@f=Hgx8G5z6n6D_AVyn>@M?W^Xu?AgcL?_Jou6>d
zU^_I(VBW8mM(mqh|9!JQI|W&tWWm}rb)`atA&Z09WPjk_7wtn-JDn>oN06$l=IYBT
zsti|3Q&N^`H12Tpm<Bl87FzzBzRn;DLJ32W)6dHj$a*3Ta66bJMJ)KnJR>#th)TRN
z_w~zRwZLU1-4SmkyBIS}gpe{NnEgt`HUM$OQ%+tfsZAipCR~v1034E>znHQ8IJhA?
z$Blay5pd4qQvjteLC^_P#)tXb446Nm5Hj*Ak0?t`X}53+Qe#V!R;gvh%|68Q{vMT0
z8BSIF_10Gf;T#wFR_6L$^H=)#n5*Gl(id}xoNfqhi-}}5U_P~;1FyL{_gsgsZMgbo
zc!1;K!5uFy;5}uKK1yxWX=6^Dj#$7opk-LQq;Rr1^WHrv&<X%OwcC|8B0Jhe7q0%c
zB}ergTh*_KKhJU3Aem+jMDWQ>yY)W$x!Uy7QodDkj{ijbav054HwO6Y07Pq;`m9`q
z7fv-*|Ab!l&D0h0aeY2DyUB1(x%y&hjz6ZeAw+pNbn_G0q<A)gVK!y}%sOYPVRpAq
zg+)ANiCRt_4p4MSOJ%;`!)J*^BBkU<A;Nj2u;!$Yj=)0FC$)LD{_9u}fAX#HD-u`1
z6qYSm$XZ}A0|2BOeUEr}MW)eoP{>)3xA4X3VWD?$=J)pEF&D>EysV2IyG~tRRx2Mi
zfNj}4LYIo!0B(YE<|tklO55}T%V80XwtTharCZibq+5x&!m_+4zu6dlk)VHI=aJT>
z1`u`~?17tcvi7?OucKA3{raK&tA7j8Cjil4Nfc%~_W9M!4cvtX&10A)sW95}q~jd9
z?b~Mi-{)8V77w}x3XJG-I{_Hj80~7d%k|Fj%F;cO{Nbi^*A;Rn?CR5FxQQiU-1jY?
zC*%q)rfKnbv%lH|_uiP(XSqn^u?IZi5!QVp@06)#?<nkVJL;R9H@;D&V6JBH_?EoU
zMvFu-cm`f6x<Z36z&DjO^@)Q@bt33rD6qRwaTbn<XOv{bNgkQ>vhRI;+edMe@|3{L
zvk4-aI?P^)3dx!bfMvRuWmdlY^hV$>%C~vXW|MLP5Knk|q^Z;#Vob}QLmoxpL8Us)
zpFL^H-x0Mh&#XIzc~`gkg7a55-?r;k4<=Aa-f`;_RBp^@;!`Vo!?6{SXHD#R0@|Z8
zeGGT#s^*x4ZWC2_C+uFz)aW|D1spO>H<%>~h#aF2Fc|zX1a`W2{|#xfUgOhtqy4hL
zpDG5p{vCCec8Tu~->6u|FRTA5Sd^_(H8~ErgY0e|8_!m$G}^Hw<#q*NmgNACA?r3~
z?YGwxnvAGa0cc015Xt{h;RRiwbP6<UG6#D?!<5J-Y!jII%Z&||&KX0O#?$A-?Znl5
zKWKM#H;@)y0b}vnUXsm+Btwqqq|xI}O8s5qLS_0#PhyCX_y~RNQKuSm_xu=UV~&$b
z{ct+b=%#K103eCCR&A_{%DM+q*A7?ISJvV7zAHfw-vETm03C%PqUXEl)jwyUIk_Pc
zyfN1R;^2ow$mZs_Pc*4l(D29c>p`86Wd5Nbv)g8m>ql-Ep;cha#)<u5t)W!8K^g?o
zvfX`?=`LOt)704juh!+#OO6fgCW|hpPed~9>H^r>6y(+Sge@kL1xkHs`%-_*R7T7A
zH-*G<XvCQv$@rN@lEK18njgM!gJikr-@UR?{fR5>5zqn28!>Ep_ujn7>GQ}{WTZWU
zcuV#3KS21#*T@h0H0^6WFHAppWMy|!6gA@OXe3Betb-g*^?9jJpg5!wTZRGB1U(cl
zCC#|OM;&(i0%+#U;iG9v4r6YT?Hj<`zR6tNb!kLm?LVnxm!iHj_iUu&A?`xNe+g`9
zRqFW2L8OmocLQ140(`mLHXf#7<wjkJTc3N%sKFp8$8ZNQRPCk6L!r{{2KyKwhs-)~
zjx32G-9JfS_|MEM&z1;0H9+|04tGbI{*QhFbP+Ya!k=1>MQHTm)$X%O(dAtLF*k^t
z&(U76xFeezv+OXdW{-Pt`6wL+{DaY(@k09~7O|xL8Tu@g-rGW2)AJxfIu;%1Ena{A
zzk=rjMW0n~oYp?1EhPyrXM@yv8BJslP|y~c{`Yt$Ic}bouk?*qw23Lq2)%M`@W>|f
z&k@u>&I>pk<{hdhT1{PIWCxwK3>4ngSgi>D%&PB)I2b~K3{rn~l6^q*S84k}lpX;4
zW}qn>z~1`Kq9cnHCd!~dSXTTxlrkU*R2K-fC^*9_-a7TWE&kyo!2^~*G<3;a($&<#
zOi;1UZyh(+tEBxG52pt~5YI6(jh|aQdwj15h}pUC-%p$=>rE!n5=yC?pjXaA>?k}a
z)2I)8AbRCyv;gd>89hYyIqI_oLGh9m)V>B39z&%9vjF*?&u3EF>W9w%9lXNhC&kiL
zozeFs|4*>8?yQI&Br`6ttCoWc^hoh;2y_2zL^S8~nS<p4odcSU!*heQ+rp&LdI-Ha
z)VVZ`a`!3A5elSN0HWD^TjSmdb@eRxhUy8ARy=L&F*i~ac2lOv*JCKk!iC;7|8+`5
z{}n_ZKtg?$4`S91Z&rxd!+;n`r}^4+y(#f)O0lsZ71NmeZp{t0yCU@y$lsU*Ptq0*
zd-XGfR#KGz(7bvcpJYF1_h>vqLfPuqgJW4U-Bd+Tdh<yymBK5SCxPX3%bZ)l*cN{X
zhrz!6E_p2c<>7Nm`_yaMVJF>c<`XRzp$^Gy2(u?G;H*6a+?8Zgf>jAU){Yx@J=bgB
zT}1LPa29erVaoz0ba?Kr(4L1KnUgZzsKCDR!0ra!{-W!jjODBL|1kf~*ML^p$N~()
zp(t%JNHanwE}0&23ngqq;b18aac~!4LS3mrGOoU?9!5Jrepw^cf5_%!!|gB3Vbw`!
zu$v!qLrg>Q7lkB!MUa&EEbYdB`9p5h$%1CSydAfic}{++2boc%-zZ-IypdsNFkE2Y
zq7&DtDilzQmL)9+5?%mM!2s_UC0u&u=kWIrwPyq(6m23!H?!M5<5B0T^wcVRZ6|(E
z=~r%q^N2jl8__e?t3o|J_{|eeMle_aSxM(#!vrmIj~{DS6b>0CQKNiPs4&g7JPe)L
zQ9m88j*Xl8EvHcfHM%*{!QW0{oV{}W+41#fX^KEl6mixWrUyeMN)A5%96W!f$5JNv
zdMb}8>IMBbmg>lw2;HCXQh*ub{8^vFPa>rtc%BMM_-O9|MKxx#d_gs$E<Cr4PW&D(
za!-32aLl+-d99v*zDgz8f*gv_bvpnF;6K*%Tle(*?CEHYd5YZnD7q;(LWN?InD2wG
zNfRm*WM|K*5k3N>Ln`Su$bg;OM#Zti^P9v+hC6i=3qenkVwq44c0$4C!c=qlZjPdJ
zZFgK~#OCLVj}vlIS{>S>k~Vdohj-k)#mf>O{qkGIck$vX08o|S^ic9<J6*l=x6viQ
z0Q#w=ciSx`DyJ&lyv)dy1iObb#3lYIAQ>?Hjqd_nuY+0h0JXgxL9*mcyVu!GidBD2
z1{~sq)ri$O05FcfDDM3x^2kKWo)fUw+E6p*+Fxn(`e-(1%|0+&|5H4HAp<^Z3CyhU
z)S&MyY)-tD@ui&r(I{YGBoUw2V1)+ks#65RayC4Jck(5&^qV(Vc!?aI@muZ4Uo}yE
zg8V-cy5e%!*I7AL%Jzxa;Z8jf1r&UyW&wNg2-Ti*sPuw1_8T<M@%=|`nZ+@y-N$i9
z9cS^ZDNuKb;K_x4n)RU{@CDf=mjvO(Gxuhj12}2;qKt%*A&w$y*x$mUZvqxJHlF!x
z@?ssOVZ|uCtQ0(X6snpGUWAo>xVEq_!cdW`(sQx!r7$TGA|n1%FJ_&BW3gMuN0)ak
z;SG3-h8!dpW0%~HJfqO|K<TVTV>%+<e*W-~O2DINPPG9(!<?w>DHWvkopvKf8YN#{
z8Rz|Nz@}wo8)9QtmGGB|C4s@X|E1yxF#SkWYf}FMUrN~h8EQ`ZAv(#tg4l8L^Qv!S
zs~uR~Ti)$STOI8e++o!lJF;Us?&T1$_Sh{H4dk0|&0XrFg4+Bl2mybfuclv7-q2CJ
znN8qN7T#P$(e!sE`}KYiV@RFh2KZs%Fh!=EdpuKod^C%^MVoJ`W1~&3%!7E}9RaaG
z;yw1<%>SqWAn0W?tER|?D8p^(evpWwE<|JfNq>Xl>`*dezPAz)F<tqv@@ZSNaXV%U
z&?3KlQZ8H8oYDai6p#CGm23hYbld<~#F5VNZ?dl?#Yo|H4Oq7|=e^E=e(oJoQz*(~
zSdBiws?iJ|;Lw{1@GTE)5zA{INyg>8$fUT5fQOrB-KTTCF82SwQ_%12gGe7sF&|E@
zdS^s{Wik2^0BimjFV4X(YYUsL=GJIb6~6@ppve?*f`n<(xz)yiGR&hMJ2fjzudGv3
zugq(N+hF8;+pV}T#as~YTXHjsp|@P0y5D;4M&z^Su=wrIU}RT2m+wgnXg|G|`Jv={
zqOjXpYwus(@gdeh`CqRRmBY~K2kz%1Bk0m>>0b2pIV&<oTkN)qfBb4q^FlBs{oEPj
z`-&~SkHJ-3Ua_E+m}f`}G?EJ5hj_68{>lVSJg3JnI6N?i@9v9)v$JR}3u)~OuTYOV
zDSdw-3A7IJLIWP`xI53?YftyK10k+{*@q7e25mZndOM~Zw}V<3azEebO&0mF&MMSe
zZ@J`LNqWsX;NkG(EeKj@AysanPCa0lW0;?&PW>iz+UW7tIEzYLGJ|KysZdepETX^q
zGft9!ZX`tEcA5sl5T|+66ff~RwVv@3qmP!-i+BVWBQ#cTQ`7pmZvnxzM6*bm!B-}`
z%=l0ciYAKxof`;*I{3TvQbUXJ?%shv=G|8P;|QmC*$ED#fnTKQmHqDrgmj1(X}z1i
z4BUH>u)tj{*a#oLM?nzJs}&BP#!xsu&3bu=Aw@@_B)#4E_VXo`)>a_c#F5MVzf&&7
zN=iq%aN=ZjE;uO@B=+{#kF(R2tJD`*{v0n}b}4OA_xe_?qKM-m@SY*;kYhxs>X@EM
zstRUr^vBefsfI3$3~wWv$5i`z>X@oHhpvPASfmYhXG*BJ7zk=lN>%`(l0e_rO21mF
zClq)hB~0uAFE@)a(w^a>Vfl)o=S8d)K-F&GwA^F9BX>o;mIg6~d};=^DH71GYXWob
zR&01~l(U{WYsU5*lI4wdsI=|Jz7J5-NuGob{#TdjNxgE@g7XzL2DA_oeVXXgel-yX
zsXdf<SSd|rfAe|*kg!CZ?*$PZz?*F)qeFsMK!}C6nxnO_K)EV!PpK%RlMam>Hve1*
zQc+&ZQ2#1EO=y~IlEYLq%RrIo%4^}xI)5E1yw^UJ;yvUu@hxWv`ZW5#!m~*-IVzEj
z4ExO1o|q8#R5cA6iF32vfB<(}?gEPA+_9|F|EqwR4L9ylfoed;a^#%`JI&Etya&@Z
zMp89_!>JjeuIAs%G2@1CCr2V8>mz3rk<Lj<_rz^RhQA*Z^iR+e!&`4w>vXv%3~zpY
zO^h|eG#6m{BAbV2A6!ux6p%hfn(wMiHJ<T4aT9F6_2#kpU?-TnJ&yZ;fq(n3=i!g-
z*fRBbY&N##D{KZPa*a6J4Qc83QmB#e4-#DKqqK_Di4TYz(HwQ_1%~pY_9+y}KQ%q9
z`)GXbTUeT@An3$_=Hl+>wURsz$=l9+On+6wsP{%WKU44H_~9Z<JsP+Sb-%Em)lY99
z{AOrvF@zqs7;g3VXw~qK3oUrof?GrV|4uayaadaZv_hSCY#DkCd^bujL`e@3&V|G~
zi?85PHWCLxPh4)H6<BpNKf<*qjahb=rnff`ql%f$!-%_F^Lxj#&UW&o-g+mJ6{3ET
zBb4rN)1)=4y23+_nvv4}4AEra&z|w|{4n)6O0YP^Dysp;zRb#G;+~Y^sUux+G5!2h
z?Aab#8s5e@ok6~i`6J3==YQdbWSVnzr*-Uw*Rfl4!mtczys8J;`~`lp&B&CsCgtF%
zH5z5b;4mP-+`vD{Vo5U{O2?-i)6a9d&ldMz>FN3z(it+bIbEjLUe0a81m6o9Vcyb9
z{4WwPrsRXcMW>pBtcULtWRJx^Xpd@3UUT@pIEh0^Ix2RWr0uFC9^Drz^R?{58vhuo
zv|pV?2s`9u6x1Pnu|I}?2EKgm#m2qBf2Ro1`!+*Zx^=D?aiPIA&QhGupLiJw_*`_O
zfuoyCB*G~Rg<|?BeixU_Su)1x@oa#)b&>?qUryS-i9>yFjfZK&xtiK=$?Rs>5H|9U
z87npWIRE5e5UV#|tHY;j=OtcHj*m$UgGHwYWk>Ay=`n#kDU49fjsEzF{MrL>({wEr
z`dLbR#hf>ITms%P)vgXI;romG^hif5CiQo{@F~4p0##)y6kX^sBOor!z6MnQfwI?1
z_7v@zm6y)0s?IQq^07^1u%!s_vJNQpzxSyTfJ;D{Q7l@l@Aa*>tz}NTr}yLyQ=Ydl
z-}?L?P0!*T?=Gnuw6srewtc5IiW+r=fbLy=YI|X7yTo2_E&n5^G&Hw=K}@B2WgFa8
zR`-cF01eDxJ@0u>Z-S4M7MSbhz--@U02mPfY>1bI;gI*>%*uKh6~I$&vstKLk?~!6
z<@9dH3P^7@d*Ge)>*nkyos$U<jkHAU6*F?p$#(U#+$mj9+V>V|I>93TnTy(_cRCHm
zPX~-FAv8lg*#LdaJ?U7s84B4!1lT9h1UOXd92^tOFCiG#F{|ratuj5=B`0<=Y!gw{
z>Ci_SN{aHxRtzJR!F*)2-;FRWoSZLW3a(|;IG69?;Nx(G39rMbm&DPC{H0eQ70-Bi
zuW&kz4G!zP<eDE=tPpZESm_J8%#*Gu)xoBiDP<_|Ko5SWw;aY$Ujs^Ai=D1Q4EsEz
z%GzGJkcaK9bdRpaAG+ADHub8&zCGZ(=rYiylN$NeKY_DH0@pq7kW^r(Eh=_x%_qy&
zQ3z$Cv09C;xS3Y}o_r6kGZiv%Pfzdf-L*H!yLlPu&UreW-!+>#F4toRH5(C;m^}%(
zT4%)rU3OV>6Idj|1>rAY*7)d2(9`K@iw^3iIN(U0<e<b9?Wxa481~@rA8_zmYigCq
zR87!fNX67)z46^ZX{JcmwPq1yS1I)oc{PE5SA7Vn*39W;HT;{39Xy1;2UA<p+T<+u
zs2hL8toI?rU2QRG?8k&O106Q3+@LU;a1*8>+P#TO_KZ;yduI9;e3)SfaGG%j7lmRe
zo%8_Oy2-H3!ku>IhXSolIGr3UBN<1-m38#NAmkH^;YL)I^gVNhTz)>eP}<M%cj-ct
zNJ|?I!<DSz09}IPSYbbdZq_27t>83gJ7>HCdXSFKC(IY`p&|99cs`n0b9<$`$-kat
z^;!*seHrrQY5K3ARw!T^Ga^-DhyA<NZV2>0BrScROxykFuy8FV(ly@t=Ec!q+jD|V
zxP(C9E`*f(_n7_UQ=YN3ZemmE`gwR3-GKH~Gf*<GeXW=WFj)pfChL<}q1>nvA}8R8
z3(Mw)2L<S&$s%HaXGKIB;ndJm+FPqCoxos!Gt#gL_AX$S1}&grbp0m(!E)kqdg8^s
z$Yj)K=@5T)Mj0OZ%6eq9)0Wijge&&(>Lo-O$ko5GNleBNsa@^s4@IgxQWUEV*9bw=
z_jwS^tf~=?69V&83QVSoRP8b*6v<<x*TlprLC0k@@G$TB?T1gQ3ARsK^n$*-DZ^NC
zFeh<OzoVlGNM2!ea~Y3Ct@On4$3M*ncBrDzyh4==<2?Oi9okk>at)tTp?Nj~#tCS^
z%x2;LM40Uqvt4)_Y4j}#5%a6-5WTANoUM?V9sY!;E7c#cCSRn4Pzl305hcE!>+%JH
zcAY?Omh2LVAs5Y~3B&IC1Rjmln|L!v73?h|*Eh(v{evIJO~A&;M+cfXZ++&&6l2o0
zgnKO;4=?OO+N2_KPQ18}Nw0y1s>zzJH99{Bq1rjIheVo@itZ)ZqeAujtF#0dVM1KZ
zZqSFd6V@L)zb_vdt12s#CB5<(CI;wp_UKIJn{+i9MaGX^KlJ49WzKXyjpL0eBpH4-
z#&$J%@c_Ii%DX2C>(rxiio%<(P1m!wo?$IUF(gCX^RjkP+!B^~Ux?9F5yvM(?Ct<>
zL$uK%oi3`!v_9ByMQ#pk3Y3xOU7K!<PY{Y0k81aCJtBBQQHH|q5%-Uy^(<L_TDWtG
z^eZ{0_zVVHxb&NolxQUvr~_zG+P7h?XkwCIZYs?3EH)Qr<Z@8(PNiT-Bt<%Q)Z_99
zQXrY_-fLTu;qb-DV+xo77_-39Q_Vgnj1((a8%pPxCY9Dm17_aiUz@rbRv^y@KboVC
z&PaOyho`p=XzKg__{SJ9dSf6Bqf4bbMoA+Wqoh+oNfD439nzq5DT1&Gh=|fTKuQe4
zAV(=EZ16?~PWHQgzQ5n^@9mF!?>YCLb6&6K^YMfgp{!$dtnAsPEJI1NqmN59)-TaP
zWk@mg4+8LzNN-s3me;6sgG^!n+(NpfLg@}11{=C8)Jj%ttRB=MrpdEhlhzFe`CSPb
z41@~B#V-|(B^^A@lO}%BW7;C_Oc0CKua>5#)k={L0fY%hOzqq1&TQx9rI?onLMjUO
zbW4soY&L>r`$Z+B)x^%i{vn+wiSNSJy`K2K`^o9yX+z@p2rcOu#A1J~;p5gzV>*l_
z0)2I+phG;>@CN&?W^vQCjKl~1g8NiF*oNW#P)Zz9Vrpb>a&l=qs<U~2AfC-<wYGb%
zaFVbe5&buKI1(iOMO01cF|00#65aVHKAZFGQ^oL@HW`UnT^I!`W)Hmg>_ak*BX9Pn
zN}Jloo3gBeO?UcRs1%O))^lya>Bb!Tp>NK!*=_bJ;YYRwXAETZ;04V;`WT##IN)6I
z!b>+ym%GKKgFu9acRi*<q7=kzPZEcwFu_oCRq!xEv3p5=tQs}$Pg>Jn6Vg5U@4CYs
zs_N-{zmIoX=fk!=({5p4=5o?rrMi`7lvJLPX2&8EgJMJ(glXelL01cfLz7n+JBDeU
zH@_DOB-qh|qgJK$#Q%!%CwoH*)s!!`^$!}K^BvPI`l`EVrzhXNcgCb<`aOX5OCSHT
zcOE|e67gA1c^ZA3Gg2|9AY;9tC(Z2mzmedv%tbrQ6S_;+A}>t#`O0pIDb+NSr3ybk
z50;8dTAb)w81(gqvMjyvSp!KE#r)2HIy@d-;73ukUXsNHmE(6NTek)7Pa9n^Unl1o
zLGOL~85GAgi8G!Bs$i=IVD@x%W#^tZi!XBY%UgP>KQBLtifnrKf6NVGK*nI2zQdcm
z-@TWcL!T-KksCuWVSv6Ef#yP9$H(q&*`Sn*zbn7iJ=oh@p}Y4ZB6g{5b-8WT@LP4h
z_7x$-J1TW<?KV<y_uA{q{=+jKI)RTC$C(KOQ1t}U_;^}2fdO9nrpLr1N>IlN>yi33
zvHPgB43O3v@fvCZEAiLWrWPu>w}Fb^`kX?Rt#FSrcHg^_R>9h=1;07;!XSxk_zYA}
z5cQ=IZyXg!zU2wTN6I_&iOSMDTk@BrHI}W3H7G(uXt=@+Ma@e)1Et-{QRD*akf1bz
z+Yr;9xEZduJ1UjMlAO;|Z}l9)jAdoOCtLf8cf{vNy*pWcTsf>@lkl+c{6RFI^M37d
ze1<%qRb(ELZq+bT#`a{y4zKT1ah<c7skS~+Q&-X*(XK@u&_KGwgYA#|0oXXnEqh+N
zPQcMvWLpa8NX>KKt2i~ixq{d9SSLR9UWZvTh=!eUepM7<Pu3`2*n{+meZfFWkHqj;
znrq+IgL+s(#mepuTIHswe5&L!>-T*5VI8%$uR6;mD8GGcyIi)?=y6`*_fJV!3)U(n
zD(UsGYJsP?i|4qc>9cX);Xm|sil3?``zaj9vCCf;PgaYiAJdF4Pi1@>5PEfW%zluC
zQSVLNqjz$@Nb3FfS~+gwR*NGdA{K_!WA|UhO1vcAh@LKV?)KQGQTnHw{t_hg>n;`1
z&gL%8`;wO8Hu@)<xT5vy=sOh->8$yF@A$Tf_Cu3|f2fvZ>%)Y{POhT+5txKDc%r=7
zGBhamQpWH=$BffV*AOT(;y%$9QK!eWw2#;(;QJH7F4P;If-(zQD-iqWZ`$RNPyx&K
z#1gUYUxQ;n`#@*|g=%smuY`bbGdSQKT?O(1B0@JVyy>1~>=)NF!$?B)<hr|;W0~Y;
zDDWMegZ1G2e=}zcOEVu1&5h~l+*Pkh6w41QiE3{T#}-4&$F3pzxPu87+*ZREP|<(%
ztRT}GEJyn+sYZtvV;%R)8fYg6ES4URkOXh>M!kP@sH5@GH@8*$@KXRwa){eVa7tob
zccN*3u=J_9KX*udKQ&udWreXfXY9A;XNn}yN!s&CHKw@H_oucLEu20VyC_GuIK3u_
zr!i$*6<eX95-~<+es2hSf41PnYd}9#tX5`G{JFs&=I5!i-w#qqB}*&7Ktx0k>q;J+
zs>kq;UJ=lbI*!`|{(JRdulnmhl17LsH8IAg5cx-|;&<&7E@Zal39gXr&fg!+jiwLR
z^4e7o%c5qV^jYJ*Klzo>eB-%;H~Zdj-#fMki%O`~)X2pbcl_4r4ksG5-)VK&@f-6H
zqg#Faa`PwrP=KvT>0QQ3jkpcdk|@vY!{W47w0+Bo@7s=O_-fA5F9Kutf}o||da2BR
zr6l@2z}ez=wCF}9ANxl|010DJ%N|T5rg4@d4k>0asis!B$~Z=VZqyY>UYL*3TFQ?D
zP(J|n=YN^W7X@rNlvhzB05Y+iD?nQ|N}i0QLwH?pxi{Kq!s=-c>qz?_`3LxOE<CaS
znS@3*K}SA0rnvj>{(5XsiaJKBQ7Jl(d#L!|(~4bbNxAqBclGk3e9&u|uMfVauOxyj
zfnRQ=$fu~?t}OlaYbD|^hRey+d`Z1LMxi{O9x&KbsVn3K3|I9U$ROFS7sCR93=TZ$
z@};$)=ElJ+hI$dlsf#pB-QSO?33b1G1?2Vue%lYxJV=KRAyY^XB28q4>V2OhMsE&(
zcg@sSWtmpu9r&`6&cPTXaXL^EHlq{xQ__M;1$hOUPCmgD{2_>Xi5Pvpvpl$5c#(wx
z3V6*G7}Jpmy7|(UG1{C`vWaY?;yfvyHGSrmirPA3_1UK|)8Cku@5FD9a>X_<Z%>5%
zzTZ{PP)kUhDkVwgs$8R3bUJYOiz8e9l|#J%JCt@ovQ;Fl>Z2{TP*D3h#`75+6mI>e
z0XkVAx@Q6L{twlUAIra(nFDgrM>Q=uzTBFGzRbO%==og?YC&>><SL+_I;%I&5DM;!
zg)Dtgbf%{01nup~ah1*EgL3vCOzN@TruZx^E!yq<SrbdyUJpt&x(7nV-N24D*vYe`
zjM{#F?(epxF=Pt!tF5F#y$YjflYTIG8SY(pfpuiAvpx;p3Zd5e+~bQy5ubi_so+AA
zEO}sYip~Ybbd&3MPp$soF%Xw&dJ?VN=w9p{smjKh32I`g?%wz3l^ha50Pc$EOpGi$
zZ}TgFTg@_OVrsK33ZRo(Pj{3_HeKIaVP3QPk+rD%^8@mgaybTO6-U0N!pc%`S-I?j
zv48!uh@eER_HR7T>O5ZRr@a@Z$}Vg^RnfbiwB6!IPBcW6t;WlAEiFxU_ucrFOqBF9
z2NDn8YZOP^h?JoRrA6GUh94}EpEv>}LcDw`R}V9X{t#VmQ>&iX>6?UFjuv>Tt&s7_
z@juk)znM!$k}KZ_)wjdB3xv!}!+g&~U2nxa`kH-|9s@v$P5W{&6wB?hBdXLb!jc=H
z8l?-IzjJ?)4H>)!a+d_p@=A^5M$dFG>)wn1aWTE9DOo>WR>;RX5R1@!BSl~=8V7nM
z1j7iH=0fBaeZM~6uSAnb#wwyDWe}>kMsqP$SB~JG%Gg5;>P|K;XM2v+{Vbw=49R@>
z@$CvgGfp)Y>Q~BKqXCN#XKlf9{*Xn|JBle2;+y?mTSWMNrJ@Lj2f4d3<RX0k%1<+I
zZik%OfhUar`7&^g(r6HwrXI0w_QQVFu(VW0RwV`U*GJvx%nc^%4zUN<3V*m_(%<LC
z_DP7ze63D-p@YGj1(XQ#j7xbcjSf21BbM;|dB5W^^)yFX?lQA<vd&4$t#Sow%Mt$0
zw*bu<HSLVn!Ri>l<Q(pj5X3y)V0L}f_Lwp(ck)eI+)!|Kq6$QA?OhAmaPUL*k&uoX
z6(YpqQ9w+oG=s4J{zhF)q6?q~OCLVSWpLiFCV>OTlsR#$nGp^Wgbt#p&IGR^G3BdU
z^0ZCYDDk!D-^dCU)7G}czy-VGmG1GwJJVzy9To)=af0^$XhbvPlP;#AJ8g&7zsQB5
zM%vqFuUotOf$STecpk^G`zve$EZKjhZ|z3(dYta|gAFFw<HUe>QH=HQnHCis@bft5
zdk<F?)om!STpTGLvs&}<OB^cg>i#g;z(xk%;^kYH@R3!b`FO2Va}<i;Z3`~$@VJdV
zu8cG`M+!Fj-gk&kzp(x>>Fd!lIYhs*@vQguOJCPM@iXetf86--iK*J^Su1pa`6SuL
zK<;h~^jL47x<4Q-Y8^ooXM{K-oH~ciJ~{&J7^R~yMAX(I&%+lrDHqkKE#(+!(SC!8
zEF=1vmBdQmf4?p-1HO31qwINxJy)T{_Rz_urLHCN-2Gb=QK=<;2Dj@Jx9DMw;#DCS
zl6AlX{<LlRzJMT|t+VD#MS3(pIOy_&d4&!b^ZY8%Mh2?pcfK2a{*1V<!(tTqkpDho
z-n0t+eg75L&K?du`RbgB)KP(yu!n*?tM(^klh?U%Mt)!ip4GwB?f<CI?_;$0wPlS^
zz1{rPd$6`f3?5G||H3DnKFu52W{HuP2nRfV)8!kRzhv+pSa*^hu#=tH-Up9_`D34W
zHtnK4{xo@ZhCAD2%n4o^&mi|+0dkM^Yz9Flofqu4zE%OB{zuJf_0-YsU&Qn&xLWn9
zx6n`N#@0_&$206K8NY7m9gfN2vt$o^$jnMcr=l)IX&Qa2iZEl$E~-TcVarT)HR|7E
za8J`Bh5;sNPlX)B09fqEZGlRmxdro2or(PXgl`TOjQg?4*Q^hUpLC>(8|9dZ8*m9t
z!5){qem`Bluq!<ljiU;)Sj%gGwzAp;hk<fz_9Uz7a@4DL!(5~YVeP3mZs&v9XcqH9
zz4QH2Xy>vy{Mp86YsHdy&(|^@;Fzx2)$j>GB?AyAk-EKrt_QMGKyvxl<_LTg#WbD7
zp6&(^W!7XDuqXa^8a1+h=<~$&?VSQ(WkwKg%_r^!BB>>PG<1gMO6Nwl7BRy;<#*)H
zr9qJFX!f)`j5?tAy_+Y0{*4Wh!DL;f@yjw$%X+lRDHPtJ_*TFcz8_D;tWb$!GGz?%
zq^CBJFzQNtjQ$JmLG(9X{*j~qgaoYZKFqCUSJ8vH512o5dU*(1Vu)3lzv6^*z|<UK
zdD=7sT=#zD)B=_6N|Pq*um|q4$F~MoA9Bn$DKfGKR`$bgV2N$}!@yk>-AjFiP40hX
z=RT(ASv(VU_H6}1C;r~m4<@GBliBw6c?nl?JbV*qf9_IA4`-6wvD*YWK)Wb4T{d?x
z|4L4!N{XP>j03V{m)oTzafkjdp(7J9Iv3kU!kuP4fCq@!ns3z_%KYcUg)*c6wW_qX
z4@oc%k$lAmUJFSJS=ZKJ_8{)ksMuut*pXF8%i*CqW>Ve1zlcodM;`|9p1)4izuZ=Y
zkD~*RrR*o}O41oXWtts5#vyvV^vZ)!Z^R!X9tN5}$^Z*60Tc+ib2n)>*P-e!PE`KV
z6z|Gl6&w9UahiP?kG7mlPT`*c4%E}<o);@wlU;sDGotg~UqIg@Hn*<mCw{(s$iFr$
z%6I*K{V(!0^7jjn9PaABH!s-C_w{iN7_VR|H<R)o{qji`8Y~08i|vYjj)hS>o6R?)
zoBOO%Rf*R8fKz_>D$ieHeVGSscL!AXP0JP|J3BE<Yfxz9w*m3m+EeQUX7;FvifLYv
zj;dP?3_jt3@7zz?3^1zp$Jl1E!*DkV|5gnN|Avx$U3AdlohOdVYr^SyCKq$xr*K1o
zKDTF#+Un1d0Me2S=&IJ<><kr9lKtPa1*^KC??2xM-qo{R$H?q!*k-OUzcZJEoh0UG
z*Uw-up_F$56-s_p?AmnUwo5iWx~8uN&b_}j@0&;1AWbkbT{*9+dz&TV6*U<wL984!
zU%f?Rc<AanbMALKd{$qk9Lx@5@=1if?b;pwaPvAd(t&v&Bxm=FXZ^nT$E3H0pbI-D
zEUQDhM6&fN2+6ujV@J$tSXhOE1hNt-o6uzF=Gp2nOUJH(B_;4jZOS%vQF3#hT=k?Z
zSy(B|cG&sVTX`i{#vaWCg3W*tE;n!5TNvS!T0H(@{aX6FlT(7Ef2g~1^0}@zeuRi|
z?BBV2oNi~<k{cgyg{V%>d2-@A66fsj{zl|nl>CK&b8#L#9c^pX#u4cRi2^<V0`mlj
z^`<7$=wWg1PN*#WPA6TB-PoTN%`kBMWzbyFh-d5cF}-pV>f6w_{m+4)!C{o7xyXw*
zcf36@Vc^0_Hf=>J9;l0Qgy@X@G#vuf8we-+(;E3v%tKQlx1HIU3aMuxWUt++0vnXW
zWR>NcKjscZ@=Rhq_0RRE7c|Mww7;1KihwelO~6;5Tsf};vJczs-{)!>jHnBI?f<vI
zyXs3k4Z?~ZTw|8vuMzrzE}@?O<$JR*ND`CgB!iNlN^dUl8u8PG$@Gh`m0it)I8{!q
z7^$+gl2-6JHYqZBzwI2GXs+<*K^{Q}y+iOYUySc9CH?LK+NmG!s-c2Q{R?i<UrMW)
zf|Pa*%r-3~#guw@mxpt}2IYVf{N&c?>AUJ)VZVJ9lxn~+7P~nYnH>>;j`=EfjSvL8
zW6!b8ga6TX2q9Lyxfgf&zwM(F_CiBXW%uFE9t#30qbUG=u;55J<8%W=ibR8h0EY+=
z%Z;;^7Am2>r<xKTj-GD|Lv!O7Ig>!S>-`BdaTy%-OCcaL_A`*azq2ofIyvp_9VZR1
zc!;5e*oHhB6q&x)eM>ka5`2;Fb<`Ozm`36I10{|(gDV3EkbG1gOwd+C<%J>f%&h9#
zfqNP%I26J^$cXKOfiH`#4hSSJLhe{c*DyN0P~M@}AhQ*fXYr7Y%`8VDkX3H+1oidf
zy)&8tuzm|k5k^?l(Dx%&G)90ypFN8GYT^*Xik|d7<5Mpc9;|&J)~CM=c`%OZ7%OX8
z0XhP1$<8|aiPaEx<r-vcC1#NMo7==|-T~y?S|5gbaw1H0%tR7)OFQU$cmJCv>Wcr|
zU5T11$*c4UaNbS-DU183(<^UiO;3(Pw)sQ?VtG{hCRhDTq31&~Cp<?QsNe3VyCr+4
z0#a?aBC`Ng^@*~0OEMN)e~2k)2gJ$n6{#`^z;T+h$LC^q<XyFM#BUobCNNZQDI|b$
zFI!Z4D!}Rb)f1RqEmZU~zdzU$%oopW_!KYws&*M*C-O{XkZ-Gy!>%&MbEFPT6u&V0
zZ5*&fb~g)R45PixzkQV@Njcsep`Yx^-SURam?vH!cq!3X-Q?G*`9Dw484sAHLj(x(
z*@JU1>(CauLN8k+>Slh5q;@cX7-^9VhqsM1;+J-*!)77@tb<y@+{`2zYVx}Ny3T@|
zBqDS-Ac=-p7s7~4Iik$jH-(PwbB|Xv<|(gsYZ3%l8F%&*rx=2Qhy3J&N+kbGjOW!&
z=VJQA>cdWP8AV+clB+bleY;)M;b&gtD^$V#vnSqjo|>}#Iat6*P6#=KQij5jRm${m
zJrAeCu3dl|PR?E9+rc#je~TAWn}!J!sNm((dE$&H8QhH`U&djZ&kYJa{7F6IveiR;
z5Ouj;IsYow4tcp9I}4*Xyt2rrz&32p4A{vmMiN0Y5HRg~(eUrl!#4)JY12@7p$~5*
zN;gHV2m3H3NSrcHzJDO?`LkAfo2lYbdG4UUMQd&lkrQ;2`)0J#N&f(|y6zp-JE>u#
zX$8?_<f^3pN2x?f)1LhCa~;TKuCV+&y{{>Zss2$^cvZf@dqXzsaxxP9j&p$b&C`8d
z%It}ByCNz<{F}4~<~-+IVuCm)m>m)=cwu<D0g90n4$`On^YeV@eF?XrH&4lou8?z6
zQv#O#25rgKh&W)T$CE*4(#r#Ikl50jqQ6nW1gLU!b!W0~9IQ_2&b90-_A>-7PaPvl
zzJQD?xl|P`75>a+!J!x*D)`;R>HzI81-(MfG6$sS`CNz;_RJF;T7(n^EHr?K`yv)s
z_~=@25f1wXU(i)k1&w>BLcRZkoLhivX4(O&>d3Z)zXe+-L~`%=10CJ7$BgO=A356U
z4(YV+23O{uDGV5kkhO6`TQY9rtIsD1gRL`5G$Ed^pYD-Ys3614t@vFUvrqB~LxQg?
z`oPJI$l~{7V8+wzWH>pa<MR;ftAW{7$*_}?8UuRyN#cOw8Z6ZRx#VE4Mv3KEx<&tr
z4eKg#f=Z27zVm~22~PuoxdSPin9s`~Ot`D?-#?g57S<&ggwxN#zXSR*-1Xea{MHJQ
zd4LmQ*z^PJ>zptwsbkQTFyQCRVW`;b9$T?MBv(Gq&dH!#`{4LY^Kf?%Wcrjj%#Bri
zmB%7t?`|B6Ji}g*aoGp=+;6Q0-!RQuxGh6nUY7b~w`5(BgrasuF&*7!j~<Nj8b?e9
z*+sl~5^uKj@px#0*@KElU?1+m+Og7h7q4y1aUd73?j!IS>G0I68VZ+N`9xwKxr&&U
zL5|VnVijG2-f2q#uJ4Ax%0@E|idakM6Y?=QCgNjQ4+MP*vRnEi37INE1Ce{m*{Mer
zHXn67mO_HhUzHFyH9&n^c?Vt<U`{o7`N?aamJoeS;d}Eb{R^G{ehu?UZI3pQS>oX|
z4xD*4imwxd*!P~org~5Ch#b$5!}sYFC^DHlE<?@mSA6<j(4d!M&*@+7K@jZHz|4OX
z%rf-GfR;zkYZ^1~Tdzc$2l1G(lR<oK5&Z+s^FvoCUl;eQha-37sYIu{yOeK$4StA*
zW3%*dNDI*n^(33kZg|hKf7X{@`m0?PGNz{<$Q6&5u&udD7p1Yf)`DcA`5~eZGf|7p
z&I1j<;hcuPW9wkxspRcn<&Ni|VYdfRNwl=uiFO5Mvi(4Qg1o+$80<Vz1oU@IkGdv1
z7y7c#B3am3?1`XB;Im_mJB__nf*4+*3hEdQ#sJvrm2gi*FX;RoPOrus?&19bumznS
zc;zcvJ)qG*G1pDfKE*-LX-vu8Our6tX3jVy%;ka(;3{-w3KYE)Xl0rn{#-g%BP*XV
z0_|3g?olR)YBY*81#C8FvLu3TbRos!<W+8}<gz#JLqPREjw2;Jb`-a+$ANzoe+FHq
z(K<f!mGpAfS7b6s-M^r>&+zu}af$_XQOJh}+g~{qE!@cl#!l~poIW0ax7_r}=UbvX
zWLPrO&zY43;iX;y$h&x1N6+Ve@kIU-=VgCx46r|)L45>jfjt^EqJR5!;vBDUQco%6
zs~j*LA~arRw5gSOh^8>uc&T1_J;Wm~UHSvkB9HH*!4iEj^l+h{y998R$_(Vs2U_v7
zS{~nJ$I#HNd16rn^|-<RKsx&xQAM6cX`88$!EMscU?SLHmp+3dZ7>NvsHZ3D|4H&z
zH)i0#xo0wC0lL9nbBV{hMniwS+~5JPp8ZgMu2O$Bt4Q5?($tVr_p&eo@}=d%_9OIy
z#4Squmq?RW2d6PI1`0STF(Bfw$<unR6GfmK654%nPiyKMi-^sNI{LtB)GRVuKI=k!
zZK*tGWRidl>!WY?<k|0`fRy!u01Ms`fc!ztgpm?eJwtyGl-8hDz>#I-?C1vGW`sPO
z^0sZ{<AJ?*hjepbBer{x6vrFr!F(Izz^Ma^k<pFUvVtuv>Pg#!Xrx*C8LVmPU&x&F
z=;1;Q-aFfi4<~Fu(q+aeyn7&QaTrl>$4Qx}1G=<jDep#e=gVMh?E!ZN(|r%&q(G>G
z;gbqBuwq~lS8}xe*^KSotBUGxznxcUbL8mz^Is6RmcKJB`O-l2`Z;@z9I;3E#vI(`
zwVS+4d~+!RLf)^-zTW!!OIPW>&$p^lj?xqbFpt6WYrIT>3uHYNSW?*Ac(Ks|gBpcD
zs8voFTr6@w!PI&^5W2B*-~050e&`npFHwsG*}aR$=_^zy)sQau>Vu3R`7D#R-z!%D
z9tg{5Z$_-at}7q?S2bGR##>&m4%N&&Dy!IIbaVqo2kt!Kk+>w1q$Fsc4YID8<x@Jh
z8_pH`Y?Twl1$I|;27y65VBXccc&LPO8`aG;-VS8TmmaxlqsLs^nyq@$A0v^)&+Xij
zL7XmS3m}~&8}!In#I7k}yD}(oo5IOUn*|kTP_J51EuTL<yZebhMDj&M@=V!_df79`
zxvJ7hGG`T*2#5wOvtWtAhj?Bit0E%X5b5Z*MyA80{e1k+?3_{I3sv>U83}Slb!QIM
z9AfFY*d}z0HJc=}rmTR!NgbY`K@;~Su4OMy9PcLolNeuICK{xp$g2oz$<i}-kB2R&
z;f}E@@VV=sUk2V8eCF>f6yS`>b;o6W1k}uWFM9;n)&OHw6u2eg=CLW?nO)JobetvH
zjjj{YRx-WQ)5qjZ_i>KOC^$DIzW0mejm`1czO%B=eg8l+A&?p5gf-Xb#as+KND>md
z<})*s$~XZ46I^LDXs(dLpV+nuT&cq(hd-%!YX<WfM+u%!`dAQ!Zi-`87FRMaMZTA{
zYPRjMCfQ|MqXUZ3<gOMhS)v)Xog^~aE6^>{Gg%tDen`xkLi-e}UQJ#^y1%I=N3@=9
zl{03NA1L%sx@Tf&&D1F$xY6Z0oMh!>9^rA#h=k>e4S2O6=U*h6;7ANnxM45h8b73}
z{d%=P+;rSL4r$kp_UgNXP9PZbbrC}PnL0o|e;2|rx%cdUMZ}V#Ia{4cqO9nV%HjV8
zuV{4S>07-di%5j8CX21TP`Sv~%+E&qBgW1oV)+!_lHBfM_XoRQE~F+87=q$(1h2&H
z{NdAt^W!Kr9O=VaaUS}alYhF?3{X563^ZC3>#81Zs3gl3@;xIKwYvc89j7e~SKr>k
zejm#g>NKO*o|ACdW_vgeFc=HGKUP6)mAEHGqpKOM7?e!T<?FnX$1jU_rM*E7p<nL2
zt$2C=Wy~D9u;*pVg9F9D&sB^8gNXHLfhq18-K~a<M8%F0o64xUn^G-+6&F8V_^eMh
z^`)|utP6p`zYXK!>3sJ~#+ZBjBQzR8uBe{7ZkBEXfyeH=8S||ui$04@s#%7DotkkD
zB9g~{w%+^qX{+c4R09C#n_&i#;=2rs)hG2D!$N?;b<WswE@tt*3;FzL9Up%-OXkET
z!=Q@G%=4&%8--P5%S+Dh0jJ?rf?Tri#C$vYM9t(GqOlX#sHqTeEtBx8r9i+2(Z%FW
z!|ryZM?JZj_1g!34u?i$!>~8=Mh@)SnDCKVu$V{ALA*^D+V2(N$WzK@PwYA!<(+!8
zvZeyKAQN?OG84gDUy3M?K8Qq4@K2sGx{EA`Mf)7LaTN*4TMk7nBv0>v`@%1pS21Y_
z3i@CCWRRn95J&FX#@6n_DO~o>H@#(@vqoP^_D#l|^GP$#_j}X=NT?Cn+kh6!n$h{u
zY>#z-!$$AHeEX!R#k}~}kq>j8=K}r5H`Dvf<u<07P6C=GnPfYKS9@$G1;z;B=_J06
zQXF<`zP4xS=<4b)r}<NPqK+qfej=mOFsIaWnA?eLHx~hw93YErcd?hx1e_)sHMFsM
zH%rx{qkO0zn))dwd`E75X2za^0qWsyBj}jd2@QFp5e~Vq_7!yHXjnBd-NFXDuz@W^
zT|nQKt%3ONb+~Fzbl+GxFrF@)8te5>Yz8S|aJ$FU$*Z%t{dD|4Z~J53R^u3h3m32L
z!tp>BA0Uy0r|O6px>~_J7HRB0nFBWZnl8WQUw6-}6i?RJCvUv3G(!wUNBGU5`qiL}
z>(3*RydR|=qDnn`4pvkLOT1@_!SR1@@S{x6j@+_-BCpiFWSdZHBOo#lKX>gbb4jV;
zQYs)?8y7r{&Qy}9TmZhorrdVn&Gckw$Y~22y#ROG0g7uoQU`M}j2zxmX)$MF&9}8?
zCpjX&6XW0Ui@erZj+V|oI4^#7E)pEk?`$5h4X0GvNen=LErhuJ*?QM&4rFRi2$z?0
zk60f8{N=WjQ$Rlg+?>e9AgJ;dF_r|1uU216@^3}00lWEX2*N!c9uS1<YT0X4JQ|b?
zG%l1+>o$0Lu(QDRjsM~7xBg~%r?1AoI)wmb@JBkpQ}o}(Q>+2nz&QHG#$4QKOY)Jk
z@6FpYq*IaiPX!}NWk0*U7%CGuL%f&&w<{|d@pxJ;cTLA^BL2oHH{h=r`g0L^zH#6l
zra4X1<uYb00E{v`T@ofUwKI>cMC*z7UN=8Q!NjfrW%-B#v4aJ-So>5-##K{bze#1l
z4ALDOIaD~?lPli4$NG2t^(c>5A3ju8Rz3J;cV^MDibKW&0T#GQgsZT4^~wE~f`+G`
z+xD76H%jFDuu|n3?sv$S*D42mIw^uP**T_0V-Z4cBfse0^_y7=04yxceJJ!+dkc)&
zo%Qu%z=F=4{W8+mA2^>kp*@wJN=ZI4Fw62DLaCnw03eFa;K81-^TzFtC+)o5as{|d
zIKakh7TQG$Bs=~WF~qkZ`m0c2OY4Ikz>N@}12R0(=+xpHCVlcOKeE?mXElqd!yUA=
zGOuPa6bh&7K<{mMZzev%#d0Jn1T6hHk4Z<sUQapAcC@D`RDXfV?OM<U7RyP+GhA7F
zd7(&l4CiRZt&HQTt%|?)bJH#%%DyAyg7E9g^T@KT=058H{@qP1cBmPoth*3OrBakH
zQQ^XqPA%ow28|(G7@uA(Ao+wr+tq^26WQT-aw!fNNVL;P`hISye@L{pva6Z1O*;Hw
zF2tcsPlhZ_%KrmIL?>q=Hi?xqWwb_8PGszi;E1SH%LS`_YIswq|I5%_H^#Z}*^*-H
zifVY}CddA2A!BqgBxfgPjaV<>SW~{<98;0M4M(BJ*w%_`2oXbE@50b%{z26BBL^LW
z05=%o)dav%149gs(n&Y?;F%eKYO(gv2T%uNDH1BWZXCO?otX#T+5|0>b5F!K!cMBH
znbs^u4R`3l%q>MKHuV-7(`kxw2|tVs=RonUZ8+tx-u<MftUYsN4~IK#%q-&$=IlD#
zoi>{Sim^jI)l@2M*HMxEs*w~F;K9%Lx#HG|guTSed&@SvYy3(C<LjSqhvW~V*1I2c
zmf&|<>8DGK%5X&d_EbQ^I;vXm3H&+5uS6>O_ufo>uiDI+9C!Lh(<n{pY`SX5+#`la
zpMtE?&ZAkW>0}3a;SutDVq4i(g60moOeZ4Y%vX!anK&7?T}s;lEvjH3_W;44&j7UA
ziDo$3uoblhK!t%?lLt98Rhvph5kx!XG&KVnBPEJy+L#Ojetepo1RYOaWi%1fnVYSg
zK4M}TEfVvW(`;r^<XM-_)w^bPIzvW2*71h<>Cw(f8hec8AMlxupa2Rx{K@t6OXnG7
ze&5|k{JHU>R7j6etI>ct1emDLPYZjkyiV@ybVi#GYdo)}p2$OZms@$z!^>3l&VGEv
zWRqE}g&61LXk>JG-WWf}++}owVqI*6i@hp3&eet>jyG{n#Cwhb`ELI@w>h~jUGqje
zQV=1a9Wc+P!vc@#^Ht=bh{5L;65(^rSb4N7)Oar3YZ+>Ig~Bi?C&?fi7Q~_cjssb|
z;|&X2BuWq8U{uRVHD1obZYiniL3`f)GNTQ%ZRy_HgBn~n^1^U7<gWI1Vk%7+3*y}N
z(G7mpBXLlGMA%VD5NbD6_S$PF8ldc$J5g7ZcCUJhzPO@DA;VP@ei%j~wcB2O`t=47
z4xL?~&LsD-lvFxoUowWoHOIi`&^PoPfK<W5@aqu{Y43L71QZ98MhCkZGgjoBJG}Nv
zI(Lflc_m&*h)%*KJapv?q@&?V3`g+m&H5|ygHRduly_B48E1_T_gaDH5Cco(2zOlh
zp9X9=*CRe7{Q2qs7sW(@kwt_#29$&<T9see^Gr~PMOgWU9HFprU{mBaGLOXp^3n$n
z@H|4r<HAr!b7Q~6tR{_v%_5(WZv-InWuqzXjy*v!)}Ex@WdDzDVEa~NC=kBxwneIn
zAZG>W!PQF2xq^*6T~r69)EGZZY3Ar*{`=#zpmmGd6zt9mbl_QaIRI`9;94dzr#o?w
zQ$W12OTqY&jkJ_E8pSi~^Sv0vyTidWM5Fdj0~w)OoyiiSCx-WU_E=})%~^l7t<C^I
zg^R^dsnpP$wdtuG8nXPKR=%m0Ppmsm2l!k9)o?A3*D2RGTm4c0k$1EBX((-BUmb$$
zHE}BiO*rJYEAQ#NQ16;~NIfr|Aiwr@`rT>#9of+Hl}ZnFEu8Mlxoj3+`(ROduUFvt
z=4^wX=cf;~5}h_C>JdMb(Q@yK*yX(>{Z5zhYhqmaU9DQTMt#E86*ao0_D7UO5iC~b
zWv|Eu>`IEw3%9`U-+{vB3l#nF8v(vzPm@0%F}*96^i;_@Pp7|KeS1DgF56GF=@BP5
zLFZ5Wf}x=Es~3>pUzV)zp5vHRk4-}zM*ohgQY+hvrw0eyJq_D0eiB-PZEtNL2umyW
ztR!`qr@XJXdevS!N>A6Q{kd870{Ew<WPJPVXz7AnzHM5u;C8^Hr_8fQKF^p(Tm@u%
zChR#L9reF$f3n8#^0={HMD@8ePH-q=E@07k6$G;NHz-fI2w^d~y*iA?;5~IrSM^Ea
z9SMgU8c*Z60)p<m{zi5C7ARuqCKMdJA3?EM)u$%Mn38zh(sKtAsOxGK|C?fZJPhDH
zKA|;*i@5Mt$ffhh0PXl}a(WNTodA-04a?$(vzKRLRD7fn4Rfby@zGET4c*C&|D|Yd
zEIJD?*VAtK&BcjP0WX}#8Pcprfv@<k_Y6rfYCS0ebH*eihjwYLoB}Ql7=7v>JC(Yw
z<uf??Z_3lq5>^ieqI|8W=@XXorT6Py>rGr6ixbnk<}S@yWxdd$p#>}r1Qb0_b~BV~
z23N%csR}%kxRL5!AgHTL;>|Dygdb~GkZ3?Lv`m44(`mvBM-7uW9}ZqIDm=uSUqOD2
z<1A(5EWEutnFt$<dZoXl>qe!pafMNxdoC-h`J|JC6WJ3pEdUsbw+|p8Ie*I>x3Gm5
zlAZNRrQw7`jhux%lL=ZR?}E!1&|38gb2eCV#)TT~mdG&~-{PmO>s05yP7IYBJr{M9
zLE@PY>-rxo%XCPHO`!-H{G{%z3}XZ5b_sWeCBh4glzGO#OzMYx&T;qKWsDpCRSQ8r
zz3jDFZ*=#WO*JpA24uy_M#bnb61CZXtfO=ad;tRfeGt}46-BhsuaxE-FT*d)UfSLm
zyd3L=@&u$>fHDSg67|cE6x()iVDCu!53Uii$CEV-?rLEV)X4wZa3?~f*A^CY^+%l0
zED(Z$oYyPG+XXRyNo8ae5*eArkR~g{@TrE5t+bhp9Dc&@#Qv9FZhBypQJ*GIS7Q4z
z>kD86k4^Aay5U><c(?;<_Yu$|u8*qr;QIR8{-?Vs%P7DW!^2$#ZD~=bn_o%G*Zruw
zzp0Go)lNi1YkNeZO~S<xeg^nDaK-Q>Eq2Da`}6<sVq$#nfRx5VK%;(<muQICX>Wmu
zMoCOj60b*Sp0HyX*EE;D{5QV4zroZX_ILeLE@u64#dVX!k}8D3?~N5|Iz(9gmOQ-4
zyp){n-$n3wQ%(@wejV*p%|e-T_T^E->T0gbz8YhRwarLup*oQ*+OZTf3%+ZJUMg2P
zk+CG`x)4N)e7<3|Lezq`;X`fY4XiERlx+ETz^b+|w@-5-{%RqY^J!bxyMGDEC^hkl
zsiFOyryDzUj2(Vm)YBFYn5uoXR!Q~05vuljfCoC+sPy6CkYU~ht!?Msi@bzLdl2+K
z6}L|X)SGO_cn&mQIZc=!kjLr8mHDC>;fRt2m^V)p=88@N8q&*~Zk}-tnAN`r8WUtg
zssZy~_kG52$7xSPbTf`%yz4X<T<O&OL{di?D%{MGW3lsMRN4-sjwar?QtP>MlaHUB
ztMdK(UH2EmN%csXzL5IO_0~<h?5OJ<&l<a)?JnK%{C9!X>1(>G*oA5I%Efl+Vv^>f
zs~F_@?`O`yPZ^_uHrt11P(_EcFl+`Pz^OEc>;DaN-)!`c*0J8{cw+fXuR$tNRYBql
zg$itDcpWO=B8Fv9RC|hvq|w?%z8e_`(%<VoEiH_Fzwl7*i<%4X`esBgF^`!TClhIo
zqKnr1sN~{-{T~_0aw;eUjOV6L-uUyLzVGDxKe7daI9U?dzt?_ir=<@!tjObDX`c#l
zx*ltv$PnNPWp)&i1|rh!1>iAL{x!yNl=U2WNsN5RSk`>I3eRnnH6V_R38luS{-72*
z;hQ;alVsyeg{rCP_n!T`bFL-(D;##6|4A(4G%7R}ZJt!Oosbt{0Ib_nv(^5&4NOj@
zL#B<KGa?fOv^4Gm!#jt*?o3Np#})5+HFxv3Q$jkP;u5f?IR0f_M^f(>aEIZKVwMFG
zwZ^*rx{AFzhpX%+N28kDQ*vme_=^(dujKZaS-$dja!b~1m@Tcx*5M&>aAI$d<hLFK
z=57(Ow_phrtw}Hp{=!OU5=DPUzYR%9O|>~zBF+^`abvMN`qk92?n9E^<>gdGvuc3g
zHwbyc3E<%XVdlS)oEbe9`UDu}%`?>6Qxsrt!Y3EpjsWt$i|r$}HxgiwM%$X|Pendp
zhvFIe69xg!F4(L$1j_8}=W9oB{BJRCXCM33gst%4gr!BOke|I?kN#V~dtnpzKOo3*
z_!1T7)SU>QaP77#kuk*Y$SkwQ-rE{`4fl5YvkrUcshq)&QWyl74tFfZtUA_xW2_1@
zD(yPTTI@0^Z16|uCw+(mgK%fxjn>+<&A=i-B{81wGMFX(pw)Gn2fV0hC#+r{2LL?+
zk`{2+xx^Wrrn%y%B>B~pMf}h0tw9=9bmbvct(|mqX(QDvxC&%?w3u?H`?bntg(YK*
z-t4)F1jp+Ld^kPGws!0LWvO%%PaqLQ_<~(WHQojz8JR#21Y#9%grd<N&K$4fE><br
za``$dOg&GUtuXnBEz8s~dkg!;5a7lSmVHaJZ+S%hh+vKCAd?QtQ@t$Ozx9)p22qhM
zm3|3F)30z$9kk5Rd1L~W<NL9{RYWu%I%kgtXl+hdrY&X+m0rGD9!-ejDCd|rH{-JZ
zr))url+A?&8so}UP~m8DmY2M0LxPA9Zjd>MPZoK@=w%B&0~&6t)gpWIB!igwvp9SK
zACCS=5)v=zBIom|KDDG2dOlTs*7ZY{aQfW)kRi4(7YGp4>bo||ocquu>|(VF#YSAo
zND`{>|34ZAjy;O0hqHDO6|W_-ylBH%jj+wBCjm_LGqK{g82AU0wJ^7##>#>HRpTWq
zKjI_%aVA1|lRW{88)dDqH*f~4kt=k)mQJNSB5qdZbOVHcyEHUV5Ixv+m132qscaOl
z9!pqB>jw4S#!!C|80;b!oIjH-o#t3Q!yWRnJtf!PSJmL;3Sn_y1gEQq!d(KKA7SNr
zKT4Wk1eVulYg!vA-f784PA!D?CJ6v4M9f7uU9Zp$U+I(yemULNNQK>w{F?{Eguf=~
zRLz{?i?Dr2Yx_WXmtFKSHp5d7K97B5YRaA#s6J}4)yWT)k`rN<-z!9!Hs&7N$Wam4
zjnvDCsUtTCS1RMve!&m3&VuK`PaePiDZge*xzPq;SdEXlo6>0Ecu@w|i=WHo;OS9Z
z%K(mQGjGLMBcF{|2wdk$<YnI`3B~13No8z~9~zI`{dUKGuN?@g<43zS{V&LhlHd&K
zFZkWM_t&3p>B&75A*eS1sB&=3BW|OsfLD`sPCzPNasPV^W`SzMOJ1iKm#}sgUZQY?
zS^Pk3=UjgNh+<}V`SG`AQhHy2ysCYQGi3VHA(e%+5HSvb%|yf%d3;CE79G9*wZjdO
z;c+_}3d0L7XMv9ab6UwS51cgYM=1LmPOh#m#wK0$Dmh<u?iL3#?6S>az$HSXKkh{K
z>!MjT$11t8g?1BP?rlIriJ1af_<f`XzaRf}P7VE$_J$+Zm!WPO-1A4?EzqdvPp1-U
z_IF!yns39CXlqm*+>!xO-@2T`k4k<cn$Sz5iFu|=`w3J8aj>gd(l!75b+Hn=<Ummz
z7F)ZP$%I-<3_L;rN(IWZkqN0QJf)rh7Y)b&vwMU0H?wHQuO~?*@3ad}=Z`+}j4`<R
zAxp`FVKGejU?UCwsx!bXV?5l65bkVD$A9gkmD`Xufu_McWMv%qf?%61b~iINf<4S5
zPj_(Wadz(9^wK0cmvNjP41l+zZ^KpM<i;XREA?URe3oahwWrh`)AajIq4tt`2<%Y{
zJYx<zhc^uKk#LF3kNNz@Eo&O|`{|Ht;FVjYDiOEnRT~A`R3B#6#A)HAOf(ewH2JB5
zP1lFUNsoDSe!3fMV9!wI(f-f-FN7Z$S<f_dZ*F<E!g)Ny4$?<f08H8S7_JwFJZEtV
zvTH@{XU+ZT!_1syB#{90h*;wGcB>H;5&dTuJC*sAXVMwRQ<X{gxCVG5oY_drDnU&_
zn7`X{cs(qjI(S;b({q}5amrrr4%#ygF;3mbqzHhr7B}7l5=H)9t5OU(5pB<fKR|~A
z=s}YJml&7uJUq{^)S3{MAvBg%!ZOmu;-38Qq<nfu0_{fHoKN~Wt4rhTaN65-*^nBA
zcbnBASA6~w<jZi)uDCTpcO1R<D|k+p9~Ey>Mz5vUpT<*`BW_BfMRM0>tt`lRYz*rc
zUw+wMbw2Ol=(<#453s#jxz&fkjJp6qQ|E$g4n~x}hh2UAP_9%w*@W(sHV0B-ob95N
z{Rz&k;KipfN6{_p8Uk2dWQeAJ$I7uYi4RLU<*<ls-(29$5-TBJS`tuPOLMV<0cUVU
z2ZP~Ec}eSh0fOK9&$eN4u3isyAQuWVL#1ec{(CV0CWCQ(Y*CnRQ20%i9)xwk=$Rf^
z-j-j`atj*sPRBj)5FKN)+1z6~nLaFTnlUeV*=cvHfoD9A<yPU}*_+<1j&56Xmng<4
z(O@*XFt>mi4FKYk0<OoA#MIE@8ni(Nv>!Iw`Pq^_VJLUM<jXYX*{&4eXh1jlMdlY4
zBST_?b2tue-MEDPB*zgdjL;_TOG+Ml#@IEO2q}%?7r0&g`|ktHNOa8H^Ut0d<bmM_
zGZFyy<NEd(o4slPGAr~RuuhjqWwD@s9Jx9xdcOELblX6-8edrQz!nz|FKYfT><r(C
zp;MeaT6*%!K14GByD=AB#drg?f+FsFoh)8U-&hwDtsbq-o@WGonYh;+aZgU=ZO<8X
zzd5qmQ8#z9DaJr{F2?osoLwtq4md1aI$0~=nr?hdw!zlAA{MBu)fhtib1vT(H^0<8
z>tVT-N57a_XkY_uFLu|l?Qq45Rykbb2(f0_m-_U}hCekqu#0UaB!x6|grv*Rp9_0u
zFHrMu{7k$5<3y9y0c=ZU-fZ4DLx##jTTPh;_NI%=J?+N?b7$ei9&a&^Pu08X>V(*v
z0#;wyCzMCShE%k4MfKI$lBiXH@`tI#X%{`@9DSKJAOR;;dj?l)Bq#8_EK41IC1EIU
zbLa=N&ViFCi@`Zh3@j*XU1c}fy0r~o3*Ebk|B0V;vuXY_7gW~%XQ$6;*@`m`Nf!Ii
z9>VXeSj{a7l{S%w6KA%XTOEd#fMgMt7?`JGWR}zmflKaI6rhn<Da<5OkP=L<`{gk;
zE;1Do-$G(h`0<&bCxso=E-~p*xNH_vHjfAfjoKY^PDfLJRcExmSTyVCP?YDmAbp&+
zs2WhW?AV3pMms!WW%AsZEhX_}iA`#!^#b<j#_LNS)emx_fjXhE+RZowwkhCX2itMl
zB77A>Go1Of?W8?9YoA>ZoffFC8Bvvw6Ls#Fx^@kJH>0ejKpQ(g9T=yqR~%_UdRQ*m
z<HL5w*jA$Lc34P&=3XI$J>saVgfLW|X_wCzOz*UCDDhom6s1iH4DN|+bLh2;;p*1i
z7C%P}2+-ZeLy$jrE4vf_Uh<M(&2MTdQP7C-4PSLEiJqt_@qF1Y(tu8VqgPG28|+K`
z$&qe29DrIC-s3&pJwwa^rPZUB9PFX~``Py@$T;hOfe#M)<pKfn=ks=9u(@z&G0jcb
zvnm*NEXnfWj|WlBH>14GJ>&?lcBOFtD*i1SJCE5cu+OF9D|@ReQM)et^a!RQp<5By
zWvKG+7?&YoFnx?`3}TB0f0=RF(fhKZk^vvyT`=&jF}cc0(YaKF;DZe(DgJy@H*7sq
z{r~_y_l&{d^<r+{-ZQM|J(B^eS15)CJ?)$s(i%e!UD9rAXXM-)F#Az8e8-2+<TX&H
z<(TuwWh{mH<Nk%vx<nQi0PC>e{kh3~3d?~!K)-9cUXEw^SRF6D8KlmKyZo3&F-}Q!
zog7X;484_jb=CH9va+lt_eT{S$BKx91-49NX62}!t71`SE6Pn6?c(lbReMjEVk}4c
z$d;z?H`<NIIPz2EM2ps}sP9YnQF@DHA0eB8oeika6jkIBh@sv=|8D)P;z|(}vuz<v
zAku+u>X}XH=j2v#opbkSj(m$0@3;m!7se!7T>NLAZSOY`!Ts6!&O%1yrEXC4RnX5v
zN<2GV5$&3Vtz#92&AraOW$+rEUQVGgy}YJA_?%k^=ySvBr@w<M{RyH{iwCy1Z}}yI
zH;T!@&IJRjU+cSd<5rlw=rwp6;Z*)Wk*~X4o=vYQGR5!tA^~VM4Te7#dG+-JjZ_-z
zsl(Mgmlw(J+#Wf<(4NxtTDt_|RzteAC^Vm6Y9R_e7<JLH6}`PrL=nNoQ}jt1h$m4%
zm<5<UXesfI4f%OY#7JD%a^S?@&3kHvLr`T)qN1_Vk5!Su3=Oa#O}UT<&5LWR{X>rr
zY&qTLFg9y4)m_P#_^5mu$X5m>ft;anddgDRx$6v$*Pc4?J%2@U)g4mhKUtG4Ki%DW
zW>+MB7yKq<pFLLZNyNmBNlyDuyScN-LH=WhKq^75*<U`n-4WSNERv%0=;-*+=IjFF
zkgQcsOS5NkSJipD_Bc`~taXB%q1oQjwLn0={8i~e`S86y2tBg)F^W!~0xf^Lyg9Xc
zvx!ip@A#Pn-syZ{6b*DC=|Vk#fTOhs!wBfSRNko)bT(~}yI_G%lZcFZd~(UX@~8;E
zj!-6?7u!YrTh>^0wHpnw?(rx_8#dILB;q4_W2S3ibJ}Joyb0~IF@7wUBcvQV{vR02
zD5(5`v9IVJZ=GEc&8Y-!?t_5s(3h_nD3^S@`*)R`gRpphr^n*YP0pFv#N_=Q<z5(4
z&Uk(|SWe8SWsIcjTedIx;y(@>akkll&}8N}M!7=DW_i&}jw0;FCo1vU;T<2W=@dZ5
zUQ-YLe&Kblh7D5?m;oUss{zczfsYKJr(#N1S$?16mRmKYg;*&eTX9fP*f)=09?H(p
zNDU3+{Fk0(=^!pq$~9<y!(UJZ3o;U}Xin3_{3PkUL(jTZ8)oCl3-IW3&FbR4L*n`P
z_~2Iswt|9AKh7i~Q}77DZn*7i2+SbgLP%KbR9Fd>OjDy}CHGy3tzj2LYuHJpGP!#<
z^6Z3yZ(cCM{Ad8(hr@~Dypeorku1-~%NUX};%O||BtdlNYvd}Ja}&(JL4}zqRO&Df
zjcC~8G=BcuosXGSy$+bwSgb4jy;)Kkz~^iy?lYYymW&Oj_diK*d*yzakrOl#Q(ANX
zHOrlWTPs1wMT%VcZ4^*JILwRCf*Nw-Me?`zLk|_M-VcuS@*ZZmL9l$<CozW+6j!|l
z9EY=(?gY=bvSZ1X*dOxA_3qIIFK<YQWIT>@7<J7YLbJOB+oT@dFELQaUDq4;P8oC<
zx3er)VTn``&Opc?DteoRi0%~SZTHB<bMA*c5r$C(d(N#3FYA8Yz*5Y;EUCOsa{*UP
z>TExS`K__T^jO2Pu7(KR33Sy{4xLO_T^&U{f^N-IVCUM?5vj?rEW^wbE$kL{8~)r>
z=17wSR6GGd6i?vWER%eJw8N8=q0T9a1aX~ug0lop({*t1GvuS^e~)}N*J;H`bUQ%w
z+xEvy+e<_V^Zf^9@qLZw(B|wzE@-s<*pE-shwfghmW+-7D+1`m(*BqG<2@p@FHkoa
z97N2!+q!=UetVAI@akWEb#QTwbbJCCk;-Y%P0Ntwq__2^-i%ZCss+x0dV`CNniPN6
zwp_;CJ{PxQGZiX4Btiod;Z^Zyxjj%+81#CXjkR+}t)87E%-R4lzW3<PQz{kG<UmUq
za2lfWo<ZQqC(e`(T9eEE5gITNc^ZD{m4wIwT9~TXnSd=#ToyAP{$Ja@m-KasI!q3q
z^}tS{AjI^eg@uLpr{pwa$;c3W2-xR<uQ|`NuBw!+Pydkf#UW?gC#iaj{NxYrYMUO7
z`n;o@PeFV|ST}0x?=m2Lbfs=)>Yf|hv-27mfDrC4;E!byVMkwSGWliqSxn-msF>xQ
z7kclRJ|lza<f-q!{6z*9uT6ns;=g_6%#P4ac$^<w#mHK5?5jho#15LGCP+_KAwt2m
zif0MM(GhxptPVl*paCj#K)cS=O9NNjp;Un&!~+4Il1p^btK2vA8|0pd78Cfn068*5
zsIXUM<xJLJ;iB87+e{mIpFHxL)0R$&Ig#;d2acs{xR3T{a&zHK(h{3xd~ZN1N;_en
z>Hi_>JfNxm|M-6|*S@$`M%FcpvdZ2g6dCE-n-DUS(apWMxMW2|Mx>$cHIuCDD+y7y
z%xhE>_mW)P?)`uI{(t}T?>I;5Qs;i&^YwZ@AJ5si2V>%N(p!l09kZ2p##hzsa%p-E
zRxCN`vOS+eijgmRAD#~U_aXJc_DdY_Sy5gX<nLuVq*o6{2#(oA-EPK&RKC;>PcgO|
z*e~5vUC|yLKdOVls$6T!B5Fa#iFGD)8fx`*z>^yIs}bS!Ct#pOM|~Y1gS-<W2T|he
z5WBpl-r7|(L}HmN1n<m|a<d@}mToS>s8Xv#r1=IHC$*Q^YrB@m7TUaf%PbvssRsEq
zSm%**F;N}gG)nd&AP`r*h!)+dudV+CUFhXk-8T)9Kf)OTrlE+3P1Qv$m&$_YK1w@y
zudYpAGiVSgGJola2ZICqzkUB#0E2SQ@>Nsq9@`thkw!JR0g>VYf*>ElkZm8AE*y^K
zvzI7AcnKmPlH=Rr(CbP#k>M(wT0%=EQOVLHs2=~HBYB5T|A%WQLZCa)kgP)1K1r?d
z$xq9S#||}y$MrcKUwan>m{(aAXWSo9_>C&0;zU7uGl^^>U1OIHyk-23w{lk<tuH=#
z1Vd$dbrXdImxVUT3<B=m+{*qBIrWr!mQ++2V1=CUO7QNZ(GRvqr@qtEOt`e%Rqu3P
z1>$zvDXckgAQ{EoWa-+Ie$dSujPU(WW^PlmBHzmST*0>)Onf5i>+1e8s{ZwU*++q3
zAl*yd?vOmD>~4JraO8Y6D#uL8TTd}p?o?<!lPmXUZ+C6V>OHO^5rJL_-rWo3LV>v}
z8Fj4^>2EYhOhMN5yy=QU7k0Q3lu(bK|ErO*fIJu@4`+J?HF~;0{ITiJDiE<d7_Zt}
z^tiM!Zsl6&N5b=fX#Skil>Xx`IsmetfJB4yymi7uwDUl$P^g%mwLb$3H8LOirHU+D
zlc;0qd(%<qDLlwZ?+M=Ciefs5PidmvUlhWI2zKROcejP{)#5A>kq;c#>z>kkG9SEx
zum*qZc12;-xi>H`o*m0yi@5rFH2%>t*xRL<gGyxD-^bwyn2vi+@~)k{fT~1Z7C<oq
zXnrik3bC2KR^zLZrU*m~;&5H8)K~=Yix>m&^2;5f5W&_kovGYc7~=P%Je%izU~ya<
z&WjI_bG^M-Rf8<Mx-ba{19optW7Q)YJ_E6QQ;<XG81D;<aUH5gd}7Sx@b=OVZgrZ{
z)=^zX%J)mDZYA^90j>pVvLLa@-~hq_ZH%$~hP5-uj(XjzDBbYLL&oaKE1N}yU6LLI
zDoI=6V|;aDQ>IkX&>8L0%{5K@^mr^Ll}9w<V4LYtR>-VOURUQN{W2jV)399G#DLvD
z?cqek*KLM!WvuGb_Fw7cIua9KsZY|>^3Ig?cvaE;5!G*f&G7Gb#{<^k;Uo@n6_;oX
z_LWH(Na#-N0-Z)D|Km3TFk-NLKooz@CzJcB^j>9Kx$B7{UnQA8kb%CNrgejIH_wi`
z5TlCp!W6|8E)eu)6$yf{sW6nK<ukOXZhyA}!A?B}l7*Mhf@eO$qCiQpPKWMBCf=bp
zgCRB-;!Cl91H?lO<fHG)h**hSx&Y+Jt^V%Hog?X6*Aij7XAgc7Xj4Be+WonY-5M(=
zQLMukMA<~p@8;uXSbrZ;{kTb(vAWvFZFO0jO<nOd)|1HKb3~JvbT)fignK~#wBx!%
zgRw**%GZbeCEqQtsLJslGC7=O!7s*D#M;&dEu~``)@y_1Wvo3z_nok}ei6M0I&zc9
zNv~c+4Z=@Vf)6+CoaF!m2>nyiS29QWk-h<nj?z~o1O?MLT?`2bCEPoUMVqbyL6=s*
zC1L<0ZXs&zZH3)KWA9(}dtsEg(RiO(nq{geO<U9E4yXAm;(m&UQ?JfT>FZ?*KnV`4
z1d$`rF)Iw4o{{u1v%RehC?*0le4~T+23YgY5$~x1WfMa$JM&PGB%8C2`6<*FlF;3(
zYxFOQ!#}S>4Pel=+bN$-xv>zrZi_G8C@k!?e_bch*cPO<Ig+7IAQs55zSZcK?s`j)
z>6%kjkXX<vG9i?Y68XV*|N7nSs%N)kLq99X)vi}kMqawLoi*K5P7ygT&d>JHJiL;G
zN?CaIi8J(FMP~PDNlCEij$B;-IlIq&v1tv8osUx4KoD~?{|_GqU!#^e1vi;Y+PhG6
zP<7I>zi>%aOyotoR5ca0k46ATVE@MuZU0qogjE8IxMLy%tdHly50QSk6B2XGO{9q4
z7WxbG7xGdsjjFcdj72_UH#9qM2^Wx_+i~<xKJtF)#C&eMFpE~-Gx^u?#LexL$iAmC
zm>;)u__F6%cQS-!46t};ch|VS(2n?dnDLX(-Wx^(gwGxpS1|9BtwSIz<UGs$BjL|Z
zauI_2bHB$|g^ZAeYDN{uic?<bz}m&PmHi4yai-E1EK%kX@LI>0+;dGG3O~LLA?k7_
zmGG`)CLE>c!`-QU8pN|1-*w{M1Z!J!-P*a2L<au$vfu}n#YCpilAfv(KYKiXioM~(
zHcE#JA{N^jJiW2`&M0#eZy)C^jR0_OiPGCZM#kOIVWg+@=tt?Nor(5h68Db?QNZ9L
z+>+)@kSDY#MlDL!96g~VAtxO1Fhx&*ST-3~Jsf8N`nzWrVX@H^Eu{BD?<w(e4N@AH
ztoP`2Ti#q)CC~yv9YAiJtGYdu8UZd}ifLY=O3}UOj2}dp9d4^x`S>m|95DI@TnshK
z^}hYxa)(Y4H~QRdnN%^uYY0|PI#qF@9DR?0@QrBGI-M5xVA-BUCeOlMbO>V8J$lmG
ziy^C=8PHXlBSE*~Q?)iAI&GBc^_wNXX2-a`af84NLExfz=16SpTgEXUFYQ#qCngx<
zjasSsRh1_L{*5SXn+Q?mKz)!r#@#E93!?~ZLU~!`o}{jJT;@tu7c^0hr0l%)9cEYm
z`o%JxPT8?|je6{l2p&JsX4GMyG)VQ`lqV3bs$;JV?;Cy!JyaFU=yaWoluA@|JbHN#
zlFz}rUzatBaBRYD0a;0jFoOnw3@(v(G&+{;tIa(NP(w*Dp$CUeui_P&j7L!G>i0iu
zdc37)BnBJUrehtc7Q7257e2m>LSZ8(rdxR4yj?gTa(+=Qg|Na{R;pULJ8EqBxEvWa
z3U(Rw(;p6WbU&z$d1e6lE*9^`7(cMWBiF~43mj0jeg_6DMso0?42c2gAfr4>{U+iT
z%h{vBgSb%;l#~`#!5BxA{3O(Ory0}mUeOK&0YRZD(#7VMe#z0~zrh*UsTGpHx)-Yp
z*Xu81F>a;Izc@Y<Dcv_8LT?!5Z(x24T<zopIO>LCG1Uu>oKSNz^JJncFv#kdRGlTO
zRfz`sh~<b;iuYvx7Yv=o8AcuGA4z&@0LXzxzfssqTO>*S<xjT^0mUgN3~O%$y&au-
zd$r>*wl1f5>OK1z>G@?*#M7{3!3y=$D}+<(3^a+I!@7=xPFb%>ZS5%sN{;E_Vf*`r
z2}To05?$=bPj3Iu0az%l6Y_=$RNW%x`$F=?h2xZ)UtT<VRrusl9PfF5X0h$NS+(cc
zrH!6<Qw^>cy+5Gt5dDs0-f@OhHc`<US0_Tg>;e^*wwH|AI*VPrNgh+bZD2KVmI?_V
zn!fvN?QiNl(!ZQ_ss-xdSJw+W?Y_1+w$ha9&?_##9U$jBniD9NI!U!*RfM_L#ATVE
zCd8Fzz&sr5jZ<U)H9Oh*iQ3%%;<J{&2{f)`c%xM_-WR5cg;;#2^RhA^@Rwes_d)iS
zpjK&T{(2MTi*eS2{oXP=76#ovOZX>$4TDB#T|q7lbKSk4YS2jxMprb&meGO7d6K6f
z6<NGL&`^b8DFeU{AnteZ$`d9Ex8DNq*~s4hD-nwK3Y<-alXdk0{Wf^p`m}nU2@sW5
zX4JTXHu3a21Ni_aAepf6gie$pPewEy<G*t3d_ZR<^hti$c&c}%MfMUreLU_8O`rlQ
zUz>7`=e;90QxPa5X{dJ_s-=tcl}Uy-E?&>|F1s~=IaegSTq8zG5kJr?Zd@g`TrmQV
zdUWVM^7{bYo!Zw8C!7F#;1mAdRObsXaiwhHYMcbAF&8sY+@T>gTiG}67JQYmT?{yT
zSk3TarUS@BNx=02x{L`HN>@)cklVy#$dfKEnWecJ6&~{wcq^S#Vi3uUSAf_J%0c32
zW@6aADCq_fpkqT%@-t8g&7AZ$dWj|!`I3wj&+9F44|({;0M3$g(FG>|>s3&ES3sCs
zl5?-Ucm|JNNlF<RF`YxQVp5<wpB}&O4oN`n26Cj_Y>6Pr4_)^yD_e$jvNfYY>E5dV
zfZ<$rEfm+l53k~T!@}7%`K|sjh(`iP>!L5qG@3kJq(r%KIZ#D0k%|PsI`YgGln1Ut
zTN`~Y$8Ibl*unQ0jAU2Rwkch7j9heDg~0qzCcE#65_bYogYe^s&HALm7fyQC@Lw26
z`@K3xM;ps*({^Ul#`V?LrQ7?~zxhABK=UVdj!v&0s><X^PHMEwn1t#)m0c>#juYZ%
z6=8naG6e31jc+wi{Yffx?z^j=Ln=z5IR)NfX+_QZ<nkHvy|LbR>b(-LA9K(#0b#Bu
ze1_+Kh-C;ks`{yjhStSQ(PL@+)+o9X-dR$RSc}h?gpe-IS|nU=4yT^ZiEnVqd_7Gk
zB(keKX4AM~ODpTp=Ki)v@At_n*x{LiWYimZ;u>UdA}dZH9(v3|7o9qh^mhr6+mX7D
zCK17Sl5ww45(I}Wz#Yc8Z47?-yY?lJ9iX%=#Yw-drV8{}<aoc21HTQdj9--W7vpD~
zsz{i4u&WY8<=u`F*FHM^^xiO|^F2>HGo=2_Qc3w12!Wl~41-YV%hdZ^Zoa+=Tzn5N
z^G~NSNX0jbS0SxKO$-;JvCtLt3J<_{1ap!S=#`&fr4L-PK!485XIj%)WY?>^L4{p$
z{w|D`PdHGN9cWcnLlmHWUT;pn-bS&QZyo}DdZv99ug3m+0@>tV`p(;WtN6{;*xp<^
zO><tACU>b0ICIqin&OfX6Re%$q*UrvP}X!z@e+;mjRc)nrp#%vsT?vQad#O#>3Jsy
z(9{6A5j$rOEGEm}Z#h@1)Q?vG#m)g4UDAXQK8kN|7>K82yS<Jo6JGa?3PTo8vtrMN
z$g3lQDD9jpN^*4%`Mq3gP{t2{Y_6LtaXawJsRO$5yXuwFNLBi7FFZXC{UFBHP_yJP
zxX^vvgbJ1PzF9|P14YEVD7Zt&31KZXtH-c>@}sdE%WC;PYUFLXF;xCX`_Z^YIdb$7
z1<_~SOuM16F&@rJ!k*UDR{%d@Ks&57Xe?`vi!){hKEC97lBM%n2+VXRTSw|V)JmKj
zjJ(P`areOtbpGRm6C4zWrW{6%l#ExR=-ZC%47{xcI$!EdVos*`9A7kTOIU+wB4@Ty
z*u$ne9`{z4C!JdtGWu7nSpj6*-!5|JZq#dEPTUe@Bm`)&Z#D>pE3Z#gZ(&_Vlg`;w
z?(GAfTtHuS8eLcH;=1!UQcS{8S?&M~CIF(k5BxnUV|+?wZ^r5WI^H%4O+e%6|G$+)
zK}?*J*yuo<i<`(I{jkaO=}Kl`KK_ZpzuT&dE^)sXVb@_#mRU+Rn0>OOe8bNpq>mv2
z9wJWto9Ay16S<_{GhD=bd4b5UHRNp!k=jWQ#CuD^B*NTSlX;L5$a;grz?icf7Finq
zvvK!`rW7T1Wuqi7)9Jky8^R3O&KAs=BjeP1iu$NIE2z@b@(s&ZGdTd$MP*AB)1%vc
z&{EE>)~cf)X0uJAj5SE-fo)RmdBd~oXEZb(Uh1+|EaW-`7Qk<5hS0w(6Ru1jm6Uax
zEete(&{sXiRq@x0CguXvH6D$UI6m+S>`}^Bzx61E4~N=($-Ldkv%<qrp~<w7V)6L+
zW-g{`E5lPxF(D?n<xw257H|pHG$|OT1lVVPA^KQC6HpD;!z)tHJ^I_Y=P9`8UsFGQ
z|FcZduz{C`-A&~|`37pE!=X;Kx$uw)5c0GXcd4y<Y)ZZWDl(5)N|@4}k|#tTxXzN~
zf(`iqRnN!Rr+?%P2>(Q9JTuvGeumCMGHbZHp}{RyohfA=Wv0S*rJ&ch4~FEwYobj?
zD!GrAR;2HQ#C`7U+8(8HGWZ7^Cjdj0anoL3<=ov*41WksWV!Jy(N3G4WLP>O>X`@w
zte0~CJ!-oQN4Ilu(mKry=K>A46Gg)fd!dFb6kmY^ER)=Txez?Su!jmPzyis_#XL>m
z^*cou;%z$K0;>~N3qoV8kr}MF*8+6}q|9Icg7Lk%c`bqcx4?HPLG&e~qzq3XC|hl#
z>N%lEqX-5?kw@e)YvVCF1Fj@h7Na6Fr{&rC2W5jx8OaKnq1lfPBlV;?b`wjPE-)BA
zU)4#JCYar*XZ?P_ov2_hK`F{eS{&P0`iM@tca!}5YX*>qDLwP}N5l48-@&O)>1Eut
z;{w6>2SGo+gsFdipZV30yCtSib&)JHu@ZUCpNEqxr>I>eX4gA1R`gV%vjd%ea);?%
zZICS_R%1)0x=2aBjLcCMUBd=U6<T5_Oyqc!Ks>>^%}Pzsd}sO^Fe!*;b?TEYCP}Sn
zPtK@__dP?ybZ^-ct3<As)A4se;@{D<54|bl-8%xmhpwJFiw+%Hwu-fhBh>f>Q5I9(
zd{0e3QFQ*I&ov%u^)#@H05-auu1XR&D>#3@WE2zLv4mli?KydUbCSmpiZKp1S6Kid
za3kD#U=Om$9(s0#2c~he9w0IGhUez8Vyq07Q=d@@#y}a?ioPiGTKSZ>o-H4Vl~sj{
zB6avoM=O8PV)jwz={&K~G&iL3$Dr!O&0@n|=@x<Q4c0m9r4cH?!Mqe#wuo9?EcjX7
zNawRD(}}0vo*w%iKY#v(4GntPaEn<jYL(f5Cv%|dOvR1C@*dIdQK1ouThKlD-g5qo
z0`5us4tFxPvJ(5WL9Hc{5R3TWDZ|%OU9^?kbIy^Kd&yZbO(k)dog)A9v)4p*pIj<E
zSucY*>m`pdk|*APt;K2tQYSIe-oF9`_%yS?NH^5V-9A2yCsR8XBsyCoVW!$57q9j5
zdhQPas+j7M6|sd8^ION)pC~kl$J8p0FfIHYr1KG-R;=<xhmPCx1wwTyI8HMrCJLzK
zmw;|sHOhUB%=pGy_d!Py`0eL6aVe%Q&2XNua8o`l8w%{mx54Ali9UjWPG0~o*7TLo
zm3^3oy6K%dE+GqAXKd$-bGS=9yz-{XB=)8dhZQ|YuKR8J28LU$6~kyK8?plPD2k-!
zCS5<Z7a&d6vqZ1a8@GQubn)`sVQN(-;6;t{4<&N|c1QU@#~pzaXZOo!tW}<Rk7nJy
z%BP<5QBNac6}+z$=&4=dQn(y%2z~^MMu$~;zI&;E^)$TTBr(h|BeXJQ`L*~9@99qh
zQshf=`i7vxixaI5%dbyP2^ROiFu8fVPY?Y2<s+?5OuKPG)OSOq0J%GYZ&+r^IG)dm
z`PhU!`)!D*F?g7*r{l)6ldKfv;{=WKR52s596dbW%en3(`n`*fiSH2o;AQqN&bz(+
z<eP;pU$zR{>g(u3HHQpgfDVOlmSbO8W9OiKmF-QK5CC#n-1&$8`ZrC0>gy=b==lhb
zRK(hikFV_5)ajP%HKV3F!{td1UoY#%swpmX@-1%1{;SlIo-ZsFE5CXgE_;m4czruI
zQ8AuM37^U9Ywu#T7O+s$Qu(&Ea-9iUHKLMQRPxkD%Y~0GUEHU+L2g?>u>U?U^s>{|
z8YT}opvIProK2f&$ZpZUcJ26dkZSa4C(Xa#F!VHWwIa$Rm5<6ji&A`#bT({sG1agX
zI2X2jiwx&U+<B&F24o{*)T{OA1j;?x<#VU@dR4XlD*m{ALYpeL!lg}9jh30Gp>)3?
zw`tX?YO}fOw7tVwd8GhtdUDan0zLm{!#tNB2R*Pc6uxpT)Blqf_uuWEFy4AsmL855
z9G90n=TNCy#_+c(YsM-*I|N;~u(&Fp2(-jn#)|A$rXM61utBkFt^1Et*iU0a4sYJ{
z2YwWUG2dOz-1zm{4$0$Da7H3-U$!Q~$wyw(`()I$OkWpGRdW@;PxI!~Ka{g*(Zw2O
zjs6|5ZSbIeRqK~^A~<Yng{Qpw%b~!OX0P~-TUJ-op8Xx+-Ve`zmB_a0dJA~R9Vn@J
zUT-Dyq(T_KkWAaZ0(Zi5Ozexyj9zi&Jjrsig#Y^(0g#KNDq%?@Fd}Kz7SI{d&xVwb
zQfE7mvX_p#COZL5z+jK^t*?$JrIOoz-vbx;UzCXx0iVDXFZJqK@-mst+%w5jhd)=l
z$eN)vAA0MI<rSuNoe@#@>?Jf$X@!|W0e4-YY*Xvw4gMwi^_my;!cvg=eL1@xFCei1
zAR`@}%iuH4EoE`aMep>&3nEze-`sIJ*9ivzd%g_turH7svXY*+Os6g^5xixGx$=K+
zO<fZz?*k&}^DhHSnC9s;oh4R`M3%%TiS0wuITqPR&B`qI-_Ki=?RCbICG&aCeTviZ
zV?Ay8wCZa((Mrr-_c(WO=()rTa6<_r@AZ3b)_Z>47%zewSEb_sEu45p=(Yp=$LO6&
z3Ovgx`j*d$!|A~hT0N2{+LVbbc#z~3da3}rm0}2qU^)8rLTH&QKDx1`Xz5Ia?R^xv
z*s1`*`KB5d6k*80o7G6ia$LG@z|Yzd?iDE+6SwKLQz-xT5P97iwK=}>D1wmZ&2#^M
z58=nlqD;}?yr}V1)IVxcx6&4zC11##fHAO++9BCnPHa>OE(VDR<tX3&3c!CF3<-Tw
zk9s1e)`=!Et%=Vt#+ENhvhh*8f2&sVr>~8x7?F}R3VT_OassH*?|*wn!j*FQSy;lm
zA5b_cMk2V8lk+7%D-8Qz7Fk`BGqjNO)_SB$UIt88X7AGT;(qXL@?aw8fAGkK8X=12
zdh$$AC=D;*Omxop9nvO9@=KzpUP`JUNoxBsP(gf#UAFv&+)10)x6T1}_0jdfsJGv?
z4&Lpg&VRg3?>Me@U3?<s#VC&Xp_8+#368vd*vHuhwsT$-GoZ5~$3CP?#c-a^+Dg`U
zg7PKjD9dzR?l)>Se*FBmn%xgvsWcV-q9L-3DQM76wkr6FI<LeHfw<y1mYYSEO>?RP
zA}G1Hi&7~#2H7ewO*#MR!Zp<HES+G>ch*UO2>F)}{%=?J-1kb}{GLjKWsu`?T5JIw
zfmx)GRQwg9+3;PxwR}NWHj_<e?gATK8{soqQ#MljKhK<hM(Vytg)WwVy2i<3_0a0!
zNNz3#&Z~4Jd4PhbJOp)3jK)YT(Bv8<@sNe<OXvp|78HX5-B!XAp{8(yv^yL~hQUwh
z@6$^d2C1E=`bBqeNNKU20R79tX$6zVUGty&W$CP&GFEd=eY_DaR|cbI{H2rxUG!2G
zs9dU|A(PiuqkPy@AbOK+2}c>ctS!>R3qCu-WYP0OI={2y%&b1PNY9hw4X`;C&n#_@
zw{_wH%ztN`b2`?TE4zr{qvVgAU7zKv<**&f@L&bBP%ZaeaQ~3qGfd-RRP-ys9*@Vp
zY^?H4G#dUvByy$=x7>`Fsy732d}G{8JHr}yqeC3TF7(R(_wI$=2-z5SUg0p&qoLNO
zp6?(I6>(yzRxzFIm7A4JD-pk)Mf-cZhG(`OqSoI#oU?(VTLM*5S4tga^67Tid!6TX
zx`nkp(K<`WRin6<hwR*9<hwW4m@TS5ATJ8~3p4OUZK$SJIA{og)AAqDa~)Ud3{R4*
zx1sr@1BwGRr9gqNQ_qj5)qCy8bz+d$-gtL|fBXP9&ARXU^_lo&`eq1L%maZOXfFfA
zcU8ERYhb>4z%1$CyZu>LVt>fPYGl$<%#P=*7B@NW`b_MA9WX*@tqSvF$T=LP%(2N)
z5f*Xk-;UPnKKJsy=cS1WlIe)88DLlx*yx{R*+Jwpnu!W#IrM<|nT&kHe*N5LT4iWs
z`1){=$w6boV%#L0PWAgcTTZonxzUz!XUFhlvTy|&_6bG6JfnK`wt&nM@kao2=mc3>
z%={dN0mi6W@&zcuN;8X#`*GK+NR7vr!BvJ0zD}QX9z$SvGvTrr&Q-j~`N*Cpw)XZN
zjwKEUr7M?F^y~vnjB9NZf_!+jFKS~}_#XLTL`fs{bf3~qUR=$qiiaX$amWTCr;~;!
z<+(=TQEn#Eb{{aKQA-M=T)$NL_tWlchUt^_%3Uo4fM5we_28D0saknbHUh{tLC)1g
z?K?j<7J6qc62ChcjPWG`b7$9A7WVXXzJ!Q_5A<)elLL_rw<O>?ZJpGtTuj$9s7j~A
z<$-4O*4QKr3e0rBmT4}l*rwI$o(n20e-ABMyYraR3F$cepvo00tsu%J^qOHlkqHC?
zQ=5km4jNZ4-Q;9Dps*;K*)rHb-fWnjk{|83aTd2kMJ>y)rMDY)8?li%G>wtWdEaa)
z^MIF<HE|C~iq`1%w)|t*vJaZ+{rl_^Ye=^-DBx;n&H<r6>DdE<c8T{ah*1dI;!L?A
zLG<sEC~w~*8uB2f-Imkz&YfE=8CtG=!gNXy(&;I$7iw^Huz*P1^2%>IjCsCZgTUHl
zJ4-GyTmX`hmFc;p8~rJ%Pd^|1<A~V(b&M4OdhEoly7PLTxVE~&>xn#@xVBn*k<Kt2
z#%Fy#%dq^uqju5L)k~hiz#4+zd=6wh1Iol{wz)|s(!~<CdlyI#i#NNN#1J7V+^0Yf
z18f+5nrs)iBs<kE7aBy>uZv!jDx|ZIOI53H@S`YZqUjaxJ*4pZ-s>1CbwV1$Gh&UD
zS>R)`+K}Js@QFWzFVBG9x;>oyh29E!`V;jH#fVnw7CLz~owg*bGPBJ14mtM2<L~F0
z<~MSQ&Zil3GdO=Gdz63NKYnDvOJ%$w6UN&TI~9ik$NxqrFPpM4cE?`O0|~1{%CB(T
z180Gsy0Io%2y$&Ig215jwa`ubP>`V;Y~^J=%fsGVtbTYiCc%a(N+I<^aAoZeid0^*
z3G}eAm(PEoyL3gY@Lr3if`fzn%~RnJ2XU`GM?godRnB#a_2BakJ@qQ@7tb!@E})Rw
zth@W%6W6M!o)LqcFv<cn)n>$>mr9o#$t$6<-rYM#)A5IR7oFelEY3^)6<Z^2xlZ+F
zcF_-Mtbm@Mtr5;&dooT*ut}N{>k+;QSzW$qA;$hXRkiocHowrZzwM4^i`kE^RKdgN
zdAEU*Bd8mOF|29Mzl34#KhU&Sv|n7EL?v_QD9L9gv#Ft=0m-nGMJl_R#0rmeQ+4n|
z2)LS8!*F)zjsyvtXN(r3eTL4@Jd}RDe0E_5G<U!^(C@hD`_{THLFz?TN_Tw}-Ky^t
z9W;Sd360ZVQGzwp#B0N!p%blyYRa!f#!Mn2Y8h)zhi15zmsoYt3lN<*f{%%(4fbDY
zhah-SeL~qL>HS(cGLF3ZyMgcT-&1qCLQ0JR8c}zquS7Wll87LCh3P?rD;tqcA0?rM
z%wn9uh4DAS>kfM*?M}w8=6iZ`*_?OOx~_3D+<ffknCAPd`aW-h!ycYtCi!6RGngk|
zA=EtPm&dW4{KflQvb~~^a6(Vlv?Ozv)2Gt8)Zu)|ZDDGX;&uB(Dfe@CGrnNi_()j~
zx|#2S;M(>d0>AxKVP@#&Kn1U9cXTPmkN(}>mB?p}NfF(Nh~gmwsYU2eu#p_v?;eod
z*O-mL@+ErnU2qa&m1t*%vEQ?N(zVQT_|AWi*yM?89~^&5gv=uD7qzb*)#4Fk26aS@
zmuw7j7TziMI^OW~MD)3G2W(`-J;1brX_1+9s)ImkoEBopIyG+18<W=v+%-252prGd
z-eN-_`IxBC)+<N5akWwlEtySufP6Fp?(h=dzwkB%mT7`He<xTXbJ3u7jcF_J9qHO3
zMfyzneEvkc4s@D?32S-k6PI{^p1WyUZlSwlP(P+L0X?(>Cw2Ph3zrm@M)*UovueE6
zddc=j1A3m5o+{J}m3+hUL^#{6Fx>upS!6P5+c<w#vN6<OCsE6X;sIPUloQ6e{}7ET
z3;~$i=%K`nq^Q)N`zPlQ$)Jm)9};D#MX*Q-7Wln=52yEF38FElwWJJ0j5LIX{Fkpn
z0gGq)eeaoP^kp@tfI4eO`S=fLXbwe9_FnAo`MUYA?H=*4p$bvm#?{2|hHuzrIgqY6
zm{4gXlJT=1SX}4WL(#@(<tq&92whl-nh;w}-+gk#-vJu~XM}~qFlWqBkG&?2DvjIq
zt?jhI6NUx>m()DVvs}9!5zT1{D0y;-zB^7|^2y9L1lG;TM41k!Apq8A-Uz@{v0Irn
z2&as`Mafcke|WWN2|Zqi=DLaT-Fn!-CoZ+w#$iZ5q(6K$kkNZbnXG;_WcZ1%F+}6f
z<)<iuj*2Mg$)Ar)D(4gjYmZM&80~)$vynC4l(^paH%)?KrUF&tO83_hMH-ZdLb~-M
zj*lY#<|px?7Cv-OJ(h1qzDQK-ET%(Ae3BPQG7k-07STvHEkF&YU1`iEKT47Wzc&_=
zCEa2)VrCs`Z(le7iywaBC7W1&@318-3ZqBacj#0|?szyv0xi)>YKiEQF9p2~W0iOs
zE(s^xCbG{Qv*zt+Nuv`q?ISq8oPqBKL76IIM^!*DmP;fdai8Rr%qwq#Bfe6W3d!n(
zBU~LZq1M*t0*9GJ?<ipTntXi)yOrPcP>2xi`1-*01G0qJR*T=pSHmD1AMprm52On4
zz3v?z8Jx~q$E^{N#ds^sW*e|m0JU2@yZ5~x9dwVkznYO22-lfXR*`Sd2hW6%F4#Xs
zlZ^Q-?(@q!C4)&U4u0#5a}SA(<8hzBVskco-7^y*ZhVb&T8fY4TscJaK>Q@T@lzef
z`V*ia<^6PAFsrH7WjcjXqCIKnkdnowmA>4~%ni0<w1BnP(&?b!%}~7_^u1<*mYQyv
z#8U6ZysgYIJHv!ho&aW>t9`%GHd~^vZ0|179#Az_g_Y4yz>@T5E$`T+E-$lq;e7Nl
zen_^CGh3&-4^CAJ*G0IkSJXSivcSciA-P)I2hW&#UddG4ImZ&Aui~>_p4%fpcCuZ)
z$fcaT;5;Z2@ynoafFP50m+N>%QMdJTckDMYYO}v=VC*@H)E71D3X1H;9$+4OA1}j>
zr^W(Zp!K6YA2QFoIUHf-#YTHgz={rTFJ8)&&nJ^7N6v|DvkBMuuR6i=jVv0NFyY0z
zk*Z$Xh&mfx&j0WHlp^u2sed=dxs>6u<4KQPObkG(MGWEUczLK}xH?y|^s+F*<hft@
zE>l0#&fup%+l5qc8J&EhOZ$O1XsTS)+=BWMg|1*QYEj;44eZ+gF;NXF2!~J2%Un0q
zH}X!xSPW#-Z<EeE#Bx94>kDIBV*F)G0~-X59nw1A#8YW-f5WmRAiPXv0|eiqwbMuG
z%jR~J8D-Lv1gIs+f967UIC?Ny@vQ7~)^gIR48di=QM3%fbbsOGjo8&#kg#BFt}QJ|
z;CAcX^73T01*^m#Plj34-&Ju}Q7TVGdo${{LK*D`QtopFM{X-heB|*8I}3nqSvXjF
zyksS}tVFGY@jF>x_f9!rKh~vBpQOHx(aMmKlwfjaDxdwer3wna@{?O8Ms3JNb$lmT
zXE?5(ox2$SM6|5`Xcehekb%WiOU~UJ<odb#O)~T4pK>~Dzz6rJ4SjRwi*W&AZi~_w
zz^8@htF|ynU|)vFw_ldnTZ9u6uLDo+ZZ&?Otx=9uhA+$dzD)xMFb#mmWQhIgsGVdI
zbKb&$tJdf-WBa(o(e(RczzUh0(Jk}Wua)in#>L({2q&_74I)v|^?4mkr>*zQsnrza
zSLb_K2+Uwxs~u={Pkn|(7kHD(iy^5d&_}o<&Llw$Dc}&_=kiZ;;^fvAa=C<>e%|h8
zYCC_^8+5aGAa_e$8S)EU+bvjXOJ_t&DjPjE=2~}CvXoGh6!R?2p)z5$HLS=$N+D4>
zUg`)bnl#Y;B`gW_OFLABMO^rCSBZ5XjMX&4FFs8lCHEX-%v#Ro3PC610_k8z$d$lt
zzZev2NwR+K0Z2J<BCxFIgH=wBY#xl+qCLI;GSk|1ZSwOQBoY@0CJJg&<}~JKQhwG`
zk(brILzCno&na2Q_E?y|s9#!IQchD>lD$Aptaksy02+9YNMUh5=S6L8Gar>GA$^Y%
z?WYjDhFsJR8zs@Xqn>oV(_cCJ*buYP%c@oGp=;`si%q*z_?0t~0Uj~rR*aT*pbwwA
zv@UG(%L+Vx1$FX?`U%nIT$<d5e)R5U%VQMJpocxZ4fiTiLU1iL*jmK^K<T>cx|>91
z6iAGI{IBTu-K5$gbD;4Ak~fs<w%t_A`ynqw=Zn1H)q=@LEtvYk$>hu|28fotdRCX<
z5RhNz)muCflu`}T(!Q@eF>#jUmeH+{jg;-PWS#ThNm<{l#~sj`yJ%AU#C}iP$(N_q
zo_=9aKkr|%u?g?bO&etjzH({s3j8204{=z+QNd?F%8NQ%?{IOb{u*^SH6VG9KgvD5
zDt$=|ZnuoK^kZ3ai1T4+dKfL38lH8SJvSH~GzvD+J%85En<*mQbd-E&4@eVH0-9K5
zK^EOcjCuC+n(E!WS)N}|&-h-uyjlr^iE^vB^tkDp+z}EdmWZ*R(!FzW0UI&ceFh}O
zP!HjZ$YV5w_;pvL<#W%e+jL6w^SjZxR&#A_N9hzi@8)kh7Fe`~FRKT9mna<gk)EKb
zV)`N`4nD5aydq}K68O@zY<?62-BffiP}bIzcd6CohBNKSwdITgspmY~8_zbIjNL(_
zKSl)UG{HaqsOJj@J-70svANJ8X0CVF`j*>7f)ho81AOmpve&KC=>@o2KHw74CoUx6
zaaKqwh-2!~?-BdPG?_kzqvGNcCcqEVcV3zh<*R2_B*`}I4&?Cxc?DZw(3UH3;r&du
z`A6W<5Q0*H)OG2}8}euEBU|83xWZm_;M^G_FX&oCuw}+tO+D|G5LbOLUP6(nKcQ08
z+fr>X6j&_In-*(krz<6qL_1k?^@l-eKvy5*v;ECiwiJF)z4V}jdQZ2ISj<ZLUjXpW
z*qCMgQjagsh+wN}vIO#>^q#qL#C5{>kr8NgWRD~yDPuuXHRtx(kO?}!pS40}Bx#w5
zazgoE-6m<T3OIf9JRCLR&3Z$nLCx-d6#Go!lDprW#t+dW8yfc2J`}sz#ntA#9dh!U
z3K4zz=9_CY#;qzY;q`Xv>%OF+Gcc${k>ItjH&H}m7SMb6n@{Hj4DNQrts2S=_~&k`
zz=|JQa=g>RXR|yLwBVR_pVUV|Gfol?gA((aaRU6830KQ^W`gap4)xZBcDV0ZjBm3k
zgH2Gj^`9Bi(SE<}6y3%_1JA{~Kxj|}q@KyzCmZcY(*BEvpkd0R`j}hK;ICNb_<b*$
zj{e>PUW2aKV9*Z+;C()@o&@?sb0@@5jSm7sWB5i_rc*8YG-D>!rjLo7#pRgI$BWMh
zyn{~bHHzD}DJ2`v-g$(4^Xm~+lUYsvxz@PTbzWQu;B@hj9>2-ph~-hjAG|tu>VakY
zIuTzd6PLX2#4CBh?t8+6+>uG^fAbeW2LNhF{(n`mBa=@RN%taKB$b+0%Av`_N>?>R
zg<nM=JXqq-z|8{6zAfFC=)B<=#-S(O6Su;_{0nT6-hn!5*$QQ?uDECxG`sqwD(DK;
z*0m<_Vlt>(htf6~{DPHn74Kj)wj6CryEKX9xjM`b<G^rV1pK_yy$Hl=U0WsK%#jN#
zF9&4%y0lPtcP}uA!Fvuz8UQadpdSZxy2TV=LUgu(3=v0MYb>DYE5UVcy^7a)P#%Sf
z)Yh^I;BQwq>tyo}$=q?b*s{2aQrwNaQvdSSWH`(!;V>>NT7>I=kdl?+v*8LmwWB|6
z`DnJ{57ysy6&57}X`G?_|9AH>X#9<I!2a8akkQ&CO9~61d3Z&(<r}IA?2}cEGzed9
zwsQccq2|DHBSPwer_to?6)l*)M6IEa)E(1^7jZiPHmCP=)zC@ya;r5QS?is-W?^!1
zbq_lGqyheP6o7KXZFaKaaNS2lltyE@d((w#6$Ly3fN#`wI1v+YTLwxtfay2lh_QcQ
z`aCCB6P~!`IQWxN%BOC+qScANc4yz~jw>NU&;t==wzg3dsi6KSzR3$a8G|Ty%8<ho
zs7ATC+LqFwR8C2~43}1*B!L(Oo-Cb#S>EO7Ux#LolErZOt3J|fWuUT|Uz**;q{X_0
z(`Lz*J`nb8YR@rn_4m`7(%%CO#;vMrM$2ZNo*COh$D5VfF)nfNI!}spN&_E{3)~4H
z8^`uvq`5sMtC!69;eoK-8;*%Lg2N6CM-bGj?T1B~A6s?rZd%@xsqJ);Y?boge74<I
z_->5Y&O_wa-Ijdd`fqUH453zoHNG*}sedCebu;Jfe>)1PmLc$MY+%>1z9EDs9pFoO
zN;|^~0J}0TZr`OHN8<&^FaXeF*=o}#Ugu?wQq$D4ZCul!>oi+%ll%OG>eBlzaKgor
zuMT9f=dLe%gjz<CP16eq$2);kR^IZb#8OSPnofx+QGyy?!tWg0IdXRp)hE1USk9#<
zU4n30Km-V+D%g^$5Y_s(9$f8ZP51@4YXPJyFXu_UVegVUB(J{*Qn3(MyYGcbsKw(B
z&#4~z@7Kz;0gBF4b^5PgZ*5$sZ1xdYdl4ld3B^<KOl8K!sNlv3TXp{7XEj0ZSE-F{
zFUzrKLJT_%T?fa<Cl>a-&W1pb`0fJXF;p8Nh~6vVx%QgqcNQ9WcfbpWu&eP^myhw3
z=h7Rk!vw$hO|CW(7xg;eUYMpzJAM!DFi*3j%0m<M64IF&r|`*PxR&3sNb4EEX~zqw
zK-`uK5Gw~)WSn_{YjJIF%XT@f_!jknN7PgkhCu)~8G>Kme7;eW=mM_;;@PQFty%s?
zD#@RQQcHp1MWtuHx8uWX;Wk?v^y=E`mg_`?3-(=K2?N`Zw-Ijue$!|h^r%BEVqa_<
z-}DaO<+kt^MT|6YzpXMrlDUNR6IIQas8mJC#*hjTz$2QnjB$weh>~DglpiJP5bUxX
z<b;@trrk4}Se^9;W=1-H07|JDk}-3dEy2%Ja%^y-oY>?#O?(%;(sr~H*yH}~sBO|-
z>HsD?DY&uOxryIHM6<=%`4tp59pYNGfqTD%#`%<5g%=|sq%wug*O}w)vyyE@HHTf(
zArBMLrUL%6Net1Oxue_C@)|)WX`5Yb(;I-H0M{Q+{d<5IE4{8}qabwe{1@%->R!+g
z^H34tj%X3l5ZazmkUtUCHoew2*Le)YA?4#U0J3_W6EG=iJNE3)US4q8Lxd2UaCK`_
zc<e;ckgSp{p@&;W%Q@96#;Z4>7KhJotKG-(yyC(E1O%YeRTB)!k_IGqN-~r?)>yLW
z(ssy1QRWIeZXe;nhA4B4`P4ei?!)7Kugs~6CJhz#SLEqs68(2msPm!^91n!JR*%t>
z#qntZD4PD#=*k7J6zyCZ0N}t8TQ1=NUP1>@Ws9lncWm+kW~IE00>1LV!(|`&pccr8
zr<Vf&B-gq@SA0gY$aLy%a7!x0u_zjOYpyxo&o5tGu=i}MXQcsaIL7;6Lzo`7R_sqG
zZp+wO;_(1>C!Vw?LXyn<iS?qIBa^-={i|?*Qqqz;S!KX;g3YDd2nY`6s|`|^l6Oue
zr4$}gEFQm$Bd_h?YJs6yTodE$#Ht#&MyHRtf#q9vSOHVf+N7g=-ldsrUlorYHdsZY
zl@eQ{3fIqX*Zfs?lEZ?6@mM~-j2LABjTkS!zFG#JIUtsV>hhi5Zb<0li@7FvL<hik
z*xVkLg%FD`7JwQ%kx9tRyn!9C#XWF(j{u~_2t+l-Z@q)6!UIg%y48ILR`^ghU0BpW
zUYtkarA=**`%W5(_w*Y;HA&MzhxTcw{YDYYeT3s=Y8wF8=A>h%hhwS_OSOAj4dyDu
zrkIgxexsbUg-%@nD#O417H-no4RUg)ArHJb3^-cgQZW&xc}~m8EgvifNg=OgFV@pV
zioMuwJFT0(Z6}!)I~Eq-z2d8~%^>gwO&2^25!;wv{z=nh7#MW@AZ;|oddjg5fSj3^
zLpA+vl=)`LkaJV=S7K|NC@AM!k440vsn!bUNxwi5gBzaY1^Lt4>NuBW9D=yXDC!N+
zY^vy4TMNL&9o&UEstJL;GCOs0nv18dt=6Y=#vTPE0&k@+HhH-7OQSQk8L1{OW`Cm|
zw!JKixF}=jTh8;XCngzI4--i<PTh_8+eTvxl^mAD=gKL;L|+gt4kBI-a|l&i@cbq$
zCj)ui0%>}{CRXF92r1V)eboK=jA}Kfgsju9V>2)faJAR2o&s7eTmY={X~)XYXW;7h
z_Kw8*Yw=i5VWtO&$>4Tm$@pFfBJE;C{hBLcHPSfuyJTh25wu?4USFKSEN2Rz9<NFW
zDrYcU*k3BsQ}}vB@i!B#X8aNNZ9utGIQkoDF!-I$vK;j(5O;0x?&%^GY~t!h`e3E{
z#Q9T@RE5-SG@W<$H&Pd!dI+YSP0S9W)_gkmd2q;;n2=H8hDlhFmyPzW=D)ZQ5-|Xr
znpf@#WtpcLRK{&izip~^xMyv{<|byMi(4+hwE`t+1or24C#z0Py{b<HBg^7Q#fig5
zSf$a7UrgpMx~S!+MkAl?z$njQwA-&8!cfnxfU_H`chh1iojX!Ssc$vZH`inSi(sO_
zq2Hn`i~PT~XKZ;fIp4f(Kcl$()V!Qah~$Dmu;098ATQ)}^9Fg}6=5N3h@EPyYr{<o
zxZ<{!?|SQ^!aCW%`8<<eiDeniTNRr7JQEk+gkNFbY}@QKXlvW@DsHOCVUTa(Cd1qe
za{J(==AEoZ8Co-iF_RxRI+l7QG<m%rCA5;<<dC!0_1>(}TRhnTk`7~jUO={RUGgO&
zRK<Uw#f&h~f$9<UIrpbC>~np+F~E(&Qclgo0pc^jNno6Siwx&U=Dt*j3Y0cysS9^q
zS^X4SE)mvP{AXS1&F$lay=C=|a5tEv>ZIw++Obmag;)JT+d@(2?78aa9wt41z!$UE
zJ8>&M(QRF}uJoeXi?-nB=3_YC)4`Q(Hglg1-%k8_D0BU5p}MplYocmyr@kfQQ-iwN
zf%DBwkRXi;{Xz3(6|)SkFOqDM7bY+Pk~#s|r?OynqQx8cPu))j+2J>+UJhkb*^8!p
zIy-I+ZMk96lL4cHmp&EO7W*99et*7p__1uhzAC|TLgVDscU3W?9fyib5bTv!AxV`q
z!QZ4;y`A0KekYAHQ~!uxyrF&je&^yh-DtO|8i(jxT8OVVFT8CoQHUCEy53dTJ-hOG
zu5#LQBv!E_`*OxpNql!#BOfQMHd${?GMKNjt_-i{EdE^gjmUZM@}AdoeI#AMxov-S
zyU?QzufmspQR{GN2>@b_8oKHRGDHPGM>7+KHr5;|HFK|rokZU=$=^Wie-P%pE%iiu
z-$i{?<tqX({Cldt#o~_Ak}O^~rb?c=bq3_9WI31FXK~s`qOs8UYtz;~>JL5qjii%h
z);UAD;+~QN`V9RS-S+s$?y<J6>sS?i$B*7P1^iJs{x5xn9!uB!lbU{u`F&BTcL=}r
zt84M&^aFZ0UBan`KD$Z#);vXPrvIXi?x7kNP)^7C%~R|mj?bCXJ-chJ+)P`!N1E@;
z7=tJnR7Q+3M`$ODI(->t^3nE=J~4i8F@O5T2~OBEE2-McvLB+mHQ)~wYG1Q6@iSJQ
zAf0+RlR5Rn4NVS%=CJ=jkT2{9axiS(_+2@VexejxFf{ssv`gA`R1|-?{%qwVUaM$T
zPn2e3p(OEPkIZzTzcP3yaD)(fh|E<6v5@y9SU{p$rJ|HbF1?g=ad!(%E-pPiKr^go
zIxLzaT~bo6q@>59#3KD|aA<W{G#$hxI^S2$0$YxXT3(A2=LU(JCJirxv_R3zqNaI=
z<mk)1))`)sqKxG%Adr2yaY<#1=|5~Gowx=DErTrmJKa*yV6gt{?qx8a+gVa?vL=)3
zWu1iUQ;T=%qJi!E(;eL#>U1dgvK9!&_w@`H2m<*t<PA|ejrvMDrRGYf+S0KOun0*Y
z#{l);52h&n5K=J`j(6>-U-!ppJsa1VC76iwk~?%7_KdwBSLH7YaZa4CqtgjPnK=U)
z!1s_j;?lpex+bU?v1-AgT^bPs$r6;@e?M%$Iy}@igRCDD4vo9!hGCFki>N7-i)4QX
zrv~rVHmz{~dlB*S+6y_)OL0cCU07b{{%r$!fc|VjNY!G1y+O@VlJu%>h`TtPk%a7;
z->@aj<&^0Ao8D_6&$Ha=(1)U#zf?=nRq0ng^;Zi3|Ea%weqK})Kx>DhO4BL6Y}%?~
zky4)cWh00a^1FrI`}1Gv`%d%}rctb8rC_fFeUFSRbG!q9O8<lZ`puL(XaB!166G4C
z)ayb>&tzYd-|(422HM|r2}N)%r%bGlb&D9nMrTn<s;YTQU%jUA#oyEs1YltjB;fxJ
zWwtH=H@d@0Gpa{fLN(P>#=~jE_HKzmM&RCFS<i``TE5;8FZwG3AFb^;3*c6?cq;!A
zoW`c0r(*i{QXFq9O_#OEC#Bi9?b@RZuGwI}!vuy4bTZGuvW#z>m(BGzLuW>1-WI;v
z=um6<xasOI5dc=JqTSancgM^&ok+CW>+dyyQQvjEla%$WjB{hUZAJg_Vu?ws5-7F&
z^^O=FAg}><wfC2cH{UI^3j#FBE%?9Mr~FwUN(vrg)shPX<k<fUX@>ie^^D4an4hyw
zyOSXsIGR+`q}!gOCGZMOxhB|&zL(L>^rhwWawR=uoY-q_sA7aA@|NJM`r+<-Uq+Io
zx>j!v(J5siILevtFd<UGX=6pBOL_31nU3AN*^2wI8N#?~&LEJ{iC_kS`$Fuz%O>D}
zB(n*lh;%fH48MHeS$P8<m|Iw={^)XPL@EXr{(0_UOczkept)`lV-ScsUf}aS4!Fc2
zizj1U-|tQ}2<1;A&0>JRLrlk4yxS>naFZhHaq*-_@Emp11s_iO)u$6a(Scs4V=F)q
zS7=PQxaFl}Q=&sWZv{}QMDJW2@KID7o2pkf{H^YOy2gjY&>f=e6|y9GZ&|(ua#pX(
zbC+g_i5S^8ZH{q5|BZdIU~a(wfwD6|*W`SBIkL&Dd_pdavi9klP`nFs`14ER8?*g%
zcNE_wfMvSuRMU0GEn|8FM=?!{<*9XBRI&L$HE#lvWkPtRudotzH}QCClRG6B7JgEM
zf=<u&*5vGIZ%r&L@J1H^7@Ck*TEk_A2=lofsfbOI;(aS*Q0%R6YNy!RV@X*vd@=JN
zaORe4Le9yOd4$mEh)IVK0!GhR0Z-(RF)YD95hEd#RVuGTZqLU0-=K(P>`%~{)bVzy
z<s*<9aDbkQ8+$_Xp}E%&)1|mLi+miOYuRdTm3sSiX^*4oKGlDK0Et07DHOwoe2Ye@
zBchjo6Kqpec<y+|I5pGd4I_2eJ9fZ4r}v#%p%%MS^;vMzd8-Wq@&w?Lm-rnHlKH!6
z^;c}fc<ymU$M5WoJDG^}>VeS_*TEsgl%#Ai$0Sfw|B7)b%ppwzhsu2+wahn0x2di7
zpx2Np0N;)D0?fC>GEz=|e~cw_;cInW_f&CYfnE=n$d{ia{TcCp+@IBdsz2NCq%`8Z
zER45>#=r~ddK67W^8QsTN4#IT5VBTVSB!TqH5?+UJno`|9`BLWpKLAy$92gIAs%tb
z(~fYTAaqi2r<^N}lH&Lf$@6&Wr)_G(Fr8L><1higj+?OGhf_>p$~eH8*$G{|YSDH-
z(c1Xk1i8!!;lA$>k%JR$JH$YG8S<x3P19E-><;GOV_z6MZg>8x8{k*;LtK|DU8j2`
z#1KFkVPrBc>B`UwpP(C`Mm9CqfOYNshp(5B8saxX*ju`Q+z-Ge0tJYz|CULH+`pO_
z4ujtZShhp|sZjTTdVXKPkxHP}IxQuyWfKCcH}lJZOzD@Wn#A`Y(iZRNBO_p4qRcu_
ziMkQoAoSSUxCuD>9fsftmlF9fnu9K?arZ<f5s6`VG<qh>-G+go9wvMY6iDu6j8u}D
zr#df9uP<z23j{}~#v!`eM*sjf?B}7jF15^yzQVroI$^WLH2eBmdcGi5K6}Xhw4Y}Y
zREs0z?R%G(tyg-~Cla@u3ZstNy9-+nuBxFT87>b}IfP0%G>#rykGYr1x=yvsdvsp<
zNL@T13cwp5yz>0?e09IZX;5~=(LAkz`B8>WzxKKQEiMltdOCCKssg=N|LT*=CKI;n
zdjT;QU(4+7BL+4@GJw>>9AIt%1v;~-(pjqi!<?652q%OWE7xr0d67U3H;R$j?!^ay
z8P=c);W|u_YDdPI=H3tw`uYbeJtV<{z|~wFlu;+1Ii2y6PGi@iBp-UhQke~^Dc4(J
zwh@wGhDgx?@<~tEDMc7igb;^m;2N~LGH~QacbHVzO4<zm=Sri>|4f%rRq9l9eS#Aq
z(9Z(@;HAx0IbWNX3M*e8QP0dD4#NXhH%PzqNG~QlF3LEw{~wOdGN8$?55wCSFnW|U
zj23B-?nWAQfOK~&r8J|IP*4z%QWP8wqLkz)DU}j~7^R@FfyjWdz0d#s&ZqG_=bYzv
z?)$nr<P5{U)-6*qzVkvH8v4?bf#WY0k|ZMi+GlgOKD&_vKvJTldz3)O|K_=V6mh>~
zqMALSFB_(58;-t<l@vO51gs7y07uY_sz-l4?I?_209F>FbpSGoMElBM*gP{X<Ak5$
zysHyu$;?~{p@(4?ubp0wNGhnm9)WcHR*T`ujQonBE#>c^aWIz`q7E=fa9{77=V!me
zN^hK7DliTvvnT+S4By-A53Rv$r;$|5o=@k-^Xct`+$(r0mj05yB?^fc%jhxkP4X0V
zuk**to3a77Xy5H)*K<4>w^FgOfg76sk+GGu?xI1~vwZ(2R+6X3N7m9XrM{9_z7C=v
z5`)jY5yjPTl~@ie+`V6xvKBiei9Wg$l73Wih4jxYDxK7pVdI<JcV7&#w&a#kb}T<R
zQf#khbd~vd((~Ia2usKR<Y)G@h=Tc$Ql95+FD-?^p8dLh*lsoL+i63B_m4*%;JV+*
zVRy*kT%FWDsrM9Aq;;mzsR@eBV>iQtX^uiV9)5+`uf$E|zlu5_b(Su65dPS8<3AK9
zIAIwo1F9<cUd6W*2`DkM7wGHY@}8>z9Y-w05kS`6->u2C9}TRZeuCs49=T*pQV8V{
zERiWW{P_@KZBM1V1?L!ZvV=<a$Qa_+nHq?VH#KO(a(1=C)2K!pv~%wyhcysW<_1>;
z;Nl-J9ro)y;<sV+H?o*Dh0(5m6bGJ67Xwe@%dBoRUIBwQc0{Nm|LaV41>Iso#eE;8
zU2u0VD?_($ZvpxdhPZOw%(<i7A5jj*R>y8-POgDytlay@lF3wd`}_R>=V&5{oF$H|
zJndqxr(L5;ash@g`O(f}JqKAOOpfMQNPOj+eT2!_S3y~%BQ~k<VKlUp^!M@E)UD%{
zd{l$^m)|ng{Ubp)m8{txnq-MQoM03JfE~9~c52D%8uxtiaT%laT-VCfET5T4AY^;g
zjsmL~`wDI?ZJ<L#DeQM4I}XMRRmWc<v>OkYNM`8f2WT|zUu&d2@<(9b(Rgu#ZZ|r6
zo1IYn+cf*RhjwG6!N_U5veLR4YRWC><wD&p%@4+Ff}d)195dj&&;HEPSy$aTA^cW(
zO%Z!-P~}FlKY6W;yrC)TA;ma!tC|GfpkUHV-8yv%e`P=K;s{Z+;i#y3wEfY(z%C`O
z-j8GTOYE<=2?r+&*C@Ro3^@$uO4|={Ima4?n*j}bB7(Jzy<y5MUU+6(1q{ymY0QWD
zl1cpqRoAOu%qASwkcovnWzo{nA=kdL)R*TMUdBCNWE;LlIuH0p9&w+V4llQNv9Sl0
z^rVq5fFkudDMm(0m((bQVzu?dyV!NayV+I?1v_i`6lbFsJK}|rjthZZL=)C54iN=C
zUETz{zkaDl2U#$r5hfs|k082S465%Dr|xfG5ESwrxl1al>Cehb-nsKJUHfDXQnulu
zwsqS8iw5q@^6wuzE*#pssURI5eO-JWF5)G;MB!Y|=qtq1j4M9JpEYmn`7iR-%|2c4
z_MrDMEI7hnsx0p#5X?3SMh?q7ktz)Xvx*H;SH|5?ZE`#hpt9xBst%?mCk~29L?df@
z|LCyfO~1Ui*4p9)w`32IvBdzSY@irfA-winir8z6?x@#>Rt~7&pTNMjh6JRM$jF5V
zf$hx+_bM1;M;XNko=B1LtZ9RtW{mo!u!5gd38MfPlT=N3FqPsb4)2VQJj}~8Zh~*S
z8&g5+8kro}?ZH1+3lBv)FhfypB2LaG$i{@>m2DIn&ui!!=-ay8Kk~z9Area?BA)}?
zMWCW=qlS*T2fRMIJ?E_RpH0FFk{A`rZpUk5NirROlD}19W1pUm#*S!R{6E)D=tHmc
z1qX@xvWXW6kY|a)A|fe*JU0BKpMsyx@W^jhx-#+i$mxjPf#wg5lXiUMZLMndDym@l
zob>lLDzDu$AJiSV9i0%SGk%kSu*cHokzfAq8#BL!_=M~rq+^qXu;1`2hi9crBT+8E
zK($}m9!u94J{ks3uo6F&bcFwv7-iEtRcl&7c>>oC;*E@R`^|3ClL?d48K-iIibz(a
zo6%2aM{8y=yB*G{>f1+2e00^X!gpB~%vrL=tfPb@zxXRNlY*^@dI}SMn85A@%uw{+
zqzIdMX5{MW9jVE0{nA}eadI9eAXwv%8OzuM_H&?bI>i6uR`;F?a=KIp)m7JMzf~qg
z=5mRB9~eq2lOI=tjUcg>Jv7OWe`uUMt9|Uo?$~&f;`YOz&3tPuRiB}$8KZPd{pK)&
zHVeJ7!iPUzPxkK58)Dd^xW1&VKxY+u-&G2@{J4R1rQMiXrTKi7d*Xh{BW;=LyCb*&
zgYO?(Bh0DVpR&|$oyhem)H?)93(_0mTD|4-QcN}4n8q&Rz4IE#6XcBJHNR;844!0q
z`m#3P^po$|n<JT@?m##fVb*-v4X}Gx!Xx({CW1YZ)BQ95u-6GD?G>U4fBX!CQF{Dd
zKYFYAW8^4xj>DRhJ87ul0;K>M^VNS$Nf!~jCrLDR_1+zWQFcIVT#ob8GYYRYboCV*
zNY<mexvNzQBX4EzvpR6pAA83kQ#V%GJ7^DY5#5mJ2CH^pU+-gXMB3H66(Vt{R0SI=
zVVX7O6GzSc%5T4>Kjy_68dT7=%KBj{W+x{bSA<&h;-4%;o?OQ=gdxWk?{xTVt#;+?
zhH6M5N23>f>?f~Y=?kMB1mm9oCzup_1ARf0TB~QlckJ~g``xy8B7SnOGX%cbbK1ba
zylD5aG`;w8<lKSA3QCr|`SWz6dY$I#eAj!a>7|8)F$snC)0IyB)|bzE8tpMhCP*dK
z6lA^slXyMJ=KHOQtnyr6Zb!$?paTlsZd_@%o2UAob|3#_+Vi2ZzeDo9469=}FGbwP
zEtgDwlv8HvV5-*ReMSiUvuMg7=aFd3<rIYQa3bS+Kw4^6+rXd5Et@7!N3&Wom$Jv-
z+$Z1xeQv`R#8s2Fa+%~kZ`J%MH(b%sIQ@xQfiR-qjq9ny&#tTHy+UR>#sNNiBF4Hm
zzyEp7r3T(!y0@xUIDpsEt-a2>OJWpVd~3BR47iT+^X9lnj6FVgBmbBN-4oIfGe(ZO
zaWOW%4L{om(up>iZhvB(vjo=l5O$^_xd`5B_m?}v<|wYzGpzBowKOu5H@d({svvF!
zZum*9GrK<z$C)Fq-v$}*Nui=1EFgn$MUZBTJ*cqx_md%AsPG4+pYUGwKYOw&NN4eH
z*JEneEm)X%IKkp)is4#}`?IcKJv$D~pBX9FNE*ueyiyR@$5|bMNxGlQ=bw()cj#se
z3_U;jS8Y}2Kh&xLa^cv46cUs*`6I~hw-xgrbj;HOeGQaSRxViuQ8h4uiGQMCM6}cp
z=4=M!a_gEu67-ds)?>{)zz*;o>P=IROX1UaFdseD0edNvu9H^29P9iMaVd>aa#mcq
zvG%|b8zvI?Tu|y~X@#%6yeoIQ>kE0hQT;=>j*ql^AiGo1<*MYKU%xYp6n-xX_*Ey9
z6dGGbJQuEyYc>||njkd03dJlEZ@s8qrHO)uFmNp-Du6|1UJ`U=j9=Utcw`b8y!{QQ
zGB2yxpnTW76IAyL%2b<_BA5_2&`0U&zR5|6sP{n`%TxSTol5-<Z#3u&H=?M0v&k<1
zhAWwT#@ED}GJTgO#KJuJ+s?E!hI-cf{7+veS55o*=U%onFt4-Qr`hMqwau)hv&*9;
zDVsD9VHkf<L!d@*>Q5qooMC}p6Ok%ZJU`BG!^x%5>*MLxRP_c#lf&io`K%x%A{!(K
zlTUv*7h=tbCXTw&EL&m<YSH?-E0{7%RY0>vVfC`0{+oM8qhX27IG3$HNDU|5XI>N`
zb^SUQDF3`v;rj^-{80Cc2cZ;j*`O{xYl=t>;W?{gEe|v6X{ygjX>Oy^e6SMmHA7D;
zJnPfFCaw>EKrg=ea!pc1ClLi(=96|i!tmc!UK`aszS0a2<8tG2_Sdx>NFhWkKm04p
zIZFG&WgNK^z2kI{M7%j6H~ZSD;GrgEkEZjiSM}aH#U3bT&v@O+_Ndpd=wu(`=?2U|
z+yGPK7C?0z)#G{JB44f5xVH5AjQm{PwH~0-0|)%I=C`jl>ayFxTrr8t8LaN~mi4HM
z+S8z|2=%Q8Zj;C%P8j|5iU-||R*8CyJTuSb6@<FN>^if^@rjL#KwQ?bD|WyBrqG?;
zelDy84JA1KBhMWQ`Og<ph&2T5kK0LK#D_l5UTo?nW$_K>`4=_48i&T~HfAV2i5-|A
zy83QUTgb&H{&1&6Z0ItboqvlpX2OSmsKT~U_&%Igc;XYEWY{yqUtOrQbwI`MJy9~d
zA@*rb>)TYe!3QoO|K#U%U4<{7;<X_t1`34sDs{wWEQmQ-{B5=C{6s<N;GbLkG${H*
z)-|PE;c(_e<VK<m0Om4lnfe?`&P>9wBm4nAO-qc;mae(FZqkOk2yYrgRV>S-L)PZm
zmADlJ#xsH1zr9R|!QVpkip|70qCQ@7FxeypBos`4ZPF?c%1k*PCcO)T(mj53Es#oL
zGM>%obBCM2KSGOxS9t{8fK6Je?j^f1XCYf9&~-N=RM%>LKKH$|?kSI*>fSEXzn{}#
zx|Gf@CN)jE`%~d?Fz;tEm5i?CkfeVt%@l8+`0)@@XitTO`pM~(vF`J!?+DYu;koT8
zJolv3M?GOokk74o!5a0Te-V3Mg2n=Qugsn;p_^pdN9=(o=ON!b-|l8e_he}*upogV
z&fYa{&DZN-8JxkF@rk+ba&WMJ1f9NtZ$W3AwGOb8fy8qj?xLhQ&c5Oc`_ZtQPDUhF
z#nY7KU6!DrWsoe<C$_RhwI2D|Ir8wAP8NEJ<9c`|^U)yt{Fju~2Q@BZFT+w;?x9Jv
z)my{G8}#w@!>wA;&|HJOT7GzoZge(m_I4fD)$A|hSy}yxv=&4|_Xe#;h8c8k{|X{u
zBO@?uyhHgT{qFyVU!^ikrH<Q<j9*G|^-rUxL=#yS>`a5o9D9xMB~j6?F6d(wLZ3^3
zU7yagEJiLnUgvkI$SJh3H8$|&E{(lHAvL#+Kz(^<N+}CM4SX_N<h0SV!vE@#A*B>g
zTDb(vzxkr%X(>Uzs?=Z&f4?yw1rVe2jO5riax#Ac&nKP2LLRpA6s#N3XlbKc=csT<
z&UPSk^#)zgRz@#lbgq^3D1|$%aBrZB<Nz3S&0d)|!JTX6zWK)ank|%rxk$(=CFguF
zX6$jeZn@R$gB+OHB>mt>(97HX^vPKw;FP_PzHLs|ckw3&yb2KAc!7J+6V`JMTto@D
zrAi0!t;vGoUb~nY`=GCY9B1qih)+VwY*m}QyndxI{O)9$emg~%v+o2_*Nf0J9K(YX
z<j?pzz%Bclx++Oihig^KuKra$9?UHqQ%!>J`t99<8dwVq_%(N$xKt?aUTWBdRX~s`
zIfb;D3>PLvpSC~|&B>WQ^!xZ%^#|=2gDMru?xll@gqfG7@pIDGXzPpmSsj;L5yt5H
zk|!faw!y{w=zbY=`|)={)rO&IEysT*S*3t1p)Oj&Rwf>PZQ60i_A#%Kz%5|fqe)Cv
zGTDbv$m6Fluz5e|f=g7`gEIBSP)qv_HTjq5H}QKDOaeDNci#gVLL`PpB|Ja35o@$y
zc$&mFe2WH@-Eq-B>9YDY8+CYhvG3Lk-*~_43gLELZ=MUYzAN5aWBmGp;zg=4^_ohz
ziz~vs7li0r?zsF-PCFehiJ9iF%c!BCF(MfAt(pER%SqEgpO78h5u3k~G?T!`hrhi}
z4I_9<bw!TB2gkqG;!ywmey+YqL$kQYXATL%SJG7tFMn{u0QpdeDL?h#``W^QRSI-q
zW{bx8TQU=IsA~Q3fMCE-rU9KbeT(TR=%?0L@=Q_*>=`*{@vR3X{T=p~V7uyA82`(X
z-761*z9(P*PH_Au@skHUG0)AIuJvc>7}4vuE*&5AE%3^ow==@Kn>X5h-^`OWeD5v>
znuJ_v9KBc<KqqThev13hki2NsDJ#|f>k~=4A-#vKD|vMNV5d<HCc)Z1JvzGhCOSG^
z`Rh>-HVDZ*Ml>vpy0LsjxG?Lm=bVTl^u%1VXCCvN7HNBFM+#Fp^jq8j48lViQSXqB
z4+b*<oS;3H0f~fF+J1r2GLH+3SfUsL>@g5Nq|@#yEXwgKvW<CU$;EOB_$3p#f}wf$
zmm!Tmkc=Gd1Mkv<U#Fhr{8+B(1>RB2HTXh&6yKnPH+jLQ^@Zn|rs-r#-w^SR$i&mO
z6dDM}3$hd_v+>v6U7k3WUX}ev_ow`7Gch#blq+^}f-=Q;#aNb(l=)V;TQcL_%Ew`U
zK)J6%+3d(`N))XzUzHr+=VK(|jrIcGC0(UO*xXNfWeVg&FQp9>GT{tArRI&LT-#6>
z_!!F>&5J$Vt7vWN3r8eBWX3-_Xb;OwyQDvq@|KMZ(jr9<@0G91>M=0Hx>Fe{KV+-2
zZ+gE5f=dm6W28dlBy@+5mvZnah3MDs($WOeS$SpGhY}S7LbQj&2Oj;MosZM+l_^im
z{H2pq(h@cMxBOCv%H`sB2HRuwps+i^cF!rWA~*gUoW(CAZy1n*6_%8IX9WfXlb(}3
zxwIeWv~O%=6hZ!k^baXH)^x&@6qiP>clv!GPK*R8U&;|Bls0^GJq>a;CtAHV>k|XY
zj=@-_42gUyeweu<@xRDa{DKP%n}6R!3JT5KWPYAKD~_TJGR%(3wma*H+-<|sl#$N3
zPkY1P;U3pnz%F+&N+<`R!gJFMS=1?@i-+bj9Sj(#tS$P7iJ!B)8E;gE0LHJ>wf5o|
znW3)@ie0y~HfCzx$OZdDGj*8D3$7mCrJ}~Gw8LTncHA1htneJkiHagSJzg{>5@hnV
zx@<JRIgyI&rqFJ$wkRWRb9uT};j-l{8Am0y<QGPSj;o4*{}qFOnSRb0R@Z$}!JHL6
zjk|8i_$%b`7oE=_0sOWEuSA+a<=gSPhaiSG43#IGStKcyJ6^E|*r@ggzwEz!d+fe6
zYT&tlT`}Iyd4s;s$%*_YqQaniLy`7JX56AtC*9HwkGCxgUj!rj(>{v^@|qI`akiB=
z$1>w*9*bN0Ils*xoF8S`Zf~B%@!SEn5_>!A{M4B<NBMz8Y|u~mhnL*#B!#E9f}!AC
z|KTlrXdgFwEW%=JNi^zk>il9MhPiLAfT^fEdm!chL?4hr?t@VHVWE*(+uC)6PHPnY
zL8;k7Y(ZeZT^Y<y<VmeF%O28Jj??JqH2#PEkP^ggAV{yD+NG(-GlNLOPeG~qx;(_Q
zUhgO8iQ0MLdvo<+Dn30}%0sEwLLQ%F3nfHDv#ulE|1=%lOql_Ru<Su4@n8-<`DFJ6
za%F$m;JBRfoX2B6P2MzEmI>cbLJH)u>JO$0)_$-8BiMfG{*Ls)j4k7tbEX~z|7q;N
z*!hbckk|7UV!9!Z&xwNB+WF7ECExkY_B;zA7*#|6G2_9*)T`Z3jm9uHna;{nnT-|?
zV8gL2OHDHai%M(yu8KNZ)$?W^EK{E@2PMk$8>x}?V%_q9usrgk?b613@)FEOQnoSv
zq4SDXE!>Pj1Q_kJtxZjiEC9(QSJ(Q@-B+7)wKN;Q%E`^k^MJdy2|^)wn!oeYxRpPV
zU8k}LrkfI;zHr+R<A_}By{2CJH22Wm;QU^g5H>dN@gpwION{dAO8J*n39ni^N|m%Q
zeU0TV7f>AN+MB|V0&6$&0CmGY#w$}N8fM5iz!c}Y&<VW<fb-8Do$BYH(|gramcj8Y
za=1z|2{ip~9GDZ=wj4yP4vA3~&i!Wk83AzyjEcC<63y7nmMlX>&8q<vqs%%iL`s+{
zrK4s`s`E=le+sIQ*2l*U@mf-B2*m)$u6yj-PfawTgC|u?ZBEIlg-7njYYBT_%hv{)
zO~P_8J<bjD<~q-k7Fkfaaz;xJ&;^6J4ZX)gZ*b0-L)^2<BZDlO+t<IAPpmT)PB1A2
zW<9^get(D`Q3_n%3JpqX=kft@8<ESBWS|870CN}|P}uI1Jp;_XH(H_SMPcYlg{MIK
z(K?MFy-g+8D!gORgt2hmwp1Z-fdeZ4P+$vhH0qIAsQBej>enLbVNe}if|<W|&Av5W
zXW|cYb<$&!U<ALQFUmkQeH|=1CXX4?DN=Ovryhb1t(;q2Y!GPS;cQ#EkiT9qepZ!~
zen)9jDlpBO`tL&+#Ld6+k~~;qH6VxAXp>Pv3q`%mO<(zr1M>TiGY0x*CiVRx@=1Gs
zP9GdMkG~1eW`4_Vof*H}>OvHD#8K<)T?7~jR=&JpoH&eyM59e#M^b1`E@J?xUESeB
z$E1Z|K-rc}{_J@mcXydDVfU->Q4o-*1dOa>m~c3+b;6z-07UjSjYqgz3*s$Y;SFr+
z&CCT-5-4X0owNSfG-M<ex)4>1g<7JXt1|c#_0V16sAs~{3sEkHBw@@TFfv5i(~FUb
z$_Zy1lCL`<500I@w08T}r>Z|VsE+G0!VJ?9-Ikv~%#Y)*Di~8Fbrt){-3XS7-M{Eh
z4*q$ypYGeilw)*)38x|JShC#n-+B=@PenDWLma@4;f$#KSb=|{Cyoz}%!dk1^KA-O
zQ{nC*;A?&2g~v$12Z>Wnd4cIm%G%kUC99O-Ma!g4aa1}#Wc1@&&ZL+yFs#RccbfwL
zI4+Os+y)a2)nVPqY}FJ>t_;^u45po0HjHHOTqPKMnDL%bGiy+-+4_o;8f{U&|KxqN
zHL8j!=AOS$VlFnvAoOAniC?j=3PQIz+)~6R*tJ;?DY?p0XUe>O)wzl$7@JJdXil;O
zDk|K(BIfC~p}dXLSkT7t{aQTjHn-4;=?NRQoCd^yW*g=sj=g%U(~Q4iPQh!gM>n2f
zDgSw`bVy=%i_i_dPmre}8yN@6`<vT+&!NAouj`5(f9ma*B_FOxM&eoYfZIS4!q-#=
z{oc;h7MBvICBU{Q%)EmQ9}xg-xw%=uwRPN~nJ_NdJg^=qhFF*<=p&5#&YJNofMFFI
zuXU^alRa!*CS#g5^o^p>^X4pA`c*kqhLp8m5oJHk-MUrWx=7@&-n!TB^WUCcvCUdF
zStMwF;}RJu9;AqS>zkOcew<AnWV`z(*w6c;4SfWUev82nA}tGcad=N>?UiW?uSE&R
z_T5AX3I@LRkj$HIQ)6ZDIZ+&}oF}CKW)K&&`I|o!&JzU0^%XWH6~MBo{gQk6kkN9@
z8OCMHfrH0OeTs(PI4MLvd*xqI4ME}-ZkH)7jV;&~tY3n{Bar1PU}>_76X7rZ`^x<W
z!H^bpRKG#qVOE;)JoMntsq{ArOt`^ONg3h8<|uW@x2vBD7q|mIdd;bP^p3f$v2#K+
zq3LeClKrijxsP@JnVLElI2A-U#+No`?Px<S<+NmkhGGSsRCdE^!^jxF`7el4<|XBh
z*i6TrVS4My1@kPK4jH%-(uel)kt`X@83BoM{22rgNZCE*6XBv!Sjr`-Kx?cLvsk@D
zN&@r8d>)+?D2$gaMc2ybrEfww>z|*M{UpTWRMv3;0W8tvyBMjoz?c~o``o!z2&~OF
z2_~j}no}}WA&72R^4-waeAhK3$b7Oo5M`+-c7uC<6t7yDTn*8^2T^k4{ONO4_?XF*
zGr*&P?ujQ9Y9|-hOFIDlhRMY6ib6D=d!S!(`~zirH0h9G2?tpZ+JDYkx6~QB_<hrg
zbGEQLK>B4n>#v=ZAps}7w>TrZdo6#O@l?_&E4wku2P@!jW-^puUqHFN*efV|j&96~
zi2DBUmOQSg1Ni}Pud)tgSLk3?cgYWlR>CO*a8qGW^EP;XmsTZCvi<<wplj8!?coZa
z%@Y%%Db9LCjdZyk*l7>uKhq-P+9NH#J5=WVf^Uf~1f~8!s@F3zGU|<?fRA=6cTE*>
z#Yn@sRqJ&rMNJFVA8Vtpq!fJlcf-m_R~8W$S&FZeB=S-5!Wcqj3P|?ZswYZT$Nr0F
z>7$hFqvLeWCOIbt+kiwNMWVDe<egvdp%fx3bS9}q)GzMuY!XcB^)Zp2J+^Z1H8m@1
z|7|kH+=Zj;^~vPegV%u1@~RdKVC^(4M|g3?o}KNYdk*Tl)Fj=C(Y^Av;2iUDwt?cn
z3b$hNdDG1=h<m+~C=uq1B{#7SoI&oD3mHWB(vX%Ny533Wa-1&rH%AJhtKwwOja3{?
zF!}JaRVda&RgrV&YQJcgLTB%|Tkw3$YO31n`b!!QWDurxf7E?@wemLHD;;!2>7)8v
zE_+zhpkkBt=`{MmDh&tBkr#5wld4044>zfUimJ{?B`UBCJwwKCMn}W_8Nqu)APigh
zlC-I=6Zi$cUmAQfs#;ijpUk{MZw~xD3884K&75kvLAsYksZDD%nZ8;<Ea}gN-OrV=
z82w(7+oedmZN3tN)ASSo!bI7{Lil;i<$jb_kT#i&(u{@N(GPvNrv>QglG6&pnAl6*
zK?o4&>b=booeEl2o=<<N60E*@twtySGZN&y_}%7q;_QMPyNWh?syDRo-=(FPUDJ5K
z<t|DZy5kJRRU$wyl?eZ1buSwaw?t0_$aa<=1){rxkh07`X{CS}>-L`&H=PZX^J9r_
z@-KOE)E?kz2X<zaMAhLcSm|Osx^E|tULM^^6fdy;5K{<0cEs*A)gTCFEeS_axwt&s
zahL+D{@Y5{Q(=cAx#wV5%%G&@$MV`G)(vIVHCF=kvpeSP$MOp1RH|r@WM)tPA}8y8
zF2yzWz|XT{%rp^?(uZ7m4O!SaMb_?XHdP3uc9w@n(sYLfR8b~et~1n=GsE$u4iMfS
zni2Q1Tt!TUQbSu`z6r)gFv}V7s41%Xo~|-<GS<v#GW9%7_)b)FnNlmC=1YtjYqB~e
zlHpK_@UH-0eZU!Id<F&C?xl1xCwQP)>qH;|*)`1dAg^Go86CvpGNk#o`efQG&+pdQ
zR_MI`oZu=MqbF@2`Jt!i{MYt<uZ2TG;;aCJV&<dE&mAPrAQr~8wz`!>WVCtcYW^3B
za%WYJ%c@L+SGFD5hZJf%$b3(ZdVR9xKbL4$oRL$@Z%Qig@}_}J;qrLi<YdwC52|pt
zKAIXQqg^w~0WZUKwBj?}MHDNDytnt+Q?l5*m3QI4?o9)XwVbqfOAaNP;t}{<A#%DX
zYGm6ZCf*ochC-``buMNn{GcNRcM%Zy2A?0M#islA56CEuYxMaE?fIP4;Jj1@#~B#-
z>LA6GI(^(I!%L%lB`0mGV5I|MWMqS9(rv1{EtfA*TnjF8U$b>lbdbkow_MxYz+WLT
z(-CO+J5Rzp8K+sf$ux1ISuDcalu~|%!qQ1B0P%mkKRGMNJ@LqEtTd1A)@=z0>+RQM
zoZ!u)RZ=julQ%|kS(YPi%3@XncNGP;vPl-cGumM_8E0Sf!YKO{uZ7Xy^&0vI$tFaj
zJFZaHlX>AJ*5oV(12ey<)2Aibt2CVv*8RD)B&+WqY9syPNlDrC1>OVuOfy8vad}$z
zyKyXW;LwCCTK9=irY{#mEjBhrxs*jEe4QB==MJUid*x9$jC%IpA`-9g%*O=Rw=v#L
z0)~Z28!~scZHHLVdb0l2;1}K#i5hR5O6mWW++Az)0E<|_v^tmD0-{8^0^&t88miKt
z`ITipr@iFinFRl<fInV(wYg1Z<t^MNJT<Az&ze99x3U5UGYPTQS)-(c?_bga`&sYZ
z%#O2ePL&mV(<-Frti?21+o9=F5IVzEG1Un({)v>sgZ-(WOjV8d@!cK>-FkL6C8LNr
z6|-d0Ih$BjC3GomyukN{SQJfp&Kwa}!7)TsSUG~X-FnU}*hOqXvWjira4<mW3q?Jv
zP^Y}|lqb?}NHt`MOog1CBPXTiC|#KyWYTXq*Rkan5}!N(QxK_1IW%-##is(oB$I=3
z0u7)ze64U(EOyiP017m#@V1{`pe;7oUwN_3sjVh=QBy?74f5&O`63iz0~e|u-aD8T
z@_#%&a&;IdJ+As%YEe7eM`zH-e;u$aNKV47IUP!RKO=t%+Vfc88c4F4L^L&I4aC^+
zrR}!TzGUfKdfhKphu90ugfBzmCh+K{RE^gZEv2f}dE2(}Wsf8>|B>Zk9x_gIuX}V%
z9yH|Wel(XErWSlyJME%0xqW}DshC-QF(bMusP9Ih;JiJcQLpn7mpLLKioahGmg?<@
z@6_|bt2gxHAx&e;QoZlO4iBde<Chk~ky*npCuB<v41`+KzU%6;>Jlx7oiFu01mP(H
z0-h!Qoi;56FN)&6<z<`R(aCWh{@is&8jD4+tKmZhGbTJz^-4?c$C~K91I=6{@HboI
z9(_AufZ!cx3Hg6*lISJK<kU-gzu^$jl!t_(p7kBFrtGl7%`tH4Zzf3P8cN82#n7#|
z3^#7b5=+zf>8Y0nUfu?=LbdO<!(NgV_9Z!gQsi<}hRcBrvv|5~8iu=SYLXy`N2{)-
zY3$&>WwL~xHh<FV+wQ+5sImSI1m$9wl`5bruohP8I^|w{sDH)f6e5~-HIHNG+nM27
zyyuh@W9j!;ku1;O6;$$6vhBFq;_7!XeIA8M`>$HukHc4Tf`U7ygG9CNt)*s*^HU>^
zwS?#zyF6#mCq?6mNzVE7S62&Ban;i_?&M-I(s@aiHJ`=B0eP+cUZ;TZ1S}-B$&yni
zKIF_@ruk|ivwM6{aOc)!QVx%jp=#_ZVJecxWKa0*N%c)QdpP7p9Uap~&EMvbC*9{i
z_E4{RqFV6^A@*7A?}0?G)82KuKS0{|<oyViW_}(Ej^PhduFssF-Dt^NS-#%h^v}Sy
zMCi(T<gFi<#1qV84Kj2G#3>>7*CNIx-s`whBtbV120=6_A3dHUemzGvwuV!LmA(>Q
zjKrnLef_kq0)n3%^Z*cz@<&Ws<ZP(WOBiGV{Ept}dx@NW#&?i$SWge>gbYr9k&!<^
z>d!0H)b(bGs1DcQ7tiqQ^A((S4{$opmQ7|1J-n&(@2@!yQ`A=0Cj!87>P=oDcK)6e
zT^qie2MS$>>jpC~@&&i@i|}T5a$dKn)3aoW3gzI~DDe!d(*D|)q_HCMk*aY?d|pY7
z@|F~tdB9fcXJ`P2CPz5C*&Rx&`8fGkul$eLJCdtmeu)%NXmXwOw74ZYmg#ND43P@P
zMz!G%W{vcrc+RP4ap#ROwDz_|#D_Kohm^bReYf}`%TY~)U+sM*PJ1RK8jq|>*~uZ_
zf&S)$7}dT@sIJp*FXJcM8lD=KT0oaaNH0}qJC#m`TneXYPo-}ZX1sLv7SGEI-7sxA
z2q0&{;tE606~DExYRuRPhG^7=hJNbN8Dt-Vjo%uaTq{$EyOsAzFE>KYK(l_R74q-3
z_wht+*ktc_f&s>m<_K4L`?A40^1o{j_<Jst4mRGjcPTHfU~8?AV=`gUN5PYB<5nDc
z5`$7C!SuPkO}MosX`EmEW?H-!mzOl~k>(ZV&}HXe-1!76<-CC5#tu~e`#1?Q)iuPC
zv`>EjnfR!7jI@??H7UFE5#k+0Yff7Oc1|xW5>Ul@;gl$}cJkVbPo1zr;u2H!cznA%
z#t)M>9qsRSEsTeH&lx~gQ!gc~l9LtV+f+8mZp%whRmNlKxf)S_WpY{y`8JN+HTdJ~
zio|L*6q?rYD%6ebSA*gpj2mKGpY4_386YMO{BLL|;^^Joe+i`VrhR!4%PSSm%SDZ#
ze6v>k?(jZERUXBS6=hB}-OC)k&#s<5y?_0?oq#ZzFUY|l6Pv1J(3Du+*>SC@XJRPM
ztJJthF}%p;%a*rug}hI1bRoWvW#>f9P%*2FiE7XXD)6>I(a-*Zea0c9AM<VFvE$1_
zKXZfFf=$2*vm)j!h&BAQi+&@itZmjj$iU}e6$s2zV0ARyZ~96!lCWS=mJ6<FB(}q|
zHD<)}<Ilj1H!;YSJ^Xb8F{x561d5lbYoprEJP)i(nj8pgzP370Mb|>T^EuHU*JC-M
zrdsk__I!Trh|YGa2!?oW&M6bG>wQgnHN&S{cWUx{xwI@RD-{}A6T2*qg66wzP{J!~
z_Fl^l6iU&fOC<?;ELRek9eM72+{`dc{p0qw4n(u;e~$BD9Sptu@coav2<xQ7P|JhA
zb0NK)Lz*!nSrdu>I?E$<fzK_Af;o1p72zI+k`{(;C)l7ha>KY%w_h|bQ~GfKqyVN{
zCHBW<{z0`9!JPA+0L_0a($O%}S;hg^dk8QnV0qoY$03D_Gy4($FtyyS@@(^%2#eR%
zd&6}*{`utlZ<fj!tW|D!?k!9|EwJI$NX~thn|T@?W1yK3k$a~v{{bG-YehHz%&O7u
zExQdwF~(VzZ}Y0-3K`EniA0u<d^apdMlQBh-q53F!{X^+K)w;E7qwDcski;$e_~XD
zoLDf#Lhd#rnJ1CN?xjKH4wrC(S$ULOY5n<jdblk|=?&lTP&7<W?<!W`M#vHM9b~ZA
zcR<EbPCR{dv`U0Q&<r}ylcmr8k|CU>@LtY+_$(B$v2T&uY&77W3hI;U%qi8CfBSm&
zi1gW4`Ia12TlDUwSDf%Q_7GZrZ8D`x+`@GuXI`U)ploLRo1%p)yT%L;+5)m^T9>sy
z`s*(ddYiJ9+$I;|yU|rMP?D}e4j^m}6a5`@@8$1AysTpb+~&zS`sY5EmX1T_2uTc$
ze$yn32U@B%%-BmUa2DJXyN+fsxDxm<tz;WH+<g--_ajdj1>9M5+zq(s2R_>Gk8<(A
zSr^gczX|z+F{bm4;aS+-dZ5{gL>gNV*_M#?A_ZTq%x0=QD8@1j|AN3M3rm#-q|Gn!
zc)>xCoGe7V@Ak0x0gJ`Qplkv?d;pQ6=6S#9@6A;Jz<~TYQ9zaQcEg4Uf`IkTKpy-O
zKPOh7z8JUHq^1x*ET?z_9e*nUf|%=y#Bv~}3sQ!vIJrn>OEl{x>|`QmpR-m@&1aE=
z!N!l&?MmnF8c{dQeiXFHwvb1MhxSdoW0zk#`&|t|$Md0oKM@ZSk7~J4xQ7TLvM=`C
zZ#B04H8SVy2JH+@_%db-|AY6=%AUm5BNyUL&>b{+Ni?4e*wI+19enit<~F)v6$_Ng
z-O7*-4O}I{huOCuIT*mPaXNkxk(F#14~Sho%ZB0&tP}^#Ayb(}=&VT$Mp!@`S0V?E
z>>KYU0`#PM2LLVstfZ%EXkU?C7#JosJ+5cl-PXXY{gMuon|wz?QfduzFEN}drVr)j
zmwm6((?Ol0d$?QNjfPN*t2{s2=a77Rf;<wP)=fF6#U@dLbtrhDRBJ;#&fGr2TyU7z
z3`wM=IJ31hd;l0LK!lIomdHfVyKK&=r&ClgU5Up}%b|_=J`*?D)fm_6T;G6<WFFZw
zuG;`hTM1u05SLi62P)GY__V0#F!@FCl&yO=#M)%Z&`WwA6E&k%qKThZgDdK7sd`bD
zSUrx1<yHebk4PHyL$3{YAi;3{v|uk1>lR$HfDS0k2%{G#!poyN0OgllIvDN01mEo#
z5~4v~EF?uCUmT*y<ikW^_H?O-<*dvPn$DUF(HQR<lgektGH{FxGw;_W%pTG?<^MZR
zlK}L#M`(V1>XqhI5#SD$AP9pv!#ULB?-;-1|9+_a!rfJsD^IqFs!jMQtKzf5kNg#(
zh)M=TRk$vv6vX~a=fw$LUk9qGD_B9DgY)DR<9R?~!vqEbNc_K@5hAhb8FbdkPu?cu
ztLQu%zU%AUf!cCkvprdpg9x=m8|XuAzKa^*8e3ST$G;yb^n4J!A?U;JTKoyS3pAD)
z$eK#O=BD(<yLJul-P4XW2AkKAhPs9Y$c^!Suih80YS|-+9d2Xxj?D%9vLYM{b|M|k
z8S#1@_1lZJ>*`JQ&(3;{6VDqXG~)=m>QzwR9dWv`*aVB1{=;eV33C3~*ZF4vwV}*n
zsu)d-LI$EcZb9q%vzt1us@^Q-1VCyA>r)_kpqdUeC5Xz;UHdVq{j&rfsX`(LqwX1@
zl6`9S5j;4i5x;poC+N}%Zoul}$E!TnsUgoMS_XYmvo&hOm?>2&gqRDtG>Gs?SVkfZ
zIshRBQyx2WBjLqxkldq1fG(_3XiNah_cb-=1k$UK#^rA>(x3+3rqu2Xp=j^Lhj{7r
zm86vkaz7HhI;uN3ve5=AqXNf9>#|PSP#V~XF@CP&U2|hNR3z>4n6KW8ATc-kdp#_y
zBg%HI6%QHH#ai|M>b!p}!eO7)YjhZ8>%f26SR#w(Tz$+PA!VY5AMHCNk~g|V7ku(u
z%>X8W%Gzpw({6uuNnU+Bwlei@+g0_(K5<%f{Y)Pmk9ga1WN<Q68N)9pJWuHkJ$faa
z^W<ot<~R#~A4D4<){#r?VJeYow)<Y6_Qiv(hki{nxMiam{<VxtSlXxWxqc4Ymf?gY
z3||d=No%~WXzuqI`3W9tkdBf_Paw+mKdd+cP8A?sSDv&N1d%`Yr}R#RAPPh3gN%u@
z1aFSvI`vfx^-NnnsCe^)!R4JK7MLI%(@0Lx;MmYnvKZ^lYFTR2IoECRXey{R6CO8D
z|CFV{ZawT;p7_atyR*_<Jw2IYAxO??c>c@wcIM&@$pyU}cJiTJ{kjag!+sJuG3jhf
z_a12{mgu;6D(Sp0<Nu&BanC6uJOkp1x|75_hG%y*O(dKIl_8PYg!>D?Ta7H`4@J-3
z_rX9rT&;2C_GJ`_HXxn}y|*_V9#O>UL14KWj^tI4XVfcAdKE5iigiQ#xv5_v9`mqC
z#AYkoMoyKqWP9dOJ|K{JpAu42QKRrX*j3*5(*xm9<|e6ICzTJ=Ay9M<WH#WZz{=?Q
z>^fu*Crywo5__w$zlv-cg0K@*=^>$@AAJbn+38emUGseRSU)l5tU*R$cPz)+JCI5I
zD@t6|N4P+SP&4!%$JTG$7*yUB^!pb*eJ7~wxD)Hvzmh@(Vh70souKZJJYUZB%y%mS
z!)K`m2$_aMfsv=&GdVquD@hdX^P$~*eS5=GT<SqYjd`J|;yg+o+efQEEcFUnUoh>J
z))Pv47b4xdcdK~;U<m>*vxgOF6H&uI8wX%m=CZO#M0yj;F1puF7=?-#l)hX-sh^2G
zt$!UC*k6Vwbnl@Fef1n}#3xERw+-qy7h<!+R~b)x-LgdOTAD<IBFLv|T7(0Jxgq}a
zJ@VTvod=D9eF#&jO}#4Nr}7zApsHI{`jDXHlUGChW3a0N`<n6F!g4Yn0v*GSH}S!d
zf?)#Z(`h8CI}^l?rUqyRc7o@ZQqu=U2&gBS=|{(z_>rsR?e&A0R9>LCDL|j$8E$ad
zl6+2p9slX&Sj+d_Wk8^CCVk@%^;N>${hHk}d#KET-%>6=GtL=$_o5HR@3zk%-331X
zIJjI*efm?VeTYTtsqR_w;pDLH;Om=KxBQMSongiBvvGG{r9Zv@H8#02B(4>+x!-|;
zdg5M@$rH=x+ucM<Pd!m-;WXNQGXDWa09tYN=}S$EM4ViFhpXtkF(*(NBS$p@83H92
z`~RY)qUha8dTeVRnGD#kRLI01Mug<_z|RZFSU-sI8z1svWFm5q{U&tS6?!ScqK`Jp
z%qM&EGF!mkVg7RS*$5tsur2&DQ?Kw@vkLG=>8x4(XdyR|N1@`$rctfb{b5+qziZE&
zDvCFU_)oME2-bQK!-nkuN7BsWCM8+LJq$M9L`TdTXCU#PFkM&yaUXe8p7C}P5uCmi
zs|is<1m@)iyxqw%vnIg1#7D)1okE<labB{yWFkD9V`Bg$onaFX5sm{h2_z4|X|c(m
z6coej!Co_%&5ff0$gXM_99})PS2aB3YRxV(caEXYymQ7lw>RM}m7{H!?amh19sL5h
z9BTqizovdE>&CcSAFMc*f_yr$nN3~~QQ9c}$SD}N;aA`5FGq3>T)uRLK1qf9Z(;UA
zPh>lPV)(cG8^<KU%y$>rHue=w2o9H}4rjUg{{KvMRuBqi?Bf`D{np=DS1;^dLA^t|
z$q*}6{+0?eU*nCi4<GRC(;cjtaM+>eAFO@?^7`_T+$p-TnZ=@vKsII$Pa3Od=wu5R
zgdEkWE?AIP4yGQjX_m}~&0qoQc<+yQPnLP)M2%TvSa@8kJg8-v-Zo=*1~PMQ5Im%=
z{V-aq9keu%Ghj4`eO+4nFA6Ux05WiDU|J2vQqYd;K3FpfemS<23GAd0cc{9B5^FNz
zbm`dil6+2L@Zj_GLIVQZ;iDgQiDp$M>nYUL)4dYSS~ryz19LasLPy*j`e@q(Msv%q
zy4&T-9C#X<UV9C_n|>!cX3&@G!65JC$Wd=ZKFh?oQf^$@Byv1yAO%-`3Ekl=kx@-)
zZU6D1{qV{g^#<+EmES|IySHW2)zf*{pY66Jhcw7)N}!VBdKh6xSiHc5Be7%t;f(@u
zF*x+eCy#Vzu{AQ7JcvG6Qi?%XLzv!^_WH>tM}GxPTEr;~cd*Zag?JQzS8_NWBePF?
zt$20K<{KN_luIM=c8ll^{OxN=BAUh>x2lhV_+jF?yL55^prus$0mpDD&SBB?&zz#i
zuA|l>)?_}FSeBnm@9xYsP^;Y=xlmly*_e9)1~)552r>=84#?z_Z#v@)=HN@A;L|)6
zhjsAxU;7*;dmc0iZv0_Gyh60s<o;O<fohKbwuMoOZM~S;s<F=cX_Adw0l|;S_5c7k
zf4~^A&qU&xTSHwtxcF*$IH2WJi6leiu-vSpOc%Pk;F>QH)+r2%5C`3=a1QzREmX`4
zou{B5bxbdYx>r<v!fnE7l>crl^H{`CB;2O4jfKL7KwNR|9^rL&xP8r7ZFfi%AUOpJ
z@bdyUH}Y__M>XxlM^sV5h9>)K7cy+IUe51#V`yr_x*M4o*2}CX`_50&*W#(Pej0YI
z_*>h}lvHE?rpX()SKfn@xrw8<rMgNuKe0cGt>oCk8~|$C0(N9(Vae+Q9<-iJLeSNa
zHm{L7O)=phiWg|*<vrh<cVpVcNwQZ8qs?|ZWtwV=Og#?6O^-$o)~%{#qts9=N{j!F
zQdHInp%=d0-{lVp?*qH>i2PDmcRbt>*a;h*;ai)F-WB3VMcxii`yo)~!adqf==7oh
z`K%uo*z+&`whjk+_idt{*>|Eij7lU6Zi)1yVYeXkswEqp5979yF5I90<H(D_Q%JrE
zF3H{DP|%;SWF|<VGv5~>Xq(aJcOfUr{|vaL&#}PSt?d@q`2xqNy`leQ4F|EyZC@Ln
zp-O10b1L=*tsU!3(&M04^5gdJ)3#J3_e`GKpN!sh?Qp$rEbpjgei++M6k?lHedo?y
zd+S}~jP%_7v=G${3^fLK8T&<yBK%WrxjWw5<^ZKu+kB8bmS-k|)nx;P?GIdR%in9x
z>kG&9qclCAkpyG8^|Jf~e3mvU3HhndE>{;hQ7lPmMdFSpJ(|hMDO5_?qvWUQ0HnJ>
zc7UPL*S5)q3T-@xFB245(HQih2N|z??n_Fh)*1;DU&7@0{y-U@|CL*Lz>^>iLTvHK
z{#{Fy<Y-xw(;Z-&kLbWAaGeTzl~+v01lq~6>CbUbw(+hhP=IP*cJH&_-JbU@KU(WJ
z8CyhQ^j&A8O}})NL8kjE@qKW~AmyF(DVogIG1m(BNAFPI5n8Vd3#+s2ZL5qdKa!!h
z5^WN8`=Pzx28TPdZ>R0&aV)-I!mObC9Hq)}NK=*M%7~(wOlZ~)&%%vlcqMHdLYZoT
z58vTCQdrvV+azDI!@w2k;LD7cC0jfT=N8zAE9j}|&)@Ap2KE|0aXjsC%LkGfuSopE
z-d7PbzpGYS?#<U4MAG_T{(V+=@a=k>l-=aTcD{{Ew^u1{%Z}|v11P1U?ySwP`JA}&
z+m2tJxB~asl@QCZ964g<7JGVtycMipM^MlYEc1r?basnOluXX9St8#`B3tqc0gqMo
z>6LEy9>5d2kUb)khh>KFGh~@|hZ0rE#ddeWSR#wP9n}JubMdyWM-WN2SdJ)Bnc13B
zNP8=VlA8Tgu%3Z898Xd%K?CB9sokn&+(N@&&X|JqIq^0s9iU(=igX)_c2lookNeTb
zcUA|bIDDoB&R5@{PLUnRt#bn{nbmA@8jtrAgdXw4TDlL;EsJ7R*}wy(KRcSB$>B6-
z=!5U3$tMg4jG%h+UM|%4)F-SU=o**iUAwUR#}0Eh$pfj3#w1ZW8r5Uo*>CAtjcMkf
zn=Kl@Qo_|^HQ55++@{p_pxzifNcB#3OUKer8Dv!FxngX!tnqMLo@QkRLatR*FE69n
zC@eo|yI*|mIjxQqsD6vNj)5v|G6fP!83U<ORR<t#r|LV-V*TVbQ|TL1&}2alOopEG
zw+8Arx5iswW%H(iOCt{Nv!Q}{jE)hyd@Ev%A#48Qj1Qy>$M=0f?!5f;Dh?a*d|LpK
z3U-(QgH&xFnEEC2T3u@L6^SOT-qDg>V&xlN*?PDCwvB4sU-t@+`egsms>Uf210Edl
zWlr^Cbx#@s=V#4yxsC0108z3C9)>WV4{uz=mnfYdH+6e_oxu<?F^!QE41f}}=}LW5
z4V^4`3nlga5Gk-8c)jh>Dq@MXt=8%{d30A7M0@!Ws)0tF5Gdky>{?|uo`0$agj3W6
zk+Ra4UUY?Qy_QQZZR)_GJpR+CgdWhYQ}mSE{~-^;bUU2w5aKRTZesPg8_0PpiX}!5
zZe=_3upQgj+n3#w$Qdr_8-Vg^?@21=a?e^@wT8AJEB$<>msu`FGOB?|&n?aDflWjb
zL7TM$-J*jLKxeK2wou5!yU;wm7QJv4+32;Ec9r-HDJVUbKDf3gum3YS$$U5TED4yB
z*liqX^WorHCL76ucdzd4QYY(NDAw9VoxS7~<<tQ*iK(TH;py*uKy}9hE4^K`Qvw1`
z$4Ey^pI~eX)%^F0Tkg8llnuTwiweRoQ{=(GBc9X-Tpk72S7<PXT`A+n*TNP&MnIlq
z^PPh1K+%O83@lHO=k7t|u1zvZw?!QUz)p01Tm;?%qw+J#4DI?#$Uy!V9sk3D3X3G}
zx_eWuRH=Ke!kcAWB=wGkqU=OjN3?VV(iL5^R*)T(5z}|Y@PWhMBrHQN!r6r8pIJBI
z!6<Fkd*h3EWKaXLDFm6YXOCI1>nJQkpEte0dT7T15Tk{7AmSQZ?2yBvtePP(J2~w#
za)?Y60@#RjA(wO*{{ixZ3|xM40-3}W4eSX7^MxQK*tE+8Cdf(kr#R4Pc|B^0)Su?2
zp!~ZL?_(gBn%3ej7Cxo*YxJ*d$(re(kAJm0#6_s@PV_#`vz~5@XIreN;j|m@GWJi<
z_vL!3%BspHz%?j;w%c*t^BCiX98yu@z*QQegY99251Es&3Z9Z56V0`xf=RN&<yx+F
zCJLK{hpK{aJygSWkOXUhB%4%PgQyA?-E4NKWX9eMPz1OPNH<Zt`eJn7f77iA<it><
zfuX5)iaexIu+i@29_kr~(ecKka%aKD?kEj)C0s>4a$@E6$GlcBFuZ7TY+@Z|Pt6B|
z;fca!F@RIvqrvbQdtl&v)oAu>Q6=ekKZ)3s1((43LLJdNELj`xww-qP(I50U`%@+8
zJ%BBGawE#-S5ZC-BtIlixR<|?D(w6NX)5QOoc+`<hP(iLPbBFanIu!tzF8v1<nlmT
z3-uhROIzknl4t;I|JH7w#gC{Ac?Y&53F1YB`uuqPk}UEFfYqUQ-%T`3!7o1-5%`ZT
z05-B$CKVQ}xX4n@!K0kpRYkDgB*#RZo5%(G_>P7lxr6s}0GP3*0>-d#>sWqCeM~Qt
z74_8~sLUb#O%OL|q<>U~^b*O0JaNa@)n&!gltbJfUiu$9Kh1xSj2Evr`%1DzKCF;L
zqe*6a+vvS4^x|7!Kw8EgHL{0vJoP@k?#W<Pr(n3Xt|o~7xPW*3a@vF4?Fka0je7A{
z)L9UAKyM^am%@*5iSDqC^<t^k5;t5cT$3-cUe^?P7k&3_QoSE}o^2D8I+YC;eia?S
zDHKcN45g=Ni_UFsHrl*!Cy1uX-#lW(+@((Ot-89yc91&t>C0!YoHFqf=3-Qo&GHmF
z{S2BT=`(H@KAMzSUH;KJD1vsUOzx!^mC<M`O~kuj%v$7?`a^qw1awoqr!oN;93ZiD
z3(Yi(_2?!SvHAyJd2?TfDt`%u0~~;9lBHc|_y1Tr?{GHX_kRaL?8K-|?3P+JTYJ=~
z*%GTZMUA3XY6Xp5wc6UNS|u^7_9mq$I*eAUh}EJ9RY98kp7-bb%OA;c<j9eEKY8x^
zy06!HHntTMV^0Gd)#LNp*4#tx7JE#$6~C4uGghy%eYnJ;{DF@Eqq;_~^M_R2TWZ;c
z80ow?{aTo>_!5a6(W~1hJ?9xRD#aRuR@AKe?_)l=dP)Jp<%0w{ai~Yx7lGvas@2QU
zS^9J!9?oS<yU-Hlp^#RY4$yoqbOelzJNEU<2zy>O{*vWAttbbvog~JTsu!v>Z;B#R
zS%<~L%y%e%`OAik-K-9hZwk_q`Cija79E>9Bkb<^T`iGk8}X?dtYv!d$#r&xHEpls
z%<xwho$!G{^H{Z};<bYAruBC>`ftp4Nn;NleX09Z(_N=7I{*5#tL`8<0D;-=ywQDR
zHSB6WJ08n9{*c9gmig1NO5G=$&R4KRu9{=*AXc()7C+plkiKF3qDk;~B`(}2V2cm=
z<%ypHB}rgw)Zi7m%>6XLX;pgstoE_foW<L@Xbiep&lqpDwO@ibRcV5{w3PtJmC={-
z8xvZg!0}eL4qG)>Q1hLcIX$Hi%gx@p8wGQBs_!HZ$c`^BtZKc>A2@DGir%j3EKf=F
zov4UlyXOT;JX^i7U=w<+?t$}i`C1aRWAw926q!oxRNV^6_aO-^w?Sgtskvf@O7U9s
zhpS6Q@M@w+K-s7vZt1o>$M_V&vD3@~a3GhpHTa(f++N4*pm#JezKVoagZWyCOvT!4
zPTQL?CB|UNiCTKft4XK&o0o(Et$e_EM%$^x(tsKQQZ{!OVGV?BG$!8y*pjz_{)?E$
zyaiDI&!<?RC+sxB(TZpQP+0Hd&0JzH*x%gOxX>{`gRB-Oov$?BQ)Sv=bz^jzi<Lni
zH`sn%U#`dm2#c9VdN)xL_UW+(Q<LJC!^I1np|)SJbWVl3cFa}Ch2xa1kZ{UD11}?j
zCHgi4jl!*e@uevRL<5D)z3^&FEaK3~4Yz=p=LjJ^p{y;PATLUG#4Vc<b=zD*ugzl*
zo&|0L6kw-@i?$U2<TD?Qm6XPioI@XMHx*;lCy;61udhPPim|13H5wCw))KsGTSS?^
zY`1<<>VKi|now8xq7n*-r7yho$Go`_D^f8tGpvQMZ!qNuy%rj(Q{ps?gr6-?C_02b
zyP7db9h&Zzqj#KU6S?Je*XLJc$yK3<rV?ek(Sacr51|Mlu3>~F7J%>OC%M=ohEhUw
zWA8r{r2HcwITcD0=(H&IKPY7WP&qlDYfT*W`lP3?lAS*Q8uwrMfTyY<z;`3H@6F6;
z(6`MRKa>2XBvy9ywGI%Am%~TgX}$ku5(OOHB(vGzyRrR(KVxSdLw1;M%+82l6Wk@%
z#0Q2fkv`wNFueoYIwC_WG8+)K@?bHkm45TJl<Y=T<Uc~}kM6AWWj4DWP`glpJYx6P
z#2E42$|S`l0$@$6xFAADL`LM7jOZBmft-3tfQ$VC<K`T&igH0#bk6~<2n@ywAS6@3
zXPEX@Q?xXN6f+>tGQo49?fMn3gjZw@Ka=q|yJ%#Y8#iYDb;y{mmjRY>PR^{GTZP$R
zC%wVWN6L5H#p-{QS!be;iI8ek=3k(>sud7Q$>(8-;zMF1FB3*pQT^JlAn+c@eXirW
z?hzff?Jx1JH-9Z}cMoTu>;s*e4hG5o-CJgKFh#!#lA`k9YivnI?b&NejF-IIiH#_0
z$mBSNWQ4^4EZsI2+7M7`(^)@-tb<!`FMECbmn#%SS|$hrV2ETD7~%a|X>+W>_)xeX
z=)lUllGDJ&$7kiDF?3Xz(U{uTgyV{D>(hQATf78WzzCRYQq&4cNP_f#1VbR-@FB<9
zQNK3{<xAw<Gacw%k<|h>;2ZI?c5QPIsp2`wWcJp;Rj|fD0s(~D|D7BvDo%9BGY|V8
zMAu8MWY#JDcN|9Q2sT6jFei!89b8h$O5efX>WRUGo4E5o+L#wSQdPgsS2CSedDBU@
z(BLFDC8iQKhWR&}(AMMNXB}sA_ut0dziqkP<nU4+PaPH?j?FnsU;oK1Pn3AgA$&u#
zP;Z!^_Y~ZxlpY@}uXY;0EE_@K+QtH8+gpkTL`y8|V*??V<p1cn{o4aD#<V%&yF?-A
zX>b?Y|K4ycrJ{nI?C($nP<%9(vn4G@dp7H?ZLZI^c24`Un;Sb|IgmM~7(4-9P*W6h
zMi9H}#QQ!~IR6_R%i`dmox+Gs)VrtY%#)$;n!m+N*m!JK7YD8ZnUAnTyI<doml_W&
zU(TEl&R?}ULXo+KZ{FLLFDW1`16Ly$n)ZC{lT(ie0k?OJ#l_xUjT(2t(c4l7e=naM
zP%G#lhhNwGE4)4zsx1;PlRxJtivDh{AWQ=G!@Wn2+(J^pWj0|90~GnQhYZ2pu!9tv
z?%`<QC_cEE&8*AxVJ9TQ&skgJVq+|)!R==Smswt4dGqbH3^R!xId7V`Qr-C@<~d;|
zNnkWpaU=7v0y2tsvnA$veWlPoz`U@!Q8VKvYvWdcaFbP80IRrSlNIvsn{vfO9wQ=z
zQb^iuCm50hfQ{b%A>M~LG^@_Mhre^A&-q_H^}>Ab7r(3eI!Sz(9roiPVO6oP%{*SE
z$#Dk2XvH;k&2}9vy-&%G+9?^s92i{5IC?sF<-l}!fb~m}VLxCVC=X@D&?a7~uwJ&S
z60hZki||b@p94Ee_X8@&H{mq$V@!L0=N5uI^Af7`LPD;LYuwviyZ&7y_2Ko#IeS@Z
z(V>RF)3=W5U&%DEtVWoE(YZHyBr46RZhTU-nFU{(W|h+`6O>kc(el)_Z~60Oa?7(f
zHT3zrAVU4-)hw7-c96Hj1j>IG$t#|po5=Gvox13gIrS2JvsiV)BYlb{kUx#0P9-~s
zU)E_U)AZr_5$M)>vxV-)M6*pLKCHEy{5nSMb6BKTl%)R~PtYCWYD9_uPJ4@~u61SP
z9;U~s$8S5tX(Rfu=%qES*>fz_2z%!0FAcBK2Of{`vSW7NbI~VLn_8{qn$qFU;kx?%
z^dgYphLoDd=K-JdzF{})B4w_Opm*{*=EpR)-s}X-e|lH@1h+XJvBSP|fkE-#er#y@
zUALF_W%~y(s&nj_Tv1<d+ZV7&&%QKra_#9o{8%6i0*WSjCBvOw6tYOHB7lC>qz6$`
zzs&oh4!VA9Mw0+;yz3VR_DXiz392c%S78<Q3u!<b?fFk04b}}Yl*k(yf<7}tvRE}*
z`qK$h@H)Ux^WTM-OrZG<POAHSqbxD~8bOHT`@K7|oZh-sGH=CiEsqeqJU|K3|1!aS
zv#tF!D2>jFXK$i954V8u4rFSE6;`6m4Lk`>dX;ZsNIq)m8yXB=b6tYRftfC&)(B13
zV_%n*01-@zrqzEhMpk=M7Krp3)^S<|r3hGa$QSbOGy6N$-JvJq|0?eHahy=Xevx_X
zRx1cH$H7T57KZn8JwRg=%7Foe=q}3G-H2_c`a3u4g?4`h%$_v29o624Qqg$XlFYJV
zDw3oX9AB0ed!)jER}%MTvaosh*$5UYoFwsJW^qmYqr?OIuD_>0E43_*b^Hf~x~w9Z
zY9Dq_$ZK(ZO;0LpHDhIhXTKxm2FZ5u7nymU7;m!Zv~rJP{x+mJ>o+l@fcHPFLoA1)
z*Id7N-6@F`tIoEOeKYLqM)n_|P|_$<2nzQi|F9YaPzR-WzfJzdz7+W<kSKA!s{tb#
zib+bLsnwg<JCkvjTXfL9eDB+A%EGz<N?EK}g)2-2q0GiEDhBb;1Pv~`x-IV)P#`5S
z_^SX7vk?WG8It5pXs)$ZSragfgb0ClspSVFUazx0B`SCQ`)A4BN?H4JHp<<qCHz@w
zUtH$EZhUb5bMaa#yZlwcM|xalwNVOh&R4yFB40U@h5gJX?jz}JX4Rb9xKVqXLcT~e
z#%%%IZF%(d9mK--B2rHQQP)!ClLe>zn@I5=ej(X_Kr%eSI)zbkh`Dc0)^MkL{yCUo
zjdRw9n9G*({&meGlk{e^p(wCO@b5#|irDQk@W`h$6Xt*$cf-M{d{vt~wH|f1x@15o
z1}HC|V(Q^WAD3owpkRh_%z1-H$H-X0FarK2<~ywu)66XNP0V`{7vs~WFl{E8>w}dw
z;yp9g)4Mz%9}b`9Kb2}wN1%z!DBdJda{h@~?LL263_|_AOVhKmb?%HH{cGBnaL8=v
z$&$S!M7|__ooLwRwxsbx6o8ZEeLFPCGZ|+WmF6uO<70sAK}&#<n6{lHrF+No4-+Vr
zjN_^CfF@pRdVKH?{lJd7qft1UnQxT+&4OT;71wL)pLy>sb{l7i%NriUHV=&^)AAW#
zs}xm$`N~yN*686P15IPuca+XoRZ;wDr(T~Zc+5D!JJY@aM8f^$OArUj`kwbaaMCmH
zfXT(Fbe`|qaTiY)PX)to>KWq~A4#oTRZqKt@e9-aK$5yKkAZA+Hx1|M-Mwr)^vFnV
z%)aKUw0Ho{@+s72A)*1#(tylKz8Rg6g}E{~`&rvq+YKrQxh>;UEb`;^Tf(ge5qFl3
zyc}c2(uRek(mC*E;%~Bmk$DesHKN;YcU8JyEh`pRDd#ivFVv01xsz}WyRev=!g#Tz
z`t0m{WFkN>Y`bBm7(0VkC+i?woJvTh-YKtuWocepdWtqRwLAx(l3i<G+9$xeakeTX
zl~KuZ^b^=hdMI^MEZ__sda0iCP$A$C?MD7#!K><(o+NhEFgJuQ-aijoFG-xpaz`c^
ze00Le8u!JK^k?a!DZkyl=B#+@Kde7lGMu2>{de0SHs7P^1nZD0!7!}(1>&T&6{IVU
zs$2?TlB>KnmP&}%25<5>NL&rhza4+<D$0Rz?rC(H??OIg0EnzN*|&eEbYVJwxME>x
z9}RfyIdEW$l8Xcp_TMV2Jc)d`2V_x>?FO%k14nBn7vuZjY9mbZfH&itIeta@1f=oM
z$(__ktCw}oYQ_A%l}gxFE>~{^*Bi~=U7(y?YC@@scNgpAVKALjz-a%%t9B=4*YUV~
z`(0Mt4nA%-y}~)l&J6R>p3CXjRt8Fmo(rv@N$@)9m}7qbq<i9H{(frL`D50!+a5Ox
z`F-v4^YX~jSRfN7u6oO0bG|c?4oFZ+1UNj548U=xyl*$xwNm1h*owiin*h~{s>T}w
z`-sf-#^-dA**F4qa7O-)W~7qclf4#Ujz%3&af0u>U98f<)#(hTIF8ft(c6@?5r2V*
ztw|(e&epIzkf8ZBUuEe8uWxI5<*OnV7aJF$tc3_IOvN<i74JN1>`upj1V6yh^8S%b
z*+46^5e*(bAN<IR*$b%qJC|pCEA6_W<Y2!V4CXYCvBIU*U-zUYv#b0?8ophSpZ7y9
zVp6JQv>vED+T)7!w)<LhvLYG(0j0dUmUqr36}8If<R;@d0E>M(TbNx^oN><;!wnmU
z?DQdS$lIZ>%3>zR8)DnqEl;u6INZyRi+Qpqi<wTFqW9ittf`0NIKq`Rt?Gghu48ue
zi!~9E(5)zr?z+Q?SQ}(2@VMBekZkMR#0Tmue<0ShdzGq}MJi9u6MYgHm$#wx1fa{d
zHc}iYC2C+f_u~+;VonV~4TvLelP=WQ5YHmPKZybTewVG!>I}(GgMLI}`FFimfh|dE
zw^sw)(AwmuYQURsag~%5q~(Nq{3NFOvZ#1|P^_q&l^5#_0-+L;P;X-8G-q%ih}^~`
z^51ka4&@XcQN=Gpg($Q(Fxn>p*KewLTf_)v^?tX5hD$d%-P!M+@4>9XnBd8{NX}7S
z6h%tpU?wA~s`$;NVMI4}A*~>9r%}2aD?et}XK!jRYws*p%-s0yLvs5IKuGAs3M2L(
z>IU5U64}T7%nz0HQ*q0eA;eYhiA-yv(OaLj;T-V*$AuZR%iG3yQ*hmj8B6eHW4~y3
zgYcxdiX{BolojOH?V(J64V%pKHW|Xx#%2H}%*}F~C_`=J#p5FXo&L|nEQn@#ZM%EU
z7VNfiZ5`~Eu;Uq)yi52Zie%yhPD2LGd-XOigJN3AX8e?$yhXBOQ&5=cPaq||j{pjv
zjX)1q|4wl>JB&~}&EBHVI{v(6q*_kYoFXg)k%WY*w$8bEi?q!V{az2T7RZsf9oKh;
zgi1_DM*67+D#aaQUY)OgO0rKV2nM;>>-ebZEzlNJJ@!h-j-@+tmn3}lsZ*Ga10XG4
z7Q%0TWvd)^K0bD+?(Dk$x9~Eai_-Mbg(2kAuuVU}VwP+)5r$e=SOF{c4rB(7{f<EC
z)Bik1hGxbE1qeG%Yf#40_w|K>*0^j6&S;;|#z#J1))sZ;Xnc`MKmrZ8hn~VdYg(;u
z0}x<Wng*&?+p=cv)-m_o&1fo`N;V^&iBfrA@<=3#B;^v|rizX2o-K9bJ5cSgvSAbQ
zr`L=KYY~-9hmd*=7lxs^WpCNqb(=YZZC-u|zB8<ePl-bd(d<Kv<oRg%<m`zVt4!RD
z;2@=@ljIObLDfP9R$N+nydU@xcPsdTWne!gCM{nF$Jn@}q9o5D2YaM3HIAA5fz@}l
z>0^ES4G2NhiveumeXALAd61v2IS|;gm~60@4OD_Kh)T>iWzK6|qggV$C?|yOSDM5J
z>!MWeD-iu}ToA)C5$Xe&+<@*f%^W~ykc{-G_lJsl7V~*|W!0Y$Cx%obW-lrstcA<g
zNqbQ<H66!P^o>>lKiS6YUF`DD+?zJ|@huVK+t(9O=@p{t#)R>yumBa!H)s7;a{Wxw
z4BRE>LyxX(!%H4}bKL7Odfop-(`aLBAv)?T^x53nN+ubcF@B7f%Iy>?(u|VPW^s_7
zEmqgP9zEaM=XqHlyC(9=aOHYr?9tyDx5794iAT@Nh_^6U$hR-NOHUPS45pNY+sGpk
z$#wry`&j6Jv|NDs?mU)>@YHbF?{My=tNw?A_^5FWl^kL`&6oNQ7ZiV2w3OArvW#+w
zhUe7D9y(NCxzM{o>vI9!+fu~<QM~B20bU%27mT$>FS3-Scrv$1q1C6-SKr*{2;5zV
zD};MLeqWPtL~>cW{45*zXLan_ljJDp@}3JWvC+#t$Tqrd8^<>~z@aA2%guq;G%+42
zcz|HJUR$VZ!MZopa|f07$dbm<;b)Cv&xzS{LR^;5HWyMm3b$DETD8EQEY(>`5(`A8
z38sh%<fJFIP^o1D#Jyofoi%9##+t{^4~#xvqhiGVSTep*8;*AT*bw$&CuOunNNP_#
zxeqvDVDoYJx7(Hwfl?jIXZt)+RbP4x8HVoB4C$ZyBGTL-NC5%+HH{k*p6X{<$&_Lq
zJ<Q96Wf75Ky)F%(X;FiIPHVau3;6aaio~dMyw+~bz{|T-dLP<?Txho<COIN<yP_ep
zCz!4EG-Bd;@#Cr{yEcbhr;)$<JeeWSXkNPw!_r4AVi3&#P+K_U!BmmTEXl1z9Lm8{
zog6iWFxAECJxGF8mB);{DtyFy((~J>vmOVfKd}-2^MraZ{kN}c1r#n)`&3SFBaP1S
zm0QA_jhkv$i1v3VCI6x{5!h8BEGTl|dSv*WTquF&_8WWOXJL~>v-zyJid6wg4`M>5
zdr(;A3k}fg4OMQ~&Z+<m<Ldxx3wEv4pCi!K_k)mh|C>z*kM)(x3leGvMRgJ@;yFBf
z`n?@2Dh@w6xdz$FK<LMiA9VFPo5h2amb72uNlWhUn|*$Wtyc>y<I>{m>UE8<h`V;o
z?g*i>0Y-N$BEf5Rao6Ey{S4%CnLy77Q3(QxO!1XkpS$I<W5YP>S0C*!q95sy++4$u
za$hX`_wScvJ*G5ABk4DVx(jZJLvQ2d+oCX|1mx$a5|psG@{LaIWO~?Cy*N*>aVDB(
zpyC3o3T@G`Ee0(~;O(DX7}%sNjQER&h2c_}M$M$~4smr?gtF|t`<=@U!ydH4)NaK~
zCFO)%0Sh&Bm#@Zjd$zxwd@fvf@~Q>uWm&GEoCv>^aBoz1>q+4NENu|iyoTFI0$VEY
z?L9oOuUnhYou=HX(^>0fft%1?IbaJ4qo)35_mk@eH&ckU+S)}LaZT!`T7P8;ff*%Q
z+bg>v;)!s>`^~ZiA+tPrPi8m?KF_mseVdTPwaXB=iDaNO?8(cj>tN|yzk}M?XU$Y-
z+t_y~L?);>BpV--BTY4dl<5TDR$`JUWP!q|Z(EP*LdQ~AO@qLGrmKGq<Med{4CqU!
zTm~i6K-8X^yIfRpTmYCs2ZVl@NR+4T3(A>zWSbySK6J^9NYlSbVhOnH{-BJKkWQ_8
z3!Ib$dgUqBm6-al7^z16O25U0(z3)l;HogCqqDkKMEFsgHskl*C!x&fH0Zr<q3)Yo
zu{Q$PvWG5h%;vPu7#9}?`S{;ILGz_XzlX#jeM!AO1Bv>Vet)fsDE+GcWb?%jJ_|7<
z-|w$I#P`~nJ+>ML+3KxM{0?2!w+uduS46r!__k@kPl~Fg)*=ZnyQ^ud*7g$njd7+G
z4S!20dDzq52eFYD?gUUtC)DC#abK;{=XB|-BDhg2n>$a)#11YphneTIxgd;|*1D$5
zSr<kp7a_l4y;Q5pVt3g}uv8cQXixraH-MW}U44t1!uew`&83zz=xr^-W1L-^3)9>S
zor+SQ21#hk;u|-HFApMQ<L2AO=KtBcd!NHHdvzb>G&ZeCW2j=+<9|`L>b)4&W>tKc
z^yo|>B~iDa`V3g4IbOJO`N<XT3_nNJ#=sAD0w)NkjYlQz9@o~+>Lq*(90emJ@IOft
z++)`r<~3k{KS6H)9fbS#UCt#M)PIJz&!`mZ)1AHDdG<Hym#fo~3NpbeVa%c7u^hHF
zOA;h(G0#D7%75RLhnW^GUc&2s1$8YJ>J?GW>U^MCGAn2j`+`+;BC<KKZ9R-CniTa*
zsebx}x!~1angKQR6O8Zv&^tJcyAhTT7i@L?kR3q{zOXplNPYHPj*2XLEYK^<@_@8c
zTDnsf))-L*K41riBWDaAWXP6~{wwoYPZyiXVbkxPbs4UF<q+1Zll!2ZTy0T-6Z->w
zYLGYM;ur4kF(Mb*Gw)5b4mZ}koxV!?)%0EW8##FO2I%|^_mc8S!hM@0wbscB9bVDj
zF_kbEv)8k}wsQyf(6zh2_3R>sgdzm@E1Zq$#6;+lpQVTX(9~vxUp%JjFgKc2-#OT&
zt8Tlzqc#JfWE9vft}qPP3g28)v93FOpO<(EWYPB_uJ87W^1AKPXVB-l;*)=F3k81!
zO2}|4sk(M7R5ZBqW_rxpEu)8BXKR`wcMuu}3({4|Sl#yOL$wZ_1A2a7D!9?)LDiY|
z7;D%uIcMaNZn?@<H_xbadYa<@k@`4Le`^PN9&nJVazUufb7MyMyW;rap|2k6h!SC`
zMefM*TkC8ft&{$7!d$>Dw)icr7{GaGzlVA4Nv-1i@%dT<loWBFXOx;My?jj2f1KSd
z{ol1jjwxR^twi|A-vJnQ^7*}3wUyDmc%{o_T7l`quH41DGVkV>rsHB=o_HJ|P?h|<
z-S<UT_x-)CVNpsBq~?Cr-{rF+&~1%p_k59%GQZs%)G!Qo3E#nQd6mQ6b?~rPOGm(A
zi~bKP<<2UTmM;uv#t;Hu9%lDx>FwoATS;MXzbbiuaD?OP=Ar#alZG(3b>-R-y(^8K
z{%(l1Sc<-YiEg>_=OmcuR;Az%g`Zcpa9gqZ2MURmhE(v8j6H$)oRy9BL6q6QWN)#1
zG{1A`URhp*wfS}q4$~#(o^{95ds#P>kD5zs#~_3gxq9>{L`~W7a8I_sb32)NJg@Pn
zVH*be%gvT|kv$DaSaXOSbC;3Taw#dY8LSdVHINB1u>T<Zvw3JGcSSXevdZ(TLjB^~
zslf<!=-`FDg#MScaMo&iLg-O&fq$=wuDvYNb&ZN=IpK5H)*IsGx-A&1cL|~q{)%ng
z(Q7LPfSLjOxq5_qW8A*vb2Z<&2v`1)d(VTHYjD2l!KW&El_C6UU%0Pr1*Rm=0F0F@
z!U2<a{4N5y6cQ6RI@a6>`oy5T+$lPp7i<0ArG|U)@gdT<IByZpfWU>6u|#5Hr4UZr
zuI8E*lTsZ7a_bO(3^MsAn<+k5h`g{kfYy1})fAy@4e~Oa-7JPzWMo;!2!J9>-UL?s
zs62g;``Z@i2c-{G>0!LrB1q_j-d4+iDs@&>$}`?-3Jg0%BJ&J}wdtVlRuD5@EC(#r
zw|4SE^0z`lX(^tXsF<1h`MdI(2kKh&Ls7TH7c2s-a6e%Xztk(kvHf7?0XMJJ+;BfH
zN;17|c*uM@m4h(HtVXN;1-lWSN#&VxrPu%(2mTr-Gx^8|7NM0V6p`lw<X0ok_JZgG
zi0BZhV)VYj@XbWA*c@IE*y%dp^AHW8pF1d}`b`1@4gt_teQX(n7SSl5=5bMf`!T8g
z?}EGtZ3Vk)fKO+}0#^)PG_?LxD60jEJs@oPFf8I$D3^;p-qb}eAq(gXAbptqB-h>t
zC?>MsEXf7LFZX^BZv!@heyD0_I$yZCEi`W3sTxV6{mM%-|3Ir@@*GtlG^;Flf5+`|
z`sD%+$S_}cFyHP`-#a9Te6!4C`8~6&tTu5V<ayl>=%bqDFQ*IX?63oofFg8n83LrB
zo<M6cNJB}RP>AG_Phk3;osLok3pW`KW#KI7?GK5UXeA2AsHr;H+Bx+PloMBsf}84D
zsU2cNq-<8;2W%kOk_QzS7n*~o;kr}>zdlaEWxKHMH>49hP7|M68ce+7h8z@C%sxu~
zQ+a#(CvAwtnMi}d+#hX8l24U?@^^!E-^S3HQKQ4<xQ`bgGBwx$P2+LXyALEMbe>^P
zFJ11z`?p?mX;D-|{M&9$Rk7C>aFuaLZYgdT@$-?J)o6pntjg`j<hV9Cz#nfk`0O<i
z&1|=UjpINTdz<?K_QP>@0x1Wcv@d$4fD;vi6ZQ2(yRsXL6Wg^nlvCM%@Mk&EZ*3hJ
zT(Ez{nw?(bJTo`qnxxX1E5i4UUz!LyGK~5b7_|wKeRj`e>}0O%{W)cTvdoqaR*?PN
zsVTG?j3YCJFbLJ~_tThw@4*vHH2(-6H~Kv`73+%WOjLq6OpE;#Fc_)zQf6BjON*z6
zYO)dU*xwDN#Kwxn@60TBCiDFQLt|;EwHn!abyfw~dzY!kEo~KC4;tR7?|zlnbwjc)
zL@Pi*87CHe^Dk>g>}(ILR+%Cj=)aDUtUx-`trtA&jsdWG_3%&F&v3W%Tr>r8s-x@}
z4MY&bp?tRG)g6RfO%_-p&*6)|f5r{ChZ_7E%6E{=*&8$QTRCCWE>t>BG>y|cfSfJI
zd{Q?~6_vL*W~qG-pnC_@)wZMJ?6`&`2enW!A<N6PB}I>)`_yU0zR7c3WtzK_J|RNT
z76Xjhfj$itRcs7QbI<>UJobaW%>gXHtNu;JZMO)n!A^}qwqi=Pge6_L@RRZn5Law8
zFONj-af0qY)87|Hxp&b1p5H3PJ#Jrc`3jH}cbWGlQd#QD9QS=GY0-Z!Rj{+@i@;pL
zdO@tsR2;`~?RoiXFQ8}7jn}V!(6j>nhAxblZiDhLKYpAoCvo52ptcVBY^a;Wo0$ZC
zJ7g~MStsR!W%6&n-!N@DCR%NJD2!U0>;A85*uES6Kql`++Te1;h^|h!-(dD5UtwN{
zpo7sbC}X=o(eub~G5bZdg-Dz()34oI>NSi(r^+j`_ZiwJApcmJuJ!unSmhBs-sxRC
zdQ{<j;(@*Q$T(8<tNO(JxjHG%eyvboasc|<oMhJ~u0Fe!y`%d?VXj!>T>V|uM@)3?
zJND8}%6wG*cfwaU&|ik9gF@5Qdov}z9_QYy^)+?l<X1aT`QZz`51LCYBCgH9j{07K
zU>7gVd154oEPWLL#NIbF@E0x`edAs9>K#$>U*GNrniUpMWPgc&AEoQmE#F{GO(z|*
z?72iO$4P$QcLBSSyEujG0MbFV@}*SW^_|#(urkn^<2~Z}r>G@*;M;!M^w)jg6U^)t
z7{eC_)AmHkMcycWePwI1RQgCdGe~%roI5a2!x(D!O_<!PX$3T1GG!%E3+X)}&?Dc8
zfVtDEfsi>|xI5qPs@VIlJRsRdM{o6~M$-^64(en$|L#>aBdJ0uh_+BZjJ23LM{b^~
zJ6A7<^S-MRS)}dfCtn>8*zxDm6rbF}Pm3sZ?fjj;FE;02ZnOs$SPkDF@AjVoXg?NH
z4M3&D!N{v0sE6Y&yO--Z?3wKAANy7Ji+B#;5KVH$Icse>A6dMW%V>Z9Q+-8Ao4Ztp
zH*K_pP})d_mw)}cr5{Oo`SN;_aV@*^qr$r~T{B(#)~j}?4^}`&23e9l0d=5Fb52hk
z)H0pGbmuo!-}w;*vXWdVj0g7$w62sW9eB&P;7f7<eHuwDbI826U^H|{&r55S02Wsm
zNWA%G(;}BbUQy5kO+=YK{5({xmEXmlB%GJP_AQ=EJ)KrLpM%yCc_YXkp(~PlAt9Mn
zo~!%QWO=X>8+4~>7%^M^RuC<<S(?wd@GP*KP}~lD&Y1~$yDS{?ksYMW<kf=||1bYZ
z?88n^Sqa}4YYRd2L)VKF&sEIv^pZ6%=-!uc?~zx~CbwklJteCdkK5h#iS=NLCtEz8
zeQZPN`iH=)OfnwKPZMW3#Iy-=H7*o-xGsSeQf_tBZl=!-BP!tJ0Sq{v^F<bON~kbc
zgnesjr3QJ4UbJEP65T-w0Ayh|E~gCICc<rnI1k^Z2OsT@EeG8Q45doPg!}u(|NL?@
zUR-3eZzmEM-Be9(L4$nVBApq?!@I+OW5xewPfxq4p&!ZkqE#@Nwcj<Vg}V4%H$uxy
z6hf~sL;HFZjBAS)4WZ?C3gkDY<Adz+k;d`w=5_KB1sM%0Yt?<8)De7>n4kL<Gashs
z<?Uvs($aAz+zS+<ckFlFq*I45P&!tRg0d^Q*OD)MR8v4QiehCm@{(mso4AJp04q|A
zJ`no3{o{FPoPC;X1fE(TY<4+9dYtL9Wv5h0%C*F6g?~(+K26a`PZo7MY2Tap7Ms9f
zgm~@h88<1YciNqzsS*-$ueo_CQK<gVJd$f(7!F|<LqS7Djm<aW!Mk?uD4Mx9GRJO)
zvEk~uOCsbovPEcXn_6p@xoxb~;Q{{o9i72pF^w&}NRGixP>Q(z!8@qMFb(&^bXV#Z
zOjIUS6Ptp21=&d2HcNwLa$nU>fs(An6z$AQ{1=h*kbm;XTuqKEGOe}eEqbkvDG{lE
zVt=SW2<0?;-P9MBiUmGwDu+x!jUi_kqFI7aRMkk7gV08BIp@Ky2^IGT*4>fJTqWWl
z_@0E=v(wj#)5OWBDNwf7LWqdJ@`_(LlKKsr_d>Ls6ymk%%Yy=+7o=d-HrP^xvysW^
z9eh~dDjN*m=fsZVYYo4+5aW5F=as2%tUgiS#K3v3QN$PUnr|N@hupsW2wDGCmRHO`
z>|#jBI}t{E9|JUq`k}+qV0iZcUBdXB$ahpR`2{>Z<x}o5tGf2e)jlm$BG6uZk*mI{
z2o3RPNg!|4Kd>ahrJ%&eniqk5zSu%LkUIIU_Kg0Y?86*SSGF@p8-t`GS*4Vh8bEVI
zBBX9>;D867z%dwir|{UTdL>s;)|%(1x)m1hCa4{C>A9EI%bQ6So@Xr+6k)sUa`5Ua
zSG-iqk5{BiAN>Q3Lldwz0hognyNqbeZdE0vU+j_l*_a_cF@wO7C=^lD=Ww^-E@Q2H
z6E0vZ+}<a1YA$ZO=0;a^jVn9AYBWHvr;1<O7nit$mxmzrA8$J=!cr8GJ$9lkFo(x9
zG;;9k5w~s%Xp3yOrJY6;vn4rg`=RU|)Y)}&haj9(cENeQrolRu>SVX4p+CT9&$Jm{
zSpB1+s(~G)EFUhV)sm&vYd?`y?ql$*7zw4*DrIeE#JFLj+NlRaXPo)+$v~A(O315o
zE0+osWf+=yKg@ccjZr^>hA|r%evAGIGo8RmTSf>7!tUf#HW}+yPZmMoym7H@`P#t(
zlR#uELQ-10vpjIVX5R_eKWIVrIGf~|>#=S$yn>3|I<6;`)B|)Vm>jf`qanhrV0;GR
z4efl~cYo<wPot6dN{5|OWhQkJu{1GZQ02^mE<ls@<(rD)z3-y#O}wlvISP1qic)T!
z?zemy8@0ariHW2fO@12A&oXz>hJgQ(pxLRhDkrq11E2{K2YBbabZ<|+Fn`8sa`1$6
zVdSC^AS8BPtwP?QSJ`H|5}DE4K=a9&YI8@#sM@MkXa}{TKxG=eNe=Q5eYH^VP;>V9
zN@(<)y%d9EgwuUbft>aA?dNFEb+i(0og3?UK?+u3Qo;3zzeQ2wT7&oc6v+Yr<V83e
zpB;xP6ULRX>)U|@E!#WQJ4rW8LtLS1i5-$53B^SXlZK8IRn@2I8KVH-|3EwmW{*nQ
z3}h6^EePnFOcTERi+I5R{%rs5vR9(_6$X(`c8@<;nzTG3v@MbBJ>viWvr&V#RkdFR
zMw}f43>crfhcaLGN=O8*fSHORHPj-%V~ECPHp6>VQ?x#mihY7FVc)bkogH%U6iwj!
z<i(>GaJUmMZUs5&=SQ8%KQH=6&WM`XA_pQ3Z*_$R15^<xV-jO7fSpeG;dm5B=!J|t
zsHOe;(_Fd(iP?TJGkonsjiAlc)m*7|Q0tezApd~TpaEJwt^!+tZuv;#3iRu~N+CL6
z!uPc{<md`d%mVk4sTD5F^S2BxHY!_<k0;D#a$G~vKK3ahzaJCUoyo9^5?e>TI~CG_
zRhTl(Ve{G=ErSo|!#k$B@e#0{lE>r<*yA{R2bsJPN0y5TY0KQVm?jXQ;MO#f!`IpU
zc!paEb==Xt5OYw9Y_mdM%_B*FL+d=nL9!(SdaXv}J=@(+K6gJ@%JTT%SlHQt%Dh;s
zRZF2kLXo+`;7$o2dM7Fw1*I{pGRj0zoR}Ls&-lGvYlWxLQU8j*5Q7_uS>zFANJs%E
z?uq<UCD1{TI4~|Hq_evT`W+hI{i8LOFL<P=#HsbA=ik$(Y|+3$r9=#R*X40p+rf-&
z;KNVk&5;|vl=;>HDo<*6`+^@wz?9?A{okYx$I75Q;d0VN-$afcuJE}p;s9AesJS&-
z=fGa{PtdLV1&ouWMG97nKh3mu&ex9=SFq_opvVntg+{d!7TO~@v?!Y-VcJN;LhMpX
z-Py1m=MfvadXaWR*H19zo?_Bpjzto5DBENvOy`zX4`Qm`?MIthbc7J+U{+H!xzF^B
z#Ch!=L343dB<141ntTa&%va7m?V@B(=6km(7Fx<*@;udLzYY_Uy5)$|EDtz4m<t%0
zRRE3>TdNQM>C)uux+}6M2n+ffK;I#i_;&U4sR#|ZO=JADgoJ~e(t2HgrKrGX4ad5q
zf3ETANx@t4_>{SiW^Ha}u-#O@>-@9N{UP*ZSXmv<YUeKBxs^;!LzcqBUybQAJJPM1
zP|N?}C09@xb$D-ojxv3aO0+YM)gX<x_Qi<?r=x!@nYAk5pr_`@OKI29LZEin;vex*
zcxusLLTO7xjd#TA4{_ZlK696o^eB)GsrY2<<B!LGqTc=m%&Dp?*S?txcjb5JNcR+m
zPjBs<ir{0}01J%6^@-;RL_;Rg*R5c>S`eB2nVIH=d7a3>2X*rO`i!_9qK#uBfZL}&
zR249LXw9w?9z5OcDo2#9jW(a=pWXWIU#s1g`oHGNJ`@Gw_UnNTUZMh(F6oeFrp)*I
z@|M%~M|B0eQk$IYd`x~p&lA@M7+MDA3Dm!4uTRB(q+%5p0jN{Aa?M;zptrx>x^Ih5
zZd(1>s{K6P2`SQ@YaSK_7GM2KSBLmoq=N&~4J(uv5qE?ZDHlBQ7J)uP4HgKc{BNMM
z&Rp+r5e6D&Eh0m+yNbHH+zE&}c-@#0r5HA(xJlQlC-zZe^1B(EUI*{1a%fLjmNTZ)
z^85I=Vv3<ju1JtW;ZZB^RP2YMNBgVn?{V~`qUoys0!WEt_mHmC!N*%y(yy@LCV9(9
zx`h%Jr5{<xnE0p@8qF1o`k~$4noMKwoK3xSm1m0H?HfmHY{l-`Nx8zonXSYVwf*;J
zVzdhcA<`f8<E{DcA5Vtd-gBroV0m<p&Fjaqm`CqET`hYX1^|Ukhm1raG*_(uI@AOZ
zVs++Bt|`rHe-I4(Eq9dg{Tt0e@!DnyNjG_f?~Euq@7-(<E_hIP=|OOe#sb*o)!msb
zM?+Zyu3)UE4n&`rIn0%=iajaj4W%R0K8ADr=DMK1;NwoXa&U7alScA&Z$E=~Lbx0)
zdJJ}BnC)M(`?boFr`#05uG?WVbbuWLuLqK>dS%1iV%cq=LDYo~P2N?CxI|zzU#0e*
zGDNc=f3-cDCK={rXVZ`rV`&BsB-ql`(5jl!QN+6V3Ejkk%94a+(@p^GWmg!p16_&A
z7dDRFFCz%2+3s*irX;dHp~d@!VghV5R|iPVMCK#abh+a@o2kUh4dzo4*HLiP*i$0>
z7yKz92KYJwzFXEwfimiGe@$uw*Fo}=tDO3D5f{>!N2DKSRQ5grgiRQ=P45eX&#WN6
zF{=Lbyfuq$1_PCyqXxs_j_?jQr~G~s>r%+c%SGPBi=;7<;$W5C84wcX@tNdE1G|`p
zAhVy%YVF!fVtPf8>8C*@mpDqCRvsSRm2wc_GSo54Gg4H-wHUy~X$`2%pU_L&rSt0M
zO`8~+4GV$xo%iv2uFd7?4_vZW3(6{-b-gdRGxOK%2U;)pgEH@`>c$^4Q_~!<mU5cp
z-clVpk>$}DNbh$DNi*!HozuO^hD%oiTB5=WlKeOZ9uMmzrL2doQ8vG<etB{M3b{L1
za0VI~{t;mx!OlzjaS;X1ruv*g_g3(zKguEa|DduK2Y;?fbq<U+x>uTN7)^_#{4{Dt
zr_7L_eBXAlYZkhj^NeRd%}yAic~`$*%$k_+G9UY*QatVE#Pi#nwiNZ$-HM~eh{pZb
zhw~ldehJAK;dH+QB5EXu6f4Wd+Q{Vo$=}H+V>^Z<Rs~b0`}id5BPKS7SfQd&q6$tb
zcCKE!fGufn;d`=Q7FPdUND2~i5ge)=Z?HPQ3!CccUe)?7YbQlu!y21ytYu~l3v(kH
zu{e8%Lj&zQ!@^otO#cp}%y8QiCh?*N@9GsU%|1iMOx7k`rbaTM!W(?Czt<F(D-saZ
z5$_ow>Ege|tI)ib;?0tggUh3+MA=dLwu?7W)Ka%~qbS6L*^$ZC_1QM&G*xi)AO$=m
zs}CZUB^aj*F`wi0=?;D?p{bbb<HyEDz;~<h>e)DSn~!jBVD?mp+A90KYf{>hl__SB
zq7~_@r2Uld^!Ac*_4*Anc^#_hs0#FlG6EA0ERG8mrS;caaX&3mv@AeNdJ>lMGoG@}
z7MyzbyNbQ|$ql;H8S4G6l+f>`Io>65*FpCNle}PBubUGVwenn5VIU<=>&V}x^mb-j
zsFHV4QPu&VoPKxTAX{6yt-*T(^V4#7ov05RX7{{I?ADgc&aB20ghV`%je+xg_u^e=
z;$rZAl02jFZO)6B191+)nN=#$STI{OTfw&sy)?^D{J<T~89mO=ZF4_|dgO{Hl%DB2
zA5vnkz=VhB642~@_gvnNu6j?G(#(bq4G51gg1&t7TPz`ufLPn)M>B0+YuJx<Fb@TL
zB(j>b2{Hy>Jl;P6FF3Cs(143<XB@l>os^}7A;#wlhJ=LftjDb==5%g%5bQ(q-yAm_
z!{sZJ^xur}hIzxv>}^wz8i@*cQL&pcgVb>$6%XU-hrm)J<{c6PiD;9qw4Sba@Dr<q
z@n;;fyOTtC@%}269KXylp&!_=7R)qk!0SN_hBJblE}v$fYRHmIE)UxC#>(lpO-DyM
zqWWTt<Hpr@qDFD3m|9&h#FdHmj@9XbfYK^bYfvPI3IvPtwg1E$ntA5}<?UJa#S=;R
zNF(U$`kH?*2|?7SSbPRTR`~@8No@<ndH&TFI*cH*$s@pKO#_CjF=+G%SzhVJ{GIQr
z+iI{FXzdr9`FN@b<H_!B0tBLA1`YsOR1VYBhw!u?5%sY9j1Ow3P&FP+5K@gVy-UV}
zDka(7OE<x?9{a0w_U;B8z{nY58QJ#zE|RvA5ynIO{na{w5!Ojf&)K~BvWl#BLno=9
zb}Ye!XwFzN%l&V|gE3y5xUz@m5$>Bw9I@W4B1{pl$v+$jJt2#&YNkBXRf~14%6GA-
zOwe{?uvDvwUF0Jz*?L>8N;e_OMUNemwN~j7j)vPf<YTyedh0*(xl*l`Lg01Au}7At
zr=fJ8?0St6Hh1_o8f-~Lt%spuzK>?xKR<nW*RPEbhlo&yCM9+nepNrI3>U7q)bQQY
zUg7>m9;DH>S=_xCW$?0jh-&ANN$1QKiW+1^v%flTm1@tM%!aEVz*Db*Z;^OFb*kab
z><t$892gQfsoh!9bRJT@6I{g|rhy=ISNG}h`hIBh1G1Q7r5`GL%u-{;peK5(`C)g(
z!AlcAXwAb6GT_rKgzo+5bI{eT*)+R#b?D%6aW)5UZN~Ee>*o68!G2Z4hx~~_CI-sG
z^#b>NdlXb&HW*V`ggypfEC3V>nVtEuDQ{*85ISMC5c6NJ`uC*u*}?55(GuFV`V(Ts
z5YVc6mS;#eSX4b*%6WWJYGYUc3V00S8DyJ&A*GLytj7n6S%t<!iE9o;A^H%y-DSNP
zp)jFl@bBLbs_rQ>&{w1-WZo^j+8dm+bR*I1%%-MOS0ql}m-6gks&y+-w^);EIZ|sb
z3FIM|{!EI4`K{m8QyQ8M>oBIH9wGP89Z!)hs?5Riz>DuInc%P=QvH@<UqrrL+aC|7
z`@JqdmVAlfpMueD`<v-&g&wSot;zyOyo25bpRMDy(AfBQez~AO1qcKHxNH0DT-@Nn
z@F1Y6z$w4aZp`zyzKX~nf*NL8;)s}>L%PR<>&ChFBte_eZ4D2uwnpcPS#$8J@2g?v
zQQTO|R~2a_E5wTdmYYqhSL$|lgxrX_SMbZfer}UY^bHOpe(>vpYenLPbDeN#F@3Rj
zPO73hfarMi{tShA3W7%JZ~fDIY@)D5b_#)$TVKr_K;hCxE37I%8Hv~xDy0Ir`VR>R
zDcpQ!5c-0c6_dQZQrY{Q{pr8ZkCp#eOvUKUE_!M-0bvRY?O$V+756QP0+A0nzbM4X
zgP$BHwFrsf&jS#RmI_xw%0a%zf83UdX){yfPK{Cu6;Lefy_mye9<HoA+R#o`QH4<l
z@;#?duF%FH`-G~D7m9g1ZjH4@y=+|Lw|rKqw8bxF-C>=SzQnSN?r+=cDD<@!<7=Oh
zROW7t2uNWNGG@?RJV?KbfBQRW-CbKO2{hy}43b=Ww9mVT%&}Q5a>pqR4MOtVp>3mr
zfA<O!Q_*^9#-QlVag`9S!OO=#L8|*NJhcKgxSqE>BhL)#f(jW%9iD&jF>K)Fenumd
z?7PML`o4c~uW3LBUgT@-?smZV*rJ<l?X!pKG{QZ_F{^jzDNRWNp+)y<ZiOV<wYe^y
z`gh}HoEi;!hk?4HVoEmp&hU^BP}9Q^__#7F2Y~MWDT0bqLq$TuIG7500{JokT`Bc4
z`leV}|C!5n{X6_?^G5<Wkd^Tr;pZ0_*ggJluRg}Zby3XKRKM!4CLtb9@?l_U4pEm2
z*}1GW{5u1~*ca<Phudk~+0XvUWH0{<XDoZu>3!)7Y~!n<qt$t=Qm}?tlEP*|y=LtG
zYNB&jBF8TCpB+FOG>~8xc0=va$dxo#DdSk<kPteUecXpTyh(UHHZYrTwc0`Y8|y`(
zCP=b2XpkrSjgi<l<G9p;uSov2XGU3!8k8eCw+pnLE1a#`H|T;_I4u!0Sr^Y~`b;f6
zR+)G`_YJ00iLq(nB&j(}(>|gRvZETUyPc5c<i|#MAgwk3nM8eCXL1sQ!%F~F{Vo*@
z^ydh5%kG#VS+e`v?ag_N<l&XE9J5sw3Wa|k))3mL)?I%+3`nc0@G9w__gd2I^->3t
zH?sCpmVigN7pO-yJ6DUpb@E_xT#+C<Km0qKv!WLfo`&P2BjP{RQ(Jty%0Uu^(uRy3
zHz}=fUS+$u+O=O08$rdSR)``#SC+Z8R?@VhGS{}=Ta~s1SUZNQ3FW*nNq2`Cv^M}9
zGx1hZW&nk9FKy8D(xSm>BMh|f_J1$q83>>xDxnVg)w^O|xoJ?bJ5a9-Q0N_4;uf1b
z^`|ePq5_6ryciQ7J1`%x{=Dtg{d_Nf(qxoQ`l0u<6RV#$Tjqf}D2Ibo`asZ}LY5*R
z8pLdH!|Vooe@nlvJob+j5_J{Bble@dye!UXso<5Se3x~D?7uw?P}b-gcx-ZPjk(Yg
zxH!TZZ?pRjBDS>tdweh-_=ZV23UG8!ktF=Ix)RDT9ShrFFYD9qus*ZtW?!^E^)=r$
zq2IyV1Ea4rt*E$n%H;$7-m{R_NK`=s?x<E#M2L72)Pq@%VMXX!A~O%KCWCe=hv?jz
zaRs09a4==mElO};>*qiBO+Nz<9RRSw%L1VSe}{Xlnyx$vxy7ug1H?F}vNm=r7Fu2&
z@J!-BB5&&dw84LK=JT9&RrNJN4~POFUGQ<1bae+M(YVqrvtABI`Q^Rg`(O4$eu4Ra
z=|tzYS+|J#@7L{Jke&uWN?TC$Ng4AJ7ItU{loWv$_Uu%x;S2HNd)11(#}3&gPIzyu
z4onVP!MUd4$;sgKLs+gzO#xv<A6r^Mp@3~2ypt~r^E(XHc_8>^uh-fK&;|WGzwi8%
z$N8`XXtSrBXDzc&QzTLo<Q$O+SuIr5gKS}~N35I!-_l*_pq^s%UtiSAEsxd016lLP
z%*KcaH`We`Dylpl2;k*W=A_9<#&<-uftP7i`=K1^0Nyo;<qZ!wKV^;XS0zXMKqYAA
zhR?ggkFAGX>GHyZZLcL1Q%_oddh#S>gbXCNytuJ0oR|Ox8K`Q~QmenpQCQn4lBi4&
zDSz0?Eh5Kf#k*zz_aCS5@ChF)BoOx&b`PVQ)g4J>6m&qi0noeLJhJ1?De$(u9l6SC
z5x`Lwn=48k5%9VRC}BQ^je6=RSd3(&NM$<Xn5nmRZElkdrr+NSmUCL~E|a)h<tZs5
znhg&;(%7Bf<zw059E0>bR$b|*Sr?x356U#?a0hI4Qggisi@%DeVNa8k@Q-<CysW@!
zUyu{G*3fZ(O^dX@f-??mmiSBGXLa~w1t&6MhCg^ZDsis&M3JM5SjFeSm@v&{y?2`u
z)Yp#JVJ1mr@$1PbXtmY4>xmit`6LqSx(^#h0mx}>^5ZWebfAYIWv6QI6F*SgZb2&p
zY3<ar(%|(hOE}b{71r|dtMR3`Nu#c=Lp>!?BxaBUQ}A{UJLIKsp~5;#iA|Y%dT1Zv
z;tc81fC{?*DOC~+Rg3LB^ibt)N$bal^kWE@*h)ADgekA6IjZBQ`;F<uPU9qx#Fp$K
zmbL?2C&Ted)FGkgp8Fu+4IzCZiU&uAm$Zt-mE%fUna`zBtBin~2)pqvaQf$9tA>s=
zd2@~aUO-mS_h+y|D+q2Acbx&>jQarP%}$BcEf+WeT+@;mEY=>f-R4@iU{`P0cW8j)
zR_2X0F>r+U*;8d(%BS&Ssi;+p=D}=ZF`Zh6RM|G_<N;Q_Bu^1?FXw$tg{0r~M>?=m
z7axTf3IKSvPW=81v}Fd@WMtX9tD`Af8p;=%y2>ho%<;k{34_%ihq9%)QlohYI!&JO
zk__tf-HN8#D!5T1h*TSCn2f3gy)CadZaM$S%n&a58EQo{$mTVXh>JwF>vQ2R2L0-P
z4}Yf>47#|ktHDr;cA=WHwn?z<KubyrC`U;MjIF>yEeD7iL;72ZU%!Y=buV{&a}Pgt
zwU-p<>zp29{W{-o??$V&ed!VW=K|V6=1P)fFoe7|obMj~nHA!4=>9ZJE;T1|x~rDz
zpY!kj(=h7pP^WZ~y~??-6G_XFw}f@?ZEmr6j~3i#c{cFGOqkNhpi<8@HD`nic-Ceo
zbqn?EU5<0<XEWW-3~kY2oG}C;xPhbgZ;%l)2n?=mRK>F9&s9rd3|@Od(AmpSmkTeS
zJxscG={qWkvE{K@qer2*7UJ*qpjTuU`&FdKU1SA4+c2#>2vqCek)=X1N$j38`t?j*
z2}v7!!tm$tF2NGDikrt6&Qq77(lXa-(_oA5kB)>;3;a8)CcG0#?9adZSulbEFpP^c
z2%_NdhbPP)wGwTW$Db2z@S98!nY8qL*@i(@>yUkSp8166oC?aILQ#DY-#_wm@kgv#
z@<Ud%pckK03I=l+&9b`tVRY)DsM9~^6#=LJkEipFO7i{VJ|Ze^5cfoJRGNFHDX!Gq
z6=LSrG)K8IG55x8xwkD#a8{P4IS@57wdE=oxJvt~I1*Fg;rE>9JRJUk8_sp$zPR|@
zpX>d8y>rUOp=<^+Jl4{nRH?}f7%|L<3CRizWsa$-r`XR(`g(>XPXL7;JYABG`91JM
z<I1~Gxy6>Q9Rns$0VIb;-&_s=zLKo(U}<WPJnddU+us{vugv=M=dsO-5TVv`=1S-0
z65om=v8;ljm;Q1?gN>t2{?AwG;TqoecTf17UM@=YYK}SF@4-{cM!abF(u@vP&HtKq
zAZ~ttd;fq%$1a?<aDD0>4(9l8kfxhP83L0!YWsPul<<|Wd%&Bh?fic5evPJHe8Hpp
zja8qj-Yo>H=4U^4Z@&^2-6nb2$}Au3O_7ARD-;l`z9i{=nNv$MnXw*d5euO=2dfQ;
zrGm1j@Xp;9gyPA_7m@5S+-2SaQj5y3yZuDc0@s_R9VU4s+S7f~W9-r^tDWNc@xnIH
zAp+1VC*_HE$Ev#QoeaRYhbvOb?R$ZY@Pb%cRNhkl(7xE{t;o5G&9{hM!}4i51+^<%
z?Kg>sIuhAG{(IBG&oqqH)_UIekn7SxQc~G`UJkQU!ABji>Dov30Nv<o?&q?<VBS(q
zq?T;z<wB2h+giApPwUf?93s-aMebc^%}IW)O)&Ji@4+S&dix%^WSWHazD0e%1lHeF
z^CTomXxC;BcdawBIE<7)eR^a-vPz<?2cPEkWua{gC6;P6CL~wZ4Ko#k_E;86T^2)j
zmj_hgzxkUfHa`hYV-sIk%-tiB3;M1w$Jbf$v-bA+W>~)jNV>H3#j*86HL}fi+<WMw
zNqt}`6%<8+Z!6ZAHNhu~Bx)7-uK5n%M#J<n!tIyZgM;eijFq;`_j#II6@I1<GKM(n
zt{#5ont+X&2J}7*R3RU{#pM$D0{xz+Uck$}9N{D><6V>yMAKxoaPL^l30dZN#p{(~
z&7`=Inc47=xjQ#-JWH%Pcya<=Kzldg(9Ho2){FU3xVXI=Ht8~)3|42#;de-T(<gso
z7(7*@=-g#2$@bdPds$=orNOP)%GM#FFYH>C1Nelu^p(pACzl5AdLSo_mbzR9LO-YM
z04}xQfa@Nyeq!m#nqdC-Oy~SCd|foTe~k0j6f2FxZM>tN$JL?0&hOVRvtl}#B+FIK
zFeKLEV%pqd!Vy4#E;!n~8T>cG&7T<R&0|tv+4D`^fN2U%$4$=Vo+K>IbUO-`O`TJJ
z3xZN@w~R!Jm%xYP@%$E&kWX9o-#vh4Q9I)Atv&ry>f<j%SYa#95|b0GOppw-QBSfk
zzJv`jX!AC6`1aA4;)Hd_ts275ox}$bQ8=OFf2E8}pkF;K8pRWYPR~0-RtBK_;B!?y
zFJG({l!eoo`nWEIk#w_5m`)#|<6Zq`q=GGt`nJQb>YUroUX4D8wM?25`XyM9Zy%?r
zw=Kh<Xf?nvITZSYBAMx$u7b(r^lFi2Z-JJ@l1~XBO0Gj(W=9wFa^->l38)Vu^%FI`
z@fznXP)qy~P`=S4L-uRNzTb3|2&LxRo=eET;!MXz+O?F}FUoERY(p57pU0CXx-;eH
zE3|fMQSz$M_Q||F3dzYqS51WT?raVSrLea;IwuFA`?Y*bDd;rT9U$kyeIYvKYKX$#
zuFn7)@<d?GiKWtLg%P32mp*RTikM?LMC$!8=-{Tr-V;vT(e3Jn$(OOkSJqSIeHe%z
zVuD2asYF@rGcx^Ixh*5vkEP7dwN7fEe77#Q{w{bgbG~>#0sru!$2+TdMcf-MA5W8?
zuX=fx9h2VP=-U}jaG102u*i=$PNC_~c%6Q8Gj)`vJ0wD+CNa8^s3oE}=(OE0D5$>=
z`SLP`s@h@3BW^qCMEy8fV*j}DYx98zV;%FX4lRX3`y&M{`Gm~V!owm3V2$S0=7Zp&
zbWz5|>I-`=cb1H<vE&?$Jbwm0_5Ow(``X9flRZWvYC}i9Eje5Vc>`~HvFrz5J5`A0
zlY#Bnm1#bAgg_%Lfn4w9jC5<ucyQwh^=xCL=iQoT;Mqx51A*p}1P_rrB_7b@CX~_r
zNy^n=w>zb6ivBV*j!30c6^r+tCi}XZG+Z=!eS33t((%%^bCo7VO$yq?cdqeLFr)W~
zS1EL9-aPx@Q}nscqjT-CC1x}Q=<pZUg0U>?DV5Yscl=tz3+oT@Dq#Pi2n8)P#yh{I
z6qmL794&w?tsG2nWzeqO8iPLUc3X^S%h%}KXPAMFYMa+GDhnA1A}3>K-&DbrJHQLK
zEqZAJHmn}#mS<~@G+VUTF=Mx!u}zGzA9Ld)A2_z0pXDGhoT6DoOqS3O707$C%uX71
z#0(*XrRdJSN|h(g2eCU}Nqof#U6o~N&e&ybtO7ZBbu{^j&<DQY>}ygxZYb<_4C@VU
zw0!<2TT4@T$oXP6|2#T%2eI&*PM;us5_DXn|MwPm)2?<smfp{nzNL}N^=J#7@F#^;
z+l(&4lzS!1ueSi_V||dh#|qqJ4L<d5Rz%I(vSC>StbVHqr5dR1`g@e%OH<o32jKnM
z?0mf}2cicKA3Hxc>rK)#0@E+$Otwg514OKFm=KH0MFFsk?W~P<MrXz%vt#I@P~K#a
z^PagO2PWsigTh$S6(qA_RFnrJy5?;gor*0pb<PA)bGqk#jKp)Q3Iqm#Iv~wU<)LCq
z%%Z;Ek)e6^hlE&}h|LxT8tOsyXom8RM#o36%@c(!WZz%$rqJujLT?$f`X<q~0Qrl#
zRr>a<zNh~y_E&Vap)K3MiwBS8J-+LNJxMq0{QcMdXmP2RAQ&=s<$43WpDx0EUH{ZO
z&R<0I7Pu_nI;(4n&Qb+<fniy8@A8srYEj&ND4gRlf4GN=TxdT?NVb;qa97Z;94G^y
zevlx$@bM?a-9*z%nu4%6x7%dDUH@dRd7lwean%&mv6y1D)+tT<;lvIi=EizIy@J_P
zg}Ets-ecN{7y@}a>V_8hDm?xkL4CIrDtLF7Qn+}zZ<;sbP;|&^mUcVPov}rG)szr#
zd2T7k?|*0jBH8f0bCT9el<Q1Bgb`UM_nd<?k#JH~OT20L;W58k=(@1YX+D2c?@4<L
z;R3_|<!p{DO&aZXoAWX7rLzyb4M^aYiOW?y5_WZxNNsJb@Z^5CWI;XJ+NmeYP8{Hp
zwacf;w=S8y2B}=Cj#;ZqG>{54`O<!IvnSqOyeM8C*X|zguJVxCmgBjla=!uM%0CW#
zUgd3}of|JJU=IAHhL2*kE)_GJISD7<+f6R?wHcc;!6Fh`bf)Q8?RMQ9cWLjVcMbX*
zkJM)Jv=~anb;CAJ<4J%<^vL4{{n4DD7`oC3t@DkBe_!j7L0QTT`@?HA_@oD;aVbh9
zModXqZPOWxsoRn)8u5i(lNWtgZ@TCMoj#YYL@H|$(HfJzKvtPx#5xYY7VEde=dpnO
z?>XQ3@TK)R+?;KA_}lZQ`d0^PY!t1+Dxh;IMWij#3R7jFh2FjD({^;OH-EUo$f-Cy
zjUVK`{`X|Dl3oa<+%HSc8Xd;-nnH{UUC0UYcs^-!vhJgc)q6)r6YCVtFcH<H`?%GO
z`U@2@dhOSobKW1gniV&q1)SXRq>F*=&EUr5OHrO7jr|&v1Vc?QcVI)yi#q#$uKvVn
z&Wur_ApWR9S)l@7Sct03-Zj<s2pv@Shh=nYWbUas{nE8$V*hXC$>Dm6UfPh>3!@dm
z0s7#^J6sy?=dl|`wOFItN8-u+akvBG<iGFFhZ!9mZ$bB99UQM1Z@dCde*7*$yuFFy
zEKk`^p3C~`cQJIWB9fF5Km&V~8QVMzYML=Xo*Dal#YdTnYq=4>D(%|+-o;4BW%k@l
z9hllL{a2cK(kBNZ2C*2*!HCP)5Gt^Js0(Q~c<q=)hesx~R#s2i_5I5zm}^H>EF41Q
zGhjHX9gj#{&l%m<C*<<zw_SZC|B<KqjhBEHh52DxW9eI}T42RqR$)pj<aMy!+VTLq
z=UA$ZzobDz<{E_0N(O>H7>s_eNs?rEc@05^>g{IdolJ#2KUsYIBH=-pO$C1&-oS}h
zFVYoMPzOXIdAvfTYn4#AY2lCY=MF}>dG&}?Xp~R`H}l{A&=es0E*QR5-<PH8#xUx0
zY+SmY=!MT|f=C(P3`^$brIex1N5)>l;X1v;28!GoEySZH$U;U~iX?&pld`I1R6p8y
z3U!x-mgza)yWH0QMO$D%y}$Ao>>Cwb_&-1)W6!Dy#qEX$PrX%FzT3?oHgRDCFEnz^
zVBST^C0(FpQ4XyD1?x9Z`=y*Mh#ihERAZx69cnbE8Da}P-c+8guxiGaW3s+?#ArYm
z@xcr34eYM@<f87cPCZ|pT&C9GU99;K&OLZy@{f&4R14qQA~9oGeZHjo=e_05F15Mu
zp)?6@PHKUv$NFLfu@dDjThTc0qEUj++{UH;uN@v%z5oPvwtGNHJaB36WB(QX|2J6b
z&NAamRA}j!LItjEOebH6Y?m0;AcCy#kMv6f1>eAXX@T+`=_ho8fo#CO<Qi5V$%KmL
zF048K>Z)W*#tA+k7o(sj++0t&k6Nugy_q_<OYi?lpYCaQtz3xuzYUc~2$fQFVK&9x
zRoN2*{(s}vQVeA;U3mXaMYCJF;guv|(D%yw@4~0M_g9)*3NKC&Lcd+Dx^0t{z1kGd
zu7wKP7CJ$o=G!OV(Lq(NGc(n(9@?6t5e!8CL}_K7vM_jkGP2>{lw!A?#`M^7_G;n3
zO?S9QzVe?VOyR@u4ZPsr@%Awn@~-M6^wIq{(q6Qt>M%~MvtXUH=-5GRLc)A_P{Wrx
zruR21tv})G>drU>MT(^fS-nFa+&HM=&Coj%;1l#o{At%S)a&ctw2+*Qj{fOrd&`u+
zedel*0RCcD<j?++(3jau@|{4woU!JH_0&0?&h17szvb&8Vb(V!D7s{~z&Q;PaY;8q
zPtVY6Y-jz`QSlExym{vC9Sgvdi$wwTSBfvYh}6A_cG~alqHRY_(<c1s`8NvO>dyGr
zKONb)*iw6;{kOD7@5hpgA1cNVOP2it&)x}iJI9}|`TK39)bwpxLFejg|JA>h$BB3X
z#7F!#w$+=HlT4D2?#)zkc*I=QdkcDEdZl>O+w1amtz7Qg4>7Qq=Vl8+7CjDfkH7mm
z!fLw})0({R>D)H&qctuHI__x?7ONHGoOtG0w^sNj+lM^u^L0koiEFyz9lI-3@#x*q
z&~R#AtgG(M`beRyyO(WW+N5${62Ot&PQ~O~P^frkhO&|Lh3uu&TfUV5nHv$m$QuoF
zjBDnHk7Vm6+cmUVrie<FNyGUH(gQ2HX#x0WKhUnyqT}bKdg<HYflZ0)DfeeF(9A1o
zOy+FwuD;f(Z)7=<art=s&(7qf0E){f`!?&WR>cR+o5uQG-;u_}OsIAi@fUA7aO2HG
z@2;N9O1<9yfvUH=MqVDpx+ytUE)&I%B4Rsv;44f2I~U@1cCK?r5n-V#Y>?2^iKK~?
z2mQnApBRVq!d6zudSQCv<E|JU@#qd7HX&HjL}5xwVS)I#_?#Y(1-nvegTVQq^TaXN
zZ?{~VZTMTW6OnphOk-oi83N~|{TeI61J2u|UoZI>(A9sJ*kF?QI5p5kb9X4^!?dT;
z0j0!$CjY#rwTfx%H<wO?z4JpC;E<wehM}t+o8VseA=T#2ZeET@NyLSSFlvXmg+{5Q
zebIOrwmrlrpT}Q8dNi}YFEktg2nQ_b?eZYWj58sg!8X_j5EthWPpK>j6;IU7006|<
zVEJkT<y=<6S=r)xwUP#%N&V%mnkK8wyl$HUZPuXxzy$;2N^(a&1Iy(6KUsLJ1^xft
z4kr_+X&13XUc7T8-}E(LuAPeZZ6ne}reW^Hg*&(2h%WZh>HXTyQ}*bD|Gfb(#Xukl
zL&;$r9lDVBj3<aHlaKW@Zeo%#Tk$fbTI&A)dzB7~PKV$jkG4-NsAaOGxf!vZdts?^
z%d?P=ryaHPXkx$QE%-$W?wfG2o^Y`z8BG*(p(;KF_2v?cXN~_omB;chpCuF}4%RDr
zN<I;<2}&K*#r#<_?w(VSD!B*pc#;69tD2;;--{U6x=rFenQTUA$rv$sEW~)kw)PeJ
z37@^v1+`#IfqnYv)3*#r6oSr`z;XV~-=B0ce=n96<(wz6G!V@My47LY^KEm@-tagd
zTq7s1uou-tj*J^pqsP9vWlyrv2e3`jkLDH>9`axu(e&r_(#>4abSM#=3JRCf^w3f(
z47J=+Kz7>}SZ>vW)(;NKG<i&fPJXhN?fQ(7I7_>C&>4QuB`7!cla}vWb06rBd92_V
zRv1Pt!MlgT)EZUq(V!IAE-K-^wcAt=6l?g3!WQX2s5Mq1oP_D}b_x@gp-|t%>k!#p
zwoxxK74v+L@D-AZV>vBEa0OS`+zew}FUi<@P{UwwZxXwE2Ji#iL;v%V(KL&pK0sXG
zAJWV8rQ0)3>`mC8;}e9Kc#&|tbfpI71HmM{h--16-KbiHWxt4^0fT~DXHFlgjHoRy
zsOl$5+iHG~Av>E8QZ{2+rpfN_=$VZ5Ijbqi#V`N{<BM0NXKJ_qBX7KGhFiE!HZ8$r
zjSS(%BdKfeF{Tj3qjp?Mu30AIKXa<bHt_xK!4;{iCa`;cPx>D123-jq4`V8qIV!T^
zeUD!1(Y@Dr<~eRpTJp1Yn$h$!+e?KbwZe&=ybBs^PH4E?`Kq`*XzszM-!%P_cRfea
z@Eljwgw>hNwVy96N)Cz9)Wx0Z$hlh&ND}Vam%8)64<4s###=rxg!4x+OWp*XXR5KT
z&M#pPVV?Xcy;Ce;1+u38=k)GJgWfA^0jvUw0wX;e;l^ZkoMZ+iH4=(ehJ_C)a{`@S
zdLBpPn*4gheuL4&D(vBoZj46Gg-O+4C?ur*YrxS`%ZywC{ntjDXr3YS56@I>hHx8A
zP0VMjVRIzhx%jL8uCeP2zV^ct<2#DNP)0FX2?=ajTM&DRIVBZoJ~0N-pXzWf<(bKz
zk}=JpNJvupK1k`G5!LQif|9VYVZ(Ex#bE!cfKyjfyvs(1H3QY_jLmbA7+Fkz#LlP~
z(*(#eok7lbWEnv#g0XJi@|h=c20#mea@+f6hSN*0ygHZf0ePo+rMjz%aSB)+6eI7{
za+i15uRCfWXO1rleG*yAz$q^rV24GN16L-L8BEcF<@>(>HhR{eyn#Y_y{_+F+zwDg
z|MWK=4D*8lV;tbohpN1A1%`GH%h=5t?%HEm5rfWTIAEJ}u$j<|%Cr&OIz`y`4sd?s
zML{t|QidXRzww0sgEu4S3Y>6>906T3tw=&szrEUMIefNM{Ne%2Mz=Xx1@>>PNgy<%
zf;D5R&5SXUYc+}-@1ZFq^p#6_Uwv-2b|-`B>yfuc#P^zTQwpO+rxNQsPhrxNZo1lN
zY@qvK5vD9lVnRJvJTdFYRFgzpAdvZk2>Q)<=A`>C(51tLs+H+amrqYU<l(c@6sg)$
z20%No!|vl7ROuq`&X0sl_o>1&0|Podo$$ntz1t6ltOzI%l*QiBG3mlfR0StRt}#>b
z#3Mu6S)}^tICpf(XzgRsEzL$@_rQ%i!Jj2Z71&o}2~Rb{UaU?CJysK~y7NLCMqg=u
z#vq=|j9F3w#u4OwJ&3!blthKHSuFcib|sIeM<E~Kdqz^OpS$yaS~0Qt6x%2-ac@pa
zPH(Clo0C;*L=I^!>(B-UAQ99{eD9RpK?&OV)<z#4bs_FWYYhJNq5Z~@bpQK{<+%<)
zE?taJBz_xWQwhkllqFKL7)7l__>SMc7QvlQw~_km8(EsD-Lm$T7EFML%m&jCK>0m4
zCf>gNs^7dv=Q{N%IH?M}N2F_6Vt$5`2e))RPa~cZXh1VmdJ^hsIR2YO<a1?y-1;CY
z9-`kB%l{WCORqR=mr_ld|4C0^l*UShSNnK?_ODu4;bq4JFT}eV0&{`qDeZKT$PgH|
zdz8A=)gVU~>FfG4V=k`3eDBgJd?YR>VPEHLV)hs}I^NFZS@WGj`w>Fu9bv0>71YQ!
zthO+9>#czhrB;L6`*$;des=^W&4lT#Sd!@V1s*TJW{|O$ICj3VIXNK{@6u!2zgJI2
z5;PL>K7s;xf(Fv@4iN(t<eN?GS;#E86Qo@>%7RV^U2a^pd_ZC@`ZOSQD6F9xb+68C
z+fe`JIS01Qzmas+$&3Ce{;q<I4^Vdgqkh@1k3g;XsHxhj86_*_-c($VpCZI%%KbK4
zAUjKcDBSVf`aoR&#3;5EpRq7`8c0Jx&op;2>~#`Xo%10w5iVbF&4JAw-EVyv=jgxv
zjndI~l-WY4YM%QY1NBiN$IjPiP#k!<7h;q#wy*PQGdXhim(36d8Y{#l!|@$ljW$7J
zD`kx$9=e*5G1g37gMN@V!<}Y=>x;52C&;X4sORN|f2Q(&xFUN{#b_fUT{DB}NR+BH
zfQN_q{Q(2nhQ2>}aB3r5dPucqaCS?D4`XewKEM5Lt;rWgR;_w_4-_5PY36f1ZyDF_
zG8yKaG<7)yH&u)VqXO}`U#AR{@e|6m*7E9l{;J8iZz^KMh=j;%J$%jh8zgq=$1hQC
z?r;>^>dlEU&YKrImdWsuYNi+6(hae<IvoggzdG-4a)LtL1BR;o4Kl)d@EyFQXE)=o
zW0c0##5r<y2+WTwYVO+@@DKgyi**ul3+?;0!y|I%b1|`H!H&JN$Z9i&h{+~0OhaS=
z6}h0@$?z}%RP$pN1I$%$QOv*T%_0-B5H#0MA$#xdp0*4Ea=C@^ddTB#sLt_=*#PQ8
z$Loxi9?E3_K@^fTDttH9Cc76ex9t8V8xjcrOUgeK<<>ybZqM>VV*S$7p<Pbe>h!+h
za)Z((vy3Y_Y$;wDB{q`a!FM;<;C0dhCtTt$7L$G(e<ZB4>9e(-5<y<|&-{3{ZtAoN
zgE)awNn{Yu-F87%W;11RSMXh#{c;l6bap;lA$_X~lX^}r?P=(XPKd8`hdq;iq!qoA
zrr@Dd*`or88C~EbJ<0Fp&obO8J&I-T4QV-X0>$+GU4wdB*H)hhUI9z|D|j$?n>zDR
z?0N!eaGK4@18ILqQG*CivAb<2&sZ!iy@U9X-!W!WR&v_imG@+psUAN;Sp`{v5td1B
zZeJ$)r^F{)&%aX2kX?;z3(K7Xc0qp(gGvyXS`}^o1U`G6qv-bQsu|cc-CVRws+ypp
zyqfMeCq*FzC~EB=(K*Khdmhc0&@MkItgE^bCM{SY9%+{v&&vz?oV3ie-Kfdf*P8--
zaB1iMt{wEKm$`&qClPcGKVO0c^u$Axk4v3E1rGcv;36Y~bRV2l%g5D;E4Aq|(xUZq
z*UMCm?l6wB-(el{9p>^=P9j5A2!B*HbIic*ok1Q+vi#u0O!iR8X(8!4-EVr&%TFOH
z=0XfxO%k-I$GBvd`|?oP`5z(PLL_r~U-r9b`UxZGUXm3+d2(FcC$)ENM#A9A-a3sj
z1mY6MQOLk%?*HDqb62^pI&Fc(Y_iYu>d}>7s0+N0p*=f_F;qTd<cFBcT3Ok=0e6l4
z&gXMzeD1qn_(H2>V7NiiD~x)7I|Rf$Q2G3+#M~B5|3h5l4{Bsr$5p>xss5XA<en}s
z;lt}pU6ZYPN9GA7`1avWe)1mR;-m)KMNntA?xsOh&WuD(SXRtapVo9BV40(~2Or-i
zDR*d2;!HwUq##O*C`zQRHiA><R?d80$jQmKnhOu%um8KdoD=;d@d+I^C1ZEF8GiD7
z3c;?+^C6AXMF=*DiU3nMB@s-g^+HexqOe!ifRPZ>SbUW%dypyc)2(&!`tln)U4f}I
z$?Kgqdz8tKXSDTxc@z8S;#hL9eM3S8zSp$`Wl$^6{+DUizRSRzBksy8_w(n3rls+}
zD4`lQ1sIVv_vR=CDcq7t3-gxA$F7SzpH~210&c16%=PWe2Y3`95~{I~3lb4CFBbnf
zq{_CP7@xBH4K6vpS=ZYCWLVcLst72yqCZpEQ;i2fkTO$m(%y1nTV0Jw!t$b>7%4Iu
z`@hhX<;DJ-_Z{Ippt2qjdq;^AOt)?w@7?DX|2zk+SNTdD&oTrdt>k3;2{e86bMWeh
z$1f!{m8V<_1aXF<qniU>XXdSC97%?aVXRNs?oBwcKpYI&uStF$kK_IH<(ZS@kU)dk
zl;tM_wdh|pl!dn4kFPY9=4xl2g;RxJH2|7kBPE1;$7AO;PpXQj|M2J017owx28Kl>
zXGRr0?Om4~E$K(75oygZ+UU7G3k*q$4ap%1{km}Dl3#RFt7=pPog~krpg@ru#Wz}J
zhTmKHllJ#UPaCtoYQ@&=PAMTyfsN}a99MQ0I(GNRZNmenVa+!-*EXK;rdF}}+9|uL
zNmDJL1Yw3r5F%b+Hh^1e9>u~w_MZE5lgQULc4D5VL@MXp+X%HHbM$_o@6O7<@Lg#N
zc^^cqY-m_1P=)-dKNGwN`&D}QCHiq$;1uSvPq`i|WbLNMDA(*=Jthykg%Hppa54;%
zcN-ZB2HXr>sNb%*_Jnz1^U7JLVE?$31^OJwZ$Cs-_*c$;hll<S90<bzbHCHalFT5m
zp_jzPI}nIe=%;^YF3v%G)4dVg{$o<Ze_0L0+NGK9i3HZdNIZxoM;4$VDBm+QL8W~0
z$tRY+#~iF-D@uVW1s*(!0%at`@7TV=4=p;W@!U0hc|(iui2wFJ8bDi{N=UAB9f>+d
z#$rBY0g&;GDkfE6xx=S$!t|dC(5;uwu(#D+f5P!GK-9!1>>pWs?_lESIQ58dL^cEO
zjtZFf>L@hZ6imT8HC$sc30FS5Ue<CvY1CS3{zkq1K6+^^4;Jpet=go8RZ+US`_&a@
zDr`!vg(#pV{Z}W0Dl1R_(`>ZELtP8}MZPq1>3j_V-*4NAOdl#+`Ut7e{&RBe*0P2v
z;99L^-)1QAa5m|+Lp+C%XKE54reUQrH~sd-44%HoTXg)r6SiZ%UM!3VR!F{`w9h=p
zcITp{L-g?|NEqvD4?$qbhX0$Ex|UqQR&6pB)MWTtA5aT0bnMq>T=e&A#9vQoh|F50
z9Lq&<<3{tp7phe+te<o^0FG6}%<8t-^moRN>t{(4{1MMwmTLPVYhn>|vZU$G*ozmD
zZY|7*wUiSx(BzJoIFQz^j5wspNGxee$@NNe{@Qv*I{)zT7zfb?Q6fxYT%aqEHAq>W
z?!p8H)An|7?#edGL;J(~`i`VfgyN@hr4`q(<dQfuTcggK7k)jDP8h#4B^!?kYMMT=
zd~lT;ejz7c87N1wU-STqeIB`vF8`MrziF?|NV2to^!-?T(v3f0I{g@Dmc6LIlY>~Y
zY^a=41z+X@?|;H^CQQ?1IeU89!$SW}`5S1DzsBBjr89%!P%6Ut4~FVzsHkX^U7c)v
zHFL<*7zp^Jx%Vi;bN}q@_X`F9AvYCki_^))6L^YJ;vsVZVds0AElE5IZoX$L7gmw6
zgl7xSNk3@I3uvJkDuz!ynG^o?PxZgSt3|{1BPfrDoe#l8>%oYd40x_f%St617p7(`
zU5<T)(fzC<3$lj+BU>~jW#Spp8gEm%whW@eIdXIK(zu%6upAJgjHa69Rr<VJAT|RV
zW@3Hx9UIp78K;R-9ei(-wrvDXPtO_sL-(IR{wKf$M@`A|^$9H6EcA)auGz=uIw&Q?
z6dBbH_VZ?9YfmAj{Sq{|^onj3=8$^iMMfuqz`)mB{OF|LGUx~QI+NK?q-(wn8JP+L
z?d~R#oQF>_!oR~75|O}=ogl}$7|H0nCx|-TB_`_UC2-7N(R3H7<(D3-&3HcO)IxgO
zBef7p!P0NhId%rf{q@Uyv`*BOfBWwa+WeRl7YBEQGMh{LH9mbC!Tt{ddY)`6uD)Lb
zw+*=7!kD;Ih{A{XRAN+;ML)<gPZ8=`$r#FoLF)9DB}g>~g)qre7rqVO=z!lFZ^fz8
zD-)0BLQX?V`1G?SM52=n57K;e?gPngHi(&cm+4f$K8W_)hhlXmeX?J0qkPhRwwuSc
zKZ1Gda|ff7YEr6d<n@OJI&21)FWs~rJN?}~<r#m#*47rPn?fnbH*(0axsc3^ml9@s
zPi9}T0s`n6@x3W@IxktkSYNVEgG+?}Y0K7BrcF!^;&zbgeEv>`PpVG!kEWB1+qVEc
z`QBN2$=rv=lwb2<lvNrIPmwnG6#SNQWZf11Rl@f_PSErG=yif10AO-2(&(cwn7K*H
z=)(Qq8*DfAPRZt*26w+6lSC(-Uj(79kQG*Nq{1VrjfH|lle=0j`hZbz2{-^g&d)Q#
zGM1YDB+%edC|~@f??Jzufnn`8d}=HA%}qS7-0056D35ZNS2EcwbvZ)H)S!;%n^pdf
zA>U9EC1ZI$Go`>-h-)?7L<Tb>tuF;+qVV>S;R&J0MCttQpz)p4f9md^%|BeUwv6q6
zJq=Bi&|I?ZMk2<(_4=syCQh!`gA?ZXUd%sz@zq`d>V6CU@+tXz!z0|v@(St=u623m
z*a#|wO-&6{G9gfa2FSb{=U3l&#8zNGsX*a)4F_+F^HvS2mmPc*fX45<+ikoDvKQ^?
z?k~!emi?3V`j{5mZ*13vGCL{77}Hy&*#!TTaOaAiCEAvT40!!}1WD`#xocSV)6!`x
zfw{_LxG~q|1cGj!>7I$YbH760OtHLbPWw=j)JQ>({>llD3=pQn_wTMz$r|A1=7+>-
z&71n{9~^heKb)fpD2&4r9mJDgZJdUMbtK?6vzi<Ohqv$^ao6r4lDRrkTv}ksw@fzh
z;JtgsYcrIXWM7|}N1u<;NpE*(@g81K#JP{Y1!{w3%st(<4-Jr8=Q(79fkTDF<aW`L
z|1eEUGXbw^=Bz7OFK@H{=K;oQi$~w!1^Z=lAQ3@Q`bLI^_zEs#R_QQKvV4jpf&>{O
zz|%2E)j;#@@e??h<;Hy9#3zot0=-b?rZ*a@4*Erek>S*Zh)eeLC9Yh(Cq`571@2{?
z>{5wPC2x%R#|SDu=y9Frf(B+=Nu$6fl=<25c|!to_HsLp5i4Tn(u^o|p+KtmZ`ms&
z*q8O_-E+N*I@x41!CTH5Sjc}`6iBHyp3FUo$tJfxS=x+a6W3N0HsssoYEDemH2ymN
zhy|S~(IFn+7ZkVNt8$&&hPUbj*)SVuE}~a^DTMPT$jpAH=rOb9T>-sV-A-oX5AY5P
zf%&`+Tckx#egfS{h#3q4KKO9%<};%qdB;CIXFd?ymj3yjU%@PiGo@;?`I@xf1@P2J
z7iVNN@H`t|uDN@yX%EECWYutkE<r-Hdt#4pyH=kC#a-r-nDly+Yx7f3j9Bl#HD~8P
zbB1WI*GCOuetlxf>7Han`>cr?bB~%OXvXrdD<j1he||PO_K<(T^f$83ZQ|li?M9=R
zDeNJl5>;90Qdn|aT6z81>dFDO=+djDq|O>mdufWcnvCJ~@U1q`tWp`)0;;0GfeG;7
zO21?>+s8g=nK68A?&Xz5K?2dIue|HaVZOsi0jsp!y0sSsDX%Vbi@iS>+H)}`10wAs
z6Dxxto$Y;oT^eF?hX_UKgMkpo@6kmgDUz34vA*vul2$HX-*Y{;e|Bdtn~Nin@?_8{
z`i(pkSV<63&C^quY5lGjt!Mv6L$uF+`PALd7gJ`Z8<>z6>pvVW@gZ~Xj_2`K{MWON
zs87G(iqoJrQt7pp*5!{Do<X~Nlf-ME*Ip|K>6{PZLkKA|HtQNo9uhfm;-8d5pkT7x
zwo8iw12+P*Ys9qy!y?lSj4!l6R2cMb|5O8uvD*m|kuIy12Ur!uDX4&oaHVDH{D^gf
z#=wUzm$i()!vu%C_;VS>m0_!+Bb5pEL_rBxf2wIxsyMI*M0oV{kKU(S95TWef#aEe
zPDGW!R=+25SG;X;v`)N7s(c1&G72g%n{A82B>T0kWfH+!p#wL_vi%^6dLUjT<&9=p
zhIq$O5OF6XRecxjYNvS#*tDeLZKP5Pc`rcRsG1M#ke-ZFfPHCL-mJ*LXF~WI8UBpr
z<Z$y_9N*j2!LfcODp=Rc>E&J~LK}PReb$@Clgr1oEJfw%dwHH4>NfpfHOrgXNk9B>
zB}z|6c>^mM)iBuzLN4=D8tTYT^5p?Ea|P$<?^KU8SCj+(lFt7Zga5&Xi15%!_Sw}R
zq!js2$u-5=sce1?|LIyKZSK-?Z5sqtGdMBi?}r7GLrTX+X(5gFD?~nAn+KOJAZsxy
z=y3agij<A6St~ZewSsFeh4HCo7^EFC&HxLO5)T%&p|bABd=w8{Xwv~n=P+VQPJr5H
zTlLwb0i~()F(6G9m;%?!zWwnVEYfWKo8ccV%hbTvr;}viDg&*WJO)!NAv<SMnL@l+
zQ``7sPBZwA@^hJ&uXBSR&_jy8*kbg+hT&jJGpHcRlW);EZm;*V3i$7s*w37L`0+R0
z0@J?7cJ+7E$i^zlOyHsjebc{#>>kNA;KRg?_@Bl5)8Bkjy|yL(s+zt0Xj}Q+dgl1%
ze3(O|W_iksuYOM7E_@%)=!{8t$q+Bl!5n1(W>HwhgA~$Rv+cf@K;*?&zkj<^S!aux
z^ZNKd!=#Ld3vX@>2(~`$rUDDhnMzwTZ(e^IbWw$-=&EP%>O`9I=wN7A{;?JxZ6`w`
zp%ke~0AqwI`-q((DyZK1z<U1OY*}-2b19&DC0bgdR_M$#z6W5kJmfJ$*<uH748D2w
z02~R!>S!6*9;q?ei|UD50VjihSBdo~@&_F&XfH1$3YgbY1UrPazp75$AC%XJM}f<B
zp0gEr<=UhW*@q%*Lbj(jo;&`WNFd)#H3QZ0U35-}V_p5cmpn8SBF1Q>XJWYRuD<+4
zMuo!rxgf&14Km*Y5wPSW5In%<QBKMPmRg&fCt~j~*%^#G5w)uN!>~HZfREVi?&oHC
zk*!5Sqjv05wr&3Z{hn+!krMJoEc9#nLCaLrQLV;E;s^sUKu>16jt3f`+0USTUrM|t
zZZCN;!G(Sa$2RumsD4ovqEevORnsjc1eW7A)2M;Mg&ubUFHQ=7S*NG!i(Y!s3Ehf%
zhphY)K;5#H680?ovnhCtzG}Z>|JK9cM88Mj_%E~FyQF;ec7GAGlaq=mgmxI`cSR9n
zlK$^^*Yz&6fQ>COiB6Dz`yJUUdm;HrxufSP@0uT}Yz`AN)oO5Z>BG3M5`9HwXPhdt
zqSR>VrsIpO-Dmcm`M`<(A|D4-CtU#=j~^KMTHlWU4rS&}&y9|{T5t5_vc{5daKWER
zn|pZPI2u^xVnVP{)^KXBxlFl6&tW_i42=8F88QWjeYelt`BZ{b2uj@FSTNyqRQGzW
zK;j!NpcAupF@uI3RnorQi>^?6UpddRC!J{NMg8^r{bOMcO{@(}7^9VejzOu??Dair
z7}925MgK%NYna#JYj4G~lg}g_unYB&hPnJaf*Jw<RR_%caJdp6_~eCVNk3bxIQZd}
z6)&&|gLAQ+>c#oTSK3~uh3S%Bu5=yWNC?XtAV`G=&PC@@Ig^+g{6X!g`V{lfmM7Sx
zUm#W5KpGq#6;92uAomhNGmP6BefqdW%h4Jyg{8T2$)A&d>dV@X)NjnDnMqsus&A#D
zXtTcD_+uk-mFkEm>!&)+yB^D#G=8ywMs@Jpc<zUpujhrukdPaVYQ|Y*vV+g%S?6lH
z%isdHkm3PqPtKNYc)Npl#9a&F<dw3GesGzZ2{YC0>4kY+2HKI2(tTs;U1DfX)WKO0
zB=Kw651-ZLx}=D%g6-<P?$$&>jh=)H=|vxI_fP%sJ}yVio#3`^q9gWeg*#t#5&{7x
z)E_9*$?fJ&9{J{2-HJ{g1y@W3`R}E)y%93dkmKmq9~nUm1pDm<UO66af3-wnEo~WJ
z16LTl_G%LXrW9V2n#P{5xFj>nm__jF@4nI%P(t^+@7+JFVy9#0obX~nC~C6%;TUcT
zUR=wSlqg^i;CATO<u&Ve7N~S>frx&)jRHiv{s>inN?@G>NLMyZl=`%_XFJdQ3E*eQ
z39U7{JRU#ftSml+fZcg*>x~cVmB7HTyWbFIKW@&wBnxHs*pr~=X!2dlaaTfj>=Tc_
zF;+YH!S8~&*F%lAW(>D~qcBV%(d^Lrtrx@rv6Eu+hF3kjZ;x*jlb2Z%oh=R?LS;x9
zk>gn)Vbyz7TRM%`;Y1;kyT|Hv`NkoA>1aokzxaiX@jVOE!U~O|;LFSIm-9ZY4?GzC
znf2ZO4Nt=K)2&l#*4j@L`(BVkIsyxo8fy}QxXjGW#}EXt%GK_Ott|V#$1KS{x8-Bu
zY`~wnwI>jcC6cznUCB4)Bk3&W_x<x18Z8Ure!vpw52F5~!^rW$x^vJ5hb05JV7j3F
zQ>^{wO4<nolV6!6v{IQu4C5r4sItV{3kyYJ4qW_)2&o=Lh<`+ejd;LNfmouax10p3
zW_<GITWPf`%eGu_s%#Fn_VzHVBtm~jH<?Gclir6+OaxISv1OX49&I2Zli6VBh~zh|
z_;&}CYuuse|Ij3R@#>WfxLSwG#n_7++mjQnT0utIG74Z56HE>J1=~n(?z*r>ZencF
zwA-k_bv>;HHAxvuh>3wTjC)A^I@YLZb5}lGVB{MCU|AxIRQwClR{r%MFuIc2b4UK)
z%3roaTf|?}G@|uK2#@9$x-6`hjhdgz1V#`P!;##D4~3ySU-f6imAyTPpe|Nji--RW
z{1q5L$wux5URNE?6iSk6HGG=TK^+<Ia7;)ZeNLzH-;HWMCsyzE&&KPdY_dL@2F)5e
zD`KV2D^sZCCwDZ-*cl}~&|6GQ0w&@#5c%3<HXH7_kWRC29T$G9&DksPZ23ymvc&Ug
zPY{h$QW^^=EU|{az+M2q{}Kv6OiyzXg-|63>1im@6E4G>aii5jxjpR~!2C{E%Q3zG
z#tfYX`-(q*UC9_<Z!7`+WucmO)f;%v`Z<muggqZ2Ef0m=upjRRPXAVNwehvt%=b_!
zgb^{mR?W;fy^!RxjxR;6Q_p%?#1CTOP!<EA`9^?`wpk+L=T{?GuR_$G(Vq@%PC&W%
z^pM;cWpOp3m?372{`a?`<iz#gA^*~x&Q*ME`JvZ{5CTl&yxH#764_&6!94pRg<ddU
zD%RuyH>dC2a1#@BznQB->|Lg?p{t}pBz>%Y?nmwNv8`9R*G0R}^!ycgD#q=xFw8bi
z!bujL5m22fLs<}Z*oaP`NCejTJ}WAEhdZM51oM1TlI7p!xhL78PKRyp1#NSMn#jI7
z?%wW0CIQYaN8=&FqL6sGIGOWz;Q9z(Vps2tb6z<rIj9jAa+{(1<!NehtOd^*aBs+v
z5JZdLgZ6xJk5p@BP*pqyOE{AD=r#{W1+7j!6Cg?nkIOM+bwo^Q)`e#)lkpv~e39<s
z%SC68jcUo~D7yJA4Ar_;`-034R&k@MBHlgg^#pFIMOeojnwQK>{bW~k$=D84<qOFK
z=^oX_(wTr<OdgJ2f&?a&1DZjU#md{szjaZ9j<KKn#ypgdVl-|L1z!%v+c9Fw-A16=
zH%>hZ8Ft4ujIJE|OmV?BmYjB`n*l0>h1?T9Da(^JStT2o(Ttt*U5h8ZbqhX>*AJZJ
zWUERi9<S6O3wMML0LZPD_VO5s*T%+EcKfm9b>CNcyw4N(EQ1_Hx(HA`___c{Ce{L+
z%;YYbm5&TfQxIVMGL?B~NwP>Ep<3Y))EheZ>qD(3i!;5sb;FMngvH+vpua5_c3lno
zjNxE0T1x4!g8Y2MR{2^!N+2ferR}|2rfj`CC_&Q~g9PRVh_ipPnPQy|rtxH{+fJhY
zCTkj9z|T7C<)4aoR<Zht8gIjcCQd{?Oh--Ill7ZW;R}-yL07Sn3d-$}$nnl8S$Wcz
z<B<B=pTj31e@v+PP#89{v398j!##Q@G@IqO*=W?jd$sb}#MQr!iAYqh$(zpy3eUf`
z76cLh)jidQ;v|_{M-z6ia2StK0&5fP{!}M8jKH?dmy;$y0}$sawREzV4Fc9L$o|8A
zoLai0n`-Q<V;^NB@K-*8H8jyoDoB@%mf{2Gas1@lg!D=bvD&rQed&whxb_xDgS-G4
z4k^}&5d*Ktekp$%P-{<`4dtG3O1yKte)95Y^NU(7?foH&n&Q;UzLAZp!>5id(#BnQ
zqb3O93Akok_clox1*mI#<Jl1u5qs~kQ4g*Y-$;uh#!JT#8PHFiM(Yim-Hl!aPyoJx
z0>qf9!an?zS|Y(<=QCNElB#KevQO$9AkU*2fhmX=W@>#)@biEhssTu`<>VG$8PLuB
z{vV=qa1o}Wr2e7uL;_FK9Jdo4@)&b5jv?Dj6DQ@<r|>OKa#I~>CeAUHpfTNTeVWH3
z=MNv_W$<5Ldq_%qG3nYjaO&fUFmZJn7}x%1yOyYeRghJzL{W25DD+l4LmlC2R)9qc
zItO*Vn(GwEb1o3i#USky`4bYz`lX*w<MN-HWK+3p7eyF>bM{N74Es4fnm>En<%P-m
z2?ZEhnQHizK0siAWEgcBw}}=T!<o+S-K&}^1sP11s|>xX@G0F7^eD+-77l;__driQ
zrIIf=QfPe78(Anv{u#9s)6ObT*NTQZW99X=jTUC&W8GU$k`!~VKUoMv#O5r6mX&B#
zPRC?nAGW*8LY>}F_`FprWhF~1bv(fAB8ez;xk&a`5B)GNX5D9{(kp3XkY-kGsu_10
zBheymy=S=~Zus9rQOQ3me%`eiS_~pX=%>B|W9!Btp&FK0_BIFgq%H>$XR&>@W)3%_
zshpqRrOa|u?r;lF-AqE0{*{v0V?}NUzYabm0W!cKndsPgf=Fx5jtS(2nQ^Q9`C)n#
zFIt|lSeJppzd-p<0YDbVCtsnU0ZGnJdS?8{O^f1bACQjG-M|K(b<)TbyPo_J{763e
z=?CMTeEo_Q+@zTwG(%1WtA&QdUd586dF6r3kT(jI5L+jPfOb0KuE)D(WCfj`BGr)+
ziH2#19N~I1R5w0wFKc@m+qgqoV-~4%1UP?8-{G@k&`dbIOlTUnub%yW*@!Mi4Y3Lr
z4e&VIcB6FfmfSKz&3x#V`Vi*MeOrI-yF{tsT<2PnaD2lbwTVw}V4avg=^{TnfQRa&
z$OWB8$n<O8XkPpM1+O1nIs4mB#a;Cjde={oa(z0#d8*=tJI02Dp?XJNT$jLMQi(}R
zsTSB~9fn1$@)&vPtJM0cfOW!*v8m%1!tA9K;1xu0%yVKDyQkz5^6n=GPMv%<i7bf7
zEu3&d1chO+?fHZ2$RE`mZ*5+o)5iwC_$F_4%8z%31Uz1{ECkzPOCiB;U2R@n**$N9
z16Ul)bJAHEhF^Ka0Rg6lYsNF?1ZPvM;Fl|bnGcr+bRqM#xN4)fuVx1^wWs$x;JE^4
z{-g&B_~+X|+$EGa3=9<apQmKV{uR#*p@SFn*FEEQ5|IkSUkv~r6M-H1(;hHtidWIu
zS{5eux_T?;RqO~vqylWhN*a3BBRuq!i8D4~#|XklQQ$I@lSM=_8S3)d)Mv16oq#}Z
z^DTT|QYsXQ)HJg6MHgd9gOl0!D(BIH3OPg&11-_+T<k6*48=j7KH|kHMc;2ofHLNE
z1qJ9!Okf16;$__B4&*5U0}j>Ib}LZMoKDYIQXVu!o{$WLy>}8QNg!Kn@0#*$5(_O}
z!fq$gc)hsUu;6%^g^MaL8^8P*>DQ1Co1h{EyhtF}&s00+HW`2-(Bq!ep@*IB8E~mR
zH_s=@)X-ccK><3EENVm&DqVr@oMB3JMMFL#!nz}_s4ypry7vPrj+lNcizX#<!&3mh
zlD3a1Wy_o|WmWClz&urL9aBIjeweOuDH!;bFZ5obKZZAld5mdXDxn|bNBasSs9CK2
z5m%r43ct9%;n$nrZ`h}Az;73;!*TO;_SA{XdVOzqFI3dyGcp)R(mU7j$K3mj1@;C}
zZ0IcCrqGX$CP$?LY9?<6FNk=K7>=FvmXVRiZNB@JIihJ)@vgFRsGV#Q=@vvBv=Iit
z1v~L!ybWa$U2mv&iHS*3R$B?+crY5)>0_irB4~cL2x+iSd|!>>I@k9jsu{NYMKn4Q
zkWDa>vj6~WcmH?Yut{s_r6*n(VMY_^;6v3^{;e(2`98+sWp!>9UH13C3~6<7wMB4=
zz5pji$VN=mshKfr0oc9k+HnCZ;kPh!4<P880LpMXh_gVegx-A6`J48`mg$CITAH2U
ze&oHKK2cWV>IUGDnpBl=+{2q!5RZ1DxR{l%LdmsZZMu?ovQ<s4dTBFMZ~F=zOGshe
zny85p2507NzCZQc$CBY^df$z1QtybmQx%gP>+c;|M8DFzlaGlzGh><P>@GX$8YSPp
zyU`|`fy3B?F)>nj+95V_8k_9yhUVy{Q`L?~=h<}|9%-W@c2V&PYonRKkScqTBBZDP
z9nHkOyDZc*TROEn%eN@=x88Nr%%Vx+t<v4-J}sL6D~f6@L3*nUxZ9Dd!1v0LL_K)o
z2L=j^bll_yv(eUWeeX*K+luAwGZ6r(-CCTNlvxtPWrDR~BIyG@YUQcMA4Xbd)q}5d
zj4G<KM(#eNw}=&=Xh5~E7km^Iq88J20H)Kk3+jV^%mhvGN=y`k(|$;OV~8om9%%r0
z))u&Q-#UTbAu(c}No1-sGb*|vp13nOL{)lL6PUPTUVrz8xBf3fv4Om{Vd!J2Fay@C
z#giUOyTc)Z|2y7?i0=Av(_Cw9uj?o9afM_zG0f_f@I3pYC~mi{HY4h}3L~%Np6fCS
zUp9^Kg{Vfe8RU=ekJTa>P?L;nfSkD%5@uUeXX<V5rUx}s4JLI(DrbN{)*W#<!3b^-
zntf|eYf0c@{4JeKx(m?hL&urDhpuxc{z+;cI^l$)YR-Cys;E@*r8m7LGf44}CJOEH
zWGrj|8{7*@7g^1ZmaUB<)JWdx>+$Q-f1>(}%JKA7VCj|ys|Tg+3v-xHee@C;UO9%@
z|9Aa@;xt-BH?gVUj;LhtXMl`^LCUtM*iOj2lzl`G3&dL)6cet#s(SfHEF0zMk`vc&
zqLl$>4IHwQC`|&G1odJ;y5>R0w}~prQef((N7+NqsKqBX3!uF6PHnJfN*`n+H(Bq9
zUC&kLRzX}Jf1D$$t4sUuK9heFc^q*f0M*4?T)*&IW|K5HH?t>K<q7}@8r(6Gf&tR`
z>&re{`XNJay&lxvN_wgNU-2&AtKVC#D&?4&s`|_q8+7m&KP%S*)QG%z1d(Pr<!%YX
zl3-fVOL1Jisp?RXxqCNBf;D4jbdzHkOr(nJa|}&((2nE$lI4jCve4&rszxQhgIiI}
zT7t#>a&l8Za9HJ&3u13(w_e5&W8K#}*Xmv^hnPw=-<TZ1MozN#D-ZMAL0`dV8bj?$
zE61qGdnOb~xlL;t47d5zjzgVjkpBJQE!J1aEo(|FV)9b%yGMFB8b_;`tGH8I*rVAc
zk$>SIqlS)vH=fuTY_b>XSBF{J8!jzWv4{4~TYL-u?Adf0x^^KH+|7HQP}Ys1(DYN|
z76AF-f5yTrlFR8th&}DxlL6(tn=}M5RF;`-s>2h`pXmM+iQ(gT8&k09@vn{Jro8Ee
zK=Jr<VsswD&aZ|!GlBg!<`paw>(x~#74Cg5?jCR(Jc}l=V@#WplpO9|?TPHMJeK>@
zJ0BxQqZ$WHzlj@3hJ_6iwMLL7(A4{YWY(eQAd~7hEN_-X7Egwi#Kr;h9DCSYMhe34
z=R%7lefQvE5F!tCe!rNc3_EAO@k^*UE%a{d;MlhlRZu>5e%kd5fhN=L<_KP$%wNH+
z((hi%SPtNt;L@3pETBDv@9~G$CjMdHJY0>uGv2r{%xy%PyYI`_&03?fQD}6_{!9^u
zLTBK=ngVh75`2%XPk9)qy<7pBHIfD)udno+m{a1en!78QxS5oh!qQ8bC<54K#BfRG
zhtf5>gYvT-=LvRO{bh@(^CwGR!FMk6R;psL@aM@_mn!+Zo@&19FC8nLB>G;tw$Q(Q
z)N0Xr4>VU@;MNy8yR6E10I)pRk~04}7;t`x*MHBgS@9LEy_s()9ci_9bKxq)cCUUZ
z?Qbt74y{FEsCA}jh@~ZdG0<XXN_Nw?r9OVvE!o}wL(_SOv;DpQKOu;n(Aq0@jas!;
z>`|*jtXj2;+G-0C#3)LO+TE?Kt=68gis~>r%vddLC1w!vd-eVK{;rG5mA~Y5&Uu}4
zpZmU_k0+ClasTVhQx<)w6xMEwiMwY=h7)|Gfcc=5pFSjz1#XIa|LFdG4V=wg^~fgq
zV$5p{uH}YqjT7S?812rc8vw9#W)lB3ms}Gz=Wds|mU@Qa+SP?4mf!98u?zrntF5ze
zis>a)F>Kr(V*|tEW!~EL0hPEH&Ud74sdO-c;o-`E-FvUGyvsoIuDT%`C;||DU#Ni7
zi)SXHL44`kVO5@4%nUhf@YD-EeQ(AOcP<7PGJaMgoRZ{sGO1}GJG!(h`kIb2Gf=RI
z5rmB4gq0!>?6IJ`+hK+drTD@&N}0rZ=7yzS^*G<pkyEh?cEa?!@fK|q(-r&(u{v4t
zIijd2m**Wd7YE0i+O?UCIdOF>pxCLL@vcLB#dAfyY_G-N2kMDW`$r7`xpx)QVgXgR
z%RKvlt%Y)AMfc)!R*^KITlcdpy$wY^L5k5VxFC3<yax02uMxwyY0uf<9^KBl$DRs`
zeJd|j@UHedH)PvrYZT0)4I!rEF99RAt}vE@-(@TbMN7e$ngG3tB83y@N7UXV>BTBo
zNRNm_z+%;O2{{Ya>;X<^p~Xyv0r1=ZRlA3x(J{YHU!zZ^*p*k-c05<=yDrJ)5v-=n
zagoz!Z?jX?k2uLdy=0#f*X=BUnhNs}$J;BQ(w!k&FX?@#3ijM55ia*sAv{;bMXalv
z*qV<wy7)?p7>;Gjyr~4RvHdkzB0=Fztw|G)-coOTb6u3v)ll9p#vcOL73rJ$@`+mv
z#(|C688$T{sdJX+qUSp}vxoQi3YRKZ7yD~G9|+}>gC&st?Kvy@G5O%FZ|L2lXO%BL
zIYv-d3Z|RrCYm!=@$uiM!hH){Yf#&fu864syv5Meo^yar0ZhS(PavDpR$H86*MjPg
z%A#^orQ`$RC;dm_OKNBH4M~vd)AMF~lYV8+uCP1(JhjD!gk=&9ndiCOY|oYJk7g94
zO0#~^ypwAT?&isHs@Hca7+FAN%#7c(C$yP!oT0)|dv5Xp_?6|K)y<c(#JRagF<y<k
zQ^{3-K|Vn@2Tlk=%(5P`al(5KkYr%gJtWs26_AVXG7Cfh@(g;gs+k4g&7|<*QBH$9
z(H~lH7D?|&iL2Sn@d~Oc-FO-Y!IN`;&e^_OcGJk(N4-tFO8#}=RlOBlRK%Q%VTTIN
z?qawj6-PbSH&x9P(WE@&>T7*)qGv$VDfQ^Dfqz?=eN3mt_;rJqk(*00)lT(-A>app
z+l#2w+}nw0m(!N68at}9?ZOwgk{Z<LV3_Rpi!*i-fXykC|8K7P52^yM-P`hB#L|p_
zNYrg?8l;0tmd!wxME>-AstX*vvo`0IzRsj>184=xUE#t{e<DZgOtz<6inuw%&ddt<
zZDjz$XOd2K015}WXb<f$@-pIDMuxMzLz-!2eD&^%!L)b|Sv~TQ#5zqq;G~AX)~E|9
z1nn0!J>zJX>rLwOO;EHtxIfcRbk#0ye3<cg>iu`AK@`)bJ>68jk0dGn9Lqahw4CC-
zo4fo4aaS6PJ$g2a_N?QUG{>&}9pc$&TbX{AQHr`6ertf7MLnP2fZYSM-lgVJL`UpG
z;EfhN=aAna^KD8YWEFKG6_>2}n`KMIS2eyYiDiyyWE>DO@VW`);aj7t+3(lX`d?^&
zMFbx7KeYcSq09JCeeV8`+dkQcZe3P(SdU6Lfpt>5kXktBo<a}r{jA3_{=u@FD!6QN
zG<`soyUB2XD}@ti62u?aJyNa|7$akD6t3SNi2fyFX{`HG*#>XH&GUS&qTK#$deN6E
zPur@i5F1yWVDZZ3R!zFKslN>x1}BS9;WrBtO&G>}D#7m%nORe&odho}D^p<B@sr(@
zjHA+PL{nF)*Oqc<`4{!a3H&rtmEVhmjvA;%t_qpeN9N~6ry{F49yS;)u}7))>cTY&
zoJ9P)$RBQG=w8b+-)?RfNo^YR9QRb|*zSUQCc9PmnpMKid@3++LsQIBxq-Ir9z9=O
z1vo(?`;38(jT)+&ywRY-S7(8%HM{h7)8V(CXxgLC+hJh@BRb87K?5e5z76o2i5K{!
zE5(M~MHn7D2V@S+*T%%z79p&tD^zMo)EiGeD*8K`Vk#d=nnMLREkM7DSSGB}m_}a2
z(lZKsB?oObxS0yeE;p~zxb5}Isy1L8vvO9}tM@#dEi+fQJ&dP2?Kd&Pk`Y~p9X=I2
z`%pJ8pmRB>w&G?O3*z_jGD$!$9W^LinYq#Sl0oZDyji+hOuW~bEjWH05DfVodW3dx
zE#eNF73rGMZ$HC7eHL(uYB~5aLDXM%e>rGkD5l~rh+DFx_<R7!Q*@z?(QGdy<EJ8B
zNs?1{5%}nIr<Yp0m21^?1fgbvY)K(C9(G$<lZN>))<zmPtns+H?8Ffg%OTRcKur}H
zV5!_}G8_rp9!{o5TL2cr&K=+1KEb<+ik~LNBeJI+#v23TtF?N95_n7lk)SH6z;4q(
zuJ}=+F)=m5(X|<*UW&3GNg9YoM5WI_3J^kS42PBJgNEauN|Y|^>)KDZ)!L+Tljf-u
z^CxLpI9C#lf4SZJCXO&GwnSGkMr1G6%X)%s!gkMaXub|H`h~OCgpYI5wQMeV^85L<
z2ZP??*3#rwn|@I)O9&l#*0lHbCnMfM@btqG9UXZ8ff?1__0HOqZCR;=vJL;38I$<@
zTO}zug3-vOb8G7^13KT`u6`<SAaNp~jb%W%bXs$^SyPiDU1iY{YCjZ5EhwzP!5>HC
zCY(8(zVt7Zuu9*Iy2NeBUgmo;{pRdt&f~Hz!Bv;KEh?OVI1e~%yu>EL27F$H?Om<R
zUE6q$*P2-p;#6tBqWsx|QsC%PvE8qjRGHt5TauY>t}JXD&_yGq4m)O6r=BHlWT~rq
zZF@*^zN8M0L22$OT{MM&IWZmp$VsN-;jUdXefR0gN!W}%fYHkq#~TY8t4XY$O$&FG
zgm0k^Z`B9g^2dAr$`7~ewlg1@GBF~M5Hj^Ot`bvG84};|f|Hk@tLYfo1NE~`ktncm
zS@OJVu;7<<#g11s)KRH11g`6M{u|iZTtHFv<4t(F5FE!8O_Fu65WdUUP94umDz{>Q
z&ubpiKVEewi3X@XAENuV#)^BovinobqUcT>DS`L3YSBd!W@*NDc(!viB~(|u(6B&f
zwz)3MBJ%L<%<4v$7?85b9Gt11EaQk)>R5{s^2XEXvIagK0cfz!*qG>SsnyluxIP5y
zj{hqxv9w^PVd`gxnv(Gm9T~wlJR5#O?T$3dydcJnW=H+$(v7H%tT-E`t)~Z~b(`81
zWaE=}{RyHlVq{Va&nF>1w*M4Qd2$aiHK?3-=^hA_?U5A%Tw(4-oTIJ4nLWyXbm5U=
zgdP{oRR(=fo(PB$U~b(NRG#mwiMP)z-rs9>`7o0NqHQ8J`^(_irw)r`F7>H;rk!=!
zI{MXDOf%&GdSR~zYCLNT0?DD=8y%mRHQR&elg@%@7C~Gf1`y~Xt9}U$pm*gY#M>;f
zlPgbFpAu6K;>Dt(j_c5rOBDo^hn*$jpIDV*CX&YS{jj=hy?T-fYNqs6I8tkp@n&TO
zrxfl^dhoMt+K!R_Hr-q0-*!rF)u=2D$d%2DcCAoCNK5jl=#aTGgJ#&X;Zzd%9P;aC
zMu`cFFW%K(fqIItLnPL@;D?nqJGAVPH3?Jk5Ky)a0SWxeQ`N}5hPnj*wiz6-ay=A;
z{GK`04)x1)*6bZmCs04jndRc}zuGFPhmy~ojphT1rghgh7VM7Roo;lK6xY?xWC;`I
zVVL&~sh>xpTJ0181N506sil>H>bjyr@2S-kgGS0Ff*pC-^&@zN{kt93uG<DB(4!H9
zEfdk8e|Am!H*`PgD3HO@NVmm;O<Yg1&sl<2`<3MD&TpI!T>jM7JHO5V-;^Tr{Oym4
zhJ{l^G|KdQrCa;nF`)Ma7H7is#WYW$dW|HT;uOySJ7I#pyglkGQSaa^`Jeu`asp4W
z$@o_SiaDg)n3lc|^!*UH(-I{g8DalG#i6t^@Xt#^8R%$fo}cC&r$EQuw(Ykip2OG8
zDAYjc{%*5fiCd>tJcXE4ne{~b@4Fu_ro}1=@s_XM%6GPzr<<6eMgx&3Mjq~atSzw4
z<DS6>?m`>h*}#jTU6ZCBXc3d9z);c>wxy$_M$18*dxf()G&0F(9Tk4-A#dqR64m)U
za+5#5y6O22spEUYh*>y#?lpmZomfddwZUrSc(wuGJH$}1&#79bT8fh(CR0;u&0#S7
zaSv~Ss>X+^kKYXC5L~9a(e)7DE6J>gptZC9+`xPJtp6>r>}7cUyb;5JTX*$ghe!BO
zG=4F-Hc91{H~-+BR2>hq`_%NvY+Z!kid(;#LcjSM3?9#SS#a_wAyF}oSLc-DS6Xcu
zPrnG(lpjb<Z+oTVjR=B~Ff@{XzDA?Yw_ky?s5+a;-J>=5<ihS3m#OG75g!x6QK|A>
zHD<hhY`$>D#_-2eQ2=x5(b}Taq3r{kfQcjSuoMfq*0_~Avc#X6@)KE|cTT-%2C`w~
zol7g9%e{Qee)bMT;)|$b9fW~wO0PIfJEz<Zt}Dc7B)$fF&~DC<2ib=_gqn}=oG5z?
z^vfZ&C^icpKXpMVCGsZw1g-+AI#MEs9KT~k_c*VCR|k11<E}7g--kb(eN+{XJz=+r
zdfDtxh`InVCiTE7?wdODzZ4GL=i*K`8(>bG_#&qcQydN-T}gS%F3!p!&N0x#YAsu1
zF?T*06z$|`oH~)SRHazxPgi=TsftI2jmm3$K$W+z#3D1eEi6zX9pz2T4q3njnoxt9
zx<W0fdAteu)MwxZ!cn1RQ`IDd5SwU^Qr;r_r=KSgw4Kg7rF@!0#H{F)#7=;@2FSXB
zR2@F@+HHY=wSLLPSvPKl+`dm57Z^ZR{p<s>eT>w!+6KWTX5?3|8lv3CP*n(c@nGS~
zScTXspj*w+QMBqi=0n{qjpE!OkF=)kQptvurcy#*K&MwV6##_5A_c4*otqED>|EEY
zRmbzsZVxH7;<`BM{9fs)ut0$XSQfknD8ZDX0E9<|^JXQ0C4n_DtYLK!<j!X`Ch{H;
zQTA{+s(O>HMbwdh4-M1-OOq>xTt<(s;*IxQq=?T^0&4W<Q+)(~)#s7&Jbu~*qB>$7
zE>Y=<@ryVRMD7+|T`}oJnHc?08S^bXwejErA)300!gaY^s3}O2W;pqqcxLLF!Oumd
zXZ8tEt2@`M?bRm36=El6JMzd9U$5L%$-KbCWycq#yXZMKSiB*EEJe@>ua>GhPtD*r
z%mOp$p6+G5xGT&(`QS-D=R#yKc7d83we^iOIUG<}ljl)$xu}T;Ew9VV#f=X@p&W|v
zG5-iCm3QzVxEwKOsVA*Z553aNIN{DyQv_j@v#}%#56xs4mB;MEZ#DXD{$}lb@4$ly
zQ}%-la<Z;upy`6`j6}rDc#R)#Yi;`Zn=$d83OGO+EG~<U!HK1w*uw9ywWc~UO~g}E
zWf{cs9eCHCzjU16?fv$lRW&`<UKpQ2Kmv{-)eWT=SXs*KsxKxkPHN3nC<pTG7(q}2
z8LB;SO7;udZx4usLThh<Z-mHIm66w#@V%D=NLDFVG9dCCd}`)k@RDsiY|n89o>l>P
zy!?Bj381YhHG3y)INce*nhn%FS<+c>u{HhMd>9@%!@2hK?!%(YDZ8Mi=y83iYuoo&
z9cLSuV?}ln32S|JQBj38GKBN~p+e;Mbpb2}%qVp_*R(smx+%!5znr%ksB8V9l1bem
zLTjEpuA(+8n9n5DyW+%!@#=;62MX+{Qkt&)0N;z}iSr)J0j~myI&K0wF$E-5kw;e9
zpClMR?WG4Mx86=*4vnqfLlN|iZzYTF+Ix&%fk_6*Hsz8FQ09;sm*rOjX0bH3y;~x6
z=lm!aBNwQ2*Q8pL+Y9>0BP5>38A=tZlQ%}ilwcL2h5*I}sPX5*2|A~d*d_=djR?Nr
z7CV(8?uL_ybQxjg%%FTW`&vrPTE=?i>+&CpFA&QviQWLGIQR(j`hr5|0)k138=Jn6
zy4MX0=Re5_&@m5eGzm+-z7Z<SeW`K&sj#!ywMcj~Z@_xADdq%yf*1RA^!M~MkUeA=
zO#1RGn8LBB_VXs_)<=XYOaRe?3?aAT?V`P~9kcV6#^KT19cHHecGfI6@_70suxfWs
zbrJCWG}>=Q4<@P{f1S`|rFWuBZ|MU(%jIfCs38bscI4~Wjx3_2-PvhJS0Rhu6k%`k
z&`_s3qab27jI1o*vET(N?nULOgSzsJYI`4zW~=ITCXI7fN1i{cJpDHw|1ANM5E|Hj
zI*exTX-&h5V0(_DL4JF<CH4^)d&Z5{cL!?&<IZESOJgfDjN`@=HDXprFERBr63@Y>
z3ar}9?aEZQQ&DHrKHhsj?r(hM?1}#2)_Gm3W?<tswp&k7X;QoDqS|xp9!waX^zGy4
zq_}5xRP@1U<P0>-P@H?pP1SB%T+c+)nwzn6+N?-p%e_~v<w3M;WO!j=8orgUJ8Rq3
zQi444FwsvDI{d&{OD*nF(v-cb*ZIoUUCv+S9!f7lXBKeN8t%Xc^xjaU1H(@Fi?hBi
z-N}D>^_+g9WxKiAH50uYk+?4Z4`T!!Yo@QjW-zht@cREh{|-4vPNqBOfO_Dig|`^F
zF0nnm%S#p9I$e<9S0@QT=v$<F8IoKx`~5UXRz1OP{6CI8S9fU1AuDV3X3&h05x~<R
zyS{@t@}fYrNRsg1n6+nGY~*AxbI<$N>?Z*;_7e`APCco$U0-TO*AtCqZT>R+Fv#y;
z$8$BKI7DtYtI05$Of~P`6YaATnmyjOi#I~Y^UYnu$ku&(<f6~5=lDAQX6EwJQzdT4
z2Z~{TTW*+Fwj~cr&5%t2`W&r}b7wl2<g>v9bXV*W?_K_jj(oz4xxxowX94^ckJWzJ
z8GDHU&HtNf01|+Y=LBTN?{Jx%wWa_g!j4I0gM3tFwzYU|v8Xe-gy}XV;SrR*uIR14
zrOHcd0gL-+_!J5i|C(@-pipXOv%H5I)<@870R&{OHWES@?EBaXNTS}m(OOdcm18?`
zu|~Dn)YOn#DsTqQ2{X2xF#V)sI<Re6!m;D?o@_D<dqb_d(jPbvyPteMCCa5MF_83W
zqyKW(!^_GJdgkxKNDIW$Tkg5W0kcLFgt<bg>Q%r*IxMD2jx6hr<w_KhTz)`3QH~!X
zx&CkaqL}EP*Q|sHtGVIu{MUs!oQb1Y+5Go)F|n@{)N^>Fvr<C6r&{^d>UK{>TO(EY
z*LHlfHVOqx9w^b5t@?}JQYEn~$xt)SdS7{%$8|%}kw3L(=ae(~9esh_g)>A*N>%E8
z`{ZQ~J@5<O!(<~KI!VIf$ospYp&?j(@h6R0QdUj(C9ndzOAjn55COFC?+_0bdi_`j
zX0-2_6jld`y=VUYwmscXPnWXS`{rhj6v3ig*NLWB#}^F7jH4>uG-irWW5MMSl|m7u
z5?M8ooaYWtQq_mM%dQzEMckvekV^8JcsJyP`ALR^t6LvRUJdDgyP!e^zha>`xMA2U
zoRc~2;o_(#`CEd=3!)Zf?8)LIRPEe_q>s*Ht8z~1^@*mkV3N|AGM5cr`@}DS8VcSm
zB3n{S*Xiy=XYsJE{0Yy7id4CdF3>JXx9)*MY5e2gU8aTYK)EtI*xn4sqzj4o7AdiD
zi!fII7=0e{joAwHOKbgZ0xMyMvpI0{e#6LR4y0aeB*s3eD2i-S!_q61IkUE;7V2&?
zsj*1~clO-xiAxJ6Ezp03B?U)7UdAn&*|1XaqjspBXb;*6!P@kG?T61K`J<u(r=X?W
z)z6u~tpdArNtIxY7vs1}10_MPrr<})jNoD?lTxW7<Tkx8gwueWiBA}3gpJ8EIkEsU
ztJ+_$pIg195*m-?@z%gSCf;-uHTJ&+a(L*WBg&#e&h6tQF!EVOM9xJR?~QodwN#eA
zfH9jLt}koVTUY7Hn{HM-)10Aw^J^)Fp1oFI61%g}DxPK*6Hv4AD5Cp9o}pn;Ze2dH
z_N%{vDc+d4t{C|Ky0V3!hLH$-^to9gn=?}qmPTUy;X9iZdsl?aSoT}`&0U$SUw|f@
zEt&A%UBO>OZa;S;G?bM3(J+OX!YI;X+<V4n620gtYMduh(2W0dD!CZR`}iTD!w8s?
zys<BFU64F?QHV#u1>u73Pd3D14XB~m*H;n!asBZjbZ<_O%=hINdFRVRTU+iHi}U8R
zPGe|wg=V)FKhHrIJ80E!fL-;FOd;Qrv;W>m|M1I>e}cD>?$7!8me4VlPS+!9kMgFk
z+a$C^c>3~i1Mi)T`QMNuUkBRKdv4>L%Q1)1mbYqipG6+bk?+!6Op1($zKLi471aR8
z8#{7v_9w&1&^Vo_)W?r_)xE8`UrQr&ICP%-aC&@*DK7xbc$h*TB)YiWQpJ%Cs@T1+
zH^wd=C|2>02X2T5NF6<trE@U5=qjgfitGIjstJI-lMqdzDB-6P?6FeF%Ci3*Oyn|x
zJ(6>LxnFBZYs2hzqNVAecZM|6`P>*x*5mnvtroVu@UHEMd32x>cs*y6Pnm7j$dZV;
zK{&aeBk0iHHbIa!s9C8u)3u~&2fW&ZU}r0SlRh^LcTW!nkY9>)6|xyW7SZ~1Z@5to
z$y<Itngb-L{Y}RnJQLXZWO--pmn@#8vS1&yY`kb#D{*4i+gl47-Y%6o%?3M+D?HrR
zX4o9Z1_ze;U$VOa{bfr|a+6zLH(TOheV&xnGTbl^fxr5CUzn2c&LpvFv}cFfi@Wju
z@$09+GzT$$ukaS?S1}B~z(7pOyS_R+^maXiB-XNNFzqyL;b`2Qu>{wFB7~R>B-RJR
zyAaXmXuz737AOPJ0|K(3-|Xs@30itC2BlZ+%sIn5kN%N(kW%0m135|?>aWsMyL~mY
zR9L#=WB_chagKpjfnjX=Ayd9bk9M8j6Ro}$x`gQ+adDnx@#=~Nc6B2NyPi;m_KRy8
z@S3l$=kB-cPq6M~sFz)sDL=hs4jQ^F4yeXuUNX|=@NYzdBBpIdLN<Q7jxxBt;t(!U
zrU8AdZ#s*M<&xOU-T=3IR0KwPB_D}~@HFlI$-FEXkaY6<`+>Xm>ru+q+1JiS3%|~b
zN|mb2^8v9Zfy)`@3j`m?%7UU;k`T}1E;JILh|b6dsKea@ysPUuYY8%~B0)9^ByM_I
zX|r>5sh(^~8kL@ARyCo&P0m}w>_leY&R`ptqqu0@yu5IY6vVIk9lFxF0+%(pKVBcG
z`QVv2F`p<Ou7t_xu~`_TpN?w;#Mb`JrNx2o!%pCEf*UvA7YeBBgLDK&fs_p4;c`fO
zNQ=g`aQvz?NIs2P;^`KePd&&WsbeI^3%i?yu}ZSQH(Y=}YDLoDbb!T+!toS=WKh`+
zFeI2mGxC%U=B}Ig01R@5LCjeA?eA)^odqXJ@XIk;J#+iB+{Kd|Dg&%RMcv=KMKRjG
zohceVCYM5xYCqhWyMHp?>C%1yKHUGQfqnxX+5@Wur-NJ%^lsfwpCaby^%$58Sp@#b
z&!@|i`p(uVu>bQUo4O%t9pH1k0Z3@qD&l9e`0j=hKX1{6*ABBLt53Y&EV<H7PZk*u
zT+e<Q)Tf@Ltr)a*+kaVj;ODt~0q4%hS=00W%4AIBwaorA%*mon9D+NCd$^rlv4_kV
zPXF!(TQ!z|4=aFwG{rd*Akir{NWh(X#5r$!dN@O8szfF1ib{k<KAlN_rh}#;F5sgO
z>>%`0-`MQck+EzQ?+;dG6ft4h#AZJF6g@>g_Or=<pC^j3KT6P3X3FC=qk9^Rh3qu&
zRo4Is7?}9%*N`L)4*etxKSsBtB0oQ^<ln;-BO^bLst1&P@^2B#3zJ<;20Es&4ycHp
zaP~o!+m$;nC=nWZ)_;BGVSyLs>l>DM)3&qUhA_ow#9U#Rhv$El&;)_>L?&p8>S^_D
z`*-vV%ac!Asfq9@J%QsYwbsUY$>bjXM&{84Y4nFi>Jrq}PeGSj{kD{S<rU8mv9h`@
z-ZVq)^M!cxSi|c(D6~QeJ51DSSZgg;FV@?9eC;tFjUU8Yp@tE5{~a|z{%B(T_bFNz
z7%>BarqM>u|02xHtrAYs*{7?YQ9F@tj8g&P5VH2v-V$3i&3Bb2K~Va~8*MYaLP|E5
zgSVptSX~Fi2FS=dUla-_AF#b|NIzz2TcHW={5Thv0dWdmd8PKmFq-yt4HO4aPF<g%
znIiK35YFT0L%ybR_muATYVXEf{z!%29tY7!tx8ZE7!8%UHS`1`mMAb1a}NdrzRWq-
zC^q+`X%6i1sdf<=zjHpydVy5l?J%v!CG^<apLd>l?55}^=Wv7Vev%?hC=`_TmsSDM
zQ;nFhRB@vUb8!@U3x|qSnlcHpm8d+aQ_K*IH7%N}5GkF>h|jCHka$J9ZQ=FaEIK_1
zWiwwg!{~!q*`xF+g<ia_^&S`~d;}UkoG5bb2^Qe&T>p>wX@K7j%$v05uJd%@V}Y>!
zeHKan9b?t+TK-*Xs=G37<gtjxQ5{2l>c`V#qd~*j)n9+b&5k~QQWqBy01Q5d!QY4o
z<SgSm#BnTGF!n9OmO=*kK?o;07cFwdT7{%x1GR;1K=MR5AYDDLO=-HoH*+r;i-ZOd
zb4~f+AbR&0+A}GFe>!+$Z(AmT^fIYEU+VQ+St7|=&S`z}I}WF=B*=VacDg}C@_BC>
zBSUY$PL(McdT$M=#glijdQ7q7S`!vBNmSXcbCWOz{I*`ekL(a+{yb-;ME<wv&cIg&
ztu?k;xLVT;&hNHC{n-Rn6smeL-RUhFsYE%c%oeQi{qisQI5GV1Z6l`^b^5nhc(qHA
zICdhhhB{3*a{K$b<qW3i<-s6q@65}+!X+cAJ#lS?2fOF*hkmc_xi~pYKS#rPIY|cm
z_nF>3K7r@)hOdMk3TH^@A-Xvzmc@)tjao;LS=zxZP7H7j3Xee)TRRuu1TXCePBMy^
z36oFM-c5kq={O!|0|USXeww<-u!sl(Fp!66knqqeLxEna{aFh*i4qIG{w!{0lkHyG
zT<W^{T{x%ZN%;Cf&Qi~{pyx`&u?nOLD0ra3m(OdxB?H(txNVQjzQu^;p9bptw`*gw
z@S#rmVp&s7z@~qWa+;_w0OVHwy(Dk~S5E7{I|`D~C;8!%LRV;8{aJi~i#@yx=_K0l
z_gYX2pGHi;%uskdxWC+@kxBKuOHbT0hqE^)+Z_xuN~6WdCjp#-ix8I&&(Noa>Z-?o
z);KkzM=mssZ3TYT%4VlZYve~GAYcLac;x*Q>Ve43l+!a<8ik2b49GOM(m$-qoF=7r
zzm!Gm?E-b^n}F}Ug7*@CfOFmtXGto>M3@lJHr-kyb*S}H6rJdI<|J${ENklD4KmU5
zkaB5#XIH@vfK(>das6B1|1j$l>&rAX<SjJCX0fQ`+gjJvup12?_kgz8lv@uw<l;V@
z6U{G#M3+y3f1hcvZ2qcJZ(W(Vbx?5Xs?d)BIp$=76#3!h9>V>g#W}d1ZFKose@r<W
zYWvGh$_xV?ch@T5DWBqA>N%G@<VZ2P4S(S&bzz}2UwJT>^%1^bBps8Np~!(wI`XEl
zAsEOW;&TU)<9%_^SoJBBC1$*@^A?r}W_O!f=tfhSUT{Ogy_;|50&6c94nU*-Wra3j
zZ^ZIpaDp5#C;vVl9wPy&7615R;v*#*uz+D|4<B1^t;z=>g{P1DTfm-}`GH!^1V|T$
znqO#vG{0WJ@5hg?jNea4o?jKXR?KxP8_XZLYr&&+ix0Vo6_GO7AM>;hG51tS{6c~4
zbVD&TjtV_Zz|jh%5<5fyFLMo33@Arp9Y@f{LM8^nK5Lz4=<{WIB|#Q2pr2U0+o)+g
zzUbhm(ZJ1j&uhlwn&7sF-J3(|z#1hFW3-Hp$|lyUu&<@-(SJy03d<G(lSy}ArqEC@
zdyNM-fG05>pNhszC5jsEOZ<1b{g?SCs<hs?xX~>?V;YMishe3-<J0b?59V0Fv$mcT
z!JTb;lT!Q}+4|@ie)AYDeaiSdgRQ5n|K^kH^)uQ?6gK&+c^{;9tCqPO^{a@7&gDZ?
z^R9CAqRg99DMVc-9|m@rQS6z9U~(=A%m*JZ(1j`#kWIu2u1hVY7ZY&=?qs~40ZrU=
zN|a~BFW(&<%|-faABx$jp={nUv<XVVeM|O(RWimW_TY?;Gi0V_ZJH|&-#065De<(8
z>w`ja@3@fWpQJNzHp^|2&ktOHcz&8+U&tojO2IL#+ej?*$j^aeYeiljSEdD4Xl?5D
z@OPrR8cTx~_=c?~U)Og<1t&T+tW70~O<WXj!A#YP06P(hnZS&ik@xQ~7QP3Z`~TvA
zlgdj9Z%A6&6l1$;ue#m>Ozd<Z*`_zBy7{^tlc=WZ6T`Mc4d=j{CPhmyob3CN$eJBS
z&PvJ;-y}!vo{kQ#3=tRYp540qr5gmJ-;1DdlfWv5xlpZeEZ9a6R(uIQfi>hC%mY(C
z?NL6SCy6e8`1thkLej;c>qMONqRQ?cl=YyTtH@_ckoiI~UWBRR&C(TRhfN5r1gQMQ
zr@373%qsf(ubvmMzzrRlISR=WhvKYBxyIoPv8|^jFB=*TfZh}O(|}R0auCfqE335M
zt}EA2`-jps&bIH*W;tbLi~*0mf^WB~kLrttHJ{}E+Ov9n5*b`$Yx6%ab)vovutw7=
zq*L$NHMIRGf~!mU9WEBO&7k_)>pVo=D~A~p8tySJ1^xJVQ15@;Jr_ZG84cjC@3Xy)
z+1g*gdUU+*ENW#Syrih~ecy0d+lioFP%-3aIe0=Lwqx~KZ_orYTXq*ES;HhQ<9QCc
z0{z|(A5Zz<u+8TDVQ5_SV}y)SVJ>Hh6!*YJb+faH_<wKbERz5*KkpMfxLSki;+vg{
zuzL-v&<po(8f13E`l$-%YorvUT8isM+Sud8-PdzS3a931pirHYL2$7eF!!%4B1`sW
zK5;A%xb<W#@U!Q7q9ijSQbo+}i!R?a&P?9~%Q=FdDbWf^T2h^_3Wc)Pt}HEN^&0Pz
z`YB~hnT#MPZ_?<YAEZLDJ++gZOn0*K1mI&k)vH6T1^_l+laN$4Fns%}f6Bw_BY~xa
zmnY~tB5GahaQ!wq2sn;xc-8QRd~II+iuqkBjQO7i+106{QS(UnA{NFr56*?BgI|{T
z0`gu?w%QVt2=5Q{3NPx^^c{221r75;7Fn~(yhOu(#NEU*SctM#84L|gjW!~(W1Y&n
zKD{FtbfP=Zqm%`q!ZtSor2V&VODWbslDNA^G_Y1#$r}E*S%M7C0`>>dBzUFY58|-w
zV(G74g8-hQNF?*fX%NG{N;lTjYuIAYd+<OyXyQ@f0}IRaGs>g4KL2%rZ5<t3#VboC
zCGLfrKFH$BfMU>4rxm;S+J!!mqBPg%H>aElv<lcdZE)o;va_|?%E*hMdvD%X+bq4K
z)qSvRkIar}mA*gmW81)tlhYx&)$uJ;0ZZ^5j2xr0*DZR^1XQzz3cc%>zGO`qt>?H!
zJ+aS<tC~z1w;L_L*$@mWnX3$sb)wGIm49pFE%1pl;cU+!#y1<#iA;BnBQwXDoVje@
zVKhlkzr{pjBCqx-+uI@%18#3-?sz>YlynJTq*4|L@t0E_frG3Kh)4d_asYF_*PT#j
z>8f-4g^@>7TYG-V0zkUOO>)GAm@cktIKrN)nu}m{XK}mYM2|EMp9i=8{H$s=4`V1w
z^nG?rX+c0}ygL}Gl{I|?Dsw_<I2#<11h17|wI0}oc7@Krag}|dR{fff`$VI2S+M3I
zqaQz%rf~4egNRl;Ew)By7K_{?Q0_^|+SEZRF&83__5ZqbS8^zUq&$86dn@b2bFTSF
z=G+2nOVEQg4<B70Nsoo{ozAH0=at8E+c)_7KoxR@+$lqkA=*rf24T@&moOCE#cf9g
zOhW^&uKT@sik@79@!Ih9gOnw<@1|APZodKwFmFC|3)bkj*F$cp)Vdb5l}DSF*(Xq}
zrR<OPVZzF(UP<M)QNPF)76K1;{Hq^%O?PcN5oA$Qo&rXgPX^66l7L&Ji{SMCos~fJ
zuV^$zn}%j`w|cAjxfxwU*~Gc!Yij;Pa*JPZe7*J)G1l=){H+j=WV2!_Bi|rWvc~!T
z%s?b#$koC#FX97PUlmFmrS?=U3&!%yDE=gNUVh$x=V!^5;_dFX0@n8plyh_EIo+G}
z_6u#8uPkA-pJ_55m?)pL@6N;=SiT;BRG7pRK}4!7>6H#XmbaX)W-Ae%Eg=AOv;0}F
zRSe>DqR(%eAuWpa1wZNQPBIxBoJmGI?*ub*M7r^^1SE(58F;D9hbY!_6^ykWOjmuB
zpNy%9GYu`AO}|+by`oOEx)QaS<|f@6X4sJq7{~vVT=hIS9{L+jv9zWa{~{4|cWZPc
z&DfWMw6e0b;DSk=dw`j4Y!b4jVupkMwlye|I-WtEdsC0x>2O4{1?}zkpeZ|zjy@W?
zT>*!nw^1#3G9=u%Yh)sENUp>Su66%AdrtpBsD*Jaa?Xu3>5AdyY}5scDq)T0QwxmK
zW3{ah_2e{rM@pBLB?P{j5;=Z;X?R}CX4q(y?%v0iT{-rte34d23iEaHJIomCAYCw2
zoC|$=Q3V(ztD<L3?M|c0Kh}w*>67^I{&g(z7?6$b{5&9zZlxO?An?X5MHK%v79F09
zmb-|UUXZu<JtfO~lb5<)D`}IxIKMu|bgJ~fzlFhL#nsYl7a5?lXES}-*bhP{CXI}+
zY5m||%?GdWRwGQ>pXPH87qr`YmMi;%l#83jsL9`3*`_9DzOKa=b6DLqVmPvNwq<?u
z;LiX36jPD$@bJr%(z=w7&SHzNo<1yJ@-q231KiiXO~&aR`$28w=4TE*5)I!*j%aGX
zZH+IylJL5=I1_JrV7veSm*c;(SI)Jrf7z8wqf>zH_14G;j+z0v{p!*=#Z*H?x^-e)
zwr1a7W4ibTvQoW!0l|vu8?Uzf$euj?z})!+?b*1TR5T|<4uuEle;#ZlJ5ieeq%v9T
zYuvUGPD)U70mmVuY7<*Lr9tO>KbCcjr80vgYQ^eYan>lqo?yhC{Y=N~t_J@KKJ8Fh
zedO-j0&a+A@q_foZ66NjTl~d-fqv&WRu-LG#GG9&=w0xV&=hDcKubQy@Q>U~3N>48
z(DLf3k~OuYu)i6E5wmTB3mDuaKAoU+F@Tq(61fBU;tx-OARSdv`bX=BGgq%533S)1
zrpxR)R?_=~cwK%ELRj4+8|FX$vm@O0Nh6oVt_RJoFQxpudHjoRPo>81_AB6_#rN%X
zC`PWZ%xxpUpQJAFCWq+9N(>BF+?b()BxVf1C#fR)z#JRi+c!8C*fSKHG*SsP2x<CP
z#d~Y+tBcDR`*Mo;ZRybSnAO#c-i8dUC+B%KW+l!|&L#Ne`<*e#xbbR)3VJT20thL%
zi?AJUnX|&AeG~u{J#%cWXz(hpr6)lXDj}A(JrynahjqyK-h+8FBNKEo-s~k>+tWY{
zDMfppX@+QDJo|f5?YDyV4Mn@(2bJkV+kZMQ6OM01S3+FB{}_bO(}v|bORTMC&s_(I
z#@5@F1SKgTd;^|VU4eTdE2Bp*+HmDZ_2#{KXH#5@5i^a4^Ebsa96BBMAjVTAuD_@p
zQt35uUfy;zk`fLcIyM<Cp(VOalKqVad_v+PM~Ve$Pl@Th@?bAAB3N)1At~V9-Dcv~
z)ndvvlJyvn|K@!>T2?_@==bO8+EuKdIxK?NJ|<aZ;g)N@GzlNL_q5Gv|C{;pn!zs@
zB8JhDQc{Z*OkQKxB>m52zf_4))W}S`H_q{(L=&lPsCh~c<3LEWhfMoeASsZnBB69e
zP<q2rC;Bv-@7UF5v#Z*bIhtqg!`oFWb~oN)?^?S+2zWA0<M77PMnDv?{Q9$at(m%W
zTKne+I?g7!SrdSfD=_JQMfaT6>hf9ALoFpT6j0lwpLa-3-{6v`5|fRFBhX}!RK{*`
z+@fhm{K?@0eiSa1zLeT0piu>}iQ71)u*Wy9946LZzY}@#tTDS$Fs$%O<?$0f{a&3F
zO7Uk8)~nNsSeFHif(`pTlVsAtOLs#ddv(C7dS$zi*Y60)$#`QZ2S&Hg6x@DX9e5lC
zhdeNwY4IS_`WB8;5?Mrdu7TI@HEIgq4DRWd6R5b_bMP{_4<6dbd1Fp^@j2$~^9>b{
z5L;!)g6={=1fk{plt^|9E|16fX*>CDgj}QUp<lG_p_kk{lF0L(ALh7ol|%9BoI_FK
zy(0+Pg27Ie39=$nBpqkwxr^2z$Cka<O`Zp6btXk|-L=6vToC{YgfomWk-!P(VozlR
z3{52l@E)T7ZUBcsqa`X_I16t+)wPC^YaDjBUu6cB?g<gadrYIiZ6gbWR)?ml@JE%{
zrP3mjuPdBJuk=qkJmey1-7Qsw>C+oP-b<ewZ97i;6GGE)aq}BP*A);At!W!H%;4)C
zp~aLn|H6QScsHetyH`hu^UyX6WT7yu4}saEa<9E_z}0h1#XLOA3HJv4iv;iZ7hFVn
zxHg@IbGx9zaFZ>#{(p-c*2IH*k&6ddH(q`@W?qWwBcO%UFaA}KtfO-4W?Js2%pVQY
zUzyQQarKRY^%|*X9E=BfczV-sor*MCJ^k?gWOO=FYMYqTUp!b&xB-U4a3uhfDzoQq
zSwSc?hw=Kf{FX3_;{8gR<z=}g{-QezsfzsJ%oFx6xB?Zlt^utAbY(Vev?)v0HiW0<
zwl53>2o1KC@$rIHNTsVv>R2#cnbY+mac=9REqmS6EzMfff$z?fYQC#013=qc+-hw_
zZjyd$+meTlet^T0gFCSRc&J2Ks96+{Sm+m)f1~yhzY}mZG}86$<<g|w$);HJ8nv=Z
z=HZ{QkS`1T<*46^a5~*BTw?A=*g#^yijtb|j&gS1poj?5&i$yovJ;5UfxWcFjdgLY
zz(x$UhsX3!F||u)Un1V}Vy}>v#}jMiMh}jX7oqE-UUx$)S)Y6o4NPpwaKncPmTk5K
zhkxg`I_uUAb%i;3rgN-*QurF5eX*6Hp@Q10YWgfGswQ`y`PEEcxbQ21Y-2B@RHl}=
zh2^<Nx4ENEX09I8nd6SX`^y%fP=M2`FtDUZ(FXBGcA|j>dto6q^&9cVL@sn6BH3a5
z<|+Cf2s%E=p>eRl677otWjo}ig~HNAp@~w!eX;K&|Lm`uqRfU5k3m~a(MbpI$}*=w
zn1Yl$EDG+08GRD`iOzZ!DAWwjwchD_QSFnp`lmg_I-DaBt3Mz9Z<)Xc8P^uu+Ui>@
za4i`D4XtbW3MDmp3b}Ob)Sdkz4x#A+v8hHVO3`SruZQj1fE!sdN#Tj#kXB-H59iHA
zbXGy5O1}yFQu(Q$7@60kIiAPkVVSL-NuU75v_v}69jr;kuvo&FhI$!OXj^HQUS4JI
z3B}xFhyr<CBe;=yln<uj-SW?Rt1Iw4Yt^g=Fv*5pXxJ<K4cdRxtpWxeMCWkU*O)3q
zq6kQ+f3s6vbS|#GZYR1sf7bB^2zL$i=0kRlo27)s+p%b$T7s&fw0Lxs+W{0yk1rKA
z*I&Ec1MWJ<4`REL(w@D~pH=1_5l8o1J$c=;L`gcI_~O<#6ziDH5msoJK1V;4|HhVn
z1?)4AGxHmbgh=eP`nyvH_{EP=WgUYRj*PXTNJ!YOe3CVs@}L_B9mSe=M8L{a2!_S9
z0sQK2?i?56B#f2RlS6E?2;DtBOafpvMW9_nX?3vZ4kTs<I>=&pK#Rk3wZ2e?o5r6e
z0<8%XeRCmQdkuxn1S1-)nTC?K;}StEk%s%UWg!7gWk4^<Jgq($pOWa6q`&a5zpoie
z<3i%`aZcj?kaY043(_Q=1A}75r>4I@98Ub;^@3w$0nTvey+4ltrP0~~m#S_&PbVZm
zvKF(Ge;^o|KCkdDpohwxx5G_h_;Jcwzoz~}zuW)fxcTRr>;(HoW$>S4cel5&wJ2h;
zSQQJg{KltZcYV)qu|S_6mI_=$EOb;P;m1wod8H}3@iN`iMH=SM@1D5dfFNvGX~bDP
z&m{GC5e#dVe?wdw)gX%;OSk+!M*R7m2(*<_N&vWygxIwM1l@z-W$VM~57ts${w0<0
z?YS!keX4N4KT&Hr^+tA>emDwnLO>4Q#y89boJY){fV6^b!K_Uq0bV00M_ir%_lNnn
zMgtzJ%e3@{*G5DLf=oZnebZcpT-YI%I@QD$5YRB0q}99|-d52X?05^aw4y3QF{lqb
zpSNhRx5peC06mF=Q(&?Em1Y+pi>=wpLfgBGJAK(p!G`38tx#l9*7(TUa!hlL_Any2
zK)sRDX@|xGp4O&tpuKYmI;+H)reh2pdJuY+Q@G&5ox~a(pwSKwupiiH?bH=L6yd#}
zEEDd|KjPy;P-Ua#-R1jvZBmsh56!^HuoK|8K<EMs>>iI${+z1B^$Fbl8lVEnCT_YK
zlhQuOpWt1kW&<XcSZ@fJa<fnjXI4kCiM;P2d_3s*i(e_1C@{Z|Mo1s%&cM?*q0E*#
z;mI%54K<x@zPs|?rqY5$nDxZ(rNWyG&s~hreWu)hJGS|llboaAw1{OeVWXMwW6-dc
ze7hZcXQg_pq$U&3JY8ew>bUB~2aytYMfh2tn;0E;u~+jyFNTq6nAOXl;?97{rk#IX
z>n@Tc-)2hf?h^u;@O}&{JNS{!I@`Uq*!p$%^z701Z}LBG*3YSv$FxG9|IF=R<BNLX
z!3n^T$T2<!!PFk_gU}xoJ2)N*rT1c81ahu>2~-NSFMEJM_3aa1e$MbXI!`|x(Sc~6
z!xr6okOVpKhtxiJo(JlBwqd5Sv-}k&vX(=y$p2)dwg;rg5m&K{FgI|v)!S%oG8P3~
z(UY{He?%^)Ar4bmj79M4jI_6J`%XiSahL0B{n;a^oa5ll2immL%4FH3G&hm`wMuk|
z?Ao)p;qToI{J0U!{aA#OZlY_DnGG~vDcVC9K3I8Xq5hH#p#MUu^Enb2OIW(ZIc&dv
z6x_3#nKcUH&KA{UNiYkYzBOxe$nx=LHx-h5w#nrE?ym;&)`mXqVgg}bB0`q>W${sx
zLvlM~v%BFpa<R<|{>%I?CzJF8$|}F#GL)zHkf5xF(>_)0<z_5_Os|xMg0Rl+jWu%J
zjqXMihBrnXwu-#?=xgp&YBF!7&Qji>-+p&Lw!4LLvlM>3Jn(p>%7Mnbg;BV!8#)gO
zCUq$)eoNvACTItfITArDKRfJFbY?-rZ5@Vnw-^Hw4t;$O{ak74I2#c>GEbI~$w@F8
zcJuz9;_^IX+PZduNQ!Z)eLEf%O2vHtY*hV(n~O#Vh;z`qjC^ry=F-~1Lhp@CU;mtV
z(4&1yNTg9dMhc>drfW3RA(z*HgD8out^Q1k;>a646M9P=lkDj8;IW9EZL)REMOziz
zVUUl;b4gCPI0Adv8cOLL#bCZ#q-0S~R467b7N{vdiVagV%R3iKp^Li11>MlonPWoy
z#|Xu<`<)-+zd!MhHlh2*ok6YEliq*UG*w>EMXKPPOM2{5payA^Q}<2!)^hcpcDwon
z*~;cGF9s$x$_a_QteaZ*!7;ZMHFy)OefZ3EKlSR}_&|HfmI-EWTvn1=T;P(b%37hk
zhVycAi=Q<FW?;kqyasdDvzHwPjfbuO-s(qG@J>q*@Bh99^vVy55bu)6;KN-!^)~B<
z2iHf<9T3XFxbgy-<reveB7b7E?S*>|_^Ak)kQq4pi#c-fHIR)>f$6*+0x3FvvQtD@
z{TV3#{3qe*%!t9`rN1KJbPIqCr7bsmhlz~`A}m3UUdPSI`JVn*2C~V_->Veq^=AU#
zLD_Ub{N$~q*JG|-KP`{3bk?4>7Ht`mM$Imv2|%k{->s%o-6}<A>socrt$Q?g47wt%
z*`hF}55DzKOs^_wy>QT~qWRCp^{|@txNhq(5D*6JRa@^Da;?pA5V66GR}`mlA6<lj
z2yD+urYKDjRpw_}ZlTMT&+y14oF#XZDhDGoa;6xNis@CFrq2H~eCHx=memvW)|K*K
z7ifS|M#+#+Y?KdQJ4Bjet;%8rbaM&DJQu#>j{C_N4Uuo>AysHI^3H?g4=ctb2X%ZY
zk`n~+R*1Ln$oNQBW{>9w=RmXgw7MJ6aZ}#n4AvAf_|o4M&Gl57<%}VBE|jVvny?9|
z+5pM1G^T?N>dmL~N>>Qx2S3%vQcpqpO0_O$6RAK(brD;E{L2gJ@Skl2Xp#Q2uWmc$
zvfwsPY{yBOG(jM^aP=v0Xt6w$Q_lFZ21&Zg(<^&5Fj{&*mA-Q4f-GzG{Y6D7UB!;;
z6fvd{US;(?Mm6ssNM=t(UXjBXT3A=GZ*i0PD?!eoMUM%T^?hnJs<gndyQH}QP#Xq5
zR0qLJ|8}B}sN+<QOZcchuAKP6c(p8;Y~<t}0f^YOfwbSGuiouF_8}a^eqQXi6ShE&
zXM~z+o;BEVeCg%=^_8a;v?(nB=j`uh2iw9~-JSE@d!?steLOa$vA{e*r$&S{%RS<D
zzQ#c&9MP2EH1a|MD64-i7oX@fZE4zvVl;u&((-vzB-}R^)fe*)2z#{#qCya%dr%2o
zDePm`JC9!#Db&is#Kd%v&o>tfSV|iueC0Ciz`wJW8&lu8b0!MJi3Z3%rTsfWc|Wj^
zo)KKzxWTC-8)bNT=;3vY4tIO*_$XRIjU%h13hTcHJ}wWUj%tca6~{XV0dph%omN1G
zAq%=dmjL^r=o$NP#GT}A=$=^If@{&+A?#1A4D>=eq|THj88TwB^TZ)mz1{D#ETLd{
z0$(CFV`WJtP%mIZ?qwhk#CVD4`b%AQma`47@K}>*Nh15FyzG@^?cQs*H$w~=*6pt-
z`-GBx&I~pNuLy_z3>}`fH~AY8@<71^A92|zXfu@?0@ACsD3!0~sKHx|zY8prsteFT
z{F|bhw&Q;{g<8Gp`UZh)lE4Sz!8{cojmtJBh=mGR%>=+nuy+}R0H<nly3=qJ;exEd
za7Qr_d&-l;W?54RTf`^meO~;Gp$#(M+$=E7Y9LwxJ+?`m{iJs}+mt7Z&z^WB<p=yY
ziMVLbX!1(zSGmvOTsLSaLhBFXPJ0}&@N<swlV<2hT|9?-u4SJ8=)54Y0*LIAJg=Q!
z!C<tmy(Cw-tKM_*V?}W*oSM1A`0`zOAYf_QQ=|G2w&XV+PbVfu6p|l_EiKFU;y+o?
zgW4|qAwGKH=OQ1`{qGkjiQa{U$!z!DZ=I<Yhi`C2Me7MbL^OD@5$6s;)eopn*DbK%
zG%313Sg|y{u=*`$y<DiP2*)A9ezzs*zP-~+1K>?5{oCF^(f&$Fwhy2RZBa}t-Bbuo
zuqW14kF%y8&U0jEUzmSs*<2TT*7y!fC4BS(GQX`LttxqG@HdMlofeC>Za3u&(U3tx
zL!jSt!;B_DrFK?vzGEkMVsx$PO<CEej-32c?aK{fo?69h8<7h;?2+1pnAZb<U631U
z+cO+Ff6>H)b!3&P1(dxoGjq^QS{CjKeDK0FVfZdrFu|e*3Hw#AFK{`VLrtTjtv2t<
zkSEjEdLAG%z+xu=*oSlXdOgiuqYbjPfg_<CFJ)fH-FusR_5O$xK#HkednK;I7?R#z
zS+Z<0rVvx*7hF(%=-&oF_)Ds5di&mB?ALY%LL*Bd;*ASmwwy}gx}v}_oCS2uyPkUs
zsGe|+(cMBVH_;fO8mzC{))Et}y00amh`Ku^3|COA_7rBcg&M#3^n{k%;Pqdy@%F_X
z8gLlWnTo#}rF;K+;kNH}1r;8jU7P50dqqz&U_aO{eB^E@DrL>ZjNe!euhFZt++^pk
zJY`RR_-8y7OLthXN8O^nO5=Zh?bk-5YtWusX$gL76!lk(6Q}l$xS$4Jzi|E{bvUZl
zsO;QRr=fKXoANO+o?BbgF15xVQB5hHZaigt*<Wu-+*b3lSx^l)s9uot;hF6fMazr2
z%8}c3&*h%EQ~>n_t|YDjvGt7NX?2`fUH|rv&32i1{=SRd@e)Z_64*3*c|IOi_UUjJ
z%j`xB5}moC_dYNLfExSolX~a{);*N)m(!L@Rl;qNB7h>rpP|JYbn+!@K}WmK;hL(A
z`OCz|@43IctO-nePX%1dpLS=bztcT^SpF^9_1Y|xe8GtUJ^0&=HaS(B0|Y?#I5QYW
z*n2g?2zhbo?{6v2wd98@D-R3ErN4`SSLfc>-%Uu&toZ-q>Aj=b{Nwk3TkOQBy;obC
z8nySRRc-A(YO7sajFeETwDxFG)!5XmEvPE0X6;R*MW_lQ`Q7i&=kxnI&hb}{oLBOC
z-S>Sxuj_F+^(5*}&U!A&NLNYIr5(f`sj*Bg&^>ciuQ@lIYoerxvF`<i3PnV#0gg_`
z3GzUA1w$dpS!+ZCZnNa4^JlQEsl3(O<Q&AX7vr<K&9vjPq8>BtU}KU~+COEz-bb;<
za(kZZz0uGC^7sbvV0D%uA=Z(~dGD%trLvQ6Ks;fycviAx6mKU1*R~)GFl=9I5y>dU
z4=T)S@)GDT0o<Stc$p*8uh<d4;;68Gb?jXpHQ$hsLA3VaZKwl{87uRLw9lL3`j%73
zIm>K@Q&-*0Z83udn6F4sIYqC+_Zcg&3VT}E`igJZ#rj&Si>we|d9(>7Nl@9a7cd4;
zP8PcQ)LrT+s#CJBTA;w!c*K|<5Y4}+`A~!CVZ({lEA9lTyN>H8-)=d(*cydW3kTv?
zOuGK6hpK}nCQX<#&=oO0QMl&Y_`!%_o3R0RDyblvj0tTr0vyUMPAvpwe~jBkdWzjR
z-b8y`+#5nGa8G1&gZHYswY!Z&pI9sOSiH1^XA29Ha%u?WE3>TqY2xE|t&icP=ih5_
zWRUwfm~iejwIx;gRcU_@>HLC3??aWmSQSR2@v#K{^m@V{Vt;6-Jy#o|UC@Hug?G=6
zoY=<2{+jK-zp7XkK#H%4Bna-xHQcy9#_zr2`R26o1S`X*Kh|QFGl~c5*6BH407T^2
z!>(g&_~>EL#JWYV%{OF6vN?c=MPO3g4Bl_Fn-hPMMtp=tZEy4juH!bpG|K;V>{LtL
zLS>GTQkF4(iG_)N05E^~x=ku@i*BHf-R9%lk8Y@+bJ`~c57RZzxtQt3cdLZ2ihsi}
zV*Nm3#jjuR=Yx(u4odKgc9;AK=j)^}4O5mye~8_i+U_Mp?;n&%+CEL4ccScOwBseB
zBZFnA^4yl-U!fqh@ac1&-&a>#=TB5DfeOp;mq0Y${iu*R<CIOzA3DE|)s}!?D%Rf6
zjxDRfw<N*zVLk7FX{GsqtmWL(6Z=dm*dWco60upjK{9fOn&kU8rEWFYrL?AWz{v;S
z{-3Yg<h-pbGhq(<MaA>M6El}FUtfHr=i?Y346){^xdys&5cPEo3`5}rX&3fC@S~wO
zVV5LmWfkMn{(rg7q|Up!eTr$J45Op*hC}Tk?I6}yHrl?rGILu}Y?-JTnz<$_-gPx5
z`1R^OBO+GK!Y-l0L6vKNBdIFk-K%oq7eNtyDa|?*<^g>+y?$Pie+Q+40}SeHwjxe6
zSF0rCS~W`?Ax`dJux{m#tb)h`IE{s(XHs!iI{vS8Jj|dBW4{lv{3FtD90lZ*gsb&!
zYg}$=^~PQSvsebW!^?hk7iLI;#lNQe_ba7zuCqo`G~>+)_~k<f(QAgoK#V-QrU-UL
z-KgUTZ>D|rb*0O=;?!oDHA!4p9GteZlLQF>t|FnU;*OYPq^Q#$8<V<{os{XdsamX&
zt~1M?#~vC=5%6F-m%~M}oOyssulr((q2CM<J0=O0e030oMOUJkChjS+uD}l+ZH5(7
zfw{h6HuLFE(BL8L&}QDm?|73+u#|k#BPl#W)-iRy64x0bTW{Se8gB=XB9{HdQ~P8U
z*X?R*q6O!?$C1&D;R~IX%BH}Y+WUYHf$NGMd<UtRm3SGx&^jQT-JAoiH=HX+iqZw}
zvW@>;t;F>Q`Df4*{P#nCXYMI$bzVg8#CgD*-0^0YY6PLo^6r^l%P$U9vk>HbNyILO
zVn<DZ`BN($H<ad-{E+D%;{)+ZmUV*<J>+HJQ=jF}lRHr%v5B_1iRN90lwS%a`Dd!b
z&$!Po>L+vO{HYJd3HrLyRBZmqPaF2RIo4i{HV}OZ5K{_A$Bq^mySA}C&A)d<W%EAv
z2k~axpMMI$rL>0s8k$Qgngsn2MY8kD@;9C{jPBfd7Pn_ASFeoM5@Lk+E{>J=-<42(
z56gdgasQhNHTAMm%4G0~^4XF5diu4MJ=wLGMh{i}`nq$zI9KRI1LLhf-RH9$M#t!O
z;x$`v_sCqb=D65Btk}vRmQIa|c6}}KR{NUEEvr`l^oyluWSk=h>|Xl?USqxT`v0vH
zQCxYx@m;o^I=^Qm%}&Y@0ednwY?xm>li0_PfQYK)8X4ivX1{XxXmECrgDs)fXtJ7w
zwCyHP3^|p_#lz7XkGZ%})4=y}U%xs#{k5pB&-IK0s5s*x;5NO!y0{@A#zFDW-s|A;
zK1oC>qJll_o%EdtX5Ji$Ka<8srTvO@b|MO!SiEu{uDy$T@>xP$H#69}k<wUC@VsW#
z>PvR34<;M6^uVj!v!-7t^t5~b^=a?r{xx1LC#T)#P2aoEIpa$|`|9L_E~D5xpE->D
zTgboeKP`3aj`_8B+KY+ERQg6|{ik%{6HaEHc=>$F?+@Y58J*;r@<wDoS4$j_`@fa-
zkbp4ApLg-Lnc2g=Q@b7A&oyr!G7<#V1vk_UE_M25{4^SNudTAJ)XE(z&!1X&{HNZa
zBz3$tIVtPJ>L^=dJZkwPaY=jS%c#LjhAo4!FxRM+6^Oj$-8L~PtvjtxODxOnRVgC8
zEj<5p>NvfcBkf<~3;yy!x}NXKxt8i-uI<xN_1UknK{PCL4^;E0wun>l&8s?U`0rVK
z@%=pHB)>M3)#I1M2P1~mGfSrhA3|<1`m!XvJCypacJF1=mVwH`NkB8FLBZQ<VY~Ze
z(7x<!(XZNM0W5OyMDGXvB|Sb&at*3ShWwbbYx_!jG94q3Zf;8=C1PT!q50xA&FpZw
z5k~^5^z*qgHo6<5jxg6{B3F}_ezzj_MY+4XxSOlg^+V;siDLAW+Uxl@M{E0g;T)5Z
z_4ih0hG-M}e}#m5$P94l<$Wd2-{0q06)yTla9SExvQPX?Ir-Hdc|LhD@gza;-^9ug
za!CSmecGI|A>vA9@zPh{_wL8h5l)80Pbv}vrS**~G|L1u{c8m5%eJ}`%ksYKpJQ$p
z8{7%)Cm=8<)F|YwC*sGl5RNiTz#*w<8o=WpZ6UHrN+eu-fcNWzhcUGPzHs~=0x{w?
z0%WZjwn9_T0C^k(5Sd9;^eFRw^9rhOo84>2#1l(LlSTcKbfmexTKr`)PK9B>FU*;_
zo9^JJY~94339U7fSz{(8U{5gcZj%W5)H%^?-v3iyshxhJm(T)+O%3~?_5midhMQuH
zO5Yfph3`1>ZrMQ7n?px1H4v;xlOpg>+2f>SFM582dZT`5gSNEcIV`#^lu6}DxtMhT
zevlCAh{y2@`NA+RhmLqm8AFB#;0;ehpnA(OLF_Okqi#n|ZFSjRnL3F-0hSc$x%hH1
zRK{_FO#^Y{PE5@2sB6?3SkC_hzR38AN9%U(Ns?vX-lODwQbVsIdhHT~^q^k%)V)MD
zX$RpK`Lf4&kpqMw63&?gy7&&Ad@Im<@3)<=qie7g_+J3|RX+WGO${63l{Tg<iNxi9
zR}ISofRv(R{?yGyw2%>0=7+7Xqsr(hp678i{Sc>?93h$T*utNNc;a(F(982OWWaCz
zS7&;w2}{2hUeFNk%@Q|SKbk_8qoEA36O?@tQ~P#@_5;hZ8%`~VlPRJ&USx>ymUd>E
z3vPg>wNF*>ck>{W^0rZZL(K=gyhKtURbGpns#OYPDiERs-?szi&~OI<-RP#2v+aV4
z!;Kc}thpyykXC<n9_XAzn^?BvrvBfz0<mvb4=Bj5sE?W#H6&`(ezn3SuIjf(QM=C@
zjDXnICi%zRh>?w{uKjH>v6(XM@ljF17w<eZ<aw%)`k<lUx{I>Q!Bm3vUyxS$OjQj2
z%*DXG0y&Pz5st<|6XP_EEs^v!8~rSJst#h}(3@p!-<7XR!mSl3sZh@I^fScNmcl!h
zE(ms6NIMU#)K>dVV;Bz?AANW%S93aN$+-I^Q_TbDEp~lW5S|`r-C~Y)Xv+mm@2U$(
zRp9mqa`&i&KdDb&QyA%q`LI=!v@;lozp_0f@LN~+4NY`VA_%?_JtS8B<zfGcr+HBw
zdVxPNK*U@2WTJZsM*FhT9Vo0y@<%AQqr&3!`VtR+8^yFxd)%lOolY8J#<tOG?|ON@
zk+B6-dd__f_Xu?Us5>8}g!Sm{(T}IxJz9TAeIs#;km}r)L0nk~^7(RVOIh>3uIg0_
z&WFSd(Ir#i$4uAr7dKNAc)`$;12Nb!@i;)j7~ac?L3OU`l%*(cF{@c+_Uzy!%nKmz
z9K-Gr<2|nc8_6@{F4*;a(_M*8+8SFGeT|YGrFlL(b*-van}tnUzoHKw6=Ko+&zcJ?
zS+1&|2q$}$tsg^KVb(eB9D2ahJJnUKqK^98QMSvPhi3ItoEz$Y2^YaVpGD=}(x0sp
zG1r8oAB`0;k763$4baZ+$HvN>kBmKJKL9so%3OmS+Mj>3j`H&Rick3-fHOsP{*Nma
z2i>c)95xTN4>s4O_U~$7Eld}dH-`_BMLaqSHA_A_PZ2G1l#8-Y4gAlTjSLjV+1ox2
zGq281x&IFRDmQuGaaW9E&Vr&F-AIGp(Y-qr+5I%IQ+(&Q;dQpgW7f6Qn)bA+R{z*=
zXbP^;sg7ORsg(02?-9IKHdBPgH8oJ#DwAH?lZj8v)k=rmStx4b!6eBwoBCn&8+<p^
z?r~oVXwKYN@<&^bMa_1%^sX<uMK!+aGjNtMd~6>#uh~VFEAXLeX+_M31Imb=C8>z0
z&q6r?(>>`!O}XDGwT_y8*7hoYar}TzU|OpO|6e0V88USEkXx#&OoGK;i^#vo>+{Zh
zlXCIWyokgterqf)6d+oTs`LVJ6v&ohJilwByW4cMFyfGXYOoNAW1UQi1x74nTJ?VX
zPogf5raTMI76XY;gG38Tk@ft-kqr}DP>4_sa>QmXbj~#~TX%6+`A&iap?I7SwxwD3
z-)39QgA-^zyN4yNYD1<hD0yfmlXI4c*}Ja!t-+3Jm<U1qx+Siu*P4!C30^dThN$|=
z<G~Cywp=yvx=_d5(k7O^7qW<aNpQi-rGmB}u(Tr)GK;HP?7~fQ+F~qzPE+~RnEHV)
z&2fc);<H!p-`U0Xaaw15Mf-%N&IMW1Q(+MGh&~FV;a3!>%H38rg?*$0&zlL&GG@mA
z=XwH8nH@mdfJEDenq%MC!w0#(1Ok}^AnyIYUmM1L5*6Hs)oc8T*+^O-c21Tq<)=Sr
zZK*J+9B;lVA=D}%tFM7|@I7iq+b*|CHLz}qgeX@s@vph+{Lt$wIfwbY-;tP@Ji1ad
z8vm^9e!X5x*p6F{vprK`2H#R=^WUKBS3e<dYOx^x^mq3r#SALmYL&r9KS7G>Sa)P9
zf4xJyY^&JT$GS12M^FVK_gwKN=*6{nH$#+$%vahC|9q4Om|gjayJayhB!3MN-Rh<$
zb+04<VMy1%>!|NU?6?7|t9!y-lYf$7#5Vn^@C!k+{O$!oSXZ*m*Nq_vPGYoUG0NZZ
zx6z!vHtw0eL>{8vH%(sa!W%yUjGkpHo2?~4Se-4>xzNgv5@)*JnqveUf>6ElfBA*~
z`<_{4=<9kn?EGPuVzC2k#(+V;6RTG?g|(=$w+wXvOaqqbu{$p@hUT-XrS52MF`8I@
zq$8*KIWT$0z;Q77^dMhyhhyTkWf#@PC`5=1n|VfixXJ39`1NWQ$sqNtG17JO(<#?Z
ztZoy@UUGbe(mYR?82OoUY|A8Gu1ZhU@0)SiTIzcw$<_0(PZ2q=DwjMz*+Iq3+gbK(
zG&Gn+i4tGlM;x;2vB&7bKE96)GJ{leyW7-fQ4TK+_PW)YJMW081=3T=?>cx-kT^U5
zCOx6e*NH5-U+(19i#!9_D9lL+=+shehJT?~HJyYl$+L>tOIeh>`HA@ofI`*IC2<0i
z*w6g!gj5dBk&VCYIW(dzx`Wkjg&}iWYe`6he#{|bDeq2GNWRe|LyCTMt6`AfwDQvg
zmTBQXo6-NRA`l1Bb}EYUtd;0jH~pV246uf<H!1T_2J90hM2sojxIM#OI)`AjS!fQb
ziT=#TkyAiiU;kCCfvARPDDX~OKU~fM8@M*jND?#2S*k97t~~N!u0z9y^aLfPcbkma
z*UN{Dw#4o9O2O;?I_2&EQPUmCI7abkdgG(&sP|`EM9NF39<L+*lXT;W!9Ya&f@%f<
z35mV%Eh5WZy>%-!EHB|GDk~<cn9c^#Fg#~##Wwd1{Hd!;Tv-^hMe^eVZ%P}254FBG
z!SH|_p0d9(XGyVSpd51Mb5|IBl2Svo&s!9#g$s@HS%`iX`!2c4$?)(PH<p%Z5lKij
zGpg5ig#029kx7XQ{P{0Mv+yGqU7mSP_G&{yx)aUkg9SA=ZDsxa%IyUvQ)?muSS>Y4
z4Jz*q=C=_65qAO!b*Q?2i`lGW5v=h>-F%KP+A#*}r|1p>C=u(9Q$V`+OZrjew8C`Q
z0UMg$eqpNCTxyl^KYJgV#gdfErpWIP{`&`HNc3aL7oIDHh^crgyG+sS)-C?b<V@55
z|5M5WoRUyMGmafhFQVoN)A}I*bOYOEVfD=Gq5%j3a=~7Iv|}VRmS<*M;~H_8TZ7RW
zqq3;vnG)3&M4Z~#siXGd_s=w;bY^^%43V5?z0EP&7N*1_ZC~lHxG{$-_g-!%XL2Zq
zFFnouGs&Of`Y*1+23lPf{o-S}&tv(2y^2xWlZR?%YH27<KpL&=)5W4<qqU3Q%%KbC
zzw7_#4?}s_DSfX}$j#fgUB?>H#ActAX|AalV)Sh0B|v8%VF;4C#sq_H1W}#wTV8Kl
zt3jHWV{G0sa8C+EG(xvXE~U(&^how6j?5$7EtJJ~IwKJ~doNBh5Tu2);*A2{@^5L*
z38_GLt+d?mth7T0X-?-6IjLwZkcb6Oj{y-^vQE|~lHlHsDT>+0e>d}EiRc^U$X4j5
zI5VkvUL-IDs};A!(|lK*B4T6h>jU5II??KBpfKdSCr|H#R)4YMHE(o7NSnpo|F^sI
zjt@l6D^^^L9<6i?t8u6SA_AB+WqCKtvUdO+hl?M+TmK&3W66MB>Cq%q7HE2h|25-J
z<&3=BH)FE?Kl|#2LcoEa$bIRS@YyjWp$()57gLzsy>l}Dy&R{sj$eKMFHg+)a2HjR
zE1R+a7kbkG`S?Y|M(AsWRaUXn&%X~2$^;{GQW~3HXaope)!v)}{OOwJ(`i5=8)WC@
zB1eda7}m%*`5HX?vtjasZssh!YpyVtSB!=JA$`|d!Pld4Wr{^#(K9UZGF^#bZ+Y2z
z1xKg8*VZ#bef_ylB(C<p8%t!MU)X(AQxh)2l=@W$+rSq{bM-Fi$whyFKMbQ6;pCBs
z50^f)Xx0*S@QZ3KGkF1Sbf}F*N&wc4qV&bN)yvC9D5`p%u>@xPYyPKQW$fDr><<|z
zW*oS;yct>@qbC6FOMp6O^m7v1bj7xf?3baFYL=64UgisuBiXH?^pH~NPmc(sq1C}l
zDm=tI^z9E_-wH+&E{&sXNvQBC$GxeKBItFuqvsc=G07_RO@u0ns7kfl#SZ^nL$_`T
zgY+3jW$>5xl`y~c;3KFXKtLFK6Of!nK!U1Fz+^}3!Fz2&a3U3atnV+~@86d#8IrhN
zAk;7Q(LL`ILt34=MIEg6mnYcspmdf}@%yo38(Q#;2=_?{O{>FDud45sgwXewG$pcV
z&%~7$dJCrnWC~I$5UX`v;<vj!*KOAD*XLvtL5Gg4A7SLPO3FjS&Tbs)g$Fl3hVEB8
z;Z)-X)~mKYE!fRHRJT&P7E%+FZ&vb93>&-N7S#`j7Z&ffe{JDO_%t6YH0Rw{bdNYP
zZ(FYDk;l){t{esc^qj~zK4MXYB1|{agGGK~f0nfZa;R2N*+5k}YNW&IpfSsMQd>g*
zuAjBBa|b+Q^1JOcMnV(u1&hu|=2CNz$M(sr?%Rq;Z%<i`7E;?aX)vWWd1+rb`~gQe
z)wp}q8Sx{rmh}?&7f#jOck8?Jz52M@wi1wg^({6lo>gVyRY@HWTIb8@{yTiI9&*MH
znif;Hy4=rV!yE-Ic>xbt6SpiPsTjy(*W3HhHwOV(P>f;1WgG1`o!@wwB@Soz!Lthd
zwn6|&RISovpW}((ziy9j8|wB!BKOy+3kK@R`#|Wb<VOZ_m4!LY>kM+Qms7?kO5K*4
zAa=7BnWd1TEM)9s2ACrChv?gYBD*h4H5xwc_}{8y3^&<|`kBva6bIuaXUUKR%g^#q
z%iI%R$ng*YMdZ20x~x83m-flkcC=j<iY-AOA{j!3@lxjX&et5?i{z-9>aDrYqt|n}
zvo}HNtNh%P_!F-b<-fs*@JC%4NlvV4v-kfHv%RyDpCx71>+aVSufXnKtnIAgqz4L9
zo`SiswFU)G|C0S=YWX<n*B*Xa<l$uyv7G;x@@XPQakswLTce{<M%hH!C_-vfGAJCU
zuO}~`ighd`&Ob-`!vbm-d$P0r0kD$;?}2W$i8w3*u=}Z%y*>u=*AnL9Ji;^2T0zcK
z$cJh7{))h!agAQ}0oGQ9OP+`f>e+8P62;TJND{2SE3xpV8UO}Ea}>AQtt_6V?_-XX
z)52>}?~+zc2G`nu=!*JVc@Rg3Ld1L%yUKSfyEgChB37DC(SL@K%GZE@g`g~yY_<LC
zI`psL&Q_JGQM}~eSV>;5uF9AQewsgQmFYQWBs_6$Bzuv>H*ER3hs-j0or;#(sh7cg
z)V3N>F1d;i$VIXTruISI{A3Q`Glif7nb%82CoUkeCl2D`<>A@^iAfiCK5cJ3IAs4X
zEfu#Q5Kc0TUv|BJC-lN)HDyAvo%PjDrmjbR_?=u^0H4bfr)?Qe{mED05iKhTkt|*F
zA_>1&!`0y1wm8Sx+fw3Q5<Q6kPa9$){XpGhS>+6-Iu*?Q=3i&Uf3MWaD2}id<FXz2
z!XvwM5(Fa3l3O5FBmIV;+zM~EP$wvRwNWqhcu?}$qlyUu{}qN<i&!j20s+jgl<g^<
zQ-XC%Ce`gRm{s{TKQ-rxXdzW0^@L|+ti8I3Pg>L5wqiOpLss1AJL@?7Ij2<j9kbwr
zTbExnb4SyTYF;?SW!_<W%r)cJwh$Kauy<A6(L_RdA<IGTh=TjAisIuy((N8M6}b^=
zSwDG@)d0n{*e?FmyHCC}R<V`X!H($J_PSeo%e0Kkzvmp_+C`s1vI`G4B<Pb7s(nyJ
zYd0B|Mh#bUF7+x2`bWBh=a!6%XV+g5<*dtT&A&=v8m*B_>WTO>BLk-(ORs))ex$6o
zP-5;8FkjV?&M@B&XKELgwstJC*^&#Z)hR23ctoIC@?J!E8NUw8Da_5@yq{s3NK8Sv
zs6j?T2Rk&nO3V6Xu>ClvH#86IP?cF&@l~HFQ?DEAUg2;%?-M2$OlNk6eChtT9h#)u
zTh!Nn_M2*AA~DGgN$+|`#KA_S+-_AjfoO}!g8q6WY5S*=8fcE$m-5a^|35uZHd7PR
zgFaDbsrigpjHYV=_@^;RNv-KiM8bra2+_aP<ssg<42VcQ?-$YxElM&_mS2H;ljM(E
z#ZGZJR%%dMgB8|Z%a1?xEY<lH5&!leiP0GR-o<7jpSFHC_b~9uL%83Zq$llTVp2CW
zNC*(rnh(iP1@RI6Bw-x)jmFDp@0w7zQzsH8al7jhC;5_k61E*24e`W9D~`-9lzDGc
z{xf^Q-F0z|eF|)THSr<*g<9K6n;{YBJU4pb!$e-3V&wam58_y(Ir-;_Hr~&r@dz+`
zRX!6drW$cZ+Otg;IFWe#Dsj6t^}Xv^|7~pMf)}0cFg^^E5lGChOg0x+fo_jEH#)@I
znSYDzKcvm73ZInpmE|beoV|kzd3WLQ0mc-`oq8lZNq(y7@J!J|67a1-&j-OqXI~tP
zy_l+Eqg*%$M~*p<4V#VQElSlvSAAvcc5dp??(~vN{aH?^aU#_1!1l708KdP2y!r4|
ztrn^Q7OejL#bZrIu^3casEJ_kX&EvoWt0I+Z~nZ)m4%-~$(4L>4fh9uKr)w`Q@eqi
z;q&}RJcFCx!#_JMm)_OPgOSrgT5yo1c1I;-Nbbq8izKIiZnS%4T$&eM;eg(&W7V?}
zCtfeT9`X(zik9jirYY7F259dNy_9h#TJ|OCgiHlWv6@#T()8IPY85yA6e2~0s(C$T
z{9yC0$Q+d7d7;2<H!1X*)lVTVeO<OvQ)Fs2Z`5=4#Rmc3=D0eM@SJXKB`TiWY1HHp
z_LEsp;qJg9{dTv4U--8}kAN@qED9s1+0UfGa*B5$(R&4>RB*8xuX<B12Oc-+-QkID
z;*gg@Q4{e}_!+1`nAjlSut4qgZL?!EeVD!@Cj%b`zsh*<!!WnEanCnj>5p#XB1hMc
z`k>tVfK<x7GvlN=bJ)$lS)fEn_p+FAjMpVovvq)4M|TOMg0kX9*>;1q^+l`H#!Fe?
zBRyF0Ymnn;oCe@{sCI-xm}@|bcL3W3HOFyDKzW>D)o0@m_*RjC@Vi`|NZWNh=9VV$
z(Z59!#(V5)RNn~#rzD@Mw&h<nOtp|jt;=^jBjrE<ZJ<S7-d&CS9$ASe7AIV!S#e*?
zc3Bjjm`aM(K$7YyG=9#aoa^b_?N~+)4r0iDy`Pp;t28v#o$;Z%zYbF|iIpi`{EEne
zpY#HP)~kTte*I~iDtE$z#=UU;fvCG2?mH9ls{5Fa8<M`g;5Tt3?5EhnZjTIILZJy0
z(W^{Xy}3aWTZ{3qs12boCn&;GHLkm-q8yl&B62{A2&@MzU4<1<Hpi1*WrO0|>)!uC
zvjIQ6SNC(bWxye;cPu4V_~NVntlg)gn{%rVLfQc05a4V`riu6rf~y~ss2W0T@Mx0x
zUcRo?t*M{u5UeoJlsq{;W*>V{Z;kmSI2YpK_PsWFVJxHA>y2_uvKQ;!sQA%gSpxh*
z<E}_AqS#`>wG`;F%5;76R9csm8J3n~!DDavX#x4?UIokbPBvA&(vUn0XP#(-#Bb#<
z0X^|W@VU%w86sOpvYY8c`{~a_!7C&&MSjaFfBu@QD+!OWE#H2yLVA&W&lhV6Q`GW%
z7S}nF#fzo!TC?(r6+Pko6_w7r^_wb9E}SrJ{VFzgK%a+mQ~2%!f<rM6Xmy7BN!9c3
z1})LNmp!~~(dv0){+H`XM1m)G=OrM!-$LNn3*VTFodI$(AQzo2e5M8Z$ZeWX5RR<4
z#riQw%h4sfn-|k43L|<$O3%|@)MW4?g>q@1ust!zbmX>P^P;{wOSx@=B=37LiHSkb
zfN9v}?F;`H%!W4Ok0L7FjJK3~G^RPyP6vA43S`{P+hw3owNog|o9p|81iJhLF5C!i
zc4)@v>urk8qy_fFdwm<Sp;lbyn^=Bj5S?}UQqlp%=*XEoF}DSYVq6L;QDTo}MOnR%
zrQ3kZMuPii;oqe8yEv@6)=-4PaP%MjVh=Vx$;2Yb2CvtP-_A$pFcgZNgU`OwPxbq~
z8Qtq_>?C*`u!V%;=C%d=$D4!7KP&s}7sx!;a=WbGqhzJqIu7|87!-ZfBw;65=VK9u
zxvC3&WPX{iE1~8R7;!yFhH@MfZ+$KdGaUt<y21c`XG<vi=UtrLES6Wtt*OOhE-qJa
zj+=2GcqGG&yHVFhe#)({u#SZw4yqVg25TE2rwiuebq+k)=B>^Vt~LQuY28mKE+TCa
zBED#`pU1BDjxd?e1ZyOnYp7pWMD``RcE_Q9mK#;3Fqh{iD#d^M%867)ws~Hpst}p%
zI1gS@I}J1XRmH6LovkT$ZltM@5dl*v966?ejsYzb?yT~SC4nGU3!JVIDZ9gaoH9Wj
zTpt^&AFQaKXol4m-V}LZos{MBeAbOribJoz98CI<{KsDs#ds&u_Aocqw?h3+Zt33%
zaz(@m6Q7Gbj}s(F+InhCXdNy{n0Qf(;rEO(MVD3HQdiH=B{BU@f34LsI}PpRu4XHr
zJfLQpyyz5LC1Z{ur~N~Yhw+$Q5&N_c%_9ux)!>L3o_&dR+HgQbEv&!afGpxvSjvOQ
zKB;69;}Vzs^GSxXC>^Uc7wfralRt400gqe)gjr?1iHUqm0)7>H03DBIlgiw(JgTXu
z|6ou3YOBOZn3hKoKFTJ1_LmutA6rWLmjT||HbMPQ=pWGNHo3)SlSE!>coXBK^(|W6
z?zT;5|D;IEhKRTP7jL0-B4qmf*`mjvEc6VI)pO0qR=ct!SD^p8{*0)vxiFs>F!x6I
zQWX5n=z4Un2AaNG4Gz|d@r5U6J{UkWncCZ3Oc|B#=SlOvm44D|%^NGE`T@fbW1uoH
zdKBr{sLp8{&%vVxf(IP*(JeA%j)y#j{~-zq05ZUqaba~vWL3X2@uWNn;p*BRptEtV
z$H6^?>!$-E{q74%zOO|7`(UiZ+&4B$Lft8j+whH~%7mjqEK_R)?I~JXiORbwYx*Pu
zbW;?$N;dHJLq}-ZDbZz3N!ho0i!nyfVeWRzAG$_DC_7DgVm?c37itmw;Jz*H+_9?x
zNxl28szZM#1Sb~k>)`v%N}NZxCZ2g=Bv`kT+C7~_UfiA~Wx{4FF#Iv8QsOz((lRxq
zXZij=l^}FM1W6ERC{yMVPr?KdEi)TE(0#8|t~V-k>W#Rk*#!s`m-v_SG6_0}ULpOf
z!%Z6ZvtllRpW9e<lOGm^HIM6oXAC5c$1+#$t429GM8&%g<YRA9v!!G1{Vsfv=IZ&+
ziV?Rsfdjh1yqWsjs3v4@&BWDSd%fHh@wW@L=(ji?=zTuh2{UJA;<>Gm4oBAQL85<7
z(Q)|6qxYa;w3Jy(7{BhKj}@u9erNn2<i&MVze^j)iCW^W6jv!tfL?-L92Nv>38EWV
zK;?aUtumDI(Ga#tp}Y<vQ_$tRND@XUQApZ2h$|C_E@H-O9fUW`K$M9!ae<UCI09I1
zCn&PsC=iSMkhdY^F|~~s9><W;Z;@xXaH$O+>VGMKiZ#n%zA%M*8a*o0x|9Rdv|vc+
zBv&(GJijXOv%xd^D=I4zVqrGSm<;<OJ2Sn^*q5#F`?)WNJXJ>46gCgHNX+G+_dF#S
z#;EwT?3R9<WHRtk<Am_$$aV3KjIbQoC+&>lq&M7CTZ(Eg0tA-Xy{51F_K+$T%GlA(
z$9M`KA;iSZm;{=*`^Vct>%Z66)uRfJ2@=N*G86s#@G#LNeKSNhRe8zT<w;rGF6G9H
zh_2=5%lHMk)-9d+RwBp#NG&TG$Jr(|zikAllwG4`?C;j*A(3qFU()xBfl6fE>RM#I
z+8+Z1eFBj%_ide<m~KeAO#RC|0pL%q+JyzG2!2O=lo=YxXS|7&;b2T8TqM*%OiSSp
z?!6?ocA9+jx<+mtpXK~5gEAQRwvv%@@D?M1{yO1JowVw^2`DtM<nkfDk`4`_zwG$N
zTY}~ulRc_>ndCkAZfn~){-i*iaa~mN<Ti}_Tb&ObKKHpQpI7|#X3`Yh(avwG@2MgL
zN@Jy9A8Oi~s1|6ww8uZt-+7M{9rpv6gynqS#b>^@TPtUmmFMx-Q=6k{3s&+ZJnZQT
zo31R@)SfCi@()z><$kwi=D&Zm{yQR5bV2pF$MTkb+u{o}>sqI*xm7Bl_<T2|xl?9y
z<3q7?3_U)9Cl@=2&&S@{dHbdnT`IdBmHx=>V)y;&ApnrZWF{Qd$(orj8V_=;LhCs*
z=df=a*!zjN`cS|)<*TIG`qp3kpt(IHJGlOC2l(<R0`|H`=r=mDMa6Q&`Qx62HZbGx
zSNBH|F}5{UgZnJ!3GU+`w2ijDjsR<VznpYMD!NjC!*}c7IYrjPp7k$%li%==CHzdl
zHGU=#yKD>nGske9k-(6_b3CBV3zOn|E8a)!5+1D+UndV0dq?opV2k3LUl4{-lMtl2
z@NRcsR#G~ZJQ-<FRyNNgJkbVF)>({)7^kozqc}fv2_|Qjk#JG0ddcINm-RlGa-wMQ
zuE~qx=eb-G66ohP<fvL)EG!6!=A8kf@hmgl6+AxY^^pXy-NhLlfunoNr8P&#VI3Lh
zslor!z(sb|=hWTgXlhHwlzslI$MDzN0O)uI&3>Cl?a+J}Jyw>!p8!^u898I0C}Lq`
z<;@JCxi;SWqO?S}VBEk(f-{0zW85T9n1}EYSkg1UT-{GLnGD*5bRmf?8-#hin;7m}
zAK$`wqdynPxCDFvY*v1K65JNg8Gw303|1Eut2PqL9TeP01Xq7TIPni!jVB^M;jC&9
zawLK$Y{h-{^=gK7Xy!aXbQ%0ONlJane0#Fl9A9*g8O`!9Ia3x{-Hk^Ac$u6cM8$vT
zKQs&Yve1wkgeF5+hj-=Ay<?ZfOSt(_k(}dkCY^QW&hpe!YJdNH*rv;{uu7@1`R|;>
z-iiNgROf()f-z=}fPfg$nxHfMJiOQc?W}TDD+x9!Ho@`7I@jHWSOOM@RM$==5Shk3
zX_^NosY8>5c33?qC4<-Vm~M_1EFTN!-iDH=L8<nvJR3M4tO<dXVDw-o4DzN^SU-|0
znD%f0%;0xObJi4t+|-TRw+rWi_VYB7)<2O`TgJ7rZs-8gW^7rpadP0>ks^<yJ9X3H
zf4vH6YO&GNGOTJA`n2G^4{7xzqk*MWrW{T0s|Q8DCZ>*q6zCScB|zEG@xoYvxyIyX
zmuusRI&17DaMcb^>zVH`?kARsSzWlnCrmV5p=P)<;ZyL-yWTcP97B;H$t`-6)+Uur
zhvvEU{ZR9bihgx7;F3(`B=GFJ(j2})6|!ESJwB(bpH&9Q%Yooi<At|H)0XP6I62q3
zG{Kk?zmm~3+##r7Jw95CZ?dkjpsmv6p_nosgtfxUf?e*=@7IsE3&9~twnR43JFv(G
z0tNK=5jbYYj0g%e+md^P>GGXzUiYqtUk`192bvmp0+N;0^E<L8oGM_NeBHhNX3DQN
z)Wcbci7EQ<1g=+m9ss&BuD*{b42`4JkixqAZxo+!ZxOmDWhaboxJ9qmeCgtN#2rDv
zmI`sUW+9>)ZFGHbhAu;JXe5d;bU%MzwC+aWdBY>8h;)6pUCYAT@mGTNaVXEPziiEK
z<um?hY>W?xXf;Q|=?D<3VjszfD7KY~b+}lx2sapC-sX+W9CcLR0j%;5=GJ<XOVBSd
zx3hHwJz<Qcv0Iqbs{7(uD`9AGo`K-PFsjF#Lhx%CyAd*MY_+;LLMO;(wj&clAI<l>
zL-S#I+~1|A$2ZZ%g|jycd|GD~9d9m`dO_;yTTB3N4oc~RU*5s;p5&EAtJz#|yupMK
z@bukjX2uWkZ`6z}UA_EPfk_j><F{ir#eI*uO_OR{r`I=)g}B4M7-yu)3?IwIXgYed
zvv5f>I%;9L6;D5tOxf<P33Mzf&^alg{GztPE(5>cBY1V3{@nE*SwKp6C>e+(L18pc
zFN!5lgZ=Rg-t-fdu<62|GN8VV|C7g5F0ky6^^yk(hY1O1=-c|gV0gDk=3uAP7mFI{
zzpkAat~EEm|NBBWb~)!xkfpFcLJ3W3r#M=E;varrji>2F<oXjPqz3KJg|JiM_en<)
zDw>yy#cBH=vFe%WQDS_L?y?C(NDBD|1Fom_q#!qQ${lH#4*=wii~j@`Z|<0f$7&BK
z1BTMoum<cci%}fEq756;s@K>X%`JPOc3EQ`$VBaXCr*3e8CTV1^h)2})s}31#fWmV
zz!>?sxnpXbcPrY~f9`?c@c!JHj{}eH8^fm^0hlZUfm@ug97oXQ_5)A4r{@fE;<c&*
z`E89g4S00#Nyem?-_N!*DU3o07Y?LBAu%?jqxwlOkS~T1unn@Tw5_L|4-Wpn*wU?n
zw=HYJpKm!$ve@aJ<S{k-$<}VR6WuEIZ-T#M{j^MZ#IAugWPs*^4q+>N_S~0zeiK!T
znGmd_yB*C~dWSjz6P!El-;Air4UR#yR7!Y5bzS1a*Z3{jiIK{i1Cm3gdOnk-OWB$&
z<)31eE9hHEOXr4`CuRCR#@2yk_5a;YN6SS`m~YulOUPPOGGO94-&cs`s0Fjtg&CTa
z*f>*3J|^OpF%i0qUR5hPg#R=T(i#_#6$Y8h=~v}SrQ6SsQ7k};a+tCFbM|89KCr_O
z!<Y5+b>SPs*j1P?9fdKS3^$b*6wiLdBRC#X6zviJ?t2tk<izy#iezm+@3aC{=P%cQ
zIIRS*28SS;E}U1+AD&Pk<!&^ec_ILlNbN$4^F1@X|04{EQMV+z6?3MOVNMai*KqGy
zSl*w(S-ne->|?*D$e7*KmYmFHlU4^6QwDj9ce40hysNA?Q2r~A>85}PM<|clX-<tJ
z{EE8jw1F;{-A)guJdl|wP4@gKG6iDgi<gy>e{d<e3B_am%eIc@_45-H#<2`RyR&j%
zTyF_t)Om+^<4fs-;<WG3h=)rOEHB@y=$T>z3vj*NA>*Dct8d1B#{8?Sz%?k}*;m`5
z0+{w^_UEL$#0DC1Qo@+5JT7rgvJV<qb?t1^6S&~}()Bdt1uVFS1c+dhF~43^Npfnh
zyf>}D-+Mej@~Sre2b*CmwRRwHsgNVVNZInB-1O}YM6I5fgZTo}CKvDH$9$Jko8Wdi
z8Qai*>D3*9TB7YIhKJj@(M5ahv370)y<KDnPqam#vkvYLGag-#=(uRS-9@Y^FsAJh
zV*$0$VOP85J+(vT`<_69`^ujRQ}<AEyH4*fxqZH2Xj%L^?$&(h+4~Pk1uFAC>7{Du
zM+IL4LrLF=ZFi;=zTvoNez}J@EHZz3RP*T6r#<z{2l!<Kj@Q4i)ykBM7l>l<m>J_7
z@ma$0B1WJ<Y*|&qpS?X45R@nnWHBBj=Y@XAyX>g{KG2MbwdPHhcjrU3f@2<<@@C>s
z!{DG`zsCq2fr)t&`nJX?(t9-A<5C&DhBT;-DWF`%M+2ytnQ+kB3toTLsJC}%xvcE9
z(zChN;U-Dx@wdTonl%gNxe|3&6kMbAlf_9X<<qP)mD*;)M!R6@D*=67k%{RnHsT9{
zTlJrA<9Pc8A{%iynLhdZ^%5E2x3{$yQNLXTPigb5QVEM?Hei~K4<GS3$QLJX;z(KW
zY`q&h>V32->YkQ9$&CC%vE2XSmmj6P<sY4*-*TL)+l27pxySpVKl=G+Cz+Lgt82Hw
z=~SSpU%P97-*?A`S9gWjBOFC=mS6FGKdto{0<QAW*JTZzZ|tWg*3{C1v6Q@o&B%_A
z6+#5BeoBW{D;y5-&@Y33B)6O-%lOK%686*lE2v_smd)ylRaUenEkGxI&`2L<nOVRw
zUhNFIpyXJtf=ksh&sfTg&N_F|g}m<wX`cEL)O;+7+Ph3re&Nww_m1>Nvr{?bc>%N5
zo`i;qrbUn~jL;*k2&s}(WC#>tVIF+4^K^^XVMw(B>dtoY02Xl8bax9~-r{znZ6NF~
z|B_;Z*9YZ)dM%BYXVURwdK2xKbH8Qy3~aN+730EtC;!j;kr$4@KI-nO7m-~x#tHDZ
z_{z@*X=dAHy{T!pOpEt;B82|BAC%T`kA1G6UF{sh`;C}?!SSX_r9H5~=4R;E_B%Ps
z7G&&=D51ey{a>Xpx2w@v@;?qa;CbKu&8+@{vN`gLs6RCt0SpI>q=uf9&0IfRLQkB8
zH)Zy8d-Ey(j-#BVNKXWO*gJ2>^LM+`Kh!)TI;j}g7kVG*T+rGM<9nw+)}__IVOIl6
zxl2n<!Ub}v+y2!ntApH(bgBUd8O`wQExFMhdCjRIDL~ISUx^Ysd`E=-`PoXdCC@0s
zKmKLHY_mXR`2!|H<?yuEvZAMCho(bu*{H+5^HM4JZpqY-=&Urmn@BqoXuLL9EZW_-
zKt275Ma%a4&N5mNB4g)4N5`x4Z{lm5xLdj4O_i^hSTRhPDrYGI8^#}M;S*Lb9gbB8
z(!oa6#x#^;^^pAtrTNBEPhe|_gQNVuL@S_a&mlP=-P5pG{@u^!@(hA)#aS!-*?hiZ
z)T2mH&$}nZJFK104Uzs3bQZ5q<K*wU7ruYfr>VaDB)oF(fix`Bv$yd6+15*omuLua
zOFL!oR%)a&H=96~3FvDnR^;B%A}4_%PYdkCH$Y<#-V>PNm&s~U|NV~sl(*t`fwLal
z;&b^{fcl82LX<+rVcM70TI7}k=0g7TJ$9y~((ZRs(#ull`R{v-PzMwNXPnT{<T{!P
zIi_$jiO=!wC=L5>%~A;YPYm*=L%OF^10sO?G<9K@xa}WqiaXypLkf_V%;g+%|0=RO
z;#I!7c}qubauKQgx*T^k%ZXO1m#SU-dNYU7N;dlR`6-3*P?Ab}q9;rJR0K}=6g`X;
zoS?C`;7`eYpc~^7$UGQYzZ|F+usyspmbaNX*u7G!A2+ORKbJQkurKkeqZ1_WFJ}m6
z-bvJzLP1_sZETQy4H*zl1l9fW)DJ(UcN;K@GZ5YYi<_yV>Y++EbC1o9^0Sve*YX_v
zDzbh@X%mpd8=mzLob+UV?tWj+0;Dl%czBR|V>IpHO!JF+63#D{&-NEht()i+eYd*0
z10*f8|7(u2(K3g;k)4G?0tlO-L0%a&;Sn$_nV)4yoHCZSnsO!ETzw$5t~4mHIb!`u
zLQrAkKCnWX!sPZs8Vd$_4VT>pSam~1$hL=hy;Y=FOn{}vFIc`x3TILDUdA24pJA4f
zFSUF5r87s8nNO;mQd-ucFF&R|NV$+berYSkJb!$1a)KsgFMDWDwm9P88}o}DQ_#>W
z^h}>W#s;ZeyzDo;B{&F)7R*WrzLCTAFpm{UyO1uoH;tj0b;|)QET#YZ>8WozjrN!Y
zZMS+?bK_bWq@EuAYG#TVlo)4BAD+xM$SO{8H6W4g=QLRtN819l127Cy8$}c5{maK}
z(XQ?mMltFarhq61dUMN5B;TZbs7|T+LM&f1N{UGjNQ)jN-R30$aTG&~ONA)5EoP)@
zW~7yVU0#G|dquIR3N^xoHiWJ!)+r8XMAQbzQa&CWhx68(ROl%i<;UN*Zl5d<+c2Z<
zp;gXDbNM?Lh)IYBS&ofazDX+6zDTPbQmNW&avk|KtwQnpqG34%mD1UQCO#2uIpE=m
z5H_w!qNLQL$wQ{>D7cWfNH}&UbP`Xa$?8)Aip^0?GlnfV`uW3pVR`wydcUqzRh35g
z3nIGvmwV{(mta)5nH1Om^f67(I`GCCg+?LSYS2XY-7<B3FE~d3D`1X6^$7+ETxfXS
z`PT`kSP5|@4%))6@Xr15m|)B$04Wn;B;^tec8TQ++T6KPCD=d}jouvd!f-<VB+F`v
z$b>RE0qx5Z($=drtKB>Gcmz-!*eG-R#Vhgerz~F$O1bz!D|AXj#MY_&7`W%h$pJ(@
zQ@3Ip?E7SoORO;AoLjIJy?ordDIT(=Ay`dz6{ncX!PO~+4-bs|tg+9G*YCcQTke=8
zhd;iUR@;M_kfw~KkcN;_kcF~vT_?7~Y2jJ4TR$8*+c~bbEL7j4IsSPkpYLzWfPEMd
zoi&axj`ewcM4%iWdR(UPtmWT@Wo()2t3RB3q}nxqbnq6B2@>&?3@q#$FeXdXBT1_K
z*Zq0(BzNhr>!U0)_5Z*IHdv;fO#G%&g@sX##y0}#_OLMM&B@Cf=y?%7Wvj$^+}vD%
zKkKl>po$(L582W+pvtD~{aXDVX$UxR?;^Mp<IETtzV_iyW5G=v`I%t9>;+j%tN2GO
z*`FB9(X=bm*$@(<4s{Y&XkNj^V~;^0?tw}CJ?4Po!0`dG^^L?K^;if!_%I>434W~3
z%gpSLe7WJ$>Ecf37Boa3w4UV5&6ZAFjH!NNbxlFpE05;nWB;+CKEO4BU{kAi?B-J?
zTPa9@cfKAkEVkIK<{~7*dUJ;#1NR44v}p`wMrGR=jR%H(ZEFx%7w;<=LC=xtL}y<&
zuiYJmM13}-QNQ!+u3w=e$`mO<{WloNm+xi@%LvO}EONJstteC&bEBDqj&()Q1>R3L
zVEP@j#;==7;~L~TC~**aAFI>rw;NR-u{=g70b$@hyjzsyMA_1EJOm}rk#nozUi6=j
zlT+(_ILGdF^Vwi~(P|PL02Z-4oxSlk2twdbltseCwWA6X2CBPnF5d1D&arCbVO!aE
zZmN9)NByu4>u7@Vs7szn(PO*rpIZ{(?Fojll~Sc5WjvT?iDMNsFH90T6A{@^)Yf|z
zc`5r57G9?6`4TdLoC9Qehn*L%cz4GWZ0+Ax;Dm&G^~2*zLLYza)<E>7p<|`}_D4Qo
zUb<#SFYLf~+3Ykz=Ir>uOiA<3_lfS*dpv)3w}F5FO?tv`*#rfhs6*0{!ZTtWOt-v2
z_jm)j_>1U8_*U*lx_n|kvts^hI;dt!Io<uaOpo<<;KFMkI|l^eY^w^3N625HJy9JO
zz#Z(k>H`@JwW*v?%k?=p2I?Iz%&T8HL{C$K0>2HHO#vPmY}o_?O=RHqNN;pcK;LBQ
zkpj|V%g|#V4z~Afg4n+u7i~fF31<X588@#;KoE!4=Wsx*CnXf~UX3>Bh8*d@h<HsZ
zzOq*nB<{0vF;|P};GDk5Kl-Lp6Hvb$@a$#WSE*wVk#7t)l;Ls>%JQ%E6e-+9HN>ZV
z5o^f8>%y~R^h`j4l$$<~0{PL2BDuo}Ibp;~l9*NfOZinCp`g2K)?I;XqEC4G)MIqX
zbb;g&9@gO&m{Rk(o#%Vv0Ub&?v^|```}Y&$1jY;KfJcHwGRG!pLjx?G&cYP2%j17<
zw_j~xM5}SeilMe~jg#_POlM=e17GZAC#fe)&BFc3WqVywcFgmD+3Hn<0eJ7#N5BMa
zy}H0;mn6~$hZqXIYj{%p#*}r!9HCTwc0q0bX!>eX<#WU-67>-1@HFZ4HPT9fuL}kR
zUnAM{rPCfHtq{ln&*V@X{zpmXf|!~b+T1o+(*Lr1J%xm+r!$?DbAYJ2nmeu~{Nll$
zA*gY@YqJF>-&gZV`;1FtZe%kJR=W#hZhvI#H`d%D=D4HUff7mb>;u6FEu5#HNN})F
zeS6J#pVW*dera07x`4<4vSj=`EXm{&-Ng*LIr*lPh?X7fP13`F3r}#KWGXs7Z*R<!
zSTFEt3xV6Xja*ljFn#_bTRBp#+U`YuFSgKr*>8AKMYtH(ne^ND$3^+A!s|zvXzlwT
z;kR?vd>1hQyR0Icsh+8yy7Q*$`r%B|!t<0x`}OkYYI$8_6Zd41_O0e8xk(?*pY9;G
zBD%GRF3k6Z?%kw5c?BqtV=QUlHo{rtY0%>ac}Stn50BkCK>_U^%M^Jw&oMZ~zPaP@
zaD{`9p;f|KpJ1aH4l_u!jnP&YJ|tvdqFyAsn?{C^*1K)`JPa<jNf2VCHf9Lshw+8a
zsNBo&3y%n?(5@96&?|z~eU4z4QE2bh8*>vkO2GrJRMwT&F}oDV^;U~pz7gv4e7A0x
z0~luV399xV%Nh<w07g_yIs?TfRjJ6rp=EdRo4T{$5t9c$@3^?43|jl$y5@U@T$wK4
zd6>UoB=P^wJ&DI}zFOR(TBU-Yz#QTwUAV5HpunsUvfFNt10EetR#xnpr4stS&)j*o
z+UVo~g`K}$UmA&jCb&&hc8OmfVpc=56qIWhsaFu3a0zaY48<})@h8Nb#=kgDj9=51
z4*W)fF$Clyn_|YaRY^vMl|EzRHs8%`G1kZU?X#fCS~ib9alR(V{=t8axc?yUQfscg
z{IxpVNaYoJOFMzB8iS|H4i1RUR)B1TxoR*+>>w%XXT0jpynA^B?TzVxSR4BeUkLn<
zi99MAqUyI4ZbY)};3Ht(R~h?W8D%fQ8nGc!oVj{;g<Z*v*vv#S)j3R=kts{TDR3)x
zzKhgE>O-DQ0MzHUrSm3dj;){qXJqsWX)#10D?Uc?gaB;(@G&1VjD!RLW)E@^nhvNr
z`L?h#l;yG*CZ2(C^!bVGgsx8I94`$H6DFz-H6DF<Tz;RM-!3+T#Af)1`>m08aWyW#
z6~F>>0Y%B>Q~+iPPvPD5N<dB4QdrjfO^^ZQJqK%*g^4;wxy=-LI=lVfACl()3QC3v
zwqR4S&eBoXt3lYDBl@uipkn{GMyarnFgWa);}`=*Q_}AjHH(eSP(vlQwe}VG&4Tvl
zy@PaGK~x{>oJEaIHF;M7$q@06Z5CCzmZZ4FMsQb6<Sdw;eavN1=UB^o5k`&=w>Odo
zI_$S&QTO?Ygj-9Z-u(sJH@zqLcWg05Lf9)kD1$=7Zpn-uMK2Tt2Epm)!usfWo?;b6
zZh!GuO94Nb=5f86aSvDdAoLFYcdcH~`L1|N<7%sz><Q8A&HqQ!d&jf=z5oA45IZqy
z?^QKokJ@_`9by$x)ZVIS5hIAbilQ~DRgGOWYn7m?idIlHW3)vHs)9(qdA&csU;cdN
zpXcqI=Q-y(*Y&vW4}ov$E1&x#STC9(e-?3iBScFmMmTm+k*gHng0TI)M!tA&!`5VG
zX=jq}G4<N3Noh)ueR9BTz?MB;!Sx9D@+!3~s-TI{t05sNA~GI%%`J(4X)8u0Lhm{T
zyhPI7rwi2UGv}wKz;#O8r8#}-A}s7WCpZBMZi&n7%)>vIEGoI(s0!S>or(2o>X#q)
zNr5_W@(Wl?oVXa9RP?+~{~1dZxsQN2w;g#%Ap6OSC-(oo!sD}Zy-H;212ObNF)m~*
zVIe89IrHl~b9N!#01#yCZl~c3fQ|z~gkJFxCLlU@fGbSd`>%^-dsx@Z+buS=s65gf
z2zNq2Wiw~HFOVkJ%+FWVb51BC;`IeTi1q27bS-{*cH4~#f)j{@sMxpvo3e)!q!4cs
z*T$%i%bmb!buVCR89<fmQWpq`T&8|qC7Mv9o5-TjszIP6j*`%@lYP;cOd*^zt<J1(
zsN8oGPUr+s;%T+B=rxYc=J`&WoSTv=w@GJ!05U7DhBwwsH9%d$;rTB-sPFDJ_8nVo
z2f5FNaZEm<|G%O?@jp@Zxz_=%f}ZvBAC+@!QcZ8nIa^n*-qkD#e~nxaxic}RW_GRw
z6UJrn#P!%ue7*!q?yTXME-dKjHwO{bc^7BWsMY;Xh|zl=J>n>vEeUH}{R&rCQHG5}
zx-9RSS-5v`X{h`&Q&-DZx%_ct4&8hdZYV*dznjis5JZ?u%eN)baJ4S!C#01sh~4YR
z(^pjgA|z;ONWT{O<-J!W>13_=`IKoTY0!9Pap4I5$A%<<c%qG<15i;3Jd9>~zas><
zzq-n<&TBOj4GT?pW`_KUP~@%vm+0r`mQP#jQ;D6x=1BxfOV7RGuEc)8LtnTs@Z5=R
z71uQ#(Xeh{DacPb&{Ju6hiy+^C~4Pn?CNNJwxa@xDSaBmkc}T;r~JoQM#<-kZYF@d
z(10CGe+aqn$(!8wMD7Vr`m}HvS}8S4!|A{t>-M_DKJMsae`$AngUw4lB+*aVVWlHO
z3Z~i(g2|s8&5`%&%Ax3OIO%p2-T^4Ew9^b5z#sBHJ*X^ZAdmIgT%bAXg?MD<<p~OV
z-q`hRYNhsLZ+jy!{8m^@l+??X7g=x5S4c$mH&b=30?I^DCl4KsesTTg6pr6DB8TO8
zhrEhhl>i(<Ox;2aJ|FF=XDvjWc38d(K6m3fe-HN)dH+oOL_n&?;t$e&y=cYe1OSeC
z^@Kf@jCdp8__?Pvs~!`~Qw|{zd})<Fowlej2VQ((U*uvZCwbqIN^i$!PdZL}_56i5
z?n-3h+!q#8JoWp%B`>O=84{s<wBs?DRNF4z@Xwc&D5KB3Ip%$EaH4^m&(h`8{G~bg
z##P%9`m6|$aZ~6YnDVq*2Wi@obmF+gc#;h97&B#%rdBP*3sdPM)%7aE!%v{(v-GY+
zld_=p)a_Gs)&1)=RcqRV>m#43sRV|5aH+-q?MA%?8V`}I8ca){+<c8+vF?<p-!WjA
z9m6W}GxONubF;Qj+$<oaY~<FcFc(h<E5=O`ecaDJoC_yBt9Xl?B}=hIB8~?2!(_0^
zeL`obgJb*7#G%$JoMekt5|vH15NYNxI^_^B&N>vAYV$l*CC~*LnPjF9Ph=iR40tqn
z3PhXQiMzWe7!u+);`x9lcOYSuzXT&M)b<Vt65Ogkb51raX4Y;LD#cY&`E2ZLsk&Xr
zi<%Q|!1Z<66t0_^^43uN+jTZW%e?nZ*2)p}etyGvAZ7lfJjBIJB>z2CJlyfoU49WJ
z1J=QcCor0&6W%3y^}iFbVtfEy;61^OloXM#6HT%MiSGQ!L2kEZ@Yyc@V55vwSK9hK
z36`igV<zd7y{AAwk@`%pgJSFsmC4;42p?mL?%yu$&(v0G+@SePpcjx*O4v@7;nKWH
zX)$t7Q4q&pmglbNV4|qc3&11vgsHuMaSD|_;P7fwQ0H1p(BD_<p`h3?LyK!H?Zop%
z&YF^K0NUDyV!vZxYFb%t90?Hk++lilIKJh{)=yVkkCB03xe9_aiT8(W^0d$lpB^e8
zMDrXov6bhnRI9weE;9gv6|^_8wRh<Y+`G{{YJ4}Lw`;2d4tTvwbw6I%_S#HLYZ6KE
zeMytXg2O_tOFO@kc;w_5ucD!1)TC={k;@BJGIY*^ioepo_Vf4<Z=*vekLJ<bFdsNk
z*$H2I#)>8<M8AkR=4wsfWo;4Z_;*6WDxaX|olzyAU}O?CI=#b?sW+cgf<mtu5Lj^@
z_BmDl3nC)g;22rb#p<Yku!O&YY#MU%cM&7X`00()s*~T*mOR0|SMR=rf)I@t7#*1p
zth}&(W%Z(>WXQ#h&%R*ope2uQGlL};qmfjy(}K$hPV1KDD<s+=D3Y{9TkH~{MiZ}|
zmIidZZLDZM1!J9htnakLbIZHL8~9CP;CidA>1lXZ>C5=8FEOSzd#;QxsdR8WpHLB7
zlac4M74q7ml=fk(8SD<t^B1-^O#clg|EWci3X#Ar|JZ>fkRb#97xpkcZuNZ<MS53E
z48N(1hBb*am>YXcl_1Tv^NwDYHkn1FIvzlA+X?JDX%wVMT<1ckGfBAE4i2w5(h0XE
z>9oD0=@usF>+C1;JW{XyUL%aW=(<aalCdM6?yj4I_q9d@BEyH=3w7}yUudQ<<+E^3
z$*alGWg|02405`jXtMgsmrxBR3jN~Ev1*QzyfQ(GC6dr=yuDLy!fm%-jN_nHzMXHk
z&t^8G2J@M?1sR!OB~r;7I<H*4{}=!*wy*KL5vpV3iooPJ*iD3~k5?iac~#Ze*0G}3
zx~m32GEi*Y%UCfiTy`?UXvP^0A$z87>nc^(K}84S8pdX`e;4EC{tz_T5fo2jql#;#
zE|3IQa|6G>B6OZT9On)C*$&Pl(G{L&7n`VGrt<f!$Q0mP*Y(Vfd!J^Iw|9@#6Egaj
zd@db0iLkG#+Sh~AV~HF$sThwcQb+{SkoNWa>3dHo+jkQF=7F?+j|I?;diACdh1#Ed
zRHalqFfYlkOq~$j_*ID?k7h3KW&Dw$a0y}-Sn1{bfwyK%jLlG^9f9-g(MrZ09KinM
z8UK0Q@g@<pqVZ(EboQGaQ2obFbmwl;6tvNfo(|gq$a(Vp38&UZi)cU9WP%Ky<w<%2
z^+HI)fDiFCXWIb2QC=&F+O3J|AE`8#rtEWxr_$|^3$$kS)EJ&N;CA$%cV+R9o?4HF
zA+!Dh1T7k9P4`z%VF7wos?47r5SU8>N>+a3L0=ErjOWLx9F0Zg7ar?w$@cCs{zh(S
zOqI$3MMSAYCDb(eKI4~?U8&%S?xII)+K7Tt-scGkz$E$W)ArvbLa_-l*suYO4-Ab@
zV=^3LGGOGKl;B^%)4>*?aqOc;pXKPQO#M|le>=pLhgA;%JOoK|3gh_ta}p`R(p(9d
zM7B(z%5&Pv0#*!u-sByAoG)~Rmx6(H3)%XEiwb#FAS*w`%RIk~2TNozOIY1wq|(+W
zK6Zc~4*Qg}E!m<OUyL&pmu=>u(E(`fsq~K=^Q3j}trlE`(szvB5V!R+M-kr#WA^Kb
z`EBm(KH>NqAZ^M$9_2{LVNC0U_Cx-PHNzj?)G=ve@IB4Sws^~??ziGxgh;#T8R%V>
zR<4oz8GnAb33Du}UVE%^#N8MZk2pJLpU%nsd3=iGs_oUeExiiHr;|IVa8Db_proHJ
zml4qBiDd@}^ss1h)cY-;`?>$m+?ta~RKqngPvQ=obkYnq(3ZSH@6<`ctZP#wUAq16
z)6x*(6^NkBHEiwI7mk0;s&6`LpSoc(e4B)q$(}gxq#)Mn3(bC_JtpO3ZuIEi9qhN;
zvAzp*rDMsN6N<%9*$$Bg%@6PLow&nIr)X3ux$txk0SuJi$?Ya~YuDh|0LsVOy8Ol~
zH069E8>+V&lCFTvoNn)Yxn3n<+fww3KThA)Ic$f@?)ZyCR6i7R9H|!FU;8;=ab2(;
zHJInh!%yi@|EOwxx+OthY~D01z@xCWg4b5GpXRXbCo-uXCmi++?yjF^`nL{F$++%V
zCs3D(OzQW=v3qn&-+P!2W;hGwllM%;QpLsobcC0zE*ZmIK9S)qbmztBh_mr8|FtTw
zC4g`VB3y&)zw8B6<gTDUB;<9P?H?QW*pUf&LlpqI2#GJBX|lHMUk*c5*7^H=3|~W;
z^E=G_anG^*a=_X?^w5(eS=CVX8seZDr@}LHxXEz>e=cRdbK1r@kj3G34CplT2ZD0=
z)B)>-|1~ezzLv~BFXye;Yamma8~OQ}gE$B7pIDRFLB-$8V}IXx(S{P|UIWS74{k@H
z{rk;hyeTLxD+_xLB^o2n&aeO6)FNMAU7od)d23b#kqtL+SB$m%o&LCJL%n`S2Ts%<
zjF8R$(#tE7<hyKUt+_4#Ouu{&CZMdH3>&j=6&iB<b#46`5wu{06D&&#p?DZg$3ynd
zdBQ`3O1e_PM)_e?+-KkD3@=@0mB;{Sq`YRwulKYTo+Htq^-E)M<;uX2jh;rLgEIHr
z<2}}0SQ+X?%!Vq$pIhW;=+=2cscRti0?<eKTNst_ulDOs!VejU%^r}h9+^In_D4`x
z%q3RltG{KvVvC5s${M{}LQ4HX^rwWV-2f`^udw;bYXSF3wR;0Q+QLS|02pn_5U;V7
zLEGd`10jE`j-HQHCMYbt<EzxqEg89<G&jKD0;rLXkIefeG%C740NH~8tzY!!oh{-%
z3>rV2uBh5s%t+tLFL<>@xdL|n8Luo)N(PI{#5Et0yiL1PO<q--P=xY8^UoHw_uSjH
zhLd_6LmjM0_*?qGPY<4#x34dqCEN7i0ZbDLBz&GBLl>sopCe#caFZ$YZNja?puBvQ
z_o??RS7|P_q*(nL?b#o{G^c)bn%T&c+U26b*K+{*I*c$#PFQ;g%D8i6;-E)lqSE==
zK3VX9$O1SWcf90Sk*bt<aj;o<nrO6zI>^BIqw0H_%%2)*qw4D=ymIG+Z3{S^(R_T$
z!Lg>}x6}l~AXtlryrW$uTU7@vV~Eqmf7Zb>t7J)@T*hFzqY!o>CwB<Ui%=tn|5Fp=
znAo2Al^}u-Sur>2e7!iifMvDZd31g3l}l+n0^iJV6?n1+CtZ+!e=yL=5soSy_;h>7
z-V*}OYTdkJ`nPnZ8JYHRd3O|gM^%d_n`$^TAu*S1ZyqA;)Ela2=c!8;nNrHKI0W}e
z2|>?3_^|(a`>Oa5wnD(bvs#cqD*rDpZ*9374)XTCr0eOgGI=Xie{t*c0DBqZ9ZU20
zpa3+YUL`z0Mq3yts4hp-<W|3pf{d5Mi~MHe=xv9>c%=S*^TasZ=>3LHmspj5(_o20
z-)!hgxsNaP@8Q}74bYF>I4^hr@11r%EStY$*sh+#HSTIV6zLX2w4B$%Uim^cr2S8o
zM-=hWZ58AgT>SX+po#F*uvHMKD4v<Iz1T#Pm3B-7>iYM!`s`-b>%V=9?r_q(+G~pH
z?MAaLp~?}DE!GFF;Wm4+!wF`q<%fcz-R)#yzrmw+C_X71^a?A}Kn5unmX}wh5Ak}Y
z>Of6M@5N10yBZ6|lt{Tvs;~St+4AlY&kL`J+OWTME#A%CUPC~Yi@foDHmQfS7?l?;
zZenOTf#Vb8(9?lQ5=p-O3fUu+JfBnK7oVF-QjWOJ{vp^uzWgDHj~qj=vOw@=&`KV!
z)LJs%gv_jn=Nak(Ub@3GNxOQdchMO)1C(4=_)fD9x0Lk7paKd;(*vjjrYC1LYMfuT
zn;R+##^09G?Up*Xr;cYR-`_vQ!iCc_XK3H#-ZzeC(2&jFVHtPOfdOY@3{~j>R+rkr
zH!l&(rZHljV?Q^PMokI39^O0KL2JiZl8=%MX6{m5`Jt8H9Y~fs>dIIg2Uty5II9pO
za=d(ll*|q<OahGSc$+82X<Q=hyIVbV<J=t&`E9zIf*Ys5ojPAzXJ|qRRNQ;el5%Iq
zg@qR#+dlj3{>K3RzwZGdMy(wv_Mf{BEKQ^hnN;n=)340uNKvVpSEuKQ8ip#R<=?k7
zUkI(1&C5k%mH)*f>IT?s>euC*Z#zRdqPWcdb8{wlb^LGg<H1<})JPR8=Y4ap<o`?l
zJr7{Qr@v4WFGB9-U`$)8fhSxisn=6{Ha;2fDtH@B_r*~iLE*q{TxlBCdX{;rdUDYE
z*X2xVxY6DQK9N^P+~78<E9^hr?`HV`F@B3{d6TsEc7bfmI(T=Qt0V|0<__ww-=&n=
zVa8{Qtg#W{L~U=g5FWnHr@X{XiNbY0I)JYV1H@#*{LyvYbE+orWTCSCm_$oKPlX<j
z`j<Z|rzIO70AVx+_D=6nezrG@5N{P5ScAvQsa%Ej85C$zZ`3ni+-L2GJs-}X0N;K8
ztPKBbqmSe?K-BGmI-@XH@%@i^&TedF%&M0CV(W~Lc2KD1a>s1EWzQnN|6=q`|JM`p
z);(j6pLF2OQsKT@tpx~+7TFBGdo>!mO7Qj`>^~+3jYM7F0SfB5QFvlx<2w8b$&DN6
z`=S-~_wXP6#p5Vdgmv8YFgJA=KEJX(WZ-+A=*{5GJ>jblA65`~^xm=1jjnEdgNX1J
zuG*$B4Gs_OjmqXcX*@WeCknePeScN14O8XWe%ISR7e)4vB~x|}1vy}oq`xvHAWPJD
z!X;VK{{O850zm|M7H*URB{KJui1hzZ=JDJmT;%@=Brx8noHyXMkuz4?G|>1pQMA79
zaRh)>VC8xV4<<r^GH&Lg<|gwcZxzi!&0$M!G9p%JiCu+uWc}HiV3%nXyTkb%xZ`@_
ztiFSrpnrwZV-TfY9qt1lm-2&=YGRDx6`>?<O>LBeo!MRa#1Pgc+eWYVL{aNB747GC
zy-&ZuM>f+6IK*HA&KRA5Sl65ST*Q7&Iz?NT1<OaNYE@Q90A@Zo^z6O53&thyGiH8B
z1N?|u9_H#UdimpVm$0s~(Vxm$o%i`P&WuyOw6C8w9!}?7n}tlBnjC_uXa4&14pa!`
zzACe9xOn8ViD?E)0wqBI|Dc?sZN#`LYr0;8-u}lYAOnwn5^Ydu*<i7QTgczXekkc>
zA99{?vr*=sgs)7RAbE}IL}xbM*R9VTFOSy$TvtKlK)qLmQh1YYX6jGfVVGDpa@ma)
z3eCH>^j0@$JnY!3FSMfEx@GQ8j@YS+7MRRnIw&z7AoHdoC8HsO*+qR6xu1S8pHMke
zU7ro<=!WE6RjeA~HKHf2TO)S$#AUMxt;gF|5+_)*TTSv7ZW2o3xkFAS1WqXGSwUcD
zQy<m>HJzqPKhCwgy;F}kN7V}$BPE`m4uDRSnu`M)BO-4f#$4Yml}h^5tY(D!JY4G>
zn2AWXW|tR5cpM6f=;t?{8Q;(PUn+H#6ABZ|!lky~x$`ohf*{uD;J~{&BuJNK(?I;M
z_?P#8POe1I_Y-~*d;Xi0T+5L^PHUOA_0E5g&>mK%q~dxsJ~y4Tc^rGAY&JygV+3T?
z&TUh8La(^>H7(ZbrM5580$J1ib5t6fSyR_bcI+jOxAX4yW=dEO#u~?<&!%@Xw!Ko~
zzliA`pVoU_#<Mt21B6N{J88vik}yC7&jH3}4%!gceo$X!+z6n)W;{o^M+$usdQ6zg
z+&ZK}^+eBiB~)O7AjoQ7D?~l&#rz{o6x6P74t2wf%nAyC(L1<GxUl)>D?zf3BW?XO
z^lyvM+#8u&yWUtxN@CRywLG((W%-wy7F65yQz42_gb|ub(*AV>4FEOTtg*VP3FuW0
zM^l3PtZPnxlF-+|1FWsq+g3!E@1_V3q7?L-3k-!WFAuYMLKF!kkE+jcKU~iY4!#m+
z0)(!GO02q+&BS=U8;FR%x&z@PU(S%3IM$0ON`dzu_~rhD9GP+D%ufGcQOtu`Qc?bj
z*ahP=bs=E#IL#c|{1=Ukqa&dd5hrrZ@n=UQL}aS<cSqBe!HK9PLnqHDQkTy|n+2X<
z*>&gY7w9A_!7g&`*BNR*0O6jfJd?4s+36v>>J%c!E4(!-gp2MKQ9_;zUaTH;exSQ8
zaWx^?_wA;hEi5i{insEjjEUopR;wj&mqClUk6`pPnZaFb)mD%AlOVa4Z?#P#5*bw+
zB&UdKtlU}ukQY>vTNT(^J~A>^Il!Vuf*68O%nKSwkjXkN|15DR;9-sNiM=GB$9u&8
z4wS#*1x!M64(e+4Yr<lz3)v2l)?4&l<UFgC)Wk@PI;6>_9u0^E|EX~4eF#+pSsniz
zwF@qdYI=Y1bydee#wd$EH5dJ6xLKS19&wW@WOlthW#x)VB5AAg?3HExDQY@P&NuzP
z^(@wQMoMoCaMG~c(9ado{qhPndIDxR;0g?)uceOgSMSN(X!}F}x36;S-BGI{4TXZ?
z3At@d9>?Cxg7qamjk!oJzi{tfGh|_LyEUC1Mb`2>BX;V)Bf@1>+eQosqq(_PUc}?x
z_E<tNO>?-@rAk;J+OK5PyW>l5=IyR!Kd+4Ci+m%4?VVj05Z!gMq@}(LSVzh8zKL!A
zWaQzTIoX2%ac%f1`N?a>u^0z3S-K7W@xO`w{$BwpwhXhLo{MnJ+xPDe4iXK*ssaOm
z(T3e^`qKol_1f+0Ee#L(1!C}f>fW>=HB4J6vvBn8X)eL`C<?A>-+N>1f3DnEjSBOC
zhmkPV-z(zaa0AWg#OJqW8$S0W@5tZAGRBN6pXR2^P*B*5ZKDprE+zqu_M$SyJ%z~B
z&IEe?6Ypl-tbaDY<l_R>6AX2~vf_(%Rx6*L-aFj?v|MQxD^+-<Zh8!#WmJzg|E~iS
z)Ri(dN1GP)h2tihPRJCQ&0_9WZm2U?f~;m}64Q%B;j{do7aV{rzXs8Z)3w*qldELw
zIu<N1Q@c?a&FPbiW%J{mZsK}!nobp^bK<-YW}nzzPmQp9*51T1+IAd%Hb9U`5^BpD
z*xovh?LTCkaZJa7I1>^Mxx@7Rf3e!D%eiz)m5~T<{(V~!UYws8d1CP2NLHSyLcz!f
zjgX$^gGhvJT1T^lj-LEc<fPrcn+>YFmww=G^c3%>mu99X#aEI3yKL{cDlB3)cKad!
zdad0xmXDh*0`ND&wEv}EV&H&>wKcA2tC!#0eknb?q6A`3#|Yix_Yt3@ar%5A{Q_^(
z!5axZj!}&88V=e1CPnD2Tr1wz)Wrb0V=+Hm$S;M0iT@zHe}#<1a&|orwH_~f73%mr
z)S^(kzPP>L6>54M@rYw{WC9zLP7c0EjkaLPvT$@nPbwM$>MBYM7vY_(KNuighWoy-
zK(dL+QkK4P>MD9yRaJB?fpfpu@;h$lZr?-PWAWKG7mac8IvKgc2H7qRH~Yikbe7xy
z)Gkc^#F-s_OmO=)qLzL`{aae~D`OEI5Q}5k<3xjBzFet6ljA?6<B&62)S(WPIhWFy
z^w6@W-bc#+I0UErBOX=&E`;j!Hkb&UHdSBV_jVgt+?tCim^vm}3&`i24eNx@t9<)8
zIIClECDCs7(bov8uXVsGnyByJ_*|5Y7TG^NyN5Xr_pi!Gh#2$^S!@g6>3G7y_Ua}F
zS9+UT#m4t)hUydA(LXnT8h(CcElBTc)+%FcAx&ZB`26F&WeXQt<A&{T3c(^8Dq7w1
zZ-4X7Hy?iPd0ibFh~@8Zps`Rm#->AG$yWTbo7_!LjCcy230I@s-v7k>RQJm1Bc7kz
zeenZKJADr!uXsug)^Ga<r9Gb$-GF>4mM>jW$uQ@t$r!-`1Wj4j?iS~2bM3S<&cuCg
zGozre4K*m!uTMxoAM(cw`xPsSl@9=~M!EF=i1k1WIFf`oJhGS6-o*(-YJ-4e6d1lD
zp0WMOJH}`~=4kx{^Gd#JCbVcO4_yTYJq34c=sh($*?heL^zN9guGi#{uF8GKjS&~|
zF4QZm8oSu_H}AJej{R2sHqJX|stq=++I^1attb9F^K+{JsB10~wJ}6@sO<oC{*P>{
zH|a_+X~#rAk9BKJj7$_ek+Q`(Kz9@vykJ)0kssUKyTmp}GR`|O%_(At;gqa}+Q~^H
zOWL~U1s{^j+s<&QqhTle_|GC!ReGS!v>&Rk|6u0Z2IJbt(a=a2GY3eL4i8e%Bs%x<
zF6od5U!CEvE9Q<KY?a$T-qowj+qa9(4i70K>e2MlXSI4(^MwAO|Ep%=rif)=ISnQa
zD|~`X<xRnu<jh7-@888<t9?SY1nzZfkLtyXT(UQVxwe`<e(dc??b{c<USGgb0JUi5
zGPMY}FTD(-_ix7>?YuqmfJ4-wE@JENS=ITPL2@zz2cAQ%Yqwlg6YhywzYp*vO{Hg%
zgx=HF%-p+MaFYAQ*X(ud3RT?BMM?H&`JP3DtT^3|xEs66s2o9>`s{F%zd=_93Q<|e
zob{8<n?|3@A6Wx6hL|qr!;f}vSJHVaY684p7x$2X`1MTzWBNwLH1r|ehKr1(GhNBM
zovRYc=N@OB4OTNN5JU%q<(QJ-FdFbIikn9j#q9K!gMdLb*{Wzud^V|>AmcgwzZ@<t
zVnUrzFHjBDVkYtY(Z7Ygr<Wvxsr8oJsnpX>OXhh{&p>7dBRJ7O`snD8n|>(|UQUph
z(4`x(qJt&L$^BcG8dtyy5)G2sppf(C`hgEVMl2uLLn|p>0-a-E6q@t+#N0_FnWEUy
zy1|%^dhxFQmZ-ewSsx7tMb^^hM>p7O61E3r{jT4+`M^0vv)g0%Xwqcw97*3j%1Szd
z(+8=SE1kMBInBM0oa=XP>W-d$gIFaYtfv-k8NE_IfcLFRe(glV$RY?in?Ca1<b=dV
zO<-=FxUgH#W)>(?KQn;X$-5q5;C$=-ErF{s2A)kIU-iL<J%k`iyLkGOA*g;>WD?gM
zR-Rp$Ed+R|iojEqr2+^etxW{sP}+gbclGj=lvC(1?TW?S^o`Uns`hRt4Q>p7Q~RCU
zn?&0S1R-TTy#PSkCRX`TsO7`R6<-h5tnF5s+PILbwj`32o@#*WR8fOSC6#sCp}h0_
z_6}sbG2TDbof}}o5|VsaTq@2~kTlNV>vL6Vj=EJVRB##o0LZ?L+jnN4C*6e{xkopF
z7kQ5YZ+>RY7E4KSuW_*vY68HEtGp`Cdg_*p&4e=LR#p`Jq;nGe*bn9}@KHCddv@5d
zIW&<HDO52+{g2K)rE)h>hY-UnT8MzAdbI|;<o3iz=kJO*C(lN^?Q>Mi^G^wcMN~Dn
z(RZPq=AEy=L&txfxme91IO$9;=g9XHp_{<ry-wnly%v-q33h*XoSF#R{8Ljkzx|B~
zv-M%;hVip+q3IvWKi3$=D^<(r;}k2U0$I?KfwY3~j^%otBhnv$?A?Ij_d$p*wxq5b
z(FWB?toA*w;#R-g_(X~1d6mssv4LcNIY+JY`_fZstAEb}9RVoQw$>Yy9lGE|rF@X>
zN_#MUg`WHuAT65$TsZi*dx+j-2k4*HD&i`un7d;2*M)goXw$Vl{-0MO$M%X<w6xXz
zWj2%`1KibGO+VOLI^_az7Op?`pF500v2Hf54hPV}p2lbc=M?W;Fuz!38ClIC2HhUn
z7H$i{<@~Vs$A1$n((psY#L%GyW0hFh%YAf(a*nh;)}Fud`F(HluQatf!g@6Q>xJq8
za8}e^d$1@&w3cy)UGdR}^+Lds_5Fwkf`18K!-eWAsGhn3h+IIdY5i^As^|qj+==h8
z0nM#=ck{nAAGF;O)gLbD-ggYjY+I@s?<U=7eGLQm);f8|i@BB78g|#U3EFx6>-(TK
zMQW<2k8Ykct?PHHd#y=b$#rxB1CP>LkO`V(JtLQ2Wb?>eZQqNK;!M<bdjSDvzIx{-
zVcB8G8RKyDRV~mAx%5KA4AJgZzlDhpEXB*sq27DM*uF{qhXlQgmq|x8Ivm|@o^)OX
zI^0V3p%yQx-@?Mw?HzbRUs2Z5|G59r?8A2Y9f2h4r~?>#H|P9e-qkB_t~G&o{LMZ3
z^$ylq{N>(a7IqPT)a&hfdm4`el+;H9ZtY@}1nbMJqcboLxA-Mol8WBqiUOceoOQlj
zfRf};G-dwIh135EVGlJ7|Ni-!Y-+#|k~!?6%eS{3YH+%t>s_7ob52X?qZfCkcifHV
zVcoi&2CrR0(&rkQ4<liE_-yHIi?}dOd-DS6X0RGhFdQ9Npq***=p@Ehyis08T;%=5
zOWc#_b{xSgy20iCxWMsS?fLBHEKzrXUtp=7LB-eyAYH{5tjO239sM?o=$`U&Cu!`7
zfIK(7K&sT!XQJ^2*IF4yN3Xq;6!Ey2d$rN}i}24lC1Cw}6Y5>1z<M(V;{rFh@t;sR
zl0?E=g>H~a3hH4Jk+>WqUKy(^)=J`Bk*<-=<<3oHbmWFv+RMbcH?2P7aQesF^~@8c
zq^|XiacKPk|FItRXfRAIx?BZ1(_D;FooQlJOQL1CeYN%86_%{4!b%;Xd#TG`qFPQJ
zMWTdH@r@JphE$#$AOaAi1Cd#im>ehQ_xar`5fV3^g%)NvO7buo0Fq0UcWmbFEs5|P
zv>k8{!FWVFH;jb@07NZ4`nxrMzW;L#Y1d5_Rne-I9-6t&&`kg1?zJZNP>QLGrd{|N
zCh8zb#{otoV5FdA7hr}_kuGxK+&&g9Dt%I`tzgfT&dZIL9yg%mrbnm^4pgfgRogl|
zH2v}O#0CG+wL-XXmFWF*CE)BvnuhntXKNap*R@H6ce}AA^Gn^wU7+??3pIz&+M8)8
z`SH|r=fnH;_~*_TJKvNHY}m+OGO-d3Ex>OLMLFlOYBfkF@I+w-ng%|=T1hLyz00pg
z9)5Ke8X*Hr1F&8wdA=pMgo8`b{G>=NyU75T+#jBn8tzBy8sdQ?b=592q6`A#sw)A5
zV(aEsA53`GFOpyNzp<O~(nQ;uu5aBqNckybS5jDhTao+*I(g*>5LF36{Af?ZXn9M#
z@|7Oc3^`x8F-RdrL3KZo@fJFpN61#@ash9X|LKeQ(vL%nO2i2&A!VoYKR&5R9!^(^
zpX#u6kyPid9<?eS(qF%?vm~vc!0sK!kQDQ3op)V~d1t*eJjp&MeS?CzpU5O;1o>`2
zIjc&;Ej6|M^Zep%aRqypaBdx0Iymu*Z#QDpvnrH<)^Guo{XU-{uBr+DIW>Wa^~wB5
z0Z@<X4J5mq7`-4aynT;HHA2m3xwfCz4vY+cZ*UdCN}+KtvLBOz`Z@?@oscM3z$~yV
zVfCZV{3(nJ)9-3;z|E$o+X+U*co57~`(jJs+xz)3D2Lq=ho-IK403PsuK=+VGGZ{Y
zF?_ClnZ|CR$?a_M`a5O-PQtH#pm~0s6ApGM_>JaYDrz3ta7RopKf!(DQJux*W<M;E
zHSsqdHVezTD(w%X#wz4$mC~7xA28jc+3!}hOJ9Ya%ITHYJ*bH`8jkbf^zQ`Uzd0vV
za&zB*Pfs@REg9>QpV%JcI7o3;l`tcE$ddMx-!J2#6U)}qhn^y^B<_d42at@!F5I1t
zmp~dS3aS1lItUY1mn*jt#isdOK4)@^(6;nkOH8RTx1DE2Xbs!FW(n9Rtn9PL_g%;I
zTK4YS`$U@?;&Qi}TIDIl{*LyYL{5_JcvsxY^NbL(MpHu^bPvOp^#n?tLYK%1LF4l8
zZ*{ayFwvEu`gPuG1(tT#wj@G_LRTEg7vFA9CN?QrYSa{=XPzBj`UX>sLo9VRhDCp9
zGsKFjj=Kk9N)V6lE!?$XuJiw-K*4Bwwb*A3)mBAe@l+)G0yF)AZfw4jJp$|f`5zE^
z^IN~3xOUPHpY2?Ps*AJJ{Ep@y2R-@D<A9J4fm)%k3h4^K?oQg)p3t*@f+x#xJi*&K
z?viacoMo^iv4VMV@pC8zq@W$iHXvkubGmH(oMlgv%Kqn@s<AWAk?{`h=8FMUTn>+j
zG+mj6{>kAL(2cdtqFk2wH{uOrecs&>W|cJq$R~s-xky77*RVyuj>SJs>WFvWzS-QY
z7&y=|eT>y8n?t=lj`Ta4Lj@}{SEr2D-GAd((f-p4&NC#*^R|hiML$AN#(!ueLPtqF
zz6>JLDv^f9Pv(byj9BIMotJQuedg-#uaamBriY3a*kg+OCC`ggii61zrM7a!0$-?q
zRpQpgw^$1GXd~)@Q9~Q`Zw9NFFuE#u%hCSH@`K%VJ;8}2u8!dsIkk*1go36X<NSFO
zq8@M-Jw2UGA1MW#a4%XDY!P{+=W<?^Sf%F#kQ2OwH*5&8jJ?qBh+X4vanJ8q3|kq^
z%36p@5i2C;*G_o#5EoB(=K5`d`~6Y1EgBB$bpEW-&tQQtRpyj^Bf&OQ6I;C&rYP(&
z6jk@jNSz$}mp4X0HUCC&mRz65y#7F`-rZfVjwkpc!;(IFshXMx<_RHo@B6&b>{jY-
zvpSl;6Sgp1a@2|P`y`@O36CA3hRGH<yMbowB$rm9j=5PslO){e;E>5H@xcN7F!@%j
zTfB@3JuS_af-O)Z0X*IXru)maIepbn|1mJ?9F3rKp>Q~qsN0>IDw$1q@%XlfQAPV=
z#vNf*C2PXu%2aokO=Wzk(7@|hVTOS6iPX~MMDeT}qX!QzyNrcJ=^S&#DKAMW)Gsr`
zBfr{Qey6T~7B)#+%BY=rDI)T2_}WkRL19tNXRw6Jud8$-iTvR(mN)seg}6a?V@!Yn
z&Rj=~+KAKHZ-DxvzA+2ko$g@$;m#I#BcHViP6Gij^lq(C94hX}7Tl$NlcRl@=p{_=
z85F9FlaEdrkFN_Xreoy~Qt6K^`bwulpckQd$u0bACPkU9rC}_&L_G_T8>Di0ChPMn
zn~L&sFbTw^zn=6cd+`xQ{*^9huBF^VS$oj)j{We2#Y`j3lV@&hd5Zr{G3`yC)2_iJ
zIZFIwl$6iMnF40_udlCB3UP-?4*ZF>O?Y$<mb0&D#vWD?C8tlJpqMyJ)<NDSf6LJ~
zhQDb?rHP2^Jfie31pd%O-Kb((5q7X&_&jO@8B!DYz)f>f4d`Q5H`x%GebbOpMWJ^8
zH>Qi_M>2e_1<UyH#^6FRs5A}(k1(#)jPdi&{Su#ZhTA~X|98@@p2d|D%ovWH8?lVV
zzyUdjqsUt>-<6`ngn&N{9PiIXQc&t}A*+gu>*;$)8_O5#I`hykBynWqG5LJ!T`}hX
zF>q_@a;$g%((-28_l^#9hP1_f4my9=^EA$-2y^T?mI}*xouzqF|GmcXmRV`+DoNXR
zLw5fbv(Gb<A}!NU4)0+sM1)RC#V+eut$Rp>B8TZ#N|m1?1u%nHlzhNb5u3mc<M_5>
z=ZGU)w&*_?oQ^6VXg5D%r~*4H^-jf6!SLm2XR?`3j$>^8t4Cb_=>`C$QGaF|1TCW=
z(ailk@AD00qka%n0=lU9i9Y(Fs<nUcbh`2_4N<WK05JbaB3?H~GB;#2svUk|;oYY{
z`#Hga?S(vRvpv>iO@&r#Y+!7YIkPWsmo%*~+a~KUKvJ;Ze$X2QR5X3}=)SoXeYA40
zM?q(zFgCz|F7!0(-#&9A@of7uuF-)@=aAJIUoUDnanqBjp95oP%IC<wmNk8eX1nn~
ze4%2(n1-!;rECCPh>$Vh{utl%?cB5Au~o)lO?gMix&>2^aAN%CqtqGxgG7s~k~qP6
zF{xtHFQ-|tHrH81uG}BQJrP=!czMH^iEd(iw?yjz4cJ_%Kcv)gfVu!^!?ewuGr*(a
zeoOg02$?ev!cuIMIzu2UtLx@hwRpBK)v-GF$k;hKrEmP*OAA0&GGP5vwwHF@^pB5^
z1vo2VvlO&n9AbM{=vVmLMq`yJ-6OREnKV2VHf_s9@;iR7G?q$hH3nqlet*hS*L$(`
zqSp4l{^Vx4__u?s3YqfZmRgqda+bHtZpmg+xntJv80qHuAI{LTK8~r$x_p>OUZSGu
z1BXv7^2?~=CT19{3IXsj8Y%5B!N&-25_LW=)gN*43TKU!3Cg$_6l<<b_=9VRQYP&b
zoz7b5{iQ=DISEOtzDduFmhLd78@Opg>s0e|Verf_3@=N;c^Rf0O}*IL)sp2FYB)nV
zX2lskzz%S!qDTXE=#BHqN`KqHBPFKqDGoo<@Lt-pVR3$@_`y68oFaYCT5hqA!P}B|
zc_`!Jk1BUD28QP~WYJo?Fu@CV`Kjt55%|N&8cn)mLw*%cQ@;EaQ5Ygnrwr1HbYn53
z(gW}Nd})pr;LeOARzV%@6vBnQkk>!Zcyv!T=a~|}rZR^%7UWS-YM;)QVIe)@*R}1Z
zdAgf%iD@Z^qQ?pp-=Fr%a3K0O_`glE3Y0N70(;CQ*3A=+hld0tY#4vlkKx}#7x-0@
zs5fMc1yaGmKq{3`O1?Q-qU6ma(o<YBP34)lGq3t}8}_Z)@r^sq*neB$%`V>6R}w9w
z$Kkvx?Tm}UbkT>h4;8$1{s_YEJXalwd830z{;_|0zx(@Y<q8{VO<0i*OEwiGJItZF
z(Q=hjtMq^F;r-H*O}w^o28VGbyHH$e9j$l$`ityx9zYbioujMXbFIXg0^As{)RLYE
z*(EK>J#4P?F+m$~=>8hg(CS|t+urWh=<{zMYSOGEjgOz8$zFppudqE$+A~~;Msqf`
z1-l~MUs@M#pq;nd0b{*&0LhJBJ)q|yAt><04J$UAfTjDs26|c523oITqM}D#g~`wd
zo(bf2M~|Fy-W!yFwGDMj#TtT3=<+Yt)SJI_*{VQ5=Z#)3o}Mr4R6N`ddQC=nNwzql
zS^Yu_mFtuqUSllqp05&=A!v`-U8K{Q#0MOGT!ewp)Xb6*+T5CiXG->~Wrd?-`4M#g
zKvF~sPaq7V0SIw_yj(@a^g359o%2ESjM^C<()f>k3a<%dN}Z9+9kgFmS{|g!7!FE!
zZ7_1*+}g`=iP?hxr&_On8kM)Z&GLuLg0~A=22JCj6((Pn-Va~e0o;=t*EB+*`5i2B
zDvqlcGoHc5Isxl)AmhzBgYRc(y>3AEPJP8<SI!%c>92)73jx^uZ<;SV=7spVXr_kW
zJW_uB`CMG<Q0!Jy{hNuJQR{ANpeVx<-&$hz*D2c{&PAh^fYB~VtcGRJCQ07h$>w;S
z{`xy%5j)MH$Qfq8!5OjR@JWl~&7+%X2bl$T%7io42@;|mao@%8^p7WDzGT~luLtxo
z!)lD7AIcTB&&m}Vg_5RRI|NJ-z>!Yj)ti)y%c229io$|V{eG=*?|{kf+{0NDb1Ioy
zT0-(_y@FnBBI_V8{Ex-8j?bh&v;xMHLuScOa5}M1_g;L%8|9Ymhe@l7;ZL?cfFBHS
z0T`ZWY;jmcPCk*gfhXrB3IlEJQw=*0DrQ`hDQu^USq!N~r#XfB*FFpi-n9K;aJ7>7
z_kxw1kA`lI`}>VSq{eTaPPJFJo{fzs>r5xU2&k&-h+4Tc<nf6R)6-i;AO|V*0cX#j
z6&tumMqeD*1Hyl2BU$E*c$K!|Ek;b=5iK#XrEf#9$6oKG**%I=;&HiIHV=~TTylIG
zju1NwAISKqX09R3cr{4n4DzMB*QO%4o@}`jQm8&p|9i5?vEP55zAGL>BHC`W+x?pl
zG6Sx!fWKQ8lm=_!jtH%jt%CNfLmJ0&J8$wO(y)(Jm?N8u+s`7QhmYn2KItoD?@|Z8
zMqGPmA<_%_u%#2Fhz0K}&j&wxZ}_ga51P|8A368J^Pi7-k%rbJ`=D7r^=Ywbr<>&U
z4327uVVTZjQYg(O>{r}v-dDK;ckl^t7eDLDN#h}1p2=vxSP`!Kl&60~29iPgz=z(?
zpd5TcmE8keBcWiOnpGQ-ycLTIFc3jfR9F#;xE-}-QHbo(4|)ivHWy(qdeN6akszzE
za!oFeiLX7;`c95MLWLylp`30!?cQ`(U&w{66wN<yO8qIE*<3PhQ2R?5fTZ(FW01#c
zkVN$O_Kf=*F;m3%p23&<Ym^E3$Ap33nDC%xB=FLV<t!}wqBhX@nV2-{u|V6cM`zcK
zi7+uidR56FjVz7RLg?)j+~yeROe=2QR8Xsd;6v}d-UqRB1C0bgG4X6DX4y(TIr~Ji
z-f+~@jA9K43ziwX$C$fhHa5)XJO@_)aSC8Ci0di2vT+^jH@8t;U{vM4s8M;9i`v9E
zoom~T!Yf|Vi};0t-J$!g!ycO)^Z8P0d{p|z+c)||z1iOD*s}r(1=x{L{Gk33^<Ot7
z1H4GF;Gi@}EEO(9ANQpTB%9Wv(>ds|@*D2(3AZoZpwaeF6s8ik7JW;f5}eQT-!GrY
z;M!vM1QJYk9ur3LaIm>h0TLBir~$b*1$)jU<*b4b=7V&^mSvq}s?N@zzT8B<z}Tw#
zgW%QnC-dCFe{$>Lh=|DCJABqXut(JdX?}`K3*OM>$-U`DHny-H4Wp4l7m$F#rdyN(
zZivMGQM3^h4qD*(qdHi~SiHqH&jmfPT@|N}eqDk(i_r<qLG{$jMduclIH3K*<us)S
z!=7Pa<0cxh1pSn=0BB_snQzJ?XCAri5X%|hUEhXzwY@L{$=PCJKplmgwWKF6z{c+3
zg+;nrl>X6ddGQ>yh`#@Nezv^a%*GjQg?bH3kqH!=cGNczluWu(J$7Z9;*-%g4Z+O1
zgmns^6;{OQD%`%Iw>N^FtVB1Ozl6a_6wI4#IyBEelSz*{lnHun#cC9$n7oj9A>L+Z
zT^&)DBZE3=8cK)?o}Tw9@2!0RM5Lk$j$qC3LXLlUU^3rlwn8`bJJ?S<z2(1DeB~|y
zC`w;H2%uOw$Y7~F?*L7<+sBjU0AOlVi|h+ZYlLo?QRT}VK{lGSE+SoXic|;ZGob`Q
zrq-zaxWA|NBq61(bMa0sT@JXJ#+QvS_V)v8=IkWsWb~JWWU2cB<u}*unCYuFV!!Vs
zBBn4acq_)+xaQ&u{Idt)hvSh^6ZLGqMg*ylAZEXq0L9$#pLO{Vmt`j`1bRa>)=liG
zy`Ra3<~w2K&Pi;)7`9$|v`pX|-b(U`VFTL2L$e39v&!Q<YTUkEBJ!uPI<X`N01nLt
z#ZZEx{92N69e^N<Uq8?HJEKlNME;gG8`Bjq_&tm;rqN2G%LQ=;+q&<qkz(Gk9-^5K
zYwJaQ?%p^{JbDoLnR#381wD}=33O9tFu#lS(ArCx7a(zwkiR+jcN13H;7^Jpx=9s#
zi+}77Ts>vdf<supW;(6UI~gOS+@vCtj$xvixerKGO!4N&MrZNLby04d0g-u`+a!uu
zl!!HuZ%y^DyFm#K1gB}oNWl67KZlkls=w?eA*3ZqlbuR1@Vnr#mrg&yM=|fQC$7+2
ztLW>ySdlb8LLR;%kQb>i**qQ;pr<(Qn8th-?r^gSsND7MzE;+@wqzC4`8nx5c~?by
z7H>;`MUO+F>HrlbpQ0$JN$k_i1-dq(nDpy^37sOL|JFB!(6?$!7Mn*x=bhG@+Ui6A
zl)Nnl7)lh&byg5i@chCV9y6JsS3&)xuZ;x3#u~WiDyU`kBXmWA!Qd2*@5CREg9v6o
zB)zxiw)?cc7&<f|>8q8vY5d)d;Rj}e$v}e|X(0|=NeGzz$c02<KE%W@#(Ulbv4b`*
z2V}qt9yAO%zDx&NthBQu3lTBFchZAJOSW1x(KLpJEe#%AWte#9CN{KBH1di(>TSeB
zCi;q8@59LaftG@AR<jK*_;Px0(2K1m@dqHy4IIO_Fj?6t(TA~AFN>o6@W0FTopBtH
z=ey<R$mdAB85qG>`Ffq%7>LBaPLcHmqihu3lY<wyYblwRKPYl~H`<Q*rH=+J6MM&&
z|1BXNvep++xq6y;>S_sTbM{R}xV7b062vBWs~Wq0;q;X}Ms|CpXMsYm7uqwf)ds37
zm}2_;6#}ck(ANecmoDC|k9pfCEfmV}W+>DjNJ7Fae{v3xl6jpv(v5+igx0B~kFk%@
z#>e|(m_uz9vsqRCop~vaGAA-Ak_(d_ir3Fn;UG5DPLE!!)OHf;a-^D%ATsglc~O8c
z@@f8+_;{rrRQrUe<7R(ze^$v>xr_^^_ldLQ1A#piYK41tzL~ppK!mBGMOQX26>KFp
zh#(xUzQ)EpM_N(R)T^eDWZke1Vu?yH`Tgje%}Q@$c~%2wL}~i^msXscbdaCMR$T0N
zG?Owd_#k!PNX6V}h&x9aIO1WD+LntA%#0o{?&t0lx+y$*l$>8DobArgE}^VKF*rtH
z3+n3ZVK}B`<^YZ|j=o4hy7!97tB54%{VP+=aBHFHSM#Rm^KS9AC-CWWI>=RzrAQm|
z_?(agm=CvZ`tlE--lX6gS`-UV`VP^zsWdt)etJW=bP$%LR{BkU<pnjOi&^d@U0PqY
zbKSb_4ojNP8`XKxA{GA6FaSv6JJzSz6T|xfAs<{gCwTb)lOj(Kp6oCW>0C|gW#P_2
z=!)fC8z><WU5IxfF~S4oD11)An=FSsy!r8pa@m^(eU~RXMABkXG(BoT2up&Lmz-~Z
z>~>nXr%!9YzXK;N<J@N8yQ}m+v_uWAD5gwe-yR3tihXX`Sw6nX<y7kXMuiQ+VB-hW
zO=y|d>mt;?vvIH-C<k5zQ`aV6U8Q;2n8ye7AdR?rikml6^oteBmOOPD$6K2HV)fS$
zr;6>G$?2Axd^<!%3FkcyrhR*(h~p`2_5yhIv26bx6V*d1N>gXgzbhlj=(3HE&a<LS
zCI+#oJ06_xkL&80cDMqY@1~dXR-@oC;Bw~#`HQ(<K<P`YSRmXk{`!KaMQLSE>gUUs
zz9H>ei~Dh_r$aoaQ0KWWv1xy!Jga2~4vt%7864>_D&)uQQ`35v+2Yp+_GAml#vq95
zgDmzz>)JsQ*MB5IoQ3lu8Zr`+=8TubjMJ~LpF-b=Do2p>>(+(VSE9YiyxZm1xFSw3
zqKy=<hUj=-Xz{ptLZ0MqA*GC3ta-l99SZ2Vp-Rc~7OJ*6oo?rtfx(uK|85KZNEW03
zE|ISQM5!04;#uPE+d8V=Y};dn{Q9osmc|3xzk1b$2C6En4<m62(qn#i%~~IGH{Zy*
zb0Z3&C<FpY@`e+I4elWfy)w<nK68erQE>!g-`g6c2c)%IbRst%Ja8L7JZC-$yaS*e
zo9E{9Mt=1?ym5zP<a)pVT+fHt#d5}Gdf%KJ9)&`pC~E)f4F1pUji*0HCfUy(bw@uB
zu(+en1$A!fdhWdQYIBS$edjAyp;h>GI=tjN8Hgu7snhRFoxSuE4iKV0ah@M~;(%&`
zbzLHipPGb!6NjV|#7vxhav360O0`DK+F0`M@wDW%R=+IlwMC<8o~it}?ngT1TFvH`
zUO9X0`G)KamK4bFigy|6T_~0wtzbbtKC~38|6t?Y?sn=inV}0Zjdi0)Tde5AOK13C
z57q9Ell1R;;VM>*PNH=!M(w-Vm{pAG%?n)hWRR-@jaTcf@s*(Vp@(cgq~?(lk+I-;
z`=;~elFW}B=!h-SS(g<#K-~J{Gt53%T?t0uL;?(76Jg%4&GdP$MyS6V=*3$eo_Q-&
z`t}itbxvb>I|%WP7WEv4PiZbhA%`e$>=|nP<xIqx-+8@8TQ{fh)oQ+nlY5U-(v1he
zPuKSA^8}4;f^=^TrMC<1jT(BJ_*lnEthEh8of(e@wYD<zeIS(vHTJ-IHCs7kh|1W=
z;)F;g)y1r11-J#l38S6OxtrmXToLj2@{kIrwT=b}a!OOp^NVA8LlQW8o^P!9lCC_Y
zEKamv%~7GOau3O-LYMAqwik-bYsRGzhGnb&Uc-M==fPo<ie$gv*iu?0_8S?it|3I}
z-J5lrgbDBueaE{$5e8{g7V-HPWD&hPh{tgCw1_LVQ(fy&S6Gx2r>ZW?8=gU8e0U!9
z(oN@-$4ev3xPSEtJ<Z0^;2-Yosmu6zB-@pBO}K3P#>BWX9mJxXP}JvP5<0MPXDjcH
z4vq35Tb`+to~mrK&LJd_rtmrYYWFTBh`ze|!|B?w2TW=23qI&m&G%UUE$Gzz+*{)$
zHiMkxD)MZbgNzoM+>7X-75K2<ElCm&p9-+~+TE~@>wJ@Tk4Epd<Mgh{!?2ToYSB~p
z0qP{$5y!QjdTqRE<4p-SR4zJfO5Z=pf^`DA3Vv5J{iJ-CJ=VU?5>b1;mQ&xGb}L?t
zevRp(hlW&6NHpQ~JR*_MhwcB5rSlGF^L_t!5X2Uvw%Dqws9CkCy-H)%tiGvHHEM^%
z-n%WeTZ$%TRgKz|T2-5xF>93AK_tI?zQ^yM9LMwT{oF^M`@XK%b)IL%M9^|h>rBjT
zHzBORv2=-954X<5XQqJgJxBSuW7o7G5q8~J=>%fT1111c)|dHG$GQ1VsPCfNjaU9(
zMOX*By&qO9=E1PCoTqF<0FF4Zm|3GspZT+DG3p2(^6Qiny?G3e(F8OANsQK4ij@9*
zYn<)5bw%6svX8GMJ*#Yf>-3R~aK0NHl%w$ebx<WAg$RZ&wCj%y2<QMv_s(hJlPoCW
zNM0}Di&<JcCB}0pgf<&uAUONk^lz)3FG`ymJHbGl!o<{vE_z5-Z{qT08#64zkT!ws
z9-XYCN5q8s0~JF#t7MeTDD8{KtdE(&TxdxK#(g;Hs0e(F_E*99x2~0+g#6~S%<;sG
zr~SJRxA*1IZ|@I~AzQEkR{ZmJH!zG#;DeP!+M-UOJ9-(K;?Ls80}Csh=M_zGRD2pV
z-4Y(6eA=`9_znMN&tgnTayi#At<ID8oS;+xfyT5T0y*5d#;N@C+jg~YN`7UQ6@L{~
zW$4DVxV7j~S;ScI%`2UUjlc-VuCkE;I>b!n8<0akC6erHw7(vb4ZWJaK+cLZf|qQ6
ziuMGn)Z4b7p?(B_(Fy$7wpV;QXkI~Or7wCoVncNh7~$Y2RME+qfmQ}}a^4|q5>JOQ
z#Q!KYN%EGgxQ&G-LvkO(FU>f~W2|nscyGh%xhg(x5cfPoU{@!xd2CEJ=%dX8Joi$D
z(BOVENq;I{!8TX^d3XLBABzeZyN}Vt;cW4*ob>dDaAMurHOvW~c+<o1zBVFMEY)Rn
zSo4d=+1wl4$U|tTn-Z3vIp_Fxs))cXG^0Ar-SBiWg>JUVD!B=f;`!tojA=^LZ@McH
z2Sz+%rSIex61jZF3=T9~?ED$W8B`=xr+;&eyWNTC`-2@L`po+yT|TK}4;fV%S;@V&
z?iWgb)KnbFWp#NhWeV`3HY`f}!(qXxcHq+716EAX9iReje||=4QE`{jUN5M$Ei#Dq
zbMe*e!owq}Z`>?{_oL|V$o^FPTrT<k*lkciBk?Oa&?0MaB@)Pzy-y6S$iT4<%yqnn
znjR{diUwn|`<lqmpE)>|t)G5}WIMj-VftL5kfK!gT!?(lOQtlAOP4XnUnYVd80=cg
zzBAQ0Gh95`(F`VeU-MV(1m4ESwEJzPkLzV;7U~C6ZQl0}CiS+j+9x|+QNoVT9^<~D
zE+CE>iY3CH#YLR5+dPClRl-K`1D}C}0+CK42YPcbPr#>eA*jJI8kCIfkbi)ti83Qg
zU0w5`;!?7lOlK!>J$dzvhk@@s0$}+Dys9nqUtK#NHJUzAPSdsJ3=am;_eE+TABDPx
z!pFt(6Wnmzi8JN0ly`i%jfHx&Dg5yq%#n<J7gnokWizR0rv3Fd#YYfU%m#-|gQCLb
z7c*)9Tpq8IRs+!^#<y{t0L*!{a*3TD|7R8komc$JX~z_cl*{i&84`O~7q8Vif_lBl
zw#yCnGIncB{K{MIcxLB^ABxbD2hoY;$dIv?n_!K*0%YGGC#vt&z?Akf*7lMaUvUUw
z$K+k>w@_c5&PK*!%3ZKK9imviuXS8kfo923_Vr@WNQ-Z{lF9q=+gS6j{?i)&ggh{n
zd=ZE}{7Jclu42?P_wf~&Er&u4jnC3n@Xgt3O*5?Jc3Si^OF{6hAbMp7P|){qTSlhi
zSXTTiLOu0t!uRW1Y-WVlUF+9Mo0x+mNr`qfiI@kU_4~X9dCm!-XaH^qs6od+*6k~d
z;EXo67E3UqR0KK&>+uS(HwsZR1T1{7yoe+nq+7sASwYkaF$)M;_>(YQvUdNI*&o1m
zwGr&*$eg-Fst8{UUa4BGOizd)vxlZsJL0lqWOLzVY$GHBgQpk0Ds$7l-!Y?~3Qn9I
z=BEOw`f7X4j8B%hfOG=`abZqIQXGhj!90$;-pYocrBR;2!9;NMQn_XRoo|tSeE%`i
zZr`O>$WSB3#r-cyy-8J0!*F$2`5^uYp1~EWW-`x>^_49qEO*TY8{n&Dz0YF_Yxu)e
zEPP~o<+z`>3L4}H`%h)$ONdRzLloynJ=@7nQFE3c;_@vZ^K4@GQ+(>aFV>IOl3PYx
z{&P)vQ-OC-Y_pW=sODHpk86}lkC1g4{jWABpbbbtoKOgTSarKIpMbZAI;sSB)^Pn}
z(5!|M7X3OmR&x|1-wSXt1ZywO=n3@pd4OqClVh#>=o8H)mFvu<v@ZDsWBv1k+ZMwJ
z3QF^NuonouPxxo2<@cUJE?0U1`7#jN(X{NO6s}g%Bh0V51W`opRoNlU*%@!hR=Ue&
zgq|uh98U`Ie}xCj+fYCQ08+sSEwjmLE;ZP)EG587KC)ZEB{gA|^+j%Q=1^Hb32mEV
z)Ah#CM<`9=QJ3}$Zdv`T)mDzZlA{bk5VvBk;de5e##jY^{KA8|oSs+bmX80~Jn%7G
z6<Xx(ch87Q`6^k`AwrE~+GlvFDUv<giP>#%($khQq2|%&KJ1DDk-L9%X-}LZd9~E6
zCiG&SDhtQ{Qn%K3(4fh24Tzm`dS$+S7*~0bde*;OUqe9CcvJCmDwrdpbB+VHVtkx#
zA6ED5=K#m+*Q<f_ey>F-C_il>k=I*<aLaJR(XG-xvyaBfv=W8`m(Ix0+8ku_15zDP
zHpp_VVwwX{ot%CD(Tz2Bn0mJnYFquJjb&U$%pUpkqk+tS$JQ@obBM#JjMEWU?L7jd
za_XJYcvIPbf3jE;sV!;~g;IvIFpoJM>9njT@XO7@`!S`I6m}&gnZK3?7L!KCK9!{x
zWA9?#M|*Jsx?-CN=vNwDVYCX%_58m;9jO%zsLm|;yVO~|*aS<h#b0EN-s|0e{JN8j
z?ArxSe{?d#m|!nFe-VH=ox6SUO^n&=CGmeQgLQu3x$My=s1z{20s#Xm_<C~lO#87a
zS)hNtz&N%bvPtP^38UD$y`Bu?d3E{-=OAgv++SVpxzqlBz7?Hev5K%NdL%t0MKn%;
z)S0oAXW8uOb8KV2+rmFXC#<Ndq+x2`TsT>bE#8EGLVhRw_=DW7(p>XlQt>^cvP>C$
zU=TSbPpr<7O7^4AqiyPh-77k7&G%b|bEZIY`bI%dDWuUf-Az_8XQ7il2W7Ev{KRp<
z6R{&6e-9Lzx)%AOQ7T2Tk1gvgi(Wm`?Xhp6&t-sP)>pJD<1P}l<+2oTd=%|^T~iD4
zF$Xd*sfNHF(E|U4UKI9987#m|2&@uw7*ROc+iC5?!o#dMK7PRmByB(N0?fD%h=N-P
z{`t>G%o_h0(h2In>ZY}~>QJ&#9K%?w@|0Ih+vF;61TABQ2i);w4LTomPB1a`m(au2
zk6vUh6Jyb3T!v(o?h-qe9Lc3qhXss+-4$yt*pVOcwFe0rARQPiIc-Ih+^$y|-lfsV
zy<ApF_j@JlqkoLR>g=0X<&{EA42x6UXK&EYp#u7hKTqdY<L=2%HKFB;2r=3*q0;jv
zC4XfhR9FJjttsZ0#_F>Ik@u$G2f-dxJYH@#CE58pM5P8g-RGp<D6EZVp=>vVzX|z|
z*X}V(NPu=0^zy8Vc%5@orW(M*Nq!7H#c8Ho6SXCVa~<q=@vG^olf-Hz$#XiSV%Pvj
zK=<?gkLfG|H=4?m>f3yq_?Bm|_L(LS$SNm!Aa%ti#R?2v@9S^2$Lqm#n6&<hT3#Yi
zn8Me#l|=%`)+)gS44+a>3$pP<pGH4y`dL(n#tLB&*XSUaw3}DEwx6A6)3Dn+Xge$C
zd87ihIx*G)ut1_|im|CMOPcF{XO7J1J3}t!0C|xaSSeQheT?)UXMmYCqX&F}zyXRQ
zf^3r*+hm%xm}7vuN7gDn@eD012|&KuzbyBaIsK?SC4)(@*roy8w-P#58Z66$MeVL?
z#fR>~sRb<1o@@}E2g;5=%<hXsuN;fslMdCEFFz|otD+pys(Y<DH4xS(?@il*D+HYX
zJH8InHKl4#G%v~)S!F7M65)v9r~T;be-d2VP50XVh=a&Cl9TzfSuoAP7hxdFbK{4-
z9Y62UHr4c|K-hUBY8v(ky1!=|!xzQ7lx*rP+woQ7--z;JGl@w}#3vEZp8jK9{H;Vz
z$+XUJBT022I%PGz3Xn5#-j#p-W^NbFU$}<_?;eYgdGD%W2`8P=q*!M<sTEFs9Vt8A
zgy7Os>~pI~`OV@HwSi$2{%wd+c*N?elsrv1H<c7n@i3>8BvX-^-_=m{-i2Xg4JCQ0
z*0T<usAlyRvD!ejCojMjuL=DgC>OJ--+#^GVuybBDKhewr*Io|_V;3sqm@>C>No0~
zBTk(8AWM%m$d;#&y-l;hVYme)tfA~>iM!OF&FZy}r1YpuH^LG$;tWch;aalodv=(O
zT+?JFjf)}jpZEMArG(d~V~JKdjO^3EV6SQ4hJnq#@D&T6M@^QOuWDmF7|{nk+&m0r
z+Bx+iJVpLutI>SG2P$10XO?OeTyOqVCVQBgd(D`kYPlgXE>2UsRgvIj`(ruu7kJ0O
zY4ri9*seKs6?SmF7H6iu2s8uyFfmL*6#hbVe&S1gglEGN9%65^Qg(NevIRrTWKCG2
zpJ}pzb8<M?)nWwJw1F-|<8QUe<{jxHD7%C_ec%IRR;LJL8zaM7`4>{Mua1w_J>s<J
z4-(kYHY7f6dcOw%hkKmf*ThI0B~La6PeMyjc*azx74PZHl>)fpR(uwO!zCC0^O?zu
zyCNTdr}+Asf0`;bF3urB6sJ){H+kM$oJN3c58Gh13%7RE1ZbM)$Lu}H{+d}@G{{Z!
zmSk&9Gk?>k3EwCC@2oZwaMM+b;NYOUE0Cp>`)<hD!D=gi1vfYoBk<A!B**c!^mK(U
zu~TI2zh<5;jZY-!!i*gt;6S{tF@wvel?bya87v=~7AB|=C5otO-|tNz7Q+gI8J#K$
zF=9hFHvt^zENNR~UO(Z1vo5J_*>}R#wBJ_LUS4Yr2sXr5<8_2yWKy{%@cv`2``*#Y
zu$TW*TLflg!rO8gQs*;zJRLO5ba}uhvdW}p-9&7uqp?GOGw&q^*!j)~fY)Sc9bYfe
zV>P*#@{Y2K_#<3)T|yLv`W;oFqfa{7pvc)n+v_|lM?c|j&&%kYNYWk8;6&Kl>c?}o
z27*HtpFn8g1Husz!t`MHnU4a@i|;O$eNqN;!)th!{_-j%c7iH486NEP1iTYE0!>V(
z)rg8<Pf`nCB!Cl(8EIT|at-;MoCOiS^Mn|`OKr+Tr+C?03g2ge5qizAa7$!I9#$Z)
zpA*+1sI;HRAmOJ)#9Tq4-`?y5^_y|KxA*zm-a{d;vm;DIzZD@{9(wqcQ{`FL5_Ud&
zCM51&RYntaS!4a$gViv8AxXr>P~aDS%lVv`09)=cB%VrEeioH9V`942Jg=uAXeiDJ
zqO4v=Uxj>lXUY4$|679Cnai6maWr?>FUulJ*VWd&*AePn20frM0R*ISj@;-LH`mQo
z0=0_b5BoRnLzHQ0qZ_jQUUt<KN>#V_%<jPZ5}13qxzBSbXY1}p%XG$(*gX$d#|U5Z
z?$2p^=BDvbkSM&XRv;KKwcSgKDsU93-=m0m);15qkOK@4$oe}Ie1s=eA|k@!3W%iT
zbT}_dZ-aBJf8AqWAI)sCRn4|AO8=-o{5s9W{B!56OLk12R-oN_hCbqu`LuuQ<%1EU
zf!gp{bI@VTiJNT=b44Tc64^*pqPUd_65+OWI1|*&C-53;Nej+k9(Sk~@Ght4HIx|4
zKvsG}KcrSP8f?Nubqlx3%^e;hr>*2Aqc{Yon?ZCG7(jgORr~*tP<3toZHo^O#`x&-
zJ)ne&^-n%(jC9Emq1yzs;u4_*R7&A2ym+A7N#WW3Xzmdf0_%`ze$+#Xy7Oz85pYZT
zRwV8F%(jPOFtWVyoXNo2-%Sxh>Tn;;y8M)LK2?%~uab;=7Nvsn8C~%q7yt4x#-wH3
z%!D;@5EXhjWrdfIFf54%>0YF~6M?K*t;3u$80&7%ff)17%a3w@<9IW&+a=D4r4ok|
zX{32|TGFLE%_>gWopMz@YPno`t>^}mYAoRGM^k5SwfE$I1D2b+9qmc*93<AD|Ek7&
zbM)C4UlL`;#tH(Fk;f}?X4CrP_-O1IrdtjLuIxPyvi<x$Ucr0fMVm<@5(l<=*>Un=
zwEJZS9+>jwmR|J*%1)3-h9)HRW=dEy(o3m#u3aIg_?&o(c#t1S!?#1`^nUI4K5!n{
z2Nv(ZRK<*#RX!uTG*0;(ulGN~qmXwQvD8PAH1?D?f9Ir9Z)Aa?_hqJEwu$@=JQ&*^
zY3PihQs*<8gJ2%Z&2illVZ1U<>w0?fm12M?Z>hs|;ods~f5_4OzO|45WQ^+p`8B6i
zY@^CY4G^dU_!&Msl!65B(gLEu#ALwRg02;fg~l!#&)wXs55M^^WPixIQyBNwFNE5=
zqhumKzP2tRu8vwh>hd{(b%ko$17)*9wQ4X)$_+Q29>bH8EG;`!AJ2RVn!HQ5I4EZa
z^~_?QY}E{rtE{=_HEZ#V+9`1-9lyNbnT*_XjCv~cuDbws(e%TzvFd-VWcyCm!D&y}
zl0M{aJ`syT{Xg*BkxL;xgn&~?XTJJmQ~CoeZHb(LBr@Pxck8q7`pD8#Wm6&+trPZN
zAmPUW*7gMK1$@pY<A2+-gFxukK4;78?2F-}Y{3Qh##;2-uc(aWb-0yT1Uxk__18^!
zI&{|Cgrnq{E>N%`%HgDpgF%oI)vNF~>|(4X>^$y|e3>>b{d+}|4tO5zt-k}2Bz|Kg
z)9Fx?3;pNR#XiMOmSOW-im_pxzzcAlnNB}K0KCQcMm#LZ0wWZ4_+r%-NtMo{gVLjg
zX*+-O=4|ZE5+TObwD-$FZ>1IxKv(ab@|<hm>CqcM0&!Kpzm_Z9*!ovPLG!&4oY3P9
zvTcMD<c#%#Qx>gwHFl5vEOUl)K%R_2F{VQ@<acc9sVlas|G-T1Xx>5YHQLQhmF^3V
zj<xANTvJQmPbDAYD*PPKySKvH^R3N9Gd*QxK>e)0Udrkx1Lbe>XsMp0r&5%Q0o{F$
zIE-#o^AMx@JCN=#JYQ}|B{sJ$vv>GTIw`n_yhl>9%_je0enK2@O^x|33mIdIr8w7p
z35@Xz22VCx!CMqlKDu}TkWW&7AYI}z!R}VD$n}p!z`(cf@I4>KwmQ(mcJ(eb0XZ)P
z?%(yj4tx(u1ZOC(@jLh%umZkPrY$QP?o<|BWo0QT&N^FjKd$nuc5Jw}wPM{z_rsI-
zFA4u-&Z7W-_~pru+SJ^RbWVf5*QJ6Ig0ap72D2Z99L40o#C43-h`>L)7iK2ZEMS9B
znO`!Pd<1ALV6ozAjL;hl@U;A6;Tc9iXN1#tKH9_Eah^Dnd72k@yi&!QX3x}f^V`~V
z41SwuP8oN62@OWKmaV$13Z9YR`QilpFR?|h*kHPBH60Fd9eR-9GhbzVL^J>9<Zy>a
zE%8Epk+L=S_al9GmkouND$6fvCopfFyx={M)rI=SfeSK~HW&7AUtnVz<VZ?!U3p2n
z=mz*3bRpO4o`cObmm`$k(_;2VT{kThJ_m+it_#LF(=i@Sqzi+YD;m$xJ9d%BOG_(i
zV98aL3e)ut(d)#EX9}4n1k7VG--+G}IzDB(&t2TfYG`hqBM1->!#`$F)eU$uh0PU=
zlxjvCui)3@x+!JVAw{{oGwPbkbtPm2w`w$bAgpg6KYvcviB-B2P4<a=cK6qBvJ%sT
zfVtR=L@cQSDDRBrkt7Bo1yU!+e#8ZkvXId)1tZ1SB9!G;)lv}mWX2a~i8eY=XuA(W
zN;1zhY2k4x8%Jj>|KJgy9jT*6_1`2;`uF-Dv{)6xK>`m#t)I_#iz|x2By7UF0j?24
zPdLeahJqk9;>c0c!JDpcZDOFX?`}Zje^-Nj!`r5sVQ%f|9s@tl>>I`g0?dWh26+;L
z>)E$pTGcMiDQ+rIbH}?24Y59vOTSD^@bGQIz9lLB0<j>$&JWsNYjOWlekpFJr1$?*
zBLDYs>KsK5E|1s$gjuEBF^=mC>c@iHUxoWAehq$bi$?YCijrlbq?@{p@ss&X2v$dn
zIl+YQ;bV67QmvyWK(d++#_IHYd$OYuY%O$5J(LByZ!iGrbA#GfxL3X6dsIGC8!y93
zX}1yO_}XKN&ZcF;)cujZmwI;<<E$fPo3L7yy`OJ?7ixU>H^Y*m{q9Y_wWOpdb_Jo+
z>7{xmIdb`_EAG)!c_xQAA6CoeMIn3*{pQ$AQ%l;yjTG=Kg!1Y&{AZ|d_%29OfdBN&
zaV)xYmDsMi$Ki1}oW0Be%87UVSl%Zp1{?@QcQ6MH0jw|!ck7El&y;=Hq%eYgR%c*&
zz`2FZD$FH9VxXspRJYuFTo*CqC6R-n-~E`%$9-wmMf4`$q(4PsWHe9R>rc)5kN)zf
z(etr`zIq`4F<fuKA!@LHE3@{F91THS>{p=wGEr>elmfHrE1Z(lmg!T;>pA=%CiQQ5
z7LR@EzL!-oq;<GSxvM6xp~X8ruqQ!ji*K}Zlmp)z>rtv4-A%v6Zk(_j@B9}ti|73a
zszX_<Oa|5^0^Xb7sUzvdMBme{PK?tX`9}wDQAv8fwka_BC!Z77Zq*YyQ&Xl2`g53_
zgxs@bI`K0|`2ISG4F-LFlo7g3wHm*_E_vAkTaip+-tIl^wwoG%Xsx+>sG+P}PFN=B
z?u#LEf?lcYI^tWzcChVlUzF<7>NJ})&eVc2Z=u8!rnvmz=VP}VWOmf3aZ>vO%v(gq
z8M`u-TLM-Ugr;bol{{6&E<F}o^+*n@OJ^YMdL+#?+?71LtU^itN!XPVFH^%&;lxK9
zzZz%fHK#tYV$MSFsq~1GPrOHUKT=bb?sZ|E(l}dh3$2!28I=x~k8>K{3A?faa=o{t
zhF1%nv?X$93lAI?UN|uJ?xrj?aXz?#4j6_1or&E7uHC1{ay7TfIf6OZjc3!C;e|RJ
zhA&C!mdgKFZL0RrvbE=6HSdwsZT8eU9$onS=GkfS`{~uSppnG^!u-_M1wJJkpcBe&
zi+YM?j6Gz(SSs$}E9Ls{=$n1rS|j0<mj1M(Gdq|?lP{Szte&WB1^TG}r#n%_-OWZW
z`;FjZe7Q!xXtYSeAYpWa_+#;Yo;_DLu4EC+o6A@t5KI@QUNcE{p%d2GyP_<>NUdq{
ztG@z5hvELutJ+>P{*yYP=Q{i>#cf!KjS(cYk?qIcap#vU6wXGR^(1dCM>g)uuadm)
z*!xZ(;F%O=uhvyA6-DwmNvB3av485iUx-=fHuY**(p!M)Xpr9!1Dc;?6Bt+;bDc8y
z;N2#2?1OeW{7r-j4N3ejf2+|3<$stWxrz_dK7|2Kah6|Q-iG^mK8|ABc$d0ZAS`o>
z*9Tz~eNi2p@H7b-_NTbDqQ)c+wT2vq*2ac@NO$hfl9Tw)tTQ_cl^+j#Na-B6DH|to
zOPbm{mH`&(*%<2_BTlP^6<^S-xPFpL%kOs~s@66PdmchnC)aDZ$Q^WkK|n%(Oh<@g
zwm=R`h)i^NUYP?|_6pVtm`XFnR0o~Y=cK=YeW0OiC!BSgEK)%b_{1((Z>q-;4!lvE
zK#H?j@M)W4bD#F`rpL^h^AI9)R}K+dx*UGH&BzVMvU_F+cv<?PzA%3CQuC8Zqx8QB
z>V|}<8s}4>>M3NsvqS=Cv`f0r=xY_qP=7cD08w|)C>M~G3sitXVbxYNfI&T~h4Ipx
z=U_*M*x*ADSRM#{dsn+H!d#K$NXiMU@QgP99W|-IIW2i>1xKB2E_sQ-e=;Erx*5Pi
z$~(-4Ak88`zXw+9rbME+STvy5kCr0q9Y6u9<3Y2F>OkWI$L#bXvt(9ZXXxEP2t(2|
zE`gi}w(4-m1jBxAC`Qv|igc%emXtKWy3ooYJL`3;!@aEe=f}P?*?fp<5ft+C!@9{@
z)U1T(iHnO;$fd-L5MFTXXTYWMCE5Xr`pmSwau!W2_V%@jjaJ(M$rrJgA2r#nNY(h%
zeh_XrWzL2Tl$y{y7Wtn$J#zATbJd|f`bO7pRXuiBgIDN`XRQm=j&g=)ZQ~?eqbM^+
zsz&u*o6O)`xxN#50nO?xQ_7MHqK!6+K~hfA>(xdcXFaQ~c6U5#b61JndbD6Pjv;lI
z%9bob1A%GYY!)?TWc(u;FNOYjzfC<zp9lwVP2UylTeKuZ(NBzK1{{y~<!Vf9{WI^?
zbB6ci5@D<A{L{x4zWyEGd(n4glg+_SmqRe-Qid40k8jXeLrp4zWgS9e-=z=@KotCH
zCH@+c-2OB+HZun1;GHm|Y&!@}4zK)N$+Y;qlj25){ouU}U@^2(?C$j)d@uN+(Kj7m
zL<QB-_R3c>`!)!sPnY66i3TWXChuX(-o-?hie%fO3{i7Z><NW&vujPp1AB&V@;*8S
zvO@{f#PGu}A-!MJ;;(}PLl{)bD&FuxkAfm~e|)>2m8F)#0@U@PiDtgdFk-h8W2y``
zc()$=4-FEl<BP8V4;<|<x~pG9^bM|_wkxe7U}U}`2z6$1NsM1c;`>X&(jeJ?RKW;!
zQ0U~RebY;^uCk=9#tK#C+MG1~HVtK;ISoTm+m7}lr7tP@s@U5by&66_9Rl^^SpnvL
z=KniuZA?e(*@A~6?usFHZQa`0X6n+z%2E05pU??ud*3cwD^|bte!nLjhyA6fH!H@r
z`J~Ll6))<XS2$yGP(3_I#K>Hs*5q%#6o9ZFOzGRPW8j1s*u!aw63Lz7(y$_ya;ssm
z<B8=LUu*8?d~yzmlpKFJwTbrl2knOGr|%5;;ty*zRz0t)zV=|nXHce4%c~i7v&m)e
z6$QcpC@6+5L*3?8ls><43(TlqU*gH{3t6>V*rcJOoDw!s(Ny0nsh2u_b2n2l?Xv`w
zYOiG-DoSm`-oLB@7OysK>ehCHO#5}boH(LS?H3mz&a~h2yf&r)Zj_8@S8OI`{lRJ#
zWCq?ci~pxaq&L+r=lLDkRtH9ak!PI84>^4BVB}@sq*8Iz;@qOea~D1FsB{J5J#6m@
ztIy6mqJ7%CIaTCQ!}csWtGPM3Z8zUjuHn()e}tZ3{%gfyytkvmF#gN+XYIRri5SzZ
zXp!DMw75;FZG=poK_klM<=J3Pje~f;m;@wo=A9(wagPIok!HyE*R5r~FkJ;>C`?1B
zFW~shVolY-smsC+9DJU2-C*F7b|k<CM&txiV%v|`4Bzb~sEL9CZ1|;fSK{|@tS56G
zF1=3!!EWQEw{D9^xxN!8Qs0z1U`@qBt3+Hr4XaZ}sY0K^<JW@>>W0Q={2f#tyZGPE
zbRF|d*dS<b>4mdqk!n>&Ed1CL+6@7wo9fM~WlSevf1#wDgcM7yyMlpW?D9L`<-B$H
zr=u@A0B?8EQBa_Wx=HT<_a2+CkIhFp>xX!ectPrZ)g#uy{Mxni+GHKU)f{B?T?kk}
zUaS8;ZYFP*?fIpiklYbO<l@5C5d;l~dZ1zgbLaidCJ)#CdqAxH-K`n=?IueZQvFfp
zzaRn;45_OSySLgP#M&eM+3>AM)flM`eicECGw`7Ph2<WKtCxka)_A1bn|ZsZexMdK
z1>081xWa`4boXz31FFkBI(TbZ%QWpR-(Q?1M9Ccc+CR0+sG&Y9YdqFMCGWOYt`<?9
z#}hU-cCm|&(EQo{Sxz8majh!(>SL^|V6XFen|gZ?V{!`70-XcLU(OPu=t$E5B>$q^
z5GTzqToIvB0F0mS7lxXbp6h|=3BDvMTT%xgTMDNX$(L%<uHu)${d6&Gk%aD43dSla
z!fGu)MvVe_ZMsQ8>GoL<ppJXGQi8D}f9uVe?e#j?GX6KW5`y}o{}|)}@wC?befxO}
z`DI{f+p6AC<i<aeoIvK01FGrD@n_nX@ep*b2xcrUK9I`ee@_IvoOVnR3W^iXSE?!q
zA2-OR{9Q~d$2+;?@nDPCtaLmh26i#&mO4NBMw~qpc3W#xPW+todR>?VW;|Rt-h()n
z3TSRKGI*j*z~h|-(OPpXo@7HwOdeXZFR21`jwp`Z+AY0J6^`tU`Mc%ES9+M`fmhz_
z3{P&~cUpI5_YLGsiJWu%f-_o;a__!H+aJESCh@1{)7}b?-ESH8K$SHC|AGQsJX+Ou
zW^B0Ik)PbQmd<k&74>)IRThPJyMlFX%5;FeB`POhB-`_%ykPN`k&osS<x{PjR~q6T
zRTg`cJz+b$SJg1aV2`1y6Dn(#vlu&x7$r!w#p6=~Rezi@8TO}A(>1bQGWO^)%f&q1
z-cI&D^Rx3XIzvf96zxMw5-9~xYmU`8m(ElV@kV(A+ll9d-~7{{BXrYQ9mcH3!KQ;B
zYwA`Ge^b09?uc>^izC?FP$OTKB{vcH>3D2hOZXP?@N9<=EB<(7lwl)Src`uRo>i{I
z6wNj`@Cn~;*E%C^?#pAztJTtj(NO&o4gBg;7KdIn)R8OGrrNrfcl|HKW2D=BZx6rI
zq_RWs4;bQ~;a68*g5s~IBU&$IdCd8-%MM5*?F#gPw~-^zK{mSMTDforwK3Ci233#?
zI(}-0yVYCot`PI<9cp+z*z*bTMQKS0Jl%aAj{8CjzI?5A!N~<ln(g5n3ilYU7BFNM
zWx_3s7MaRWs@d^ZdN2*bc($ccoE@(???E{1pTtc*j5~N3BG2`G26UHf5W?-a(ih+v
zj*p})c^MzY$?5o^06N?8^l@bD?Hhk9M~N5B$ydlVk9J~Ds50w6sYv83tK3X$DN*x+
zU<_Y*CTa<j{^n&Z!|>nlXi&h!wvkL8;oZdLk+1Gawa;6RYKdAZ%ZA7HUn9mUh1XF~
z=rmj|z^)bfzjyv>Im;iTUv()NWn0ZbYcmz51k?F_Eh+Ri(J^6^KI>-GwKJifdvRv=
zX!>KdpVo<Me_}AkrnGrdpz4ZC^NS~92g6LbYF_eaybaie#3=H_bZg;zEE#MY6!{pg
zQ|Jv8Y4&0Rb`+D=nR8<8grUc7)1Oweg;Xy?YqL<-GacSYtY|;U<CF!qr{9f_8ocd_
zZw#2EBqe3z8&ARRNAT1$h91U^ZFqHn4dx<8{zBQr!7xJ|?(hcpN>VRZNEF{l;OPl~
zLT887cD=pwjBCN6`m%kuzccQwAsgc=K1W7yWt_UTMs{|HR-!MbBCxG>n^0saHcjh@
zWSS@>f1v0<hf|nq{6Cf})h0yFM<ruFca@tZ_xV+`Im%uG(sk1@B^&j#QHs92K+^3E
zgmzviW_cCBqp8cBj>q!XPs-4;kx%Aku~mmQr?X|*_7O+e=$=;8s7eul$A(b*a`c0y
z^|*tz=La1QaQiuG#=5Eq<~KS`JHpH<Rgd}OPkj1Ef_oX?WUcc*>uh<^Txh+}r2NFl
zfjepyZaE8_F3k7+`Ql8J$`S=lP#TL9R;}l5TWaKH>C&Ad26zeMrE0_-dQo0H-BB${
zwFkAm#CmcI6Jq$U>9ywAvP<4A3ilc?nA?#A7m~!JaXFH_5MQj=QY$XbdY>%w)RZeX
zvbH^hEf5&$_%>B#rLboc;>kd0W{yzuYN4uT+(bVNbLW27g8ERYh+ACT#zv|@EhF5&
zEUmFsUA|$?4_FP(N&2h99mZU<dvHipeaO@)dfNq0{`kD7d-&^qo8`|=lG)UlHaaz`
z>!i&v3YtfpQ@8%SfB41_m-*>x<3|=wbl}eMz*hO&%n*O+0(?L*t(9dqNFT^;*pGRK
zn${+!>m5ZJMX9~wYZM=$rc(o~zB<*OpFo0zUQk&mbTf3xuMjEx#1C36Xu$7zY>XDN
z6j|fGrma>q=vF9+bwwgu<RmXLNq;<yA9^kpSM)zBAmLqOjghXJd}aMT$+g|K_ce^w
z9&L#)RZVtd#hy18<yV+IR_aLt@GAt_I=&*{bRyBG6D8Ge3f|g6(ra3gHD+rFaDFQ~
z_)vIl=7P`w$2C4Gy~L(nx6rSl9cV(4GXxPMoa2*|%LnyuJAoHl&X_`IfQb-3LZ;S=
z2t6|WYP4tFu_K!wVH9eG$$6>Zf_oXGN=Z7ap66~p^;v8(=u#-S&N1fmq$j&{&HZJR
z1F9amvE;>%ps@PhdU$u`*gvE*$^*$=ET5f|wD%5m!~_}pohF|3Gf|qzy~X7P;vTVj
zG$shmrJX<$SBtIeKOwh}&<kkj)`SQ)WpSA!=T)~!{l^c^G~qYS9s-YJozl|o4QMHM
zuencmtbgQg4#!R15BHz(5Si+DtSb0HD9Z9;YVB4`VE8k&<e3(ky_{YPH@hW5x3I*W
znmeCsMPU4DSD%A$!k(s3Owr+_XP<L@QQkxiBeBa;YAng7Yr7MSuOuFUrN@K$Yb~#9
z4DLCg(Dbgd`og28l21HA+XFIZ9;>ab$3xrQ!nWvi%d2k8<7&%q9iKBg9Ne;NKwr0>
zO!&{9k9~?pxVRCWt#U_7HF<FV?ZPSQkI=PSL<cq}(GL#*HTosiO(Zb_Dv?d0?Q7>e
zfxel)T7E}n*{y&3=uF}}oFFaCdS^#co#iEPcvxRNQnF*a?eXU_cAX><`q+MMsdmbc
zVY-*vNRGE6JYS~e&Wd*WFU4e4?zAU!*9$MWYds>z6vd`L_n#JhtigT!={)vis@s!M
zN}SK5UH1uHMwi@HBiSs$?fX9duy%T%5O&92IO{GiOMw}w1?zk9DGNZVJ1*U^30I73
zpM@X)5+-Zy-yp1=!GmV;E8zreX#3a&{MR|*^t@Y1*<1fV_yzo$@TwNqxj}e!eLwZN
zjIlHCJ-dPdDSyBJ)cODb(vQgF+qXZFi|e!_zV~D-2>X%<wAyViU!MDY<6W5XYk3%P
zv(4ZjJ<4%>ey}OeyHfj4rQ|GLO{Of&DRj(!kN5Za@*LS8l7H9gypto!%T6H<R$l>O
zZp+H(t>eqypS*K`rH0^@#-_m0e1(4@T8BkGlm#J?+t=$k?G4^|Q}N-!qx=w6J}xeb
zN%-v$*s?mA(@TYaTwGiV`Ki|}bgLv6-P?3seu3X8)np1tM*etv|B;Ue0CXoc@|^zu
zk5ia<q$&z}latbi*c=8tLnyE=1qH>h&}}GOzdWJ_hxHCT0z3og-8-ftA0cx)KP=|I
z$C(~C@Ia7uUzNj<l4i+zaGfvVNQN<BeKjB_FUn*kTX<`$;|M99_&8V~8H@VNyixtC
zHau)^dU$Hiq$=DiIGxa!*NRPfqq{!o%I*On@=x9-iQz$~xs3c?OTiswrZMYuZYNDW
za!zki{272yB7f~j>X@pAt~c0v?VjpCN%TCBj=ifFp(nCj<`)io)8;1Uc`+UStQe)K
zp`1au`SQ27dA{?<gkd$TQ24|nbP{up7=O2c?o)nfJ5FLgU{TE1EjibC9+0$ETJ3K*
zW;*ON?R9Teb0!CV2%lPH(${~H4W{gs_!ac4<*Luhs^EYl#NP@ofkdum(}@Om0c`mi
z)`Xm6{LiZZ3XXkx23KtN-rqvUvv(<q$2@Pgi2=HoNNst8$e?S$agNapZ`tVXN2#GR
zy`w)*|Jz*=K9dZ1lnCwviI|8&k@&`A?B98oTV0u0vK8XpCG_hP77YgIE@R^|N`WUQ
zywUcv;_hB5txk_cG<h2&Wx1O88G?3*j{+%Q-kiSmDdyg>hw%?qG1sius|`-O{oXz~
zC(1WFuEq|J3HX>@(QMlq+B+?2z+4u_)TqmIcr?2dR``vgEQ=m5LP_O7#Tu)lZM@+0
zsE2$1!{3+7Oka3F>iRuZn1%1g41N_f^LWs0swk?li466+j2gD;PnR*h+203_c=D$2
z9JJPW9BxiSkCdvu2dCN2JWN3DqU=3xi>%UCL({~^2<zOwp<ivT)^4MqvkI<Z9D~R*
z2V+;4Vaq_4L;lNP!L1)*8|9s-@L8*Fc@+{TAEA+qZe;P+d{-itwsy6`S*)9!Kd}iw
zF(3Z@?SK<KijxQYVd}R!c(la5bLsj|>c-TU+F?O>Ru8R*U9);_{Mrw9$h*cL&$zqP
z|J(XjwHIact_D?QQn5LW`4~wy|F4#?u^!^-(eiDfxV09o?=;5nWqCAk|3e>z%$h4>
z!}Ey}$`4--Vz7pTGjA4)h>eC@Az#3C!IqD-{5@CD57gxSHT;&KnIWFfd!G4r*F>1u
zyPAD}r?pYj;%Tc|8)XM$@%_b9Y{{z^@qM2u2J8JU3-A5DMRw=Xqjh)RU8!Mhb8ENa
z;ppOvfcy45Yl=zLqPxF7t~FaAg;QmPJ7ZP>k9(i-7Iut=>xqTk?6DNMqOt=}(^frl
zwU&mqTe}@pXLch7y%0z`MR%Q)9kY*;61}$zGdGSu^}i7S6~@cy?+3%l6KFu6m8-hC
z<7G>}UD2zxkowoDtUdDm>s4Om`6=li2%uBi7yoGt(9-~(4RZEN`-w&viu8(FcIc}b
zfHr@pbP!W@F#)K%B?0z25VnN%??}fEQ#-3C|2h+Tsl6^c@hjwuj>x8A+Yw=+0~!}3
zmoNWG&92e*s$P-<I?Z5ns%Dqle>+0PrY%M=^Q)Yx*wpQ?f;qmtBBtN69M1H=>VkQX
zqZkXqJ*M7IcSaTNHcq$0rgoav?tHa?AUE=qKtXC8)ej#rl9SwelzsM|b89n;?0A|U
z71N3|%t`+o%|8B}=!rv|f4asQtM|T8=en&OWV^A8LczZ935hbYE?IWG{GxU7Qm?d+
z2s_2hSYFR8pzk#O%Z(<s%XfXb#kxhIO)D0|!=<%(|3jcNo)q?YXLQ)^%CwsR*d1h0
z(}5`48r$l}nBm{~1VVNP(TGayEhj%gMcMd_ky=NE+!%k-Unq}+(-eabpFWuOOdc=x
z)6J>2lFZJIQmXcdyEg2GuygRdy|A|um7#97fI_pPwOE!CN#(hI)J>Uk?kkJg_i4I*
zDED4QOZmHTHCHm{w47LWiWU`#Op0zIYe(bu$3LX6Fh6>5e&z^?5E{&y_N_8lEo${G
zI3FW+$NrumN9h1a*XFQM1&in3ITb=egl8K3wz}FF?+OY2`21a)2YM0i2!`%<FiKe6
z3L>*b+dUb45x6JGX1guhu=&xVz^VIKKcle+78R{a3i>Ie!GzI*E}eK!8b;lHe%SP5
zQ*(H%*w2)BF!K-kdVceCH5oZO)8VyvO@g)XdVS}-SO4ELV|5$CQvbmYpV8RjWpLmf
z2~0s>=<de{NFuLQZXm$hOkHqowb|v(U1ze@97nan8^BWFWo53xeR8t37k>9^^k>6Q
z;CXZB^XjGvnL=3`=L$W6V4#~c7X#^URWrA^-Rck7!;%?JEkEHBwsUW>C^~n8tN}Fj
z?5{UIvPzywl`vSnvg2yebAuVxySF*fe#xfbI{CrU-kowKn%+Mzz`rL140$vb_ghY#
z=jFyrD@pR<Hem_E<~YWKrb|!jG@I2HlS|A{u4v3vEgNjfYS3Qu=1doXNJ@ZdZEhdg
z1dn_jw-<j2o!zWS9u9L9k;Ix5mD5s!q=tI@_RRfW$XSZkfHyt`G<4=abugG+KV)P9
zZj<$QoB8+|lQoZj@8L$*#F7Ai3B3QCRcy#jnTBmeP8ix*xq7K6FN)sbdDCChEb)yi
z?vz6d^Dw@8()mF1H?s;p5;o-p><<n$l`b^^oKKv1pf(1%M2Fw*U4FF~Sa#-U82zx=
zCTu&?$?WyOH}7!-5luL<60k(fP*FV!hpTo#YEbv$pG~u9OXaL~A6|KI8MQt4D~|$9
zoOKZlU&lA7k3%eJkxy^q=A845*y+fQ=4p+%9T=`h?S+odU%j1bmdx+Y;FEQ$^gy3s
zHzTEs`*xpO=tqb`zZM@fI!X$OgY<iB6v~bJARoM|6Smg&h!WwpI%<E9UGICSnS_F6
z{$B#k2Fb*WP|IgY@U(9qBoB22Y_x2%XN|Gm8rm!s@r=1#)$^am6qbg29-rVgaPMB`
z<Mq8Kva`PKWt-R^&r=>O`HUC|9?x__>TmllPIVN(UMMoc1gmeUWYfCdAJr2K-l3q+
ze)UJ%mlo9_2=0C<FP*LXMS4cn0etbRvdPVsI8)_`6J-1S&i2K`U1hbelf=Hh$H1>d
zJNxkSp`5-yQi%Z4LTW#Zj~Y%?fqq%%mgz}=VgJ7TG;Q#l>}^|i7OBX%YuyT;NW{Y>
zE63dDMs648ysea&luRX#(%c=&pG04KOH&nYvC)(zK%sbS6a+=(HFlh4t@)%&czje$
ze)3s3C*d=?lKcKtn)LA?yRR=zvTlz#qZgNORe|8|(RH&_vI+O%7?f?lW-5h=xMidG
zykM-%<o{s_8%uRs<Q#J<_ac24t25Kbt0TZirMe7V6mK5sZFt-vJF*8dO9lOyyo>s4
zBA(V1!hgLkY_XSrJ1J<*vjY0V&o@kG)FTS>#!CuH7MnT3CwxE)7qx6-wSBpz{G3}g
z$=#an9gHLvb?^#o2(1a~5A5?~ETyx8C?X0J52dHvFF!hdz86XmrR`<7Xvf>t&k9@F
z=~@I3A+Zm!CVNnOzmNv9xQ9`9W~RXs;;&h{B6C#WxPn5$QjjK#kjIt`t>V>9Ur)$~
z<x255!c{{)p{JRQRcWpWJC9o`-cTCryHwf}4VY?+kQF`qaYLq;6kdBorW1Oq25be&
z(OA8EpH1dk00~8_PSmJBJ49klx+)MyQc0GKw~LzFUzADTw`2%5Df)(5`{!BqzD3+I
zX2&)|Bj(<&)uH(<!Dp0?dG4}2Efi(PL+tdDOs~lPoZc?cJH-)hyuNfewBGg1PU!hQ
z&#3Oz7Krp?=Ha9^kv}4NBjQY2c#%@lKE!hIkNO3LDo9v_qKkx+l;Tss-!<6Hj_UW_
zl!A602t=f@n1tbJUU5#0c=c26N_VmHyAQKtzRuI??k_ec=oun6k*{;BaH7NpQVTX|
z*1$P>>y4Dcql4u8n*LDtd-{U7{Heu9ajGwOygwIFekvibx_ZcVv+ixw$_Ja6)}XR;
z;%d2##1KHsgM;s@3x|ZQk0Z~Tb;sledwtoXV~=iSD4KZnjSbr<9g$WelE0230hv=v
zp7L`7PfK%VvDStB0Zk)w<3ioIg&j%5`h>A60Y(n5TDR-*?&hU54P+@z?+8@xs$#^8
z6`2zI8+s|ar1m(oUfatx*kk*_Hl70n%9?6djUjQKx}_~As9KkxuFc8m^!OqQazWof
zpDq{b$cEMC6Rcy*oFFDrg<Mt=94Yuo7{v{~v8=!}D0$Yg(jX?%z`vAR+E1L{5rF&v
zLssxzCUA-V-Z=Yi2XNgmbwRP33V$7yfxvH>`U8GmVABX>QM1boz}g9{7>Fh_NQHWp
zS37v2we5v%@a>WNBrYFD)p^th>?x2T^a2~3GTUTo!~M&vZDQzCaRc@Hpb)vm5%hM!
znKPO*)9JM3r7p$eLgk}7<d0-`FqCVuz~`T+0zIsSN0F&I*negkg7H?F{5tebD*cqV
zx&X5|d5u^D*ri(ce?G}{C6;m^`gyyjpamSvr>+L_6tq|J976wtKeT>`k@Cmf2^4B4
z{Luo4a(vzHD5;Pu7DZVG&u<{0jf4(2UN%WQCEV<`T&vkl50m;`_ytw#C*<N@$ysS$
z!vX^oc2RFk6Ywv(d-r05Zt3`^DArN5RcnM)0tcCNwurr{+T?0WRe&C*r}U`Ez(wln
zC-c#cLKL6@Hy;D6_pK#zz1e;bL`ZI|-8F2==>N3#PwGQst@;aeZE_>%sk4PnmpWr=
z5qX>@2{(xQhZiJG?%teMBxtUThF4zHw$N1N5U1<qD=mbEW>U7IT&KFXS2WR?>~FVE
zh>nW)&67GGXzMf?g-Fd}YK9!6!}B?RIbuN>33s9^r#I_Z2~n8_z-9LeQp(@!Ln<op
zn7snKi)T`0bOtL8mYumgYxA_mhD$}vBXtEE0rMBC;MC}@YIZTU!QW1`r5}FpGX`w+
z|CJKVcnmi3VY-$TnsG|<0Wh+M9lBBG`*2FAOGXWJl8h#=)!W1`A3j02uZBz<TRAF3
zxux3%2gR+1DD#<_0swVk?oHe3vci|<thyW3&(~fWD}TS6Bm5f2qQ{jMC;C+8arX_L
z+T%eqf;5&Ms6KaSL*NUCF+{ie!ty3z6M{`d`nlvw131y|!;iyK@wS*oSaWqCSysO^
z&NQN)L1EMOK4~cAv~R%#@WDD-#S>a{>M#9&48qIieJ@!~1Yo?;1dOg%p?S0}zdTM#
z#c1Z@v!?-cKR9jQ{c^<3iQPP8Q?D4wab$+(s#|lVa<Fa8Q-1jRg0kDlC+SmZSyX5)
zyU!J;rGm$HkE{iUHnWuSFVbH9jo)1QIYAv>NusqeUhnBCQ^`yCNUOyz8PXJQW1;}Z
z-;M|6?@T)>YimzPAU_-;ay_I(B@o1Rgp&LBgA|VvI5Alva_yvkgE){%K%}Pz&nXG|
zYBx8!J0_<6&7Rim-y|wiHd4Xd015(FFLk~Fp3tu&NQtc~&=%~LR9@G})rV=bhTT6H
zanY@rEM`lMoPAc6pc1AQ%R=gKK$KYYgk(F5e+ehxSYjw==K$TQ24h}#qbJtP03vIG
zH(zEVS#<}#DbMk)Nv@Xh-RF{(qkLqFz|4teMJ1iW3;dkU^O>GDkn|O-I*b9PmxIz2
z?wi>*bLMfTswxU6vBRk4`)0?V_co=SsC$qEFeg2VUUqT{%QRX)GP~O2<BjLzqo!Dm
zUYC1P9~lOvN$+>f2T~sQDw<d(?H4$B{^DDxv3;99+KO}Yis7F7DcrTAB3zP+lE1^A
zK19B`tH?<yDdN5C>>&6C`)HII44bya9uNmS*6QL|diC+yrVFp|;y?mI_ip9}lR@hG
z`j@|uUcb}BH2g#4z_a_`h;-{cZjbvim)feLx}5dne<GtKsodpzr(sNg%yLw}=)HJu
zEI=VC8Pj53?2=%AQEep`bR=gizu-9NJubTW?#}S~SBsYWZ(KeLlid-+#HVnH^cX!z
zBHlVRGI8*+WF4+i+rjddlOMf*EtqPo$bP-}FnHv%REh(p8!?<2_E?jFmQI#*f;rOM
zNGyDHmW3Q6WvutLnK7~e_;qG;kdSJ`ZDk`C?C?4CrS!3Nd)bLolwi!dE=+#m)$#BD
zetM~so3ydSP$`_3FARzzwAClKJG=GN#cErytI(yClyv~yW{47?52xkL7b&lEadoh`
zpB%?#?-D`S5M#=wd{e(qU)!sq>3;6Arj$cHo^|aYsr8<bLPgymfAk>79*g!f@wo4v
zf)~sKg6-hKo=0rCZ|v7M)BBt_w5dQ(je_}LA{#C@p2t+aK|M<IqqKFcm(A$~SmDJN
zOHYYB{?@PJ)5J4W(q^?QS`j<E4bE0$d-BB;D|YY;C2!Uy5Vl*}TG11tK)6)vsQ59g
z?ng*yKbK-42}Ho)X$Z<cv+oHUC7j=8mn<{L>;Ew#C}omIGFGlisP?d#*PmF-%Uxd)
z3<sRjd(U2wlb7vN*4~<&hL|xl=uqH_c!q@YA%AF<wpKGI6H3T~4e3jQ_1rjtf|4Z!
zKZP#z*w)?zcfp>d@IcplwVvSmi8_x?x(_jZzBI%ogaOsNOG-lZ3I`EV;`SsI7JG^-
zgYNgtXvN1xWatFx%M2tEIn8g&{8Gu#b$EH!+2Z?Fu=j)MV(`cxY$sk4!-=?m$#)tO
zt?1Mje=XV*Ze{7<UKxq^pp&QAd)Ml}M`Uk|9qgt44<pcTJOl~Yd%DqD95B3{wYKx?
z+Mv^K^74fUh4RDKL=89iw<$4~cR@Hah9n+$)m>_OGdDOA%SsH%u_3Khmc}gncDj<X
zOvgXfGC8jEA|*YG6{5DP&1MxiK(_#GEIJ7@?t2IguVYfmQ&H%Tk;Sa}dm?Hg&y~ar
zNFRTgS4+f_fUk<u36+2$IfugK>5JWpi~NCCrnimW{Y~J4n*q7!S9G*G^PW7E0Z{iW
zkVP?^cn(Zk`8ZE8#*w(iq%QR~{G_su<td}=xRpN%Pw09G6XS#AugMm!pTTE;MYvqz
zbc;nr8LSzZ?YfF83}B$*uA5H*76?H%a@N_OZ>Dff0;&5Th6Tre#C;!?c|G{=|B-Z_
z;cUPE+Yf@+yY^m1?XC9Sssy!Slv*{bw%B`>wpv@YMi8x4l*ArYMK!c2G3!f9tO_Fe
z=Xc+E_<4{VNj^t%UGM8WU$5X%{{BGMtpkFJNq#sqiADvku<Pr#t;6I_X*jjwt4FWs
zmDpU6*tLg4c#z!CpMX;v>wn>`LUs_<#r4z5Q?2dc`_<F4M`^9f<rAL^Cw?gppUO<H
z;1VLsj7#pzAc4Oe`j#dfoz23UKj~E0a!^(EJ)qjox;d~GHJaeh-a&cyMm9yal8fX%
zCjh}<XKeqBIWU|7VwVye&{A-6BJ1kt5Z>v>Tcg9zwg1EG^e?Hb414BkzzTR6?7V9}
zH9E1CS~p|#*oU9uY_nAIckw6%{Luta@@ulM&;F5eef_HL9|l^pp##+gvjFkR8jf>*
zNbD=+B-wDboq-O`2Sjle(d(;GT7u*hkujxvoN@=l`)^Aw?>$x^twxhM&m+i)LWuH;
z0wC+gNEL=Ak8>t?D+nx(&{zkl;;*78k5_`E0-t{|ft@PGDjv<su8{nV4G){7!nPy>
z9x2|=!7F(FA$`Is;xTLU!d#nL`oVy3sg>q`*stn)$HTMB$`UWp!{2D`H>Y8@ALY@O
z?SA$_4nMf<ZO^6Bd_<`ZT)b>gxR`IUnVELMF&#KuhKnTLe#R_3J7>dXc@ucv_^3pM
zahyM^e!<Ogk^1l)Yc~b#o279&OVE@pnXdXT_|t$hCX+H~v72IWWa;Ozy56LieGrHo
zo!SHMvEbsh)aKD`q2eR+TlL8BbR-bSR*rZ#w!vg|;wPUu5%m17j`>ui#q&ra8XaVF
zl<#6gE?C%0c=SKtSfVhaPCy<IG0Cu2p~IsRj5G7F)}Bzl;sLmS@-P@qWg=5?F01Ir
z`!?OXYZD!Pyzwm=nH?XCW$0@|b8wkhKEj`-P$3Si2m`b?Z<pI*-ZcS(*z<atkkszz
zS{~a;1&}09xD1aQwjxk3&V8yT#dokWy+&}T`KXwm7-k40L4~|Dexf?espH#O=1g=a
zbaU~)EdEsfGGq!x97i$gh!Hc6s15Bl*GdKI%dX}Fh)mbX>7y}Jq-({q<aEN=U&nk9
zL*8-UM6#F1$kS%pPa+&*Z-cwjNDfU6b?tif0BLvHzY8eXj(xM^W7wo=?@r=A{R7p%
zJNS=80~gs$us2OIOVV;2wDj<sAVD$<?s4j9jOuIX2;%VZ{Wj!wAeGweJ*FTYgGK*w
z`$CfIPu%_+s?%8WJ6au^R3`>%<Mw!3Ln<5~3?Kiq@4EcE0-+1pTNc?VzoFk=n1TBl
zwfnw2$pTS#gcCGV#S<MH1)Mk&;7xbtj!HGcS*UDgs`RKF3|?nX?~QU{+GM?ZB+~|p
zYGtglQebvkVk#-2A30hto=HloK*0}r*RIlttJ(ve-^vCkcYuyjNKs`%BlT&oei>Nj
zX46Z@w{>A%C-}tfj|1kQ;4_`?8%e7zC>KW=MiW~I@?vM&)aIo1V*Sb3&zK=bjn)q_
zj;b%iCm=zg25cWtRo2!JUM5O(#zKSXnHUR_LLPfmIe(NMa{dfLC=l#F8>Kj`Mw8-T
zY^8$u-IV_h2HxF7m0~6r`V?`FD)mEKUe{|uP^Rr~fxH2if!^77XQoS;an@a6kG<{Y
z&7Lh2I_RBorO?-_aY|6CBLc4SWIZfdlho==2l>C5biadpuqEHXM&6H&e>C2PZy5*S
zRyMc=UL#2xaz*yr+DwgV!hjS;qzFqthskZa!0;84@79iLI$GtXTC=XVyq72`P0+Sz
zGN9IA$Uo%R4w->kqaX!43p@yUzE|M1r<+h9I4Vma=g6?%EBpAbdpM6PmbBE_gmCAp
zv+@Xz%$16q2juaKs*UeZ&mFW*UTMFr)Az$H#A?BtmGWYk{f=#X&Mh;$<H{PGz%QA;
zzaAZA`}%azQ;IdX0W&H_32?YWr*Ivb;xW_*e-3TNRoV|Y_o~0G<uhM=pE*6Y*()M%
zK8r$tViiQxT;*#yLOg=4c#T3!%WOANet{}vd7emc-u|}>1cs_PC}cO_nFl$MTy~U1
z{++14{}bV1K}KA<ale6T8EyVr_Q#DBCC{y04xL#!L8l^s2h@C(F7)P0l8T<>w)wih
zc_qib$#wFrk7BD_>NTzt=#rWB&B)<UibFB2&~0pmp-KL30jN3u<1EIT4Uq7Rt%Grk
zM%w;`2PyCaffg2Q$A9uBX#O+FO}}G(P{w=_PcFB6+_17;7A@wBz!o)k92AXs2B0$A
zVY}@i9T@cpf0s;=m6SmsZ+wHxJnRVpv?M|oP58O6e0*gbPnB0<G!p-ox$5M}L!}^-
zRmabFf#rWLrgHI@xPC{~g(|+*^N^Q)h+s>Zm>9ppv2%yOoE;dx)y-vR^Iv?$fU~u%
zkMqDV$JbyuHd`1Mz;Ym){Yw9-lZ1g==!<MxS6|*Yp85191nv*X<qsa%J28XWP-&cz
zMa=nCSRb2XQhf~?yBglE%<Quwp;|g{N(DN?BZTu<1jn+`Sn*glIjw~{;)B$jJEmGG
zIRPUF^v!0bx&rd}BwdJUHGgXn-V{>zBjfrV#0z(cFIA_*y+^$p^sc0q{j2qqxDDVK
zvZRB_ZHfu##ZmrwvO`vuRE+YTxI9)0FvvGy95A_&A$9W$5UUQ8&FT?bAOXC-mJ6i^
zGy$mW^0wyOdlP2jAg;}6EfI3C-jvIG&>cdP(T1Yt!X)cGD&p)M4<S4^zj5x7Mrk)G
zU-TYm3c4*4De*dDT_zI?qBI^RJz7Md7CsTQd-HZfLrNr5_{xy!#A4m6>%`Yv;42D+
z5T43G4zYnF#eoS95UR)a&-`JVu!#TWDjp9m?H^^m@p$-X#8xxjw5W3|yG5$?nD=7-
zrD%J;&LromvPBX@HI+d#vgJ(a5A-*l>iti8visDm_Y8nv+!>-x#ghsX_y~BZAycnJ
z=4VDUpWsr$%<>$TqpomY5YW>GUl!|s%s<TaKITGOM=n1N`#X`=`|k!>n+}6}`?dat
zJLhlLAFF|C?ymd20pX})#spcbkg`|;FcQ4u+V6MgA+ZC9vY4vg)=8LVIDUZaY;>3T
zkv<xo-dM4UYMW`bnhFV8?LHj}HKB{FO7%DVl)d{Wpl>7oXYj;E|4K96tj&_s9SH&<
zZT38yma3?XYzHA6NS0W42Bb`|youZNRb%f8`#iSIczEY1RA1<}3Zb;t=%O<H((?`#
zQ2xGj?O%;Mf^VWfEFdZ5Y{;}tv`v$Pzr7_1;eyLb$(N+u<%EMGTVw|udix<W;NrLF
zGVBxQXEsJBUW8I}_u#|CgwHG^mLLE3DRdn77ay*deX4%R*_)WOCQwQjJi7shH8?t+
ziDzv{KtD<vtrmTW7>jU+Yzma#p*MbAJ1dFKv9%j0rJRkZlz_rR7`B`Y1yrLMpLh|-
z23u*Z{C;2$$R6r|=<3(wIvNM812)0{$IpPVnfQw>5>bv&#%^1nXT*-7ijew7ez~PW
zo6azQiJGpr?sFn`QOGKz)K%@y2XafsY;tWC-apLI<TN-EUPo0i!tRIW8_5wN{r49B
zy=64tqD?aXlK=qE&oV@D3QW{PNz5%GgKA)Bmw6lJ#^39|twcBV1wIY&eY{^=OL7+<
z(RIP0@48+-F{GMQ^i@oDSd83IfjK#<cvwbfSk7QjH1_@VeLPx^k!{*CWaKLHe^1M^
zN=bcl=Y0Ym<k6huXbzoh7M}d_$2-`-Xl32v*CctD|Lso%1L!ef(@a;5)7(h{tic0j
z^YknQ8;;!R`o2WaI75O`f+@^jl9b-h3Ol#{r6Bos!hwlx!vu5mjrYo9P)L~h8TxUP
z$G?G^X)k>tQMRMOR{K8>n;u6-8Yp<?_>jvL>5GrPj4@@T+<Y%sr<+=Br7C9A2@JF`
z&O5-dKuhFxRI^HkP69<QpL%@Ke4y?<-w*t@jq)DOVeXtiA>an~S7oQ2XNUNjLrSZl
z?DmVxsFP#Y4NKy2iz~5+Vf|?z0g67;S!Y7gzIjjsYa<*ZTvd1DDgteAip5+L4E#8z
z&m)>mm<Io*W}QCXfi~TYbYWGsr1D<%t^{MEv53R2F9$8@r&Xm*Y{jrL)s^6q7&_^=
zU~Qhp3Ta;nIa`#ul&fxZNdWGwjU_;CLgvv3l8~g<F3cAL%@>NU{H8-XkS~6t2Pk?l
zU7>o5e3S9nE(e3WX4fM5SzT62mYBTO7xIMOYMge})6ZGOKn65KjSz3xFF%EujNp1J
zc+(n;9EqF-%6&N?5Oy(!dvP2Bxf$mk76<r`B%yK4WZiRrjumY^n}#tD=w)`|>PbvW
zTpIRRCP^XB{kJvEA4d2k?5P}BVV=(&M*vBFN1SQ>COFTpHh;CO{YWP=adE2Op<j$^
zF&_#O@+K8`7VCcfE(?+_K<OZy=p}HGdI_@Zm-soTCCY&nMKcPw#SBt}k^s^gUe%2G
z8;o@M)$J$yDKjseMn7Cip~!49CiXfBDZQWeIXJk;qS?qnEJ05?P)~^=#t%IMUK+co
zz-)L>yP|TD*b$-hrZSOAquFMr3j&Nq)s5~;<&?%_rlw|&T4Ylsx&B~9Hu`NR-&|b`
zv4sR3f>gRIY_boS1PU2HPD>J1VxYzj4G67odcj~=1FrL{0+x{Wmz!TbyV^7QYjP&@
zNG58Th4G2t4?^h%W73tMC_&lx)Cpj$9^f$sDu9l%R4>VvHa-)`-P=&1@m>^R*_i00
zP&O82VXsj*{drOF{Vo{---hW#a|9jqk=Eu_l}@YI+6w8<e-dZ#9LZ{D2ReRz^JwEE
zKyXX8EMhz5=FwXKqW8E45vb%>dc#`?iq{P!-3%A$XwSqwh<<&5bw00!vy82EWZ<`N
zD)){|!q2p3mUg{-SrtUootJjJ9OS;(h{NBGh`xxgf^L}7*xdz?00sd{aV=UY49u*z
z3WEV;KMi@JNys_)EJJ{R^pYf6^;N)X%-A}W!QGCqTSZEaEJKc9JEIqQyo9%mNKr>w
zWxEYcV$Shb6yy>)K`tj6=m^DCswG+k{33G6e!1+gN4Bhr7n=^KW;^DM*k}&898RvQ
zI+Abg(Js-8{C)VdiliWouQ6VmI#@%?d+yvq^EpG#VB{eaEp3M3!rkGkC;rJPeuf=<
zfIcS0lzE`}lR>o9YsDZJLC2WW{vJb?5fCXv;?<3c0~7GZaLYKam1A-UXoy?ig~i*9
z4jF5duZnUt`-GYihf(>wp;;;3`ee}_(M5zzwtk8p?3@EWgM30xzw`d<r8S<g%f%iC
zPQ9dOyR-hSqGzc+4A@5+B|Q0=OBxDNL`vCNR1518&CFJI{#pp+MQ+^ydi0}*8qo=w
z%9!;ZL|D$g^UI-0Shms^FDu0pHv-+~7ik5{-ju!PGrM@HLP^cg_knAKw7c!c8_9(v
zL0JK9b}2oG@ohE2aNJrmrrL2gGev!}t9Y|WZ0o;D{KaMO!`Yq1x7rO<Jyw$tf|YG`
zcFFYuSG=o9d{yvvB^efGdY@MK(LLG2j~(LDu<#2QPFCQ>?MXGZKY_}0Hn?+cc><>X
z?bTg{Ici;i$DO#D<Rt1_&nI3y5sz3d_5cV_0}dEw8PT_Dc(i1q|2i34GLj}laH0(n
z>{s{}M(UJw;Ch)kyAkbB;W0;g;E+tlj%W7PyB1T~lign*6C64Q!f+}{-&hUG_rBT}
zZVK&j%&7*r$lhn6yTc$PeRJYbdAycAklry7cUsNxnjQP7_iy6io(h_j;Q%j-eDEMX
zq~?2z+{M9V&EBE9VH6@3`=<w4u#=Y~#=HmvMJ1EzWUP|8`Bn*EWvQWNN0xh2pM8^w
z7hpf@M-jCA3@CdEB3jO$u#XH%_I=o|HiDKXhFAi>m!W0y=@RwUPf>a6UIgk9jm0@#
zF?uWT_qrF80<z+<{(^9-me#U}cr-jXA#3M^sI(%Dwy3coY@a3K-t)z4msNp29MLnP
zRj}7)kMDSMM|GU=*PVvBs|NIGpsW4sD*4h03GUY1H6oc3`z=i31SVIOuv9*|(`!f3
zK#a+PAfCv-w2(~G1KpP)eKX4N?W_8Z+>Mtu)-q*koFj9kBkJ$^<$Lzk-<HaMab!t<
zot`;=G{`5lww8J--uhTGi6qIAFtKluj;>U);Vfh+=bXsanVqoXkP$%ux|fPL&mxFe
z5eCRPafJ$SsKz+$-1y)@&Zi@xFH*mF4E~AtdwAyPD*a(RIfdVvkA#|uQ20XG6MyHO
z?XXTRT8vXAv9FDyZyT~@t1To3hz!``oE<2)^k9yEp$O%>Iy(3b$xixw^5E5-U9WA_
zfC=iw6uE?=sNQdrNLi-UZJuqGqIkB5BFLRR4zJe*GK^ChK(vp@*SprYpu~|v2*~FS
z*@_Hlu5{L3iBpyS4=>)KB11+sspml6lsb_)S{t<GZiD+MmEObTWzK8@mF1K%HF=*7
z)_uYm4m&yt)%&PT_f=HS=pRzgzOHD>xB!~M6~BU7E%Nz#w7u9ofNCS>Kol78@vFe<
zcS;D-;CO?#Hvtwi;IS-MYZ7n-Np#M*Rl_zaFwL(tc8W%XCtzQ7U_O4iiTkkkF5CP$
z#uf%EnXAND<%dtNU51}3I;JT-G!WNskJ$IsVRy}@$V)g4=oez*=evJeU@CY_hiB=?
z$$$9jgIMNVHm;)LrZM5grU6F#i1%zi4Bamt#bQ%f^)#X4^OtvF{9=9rZ1#KD^3<Q|
zk6xV*-=(K%1pEeg2cD@9Br#pal6fEh&3BBtUQJ^;$_7z?=6fz6clL_@%&Fc>WP_Xb
z7hWh`!BsmUg(_lnjp`|IKayn=h_m)nZRICoyLC7A-36plZd?4WVOWadd*;dA6tEl~
zcK`OS*M#f&)$R6pW_!m0PZD{wZnWBG?-*qHFuODZ1*x$v_n-uTLsE+v^#XD?-hX|V
zx^?_Ilw%0YeA=RAbG0MOR+!vXN6sRQjXfq$?cn$#D9U(5S_ICMseQfLb!(VF9zpRd
zfIY53)5;P7(p*=uwYlX-v}Yfc71&8)tt(^OE4L53E{Uhq$A4l2nOW|M#p;C+_RDlY
z4t;P~y-u{=?+hU!8P}`&-atrN>*6xxWz*(xG*#4KJRV9YxrS%q5*+V0Itkz2qkWZv
z3Pd-9FJBe2r8pUyimyol?p6jB!ahbextyQiLH4PgQKjj^x&T*S5LqUg^y6XEB01kY
z;@v--Jo~M)-Gz`8h_i>RO}$+1H#NcB^sc>aik`6np<!iG&26_$PZ_2dJ#8F=OSK)4
zKf8y@IgdfOG$acvz(3ZCeJzb;OpFqH84GPObQMatFZ0F!ST@+>4Yfr0RQRev@Jlid
zn+NDV?dp_Q1FIcDec8Gk$(KxR_z<jJkLiyCy1aXD+f|)MuLn%<1SWa`gg_Aziqlj2
zGI~r+0DdCXapi~d{ni9t4Q!H9b|x<BFp)F$)<yAinN2jLi>P3!e<3LtZKtD`lKuBH
z+)Hoq+@o;VPiVW~@(j}g3giSK@3(#1;Cz33O?JbYB<QMM?ZnSRXjH1sIAqnL>zlUB
z`H%>U%HmMc*p~-OE0|GM55f8ZdiQt9!$^x*FuG%yj8cH_%1QFnVkikU`QQi3QH(qZ
z7w6jEnGG=qxx|(oMX!_DJaHwLmLPJ=!6&y=+W+zs?R-4bZtcCB|KZHs7Ei+Mk6m#N
z<6TQk*s`bRV2NKAWBYyIV+bWr4oE3j?`^FUTX#@bt6Q+tww$I{kN8Y~6WK6XRA{EI
zSnX@#N?E)Q-m5IW!~{e6$%=Kks(L;XMeJI3;%M1vn$Od;#V7{M+%C-S_%%PkGMGCR
zj|^<Roy1nyhye?jN@q83VTHy|j>3dAtpyW9R9VJsXjrF-z`*EWqswY(W9BL*tDtRr
z5Bgq!%8CdFNeU~l`S_R4%&slEjyRP+`ACB<d~l2)I%vcjzyS@!w4rNvZ;UcAJLwnF
z9YxGY-905-)#vpu!}7ORgeuA9{{OoXm#IVuh))~Y*i4Uw@g6|jv4Uk8BfsZ0ZHj3e
zw}OQ9DisW#kB8I6Kr$>|i(f{n92LSF{=0DwO*6@i5do6llkA^hWMmlhK_<y<Z8eil
zeD^0ycPC674!wBj0|%jP4DUW%Pa&m<6t0$Y`Sv??@n7TDo29J&G)otmY!M`!R?hg_
zOFeG%cF~p|)vq(BVSyj7;ZMUD4Zijpn;OWnd>E2hIL*(e3+tiTlKuQpF}G5QLWJ+k
z&l(^nI!F1$<h>g!@aIO2d<|SzU#&lgXO-gDo4aWFM&w+{y!{WUK?7ClsoDuj#c(QJ
zIfEg;p$FN&J%Eq?u<aSLV?)}5uw+~u&Gqx0L=J~Ujj|wP(vK49ATqsahs#e^(ZYZG
z`C|+7`Dc8GtCqw*JQ4LX!4%}*BmV#RJj8Ruep&i!T<^SlM~o%bBgHy#odKo8k!@g;
z-QBJnTqii=G8*n4!Uh)));$~eD1*%wxLb|ty^L)>az?N$c9^(IwPaJAhV$%#T^_Sz
zpAwP1THQef_<MjMu{=KX#@pv8obDB=v{%c|*F~*a8j5Fp>#^ER?^-8{PXcP_XVt-s
z+so{1On74mS~Rv4%WM5PgBwa1<n>Z{aCCn0vZ!82s$9~^#_$-OkxkDcj667E4r2CW
z*o{yD77eAb4oY|<zXJqVKR{0{Iqe0DQnTE#a;rF%2xyv2X$|cVP|IC~i#1ntRDyr2
z_Ej`1iJFT?p)}^h&GCEP7k-z$9}lFMlB@`JKf|MQY{ZGRBp`Wzg>delQrH-|9GMEf
z{o;RMu_CN)pPna26kEc=0&!EhDk#j?3TB;rb^9ag!capgGUj3W^Zx$DcN;lo!oJeN
z@|3Pu2?U@UT{t$thu2TOWC9PW8zL#Vbof1`M@s_TAaRu#>+|-hx1Uc=q-tdT9y*YW
zpSk%dt~e9=gt!3_Y}~$?mkPATm~2~rUcJH?c*n>h%OxcXxGvxzoQ`P0SK`deC#i;!
z&4Cq}RK7@l`l|Z&mws*Vv|Bve$`a3X?5a#pJh)KEMI0+!Z_65iTGM`vcZXd{B2&KB
zbNK$9>k2$drBa2#>uw0LY_R=~tg)r|YHb-VreywYo9t29_;30{X2YEZeOCc5ydM?f
zK^wp9;)w+`2Sn@1ev7QgC5{P|UHEg=wSp<oVYK)I!}&;7%Fnuo|E%be;I6v5!TpvS
zS>?~Vv2la{A(CF_7t}&NQP49eQt_UD{3sIhxe)X|08tCjrNV=%*+wa@TcOE#Og5DC
zmMOtNGb9}M1TD<$uMgPTd}5<wGFX%VXzFK)=%fUK`eS7)zTpeQui#Xtj1_PF${=Q|
z3-bI^Mq#z*+utC0aH2%p8SZYA&f1j7#SbMAb&jZ*W6S>K@3z>efwja_=;)WksYdM8
z_J-#1&%*2%IC0c{;=vji3`ZOgMO39_Yab9Dt)T|n<Jf)GmpnQ1BwRE~^jSAUeYL^`
zQ=`V7e|0BAF=T^!x5_xv1siY|HBa@@{~OosO5b1-C~t>h)X0jv)N|9X&?CDbGC5tQ
z)JGZboDp0Q$Or1QuzOkhZxlxHaSW1K7!;gFfR=z@|EKfOCfa(1@#2vj1-#p0l+wV%
zliQU&VMX_QweacW>6T|I1M1y|<o-20NNw$Or)QUQh@t!;(_i!C^75c-xHAklU~js_
z?q`V;Tx*)0vD0r((crH6g>cdIwsBGefqbbx6B$@K>nD*Z)<V4^55+z=%+wf=0_OnQ
zDnIMVapHHA_`j!)rS@sK&6-o3(+N&$3h?S+GV?PBgs#!j<0dVDpBeN50xGw^GE(6I
zkquw;#<ybZ(J_GQH?Q>|{Yv5Gi<gS`NKt0|3p?Ef#t&xo)Hrm%OOZlx$jr7&tPsjD
z@mP?Gv({nTJ^c@ca>)<Wah&HBZ6OvP252#h@wa6Ox__P#lA=kuC?Ho!AXyF=&B2iI
z?WVOI7Wp^Ez3Zlk18DDtJJJ#cqvf)bbWHPjU~-}J1DJ%AHzIluA5zf0yWan@DrkT1
z7KyPMrz=P2`ZVvt@UEYVq>>)|mrSoyauObOag&WVhqX0ZE4>Ihh-db$I*wnkeK3c-
zhq2+VB+TI58Q~MWd<l(v^U?6;w}|uR<Tq$v!5d;CT2_i*#cjhCLXahbJQ|^Vs)m-K
zu^vzP+2kpmzffbWYQh?gLiui0@d?IlVb5mKuix~bQdp-lc6XgL78yb8a|6fPBCG~f
z78arBwc;gPDzwBEYL6=$vzTeNWWPiw(Y8bQAMt2ZxX6bIL7&12rQf%r*<&~#)F+U9
z_=Bd^7%ivbsmB5x`&i#W|N9|8F3`a1$2$dNz<79XHVhr^w@h3R#}8{gLc4JZ|Krd0
zcD=QBhv~wI!|O|_=EHOT=zOy&*!1)rWm$KGGn|bPCRNs4l5=_=)|}BK+H{Vbp6+NX
zJI4l3z&eB;+FXo3a4ZdM$y|wUNIQRA1-lg0;XfV0Ge6%nbQDZ_wmLb<!GP{-lzuuR
zRL1>qBQ=8^iq~348ID|$>b|WB{;b=|+VP0%gokX3e#=*<6055#^v3A5N0cwlSmY?$
zc=k)wras9XP}$&FZW;M&x@-aSd83hwqD!m}K{e?Xs?S($osT*m0Fmx%s-6X~a)-8r
zL2cthk?Yst7>en)a>5&r3I0#-GF~%>AK0@FrZ>3k624b<V#eQZCf=P=>32Da{GJRZ
zT2C%qo<f<Xhy>&=R}<B;v?Dz;B5SGM`xsLo+qW-VKK@Qd=$kvNM`XVOBEmlmRjxZa
z{D=s=6VuIV4=uPLV67L<e#A#XfC#6lAFljtNhD8A6nrgZspu0p0F>F88`qbERuMR|
zvmzC-VT5!$pm%V)=&JoDDbcJanGQqwXx4S|YQtrm`PvJazD~%H4g7F@gBZY6Fn2=X
zs7z7=UouHjsGQb5ty@&vDH`sJ_7cSnuj>&!Vs%*3!uT1*oIDtF#_#Dwhe7G74M^4_
zvX~aaV9B&(|IP9D?Im%b5;JFd2lm}Bq3;+9*}N%`6g&ddR%nefpm<6(iFgY`D8T$|
z@N>zgKR2|WgifW7>>~ZT-{k4t5II(wnbvqFa3Y*(nw~}e;Z>taei9WXO(`{Hu(rq;
z=#E?Guc_T`H>$4Ne68NQapK=bY?kVXW$)RXSQS@WR+v~`Egxvt%{H#N1-lxBny4yB
zQj&+CgGcw@W((t)7E8rSqz*nEQ4w&+gO{>6%c`L{4!>aN(5)Xr*BhTf!=y^|IWg9X
z>2uXMiHzDt#<4<`F^QX5S7B%{XWsy(@Kxyhe>TM40nkK#T60H7CzY|@S@Z9fafO`l
z)|TwM@~bx6SGxNAb!5}iI74I-!-4zLkiT6f%QC_`;hKhPl!ztV2n!0}&h+V1Ezs=-
zlBAW;USOIDy_=8LTiaC2>&(KuArO+}3MJmhkqhZjW^9l+3<xJb_no8k#)gnO6%NU;
zyia}htBL}7d+FoNu?~fho)}9Qp@<BmqAzXs?Nd2>BmvnYM=l(l*vF(IPLt%#k@Xav
zG_5Z;QTuxkqV$+{ZSB6Foz%fE?WB`Ip<4?0cx{i@&{BXao5;IfZsFwQ`(vAw_i0u7
z^=;k*W5-;A$~!O~0v|zI>tfyRDxUYM)A@dc1Duq%gwr#CN4j&jiJ6s!dvzopf9UzK
zf`68pKQXTlyLfiYRPhy1$xwI<IV6#fa?nB{I}C!)T8s$d?66#T{gK@bKkM(KvQKaq
z@MVOraPjiqO=uyVYS4Z!ko)rKN(#OCzWd##9<(1f>M1j#9cylSVgcX&Vft=M%J$91
zyt1<1-mz{9AwV`X1x1N2pM3Px!bvjS(`=&b`(r5Qn?mL?@*b`h!8dAOg=)aVjt%M3
zFpgjcrf27au4D-<nx5D_vxrb^Z~I#>qdXrtbs~_>g?{GXxN7jC>z{80>n3>@f5hg7
z4BfVge{qYv=E1-O!!Kvj#J4VQGMSh}s7rnb+?*3n47Lk7IQv0yGx#1uB$HxJHp}Uc
zo6bT^p44+04Kr($W9HI$Rg1}%!!8uvG4jFNgJUgeKjp5;KfSHF<q2&meN9ykJJSsY
z?j(itKbab=A6~S?g5)0;(fIcY^w5Y>DUb_Ie9%g-x}P_i$MrVskBCzO6mEB$AA-~G
z|9?LvC)PyhIne)f<HstDFNMMB>C1cgRLz)XB}o-SWk-b7<LF!?M1d>DNaoE6oZ~cB
z{XF{BELNi0G1p%FAG2UcJeFczYMlxk_AIl;rkZuXx64qkunBy;SQ^k@jIDxdtA4$_
z-i2+ccinkd(WQRCVR=|51ay=+yFrOR>=7>mb-`&4j`~*0Q?e(^OsTe4Ym$Cx5>ako
zTFSWZ0<K~nL)vU3ejgHzt?9mJQ-e5P5K=&B!gA;fZfdu=+w_V0ubq7EcHWMO10{r-
zm66p3vm%^g>1J_jyoPO4g?TEJRAHyTXAtXW1*fuo?m{Zcw`9`EAk$b~nQq_j?V`KS
z8HHj>`pWdeWcdN0jEgAKaL8qkeofQEVG*=m;~$}_`J^60Myz0){AgOVq3{NaCygx8
z__I+cvllNQ^5e4ZSRgm;hulDc7*#a6+kBNv`jjC}?;{9M2s<fgI6cSx5b*4Rgn-k{
z>w@<3BVyEZ{xVR=*$whIsx2uRoRCeT#Ro_<g4x{2#_vk#ujG<fU!Vu|0(!9$yJP;+
zZVaejl1<URzXHJQgp@=@>6JSGK&F6KI{O4T=_Ppv?I0=SFLt%Ns<&CumOHyOvaO_C
z`@rdN`!gAWr8Q`Y81R*L8RO^I6)$`3;gl$@6A%g8IoY_BCYI_T*`pCFHe<haKhqz!
zm0b#MNJ<C6+yhnv`Iz%TG$a5RODLIvJ&oibIR@!42_SI-P;euvy3k`3{Kwt2waFS3
zSugnebsux3+Hp=l{jOF#L2yGaDc}Pr_+Q$}lP_S+J8$WjX3Qhu>|IpJy-9$m10H72
z=npsHr{3mbREl3xk7|cThu8t^`Ai{Lt4Jgz$oSqrh9AS@6E?)^_`R%leU>!F<Db4)
zyF-Jz@_@+Gl^mb3^S7S4TdNy?tf`#M4qf>}FuDSeR4jwE4Vjsz+%FwXdk&xxma5!|
zueYaF5!#9u5TX_k;VVCRk=q%0UGPF+xX36G!rczw8Q6J%bmFk=U%bKtIP!nW>-;vB
zAB?IAVUb5ap15xxt`N3K8ie`x!e_O@)V$ox-pq4m0T1FEJwUcotOIe?;P>L}ZjO*U
z7#nQPV%Jw}`ej|odt_;W<x%;Bl{QnG>_$RW*JW5j_&FrDJ-QS;6#P0>E`GhOTng&u
z81Jr1%sCb3jXsNxe^Hj9W@%{J?@4ADVRwhgCJQF{c@x`&WQUA9^nIR{nb|$a>;9T6
zkrfy9HCWLB@n~I?^?UzoD7wCR3Di0$rTieC?O^6ZlI@yY=ss0U1_XrQ{7G^D{M&aT
z0*xRV==vJEb6kX$N~zYa006aQz{9^o&HADP?vU$hVax*Wr*6MY83?T!>ZLQ6<jw#)
zrUZKS{-sSnB<ateMNsb^e}jvI)Q9@tuJ;&Yi!YlYSvW(SLYJH)>OOP_w<#?DdR(La
z0+cKIs;dvLA`ok3k;mj*h9MJuq4&rqt6(c<upBNGYc*KI)6BB*n(h>nnIYEHG%C>n
zl(P+ew$tss_C4jbTa7Ko#i#sJcFL>@`9;>7_$~(e=dQh_<Dr}ED<n^pO4)K|Tcv8T
z_c>e1okwT?its6XPsIF0|J*SF_Gm`aY^T#biy2J;R8Ue27<lm~X`NbIB7&9GFEyIC
z_uERr5EdA``Je?4Wkj;Pb8r3)S6oLh!JA<eL&o*-Opm@ItdsMZ<2%_L5**0~K8#zm
zm(GCK#X_*+dE<CJ<7qT@9|e9&G!LiA2<raNs$me<8Ya__weEObzd{@&Si{_zVeS5b
z81V9R=T8gz=HiLQDshKrux)fboNH1@^PvZzMt8h<dSl%VOi`CiVbqkj?AszxlCfZO
zPJAWczdjQS?c`U9Um3D~jNC;e7p9UCI6ss*3?yFdH>YTs<X7;wn1%n=$#SP9C130j
z00BF|k7Za_!Ww3gcn~RR|F0ebx!tpHXa3{+K0@5_#giDw2&W=U%v>e<pDd=7W1eR{
zZ10H4B4D&nK6N6+{CoNR&{Fn&VzlEwFT#_+ua`LeC0QZ1_+@I-7%`RBjRw-ceR=Dr
zP*qgqe^*1N_wH6zi7TWZ*sd<EN>6?FNtn)@W!Y3$mxXOUG0OOc@6x|zO>8SKevoNP
z*>An0btrL3G$=EzIIwO~Xg)H42jRL<L~>GqGZBrj+Z?;0@e`GXWGYJOd;ZeeYO(JX
zf~vCw<^0DSC+rqzyTzhR)EMxNooVb(kGPvl*#2I}JfHX9@r1!2J6N+Ul$qqvmzKT^
zMAz8^xfVj2Ww1SGM@{lEJ+LYAGI5q<gw?0ejwITdUmDQs-`K@6#y2;ij#CHi>I%K@
zuY_~T;lKLLn`{~p7D79<xXK5`!k~!2`xvujCxi~)-^a9!yW{zEh%5JwsMII|a9}@<
zs$c3j9_p(h0b%oqYK?~wA?v_6+qyLNAqoZ7@e$I7JN0I_m=gFboR0tehd^#gr4Qrc
zBfZ#{#`E8rw|LCa_Xsu_kOu}*H)7^4kqzfFP5$t}H&uMHPx@e+v7G@UAv-N!;$N26
zTfakS=#dz~`z(k9LfQQCC8k$j6UEd^_uC`=qgT7Wy^)boq7Ttu37t1FR~ul#v43WW
z=$lZ;b%-S;#G)cY(k=`8z9eErKD<t^?OZhh=i(W+&q_|>?Y=|_ldvEn%S)WIHZB9~
zOGH0D<@#u=x_1-C+8}@mQ!4>ORm-tu`^|ItW;5WXUU9|;4LVri#jaxq1|?w;{S3<U
z+4It2btSE)PLCRe7CA2Rlly%9*hD)Uj!RnOuQD8YJ999fJ9J5z^9iAaK{<<_=0Wtz
zCTMsV2?TWf4E5eC{P-D>B%!tr>@XVwswHpW+)_6qRkxUO$;7Ev%0pD<ey#Nk098y%
zbW&p5^t$<0qbA&*hb5R1rpKUcAHF;bIez-Z+uy>c;V>V{t7J>JQ}d9ifF2?iE&M*a
zI$pG}mq{4dNIRJ1JdwVqv^;U#^dJwUPs{c&(c?`LNBO71YrOLM#pu4bxl>o$_>btQ
z{&=;tQ>w3W<`1e`01S}ku5-`bkKNYdb<U!f&FYi)4mc9O{%^iwqBMuMgdDTE1*(eY
z$4!7EQ4hP896C;kw@f(L5#3>LNzSY4K!zg|ki=sh27PKt-7G%Gw&A6mQHfMaJWm9F
zVcxxA2o8JtGM|d(O@Hf~jZi=S)Xjk4dwfT2DY3P0N|ZxhcGYSpcxj+BGXtw3;%4ih
zZyl};Z1&N;wK4&%sYLB@3M7cI76LcxMoO#v2bZEf)D+qw3Lm8!c@qsdsD0je??Py!
zg*sjSXflP>nPiBwXYCm*i5+1|9h85<B?&dm@U-wOdoTUmOC({`T#8It#A1X81&<2j
zv3kC?QOQ5k=o9uuBlt0K<|Q+`r0gh=iI5V=h5e%5*GWm}l7CC*^ydas5qt6hG@lAP
zDjtYuym0wZL8L~Z0@PXdR1j`~8$45bQo4@{>$NmmO8$aR&3r{VHoXP5M{}&XEuEU-
z&dp>+()l~PJEu?rRY2z%&cR7&5h)r;EJnM;ztnQnk$SYgB(2_G(S^Eb0#ah$F}Q)v
zDBK^?Qu+Nias<w&zYQ>$LKZ)U;;Gdp+%6jM0mkoeD;6idGu0VFP=|apu>|gl*l%nu
zcOE0sX0r~`8rBv+EO%z2B6E88Uz$T-s`V?2KlK$_I&99~RCX;wrrcdZO+@mj-QKRx
zX(9tyrdRmgz9;a5A;t2iBUb$Qi$XL2C^oX5$k01P^H%rHO}u7*@2O)Dk%2zUL*R~V
zbyP86@pYGaEmR}l1n<>&w^Od{b^u`)VSVcVty6Q6J>`Z9$eW!JBxL-?GNYKo7M-gm
zRtb7iQ#ixNFh`GU8ai40ICc(h>0b#-U6{g{tiK{2Xmdx}AMX-tjo@^8n0qjc5&aRi
z*oyINta_+w=J2p#{YR-I3gH5_!&EwS(+Ls54oXTalYs?v84xP4qk*g41P0&ONUEI2
z@PN}Pz?^V35NbfD_r*UayO4*7@xf#+HosI0zCt&*^W1;5>-9a{Xo<gQ%-bb=umO7K
zYrfNx3iJ_?I{}h<Zur!IM>Xb9IrfHQT`}{pRad>Y8`k61DE#6>>mNRTO7^f3Q91tj
zF39Y6B-CxZfOzOUg+mN@-O|Y&fFBBH!(i|Y#h$(m>44?!?N-P%cnSDwk|gjGdW6AX
z=zfr>hF&!Aoo$8}mXP9abURBxx{h#6IR=g$8xMDQ-Y@!K(u7QRwz{fTIIj-xF7|>5
zqQ6spl)?qOx*Bs`UKD4?7@<}UT8`qO&ag}o$70UjW@I1SI_L-C(>hCAD$SqN+b{tc
z7%=m-4#rUd@EzdOf-W7w6Zp6-@|(XRh^v?sgxaTXUAtc#hh1NTaoz8Js)=nL-9e<Q
zYm{g?TZ`G8Hy%C)-^+Kh8Wc;cG$BsQQJ4bvW^}XM<CH$Kv;xj^YR>7yoA{?J?~f-b
zQh4DcLl;!*>=!dACFz8$d(2(4qX}N>Z^Tf(#DQI~*$*p&=ck0rYi1<q0W%fxs9)7a
zoEENwu>n5_uro`*e4l!v*`hd4#O+0fht34;SK6I~gCDG`EH@%<wN7~q9XNDx-ga&y
zuwabrd`u<OU~?uV;K`(Z#uI~1j~907?1U??Sf*Wgzy4VYTdG%gt>qU2q}5_d9M8Sj
zSH?ytQ61wiKo=Tm%E7xZ7AXIfwv-vvYvi(w;}HF~gPn@`Zy&LbtUf;rTUo!9{g8F2
zRod=U*ld<n*EZ(pY;hVWCPO9p$%dt*5am<&8hg0kZ!v%TWqz&a>cD&<w&*Y`N~wzA
z+MESDJ;!zDx)Hw|%NDz57Td6cmmjgvrYr@2y}Jqv&fafraH#s~j230*HMMAhG*2-^
zr3|8_z^MuSVKwPZD8I@2b5xzB-BxN{UG_Io{F%^GZwSJ>rJp(A<+}5wtiPip_V&xb
z3SEa1eqQidK-GG2<KDVV3zvIflp`^U`iMN#sO0&~<CEhq9O~EcEsgzBCYixmtxywX
z?Qaob@kcDPU%>}Q<@Ux#=nR|vG^lc_efY`##~HV2CWkD>X2zcMClWTvOp<km5^52}
z%>~3uR#{-6{&TFUAlD?d0001th)QzBh!+Eh57Os6Rr<e2qP64`*N;yhEo`W0eeC+H
z<$<UB)IC6S1&945B8hO1FmaDs53Wrx3@$5ix?1m5e%EF`CR?NAu1Ux|<?_MHku5O<
z=_JLuFLm<$Jg7pp{3GPW;@|UqY@zJb^3Zw@AY1vjHurC2`QIRAOPmMEUu5c1T;d#q
zAK(060K>+=B+3>5-%`uJ)MX+;GU;D($0KQ^w=bF@h{5S!mBG|DAjaBC{%M-Q8zw({
z5n<_p%jx6S7ssuC9~|!&d)PBFES*s`#EHhhOP}}LQ%%pQW89;$18}>u-`v(yh>l24
z*E5O?dlVg|pI`m^5<72d@*lZA*}<;YP+5&o$vqZ8k`cfV@Envx_KK%K#`Wu`Q{JcL
z{?P2C%>qHLsfh>z0TcdEY%;|}le;IxZ4HNgasU3CWZmtWTR*iN-qH96U@U+Cd(5Ro
z3OSLW=&|}4kulpqUh<*)u9kg#m*m*D+Vtl7oBZh@2@{lgG0H4pc&VoQKdIOfNfr5>
z>&Jvd(d}9@p}hyjCEwy6#jzXh*@Pu_+1A&w-Xy3ipW;f%7Vdk6{MaPnh1Z?GtaBXc
zr^*L(_SY-q^Vht-=UYIwXZVKaxnz1BS=_TPf520(^4XaHYx(P{T`2qKjWzdfldoz?
z#kua^?FI~VsFc>MwQllV9@K{q$>eU8lfu04FI?um4>!FWC!eZ6Ypu?~f)7rcqj(oS
zDMWRJ{d)cM64N9Peo;l-%_?nocm9pPl6|H%?c!o21ubp;?_J|zyW0LqYhQcc<n`0Y
z%HPt#G(40VEuh@ph(=kxr+Ry~(XXa%yG^9Ul%oLvLm9oYBy+Zj%_PO095Pl4si?SN
zY6;{@NS1A;O#$%=$)^;ipq=W)m1^lwIVjVnrU}u?ENl0hSZq6uFnw+K1Dan*?#wQy
zVw$UK3iP-p1@v5zj2I)5%u1VR8A@i-c23R0l;jscG|r=8EHyPP|Ei~=aQ2f*>d9T#
zeUO)^&YJ+?;>Ww|(r+6}9b{YXM}&`K1>vo-s)atAu`sJsOjR+8iz#9x)<>KInf2~c
zK?M<e`QHnjDkKZ1+}B``f|Uoqrtn}WXj(6Wdk<p5qg`_oAXOf9+2nG)9MBV+t8nhw
z_?%cARn9`p4kh|O0E+~kTP=x~I64r;C@d3RI@Pl+(#23h_g$F;FHOAQW{hNK{|XrM
z@`WE)6(6Y2d^UTlCREG6OT=27*|{~r%~jlQBjsz$j}8J;iAw9t^fxK9A(4?q^VzcG
zZ$f&m%=f#O63&!W6C9_Tr-u^4-YgZAm+)_TYil?+0Fx1)Rpg-P_H9tcM)cr+ZQi`9
z_xx?jIRrZ!0pj@`!U2<Ylt<KEl~l%3mkhMb85k3drvri~Z%=+NzH!?}#wea#$iPAU
z<?G?Wx1_|#)!@xVSoDD_yYcH-s!uK*B^9sMTqMONHc6lEzkD~O`JHDD!eriZc9h$x
zD{P-H<8n~~RmmX8ih9xqPyTRcUU`)|LC5FhLqT$I*_=j)&=lXYeYxU+6XqAL;q6wS
z*x}Pv`Or?7;w?y0+luj57Hk7LAt9<|G&%p3J=eJETou=Qa|Z@)dwKfMU7*X=QIrf7
zUul^Jk!E?cj;iIe5+QcnC1ljTrX>cn6VW{g_pJ448;G=6*YGVaUkD%fWpI<DOcy&U
zcY}JdYsISl`0n@|omuGXD`4jDw&SlDh>{kihv2KPNDfJdwDqayg0Cr?Nmh-&P0%8+
zAss^ClWS<4efDsC5$f)!QFw@LykOByp~HU)ww^`+&!rV)7XjzpFDiCoj;p19yR$ph
zt8fz;BP8+-*(Zuy(@-lV|1ssWqXc6JiWmPZSKm=F`YCI(pBP*0Y;;ojUdfc1k?MuE
zMph~wy;PtenHO|hVsb`3mT{JNn;lgKDS_o~?vZxu6DAf1lv_>3vCZTj3gcWhLpZ^q
zOTqVu>x92>=I!^#iy<$KHYYfz`sP=0mCmwh;`~+0s6b|7W5Rh)hu)EJ0;P)Nj|eGG
z>-Dz$U{qc{st1U-Mm7EiU1DDWJJ(bpFQH2;Mok+BDL<WR_q*ECcGDmH06keomu5aS
z`Of_PnVOq!^HJMtZk50dci!)%+&LgtDetIBIRk&*{tC;{h5hzZ<43Ys*)BB!R^a4h
zBVD46&P6!bLGEI$0Xgw~lX7A^y|!%>73iqz)%#=tVf84hu3vQQo3ciO_>-fAzu)i9
zY^_|h%7S7%ydo<~X3PUTWvNhL$NS`tMD<?(>I<#-_Tt<Bq7B1O#*NOnlXcS1IF{q-
z{6JcikV3wR!Y8<8*aWlOSK=K|k|N_lo?k~^O||^EZ_A;~Ge)H0IHA7#o9l8xxogSV
zilsQQXydNsjj7V@+?DOxY?uXO%i4x1qUAA_jxb!Wk#~oCKs!#f)xhz?rqNEZy5g|&
z_hDy?a%UalnbkhJ-)*2jg2z~fo#}>HP>#zQ;~mnTPv77`JTAuBms~bwp+8k9!9F3*
zAq7Q|26J;=&NCs+OH@0wT-J+N^X}B%PrfGC|3!vfDnfs0SnO_3-CYU1dxMIc29IG1
zb@N3y^-1K&cf}H~H9o3eAGhzb7dJ^qJyPlKF2g0-%Rkc-Nwi#|dZ1+6xIep7|EqZa
zxh98+{yKM>+X}tfcNyT1=#i`An$n|Y9jeF5g|gzRs<Z3to%!93Mo8%vUp`viZKfeg
zk)$L=Zcpu2RT;;32<JuNOvM&Yl671h-x=ejWD2YJWp@dDzxl!~Ubv71uqrGdKobN2
z{a~acb(fGlS#J9kh$+yLC2L|lciG-YNKLceAJ&U`SY4X)Ly?raVJ3xiFbs>Gqa6P4
zLnVVfRJpqy1A$FuC{d7^L4EmVn~8*o41-<18d<s#%%NZ3<$`uqb*~=DZ=vhO(yUVD
zw;d<{HBg8DLxnFi&=7erYYGj-va?U{Au(u=dEOI7xWQ)Ux?7c7COXFk=KM5c5n8x@
zuVryKET&4LR{d)LDQ!Dvktq%&twMP8e5M(u910P*dhGI!Ikc)d@5@I$crf?(lW@D|
z2kzERh1PJXiQlA&?n~ydofSyd0{!s$eSl|CC>NTW?pV{qAC+;WC&M!LeBaSzLskWx
z8u%-0c4`4kj3#p&Z<mm}ByrtXIq|3DXg;sFvH_BKZ>$-gP1&eIXg+ENwQaa={-I}?
zo?{tazFc^`cRpmJdi!|h-n%AvSY7oGnc%FGldbTm;U{PNnc`I8!7o1GL{W~W1ApMX
zz2UVyAu=$8OrQT_{+y}&Ep*+VKt#0FFNb_g#oasndT&tSR{Z}XA-6U2M+Tla+37ig
z?sw`Ly(?z<eA(Gl(#t|8Nc#JzfR<;K*k}jJ0a8FT$<~?+rME@ZD1?iH4sv(NnP|r+
z8O1mrLx2gHru1IH76H+CvF2IXArm70+RN2hA@Z1$lytDPioJjzawl~mL*g<JQX<bv
znmg=fKTPdcAbj|;tzZ&FI{Ov(#b<lLnrZV5zS;Gct?+)&fJ1Y^J}PUt090j#5B?fL
z*!`W>|0<WiSF}d))W>%w)Ff_&S{AKbI!icumH7A+93JY1iZC9noD}9%3nU@A_~_RU
ziE4#VExE?uMs3^;G?R{hxr|e{2kPA<+R)XzpV6g?UIx;Ol4PG)gGdRbM9;vvs%#<s
z`FNm^0YzT+WFs@}H0^WG%-VH>c|=bDUxp;B@0**7m^;sij*@L+jh!*9xbFElsxJ1D
zRrup(qhJl7k*ewGi!hD@zHbqN{IA7h9kQqF7Z7f2`W3(4aSyw#xP3^r6!W-?OosVF
zh+8WOZ2k)q?|#3?7@rp{4j|`Xuj4Cf4Ki}Lva|U3U?TO#j!D{p0x54&okuu5wcd*M
zd*p0d^lF@$u98XYN19W-^>U(&7qy=<%27F4)arO8aK*m3TNuIko4SqshNKY4?Fsy%
zV~8xN#$HpAXmgL!xVGbNEzgii%>2OGNcNK`b_({J7BU8t;a?_UvI^7We>aQ|wDYL=
zUv^R`Daup6^!iy+KEzkDbF`gVDu6{tN6t9oe4cg%JU=hUUbM(ZP&Lq&44F`A5P2#R
zLZv4}37ExGA|5^DV$8)bD@|>xLpEw@%6z%tz)p{%uj}}y^1p-N_n9*PjaH9ARfZ)g
zCMNDtDG0b<%GYl0^6w+8Gu|GS&$PYF`6hJgo!UNwc|m4clXPeV`-FmJFM*s;lr_6U
zMJZ<tyW2%RIvc(1Lj+mV@24?}!)$Fy^l=uW8g2c$X30P;8f$lN=}cYo9)HhgTY_Cz
zTHEnJ<9IX$qXXkfLlY@avYFqfJBWC$2Hl}ROHLmNiuG$ax~oy})xi;tBMoRZ%Hd5x
zRFx$4{HS{nbZ5-z89jL!n{k0GHp~3TrbH)0o+itkiBYK2UQ~6!Ll-hE1k|-`e;86?
zXx<34A#|6E|CbQ6zQIJQ=~=?C@$*c$s$WPze2G+;Pe=(siT(Va=cxz~7-fJlF(9Ax
za%<KX@rq{4bC|znJ`V9G-OV2-1@sG@gL6xF+FKbl+(Gqvb3d#Joa!$|CdFDQm`K+^
z<dh{&wDDXF08{p~>q-xfIcj3W^6|Y`^C7H(3;3O$vB`RwRABs?3L|*Jx>Um%6^lj0
zMEHcBd9Z{~k59>Ul78U2M;D(p^2F)k_JQLt*kieg@t}kl!+d+Sq2XwME+!Og){(y<
zE#>_9sw>P{#7e1eXTNPgIg7aDZPKIQ+Ke!^+n>KvxiGyXf;uSol+!z?l?l4K_vo<o
z=w&ljzubR{%2bRC2HRPH9il{Vf*g#<7x)0PQPXFZ5}M)v$I)3oH2Jl0c!L3>yJIv8
zN=nBl=@3bg6ane(!RQtcq#FbU1Vlo*Q&OY^>5>pe$$+uF`@TQy4|ulcoSk#u_vgCm
z=|>`#fz3LAm>X->Z%Jijhl-8qnxR#v`-bb6n(}{ehU<Ux%&_r7;O3NY1Z0bo<7AlP
z8~l!hbqyj|DI)t~{q-dtGO6F5uN9ik*DvOo8R5zlKMs!Pn-@Xa2ot_pnn5~#N$NGd
zJSRL1ej9Rqmq0<2AC5o54aqxLG94(AvJO5f2je-I`!QfHKaQX2g^w<L{gw_OWpVVx
zliEe7!UM$18xIqk;!dYgZC^bv8m%Lgrd*g9N6}yC{FU4(ehFaY*ICaZ%4+~lNm113
zaD>K$l~Rzi5<EYCe@tW{{!N&f1Cik1&dx|6ntHp^kKKp@d2I2sLeZ$xx72ncj)kJ0
zVYOq0nI1p9%c_m1BFr^#yxS$8@xNbT(3%!I5z+oFCaC4_T`|`pZvu7LUZjP`lR$^t
z69<tJ0M)gGUmvd=B<pQ4qx)OY>@{H*_V$PNHpAgT-m?~k$JKgRGKwlc?)gOMH)L*I
zuLeVJ-bFm|4q~T{jbeh`B3pGBtZ+IJh)-i<!^Jp?VQM%%V^Hc_1X4EP{=*dr9k1UY
z53<_v-D`Qs)O$au+qX1LNf;<`Ptrg6Eu$}9QQcleU^24v!h$(<Rgnc`rwHuwvL+d_
z-9w3VZ_T4Q=TOm}gI8gE;mOymTSAD_<t}S!DeO!gAiI)~Q|d8pN0brScBGIegg3`5
zi52TIPlIl;{hk4Utr6Ab-mHIu3m4_}joyxADH`ds(Es7PynmL^Bxm{S8{Th=p}h;l
zGcP_iL6B}PBDvhOgh)QZ7y_LvVRj0V3icbd&Chx8;bXtu1*Y2>_X~ygmfZ43i=r2I
zXL~hy?eS3J0L@3H;<HU1wMOc^0?33`WuwQ>oV#RQ@-hKBKfUdgSCFaFhN<tj-pCZ6
z^sR{Euk$t)i<@59v4>v`nT-IbBEwlLI~!&zqh|m%1cUYyFaQ_TQ>1ddbR@5cAD>Zw
zAi$~6V{#5h`-qHnyx+`8P82|f0}X^6s7XIXVPLV=i}WKgU$c6roVgb4{OF_ag@}-x
zzfztN$R_0er68ExKH84WszBcWRko!PJp!ait2@P~So!e~cfe-0;z;T5w)1euFiHyj
zzTc8R(UcSlJdJi?Sz9>B@OwD$v{(3tTm5sOm<u;rh0EYe+@QxGA2ug<JRaRMl{6#&
zfC<A6{T&KKjUc9j!H<A(x^evjr$+elb$i#RggW*qlp8F6QwGs8w!kx_^7OngfM#*G
zX?-hbl81@mZU=GlB48c{>r?xK+-QA6*j0uXWdj-Z*#d0WHXu|QR;BQfu!4NIvGEk`
z#jPM{u0I^g=l6r4wadjkT3Tvne@mb?%1!7=nURF!7VonmDP?cDpo@*9mfCaUfN}Rs
zEJTYs>DXSp&di;ly*C{Z{uqG#gxo28gP%tAbpn91H`}3EeDB1c*|Lc4^xwb_y?3-F
zn*ZvG1EGw-+=P$HzdaCanLLdmYim{RR~(6K+l>%IuvzvWrJQ>jZ*PJpUi?C8_s;ba
zlMAIxigRwG!L@$$;QN&@yYba<&bo&=x>C4vg}(@@lr=<)HHP7`sOpZlTv#q0#oRMA
zS$M>Ivazjm73tM~t&CxUf9j>^UN)X2^!JF8yy2I^14CVQ&c5w;nPpovvQLPdkL0?Q
z-5um3wUxe1OTTVf=MFH#WM?qeSsKH5%+Kw>T?_nnIPQRv`lAyJX6N__Y)jY{{AtSa
zIX#s2Jpf0t7#y9CqJJ?kYEre$=iKl^{>pgri_~x!f4etrY>E8&l1z#EBCVob`j@r_
z9~+!}t$&)um}dZ=ogQy>boE0+x1RfYR-0ZObF38&pdxY41%+1`TdhEDw4QghU@q|4
zXf^YNF*o=x$XJ!YHWYztFz#*T@F%bJ0r%)0zPIl@l^H0*MP#}mQ~fO<IsBY))IR$3
z5$7f){x}mdX>>-oKjgC%#nKQIl$x`<8Se&DR=c=nZL7g`{dHrR_;zIT{kR2u&h=$n
z<nFhUA2>ZdyxCtI7#Q$fI`T2Dp3*ybHJf|2+d>^{m^+j(@7;b>tZ|sVWcNwXn^`>R
zpSkbg7;S84uW3v}wocp4Oz6?aqia${qKNCUTFo`#aqFb{H-|~%kN+?rH_u-Wjd;Dt
zxq6mGkzb=6YHJEI`&kNuLHM{Uw`A%*g&{{X74+$`*R$x)<bjV{?Y3oAGeg%t5q%0#
zM|XT8t5ZtGqaV@}>I7+<xV$lAddWUBvw9VH3{VK}c1`FB0Z@HktNc1`m6)4++VYg&
z;#bc-F1Z~ftyr=`Qh|iQj~a{wg<lCzO#zPPdZhp_O%Clgw?o(d@~zV&IbySkRQ3^p
zcz;UcqgB<s6r6OZSTiircficJA3n1oOgFN>$bUwVI@;)b+|aqeVJ+HK7C}*stsZ>D
zglxF#))YBGeM;D8o&JofcZt8$_`QaIw571ew+{zL<H$Enalif7%a)*<sL!$v8=hgA
zM_I#MAkmfcyXkm}og8xQvcMb&^d8%wQOa@)JRZg-hj2{tPz&l%-jLmjfVeBcR(<S6
zo*b){yv+ab)2XR7;)TfIn5F4s-u#&82SJ)KLEgiCf%=V>Pf_}scI=)nUbWQ<8w>=b
z%uL~V&Kz*;7YSYwv9_bFJUNl4%+xJFugXXuDPO`IH9!{tJU?un-1-meII<e9U5zWf
zxuWfP$V)6ovFF2L6AP}vwfSKtOqY85uPd$<*Rd)BLV9&;FCK2XCp)6T$-Q%PkAn6q
z5NJQGR|Z!0rl$N{2d;HEVh9@lNX1XSB0%BvHSDB)WbwQCFl3Ab(Y-7hTSb4=u)lRm
zjqP1qR8@1tRLn3yYctCs>%<9_k^T%9f-RjiN?cZopSXZT3`D-B-R{p-BJj@j!p3(S
z#*XUh(_6ZAod~HH{VctWKhyg7&RQ6iMrqpdto1x87thX<mOS@Vmx>U1|F4e!dnJx8
z$#_2-bMvOG@d9h?uT2JfA*q(*2eG)ac72A=19lJ3SiLOty@Tl}!6YZk?1RrE8m3>D
zwtc0V1F2sl#m8BdTE*KfF$OsLj>uql5gdyJMEE0eYU(7Y1ba@ZIwnC@2MZ`udodU(
z#Y<=7F_tG*74dc&2TA=P6-%uF1Glb6V%_$E+RMJAc}IgG7YqY%5q@-OMD)qY^lE!a
zC(qM-pFBsxR$y-3pZbgExC-3sb^2M6fhjLbw#INT9R5xIUXN=N4^)q?n5>fQc3yBN
zvIFA&OYJ(Cn1&TZKfg}S)<Bv%Vy-igg-#h^tqG(wnPrrh*?6-(naE>VBTfqNo@g<9
zgdPG%?8^OABqq^FcIIe-f+Qis@;=?IFF=kNhY=!nI#5USIQg09h(J#)cR!0pDkb*t
zO!<V9s~<;3)1lFd60G2&O%g3gN%6+p1ggLucDviFJOeo)52+YrND!?cA3x~2dBm~Y
z&w+!;j9AOt$Z*}l8<9b_K|Jg^izQ!+M0%V0a(EFBI_zXSEbr9XZ|$)k-m;he4iWX9
z4UX0yxk_w3YE~*8DQ)@rbxS!dCWLK?LVjHT8neN_kllgW*x)wTDZ&v{hF}ijG%NEb
zuWm5`myc-s@NvX$aZME?4%=?+MnL*x?AkkOU8LOiVdi?D@6Vc6Avb}C`_T>=GiZx9
zo5&)@&8JveGTY09_)Wq(;=r576Dc#)XR|}SXy<+GLxK>(lu$(v%)-(=$0|VbfqX0u
zkhqg1n!eQge20YKyD-dX*w5y8NyV0axAN(R(8xlEu{kO;^^9(W<mZhh-`I%AtGntg
zsU(#s(;5*(u}OYj)$UF+$3VszHKi4cn9t--&w;(NucVIsK7rr!!H)a!C`xY?PywYK
zho*uxo^kocj6`(N``d^w?6eMpq#H533Ew8eUwF^j&VZx72*Ro27lTfzxqS<p0+w6Z
z;NQzT5neP|4iL<{&CLJ|2H>!=V~5PnMOcNa_nk9NscsRb7!L+-#0|eK+yvKYAlbXV
zFl}{`+Jx4Q)T_RFJ=+s4M?m(K8X(?TP~c=HY-UoL&Vw)9HRo9aANk{o&$97E#@r>G
zCA{(}y=OR58^UHKv!o!1AKj{*tl-1sPrQw?8DkonhgmKiH}nRw`UPr79_3)f{uSrl
z*446ccu?p|!n%wK=8MEYbJ)RnWS!`TGIOm)kG<5-5T8T=I4GA&oS1kcvhRIlRwxIN
zc>|@jS<YB291*=`&>-O97V(To0#u9V89z1%LiT3i<bYLNn25@m-Blg>Wxt)g4CG}+
zY2i$7>QVSNE>0kEkId3E3C;3sLQ&FZm;1r8t@R4rrqM7rS5`(#QE@Sy0URZvNu4<Y
zXV^xx2LE1ZRbB*rrjN)n-|G_@;?P*0(r58D{##@gcoDQnrUS~}L7oeYVN}7>r6+5b
z5;*3>48&_7k>U%pW0KM0Ck?whwGULH_oYO|LRdbT3a*Mz>SCP~#zuVO=2bFH>Lztp
z6}xraEYsx`1!D9m>=;r*#qYw0A1k0^W5c}w-$y!rB|spiX7z}7V0J7`R6TNGQ~;!u
zg+PYOWG`rcO0zPcDWv1}kHcS{wqChcWMT3(|B|MU!7y(}V=yB!jXIp{LYdSbycFK4
z&L};xlMC3Yu%|*vXyCf+Y_IeDPCtQ3i&(^Q@eCpVeqSlF4o;<x|8Y~2UAm;6%;{e?
zNEBXpt2}Z@G0>G@f=5Bu4lDmrC-mI&sR@aLbhNo15zJXcPff_<G+orv7!Hzq5*t6G
zxOv9x^Qu02H5_w}$w*)RY|R}rOpHQuF4R)4@=QpY6sJy;?#H~a-|2>?n%p%0)f{rj
za{Y`I_#~Vp`own@iR%;I&YNB=rm{i%NZ+)XK8gJNDJQj`)6uSv&F+IkVV8|UGvkMK
z!X6BgP&O-cFd@!Re;$WRe;jGTp~xN9DqN2FsjsWR)gK6Yyb^bJx>ZU^eeRAS!TB^c
zuo_DoBcwknMQ5s`sJN+Dl|n{itfO0q#!J(G|9Y}!wCpMC;I!tsvc{`U^({hwT#OJP
z0<-uV&2CC4Js-0DoA)TOkF@_7JJf;!HtN5)#$><H$WQo_5<cvIti0%7gUzAA#pRWM
z^O=}`o$O=ja9+n62Mz>xD3~<BScr`26Pqb`UjEDd&jTDzg7p{9svR4}0NFl*M4GBB
zQg;8iSn21{f)*w0pGZ2j;>`-KN&rNp#JojMuZue{{}3penA=Wh)G3RU&^U267{xOx
ztd4_|3RL_8iH|fJBlJ{)GYEDhi-F8~!O(p$Qq2tKvO{bRgX7;=TA(AcK@#F@w>|oX
zeVT%iJiPY`P5nkUA%0sW!N$`@y+C0Yvv$mOD-`>R??<Jjq0lA+ny_=jV6%+@8EKfz
zkZQG{-&?CqC94y>4<Rhk`mW}e{B<1KkE8V1#h|64huPW8b?#f+mXgT_B7Eb=CI5Dx
zoLZPhKDy!8OE0|~R1%bB-Wt#*&C9w*29uRn#NNKhroo@E8#b@ple0y?OP;r3C+u1J
z2s<sjxVar9obUVb8*s6~iFp&VnKr8I8yWfVb8jGC%r6zHX;y-t$M$ude@uM20A*i8
zbvySLtU=5swNxF()vtSI)~zK~rRZQrfh+eW;(mPe&mWrc2G<=kyPPj%f{)VE5k&yT
z;`Wm+Og<{&DS+~2-3j`79CPmF_fzY)$k=r8<7PS0fXtg#?rh5}1C~Y0i+NcGakTk+
z&BusUDjkU|+jk<x>!5s%q;{mxC;((5=j$NV+gIi)x~2XUEx^K=g~v_Q%GxFpt|c?v
z1JDJ(ETb0^3uq+g1bGo+6avtUw4A1h?F{0;B4L35o+2e7gkc3}1y`|u9*FWKfkm7x
zJdWH<0gT><Sof6Bjlg`FFeKlgB+n8P%G@zPLFB?Y+B{xO{sR4d96az0a986D^H?{^
zJ3??f4MQ%<P^@!-s+u-<9zDh<-F0Nin?u-5-)q)GuIJa5D&A*rg^!V>2wMfd)T3=>
zl~eljE!)m=MciGtZe@7YJ*rB57ugoc&f`9DUtH^Rn1obk&Sgoy5h=#icoVLD?A2JV
zWQZqy21u0QgD=QWqV7-PI+#4h32o{A^`G9apN0s4fN;*shi2B9=iLFD6b$UedWCix
z3^zexVTfMy+i-?pjVjg$Z)7|P=od`)k*|em!XwizKln)SC%Y^uWy7zdO<Ou1V?z8L
zfFs3$P#%hnj^MY0vrG{e7ucR}q<pw{V(YOdFkZ5BUix{RQ1IULOX6wcfE#I-7m@B1
zZ8A{orjuQraQK5IpH+M4d8jdyaJG0E1)8u)y!WT{&{GU-<tc-I0Fa=rBWH^7B5ZJ2
zN9=b0vlbSM1Di>S#p`+kj5+HdNR6iW6o3Q#Bbrpl0fR~5sVng${xTB&ju{B%bFZRU
zFsC4gAm0HQetnoUmS82B5F#fqiYi9DqF<%rwb^NO47c7=&0pMy$y;*kn3yX`j(oOj
ziKZj=@>D2O#%b}yx3~Oxl#bwVxh~4V!a>=eRBU2b*}35$UdhuRz;B-q5b=c3atf4G
zRZgNlM~}sN`a|(>9CAVcLj$*U%$|Vwdo^qEa~j$7FDJ0ivT2f&K|9(ghMM%ZKHxw#
z9iA`4MkVKc%#E|bLVg?&%DXg0m;aD9*u`}O6c!jUr2iC$CmJw-^{25G6F7c5_JLC2
z0*8Uv1;(u*0t%+-%3Y7O^L^B>g|kdkVnDg!YoZSH(_;8x0pL~QKMt<7Yync@((jL>
zNq4ylcoco;ms7UW29y=3xLP&kaB^DLKcP!Ow@=ftl@odtBH#&ExlK)*or6SrodR??
zwDZFX3m=x9{;V}F8v9N>Jw0uQODwJVcJ2HsbEjIGb$&$*8B{&@4hl@HAESh|Bz%}C
zvyx35&pUK~QBg&<fv<LQ)#k-ickuQ6#(p!jJa3Ylm6$@8B@r4)7$~$f;9|Y>)9*hm
z!@1{EF$lrnzyoUO3ijkr-QW=S-x?8Lr`Z*$DU`-%9mw!PcwPVCi>FDMlsPbojYmt>
zTQhhj<-<+~Bk_E5(z-YwL;4;0l38Rfr+c_|g8MmwiugP#GRQzcQWW)mH4_sGQHa)c
zkyfC<XS3gI0tehFob13(H!1WTqkrc$X!9hOicnsI(L@_mU&kQ6XSgjNvaKncR<0!>
z^b)JZgF@6uzP!TNZ9Asd`5{c#Q<nkd-2qdZ6(ab*pHzkc`{pna^A>T=Td4ZdDGc#;
zRpL`o??L5}Fj?=G{hBk;vud%{w0Lip1v`G7UpJdU>#?dSYh}32l|GrNealX1{&}yq
zT8}Oo@-fpUjDL*bb(D1~ST5;^fl?eH;@0|KCxxE~HBh{4WKw1uq(%bWYuMhW?Z=*i
z$Ew1bIo84s_0u^IR?<$Wy(t?&SuETfuYz1&$R2jnBO>Y}HWO}L%=%6j$(}dAq^t_l
zbEBksx;ZgO2Y+S9Iavw+eY3lnSJ(Oa41Ekrz<(2HB?s2#5yLG6@Dmm1kex;9ur*JU
zO96zr`(sAB%Hs<q;QL{GycEQJlTFhbF`H;v>v!i$wt%h)MYoHfj~*=im3NXTL=VO8
z>1R>etp>AYQuOrb-4vREmhp^emSc3I9I-$3iP3KjhI%Nh_=uCrCVX?rmw|BZ?%x`Q
zo<!epI8g7jyW$HZJDI|75TSGbwX6W3w%*T4`YQHSzcVGJx>wM;?3_-{toLh!tL`vs
z$SIPucc5v+M9e<HcWp4fH7()*F2@&rI=~SjC2Q_L9%sOEdp*vUg2^)AcH`eje`X;Y
z7K<YS<0>N?y!?%ucB_zKx2wPPhvN5NqkD0j#Cl3L*?%mRQSQ*Kj;7_KtPy_ljF(|7
zS^G++Ef`r;k;jqYxu5>3#7Y`6xW%0+i{;Di_LD^u<GL}I^n52?zWi*3Fq(#e5oFi9
zZ{wR}?q;FiqcO#9XN)h~h(~hZt;5hQ!GE##ts{!}udrZU&z`r1?`P?SdkdZNitpZz
z7qwdX1B6qkigSp_;-r+H9U~j!yU>9M4!z*lph`-01}1dCmTKgK1C{HH#EAO|*#Ut@
z0#^1qfy~B!pwP|$`UyNiXhZoD1ZCx+VyCvjt82Ot3j38l0BmJvC+OivU{Wl*1I}<H
zWB)FJv8bj!giTG-b_|eQblXO2`DPlXEB6O6Bo<qWvq-GeoyQ~QkrMy5n7Iuj-Z~m2
zZiCU<{G{4D!p3^Sh&;3drQEE`E|S?8ypeweCeLSM=R)Z*6c4O&?h)NMQ1*U_E|sP`
zqTi}(O@1fbVq*JCgb?yYp~a#q<}MR;+RtuFWMc#Xr-E%h$FnT=YbQ|C^;$(P=_@bY
zth^;mD~Sq_yECp7A?Obnq7s~O3k|#Rq27YVuPuOj;_f=$j`xQYLKH^<xUp#nDHQ#0
z5pQmY673_NS3Hzm>PVq6)(^5waakjnK6=*m`F=VUf7Zy{ig%CSr4F|@d+vRzwpK@R
zU|EzB^Izk=CcabmYTg$2U=A_{z*ncSbz_-o&+m)tNS^E}*ldxCd~MoDVdL12OFdt%
z_}u_&sS!?bzqT$~{4%b8mHk^dI*dN>0fhDjZy^`IbLl$X9bt07;4A<7Xv=njvWX5T
z^nLJ)5LjK0RVCsuhDvDQz_WRMfEtnzV`E?`6E_L~BMgp_)`D2nak%=8Fh&Ppx476r
zUEsU3-#ZGY*dTY=5cH~hQV0j*UBxvYC!L4tn6b|E1eI>FC(ZJuHaziu*?&HORMxWd
zfNnh*F_(YOF0%<I)%KTV?H!fDeRq2EUghE7^&1;`nExt2;q}gXmNergK4{W_jj~no
zVp~IjZ|aJIM2Rn=s%e-+Vl&ZZXyQX%*mG0SOrNX!qm1umep`S@K9Sy&D?s>J`wg0r
zf~JpN*eaYVv7u~@zcay%7?)=@V(Gffu)FLL%Sg+$Kux9UKM`K&ufQ$^*}sYo>AFwL
z+gp2R3S<?>m;VrQFX4;I%`oN8$8K>zj*3dhBoQ-VdggUEw<#sp=Uar1)jM@L`ic9o
zfsT9UeHVdOF_RCm-DI)o>b9Ecv2XAvu|;`XolBwii<8y$*(SQk&ZwUi{iFnJA`3@-
zK#{f#8r{_dDl^r)$Do`uK#57gTy&?j`bNJMQR|t}2XOOsqk@4*tu`D+W2S`TGKW?F
zTvgH;HED=WARi?0o0SJ?Jzo&*9ZcaID8H=fm-`5$!%p)@w%sT-+4MGJ`bfCFx_jNf
zg}zvp&&9+xrQ@-)8uO|Js6(mk29@DKA^00uH5|DBL;Qmhc4lb<x<^%ZvkycE__OR1
zBI6&;4mec2uYQSZ@X$NAE|h<;--3{BYM)vz_v%L!j$7l&;{7NXw^tAnkIeIJtg~6%
zi8f=)=#$94?WDaFxO*P{iZ}N;z-x7Y9e&_}@}e-XE#d9b_$RMc5tH{))+3JQ*O#1^
zgwfl2PX>hfn1VXBKV2Z3vKW)Huq$OakB$bqsSh%Iy4Oc@PH)TniC~Y8KmWSR_$3?+
zqyB;W**RwzXVGd(Aqx1><Qj7tmXu7POS=0m*QJx8&oNwp1L>H`|K?<=zf-H|-lHOn
zFYLY>%WjB!DhC<hNlggZ-H2WqjY%s)ZD0Y&8Xa?9R|PU;6?;F8VXgH-Br{$=){dWl
zOy$I$<Yw~Ntf;W~yx^U^QJ3h7xDK~PtR#A+ev;khba&bUYYE|Kwq8MFFnrf9z2rkq
z`rbXJ&oFej%f}Rz%TJF{aqCiPGm;<C9vPF)R75x}4gj6rPf+0FxM8L-u^X&CYbIQ;
zyuBUHN)TjRW(hYTJ=DCE-1@nX>=-DZwE4op)FJpgDlM^q+RHprYt65$z0NhhA!s^x
zxRfoiB+p)4omI7-u3>R@b#&01%m?aN-L3QKsn%)Y!IRJvff{moby9OjOvWVSF#&U7
zDJ1&?+8z6DHX*C=Yf?aX>$Gp_sp6!@ywH+nqyStTUQOHpBbo0~R7HL${L=}qK|s-b
zj&xKrCUjR3C%o7`^~HXvAmPhc@_jf7E{XC#e`&8+@J%wwy^SmK>ZY?M+KWncHI6|f
zX`>w6CTqhs4`)138o3kei3WnIIFL~b%_6J@$6P?`5j=o=XO?_-WJ+slPS2u(xQ6Ai
zgB0o4r@jOrqtfUBV)g;zVV?Ir{o-#v9QlIZU4j^`gVP(61{g<mWTJqrPY3ix%QpcN
z<VT5nNvupLBTL`?M5^5bHf5PEY$~bHdfcv9LDywx-nN^w=0lOYrA!_5^yOOK-u&)v
z#<}O7#N`pcx8ab_+!%JRgf%a&zBWX>93H&he$dCC4Re4kD>X%CKIS5=$Moac;QIeM
zC<6$YExG0e?b)~wGL;)@<Bm(Jy?@wDTEP0RJt;K~H&sjfAsKO>v91|?Jbf5dTp30v
z8k>TAl3&lR$i^T<sLO2kN*a@J_DiJIR_?+l=w|9FHjMEsnc@Oh9u_2WgQf((9Y|%^
z7P&8>b`4n|U?q2~Q$~<hD=?tz1XKt!a22;M_f2rOdz5-_yH!b7))?16y}-2GUw9ak
z)G>q%>Ab-dZ!?adpmVm)bx~gUzBp=8Df9}g1mF@_Z6t=|m_&@E-byO)-di)N4tzc`
z_q+Rv>xI!Tq+0Dy=byxGq5pn{UO5F={z9ghAJS7ss@K7z4_-*Vbji!#-KnVFX&BD;
z_Iux%H`lqWI_WvBM5g{Qy{j0>G21eajWd81LoR3N@5l$tX@75!^3ctLQTODZuf~@*
z2p;Z7-(bL?$12e)VL!R~HdNQ}LyIJMHI^=W2tN@*9Rok2V6LtPo5lc@XwO-d4e~h0
zQHrK2Pdw!M;*bqBBssMVa(WZy3Q*s@Me!4k1^Rg*6*;cp>0*QqT?i<4z_4PPT%0zn
z(s}Fr)MT-bHsTjK$=B@mqfP!VF7u{*4$dIic_Wc{Njc8ImtVQ1c8B<V?HqgfXs1bB
ztI%#PI~T7u(mQk!Q@dhS&x_%Rr;}OPZH?Wv2=oegnAc+p0O}pgtNwj3y=CWhYDM@3
zP)#RbBh5oU+S3ga8evGiPr+k$2ywX*Wk??hXLEi`p>`KeIK(4Ak<$KRk;q9D^9}LE
zXh7prH#Hn{2(L#*`jSxN+V$d|;YBB7?zs3B7G7=nQ5UE&g$yB`K=HD~TZO#xk&gYm
z%dvkQyENotGmxmGehx}$-QJi#E;%JYL`+0Y^L+P_HCDH3RgKhYA6@SgGS(Y2k4%&?
zK|N8xpb1?{Z;5JuT*bpPczNO#YV!4VC<m|{l%i+(xsm;tN6>E9-0Z|JzV@nfOwg?P
zj?KJz6W^&q=(!(u1cGrjX+##)L0bOYifIXea~nthe50fP86H{^ApKVS$DZs1Cctol
z?$bE>p%>(?T8KU~Zk9ZwOgII_H`!kpy0FrCq@pw~;tp?}nINtZrBn_8q935FgTYXo
zC$1QO-0aCdSK)Yt0Z`=3zhc1gB~3WbI<QeUujHZVvjjA;@F6)U<@x1CvHb_Krep>=
z1u_aS2+0fgMeDxX&yJIp*VfFq-APl6wL|Oj+*GgN=jt!|{zWY>Tbe&OVu3jdkB~1t
z``yC?tW2qdMhWw1#3onW9j+6NTpc!>cRK8&!49NTUELveBN-p{2R+w$O;g$Ay&cAh
z`xJ!n^nE@ZZB~sx<7GhFA2@-B;0PtaE#l*=IFEQ;hxS_>qC_#3CIhy-zt3!m_V_=S
zcfO~y3*X3*$3?SK_V?UXV$Lqjpf7+54A#A1>E&fM45m|&YgldMPmVfY;OvEGW*jM}
z<p^lAAAn`5E)@?(l29~VIY1bjLnwQsI9>ggK*2U{kMRDmhRJXb>r>qSk&-7aC*SME
zdwj*ah`9t=r#n;adBp2idvT!f;U=diy~Kh!j2p7gGr3egVh|<b6|9|&>^+e$5FZCA
zdHL|dv&p`7KW5a)>an00v>i3{+-DM<%glvlbca<C+g|?UgF-R)SM}*N`O$|>zFAgX
z7xsMY7SPFNL(jtSigJS2y~8-u?TZ_!??c;6u|BZJ215Pfnh!|~u4*<@s&v=|>e=Mr
z(c&r%*!es)nFr=G>>QZMZMA9EmS4{X(o`7uaulDdA_jzU8gP-oujLCW+rAi_aOj(8
zd{hpYzx~KY{BrqJ8NRYYr>2g!vL1%~<-lm8a+q4c`hx^0o|B3$23Pm-B*fBc9`az{
zxrwV7$aX7#;=??6VY?KJk7-pMKo;Uja8qA<p7Y{?wpUU;appq}Ax739`clt&3>v^l
zKc=&6rYK4T1HDY6?!lceQN|UZ&}ITdvL;*+abse%$*0*KZQ@<vi|aw>&i2oI;f&4q
z^cc+96w9Bmb0;4mLjUx6Yr@@Pp3!jq$1e<-$IM5=tn_lt9@s0AoMNU9AUEIkF&dqE
z-+hcx%{8j0)pbXy8hXTbvFl|<{x`56FmZ4JqwyszxtZoLw=FJa(`EP2x;l!@s~Gl>
z<SokOjss^7&{7IeBK3*?&IGwz9IzJuv@#&HTT1d(i-Ecv8FwHl*%L`$chKuf$)@UR
zZ2)Z)>!Ai&aMDS9{gDcTZfHrUA7x*%Grq%73&7i87foX;G*h>`k7Jb|kmT0B=`3gs
z7K$3DK4UNLWrQ2DK$SjF=!c)k4~&xB%IWuWgulm;(Em1LG&#z?|A+0eFgXg1!F2`N
z(I$smzXAG?hW~3+t@wXN+<f829*YFjhgmKEbYE<Ha=WH-z3OMN%4cbArP%{(F1stH
zbU4-I&0;T<=p%pZg0N<eJD>YV$!YAMI$Dh8e;Zuu^IsW$aK4E$UQG;>F~XRixEF2n
z1p&=6)Xam&v@a&rgN;RdHo<_4dfrD(bzNcq0AEb9o<{(4h*uaXdu3Gur0xJO9}e4X
zVQECT%#|&=!svBVq;N`9-x3?SV&E&n0Vb*&d=}Rqo88R2F1PA*(}TeY8DRf~H}l&!
zY<mpJXvH-E#TCYM9n;J3w12AP9K)}`P4R}rl?`WCH1)Tl(l7GUUx{&EILc;tf6jnS
ziXeroQS$C3vnfD~WfQ0;oc1{7rugK?hs5i!P?@T+F=O*nogNF-0XmIl`}2k7!D&X4
zaRn<KCwS_=MdO$Lq2udGHv(0{$?BBS@e@64i&;ODDFOy}R-60CCFbsS&tILI*SS6S
z7|4z0&eR@BW$QSs+(@5`jT=;;?ehbgGqL~8B_=1@6%)^SwQkTGaZ(YqIgcUKh%?q{
zDBaqi!9j(Mm-9@Lpbomi33@GIKP4NsJ#c4l1*d>FzP*1=Q9aTBNOLM%O_CItZGJ%}
z*fW{#W@9t{pjq}wR0N30L+#lMA57?RVR`>&{M!R^;k&k*0{F$i+TguC5Ew^n#y2yI
zU1MDoLDQN155Q=`IjDcdZoZ2x8kRIY*lJ*&agH1x`ev%Gj4zWcFd6*rD`mo`m(#q_
zb`RATbHjV5J74iKQQ%oVTkL4(JHrWGj?&JMyVUSVs`cE`=}AciQN=8g4X|YB_=4yt
zV06a5n=7TgM%nbMt~G66KDeB)su-N-TIia7Nh0|;BsuPXbJNyr9ewF%Y0anbpw4yF
z^emKnS)VC@9(-=}Wo$BwJk5hf-0w8{oLg3g;LVv3pWq_+JaRrlJsOKNarP7fnP^)-
z_#>sjSkKtZb6M>@mjEAQVPi{(K)U<5^)wxkd@09=TrazM)&U~~f?8cJ^dnl|6ZI}$
z6Q{DV3!QmwusQS7zkT!c>W;zyPWW<f9dpKVRvbv&lmDD}U!j3EfYLLjul*CfkjaqT
zJ0NwS)(p?qKYb8R-A^9ib<rHbCiC8O%_1Jt1KgfTS}EULpk>$~1g0O8TbiHCzf^@V
zjD)6Eh0FeZXGCt<zzf0SK10rU5B9R#yXLCT|A>JI&}ChwZ7;dLWP<rlK)_(Wd7(Cu
zcc_lZtwK|L7EdP^d4fn&Ljgv@V|6r9LvoM&gHgd_c?hZJxHXS~nRe1)jrm>*l~gz5
z5)&Xb<%(1I5CcJ5C1?(0Jc}anh0#m<3DFKNWVH->2WtF+gJuiP>{maWJ{1t^qT-=m
zb(;t^>$L2)=B;zDO4wTsbN9GdObN(Hs%sa&Kom-0;Cp#`W;=T;t~@3}q@J^2agNBP
zxvw|`7;1YjI%6lO3340=s>4a9`U3b-t``rqCzKLRCQwu*_-dm)mfDPl%-HRIlrSy~
zAGO2pd`J*?zYn5B3=Xo<r-oB(R+IMq*xdy_@(i<vp3zS8b6$=0TY9Y#RBY-lfjl_D
z%^z(<j=V#5QRgQVVBlT0YCfc7Ym0N^@5dL8sP=09!*KmYe-C(9=J~I71)+Z&feBm{
z;|VYhN(O#-a+A~)L+a*7=IWn-U7zxeen{J0)^Gb4#FY$b(ON!GtuQymfi59jkaX|d
z?=Lc<osFSS4iz>Y;BbKVtg&V7X7<`K$6it&rs@@(aMjM&@4qmXaifm0_?6)<8UkWv
z0`iS;PH-oQ>7x-!BE<W(x2P2`DTqq+=paQKnIaxqjO>BX8`Kl(Z9uCv=GbHhT8sc?
zheg@waO=Bw=qJ3r8E!z#JcA%68U&80V>;USPNETmvSx|sj9On564Y9WzQUjxA%R@w
zN7YBs1xr1f0=f<cE}Jem+@FWlEUDiO9D4TJDPCh@w{f6Nqpt)NF457@Me>wMP>!dA
z%MMg#?|apIk4TNt)f-smEJAabXu3RzEA5y9UR)K1rcn^ovvj%<s862{b5>utIQJdz
zcK(H0{yv?j0T=w_O0tx=JK4S^=c*B#%^FX;h4<IT`}qybx{s_v8h73^xzrg~t9OY3
zDP<b5f%GIFn@kIZ6M9dCf0@;cSHHK8o?y<@Anq-A93R8J51Y&HxNXNluwPdm@ssjS
zunM#&-dR+dY+Q1tJii5D@F?>4fwdJJii}>hquew*j0bw30kUI>6G|6o%R%jl#|x0Z
zD+Y0_g%=qG1<G6W<J6L1vrYr?U+V|4s!YSINz};Cvh*O9#ZI1*w#0n~TE~`G97y0s
z+2P0gF?@`1lxhM8g8gyiaZWbL``CluMIQ~UyWOf)w*+eNP0=qy!gwcx=dW$W;qqQZ
z_viC|lLgJ2od7P9-?L6-7+jNgwuZA;tM}d*EHUDJnQSd6Y0Ni1eY}rNBb0f_Q2fX`
z>u;FFmnB0|`TxiNA4|*&rwV0Qi}U7d|IYh$O*t-k)ZxFluDK{-tMp@VJ8o}~JzNsY
z92$vuS`slzU?H05U%~@V_{pwl1MV9rFHu<L1GS7&Wu*C*<466nkhYcNrX&0ZwE!WZ
z>gcu`t@n4BqFM;{UbDHVPad;_vpfP|P*4zv&{TOgih}WBg5uP029zG;Lj4iZ0e=|y
zHFbb4&F|XqAn$<d#dKdE&{aOv<{R$Y795?>ZV?F@FT=Idvi&hx45(j|;N#h_87TY;
z?UYda`!?fCMCaelv+uvt&jis7$@@kxi+sf@@`UG&gViE2f3kfLgO-8cMK+p((+3Fv
z_P(D{7@YVF#gPguAIqy!D>oSX2_sP@E+5BntjTv#YHJb^X7HH}G_Lq8lA|mbSt;1}
zb=YJ*q6l+uD7?e3k2*XEoQlSww_dXYKlI?m0Q-wBlg?iq6|Xy{++D$Fy=F$&+F%mx
z<=+6x2lc!RfB6Qs&#mj<4bRCuIUkhr5%I##7q^rBcm=j*R~Oz~xCH;buIXM1Vg0e?
zg!%h{srtKoM*CoTjRYmr@&Ho<BR{*McC8P$HSAaD)$0cONpo+{+OH(6E~dOGuTj4(
zUF4rJaq(Q38=FqQsN#g57;2>9V=IMi?e*9?5QcSfJPiX%cUXbFJ3%?nG?{lC78f-P
za6?hhk+Ks8wO@g+i|XbuXR;>CE_{zAt|zz9*gIOCHP|PKlqzFiAt7VRrS0K5z2!I`
z8nVQ&%k_-D_*P6~;!vx5$rCf#>@udcIOL#ZXHHm+0q+bly&$DZV<C?R$@zNUTTm>%
zNZQ|2bN-%zj2z2Da=b5EfY7e!`gb-PRcxe>Nri@G-3{&iQATAMi3{PiD;=wAx?L<X
zp02Zch=fX%zYsbR`;7Za4J?#U8`SVFvgQVkZY|179{(c|!56&P$Fs7=RjWI>e~Oio
zQ`ee4FF~x64nV^fahb}oI3HuEUpfPtVI{Zr=<to{QC3rZB<tHCQ>!h(=Bck2Ce8gm
z@F#D=xLC5J`8K<iy?<0TUU|fS`(|uSKSD-B%$<Hd>tTWA&t^p48`ipc2RZKT*A~3K
z*pjWaRnWoi(JYQHLeD8wTz^X@>?Ap^C-CS;zrhUoy(C~2N32rl7RP=v+NX9Qlrkw-
zio5qb_F;?4rkZ(&|IAUGKbn#L9<guIk#M?>*WpqU|E?5ZYYj5ywXeyq8WqT!7m8HK
z9m?Mn%rDdBCfNHmdK&ut!cATD!a=of?rs5VPu7Yx<EayDugi`Utb9uA<M-Uh<b8o<
zLz)dXe4g;O6o`^0SNZD+ERkWlbzdPLchl=ey0?j_g`jVa#AwgGO(CIy9LpukG3SfV
zjQf2SjGh=4xbyTwP}K9~(jAUHAj)t=|Hw*g#8wG|Q8-9%?ct0~52}e_J*@TfQ2rl~
zglO1HP4f%?sJrbxYr||&CRSh?=<nZV#LlQ&=_9c)R`~XwcERN5*FZwI`;kbz5*n&o
zkL-R28ox1fXhO3lV-;FR;=q1gD4(8mZ_=nK%?1;>hEEZ2&B+XwxvD=c>I^(Pt+V!D
zJU{QlJ)@@gjH;tSV}WLKcbjlF+z5^kNAqMb)@e`n)cW-O*X;AlgyfSCyR~7oDNR4i
z--;f8f1l-o8Sse&j=H%HuT^nmW2nWz9C2~Y8lCdS^QI<0e4Bn^z=zF^mYn+IdMj^i
zk}bWDo~aCoznwZ1TZL0kTip6V_G*`D$Bb(>b(`aYS=d{DPMOr;ch?yYnNQ&>mN;f_
zef!2lT|Az-Nc?L;!A?^C$c8IZZx0hi_LusKyu%vZQC2i7DUbcitvr}U5|--*;~ww*
zt<S2Krlyn@{R^e9a1lghHzO9NYM$_=A``9|pOqwg9Xwkb?=$ixBRB~THSvP+X?=Ef
zb}mkj9eJ2J=)h+JhWR-KJvO1(9VaQU<ZhnhnKT}ZUd60oC?`L^Np~l{<E*GPDZq9r
z!H%5S9@!?@tJab{boF`IK3M6avI~!m6e#%FLhZm-Tlq(iN#jK!N{rX2S=()HcX0B*
z6Kgcp*oQUUMTy4TGYP+^Y}6_xp76(IKM`~L|BT5i%Ku<?%NvsFtX}MU`Hi)sRvTK^
zv59Tt^-zOAjz+h7n56N1u9Gz%PtC`jT;8N{$9#Hv>B)!XH%9{r7sL9Gv6B<8a+P!Z
z;xW3=lut#63vJG=JR6BWtDAmPzWLw+Q`P0G@hk7TFjYXROjjh|R%c{~ltTJ=?T$-r
z&zS9{X>uY_RC-Qf8HqW@1)<eP7ju>RJxKNHg&MOum&c~y6+3P)el}!6gy0U-PGez>
zbZ;HSfAkvZ#8D32lyOU2tH~&8oeql%#I}y^Eirc(<b$r5?LstVCUx{9a*nsQ1usOb
z<pa;Q7X?4n#~yZg@IWWaUr4Db0jq0+>x<fIp%>~n^k}BPr1bQBYKJSBnAi7AA8HIP
z^^tX2*d(mo;~m>tZ*#NbG1W&N^lmQWN}=YG8M^6K;Jsq6-P{z(I4-j!za<Wl;<MZ-
z3M&F!W35;_hEV#Be$#0qgZ$#RTm0>_b#129BqhD_XjjBrud+Ks9Kd@5MHfI~J+bTB
zs>|8-$U5jgFF6%%=e$vDq_vih#qL&4Y4qf|wj>wO-;^62)~la(VxkdXSzkzMC?@6l
zDAv^=qPZsT1Cd;6HXfDdZroelO6yXB9G7{%$uabmap=nDf-A-oZGG^WoON}1+n?KS
z@zJeXvvapSKw$jNUiHG0eBCjg$0b&hi~zzC`RanW3ig9Bm+jG_>Hd~Q+Rseys5OIQ
zcW?f5w`#ZP942@%&6_mtiwb1xeb{MY$*P<o&)eRezSdZeG9sZ{vvSf&hs63mpEvoH
z4$n?P{eI)=l62TeVU7ybex%209A@!B9A>2vRP;%C|Ct_w7HQF<<+4aQeXxIMC175M
z?&8DZ;Bs?W$;c85VbTxSX>-_#V$;wBv8+BCVg{SV<JB%3DeuZXths0HirARP88-3Y
z;zpgh>>W`0Nh1^&HnDtFDNv*Cy=-A)JfP)>1q<I)u|L6IjHw;X8hq4j;J_+$hS@Y9
zQFJCL2^X3(P)7cMTSzNqobQ!VUs2X+dch@{A^ot(8VOh460SwfQ_McvQl^{fr&67f
zKr%Nx_Th-fYXDJ$sXhH7ND9H8Y16YfX1r*EbgrqdU9nhrZa4i-iwc?27Jwb5Yc&K2
zcUdK3Zf?+4F4(_psoMbsx4(gf8pZQ4F{!>sejj<D<7Sr%H)0090g(!>j!a$484f2^
z%e3?8`fDdHCKTmsR2ed{dLcs<Yl+`)k+Z|(eSaSP;Kntb+bMYS!X!$6(r8ksUwDA*
z1wGA}WqekCF3OsL^5$)49ic>(={Q5)d<?80C;uE9c=`S7`-3$7+Ing?KkKo1-7!m;
zS|;x&Mh%hfM=B_>_x|%%J-hj?cE7p>L~>_7`=VNCf<&e}QCI~yA9eLYewcY(N1QVz
z`gb@GGYH+j32r9dpb%dTJ3YT~us$;t_k(d{_*dS}6}kte=D)f9)PYbM29}wVMllm;
zc)ZG7@nMFSV+L9(0f4gSFyW}#rkWT)7K?z6i(8L4F28_Fq(TMHx<QEJ{%+TUcPs^b
zs&@b0F<>?l1Nna($nJgFQ%K+W`=PD9V(V{h<(SZ*p$u;eqw45Rmrb{`FIup};kmuA
z*G<c8M(k05#qR|8Kw+uhWaT;{Cd2=ELF!i(kJn1jNvFg1&5OmepSpIf`ks2$EVShR
z9Y+>T6<!2P9d^`)S@H2aI9BHm`%}Z`ukGf2WEgLuJX7KS@Qrd6=s_zlMK!x}+<6}d
z(dIiXSb`~^V6z+t(^L&}Lp{bjNj69DRSA|?0{}Gj?gzXNPUaQ2ynathf%6l<=uRh5
z0Mk2dTN9L&$9+>6GPUe+UH?aivTg$Bl<Df|3Le!l6#yUH+i<|=upd8N40D|}3$a`N
zSG4}^@12c&3GVlxHOKt1y`au;Hjf7Y`R)Me86V$^OP{vBzv1MP8B+vlL9i3|6h~;>
z)IQ4zoaCZN@jNbb=OPF;EwUS=FE$k<x27*J1xV2f;qUORsXQ|kat-lt1%x=(v8^nV
z3rz0IeJmc|J-<f;k&EnH+_0(VPqCS1Pswc%<ex^JTB$#f)t&3}`Tyeq;!}*W=ZS^C
zrd0Vq(wZg416UiUo9=J^O2bnMAAh5|8-7pAsMqSHX92)13PLxIQxKnb*C>*PPgU%1
zk7p~uRN~ml<dAWK7C|`7ha#IS1#(4p6X)UQY&PVQ>z(D_Az?lM#40OUcCr7I)#{yu
z_uG|!uD|6rE`s!>2&8aFgNi%^z6V9@vDu9R&cn(1-lv4L82@lE=`^(k0I-~%tKJKO
z_qbEosU33mi>Qepxsl>im2d#SsZS}d#2nTb7N`aV_S)bpvmgLsGysz6m~UYW&!9T#
z9JR4IF3T>?NCTq=Ov{R{Td^1A4@JO)B7m_^PzWJKO%grTeHxH(CYz=QNsE#aSmJT`
zd=ZN?-1mhVMQg^sZn9w|x?R~mi8zB%{wQaq3K{F8u}!{3)_tVlr3qA|{84jZ?Bl6x
zHcRvUEO9Tj{m-KkYmj7UO=3kp_jI4yX!d*u!+c2QYID`io8nNj?gmr57H!FSI~b)}
zYS}`!rYJR0d&9LO?>FY7BfFivce4o7S#y(YwRg-J)mY?I;bS+Fh)FAfM?nic$#oLJ
z2UH0!rJ_udAb3m@hQ_a~4tt`VrWp8$+u{|dH{P<-A|Ljf5P6kSeqtx9Vqzfb#SOvD
zdzC<L>Ur~!cuPtx>tD<my<K%H->hXt1HzKw)Xa-Wy<__*pGzm0Fb(krrQEnTWoMzg
zG`$ALAd`DK5H=i(&%MVA2CSwjsj=9KqZj?|07kZ&+dIq+w7nW-ZJd>a<Vjj&A;5{a
zM@))p(|~@6+m#K>fSt&&fDLom8S$jW`t-7oNRA>0&33D<^W|DEW2;(G3u7h`e(5Yj
z$L@CoNka=?#q_Mq4Tg<)248<aEKd5MbnxdHK*kNcJMWU!?zp$=uu1CNI@)EMj31E|
z2|N=?gM>FkNUHZJ&^4qcKh`?FwI0wus?#`oa>YfJy4957z|x7$jxY~;%}v{knJf;V
zd{?~<NHcXcsBXQJx#XrZ`Lc$a&ZuVdGAE4=&)CbWLu%x-SKwP>uhrv&qHPra36{b#
zt@{Lje8p9af6!4ZXe=RmZT_9E7o2K(hQ_w=hh+zyKNTf(y0;8Ia^x}P<1uV8fK1kY
z!+uACKUpdMDDze`)p(?|SgQ5`Z5^m;VSK|Wy9FNb$YrgnoynSvDs|M4>OT-fj7hm-
z!zynU)`ew`%B%lfbaDL=#>Lxw<<Z(>!PU%$H$VKeb8<DT#DW}PCF)xP=%q1r;H)jj
z|0I6BsY;NE5}N!mGaZa!ImJU9b5VeL2cB&_l;Yk1*znv@yHCft<umI`#*vcYK9Mzh
z5}+`_=Y@KJ@WdqFe7gVi<26ep-d_@YUh>^{!9(ZvOQWe<F2aLG=kOYGl3zOS-om;K
zV%r<HoFr>qqK~Q<^t2|^A!ez>n_u<Wnr~0eA@Xvj`Qp}~Ov}$E$|5YCTsuRS_R+TF
zkq4hrSpDjgR-EF8kEbJx^6EYX&;4%iEC}`eIhnU0X)<-aW+HYLW^Vs+Qnv{jEh%AK
z`*gCV{}9Kyll%<cnBRDf9i+YKbP<yH>Wj^PLdNpRoODLEYiw*}CiR?Qe3sSgvZ%tv
zzDH|kda{!5$NR_|u<UyCpSD|K_1kNxLeoJ%L*oL-i2tIo<7<)rw)Us}-X=Y?ShgNg
z+s9BbP7%mAav1wLtM6<hI`Fvn$IK8;pgeF@^Omp}<uIM=KYAtM`=gFafA~A@XUa#+
zhMXowH2~6wh$nlaKHbe+o40;QXGX@!FzQc$`)lKEzc*9FKF+v@Eo^3UyCz~nV<`pj
z$Ws=2IFpX-CevZut1Ih1-aHR$ki?Nk{9#KbY|-)+$i;+CJoS+qEXSRCY|+i1dJ%IY
zL)h8^$NYz9deB&f<U^bW%lR#8ri?}qQHtuvpF8s$pDIbR&|tY#@cinb?n*lS!od5c
zHif25Q_L<VMi{^QCzR@Kz(=M-cs{!R%<l&sWUIQ%g{T#vvUqRRgNY6=aOtD_^2$Cg
zQrp?k9V{rvH2{{^*^ZgS^-Pu_OcqQ<&3}%vJfiC1t&ZCye0ugP4ambOoI52%ihJ9!
zmxLkobzXirNHC<qrWrLUG_=UxzPTL&%PfKh&qEA-p6>Ltj`VDCGgvx3h9qo9)gLbJ
z9Ddk(w19&P^Mo0b=!3eoD0oTmsUsgh+aG#u@8@{?m16sdtWo_f8D=A+;PqU6w2PYW
zJxBjcNx0rJ<aD%W&?H-eFMjJDMrGyNj8J)pbK6Z-eQmy5<s~#<pW$9EEqua*%KU7~
zBe4*BTi)fFC7Ex96-H~1eaN>WywOaK1^b0N0)RC>o5_HT^2w)*XLotq2j7II|NRxD
z`dTypL_bnNN<@N<uy%I7sGF$8)q}NL#=UhMMPttYEaExNdxk%=!!Ey(9A~g@-kNGO
zm)`Q*Y|KdTw}f54lu%fv{#m9mR!m24ybq6V0l)Hm+gQmg6+E>4up|rhSaht&ht6LN
z1XQFWeikO9uzp#g=`e4~TC2zZ<cUHvLN_bpr)B7ivwPFm8nuL`LleWgx{Z$QIf{Oh
zwXeQz1_@YLe?GEYRxMCk{ejXN321NMRB%{X34OUK(>Qbh%fxcq%@6ggq?cS0cSc7s
zn8>#&2EgIN_1*umbk=`OzVG`VFuDeabf<K;gdm;D0BHnikPrz+w=}4flwh#Y4bmyn
z4T@~EFLEPfz}P-}Kfd38;QryhuIs$->pYL+c|fyNs=6KLzgqT6bRH&u{6*p@%Afb8
zs+a=fKi3$uwYZfwGFCD8eL!NYhLaKfKSvV-?br5e%^#Qg8Uio)Aio3OU+MHEphhM*
z3}}IG*jQI3D155pi8Ho1!2Xd>F{Yx<#}q3gm$s}JhJ)$WUHjZ<)h#Cc&BG{e>J#N-
zO~ImAb`Yf<?Q77FZ(As^ZH{2lQ%5`NErD@C-qNUA<Ogl~h5-UFhHm-Eji$Y$?{Xg<
z6uR6QPEE?}`;p<yeY}u>AZ>TcTip-7C0etF7J+V8-cM}jXKJ{b5q8Z}L~GJ7S+}*K
zIINbe=@7?7%~ys{)3%N*d?1BQ+yQ(YH~8`W+-)96Y~WN#)+g7he2trax2q>8uot7J
zdYN{ug!qdiU$dpKJ5BtTE|6u=aU9k3&0bWyK?(y7L2O#G)AYKHN2mX%<j1XcraPIU
zVB{tx`}j6;DH@nt**4vaj~ukUX@I-{TS*GmzL-H-d4WUhi`VMNV5~0|yRE#r{~Bm)
zt1S7zfEnJsk~R_1m0Y^pvWTQOF%s(U5C?CCXE`^g3Ce80JRyK7mU3bF5k0Ev+m&%$
zZCpb4+PE3Vq?YmM!v4#f<}LZt#w7KDZ>wkL1~;1yU=K+thnca~n)^`{HACb#y~S>9
zA?kI5!Mhp5#)46zic4Ynb>yw!TA$O@6l%&1xWXIOs3?i$Lw1rvR7j<6rws*};I$7}
zQU3T5duxb=J>!bMyCBF~CBG{(^YIF~hZpJRT5B@z!q}!h7gH_edaF8y2Bp{6?A(Hk
zQ1XD$^$>ZA1Md9g+?9y>!H7|{R&*+8np*%Q5}@^J(Fg_6(X>{8+`C3tDE}w7MOmL~
zhAEho=;KOvNOlmY4GdwLGxyL&#8cHt@j9E33e&XEhLoG*yY_wdOgBVM#%T4R7EaPZ
zwZc8ngS}6^^qEwq0^1XZzK4=zb|OZ8Rz_M661oLo3Z4QJQ8Hc2ZB@f-GsD)}wNdn+
zvj+LL2Au(vgHgQZ07?}T{A;gf_DVv^k#vYG#oI1+wnit2^sz*ll}&*$&F-)SNQ1-u
zL4~mHwZimNCcz>M{g}?BGgH5BI#GqJ$AFxh=hMJHgerh!wNt=>BPG9lMjZ6B-r}!p
zHE@W{tc}-@KY%XDPp-(bZ)*GV%E}cw6nb15Qu|C2`98@$?0_m3pc^})rqD_Ns&b#6
zE^~E`)9ik+!=&o$vZz671@L4!4$l~%&JzSxt8X!`j4XvXF$h?7%Sy^u>)%azeBs9O
zRZy^Hzm)&%)B}G0$NM@2FE$|2gJR42u*ws(Z~?lo+9&Vkt7ora_4#>&-F$*?C_)aP
z{vsBF>8k81EAZh99|{~f7#uX;87QU6fePVDsHs_TmyBbbBJvne_*w%a@$%AJ>Lu^W
zvw|_GlOr(?aK-Hd?h0p|bHUCRaJQm3DhuwHk@N7ukVVMWT;`)vQL(~v7H!X&gx92O
zOys1qH#3MYA1H%|ADRd$Br}vzo6=?^sNAWQ)DUib6K-avRMONNBr<s51W-XE)JVbN
zrx5xx7<6US8te#Lr4!hSkYQSiM80Mo9}JguWA2_fAH26#RNk<NndLsh;A$Z}wr$xz
z!r0=*d0E2WB1!tx1X`^R5oO<^<6jY~+iChjLQ=yFY>B3r#Q?0ZUX3d-#>()G7uu{g
z>_R9lq&`lBJ$q$PT_JR=g{83d5dzC684&+nW9ml^y=wBq6N#?9o|S>eA=ErAHo2bu
zT!O6e0r!_^%-Bq5|C}Lc*hy53Z9z1ZAq}cwU$$p?xic9tLV+fmKJHY&m=F7LwS@$D
zW0T%Y7s+XyZ%z`Ux>R83pd3ZXk~uvg8_<Y=2(un)Y4bH9$Yb23{^bDw*U7*Va;*QC
zABp)1K4sx<>U~#BIzSX97xt>S$7(Z^v7hXwuL6g|$y4h`*)6$7_VU?|A9R>O4=TeW
z49HGesH1An#_wCDjU5qA1)sPOIN<-X#Kc)SdMTv0CM4WfVAg`)LIxNU-i@sxO_mI^
z-t>xSR{CapYlooZn|89cYxSPVf-#Gvy3MsgPd|PHjk!2;LcEk~ESko>TzAi4X(b{w
zt34{}zG=tl4v@zr`gQMKW6%??$h(hSMu27@1`;uBFhQ&nj_lu0lH4qbO=?fxaVrj$
z?kE}1c0XN=E;DOaz0eBT@=SF#8}rY+GrdoDLI3?e^Wb5^faW&fioRK>uId<o7|1)8
zx2kgRb1~7MXyYKKxGYXq5u}KPkihW@g}F;hpA`Ub;RBt1AId3dj7ruq9NYBjCnj%o
zQ=)qP$*KBYlmeGMJiwS7QbxW`SbM!>k2cs`z$N=?mp^w{=kC_DQH!x?05CNgz`0|x
zkWHA!;E?*vWqW7D#hCs12TRJwWTL;jc{E3Zq>lajXNq713~Dc)Z2Xn333@W7`STN2
zFn%=iUy3gkNfce(hDmFEN4|Q8o=$2Pzuw#>TD#Z~%L^M^3iihZ{ibCb;INoeoNzwy
zsyq0T5vZb<toEQdu9IAZn$IKSu(}Z+5C&c{820+@70u$Vu68>$$*;xe6rQ4P<A1Hl
zaUIf^$8@*Ja2vWQ{!H8oEtGF7?MbD<XqVb=g4e`mN~t(+lmG`Me{ZVQ_%PKm9HsKJ
z%CSsj3*z&Wb`Nj@DLne8WS5rA`hzQbM(85DP^Y(bu156(FTjPLp2jjTCB}b2FdV6Y
zUXWCM8y9Kb-L>phmeAONp7#XV8`1=+3t6NkEF6O@e%w7fe?d$`vQK8P?sWSf9%jkE
zoIxZNgAUbBKGlqQGh)geK9YRll*#By+J`TU<euMdU=UwO*n|0@>hc&>Ij>)KA2nSE
zOJ>rG7N#)9Yq$1=H|^uaSUxSP_bw?_55<oCnG(Mp^sma8{=yi$-J(UxMIXztI#|KU
zMqN1UOr+ldgbSik_o#OG1d7x2rj8z>AVtZ=BK&yR=KM%B`LBAgJ>Mstjg*^6bo{~7
z!!4NMF;{e`cdrm06n_cb`-3(5PxoLok&w&#l<uW}J>!VgI~<xHdW@orv_v{&1hT+B
zjSGx-P2MvnaX-OZlcPwg@bI)LR`LJTG{?itz{kwFdxI_mva(ySIzxT&C0OENCA%1(
z1Tr$R<q#1Uw8q`G&pp?WoxgO5$aEc6BnUx%XjM)%$J!dcL}xBotm;P2{)+f?2wC89
z8$|1we3BUSdg67!gtT})UxfD-S*JLqROyHFpXXu?rSqcjTt_2aRWyGC%QYcVkW(;M
z?sa+yL<s7m^a9w}p27ln^E0oP;CT;)+MB-Xg(XX-(?36qZi0XC(vSVNNN~Ttws?A&
zqDU!D5;qdJMZ9sQN&Ef!0D-9Ua=xEAHdj`_1Cq?L|C~3Vx<pbB;&uWU5pNpuM%(D@
z5X@%sc!wc@Alvx?@HaP6MV}G4V1u62sGM(q_n)E~a``D}`zGfrQYxM*lmy80B~_*E
z+h!7?ZQ&CjeGx~J>$)IHgdp%MM{?Mk?!(Ml?;dMJsVOp)XFj$3ackgiX&MZXmD#TL
z0t;IH5FI)*z`jdF-U;U3!f^;|N*|4!J;xWT;{ZXuRrOYTq4%jaf2_&==E&=$R^k#m
zLp~`AZlToPYu}CKqr6+s?QE~Ba03F?FSF)q{#aC6Ieqw(6FRQYR17hB)n1YR7Ipjb
zOGnT1eYYRVolte4)6{TK;-N2|wO<~~@-8!`v}}OUM)2|sd9F-34#ljm9(MfYLCevO
z94N|a&9`pJM4-aMj7CWX4Bk<WEtUL~{!kp$y!&+?nZ6~V0OCakFvhS-^2+M<BMGzw
z?f5mA(m_;dTY}@=bkA4{rMYlS5QA(UX+6kr3b7QK-*Wi*^U63UT7k%~U$%zi<;}JH
z1B)Y>8APWaiYndEZlidCW@l`lwl(4-tzPa_&~|n(su|NS#0uqdPVJumc4Dag$hB?~
zp+$*y(@gCc0ZFuKo(~_4Uw#u@t52g!p%b2rd+G257h_7<xmUx#nFD}H50gEyOdzUO
z_{L#Q;^%4^x|u^@YT_#-_yj?5q@EP$@~hlgbLCX9=^feNoXvw{(FDm}!m)e&{7F*(
z`kn~9*L1H-mfOzUKza{N^D(~UA`8Y5>eBl<tkz70H}EVtG3><k)9Vt4RgW^I?OS@9
zGbM;7J|(&!0=!F(y-`r`#hA|Gmc)f0TSrkG+SZG($@NiOQ1SNH1D~`2@hnovqDWj7
zoMX!5<&>F#iE{NOrDUc4w|pIUA?n*!FzVmgitnpj=VKxlcIr(dSs;m6EH5w5Dx0cv
ztsuSBk;DB`GIyMfi6+%AY#I)C<AzIkVD;NLoQS|+Am%m$Ano&$!0M&}l~a(l+|j21
zX`{9qy~*6!kK=iGl)vRWU;O~Ai_CbDX#GY78UKNGL<Ma)zK(j4B?+q4Hn5%UBVOC}
zd-{8~-GnO@%If#YzWbx6X_P2$7qos@H-<okv}N8Alu1aA9(Pd)pyBAdQS$EYvD~}v
z(u><d*BkZ<J!M^e;6)sdw5aVs%r-Sb_`tMgX%B%G1dgl{T(45p34b7N%;JnoC028z
zM36tj#a;v;kxawJW3{#pXQ8N9kLi`BVIG@o#;@$C!gBy9^X%@nv-?6!i&7<WEG8Na
zTBv_IZ)m}@3Npl+-c{~p1u1$26)UC0Y}qvd|E<vg5YGuZMU!vBWcyC12aHZjdjpRt
zxHahL6!`6BmKXY0@6qBqfTg9gn(f?bO}OEd>CTl@l<dkm>-~mw>9yoF-^|sP6%@_8
zpGhuRg1%Xdm@m37w$yYkU>8%(y&=Pr2|!!c*P7k-spTfG`--FSwwV^x_lsqjwlGrI
zP3=E^?t8m6gd^N+6cbG~7|@W?#Lz=;vX!ZV?`Wo1tX8(f8*%U1oaIlQ{ONcf*}%{Y
z8(#fX6rWRm$IAj4>XY0rwKhx<-O<5O)BKvpiv|fo9tX~^XDz0majmKuK8cxyx7hOp
z5rlw<-nov_W(JVihrf?45Glb)sMP!;i3yquL0xJo_!^RPDTEFnfoSd0aJ1nVwC?tx
zS5RH`p@j?{)*YxU+@fmLtwH-kB6gM7HAZmYo|lD-7G2Bsws29Uu?F44VHLIlu_YxZ
zD|As^5!QDA&+kk?a|GK9WLtjvX+p`G5u3R;uit=t*RY%X?({sw3=U=*ImzqU-$AAI
zn)s+<_zd>OU3_m35lLfH-(G&}RS)n=_a&C0lKn?|E%i%y2GP7^l^OJ$Tt_y^Ii`I)
zPc}er=>;+akW=pX(YEOw7jrTrCcrf8!L8vBXF_4Sr1{OXt}p=UX`KD9C2(_Bo$skD
z2JFLxWq={`5GFV#hv(uk<31P<5&A?!H+jHYMnS?4tTwdb-m#bmRw~sq2{b3<-ri4`
z9siPXd%SMmG%!*qjw8tEcju4oxINgEh`k<wHE)a2TgJ;X06o`U(EoMwkIi&M1+)Do
zTfCggV#l#~4cTRg(Eo636A`guBp_#t!B$am;dbtBJ$;?IX;ZpEF*1_1?UBw8zXZwU
z-R0_?#QplZvz=Lnt!_hdYowa*qcsg6g3f6!Ie_Ltnf=+-@@gP`$=7J?{!mY#d*8U~
zKBl8rWy-$qic>7ItfOB^J!?Qi>d7+`qUhefo2&JAdN)^t9VY#?^D2%CAo}ZzFVQ6I
zWBs4x6iL{aDgF~scQyEtPd3EJL--_|N9Y`**b6vVPeVt>Y$d{RIc(=w)7>)MdK1#?
zLSs~Y+VZpN+r?SS%x;=bR15Es@`}4BXm_-7s}(zpvXj4dAwJ>oo0>^{%!<Trex`Z-
zM<yhnkd$k(MKSX3W^AbShj5G_fLSs3OT#^YSl)A+#OFD&@SRh%P=nvSEtO`EK{o09
zpR=r}IiUHg*qj#Nf+M=;?9xg8gDaPyBsz_xFo!5eY#X-MVf$Oz6qG@>4I|QuUdZI+
zqWe(AT(dy)9{qN0Udj1W@|K9s{s?-u6yOeD5XVc&g_4KK|NB6l3>U<6Z1MenA1^D>
z1Z7$1-e~u`+!4HANf+jp${-m$wvC4V$Q>LbDHB&|e1jHSvU0uD1`H;hn~OP-|F&AF
zH5r*BEv%?lQYedqku=q55%z&sCSdz`$A|4w5}a|W)U-oj-r#TvYd~I3&y0|QF#h}s
z{K__#Z2VjQlLbV;Fs8CftOnv?M$r*cBWIZ+FL6I>@F^iHX{7a-;d_;c@;5rEA3Rq{
z9%CG1e%=fD@jQu0biN?NZV)Vk&^x+X)5hO(p&teSmlH^t6kEsDXiPj(o4cE^{`Br+
zS&|9})WZ><UHpypGFthCR{(XijMN0d7GKBx5PgP+k7E}Vc!?IKo+NpM$9;AvTSU8Q
zSDG?WBDtTFPhVqs>py<PhTzNE!6g|Pot8vC;9w~8L#!M@#%t2V0$qx0#iKjwbCQ!s
z%glz2q)z*gv5}9&=envk`vY7bm)N$LQppHw4ljpr6wOtnbNjPC&yM=pEk7l?a@~f>
zV7=;bWt;x<5&F0Jw+WAk+Bj-kOczPpq!CE2j&NDsM*;Gk)G?Z#imG-dT7Mnd?{i|Y
zUlRh$HM7MFV~AMDnxnX;kul0cFZVKHNs`l(xVRL{GuWNq?SLilH`6+X_uq9|q7x20
z_2LL=#I?tNzYpuG2V=xLKrFWPWHi0)PGtJ`RIBLAEjFJOb?~CcC)(6Hm4hgoS9=c3
z@w;SYL9!2PYDSyN^`-PawACe@A^Hk;)f0)g3iO&nnf69}kL(TtBfE9hg<=fG2!++>
zv~U8tkA!FknIz(VJa|>Z%8Wj8jwwqBnmpOuQIlx@0!Jy=NC);lLkrLA76vUS_o}-2
z9@^FhvKq`_gkoe`FZlNUH|`jD8VyE$bg7&aAzE^07FDOuQwt`3GYZk2J_d~T%MqX_
z$RAm8eQP1?v|8xph~12dl2H2KynVDP*^i_O2?L}?7^@F*@nT%^_cIFsgo*6{y4D*T
z<F{J@V-hjyrSrO6VTZSUxIT2Wc34aCN|f`^Hyy1mK!PbSKOI@zeP0b}RHsI8;KcUY
z;r)Vk{zpp<H9k4`a2_7og26@)yMC;S*mC(>`n~_dF`FgYU5ta0z{kEx5hZ0y<lwOS
z>TsI&jE|EKqbWR(NZBLZE_OXS#q+>4DKZ0-l`69`i4^tJTEfc#zP1)WJ!ftU@WjR}
ze`?(u(eIaEW{$&D(ldT|o}SFIt=4YnSmRz&mp-fHx?WZybv2uH*6Tu$lc3&#`n4>~
z7e6v)CCB7-9YAU##?Aw_6{94X_T;tC-IefyZb>e`-K^XxpG}VDlCX_PO$HXtKiSF<
z<4=S&N{!ngxTVw7pLIX=Z%=w(Qr`}8=!#i(;)>N?(5qBJp+9S_2Q9X;79+lhEPhfG
z{r}#Rvsatw^dghrv_e2zXd7byVDQpu8HY97R5{J#iSm*~*Fj+w8*@Ux&X%VN(MAQo
z4l21R6A?`?2fass0xPoaVHjOwRJ_hvxs0gp49SRl$rXH;dJR{$+TODo*k~}>wkKyB
zd2*#57|H}VXT%C^w}NeJWrbG+GL@KwHN@h?(w|W;hD~|*69G(tL<+i7<1y-r^r+^0
zc$g;jv&?2;G#i}-<ETvEDX|g|AmN@Cn8Sio14zj7b`MWS|LZiQ_Y)bj#(nk@FF3p-
z;WFUY$xR={-B776f|98F&FYDMtP>%R%d_xm)Q7&yW|5||-0;n7Guq?fR^(QQ>}=~r
zg$53Tiz6+|Kfi|Kb1wGJYZ|2<lPEYVJMj_KZv5H?ar2-VzDhlWx@B$xBMLYownj|l
zda66ings7peG<RJZvtI5JHZ%-z`z;+T($e>hXo=RP|Ty@a2sBySIdBzvYBqx%kM<Y
zc8$pwr`~scs-u2=R)Z61dvYrGS2>@dyVoj6=?k>u&i4Aaib)<(@8tn9_yW}v(3#gl
z$@Xs9tIGQFcC3vDGgF_<#=))@>HYbP-XGfqLGcIk2}nYPzAuuvYBddpC*Ff%>W&P5
zHri2PD~;ZZ0)N0hxgVmg+ap-JhDFnNYafK^i3qrg#69RDVJ<7-I=7ZFW7(^CrkxxT
zaX;eBV^iW6OyJ3R5F%O4iHCPyPT-gJiQ7AkINP@Fl8oMFh+-r2l!tdG4zH|`AtX>*
zkhaTDPx{oNdox|jv;K~h2rtp`fjC%~ul5rYPdspCBUQYc=D#-&$gEGyOaVs)#K#|0
z=(u8k=<SgZ(hwYv$Z_K^+0uftm%kT{L1BOu>l@uDoISw0{#xi(lR-VF18f17Rlu{6
zS&mk5{g#$dL!k6c0tw<0CBo2L4K&x0B?%@zHGC@^uCo8XGaMC`1H2?{9UqcJM=AQb
zkve>A!QNhHMmG^UNM!9I)b&BdPhx3xfEu*On-KNH`!}1QSnmC$NF2|~;p76cV2}rp
zydntDS#hcVkG#iaYy_s^LbY8s8!hIkH1P1{s6L1<wj-n~uDmFnnu3UhkS~Rmd_VzU
z&Ykp>Wn0#Dt=yZnYv_giU`5Pd--;%$&%@)}uGX5X=39$qm>z?)gi9k>RI9!281viq
z;+vJ>UlNB-sa5X_$>l~@YE33u%~Se(m}+e@Av|2;Z_ff5>p;E#X<;S7U|X)YIW?er
z_w^6AQIb~p7|`YSEJ2bCVuvo6C?`m-jf6-wvnT*&5csO-m?V3&t<;WywlzZaJVdE1
zQC!iP|2la<oRCI6BF2_bGg$zOmS_NP3J<u2ebiMwQg?9ZN_YhL$_*f42?YpM{}}4l
z!s7O;R0(xZ|4}>?!ycKIBx}8vD+^5pastNM#USAUKk56mzvpgUo(R4!v1i4B(osAG
z1Xg`HJ=f|AYdF+Lub!-1t@dF)jkG&D2K;&Y-_m3?=JM_)pz;#9W%(ILODzT?B~OGY
zKdTb_^(~q`A=10X8#nvbc|rWd_UC<AQec0#J%I1QPLQ0N*5AbW4)5-q=Oj#Tit=($
zw$zI}-}uP^c|dhG*tR&x(~sT}5QvB$Ex+HMrqY{Slej`|YV4AM0)tV7R%8dzs(Z}j
zN)JCP0nks|T-^bbA(P2fuzDv3Ryb#&S1;vPx|VG8#14RzHbDg1NvFEjeC}=%ubnWW
zMYY<6pD=Y@L!lL>&(wE!q1}8FPz>EXBPy$_VlAx1uSw}oJ%xdQEfm_)TGuEF5t6?4
zah}iR^kaYvltf8>>xFG*DRPM4WjycH(b!~P+fEN@MLv})*jM`__;yj1u|k}bbXb?P
z{XW#lUWiMf{6l*f_ea+LY~FW+JOuggG~Kr~<A!U;Tvxq}=bawFzDsP*uyl~V2s`52
z3q7R0I>7<eMv|~tfhaZ8M-XZ(nHRnL(KjZ$MOSNdN@3WqBW$!rSrJ`A$B0sB$1Wnx
zH6zqv`xNPd7M%A-mK1;JOLn`OK|bP-idPO0{p2XfH_dT$J?5w#nbt#p^2q7edFT{G
zz#|U=4l&<a;r__Cb<lFrDLY{q<kH79r3+cxfzF}J*jd7tP!UEog<D63lW(WVL~obc
z9Q`uC;DbF{C-$)3E4$E5N3!aZIo><nAjiItxzw#r9Ou_9xfDGkX-P?NVqil6?r!Js
zZIf^e%tQ>!a6$Nx+O&fYx<Xq#Du%D4+}ryh%p(bW-s^o_bW-fk*RmOpT9{vq;Nm>f
zI!4?)mz|y^koIf!ok{K?H8ngO`87i|m0nZ)eLVCbQuk+$bHYQ(Qy85kL@%Y0B?W)t
zI}kA#o|LC_gFNI7biiSaAzrCZ+4=oxQ)F=5plU)e3LFDInA)o+3rHy?(@EW|V(EeK
z#kky;6rI?ak!0o~f!yCmKdx{f)$`uQU|nUIVey1n$Y%->)JDB;uEqipv4XAd!E76T
zeQB*QpE{#=!(UYKzg9wHtTJi4&Gv$!Ky2apNnF@tOf*jDEHqld3v1_H?5f<=m+%7b
zf;sq3{vC(Y*d(}jiPyPDgr<&M^-50t-gccBc$`N{6~Jg1_l=?Z3Uc2#!~DnN7CDkD
z;Uv4NT}3!?LD2Dkq?>L4ZEuKM^ePn<;kiDm^60oPU+f=pzW6!`@Q!wBjP(RvGRa~=
z<a4}9BbM)3&ztC;i@v_HY#|&jRfm+GzcE`2ziF<6F({dUFIJuHS?p37$Uom!!XZCF
ziNy(LYzY~1g97nwK44$B(*d%a+tne;j$zV^=GykFm>%y@v-~)8O13=r14A{Y;3x9R
zhfHG|?3U`{0-CfhO}G7Tm=eOmmBj!(6a+0&e{*~KMOjF)669T50}a<OjLWUyW))v~
zqAS|CZ$FOzDjzNz8?8(%*6{GJuz;bpT{B<dWqDH=p(SfeajWLqz@oJ;HJ&!T7W#oI
z+4(_RPJ<z~b-lG`{(a&hWzmdgbx^d#9Q2?TsVCQY_CQGhnoBi0CKL%v%^r<qc6nUu
zLb3ZNO0Y}7Apz;bjl(Lg^HQk1H4m48i~HxGzrTL`YaBnaKj_6rZ7vY$wCsOHTeG6*
zF<zetf4V+6JdJys@uWOJO{yz~q?Vl;IlOs+kj^WZbDQmEg-T18VIWFh;hKD@4`pBQ
z0|Cl;ns9E9E_+@<wkuOs$tY5@wGTo?je$sy608t4|M0+=6bP9(S8n!SAg!2wy7rcu
z?rNRGLY=Ya7{mC0%$cK=!ypexkE$y8_h}x>Ns}|4y-cDx6A>skZ#=;*mGX`}Lf?f;
zNa{WSsIHk(HwIKhDBpjpNJ61@F;w~)ZpzmG3f8om>5h^a+BH;Yqny3_yQnLP%U%|e
z3n@zBD;4UuCL$rar2ZOAMw{Nqt@N6Tux)82Zuk{Z6u|V~$5TXZBl-trFS+mJ^Pou(
zBeDC0>ky)?y@9@7aS#$Qw9~i=zg8(D30iI)`A>dkcdOO4tkIMQsW)tXxCg~66V6i@
zmVy<TCbWDEbgoQcyIsBFR^8HyAzypRubG{-EiaS}2INU;YC$wj3x~V8?CbgS8WOF@
zQsWU^t+myle;>Y;i$UTQPAlZ*wNhbk2+U=wJReN|H&lGdPUsxy7?OuE=A+6n{~=+o
zociW~Dx{r1G?(j3y8d9lJpqHi){@c^xByQGfksj53_W|nMg*|l`RL~RriGg};GKS4
z*xwEbex2Ap9P(wS=!pQ1;=~1z!i!K6ZD~-Vs5BBF3)CbVQnsD?HDkh_33x$&5c&s1
z@FE{~qGrdMkK&<I106$)Z3~vmH~5)7svw*Uy@T~7x_Z-QKpqhIr^Ik~=x#?uV#TW&
z`o&Ci$u+G{KGT5OiwFErbN`zYcvi1d{@5xrSMhuPgb&dy2BdlaJ#}zTq%(<9cRx(6
zx`ggFYYu(O_2h!>+aKBs`T5V4cXqzoo2HR|R-pA5KvjDc0`GOg-R`c1jX&{RU5prG
zLabU}zRW7jPiYL%uVuY=Sx0|{wMUw`r8XT}U5j)-Pd-~h>Vbdp#d*orf^GdZ+Mq2T
z-Ut2x8;&;3JIb{F7y*ZKI1$r*bIbvfg5wXC#tR<xC5jplEPvsy=e5y_{oR{iY};F_
zHK++}z0KP%gX4gIk}HSe&b2Z3r*+oA37nL08Vh6dgvD>DX83hiE}oBq$YK%Vy*;t0
zZnP%fr!CO5_wuo4I%?xgVsWY(c<jnAE%l>d<}gmxSe_><kXOs($3|lSan$3M`2L6&
zqw<&`g}Vy_ax#5w=~4ueMSmky@Or3!>Hb!ZN9Jyb;oL@Gc%M$%-I*N(`6DJ1`reYF
zic!p|SYPz1Viu229Y41qM+@s5b+T1~`zI}1d_><Mp#LSQ5y29k3`rJp?H8NU!2J_t
zc=fK{ne}F6+aTkfAPz^?*^cHRdy7cg?&RO{OSd#~d+}UmZwT2T9VXEDL2>zI{&Fub
zwBrm1d5{I3$}9nWFF|B>DUjB1$y@bOz+MR2X3wQ4o+fl|jwM_9d!G)nVDu920c38!
z*TE%m=<H+(qu*yo-JqZ9X+QB?^eCu#1y2<_!&WqoZrnEb?11Mw-2J^=)Wr%SGxkUN
z&fE9HR$bQi%umx<8#MJL-+^^!q7>d-jm)p)SNOL|0=qeStY0ShsKcr~HV=s0ZGCB=
zQ%TkhB5J-@hn>GMjNULXl%K{0BAW3Pq&e5}sK>bc63e)PLsNPr?zJe)<vJ%Ai|o*b
zw)h&nc`liUr5bTsCXAb}O)9;HBZ?jh4Fx@}2j0RJO3+&47<`S=8&dj~BUt{|-}RD#
z##dPLB=Oosj3<<U(uosCCEWJ3^Uj)TEQCR{zT~`DUq?nT!(Ra&jAsx_F%UiVDvZyY
zKyaQ2W?{*<<MocJ*;Egms8QcW2??9OygI}&ErG2%%+mhCcQPKn683+lIvg&G>68u`
z27|2?kq+t+^-Rl>agkPCi|az*I#~&$!4T+gc^URXW%=rku0Gq8Ex8Z>4A@c*U`~0K
ztWjh;+^{5BSA&5NQfIe?@sh$3RLGLSL8qz@c`oicdSb+7oxbb8FwyxEf^eIda2>Jy
z=EJ@LhYanB?qK=`@Ba$>J}aqnX5N2SE=M@3jgNm-@`{YEk$!nK;On*B-<-zk)JtCJ
zu9(7NmJMK~p+Mwu5JSrmtmr3yWtjq;zW_pI=h&s4AN40pt4Tc>7}HIHpAlFXi%omc
z+TYQW?OT%@G4zr-D4eQ|)wawqD42IE(v87Z6n1V>i**yo{y}6BeQ~nR;qeA-pg~Tq
zKMkrY+r~q4Poj9qT_n#RK#(fH>Q806|Ep7u-z#zOLz4jFsU3Xq?eRbOpj6$w#P8i0
zonMA0L6nhzqnE9)BR;+l$n<+=gg}--z$Q_gqrW{Luz)|TRx@Xo{_`-#_#To>!&qjJ
zjo+As8v_4*e2JMR{m03hvbdJ@2JwaW)*~T;Q2%PPz-m^3SYEe^sf6h|J$)R;z%XRu
zIEeS&(ryQC=>}2Duo&7*$9LZQDIn{V5P|YU#$?wp?iX86#jdwIjnt>o>fYESEGx$-
z5xm{YNx=QRbk&&@mBB)|O2vV9Czk7B*(dP;#YW%Kx==Fei>A>mPU5aF&ImiGdz$*7
zzAh(AUGSzSox*xlMf!h}Jwl_pN0&IDZ63#}U%zLUznVu@CwLu$@5&FQZ0!H1E*)$U
zY>!8jct2%U7F&>->f6H;E3c(e1Y4@uNoI$8SW9t>#*F>1pWDCAB7b_=9y5P0gKut%
z^iVRoL7is01PhFYe|&rOIWi~4Rs9AnFq)JVB>anu{Wqd`uhNYB$cbr5>?JN~4+yM?
zV{tF?){2|FxC=;v)p~yu`lJ8ZIiJz)&8vxxBGzJ<z224=XU#tN5$ZJ_a>ZI&mbxSX
z#e?vj(qWq!ojzlitcQXiQS<}ol2rw46)Txr+%~@%UTm|Vy%x;b)EF(q2!{Qa-{Xl9
z&}L?lWM1wSg8p_|!he(XNn30AWs(@kXyL#We_CxhrCvjFlGr3L6LDTqGbjG;N|K?y
ziC{_+B{b4`OT(}E3rSbbN~i=Ve`vWtPz>HOjOSI8`!$!026IeOO}o5(z^s>gruGJx
zc8c7Qty$-(AN98#!ke2u>5#r6W+9$^+#sNb@eQ4o^1C4{!kS<3#IGf&8KGqUN%2QA
zerF&CIW34^z(A3R*<>o&EJ?zLXMwv|L;qI#9oeY+lYEq6`D>NI+waYsU+f<+YqF4h
zkM8VCz<eJAVf16PV>lsyE6VISzSxO*IMSt!>5+wy%6$JOy%;<dmaK;g*ow|TE$jLL
zFgntRkww?Nt(ZrGxW*x;Mq+Ci_}c4(96`xy_SJK{KUWRkzdmJJUs=D4oQj;8_dpgW
zFOJkN_mxCdA10RLY1#!WPOYIiEz?|H9|W9K_aOy5KqY~z(?%O-Mt5fpC7!@qllAcA
zNq=^=+mTK~w)ljY<TDtyAw}DX#(T|tmtC{Gx65hMhe(NAi2Il@82Z%xVx0}+--<NI
zNtMb#U9zwy^IZ1FYA^XbXT-dUD9!MxwH6CN%$S{fw+>Jpzv#BMe$LtP=<R&1512ch
z;g~%9>mB7%^Qi{g#8mt65}XP~E`E8Md=OpW1${PE%)34855LSGxcA0Jqm`qdgaaNL
zeVekVx7&k?+(ooik&#_{_>%cP191?1p&?1uIz<blXBPB671xB5Sv67JTjeE_?kB({
zgi!NG?kl)DpU?VQpanj?RQagZR()@*BZt87aq<O8Tri*I-e3Lseu>$|%M#qfsGk~v
z!H$>o{0ut)z<dr;_fE3gEY*5ThtP&6ybV!0x^Op0|Lk&0D?wvdPNT!-Zi}lCRU<3t
z1POTlW*W=S6vD1jv{}x-+*&`Y7!oK|7V-}2i`v0MpdRSAXQ)~lZ)8y$wTDQl6kLZ%
ze>RUI>$Ob5A~iP!Iz5b3XWP4`G1yRzvZ0r*xcL1$NLJ3}@W9m<&nMc#7jPD-AdzI=
zw?pQntx1GPS@J5pD6vTccTeg5urtE|>FKg2;4NU^o`uvB*VY~(9b5!ZKE3Pjkuv=%
zLcy$2Tn-3vCZHk_yNt6G?TJptq{r~ZFn6#SSAS2|l5@D$qQv1dwPDYe(Lzfy!>^t@
z1tN0i&u;L`n|A!@(q~KI!*w9pIgZZux6`0)eXjbyx1$LR0Z%9dHr0>ZrZdrYfJa}J
z`ZRDtMgt+>H$E1P8ol=D%v@Vpmkx;rR|PVy>tM>AMdbKU&Ro7{VnVmnab)01Bz$_f
zCt~DV4<yQZ=bjA9^!IHv_jYW#{rOVzCoOwz$;a_ODs-=@A6ay}#mpe@M$N$Hl%=Uu
zQ|9Du0G6R)QgO26@+ZbwmgFF(RFGo6PGCwkb$B<pB6dL0u9}6Co%-wViT77MVP1w1
z{OOiS+P%C!+z*%L3EOhjd64HW@=Q7@mE6F+PnI$5cr&|~yq9#+yxceW!}&b*sG}{W
z#&E2tr8y6e3}$Jv`ODZ5N_MNU3F@BI)ai1z+(^v9NgceZbjnz7J&fznS6qH`=|-+0
z<XbcRDw$#iLnasV@3Z`8ImjLAGP&R`U_efkKJ3{5ARt+FZe#iybAt9jxKIZCEJRh%
zeZA)5JA@g4$VAEBegqf=q`H5U0?>t<?8nCtzNV8U1ptqDJ@&p=4WNz2`BF03y1MDc
zrX}vB!eLqGZ>-YU*WSf%sy;0dcAQENnVHBOkJy5lkjRX+Ur{M*AS%abRLR8FuMex7
z&b#&KZ0k~Xxag`*a!n%bh7*PGoQ`~c11>A|*7Fc6h5$hyt$JKueOwxJ2cK%f=Cmw{
z%gY-=Jyi4+{P@u!9d)wE&Ev6k_9%B!H{rpLo239dA2Bp?;AJ%&`8D(v``*6{LNeO#
z22;}#59JZ<!tX*Z23YR}q(~+m%*)a5wcMTCtt{~(&3IIrGd^SRK|xZ?p32(fgyU$4
zf5R*9q<C(C3_bTi>vvjxf}(zI<2PLgHDrVWJhRLK>S`j=Ku(16znQ*o)OX@b=Y4}0
z4+<J5dvL0Vl@9&v7)RD&x8?`#N>3`7KVh;9Q{h7dVWLw}?vq{z3frDcyU%5VL7-4|
zw1r=L8yq*FDOAw<B=!yHQGeX6DmvEOb=YM+u9@8Zd?Z|2D_VTd%?MN4Vw;3|h(4T>
z-kJ7Qk4_s)qxraAxQo#1phcBdF#q);*-HK3>@4R4vA#KfE8j#yl%PYkzy6u;zZ96Q
z5^va$FQHaD;KeU@hc|PYPQDM(D#GANr3AZJ|Eydm6jO6=v}z4*2sK<FJV>@ile@;_
zH*ic0-glIZ#_%$?JU0^l35#w>ezCm?(x$C0{C;y`o*KtW-2v!q#1F88v2PFvojS)W
z>^q8}Ln#RWFd+qVG5#^)lr|EpaH{p5iGjq5Ba-&7_ksnfC)4f3{cjp?++GnSAQ#@_
zF6-mE-2l!rp$&;uj0mYy0<i`2dxg53oLv;|)P1Zx*NG}kOQcwi9NQAYii3IKKd~L$
z)HmCjNT?bv;ilwAq3+&_E&AJfHU2>dD!=QT7+Pv9Np^D&=2Pr;ms4q$>Wiu!A3P#W
zd~quHIhTx3gZ#-vYkhvI3q6FK6JCOdlh0y9J(C)hc00QLm%WR_nDpA4vPBcyR@SxZ
z9i1``LINQ<VWr>y`W(z8pF(Q&gjrdsm*pP2&n4ge6eT$rc6CJk`J_8LARiocSi?m<
zbVQ!@ZN|qe`Z}UM;h62FKJ7n|3T&6TJ;)FM64QUm8=|NG4b&(^&#9Ejh!dl*O*d3d
zyS;D&9Wkn+MwdBk`kk-i*Pfz0U*BanY<FJ6w}>o?Ihgt&e4*rV1U58T-O~@3?hz8y
zjMIc>4RF0Bw`D8~<Y9nc8sO;p6#=SIEm;_4YPL?;x>p}QTO%Ls9;${*rTI%lhE@`u
zoc6*JZ9H|&1#p(XUgdx4hznyqNBbKn!-ol1@2}|<6HpE{4a68Z-k4p7Zh+8zfRC5c
zDp!7(sokC+vl56bD#m7=$BB~9F+;$1D_A(GoXQ>aattI2{GGf|7td8LI!<=-i`|e8
zB-$e7qTqL+g~0NQn+3^gHz^SbJ490pG3Y_Cp+jXj^zjJR^EuBS=HHrvZlN-Aej_z`
zozduCo@E635xM7Ft>;DZ?$rbvJ?pC+x8X$ekB8n*xuSnub5?+)61Q5omjr3lgPv*m
za*$_(j?IXECd94@W~MGY32$)5rSBd4a<}~Ot5jOk<&sXL!7BiM@{cu%LVM|c>(YJr
zOAoD?_Ze`YV9{rC{c~UCj@on|K^I4y9QWX$Ul-}G#`MUYgJpK-;uz`jXdI}QtKuE_
z(NOj<=}jTp!qp?o-uU{`DQ@G-2v6-yO1@g*GdwKgF;N>7-@M$mooX_Y>lQL|_|iHB
zyR)N<v#N~#02_wpeMq%3HCb{JtSLU5FJ(Bpj*erswnjfOj<FcdY^zJI_5w^g+2er0
z^wQ#G)cA`R%jw9~tNNYA@GL|zOqSdfM>}r`Ty&{y$UV@hOw!1I`*SM&Ao!JrZ7;b%
zmhj8e+S0|Zn6@B0N&Ci^r*S7x-%CV4qqg&TTxKxKPO0VmA^U%Co<S?afjfroZ=uiN
z7=~$?Vn9v-QpzV5^vn&^t)FcTNQ?TO5gmR#Xd|L3C2FjXA?;(hh9{QW#}R+ti$>&M
z)!YU9jDAly76oclRMc4#$UZrO82W6|k_{CAVYyP9_5|GLL|3_Y7|FF!Gc|o%DT{tA
z@E?(F!G9i_e16zo7AK*Z6l;hodBJxsJ)}-IF<TO}7f1A3k3D~j$2Ppfd1&Yd<)_1)
zg(8$RXoKk=A=!U-4#CdiXH2UA*C%&h&;OIoyBpve->;L45>hM>U>+qxnvkuwXV%zD
zk-Vo^id<o!7$kj@;yiiN7OmgS*;3rx$H16eqJLM!F7_oL83)`@HStqAg>=J*<J9Ex
zUVU&mz~?}xlKlG7l-jAuG4GP2J@PiTO}HD<!5Qi@D>LRw`^@16_jQ0Wund!LMJuFG
z7`-Vx?(!)WwAnmLz9IA2J%hnQ{u?4L&hgpn3AG~RGwXVO<LHWFX7tV6v61q0p8Sk$
z9S$*=ezf4_%L-Eq7@dhii?lQ`L;u-s3Msz5^M}0laclv9x)PJW9#=BG^Z_%D8!T(F
zengXVc3j0pL1BI4Q-_H+)ek<7%{9Z5{(MDio5-Hz)<)fLvPvpH>lUR2T{ub>fA4LT
zw1&v?LHln7TsFq8?-sAHj>ck;cdLx`4_{b$%L}31<7Gq~&8y$&M|JSG^@J$}boC`l
z(f9O6Uxkj^32DpXFb2*-Pu6hV*t8Vld*UwxHR7PgR1Mm+3YlzX1TpcJL|L7~TDsrU
zFFwC}Nzk!yp9CznO*O<S6;3V?D<j}4<=U%NjnR*$lhbyjI|8w;MgY>&zs?Gx-Eri<
zDxU^0aSfYm=KH=R<O<_5baL3>x(l?Sv@^H{xZSDB;c$obD3C!c&wA7{o@b>h_`Lqg
z{7JdRdn3ueJPbAk{{4tEdLydOV(+8GLCb=4f2HsXJ&B2LUi1riaNljMw+uy37E`Pi
zgA1X0Ij<N@)F!WSf`uZA-}6YQFb2aZM<36Z$NXBP`LgDN{A7-!y>2G?R3qs2lJY3l
z3lRT==&v@kteh+J*6F#O$GVO*&u9P0L6V9rl+Oq<!qA3O(7^Y_15a88CMr3%(}tX{
zbNMmt*$_}*P0VfN!>0;d%!H8wLgDbM7FLhbceALnD@~qZMr0%>I+n4H?AzQ#1>zIn
zZsSG2I2eP$M86O-H^~2NBb_8b??yZMxrftcW=8Kb*RTpa&MR(qD>+00z9vK&K$0Lw
zPV78H#?AEm4hP|=;57D$^H(*;ae;fBC8y*aAN!tUV9BLNv*5tIbOmitmIW?u{dq7!
zo}8)LdxwCMGK+(VZ@S(aX#Qjg>X?}K?D(OCh25qZgYz&abh^a<`t#_+pgFmpBS8sB
z62H3;9B%ug>96a^!uoOWAjh>cI;Hm)Re%d0M!8l%L~R92|DOcN1>u=5f66fO)W2$q
zC>0TJ+s0KU9+A$xgj#@OS!>4TphH7mg&L>@tVLzB?aI(nv&Zy2m*1hgx3tDN*k`Mb
zy^}*8jOK5uWMK<%QuJI)O-;-*{g$os1T#o$@jZKXkbcZd%wduzeMM7urw3y^n^G3X
zv2m5st;Li2r%#>FK5u`M`phhOTKXlwz7G8hZR+v=;8aUgMTBBBWk-=%U!v3IJPCF)
zVsnb0{~)GUGlN3v1mER2ga!1Q3=(^}ve<nPcR;*P(jCYZb1eS2=$~7C9hIm{otv%)
z+1mDOG~#WW8W#h<fYm&v6+GyVyY5>NyIxT&28C!6iH3$c;q7~$kD~vLe#a$T1b#>v
z`Xk&I_gm(5fV3Br$p1!4w2@m8O?+|@H|+x<veE~(isM=KyR3&!;?FM_`v0F$7QN3f
zge)z3HFdbNGx(hH5QizL?2xGSTB1JfHSzo?RIKX5Fmz+MWM#>xNk2`LpI)jl_Dge@
zds630D^KXkG)RXHx!0POQL3RKnC(7^rQG9&(t^RvvafNMr>Q$xoGdaV>%g&thgd!`
zHFIpo-3;cJp&Am^HK^-VT%j{r0XQT{kOcN~%rp%ECv7zi2EAssxS^fp{G_`6_65=B
z)0^kqKfZ{)+1xP<mO9P~6B+Z;1rP8>pLVmGAQG+LiNm|ki#|ESR51cU<?f>5eD=mC
z87MlHlo@zH;l5GgWlRQl?+iIQoP^IQgX)8+Ja&tS2SR#W3flHo`b3(Y)DBFh8Dvrd
za)z4)V4qimc<3e*A1`w_`rsoqx0jp}fP~oM$M+GVvF+$*ae!@FYJ%vj1{dxH0u9Yl
zdav*YOwq*Mi!Jl|7zmxKapA66f&^p6<n=Ix-7^ckKl+lTal6^i>L+aQC2k7a>2Vh@
z^32>)-{-#aXe9%VeDAZsEXHbnxs~C%Ef3xG`vVv)v3dY)yAFY=uC0K|c`@)(-#HBZ
z68N3~IC%GDhu%0k@>lB8xlx-*onLF+Wq7zi;VJTuXJ%fFjYcvYXn|;47qfhV=Goo&
zymKB+2VL$c1N8xKzT~p_&roivEH@66=iVy=%Gbkb{h(R-J!~W~6<l0RQQ!X6k%^g-
zVincwpp(qx0DuZfKYr-IuL=AiV6w&Dx9yp}hSu~2M3*%M#J10KD>!b1c`!cz#h6Xb
z>U-xR!twT)58+txc&7Z_efk`Bzi8*^b7pU*Rq}r^-~EZd{*rIOkulBQ8yUFnHooZl
z5VA=Iw=WJXe?+xY>v?KHkh7ttuuvt61(HLGAvmg3w(JNZR+puIHmUKPzqpKlB3i3k
zxv%M1qy5;<X=6Wynbd2YQ?u2||4?l<%zEf5Z}s0f4$;i*8`u_OO?tp(Lrw)CiS0h>
zrQ~zYBCU&bn|?_4LRMX(_DL2{tyYxt^py(czA<+*X$GT(WG0Wn%RJj_d<Z6pal_AP
zyluX&5#p}&5Tp)0fI-oGyJ@5ctQ`%b0NLA*Mb?>DnOAq%!<FG{<|W93qIY)gcRr#m
zgPiC`)s4Svo|k3(L-Rn7DO37^k|FTuzAHa3iSxSvZP)?Y=oRXvJ-s=*uceoZ5Vd*W
z;F4C+XqLiLj5PTL_P}?r)*63|AWlp=&!nS)%8f62Dby~Po{#*S*<wOu*<QgFAPgI-
z4^_h;4xRJQ4|+xFcuN#p`sjWQi2fz1)TG)3l~`}r$<Zbd(n+l4;B<z<zYIIi&1+9<
zrdTSK-5r!)<TGt;x!kb}r@Z}LnhC1Olw}TET}4&3@E3HX7^x{+-<{(?$emiqx~}^B
z2paVlWgl+qM2CI=&8zyoC_RvAMGy0EWW_W(jaE0qgMqTfl;=)%-}_P^!g46vO4NFH
z<fLr<J8e;FH7#!lQ#j94VSI<YRyPA#n8~&(LH=L80(Vpa1cYim+zKY623zlDQK^d{
z+DA$5!{FpUdBiFY`hbl7u8eD?(Kc@y<g7w)Y0#VcIF(wvy$mOe5$4zbjDU;tM@Yvn
z{hILb%F14zsKdNR4l{?s>42dVbRUkPdeb3yC3xR{rPcmHnfHvPydOC9`Mbiy{K41X
zT$_o>XsS+zq@y70z9?ML?77F)<NCJ;vzNavqHO;QD|BDc7J=?V?vQOQ`m%3}x>*=l
z)S}Q5OF{9bPm-Ai_y-7jdO5Q-gWjz<yV0n{4d&g;+dvvC^0ucAKEyd&t@$=dceW8$
z41VCb6b=qk0|{DLRO$>cUU$>2x*RWHw4!C&ZzRr9vhZ_(-mk+G+!wwRDPiCA?7<CX
z{Bks<lUuy*4e>_X+?r~F2m(@kD+v4F;2XM`$xvj9VU2bqT|5N?02PTYFeJ><WWNFO
zaujX|4FG-(foNLoS2shFxbyPih<e+F?3>63VaZH~ap|S%2CIqU5c&`+bzjx`^W9Hf
z(+Pw2JVlW{+BqUL!UXw$e&0r-MKz)?@l2j)sq^|7Ubt-`ji1Y1P-xB03X^H|w-Wh{
zRysTg?6Hr$23c1fI<q>jugoSBq><uOoc5Cskn=s~;VlaPrGOorA^+vdT7cIq2A&P;
z5ouX8k5Tzv?I4=1W*-_T-wV2J$>kbwgh9>M;r)o?t4@JyHO~;HWWOinW4gb|lLSOu
z4Uo^$OUcSk<BSD7h`eQAW=w!~O9^Htc-uE6dcB2FTO}IkD7M5vk5c9n&HjZwLgoda
zdNMPMQ8aRL#(mOnu+QBwvkU~PU@|{1(B9|$$K1Z)bKL#>dmj7Ur^Y$Vy=SO>EPKMk
z{<z4se40nMY64-en6^3u2brR;ZF%!?5TPM@zZNkmnV0FSI(!N1K@~$u{V~3q3RLJ)
z8rr+(kHZM9o_fn_UXI)Sh#qk!NQ7O(e+w#Jr6zEL`i$=a*tZ>5x6hESP??i^j2v%<
zX^tkfGEErR2^urkeAQaPz52snQ&gjFU|Zg>1vchhO7A_d8JY(j^@5+RPx7M2N3dkR
z(7MPu34ebtjf8rK47U@QMR!+s-2JS56eZKdSAOzwo2StfuP04jos*0C0|4jNup-4W
z+D%D$QSi{3-C~bb#bfC_{yvPfK`+eq3;d?#V^eb_-u>^__G4V2{ppv<=sr|PUGS)3
z;yU`NjOLNtB%obLQ{|?}i)Jb-BU=jeld<IqrDozG4K*tX5-`iCG%RTA`YB{=Onzni
z5Fi=G&GQZ5Oe`z(m3tKjp?YdZ+1$ZO#ja#*=M55P#o=bRNG|MGz9@5{0GVr5nHbvd
zh}2esKJCV|QxKKV{UobPeQqtjpZ!jC1zd;e1VER~s;wYqBakuQ+Z1}^0f4JO^%kMv
z=$LR2W&iDVz^|t@K!%qwxW9F)*8;_kWW;y{7($9rH-<*iG$MLol|WrvD?|UD!MnIw
zh6&#8eqhTBnKyk2K+2{chM7Td?_YIWefR(M`dRNb#DD*E&Ny&i#b^m0Mir!-nBR4J
za+51m_9WQ1P~!tESIC~;LSF67?*EZ=mH|z^Z{Hs<x<f#^Q>0T;N~G1%Fc6S#_z{lo
zF6ovYF%(chYNUWjNehft5ZMT+u|4}g_ulW#wK&h?_{L|u-s*<@=;kNS>*B2IUQ7gv
zn+n=w`^s1hB-|z3W^vK+B}gJI1k#zX4Z8OCf1)o-?QW>HZSaFRZK(iS4gEZ1nIsC`
z-}dxtl!{d@=XykKF@bPGVPl}yd-)fuwvLcj{_=V9II&ZN)p44GOqz6Z?)|59-fwr%
z<>71+Tyc>?%98yR<~eKxA0~w$S0rD*A5`EEwIu1>>QyIxeA6(n^~`gjl~`@+TKv!Q
zp5Qqck$ON*?RkpCMsa@Jeo7p=a7zG)wsasSUTtcxpwG+BhehVJb4y9%a*U|{v$giA
zWMD|}#@@(8a#v9s$!Zw&=O}d~F=1MWwS+niF{Vu|+;tI9iL?#A7YcFr^|>5Uz&E(k
zz&giP8AIh%N&G0udC|i4*x=cqVHIL!hW{Z>kQ**NM{h4j#sY4aj6{YXzH5SO0;;d3
zhOC;eM*LBceLcB2jB4BQ=){ycnzvNV5v0%j1U#{GT;9?fON{=vt8&u~EkhgUXQ~wh
zy$XjE_i>JdWU5t+1W)T)l<!T$m@;I<MKy81tuUCpPQTT&MRP)noYj_Euy{Ow=JQTm
zKB2z_vJ`exm%-M4`;LM48q02$Pq+6>VtLqV^+-9S9y^_1j3{`)C6{fG8XL+?x=k#e
z*5*~{*PB#@qT+J8CT`<SF~w8hA_q^nt`41I2a~(x??Wo+7~&ZXd1=9$(UG9+hXW-c
zWOlF0CY1j~-l1x`yEc<LBngDRMBvwn)eFmr4`XjHwt{g~iSaV(%<xMM9CsBdEW7zd
z4TnUgi47(3a;af6P(#>Q6W35}gb;}@8(ewc+wHZ%y!QlfJ=0q}J(^JqBS}YH-O9R2
zC=Ol}txYLS$CDo>QzJ`0yQ0Y@z>M@GfEXA_`}x`&NEM|FP+P`Z%AgXck;H;2>w_<c
z6d^nUWUGVB31{CR)=_B(K+Em>!SW^vY$oT`aQ1dFab=;RvM=g1#>f|tXwoS$@9W_B
ziY^SAH<w!Rfejpv3;+N4Ip41&*$qoM+xuaO)GO7DxaQ5OwXj%ZC|!K)tmfjIeDnV;
z)7P15Oe0`DH%J*jQWJV))MB$B{dt$?H{VE*B?x3|zS!?Ulqjp5*Glh8Qr@qM6;HwS
zwb=V_$0K_u!q%W=a*p@d<d&eq<>YqvFYedgY2IG8ee4FlW6xB(G$)iNt2_SUR~N=~
z2^L0*Mt;pw^m%>#)=^`zfWx=0;<#l2L4`aV%_ocaJ*Il%9eJ(rw$;{Q>l+C{Snw{K
z^qoxkV`21Ef*@Fp{Qr(pERtKsjq*#;GZPGsH2)2zn0Uv8X4Wj*%!=Fy7kEZ&)~_B2
zh_{I<TCkJ<cm1*fKQd3z{RIY0GN5w=!I>&)e?r@a1f1yw)8c@xg^xa`lQ1gEryDz8
z-BmKr0u7Oy;wDMzj3Ia-cds0azfeoek`jOXCLgJekNWcNwdgMj3eRvT^EH1|@(+9c
z8j6Ke);}+VvKsD@1I%VlV?{v*#frI?@B}|XygIG47*Y{cJP*ngr5CS4*I;NS0}Yd%
zNAVAVM6m*FTLPz-VrL+bDH_9@veQ)4JcqXVXc(*OU9;N>_1WpY?%C#W%C1U;UV<NP
zP98N-K$_g((JqAyrL()XMUoZr!ep)Pz1V5!R?z$Qoj-p``g8v0f4@QBlYsMkQuo&b
zlc)2AF-O>v;aAwPWmh*z%_^%Ck)v<+|Fp13?F^VZq9;*Qk<OBNi|pV0^BSsp!=mHc
z9nUXI{i=&WUdF{8cdbp^-lnzlhMIctVPiDEMF%Yv&EfXr=EF|3;P{y682K~bqUb(O
z_BJ_9Q-kW8Ax6P!ESU@0+!#;DO3i9xH$JqqCjfIb?9na#w)2G8;7!o+W8(W@uY)bi
zQk?ghfuQBw8m!8E5Bq1MOR_|xGUyerR&u$&hKy+;@F5I3Vsleuv}8{38rx$<33&b`
zZAlF6X=r}d+w3Jfl!<j~sryXBC+WHhOgA=IVT~mWOcI3cH>}UllN!k=i_#E9H4lNC
zelXzEXhdbIr~#f|Mi2Bi@%#-Tow@~hdA}S-W1=Vk-H%y|?v55Hs=x94eEQR4l6c_#
zF9IWywlF5PN(=@V^t$y3OAXic$xdOr$IeRK|26kz{j&0QA?65L>WjKnLte>+_%jdr
z>P^}yC1c3^$<=Y%gp0Z^jdRwoT@>n_qCE5+sj^NKzyBL1N{|7^t<&7Mifh4N4po;{
z$Ga-DK%yvZAcLt~hSse3n^U|Z4DC{Wi`g>><KMtSH(;!9_S)`}2x$-Y09#RgZ5k<#
zMT6X%yuCe(4deIcmPf5xKV3(I7OzSR&fPzrnK+J<zX*}o`@>EFtJHK{eJ<gbBlv*|
zL*BTSmv952{X3qb@IPO1Zt4=uqSavD>*IOAP#5%A;C<~jxl_L9J;*ncVk*?Z;}v%V
zNypzU!giK5*PS}9lXF83Bl3?Y@4h%;Nke<)uid3eIwUIj<(^AeVcD&vl1x|_-FGwV
zC{%6U6UofL6HI=>quNMT)Yl?pvp1cZz}Q_e$3c4%{n)=<HX&l$#6QAIv>1Hd$ts5t
zDF#;EHgp#hq+=(=g?O(NDr3BE&;K%7FybVj_skl%_FNPM*5cgaoOf|vo10hgSH2Qi
z0qhS3yYM#;rl}2Mot6=6AMV&BAH6n(5tLlNwgY0m{k!C`YkeNP4M-9~6nzrOvMZjb
zRk!X^f963Ycqc3t@su{#7?HsIk7!xHOj2$1#u;Dq5I|6|?^qN0qvV)Dtr+<dL5zJl
z8wtA@R?n5A!u<dxu`;n_$HZ?IuUF(KUXBCVSC^c&0a1lp*cUEw4vn2ZI4wLt%ZT@y
z_J8xE7kka&PJs`Ptn={Jpt~u7G!;*_dj;^7D@he8zo>o|?}R)sNmlx(zKFM|ebySO
z<GhUBY!Q!>g|R=%lDD(4<5FeFj{A>fFuN)lo;i+@P}CVOs>gfe6T`{zQ28PfQ4KO0
zQ#N=i(JyWFXAxLa@@t;up8Hz(=+pd<SmNJLLx2^(a4RLYosbA|Qcw_RqU4x_u1ELi
z#kEmJpu4NdGkSWoS{l{koDla>HBttjV|v9)?k(I|@RhgK(Cv}N<7AtktDmo|&_<mt
z5Pqu(7PL`PP9yZ*8qpu;-c}PGRk-_qe<KiH{(DR4^2i@5BRU`R%jrt@TtrTb%&-WA
zd(mVZa1nL6Tl>t_yB^gsefyb<OAa4zH&(x@l|x?;%UTM+PnA$-u-E%T^kr6J@(!^w
zvo2;S!JRuAiHK35H&fSg_$@I>!mz3xQ)TaGL1#dtJ#2po54`pV6^1lgxzHfZ(=z1v
z3B2h3l~OPD+<rN14nd9@-_Ls>`!!p0b95IVY45D2O?a-CBjb4__FhFSUjxv60Usl}
z6FH6C<fjKQ^nO-y+bs%&qm11{kpWwSf(l7pgUS;hEWb9^xy4@_InqTR)GZd<ds1DI
zJRP8Ze~K_Y!pDmPh##NiLTI!Mq+3JiiDP5~evsZ@{*EOHK4CYUn$YS*-{u2JUOp(u
zKffUnR3mzmFytiuijTf@48g@!z1Qz;s9A;B@(zs#d`{K$WyGTy$JZrxh}}x!tlz|c
zIb|4$pS6;j7fGs%G*7Q<lL2aS2qMJ)xJ3?l{E@E*FUTPfJY<ShR?ZZO;YMW%WcWPW
z^N^z6Y7+X-cz?~W)p;HulYC@>UI*{5s&NpR9j^SjiC)F5)vx#46j&O*pTJCOq(mmD
z<iv)DT;Xd3UhWKc62@|n9Lvwa(@jLya)O0Y49<l7w`Y60m4MIdAWB>&{d?ze$31eS
z5K{gl+Brh4HA((Bkz=GF?0fR7pP$Y!ikdsJuWQbP&|0*&whNQjJXv?I9_sI}=uEN+
zCLj(Xv842dJJ2D~aPtWrmWo}pIENikl1<988S{*5M9(5pGpEkQ1+KDQDfcpt{yW|d
zgwFFgaY<yG(i}8aoyAIh&3n^M@f^(@<jARThim4bJ~K|o&@6uW4Ecg=?VOzS81s&d
z`;(pdxN(Y_a*~<x<&V6)=W49W;u&e0{s}#knv%hAwjbkw@6?$sewots(CeO{)@tMF
zAyq@GX>nW=KNu)0=S4eYrsCd&YojfrBYE2^Xw@kyi`2LEVweF_`UJ@m843hrY90jn
z#QZ#ykpW#zv_P0Z|C;_|z{+FMg3pU}@}Rpnk}S*@+_Lr`sC!fgQkImcotOF8@MFyr
zUAd|IR`BqC0$&61jug59M70*$uY=J%MnXMUM1qyF-GVA9+K4VXNvRUV#z}6?f<LO0
zvdFm@WS@}+*}#^lr>#UVm*Ok%d~iv?-_zwfi_a&Bf?)|4s+L_>x8$jJ!gl;TEZqO&
zU`jKX_d{3;XpK^osI4A#1u+GqwVYu6oN)v1-qN=-litgfQvZt)&08V$=H)~bt9ks~
z<azu`$}B)O=02p$G2kwyJ;0OZ@wwP$Us*s)8W_VJ!R_xr3n4Mm`78qxAhvv}eCo?N
zxT<%$JERP-{Zez!d5ZYY*oa_WomOn?W%w4Nr98zKqrP5iZIne@Ii9cCozNm+#}G{o
zeo1DRN+JC{GHMfwCJIis`xp6DZ67GVy^w39DCZmXwCj0(2Oj7Qxeu4*;E!m7NLEfg
zhRf)vdS=Dzqaou#Eg%oZf34(oKtVglKNRov_4}Xyz2;ftKO{%gL9`dc7N4~vdRkiI
z4GI?F>~7kPsMTT(VuyQ|?->JxVWT)4qbeQjQNR`jY#)n-yo#=^eCN7=_HLluvTWBD
zQskFg<MtDpL5qLb0&(GB$GCV-AS297IxJ;xSW*!!98=2TfO*dQ1L>fobTw4m_;sZg
zC9xU(0(6@2{*I{n9&1z5Tx#Y6Ro+oj(+y)vUEk@Qe;k>d8*Ywz05(4}f2M17oho}%
zb@r<HI3AtGn=rT8Rjje=(@HAv+IO(35KJ|(r)T}@_+>rkGFCPinfH9$>s4uZ&vyKG
zNuq@4!i@n!`Z7ZkqBag|E_(@<Y(H^ThGDwhj_(o)(!-Ea{#hr21}frrCvX2j1TS$_
zamf0c0ql-sA?sU*PGlnJd6RcPZK3)rrJO1W$x0zzo?aT6ts9XJN<UOS)C%*gm2&sL
z)rxpQ4(F$0=A?KxK?(MFRl)>>iTO0X5xQ9FNihvJbv>pelH(W#PxmAKr2wDbg)S%w
z?H@&ouecw|z?q_Ah@R<{>oBq20xU*%3s(-q(i>BN*@a?BO}Vz2N%2y{vLf^R>7}3M
zD1mQ0<=?zKz&aGNMUPSU`eJ0zs}|lncXp36a^|aX`X6$Hdt5umVlaX=9HH>csSo)L
zS+0WAU;=2hgbqm4s=0D;F<VbWBOfI*dE@a~pig&QxR+oAb5Hc&>J4WQ)X3yxlX)KY
zr9BYiOL_39>czLTPwVU6Y$kZ-jDCI`n62A^+_W~FIz=$5**(^Xcx#yuq3ABVA`&ta
z!JL}OE9smz*i1ABj{0{TP^hn)UG}yrDP{&(vslNw<kLW!{>JCvbT?xKEj*|cIkj!a
z>f|U(%fzY=469TJ{(SOZL60RmFc~BFaHEn1$F0L&IxLOmOc&oTN&lhmNgvZ*Mm8w4
z0E;>OHoW2{NZ}1!sR6wB8q&$ZLaZuSn)@pxT$1LY+&~P~x3n;~Y=LxHaU5`A3It_&
zzk6Cf7<jc?KY&`pEwm--g77#l&{yBIMj-rr!tMiczsD)+4Aesvcoyp-ZbH=Jk+!6t
zYY7^ovU$@YY0l2DDH&1)B-OUtDMDg82~3EDYJ%axv+99q7I_o-B<fQgwEkh(!SFO`
zgi+Jp$H`bYHIMnPzt(~u<w=)=nm4R6t~26yE}x=|R$j7CVGrVrIA~gK7lR-mbI^1$
zFnFmc#xn;>33Bh6R=CO}!nilxH2Lh{+Acly@j<`z4LL|}+uzwQ%MbtL{Vw(uEbZ(i
zCB1+J=4}*A)hcsR`hj}`2H=p<25A~goo`$^6<_il1rr3ZCD6MHCP;*oB$F=T&`vT>
z(McuR1(}x?_?C#LXwx=}0TLQ<brSML{|J^S_$&kKu#Q|yMKc-+sUp=qqqPX5f35H9
z7fkC#lKflhv_dodw!(oohJ{(4Q6#Y`NXFfH)WBj+q17DiU$+QD5Tr2@xzR-IfisuG
z+=Kz!WYCLLr|7iq&XBMqPj?5imfzo8UDbcFo3_tJCX*03)9lL2b!rM@$In<Lwe3F5
z-5j(1A;gf?m$)^yRjT*w8XJojuRh%I3*-mG6BHDcWUFzGgueRg@5Z_>-*`EApZ801
z6Mc{=mIW>Kvo#O>p{u9(PCYSfHLWe>irdDZl=^>f0Ttu_e7qL#0GpBKy8G&8QkSXC
zZ6V6L=9(Va?@s;wZSp~(_gIi~WjUQn+g-bYkY(e=&fT|ZU4Kh{W#xAG7apw%RS;Or
zjei8Pp;!JGa%sznTe$m?Ct2_Gf(w-SLCbh0Dhr->B`py8OG_RLFQld|bX>@8qV`~P
zZ*<6f(F4Nol$X;25uP&2Y4e=SxBN;f^W>mfku`#~yk1Sp1UmAy0@W|X9G{!;@69-k
zv8M*dPz5e~4sF`;TPan7GR3rd9@TA5!Ezf7t{)f1a=c_Wr%pe6^W40VvS3tX)lH-V
z*<Yl$*d$L+k*YQ`tW;|%S#cbr^jjO3>b+!iGW$JCCZBE~<^HVVrn|Mv{Xgz`t2)y}
zG?Q-0=OhLSBuqSp{e5v|yE&7s`Lj}U2>_vsClXn{a4ZmF2JN(JmC>?r!@eb8W6$#F
zm$*zSWqK~vQ}nR*5?KZU=_F{QX>STI{VbLqsha=m6@1l43_2V=1i6501pDM<8}w7*
zTT*LkLstJyMNTvA7|(5Of1Rzmv^54JEp55c#hQ$!R1*T<FDGnAv~cy3bWT}gKCy-q
zJ@>!YlYf+U;_en81$=b?WOsNejeU))n!>L#Zldrw$bp*j0*j1~fwF$$lStt30mt3e
z^|X?lI0K195lvR#c$5hPDXReH1I!?F$U2$%xNe_(*3i1}S3LVzd@B-xr8wNM^iY8n
zLvm>g5zN+sDof(1X+|f1f6hU)LGA-7<5leVjqRJW%;Uu~F-me2l5d&mISCmvLr)z>
zk(n&cm5QdaM8}uQ6NaL8<eu*T{aKo65KISQOYVcK@|cdn)R$IV@ljSQyW0ILhcq#Z
zoQMSXNp0wL@lp@Yd*ts6DkCLP)Mm=WC8=FAXz0tzAcDzJ<HI_&!pSrdmL<#lL~kC6
ztN1N^Q-g#DNk1a@dg3G*?y>9Y6rX3A^``T`+_NHS9}H=yZMC9!zf|ZmiS?x>92v9y
z`vo_M-H-jUK{w_}i<KR2QooLGWvt5Ub#l3fW;tAr?rFTh2VBIBTql1VY^&YvSXcsI
znn^F7%@mKd^eaJ|-nKaHNFFnhP%&#@xNzL~uUe<XbHh^{G^U7%ddx0<!5S{QRPQ!J
z#9f)e(Fqjv^dca{X2hvrrnfhkX>VDVAqj~eCz&4%DG{MS@Hg}>KP91@4^0`;1gy!d
ze-{i}ONZgVNFaM7+w>V}D%bkGS2X6aZT2)09WvwR_;drgr}2tY&r*lsKG<*omueJ&
zUK`nrE%t56Nk~P~=1VS|CEI!+N<^UtOmHd#pQF7sGqgPS`5G#qmaPE8R%5T;sZyM6
zj!|83eex@`5t(kT!1aits9j#f7|vGXc$Fp@-la;u$CwaM=~m{$p*CB&vY@O6mkk#9
zb9r`YQKmOK&U}{Aggjt<io02Fvel}=DaIwsKA<}I#<n6&zPnb^>~K8f@Ek@(Iy9^l
zXGWrErk5c~o!0_o0vphtp0%D)WI41GoVho`N(Kg*vT=VK(r<kubYF3ua&l&`pW3rG
z!`fmv0s0z=la87>2}@T?77{*uYilLF5m}pV5GaWugC3+1ty>UhT|WLZW~_#&u+jxm
zbfzAS)Q4@W@MUT<?FM}c%8mbZ-ZuEo;+RsC*UHQ{oErE6xk`K^)lYjcrZ43<h*wL)
zNLUq8i11}P0`_sxE&AQ`InmIO$(oK3;R*N-LLPjx5#wBpafzztx~9)y6MgzKB<cF|
z(NaJAQ3uJy;xvgIFMqh&P%vxd7AHuaeQ%mC%a=-q9M#&AWT_A_|7W$hjWBB@D<Dl)
zKRR+462iUn3zZb%q=ra&&WLVGX))ciFTC5|iu>2(7C{c}4Hx)uBc9$!%PGk1G_wEe
zr@-LT^a_f#hed5|N6LHP=0qSc8c#hH5efG`hBkxEN^+JgLmnUY<IHnD0(2}1Rd}&S
zSi4rTCMfQuZ+Z1_A_W`t>b#$K2JLKaYavbFVn%l~$5!B_kU@IY9&Ro_e9k|2`Suxq
z3bVl{3I^<uEZ5O(bJfAGharL!3u_L|pW(_sVwP?CMa)c+A?slFSC_Uuja{X)&k32n
zg@;>QgY_N)3D+n(20V2g&rDhQX3Vbn58gxXk)7_H#GaMTOe|Q8_~>+zeXnd46O3YZ
z#2233Kd|5Dsw-}xO5R*2Zp2b54(szkd}gKwtTB@y6dXQi-|dP4@y@#rL~YEa8Uw=x
z`srI~SbQmbJ<U9k|6UlMeRq@|HOOvch)i${D5-i`E5;jxrERglkeeDdZTIx1c_Jks
z@%G+-(R>?9tMvBGYdvfXMX2R}s|m6<*82o$6S}l&|AUQxU0^1MUN(_@1Wygw2Cwhs
zJh2<#s1eWkHl~K7q`@QMe0d6^nCllfd9!W_3Z371t(3}&s7RCjU6^Xj%Xa<vsHvD1
z@?c)q7GwrXza%+3@|@&<4HPM9=nYBT>1llnCN*mUfytLr+)a)tjiN``Z*F9v%tjx`
z1?7dZ>8{<Q+e>5Wo=b~kGm7Kt)@nMz(~GZra0wj=+-Ch+M^Qw`O{B&BeV1@+Ck;r5
zRj<}@+gmXpN*aKd&dT&+0WAn^t>rj7@YxoDO_x(BHd67RB=HAX?*6TFC_knzk)tQ8
z7e-|2(OnHaJh9Y%!#smKCxViyI#Ei)7!R$?2`exY=okzve?E%*<g)|~{9S>IFko7e
zL02`BFShbKTj^UwKUGtz@-)5Ar41`n?L)$(Nkm90qwFNirK-;T1@`I_<Vu*Cg}Bx=
z35qcmx+&DM=4YqooAb*7!D^qEsS|O0Puz8)b6)&vWbpwnkT4B|jIZUfjU7EQZRVZQ
zGA_WwlNXn7M=6)p_0nH|ZFw_0kAyIpvpFF~PGk3$KGdw)srGR9_IFl!G=}gZOYkEK
zL*6v+zY!ki9<hz=CkbO7ENIxYRqO|5!XJF7*5&FaN5ygNS(=$hl#V(Mcdm{-$XurO
zcgdv0uTn4ICZK*Is~PxSONx1mH!Om_Y&hyZ^h5B7<;uK(%l4EjOC^8WzeJ4S<25(;
zu9r<(l7`vqxhw}mF<m_MO%O&8v&`N=XN{+$$Wza8`u*1VCMvb9R@Fd~*;)5a`}8<o
zL<mlIMcQ(RaTI7&j%y4e!o}raNK*-?XgnSp*GC;RoLj&pV6z3AzJB6zf8RL>>xbJ+
z_?3b)WPE>07>E!cxbvH_uMXi6%>kWcJ<YS&RxsfLj9NY6OlNU)`VeH*gvdFCUyZC}
z?sbA7J!bU*vt>&IeqfSw(0^hl5JSH{(@PBlnW@O%^>xJu^~Q*TPmTNoBTJiWo!cn}
zE0P~JWk4su$zldY!2x8NH%$3Em+T~u0=1h7erR)8KY4?QduJynd%kGWQpdtbZqhky
z2Eu>(<NAnt+s<9gG+|-&Xwb`o^6snbr(!#{y^#X6$_lpWr!fK=qrv>=dG(8~PwnQ9
z8`0bn4)3aQAr?uTa?}KVNq%?{a&C;xcmKG|7s>F?PT=FWgvO=dnPovKh6pdS?yyE4
zfkpF?W2;5>(QR!2*MM+`IJTk!^F+<3#RW8UCox1GUxxTE3eSFx@ns6r7fk{TXQ@^-
zBejVNJ~Kh0kUj5XalE#(`m|gQ(m%=&qm8^+M204ZEZIzq@SS2%W`dM6rMu^%qB|HP
z{X|Rz-O=oK1F9mjEZ#bP;alct<oD*ad>qWWb?n&lY0pTwm7SrPgkYk}92U(PDVHog
zH5A5Y*jl0n;WlGmvx1%$G)fPJTUnuVJ}d(-TRgo|Uv8hMFGS3DQ5)<KzswL-#3Fj;
z@zu9nSH%4;gW>!+e_QpW`vpJ2x-yPI$^3^lm`Iu~Tn=;kyTDUqJDjfHE31ABNh(Jx
zqkzig94`F^>ZlU@M{j}`je#X%&#{C->poI{u5gBB(sJTPx1$9D<YDIf2mKjitU;S3
ze?Csk#3-XsV0w_3%hPurFbI8sa@|r!Kly;%O~`j}oaBe<%V%MSANrL_JU~ZKqpP=j
z(|LllzAbe$gTCZ^!-2$zoX%yq^P?{>olZnKf&MJN1vr8K5bUCX8|Oh_V7M7r6~{=s
zO({XdLO;6qK-2!gV~YA@nI?i(I(ZV3M?_5qOd+)H8<{y7>2J1$@4eh_M7kB*jZvXR
z#>%h$%rv20GG2Eq2DPXqh!j^p(Sds`eOr7Hf;F!)I&Tdc5dx%bZ1|l*OLC3Yp6uMY
z;MAq#GlzP+fyB2G(+f8weEjOe^5Wx)42%_|U4VFO(@7+j^EAQ-QBZtYGY&VLlkF%W
z7Tm$X)`VnRBFNnTh#1NmUaN8zKJ(w9u9Sqw>fuXXMJ*4XjsBVwHmAIC4Im*sg}+G%
zkDg~a>0Cuz7qhzt$`tTlJtYN=PK#%3<xOu#OFzEFIa&ldA;m4oyr9L9M9?&xs*|e}
zLNig8ibw_N48z&qU9AQD^%l1}su{sIbYGq@zqj6l!%h#Hgg%pY4KhTcsBcxpX&b(i
z-IY*bZR<s2)~&4#1?<R_IzM%mf&7#UzirKyy;f@lO_wZBadGLyw5Roghl&enT$Rfq
zl>*e$)cxd*%-%W=$`XdBdUE<nPox~V968w={u=asm9$XdoqdTfFmHSBf!*K1DRP7i
z0G`jmL0b<`u{*e_=(&*~v_+^KhSck6^Mx=hMe{00tiEW21Z+R9;fv*cfGp7K)I`&V
zN;r^pD$e`l6y9#%U4lt1Rn0zDq9fvd1dGZVg^?P7(EPR>&vB?S!RDzs3g>EA$_505
zEN}GR_y1RX^&>586uIGMKOtqSco4RaGfsgzA1-7f3apyP<T$*n!2BNJ{>dy&xcMYb
z;bjUd*c?*4h+C(EK;G{Bm|8bQS&*(kcXtmCxnVVb<I$*4%<k#xzP1N#u4Z~c@d|26
z_Uq{+w;4Bx0&FDflk{rnHK}Q-U1!T{hC&ABo=isQ>f)rB**r4O+-lb0#iUc6f01y-
zzgC`3C`JkwWyc-b4Nu#=xmhNT<e~sXK`Fhn&l&RocqWYnAi(=~g!u^OQB?{)ULVb*
z^%<Z!auXUL<6`$8`PCj3m84zUxbt@gK8K`VO}@dOuggY9!}O3#u--ccSO-#>n!M&f
zxgzpVx&L!>82lu(9H)5A?BktqtR54;JHJux*F255*;9_*$I-O5!p=hhp_{>Fd&=ct
z;X`W6<EXIV<+l#U<y{=>%K+S4sBHi$l`1gX<G1Re)K9)sehCX@n{Fxj&wt&T;CrZg
zI3iR%G_hbZlwkT0Klc$G&v9r&mKA(b4M+C^gec0=?nRp(uY9+&y+9p~eST(ADOw-x
z7MSPMuH?exQT12qRqKRp-q%UnKYemt?sfRW>XiyH90l=Km9be_=%@?ps~d`!u2R2*
zg63bw(vpyf@&iZqcx0m9{*;OW;9nn^9<x(1dY1uM^r$jOma0eu`)wZ00s_b$=*9d3
z{DSk)RllI8vmsU@{>`g3iznf>OQ;@yyB$V(8h)u-ZN2WPiwUeaS)4fcJ--OKRkr;z
ztV?#W5?|#2SMU}7J<M{rB{btQ&doB(%Ky9K(BF;wozT2!m<U0Rb*`nJhPp{*e)ozU
zb;51$7c#v^4Q{&=X7vktlkM8SzTka-`=%x3MP8dznDXxHwT0U+<m4|Z|Hak!RsIFP
zx)*P<3^XgDR_R!?ta~fpMsK0*-0h;mxt)hc{oAxwt)Dr`Tem)TV6tic&8VzTzVNU2
zRbDG@R;T<*<h43ekeEQRkI7^lKbEYG1u{(f$o>RvX`IxQ6<f}_9BR(8`_=!>QTDh9
zsYVdKX<wt`%s#R8o2{=5EM0w;;}3lC?e~_k-S^$#@l@H3zt&zRtSv$uQ?*%zW}ibs
z0gW){=LfG+H({ju3VkY)a2AQ_UKJc$ZC?{3`jTk-*NnM{P0PWdh?t#l;mQx`uK8)V
zau0?qz9i9EKzi7DRG9Ens^-Pu=Li!U1MNO~mg{Z1lVFNl+1*hu`3VnE(ai{}HHlBH
zcJbQ|#Y0a?Dfdepr5cwe@>*2^0L^NR;z4&hK^qFm2Mho*Ga&#&3V={qIC`mA`k~~z
zzfz8BD3*{Y6CNSFWB@+RHv;*J9f(h}5lU4Mv;p$#SrSY>K&@5)17|((W%2zEeyomN
zXRESRnojhEE9IwtAxP&<;EiD+uy;u#_U(Q=tF<fLxnZ7e-c7$$d+>MvZ^qTq;*xla
zxp+xIPdy0EPo_ZBLCiGts_`++HJ`r9_=vfbR#qOtLNuw;qTdAp&?g#`RjGEVEypEl
zNB<#9$pmm%aS1&dpURc?4;?6(K-+chXZFAlDNxy9pZuP?7LOcg6Km6Jh%q(N)G4K=
z9#@|%<XZ`_FeJ<^ly7|$PJm+Idk#NB9b_1hDm769gP4966z87yc~+1<pAacukZa1F
znyoD<f%Z4PRAmc6o6Grd6HoC_)$Pw`!%Bj4Gb_1297I{;ol=lbS@m101IlC=BmPG2
z0H-E&Cd6ZuKW;!a!3XuQq^$H?SWZf=KkA?EcUbDqur<N@Z78<aoOIdJh(U)bU;A0)
z&#Mj%1-eePo`*Zf9WQMSN8A_91%V(>PwvI&C)9i`dk53S`-Q&mo~DkV5CO@M)9EEJ
zfBuug43f?!7z|7+G&YfoV<H%qGZ(Za2akG^!&OXw;lqu)AR9k?`2RzHT1M(M0$l}h
zl54AH-=k8na`({?_l8!mt@wXEH@M>07%^*|@x{Tck|-kGqy7pE79+XIJB2?ycJ4pE
zcQB!FwCwyym@mm(-ZN!lNNMHRSt7as@~#-29l4*LNZ?H)b<+`aWy=krJ=3!@!qF<F
zv71i*#1lhdQ;vYU`MbOf`53Y6-;@<V<*LOXe{)Y=F*-~q>MhL61?Q95TMrVXU6lDZ
zF=cB!WbTo}vJ=p)>?oeJ-+x>JeJ6lO)jZ6^?kF4cTfXnN7Uua{s+$HNS{IMGGvGg|
z85lZW>DO1HjC<KHFxDIL<u{}Y_1Xb8y~y2LRICnAI?963uADQ4?S1yPqpPuB-{nt;
z-F|EZ+g3G4eO)0R+1ZGTa*62fsZ$V#VbA_+wK`(lrfQ8YR}z_IFx|vrj3Nx@Ad<tW
z&)*G;8%By~3SEXOw$$J4|LEPMb9rU6j?cpALlo+&>@q+ymP(253Q&GeboB&d^w!OP
z&jEi+)`V^gxbe(UBF&Y|0Ubnp*7BQ+j3B+Q)qP+un_#?i$`<yhsFX%Dr7iJKrB!i&
zUNC5S+OkoQNg_Vifj4ia`Qa{gzzgBz`O~C>{`Bzq`O+fAn(sHwm*+mdFu7bW&RjQG
z)6|5s*8EO;;`axY+_RonSFALglDz)9bTY!ra*Jq&UFR%>^-nlK_2sN5vyo31#IUq~
z@;PM1nW`3VLg8uG@gKW@TnA(RtqHI|XoUDMGO;U_c%p8AM9+{|F_pvM-Sci4x_6rU
zXWD*Yi=fq;(4-6sC#KZi4U2?p-qy}5Yd^NUS`;g2Ei$auF`#XZtq}HbIur0=2rvGi
zwIJ?`ds)x6qN%65GJYszQxqlJ;)*$Jp71DXoAQZKF&l<c=IFzU^P2Y8xp9_v++vb6
zRQkPDzk6sAvfT0c#RKbuZ_n&?rl&yn*4yl!|K+=e?bN8IC)%6oAGBaxXK73;vwHyq
z=H*z!L`uG^y`}!+rv3Z}{Rb}{I=;-i!6?^+B<x8m71Ruw2lIA%nmlV1_jhYfklMR3
z$-)$I7si+?)X#Enwu8Ny0`(+xZ>K~Q%J@uY))zFf$UkK5vTiL$bkpEBw&9Or^eBMZ
z-AVHZ`ZW~L?<g2e02OG!I!!GQP){4r^X~wvu4xYmdxvXrTnApLW)z#Zc~0HKHnsnr
z)Od@?p)QNk{he{M_kWGjkqPH`{964qZKoU~V4$sKmpD-Q>jNCs(P>b_RTq`dJ#U!l
zY(kz;Ib`!7gp0j)#ZVo{*mR2v^C+q%72x({W;w2@oU9wQ_g3CUvtJH&x_k<>)^I4h
z+?*(90c4zS`6uXrAbS9sc2y@;RXkT(n%hQkDp|bLVP<MNGrwZW?VQZ{uhPRpvC3sq
zN3M~!W_lMEq^7T{CmGSd>z3|hgFKPxq0o5VL}$;z1)7SS1*>CoxVhP{LdiiPdcKW>
z;Za)-dnFb*yel@Uh<+;<D(Yylh-PK}arNU$9<LjBlXqo)Ecr)Pqrut5%-==ZEv0Qh
zFAx4)PKTp)*7=+<EVz*?PX=W0!3P3Xh{{&szjWVLF(I_7OAfN{hEmPmTX5!jMRY<w
z6;DhzMap(IWQb=h16;@jEANlZr_HdBa@NAFcZ8bW^z1hy05j7I9wR|kD`-%1oQZ~&
zK}Ph)Ht}B(zet{l!mhjDg)QT3g(Qow(H*k)cGu+%H|2K6)<>w`LYPfni~khiR>Xfd
zB4rB8*4pQ09|L^+Ad4-*=2H`E9@9q9>%OQGHo?=xDf@R>%a-O$alH|6WY!B3^1a2b
zj7tgmA?}KP{hL3Lf;=Ai4iwdm{YdFDvjI56^@6^~PM}=2{+GRy`u-;!@?wmDQYU45
z;+rOL%I?lo%0K!+pz*z30e0*fd$u3C2oBb_VF-FfndaPj2v@czw2-XQpiDVk-iUP@
zh?80VR6_N~Bd$d@SLx^+B^ep)#IWDzc+*tXZ^gIJDn4=k-1~+|Q=UaM^-EZb-bNRd
z{fF)b%6GZpH(vfAGw<Kxh)-){gm9C|`|k|C0HS`Dcdk*BtPorv6s}XlOBJhJ)wP3X
zLu^ami$79Ku6)>Y^;KjYQ^kt4e)m+ERMeisa<=Sd1qtAJ!)QU=N@gAsL83)|MQ;*=
z>K;%0xT2-rKQOWC$!PP7$>uYS-M~n=yd0N$KfsCUynbNg4bc}s)FdUCDpJ~)Xh8B>
zU?hpeQD%%3|J(dxbfpxC_x>VA{?emabi9u*OZym1pT*{RF^=eMm&DnCit}5%3{jE?
z8$6bGaP!K#r_^<Z*yZqzb2DB&1)lHu!EJ*4H8iv1HyurTxl0VEVXe=rwpFb{2MVU{
zC$J@tUxzkO$`Ej={d9tEZ_9(xge4jgcIVFGL9l7))Wn;Ft?3NO<0i1&JcWIiwjTsf
z<Mr!C&L~&^8aMGE`MX)*&{y6@(Lt8!Ouge5frydh#|M1sE2L`Dch`%S@JBKQGQ#D2
zB=5N-<C)i0HVM}_lg5pYrSNK&qYy&mMj?Sn&d*zepE}g8hK1p1Zd$dfK#8>QV&L0~
zQl&E~uVP9*G&M;Qux+xh!SwLtDfOUWDoQK0!o~TnoH<{B_ta4Yld79c!(&C1rR=cd
zQne9DaVW_{jMS(Wu6y$wSRVD|z}!dwG?_-)1s~vaG7(#<8Ld@TNEp@hONxyr{SbyC
zX0BGu4j#X_SBxRu6P;2A_ANwdmG6*V5!owg>9zFsM+;C|@I6kUs<OMKHb{%r!4Yni
zC`(8#xb^@JWArcWBP@+2*6_>-;<iPf44e2;;_S|Qr<{+z9PFE-6lMwYv_C%bR1=rv
zx1nE~mVUn=e3hHDG%fUNuZraFQr*Es%?2vq#M~_I$_;gY)HyAq7%KB-Ey9b>F+$Bh
zf;VGaCqtai-?9f$Vg2M;w&az?Y*Cc+{!x06$F{<a!<~Vs_D<6);=q1!H#~++KzaS3
z56J}{K>EMzB6$oq;2~2E1oLb#tc`V_m8F!O5@gR&bKdwo6q}S3rShA9_RZ?aBa6YZ
zm@;vdA8F`Yz~K4c>3?tx&*6oh=3g=(3K#Ka=?fjG%>J3S;BoUy@}JRmVP92~|0D~b
z^ZP>&E0~eJN!0c0NAr_?`<-^6<4&}<Rd<LZa-7JA%+2cp5K%wF*K}6&c!%c(524n}
zrFQ8v{(MXC^OHlXWSVERF4Y(5dMHF_0FI48Xk8;5rL0m%mYDqn7{SGEU_5RWr|S8c
z85;UN6$^bSyTK(IEf~XdW(EL?6DClV{h|Q;Ld4!1-IqR#E<H=@x<H0m5wg9Sy`I4z
zq}cH&x;*Dr`@84aQ5?YxV3{G|Jo>MSbV;FcU~zPBk*Z6eeLRMyYee<5xF@%V9bckn
zr(>U4Sl6CYu2|DajlXG&FEd8tgQ~5Q@LxYI5B7-`6Bj&=Ta|mvy*WKU*w&nMG1R&u
z=8<_vB>iG`^(xigV#Tzrxy-K9gUUBM&3iyzO0uud*^#aG05T*~mA7wH(9epg@w3PW
z2es#B&8&N<D2<y(r-CG31!R=j1b~CwqQ0XQzo<5%B(M#d_wzFSj3neEu3FTp2)=L@
z8^N%sf6T0(q8#+Dpm8dZT~6wbA1UG3BK+*jGuQ%q7_QC6m~fC!3Oq<%+ZPFDRMygY
zicrI9ANsQL1)~@ogdP?3z1PWHMr$#>btz^=YS5A@_O~wByxuzA;%}&_VWy@Bc1URT
zgudqeHGpr{u3~pz%0&ZIiz5mfp=1+BNsOq*FvPdJ^>9*ko3LPJ*O#Z@@=I)r%gHo`
zp5Ayuq5?;pkFm(8J8xd91y>D$zXyaxQ?5SAlZ2~UKuB9u-<zil;n?I)_IMUR0(Dy!
zF2FU)9>mYciATH%+^AQq{fA-=e*%{MF0prjqlY-)eHZnfQ>?bX9{e(18aX8?vqBRz
zWi`Z>Gh7n)xzqhUVb2d2fl1kd<f2S7eUd93);tVyu-}UIhx2|5EU8GWV>qehZ45;(
z&F*pvfcjmppc|fUvb?2&aqcy~&&9CXc*fCm8lAjalHkg|9W63)@Tu);A98MhAo#0V
zn1br*?G9R@!hUs4r(n>I6!IUJD+MsIr~`^9ecS2P{*MxS!y`W46NzifZVhV1t@{D7
z;0jx=FfRJP>3yWEbDVHk9lJ9&5eu*mEM&SO5Vb-*>~C86N&Kn9{_T$vbf7<{vy*)P
zkH8_959ofp8S769^{-_skWtvtz|XhWFM@TsXF|IGz$yRjK{++Uc`vp5FPE@n8ZuOU
zOr)lD+dnRE#tOQp5Z=vOF`aZCG}1cOy*zvR^m0zaw|nko9tGyaPZ60B^O}>1`RQn%
zD`nenwb5Txs!ER0b;J=?giDcAZ(L3boO12xw&^K%#`J|a&z!L--<jJz$16Riu;*6w
z;#M;~dndA|??T6Yb*E3r(l3)NK7;`}bRU#TxPt*GWiTfdfrhO9-cdr=<E4+D?M+8m
zfv^Y<OXqD7e8n|Z!=Pycfd1q_ZWPOz{p>pb%QxuFCjuV<cXvs{YJc##O^bf(Zec1_
zvy{;9d*zP_sIE_enFL(gB32ee2a9V1M50Y2x+5Ht=EpQx);l$(Q9IngM~jdsx`SoT
zwXuCJ28f`sj=QNz6h=S_xK2RDpzSW`b)WeeFN=&3`WX%Z@x`zO76E;Y?XEOG{f7bg
z@esK?OoR~u&a4eR()~@b=-&2O;z8p0xWWk$`|*K8$itHE3+zT95SX{bd&~bLYb(Go
z`#sC!k^OHXtXa4FM>U7AbnJ0S$+D~yjgdsZVRTVmrtFYXeO=xcQ^?w)|IfSl9f^9<
zOF0S{^<N1f)#MCZF6slEXrXZbO2ssSRB>~|TuzBQpL%-tH*o*+yWmm%SIRShruX*v
z058jqqM$^~n+1_l+;al7FPQ*Fw;pLHg)^)Si%02B^3@j&G)P=H@8~P#!J?vu8@MTm
zC4Nxb^S7j5^srz_6}-k{Y}HGUoVzl~(SW|ltU^aDmXvM1OY7MmUp0F*Zdd9J-vfMX
zax4kC#|a*$JN)-PVQ;#GsFCFG9N=F#7qvMA(u8{dkv<YbC{TRnR&lMRp=Ob5S{-@%
zeUOcZi<|uIF>`orH%Z-(+2Po;$_(>35#Par%u(S!`Piv;bLP8iZ_u6d)M0&p)0L9e
z!iy`bi7h=Ct?OW{2OD8eZ_yJWQa>dqS<=@vt@|_2QbEwp?Otw(x~|QlZP}pu#{BKJ
z_+!63WSQ#YrntM-<t{&%Y8Q7Fj@ZK+-B*vuNaW#YN<A_eY?t^iS_Gc}0b@?mm^ESv
zv6oSH@{7dv>CW*Db?0VXL%PWs9wYG};jec!cVBt^1#rl?zWkP4Xub<KCWVk{0K!Wv
z8>-+JmA6$q`rpy;M8Kow1G3?yTYGhpyHoVZy$vry`$C}rj}h{*lBbW#-Oq%XFO-{b
zlSGpWF9SwWjQH=}YBYyGL!1_v&@|;lM(v0~>{HhD&Ph`}cP*;vHglv`|Gx|x-5bv0
zj#t}+*aDPvL(sqkGU6;VfjbDz!{tJvA;Ir<z{csKj<8(d((3R6{z={J1x%m+`*Fqa
z<dZ3*<e#S`b8jV7lp<5w@?v$F;|G~?so;snNwZoWf2Di2-`^;~a^3L7l=-JoF~hT;
zm*E_rydcGbPU3y$2S?i(w&1;`Dpl72bDIZep_0COBDPFmnKlm_8q{0JA`Je>p@&_D
z)SrkTas1cAF*!-=!PJFbrL95*yJNvHj6Pl#hspR=U%hXVI={Z-2-mF1Q`8t9YZsX}
z-AGI%9`7;-sYS`t$P_#IV|(hG*`~y|m5|e)fbdASeXLRhI)@Wezx$g{RROml-Q{_+
zT3!?)^66skt}3~2;TA?=2sym+I2(^z>3zB;n$Y?~_0Q;?5vT5V+=I!^YqG$0Ja_>q
z;p718c1a{f)emX`l0&|oWo5+_@$tB5s$^adk&T#2+|iv$MB1mUaO}M$pou?VPD-}S
z3i}8zq5PH1TohRPs&KFm<geqVd%xus%uN_l&`;821Lp5dG9EdXbSz2^(Kj+GmP541
z7;H~|Kx#`$GpENTd5Mep=LiB-1a7<1Hq)bwUT2E?wQ+H7(?m@^8ynMMjPdcVqcLkK
zBfVFUE2>Q=(Ot(2kC)RKEK~>fzdILPk0ojR?DCs5(&a88__ltl1P;+_GrYRn^U5q%
z7K>uQ?4)UL015<%HN3FTH4&bicdAMzQoTmBB_yv^X-Sw8`*L&BH>cq?K!>HMt>!y}
z3A&D`{+-|Q*79&iDGxqUl+RyU8q!^^nAcid5t{?ld?@aYDIb)gE)uZt`|E;<nyf#O
zIeiN#Xxd1tb6U%9rvzteH3pT4B1?Ta5n<W_QL<-#aQJQSPnu(^)=qNrrK$*$hRm1C
z_Q=?U#%}lVn<s*2dbr`hqm`tpt1UwwFYK<;xfUkK%tUY#5;lx`5Q5(w#S{P$@%k@)
zCUvnX+kme{c85`c%;ja`C*O1biy?f(kfw}<<J4-V@kONvw-brnLGLRCLmY>gGii5J
z`M5-9&JW`x$%nWpo=?S43Gkfu*yuopxXF`e%k7K^1Ia}4eR}C#x9Km4(EYqfcIVqP
zI$-V&Q=Arl59O@5nbTo?vJ^fMQht$*OCq8Rz(#ah9Qt9!BSx6_&9YX|@!l8K>4}4a
zo&#@@Pesq%Ay-yI=#IHgWI+k>n%f!?iGsk1%y4!@|Mlz~`q>K-vwsZ@OoKGM>-;Nk
z{tA6lFLe3Eoca7K-Q|Z(YP3ZKB1gJ|xq<3)AThd>UUe7lHB9`!NY{;T+O-h!sp#13
z<EbHK9xlOgjY(xs&daIcyk=d_^o@0}$=oj9pcjBBc$*eb-u(FNr3A^UjokiBKNzo4
zf`MjsxH+Ed3UL2++t!(>Fvh-v@@3E6{)x~gNoe~6UsJ)e@Z|20{jE_G_b$W<=5g&V
z?y~}MPFE-!MRd{*1^7%(u^#kTY<hIwez1MJb13<-G%K|51V7aKiLX6$N9og~f7J+$
zF|EChQl;Dlca{PHKFXib-tmt;Db3HfG(d=6dD6EX4SABIZ<t>|5sNUXlj{fr1xaxU
zVP!VvyfK$8amXo3;VGQXF*b=NjnPgcP|0#c6(`$d#%V!H-A~Vk=j;P(JzNfsu=HaZ
zSHltn531I<L$tW$h?zc%C@0yrCZ-v6uG^=ZxhBrcL@`9Dr*CE<QltI9rVkU7%NxZX
zTU;B6&5$nsp2Mn;o@T^|-1)vPRrx*P4=e(OVT&Dd-+Lf`!jq6?Z1Mw)=?{f5o@zoH
zYJ?UyL0jyJ#XutYX)~*xi)CmEBGc$x6?S%Ps;u=bj7sT{KpeOTvV^^6Kz!`cw^~~8
zfAauVJZPHGrJGYnd;fKH-G<Jr4@^I<xo=?BfdADWaGhP+Cm3Ux`_DPfk}z)3+U}%Z
zDI_@!`^f!6$TKneOob9jXmf}N%W;ik@(l42hR;0SB!qNQRuXx6m*T93>sG`>jEP?;
zl#C4Vh<`~>V{X?^CPNZQZ&gtX|2Rp~P{e~d95?D8%=siT2)NQ?vIvK9U&+X;J93nG
zvfDl{VCc#OyEC;@1^w%dxRhq6(XOaa8{#2+)4{8VUn&2#QvPPRxTt8F?+Wi4KirKA
zt;P{n@GSLm#tgMPetTlW?C(r0AkaQIiIo83i|bCFq6aQ%>C^T~p8TE1xN~SeC3192
znm@x`sO_vp%T>D}3}>AlFX(5q*v#Sl(4(HoZdvGFKIc+DOptPgt*rsIZ!mxb&gEcN
zcqD$PnadR2+qZgYeolUQJTXJIi+(b@`6!S&3^6R>*H9!`=_RXaw1wdc$_G?Dd>@EZ
z2sP1qC9@oQ`cB~|sP=>|92o-eWS0%8JI!Ja1TaSx$ys=ZiJk1|I@gsEZO`#gBdPD{
zeqe%Uw$-o;3x<SxSezT9a7&fT_Tsx%<ko)u+hZC*IImU!A(bBSL~+-DIk5OMIMLw0
zr3SwUgX!buTQ;{}Unk<U7y)`ShB=WZy+U_KaV`T(;^p<mDiPg5A6l(KMGw}!)MRVX
zB}88XT|=v%GC^a!N!AEFVCaF<;>e%e$=kwvpLkrZSUe6KM{oFYZGM)(M$V^{1IRJ0
zhv;5GxzLCRQjzHSccncoLGF78arfgo6>cayndhka!;w{+l-RaL$sk9vy+kaMaXKE+
zKg`ak>2ynn&;B4%<B@@rZ^4bkSAlPz&mt`p{`=`(zQ1x+HKn$rwOuhW4!m<{jzY33
zYasbv%TZ4)s6FDLO&L;V^W$s$zyzoG)nT3+<F4mFUcmh>Tj;@M^x3i*mr*^j^$>T5
z-?7o*pfkwL?%X=D6p3l4c(A+8yq4Lr$l3Z_v&xx}^NW@$ti1h4<Nz&gt5vJFUA>Gq
zE+_AA%kGMuvYMXg8@Y5->h#rnZwG#n@@480&f!0PdGUV3ng*uSd~BoWE_2v0LI1)8
z(|siOcGdWr2U=-%Bj5sp3k0TiA$9eBh4nM_MaM<XMdRUderq{*ta@wz)U11x@i$sZ
z;NeRZml%vquNs{v)2*2H4n)%W0=#3l12JIq0=}<&#uX8DbxUf&5tBijARc9bPrkLo
zty<7PA{Sa_!9mdaVv9<MNZfV~dwS8NFEW20AYt9$Qh@D7nT1{J@V;Rf(iP}UxQ&Z$
zd2Romz+F?8zyEOozSUgq%yDvwL<rp{B4j#7fGp(OI2D4u84?*|S%BXT2Oyu+MFsAQ
zVHI>9#MU!>cvY<OQd>n(Rb<wVHo>paHk{Wd&Y_EkRy4w1qM21k<q~ETNwU#`OcPFc
z2DCgI!}r5&Pvz&g!`VV53J@tuKVTlGLlPiAE_OqGf3f8!NyII68pm!~VQY@90#68w
zEtB7|%04O(I{-_er74y=sT!*nV2lF=+Ce{kIf#D={PBtW`0+*oGe6f)t5zq#X>Tov
zB>sN@<v<$0Sb(MhZaKH!2<NOJS{w_}ypVpf$QBxE5EGCqS$EW2Fn}dbp0lHxpX$<g
zq9HdTFFj>qRz3A;IkQ(cE?vfQ`T4uMSe|OuCxR|mS@KnN)}%Y)JpFK=R7$^=wfIJ;
z8pu3zJ*0y8N}WAAn~R*`QBd*=3^aJH5iR!5jesW-AZ&a$$KqO<Cxiq|39?egOlW6i
z5&)7kJo|?@KpNq_xgR`2)d@h6<NMy|{w??Lh^#pyXcBpm-UH@s;JZ8I;cqOVK7|Y$
z_x&-UA;kPl)(jFhF)#`}jW%cyd=>KF2?~N~$pVeNZB|b-<#0vth{5VVaEOsUJ`MXK
z*@6NaTLn0=A>0VBi0H(7sDIOe-Q%`wkN=Cqj^*)EhmEDb&^>W{0EfQ*zej36KpVQz
zYd(&EV16zRMOIiIzFKm<q2Pdayb@posc+~auXtoAf{gx(ng6eHo)B>#`X4QO9Y2QN
zwf$@U{S^`ozxRK==V++C@J%<H&F1&c|5r)Gz}d-|+ew)DhA{0iffEP<NEMx|&Hi(G
z;-Pxg3WoJg->I-2bVn=}014E?o>RcRUNYH}U?v6x#%NGvGoSE@E2@E|;<~fiRn1(?
zpOVT|5j?zWTxJn0`NEuj()nXeWa{_A`$NP2g=qY!#?OEKT=*m8p~g6T^;5v9e-YJz
z1TGYR|L`U=VTr<4&{7|6(ht?X2s9{t5`tmj<QWHQX;7|>Thx#7A_Z6l5Cp7m<c<&#
zfUY392t+ev3?WD&E2n>iO&+Ei1yzY=yYY1s3|J2u2Pwh<XjWbO!HsjnFiO(#G#y5G
z4*4QBKjF+GaO#<Zg1KMgh>H+1=Y-@rMh&dHlRpK}N;knHdd@l_4SLqV0z1F<&u;Ub
zY<lxZ)JQ~Bz^Lei#G_0K{dh%GZh}$1ckuye2XRLw=1`hr3iBoACT;@0e!fS@`r-N{
zbpmt2LU{pJU_YlgJWS3Y9gqHp0vwn6O^5Vv=Ks$NGm(c}0$*`E{QG`7v}8Trf203|
zznnOr220Y%SNrRIeg6bsTG9*aSsJgmqrDyMd)L_PdEe^kJJ)VZAS+|^ufwCHur-81
zJOVNv5pTy@6kwzaBS@tvKi^UWiNRO`5C~!?O=a+S1R*gc<zpmX#XJ80`oLS{lp$Ol
z3-#77o}?HfWEOw=)V%i0GA#f1C*pdve>X3GS3*6>jIkYAefM|8Zi>qPSiWwi3<TV^
z$S*_pKs&qQy0qH<5XOOxC<C#W?r7N*00ZEbykGgm3N9H#s)LCTH$@Qy1gw;m2?NN=
zvXV)N129F>bt(u81pyQ6@|jP5N~i(FK(I}<n)%=1Hv!TkO!b#A;;WyB6<ouLu4Kdp
zv%Vj7tM@T83xZ5HTcWJ%#0Bbt1loo>N(pT>_~pp#!ifbUra`-<?7|nr?<lym$Tve&
zr0@8D7-BT}e}FxXX1o$3HQ?rq6!;B&%n#lpE7KhK(qrx>BjBC+9pE798^ip6j;hg!
zJRm*?Yv=iK3wgLmX7zaZ<9w#h79wB4Wu@Dl=<jEI@AY(@@~<Zqgbq&#K;&IhAmLBb
zAh=Viel7{)!62$k(NH*qDibhq2<A+|#1Y7u^>BxF?uvWwhVkSD3=IdCY7j=h_v3S3
z8RLX-nw}*Y^}{r-t1!s3{qc2R(ID}$Cs8?XI}>wiza<^Cey#Oyx~?~f(w|4P|B{<@
z{7)`gr3><1^~)FQf;ubl0`TTNCtf+;&({SVRS~GmsW>N(00=ndQx$zM4FH40j9fe|
zakImqLczrT3r7m)fHjYDEO?+I#66+sXMP)S123Jl`sV(J@ETvWFyLR@*ZY$adi=~x
z!r-4{F@hhCA@>j>u_1XgRi;*L@CO%jORrypvl2mKLipt~0QHhQfW1_ZE$|P&EG1*h
z-GlqTC+xK^;aQIqr2yg7M3_2}h^D3S_mho(G`WYN4&o)?F+S;z{nQ?mV&91p9f@9s
z^##v7pa4Pd0kdUS0UuW#j50Cr#qsn_&*2z)OtSgNEKFe5OhZ>%#xQVJB4hq$DxnZk
zOfsfardixEOr8F&u1+%htKS)TG>6=F&cFaIu3j}wV8oax6zZRl9i+X1Rv_De3!4^o
zOC>+&zeEB@>9-5V$60a^76|tQXQE>^*?9K8ZmfOE28=&7%X=@YUk+1yB_dieqtA&D
zN{i+0=jEbYUnglHom{?J*#5bIzFlkJin$0eS66&JNdcsIpy`}I0Sb9B<{<+f03pvU
zF^2$nF29QOng?On;hhzYH^FFY8Bf70WApcJXionI0et~95jREkld!e>%E35u9|Q+$
z@MB-!f;*#LD>VNmX~Vqj-X!#g)^!!aSzUo+Sr7WI0I%sVGw29&hLY`qSdip?F9N&q
zv5?9<NPtBd5q|$K9X0@hK9x8Bt}eaA!rs6-cs*fECuV6mKOhcUuCUYl<U&8H0Pz1b
zE1&RyoP5OTkYmdZneupnC7+Skt`P+Kc`Q*R{sP`t%ipk(y%>-H3z%)d1U|d&|Nr0@
z@@6WIXZrrni4q92efXF|f*+1k1uJ9U9t8i+|1($BdOPQQ?_5_1eL1;RUxc}Ecg;2U
zFRIjhOZxs6QyviB3QeFe2vu!U-k}g;7y5Yu*o`PW02#N}dE=O6a7-gp!%xP+qb^G%
zb(xwRf1a%z8zO2l(Vy_un+TD8s|FH`t0Mkh62oXAOEyfRP1rwOUo?1Oee=|0ue*#D
zz9*K`TI$7fX<yxB^72tGeorL4y4yb`bcx5timn4&9Zcqvuzu-j4dkQEo(XO8!)7`v
zIepCA9XRJE7WnNdZ4hCwe6d_Pura~etkg9>CI|<_gN#kpZ4%5T8rjRG;cJS(KxruU
zixcrr1t9`>fR~1E?5rC2cHDW!XMd9hd0)XT0}^z&H~1Z_)b>6Ici#SV`LF@a%I4Dd
zzzLVnLEqGU`h)(!#E5kOGwQv%yciY_&b&xK6vtq}>Ir!-xB>Q9oT%f^uK*tn<X%0G
zf?iSZ{B;N@r(=5@Oe+|ZmN71!=+Mwr5j}hz%@~LEPQ2I&9<U5FiMOy0xPZ67fCitF
z?<4%ae)N<gw(L9nIFiTsL&StT!GMQB0b45}J6%bGz`g+b>W-P8zvJT8|0Iv5=63%P
zAtAqUpOynmy_R3%dEQ=nf3_0B`Eq}RLj49X;HG2;);(#`pRdtIZY~$W6C%E#LW19c
zUvJlX%e2+z3chh*lJ|;z7<V|*l)P8#LY#R2&%)%Y$e-orusMh+_^Bhz<Trl=G6VvK
zJUlcFgX-U0FP9wlqVSbk_SK&g>ypv)KP3^F{l$DC+@7VNL%f6);#U#P$4YZ=7<%fv
z<elxSKQ@`nb=9mx_>nLenX*}fzmpn~5v~9N{Fv203>NX@hDe{rz`J7iLc*C@lAy|f
zUig4NN}pZ+A4HQM#6`d_-O6kKoByC;^z(5rQ79pdBGSYHt2<?~{}TxKMbHxP{{sO5
z;Dz$(H?R7){RfDGTmaX9<Sp<S-w~wYpb7HJ@AU@%@Fgzu-{<em55aWZ)B7luz#tI4
zpeH$b4A1u%h`$}gNNC`tOL!>Y@*<WL($qB`iHD1V%w}bJVfJhMMiKCTfQOTLxPN^9
zxR~d1far0NS>TG9xvB>CvNUOZ0!2^49l#7u{&Z^?wDWojvA4xK5Jv#bD03YLh?<m{
z@KHwvG_cB2*iuTIB~dP>O0bL+Yz4uLcxxmvTzxS3M}j{w7!!4XqaHwON&&!n5#T#0
zW8rM43|O+C8};#;eQ|cc`)_XyzIw;<_;El28!gwOkN?36t$=>;rSkv(3Np@j!A@q#
z&gG-2>|z%9CfMMa=Hm_n-iYJZ1lZ}i1FVx77r!A-{aB8<s67NE^~)HDXwQ80i!m{u
z{1;9<y=tDhDs!K@21x$3Ts3HfQr0!!$=6rOpfko-Ep)sk&m8f|)}`yvha{i*Hrtbe
zJbabg=9u{z#qv=xu74NmZc2xoyW#7vzN4j@>niGW_?|HI{B{0JNLmGzlMiP>s9=a4
zvB!Z9B<z*|8V1;KmM^&4*kghMT{sgl)6e<;2nC>*G)*uWo34d=FT>C?99@k8pT0Vn
z-1yjLBW>lT)bTzhUL1=P@f*JT%hl$@0%&NQi9N6AMauVv3=)0sKF+)%5g7^eR$<ze
z-*6xMBU}Ct@D16JaG$A<a=?RsocrYgYDU<TJTtNCxZ=m_o0<j*crVj5W_O3RUBo{-
zvkd-z`>8wgVhOwd{|_H7FIq{<8sa3$WSVy3#_G_Q6J5Pje+hAdOGOSze=Kw$`#}Yx
z@SRa}V;;Dz1Zh-rjVbx<AMPLD1XD?^*UK%?Gw+S~GkikSX-#a^ZuwvBgW!5W_f0nc
zsq#pmps;iTv1nxE7Ps#TBh@iM3x9u}-{qwAS>M6}xK7~pJ6K>jaA;9~9q<3;kp{03
zCkgTJK(q!OfJ^HUCK#6piqNBAfk^)Y)&g#qtVmw~Pn)d=wh{&bYg~!_^Mh`%FC!?x
z3}Y=X1Z;x*AP@+3N|Hn<ghl0(Z{N}|Kqw8O2lHv1{Q-DRP19!5{5PJ}h*m7jGyjv4
zpDbr?mmpzR<^TUl*DBzO$!2TUR#z{RJz7zo(s4Rz>r32M!d=Zee-$5Jtz_!;$<OES
zi~a0teAw=Key~f$;`EgsPUv~&`8ttO<+fy|M^D2R2}oN`fh4Jfm~p5EyqEkydH_oE
zH)sj(u1qxD9{6gB8;~LZKrpt^S4*PZ@3N{dCm`SX<g}uXGfq7780=nCcZ9$HmKa-I
z?d{_$PiJ}W;t7Ig&-sdxgTx8;+y}^sj7ZuXv&Q<w8d2zK9!72_kBQ9DgSfxMMDRzA
z00CD72KB)N0#-`eYq_Nfpt~ORh{ljlDe<vCw)p=r*M&$6{`EEO^fpo;?9bpg({e2H
z{#+zCr2I2D4I)K44icfLdi@{18S0wecz=W}GqQQojQ|3Es=DgMy4S^bWK=9TVHe-7
zUk!9dVP;Spoy|Y<X(fCmR_SRtCFRcza&!9T#os%uNAO9i*@^xcu@49qfhiWp(L9~U
z$CJxxmy)&mw46PsE?PuDz}Zz;W2=Y$2|G25;kpL3YZ2>T^Wd`?ME~w|I@TnaM+~9h
z?+@afn$M1xfK|3<J|WMo#vC`tE<Pa79GA+moj;xYKrZTpa}pb%Hv}cYsN4_+o<q8c
z;VeCHhR%P7sU9cK3?GIAYlxc>6N&o2&EYcy{oxEJZh+t2ASI_jN8B)m|G7o~UU<0P
zA@K_yA~74N_SJq}DGT}Pbdx5J*A-w=vb3+|jew<na8;zJhDyEQg3Tr!rjv&Cs*IjL
z=844fY_1*R>ic<OBa;sB{(7F9`FUpsMvApV;an%HEo<kj)MmlYH(0)2G+NKBtAakN
zTjDBFn<g3~0ak@?1(13mmoVkQqCNERel!`mOk4%YCL2Z-DiOv(qd+|f6(KI?A>Xez
z-%$)=?ZeS{g8xH-_573r3EUoMqv8)=SWDlDi-bf}K!RL2k${f_r1YYEaJRGJDCp_Z
z>bw&?GC`ZVJ#knI-^v54K$-LJw}JQA9Z~!sAzAR2R3sf~26^wF)N#|_>yow;AFL5Q
z_DZ_H#n!g#4j+@gFBjF)adbu90P;wj^<o=5XZ$tVRpUMXp0iZcQdWEAs^se9)$^~<
z7B`O`J#t8Nq)s7tr-Z01pir=G1QG$51({2DLzs!W0rc=~n&F<N1f;{|5_Jvz{}%S~
z0IL}U3-FhRv~hq)_3kre)(1qMFA!dD6~a)BpY8k;Xnx`VhU?|$m!A?IzWfOP0rNnU
zgAU(=U_d{A^lz--B;ouH(J$P^gC2f>gY!}y6>$?;hx{Rc@8IAN(oLU5!{U9j5WqtO
z`3=;qToTmhHVQOtr!ShT`LdovgZC$}DR`e1@^6<~u5FIK2xsYTheUDQ-K8%*POmk5
zoVpP)fscY3(_-nl>dc9eKmB0EzrM2htycN#90Y=zY47k~6f9NSivzmK$WB-O^}vB?
zlVDM42Y;((CN?`J<Br9K>d(X$0A1x-LL7dx%)6a!fZgcZWn?G+{gxmh0$11<&Od|z
zKDtMHe_u*BeQ+PuY=18h>S>SgP;i7MC&Cz<NUR9|4$Z!S0GsrF*ZsEmo-~;92Ic?&
zlM-w<;OtjOV?+cv@U{Skm$ZdY3BHzb7|Nj4dA(9c?t>5ihKqRr6Z~g~QjY;I><>Rs
zKw;MJPF|4wY*B&*cfdmM0=vGu{>J^8jpHSW3U)+wv(u(;S$kr_0tvulr%gn-OS<Z!
zI3kY@N?)RSwA`A%!ZcM|Dyr;3KNYoF*UdV{LV;K1p@l8q%g{yR4&f6N)t`|5A!57D
znfa+N;E!7O*AIeDs?u>9qfTmm2&1K~1KIWSW(+b%-<A)PSwub(gsdinm?{pk09_IV
z?*M$?$NUu3b+lqX{jY+S>)S~E{<;AITsbZ;OBCJpd7SFsUE)9{<e~u<Krr1oI{S$)
zgUUi#vYc|)@dWS)0{WV?W1i#uKr7U3z5vB_cN_3xYWux-Wog`gZ%0{xXMpR@hHKiM
z6#0ONoVb%n8;0rjK%f8q0!Qh$iNbCh*`SaQoiV;DFb)Iy-Nemym=FgXj6m3!Kq3jT
z@W$rW5AgxT83Ggk;S>BLj){l}?Q6~3+kh4+H>nu<z!CV23yXlu<A#OrlsE^Y>3k;|
zH+lj<@XY>;616W<-!D4k#3M+Yo?d=kXvFa5?PaWH=ligh&2vy12$@X$+q~SoR|#@+
zW%t!d&r$#X-xbwpWRK;mUzV)d{1EjhJ-)465Yx;xg>vgPu5PR6ojA^)`KS#U1PhSD
z@BhGvX9oYO;~@1svKu)6^aSi(yt1<tzrOHIn7Ub=ivPa(nOQaya1;7S1_q}_DZJ=c
z;0jHxmW|%<L}`UG&x(9PZU7K{cisR00f}ldW-f{!;$--oxMrQ7@TY802iK$o@;@dn
z3eZbG0#=|8%a%MwBgA-*5%7qK;y20gp*xq2G)&kCx8QyL=w%RG7LXa^!@Yz7)tLe~
z0C<&|0Vf~8t5OPQ;5zw3*^Cuo1H+Gr_&_2N@DjD)d+P8YWtWz#6t*Vt7OsVa0xmRS
zd*FNjy$lb}*96zdMGmAiu)eN+TKFRBtuH3BL{~29d?m%`mp3<#6|a{@{|e;0Ozdf@
z1X@Tif6HOVjd1^3`Eyeh-p0QzZ(Za*dj1HiyN@MnH$7t~k|+O$y;q=&FNe2h_$uIs
zr)if|E9eYPn%Qe>!4p}O)<K_};KVkvb8Xwfip^2DZ@++}?RriA`=x~IX>*PF%=v#N
z>AOG4@Dn}8?SH{`59j*6ZsT|oJ!u`Z7>3ay`)<hXpSRy08}J!-d?UY?ui=&&=kxja
zj7A~wrUFOmKmYxx;tnCpD0T|wSeQmKaag;OW#$PFga$z!7!bHAei#Ud;Fn-@V#0gi
zd8)z>z(4rk*9?XMXMh<qePrN?sa$|1|1AX~_^Ql(UVdw5KhQ7?9|SM~4XWQ+W8YG}
zpTFXbyNOJ1{p=jG_sv?@9p!>0=(1<Q6yP=qld$sBFi6AC9`$d6ePxd|3||Ei(Ix#<
z<sHEe(|Y+eZX=$fBprh&7n6cMs^48p%}Ej{Z@zyoE=p^JtuuD4BDY-KSw8Bxo(gTu
z7??3&G4O#XdBUr~aOix#C#4{PP6BJ=;d6B~{-8$Iy=k-mr?#o42mD_#w^(uhUTN+m
zATBdKPyD_p13T~AeAojL;ygphoWljn;mvvDIv8=abog}*KcKA+3x%JFi4!DD+%&Bw
zLooPDLIOQzot-8EU>Arh0R{E!O7Or$5O@J)ye97B4~LaT03L-F6tf|aSLfgW|0P};
z%13EgO3>FN`eHa=d`8#8M}(*Fh=5lBD7wsu$Hr{IrE%>3yj4$TfA)hK1Q7Ddpc0e-
z6NWUz8zEwQ?<je%)yI~KzY(UaP3bNflqo=--yq1^Ck^mNNTFLlOT(3;t~1}0iP0i#
z`{7PrT20Bz+4;4viMM3gA@|j*lHKL+TAPII9T3nd8SIKMWAoLUVEA|c3+ARuW31F{
zpy&P)qBvACm$Q%!rQx4xCHGr?8?a-Kjs&^}97RLxkLo@H2JXlIBhV3%yV3M;7eFBw
z8&GrF3(8-`$HC9STuqEP2OjIt_;TP#D8GPZ>(<i!|NjczA%Lbr2ih}oGMUvwTNRUi
zF}dI2i2R`+v#?A5fP&qcgnDBXU+{tUY(_2-f=!^@;x0EOSePu~+ZYEuxfx6yo}wGT
zKS%U534cnwL?7UAS)cEoxFqO61zB10A2aX6Fj+%mA4`S_`~>|(Enr-#Fj6Fc{ex}j
z`Ee*>L;|QJW-Nq9o%Pm8{;BcK5d0SPQc04^3+J&KGGNDLDw*l!&<v?6d^2P=5<0_8
z&;N%xvau6?@%uKJQ;j$IA>g8`uu~Bli}%46gwci%d@GpMkjSO<0n6nX5ld&~vEKNK
ztyaG#seIhoHzgHkKBeW*QdHcPzruCdRbqOyr{(3=$VVmZN!8WYq~bH~n_A&77bbIZ
z*^*zYS0$p|pNX?FnDBkn*U4cS(U1iAM?si*#*mI6m^lk%c<Ym?!ataY@$(jsTciMu
zCB$}4+Vi8lk0ooi6dxlaIh<eMqS&WF&z0+dC_H2bi!h4ck;&Hpf6vrKUBd!IaOWA+
z!&2#hus|dhc=ZF8GALPl1{BHj@4-Njq+C}e_^ykGvlWii0Ha28eohwW8O{cQBK!>=
za(;G<<7L=u*<BbR2!=by15mW!{i$Hm^ciLRriP{9cnpR(72g@8fLEmL(f~@Wb48L-
z{n}Gl6hw>iz6G{`xD%D97%75CBKex6CxD#1tKpewQ{?c${v&|hx2(S~ir^F%{l?6`
zqGsp}0AXcsOW$}$z_X@M0o&C_r+I<u<!o#|HOI-71_$MBk-w<WX+gmHu)sua0lu&|
zIwlcSG=W>{63+8Oe0_i9(^Sw6*y%2W%(TaZT2ICOKfsh!E8^8{BS&4brHm9GhB9^5
z6L1DU)eq*g|M&~jF!za*I$JSkX6Df5hl%rJ9|<pVgxDfQ;4gUn@&H&He6`otRn3&+
z>yowkYEoZ<jcb!zW8?EdgNXfwI<*_g<3@gN6LG$}8{u7!JU5`tM}xJV22uL%Ohr*A
z)gANhkJ0@8ez|O`@pWA-M0eG{C0E2;+?r!G;vl!At7%+fAg3Xy8&6mSfxk|!mh4W;
zY2hk~dM4gE*qNcxdM~Iiy6$dl`x+g-TLu!~NNNLj0DfCXujG`{A|2NRw3*XC{5}X`
z{#C;ouEv=I>%)oN|BA<jgmy=XY-j|e;GV5z4H-!T>cWc;2|`YDMAh&ORXutfC;Q*y
z&kh3OBP86j0S~_808jU}&F}qT?y7D1|DeF!!UNzS-1>0>Z*O6N2jb;_*`ADHqvqco
z!De?tPSf_hzICP}RXXQbo-c+{*qaG7+4=%~JP!!)^8SQ&fKx|6;2?HeBFi8KY*<l4
z%AF*+EZh<Dcon$K4>=3V1pyJbL%0LBQa#o|WFini{*CpCgJZuX%%8k6#?eR}_6-w*
zzMnG*B_}+~M>PM0E1sjLza2gKI=WsO)fGoiG2^G7CsqreDwJT?*EW=s_sFFYxx1nW
zaeAuOuYwtY0XiDA-C9%pA&~ta&)+3>ywukb&68(>;V&Zx_MgS(5^g3qZSTSx+X1;U
zvxs%FjX<rfvxQ0HkHt6F*KfS0M}@cLt!3*6$!_1lY=Nn9$`}c1fHay;F4`u}Jya!J
zC16<s0Wy>tM-ToPjfIDxG$olRn9uK*M89^UK!s2bUP|UCiIY`Ygds{4Pe8l9k__U<
zo(<~E1QTz-_s=`jZLFY4Nd(ZcUZ`z-d~YmnOB|)HZdQRCo+xX2d_ZOZ%=V+wAKm<5
zY%nF~Q#E~V;s{&Soif+(gdxQ{%uD~f<^>`MPCNJK<LM*SL3|KJz!HGyP0knPZ#91b
zzg<5u1K0RD5-x1TZNM;tF1#KB1KNyhK4@{k;#*(z5({%KGJ-)k%Z#R5eYWueMerRR
z;{nFDAAI)SCieWq`oX}Fd2EH#BcKxCL(6n=V1P)tjA?<dZjT;rF#y``U?K0o`{jR}
zFeGmq0TCnFxi(d+jQoskUak7M-M@f*^r|l4<HM}eaB+F!WZ7bDY~jxiClm0%k+|t-
z5DmE0zuQhF7WMaV81=po|1F@HC$UxUj@a$#4Ey<@fSq1|w_Y<YeZQ@AlvH1a1i772
zNhSYShiZs;#ShK8-vss2NT(z3JS!4z(7Nk4&uM8oKa+^i6!6&-4Z|~?qe0=8lMVSe
zOQIS!@qx?dsLA90P6%<>M{4J+aPj<tIBfj<n$i)?XLNo)dp1+ntNfUoI={qqx7{9@
zOx=rATl~AzK+G{eHb{)+OWl*DTqRo7ch$#+e0U$!gjtUsssD+meI-Cd;i-TFK*JEg
ztbHH<3fm!!0WEAq&uLBgo+xx5{7l5i2nGSr8am4aGT&+Q@bNL9;sF=E9U)Ny7F<Au
z?jS<t@L@3AWuv4+9eCN}@d6fKJz1@Ni|;2|`q$4`YIlG95ZjnL={dGjOV+QFs)5&8
zS3TXB$>;nL)qJJo#s3Let5w@wa*yKlSH^SSE|O@y*KsG|4sM#1V%oVSk6qVOa7i|O
zz>d8y2~bi|cGYsmo^+y{f=oZJe|)y2uxh!pBEOc)G<*=pM9U6B+PERKzgG)&Ottkg
zSO3k!Hrd<4I(zW%Y5rZRZ-ObraidFoIa?~0lO|eu_${q!y<a_K?EfLwPEOi|IE^-F
zopDF&mzxkDo~harjQHLsEE3r+ggx_je-Y9w+4b{zf0mzZ@%2@z^LihJrzMySP?JFb
zSB^bw5OEU6<mKrn=FNNIyx=x#hs9%of;bQwkl=sBMgRiRptei`P``?*>bv1PEPo@*
zt`XU!)upO0&Et`LT}&~D11*2SePuJNSxk^;u21|FRUHB8B^SXDNhUse<w|}3SgV?5
z%pqp^CanRmWfFXzPwR)tTi+(sV+G-9^V*OgqHoBW6D#gt$-zYP^=H-aNy#P!I$mlz
z!<?6_VfyP|Jw&59#(YmMY^v(g^LKOcc<|<9)LqO%xhJe(CNxvc7ybz^hNWa;___ik
zXkP2$_5qS6DPA!(!&wQKKwbbVj~+kr%K3u{K_4$Q6?K=vCn%YttZ#3VSNSNDZn-p&
z8%u@x1QP}V+fM2_d5`~z)UnXOxWM68CaZkjKIh{0l?b&I01_qZn?aU;h4ukBAT3BR
zA^oM0Fh&7!>wkpf4J|jvfCA9k06&`Ath|w|@2+aIQxot-o0Pl@tGWVgfr0$BekWDW
zSZO<->#Ls)&{3DprlhGpeoR-8M+);~%>35c#d799Q}9PVZFkKxIpgH%D1)iqP6%yn
zxLh~U8I_zaJP*_b{!25RvG|)EjimMU%i$|zF(Hm{0I)L^To{)G`C&vr{2wW~C1F_L
z!T4@?b;vMFPkdgIY~1;-rBAO{eolTGsYaL1$RII;NBAX<0V1NSpgiO>-1ufT3Ox*@
zR3LEuU;o^~6xq$mB!8Z<q{sEoSmERUiK12#QbUR3`6{?ux>t-pCs-?<vqB~_<>9*4
zvr(OX5aFsD0SyhASPg3#cmKxiFd~6xb8b>R7-7)a&-KTF1+RVoiMS-ecm)AIRcnGt
z4bx=R$8Oeo)=X>i>dWqmH*-HGS<1ue^~dJR3N-rD7z3S$J_xBlhtFhnCuBeFX<Pf6
zdJn^Tn0H)fzb`I{CcRv)YBa}RpMqNL$X%Y_a&`~#6q83qoe!S4VKV%j6lTvx@~-N?
zgg9n){B~<c)Hs$emmYq=*i_uTriAy^FF&}`Sbhn3YIBKe8u#_hPPf4yH2wA0)+x9o
z-t7_3UM4gC5ZXYKs_g6Gn+J`O6ouor@2h+{tyFLI|6G)3jw^>b1V^({R&>Ae*RO(|
zxOGX&4qzY-2pR(DoEK`~zs4W+Ems4iTSQ9O<)VHI@qD?|(~a!^|2<AKiAI0I^`|f)
zV3TculO=W^`RkU2qtf{~>dc9eKm1OWr`laiFRoubUU+{20j_A|?FG~!zOFnG&ggy+
zUgyFaBC6#wJPqy$2=QtE1hK$_N6u*ufc5v2y$1QWe-N*YSI$Lqbzcs3M5)GzF#IzU
zeN-XIT1b9RH9cC+@m+oLM+UD(5aiRhgNnzl7ssDA7N8kI0hRgZG(25YgdEvfdFmw@
z=NbPe8fE$F8lA`ebK4?gD4+PQt+!v6tBByfTU3x--AXW^QKAp{ZgnvA`D>s|zg)W2
zb(g^{$z8QT)?h#!KCgV-l9RZv`Rjy^KiL4k$y)psV<vv2xwB<(+|Xl1Tx-8vC92pI
zz>+ofm&I#MwZa^{S6y4><;0&hT*=j>KNS-;@At{Ga7AZZOU+cZ#P*kMFA+c>{JdHM
zTn7iQ;wFJhkT6~V1bk3_xp-$cSLEubCxm_j|Ki$yJAx=>+)xgHq~f?EpF7LXQ7F!I
zq#4D(6G-&QL!<nf1DcPXygk_eB_+wt*_6>as&sUpA7iaow@jV#XU(MYb5~W#osYp6
z4Z@S<^_SJYwOsYQYroZ(!4@=g@`U(Hw9>EUs^Kne@8#&re*E$;b=;j=PF~Yqdk<!B
z_$7~k2Y|T1tNKBFMz#iHy07AES|!3fn7`$fA|)P=KRu|1bkP6YqHHrRq$MsVurT@^
z+FDLt63qKruYwM%85#XnG-fGA47K?={ViUEUbZ50T`b&{t@nNW_3&l|S|2A_S0vh~
zlLbB3Pu;d^2S@K#)-6?};;n0Hk-2xe=d6EU>#PwRw{JHsQp9ySIQi^7oHXo0T#@Da
z>#O0b4D@c2hgZkOfq$Btr(6)$-YA|-YM;+no*zL>0Lj0spZ}BmUA5*TP4HLMma6+V
zBKo!PM^)eJ6r8d{iR)2ZR<%V~Lz9*F&C880ZyV3aX1O@OC#^49u6p`&)wR!Ztfh@x
zB0pH?%gU6}6V0kAIXwC&h2%53qPv4BSjms@U*m69(1==wu*~59`n7kqjSX=$t!-QI
zNn|`aJ%^i(vfo;+BHlbWwnn<Ob8?a{cq5i8+vl(CmwXW2Et2w9&3rSe)@>6RulzGw
z)ja$Dto!XKqpY2ETrcB}b@{cg@w5cu{AOm-r_bvIqDh;VM(z2lSX@HECnalLTk79d
zgO2K}H+t3~8p*CE<^TY7X(9$K8Dlq1dgIT1@oev>Vo;=+P%N(jk<snBYw#^qjM7TZ
zDx*+EN^#AC5KS&fgTX3Z4)I+R(WkT^2wG|pQA)bV^3CjUbDc5ULV}ddHZS<5=d~s0
zyZ==k(%D{0C+w_ccI0-;4hzz<=V@zp_(}W__|~}G^mBw<_DJa^I71TIrAp9?7bi&C
z0p1jfx8rF>4UDu9B25J#<k3w5y)s7giQVqkx&WY5pxhCQ?1tgGnl>OqBltFnaouRs
zRWd4w6xY6U*4@z|)iI&}$e7;z5ld*mHMN<m?a}`V{RkkjC89gc07F<Em{5wz^$pNJ
z;{j`7#1g<fZo{BJc9C={YX4m-duM*nW_hHjx}3tR5FVP|UI17=pfKOi>pHfNIoOpN
zl>liVpbA{$#;v@9T66+p=a5wo6u=8;078h>=X&Huvt7_ZZE0XoFd|1*4?ILlRoGnp
z$OFoioq(ao!2#J6bS-JYQO_R$03s4Wn&4^_CwQG=cZt*`#aI#shBWd^SdOlW;R+7Z
zeEf!QPBWU7sGg|+cP(oScQ$+L1@~P-BHi0Ms4DMTF#k3*B8`NaK+}_wQVGD7sr}GR
z&DBF)=nj2cwo{O6mRPc6$Ro>D!~B-(1>M%L$0ZFo;UmdFLqb^r&<qIOSR0p0?}9l*
zE7V6NN~ami+Z_o&Xy(yJ2qHKm&?%z8{qp2^o>7mef16t3Fi*{U1lNKcw(J7@++;wo
zdEEcOFL?MsEcMC8q{965`e#k`33AE+n8q>!z{isn;T~HB8#RC-9r?I#mTzFE=IT)c
z@0t>GRde-n1l~<h>$^-Q8LAWIv{QQO_uhcig~B~p`8Jw?N+3i}cJ{>cN*Fmq0tc>b
zCT1E5^>}}pjT*unxpN!b<aUA_vl1&9Lz^1}G884v;0DWy8%oa?%|RH_4b}nC1eL`g
z&pQtw6{Gw)_#`r(nnuBhfqsJk*Xnt(5h+Ms^3bAyBzYcH=l(?-zCq|x?St|PoH-FC
z;DA6!0I%0)!7uTN8W~>a3Bf$(ZQ{>w%jxFg1PkFiy}t@Swl-S8W5BY!unHA1TH$_i
z0UG0(flq`ipz%TXkkE3o0z@2mZBu)o>WUi*XRRrtV(nM^=j7aI1n?yB8rHHOT%2xm
zH#Mcg{3Dt)0l*nrA=Ewwz#UY#5MSg0Bhn3#(}xo@D%An_M%)14xP)HApjE`eOI)HK
zzj!zSPs?E!;8+P{SS6@i{V}&_e+WcQ7!0naeXQ;9X>fryjeo)s6LH5s0Fz#f(a(No
zP02sGgZYAs|Np`)>F59OLvuFK5`WAYSI(37@&AGtiUXDh007{vnt+azpI#8)S)8VD
zAX_kzmV^w63+Nu$1L$Gsq0gTG3BXJqVg<qLz*B3X=VT8BvF3iG3aZywfdc#kQe_-~
z?=TgB3JWt8YldqMD|4@>AClDQ<2g071P-<HP;t_yAI*@}BJ%2S?A+b}%j@Co;U55F
zbe^xW1kJ9d3o`uVp4xGgsJK4Aax&U@bdp`5|G_Q<->fnjo<YAE#%_si;6?jIdlCNm
z!5o`4;$wgNgZ}VAaEF2jBj7*dQN$PE#6WU@gWJEq@|ixv3IJ3aC2uyr$74WoRIpQ!
zTtUStVZ|wa*ik@9{(gV_ZdiMA{{l>0SIc<W9v@y3gjEX|n7_EhY>}arL$H{FWxNNn
zjydSWx&?_43ZNFqbtyWx{sB?Rf}oPGNH@Q_1`bT>KRbL1%&{!dMgP?89U2N-4U?w#
z?;3ys3Zc!~_y=p$agKYBu*8T6Yy%tP)d5qG6>(ET<Bk{@G8ZmnjeU8j_lG=it2oU|
z;IjEFsVmzB8t(PTcY11w3LLiBG|``n@KKH6*kFMJ{RjK)fB1|EzgPfKxn76-w0Qkh
zffOz^kK7_4*hIn5gK(t&B3VTd6$&r#l*CMDeIK~yP_FR~g(N>2pB;Qg7@lu|0~w>@
zA}F8ztYj#(ABJM_@Bm$|e)|s*FGd<k6z{}{1YZPEdZuvp_uqtL<mPPwKd$;f1FNOh
zpZoeeF!}8#{;O|WV}^}9ASQSISVcEGukGM&1)_%e;!v=Mt^^8;lafk?r029dy}E%D
ztgDt|wgxZ+BKfXyeRFscwSk{632=eO_+KEKs1s`N`A(4eyhD7{1R6ll7(#oX@Q8uj
zBla>xA%<W-ut69I`_JV%#9}^3CL3GO8p({+{u97Z4*uZC4&}~zKoxIjRE{N)fWlt7
zyhxJx6Th|}dsP=N;Gg0|5&&BH)XabL#IN@77>09=@5>S(Wwj5(CfF;Pub%YxQ^kAz
zuK^~#w?BFP003}FY{S3|e_gHq1wKi7S$VlV^Hp+lNFM@c<-33~AL}lW`B#|wo;#Q}
z0P=Z50(Af*KUy#Nf4}D5ph0-0xn>*}L5E!42u4NecuNFrf&K6i`1eOhWC05T3;6%y
zJVyw`bO-|%+1$UlfQ>$=m!pY<JkO5Ud^CfBJAtr~gWME~Y2Soo<}cb@e-a_;@y9jb
z^sIaz5uvanu|QKUy0rX}kkCIrRsf$71iaV-A>OPU02p4Wy)9#IMJvXBZykU@`mjJz
zSG6O_R?KqCKk0X~{^&6F8u^k<`=6LF>zf<`0RlFl41a=L0v5d^?;uF%+K|Dk+n4u*
zAcu?nopY}cBZ-9O7&ZnHu>a`>AP;>~_JfQbfc(A**%dzuFW>=)yGJr+Q2+5F0u=4H
zO$<!rU4iRONo&`S{eiH`2+QW#M+x9S5TVs*M=xQP1AF0!DG&|wcmWn#W{7A1{CMmo
zXDxxi(!v}I)<7;utTQ(T902Kg#DfkGpfTsx{PTGA!3TgD9;c`NjsQeoQ)vI~02v>x
zr~jo5`$;E?`2QrI-;iln>NaED5sYhRM~KA6VnHOzJLh`hxFA#o?jQz`8AuSHhy;EC
z^+5ERRH8%^l=@@2HL-$TZQckuwK{p>5P(WZR-o<>4qnhzp8zN|k-VSxKmypA@r?)n
zA=Z*ee7LU!dr$Qcz}w;<7oZXxYzF;cei?un9+v0#ny>$)m-eP#K1BZTH~2}!>HH`Z
zzycn>>ihrb;m}C}@%tD87x=)*&>&5qKS;pWCJ|6CCLSa}&H#@XT#dE~8TxZ=I~pm5
z&Lmifrkepm#t?v))0}<_+4u!|e^GmW9;PltP-J&7!uCvno6Wa(&r?y*e|=lzv{B>&
zfMnqu0&eT7(0*;i6%>EnI7Q6>5kf}vgj4?Gef>ROfaub9Isb4!dLk;hnAf;4_(ULY
z08{$dANr;d2noyp2qA5Fto5r9ALH>JBZ(0vCSUNJr|yE`_<aiEpbVLGLNBNrcevcs
z)ebKKV@Irz-9P300A4c+lp(fgDB-=lo%SKaFj5py2-WG0dglM&r<=eDSik!*U&+LR
zXal{Y_o1LH_K*+KiX?d9Ev@+v_W}})<OS+_<6XDU{5#+=ub>h%m>)I<#T)b7Huw;|
zBM<+}00y<+N&o*3>z3o^R#h4i;yg!)_>l&W0t5aaM1&F$au7&C;upj@2qYl>;#qS<
z#OBUcIEP$Fg7MV7#OME43K4`cdSi(;s(Aax)|@am>m<r{9{4wwx|=_7;b+M{49&a>
z*pZMzJ8e)Oo!*b<0Gsdv)*>Fjgab`R`$Vig0O;&OL;n;05DcsEfMx8Y$MT=}oc(}s
z$}ATSf|zNR|I$lIAsAzcmzOFeL8->#brUZRMcl-3P)_WAto$T!Q<cC2`F;P1inlB5
z{titl<3Io9;X~zoVl8Mv_ioES<$&j<jR;=iBLV>I$BYxj>VH5(!J=SK>xyhhpXdh|
zGs0K63jgnupgQlL_-`1jGc3oinOtmS!hDg?ZlCV&@dWXa3M43?B5vc~cmMGsL0w(V
zP67wLFCgkH6y^c&N59wA5)c`O?Itqhn+`GH$_GyC6FdL^AymvIWDVcwEzOPH#h0vw
z8oPy`lz(91MQ2S<cYlf_1YQcFQF2+BAf-bF-Fh192hFEzi5s676fll3;D8!{ZDYZ6
z7MuHuXwvY*1_2l5Tcb2f08RZj-yqf=Qva@N0|@hoSpT^l;617MPrg92#IJyWSC%Fn
z@DV-F)+}>Ha}}mQ9i+}<Z3ki+XQqCpGQ1$IKg?_5VQv8E=SldY(@Vy*nGQ0df174~
z;zd!Q7Hb7Rhtbsm`oaRH=Yj2#o0Z9kV`!c|#=yFVM|`w;g8u5bA;br0EM&kJFdUi$
zM9ja}(1o*CkSo`}d<hAf6O-sI57UW}JWBMTlqY*@^@#~XLM}!?eKzBkYfc2h6^1A(
z@Bf$lUw#O_I<WAFfp<7S7=K&a3^w2m6%b`aDNk3C(wPNTZ^1{P_E1Xa=|0C}sF49|
z91=%NhKQn)$U0G`K^<(Cnep42+n*7L{6R1i^wXo`UKQaHKeAGQ0ggoQr}zRRY0S2d
z|KSlLVVlq4F1PIH0veB{=a=0a`sK5&bNe!p<KO4*Y)db5egr%sChHtr_%n8B2v<#e
z^VTLJ5yfIv;xIwNAVCubpEy0EtkBkE6QDTxtPcWp$(<GBbS5Mr(J~0QU#g&T{3T*H
z&+v$mJP0Kr*?CP~cb7x$+PL*^;e7QqH}GxCTE%x;Q}cKNdJp3~eZnA{QG=c^T$K)g
zU?z6k?DvQ75^ONOAMQMP%`|@Nzc*0=L!86l44u`8yY$2ObvisHz(3Q0qzV2YMrncm
z3v(@j_xh_I_y5!%g=HYHgzxS?8=psC59iwcCL$Uw6V?X>b4z$S<t_gogu^{=UOfM~
z{w7)wdKAv$d`uGf+59AWdZ4iXd^G|l=iqwfE&BP3ioXcl92MGF99pHn2+6@$#-J=r
zPXKb~pd4T51T{|+EQu6wVE!U(4&}U?JWLf$fU{F@y{enQbMj<2_OcK3n4LJ7?S}=O
zKqgaNO}2iWOs7*J#W^DDdw>5YNpNSE7sT8IZ0Oj2tD&fX5CLke`L3Gzn3;;fh+79F
z%`ycyw7DJ>s+kO|WU;>Tu_h!F%rm>TqJWWJm%l$ak>5M;h(vw_wAQV+%=P50cZ?0!
zkNZ5qGtxe@>ZldYxjO_}1I}szSkC~56CWL&6liOq|5;ZpgE*n1_$SO|tRmUyU~n@?
z!n@9i9H`RB3vdvT9@zJ>Z|~s}U^P}t&AwVY)+BXuh#(GIe1GAezNCl8ly;E!z<9{K
zpwvuXjR-hGT}%YVuMf_4_u}mp935XslH5$RLG+lF;&E{AhvtBf08{<Q+k^kpK!=kW
z;g203r2qjBCga$CWsi7>D4}JLjJK0IJX^W(aF;-zkHyeSb@+;qD0M)H;rIiO=da57
zUl{kpZgxKSPY<3G!e5#5KNF$vZ?dw^_rldpQ&dP*^D#3N7jOtwZM*+)<##8MDq2`P
zY(e8;cWHjvCJ`q*poT~^@4_JgP&h2K81(6Yf`mOql=8dT2nl8$hb+AgGa2}=4R;IA
zQjW75BK~gkA)JH=9NsSZBLj|y2lHd%nzT3i<xwIB%brL8C#YmuIsgPkj#E^INB{&y
zo?zvZB76Y^w`t$_DHVWg?+#$RY)<0BlQqk&C5bnH>X{SVjq&DqF6aJyGH(H2XxM=v
zZK47IdX)Y_-**N{q=Vnxd?=J3#C~Y-h{#tbO>n)12pl}-jO%>tuh~ZKFI*uZ%&g(a
zL7n3a!V5BU*X4Y#o%6me$Ivp4^~=52J$%eZu4*JeTLH+3iI74SGaf<YESU!+5+*14
zVHvsNcY>36==GiWMi;?yq?R&)cfCZ3MJ146NqJI`8&X?7zr~1Q_-m_0b;=Xw)nmD6
zca7km9tp=<WF0WoF%Z?U2u%k@>Y0Xj_!LD#R_z4e!9aWD;|B}&Ow=K$kiaL<BJD(P
zLUiYXK=d9!h?w;f5DVZvy7ap4ya_jfjz`wh7v_8)!Qw$CJOC3L*9-U-`7EIn%UEBw
z62W!pIVA)FkbZ77J<ylztfzeM#OUuNNCqZ??gNr-F_Bf=WF2R7_CeNn83$S1@UJEe
zMQn_Lfq@-qE=Q=+WbeW<X8XrH*|}`-_m~knxDm(W;K<$`x(^YZ(*=59<iX4;<H(f3
zm;gtKg2^LbZ~+ejQ%fg*fnXEHTuT^xlNqZzSzgAZ&x9@}D&X=2M9Bg|jv%AcerT2v
z3*ofhvgyL{5k`sn{2#(+@PR772zY??8}kMRFeYi!VtV|{Ov2)^n-NR`J74h*)-l&!
z`uES*@!#u$E0&sn5PJNtmGi%Z1!GBwdr63XlM)E4_RisoVLQRZei6B)!3+mT$umX-
zmn0or0#248Ua(LrTA9L~L^_E+ckqZnR#h+$z7DGow8S=_{6AI!zHM8A?!8=A1FYCE
zbHJwZAuu9PrlrU<S^$Q)w6yk3CAD5o|G@yLI!2Q!#pAW;B6464YtWXEhJf0U;kYC;
z1!~od`~Bsg!4@GuC%d9V>k<(Y_yU6+nSpo5!Se%logaa#V1%FeB7}@zhg_N2Tocm|
zuDqdu$aN5zn}8EaD~q4sm_Z!8`uSLs(bwvvhl<XkJ4^#Csd-?F{l2^?zlfW&-~YtK
z<hIWC5LBysapFjDU}MqVNSJN{I{H25L=-!IX<y?Pb-^A200rt1YfOc?$efS`Sb|CV
z#0tX;)p-iqC*qn-)hUVJ!XbfJ4y8%)>BffW(mK!Z3BL!1V?D%?x$2snFh7FM<6^;s
z&KN7J0o?VDY5&h#HvVo{dQ+9?3{D6K!s5P&D_JEHu-2qOQyF~xB3}eYl;7e5SPT}B
zPFDlKuf*S$ARr5?tlmKZ22jbmKmz)=6XAd8k<R}l6FVzVBDCO3{3}$~;h~oL_<wWy
z>o2@HYtwv}3v9zMf<P`AMc2Q~qDTBhI)#_RiRu;d-{6)HY0C^#miFQR?eIelq~rds
zCk@C@(=8cC5{LY_=8O;UgeK*v(WT=cJ~sljc1(2**w<i$fK$H{SK$~|1J>ofgc)VJ
z`81pRnmeg{m}E`Cm~l+OMOgKiXepJv)JQP|+;9i0rX2@jG{`!LX^vla&kq%+<<M3!
z=MU$92#6J|#jDR^K>@RHoaaNS2R;m-3rmU|4mi@ruT58*n)asWuBHAM<&!yiC60(^
zCYn&6CB3nHOap+$wo;bz^G##lxDFn5tv&Wo0b0a59AM*;CQm*-B0d4%7IZPsPX7R4
z7h5qMb#jhx1Hl;V1_#7N%=`!y;%)vh=)4qc7-KAhEkiKW;Y}=+c(@j|TQQp%y96&A
zDF3`@HUdY^&Ul{%egUm<O*ZY9a13W6^Au)}hyEfjLbzd<@?Itz*uo=Iv{(F^mxO#G
zcT)t#%toga1e<6Nzf*_*5rj<v3AY`CjwNHeqpU@9LL5vkA{b)sKgH>T8{Hyt>OB{R
zI5T=IF_sk4&-_|T2*E~`jvBzs*nRkzN5%rW(n_G<K7|hppn&7p@I$x_wDLajH@!f6
zhp*v}g`nb-Ou}!8z^k4x0~nP){kDCdT)W_+HRWFPxn>ylIG9@qP%|;tzai{mmMnPy
zaGdt|H{9V#!d4tGlhzwjIxttJPw<F9BMIJG_shfAM(REAA`%-8HbWlk<>TX2gTKT1
zb`zvKlV+$Q^{8*F!6qav4&4A_Ig2m%*gZDK7nHZUaP(fM&b82haCK_XU~lFL_;x?X
z!Z~6!6XIaD+FmjUC;y07;)Ddm;!j`4E_3`MASumw3UUMTwrS_^8;u?UCe61~#kPQU
z`>-}^@`6;2vP}9B3A_LQ4<8ejim+MFQV}r>l=0lvLEG})waLc^)fW;9vBffC@$Vtz
zPE#<ck9b@7letf>co-L3NOE~d7Wa%Ihq)i$0;#Z+rsO$X>cj%9H_6B?01cbsUUI-w
z2oFYxU%onne7N{BV95x=d6(D{D8cPSZ0j~B>#v6}0|+`Pj~O&b0|;`%gTfUbKL`l~
z&^->-3cH>I2fptZ0FY%M;yU+(`sv%?hsg#+_3xgkysLQbOIh$7abAoSJ8O|WD6f8j
zu@2f|lJXAS^e%CVt1Lgn7AXF_&EGd;`j6IL5G-KZurL_hMPdbc+n0EZf)|OGcy=se
zb6)dsjy`z}MUnm!f8u65|3Bdo0J5OvWA;{VZ~)qWQ)GYiCV?2>k?z5#_Tmxx;|L{V
zM2QESl`ZhkqALvy2T};L9uydU`Fg0X>eDC@_(H4>3@B(0L$gN@p+o0?5gYyxy@4Gh
zey)Ma)zd$Ti4t!Bjjf~ijv!8A<lrOZ@#IdxtuXWaBM4v{O{+%v^fU~uy10*ifCp=h
ztc`!nUjPCF`=XWR-tc&b#4H3mvXqmqOrD^>yBx#trv&f?1yy0XKOn!p@GR{+TUZIu
z+DEe-SO4blEMD<l>L2&a8td!Tw}=FO1J02F^B-0a1l-M@5Q|S}iM)S-k#RmCM~Ef#
zC_orN!T$jfiTPvKe0=bJ2sKp`00Zx``Of`ta7DE3ksSeg#{Qwk&)_@$p_+5V|BAo^
zojd15Z~s7?^+hY#=m51{ypI3)ufM<h-v#$rrtZJ~f#D1Y{JM}q$M9DWjfj7Ob4k;{
zG%lG!ANNNwHkk+gWIo0=O`;JV@ObJrrdPK2t{(BaXLvvG2I}K5KmBKhPv3fIOxXVi
zhgH^@_lxL6Q5zowTu&3%aFM}IeDNYUkuyZWCII)QfHb`aI9vbw|DT1JF>4cBOYOZ^
z(VDFqMU7H>kJ=JywraL^QM9yLbSZBuHbw2d61!EBpahZpeZIfz|GKW6lbn;+8M#i*
zbzb-VxS!9pY(W3aIij8q&gYp%*F`J;PJ@!BbKtVU*-WzY>>DUS$Zoq$0O_6bECSi{
zMl<$q36=~{v^Go(@|PF`boNP7_`Y0;=G<D8;BaW2<=bkc&#m9hg-3VVY8Z=D@X5<D
zUN(GATq@1Lw$W+WSTXrybk_|?G8gUUIDECnT^;hjvc;AC1m+p0+Wr_aI}FA2eOD*$
zXlxk(r^vFopNjWxJrIe4{XH_o5GAokDW5WOAibln!-t1CS-3Hhf^gdx>17~(`!S=7
z)XGc5!=7}>!0H_N$U9wjxC8D(M%uY!D(sz$xqHn}2ptXOB1G(}Dxtz$E^-}_NGGm!
z*DtUIMeCN9Lh0f4`|~8w=#!lM_XlZf->-aaCats$H|aPXCZ5Oph8Z<r=+sBAtRf2U
z8u50EUaxh_uf@L(>fn0ug5z4k``41B7P-P~oxLoAghs2WIbtQY{M|2ph-6{?;Tww=
zj0EriPe{U-p{%|w98^CI?{3wMJq&^<H|QYhwb2dZ=%R5>T!Jf;&U`TtEiVWeA(av*
zRAEGOW&SsbN;NHb7*3o1KrC4HVGX8ln-CGf%L`{)1Hz=FRKlN}(7Ck(V+%URCsJ9`
zd&yA3Rk@~A2wLzGzF#a<6yr%U42)rLge?Oq%@0$wq;*^#H$u?Q6S?dk7#w*kLmnRI
zvaDt0Z*Htlx=#XcnHzepdWaPVsC4l93VZOMI>G$Iye^OK<OO3vR&{c%`q;M4qUh~7
zZIU_1%>jJAOa){6kizkHUS$IjG}CavZ++&k@y_?PF*JTxo8)LHa1}-BjTdyOBwe#a
z5KTXS%aZZF64h~M=+Z*sUHKWF4oZKGDHg+7H5w<1LO$LQo`b=4oFFl%lS^`{;|$2v
z21Ei%p|-TwGH}q7fW0nHMfD)tQE``<g!<@o!_bV24fyj<uXa86-sOz}oIoqrzgTUM
zPj_I$7ZE)#)Vj`nntLrMF6L0GD~^39QL&?~J*09vae&@wL>!4_LF3MDIfB$?Yyq3N
z$~fHpN@EG+s?Sti!?1uL?&cTc^cJH%RzDi?XkE3v5-8yzAieG~V2u}<vj_g2ZPNAH
z0?}TseY$vYEWq=RUJ$#R$q}nP{Hrz*zLwQ>q=5NcQ2rlbwCAF{>-^Tq0QV8T59B`=
zp-z_GK!-8!T}-0$=O3{mhEk}+oC5gt=pq3ScZ=S2wQU@e;x;}K{+Dr{2bidYT5KF@
zz@9wq$Z=kdqhuJ0=rT%mHG_4j^KTMetQls;nQ&x4n!hN=o=%sSN*z$$b)5641+9g*
zHwjAbh||!l*y-zYZqa6}(>sO6M<+E0j8;6?ed)YM5$?0|;XU6PDreZfH+;G@@80PU
zgPNm2V`5aZzc`mSv_-{wig1>hTxZ%S8ouV=wo<6zNk=8?hv?N)6nCpk&UsEZLu9$9
z?n9|KEP413uA|cI5kM>cPs$IMh3s$Uq7I|}B<MLTzU@rBl>kWJQ$9vMnrS)>pfhs_
zaX8-|w=_P|XuIb21`KdrQQg3WV5|9F0z!Qq598JbDcLUdpCQ+<_h!*!^GaIOuF3>h
zgh^r`a4jn{UW&0l)Q&NFBQ+J4q&96KW$aRwKeWqHZ_btCrZYS$4!7iS4`I)H>Qe=F
z9_ZE#S^Kf*kqavd1@RyAlch6eQ%fzj^&hGr)-mFv=H-0NUfgo3K;0#akUMMIcNz8X
zBq+$=r$_t}>Spd?nIX#Z-=97F9AOHMP|bic#aiqRt|d7=sgPv6g=3iAH6C_d@&a|g
zFG>s6zr9Vyj*3(ucedU+FQT5Zuj<CS$eYu+<Yvg<Fa>|^qAO!oe6g-tPU&@@_sz<>
z5yE7s4+p}AJV?7mhU?vl#MZi<Uh05090avE=`SN0KW#L9b92h$T<yV~0OSy_nsETE
z<kw*BR$Dycw$Z_=>fe=1*Qf6bPZh!1U0ePc@A1aB1zTMt{9gt<`bxiX9g!p#I>Qro
zdcIR9_x46s|LF_REM-9SEAg`$g4ouPvAYZtuU5iw#fmiT2SLvIoaNJ<9w3wQ#bUSx
zBNGK~sFmWmFP&N-3YaHk>^<}9{djz)ltv-ZNU>coNMG$fZ<fUN7E{FV-R|VXr_#b=
zSntrLOt9RW=h}Fjo2tM95>jycrNxs+rk*sB6^o{zCwa@Fr%$e)L`5DXzZmgr4)%k(
z+a4Vr8#gynT`{(WMa{q6AEC*naA6^Ic?=23c<H!td8uRm=jz_^9CS_S8`aDXpf(>|
zm=O(P?gr@<1JY@+vvljr*{K6?@O+ciB=E-AUCLE3Ni~9|#_1!jPk!$}uc(4;=Mz(1
zJk+AQ>jywa`O{<a1;2DwXbfK_xw5jGskoPrEW{J2puz%7x=v^lfUW<Ph`Bhs;@%;%
zW|KvX4_c>8Buu5(`QHq9=~cunrnnns*;&rt6T%algrw_DjLXb@fph|7;X{}GTtT&u
z9!a{!Pur;Z%@sSn-V1Zyz88DF3Fs2y(9Ku^*Vt2|`_=CQEioFO{b}_z+(e*```*#h
zBmtN*VMqAZh1HkUPq`|b+Dz<J-ovrfSJJgsFZm$dUd0VEz0L%dAA(9xZc)boLBh^J
z--Fv{w^QPSWHvD;R7tn}zNu6IGKCH+k64|_0KM0==xx4)+jclj+ABkpTm7^{&Zs>0
z9)sHlln!s9SHb~1GFI%=oI^kRf`_*r25I})t?BMq5CmS}f4{a(df1md3Ko9b=;044
zdLmSzERYZgpn4}W3Fw**ZDXNYox>yusRXwR%XDsf5hIaw3tviRtz3etewIf2yK@nR
zI!sMZ27Q`_WUH2`9+;r^a?09rwa&=v0;?^$$|AnpbP$8v`W1G8)O>bcUq8)tLKGfX
z_Gd@JnShqjsmS?`=k?y@Ks7a24q0Z*bKs{_Whc%VcE_s!j+a};??(TLH(T5On{|tV
zy>)11OA#9GVjf-k`28ES?Vkz9DWlA-Pps5->1tin;oV{d)q1ej090@r69H9|Xx<Jw
zbrg*HlNnHuu`cvfdGWD0Ko?<?w)264L(mBG%NGbYFUV_@GZt8V-6;C+rNm13AvQGh
zK?U`%4Z<BYxqDl!fR_NKww3!t3pMMeWwBwGVvj48La&2Q+D_&5SHrxgFXVbdZu1tY
z{*f_2HW7_9Ez;;PFSJ2qg|KT+suTH~`59fvCHe28J``;K<h7uUxX+{yOnA0EsMeg>
zz(1Om$cMs2_ff_D$pt|}ZSSrG)kl-8#2VK$AKfkQJtA(@l;9rEy(z0^^^~TEw>-uU
zTZ$eA<5W06kcW0LQ+KFiUiljxIZVTFS2T_`xf4qc@z6j@p#cADV$^qg1c~U+h7SQ;
zZ(r;f*Fd&+Rf$p&+D6KTD;x2nB+o*=xljAx5u65<d{v-0_o}nXQIyU}*M55=LuLRn
z6shU?Q8Unw>f1@`w=3_bAOPS5^$(@l;0S>E0sduqfoH)>S4&S&fPX!U!2NT~KFkZe
zNL3HB1MXe*t&h=P{D%TiiMkDf{{G()QP_OwyfzvDzI0#>q2=SaxTU$wP(HpJc9a=!
zID1J<71)M3YJT3)e6#=Jf_}-U5WqJN02hV=s6GOK`$+H-0H7IkwYRGVp5tr$zfDp#
z0W|;LyQ^<#Rxk)~jgg(nWO9gi$N#Md7)?&T#9O<y8u*k3(lqHLo4xz+`Krv?!KnNE
z>q3A{w-2mO6Lb%4A6NW&q5UehtN!9sYf}LC(n(XmLZ`=$v|GS_X}$Sn>q*o8eBjd0
z)p@0W`K3<RJ^!u1l^?-BVuF7>8C{*de35cszJIaY-g;8v(1e{|8eVGu5kU6h`Ls0p
zt3bb|2p!3@QG(hDCB&|1tVm@>C|f8S{lAyCNmY4OVQ5%n9M7)^*@@AKvB^k=2=$_o
zu+m@gnejOowW!j|t5wPt+C~-@`sHs%$0m0}k3vJkLRHW83xDsZMYXgnukc)o>6iWv
zOD)<tq$(MVYHN`AdDvDKr13QG@#g>i5|H#?s^C$Vro4fom0P)o@|I)!@jQY1!wo&n
z(j8}s%eTRa4_u5N#e_>Kc*ZM@v$@_va{%IcZhWEjX_Nb~DE)I;9#F-Fl&&Oxs>}KO
zy>VrDt<7)cYiPvv!IkenV)7dOR(`m}|1w@)`5M1JTH>JT<~_L7n%CYLFuQtt@5c`{
z)#Vk9gMiGSU0xo{cvu)iS$sf%TVbdMm3nzK&nlIXvVKkXwrUqfO-=Q`s8TF#RY}e3
zk*l*S{S^oeW$?6+ofz2(1*j6W!EYu*)yy;9s&^QIa40@Ys@K~v_@N2_z%Q;_0<ed)
zPZSOuImnLiMqDqg>lzC$oaPF>-*0ErQcHDDdb=WA08d=@a@|Qo^$fMRrKk$0%(F+n
z7Ck!BcWnG?m!V6QU{dl5iVoHm{p+9FB1f&5AeN3#(r0uOOjwWlTvWc9nK-buovT<-
zoVj0*d3CM@_RPD_C3M)och(|V?Lp<_wJUug8~1y9+1hT;w6eLwFDMQTv6b|cKKtBN
zWmg0uQ~R1EMOFnqTgeJ&$Ujet`O%qQle#%wEtcR=Z0J_G$1<G7qjq39er&^Qu=(Cq
zr6%d(ZMjg)m$-;V%gfbzr(62CY{j5_8K!dYgtmy#0aVVaMbbrH=k_cBpQtIqC-qF^
zL7yNM;FY}touoXlmH_}6(0|*g%RVkP?xFqU`rCwcK@*o?MyUr3`3b-~7Gq4Nh3E58
zoO}*Mo<3B}BT4UPi~0P5*Ikcq-Rx%)ZcNPm6UaW0)P2Ja0(wuQMCj823z!)=qk<T}
z8XU8cB0J!$g~wwWX#hs{d7F6($unq-Yos!8!a%fWQCX^R9H2d18M8glqur)6+=m0&
z{X5o5b@7Sze1m8KBH2gkd2ju5EN#GL0mM(C{|bbux74XjibguSUhh^qTj0|XX=&9_
zZ}c~X8d|#G<D7sCqJaTK08v`fFzGO`Zd3o7d}bhxDNJ+m?Za42=re<DracBayJeZO
zcGn#{8;}XbLI_0$hICvi0M9AVf0KbX(soHuZj~B3rJy9APo~wab~_g&P>607>aS<E
z9`2<vN(^tIpAYv$tSi20Ocf#1MhkMRBz)`S(5wm?Yb~76b-+kS1~?6-4oW2O=W!(k
z$4=XH70F5DDcU&~lzEpV#WHKA>GhxzMQ<s%%vd}6RLltb29kSSj9ON7Is7Z6KW5#}
zjX>7D!iH$;yjjbBn)L@Z)JKTA=#pBcUndAQuzP{NLb)J4*P<LA32t<dM!1|Sf6U9I
zz&DtN!HF4%%d}J!Oj`+E22p{gok}IHw*X4+P2;IMm$V5x!<0x@n>GGKj{iP(sPE^G
z_2FyQk_rQN8Rn*jhX+X!wO0S2L)HwhHH-)ZC<>rURh&B#PYN2ouw6j64LVITKMV}-
zq6#llwhs(r9DY-^2?Lk<Mve!%9d)K>AkC%yTaTf>K)s_`<M`i_U{+G4?pWZ91||Pg
z*=^T^Z<<dhz^^IAO@F;}|5&_$m(QL@RhX`5vn#(Q-O0XKS1Hj)CiAEeAE|@*<ILV|
z<NkT3FM21m@*i1>j=)vQB;d^xFL?4pV`-j9hgHY6jW4%CZeI6Fcn`yKQ$jl^Lw<A)
zkToFD4^l{k4z8_cY2b?hW4X`a1QTR37ArJ;I{34Xjlb8x(>VO_x+2>6*b9F8;V4j=
z9JQ~Zh*Dz+>@^4)t{cTg-7zjtdL)I)!Mg_ORvG{7_aNxkkJU2G@GOD3O2Nne<%c*O
zFQ|btu*|BS)e?|=aBx9J{+wd|b?ZqgIX!DaTkP8-1aZS{Q4x!?Qq)ei+&@5@D2l6#
z*qNRFLo&Rj@wd$SeoFK#Hl^&oLlw_<$e^yE!K9EmKxf5&rFOyqziFbmUhaP|T+*q8
z`gtu<fwuH}Z0RbG$>)tWAEmC3T(um7ZT756HVqx#rbd3SB7%WVncmi0`^%|n?hRK?
zcu7AVNV)_JkhEtYF)iEOx*yyrn><VzlOh_fhMdj7f|G61Q1u_rbt@7)mlpl7b}b{B
zsB>c;(5aWKCYr4I4-L8#aFg%+f#6f=YulEwXnO<hqfZ}+%ZZaKB=g#K{Jf*ku#dM+
z&XCgI^ghE>L{^3ROh4l|-M(#BJC+v>Wl<VKL9$NxKM&2WA=dZ|7rt9Cv^1}V5k;~E
z7$!d|X)p>&XLfU>3JA-_9qQ=4Z&YmIjBP5L+f>2>VKWdYI$<EO=XaM_-=p6JY5V|?
z-pFT*-=U-yoW)dk(qCBDJ(nav{1D2x#Vt=A&M|cd*=*OkGge}sxixtQ67PhNR-*1`
z{|}_j;uNsj_5>vMcNPuO>iihSFyq9(CR;kwxbu&a4`CfiI-yhB?h-*+%tOy5Hjwc`
zl7>}u%HPbVJIis^rX`)jPky9PqmsWtVi8EIUF0bxfbTYTP`7}DKuRiBdw`c+N^|e>
zvKKd1m~XXX^IgHw>u%nyEob-VIsyS^=cX59yl8sfUYBSI0M+VVe!wZJ2PqLy1=dPE
z`J_cEYnH^l>cYaH9FaOY_**<a{OHW-uUVeU^Gs;!I!nvH(xX|)u)~Wap5j@!J1}Hj
zmq9HuxaF7O{I$hLUx;I)kcETV#V5GaxhNsgM1nw#cNw}2ZOkzJq(mTxOg6J|NAiIR
zf^)v^=Owk$`7!1`E1U+hBz-LATO<R(A53qIA>B^Yp#XvW&ACn6_?Lo=N(vN=%hFd`
zTreh0AXN(JuZ%#vw!mM8&u5r~`Y!5(s94dUT0&y1qWbmhM=@h~u;{}T&+V03mq>S;
zXTmCo6<AGCFwna9RBrVgoCN1OTi#ltjN*UsA$yEWdJ6WCeDKjmm7g>jX(b%>ss2MS
zOhO>_PS5JQuW333%V(|?qeEOw>M!SRBJ=3SBE+C*$iw*ju*B)H$<M7ve}Zc(z%Q<!
z3q{NXuEoT}P{yb0M_l^xw+(nzsgnm~NPz(NlaRPoS3p`RbDJc}?9AV8`j|YhF3Zm>
zD3SFpy!+;7Ql|9x()i(d+CQ=5W|th`;GJUHysI>!?%`wY41H%bo%CGRvsd5uKmp~w
z=`1;93I+X<*n3Q4R0)-pt_L~btl7xb+v<FfvOpmGn`s$dg}Sxc_3|&*R-tlJ`5+x-
zWdx`d9QZt7X@{iV-w27T&`RQUqoT^WmbC-qM#Zw1Fgo+f_Ci1WY11oLNi-_vGbt0+
z6@Bx*SKZOThEc3Q8(m+a6V<Ghn!>0RhEXTzh~e?7L2#X?3kA-2bYjd4F3rXpxXkMu
z&-=+i(4+|to^O|HWMzPR(@>-cy<+eVI56|L<SNSxT8K~m50Dz?U9y-8;nK>hTR8t&
zwd^bCcGj#vV3>Nxp7rU=#Cvqt$;Y{qcZANuI9BC*Ne=zy^p)uyyv>4aNfLR${W0WN
zKFfoWi(V3iXKBkM&ZtYg@I_CCb_r@#rkbMeez7b${@YBwlmZ*#o2>Tm8rovLRs}!c
zSagn2|Ha7u#)wu**bIL6y+w>+;xvZ?b~46=HQd5zn!eP{E@u_eF>Fc4eKJ5=<p&aB
z;?VZYQbtP&5{vAQE8C%G7=p!sd04j?r66Q<sInb_7MThgbLKKWXhe=7ZGyvjR>_Gp
zcI$m#S-|A3Ub@Z=NHRH&_);kOfwm~DZfwwnE#M$**OT#f@;n2QzQ$B=&h88DWf;xD
zyzCp=T60wSit2|R$EiK-l~cUEQH2!ZncCW!ILE{?A`PI_GN7w|g6Q0cNjX^S9E0^f
z!%wjRfbYkbFLz=YK9i~S1YoVJk%hKJ+5GtTA0IQ57)D(CfOGd26iV_Czvl`kUPQiL
zr*24miy5V5l#m~TU9V)dGb19;4l_(!Q@f{!OIrg8cM^HH5RHANEfZu6!)YYr6(FGP
zYHZa2W}p=Q?s#4f$i5109dS$w4i}s*{5{psz~Wy14Eh6itTTt_J^y3>_>DKyEF&(-
zQII2E4N1rp6-(s|<am2a@G@8ssN~%9?6HsQst`%I(Epn4It0_z0*m3eBl(Wi)XbN;
z->34yb2-nvl#BP>^D4dROXtO>c==B2kF@{t*8cYJUr}wbd|=$QbDpC}J-bpH;e{!;
zUIWs#J~{Wt!h=6=r%_(dW4Y4l>_?<iG3&uM88^Xb>&=W21g%7yrmzehjpIXZkSXy$
zHIu<}qbngjA;_EOBrV<J%kX(_>z$hI@w*=*1#o7<Yb8UYXpzVA&V0;hvnN*$4Y3Sq
zObV3is2K?vH5C`d3w|D5LYl{)OO0_NGb((#@roKkWA6>^OdJHunQ&a_CxFuv(~fR)
zHi}tw^GD?z79oS)QqOgXLT)}`@Dx~5aouR6^ZVyDKcZRu>2<L)nTf~S-hfCIolh_n
z<Pv@M#Btzos&|Dh%#Bbe)N@_N8zjc9=E)3?e_#m%F!AS~lLMDZ2qI@+y`OLtM*BHl
z^9}?(+Z*ijeyLYT7O1XEue%}2mGHwv?zMQ7jj<lNi_L!Oqp3XC>0Hkfver4qU(ZuE
z0r*h|Tl8!vUX*jdigob1?Z{cVG8;5l!#BzBz3hi~(#2n{C(stS=7mIj>y;7Eu#vTQ
zr#iLCx7Ps_W~Y2|ubpRQr7bVVFg;|2{(JtXnC%<!-KLZ<D?v2I1-j?8JQqXGbv{VA
z2;5Aid5UyU+kZo5E8n8%BLvrV*-lJYuuw2>T)3Fj25*ifYSowyYF`;A9EHWh<s;!7
zj8O>%d>x#*?Q|)7%<5W?_}^fU$lMBmqP=gu8{0iUMWs=+JBxSIv5m~{OH7NjkmQ@R
zl3F4}=TxgtIOY!fH69&%=F^CnbUnXo<$t*d^Fw2O9!F7aYq*jhXAQH>#a|K+ET|&7
zR>=RGkn+@t|M1GaYq~#Rw>ON`Ng7H%0r4F_ht=`&b0dWPk@<xCcODsTC020~i&Zl3
zPq+9OSS08_8v+PFvpF=j{q_~d)juYNz~nqIGa*QHGk+ISYLUBiWpR@!LA0s}{I&03
zQch(nHU104Y9w3T3_UvpUMa{}>>|z)cs{s}6k6=gGwoOac_pfBbsn#Ba+!q104<Fg
z#R|zFpIe=M%)&RXEJON440JKSVWKV-cdo#lXP&NqDiN8E%Y8v9i5}e{Twf7`^oj>_
z&S&oSQh^M83HmG4@wPt+rwtuP?XQnI$DCPW%?^7v)9|tmi2mVDk%a$vEW*c8FIIy9
zbzOjq;r&Rlu3q_9atzQ<KCX?_UA%AO2we&PBYs@D)rlO5k$nn-TC{Q=Dg|%zpwCbw
zCe}<m+`&xWPFce)$G*ouGP_8;Hi?yDLu{iP)aLU0g_VYANTg-#@z7dtB4eioWXlDP
zdAMg8ZvTjAcBE;LPRU7~TP6bmI8{}Tgv>QnPl53X-YTgd?sb+(e`$_VFX(lxX_MR8
zAfWF@!l9V2l+60gamF`GB$>YwJ6Jw)vt&hI`tlu<A3uIgDE^Xpwx(WCAARO5v6tR&
zbxoREcQAb2hb(4fDH!pe_`wY{`k9FpeB9!e^Pr&GpD1OX!w3Q#VyW@7D0|4}(51qL
z3)5LWL4GCZL;t$^^VMg1^XFSZf{VS>Tqrg4Q^pP&qdrP;ydmtxJLksKyjO8zh(yK?
zL4do#m&6c}?2Vz4`_co_m`8eSEKE@GdxoY;?6_37?DaC5^M+_MqqMXwiM6f95#}f~
z^&0ZzTk|i-Q;*Nrl9LUuJtqpX)oY$xY_PPtV)3?=^4x8_PLw&7?pT~2H7@XNhq^hL
zo)G@v>z=Uq0mnOYvSzFqUU|;xqnRsBdR@nRl0^TMig@7d5L3^P5aTRAqS<ctJ$*`I
zf$Jo1m(73-67|{|`_c6^;M>7VCFr2jD|G=YnV}F?Q`~pG2ojXSJiWQC46ytmK*JPn
zo(wS~5weY7mHmHCIGiywvoYj<m~8UqOXd=1z;q#SgTW~KO_zH4=Q)p#WQJ<o`7fd|
zoB{`FwZoTnOlO430c5}Ys2<zn-e)%*Tlpe|pu}X$h(%m6Pq$n+-#!^<^kz;0pKnjR
z-+R6fV6vZFR9{)tHvn~<Wxc@dBa{gT#z6yFfICU11mWGKMyhwq>5?QWlZ&t6X%u`i
z&$xZnu>pjS{?%jR_9|}a^y8sYCJtFqo*53MrrOkNXAjp851)8w%n-wp8*ww&+dTev
zRm@SeMJ%gMybzaax6@nKxN`GgR4+{Z=_7XUY5xJ?Xr4tDyb<|!eRbXHgR-7LW%MZ_
z5mSW0S}U2YJtF~5IxJ=^k$wMl<8h2XLK>xJr1h=IhesTNhWvT)-DU(Xt*8Ws@^0!m
z!fWDf0m^EpHL|dfri#%!FEeu6!TWu3BR^g~5<G-^N&O@k=&xt=Z2UgpZD1VBJ34iu
zW*ou}X|-_s7i`I4zY|9rIcawCyQDd5Ib!V;5+hC~1;XI0k)=}v1shcvE~ZBai{4na
zetCxwN5(H&8Y#-*Q!&g+$h|v~?B9=w=9N)bCrkh9ouR}=fntGTmy$F6_58D<utHU3
z=$TeH3)_NKbAN5sRDxJ>Z8%#xi!2H?@8!@OH9}>-IoFBxi{4nFc1@7kUYMnhN~H+u
z>i9P6qy_4ZO86~-%F^&3=2&WABxm8w&O%5Jez3cFQUR;*G6Ni^L%xJ>1<&*QhhZ%_
zjmXZl?rSR*I<r&>qFDs~b?U=~_PU-ohz>?%?#;lUsWsuy>t#wtU7CmE?D&vgw{I=7
zV0^Sp|AT@I#k*K`zQ<=91lvpiOviP*jnpB3T17Nk_F}vNBM1_pI|ox=W3Y)I^E26d
z`ICjH%W5v7i|AxS*aPzLOks)9Z$daWYf4hT2jMd2u^m?uVFioLM#)RKZPG<A^pE{I
zZsabnl@YP=;DM9_(cD@3x}ea{#Y2~BA$uP1CngU27T1a1P!yX%x9qoHh3{fD4y<%_
zh^#cRH!*-47ewIhzrm8%g65zMk>mXXc4a>7980$?H}7AJ7=tQtLM5%7WYU?oCVV!U
zqA#~AD?IwscGc^?sYjdMG*qn1`nqy2jwie`vw`vk@*YO&$qjcS)(&CM)@w3iRNQaJ
zsNOEpPOhGvSHU=bq;LJmFniZdxD%!blhmp0wjC=(@j!P=O%289h>Qc4K~6Y5e{mS0
zoN#4LnrFk|9DV0<Clz4i69CZ&U4_XQyXiqQPG=Z11?gHMJpi)ZRcEr}AAS*SQQXC`
z!_ul`CXfV%CXbE6e4n1EBa|MJ*{9KaT7iCjaHe2(XDU|L4dBqp$hc;grvDsgh8?FO
zvwVH<Em%86R|{~NT`w^!rd%!aPB6)d{Q}7xT^K(IpyY3t22WbRJiFtU(0>_^=S~eZ
z<-0ZiG{O%J-%}CU&QT)oCTrgKM5|^$IsY7LRJzqwaHW>uQn^`PKh~p8K$fvI>l>^N
z90I~SJx|J(S`tV?(t8*4SSSTGnGE36K5PqyMY@RW!+(*OIFYnppUt`%b?Qypku$i<
z>}Hl~RUkLa-bX9f*Ol_U*L>SiLF_<VqswTE7NS`?K6RoP?7iuGj*cr@7q@acG>KZy
zC<uG~?AR$HZ#{f4>`LY7u%|cEcf<G-48ysCJ#_0yq^_r0hdj~?ZxCC56uGPEV_arq
zk)-R161mmIkGy~gbfu99tEGgGkeJ{0ZnJ2z)~$S*r^uUsaN5h|7%k5@ggTiJs}E&U
zuXJTd40oZBVob6Qmy;(SPQZ}YGM(Ay;veSMC}^ku^kd-eKB&)F#J(oc{I|iM_)SVI
zL&eLTHqDGo1hW60D%S2__e^8y-A*##20d&bLL^`A!`Pw!jd>kpi$*f6#*+Iz_);w6
zf%WL4EF81O_Z?}@Vw+yX5T1_0w;+ku=6;0{_KvlX>PJO)WP$M4!OqMB>;1j#XMa&G
z_{7V&<+&9~hc%+bwn+6#89wJ;aN56}u9JGY;J&Y|ZB@2w6ro(7;AB!13E=$CM<PCK
z1oCO}sHU*2S$ijY6*-cJT<d+D#uBV5D~dY=Yp@a|T#~5U8`<$>dT0@MYfV==2`U5O
zSjSX01Kb+w9Zvt?8%{1)P>eyxeqroD+hB^1*2=_!N<n+KZ02DD;LFyK@yZ5*9<BM6
z9^|yhXgj<?I!ljwfJpO0y*>_$T#8dGCsR3`MJuoD%KV7fZ__L-b#atDpgkl3xv&8@
z$~Q^+(imv!?3i3ZGz{zAAkDsRh*p~-ygj(h%`7S?wl031Oh!VNNVbJJZ0T%hk(@8!
zC58deq~w@Cglr4!yCw&WMiCiNRQ-q7H-z>_`(ItZPO3XP*7GFya--g^P7V#f$|#M!
zzZdaUXBL%}MQO9wiXb(lT!#1|_Az78X4<tZVdoJ|ry2Ub5B9f6RuSrluFOs4{bOA^
zA}d{l^Y9xapw=1HRUzGdQBSZgMVxA9k_PLetC}IAz?F;dIwY^()r4g|f<*}=dKLj-
zn49@VB35DV^OGfw6I3W#$2*aN=b(|`dc`pYieGXN@Wa%r7{gS@T>H0Gs=r-}Sy5J`
zn4<8QvSRr-t#Vd&F}fi)T$*`4-9W4%0BI=1+dL?Cczo(xKDM*2oz{zB87?I``KhEN
zK~G#vh(?esS^LK>uM*f<b6Rsc=ac|m|1>qvKt`q*(qtB~?FqpBp@Ri>5M)%MOAhCc
z&bzQaJ<lWG=ZL%*ve>8Op^aUni`3<jY#sSouR<V*5=eKsf1kZ)<n!--i#F_(CXfqo
z)Qf+$_ooJWiMM)3F=E_(7`{k=;XmbTVc?U}bLvq)n3*)kVbj{hAO|f8ZE!;MU3{id
zZ5rX-9vlxCJSHF(q4Vzm8h1?zPqDlzp);^dlos6B3S_%KLQPRw{JCxeJHS`=aYRiG
z@9_Rm!mK1W<VcIc$&P<$Owp)ANbV5+rhn#vN>(a!=w6ba6W0}q5(ZypyvYu*{;%qU
zc-m`XK;_veW3Xg%6sg-E))R2$MvMHHlk<M(oa7!Hl(B-;yH;FSXw(f%O-gz2w&>$9
zNt8NhEzN@eK8AC;m8yLtklc+R699>aHpf{MrNHDmtlRawjZaA{a4MGEkvy`X8!Vgp
zV}?(|p@_D)?rW6mmw33bKx?;KN8q|p%tp#z)gh1fy0AFWl*29RQWC*Dd=RQR)gi<O
zful>mi#(<xF8++@#UBqiuKe=NL%*KqiX>^lqxG-;r4Pe$^Ev~pbkJ21E<6uoDQghx
zMAY44K6ttl^0fXSaE%EE4fwcLLgF!yAY_@sk0y$jsey<<4?!v8jAZ_#XJwsC(A9rE
z`eT{vb+3U%G4WT4{lyF_B**-j(Ut3#Rhd_?4%<RqJfb4o36lAKof>lMnOzL)w_!X(
z+7nhw3O<YSauQ_WRE{;Ir&={q;5k||Jmx5j>ID-YeUBVoiciH*3h5&1JMyoy%}|~s
z6rgZcaBb%z<*+x-7#r&h=&Ozd^Rjvv0-hX~JcVi*a0LCyHS$j&SRomvLQ)qlQ5p+J
zk|z5ASo!XYFNist&NWi9GB!t9(P#qxNba^i%7x^oY%rJCG#c;VMKn~;FR{^%)p$1L
zvDudHvI+s{sfoM1t)&cX`|!sYeDdA40iz5Mdh_LwPwsms`Mr03vG|-8lGea8FAXry
zbMX8jZ)3)GBkRBe_BITqJY$PQrE5Vhux3X=XgL{HQ$c7Y5A2*J%^Tc!(nXUu&ac<=
zV|pSSi-Q#3b9N#>Pjv`2*5(&|SFBA4^k;23!xvf?y(M9?{Wr4&BFN}_-VLHfB*OQO
z@bqo8=+S@k!M{yc1N(NkVa{S6{p+C6cb;#-e_@d&Dbv_Hlze}?L54w;dT~j2*#p3i
z%LN7l2psVFKyF}&2qz<|cwl~e87Ck3o5hWvY9s@%oPQxiARTr0!_Ybqk!0&Jo~t>$
zj3)b-PPbg=nxEhtqd-}f%IoTAuC?OEC1m<A&-az3vPPrKCT$BxNb!+N*PZLoQ$c$G
zB2)J9{#{*<0ByEWc)Mz3=_=>*DvXj4yR^(yUWpETrJuy|9tc=a=1Q{@xZLpGf>H!&
zI5YWkhT^#2)jetG?3q)E${;2-1vB~#jO{RS5-4ryilOW|Zyg)BSF<~BhTAx)zR<YQ
z9^t%>x$)M&IE4s1St8w$eZyIrf+;WmUo>eC!L`;yYjP{Wupu9nz}{P_X1fJm=-6mY
zhU&k$r~;?u#5&%eK>r%o2Mm;1ZXiJ+@$au5p$VuJSLC~P6~_qF+aqbCrd8-8f&y3V
z)Ci@#0Wv-iybt{&GvWx+wH>VZ6{b?YK59GKvYDtDx<v5cNU#l2E4|&)DQ)_FykOxI
znyIRV+hqeYYq*f#rv4c1fN$tE3<7_dRU6((OjH-FmTLmIMiU5pD&_q0_!kBe{3#_N
zOf~lQ-xL!Q^*;}f1aYle@D?sS=t9VwZ20g)wf}_TQYaXNg4F_*S!xpPTsc)5&_tu|
z^xb9`xFE;f66ukU=9ck42@DeA0LVKPTroLMX>;>)F+x-mLpst2kA+)+j6~gT@1<|W
zMj9M=#5>ciDb7Jx%`KoucS7uMuV6u*>_4?&Ni<&efw|q>G~4E#!gWT^cn>3eh7J<0
z^Sq{HUB?mOqk!*%T4H&_BHf{sl!&`6j?2@`2C}G}KKJz8O<fMty<#r`(uTgWb;y0q
zmMpg?AfE5nc`QUdra+$3dAjV9!=>BJuU~Ck|MwJ8kVky^){h}JPqODu%jbmIf&)1b
z9WCmpKOYBwppWvA17+9BVl8ad?5^vB7}x)MDZ_MkJEq>d_UX{*hCT+eoIl#s)v2V%
z+NqRliB(cG2j1TNAxop92*1KbN;&@zlVGssWGd1KU%7~0F;`tYyk`mE-d>VH2bbEW
zpe9Y?3LSInwgjI8Eb~5a6ss`d(V0J=)jwi1`p%r24P?@}GT})Q0Axcea^XOr4nzkE
z00E%?!wslj2K}q&{v~uAj6Z9w|7Vr?r0wNP0D$_F?1%797VQbm4c~A}$RXVE@8eT=
zbiQ=8>HVu-)JTxa|9b!bjRycw9n&p=+r#jd7H@a7bnw4cG*PdwiTeE7#b?j{EnZSr
z?9ZwS7#kWF7>r-JZpow{@5JR(q#7)*#8J=kb5sHU)U%*LDPG9D#V#f0U_;e6>kiIn
zAtmqU1dp}v$F*)2C{0%($53g~B;whQCgt0d{ZX2N^!^mfS1A(b8N4dW>k_GgVT{EN
zwR>Ik7j1GII#pR%y#Rx<-JgOb_drgf;fAJSuC!F&c81<iE)g!Sqf&zy_pl?0u=yN>
zCL%N9IcD(Qh7j#7Uq6nBx7P+vM|ark^j0PfaGeVCN@O`}7f4KQLUXxcf^DaAs$~sf
z43fpx2r@sHkMF*D8x#MlOX3#y-KQw$1Tc>3>wv4Bu23?T?#Fl8Qd$NP`ITPKSoi(u
zT!pl|N!add(##5C5gRc-RFHFVN?ouh*TewtN5zG50aDH0bbWptz6Cu;{vi)+n73y;
z)FJ-zZ@%6yI*42OtG-rZBUg%F?D;H8Z}>+hOno*1kiz|y_$u>IeN5$3bt^72G(#Ag
z57t;K<3IQa@9gIJK9?4|L<7CsmK0I;)j(ub(F~rdq{h6bBZT2|4thlG1ju?h&$;{K
zu8%--?IbM5KPMzO1`MYVWJay)i_?zt=kqqN)DbNdayv(duZAb1T&CqBdn}_j4?{zv
zA~PuBX#1U@VEM7<^n}c=D=o^P#CHNFQy?S7kAd3IBWBK*cDeOT75DQQGLdbK+}{`H
z%D&Qq)3!%%GZOR?LE5PJRmjaI7v3lxWPFG?sKOfEzA88CCZI$jR~H&39-*mXf4#L7
zd-H_4FF4z1qe!w%q)x$72S@eBS7x2~SXjteZ{)T$-JJ^AUDPJ~Q}U@LJZ|j@Wy>$|
z7HyGg&J_I`0Z(b7bOC}2csC|fi@1x38-9P{dyDsw!#^?;@g;jk=vNpU$jxvSrbe}7
zj`%D4D+X>7PVpm2duy|)vm^Ud%6LXRlJ0o8Pk*WGELt4ByM--gAY6F9Tu-+ydEa*T
zu%VzNUPwVEdSs|+<m0$X{O)GuQ>2=g4!@YF^@kRb+ksnO8b)7mbMUWwSC?lE>|lj`
zob0#tAbf}V(vpu3v^<*iem>aNzt5Vj%l;pS#Ird8zOtJCC{P%_0F&Du>n96e&Gr7R
zM*i%IJim2oCs%}L4kSixx#{WuVQZcT%vB*k(terFW5~e{p?T53o<73X4hub8$JcFt
zcQ=5ge=Cc$(=N7ATW_imiq74x(`%^@Z{Q?~y4=Zlwxmvq7E<(d<j`F8*Iswi0XWIX
zMT%S;42^ym9bRsxKdW&*Ym)n%cAz1s+7X~AUw@mue5l)={_bH{h*hRu$kF|DNie!n
zBB|cWgRVys+@oZb5NnW<B>_|IFA&qpP7cbntR43d@PgJW^m?g4mI}nP-u^*!UZhH{
zW|1TwrRiK;K2?5nB)~`GgvB$}1;74h9vS~&@=JBVmZ&SZL(3i6n#i2Hf9qLGNC<^9
zmn~l5N2LCt#e`Luh@MFKcD>GB)f>mehd`mE4C*0Ng1n3IUWp8{(0HLI1J9$bd7FuY
zUgx16Ijg!27~9w9H*x#RZ{TaD1w}d9mI%8tF}Whn8dKtDd|tj@%R6~N8jLFDdy{4n
z!Mt&P0@&|1AXUdxc+Mxs`CuAc|7=4|X#@Yhsme`}s%`npV1T?ZMq|}W!U4mTnfb0%
zhzCFoqB_?i!_vmFZ*wk6g4R1p(p}OoY7?nmob_M$lEWc4`7R-nN_%U{+$YU#7{Hv8
zGu!5c7)!UN;ef}Rd0|}!hSUnJR2V^f1EUVupAoG<YSo%Q1a|9n6|-Zg)y;0ytz7A>
zX=z<E8t|Zl%vUL*Hkx&KnGN9O#LtC)`0*=Mzd0<Q{O6Nx^eiHPZ5kS<jSYdYGaPQG
zK%@K}I#@PLZod-17ljZAn~phOrM*L}41Nrkte;7$^vUvweYf@*?&jpK?lU;cnPJG6
zJ2vhFKgD{cuD3-84NIld4_mism<F_dj<6hlz7{yA*ktSYT2;RHs5D$d?hrrUz#)2|
z3+%DwXx0P5&VT#@IKM{~?b2N+r{)QzOoK1`bsq=)RXV65hS$!T(7z)_h+VQvAkq=V
zS1A7b$xK5b1Dt2#(QcK_J56;g?6e;MUK{$BkqA0_->VBirS_rI(egHu#`(ctY<1!t
zjHTGeKPjEb_DE?z|5dH1(Fg8Te7p+CBGjw%ETbAqZ4ak2GpP>k58>rXYAUVUqpV*-
z0-a+I>!qrc=@^~7xBp$Pt_|S3CeW=xjF;UY3Wp_lXZ_l6b3rd2SD*gS<N1^D;L@u*
zD}Nyr=M;Z-^KFONW1%w~`{8eUY0)}dsn=55J@5W^AGDdQM|rl|z8ZcFK4YCc^*IVs
zpF98{73(GJrI4{6Ixml71_DuRepA0A=>ynax4vCbOtrl=YOVmi)!n?jBBm`I<~lj)
z=$x`{M*mZ$ryvr0dM8nThA8yI@lmM^a?^zdEH3o3AD5KiUi5A9!HEzfJZJc-!2Om5
zrc4gm{bvk?b5>}g6Fg@(;W`p0)+F@mG>eMayNF4JG^n)24sIn3dPx32Z%cs}k|J+E
zo%V6SiQ0$oA&4G)(_a3WFR$HiqSAssc0_X{y<C}$=ReD(fw+tSlMJjW%14o%5CF>t
zZ!1-zS?W^g5xt($u&n_!o{laOUeALl8NQw&m-rwJm%5Wz(i72+%g{J5<%k>9JEr=f
zb>#^w1*_4gJyN-M0;A?!jvST6ajfjgq_f|SnCYfue`(TvEk8asW_uKE{pJB-m*4xv
z9k)-;WNm4yT&AJddl&h9Tn7y)XJ0fEe3Q0?cjPliZwcjzZDn~L9);gpS7FwCKz5>o
z#hOosin!4)E-DX~{kI<VG=M8diL-;HbgT6~lf9`$w`?LC7%7Vk;sI1X{N>p7?;>s3
zh0@|unOtF35IU9buaGZ9wNXv000506Ma}POfmIK@YzRzU%C9Ui4GB-$7b>yeOJ<i?
z?st%T4ZLJVKU^Y+F1TAmwUBau=RGo0bN~%8tNxTYK4R3vhn`(1I)?DKBW$k{nvY1;
zB>%u}{=MEseX@--T7v?^KqJ{@HIiVgNy5u}t1Nrn$P3cbW0y{x_6*{ybOyiCTiq?+
zA;EPzBN<8Z%g)p>XF+-zTEXv4BMlSn<ROvjb(JpqPvxY8ZUd|0#-o5r<N+@_KlVW=
zJ#3{~<2OG(B#m|Vru^4!JX$aE4x@}n0P>X>J+eo_xF@6WFyx-eY18|9=?d4a^9&h%
zdOc&SX!fi^D`78qY0&Nv2cPv3Z*HP3vapZAR)2fSPJO$H%VYwTd=!cVq~@Xt&8B@P
z-;Y_D2_e-&<2|#55BIHNb61B~Rqxp<XVLLf`=lpziLm$k(WTssdCV9)SU=Rb$T+M=
z9p#hitQ;grRBeC~0Q;I@JO4C+$}LnQRvj;>QxptIFI2NQ3P?gAw`0^v!58qdcv)XR
zjY8ESFNxl2-FAR#a~s27ZVp)&B!C;jz+=@%6ZM(6UdKr(7q$Ak4v+N|%lavy?Z_uJ
zdjEwmC~PGxhD`N5qvp#&e9Yf)e23gRJSTO#y7Ws;Bx!1|C4r7+2JrEy9^b)v4Gn`{
z6O^0pC&aI_^CWjP>p_h62HNXDO{$u<@yU7qW7o!7%S#MTr!15G#RLy)v>dwSORuDW
zLSv$tzTy22lBgVDB_=99fvO^hcDAbalvE9nw)ms;Ve_%Zyti@hk<7ANEcdCj<j1t&
zsEOMQdfDnsYiZ#=P%zT|`!fUAqvHgHMISFE#Ko6w+{{6nkb8A3Go_C^glpoQj;Fa9
zw)3*hLfy%Kjt!l@z3!r9fuW(B${AXEXz}p$EYl-cToiv%JAoZ=QN{^$^PD@<bpO%*
z^9T>b77q*aiw;gA2SUATq(yuwG_GLl3q@CU50_<IE5B7p)%f~a)`%Ypd0p~rtdlai
z`)=>r#`i>{<i8-@UF&I{Hnv9ju|&@-(`5j-lBaYbqwts0jjFp<i9rd+6BO=R4{*)B
zCTqP8kTYl1VUf@mwanr8hKM9hLoAK1v%hgk)pdO_D)JNk!=I^){y$@dEDb*xrM}(V
z^*n_mpUFo>`Vums&+o~IL=xQ0TETAMhz{vyh`*ItJET<v)>=grK^gy+fAY5J5=~#+
zM%^#tt5mj4?$wooeB9R{pfh&`4#}(N)JNA^1oCS;`I8<=AVof(0U-jew=fLJ6s2?0
zY$(_YHZL}%K?~79H0VrVh#nJNGo^2>an!@h;()(>XW!TYr_5puZ<941|N2jT9qFG@
z4a-8>gl)P9OM~64Y-Mj;+364rnVV<M3%k4F$uMtA{nKq#K-0u0PNug2W4A^j7nit=
zX7>JWyHxlGJ+hJvnZBo~xwuUJTPR`ofkDCn`}h>8o0#+|roG|tKq)7$^CoqF@aGKx
zJ{$R6Pvi}<>UkCQ&3UT$rV?w_twZR-a`EPtpf&vHKe06y-I1R{UrtPaIhi#Lzj*ir
z3SQUNe3=$b-EKgU*qOOeC8g5vYq-N_A#TYcZe%!mvnpL?=F(p1Nu++C)8CO2Kbp?(
z?#}XGemjfSQfy|kN$=5Ig=MTi)qU;euW&60*qlyq_D^}?cQ`2eazY0jo#}-4<yTIr
zvFNrF^on04Y5qs`SY!0)vE2Q5CPvO(-A$R-M}nNu_z5{Z{<NeK7%Q3I!4}GLGPEeb
z#-8fj`8?fv`|E~g(rUPj=6+%E-}BZTqOQC{g^nW%YeIs@?Eq-KZmB7#WW^yN+$#!E
zf0!k?TWoWP%ak8*KWiL}FI_CH9o;!KoOE>9P<LvfP_tzVlKq#W<i3r`qXBA0&Sqkw
zXVF|Dj`ysfo&$~@X@3*Q8CgN|z1}C%@8zbYAM7@PfjAu8yW*ki9ofp#Hz>RGvzHrJ
zkaQ91p+zJ)7L}*Hsi?gEK&F;%O2cTgblcxCS33DmA))D8S_x5L+ahx$*evPV&xMal
zIy^~d-*0HMQAUgI<4C4<dAo@ClO^kfEp#zfYGc4D5fTG32P8LiKL0a^zV#P2$Nz5>
z!@{tM%U7cTd#mdwf=PP`=tmeH9l^hkxJUV$a|FnM){C=-L!vv}tP7z3`%dUaZ@d;w
zhtucCWIPxRo?wprW82vL!9@;c_)kd%CHq`Pu!4pE26me(IIyPQ1DVPvCMivTx%-Kw
zJyGSLkJQgH!ljJPJL1mdthn4a`<j0@QkNEd9vZDMyT<2joMQRT+B_=Oq)dCKtVQix
z^M^-VEZ8oFA)RvH%b|tL28}07GX7q!W&IxZ^V=lQr~0<gCOVZd$FEEcSMqnx3Ceq3
z<|qsC#z(I&`rm@Ykh_a6wv5_WwLk=Ku=7ey8h;dVikPnu=|q3hkjbQOOdjqRiS{L<
z9l|<*yfw?c#8qcNW1hQ4vXKXDNS7fIq@TseK5VrWH&7E;o<5}z_Ir-~<3JXXH>f~G
zH%741RiyW^he3wfM<z1VOo{n{JkRSlo*bf^wOeD@hkM22<7x~Hr%=Lv!b`~_dN}P~
zT)YZpBYaKAyt!DyGOF*`TCeU6(<CBuQHrODKwMMpuD)K(RtoT)BNmavH=2Sd+iOwe
zL)d3=0c|wJ_kX5w;o6AHAN}Vf7vID&hy{$D+M(jkJonKR&MM())O<?K&u6^Cx9b~^
ze4XuTdRu1QQH${2HI;Gv-7jte`KGZ7&s?f4N6>mcoXyK?QqxrI$fMk5AG5>$Ed}g(
zhIZzg_L+D-?L*%(PqD!2#e8};XvkJ06-4b(Uik5QdZ%{3m*Y^`bT^pjZlHh3E#GhS
zp<)(k_@9ep4d2mFj7wK^B74zXcP}GU?Z55u#8ghq&8Jy<mhD|iDGSG9n;C}A(n{Vl
zN8vu~L4c99)9_0&a#k+yoKSD<(-_h16q_N3Eg1tHc@M*wVt8{&e#!lffx~lzVVN;6
zS3PwjlJ99KG3(8lR(ls9CLFI|`ywmV1<s%3VXWf8h&dpsN=AqO^;9CSMEm5VW0NZG
z%;sq+{o4UiZ53kRL7*{DgVaD2i0qWd&trxUgh@#ZFtCV*B6W_~`IGb*$M`3ImcwI%
zJsvJ=qv32L^#0oDtNh&Oe#$NjY#s(0V8+Sc8HfiO3p&*+8N^=}zk20I`3;+`N#jYr
zR1jZhUvQ5$3eEUjtD=X)NzE*!QT)s1B+R}LeSSFQrD@CQ=G|7__;FMDGOHTEP9P(F
zAKpZa(<8qI|IkdZqYm$HU&EJuxxTR)ynt@nH26o@YG|A$&)@#Km!~0zSJ-otxVA=p
zWb)8fY18`AS*u(zO~_+{XRdPSyNqQgMfur{w1G9{%=?7*g?*9-tuN8se$_;KImWo^
z<+1TNr$Am+Ts{-#LF#FQ2UIWad!vkc;aOCbqpchWDq5o(`LWi{g?8vTOoIOuMduk{
zsKu>4cc1}_cr58g+U0M)*?#Y<@&!(Y<mYA#^F5~6lS$Jt4`mubxy%vB-$1K%E^!KU
z9KnQyCv?39vO>)3a@)eXRi@3sj%=}j)A|_2<0j>Sb}~o1+3Fbd)66>r$qJDLym;rf
z<3_#K4QYDmg(9;uzxdszHNER4_Q)V9Y74;9cq<gKEMRfbM&Zu>IW@hm(tKu3wf1k%
z&2vKSY@lVo_;sNhHLE{x`G!|XaQ{;-E)5=PjdD|Bn40wFx?@lO>Q4(RtJ99tHTK4y
zrE(NUlUHF8mIbNGGq|w=fGAnFi|QD67<!UX56*H^5Mc~Kar<p&M`T{ifFnrl8^zJn
zfvPX5=UM4m$j&x^Vt|7!Il1fI9{T?SsX$i0q2Kz!MkB<2Bf-WYc#wgzb@)NX82s2{
z5d0z-iozcVKp{1x9q;q)IiyyH@aD`Eo$`RsAgejw!UN&V*dG<XTE+x#Fki>!jfRzR
zv&l@Wy_McW6dRDPDuF!A$i)Zcyo|w5FINPd-Z_sK@@5IUmhCa|^6s*04Xx&vgmC$?
zs9;|30L}GnCV%Y4+vaX?1p9J!co!r5EhD@6;PNV4Yct>8u_C+>sjo1}4dl=UHsNRc
zo4F-4|C@w24<z6AXT0`%i18m2oH70$5<~z0gaajy<65V=iSZ%=cu3&AU!DT6g>qmK
z>)`*A|BU<qIWw7%5c1QE?e;d9!Jry`p;^>%?t5ARNO>@iNEO{oh-f3$L!Ug@c1V+N
z#pY!NQvkFCEz5jFdIDu$5#_ki8vOT$@dP9kUPe*V{JXu1;%j)x!{F1FG6H-kTbnGS
z=GVnQoAS<E^sYqw_y=0;#NU6s0a0N8A|=T9OM=+B7+sFpctVjpixtgbqujKFTFz$g
z{VZDx5eh9QiNVzOl|yv&FKbbq>i``w{6>91WFG2PYh3lgPSgR3w>0$Nouq*O7l${U
zNO1rZYWblNgZw9msF4vOKZ3m+B<@!B*bqkLS&MK|Hmo2Dz8(#dqU)-+d0?bBpTZ3b
z|K9la3))cWCvFb+fiOvRW|Rs4-q(%+rI6-c@?*i>@tGh9yqjVaJI|$GWNic#HJ*P!
zG4KF>5{-l^!3uANx%3zeY6LA{&HhVUVXh~eBXOK3FE)E>7+Z?T7U1r0la|p4IG$|z
zj0x-i{0WTMZwYYESl&zEKfzr{5?P6bY!NqsXJ(h#&W*b<3vpePUEP}at{~iL{J~W1
zvZOyhLEFhL8CSRg^KiIzeSX{a`-$-)ympnMA<Q^*Pq`zsfcj(p8i|6RA8F_?##_nX
z4k!+~mdU><DS6#T|EFGKMm6GKyNB4RxYH={^v>(yemQ!)*&^*fFcSQF=i)p-ubYVq
zD2ucOdCHmoIzFT%-;@Fz9tvn_z0<$~^!>pG`S7QY4|4fp8RWLW<cLF-N6>#RYu^=^
zMRG^J^J7-ID12-q&2oH#(OrlOg7K0Qd$WqJ7u5&ZUqA;|{K-Tg_u%JDEgj$2Khu1!
zXc`x=g&y)OTWz@e!_NLBR1$1?J`NdOCt`^>yt$VPoGF(-_S@TTA#n@x%a?2=2#E0k
zY&}e-ra|6GkatNj-!vwMES+&81HNAW@Y0!EM}8v(o+JE7pNW>?5u$%O@C9{qSX`gt
zVsY<}>tBkVPYCc&o^EIq00ZvMvE0;?!EYv$aeSGt^LEo*x1rZ8$yw&aiSG!zQ8jqv
zm|LL&MW=lE-^7*@Kd<5<L`C5l|H9Zfv`LV0IVLa|IGmFhVC#}%`Jr6v#DfFf^;*Qf
zBdA0akLK+^A}6~(F(IOh@cwt=VLdNmj<6Y2(^EerV3YO2Sx#P5GYFHGlUaM#pu3jJ
zuK6-U8_h$Da&l>~ZcYn3q@%;AJ$+pThHRvmC}DVzO&Y501HHG@dY+V)UE}_|Puv8f
z^t-<NUCrQ7!)^c=_5WA@|Ns5~KwHqWxG(cl!Dj%I)rSrGZr7Vr0SjEn`pv?TjlHJy
z8GiTl!Qv-^1$~Kd!Wob89C@!?&?9a$S^g$SbVzJZ2nn|oUJ%(3{CDE$Ngu)sO#%Mu
zels_8ruOe-1ne01$T)dCNxT8ixQ#7hV5h^jNx>CC1TffvHy}Oep|iig+#%()f5g?!
zCP{N(u`ss`p#qBna4lR7)=awDpH^SQFyMq71^f+~OoOE4$U06;OZzxibHOZjU-A$}
z+Vsy81y+)4usM9bW?tf8r@(vCVX)cCL>~Dv9^}LPL^qaH%i2YJO;U>Da7U=+a$@Ey
z7Weog!HrJr?{PEN<CiXk@5IGK&%@OHy}U(|^JJvK0Go=DOrD)MN4wStxT*ynOh37j
zuR|rpaMdFp);M_nxhcxU@g99cVB&AY$jyw?mriTRHxJ@(0$e2;9D;pcQw!<T{EP>#
zxD05C{t>7YT)SXG*6Jis##-Ny-&j4T0?YzsY&K(oUyuwvhSH<Qzr=;`(oCj~PEb*F
zJ!Frh^S?9Zd3Y^?7Tyrp{(s>j9f4*(0FU}cy!HSqw=O+6f8KAAV7R{kk59In0-EOH
z9s8_xeAI^8CVvkvn$4`E#K9Na8?Zg=@8SV8W^T4W?S093Tz&vjp%b=#3la)$e85Tm
z0{X!J0C?$5KgbL==-tmIYm4v$*p|--H(mvDpfC8ihJ!5~v|zs%4P^66V8D=V8;(3c
zPrl`)tt>9)Q~ST(??FWkDW4j-RdedDRa|i}wy7~xn5s-wCKt^Kp`HG&u6p@jEAzjD
z6?Bn2@5G1|kBAHklCuJ-w20!UX7GpRK)P!XQoFEtO`qKHF^I!wCuUQo2I1Nm4u>&3
zca5EukLfrn#K**9Icj4m+Ty0&2N(QRa3oz1?ou8}rMu4=zJeA)&}Uz`VDhdAZ5Hfa
zY?NEG$3t3(&!iH&+QSGAXcB>y;7=hpyC@%u$F-8g8UZ9yr6AA%Bs3(EG7`c=ioN+e
z{30tt<h)^%gBp>O5^TN@j#KU=v%~mL|Nj9eb)Rt{n-KL7#~#3#{+%KS)3>y0t@ZmA
zh!1Q54Zh$%P}hGWU=ls1AODHwAzxtKR($&wG?<_8fG2=@{EX8g;&^^7Od)%Kx_3}*
zzyvMr+>s}*S?L5#bN&w~mnK}>_k8cNsF;5jS(!3`;?)~k$s(zN4qr1oygu!H)@ZgK
zA%b6*fj0CZ{%;PEA&BRCKb_CeZOQk4z5V`&L(czKP+i06F({3X<3mCmWpnmtekK;j
zQx}E|IHpo0+<y6=GyEZOB0NgJ#cf}WQ~2*}aCC97=aII1cobqhPcBgwOgamqF`Olk
z#&HGp^GITx&o>EZ44bNXIVHY>@$xgkOQ1;JJ{|doC*&v1yDLj~gdwwPn+6Yz$ZfkR
zD=OB?wxG)eV1)mIeMmEs5a=?{XdEC;KFrU)PZU9cpVPCy4Y(uPetVx`ewXK%Sd$B1
zq0q^MMOxt}3Ffo_m_BVWVUbv66gfLO&NS#PdKKg-IRk}ofF*<9{Lp?7@gRf{c_Y5f
z_2Im@T%aM}CXvPap&Ge6_>jma^#MkN)E$#dk>XTt@g5*2k-HV-)0UtEKOiRAxX=O!
zt*uxH{*RJ#5J$6fkKyXyco%$TrlTPAzs~qTPWuDzS@u6}YvKzrH(GnI>9}rZJJI_)
z=YOlKf^Dn(-SfW_3u{vssJyHm`JWSi6O*cZFu#C~?6dFxx8Jn2%VwQ5#o-I?^)UOf
zx&Mo>AoD#T?SwS}>@PI3bd(zf6sA8n|IN*e<<|*jV#Bo{#JrZtrbU~R%);X^7Pk(T
zMd+M(1|0@^U_I{x6)s1m+bKz$P%u}m`H5HrV}(!2--X-(_k11ra92MoJDFMBWFAZq
z3d~k{a4sBLi3!kh!9ZUZQ8+^{M6x4m9ckF<5AlD871t6N717Dgfb4J)p73XXf{;&w
z1?9&fg!Qb2Z4>b}#QICb>xh8YW+@?S4GZ`V?bMSoPY85R-U_%t-ANFIo5Nq=kHI&a
z!71`Iob`kOhX5)Kv(MG;>EIXz?WB`>9EhB2<66#-5+GIsqEt+Sq%=%}sM2J`y%1CU
z(3&6o5EjZdFm!hqr0?~0aL#WUyqD#B>k{&@X0U}H`Rn9;_?fohD;{}wfBa9AM#l&I
zvl)GGgld`ShNf_@h`n!L++e~k?&pwvmM|kX4E5%;2kjmZ_pgUe?+pPfak$g{Lh$b9
z(Sz=-&9AzYROH}5pO&LSgu#HROnIt6&9Qu#uP=DT=lot|EytCz_pJ@{akFM_9;hqw
z9{k8YQ^o}V0D#l)O9<}MM+t1wfX{KNnje@K&x~pcUA%cvnvNNK@BA=MNyMy^5KX9I
zt^36DC(6;mlgxPiPPjq>-CvtQ@Z(6^p7052sOWF?w;1}<{k=rN1b8Iy497KHFajG}
z)$N9LWn+76BWv~F4vU}6A{lnP@8J<&7`y}{EPM0YO&PCzdWjMr=kvn=Gk>lBedhka
zodjmeIe&wBq3}TfA5lK?67$XG(Dk1HUss?y%maq=$$7l@#;R8Icktq#Ak?8C+kgVO
zE=R`7emlMb;_0mYHMzj@#Dlcj0Y5w8`YcF8i4qopl#?~_aXyJ%{0{$lAyF{=HntO(
zZ<#Xi6@7t{R3z|I%np>>?4|T~LY?vNU#(XJcn<PR&tXLqzB@0%J<tEaUre!_8lXZK
zPxOE1^rGT_SAA3b5@8CBLw^UJ?~AlRTKw6QlOi46>;Hs3aLtxz<-?E~aW8*@UoTT@
zJ`}uy0)lzK?@Rj7%k&p7iQEZy8g>6j{t|G*gK(Xcvh6krJKCZ~S2YpD21pL%yC3A#
z>L_Blt2wWV*2$Ir@}zy?0TRKynKEKtd4j)_URWqnW+HDNJb!{Mj&%uT<M`r5E%5M%
z^|tdO*O6PcAov0Nth^xLeLL|YLr}ooO}~Hot>@S4@Y5^tAeM=i`2j}zA9*69dO`e5
z-T@e@hL&PP0&FE>KnZuqCJBH0OZ(6-QvV!hf7A>*aae%2#RRV`bOIytP3_kjUf2KQ
zLng3f@i7pc;2#}&2_D~_|A^XUmizGR)cy!&Y8jcu(Rt?Zi?}fYMBo_c(bEXB006Vp
zj*o~D#EB2s@!YNW5q}@<JeO(jgA=Rc<?-Q@$H=ND@e$zF^b8NSkBPdLkIwntxLYGJ
zidf8yubGLMt_kmX*q`|7y1&)_8pDcxseV_@2=~{|4e>K!$rJdEgKTJZZ`pWDD3D$j
zJp-8&`@Aq5WM_x&JTQ0aF68CO9dcv0@(K8^cu_Dp5`_4x9PHZ|64`$3k(&&hC1Hk|
zrWT_^CyS?JTzq89i4y~_kuG~(<J*PWz<X*VS<CbZ)*w#<yqNfZhE7i<-{7hN@AT1!
z{kjGp-Q{?5&T~)k@#>lC@F9CQpKc-?hjQBZ)EQ;{p%Y#TIQs@Y#HmBUMA(xI<Pd=s
zZ144dz7@cguRtMF8}$Ia|ABKTV1`e8qyJwHCU>Ln5+94ZjzI=LG=XQ8%DLXhHLIA_
zQ?)&PMc-=?3{80OYO|Q+v5zn2L{0Ef)O*x~U*Mu!sB4%QItw4)1iUc5A~(-z05)ov
z9Zt{x`l3X9p4*<|e7yqj^{2W6-oE4bpXlv(NwNAIhIn1Q{!&9y{vs}XkVNDjwXcwm
zf{uZPH5)J)nK8mMV2s@#5d|E3Pn`v~_*%yf$W#R8KI6>w*AMp(Qy?=xb=U9WWmVtf
z*FWH*(^z*c_xN|iN@4$Yk>&fp7s=0GnTa1i#KleFBL_Ta<gts<F@Y<(BTo~;*aO;a
zuW<z3hfv&yvHk%7;tJj%8sTUEuCE&t5k5aVzuw<4h2mmuK5zcGOO67k#?vBrCe}@z
zL~t^*Kg7m(&_FC>gB40LM=6Ohj<15rCVQu^<jD`j@<E3jHgUl>FaQ1?J`>58;Gdfs
zWySLHIkRw-IS1exZc9U$K!+x;#EhwK%KzLL5DGen{V7-Vys7fWKN~(!$Z87GWE>P~
z%M+jckB9B72H8^gLAn1dKyx!;)PY}}@`woUKa0fNL~H<D8=*LnIu`Spj7b!V0Q3q|
z0oO?gzc@dW)ifT2DggQ}%m`xlJTMswCWdMvG%|M89QNUg&-{Io18BymD?;whSA^Zf
z0N1H^KYZM?ito$99JxLSc%C|Ojt;VN!>d`qIG*aueD#f7(SNyAU*NJz0&OyQCuH%*
z;oC=Y+{9kDt`9GSa-kdw^aCCY!PrvpX51e+{~w?(XZYx6Zyj%_=>@A2lZxYu4X@%0
z0sVR<yz!CMwR^AfW{gu!zri<wE2^G6T!`kWX*_Nt<-EVdP56vYJ$^JYSvA2v1is(g
zWw~!8gxC_WaXEj4C9#u7SuZ>QtH`Ox24C+mfeHKiyYgmasOx+o$Ot7rPN_0^Ic;wH
zt^N|s$8Jma)an6`HI-%My<&T-DhS-uf5e0}PLKw?)QtGS#$3hbcYAwGzfKVQ;`2Ip
znd_I%{{`Ft=em>quvx?T0A{3mOiJ266d&8`{C73>@foneG9r;LiJo7R*qz=AC_z78
z1;%)GObbyH{V~`AR?r*xI3D+0nctI+%%kOpnkDAQV<-2@#28{-=gE8X;W<37H!ZpX
zC}1MEEQ7^Nza#&x2YOB5Y~SI}XLj_(k`Q&I*Xi%-1Pw3J1_CYe_d5Xl&30kMZ{i8`
z-GZE&{<wiY+<-6XqaBq01Y@u_U~Ej7Wm}@BL`2Qusn+6UpYBl$!4K!J&>UqEab5`g
zKfw?>Lxh3bC-{s<k@_e8CGq-sdQSOj)rJqd<{EQzRo=OF<}>bAI-i?C6w_e1%>n}+
zPZ|&jju1nP42DW4;_6aJ`V<7I>ZDw&NbrUkmx*8y9?f`kb91aKq4<Ymxdfqr_(ChY
zNuPX-OH+1x!EYm?b~k^WYYx*J;r(>l`*?8Vo{h@yo&E~24t}|-|Htd@us=>fUb6ue
zuDI;i`CHE#H@SJs|1a)$F|j$~1o1zYhF;75y<8&@y&m%Zg`t7`B0H82%tV_c%RnLb
zIDW%qxjfx>V`H5smdBMBlBgXr^4UI4NWggi%|i^L(1uZK@RlDPTs0C4@<4^UmF|uN
zmLRNTFZlnUT_X-fioc0;ct91vgYes5_$liSB{QIK0F(Pkx9|9Yg14^bO#l8tq!P^s
zZbhKo@jten@w^cVTT(5>|MS1V2gga=#_im=LIc_MhPr=&14whEBCDM^cg+9f7}t!u
z?t6xz`akj$iI)gViMX7BKmYsyjlQpayd?<uCqxU5X1^hj!Pga#APhALAPGM7eR0Zn
z!ZKFIBH#*CiXudn-WcdfHza5!J{d%VT+}D1Ddej>z4_*D6u>Rr4|G}Vm!5FMf0UsU
z1G8FPUu-)0ynfG)+J@l43Uf5zJ2IglZvBEyU`%lJ$Kw;NtR3)IO>{|_|IYA#zLdxJ
z$Yp!H*Mn-^9}NH1w^vuo_yx5-Ja+v5C*rfWpYT_^*5ES!v^jMXbE|oq{)3<Ve)cJW
zFRcgnq8eAMMkB;{j}hWO6D&?%U4&`wC-UC(Blt?oV1X6z(g;8iHDE{a>ze@Fc!xv)
zF{yu(-O}S%*X{_uq2Ly`zLLGr2R8R4BBl@BQ>1=Lm|@fM-kdGPWJym=pkK>WH=lwi
zB6&|fNF(1Rk*6DY-|yU}M@ogw;&Ac&C;%ko)Z6OKGPJ(5u;3kgr(!-ZJJ;3k@5{%1
zbGnZ&^c*36PnqF4e+oihRrjwD*}j1N=CgI_CH-@cGuXC|f(C$p9yTX<nPPZN|Np=Q
zZMULLo(u3+!3Y*cPa25{{a}Cg;&s4c_4(5e&gWd%Bzv$U`kKZ8{)l~B$6y7t-E9y1
zK??*Z9R5;1^&fhm|B?(iVbAG3|AB{moYTHupo!ya3Cm-q*bzAI86ATIVizg~(85`H
zs2Uj$<>baJcg@3be_?pYi_d&x$Al;51bX@D{4%qE<=uO53U_?NFIoiy0h?oCd3Xm^
zuDpNVdf<j0LCV~?CeiDMjKnMao!%q+;Pb>~iJJmv;3Kplx9K!zvv_##0q(-66714!
ze*^qZm)0z8XZ=J81ezek-+=<(5O<wj@Kb>U^6~H^(w*R?QMu6{eKZSk0sGVqhXYk~
zZgeN_piDc@#$;`$NN3Pe-XUMpY+Q`<65^yCxZerDF8zQ`_7D@%5C>lT2zGx=1mC@~
z=GK@a;x~R=g1$)-G~dlbZ1)A^oB$<D`L@Pj*Z?0HjRU|&CmbQXhLh%45WoF}0?iF4
ziPbvL{__PNOUptWQ5o{oAP?jAVZ132+qZxNz=6CDjrH@EgIZV<V*f9OVds5Uaq%ex
z5S}-a4aAwq6jXozz(=obiGt4pR#*<@90UyG$(R(D`v-%x!kPb0eZV6BXIE0NLm6+`
zk$Q*|@tPPT@xGOP{Rq`S9s~KQVza$rHR&0Azi(GKJP>LkE5m(@zvCghHMgjM?*X5g
z_Kk31T{w*p95HdYURy;V^~}E!`Kzy!W_}_Qv#Ih8an;p)bj!`rn1kZx%sW+&<j0PB
z?>EG8bsYn*!@8V6tAw&4L(pZ0`Lo<;iX()0<b8mn*Xe!16KO6*Z%=4oLRSIzFZUYq
z@XFMT%GGdHs*fNV@N~8=uR60V3(F5vi{m^SVWgruhzb<xVGB9cgg1l#K?m<+;FE`%
zw+Jv-3GhzblR(Jap>G!%1WTQa11=xnyd`TiReV<AAAw398cwtMxFdXMNQT_zd3qw`
zF>s9B5<S==Z@&3rVIMSQ5F0H^2|Nma@UGxO)(4uNE9%$UCGo%T9Z>>8J{nI{AaKE8
zim~~tt!Y?r5C6d|)ej=TmhAU6$d0&zXDqz6+I)TxW>DJ938Dj$4GyS*U>RK+Z{s*=
z-F0IJL2o-uP%>sD)^q&tfzQo8kN^b1f&70S9Xtg8vtGQxMzjP>3fW<IfqqMlus~=(
z7fG)+$;r>)laqIwy0yM<1T8O*ct^)-7#M~)Wjp}^_sa&~mI8D92VH-N00;5^g<J;N
zF3|5LgNl)%jPon_%^-bDp4@>=4I}v%GPz-G2NA@TQ3{x7!QEN%Twj_Hp9Ul!h<k_Q
zwhTCnSpp!heGT97Sq`{mf!VJ8N-B~F*XzO_EbBYsnF8x_JbqmZT%D&b17pKq<K)lS
z8~PXI$V9&bZ0871ebK&OiS`P$4WHuSAG`ejtBUF;9iTn=8&hid_rWg&?}*$aePDkr
zF^)ft#v)E^;w7CZ;MMUErmM^NeU?tkUV;KeW@dAoF&Fy-wpj2Hr46V89XnI={{VYp
zEZ71&UXCBXxAEC)Wx{FzLM`bwjoSa<MrY44>>|^F$AJqwFjFsf2Vrc(F@8*k8mb53
z7`{40^`Ac`h}8YZFycM&d=fo?5phScf46`~zS{+jl=dgv)A8I<4u3%L0!DF}Ko)y>
zBscc(YRdz(vpuCOeWT19J>N(_>?j)EUzd|t;xQk|Bo7KN6VH`>a?K7Sgdr<3O)gY%
zEc^~g4VF`c6ic>&x;#!9fLUOuAZ}it@^_}l`n!^e)$vteXoiI)rc;5gCyf$$PNTTH
zCZj~7{RzPz7vKSGmh)r)69b-i?Ql4&=^!cxu;cZ90Z0M>DZ+!0fO_>EcqCzttMmKB
zmw*DAYBJ0vXHZ`ylcK(DSMN7mo!i^<cz2ECyx79r`Z!9x7;|5kuxIpGGya9)I`Vhn
z3k=R6$NWx40B8}kR=ww_AX^Ra<^+$&b%84iSAnk$MOXei1dkon30yq?*y{emQJ2>p
z+c1Ej6z!WVTpD{D4g{_l+#^8A#qHZ2jg<SjJFf7SX;Q6(%+McaACASp1m08g<MD1&
zJ|E+^gb&l#L?ZEp&en2Iar+EF4C>dBJOAbX7Z~Ynq45d6x&8w#>xH)*u1NvtAXTJ~
zSnD0+F8};7U6V~d|9tBe6E`S91ixW!CK$p$>H$aU*nQlaw_smC0LS*GK64w>Ff^pF
z*7Z${toB9Ys6Pk^8O?wsAB*62C=zdzix&uizLC!bikeHtoIP*M%$JC~ed38df&L+8
z<j5Ebaf;=uJ#$u)2uCfdUnX->@0T{<!XgyMfM5U!0Dy92I0OI=0SGkI9Kes6kjBq%
z;3RenR`pb@CBvKk00(wFi$ma3ZXLQD0Du8NatLq&00jVq1%NZaWq>h2W3i6_gaUy4
zdB_H{;XYUZFi7`kOTu1VOx>`IqjCT;0T1W>w3HVekt4hN3SK+_A1u+3+o4#F;0r0_
zax`Rv(B~5J?IEAE#k&G0h2|F$gaDubM0)>!g?Zz$h{gAT@<J|neoir_|M51;qeH+5
z>w7la-*ANSSeE#4zQSgQ>_xdgAMZbeInAHMzQz6juyN3IGJlSbDI4Hz_cUNnZ}gw@
zhzZ5=aPAW^c?dh@yx2?0_lHp?VP-|v>QOhQXaDB#;!WN=wqaOi4S@*Q66fLT>Sz=4
z(IlPmUPvN0+o(p)?f)MjVNJe~%4@y<<{m)PBGPz6Ao+RZ!n+9(+aJ3>=%b(fO%0m}
zsD{X2@K62om74d&LKW7NTHv~J$q6=pg8eZ>@7v#zNurtmh=QNM5Y~15xI=RDEZS+I
zxQsK+=@wTRg^!4fkC)&*oz3|CbK2RSYOEP=@ey+-8JqT?Mh#<Q#O#7=&4wcSbo!uA
zqcC_Lg8`RG=D_kKUjgjr5xFnG5jUzg;E(~NXnG;X00iXrN?S5V|G3BmQ|fd0!~n@^
zOSu35CqzJAYyG?w#q?;etOO1N`#;$nbavXo3|<*s$Wm3-EpL>H9pWD;VHhZaH;uso
zF!q4g9;4jcp<^3P60y|Vc;fRCZLtd)_Y4UezzBN%Mt}Jg2F%O)$O#s$_!zxizyJL;
zt?k0;Z608GHZpR(Ie7NgBlbpIx5DO7RR0VK5kl;?pc}O&2cM(-%dhVFfdT&#BZ&|r
zlvXb)i8xM3bXf!hoRrR&FA2<%4wN8pCcl@*v)>8mB{Mp)uIUd~{mAo3f&&5$_m|=^
z5U6he1OONiMj5s5o8aY+n-I1V!@!$(X<;l8g4>t@19|=>yRZZIo&Z4J{}S!{1~;!}
zU~CY_?Def`j{vZQLXkiQEC3t>Ei?clQuP28;8zt`00;?%0n$4(&W$4nez3AYVpfrx
zaG`hl3jhHDx&Q(I)ZR}GBA<5{6O#>S#;bOW4Tl_eXG<a<N9MFWQ>esS$F$i8dC!PA
zF+hXY?x4WG3atczZe<{r|K2r2MPNV#0EPsURN1l4Qy2UGDH&cV4&I}*nwDV!x$<ug
zv1^hVixuCE<cHT?c=;OUrlX=GCl6-%6{ajiDnNU7_sH`{RWyI`89@OkS>a+n&(WRx
ze)N+e^}<?7xsFn=!avtHGkzld{obJoYoYn9ZiBvP^Vj0IEtFw7k8a<55!goA2s)Fy
zk|&d{9}%#|#<&~E4Zdj6q7}sVm5dkh7ywgIuR;gG46Xk|(;C(CU~Uw%AFzM$O9E*4
zk$^#E!`e2><B3RggHj1?;Z%<sGNJQg3MU7FZQUS-|K1(UM?W^Te3TKy3+CdoA3?F`
zpB-`94pr}3Iajfhn?cN>a7k9YK3s6l)I{XIUbwF$CZsthe&vw-Kdw(0hbJ`2UH<l`
zG%u4M%lTtcF3-u`1ZmJun`4@fi|Vq&0uMKv`0ogqaG-^R6G6EKYa)x+8gGln_vFGR
z3(mAe`0dC|uBLFs6|t=V9k8<|_nU-qfK)J>BODxs3o>Lq0Xo0`2*D}g(NFMfUx%Rt
z1~ABl6C*(Wu_mzYrRA~KZd<B#&08Jvbkv>4-~0+EgmZ93<EB@xwqb&<3~RA^et^H>
z8B&2?6Sfv)T4#rl{AxrK$;)i=!H;$<uMF^%Jq2*vIMstL=?|cvPYHl_sjL5d<uCZp
z7n{b3GC;@^#5h3#>O%LQ(tUjCjd9x4c*|5dc-Sw7;!WT9%OU^(Y68vT`!*Cdc+rs1
zI112$5I6b#a9M0J-0Fmk)TD;+%Lg*}`fKW-eFfuj;E%v>$%J&ELt_7NsLt*pBYctQ
z-=Di1>x8h?lpC`?kV4L>_(lRoxd-xn^o0&!wEJVyk)w(B+9$u_c&unl(Ui(40I%T>
zPNsL!CqOA?61aAp7x!e;ftKZ$mcYz@zIx`<CGcO#JWZSDt2})Z!n`ABKX*Wd<>x;d
zq^n_!nZn<X&2Wuyg^R7`fWX7X-G8|70E}RS{c%(Z9g_qFuq%QON?{lBYS|ANr}u<T
z9X1+8+1L;`aXqvT!*jpA%P;5(JBzZJo>C#EqryD&=u_jW8$X*$k@&1K-s0&$3`Tm>
zdGL>qj{iiq6YKk@zA+r0YWZZXxDa_Ngk~UPxFUzqx5vhAuHhbWTGc=}Y;PpHmr2dx
z?*GHSZetOm$;Plp<uz*UkUbL1LM#8tx*v&#J(ngrk`02Qv2c-(EGg%kJger1AUvRR
zH!TF{cg0s{b$>2s8`|XN*?5guH8Bn(*ClmaAzJal(Ril81lXp~YsoEmUz))g_)CJw
z{MXRkgc(KW0%xoDqhFVOeb1Ly!af~CmB+Rd;RfM%_cP5^cl>A{{|U_WOp|Kc3&C|$
zlL>~K9O3sjFUiT1O2+xP@WF-R<ln7*%*?Rwn#(sYdvuo_s$`5lwc**);YPy+P;1{6
z%rukXqE>+W{lRsnd&&fkYXe~xAC@~D(-;~kiN549ZMgnTId{cjyY_)2@?5Zs3ZkUW
z()Wa_#l>1@DZ{;|zYz!L7%2eq-&~lDHNjk_)AUNsIU$Aj=X>VXVFT}!(o2@6LqUq+
zm`_FId_PB>eP$S??ldz%tBB^KNWu09la`ZMJmUOlKu`_a3-J7gF^j(4anK<_7Oh7_
z@4xt+%2_ZdgT1hy1X(k3`^yY+`|$GW(0=6+DnOHhQad*`)gisxHF4Y+L!HA!2Ox;h
z-NA%exL=#dJK;FM%Xq-bGBaKfbbHpI@0VJ>I=u}4OS$i6&)$H|b*@hvjt+OjtG%%t
zO$8p8`QlDaXvc97)y7_p1k{g<<(Eumc!4jTza2rs9Ft2lyt8vN`7`FZw$%m;f^I+n
z|KcC;=PZm551{q+f0h}DM9txvx#{!PoMfQz$1N+uT$>Eg!(H)&`~-9%8qe0thztO7
zX2hIOhY$b&00001ahSO@yQ}V)^>A$DMy^i-uZ5Z37~R})@mnN;6X9|&9NIoD>(2ns
zL*9Yso`x7Wps5hg8O1<kgmALFE2~tc;d%$$^e@2#48x~ow?6ZsWzA59sxY+!&%o##
zdKg$~hTqfpob2Y_eW%?6-Ym#ic4RCx!_B<rT>K2Q`)+CGUV+Yqr#a6$7$If{n|>HJ
z`uhQ~w|?fv-JaWK&uf3QHa2n``#H|j!21p9ob)bY2w!R!^Pz#LT7{hVJo^x}3=c5#
z&Tbaiy@Lf^_g<*N>+W-}-@SgV--Y|w9e$zMDzD+Z>(0M|{YC5-omYbP8mtv}?_P7N
zuwHfy6>h(J_8Zr))!=nYuR5m#o1dqj+UDpyE{>l8@?6}`mrqAK!8{KOrOBfD00000
z1yZVp6OD~0W79dWdgpbSLD5B7lJcN4&*P2xTlD{+4^fR2*(1+8aF1EPYhk~V+29Wi
z&(P-SJU5rlJl=jwcHP{)`?qX*=e7?pd4cBj$F=Ldzijorv)VnN^`5u1_MXu8hpY$i
zp4<2U9&aE#{zshIy|;G$S-X?JX8pUve#ZTykRH$j+7D^#9@r0TJ%4O_KnJdSPiz2t
zUeNWxKJ*VE=Let84=0#;zyanwjk|a4=-IgCZr{pp0Br++002O0L7PBI5AjeY)@sj`
zT3!2zp1b7<o^<T_dfi?!2>rV$KJ3UX71{ACc)j2GxZ%;8Z@3TM%B~l)#I3*{&o97#
z1Fc?e=psuI!g5EnStT~EDp=$U$jvw=<>SOcC!SB@yox6OzD4KZ2ne^!e#OC;Uw}*3
z#y?2-5|=cz_F=>}9={!eR*i@>GGiE6MZo_${BI^q@ewvdbVbFpKNA(1m5w(~3OM-%
zsdfsuOEi1K@)+5%jfpK>LH_Qjd9E!pkM13SPU#k7xw(*!gMfwjN68L2(1^rf&#1_s
zf89bB4EkchpL!RHfHL;2KlZ=PgpTnc;$+MZm4BXZ1TSvS7nqWhWeENfdaZJU^fQ}S
za;KJ_zm|~nz6iKNb6C-x6+F3$^~Z8wJOezvky1WOSs~@A<cWk8#c`_G(I?`0{<~?e
zTge9r^H^aX6__2U7x;}(N(5~fHT>)UH;!Y%GedkUaN;crL<2Tj*Z32D`?JS*eh}bF
z!dZ|BE+7_oNaC*14u^jT=?V`)mC;ZtzpD(!TB#Z!uZ+Z-Hhx-p&3Q5Dd<htdc{9S_
ziR0~@2=I~%iMEDSHrUEzuJM7B`DcWXaF-K+g}OEMhh$4AxEFg4(+yT$4>yM*!FWnI
z4g^i;4FAw4QRO%>Flm8Ze~QzjBJwZ_b(h62?>VDCj{hyn8)HE@bB~`fXNz81c<xAN
zmwC6#8Z+_fYnM*gcbkpe!520+9tj>RW`dqFuSJJY1Dp&H{NBHi*|$UZ<0;L>SkKJG
zW@6B<it(`@9E|wNw%Gi+ge|rd-vVF&6iNR7%K~is4Ec6N$(!;}GFD9Rg(~>YhImM0
zo?jIo%Y^XO?EYKfQ^9c<;j{El<-HS#<;^N<l5<5dj$HD>TmUPGkuN51_>6&MtdDy6
zq~F6^a4awScaH8P8DB_Cg(Z**^d8ClCCM@Rn^$?guxZWXfC4-t<D?+mB$7?_O)u{X
z`)vMLnf)sADoogpY%({os!;p0!WcmA?+9Oa>XTC+ysXB8Z-im_Kv>K1jFcpJQrgUU
zIQ-`--0+jrtWEHaF*pQYfQPbfz_d0A9&hp_s~2VyXaB}ly*`(Q<lAawqhgbPf4LFk
z`_JeOu1cCemaL{p<c{NJ9v)lOrNvoP@RB%=Cf;^T#f>1h$qv?+n>RnpAVGM^yb0WQ
zj)AiT$eU*$&CT=r#*;k{!Z;)zHmoIKO6rmc8aALg3YvxkVZ1-@LkCy?HwkEtAUv>r
za#c~vFmM=Jx~{i~{LT9b@nybQH<!7k*AcPP=6iN@LTh-}xFczudIN9^{X|Q$ha9)W
z^TKX;SH*KAWgao#bUV+@AOK#7yt(0n-fVLrqb!`0PB9o&#!oDF9>|^0QRB|IPV`74
zq@p@U%^y4elUn$QiMcMYjGX|8HyU=~BMq$F<})vQ4dL~k3zuboHHQ}G@5vR%c<N-H
zwK3KvKbtfeX5zTj-#N>EUOSC<JMZy3zgi{5>O3GO_`gsW)9L^5{G>py<<r4h;ZKTL
z0rA%vh)6p3#q$4}GxF<WTvvgMPBs-Vi^$a#o)oZyiR!E~s8-8}8Q^zW-;syMD(3hD
zvPjqmW)1d$I~;gJJSen?4}sRs#sC6dNEepYS(YMS9>^QwCFH!2W#yW69ntWdfdJb)
z4=i|Rd`yPo%Oo>!os~zkPOO(Ck-hTUjEMT;ys?MmB`L|{IfDTi8HpMpaJT%y!7ni>
z=yzF6yrvm^zJx`j#c-Za3JFa#Ir8z<-w5H2*dKxgc@`vi2~Vk!W7FW+pZ|P<8~@_6
z5cd3nk6);q*0z9S(5(CSPNsYRggE|O<1zc-kvrtt;;4_x%p8ekW%2S8OWcje4vff;
zJaF+E{QVW}zpwnu-Nt%oNqCq@_W{>rCE4$1&Ke%M!9Qf-K4||5$Z)4410pPtFBe0R
zD1QTR`))FF{R@oSnSkQfer6*;fVON_5E~AA!?$QP4U;f9`1vptSDV(0#6HUG@ou}+
zWIKr65zE$_EHFs1@4#*sP(IT!cw2M!D1!Es|K{WM0R-=a-0+eaI8IPq1QYg0Lr}^9
zaq)O&%hyK^JI10V<7UZRS7hX8L;IE=;X5gS04IU+IBcYTJ`~W>1kL&0Hfc08pP2V@
z#0uk1txS9b3h39b2tz$Gydh?PxRe3}4@=BBO_;7fB8zYPSfV^Bc>JCf&mu_@?DOUG
zN8udYkT&7Ok1PlW_>Zqt<NxmA7o_j=Muj4M(jfMJ_j$~{;T{#3A$Y;Jez_!r;YH=3
zj|wHtKd19mfugQWj%23cJ?NK2_(#GVJsoB=bDiTxJY+Es1MBGci}F>7+>D6N2=I5q
z)Cgt43H}qZu>swy$dEG<f<z$C6R9^2j#4(wswRfn{rp^DW%OGN+2cH7-~>M0;ncj?
z_r@Sq@#adweRTEtJtO}Yj>mpAow$i@Mq}`2!h3@Ok%5d}IjQ)mqf^32ep@M+JQpUZ
ze}wDCPj*xh;JG8_Xm!aP*Zx`MR3DN#JMAt`JY)Dz&DkCspSnr%`T1yyenArP^CUbx
zcM)u><0`C7OE5oK33=xI;5K#e2KStDSP(1dKH>{mTX?^&Ob`SD1>YV2@ag|oj)dE6
zXsYR_!#-cnpUKHn!h$aq9-XE57kCWbUV%QQyjDi;S!les+4#r=j_N*lrcj*o<A-h#
zm0T~gfq2KJ+_^v8daFn<O~pSQgxI~|(wN??`{L!B{{VYiN${B#P61nzf0xw7$9Q*A
zR+gdEY)!d@EIsSL6He5>qIxC7(v^uBy>OmKrSh>(4EZ;I!gEHfnN^YajB6g1PY*17
zWYravpL3c=lZ0X4{yT`_Sfxr4Fn~w*-M+u=4=-~VOgF~%zRALKMy!n+4DfLo`6_rv
zh7Xq&Dg?PGihf9Vx*?&!*%_ccfYpI#YOsRvKZ@W*<_Dgzn}1{5719mfe7k6b!2G=~
zuY6bD<1T3aUU*-6SA3OaG9N5%c9y<x8Zz*dh9HkXPudINV*6u*Dn*s+kKmr|vxGU>
z-W2#x%Q+i1#rATUqU&W9P9(XooKGJj+#F?T`SsUa!B%`s*8ijFY4p6Z|0W3ZR&d-a
zzPTiYvH}4oE=^^FUJ$a+2{Sx0^YL7eWgIqtF6Kgb8;rv;oJ}RNu$I>!{m)&ka%39L
z6`sIA9~sv|A-+Sk_N!S(Cf?rx>DPI8it*u%!FjS)t3odAE&l0;LFatEQ2eNT*O)<M
z_)d5tQQRICJPXCtYcFy@(=R4@M}`lH>&8vO0%*<rBj6-oKx}pJ-PZyZhehBE{eOsr
zI6Qi85Z(G5)A4b;n#9Z~C3%+sk^6l@0H+*`Y|bPh3Jyg1!cY}zCGYpJd61;rm*2Z~
zQG+Hc@H<We2`ewmOdrH~<_7>05#_Kf1V!brzUOTT8x4Z=7C=xMsK$iQqJR*iwlV1q
z+W$$i1=7Q~rMB323M7~S%Y_sGimGg;ZrA>Yh@55Mc8qgip25lH5eS4VGs9?W!oUEG
z9RyQ@--D3P$z&lEg`z(=SO5^B*%dY*NWKOwX?}2pY^}y&!%KQ?n1Ld29jk_c3BTiB
z%g1;VezqhBAn}94wSMA<Z`=Md@<5O83uU53AhK!Mh&uiE1lxVXgEiQ@FDv8~;B9%n
zD-YEr5~VDgB1_O4_}>#7Pk6?fzCHKU&*J#4rr1Y6ln@v?=C(v7U-A5s8xWJ<JSus3
z`J+g7Yi`LB#)CHzi{~d8jHG@d#E68ZmM0RtlCSbZPEQ*U-dNeYl7t>4yggY&_(IC2
zjF8U?)*<1R?YPBqW2S$?8>=ZHvY83s_^Z|HH&B2?W(h@L@Q4^s#y99p;%hKviuYZ}
zWC1j=e=b4}zvCLRns2owKP{8yw%Vt^v#OcqYFI!bG9h{#Xzg&7$=MRX9k2)=HBWf&
zY!P{$MM1JiWO#lkt8-5Q{|E#`QYAZB5HnzO4qxGcA~9%^5fpW%12_0??A}6ex{frr
z=H&SQz9J%_q`{ybQ6_{WL7#$%iL(W$>{_lL#-uW665>X1EXlvNzH<b?FpLQ@@3r_E
z0I|wOe8126L;})*nG!02puDgq_n_6kK(7)n9XO7q$a+teznDdxiW)TXMkl}9w)oE)
z!XSx(HYm_b_df++LjGXnS|(>Z{5R3#H`D9k+0-b=07k&k{bK;Bpa6A;QaGPRfnQgM
ztv2ci9naOA<Ll*;46Ekxp_9jWF@`|wSe8=Za1R<83_H6N4!++N<ne(MI?CY)cXRRC
zt20dgG-kN34%~r-6A;@2i!=OuF$(1elpvTf_CjxT!4rxjAy**2BSSW#2j1`Xh$cIg
z!aniZk`B13nU#MWHZCSMNb^P#;26Jz<}-~B_0b!W%B6lHSis4vHhye@0AQTc%KT?J
z7tiUU#%6n9L)PH^lkBvyQvzhY<j=&(Vt3>Da(F&VL^b&M=Df`!C7YfVrQ%0Zu}?NZ
z_oivpj^yL#g-&D55&S^fX8a*Ezk$VV8LxoA70^<P>Qd9#fQUzMg<Au4Re_5t1Ti^@
zc$h^oc~`#S9CJ2*Od{p;XTF2~9TtMcuq1tE?bjx-$E;&I7rMKzuisd!{wE|MHy|9O
z92iCTmmwa<fvjUyG0R|tL1N05c7Fr{3pPK9i-OH9(gtsMeLY@o1GMFq`ghLwh2e=Y
z9_C?a{}3d6LarOC3q!)fXt+MPyhMF1AN=$2d@NBECa}fl4uBcQjHl<Rqt)>OLL3hC
zC_XFt+|YCWzYl+2BkXfqIU=7KCXMUhzrHWQe9)IKGUBB&JB;v3(Br&!vH`il-2vFK
zxO5*&4nYF`1uqHSNTl@ZkDGQE4(bMs=S?LyZ-gU*q7yYnuE!o#0bQ_id3zPta_T?w
zN^HGxp_T#u@{Ix7&7lBZB#_-Q`{n0C&^h5bkmIKGM}&tL3C{|iM}<f7@SJFO`HzoF
zyd-U`+*I({NeIx0@tmOmho_tXx9a|-|28{{|2#O<XO8gOAEk>LgNIqTAP<CXozVWK
zIr(E|&4wo@<im|flKdk<hVeiV>zAKRLICr0sfeGS4{PHU|Hu4w#m-BFPizlxxj$zv
z1Q>q4pTx?4@txsWFR$#`!U%b5JOdN!>)JKDc+0?I`swD~;}bgZ7joVnS>a)eCCTRa
zfQZN%GFk>@Ic!sN)7%uW3iwGtw#di!f^M_CTq>k^?bADiAtQhaJW2doL@V`*g2vR~
zSI-zPzlW`u@Bi;(;-MwV<$tsu5fC~C^I<fG8!>m}umEW2W%_dg&Ti$6{nLQ&r1Pxa
z`0ce62j0_PeedrBm6h*f;Q{^gaFxN=6qX+d`0&C4E77fGA788_f613W5gyay{`!KE
z62k%s9%zf=ZVYdK!W;=+r?0V=2ht6rI#^kM%gQiEeLC=jpB(CKn^S)XN6aDm!}ETc
zfLwSZKc8G8bs#t1?6~yEL7&Ea1s<6&AZfl>0q?v5(hictDOdXj6J+p}*+;=(!CeA<
zA|b<$!6uMt%;YNHzr{%dMv4=$eh?D3z;D}sjO7RjK;u7pBpzdKCRqzkmN;y{i}g6&
z9|jdqE|d7`FZsSqd*8+3F2&#G*Yac7{wMok-OlDCNrlFE@IZP*^uS}#R((Pv>1XH2
zjR9uB7T-T!>da4lZQftwFUK8T54(`zPsRsllTi5o3EvEC*my`{JC73@yQQt_lN*_r
zlLuOelP2rLZxIW3`TBszs=B07bABi1d$E#24E$8lV>jmiiMIy0fbW7xCcKz!%VdGr
z671^}_1m+;AB7pa!oZ`K71)v6yF4XV$zJdtz=vn~ElF}eT0>w<qsXU+MR?BeZps^Y
z;k+4IWOo2X@{@<qm)G`hf|VNSyc@80?~d^zOEh~fBqM@bldOA5tsiB=HiK{hPwz_~
z9jZR>`1udv;=lgpscE<y4gEqQ4UZ6l76ViK6!`M)g%xZ2{aA}Tnph$5#E_Ne(AsCK
z{3qa?@u))p6cV`R({5V-xI#@Pq`<&_AV|&tFS_aIBVJ?}H{$C48Lpkn?ZEKbo~NcC
z8Q<yDrC<=tg6UG3`olMxA<qcZS;*<d!Z*|hz8whocg~Xs(uURq!crOoe1HE4ZHPj9
z!iaZE40xFhb6z<+z7w4#u1ok&KFp~abQqjhAFEE}WDYfEMe{iPL=S7X+uZ?I%ax-f
z$Bfc#utk1pYl7ULXXO1uuKa84tUbw_Ao*kOiRG&-8*%hWNOLKQQ{K2vIv_rH9uyJa
zell-Ek(0v1hlD#?(t#q^g4|wP;gi7poguSlmNstWIQz*PeQ+IiKptR2v&U~<lD**%
z#tL^a&Gvh9t^+>EKEOSkww-7X-p=PgWo-N-COXM(zO^n9$H70B`GgVD^4zUdz&ru5
zA%!NeRk^`e;}abRcq);x6zC6nU>RL2JsbPzSkEA}bbNJ({7p8sPs|tqd}f8Mud=`Y
z%9RvW*}uC|Qj}&lAO3@UoG_S?FB&q$h;i*1zce$8{|Io(9uvoAxJb)q=DtDN!6O?L
zl8BS`l7I06LJ-4qniKy_GH@|_lTY-3m#vK_-oZY2MY=ScKYSi0jT7J@^)F}{_g!WO
z+$+SHAaU8=I=U&j;UqW~X$`L;qV@h-TKKMqB3YTSu4zC4Fp6{~!daP&0w<13T$?d}
zbf3O{O(d(5g+GIy5VDK~Cq@Owj556`;BHE<<LKcfZi8&yp@76vlbc`|dKi8#6R}M#
zBk(`pLT0z;aUNfC^8Sl>Rhr}VQg_QV<j>0*Hu>R%M31Z7$(}{NVOU<p#82=3?IHjj
zk-CQFe|}hz1EQGkNmu)&g$)}j3as$7jnW~8IQI?wI2SrZXxW&5{G$uoVcZM=*v+&|
zPugsY*cp`)RZYGB`3AYTcHu}`5fTcZO}Gs}s=?y?i{tQliv>$`gTyJF_?dhZz=Yx#
z#DwBe+E)T?iz6^Z;M@{00c<%AP&S-olfZZj!^q%E+({wzkz|?dJY0q}Cc}<R@cFVb
z+gS2!q%rYcJsYw!lM^Q_jL4VbuQuaZ@O#2iGcP{aUw4lfd=1IuQQ~h}c*E^6sZ4%q
zd3Vi@iZd{gAzmjUKuGeLQox1f89$-?(g+CPZKxSMbOl;9sQJ+IVdB-*S*CZmNcStl
z)@?F<YsB}(PYREW-T*@)$}Oo0Jb3O8MtlMrEBSwX0FO?C{>trCs{cR#lz%G2|DAz^
zU};()^+%tsD}U>%3%%<R8aMTWT-b1ha0$MTdSH(5OMpkegZt(HN9)iZydE$*#;5(r
zh@5^TC&C;nXM{TYKbOKSwJ#G<3*tsV5DkUpr2~Hxj3WEK^aNALIp$YCG<aaY!(z6-
z0hhVt+JE#poQJb<J?=le2hT3#Xy5<!M%G>|wg2Yvnl_xz;Vvg9Gxv?SN9HYL@st=6
zwSn%WiB4V7jZ~l~SH_)wNAbK2qOVSGd^zGh1cPlKZFg&x<@^h)ai?CXJew(!c)5}?
zu6RkpeWsBztKmAmNe7|_d|up&2>C}ru3a*2`?8y!1?1Mp?$E&R=D{C;p24dK0G=}h
zUjkl16UGM@7E8%;ZWtcgy!OZU9sS&s@ik^T?@1dseiE1vMl=;+9u@1<BVk*C3!?__
z@SfV?e2~#NMilT5n@R)QT}KMSo*@zb{{|qK-I)g))o1^={O}KLa7KBDSco7xY)Q7H
z{a1!3Z86$R&j0WjAh1_930?zW)(jj-f!F~1{V&t{{s50~5PJq9c%E;5z6aqyfEb9M
z-R}ruNAe>>J)ew5cqu@H{$B{x8Ik!u1gEKtlj?=vzr>7;4XtC3yY~bF2x$jqhmhv~
zoA_qT>i2g5JhRj+vOAw!4VC0%W8*S+#fk<<x?)G+|64c!Pamwtn*^;NkDsDUIrM<C
zrylj;&o%*ZP6Mp;`i~jOkRra?^mT+^ws*JtME!Lr+>N{5h_&X;az_oGz7XeyNAmkI
zyU@MzA4K_MNHs}~_eAl<Tz+FUMK;XF*`hFI$-VrT;hI@^PRfEjD2ip;P9s|*CAB4S
zPy_exir;z02?`|5f!#JretgYE;2{gofs2f)6O;pmVsZ#tUgkh}?;G+fz*(dSACI1#
z`QsC9Ik4X}f+J&+$l(~y;9~9pwrij;SlF9-99}kUwsKdtW8oRxvPBaa2{)pv8fqz|
z3mZ6G37a?(^sEci8I1bh={Miq-`uRXh6V9Y_xxqW<E}k%K0Xaa17w83H4f#!^67Uj
zmts6e^6{@(uz`9>LYYZ_u$W1v!eJ(uzCTDk0hqXZ*%jb9qrnp(FIhYIL{vk*#69r;
zd{czX%i<#-?*M%a80N$S*$5K0tv^@t6%W&y$8=C^-wz1mJ229-ijr94!XguLDF5KM
z(0ldC&kFcMkG67nQDE&E`_M`?pb$Hf4Q1ruGS}K1_h<Y@Yi|p9{!A(m+yJjYP`_KR
zCl#cZfEkS2NtxrKj>~6l_?t&Fb$38*jzJ(BEOB*S2U`XlH`W+6SbzWEB)jg={yAZ;
zOrbE`J_mS0;&8Skm&0G;LKG_wwoe}fCi!za_(XpRlqpJ7oBKRH2`$EkG2`egVpeH3
zr;OpB6V*l!2XDSgvZ4#}-#h`w7t%Q_8nC2l<@kIdQ^Su<cLE<7J`s$7gC0A1|HS;C
z`5bz=Ytf(V6q}oQBGfn5a1Jj~jlbOTi;e%yoB#t1BGi4#2Zv$U)NDo}@f=Sr-x-8O
zMou0+v<ri-Op_}Q5eVQu^^(Pc1JN-B=5VuQ&5G@SkZ#gj@6u3d6RSur9jp-{<0?ce
zTSq|5iM3|WPfkpAgK2LW$6+lU!TpV?qXPPS&zFQraW6fyN1y|XnzT%U{FjmgbDmqt
z2M%+1Zq_~%rB`J#6Tm6Oc8im3Uljz8C-{vJP>g*i{`Q&CKQ;_&li-f$Je&$wKzd1Y
z;S9&uxbq2Hp#94zw+F$8Tx*vRH;<WkUevk|*e1reZ#;K*hUCtJj!*c6VMze}v37j_
z!c(^dFTS{WVd3xh4@LMsA4|fpi2mGsJhvIS&HShjvVb(`FeXEIaJSujX1)f)68D(S
zy}HU%EuYtx%C88(g}EQ|pQyO-J^(=f^?&PQ1O$qcKOSLU31U-T<^p|d?b!ImBWdR0
z9<U~>{IiU4hsVw2dgZGsg*Z+_6yz~e!Z>VPoRBGqbDFK>;W^<`!Q_G95#{lM(Q{_<
z=Mds4P-u0@k|LlzjL(E3Cg0tj(ym2aN4u9H3H22}L1EXHBo9N0sIA?Ykch6Z2tW*F
zc*XzvXg>TvEHUktvg9-o*@>Kg&F2V$90S%^rTaXkoHgBF-Vytt6g-OshPdwm4zyjq
zJUaPeg2+`QlO-yUqP5g2wu)>2#PA#`)>y#v(V|l;X#HYEW-et#o8hSvo26Zk9S7+Y
z>fc@SrM(IvlWy`~^MEdDv5!$gQ$7Cr%;vIil&nTm9Ped?c=;g9&kC}T#c|o0nT-E4
z3f2RBRZ7H(W5WmebgDaoaD?!V8!2Rl%C0M$H?NnU{3qBm!1Ajja!U^<C%};}qbHsq
zDJH(wc4!b26EB=`(!1P%1~w$mOS+<CKb$L6H~>exsVTAG`~+w9^8NeGG09D*hgsp|
znWzRVd&Q}V{}Lco3?Fvz+>T~=6^u2+dGkIWJQHOJQ20E&8d3;5qD*?k0&E`1rbZ;w
zAn}pYAoCKYH;BZ382Fi#TZU?Q2i+6Gh>72bOxFeE&JvsLdGGM2AzUZMv(Y?)1Lfm)
zFo$xR9gD=`VNOm)8F^=g6O)AOrbuxC9~nIG6UnUc_j+7)-IYxh#L|_D6!3_IVsm(G
zIV|m!q!a%Wf)@Wg39Dn}oe?}C;DSg-Z#N0>O@e~bPslhckuiWl!C8|a;Q5mi)&f9I
zF-<bIlb?CtKUkWGjM0Qg6mny;<8Dms@dy079LWV@MBfwK>1AUDn401;Lo{fH?iYk3
z<0lB{Xr_iUOjihVMG=G-ZF9=FPIy%CJScy3Pf~K@;RM9Fyx+kGE)U5Z8Gui!`hT+k
zYTWO->?(_(!xNbNBMU)_!U|$u9t&tkh^Ys8o?-|9uLQz-*FkN6o%}#1;Ug2qu=TJv
zc@F#|4d@^X=b$~Qa3%X=#(oiq#zqkkX&Gt(@Z!g%hgz5GrMQRxx%U5(fVu05ggEI7
z&zdYWgE4rXCQm+L8892SJ9u$O4alNP26<qdR&0Oz{XY@;a1;e%4_N~5q?a)v4}w?_
zik!$oTbcgpWVM&EhZF+^)cKpW5_l3Uso?XB)c^mt&_zYzioJ3|GV#LqP4L2sRJ2KH
zfBe4SVoq8vxLXGoB*;4HG7c`2C0Q_^>oh1f;5jB~khbKTbNF#ZavV`y{e2Y{cf2D}
z0tG?`C!Qo}kDT~1g`L~_=0St({z%cC=f4SOn=c*qCyJBI%*@P|3;83s=zlEHt0%=z
zvmB=73_{#jCV5xF62_?B$waK(_~T|y62}hfQ#KUw_oBT;adkXA@c8dHZ8gU@LCydI
zv|x=0p9q8kH3HKu4rl~lpfl<$n_z+c|AyNC3}w_19lwLO;sos$LMBZW-0=8)O#Ijn
zX{LX4;q^0EVxk0s`~!EOBtw6oQLr!-_|T9ly>oB|LHSI5a@&R{`iZz8d=9b35^!u1
ziGujp2zP_A(F38A!u*QL{x_Vsju=n~+pRzL|AGBDJsRS|0lD|fre1FeZVot+0bQ4%
zd93Qnm4@JeE8{7Sm7Q_!A5$Ik!gx)@=J=Mps%2e72n%54w3!E<lO+WvB>`a&pXPjW
z=1ekd59G&D5m-HVTSx?bUgZDtLejL@$Zwm*WMQolwHkcD?MwexgD3y^(X+(Nn`|LI
zKfxqPCPxP&QYn)Y%WRRshbJaA;^Xn&)>>C2kK?&5Fp{oIDnqN`9{^;3lqXy?XZl34
zct|F`fSuXnEQ^|g0SJ}x?{>;dFb>WI{}^V+9?uf1h4mEoU>?tu(eG!Dny8<f6E_>v
z>8YSHSr~XYdmt(M0?nVq45^&@0mLiB*wHEhBcFm#gkcYe6|u~`X5=2dF>_w`5D^mq
zjjQASrf9Oj-=mF)4x%8N0DE4CL<Em^p^^ahrshY^^LI%<H+YYmLBJmU>&z}mQb`(#
zf@~dhnN3WCyptndC5O)c1$YA1LY>E~j*=C%*LA6y&)t4AOb>pq;Q%*pdB3FJFSk8g
zJJI~_Fm1!s$>C-8RzF`}usA(vnz2DJQY%hICj9TjMQ+U~%4Jdr64&<c2}UOfn;JF&
zHmeR-287*&4Q|<*CY}UNZ19<!MqW&tlaimd%g4t5v;zAXb7zE)a2<AfcfysCd;!=I
zGxOh9kaT=znYUn<*uKqk2<MKrsy`uk4c1r1+j<?a;ShjQ3NEHum8nN^vciDL-za?F
zx&hPzM^hwka0FM$znrfNIgitM{(4$e2hjzVBMIMz+y^F_XTz1;hYEY24ixtx!k*&%
ztV+c1yf7=xkac)4RWQfF2qeK0m~_>RKZtNLDF}h@z%}a-O;8jDicd>|Ol1d4;RR>G
zBop`ylfjxX@SFeenY(TN`2P$~R*5_pgcJ!`{IL)1_4sVn+8^_$;zUvW?=}aT;k+NQ
z8>0DPd13+rc>Of$X1<@3bf$la>FLv_T(mriR|#^U9cYb44N*z6!W~SlK?n;s$Gv_E
zv91d%k9oHN_jN`2GbyKt#$pCy*(|3Rwh_&a$T$E92Vem7@X!Dd45$Dc@rXTXg#rEr
zYb|aA0|WpB11%r`D1F($1OiDwU*zw@ZUQ~@d;O2#D86eU!F_RmsW5UYC@PWL+q@?K
z{|qR<;eu%ED`es;5^n^bN){)?_?dVn^aFfqEI|LB5W`;X*brqT-f$mg6Fg51xP44}
z{P2LQMjritBs2dL7)<PD2dbJ1-fr+8w3&BZ;Ptf00rc>ZAGo`wYw7VKvv|;#uHT8X
z+0~z7nK(l3{ycz{7%~U)(>nURWGk80*m(KWv3ed-7%^81^Vo?6jEvXe38Ui8Rl_{Z
z9}_ZJ;hucl1$PVcugz-6k$kbk9DgP^zvk@?&H`>~ERY|~rxwr4W0Px=S&y4PmwKCr
zw5Jez%tHDf;b1j^f>_~G9#nGd2p~4}0DxF{GE^KutHb+%5IjoshA=UOtucB0Ek^MC
z)chka;}Fo+MxOo=6}f+!MTrQO97&BYEF$}B#Ssti{|(dc1jDiO5D{CGTmSOmHQf_G
zb-gn7QSu`0Cl!Yg4p@YCOpCMm&2U|AcyLD0$slih7C>OMK&LQrY?D3!qtUc)U<Ip3
z<gl~n@1-H}rRi!UAQyuGT4xhjI;NSVM4^DsUy{#Xo%6rV;ps7miLXrQr1h9^_Yd>G
z-8C~@3YoYq=*NKqfU4vx$*@s4dgZ{7Vrga*T3jSZFeX-Gsg;QphT?KTbe2i<tTHbr
z0BF;s9>3uaa0ZIHLF;e;4<JQq;Qx-lG#nvf6L90NSa~ktD_niN^_v%o>kPBQ=5|ZL
z?-pdlBAMYiA~P#eEQwbM$0^Gvk{89~j(<VHCv$xUxULy%$~FK1X=D41&hh=zY2?Is
zmkKvG1UJbf4+{I|gt0Pb_2NYAQ#jyA+5>g(k5-AF3NPR++7EyJ5iE?u2m_3mlR+D1
z03qI!W-Gae{B-jEP1o7{Nids${|2)RQ~wbbX>X0@Mf8sUba149&EO<z!1Rv|&<mVS
zYvxw0>kuaz6S|{h79Zj#kA;5th=|##VY5=+tKWP^1dn5|&zH@=#C{1Q2F|bt9_Z7C
zXL^bK$C@JK;F|}cNs&yMVu)a-JqFzCudK{gwXJ&jpr(dQ6jmfwQDP<+S$e9zItUXv
zxJ$8!hfw38p|mqc;SC36j6S*%?^tDeiCuF?{nm+``7Q?=^JI$;eeywu_`I^xoMQx>
z)8=_D<T!Xq0G=e1FyF)zo)YmqW)Z?XBLg8}7@1U%b2kQ2iopS&@gSP1G5$$Bu`w8}
z$Kuf^@qqC7n7AO&8Y;ND@WoDqty3!g!xH$>8p{J;{9+>E8R^SLRr2&mXe%Xuh~O=0
zoAnVbm=XYgbj_(>a{qiM2}UNFixT*Uy8%0Z<PKUhQ}B#j1+wj<Z0u3L#Ry*<`@$0N
zH8(BzxCs_k{K*}?=#auI1rLA3lWA_v;{GNIvHpOEm+ufkk?k$=!3K?~_c)lk9MIz)
z3i)pz_lx51Ed1I9-dhYs`kF)&0-x3K5qbm`LInBu@f-u+a5N^bGfjVf82Ccq^hq))
zM8pYSm0iE`vivx|`+OtVe;?3DF9hBKKzK_Y3{>Y}$MRe<_sU=<7#U-{>R=oGN^`M%
zLL=)EDhuyRINk6Ktne$01b6@SU;d&u$(l^J&D%`8C)M6!W8)&?vL%mIa~$ske3;aq
z-j!d;i*jgBlN!%HSs?UY=16%_6OuS=R~gTV@wm=U3X&0oGGlU#EsMLi1K!g~pFiS4
zcy>z_Vsv7i9Bd=vcg^A0ctUp%z4(R8&3Da)3x-%g%+G6##*9GR{SS=6MYQ8cr<=6^
zoA7z>$Lzw&V-pwaJg{$QZUF<6v{N4~lwf3h1n{2n5Rw`%FFY?3hTLH@|AQrS_0JEk
zJIAFA?>5EH({9k4I-lVf*aKl$qMQ1`{et*(aW6M*!svJ_E{GSzV-UD{&Y&19UL^4B
zNIK?>7w`b4ctrR03AVBLI}i;@WB>5xU4SroRXiTtEC<=LgN_IbF_8VzM06ejPV_HN
z>5~#ZeDCp4Oxp1{2<*mF6H6^X=tn$H3BUgdT3hj0LZU(j@G;_l;~>09tB)WU_3sMb
zd*l2phiSui8g<}*$1olS87vO_T=CInKK4C(a5g4iy)VW_hF8T{AU7bd(7tfX?Rl(p
z4WO>DAqd)lnO|?dFfwbGjqRtw&l8!N8N3r{PlWj6XObAM6QX$_uQEr7t~bd_Kp}dM
z^Pj+V8ceED`_nOts?hj-eGOsMoEbo0;Vf_#A+1J;V3GAZ#?I_6^T*4;G!LLW0JQAD
zOFVD_1K&nK6ctM$x1LXcR`85ZfE>4g-{rjw27iawT(K?$UE}@7>LVH>;T-Weu1ql&
z2d*mtyHUVz(F`AR9$xSR=H%1x0Kj{yJagdx#zs3t1&o>DVWJp-u0`Zq0xL(2XCoaf
zWwr*^qyGucAVm6>TO(<@|2!{*V`E!o2lIES8XE7C7&*k7P-~kPLJ7y@hV)M)F<tLp
zEN_2&o<=>_Hda3fTOc$&hUcCEs_T*9PrMDE-gfjuk%TbB_&}KXqlt+8P9964RRbOp
z{<!Qo^f5~XIb40+{B%wae_H}4uMhoeMqd-p3lA8KT#`w*pOzhdWOoN#ofWM95ZsVt
zq=tA=9U(aUklsjShvmFrWNC?bn<{OwpW77>ASs##lfwbvKn3F;K2csj?~FPC>Tg6@
z_u))(;sS{+=;!1C_3?26+*q7p^1^+*{o&rU?*e^P*L-9=INTsiIOcv3pPIWYNQc5k
z2DN91*EXTpI0cdLpJ;2~Uo|H#cu57xJTr*-W5X`P7E7BmHo?axIBfn9-C0Qu=$R9Q
z^2l;VXnAebUB-8<7mSZ9MFIeNv)jZvh4h6G7%+*h0_R*|)CTU!501Nhg`>GXn>(>j
zxA=%dge+I>nOOHNuo!(U_uzO#T>&1x5rz0t)<8PnP4CZ-PwwxLz5}fP-9R?aR)_rd
z{jfIx7h24kht!pGVdNWc<?w?E;~Ru0#8)pL5FD`^<1xd0is<1up!nJbH8kWAhz=Re
zNfSw&aEzRo?wRuCIU1Q<lZeMheI?1}QSL?j9Ppjwh3K4|PBzTN0y7WnZ~o{`W^p{*
z8&0{fj|$8+3cv9go(s|&g=?;BW1rfH4<ug>i}9b3duJ>u=N4uCLuQi=^K94!Yoob3
zzWHP`O<#Jb9uS9r2wK(=T{7h{(s2#SFc(e`8+MHh-N>PdCTs~_DU9$5U|TVgfA~Wq
z>sIw@Lj&%c>8zbVKpLmF|Nby~y?5Vt{wr7&Z`TBnnZciY5UBwt4hDr6@!tRZAub~E
z5=2emj^ovW;IjaT?#cCFN1^^;&>dJ{A#3X28~5P>?ZXcIz(P0fI~`QB#ylD^J4P=E
zypGMi|F`;|iQ{dXAb3X&fcu0egkWUyLu)*qA~TG@THG(P2>KB}J?^ALOg;I5D%PuA
z-*zj6p%Vip0FSD@-`znbtsAf~^g%>TfOZ;TFYAhf%;9f$zMJvQfO})HYoA=kji*cB
z{IHg!>6-uZ!MB&mtpE0#6+8{BxPAheAU2Hf616~YJ~?K13wvDw`{VK50{3JG??Q0$
zq|T!R0gOZ9JV%J}9wYgAJh3@^xI+qm|KI{P_sa9ZH6rI-l4(Ii2{u%qLiPv$qxe8b
zh|vYbN#KO^%4vTI;T{q|kj>A@O}b%xMev?&?OO%>)<(n@PDm3B<8hw3;oQ^Xwx4<k
zB*3n@gJ_J(^v{}9Nh?o{_+6~j;QM;w=<#g=4((6hZ?vbFQe39{=K}y<&&6z3DWc)9
z10;M6p+qRsKoD{ktS?IMy?b)gM!k0prb>{1m+*Kt7Q_9-d)LB?{*!%w{1ApgTms(R
z@*fXAmro<~2U%+ht_6CK9@Kw;FBDM$>_p*#pd3geh>6}JXpn~z5CmQz1~2-E5^Mp^
z>8#)YQ)zt38UH;vHJfAO)%ffQTEN;^0*kgilgIaNY0vgiV}Ig$;W)-GTh;M?IyknM
z0ajV2ClgK%%*>?x%-CBJNVgGFCpKd>#9+6*RS|fY^M_;|Q`ZUF+8&qn2u;F9DWVn;
zjlxqyvIGnn?BIG{VcOCDPlbaaVf^9y>)q!7LIoA+!aN2*0+UOCsP`6@6PJJkz;rDZ
zb3^t?epq=VlTxy`1Xkj4MnV2xz&r%=;cm1uwRO0NUI!3zK0a7dAOf^cb1n?X>K*{U
zfy5l=;;_LnuYM53e|-3KCFa@$o-k<Bd_<p*3a_X{AZ!3brN3z({(uaR^=;o`1-$%r
z05!<IWSRdw03R8VO`aro|7%i+q-JdY{#L3bM%zFCkYVj8ilZ}U@AMdQ_ZpdAZ0W8t
zqBcki=bBRyPCklhH#+Qa9DDBGySoSo3O_#X_2CFA-hNrE7(_PBERWM?;je78w|GS#
z0`iw9mAphP$&4F$c`l=qw}^@DrHto;9xEK3(r(|x?rnLu@jhrWv|kC@EKDG~P+=yY
zz>R^0We}b_1lwNwDm<el%wPELXaAZ1!V%wO&QZ>qDlZ$~anRFcE()=Q_+|>G=`;i;
z#JB=QY<f*~R)IXoOW+ffYJQDWoU~}8Tnl>DwZpf|$Obuy6;vkCb(^Y*CZV4U;_!r=
z-Z)%7E@BG0Sny~czH9?p^J+jXw!QWEKuGKWdCc0s^h<C8!K8<y0klDnc+#Rpz6bmZ
z_r-YVnNY^!YR`<0hQy2ttjCc)1`7dyS6^z&&A$8Wd8JSukk7wM!di4|*Zy8GKyZh2
z1bW}D_EqwE4*|HJ$H9#4c$!}kmou*w>5v<QNe>P2Ja~88;~lbb_Jjg$@uNG&jQ^Lz
zFq5!B5ia!~&8>WA1kY_SrV`k_M7z)YFadN=GpUen(bvi=cOGJEt-gG{`-y9obw+DD
z^t>T?wdUNU8#cUteT8&q9CV2<f)RS&uQ5-H#&}PGf`DUFIr)TK4r_ytWx4;&0|@xK
zPVz-vt_I!Tj?_qir9GxXRTx`q8`l7MJ}q5EPfTG}ymBJawJ=U}LAU+qjAxW+i%4xY
zFx526xJDR(?<RXmHG_&QHrokUn08-C9b+d4)%)b(>x4yk-s1!?g?CZrPFE_>u=>&$
z@I#A)M0}n)TYKhsQd;Kl22S*tJHkE^I9zeq*-sp1#wil~c>lN(JpuHtivk&Ya{nbx
zAT(HJCyyJomtXObneqG^T@EgZxnMQr(cf6c4<Q|N2K>L{Jb?dQZ(lSY7CkT2Kvl$(
zH3Dnr;eP}#AA(^4%q~OH>-EzPB3b_*K*=mY!;Zee7jr*WCMuI5*po4kz3zMD=9FNv
zq!Q%Kw){^TGxHgjNr{5)5$P8j8wK!<gXjE90s{V61+%&KBJFp#Ur!2r2B$87+pn~@
z=zh-Rhk%_XpL!jHuamXV;$Oq#K4N9iZuR^eZQy!dHR)&zopv0e583hHHOrtj1$uwA
z!jmg3IgCOVIfc!E2j%AALh|b@B{|}160maMC3+ot!gUyDKmG~#d;?}ZU|!r?p?~LZ
z0VTRx@4h?VyoM`4*U|^tH4I1j>hJ*RSl-GJV^U}N`DOUb?-k68^Z)k{ACQjadtQO#
zAG@~r1q6o`qRV!eCF)9fP9rILXg};G`~MdQnd)lZy}yP4J106ESHJkd`Lc3`^_WcG
zB*YP>kAj$r-*|lwS5H2Mk6`8}f+agm;F<g8_z+<jt}AQ_^_l8jNH_N-f|^?c3?Znv
zxxA-;h+ZBhU`_SSfT4?v&`&H2Ap{5dmcWt_1sog!WO-mT7@GIv9;=pGL`<+Ggaz=@
zwl2^gCSar>U6}v85QGb0M30I6##$bW&(uU;04UD6p&fGtn%?0D`$zz5eSB!&-GOy^
z?m<83HJ1m7jKGigWB|x3(UAGSPL_UxuQ(riy|E4yn|bL8{-HF)z-fZJzqBwE{2(Vg
z&&{%#A$es{EB-QI00{8z0_=;!>+QCnnP{Wj2Y=l!m`LMB%3p}Xv10;OhbrOWocXx?
zsH}?|b3FWt6`(II5#f#G#}>Cg6Rwop>u$$w@jh=2L?d`03t$F6f6wQy?91n=eHt<T
zd{2!S#&3$_JbGj~2rxv{KH2JDJ>z8vImcgx`TxQ`Ff=$w!%CR5`=STqai^u?V^m*2
zqr*3URgebnn+)A(5<MDCVHe<hb`lH;&;xFUlR-)xy=VUb{r~3hnTy1D?++#E9uOLa
z3)^Z2pBe{RY!7%^+Mqq}*9i<wDC-O&!lQq~5R@H^D@0pRx!^(C!2J(!*a-dK;SqOQ
zk<suwCzA4bn9W**IxNGv%`E&k=t`9W5MC9$Pl0P^i;>a80zfZm$j`*>4Y{jbuMT*y
zsrFD4_FNzFiI=DBQmtZj&aph)*lfZg1>i;b!Khxtsb!Ew$CPS#7J0B3$aus@a0>my
z>|qb`5&MV+HpyU+2oC>*{r>GU_~|xhq7}b$TJP~6!gEpR46}J4PDpC&AX#PN<bi2L
zGcQIXgye=<b87E4&=I&wG=jN5qL|a<-k+9jZMKK<W76?rFG@DJAm*yTZ~+7!!e@dw
z0E!67Efs{JN9RBhjbW4GFcN+M(}&cgg22`ZGxHn*Fa-hoqKSSaaBXJ~;b#Ii^zQ%5
z<J{lt5+*%}In2e7o+|)DR_S}C2V@?z2%FWvU-6jl;qU(qPcXro@cH_D$DTMRLo-z(
zy)-nvF9g#Z>7h#hOL+eYI73(mw~;?E>JnxHt-DLhch(;_j}L?6ydZ065;08|ud4L9
zwSZ?jw*}_(TyG~dkU5AFUVz`m^gjvF2H`~m8VbLJtmKBJSnGUd2G5jnh5#8;g(l&E
z{kw~d|Fk(Ts33~`a|Q!9@KYTcF|q}E_cZ{|g@RrddVPWZr!&6TB|!5BLO`LE1g0@D
zkRoZxKOUSeodrb#Tnjdh;7Rql<lis~=YcJwXat-+>Y=({gkZ0L*5SrCv5U%M^5nv)
zpA>V-loS1aTq73_vS>G<1L4)Q0Jd3$9r(=CFpOPWQpU|rW@PsfOw;q{fQp&sg%klt
ziRAqM(KL*M;hY^19fuSE_D`3G|L2eVhKOqb{j={e2ElnN_+~GF=0sY4G*W^M0ExO?
zUVa6O#oJ)&%y7sZuno=S{6uGj19xHl;O<HY`X~}GX+{68->(<YysMb?s^^_?5xfPj
z=)phi4c_BGgkQK44RZ;*BR!;5zZ_me3ar{KtWS;)idpdE{9z9nrv^{EROFy*wf`M<
zS_v!c&+w8nv+%&4Bun6putIoFe|}#lAH8$JWSI;}!g^MXt+K8@$v5DU?bnsmp|fmH
zdu#D_q+zU*tVwMlnR*~v8*n4^2l&6X62swv@-$=Se!mEXCIA5-5IF?PFytfAXmf27
z@E`yZ0i-b_f`<Ud%>WEb%^HxW?fRNJ^Z?ihYdgS7=uj)PW`CiNxaa^90VEK%u<#i0
z03ZSa5=<-x01rDJxPEfr3IjX_I~;rjz$@T2KAete17Hz1!CxE#YXH7%OAuUI5P_D~
zhmm-}Vxbp0J7|1im%!8|S*i!)N-6r@#uRWE2Ai97ZRv}4|M)m?py+#?Uo6mcQt=zU
zG6u8k3D@2s1t&uf$99o1h<^C5k$zxYi5i9Dy}z54jvbK+!Bz&^Ov;tp7zcJ$spi>z
zw46ck`>6Q%wUB(O|I5z^$Uq|YYF-csllnvALVeOvLrqI$4v}$HLy?*q%ffU|M2YB$
z$+AD6H)Kf@nlTwmA&EPt>WG}4G%^XqL1;}t1E{`8PPebW(p4M#>&$<?wEzNr!68SL
zI74m#H~<I&vH*aqM=rmn(R{cIcmN!p-arWfP3Qn*W;+8Y*Z0VQi~tLK@En~ea`a77
zOZH@FBT3)^5!r|~7GLLJa#o>9@ptkcwwWOlVC@N>$twR0RdJ{517sGVD*S5yh6TJv
z6QO<e^f)pooLF{#UcGSuDnU&^03j#<JcF(^KEj~}D-&v6{#jDRh~6_mBOoSGZTHxq
zVeW-O)p(`;Fn0bACmk^`{P59cerPI6JnT!v@qIVTmCIXGa_BhhrN{4n-0WEAW?uA%
z4F3ttkn)dplz7LJNSm9ROy1u&DpW+}+C*bQI8LubiR6Of?L%<^R126W-M9YxWr4W*
zBj=BdogHtA(}V9b9}@+9-anB3Pl3K-{?Xhks$2f}aglZc5JwWQe-p=e_`@C+G$hN6
zq0?Mw6YDj%_^2dl;~*B!ef_RafF*aYj{F8!N8Rnd=%e0<k5G!4Yn#arFNksQk5ECd
zFm;-a2w|MQ{xTD1*Z%-lucR@S=41uEMn__3L4S40KcUIVgR?UvTt}8odtN?n%jcDb
zSJd3p>7sm8%=Ss3*xP(xjI~M|_Xf;Y8C_biLqG|%&?ngE0p+;=_{l5?Yx%GRZ<_7T
z83A9OXblXQM-mm;<mIY+=HBG)Ffv|90<IIcH@!OHJ6p1;cwdCDPp6fFeKW7e0N@I1
z=_9o9yVnT#YRljxdVsrlBzOx$y1P%@1UJ<!d+$A>3HiJsXUD=cPD(vGzA>?&RYw!w
zNjpdX8#$0$)5gyRso1M5IHFAR3XTeJn^c4D3u_nI_fk;o7-#jxYNJk=9q&qWtjoqh
z9>B3L@5ez$4p<}K2CXhS3O9dn@*U2D+yQHoC!6@aI_HG^e#*JwnlmNx%*|1^UD)C3
z&0=ek&mO(xt5x@7Xz=_cvK-FiLm*FrH^1<V3p(NM%0slQ^hxbFkZFTWaMl}tcsP!1
zn|~FJVyQ8A{ADy)y#=Vj_-e{VgtF8Smp&syPN^gP!bT2^pzfPfA1{1(Ah<K(IpIM|
z^1Lg;G2#j+qmhz%_(;d8gLpTq9=ylbr<&m(2v~d91T7A^glrePzxen<!R@*VZ~Zx$
zj)Hpho+sga&jscZD4rm<twM?r6z<8UV8WDG=+LYOgZ>f06TnzNh2RRO>~>2Cm=%R>
z-+J@EkLKZ~YC>$lj|tWpHU7wkKbA>PBn<pk65yzZ6iJwwsDD$^@tsV2?InnRHYy{s
zK9{NY{lOl9I`{kM;X6-6Pgg%CRw?;shIlR~kBr`UY9j`mmd1?r`F5@OF*aso{FETd
znX%kP@0ln)=Fr68lxO^RguEkRTY^Tqg6|jp<3*051Hab^?@W4MqQqnP&kguG>5%+a
zO*|{lWr+`0^9WczcXJ)#{}HO+O$`e^CJT>ai)wqV_G6QSP?<MSC-}|n=ao4bw)P*1
z&kqgq^LOJ$$H^T`+q@g$J4h-_lb1`$db0A(xufLI58pgKFUcK26T<m}u4%bq$3_<J
zFxTSwG5o)TJk!g5c~=QW1Q0^>K65c(&$;8Ek3y#iaP)i8aF2o(nKv4YDbCmy{lG1q
z5B)msM8a_YA5Jv2V|e;T-+JHkRPvJq^3I}%5y>=aZCoRa&tPVlFKZ$nLBPyD?Em8^
z9G~b&h>+SB&xUWQ0q+m)8qJ*hiiqDWjQu_G?NS9imNWZ9`JtWRu_^`Pd8G=kp)=Xv
z+-E$r{0Z=m0*j;GVaYsdky%nG4ou)}u7lG5@o<laXIa6FY#KJ>sYzk|!#5e;hd07>
z>QqEZlV>&WWnT%^mz%b^cTR2-r=2D}FDDglo}IGtYhN7((Z>aRhfhBZS#mb|{^LcD
z^+a)bLl6$DMDUYkHeUo@XJ410d+?r}JpQpIoW;AWONg^hPF*^KZZF4`1~?E?d_Nof
zCtzX3Ach5Sk2tW8OS|`*;(kIr;_!}$Pl7GqP8$_W35U82Z+FD+S()w0W#;Z}Z}Am8
ztDk=+-9$u7jOWS8%w-|m6+u13@qH#RThQX=3d4mo2u9`!j}PVd!VpZk#j;o;^E&!e
zHcTSVqP!2Z|0O(fH;F8UnxrF%=a$N#*N@SXoS8RQ#WOZ;J?9oo{o$#nu&*T}ZYPPG
zc1Sc4qm1U>qqvC(@%X<=q)u~lX4;pQs5(HGlO!?Rx^pra=A|N7OA`xXLUGwY&krvg
zox!IaTLw_pfIw-p?uOu%4-U`qJP*^eYA8ndX+XPLxA>%lqv1Ty?`8xp@il=zt3Zb#
z8p}~xdF&E$XQR~yQQuxX^H(|6FC`Y;MM{(kDL^8u)EKJXG4zM2mD*~>gd|{446mZC
zh9~~`@-v{b@o4g>KidEPJxgEKpwG49booa2L3DhmKjZs<&HiWieV+Tj_Gr#dhh=B2
zuUeijAw&t-<<Oy(?ds^$P;vm_z_}Z#xT0<mQ&PpnVZEGy;5oSt90P&R=fH7r9D|TK
z@Zt_2IP!8I5aA9PMaQW(^3L(ycLTnx<0PX5DzYagieN-49rVlJH+uDDw_3`TQ9z(B
z4neju(QHeq=`^H;WExi39hz^DD5Nf&#DIX_bK$E%Giz1Sp+(BEfMi(KlutrQ(3r!)
zn(ncLEbfITs)H&s0mH4H!o6V*DQ4<1jatuKUKJ-jS?XSpD{81rBAe933Td2OY$3sQ
zv#jCR7m|$LZ42oZtOaYn%CI=Ggq1*sXmV7X`41elAe~;VNo~o%^Qx!Fbwu@6J>#1T
zZrtn!-nEcpKY!m?Xy73l&i`2Z_j+<`q{JWtFM2#@nJb**VsoROvyO6XHMJa_Q$xjE
zyb7x2yl>HNdDy%X#gyX7w{fL*?C)!)ly8+?;D{uo0q!>Ro|8b>^J@j13wrWd<lBKT
zx;HEyFWR|zZ#=k7A_1<a?59k&)c((6y9Ij}KVxdCtm-?Y-`J&FMQ+@=P(rwsO*IBK
znojf3N~$!ietuJ**z4QZWw=1@=IPO~OQi2l$h8AR)i>q=dOnOr<=)y#Pi+#GkX?wV
zp@7~PuhjNUIZ70Th5b%Vp(_Pe0047xS30eUdm}jJ_n|JXQfju)<Tf?$T<sgCq;jII
z4m3+%G)>gA&%2Gcz*(cP9lxcJ#5*>vg|XR?X4l&x6yYs$wA|FhB(j45s1Sh&dy|yq
zN<DR(5=^G=32Wq6`PnxOHoI-DlO53WF)~*i595t6yj?jq4|zq5NPviv;^MO1Oc68B
zDNvfbtV-{(-8Q}Xw;Mvr-O3Yil*?0UnB7cnTGO_(GAQg)QE1ULa&CCuE@zI?nXrP2
zv9!{r{R@HFzyJV94ndn>=s&?$71CrS`~zJoTd&Nu_I&Q*Hh{Baz3se&()VMJ3P2qC
zr*xy;;ov*<(pPtY+X5cW{!CUYW@X->|Bqup+`x~s;VX}O9AYK@S4R3@{}Q}JPJbS`
zdp1~^tzYi6Qu1Z~BZhy&&M*JmL?^{H<<lajUH&9ULQ862f<>U>GcU3K<9$OhAOHXV
z|B2Vj<5<K?%tShc_lbfp4bvI%F^j))u{NdT%xLHHaD+c-p4tD985@!hS=b26hL>gg
z)`jtSi_`N~8nUyNTj!3#$Pj{NfY_|~AigDk+CS(1U-A4_W@LG#;G>U#m-i&Mh5q)Q
zCGy_y=KlSUF->WI6AZ>ooX%;;%U>V4`TXmhc#K#3ms6wS2|xcC5jSKwFhoRS_^%ym
zQB!>eVICEqekO>|1?HP`++gpY@%f^cgs!xI!#Q8=Hq$l*v#!oRWrZ0CMI_uxnhUQ8
zZ{Gd4SVG%phAbEk_cTC|#-}R_W~XZ3ZB2ZvzocF_mWy0Q2)IvjV~mf}e}aBZSzjfh
zn5+vC2>5krhgTT@G>^v2{&<^{|BBd_voT@#o<B|OEb$+fHyOeoHU#)b!86{tZ^aA^
zJQtas6`p+jO%M%wgF5)8eeVyhJ6H)jrS61BL;BqJD0%$wg^R3_xBnO^{xjj0_8D(_
znCdWa*CwVU4BlhEBs>)U8M0Y71J-7k!ve1KD0B)vN4)6bdfpD=F?^UERVyxHB7I`*
zI-Fs-L`};Wdz)lvU%b$`Mj~0gVF-*yBKfSHzmhdL_-lxSIU!`XlVfuHB_{7l|A~<y
zR2hfx-7~C-R758`mYMmb`FbI^!EqYq@^bL(*inI02K^IC3oi#>aB_5+*blq3mlmu-
zFNaev`Met82l3t!=5TJ-5H`o6hj(XSm7`9f%fxCRKjNwc>mobPD%KZdxARvu{yX1(
zSg6H8Rup(`cVav5<8FWWi^$VDf5!4dir*O}<%C~1;ivTx6Iwfx60jZPvqBHM|KVB2
zu-WFxrKS;x$MBYsAE_RT@llU{5imMnMBuRa#t)2*?eNAj)2=g0%mf*+i}|SK?<^>!
zPs><06(WW;b~eYT{`s+OvNPi*mDiq--n<O%%qGN{;5*G9__&t*e^u$mAoIU8d?hA6
z4Y0(~{6w<94<+I9N5)TOh?a{sE-LasJmpq4d_=j8-NbR;HI}f>?|l;DGG@|I@8Ttw
zZ5MGFc#T%fF><sY{O8($3d%BOF71c?jbD=S92?pd48fJh@9~TrCCMbNJ9R|KD;I}i
zFvke<5(F)>al{A?^y`9d>R*sfirJqm(Piwhl6%H}O26j9TonLEv_IT8RWLQRc+3Rf
zqvb%C1to>jEH3l^fT;h>pkzdpP%U`NW=NzFk?%HeiDN!SQ9`f#tQhsj_r&W=oBlp~
z$BYtKI&q7-<k!>UYlLt}(>VrrW~MMR*I*NU2b<|y^{g?U{AR;;d&CD=1dr4o-@34%
zN9bQrN1fJ#j>7Bx!@4-$FhI4*95!A!Y{W}sM3ckGTQ8Qg!B!-e6uM(LjQz%r5AI`p
zlIqPM*ClIF7$%7E7|t`pvXB#a2~Z<z0%0n66Q{6D^5rG4HjE06M7`ek3<o_lmxO8w
z8aALi4J8im2r-60V+@8J-WW$G|KB?Q5y^zvCC2Nvx91~@Ut2tX%Nmb!WQj!zzW>P|
z5vrnOf9CP&rOmQZ!^CRJrsv)y)>+|*{6;e}S3NRwOU_0*%ai-t<=uwwKim+!f11=F
z4fnEtiR6Wn-^EsVXNQRKF<Qo{qmnp*E)L9BCN~k26C_87mXgYR2r&{+b4hU$$qC?N
z7tNdgCT1vhFC#uCOhs`JCSzJYx-&I4AO9(SWScuijZa+B3dT%CCjxiqPv=f^49X3Q
zWUqudZR3W|ax;9jNL#*bRB+wnwOJ$MEA_|uxzO-%KIx6p$d3^f$p~r8g`NwF^Ffl6
zXIyr}jZk#qjoN49DxzT@8E%A3Gf*S(zg5ITf_Ab0CH?U+oD<h|g?}y~&R;5-*JFXs
zxiD20Trvasc0=DkE|T(TK5Up~Uyq2=OAl(l5f|s+`{?V6)j%L0lzmdcISB7O=MI3E
zhm3}k=tw$U3<(de4X)0Io4P*y#(tVNw_tnLw_yjidprbO_0#=b#Dpmm#%1g{9d7v>
zxa6P!Eh&yr`owM{#7i<P>0dWgyk3=anh@YP<;24S5ex}pB$5&QC^ljxpzbhi#0jiP
ztSL~H66C~0d`6-K2+-wZVxN4NT5SF@ykyv7^S)R~{S)|3Gdccm;VN=IrbR>76`RCV
zP2)lXh?YiXIG#1ZC9n;zN%*vwnls@|N^unOQr3{K2!!j3J8Q~#AJ;Rk%IuLBt?9>t
zKbiAOYUI)y(}?3HNH{Tb$8`C-I&FcT-Ja%yl_%jXx>}hRxi|h1!ZsQapnz*}<{=9Y
z0ukW;MB5xDP=bH`?;^zS{wq+pmJ}?|P8lGj`jPk62nUCHko-<#FY{lC<b?29;JeAw
z{MdVQCe*p6h5kNZ01jA8!>L%2n42$;#C`$Y1w8DooW=40?*A$0GP-<6kQR0gd!~Ea
znT(zq@slO%LHYI)U9chS@hmw}I{VLl)LIgbcK+Z0i3!Sc4!983Q}CPr@H*Fi@jo{V
zi^>LPSx#JMo#^lT9caQvcK}VjXXM*iM)BE)N@UZ3><-Y(;~#EyX5F9v84SiE9=syq
z#5DI{N7>v}XmhEnTV6{JZZ7nhyjWsc=to%u5g1>&S#sl4jL|V0A&-okAj=Uf#x_;{
z6YPkPcmwsY><|?Z_`C`>?soo9@mBSYZ@v-P5XKabh*`T>`7qJDKaAX`$40$$?}TJq
zqS=CPgXG=U#C~4Qd`_x}u>T55_0sIn*P!_1r!GKCe=|E?v)7zlx?~YG>)c5_bU%~)
zDID_X2=!573y>H2b@s1hSwC~3g}Tl8*#QDZQ`TIMr{}s(Z1Wm6K$J#KKW@HwMzr<t
zoHw{|fyOdJJS&Kanjee;6Y!22i?|W6e+J?ZNrVOfy!@rU4z*^~yYKF<!U_NIkAg2K
z&H_F2tZb)(^UXV-9y${?(8cHOo(n$mzV~}#Ag}+##ZXM7F|xmeG|vl@!W!M0@sm*z
z*kxHQYBBj)znaMt)*@(+5v~#N7J33yq2}!x$)UbCs)!$r#=Gi$(*GF&-c>%C&3Q$y
zR_V9WnrrAm)yXh`tF}bY(*K0$vu8OX+ct8WDY8D7`QAF9N4S5u8i>Jm6;K`O_v0ft
zk6070|B2|^vyquoJiZZy;{*rkTMsUs&TSbYnBid2LazIw```W~UR|JB4K$)KX^E(e
zyhbsXTc)67NVOP=cy;C^c#xdNGNF!6Wu#*ji4l&|u1s`Q5&3Mf+<7L`uskqoc#wpU
zl!8b{bnJ!H{p?5loK(A!c(KG3sIeM|mT?@X%g5!EVl#ZB5s!w8##V3!Aoc2$^AQg7
z&wlbA&T2?52UfD9Y(?7wTf+XOtLs&}so@@>D;m)<)F!}z`k#E@M$}h0-|-y173L#q
z7tdY$^O*ilO4DoQk{FHic)yJCp^-h=HUY%@APbz3>2rveyaF}jM1E~r_{obGTYXqH
zL;&Z%VI-hO`k&n*wa<6h%XoSkR%h-JFxX1%kQdgue~#e`B$7u%iKX9gZuFm$MVRM;
z5T2I&I@2)a!ZECfdMh{$Ug*pBp4bd}6_^mbk9_}jKM{8k@O_`*8z9dwLbiy208C}9
z*2X+fal4vDGg=}wi4k&3%ET5#Vj>|vJCc9^iyJmF2Z)H&_+th;7%}Cb?1yHSB3?6_
zHdYw^QSe8BI*Oy~7;rVL6Zh(u%UU@w6FoNv2lL!ONr`k*!3Ham*zn6$7t1-rAJ-&!
zW{)2>_(#H46rjM!&;T3|Jbt|haCBe73m?b!Od9@pH#wR5B6fI7q#XL_+b&OCxRUZ?
zf-cke_Yog>fbgSc&(s??!58k#W^0>B(Z76QcgZ{n3ok8^5?{^Zf`j9{DFsCiSz=9l
z?D80qwrR=$1N!6Y2IbHl8^~+tb8~i9??4@f8=bMjz2ezuyo!P6Y?E9}Pam6U*sD)s
zx|12#PxkLMxoWW^OYKWuTmK1L2=HEE9t+RQgF$PGq8pPYGi(F*Pyh$i$>IlQ`5B?(
za>nK0sv{Nt5bTzCW&{DUBoBxmkD;Ct2nhJeSO`z$yhcbIMBIHu^~hh$$w?(yK2yT;
zt&B%lOT7#E^qa34x_AdiPH++L`b-ED+y}Ql`&sX1{L<0yJI#P%eXd!cA`j^KZ)3oZ
z3`EtOKv6tMLP%K>5S`ygag5Vf%~bUf7m>brDPm-(eQ}@5JP49LGGbvKpcwrXu5NA+
zy+&9Ed#%;q{Cok&>MLFF13<jv7k3#ErRBGO!aUT;(A7dl4vY@OnHyLc^6-U#7Chh_
zA7w?^_iK-@G5JV9I&5Zzeqv<CGiR6&2iU{UHVR_%WH=3E7$6P(SP#vCW-hTy?L@v=
z%cW)yTb2YeXHJC_0E&gDc8YG-{VKwYw2}eoayocG1dlHf2w4&qOAP|u#n=qp;4Ndw
zE6C!g<_AC-NR;3x@qY~A6mO&~!Hk-A5c2ou`D1drX2L|x;lFs#49m6=Gm2IP0fg2B
z8d=UDo7-#GTR%?;_dWGBe~eCe%gF>n!R=I>AR#ZT4gbK_;l)t>cvlFbGvL^WW`{E7
z{GnUov0+J&MMjSxO<zaXO6Cf@ASMnJs+o3DMXbtv&&}P*!aA_Yv{A`q+POGONt5P_
zgKjGg?mD@d{AD`I=na!YvEE2*qky=#OhhN}hda1vaQY%*Y9b>Y%g~|Myhd&!WXT4z
zg=fNsC)Nh$e-R{*vLrDgOC%*oL_S!zPO&~DAs87uMIQhO)<$U`m1*YU8yjCN!2sj9
zh(fc&2Y6;V9m$YfUyo=xpMMofh|!tzekb7@40y;p%Cfzld4Nb+7)p+&M=Xr`0v0=D
zVIrH|5Cof#4No32Lus9VygUI4nT4JB0qRKMh?M=XKZf=o)c1XKeSiNz!=Q1k!oUBj
z1kVl1?mYj(F&2%Kh6bw=^;6cPiH!n+cln+o1El5(6vz&U_GDN81MrR_vn9%X<lw}C
z!-(%M{4;Yq?`L=)%M5rzA{d|UfVg@qsTrZwPr?xyQi_n77n@K#5(snwJHi|wZp>ft
zqL61PwKNA>8qe^?CRCXB{0FmNKe@gjyP1fKy@9etPFsg?I)H$`2+hJ5=nb&+0D%8h
zoBKe(;0R?tKyTvJK#>V#ADcX9@u)y@?=p;*kV0r6A^EjijUp%^Z?`-;h&O@%xL4br
z^YI!?QL1|R$!KTh`|RMP_<Afvv%rXMxbFya>5UA*2DX3m78A(qcp%sW+L1ZFXw^9*
zD}?6Pnj_NrO>uof1_96;*Mx14WivwG{xTau7lhiYeZB%eeSYmjIf0*NBdtdg_xs(W
zc)*`U*H{qg^f#D`^X9p^xkCXbG^uq6#9*5eDm<D04%+S~h>VgG!Dak>04JNSBK%->
z8X_Y+DXj3WY`}8}2@gO@zZv1?C6JrB)&hNB&tUg>d48RI)4l*Rx(DCl_q_x-Ix+Z-
zRU${<2*+^P%9FlW)*HWxq^A8?(vkt+?}WP_%LHGHhgP#>4+>q*?+ikiXrg7G2Y5-9
zo+ll?;Kcs8+(+RF;T$$n$qOb<97V-jzX(tp@TNaA^Uw~fmde;bRIvg=IaoGz0E_y9
z|9JHgnt(BTRycAVGBZ**znS=m>5mJAal~!R<3K%YwHQ5jU-*G8ZNaV|?C<jM8}A+#
z@c54x+Zb!p53<nWfQ6ob|9{{4O$|%(ik4AQ{m<nzQ&6ItKmJ`1?}7=r21XijGjPoR
z6il@Kb*PCgLOcXt$G~OxlV4sAd2vDB_|hj+*{l-85E7QbsH>P0vsr{6#3MFtGXISE
z1)w_38VUD%!{KK1<Tn;{g>k>YJJ&}T_}Z9)k;pUI)~5M!Qb6JZBr2gO!&dmtJ^&GB
zVXG;oJOjcPt4wj7xepS;OizgjaMN?`D@z%dt}<gJlBzS?phfv6x?f0d;WJ|&84T`-
z+Qz#l)V%-yH)#s&1M|dtD)&cMC<z{*F3?E*0duW3;tuiCa3}pi|3g*|z1|~!{j?yj
z?~<=jG$1ehP9ykBRVj?oKz0*|5d_$foN#q`b#<o^CzRsh2_YW<2@5<jLU=C{6NVOF
zjSdijnRr3nOx%7Qiy`?SH*#Y`@f4zjkBq@DfY^wkh`6$;m>V1W-d&yWx`a8z@tz1;
z-3TMwvv^@08vthB>HToBG!F}q{RYt=?{?*gilVyCa`=g4h44k;D$wTyDIxq;60p}G
zQSbRh-$)9+q`BN6T8F<s#&8z-nmy7Z4$swEn*X@)|Ch_cZ^R$wzB9ZQdW*Y`-wF*$
zen4ctKu9ls?l}V`x&lXN$fF{=y=NQ4i7jMi>5>bI@uP%0RHo}ZX46u8l7S-Va?}s!
z_AdDV5Se3AGMlqyAU053t0XcD{{kG%i;*oCdB1=6?|q4mjW$ugbL?M!;e-FyXX2m~
zVP26F$Tt!>Fx~65IM?|9q#RpZ%sYRe!~3V-7x~|a6T}HLW$~-w88XBq!VCP661<V#
z4Z!}P46uYngh}A7nvg$;zXTOX?*wrCG}Ht8<><hXyztJvM4tt<EE4#L_#Yjq?MyHM
zRa7agL;ue#qjrtQ50AOPF7^BA_sjpsYN6O^fh)t7;}}@R7fj@~;T%9S>v4$m0wwu#
zkk9qI#Ykd!NFXpF+<v?O6na)~|ED;V@tkZl5*tVA?8NWo1^mGF7QqL<Tm#mbPLG3#
zi&W9hB)(va+a{ajvj-=C5-%>#Wc4!YTqnq_*>p$gzx>r&_{zxwk6?+ngscW6?kan{
z<&gw;k+3uO71=~st)2#6xUSDG<}10o`#Vt>RwD|;VJ_ptH3P=xR78A`nqvmak%Q|A
z9r93Y_cC(pIyrG9#Lq+L{k62v;p6mQvmh;YaBCsC>vSY-<AsTPGmM&u&*Fc^feN&1
zRu2JCG9gK^^JLtdRDUNi0$y&e1y6{JorRJupv!ad*}5d$q#8u{2}`$q+2$uMP7@sG
ze+YYxJ<JIEJXP}KX2vgD4iAn;E5$Ldr+7uo3-1p6N6k)2&=85e>p0}6CXu%Bo#2ah
z4ZVH5-U!vLkPh1Ma&*X-KLY!Sf)dal;+>%cwXXrr=U1=o4a12p74SvGgm@Z&OTSO#
z<6xPJvIN;*_?H2XYH5G5`g(>TsF4Q37EtUkoLGS&E^16zvXCx2k`Yw;3M~QZ{6r_`
zz`_7f`3O$dH>LlV@K0>O(UEWJT#y0p-I>_`{&By&|A2SjIggIVjOG|EW}5-{eh4~8
z{3lw^V0fK6FeZEd4tNi<o?vyWUGR*MH@;pV1TB32a9RQw11nd<j=cdN(YcZSUB~3P
zKmHKFe;iBiEX|M~88PVxmS^PRr~u+X9lup#BJ{6}=dMm|uZiKFTA5oRH9S?ha*4GK
zDsev_0Y!gm+HOyp4_vnYKwR{H#%GQ_orksdzTvGtXXd#Ivip+y_l%8yXxG?G+{N~L
zbJ_wv&f{mC()s;-wGG*$(N00<Z5a}daG(GFH_H-PXhbv^Htul&!|RR2$<|!ZJVYUI
zU^+yEd;lk8BjY0=d`SD3V{;hK0~pyBKbCPA;j)tNlVymKLJoKZCd@>#LN;tA>Ewj9
z<?{1F^E=)gj9)HKH+VzdL$D>;U>BE{$!tk>z=yNO2QQ_!%qO{qcV~Vx<}PzAkJC7&
zNVzk0hha!V1tx*FYQWRj2%D=sA{77Q$5{d11nw6?1Q7ukh+ezTr$K;nyuAef|L_7E
zD{UqF6Z?*W>U;Qn(1tE1NDR^xk-G;M#o-SR5b&NgHO%mW*5+iu^d-sg1_jfbeJ}XS
z+tq>dtE(!35$-VH`o34zSP$0rY18}x<2-H#&OCLJH>@@<88tEcCE`mPY;gxJaVE^n
zC*GcHb)!M}yK>WKlA}{A_nbgq@Q)mko1&qP8Q0$t%sCV0pWir~K%Cz!BgV`eaF-a2
z`j!}oLou^sA(&DOdy8~Q1M&MB8rE&QnIn)>_m>xZ*|-yaS<5KN;^BlLMh|uVM0RfU
z11avEb+f%_1G5kyzWLB=kMD*=Gr*9Z9wJ#GJP4D;Xw(fSPcQHT9?glB_~J)Ea6lW<
z0VL1N4#*b7YXzQt%;VutJLwjZIs(MR1z<t52Z7v9731ItuelYvjt2zs3(_2~e(h-M
z66#*~_yfe@!ht%J@CS+Gg#uL(^n?c!F@h10z&d%16Elb}WIi*V43|NiAPD8nP>6+(
z<@vG0F{&+0c#7VuMRA(LXM{X=gkmz5Nf^y;nZ&=u=@~9YWM_zv+q%-nO#hd$w8pqf
zLlVPTgka-@b3!;X#*K>DEg3)II?;*#Sor-dGPpom!l}qCe?Q_OJkJ4x3v@=}vFhrR
z6-X$`XNj+-|7$ic@@$<yHVGbQuo379_bZ$^$Bw}x%48BVychS;EZ7?r{?=i0xsUu;
zCIkl#wRPZ^Yu(tGm=95`rQ3j3$uRyz9Vhv|6<U_Iz47?e=Suyk$z9D<=i)(6!Ko+_
zzK3XAY6EBHu8<p7dNAV+A4vhR)&n5*EPYrQa7Drx{tB^ylfa-7`;dQorG3Bd+kL=(
z@%Q<6<j)fR1NV-XlLA)z+x{{Z{+*e%xeUKwW8gMUuIZcer8R0TBVqMUmoYUqeOHSA
zX`gaUdR{WcJAGlX@W3-YH~2i6Uqk*|fm)>NU$w6Bm`mVD!@A;|2NR(&kQ`cVXgy^F
zEyZtf5U$x%PrvsB_JQlCg+kG_hX<|1YcniFC6qv2T)#m8knmdI;iaH}_>H@)Ha;04
z#FjoXLhGAS7_Au;MAVvwm9H;<tVm9h<ua`e#^O9jh=}vyU}#PbIdzXvoS0WR@erMm
zmE?jeA;`kwIE#!^{u8c=MuGww1Oz0i_TDm~+1LjcvYD||$Piu!;ksmld#C<}NNIRN
zP{3)_&pkDRN8yw29n>>q8l^n$a@v<Z%MgM3ShJ_yJDB1wl91_Bu<;tijPNnn2G0R?
z#3SCZTlorGX~y=>_QAg#aw(hxsZ<5Bt)RpI!-W^St%mPB7(d=H?`?eE95=`OI|l&%
z8o19G89$f99G{cmAJ(3XKfQm#8sAfl4%%h~>p2O3W&p!?Oy3*AD|c%@|CUA9&4=_q
z8Jp5*%C))A=b7DN>bblHJl4>EwtG&$kLAtlXdbPVZ9BX3^fvDq#Gp1@+CLq6#z|cP
z@jJdhgk{P#(i!5Kh);Xna%Y5KWblW4B!JX?L}t1_9n`Qzd~jv^#EHDjP@6Lk@3`pc
zoTgMvepz9ahhkbL<Mam+5gpSCOm)o>3DHJQ<!(uNc+9Qx%?t4#jMi=f>)TbX2B?UH
zv(}(uPr@Gk_F^0LZ%KQ9bIa}gWrqe~>asCq7yb*=ON9*ahU$S-9g$w3fZj0~h`EDR
z2CaWMg-a1MCE<DaJEX*j2<a1A5K#uJV7uSDs;~#(ua)Lz6yM$e8H~qKl*}ZGmT<~f
z?t6vVh+x65Y<zhL9HhoM&^5wQp_A+lLr@6KgfR<<=frrA2t{z6GgF*DWCXq!r;Gv;
zclf9#vkz=!FeCc|d5m9Ui2sSg>GF1+ae%J+W*z6Vo+aOfy>nzp+Ku>+R78C&U}VHg
z8@V~8xW1}xiu^>8ACf$6?hauL(HVI>falARS9$Rhy*>A9eFVxhm-kN8zlh;H1g&wk
zH~tH#%iw!`<GkN5s>y%Ej;WU5fHeTdA845Pd=idCFgNQ1pTGVm)6^==Qe`NQTmU9l
zV~p>=^bK%XgsKEsJTP!)!6TvW!*dsd{_|oYqIupsg#8Q&8S6OMKp+#Z8dEgk&>1lk
z$HxtihOwamJQYxI*p{F3;SXwyR8^Zf3`Qpw46hPhSK@fyHnAfy(HXhCH?J`g!zl{%
z{6-D=x`8L7OFUj&(kt5FExFS-`kNZr`L7vOGUOQ`uRiG4FSya0H?in{2!$X~X8`*U
zZu<?a6PN>BVzb~*KNSk(s|1guA$XTe;NpMtVFLx?A$bA2PjF20>c=e2f~@e56VLMI
zJClPR*cn7j)<4{MLeIb<vt@-?v82}rUgBO0*=*_fLcY(LigGfcKN9XSt+qU89x{2X
z1%1F|wMy__-o4@Eh&B2i&ovl5XUo0RL`-!3&~q3siI0UMBBo^=j$FjdU2#<5wPUk9
zd_=XMn*$LU;wI*i5(N0Y1fzz~<C3586Jg#JCX7b7Mg)sc{;J9v31cbiQN<~MdpVb*
zAByK~XD<nP965S`j51t91+=x#!}<$sv4lQahsPB~mk%H=^4eb>V(puO;mgZu25{Z)
z1O4<;{U7-4SEmr0_bK0BtF5SoP|Fe$f=0*qJ>dX+Y#<P>A~TQX<C96hF7Z$Vf$KbK
zq3*w7!2xyzEzNGj{~3#D3<0A0kbDFSsQh!^R*UyMKrTn?nA~+yYR%k&KMwS~Wnr=K
z!-02(jP49?D-QitJ`IV`5N0P;jvV1O?6306^KwVy@<zy_BtY16L0|{VEI$#2I8Jyl
zv%?=YE<Y~$(vp+M#9^FGVhx|0zmg&ot&*&6;}Qg-JWSc%u)WC4IHqu$umA93`^np*
zDF+cR!Vru5t^fay#H3vgAz!*^`<7JY$aTDo&DPuQJi;8DgZ^kT`>p@(F(O5LUM8MO
zsNn$-eR^K`u>d5}ltj7WVcEu*kPYC-LaO+Tw0nL1Cja@oBw~0C@^Hw@DQNO|%SXN$
zTb-IPOT~E2;W*{VGvUt_IPuUF8<W-dT}Q=QvC`UqMvVd^8^<-7r}^?nJ@=Xt!Em14
zPRrq56OQHPk>RpYGU>?>-z2QHig<}=r+~q+@^OKa_)hpsH#{VRA$%p4k`a0T5xx=D
zo~VnTd{2%WOAf1!^J85NrkrR!x$Be3EVPfs=Mxz#b!NG|VGJu~9}I)Hy&aHp6tPS3
z9q*9ZxAdENa7}vLg9^VD^FR6KHOmc-ybSJn4_<4Ep|m2yFy4TX(tdCW$}&PAqY(Io
z#4m;+EJui!lNJ6Z7?T>%N$D8`V8Y^QQbSsp(J7vOP7=^YhpUs8leJM8Mk5WxYmeCs
z@S=GklM~`Xd^-CajOiG}PbPL_6=E+QY9bSnB=95*V>}lSB-zwL$`2DVTx|xfn_u&4
zf-D~iY$3xwnsQ+g*Bx4>*sf-7kNh8|Oei~999WV@4c~Y|2sq3rrY&KgI2~O(yc+cU
zDVx~FZgu8nG@o57vFf->Q$yJ~IFBAIQ)O~<NWJ)sG0m+)xRP^Cg~XSh3i&ca;#@hn
z*5`@;6UhmTj0~5-VgeJwNHVQF%yAm#@pTa_(p__P0zby};IoeTPC+gQv`BgbN7T3>
zU!?#>U0b)?>iIG+2#JflHdYonu@NPPUL?>aFRt~8cq;83b8mEa;zWWxHw_38cn-E;
z$@q~zCB|A5wf-cQ2QHAui3NOUh2f1$^aKF5bs#hNd*<*VX_xB6!8e4Dn*kp9-sIZ#
z9pWm+s-;*yRf)Mj_YAVgS#MlV8ZI!fG0_}?fUaTB7ZZk=VfuRdYw7tTEU)-mft4m>
zDon~!XJ2{YTz8J916g!W-_|B>U3VS#$=<amG~Xv!kWWw!10GH^n4MqbxXNFbggxtI
z?<tx^;-pJXoj53n&xztC=YqZ}Ph**yaae*>@RZLJ#Kd{Hi$3^EnJa3ah>4FTFn6TQ
zZGT)(JR~^ENO<j31Z{Hv=m_@@^(y`R#QELX*bu&t|A~FJNY#2BJns((>0(S|pm)Po
zL7|d1ur`z_od3cid5oSYg*oqLw}8b-ym>*LGYrNs2RKjv{|%MS8ImRoFbM1PAKy?T
zcz+6Gb-+7(6ofWFS&#eIHw1f@1lwS0GV;MGHFKx<nRpwMv}e35Kqi85%ydl*1m=!j
z%uLol;6A}(LQvd5blCm|GZ!I5Mfh$k2rcT+nWKwbUG!Wx4TFgY<_rd&tYGGbopCkv
z*VA83eL2@2@NWAZj)%DyN%mG#VF!&SDCvae^L52yt}5qC83d0VhWr~nb*d0rKUXk8
z&bmWmzSrB&@iP(2bNh6TV~Z6H$WyanMm88V`S(LiCjQ?M+en+{#21a3?-K>F9wS^v
z+~-F`N5^oL5=pYK(rt2fM202^I)G<7T|>f5Je1<G5qajZz4m}#XKM~E-}uPkVu_a4
zpgFSm*7XhK4YBayf3*5#UDyTH<?>reX3oz5iti`Yw~U;>Lce@6J>7r5lwtS&xaclg
zVz&@i0e69cyJ>F!JUB!kK0wXmhku!fTTbFn;6W3<lXrmKiQnzN{4y(!p99)V79b)g
z7sSD#oG=(=CN+p1ff3pRth3r);sI4{|KN{e`D+kArfPqTnD7j#vDBdTw8ex4Kqh-k
z{qg=Ea_kL36Uq3nz$U<c397nTA5ErOq6im?_SL~Q226J_^^$^Pk%z417=7hC^ZDM6
z@^a>0bq3_|)XL=UI+*d^&Ku?i&|$>dfa|`d6~D3T4f?P@UycCyo)WN(iuCSSj2iP*
z{}stuk`9e^LPXq?b{<HHKIpt<xcW$UV@d6S`|RNz>q7Q-$kWbXb=l^R5}rbSwYv=d
z+2IrP|C_>*it_p9@WNeN94h2M)X^>e>Lgg}2g48C`C9GD*YB&B^~8t-7)De+6q=Z-
zAV}rdFHsm%OITwCqC_3#vt^{l@S6v{{O`kV1KQI*S6r3XK6!jedjEA07@*^U9`w8Z
z98$jqrDh(7ME4*3(Dwn=kJniD{vr5~fSD2SD;b-|nsqZy3TOTxRv0Q_IV<T7lcZuL
zOi>|{e80;hFb`Qr9}fjs8+SCbFWax?F6%HH>G6S{zrkm_5(Fmy`~)ktraynEpU1|%
z=qxuqUI6`EbVuR~5^aI8eTBfbH68Q$-j4EMfKE`<bunugo+h=eep;h{mWk=E5$S;K
za?m7t9OxM$ak$FB&#MSL4iA6eucQ;zb|<JN8*#m_+ILoEfQ-#^PwwAI{UG8dmwM&d
z4;yQ77<Us4L~ELZOlKP6w=mm!caxi{sEoXROwWIsU2&Q@9Z+$|iO0dn7%{1sI7K+r
zz&6P+cv^JCr7+<N?v_|MML4w22LdU?rcVC@0WclpnN1>zgMwy9Jh6@#&i)V+DM_4U
zl4f96^MlX$WG{v|l;knVoSB@SCft@U-dC(L7sIs3vXd&QdPVu6UKk0`$sT@*d%EH@
zTyGJF2UYYb#v>$82z8+WdGi@)ZhtR5g`E~4C&-%v{znMtiHB;fV1drPi$CE3Ffydf
z9*HJmnKL%T`qA8+XEuj2{#lr^A2*Im_ldIFoGvmpaV%#{0q(S)2OHS=i}!SiO{iYG
zeR0E8p;@DJc*z*e!%EGdWfg5We?D(nv#{;>)|5XPl;3*imm71qyvuh_sER9(*Ewu!
zhKIa8?JD#*>!r#i<KvO7%{etKH#d2&cjvArPU*<c5#lgQ%b|vQ72+nI8E}6I*1B<;
zE@?NHmN;Vi<g3XHM7qxtak(WYWH08V&8U0)>=;9XEi9ARyfqDpW8EoG=S$QW!tKkm
z69S(>_X;>Sc<?~Kz<?Hux@J)|4a45v|Hr;^=xQ^E!f%V2b8r0ED>TkrASO10QV5S~
z0z0&~)j!075q=5$X<!^~_b2sVKjK1K6*BgCNY3Q2h^#XujvMP$$OMbzVcz)l#qWF&
zvnTaep9sJ{n<eHBB{a{Bshx+ceJa8vhP4rxGu(6cScd@D+f8rz-{7u}E=CXBOn3`v
z0g`EO4PBr*OL{xRMC+4co2)^yu^z{Xlhnys_&GTwA9goOMhxcw!ts(9`(xSHGY9Jp
zdh#!}jhUm~b5m^C&K4z&G<(j=*oe!72kF`c@P(e2JK_6qL=n(+CeQvPPYf;}yr*rs
zxQiJ;A%&EfiCb?tnuxen6S}*NMGSwN|N5wm5=33BD57bkc|=~e@fg^NGS~Q<&S<og
zGVo94URF%S_r%cbUZ$LP$u$sBtuYsT%MtL%CZwhO+@=xW^_{ZyV1T!Q+e~D{aXRh{
zSDF8~=s=mmPx-tdU=hTL@JE>UU=WQpoL6*)15LI*ID=6k0Jaj~>YIZ#j8TV`T+DGd
z2wlTaU&KSXWnTAU1+H%iS;69Pg_4GT4>$=OGmbgh9A3Cih$j|JBrT7i1=DAahJ!oQ
zOqd<!jw&a7R@AV%h6h(o47{>#3us}aI;q8Z#i)Uke)!Ha7#(VHTG9#XjA3u9lmzv1
z+?VkI4OR*IxU`mn6MsTk8~P&C#b#y>re$Ms5!4(ee!W*TwGrYo@@?A=@SMgrM1bUH
zNQhSn(m}({RvJ?%{p(PcB$hL<RsJW$-xVYnbu_de!W8c$G28mM%(#&?sQH6-1dZ4l
zSVT?VWeiEjmx!7{GYZS_#43<O1LEWa0%7cUmErbV%f;W}cb4;5LFuLZM+DwjB(TT{
zK8&?k<^JL!2t;ye;#RaNNmF;c$+LXiTnQK#Hy??XXu`^W#qsv5{nXc%<NQ9$@f@)U
zxB&2lfKt<bu^%R5+#ko#FBiT%Yv4@X{(g}0eQDvQS-Fq0@qK@jvfBSI_99=No)Ph;
zvC=2`q2-hM;_}lSX!_)j)8ycuHBM(=rK~_lsY4ciG9iIJL!^H)@@d@snATqr3Hxid
z(uoplOmWHrUi&4)$<w$`*9pxg6n_nxn&zbX<fs`v79%DR8-TRJbo_)Z^sn)OI)=2o
zSJnWJA)18@e0jMe8h&R5aKz>VTp}BvgdrU9IPN=IVpoWYJm^wjBmSL!6PW~lo*rX^
zSH@VMgu1z8mM7OH$EAV@j3LcrIy4_q5fansE+SqUR^;&lIE$8_!g4^<=Y>hlvBI>&
z;VuO2UsLdzfe106Lngl8;SsZDnR@VyDGfd%bcaE$9)cEi=SE>~nJ`gPFmO3Hyij{F
z6Nn{xPHK~a2ZAKT;R(}ke8a#*nb;_}@|v*M``G%#VK@Ka5;u3Z_}E8yi6VX?FNux`
z&y)4WOt~>eR>VZcsHpBZgr3si!Qa$if(Z1<VGRSRkKyWVN&i4qB%h3;y>4vml34;h
z=Hc^uRJ^x6rS9&MpiJW@kN56d`El#P>fiXhU}gO@gmZ5Hu1e~;Htm8)j8-7I_|+BB
z#6oyRmmkN(VqzgVrTO8A*Cr47Gb@bnowgJw?(8G!dFQr4TUyG<L>$=X=VAM5rJu&R
z;TnM}(oP7R8C`|aAu9z~Xmx61f5+^%C>NG+z}ni@H|EyN#Ser8>$x=0Bx6e!r<4I$
zKu@4J=z#hBymk=$(K&=Wn~K6mBZvfq5jzNrCY+Hifm(CnNO$|FF}LcW?4XOosz5Y)
zG<GX~Z=OL_#SQuRj&oG$r3b{w5Ck}~tssQ>M}~_L2<@L@j*mj6+|J6lMwr;`^L@B=
z-26|8c--$VG}L#fnKLs*h{3NPn{%X%X!Mz7;xRE9IXYuASb|2W2CAQgJdlzQ<HJA*
z%`ch5<hZCn;laoao-@G{<NOdmw8ump&Al-KRxgggm8^B5+SwewmlxB+)w|=CWnt$z
zTqPtK5J2l=d_+!bWtTA@5^a<}qlgo%tC<Hw345zppA%eHnh|cA=9lnW5uPFttam>f
zjq@~=oPJq)Bczfw#BZB(=j6t+{7GX;jWuHW7m4#g&}<Q8#G7L?Z-hl;0lo$A2-%ZQ
z{<;op(Amacr@IB1b@3pZ_LU=O9pFMOjWkZnN)GkrN<tV@xi)>VMOc7@a2^L(Z19r<
zA^D*i6#oJ&^fQ0_P9lB?{Aj}~io!qX1oXnJ3Hwq?@yZZ$19P1F!E?>G|H;i7|17$<
z#C{^mc2XFg9$V*v#N0-Bj1|OWh=eN{7;}xTsgCE8B55LYv6BzFclk9}F9}T!x0j8~
zWCLj00DpXmah>j_g`##5)x855$v?v<a7Ye$bOhSfnJpgkg7&kk^)TQ|hucgy!GDd=
zfM?<9uwI8_UXuMgow{q?(YC<+Buw%<`8xYwb2qJr{nvG_G<l!!ry-Ex(lRsirbe;w
z5;Ws5{hYrqi^$e-{6G%(vmToY;-Dk?Kz-$(;Wl>^@X&t{Ujg2PnT^CmVkYLoJ`bI|
z8|wAPWgCKQ$GaW3eqay(HI6UV7`ZX!<ktRMC21uQCm$V*Lx}uVw&D1PZ87(I!Nf<1
zgzFEvJknBeFzs)nKV#S73Ewj@>iJ-KbKxCSu&ohc^72*k@Q;$5H*gO~s3}utb??S-
z^%cMhJsWfI|KDE`8`g2i=P#fpH~(>r{x{sGnbI!v{}0s7T-3evj?+o)YbRNbcs2TP
z8*1k6T^#(K8)qH;Ch0IUV#xT|xi9e}zsJME9f>d^hq8uapOlTupgOJ{r-pI6RtC36
z_(I*Sf&MQsI?0FsH2y#pZN@M+^2{YPmw#x}XfxLYyas6nCYL9_%fOYnJ^nWcP2V3g
z&CTIE7Y~l}KqJ5?|B)xfTqA@w444U7j#7H?cpXME2|s~-9X>;Q-XbHI+4*5Xni--$
zEO#~~&jsFm!tov>1bChz5RoK0_Shaicrce0;{%fjk<Y?YK@nly<nJ1U3{Ex+hjl|m
zL3biK`QLxa1%yg~@vc(cH3jm2hgWm|H-I(IpgP^-yad_N`05E*XJk!fc3wfio&=wb
zI~STe&962Enmut*o2yR$i!W`$EzJt2NPbuYuiFD@XX4C&_#JFmgGmgl;Q)ps#CVSp
z;ygz*PF@m@gbDmN1m7kQu5TV+9ei&vi;V4`q5Lu0L;5_iH_qW45|6Gcz=f6sumq3R
zEhD<GW9kyLLj!4GFNuH|Jlvb_{I_LrybXiph5wI`Ku#m)hRR4DBu|KixvZv*#7&K3
zLd0N;lg-pdZf_^?)b%tsG&{a+V>x0XGQhBr_<y*FjGyx#==kTNDGt^Bntl?3XO3>+
z9UInY@erS#5Z3!9J~x{%Mz0uEj2uMy71s{DJTn^OOC|J$Y#Z6D>&UiD;Y|ns%iv1W
z(}&mN@P+em%3p(*41C@ZC>)OkJ_vq(ENclgWR>R2(C{4)>=!lxBg!z{@BqE?e_?Vj
zJTD!9FpH%ak6Zv3rDs%ze>466z1BAW@9}K?uzztEF0aJb7vYF|9uNps*dNV8M1)ID
zCd_n3Ba)oKfs!H<rn{06vtTOYywGIf1A8b>#A};DkowV+$t1k75inxYI=ig)_H~H~
z^B)?()}4j9c<(d}!C~1n#jyC3a7Ex4;I;RO5;t@#AuDb_9eqTd9|7-8t^D{2%V0R#
z8E^B#Od_$`<G(WsQ9CqgJ;;N=S1E@M2!AP^PxAgk7L=zFi4(+$jKpF;5id3be~rKz
z85%WPd&hWg6v5zvf9`Pqu51AAe3MUL0R3pri3aa=IPYzbhIs4%$G?%kyFdqb$u#j8
z({26aV{PI8q!@X|w%Gr)3LLnQobb!2*iMacxGt1S$*7F-L_gj>C0)$p^}P)XfvMer
zC&+XL{17a@!1R=4+2NEwukic^KOZ-nb}=9B{-LYKGxMj2W!?5W^I`4Uz?=4iJAn?<
z@y?|{xMe$!SdS1{KMQhZ*}fwrM17_4jJq1fgbFz<uTdX_?c3^$$73@kIM_BHEI#5l
z$%Y!9KL~kt;}X9zAj-GlEojkeqrZ&DHySqeu4+9k5*q?p;wpDuc+3%a33vcUzd@h0
zzuEYe_;Zi%BYUU*um|^3CE|ZDWW429r~{BopdoLTQ8s=)MY3lGH+=`&E})a5;{W*T
zb5_dS2YU)pYMR;fr@UM;TnJ2C8CwKO!0A19dx;Wn8VC~-B)!=ggfSi?;zV&GIFS{_
z_y8Bm{gOBTv;q<7j25LU#@X;@-`oQD%mLo$!0;#m=2*cA);GWN00DX|xqMfEJ0tX$
zBeq9mwa-2>MnM_rr;+jg$c@(HMTjhA`kH^ed-+|D_IanK(Hpa%o9&^AX?nl6{oi?Z
zUd$q|M(y}=Sd&}N4=1d{L;O1f81<UhW-r_y{~^ZR_vd`%Y(Ko&S+n-LkJ=iB5cTlC
z``^D35}E}_Nb<q;&E?@}j}a5mE1CH?PkFkJXP++ZK`#ka-pcYsMBK0)2qU2AdE#J$
zfNs`jsiNfoD@Nr2J><;PJ^o=BO?zM|G=4hn-PSFJAs8-0{yW*;ccbauc9xZhQ%R#v
zx{Cl7A}278_J0VOe~iZsk!2=E#Tt9CrWtxa*GRM=3u`pBJ=!|f=a-<%c+Y_Uop5$6
zXdlhOFoMsKUN=6}00aIVLY|!ufy71L9dkfSYRtD}<0gRXXDfv!!kiUFZF*DEnSuTd
zsIAr0X{5|yVCWBhc-flU^Cb-q9|&>-XV{)RA$Chumr>F}u=f9fF1ruB<SzgGVs7m1
z{`JIJ1WFjEc3?o%e(1!)e`rmbSVmsq)ba(yP3MjxPaTN&hLhBVJznBO7d>l<5a<P%
zgt2)fi^j9WOC2-usi(nKM!9r$*G!GJ2lzhKT7bJ#y94k#2ne3KeP<7aHX)%Bw9wmM
z(O0IhbGz7`c9A_*7>I&n?$zz}aTz$iXpLZGAjD0(5jO4LkA&>|M*ZF7O}lvs`R6k>
z<{jb2RE}8{$|G~7zhNr}F4WE<{M>1hBgA1IN<>Q>%MlaY+m~aiPA|>FsS_z;BMd}i
zIG;2bHVCqJj7}{BFE@cN;~MafaMLUa{7)lZ@T<47zU$OJ@D?BZA??6bx%L@)>|NR>
zgI3c#(D9x?f61%jpVV=o>j6W0Y7DlzA)uNc<OM&IP-i!v8>rh2f~JqhUlt*QWO~Cy
zu4<>vzSzcJ+kg4vpH6^|Sqn97CJ)ThDYLt$z8!@KU`dB!y)njzu51a1pgk~4hLeDP
zBLOFLcIp8l`ZqpV9U30`KmH#4)~bi#Kp9VZHn;zsHGx6vDi3s+p+<p8ENEG0_>n)g
zBfXDyjNDvBrg0l;mtFS1iHwRp-jDc&{(6_F5S#@a`j~!m5;LDu287hQjhO0j5`Nqk
zpZK^V`PHqT{P-E0t6u+_7i=ePKHg@G4Yhz<SE(}C;(Q|!Kp}x^{5O?^d@~h4zlJi{
zA&Z-=oX3F2soMffUx0_2G<jhCG+^Q{s%TV1@s^A+SK$e*kYM<TOO1OlKp{Vcf60yo
zhm(Si0ofT(pcGwlDz5-_Y@kRAwInIJz4(D6uuHZ`0|$uY(TK}!AMpUQ{G&IF(c5SC
zgZ<_CA|$uBi2U9(VZ?uYSB+BzH}RHMvEu6K-m1Pb8;b*n0AuYT{_*K`$0u`Gu3h`s
z$Mwnea{m`tC3pzy6^TrE>;&JV_NWlN^|(hRg_-`s>py{)2@!ikW_pPdYRvn@3f{>$
zn?EI@oR1j9OLfNbVJmHU#6<Ycd+@t=h$Tv5_<kcN30X%*PGqHK2)x_f;%kBk5x>9l
z#v5ARqkGP~me6c+gl|#3oFIRX|Lp?;8)N#)q5tvt@8$Zt{~e78n4(z0eOvuIU-;-Z
z%_gU<hfr|e|4NdW!Lupc<-_?grT+d!(P_V$piH_yI0i7uLB(a@n*^;I;3Q$SxM36>
z$$#+qyd-CMc<&70KuFH$8QQCVeU}zDnu!)xQIm!4;nVISFT=W!)lN9Ig0<oyADCod
z+0$o`R?X5kWT|RJVHcj;p8hfp|6S((@EiHkW1i~#S^NbXc4i;#s4m`2p{MfktZ`z<
z9p&vW69{$9_Z{SGus>V4*0^qQ8DnsE$8`ubGM{;T7T_kcu653_Jlr_6kipULkBx~;
z1OhL4p*rFC_n^jn(YmV$2?aQDt4e}L1>^<tgBH1ft5QN+{ydi@V>tH_tVm8|MDm|O
zQ4a(g5x9vgJao^(Jsix9X7svoZe~f|isZzbTX>HVbmG1v^JAH^R$!Qbl&ku3rF<hN
z%@tm6;w6$(!6gwFeBwDF8_60}@dfUIaWLc<10EO*lM&3EOw3r)4=WqQR7OrK04vfy
zs(p)QKz#heo_9yz`RB#vGhXn?eJA?5kpTke|1&{<j-Vh4wL<;FaX#n2UGe{hGtV=3
z#B;9^_}YNm;%Nn4Lbx(&*lziFJyl3TIZ$uZpO@|RVvgVc&EX4dc<%&$H{u7!-cbox
zgg1oD{e<m~QfAwyZX@yfB!yPUC2Ro)jZz!XzH=i5M)mN7C2tX0fV0gPt)F%?_InJ8
z2L~cVDV_>ySHq}1{)DXqL+N_W;k?b2+5NSL2wtqr`{4<^X)%ZpJJVF*--IoreNV!g
zY7lsc{;>@*!@0lS6D>uj5*X@|tY3Z^g1#bpG!XpJ|16D5tCm2Se6@Tyn7E}Lpm(Fw
zlO8cZM!I^>gkt0yQ_@S8of9mHV@O5KH|7pv|4ITY*r$cY=rsXanjBC8e4k5mKlQi%
z{ciwJZG$az5Db`B#Y@xtAr}J_<%6mExcKg20!LHKCyu_vMacWPk|w9bq_GpV8-qpu
zGr|((*bT2qo5WO6Sj+=PVbwN||B&kpzZv>~807PMm?q)~4)omg3^D#xGV|0C;vF15
zA{J)I-Q2b>n6<}KQkY?}ahgojQ?@!`dU-KCM&cyHDIEMvkr17d&jwqQ)J%OxX1cs|
zp_x4Y-yYuhN6ij*vOw!U+|b(zJQoD;077?WXLojHcTfM|0d(d)5kg?p-}je>FtiO0
zLJz+NAfVmf0{|FFi}5<Ri71tY@f<q+<)lv$;>LzW+`L8xKWS|EVrcIFr*Rv;#9y#3
z_3@v5Kw+Ik?GBcyEW5~&Cc~@Z{Aj_FvV)V1!DS|80JQD#;6Uop@8@+K-^8@=6~D$*
z2(O174EQguX23d!bgKZ~{NpF2e%l~-tTRWr#6;s}XV_h3%|yw^Yw8F%g~Trc#Mz9e
z`^FT}+)O3snfEktF%j#qI3CFUYTNinx#h;qNAvz9K_kX5a>PP*^CBZwmLqtPer6k<
z{}NhAu1JZehkxNadR#*v9j2~0lk&0M@qTDBcys@X>XI?Jd=Z4*f4|EKVTi;A@CHZ$
z1I(1s$?t(r%>o1LP(dI7fZ^9Z8~}jf*CD_N4jplxwXYBq*rI?Vs1YSJ3@*TIOzS`z
z2Oy{G01OSM03l{-#wKF#f*c%nhk#QD8oSE|crw6Zg9Ksd&rg8Ij3?kjoB+hSv1lCI
z9xygF9iR<?3uFJs8io-NU%=I&4#=~T^#PB-4St<FQYCZoQ4xG1xDvcG2`|m&r<Te2
zxV;24a8jg|5dGpVG%|DXo0yJJ!TR&lpJrxPp!qqoF$ZRS%NiRr2jM&5itMqwn3%a^
zUvjhOmzMjk^zON>COvVfd_|)rvg4Td9=UKjiG*<Nak%J@xi+ugvO<@V9^Cq-h=l1Z
z(yLrY;{0@F(KSSkON0dGV`JZm@iJmvlFt{(r%m%#@KMXGM{yHzvtogeU|ql?+@Syb
zkN@bv1Y>OUNX(apLXkjXKyW||02HjxLdx(KGr@)e1!=>Ch#!3k0098gfCPSU0E}$U
zM2z46*tit1pdB&-4}ZH$;88I^I&VNn?a?I>L>6XeV5o{h%*b@K$Y^a%bk7ixs|hrJ
zc+5;t06<}(Hy!vXgLu|}*hRpc92am5&=3aN#rOaS2EYK<I2+lhU=)c1p1?h?BSao{
zKzaX*5M~hP|9k(zNL9?WN&$nu_ovRe_>OL&J_K>$D9|8I7@O1ez7nuK2uG|BN;_B7
z|H%)iz#jAOdYG-F@p$dgWW%fE-W(TQEUZ`*c~g*eXg?)uQ4;V)^2Yc_7@Q35i_+zS
z2d~Ita^lF&8GrsZqhxoM2>dO*cCPyAKgJbBQ)!ifW`l||%}Ve1wwU_E>1Z_lVr7V%
z&wdi$yS4EUp3zw{TjDhl;w9nUO>t4{xcQkGrd@m^j}d3hB5P@DcK9gp(>2K-ToGJl
zBFlu#UlD``;>if`?m+eXE?IbS-~44F$<p};!ZDqb^FF6Wcn|rmD2aoI$pP;YNvFRP
zc!EZ##%p6F<mI%Nb$mod2r(fz)f&e6AyE*V$1@nBo(eCLy8kB)N1@2Me}BO*6+}@2
zLJ@#}2XzQo)diaS#zI8^0DyP^hJ@ZarpQQbOr3k$I~?njfDkd>@bmE;-U1f%e(S@&
z60iV`#V=Kc?S~$#0%i<&d>HLr_gq<Btb8~G;eXcz8M=gTR^QYJ9*@^B5xrY{vH$`I
z2F6MZg9df~!3|)Ey!l+Kj`5<xj0IkW^9Wv}?VqUF81ySJjKZ_;!kvZ)18;Hzt=}eH
z+b8$gBFx+nya2FB&gj+yKB~vp&;F}~aFLzL6<G&N<S{Ue6)ljz%tN#V9|~%Ar~iPM
z^#Q**GVgWkJhXssphB>YkHPl|aB)-|ehSLrdc^pVbHIW($qD%RAU~Fe&nmy;wxg2A
z4E|(W$;nmYC&X)rnqH(p)!gA?Cf*!-!ZiVZN8$kgn$7{ksIt)9W}*%d&_D5$kpZhv
zAQ_h>^<;8XQ8>>^s865H0mtgVk6G&cM>VDp(gv~Ovo4`;6Y*3aKgL4aYP;Sa46ax!
z{0lZ(iA%fyuD3{Tz5(wK+zB3y)%D>SazsgUQuvG*Vo7m~z9Ly@i%}4qkg{PJjZYCZ
zXG<Ny1PFH@sz-dIF#@k~;}oSZ9;rRC^~t+~9TEdqDE)Acfg4u!RRIHZZtDnH{NBF5
zkAVx(r(UK%$joTtTp}+1TJZt@f_Vf41}=qW5-~p=nK3*o7&0I(jV71IdwRwv0Wsz8
z20611UFFevYW7t)t)2hgJxu)-{rn}U)FKwBxQBE;Tu+HN7&c|*@Z6<%&e@EUeDAZY
zq!a6LYZWpsa^=LEH318)*>Pogd*MF|)mV<DR5oBOzg2F<*kG)AKmUy57+z>7#l$s{
z^>6;m?NM;JM31I*^uO+HovZ)mku9>ad`T@|_>$Jhki>Y58~!FMB3YS(d4^Z-pUuTb
zsk9-PEve!&@VqI=J?A3y$PIgCr8ITJNJM|}Ju6i0!qHFrfiK`AxIXgZeZCWpT(1u9
za^<0Xmk0|g@i)!kxcnm|9B4Na(sa`{0v3;Xnc*|ft@jWAh@(W`{R}p(Ovg_gKf|yX
zhn}1H-YuPf!)2Z}A8}<SGMIp>q3=-Q`8Kit84mL|K?R-@CCJTABO%O0UnDQT6LBA#
z!#5e>DAZ&qQ$u%%B)bRsatIQk)JKTPi6xwF=jE<Qc_)g`9wget|BKig10|07;1CGU
zt#76y9}$ACY2M~#|J{?I>LVM?r74Pt@f_<>7`{xx1~oZ|mdOFn1;=?P*j1rgL66Z~
z`%uTBS%9O_?>}54taLQ+k;A2gImKZdlsMbY{4)t3QQN0_3fhL!SO3I9ar2L8wnLY_
z-F!sTNfpF!pCUw7<!9YF8MutRoyiY2Tx;;|W@)P6LMan!b}IuZ!*&Pwsv)6bK)?PJ
zk+ueWKl(zCA{U|aon#Ook4%^T54v$o{wIs_%N(yJAd%?F>LbKpr;^9EpT1oCm+`z`
zP)PGUOf;qu_*+dkG!{2?asZ}l$!oR4OL6<+W0yHUH-9r2{z{MKpAUK9*wqLlN4(5i
z{%4?|IF@`DnuU35Foq?Et`YD^@cy>2k%Rj|D+eyXJM=C4kAgi1+_0KEd?zy(B#Rl~
ziDGdtJ|;+v+&c-eIPC!^8{_8nQYS(W>Lq#vi~i#x=GqtzBa6^rNc@*5IS3^^s4{iv
zM1L3Nxo~HtMm&`c?%w;njNC_vmdR{^w*{UYF7t<O!Wf%in>OLmp9jWBlOXIPY;k*1
zYu<C}60mWN6yJPxL_VU{=m=VPNB4gD;XX+&f+6Q^)2-R#KMZHfpYhV^fPl))GYdRE
z;3oYawNN$vvcq(FVm}|fB4#{y7DK{1*!kg=diiW~`7t%gOD>Wl#ACR6QM*ZTvG2FH
zCw<G*{Yd3VhlKDS>#gcz=k6X(S3p8hvGe1lU-2Ob6rN1e=gj?q6ghOt*Y!*WdljEh
z9kYj$R7ojOJWJup=X^}D82F45^JjY|AMo}I{R;7BJe?OUW@FatedEPOlLvkgtC0Wr
zj5l?N?z=u{(E<K^BOei;66c4+elC{t#e>fguTc|gY<Cd=Q`bO8tErEu!K)KW9G{QW
zM!B__k1g-~MAGs@#BL+RV9OKY1o<|ZaJvjdc!{|oKMB<Essd$SFFd8?zV0J&A_=VC
z7jcBiAyISoL;FGz9}y%*;sipG7(<$wcNxv$`wx!r-?UKN$K*ht@Dr>!!T=NEMDPM_
zM!!#g^KuvyQ@z(+(0&1u);!K6+S0^+YTg&*sO~t9>iC~rR+@KQEfL~1h&K*3Y%*Ak
zArXP<AsWus2mk;8a%&<<LLdXj88_#A=C4`mN~2q%UhOa;<ViLF_U@`YBTU57jPWe4
zeTwE?DLLnzowj7WqFS`7xBw6dk~}QcQ()3liffvzuN%3@2!c#62Q6r_uYn%f@_Yut
zY)9!%=ajk@Rwac8zVulul`1cML_`*kx~eaECgiHIX{V<Xzdd?HtLaetvH-ExaJ9^E
zq2=eP_&-~<B<B^bQ8J8S0s{<y6398H-?tB!H)0oI7z@OklPUfn0000005yoXVZJU<
z!u!0OE)~4;dHQ+zybTS>_WfhqJ*2j`IbPSS9<$mHT=tEP`?({?^Sr?IfcC$S+dX0H
zfF9e|0qcX?dw$=x_Wf`VU)DXZTiQKf00Y_p0D9xv1K0JBSoZyJdfw0vZ`KcJ_P~2*
zx9f+tdf*<=df)-=fc4(Dt?T;7x9b1_?T=V{N3;NYe$WB!p0n2nw)MxZ06l+LJ%4Gy
z002FtL7RZ6KZzfKH)uVC+#UxR=LI&c{NaYL4Uc~I8rIHsU>$d}c*qwdtbPq<%fNeE
zzqROjz5Lmo%K)}@yT?7PKY$^v-}a3W{v~lMiCK6~)|*;uggk2%RPADLz+p^J$tG3e
z1Y&sZZX81UaF3Uih!HiL+rs(38bR0Qg>ex#Lnp9c*!~i*hx0sgR?GkXC-|>7oBj}l
zct6N4mHG(gc%oeJx0$X-(@go{TjYakG#doVKy6*$PsCIqGwA?+>D2ACV<7#;@?*w6
zBK?y1tZg#%V`hK&Cj3BvRSZwVh~WXiD%XylJ)%KVc*ya*Pgik>xFrFdKitGSdOo`3
ze<v;d;p*2D2un4y@P?u$w$jC7Vj?qekDKt{gZu&)sQh)u)Svt|bKH2qU8i#px{udB
zhs2Dzj8(D!^?XFKmAAhr0ATNlo-ZL;D|rDKwkYt=5^Fs_yj}nPABcO!z%i}Jn_^w^
zc+2nwS)w_6<B^=%ye~}nO8I0~JR=c=c<yLCd)%=6L{GaMLd-(Q=!`27k|Gk^Y|pkb
zZH>fgBInioRwuKsO|<b4kCsxw*IYC|?~0*Sh{Aj$=FT6`HIg(o`7a-@bDTVMd0N_}
zAIu0|xx@QEykCs}eWU;8)j(rYFB#MWcSiKW>-SZ*kH5cscwHmG9-P84EG<WWfRni)
zx_Hmw=z;=W4k;VmlQaaq_;xHt%~%okMymtqus-qS#K!*~GBx};=6VVjbs>B3-?lYR
z3eT^8{eBr*!~(`*Nu7=&BMtLLjG;F?MaN?$(7`q!+qUG0{m-fRnP{K#$D@1VB4alh
z+RHgul-U1?@ffad(5gH~<FW|IXXF72PqL3Rd9)uY@3nXIVA5+dpaHT*vRdh+X`Z{y
zs(^2(ad__n%?%(V8aJn?Kpg9VW{Z<L;}|#Mx%7v>D+KU|`K~Q%FZj>yH!QMN3*a@Y
zdG}ac4#Mcs0r>t}d9}o3h}1?Fh>6O`?H<f;XHghpBR>=7gDd<elJyV7JOV}3wALG=
z5gFXl$>m+BEYt?nzjw}5j0JA;UPJZ8O1t=|=-AG|6hFK{t2Y^@CNjo+A^(p0G;B3t
zHcZ&Qg`q^qZL{YQ7X|B?*^nCPo}6sY$wXEikY9<^MkkBYH&U2C^%0&TKNqGrlw{0W
z2Yajg)5s=(pEwk2Gp%M{$8sLb^rMAzCBemE9UNf+dS8ViB$L)?jYMFxo2UYhUXbi~
zN2U_rm?BVZBQ6M4J_#AnI>2}NISQ(*$ukiy;nA=~OpzLh{3W6+HDG0j=BRNF<N`hV
zKA?V;eWS)yA;ro9Z^!<+<Oekz0$=(a-5vf}4P=fL-wI(962O`NJKMM__DZ|YTolf*
zcC^cJJ$IdLwKok7!sgXXl|(`wct>elN3(MkgiVpO_?qDwn&6}fSWT5MW+e}z9|Vg*
z#(Jwhbp3(*=Y#xaht7WR;o4|GJs+xL5rwG9iX;+0KzenE-j163LvZmI0aHfzBW>hq
zbrIraqIn>>Z@T95aS;~=JtHk}B6CnM%Pss}gq<!?){lu7DJF;g;}O|nKN;Xh_}s`d
z2`b&ht=vxp9zGIghENu4&lI<3e;f7q&w9m}Sb$?pjT*nZAeo>xC<(nEqM&adGO*Vl
z-`<5K{lshhcZ}RD366$XE;cTrB#T8>o?6@*-XVEYtMQv2GA6#&0;!%0&w5{OR-#w+
zrQ@)OlSs9nB)xGOs|d)it~;f7|13T8QEIq|R%QGc#V71Tdu=~fJ038$&3Kc&=ClN<
z-+QIvKQEF7h!RY`UPz3gH~-_^_z-a%Mt*G$HBKP6v3kVG5%`EY*Nvx0y|CpW)u<?H
zd~JUOdUFvk2w?b6-@;|0brA`7Yec>;Lypr_OlzCV_>mrHDIW_oL}tofHf`1*<@(BR
zOY?I;u*6<Bo=u7Qe9-@n&k1=wH8YijORg?lcwmhJ0v6bm#6owFxJJ+>0q&mW!xA%n
zgXV_Wa{CjTG*W?LJWSa)@fvB>l$iOj9$F)+27I`#%tRp_Xq6rT7#p2$w*UR&?7$8*
zbn_*s06qg@jd&L&<@+nV#Pe~ZHs&J+_=vttGiLL|NrqgsQ;G30A2&MA>Lx1=$%~ko
ziM!yF1dfyZSw~6m$Hww-BkO<Eu-kp__ZqCR+#dk`%b7=3ps<C|f<aS9<E?)%!5Tc`
zHOU%Uf814b#713@q=RalX5sv-G5eJ)&%!xiWHh&AXn)<%{w5K}g}{Lxq5k-dtk&og
zZdvpRGrlKm)23;Y`}g+}YdNp);T)$JgU-cLCml`0ejR?TZ=nUDo^{;P<&qC1JlUj8
z*A?c?hIo6M68=v#JbjT;aezYB(7?V3V%;)bxQO|%IM~2rbi5W$HRjLd<h{lw8_j7x
zoyTj&UmXF9<*DY;8f!fqiBU8q<-Miexgg}d;+>l6AeWn1)iDu$BfvA&KVSLdZ%Mls
z8Jp8AG<lhsj1oMjKtjMTDsZKE>?XzU0!Asq;t*FrON$M~J7<RPzY;zOd`oo#Bvh2&
z^S<FakG1v1kJ9uQ_?%F=DbF~J8(|SJ?J-RkAZr`Y@fl(yl?B@J-imHqiE5%X!abA5
zsdrI#zmpo%;vp>1WxFHGHzgL|#70hEch*8{0%x#?-0pve4F8dK&YcIntv8T02-?E)
z@sKk4d-?Oe277lspJiu8r~vojPj1B}P6kLl<%rAPKVnuqBaWLZu#>FoOz_115y1o7
z_y}8U$TKzxw7u}O)E@I)LHb|+dD|R!|H3_^qOC`a8R1!oMX35S{}C%p@T|ysE8cl4
zzH|PfCdOuuvxte$txujWlg$nz#1j;{Vt7YgAa_x2C)uzkZQ@AK&otYfb3goM9-_Zz
z_q+K5K}}J2i$%ZW9Ax0b5sAtBKM)DoR{vmsAJ!e<`m6}Q0S{m#d7f1c6=#B+A#Jb{
zJkMrOf-%jOS~Fag#6zF=7>T=rEWp?}nC)ZA5~v%2vXdau-le?TaRDR)9))^>Js$c0
zy|;fiK76*94#Z)6Nv+&57A7M!MkXV~Nm?2|ElHZ<Z&#8T`+^Nf;QENvL}q4YWsc9M
zO=1p?A|mFNX>lP6gM^bOu!~h|ntV9j@CEiIMLvw>lN9rKzPHNoHIOK|9`hnR2k%`A
z#KV3F7t#K60s3x_^DuqVcU;)yvm*WH*1si|JDGS-ENrgOJ(2S8A90?^&060HYf|LY
zXX7Sfi*E0N*he+CWUMtapgZ*H&ZTea<plLF7@#frR)%|z{3lu{O|$C=^+0Uv?zQol
zBzjzyJy`y#!>s>+Tl!0x&<iJM^`4iy<26%qL7{b@<_Ikw^Wg_|0RM#gjwjvW*56SO
zj!91&!zcve-tQ6<m4VBj2h7pkL1ac=OwVr5;Xg!pJrUr3OV;@?#-;HQ9K@s|Vn`^Y
ziHyk%Zswvf@K7XrH?r7M%Of=a|4!{Zd6D~1?Rk90C$8`9{JczFBZ=P#^$1z@LpEBW
z!m%)Ag*FU-MQz{<IR^0&{84ArWA3{E=lNVOdtrmD07NIMId9RKUl8wZ;!FLBF}^;m
ztKyi<%T`_@?yQm!fxU5FSfX@TUzU9TCl}r81Wy|y$9M_%tL%u7Fn|hAu;RN8$+345
zWyQvJu_NRmV`4Bm)V$EEUjN%~<@S3>J+<>7!SmO^V{tU{@vCW=n21gS++7wdyo-?!
z@;h$6XkNC(gZz=Kl>(`@C!KeNN+L=dmmq#3HUKZfY1;7`<h|gcBP2#Ag!(6XCP#?z
z8KNWL3O1bM!Q9n4)9OCu{s+qDOGw-SPj*|TbH;58ya6jN<EhH~J)G+trrG=r>$7|O
z729XB8R=)T#5^OO4t^+@y0i6UqCW^(Q63UQdM9xcT>8uNVVs=Un&BKH&g=kVYWo*@
zE6xa>P5~dKs-pvVn~y+ybEf1fZV<o6;Jq1V&z<+ZK+6^#+~{OX_|Dk;#<2fVo50<*
z4s`-YjjB}OJ3JvKrfe<IE_RRYc`xDuFU}FiqAN=V;k5d~5q+b_7%Kt({(hmr8DCU>
zLka++#5&W@_L^W@=s2}4rh~0Z4&^P3D4-^FbszpeFJCN-onyt>#em1nQxMxT-ij~%
zKsXgvmhpC?!0KQ@!WXI9Zc6xpINY(Z1C~SO;Ta%4F#tyOUu)WkAO;8O#D7u<*b?M0
z@co(NB^F&93mN))NS~kf4`?-jbJLc6`s|4(Y}$e$vYDWYbVxmCD*a>o&v=3S`05q1
z{!o>bM&L->I;0P&&xm`YqwU6gLexYhpGM64LuPnlBMU@sBQF(_7Dw1H+>ZE+Z{lOJ
z`T`IaYi6G5{fP|iRlm1<ayR}-;hr8@;rNos%uYALbHc2T2_WB#^JY1#W5gDnVrPBc
zNLLl+lx|Omn-H@r5S{==dhS}k!6U)$$X0#72*x88oWL-nLG0@V)PM@UneE;J8k0v~
zKzqAdf3FB+v|pX~v*qGE<MGBrZ%O&Ui{ZL2^Ab|2pZJL|d;f@t=+T^E-TaKl`NqC`
zlB@Jj&i@EyhGe!$*>8kmBrO-D@K<1mAAbnR!w6v##l`T4WeET!NG9rN+D)(WB%O6w
zQ~&$_M-C(hBHg8;bk`{95O^aXNSAa-$7nV>l$J0Mq(KR37~P<R^yuC|V8CF%eZIf_
zw{vahI_Gs=d+pr!{d_*2Wn)8=!tqr9wcLuJySl;pCok3&U~CRvJHr;0;DMkir57Y5
zBvvJovSZ$g^uNb?%nVDk2>mb|HXTJ`=)F8KBJUB^DYiMZ<^;mF=_ut@vng3OCtLM+
z2?_liJE|KDMGieLLgG^`uwUn#8lp0Da$A4CB)<Dj;O4{q^W`H~@q~y2e8~X-z3e*M
zjnmrc6;$%ogOSRXq%=YrAt<KZ8QiO&q<HJTp0Ohp^>NyE&Q=nV79Xezo!gw1C(-fg
z7$Ep-dvO_(8ZBe^ie`v2ICS7IwMKvNC(k+Z-bRL$v$tO&n4rDWj3}O>|Hj7stYDLH
zhxmV1{5$2^70P5(1lDOd<jO-+;b3!$m(0$uoZk3Sc~o9pb(Ag(f1ro{w#@89NDOXJ
z(lvHc&mDz1CX+iO1c~L<7Efcpn`O$bL6b9txGX23W?w)zzWm#43-3NKAk;=?oHzf?
zmODU`chll6iqaiNInlWzS!{fgPGhqey8WS@RX(BE=RJ;i>G-A}5{~rK9Ei(u?&Z2Y
zkG#noz0^_3-oS<;gBbxHtkmybN-VTx^1I{}rVCr#>xR82eO<qUe1Ym{w^k{tEtY?%
z5hh~UaB2QGW>Ll_l>d1veTKVq3C~p*_*Rc{l=5?qiO#L1*z@;);4hFft}iW!A#%GR
zu&m&U*sgW?2JB$pu?!>gV(j)%==luoQ(Dap{*z1nzq=%^&dhhOZ1akU8-`K_tdR-j
z_#da(+h_Yi4uCO^#SxPc-ecpkz#xT>$nOf@de#@`xXu-pA}g;a_U|qKV~ke?H@PR^
ztCtAjN<!~FdQ5~FQ9hHdJ@CJL%{sxC(T0IUmFE7NeEND0#k3I~*TU5h8UZuVj+T$T
z<cG;#WUQQjHgf}KnO?v#H8Y@#$-?l=&+j7A{@=t8?`nGh9%_NQ<JmdD0XvlzZXaAM
zv<W%Iv6!f%Yqg~sA`7(nd!={Y{)4qF7ZZUPG+NbIY#c2)<t2?&9ZiuRv;X5;d4DRz
zp7Qq3fO|Y)S5_zwFddSIEF*+y*x&~cK6p^4!d;yM$#y55zFcR<q5CNNQxXRJaT5R~
zt(&xu3ine|Z3TU=jMckNT=KiSwuq^4b=pA%x$~LEvf8|qJS5O~5I*eKm3^k1%_TRA
zmqD^;H2OdXKHzfklE)SQ44`T(Yjxo6#o}A7>5#YQz+q<<T#d5h7KUG6FXrDG;)h=8
zeIMr{F#30HmH44pGeW+Ti~79Zw?ro7?(1u6I}I-0Dj~@L^;6ZPigWwnf?W839y?nI
z&psej>m&DmeR6)2Rs$KEibfIewhZX}rO{G|btCWaD+%Q+A|IcPu2rg~SRtx1|5ix_
zEyN+VjSX9VCtgPl9HqGCx>s!FWNz##0zq>^2*u4Xx@yy?Ae?Zrbtj#gCBsLNPf?>z
z1|RJlQW$20WnI_&M|1)dU7OmN{}{g<10yhBvmxYumNQ7pqWy)SdiAN;82m7Kkw{NS
zc;d+GBC5R|RYZ$a{Z3}aZ}2g_{eX_03M8`*vb%X>B-P0-sUfGe2!|bEFHbXrep23!
zk9YDzVTWv%<=o#GE=M+{&+_(T5wG%EbD~Tf$@b@X_DpiJuRpyOup#bX+TlML7PWd!
zmE%lfy(!;Zgzz>2#iI3toMZlEbMXn=Ys*b&mIXEn@%~4}k?k}#I(Rm+LA&Zx<XR|q
z`AAh)&&K+{y29!i+X4XuR~X^}M<sJEg;Wepr~B@J*xhm{aXf;nE@&~TDN85;mQ?gm
zgF)skT-}Z>>z~X4`?odi8K)V}qk`hgnCFw2m)KtR)n~arDMPo8GlCBghXl#Vv$KEE
zk@ykdSdW!5^x3>0g{SlLk^soJ<3D#@G}Hq_(}z<0&f_0l#amRo+@BO1=&&aLvVQ(P
z-Eo6u$`;W4-#=iB5w)~xw@^oTRAEHL-5$|CCi3op9NbdScFHYxpoOK2`R{`})6QrN
zCw>IY=4V>U=Nfl?enx_l{I{@7W~H~Hl=#!0YmDjJs{r-Axn=&tmvV<C*xiMRd9!<L
zcVC|0uO(>)9nvvii!nwlB;4aFs;Zs$=Tl=a-e*tog!>@%N~J5~U#n&HF`M>)iciWi
zRTw4N`zq{m5QM~`&1rJb&u_q%jsRHk4cZCSet`&z!pAtP2deIDYdSsR2_tq&%|G5u
z@hy-iId32Dn!af0wivW-kjlP96|;JHZ1U5GY`Ix5xbBG8s5?x6`+ruKPye?r<ni|3
ze%wsYnhHDQ)J|GwR8Q(`CzVpV9T#M405^Q!-y8DUsmjV4bX~TeM}Mk69W28UWarqP
zE-#->+A76gyYG@OPedd=eYw=jc27-^Twu`oN0yL}%RxJ@`eXP@7xn??LOk}@{a$w?
zB=7dbfK^xBPi_Dw6tumxJ5y`z%IL#hKm!>mGfvbz#j20DSfUa{E@XOppF$7~JjAg`
zrteQvjFI482o{aU_Mt#io_kXyJ+YtHu%GvI@`^RtNLCTFl}biNOxcSpW?&R!7{`ms
zP#eaW-*bfFlf6Bt`FV9ll+!V#DnrqI<&NPAumPrekyB|mKX4*i6Nx%mL`Zz*j(zv4
z;Y`_14_Xo9lgcqY2mRu=0Q(wM;so~X83v{l@hEBVgidld=3|tiSmMu#_Y?cik=c34
z|FUYdus{~xOjdJYFzIR*{~{AN3cX+Sk!#a8=rJ|TWeMC;I)As*HQts8&r7cFv9bur
z`zOl<@HPqa?Lq7-z4DRPS$r$F&d#fUX&t@@$08clt;qTB2LIBWgsdQ}k(Uczf8p^{
zz}P~0FR6CzKdXxTSjiF6PT~mp_ierH;Z4;W3Y5u6DkG&2#UP>RLqc9RYDEAfAKiER
zn-AHJOEXBgnnjLpoXWH&mXdbf)3lFK#Gk`Z1k%e6b;&LItaskYJPJPhwpJWqx^pEl
zbD%X`hkyt5HmJs0@t(^pZ9K&oU7(ru6J~8lbG&3}kWbSGWGQqN!_jFE$joppg5s0{
z3k-kwYE=p?U94GhE7UXZzZekhCW)kkh;Cku!1(Xs$Rj+mrSG<%JWvao6G+m$n-~7(
z7JLg|0*^_SYp!pwiC1M=-BMrdOW?hr0c(=u`-Ai#D>XPGS9JQ>N&53UlO@l|JH!ih
zkv>~*ZCOuwULHWy9>tFGb9~y7p^&FfQ^MJ4ZxEsgv*p?i%@lagt6ocj?AcIpXVpeZ
z<Vo01z97(p>x8SChbrhOB&(B6EK;|LaNu!v0V_W9x<e6c+a3sF)X?nf(El$TZ_-Fe
z%qqca_8mxpA4+!Taxd>7s?hZh7WQ~P^oaFKKiSu;Ul#F--n~=)+F9N;ZW9A=(@m7r
zM^gz&JI8BiJPhq)4TTmd;L1bkgYhEqDJ@^`LN~en{WKhK{55rNJ$0&CU=;R6y`J~`
z<pGVdmJk{zof=&?gA=r;rBZd}zlZ6T3tUK=J$#Q*MeaZBpV4D-{!ydtVvesZ`V_UB
z3kYmK1RTF6UGKS+3G830Y(*|#1dTiORFx+y{4-GruR+JR)42$_zETd}?K?<4(FZk`
zaO6=?m^sYQc0UHO;a?OZcQ_z}x;I`9&XJRBY%sBw3<6HIvB%qoq8qahKm71KbC>sA
zwD(`H*v@S>ijhbs7Z`PiYxD`V6`UgZ;ooB0C)Q?iB7LnLO6iZoz+k9kXTRa;8g`Ql
zB64n<k+e(Y^~nr4*iVX!`>cMkCub9|=C+S|$-BRgn@C2SF*KC8Wl`Ruc<a-qQ^M)_
z<cfW0Ek5MRK(pA#&T!2&{Snxj!*#ntD~br}=wwP~mi|j2DRb5RrDl;kDe<VrymIHs
zl1Dvl5Ur>)0`(z&w9k}*HQqK`RC4Fzr@RXa(kxTMSuxYkp5eQ)B7p(ku<=}u2Yir#
zYYKQ?jb|m|rlt~vwg(|_6b*W8;q<t(xSt_A4Rrwsip~I8(%Denl!#|x`QHmmcMo0B
zG8*@4I>!QxR$N?%BCgxn2#jPi%X6B8IfAsvbxkVT`dg5xpPUw-*g~Ppb?+Gcw9Xyv
zrdyw^dKw4;S#pg}w{}WT*XUHrGibas$!iTR?)kV0wRW7{^6g-{-_hu(``gCQji+P2
zvzgXy#@;h;xP;^R<2vl*HT8q`4!z)$8z01sa#uOz)m!TiOpHPF&f|+g$t3lR*KNw&
zDTla6&OpWIn+texzxHcGsW(v>Q5j{j540%r%sc<(C)zW7*kC8h&0X`*MG6q~65X$x
zl#W3_P`Kkz0t&>C2m{d_W)U2bNaG<BBH1R?r!`h7X!RO-xUm8Ho*_{IwK1yPlBpm?
zzBk7S*|QfO_ZSCPN73!Q>Nx4E_%|PQ7!4Wb+(_6zqjq7*Te)sh>tYf)*m+A=rO*qy
z$<Gt+`w|>o`wgd^;>OX~N@{_?l`>0xaukbN&Ran)u246bFG1?uVXZVAM}-mf-Z(e@
zfnt7AXEb%L+9h!BzogMnz-2N{0_jxN5dloSxX3+_rO13;eYh<V{vUb`L=yboPJD7+
z0c^vLP~^M4JDbe~BEqv&PV31wo{ZUYw*&RPBRR2VQP`~XgT%UY&ja?kOa1$-o8X)?
zjk!)|4IYYx1-Sw590#ghj&@vk$MARPWT_X@<cGr2KRi*S*<14hsc5;;oaA0M#w`Wr
zbNoj?BJM~IA2c9n#$+fdb)Y%|K0k|pRNR|y*QVtvy&NQdW4)-z%?Qfmrc`r)FDqqf
zkFhtxLZBG_X}M_?>B#I87ahD=N8Wx%CkdU>lK&570rAWa<g<1L;9Z%hV=$aw%@&-8
zZ&o1Z*>it{a&<zSJHoy8ttxEOXb}<E@XdwX>KBi{<?+Qt%&#aI`pQ89NsEEro6Yk+
zr8%#;gy#jxemVGGz)?GCOkb-yHIItCyQ`FHfK4&0-_`WEbRn#acwfK?Os64wdl<S&
z{5fBg4F1<8p?f9T$J$?9Zc#Lb*~7&J;uOSvYvND2xJP<}Hb|0DG>GcK8g^PzJBVeI
zN#Jmd|0KL$O|QKQUF2dxB_;Vq^Bdd6>y76Q-UA`2%n(f8t!LCc?2xj5BDMB#U`)@v
z7;(hpc&Vq+*=TP8_NRdR^x8A~k=V^pEm^5MRUBWj6MervV9@Q_7}KEPptX@M%;G@!
z>c+r^MOkNT|KPH?shKu+%}u|FiJsN!g|DntrEicw`Rn$!_RfxFO#g|QD)jCsPj+ij
zhg|)W1gJ{4p7E3DnVIM;nVJ(ET};b7oR{Pkd#ZM-cJJY~UHrFSP0ds6%P)3IUgIw;
zDLZ1mzV9$Hv}g;UWtKn|E>Mv55Bs6`Q$EuAzprLQ`0^Oaa*s|0IoE4>6M4l39JE-<
zF2#<<2EjF!Q`VpwPdWb0W?LqLc}16C5#BjZQEp~X92lCF^{k6@#QwzydQ8t(ORz<Q
zFUw!EU~6(sVqUV2f0^h?h;c(ewuWxy!9=7+r>g74JnxZovGPm2_d1uwraS3e4+dew
z_xJ5=d5K#YeAKr2?KG;Ful5PiO7&r@H0w@wYAd6~@ko{qK3x>UDZ<^9w)@Y1?w=oH
zu790c_}0Jv4~a7HU*4~lVpiqX(LeEktvB}xX5=8bE~c+0q|hp*a>g^6pDC?=ASngu
zr0pLLr@>oRPr1e{zHv*y;t;}RjGb0B=<-A}tGwm0VY}9+G;JmydjFF#8>HwUGJ#-Y
z=vQfmdU;Kshy{Ysr-TMfO1xf?SDb83|BV2@9x^BvRX|=76KwO)O(Ij2D*t?oshhEd
zCfE(&N$z3%7d;<42Vx<Cb76sk)_`Mk1Omh3>sI0r&JH^)C?<CF;bf_Biw+&J7h_B4
zsLiBNNoZ%r9O?Iy`3h$0624G_Z_>QYNPL@d+H;x(GRrWd1wODAX86xKJ(^^mbQs=B
zp6ba>xVn%#`LBdvtzz50KhwII`uvaB(l4d!c6<d4`<ioV)U|9lshAtj`!ccz=K5{R
ze0M^g8Go-R#%<Wo=eSP`_z+^@RX+6$LpU8nCby8JR^7ueWk-obIoP>Fei2%u8`Sm3
zEiTj}W!a3gpJuDjO7p^rOOz@orgenCqjt5{>A?f+EWHy!q6fQ|B^uvRri|U%IyFC`
zkFv;J_05`H@ZzmM9`|q8hiTPB?*LSAx}SyK?YfO1Y#M-shcl<$Tho%^0iwlVG^>v!
zdXL7;^1rnSrc`_tM1T;%PHu&+%{+;V-Imd?olD<=OeMIokG_9<=eYunY6t7yDIYL#
zy#Q}?#(_oP%z^D+9>c!KGIu-Y`g+s4tB2TniD^hP;19^@i=SbHOTJPa-{(sIprdO*
z#F}S!T+_IbnPogEZ;D;-6-^-_+b6yg7dxJOmTBtjaK+2-Pq_(&<AYQ|<Cz8sPDP8q
zDbOr66;t;1(EyCPCKOFczV#PBRJ9z*wpjbGleWC4=TS#ycMw|_Gt=l>_OJY5VZ^i<
z3kIiE2NvX99mLGXedW??H_T2g`pq%7My|}(X%5)UCpY7Ns5A(vNV*F~mvtAuPc&@L
zkL1xq>3&EBxfnlw-;ayffjmp<zWKI^r2IR)NfynXs>A6{Y2U-%z5mJEWRviDdXIn-
z%gVjr`i{$HH9IJFb<qBn<tY4rYr{aeKslEOd|Rgccb4NQ-(DaG=)`AFa^3-t%%gq!
zZ~cpvbWH609YaQ128`i6xD*=OruT>u{qd+-P9U~@_9adL<xLx2`A|l}j%$;^ovxN(
z)*dcvX^(H5y?eik;GJ?_@h%pc5$eg|6Br*CC!+%S_IB|FRS3QDuBZNRRBOdACHWJ1
z?D)(0>}NFW`nYP(rvGL1Yn#|B1W((24S8E}adrUz1svHgW*B%F9Zr)+x1WtZu>Au=
z>p#g7BM;e)Z%fYA{xxaY?o7dC7FmRMQCBHFRGi|VA-ybKCKA7lgRq8Tkdfun30>Ax
zhvd?|&UXI-`T2v5rVQoVy63b$#QSx{Ka*USs@0Y^sd0S0yD@J$bfSDZi!r6!kQXn5
zU|hFNCQ0WV%{H2QLzi~bXe~K81l|r&ErNAE?B(k-A9248*xop?d9qzYzKK!u7h%o%
zOK(Hr{dIH(acaH|jg|i`J~H;^BtAGxwAp8X$x#W6>&;0zmog!^JQd>48^x#%Mx`ia
z82;oMGPI;1D8>hAaYz6hjB6LRy|sh-ZYP2J(FLU&v=Nq&KADX<+$<CYoFk46=H<E2
z)!H_E`=-9GYDpP)zV>emaxMAkcF{CaX>9mmk5r6$UV(9yXo)~w;qfPepLWXfECoDc
zxP8)Q^vC;Kc}@h&q5~@O&id<o4RusCXpHkRrwH7Gm%f*ep38r9S?U!6!{MvA(|u(4
zL@ZnA@@Qd|Y~IRd_B{s6Z)U;W(E`BsEDpo%$|jRvL{f0lZTm@jNLH3lIUc61J!H0*
zJrXRqsHh)AT=b?_klhdujn{fq<5l2-aHtxR-N^At<>U8O4?x)1M`V(iPg`ZN2ipmI
z^gF`e!HO)EY6}J`LgiJnHd|ow(iu7+xC6qW*i)UWEj5$PEekgImOK2p^-&H_i|jN?
zo)3#%Cm)#P5`)oha>P<9%v0auvp{GO_@S(-FRGBF{b4bO8){o}bL2V+zlUVU%LGX`
zNYg}OHS>~rvP3eq@-2GVI9|!-{ty#Q4McO&#pUJ4<vFC{wU`iDFC;bI>GYbC^l-6R
zm6{hRsf@sCLF~>^w61*-^XRwP_~Ny*z3xACIl6j59KTo&YOp=A3REMBL-)t%DvPo&
zi6-UAmg+3fyEX3`5S@Ju_yq)=%I`y+6L5XCT;_guwqqxmM>o#I_3XnvcdnA^`54Os
z21s~!zxX)q(oPEKkv0}I9+m4s4LVhdxaJoVnh%5w|Jfiz>&M~kk|@TB`WXk(qT7G>
z&HlNfC0uwcsC7+Y33FJ9jFqcQMT+O~soyg!=h$f>BM%;?*AMEt)(5Zk@kAcO2R~;O
zj~AW!+B?}hh2p4RQfY4pL5!^;?kg{*YQ@v%LD%0_5x#!9gO<zU(9H+%P2p5XFGnQ~
z1FB;G-_#{{qX>9SNC@D%AKc_fd+m236kEL->}}hB-Ae9}FswAB#b=%M0}<R{eP-uY
z(4DmBZpDfmlPA*Fq9M_hBB#?I2^f@KzA4{(8oLnCg-wZO**&27*|=3H(Gp)Q<9Fw9
zJ`}(+%pNpyXMgiOi<JOv$4>{lO`Wy*U`MP(Nno!nK-Kxtu6yQ;-W>UOI@E^s&Ch7J
z+YE~QATcqysK@^ZWp6C{-~&o=`_5(}Cos!(-GxZ&)|z=4LlLQukB;)nT?|k7cfeKl
zZw94XL%dKdv#QZ8$?6;}j=D_UcR#ulBpoV((gx5|3v3qI=FA>7zs<E`Rnjt+bRYk1
ztvy5|4V?%zXh~VSkSQEIA#4X!MwXP+^?^JZDTk$3PBe|D(CErgqvl!+Vbw6q@l>tp
zCf0{&)e3acZ<DgUg$Pt(-;E@etS%i~RAk!qX*?r{D2b5b-QJa2&G?H_pqUpE`C9#;
z-P88A*`q6CaZBYi9??BG=VeZ8{pxMTb8K=(k!3@2{LQ%FYQ|7R!`o!vT@OXjhv%Z#
zW(yPQL3zHsi7COKc>3SOYbMje9iel)E5D&hG?`pnMVht7ME{W#B$Z(itZ+G@=btlB
zOwg<YCM?2Xz?kky8vFP?Qw}iFPYEOrS+8;T2s%>Rc!6<If?%_M!Y&4FGESyoodghG
zJD>(8utYJ4gM+FZ7JQ)vqAeZyDzWR{aQ?QxUE>TVi>86wiQsxciU0I9VU1r~xg<u#
zfDU8ZuuK<4O<2<sT2-XdV^@cTgj}Iw>%(@%eQ7pzFYQ%z*mBrFn4WJ?cMxzH43xU(
z#^DAR*PtkA2{>l{Q#SVvG%F+rdag9q6}DL7q5`)v<3fqlS7ivxtN)90Hlx{ITXZ~3
z@#Of%UgH$;OJ?6R?U6h1=ED6j=TnzYbQ$uMuJUhwZ!q$%p8R#3Q_O;u`E{MiXVl!r
zC{1i+#b?y{6<xIko>hhr|Ghxg+*nU!LOtIed0_@VSFmWKr8<?J3U4WEB<sFC7S;?5
zaCX8``U@l&Rp3Fn9LT(;LYg2&@^Rv76$}nTv3PoUO7&vxUNYy?vVmC-M3E`qh3upM
zBaWtR{jzNT-4U#i8nI_3o_Q^88g>B75%r%LpyLP4U+{!~A!3_P&gJ19Uuk$nc-Jof
z=33>!iSK89sl85io%E3|)LLZR0S0LMMR*(G{$`RvE1Y@2(&J<P14yixtR;?6gi&||
zB)26M0Tb07(HJz9N>U1iATTr-f;z`NPI~p2+J+TDu6EwxH|oCqFXNFIb<fimmVX4;
zL2$>@!5ZllR4(xJZ>7f@wMN#fu=|6Dnf%+zan}#-+D{w5UboW-vOYted?zY;SVGG7
z+1yr$CnfFbV+@n%P@70H+Z?lQ%;O61Ja5qU1|>f2C<7tCrbwjVTZF3tIVC>MG5&wF
z1!*;PUn{xbOyVzxVm7RWY8)gE?c+XH@|>k)76h0Q+lS7#IpT~ik%RCJDJEhe3{wqe
z8lT%v*m3x6)ik5D{@>9G)@$kHiKMR+ZKyv&=IOYuWFYXi;5%hM?7PP7XGTf<TaB!=
ziU<QHo$nfh6nWdo4^c-MHMB)6-PxP`R6?AR;NIQyYYc{)7Gcw5LD8E_NTn1pa~a7R
zQjNx8cs5sC>qxquDP9BFJ~abjy`gyB!PGjZN)YzZdr!eyRu-m(ZfdJvUTbZjb}c*i
z!6(_=BpWp9Z|idfH&|C>bPWTWt{au6;-Kwy&qP=nUjVOL_BO=W0#Lcsyh!%WcOENW
zBhQDzRv+0ldw=&%oMJ!hh*z{`VWq<vD=y4`48BN-rR_sJoDd@k!gVN~=`PIS(RRPf
z?gp?EDbmz&MwQDxavoz~ug7+%K_&64a#^TpBnqZuAPK8NtnoKf)PmN9%U(7@F*3Eb
zIN)-iX&v{v@F~dhw?U0$iQD&7$aiBM?&8zL+79B%w(IOJ<u1qV{{iKjx7KnNlV=OZ
z<Am*&MP!TNDzp&3px)5-`G(GRdE#T%{9Ewg&76%JYaQimzH{%^c?8#^t@5oCUQnk%
zk%{AV&}9%mH1({XX1v2IDX}fMWE8X}i3v<0ABf*n<?X&FD`h{lg@#wqZR9?{&+AjH
zq&odB6!(<GYDG0Bz072Z?t8;8NHeWj=S0u(Z^E>4((w(Pr)ZcpR^fgGtfp{(bp;6Y
zOt5__c!SsWQZ5jD|Db^=fAeZ=N1OpW8&|YXMFQ+-n}Q6M#`FHz=onz92lzBhvHbxH
zMhZRm6<X<aZ4TY(l%?j+Y3A-r1W;dKP1ms9$&X!y=&ubCkbneH9ZTyJn3x*gl`%dG
zQ+dxkn3^X5U)j}0zZ=g(<154MKP+p<%qx?o!NGLf(RBcLm4o&IppXc8eE$;TGWzP*
zpL5-25F?&^7v{AW-GEu?s#^D}4#B3iXoFnxLCck_f_OZMeg7s*B{XLya_7QEV}2Bx
zwbfQf<%|i-c_)N9f3wa8w}cQ4CjhHRUKcM9J_@0GMdgR04OF~-_L*-CliT?S*F@#T
zQ8paynCc&pg)MlcPfd<jhdDEyi4?7L=S&<_3IUO@eE@EB>haE_4*Wns_JD(D`et|j
z-6faYM$WSe9mcCa@A1vQYz8z%Z@N;$cox$$<cYeB%rB<5bz>Vv?$u@0+El=z_!W~~
zD~jxf1vH|Oh>Um_T*%t^ye2{0a^%M<VBm-pRHQwqII?ReMhK}gx2QIm6rbm!CO<_o
z`4w$guN`JExcike$>uOJkiuYSRWPG?<zwhJ)7}*u_5G*#JhZY(=GSixKRUVp8K*(}
z%I)O*q&cXPCiDDcSkyW+o{_;&GSW3M_>y&ed(1A_6VO$dSHY-R;?^jZeXxY;-MhiD
z`;Z1A+<$Kw@ZNdqb#DA}@A+EtNq3yi+M9YYc1E?l^sC6tPsLw6RT?@=HHwGP#UT2v
zqFF1U&m_6BfT(DsM_;0`4SrYOZw9?0U4CJV7sqOt8M*Gs+>DoaWaR?T&j%%WOPIns
zWX_W49jO8R0fV2NU1;*+%$9~(MDW;m1+JQUvplGtpxpm?&GiTwb^SZe{h$4Bn{!x?
zDN+7vPVOsBX#d+ws>oQF*!W6g_1e<m91Km0y{hVjRJOm#9u7q+VZ9iCAbp_z&%&>n
zbDjye$EsZv?}X9d18;q>&%3#@hPw*yS?uh^8@#ib1QmAIbq<yCo_k-8m1$h>`fD~^
z#a-&S-WXc6<Tw=P40JF40KS@pG;yE*$35OnCPB$f-0|6bvyRNF6w{qiBE<XNjEVJ@
z3jNU{I41`4-;1qwhh?$9bf#P;g*;fBjc2fQts^xIPK#If?1_l7ZLhAco&1X#9{z;n
zNU437wVr{WPc8qoC_Og9g};j8@u>c{zxq3+I0?$E<nj9edD_TJT&}{@2Su@Q_p(tJ
zBome3EF}ytZbasi<s>5m3V%qKP2S~aM?a#uH<lL@!aMX`1);#BgGjXnHV){5H%Lar
zKr?*fX=!Flbsp~zEiWsZimhWPtrTDI{W+Bo-DdFgEI7JVaUs~OmrrMO(>4Vq=Tu0+
zs09wE@?+jwIEwSEY-<$D(fGqT_e6t)6!6wxEC$HXV^p3>72kzgV3_5g%~68DR<AKm
z&s}?cKvu%S7eB*H8Do70vZ%J8Sp&6{(9EIwRuO!$kP2N_I1mw({2U6~8f`X<d|zMJ
zj>%vQZkIY`t#VDom#kTZKF2GHkQODRn#Qh7u|?h;Q}rs6vPms_-(w78Z8|HiZX>O5
z^hK-nQCe0!vEd)AyQ&qNkfaPvNXjz5&eDTB^zr(e`3Upk#DlsV{D(yOlutfe5V+H)
zmOpZ#j?7U~iE77gFi?al*0Hcn*Mf(M*~d3>wSrblxYzLH(m^Nq_HhYjUDG$sb$oYM
zeD{Vo$JGgChsfn$-(9tZAsaGih@cz-vn+)W+^tfdVe!XC->bWadf}}M??l)OxY;f+
z`!E!z@BUg(u&cP|;v)O!bU~<iQxJRQyz#I5W{=|P_28f{%KLVcC{eIcaI0yUKIc7v
zP`t^w#vg{b1!S9@mE-I&NbU~isgIS*9y?)h2G1OcNlR2A;o212#uEW0w=<FjCK$~q
zwtC`(@^@oWwOA0$j;m=_j?Y2vccpGt4TyzzXTl7}w+U>k(Y1yL6^3a*3lt7Pgt(E!
zw$Xj;J%1ch><%yNt5IUi)XPUJHOl_m_QTg$#$^tw=FQTQ{v|1by8E_oC%@u;5!IG}
zgMWB^-TbUZeFy%G*#RznUX8Gp`*qz7yp|3Gcz9)+W(Q|XEV4TbVyT{pma4$n&b}1Z
zVGGLDdj7CU4FWlQPnrLHMjd;Oq=c7jwA6`xS2*z+nH)4F-C<ibajyWQ6l`xCQqe;v
z*?si+<zr<k_5SAgg3SPlckg$9Q8BV4i!g}oQ<TnoT)^jjQN@RyM|bPX)be->_&_wl
zJ3SlLRqBP8FnpnI)jE^!jZ#vs-ILzZj*gAIdaZLU)%F#IEGm=G3k??bhfj7OX?Z^N
zuLiz`GG2-Hp){Z8#eDlogJVGf-J$@dtIwjCvDaOQe^!J9^`DIwgcE50AeHGEYAn!C
zjC%7e2tnadc%XLj%xp#)9o0mDL&Pu01q!=8MpC%coMg|^69S3OZFlQ2mW`ldl$7T2
z_nW9ej#)Lg7BGDg;9?5?jn19KciS(H^mKo*LsOo04xKBMvHT+LR5yWBoJ4*8$-nUv
z%Co=Dl|I!a9P;Gp8T|<%`+o7=>127a=3E!tzU@=UGxb*C(>7?*Y!2XfzANG%gJbJy
zetnh`7ng;f5UH9iNg4<W?!|ZB{$fX|nOwLklSZn?`fzHw9>lN|=uCFK!r0aw7h{mR
z)pA9yRB$$-_qWmN1mK^Lnp~)w)VH;9#QV_4C}M4aK*RN8_S#wA@?M((oxjw93+PQ3
z>cW`E>!Z~BlS7koh?CPq0XXOpHz+NRv>`07B<KW$rEY&X{(kt%I{_MduAIFh)Y07e
zbm6*grHaC^${7(fCLlfNBz-44*0<1+_epAady;kOCD!~55;o(3PAYa-NZrBEb!QSL
z>*Ir;QK4)jlbz{DW2&0Aef7x3du7x6GbT84*u_E{=4s!Hk<E%7!58@@1N+-wY+e_=
z#>GVp-L~=VKxxAuCc87rL)jR07tu2p$I&ZhG3T4Dfkw40v$R!-WNmK#fTkS!z8q?)
ze~a{T1!w2it*soVBw5t<+(P+M*5D#;LKZ7y@nNAy^xb#>JR-N~TIT&L|5;I{bztNd
zm0m!wpcx(H-HCi1xl#!wSt1F3cO-yYiLezAeJM@oUR#S_;hw7exsF_SE+IqPf$wQl
zHvGr*)3ZBe8V?5o<>kKf2*Pw8=D>A6C0)Cq8ZU}of=zh=ARZfie2|BCN;c7j5GfNm
z#oGHWs;r|{E6RH=u+6CDW{~--V9;?BUjKW4)`Gz>wE!nu#|&Wbs9DOc0QuViMmg&*
zR3c@8qsz|xy%L0zU>6qv*<)qSYj2IX?uA!B6EL2Lq0ejPYGqShEBxF~qLrukb!}z3
zKa`Vbl4EuJo4Z;qNS=k71<dbt*jdTw%v9;AX*GM%X7YJasZ<pP=6o!8Z~IlO6O`lw
zpM34EeS@3bBT3AKsM<X0>e;yY898C6F2b;XF7P|5-3-o{_#MgvS`#K*h&CR2+@0<8
z)=+A?CHi?o5YnL%^P4sZvqiZ2`TRAMDuP>z&b^9rv7OC;=*@3OVb3_-N3`Amtsk08
z0FKwy(#4o=fD0+cm%~P4G9fB*p5wtVmY9~**%O#vHc~=@S!P_1nI*7aQ+7EcW^ExR
zZuh1Bxy~>>b~h5$mhgBFCLj5&OFD^hllbR@mWK<(;P@c`31K;2jrWtjEUE;WzN^S5
z<}^eO=C5_4tTVd-O7s9y{SJ<8=_fOkvdfjDM9GZW9i9B<=pxTDYIfEQW(pFuKJ76|
zfotC&ui5cpXg(8ei_O)bMS|KtRaN3kRUZMmuZ+j}&_?X5EoDBGHrt2oj1iun%}~Dv
zVhNXtiXsn%4fn2!?dks~zb3Lu7(37NqN*ll3;?4(exbhjoYsg^HCTvvRHXRaSc3A+
zy7q**apGdEzV$pIgMR;%TKWsPVuTZhlcne(8_E&=jy0j}m*XUsv2LXx8gTVTMgAb9
z*K{dqX)2wXLg!%Q>GSg|fc1)n$40plbJ$PEOl}|cZ25<QeLKUMeK;?f0kas2=2Nlx
zSDa(x!}nhKKg2a`pNW*&K1Px0{66~j&21jzOu{08Bvz3Ab}>5Qk~Di>GWcF<{|1-P
z+?jKt?86Y_TeB7&Mi}}wIL`6q2fWV#M%UO*$@z+?#=w&-Go6^k_&3<S2@)NitLL>l
z<tnFpK9-7<GI9oY-IT`{3<Ov5>ayIp;2G2FT7wN88)<+zpa&MePM&1L#+3iq5J|wj
zh2PheHXb$d-gG};fS_ne!>qh|)?XVK(bKb`W3oV?sd8`4u=>#lPs?uoAdktQ8~9s@
zoJB9-u~+k(=dh`6G3A6dFQmcI5NKbOI<)6^iLKfzM(VeVLMpBac(2Jr?l!g6VAuXz
zN-3J4iJ*7roNIK=LzK@tfY!b<GDVhmw|V2Q<8zU#Nr<HeEP8CgAyPDA@5PE=9y5#P
z;ucRx<Y^B?z$LmZW@C>V+1b)dz&ttgBy%*r?7V8S76qnqlOnY!4~e^<F8H|}s7YD&
z^9JfP2|r;$DR4|YvX%A-E8dh?qrb<u5BI{5GOi?qI~s0eUpXr7-+%|k78)UUM-m3;
z6Tt%8)+69}WxtO67pL8=Rxf!T=o;Z=B+KrTw<d`+BT<hT<ur`5xYihNPT7p10>l>O
zN~Y->AwqICN&<r#r5N>MX7fAw-zdgwZcX-;^`0^HmMV+9>`kpt@Q9rpxQgNX-Us$7
zcqh;)1n<tu5(q}uJ#ZFdQmSp6G=67+{CbMsa!A;T_z+^fvG*3zb4C4=DNHMj{83m4
z9L1h}i>`5hMuG*wa#E2QjjC!KgQc%?2fx-d?Fe(SRs2Cde8YAQglixjXVwD(k3I5s
z5!_t9TZ9U^UL-g6mG9bppNZZpl;t*PMO7HwKjG4y9efLol}xJ+DFsbme-TK`NRV<P
zzNl~B-m!65+A3c~r)u+mva}{;5VC`%H|~AGfAQ_xc@;$B)9Qok&l==yHK4hVuSC1#
z)q~Q8(?6&%WSW^ew6=2^SxK3B!6QjD-bcvxD3-L}44h};AlZ!`S6W5=7s*BHRFLvq
zjq(?Hu7uBZ2ni>Z+-u+#rzk0gANt@}ecS|I9Ra3$QI%{;4H6QCaY=zX#U3r$4t&CY
zv?QMK#crvN(}p6y-nI?ADIvUry~&Uf{X$fFe-#}NDVv(W5am3|I@;gz42o$qPDS7(
z*{paU*L$z=D6F{ni(Nbq3?JA$%-v$cvZ(2{2|W3b(xMtY#C<NCC^Zz0h7nC&nFQ{|
zKP!D(SFasP)=IMm1fieJ5rk6+y`&NPY}K7%*ui?hAq8B<yZ(JMrCO40<td(9JHCTX
zQG<X$<tfOoX+2Li?!0>CPw-zIdMW1bGO(FxPsW@`JKsG{W$3G$>h?rL$Vr_(KBu8?
zaj#L>X?0<QIiriXUOU;Xax0r!XVYUh=pXGD<itEvt7qO|`|N!a&7T0}_Igz&$s*J@
zHAa-fW$eq#hE*(4lgyhVG_YuHfApOxUgQ2zFD3Z9hSj(kqbvcMJ+2G;5}^&gf%b~f
zs0Iu#*sE<aJ#VnH`R2|0bMoABT#)zWq%Dl>gjjso_OW(-%+^+4yDSvNrTmEXVr(QR
zd725@kI?8j8OC^NexN;F?pBhp(dgm?ni1cUO+ra~s8rPhQ}uH(vc`Df`}bk>%(yxv
zrF*_WOA7f_%X98X`?R9#9A^{WJ<Pnn{4!Qd1?{_Sk$Tsn-0hPoSDwrdf+FgV{HGt`
zI;1#GZ9NzSNH_IMn2&Ynb||Tvy+cY>ZQrB7e1&6ngg(;t1&uEY)unRuxjvi)?NG(q
zdeWxo&Wy!bB@KJw2I+ycvCH0?kW3Im7zpml4R?mFk$UI#K|afcej@1gL;wOS`msq-
zPLToBo#0iw_c~Ht(Ak2HDpS5j9v=qdOepfx*;qQ|y$L8`y-oh9rUR%~kQ)Sw4Q`S^
zh-5I3JmzE?VIjm>%6$P1Q(sa@l2ioA>o;p>O(P<f{EdH*0{{=DsGd5e2N`@WQIr`5
ze5WWXL=N4!vVIH;Nm17Rjh3;>l?|zWq(IYO6SE5Eu$qcs2!6qheEynxMd{;9xwt2K
zy83V)lGM~8rJ18hhEIJqA2uJFNUPQ3L#rR>NR|I&$umIx&(jWgNOxIMBy}y{F5kp}
zs?xGD&H5W^4L_I14k*+grvw*K{X7I#U3S=nOj`T};_T=5phKJ`{nTwKWVhzx&PKuJ
zG7{Kyxw?RNsNm&(5vfqSiFerHT%%BW7^+bP2vz-iQPgsgfQ+OvQwVIjESjRSWSgC5
zTL^Xj5z>u!48a-Jz1%M&L;B`IHkTAi0HMw`RA!eQB@o<mlgHxL`He9|$SdUsl^Ncl
zHz(65wcI53)L#@($U#p{F@Wa___$8btporNJS`8|`POt+G=1Drf1Kt*FbAwY4(SFc
zIM-Zsm%RZoZZm2UEQQ(tLb}-&03oNi)8QQhfK>pTHy`JyXKMlAE_DfaBi#VD1)Kvv
zWL?1~7yvkrnE)z}y-UsdII-&&3FIJy5_95FE7=K?r4yb4T5-!q{=M{&4PO}Wzje6i
z#(n*Hn%V@z#QzT9u4*Y%NudsRe%uHD&*=}KvX}<|fK9l!RML3c|2xbI0IUN5O7qGE
zCFS7W>^ZtAf&;8x*|Erqc060&llu4&CrDZ(c6iP0v^%2tO*6*>9Q-+C4ULcawOY@P
zrRk#Gwo`Y27U>FDL%UKfv9a<_{hjfTN*1vg0}xK#hQ+-w`qT)F`}Y-^e7H{ElO3kx
zMOZXMj8=s5`rcx*I3*Gc@hEdQ@2fBfUs0lB?i{HN&?vje`>LOQZcEaC>QdvjPIE7J
zI%q-Yo;OGG+RA`|QvyH$c?qCchDh;ne2y+>dpR<V*KIMgbzeIv()dy(*b`pQP<w8~
zaCH@DEYfnqX~)IemY=Cv6gb)2&iz}i;uSM;&IF}5{ra{)a5pu@p+UCuNmJYRz|Qlv
z%fr)+6CD8FIuDzI%W8*f(vV@$BO`k<rR+QhtvED#p^442w30v8xhn`%(i=H+ICnQX
zxsq4rxHVqHrB#dIEh5M$%wU4z<~lf`B{z!2Pa&Go>z?o0l)rCPtlb*r?ZhZ#X=?eO
z+?MuOfRmF6e!ZGrjzcPFP|b0Jo&0W?z(+CrDx>-5y{snnU&$TNPbG~mncr78_q$i-
zIDp;;)!=~B@q62JqN}jx)oVveqUbRuZ9!=!K{Ln!;rt-Zv15X-@mZ_;!)Lv8(q~c{
zk&V+D2U(Dva~9M`+kx+DGmh7!Rqu`l`ppE&xQWA8cmoF^j4;0E2YkB78g8K~U7_)O
z@>~e$U0U@fmq<M$wjVVIrBb)sg06Dp*`jEW2{gT$9ADyJbC^N3!NsUXMNgdA43|#A
zNj`^PQ#voa0>?O)h{}E2wW*$kd~C<=Apd;W(ECsBk+73xCc9J$eJ~qc@`8qXQry?O
z<`&fb1=$p*3HHO|;CC7yYPLo@arvjk%*UO0l>Kb!A_ude4oZdQmA7rzQNh3*ML)>J
z1=x!fbnOr~Oaz0*3O9={*YS8SE9Kca6bQlljkG=n;pmk=fS9pfK_D%Oize45_3Yd7
zzSP=LZ!xt-PYyl!3zbCY=K<SJ*A1fTU`A0Rc4V6USjWuEjNTh6IAc1&6PcH}?-q-?
zu!6-)!t<Z3(6GnDv$f+ml1)%<va+DDMm9ps=gPZo$p~`wxMA4sjj9InxI<l><n<dX
z8veh~$=dQo`rE5=4a}-o-9L3fZpQH{cWJanVqc0TcVEX=IP;&Hm#f9&48~b6X=aM%
z8eu|v53@fJE_2pcaP^@gyztU=djx1xjDm~_lOl^WU56bh9>nDQT=NKA^5-GB@oZ)j
zV;X+hd+ki&dh&)wt`hK}OyTF6+e9FGyXRSTIK9*}Bb3ZVd6o<6Zj{GY*_PJ%Mh?Rr
z{R(E2(N~G2WT5!>1aCE&Z<Gn!g`On%=~u|-QSxHNl=<!xbzY6_Ce1(7BI<vhXN~h)
zP|SyBv)swEK5~N@N;R9T{MSaj2;TS6X`0iF=!wrUpTsHg3GKf3T@em6x-;+u7be@A
zB-{l7<u0CkcRiFVdxK0RzAGnrjqjy#^5K1X`2z)Yq{;qDr-fN4BB*?lX5a*G@fdSh
zioRo{XcUHesGARYFbAx8p8i$Nr%32(NZuST;92E7Ici@ld8(_ZtLHPdI{gR5$Ab@B
zw$Q##9W<g8dX<32gw7W)M~jD|icb88x8TesjID4}`oC^Ylvjw`7YuSZ_!6zrC=J}U
zMU@Vez=dNZD)KJ5nPvIRdZIgyzcCNAK<od)9Qcq>jYxd9e=D-)$z-Q#(}lp)BI?cL
z-{fgpnT#7el<CX74yRly-5G0=YKhTZAlhsyt*P6c@dqThba2#>{EVe_s*~<=hKN5U
zuOzMSmCw&qeqy&1EG$+|S@75QI$Q7QmREt16(Mh|a30~$S@LR|#ADfP*G&vtT_6+}
zW}5xmJlO@{*H`}TVvm}cGwLo}oVWE@Jjizj!--ezWp2iiBLp(2#kYl^H8cPhvpnSh
zY0+Q!kGQN~XbyuAqCUai!KJ^)X?D1*DDHbYIe6vnzc}M0EI1|)F0;TagPCQl>##fx
z)UNC~3Xc#NX|EhB&Rz+MJdB30y$(u9MTY*k9*mQvyU}a=GxNjR!P-guT}w)wc<5xS
z;*o-$<zJy+4a2?CV&m}^a}522R(Pp^=QnTih|O=o>X5rb?}JHftSfJogH^Dh%nlCC
z*e*Bnf;Xz;>69LMh!k7Wd6Bl+j@4`Jf(Q?dov;_PPqMM}n`Rct^Yn->Lr_(UMRd7a
z^_HWs*U$(QC2~&P_v#5lt{VI2R@~i^1xbGqXdluu2;M-0;`upFU4|~2nJ3eI!MeR=
z-c{BHiX$x4&A-sRVQaK;@E5z20mCplzEIXM>(tB!!*KCI5PGb<%vtsWbbu|((MF@4
z^meK_dHlolW`lAN{yJeOTCo#8xRUFb?_7OyI35`az6UoGKl2ZHsN^jtq%+)19t-Q~
z90ybU=N<W}43Av>5yIzvFVp+(KTMe9B5oh%Gw*DdXAk_v{M6n&ch=e7Tn$I3F}7%d
zZZiBfHyy2+t_~?V`rj_!dx9PVC3o;QrMtkifP<BvN8PNycE6tSS^UQXEnrN2aV;yl
z!_6O@TYzqx&{oC^;q8?m&AU@7IAv)vd23n1iDkEZ9DDvUJJiYjL)Yn5>jN(cF1COv
zyDu?J+2txXYVSt!w204B+2wMP=<_Nhyrm6G+ewX15)*s#X*b_Rdd#VwaA+*KT~94y
zXBp>n*o+^Du6{5XSvegeOwa~VzF)o>MHfG?{180n7Z|CKIxLGYdZ%z}e-VEjwYa6f
zaBk9K<6MXQcz0gysuo3y-=w=}9yBg*f>+KO=UQd$s7ugnh&RcU<41a-6mi>wZItNi
z6e-DFjzgqmeKLp~54RuTbR}?UP|TY@JS%@{01D2e14)#9<v>V~I754QI16YzgC0Xu
z&W$^4@y`ZYl5rLw>oDn2H=09HUU7{R&fi5{J5UtOz{UAjDMq49-3H3;hAhg=&^wE(
zY<M;|YJOG`ubRbFs;^g()~%(xU&cZ6t?Do1u&TdK1QRuPtFm8SMNW!47<7;+7Ek)!
z?0gb8Uggt-ss<Z<>NXjbx?pLLrn-8x5vJB2^i&#vZ>1}D3T@+c+hDc*>(FBUC);h4
zgDBwYA=f)5n&VJ!SQQt0Lb#H^KXcQ+KN6EXwTAKOmM9jnEqeF24Nm=+mTGzTa)btW
zPoo}Wro58*!)$okbsNJ!V=?LNFLvE789K1@-q~54<S)Az*FG$8=Dh?$FgJ(&)y>t?
zvCc`C3Zr}k?cM9^J2f3PUH1zb9!~Mg<DL|a!g_K9CyO538J^#y$HZ;ObkF&BSOZtM
zLDggOwby~KwNCd0#7BD65CtnP8S+6~sh5+_OClBYWkmRPlT^4QU<iqRivjfsIkaj8
zgHe;q(u$#g_jUSZC5Y~8gvm_XC6>K~U1}=g@0NAv@f2R7i;#?9p=ObO`<PgcC)d+O
z7n$`R9kY&g&giuML#CdVt@28^HFHk80Srf6c9Fyd6LPyx@djs?{#S1yyk=;es5bt7
z(vr@bYHrP1H1JB~aWG}$dz)iG+$b-4B4tV+OwGj~%fYamh2abU*Nf^=wt3nEYTj8n
zbKPJEgE{<o!sY+-`na-9ngfPAJm|ur*Mg2$zkB*`t?H^h0kx~~@N;lba`!UU^Hrg8
ze(T%fQg8HnHk1FkcG;#yzPoj-;~*h!_SDZs5B**ThcABZavU}<Kr;Md@^mk4hAmgU
ziuKzNeEsPCIoykeI&07`z$v?ad8@F{ztl~gJ18H9g~bUZ^$<)Y(~ZlK*8L>mjFw;u
z+qj`Wi@(S7x?}_MxP-x*N1XnheD?6VrkThl6LpStd&*iym3vf?#YI60WzBMo8?xgh
zktW6H_RTq=4Nrw#6WO&s3ODKm;g_ZCU&nJ@20@dO(g60)*@QMG7xgw`wVub?p?i6<
zm9vLlPezDp;%xr%(v*TmJ&}UR7cheE(3G?iCWZ*Dj|env<`O@9o<_X8xYCI#Or60O
zL9woh0b=7e<?%8Or?6kBg}<Z}dMNJ`@{{n|gwPz92&Kf&5uw1x$@)P<ZSAE__LAv8
zPq=Nr1xjM7jv8E^d|Wu1fA~1R|Ke5uw%t&IRsrDW`3JfAK<GSO+xU7T$;KzeoKOS{
zW!_BlXxK9Q)Z-Bzob*;lCYfnrcLu=&?FBJ%l0OF(Cl37hMIuhI;N%a==Y~5WxHK}b
zz4@&h@<wmn5;`dL2UxJ|!&Ja2d7cD#c9W%2^cbA-LJ`NjR;fFj-pOupze@T?-q2S&
z;)yPDV%8tP6~u2G|H8@sy8D`G_a8(6uVkQy8i)u`Dl@YwAs&93;WxUMWT(7!B#&ka
z6@V;j&0>dp7k1nn%tMW0v3hANR6u?Ou99~pmY(JJT-;6qb39nk6t&XpKZWB7V~6|f
z%T}(C4f4_#Sd8}a5(G;EcL-b9GxsV55?+KEY)TWwi5Eu59R>dQfq5(N{k&@|HD)hO
zp4Oi#colv36&5SwXD%<Oy8bHclPZTKP^Xx2EANSQ!Wn^y8R7)6d50H{kdNu=ef6&0
z`CZB@2?pw>1*bpGre*FLY1O(?-!0YXd}y6wWWI`bD7pLRuJ?qK4f^a*gOwmPn`D1l
zLWrryvh&5B{T9jxLorJ)<C5mkM>oBa>uXuBSe81?UZ7c|+^Wky04W_$6H$GzUj^}-
zm!t!xR<!jIi9P)9(c~v1?Cur)?pSux*CeGcZyN!Pi>bXwN$p!odL)n{6Gbj7oc&tJ
z`W1(spGzWRNTwZW%IMo%mt>Hd{WYJlXg(B0T^KEy!PObA19wPBCQlKuT<~~AE)xiA
zI*@l}8H@K~a?1awh8X=CSLxWWtnkJqJ)a-|<R><!wv51UNgAa<F><DnAErNMd?Fpi
z&bp~&LrPVy>1m|gqGorsL8T^1t;_#}XbdiZ60H}iZs~-rc(oghFD8$mAcFQD;8;Il
z&taSNcR)fA{m|Vqpm)RrTmr7>U^kYO(4_*g_Du*=3TAho4fRnIVE;(CGGQbA*I2R3
zifw+rR9mrOoamOf*=nO!&7<K+M6|{iYb4L3*U|F^%lCekV%hvCq)aL!{};Az|Bs~e
zj%M@y|FFGRsM=d;OYOb)s7<R@?N!89u~!fkV$`0c)!J0;O;D?}6t%^wofs7}zkI&G
zbL8+>9M1hbxu5&}dR>=p#^p_3@JCp?BiJ2meZao#^CqXBbk=}*3O!04@Vh6c*IxBg
z1Wyq>&QX?kebw*d?V_q~8o5&R<3plS%AFMcT>#2BhwoD?f6)oSGX?%ld3}{~?rm^L
z^_oa(3OHoh;x&&6Zak_Inp;9^O_Fw-JG+ar>eK$0lQzch$g#?@A&*J}DEGZMAl=dP
zHf?0T?(MewG0}GyvcvV%H!32iI2>C*ye?F9C!t2?M@vMOuSTa-hY}42_dF%~mfJ1X
zreU37T7lMs`2c095hCxkNXvxGE>(r-YJR=>avT83Pv)lcL(fI<q?9#(SxgKfj>j!K
zEEU^@ewmhI7B!$pE-Ws;DOr|VGtUW*#Sb&4wbMd%xi+LHoWJWmPq`S0__%=Y1`a7O
z?sM-M*)+{ER0tl&8w^yOK80(zW{=eIS#I!B6Ap-%;j_!75q@1xlykG1{c=K}-gO4U
zFYY&E>&2c><|5`~X8v|z<bHUaWbY8tev>&sCiYDE5`PN%7G8v7tQS2co$teHM`vUH
zjwO9O4@Pn?mg#PtL}K~G;DN76nP2gdN39NwNtIEWY~HD+z8C2-rK23Co3ggqz|-~}
zC#m=17>}lv$H7Hm;l3)OSTd}7UljxRffb2?!xc6e@D#)!#iy~PM_o>`QeUd^2Vmef
z+FO4aCybVjl3>tu0QDdG2Atn?IZQFa9D>Tj0rp(XA;x(B_R*zLm*d8LXbP7pvkOsY
zW?FN@T<T)WOb6;z`GH&Il|ppY(xhnLieNf>cHbDDll)8K+h9~-Hd6{ra?8cb(CMan
zJu>wPj7#Cfsw3L;WayE46h@H}0bn&igd1Sb0NQCMrV1=dP(@4=epE749ei(oEs~7-
z9b85dod(KHrg*Q0*cz(WZr_c|_UIRcYf<&m2`eLbcE+7`i9|b(HG24msbv58jVIB2
z1&o_^Gm~P^J3GQ|qXx|zyg#!NmwT(6oikIgy)FXQ$mMP<?w%fN<P3#;&71J|v&<_Z
zNV{##z^xF5J5RQc<#Z?v_B{+1y0HT*W@X}D^40F`%Ho;m{tA1&Mal6Ff@?!GFD9M6
zO!jnov;Lbh3Fz+5;oWWk^&O?PyG~`FdfiXoF5M7B4`3NW%ADwmE>W?YjRvr1p)evi
zpToORy=`l=M9rY6YwbB~(VeDQ0(M(m@;(@n!)$&sFGaUO9DU?k5rkTmbHRJqo{;nK
zRgg}85&34BGmMJ2=`Y3>-J=+%K%V{y^F@VIH~mQDX2{f+<!_`o7+8p-{td0An)9-(
z1A1Mf)ZL$m45_e`;kyYQjADL+-%f5R%%^*VJ2!Te&wo<S)cITG`|lY&3x3Dw`?)Vh
z<G1dp>&Bw%52%}e|GwN6#1W&_BGJ3z58Z^NJemUq^n3Yb0ohQkMh+p%`+rg^epjSC
zo?}s7145mcSNqa|_8+b?p}<u}W8|+cXZH5@VE4gUF@I{Wf8lYMP5~7ZVSppxFK~AO
zk`!9U!v=_jzy>V(xV}Mj$~gd}f9~AWm3Sja0w+7GGR9kN<`OAKe_cvZX*#$-AS;4-
z&KkK%&Zy<jqqyTaI*MAr=p9hpXmuzu@kAtA_)~Rg-U169{Hxz*yZnhYJyia%@>_5T
z_5@|2`19qQeX=e0qmr734tzNE!(T<-V!{T9Q1{IyH@86{jZI$Jh156%iUHbD4bpHD
zBMJLiBI5hZGum!Ws<=yq*HdV$C>qCA$_v7dgb{@KJ*9aek&v|36}2o8Z;}k<m;^uu
z*hxgmPYsx+nJ3BgP&A3)SfB4^+37;wPWG}OLqVV;neZ)H%4g?AWz2>mwe6dUlAC?1
z^5bd63INW(2Hc$oj<`oo8TJ(IjujjXpHtIRg3Ir#l=ZCE$9@!zMbVwT8SvWjBU%or
zyLw9ban#b2x;?uXzA1gB=H1tev`oB)fGfW{!CYqbwVEU_*!Gmb2CKNM;~2OBCK0Z&
zTul!^8}WwRBb23Bl0#XdDe_tjQ32l9BY7Ogk90AtXT=1n=-c3&lYJh9p6W=z2S=Wp
zf1fv=jh*hIaZ_v4i7@D{Kohrlf**gL`A#3~`t$4+hHyUeIH45Qp*D)1mx^Wk{__|+
z)IxUjUyTVF1ph8(R|hF0D|o<oxUxa<BYn}4G$agz?vL0UiTml9UNJM3?#+OZ3@!PL
zbdAHdmQtLnj`R`^o$IgWrCVcX+H=aIPHa@8-ki6bpbGbh#hbwp!4#baKJKy04_7tn
zGB2ORY4{X)Q+PN&%KY195S4V=2lLlw^-UeK@JhxRe1QR&(3AkpL6f6NO-^t<iy>u%
zYd_D#AsbtO)Uzozb5-)_UOG>F0X(2deQW<F%Ww6~V8N~MgWdtw$IU=7Gf%eU&C<s#
zI*MoZ7Kya{uGq-_q{AE@q7}ruY}Ps&ar;OKN_`G~2B9Gy1TF}cs^MVfac@TIfK!B5
zphI^TQqV86w>qx|F?J^#STu$n?s(;tc&mB<n;raNo5O(?bJ!DKu)>vt8E$XVJx-J3
zM^2X8AE-WRo$)r+v1Q%|^D1<~z;xjwP)C$EUcI(pzW6n0l*mv-JAmM~W8A=G$4BA5
zh7x;Q+w2npmANo!Eo|nMWP`s?<gS2y0+0jDf3tsICOKI=4NT1ZHpc@e#U>SAgMGpc
zK~PZ=hZ^l9wyhZF%*bzePIiD(`)hU{A<pIdG6yP~Rqqc)3y-|<qsRu|g2uptxb^^L
zoXr;-VM5&czp1@l2j2#xe?_bf(4XJU7s!osFf~)D#togd@VGDsU2&?v08ac!m=E&l
zg@AA8#7oM;-3rp+c;@v~$Q{+n(7T>fOXT9Hmna>Q$s`QN5_4(jKzQdTV>AL*p^3Y%
zQ@#~X;`q&UF6_+OH$~3#jhpvJBf(LpJ~b+8SW{ot3AZYklVL=?<5al-X5Ez4p}9_-
zR#z#Y&T;u2{-aRM!r8i1w%p?nU3W_w>bgcg7H?6$*T`p}&ue6X{o;aYnn+|j;qoFc
z2l|1(O^s;EeOQd|htRhvu;*yamzHkB#qe~7Y<v(Fu8K!a(?rt*Du7G^;us-NvCq93
z9D;h`g}Fb=5eiy1Ix8ORUQ`R*Ye$z<0D~w=hxymwfG*zvas{r7wu@mK<S*RkiT||p
z=}EeZR*VRbS7W|%J_DLk*FG>jX$NU}9{MA;Mgq{V0dZ%4d3QI?!4(iUh$2nq!0nsd
z?lFx_!uc;2waNo<c{%^Y!<GuTgAt~pI6qti4b?_)w>|BX?~dm~2T>9~-0qL+<60Bn
z%Wot|;6Jcy`?|3~6rkJzQY$ChR8;wnBdpzV3qB^Kyk$*QWxtT!j)=1omI7U~>KM6j
z{`~&d)h!I2gM|gZu^&r@llEXA`{Ce=Jsv<W08o*Y+5{(!gTUYc>7KOdu7>)=7ab@J
z;8C;7P8XlY%K+oq9SW_X-F+ULM@ku5nk~+J;(8<IhUiBN>{Zm~+R7SjlpJNMB2*Pg
zFq=FT9APlGh8w6$d-(|oc4W6|5yL@Rf>bhu-=Q$`kt9u`l<$9_)s#4u_V`hqg<o9a
z;02Qd%QFj>$%7VJ>^qwlG~Iz1hTzhZZSjZV)qN4Gt-*7QkmrbxirL~0CxOZwQFm%u
z{7IB)|6&B_j4rvpvd^HQTo4pBwneSJeF3S_(B@;mNDFtv;k?muRL4vr+4h_}$qgrU
zV8RrR9r+kipagrbP0<Icn!l}A;lElV#eqK0#4bLQfD#p;t;8O4OsGBM`!^o2P*jn&
zRcCa1Pit6BMJ&nm6l|AKa_lb-m&+Bq;k>_2-hlNb<Tm%WNTh`epV9-w7bodwj^@0v
zkgiUI$PYgEB)`f!J|6l>-X3mJ1@99(mYsFUDPxuk+z&!SOd&okQIpeL=B#f=G=aR`
zF6rBwUzCR<mPD_&9zXn3C2?~3OLsMfGI!IzV;7ld;fR;71U;@+c&Izlb&>IzLehY2
z(h7Y-F-KyT=sNXFM)7Z|z>q<1yKnm79SaQ>6>ZyyS4R9t*R{l<kl`kMt?f{SP&SQ7
zyK`Q#$1qk~!R4zAALd%XRJkDI<fJ+K*KdAwiCsABLd8wBrIk(r4W}$>UetTzA({*m
zeVEHP+ozZSG|yg#!$uFgmiTH%5`rPwut(@?l7_GHOJ`ciqf<b?N2%M$k6P_A6J688
zbnq!ac;J+RmiW7Q&Ta!};u3}CdJsg$V3ZoOK6IJszD@pe$quc)Oc0ADoYuc61piNq
zb`#xDuC=^GO^=&ZcXB`+_F#|g9yGD?)+M5KlCgxHFW6@({HVI_8U@1?jNj_F>-488
z8zr=rkg~>8FOn#oPw~Sf99`qID}=sHUL$(&YCkvB+_3mZwnp5(Rfgrk!b5s^F{7aN
zO5Am7SJgiaoS0~;DGx!C<eNGh&A)L%FN(2@ODtA@$^1Xwni6kUM|~zc=J6{GMp>EH
z<-@n=*)V`K+Ye~~srP|~1qe0?o!D>`4t8$S>TJz;#&PHG%P1auHnho?%Gtn#`&6tr
zNNj<o)Z~gv_qB+do}B%6QX7x6J@DdcB^|XJl367}1v>_`1|SIbu?4Aj@8L=_<lrx4
z0bf1~hzFmLkoGTe$c9VVuFM~nb8~6fT2k%`fP<Xl@(BSggWHhKUaX9j1g`rGm-udz
z{g(w48;YiY+X+=X<uRd2_!<)YM~F}0d)dovGlW;o#e+Y$x{d1^0*~Oc`j0YX&og+x
z`mGInuV!)}CiE>B$u@kb<sPTA23=<}`j9ZFK`Us0W1sKc4XEvG^;L|BeG)56ULQo0
zrn6jZc7-0SwcU&e2?;m{S3(69w0QZ&1W;#8A1G)Bm=Jv9Jv@Hwoa)`ubO)JiQ_P4i
z%h5<)Rjk;6_9u@}zzCoRu=@e6nW*xZldh*)yLm1)G}_Pod^&V7YkzGw=}S?iAkuU|
zI|8(qe<HWB(<Ds4o-=%>p3z&!JrPoG^V107oFybB(#7>_-<Gks9zVq&$pGk=rXD2u
z=4XHTaZFZ5(YKXwE)OfO$F711=R}hGhnu8@6&0qH^(l`Ijy+?2h<k~0bWH<wO+@AJ
zW3VOn|9vInioB*`HG4=%i~dbI%KUkb^M%5pYm0$2*H2Jgt=}3Q0HlSktXCLsOBP|N
zIaA=ur|Ey7q4j$1O?YcrxK`VQM1}v){*@AD{Wv!9!UV^tQK6ljf+l*bWuzdL^Uv|P
z>PtK9+W*H*o6{)9s^4jpgYcYE5RN5_VLT^ZmB5w1a66A9m=ab2{I>8VI$bLv{_U;`
zFIGlcg6EgsucGl_FB8FC?<nnK32Inf%kaVM_}9Lm7*UTD+#fx@C763W7){6qX~<W^
z30NS7Jf=JuAI*tm(eVVAmq!1!DdgLronv6YMve^<jc0`L;`aHx^_gc@mCmPuM-h_|
zQ}fI7%Xbk}iE3*`>dWtFBTiIXcY3X^Z__f!aYgu5(w{sSn`M+7FPIz!3y{3)Q~lU9
zqv~Pw9Zw15!|Qd;=3eN)VY#V*Z4)jfAgzDD?#2#yQGe|sy0v<9?MF6n`s5V?ar8pw
zU2`zomHwF=QOap`__cX+t|Ql}*ddseDIZ{<9)pz+tNPS&(@X(k*?D-S%c7)HZ|H<I
z#yx0;;d%kzZ|cql;r*_vxW?6-T_b^WERR{|RHOP{pnw7>VQA`ge3}E1nD_Avrz6HU
zH5LE1*~e1HmS(P$XFer{PU1<#)lvK{@l2`hX8sbv6i2p%Hd8j&VC9)`eboNYT*&_O
zv=S*lRWl59pHuPQ;9?2iC!7PZTkX+;C_`?ndv2HV5#&)X2Ms-Zmx4$vuT<BqPFM(=
zBMi5H`rxD-3k5j-E47g&)_gs`bP~$GZQ5&<iB=!L>r$g#U&DoKJ5RAyTL6g=bRs+B
z<TV3wN^)c}TD-6>$%RxO<^k;Fmhmy9Tl7dCEDb>SN{}UzPEI1W;hCR*XW1&rj{hYY
zCu!!u`}&uB{4yOk27vt@wNAZeflAv$H`~4WcHo8~QpKY~K%!FS|5<;?$zmK@uxs4l
ztL-KE?coaDnpJinfQkQ+cCoE&&UusB!_%(dKs?Anko!izw*1TE-smQ0cFet%%fOS{
zNIMk^oo%8o4-Gmy{e`ANxuh{jidP|T5^oS(JQk~>0=5r&8MZ$^1FWW=2OF^c{~wJm
z<lIxAKOKnkCOUjSN%{d9gcWotMnW3E4MQkV;pmHR6C6@`aXT|IX1B@HVVEo6Qk~V7
ziy!C_JqwMmp>f0pIF891L*l>15o9d-R$|h(f1`52PeJ>C=iy4gKYmP9$Sy4guo&`v
zx8tYbl*F9`OV=5M7+lx0`tpVN+go%@o;Vdr@o!`Q+^upm3C8uWnF6GREModBlAAd&
z^kMPhdm}-6l_=#?&o|bZN$7X1&?)kgs}KwvDAXPueJcSb;z%CJk5Fy%wi`csm>e6)
z3Ni3^!(01hxz|sytW*)zCA54OO!QLpvb5mCP^w_mLz%{F`KlAPPk$LejC*2VKS9dT
zzyY7x&<AC9`0Sn{o7E-t=`hlDe4h*;UugF&*P0!*s7;I`TdZ3nAoPZJoL~jd7aV3c
zsH@z<O%VCVh6LZ24S0a(7nOkxf>a*L)Ql#tg4Fw$FPT1es{NRAMvV?^uE%2^ha|PJ
zsRU8%%Sb4}_2Dwy32oS-DE74?woFXJ6WTd}Zyfp$uPV<&sh~IN%vh*it0)XY&1>!k
ztmD-`46ha58F>S}ZBvcSoVv{o^5R_m<YyU+Gm?of?exNF-2&StTtL{iec|*9$+NCV
zA5G(s{!~Z$m(W8xR~E=;U%z!b&nI1@Qo<qS6`8+**6%-HQNxvEbfw_d@C^QI|Nf2q
zi8S_l*g_z4UC)qAqwLO<Z9GVheGDf0r2u<KR6gqi^b`8=&x-`l0$@v3-j$qPMUQd*
z6?IjFbFBvrKC4opI`(|~_`e@<5nN291@gENL+*FqI{UL?1jJ2JmuhcyiUMr-jwrI+
z5qO3(Nu<LcF9bv3%NoJFa)t*G$bfOeQ*J)<5Cx=<3BaZ}eXAfCkh1mTiL37RXdb98
zLAzkim7!En%S*4IU1Ie8ut0}M(f9hKg1#g({9mY5Cf<c&Tf2>e#VB&Q+qVSI9F9I}
zXh&JwUBzdjq@&0?w7Ln_Ft<3ctZq&ey8?;2M^Nvrb`l8r*xprs8rZ)QI)7lNZAX6W
zwou0aP3LpW6MyhToQXHDeu{KmpWA51R`KAlm*U-U2SAqYsD}<}$5MXVt(=pgXWV&Q
zSw%oRP!vF}bnj<()HcRV_hjd6wfHlxp)d{Emf#%6rTRZ_C80mTRQtvVbggVg%N&2~
z*6`7-K?p*@P+vbPX=~8m`<PdspN59_<q<l6>&%ZaUF_U!EHLdCPuyjyR`7U%GGKU+
zkU)Z)apAIOgZe%!3^%0f&VMq__MRtUdX*2P+JA7<x(J(%%50moahO&4!4IFb2Tlz0
z@!&t0c^2QxtN+px$|hRns?BkCo2%hmEZk!0Vf0c>?{$gt2H-_Cj<wy#roHu+o_5FT
zcW`um(mRwl--NZGmb*Gd*aj<fZ1`z~2mPM`P(EZlN$`!0>J}U}5&4@-U~x-%zmdK1
zWWE+5Gava9{{t(3l8{W^Sv^=yLXSYGm#5UtT_sqoHyJ6{0$rNYDic>@5>?Qc%fHRy
znZe4Y`dPKXqJHc=%Di9MW)Q+*n(&O(_a`=P#(6Ph)C(__1spzIB>apdM}6odd9uZR
zV8yCE4DWV*?Oh>HL1XyMr1SY&RkRr$nPj?P?(WPwO6HvSc95!oSfsqH)dL3RVnxYx
z8Nrds;GKF7Fm?%$vN!vXsW7JNJ%0~nt`br3phJKB+<(<c>i12tWJ9v%J5}QY)2yt{
zZt;G-iY)<dGU8M8!t=iLZU${N4FZB6DHAt9x$go$B(nrRa-pLd0>&DzflhaBzRyWw
zyK5}SQ5@i=$T-?#_Y}Bhh_l5#uO8x;Ax(cIXTys4i`-gl6<%Kph1Vo1F6(6Dld#YD
zLZK&?sX<X-z4+$_)v#;U{E*o2p?BX>?OyHI6md+-<?mOd#3mo%4(p226x;-HKf58K
z*eDUs(Ul%a+xK$S#1b2Q5#1DD$l~~8)wm@FIys%cg~+V&esdDl<>h-&;j7_ZBZS)B
ztaj<ELvVkk_GX8wd&tyb)n<NF3WBgoNP#!`P2KtRfU7Xgvcx&Z6^f(hZ;{k1W5i|9
zRrokWRmrT<wX_y9*kG`m@&KtQ>CG;1>%WQ70vZ>M5YF85(VZK`{k7$Xj01A|1-UjT
zi~{`~$$1_@MgiG85-J(bk**cW96v{4{Yr`E&QWBab$I&lY+krZn^NO$aze!*zHhl{
zXbiA`)&`{3FuC^j`C~a3@e`l5;;780RtN=cc!9%kBOHW9lw<d$C+T^#*);uuTBt`A
z&K9{afFR@flx0qK@R-wo001fSlo|FS#M_PI!r*YvXJCOgjNIE;<oywbJhF|IN(&Tz
z(!U)?7)ZrYcQlqEok_WtoRrif1Dr~t2dC~I65vw9W!q?o+8fj49?uHX8x|=vMs^m%
zdHppEJn_A!(Mi8dBvVuC0lkDWdE8<MENXe!<$f`|!LLHe0$SMOl3*((8L!fTe+DX(
z&Y96qYR!=B3as}nGEY(HUwJ!YzQ#fSrJ$BhpnO$GwpCD;^VQGdEENx-zd#1{`dgs!
zx;8^1&C`>tHK%)*pl^taB|ptc<FT)cexWD5LG{c8`IwO{*mTt!UwH03;}*#U^?M~-
zX3gb+MkQX2wlv)mdvT<g6FM=GKsV05@&JnZo|gGe`ZPY4`U;b#3YYwK>8F4lgkqzB
zvl`|RAn6L=^JJn%CQ&8c*5yJ2nF2vq*KhmWhWi#tk6__TkAeoSznP~tQ-spzawsLA
zU2M854=$${Fy?Jo?#dFI)p@`4V^lGDg<IT{Q8bJ%^Xz#keJE!5zFbK1fFfDI1rxLw
z|ACdfRs>PUP|v*n-r>baMBl4jw7rw%^Alo@TVQhyDT7u%o@&CJ+tB-@>A{9yPBc%2
z%S+k(8D268C1}F#X-4o|*TrXUX`G3EW(9{fQr0QMVn6TRGrwN{TWJ5^u`i(Y&KC46
zTKT*$#|@Ppix#qDwf&t$vcV9TN2=7<LxrO$?X8df3<Dh4+q8|InS{XQt$MCdcn)}#
zFR745RZ4q&TPavI!J$^S8lyQ60e1E!{CqAQ>c^4E)RDQ`E;yx7xXMqVp*5Pe>XMqs
ztJM}+N<4r3bSc(Eo14~R9xa&RuyS(RsE(LTJSl3e^I+EFc`qOq)z5GIh&j=sbvTls
zR=oyqQav?#Rmk(PyAp2ihp{%i*^$<HUd=1&XXWcu$J2+Ovk7d~Z=1Gm8hdcb!5ieU
zW2j3cng$&~z(<VB2m@fR0tku&Qjk+JgnTd7kK-#p+c)JlI6whc;KmN#rEt=M9}mX+
z;t0QVGZnvRioh5glN=llJ!(<z!}ZaGkJ$MtOBW3IU<U4Q7odC_aIRkTE7&mH(GTyd
z()W{@Hta3wAz19xeo_Gat~<NVdKUsY?Q7gY@C~18@<JeEPXpH6e(YMiA9xPiQh!e{
zJ0`TO``RfHDdC09>)nNG(3;=ZXpfwyAq77rU!@h>md=MhomQ+yQ&$vEonFY2>Y=IE
zpdtt0&2<$ecFROj0^96=(GJ)xDxP><u<#m|x^N%K1EBBsW~HgXm2DwD64v3e?Nd8}
zH9HzaSKHd-DOn$I)OZ~|Xc50?P3<GAjLeJ*#pT?SJZ)fZnZkI8E&+$99r{n+7(fHU
ziP-t!!T`zcH9|I(yuV&nr&Es~dauly*zvK{pkwgDe@w9biL1>Mf$DQ5ZJstUmoqg(
z%z-;PNp+fCS|BJ5Jd(EMBYM?aci9lTGqX9|)iVKvZ2XZE)Oh5c2Q6@o^d@EJurlM=
zFifL^sQ|^cq<pCeT9-N23aAw{RGg%})85L|nS<ke*_=*UDAt6`Ec%bGBdD)Vn{fcX
zFFWFpWQgjQq&o_xw#rNk2u|2@TE|6bt`FUAIND{y0;;9Pw=)RCdmZ!3dN&m*s!tR1
zlUVKcub?3?=0@+n%(ahne>GEtM3axb{@3S}+j$y!T<_yPvE{TVw=dB!h+=VCoN)AD
zhxM$AcAo<_gom|I*{9C~*){*lwrl@Ys&U^&z3ScajHr%C-VWapZW_jXBZ!EzE}V);
zv;6=TDcK+!3C>+}6)1#1MRY2oemI*A{A0WfG+fWBx6!7{r@^)fxC#7dS03s>gixsT
zv%xkfouf=)Iz!6Ny996Ab}knyw0c6s-%qFs1S|j!2mLEoXVJ&7Sbrk@p3*5z7r?i0
z0^nBo(HGyUMdz3n%t*k2p5SxXi<Sn}o=H6$EueS1ufQ_OR%lQ$((6j79==Z84>R;0
zJT~HPe%h;J$?^#DM<*EzoECjJy&M}jEhl#OJ&6?3;T)KEr<!wwyUhn_QBU;^k_vtt
zCMGAOq<w77iKea$JyQO9{0V)KLAStF9F9z+;ttx7f2TJ@DUr^fzI{{}ZiEeilQKt8
zx!gUy)WM6WO&l+45;hTy#M7(qR^bRuFfVP1NTwf=k;dK(a6>~PqVeya+}Yosqa{A8
z?5}2UVmc_~5sf=$=A;)5EGs|f1)Qv~5Efth4WiKgcwf1by!re8`Y6l6I6+3;2k^GM
zD7rOVs_wsK%KS4D_)X~Vniv_Yp1DIQwsFxEX(3s);XtK{ivjZ;(F8lsM~+++T%*zw
zo{-UbGRPpdt_XM8&KDB%TI0I}3>0E_1s|4Ej>Pd!=_U#|1<igW5s@(|<Sf|WC~SXr
zC{TSXVWZzeOn9F+kHr`*;dvi!SMk!ton9(d@y#$ZQjiujbA-b?JTOyG|HaM;>biUy
z57XXF@iH(dpVTh8sa38oN|_<vivB(I?mc@w8m*oyf8_`8Tl4uCd#IF;KjsNbF*JYs
zHfvJ+c-nV;z60N<=!tyOaATK*EzK?dTF}-`(LK)MwMx(_OZ({%j~-F;0`Ad))&@V^
zgd$zxu}dY<4JDT1%AQ&*)5BOCob$~-6>VdLc{LyqaMU{BjKP5A59mnHgs-*Ue8Ne;
z{;^K&4=vBIqfs+86HCP)gm6RuM2sn+bO(P{)b!UFpsonBupMvYLo-;&a`dL$?rpF;
zATe(~W4=4dZqwGlEg(h)1~=6$5JOn?0FeArIZ$^_gI#FcuT!C8vB;^PB}vdk?-7!1
zCK0NsPwOIcg(H)HGMY^8#RIeFv0SD!-cXL&VNN?<jjz8lBuPlXj(l6-+%&NF5&rGF
zr%{QG*iMxmOIgwma)Ps%Tv}0(R2dg-{=w=)e{3lEpQPvO^0W8C*|Va5PMS_ga_*J>
z5|PRXEBx_2eGIxRxEYRnFl`%ZE5$ewO+esSTW&X16WTm)JusN8-JF-d?z(1+-!;3r
zyBj2`=Nm9kEitOZetXPF_2J{eD&!~F&II>jFjp^z47W2zt^wa4Ni{#*JMuy<Rt^8!
zMP)U(-PmuL1KnSBiCL$<=T)TLMu--$8dyfZM6Q*+{laPc9VCQbAq4^~-6eBELzLG@
z&jug~&mzTem9L0>E=c{Q>mk2=!nL-`8%*m=chhJHLx`HE!!>LO_h;P}jvkGYxL)_E
zE`7mhlb&h~(`ixv2ltVN-H?E2_||2<Y{$UU$L$krsmOc;nV$x<0FW?nRK%DnKOrkf
zqX6_pA)l7CGUDWzTRd8<nO(gIzi@Lp?hJ%m{lF35?mLT5)C1dpjCz|yrsekcvVMC4
znh3{m0~C`upD<)}a_3%bbo$nl=Wgqq36-Y#vo(GwgS|o6?Db9V_6VrqVW^?q*ro(k
zUKP`qU3RUhHV&#CJW2{UWmkZDZ~NK+rT6{#aqlY#F<lZyLMJECYCu^+xC71RcIkeJ
z5Ux(ys%uN~${xKe7*Unsyc{3-@|%iBnQ0?8Htw-%polX0vnH1!oDvmSPy&Y2AUUTH
zM`b|?0}cqYSyAC=)$Z;$k3IVvN%k>9_*f*;c7J4W{!`0Q$8Qb0*)VjsEAsKoUbNk8
z<TDKpHt;*DeS$cx^N$f2k!+5e-L=VCZu{p`Of|lNS}7Tn^&nDc(`VNP0$V&AjXB|l
z$*PG}0&55r#(21`_gOg=|FZUs90oudN`R-d6UFfj9L8A|jh9-w=#snycUcs*H#%0U
zICI*0`as3WsBl$?meI9L;b)8y_oBCV+7s<+fG}=UmFwbM-kW(j_?hp;mPF#v#vW+K
zWW8Y3)&Vg8bZ6U+X%NW<dD$TCMbd_o4xhUB;u^iS@BiAVY11q@`sor5N<p|_HNuh)
zb;3?3{@b@VR<JLhI^vm&UNb#o+ZNMF(QrcRaU~004m2`Ofzl=?=tG&}&y6ETE&zxC
zN3{!_hq?@xmMoO70Bm_sipB_X2l#Kydff0=QuedUsp!|t`jwaOBQ10L&v-6N#$~%*
zS^M(wF>I7VkNE=`hL??A&HVYRE|TSHXHfA>badFB#N%48zlspHp)<FHe>aq&&zY&O
zLo6)VC9w8(xAn{u&*^lEUHm2P>vhX-T=owPr}x_n7^=be!4H0d|CBmK;J5VfiBngp
zpXEbtm7hR!f!Pftf26hH(H`_p<QM#x7#9L%ot&pIR2zZtDDi3qfmgX<V;eq)ZL->Y
zezbh+(jiV^{lW3zfXO?iw+b<dw~FsaAzk0qmYm*J5L?%;X3YjV?;dm0!V)sHe;qM?
zzIAyZrN8z4XEFDA1e28k(W+cWexNe=x&}*JE9yJbCyNnAh07HC;Ee#8b_&JHF${sZ
z1_bqnf9$Dl!LT3k4{%ixA<D{k68b-=($fN=gQ<8}Z#<?1Gp-LvE~Wg@W_N_{A%$2K
zMi1pnct|5QZ3*kO$NhmTkG!J#-AKAf({peSxRpNomAq!!t{waMO43vyzwV|D@`K{_
z`#!4rScr4<!##F0BGc~NoSX3!Ba5h!bmGvGH4&93rO73L4H9+Fr&fb7^B~lYBW7|_
z_A2ZSp=(Ykgc8$GrPwo%Zpfs4<1{Y;{qA8XJeZ!ZBMjF?7x~X*ffm#W{FsyI;0EmO
zuKoioJBu(Mct`;s30bBK+*VoVr$J#{i{FM<^cm6PDZ!~tVS&Y#0j*#cxNcrQ@wDvg
zv{~0rP4{n@Qc6bw9Iyv*`stSYk2OXMeGPT|4iV7%9TQ(#W#p#`Ty~^XcgI5pi`RsP
zH>E4R-+~!ub&j+ECV&SAs#nRz31vbrI<PDEW6YK1<nkKaCsXePlAlCbF*@R`M`g~m
zn~<z6uAraJ#LbxzE9h9Wp7{=S5D$1$(FBjQgtO*B=-2=olyLiePTekEkGI^mEv9+4
zKGX*j8fi<3XBuj<_7?gBTyEo$e<S=BE|&7_4ECFz<QdYeG3=ZY;Xj<!3fDY)1G63N
z_xfd2Fha3@Rq^>$o3h*g)L|`LbBXQI&_B_luGl};!YdTl)(GB@Ef&z+tO0b*c+0Tk
zDl1s@w#$>83dJyDC8~|K7iXEWm0e4M?lXbYTp!9NzH}mfcF1jyXjnHgk2LFEz{FYs
zb>Cga`#fw&3d;Y7ph~-12t=3cP|dgXYdV*7Qax2|O9JssEN8cO8KJcagn=<U6MN#o
zS!^6ZHR>%AdS7!>NR46nPUGt4j}zKtP&-+}_lm@yYEc@S2px_gkFY+eS{%C&h5X&>
z6NZD*`I@~A4P=#g;Aq(R$YegE-M`Gt)D??J+PsBod5?%&ZvLLT3YRFc(c+IK6Wu_n
z&m$)msy^^^F1$r>dkTDl8<kw7@@QjHk}f!MFfrCvmebEZ+a8_1(slOc&0acffXNlU
zDiw4D4$x=yAH=g{LvJ7`76`2_Rsh3q!&$|B<e*8`ck>0hp@739y%H>Zi{nB7eD)-M
z<36=ir^W1)AD1JW7~RmPC0sC|{p9mtw^qzLk4kjH0gW2a?bE`v+(%0b{|m{7cnt`;
z-iv-h?f0ZCiHP?|TVJgu_G!IM4`$nscmEI(@2|~A+@3nPzG9-mAnfh*STV|%D}Dvf
z3D)BJ^MC2Gzgt<oSQ(DhZd<;1eIPkSv`bTYxzcUhBdz)cA5<S#(6O>r%EziF&Gme;
z==-4hVhnyCTQ;+?)W{X=*v~ljp-<n09mhq#i@vp&={LX9kIDFeD?!`0D}PUzAEB}&
z)bH1DM)rCXn@7863<+vT!&HZde+K_tYt!lLdaZ&JP}iu$$IWediLK-q{A9oVR^9z2
zsZ}Q|641|LItSP_0m~4vPSbST7L31qeGB}66BaE4KjqlEdBpSend3zzX)Yz5;b@`Q
z<+Ma|qDCsyYX+=uBHX~&C>j?2_K)U>6@b&d!bYH83_Yp-?#~sRZxyg>I;)~rs{We$
zwyydki7i{OgP<IQ@+M)M1^?>i6Bp{X4w-;WagaGs+#|%mNLC!OSZ05>J{de(UMqKB
z0+G%VDx3rce^y)yp)F~2AKm~rD;cnP_1ds80$0S8sz?OW$JIY}M2%D7wt<6FN`VaA
za{1in<aQDR%kN|A@D(UItFTzdF(!&i#UaFTYa*6i#$5;BuT#E$fG-vs8g{(JJ?YNO
zxGt*Rvvy@Kc^!B}!)&h_gp-UHo!=*1z)$0TIL7n;ivvPR3}Ga3$SDYRzxBpC@N!b*
z)lt!Y_ZeqXEkm@^e>BplD@K#E1((jgCMAf4NGRLzqz-56d{9+yh=n>91aNlA9Zwlx
zHjnCGc2f>4(&%{#y0(Y|NQl@Dg-AG4wtZ75yYSmp(fMb;my6l_%qWG16;0l#U;HcG
zoIBWC_#0~xck3hDc(YoXvM#dD6HYy{>A@ktHXubrL07-~dHJZg<{s%p`RH9=3}#iT
ze9imno-@xrY1#yP;=_lKoSdZ#I{+{MsTz+P0(kOwge7uG@Yg%Wbp9<lV1>fA4By{j
zQ{vSH1o_F02DIPZf4J3U3<p*{jT-iYa{ST8!6Tqh?1zTd*k(`GuwCWbKR9iDPke&l
zm5MHI9p5Z>Zc#7hL4+FtZn?nrB`DDs3D9Fx9noy5kB@zD$nCmxfwwt#cZ~F*R?GCP
zb40!WsQMSUn)&N%q}FlQaX1OctN?hnCUm@NMwok|*>ZuCNE{7UUjSb3C4fQ&e@y`g
zsQjHUHV2I(_AHH@3Nsm3(;#}jV%qCP_56MCUg%Ebn7c*+9lH(52UYId(|NW}_f!4)
zOhEUaQX-8ebW%JDe|DbZFsV>;&6D94^*x|B!sA_ZCyKGzJaena2Isa}FLSb~Hg*rR
zys)Unj@neE&ps?idX?L_I(oxH)<Ss)*`FBjzM@90w5QCIDJZ^Y>zcbV+Q@wnp`ILd
zK^%$^CiNJ7;31Bpauo+834S{%u;khdGV_Q3{Cn=tqFxtC%3eCW;_7T(cab0^VrSv9
zz#WBfR0#d6{*=tyPgJD5^{u&wNl=SmEx|sqfAwd`nPOfg)|E<tjx~`P0mT~p$7fCD
z%+@G)Aq;?p&CWwcw>NIsKrXlv>VmZoFf=UkJKc{Jc+P~ef~3H%S)eK0KAUD7B3Ts$
z@D9g0f3E(E3=-A<Dn-K-_ux5^J>Z@~hH4>4PP^$diz#P0RQwW;AS4qx!Sr-KJ><e}
zfHN_(nD1R8UV`{V>b+)$J(MoDQ`TQTX$S0WhhpMZ_W$EUKibVecNWB6fP@CYp^IMm
zn?CLDWE9{>cAh=6o4wfQbe{Dl3qE(s<c-IJPHGAWp9~Hhr*#w_mvlEv$z&D3w+}+-
zt&aj%53s%6Px7QdNa6-Q*x~G;ITx3-Ss)4;WwAx3l;Wy)zR<7vfRmc8jO?w!>pu|b
z<VFq%{+-1k>ULeej#1=5h->)dOrmH}N!Ez)boo<pn+(RS1Rg>Y+CQ)`glLy-BSLkH
z<qcHn)vIi0Y|i)<sbi#cF_{7hiPQArdK%sPSkHZsh?wax4_zF|ZZZ5L=%uo}h31HY
zk=+3}G?t-Q$~RF`#Yw-4HF&-6UKn<XD}GK~`!W1T16IEmeupglWo6X5->0Dh$xRaZ
zm8VewTA2D|?bZntxTx!_ef-RD&#ZU;vasGt#%Le~(@9c>cZE=9F#CXSWhLs181OMr
zK|RjtJaWd8ddEhvqY<KI8c(VpUmN!LV$vuoqot6|`3+-1${R8p-Wm&dGg81mJ$X1}
zid5}jkgzgJw69N7c7l+Z#iu80L+LrULE?w#b%#v;l+JjT2OnyaTdr|g%vV)hzADKL
zI^S#<Bckqh7NU;XVwsZ@=^d!cw=kr~*RtYtSB+AxAgpPSaRD~0uK5^xtR~2?yU4I|
z$`dvoNK!Es*+}yWw|P+a84W!?-$&;&b=Xj!b+9(OdYQt2jeaBJe-nXhP9s2_0T3Pf
zM@v89808q>SN{p()QJiqVcz?f_m4zFQDLw8ZgPN?)v`D~g7ce}ksmwvfkLE^XYrre
zVI>}VKrxRpS>N-ge)l0O+V8dxzbUHN`L{r*eqS&L*<B`GHHor!G;+y5`s&j56fz7C
zSMlKy6KgBD|3D3)-)M>3Y4U$%4Ayeble7cxTWRr-KhsOfr1N9qqC`0MLb~)HTycw^
zfoPgJ&S6X&ZNVUU%S(Ju{V9_Q1D|OQ%<ngZbl2qhC~nUkys33tE#a1Dv@%Ju%J%{x
z=Qn65GC?^*QdZB7Zi<Y%QH(ag{Bpow#gX~zUL|(M3n=C^P-DE+D;99ZPJ2Q(qtd`y
z#Aq(&smoq0g23NZa{)>7AMgN&XfaivQhfEMh4XES<b$7yaycgHIL|g4U-Na0Zu>1{
zl29`c?g2F7APfu;e|*6twmq7*HY+dVhuqN;x*0m((}D~Vg1BAcNk@$|iganxoKjC8
z0~EAH$*l5)PBj=QhV9r`Hl9g*dM5s*5O7(&2YB4n6_5I8!u2lfmrcQgmv|!}xE!|-
zN=atlH#U!&fsB!n3I0a2gWDtE+*Fg4aJ{~?Q2M<wF`r0*{|i#tK-adWxf$OxhbO<&
z)OoGm$HSSH{)P)TNBA37KEDL_hkrxWCV7@KA0)hw%nSE*-!u~VxJ!>p;$IhcPJVX&
zplBst@{rL(?>J2Ad#KRQh?i>a<<&ib8&lA^Jea;j4&sNz2tE3_II0O?;%w|pWt?#J
zzkd^s{s%JR3|d1bifYljvQ)jO_eR|fvJYpd*pgDqC9>}*o1&Pl^5iAN4}LpM{v_O5
zagtYTvQwvY2mt5-yYU3}N94KT!b2TzaswU9GbRHQg1rb*-Z93%D_}M=+(QU>I6sYp
zNRCqaEx>bDrJdiq37%K#oSFQ71CD=oL81O<V2q1L%%W<_hU|HRei(sgjz>^Yp|0oo
z;>ARPBHhe~lI(;HS}Un0#vuiBYc;aAw&wO{5~~VL58?0d`-+<@Oz=lKKFhn*y~KN7
zS7f#LlVFpi!oc|~o?Zp=w%5zczBmwI87QMLp5^I1=_VN<a2T@;g`{f|q+%(uzBoAA
z<*EgJU-(B~B1f>x2ZKSEK%o6}60?rE_%TIMde_8`d2{vp3%21-X0~+T*toi0Jk=V%
z9enSBGsgrZK)7-&Qc!bSj~@WQ&_#lT_R-eZ))8uT2mb%>78CJ`J(pNw=TO5=r}smC
zsi!Xvp`WN_*Te)SDXe!AfN-*>@ak0)+Sj)X>-TnG?1DuBRRkv(G78M9I-FM?yGv3!
zW1x7%`@R>1S63s=ygjI2-GrM}B-)9uOV#8O*+ddzhPjlY!s<^*{`-w492ms*Vb9Y>
zk!+bf3x$_rDX+ODxZwNjV9Aj_pN6ijsddjWw~b+n*Q_lBwf?SJc92-cmpQkC^Oy%=
zGot`L>JvZ`GR5!T*Rl~S7A>>y!2xRQJT@<|5%>8kXT<Lrgr6w8mx{J^=oe%^4=@8a
z{=#~tjRUUzp2s6)v(Ng@Zjp$=FkB-t+N_xcmowA$-3sE`t9;JiL7&Xj-u*oWF{Y0S
z>qYB}U`>>+GegEvFE(6Xm`xNDfg6aPRo5$Saua}5wB1ifx^6b`Mu}`rN^&+{Qiw=n
zgl`}N%W3g-j=$0A;svnHp|(%Skio)sXuf0{Y=D*9c6i4y9sK>X#ws)9T^2XIW}wPt
zd0<27=kQY?*1;^=MdR@y7exPJL4-z~<u^x!(@O@aE&6*g5Ym9%IOS#O`OE#w(*C65
zHK_)kmw{bR%8Y3{N_nO^l+;(`KUN%e;tEvZDGJ#=REfPiwZZ|e=pAkj-%`9uBbRuX
zMJzn1I*#&*);X8`tvbGFbC=nB1c*N$6ElfZlHUK*pr>*`-VP)X{@&c9sN<nt=O|_J
z*>+!!CD_ia&lv^XDoEvXb1YLZEE8==P%g-PtzjTYNo3d2?f`?p;iSlkwqkDE?GGq|
z?>8Pa%bFu+Cizf|R3KD(gbu;&;+#eg$};j}tn;=eLbpM0<#FQcYh&#yL)?#<M;QWx
z7s7n|A`kHfwEGTaE#)RzXJAY^Qx0c9Rh~Y>`cxzd+wbtc_b&)4(Y~b0Cih%D)>s=W
zz*zsozY>kE7|RO6yC4Bzz#8t_t=nCSJrtMhy5z@KHcd|=Y(L=Np||qV=9OE#rH~za
zjXrip?FuLXi$77fBn7@)6tJEhyPaj?OJ)FoeJ9ds-Zv;fGxOQ`lrtsW25Hx$^?#JE
z=M$gpF+$Xq&l9aZ_<LD|4{Dvx)1IFj4ZLG{mzS6K*$_cc(1CE`ljN}TZ;aJS`9jJF
z1cJNrVGyh=cuh$-&3+xSIUo+L^d0)wrJv>SWj)@6&h_*Xkc`DTHGm+Y`bpmnKHey7
z5+k{{oL26gCwo(WPl%Cd6`RJTBx0Y6>R}c}1*zZcG9s6-pQ<#-VOmHgw0VOOy1Ys&
z-l6dD4Q@L!y~To*=?DjA?7xvx)yRHH6z>tO)t$AZjyZVtTJ-eddt1J%PK-1_&_|jV
zoy(8<pIMf&N%qmcwo@w;Dwo2;8E;Z6t-l(Z0O0gdj#OeNzE~%|rnBb?#pZp755NTO
zoHVSFwZvrx213i<SWG{O0GeI9@#9KNM^mm3I(rnt%0Aot`RAm>-=Zi_f2(0TB+RZK
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
P5H5X9+L`rpk|6va>SBHd

literal 0
HcmV?d00001

diff --git a/osu.Game.Tests/Resources/Videos/test-video.mp4 b/osu.Game.Tests/Resources/Videos/test-video.mp4
new file mode 100644
index 0000000000000000000000000000000000000000..3d5e3a99539cd4a0237d0cc98a864995591dfd90
GIT binary patch
literal 2885141
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%0D{u>+?w{Puvb%8+~T=^M2
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%0DFCuqNIngv-$+?F%wtSajABiXuR}i1evP
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%0D}*T1S(B}Cv{0b~qn~#n_H`g%#pSs8
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%0DENqm
zA*IYWFui9<GMRKy>+Z~Sf%LEL3Y#SyNkG~yz*8acA-vJQrh#4r3MDEESxbjIw~4JB
zYPmj(Bd2UQ_gc0c1%p612JJOcZKBQ;7?T8;crAW1u6+GzVqJ>on)sI6nMMWgTzwxJ
z?~)-bR`Fe(NBf_!x=UyE$|z5aYFAD@|FKvmKb=`XH?=M-o*4lauW2*XK65>CR|%8U
z>OcN2y5y;KeqYTclPk)qx0#UfG<nPQ!B!YK-;=lJ?eB3Z<v3RGKr3B?@9ndSAv=h^
zHvL$$>G>iP5Fr~zQE@!E&zeNw=jqMc+q5LNbx1)-vFigG%04Z{5)NzyZ2}-B=Cl2%
z0YRm^X{e<m1@~EXQizy`QACZ|9@#iOv6>~<=(%7d-L&5!!A+OqF98h;LkRty)qn^X
zzh`qpA}lYP3au3I(BT7M3w51kFLV6rUe+Q4z~yH=h71z^eJ{=nWn1q;I@>T@vRIc}
zr5`l-af1D`6R_<-5$7B=q>aL~Txq6;k3K9g0m4ht!U?b#P1kX$p(FD#XTW5c-Jdjy
zfp`bI+>#OPe#hZ=es1-Ws-)-jLu}%Wk}d0aiHM#*8ojUc7l(fRd~4Ykz)Ug8+Dkht
z^nnC+(thJ(#=%Q0^)8U>VvX>cKrqaC7|$XicV3AdEp&0uzW{9mga<meCSPC8>~Nm-
zIxOP>XN#`#h|u~Uy`AOjspXfFpzS64u07}otc@>E9lL_Jxh<_qhykmLP!d9IEbDcd
z^)E_p3(3Ik5-!W0nl-e{^`(jbEBw<PP8U~e%AP!U`_}xGk!I0ihC`*QAi21`zd_~K
zNR+-?)T7CLJ}dQh4UvZ}$;ahVvw2XVYu7XzuI$%8nkREJZv^kHGM330LBAEl2mpQA
z+0g34*qx!-ln5gB>tMa_sW@X(eP8{PFS0SvgH~jHMy{*Lg6rzHrQGWrU4i7};Y*zT
z4Qk-hjl+(k>xP<iL?HIg!b|gJF)ZRZ2wx_u(P7riRGB(&^2tEL=Lap@{oL$ba*^p9
zI|_{9Zqf{p*&25Kor_I>mUT$!QEut8sO7w`W(TDczsh0XFKap~!PttLbdDv_InnRe
z2YjEY(SCX<=q|+vR={W!X{P}B3)HhUUuYDwA$)p;mbDJ>ou+Q;hcR<x2&5BZfD$p6
z@f)GBu+XLTgm*s?Uco_3(I3{on&&)h;|dw~!4jC*+ESff+Ux*oyO9_2#^f*+2m51(
zq7%__#0P%gUjA#p9r=q`WSqe<zrmVgdP+Ip_w5tnY&0E1+j4|*kq2_$+4|<~=NhFO
zZEN5c>9vvOBDDyWbuX`2IFGja`ghG5N5+Ho%HGJe=`fWLRiTGgtx&2D!<9CVU_7JL
zK~!ldP0}TB2Ylf@{29j^q<Q2BV-vGWH>b7X{3Yo&{9$`iR744t7&$xl{BZn00`PoF
ze4dmWMs@*X@u(M3Gt)(MWy(`yn|owxj*M&k9PJYLA&bg#*Ik7-R%eaKtLKWEK{x@O
z&f~;=*k*>GnI2JWj;Sj3I+QT9_0Opmv6<-WTrt>mnL4tK9afHd0$^Eq{0~mWq~A5L
zTj|wV%lkwFS!#wfJ#+uhGY%S>3q}u8>n#YSLYkYkzxK>-gz>eJBSAn;gs7({Zof=Y
zKYH{&TXPKL`VeYG*1I}WkD-Z6CRvSlN#*|nWB+5vlK6WOo}p6jZIJH*U>G7I9MwM;
z^DIj|{y*tFeQVY{;u!_~?E_l*lixppd0QbDX|b_7I128!lDE&oJ@2@=Yj+xx#3Eu>
zD$=~xm|m)+z7&2X?oIFIiw^-U(b?)9dd<i~aQ6=b8UEfGV&J_mWsol5yJ?8^EMU56
z2nlhrBq7AjK1Ujly&#RBwJ8RAUToQ1w3;$3vEjc^etkV-aCnO|%+u;+FG!jjpt=15
z1Dl*?Vp>hg*^VuFve|p=&q2DucQM?}_z5*05PtdqMA+n@Za<~vYJ|UV30ypL@~Dy)
zkvqzh#~i?Q;#yF`A!mQfgwqQSQ9dS8$;WT6<nx>~P>-_#PEUu3e^S0EYqopx5;t(N
zKLMYQ*br*vGTuyjwhL0tgnC8VYvv)e&?n#Le*kUdGwP^A>DGBURncN`!V`eO7$x_g
zK#}P+_Rctc^6q^{yKIPs^<eVKPhOF|E~f%v7nI$bo>Ir_&E9ftZZnK6!si>n-<|o+
zLU!JA&$~!=--r)k7G;(wf<Kz-7U39H`7{-^H8*$fJ)x6T*R(QQy?-7t@JRXc!Ypi^
z#1kg;CZZR=k@2=q(p@pKe(O_x)VRKIAh!*AMlSISEk?y}^uhXXmd)No?}J9g({RPA
zm?I+tjX^4$;kzVIZe^d^ON<AK&S~znuCad8ZLX$_l#a|3^X+9GqNnmDO3$uSFr+EU
zg=BJu>gcP=Tl7yy34KJ0ZxIA=KR!~X>E(@y8T%~c^X76}tRDoQV8RK@v^65re61?i
z9%;D&bnveotc^bX)fKyX);2N==EMRDc#>uiPsMk}hanlvazD^YMZY5&;$>z{cn)KS
zVd&`Om~cfD!22DK7<Ob<98Kp-a=R-UuM)+KT#bZ23QsZLNU3K!{61kd&jkJ2+q-el
zqT2QC`-$r1H3)Hxc7F*`PvoL@OB<Y+%eBjK!`L*w&vtgUG1|TTE#7HR<iqvJ966td
zt}8IJLFPrbO^+J92C+KN|Bp+VK?IAgM27&(qgEc`2KXD;gZrjN8!UcsaUf3S#*<mk
zu~3Yj$-Z<SN&R-N<(>!qEn0j&fdB4Y(^jOQQ{4tacpmfD<A^y(Cojoye=HJ?%H<EU
zl0GbTJHWZxeR%Z+b0y$<Un$cVIc4q9Bo)H*#)@b+7f`b0?s8nZOq8AnhCJYr`=6#v
z>Ko+M$9Cyn#`**ZPh;k_0l)%K@RSB1`q)=%1^|Iw`e*YKdeL~ffsy~1JV|8Ud!%~J
z<^U9B<enieHqoN1d7K?-n8f0oUq(T;SjIm40#MM1<Cq0|U*TXSzTOzWHn-lPQ}7`L
zhPZViK{dM_bl&B{wX_Sqq-Z~)HRGUpFup$d)KmTh?UMH>lf2HNFm<&>cpLiHe*_fG
z-lRQD7tg!q0*PAhsxqUNu^pP<zMT3aBD>$Bf8ws++p+sayw1QL?QbbC|Lu^1C4qyq
zk3^*Wb+-JIj#8(poPLMluN81LK8<ermFkX5Cv+Z?*;i**kS*8eMl6y|jC9r(tK=br
z2MGBN7x^xmXCYy|i5J~L7ilp6SQp?s*RVok0xuxxU)ZTa@Z<@9hdy9=K{yL7C{|xK
z!@+(mvFFON@FHUcmW)<?-=r9Sao)h{!AkH>GPZnN_zsoxOZuzIG7K$%MXp2!g~He8
zteqdo>7_)UDPYhv54(%#n*FFRK|Cy+#&rGVATvf6N!n1bON#=-N0o%_S9sP4ax!+S
zQ>CQGX5k?GiZ&1=d|xvaH#1U+GkytOT4WDf(4;|#n)Rjr93e88+-C#iBqUskUztbI
zrUl~W;Li~dp7J1GJoi{tcrOs8)RaPjUjPEFew|z@Z;0$_H<4OK3H|}`wKGMNGk|BP
z7w1D`HBN9t$gw(di^)hkZ<9dP;V*weDv>GlZnz!AfYZUL&zQ={RJQc)q@e>Q`hAo!
zj_(i@gy#Kpc>mLT#t>=LMs}n@2l(W@8G&X%J46a)#*xpOXeVi<*qy)tHgH~6;Z+)h
zIie~s`H(Jj15Rtn??2-RpZZ(MzNW6Km4g*uj;>Sgy|R`<E;ko&9^=``4Bqt#LC2Zr
z`rJxgj6TVfckc!4h4H>cyUs&RS@oB)62q2Kq71m+>tfpnf>iM|(GD|uUiMn+`?h_+
z<nuLS>=xVU{!J$qWsht_Zt5~%{k_EAUsj@epa^g{IlZP$z?8hyMvQ_5p&(RAQEzMG
z5nu1J*e9<faRE_WntM-CIi%!NoaF2AP2zFk?`Up6br@Z9=i2&)R{S|sR`=+Ed(yeF
zk*=#$22;w(!G!B=Cgv_?A2wbjZ*6n`Ujh6pz*Y4TiC(~C8Bfzge_CCvsc7@s%y|~A
zTSu}^`uF_7{O#S}9m2h1^xq}950$#eLKz@d!nVx2J4c?xGjBY%QSp(kY(f$fVSu1N
zsx~)R>o;NN5p7wv)sKd`>EX>0Tu$ReK{>P7k{%P<lRpIJRLSz(u2k~E;~BkeR_LM3
zN!;H5G;7{{{1b{PLy<mMZ=7KkDY?oAm~aIEWF8w90{#<Yui~Q)X<iyzq?S*=lzh*9
z;+<SRdK33qaBVAJYO7Cb$BhGM(94)LuleOM6WrO%SRr@_5Zlu7?zkO!u*b-t&4-VU
zm?$G&Idtc=q24eiw|*VD#fSn1jv77j@vCcPTu`j)?>7i$PGe>dOGkGY7(8at&7M@?
zA?A7NDsU@AIfHW@!zNdj-tuy1cH@IIhZcMdiYAkdV--1pWK+5wK>D`St~=P08)}zR
zn51mrz`2Ek1jBv&l_rpv=~}OD!sXLJaRrGi_;E|I`h_=*P-1EhVFd1)FVpRGCq^!J
zJDuQA0NQo_Ti)L<004Gr6<;xOo&f%ZtNVi&^74wFZHgVeDcc#tCw=`x7h(~{>QK#~
zOU0*QLc%)fAFaJ@MN{$Fw$*m1uO>2eaPAinB+t*e?Jq%R)_=@PJsq_Ks%lFyyowEv
zWpr^+MZ@Lpoab=;P{)IjuJ+K=v`bwrBRQ9<D#eQAZcW*l0f~UVQ~1;=jZ(rkAsY61
zoX55hm(RwcMb67hkKKu`hx9*ardu~L2?^&>w6YlP(su(k@#I$FHoO&58PTR_E6>5s
z5S_T~EOn<`pIVOi@~R>J-sbpe`7`egUM3eP!^JWbrdC~nt76li6!0YdI%kREBBVHQ
zm?q>;3JbXVH3k{~Y(2nJyfC~1QTA?WXWeAeQq<e{u8c1ee+9O{t8#L6#qF_gwd$d_
zAb;GI@HG4O=2;&Yb9ki@9Pk@NLNbN^0sN~^7c2%^7CRH4&)o8IowOV8&~}xoT*q%@
z`<o(IKi2E!?RBt*=A0T*Twi8GakM4*w16K&g4JrUEGYt`_$Reku%^UOA}=aAb>~*k
zx5q@Er?RXNT}v~_0;uT2p<(mgmfmR8lA9K{tLo(e^?}V}<rzb?;*o<&(|U`9>r#z>
z3M>V4ZXv$XnQ~%!=XOE_6*@wfN`^u--NE<F=D9@PNJ5Vr5I?SvG!d4=ua%q_mG65z
z2co{<FAJPwMjnus=d{E6<pT;6a`L>qUM@=Qg?~NshDL)iO9oa3!0VCI>pg{|0%k=$
z{s=Q1#xbga#jJMw5El@lfj(AeJp3Vj*l;7l>b*#4NPyE3KXn#DPH)c__%?EhXus~@
zp@-)F?L4NR&)16V1s{A^zAeJd8*xHc`cJ#8hImQDCCTF#od)4O)^WT_LJtbaDHS~q
zQi^0#N7MgZlw1vX@|bSzzq=(i6|2wo`=Mj(IE}w2l|w;yeSNR)9Gpfu6I*a4<qkKE
zoQw%JbrK45MIo`Lxa+HSW6Tj{zs;fvAbT!!9Q<AnZ3(oBvhbyd4I@oIP=@CE=4qUc
zM-n5!Om!uSIe%MM*Y3?BX-Cy(87jD*f=a!m0I?9iFPF~;u=pON=+lmLoz(}R_@>zF
zf)~-%tlUMty>hWy8{(O4%iKRio{hST$Mp{wTr~*#(FVnFxI2eOz6Ib8PzQS|Ykm6E
z7pFNrhICWSC8w{xkX@0gO@>V^hD$D^fnST@l`S5S9(6nV!r?LCX|e8WekE;-uTCqt
znTvToTDjibELdXz_ZJ<#c=#^>b#JFF5^0*baIc7M`4FJ6GAPKTzJcVLT;3V91e@m$
z9>WQpkH9REy;DWee&!jU)YQz#$*IhpDO(h|ec>-JTO@GlU&oKeP-canU|9>w(m>yz
zWdqBks4^+`kbrlE1w4Po)*YAe2k#>KQDp6LQv;L{{1nG@@Uz6jW+A{(xVi6id`Z&@
z)jfm){9$YhyV(%tc={l!jd`lpRttNyQ0RV+LFGHc;V8(J-6RM>Y>-(gw_T3mep|IR
z(yY@9G83M<%U;x8Y(zE#7KuHfKL#|)sL#*;rKXHT0QAG*EoJ#klaad|o2k6@2e(-%
zhO}9xU(VsI+!JXJZnSYvF^d7yJ=f(01`jO%RJM*JMYv*uCV@WdD<-Y}^~@i<S+GsR
z&kN}V&cmn`)U{69W>J^P5~IB@W9BFTvn&J2uF;jE;>uppFungYcWHpg@u1as>PMXc
zG=)(Qb?8r)e>KQ`2mh_~Et~L9OiSzcm9(KLm-fs3ncx~)ytw(?&xO4!_rw=xVg|m>
z*wDQD3qthy3dW}6eiD9^Gi^D4mHStE4Umz_cw=Bh>Dm(^qbojV0sv>ZW2CZ8KJ=&+
z6$2O<r(Opxe-;6R!uy+PYXJ8MKPayGW>a<9Thzx?0uw+SbNhgHYI{n_Mp14aK8ri`
zQXj(0p2i>_;6E_(HKWbPnQ+fpqcf%E8Esucy)us)kvX1;4wbWrO9QWgTbkI#-xTj#
z{qN_C6p9r8Aks{4sjw#x6&sjwcXoM+9F^&VQSr{d_rlgGlzDK#-zwe`?^vhcx%Yir
zo|AfQkStVM^7IBH_&3v-?FAyt7DqU_wCEM%0WHm6xW5>0foua}$Muk{fkdE&l{72C
z*8hoU3x6;Cb?Z;^1;1}WFjPI8cN<;u=a~sQ5&I8}fZL_AAAH)8+jBM;Db%tzq+M4o
zaZ#$NaJu{BV}+9`lwZ~Gb;ji7OWt=u;f;+`6-STCS8rA37147Vl>`^<;Y<e9*eU1`
z2RPZsKBA1B7`SFm<l!t)cS(&e&muduj@NK0Z#k3M#BejKGDHbPSZq|R^ocwpU%v1i
zenP$Nuzs8IpN#0<Uh`Uv3YGlkh}iRgid=|!XoG`wS}*+vxKHEu==La2;FPjNz(f7g
zb{3%3JY;@LKhz}EVl^qVC|nTkCMxes6;3G{CPv>d1{LB)RB2rQ)O!c*tfzTqhC-KM
znsLyNo1OU9%6l7SMGb>fN>HZxU)B;t%8?7}0QuTG9)2y-Y<4_fq5&g5=jjFuXrEPz
zA<;31(Bp{S&3x7+H`#C{DsOWr>6d5rg-D7=U!h4<MWigx9n?FqyRsRZ>6b-vHkTgA
zL~}WQl?3-cTxwi{r4xGW)B^x_Fc*2119+6;uadC2X9;f@1P`JOAj=nxm)4%L;H1oY
z1&v;NbWNcH^eK^DtkJ4I!_{xKbh%Xw8w8+$J24lRO)2G~hr~qQ^`WSMm`}Q1ij_8c
zXL#m2T36W$l)mKS0)#GJh+=H>7gQz91BSo*p&1;heh_LcVZVyDszH;ke<C1<gqNHv
z!kSPhbY_DG>w+$4fJF@ZuYDiJd&;WI!HUE>fQQ(dg?yl*<>9VPi#!e0iKSVPM(>n1
z@_vc)I`^QmgGb66HdS^i=3r}DQ(<dzAwP~b@pIe-`Yh`M=W2?th^bUpwA3OzJdh$m
z#hq?adAPJy+O{&pXo+~s6A>>O(64{7Y>|miF>vovnAZC<;lFRt4)EPOAIE8wwzwJv
zKq(<-$D2BT`eX-16}Y|??uI(Bv8%I68;fV>qCsQjQu|b94}10=Xy6q24<?HFTtyJA
zjUYGxq<Gzrx|V*ii%#Z0vih0qks+?RQu1z7LX5(pb16yLoJ_L^9sa6}ZdpVn*;e-8
zIr47z&Y@+5@_84dWb~<RDCiE2QZR;m^XF9;sFb&>D_-Ud)Iw1jOYxb<D3A)`+Upmc
z17>nJctQ@=caneE?9|?i?yKA#;&T~H_|SY-g1L?d4LR^g-X2k%3lRT17a{YnMX6*n
z>##o2w0PoSVr5mXF?Dl0PgGjG+%Utz9$%je%bSvJXE3mVBA?{6`7%_b@2&P&>&{By
zS@@rS`SB*s@D@+Mu(;+nfXO@T;tcJR`<<KENc6dIs8^tqm`>p_EgMC^QRaEq>f5cs
zDt;TVd<n+rH>XE&3gP*{I9b*~xQ(pw@_W4&vt){;HPWz!_n+S8vhrD&E2^=V%HT=i
zq=<pIF+|idF3DbuT?}4T6#KTop6g0#r(k(gX@K~drUup5)X#)Gk`h8Vl~R%jqSMU#
z;!b9S)`N|y*Sn~beo6Be#C&;BREO!V@h>M#O~<>}X+%m1huh_IK|#qjP=00fuYkcL
zt#~kL+PJJ2t##0?mxbLi1<sm4PFy?Dys+<w*rf$Wvjy?si|I!we^wYV1H3);6`(b#
zVhu|+sVwMA>b_Y?Wj%mTJT!Ww6%cp$fSh(=e|+4AmfTThrFWV3A0vhYi3bLF?%R8E
zEp&+SbmYtJr!L6S%5o9~<37~M3ZaI`Fy2K`?63iuI!cjHe)H$bDJ<=5o8Bw%oPop#
zv2%sXRA%G-kOI`-e+$9&<T$Xoaf$Ag$N%Eu0`sEG=J_*vFS15AT<9MUSeFwx+%+wT
zU|~bN1$rLqF8bY$Hk@|`+?+Vp!-id3vgEs1y{k{doe~I_QX*PlML^%D9Yv4)R}jg(
zsw02Cn%=Xq@g<wiG0^I@u_@3*nNE7Xm_kL-c>znXcv(H=`KO|u#i=_qosnb>K-Zi-
zHH-&#2ylYqqX@8Vo{QT20TO=8G=4G<7P4bTj@_rss<-pwL=6gBA8vzLd*e$ciB|tS
z2vYi2ET#NLe52}Yp|Zk9dzP>zPsfNFg1kyKy45CLll28PY^2ll(A;boT%;m{Zm$pL
zQghbs)Xi20qG1XfH-x7|3m9FU-(?=+ZKi(7&~}N$ZPLfAXms*N?e{8g>YKW;aAExO
zm)i`NY+(vqMx@DNW?HRbu!Ikat6z6&OIt%i!La4*=g4e&Q2hVD#iNETMd%_M`5K^S
zGLo=G!%LjL6SL-tMM3_E31wS=@z=xf7S)^$V$raE-s!z(Vg5C0xR6(Ws2_Gf4f1pB
znBSp4$RAE|T$}rGvFj<H-dp(^F}!=J&3M=l<O=?l0ruM9ZP)i<;J&2V)Meo7#Oqy(
zPt-7JA(pH{bx}p!mt-kr7%;<eKSmk8+?KUK_<!fXup%WH@>h#TG9;PYp5%KV<bRtg
z`FuuhzP)&~#z22VZ2hoSqlA*16yr4!TZ!M6h>SRe${CFOA?A+?M^#SDw-x4S1Rd<a
z)hz2Div*gwl!0BWE_|IQBre?zUqiIDloXZqe%p18eQXj0{M1vdzKXsWv?$R|T7*g2
z<@LInZl9x5H#rFO5F47K(z_?)AdY+UU*$Xp%zxj7N;&8tpZkrgXAt{!H&{i#V7UI#
zR52}j;kj4zJloQhz<<<6ft#qm>K~^%=v{RGU6%qYXlI*>jwF~9eo$t|Mn95cbc`AD
zz8N#L(7Nqp)%(-0W$R;>R3ORZf+{F0`s&G#Hbb+Ht-+L+7RjHclEI>T7Uf$U7Y{U>
zW;xWp(H4B3VxIPL9rS0OMlME00Ih`zBpfF54Ty`3lzg-;x)%N@&hRAaH#Z6&xSNPY
zoOMZoW}rgcfMj3+B`TPhcR6*hEjqX@S}j&YJGCk9&kAMiLYi#&0<4T&4dT~hwVMq~
z6MEx&_u<GD8V~HT|MKAsdl8dcy+D*q^1+mYMQCs7vF}&K!{xXa)}ZC`PZaTiBK_!B
z=USeX@lMs}stM9$iUWiN;wkrZM$aS%j3fic7jzce!8vv}90G2+{r)ht%_BR&xsMDB
zM<~QwW_xomn$^iJPD@A#uOFe@m#!Ex*lS4iTo-Fp!u3GJEG7Lx4QlK0Uqa9Ir74?n
zV4Y1?k_z=$%sslYmB}CTmP~G_e8y@ZE!_J{f*#surk^c|E^gg|-dyAbyZS3GxLZL|
z&bM0@JoOlS{kkD0^i~H7U;3g*Fy^_e*M*{WBo)<lhRmajrmUlH{4tcAUpOy5^LHLF
z?{t>?bw&#8!b$_Ml-#;El@WF%&ym<C9B*xp)8dO)0>a|odYiEJ%lZNUBtVg&$Ij4q
zxirHXrPkJZrp`#puX9s#S2d5c6nfDhP`)THvBT`eL%hbdHmC*lV5l*Phq06gq9C!q
z!MLG=uhR#Bd*FhV{7K|Me&z;e8F6vqpfW-dar;dyqcglvgJ;?Ro~t^VkW14{-|f1l
zx4ltatwD2NLG>L$9{zco3rtG9=U+kvNnNz;d8Afi_3_*gvl?oI#ZG5^k0xt)=$%O}
z1Kt~V3;fL;jkDpobQbpN<Eu~icWUly?vuidKZ^O-49N34t4uCNLpf#c%_V+!f#xPu
zBx{~cLP+*8a+WU#M6F-jpE_RvWbAkEmB&3axfuGme1xS0yVQs_kGV9*daw|ecvZPY
zv0z~XMl;vWhN*RVYjkN4mgNiaRh$yHTvzdP52eXw{mVllU(@Bf$ZnS2Npj^7%z#sR
zYE(r_Y3<WmA)e1S8*ePjAp$KM%Vh1hi<FI2YxkC<yZB@I(}y*}%6})`9`=&#7y_x-
z!IV%)0!eGhtx@I9wKvvB6dIVsi1_Y)ex)%s_VuNq04qRQ#M{GL(kA|^OboGaWJ<dQ
zc9XY9&E{+ul#rChp9$|EE1Nu+wk&D6locR@$VJ7UH~7;QS-AQFURQEHF*bbRMFi%n
zJjubGkWO!iPslvJRNo8Ci~q71R4zWaFMz+wxtevSnf&(lT@yw=Pa{SK?ngjKfvh!+
zgE8uw8~5h|*58(Ke_zYyBq{$@{b{!v6*VD!8uk=slT4PI4tU;TS#%T@vC?w`1%9eu
z&^@OX2|M4vs{h?~b-5)p0Xvh$XK5g@b~A#r+5VmVpNPqfUij6kW)X{hQqljsH|sNI
z7ayV+K|^;gRv)Nu==DCD%KvXS!$`^svtuJ-<Nu)^uBtg(p5d0fUaEV(uOKevg=KrY
zb4pq1+i8sf%BgFtzTbnhyEd4UZ%bb?US?Ija&HaO<D7fFy8hPdt!mlG<dW7~ku{4f
zS0^_Qz=te`Hy5nU_X(YT^r@X#K%n7nB7Yjk9xpAlSzEpxY>}l=Kv!+_s9%bP2c;q~
z!&Gsp*ujGG3!Sp?GzNqAu|l^lVKtT1QrWq0i&SWTfpWp>O2@<8`?nm|mmU>g7BLX<
zVehr&xbMdLsGK)^!lhEOpuj9*rQY&jirMj2ftmC2x&`~Camq*iiP$RoYnpuF$y3kO
z?N~3ZLh0}A<tJGRyYCJ2V~j`GbY92E;@V*{3?tKqRG%z*uY&YIVrSL6wkMHul!hcR
zw*s}LtDduygFP%=u~UR(l0Xs(0<Nt1CdJL|@Y<<A?(2zi*N=dgKuzc3k$)<$d7Vgb
zLPr>v`yEzbebL6azEoF6Y?H#Jp!r+{y=OP7*)zDVcATE`d*SQu77TCf-52h~V+IDp
zsG$#CG7dWKNx$O6g?{Yrd?v!oFHQMH6}pv=?m@xqT`k-5`wH>rvPrT%>63X#OSv1S
z-l)=Bw=M4dlOEa8jJ3|<M?~g`7E{5W!?O8+6>S$&($mV(UZxx@S;zbNSsE;Oot84Z
z|4&yJ3hB@8gCq5i6iK#E?K)15X#p<7bTka*ysI$*GgX>UyU0=_=KnkPZi0eMR6BM;
ziCn_0AixDkoYh%U!dO7(B(n#Ga7I&6<NdR$15tGEi?1XgD8aJAR{r+bwMB&b6AMop
z%SSbZL4{*f>zC0|tL0+)?#XPO)!F(1NvQLy&$KNtJDd@yZdVmm>MPOunVcWLHw6TP
zAlFWNTiUSBEt>N2&s`&WQh(A!=QbrlLH9_y`LhFIOU-%`#26Ys#@UPUa*P~UO82L$
z!^h4c$(%sKu$mT^_I1|>IoM<{SIyh`r<z|3O7ibpA===uHoBP&*sw}c06gReDQifS
z@+FbKmhL#w`1`Fbj{@djV%rJ;Bk>!VzYU(jv@vV%a~P}?*EVIA_B~oM)nTBKSDddh
zyF_cgCRU};`G$tNt{j8g<io`>11-;U2_)hjj3i6}p$s9n8J%&=rc83JW>KLIHHE!3
zlnVnsxFJ~&PUMPpB9G`P!%P_h6R$2QnPsUiuMjT;S90Top66lDr0#7mIlM6m5vN@a
zuT9n=6Ve$Tt&R?dIRz(JP-NZxY0J9jDkOR{UqoG(&Q;GJJIiaekUkq+H9|43+s|i^
zni9+YJQOEB6RM>v5PRx)r<9SMe6-0x;z@g5w6NoLhR(Lw`CgC^Pkf~&o|A^DGYhAK
zA5PxGPP|%Vew{rO;}-q=3JUvx?Lb_hgjZ+nkZl!XBtGjqP$WP{B*7y(ZWG(<@imZh
zCTSWO`sy8$Noaq&jz@4|@sc^zB=JN0LYC55c{1?3{n(U|W8YEzdfePSmg16^Em3HA
zHUMa$ts>VW@Vj{iITvwrr-yx$Cwae5^Kw*B82O#Gt<d-bF$Se?`a9OAmp9IK*~IHR
zy!XFP_h<OG!eJ#y11IH3*XWhQ-xXzC?t>zw8c3gqzbt9()+%yG=hx9iBt?Pmx1(^f
zOv3=t8pe08{?yO2sKRy;?l~7C_9@K{ejvd;KVlx+XjTnF<yFNFx--hMXy)7kNli-s
zT~oeTwhDn)yFdnBE6#s6bLmybD6ii3EE0D44>@|uGnbx&ZbNCcDQjq2zX+U8F21^?
zqEF8g0E-}<!tb^2jK2XoYn5&-HO2@@Q<}Q&W5;;64LDkzjARDVu+jT!k@Rj*4&Vk%
zx>^eG0kbk*EtSkFVxYz5e4V}TXFw+<T1#ETz!|1i_ZSKMt6xLl{<)FqOkA(J98E4I
ziruY)DKA@$T|$8M{+^Dn-(~5N&}b%eHO-@T+ZT0#ksF6J;zl-OEImRz;6x)qaxzA_
z=+0^hrezAGgLPq)Zj9jh2eom2h~|MjC#gzL#|=lGuAmqC$Ty$=vw<*bOz)Tf$wIJu
z!Of5dbXYl5nu`0uIR9zaLZO|Ziz%k4T#kqME&V8;N6tx-NYHy+M2m&qzsL77-f{DK
zk@0CKH<%(<LDifQ%D&VRv~wjK|6phPScxwd`VW_RxJa8U%id&PrivsqT#+HgG}a0W
z#Rp(>p7s*@e!H}ANX;%nTzx*AZfI$+(w-8}wt6kt2mbkNxbO_13WGzVIG+Sc(aciN
z`)!ZpLYK?T-`NPd6TPWy64jMLhUm{o%awYAfPE1;wlH}BGpsAT<!PRrhVi!1-lP*M
z@9XF`hU^fU?xufS-dl%UT>zwxul^OshiJTqeMQnRWdQn-V0X8n@}E1GGjQfpzkSB1
z1?6@Z4P+yKpH!u-^~Nw%|C18!EaeTT<tO(qw`(vLu~>3T06SO#DF-nhKTxx*v7&g6
zjNHXbxaBWJyNC8VCzIa~2(hO!MN6nn982o9m)ZO!p_lKX+Z!^(*57I*kql(HXr=Y9
zVRcq<dE>A1XzNI#ohqUFq|4D;9P02_zX6-z-}<6;DnUC;sC8uAw{~lJk$di++TBxB
z3@Iu@hH?e3qW(|+Q(ABAAW<XjM#iQ8HxB(bQ~zg+X}2i_82oJHoPHk*Mwhv;5)96V
z$3$WtFN#P!{O2mKuGW7#9`C}6JNt28lprN^TS3H$oUHB|O)A|tB)c$iN(Gr3E*to}
z#h*FZ=#N%1KwoiGu_3pmAv{NMnkh?*&+J4%E@ermiW7U8lU~^`KFxQt+fT-I@7;cE
z?r%(z9{!yF*=#6$v8IhN6`oq0&wFzD-&|rvx>}hfTdfUJU%r8_Oz~OzvS9Mcn$d&w
zpBLB4NV+J}4-Uq<0teV<N-UA-o8u2qQDf2-t#4HOtNy2Qx)Kpbm9!ZdU#X5S(Ts!!
zjkF)H#!^^NJWUMmv1vNnka<GQTshO}y~U1QIL9FM>SMVxZqQf`)i_rPskp;sY}El;
zwe_w}9UyC~lb!-egLa|d8Hv0(^Ykj;2-)KzI`H<aUSZka84HvR7#%rAYCuu#0r2am
znQ^kpn?Kv%{O*hsv)sCQ_egzMkGH>2SvInT#CMEjM!jDDa&n`$Eqhb{#D3&wvkiB>
zrHu}e!zv0>i+K86R@QcQIi`sMMDdmlA70ow?hP&~!_``>agUOde@~hHd6dH*Vv`7u
z_M@4aMk9`1`!x9n?X8z-L)z9nWD6$STF(#pBu$HHV#rW<eF5y7mJyGN<`WkZr?*7!
zwXYu<#DaEt__127ta-$9+aC?*BVqmP`UDgU4`hd^*4sPlHO^bxpv%Spc6do3vSM4f
zz0a~{5c<>>b+J($#aTVc;k<61FY}heiPtmD-hX0{>R~0sA9g<nWPXsxb41XCYNaRI
zw5DYl`}l{4&^fwMhK-A2>PMOe3}LrvC->uKE<FU9&F9`Kq9z~X7IAzs?r(ulSbZKd
zg@wg<XRES_a<7gC!FpE^zXHyR25MPv?Rt|rY_3a;M8V`^&{J2Fx#2b-;t>k4d(Z8y
zV4DZ%+TsT9Y0S?WSY?;~P~UpU+K-}Rv`}<GE@7(2(0K!rNR0*#y>GfhUZwB_A1~^f
z2fqe1Z4Gs#Qn){i#Fhbn!vY!k>-LjxNyCr`$zQi?+ib>UhVZNzwW8utC>v2cv!MU3
z7@qMhb~o5m{YC^ffAV%cQJHDRW%v44;G0?k75O;tc_%EWt~c@I)l07M*Zi)YYITn8
z6-Mn;*cf2^M?ey+<nOnAR)P)l!>YPIs%OO~&PD#JZKuCmyFGlr&5?oOmt+&sO=01z
z?*<a0CHG+bGkVI}krW2P{LKOKBYkW;oK0wN4{o<_;OTn(w}4qU02Asv=4Hyu!>;>_
z&irZHCm!sy4fFDx@4YU~T7^wIp$L@UL4RGtNee}A9|QPLp&t5T8>iO{+e>vsQy6{!
zk*{bz{Gkg#bh|gk{Vf&<d%k60hPz+Pz&`>HvSZdeMDfpvQ?-BG_w%mPDV$OJkQ1+p
z?m>@42bXG{k1<%_J^EHwg{GJ286IW`M(wvXc}5I~FaB8M?%}<=qOZ{=KM;+OUnM|!
z2}cY2PPRCc>wm#hUm&41{ZW`$d#U4239$x95e*$f(CND2h}+x5#3nyr6OU;w3n@!f
zyt92eKQV`$pnkui+I78KU?_EM`KEZSGo?i(!_(x~lyM}D8ki?g9@Db0eLAuXt)^VU
znd}qxjDG6?W29WYt5c>&^X!^>4eta`%}R>%A%Lep$r_o!H$Q*u8L*Y!zQ6VAanUq+
zmwRDJoP~93kI?nBNL=n#O5~}<6kQH|gK2{d4cuC@rVPm`{&s`#-5*|7me)(>59&!u
zK=UONN-JH53_?dn`pFNpA5xI|Wt9fj0q$yFb%~#9b8~(Xw@p9O|Cib%sy>t7b#YzN
z7AdgON!ovEl^?Gv(#*4dYF{N<AWU^xl5o*g4e9RcPJFz-JyL^6mLWd>oZ4P?Hu|zC
zbIp~q<kTdje^t{YQ(y*@*^=bu13a|?`aGG$)9cBisTd<S^QiUvg#lT3o)fWGASW02
zr)22q(StTitY{veTvs<SZp0$@p_#E;GNyZXT+r(xm11ee0Cs7#t?mr;mlnvx0vlKt
zoC{e!hHMtY@~mjCWGq1Wox=)sN1TKGu2<l{^0j|ISQo|=_)2ve0Z%^2p9KgueLwjl
zdh2ta{$ASLMtYB7I(Wh$oS%U<S9vj-l_Y8}TsTB>&NurWb{YZMekLg~m}ztG>fVDt
z>`_5Ec@Eh}dT7C6IIj-2b|FDR;KG6+1m*Y?!Ei^eJ0;3qYTeNv>gBFhh|wFAASJu!
zV9HRbX^iU@CrnNmQjriEKn->EdBc;(80cX*LQg4ORh>4pR~M49Mg+}?(Ulpp@tL(F
ze%#hVhsmKbqvDShf1awL{$T`+Gz;_%KE)keicEQeRu}ldBXnY@vCxsSQ;t|Qc|qZ(
zN($)j_MaZ{F=9^Ele8Nl1IbyG+&>&X;<#^5|L_o_4ZQeC>nn-nlFK<yiw#|G5{)a-
z4@ZWy0Ove;yrTEV<d>IpIRIg{<U5LOw<Ej{5>zsjxqEj6xG@yQEoXe-E%~x-zH!?d
ztYO9GM^F$uAvs>h`jk5Vm)J9Mh;O!vnTu<=M~hA24*qGVkNYFLzzV~CzcojS3ck@j
zJ*19iW>GY_OG5Iq{-NSFzdMPXE7y8XH}(j9yz8fQLi3Wgo?YbG%{pZRJiaWr7>fKl
zFAL34%RHW$Wtfv>O$c62NyUMVk4Ae8@2UhinA_e_;jBav&?q`<jtKLbVC8%EY1(>2
z`lPU@9@`FOsU`t%On<+7rh72i?Mmq`GfSEWQYBf^jNehY{=Uj(Mf){*r9@4`>YSH7
zK%C;Vdj<*Jn+4X!{hmA866NLRiC2wWmAB4oRjnL^pt}5H&B^3_%TK$5UR4OCmFLWy
z?Qkfk(Y@r=f|Nvgkj&5n$>y(%jJ@ji=e~1y+^qyW+kI@>0Gsu>r~&~GT{J<!vpe4?
z`%k_&()luM-kGo+GLZNnbs^#j<#U?2&jPP7h<#roU!M2MR)%(D5KPmqt`$6BXgtuF
zich^T1^^JR{{%_uv(X}4%d&5VvKT$N{&W+=WRFv7KOC`lqg~#JgzVlF7fjdJuVW2z
zd?ng0m-Ae9i)IHn$$2^LR1{eL>FA=Vz5TFXpQa3Z;=6`(-Op;$g<*9rW<7_i;m51M
zqz<K<_e+=6s66Y{jz5_xGM&XWcMuWK7#gx7;1ADyD|qA<2j2+1ecdrBJQye|-T+9r
zQth8`Wy|BoU|D?RumHQ5RBfj32)w~6JAP52BIdbtm2Jnpy>909`n1SJYnLm*{Jc5Y
zld?Re5l7n>ecGEsTFwXC*M;E9`rkh7n4Lvhc&t_Sa+wAg59QT4XW>dloIl&bRz`!&
z^(Gg^9_^tk(Ez~38-|7Aj=<SgTNV*`tZDj&&~E+xG0Ml!8U=5ZukH@-HWsBNEay?c
zh{Hy1&X1iH*0^uOw160N=<P+Mq&K5zDd&;aK*UBxn~U)^p+zw?F1<ElLfr$fFnSjH
z4HV6E68m;JazTA4-@r&#RFW!WqoD6uO(??$FN&2L?6=5uHW<Y_<W{oYWWWYi<lSVL
zFhFUDHUn1YosArpm9t8w1?L3ZIkoPTAuE71F(H<Aq!3*2P5kU5i_9_9&@}9THlf1_
zO(Fi_Den<%NQ|MJnJx6@I^^mqm_=!5>u@rwlxkN<>6A+o5Tk3Lg%d_@l=Ks^2wi*(
zX(sOc%H12G3YPBdwqgq$Y_qd->K*#_KPv`WeE2xXZE{0TH7y(VFE6b95)z<Vyqc2v
zHqzg#!F6<%{KqX|-gfF{>}$0{#Mvv&WAO@V-aUc!Ak&IUiE-!H9|S%6tlKVPa~WaC
z&y<FWU+1n#WBW2Q68}XjW?CYWn0S+C@;Txvj`Cv(VfriHAoR24EW(-kmm(D(p8o>I
z)p-r9OtHcNE<V(WNlohvLtNuA#e^3uI_yw$c^j?uxY!$${G@u3ya+a3MzeyAFDc4c
z4!2<We*4AAlBY{56`7sqJ(L!5ik{d8-JgDB>D7sCCfvU;f_Ga|&h!Z#8&Qq!b?seG
zXjX^EuO=<WMlS1Sc7_JJr3Xkn*4t)0|KoW5lyLanO&ySUz8~YICAZX!To@WPXtzSP
zw7-7M%yp^v<9iKgMBur;9e*~54?UqhF%0oOq7lBIvA6UKej59P4D96}FN$gibojF<
z_ld^xM@<+6BF9sNvS{J%i>#0DP(K6_uUA?a-x(4DvZ){N&LHNfM4Q(k@pBU`XG9ub
zC(IuXWErvar7wSdQT44HbLMx;IlX2Kh)az<J|ZbI0wFLi&+e>~1M(8~h3qiRsX91c
z5EgX~Z+?};-(kP;NIs2=UHK8yT?+_=b6JCDLcdiDkI@jWOn4&I@nIv1@?$mrVPYq;
zwfDLDlvJYaLJ_WTgFC`SN7bD5ci9kVT0d;UwNgkhEaBP4r-52Y5k>;r40bK^oL|`@
zghhGarO}C~ltE;oXEM7f=Sl3K5PcWjWSF`<8dg+P9Z5^gT6U2VR{gu{*f^)#^0Ry{
zdHJFh#30;+tzjsx-i+1OB1r#NFKTv#dHoa))?g66S>;f$$t8<g`+;+)4nz>x1i;lg
zoSG3YalhlNs?h{?XBTuYn(=b~ttYtj0oVI|*OP3Hf#5|Ykjq?5A?Zgoj>UAr?)N7Z
z(plSy5l+7iwLJ%s*w~?NQl*mL>)+m_UtbIEUy|5(7fIdI<uBdT^i#uLZV9`QUNS56
z{$#=+tg20FwW565<)r7TOur!ks{3&5Ma^x{>YiEu5K6tqp^P4P$>j7BFFwO(WG>@1
zeqZu_F@a#5{t`vRB)W2WiztCXXWE|!JQ9A=l)9fnMK{hH=<ej#RMYz|I(VaWtOk6}
zFt|xB&NgHpk93NiyxDH{r#L&@>hyfo;#=d<>`w}D8GR6Q%kfJe@cHmf(WPUbhOd}P
zCQE<06h#{`7rsyKiodRWX1ZZc6q`egfQWB9G{ORzTSCZvz6&};sxjycI(_*ge5gO2
z<%QW-M}~2~^)k|^1oB7Y#77eu-b?Sl0fWfg2MX3+zw-J!?wXhOHC&DJdmM&Yx}1|#
zpPSSnA{8g#!Nwx&kSKY})vTC~>*!SfWNxbDrX2Zog7(I=oK$*BWTO=RUHW(mqnqV7
z^`~p^=~TmzkK<x!U7^p%m|8SyyuJXZR0KE|s+O<Ol7F02v5I3@x%if_zNB^S)yPQS
zMDm+LSeJp-;TXkvVqq-yRt|4^AqEs69o8Rxuk>O0au7?Y22gtxd;lXw3?6(urZd5B
zDX{787e=T&p&&-sM8G@X2Ci){Llraw8J~%FzE}SD8Sf|0R>bfd(C3>xGs?ajP9^MQ
zv3#lfO<4S$svH3IwG)*V;Lmstq``!p(hx*9xCM0<EH_riq;w_QDj7M^8YW@uiz4$P
z?^j~F*dUhMAfk-F@gXTQi7D^l;lb$WzCeU{`5<#T2W#v||7{yaeszOd!|=qVC>pqf
zx2}S}dwaetWl_I|wC3W1I@e++@l@&TWg*>`!P^HHU%)`SUQxd~L|l~F^f8kb$C}BJ
zb{i)mSe67@@{&zY`h~xO`)s+TXMyvH6VcXwI;-!*po_Uq{Net*mqX~J@WnID9qPgH
zo}I6q$XLutw0KKPNJTTOB;W;&d|vn)96}?VACL-3n`FT9T!>U=oX?uF?ci<vHT!QJ
z_Bt^hT>Imn&YsvY&EGc?GsHQ+AC<AYCl#gLbks2X2Z&L7pEOsh{ZfVddSA@X3u(0J
zkTQ~phh7Nw09b$KgGvLbFtOR*O!hVGi_z~7j$uVPCibpIYt{Qxq^!4$7_*i>DYKTt
zj1Ve<(DQ;rTxx?%>0nd`nZJ*b{T=r2A7-e@DzMZ~a4!GJ<u3o_+oKSl%&f?Cr(C$`
z>Y~8u3FmZAG!TwX%4Cu{7+Sb}eH3h8)``IOMl~?%EC&g}GsU6}STvfhoE#Rs;6b=f
z-o8QiBqs3=OZxU)D1(A_^JBz57`d9g-_MI@K7KMl!<^vdqR}06&n|bqR`~a0Y)ZvL
ziv_Gl#Y;y^N<O82Nj~SMWCS+XxDwof9G@7zjO0?OjbR{#L0*Il`Ffi>Z#$c+ewk0}
zbcx%ZqTz~OvQ$*0wDw2&3nqpoR&i<#4k}~FlG=zHl6q6~RPy)bh!b}|CZ{|yR+^_X
z*RfoJhLpOGu#}c-14>PO{?dcP^uH~q@g|0$#a_R7+$0r$YPM~22p;ma@V(LO!!0Tb
zEo#5yIfs;rf&ATINT^-^X7$ND6bM+J+JLp<#A?gLhi8SB?P&y+QE-ivSp>EY+AigN
zdc*hwqq*%QRp%N0s#`jzT#d#3lMB1F9ao~v>5^o#R#XiNqKc1bkqG?!o=I8zdOQ2t
zDZIN+N1ni4RqJRU(of`xG(deVBPRO4`d-B7oKl*u8?SjlLK58LD<d?9X+UPF&=I!#
z&maa8kD+^;@(;M9F5O4aF87o$L=9ZLDFRnd=ZHA>Me7{7+1mX$s0}J<B#`(ubqdI3
z84ctv=Z4Zru^785ta#T1>n6=S%D(nMC_sQWN+<y9#aThWpZLH6gVYD24?spaTH<Ub
ztmA@Z@fR|GXrpAos`u6CF*S)mVP{itG$`0{fi^Of#OoS<<#Ol7BUt=)R0kv9`%=cx
zUoW?zfgj-mi%hXD^irs&Q^zRyn`R^sdasH$y~cOUeNx}@z5~?<B5!Lzp?JQ-`b;u1
z{EDvDM4nQiAA5K?sAwXctP8O0&6RIeMTl`qylQb40azyGvI4*=t4XP#vCi)JN3LSB
z&b$jHfi+LTNfqFwuO!45lQI7oyh3j-QG2(eT!cA)7l&6c8sLfdGy$1DSdEKK3wPx^
zu)>0P()yxgaB+p^tWC;tj~%93be*$L9*|;(0ycL^cKS$}hpZWMINsxZ)+%up4Xp9v
zo|w9NPZJz%hBZ7O=KuP3zTSB{RG?xUO8PBzRgwuuXRaKdkD%!bBzN(%Y0=yPYs+ME
zpTXys)=N-VF_q=fPGhR$n3(`jzXjID4*^9V{~>!mUeW)2<g$*FBHZhz6J?`HM?oj|
zcB6f3=RWUJAKHyZArU(k<#7n<C2Xu}krrUD-A8Oy?=3#od=J1G-={RvzQXf8my{_&
z9)gscc&nX18kT&1bwY4m)$~n|+8_ax<Z`?8)#s2b_J`{j;Pm^>c3ItqUC@K;+-!-r
z8;Dk^3M|#H{c-<&!*!GAJxuo@3*d6{-XP;miz@ss&(mBnfVA-dH{h(qYElR9t<ELh
zTi<gP_WBU9Nx8xb2{*~Q@sh8SlI0!lFP#yyM_5YABxM?1bn5CwvkC0>M$Gdlo5o0&
zq|{8r1Qi5ChN>HfSFG@+D6TIxFvXhj$-&F;EUeAJE%U0n01%7Q12n($O~C|0^r9#*
zjerblhPN)_0S1zA1qRFb?Bt?@a25Ak(oKk^uC$+6fJz+8R{4E;Kh~yHXj)$jIr{%&
z>Aa(oeE<IsxUf`2E%%<4dz%ASYPl-4EX|R7<jk#rTXSdSz}%T;rKOe@DvlhvO>--_
zR|;y0ity$A`Tfq}A2`=JHy4NNzF*htdOn|z0fsu_^B;;#g}1X>Z%BHb3U&&nCt86%
zGymZ~>*$WvO>0aZe76%i(M~?GQ(UF>S-@MfNq28rb^LdYIce@{0ITzBbG1BMztNl}
zJ1X9qw+d3p0uW+#b3;ll8K3?9XV;@EyJ`J7>JKK9{`UkMF6KwYw%E|#B@gM#ah_F2
zJ9xgw5f9p)9(}#!!{p5WN8-XENc-|`wMY9>6{@<Q1%cveJfJO21s3VBl(8_(j8*^f
z8OAMZ$SUxM!?*<iw4kUpB!8cbIJYWl7y2jeos(4l!F0xjn12@yU7so5Ymc0t$@}aY
zgRr^~W$#zOO9H$*F0&Uk?Eua_uhhG>wA9xpRF>jOvE}_U@lQ{ZJXtnepW1$kwnW5=
zh<@QGl!ScmN}#F^n9bvDRp)F=9R9Y9u&aUbA9_v}=DLD;$xqmU2@mpKsf(WXQ+@UU
zpnJ{CWRu}@3w7g2!7X}#E5)Y$Ol-0}`|Q-v0XZv0WvB^oaw!Eb9A~sL7~M+f)M)u~
zL2Io0v2t^&f*|zQi3WokKkkUN*j5Dt3Xh=`SviPdV*4t-!Sw^7j+iBV$&hA5c<P}2
z{gBnf;cSZff%8SbbhwC(LGN_^k=9I$i)byjX#arfYm!Y2yzdD;v;fe8XOsDzdgvSp
zmqfQ-I~h%QO`RW+7HN12!nfZc$prv}S-yutDW=xkhVyBd>xycjb0r|DW-EfavJB24
z8MjM?r%p+lb&-KKmW!)(PR>)R&@dowY9CB=z{I0}?zbc=upJnfTgB3%<&s}1YW^*)
ztmLB$NB|~3%st)cUy4qzDXQmcori6~bN%M&9RB8>y*>F<mPIU5kAH+U=xRC$8;;4o
zvhw!<bby)?@G1i<C$CUAsF5b%D3!Sm){s08<e98dI}Bl-_s^tm4Utk4En$1~%KeKq
zih*QvG-JD+oz56#fSR-6=z4LF)=@Vk`^g_E%D@zVURRo}Czk!Y4iw*7a-VuupUK)C
zeP8ei9(sz&+BhUw@nys#i7{+krny)Kc$3h^(YPzxlA6U!W7h~zC4<~o8GcC)S@Co@
zO6(Jf@~8Gf>55IV9k4*F@+=P4E@Knt?m^~<0SC{Xq~7YjF<UUT&_=&d>_`{2$Uw!g
zBZwu;$&yx%8_ACq39L;1R=-)KYy25P1nkKNL4H%c;S5%zckg!-NQ~_a72AAwzMTWx
zZF#T_7bNs9B}$xdbE%Y852U<yH+%%atEHf+%H02GdNAmvfdn+a=trXQnFmf2H~F5I
z>v}HF3Q?wuB#1hsj6fqG2O~;qLBZxeU$c{R9qLtva?A8D8X88ImVBYfJWU=S&;q`1
zE2Hd3kqiyBIbOo#=I`?Ru18e1`JZQvqi8D%(zGx_lI5Zv(b-RVd_0_=LCNukPS9ZI
z`Ffw1><^67zV*6<y){TG8}msB$Y~YwgCkpA?mmzfc2n~E04l7Z)a?qkyndG(qXk1T
zi*z^Y64Tb0Af}f){+Hv#8z;z1ZqW!g?RksJO&(|aVks>aP@>FaD0PPdxF9<=SnvWy
zVRuk@*S%sARlA}l`7YmEOZdAnxnU^QJt<qoEeyxP$dK`l;f_k_N;smvnx1Q4uQzB+
zfNNQGhhf8IwTD0L#yQclGmE$@5%ZBo$+7mBmu&D1t##`}Y+9Uq+GMnD`s)r(>PFXa
zr1GzQZuZ(9=X8VrCqZ38W_;Jr&rc<ixlLB5-b}F!nWS__eW8qy5bVc4DHtxq!Q0kS
zuQvrB`@fIg%o2=skADUl0$p;ue37qY)hU~2a$%)O48*xftzUfZ!#4SnMt4f|DQT52
z6J=meXQeV}i`n|oDv}%xgu7WQRhtS`$!HTfh(lBy!f^Mr<;_X`%0wz3-T<O0;EU^?
zfnR&&t%AyRNtl<5_(VsI=)fb`aj#<-e9YdP5wrdm^~6-9a+m;2Ko@ha-<Q_<oWkU*
z4>yCJLNplRf1-M=(?9kNuEKrWQ=YJV|9)b5V5-wV7d{pA3zIugS!8@E=b70wzgTYy
z>iI}<jmpPs`gyeKDUfC*rpg|r=|mZ@Xdst9mD3?{{pw?T0W)8Gl4!SF_Z<Gzj4`0U
zf99_I<0(gWMgNT?vF=)MN-ZPZ;@ZiHN;6b*b*6bAI8*M7I=ZVswd8jl29Qi#$`xO)
zt>>QnrxvU^Z#L*e`*@9ztOHi^Us&?spm7o9;Y*Abteitc_LgSMC>^IUniR&b#+4DG
z98n?E7&Sbd{bYq$6kCTeU)t}ODR&XpDk)rc=F~X&#7$ko;P3*C4|DHLNZ$8XI3^^h
zsYK2fmMae;v>q4jQ$b$STV2-sgxh(;SqS8C&ML>#+ymors~-_^z%1LI)6fHRTFdBJ
zmtRd$gRV$GfcXz6%iFzcG|w`7mE(*dBVorJVQ`I8Be2F52MZ-DG4R833ayMW+A2_3
zX9w4O?`zg+T|%W<%AJSFIgcSUSp<-;vm8@|TH!OV(M-4q++Tn=C@go$Z{hn>?ZHmR
znFrFeG#!xdAwO<gsc=kKc??q}X#FdV1Z{7NwvuH!r)RtQN!kMI%^CN8b@KU!inM62
zfEfs-x)!q4;ONHR8^o*o{0d)xtf>KBwW)XI%!m9TQ`Qrr1XF1@lqv|}Mv+eq%|_lb
z-5j94SV5Q3)!@iigurJ(T^wsEz>5w-v@+q3i@xZB3A^{@O!C=Re+C5rAPH;Yb56b$
z)J||$$9Go+CG2zxZv{!TRGoQ9z?=@3%B+&(EH*-XUrW-y9C6}CVLuy^wv^1v%S*yZ
zZ3NY49<c{~y0L%U>ZC`V&iP~7!SY0w|LMq{QiUo)H(ibSL<$cP+2S4%ce8y^W~jJf
zrRs*5ODOzj$=9*#;;&-C5!t5aO9JdK#=APN-jN|I#SdCaLlm^Wc7-i-<qSZ;HPjmH
z*-O)i?64^!^ksn0?R^-@V+vWU8>oKJdC>_+*WR&p`@4RY6yf%Fz1!c7(~0V=b_}44
z(KIW<n5v4OTGq0o*0P3IZi>O>An&r>U}3{vFBw<V#kdB9SVN)^loh&$#>)DIg|LqN
zr>eMKA(Lb8QL%^oqKG{NOc(A}Hf~dMVL4_)CVUtGTd4lRLs@*d$7EUocQ2?0cu?X-
zmb3y%7yIiE3q2mMvju#{3GUntd=7KYMPMQ#k7ghVzwzpAm*UnpD&gY5pW*}J0dm#@
zLln*40DGf%PH9UN59ZuUI&?d2aL_`RbvrAh*`8@5F)ju9(z&hYsk9S5+Jgbe3KvHz
zz2;Mv)&57)N?O%*?8Rzv?}b|LV<1?t%sf_)26^+IEi#%VlNYFYD9RDGdj0t@%iSZ#
z#?P?T%5_zp9ma#c$A(6;oC!hCbW@W0qGxoajEijH`^Nurwf-kUeAaPXb-U)pRVt;&
z%$SyEIsBA4(xa|B`d&l$<TWd?eYJsstU3wNZjVUK(I*(A$iO{MZTt{p>4nCw8OF@@
zC8hOflDW5wNtGAJkVwHt36{oO`M^L4r{y5CjvxI>hhA@@!%*0F8E)1S-iCc%mq3yo
zFwXZK0LP#pU6s^q5t`dk6zGl=P_jiA<j(;>EiH=!B=DW!@kI?o{XP;Uby-M8k*7hS
zNge_4s<>0G5|eM03)OUNCmG6*8L7JYpwA*c%*`O5fSvixDa*o0C8ax+W9KJ4vw&QK
z%<j-fbtFTKFq4R_)a~b@hW72dURT6!s$Grw%&7~z5cv15$c6U!e>bx~<Y?WXP06+q
zE{9u?RI#b6Q&>tIXJKE!eS623X}N4vf9S?zm?f1Z!UY17S?)R4rmut-^XVmcLW7i_
zxqkwEnEPb8xo@9GK8c9Vzrt=(<>&C)CpA9Jupmhy+d`k=X|9q}j(UgVB?dC2IS=(*
z`OP)Bqqu7aReFAnZdln=%#lHX)OgU#<b8$sp$xf{{IbY6r5lz)ECgkNGx`-ndT()o
zlTz18N6?%8-O+~X12UdRnQHw*xbCZo1R_Q{hEJ!;{~z@$v|Z1K1%0|&g6e7&z_v0b
zM#P%4K_X7PhS6+6uAG^81la8gfs~D;y$o%75et9oy-VA<t1N*2J&{i1u&cBfH=qA^
zqSW9-t({FGQIblN)b3?oybx?JPBu&1Us^VZmVe&U*3hn@u>`{x`xlzA_^;vE<Kcq+
zhN>nwrPjdfW6*~pGLP?ZDi7N3K$owvFW>NXmQUQ{(EL-A?0i!Hyn~o2e~QE>er%lL
zYf=0ZXK`yVwWYe_a7C=4bVxE%vQH1AJu|3ubGogduB@CR?*-tBC7AAnTgaWzlm2do
zCqJeAhkTeQgx(_?<>$*5sL*h;B#BYMQap8OIa;|2E_gGJ!1Gg~q9-1hyu2m*&1i3N
z>Xi$0{ShI^S&8dVi7J&@K{KNAuq?@02Ohk9=;?=UBvG!n7Y0pI1F04P0*D}9nTKOi
zud;9MEr9SG+lvmj@eYJK^|nI^bDaW^3D~*Jx3$@K%bzr%kOOrlnoDMa2kw$!J!L~f
zhSiyd_6ZTkDi0;nOmj;oXD{=)j^<gqp<%wt^@1YgbH3dk@A!#bX8LliVSv|0b|qZp
zk;M;^5#tie4NMxUnp!wAVw*OD`x+#G+~W`KFJ39y$Cm)gy7M6yeDtg8hecuRowvE@
zDA#&FmVyGHB|+b9^fa(p$<AiB6E&b@wfKi&z20Si2DNLZ9gMMwWm7uma^UW_xRH^{
ze#RKOz+8`_zmnbJa^n}R+JBe~)hYDw-?J&LyosEWcIqAJ#)*C{jPoasR`xXS8fhhZ
zD!;IKQLy`xmrIykDff4^Q(E@gN0J*&Xv`<~Rfk}ClrL_|qD|1gK_CB^^ETi%kY18a
zn6>4qAbj%?;PNkNKs@J-gm!o~D}a@u7U|~nx29B%u5l^emI~qisYe?{qA!V?EZlqz
z@j;B@06;)w3(Nn8#>ReRsHA{Oulzz#(qhZcbTu4;jH|h#ybPk6FRE-t)?Z~&&g=!)
zR}KS&uVF#l&5XZ9ojK*vFPxl*uR^it;|fY?QVL021(54-nykmTt(5bX$MPU34~}35
z`G-I%3<=q<CD-+ioz?Db+p`<U$be*xlkBhD3FKj=8eJupKh54tNwSV}&{nc%UlCQg
zlaja@jHh+P$tu6P->C!2x^c3@5mN%vx~4tu51FUezA#c2qOQdF8~{$oFw$IpP?gV`
z!`Y7@12}U$zNRpC&P4+REB}SZHWRcx1?G!sN>=thkDNg-=yI{Fjy{=oxVtHZ5hzml
zz*xc{ni|KCe89gei`-W3Y~SAe$Z7j_nj^J{>ER8bYAH(Sfd=ww{betw9O++DG{n+?
z#~T3-rJjcbhTCkPO3oAk0@$IP`;LD|^1xDn5H0Xmm6Hk*pbG*76ONS+)Z>j^naL7-
zbh&=<dXTv8D<r{g!)(JrwJRx1>K>?vA_P+TzOL1r0wX^48}HA^(YI|Z0mrw}Z{!K0
z@J`xC$zu{;V*%FT7B~|aDiWV?PsHIu^wZ8ypz{l6^f|(R?8RAYP6f74PWeUSg3C@*
zRGub(rY}neZ~;JoKwarX!#~5LIa^>|2GhXRi~9U0eTv9@yHv6G;)engH{*s(o{Zn5
zFo_m<SO1|<zHmt*0qOLYJ`DIYen%!J36fvdv$GU{EF(sNF1qp}vbwV6ES=K2c3hA0
z)lEQ=s&8-QVv;R^DDpZg+wJNsW?bqmri*fx|Nb-B&?nCoRf2vTkSdM7k9oVQed6`x
z4VmVqjnyK_^2ko5@zR~Yb;-oASP#1c_jwh;?#(xk<7i=SQcx+DlwN|Zb7v(JP$1#0
z^}`FrE%git<=iU&El098M(#^4k#OxOw~E<NR_5REHrIaEQxO7QfBdgRc7$A#Ti+Pa
zQwXw0_t1OvP3LW1L@!BqoNw#dJp9**LiPlbxbD*ZK4JWjy}d(AGGO0*hL4+@&SFU$
zA)rug%ybxT+L29A?-P<zO#rf#-#8Ckges^2Wa>sYbm!(OrI+ZBg|3w9Zr<fmvDu}w
zfZ`RZEEFa5-5Dw;bfaqLnY^9@K4l}oV}oyj8NuxnPS{0OOaA0ly%hR8x$<5LQ6Y%B
zv5xCoCzJ#jAbD13U%Pm2?`wtJUqPFL*K&dQyag}HYdCwAqWm5c*qPp{7XzZ#T=~F@
z{SpvgBA?jRK{V}bW)?~~zW5AJs{%KT0q8FYp0EwoJLrbwoyA@})jQec3UK}r4%7vR
zewMr^+YY>Fk2sX$R^??t0(owK#$W+PFQmW70~lXu901&7$?zYo<Pm0FO2{X~KM+xM
zvoUoKIVrLA+Ph9~>54K3{PR>5x|qJ*L1|FJC!78m!==z&>e)9VAPlZegW(At(A=!x
zImRI~6C~&X8<y@oqA=`H*V7Ss0H^wY7rQa6MNKp2VE{yoNV5PAi|qiYr|Bv>b%=N*
z@V^m|`hlYtZ==aX4MWfIt|)&fR4oNA+HKyc4bn2S4^;&>#j@V>3QKv^FF3y?Kcv8h
zhfJ9|lO51uYF3QwD2aOQV=D`G90vl$CoO)FH((hZ%J&EpN#>eOzTDT-dzHNN{XOO5
zRml08tNLVnCCI&!Vc*=yaSd6pPj#Pih0V4%sQM(}n%t*Ba&Lhbkt-nv=6y<?8siMS
z;{4+}bt5|{fTC=j<@s&K<Bp!Q%7(nuPCZ>Tl8)@S8DsF{ui9tb00fTgXTzE&@jDlp
zc}ZdSf-b%Lpj}={i&W0K-?|z7H&+0VPg4&7FlHHRTEhnbMB^G603h|yEGUV_?Pu3D
zN8s(40}=Cm0no1j8f4?aqG-~kko1ya2B7cfL0r#I2Cui(GEPrEpFDei$oCIz{Lw<S
zu!Af@vtTve33zoku4~Rc+MN4AWmoIT@BEINXZQemc<p0YQ~3So@=8&}XBkF<GKPqQ
zKniHY)6sJMa=6+S%d2pPej#6TIk^OJ4fke!Zha))01t~U_Z$AjrxV92*J+*XMoVH4
z)JW+Am<NXgYpK(<>vb)nJJXH)Y$qIv=(J&w#(Jb~tS^(aLuSWP<37p(c&fXSp9@p8
z5vSKn^*Q4N<OVBbZv?`9rDEB;EK`rQ+z23}oYUQ(UU?*Q;)g}owvX&<1tR0ByA(O(
zQ3`7z_ML$D3u*Yh0;bDdiL}7EH5`n`U5?2xIH-spEE!kA{J`}Vdtg(B0)Cq%`OWb~
z6oz+em7(Q+CLVO^c*+_La9krN|IXzq{KXp<PTK>w5J2&K_}i1-8<mPG=?D|&xYR=n
z%<lcPOJ?0pT)*%q_T<ICht`5fch#toloI4p9yb0vhvB>>wf}~mu8dLoAf89o(E@;=
ztw#SoU9bJ)baF&edq*qt#kq)}!&-l_2kh?qafFhEjmsAJ4F_`mkt55f#3U?uGEP%o
zO`XC*4lIF&G-_Xk4+EMr1!CtWkj9;1f~h!`M*V<T8jmIzuOMw=J(s8G55kOz)dY`z
z!TF)nEjZ0XASaO_P%z>)f`kqO2S#>Y7=vT@&0-lTUXi*!5#eF|cXsm6``1Q_oKR_p
zZVxU4KR&ptFaudu6>h`BzL!86*D!E)cdr%c4)pbi;CTEwnU%n!_?Tv~vMi029;>}g
zFYnvevj6rV<$?yi6pi5MvaD_%aqzu|k75`*CsBBdQ{`T`VXt(OhdYLCLd}*9SIHO=
z4sdC)gt|m?Iif^vB<|a!t^5W0l#$*uhng0G(T#WT^gD%Y#ar}pl1&uu1eq_iGT)`b
zLN8A4jgWzJL=ik2K5<oOA?VN6^5IVapVPue(VyX@ooowTi?_&p67u&Dj>Y9ztYJr0
zNMQKLOOwn8*t_qkqjzl&b~V}%e%J6X0`j&x<7*PyUL<TbdDu^Lf>sIDb#t2l9~su8
zLQ}l7jUYP7Zo)o}ZE^`_0{t9U<7_V6d`?Nh<U|0~bm_A^kvpqAE+M4(`rUWUM$)b0
zzEmBH!2I@qwOb1X!Pqs2!X0r98z>ZLM0+a@+?0kA1jH^ALYF6_ceOqYAim@3N_NOR
z>mSzF@e99+`!q1Mm8NP@uh)?&kjQ=Nvz_~Wcv~#ZC-y6)_D0Rdm`hXtNZ7<b(+V1K
z?r+09&JtuAGv2d&u~B~{xc*DPI!~)88YKCLVKGSXgTTUH-bF{%CxA`|&}&g(ds+fK
zaFLBPhBc|pj%oPPt{j$*E;4>f_?`8m_gsJN?ZJ5Oc}iY-4x8elTvCBs+n8c!o86Bi
zv(HPO1s)EPglM;lW(wNO-sv)orNN8>XOHxU%JMnkE;j#{3kKb)h*Ab=4@tHrYah_;
zo8|Y1?*r;)ffI4=BxIE7So2-3pAI7U^`$<YnJzX;D^q*V!IPiuS;=2vo-Wv&^+-U@
zS&XuVT^yFuJXR(`wT)UWsd$ziw$(gaL8}Fp$<oS!Ss^Q>2Ik$D$WVMi?3Q{2q`O?*
z_%7|kA?H1Hkr<#!37F^+8j$lE%ck^Q)LZ-5THS8sm`OJxNm1gH1w~aQCzE$0m@th8
zfZc^^BCkF8GE4bd_j+#hJV&E!Lcx8Vcc`3(Z1D?VeBTpI$*OLQ{HA;F#c6j&h0)8C
zslTjS_WR4L!Z~@gkNTE+DIh;XKSkDGCs}fJ1&>eA;5wrb&TgtmkFoczT0KbX$lu9v
zwlJ2gnc*Zx&S)sjdD<j-x5WN>B7lXmCmg|}bXko8Wem2Zt&axJzvO~Z=cG{OsKd;(
zq<6U(+d!XthX%tW66QO{`LOAvMM&LarTHMyfj5#jG3;0&rzfvv*Jl;SpHx;WmvoBx
z=`c(L5%rZ7C8M}>9dY@32D-?&)497xbZf^rjplx=#GYg!XPaoOs-YkAksWe^e!ZXK
zxGdAm_#haM`TZQB$<hRK#GZNn4R7wl(R*=Z9?d)!{WU;<hTJHZu>0M!Lo%Mv>NfqY
zC`9c#6WdkfVTG5JBO<?4A57=BsYAVWdyPtNww2iCquG?J8ZNx9t4u*oa|DeKP{72H
zn%I)9ljM(gmvT1K=`l|z&>t@%(;r64^C2GYicOkPo9!MI0OmhBZ<j;G50>yF67Otj
z+AR6;#gcZf1RQP(r#vT2`|*Gk3pcf%d}$pIo8-h@DP85=F)O;y#r>iUck!d$*$Y;1
zTVQFHT}}AnqeA8``@(s!)<TNt#G+jDGutuesfaQ|2fqqktPb0_rNXPcD#=&!EHn&1
zf=w+>G$q-GCZo~9&LwYXOYcA>HnAv_I7i&*SV<<HBT{>vPJlOL5sz^hb%<KW_YY0@
z!3KJL+BEz1b(b^?qgwX_=DX%f?kD&LmNoQLfTNWhrgMNE_&V8g)wnx`hasxrMz^@?
z+jTQ4{9;^w`oA8e_Lz%Hfo&6rp5S4}@6z5v$)jp6&RFyHZGm}GNYi6l8J3oWa5*h9
ziK><&zYNF}_z;)AqM0D7;WXM`jodLM?~H~WhBFS03hrfbzgKaieekLb5QT}Vaww;1
zgY#x}+LOz6KC14$`Q2;^@rxW9Ov7g?s2e^r&mP_tzNYt`a#rdOA+{Z&N4tZ41lw1>
zC51V&T@sT{<=Bk<4jb?k9bOlhIAia(UeM-D2psF-d$HlJz`Pw#-s=iQ%>Q~eLt;c5
zqY~zV=cx?YOu>`@Y+U72YZX_<WWg-wuxG}SlxU?Adu!f~Uht}I!N1a&#_)Yqmh^c;
zwPo#+PFFw&^k}%H#6|7nBMDvujV7x&NP?6%ax@&rE%t5MQMKnL{KN~|6Nm%qRk!Ga
zZJ%sr{XQi*f8smLJ3IV<7eCmN6zmOl{!AwjV#U*?t}0(rvbapgKoT9o3LY(!IEXh2
zKzB;T?y1@u=wf+8cpj!e;FkvUvjhU#RqliKRqJn2^^v{dW?cl3y>cs=Rh|J@oc3}l
zq*Fy6nPA39&o5@ey}+E9w7Z{3yoHf~vPi$r;^Q_pvh36vXL=*%IsJ2@2$s1of!$B*
zO=9;}dcfIi^_;#@=)F)jcDPv@lZI#A<Zn(_$VvT?Xcu3Fh~rxA8SbjK`pXK{`jk3!
zV;;=sn8jzyyVR+ptQdgG`puNt&1hl!&HtDueZmZ9AvzS$Nw<lwsV^2{vM<uqs_w6w
zR|+Z2-wdW1xwIDRj15}v>lAl(?6haT#-R`P!0Jy#9d2I4s+0l%hE;lny0;(%;w8_b
z=oN`danH$TpqOxgBV$*eBxGepia4+VU~D$NTaf4!bQ5K|45Ltp{?Dm`;1sHC#I_2&
zEn`luAB)X2&=KwwckgAFPEq_M^W}?UlNQ6mYS-jzL;Z(0M`|e)vV>W`@FOi((TC3u
z-wPtPLDx1}zVOMJ+g-MSGs@j*3&u~z3c4N>mYRX6sGW`NbsM`F;-WHUr=BlN)%R7g
z`HY@1l&2l*V-v7&!<;_tPCP7X@43ZI&xenRX%N}Rj8N{VLb}9d5iK+O%A`WAMWXRQ
zux{jvnNd)37oX@mB;Vqsqjx>+kA_>!i%5>Mm;UC-hXl^4^RDl+rNiTHy&zN|-O{sk
zrr9xt_$A4-P0(@MwMP^bkk>ve9mt96RrbH)+@XzQ-p+Z<eF{FEB2y^JE>TS^LEE%i
z#R?jGef5cPnVLOG2D%>Ceu}=L!cnvXf+ae0%DxD+G|Ep(5=&HBc)8z$Y0gl}aYdrf
znS{76`jz$kwE-CYtNjDejG`XIaxLK~Vnj+TS?C<Y@n!tOmMV@h;AEAeqAS?`)d}2=
z37HPNcFiLlbLAWm1u#VD8c(-TALi0NRvrh@RrHZz|1ic5$d*3u<hxbs=qpJ5sgA`U
zKt^6iyX&G#rleZD?Q#HY>7WWO206uWoV{Bt3g0Vb(21_qEy{suAJ^0Atl5pb;UF2l
z=SAqthX$Gr<Q1b~vbQ-lK5a`pdvsH8BqcW?SnuTw54ZCU>gwhD`+S(ue)!g}jFduO
zmbDsgXFfBK>9$URBCaFrgDgBnCVCPiy2%g<6#aL`tK#)&rCt}$P!HxTg*fN`EVQfQ
zz2=b&efPRqo_zHOFHwy2d(fYgFbB+Nk`@-AB0^4n#@HH2XP@=`V|R-=!xTV2`i(iK
zWcIpUW{F>0PbP^@f?uv<B`9{AjQmQ~LpEN{s#cs65FATV3`=tI6gTl)ZD{D3-;-vu
zAG?I-`M80UuKBUpi-DABo0l%{y?sEOF|E;#+-9L>CEY6qLY7Eo@0@z#uAVUXOzTJV
z=e?QcX9{Im@6xmRPvl4tUMolFZAgp@&E-C$NX(oXH`9zwOFRqv`trDr(C4Li3)#~y
zICHV5oe6|A(pe<ok71bl^OEviy(y=-raWMI>*6}X`&zr>Q5h)pBnbZGwvlN{=3<3`
z<Pc=}aTD@Mq=ysz)Zps8jr{e|jQ7D<7$Zi|@k9OG)$vx=-*N%ofVR^{fZW%6e}Sam
zXg5|?^s60O7m1ML@8U@dFRW#f{W@bzgjI$z-8EzhoTVclSq0f$d;MRptu!ICA{_!~
zVaD5i>kR~P6wiI9tgiF;Q0tN3)&-lK3En{1^>}hU4Ln5feRK4z(1qP?J$aB{jB%&)
z0;UhSV|mse4YqEAdZlobYZ*?sw*Tn&^5i4x>YhZ1jkftt=)jf04}_Ld@85YlRQ^N=
zR_t@UVt%|(3_5Nxo?|@zQSGD!vu3415ou;tS|@-RrbnV5F|^;vOmL>Nmnl<yWSh2s
zOrYyz7RV>cvyont_wSy>tEt`2{oHN17l66%r1OEY#C@CXgB18kpx90-+g^vEj6Bk=
z=H*=YWTbX}x;~k+o0nHfhkR%ltVxXrR#5NjJg46I@=}QGYK6>z)(N<Hv;3@DLzuu$
z7D}8#h#r+@Gc9>`*rt@w1SNi}@g(thhF<Z!JGQ=^4Q;7nESH7_S$qx}bkX9n%>CJ%
zDWYQv-r6ERx)Z!9a}8l$GWlTtY0gZ=QepfzDk!qkz9-c?rM^Ffzo=V`_%(O!eDrwe
z_Lm1L_+`FU_!Hf?WYamKaWC!qShc}ra|>9In5*>)jI)qFZY;b0cxYu{1wH+aq1`(3
z^4OL4Y+3;5wbg<tt^U_BM2iO2n)fqR^`|S*PucRsMIBQ}qATI(&sPdcTAUiX^&K+`
zW{d`><b+e5n%@JzoT{lShDyKbc<Ef$1WDL#jDCwL*kybL<ZRlebg;X$=NEeqK++m|
z-u0!WO-Nm-%X?mj<~@EZrmwXqlH2*f$=3T%^7_Uvae_AM(PmWM)WDB$v4@<~ena}k
z;$-$3RVV8QN40)xnwuhq9;*}i)3TaFD@iU%(E-%G%Mp6E3tg;4T>!*|n@aBkXHE5X
z>Jy*y!EfpPeE~NChvW^?wA+hzByB^#Xq?ypl%`s!4Gr+p{M$L_W`Qx_yqRMLQ&RlW
zd<}Q6CLtz!X0<w%(#|!4&k`}bD<=G`2n9JylZ%#Q**od7xGlaofBD}phk@=+7S5$i
zL1cecP3Y|h`o()Iq@rR6*$M~RZmimR*+#inQ{;+*Ki+UNyjdiCoH3s@KC8ybxIFVs
zEF<$qO2SpJ-u{;3?A6of2lbIVj%0T1i)iN5$@)p<R^6NwMx&=s`7JZzf8wsFm~6HQ
z%<r_QTikRjV1DQW<>c|4y)i4CwdZHfmq$FWxw(>tQkRUL_VY)Z`GsColoAuTbb9^X
z?{}DX!}X*v_eR%q{QSY%`gn<!>$ro4j6hC?+&^MSPq=S2ua--Q^g@}zQ7M+}@ek{1
z-gGR!a^Trb5GIhW9ZzYtFT=n@8uS{FX9B1bU5Z1}!PkHSZ+R%>#+CbDDK7+@X<8>}
zy#gC3<xW%k`!x2V>&eQ@7ky#Dtv4H%btLhb@w|zNTt)8FiZITe5Fw|lwB4J`CxHB6
z6V20T|DjzecJ7}nWMn=M@(9H{Oit>ZrkYs)>Jv~hX=nC7^)KI2ZJMqBlg*~ZK>O@v
zQ+{u)ny25T`Eo}bzf<byGB#(FONdc`2-_=zy>Wj1cGf0VAZa{2UnD$`MW+^|&B1?<
zR?M+q=S*;E=s9gHbMAFg*zNyKAxVSL<4+k7le3`rcPoIndGRDNB`+Wcb1khi+N-Qb
ztc{jWFZ|zw$0FBnar+_c=Nl8%^#xXYjW8I8XWWTCc+gy%L-f-;2k4|O^YL|q*Iwy*
z8+S3Bt!-9_4VtKG@XdhTf1GlKj(dQQ^Q96KD~_KIy#wp!7D}fWBg%S`EQANHtgXL8
zfu@)@a7?2jMi{lw>-8_y{mSq8aa;blgp>K{^lc6GI-=NL?qG;}Pme*KbdOCz{rgPG
zRl<vsD_OnAdf8&(fX7N0eaOhIk;qg#1lN*{-1&+pY){3Z(r0IcOAXSiZ?r4^*K7wE
zMZR}>Hq67YJDS=^TZB-32RPeyMTeS5v7ArPMgpT=J2WyJM%wFWW+6@X{#TR4nl<Bf
zT0)I{?lOqTn?nO|h2KuphszGH|K115l^sgGjM*Jkd8MRPp1-h^*8xd(z~_M{gzqBF
zv))1iv)?=v(7iPCPEVeCUk5g2T``HeEI?V=Mti;s`nXn;#$6lhD1BT)BGi-6WTHhN
z@W$t*#j`2!Nm;MF=d~{9vqEN*I&O_`@odLw+pP*~%qOijb5og}sywVO&5|^|A01b{
z{0ZZa!jLf$uV02v`*ydPOfeoxUYyy|bvZu2)QhzhiHXe6o)tfd5}hY&+BkrKyOqa-
zK(z(E@8fO*32kjQ=S%jY^~v(H26t$c<!liPW)DmT?3RNS%!03Zn<+q(o7+`g9C`>R
zSz%9*#n3R$kC#2`Y6IAN0>*#O=4LP>nC0s3vgL~P&7?h#&$WaO>G_yEB<T2hOV5k0
z+-+X{G`Lrnx%1_b7vtO-`J@I0#&W*a_0?tS7^yZ+>Rp;fUTb)6&<FZeeX&3A@1BYG
z0*-R5^^x-!pUHbwH%#sBuK)>B1BMOe&(?6k8b3&Sy#5NGP~OcjlGSo)D^^%FtF@8y
z%1p2kYZ^LJW`1=uy{p9&&3dET`*kkj8)X14A*+Iw@WHD6$@o?N)fBP3^ROq^jF})#
zg?v1-R?-s1$<j(d8#h&gUKd<Z1r$x3Aikwp8mGn$g3XOsmT3s?uarGmEPTWJ6KKx9
zU90N}Tm@*LHc25!B;0t!K5uXrVJ-(a-(NjjEQxkGTUy68BNHBvn}oJ=w+%Gw-XSu4
zeG~Sc-s2_WsUw#jR{QkB-wh?X0_Z(to_E5?qtm5JFK>%D+vLE6Tjal`x-x23pL+YT
z=HIzbAzplPIIyIg`U5|MeR$;e#oz36z$-5nkHE4Q!J3l%>#?QQ+4W0G&8pq(;Kr-c
zYC4j68Gpg(Nr<1z^D_cZQrav2UX}d0_K*H*l4?5ny#rP*UeN|QyC>nsS9)%_NW_*s
zNj@KPZ)-N1rdfQ-PzkWis@5r2u=&2<NB6a#L@WKtA?snZcPKgSdxjajxQ>u7c-)&_
zInSo82O|#hFLBxWSu@6@wo#U^L&}^%_wM@uqux15s;TQl74lJ_cUCsXABkT>oh-Y?
zvVVb}R>C6?%R<WgdBkcJO)}`-3;Uz8v50UoFVO*M&|>AJQ*?6DT4C+8^IZi-2x9IY
z!bxz~GWe;m&p0Ttgv6(Ulwvq{z;qK&PD&Q#P+GigmT6wlkhD6IYPcFJmv{C`T~Bm`
z@eARH6@=f;5q8NHrzE;V;e|cq>$1dg>f5tmUS*o^r=ZYJ%u&evc~k(9nqV+rw*X}M
z<|mZvC)673#PWym2zlpEy+tk6;!p;jtEYX0=MUwW4Baer5*Q(o-c?cEjVvdsUU2}-
zl*%=eJTTUv`TQ<Ou;K{V``6aPTdV9j+YNqG5F6`h-7KsOEkNP+pCrlIe>(3!9<Azp
z@20Q=a#x1W0pv2X#_ruwSLFGSI@h|)n0y<ESR4pE?!0$bxR4In-vHtS6ZPMqF3F1V
z68gVsua8PnV`_)bay$9rlskTKS5SFj^O;M}4uiv!#YqPBNh>w}2@ysdD-W!KeseFL
zwE2xj1rrLoxuSyIN!skKhY^uUi14<@wFTVT)@$YXOix8`Q=@oiTbd^%N<-%*iII1u
z>l}Y+_?hLt9u%sjKvnQ?<Afm0(~gU~B>>;HJ9%W`_KGgS$Wm;6f61`=2D$o_h62Sz
zAw*KwEdk7pk;p`Hu0P@oJ8-tX#q#+ukYbZ09vks4Y>AWR3za)PSHdnGCFewP%<S1}
z9oev#YR4+TiPVEesHc|^IS&T(Z<6~Xxp*>@{_vrG7fD!Br&P73Wbvc=`abyKTG?gX
zGq}OOr9#D6!B_F*1+BL6zjZ^%tZ4c}Ct5cIga4;bAG8-WL0VWXUO>f%&+b2VB_`8$
zDPO%kS{Hdsa>3R@Z)g)N(=&DMVzPA4cW84nzRR=ANH1Oo%Yc_AfGGdBr~#g-Z|v6s
z5Y3DqD+uDfGoyEG&Kp@A{F#H$VgJ=cnDsdNU0-?OKnJ$!3863{*r5`FkUhV}u{#bM
z#9lNx*@zLz-T#6JJv%Si0l3r=E#?7haHMt?sS2*C<)*9JX63|~wY@k*EnB@_rtR*d
zqkoup&9iWKbATkO=658)MBMA<qp=J-^4Z2n=4AbmMX&f@QjjBso6v;>wf=j_ulV^3
zuTAR6_n&zma&IqX?x#+6rhEak5heoQi~?@!kVXo%3|My*xUQ*^PeS8u`ZIVHh(;i~
zca6O-3HB+JXkcnBj-Qyo$Pc`px0g%SBm)JOB%9@7)v%cg@pk*AcPfHwv8c0Ul5%mi
z^YdSgWa#>*q8HQp6YUOul$0&b>^Ak#J73d6X=#>y7{<Pjw1bOa@u+}*O5J1;=Eq_*
zSaH8+CEXzZK(qpD$*Y-`Yqb9JD6;@QNLqqLYwPvVSY>my>r;ZjyoC`&tPC~24}p>J
zFI^!OqAH>UA)zD0LD~pB?@*%Vn!lV9VE5Lv!^l1eJx&&k<qZ(%$o(pGT@IfWtG46E
zRu71~w<(Lb+QrYnKwWsAFu_3<O;*^h_wpm><`e<fyyjm*^KN&|O7aZ6AVYD+xyz$V
z=~%k`xvM&o<x!7{TcQII#*k}9MA|0Y+ky2D-&FdSe~Xw}#qT}j^VJPHaE8!kB%IYt
z4RpJ*vAn5Hm8kOmkSsXK`s<og0QqR{s__rvYGcV+CO77K<?@+pw^{j>tjr%K!4e%<
zq%12RqX0Rup7M&Z7!-C`EN}}i{2=Yka`ae&zYnL!+mJT7S8dRUR(vM-t0YpfDO!Vs
z@;B|d4K2ZH_N6p3G!;)zDpB@4OD*DiC3n&Y__B;=7xH=ui~R95jLl$pB-nrHeDde^
zih`gd)t*CqMtimOy~s+r83IB5ov$lOhXTJ|%T3tjsNua!0h_b}YhpuSFa3`7Sf^si
zXUy%rh}vzfu87Zx;@H?6<M0t6{TT+Kr#S(eDtkIt3#l_c7J`yPONUydbz13m7KA97
zpNT?OsO)Xh{Vd<-jwJ*R_u=1pZQhRHgPdD@mPdhft|29`mePrgq-G07lzRn|KU*TY
zN`ZyXKoED~sZ4@L!R8X5-^f2kl$EW-DWWJVvwma<`v=1K^tp0?l-e@d=l3uCD@^S4
zq-T$*tY}MtzrE<nFZ=&CH2Z>Qx%cZzo-@J^2Yv*Yob@bmg52@q-xzSL9g}@Do_Oi;
zMQBdGOsdCi^YLRKf26@*`kGr#Poy-INwg80ki|NFH0=kxz$)#B)Hf%<;uXzF^<^g7
zrTu109Lc8Vt7R$`@BOk~X`oa6U&Z6N_wEuIKPOlPtfQ6<H9mhrP)TY2;G$|iqmYj`
zSwOJ9eVj%X)7%7)L1|{E5QL=^gl_eFxbkPCnmO~Gua;aVEI{CItxFK)M{*;E_v<Kh
zeZ+C4EQ``pchU`~?Rvy;TxUO%S$NUyu|$^2gFgtgXbqFg&}$>avF<Si{JU5qSBmHI
z+VSGl&(&qpc)ynp+vi13$MrdDdxMp?Ost0{dcgg=UFsr3d1>)^HBM0z4HsQIXSkk~
zJj!`h!s)B(R#_|NZY$U%{V@EFs>4Gi8EKj4VbnfXPfF_NZUsa3usiKq#$sM&6T}Px
zoV8jHD2bK7f%`3Rq~3auHnNz64mUtu#*{3Rh%_1M$<7f#tD!~Ofgh$KwZ~($x99>0
zv-=h}Cs7LUv|9K!ow6~~6$5K#Q%sWl!DLxtKkXF?dW7s!+Q6AB;&?YQSkg-l8Q|Y3
zf(o;+Jm#(wYBYHfT%qk+CPS>cljc=xJ;wp7Yxke$jM*bt2Wb#NfVsgdaJHQ+gk?!(
z5xbf$oVa{u+AfD}uWPeB9U)9BBpLl?4p4o~-IPx#3L`l3DYefLpnXei1Dy}bJ?Dq`
zex!8Y7Yo*m{Vik^%wZ8<hQIM6rqo;L4cAe<FmGo~(bx1B{=!P-tnO~TDlO|btiQCb
zHSwE5T1~HJ4L}~WxO0qdUq!uQuUiiv6gaib;X%D(Xf=h%-Thg$mSTQlZE(T!%P;Bx
z=fVqD%B<%<*R=Sv3pl*_X7<rq@7|j}*0`6K*U+SV{ZUTBXrRD&PnRw>Ff8VKNB8n8
z(F{xZ#hf<u;f=4_PI|E=t=M)LO#hLCB3F@By}ga5#oRgWR;XGwQ9nd0wtM^)Q|Z;I
zVK6&UgXXe$rZ$lH6KhXXqG7fx@yp4_o0fj<*KKM(c`tWC#_1Asew(l5$WWG@NA>hB
zvc)1FoiS3^+ncg%N}q96ZQ5kcc<FXvq=13e`iRz<uj>(FE*bTiMes?IT*wn<^u9!n
zUqmaVXn}fclJmOXC}7&fXrQo2ZfK=vpM5}7oNxGqSa*5V%A9)NmBVUZ#UvB{A;qFb
z5u_r-Rr18!)_Zd2f@3V<o78<KIOcvUIJ$PRwl%*UZo54`eNzYb9kot5bUvraiI?;%
zgZXrK-F?vY*=+f**TWcU<!e{Rr$kt&HyIVI0_kMneF5y6lafuio_Ed^z2l~vJp8OG
zL&-eZUO*3GI@>PGbKVPrA9v0liw0i$@%NF<V=9~O<4qIwkceX27+T4=J@Ad*KN^oE
z-?XVFw{Y!<dgb%dv@1QvdxilTW;uWLPE@H&0~fwL+qHV)<<=(*;T+*+{VN+4n|J=!
zaUXF8R&9I4U`xV_EHZp-?E>Ood5Obe*zA>iCmIdh5I;o97MpvQE5jK|I>mF|$l$Uc
zR1EDda#7t>%t&c@L8UjSFIb`M)vQapT%i4Z<gMe<{Y~N9`pk~wb}^+E%NJ)=g><e1
z?#F0DG9(1A9@l0q*0{fSq)U;PyfQklmQ41YE|t{ThSZ=#tAvneL-&qoB!_O7G;u98
zM3x9H5a?+J7VIW3C6(2m(Tr2uRRzSMn{>~6-|F8W#XVN@ncsB^SZxTqn2B*;T!roB
z%qIT}4;iXY0f2-MFwWEgfLIjGah@sS+!<^H{mt4Pp4ctdJ2{gu%wK?eLH7dPzE=Cl
ziIt;|=RR21%7nQ>NdiG&M3w5~&lU$k9B*tUf*G1-xwp_-F=!D5-|ZQVk8vN+B2M$|
z-D5Ji>>k?9xvc7y?Rwegl+cr^PS2ip);&-9-TW&ngdD2;^P3cz2Fhl%*3<8{Ub-uy
z*KJ<z6`uS`JW-_=Cq!KyBGQ$;#U%pVZ-;8=!50_39DRD-74C3du^YWmvY?lNf^01N
z>J05*IR3n`8;h~@jQcLhU9MJ^X^Q{(MMIXvyd-+2D>_WGk#!7`#VU;|X-+aQ*BypO
zK!Akl!6DBdkNF!~W!byK<Bk2JL<#5Y$&aN%L)vt}W^hL^pE@iTM@J`iYaTAg-gtLb
zOBQ42&=|i(rtQfVtUNe~TyM<3NrL~Oo$~>!>mPS&H~#Bo>aQDiurQGo!T<d99vVm>
znL4G`csMiI)9}1F*0PuGCk(bb6pyDnx?DD{WeKvWTc|=Cov1TM#r6_d`^%WlL6}LQ
zKOg>Cls{-4$iocrpRE%HNujn~bNQ>^+62~)Dg4Ry%{R!f>kJO3#%BV2v{75O1QX*;
zj*Sr#t7|Iesp|?pHNG=-O!WM%pgV%9tEEO{{x6D-N)||Aq7uSkV%OtSPN}ZXdDZ1n
zXQJ$<t5?S9#{#Z%+(g|M%nu7ZmTQ71FVR^el>TTqt8HtSA3!wL$KS3un)4~uLc{;j
zY+XG5vHqt8`g}VV3J&%~1vHu&V<NW#(Zo-$O=+E)55p-0g-ek3>Cm(bNgqYH!YmCM
zL~V3v?I(fk+C2Hdw#BTNtQ%|v@I_gzjT->?zU6Qmsma$jKbL*7%yD`op&}`OWp(Zt
z#|M>t7rzAUVbLr-#iS9EUcN~;BGD5z&iclwFq==)x?@fD#UlK1-#7CbaV-iIYGU&L
z4}$MrW?ZS{?04eY`c4f?FV>VZi^uZYj=NGgxdF~m6B<wcL}Atb_O8dTnW2=GJ+YO(
zd7_~uB`AP@VX5jSa6Twwi%_RV3jc{Q(W(gehi8g>HNM0<`!75?J$ZnU(}mh<$THWs
z+Pr~pmsBoWe4<1Rl!Nj^*>OFMcYuxsWw}|uRrJ5zyM{a&4gA?h_}UBC=EYrn=C-;-
zG{6gM$DWOl7?VGJX(!RPH>JUdd$e}XL*6d|zaQw_UhzmqUB4Ah>maZ~Tm5xs1^qNM
z@>5w~q(E!gqj)W2S@t$x#q44WKSc;|WC$X>KDU$ANx#eV{XA*9Lm4}FVK7M&<clK*
z{umcr4*!X?e{H-B7~kf5@H_1jWz0++M)dD!?y8G?NvZ2`u?0Ucth?)B>&*Gi@gGe_
zMKAx028XX;kf4l~p?I#<y(iF5Y^o$T3F{nHfp{MtdBc=T8Oi&V(I8_+8-*_I1|EUe
zQ>w<9+^ucIQxE%4+g_$AUbAGD5BQQNF^-*_`i$@}JN3|=cE(Te;N><p`RK`OFF~iP
z=l813vO-Z?K6NE!zj^j<V*+zD(S}B%omv*YhSOQ8`1#^mE6!>;3C0rtXY&!x3>Pi$
ziohh?_bS@olzlXMo7thAxqoxCE$`h}U3&fU(JP<P7|hw07C|ZCJq2ncq3}a0k7(SJ
zQA8D%@`4>%*D6Xk;r=X-HdyT@ney#WL!{4QqQAMPuXab@xKZ9E{w6n_uy&{4r>Z1*
z@>eTm>JsjZ+4Zx3w`L(nQ>PUVI(%Uv$d@e~vfZBE@L$LNrB|={*tf(9Dv=q1j6GA_
z{>S$#IxBLCEAnP*pzXAXzJLQnBqpRFEm>58HHA!Fft=7~LFlpu0n#&sz7c4>I*yzA
z-^a_Yjx1k7+7OEZhGLZN_4#z4b}qpf$>&PKJAFp}clIx>uqP!57x|!i-h|)s)W4B`
zqkieqYFzW^YCClKu|$JIjvlboS=OYnAKRX*<n>Xm*YH^~&t+2zG}Bb!XUTcsj2qu8
z4Y`$qB}x7SQE|}H>gV1EWZ4twJKXh85I-lR@Z#0iI+j#`0)^G2C!!dlF-*C{WF^ld
zx2^e0*>p%wg1FBkZ?KDUF3r}m^-nu=c2#%({OGI#jAwCOEOlhUIap*jwzNEM)6Ccq
zP4b_5o*UD!u%yaZJj?hnSASL)u?|;C+QX=#-mVXEY;6Ysm67KgF*x*DN4i*etj>j5
zchcXKyo4r&AF;?jAWH}1iKtndTI<-&Ax-vA_V>B;s;kNi_ub^|*^I9Ax>Gp_<ZC^K
zzk$YjjGDw)n;WUTgZl|}(H}`-0mKnb{Kzh&%tY}87`O1qazvn<gxXL6+x<P;7HIm~
zGRboQ5yxlp9`M8r#c7XNe3nr4zV{HLKkj3%=$nF#zryli{PB&~-Oc)IUzCL?ty(5d
z%Vm7xLp+`#f>|TcpCvx}|5uW*;tJAR;R5rgXKhbhtO@zIrsFQ#0$PA)!(fRVvU|zX
ziuV01Fx`Pp<jCfqN(dR`a(?WQP6jQR9RXC9N=4V$%^a;G3r;IKIFWfsyQA8GzdTi5
zqw-;81dywh+0zQfV$QWyYLpX~c*5|J_7=j;)eKCvb(Ek@KGgQqTy`B<5&m6-k-HUe
zBtgF6W8MtN^<i~95FEhbsoNZ({+0_%SN)XH=KIJd{NF#l*2Cv=3?HuzTzQ^pO5n^W
zC<!_YrFPbZzU<JmfCELf1~%VLf{a;2G?JaheXX>T)Y!xv;}~8@1GU?wg1XL$ITBc)
z_(Ia}&Chcahs%a(MBwq_&63jx7tI07YcdIjY1rj8X_gjK=ih|@Nc*lt?iKw`;VjfU
ze5SBZ8gAEwfBe-@lVBSDpKX)C%mc;qImLVTJ}E>mlnoM~b3KDSgXEaA<$A{8iIPG3
zSqUND-_aTpXS8aN9g-x%B_4Z9==9>?WsE{c-}r>g3i~H5C8Nu~G`wB1b+4`Yij92-
zhO7t?q?H8czfzR2(i#uySdw>wsj*WJ^O9tZRxkBBuYzo8J_IElQ2$J7qa5KkWqn-@
zgAYCS^PnD)>nlei1L4~)_D{L1X`_yc*TJ(niweAaHOc2=*KJBt<fCPr^qqzTau23B
z*V20m;J0$dPMY^dHFZ^7v0=&_D0PydWRjlhF!Q&oX2AUfT<3;@08MuHLnnMoU;c5A
z^DL)QfYJk~Jqd=3Ia1gFsYD7<&Li-Z<Ek6Bx>ldN=i_B?+(?kG^}tmpbwI&|f<$>1
zu3}q01+Av^ru2Hbmlk&SPXcumgg`e%q|~hhl;YcwtYfTS>l8`>96W9^S&R>zMFIwh
zd@Q^DU=uy8hE_c&^&ZlriSf9W=IWEW*7)0opSv0Vn6S@Qi#%|nHI+$C-}r}s0OtlE
z!2Y#7A~)R}U%@5Vd!~EnM!atEM7WBtjUL;8l*j`oaT7mEmt46`r9(O=-YWQycE9(a
z@yOw=n@o|Nox&{K&7I_sYFCpH0N+;vhyS1bL1A5Wsjb8d8hg`guYs?$A)zeQ?E-XY
z)`IJ)R~-*MQ<K<+q;_5ewENA=z`oh3+yeSOUZE8+LSSgV*;KhdHm3x%nRRD=`X?&X
z-fVxM^ZTO3$1-l42Qo|rT%|IY7D`NH4`Zzy#UB^%?@IhXp3VcPiSPaTNoYZ70hKDD
z2_i_9-iveur7OKR>AfX%kS@{@Py_)H>C$@@=|~d@gkA(f4G@wy-`{`c%}h44*-SQ*
zxwCtp=brO93H`Xu*M4Ni19AvEy6J|NsPmJ}lSr;jZLR~Vc(C6L9J2f4-fP?ie5e0*
zFaAcdhS8<)a5gt{j-AVW_qY1nH!_efQ8R|vBBvxQSUE}@7<C=md3$>bp#DSyTGP}a
z0cb>N)teg<cU2Dk^dT^SM9^D5(7tnd*xS1Y4xx%7S}}HRfRNhbm<L;5O|qT(4JI|k
zX^1*7ai6_U;U^tb=>#QRN60e0JY~9CXRUu$U%lR$OZR(~!)L5CDWoy;%0b*~OduGo
z3ewvlpCzm$R~En3rF~YUjRrb){XK`>7N^wXl{lN}cTtf?>9qF~OCRh1x-S&1#l>kn
zIx-sTlqtX!chZF$9%UB8#nrWY8r4vifAqX|$%O?5;KKv9Us_knD^l>OXN%|JpZ^&E
zpQTH(w&|qoJ>{*R(#EJr@aA=xd9Kh1pH=JRD6Xam6%=Lf21h>97&i<5_9h!gKdIy8
z%J2enABn^g7R*9Bk22!}+hk1E+a_!;ZD+E|5~+|Nnpabw`|6$u-R&h16VfCQ@=`cb
zbCNrn;o6qNA!UJ8EB3+&OdwR<YQy<GB0esKT|bjq_3URq@H|X;F|_l18<sW8g@eG$
zsedMRl;~X3Syr<34H?OfU!oxNcAwc<>o4d!!z*Ex)x4A9lN~r=T;I#8ua;=wJ<i6V
zkq{jE6+q`_S~|w86Ws-TLTxNf(7(;aaVy~PV2=Cf6dN**tS>w=BmG`l*eSP11xC?A
zEv|&<>PL;?S+d)+wO&_s12%!{#tt5mN=X_nb|raHtz1cD(GsMdshB1%5vP;K!wGvI
zBN3dIm&1|o9EgQ%Dir*Um2>Y4l?Z5QHHDjW_73y%y*)a-5U>7>r4jszLlV8{J5b&I
zQJQ={{G!x7!;{`5?E&nGV$70kx)-j?7&{x*(e4q&bbmpJkb#fQ#QI9uIFf_p(NRxe
z8a+Ry*A4PGHYw@L^YCn?4sjJ6R~fZv>m|C$j{Nidx=nFK&et{WPmWR?j0kU)W2JZ~
z-Wa%5e$PIRxU@!#NqRkwRpgbYAQuw!P9gFXh9d;=rz<ov!AV|HWr|%au?XdIXV=h+
zCt9P={*msyZf?@F9X@#HSsj8e4TR$c^`2COm-!e|(9!U<OL`1DnqOmin4Wj>S@Z=Y
zDxpBKCQ1Z}r2PX*Nj8o%*)b8ON8*eR0R-q2YBr&XDN07077UDZy&1DVxzZfsOVD#K
ztVWh=?arDn^&Phc(t>Ad@0rGa1UVtNJR=|izdL)v9u_>9`Aj%*oH1Y};phm9-}oSU
zbm|LRqJ~AW#)%SC07zS7KZ%#baVdeJG-SxDpFv1TbvAYO?cx46V?9CM9+@wx^IO@U
zBSGez?`WEW>5C&W&ZE53@qTk73WX2*;_@~>aQr5TkNvB-^!1i03~BEVq%+-n$CGJM
zaF@o^(48R}KC+*kEET1O<XbXyz^8XiXh%F%cL>%}(JqWzWjs%qDgR7W9dSp*TP(NE
z^N4O%V!9j4pB%)3MeXNh@ojA`uf?Utvpq~DdE*{+kDFIbnYAnIQt>>S^lvAJRGLl@
z!PyUd=5SO9vB*6OM@mqJagaR+n>hsrs-P)7e@U^Kb+JiW&WgK<!IF7xMRIl{`Kh=f
z8Dau?!;M_#j0*|r5pt&abxvMqA21f2k1DFzM{^#}a^UMZ!cr=nh3U-OSEg;*nx?9H
zR`(WEno`<)1*RLkMhoLm_j{PQ>BYQ)151p<-}HJ$4Y5C^2>fS88}-8}GJ9fmG@VNA
zdPIy!x=`#>b!S{kC`rxZzdsu7zx&I9L&%nJNXIj`>Vr<t0zVEmAx^h2f9fRG{VkeF
zgCtO3FQMm#CG0cL$G%;N>Aw0k4jiR?OvHKNG9?`3S&1mBgM$D-U=PcI4IM?Z5yJ~g
z768U(dQ17aI3NH{1@L<u?rFgA5IbKDnP#^RiB`3II<4d!ar(e%9JJHWMHr@e#smUT
z^!>N#veY{@-56huxU<$BZLNQ|uQ{dt;=u&f$NQPG(q`~^vyE(8O7ZPI8F)+T2BGU{
z)Dv%9YX}KtSw&1&uyW4L&lqu4+o3()ckFhtqupHLE{4xKsJexF+DdlHBwli=l$qra
zt(iCU1PsM}CnT&X5XeeFetQ3cNq10n4&3GL=r!OTD}GG<@4Medfq>a<NE=bXJAtOJ
zSEeg6U!zK+4+<kD?<(LGLG*An;T3gTvQyV)+%YgnwM{-d5C;cH$h0X`PX|qSy)tG(
zFzSDRE!~S|tEK~9NUHFxt-=AWAj)@ofGWUHLeIp2DPoD;4^F@!@`@UswQUI)A|~n|
z+~UkR0SM4dcj=v0i<c{=vmgG9NNP60I|t=`1`po<J|VsT$`a(f33woHG@(XJK%%gB
z5C3@|x?*i5r&kfHnuJoT2&7e)e$<H513Z^sUXrr<)gwg}Ei&;AcEQs6cvxIX{vdr;
zJW|^82UWvH(R*jSeOE@_;Z$ueB_u$P94(B}Zjnvw3X^;J_2utI)3>->zL-En(CMp*
z6iy)R1l4BjfVy-YFDBHUT=XWhZkanxY@-$E{>v#*Ud6Ryw-Z{H?NP^4NP8a-BltUD
zak@jntPaRZkn3}g9|(syPz;m*HlmM6_%yB{9LDD&pe7_*L|V7oo1guriTEh}i^9(A
zDhKUMBA;w~kBZyQ5ms2Kwf7o5s}7+~qKc_yNlXchQ&qbhm(E%_@m3GPJX(<cN`Ch;
zk22FZkqSiz;Ca6@EKCLPkYrAhue_rZg;)Xm<0ZYH(Ev6eUCKD=8k4Sd?29|uM5}<a
z+M;X-5Hds5;+gR2WquZ!dV#SJ=U5*H-~qdno1~VzJ7M>4|8X3y-!f;d*uw>K>Rb{V
zEx4&`u&Xjv&m(hMlC9#R*%?IJCA|5;Lti6{$%5j>GOy$ip7ycV>YIkjHzr>KxRk};
zgCxV?`6T1lA1kV<Lcz3HZD)rtP9+x?$8&?}0hiV&??RFKt8m$Cp%bLl-B@<Tv{6Gh
ziP*Hq#Gb^c$c3iL$!gX}spO{bO`J~JFYivQTY?vT4`Y)HlP27cZhBi%wPs)4)in>a
zd9F{#bI|ZLnNQ8U?aJZe%Sny{mZqqgXgl=R3iO$Drdk5I|4(7AwTDWfHdeV5Uv;Xe
zD|3HocS|53Ra9Ul2<@UvkKgc@tfB-8*0uh}@e?64N2vUuon*BXp(^D-f4R|D#IZr*
zp(DpK9_l)jY`V@=MOoe5`N~WFaE-Y^!}t(cuYV!s>LLCiJJ-JFT!VQ7Q~^iN$nWH)
z+s=GMg#>1p)ZhazsT<!1sVflE$4UK^BSi%kjnIpREX_~W&U=Eqx|d0mj^3SG<9S~6
z95w|-?%Z}ybk?8|WSQJT)=pjglB!7HpW@$rstU^^nEJfLKI`bKXMTmp+D3_gx&wtR
zrn-(dh`WaA$<|24zkl#Junl#5Xy06&7LQ~&)0XC<cyBX$xxN)k#nsDaV)xqul6k<8
zJ+k`sn_@`2nKkHDsy4A%>V=TEb6J~8z2XQ$M9Ws-5-FsXx6jUeFPu)q{gs?|LJ5Xu
zt^rNM2VWGhe&Es7E<h5jFFE`2rLM=}k4U5?&BqxiihYqvX_4i}G9R;Y@%jZIX--Y1
zI%nk3wN7jO`;DPq)_>|Rxj$l`K$?UY2%p{Kw}x82rNLVC_{OT(unEKx&L4vw8@bZB
zhE-yJt<h110Wg6duM}21kCjnZmW1C!9`5pyhjn8e1CE$}3DXnIIja>wrgQii5}&a?
zr5AvWjy^}NxNCV?sHK(VFHkd3HHAx9?pH}d10r8o4^5y`B1ZLrW-ai1Q^2^nuiPn|
zQxGpW%Y%-3%wzo{JJ4}>0h<I@8qhT4_U_^G-B1z|qbQrmuP+{Mv-I7+M?ZY(`X^kf
z$ggv@&*jCjt4Of4?GmVA2kZw>wJ2IX6^k@EsCYnIQ->j$=KqJC>cW{tzM}tJ4NsuN
zcf*v5(b@N0B626t(!|=Qv6qGH>tmfzQP?XE^H_}pqDjf6$xDaW2}LseB;^14nE!E@
z@GZ@a^|oC2;P@R9m_j0)a1M-yghD@itmgvxIw<bsF+|W=oKuKZ3!&x-CK%MQ@jRE~
zv3PZCed&0I$N_6S7r^>~@<2Y?*wV)OYac0n_Ye^DyV@gyVU9S8swoE!*7~HX{k+Yt
zwu{+2g7+*o5u&Z}`eP6SJU-FlwrHaq@Xw5EJa7N|d^o!toCHSds-?PIvqt7RLJ%cb
z_tZLji-glC-DDQjh84UkgcA^%h>s$a9wA|2U0egQi%S3$wu}jM_hZENzWGav*H?QH
z@{R!3%nC69I)*DsZK+-90e~jM-LJAwt-{%E)V?eQkms)4GYENlL&W}A%=%q9)hEfA
z&(&RNA>iL53m}8XWSzHu6@uqlLBRy%3Ks6<UsiC(B1ykuyE)&7bkea<^GC=WkySLN
zz|)~Y-)V@wU*Y^DagqJw@edYiejP_6ulELt@oKV$HKqws#iGQtYGVg1o4M<Rf{?5f
z^H2=$yUFx_u?VgtdVE`@RuXB|iC4APyt2N|-bgukY|hlB25a2|v<KbP%Dnq&#19S#
z<3e+HY2Swa1}WVl^eCU$r#~FFb3$xi8??<cL8Co&Q@jXZ1u$dk0(pldPR%RZ2Z@yn
z`C#9YZc`4At5JQmSTwZ#BY*wALYLogV@$x)L3t3!ES#n4xJpLSqQTpWy(^na<Ol3k
z7X;}c^#%{xBE3lN;8iYuLqdzA?2C)~%mJr25ToH=l{M9<cDJ|`2`rKwykj2cLW*yk
z`4(>Y=1k+HL)aFqjuY&{Nmh?j?84V*M*@<}2|u;X_9CBV9tYqL;9pTp_pjws!~|PC
z0^a?Ro<Uy&lr)BAo7Wy0)wyGiSeFy?^IN8Gzo?I=#00he#qh9~!jczr<?-S2GeoR#
zQg2R56(cP|PMbeL>8ZFQkxm)$iBR0QNl6ErtR<+3S&zwNz+OO96W~~Iz_aZWdHzX3
z$lZFFV<p{s#9u8_m!eE;C0H-CnA*C3aWt;-HS-1=3FgFvhfZ#NpOuJbp*9Gh>B{|$
zPtTlbC+2ecdwsBfwX^8G*J(^Pd4R(2V^(vTxL@j;B**aFzF$nboOTTC;%6PF2Dn>j
zW{1U9bAy<x^owu2GN<|;OA-%}d|U7fvB5P;SPB~&@rOI}SLY8+G1R1;CgI1)u+47+
zW5zCLB^JTqg%16(&<<C}`Dd<r-UHqtWZA<_${~MSYX~{#!&2$hsIsA1-47JcFxggR
zSeoo(wU3M^4PbNzo~y@V1nG-I4|_BhM0T0Oofh+{8%a!vQ>Q{MXMdiLu0lk1q-4h*
zu1e+-vMaUo`{9)!GZX$P_OVcgVi!bS!f5zij)yvBKYnIgj=eS=x7Ia?r-ifF$N$DW
zoooy@hH76@@zLF%t`Ug2zs7B~85=U~r8Wff+<2U+*=J2+7Zv0=arFty-<5UDNag?P
z@sIm&K0l1E?F<+y)csqYuuO9~7G@zwnwtu3mkre$DLopdzLv?#l^VG!kC}CeT3;hP
zxg##Wx?4E1#*_Fvil#3wiQ$t%HI&qZ_<bcQ6E$sYUi#&JUYGlt2Hr6#Sb@{o0?_5+
z@-NLr4CI?86yWUV$I!NP`ZL{moE&NIQuYx=5nYt_Zq?H_P%qZ%NTHBBo@}KQChP@5
zhxS-c)kw=hh6PJT?*anp5an8SOWV92An2eQ9H4Z^+lD6cWm0VXy2?OzHC~%DuN?m1
zUfv_@y0C8ZRZUs1B5m?0VC=y4E@e}l+!_?f9zud{q80;US-@}BFJBaLTdI~o^~YKc
zb@(Z}Vs|hKgC~{34W#FWblpvn*Ja?=B1tr$(<j(w_8UmHpR5&%qbW;>kazUa;8`MX
z(88NApz9ZRbXny<N<$RME^eLW|Hd83(3hJ%K?I&5D(k-z&}3J9>`^b|h?c0BxIEPZ
zVBfJTgyy3?7U)nJO$Cs}6G@xZ3drULU1F9jJK+uBgp!pG!@i0$omcDubLyQH?@91K
z>=DZrBuQ&cReMZRtR7+o)8}%fd)vVSut!X{>@`Cc;ksDi)TDcrVSrL%M{Wcj>Dqkz
z2_9pm;N|6!vl@tbuJK|PWMF2$mLX(4MES!6we`y}hcb?4InA*7yjvCIK6U5F`!+v(
zUAFcMjrDT{sZHk{Fbi_@cL2huhbmS(o$keE_F;C{X}9V^r@`P67*ZJQ2WGocU}KNB
z{E-Q;nGVu}-K<b$)qixQ#1*c^#r+#lW-r<aow)1|IPRvXTFJY6nYfV#pcx%aVZjO&
zy)CySTG?BP&CUm}X@iWM-wF@4(vH_OFQX5f1zwOxknrrW`3$9v=QSmve_Jea53Ft-
zp=YzLuDg`K+hcP+p9n7_(7(ckb}l9$=J0VF`%=FkHioWPOUsLQUqh?q03A2~;M&*r
zwDZ27Urmi1X!cKzvl_LEnlefNOP8ypPQ{wh$}{jwZY;<`jk2_Cz&2%#k_b(Sf>C<x
zN=&N4dhXmy0~Qg6@Q|~FJROgD`QmZz`zx@jwp@R&qXE5VXi)yS;4ihvfDUm@i|QV#
zmjrkwFgh6$KwV}V4fOAkWxSxSV~Mk1ul0b05mZhtrYtGpAQ75LSK*8^`lrMd9tcXT
zW}sGj3R-?$3`W4%JO<c4;xP|ltx@`-!FJ(0LoBvu@bjNeLaT)MI})dF!dp!p<#u1Y
z?Nn;XufCY6u2+df$lo`OHC;4P!}uokdYV%v<_Eo-{kFcs)EPcIWGu$y+$GvBTn)N8
zYE%~aC`w-You~UfoB2?v0vE*6GGW)Pt2DZcQu8A^FOepv<p_p-u+=M79nVOn>}Sm8
zLr&=<dsRQo56Q~w;-D=dnfpOM12ohrmi`M;AON>-;U);4x1<Kie4)c$-qur6q5^cG
zC~o|fGyZ{5;`}35^E$yVAC%VE{eF)Bi^Y(JCT!yp=S8}Wj3}32Q@R?W_U}O`nR4>s
z&J`5|rlH#*{Gs^W!!aPeMR)fFK(H1;A-2H$EAQL*L22*-1!WTfL)LLhXhNjSJXXZg
zcL9+n1UUFYwxTWVkXNXb-#~xkI+s0j6|}Kxkfrq;D=b$G3YYEZxN)C*xEivMD<F~r
z5&dNW&+{TMK0>#dAp*mM9q;~Glo+u7GyJz5MHia6r<Tl&Mc-IJo+_R0qEkl36bKq8
zH&L19Zl>HMqg{UawX=yYnk5A?4%|Jaf-<RbAr|2@Cx|lqWu$GmWSP-k%Ry&d`jI0w
z;nU7xkj1rjj9)odkw6b_DpZYzawV%>>p|hwl{LRt&ZnyNmn%bUh7UKDQxsbk)v<E)
zK%AS>?fBP%LU?i^(7SG3r`qQ8$Zz073zF?Kt*j1au{XG{XnP=iXQco9yC1H`BUuj4
z)J;9O4xWJ+6%7YypINiL-9}lxZ6g&jVDpf)RfmeY^~ep30tt2RN<u?shxrkdZU=4i
zYoCFxosv<9cvL^J!r`Y8OM=YpS8q6%SZU{~NxvO_?Wox#rfLp3?(C5T#6F!NDK`W}
zo6Ha{0^DrMD1-7{ZgI{v-)?WO2+-NqJ2L(8939sO_RtXaN??-FF*-CCuKH#bdjnwS
zzNS2?m37jR>lk)_QW<JWc?ekfS!`j8nZoZNgt~4INKUOffvSq&0a^WmeN+aiz9Oj#
zfC_n~3&9Mko*ONmj&Uvh7^@jveA)h8w)QgmY7~o`w3dF+#Jg9W6dw&VtJ9}n1RP$?
z@K-9Q>yLEEbRTDWd(Be2$%pQC-Y@EC^S}*mpu4h+Nxl`)@nS3m3;MI3N1O8z)Fmmf
z`!^S6g#A4podAicI0pvaL9TmW&2r^+b5$PE{(fCb81{8SdBrk#GLsB9=#eq748i#Q
z0ZC6b3EU5Ydphx?HXPl=;fB6{aej?6ovDwIW?xt0dPW@coJQ^_xC4_&Bq14dG9NFn
z2zUy_JFh96Z8O83xGSX}n=L&B+85yq0LU?cMEeXD6Q%mE`kY=<4{bqj$#v(g0?tZ&
z04K8VzfVcg^>D0+OD{=haB#PS|4cl_QkXKacaQG*a~v0qkjh0RZbqzwJ7()>*8>nT
zPaO(GE1&`F&l}iLb8A{)Z1M*9BfXO96#Q(Tx?N9l<TUR~2r=;77#+kP-(5$GJpaq)
z)ZeGPevw-?fK~-(e^%H@CunXg6K*gjl~dz`<D4B#Zg=>rA9W7Mo4>8N(T+u7@}OOR
z**pHi)#i$Dxrk%xpIvXOS*&)V+4qdy&KNo~tivY4gn;17ubB8e=7SvQlyPA_<rZA(
zZEdTC$1H2<6DtO!NJRFzx57(H2ai#U^`{bmthpD|qG<(g#X1Uc<>xos%UC{U9piLr
zoEUPY0$fn=70I@<T~70Kmm$+xCh@sjP*Yq-L{Qc<^oVL+48Hka($*%IOK??8Lpufr
z2@wM}>6%S=`j1~3sEDj9=<VUaSC6fyCzQ?x=|qrUe3InmLU9kf?-v8%<7cSeK>Dq4
z1BVMoL|k~V&Yr$9X6aLIz3?1A^T)D}gDTLH%?;Gj{6aeR;QLV)eU1SO5cosnpk$+@
zfSLV^v$L(D1fKc-jFA$8I#A@5HGlF9mk01~u-gv)xnA**tIYhthtpiQ>zLyDl5OLK
z<iPPDMfW~xV@+=HTf>GXe)#i$u$zGvH`NP&#5(H<0KEL`^~rP7*S=>IlrfbbGijb@
zRt_Exx%O(iWI93d{1``D+sn(~gL0An&2+8FUMZ|3-tBc&<fxcpYDapUDUp@SnSi6x
z!qE)dHYx_z|Gi0-cf*t6>*^Hm9WjV<H_eBr^0{>XR$gjiz=vK{BtMROvM4;qavhd3
zn)v&})JJK*;yFg*-p!HCtz$%+e_o?)y%e)?)NKYY()=)Rba;KP213<qA-u&@U{NJC
z%DRI{Q8mzCGD;##aJn7k?7o{(<s?JdN0vAm<j-3gPhBUA0`jmXQC9Y)e4TH4@2d&H
zv;V@5Q<C$X@B8piMfAAeXL2X?<>d^gRs>OsQa7?>lr!LorWjvE10P0dwU(4HYj0<n
zZSB4XzQ@=2@rxPR8u<rB78(2iE`KD#-j5(yZ`5Xc%_@7wEm-9yBA<TtHg9Ba*N3pV
zjUNC)we*JF{nP&KXZfbqK0@)l!0DrPQ2V~DnBckbD$f%OjD2g#t*PA7F=TdCE)*``
z4hUw<wN#p4FbMaaTpJ&K)0vD~clxroG0Jn48|P@p<*f7cYHRK3dvNtYF+<PRG1<8M
z!vgBYJnlN)m%yWEgxt!f0q!fpW$pv3Dtl_9$814$<}p*`wo{UL&xJt8H&_q}V<%cQ
zLN)qg4onQ3Ck!l-Y2|SDlb>_LZue<IIE};hJdatttqQveXE!F@<YCg7duu$_q>N0C
z`S=#!=xp$Sw|$5spF$ua*e5I6Bl*FO+y~M_dDy$~HqT#x(Uez#a1sLty{O^n)^wYI
z^>u7>gDyegs6pd#X-pAm%AqR4nB?f<2ex5kRnb&7jLVX2a8&PR%Fd>%%7V!P&2bEk
z>Rs<lCLIkGP)3z73C&LIZ}P2#&w+cxVxA>QE`6h8W6;W*y?}vNA^(nHp>XmG^awt2
z*4XXl9<T$!bOU-*kia&TY^No5*mZL=_{1>uf|!za<^6L(l({|lJ%lSgAy?hGYA&iy
ze!}(M>$zvy&ho<TZsUxrX=}kCg@_BLKXnTN3)4@JiOgFEMS^QNt63LrxBt9JN`s*a
zFr06*_c+D$liSfSOUv!@(|r)dxp=!Bh8EQi8D(xYg+cY+9KSfD-Ri5>_#4t0<$UMK
z0TIK2lKDXwUHvkJyEn-ax!)yj=|#rj_|<2*KtyCfBJ5$M$gc>YlmPxb{`Ql1T1)u<
z6@YlCx&>!E{X#se<$uXS!?Z_n1IWQU)Up^Y4mlqjTHw6qd$9ZO;5>Qy9m7Atro7HX
z0`QEswiU4z!cO@h1sZbJeoYWn){_Oka3KE#qb?InqgU#=SE)l0lk33spaO>voy~cV
zA)&UFi(vMcJ3yGxP5ts~l)xn)rqa%&z>8aChN=$>->)0F{)-afP{ZX>_A3$*)mmwV
z%n$H?;gfx)^q_YD_Bai|FE%l5OpwzeXL{5oHqLU7ws@u3aP#Nr8e-WG9g9VGxU!On
zJ|i?YOXo6eae5~89=_K12=H$(Yrw1G18?ykklo~!JohbQ^w2d<VJ_mEaL7p~k`FOO
zV2$hG|1#@}lzX^#LpGF2zc-XgH}+N?aDUvF*ssmkK%U~?M}?0?pq$eW9rZS0y;wX7
z;BFVkn=;}0`Orcq4>ThQ#wZHQ|NK!~FK^wc1<fYSglDg<rd-_cJ!4#9{?gx9y@Q@P
zWy)C#(B!S-6p|}x(*Vm<w}PE4gIe>F&fiUkZsHCRht$)`GsAje6l>6D5=9KPrj&8-
zQyY+OS|UPTT55f5&*uealZEr-V^iVUm%47}Yg&mEi~#dsjT?EM_8Iy`ttL+zH<mUM
z{}zy6!^nC(3P*r3E5P3G5hvDLrRXAVMU&ky{;H%zSi{}W7M2fomm@_CtVIIr3=LL$
zQItXbr*e>TYSCz%C$ue%!_#y&iO~7<_~;qv0W%@1E`|!P>*TuE9?ljVMf{WEv0F}9
z^$8zbXYfo8!yX~RdNf4ZxQ;rQk++(!AwW@tMz2`h@4u2Pfr)YOLx|dP?FLax?4#js
z@4yAjU0geN|1kx@GbGNXxezd3u*}C8*lZZh8XfhUva6A-QI5q&M+1poJX)b1$)wDB
zmIN2)t-NBkz@$vHXGa%tLkCE9@IsGZ#OC@Nfy{CwI`)17*20`J2gxs~*pt3hVK)xR
zi@MlUdhT`NoDLoEH<y(}vrcUgKl{}y5h<l|P(=${={b^%L$0zN!S`!J(%RiVbJfro
z1>?Fus7OWp=GSGtmWwN{=!z=Jncln861^+?HR_t+Vio<0_1vN#5eBedI1l^=dOleN
z=R8#1em=0UW2$Fy7y|X+ZIW=i4a}xF^lNHQ`vk5&PT`18<KXiA*TEhm8oj5l#^OQ#
z^>ZVc*WH~V=WL6AhbwjhazVsQ`l|6Q6yk4tmRF5OZhAcW9(M>lq|)`Xr>r4FwPBPe
zy55FM5618{_2aW_342wM%Cm$rR8L$6QcNF}&DcJktVy>dZ;G3l2+l=6`35=(0ZTtB
z*F9D6441*-(!=xetYQOtfIcCos3k`)05<RCyhBriE`Us)FQvd2@h6l@2PMPqzoiO1
zuh3$5g@O-~z%Tz%J0)0Q+3w)QXy?y!+56TU;~Vn(2u%S1HA014%N@DF)z8tx&H1Y(
zKHmA{<B$+(E^(GhrVl$#Kw<lHE-1Zbk1sFnXry_cqWFPL@<hi_&~`s6m`R%(hlJt&
z|KqmLEZPx;-(7>^H$6}s6@+#*sceb#yD2ilobrz!UB%d&5r}BQ*hyzw+l;3YA5Gyc
z)n%rp80UQ??{I+-fx%Q)Ymsb)m;r$6hiq0V<zY7Q$_Y;Lm$3NC9g|<jO{43P!R?)L
zaULYZv>343*jb#^H7qd=-x|TQP`I*kFOm54#bb0tZ(`kf&i{T_lz6A8Ela%^BqZdK
zKecCiM8#*5^E=xoH9ZZNHzmp><B2ec+QPG~p4TZzzG=CaOos#Vc{p4|vNY?J>pC_}
zJWjQ~Q6)Mvi3Kl0b-eOo#5msGK^ZF|K`eEkr;7oP++s#rKyvvmEZ9gu=gZbg<hgKF
z9-LIPI{GiAUw4pvkZ;kAZL{Asj{Z!?k0EM4v1O*1leUPIe+ai-fcXQk5xb_HgYz`P
zV{5~l^q@uozrPrT1+jm)l=uIxV=VWZ-TD-j9qH{=gJdUu=O|ZiS@+{Sf=M-w!{(RJ
zu@2<QhV!3QVj5Lu;Ku_w<|dhMTA_c2G0H}NnY0>@yHp?J;;6Lz^j?&*U5h;h<v-Au
zD&+t;UmGsyFOl+IkzjnI*ncVPV5JG>t@(t3n$DMn4vgvdCb9e#U9ZphEeZBz+y+Mf
zYZ=+eGaj4;9{|F}-&7A7Xo-a;nYi9Pl%i1ohOo3m6SSUpbSc+Mru%BjE*A(DF*fEL
z0IJRiWg>$<jE6?LmX`zwc<*X``x!|h`$rzqIMq5wB}MMl!_)Ud(>{2-t5F7i$@W*~
zYQ8MsNq`DFg*8hI`^i~+K)$~6Bir*&nb79p6wJK$fD09hB6UR@gI}{He{%G!<|Q;?
zpzVW*`BD6MUza@JH!T>meUwg35GC@w66AL6>p^Jeu5f$t%uePafV+!vHb~|I!1eva
z*W0iX?02uC;0Ac}Gs)6n0pZX5gcb91?N;j;dUNzP>H>vP_6HfZi@YxSt~b5U^++^$
z_NA!h2ttl%KJ}v-E-82ozpNoDC|)6K%02@=Rat*hMyxkMVo6|zA!udZ)04R%KxpU>
z{^>?54y&e@+lVq4UYT|8y2MagXf37njgtgK+UZ6S%<)M1CuTp=1z(&MtXpZn)Da+-
z#6_QPW6JXeQZ}`&J;Ku3{um$+K77^kjAo!qlv}U)J=pM)Vlh<f2*I1$XhS<P=-uz-
z^E(dnJnF7Zpz@iA+~xp&YSE``N%sLYNa)J1ViPHL#o&dDLU%r#no%IpHG>qs>!?=S
zp#ZzE{%L;X{$t>^uG&8EN7%2{%Ss=^gu?wIdx-senB?@~Rmy(Z-USKpXVK}`tzRDk
zEX#*IQgr2a2o_$$6RtrW-8mYD;xIcrXBuBbF|S1K9|V<aZ7;}`aHkwqGeN;7D3YF2
zf~h-oK?<ENz{vI|HxrFa@;M$4Do2~+0@5A!bI?%VI1zynZ}$_+xl2^AuiH|agD&l2
zz$%CxLl`o7%OmDPc5UD?FTfG%&RFxBvfS~r$+6$oI6cW9`7K{rIDM~dD!O-Fj=(iy
zp8Tppj)R79Dg~28G5X2lfOOL8rZX-i958o@;E>hWBgFE_G^DxPMebuvJ<EMZU2Kh$
zlt+i@*<@L!<^?fz>jDd_8OD)!mN_~*dcS#THV$7h>Wb1)+Kzm{kzAZs=%fRluDm-y
z6&jPaP99Z*mUk>H{}~97Zw6&|jCK8Y$f3fLxjV@G;OHlcKCpUh)fp0LG%WP*cAoXl
zmLHoeQ$WQ#(co>Xwm>aw;f*0P6m<OZvyjnVpLD5CCl%ymFq0_ew19P3jIL>rA7aY(
zCP3qKUO)&?*|w2V3gyWxT?HYTinDN392Uyuq$4K-KTo{;G-^QTU*8ie4%$?jnl98%
z5ZbTN&9#(!TEk92MhJwOWg#aPc|UF>u1c24Ot2_@YqSqBGvAo@edKqSOp=@f=I9?T
zWNr0f*dshtN`kjKhYO)@Bw8n+rBDUE%0wqQ!_eWZP+lQj^qIs>=Dm+(D5^|D30uY>
zL-ws%aFE>nxMUQCrJL1jk!R-s!)2Ao?y+$v!eb}YU+=!V>pUd=+WJJi2%*F46JcZ^
ztB>jOps=DC7j9&Mq$u80U#biQIk)J_Xf`#Rj(2SQBu^3WV((hpKd<}KhRAf(3q=|T
z`f=_b`MUWGC8^SyB%=2Qn>$)2A3=nS$h-67qy2L_{O|gV9*!tl6}@9}7JMH7$G$BQ
ztW@@kg|?|k-<%I8_#nV&QnBJ-2O6sTP0Et#S#cZzL$1lOR8LkOdp3?g-IzO~^fQY1
z5tCP#^{YzDt~hS(;Rg?wBu1{OTq(X#j0FJU;uq4{W3m|NJ#>QMg5n(;Epo?geic+@
zVPHc39US_d>L07tiIQ`CPk{pbkwKvh`=#%;=rfkv+OKOr3a{ev8)k=<oxKD7{HJSU
zIo-M${7)83OBuc^<q0tt0>3KBc+W;X!l7T5#vk?124g3HenHjwc@2>(dPMe_$%&_v
zhEV&*^rt69Z$_^{p)xO|_wG_e7Ik{%I7ghI`VnFY=*PXK#(=-U`dnL%BCY?_y_Unc
zRmo_pgsn2NCCdmL+JT2Ep8~=GN$n3YA0zvXQ?wk24Lawcg9?nrO^O!hn(jMv)5vt#
zZaCh#)CxzSZd9`PO(i8dcrN`tMmoDYy#+dA>?E_p-WY1|=jA2SqyO1J1#@#*yj)hV
z?2wymGR1#rFiP#Lw=gK-_seZ4Q~PujuKhtVbrS638ra46f*`F-gFBONz+1x&YIl=P
z<zy$sABVILKVMyRUdYNdW#p?z2`=Aj3^jJR^M0Irc*A$Vh44iZ3n>&Wha0dBdt~i5
zU2{^(z7jrA&A>02ni6XLU?NbI-`FDmrV5gm!v^1M%y2i*CHm|1W&-@YB=qyV{3DDx
z+v*Dvlbg=(o|#+>`bozwQLgc%#RD;V&#Uz$Zj$XxpR7qV8)qcOBxxx>`phf7GyJJi
zSqHpI+A$O9(?#0hoYpQY*N`F4=&wub2<&avbgH=^L4O%ZR6YN?&K(_T8GIDJqE4O$
zB*SVnTuel(gSeF9JOT{~y&hjZ2Ky!*<GW^@*NS|QGDpS9)SV2QxSfhoK8z2S9#V|y
zo5iH0h69qAiUNx`wPKGAf~TB>5U}Q~e83#C_yMdDb1bB^(@f#D{PuZQjkli;-40!n
zl*~{$Y<c(`S$ehsi>-eR8>mv_?1J**Fp-$g0?$VVeTMNy+~^GyjZVuL+t;|^6@vq7
zaZGCM@ZD`HDA?Qx@#Uk*iwI342?3p@r_yQ1$s(x`x9RBThq|Fby3y~2DW$-$_x>J-
zZ%c^%iWx5+?m`D!FM$_}hUa#C)OI7W4RPRuk}Nq{OvHoc+Ac$}?H>cKHZM~J&(Rul
zu>7v9#I<+z=+wFZfn7^YjS2@|F*(=2Vp*czg8YY9jJX>kX#6;YBSnaFDU(<#9KX7+
zbL7tBXe!WOCm*}9u*9z+DPab;pZIWK$!)g-5exl6Nq&UxGLC8uE-PgSlh?IKj^a&I
z<rd&lxN~m4BW8YS#3ofHj&&sr{#Wfjpx{?@jSZ7x76S1v+J^_Ju2&Abr-rsW{bU`@
zTA=j|57LYMve-q~>_^Cd8feo;Sk7hBI2TvNZ(<~O(r1atYNnQDQ;3gSb1|mnqF?=7
zlc|%zk~gwMUR!Ec>sGg4MVLt(i|G&$*4*eV1CH^h8~?c+whUZfV*;P*i~;;*lMa?%
zYW)>#0(rZAWs)ap)6<7`q&#*MOuB(_KrvzOs;mr{OZGE6xGL=FUg<^ga^I4ro}lNZ
z#fDp-2f$NeEYNmegsTSRE*Wv9>Z60~OfvCNAqz!Hxe8)B^iV2@(l6uCx9b(uPsrlE
zlAmN#!Lv28usUHoqJwr1HASjMwnPRGA6+FEwzh~9Rj--!89`0O3s~0IV})GGMD2JT
z{(RW<kBjSy-geU@|L{U<J1Qnb@m(?2JM+;4ArzE~I>|Zd*|XuL52K-jXm6_hT>5wH
zNRGH}9Q60X00mQ4T_W{cysOy0n?LE>DPf@;!;ptkqi;0}x!Th`V^PrL_rW&*XJjsr
z`iz{gguYX=?1j2qHuLO-@wlxT7h=EXb5Y_OwhQDgwxw&b&m7M!z%xLJOI;6Fpn$jj
z!wczn4}D;P$&B0uK+E+H@zuMR5y24PQD@YCto<b7%IG**%9ol_={g_O;0O){u=AWT
zb_}94EFI=?{SMn!Xmbnj%NEI_^_#m%&+JS-N#o4<XPKrIk~ZkwJo?Ng1;;5iJ0J-O
z&uZrp)N(pMqH*BB)w@qjep2Nx>&@!d@%JBZ`DBkU5DAJnE&d7(NE0}>ua;jfe8!M}
zV!PG*pc>ri_}IpaKu3-~{I1b*xUd=P{W`T<Z;19UnbYxuBQ5RxPhr7Z0q$UfI9Yk1
zWQNGdfTyqr6`f9^YlXEBW!S4*>nj%Kz7{>(@Tw>f(OKI*VJGxAt}G?)esZaYYR3TI
z{%Z0UOVf+hK}d)NWtdbzy&6rz>hr7qx~Dk;k+sT-CNH6Ozv5iS)O%hHd;hbK>rR2F
zMdjGB6yFZ0z#e~U!W_>DUVX)bqpi-LF!DdNWQpD%q|m&|sVOhW>V);H-`$Qer}>`w
zx~3LmI`3-r*q62ZWCa$|yjB*cnw&UI-Uee<f*$9;80LTRv<gy2V3VtMcOEd0oib{1
zl}p~0=ftsp>*7NA$yrqRH1V6S#R#>_Sge;v$9h~&G_f_!+xiKl-HhSiLnjQq70gkM
zu+yujf+G2Z0Mv}=Z83ZV@L)TL*%8au0|w`98=*930-|P41CsXu>03!ZA3S^OgmXYQ
zJv!|%XR4_c88?1(&OTtpW9g$9vHV!Bll18XwCz&16UI!KqV8kyMje5z-t{9M@__Ie
zG`86nWxRlAaLEUs7@bnI87#W&q-AZtCfbE2*QR8IQxsp*Rs~M8Tq>NOcQYs9=eA!j
zxo*N)I&?jP7<(64zM=e7hWm&RR~109kdLOI7aJ}+*qN^R3s3fH!t+8dBY?2$mGsh|
z@^DJ446#6j+Y-KNFQ5$3_n2?-OTWs-vSd4`UcT{fSz`znn;HY;?K%+d8iqXr%+|NB
z0u1(UVV-|8w3Z%fWFwbT&_m0=>Mk|DkB}U_m#2Jfqf5Mb4m<$ZOPoXnH1cwVhmDP5
zxrT+bZ9iuXBBhn@ovKrCMFqv&_83?bQc`J1y??e(A?*CxUHx(-;8&Tf<Fc&a@a1Ak
z^Mriy=L0OuoZ%}xCe!=w%VC@M*Vz5t^U;*YUPrt#>w@uJduvyXi`V8~_i+Flgph?f
zDwuU+&ooRemF~M(TbqNlXH9;vN{?fK^9%iz)h_L&#M6KdHQ8e69wT4rg>?C7<Kslu
zw{aqA1MYGvR8;xhc~exsB|sof9Mp`<so}pk<H5rZ{>7fD)KZ1@Q`dMB%#}oIEWN8r
zQE{ApK#q-U=jQ2JKs>P6MbTlc>9*bA4Z`H21?{91G0aCW0gHMXaZND&-4C7ENjqj_
z|9gnbMRj3(TSnwH9e^#gm`l1t*y{o8R3DhVFcnx$`gI8N;$1~49R`&F5Oxn~!vfMf
z-mj$GE03L<Kd-P<ou{A-W2oi}0(LLR*sV!Q_-E;v8WO@{EuTy(uagBWcMe!DRk#U2
z&jI;dQ<T^Af)uHYi)~ByEK(D1<;5s$oEf1u$z+Td>v2$s2f@n^dDeb|DLgazC#L}y
z1ya54<ZC%+ZxSuHb4Mg0(nhhqk3iqPh@VnS3;)1FO?JbJMc)sKeG31pPI)z3==tXE
z+1|M>rOq2mqSlFyfnGh3><@Z)LObBF3q0CRGE%cr;bcy~SDx~1h5qcHdcpyApgL6a
zMn!lE`7kO_HaIS-4JPSV!+_lPt$ZqsBy=<NfkM%vR-OMFnk&h#UVgq!tB94G%zia3
zdn@B1!CV@m`u$;Y9i0O)=l&elr;YT@<qxo$KrsFW&@SV~zRG&N85#t-A7bdpCSNI(
zfU)g8919r+K$p@RYQQXQKd}B!=w`lsmmpdP<wO{vkLK0JvR8_Rl$S_4GBt2%pKm)6
zv}@5QMZ<6xP$60~u~ry)#&hQ$DOL_CaJrQn${=8Y&N-I7?cI-rdrGs8D4E(zO(=Ze
z$&3J?TT0twtwMKc{&dI%{SvWifcB7s)Q0z_AC=>k7Bt=)EypxAyS+<GqFu47Yvtik
zOYs24QT`Qk!tbgZ%R5GL;00a|OBnoE1=S|6hK1uipKKZ*CazQeydgmUiq)znx$t_T
zb4M?bi3Hv9Ea-S-BL&M#s^n#Ia&faU^7A;BuQ)5D)l}zltS`=25ZMy@Ld|aEx=Cli
z8TeHu!|0m%3wKqU@8(;n@Sf4Pm`68yNRgCZqWV`^N3mpY94P}{sQK11Qz?1*BK;<T
zC?;UL!(d0(=ZPBoso82uhfCCAudu)@6l?D|IQ<hsyLR`VRR?r<nBnttAsp>8qry1#
zTdEM>7y$v57?m$AE&U7o5#%x6SgP|#5_Zg#Ll^U{8@3FeU8k$@m&=A+;^8p|H_6E#
z%!|Mn6)^eVDsze_Hp~z3@M-4FZKJ5_jDf=lQO14?@><e|jQa5FXU?#u=$*Dhg6pjw
zQ;K|2C@`*b&@-b^iM8tyA<0-Y3KMcn*t+an;-DBU$Pkcpb!8*e2I)9{zcB$%@GSU>
zu@n9r-bQT*+n^D%$F;RSqwK6q=rKgkUZTOy#W2l5Ul6Q(he{f36=cwP)_r<{XN`~$
zQiAT$_Rl`;?!J6Qc9f0xg9jyR#;$=FGOD=y<&c~#nG<r{j;4Zf9mbe4+7JgdDG@PU
z&Z!D`YCM&!t60NT*!tZ4^?1WMs6v!6zn$xIf?gRSlcoh$Lf8X$unGAcjeF|(Bn=FR
z0x8wn)b*jxkhr+?FKjL&(&D1XW>!bLuSizzz?V~0jBF*vNb#y+8}uHV4s?9!W^jC1
z>`=%felwtH=h|9}a6EwKmn+TooG@wdKu{hR9O{%@^rn8?lDtk*_&5FEcRC?wu{Pg$
znb<9XZGOYO;;D92W)Dc}U3MdmpRWp!Xmz*u#c_&ddyy;DlwV1IaOv~QU36ye<6}2x
zm&zQ++hW)Ho;`JEb5{7uS{y-wfL3-9mUhka#!T!~3OBQ_JBhSJjUGcg%u4>EmMzc1
z8nGO1fDqi%dA;7zjF*H&yV7O^Bra{U<HyPLOAt0yZUWZ09i$se*b1dcrM${=o12N&
z!R;kJe0l?URl`}%{u26r5$jqTB%hEA2!F)rgq8*waMYMdv{4R7xYLpVGSqn~fKT2V
z2dYR|ZPIPRL-Geyx8Kb4`)1{a=+3v9k}{r2GZX2*Um+W$fO|aI$RxS*O%ozm%O-}8
zvJN-msJ{FCx-d$`&}ik3M{FK((z}phAH=EQFUP_@ZPy=^dn07|?0=k#bkL*|ZVXfc
z0iWxV+tmH?I_bOGhWE*HG;On!ir-xAx`;*kuc@^2TWIwb<FW?H7q@;5G?k@o3x2r0
zz2^uf8FWZKCKpxFAS?oj!f`LB7>Joh<uNM2*ka$&EV5)2+x;$#^3uJvGdUoXNXJxU
zhsyT-7mnbcBa+6beqGQUbhXD+Rv3V`-1v<io%k>dAK#pHbq9}=9beHGQ9AUXBG>EW
zEr(6gUvwfW<Lx_`Ap>8;Y<=|vE=)(!30A77bch}SM5gWA7KH8O{@+X;6hu&P#ZklV
z+U3+<vFjt*3*kJk-n*U_-E718fM7xFBgJ5o`LHit1g{+!kAsBTekQ{A6`#6=zj~g%
zAomd*5HV@AF2Nxt{CoFz|EE{a+v_lI-d=4{?Q2r9f5~KK=NZ8(Of#94{_zr<>=cG0
zh1%)@e&(GHcsSDCe$57c7ZbzB?F3q_(!SE91nsF??Ivx;mNJg;6x&J14yyBt4~_os
ztkr0r_q}Vg|M!KEjLkN!09r3iCi_eX(;!IYpY50<>wwT!DVzPN(lohU8^#delk}wj
z`4tx6u-xjOH=qg!m+4o7g!3F@-oxOZBV+ziwqb6sQvihePmF=}Hdv;(6r{wO%geu&
z09&MXtQidFBcx(Kg(LmZo1tATHX2iFuYw_CTesP3eHn`=v<wrXP-Ck9r*<CxhD5xq
z>fynnJClDBP85olTg7B$`AIVa{yU>p0tvB?>Z_YYy=j5HEE1y|(T5q`$KgHq8+d^P
zZyffm=L&>?h-B)8&?b*!o8KfkBVW@ocWOUuvCck}=v5*3y=tz)^Kj~O;Hz~P;`E~}
zqS-&=G)I@NEw>UMggdd5G1-3}Y8~o{!%@PHBUvBUB?UXNs~Fn=0GEv>fO*5}#%eeX
zJI;)NWfOONo*k#b-9*Cw-uZK%{dr|}XvhTMDvoc490sS*{9yC$-w&dZaY5#{m~#s%
zzYitBxC5*5e3$ewn|BzL1Udbwd*#AkiYw>yA6&6wVu>%TS$Qf3e1dla;@gDMWmz62
zs(3cTFkE>YYCl9-3{{+_6N~WjBU$4BpIQ)YN;gwLMmP;PAmdQUHDHI+rx_gb{<0_o
zqu+=nP9gvl>p>jOSA05Xc6xP=)%L4Vsof4<9oR4~f)tJgSwjhzkzK~Ed4*2CkEjLf
zDhT)(_Gmcq0{%C4kUYvL`;5NY0H3in1(rvi%B`&RZ&{J4uxrL;y%(cjUj<56UxRg^
zAfRceL9ba&>I%Wqu=<E|PzttrMNfL*$<J@>XtMOdE8|*#;m@IO^D&>y_AOgC+{0_k
zg{7&%h*_~>#?H=g>N40cOz4pR`2Ny$wcen&F~dx~w@{0jnaDweod4IGPi_{c-mhwi
zn~~3i0^%QWDBkUq=2Cr2ZL6HOHN2&aP9jbni^eg=MN5PLS|rw&66$I3nv+*^57+H&
z>|x_AfmbM^lk<M(qO@soK++Gj8;ZgwU3n_ZyCe>?qBiR+_uqcPL?VVQ7O7-4f+tqE
zmNN!bYd+ju9JQrk{xFFGRDU$mkv4v~bQ!ebu_a8gM4si$O1Nu??0OxnJ%d@o5^CQ6
z)qqm!Bx5L1d}c{i7_K>KXP3XG^X}c9=1Um-0-;sjv$$hwR-%8YBK%}#l9lpDZTu&9
zR4&Wze#GBnM|$HNE#k+l-{ox{LBQ4mUw<|tu;$>(x{E8T4<sM6Xu<NbI}rN}&M8@V
z7DIreY#C|6s;CbR$|@S>BY(`iQ1ZO#EX_r<>wb5Rd*3zTOJA)oK<h!)oL;H3pSa4Z
z77wYdl$ZC^Taj07H7C<GIe}m7g|(<qw;z-;PdmJev+r;cpO|DA4{xGgan{}SH1$7V
z*&e5%DgARbGHL?(;&!hG1uQP*HSq}EbMR>>cF|}kKb-C0|5e6z$^{hLjfyzS^hN(p
z1muP2K7;-ESr1xNxo8||B*x1mt(L-O=$Ac{Z)0!mdk;t_f_o7nHJfg+_{4Lj%slU-
zFg8qT_1MqtdO40KaCQXnY)H<-CWwGDBvcg@wBG1}<mh`#b3CKofkvl5&`J<Uw{(d0
zUUyf>F4sVn4qWcf-Kne<s;Si1z(4GM#7bRie}HY1S>q%Sk@bZzN#*G18cdMz$O?O(
zdQX^Hp<qCqO-h7F1N8{|i?T71>M(jv`55|*q<?=1+~+&)tr+z6pHtD1sMIdSGLmhz
zQucTkt#w`wN%UzdxbXfN&rYZid3xtHGyBGdq4&%R8yhcCDfK=Hl>0j}^bK>666*eF
zUSpm&lF;r#C(&ZiLviXxgqxPS!y7u_+np=HblxMr15hZ^U5AIyh1ae#(<Kn}Y5Xr>
z93A(=I3CTJ5=Y%I)CoFIw?DtQo3dE2DtjE}p0#}}*dlM_@V8PG%+FpAlR)ydC))=^
z97_e+;@49X`WVu<&||LTn?LPdm|Y@`jpDEd7f~~8sbA{CIN9!)C*8^iecfHlY#%Sz
z5iQJbx>x#3nJuZvh;}sQx61;GDus6I3uJ-u9KbXF!I87d{`ne(>r2*>_r^lBGF+$M
zs$v@d3ZHs#mRaQ((xEan1ye7!J4;fupUH=^#k~zsB}62*Q1h|Y0lTF}H{WRu(iG2$
zirxv|c(-#q(5)BNk7N_1_By_%?2>2}5J7Pofw=mv3UT>NX*SVvT@c1r3n&hiixwCE
zST8d@I&>ipB_MoDr)}b$Tq1}bW8O{DQ#q%tYJdtetU`mo1pyBK?$J(q9R%R(b&`J_
zM#q&!4aTKpBd&7cyZ*OeLaBAsW5%hHIFS$O(Se*+jgMImg(gF4=nhne^Vpv<vsHY5
z&&geDG`Px+P;K?Cs0sae7OYI6le}^x#5?_kIFVs)VZ8GRhIL(m&m+8_;sBn7#izo_
z#rIacaO<Ym<^<%OEX#OgP~TBCKb25M)-bcdIN8GPRR2=tO@WrC5wRa|VV}_JJ?eL^
zHKl^&(MGVBdCi^)$O=i@5_I|knc<=<UQxHDgA2t<Ru}GOx1t+-w`GrfNZRB%g5kK6
zsAkQ#0V9^I?y863_|Cd2RKrrcOzDb;>>n}3MDUg7jlv<z_=l2)0Ufq3q3MaXYSjGj
zC%L#RlGn73|BtBij%M?J|9@grD@N@-($?O4mD;OC?NPh6sl8&y3{_jvL0i;Tw6@f!
z-BPp&u}4WLf=GUOf4+bG{>izs&dJHSll%3$uIu@Dyq$a<R9t5&Ow$!I!~!iNOvAb@
zd6#f2!*8Jm+fZ+(svG<X!zCMSemO>-Zw)eA{Q5K~9=Fd{k1q<uMwFRA2R{{w7iC}=
zIx-hDCm6cRb^HvxdYH)vm8Sg>lj{mXJDn!|%*Q8BsQ=H}&MkmS*5&ur8!yP<fo^bT
z>bt==R|%-~=Gj1vlP3b?s`@YmGp_qRyv}~Ot52852@f$J<E!GKPA{gv0)j9ZD{L`O
zYRQk0q>*k?nG)%#K}4QguBmCN&jfA}ToV2f4=&h~73aisB4AKThj@AW3bBJSRofV|
z$yr)9G;z1T(x(@x%Y9dyYh1@3Sg%CKmRR2O4C$HxlF6~Z=fF?DZ^Y+r96z1*@tk)G
zZUp;h!EI9D5oz#<903Z|@rEv?mwgnjs`s%bTUD{b_jIB>4DjjDvZQ&NYz&Qt<(HO0
zejNvH!iRIQ*-l%nvq?1Kph5~yzx6yGvv5Z8&$MUz4Uu2hhwJJKz)fAno@&6g6%|wX
zJ=^0mMjG5Q<FN~}<QLbS=d>Y6nj)Oa$SKeCMljA)g|h5YHaO1rQ9LqB{DCJOV@eZT
zkLQbxSRH|-P|<FXmGbWZQ<Pr)xEYE`P$!I}v&2}#?lqJ?S%51Aq8q7@ykEbpki(&q
zMQ_>A4hzdo?i0TRg*c1+KTk?^Ij4&)I9QibdDjN&FRl%$P8s2^upXAPmTPv;{XgIK
zb}X3)+k~yQUMu3`&*QUl7W?$k@)Ocldkm3h)C)mx!^g*}l&X*O!JAubLTbO+y-zNL
zA{84nOuvRs@)x_7G&oF*cqjS4${9IV;aJ7Dv?wsg#E?4*TM4TQ)C-(iZ2So1@O&P?
zb;t6$8KhQdCoZLuO@gO&&{^7yjL7P_?9>KPAPtfY*^SZSfUOI1s{1_cSWf*Ef~L8=
zz2zx7Iw(&v?S4LMuY}wde<T7bs_-!$Q_|APnLp;IR2(C)edeI>SAxotuyKT)M1k3j
zVxK@fH}kKqrvJ_;P~SP+H;5$&*>C0@f8ZZOcsf2Ur47fr+&(rq2TcEQr+In=depFb
z2(&}IYp{Abx5QBI>=nBOOF!!UaMz&n)Z?Ets&F)#bMHxsqPV|?;=3Tq?ZT8A-lNC#
z7u7dMrrzJ=D9gK>u8f~q@MJ8qQuDh8S((I1yF=bQW!d&F)outy_^!UfeO*8Fup~nK
zJpm}6;Ci=szIV_CFn(7IN_wLL4He<sKjiMJ*<-uy@1LqvtPP?J%vxnx-hfm<j0&X2
z_Kt)l`k9`Wy<OBz*_2+#FJtxd1A#@pMcLwH#c`Oue06v_3zo>U*KB_T!oMMu&<_fF
zF;fGe@SQrEm^k_{jmH53EnL`1*iw>%gJO!mG-ft{jU&=AcMd1DU7vMaK)VgP0y{+*
zd{^CdkhMU*38a}ZB^P*TBf4XV*pWE-NVY;+O!2!9D2h1RankR~sg8W$YGCZW7Da|d
z>2kOG{P^nblfJZfbHGmlngr?1UC8shb@6gH2jm0S@dQQ~+2f@bLmFZkW<eTd;O1<~
zE>^eZo1Bq#fwCaB)ts|Qp7)NymKI(`^iGN;3tZGp{bg4jqqnRZu5P!#^y;otJEX((
zL>GmBEQO-kg1Gq(^EoC|Kt&AT;Pg&9_n)Ab{l3WfOv_@lfaLC=k)hi`p4QOqrwM;r
z91aJ3!x3Jc`UcSzYN!Zxqj}lu=?OW%l|xlVq!BrLR?syw{kYgVD*+B#tohr8QzuxM
zUc{Ifs%qd8M4m4CA=TDHM|zxOx<<Z6fjF|xJ}myFvEid%mz4@m)A)!fUzP%mL(W^v
z#q5;=G<PJ?WGWtI59FyrK-5_YVScdZ`h?lwzdj;o&OfCV?2{w~s|&dqg2&?o^+y$x
zsFqxU2(O2x>gs3<@CK1Fw+xhfPpEILEAWm9)Wq!Q4vjjr42_E01~6S_GPAr={Ve+K
zOZ%<Z;1!d}TXXmqAkd&ns!kSa!x{p0f-yDrGgg<)wA5<#>xzx#a@R0(rH9ZwoqEg?
zw?9ekjr8BJj4x1g;$X`;z@Jwzamg`{h4m2Leq8x;C$JO9`kt<i@5-5?NlLiOOH~e_
zQx^${!326s-{p45g<0Sy<gQ27>f4v+L~`c;rE_HT;p=K6^Tn6?#;McU`iVAYON7^+
zBf7aCUc#|!4?Dz$K3xxuOBuQ8=nCGKWv|$ps2>K;;lL(iudxTeqU+z^TuaH{s_T{>
zT)6k+v1ccK%RaJ<VqG|JG_Raoqe}zGS^kw1+|!KxZj*(g?TXVh5PcUXej#hhGs{s*
zHfBiW|G@?LGl_-rP-5US@?RLu?0O!5gxbChkn-Sna0E9U`?J>-^M8JX$NKbt*nOU4
zYW-dJ;O?NxnWCqNUG1j}_Vf2M-%#b#{qNR0n}=lLHj1w$*sSE%1>zU=N;@kdBK}0*
z1UZ~gHJ`(yhH&!lmUh<#l-7hS`09lE9q+_6ec-92?~`1^JsMKccOJQQMu#mSlc~vE
z5SA_(V9b}MVyDF8>t~Rvd;};Yd>X#D+&2cj{NyH1NjTZR>HSo`dOA0?L-Qq6`XwQH
zD65{o?dmC#o(MCzOv-%W`9DZcmvBTnSbz;JyOLhGdXS<@q}&6>IW&LVW=Ee9>1|#U
zCV_|>zW+0;xbE0Oz1PlACL7LGe>C$!;~w#XG!`qF$TEmA{PC&XZu{d$q~~9n51lYj
ziWKpsRx|B(iOMOf)(BXTMA>7*D6TxQrj-njrtg0|tku=PNliVcsI4u5reCL_PD+-Q
zK5?tM<0Wo!A(j&raB``bH4-EzcO%1e!`5Pv+4m>IgHfTc5f7>{GxRj}h(3MIH&p<g
z$;3wl4{x(w??W$!8TAl<;xU;+TQYKUu9aB7S7#$PF<cd%6U4#w7fj&zLp&NcNTG?<
z29+NN6az?fwLKsl4A)V{?=FtRFFaQE&g_f{J-(^0H>6BLZk70Gq_(;Mv}{C1R1cc$
zRTMtLUgWTtXky?4kMU)CoIz^>ELzwKS4Bnt@N|VYsaT#0gD+bvtc2AJhw-4XoS&$i
z@Jks9ZcPOw3!LQBpYLz=A{Db%5fbZ^%|Hs}%@T_Hx6BuIa@&f3S}3S?>p?sBUDZ49
zt9!ALYtX{aFmnr=i~W;v5!(Gl!M|};=?O8)od)BjyAg(<?S><@;H&M)!x$Z}l*pR(
z<aA~@UD14llSDu9Zyz8vCZYh&a(FvwL9<g#Pi)nhWwH{h)0rcvvzUo&Pn;;0WUBpe
z=93zljvD4e^FT2rFZD=-y{B4#I_SKHRI=WVR*%se8ED+uQK#1oTDu<`96-yj$WG7~
zm+ZKPsfU4G`+B%`DDgK73!;+mOWSxD(IuRPimr$X8G|xb|1uifr6S)S<%@MX5;~4h
z)Ps)X3t9RZg3CzF?h(6<$Q!PTpFD-k<sov6r=G}2S`Mz7AXeyyEHB}gO82On`RLOC
z_qJK(gr2NPj(!4SHfa$qPS$Ky_dTc-0emVdIXfs4C_a3YT99CdXD;F!1yI~NfcP|z
z@^8oRRp5y@lIHHc8ToiT;}Ssr?lbASQ7I<`0O{_c)dXldJKzT+hyX+Y*NxH;&7bW1
zJYM$^BrK&wUky)3&nMNl5&fV4`S8*tF&qRkhh+du%O}_DYf=knlkbp3=KqfvgW4df
zKkEne#6n6`7JCU;7`&nv2Rvwbg<xcCe(ANfJw~FD-fO&M;7Vlg{h}(9v)kBZd}A#8
zk()#FRj5}CE*yi67+L@8mHJL-kOJq=)3mL!5IutscCP0;^*EP!zCVqrr)ewMFn})P
z4<gkWTIEoW6olSq6TJ&SS6GgvnJ{_QJ^|i=y9O5q`1D?5!72qAb@-g!)<x*Yh^XSj
z^_OLF*Pre{VbD}Q`ceM$3K#7Uwsr|3D!{|Qb<Oj4Sbh+NW{DW<V8BGtc#=o7i$=?J
zdKn&<^gC){+4RfEoAawboSf=kByaM2WU7udkH&0t1fD1WZUK|1KC&HH1izc8xJIl2
zf;CP6`cwf9fL6(8PxvGx0kmcTyp+U6ztV(!i1Ob&OQgHjtrsDW&u;9-CvXdDj@FYA
zpFV6_Q|vb9!`~s^)1)A32&{gy@_XP>7LaaBYK;jW#!CX=rEs5MhX8pg;xya~y>j!c
zIL&vcx%GdSq7t>@+*Q3JHE&5i$*^;|MHR`JRv;O*36<BNzMvLGP_EI_JOnZ6Xog}{
zU7Ak%G+YfCJ*DZ>@OWw@(Zj5WzuOOF7vSl=!7<$?t6Vios`O7qYif9sHwMUFb%tD=
z%#%?3(D-&{lz(e^{LkeVX}8V45(L_VmQr=_$z&xw?4@fdZ8}mNJvTTT`H7)2V?FB0
z;xzUFnjwA|P8N>&Bt%gy45SM^*q2hZhUSk4l#NKzLq|fwgDTUZ5F_tJ11vJB`MbL_
z-SdI)#inF~?P_l?K9zPQ)FTj81ZyQ^=gKX_xy%iIo4)nsC&{CGtl>|e^+((xwiW2(
zIg;YnLD4+?{-YKT%g_^@QFp^5B@N;Bck224c^rIv@Bj!jiH|+zwkfw3-pe%+LYvF#
zXM%rP(hXrIVO{TuU)R86`=FG1)?3re&}=x#=h6+&V1G(Q!^M;Wv9v+f5raIQt?J$v
zMS_!eyBCDzMh;)Yi+k6J&l<^rgM@T!<qH7`3b??`SxLjTyi_sh$fyMN{wNiVM~9kI
zs_dyACJ@8p`czhVKQFL=5`i!yKCEY39J6`G_;9TJ0rs%~^o7x_@EfEYctA=z*j57m
zOdxW*(4SHg3!v}u`Pp?bypALOE{QPYL`-b_5c$oq+7f%?IL^iqqS3fM4aSks^>csY
zR(q>c1jBl!vgK9R+;T#>kEpc4?GpKCdcV^iab(-Dorf<G>lxn<2wq`f_SWR+77DBW
zNCZZb#L>5&26d)vs$tSBNOm9(_fg~{7W;ZzqYROt<=t?7y51tolOf%Un98#xR>|yC
zay*qa?W!KWIe9eT$LH=A%I>iQ;wtT>-iE6YmfFdv-YsHO5KE{k22yBidFjmH>#ypE
z%=U=rlD`{rB|WXG^A*;(uKv?u90ncSaX4Us<`<fA$#`*0R%N8JWW#M_iIVvDwP5;A
zUB^cyTcL9NVd;Mm{UQ7Nw?g<3_ueXZWydF0)>AnUH&H47p+38tcCiFl@TX=__Hrq$
zTe<(G_Q^gfB1VV9XU@wOYn-x;52nrkl~dBbE{^IH_{xcP=L2Oy5hNIofZKx)iLPUR
zwrgPO$HaziHdRc_S0X0o0F490Zzz0G8((Z2^?l(phKgG%F^Xc<-fA?(7uPTC4cJ4o
zo1EitDuXfQ>@6bs3G3WmPh_3IMckcZX#~PK7bvm9ZpIMJ{O#1-^wgo;+Q4fXer6vJ
zlDC!rC-NU7WiXO57uRw`{g#dV`_l#uN~H)@S{|L$JPARuA)EVe6h<PR3KQRz!qxW&
zjh*5t^>flRR1qvm$;MRhsl>eC5ve|jvf_y0Zc~p<hu|L66Bc@3oI+5<ZWi+ix+EIT
z!jW6!1r^qhvkQlAe<60_)z=#rCz~qtH+u&gEPRlL$|q{pHONTx>Lm{^t(ux4YC{le
zN~H~4Wh0&Hwk(>Cwtw>3*GeUYI|+kURN1sBvkjLu3H^1y-rYxQ_*0jXt+h9NM5uCM
zS5#y+xz?#pcmB?0tC2#~><!%YjpWh=B~pY@oF7eu4U=O8YoA1%U>1padks08^2PA%
zx<4@+RYOlrXKgL-O({+e56|iwN(#DAwyu!fG+@p{|LS4eI70c>@HuJWUy@Wz(iS<G
z73dw$u|>y4=WNqXjO%1n`Z^cDD=jXf@&TuvGHP@f3$w@$MNk`T3w0vIsW7?z^6@ld
z7L*d<_EryjjINND)hyeMPeGR!sq602{2>B!1dypc$3QEd(q$K~wH;H0L=w2Y_k+sH
zSv05BdG!j}UW4Vmd4FZ4t|bZbQht@KTG_7!Sm5TP*GN^KK0aebG~v(WdE63+0}0t`
zR&7lDu%>bRbB^9G;?$(Uhg9N6{HQ4sjh}zX+s_w<aTVeH4^Nyzk{b%W%Ad6fsKs&U
zV*d<eHLk6k%N2A|uH@YiPU0>Pn{8MYJ}r=t{-L-ANZ31v>1DheIz0qeODZn~1WE@r
zMcsSsbIATdO_k3^cE*wg%eO{<t*`RUYvHP-A(lNlskCFKfl`Qq7?uEN^Z);R@&C9y
z8laf))RpMjtC{<u1Uq4bQ$m{}58DHxYE1F{8=h@@&r^&2C^&p9>0oeqK@aJX)uz2p
zk-*;xj4N}zSWJ9c<=a+Hj-P(?vICPqz~rbI5$EsuJ_-5<7`blv@v{15wdj3|wr}?0
zhiG~IFQz<fk~c<drsn%<Uvu(A4lxpV0**&<vbQfrZzUqSl)Ob3RQxg9!q<L7Y0;EB
zmmy$dUQ#h8`9=Q;gApBo=zjH&p?*Ns$LF7U^(*MyAuPvxkpG@ZFSP{#1SML+IHNm%
z7i092Ny;Gn*YCNhC-LB&CddmcFVs+{jPPi=4xekBBqT4cId`a$iYwIB>1md4Y6tR~
zLU_Vw>ODQfmYdGKw6`pRZU|ukXm?Y%U=Ty(6Dao8AM_0W6px}+qX{V3O-*IR9Fphk
zWDhtL?IS4wWPRFIh=qU(ddM%96znVyZxCGO<RVdkbAaySCGwrci$}$5=Q2M^921gu
zwhN@#33k>U{N|hXGIqe!%FID{A*e~7PEVLI#F{itnuz8ickYl$(}pZUtUu+$#pRQ5
z1K`(`$<!d?(@zqkbfy(x>SY&x6azB#PW3n)Hb$56Sg=7O141refPWW%MMu*t{c%-^
zxtUZ+yQwu!^ikt<_AyFHHt<B;@ht^kffzn3ZIO9&an%6Aey%gfGult+88@K_H*MYR
zhJVRa|LYn9`T+s0cb`H|C_IelD3dKaV3etr%?Xm<3-KVIn=Glo9{DzBtSZs|kMC+p
zL;d2PL<z?)R#hksWhQ>#$=V8ma4bj_vshi6;&w#GN|1(eUmNAw8uS;LibNynyhTX=
z04Gtk>Tw9the_eb!R}1PH7JlwSZ<w5ng#3G6RPKDd}h{t!#2Ez+3cc=#ZjuV{tvSh
zt%cRU4ip6}B=lYN;iPB2gGNzAH@hLXS>IT>t5-CXF8Vj_>Lp8pjw`cqh(xYu^H4M+
z+S+OKnUu>kG<}@>-E;Nh4D?%OMYds6eVrlc#H_i0pQ3^np?eJwBI=&GS9POlv0^AW
z)6$-|`sZ&dlXsah(A-|Jvs2FmQ$gDbjXW;eZVFyibuxDf(_~3$3pq21<cf{c)&&Y}
z=&J}%;x4wG_)c)AH3&(wrhnFhV=Ceir@p!}zvd}XiCYhe0K(!=Pmj6Q?<G((s6u}8
z##6E?(~vL?(`B6oe$$uKcDJGDJ~G6hjOW=*8Y6#Ivvwkt<1qDglN**_hx{2_%HfNb
z>N^^0s^GLi5Zl*ZR%0t;BHB{?C_vkE>7xMWn|2fqyihKAsFzNEA%Hb)=H^?mH5e-+
zM1t8Di1%*_9h_=O#NOhYK+47P=3luCZIHd=5mTV;fP@9PM7s1ch+4%1?>E<V_TT5P
z2$%@-%NUhf9~dkrOH>~6>z&6!Y-(Rolgtb_UBOtfv_fULzn^7UE5Q>0d`u5+2q2lJ
z{()Yl_(vWO(CY#2&2eU{`t@t#AnNa)Iy(?+kADjecmJ~S*XgR|v&Im+|1Ns%W1FV7
zqgS#hH5o|dE2kSI?AZ4#zqpS0eZ5YME-Spu6l<&m>ei}G63_-srXIpUX;Ts9$FjGx
zveWP+?ETqo8aHB^dY_BBNtTN`H4R--m_m&y7kuQNVB(!Ocp2JvRmL7<Jt~#_Ay`BH
zj#i$6_@L88Edr=!`>&@TxKe2#xLu1_UZrff?*L?7I*T`u$PpS|RSZYa!TJXoiJr$X
zJUx`%0w*Z!D}=_67tU7ac9S55&dym#EV4MCyGpUG_$aVUxhmhH&&)8OVrRjj6VQ@V
zT}?Wubt1i;Jq_(n%#l<~hBA>AanpV802DXmX6pvQ3}HSiEwHzKC^|>+uTEyzbob2;
z5MlJ95;3Sp_iDil6Frjz?Y_B;VM}{_853ol_L`Qe#k_%@iFwoOlb95sCb4n<aSTGG
z$IVj%DWTLWk!+X%2=NjrW4MW(T`T41KhD`&d>#kC&!s;&Hv;JR+^UdsIAKu6Se6tP
zwh|Z=MypiVq{Z^Ba0@{E<yl1o^@cz*D_Oei#pW>;VTCEoTVWF<PEh`~IFC<eTVR$t
zML)WbnYC-L??z_kC_~;I8rW(?KcJ}_%AaHVG9i`05P`rW!yepkbN2}`b&fXrwr3&#
z<OSC2LDI5M>di!iQqu@|tDka$?rddMYi`)VF^EkSKxsP07VrEEz)F8O+joq&!Q5uK
zenfn(bt>wC0Y+dR;Z9_L_y<S+i6=uva{T`Yvgv{2GwuLxXD%ep`E9L;ycY!}JLKTe
z@A5v1=+)6U;zR)qZA%K4LXF*YEDdfZKo>bI&_9a~qd+0<s_Ke^(Gkm<7|qA%N2NG{
zA*d%4nfy3{;?m>AlNYQIf<yadtY(xQL3Nm@_uv_YC2h%x>}NJ?ckFe&0>!^|4$97@
zGG|8TM<OY27vAgg8h<aPo16kO4rQ=5=NfoO%X&55Ji<e<PQDy4t((`4+E{^<eS(yU
zR;8fojE{qy#D^&Dw?)n`&anN--x4_)vFp~DN1S0>o_~eDz9&Z7<9!BRmi%JKU_y~N
z?owa#`qeLb&P!sihzCTCo4s{Uk$jyn_>=9UDh;DMfWmPc{~FbEU!TX@3RuFb(Q|R>
zHVHhU5(Ji)<>g~!d}zGFvmK|B?S9KG`?u5+z4?bvfQ}}k8u$?BzF-aooH)s(X52+A
zFljZiN>cfrNrgtLd3~yXYYzYj$BnqD$57xabrF~;N_&gS=e#BB^T!iFzpnUKg2n>z
zyKea<pR*6w!AMnOfifnN>zG$gR_21H_pcxvJ7XLn^OpTELd4!!<|_~@2FQLp6aRU1
z-AZ!hT)Gw(n~>CJt})t&XRdG{?WqR9cH@(U3-;=DLfwy)ePf=+_;xjj?8R<8L=5Zq
z%74@zEV0crYlQ54)8@U~=J)7gnuSj_Z2sr*0dK_b8vm*GUPBTGH2W6%yw{mldX;03
zec^n>BR_M*PMtj(>AwA11|%q*dh0k7m7bbS$@Y_eiMb4DvC%E)Ev?JYR88^M$U4`S
z<Iy^Pbt@ZN-s^}2Z%!f+(2rd>wt9lFzCzyZcEQ^y4mWkHs1FpAZRAC6Kw>_&qu0eu
z1hmjfZ@60^VGcM~9=El8`+4eUACfm?O?gpaUQ+o`hCQFIu}PBSh+kw#%;Y0N;r21T
zh#F=z7po&VNjD`U@x5OMT+oN_ACDu!q<1y(-+WH{d&YaV(Nyq-TQYc3VAV@>GkQ8q
zqFr>8a3_3q8ixM*s}``;A@nK=B7Q+wSy=R1^-$?N;t_XhO47{bO&CE{!WBtkpT+iG
z_q~`s!HDhy{!|J!J_h<ku`K@YQ0yrr>|V8eSfm!}5ZK;p;AHc&@Y}ujUsbtq2=jtr
z7W||+CHp^~v&2w!FiAnetpQUK4H%rDI7iaLHXE+BAAWBVH);xhu5Oi}m^u+XCC-|d
zqddO0-;3$>aeUZ7C7G#Q#UCjt+YwyhOGNT#%xPD`D)ykrE9DAvT>F7Fk?xzx<t<%o
z?-85DG+Wkk_k(K=A~Cbe;8-;QRaE1MOeo6^Wlg0Si`)++OJ?@Zy}(Sfw`zJtd8Hw@
z8O;IE8|yPX9&kT{qlLUeVw-~gk0$YFsZ7oHMA&fFUK)hK2c2(!K}%)|M5B^@*HCNS
zg0}aB**|TYoE@XwS$=-3JJMEC+*s!>BiNH;Jo@N$J-to<=)&}sD;W9uw>z;NV)Iwv
zCc*4eIjH;r*s){2)kJfIq2o7_X7y~?#y*t6kjAPFVB#7xv2;-Z&TH`_Swkb5Tz_Zi
z54@+Rr(bvs7rk^J^u;~QCzLj3^ie^ThSLoU6ZZ&c(J!xoy@%&U-y)ke3mUbqy-CD&
z@!thw>S!?CewsyXWN?O#Dupcyg8xuOJ883?vOP9D$x}|5=ewrqFL~FBHPDaw<{>$5
zwV${*s+zDA(G9m-2?Bw~RV#}wEY*rp0|Ik187l!*0|8snum4g|`3<rJ#`sk^<zWs?
z>H$U_?g}@W!ic)aGa|LOJ)?m6gMWx16`p$|JOzhw_lz$fDBJgxisO|?B6_m)+W63b
zyO}avow1H<ZNJqUk(~Yx(~~vtyx_)Xzg%YM%v6)V1fVgSO%RJ(7ku@L#ZlV;9Q{$U
zRH6BObeMXQ{9CL;(%zoX4UWq4Gr!XWWjnXT8v^deat0=byi#p0vuHP=zYQwNYLiV$
z&s@_Ygy^Pthew+vkn7zo(y{D&)h}K~5r{Vm71XuEUKK6W9mG2b5G_uM{aIXTlndgr
zTj7}Ty?{uo`*u#rrE&Up1&M(w&7eBDk2o0ku4a(s0!rx~FE~!lnz)#yqw8e+xf0sT
zCifg3^5m<e_tHyuBuPBmkCb+elOT+spIecD>cf-*Q8zU6Wk74ZysJQMw{C#Tt8b1M
zWyOywRD2^-r1I&<mV1>Vg!YfGHJf8J8;Ao6b0t+AdgTEd<JrSndaHFj|56XDD;vnk
z-$*q+^ZX92QBE`~4#ne~6hds$-|%0VFyD?l{Nqn5MTlcF9L<GU&Nmd%E63h^KA+K*
zJCgP#c%AMRqOm`R^7Bi_in9qiS9(o<ZzhAm4_taUe?t*81KdO?@t9?Djcw_D5jy4;
z>;bNYlyT2R-hYi{39HqnpI!mx=wIb@JuOE@Ds_XDWxKt~Xi_U>6OLL0-R+iM;>*==
za=pDp?v=54Oo^?4;FEe0n_v8$jhutc1?}nb`eqsu?0seQCR?&-ZZO=L=h@Sg=vDp5
zk0<qdEJN{30gtPAuT%qAY=+hDIoo6q3fC*b_6rCQ8%T_=b=GB<C`(I4uW6bD=bJhW
zB%gsIS8N*}^fC?Jrq?W4Bc*bBF~kK}*^~Hk3>&|=u+9;ycF}uxUDcbnbi9tn9e-|m
z_wtsvi{}_CT1Av1w%xgJ<ROvC@ML;XKD@A{Ue&ntibcMb#5vn%_>5vsmKSued0slv
z=u#vkZ+IO>;>$^YG1vH{*IuYA`=alFvOJ8!WawW!PTm<hQZ)BQ+)A&^oRaGw0z$C#
zMoHK9oa_J5;8~@kD1Q>KGCAoz!w24>$ND=n+9bKje8PcY-Ul7qml7JiD*Rdg8L4``
zq_S-H9ac02k6+k#3z_43h5IN0+vzD5>Zu8?k=^vlsuCP^iPoCF^wR^!KPq;Eq6h=g
zX1#&Rw&Xlk3G#`st9oaffTXi~L+Pp@Mf_l%2@ipF&*Ugx{eiM*_HVzSvu=lm93ifd
zVzSDD5!~t>MJuq5V9n&%D(?*}>-zgjm>=coJrywRBUPkS=#P_hdi@PsSopL0Oz6+S
z#hmUn?(!?~r|(|2G3&8Uu${2sGb><TI2;@cQF*0lTEtcM+njPpISIE5{If4FuHG>+
zj6Ejq?XcOS53IWhu_O^Yv!j{N3;73m)i}H^@|=>JmQAc(yJ9xi{v}6`L0E)Ad$I)O
z2mHsr`uIrc=KhP{{ZgMef^9}s`Cd9m@L=Ni;WV0`FEvn%ksExXAHPyLS*1}AtQ<(@
z4O_-<qqoq#T%9yS94AK3zijVaH9wLQ2>7aOKYW|v%7{%h9`(+@qLw6S)*g`Y9CBck
zwRA}AS)H6T`s2xU@Qkw`ce@SfJdB%`|Ln9Y{#%Iqkb!d$QBe1E>rYX_T1T#?5t<+T
z-I^lw>4?ILXD8+RhnPZsrkQf!#_bCi((IzEw_62GytLF0{5T)}F5IuoCwK}J|M9RP
zus&oKfQy5MpG}Bt^0%wrVp@?$u9b1e>BU)kBTMh*e1cDy{aa!ivF>)PbZekJRQ!mG
zFuU68O9E4~-w%>owtMAtk*W3Z4-SZje!&X|;YE$XlRTV0TL<i)ypg<!{E<@F+Iy0y
zM<<}2kqeCJ7bE4Xgp;L`nP;6V&#D+-)zV${QxC70UBX=HnE~ULT>!-p1MwM+$~M(E
zA-xBZqd|(5*S!j@tvR^P59CjeUV<NtZx<57KC#b7$3;xngD~N9l#aj-`jvFMYic*9
z`WQekAtcD`TH{w45|pT5b`8PPGa%yRW!(6MzxPvpRG+lJY8_<I;@#;q1REZO6ukIg
zYj9SgWEP{}mt`vL^7M8q>Xi}E(BuORX0jF{6BCV-z69yRpkLlT)H+_vqdM81|43?$
zb7($#UUuAX$?K(S)TXbknk3r)^YXYdi3drd%XcXg<D7c($KVdV6a!KOB+oC9LGZoN
zU;d7c`$_l@KW8}ksHGvGsl0De7PS`NG0pS7{wVlt+$p$bfH6L1spTm$UV<HsMUq^)
z*s4)&C<+e9{D$aV2mZd&)a&b|3Z|w%dPhQZ1E!0Zje11)080p`-VM<IS%02;w;d{u
z!oZ?iJF?2S%(z@sf)}>e!e4|$fw!?b@zF!Twn?VtrPq3da?S%nzfg!3w{YQi4}SXW
zHUF#eZ~Z2{_(9t5Q41SrHI`#e@&qmrW}5x{PkL$E5U7tavHn41Gl=uoqhd6}!xvcN
z^2z*sAxxGRNijnlg`od8mS>15XHq$$fM0~!w?&C6HRWNgxR*+<ey)_khe2WPEOTs8
zgzK<Ddu~q}2xSY&i^(+u^8d4TJAF(Vo2#!ZLf}SJ0vDdhJ$|~lWZB<!NUbV$oTV9G
zDnL+G$~<&%1hv@RBWUO`V?EjzizKTNvkuLe)T;&Yq4dAt#UFaV;>52PhOg&aeIGUn
zGi&-j{>{WXB>A93{|ax&*$2L`+0*1S1!Fo(I{)>Ac%G52`s(PBmL_NCglVzpE(7T{
z{t2V4Dle&4tU8B|sEfDA;UiLhay2@zaGp2Yr}5AC207I>SO6h6j~8*OUnzFlDPJYZ
zC5zjd9VAi{Y|2d}kuy9!+H&`rhp(B4cRu|Ojo@nXl>iDcQCs9$8%}s9!!m+jq47UN
zA)Cp%=PC<Vx;pP(=*aC-M|ttL9P%%-Jepm+-Z;kO(C=3X#$|Mm@yiGDKPO!XQ>Uuy
z>Re$t3GKpE=-V=|io<mRwagih8?z|6-9U41FH9Acm@1S^Yn#9IhIhh9Y#;DwpbMVW
z2ZgUzo0F}~k^Y?{{OfT6q(j9m)Jd-D#q$vKYhs(9Zu+KE@@-%sieOt#t>n6jY1)0-
z`Wj?as})IR$~lqJH?<$?ry@r+vYaj&SncWO%DecY(ySuPE0fY!_ttx*-Qfp2dhNrM
zY8)|N$ef>k#8a3SNsBHSlBs<h!1EX|Z5zHIpU}BgpYYx+j<8W{G5fnG<>)g0i??%?
zJ-1ueiII@K%{Bvx)e@<@N{)cIc(kiy%<99P(J@_oNvaRv29<9H7KA$nS=~T{U*Glz
zovC+RbJ`y4G1yQ`=}!q-TilnVabW?e^%60$_Lmnui1c-t=T^tx#oJo6VpV@n)3N-J
zlQExz8)R?Cydw~8PU918U?Y*Q!&^Ekdu4VLZ4%;QM_R@vJ*Q?UIspKa$6BS3|2ROu
zl9xq7hx#7-2G+>?qVv!%f+qJ~lVF_RNBBU9&DB`-GPgH>Hm=)Lf<hjFy<>Eoi9Aa%
zY41>VG~iOHg`kvtl`=+Avx5<ZpA)=)U&R@ZxqA(=bX;k5x4X#jD+rSyl71T+4cqVO
z|Mg`RdBzbzG9p`b+<a?z0WMUxJ^X1L(5idVH|?O}l!bnE4QVx}@7RdUSy#7ABIc7^
zJf{p|rswZWuY>tIsGNo~Wkt9Y7<{18m@mSM^E>ERgYFhG+5}|^4S^<+7#O2inM__J
z7({VKy`AZoU-Lr);dm%9DC4601|qx=1hCVamT?h2-=zG~u9LV4i+ghA|8{3Po*jPu
zJ|6l);&nyj@tNb#uxLC_?>Q-VBXutx=EBUw7q79F56J9In(yb===WOUscpht^Q^N|
zUanSJgDwUbpL#0fWV?Sgvc9KRt(wh;k7;Imqso_Z`CRI)kOC=^PgKWR*f4hoilA7Z
zCRgiwXY8j>ccg*apXfuj$<=b)OHbbZ#^L_1(~Vd-*CIJEuLn@JKcw}P`_!9Jtqmk4
z$1WzY>Y4fQr`lfZ!G+dy5w#7(T2k$=9|=smbk8(}r(h$GbjMdEP}Zr8!!Eh(@^=6o
z`=J^=>T)VaNo1cYLqm(^S0kRCgS|O<AkKa?Ux^+IlPy^QR?)>Ip@iD?B9TAlViEVz
z#W$Msd2Rnem7;pAVT~ffMNzE@53ElTj{n*B1skqFVbin6@ziU1VB`R+IA!pK&IVeX
zB?C=|j<^bLpWyi4Xt2O1Y30VNQj%FQ>789`pBV&t<t43y{B?cuOCQEKL5Dxp<Q1lE
zemhwAPJZV2=`}5QHnivESoyf}h4UTA)LUfx!%#r(&gkSCX;>(4iPC_CYN)30bbeYB
zqbY3GD2p(yD#~!$S95#s>&1zcutcppS8L;l*TX95y{hAhi|1}8D<da=Jh)^?gV<c9
zu#4yVLT?#Cj9I(NO9nIe#HkO&@_4<~HAef*{WUUvguYfqyD>STqJnTyp`&=%^nzGO
z5kVrlomqGLc&K&~ZnBiHdQp@ib+QmOiIAPJ8MyVQby(Ybhp?pzdhMeFyF;rGMT??W
zZye~gs`wXfB+}Z80VZcfuJf>uQ+9as1eQe)&3{Gzp(*as^_aG{#(vgyjffOXdFe%I
z@VP_UF^JW%V9oHS*T%js1y5*eV}J+Kdv7}D`VPz?DR+^ieMmctuw)JlcTA9NG=B(j
zRb7NavjhlVI8LVYH6uAS(c^#Q-84LN&C@=^k0~C*mNjEevaV`_$-lql-MFfkX^Rg4
z9NP)qw-sbD8aIQ=yFp*kaS;q%>NfG;d`KW@dqDA#>^aq$1ufUCLtZ2|)}6@Bzg!(=
zMF^^nt`|Ik^#_LRoskC0mlEiXMFioXUQZBtl`30%-`Xv>)!4(qc0UIk**OpBoryOj
z)vgH7=m&~XXfzu30pxW2kC0q@L-DmGzRTnc-R(Xd3t1PwyXGlf7eeny7pFBec&X~n
zZA*S~TR;H8r_#+E_O|s?E4GT?>ydPP6{0;Q1ot}DYZyz@BRB*jeVKl}+3SD~8DPoL
zea8DBywvtmCerreVfgV2Wv{=No)6w}!?mdO2qOB?Uu`kQ;6I_y?4EFT&+g2e#gBt}
zoqWf5{oYNpng7iq>4PjLJ;c6%-@GPnDe7Sv0MZFL<l@C7GE*~?%eHhUNYYOXFLLJ1
zg~ee}kQbYZ``&YZZ>X0n=#~~~8GUCl=X@_$7P}`XpGS7Jy6E2AT+crgH)8loY(}Kq
z9p0lGAt7mJE$|iY(B$qN=NmXtM!?yrlz(G>ft2LEK?X^*;~-8~YvF1iD1XCCMY=w{
z<5=!1!cPiiUFR1bcx<3o)Trzv-=}Rg=ts&(xe<6*Rld`(Z+AuF7(pjzk6bBzSVuBD
zUgG>x37vY%h%D5vF(-a7G=Z-DP1oxkmRD&ka9)?mw|h}TvPa2(-uAKFeT~j<0j=D<
z?50xt94V7$;9mi5`VsuAkzPe-JL&al-`I+-%!6qx_!W9{N?ZE}>|5~tvEU%qE#*)d
zrxNUnW~KM7BUPa?K;7#y8#^*EnLNb<t5ib4<3(E{Q~mSLhHDVn?$7pUlF~Fn&-4k8
zY~(xd6*NzBci=RE8k3&=Y)oRDD`&IT`qrQ@n3uk>-Tr{J1MAo;plB)+cO8|CK$%>;
zz)2U;|E^8xKkt<(xx<0dSTp`j<d*hnHeC`cyR}*Ua!jfDFP;TDmwb=jhEn}|_M+zA
z*;-B$_xZE<(tJ8(cQI6HYdfD3Rq3viY~Ufmm{-b~hhUzjOZ?;%@qO#Q_Y*~VHuG*x
zn~>MG5@iZHn~nL>b^*y@Rn)LAjj!IQmx<dw^M6vX;Tpj?cj$`Jv-Ub$xtpKeyaY?k
zz#QYZ4&+w(;}}LHji2dn*&yU=iPZLJN3u|i2aVmp+cP@@diPvROOzgy9Q0H8S?}R_
zo{A9t)#<eyO3Pgw;Bbo*SZB`*T%u>@4_tP+Pa>L^xSXGJ3IPl3POGP%RpW%Ok1n7=
zts0j#I`O?*X}uaBj3>-!naTv0zWLo+mTBl)6=v*w=WkBEm+5}eA8#vm+DCcd9`RGv
z;G5BB!p!goeM(IiGOcj)-r2!v^NKB4#<89#bAy6O`k!Y+erJdWb|fPeihz#oNb<f~
zuULiewpVM5aj%n)RG$OsL>3VJK|xk&i*jAIm!tC6Sl9)5-yla_J6rwgK5ltY8ie*#
z%5vgof@?491_9dwd^Wcavj&uu)-uNh<!m5X()Alrv?J8;xGz^Rn)SISP2<Cs&E*Gq
zcG%X+gVO;6#z4BBs0%?4LYiH1n?^R&nsU%O$t&5^sma@E9#U|iLELQ;F|Me2I(<u-
zPTBZWKzFaqaA<x9dKrTlK`rBry9<>LJTASoTfnkEIWJIIgG5T~N({KpY~5Zo&>fui
z1>3jr1(Js&zJXJG&gOpDHrIr|G#l6w!%MnU{`nX1$k7(GiI=Ejp;+%D((9a|yMv9H
zBT|bIW$4h#m)X*|__(bw8b8&FnM>)qhDCK<tOUgw(^%-+ztn&q#T@1?P;MkD4?Lxl
zI|;epO!Co^O?BnFmu#WHhFl3Rf26Gbm)=tl;@8z-6{HwWD)IYa89-lxfc@6!F0oM*
zdHc&aKC5O~D^A&JKN<Rr<3XbcvDc%k{*>cN6ydt?TKr>gYW>HAXkvRjp#;e{dxg5H
zC5cXR1Mnj_BK+k%)32FLvE)czJwuh_B#wJF7@Cv9)Ide~h3&xyZe*T$ZwM9Rkzh?q
z7R^|hK(AHaFT@v>`0=dq4kZ7cfcjC)4Q7@C1C`x49dh(aHTBnE-^fh=-aWCQ<POhQ
z5O<XbY>Zl`64^=Bx21Jp1T`4oW6Z!!^5nED!CTwkz!ch-QeP<x?YB~2oSWFHF<Rd}
z=UvmX7ik<+6gVj%KYcA9b^mNYqcQi6QaY|VTLU;LV;B^n0R#W)gLVeo?(K_QwHZY{
z?YWTsgfkw1Ow);?9`yP>=nu0p8)SRqt*FBoQ~x1FAY{(U-{uWeC%{Y=?eFC!6dB{C
zS3Zy!2O5ybx9qUhoDP*quZfdZI0%Gv@jqL<zY4=bVKS*rhD{pql3SXJEnC>Xj~{kS
zuPZHBs(=v(&Wtp9E^hOcZxV_|qo+d{PL=Ou;hrVZ7Ip^C0)y2fG5ZO$o5Ex+9~i*q
z)1)#4v?c+xHeJN1`2|*4dV{h)PC}GTX3%%KAskHp9fpEH$!KnVR^-vu-L-TIi}mPf
z>hgRJ^?))v%;d{k$`IEKWgC7JGs?YsLjI&JAAb+g;Xk9-X4E>qKpz}f>HaSHIUt<1
z3?v~M=9#h}@0+N1Um<Isd0n&UK%eHXIp`xtMFuN1?2Oh%*1q68!)EAu<s2t%bng60
z-;&JIc&n~~q|<`0<gpkcfFav$9B~Z0T>rhCDDMPD#Oa%ixht`yA$Jl*L>bijrOS#u
zQ4haWaDK_CzGF?n5UVjT_p#IrWswNh{y^eL+sRO1pGIauM5qBg^@@A;G=X+mYgyZ0
z5eC~BY8?FX9nNQNo#()8$C@k2`c&PDk{SKk!_P=3azae?IAo*to!<KouktSk9;bNC
z_j)%fYn0!s!(*|ttY#n@RB~<wNpcJTTmmO$$vj!D5%j+|*kZe02^$9ODCUKcW7z&`
zQk7BIkf#E=Js1uHf5|H=vx0es0e2VcC|?B1zqu%$h&Xzf_q0ZT?D=``Q@*-&N(M7v
zk_T!u^}DG`@vMYUmL7NIR-4Lu1r`nxp<5odeOdcFd_eB<r*?HwY-0O_oYv4KCcEE-
zWzYE+@ciGWJ@ifG7l*Ih;`pP**aVE@1uCb>R5M)R&e6O%<z$a@7{HleLb_MmG#{mI
zS+91JW+DbnUbE2GIwoB|6hiV}17S%&$+*VjDERkn<K&JLSv&uht6WK}-+I&kr@CBg
zn|?Nd?EOxJo~7o!f7&Z*Dnxa8uM%S_=V6}rqE>}-pL8o@la+J%<Pt+H8Pt+klm1;0
za;H20aR>D;w4!iT_?))7)D^S1t=NVrtw{NOI?MqFpGMDGQI&iaCDT#Du$7C}h6-{`
zvyfIZ)Sj=QiLZk+{6$NX#G?(T_p3`UCudJ5MS^xxQK_A^Id_X$H-$=*nzFpaj-gd=
zibwDm>d9mtmhXo%8s6+)Wni&tn%tSBB3Z>OcU?xfcDeN<9%%>shCrUg^rJV<73|Zb
zsEXU#T6EzWT0DiV(9}*A5Sl&tt{BdBC<e;z8THE9!I62^WdBlf|3D*Ibq&B=!Ct5@
zR~RF(Vae`cak3<55RQ~czFgB6%j4~m(JHvk)Wj38ZVwmDIs4`V>IK7j!9EV>in~PT
zvE*y%Nkdfj|B_;NAMuJsZ$vnyrr?yjV&2@q$rBWIEr%5Ul%@*@pjp?Ky52uy-(#l%
zX4yq)fEWcSS2i}6HIS}+ly1tm=MOwwN&jT-mZ`>7W&b-QDJf6Hd)7>>-L4r}<3EvB
z!ATh0&tA(#L!N|d?*U+^rW~s>tZYPNPf790x&BxEnhq;qeAM^`1uI%AMhypE0S`SV
zMQqFDFnlQHSN0<N;-cN{RWHVvKpa49S?l7&WM#uZlL*^QPuP3KeahVOv6I-d=(rLH
zo!Do)OcEQtsEC|AMb9$Jzulesy5a1v(H+m#+u862MTVK@DFu|MSwK3kmAaYcfZb<$
zyMUC3b4fqljw2+W;jg;62`AUeMc^fPMRvj`8S6uueUKvK;bL-ju1Q!SuiP4visq#j
zi>o*UgvWJ!SIcNscpGU%cO2+)&dpSIAbWhI!Jf{-n{_df6nW;tCR;t~slLzow7OS7
zoJSt!f~Iebo?{HUEILZtc-uM#%b8xk#TV3{Xq{DAK}G`95b~`{4u$010C5{uK!Gb_
z{2-y&*eQ^-Wdqtp5;}v5P3kf)oxaDHKU<!y?E9=c5<Y1c#qu0n-YsAuo%A<*ds930
z`Nx<xy9QsS@TBn&XIBB~0miCc)NS?v9^Hy|yegH^a3n0N5?rgLoBxaKUzCJY^IqZX
zV=tr^hG$rxF{?peyMm%s{4*D?-g`e|yA1OQh_%UFg({!5$bR*QbSpaM#K~`0%=Fz}
zsZ&%8VIPU-ZM4WRmbg<psoLUH!+l2%bEbH#UV0x_s6aahgkU!yW5K1dT*hBF$aM`J
zmu1Vj@Ww2wj}t-yXxTO~#S~{2DZb&J$N2QJw{oh>u^UsD3-o;;NjU?JAHDh#lkHz?
z)l>&Qltz4tqtEf&SC8|$m^{Yt_^NE}@32X-SGYC7qf-jk+)qwbi`F?_FpfNoAo7pZ
z>I8VzZ>Hg<v;D7OT#&L?z}6~;Z0-8u<0G&lxD^+{a){g6*lmR9HR>U13Eh9<6_%`?
zE!##-yn3DHt!u-1Y5-ua)pMKpJ0LvTkovE@{M1c0&(a^QYe@Xh564}RZRYbew4Kmc
z_tOz}3h_?Uj6eXDP&q&_tyIgApTgR~$|~2iN)rN$<>re0=<HLMUi%wh#ztgTr9owJ
zX_dLl$urk9_2ULT310S>IH;WYqJXf2+&&LhYa<SNZBLzIIomtUrtm-HDapd@vDbez
zo+tTMsmB;pQ2I!eW&f)gS~@s)BKzcIn9-@*1|9o`s&K#>&}8Wc{)2pN`M0yumge|1
zzWGP94%>#Q&*a~se_U@EP3IJbzFo6^0z{cKft96(@L3nh%=Ubv{bo&kn52Fs8kC^E
zbvY-iS-#3p4}F|WAL_3psm7O2tsB=Gp#ss^EA~7NZ@ME-%lz9MwoL<gu45oAX5IDQ
zJ&67M<)X7;JSptBEO7kJ%HHa&%h^to)mB~gx|99*M2FN=qm(NpG2YVBSw(~>*B~wD
z<K$qy*tr;#<FL^!eSwo#s;}D;wz3PkL~eIKF>N1#M?=<4Bi{De?IbAtb&eETFLU~c
zz)S!gm9vpVr|;tK4AdU?L2a$S9sviCY7QPVy{HLXW&XNM4EfA43I<_skC#8G1zNw;
zxalur>2B=1hrdif;H>bc<QtN<)rl6Xi!bDk--x*W?T>579{&79n0qHJuY$<b!?Hv|
zY{qhdGTO(tyB;TE<F5%%LT$Zz5%InM{&9N%&fC^(>R(D6Cj3VPV}C*Yjf2BVg%0`*
zU-ZLPD2S2&u1Hg)1R+pFZ!s7<3!-%0r|xc%h%d_T6q7*batYjZDZS*%XHV~$OY<Be
z->i)fBi<Q_JrCl6|B=dj>)}H}qmrM0>W^m;6wUJX8NTLzzk=BpS|D7}KIU_?xY2v_
z$c5Eh;whq7HGenVmtbpN<y52BBO@Q<|636YTzktDp7lnR_m;g7kmu;<6*Uiab!eew
z(YLW%Yx;rX_~f8hnt9i8de0P;v;>Cdpkk~H1jp2EI@~(XX8ai+Bw2aw?Z7QJU5ln!
z@&M@8eG=uVH2N{U4=NbC3+nfE#}qn9bz_0>Gp_+FBBr#T6b^olZ7zW+!`QDejtuMq
zOBjA%GKK|kJqbtNk_wJKgT-3$_%6@>UBrqkH(TjSd<ft69^9l#Z9hJlis^mUFHML5
zB#?ym-|HW1T(L$S4T(f%{c)f>)h@pGJ6^U$4!IK1;s;gzZJ$SwiKD#Nb3I38oY4%w
zKk>^ZW>@=V4+a+T0!Z)dijkeM+_p~7{RR~D$ejoqcK|aS%bv%(wF>FGp_iuF807w}
zXmC-)ito<N<|J~-rX4`&@;ZM-+Er%%$sz=b(9M+|)yFU$FX$vRvA8VZ40=0rB&bnz
zSai4j0L%AE6!j~Duv`wF|GKq=N}H@8T$=lHPabdQ@KiUjVfi*awR=lFUIrwNKi>xa
z{T-7z(O=Z<IcuBSbvwbtF2N_J(uMY?lJ0t=h}vOGbHpj=23YNt^MZ>PgfHY}m{Ak3
zpUZ}yL+~v9bT@HH*ZblCQio@DQQN2_=p&@W_JHcN51f#@CQJ<L4Rv|{pVIRH^vWkc
z`GCU*BaSZKP?zl=q`o(kbUe)MOwFgiz|*SMpY|_oA&8cIp8@Y2>cOT2=;-U^nI88d
zRt@zY(?i53sLbWXRdl^`@!UN($2x|k%q9&K`mnF4h^=$w;(W*=+2z3|>Sf8!Z8(8-
zv7cjKq4e0wV-Pw9NizINKnNKKOHrz#nmeyd>i^Q#PS~ljjYo7UviudLC7rJ>W_0f_
z<7H$Db2Zx`;c@&i%QP{u`RiG?!=3r)f~3LP9|OhW-~U4%5vN#H7vCOB@a=92tZi!|
zSBQJjoZws4*Q=!-K;@+fDby!rc!<<#vU6q>6zRWby``y&)g6R=^K=z)b|O%ilB13M
znzZw-P$Yi4$Gm~g-=%lBf<L~7U_EC9g&$2c3&;ml`!Ta6G;TRKkR1(ucdEh16z=pL
ze>%}^JIp;9yT#9keoUA%dEhA(c3noEN}v6KE_|9RAU<FaGc+YR>IcN-W}Nli@v`st
z+6<umBB^b@(i7srMH!)7zl{)7p?i-pzmJV0qI95<xL*!eA=xm_)fnI$O0+}$ptmR(
zxsax8u|T#lMHntP{=fl~S?}KEpN)(m^IFhGqH)sD5M{Ez&(GDT=uOTiPhOBsGxz^y
zYx0oq3uSARj)`ZRXNn3<@q^tb{!^j;Oe{CQ_hYXKQxuGz;d8}GEmF?i<~BD)XCp+a
z_B{C}At2|}xNjjN&aY^V#P%yUYe`oC8!!MKNk(CK%6R%pHN(@ZveXL~=n`8Zcs_j-
zS($%>=p&Y_xcdbCtB|nCDPRm98bcORSii$s>b4Bab>Mfh_W5Yv6vRHb0`i1OHOmxo
zlU@_RNH^65p!$|KUZPih&TBEDLX~=9SniVYrb}cYkLsiE>0KT=Q}*yFVBPP?H_J7w
z_WutDLHNGR!#i_zsIFj$d(MdNr%fws>m`YuI5Y8B12cWX9>2g5WK7AwJY{&4SO<T|
z)cf85!9$hh$M4gO>EGMqEl<xCe~gdb=iJcUy@CJqIzYFVHJ}zl#50yyD*oB#4hiP6
zGe)~nZf&+asP`K-ZQ2jUM_YAICL<;HJSU9^X92f}0|Wmjt762g5I`%(OSTW00PU?i
zO{bt+nB81?O7dBbt#E$T&HlasNvcLXqvHfIQ!V2l0&nh4<G|wmvFV>E`0Uq@fXRVX
z&uGb``x`qnv2M6_Y&3WNYz}nm*4^5UZ)vW74*UP_|Ng9XO}F)I$7hl{9NyO(+t$lk
zX8+c~_{>3FAjte=e)sC^9@eut3;p5Wp|XJd@q^mfyKQ&uyo39D?|={nNf_eacs+ac
zY7tw}i;UUt+$7~AIgg)2&Tr2XF?!(7?tS_;>#F_v?^qrjR|rvGJT<Zy84b;mO*g_l
zKtlB&|J<s8B~|)9@Dp^t&?SnSy%NP!4geVZbP?ol+zeyIQ+?o8#a4VDnvwk!i^$kw
zjUbHWckrFJsUkF7WGI-ZAdtMFpo64)=i+$b$BD09d7b~`cKNc~14*yEc04ee0!Qi(
z`wtRaW{-~if4caEt#7jQ>;}*qzCCbBj*Nkn8v*tnBOQz#Bt7}g{;-5@B1}h!#C{{>
zoJNRzWbj8H89X|=#|w|m-uDUHpglO~aMtk6JXM@9UdV;Ge}g7G1Yh;1=iWQ2jd%kd
zpF`u03h7}_9;3j%Gc-s?e55@wrQBAv;JG9uGz71@OuRC?+C~mHaZodF&mGB(#`90S
zHF8x&YrhfS{P0=f<(2CmN_<9aF{@Q+{6yLNO+Mw*X?zRI#~1Q=^GCeUH`MOI4;SDR
zcgBdkn8Wyr;;`bGYYU^U5%3Z3j?PtpmwH-Y2>0mw#<f#F9Ia_3<-g(}CM)Z_rdleP
zh|%_nZ|<ORw2oc={MZOv@9;Pn3qZLe@#o_(5<N#^U_+m<3>J2k?$Caj=^=X0?;qam
zkvSp9%&oXz#(Vzynev}p-ATSP8p&uz-(c^21W<tR1I3PXf+q@|5Vy+@@_vuO|E_F!
z0YjkF&;UO1pm8~kyhQNMCkSFZM~LwYh+l}T;p7nx5a2NRc*sGByFdC@2tp!(c_9$=
zdF<~2`i27oUqT<f`b;%$3qJsSL-G3pMzPs%Sah`g90LJP$iG`*;SLbs4bbkBAU3S%
z-#l%qz&BTXKfBi^IT@wl9~v-zxN#HB#gxe3x|Rz@O>=p$o$K3NzBNH{9wQ3z{nf@{
zTI(|#3(aDwFa%G0922^W0NLg9GN8SfR}oxCAq64HeNym*ke&pD@X<~P0yh)kEfsfS
zY9efISND$_O%I6p{>&scj!a4Kbi3+ixC8VklMEUac&|1#Cj1@*Ly<%d)i-K>|M%l8
zfitb3g}${#7iksqFk4D-cu%jnw*D>eb2lX({6DxR+(CEV%ZRRP4A?c3jd;x5kXUBq
zsMcLdu|j@6K4*fEAy(6c?hXG6r`&)X{N53EUMDkSq7bZmvEn>O;$fWlj}bo~$h%(S
zD{g3AXO4|`Kg-}n{C~LrCj<<KODJ7$j`KV}BjkjO;iWtfG%1PPY7k|Mj&0pX`EE#A
zABybM_`l!Y=mPqkrXu_=$G~N2-aaE#OKi?$otPn<Aw7^2914GB9N5`lJAZ6`@p>#9
zt3j?@AnG@}7v`Wz7U&Lf7DP31;v-1Z(hd-asj&+z(khRWlYrwo-~TW8ii}7497vAl
ze3hs31O4-D8zNkFup@5+o^gr3=jFzB>ORj71mA<l=r~0d4>|My2+}|$I2~DE83G!!
z8`V5$;ld98_>4z*LlNRUN8t|$VjmID--1TR|L~p@;2f!!al-^Jv&L!3#<={=LB!-H
zw@oyTWIg-9k9`LW+jH7p>Eg2~S~(*$S9KY{#(LzOdrTvUmy3+({OlpAz7>gx?cU>i
zADz*finjUwCL$XDavE&^OeUW%LIx|tc6|s-bFi3^5YH9n#S&glzyodOrG9cpZ|d=K
zLyu3+5uNGz+vYKe%8;90r^Vwe3~w;swz%48VDYcd<c0iJ1dqUfgPQT<KuLOYU^WZ?
z5wG`ws@wnIpTLE#+mJ^>RtRT&63Y(=EPHoJ^KrH3c%EqB!Pgk)dGQ9v^B#+nmO$Jf
zXVIIJhfxVyE(gm9+`MN&I^!TFevspQ?;nXbQ}Po});0Ab-&cMv2aiaS$KyFtyK4eR
z;r)bB!bUbZ^9OoQ=UYI%BeShCuy9w5sPiFI^C}OoLiAnK;ULn`d;Iny3jPtZ%ore%
z(wMS21w>=Hc;x5dJiE;+LEJ|Ze4mN^)@ed~B_zh02Mu)?%&`66Z67zs;axF6(@*L7
z*42V0w}_gsf2YTIZ_6d5a9%R!$r4AIwc{Co2xcbs1j1cfn2{cM-MUbl7x_M3I{=lh
zjN38L|Im|3f1Bd)0WWC|FN=P@3Vaan;xBn=km4-}1+SNfqQK&ChlD&3VjmIWJV%J-
z=8XfuetrwE>I=Zrx<w2IAJ)vdDYbF=vk<+N*I;Aa51o?y&Xkxr4VLM8{h_5x&lw1r
z(lA@ne>%(no~gsqVZpd1!{BZ!`>tJ%FX$4DU<9pRkG}}rJYl6JU|wD`0XOsnumHx@
z>i*L-s?CJ#R(`1OuF@q;4@<w64__At)(6+AvMLDMPWYZkd7>2NvRwFz#6rJ2-!)_7
zCNL=f|HozSBjPWUGZs8W#wq_cNHnrvj?IHvEHhgw{1D6Y^xL0bU&0&#0OV%Cmm_@3
zUNZH=3nISGioN2tiW^lcmm)l$5ev}eUhrO#=>Pe#+ES!r!!e*x)Crw@(5>PkF%kGg
zPlSA_#mZx-JV%n5De#|<G#O0m-zQiLyYkMKRz6Pec>X#L%^px@%}#SB-1nekA1a&g
zBl;k2^E?xtByA7Ge~8;GmmZ=&H-i{t;soT5H;!Rm@3QlFF}zGfEz8~CEp;b+cT86m
z=7d|3o*+bTBCo%74}ZC-WTx(=fsp=e+<8|{zD{o7k-PDiWq8WCVGf(5YqD7}_!ehJ
z>c4OwkoO;76HRei71%N$KR}_BoN{3gmQN9c{v#1SBR}z0DD4k%a%W9U_>4!0UxH|9
z?!&1e<3pvhzr^j<8t)o`0g0PK=i=1gTj6)R@fl)25lDn|i$BdYxJQV~n6zo&Q>;We
z%UdNUe0*faaGvj5D6TsW(<Dbp`mwnG5x$fEGjyg)y_7cWf_^IoBC1my0-bv2^ZEah
zQ3DJl@y`ArR1se7f)#l=Xp&gSipLk?blb|tUJ>%ghWy-XCB8-F$E&gct`XmP;f~_9
zz2D`@3nk0sQQ|2gm=G-+A?_j(k7dLj<1(&Q{ogg9MCfq>S3qnL$H^=R_2Vr-hT1<6
zr`stNJyvsZKf{mZSZ8Uz{=M0KG5g|BRh-WdC&9N(GE02}0j?*9mhte)Ol9F5kmJCC
z5I}W-0RO~h!yDO#=BM{u(eW`dM}75%JR(eKm*QPhLkK<L6HcOa{30S!Lroo1L<jgp
z6Yw)hnu>kviOb_joyetfR=M9lpYaC6z2hA3;stY?fa`3Sp-H<yei5WwYw8fGRYC1W
zWb^CqEt1(WI6>z4XNtFO-MEZMs(=|jlQMj~qm{Q3_d|LHBLi|d{wHLgEbHh=(?6_K
zBfd^}Nyd2?$iB6^aTtr@?1Bcxsnl2HMdj#YLtm3y`LLP4ijqvcZV4R$_z;yq;325*
zNn(D`b^RsZXly<lYWkA%tZak7^#EgKZ4dAKQRCec=Rf0pKt^YvKYIX8&quz&lB)4L
z<8w?1djY{9=&glvrfKYs8m1e*z<<W5sy0O%BLBn*mzTf6D_y<^^K5akA?`<fJLKVv
zaU#&gBtc(aqf^YBykN4G&Bs9zu1L^04yYA#VTn%VV4O~7VWl#*onS%E`TYIySa4Wx
zVi7ZW{A_^e7Ln;6j<_PyKU~l1mERXvd+t}5nB`Crn`jB$fDLx^gY0*uOapmF%z1`?
z!8AUF9|}4ywfvh?E3?DlQ4?IyJimD1nKv&sH=V|Kg6qc&;vz93^ikQw>kMxaZU9nE
zplYIgekN|v0UQpMQnTvB#s2`V+>>LVWN#mscoHdPp-ccGKC1ms|NH=`*i3Oy>aP|j
z^K)XpDz-~JKNm$c5Lu`W)bV`OS)`uvGQ?))+8V=*`0pl;8T^~|$whQtDm<VTs?Dlj
zM5LIau&6V^#cth&;RxAwC<mTx0RZ^!ygRvL!#A8q$3x9~FTzEj0gb1~e|scm?uRJC
z?UssDzlzmU2g7v5geBmb9CgfMyzBR_J7K0aFj{ZE5;#t4l26wqBTL7`>f&}eluX44
zywu(N97%}I@^Mz<^!WN?KduUBDS#!b_%Zkc9b4f$@_tmQkE_drJ=NGd-$jD#5&Ah^
z5J!X}Fo;uUmMmj9F{s8=7=m+a<1houAF>Ge{Sq(*C{(o<Aa4o~r{5e#^n*LO@E7=|
z=ktADOPPVfYI$H4{vuL#C_sdk@QmDf7~Ys2rVk?<(*ejAJg_+e=ax``2`r%kG_aEb
zw6uZ+qbZB(ZIBfZwx5*r3iIz7&3TvR?iwZw#!s;FBNA9B`VF9uzO+5UJg{`vik^F$
z9&v(oW{4#FcryeXG_dgp4K4VX$T<i^O9POMNoC+qEXV}xfyhE4SPD6Ih$w_U2<G6=
z2{LW?JVC=t4-k0L-aJq<8i0${)(qGEXq(i(ZHW?Io;oLU#pHxS98TdFt^#M5(+s~|
zoBZPRnyDfFyDFSTTmnvXE1%sz(KZ%8TEa1$6JOKG8~@Yr1Y6Qg_zYIIwD5mIV3k<?
z0b81OhF;DYS@;nT^*8?CrgF;@*Z%obhV@8HuUeM9Jc!5qc)~H9&3eD^)D&Wyt$;F~
zxWcZ`dl2Q5Lk?yN73DSM6sSFS>S)p7c>nRA0cw<iYIA)E!<Lm7|3D*gfxVv{klje7
z`6|_Swhsu#aCH&O0BWh_41dv&VjQuf%Bmx^<;q6v&yUr`JMN3~Awwsn2O_`j!mMs}
zA<UWkkce}CnWc_EEc_z~aEWmlzod^x0#>#qO{$cKuWDm;vpO<Pf@tOyDWC62xD8Ic
z`<XGhDG4->dxU0<)4Jg;6qm~n3C)GLII^<ki2Nm3XYy|+Cecwc9zG}jX`?Xj?R=ey
z6h4NKh`6&=G;WU>H*vX%qH&ZbiH5O!96hP@Z90RtqmT17h7*VUZ3Srhqa7vyhSmDt
zaqp{;IYKt{zp1-K&bF0P0`f<0Z!?L(_R?b5Al=P=xL<q5&{d#K`B;^LVgV+zbhH!y
z|1=?8&wf8mVny<Nbu)Jxh@-rmRsJ7SHT2h}b<KOr%XxipgdJ%nVB*qD!Nk!fVC#u9
zvNRhHB$T5qc!JFH^Fj}VJ{{FSBR2FLZpBg^K97+Ar+NVPMh#QG={<<=A{y91h4?@5
zoCWWSGel7<FCsphw3hQAs{5NL#v?r1C>YZ%@p&O8l+!p6{$5zAtLbhd3SuI7{Fy_Z
z#RW4#Oxf!vCvFTt@dpSiE1&W3zzL?-2)!=%$N(4tT897_0b2Y32)YShza)i(ANTNf
znLB_VkN{vX-HDEe02l#UhX5D>+V~Fu8}JV?G0&pQ_J4y5i{bg~WAA<nr~wb=B<Fyp
z><TP$K)fX-kJwn9;U5x68Oq*76=0jTi!90VhK28N!{S6|ed=rC-5SGMO6KMNrgS!%
z<1GunMu4?0IxlPg#B{|~W_wFio&6!9WD3~D{J-o)X$^Xz58vztW@&n!Yd`#EiV`oY
zS-YS<%!`q;Cw=~a01^dkI)Fn^O#R3F;`#eStIvJk#Bs=isQk7GeQw$(rpWKx|46)%
z>pV%nf80n!PG53;JK-t4lX*0olbWMJ0)H2baj!_rFxSN8>j%xPd}JhIn4qxX1qX?H
z-(cmmnGL;v3JOf_Nb^?yS{qnIoBa!j#CV7C0<(F%4Vp~Sc!4~9GpAED$ui;}#2aM~
z2`nycIBrGzotxh^S3eWR0Y26zQCNXfuR4hO4SEcmmGsxsUFKeBVsZxD6SSKDEFmJ>
z&)3-c;$Y&^Ou@y(nS;G1X6#SKP7svIpQaM~=c<B&J)V#GD2QrE_(O*wwo7_})oeJx
z!dWlIX33#bI@V2SfZoYzE-TIDUWMhiZoB2!QxW*CD}!?3c0uPT4H;M`>K`DmC;*Vc
zm<a%FKq(k8Uga5@Y+FM>tq)+0nH;~rp9CE|r!*`9&hOp|;pmG;!HoCdCVJKYF|}GP
z2mSsA%||$Z8v+~meiOg~zybjUyE)1cD?;T9ci;RG5GpF7$8WgI1a!%=G($x|$^fN9
ziA^1Ywh4L^1AfQ&93eBOG(F^r#dBu=5N@GXi-fXiHKGG1j!UR_A1W2Icm=jW0UOd_
zB5iw}B_=j^6<Ng;@AF`FX^VXCpU(Bc3}8<5cUJ{<b#dch4X{A)!Yoa(F8)n{0JRe4
zvW}R-JYG=1VZ|_i-`6xD#PP07_>mM7z)amgKlAnViO&8YOsa(I;tcs9?+n62n5In2
z!W=w_9@qoAUZ5au&3pOr+YUVzGhSXbdi4%x!2T!32TqT?>BGF^aS*&nM42A(5zAkR
z2#cB^va(H94TzhQ5!aA_+F8jUNC7Zx073y+&7$#H_n^232ZTo9Vqf3p@t6R4FJ2=z
z_x#7_00*Ye1SReIN`AEfK(Q5rrE4P7gMx5ja1Miy%ydiu1Ofm7B6+T~VZ$)%LAzDZ
zvw;ENL%Z^TD*<B%OBnn40fxVSbnpeIyn_}~3gRP(?14H|70L4bLIa~;A7*;mcG2TQ
z-k>N(q5EJ+0WdnCpa2jM05n|`WHj_(&si6z2kzg0$G`GPL_|R~?Y@N<l+bR!{$4+m
zY;WY!8TE<f>ZZhamkcB;Hgb5^EdKf4_)i=Mj~XN?1CF}};yi2>5TwWT%Y=9*I^rX~
zi;c8=ZwqM@&E8fQ@w=Mhv~i@yj+wQ3!UpH{iSZv5fZpTHDAHmTWJ@s_c<i!mP|cXy
zL2aDPNx+G((8G9s9@|`Y8|nU{!bg?@J@WH_s>*t)ol@=Ukia1S_(O!)|GG}w`K*|L
zo#mbApoStNBRAWahC3K?xJigmz<O0asJ7X$5S^a_q66BMy-fhD1O%hmo~96&*V9C?
z9~A#TSRsnUME9-MBKVm4{RG0ECB%t^6C3W}r4w|F_~tGqJbKck@%Z_I@etft6;Ga*
zR!8AF)-fyVi|V>bE>3DM5aPcO{}IhaO#g6)=H$<s!IM7;P~!p;N#RJz@gE7}LPcB{
z6W?4Bc4njaLy6Z2_{rk6;FVaJ&i@s!6UU4P)dKdL&oyFN{8t+E*xN7Vsc2-n=JD&^
zODA})Z4BK>;E@=-M0nraG7%*?t-LAl$V7apvFYOa8W*?_1Pkw<_xfj0ECrsm&&*-d
zIM1KNi5W^buA4{JTW8URGRo*~CNMS6Vn3kbYs87*o7=vJ=J@>Y;DWd<m!G~|?-vn?
z#1@I=mxSblDIiE_xS2Tarpm1;-vpJ8GzI#pyWtEr^b^G|MTse3kyfh+AEm7I!}^gC
zcxqW=Vk1(S+vSF;5yBXVM}o*z(JvH>#L;j(C=cAFDJCpQL?5qwUjXFPnF44nb>Smi
zgV(NaG=;<nk|R+bBNK>%3`ImqMoaNATx&bSwXPx~;$2Ojh|w01BUsLh{hNm>5GZ&+
zK=BMA^sjm&cn<Zu{~J(A&>S=wgcKq5Ui3QeNndN<3*z8#_vK&GKcP0CXYA>HYNAk0
z-j98lNEc>DeqVq7HmChSH+W7~V6Pko;cdDg1lIbAq&prKtxO1eKf@eV!Xmh3EWg(T
zS1%1o<)|G{&OHB!pOY`i5jT%iPV(lsQ%|oNHm$^fFZ-?afQ*0TJJ`5(eh7DPQ}UKb
zg0#JS(f>aZOe}gI{JuA3CSC3zGteR7G#eto&{;77CioA=30N2iQT|fJ_JdLVOC0ur
zjQ+aIRMC$f*OmS9&yD_REi6X~%|$&r7}Xoi;IoO(%+5Pa%-=R$%@LEmtG-N(w+F<0
zZA0V$6TBbsW<%dny@PqWO&26;8bZv?Pj14J@}+@A{x{XA3BSj_z$X7ru8wN3-S#&P
zU_-DR1bc8FzQ*R52eGqL0zSZV+v~;y|1t;TKlq7eS9u2E7x6w2(J_&HIwlb{+ct{g
zV2}Em6pm^}_2UOOaPMM-aJ)`#D<UY+JdcZuLKAQN^~HF0OjleTHlU}z6rhB2-?ap<
z0kA-k^auDMtNAMv_Li4Gn|0K~i{mU0@AW1p?I+#)9_|l}habwAXK247{r2<wZ+-oi
zp{p;+9^4HZM!1ZLCS*bw2@Q3{ak<|-e=i!E$q_EuQD($J#}~sh%!?$Ago*JGL)vR9
z?=%@(<fk4ueh~OYzYz{_|3}zC7GwmEKyH_<Vq;uArbWQ^1~B^ln|Y7HJMSpJSn!7*
z&9@veh{y2HjR{Nd85cU?DXRwy#Qh=epAM2jM`=Ddj}T2wRzXDmFP6s|EGJ^=-+E(M
zup;p_r$dz_kspc81#AlsCk%LW%XzXc5Vp_%jfB~KctBnVT2CTf!u~U&4P9U;xf^o;
zcef&(JX}+Bhh){-<sA*O|K+5IJDE1)@?vJO{+IkuaVf$8#zcXWzFWqWBaDc}#Q2GM
zJ@83~-Gak++%**c{%it0dOrPHUr-y(JWL3?hse<k5$Ft;rZ(65E+kKrnp@uqXUx-E
zE+gVIOW6@2qAnN8srg{ri_aUaxQ-I3V2h$GGGZp<U=@0X+4?&YSzek$M$8o?xRg)8
zd%Zv>V0pWN{Xk+CqfRi3fui8xuBD-wVY0gO-}rtXpQ<(L+7J`k04wc7+ICd}!`{?@
z`Talt`2B)bKxW88zF&gvt<<O9k<1A@sQYZ-hMoQi?=NG7TsFhHgl;Y)2yr?A6Hp@k
z41^Q>@9?LGo465p4zca;$$9bcBK^<z0#5;k9y+1jhL=QgbHj=FfR>%ESsEi15#lgY
z-*s4u;%IU+BRBZJF6AVp=Elacp^>!lIiP4Z4Ts+~O9I1O5MdiS0Gsr}Mf7Rs4r|CB
z-zIg6t^EfF)?c`J5HxR@W5>r0y&w44p>~z_q`pxf-u%OgmSG2je>i~ML=WfpzyJ7C
zESi<$b`*FzX8~Wj|L|0|kwNqG@0k3N@xX-L=*zIzI14rnbx*#`J`|`EPe;9g7tfD-
zA{xMlWO9{ZyX=bm2kL>595a!^t6{s`f8E8ryEIs%e>L!j<1{2SR00<I5BLtEf%BhK
z4SM0~V3XiNq;5NMXy=0u8$46djEM+hJV%J}9wWqfj}hWLM~LL$wi<(g>q>wH%E4i^
zaF2plLaD=c$T>X9*c@e{`UCY(@e?`<PrxwY2P0}n=6+pgisY7rzlfG26%m>uE6tIX
zkLAOBA&C{iBiIi$;2`aCJN_O^IdAxpoNUyv*_5_I23*LAS_p|+9f4vrrw-`1_JJ+A
zNH}i)Zw6wcKLxueMHC>B$Zz8iBxeLWD1*$sjhdDZHR$NAf+>g>T;4`VjFV9fEYC8>
z_h66xc!)~S9En;8w8$T_mc$7Y$_aQTXD)!`C1?lK)5?4PU}$xM{Ay=Y1Vjlp02dt5
zCytQa(8uooY(SBG44g{SD)mP1fN|z2lebqR8Z-bOGnpY*?nnFWganK88=uevC?ZQT
z{*L<uMB&8e=Ewc88|280q0*WD`(XhgA0}fS>udkCQ>W>EU~En`ag7N7|F7^v$%Mu$
z207mNPo5pp@qBn7M&8nh?`3l0J{E^df=Ab|MNMZxLtcfUs6Da&;G?L#0M(X!ht=RD
zUkmJNs$fI1FO9-_IUnYr1hqFo%hT}Gz>lzPRWKv$2M*Dx@30@a^VAGhDq0`)#Y8$l
zZ{t0=yGQoL^ab#HQ1gKQ7yP(BjG6OV0P<cTmkGdu{0_c8(j}xTy$zrd#*&6`rVzdn
z$H1U3${;bYg0IW#n;Qv111B^upg-<jClWq~IsrH3<Ve@-&i_IG`+&pypYYF@mp7S*
z&9`&Jd_??I0K)Q{Mh3-UpGFYmGAZ^$gVbjcB0=?W_&Af6nSK}nGL~EXL}jQFC7a+L
z&0MCxoM$qYAIznfPo3HZJmylw1Zg@$z$9|Z4*-!%E#tr>Q_BWYDHRs)`M<=*Q#YG3
zjB?2qgb@B^EIy1mVf10k53?y@_GK+wZo4SVGs}KI4D!SAhb{Psn8+Us!>{s>L^`A(
z{OtJ5eaXZpeGbuXe@Pi<(*5>y@(ys{NwIG4d{koq1oFl;j&hC56#TpVB_Px_rIhQ7
z^e1(E0fD6oR_*lt{mFm$&MK8cnK9)+L&J0N!YvLwS`Yacwm=5~M;rZ*&88Rtii9Qw
z7NH}S0|MdCO7;ZBgH8eyiAKirm2^45yt5qn>jwKY$%_TP|HQ^bcEB7szucn|Y&G@q
z#Pnn+p=Q_d=@H8igQo@4L$A>h31L<J;{gN_6v~CL3~Q`gyzznnKuJuG{-fP$=_5V_
zf6nnTBX0`g|J);<&?OO7YTw|)#6pmKnvP6w)AsEdIy7hRz$YOp#JxEIV*N7nAoD#$
zl;hHMkGIQ2b1`fE`Y1`CIz&7d|Avlo-@YH18dm?`!Zpp@)Z!%MjI>|ji6M{8hWUXD
zf6mFp`LH*sI7>XZhb#>PG5v7%Iwv@1SfiP$0fo~$n%2gUEIQ8r_=vJcsDSamETCD>
zHvZx#&8>SY_j#+~T-eywG%_^D#&REzNN8a;M<AX8EYLZh+Q1Mu4t8sBQvAP!t#BL4
zUbrry({PJ`Xxkv#8b%&V-W7=v@LNV6ZUbw)_;m(QXen2AoxbVb|K{+)0q2hJ&Bi0O
zpYWAJY_TIWH-FE`i1@q`J%CK|^bOmRL-neaE!kPWo_C7SClQ~&HzziV<%rLTE&wh(
z(kBL_HSORKZxJ2MngOdL>Ep9Om9`&jKj4Gac7T}r`vH^i_DCU*MN>a<d`491hZqn1
zXJg<Dt$hg8<$nFY6E^|-i^je7(&hC85T664R~CL>T`OD_L+D$V)A$oTf&XRvAld;P
zhl#%XhtOb#eg?vP+&Z6uP!jkl@a#FJ1`u!+6ClAnWDras<LzAD1YbaPr;hLjJ^qAG
z07bq7d6bP0iJmd90Ap+Td^~JwBbOSMzkIwFN?KPmxoWt`qc@D>X>>IKcc=h-G`r5(
z#sC`Qo)eD+PZ%}_U;?ri-ek!*i<9y37>-?TPCj@V@0M}d$XU!>Mk5j`GoH|ZA&8S8
zJ?CswdbpD6(}MyAXz=A?S8_iPQ=7Z-5@IV67s+V5`L;%zQgII~OBlRtlFJ=HO}$;_
z)B(QzTfheU`mCR_tA9g&R(^^NYN3?sKgPgEUXAUO>{WEse^FJhU~qk?XWGaF!Oc*2
z*Z~Y!_KVV7J68%ELo4Is2)M|f;%Mq8bO4`jP<_pP-X9y;-ba7&_nZL}+5^*5-@t(K
z1Jknv7sQRA3I8td>?QXfvK{3vBbmGUxsP`$*%pi+2yxiWXgDZPqCbSMK8<_{1b9co
zk7GlL-~bYg8vlsL!+=$R0P>$YMg4PSh$8W^P3=*yUOR_jv`rWjpb|PZrD9%R$ZUn3
z{zFfKdVnU}bbsX=#FY#Gay)c*%i|*SRn{PCH1FP#`O>dA37-GI|7dj2N9FOk-FL10
zoMdu;1vIeDHL?R6EsVrRKm$(r>42;HO3st+PZ!@`FO5cco~VKRJ#fbeSs;+vz-$(D
zT77G#T6kNN8peg;4<5I6n&&l!zhmMf_MU>tfOq@~b3hz%y@6e#{lIE@0q{Sk@ey!4
z-<y5}YsY>Gmm%h$&j7hj0}J{%bI((8yG%s9*Ne4bo;x%R2EefL!^z!4i!d~T6V1u3
zd?{!%#sEkzr8=x5qcanV&JMy${aI4h*w{f=XxL@(*wDxuvoOLG=|lRM=(m?7@P(>Z
zZhV^$2!1l6*USFswq>Z)J9eE`O@0b;ATiaL4S(Y>7P=qE0lm=ZuJr@~{d5CxEYQ*c
z9%$TT(ubscHx=2uMflGbm;mWBh-{6cQGz#J`H?#@Z1u)_6K(+U`TZCYp}@c*ev_|3
zox+=u(!Le^A@<0J(EsU9Xbx=pTo5ukY)1$!@JkP`;aX+<K8BH|DHn@`ebCTvVO%(h
zknkjC;G-Qb%rgCM1{3;wd=l}J6NQ3)D<sg{KS-Yl_&~|9oq#|?eHz{ZKcGKoZ`CaU
z|A@em`1eo+@47YogMq5Q5B@7!Qvb_sWHk8xEYq$x0!O?0==awe=&KP47sWAnE90QL
zrlNz^LyIP)`mi(D;yw2@nw2Lc#1mQb@e*C<kMVgXM2*8`q!HbG5MYnP`2sc%;FNN#
z2ucKhM{*&$H;IjvVUCU}upwvo-`q!!W>;7E*~L}_EA12CXB~TtNFd<car%HWY4r8%
z0PfC>bdmMpDyrG&_YX$N;R}{8BuC|v$$5Er(<fl=T@}g8nVFdv$*kCf5~&lqzr;Z-
zN|&jfBuA&4!0Qp~TmVyL84w0=%6&Y)5pdl?_L;N(6vR|S+_79m<e1KmF%!*zkA1cT
zp3W0Y==Yz6H2{UHt-79<s)uQ~(~Zx33)Fo1=hFM#*ctoH#$U_fA1p0j4l&UwYcP$P
z#!!AUffHHU@$D=(XI3D8GVJ59*Pr|);3;p$)$OMDHr}IAk^npOzs@%uARnk>=qsJ0
zd;2=q2u>Idm#zpqKo>E{{SvSQI**a~oB-d)Bk+{`*1*0pTy2j>YgECO4L{-_1bVFL
zAN^#<cZ1_s_wm{8-{UvlWZ(P1w*Q=6N@U0_PVtA4@%KeJkAzKdAL09w{~4dr?I`dO
zKTrQ$=75}YU!NLM^&m8G=jTtw)(lL+t$7KNmt+Qvo8mBy-__RWYsQW1i@68!)>qUa
zFAmS4qyL875$<}w|BlNJk;`A^+#}+APPiq6ylBfvo`rV4#qoX_<3bh?Ml3N&8pn+A
zOzHfAH__8k4W%0L3&sT~XY;@It^1kYs6X_B{Qh<MBXPdl;xWv+ogbfw`KFrOoS4Mr
z%=oOHu?^DAy#^^`_{qmq1nGxe$@$vA8{_1DZn~?;4O-?0U6Rrx1E33fIUlMM7XIOb
zUjOsI69B%AAFjp5-Z&;XPaU55JErH&a^qC*i_P+=q5ak6f5hIji3^S7rb%DRAC(qS
zR1?7#z)S!C1KaK)<d4Kc@feIn#E5wxWG9<d0C#RcZFKnBhOVFpcYJY7-5)%|>YGvi
z`Okj(%k=T4Zh-!Ijh{caTfK0UaD4X9{|MA%W`I(t-=+V$)k+{h%*{vZm;{qOLH`|T
z_fIDG@{FGA@pa(I)+6B>tN`Cx@_D&x0Vg^}YyfYp={(sMnR~{@-`sb^I02|KM(f*b
zmy?0NqV~Vdgz9`iLe`J|pvDgs2k%$oY9B9%40Id8B~@T-Mlp(5f7Yq`2dI@Q!1S=>
zeisJ#zE|>?5G>Ds;wI?}SebdPpPR+}5Nd22GM0z(0Sj0A!8URseqb;Q<xet4Z|t9R
zyIgqrSRntxQWJM<gwc7t2Hsuve}U>u_{j$20kb9?++$E1AoQ?kMfhz`Y>mkJ$4Yia
z)U~Jhxfo?55&X*8zJYuP>bcE+6pt?wH&2_z^LR~~&lkjx#o~J@<^m?->86g1wGDOu
zj^Wf-iK3^}5qQF2Rj9z#i!M7+mT&*Kf%FG~NE*9u{c#rZUU^B$Zyhu6mQ@q>)j2p$
zcxMqjHbmx(=jGMHcAMOi{Jd)zj%@k)WQF7TE;YaApAViR3`AjGDm6|0CWkDq;Dcce
zP$0KQ;pPI0>F5(}0S;no=P+9{cQBl6qWt%M@793>^Cm7m7yE#~F6BJv{;rdI`k0f4
zVG|RAYF00($&ByM^@d(hx{RhefACS&U=g+G|3Cv9SF8I?Dy$DmUkYFlz3KlT2wO-0
z1Ira)deh4lV0zFvIs5EoV1KGd!DK2%P5a>egK?ZVh@UPXCD{ApVTeIU;RQew(8vke
z;=LL%=+Ih6ywo9ot@xuZeM9$<7LZ<b-s&&k=I~jODl~@wjjSgl-g(X$*X-E=8m$3*
zX!U@Oy#YIb4X;e}4B1rN)9Ih92Fz8UnsR!7xY2_LCxzTep1HK!MdCR!P*{9Tax*l~
zHt+m@h}Z@$(PJ}fn2qb5zCVOI9X_MZFTpb@9I2!HU38&0r{m)IDW#&q5qxBc;ND!1
z$l@aTsMa*lsiVd8d1XyFe>4ZVqZ2O&{VdXcXmP7I(!at!5j@jJmKf;Ca^Y0d*MYD8
zJBv5S^3$0HJCSEr*zQ||+wl-0Q;VjU=+3xaN7VM9YIyx|IT>$bF0kH^oZ6=*Ad#%u
z9elYVh~YX~Nog(->;@kHH~0|A;|I|<lRq8OHR5(lo|uj=%LGSz1O<mp!`Y{SGjmG0
zY1*ARS$V!OII!v`-~K+x5E^4Z^A{A5wg)OUtTdcm+SiCLE=kAvj_(Kq=D~oZ9>|UP
ze~f@fzd^g^e@dCH!JV?H?~p%l*n5}TV|lKf9@pQlJBW?R`E&4}NpaDNt0l=ZIr)3H
zwoY9!tQQ}fj2kjy0(E6XHKi<Y*i1l)w;IzdQSg|7TSv@tSHyDCF&`0e`@aO3i0F?I
zmz#!9z-5}R9vG^sBqQn-Q4IYvQ4?_NDaztzzJ6^~3BJC^f(>BGVH}1dgIJsLr=A~I
z=T*lYt{mTAt|nyxCp>R%HAb*bD;mp(o#m`oU%9^8`rseJc1t`D2FCM@{Jw99-yIKb
zf0_oB*)n&+Unb<zZ{jUoEZ08?($19tv%|qBP$&EZ!0&?3HYi%6mwb{w-G*<NkVTEf
zT$)RNEbv@jA`LMUL}uZSHYf=<pg$N(^arG<a!3hNi^Fj(|A%nd7zlTx^c^21cJvfZ
z+N@7{FUTFTbu0)-{-0%c@#-6s+H~&s9skGszj1<e5MM(K)+v9NbNc435Cku(|2(>n
zXr`iO?e;Ej0Uq?c<Hq<1_oO=@i9yyBWmpo(>t)yxw2uFAS*f_qinZSFyGw<cRh$q9
z{~6pse^;TI)1G((v(iJL0)Blb0HGHH18sON`>y(OM7&&vhMFYl3D`aB*9cDmq1o>9
z!4!Tm@%*DAcZ!=QOMT|_Cx{oHP*jS=DRBNH=BmI<cSruK#`x9?BPCxqk1TGXY13e&
z#~o{6gN@JeJlerGm$>n`>{USuVUq_8*DAohjm>M9fQ7z4U>ntrBdV-%XPV!iI?fLS
z@1Mf|@vwfp1TE_K`|t;IsB=ICSy|Nnsd1YBaX8?dKYddw!J-)*1?S|f%u5l2Ttxm}
z2t41L6eMqe{}Bn}NOkpHy)OvyKL5kDB06ylAc4o?tTE6^|A|}QX#T!}{yd|pU`CJW
zBpaqK5Zp_3-X8Omf9s9bq27T4<UicNf8Sf$gOk92Ko9NJy#XV-gF8=;?EKM#e$7?C
z8Bq2`ZHxrr6O4oZ5%?s)lkgxDwQwKL0(D2f3w$Yo9_`d*gPFQV&&+7Mqu)Ah$Z`Gd
zu>ChAeEiSj%lE<mn}APWtL|(*C*Q&r6JQa24m?MzKSXZ^nYQh5n$$i}5X!G5NHeMk
zkqI+Dx*{WH;TZ*<JZ}3?{Qdy%Izy}hx6tEA+s1*tO90;bkJ2+Y{ASAh*+Rz1e|)M6
z@WO`#Pru~lxc~!m@sq(6@X;1rH{+R&Hs?v=D~j={t7YP5o~ENu&n=yL_>YMfIi$1_
zN&&aX(|A+EH(E9`{{xgp^$;JLn0#*b!WK%3X_~web>3?lk`LzA)f)b5|GRJB4p6m@
zGI{(@9~{mjH)E3yu9EWG0|qh;2l(E2?bxs-6+^55?{yn$7XIN?5rFP~peG!)du)GM
z$M?&C#dyL#|C^gOUlA7?_vfw-IXKiqGsN&UscEVHA~%I_BK@O;ZwfuNTL030;3@C+
z?Nxd2{vvHS0h@m;-Q#wYGi47b44!of`a`|yfQ($b98CnPs0j2n|3F;pD{$ERJMsU)
zf-jhGG82FN64NgFKf8RaMO;0tMg{#(Hf_GzsBin!q#gvwXcBL)ax6BG%?J31??&(l
z1mev5>InqYU~e`?#pjXt*!vdr1nq#LV|~2Md)E6igpVd7PD`S>xwvn@eYHF#<1HuM
zCQALH`yaqfPeH`-r8&BaV0W0c;w?r4UQ5u#pA6LTmtQ0UChYS-*$J@xOlD=Y$})VA
z8kBw)gxI`;X1od9MbScj4RJxdKvo?{#ZWZ=j{3uXQ#K3i&tGq2*&<j(-cB#7>e2X)
zeBTW43SuCy5g*AJ*F?I37T5axbytwiXyO@)sC8KXx2FE~#gqHy<E>SD5sBovAvl1n
zAzalC@&`J=<}<2y`QvaV{cI99XaJf=(VIn_kN3{|@ZM)E(mm&&LjIX=sYgJ8{QmX`
zA3weS_|Ll{OY)K_IrF-!;b>>Lgz*8xttM<S)E?umKXd;bRe2%47X1Hzgy)9m5EZ#`
z5^`2%YlxJM=g5D!#97=&H)s$&zmFFJFUFpUD<eH*Z)>qV*^&S8+}P${%Vodijc?%U
zBl1aT|8Wys<|KrFai4rwCHL~r4VQvSg=3-t3twHZeND<fcrkoCj0}MTCJJVDl<R|-
z&ZFnd_J9gcx^EFp=^pc^-xGcQ&hU*CVOPXlfcgFJ{cu506LX{Us053t1j&ncVu2_<
z4!8nk^qd98Z1x@(dEb1n7~U{~u*1jx@HdV*e|6ro!@_=eR>+){e~6!(Tk#TdR{s|q
z@~pTG*c-FjRjKgp2HD;Meg9i<0~x>2ow>McD@pD>Gr@h!+#VXDn_T=PQUiC4sR!dc
za}0!dPCtkl{4~@IOEF;PMsm6L-#;k@3v&)7JAm1M;s1NQOhncOEq++F!R$xigO(sg
zc{qS5@mnhJ0%w)5<$5wZ_&7bUuBnB$H1WsU$=Ip>CMIJ|Y9RF(9U6hi{T?8)GfqE}
zRuNfvDb$c$U}(RUzP9`LQ8j=(_C}0z>bTyjpeF8*eE}fxwMZIo`XEhoeu@D#)P5w~
z(*hoen*z-p_xOg8!Uj-*fBUXB&qwz*Bkxl}5Rof4CTGfj{BPrd1YF5OR#^q7gsq_g
zG2=o;+CIA1@06TlVTJ$VA~<3a3>#Pl^ilG3k~{RU%<n;W0tf#_=>2y>$LLPy{2fGy
z2;2o0neSi;SxgSQ3cvREKx<yvdKR~CHTDc={B8Et0so1Ep4vJlfE~`Gde#C(ssi=`
z5v$EXVeA*z;E$h6M^K`q|8PU)=bnY!C&@a1%rgzN@tKTd7tyGpi%<!#q~U-n{}F%t
zlPek<zq|d*GoSMJT^ESTl?7qMj(oU?P9uCLR2ivbpt2J)?)i7Z5%5sk&JYc%j}2L?
z1p8py5fj3;H3NnHKx1V+z+&AaJ!(;e8|DA^8X3Fz{2@Or_dhk!J1+=PQbf}wq*>2?
zTC;vTLp&10%P1@>7;Cv3-JSP}PHc>>8N_h{Asj^5iTS#!;(TQ=G?==`83j0t#1l@K
zSA^$+E;2LPkR=FV&o?$1`JgfNAR*V_r-EL9%)meIQMk+vnM(<MOj^2O$9>>>OgQ~m
z5$G5q_yat?Ty}6U-|4tUc{xAL%1G7-JGoNgIk{=X{$6Wm;VGMLYvtzEvPThw`7<+2
zoL)5$X<v6QeN^!nAK(B0M$<u>ph^$%_QDnn5yj9csfXYwxbKAH0AMWy2Xn!I>;zsW
z+8Z07ENVN#JxKbVaElL#=8Vhqyu6+XxW5liD8ZtC;_X@iBUFRjzB=OhOqgKLp}DBz
zUJ{dP$*ol{CykzbWH^z`?@eD;ZlU%*fjev+W)?k!kLeEIP(XJX{lWb*Y5)PoFmc?`
zy=QB}T{j^FVSF*o*{DN@vj6~I0ONuXB|XnOW|jA^ph3o;`>$V_B5{13kj|d$%3{-4
zj%}Nd`^D8?N9KI_dPSI0BR2|oyJ5##61P<FUT}$tNIOV^)L-XM1?PRwO~7&Q_aL-;
z&pc*xFU9p!GgJz{i`FjC3BSj_z#8-*>K}G^e|qU`1$UUt!wr8Aw>)Pwtfr`5B5?wN
zB59oTf<9f_Dv?--NH72Ylk{H+WroP6FTPFYL*qFhz-H+{8v(XJZ$NTFxT+^I{lnXz
z<l0EI@Sf5%aq9W;5xj4Uwj1&EK)ODDsAn=kXlIxV4|O{CZ@=9GFMrS>vbuL`?`u2H
zR(1RoXVdJ#K92|`!NjS+>L1{)pc8(l3;}1M#%zD@7)sCf)Cj);>}Y;mNt+)yIPmpZ
zfv*G@MA#N+Fz&ej$74c22AX(QZafg5AB)C{za50F(Pc%4y=D}*pFG=dKJ%_OmffM4
z)yt9?E5t@(D-kz0n*3g`(n$Q&1sJAIPMiCUng7S~L4oqgwA^xJ2%J@KnqQW)#YDt@
zU7?>t5yZfe_<yf>3Nfe(xB4&qG0lq_8AGt)G0I=z3CCjicN!UiH;>hqPyp09eoyaF
zz;XX?geM<K|HV}apN0`I9$FT~{B~@>QR;ql@LqeN>2-DExhY(`<)oR+U|vjPFX2Bd
z_U-Wy=LyQouQ7{4;xMKVz8LBRk3;*IT@MO@dsBj5dj3uuOuQjUfJU0oIx*2JP2p;F
zGdDDh)4nTYG+}6n>r@NElot%MEk>%AR1V=626>_3p)w4o^}N${r(O~8<6Mv}f;yHN
zzS-Is|G8vMR5I&|?oT{--dEyy?YWYVO<gHg)2>N%Kg(gJnGG9-aqyb<yxp|8D^Y9h
zmw$Bxqei(Th4;JyT#=c5{9I=`7s+s6h?|7^N9~7Zfq+6U@1w@>;sI)G%flNNvCV7i
zrJRx8_KZ{=GQOEpA3fye@s(Z4`{92G_FyG=Rgg8O{wxSjugT$*;&{k=?FID^7+-|#
zvF)}S@DXlnti#fh(eFM0{6(N4dOhby6YqY;Rp_4)L_In^J6n14_)f`py>d*+W3Fv$
z<2Ip~3Ii?ffK1w~D>s08UQ39R7bbcK_J)TKjP}FPBm`{)Nbc%uKxd8c=146uDL(GD
zgcEpsUhn>c!XLZpxjEv`%SAj11<m8hk$hI0rE0z>QS7*ra)bgJ#7~HaxwdoXgn4dZ
zh-p4v@(cbhIMs%^W-?!&C<xrRWxLsC=JB)7jlxC;;3NbAxUyS<^ZVmqBWgfR*Y;JN
zw!lsLKQ?jU?(hB`*MUc!P$gleSW0$B)Z@S={YTk=vphFPYw?t1^~s2?Z0=Q~Cyv>&
z8OU^G`2HVUmOQ5lbj#EHeULL@T+r87y!Sh-V?A?ehqpi8V<g|gK4^15(BXaAJ5q0m
zy7?jU@K-gTkK+L{WcO&nizS+BrM#wmUH<vx|Kj#coNTbTkMhY2q`4=8**;!rv+;EE
zLOLQk=GsWK@pIk<DI=QvT*R|WNQQ~cusFy77!dIn!gibEx_>X4WP!Q3)Ye`j0x&=n
z6+<3pu$Pe<7SHh>0lcDFC0r${IicPnUgqvi-!BJjUvoke%ffm_Ib}t4$(kGH?EyFM
zqsMqep!rfzhmo~*6Z}Fp58$h?g0+SC=yxqc)P+>mjzafS8O_DyhE4t=WUt+PXZ%d^
zOjV~t4Z8bWk)nV?K98Q|pn>kE#_k!bK>@7_B;NB&fsV)ZjSGXd@cJZw@PzUH6qwst
zPH_d}Ym=5YJ2}$6Xw;EH__|1;I|2n}Z3~+j>-Zz&KRmp#4&exE5icdF;5itgGIDXL
zukXXFx!xlAYJ+<3$tA^UO2s<93pF=XGF`QxY-J_jLc_ul(ZQNvCs+#4Din4}gbWs&
zg~jpn!Fop~!(%3hTP4C;Mmf<W*PF5;elx){%fJb|y~?%`tbJqob{<Q|KWE}D4LvR7
z{{OBK$`C^u@dK9)%tMH`v{+xPhJ6dG;VUB?FMJ<=Ey$9~#dz_xJA3XpXVvoTnLnF9
zTYP>1M}R+H51^Lz68H~fd`=kPL5Jn0N&wJ5M)CTD0qK4(BzmHgn`$?oi-wYIc2i+n
zq&{yl4R;ZMON4ACffwK%iX1z3fj6EsCfHJC3LNG<I~)}CxN%zi<KXUN-CnM`_#}Lt
zf5Lr|uZ@2myGUjt62wC|mt$<oGU7f<Je-_QWV6FqkGm;P*DpK~E@{~7j@puQ$0qM5
zG-zfH(JQ9Asw7_@I6y3;pl}W|iO&=QA(LMEULUj&1oCO1m`c(3;K8_wv%lByC*J?Z
zm%foF<&?`=c!|UZDkKnb(sCM?8QTo+0pbZ>2t_miK5&4Bu`Jjd5zKd-7#_Oe91(d%
z2e!l!=)asL!;~1@0qA}i(P8gb)w}Lre()ZTo_E?an>}!kG7-0)SqJN*#@hGK+&!pa
zz6Y)@%YJL}=74;jU2<D)*}0|NhWOslLdq~i5w#1{Pe6Zl-&VpFV{Usw7o*=l-(Y2D
zUxyR94o>g<5NVDMONTD-Bg1`?>I37`^gFA#APw|ddi<g?x2y5Diu@Bi^DfvX^7kMk
z+&>Ny_6Fik(X#94sTcBaK>T{}tR-mmVY?&hJJ;X3jysb0B>9IQ{1f@HRn{HSkUW2y
zO1yRuvO~*94|g9@%YV|WGwSJlC(30uR@HLPhs;(GgmDnwB3?=>$=q;qZ-WE#cu3CR
z-SMZ_<j)L7B2M-@u1VvMj$aesDMAUiFEpq|22C#rL)~o@0kAyCh6YFo!w!T5Eu(*5
z1(gI3Lj+A67zN!g{nTqK=4ziqPDs9wdC%=%LVzY7_=_+4;=Ix(`sAd8mcB1HzHGj3
zpku*W@P<JG#|IdQfi_9BQqE)L;EAJZ(MojOeJnK8_hlHh_(u)$U<}kfy~nq|8>ZxK
z<~Vy(!;8HT?mmoG;l(CuPGiTqoI&4p`5FYXnf>c>@t@zvM@Jn_)LeP!ecrG{>W}Zj
z{%nWQO+b(HrEVvtKf^cS@TOS=kB^ek?=yX~=N%mMUSgdJ&!KM&w|kE*ymZULGj<|L
z3NE^7Ybc4yLva{K5f|NOQ9l*gEbyR-#7!`@uUJape}pfL&}s=h&TUa)gfx+WceoG>
zzyPCJYR89oKt|##l6VaYds03sJDpluk4|`ZH)!AASa%W#-lzJJ`D!3wHTKp)XumvU
zrTFVebvi%7cTsb)PSu?jbVcN!`r^FNWqEnHN2idOLpt$wP@CL-18A}WC*xRT!<#No
zKgVN70P1zu5e_6m4FAvBy%*D?y4N4Kj2wA4bdV@-cB-(f@e}d(j1|xwE)y`N6XY>*
zqi=g&JBdFR?5)F!meBd0<~=U^68^b4k2yQcrc>~$k{|!i%ZQJN)*>F|$$y))(fMJ`
z*}emlCgbR<q7Clew81yP(JmHnfIbk86>0zja0Q|viS3hzU;IZjjF&DPci$KYGCb(q
zUyli+85@=BggEJR`C8G3=u*&jJiL>^2RY9-Q1iO+-Z*wOgBBk820vEyMdpwb?w;t6
zz-@PDnd<TUV=wXZZ{tagAB1yw68!-m?~Q;50#C*JEG{wyTJ`4Ik=||r*L4Yr>hXO?
zu+JE6($GHy5qz@aUicx4j@XY4aKGUmNI;j=$-YqiN%RBSB4GnSX>SPQhjjoU&`(ep
zKdZHn8W%>xp}&RO#Lf0S`@VcfntpS0I(`$I55NHp`V-Nk+v6&IBn<ct$hzN^^zwJi
zB6^LzdB<Qd>!>ri0#~G0kkWY1f>)VfBk=u^V_#v$;eh88mE<L6LAjJL!jL|nAMW_B
zIPv5mWTb66jPtqlm{C9{dg8l({{fiTLGtY`oZLs?qOj_Cskr&0IIZO2E=_rn1b7vn
zlak5xh=Wc{bg~;ZwjLsqeb6gcE`Dz;P086Q_>6Z%s}O5`ZRy?lJ0b`VmbnB6%fhM+
z^HD29(_SxHs40-Kyg@gA%|&(+;Vqesam<Wo@SJJ&0;|mx!ZCpapRJ%8Khh7Ye*#ZK
zpP&X-?}s$R_+d=Acr5_qKpel`JML=q{;%*;-ye(`@FUF{BS2pb&KI{ugmoisUdO~?
zAA(VYU(#Rb@%#wd+E4nLU#Fk=h>Zt<Bais0zj*$BNrMDEmi{8w0;)Y<kpL#>1&;~X
zEYC|~5`2S^QBYsSz(muK?=SEXwV)y~Y`QE<aQtRI%*PDacZ$>y+t)apT%njpXTF~e
z&)NQWa0|pgkD<Y-KB4|Q#&FK;Vnb{_oW}KG|K%w=$@CbFsB!a4piz7*sYDi!d5wbp
zcJ77y$s0Z6bXdRx{uAQ{+F6+RLwE5$ZW4?fu~5l`SRWl|Bw@V)9%`&h{lC9K%h}iM
zK5H4-Ve6L;Hy;r%P4O^}G;j`H<1<9oYzY{qz>f$0r)>AKX4|uW?Rd<M?w|J!(Gz$h
zX`W%Lhh3CWo+IH8n}w;Lh`w3g_-Y_TBZ!+3KQBD1gyS*2L8j(1GWn37mPlDIgm$BX
z5`%{P5#hZJ?OGf~Usi4qHiyD|2%pr8^FeA~rHu|<L|x4TLwqB$A00}whit2i^apRu
zoK*#Jytz$|mc9_8<}q9<suK`yV_b}|$M-O5HXvK%%|F61yyBxOL`JOp0cyt3jj5-E
zFaFkEz<n4V475(Ya`;D#Ut1D_4JVqG217sU4iE0D0jU>JPk;D~U_*vpgH10<%mljm
zKkAmr;UNEW#s2@k3Oqdh<E@Ty68H#d_u}momSQ2sTlgr$2lUHA({m7}AmU|)p>h9<
zj+uGyjObn?Ll)Gi029(KvoxjWU`^-6@4RFnZ-D=AT?}qp-VtzdFh+eY^}DkcE4U1K
z_nqbUbA9-$EW!e45p-z+Hky7B#o(s|I$VJcmn$g+ZKJ;QA7#K^+m0em5am9|Yd5ov
z3^Ew@mme<qxZs?q5Q!=f$Tpqvnw%q@eYa`|+GktB0`6<x2*A_`+PAGj1Mlt;=NG_R
z$9$BO_h5mpZdjFX9puwR`!3_6FqR|4LmYlQGU$BS934xu-`5wO8Y`eb3Cd>XLUgp|
z<MYGV3=w!}Kyj+I>cF~Q@bQpM=ZqC~S-mT^R^$7jfBzrFH3Tg-z?gXaZa@P3WuQRP
z^)OYM${4-P2PupE4N3q1?HD*=80t3>o*5xL40FbI%}2VE9Lj|hht8ISxXj)%AwfH)
zuMB1x$L-1}>yFom?w2n)Evj`8d<O@uJaoKukYu`CBv+(g-K1^P^2QCFBuk3OAXt_R
zHrm=BjP;v@FV(-O${j=o`~i&L@ZmxBU=_Zv)BpWT*Azb;@hjQa+yUC@^kE+8|5A|f
z=&RQp9+<%25BI@GfHrHhDbUtlHuFxb<%(tCvxGjTS_mRIR?PnB=f2ecx4}*Xt#1uA
zeLv;YGlWg7$#2XHD?1+($18o*tYfPFc%KsyF_7vT!|K9AKdZtWKzJ*SWj(3Q1PDH4
zTD*S);^bfR;6P5+bT?PPmiUN3-7MXio4Lm9|1&poKF{^A+eWMhtHxkT^aQwy@DXj5
z!qrE@4SCqtO~y*_fw}{J?f%?7pglCd!aYNYOz=VS{y>{@AHs8IJ|ndO{*Uj*Q4*0T
z919Pk$s7<(|Ls6L4IGq{lI1^7!hNyq+MtzjI9JfsKNYnE4-nO`a~2Oh;XR`~FA0Mu
zivx3*`D<7OdgPYonF#xvFzXQ+5rnZ2-wDS@Wm&{dBaaNrgy;@wEXo-xi8m&SI^E(U
zs|bTdxvwE#dS}3|AMJazWJnE3vGVxgn}k0fkH&O7p1`h);__0Cqpb?e{nU8UbLzwk
z#m4T=U;)}+BxG4YczJOATr{8M3_H%@OaLZ1=I}@9S>rsp0x!-0k8l$iN2)w%1KN55
zbpki&tJ(*sVY%P`cmuf4ps-nfxMRUCz<Wc(F^3R!2NjP>KcgFK;HQE=j`+=>3BPsI
zL)Kn)sJ@Hre{a19pIPJQ8Ow&R@%~EThMhLQ$JVn@UG4l3HhoBd+NbE8U&YnN5F0S}
znD+-GHZ#jynR<I*7pkOwEq~z+m{TjTKPkckRe_yI?JOt3=|F^d#{x#+I>(OiC;SA+
z4xrdJ9c1>8-TB5r;qYgwJM@h2RbTs{!T7sp3?smVQkV=O6#5s$RxuviYNUw|#PH3T
z<=t{)A_uF+cr(jd7Pa99i(cM?W7ftzpYWWkH804bxci5YrrO63LYdHs2Y`MMt_>I-
zIX8D5E{yZJj{C+49g`6+d~hJRHst7yi-h}-Kw8NI@<|DBWZY~;a#;-UM7bfPT0~M4
zTr+sM?yV2nWGay6EX=?_9~rd`$qeEG);O5lHuwT=(EpbsdzS2c0&n_tyT@+eNZr1m
zBi=tb!_)*ZTNe+25S?G~?&0Ifj9*9BH-z76@@A6+Zp-2!BZ^Dk(A45|H3`Ypc#pYb
zAJ0A@y;Pi)?*lgnOy|LLjqoVFh(^H(9d1dI!p#23zF!cxmHv9;^L+joe{g@P{1)Ig
zF3$S60$6HH)WvOFgB`Z^uB!ezz=Kl#=MgFkFSfPE&X=w$$IM}~8A$PVW|dfp67S(G
z%n-$}8{6&S3Y?cETgiyLNu;4pWyDR0n-L20K_k=1qcjX}i+u5NjL=b<2VM@m1pi#m
zCn$dD0jd5xToU<*A&*OV#%dI1fcBaTUJktS$}>T$y{PNT?vUI>M>Q4H{6yBkMKNnC
zlTp^9HNrj{O6A8#SV+$Bm!KtF?VRlI#&yh{ni|k?iZI~;eHd~KrJw*8-gs+@t>Ulm
zoIth&d-NaQFCDJ<?%+U?>-+*e0sG<NCDtd0;yu83_|XU;wZSG4cUmYw9op}X;T{JC
zxB(fQ|78aOPalXb#u<}_ZZpCJ{yJ96lx{6Z(v=SZmt|s92A}XpOo>A<eOpXgxc(z~
z1ke+sHS;HOEhBwrNN^yPr2h!yhjJc5+3}+<2~%j9b1{nzfdKw1H3tObC%<C&`)Tt{
z2W80*5$Du0Do}?5KNXEtf{i9H3(Kzm3FVIIU2|uW39vpQd_*h7aO+bI@khlw+{IVi
zuu!;Z7>n$;jF4>|;Y98}Y75FdWy=dAkCaw>D}uY@ys&kSD$}yXU6Ekx0gUUdJ1u>q
z#!$*RVDBW$%?sXGpfRX;<5pdfS7bi!oUnD#eVKd94i2%w)-JhWcb4%pKw)Y@dIRv6
zuA6}c(M)m?=-=nh=i;yu>wx{o_ykIBW6v23p4d{?7@lc{bn)v-S+%ZScWNz_UU+8u
zF<R%2UGtxd=B1J(Q?oPw2mHD`Mpu>y@9%HEe}2HMp8St?x3|AP#zE_?<wiu9RLwK*
z+y}qLA9SCFhx7;Waq*kW1_CJ8nI}8zab?4QFE{~%y4(NIc)?98vGcGHbWG!(Fh*CF
z@sK5T@NdQ#UujR+7z^2Sg<qP_XUti(K6BcOYkmU_uhs_mU>>XOI$HaE4H(Wlg=YEb
zKKpdt0cdn}+t_{}KN$ul@3sB@GA%J$F3rRTsKwu1yeB3v6T%O!GH37YL%Yb}_x5fW
za04#w*}djw%Y!^Yucx2CW>aoqelYty=6IP8=kK0+h$kuYXP@Tg@i=%&u2UURGI)$f
z$!$7sgnT4tbaBG4CeQ9q(El47S<_V4&TR3}Nc%m}wGKV4c~~BufWqOQP6z{5L6tjF
z=>Hd@s+nQd;}#zK<&FY_|3Pnxtnef(4FouC@!YWiBisl7loK&~EO4KoJtxqi`2l~R
z2Rr%$K7p<YFpC0dg8Z8^o1FM2!zeZa2=)Yw+}!upzxlBUVlf|x__=MYYs$Ux9wYch
zf5yD4-%;iGjx<#AE8u$>;WL6>cq5zu13?df1WcD7HDWL){Q&M<R^z#K!Z82f|NW2Q
zKMp!sfED0(rhwDugm4nQMqnmy#ml(i3tWc(eV8QtXl>W{PlL-s3+mYirK?4Is7t`l
z#BxZ%f~?fgr)!Dg_s$?!HBlBHlRcjwp6C@zMSMkYo~VnVrpH#=<mnpxB?ETM`Q>g1
z4*xHJFna0l&K-#H9wWqfiFqVZ3tV@OOB@6b<llTJTcRW{E+fQzRa%4%e1n%TZLPFz
zi@fjrbUQs%KJ398&|8mj=yTsY;{N_^Ku+H!ql>Ee@zo8?MzWgF8Rn7Uo44IZLdYzO
z^XuKU`L#q->zg;C@t!iMf^X;z`M@Ev|DSC(H6N`Z#|kVUnjn}L(hd)2`}PO>=Y}0{
zNrD}(NM&fbWH-lSE&vj>U}wwkr3LeEf5X53SdS41VkY38J~C_w1UB7@mb=ow1aOJ3
z13q7~F6D8PpP(jru8aWowek+%m)Pgc@!UPF`U7HI)1m2$PW)wnLUtVI9>@&=L8Y=3
z$bgBS#@g?Jc$oMt8Rz?@%4&)YUciCR-xcA=pB2H0X;C<y51EmfAAHj8WJ|rff*wDU
zvFj*Ono*9*DAlK7AM6VCQIhd@b)H{Yazfl!8k$`Zr%zY$J5<tsdHa*~iF$FfCBas1
zifFibI?dn5;F+K&+{5DhtY|<<GK>peJ01kV?cpy%`I@y0^XuRFr*p;|zRTZqvG=cn
z%2q%~-Us<IYbLJ@ej9cGF}3_Zsst7va0!3t+Q5M>w5LDwcqQ2Kc-%CE5|I*v$br*1
zX%c7G{l$N>zr}CO^3fU7_>bZ<(}Xb|BgA-*#6@8bzA$e1iMV?<=|V0Sj~~Sr`Cm=A
z*!U}xfWxk*_06i+ggUUH3-kradtml}>!<h-G>1ALk{|JWa%Yq<85vyKBE#_*&B9B1
z&M~?1A0IB0rnfED%=hB3gfYpaa(^FhT{>>7hmK;0nll5^xq*Re4Yy#Idp-3|xRv4$
zX0_tvXMmqq0b4P$UoMY2{Jm5oh>GK*Bu}KLrB?0xw1JGYHiYE8XM=a~77VWjcf^{D
z&)yx{;X5qwIF3FVeAwX0O}keeVStgYLzwXwz+avx%pC{t->h=LnEjyt&wT&EWCRb{
zS7!(h5EXFZ90rBbeOP-fG)ak~u^%lI37^lBc%Bl3jsuUHAp?f!z_C0bIf&>X>h4s)
z`Y63R7zFjl@jahHf2jZaGr*@XmvwKd6R7#4!&c?+`>VuhBAyx|@^GIwPnB{7_y7J+
z(U^}DFA4FfO(c8`qBFw0k{{%8s-WHYn21$)zK7&li_4}0EvaZiGQzod(?kYrL|=Pz
z^YLA!ju+rUx>(b)mKTevYXS5aY2nf~$0+uX$6bNUfX1mcE<H8X@Qwm4=?2l0e?mT}
zjJ9(XEdUIjz8~^Qj8V4jxDWk#{^yHX|G__pQdesOxUIh7sFZpZf&Yk##6)5Z!WSky
z6mJnX1YADuDt7OMyvvs_NPrmEfH6#JVf<keTp<7<H(xLI-xahnr{9!_APCLae<Bs=
zelp0Dm`pzGtB@15Mg5Fw&=1x{Xm#MY5GbF3|6a5%qvwEc#$jKiwDFaO1ak~2N#4C$
zjD&D<G%z@i#q1ktBAxO0j}tEy9Ifm*|2!8JT1*bz!3Q@q;T~<?xQ`l?KQ59@POk~g
zMi%L%zCNMaXR&^+-jk?eC#66W;w?5)C4>?E=ih`esl*GSbWano@!^~C*hjCA@r!-W
zpB_0s=jeO@Bi}DNa0M3qd=&ZMnJ$Kf3&VtXI#@;e!a6P%5czl@(EkP}5#lDo5uAT(
zWK)1Z_51J2HR?u1X9dMZ6SUGHgOPIv3l#I{$W?mrl|p8o3(iX+o_oiC?cY}a!#jY9
zgV|T(TzKmtpnDG7MQ$A!MA-*%OsGmpRj}yq+yZ>?j?ncXGMWi8Kk<@D(EdG_G%bVv
z^<?v6Bl*1WTql}VqjA5>cH6u~LINRfX&I+9ModSDi|#+4{8y7#8OFJ>@o-UoO2cjc
z3C0COyZ|f*T7D})M+{((Y5vt9fgAjey!W>d$Is1&5nyRjW#Vmy8FoF;=J5pTyfKJ;
zM~LwrBgA|_g?Nrk;sRhkY)8RQgnAY9$Kz{L6{&_-70p`Hz6i4LfHA>3-z<DUa}FNw
z@?=jAaT7Nyymb>!7HDCc_tU%1&bJ#`(0>?p^#8xk!}DD0T>pHRldnR&CuBJ}vq;A*
zmlLq#IMztulMxZZb-z3ag#6iMAV5jRSx3V_&=?4J)^XxONOVsh0S48co+w(1Yl3}k
zlcdVTeFo8(ix9Yl#CVUy8!w^}ge!t5<!#C>{2_?(3-C=ysIMB+DkMh}E_lrU#PW&c
zL9fiue;`}V9J84L`K^;lEpZf*+2_v*+O~u=WO_j!<9=oFJhUwQCChuy#pB~Aag6aX
zh~7+Fh^fR&$^L4V2)EyiW=<ynZN1uU(;O<umQr*qKq10bCY6Bp^2Fn!1jS(Fkjk0)
z{QiI9rwj%gR<aVY(KK7Po&IQdvDbW0nhdvxu@J{3i6?=Ke6;6*5<ExT#x~-+-4*c`
z%wp9@*ffhzc_Mt*CpC=c;(M~lh;_y7#p6K$hG7JT)&#;lDc}x2ss3vNrq9(_ARs;J
zy;t-Kt5%<rTtAbS#KLF%_84{DQh#noHQyXX%fV)53eO3+&69u!@*4dpd(1pAAbGjG
zH3nnljDS@G;;u;ZL&<gD9wI6%E4b`sPx{1(<H?ViMPf}mH>^nc1_<k4$>e4VWX*9n
z(a)7@8se$blgabGe?ReDlC>aU!^skN_^F^|u*6t8YGgO)mUu=!X>kXAs>e;*ZOz1d
zb)}HgDzS&*51*~`T1hA;;;^Ey9_m?+bOKK?|8aX1gVi!Qc;xXg3Y(_+GOYK$*UN7D
z8~*<t%Q5{%@@1T;e6pm`c_&fVHZ_ri1!T3$GKo?u;G%dUvW8?S6Tf_Ap}~+5=zok`
z#fco(@lSqiuH>KE^*}`a;jP)L+J^Oh6#hQu9fdPmNZZDY;edyvCO`|qIV<mQ5$)1;
z9}`a}k8Oc!iDx50-<vOo6wh$_PCq9FxZn^7Y7D2!*_dFtw8sGbpn!a_*<XBKIt~Nj
zPKLNjQ!L~V9z25txW6tC%1S}N{#fY|gt?CL4|_j6CxYViDSm%g5Jg5Q!O!RU-#?$O
zSow?}dS~LdLNRixnee3wAi4WzRJCT^pNtt`TIVWi1-*WJ)Ce#a$(t*)4~dyDdyeL4
zHD9)bb81;GIRsdc?}Ex`8k9myUW{M=ch}w7Ul-sFyX$Y_vzQd3hv1&w>O=cJZva8@
z;U)C<;{SkI<)qj~UBZ>mRH=?y6vIO;|HPJ%1AN*oc(FM+N{al{XW@?;Xv`XFDrj8R
zpZLD1p&lq~4{m)k#0acJyxO#vyxFd7@cbhl1r<a@tTWf13ezja4y@VZCfa+K3@cbT
zsY<{=dbwA`JrEm*;oSiQtwAGM_F`lzRNyZ#gua6FQ&>PaZ%_XxRAa=+)RXZs_zY?f
z8VImG1Fky=yQm5LRjJ(Y@pXuM7UE^Bneq7K=UO<kCfa*YPo(%<R3>oue)7Ix+2S$;
z-3^tO*;#mWSh$Nj*9qoknEDO=xTs>8jM8TvJnx^Ef|?4!9^gKk62eibjLnPa|7i~S
z%~(BV>L<SqQem7#P9$F39l05?o8vIs^MMxksCf1kg|*}{5_P9B&j(3+4EAF$eeuj+
zwWj-m{Ys7=381pUPgX96*myLCmc+t1@fb4`AmT7)CIf<OEU-8x!pjc^kkZ4)2-3jd
zCW6ZZcg!fn&4-Q=rL(JEdjLkS8O4xrMVzAtA&j)i9+TKJZ-`Q4DgX)JrD8+l5pux0
z8uVc$c4@YC+h3FEfLtT{21o%jLjVaHKgL1bDPVU>SwR9kvVe%0V0V<TW?eB>U)D4P
z)U<}oNP{Cl_&RBC6E~$G9sJqu_fiHH;3I5Muh-a-B6HvE{F&|_>z{$y3S~W>^1?SJ
zcM}!B6wRc=fsj_a$HPCaVm#u=aGUE-@KmcYMY|Ij;80Td*s{sbvTp#-tn`@bJR!;v
zOzxi_HW^ELLB&`qEH|-*{z?GSAy4(<FGKweiJV$^Wv9Qn33OBc%uFfo05vg@gr&R8
z3cKlR-U!UP865xCzy+l4J#0^ZNcJvMq!GRA*vSv3yXDR_xP^<2d8l?|iRo&Se#igj
zXT17w^jW?CQ%Y%%#Kv_2F=c>a@s`&tQRreMHT!{+y(TWEk8f((gp1n(1I`ZH@5AO~
zm|y`17^-EzL`3sxzuSD7YZ(gHuz8UXx_5F792O*1XHvm8|6*e}3-eh<mKlrx_{d@=
zTQz)b00JZ>CxCPOlMPr&J}?4el`+_bV5*Y-Apj^tqw@xy{0S2}_x>P{=eU@z>zAeE
z<4KRgTB=eQviv8;%wA;^aXSN(XOnq&_|P`05G{CA>xLHdA^kLh-aKuUv6RCMc-s<_
zX%XSwTq1J%X?IrDXvWyj_)`DY13w7pXdNdFk6y@p+{J;rqWm<7{w1CcUnXu1geWI~
zk?W6t{42RAmCr8g(;pG>Tn-zP6~Y5rnS8MNnWs}fHN0>TBKL~zlMo1a;tl=@JU0hL
z?C)GuI;`L0>79Ku@iO>_%kNxF99)wyacL%C;^diwi%B#0;|8yc@CHx)CwIyIjI{L~
z2{Javu-kv$_c8DILbP}EW?+M7de%ST&Qk*3Xlr+E5E|hv-ka--+a6r=jpXuPTW2*^
z7Q}d)!xM2dBgITgrV=}OfJBKBPCP~gVq^xgW=8zN0fF$q1r`mvgmL51cmLY`e{UWD
zAO!%CsbFvc04N2FOAjI<OAjJumM=#PtKk^PI7}Difx=<_SbRiDVet{AfLW#yYKJuU
z6}J!xtNcD9B(TMT-7-*lyZLx9dialsLN4kAW;s@#Jig}&x2<_U-G0Bf^I;m~fOOQB
zY)ki5u8~6b+5h4xgL(lSb$EYN-~VCJ=&x=G{hoidM!P@!W<*sX-O&Vmk0dHQKocMI
zgYO_z+SLEhHpkj)X!-b308N~=5x22_rD3tm<1Lqi`@2sSI$Q1PZ6gwnTKE6|yZP|{
zz9VXEi4axGzr6RTg-6Ee|7>xlV$$(H*T3!&mU+qIIPVW@^s2p&2LrhWmLq&*XdVNA
zTB4@^2mF}_{FsWK=w!cfA^3lJ#F$)Gg&U=+Vdf>oVmw3mfnGI8+ewusYm-E#R?~<R
z`}`Ml%opCDkt{&1RWKzyAvY!B=Fa%x_q`N-Gn1B%lAFFZgIIxAotqr&(cZZ!)Xm|$
z@0E!;XHnM^2NxvDK*4=hyf9i-<_Ps1$-)&0n@}?9!UBbs1vs$25v^Ja%d}Z{;F7V^
zX`4A_9|blV8D$bqQyl1hQE<K|6}uhe#6!GSAYxq{5(?u4&BtsynxS8p9M#ig3F-Z7
z^{yBUaDZYzny2NCxiW4{MdArW@<Yq4@HYtPWJAcKQf*y2B-%p=;yrU;>Pw2-<6?4U
z!gD~UeExT?CTy56U_<zOZ}1{|Tg8bJU}l&~;Z}Hk7r@nqWx+n4oFSmBASWcRT$-Uf
zt#fh7-26`oaX&kw)+NJoW79+2%2(d>cdiog-%OSpll9FzW>GIJGNx)%8scjN6HuAP
zRGFZy<m85)1a89f>hYPNmO5w6ssfg+40sfri@{ecl5|%ZdINz1ZGmbSUNtmdhr(M+
zO~O_i8~eAUOh<`)+@#HjgfN6hC)35xBKbAp41eRbJWur=#srUCAB>s!@OqFTE)MO2
z66bq_10Nqa0I(5({){(z3d4^f--L0TM5iRNX%KsJMEx%nnU*)Mo|+7tyJy(^vE3&;
zJep>fUM577gc$N;2HoF3CK^*e5?d%{PaOU6{vm_-6K(_V5&1#`@&}hB+Atmu_f*&Z
z<r)}`>y~to${H3Yn}$u{nD1RuR~15yrgpC$rm+U6AX~y0i51|##a0gis}ud~@qdI~
zBJ@MY7c#UFKjJ)p1z3+W1}X#na4!kwY+vKthHRumUN4E+V2g8cHKpd#Vj-?7Vn`~$
zyBHx6EVjhFkHqeGhxz{qgh5=k;@j|EO0W(hGoUlZm}n5K5FVGqM6z-lIW`F1IsRW!
z-$l>Lb%gkg--D5#n(K<<d?aUC<TDx)Gr!9S8^^B<N!(;puNrldyj-HgMTf0x;f%M7
z@h(jHc{Wb%%JvV-4NPJ6#p+DPnSaE1b{K?20071D7>D8nJT#LC=r_grGg4+J@pBIi
zG<Q(D_$A|w?IJLPVx*tK9|_}k5_0A-Yx32v!c{^eM<s}eY-yvfTzzK#GMV9dW3DSR
z+QL3{OxQY^p}WPDOm%v}@jSOQ&|BdtHr$!Tb4tsg+i@Di#o{C4B-valYXs>0NRaiZ
zuB;pyWMa%A(){v3ndcWTu!IZ;s8ys|)$8X<M6~dTk(?MVqcniA&qjH%Y(q;J9Y&>z
zm+&5X4u61Izs437QBzN#@W>$((&e%A0+Qb#X8{BHy!Yi(gfI2*chPh$&EdazOF}b#
zH#ZJijS#ir6Ka3q4I)vp66Dm2u^%|c)!xiZPaN;?QI44CozA>YYywz`@P>X&MevPq
zk;spUpB<yv^};nmA~SOnNI8(gMkk3H@AY`d&Ebnm1dsG?pK=g&nP-=-3HL15>zl)O
zNf*iEtiAP7k*JRoi^M`bdl<K~yl*aoY>)92lHDG;Yd?tMDv!~U{E^ImCpL!>Wpi5(
zCCos8Dl_qzMZ=8*&jAWPwe>r1x#S%18l{^8MQ@ve0ITb7A}<?O2fMp6BfuLui<wj!
zp^@zG;R!_X1Gmz~%s6dg{&(>rs|1FQEDwh_5?H|q#A0G{d*XKlGw_R(Piqy%;rt>I
z3H-Oo=|V@TdsA9AFHpo0JSI<g1KeiCH+QImePNeiVDYE_89brkf9Qah@E;QqX&x9M
z6AlvM$}dTIL3MZ`_WfMav=FrW810lL-u$*F5qy_2ij2fT1V_Y4$;+{Pyq>WY#!*O+
z=mSV0H=E;_AX7w{Qal>2X^8lDUeIq;47aom*>Mvi!WMN)7xche{#eL7BOt*4<it;*
z#*g@(;e!MUj(E+OJ!1)d(dph#*OMbR+xRA_*GPhqt&s$qv?^ml5g3@A;S0ot@J8?-
zM%2_(s^kpC+4p``5wQ>NUHw1#u*_V91VAcA@v#H&4F6x?5w-FCFigeCTa73|>}Gom
z(QODCyRK1_y}{LI;aDk$S>EHH;KMscyXY@_Y$5FxI&!)if8(~B8X1^p&S=(!xYr$(
zeG2XWiK(z3xwgj}i185F*3ZIRoVvbQwjOfoBt~vn558HXAMS8KWv9t3IXFYukNpq3
zQHS5xw|bg_DwNX!lh?zISI++n#>*WlM|9D5Z(uimS===f;xcek<E9K8o<GbSngDL>
z3#jzNKk$qMk8-`{NBXbzzkqMtnINhhK>u>{ZPN0?aX$Jb$-~ZG_^pzah1-IY@w_3;
zC649!8l>jVoOIkyTS=zk_#?Lt>K&c&vz<RFpTSxwAW8p0`($8{2>h&QFGG&91J~U@
zL7MObt~?254j2#oHzB;XafFTVA2#V%QQ!D$3BB>x<7l76*2myX_iygc(kB5y3u2f%
z!ukpcc6x&X1F6u`9PYn(`S0G^ME~Z%9D8v7R34m92tY@^Ue$}XJHMm$Q?kGf{q`6q
z&?0%fMJmL6M3F{#Y0r}4B6)ng6mxb;PF~WkuvaXoO9WVsYa~U6xY$vlU}Fdht8GTd
zOMwLz17sVX;RXu%kWu(&w!5RH!5b2|ZGVo*8Xq&htz!fq0)OArK@{JIz5$!2+C%Ah
zIgSqV#0?|zpPJ%pv3xY8K6m(D2!03CxfQS{&QfjEgU7GN1ckrL;EnJ#tkffNek+s4
z&qMjV1g%&dZQ*P@+?^YcHiK{<`+RK^oa^!49ijw_ljBsCu`%4$K~@4MjH?uba>kOU
zlao61!Otcgd-y{(SpGcHU~dpiYM;rQ{t$-}SlY*$^I}5y-!>>}cHEG~hrJIfHN(Oe
zsRyD9MhyD*-VGT<)2ScfNsAA9-Hp;{(?X&huN*gNr-w#Bd~YwLv>XuA2<Ef~UU9&I
zqraa@L*P!Bk2nwYWwalL;sHie3?&k1#fRR%!?+SX70?SjG|C*KjG)kOks<A7rUDhN
zVQ7A+We&jb`UC%jFb4@0NDQ6&nF1fiO+u{uxIw>q9mk!1KCdH39{a2p9+|b|ACIA)
z9Yy(2&MOg!@g5_@c#jd{JV%J}ABgaU@b859zt}p9iABM|Spk3Md>51>!SDUY$BzXW
z*A?I?_ydq4{j05mmWW!1HPZ1h1MnM5KZtaQ|MPN3@$9|xWHZF`$wprof6K<PkK(uk
z7kzeR1QW{xwq3g>_l!VwrN8l<9y1nL9y1nO2bd?8)c^;yvY-I=mc}IIh9_YTv<`1@
zAEVC*Si2?YI@FDaOfyYs)5dd%fr1fbuz7-cVSt(Cn!eIl3;k+=*Dw57Rw^8gMBN1r
z-J$>hino;j0xHtPAdBJ<NA@BogUlk!1kS&FQ~(I8O9P%`S9C!$=A?<5#6uDx-0D^c
zd`}Q0+yJ$HkaUZu;slG}0qjdI-s9sn0uvsVraF-StI!}o2J@%E#y{nV5-)-@v$BS)
zf5<%`OnNy6{%p%>8c%Z!JmW+^^AQCc9fDHX8Wqn+00x<bnb<R}^J0Dwu45UcO>80$
zE)v+)4#^}%#8)Si4aCkE93ZGw@qq~f+wi}M_(!uqm7!H|33wIw!v7B7o5#99yTijU
zj*d_OPrU7c?MM6JC}2GWkc0Z-ph2}k!SwdV>eo~BUyleq%MpLeYyAPRFKust_ZVsQ
zA>1wyj)Mm?^LS;%TS%<x2CXZUjkpZ(mJ#Q54BpqLOeNzIXoK%v_P_bC61Bi;umU~y
zAOFFvx1bK*Cjgt?gTFigF}3}D@;q2u`iJuW_)f@(Y@G*X<>S(@yhdz6D2)yGwa4*O
zL;;9lHNW@>@hpmc1zzX?o*G)I*>^?&2)L<l@iCCKnPT^c&s;8?z03E>fp$!V**Gq%
zjrX|w|BrlxPRKZxH5(UF9snmpOAi1Mc~agy0XhjR3}BDi5osfPf8!{KotY02ppwHI
z*H_>2$X$^1Xe6-oXe6^CD<(qhuMKl1M*h))!Zf$z#e`{L;>2lh@i7B%I3(T*CMktk
z2@-s~oawZfjaFPvh?D9Dt?Tg^ft~?JmL4jO*KqJqH6Fx;et2WTRb%h+iM>|LOYN;H
z?pFL|{UG=AH(IyN|HKS~F1tWBRB}c2fOx`-IE!&p2N^qP=YZPRcGD)ct){1=M|u97
z1cihGJjd4RjGpuV8B8`5(2B4y(I!lv@8AxgZ!A&-yZ4|^1CT;ozrUZ&?xfZK{y4WL
zA9+>r|9<{lo8x+5G;1;vf6VN;j<K2F^RALeeE%rR^n>Le{xd{B<#(me^h3K@2tE6!
ztvI*z=W-8o6y7;ubO%L->ZNXV@MLSqN&RSdW0jZ3{I%~%A^+?Cgmu9UYp)S~#@Q)r
z<iuYSniNkYFM`h+mBTxNpi`4!!6y-%D{$=gm1O*&yem}5A$>-@)pvk@K&oj%i|7CN
zPP$tNv3!5#vR-g#{{$HUv}UN@LeRZ2GkD+o%l9`QlZd^ai~b7v%FQaYW!#=&%0q}Z
zf#4qn?LJrwHibkkBlyYj^WcPFj8<mh8-!Zx84#V<d+q=4BjA66|M|QEJ^UZuc<g#e
zP2Pan&>q#>kdIspI0Rq#IYh<{ytvep=jGvyd6KZ2Z*3+%BX=lBX!Y-k&Hip^j3dcE
z?-B5vq|htLmKT<7q4s!;oL&GK1IKJ}2*3K0#2#=sy2*@8F@*6G;ygw0h3I(9z0!`E
z>xAf~U<cjOn~>+dl93OK@Iv+63EA-n?tu{vdv`(j$PxPF3GRUQk=1I?z@4sxU$>%$
zgXz!<IL&GA8HWCc)q6(l+ONy}SEKK<*9H*k`Ut*w*C6Z+_zi>w4<W|+ZJfW$rW{&@
z4-lU>DZ<0UzG#F@Ix5kUW94JRbJ{U*2seCxxb$OSrXHOhxx58`0hzpafQ$SDdw>}C
z{5g2|)fl{(*#87)fYW7(=fKnjy8ZLu;@{T@O+A+{AYne{5Uvw~KPma>Q4J5Fz|cL8
z28Y5Di7NzfLj)fkCFa;y+PBuYt&Ti#STh*mjwg~?C6k2oBYtbm5tom`9l3dD+U<(0
zo6bIn3hWJDVMs=4M~Sp)cEpO~{|}aAw+A+4G-hD7LH=pth_KJg&7TNynSMHFXoHSa
zy5UIiqsg2JzkSCXD+9MtFx;B3<m{mMei=Y+HnY_#cs6t%<~>coO!Xg$0!M(IO+*Dp
z!2$5%bwA<V6NY8V_`lwpgf0W$H4Y~e<NuG~8c|(m@DP50^!!`6TbPM`0sGn2CzrCB
z8^+KPZ;kqEg?gv|crpTS`Mt_}U}mFy=*xeH`rqa*B*uJjuXvQ85Yk(8%iE3@*q%*l
zBa7prz@Se!Jb=-IjpF~oE;2ud31WBpC@uf6T-XzC0K5qPZ`WTxtH*Gi!m|PFx1c?Y
z0(0^6QU<5@+8p^W0oKpzz8AqGKu(H;%`z*8tS0B*{uG1jfe0?U-;NkHfP?txAZ~+r
zX}Wk&e7UgEu4&*%U(3d2{uQ7+H9ylr0YnhBU~Ep#J1~U2Fd7?I|INoG?~9uh*pCA0
zgMKz69nC5ftS%t8j^pAYc=}&b1d3;bPjDaNGG4}KQ)Gh>%*RF?eB(3SpY3m%I3On-
z|A>o;Y*rP5Gm%F&TZi112>nITLqfzsA9b^MyhLP1xn+lZzF7N}4HKJ!N{t)5zA~Zg
zPz-2D`{6DN(Mv?TWa~}Jrkx+hQ7*7KNE;9$@KDkbIQ-f+%bqt_i}RZ+qB)t3S_|w!
z#nts=O$IwP{x+Zw{Y|1HKwe!Ja9Kfse`-tY7vN(|fFyf>|9&bembig&-l}1r4hWxr
z!x9yz>mfXEYmYdvJ(*mc1z-H$2_9!Rj`=ryfbaBBN2zus+y}KnfB|H+gZIK8YgNEv
zZn%6D)u1ys`~dxQl5x#aY;)ov<Ty2<qx>R!n9ZNA@WeWw;)$tx1pD>vR)z{?`3Os6
zcw-H8!-@7|9%zuZtCjno&uREqf>)Qir9uh}Uu9?jCre){QRlC|5%B(uGX4VnevjDL
z60|a&sNU2KOUeJlU`zC9(g+vG+c-Q6_wrJg{M?@S{t3JWp0HIyY#mE5gYeUo)jtl-
zF-Zr5p_fP7kzE_L)sEYWW??h$Pux%9CnU|Lk~FN>7q-a~wAaEl2^bwgq$%4QP=SK-
z3}?#Rxe?Y7?b3UGHeQ#w<)Q)@iMEzUd?RN34#kO}PRh#Ee7@P)=j({yFG;^NT3^e?
zbJ$P+{~P5IjO5IQ<;0hIYZ2iHkMR-^O~!QGpfe#9b|a^zPWo^`!v1VGWdr;SFcCH3
zx!wPbuAl=?`l{*VeH-DKfeX}rKS02*w}-0_{bB6%jS}Dgi_me9F;k>-Cqn#mbRdcQ
zicbUqV>gG-B__-MGKsihtZG`=mYy3<w9P{?K^sE<JP+sXJ6sTIph!Ir=Vrm7lmbrr
zN1T{_#0~4iJfQU(5Fha{N;GSW2~J3TSbuiD7nCl*&5e8{+Sn2A0{gndeJ_UvynlqG
zNy0^xO{Tc7nevH}7k`}6@o+!JKznt@onP1!dLM>dAEN$W^zVo&h%!gEs^2_b+#tLo
zdyaCO>1@sOE%6v_3a-(yr<d^`880-6>hT^TZZZN7;`;%I5CGcWB4wf10%qsu|K(>b
zY`?GO+KHQvw0>?jLj1AZSNunYlhw9|&jd3B1hDOVUxGiIlZWge-t@3i2Bd2IcYzn<
zNkB#S0qJR>^#T1E1AxWvlYH}IQP%Pw`?oTqX$SfI>s(JZORXk?Tt;(=zZesIy5TxY
z9f>%A?1{~VDL=`Ekz(A(g*irtci=$$y=ZT;Uja68p4kmeSUWea$`LMKa7@q}7ekkf
zXx0Dpd*Zy+O8;@ps_U9)$i$qMM1_$4ZZn>Ocmo&e#C>1?_!~B47Kp-e89A^|yYC^i
zG-u<mg_3RO=QY3F;}brexNNE4uc2^%f(#J6u)rjHltvfo5j+WiP5Yk~sSh2uV17UC
z-Og@q2D=QUm!5y#=Dqy!`{R7yP)nmqt$>>PKQ{nv^l7L#&2%{b!2BKqFUuFM5%GR5
zppQfS;Nb6>u^#YKge|xPUK%oQ)g7MP5!psc-Nk)u9}l`t7lfQ|k1nzyDV8=U(0N8Y
z6`<Ep4t7wo{GiRK+87`4-^}(b1~%)Oq!noFS^tbC>c-U%$MXy=DsN2<bg@=FOM`$|
zT!N}xjtB$(E+QL%_o<cT+R;0}LiP0h|FCD>@_)Y}H~-*LX|E<s|DVpWF*A5)cKE&!
ze?V!NZq-lt1eZ4B7JW<vFY(<01VaYugzVTOc^yuHsSnVYw7*0561^dq!K$jA`tFlc
z#JnTOqcNIQpROaiOs%eI66eEmL|K)IJG+09$j2v#mUw4?-cH=x@1#RsS@VTrF`OrQ
z>Dw8_dJH4r+Bzt-U&e2$f=>=i30oR9TEcxZXdFCa0a>Ha8Sc*?jCMRgd^=n&Kh1Qp
zf*Gj}Y4e(WLun=d?-B78p~?7U^&RW@a|t`%!?z(?gLX=u60r5Z@v~zOf(P$B?GJq>
ziyK&L3KDITS3~F%JrR;Q69xh}V4Jvj{68lI8MsS_HbEMOesV$tFH0<I^&N_3`oY>c
ztb!Q%>-;GovKi-$AbI0I0!QwtXbF%KKX0%z0J5RN_8V#d@9=yWNRKJmhBC(Y<k}TO
z3-*8C5v|}jmr<VA+iv*b#xb<?Io?UX9n4l@4MpM;(R$q-Ix-q|_uTOjaEIa}eBE9<
zjDTZP0S)3J=8uVMT{Bhifgj8nVkYCnK=(9Zh`&Jxmyx5(DroV24kW3g2fmgE{VjxI
z`230ohM-1i=B6eukUl%=p%Dmnd8jpi;^F+zLRy}rE`f>OfY-XsEz+yTa3#8!FMV>2
z6(I|`8S0hm8ZFl3zgM0=5dn{Lm-NLD2<%SO{9u*;zVz?%%80NT#!fyOYKoAp8+P@J
z>AMYLJVkSHgJw?WhRB>JZ*9EkR~ebLwHX2}5t0vH>ywvcXjyqEvOpVm(lv<Uyk_Ol
zWY~M|guIc!)3A6xil@gz?Cgl~TO{iF;eYCEfVr$VU0tG=i1PxaXqx0FMe8V{KOG2L
zX>uo<h*a;<G;@1XNI-=>_)B+7X)Yi~%RS%3aUZ!i-!7V7Ad&_K#&yfWb4x)WmO2m_
zIPHfSqu??#?L%WS|1FZo@G2)2!hG_Q-wEO&tVCxvr_w7%cJRjsc}-DD^=YHp<=6Gz
zXc`t?2|O_q=X@#S6N3|$qU+>rK=~B?SxY~&&rQNxaQ7~3{nEGR=Gc_x&&%dr@qTW{
zXkNmKzyHIoFD<NR-w`TXBo@qiJKa-ctlVbQ($6e<zTGj4OurYxMw*_`NY3!^QD}6G
z8r44f9$^j<PUIlR?|sYw0e{zgkdwLL-z8h0zOX@0d|HM$C-Ziw82EvvUq&AtP(soB
zp*###%pDr8nR}DmFdSbC8*t}O^JBvWr-nWWwQcVIs^--|A>YsV*Ta6{ny@fE!`bWg
z!<%r0wTs6){5z~TyP%PZWnuNiAkKmb8QfIOUBuCx=PG0!QdZCS-r$y>y=XiKA+jF)
z@H6Gs5aQ+0chl5`ziU*+#<0{fK79PtcA8vAo*2L(KYiVCoSDWl#^rw<JmB9I89elH
z_4#-t?12kUw|o|C(rt4jFy;Ol9(P8FFXQ(Si00aatmM2D+YCQp3?W^u%b9r=Cs1}w
zS2*rXfd_B^4j&utqwc62^pNORn-n2p?gMtSf}zT2{nk1}4Wgm?nz=jVh2kXU&!4_h
zM9v}#Ik_QR-PA3?C9&ZF1P=>UJ`YLX8H8*e2tvUMwtYI?)O7j^pKhgnJ$r;3em`6z
z8W=+wfYuq?LIN-@L66Z|!Uw4AmUZji)+NK1lxqYQhIz%|x!iw^n*k4&DgrOg2fbY6
zv@^^buKS|pjSrdb?B>s}0uR6+qJkElcJ!TJ_*2^*1p4&G0Uo{$-_XaZ!)fLAk9))J
z{40V8#mms+s7k)34vth6_WjyRNj|lsD9J-X|Bdxm;Vv3j12_7FS;KgrAp~jRHQ@-{
zg81LxW52FAS0Q=vIEv!Bo3-2brcKGsm;P?d_u@QsPVC3>O2RL~oe`m0yJ@6rX%&~>
z8RJ7BbJ$10)DQ;<^H<*o>R9;SR?)GPkFoN`+BhXf`P}y{oKaV*s~OB^@e=Xuv-4An
ze-R!vik7ftv3~`X2nH`$60jkf7Y`ww5M3FrpV(a@>cRK2Ayedul00yHG8nEeHVpe)
z!N)XjFNlcnhHez7-E%y9r-68V1JnQ=T+IsR0&uPr@!(w?hXMulIC>$pFIXTU=mP{2
z8&cK2Zyx>e5xl>j>x!A+y!uoI?1CnMj*C362~c{&P&_(zr{W<$8~nUSE<}^T;R@!}
zMvE^G+epWtL?@;$<%jE<9IUFCJpRxUkvLJ87x}EE?7Ux^m^)bcbbcysq;fFyMFbJ>
zM}zU*k)eiP$opqezIS)6@J{vr>iu^*X>nY)TOfxwRU|-&BgA}`%Eb))l+u3@H=mM0
zf~7*J8@!bSZ8MxE+g|c~(9?5(w_LTyh(fqSjz({RA!W-4!v1dz{te7cT7~mo8=c?y
zcBFw1)7psi2k$W>&>y`2c+DP<dEah#+TUtrcjx>?`Pt)l4TgFHc$=tk0mdv2eM~(k
zAII3SlV_=Bk}Dxx(VTz6T2C-wWRKjYEq>`3=3Y*Ce6m90SuP8><mae*{gb{Jju#1=
z3k$Fy`a9l7Kq+?w)X%?K3(bg$;<}?P6`MFG#7WIVm54?n^q21%()kmT<gPP|(O)D!
z3OwE&a>MYF9`$qYf}AC4fQ_BX_UA64etWxoxq1Nk?#AqAYU4a!8nVEUYCD#K7$etU
z&DQE5*+T{I?~Gx6aa@qHMLaxx*U1Z_u!+emw!FL3d{)OZ6DaW+aULSMD7EokN07S7
zMYK_OJa&XmpaFrF@37q#HUDT`^~jTSKV$I^9>;uK@Y!Z!3ULID8T@|)`V82pguu;T
zX5}x5oeQL9e;HG}K!=vdC&fTuf2#eg@C*sI`D_;v7tNj!eI5%i9_f|>N2vtb3Bpzy
z<t#LqMHG#{$p1e(OU<Icgzml~%ttNveBNKg1n~S=wq%KG#LL68pUNOd4G>1tIvU^x
zd;%;Ip;g}^X~x(G{X$*hCB%F`=D<eN2UNgUSTudX^&!Qk)yALh2m|ku<&A{<ne)Q=
zFSuV31Uzgo<bGXo<xv|}^xhG(yFn{P!`VYa?{LgKi|TN?u?7Ei#_adE_)n88W<TLy
z4Nvs3klt&UG=yzRd~%e=gNTxUn}p?!gpuH4U%MuByjDg~)YHiq%jSW3XU)lonh?Zs
z{MjHNJxR)C8wLq}Ki+sSl=QM0f3l52b>XEc?~@wGHze>mpT)|A$1Ji+HwZ&98R9eX
zTE{bCH7ouiXpaPF6GR57gAC3$t5@6vFIA)W%H_=qhWoPL#m_buTlr-rt&#a|iwST`
z4j?v;&+)aHZ2#3n>yv7l;X9x^x-0p3K9roZ!(=;`m%%S}M6k~YajiIe<636#MDdu3
zFvN6DTtp!emk2^J86t5!*zm$60ynG+=Fbl1<D)8R<qqYLX+VEI_URkq@x6TkR5v@d
zGXMOs&`yc{S>O4o7EMF)@)~F1F0YbNkcJ!L`cJg$i|Upwe3auR%-o$KSVM&JL!!Io
z@<6dT2&e!6M9V>%z*-ORo=>nj=y5*?Suh*&%N?7*AD6?6>&eZ?gdMZhfSwbMna5^D
zmKDU=4hw<2Gh;*_-Ju*1ct`M`7bPb#L&->v2(ZkE+#CFFAoG6TRfv2&ppGF#f*WiG
ztituz<m2Xlxur{C3W&+v&(Qu&*xL+p__#xYEMz<o>KZ1XMwgO?AAQY)CGN~}!?uEX
zq#)-aP7<u+7IYcu_?|Lf#{Bn$Ax;Q2nDlITQTyF~QOI3A_*xo(gYjLu_!{~z{y!TU
zaFtEzcK?nTzYF-f#{qv|;9{{-`6DI5`19f>?^Y1lK!k|#J|o0@L^s@KU!jIMyPt&k
zO3_4_wWVS`b)kT+FUGKaBGmQWj{XrW#waF7G!TS0!a4*nA|rxFs3W#L(5uZKxk5)q
z@h`zXY;I)|D%CjfPcV2fR@6UQD=q>#@wn(XkuKnZ({VPiGPAyew2Wfp68i-09yb0G
zjN`b-abH{CkL9~}aT<vc4e*zafB@}`(A<~YR76c?Q!<xgn-N@I>!zGXE{P)0XAx6l
z=Yn&?%a(M0KGh-!9Bxk=rN8kp>5dj`2+v&D`yMZwB?>`+#Bq@H0%*_)t`7m~eednc
zC-Y~5&eK+#pHfAFA(V)A3;boK0|;0VN|DN<W2v42_xC=3h`WBkhC^yZH%|pQz)c3x
z(A+wT7J4snYj8V=&zRgN{#j4Ws06s~NNL@y%#Mi1^35%fUkF6=XfdN=n~Q}!-Z~0u
ziU)^=U={{%lOA6H-{Eek;B>>bhzr5BC<KN4Vw>XpvB+XEbIaCAmzzLo4Muo=hnQf3
zW{$StSR&TK8yG!(G{#EU{M1a0oqi%l7g#_Z@$r+wJKuAL2NzG>(4qME#c{)yd~Tdi
zEsSp+^Kw^+%gG)Ko528BUL#--gWXMEf5c%POs|)G-OEoCjSU-+nHN-H@|c8i5Vj-4
zg3mTJtce>@_C6HkF*vH!3k%%91FsVvz%cq5Lp(umtHfR+`^to9+4v-o)L@aN4-d>1
zK-Y*C^&n=#VUMc#*`vb{o%lncB+#!whcZsb*ETq2WV+?nrQ<7(gpziM4FOhnI09xn
z${0QfB@Kq*Enz?$Hwy6N8eXc)2iNh!xrcYlTKuyJP;uQo<KTqvkEUS_rP<!6;<P!G
zP4Hcahq-a!z*EcB{%kcRix~0N$A{6w`b5p1r0aR=Tpd@yAQGqFjOJpaQMp190QN-;
z1Y~?3?xgO2*Dsg*<q%9DOUdKPZfY71>xhSW)s|ZksIdXi6x=7n9IrDM!4E&YonPhS
z(HXH7#PdRumJtFo?})=)%7~arZ<1q|`D2$mV=pEiQh&>i4!-$uu^!~BhiD!=Ipcuc
z@1HjwH#(#mf5h7c-wf2%a$A-kEZRCd^}epYYPkvTkH!xjS(iu7g?tiK-t%{L*Dh%d
z0ux-hBl)Uqjf2DEHII*lN7=l2Kxiif3>mf#KX%u`ezqcrBjno(m&MS?AU0S?+h)6k
zJO6}ynW8mA(v`rgn#55BtejMJwwna=HysI{<`9npCXq9EPC*5CVHup9Cyb0AEHd$P
zT-c4MLz-t155Yzm?&nf;S$K?iX6%I=oF`+E8ICiK4meMj8k*+gC7w1hLkqc65ro;Z
z$vnqK6OMVg^v1lgz(D#rcp&pvavvf{P5=R;PQFhTFB#my1BUl!HlP<nkD4p;@Z3BL
zQ8<oFY-%W$_)dC$Z1Fm%+%XJuPC{NWt_m#?!>ud_24R0ZQuZEAr}<`{?~3umH20f=
z>x>s}xGRtV9o+ar!e&RgG`GF}I#=1ZkB+W<$-;T_+9>~?zk)rD?*XnJwmmwqYufUJ
zf{zca|0g!D2Z8q*WkzquWPTBvvj^DcK)o57Knv0+L&6w$5#b11mT=8x<c%4B%Oo#+
zCmfvi5O-Ac8{&IsLP*f&XUpB+E}UrKxJpe{Iy;?>@SOSOr|vQ!F-7vwHg4;L=MowZ
z0XQHFkw`&!embT8!*q19$)7bw$GVe&Ii(C`OZT-f$ICE-woYtfI`R*Tyqmrm;)9U~
zmy#bD;pO<p2YbP{(AGTyB52SDYk%+E{t>irNka#Q*RmW3E&$zQV5s_UlVK0b{2@rG
z5c7zb{qjP%PBl*=4E=nYCNj}-?cCgdpXSdWNnG9@tN1C~Qv(NKSPgmn!FGaBrR;x7
z9u$;dzN|sCUkeafwqXL;P)`OgRvs$5BZ$DlP8L)jf@?McDo6K-4*vk*KpwwumU!*>
zO7N~wnc)ArInu5Xf-a*`5AdH>)&ng$xx7{qgf-32u;(|IRwKk$Cp=95EIX-s4RT@o
zul{NdREoK3`tL12ERe<xo+DBvzURkcss{(&WjRtVC$btHm7`uWVkPCrj`hAS+Sqxr
zUhaVB5FZzf({vj_wrpTPd@1I}!>Der2n+$p9v%cU3(}%REpS#4uI5Tp9D*0%lT=AK
z@QkP{9cuJS$WI{1(qZPm1eEJ^{1j@6L4$UYZ^myM00X9{YXfj#TrYe%b+jM%K&+zv
zCNLB*u=+2Vf&st5XPfh5Z#@9qWiP_nMU{gJuwS|z&x9=f+OU^T@SIm*eWJ2X6QQ7|
zZa+-j$@ova{-A@KFV`f-H$nMf&DpORTxCS%;DWMN67q9Mim>p3-X1^}klg-O7t0`k
z(7`i=P7tiZ$fMu^JOhu67)QiO#pRurI0#MfQ`ih(n2m%6pfzkz3^x--=gBrl$2bD=
z*yBS@zCL&`Qo-IqNa}n6=Kuh#A>kjnHuuTncRXHdM?e8<0L+uYKby=L2<YuohCUse
z4M$Pp0>g{LK(CDUPc^TP9_jI%6=*qj&_nEYk1+ej4#US`#=Q=u9nh0cU)7Gkt~+kp
z%6Syrp;ZAZ+;Qmt{(p$Z#A0GFrXnYrS>y-;e)uTiEa%|~R3NMh_n0jj9iB4qx`CnL
zQ7YgW^gl26Spy#lc`TzFQvA0WvEMarNj|Ul$*CKYt^BkY!Lrnz2qA>sLwk;-5=bO8
z5H#NeE9~?Ib@=HNBzV{OCF(F*?_;yzqo5daDfrkJFj`EETApSe5b^`k;GOE`G~lqD
zF>wpAT9t^4yVxgue2jE+c5!$pi;s?zMzOx2bhCyO0gv4=9ZmjSF|5XbP4b^x=~sfg
zA>zZ;nwC#As3fs(`Yc&W_k1I;hDIwz9RZc5L5ajJ%+BsO1@DIT^6)Ilua2bH;&4&s
z#+V!!N5M`r;ICXfn{bF}144A{Hy50sfsyV!WYvwCxJ7Wd&>REf!Ko8NYy<~H+QfWT
zIu1*qae-jJlbe`gXOpWJ&3%l#vTfz=>hV~KqA;9BJA`tfWBItyIdD4RIfgLO?DmF-
z5xD$1wZEe?<zw>9e)D%=ZVD1Fhm*OEc{V80V4cV#AUzW0jENn6H_MlG#p$empYlR>
z%WsWwy|p+X5`@r0fxs1zL@?2Wo?oScA04$;H=BVk$4HC#>YxF*0(=t>0R)KB-BDmQ
z0@`E#BLsT`|H4O7o|Fww!JsMw7_{_o5BE1~QT*{TKn!i$|E`kJzc>F8SX>~+nvveB
zVgZ?FOkto)#&I{`9%(NhlGr{$0rMAoZ@Fd}FqVIdn6S-GjvlzW;vk8%ZVll|$k>`U
z&*p~VvhKH6ph2?Wo*}5f3KsUI2YhEAtTzo4DA;g<^X@|cM&0`iWIlzk5Ern=ekwjv
z_ALT5JSAnjA|Zh<5Fa0seP`C9WHR;em8v{2in0CiSSQ#AuwYNdVaaVO;W-Rp{Z1gn
zFRn9RuY4)hW23NO4vjmiP(u@%gKw`02Y-yN4-3qGz(o`&U|~oA0aZkXjXfg+*X6D2
zni^XhSd=Q@0yh4ypTGZ~n-M-D`<&`YK{pj{);bUUb8(<_V2_06MNUH;W?8u?v4djZ
zlSE*_dWZPQvSUFX+4M*Uwe25MRoEx<SR0XSoJM$PrVKCTtp;O@n`1a-PCVWj+!ve8
z{1s74j8-(udCP`TUed1x7HrlGYaeOgf^Bse_|F|3tO((N*pGAbm=H&<LYyea(IC{o
z{^L=*RELlM5pWW>#=RN0@O<uz`i+V)HRwM6V|8@!9!QC}c6ypS;`rMh8h#py{6x85
z1rtVE6tsLep(DVb`*gd`Yj5fNUCu$!Ge^YD#sLCw!SeVa>UvYYb*>^1XcE9&KVJ{5
z`-BkO44x2#kDN}Fs*Q8_3_q^B#)k9<xG(m{s5`zc=ZQT5;+|VPrk0<C?{}CgG%_h@
z@iv1i>l_XL1lHx@3VA3|0crh~XmKAk5(+wa@V{WxWLcC#tN<Woje7k{wfllLl+~Sa
zj4R?RioF$qV{?m}AD8?`ng(I6KM_!d`MbDZ2uE{I_6E3$1F$iH$#(xYb~14pX~~-6
zw%e(Mqh~%Y#_bFhlbnWEYr+`WJYZq8Vrbx)f6gFCkYxhcie%v}V;QS-HO-YPFT#7Z
zs{BQXRTCpZ{t=U+SVnTxKy_FLoXE}31zL~^J72)xM(?ojg#oz%0D1!}=MW?S0J2sA
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%0AS0*vR63sXUHXxomFZGyGQC5AhnT5ug
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%0AwiQu2&gE`|knZ)wL`3Q*n
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%0A_9R8YpiOKy+YEQo(a@YACFyab2d#@VxlILDmAP
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

literal 0
HcmV?d00001

diff --git a/osu.Game.Tests/osu.Game.Tests.csproj b/osu.Game.Tests/osu.Game.Tests.csproj
index 161e248d96..3d2e08f278 100644
--- a/osu.Game.Tests/osu.Game.Tests.csproj
+++ b/osu.Game.Tests/osu.Game.Tests.csproj
@@ -22,4 +22,7 @@
     <ProjectReference Include="..\osu.Game.Rulesets.Mania\osu.Game.Rulesets.Mania.csproj" />
     <ProjectReference Include="..\osu.Game.Rulesets.Taiko\osu.Game.Rulesets.Taiko.csproj" />
   </ItemGroup>
+  <ItemGroup>
+    <Folder Include="Resources\Videos" />
+  </ItemGroup>
 </Project>
diff --git a/osu.Game/Rulesets/Edit/BeatmapVerifier.cs b/osu.Game/Rulesets/Edit/BeatmapVerifier.cs
index 768ab3545f..12e8d2e36f 100644
--- a/osu.Game/Rulesets/Edit/BeatmapVerifier.cs
+++ b/osu.Game/Rulesets/Edit/BeatmapVerifier.cs
@@ -25,6 +25,7 @@ namespace osu.Game.Rulesets.Edit
             new CheckMutedObjects(),
             new CheckFewHitsounds(),
             new CheckTooShortAudioFiles(),
+            new CheckAudioInVideo(),
 
             // Files
             new CheckZeroByteFiles(),
diff --git a/osu.Game/Rulesets/Edit/Checks/CheckAudioInVideo.cs b/osu.Game/Rulesets/Edit/Checks/CheckAudioInVideo.cs
new file mode 100644
index 0000000000..467adcdfb6
--- /dev/null
+++ b/osu.Game/Rulesets/Edit/Checks/CheckAudioInVideo.cs
@@ -0,0 +1,87 @@
+// 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 ManagedBass;
+using osu.Framework.Audio.Callbacks;
+using osu.Game.Rulesets.Edit.Checks.Components;
+using osu.Game.Storyboards;
+
+namespace osu.Game.Rulesets.Edit.Checks
+{
+    public class CheckAudioInVideo : ICheck
+    {
+        public CheckMetadata Metadata => new CheckMetadata(CheckCategory.Audio, "Audio track in video files");
+
+        public IEnumerable<IssueTemplate> PossibleTemplates => new IssueTemplate[]
+        {
+            new IssueTemplateHasAudioTrack(this),
+            new IssueTemplateBadFormat(this),
+            new IssueTemplateMissingFile(this)
+        };
+
+        public IEnumerable<Issue> Run(BeatmapVerifierContext context)
+        {
+            var beatmapSet = context.Beatmap.BeatmapInfo.BeatmapSet;
+
+            foreach (var layer in context.WorkingBeatmap.Storyboard.Layers)
+            {
+                foreach (var element in layer.Elements)
+                {
+                    if (!(element is StoryboardVideo video))
+                        continue;
+
+                    string filename = video.Path;
+                    string storagePath = beatmapSet.GetPathForFile(filename);
+
+                    if (storagePath == null)
+                    {
+                        // There's an element in the storyboard that requires this resource, so it being missing is worth warning about.
+                        yield return new IssueTemplateMissingFile(this).Create(filename);
+
+                        continue;
+                    }
+
+                    Stream data = context.WorkingBeatmap.GetStream(storagePath);
+                    var fileCallbacks = new FileCallbacks(new DataStreamFileProcedures(data));
+                    int decodeStream = Bass.CreateStream(StreamSystem.NoBuffer, BassFlags.Decode, fileCallbacks.Callbacks, fileCallbacks.Handle);
+                    if (decodeStream == 0)
+                        continue;
+
+                    yield return new IssueTemplateHasAudioTrack(this).Create(filename);
+                }
+            }
+        }
+
+        public class IssueTemplateHasAudioTrack : IssueTemplate
+        {
+            public IssueTemplateHasAudioTrack(ICheck check)
+                : base(check, IssueType.Problem, "\"{0}\" has an audio track.")
+            {
+            }
+
+            public Issue Create(string filename) => new Issue(this, filename);
+        }
+
+        public class IssueTemplateBadFormat : IssueTemplate
+        {
+            public IssueTemplateBadFormat(ICheck check)
+                : base(check, IssueType.Error, "Could not check whether \"{0}\" has an audio track (code \"{1}\").")
+            {
+            }
+
+            public Issue Create(string filename) => new Issue(this, filename, Bass.LastError);
+        }
+
+        public class IssueTemplateMissingFile : IssueTemplate
+        {
+            public IssueTemplateMissingFile(ICheck check)
+                : base(check, IssueType.Warning, "Could not check whether \"{0}\" has an audio track, because it is missing.")
+            {
+            }
+
+            public Issue Create(string filename) => new Issue(this, filename);
+        }
+    }
+}

From dc4285582b8fcab80a51b4a2e4b77c186e4a1f6d Mon Sep 17 00:00:00 2001
From: Naxess <30292137+Naxesss@users.noreply.github.com>
Date: Tue, 13 Jul 2021 06:07:04 +0200
Subject: [PATCH 0032/5547] Fix misplaced "f" in issue message

---
 osu.Game/Rulesets/Edit/Checks/CheckTooShortAudioFiles.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Rulesets/Edit/Checks/CheckTooShortAudioFiles.cs b/osu.Game/Rulesets/Edit/Checks/CheckTooShortAudioFiles.cs
index 9a2c714c06..ad9601c964 100644
--- a/osu.Game/Rulesets/Edit/Checks/CheckTooShortAudioFiles.cs
+++ b/osu.Game/Rulesets/Edit/Checks/CheckTooShortAudioFiles.cs
@@ -63,7 +63,7 @@ namespace osu.Game.Rulesets.Edit.Checks
         public class IssueTemplateTooShort : IssueTemplate
         {
             public IssueTemplateTooShort(ICheck check)
-                : base(check, IssueType.Problem, "\"{0}\" is too short ({1:0f} ms), should be at least {2:0f} ms.")
+                : base(check, IssueType.Problem, "\"{0}\" is too short ({1:0} ms), should be at least {2:0} ms.")
             {
             }
 

From 049a2dec34efb091a31a5fa39294f9af38b33ba3 Mon Sep 17 00:00:00 2001
From: Naxess <30292137+Naxesss@users.noreply.github.com>
Date: Tue, 13 Jul 2021 07:01:42 +0200
Subject: [PATCH 0033/5547] Remove unnecessary folder include

Co-authored-by: Salman Ahmed <frenzibyte@gmail.com>
---
 osu.Game.Tests/osu.Game.Tests.csproj | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/osu.Game.Tests/osu.Game.Tests.csproj b/osu.Game.Tests/osu.Game.Tests.csproj
index 3d2e08f278..161e248d96 100644
--- a/osu.Game.Tests/osu.Game.Tests.csproj
+++ b/osu.Game.Tests/osu.Game.Tests.csproj
@@ -22,7 +22,4 @@
     <ProjectReference Include="..\osu.Game.Rulesets.Mania\osu.Game.Rulesets.Mania.csproj" />
     <ProjectReference Include="..\osu.Game.Rulesets.Taiko\osu.Game.Rulesets.Taiko.csproj" />
   </ItemGroup>
-  <ItemGroup>
-    <Folder Include="Resources\Videos" />
-  </ItemGroup>
 </Project>

From 0a848e86a385349fbd4e91c560e11509f03dbfdd Mon Sep 17 00:00:00 2001
From: Naxess <30292137+Naxesss@users.noreply.github.com>
Date: Tue, 13 Jul 2021 07:32:10 +0200
Subject: [PATCH 0034/5547] Use less heavy video test files

---
 .../Videos/test-video-with-audio.mp4          | Bin 2316032 -> 47291 bytes
 .../test-video-with-track-but-no-audio.mp4    | Bin 2800362 -> 48642 bytes
 .../Resources/Videos/test-video.mp4           | Bin 2885141 -> 2832 bytes
 3 files changed, 0 insertions(+), 0 deletions(-)

diff --git a/osu.Game.Tests/Resources/Videos/test-video-with-audio.mp4 b/osu.Game.Tests/Resources/Videos/test-video-with-audio.mp4
index f41c41d388b2029b24247b1671e0a02855073ddf..5d380ab50cc0c1cde1a5047ec9bccb234776ae84 100644
GIT binary patch
literal 47291
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
asGcg-t0l?en5|kCXn*eOZtBik%4Og!@YJCI

literal 2316032
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%0Ac
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%0DH?#n`z_TgKvmp@b<
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%0DX}p;lw}~&Q37D6lTJoLaTr6J1cOG@2Wb`^XO6;b
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%0DS6Yq;Kxph8_B8uzq*(
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%0DTh^{jT91BYWG{ILk2HbDQ{sh6&OP`j)Rvg>n
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
EfMbo#W&i*H

diff --git a/osu.Game.Tests/Resources/Videos/test-video-with-track-but-no-audio.mp4 b/osu.Game.Tests/Resources/Videos/test-video-with-track-but-no-audio.mp4
index 000bfc356737ec5ba1b173b181bdb7f6f1b75501..7cdd1939e95f7e373f54a5f40cb533115b1d2a2b 100644
GIT binary patch
literal 48642
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

literal 2800362
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%0Aiw%dVgBZDd^;L69OaRaDcD
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%0Ai9~nZcL=5!>
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%0A<qoZwcZv<nlO
zeCn<?XqQ&Qv&XD04|?&tk=1*3Z$)eVd$f@0tG^`u$YPTl;b>wB66<D+LmYOqfm6N=
z9+ox9-;>>2SU_CYi4fPwo&}Ct%@D^w)VotC5J=BHFx$QJecL#P7=`KS38<jHO<zZ+
zODcnc6^YbuF)>}Z=s+~Bec;S^hcv7~<&y>JG}QIQr)<{T1j3?Ghc_it%qY0hGX0PT
zvV9+ruqesn{TI~!<3CB9_16ZKpZw?hvZB9Z<DW822&hW5W-Ilv{r)|1!m$7MxQFQh
zcjW#1yZ_i{tS>>w=a>G-h@*?2ic)<Jw?BM>LY^@2vw4Q3MlkP9MSq>}aJcuJgox3l
zb&{7srv3*@$TavHhjJn2B!Ly)V36@8t*#!Z*^?u+Sm2)8gKw3S3tG{{f>){Q6puO~
z4Xu(Sj{daW+e)9LxpC1*K)YzhT)Y}cPV(*KIjMIsOUh`t`+`VQJ@Pn$kzJFL+t0cO
zpl9fEePgJvkV{+fL#p&ODcW^iId<*1Y58}@`_J9%Ni;k5f(Bln98CQMTs-52vLS@%
zIM3rDT2`u6eU48!03S{Gztb?(xC^)5G#^AC4=K>IOLb)VG><Rk%Dr;pD!Ab1qO6UJ
zh_7Y)bgx(kkrOKVHhE}lN@zYi<B>S=N_wAg(05z;LRc*dYu*Lh*pM3%&U2t8E2q}5
z_9A@CEU}-N!5|w)W6&$~qVwOq99Bb%9jEuG@)(p4b#aU*y2BdCcBUlx?W+$M7QTtA
z8-W1jDS=!|_%o0=Nq1Eb>c4_JN9zczqHrOaz0~*%J;7-BMFD^=D60JADShU-c_@I#
zCRCW=NQ+K+&p~Dq<i>V>b-{E6@%4NN3^qTxU_cg=>ONYT$Vg+z&Uu}SJIh>^0;Fi-
z$yFV8bm2$Q3YeK4VohL4C86QFk&B8~k2xr|8`l$bFDV+mww1glua;!w623;b;f%UI
z)!Yo}3)+io2=D9pg5GDB!_c}hv@uyw6N^)dMJrnT%9>&T*?-kM#6*9Zu73{GDPzmA
z9bH=l*$$^Z+D31<q6kNKw}bkE^xiQJ9$WBViVr$*=)Cz;YR<;+#q%|*McErI*U*46
z-?5_nqH$Q9a@{jA1I=Kqh<Q7@S22J7o=^e3%F+h1&3moz8I4*a?Qxi={W3Z2>zj8U
z5>gii5r;yEdqJZKj;DfU)Iay88x&WIKNXpNRN!*dWamgbd~iS@Q_;PBr64a1O?UlA
zV;`tK)8mTj9t=|PrT6j%n~N!DV8Q)w_K%fN@-Ga>%!3<XQy)eo*eCh#<O6=KbbtLq
z%DMUaL*KxsnjB<Utgwg2YJxP~lQs*iN<JXBUX!Ng*K_qi#NFO|cnSYP6_zGC_(F-F
zHU-H)A<AGS<nsCRu=NgGN%(?Umbhrq<cbD8(sl(5K8N@lGr(8WAk9ThlTvaYyGXpH
zZaCl{`>KHab8Txyp+U`$3ovRAv+sh)C`Smj7B^UAByEedWnc{pGF+bn{zt|gr{9hA
zW9WJ);=B5}#B>JPxEiYT5O?fmY|XAWTYFPOH5Be_Iyds^Y^7aaN$JTlEuJf|WM1}0
zqPX}*0u1Z?6FNED1uca2*mbdXXg4(GZWSeM)Wm5xFO~Y=!xN=IE*$maomX}H1oOR}
z2|=RhKa6oTyHgkBug4Si$%wgw7Q#P(WMY10lMHf9@5KvlW>wFQgkQ^W`@dOI=}yas
zpx$41_Qi<Z*vO^B&)y+;Dmva_*Hi0Dl6&OkaoDZpjy2AWUa`Ys6}@efy@eM)!E|km
zCpZ~B4AJ`hgW?$9FsxEfyJI1K8`e9-G6{vVhDi&DgXSg)C48XoJ+QOQ<4E|*<H;xK
z<%afb#d5>0)V<kDUAsN+rj@qhB6fkXA<H2rz03jJLF8}rqRr#sI2{Ango)?GUSjj)
zGUD$?*(?|69d2VJxM4iXRdMkO`VRte6%J+*j_en!xRM*)7~$SW{q>dWEJ`SmU$jz}
zSngAsdSZ76CZZ*BB5#nGuan=!oTuvnN+{CEWges{72b)uwmpLl@w&8{C7N9f`TJ(j
zVF~s#K}s=^rtLWZAQ8FZ1Bq{Xs(si=n#z@`z`ahS=&v_&TCEJZQvH@0ljg{U;y7C=
zUsSgb0M#3}PSLdg6dq;g3U}Ul=^LtfFr5;`w<9TZKWm=!m;R?8BhaZLt@e8zvgejk
z$+MSM<gS@iIqLW?AjDiZb%GjS0Op#4U7%RbB37HP%OT@<>ae=}H2(3xLD8gWIz#_s
zq#=DNSRjP>3^WYoSNIKFUr&R6L$1cBxKgjYb-|Tdy_h(kefgnAR+`lIK3Kc%T`x~<
z5hLjjyO-pV&nLfbg7nocvV%8D>`>)wNo1YiSE<E2)8?b*F7kaTS~CN;C55^l%k$wT
z`DdsBZfV)<rwAdh^UefYNZ^RlW1E(p+kK9at0S%NHN37Ikq$q!%isHCBmRcKV0nTx
z0S}i>BxGKa7w|d#ZNW=kc@NK8Wmabi@gJXi6u91BP)d3J<m=Hm98N39@gDb)>rRU;
zV>xt@hC3?&Taqu)^)yYI6GSkci<Nn5;<3zyM2jco1f_ZFam0pkYJYlh#s%L4$$Y06
z0$Crsh)I?AKc;=G>A+K)&T(iyODgi$%Kz7(u%#J6g|l2}DMy|ZamhJKvy-o1Juar#
zaFKsxpjjo;3AbT<%m}UXi?`zJxh_!bw9;R#o0mT+AR~ssMLD|Yvil&n3aPPdLybq*
z_??pl<yWxusD}q>e=w(Re*2)>`WxrX?O*dh5oUZ1B|wtj;&;tC%;#nH@;8Hrz`ixr
zpdztDKWmJs`GD0X1J9lU)b|e2GB^tTh092f`V*Wktmi`^(%d1dC^Q|>N^e=u!3?V*
z)md0Nq1Aqo_JniuLV6is-;5YnG-=FtHyj9qCVCR0FGE{K7y{S{m`5B4OMhK6_vH43
zVHh#|j+!&;6;x?8uLppM_bK~bv{B17zNAvaBmNrf7kP4LFoXR?&vogT-8`dQ$_Nj2
z<?u5&5O{bmkGqwzphHVy<U&iz4nPe{{U;iX{MTT8gVx<R9E~wyTGRgTHu**UJ)sZ)
z<NJ8kO~Qf0EP3>p7;(^MUuvS_$AePM!_B@eiu0ajMwk$N4vm!jLiokV=DVp>T~bH~
zl2~~h*5gI4?I?KRhb7Hp#@V|Pp_bf^&{<YlIblA>mg4;}$M$>Ru!DZ-%C+^sbgmEo
zJkXIM^}j!J6n|l3Qu2d|Znb=3daAK6f>m(z!aPDSZp02>zv#51%~lt~-FS``pN0<7
z31|q2CbT_NZQhyKO;{G?++DfZTzpE?BU-CbwyOAfyi>*T+0@>bJ{iB9$%w~`oRXqY
zS{HW9EPE({Ee;I%{P#9>7EUvT3js227}A&^QNFpGq}K!d^*MfG62;Nh9sgg$nL%a5
z+oG5bqHdhFUb-gaj;j>Z%tyi1Rk<leUdubr9MYiR4b{Z|n+<kqtH(KY7OfO1H!jhH
zyq^0yYqvVSzWhjZL5^VS*70{DkozV3<jsg~1<9Ltn6&@vlJePd@S2V?s}thS&v^QT
zE8kU@qjhCH)=|w1Z<reSLtikzl=th!LJ%GQ0>#Viov9rfd3Sm$R5&hHCpq6h@Z%Ki
zTzqMzm(lZF7RxIY_qQ^W(;uN~!;V8M6psfi)8gIzs?(^ShDc)z>fZyXB<rQx^U3KU
zKgC`L7UI`YdFK<rUtUoCtIM902debfX>-S!iV+LCgpWSV5e4;_^^f&P8h@sb4Ap6c
zJOS-p*HL0vpM=P@w2>GJlJX2k-URiD**Ec?-+BK%=GWZKGFrZP9Nk#cCwij|T`Qlq
z`b`65_R5-QkQy6P?=agbthMgIC?0c5zY$Z)Pd}G<T2mp*HW~_F#g)Ox_C+#|C+;o&
zz#M|l6kc3*D12t8t05Al$i>noOw-xS4GUxUSMQaX-JhhHA!Tr0ga3=-D|xgre@)97
z^RU9JL*1MmKxz5;u_ms3O8mZ7F7aenM)T|e3JBt|-Tryz$YD!!AKrn~HocFF5v4ac
zl>wa-atO4cq)(;=!2&?AQ-(26pU6~?-I*c2jVyM(TP_b$b-cC#e2{qkyG_p{b4BAn
zR=~cSRzN|89VH~p<&A*swQ7xa%oHEG{pqi#J+qE`@c6jfQeEWHL?fzhzzLB|qr+4~
zy1eAw84*E;g~^Op!}Nr)WWm|07$XbA<;cl@7r(TReqn~Z$_g`akI4Zm=_-0^1?O^Q
zUU_IHX!!2i#)>OhmFWv*`{?5#faJKa^LV(IKVZcAO?1Vs{~c~A)~thHRBD+a8~w(O
zsW;M|3KC3(BBFD~xp3LZve&-Nm1lXhVh8+%mcUqbv+uI#?|d2k4bHX-Dn3_EGz1%D
z29x~*6<dpEnX8@P+p>gRtxF*k&43@-143F<(XIqw*+i_A)VI+cURp%l@2)z&;W+g@
z4uqMzx#2LcqU!qg{?L`E0xW~&QTRGWe}7od8!d|dYH!T*W|)H(m+@GTx%NqvV_QeZ
zFaO2=PNj4o-|mvNpc-a%xs+b8KZNwDJA+M{u6?o+15Zsq$WF;TzPn2gYN&x@j%Kml
zr^OyvanwC>Xd2V2P-*z>Muwy@{Ga^bL^s$X<h2LmzRA2}OFrYK2Z!Oh|F|ZeLV9H4
z(~n111Wgj34Af?*+dll?N=F3DKwF2JiL8zC`rQ~b()tl$#AKT#D6j8$SNC12U<Q{$
zAaO@fNUpEC<9~ZdiDX<S+b*|4@E0Csoof^++qfu$(3Xy1Z^F)I?dqx1p51S?fVmB$
z^)C?`osmb^6VcQ@{%5?`&%;Tu=ICxahq}ZS<Z8p$yb}2i6H?Ecr5lOkri5;Yw<V|8
zibsRo&%x(DH?D4zGg`#TC*i5}y6#e#=U>}R1FxX0^6u7<0`&<&+go*nN!>`BJA9AA
z&JH{H<)nC_>cIS>D`?e!?5S8iS2r?I{h1NorI6PiFROb;FRGKEJC?Skiq(7W&A5Z?
zRSe{4cCoFB@xHkc*_DC*U~ahfIcIsjwkpQhqawa9kIRR!ZALENUaKk_iS^Zr{(=Ud
zLYmAzyFY9gavF?MJ?=tcX)e4xmN-*r=yM8%3_B2<5F1&a$rWk-V`*a0E$T%#XyfvV
zJUDbiKy7x#IU6M5|M%cB?!xen<BA7?!F#+bKzbLw971(D<NBUO7tGOPi*E?<BYu~D
zCJ?piSkYI@I;5-nBP5<bW;escld#0@{Lgze@DY!{u}p92SaxN)rPN*M3JTJ>xQs+K
z4oD!6&X6%}j~rWNs<rc1Q;FVje{lKzcOO>`dExyJZ-?KGi6;)o=H;Bv4!u9DqTsiK
z`oUJ@y3v&0=R3<#mPP?hKTR4tR?l8viVC0h#bD5u^7}U;*g@xCsJa}ke<Elzu3OHx
zE~|&RI47BY+;OBKA7aB4|2v`Z(JuQkLju-%yY6ntYk|7```m9QWB3?%mb-}inS*@b
z&W2&NBvowoFca7^_#+9tP?G4}EbSJTprM#g1pvMgIUP!4zytKPS+v5a)EGPAedFWi
zg!f;&l@=iHxN!+j83ONzJ|Civp-{L%WrOa>l$pBFOGD}6xty<)D7XMJ%@Il`B?%Md
z6hHmLUq<kFUh4H1fL~>R9%fV2?G+K9MdyreU%EXHMX+?T&NtD$EW_zeLFWJrvR9E2
zUI*j;+TbowfC2;<Ct(Ig*3PADg~Yg>U8qM!k~7mQf#6#XMBek$XR^~pj0l)w-gBp4
zw@;%)>o(i>`|Q-<JD$AM(bG#Um9J#3yGmf~tHG313rgjPN3EHUCP!*FtV3>JCFE%3
ziv^AB5ABaH@bvEi>zlMyQI38_8OJ#tc|SkM=i;i~=7Xp?WDKD`ms(a-YR_)mD5G_7
zqMrql(X=m5tUNX^1C2$%-1z+b{^0ge(+raU?(Aj>eOW;%TXZWKha{F*k87{n`TF6(
z;6Xrj0l9IP<U99>p#3gL5@6bSkKD3m(tZdVwBhaU%c5|gZTD=16ouUXB{wsRz8xt-
zr4(`P2SpswgTgZ^x-p_MGy>@+RZAiMD^?)^o}zajGrm&)11O(`<q@1_d^bU_CM_=J
z0osN?xqp-INz4jxdhA5Tr-S8F-uW6DQ!7e?Kn&j@fW8c4LRSW>+s6G*K9}@lPhEd}
zywY>#-=Qac>dDJ-UFbF-{+Ge>5YZ@h&MCEAGHfL>r=jKO214?tYG6CW?;0e~IAe$K
zF@2!_SdO%PHj9>cNII}!qMtlhojSRhc~rv`JX#dkyA0++F8qy%+UVL?t}(iRUKhRx
z={`uf5&@j58FGJz`wN(~Mt_E)%I|24T+WxoxHmPAbB;tSO_HIjhyamQS8KdsvN)K-
z_4aT`H-u<_4d7VO1Y5r*eG7SS-fOM(Im|@$MQR5(wf>S=gCnMkvx38H0US9>x`K%G
zh~tY9Uffg(H*Sjk3<pZY^iz(E0KW?0=YyTuCP)k|Oi#)~3(N6^yl*Gv`oFh$##aO=
z?n3L$#JQDB+4p^xzy31HaXsC-bU~SxV!oSw$n6aEsTIeCf8aDTNokdFjeuU<$m&RP
zNeJwGnEpU@TpM3AKS~xw!OwQvNd$VEjz`zX(Aw3C*;xmZ!d8umBkaawo0#W1s%0HH
zU~v0F$rrP7o#+{d3ze#zAX`nN0~t9E5?Taq_nh7NccMExycM>=c#GN7U2SSOd?UtD
z#NN#Q6EjB#Cw|eHf0^RWx`Q*tJ{t6psU1@k)nYVkN#g61qWUQE*(}SdkVYugo?B(T
zu~RSV+4p3u?*FP#7&_oHlb}#nHIp`o|8t#_zy!u;bT0oiF7uqa>H;`%-Fc7_bZ2rt
zyQ|{f>he|H-htFUN+QM`kXE4Q6@MT3+CneZAzL(x%OAE&4(dkFI>fWoN*#%^z6_)J
z`Xm{1<4F!)k#q$XG$<t5rCI9t7wE{GOn#iQ@AM!56c9>#z>f+~WEs=n4YTzZeV1Sv
zp}|qW&g!;FXFa$0(3Acs;+fg;bD@Sj-WH5Dc+PU7$>G%&-tP3khy~fpU5uJ?qj-PQ
z0p<wy#XStXSncCu5$$;Ot5ziV2H|hk?WJG|uic0?6(WDn!A*v^|K6JkGqjkVVP0rP
zlL8sdThFfIi->bdpNw(@*9=m<U8ZmsLY8z;Sa%)=72PcZ3|o%p1^WX*iF5iuaV&Tc
zkuyo;AL+pt`rA^@-jdeh8Uz6UBT=$rJ=>P?#EA#?a!C|9m;PghIAIO}e;5_t-k~`>
zTI;cl%XoETM8lh*pvB)MCVB-+;&{5XeB&msRA2L=x(Hh}p=dm}f~JExyIN>0GneZ<
zhwSeTFptbi;XmoMcMDkwrjxXSeTFY`l2(0^J=|qcc|FxkP{UF)PU@OwXADS5WF}{B
zW#EE48+Erv0d@ts<88_NLuWXEzr}RF4KCn|IpEpXxWn2jPsu8?ZI?a9)Jvi(M*kH>
z#?0++eH*ps_P?$Op>=JkLm24kp?+zU{9t9oEUCC5MQL}$9S{u7#ALB$5sOb=%xVpI
zrq$Iu{-zHY9rfKxou2D<`Ww8}Q%Yx{T_MbT52m7`K%FJL8I4I-p#(B)M|D4zMS?}f
zNi5Wmm&!8E_0j12>`A)~qEWMjQieH`=iAE=UBcwarx*0V6!%=kfaGsJyZ{QqiRED0
zoyA3lUesEwuxS~culdC-8#>;1IUA3EWHw`nl35RgETdTaVCt{w-^Cr;F8(fcq0kT^
zU|SLj1Yrq8$%ay2g=*P2(9H1A^F2;np>~YLql{3lY3`gqCzE!w$bC;`?}Ut(7b6@N
z--GIv>Mkd`yCBtaeeQ4fH(y4E?Xf1X@I=fPgnxC&@qAhUsxm25x`zaJQg@T+6B{kg
zOcz2jFu0BQ4pI+n=Kg~(L}4#vV~g`?#COdh2fa9N2{)#qUV0jGA=>lu$`A1BMgPfc
z>OY{u$lQWuU_`$mC@zJ_7bUHkg7S`08|D`geoN5xV%8YU-c3jv%sc8j$HjnmwUBdH
z%De#<BlJZZ+XsEyF-Cp+Ta?VpLISHVr1?DmuQlp<o-3oxlVs`VrsdMHimwOI6l%~%
zf@5TB<zTYVDiD>m0pdRF5`+;k7|bcM6In;`B++C4vHLgn59m!|w4H8GNKd%b6ZLY8
z+k*DfpOXx|k|vA7x@Gu_oE`+_|6%Gp1KIljzik9Dlh`}9s=d|TqZF+gRke%SqllRx
zX06hit<g!fHCtM-B34nO)Tkn2R=*@h1tE8S|3`No=RtCEPR{4NKd;wyrCF&bO1rVq
z>vQ5SZ?N9f2UoEh;)?{PJT&DB22FVPWWNqYZed^*n{U5nr}B5jbF5ZBg_))L_<7)P
z*NJ{sRRULwQ{@^|QesEVikKlVQyWS`e+=w(<T7co?)nvu7K`idFSZ&fAp@FtpU;7i
zEZtqe&e+8}aJocuH)B4qLn9CCj$z`JiZd!=xALa@W5t1;rbU1U%^gRo{(oPBTvyTB
z<+ZOB*!M)xxis|o2YQL}U$)e<N=$;6N=Y7)xfC$S!1_Cv`xP!!)Vo<dq-CN)jjpmh
zwVXF(;h>LyySb92JmM>Y6$jtRc3xMzhZ*-AaxEg+e8#~uVRKn*2rr{BV&@9>yXMv<
zw7`eSN9alay$MmZ?&k*L2R-`4D?|L+gGg;SoSj(;A!*KgNVjZtiWO%aUb^5nII|H8
zdZD=mr!+nGcVvP09rD?m5+|~&3vvR;3cWAi<eEw+xZ4sXFimIT$ZI0sECbe4)dy}&
zAGiK_P)`ZzzEEz;fUMm=mr=z(>1+3m@hOK#98n5a;V(;MyJ3maGKc7w83SJ*bV|<D
z5IDTe{jO_=Yvl1;bx-9h;{_H2s-M#^+H`<;zDRsMrAQtLg{G!<b}^~Q^vw4@&EP5t
zNk+kE9n{03kITvI%vZivjxW>dDX`yKuz~0@j2Q|9{)mE*by<2;!U!=9sZ48M7(a`F
zM<8cM&0KMq&<L#v>~D99Iu<3aX0d+o#!7*s!rjtaOMG)6eyy$QO<n|798988L(l^R
zv&gue`QpyyP(XkiQ;kW8xM%7o9^!8vp<e;2!kma5%R8D}kG4<?wu{t1rL)ERS2=`L
zTpy-vnB0qCH3wPwm~OG3*u`D#MUbD9EZy5c9YZZmOZ7U0nL$qLoDp`QGBhh2LqYdv
zT`CmalNkYGfR!ZiNCJh!Mq0|&l#<}^dQ$OXc>ceY*2X?tmfp#qXFdk|DPlowWiL2Q
z7bYe9=-Y!7L`*3si2IYwp9OVNcnixY+=olfIz_T?8tZkAa6_MA**rz|8mEz=9xcS{
z^#V5sp-V>P=I6Kb3*4nbyC_y&9!Lhvc865xQqiws8dP<FcG4$Gw=|4^-Xb;oSk%8H
zfEue>m9G|1K<wXwRjY7}!g(zsuN%|f!)9s=>ExL>vuv~_>vaukj%3NC#JA1`F~4oT
zIoN*gH(I^K_{!SqT2|Fs0&Sn9z-~5l8FbyZi4&?F0Cz*er(wU!Zh58|tck~kPq4`X
zourz@TIpG+R}%Hw_65Qvsl-FK$b4fc)$CVv(MNKBqZjg;$xOqbTJFmGqBRN`H^bGB
z)X0POgffXqXa3ymqH+F~V|b~m%10Lyw`+2`dc1`F12k_(9$HwO8Q5z$Cl~*^Uz38*
z$+xZh=JC`(8sJ<cTv?j;+IM%hFWSbx%}=ljnjm>9Zhbru=9Nd5Kv|9!+@py?Z2=?n
zQH8Xh(&U(TeunF4^|(s~oBC_AjpT*_^o2{K=+G`<h8}Te^L`&0g=y#ij66kmJLlPc
zvF+b!0I0-~(ZT_fE;HstXFyqWr$N#kw~{+{XI<fTA6Qn-_f!kc`sB>qnRGsVZpuZu
zTf#8+iwlNWtBd&j*Cca!e@iB!&JSTTRq<6k#43$x*{hW~C3Q1RAVUo-O`Y1vYz<i;
z+5o}BB>5kB0?Li}X}g&*bn%HQmx{CQN(PI5phxV|Nk%>`U9>f^sMjAex|xL4&3Nfz
zDu3k_BUx&H2QbFHX%2HxtTi7RLq<Rt)-mZaBP;<n)0mo~NZyRHxSrb#c~r(d?N)bJ
zr(ch!{8CC|*L==}1xf~Qx~Gg%ayFaa!Pl=W;80>A2PSo$<%*1Jv>&b5gt-zQFC{2Q
z#&?jW3BM^dV&-DjP!Gu3)e{Jb;&)vV%~;bF&DuQd{T=`H342tasw!yiHO_}BwOj7@
z3wr8iKI%FR6}7r>vp_GRsA-Zt|Kvk^gPtLWlNkHl*LFeeuL7xT!EC&D+QV||fq?wK
zAhZ`>qXDrI@%u8=G+qHK%K`uI{@>u6&mM%M0<gVh_O_D(pQA}SN$_k%gu(4h(-EW?
z0rG6o-lU8#0z)H6{m*ScN%H;le+{{KQ^M5tyj(Kf=@}^Rlm(EJ{}0!54zJNi^s)aK
ze`a`HosYS2;G7bp6m9PE4noG?#N|&e!M0@r#hao=Qp#`lr0!xR_*7o#YTLTBn-I&z
zM+8FRkDmSFv#pFIyurqe%knZB7$zVWe1MEyKD~I(RYgMKzzv%DK_sn71y^pq<@*Sf
z5>NTn=jE4-I755w+Zxa-RFYbYu~~c}=-1lj^Zc(ZHfTqLgfmK)JD0$8^_qN{@3YBB
zT?WSaLt1~k%AQ`P=$T6QJ#m{DW&F#J`~Qx!Kpvh9v$IXd#j3xnBZ;KTUhmyaec_Lx
z`_wCLp26Gw-&F#ym)BMU*P7{zu8|@C>)K*G#e?2PjXoIuZp-Y&_j?eFC=~iQkrLV`
zLUr*t%{w7Io34r~cGoU3vSZUzOh}5p_P)Va8qMjatp?@wjYBYm167o2i4aD#hfLA$
z0XALRo1y81PfufiC~y?LMUK!!u*a22h!%;1BJEDU)X)2?!3xHos&?}<-a!AzVyA!U
z?GjTy2fW4@SZ2*C55HtoGM^Wq<XPDg9^oPpG~ub`z~1urZ13RlOM)Ed3{^}*CO-*{
zy9Jj{Oc$y&q{A~MfUBk-ef-Gy`%Bl`B4vP!pdaLAwez)`U=m{tV%qsPp5|ANBf&s#
zr;O%zB0@I--to4c_Y;WFI@GVMWE4&-Ft>9NPvx;bDZIq3n(ADcveCsVmnYTpH(B7>
zt=wJqU}~Z7<_tsxFn+n@r*P?u_k$-B9EfE9$sA}CiHc{mbvwi3#|4?Do5J=N^6V$(
zY*)qE^*gAnEckmcn)+rK0RPzy6^hQh^1-qth8Vk4iSvvH*QPqySnLn6R0E2j+?gWk
zy3Zi4^7=%XVUXUgA;Pod5v@yw#|oQm=mV+Rj|R{De~Knx()B^5oH|cTHi5SmHQo(r
zze?O(GL9YuaHxy2sx3U!<~~5v3<@?d(e;;h-(RyPa^wzPYd_Ve!u<a59u5KhsiT!=
z{y-fTS_s|EZ{QeW>=H4!P4ejg&DQA2B&zCE@f!EJem{uxJGCqR7#e8Bfig51jB3|S
z^qREU#q=esd8(r1Zizt7R>^SMUK%AqXPl{t<c!TSl^#a3lG3Uo%uju#?Pq4^1UcQ@
zdz5|;zQn@I1Q2<|$@;>diq#;A+>>~Hw9hP%vF%!qi&RJ~D6uT29QT_}=?Gs1g+fYr
z=K#k69wLU?Np8!@Iz@^Do^PbTbacyB8nKLV;iOZ8Gp<PW7L)fY)TjU>a(Ul4JqC}+
zm*64QgHf5>&4$!^_AL!1MPcE^CdhihTP&8fSiH#lWsg3AzDbIjTHp_DaOf`nO+Pil
z7#kolc8%m0Dh}@zy}!*gFTP^;qrXh_)nByxei&72x@WOc->6EhOSC%1n#hoUP2*N3
zGm+BQ7TuOFXn8Naa;VY|i|@z3+s8k}{`g)10VLC~Vi-P5RaBR6t$zqZJv1biRij<5
z4=jO|psamFhTY0uN}Aff7QF-8rvgPzCWkb8oKP`z6fRq7$P(;+O@y?!-L2H<?L#m>
zu!rAZOK!O|==uygS*eN8@?CwW8&2r=Bi`P%hxED0{DG$53ovYNP>s_ru%7EvKX{lg
z%W93>+;@X`jp(|78M+D1Z^C;R55sc5Da!rg8~=7&lxzKvOd0!Qyo&3@g2&}VD=U=@
zA?0=M=k%ensd7OEE6@<}JAaw%f1n2PlDUVd<LXTMqo$YGpR2B1f-?nvu$leJ^P;j5
zaT9S)rN!<bO@P$A0+aWJW=~BZDW=m`wU~$*)L1gphA(3=^~6Q3;Be$`GRai$;UvSO
zhhxBGnXUVH&LH)&WN4xB$%B&xoZyGKlxvNQwKk8n$tA3tomQ>nMPf9u2h`bN(6$q7
zQXgqS4{}`-!yhR_GyEU3N&bk?nlF<(xD}3(oD{DaswzynWDGYYAZWs<n_y^$ZC3m-
zIexR3uXDBwK`Z&G?sxR_+rK>He~K}MQ$JqL2>~;vX=KzCYtPo_lKMQ?%u;{Q{x{9S
zEB|ZZpQ)ltw>~gj-rHji;35HYUJsJ`=>ZCVR4{mfrswxQ%%5<qF#}LLu23Lx5nl_X
zU%CyMH14MI&fp$2CRX;WN!hv^rQI2n1HPQ3IgM-ew!d)i=$^(&2rx&6F1nvCKGwPn
zSq_2WMG~7SMx4Tof^o>{!;fDQP3Xo8M9Wl0;*XrAD|N$od2i?Y1ZQ~Py8At(|6-Eu
z5r!+gz@C+c@fm6WzMB7<*)xR^b<LkBio3Jit(t&czRy)J^f_47A3C|#KB<T$#jjfS
z{T84JGb&){7)dUYy2PjEDy$g4(qi&h!w;rjplOFP;T!LBDPG{U%R6TWAhA3GH&9<|
zHFu{VNptMV;p%&*ne~JNsw3+V^FlWbDAD9lRkr^kXvU!iRH{mEs%m%jCy~CrrJhfR
z2jadawU{CR<01bO^N38i6TuM`&e-m8i9B?uq5!}w5iB**7tL?NNtdU8OILtI0Ng6`
zLMeY7?GSv%PUZBcOh|X$eS8}XCFWAyA~)M??Iki@mel87!s%Dw^H5Te;br$75eI(h
z{skjy54M3<UqnP$D?WdsZ^XB=?ZtLK|1R4xq68foDF|EBHS<_abBX_N=5ydg5-&Yl
zq)(0OAW%{$2|kDp=?q+Qb_Y9$+Rq_vSZXw4my89;0fth^+7RK;E)Ev&Yx1AM`lL1T
z%O5`D2w;*Qk~wzC2lpp!T!Kf&pQw#A<4ro<vp0XTH}PDmKGDz?hO!OBv+JcWoLsib
z5vyK_lvhh~uRbSIh=WdiF!PKO8CDv;A;ROzkNn1B-{7g|)LJny+pOAmbe)HLn>|H%
z=H>vxyicBHc*<R&lGA^o(6(B<DG1N-Dz^xLo1CSFRENUJ*hK1Qk}Q(?9V9W&b)S+C
z<%C)&iF4m;c6xH5%Sv5iBlxz>GwMbiwTg)zTx6%vA*aAIWfA?@^;PxX{@P0>cgb~B
z;JFSp%@e+oHy*?ecFjfopabL`78t1Z8b|-$?*k)opJ?z)lBq?0c6-?`&%V2F&>R*i
zHRTbtBxRl*n!wCo!7xzwU6vczL018LI`iQv0|WdTxTQbqks^EjoXV(8Pe`|fhwH2=
z&1$ZRb(xUptIrVp7)l}{2A``5eE-1lm=y8MrR)&{U3{C%Ncij?wPOA3u03dlXEm>k
z2xH{$ToLhr@s%9l-y-hp3TUzG@&n|R^xkR41}(E>*jVhW#4ubM2~-T+cjt98weiGc
zedr@s>Ly2>l8e-z#-CG&SkBN<$7|MJMN+`l1i@~hrv;l^H-8Geh7*a&?u{e}3{=U`
z2SR(EU;~VQ5e`4Qzdqrguz!rfEqG+F7N}&;97kwYIqJUCc{JEMFa>GMLTfM{B+247
z^<9uJRDo+^s!_0`t;|R&dP6ew`}d6PT|GMw5;z9&xexBz!1nZ8`8%PU5*l(uq4LSM
zKV*PV?WFH}cGPd$_>#;6I-wAgI!kiI%b{@T!`o}jfzCr-!^+ehO)?MFP=&Jpuu5Pa
zf!BYwMrRu}AFX-yuo~Zh4J+Bd9U>?>z!>_k=+TBy0jTmBiWUG~ohb6;l*!pPOY{+L
zaLnWV*A?7qZMl+8MPa4Q2G5hY=x1tmO|TN+r9vQhj`(#_3oH^J9uft+sn5YAPhC|J
z8UQ*OJ~&4OM4b|=!h}@_i4gfhegu>A%IFO|_2W+LVfdA>BWS{d$W5&YzHi8fYF?UL
zpJ-&@eT9v8p0I0?K3}fiK=?1aizaiR6R7L4W*fM#HoMQ0fpwYVCBPoEYRpyc;X=){
z=HO@Sb8aEx`>Fam1&yiK<yy3~3PwgQyA<h~&aQWynpy)Di=H=+tjO!uWggseK}`v4
z4#2#@qy4I?s`7uF#4W3{SF4(C_Qq9)IhXb^cp6@x0fdEn8BL^3&G*qR=nrZ4Hl8Ct
zGDc1!G{C+s5la6_7D7B1dAVSoa*XyO$ssj=)00(i_A1eJP%|HA{w2kt+rX%y1}UQC
z(wUFc#Gm!TET0v$j^)I)KI)8wr5Z%HM_wKP^y&js^NW+$Us)bdO$KXtwM!9$!|E0|
z2))jiD$r7fMJ1R2SgRfc`f<40rmfx2SPQ$9VkX^9rRm#$;vQqhMKU!DH|!0Gd{<HW
zsJ#~HpNS+hnVz^1Ym{{kSGTCE#$YdjGorcx$JyU+Jg8SXjKSNFnem(!T&;+%ppy+h
z2734!_CuJ9EWQmU)E4*yCL#m+Oh}?ftVB(v_)QCJGAK}Oyf_qE(dM+LqY4&%0Ifcg
zn>`fd>(J$^fvMWRK(NN$-B^L+t+fYll<;2TI_y_Yl%}FlbF=3^O>1;5+<pAzk3h#g
zEk7ou>o;6IKX7TMGy`4#a?kt?dqHXFgJ|yS)FXOy3qEsys$&-;O>sIKF{zg=>#;Nj
zzo;4%Rr%`wmbmhOz3|%Dlu3>BgwZ2ozLs~y?;<|qqqR<V9yvFobUz4yJh!-g{0j*D
z??Fb?$9uUgWXWVi%*TSn7Z_NUv2T(FAm{WYCal6znA7cg*MSv7hHoaj!mh5$bz8>M
zmtGZW_oO37AB5YDRs1HGLZkssloN&YxixTiYKrfB%fa!@2)=?j#S%90d-2khnPMbn
zFWhGp-ug)&j}oXNz}+&oFE|6wvFt7_j{EWQ@JY|%Pe=O9b?kpE)PwXJZ}M13s?3M=
zH9r5ygBC+?UOK;DMSLRj@&-M?0KWG0X$+}>K@X%14sJAJ%R}xHn6q4y6Yn%!wZog?
z+`DbZ@EE<{1skQ+FWhDfNTxc8<YTk@js}@#B-3Z!szhfCBR$Q!sjc_HgiFS^B3%sH
zeB_~=1+Jug-)3Fz*>^wE-z*cqe%f5nQfQixDdJ<qs@N8%^2^677ODA<v_m`yG|q%6
zVetqqnDoXLuiRYR4Tv}fuq3Xbl<RL_yv91AU>I{cjF{82!HgvxMy*jIK;E4$ZVP;Q
z=EOgXHZ?7xj;tk*1HKVn9dzVH{j|GUfWP5u^<pJPHV6N2)!UYbP)0;ts$J6&<85gL
z$^?X^lDtLrxJ`By0?62p6q=X(Wiq2g=6<Eiq=>t~){FO&BVOw+c5Y88{i9OdI`M;$
z_T%{7$uV<-oXsMmlb+p$WghH!T_|4;erXTh-^rw0F0p&qv?QAZ?J@uMACLiIK)M|O
z<|3ST<)}NSRt@W1AsU{+rz9uaKQd}pD0^r$7hd4LmS+!{v)5bG9ad)?NV3^QGSCaN
zkBMJI;Xg(T+XCCx)8+u(4^(<qAmiO3g&M0g2EU`M6G$3K<-@0ExUcZ_wx^AdTAO~F
z2BU7_!-%3(L@T}IxSF-FUeo>x>!PJZfB)^F_x(zT)#KUD-JvxpSn1S-e;Gng2a&a-
z<MYd8IzplG;<vh)KGC74-ETHC_ZzLUG<AG;=Vr0*MFsl*X>3`G-HmIXs;nxQV;syS
zZ59^}6q-OZ0Tq(`OnUfFH|C!qS>t}&cfS^N0$v%`HTVeBmFivMVGRF8fjDS!=2f42
z)P6{186c!z?i9iHSBq~`TX%DgdDm#17~VU!qdpd`i6_(!c)_32%_aLO5o4cdvPm4k
z6NRW|QrUUxd5tn}Le8+f2b__^*(|<WJ5Fhh$cSb?&o-8R6IE5C7R?nYHGh)ZQcMux
z@4*^RLn?oT3hxO9S6-uc<lc4SbJc0L=q*?%+^p2MAn_@5^b{qwnxJnm)Q_ou)%Ufa
z(u2;Rk^#Xu$6Cezsz3aL{}*z@=t%Wt;~HI9m^N9;uUFsE+aK*HT0-khjW^K+$MF9-
zh~5*E?JscTr#zqxD%nV9uN{U}2343T{|JVhQamU^=qfctEo~j`FTyLXwGPTiaSX;r
zgCIuIvx5RX1W-_jgptERt6jDtugB1?E4^A=8{YHwl?PfVNj9ssln!P5kuFOb+t;I|
zvb1qt)KZKMiaqKITW!+-{t^+mz}2hnwaTxX$#CGnGIXa&@{&nkU5s(&WB<~dN3=j8
z(;$wuM7t3d)8XN3@0vc^L7VHom5~Nr!lsT4KI&)TUkqUw@^!_3CIdfXORdR(nAWgM
zOKdZKtQajgRW7b5^n=M;<WaH4FE_};Yg}N5V^S>B-|^nFl3VDAK~pl;{Vy(sT0|&3
z{OF9F2%dIwFYj|(I+RF{(Ea7a<zaxjCI`hk%;=%asrxPtc(XuM*Qw6ook^ePkfQ5%
z@-qT3q|IF6R&yg*bnB2S(bl29NN!|<_;>JupUQGbDdnk*QvkX<*YEnv=by#OMSQa5
z6b0kFTA3e&eg{qbJa&WI&D1&hdR)g5iv7UryQZQV%<fXG3;*<0(Suk2d8-^+wLr5d
zqfP_47K?ojA&B#7R2X)G>i)$f4z9jhUQ49>(><KYnPlI55Djlg)eWQ?!BVGD7B5P#
zevP^$a)sQQsEG6-am~Kl%nz9B?sA)-FJjr7p!C{xA1JR@z~d{U&Q}0V|0Vo6h;&_a
z)2VF<p-+_{^i6dS;TP@TsdCi&P9<z<`7dY)sO7M=#0ya8#$ug6(D)`_+?NCQU`ksC
zG>#j^=E6KD)v2g!!w5DoF&T2kU#5>FweFskC{-V%)}x2mdglKmQM<@iAhR@$*DJoh
z4%x}03yM<`+RbtJpj~54RJX9R2-51aFQf@~FD}+37DxQheFnx!ZB>tE102;fPu1uV
z6DG&;YpdCK)#U!rTeH+p2T%eS%?46y%q_F%xEELPpTWpxj)-KHddG4SrSg!P6y7K7
zLhYh@6|qcNXW^xtKMUP~`R&qXg>?7YxXr3_KG7%2jV%xFkAkL}GHfmT7-1dp(2SOs
z!hFZdK%C;%YSHbic4BwH+EqUmGfZ;V@phd_qO{5l3+i4=AdRnOp@|jFOE|HT5h1_w
zs<e}zjkd#axzDET)M)(=+4=0~+1IG>L2%wCE+}ukU6yP1lE1poNzOdA3ZmBXVu-v{
z|4AHhjCOauLGPp?)+p4c5Em6iDOK}7d~}}GNX-51Zgc$@L&<SrqT$6V<>iT}Zd>4?
zc^4y^Hy%uYqV9&e<VufZ9_u9oPa2)28V-CKNXfEp<%{Bp()S$TXxO*XU8_XZkaUGJ
z--9b88#{Tq0OeZR6po_AMFS1_!BBv=N`%|5x3|1~;&gjh{E^C2!eWhRKJQ3l{?+1J
zhKNZhJ_*y`W%)Wyt8WmIrIOiAOx&H;GdP?TG$Z3pGQO@5J4}T7xUcCroFvLSJdGDm
zF1lYXDtigsc_F?{?>Lg*NGSOeHe$1wbX-f}>7Nw6C|?F|;bg`?r8<W`LA6^aC1g!N
zklH;E_m339Sb-Z_x20Lg#!{H#Kpjc`KO{-OYs*G>X8ivAp4W$1tE=xgIXUg`&tQTv
zx#=>GXWl+DW?n?5A_2%jSq2@^06lP7p+ez7fb`qXr)tx;5@I)}lh1OG60WLoSf)fQ
zW#lz4%xkfc?kLq+ulp7Ga)vyuxP4`@q+Du8{l0X#)Q)Erpn@!cc=F}qHPhs)>(7fE
zY|>|{p3auNyh=@d6t0Gm@iaCzc1p1`dft+A&R%BZYB9~6wV~dAw{D#Bu0dgEjr!(_
z)@MSg?2$K$kQ3F7NkKh6KbwAbjz~Hhr>5qxefO~K7?+HCZ~_}#<arv0f|!WZY5uKc
zETr|XN&aBk68P!i`dh#ZeM1yl{BD0`*_D~5JPxzy1|&`u_jI4Sn$3Y|pz`U{=6+*h
z63e>M`mABgjkC2f4G+%04+4!I-#foQUrJ?=<meBUseAY@B1(Au$dM*a{%@7))s5dl
zL7%_o-8q1f+htMAPCxfrpEd?=%PZk}DdZ9geQwp&tsIUt_#cMk|9f3Z6Wt&3hJaq8
zB%o<QFph4)Xl-XhMb?N(BlRPt)ql1b*&wVUVBt1b66-sZGu_N|jq>|0_s$=6l53|T
z9G;X^v>=@@&*t84>dxVzy^d(Evr}=gl=ILj@6U)ASuTojIp+Zk{NVnjl+<YqXE{-<
z-5J({HrP5mC6Vw2*#l@*r^@2gJH44m*n{?9j+Ec=?l(f#RF31cx)uwJ;hUSV`31;a
zW5ZzhO^15qd9Y;-Lea--tC7-zK9y|$r$b2k-qPxN*BHNEL&Z1aOf<rZqQHxOl|5*l
zPrAv$9l4U@gN}dEp)_Gp7b~aafvB7Oxq7C3Q0Is4VuF88MwCQ=dr#WqR`b2syX||s
zqW4Sg@QOT9HJ1WUfJNQ$MsAAl1Df)A;|j=x-T)hS_LHf$P*Rm2kC2Zipsq~Ng%xfF
zPw%8=VSQX+XhXZZ&9O%OZev#6CoQjd3`bsTA1QD7O3BGIvK+&fOi`$4<s6F4q1=S7
z9mv%OlI0;vjsf`jl*=Z1Fhf87nfJ>%))fG~@i*NT=lX<l`uQyPAN>jbzIvlZvkd=T
zOJ*K>ctH)Ssvtq^`*-9d9Y9R~A<7sf=<N}bV4-9c7_LKNTz+&Dw@rybHs0j(R^~NN
zzPH0nX?~*2j$!$babO7Go|C?MD3A;Bg(%)%Cp)*B)i6FD!cv<OAaWXewFA{A!*|6~
zU%Y?{h<m_`f{ckM_VhVv1rufk1EYFIx5cK8ANm@W$M^KH>G|J9yOp%fao~oy!wbs2
zRlUk0#X`iwvIoQO{YYG6gs#w`UYW})r9g)|j(1M|u8-n}9yJ%9bG4Er*6XoaV-vVu
z>P&<<(bm@o_>^v{X7D*d$gS;~;@+3(kJbY1iQ=Fa!%Y*yj)r!>=66?H5M^xO*k`g-
zWiwQTpr-MQ6X%s1a}wKp&KLsebGg1tGVt}y>n8(t6mN8`h0I_?v^F1rL0<H|#cb~$
zJHb8B^x(8(Irw4rBM8^beBb9PX+=$`wl7}_3o4mM>uZUz0suCwnDBVpL%lH%B!D*l
z3=nUC4YHo+-L`L%pLk<BTxHvpSRAyQdIfKjV{b#e+BO27H_W4AynT43seT~J7cB0R
zkrzo^=y)c*`6sR1c<pLLCmW+~*at&>hJ9qB-kkGCD?3yu9I5>zzP@2z*n>dCG#WoS
z?{AMIeSMkX@#yfrN~hbe@i`|cjI%`HSSBTMYxvp35Vm&%Oeqf|1-(UC{JFN0SpSH-
zCEwZ1)kH1phF`j$+=Qkk1pVZ<+PK{CUKx2uA?Jr$$ov#ok!Vp-JMNPU2S0%-sb!sX
zHzs-fIgD_Rxe`A3k^_CmmNhTwv8{=lWN1vJRr=|tJQ`Xo|FF6eqK1jkcVjh##4%mK
z)rsa=QfPGZ$YXga9!q=PaA{kg@Q#s-aF;Qw*#&3jpP|<&z$vx*{6Xdr2<%FOFV)r7
zp!be@;H4>7ANRG+()bM!CSLgqwbb^P<)Kd^kGZKwz#6Tlq=(KNPkC;}hFUK&LimPp
z4}pJU>$qQNw!rbUUI{_8ZNnmEj<|UJ_<Iy7_C>W10awtq-Mw>+KG`4s{p_#^5V>Vr
zdP+5jpwm*u(P=Ymk)wMXl1Pr%!Srbv_QQ9Qfnf<3%g=uIk#ttyY3Vbq*#_?aJRk@Q
znYmox9io5_m(N)DSJVQ$dz*d_bEL+POB{z(^9%wupI{G~I<5?|$kW~e>!|c{@9DD7
z^Wz_yq0SQ7^trzDTK(i`dI$#;kyLdWgt089=BmY9+k03`6Rx@HEQlhVcE19anO0E9
z7F@G_LKLrv=$m?Vf{p_6b!<;k#I4Ug{_JSo`j*weJ7o$uIpFV-c>-ELIQV8o3(sm3
z4r23JycDaqDb8fiBuOjXNul{b1(6ke=HB{{R-<oo?d_#*0HP;diYpndbLur6SJ;D@
zP%Q924X@-$dWnDb$DmTzT^IR-mipx{;(rVGmiLaw4MSK2$Q-OE%tjAtsD#BgGCH3Y
zV)ApJ#RG_9xYQ(6SHhay0gw&mteID#TTTyL4NJqPzfbV-{)<4!e7r|1BtRbLXQf$}
z`3S|{aeeH^>vd7w>cQ9?)N^*yr|y`>PiHjTR%4LJZpUcKkwHUtK5fRC5zog4(Q&uo
zWN9ceRQ#sE`kVTX;sPw*2_whZr3JVs;SK#6P1H4=Cau-&#r?bd>lB_KWnHVu_CsgR
zooIWy>V7~-ye%Gi=MZh!N$XaQrka9P=_lQKb$%JfF`+2Qg|{+?20FTt>83OAqxBl$
z^{fRUZ|0K-j)?04_AE(oKAjo1V9-YQOdhv@^c>()oi|WjGNos^cjlRaWXm}eNxXDV
z><+BSpJ&G0*VbbGry*i+a4;;k#$uTl>($bjv+Gt)wAK*fcGxGL1v$^<Ih~EY#D91}
zLld#Fb+adSh(7r;!Jywkk*-aXkGYfPeyqN9-e5TElT_N>l}PkbW@NpbxjuMwJeI)Q
zTg4IX>OmfvPX`J<LE^3Afgg5WTqQ#a1a&a<{aT1_8!5`CVf;-0QdCEq#`NNVP#YdZ
z*=>`a*dw~c&YiGO8X$H;>1*0DNV>>7T|5~LO}~@19)N5cDK`(RH?t{U@4WfJBYc-l
z)#+3sG{rgo2mWsR)fue_MSrW2n-xwhiga+xBExD~eXR(1s?Ed58f-J+SHLh3u+oh^
zI<tln3zjRWoY^_;83jIiT#BBMPk>9$)pW(ZaKb>`f6#<Ir!DlFsCyV!1(={3BFO<E
za18`zv_>|U*(oy4-_8N^JhQJ$TpD3@h~SNpvT*oSSisgJ=l2|xH8N6p$$>#cyxH#6
zg5rqt9l_iwv)m;52x<%ZFR!hX5VZvLae4WY6@`2s>qp}^o`l8}LsFzyp$A{29%G;b
zgFi?OxTZD(kPp7c5(ct=@7y$-tm|076-_(^3EAO<Ck1u1x|!tF%cucReZl6!Wpyvc
zpU$h_sH9#12CzIFx`why`Dq{_?W(D5++jQDz#xmqn?=Q*8|B$nx~6LZ7V)o~5ySh)
zXB}q#T){r)6#XvCF5+8W<-{rBnFyeF(72bc_C2icXTk}+*;-<IbjrzS1XTrf*$N=0
z=)3gJGq}C|%K929{<SbHK%^h`yq@L{g6BLL^7u$MKvGeNr)+X&)|}7-asDXyT|~xl
zr2^9T>=|krW%_L9hy*$0lX<kFnXi}%<<~HP5O{v?Ar-)AtZog$fIKphowZJJng7uh
zEihax$WN-F;tfko)<+v4gLe~1>apEQDrh(vqDfEIlz$RF9FraQA-|I0O%I^s0Y*pm
zRc%jCqPecmbbk46x08OOo3y@7JuxI6r1nKFD;6`4M^Rh>9%|okhFP@=54=drda(m5
zG6zFIBuxe8Hnrak&%hbyMB1g&v=3G8mfFS${l(@$tZg`8phr&Y;_A)tlV3W!0h~0V
zd6qI0y<hg%n)ZtczmmICPO^kl>nwAjhZct^KeV?ap1$&bdZ;mtH9f6SFId3<XMR~X
z6?gUUQW=~;6qXfhl}V%`SBl7n(M8?kKGP6DGhL38ri)7D7S%uSIcfD?y0x#@LefU=
z+bzk3$z<6O+q#SV`^-ORt?q6M5AIN{qQer-lGf-g)2T)IGw2kw{6a?VKi0D&Pbw8;
zHS+z%p*;t?aswSXt5p{QWnX@7ix%*Az+dL^r2*6d{f0VUe5s{&PlgIu`5N(eKZQ2<
zbMS<)6*-Jl=XA%8q1%S~<XtqVs3Lj=_fGos^|aN>Ha__t4@6$C+)dT>HQ?1CJgi;&
zrxLwNTVu+i#1NLMpjJla8qsJOFoiuU%m^^y<rs9Pn5Rv0G9(C}0JY5>-*BHWQ`7$w
zm1FhNhobY?p74Hmv9Bhtnl1^DP;l0uiLuAnz1GvPQC4W_P{vTI0>7IXj!oQ6aw|-*
zbfa26^ONK35VF2YW}|GJx-qvxwdPP6w3N!~Goh-;Ymi;Lcu5$xUdJA+8>D`a;RVUz
z#H`-xu>-7ZnSIuFYZfOxX~Fr!-b|mkAwU4^JCK2~L|0jNz7wh~iw1Y`bHGWalQt<x
zJzD3KJh|S8O!faNs&EJ4H^;(t&TrEKPU$WcJ=dENw`-1sr4%)d{NCa%Zk{M?LF8rx
zPcTNNZ@yV0|I;MW_-x{=8P<rQ-05bShOLg~-;YFL6u~I_;$Q4p4BZ2@`Nd*#^=XP}
z_-XU+<8YFSL&IFE=<=h$yvc<24#X=))gST#wMt#%XA##Q!%Z(ZVGJpL5>NQq4TI*G
zkJX(dml*yt-Ou7E1=G*xb2bX>_>K<T66Q><<cH>?L~L6a7$szx2=Tz=TQq+0U!)n2
zR-6y~$f@t5m7jXXIp?w1l4G-&=U*qY=bV2&p1r&tX-=$WU7VpO8F}emN5yJ<g0R4H
z;f#}ZN;a8nMUO@@PN0~@oc^m<2nGASBeK9Hh%04fjK4W#sQ*MQmEuX^<d}ye6RNJ#
zrJa-+I$SJw?-3h?b9|g`v3-%wbZc|y$AUETr4*h}x87ohbJ?e*b?_+NquOMKJ*N|;
zeRMF1qP<0}_5=y%DX-g?lP&gq)d=Q9+<O;W8T$8A4NWfWF{4{sQ&_f<$b$BQ-Nn5=
zhTxjJ*ENgtm9CL)Cv|%!DJ&O~SNpmC2{VQ`Tk2%ize@>L=vP$%BTTDVuT}1)kv(_@
zqiI6AZNJjG3~M?BSqUmC;!A~SsCg$1p90<v5p&sznRA0@T3YOgo{p0GjRCSVfj6BX
zc*EllS=ug=a)lPCMbdtsjLYmmIQD_6nsFU-sBn<-HT=zV1s>&wNr`vz|GAlQQr%4Z
zmv;FxSyk1%CdRd5aT0=PKb?(*cRZ%ms-msDE3Z4MkRDm{@wGL>L1>=9?;2AaPwOX{
zFDDtx9)7E<NBY~hJ_#m9^nY|!wInzVHoOOytie-J&SD##5xs^tKT!Qlg#3IHz%@^S
zRfRD|-gB$0TEx9J-PModEQcvdHT|0>sFyeS53|!P?j)il{~PQq#A54m`3}5$mYm0j
zPDKkU^|ng^McS{7enj3faWKI+eUF3TL-y@3TgLhdjBllVdiG1()>lgfs<-(hkHepa
zi^)g&2t3^(O5p}qWCo&ni94y&IlWRhsO#8{Y%iGtCc`b`j3R%c6}_}8smnxOJYCzq
zU5#KVQ8#>My>z~0DBr96*}Ru#MVy&m{Z^A7(NH!pqQh=4o^^kX4OC}90^???Jo~%C
zhe{sf{{o>jhi8|$A&o_jCcQx^lr%aoWWz_p9Dk3Ym-^-RE1lIIbJBxR6P9LV#Whn<
z+NesrjVd7&^n#Az`G?=rw2#`fjVyGJ0K>}g_D{>dR~faf0=__w%98XRx;*tD(Nago
zX?*dqxL6C-H~xtDA~x^TRTvy2P9{Qgx4yr+pYiX(Kay$w`yT3QZAG~<1LhSzfns0X
znOs|55f;f_@#$`TZLqu?`bfDsBJjE<wacozj*adk(Y6zlc-69L1I_%a8y|HHtw*~C
zBE3;|NgUO=^>)t{&c8`Y0!60w&NJJ!zr;xfMXXNYodai{1&9cCV{{}u=swf((WX5i
z{AlD@mzW$0#itc|60f3Tu4KqKy7j80Ji0+mMMwWZYwWoq8GS7i%;d=(qQme(<Jv@^
zp~7^5FvuA>Bz)<((z7E@o<=#!TnYEISt$(vte|ED@R)yQps5T&XeFw*KpDm--gp)+
zK#_nokF1Gt){;^T-U~_vMSw8^G&(Bj4<A_;bn7#HAoi+JLik^?o@33ln^I9m<cG{h
zbMYL959t~I`*2O`B&Fkzd1y--X*luV{{3vQH$IDgc8g@V!=(mD4wnb7UKzIrjK8rO
z-=Ta(CF-?TE!UUEFAhnfXD>sWj1_Y)4fswaAAQdFqVn1^<mNtbi)Up7Qd#+#zZldt
zhVt=NDnGrJ&@pVn(PtVMH3HbbxkFT_Ek9`0@>J=0C)Vi3ej9;UR!p_BFiwQ-z6=vC
zE{WpahGo51D2f)RN|^o2#!BVE)zEh~cZo5&VHf}w?skT;x8yMt(lW~Y=ec5OD3$&R
zkw-76%R6~l!y~~P``)PK1eS^J@DuDarf26arP;;3G8+hnH>}+zL#iv$msk+^&h#JY
z^!SBqjf$davAEh)hW4<5Lm91c(lJRl+use|%dB<Faxzu+H2EX7167NRgd~zD*2AP6
z&&_Vd$^z)pW6lB&YrLj%@sF{P`}du?mv+wZeOn11Ihn-7;r;^+cSF;b%<~|9fl^#5
zEbE+{27(MQX3V#t2~euLUNt|TJ#<;@4E20S^299`8A7Jdu%(+_BrV0LJYG|cdca*~
zN6(wyO4$ifUMg#}*w|fhKMnt$9|~-trxmvQlLaBTe*gB7#}oh^auJtIFUZe7Dt!g-
z<1tgoCrVK~hCBHxX>6k=)U$XyG1D(XRP-TCj;_e>9~4uc(SEgPqIP=QL$Mh7+(6tN
z74vEMu?L_h&fc9%6Z!ULu%Jt0%Cay&gE%7RsrlY8GWDv_<n6hgeucSZZ58^OKZ$nP
z(qICw3CFN_b=K5OEURK}t{umeh~iH)H_JREddvX#VzuGsNdWD^e>ralHGlaiY%C8d
zzf;*(vx{#Y+#hpT!G4K&88ked$H#CH?2wNdqsZYD8GIj{vQ#gSQ%Cuzm?qCS0ox<Z
zJW8lG5ne3!QPbN*ZtpzW-v1uGF4nNBGud|ZSfSIYIG2Lhg!W2b99&OStFP@2qGfDi
z__f|4y>YXP#{-&i5<`86R#Ur@6dCc-0{3}6SDN_WUw=(GemcRj#uKj7lf(sSVeqo_
z(3{K`UcJo<yQu=-EA+c<-n-1v2?zJ*1eHS8Jd3Ofp3<_ZU86X?BMQ61gip#@do;~C
zRvAfL^FLoRmUT#qzeWwBMPI({Q+G{He=z)4L5%ZR2hUIwuz87><JVnkn!})g&2^D|
zaLW5`$i+Mm%oOt9hw>fu?hJ<O&T|5Pi@wtvTz-rv^O<58S+KLc6wk}tpdA#~p17am
zy7$S3Xsnr&QqAt`LbDv@8Me!VD<_6hudIZcG+&6{WuENG7go<=3hr;={x<*&ODs@X
zB+=2v<QVoXlUW$<XJ20mY8jnW?35QYxA==W*}pJ)zJ=o-1WcB^{FAOqUYK1rDL+Og
z;WMLh7!(;gc}3RIU^pxU{Dw<lHM3yjh~z9U?+fPYi@nN(qcK<#EiDdRP(sR%<ZNIA
zeB4?`&wrK{rTLX9>DqPMNczLzK=;U07`8NJh@O3i5`IUkC!KbOt7iyg?ykP<u4pqv
zC?|?O6Uog&8GS09YEu$>o$>nD!7%|gR6)FWq8jtbFr}wg{mKV>IS~i|vgU;@ql)I;
zFfBeTCqph6nOvJ6+s^voAyv-HK@vJTWESQ9CP6jJr`D#IME;2tazv%wBzc#X*MAd#
z@yFR26Sr)8N6$;EEO(UDBFL*R{NI_8$VPv8xDy2TSxiCoo`**hY1C{3Ut_vVS9U2<
z-Qhf-H9?;F(*tD5PErY>Vd7I5fGZi_{$W#S7#XH131}{QH2s_aigm&<FbcA+JE|<_
zF#1TwbkL}f%C#2pcX|1O$kE7ykFukTrE_%Ln(Y<(AAzmA7t-$Cja*sjaq{;!H)gTC
zhT_?GP9N?ihr;nDHPPk|KVBEOWb*6(?mAgMZ6wDhX35GgCtxs{%*d~YOC<Lvh)x>!
z1{?7G;2XhmvpJ8NWF&l-W=T4xR~oc@?oFLx_a1R`ciK8s)t3qZ`d0X62EnKrBu@c^
zomHu*e!m1m3sHa_BFLx36Q5du?GP&k5+m*{p{2mku;0AvZxPWmJ!{7%UIjFBXb9gI
z|8&Sz4y1}HtN>DgREJaoCkCSJ2k?`cNF@XHXElf?hKcOgebMxzZl-=QSF|MOg@S0{
zGtjExZQfZt?c!Mzd2@0nq%^}o!!OlhOr8u-wV<CkA6#R_g^D#Hn+?D>9=r1l)RF8`
z{mQJ_^{BC>=kzapL>Tt>YLCNZ{j?)=X`Z~~WtqQFqUsF)DEEpPLJo*sv@yRP<Iy2T
zK6|z3rQIeQy81&Z0nQ9Ba!?n2K{yfwVT-RvtQY#;uLLW|Uh(v22BpJRxXZHs9IRah
zj}L?*liM0La2=%E`0p8(Uc9-PGmm+4eNH=O@5Cv$!U_8Q^5Rj@ky3@^(07BErIq8P
zUz8GG%#DQAVzE0_;U07e4slOz89%lFA!Yos1)e8`;a;X{7zM0YK<VigiwD!T2*2}E
zn6?u)#P9U93qK(vo~FW1SFqLmDBMp+_Ji3uG;cn~YN=7*yo%HLk{!5*%_NH|j8BN`
zux_~4Gz);QV<}dn1SdX$!LG}B;m?!*{Zr9C_n|qX1HFf`;N3mhjVonFF5emSsoQGT
zcu!$znSfPaLv$4Lzx`w|T!Voha^jEk@#(b!2irI#VTwP4GB?*>w*d1q>s}E%Q&fbG
z5-6q2uE(`39txkrGqb?1Kl4A77PYD-mQ}(d+VbA+R_4yuDb1M6rV5EQ_w;db#HOBi
zU50QxT~??<brQcKa~TR&1=aQYg=tGf45gctR>~0u*6mu-@WIsH`-K%Hd)RjjHzQZ_
zF3uG@ral@fOn^2Cy;p#HVVZpGBF_1a{Vgp7F(aEo)I9Zn%k@KD{-)b+XkBYI6T^LO
zDhS#O+T`4oxz#^>3xB}bbaabMehw45-Sp=*nO%5QG~u<uS!8U^Pnv;lU%Sm?S4x%7
zs<I$U{rXOLiki&V^*Ygx;cu3?1ggp(32s#4p61nPK(GI%jiT5(ubd6%(TEhwFX^k|
zYl&^ipR5JllxQHL2aou3EW-W}$*AwWnWyQ-IPl==uA)^Y(YeO!`K{U3{Yyr1j*6+Y
zZ(mSqMaf57%q8MrMU;j6DN3zm6f;(<?RPe|Ji0eiE+sMd4MPgktOQ{W2G6@~)H@B3
zd+dc6yu5_g+85pU*Gu8vcxjh3*iHdm`~4Ra4UHbG8_Kos00K5Ss%NV?V_o!&$cF@K
z>yX@$p|}tHy;5(#b2N6*bE^%!m#-qxd>U%3cHB0vTjAh-H~e*Z0-l(3L5Z?|Tg|a=
z&XBse;`vhAIX%uRn|{Utx%6n~1}N<v*!yF0^iXFg>95Ni<JL+BM5N<+Ixii+`Su~n
zhU*g2O?)>>sCnQa>p=$<Vpp*{j)L8HI+$uaP6n^Ibu(Uh{0;tQy<M};hhwQ6y<~bi
z7p-QoIg~H>tjrzQ(-)(uy;qJ@)q|R@B?J8l#n40ug;w3oak~1C?+|?<IA($A{!}6C
zuA}+J$5qQN$AV}UeZyddV^2htzW}MTn;I+;nY?)27SRxQP31g$^Wb4@&RV+=P^$cT
zlBWc<#^as4ug8A)#ZtDqR7VS7LJgJG_$V}s-uOvB&lDaZjSSgb6i5MKFL6YGvc~C3
zb`egnmi(xmuXyX`A#6<%`L)EbzjAX3v*^)i)yL9@Xc}Jy*_VJTf#|Y|wKw3IH5P+#
zxZ>wTX-z&GU&c=I23ZpjGa0k8K9mcm<DdDvIN=fQmwQyIq3mObf^1iatt2jWcUTC0
zYd##Gd)zds54<|qYi5X}xD9eatoCB}9@I7&i6|13z6pZ7ZKAq6q>$f0J_sF}lnsYC
zt<IHE5)VGJJKe4fuWNx}_NeO1XIk+9wDy7W)TGkx?NRV09YP!O`xuOi8^a0>S<nQN
z&1Pt}M+=v^q=j~L3&wQwKDWkH_A;#a_DG+fcmq<aX}H@4X;ZA{=WKb|namkJDb)C!
zKq6_tV`l~&5u0g#oduX|Kr=R-I_d|@02$5>gbnoi((hLv&t^kd2fvhNT-f%#TCiQg
zWTmACTGJNKw7-+Hzr2(%FrD40FVo&pWr(*4_m^%&y8ZeiVJV#g`SRoWu<=HAKFW)c
zLn)52Si@_8LBdQ<<8(f}rxc66bU`QXljnMmM?r2qm~7B(q)e9%C_LpcjBn9TwQaoT
z-Md~(e>hcEh5Sz&CH5I0>pML05$*R&DOs@`+NSlJSiKjomR`Fs<8NGb*$Ng$vdL`x
z(@dBHBnR(iHyTqCYPqV+2a(nCx-HY{*92BuYD`aX7F5YYJ(RJ$rliFI=8JfM{+CvP
zf+dR8;tjbmv54OeZ#S{!#Q}W(1)tu|!bgMjS6i<))!C!N8)+F1_WH&>`pUQ}t>Ihz
z%-e+ZR-6Z_td9X)#3trKKBgS7=9kf3+kwk#rhv${v2aNe{eaNiHaX}@m?EL)dm?-I
z@7xLnR!)M_P2fnckG`h(aqXw~Uc?(GqnL4PwT$lVW%TMtnwWp-4r4kUS}~JT4X6ls
zf%I{~QBTPx&4+=_OU{4HV0PsFVsz59lMl9|Njtd<(=W__i+1#%;HsfId~2`$H5A(p
zh49e3BhDk24cWHJDLAx8O;kYk<BCo4;2?Vq)g>@uiuoQp+39q59a%U~+?X1mbyS|A
z(DQ%4;XNt%8Z6}3Y2(jsol~r?bYem?w8y8p=2z|;S*E?@cN>oV3LzyOcSucUIz)g(
zk>Uuugp+-5aAm|)+NsY--WNBHn@<c~Txeb(QQ5-V{SN`GtzOJZ3sR!16*bq1t48pr
z(ff@iFmGEcmv(85JuHhE!7b2_!nxl-{kXJa(}m?;B&=p8D0BmrQ>ZCyG$xzLLK9Ql
zK}~Z1xd_!?+7H*>CFW)1yvgR|<~NSI6mGjVvnM*9m#<%VYz9corfY$(0aC}DmfFax
zA}YEF(hIHean26{&l!Npg7byha~sGe3wR~0ksT~YCL(Syx@Z^gK%zG{I0ot3itnx%
ztkKM~jf(XNpZoAj&5_or<q43x(C(v&G0}n*Vmh4NVED$LyEn)$@qEn#27E7_X+%&A
zSNotZ?z$A3AxV#(|6|`GD7wjq8|zlT8s@e__I6HNb3jj3t9R8@$t+7js$~^g)c4Ot
zn&?kewlKiGe=FEfgBwZeM{^^LqR$EYJ<CV2-%poccvjJ3%xwnQCB{@C!htd`1@~9M
z<=3?4*V_qV52j3`dmkOhckh5JvcU%2D26+qvJ+a*^V>wx8+zBa+&JUzH<-O$%@pFO
z`0CyzXYOX?cSI7E0_Px=yVf|Ml<{6H*JwmN<|EEWa&z=QShaAzFsI`|IAyB^i~9jL
z=sy(zsy>|M3k{+bgbMsY*e*<y^PX%EPZ?d&+71Kr>!d<b$+ik92{eCcRNmN;*(S9$
z<)yCjIy;CKHn-glyuv2-LyuNA=6*h}huw1$ZzZo0=Lj+jAez|Sdvg-0#@1ltfokld
z^H@Vc_S=M2w0#BBAP>qA!+t92N3kev(g>S~D7LVRx=ik>16Pn}s);4R2ypwARvD==
z&&|cR9Q96_25?xHa@LuKSy06QL7p61&)35WLex*j7`_A<T2)hBJvgrAiI9M5BeC_r
zPm|O^f^&LF&2?Q7k^DpaQa%K}W&gx|7el@4qTcin-!Wgy@>~h4GPG&=YZAVSqdT^)
zOswwh^cI}DUy<3-AxQaMV148JF((mqD0u-lRDd_KC{LLmJxFr+sclBqdpxbMa1l8K
zNGrMIeR?HuhsDl;amomzNF^E3_uPnQbbPkarLj^GV;VGwE%;cSMOu6{7HnATRmP+*
zVq+`4UY_4!4KfwK0sJl=fttS2v)mGf(|@Gi8&0J~Q^H$LkD#v6<>oqV_%cbQ1fow*
zHmsxK76ueq7x(m0NzdF$Ex&1d;DxYzTzTD5N}d)SdU)cWEND;tAw=zmo;xv;w^U?d
zfuU!Y@T(e08x^b^v3M@(W=!<tSl!OaE_|PG>Utj#tx~}L6v>+L<lB!JDV+10pdBoz
zPc99M4D2`WiirDaGR|0?+U+|j@#yCJ(HB1}ta}FfbR6U+?ge0JrYt_jpRrG{*p%yH
zpBd)vV*r4@->{vMS0ew9qw@e}`~UxVB0&%%RBeg9TCu4Wt43?J)hbncmD<#3NNieL
zYu7FvT9hhkB(|Duzlzr0qli^OB>(*Wxy$Er$zAR~pUdZ+d%s@K*W)2DY<a?09d$zW
z)*B>)EuY*1C}UPiLLbCadU^t~mYJl4=AE71@TOO}BaP-+9#!Yk(k{PI#<QmJ`JYNS
zxY)tGt%)vRi-rkID$ALcKNYoR{*x5>Tu`2F*sN#@@nWrS2yb6lhhVx@aUCRPobUQk
zvwvPd<&P5c!*4>-O8s`$h26oUM48Pm++buY@}7{ru!t;MJW*(_{a|{?P?^k7pSvY6
z_mhCl>W`_stj46*ELtX1mI?H$MT=F38wg!EB)y+kO&8ZR7kuF-+D<STW18274h(<n
zM04I4R_RNQ-l%MV&_h7$iE%&<MF93vV3a&#shkh~-OWDO4Kob4Ic1F?R)w7<UNJT>
zrBzQF_FB3>Cl!5CkQ864kIG!vzB=&q_^{;83f)Mc{qj3p4Kgvuz2^R5XA+nl!jRih
zGM`LXVY?&;Ssh+UpkQu`!WhNQH;0BWED}Ks0e1Xq$<B3%vW;p%Wj4_nK<sHi1EuPV
z;OC2`NigRq^L%&4_%Wp50@#9R4)V{X&zoEhMJ7Hw)LD#vA+|3Uo1Et2Oo4M+Pzek1
zrJw4<ygoI<1m+cpo391_Cp9-f!xnPOp0J!g{B_nG$WX$0kA_C2$wS-$x&B>-Si*rm
zKF||BTO=}RvEDB!VEmXGzTk3XWUlqaitb{4IzMF*1YL4LZNFdXle>mV+<6VG&+Co$
zhT+UBffisSuhtf@ngSU>$hy(a?!IA$=cr2^3tJre%=$a&SDt}1FKsDQZ`YzFhPzkd
zrji3x6GYd(wuyCz?JqAfBWuT_PQ$)0A7kPrT}q#qsi^ceJbN=XKFXZ|-jD!l7PTCh
zQ{6<oV;Oh+SCtQbSyN)vFFERjcCcr0UVlfFOl%#yUM!fKRrw&cL)b=^TJvXj)}P{>
z1vVTuJ4S)$u&4ds{mBlFlT&p)OL~4399X>Im?|_EEwzYaJz>c{0TG4bywaYh`j*VA
zVl%h(a@kd7bzp%j6Cm~BNRU+tK<nj!#~!dx^*r(8&8QAHFO{3Wgoq)mA~37%9-XHW
zR|Fi|5bh;M^OR8Y|5_KSy&$<jTXB<Fl9(^ule5}$9laC885x9W3%>N6b<9D%_kd2Z
z-Tx+yM;*N5SEr#C-;}ds4yu|P7IjM6v%A`jVINRpnsBXPrp9uxEOJg*hf;Io%Y%+)
ziBdol@^CnLGOu1~nBQ4xq~XJ{89`rAmcJrS!eR-nBSdhC9%fR0*@xutufe6bFvT(7
z-|(b6U`Z&yN$HxT(^^S5-Y7!-|5l}Nj2{1RHOF{QQ9HXZ_ZQ+PWhJ-%4;R!)mZO;C
z8I>G)4z-bG5bxt2&uc?55KKzM^(aUd?Rkc~9adLrhkXAk_nKFj-|)-9hN~xog&h^z
zaysm1RBf*qaE08eh+$<l+KWl9rtisUd;E<YTZ&87`#JMc{~6%F#|eG^&7U6%vn;w?
zH9~HREk5^R-@0DR4pn6zr%rKIS#&Uj|Hm91wvp8pP-?}O2!rAb81b4<zcv1}wu`=&
zn9c#CsM6fML|S7!QY%$&eQ;6L`1_IE%p>bfvE&3f{jV9{I_9i&xj@o^oi7GY@aAvu
zA~^F>a4H&35K7&%>^RDN4aE&oW=_$=+S<?5!2?2f%PJnhWG;1u5R)XE^UQj<$|NJX
zAR=x&{4e}<xsLGs_`vGxG{t!6rNG9)e1@-5J5~3cxxa!U{2qfE1Sy5K;kDqlXDs7_
z?TUt#jZ4ik1GNkTKOQNt75kr09X!6>^;Yn;Si0YSknUZ%Key+uymfM?VqVyA;3UhU
z?z;+hZnUn<(=QG~%nrLtwhuc(lGzw_wQ05ra_nF!&tsn5UqW%d=;P5nS+1!08I#(h
z%ViZ18F9Mhl~QbIflAta^zBKrcLeY7X~{~`FT|hhfVu?L+@YbFgZD(_uMJjr^f##7
zYg8>m;7FqW`Nk@0b-93SVmZE@P^F*hS-1U}vJi8Y#r>algmA3Za&>c5d^`D3-Saw*
ziiJWoeZY=?02c>y^}4&bdb3AtYSl^aOPAJ8NR%I|0R4f%V3fn|UM@6#p;lZ;=2n?W
zdh@AJSO>}U9*~x{mZ%_mH^5JZv(dBWT*B8xHTMF{0o7*jlSTVGPcGCBN~9QuNovP1
zmCL0bcNwR16tj(uJnZ+^ueKPzIW$=w-t4w>yqEB|W{kFPjG8l_r@ebeskN>k;Y;Y5
z`Rn(IlJX0}j#Cgu!Y~E3(1cgc?k;<EQNjlv53jkx?sHadrT;|1f}L$Mp3CYgU<{FS
z8c1i>W9+!p-A?0MOa2^*&WOY8L`(hN?HqO^TC3B+SC5PafMXgHCFn?z^SulIHA5GK
zK_{F?+Asvd(59<4-qU|DyDw;`a6hW|9gIrkVMq7^>i&B=?JW#^ZRf;s=!gx5YSG0@
zU}^c2`Z8COAGvs{w8L!#Jr6@^{q67BD-NH2+WBnpS=T>4_SmV#6FJ&Rx_s-Cq)rr1
z5BRb9t=`y0P1TJGeTkfJgCq{~tfawyutZo|?V)=r%9?71ab9HB6J+bISEeL^gA}bd
zuX)4;F70PnfSVMD##p!p+gb4vtiP?K(A+*{EHpL)a{rR(Dy-#VyDLi8Nq%vr%;#`8
zC(aGaNSBn@tU|j}L6^4G_&z=^o05{NApDuC?RD8#1~OD$I0!S5KIE<6ed6X!B-|cv
zvxvD@412fF5!QvvrAm&bxbE$#B~4u<w_GD#O<>5<mbh<lFD4GHE}Y5?e#`<Opl?(Y
z27&-;H9x@q1@6i^PN&1bp@r)t4U!BL0SaqzzeJhW@x-~l_Uk0Ae`9wzmuf7*3&Oo@
zoYs#fbYCL3pT!FkTF~1h7;*Y^FN@E2G(lBy^%XPQ%&2fJx+U+z{t_WkmFtBeK<9X#
z@5^4Huf1ZzI;>RDETEx(CF$ZuRsbxikCNjc;qHCBm(|Ke-7h)3G#C-&Z%4(nu|3kj
zJ;mtwh@QC4gt5VYi!^Gi`4{Ls);`83Xak;itqwwz4<zpsGoC-4xwH-88qsMpZx((>
zqva%coCLu!(KY7iHE|r!UR$r!<C_OR&$oh(Wsu*Bm?IZB{U7KX8OMC;rl0Ki`z~A-
z@^77uYab=LDV=(pi<c<uoWO0QGVHQ-QKN0QxPh>*9b=T_k224DPlZ*xwO|;-bZskA
z5zGSO)qiIGkj;&~ul1-MgYMAaS;#gn{WF=&$43hv<-WWq!toxTx8wO|@t2iy@e8I2
z%iqv%b-+B(OV{gxN1(IPnw|5?t6$_$Z!QI8?4pJ?_%DA)4#xelA||`hA<CFize=bU
z#_M6I+8bflUH`piL!X94Ylsfw?m-g@abo3fjnS3z2s?CCOl$fZ>99~+%(H0sv;AQB
z)G`B+TWgUNQzL?;MJu|8-Bt+gGLEpfA+et4pSF1jhwQ~fy^l+83P;;1GHTI_TdJrk
zA-L(6oQPgK_jR+5cz(#Ls04GF;SuO3-}~BlJ&}a?TXpFbN|sBXnL`QR>c3&5V;?y_
zuG{--X5M-4y+o97#8vw@tJX<#!u5i}oXLg0+Dsh`4Y7-=^rOIgPTxy@R(gpdU}>yh
z003-tN9p#7KTL30-RsFKypz=QxGU}OT$phG)W#qliA>|;5)Jey<6e(ZGyS`3i+R>(
z(BUqM{?3;~NRWXV1q5Oy^!bma!@jRmldcxL)wSsSUv{r<l-Ot2qFZTHu26YwD}P_-
zSHIanNl;>Jp)Vjs4x>wR*9fnZhfAj{TLCyLW)Yh6j|>py$Ba?`ZH^I~EM74~@*t>>
z!VH~8l?wx`GTA8$?5&@aukAng73RPi?fPx`(=G_lMxT{3Y2!{5yJVpoA|uR*kcnP@
z2Ofs!fI(qIZFK5$Hl?^+vnV%^n_zP-;9=`HWrOD7@~e=z>u0(<6HWS*JwCJdny!GS
zjn$_p((=reY`PE`{<@A__~&bXBd>6|<6Gh%iAx^Oha!>r(J*ST`e8)t5&Hqv7P)JC
zhF2ABv3c6=9j6S6_tr6lPV&irgi8CLGF|b)=3P5}CV9Gd41vJxJ|<{_{)FsC`qQpU
zC9&DF*U6lD2{XM$^a;4PJ@zzRI1<E;YZn&G8f?f)z&OD7H{>K4pclSeDgql=3#sLd
z^b3uCN6_BpQ;Ycnz{lSK=@&<pCGCa09S+@bnv^Ugu6s!cRrI9n+c(zJ@YRR*=F$c)
zKGD&+v%=Eil<|i5_w<hmCZBIo8PkeG(>cBVCZCjqoRATpYK-tK*K%W*n}B!n^4Kh-
zzkDT1<?(TQc5k$zwF>SxI)yrrP}hk&UBYImdeStL@iJI!G)UeUPPxx|GF{O@qgb$3
zGCRGZt|ALT<<lB19v{)34R>ar*803!UPE_wAJ`0$@)*7>Jf0;PaQRlUxFnFp`PE93
z=iNO{fUGsF^P+JcoQsvs6%~tQk*vz?=DaJr>WFMm95wR>1FeO@PnZgYxPcj74<wGa
z`@;aAPwh!YhX9^}!=4=?&l2)7jrwD3OOK0absNPv3l+?_&=un*^b8WbC#@cSC_#1*
zoV1fK`krBF#I5djor_mWiWYT15b}<iObok-SB*3g4RUz?8vgRL!T3)?$-U7-gD4*}
z))5)LC9pNMmbUpdlg{FJF9y9PlC$ySIjG119Eisni-h#_h9&TLGtgPK44_hD3(S>@
zC<Cy5qo`~W!B(k2EfsY@6zI$R<La=EHTdmXyhcm&-;=z=w9c(Gw1pF-okqMi%^bBw
z=V;|U!V#6A?Y))ufJ}*vQ<JGBb;iscUOH=-J?^^2b{CNOMUL`CHiq!R)ZJY#%CHMQ
z-I?@tWP4Smz$Gb{@T|z4oEy~A(rje=>%9X_0tbcCWu&4alAJBWG0z66`@yG8xssKh
z9=qh2jY|)2*I4*Mm0vg-FJ%!pBF1KKh0$D``uvj?_XDt|_L!}Shf@CS&jH{s3*Yi2
zQz$y1PxIn~lvB4Ia=8J8^k^^YOqlC0H$Z^zWraNI>4Q0nK^*2^5yl|%6!D+Y*3gpd
zye(1mg=6bIL8vAa6}-Gi+a<0))H1$f7Lgh|smlzH5+QW-E6S~Y;DreUjxb0ps_7%a
zxsBK}^Jc@q>&MUoVgh$M$D7ok$LSHPzgD*>w3ny;X55Bw(9t0agTE86l)|QUg%j4r
zL>6>v{JresPw;lj?hqsdw9^s|xG%KeZk0cuoO0~BA8UruFX5!;mQ;VrK_t$1=Qsct
zYIc772e)o!+iLXA9g9u5cl&|yzdv*?cC%Cb&-u0-&&De2+UnT}t1;up(ht--Co78D
z#9)jhK)W5a%JY`AJO-RRPc^;UQmXY9S=Sx3PKcA22YVu9Uiu5o_+C0DdyAR$9CrI|
zfzzmy4WHA+m2s~N#2+jDsA6vm;NR|&J7FxkT^U++MXjU}{Lh(@kH5IHP(K?LV;dvz
zQHSZ=cx*yu4_IqYUyV5{cVD1?5^?1|D|+8}+MIIy7a=OO0J?DVsB8BFFqxflj6o>(
zK6+N(gvH+YQ0EBT{Z<$~V|c#$OTP*PB(MLWuT8~tNbBH&)!5ssDM(^bIoIwD`Zoee
zh22A~F7iw<vJW~33moEojPyW@M()*Mvr`Xh9BGdDMg|LY*gE}4A!Amz21KB4+qrlF
zv(B4CsK;-GG!2YY3wv7Q>N!W&EG0g21bN@Y`|;2)^|7e?9usyIG%N+{Jgg8=N{ml+
z-iWFD{|G>xw9KBoyL1;>%jg1v_U<?W3v^fX1IjYr$I|EG-L5=;v-@H|H`r@5QoUz_
zm?@%C6q|0~44NxVT>slw-W2brsSr^uMW0aJP{;L)#=}CWQ|udH6eV06oE)WR62x@F
z`c+%X?vArT;<-z(w>C0aeZ(xFV_NU0SaUX6D3V2$*~0p%Ed6{`%f?$$cobV9Ye*+V
z|8h2M%N7ZIb^0IP?myh&C$ii~AC)n?_|ooC<vA&Fy(g{>ZBO`Xk|4fM7Uep9n=h3l
zL;Pb6Thc`;02h)z%qPEp$w4bn2cjq&u8#s-e%^ueL~kFwO+llwBj>N-x8uM`IOfnf
z`vn^Lw`8LZ^wdPT_CZFZu^dUS6Gn^nRjhEc&_tryA62*|4k9Mj)($ANpGO7&eC_~S
z2+eZe(5ovoH~;!vl7Hct^|h0)rTjSLSQ<TNdhjoSXeFPtIy{2-&#>jwnR9sAOYimF
zOdL&1`1=e5+QM_I>#EBZ0JueBzb)-@>k?~6?S8&UYOFr)l4HmXoL4{<%@d$<?*>i9
zLayYKx&F9{1+dR__#%nZw7<#eHuurWJxd2h#|8d<f~DFM^I(vs?s+-rtnDj-IOO|4
zS@j6Q(V<o4xwuD=d_7x-oyfCo+YSXpD954gevV@;LV&;gBUwDgmbelSiHps)N6QI_
z_pjs(eLZLkP;KIxyyQJRxJ{_Om^BvCA*Y5A<Or|@(V9QO)pIQ<%44IwobUoX9tvVa
z1I5HkfH)4#q~X-xl#x;+i(+S^7_BLOJwaO<RH4ql+XNS`E;%<vjB>)pJgn<7#Cfsx
z*e!jNBd+}qG2?G6-N1_h$lY8W+jFP8Z%+urW#ZN+Kl6{@qW#pl-jc<U-N?gCCfVRd
z=CCU`p3e6eD<Cw`&L>iM3^sH7)s@~lo<RP4x9ZM^>Jp^=v6*rkJ6^~mrP@UDof|GC
zV<gy3)%k_A@8%}-r=LXgkvSIIoxDX$eu;{7pu08W6wVLKrk%@=g;M{z#jR!B=+-&N
zjH9E^`tLE@*?%Iw8V|^vc?do;I{nmRhPtRuoC9?@hvGnDw|5VVjA*VQI6jz0=j|$?
zu14ohxr9s6Z?;E4mQnv6>S~7cQ;5tXhhukN8V#diyQuLLp`?`$<D}mo2s6WMDy{hj
zHRx9n_P*{sVNz2NVMp{*-Ed<YP)K*eTZ<5Xy!ckH^zlwK(OgaLV(L>U9&?A)_6|K_
z<aW8g5y_x?++S(#LxBImF|66h_ZG0D#XkiJ#}HifB?r{?pF)M3qh$X&EJuM?35~I_
zbqRH0EYBUADrlz~_6|EYOKoTXV}rlr^>^(FwS+j={DPv$c|hiofA)Ia#OJ=^UB6Nv
zmTE_7OaJIgbE;o{3@sp71A9XdKE#iAK12yKDlviG^rXoMNsaqB%ckE~EB}4B=)ZVN
zD5RXGo|3jj6+~fr^nrQ>4}R8wv6-BL(fiSlU*#N7X`UU*QjT?9_jqrKBXx)wcg7J$
z^%wt@Cyc68XYt{bDSHHcaBL>_&5|wUeH%{#5-`-wdpp@;sLtD9_z`NbD{QxDApgGW
zLV}#a+|Nl`o4u)7@iuLHmfuTiq9f$9;!}~^MkEe@a&;|#<0tMTvBAKb;)uKsSdW2$
zv$OO8Vc7bY<AH?<nJ4R=zOJO>15=?m2M}e6tG4(Mve@E5Sscb<#lSQjY;CF<CHpP9
zK(FZ6q19gsw=_BY8Yx5K;{t?U)5aJYwteRrUdqt5cc4AZ62kQ|4(VJx^ChST)7?P1
zF1c63dr7itxn*Iuf5Iykh<v4wpZ>7^<sZO1J~qmolovUmcHssu2QHs8-L^;=Bxgrf
z1I?f01?(tl3tu8ZV7HKW$l}_dZBXXGrbuH<gL!}2@@MxP*TmD;_w{5M=0Q;4u2iRz
z_*wkBBF5<E?-}zqsemEo%JH7Y+4Y{Mc``mt{dpGe#^3oJDbdNM_@rFAei0X&bcvfu
z*LZuH=mG$-)7mgx_;HPZ?{3IMErI`dpc&;cyeBTPUy`|gbz5GB{L!W<l@*=2#<WUF
zrsZVmReK${p4F6%qbm%5n)7PACtfqm$)8Q)>HPueM(>-*6wle{iLj>j+q(`#v2vEN
zdk}|kgh_cfEl%}R1=@m1qW#tONWs{{S=YiK(B+P18<%0VW}Z9`tAbH>%w}FV0(+o;
z+{HtM7C4S?>#7T(vrDCKvW`viP=_CT!t^AveaZWO1O2aGY5bJFkWihT+r>RzCl0#<
zk;Beb*&O0sBi^4Uf5H$<dM({P#j#{_BEg|9qWqa1;@|X73gLsrD-PXinNFX7$|$6W
zh_N1ag0*>|&RnGgNis4J-$fIYzAwyrs}WAw2Yji>`|oqUlx|pb*uXYnF}0jz_i2Y)
ze;#k@F0y|XIx!!$YcANg>*VViVe@@Ct(deyDw0WbwO4};`@9?OCp8E=8Lpe)trDb&
zk!~TMJ7FDA5q;L92||OH$61&1f2B!#=^im^>1+}`Mm=Hr63VWne!<}_RZ-1Fdlvjk
zq_*GPZ2z<wmHgzZ^W+{(96#Nj58k08Ysa|R(*6Ar496=Kmg(P<eb)0`-lkBpr*0Ub
zsZ-=UzmSk)s))Yq-?bS5@%3(RcK~Nb&y$Hl33t57#AM&B$G*RO8JybB4w4@d(G%ap
zI(V?G!>)?35#E(Fmg+nT)sLlb(w`{)mQ@1Uzbu3fl6Ym*@hPT5qCclK_>E9_#U~$B
zlz$0@93?Dri$_iLU7d^GngjUOV&qZK7d)r<84V`66;htJ0)H5iJ2dW8`5&6il5zJj
zAImZ>-N<85ijKKA7*5vseTQzY8ucxB5ooDy9X>fY+2P|O%T&=#-&bi6bT?ul+o_U>
z_EpzXV$A~GI=GX={pZE+|305|2lHNfJoWBdSOi0}yO6_aCy8^m!xK>&KIJhFR#E+n
zzE)E?nHEZH*D&kD!ki;IyI$E^_K7>uhOHQ`9*OM>+*s}prBls5007#JWf%_ZlA_e#
z1;J>!M3HHRk!a<XOLm{M?+Thz=_r#OrXgWz?a-jG8Y2$#C&72^xbEL}U3<$Wrv>Tp
zp4SR<k18R&a1&XfuT!l5cq3iUaseKrCG&Ng3x72@0eJZ%MWD$va%WVQS0~YqJ3LQE
zelyZ3T)WwU67x{7KEEu}3{TK!e-tfu*hw8@&V}}9Eb;riZ5DkcMI-dyfQdCmodqSp
zF$r$m^ZN49WZbJ2PaRM`zdk%p^o7_09)T=1JpcQh$uO{Cx=dmErx5-4^l8$loM9~M
zQkeZ)OBQt$`a?PgoD{hcO83MN4D6#-weD6f1*(d@iTpz;j4@Svfeb6Im9(HxP|VI|
z)NoIB@MgrZe|-GCJD58NRitO1_9FpBO+(fAReIIc#PEAM&zB2wco*k2?gAU#jPI3-
zNn&d}c@3khY6;idS?+fIyT+3rhx(Mly`e>kDKtEE4d@BuXD;<)%~+@JikkcYui*$Z
zJKoofupf51OVyARs+OX_g{dq^I6fpnNxHw^i+8^}bzf2cWMF#rz<37fE*KlYb4l}3
zT#CIY{_3Nt0FgY*LiLVppH5Va(AnkFNQd=BkF+YS5NQi4PJ@nQAuUmep%wI!`JDcG
z;mdVfQRSHCH_AqWYF#9ZP2`>G$@ekRz&N|IsHBxQ4>bI-XVmR=zCjAC<MKY%|1$6%
z<fN!<ql2EZB$CZWcA|5{p@sDOHY7KnY4{PWi*#=H-QjakFvAdX`BcLfk2fPaAptT6
zmU+L*QQ(~G*X@ZSJ6!7blSHyE@gOMRTW@<?y_wUGF$v;qJo*Zdyi0Z7rQLON{9*gh
z@7%>UNTTH2SBVV^h+Y7X8e%O*+iiTuxj`n`Y1vt>8hi(SJ&Gu^{Nv;aS3-t>-=S@7
zS1ZjU{Xff|UFZG4vU!V-Tzw<QiqSo^CFi{0=+c|-Nyqld6oQG@bb4o3pv!QkP1MGf
z;4v7IdkCd<tAIm)aBjlNkP4<Y_|0NEzmQet_m#x9QQ^1{=tOXEamwapV}gi`mWsGH
z{7SuiB!nk+b~DT_hc{rxZgtrcBLhv+6dk~t5q1s<@^H@e-xCHd&B9eXqb2rf+w?=C
z5!>@u%!*Oj;(wwT|D}1WiollfT<Y=JwYMhlv~;*YbAww11X~H{i1OvH5PqvK8hPyw
z^y}>klA^xI)9p4b%K3KUWJfL1J}HT+tZ9+2oL_t}9rFbHJ9gTlT@nx3_k3k|qeCK=
z<pVSJBn8UZZ?L#AcItPPq*!kIT$+oN-!%Wc$>-2-FcmRY>mVkwz7*d6rytHY%uZce
z?YOAxHvJp-E8qIN0`QL1e+NltZ8q5L$P+bP^<@{<hfZCZ1#|?g{9<)i<UKDC5cQcb
z?16k2yh}NaI2p7NBK+DZs~Hw4`JXz+%CJSgqMx9@gEATMdG9O20r7seA{mR_bbe}k
zfA`K}x`4v(`d9A+uJ3P1P{8)e#SXL_sP&VN5I<=onv<&BA^o{serA5tWq*ETq&_2o
zq1?57FX`9wN*|1j-}`+|%=<2RcK0JeVMbZwa2M(nK}PTLot)<ouA76AgCl(-fuXrU
zJ=Rr8*@6uuwjVd{#GiJ5tUcIs0O!AGYBaymEZd~yG4$a<c(@m_VmUm9|GI(udRu@9
zb<54gBQOJNx0i?`{)^HoS^ND6Ez$TpUWO995+9N~F&2NK7c4(r+@atyT-{B6qUz|G
zv8By!ujcs=wXgh^ds4}DwV1C15{@cw7D_EW?>#oJaF`tGf4vuD8pW!ROig0S#H}Zm
z7XxK)){n)sG=U>YjTQUw7+-Aw@0=81BIN{+(iHhpyJ(lUxt_YUk46m|m3;uJJvHn!
zeJe49c7H%^dHl{YZF=V^cM!JM#&%1U&Qt}OUEfm2BG$buj#__vq8d@Xx_&YkY<Vby
zzdRW65z@&2{$!r{n|-tFTtS2{)5NZDXEp~X9wnGN@V%sabwA~EmrZ{4knjO<u+;AQ
zX(>HXi1(Y@q-BC$pid3Ua$1-Q!s=zxEuGhra3Pr>Cg&sUSe}-|Z8n{3noBF3w-R~X
zI;B6Adz7v73{UC3^GcB(l9tTNnO1;qloN35N4J~2JaO{xek0$#i{%eujCrOAJp^<;
zyV_AB-9%v8={uv5_S%0j(HyYYohzuHT^QY;t15STxQO59Z`L-FHRp%3I0l?*YtBTW
zL#(Sco5d@9y3F+Q@ZaVo1X)1Y*}3%a+<~Q)6@GE%wQb|KdGz$EphPx$kvtaueir`3
zk?!ch0Tw_Y&PmEpCy>QMLj1Q<Lf97`5qGb$+&c<L$rStBuc4%5#>X$?qjBf43JbV?
zVcO_N`T`9P9bX!>LhHJ$UVM+~(Uo$$0Z-=Xc@Df`6C_>F7ajZXrP7;1wN2N*A9Pau
z8_yY1r`QFLIJhEsBdh1CxaAX4bmH;X@HdQ&vALV-Z=Me}j0r^5E?iE$erfHQO#)Y)
za<;Y6`RUWihIf<Kw?R*cng8HosOkT1wTtMXYwvz|fs9|De{z&jDq{+mmJZ%`6@eCf
zFoC-#1#HvBe%wdP%ES7C1-1Q}$U?lsFDdhslR#AcIq2j93jhFs^Pp{jS-&74#aNF&
z2*6=38Gr!5QlfhhGyoa|*uY$_Kpp|1zT^M^AY&3>mx;kI?vgirjsBs0zrs6rCLO6?
z0-6MEk27uB=sddAjs+lZ`O_xk0RWe&pIm-JJ^b(SBTshx^ZWlEU;zNpaos|IEtp?I
z^7l_JDmNR*SJbAzy8pA!p5eGGvtwUtbl$Fr%+TUyTZ2HH6k?#iSXj0fk5NRW)nB>o
zK!uPoheeU}Jy30Mfs-|ZDQ6p66GXTYbbs_)c+01xFOVWbV?R+I>iqT0;xiC8m^IP{
z5;|mD+>Wv~+P?;(qoVc_>tX2c$||+lCFT-~*H}M57lDq?F4q=!rY)<gs6Af3<^rN$
zWt3)Jr4S#y$9C`}Hj`~r<2sd`HfUR&n+s{VVdPC>TA>G&D<*j<B!g7va&h8<ei?ai
z8n){jhASCl`S^9Y<+V8h8My!bkMYb*f`qa8@@ZsHP;^lyb>6?7y2ONJJBQa3N6k&9
z+7CnYRgqScN_C$)b|ezZ<xD1DueAAJu22=%480)zR8<v9j#w?)%?xkMCJL`s??*<o
zwiSux2T86u4;U$xwHpTBe>d4aMMhq~6L2H|m4L;3d@NJ6vRA1I2@HH>ina*iF?iT>
z@=ZH^2u_PKFh6{Z=5%1V0Ra2E@uzOu%^uuqsV3bMZ@#GpFymduUr+Q-efe}7P6O%(
z(5T=5T=5}f{#Sois*)Z{MIl9l-{N9tKPV5vtGgfmmGWNNuYbK{&&?_jvSE}}b&KDW
zqtM(D*I@?rba$``Z_(rc6U^$aicv^KQbU?o>l6?68;7v*Yi$eQHIbGIS?2N*&M=~U
z*v7ShqNaHXPB$L5wiM8u{Hs|C)f|o&01n+Ooy=v$i>|MA*?}5LvV#0qR2&9_vrofK
zQ~6AKhzq?nDxo9BjXj|~<&se~)ciTJ>#`Le_P9px?P(uAs&6|?azTJKtEQQNbVQl!
za-2;igadg_yOi{j6`LiWV_~d6#b>_@_AeSo<^Km@T7CrGBLr|waQ`%dp1s1tYG}pE
zFB&>K<1Yd1e#2k!Nqu!V-%#tT1HlA7i|$eH4B_BTk{!>&h!z6w3)U!kMGU4lm-k<I
z$3ykQ=^s*h&(vr-uU9WtVv{weSfk5qlSuSc%jHpF9abO#ZxjvWfK@gibuCq5J@;9r
z&4?Tdp@}aMTY=7l&w|&$G}sSIr)_`f%Al7H?(=)WIYySP(0PjuA1$t!%uD?<SR(*A
zIxA<|L~PMl4fXb*B?Dbo4iJCCv9JTfM?_YuDh~!sVyeRuqKd}9Ck8~=jEPv<;}LvO
zOhI~OfSE@vR$9X5r{L!Gu*-6=<?oG-q8D!$bhNXpMo>ExSVZ3KNFZjkIlkv=&me(i
zD0j&jp)63@*(<B4N)SHG3h{#P*8w_E*oRItn@OGEdF8A3=^yG3ees|z1JgeK;L5d6
zG8M{+{|4mRNtS;$JKeEEt4p7efNqim3AaAUnO{QJ8IUrrNW@7htR%aWe|s0Guz)CV
zez5AOXhPrhw2m2)MQUn@1PfH{W8s}{lyV3mM@<sN{Kfri)sbF!6>}eszBkC`(zU>2
z3^nU~>$Crs*1tB91<;!jJGjWa6(Axdpc*MoAxH)*zcp5yx}QqVxVvYYd4lV~BqiaV
z?OD*by>|@fhn9VEd^#g&%|#hKom@H>!d;t)hs3vUx7pw6fV)L^e#bzre>3hQ7)N=?
zy&!uI>E)z%%ZFTLwAHE-LlA|Y=b?Fqic^_i@O50-+mCRnvR+i^R<0ewJ!#nRL_qh@
z2E!Zq;?W}JW%Jm?j;#)IG(aSHJPkI-w$SQ4B+~ViqJ8iP8`>M6*S&ny2~8?<S}d8*
z1*~k1(yoeLGE9g(s+Xst;2uT$-yHn%(R<n;AfQE^zg*~LW$fSx!cnB)cx3qx{lkb;
zwE=`pOCv}|`i}JzC2#<m)Ryon;CGYTxG7C0+q$n+hw*={f*oFh*4c5vjDW%8&5mCH
z?xuOsS!1Yc)B8M&NdVKxYd&#`*>`u;2haJA;oGl8)9IJwXhdcOjn-%_#B)w6Q9+yQ
z!om+rm1=%YlSVq}1bTFhSd^WOYOlq?Bw4L4_&EQf#k%jsyS^X*+3XUjiEVxv#DhMD
z6il#88u`9{4`eZ#Uk)LYnj?q@*F{S-=BF2p`?QcuQ5c?RdZw%3AzfM!n~Co4)z9T5
zlYv|gT6T`fgA+ttfAyN3%kO8o9N<oBtLED5u;17TKJvqxLdplCh>lF>t>JlcKADZc
z*F;JC{DE%@`qqeF0<*t{dU!;XmCV2YVr;irWAu?a(^AW&uZm>_SRHD3-#=0GJNfZp
zX<If{T+mIMQ8i=n$1Oy4w8l!U+++@RzbtWSeGEr$<(n~4GFxL1iZyEYoXr6GRt<VV
z&$>+NEEmixBPr)P&<IyUZIx#AFNS_fwhmJ!Vpi@h7;@=8*UOjg!{`7y0fXxsEDQob
z^&~KCJhs%Up%aGF`<XuX;_~;(n0uZ=jbWkWf2!#u<D}w;-s+PQ;MCpu<aj5R#`<eQ
z{(@e6M2JG>v`FWpMX|$7WilfIN|%%Ez1FT2+Kv`)-#hIK=W!)w|7Ti4@A1*Fkn)=n
zw=ikE?fKv^PGR@!l%Q#0?`EPV0r1b9_V#O$<3yWp>40kW16T4+I6C0J74I?hj7D3~
zp&_vU4h=4QNc)!1^F_WFIw=pA4Oi%Cut6XlHn|U1<OEyWLb0spl23j{-~h*m><*Ke
zlqU`+FHBIoGmma(Sr8l{z^V)zf5AngzW08Kl%5ehlj}HRYYJ;bu?7z7U0j-(!W=^1
zku^N0;lIFsRStEK%C%E<LcX^?Ll^p5Ka2IR(PFYQn70`x4Oy8o=viSRGnW1OIvzDR
zKaOAuL8wop@~zOfNA?p0M~@z9EJX=B;27Jd`>t(AC!U1KYP&U>u>h-Dsit73l5}p2
zT``eQt!=>`4{tlyazt?Ora(MSJ&!d(8@4~3K-*govzg7m=5`4prL}f1>$~>3)mKwH
z$|zUYZ=##%o}g5*2yo7gAfW7Fzl(mHNUsJo@rk<8aTq&oS_bQpqZ3Zk$!5ruAL-~c
z$>K<Rv2Qu~2MeF7h~A8@B`k>*8L%%f2o@Wk18A0aBu)jJpUVi29E<p)eqx3oD{&!1
z%i+n%F|~$*lOvI}2_JqYcN~t`PHTdGN9>CP)jl_GvjZx6=(E;_>a+p98)9i9igkNG
zq88o-2+ByMj}Tlv%)S2LrhlVk@sD8^b{nCwjFvm1RhW6qP~3kin}j;?j_+dlm!qhw
zPjK0TE^^qVmKx?!Kf52G`vC)7IYwI@et>v`5yVLv0dPS6&u?!f${)DNm3F|r@1ogz
z+r$zI=m@x@(EgK9nK}4*r+DTQ4COfaKf}s{$<Aich#)NN_`>y^`Be7a$T8;j#2Q9T
zMUbJiaA>w~QJxCv&8g)Xi{*ByKVMxrFxaI6JS1*q7zEauT7xac9<6nrLYXH&Kfq1@
zn(*b@ThnHw&><t|G-1jLugXe_6t(6oK)$~}E~AM(6JhDEce&s_iU3_N?`t)%xmoN)
z$GZ6ienY(|YcGX#-W^ntGz2V?sDCh(PVtC_W_}1*QK8H+YKA*h4YI~|;Hu6}#cm{Y
z`5a8mb=&>u<-|n~-a8%?`~^IjH|YsAxXrp+UW8yB<Q0oN40c&M>5|hs_{UDCko!@e
z^*unBN*VnoLNVn90a%-7^m1C@WE}IuOC#<NJPK_XO2{wXike(%Z&P2$2E-E+1eWRm
z_V50bD^g}Tc5hLyN7bXk-ux24J45E=a{vH6%{eqiOl}Yrc-8M;`{Ru>r%@m2%*E$x
zHq#x&J(5F0bttKhrN|x9Ky$N|G9|bE#BXgV4v|o--`Xp58jCdl&zC^>*Y*NucO}~7
z)u_1x=)s3)LsRMJ!H64~-!v1(D4?4BOry5UBQr~;TSW6N`LlKw@LYT3U*n{%l|L_I
z0`6%8WW&pDdS{UR0m*-U<d-M7ICvPk?Xn4fzu}0?q3=;cYA0V!oxCq!2SBM50UV@9
z-;5pm31FXB;^s5hKUe;Q=ZsPaEs<G-HI<ukd%=8ciChUH`+^A0DD!iY#3O{3I$C@|
zNcuDvN~gCw5K=t9N&*_CuF*A>^l&VE&W+d7>kR2!!T_%Rl6l7#`EcP^QB^`BB~O9*
zT9zXIiF<y$RLNOrL5>{6QZmr7q(7=(1rf|S;z(ob9VtW^fIjvfW-RK&coPAuAC)T{
z$hcw05TE%&G^NXuMzte%%j~PAwC0UN*ibB1W~Pd66#HeN-J!|X#SuG)>0)0}%cRXS
zx9^jo3WeZFZN?Ul&~X+eH3LxG03f72UV>Zqd>zAvdOtghll+l*^{&HloBA&sC}qIe
z_k1s%<yy51i;SV+X~<YO`btT|Y&1K<RA}&9e-dpTa3*9}jT+@FNcno9MFdQ=@DvA$
zM%hTYt)vRSzYV`jXOQ{zS#vEUJc^sPUHVUL5nz`}uLX23@q=1VOit9~qu<PN^!+>s
zy6EDB>k?tauQ_>R9n|ZZC;TfW;|rOgja>?8<0SM{Cv=qzQ4oOb!+UVdjG}R$%fRH5
zm_@Dpe^OkO)wxcb%6G|(^s2-XW#-!OwQu~q{FodxF-hcu-@#!}a<s;?JhnM?W&dan
zj}40$Uzj~XyEwJ!?t;a;XBzF|K<g>KFs<#F67WszN?EJX)AWVo1VHY;t&`l`+#cds
z<T4Ft-65vNKrtuaJ3U?nyW(z^-Ivb#ilp-f*f;tsa&I!R?TdO7ow5u%e_QF5g?YoD
z(|?N274s8&xwejz**@2<H4pn<UdflunB-ib6RWJ7rgT`op$n|3%Mt$aLR`CHh5=r3
zXAa&)R=%-e!)gRWZeO-1z!MqAPKBUWhRAF|ZZ#Te54u~DF;GJX^;$5fCr0+o%s%3M
zwAsCHkoz3#ZV%TpmGb&*#ZpN^OWLM`(J>f~#e$~=^(Y?tZlWhC5BdF%Ozu~*L|~8_
zOJZY!!ifb-h2HDisL)v3zl|!W?UbiqOS=4ZOR@{(9?lTzmad7nYAkXC#eWRZc|09=
zHbwCmX#>g!@_uO2^!eSoS!;Lq&nvR=1S+kE{qys+!zdA4^eg{A<g|Xm6Ew@jNYoPv
z$5#swj?HwRE8GT@BuG>O%R?I8T9%WsKr;+rFX*Gc$;5cISaiS9(;hJ9YT(vtUp1<x
zJb)&WQ|Hp3qtCyZcuF~^Rlny`;=iQQm}v~v<{#9H8cGz}ru1+r)v}XmvHF>f^Oye-
zlHO0|n`)WPwIBNL*%06MaQmA5amu<wMsQ3rw{f*4)@&Ce#F19v%RO71YhS7uuDz-F
z<lWH?A24U*xB;n0=%{XaXw)`viKzCjA7&qP4<Nz|;~(V4Maaz@2+2S#A65Kkh}plK
z&@BVGM*B8?1irfjIW!{ZYw6d0*C@HiTHM*MF^JF+>|l6I1KU#PS<}qLWC@Juw@s3+
zf8=%{Y5m;SzIVerEemou4Y_7@XUUguNZO4o+aSm8f0|(RUEDi<)!<HHXl?7A?w%XQ
ztZQlT5jvkBN>W`+|7noM`jcz(i(xEB`HA6*Y2Oe}GW>`+9Qb`})gffBOJtxV+ozS^
z7aW~kH1*zXc}b}BkbtDTByYj-v|1YEl?V;;^3kc<dr%lKdTVCRaG~(lL~$<*G&v|v
z@MWq+ucxJT7Mlq8qoUv{tuVnRE@FT|mWDVMEx1Vj^yAD})=>=ebZPlhmcrcUvU;*T
zcl1i}H#;G?iXZM<ukuR&qDH)U^VNoYaT>FKfBtfDEi%R2N%PR%E6L?MQ9+mvM-2C-
zucpvc+h6^ICTk5>UYrZ0g%WPPBJ(FT(0M(=Xv&%z^?cWJa@~*pZ_tILt68<T$O@7+
zt&tF}l9-4XbX|_k2nN*)*xNrI!CR<4>oIU*x$z<-dOL=HvVPxItK5bj@X|(s1z=uf
z8twTcFJf?h-_8;q;S9T;1ocujMbC702@2r~hbarJw+fd0e~9at4OmZLRlH3P+Z)V2
z1Wl?iG-|nN^UF#%>Y)F2(esxJG<Gcolrh-lfA1T$hSivElt=aq%5rH7n;Kr-dqo`$
zA&gSzZPjBb>v4o^(p5<jHsWQI7H-i+sb3up@+HJPS;iGmnk53q)l<vsOf%OozzDB3
zh^-XMV{cI;&E%S=_qr$fCtise?2+k?F~SzZ<TKPDjg^D*3#IpX<r^}B``-TllUF38
zR#1X7E&3|Hc|amIx3YI64t*f=Q|(#L^R;eQH1wcFTY=iJYmW2^*@ZifSTJn8EqgH_
zbgnhg7wgQtRw=$sNg$K*qDhXNXfno6V;#M>6x4~07OhL{Rh0C(fR4u=>QN8>FdBy)
zeExI~9-9beMlspXH}NBV9TJ)T<oUO^;6+EZXiSPC?g~!<x#Iq84-QVr*Qd`{py=2V
z<K*T!W3eL39EfqFXU;af06b)cB`$n8$DE|H07h=jM6{DB*e~M|f-qU+x1Jgf$TK`S
zTl}iM6W)EGUi7<E$q??{m`#mtt5E4}yE*E~Tn`Mq6?1rl+Zch$?Z0_<L=a5Bo%1ji
z+PZtqqM|kEbY6p4u=;hCxmi41+hH{hbi08ysxy;{4}hov*f?cPyL14EE9YD_htZdP
zQtw#;<&svJ(>Yr-(iyn->tkA65x<zu8dhE=(`gDNG&?{6Vz=1`n3E61rd6z*Y22RO
zsUMS4neJm9r9k43rCtH2N(~yv_n1!dS9@}3;66`D=j|)>8rJ=}9AP@#kGO&cE~h2;
z;w@so@PdVSO0V=>fz>Y#z>_T80`B+!yBqw&Q8*5`$Z$<YMtMYs+eZeKL@Z%wxw7YC
zC$WrM2*4JsK=w*TiDo$C<4zPsnHJggFh)ykwQs$+LwZMfAq&O)T>gqGyobt{SkhDw
zH%?+%Fk^(IKbOTUIl3y$IBjc&(QFLnc{X<DL6<r3-2P9822-G~0>{((_reX>tY;eB
zoTz=ZY!$s(!ol#+U~1N4<x`Td1i@X^)o`*^k&e~vRHMr{iYJ?mv1Kw)@NXW)fuk+a
zSG(|WwuB#0_3YVM#7Z7ZSd=iYhdtb_W-=PPm-a1z&A$W;C$^pzt%e>S4<%Nbf*#ru
zg&R)7(%UL|^ceQx9E-hjqK@~%?|>z8aMR(Fi(%IyOlNu`3T%XG#~2nh)(=U>h$UU%
z#eQMoVowav-Y%vo-?ng9is5yaF!DRJEeE7hr*(MeGd(FwD)R~z56w{iO)S-TnyO1I
z_!xT1U&7WQHozB$E=g(A0uN&w#HKegfN0a1(5+y2TnZwBIBnb03F8tLXk#yp#RRhN
zqg_TtDsS$iv-%atH|L0Y-HDHi*#bVbG8^Y#!E|4elgIE+Ct!z8O>@x>?kozcNF?-8
zC#}|NmJtcjWh?*{B`hw}Su!@MBBy}ix_|%aA%+WIIDGwWk~T7%POCv%7LO&rMr*yr
zpqs$+DTlIbi%BsLmK(QzzdO1K1nxhXZpaz5z`OFdi#w;><ep4Qw@?iS({Jiz0xGSs
z$YW=U4QuracAw`_B|XpZRKVC^A&sU8(?BxbA$*o~Z7zXPp6*~=b?l*$gF{bD8_+^a
ztaDUIMFn7~sG`3HuqYbW$F?Ex%_R+;$zZj!dlGT-{D#QfuFG(>Ty|I@XYniXlGNzm
zV22XymAxfhP2l4Xm85pt9Kv?jjBpwACZh0&F3~*g)H`o(tvE<$Ec=Dt9hg9b?+qDG
z?~ibXHN^Wk_g_BxOQl>-6t?2ppW-KYyt;)CyJ6o4e&HuLz8ke6MU{Kxj|b;_Vj}1v
zQ~c?0Rnw`EhM@#agemprEHb1fFVcGqoHY&dUZN>@dw|-8M3Y)t5@z^-eG(wz9gN<F
zu{DN`*t<sh^PMifU!5g;4(u)P@<g;B{>t0mBOroI69v^G+K&Uj{-t6_vO!yiSDo@G
z;|`k@ndQxys2>>9=!%1|LQTv^O16-udhQ}yA~td$Zy=pTr7uPT%e(XbC&Q9(c}TK~
zCY$a%d26<XQ3+JfGr~n7ZG_|FB>IpCDL3|bV1GRIT9#^(l430)t1{t}&xzw|=kUT$
z)?K&z_Y7Fhix8Kjb?w=RLXTPCKup$e)<R!$;Jaq_GhESnO6Qxs*$zxkObur+c4j4Z
zcm829L^hM3Ao`F#8+#MRmrPqnhVjPsg9Jseg_KtA0tzM0kxuArZ`fte*g{zjd20qX
z`I|<hHHY%B=AoU(2%hDTj{bdiKH=#|3RKYEG|V7?>Iau9FP415gx7q{!(;Mn<_A*`
z;M-=>tHEb0YXh{qVOeYF+qjY;ZvUCiBys)&3%SL+m}Kxgc25ttaPvbc<)Z%xtCEFK
zFcj;C6@3EJ?bG9EM2;PPnJc&}p#i_XR#6C90_KBQ@On-j#+>S%7#a^ByYlcSX^MeM
zR*RK<+dI;p4Ga5x;bK(WhJxa~+I~3opVFf*g4`*mVZKBIQHA=0yZqI-#K9>K?5G8^
zaF?vWJMi@*8mGaZMrQ8ZB8!)B)iuWY289T=lgaec`?|o>qhby6yJ)&QzloSrqJ!1i
z7)g_tLPI`MJwE?nut&Iyo!xPColkBf`6+2SQY&n<AI9WI^RCoK3LKC{X6wnU;?&<)
zQjx(u;n+M#r(<N@9%TV4Ql6jJ`K>mY_F9?_$MzANl4JKNl99u5bC|1e$0$sTDqO^g
z&wCadDnCshFj6+8-3DRV1HH2`6u^(Hd#>G_Cg+q_X8FKyvrSc)gy?{orhvgs)uk3!
zl80z1wnFVXHg+K<xgXMu)0MQRbFu<D9eV{=By_G2Sr`l@9c4Fg_>vF&1&@~u$Wk-;
zC8>*JFUFn5HoFLbi;q=l-F`FmLPV{iS1YLYP8|GK64Ni!uj>n}kvrZ47k-hKkAN@t
zUY=AFPj#2yunzVAkQdzNPK{lX=cA7^xS32#%GGgmq!Fyu@mqR|<qyZuPh#1Xh^V!6
zL5EZ(ST`3R1=Sk{OrJL+P3IxCWtk4X76YW=4x+s<RW`++N&XB4Hr!|<iWS(m9>$*T
zKQ=N3aVYFgdZdd{xxq#jDd?8N3xZ(_s`z{E9_rde<j;T7agmgCde@Loe3%{Z<<n0_
z+kUjo<GT%+ryZ0l3d*xQOXi#|z)#=c+4)qoSuX}}_buG#qSnhj|GYxcq>geL?x57q
zk9KJHPi}OK2)Om*QF(wMG4DcqXGzTnAiq7)c~J_RbqvjR@<|gD7zk3lj$H!nMPV-1
z;TN^b-TR1a9O$-#`tVPtlS9%Iz|GeU!h94fpzztU%gQGymrzQ5|Cpl76aGu#(~h;5
z=8t1pXa#*uTGZP^o-S|fHq$Uxitae&?m2N=^O{{o)1tJter#J7@oyHHv0?>^e+t3d
z!md@kH$%0wbw>Y83(e=CmJ=nqI6QIb=|nxBHt1zgs@*^6NRSIfQ{}4}_xb_x?&rZ}
zO7zaf6kk&H$0`56yb>OJFfI--w`kb>C!mbXh{d!OWh4CqGm*xyo&Ey4CneFy^cr)3
zd5?=>rF>IRGQgZD>^)W>5eUTq82lZ%ld=G;@PXu2oO1_&+5p=98p>Z<1c-o7g35dU
zb+H!metCz_G)}_d=za?PmaeDl+<dTNpuen~UnuZTM4qxkceY4Vt;%0z&iC0+4#wmI
z7Ib!4ct`K0{#1m6@{3kNBR?aZ;*F0;lz8)j@|mC_q0!`OL4Cu_=xSyX<zMvRXnrQ@
zq89X7qsdT$a-nuWR{Q5_*pA6w%-!~eWAIjHz6zhifZOfU2~nXkp_5pH5AUX1_YB>0
zx+$ysf<M^<*o;nJT9+<R><5Kimp${_rb@D*gWX13B-2?a!@ooqB!eT1(h(gRE8w%i
z8kmO!M=|4&Cj%cwc5Zd(5`{XC4cA!r4#PmgEAIN_oBd%lzTfldDFXoeoJbJ`6lv-t
zZ9Y&Db>T&1c7X9wJmr89ro;*b)S1hi#zj&J<@m#%>PB2YrI9(eAea_H6Z^8qPZFOB
z!crIl*Vq@IFYXGf(9_;xB`!!Wj1^b%_^LhMPS3xAGF|}O^aBI0e}uFJ2#~e^ljj8y
zVovkzJtZu{bXz@B9nhS?T6{#8!%jUNR>s?Rfa)&?!;;a!$^5y$(0^o_Z1YKNGFe<?
zfhltT)mBNv&4H_hJ<#nGRxf*5J~m$A2Gt)Extg@C9~8GYdD`VNugTM;g^nbv2--vv
z612rgp`yue064Ap7aM(3f{=zRR9EvO@o|aY0x7xco=NI7A!-gz%LZ0Z1~S`eGob&y
zN{(YV%OJy>@>6OZ6Sy&DVqL3v2oM@{cZ%%!5)qfAEiYegV9YHChE!fH2dZuK-escS
zE3~z@2`!b=o&9s2jx_Tv<6_M{7@VAR^4=upRq_Lh1LNCTK}5%wXrGZsl|N{!GYLoo
zOz>X=J3u&v>m%Xo3e@5K1GN|1wt^!{lg&i!`_}&l)<7x0%}O{&&i^OvJ@F9qi{kYs
z0$s-z+}@Ad<AU=`e~^ih&$x&v&<c3))bS65-~XfH{|LoR|2GxI<HupRv46lw{lA@w
zi}<B3j$mLPa-DyU;TOah(|tgT;s;V@q!;n<yw3miPy6Eg7y;~qxgkU3zzvDAP52%r
zP?DV2I!da~HT4JMumMks{E?si00-ibwIV~lsW{&Ec~SieMWucAgAU(+LA*bgl2aLF
z@j3&MM0gV=pNsK;Lk$2|MAGW;zkHqyxjBZD@Z3IvRUU&}d~7{G@JnDZq5Yzc5O8{R
zV1VKCO}+ObLIw!n5dJGN2<i)iC?=$Qp8z7Lk8q5CuV2JQL4B6iTmP%Uk*-b545>`9
zkB&ABR=k=vK4VsJAa5Yy6a6`!|B!ykvNPuA7Z1zHGl3~=;}81)86Q`u-@T_=h`TH#
zU@m+_e+eDzCIjBqiie~SIGKDzUj$p2;zvx-+x+2!gd+IKq6>jtjp4xr+<BJa8MxC|
znBgB27lOW70cM`+u9x_jBfdYrA_3pJlYdU>{X6TI{amP-w15mg(%auy!A<SQCL#)a
z0jiT}`2ZbL=!UHR?E};)U2Gt~%*IqnB!2)8JrY{IO>gXbX8l4$f581HVlE4nj?37O
z-RLmlIId{XYF=!ajP5fL@RxdYfoDB<=YNZnd+X%tJP|${jffA`3R(~Q=9B<SdgreV
z&gc9^n*(Tkcd$1aay*eT<^%yT1)&4vfDg`}!E###f}LVLGJAIi(6JGpfjf8^RRO#S
zrNgT<>;40<n1>n`3lcX7f&~BYC6&z_1>)u=uMQlX9<T`8O#27JJ%RUH)YY$jO$8D_
zNoO$PsMcHj6x<QaYjXh}*}mTV++Q681di|l<Px?9d;*^zlYJ)79pDBtZ?4*b#d`vK
ziX(-z1NZa>)64umo#yf^Baea@10U*QFZB!*lgxkc0f4>n3-##UYgo`C1ajtSsgsG@
zZo<tFhj*+Oa&;YZ^KQuii^SMtKvBIx((RZ5^}@UJSva|t$H17wC<AC@;vgBSHfkYT
zfS%$3eBGNZ3BATo=4VoqPVt|PogDx2h&LJfaVbsMN2zeHxlPr<0BQ7+K<ED#D%a-f
z&I9wYnxC1p3W14C(~taInVn4fjHaUL*qQv$MFFd-JYpjFu~2O_0u}W9^#cUno#OZq
z?*3MnCj>}3)B}i$(%vtFh>Fs{JZw)AXUJz<;$rw&u--&Q!0IfE@HO>;>m6yG;G=<{
z*U_JW{e1#&(-XfYqyRaOi;e9yKNr{`ZTdQuU>F77MDQi`X7p!Y#7A%j5tQ0I4lJ09
zn7=UMg(>NS=QuSG);eN4@+jI78~<=6?f8i7a5m<Rmbbmmx0<L8!2|C${v!Ad|IN#}
z5@R{3zB87aYh1Q7`xqta@V^Y?NInR70#W1LKj!3)8fd5nUi{GU695Hpa326skr9f7
zFGs6bAN(PT<mZIF@ssSF^)hJYPr#|(I|#v(nt+HHm6{=)UG>U-TD~W~RTJ`MVQD^k
z&Y1D<@KMW`FxL}Y;;B&Et|yg?x)l6Wh-t=456#JK4ZoIb<?Ds@=tq)84`fcSKU|=%
zlMh@j7v{$R=>XJ#1oGIkIvsI&!U*7CsS6`Bi$sran)P74=u%?j$n%N7FuyHIDuK`;
zU3xqyuk(NW6nDpFu^nQM;VJ{Mvo6OC+_l14$+EdbCYSD{bp3N>3REG>U~qx;lkSsP
zj!Oe|U_$w3GdE!au1yV4$6_bsj*c7I`E%w!o0=q%IVJ=HIk`EdK2V*EPZj6s_QmsT
zaP|6p5_rgniUsaiX8zwNb{080yP3RiFKNxmyijm><NE3j`Ju$=f6JXl`Ren-;SLGs
z2w9FD?NRkywV>N4a-y10r+1WUCzmk$;e+FO;xJLi-Tpk{PvK5Yl~-4S9_9-mIOvBL
z!8aQ>a&w<SJVrmeA(2Ex7<-pfM<-X4n)`&gCIkZcIWo4GI_1#N+&{@T=H!f=K0YG7
z8{R!HgPy$txQ)Q~AsWmK6aWAOa%hbJN=J0RA93EfuVd{<Ra%MyzP>=Ma20W-Vd~mS
zY0JT!5#5}phbLnCV^`fS%Th;!#|iw|x+7VmaagA!e_&L5W$N$Y|FH=^-&k+w;QfV=
zREPo~A~Aq0C<*}(-B_u-7pcBnPDeLBE?ivcH@a2rQ)srC5qM~~CJ+hY0d=sQ46pzN
zKvbbhRZy~^{5@y4?Rwf-<)u^Wp1ao{!u9>HY&ko8{$r1xu0GfgYt}t;*Lwcnw)VYu
zt?M4y>mI-H58^tXGt+J5Y~=E{k6YUT>jCSJYui0wdq=kRzysS4SoP0q+5q;?Z1%mc
zY(2NEdt=%FdqL}aK%(%^EU~xsm<6<C9}9n2WoS`uVSQin-<W?00016OFg$)<=P!RF
zcK%N8PTl95%mL;A^7+S*c}=5W0lBk(Aa3QiY~BH|0l)wNF~vcfAZicsTbew4rDk}&
ztrTFgpgo2^is$&?En_DwG_c=%kcj2%GBCQc<&T?weiHG}ax9n^?#QAGf_O$F3v+oi
zcNNV>Y|k&tO7G;y4eX$U+_=_UFTn>yJ}KIwC~#ypa2qB01`2ifnJuCN0Jm%LxX{hs
zFl7QIRk$!Uj|8eU`NIK~j|g-Bn<M0`VLq;wBN@%z#`kKef_|(C$ME{f<6>yQOgxK8
zqonuAoMKSh2tvG8+-Pwi5|A)Xhg{Y&04EN^@aHI4ID{0wWO#ksqVVOk$QWHE`PC1f
zQ}G>4<Aa)LAme##We_c_ois=8_m(3Ha`<r}!d$V`9}&yR0xo`Tr<jhfFC{JAJ|D{t
z-PPzXdB%o;CK%qVR7QR#7(hS0X&Ia$FazL{W>YEcpB<VMN^E@_S6s1z(eC59BPQ#l
zNcm&YG(898np$4@AuL6D47&8(*wBo$2Dq&TW-|{WH~<ImN3_}-#c-El9!H%O^IlNE
zYpccZm4;IiOKxDmYm$o?IC*pwY(bm6Jqpf?$w4_p2MKk5f;iTGuk&SN2y<!N(HKjJ
z^68=F=B%3M=FEY#NU$O~vKX|eQhLA1vSJ+^zIypo;Kc?XEv)*vvz$#xp!?G_U>}Rt
zV7@R9_^t{jNL9S~c{w=L%DDt`%orWX-x-L(2PO{rg6<I1fcK+f#|DqFhfyo?=&$Pc
z%dI!d3@Ux`_6$20gW3=U_EREd>($<Bpf~AwswvJQZS}zp@rh1XSNUT`eE|b7oqV##
zI#<cD#>An0U+VD4g@ilvU~7Uow`uQ$tz<}i{^Z|X-eitmO~B)l{3m!I3mXBZfS#J=
zjTuiB$v?M0bsINeON-<XEe)A{b^Uj#LluLE$M#`_zA9A|2ckt!)$f`clSj$H4JlC!
z&L^&Hd}OCXQSgr+1y3}oZUK*ii)(>juSv-q7cpoIyb^Js09T8=E+Ip<SRv)*5^+3U
zJTQC04JJ>7=qTtf?_+auGl&g_hO~9WW1>gD|5y1oC1ZTvSooR_Q2`(j=QSe-VN3ur
zw|8~_|M(>$vLF0M1p6r_Sisu9#M>^N74L#wr8tz4C=!$v%^<$(mUO2C24s(#(tG5L
z4j!{6_)cU@10jjhwfmhLDT6+)3(L-Mq$`WdDvp7>gc=3<zsKRkUN)S!IA!)Ts01DJ
z;~>8-e@u53VO5p7Z@rwVR~I!{ZT1+#E9A}caG%D5!hlQ^GXd|6jQ|3AEV-CclJMXk
zZJV2v#G-`i{}o_p3E2*h*m!=}U05zngwSyX^T7-|4L86Q<?nIfAf}Isq1g-xjy^AO
zJTW^;CV=}JWRm>DB4adO63nE)C8OZJhG2mD_uU3MUm^Z_{|-wB!+84j@q!Am0pNP;
z&~weCSZ|VTrSk4(DtulwIq6a#9gB(EjT<&#!O6)ytTscqLojZ!p*iTG#^ZckhB_>4
zLT2w`9Ub47o<l;!+_D-lfsM=)i=a$060465uNOr5LkD*e#88kJ>0x~A8Dh{f<c@?B
z>yEBfhJg(MV<WW3uky(c<kgP&F4;*O{_^4>NQ@`T(+<f6iJOG%EHaX&n_<n>-zOcq
z=!oXV!Ph=op-<-(U0%Di-J#rGI1UL#S|DoecxoAh-vCUP&_>#mgyu+8Hc4ke=ICm=
zyquZk`{Uya^7z2&_hUgYH(XTU03JaMt;KN^5Mcl}0_7Ti1UZ2KV_+`l&AXxcuzcOK
zzutuyteA*iBYc}mp?(wNbGM||o6iDuc%BNR7GYFyJPz=|sgK7{+;}j<ySG7Yy85P?
zCCxO^Hxb`PLq+72>nja#y@L)V+fPS&{A<60DlBqkp9B|KK>_2qm}CdjLm98mH2_J9
zZnFGy79;U`fbeyV9r=cM0?=iWIsI%$QGts5;chaP=D|!{Bz$;Tr4AcG8W4HpR>!6x
zBzHUTAjQ^4n{k;x3<4**PwxK=LO3RF%asPUs`4HH37A=Lz>phJr|FJ^6Fl>O;^C|a
zS@Z$AO2ESt|IYXXAOmo7q?v@aP0aqU7x)9l8Dr1~c3?BlHUgpmmI#<7e}Umm$!TAn
zFN*+3khB1?grx+6-<Z)CZm-WTc}Lod!!`<xs<rYA7bwoTvts^fAUZ60IlOXooDuP$
zfVYU{ltly-%;&^Hkr>F2%PcLz+>%#i<>fl%=H!pdJUiu)nIC-7ziS6a^6`-|o0lMh
zYQykLpmXC3DY@cJ<72DBJc6yt;1^<2;|_1>8Dyqmzvck;P}Pw~fV6q>390WV>wEj`
z4-*A20a&PtO@Wu^VMgic|61zgEr^ti+$1&rvpp$y-`nr}FW)=d|J+Ox(EyNHCj3Ed
zh%OO@>9l@CiZp=p)BpY^<u>#9x)1*}M4tdM4Cry*|JU&m5cw@LZ^2LHH2y!v$uV^S
zXL=+BEj=$Eq5!nuDOvf~;VPuSn8|{N<}RIIpQu;?;*MjUZ-|SDZ$Nw3z+D1kU_s=#
zAuF^}ST}Ra+z8d)l+atrIHCZYK(syX9fDT<XhHnc8<;ROFI30fkYxqU2LV1Sa|YOh
zC}2ps;W^tkwY0cP9v1^x5Pi3CADYRu<m0^3jGGE$&_gkp_>2|tTr#qH0msD=y7h2L
z8V4!{pc8NKpBpUR2nn{pQt?>>1r%&H+WBZX#U1hdp<@U(zfyrbPWDt0!fxLz?K+tF
z%uW%o5d;L(<5I?8uVzY6{N4aqkv_#8eXj`iKm~~r_6r?-X21&(61|4UU;YRNc4s->
zq&E<#4DgK#DC6Uk?p(j|F%bGK92CVscg;%#yi?jPB|5)e&*xqyFTy{L(<ji-Uxqlr
zes0hpws8UAEq_REULr0C^PZIj%19lE{%j7pqu_!r4!V|H(dg&KgLZfzh9K-jC1Gwp
z0Jpg}=Y4-4msTP#uylBxrNJhEV|lxl)#c+J3qnXA4DWnIF1Z-d(?H?9Z|8ruHkq|I
z06YMI7C%j<8-JbQ4i+Rjl$`1R90$e#a9P2rMGwEF@z`{NOHKTLfE)+XxoDyHixC%K
zc|Im=)UYptjy+RV5kdn{cwl1V!Z%~eASHhyCYUmYytD!y6Rt&@i_I-C?D6ym>)&=E
zlE`KSzDg+YkntMirh^;H1P8#8t@!nLXOkWpAJ++aGG@3>8ine^SMZ)2g=AqT?3o83
zqx;y*rH2W^TW$8ij9D%#nG+~>>^6REcwtx|edg>9!H<ftO94lpC<z7c9J3q;&mBHA
zK2ZalAPOvEG3g~>xhDwt39VgPzy^A(*(L+R?;|jvPH+IXNxYET{IjBnDdZ_%{`Ef}
z{r^DxMgYazD8x(yh1cIAHWmB6os4ERUeG)mx?J3=?T_e`hs3YWzXcrv1e<2ucMxrd
z{vGki{ecM3Oh|*(o;UmSgZrQ2JB<*?PQnZHu@?eYk>2J0!T7$Bb4e!*_@5IAY`2D5
zzv3jv1}5<l6zE$+ycB&R05`*u<-|gLSYTX$hXXKhhrC2xXocu8lZKKG188-`K`rJ$
z3#sYS5oP#8s@os|IdcidCXbt4@P){;AG-{1@DM(n=;L4d2t;(2wK>24JTZN3XKn(5
z8RJT@q@$m|cnT(K#nY<rS-ju_7$$lJM?fmW+XLKqtm;}sfMK9TVgVPrRx%oV)+2SG
zMdY+RY2i3y4MP}1xq&g^wBx7bhZN70Wa6^P8lVOg0|6G9IWNo=^4>#<`uEErrUcL6
zif5Q0c6?nEqM@+P=zebi9C)|Akgx96CK9*+e_z!zC;#98Tzre(!al#2DK5Yx-vG7+
zwTgIq4F2b^Nn0HCBR}th#NToM?M2@L3_S0|#rQ>Hnuiev2p`tZ@KfXDz~%Hy%}%)A
zPAzZuJ`1bKJOlFhm%qYye~Iyt5^<b-L={wlqyoZx<*W)seSYzHKsmn~8T;bv(k}#$
zFEc=P#^wjzR|cXa_*&%Nka4-c;W!(_Y`%!Yzq$k%zP)E)S+snRsfT}azyrzk784&0
zez2Cwxt<QJo}kdL?$?4oU;^;(p0iJ9zs<1F-E#Tj`8u3E;wUa=GUafFaRwNRg0?tz
z>!==ZL*(VSp81TDK-;;{5ZvLV!CldC*5%ctX^;u{MDbj)VWvR0?|0%gh`tH0v9ik8
zJ|aZdj)KQS^3{iD=Aat{g8*1*;i%wy72~ZUfEHREB#>3u02X^(SCedq`AV)l+y1Qk
zzk6={7z4mCS#e-{Sl@rQ|Kf1`+~Yt6*7GVD_~Wq=-U9!&pb<T?4*Wy{>TSX|jtm5C
zG6Vf`I?6+cVCVbHy>GALVnjr8d<eIVe!t^0KOv#jLHx~4|7*Yid&UR`H#dx+F*UpQ
zd3+tGDAYIiJ!Qdh_M@6_z*v)+=gCEWZU!o4wYPZS`32~4DfFYg+5Q0V1Xz3)1a$si
z06?((Jqib>Q*(E>{In7dNO`s+hAM&Q%Vfi8kK(eOrZ_iJpnr7E-@;le<Pa8x^JH3e
zf!7zBHi{4jw0=l^PVO=?CLBh%M~s36ZkF;b8l!!3t|~XbeC2>R1oTIOIPum4pnw<6
zVH^)<07e6da6i$V0el05u)=~ye^qcvfF8=v#Fuampx6+e{7iNNXXcH#0L}YT-)j|W
zt9yU{({WzF`VcT6S^dBmr^Hl7kIMxg2zZE?h${FR-5FbXYU|cV39CClG%zdd#Qo=)
zTXq^>Vc?ES%Mc#bKf(|!3DCuH{|6doBFhJVGvOJ%cdg*IwkYz!eBqDU|8E8T7+M|<
z|JOg^DUlIPhm7NZum%rM_$&>dALNgX)&DgHK-}tAET_*D=wdl&QK4{u6~?pk9Jl4A
zIp`oh8+C+)Fwb@e8=YPn5geDj^G{_MY`iBRKr<zu_riGCy!!|P6GZ!X?G6AQdq}04
zOn2u1xt#@$g6G%AZ+>?00@PddCB4)9O}8GnL@m5hl>e|b!Doh-UCSex0f1e&L+ii`
z*5^b%v>W}=0)jzo0HsaNg!$+ZMEBlblgIKvkx-xNnDUMAFkZPop+8?<5c^f!0sQ?Q
ztVjLSmYuu;+fS@R>fbT5Tz|k10r39|B!_#X#Ov#C{2mzi^X@46w}bi2vm@{d0F@!h
zod5jrH%802j3U4P>%vwUfy~@6@CqGkA~O&A-{A~D4LcIyf<6N~LXRR^URi=oywwPt
zzBoJAHCb5S1pK)@=nt!psZe=khgJW=QsV>fb8~owfO*YUvU73>kYM;rJdg(*F<<dq
ztWhw`ajULwZ}5z6Fcx*t*ELb!p8$Awe~ki%d!TRvWLb`49rxG(ZJFqvNKlh_r7i5s
z{kCnN_VDY1Oal0IfZ8Ad|I*n9{B%rht^V*3ImCtN29dBKJh37q!W9SzxQt&U2KSUe
zXVtvA0UJatPb>lPT8sqmH1S=;r-TN5i;RNHqLM7EEAtFayYs|=;^AHe>o}M_e*nww
zO?&n5LSGQ<j&uIbkQX*w@{A(?kzJ7)hMxCPVz1?p6gU72fNz>{0>GHtCj`_uEy<6J
z(>;7AAbpgg3Ij@-?<}o@ZfwujBxWXuPHyirOdwxauYyUVU~CHt<)at^=D%1kitqt?
ziH^w#bNRpqGMmzC+Jr()JW`c=gb@20js@z2;z0}^GQIGG_V96yRei625^U^1NG?nd
zrd~S$YSYs8fQ#}>_U=Ty;IW_lJ6?Q2!8kDEF%kSJ+Wg?$!tlHG>0RfAbDtW2dL(C5
zbLZHBn<hh@K9|Io@B{bGY(M#z@g(?JH1@Fu>&s5>zTX}AJjR2bIHT(BY?EvoJXh3G
z6#w%EGqTaMIv}x#C5$V>|MJfhCV!Gsy>d!+=!9@XCqYKF$}gLuHUk5^XC(CgXz2Q&
zf6K>)U1CQ-BDW`ZyuvkU$L=(XM{+;;Cia%w!+;;!)yMuQ#;OD{|EVW~pZH1u$m`rb
zFn+rOhRyK@4b!Rti8erFfFs+s)yfXAMi`R_6A3tW=dLTt#Q6A_oSYGLSNSskhza))
zAP|l8ANC0mRrY|&02MS!AU4W=ra+PCJv;c2Rhl<;;eQ3Vz&&<uka6n1H>CQC`jGrn
z%%bJU-p}!qh_AnRj%As-M^B~wS;SWeEvI};>Mv7!2zvVW5w2O(a3ytn;FCVGV7y-)
zj3<35Ljf58We2Z_#fC;LqhsPiI0S>&2mdmadC(ud08cqZqJez3Ou!Us0d`vcH;ukl
zU(f3jE5IgRmV{yCXZK(PU#vdy1AI%2O)q2k&Ke9OWH{VMgd*`35+z=-As!R$2Haq%
z?}%t%x_9wEuK)q-TRWgJk%<t$833T`!@~29?{(m|8&2MG9e-<BT&F&Q0M-2SF(2|o
zgB!6|nCSJL*WbFZh!_vzxkCtL6N<pdbpS1@13lx0&JpFMdgQ+2IEnMBAK?q;jBpU1
z9T4D?2y$fkIVnpo6I>^e^fHDmoB)3fW(Wl9YZZU^QeC3$6fj0GkuHCMWg<2?HSyfl
zhG#@hv0K2^|G)lIn+OpD&<8zn9ue?%HQYOg`EZAXF&zFgiSU_?!(iZeCnVnq;R}!U
zap8USi65^WAHohDQ@VaF?czm5)nkq4TKwU=-~#tzoogyOiO;p?-Vv6RNGu}2{T@)L
z@BkA4-U+q{J0uqoumC$m2Je%OCMXi*l$FYmE5dp?ksU5W7t1^)6gm*!1Xe@okI<hs
z?<Y23#C~&Jxa~UO2}E4r0?<T=SO^25zu_NH0%Y8D2&><*vj2ww0kBSqY0nq{2%x2y
zGKYKf+%S1BTK)KcUWTxT$;Zr}i;v;<S)c$G1ql_#X7k8NrZDPhjd#Wjd`)s-3+JwC
zIlup%Kmho6iT?n=PzOi6RiAx04<8QvJ_$tFrmpV?y~yy3d&#?QwMhT<&s^0aej~WT
z{2{_}9LE7-GaK<eUM3(RG)8V-GcGc7S!8iJYgxL*TwWU5KMn7By6fPR9ggvR=t#x}
z6XR`KiNFV9X9qBiUi^PZ5x`}p$5^jE#{ekgjA%z}@K|bT?|ApH?dHSYq#cr<|BA>c
zW-)+3a|~WP4D)y-cwU@GgBl+9es(Nm;D<#hUF#AG{sd2cc_Bupb|c?azjg-x4nuFi
z_NMz#T^SLCd2~-dcabddINnLOPs?C%^47lz!goW*&7T*|mJgS&O^Fk<H*0!_2J)jm
z`k_r%{pXkxskF)ef^0h^FarRcy(@0|c;0Q1zk~$E;xoU2M7wZVNs9sn;yx-KDW44M
zKDerQJeUtTbTxbHFg6!84ikV(wLg9DG+WKyQ;lYb#PVV=!ko9yqxg;<>pv`H<iM5b
zKlA<zy#twMP21`xlDhc3+vk!aaIcR<oH*TVC7y*CKlyV`lIGY3Fby9GWrfT%#?U<h
zaEO|xr;!|oM8tZBt^N@?#s2XkZwB!ZDn)_ZAj!gezn%UIJ2BEEBC(1GkoG?Md|wLL
zlwk0mhV(YQe40a9`0pA32*}LPO<=%lYws;J$>+z<Uk`5Y_=xL6$UbZQUn>Iu@Dp#Y
z2_$AQO^=AU9kz}gwuch_2w;`u+CIW}!)^oC(>&1lU!<Z}KVOgB+QbTg`_ncrDvnG@
zM_^DMwns4L<E=`q6Dtxc*X2db@O^X|Ww0)JNiPqAOM7nlBX{V#=EnpG;H(+);@vZM
zt+5>3Lkr-dr!}B#(X{e%Oc*)Yd^a*S6rq7sb0$SU;VB~dSZ4rPk#>dy;<Qj9Wrw8z
zi!f7jr4v{qq}(##UG$dx{3M^nVZ})PP!=yq`BWyjLh#4JSV-YW2-SgnXU0Yh*<sKw
zZXH5gxB%W<X`|l+lm!e#N7c)h<m&R`9KU)N?f*O83Tv9&{#;0yF6o)BXu-#lX2oA7
z(~#1c<G9z;D2f0M(SpGSA&R|an~C-Npi-{!Zm;tBWPV+;(|vkgN>t-8guPx~OTI6>
ze;obcjZ6ExqJ+4qkMA!22`L9xSjWL!7RQCbkM7$(K7`J(?3!dS023i=!Un~F0TCmf
zay0@JmOtXQu^?^)?vh-li9dvfK!M^x4WtrgGzwno;&8kWilYD$KXJ#ijBAH5`kA4x
zm+H8xp#ky0MChYQf_3knzlNKxxhB)&e-S4M<-J~D0iEQ*2qKIoI#yN!0$wJE4ba32
z!avk|TZrVn`Rjxspj){t!vF$jKC*y_Kp5Z;uM7|<DJ<SWh6uTQyfw|OAsl|2^TJ)+
zS9sKB{1r|FKvN<*1xE-kgg8F_9|Y1Y!*Jfms1rDB_^ciUPME=hkyis8h5$si*N|`s
zO?qVS!)^jcu08fX7IgUO!Va7r`W&w&BqM~^RQR~O4y`aQ4i4Qhb7NGLYH=Y8Jplei
z^<EJ11h9ipj(fxloK`XQ9@KfjfcTv{YnibI;m_PA<Wc{K!|#&}>pu`aq;%+A#Q~=n
zLB}I9a!AKPw*l0eXMxi@m~_tPT8B*TVbeRB{S=Tc3`E_N8L+SB4yKbZbcd5P8*l)|
zdo(ClNTNeR!;2Nm_;JN^4lGwVB$>ycNi&Z_)<v)aFA2BTuJvSsTwH^$K<+wJck^4Y
zgRt@ZIVh9RYs8~J=JDji>hXQ|NDyLtOjll$hJ4akdiu;W`8xG;bHYyK|I5lGREvti
zzzA(6G6#ebY?QJO0a3`~V0akQPfI6$8*l;_+P05ZzkxCG55B}#Ck6}r&n6fZfZeLV
zx4lp!+_x@p=&=UY{#z(PgvUSgU^Tn`hWQ9qA|DBPeGcQM7d?I=NA>ToS9od+7x09l
z+(M_M;F5pb`RnW>8k2lRb~mv*<-o8eHssENvw*8wertkgH~<w0qSG)`011uH9<v7l
z8y=aOfB^x)xf>4&<Wz@4rfTHjs{p{}f}$Y7l|T1mxcdviChez%_h3<!$K=Mc{u9!%
zl*PH*70H+3zIvchl*i=i{{`0A*b&Ezj0d~K#do^>U*X9302kIKGA1+mc_jUCMIp@3
z>xlhg`t@*Ck(6`;07Jk4iI`Nz!$4apEIraJWe^>p{t+?m&i@Ds!fZ`H0n5^1F&``u
zc$|fRMBh*CEJ!A(1P3DYJ>$VXhg?v~ar3{zSBBJy%i^h&AXr6lSrk|XFlNaD7>@)y
zz31kXLc}pm_39S(UL)X-1~mchgp5lcCn)gXv+z+cbYvp>6*Cc<H0mzs>_g%_N8&yS
zqRJlCHsAyAO#6|qdg5Tz2u*nPm|y{ADJ-CY%55_cf`G+Kon+*~URQVXNi2bN+!8hg
zcImG63&WN&=Au!Yv+{Mz>l6}mOY2<P5|Rt4XwK}&)IY>ao@+;!ilRVEV@ar}nL3Pf
z@PL>q&-}&QnPv<>HG^{4_2=ZsUQCG{d#i*b#E<AKJmq1xm@GJ&M&WQH;t`u0`yn^~
z@F_Ib$)<n$zrhbfCO_Qy(Jn~v#qX|MZHp(O@eqeV)4-gA1j#>MzHbi1fSf@v;v<jX
zo53-JOn68U<ii6WDD3OvMMsS^&1z#7w9Lxe%$S4M<%Rf%8@)<B`RVY0tOSd$Jvyy@
zphs5V{lDn-Mwy5b=QN~4^1s(to0Cj*NWq5T41YDI>8=^JbUKcn{THtj&B6R4IqN(n
zhxjC!4&O=1MJS13=H-06Oa-;yN4#VAbyt0)o1xeTsEC?R_<*#aC`iH2ABEx-eUu-u
zFCR2!z_TL<OMY<3h9km0kBNpPC8Gm~0_f!zKo$Hhvw?ZLO)e*)sSjTGPIfSe=Z{7m
zY+vzn!G$l+WB&1d`P}*Dpb=rLMBHCKA1ERB$MJMWALq}(4>;0&TovIP9aUl~%R453
zxA=~dT1jyM7&tmAW*sIXGT`ejAb(eX$%zF12;NIqhr(9t-#hp~RvWB6>Im+Oz<~rh
zv;Y6_O)_5M<A<KJXj)PK;^ihZK0TDsZ<g7Fu^ctkRH@OGKR*O~urxXdIiq45;cg<V
zrU*IYz{|lNhghV<0=xp-k#jrOu>FDlcyneW6F>vAPMB0JushkWr;j`MfJwnjrszYP
z4#aWA#Q2}f)SQ@rMO3<xOTKsU0I~!k)QtMp6U+zNyZA-V1skI~Zv6;>jME_bxOEL0
zy$cbD=92gF^3t&o_cm2F!W{L+2f?T7n;9ASjuMBYiRQlAX5fm)DjTtG#`V_^ihx*`
z5G9H&>)sR`jqpXh-WY+5wk}|z&Wz*l1-CIbk;hRx_=9AXnS_2Iw-`5ZIE+V#@gInY
z#CVA@8UKmEJnS+^!<hOukz*>>fQ6PGcIGv83&k&ykA4T?8^ahh5fIK6C_rEjI*VQj
zJex18*DV|VUWjfn^Le>AiK+IS@fq<ySA`-lmpxI99)F7AKQjm-(|u)JT)~sKFpUuh
zywc+r#04QDLxuv4dD32m1r_KGm9H_^G`1w}aC}eUq&IxPaIE%-4Ppa4JiVsAMR01w
zhQxe8AgGZMxInnr!Qy!_?0+wed14P=mJ>tVA#kz&AUS|BsjG(?)^)&iOZA!l3?b}E
zY-;<*T+Gbl+6j!m{f4TQukhBxj%`NBy0l;XB_OTnF~QpV@0PzOEavVH;r(EOzHH5)
z%hl%OoB%j|79k=tb;`K@NzV^6he2w9-(0JNF@Ot%pU4lVcWD|V2k->#KzKKNv7j)v
zxGK*N9}pd5PmhQWros`Jh`5=s>vHg)|Kr{NhW997GQRdvJ#dr=Tfg6Uooxa7o)lrA
zb$<aL9&a=k3i7dxO6ra}d;h@=aKqwYY!@w)#*Eiq;x);ck-Xvuu@iXp)!e2m@m#j0
zRyGg3Ncvq9aNx!&?C=?ERTWxVh$EmG2>ehg@SzEbTUbBx;`%~Yw*DYLyIlhEU`ME!
zehmK*7W4x=rH}(J?#=(EEVW|(8e5E*WAC5Fc+5awp@1?!NscREB>mUQU|4?zt*L?c
zQ=(1zR6&d+J;RG}@cwKC|2z~14YyDHw}c=Qd++*_?L8s~Q#1#?$HvrSUK-FrAEyun
z{3k4M+2(rY#|*g6OWp{NxSs8sGIC+GJWun~snL}`o$tJm$<J89?1=vp&5?%x1<~oK
z1ICUmuq(6S8A7ec;mRPeSit%!N|7L9h2XDr@DjaJKcmLuRz*&9No)eO71o^JydOjL
z2@l?Gn%AtezsKYoyKx_*^iMYw$PAOf7guCC*?=>NZ!h8*`a}Mn`8j=I4+uo!BRF%w
zNY8-(68{Zycy|PCsYt*8OxnCZKWyW-_({i(e_ebymXGvTpZF|+BXO07j$pv=q8~ji
zHULZ7`!4qYk9{6~wwK(2Hi!*@c!eJ={7EodualCxg?Xt@uvN>9MsoAi9pO07#qhl1
z27wevWPQLImu+E~VN4JPzwr|Q>HzN~bASSZTs80yN%03o4c8+O%$k1rOn~Ybzv2Y`
zCzlC$FdF}4gW8@;z#jCUg|8#Uhz1bj(&qlw9J~Ylbr^rPKswoi6GGI2A^gD4;e9sY
z*=WrO_?c)~_>XvuMq)7@Bk>0DGanJlh0M8lL*Tv>vtG!OBW?`Q@C<rjNPq+T-BfPR
zfrP$|>78D<C-4DH+NrXAfCwM!;_tBjpSco0!CLu_5Kq1#tzv%?;VL#{3gO@SaB$qm
zReU@U^6{)-lZI$=7`l}_oBnSbYA=(=h0Eik0I_Jn-CFcnR7`)*UJ&5?zj%RA0RI(}
zw@Zls+q^gEb1D!TXm(Dh$Njg2ntssPdw+>6G5u@I@gT#)jt0v(QGbC^wB}66|Nnx!
zQ@J1cd{sF7P~9W(e6rB!I6K#3VX^`oX3ge_#CVgfVnR3rBlpAq&=32g<qzc@Hx?j2
ze;^%{y#R6l@Iz~T;eX%YlK>gN%KLo4KyQj_vY%le{r7xzFadUL7rlu3zyi1QQM7NA
zxA`I=@tJX`-M}FFuWC2Ah5rK&<mK@9CPuOEySUMwF9dvcYv{w^N4+@*`Da6FPQ52J
z%DcgMPV8(Agrze;PmHY{pcV?+TZ_f7xrVov$@_c-Ep&)mJj#9#^07T_G{^qJlOskM
z`^SQ@mvqsezt@-WU#zVWoBw+M1YZ*kkPzeV@Pu1*xfiBzBXp0&j6-^8d~JLw-Te=a
zFG=9=K$h-7!>~~w6SL;;5k4ebmFj9_h=R-j<6Epg`2Z62e^38>;x+Au-Y7-kkOLs~
zOhVYl{)}(%;lv-@d$bQk2k!xg^LPUYD3IMB-n@4p0RRs!^0RgSjQwB)11o$xfd6fQ
zrZ!&y3om_)lK$rV>WN5E5eb*>;YLP(&~L9_7p&p}G?VOtkr}(q@^D2(G5<o{^HLG!
zr*1QbEQlawePybhMle<S;hC|I!f}@2^zQ%OvxpCZ8x2TcKf}ktbH#qjkN>m^>n_n4
z&;M(|bH#kh#sAv)FEy8<F~9w<1#d0L$TR=i2X&XBE5H4(1#erCkk9{X%lL2S5skjr
z!wdeCeSh}&dIwyxD^vmC2iHr48Trf9<N|u=gNJICGBmu4<AlC23cflFSePU5f!uHV
zJ;5S!#C}*}4gvU{ZvZa!d&qZN5f1otxab25+>CsE!5gzK3<4+X54KI4@H}-V+__)h
zMgt#$wGU6H*EfI=<#~ym|Ms|%-T;-6keomMKm+4(S&*Io=Auxh-Q2(XQ2=6PQn>5}
z06u1l%t-J5YKcOdS5p7&Q7Dx&8GrVJT-Bdi^4e&4csk+fGv&Rektpfs%BR-_+ZssI
zw#zSqO@X#^>^)u)h|kx)T-$_CfeZQyf?+iPmvx8EUw`z)zbwD7#dpla{F3b)yYI)u
z2iCr@e6xlEgR}5MxZpT1VUL2TxiVm2fLTOwFu;$DKk1n<z77>{UurAcziNOi8y*}`
zH~k-%6D%PYBbrWlfnC9W#5He7{MY;|@CGYZ*#7=sGkVy6-FcN>n_~yNMRqvzShM^T
zKwHEE85s&2#iy260eSq$`uY+xq|TBjCL(T4IRf4Yc|GfdFp<OVp8)ykM5VF=`k)9@
z`2CP0zlh1B#M1mkMtBDrqW=uee_YrAL#4OMZ2&N`n@{MqUOOs6AG=;VH~>%(1I;mB
zM#%*}01o3gNN~>K%%dB*`=%W6ub^xMv`B}6JD2154}3MHGL?q!K~>-5Y#tshAhzX%
zJOE}28@@OLv_X{wTB-=H4}0c~OuYZ~e~7{sx1^`zC`>n<T(d*2ZZ;O-4)HwQNFbBC
zm?in7W{MU*;yJ5MGncEEn_BzYF_wk=v^Frx8kdKBxXHWtsQ8BAuw+?$$^!g3U`)nd
znz1xb|Aucvs&*LYJO|W7XTbZ@?G1|m_Pz?or%<_X_k%K=$+X}s(kf~_L*Lyw0E~r&
zOg<EB-{7x+S)QDn=sWnLbWD$Y;FD?A%m03km2)|_Z{Qza^B~T+4Q}q#_I&;rU;HBV
z<l0}q{@hGPvyRAVjy6Kp#8rv^3Mc^?yQZA}|Hk;A<&;umYFL1Xz7jCs_rL^B-imry
zh`-_V@L-Q%e`vqrA>P9PV|rU0{$L4zT7D~A>Mz&G?*M0i{J1}{@}&#jzucYQ?EkJ2
z@B=H#`nqtyKt@*WLpW*q4~K97<JTHbdtG_=sJ(M@P}t!7MgU)Ur}czgpm^~qwjm#`
zG-{JB|N2rpV8i(+49KL1tQX!0ITkK`<Nyl-Y6sV^uYC2LHYFg?f6r6V0(D?7^(7}Z
z_RY)X<2fdjbi7_vR!<xS9Gno?Z+1ZhMt-<W&B!1m1Owu_26;zfbY5Fu{u8E1&<>q^
zB@ZOaaA0p{P{niBYBOp-Tt;Rw#41`Jh3KX@+0=9?S&<nMSL=mwRrn&O4K;-n-QGLB
zMvC{6pNWiyGaXEq|7)Ofo4&J|=-T4|LG}I1^U2un&@TXB9(10|{x6E|CEWZ3SGwd~
z`<Qup_n)o_aFK!Ty*hl{2!C-gRve8RJelHPqQRTss*hLL;Td=#d<(OD5XJEFDqmoN
ziz(lU2=Kt35EH}+1bB9Oxl`)@1hNCbd$st`&=0wMUw~DvPox2btK(+9@E6u5FkyZ-
zzy{NG&7=N$06CLoJjvhRAh}Jsi9CxLjwNT18s=rHrhlP3X+238Luud}Ipav5;G0i8
za#YEC2mU`u2yyS7^YzvXi2U_BRC6cg;Evqz%jTd7etv3qtWV39G&RGVemhif?_=@2
zn#U)3IWuqMm5v?e^Kl(;n}SN=xK3s8w=9EEB<i|{BHS<(U+}(Uh^Pd34gjz|!2Yq|
zeqc%g`}`2bLARyr=EekY(sIAgP?L<f|Nd?=5Ug9l1TzQW_BIG~8VwJ-RWd??0F8tR
zx@%nB82dF54njOCI9-0(|Kq#@*`(YTWb#;eyXpmsbWa?RUv=;IA)qp?iHwhL*K}h5
zU>r^OaIOA;fOeO1J_-tS{1ia1rU$<#difAw9d?CgLiqYAj3@u_CHG@*`S~E`B0u4G
zmiO5+z=071DwcuvgY35`UH|{V3tm6P^t;#(dc4z-qy(Rh&7_*Yt={*7p8^)M|BZxP
zo!JD&07_^cus<A@q+J&khyxZLciaX4t^@DfCNT&2h2mik0cLyNW0?dAIVz663V3b1
zG%`lpgBRSBgyuq=$Yic=^zHh*M+8xUmAe+j^40B*>)&32PU))~8sfZgO0ON<{r4`e
z2&02P-cAbWV=0F5fe8TOAYf5j?7n)lpvp7*<kbNXbJj19j)A~fQBb%!4rCBBkeP20
zE<`BkFD1g=%=}Cg+CAWZuF``vm>vSGv(K%8e1RRWblW?cp>^*+e~kP_{YK`%TC%;0
z|905pSH|CHhFbeSZ)N5z&OS~5i}Wx7Z$h$CSbO)wC^r<%u7)o8Yj6J-YQ`l4dYkcT
zM;F1NK>h)0a_0QQF?_3aJPZ8iqcv&3KYXfqz6ama@*PC5<18dh5ls=HMF1M<TWLG*
z|BN-p$|9B(5GjTji{Tmm16)LY0qL|=IoKP0t&_w>@NZ46?FdJNfNN%s#-yZMH#qF^
za50K`S`DY_n*T7VtM_1AGOi2PpIbzt2o9DeJAgK}lYRx1c?`-?%pO>F!73iE2ZW7C
zyzjx$>@$`7!SGx}bOa-$!xLT}<@L7u+rV2?n=0ndDF^=l@XJpVeCE&inKQTbbL#cM
zEZFq%u!49?)#T@>>F3O!o0@}>crwBfy?g7|iHhf}CG)rc1@;FnTBTPP8wdp-{vv$r
zixdTygAA}h8U!>nv_Z}&zB}LYWpytFo1x0zu!DCR=fNMWv&$0vM3>Hpy;y$?&7BFu
z2Ye92i6!Wm8&^G3Bjr)zdgb!$s$O0l-?!hEWZ|v1VXS!ebpJ3>Kp9@HAIDkp|Np@j
zlWZ=6z@PvAe&R8lH^wH^fJ)=C;s2VJNc-8wzHS_z79D084^IdB<;Jey&B1karL&sw
z`Enn4i_2*(aXJXBRGn*wFw#jzEA@>LZBhOj*a&FZYWj~J+^_O=%i?Nl?KL+E*F;f6
z!}9i<U0%8Cwp;V_)-0>wuYx|v?7<3RCFaW?!cf`=hL^HBPs5vPP{6Jd=k7HB!*uF&
z)&az?`FXZDO3=%}Y~2xqKE*7K-vpMWeZZb8vUt(At_dbWV_!?v@SB2P0l8oKzx<aI
zj)JbaCN@;Rgk+l;&T4m%IMck-`;E!*9NNc+N5Z}}k|5e0>zSsokB{yT1J@t;OKk?-
zkkA{zFt0D0gt@w??g;It>bOrNm~@cK3yS8VR#BYU#weVN-w3#MDv;>-LcSL3yMBN3
zYzDwV=m;Jgk4B+G!e|E6otW7d{|QSEO)snbyBUKTyd&8MAh@{5veA$?E{*_y=cs)<
z-}lA&F)NS6a81m^S$lo;dANyT+hB4W@JZt$<^C%{hY%n7vhqx(hG>Z9nEM)Reh6m_
zGs^!iQM+a2l=-7yEn3%JoG7Cr1M`3UKgo*m9Fs_>zb$mVd*M4-%^q6=KYlkE=8`t&
z#7)5+wC4y5E0#cjWE5-1$OogFhEi1D85dgDBsRJ#E(tw`f5P$crQrhe*!c_Vj|157
zG#~w6<gka5`S`pt?zO^=o3iu!!Mnf0a><06Bbdqv76;)jUPPJbgAv7B$G{)Tc=7x_
z#%6g!sp0gSKH?gNRzlyd6SGGR+C@oCjQo^N-F1JyctN)$yRVv+rjOUB=A~*UhItPZ
zAQeFdp%ni3Pj1m>mNU5}G5#ZbnNqj=w1YBF!*Z_6d*+Aw;rE_V!O`;b<WDT2gI}xt
zUS3Jz4Q^krS1pWuP9ewUw7@jM=Ptq?ozKY%SLQn3HpgFAggVRXh^`W_Oa?%}Vb~<Y
z6W#Y6B7JgR$-e}U?+;<)lb)l;nsokNSo&k{n;n||y(bZkPJ7c_J6yna1TY}|0N7=L
z+WQdLp1+bnbYu(-`n+!wR3kG+Na$C^<CDJSMFjyx53<Rpr~kqnCCv6x1cRtI1;D>?
zp^gNmGkg%plAlqW-d_1L!|+SlEscQP)yYkRW>X(=&;@tN&s9!UKKbfAc&GeV2xaq0
zy}KeM&C61de{r;rpR3<3C!$<U<_HJP*K{b|%p`m|q`^OY-{zQT!0*9-n!1=4u7sH2
zN*L}R+@eR8@2kayG5a6?$;;1JF@jI^+&u@k<?ckauCMiVb$NK6XQGx^ONS&8D1htZ
z!cWEuzjhM>jcQ(MTVSt>%N(q6aE4yES3P6Lvm^XB%_IyE58#G;u-QFz=trx>@I~Vo
zf=*65HItJ(se9&(QSj@QBb(2GF0WA-CgrMj*CljsnnpjCL>Ae5lM0jaYTW#o*{^+j
z=dEUcg?XygFJ6LfUN=@Zn?}GVKjfMyCdUJSeAl-(UWAX=3&(~FUyZ*wnFg_>AN=)b
zU?|F_fdAJk;(Q}_k9BX$X}`<m#mmDGb#nD$FR$Sa@uNO6BLNK|8qME7|NsATX`;!e
zjW53^f=(-%ki=0zLX-_`h^BzYaa3TE?HkaHUFRc1tRe|7K64g^p4e&{gcWm_n7X-b
zGT@*f2^T~nnsR~V5ZtZ+khKa($xMd&ksmrvYG-K=$p!j*W$WM)-AGv|890E-)%_*C
z=f%7_*idu!o&$Mzf6eZwE1RzwyCx^Lz<fME(e7?tT|GXM>a0NrjfZLppyoGj>2i)f
zaZO_FdY-wu%U4tZIDs=neyaM?4BCxtzD`VpsX6a@YsZtvpAvCg)P^F83KXEHP&vR&
zdoq%84xH7e^@*)spED=N)!sC=s~2YMlpa%|2wUhy)&M%F%+`lX6{s|L?=Un<7Vahz
zPZUOM7_pL$Jl;9P0%!mh#6i56I?q<*cg}7qf1gigWm{KCDa&Gyi>-R(zWS3_ogYae
zS)Oxg|0%p_Q-iU+i~h^ic=P@+uMUG!lq#2^i~+~L*U`<YVQ9k@5BS9nG-Z$;ydfIS
ze?R~K|8i+0Ne*{;?Ur|t^6-+XqLma1C=X}~v6C=e!<hkJDaF9*5LDGpLu~fY!(|De
z=(!?-;=pR!6-WK$L(%iQJ1N~^$!T)?EhsuqDwRtVOR~1Clo~7xYWL>*I~_S*%FO5>
z$ogrzLUB>G*M6Qa3lGcbWZ6X^o}Bc5hjQ7Aq<d7VXsMw8Z8s4}g*T5j934*xj~oEt
zO$L?|Zkl3$tGZ~8UMU8dlM3Jy7L(0bO|+Z10Fn>~CW<7KCv(HswprbE+sndAs)|%l
zD4-^*#l{Q*A<o)6rKL#-Br0Mef(V2mHfhr2GSOEtypTqct5GfNjrbRUXcuIq<{R)O
zuE0pgyI<atr9MnZ`_JpO>YAu2W6uvYHy48#jSQ-4fE6vbIVq~Bvs>W^oo!hw9_wm&
zf?3EX*5HM*Mf95GouIre!OOQP&J1`YQq}O+8Fh=N;n{22eY8|r7MpMY02@U?n?Pz0
z_l|;lKmbBq-13HTAO8?0E0)1yw}U*AB+4ZM|6Z;xP}5Z)tw1~uJHBm!Kbo}Bg}Siv
z-K-3}v^kPESCVD1$WMsa4aC)j@&#I|3%iy)5%Wq2YzA<^P03E2oSe0PEOY>REr{J-
zFRT0~&kjCgHzg><l>Ount`g!hW}T7EgAPgeo0e3X`Ld11KojMqcwjL+yKTjAMY<Xa
z4}`W7Lm`330H6069~cDyNRQRx`7n@E*c3bQsb}xU4p$`M3DPA@oUyYnj^@cMUoSir
z@>6-44Dw?5Ddxr_xXuV;qUs!^<IUBl-Q@@grWfw?nTzfiMe2GSYIDWPk~cY^A-Kws
zoL4U>#K?i?HaT;Ic{J(1PaOpihb|s=g#tLr>(PAm@sPl|E@Z^_)QtJ-;WiDs|GbdF
zzg<nq%=6*7FxI^1=8PJC`t%{mZk=#N9}^1!72$3Pc_lLV{;vZk7nW#08kwlvlQpbo
zG|D+Rnj`@m6BG)HG<nb5-+>R7qzonq1CQjeHYjdK3CkpZn=oK)`FPkMJLIuO!ee~Y
z5kmody;!bD^v^&w$uP9Z3I!L*C{2v=*Ci7xU`XYSZngk8PmA+j1}Vz~ZB6;&=nf%#
zD6c$pDe9IqDdK~sHI~9NL0(=5h7Q8S#ln2|w}Ku6waWm+KB=$s{}&!4j#wR6E$JC%
z=kail(}G0B6a}BdvN`Uj;5IP^EsV~c;`|*ktg`aMfSmC-(_q%|M*@uR7s*8}jlfrS
zWf(gceclf8ab3oORihGx;0w)|yuu^;ychFxM2imQqHfW<#|@lsE*?wW#c)xuAP3DB
zawyfXJInzW>tBNHr#_qS?;gX)b`S|4oA<Fd7UV$S=2K7$<(Z>1bQ9cP_?U?xF<=q$
zC^Fz-8zzAM{YwsjMgO=ESNoskTwOc!#7VB|AgLNl{6t4$fF!x2e@pkI(Y9a;?}&`L
zyniZYD&{u_x~|{;w!eFil>E*Jo3I~`{9IvuR{!~-opXQMzi-coTGM8OjyfX&{dsH(
zWN!1<$CIlfc_cJ+m-l<Y?<Ed22wihX7#V;7{n$hcN{HM>WR^VyO1>ja5l5cj<X>{F
zPF^ogb9@3P)rSOlM?pXhceOFjkO1ea`_g^zd(v^5#QTR=gW1x!-m$*^?t%Y^!9L(^
z*PnBn$KK#ErZGSoR`!1D{G8knI=skG%<(Ws)yWg_Gfkfe%>;g!2YE|=B3L`ru|1>l
z5K%37R?zJ4@pE2!W1#`K&zF!ejh0ir@fbPg=0bPe-9HiUpY!*a_|W4zJQeT;_jQ)e
z+wCU!1Kw_Vrq99ZeDuwK=gNEma0idKJkhbomiXB)KgD|L>G+AwB5yEmX!&Oi*v@m$
zUl}}n2|N+U!U@7c!Y8kNUb&@NjOj9Qd=q#EIDkaI<fDId;0A5!H~pcXDrP=zru+D=
z!|@hE6)s=``_eN`p@N_6f8n61fvSu5*)V(J`Hl~IG$2W*s{p3(S;Mo`3Hp{tH3aOV
zT;JYsXn(&G1y~Zjn%up2Ik+r*ATQ+3_?-a{M0B_FcX)+Mi18dxiG(k7CJN&%8kU9<
z#6mHV5B!9POCcf>@sQN~10G|0Rbh$h$Vh~_NF!{#A=1r7L@or{HiL#lXQM=&cRX8P
z{QnbzP%CI{u|u`?-b#&9y3v}YXsNA&kRbLht-Y#6TdUO;wSrhhX;o1>W@{udgGhe)
z{Jy{M<9Gi^ZXUUhbIv_?oqOJ|_v`5~ejonu>%Bj$7s3gZ1y2-~gFbXfIBR)nd~&-N
zmR%>+N+;>{Bgc;ypm@^KvY|t{UbVW!-*MVOO0e&t^L<_jC~5Hm1qocy?i?(|w}=;u
zhK)FM0c_Qx`_|W1dX%07M11}0Lno0qSmJ8ykYiOvukXFEMxYaEe{XQ=#Dz(^$H)g1
ze3H6V^fl5`JP&m@$0g!U{uGn#Y2OUph|yU<6xSFPq)hqRPm!RZV2r?dzE5QQsOqa!
zNO1rNcLA1NiOwZhI+(!Cbp4~FS#L>07hgg9IVsHZ`ujJg>S!~Z_j=M!sOasld+@J}
z9)2CstAjrZ`vDx3(Pw&8t(v1|!g|P4y%VCo1>r;KPhwx;(4gwefug&zEAgn5ErUQA
z;RQoOqqV&yl4Y<xm*p!hX^j@mxBQCZJm*k{reGW4Mf#JO7lKEIVs|K5T<sTwZJRm#
zYAm3l8gp3P8Tok(+QCEM-t0jFMfUvyeHMT_8;bsrFxQ-C75<z7r<V%!sS)E7XC~lL
zatqZ!mD3a7vlp<seBV2xDN<2AIzG43@9cPq*{P!+ADcV$%x`CA6KNQrqId<F>%atQ
zje*eF8CvcXNx6g<NsKJ=gej`m>xLSk_9Q@}OiC3DD^yfq03Xb3|9v6z9a+&V!(u2-
z$CQ)v7h?xb<)j;;Yo_R;`YF|I6`lO2jp=nXxS0a}&zrU^kYKXRCq7`uE)fEP5u<?E
zrE2l-fzK~l-~XAoT1t@gH+x4XW2h84#+C#~8R`x6MDZPbo$Mga0|xXg((ePV&zV9O
zZk|2rpQMf~GKm!AA?MVE8+2sSXc!^2E(3Jo6o2P*+)1&q8n@?B7h74*4JntnaMi8t
zF5N7h#NXm_F*347R*PUd>23K8g6(j}$?58L+6McVrdBfJgUy8B9Y+44woo)6erwMu
zIQGKMK}UN$Z&i@ufgk$FSU%hDFWfYuvTzRP!^PipYQG*!@p=O3FI&*KjL8_$8X(Dd
zuJxf}O7YKc`=@gtbL<x)0W77#S)FxE0KNK^(H4L*vL^FMZEIlE>7jF*_8Lax<U9$W
z)a1OkV3wpnFh;+Mz5v+9ppR0pg7G&l1<Y~}oUz~%T%dz=yIzd^=HBE6{%X1sBOXRi
zTjQm_{%F|)ZKZReB$^lK^2mZi{sX*Ug22X<?_T%2o$>au{vBjf0ap0e=}La{;ual~
zE&BNF$_1hmVCed5H%cH-;`f2vT_3!^!bl4rl41vKrlj)NoGezccVR?XGbSd_mOcYL
zc>g>`Iw|cl&3P^|36F!xO44HMN0Fqz(RndX(08=k{QlU|X;e%jIu!t1`1iU7>+9bd
z?b%=Y7LfIyUzZx(lh{!_J29a7_L^6XB&;`~+b62dqNCdt6!5|)VbLL@FdqblyG3`3
zloZb#GqnL=W0-VMNbe6|-u-iQeTl@S+)n~#eraU6?w=E)Y&wQx`3PR`;x)97y=-7i
zvO!Bxx%-%?@W{Dj>_eK|MGitJl5oL71h^Hm{}_J)H&sgc8eI6{fV5l-gt@ph@J<F9
z1(AUjL7vAsSh;bIGlIa{!~=$^P-w4<;C}x<G1;2Q4gkx}nGSVPG4$)*CS>r@tk)Gp
zK-&ymT5OC0*s?F^zLOz<O=6WclXA(YmRRmDhZg1F^>|E-k;;}X0USj<c|<o;pr$Yv
zWcg;}0lpMd*nP80u3k|6sNY3A%*E%f6jvjCkj2pf5>U9iwfAVDmC+PYNFlTN=eTe}
zdz1n%vQ=X5aiUw?Ekro=LkwV`%&mLH{_*q87q?#zWj*^a#LQvJxb9ESTvKw5>L)Io
z(pa`!^BVtBu`^KHoUD+;&7ARqQOi_c7e)ExQF=8kl=`fm+_+cRsSY@-g<(_2oEBe{
z$=0R94n!xjv%?5hW{G`)$6v7->mBO%5YP{H8QEx(?z;wmeLFF)ka+Q(YshRG6Scs)
z_oxXjeWE2k^;d-5A~pS?(ZKJ&B}_keeP_YCQ@fswD%oP#GTzkrRL0%#Z}@FUOr=5F
zi46UP$Y%)Gg$;Y+#MW%&X7UHa2?xLoRTQq?zd_EW6_I%_vz|Y($M@=1Wx@!!NRKj9
zHd9VL5#neq@SECl#|85}S>@@z_wIZ5wv+?*?E*H5#28xj(b{4@vnDS1@m78K!SN^M
z>aGQ+l+_OcIxBl7Mbqa8ORhy^bHNlp3m|pjGR)jw8Ka|g4%Wcd$9lF7FZvia2O&u-
zdjWaLU1=_c9m{~l$Xu?A!I>;kZX<^{ky+x2HAV6coy$9Mj=@e&MNN())t5-4GMCd_
zR*ObJe2^10c$5Vs!L@jCTH*YXN}%(LaNJX;exXX)Y-NJ|fLCx5o0yfbWH<@mOcai|
z3>)o%W1_T$BR^&dfp~XK@5@oF{J&C2Vdu<XAQgzzj;>Qr{N&&JT1s`yB-v~=uvRD5
z?7rCkqv7%<n`!$<_IorU6&4{;W8@&NND&H!KYmb5k-Uord>>pv*ZV*G#OiWu8&JUH
zFtyZ(*8V4vTt+<2yg5#eomTxWH7q(gj<a!IZaUYkIc=z|s=1*(qIoxIo^tHb*EE!x
z0Ni|z$}@s7c=ei4E*5JC<35N;T16G=E`@O-ikoA9W5ZlBw(oi@XXSCXc&VDDa&!y!
zcNxcLdMfS$q7o+0zvbjRe<$tIE4pcF=0z#7bbIRgJZt`#ET(WPeD=^J_i}}?my6;F
zC(S%ID~80Q==D&YQ!#06%W@>(hGhj+->vJt5S^&Ca-PE-t!elZPPtfM{JmZ4-Fi|=
z2cDFIS0ERT<MfyJPgj-(K>jmn(lXT@$te=})7c^|iM2mu!q>Ip{ON2kg4?dbA`N0=
zFqMIGw?r!XSKaC7W~-enak-!kp}j)YMy-RvQ$~tp+dChl6fBs&hz?m<A1n6vy7fcZ
zWs}(cJY4Jf^zFW9^S5mM4}fez^}2&ZB9I-aomCGheW1V{Un~@%Pzc#2hA9EQ5*JhY
zWE)ScIFpxjPQEBvH^WN%|8{;Kd9(VWKm>{Nu%zZ`*QzjiTm7z7-u)HwYe++FKl+X$
zOyH!na41%X=wo(1LtV7{q4))J*G*Q#>dVQcDTQ`8I{)A7Z!7O-McK{;J{-;`e-To=
z=bcP!&}5TRuPh?Ea(h0s4`3G`P8}R|?y+LZeyI;rok>jyl7&f@+@N<by{d?7tmodv
zofEe552Gf<ey+TCZqritPF}jAx@|%G3NBRUX*tUW)-Kd>?H3f~@kqZ&@Pb{(gMgeq
zmZfN2MOX|oeAB@>P%XO6MlWD|)<ENY45so9ISKI-d-uEPt-(kB9qjTJIlDp27ICEQ
zc_(S$%)T$!&0lZ8E|(!>Fg20D+qKH7xPARu#QW4Cz9RmUMKPjgWR?~ri2hS*(7!r4
z_M<P)a#+ivH>jUo1EN&vPZs?h<FVH+Z?zd!4nc>a4R*XNbDX=^qMxFPuX%cA6A@;K
zWV0^Sq#h+9FI@O6{b4An(4V0y;#t_Ynd5RUHwOF8e63A3agxE=j$3K{mNpgLu0eI8
zur&J({R%!>vzfH5v0NdguOF7{8s-@iDtVE67?<&2&4u;RsiSqAu1V2(7vnbM%Ybfj
z(g9UyCV}7r2RFF{rP36Ni?;;4-Ny~c&qXi?`CphmBHQhjf=`KSz1<7yeYe!=UziL>
zI?9VXnRgw{OJFac`o^W+rhssZC7+dy%_|WhN?&d4qVM1MX^467{=i$}j9cNEQ)%y>
z{XJf^Vih{9;-Tg2?5Ap<A?)u&AIrYN_arGRU}U&um;nx`>TVLu(xuctQq$plzD^>Q
zPW7B*z#I?gP4C|FgN#qS=#|^4Su)(2p1b|#Hq_qZJ+I@{4~@<n3Xy;m^ja&$Zjg(C
z+$PYeE2{4d^~U{W{}d88{`YLpZd0n~WYNTyuK*Wy!rH>eaCNuSVDFZm0Yg@+)vwv1
z=-0ct3FD)$O_mVle2=D@y*i$g>+|D!y~ey3A8uuRk3W=e<JNZMGXb?_HTq#gryjjp
z`8X@Q_iL~s-+;TDU(G(_mio1Ik#6CLsw(qd4Hxas877)LKIc!#<Sgk8%YR05XPy&E
zI&i37qzQu4N!-cqh~i@+)~%S3?)=)MoUojE_m4r1xhd%VMc1Jc74v%S2oggfFNeCk
z&$?}_LCwv%aIlt~wGi%;vFU=DGIvlAFjfg}dtN(mIHD1_)vkJYd_4gqVS2D3({(79
z-Pxtbw7C1>p0qCaEl(_Z>^yw;iUI3A&Sc!S+Na6?|A93LaAG2+sNjUgb_3K!L+pj}
zIu_Nl&5R-MT>PBEasHjFH;c7-{yKkvq4*VElbt(?LwQDb{frrAvm7-gSFmau<I{Ad
zYtp3B?)Txts+aHZtZ^NC>EDx_ZI+FZZt~N2f+(5$vw}a1lHfME4~3bEY(gdz>*O#N
z+xMS7gRT4vbFhtZ{8!dL4%HM8J8fy5)3p*;ox^`mZavt~Gmwn@q4dq9eHl{3JPRYp
zkE?ZF_8fO20laHBi5aM{lDC^NQOx_=jrEE>V=qNZI6quwTb=MmyXa+QivWfvoMwU+
zX`{ONUz<Grt-SbZ<Zh6)gvF~M_ju5}9P8$nbMOB)US0~>jnF@-;9iKDr{5){=BLHM
zRz|4zfB;&sh)b&p!aX#KFU(I~>-I}F)e-SbLQUEz>yVD@AgiXr9hmjb&(z<{VK7MM
zIK75L*=9-gw_-%722`nzyNk|gGKRl`MO0!&Yja)w`Hef@sn7)Xxe<bYfCK@G^dy1U
zesY|R2ZiiX9;I}(i6zcU5Fwh0b-pTY4)dUhgd+}gS%RWWV<GruuY5Ent<v^w?1LZk
zCGC(Q>m1>|KroBojt#j{s*0#ATfUmEk(|ne8k1`;pd;kc8ILMbPllYgK^(wRfV&{k
z;B$nhr^1skl|zUxoC3-)b)7!teFg#!bApJP8Fm>o$OBDsb{_24vDC{S;KaFmC@o4U
zq0{2yt)coe%_q7zHK-q*`RoN+#pNUb-t=C%8@JVUMgV_1IijwvW*@sKp0)|&w2PF!
zm$E1<(n&o2^T&X?bau&!6)f1SbMlx9q^^>ya;sO=Gr9(xoZ|AF`B?Q_(F0@Y5)1N>
zX0^uA^*suwWT-)Q466#4=n53&`6&vQun73{(efyaiX0PrC3mvc<NHy<-NkQN_d1yQ
zzKdrjxUNC{Z{QZ8;%W46XR7++F{7OZX9v;T`YS@s7+t0ggFZk)hAw6S+vf+Pvfe!?
ze6J_>gh8)CtY53yPhnAN(&ucMT=b(D+C$_X6KI@??01icA~`5rCoTIe=c}UYx}X@#
z=cGaIS~^v09~1IN<m&I&|EL<M=uNtnwovpQaExWxu5^Nft@r4)zK#?=u`WeddS&Jd
zgTB6U)8h=PDfD{b=cUG9YX;j0alMJoNVw0OT1Hw0M{VI}BKrqSTPMaHlaO1-QkH<Z
zmK!f-g~>P*J~{62WQ22SKYcL7C4mkdsf8!CHi$&RG-3>Z`<~gVY9otW^0!S%w3kG!
z-F9i}K8iWaDH}<?bL+*^ChBLqUo(FHxm>2#@6+f;uddyp{Y<|1wkhLSbZ8##m#clp
z&hmX<(4BB6qbf-s-3CQu>-CRXof<NUi^lQ>Y7K@)3Y!}10VN}Z(Qk|@PaF-IXYqWI
zp5zWD(D!e@ygrpOa7zE9zX?gI%bt%ycL36cvf6?<3=zD~VX(qN_N$*Ug4mc&6+%Wr
zKalq%pdWDgUucts7wayc=g+DUjGL2~`Y?M791k#PzoSY+r@a08PGji{1(1D2^D|N8
z2xH~0(7JuPHlX0FK0>j#dQ|9_Ev5Jr5`XLgcCEf*bQ}(YU9LzUvrJqRD`_$~K^Sai
zMb{23McM0K`8|fo_eASIM?YNn#ZWNaEQ~hNXE;)n{`kI8UmT*?%SxaZ1e46rZoPf<
zhS{q~R-2oR`pZMzH@`YYN&5*XUKAC-xWUGOVKnZLnMDSOR?NkVsU9%llkE1-C=wYg
z?m;)pUr9c|k*@y&W&CnIDgq^YoEhurneFcxU|nA1act1>=D1SB<H+^xR0T<Q*L{D>
z5w}*C*6g9Hz0RUs=277}@|fA^QUe$U<*<gVpy+!q15>{Y0R0X}U;&W@YbOfnbf;F#
z|B$%-uvX@yMZYyu$LWN5jexiKL{gtaBJub9W75T?3#Ep>9Z{j7X!zB)bEG`UKCYJA
zNrgp50$$jE(!@`li7Bg^50<SyaP2YDZ<sMnLP)aZixNlC`SaJYN=eiyQX-wmnWQXU
zmBh0XsjzS%v_qjwgb1n~SQMg4Gd16EnLG_|3yrbrCv<Zy{F44r@Wc-yC=KdK#wQxg
zuKK|f4bpc4<~pC5Ttj_u$hm&&AX%qF7c9cs0_&5O)hY9#6L`?q+K1&ZOc?}@Jn*QB
zZNKaRg)dO_-T$2Se|KUKq6?aORrTc${{muxd8fMuF-D}~aDR%2={RzuPTUoaFxr#e
zYSiY6n$%JAF;NnyW?W+(w=<PMuirFwh9j*`d$_awd8vB52rjK@ek@?!w%qh`gQ*`b
ze*TY_0tMK5HNT~g@u(sq{?DOjD!%><E1xGqj;`#a_f(8hD5<<IG)Uso`X^MpK%Tu9
zn@*4U&9Ozg)^c@ToFE;w#W~%A`o?Gt>+wxFV{Cb*wPGzD%Lf+jVnkIuezBl}PmF%_
z)t`Cdae?MRl*SV?s*1&9{Adn&51!GLGCa@9ygk&Q{o71WH2(KOUS2cLFXpU6rcS8%
zzTXB*qhJ;(uQ{tGO7Phz^VIbz4P;QvP|#-YzT8%2^o45H>+%&KB?Oc1vBA|OuCDen
z;l#kPS17joa_UJ7NRo+$a%CoDu~I|<9lob`+lk&zMVE#DHI%m-7_`9{O6~dvF42ZT
zHcvW}QerL)1Z@bsX~_U7`xae+yyx%i_h&A(B`ACpI_a@@c|xzO)cIF`lL`SfSgx%B
zx0<SOjISEYg&nP!kIY}UYC0dc)JXEE$a9wL9%p7J<67@~Z2lw)dMllkAtz;NPdv@8
z29<ybHJpJL_kfJ5g_-)wuq|x4!ahu?mX>*ZG5zN3#DG5-F=I9>H@K7(ZgP+u_25n>
zU!8obHn2o+bL`QmgI**up=Glt>jpKqOzFpzbv<OzO>#HrhCpzsWZH)GVlKwlmf}Yw
z|A+~uBc%npNo#4hG3${A^v>ba3YFSE%ebuI5K16W7yS!y`lColixjy?>$w$&-I&xH
z+t_rghqmWJKNx2{J~wF8lG_v6^Vf`Qrq2IkQVJAyEp$kBb`aPp-<?f2t0usy`QY3o
z4c;EI++dEVfRpqfq<HyCDA6HQWIx7nWtbN#3<PmwT}7Vw9amkO=v2@*4e5?@<g-|Q
z$#T-hPgrFa*bXsOSN@fv0GR}Tw|*L@rK04+A_VcaHp)jFm>NdEq}BXuIOQLqN?uhI
zA$;WSf~_jx1S9Jp!n>0G^_RRAP#^F`0PvXk-mhci>3F`V*p8!nR~JkVnIX>m@}(Cl
z8AS^cQ-l5s5}PSKM{9KU1+8D&DgW*B{6ol<=&LfJt5=<OKb*utr~O6llb`RO?y645
z55*US#NIZtPJb0R1rxIw*e+(#Nh*+jFxeCrIKMZ8Rd|Zr*-E>l$Ao9hpT|h-wvw)#
ze09t}H%B(OFEf|_=eEzk+0v{i-5T7g`+b3w$~U(^T#@a*Y0{+>*bH4?F_8jQ-C!)e
z4X=pM7G$=cxc-zG9=~9H#`Et>F>hIO-HkNR#!cssv(B<-_qamN{>0aq%sDpjAvk4k
zUo<Mpf6HZ<<EbC`9nU26{GNRE4VgFKl24Lt%$Lf$XL_z@JmHM_!qmM_7*e`@_04#z
z+R(%ZGyNs~YGD^6afUQg3Zs2QCCwElD75ni`vH=!PO@%(huCv^!RdW;^aKYqUgK^5
z8fpZAX5WE1$=u&TYW)4K|73N(XQ{mIPs@zZ&El<-ZF0ZJ?_24FB%Opc>Ru`8r9gUr
zO_@{kKN~AkwWc?%j<+UcF1)~h3CCBCY7{L30K!#9g)UDV3fpu>6j4=1@Vvk6WwB+A
z-A>>q30Hz`)wFMPN=ei5UNe(dMpzzd76|e^4AMIPdG((-0tqpiVGDY8jU}SaXfYw6
z{M8?KKJjD37lr37i;$IcYXak)I`I#<<3|364>M(n4(^=uBAc4G3;KFm@w8C_z(JyS
zu&AMINi$VvK|78;@bUK?r6J|~Sh`Hx+-sf*VJ(kA2<rfDI)>$j-)+AYk~WH~r*yUP
z8L9bN(nW*(VSdVdW-U2)-31eSgM5i?kOzEhO#4c`!Ny|7{zm!H!fV~o(K!hycK3k@
zADnAR*Eh7^ill{8UT^Iy#)Un+(M54MN?9Xj-|Z!0%!g7mX|N!N7ly$xh{nXRs}Cm2
z9_$QG1?aZV@DBBCTPjFvyT|b+{|ScZ3AtEmz%qJ{rBB5J5dOjIrYhgcZXkXdC$Fw+
zYg^HYMUB;ibZ(0Wx8-d4Bn_oq4?L=}GE>*gUQmCe`0p}r^2gVUNoDFmXdy;B0G&dC
z@wUgxasnrPiTQ9dlEzt$XyasFI?Y__@jiaTTEc()1?*pVIsl+^L3t^h4-b|h#McP!
zPH-4pA`FW<GY^?>;J3uy*6uEgzV9RMg4474m|puE3JtNn7LVIe6nHow<76XTusa~C
zqa0dg5lC}NmA4$fH!@_Bt|WA<o>&Ly*4rHv)BQ+c4v-s5xEwvB%L`+7tc$YX`Ps2-
z*woNl-Zs~?7x>fnNW*ll#OVS0v~2cOe#<i-@w}LM8d#-W<K%0UmG)Pg-KCi}oK{$g
zS84LcgnN8KCYHy3q81C%A}A4xgKjL4h?r9+&-2@KxBii(_K(3_WzA|Jg232iUfm`)
zeD=LpS}j$M$0f}+GClS=Q@sI1RE!fwL4bUdlg6uQD|*o;Hm~VJc|c#5pr!$VUe3#X
z*dUJnwYn^yP^WtC*<QiYzT?XaEuY>P|63nS@ZCK2-?FB0g;@~*|9@cGTj~_4#*ljc
z!&erDr$D>J{aqr0!*0`R(cf0G$p~PO`R*oKe4|UDR*fylUscw?#V|@-fla*mkOQ^)
z@4>Ol%Csf@f+Z3yIUFxG+hCV=$xl%E<<lOfES{#6MUMe<ss_+S(OT>o{X1dF??ePE
zzH0FS<b{soOY0g$7VcdxAx-PO_*ON4d_J{9?jm`B1t4UmA&}PKI<ZO9NhuU2NH&tJ
zLx-Oybhg}dzoOA%)F;z3d1?2Hx(`v~#S>w&)ofmo0rR*o<{KXy%1Xvb0TtqLLoywN
z>h=b?|2ipui%chhk4A^@H{OtBx6i6(4TXfIU96^Q;02z5CDw8i4+_|ypXE|^lo&2P
zD3P`huFB_(P+ukGrPDdv97I)g)U$%+Jw7j!KBUX~yY2IPt0vtJx=!T<!bl6lR^KZl
z^+L!@JAtY~^2;&;gd8u)U?jM-KY2ZGDK>o~X|3uS>%)swTbh_D{NFCt6X({WU~CQj
z6yPAy*Doarl(}DB>x;omhLwf+p$~ePhO=J!-hVYT(j#*loU4uplfaEXs!=kB`@V}z
zp}X`mU5WKL)gma_6f6?WKGqBV?UKB&Wa#}?uzxqmU%2WrPFHM+`Hg7w;SZv6*U^xy
z7ujk|c*pCu9NDS8&HdRlJki>9Rz8NT!3slPVq#PpnAZoiUxvKKr^^+Y9vWacA3u?>
zUtNP7iBglocVdNDU^(ETJj{#4;$aHQX!2l}G@c^$o971L+kx|BCuR6o0#<I)Hg&B*
zM4#mxTAEWv3ByWE9KB`?EpS^x8(CQ~bGHy{0|WD+09J*RzPDv}2Sx`kjhTa8F2V=9
z7~_CzPv`6`UFvF00dg?jMTYj<yHFv2&}BV?*FR50wf}LDO+mT800G(VOrK>=%mU3e
z*l3>b<Q93l6g_8jvzN^+Tv&W`{U$}6+28Un6wky|=}7U_{^60x34YVGfFtFCT9W)N
z^AZQm#rhufW}I>@=JH0dopy`R35x|^Y9xf*S9DR&L^OSh;SEHX4%Kqf<)J8V$xH7P
zJFTKGeB`N0LFKmq>sMSCL{C5OBkPx(MAe{D{af6EWy_dfU5<<e9xEdUBlou2Jk1fD
z5le18LsEHncjL)z2ocRoEQ_p>h=bklY711`nk&?QL~@=*^hAL0fr-;{cS@ZvXSwk}
zn*f`JJ<T6T@0*il57?;hPeXs-6UAiB3;v8HVK?|~`sI}?$K?Xn2vTIGH%pg5sryVM
zlt}ij%yK~u$m(y*?Kafu1haD@ID`p**_^)GpiZG%jwc#-`!N-=tZkfB-DyK~RwyNl
z@eh_7Kv*Qr8+vZm{+Prq_3qx-?O_!|Pr?A68nxio43Z81MyT^|z=wie)grpjkZ7q^
z?7Zo+f<idFIkb1v;_pazI4faf`nt_!JS1r~b9^z;NiJfO`o3GJ$UTEOaD0?Q3REHE
z$63>|#O|>;SOiP6+Fb5DFGuX+CNTxOvn4Hm;sMr?QJXH(C#R6!o7A|9yEZ_?0Ef4X
zZ>Pg-ycuIXvuiZM2nt#uj!P$U94Uq#AnmS{3$;mfhwm@hCqM0dSO0@~N%Jw{!GMIM
z;oQtVZ*D>+Fg<*E!vzriEC9%^zEqb(`nQ?L{)Gx$F#+4G5`>cSI15&0KCgZHea=5&
zf_QO-)?%EJJgC`{Ptc*}75R_&CK|Su@H!|q7cJ*fM08imtXv?sJ>qt_+Vp1HDs56D
zI>K;@#_A1DjRw=d9^fqPM*UR=!Ons_mCi}PmOnDGT<7F@MejVBKH6rayoL)qMVr7y
zlb1>4`tM4zsafO?%<1Qv#dx8ZFbEwtLBvG#3Y^_Mk+XDYQA<oz%s|@kEBx}>c!zj9
zg6rADX3S>zd?z8MLoSGc@Gt+2a)gjBm%F#{JL%K?rALg)Fz?Sh<4w%fd;|yRP7N&;
z<w`}<VbcsP>AO>aTdr-`YVf$RUPYnM>a~F1*Vr^~uBUrGH@H6TIXkBl%>NdlGQ2qE
zM}OYnZ0g^6=K{1|SSj>Z8+pl)fM)}X(RT~j2qq@4B)KMJ)`hupVV=QF7Ik=`UFSK^
z?C(9r-NrKH(c%Izu%8CIlX4uqB=1QFHQ>AgG!U&rpN_7+KJR<%2FYpB(yEH=;q`0~
zy*i?>*P2}qH`eKyoehs_33DdS+ol&s0+(HZ6z)br0P}D+i>ACYe@-h~xn0qo*bau_
z<GdI?1C{YqL6S}{YQgWLrKb60)xk)5A^iXd*>=9+3P@Lwdx%TiN6aprvv=2|p$7-H
zxr6{7%CeT}I*8HR)}X$XE;8x9O4L~p(Cgh5c)p*L2eb+PakT6f=~s`v;kse__vR12
z5d%2k+qNU2c&nv~0q77scTi83UbNcJM(!c^Y;6Y}yNj~LKlArJ5U6^>eERgCs{9uY
z#s^n$uU!FSj6LDm$ppyun|0aZV+lNl`MOUmbr*Bi`%alAA*i$47$m||h<O<qgvQkl
z-=^Ugs#ip7>umD={9vMPj*?0-R_d8htB!N31}`=7j4CD!o4P;WSjR?=1?lA$zDR^|
zlXDm1Z9iP&YsQ$(M%EAYySxu(`n#2I{3zXK(QJf+;3W?05Zl)Ce|ZzgE-tk6`t^HG
zZr2R3B?Xp&<|cGI!g~19ovzhmwUYR9aTmWfo{fiH0n`~t=vHV6n}_gmcuuniQvvhO
zp-RA`o6qk!?HPmCiGqawkvZ~JTlHIZZik06`{UGu&3^={>eE!<TYlW086)=y^1MIm
zy|Kg0hx^8V05XRK&Wm9ZyF!0A6VyRm0kbsK)Rl@^>1FiEdN;Q#xXmoFO_Xaw2D&zC
z2!;HVw~52Xs>4gFF7?O35^gQlNdy1UtUD!_O~x^iCfJJ`mAb$3IYkZ7N1`rwQUnC)
z#5r>Vqxjd_=V5fx<A)?3%aK2&$Itp6chn!iODql>yZPq1_X5B8=VIL}9O7#|3B?$%
zMa?G0NyQ!u(iWHQx3X@8@re1P-(uFzkJOi2fTPdh2A%W{QmX#1$+{_-&-WhtCnREn
zmcX6T;?34+g=k$_8f^$rcTrKApuLwE(FjqA{k7}Fbeh=;bXEwWM$9ogn1cDS%~vBf
ze}*96kBqFNoKw@j2Wn{c1?mX<%j{qO(ZbRH_x^wc+k{c`E>y%Y950z2G5Rx{1RaS-
z=e>9K&(5`9^95YW;>*iGiyte!r6wulW<z#e>2q&p3^5m}vkolQL|HM-U6;gLVo!=L
zjPPj|iEG7tdaUjGefNX5VbN9RO=`Wx1cg}>H`CMR{#W9+V&YRzKA(N=lH2};$dR7F
z>s%b+xUWXNDo$Ybw(0D`AwnMvd=<yGR2`iw@60BfsJ?8jd*{`g!+W+g=Ou42%`3*9
zR3dDQ8WwtawI*+`Gm!xSyo~UO-2EJdSvbA1DL=0No(fcG^Mi-J9~~-O4yUfQZk?WV
zPAm-@7M=fF`PTLC72~Hxjhji`D%pMPtU;_{;_9IV5?Ii~Gnej$OY<~am{jJGM-F%#
z!?n(>AZN>Le#qxV>dP5fc9zxQmv_7P+V1VrI&>@-i?r>qUlqf;9V`Cspx`;(wG?dY
z{L~PUz$tL><C!q7261i|jw0h2-JUtRI%)0L+d+!RwT{BIp`DA;%!pyuM~5Z>aLKUd
zuc?+^hRP2exY`(0R#p<;7OeCg>joRcYdAlZzTjl#k$z~eLpH2o&c{#8!Jo<h8lvjX
zear%5T|dBUS9p`>o5j9HoH+^Mh;s(+zAX*vD+4nYMaBs$Gnr~$q$F{rwz<?6+{Sw&
z!Pyq9lXzV7KetyO&JR}nq}cVU@sP7WxFxR56rdA(n!(KJq&V6Dkmfo&((yE>itHZK
zt0nerak%J0z(DDns~m1CTC||<Yt7x|wb9-X%+rrjnf?mX%Iq{w2l*Z*Ag4EFM*>SB
zMi&ixzmG;tcQ}}GBdL-Hg$1VW9!_}n@o?PZw|Sa!St=I?Q$v&(mJqO~5x$>}?w>AM
zaejp^9*%6DIor|@jB{(a?TLE|gq!zkpHO-4ezCHfiR00FNwvB3Z1hGh^Y<L>%}WA;
zg>Rluo~PwBDuyUA-RACGA<_UQ4bz2mpL%b(;)MK{yJ@~mn!fpJ9)u~M-ywrB()h}Z
zL@=DRJ^uOoUgM3|l_m(W-EQ4nCTVeN3vyJ!N_L-YX;LgtUKc)FG2*8ObTGB}P-&@R
ztu16V%CV`=%3B}Yi)+ffjdm)9e6llCQA~Axhm+INU6KzkZ5UQM3wYVbphHIp&Wklc
z8~&vle*<T8`nQX_<M*ESjd5pltn^+I7m;j>Dx!|CoiGa-7p&J4XNrvcz92;X6ps3a
z-Htsx4zOKRX)kx$7(S6bUEIT(yZA1%^tQqCF{7~hkw}Ta8E;Vg@m?2u&Vcj312Cg4
zS(N|#-k!6(zIV_wBX)gl*hHBI8_PcB#^5>oE8Z%d*yLZ88Y&f6!r=M*8Pf1e#i7g6
zS_`-!_rU0>%mdxHmkv`?7g-b85K8*u5|G_~#3Ap=q$<rg_f4Gyjn;XERDg3uDdfF$
z!Ap*mu-x*nzLp9UA4Tg{r=&9bgf1I@jM=qka>Z|INNa^2w^}Rnb-yA$80wOOEVU!+
ztQ$}sJZqKn2=n|Qqx^t#aHuZ)Y-O&-0{-1zOH0>J-K^&(V*o_g21@q|A>GrXYY>sV
zl4bV&_yl|AOoJMx#UwWf@#Tg)MkKqBuC9DcX5u(f_g4+MFglpMnDBmq=HIe!eM}7W
z-#`hG&tu!^ICp1~cjQ{zlx7p8i`uRa8(KBz4|cLffY|xNLg2<F_<X*>;L^kxzWSE)
zBZXeM=LM{MABsFz$X-Ws$w}aJ<9*2Y>F!3^O?RTtowQ@4+NHr_^3JgHiD0*TCLib;
ze_Fn4k`}`o1Jx`<TQ<2k3Hh-n5bm(TQVO$bKwD-;58q8gp2sbnm$#EU$#+cUVc6LL
z0dkx0*KDqfnDYE!?OT?-r&zQLl%|Eu{i=TsV{!aqjGi${t-UE;%|^k+=dk6UYS=#c
zLTLM>+5$K*a4^#{xeUe`Hp~&cvih!^@43ftJZnNd@A+HeY9HY;ILxoaIIz=uMDxaA
zFP7%4k^v!4d0a9j@@0Uz^rfS$%%!_LxZ+gvM2({}Ao`<ZYae~%5yNoG>rY&)VKI1;
zx9FqRdy*h+)=GKZ+>R}lN>)zVv`K8PWXNFjP-XUneG~SW@AXKYX1bWr&p*6{xx5^b
z2^opZQEN$HQ=Iq*#^t~Fac!!S*rdG@Cg5UZfD`MJD{{N^q1WD-^wR>9ui*PHPcGjv
zIQF{q1lk>x__27@wa5t3>?#w*Y?J&=G9RaimrC85BE$N4Ot4&QNsGW2CwHkt+=Br2
zm)<e8_REBCTVvwf-$WhNITeH}RUkYP-rU_tD(iD&s=PM%%9(#E{d;BU5?}&;BkgQ7
zn%67f&bn?wD~CYo(U6b^!a0E4!F&}zW<0bs04A#`3zi$02iWolLRXV#%XTNp4F}m8
zlIJ~F`iy`SJ6ATQu|c#19g<2C-}Vl36AvYQ=WJchRWXNkVV}UnCe^_rBjV>oHMDRp
zvIRGvt4&>KL(Q%aO!}?il-`d1YU3(BpXVeOp4g4ZY95JZ)QPbNu`7#<q4mC(@LfRD
z(~v11;m&9h^8*Wb+y!?YRF*l*kb|OAeCRQ3FP;|b{pTQ*M}y=tk1qMb4E;}7>GT!!
z@O511i{LvNh7o_n?vSJ}3o9B0a1f=6=ziqY;*^xmz9D6kbW(-j%UTG3C^?7mHh<4N
zER{{Wf0SHA?`WdCT8*%Y(YBm*F+Q%q-|ximL<|`Et)|2XxI0IO%_=7;RV85`%5lo6
zD{}OB>D$Rb;*>oK!XH!rBb~xiu!!gUGSPy{ljoQC$|%eOo<DB`&OKT)bS^<Ap?rr?
z?VgJZ-Ra8)PBE^UW3R3dAB;J3WgK?;-N8R3KEUzfTXPiBKU2?~8wzM&6QSKtgolv(
zM`6FTOZ?5=4|PL+jrL#fcq+%o06Px|{blG`mEpU{tTpo!`R}84_ObWKlukLbN*pf%
z2>Bly546tlr*gm$*+=x!GjSq6nSxxMb6+L4@Tzn9xw8%Cp%(h!MZicWL(fd+yBloB
z8h<5-On4G%e}xYjqSO&%0K1J*8|;7cTh*FNtD<<5TQq_0Ueh`$N%yU?b!XzccW*oK
zZxy9Re0TkSac_0CtekX*vQ<-BX=4czgOUm34_%JMt2o|z90#X}eTg%3P^^Pk7(sIR
z+Iv1H1}kM0!9(2Id<;8WSi2ime$*SBoaiG8t@8uwA0V7`Fmi1uCquy!u^$G&R$!|&
zuD{|R{X?ShEcZr8^v2l;;rO9qJ@d%;-<jQclZHogFRC1DEZ&DY{LzwK#@+its(P#J
zB=(eJbtz0RYu6Ih1<6-QBkq!})ebqpn2Wd?`@7@%OfPUI8rvl`+w=qkD(1&-@oTlI
zCZKm+`>HYb*9d~){%|~<pcmOtlK&GEsRA#>L>@<)lZ{aPP+EfBXM-pU4yt9C8JeGD
z{1)q(&aKnh3}kMGaiEu*=b_B@``^X2!4NvYXO~G0@jD5-w$7JBl5XyE<3672^#kcP
zT7-<e5?AOBrdNz{D;88Gt7HY`ye>c8-|t-Bc<~9#RN5t;IM;}AFK3fG4%U=*XAI*X
z1LVTA#WFDn2mO-zB_fNvNz!0%paLJmbz)(5+PUcFOQd1Nlq}LCIN~RVSfWX@EmhJ_
zVY3i5vt<M(8-`3Qw{h7EJ_GRXcMe3F^li8pl9=v21l3Tp)B8{WqT*#E(8VmYojVAq
zso6flYj`2bahtK_?G0aRa5a;NFwvEF&=D~)n7uUnk$)cC{5@DggkNftVVGXLC`KWb
z{oW1wRg6~ZO?jAr=KC1tBt@a#(*~dER4_%TL5NG&M$Lte_b_b|GLkb?C8{=tf__e9
z{zXVYlwEW0{3&oeFrQI9MBueqGqesU^KEF+tUqFg_X^UWB~UiHacIWJTPBLPfeK&s
z2!!WQ@~jl-I*_VIdd$Jf87N40W)nl-vgdIr;$$MF-!j7fGFOd$UQ0xXJp$@E4e0No
z(gzl*O;rsIk^<iHl2ResKon5jPxQ23L=S4dV{{fcE(a+uJJzNb=2U<`v(~+$S(~$&
zC(43(;3CK#WZA|W_>FVEIn_mVaf3P0TVX-;bq~W)YUSmG<ilyM{tN@`%uJY_)^;GG
z<YgL$no&3-DnIen@SJjU8tjo^k$2(Jj+LsLp>-8SUhHete6!)@Qq8pGAX`gk1Bc9%
zl+PSjmr0SA<0LLk8zfBoCB|3<pVDa7%dk$Rtlz07?E%Q<Qf}U!)SH;^+M=2To!pSc
z+>w#x5q)uwiC^G^_cn{gRDU6kPogTFlu+tXFA3u8gUZm4V*1pS)#h<3>0Q_l2R+q;
zzM^~QwNP!=DRFR{@%4-<Xoy#!1-WxKFn0_(*t`8rbU7$rQ*z!o@A{DY8i-*TwnGE*
z1ThoCQojM{EL?mvhVG~`fg(3Fza^~^G3vXfT}Us$WKi|`j=CbnTIckY#NQUw=9(#k
zflEok@}hlFQTWIuR=$AJXOQE*Ukio6Pl+71q?Up@_s-qISw^N}?s?F<KuK0}A~n8t
z2rj|*yGYe)wL|E}i@K;A`HO>=GFKI-lQVuA3_|qpAJG}!-by>5H;9e6A=zjdK@N?%
zH6CPG@r@CI+Z%l633B_X(odaD{N!>YLN<-m(R_VyNT$T{YIM2nOLgD%l~LKOu;zi3
zw3T=lpe7|#VJ({-KzS^K8U_x{mPh9)3M?iM_b_+Qciis-;t|dnbo}T+b4@ltoqg9Q
zPl$us<_Rr35{eVO_s%~arz(65n?~k;ur7+?paqUM5)Y)LE19q7oN%4wC#EFqfC$3~
zVW)7$NSk`>)s1r;l_eLRhxdK9#$G+ZOvA5sy>U?vEEFS$(PmS2ZA=q7dC%;o;M18L
zd*S&knt;g{9gauTCGH@ZoCa$bTEIBgD(vFakFHmT!r$Q?iE)`$e<hxHJr4O2VnFoQ
zajJ?wH(e?rnlj}5{Cg1Ka+Pn@NrzG)5hA2L9;2*eQ*$@XFeEeMp0v2$2MPQ3^ADny
zm)R8cr`ZHGjx<iz-)Y4%KgMZ)Q)mfca!pwo6H(*jUMs)WCN{CeZvLZcij!i#fon-z
zeN_;k`_uR;+0?0BK^^YCG6L;JxEmt0=Q7d$C2+)Z5WH}$6?df$;OcwogmAisj5}_A
zB51Q-&+)7y>KeO4owM@#dX0N6zYJ1CO}3jJGJ4C~Ib~(pG#vV}N~udyEPZwS1q@AY
zXH32awT){fCfLSY7Ap(RU)=akD!ukxkT>i6?%r(C9WSnsmF;T0f;2qp=+&NQ@nn$r
zBiEC*B@IvqePHJv@_5r-Glewo0EbLn5)5*>6RQ>8i5+Ei|KXseFLAJ8Tk<i!=kbpd
z+((zGSxlP$({g>EX+s6ct(m%usC4ZbClhaomeiv-X)XyEOc*PM$SSY!g<yB@3kWrn
z3+M#-tHFYMPHt4&la9#lA}K`xYdK&mL_t;MTwg*1AH}Eo=4gR;gWKRk_}d%^x1WWi
z!DTu=5Jzm?4k^9<p%c$aV<t`4pDh~wf|CL((5m2nY5jm*ncZH~y8gK-*Wh5}WVp2W
zdzfUl$LA3Z8#)E)pmn8g;pvLkkTv3%@2(xg0M8`by@vv1_rp8>-9i(C(dm|M9y>y`
zmu2C#N=x#G54)I{0|hW0KmKh-I)0>o&(w%@&>dhK^1`Zk=EdDzcgq`oLsy`@>_GXo
zrq|s?%|!u1Qd!scR*<$SJBfN1oBWzx1I9Qs4G}rkO%q)$kA64wt1Za1S!O^caN;Vv
z@Tp>l1NL$+YR2YRr@W3@w_~?7Cw^qa-K1Ic++xvYRmbNOJesg{yLDlUq_{e5l}MKG
zJyywmv(j`81cBEQ&n4dHO<v&av`t@<&+PJ2<)Hr=f6`5}2pSpzORh{?qd*86Xz*?4
zf5CEV$Q|^fXZ3o=I(KsKTF7y|;bD<AG$@(Qd!$HLXr{W*jVLUyTH2-Z&p$mgApY|y
zX$5?a_X?wa*%r8H)oMFE{>FO9_ZGwJ^O0|4)!=!e;kn*d_2gJEbqdcqDuf843v>59
zLbR_~#PGy&AwA<tEVSHI8R*J+e-@cs<8Em+PyTf%aI2Ce`u5Gw%RIKArtviY-#@<R
z4hQ8)rD6xQ>{soyrnp@4xp7yM_?{OQ<y#nePd23&AM1q7etl<Q_d=%Z<~2U+>M@SU
z3)f}rrEC+f*xboMM(>D4mOcHxY-;S&<{Kb#9^q`&_%h7ZRsc?79X)RjpEX-=eM;z)
zdvtSoRN`e^hfQ2qP~Vh=_BZF^v)?sE{B50$9<}+wze}{%+TJ_rfYv*xlW7gke&=d4
zD`Jb^{SCW(dR*fytuA=Zs*8#K@;Rq6*xg>Zn82t;XA`YcpS(7&7g)&E9(kG@bg{0k
zNj#2$r%VtP=VHG8*wzo|$s=|xsbnhQ{>I8=+}?|GM*IO^Vj0!n=P}qANPo!;9T^Nh
zT|eJ5Il4vB%4p1+0Fi4+XZc&gTF<o2b+jFip_gUPzQjd6SUG%fIC>gKo8+6x1ZFDy
zi>pIkO_4p|{X59<g>?fx6Tti4tJ1*neboohSJ?;tV(RMAZ#5=RW5b<y@(FRlgcq#;
z(nprP%#7TlTec4*RP^=q6F$E1wP?`#3}!Q=z9E>H^}_N88<Hi!^J)>xB^tFU`F8{E
z-n<f%d_&{s7|^TS%1+Bn`3w3jN@O3){rqB5tKI~?W>JQ0%&?b9L865Sk7_00&P8#M
zpff1`lJUq>Io!*%<>4Maf*EP4Ak7ToU@EKx{<rAS;g;~SA4=Dz&etoJ5O4dARPy!)
zq6ONf_<r?;J$}AUC9dsqY_eLZpFyo%e%a?w!iV!hAHKa~sW;Pq>iuNZ(e^zZ&%u%Q
zQ~<A8JFM%uMybiB5>F8TAm3qBh`LXBeKT3fRHm1&g6CoC|6k2W$AzZ#VDzSnaR{5F
z-!Lqx_#thD`1K2IwUoQYS}$E}hm>l|-DdqkmsR{|>jbNh(ECfKC>$aUN@<eJO`SGs
zH*aWYD8e|V`T8Uk)G<vy#ZsN3b0{IBI7Kn<T7Bk%ywdN-<P+M~$7Eyjqq(^`tYT<@
zUERWxWy_9Z#;>!vqfnCU&cmIZqhO6tY)6z42VH`c^jlCy4Fw^+$sNP7O{SM9?hb#W
zvrcsSuinnoR@yR$eaqlGhB8QPO$waHhej-PInJHZn0fTA<PcgV_|W3jwfQl=jP;%j
zlO_6X1cw&cwCnq#x8wh9`SAgvQZBS9G~klR_UJi$>imuzZ8x9~I#WyKcaCVK<81X8
zudH-LfU3IX{=vXd@1);IgGA!FV$ARVDS>p;kd^Wzh!*QWu+w)^y9=T2N4`7%Eu@6e
z^~H)@@msK1LLC_Tr?Q>8x6D&I+IBj+{#(rYc_`@JyDD05oc0}J<s&`!b|1QAxB03V
z8j?vFv|jx!LF+40-2XNeL5alao?tIOG?GT{a|PWM!l4Ygak`ZMIRd1#*kVlU#oNbZ
zeCcS7S?MTdIP$-qrv06`N2-Su#p*=AbJTC_K<e+|&#!MLZTaH;m7(@z%KvUwiuKcH
zHhotf3cP2gyRbjF@YAn@`v$$jU*84fm*Td4tUgk|@n8f&V$*_q3`f(`(+a0G`oAie
zSH!3k8(O&X(jRGk1C3)XHL8U?H|BaahRRF&vRbR#2}yl(#aD#rD*l;xf6zHjk(08j
zJ4@4@b~gi29kriMh4FL!;rLN2T5Iqvi(71yPSNQ9w`a#>7?qmc-Atcmf=Ou1&hG47
z!Q-j8u($@Eo9g7W(8!B$c<W*lH(B=l4DEDiuAQ5sq6x=dRQ~NyS$uahL_?x!ZT<BE
zg%=}M<)cFO+Y9>XmwtGBP#WXwdrq~%;8#=1zr^U675V88WnQ=5G@yUR#}|-I9IG+X
z3qyO`89z#7-&In%d6~{Gfkw#CFz0w1s%<Himz5&HZL5RX&U#<;PFbeSIi|p_yXhqp
zf33s$hp?1I>a8wek<!ATU@{@_e~uAtPjWb!sK>f;C^r*Kt|ttJMAGcTsEdXGS1ke^
zduRPloIjBI>faIc<Z(s+si{Ff71tmz`7!whEV2d9;&;BaeQs`khjf>^tk+SYN4gDg
z^<Mvd6ud^Iw1W`yLO}>;#v@q>+pBRvhQ>3KNC9??8AS(^eV~s2sPbLFX~nPaaij!N
z+0Ct!$S3j1_p{Fo9I49r=Mw%%U6svvePv(t);njcv90WsK|Z{~Elj1K05%QIUWRyQ
zMM@mr5Wlld43v2Fo$DlEE{`lKVB+_et+7C3Kl%ghB!J)=A_j()hmfpXxi&WBV!}I=
z&|Pev+vfisGJ-AuR%8lL`9~?oh$P}UF^1hFEUVm8R|jD4uetgvnqt33{x$7dfZqlf
zJiX5M=-6@2#;<xb@_;NG+1h#(8eF`v7{5b_5%B{`keR3n-THulf8o}d!07`Un@GB|
zvnp1;yr{#E>VpBb<5UPLwQ9)4V6q9;sjc)bF81lO@z$l{RhW>`v1TW@oiF{1lX8|4
zx9PJwJv0=e>JEAVG3X_}On*~;?lR^6%ec$XB(g*3e1A+0r&h|3RZ<wdDgq}a;Xhqj
zl_au$M#+SHN&O8sPQ7;g<^YcaD0u&~{6e~N^xbx0k>i{BpWIxu<G@@!Bkc+yEdNMm
zZ$sQa)n2*^y68rRzCZceb`8e^s`ZEZXrIS`kL9fmCUeG3Q;~%~N=k8e(n@~a&e(y4
zE&O+*!DL<b1_?PccWiS%LmgFfH{w{@;!~@i){{+{MKHjp6DP=s(vvdv=uV?|E@@{(
zgs&bKPf`F&cqenfbBMAD!<J&21=$o$9_kz#x-!0s+oIQNoG#UsNbN(A5TgmB{MDb{
zFXdY5L$wIVdCu*!06j-!X{^T;vS|ORlYEw*qhV`F4bw@buh9J{gvqyqNsLQaaC<2c
z5m(CL4`L0StU9tL`WycR(oCDQp6bdH^i;>VtHqwoV+JS)O+Dd^a;i4%Ms^#>9V$Zc
zqcSgY>Q_Rw7PgyyE;%rKM)hlZ{WzpztKq&kN<ePSj<!fDwgag{yLlZX(zKUs-mz`-
zfbRWcs&}^?<V+9+h##L8^psbVKxOQGf>s_2dg{-agGn57<p|UQYwQV*4EYi{0B!+&
z!_3-WaimBj6g|}UAfxtDt+KQ`1J5m|km~OLKGx5N689~tlU~lqGdF7dx~%yS`nZYg
zw0B22WC6jc?sD^kLy_mvU?;hANf%b(ug`sNUifTdUK7xMRbF~07*?OsQycy>VpM_f
z07bn*bU+}$?Ez!v(;Gb8Q217jzSJI`_JG0ZnsP@b)=cXIJM4n-|2+UHNd8SoncWqq
z?fBz1`q%sa<+L*iJC{*te#7DPZi%N8Oc6F|w`=(5W~(wqCOCK>oUHx5AfnT)myxh^
zEz2V~#_7RbUQ`I>-zt(jF>z&4H0nFSVEH7kzb{K?N@PMO&E|<w{@w3U&Q_OtmtQrL
z^?J(mc0$F7Qv~d!gFb2G>ln4TH1!XYmKW+sh1@|u$SJ1iguJlythkg-d3=+35s>{D
zbc+hU@}iRpAdex0fKTHT0oSGfSg8M`QW?4(t1pQrY=~I_xUOr`w~{#XC8!M7qmMve
zv=SbnDq~TV-Ee^PxN)#!PV#kXEK0VF{hj}HgI>>6idazVC_1VbvaIfxIHoxwa2Jvn
z%USu_I44R0ysh!DaZG7sQM&*HORp1-;bgjPh^C^p#>5OZ3&AzFj9zn=E`KP`0pF+e
zYUD`IM~qPCsamJq5Cl@mPSN%niaGD_|Iqc`@oc^C|9BFyS7PtIwRVfzyG5xEwDxGV
zrDio+Be6rRmKvp{iw;UBY6Y>1(ycWT(Uz7H6hY+t?s&aF-~WCdr6D=z+~+>meXZy7
zx^7E{`R?4l0t|K!CPNlwt!0s>jIhVpqmGy<?_s-`tY}d}xU7Iw0sC2h2!ZB3XSr)D
zCEAH<n9)aa@VPJ5IPYUaF?6<3*?R=TFt*W<4;(4Tv%j+?<o(qnt6?HNRNo6eciu}c
zNRAnd6GP#tu5pgR0ncj@2E$1(1ngAO2^gXfCUPqNgk8;pnpfzqz!x@RT-jB)Q)O@G
zkXXD9zcP>VL!3c+Lt2niwj4$5LpMIqiOvC<m`GU@9;{`0st0^w-Ala<GYUDFuKx2+
zEYF#3xUuBr?&!F%@$Dr0-u)~Gi)3hAvoN(Ml}x)U81-+E1TDwa(|UlVhMjOYot!1P
zH-w<^sQJfp*ci<i7G^1SP7?L%yx0-FVKySduQVI6^nH#+^mSDnOTZ7Z=ksTrH$T1_
z<!yJDyC-jQq*q@}P(<=2!OK^Iy0^oW7b*U-=gsBK=PV};Dp!bMcT2A8XuU_Eo^KOb
z<@PShk1pXu<p&lqIUitLrX<`QnImuGSNrbnDVCA1K<mU2Y@E!zj=<DU{&iMB`40z8
z;6uK_bSdIif*h9Cdaxnicupev8a}vTA*$;<tU;TsO%#1ZR)9Vcq)sW$;zSp%m3`Oi
zvC{gOuE)XW;~ei#EMG5#N0U#-@?7<~cnY_#w&asHp@WTbq|jxCYX*LjS6wlNIG)H`
zsUzgV#(P4XOHJT?zA;hPRrZC?q`x3$bc}e(GW6^1lZ9GWIQNYRngzMP=<8mJFS3hx
zJ^Ip^uekicuOY$u@T%B%WBqS^!*QW%%Mz9T$}ZL9X}taj=XLn4&s#2$Y#x7_Md@@m
zGyF(}xVoYRH4?#!y=4<y)nSMe_pL7mB`escEVanTTrUn;er{_;IJEOa*SGBpcYc&q
zT=~^$7}Clr7_!|P#KQZHqHua}17B<Fp=6$}-zlkc;MgG2i{+oZ|Dj)3ditnr<!<m7
z)rvkH)cC14Hq-w$%@+h1C9S>ir=$7NE0FU*lGjj@VM(<Qe;ReP8jEe4@f&mHl<0-X
zWfhMYn#7=H;zK(-f$XFrhmqNjmG6F>QRMW!g=$I<LDfoGucF=v;C%x{DV&}u3C?@F
zOb*fuKwpM^dw=iz<3pJJzD!^-@#rsxRy>-;KA)n3b=c$qv!RnVTXtsT;0SY0af)p$
zK96#z=+JFhD^A?KF4mu!pYqc<NGwX;^004(t(o29bOhUTIf(v3G}atlS$~l9dB%QL
zTUmCXYOf%^3xnK~dZz-mr|&*SFjOJ<+DO%>Io|3t$FmpX^uDRQ``5J&rOL=9bq048
z%kP(wNsssnl*_xxOAoNr=kFU=-w*>xuE3vWV9hy2Qfs2s@XLwMxNk){UG)hp0XApx
z%|G>?IAqxC)b(i4MVBU%0S(B;omuZU>G4lmHjy)&XGu7p32nA2Hw2qrI)LKfl&$MP
zZ6k&bC9XjaIz_M}f`uH`QrHsibPg8XMvklNzaJs(>Fscfw(>XF!s)NoWfoZ$l%#%S
z^$*tgxPHT7i#8<IWzN^F4kg+F_pd}%Ieff)#{nk%_uSo~Ryt1U9N5|8{@euu?nYSm
zQN7@c`w9MG?t5<*FL<FJ2!9*hv`QA~yd%=shhOKk_RQlGB*6FI6hF4G5G@Ind&Uz!
z^9O8_P}RUSHlMg8_@gc>fq@yJ?1XqTedWjwX`Hx3UCr7{mw%bIrbqn<;yYI&=*jBm
zEj?r{s5cDGrgWz$jU?9+<O^-lt<BJn)n(@P4|E5?Wm(R@cYYg2+Kzp|?OPYRc`aoO
z6d}G})K2R-g!Mgfaa25t0XKY^y7KbG?>UPg!X69!lqN#dgM`jTL_B>lnW2MlFzHlS
zTw}jXC_C#TiTu}zwO}tL_u$z4ZR&$dg`YtkcrN>Q#h<L$s>Re`?HI8J1nq#%REuyn
zEj{pMR9Co33H19(lm;hXOtv6FYJQAQ;?TLB*R)W$Vhq9w8vOMW3X6D+wYUZJqmISr
zl@3TxXTOQ9F;4olLB}Tc&(D|djC;^d-s4OQYvCrGq|n9{<;k^<tCM?j*O;s<bl8+F
z=O2zVbcNCy?B8`^i?j2G?Hh|o%9q&5sCI4iM*ktIQUrcxuV|W!Pf#PRlIJerM?~wl
z>DSXyIvo5*&7Y88XKv<GQw24Qb-23X_9#}5U$9uGRj}=AI{UyhP)C0KSJsh}cZ|~I
z#oP#mVSbKFpFcB9yaJ+a?oVw)?GtSM66`Zi22Ol=r1AV!3@2IeVmbe&_IBb#2k?z9
z5ZFF^yQ}*QGNUWSL?qj7^N6#*OG)uPEjxX%*4-=m+Xd1Th-ImFvq}ui^b7Ybhcqk8
z7qdW6`rf`MAMj33IHhqJv5~lxrun&(9~0+MV&^A_%Rj7b>R)d&>(8-1w>on|ru2aD
z>{F9Ytv<mR`uho+?t5AaLaUJ{3d*Ggsb#^vt-&kvtUcD=<SzSvshDr`$f^2@4$e_c
z!IZFgH!*?wlB9$|TUw6X*;(_mJx$I(y2bLj&eT9ttIeh9kt}}44*xp5ve}Fsrn$oR
zsesULGXdNjL#U;tV!II|oZS=njDK&t@-paJj?ldHN*3Cn*^910+kUiy+Z&kHMa{K2
zuWTy*LNMDe3pqpY%oi0!Pd5Z!7Ov9T!_a@t6)wzF%1jgU0!4OKs3Xh!vN%_~hpfKk
zsZz|H6{72vRJvOmw)XH@g?Y#pvYs3iVyF^Ilq~v}Dd*5b_QQKO$&X<;n2MGr=H0Kr
z#Jq&lfx6z|C$U^jERtV!4S!;wWzTbJW3?Kkc()8UPup?SJ)FS!!>{uy%)9tSSH<0A
zMzhRcrh8x#_imb|2CYy>xdX&k{e?|0tR9V?czqJ$C9@1HEoMrWLk0p{J%=a;$oBT8
zZ%dmbbBV$ZRt%<Xqa#5zzGVsjq-#PEaqQKb3=~mYerI_tSv1=D`)4P!<p&OJkvRrG
zNY-Xo*hyXPs$uyxeJwg8`z5ckM4w2>=50wD+$=52rZ2d3f!!RVzEk*r$37XT7UeNc
zSfXZj3(H-4=hPu*^!eXO*Q5k51OJD<5YhkDt7}FIlg~{;H@{loz3o|q8>DIm)bdeH
zwR?Vo3Gj2Vkd8@c5BFP55<H@Ep8yFn{0y}rt_#)LfsIjKEiFYof2mV2PSuV#QkNpA
zeD6!XgbU_!bA~1H?T=?91~#~r`Fgc<q%GObZl^ch_Q-smyu7Jg^x<2k^toX)`yR_%
zj{}Yieq8C)E?gZLXd$i!&*x05MKm$S0&hR1UigsZ?0p=x#OQ7<o4fPpjLTU<`U+B<
zM5%IPIMvsxnWOQI_o3^XRcnt4#}h=#=LjemLVW+?a=7fVT@Ra~Nc7iSV9BD|Z9Ss9
zFMIy3P{%3%d*5`W{O4*kR8D=0+<Okg@biGgTQI`SV|!a##)g6>_LE`P<G1hh1w$eN
zV?$k7dtAv^f^hE$mZ&k!q4Z|STi(>LWGT)g3t!f`Bwdpz^H0V$G&-Be`B?%j&5}0c
zGSsR(V|(zDP`3?wDgsaWcPz6X#r9jz`{Q=MVDyXrzJ8)+^V&dkR?(E=w3K{IMWp|H
zPSktjS!_?@HJr|2dcB$RT=A(U4T3X;+F!jJ@Br0?rsyaN`+Mt}3m8AlN7cOpVN-O*
zBih~OfPcsRP#xlp_v1}vz=B_7=q+x<XZin4B`-yg^A;IYn^oUMAxf+MNlAk;k>Gcz
zNKwp#O8VGbWegIe#UGB2F7QcaSy@BUctEVYN{q{t&i{UoD7dG(q?qk^SyfGwx@gDp
zW$3?z4jIm`!Z`E_qM?hz<E-URca_40gxp>_Pu4Tq5m!aVWOS8Bz~;~dwWt0z_>=a_
z48Jp#M4Brs(<FSa1v6X2)89>h-szN-2W`@=>(jMcZj0K-nY6SokytU~?S}UTPmj?3
z4o$9oy<@H!>951*cdsC_KDfVgKo3K!%NC3tU7~K4`f}Da5Cu%lLaH;7{ld!SUj=hh
z9xU^#MXW@5jJFQrJCUVXw8v4|VJm=1g<Jk4@jXbmItCKdCk;snf76#3(AQA2^}kR1
za0Vmm><S`Ex;l=f*!JGE!a>Ft%h@eh?}Mt4q*(qd`d7`p*smc=aIhOAnd#+eC}MN+
zW_I5s(Izq?T?gJ}%yHcN$T5wuP_L7Zc$08zzW%TwzR_HTS&}@D7p|Nk?$*{JZ#vSR
z)A;9E<Bx+LrqXn#RH9z~HG6o%YRBN?$HTAJ$EQ7DK3>LC=k9^L&p38jL;bA1reCjy
zYq}5&eGR7U;Lg8Dj(CS9h`tz;xmd<NGn=#Me8Iiz*lJheK%uYfv18}_C2(*KxqG-Y
zk#0E3h~op;0cO^<NDi$uA<`Ah7j6R2U@;A_FGZnM>=o3-v1xKo*Iub7BgA76i=l!)
z&@sKXc8*9t(b<{aGiLW5WLY}H@E>&wcmfD8G)L)K#pn>}ZZ4QItL2-C!pzQ$#!btC
zbS07A?MrfGzEl=Z1Kd8mO1f?m2j8U+p^+z!#M-eqe)lEc<)Ef1!>)cw@V6QjH>reB
z+?W;;-7&+edoaFB%KboT8GhfPEVn~hq)yn=JnlEa=f8u0L0vL(?tXT>ACF(`8P2%*
zR#_h(*`q(7_UwL7@&g|Vx7mfAUk95(WwPtvf#LYr9vh+IoPi%_j*O?)e-!q9t1<gi
zI0nQ)_ZgU3hKl56fg!0j75|^V_1U!#m8x3+#|U^tU8OLuA>G253sHyF4_2jlu8ncO
zl7_7rO5J||QLAD62De^*`nY|jt7^F>ZrT!tA4`k+=HdqlZUDV<2Y8wah~uJO*<a=*
zvmrA4oK(QvTi(uvjs?juRr~=N0<A_L?fJ#++l3+PX*(Fwd}*!_8{O-q1~XI9GCW!3
z{YTHRfX@tqxU>QY3-{XHNvG}N0(yKc@4ec*QKo3JuFFr|X9&^N+SRh<*sdw?9Tt>i
z_vQJzbjpv2D}u1S^UnMYeM<I7HYj48YQw5miPP0cvZ`faH}d)FPOMLh9Wi~4vtesl
z*yM&f`5G=YWFwC~(SI7>L5U32quNDzRmv_VwaWLLwo_5e(nZK6WInRh9xZl(5FEAV
zzn^J0FH;rHxvclg=u&C3f#Vr-m1oG&$RY0=!#53RfOs0^EFu|Mz9uur5W4vG+Qbf4
zaTO9|*H#*mx#Ij*skFy7D~MGg_SWj=x;j&DWt5$bfgz&GMrRbYGTd_45&^s9^^VvB
z(`VW_R;m{uJ~9$^x9j@MB(87MeXb`W=qlG(cq65;0ZXo1;I#@Vvq+nO7rklRIfbRX
z9b2LM_W5zyiGki?PZrYlJPPlT^boq>JJkbr?e**l^ae`2O*P8vZ6U2vY>TKBOVl80
z2_5JD1#M;Mln7_A|5Gk%qddNLTEztt&~#57665ig;fyO)I`{Z9LQ$X*?u|Vdcj>9h
z2@%%TwkV@@V+5>sB}q$DZ{y7#r;))Khm>1O=#|0b<oV?o%iJQ>)9WKN=0<7U6x;Dx
zUYkdpHSRGT#LiCdtWpCX?egx(y-u4cg_{FxZdr5>kh<?ir1_$~w5KOvSJJiWeoM!u
zb`{+)61kB7Gotx!`}4-$l=eK%kQX#N@4>%~R0>Y*ks)hvuy9-Q>9D}YXFb=)cI+bj
zW8=Xe9_}$c@Ha`Epmd)4(~tK2wS``Sy3obIT;TGB1?FjzDrdCj_U7%^MfBsQau<Pf
zj3$hS>hC+_4||$Zj*gM$vivuGcv>#q%378*4FPC?p*b=zeBWIsUnRJHmSRg%3v5i=
zyPti;@3hL_z~Gr>&9gBzjQ!d#MEJ?H<z%VmqSL=dp53X^%o^=WCY*g3cg9sSJ6FZv
z;yW&b(%FQaz)%6rF86bmH~yT-vTx38>(*5qA>U^x$230&3y@z^vB6<XmVy;bVIS$~
z%0`5|WE)>yX(TZuk8m^{>wjOFNIhF$>pPUowzc+_6y$hG^C0Kwp1S0R$_{VyXCk4D
zk9=xu54?m?c9X0T{*QCO><rr_V)wrY#!3;2$YkcmgtViYQ7372e;5BwPIy2$mFqKI
zmo}JgOY2f)&t*CzNrV!4MDl&%;pzr9-bWj+J(Kkw6zPbkd_%R`MMv9EX2pH#Y-287
zM-TRzm86;bNgm!BVC~v>C|9ajKj6`|@2(?-C{67uqoG-E_b79v=j5&~#pA|gWLNW-
zIGy9bVjJG-dr{f#xi=BoYN2?`M^Y&J(si85USj=JX(ucd65C{tbjUyu??X7PN!wZS
zFX8!X-FQ6__r8_JNwt|mo>tEpBgK#oCxBo8C;9oed4%jG&1WYsOs-Or)GgCpD+@PC
zKqJjghgsTW@XP;kez2Z*>D;+;<0nF{92$;h^KHppT24+Jk`@Dl-_IKMI5>wA1+7Gv
z=F`rM3^;SRZ?bEV2u{CVeLQiA#>(ojN@IF{<J@GPy(EjL?GH=Vcd`=fIo97PG{|F;
zSt>m8zL2<>LB-T1X%KVV#JRld&0Rdae|(S;?q`@DxiXJkfv87JJX*j<z(XFHrB!J5
zIO;!_`Lmg*UTqz*t`zIhtSIlRr6GRs*SWz?@{Kj4dxxw7_Xz@0qbUeDt)Ahq6kUO3
zb8MzE>8UE-H*-+o!I~Nku|0ZOH|y!7ey7_869Cg6=km9C|Drtt;6#F}!;DAc;}Hyr
z&I7;2_17Wjwfv!Ljzz$F!f$WCo9}tDb4%jV>1A_qLg@a*?&!^Szt!l?j(`)=Hqam>
zoFal*1-c3<X?c3GsJX1GqBP&2vN!)c-St=X+s>RHX5W(e*7K+Qe!MrMJAYlAG{UP~
zQ!!P*a1``DLpR|c-iq=S)W3Qy$)d`j$zoFC3wGI;qw?dl*3FX;YJT!QXojfxJpWzB
zzfQL`koDCGIW2U@<2^C|$*j^jKKY~BA8xJEauCuRzSfUnx*r!`*Og(v&6s^8&Qr7&
z7njnH>+Y$ichKboS|-8vFc2COKP5WNk4wDoic$)H-&mHr*xukzHfua*UTH#4$`WCx
zIxH`oeSgLjZEo&Ah7T&qN`upuq`TbEvU3HWSnv(LP4)s@D!w6B;@z=w#XszGgir9(
zG|g9OtvdYXdlPR(apS$+rN?GZ;CqWP#JC)I=Efum1aab6ukfhE(h;ny%ZMP&Rz1Fr
zWU;t3b|XPic?xVR;q$<v{!4os_p)bd>?_mI&L>A@&LgMZ=&?ZBC`(Vi#_ztr8DJ+(
zSJ1`YQ&YT=Kaf3b5b25HgrI4UjO9(!6qZhwP%=kxY7tIx?Dx#hu#|>*$#6<Yn-v2;
zn+5(CfBDdqs&YZ}<nkZfXa~7=Ya~_WS>9IwqR<)gQJ#N#>z{eWv?p>Y!uht!r%l=3
zmw$2je(EsPBY<3*^SS0L?}z8~*_l$F(Cvzw`Z#}qUh-<DZXGu{3NL?Jz+jlWX5yWG
zA0o}HRWDXaNe!l6BMX`>m`s}7HJATMtFU#p-)!ZS>D!Po;aA{18b+eobrr6b#XuZ{
z$|mmq&c}5Px%AAJQi#2O*=iAqKO?Xm%Cqu0bP-uChmfVL1c2*;fjVUOWk@;BCV>1~
zTqT(D8xfr{8*@R0Z;v9@u8USIo3rSX<a<|#%)gs&ir@b8Xgasr-4zOJayjt$aC1sm
zE!^Z1+q;o(YUphijU3SG$@`nRuf~%9pAvjw%I!t-J-m<n`bknXUA|^IMycbi-ddW3
z!|jb#%3qAy^&qQlWA@ltRQMMAlFmu^l@XouC)}x?+8hNJD<wNZRzZ3n&Plvqsea@>
zott$qnx9~tWHZ&PtbGiCiTt`6UoYNJb57W>NIv1w&)R6f${uMiKLHQtBO&yy`jizp
z@2GKp5WFu}`dyHKcpnHq6VCVw8$R3L8)nL)pGwe|qw)+Yu}2E&vfgxp(TpE<{&hb7
z{KlRX|LE>Q_+T0pLF~N!!mYw&t09i3A2rlt+)?x>j#mzXPYko^fjmfVNcVTu<<d-9
z)O}^K_O5K07SZE#j>o<Y2o@Dwx;hqgDxRm8YV+r+SmWGbOV(lk**l_A;a?fL&8D5Q
zEKkaH@$CMCf3J@PbGI$D1`DZG!76SC9eVuY9`=`TkjSm=Zn1~tD0HT<fl;JU|C}3%
z6YQ5`39HIwoB@5_?uqGYS0J>*gZB@{?}gc0jUvwo6O`und?VHWf{K?ij2MhNnYf{+
zKg^%53S!uIM!WxxLTl3{BR8>27C(vM<qXyN!yi{7bm*!^;R4j3X%~`zTNcie|JZZ2
zN^-aeLQt2(eu@HZm~WYS+(?cSzPfUha;hLwma+N4VzWU$;$#hfY`EnWq2)2;g$wNT
zXoN4>Ommz5NR|=YJJ}SKjO|bK7K=QUI3tBIeAf(O8Km3O!!T*2K|L~AJSgBrM%^`k
zOFD~quFak&5bYT9kmawy%r4BMOb^6ixtI_?F9OVV5PT2&@4Hl$TFDS1$c@4WFR<!4
zLhA1u78DFire`h(%v{DoWS&5wtaG0%#r$1u@S#>sQ&NhOr#m753flq!_JxcH;a2oQ
z#}styojss{@c1LBVVFf}IOlbtWDc)u{d}wvO%_CL>9#xVh~u{WMym?Q+wssw*VSJR
z*|29ZafTP)us9<Q#tpG{PXvhAB887N&v6{fE^IDr5Mj}}GrGNfwDaaQvtH6x#CV3N
ztu3L$F^x0N^^@wAn-4a>;#k6ya&s)x?>4o;)rQwCQ)Q8sUGLpsnU8pQau7kJ8fd$c
z%h56A^Yqo6Lzy`I=)v4i9DC>Yu4^uVG*rv-gbhUpwV@wCO!>Q1D8BLaPLc(#x<Jz2
zO*4VDV**!FGD($QEbBc#a&M5lKmPh^{>sJBS9JOCZl`A&yf&{rFC>^{lwWHgj%DeJ
z4wU~OzliCq)<K*3U(u1aQhMDm8ad~;{xkxn(&#?Rc*11EUg4*a;TIyTw-Bnmk7wc>
zYgqFwdXHm&lAE^P(L!PDKSOmi_I^AGZ8KmozjDI8Ppe5DK9T!eg_CV_lF0(0hyo)!
zouFCWaf*@OBOv%<fO!2GH~s|PBg=ztc~!KA9hwWBlznbW-06h&t;%jio&MWCvvC-E
zZM(j9sI?>OHZIRx%#UCl;m1#cBJ#(qpY+Y>sjj~;pQ{fYB*;D;ITv{O#p%QNS_cxJ
z=9QV&FnM$V?z+~CAz|y=^-I!V3(L(`BzETcZ4-jHD2X4k<jDs=-PZo4LiC7vhNHz!
z6+xW6?#^-#FG+)+R+JcBfTgEeTr$0MR!Ek3y<!g;HWzs8%#(miy=72>FxsV%wb;Hh
zIPc`6J;d?NhgW4<RjOD9%3eH|laU_U#y%0>uM^MF0{g@J+JcD#gYZH$<#@llmjErZ
z=Q`}&m-pOn66SCD#(Jg`_n7qkU4fm6B`MBdEU&+om;IT{|EWOc3wCdc80_!-mh0MY
zea9x{X_H*dn?@<)IyTSqf+*8PVjNBj6Q?0US?ko?Uvh##AgG$@gTw1(N3PCtAOwu4
z{)M@e{gEMlfWZBiL-E@y&9jzA<qtBNo0P8LctlCI2^)D-R^cSe*e1k&-&BTazD$Bd
zRRa9aJvr4{Dw)7g><#q1BovA8KWF#$Z_A-vVQ4{;dfO~gLa*CKTzg8g!Eygy#4~Jl
zRNP@pZr)>@tY4Hi#UUfxmlBG7n>7fxVx*;y|Dy?e)j57ohaRQmc(#vRV?cqb;mnL|
z=4LK+(0nBqrd!#ya|&SMrw>XsgGn-%{1=mQi#uesUEUo7tGpl@D?FWpB&l5DgML?+
zUuYL3*nA;X{vLM{UrZAF*=F37kL#akhGfGoRPAd{>|5cui2M_0^HADI!2G4CTYf^t
z<%EFd@ATDsh+K0T&57{Iy}9vuBq>NpCo=uD-_^{5Q~}i|v_!Lm1@D>tKy`1&SZ>hO
zs+2<uViP(T@+g7mP+?FMtN1ZS4yqj17VSRhh06NF>9YTQBlaF7-KC8m@3U(9m-WbJ
zv3{1Ve(CCh9Q%uJLXoHqS$r3x;7XgmC7hq=uQK9CgPr+Ek(D~v`}k_klDg4%9wS|g
zN@A!`^;jm-VUFP6RmRo-Xe1v`EIyJf;nfHjTuCOkHtD{s6;Cy#?s13N6s3YCL=nXc
za4l|6E<&H2MKCvVr!tnl(Y%Ur4}6=A_b0i)MwT2QddJK!m1fn}tzkBVM6_XEx5#$=
ztz~hC?i|<e{H?Rl)kZ_t5q%4F18NCipX-!*D6EpupGGfaUCe3Bxan(A)<!us`sP~t
z41;m1i}ETT5CAq?WA6!ye%G>Tir?F=Amw^gX$?(k`qv-M*+KyXdiaf>iDs~Lk1tj0
zb#sFu+sDuQnh;#uVFeuYwWMn%mhqp$&SM`AKuW9S-(Rvbek|RG4C&&sBNULv^TW5a
zk??MD={(|R(}_=r%%#FfW>E<_A?dr7chP88l~4M%$Pt7I>Av3muo2K0jbQ2Hm+)yN
zoN70aGa#YJd)rvD7g}Ebc_1m#{)m9Zu<E?g+t37(tB=3s(+}FRv=;wW`=sjkZ!WIg
z^rDEICAqPkN9Gb;Y_SsuTW<58Y>uGYo}XxF8B9EUhC&mVsNkLzYU0@F2y@ar_Pujy
zc?w}+^!+C6v&Tqh{AomPz8hAD*YAEvT5lhAQDnet!0aV<js1J61zYCo=D*qHIHfq_
zhg$&9+a;Fi;#k)Xe|DSyb;s0bR-$408%c=l0%6`Qd$qJT*(z`uVlY^0y#>VJjKd!z
z3s^`M&UUD6ynCOw*fDY+6e2LJ&tJ}dn00mE!K=Tei|VnWZffXX)isaL%5D0WP!#4$
ziyL(@#UJ+_{}yK3#-}E0*VjXxa>Lc!>~m)kUT|)`+p2qq5=f8arT)F{EOA9wH^Jdz
zLRetL5p3V<KP|;);+h;akk@{8AU7X90^+Qate|;x&)%~kmis1ZN>8gt+@oa$bNUw7
z%23zwIq!H!fZ@b0Y6@qApb2pD@<Dzo4%xF3wXux7dzT<(8*Ib(>col1j~~<RCO6u}
z(+x4r0gD^h0B<629RL}|Q#?PV>p@L-^(jS`)>g5mT6fJja1!8i&NEY89Fl9K#NZl+
zcuvcBOUtdR@hu%WZHtQwlar)nOa}&J#FDn#89s}`zkUcus$BgHEQmKVNj5Uw3iExB
zu4kK(?P%__%NJ|RJ8(+C_@&O3U`H-4p$iYNS^mTinf3J$m(PHo2!NWr#B+qd%^<!F
z@tp;MDdCy;<IjM*iHYm+C2GmLCsOuRw)@NuIS4FrT8E3{L1#8<Tmq+kX4^-mcrq_I
z1W!1aBl75o!zT52cNd|`K5=98(aX$Ze<F|51^?)tI6Ume>YAWdC1^Gl@suw5LK~Vs
z6cptNZde%b`-nMvUaOI~n-r_1*B~$5mj5`YQ;DsI{m6|iD-Dnbagj}t{5!6e&3wJ^
zziW19!_fBU-bLwc$y1O2Yq8yCz_o%$XXyLMEbT7cN+%hH0-0peW}K)+jMuySqC0Q>
ziy!^vAs-`wy;>`M#@kzH64j^ILHOD0D#q0lm^;w`T!~^s;VfB`T9Evj{n~kY2{=a`
z2}z6Iq2U*cHL=LXw#B8jIC11W7x`78Ea~gW>~643F*T}!3tc$(&bhr2FHft?CUuYn
z{@^X>>SoPBOq48KnFFD@_xARlzz+K93HL=W;q1wtKz5}0V8kvdidwz6NC7IYrG>5z
zvS1)ipRh);GW0euiGcn}JqG?VwUPSt{QiaHll0BfG>}K%*d{S$1V{=kpG(cFq}#p{
z>dKazpwsdse$4EtI1SO=?cXqB+OacQOBhT%;822d1E%2y=70n3=+e2rlT#C$?R*fc
zD2Vx&B~za|50U{ZH>V4`6H2S!Ju{%O#?bQ7xuVNr#nT@w`BfZpvy&kM61!u>L+MIB
zAE@VCmi-lruJY*d7SBmie7iVtX{C*QWC?;OX;E32O28FXMfU95?srA<x<gy%eovd8
zt7m|s$F8_@#n4CB!$zP8b04^gk3f@e2b!t@Js19XAA_Mg5tL!P1EpsnFyk$3;1xu7
ztvtE)>qgdCGE0kVivF}gJi6>RJ&=TIa<fDsAINhZwXlF-x^KLBpr=<+NTOO5{DNR=
zwV9l!VmpLW`CYJ2YYevZA&z+Ip^W#~>D8vc%cD8PuMB&%<fFut5BS$4Y{zVZZXZfM
zhO^L*84KzI0LUz^FK#UCsZzxr_-_y(2L`6b$Io1o1y#XGI(oJdGcpSjbV4g)r6<*A
zQ*!nZlnil~LyCzk&DZ3f2K*2nLJk|0N?CCn!s2%BTN#oho$erl)e6%8#vPU5k~!MV
zeQs1YTPW20EZpqQ{#h@o_`QAu7Q;@(Y8m4r;uff$+XfHIG8e`2zo+Rq!*mOZd)-CD
zgRDx@NH)Dtw!UorZQZe%N;6_y&uc&$*bV{6Y}3=lS-0@T#U1Jc5(Y@p<Tkev!u#fs
z`IH{iQu1pv2`pDy`QpY_D^KRKXVEA3Q?_T6K?S<~GZ_=f+%P~jo;HPLl|R<o!HO;F
zc1tlJAT3}WFqcALBnwO8H!SrY?p4i+Uq4r|03Nca`DpQ~gg((8Q8LR=ZE0h0E&c_P
z+@45r52uBD(?snkGtc?}KgBcs^49~i-t&0xKg--%o|69Z5^ue1m}MHUmjYcbTT{>b
z^q%D2kiT|<S)~Efu<a8*@e)5<SAc`vY=FfU${d%jvp>$W{vfg3{bU^*dS%mbSuuR9
zrC}|ArYa{J7#!eJeDSK+d=A`|)A8)zvvvE7{Zt-k`=qD7{doV>2i`|qbtgpM?Y#br
zdYYQ6X`7z^VcdRRIqVM4!AaHwGEcxR=X!@fu9aNjejV#M_`F5fdi(p|4|&9q&yP*+
zY1q9rI~T_&x_?hdIsC{8CAA+T$FHYrZLKZnZ4Q<Zf8E#9xC{C)BAy%RD+;Hd4~Y3;
z&z47aHRUewO57xoBQM(u4eE}l7Zo1E*LmAbz4t=-96$N?0k<kOSm)`w18J%#cCV3z
zm$1MrK|PkW^@+(=1x)_b^_QVn9*N?j&`A9|cYhG~rv~Q+uj{s4U1<GVttJyLeB%C9
z-1E>+Z8aFbz&TGf|Kw~s=u$XuRbJ)z|5p_NssJLJelkh_=Bl2cBEaR@f!%U|@Vcz!
z1H^g3+eY^0<v{Vbx{!l`J9c?_p=Q@vXX=Ax-{{CGn3Jr+evc6bm(gmn9v{#Aj*%-g
zGYO0UPUCih-ajWoFOV<KT;u=D0`T<L@Br2XUmL>s$i|2n?bC-QNf-=<W)l%tH!}Hm
zRux=EV<au_EKdkfW#|mA3VTP_%(nk2Aci0TiC)nj>gre`-(5FSYs0z43ukZndC77M
z!2I7kUM1XJ=iU7sf@ZWak$0cQuw#VVTF6|z<gZnh5RkW9%f9kXM|1(Fh-STwHV2x$
zdy1(yH|bEX_eS&5<mBI7sznJHRXni3i!_9Ila&AS;Qw+zG;#jf?!837Nn*xr{~H+1
z&C>C!g{e`_Ob0_qS>nV=o4%MnS80gi!#pnoi)zrV<Y`170J(WE9mG&`nSZ-xl9B+{
z7f{)GY&Jgv!8^OduzxYV<hpwt&?X?CnHFCni<#URxy`1(xeGmjQ~HHjGlxyQOb6^B
z=7+MFRSj!%V!LNxp8K5(mY`-l!7Smx?nYQp7bcO!BLDv$1j*vovc$XTnbF%^-~K?=
zHS3#H&V<*uKkbeP5^PyyC^b%ihwz_u9hpto<><$;a3_?~=%n8@KHBDp3vsd(ytfAV
z*4QQJGegL&mQM29q{>}L=2K-JCv-$`8%H9^vXQWmD25aXCLN5GIf672M87TEDeUj`
z|LFd+zl1tNop<~`f2Jht#koB}NbXtra2`8t!PwNK-p#nZ&Qvc5wlUPq&dK53X^eBT
zM7nRcbR^NV^|hg;_+&glKK{D^mw$GH^0xs%y<fqsLUi~jeM)nAN>g~5$GjyQ!V??b
z+r=G*em<z2b`G^L9EPS%QR7lyx88Js<7vAS4M@DH^dPZ=gAReB+yRF1A*#o=AlhM~
z?>G9_t(s*Q&i&n{7`(qGIAen8MA@>75W%4t*P;5<FJwDGh3s1UjB)Fk`>j^Z6w#oH
z&yWSge7fWy@bpjj4{i2EaaVfgw8tu<xw8mDlg3l7nHfK9Xt{x=E@l<r3DnY2D>Ff?
z%VNo*i6n0yr57jb+1Z!H?}^eDnF4fq<wGK?K)p%I6ZAU-46gGH)M*5oF3OmpDXnzW
zGzThw<~0Oz;moN9erT;hoy)&i(OWTvz^)31bWhz{rMjk>`-&BcnOJ0DK;qgJhAdY?
zJ3dY>ICL6ILoD=X&ZZ#(em;iD%N`nqaloCJ{9yT=c>SGy5FPO`xF!ub<HQsEkMk`B
zR54NEMCm5nec-z>89<(OzE&S3Pgoxil&s~1Bd7;#t`mOqIf=lKY+X2*Wkl433K>>z
zpRuseedlQiEsA4>5M=t%a#;t)0do?y%#m+o-i;_{(^k;V5`zW#>1uvdwsY2Tt34E<
zG_ict{r;Y3IXf8*E}vz8|NBVlW-U=@WEHdK8_BI!#efYnD2QuJKXPv|!THQ`YQ{Kx
zln^4^@)3r(lPAt4&~O`$U)3rNmVe`w2hbQ?n{3Q<3NKu0`3>BvCL=bvNa4zvejL6~
zK!EjS_qQyz>u(FLcqZ6fY@pd(e12cTiH#>z#$5i|o}&j3Nkx&;H7s=vgzrik1n8*c
zj(_5?bK*Z}yvGcE@p&5Z&}oF8a$Zq*7dVO|>X%Povbez8g8jwEQ^7lEfw#zDCvXCV
ziM$$_w{wV@3%p4LtNrPLFUD$z3wRGv|3=^}Q>_sO7gM{J7u>ysmnWFg9pxdKZdD^q
zr1=m~aAO?h_4vU9?J#lnr6b&YG#rXOh)hPY2g1bi+K;d!1Q>Ga`Y_!GI9=a7Uep9E
zKN`^___?A7?0EY}7AJO{peqt7v9I6R+!~%fVENJhaLQ{-_2itFYR!+M#pBZ8$Y8#$
z_m<a61aIV_2;m=TJPJ17WT*8NG%U?csQ1NhZo%gAb!@&8_&KiR&E%D`S$%eTOBJ#b
zw$Tktg%0x*c+Ld}^0=KM!eHsiYS%tU4B_^lk^Uy9bcXEj{Fb$B%hG`Pc8?`2jaLmW
zT|P#hx=KO9QuJmzxGcXMzTblS0ADrYxxwxB3G?ao_p_)pLmlit_>7S_^^RZU^f60;
zvcbs7lU!Xf!I5H>7jEx$v?R*^IHq*n=goIma}NI6QP`)>UfGx5OB$v75xq$;+EUlG
ze=uS(95qBXkPquE{nrCG?T~!W?L;nI@LVh(+dqXfQh+qOO^wKkEemdHXLvSjkh*p%
zFv4lp3Qo_Y{D1;UU71{;%T9L!lk-i*$Io(}B;DVcgImETFq~wb^60Rv*VcN5n8rn3
zWrc(JG#XNAs6zFf!DAC_uO=HUz>-wW*w|jQp#>hSXaXWzV=`?BLlz#ssS=he3c-R{
zd{A0tzZS6qwDi)<Uy95HjJrk=LML6Jh@zUT&diQSfQ*1|kmxw71r;dtjYCbK(L%+-
z71@Mmcy6|kTQ^&mD2Ni7DxFfJf)FpchB8eJ<sUFqz9g;g{Xwx#OF^F0gj%lqHf%!u
zGig-V;d}PyuJKA|LHj92QBpCh?aYF-O}ci9UDZ;@(#Md5h}s{NFW*S!FE-ZzqJ$jH
zxT_1=lF{asYwyjdvQiSPb3=IiS@bVeXmvm{>NEHu2#Ui!u+=mY6AaMRZ#bxTHbBkq
zh>lUMh<)!R#`OGlY5lXi4Ml<h6TB=J;!v#urQUfKTs|NOTD(zv@}V%!HtsA-#+`|@
zefcxZ)WuWEQ$XL5mBKXvgmpLOKag~F4K_ASM+F)qlTg&OGYUMev&)`8!mKlY-k5fr
zAX`Q8q;Gbe#v!Z~P?3^nLiaobNdyd#sSp^SAp9Be&Ldn?{y-JH>N;Y0?@>!<UKc)Y
zmiP|gj&M50q%iRK%Sw*hEadw<h=|KOgN09HM`pcMlVxXTpnrkv0j+TNkA<rciVx2o
zSsJ$Q<E}X+T1+jHO9VynI}~%pN{NwN#LR4eh0#nTD`Ig8-}|D{+*V8IXdh#q)}yk2
zpVg&<_4$1s#j|~tMy?!E^4OB$L8eKhB2>RSzlY3rWIH*Q#`MfD9*H|jdFGWp61A|t
zzPJc=m)@w`T-$R0v439;w89+$iSGqb+!XMomeLS#?iNrONmM(rE?&|Cxb|np2PD2i
z1HC4E6jNRNw6>~YT8<Q5v{JSL|L*rEhI|5?W7gX%=ZRQP4_-O4pQA!!TF|6|q+MP@
zC#6vjtvb<}WI-ARPAIA^o9lFpHd>{-sY%~1yRfvZSqWepyYR()Xqzsq9RvabujmYf
z7bd=?$%lizF<~iP2oe6_4+i=H`DV)VXwsd<WrHde%2w;my>p_p063ZJMKPVnD+lRV
zM>ku*ig2Z}dG&kyjyLAjgKJaev5mun5G*ITO7LyAj%IOCWU<|iDNk1zXVTn^-8LlR
z-s?^~=_Pw>SyC3HP%!ae3LtS1ErYL#<{wk5v*cn$QG8`dVduG(xSWf@xdZii?kxuZ
z6zXliy7?8=lye}yZ|2G8r>_8maymih`7Zg`GX@sS=K4*{?~-O*)AQGQja_fY=)Uh`
zUoa#IEZjQ|;-cG(J#{&C)aS3wTP%q4=#0!(VV_;^6`K+|`BOJOfo_OSPoP<I+fD}u
zS4t5>x6#bi<WOk^yk+j}PDzuPbZ>=_nE$aBZ*#=B)URwYq?F(&3D*@}i-o!kaBtdY
z({DW66m~I-sgA{NVlY{l>`u`fi3H`gNfJdnaf(M*%jonfMeZf-Dw?!w;(=8+-8>3b
z0e9L2$EgoX*bcxcd>KKj-(#MAmEt$;1X3y!?i;|N?GA^b{1)@{w5cb(#Of%3ps-7b
zq-{@aVA}UNoM?9<NlY7l+Tz@7$)?%JtS1y)7bU4)C0hAcnzS;VE<l-5`fiPZ^i3Ke
zvhX4P5!MEjOyq9$P<P;kw+jx?JXwubA&$Q@`O)mM#7N#d*IDXoPCDySJhYO)0)xrb
zSl}5#lPxXTlOXqiz1q@Luf@0Bvlx^6Ru%YipXbr60fw$nh671BL$2XJ@0Ot=luZ!-
zXJc$W<{s(F!#h#SdJL8(<S!)2DOO#(t|<pQE0EG)XGs_c9lVe#Ru!-WOgo>YLYy%y
zm+~#l1*avcGn0J-_g&^El1=>OuAB0lgY7&Q@mz9hk~h%YGUwOdq$y$#sy9xSzbnut
z6fBJ)SiFZi5stVnEOT~O5~VcAHhs5T57VI?>f02x+uxv5^daktRMeA<0Knk>Ki{Xv
zpYLu_gDGri$Qy^UkK-AhJnLv-vDtOz6%2+`y5ek?`2${MB0XJtlzGJI=e;1|wS$v;
zKmFuxi1ry&uTZH}+-q3335|!``@#|?$LT)9e!#Ebl$tnHF>5=7Jm-~19a7(O3Dhu0
za%zc39MS)mv7)2F6CBu@pM+3zC^Sc(<(y5?`C)U^IF}sz%)5&71vmcuz@;$MT|xGs
zR(;m;SK`7AN^HK<6tR1PBEg*$9=CyHA`(eO7YH~=G^Zw7UVvR?@TSG8V30Z<ZJmh{
zDg;lYj;KWN{-<*J2Bp_jSO^z_VnTAyBaNRl{)O;I#?b<ITZJ;<2F(~ul-HfxTFxrx
zJ2(#EE74jChFQM?Cl)#n(f^Apxa|B1LFP#JcuQ`wpp-PMv(<}Ve&4R&crwggbEfGS
zEYP_8uopCCS>O=s0Lx~(cZ$my@q7Y?R6yljq$cy61lT1C#b(VFQ1g267L!cD<a{FJ
z95avIDf$z1r-KIbt_XTxB#8Ko9os)vEJy#s-nA(Dac$$&c(NsuQ{kDn2Uk#??BB-M
zAX^k*$@+pv0dv%fQ)7!&v`AOQzi`{7u<w;W$HS7|PC30-5zvOYP%Dh3R!&J5>uh)&
zcZL>kR=}ZHhO|!|Ow&z&@ojmtgFk8s;_{B*XyS;zV#w2uOYdKgkG>|r<&g7ej)h11
ze!N+ScBL$UW9LSBUIz@aivROU{KcV<`_TE7&=Hvt-tl6hS)*C+^~G3n$pHxwbk1gR
z>pe~{T>fWhDTx?2Wa2!S#RF0~lD|sjcs(OfKUVCMoWp0?0S*M#B#=*sj3VUX1NZhX
z>wXKGY2ts2e{OaRuFza1LC-_Tf_mRwtZrMNlOnuZIt_kRo_P!~lyD2JzmpIM0Ae1$
zYx?|J*S+B`1gcm1jJ1C)Ti|(Y5?reP=*avmx!mQMUo3y;+|zTPIL?6{cW8<TH~;Ja
z;6H$?#|@LX1mHJE1=QD}FY^LTZdP2?N!-KC0Sy17mUn=9P%gW0%^(a$C|uKo-(Bw{
z)OmW4cLKs_cL3*yV;WLW=ud+Q_8!h!+2ykNW${RG=<YCNnYzscBm~lhlOn*V&?yVL
z%clM=i!&)11f111x;1kEXv#(cLz#LTMRpt>-%M&W%%b*kef0E=&>m)N97~-(Sl9IP
z`FQq(I|cCEL3F+WB$R0=Af`SO9k&4D!%$^G(*ea0q|8<}fdA7%oXt^9c1h+jEGegV
z?DeX_1zTDo2Ab9gC&pT$QgW$^t&Zj+$Fw%Ba<>30WpDH5e~~+hX~Xw7-tU1{q7#gJ
z2GfU{ibb;M%?J8*zz1rrDX(ijg3FOa%hijbuf7)U6b&T;)Gjubu5nOsvUcIH36?&k
z8j(D+dpdySaeSXD6om!`Af#d2^jJlNAs?{}G#j+$;Rj}g0gr>j@kjD2^12qPd(;@u
zvK_t96ih~gGwuDe^H9hFV5{h+4Pt^$uWxL&3~zH40+JLinQ4$zap+fVD%wzCAwy+j
zyoFXiRK1Z-bBa$0mf&zjv#Ww`0-_~iL;=0`=*(|tKVvDTjwK3y2Pg(^M)C<P_Z@51
z?&wX90jAi0bg@`);?!%bi>sU4zuKlJ<i+t<vpO%+8T#UW6wzI)3xerf&DjJGd~cLF
zQoDhl=+aQlS(g_VzOmy+@kmAW3dTHx)*czxH$`yRBOwSBmPf?(7-?DLd}RFRkve2A
zYi5t%0$Y>Cd9Y{~yO0_ooO%IDobEVnhY<Nh+xq$|Ll#YwqgqXKRM<*a_L%HCvOqwy
zK_dr{NfKn<I5P*b#Ok{%!WL+@Oi(u~0HjQiz<Q62e1sS{t(^pG(Q(!YNkix~C+%fV
z^W#P!A}H1%pp@oFDrUEqeUKj5AbhUCEHks=2htS{7aVQ~bNFrJjyRHPV2n${ySssH
zorOZLA%e%5;bk^KUivV!B!l-Z7S8T`&wZURmp%{_AkCR-7O5i1feSn$^Y4x{k`skC
zwMDw}+gdm=zoRBpafk@BXOD6g$r%BiVw?WD>7Dl)%;;4pgJ*B80?`c(XS=3xeX|Dq
zSSF+93#Ny>N_?z)(CHaBV48aqF_SqMCZk6COuw7=5brPdR(ANoDtEs*R(34peemca
zfB<4ZZ6XV0nByHW;oXed59dhd<>ZW``(m)<`j(b*OKBco#J(?tu>Dw*yans6O5OA#
z($^19mDB+abXgAOp5l!Rt%p%3=}TjE8hJ|SlHrkO8sZMZl_`SDo;hINDRQHJ48!*5
znEI~WcpTy1dx`cj!vneb6UD|+YH*h=8NRFc)$WpR2isondrp$39X((^#-ZzR55<K}
z;ozB)!wvuHbWFPZ_bB|Pr<l&U26L6`-9Oa#c<s%{U-!Izz4Eq~*)l0z?r~xBFWbX=
zoR5Uo%HhsXX;}|4iHG-C!G<XuY!P-sjkC;;uY1X&l^SSS%2!XfgYY#t3|EwKXT254
z!7(w)-gP2}B!_Zxcy@BZ-P{@sW^C7__XRbB3VlF}i+UWf(LtFQ{|02JL`Gg(kTpOp
zjK$!Jyz_Gy9A<O7bh#`QuKnxz7TM96qvP|F(`h)c!n1E0lx~okdvExC?cB!F)opbU
zoOF2@u4q3_j+kteKFTK2J(^A=d=LJ|A;@CvWcg04^`DW7oWlfsADY{7`TjwtYRtGP
z`kpDvI-vWQOrP)<pYnbc*0q5C*Dv-k^5Z1io^9s!wNY|n0vUa<fb;+aJXwwJW4)!=
zpq)|L?YQ!9sDoEuwD%6&NuaZDKwSlucaPv*?Jx_;7n5$#jz46x?8};Ng;TrcWk`*J
zM5Q(1*dGcPd`KaU7-`y#uIy-w?F)Y!laYEHn3hg+g#@d6_W6=ha-SGjV!FaJFOVSB
z6mEhyDq3!ee;ZDR^~&_NQ#eypFbNnFiYRDaV$D=lFoMxt+ZElT^(^n?qqv?q;eFw7
zil{(Ubum&WKP}1=IGA^s6MJtbqMYM6hsHY{vD?8sQ?wE>xh^^evtotUvE;iwg7l}W
zV>X1dCp=L0Hs@RYH_<qxLfHA-oO34I_Z<GmBjF}z>1}Rr@9f8->k)Y%I|@3<2)V?j
z7*&+wZ!f<H0XQ@*{q*!<5?kdSN2JKtnYw_6@p_R+7eRk^A<sB578%fn_>J3+gl1QX
zaH0O8K7iN#l@F}?khZ{{A|BN9(5I-ZqWaQ!=Me|{w2Ug7=g~Uuz&~XszL;~-Qb8~>
zApEmC7vNbdddscu9;*w`FbRf>FmlXO^(cuETzND5Bf1*-+KbqZ9fR@k1dhax1HjIG
zLQ~8)>7`k5juKX=uf0*!{n9KIl9fH6Sw_02e*p{jcjzm|z6mVUgg+X}^?(z`E8z4j
z3~@(G6o)i;^`E$cLHJ2%V3;Vo)WhaHCGoOxFe|it+yOoeY`;vMb*1e?!4CPi={jug
zbwLdJdi;*C5U`<yeyp+aWXS5{o@x4vKv7&cxMccnCj&v;ejjJ{@a!WlTZ0M}L24cd
zRZl@l3lC<;52p1`E?{5}%r0MU3*0^lGRnKgMUVS&pijrWItdG$1~)!n+0$RFNNw6U
zd|@kiX$=&{&@~4kh<PxvmYL+Qx40VFq4MG>sQd(tG}t2wJ>u~Jl~iP^aLdaN=c$j=
zezv^$@ndNvIvyNZ0vdVEg7!R>Cuw3ml*?iEfo@)IW9ynGwe$bWhEw*N^5`4`u?{A_
zgZhqjxoHH9wI&?97~tIo&?TmA_4ZixrRr9S-f~xu;@+(z$)F-Gt2}!o3)bqkScg>X
zSrYF#bdVcq26gT_wmS|cT2~?Za%9TCchg;$UcYG9GOn3$w*FqaE7Jo*r|`tOom^4f
z6*WMFon0Oq8}#E`iU;ZQuG(P0+Szr}x*x+-?)PXl%g%Or1~!mLH@>@X@Gk|O@;p4q
z5F3Ux6Cq0XQ<nY*X>x*+ylh)<NfL%%S3;Vr>TBzktLpDO+_R1~$tdb?%K{<nuB=}&
zpBOuA$y59%x4yF1BqvIP0d<Y3ViW~30pd#NRrRb*ApS4;Z&bx%(Nd_K7{R;oeF~~2
z(J(NJOQ$dWG{VNOwI;<a1^sdS0O~r)TnLw<jSMPx&l7H)Eb4o|Q&R>JPcM5d0tSDX
zWe)8;x9J~qEQ;BIh&JES2C_B~m+vBg1KS`PXx|cd!t&PUcV*cT2pXX@iRDvt3k7$(
z6@fJfDnj*R3ax2NywKL}2qIwl$0Q=e*S2c-my#N@cVgRIES}ljP+q+VDhFU@bJf4D
zwbIo!_gKz}F^t5vPPl57RElxg8%Ni%_b|OQh~qzy9Ls75P|YQ5-W1cSrAKm-Xo)IG
zScstv);WL#61jE-3;2>2=|X<X($KWsk+1b;A15KoaX}xfF;nkgFj{6UEv@cL8Ih^+
zh%GMApd^<HPY~Kou3);21UtU+#Oz?9Y)JtZ%*ZaL1ppDI2#-(_wuqtV8Qt}|%;Rv8
zvVu|mWkceu=Mw)CLnCa)0)VCA-T>-ng89=Gs;6>dwjt=po`^6I*@E++Gew>!{Hs(~
zUqOS`9HTYR$KN&RU62UCOQ0zNT<%Sd;pH7!`y4uyUZmB_6AR=Y2mpO4T?Yw$Zo0y7
z9T@n$(!S%%rZ{~mT7Td2gf&H!OASUw3N>HP-t+wG5_G$YWhu_KNecRE3p0Q}VwM~K
z7p$HPgL9Rp{}a_=Q~bH#Xy5t({HKj{q@JNm==;TU@;5)RRh#AYMQMVhiJ%%27NWG$
zIAzLLgb0ViE&U{+nntnN?dcE%=AU%hJ#be5lHWzYE4Rus>wnNIZux00iV&<K2oU-}
zI~Iai#BPOvIh#Jnc^G%bLB9cpVp}1=R1^ZpFgdg-3<<wOgr&#{{of0YGzxY$U!L<Q
zu*K~AvP-K1E}`U*Xr#}p?Ow96z~0nnr1X7NQgaVd4PSnmzRne5t^-qTOl1}Ru1yd-
zy;ObUB0McMYOU|)V_26m@#xiUHq-BW^EmvA8AJ|2Sl1QXv7VU3H#a_sy$I2uv16|Y
z$?HOjV+$AyK<D07eW2OZZTG;W$B$=s_Ql?_u$T@Le7L1*ft?)u1py>VBqHfFWT;*K
z6R3AAmp>=;WqN+o0yKQO5a$JFUuUOff#(7q7CFfLndGtQiI)!e;cF70yR&r0nh5g(
zLWH7FgcSB)%ql~Kz!O^2yY*7{)7k=~cHW$$F){M#zRL0vfJ}L#rrzm6;N=R_Q5A%$
z|92UWiM_bgh5wt}%H+Z)gk^b&ci+OZ{N1B3-0iOk{c0-t&_?T?#wRx`M@0CMV=$Z7
zkJOt+BIGJkG%rQUy>_}j*YK#KKtUzzY1#Gi)vkUQR7GYq@0C3-9R!*j<DOh4s&#VS
z;e4=InwMo;fG#@nou{XQ0vl~Y9WbV?Q?D$2j`lkoQl~C?>dp<`Hs^mPJGKf!{8v+z
zmy;gu3G01T-75V5G4<y0P=5a#@C<{o&sefEcCwRQ_Q(>c?6ONDYm9xyK9;OyFG{6F
zmQr>GgCt9-P}Z?k%FI|Y80NY4{rsNi`9m+GnfshM_qoq`pX<8b*ZbE`4Ej%kNal5L
zEqsl|<1U|)$kfhf_T#Wy-%|@GdY-Sp`Ivp~Y$l16RHK0aovvUN5x+@~@VWS%s7h0Y
z&-uOn?z#EvA}Gx#XFj&gN&%Q<d+^JGb4+$7H*M0i2e>#)cq@1_zuc{s7lmeyV`9ov
zq_gl}H7wi0*t|ZFOVLqw4nnhf?!w|^Jw3fn%I&}$&1e9P)zcT$(h3WYXHdKQUX8nL
zU^!2E6pLSr|B1VF17GjQFZ=!rk9ZYAL?pY6v=XjG6cnti1ck4KgFn#X!v$?@yxy&7
zgRWp9Y;GAm3_Re+EMpJ(EN0J+{d9QqL-f+pJlkFb8eraoj4H5}SY?pJ$@$^`0HXhX
z={d3C`$w_Y{o~%}T+wpE(u+((z!n8@>YfD~S|s3+fKlH?6_FSUx$}RfdccZv^6&$I
zBx}Z_SbY@HZm5#6;9SGb(peN~^H_XQNLbRfiUnZHframc`a7AM|4x%9hdx%6*xx>-
zb)sFIAeTE<rYmi?vArM>^wb++=RNJn&GgZZ1imkV<%Y<f?WpP~p8Esn%J!$UwW`qP
zV~7Q#HbfPX6W=+U_kT(w;Nk!s-}Cs;+vERZ<C!<S5`s{zTuyJH4=>4-035?PYLj~R
zw~*V!1#XeBZh@tm1v>W<Dmxk>klx7=vfYgwh&j+_GBA~AktXRUwC$eo<3M<M((Pl|
zTZL1g!5VIBT=vsfPGNOdxI&DhK^-?U&+cT@$A_eok*y0{LMB~ALZYBSYZS904`9Hw
zU~o}Hix*g~P8K8pgM9OE1gMgw+VVu0rmQ<KCc5h}kkFH_^RJy{^&p4$|2IyK_g3)0
zjz(#TXEFcZ_+@QVKxl-7+VYI;$srQ>$UQ<bu;(oxyFyJ84(R{UH2>P@0VM)3k<I^I
zYo0s;APrr>57`RYMbbUFDFBmlas|=<G4lXVzc+Zb<tDI$Eg;j}=;Cp!$e!I3q8#6O
z(zR0Z-;4j_=R4xbQopg%Bw=JX7ogBOQRBs1B}+{n@6BOx|Mh*JJy~bHT#ivNK#N6C
zE_E{kwL#7)$iyafLc<KIS|L)_tZx=@!GLXHrNjUAI-h(V85K%Lo2KmgB(cZQjgX0z
z`I5w1M9vA+CL%&;1Z_uvL-QVhko+5}8Dinw3|2zxb_wXBc&CFLzDHj;*v@&C$ukeD
zq^sBb`l!kvO?6~S6ENtr$C(3+dIhGN5Y78<<UD*%*#eqGX|w^1hL@)UN3LWP@D#};
zZii=$%T#d!dGUW~NKF6Z&fiY90J^rS5Ryy#e)Nm^b&HeRwf<GfUH4wZJ_S$>nL!ie
z#N1-T<@|u7J%u)+rd9NcAd_}STWc$!`0y*aVUOJLBXH1JIgb?K;spGO@}`@tVNf-I
zry&1(B#iN-oe^&l;MFWG?bz~6vc8<n>LE5A#goxjMlt#CW&^^@s4~LwKLB$D?HLYr
ziUSJfq(2aB#poH_>*pF?Fd*8W#G9Z<NOJ8Hb|dguv6j5c>|c;XAb?Cll<Dc^n?+Tx
zm{Nb5=F>!YZNq}}Sm_{_Q;Ma3kDEMw9LFJZ@l@zMK-&S=2u<~)uERhTZ!`?AS@R7D
z(s<tN#lqE}hC(jfr~{=~$$?-N!Mel?as6m1hidPyJ-aVJh)=izHOUrWYMQ6cCa4|n
zQQV;)epo(8vpPDnGl?I(F{oluKw`#R^1W6!81%k|l|yf`WoL5I76qlzaRj`@c0`**
zpqt`O03lg%^7x!|CGj^1zw?qnOrW{zcIy3Q-Hr+;dX}ofO;eh1XsE7U&^e<ew3%$-
zIIgc?7IeK0+9HSE6+N~?tooUu44ELEB?S!j*z6{Xv4(ngOO|QvqBa^cTdZuDHte-%
zDqGm!Cu&_Rj4)nlgr}u=$L?pO8gt8YKe!|=h6J>B!r<F><)EN)#-j;ZuLlo!Xmb!o
zW%8b&RBJ1C5G*s(YYA3s#f~t{Eq)Q1pG{(c8SgZ=k*D9ImzH2ptk_|q;ZD&>?1lYU
z%%#T}sor-LsA*y#dOLkFza>O(mYX3*x?@1mwx>}+$oHv18KYfSN^bHvm{!_t@n*6P
zjEnvINe;~R{_HVN=({IMyHv`?zq<oED-hvR-yn$25T)(t$Uv~DGJwLHLnpFtf1~yl
zEP@QtrzO!W4<&*H=;}gMliGuft0kWW1aZF~S;#<xX}||gAa%HSumjyAF>_NaddPCQ
z$zC!Dbt7kbty<d4GVoccrCI&=={}gLRb=q#6>-x8{B`|s7}h7M{v*>R6+VIA2L;~7
z8mMM=YMP=JS1Jvu67NZ4c<SOcrIZJw7wIEzM7>M~WOkg&&tpFbZ)Kn%K!@&PbV4<;
zWsynDY*k&~ZB)~LV8CjREH-$9%nsLVWY&^78tFY#wD{EGbejQ_vkNR}$i`O+PLh<0
zz!U>`0iDqKPYgm0R9eNHOK#Zq+=GfoFVWsgH#z?L6fQ&U7b8TkP7A|!v0=CM1pqO*
z<E<`Cp#6^LGp_QuJj)=<Y{YMBkNq`!gg5u}V@WX!6qQiV(^9Jb;^2~>7-%-7-4>jW
zuQk}ty_(F*a)bp$vcez;l)<zStQP}hhUcGZRbUf@XiYyhFklJ_kS$H9{lkZ5^;D3>
zi8ioypbZB;A<D?BZg=XGO|+n;aUjhmg*VpfyJ*invFj?#5y<vt#3|3pg8NT7SH^u1
z-?DWqfOZ;0`p7iaUCt%>_hO*5Ubdnuiczdt66f<HQLlk9xL(S_+<)L^vi$j%(D8OB
zM?_3F!gS(tO2q1RPp>)pl+5{O15=7_1nCVx+SQsygj|B$Jr+#_R$(G7tc|*5o3{u<
z(_)idtJIdZ;}Oqh{Pn-b%e;n3k|e1(8F@r4<<<9Nm6%Z=zsDZ0)@u8Vq0va*7I(!=
ztzs|-a9y31K4mLtcpCTGP`Qspb8W3=Ijs>RG?c{jnT9i5HYQ)Cj%4Bk@2e=N$>w5x
zYi0mR^#1sa@6NwD3oO$-$>*w9W)@OG@>(r#flfJ7R)7_fh8A}NuyGK@g-<k(oL4f)
zbRg$njyo`Et*2Pave5S(phqvp^$wZ77r*h1rOBb%a4;UeU3s0K_h>S0eSZcl<EaB`
zFMF0^Xx?3l8|CC82_`Zt?(z1Quf!j?jEFO(=vSLmf)@v!`ZEijWK+Jwvr>r+?cp`l
zn_Zm%G)y_x%HPZQ3FM8Q00wTr`2~Q=A7@inR>+E(Fbe~`iVz;rc`S`ve$~q0dx{W|
zKqb}|<h+)6hg|<=ispd^gA80@uf=%wfAaWj66WygPG(FG?QXI4jhz9jyz}>djK7u`
zdJlTeR>k365M}kI6+cLZFFooM?M0Sf$Y2rxix^pBwtt+WNrm~uS%7jbEcUu*D3=)K
zQI|hT-@9tC2xS1mg%c^1cwnrx2US|SS5X{;!)(B#^Dwywif-{dA~zD&?K9oXTuh&Z
zi(2u%iW*QFj_V|k1%r7jAi;{g&_|_(WLfMGP*R22N|+~mjWO;}nEF?6^czI^BkRrc
z!v0jMLJtuFX1Y0aWv}D=%*|OxeWrzEG+OLa9A3pOJiWZi0hT`Az~Xd!6eeZ>r~4-;
zA8Y$O!~3VH3a1z!P<Q&g>Dc;yJIVumk&a`egd2x~Y(0IJn~BkpLg;$Qk9aRQJ^ugE
z^Idt=bRP|XAm5Bq3MLq2hDvg)BY{Hi>F_?78%n>)9mUhI{TwGZ*7n7l2cG2qEEFy(
zH%D^a_x3;nP;xQyjPLQ)mA)j0va7Yj_lfsunFW1K7JGJTedOZhU*?VDHM9T~9ts&n
zI3~-*iBJb`&dnco%^$<M<_KNAx#F30980tzC?ytLHeK!ZkD52}-j8QaoKs>>vVF6J
zcB5J0)6eZI6k52K+*J2Y%$ERNI<OJOb<H|XU%=Ay9H@z*jusaGkC3-%;x!pH&I0kd
zcC-R#VMePA5o(_RvSV}ehcWtg1L`KDWTOc@hj<;uUFUlE-$s9o($?~!ky6b)qRtUt
zC$Yb_kva~hx^rXGUMf;YHmD*U33G(#n^<0Vwe#`UsC0Lm?slKy-X&Ru*HEk|-yfgs
z?{RZ`<jXN(hd|heN^R+yhm!C4u4Q2G#P2VkUim1MsPzz!lFt;k{E^&G?o_G;GT;B-
z#$l}&`m=0Nz~^Zdp2$(DoPfVn&`$$#<^^ZhO+Zo*2Yfqyhr{fkpgrmczFSOj_BR3L
zNH#%s&Hw2Q7E^-LWo)+&NS{1JfL$EC3?_chp2eqffr{pm(q$P6jW%pHgn<)dm^?u_
zm=E+uuhoB=6j9s!@*Ukg^)l?ClUM=SGQspk$nd`)u5a4#KnY;uX^0?%xlX4g<(k|8
zk{gIAM@li50i5D?y({d~;=+pcYl`0<5*aJy+}P2R91PI)hx35THT5#}f_|wxtgkdj
zYB`(Q_imUNgwidrK8X*>mlhcgeHEW<wy-%YgIH9?Ew7da8X_|ETfZNIoYZ%6x9IYD
zv!`fViNau0DJ^E+sA}Dp5@I*&8g&_O2A!`q=>dS_%rqHLKu(E@q4HoI#l!PRq>;|(
z{<G)Ha^8+u&h6I5&Qd|_AD@nnJTUK`lor_VPwOOk@nHwRw=f4xZY2CAGP&?&cYW_@
zC3=b%Db?%zRR}#7Ei|`~yY2?`F-=esk{f?SjaznuI$h;Fr7|dU)sJFKQhq!TEXQ3u
z2Y^~2ZD+b3n%5E79jgFlY*x<-B1K1rDZHH`p~=|vFlW3^`H_Qbm~-&pmO}Cves|ZC
zR#2-_lhQgAPyomJ9LG%4eqx#q0ie9vNG(W@mcYtq=`dyL{ceyS72(BjxNZJ5Touq4
z2qIIxF5sKKw!E4a*F9gPObaD=w)`0QkuP>+`YAMY$p84#U)+^y)mHj1LQg~egde_r
z=Qc~jm*74zCT>8j0mI%(p;Eo9I)dkQrugXj3($cG)G%05<~uo>HmS1o85mQl%B02&
zx<7cP)Ko3h^K5!PU>}3{Xnp=Kg(A)rJcVRvZ+QsN2O$FJzZZEQ%asRUz)E@(>~iQq
zkX*+^@iTbR`U6vmn=zYI;yEOWl=USvhx-H*`_@BjNvQE5Jg?{Y^-Qu8A)WDgRHux}
zdDFon!W;4XKTUF)A}`J(MsE4&u=n|X7N%($`r!Gu<XU<U;r`D)ru$?dDFH~;l}(XF
z^U=<^NK&a}pzH`OYteenmA9vz6aqlucN}B8F2+~v8dlSAIsP!k8D~%SfgoH#JyfCy
zf`#r_!cxpsJ~M?K2-bkqC13{6&5{Yh`?ErwKIre=MKV6j%;qQbMVU%=u#_qQ&fm_b
zZ9`}M&DHcF5Uu=MJb^h)k(~($efI*phDu1)zQ$N^YrC8F{vVI=MF@;aegF2W7#AeL
z=Injo+JvG8rd#G`gVNo&vMEoEvT5i+B2l;MzCy+GI%f`Ycv?@hVT1Sd4HUN`mu$6u
zZ99Tsh3`CnS%UU<SugR0LPXp%{(51S-yF?#I&8X8`zl>t(%yw|O<BdTHLgM%#tswn
zpJHfrI{pxlC~3Rwc$p{EzkkOm=ku+?Tr)$d`&i9Boie7Jh_Gtoutw=rK^5y6J`yYn
zrJMJ}|72|t1prTA2LtH#C^;V^-8(pkK{=l|B<h5xxg<<-s(UN<^0`Qp3+v=^i8HX=
zbK*TXm(n~csDFA5P57ptCcze<zRPB=p?)=wO_?_;3~*l1`>x$>&x)(y7?QAPqBE7w
zpXB~eaK4}qw73C0?{Zndd>E8#TjK5+JQr+G((dqwN6;~ADIO%AK}pTD%Lhs4RB*27
za3%e0N#x)?1M@kg82tABT4wV?=LAAUoB0kolB7N*B1~3m3`;6BGd6b|70twxVSFOE
z`hRWBolrOi_Y%3<!bZHzlv})8fc+uCps(mr;;Bu!FsGOQaWC<JAi(jT0W%WV0k3`k
zG_nBf;{CjcBpD!1dvb!*11$o4GO-(^`Fszr8`7^h1T{ZUM=>POkva-Zu)Y8L^!Pf(
zR5O`Hrn(?u3{Z(sSJz2e#+q<?29mxUP7wePfPV8#%F}E+^u5<nP0-jl=Ik{HoXe~Y
zp|)@m&z#%~<oH*KtMj*VsW_{=j-_amXatU8BYiTACw32=_nCnk1q|T5%b3e6zfJ<8
z6#!n;KNI9aJr1{6QfDmQ9Hj1d5E}q$J&8Uz9(Z>*Czj=VtaZyjJ%H}QgWoCw7zNM@
z$xch@WTPP^kg~cm-GH(H>xrQJz#yw+9#0`<NJL*Qr^4Lrjh-o|yNgCZ$N8~R&u2R4
zP##onN)(WW(ba1srYcQ0v`zj!P5$y1sO6w{30NnQW8E}fH#0A$VWWV+DD4iXyEeXy
z>PP{zketl-Dy4J3P<QL3mPpodM}+;|s|%rP;<#u`rKzok`+b%?JV~G2rT_0M9*d8)
zHk_1mK+^FjB+-UKQ~>PLxK#$|w+cY~bg4}LFTwF-{zh~Ix0&RYqzSEv+Mp5)AX?ty
z^Wsdm3O`v<F(eTTF>MK|%(zaa#x26ibB6>8RU}cX?oCj(Dq_lj0gZ8a+!AKRF3>x%
zgLq#ItXYp|1>wxTjap(H&-_E#FI*E}6Z{<u{Fg8W&heEtH~G{A1yYfB1!TjYt`-MM
z4lY=d45OF?KbgmvNq18*OjrA|^7N3x(Rw6K^oP)}p}_~^spjC!#h`~5Jz9iIX=trz
zpMcPx`o9P^{xw$^O62Ou)3YoW`qMiJLY!$T&1$Ofo4n^N{O1pOGjgnLO81^E4NX&y
zhu1mYz$f?10i8W>a&`y0V%s1wBUIx}N&ox2ZHk=#qqh>&L{K{7;pVBDf?9L3z|>do
z)7R#aY}a<~?M(|v?}tvVA1_#T%ATZi^<nwsc&|S2G_rjC<1)7awQClxu_3C{&ld(9
z5qIu=vY4gu`gzfO&XwlzX+oC233Y#Sy@lE**m}2Po~nt2XqohLo(L{psnYhwl*FG{
z(*O%8mc{46IXA;4uE*SBJnlwVUX?}TOXm@-=KjdgQw6^z8um&-X1{<T#u?|w6^i^q
zq#bW#?}0>bZ|4}Z{q*{Q*etHpLA+(4&4VRfl?Uh8-%eX$@5e&lJ@Z<G7hIb1!HVCq
z@_Wen#fPy{sfV2Zh|b^4N_Zb_YHwu{<n#;c^}}dRUJsgef)&_Xu^ZFfYTQ9MTDiPC
zRFO_rrcpiZ+93?)<CfP0esv+_0v9;#-I)Gan3Y)`!g3?DPQ&o3+*(!2A5aq4Tu-n(
zi<)KhTb`&*K;H`l_!s)W7|c_%!<2rTpUj^;IP-9>B(1r(^EuLoN)Qd0AtAUV=td}P
zVXSoneYIM==X~4;Q-pfAmVo+3uDEUgo|8Jac+bM}VIp#Ya{f{y7G_F87#dpg!yp2l
z(3{SrG$C}buqadNFiAjBS-ShvwwLsn;WKy;K4ne44*nO48o<1>_t|#mha->g-QWEt
z^coMrMKLg-$oWrfR9%d#Av~K+!38-SVfR-@jOp&QwyVVtJqmJvR1H1q_Xej(F_p=K
zlNl()X*4zy?QgFg3mS|@fQz?Suj{&)J=tJ{RvbqORdjzyb_-(oL&Y24{}yD$p~AB8
zJMi4iWXAZT;Ir5JCw-YxnrF{QGQ7?(sP*n1h<aL5YNVO_&1{Sl4krlhO}`un$t1Bg
zen$%?n)f#xi_Y%e9REvc>4X_;)tL%1Znu3V%XiF!9tQHHf1X&@L@0ZH2?-DMH6p|l
zFeH6Z5;L$8QRpoKJ!q4^V@+Q+F)6`1X=%h^oiv}sjCdzuCV=sBw6TYj6w5e1ldUxj
z@dC5cGV<dg+A~MJ0VFnGn&r1WE|milb6I_CtR?0!Kq)zc#L<j&w7HfeT6_NtGRA`;
zr2`S?1xWi>{`1}ENquO}DuC;jjEBkj1G2D)B2ltf=0F@SYZ)IAvN&<9a+B!VL#_uB
zffhKp-X3O*H!f+xLSBb*KGlFiv{q`dl^PVNg7>PSirOYc{Pa>3`{SK3yqB$PUGU~k
z{ViJ%O<YGIS_{EjiVRRl-kmtDsswU2=Nivp3IsuVXg6{eK|N3c3?U2bP{`K1nRvS<
z*3HP1{X*Y~$Us{)K2i5wzwti5U(a#H&2e<bJjHx_e>nNW`6@_<5cyq|oM-`<7>v@z
z+b>_?o1x;8mFCrLjwNK((_A2EaE;e88Vs_Q0YQ?=P8x{LUB4w<HL&c=$LA@dNH|$<
zk3p{t4gEtQ<BoLmQ&I$Z1{-LMq?NOG_#Q%Er)F^$*qHE+uoq}iVTFLN;HKp_LFNGK
zexOhDN13e-EP+OcvFJJQdS4uaeg?{y{Mrgf?op48nD2Rd|0DMgBf2UpH|}lkh#Kj8
z3c2HX<G~W(RL(u*w`1;$l`T;Ts>ma?ZR#T31MC<eDWFh6#+t}D0Of8wfK`_SSVJ!0
zlv^+ttLx-aSLSAb3N*VB)T;8m{kXUE@VE<EBzHNUDxfq3u%S%@Y0R)!ydr96tEK>F
zi~iH}Yab|;N4gQzn5DAVo{o-xs5fAT01%Tvdi&_T3hBMgu<og&Z!S8?Z!fRXmm8e$
z_Vaj(?f+=|qmT%*gRi8T1VOI9iHl6B;uxn~)ja^7C!mrOfjIF0!1<Hw<$yB%knlFr
zQq~lHOn25GR0x5v_;lDGE$k*ia}{&_P3QFmkFR@YLSBaOYkutYf4x6@MmAYg2pI=(
zy4)u_`^i<TK_BM6dQgXAg>@Im9w6q;ZyoqbgWMfGWNYFg+u#Y){+a$Bv$B8?tH6fq
z;O$+Yi{}#j^)%u`o!9Nw(5I3CW95z#fm~5^I<R^H=C<9N>q8w#fM%CyF=3&K4C>bK
zuJ2J;YDxSjz7QwD5{1`75u=>D&bml{sIJ1M^rfFn&}b#xY;q*nE`0zwuDEZ8#J>)+
z&5PHN$&c@CJ#@ZbwF<Pv1O!!K&R&3d4n?#j0oYhh$~P@<1jp;gb@Yvi1or{+fJ#&a
zp6Tzv4=|q%G7~}Hd<V}Sy$?y0)2;<6KxDh-aQd5@5zMHrcv;}M3;+Q=gTb4tNnWjW
zCd@6!^l;s!_d4y=W0?R1;snh<p*VE^{j*N8#gJ*BL=iZU?uLb1!;Kp21L8%p4H>&t
z3ID=9V6yvrl;@%V9$9qyE>5TMKB(&8LjTlOqK!>M71a@_B@~|rAYDMm{`C(Si}?Q-
z)`eq$JjcRE2ZHrGH>&a#(8+%R)>M}aBqb(csA$1Quz_GIkY3XRDaD-!-?K`QnQs>b
zr6B(40+8{boR=y>ACS}FG*_#^oG&*+wVtY^Xh)Q9Qe%eXuf0ji2)XADh?>s4?gj$G
z?N*Mn2KroBbc~V!_3!rH(SZLD5Sl%wT?hO)R3Y2X4i`>t(=iuXEfDL?sMiIYz5={<
zz&WMSASkUN@Cp+KGRkKHK*$L^C<z9_o%wWwkSEGpI5*AM=EcRb2tz>O;LP^fvr8iK
z&P4*vRHhrY_V1nGIb-ImO-AL%yvpOzn%`gB%980B_r`BjvnUG!f_~u}cW4>w&+wnt
zI~^`{X2By#@NZL!2xzhEd{@r$nd6ty{>^+xb?hFooN5Mb9r08k3M5nk<)D~6In;wR
zBLSPE`nG*4UhMTUVW^}pTJ#TKDDaQ_K7chad9qTS$t5Rug6fWwxqcahlOFJ!&Uy4u
zjU&?ykR#~Sg=ZcD%Q3PqS~7?+9Pn;B)+Ydu`g)(zz9)3>{I8zn7mSM;Z^K&trHxP6
zg31npg?oyC#pmzjZY(+zuf9bHRVLm85`{4rk?%5a(YJvFbtU*oPE;CTND;<N>n6%S
zDgww}sNvVeGoO>>z7G}Qv~u570R9#-)q=0VYU$V8Yf?*8d?mS~5x0`s<+7}*I6fK>
ztTO%-v#c^c-TsVt6(Zw*RY&%wcNwVg%G0zTxMpTMCnpZ(pFd3=M3<lTx+7ci_4oC{
zJF?PJ9Nf{qN$;iF&O|k&s|t3U-6HN->%7pf5={JPWO<L6+*PsmeMZ`?VcT_;avG?D
z^SiySOzA^FXM&!6@Y+>D#<C;fC*n7@AP(5sfVht-@}J04c<>X(a6j>^kQlwr7(JuO
zS5lvnle1*Z84#v%4xSS8u9NOHUae~gS2+TxOIUrPHO!yFSWjx2;r+m?W0)S4O3WvE
zml$`=wG%qF6$GFC?&FQ0>r{udk9_Xdo#kTxb>lLk0H~{_yL|fCbshV(Y;*i;+M7By
zTl)b4r{^~u249=<8}kbWHn5O`KlgmAwB(*lV9H&E5S-xkN8slD_9seD)fg3&)pv`$
z%TsvaSfBu)>%z%^2RyhUlWdr|JdP}>Dd_$1!rp#SM&>b1E8R>cuXN!Sa~!v48ZJMn
zk3Rg3dezy~VfBIb?CYM&Dr@u^Bh)};PV?>z`k{@jAN9$xT(2?FYDnhpmIvbBcJ`{I
zZtGaqW*nZM{4RgBA<*%e?2Y2=iGtr_-#9#at^O?9Ni1wW+_~<}#$xrC`-2Y2dUBY?
zPiM0As<PEj-!J8_w9wL=hVt<Dx;ffkO|L^I5D)XsBm!)5Emy)2Hl)?A5OeXAGKc3c
zuovwtSuPbs{VqN`o*35@BNZIIRX6$<P`Q2;-oLNr>2-ir;c|*mh9{c@r?<{B3h9}~
zEsjZs)%i$HeQ+@s<WSg`($dp*Kg6&EB(XvixaiVq+w3-IJA<0C-9Lp5!}R1X6|#Lf
zD6M`a*LSzu>hzbDM})r7si2_ezlxc@b~1ZN6~0xt=)xZj0>SSXRV=zN89}<{HFrGD
zymR6<Tui_&4NLMR9^Oq3_XgZ8YlxbAdDe~F+sM$%BcJ53c_TM-O^jnyQ1GPX2E#RE
zH}tTE0G!GRTXRI6Ef16su!+oX8nlU9q%+3UNb^8+pwI-5C0(HMU2nq~ELyxq#6W$8
zUkjtn-737VaS5fkxwuiR46|%iT^-5GUfo;_;Q7Nj9Pl-f@hP(V$b1$?N+^3)s>~Hq
zd;@_h4+@~IcTdW*6c}A?^hIVd`A9SX3Dpz1Hq44ZACLzf#g%9K+>&el)Qsm1gz-+`
z);{cZ`ixYR4~c^b(vfcSass^<2wj`U88K0XhKZ!TcbuEFW-&3bDwImwwcKU}(OWzf
zxf-jRLfsjxR32aJ!G4oZ^)??_jH)}QiRk*Y%^mT>N(9ptqhsi1`s!x<w}n2~w~d(X
zwbj~^tOX1)BUMin5Ah!xKxLOO=lm=Yt}x(HWcvA98?wUR!xO%?I<g<&zAs<XRu6^o
zi?EVy6F#3$OV`#ARAU<1%#ghuTC7<?lT)OUP1hZ4FCu?ParirrT4IAiU@}50x~aRC
zqUViRiFfHF$0gp34iRdMw8Tg>@e|{U(*DCEv*|7Ij?f4t!JNg(a!}H#k-4fAEKPW(
zyzoowbc!$?TTBQK1BmgxM57kyoRwro($FcVXu&W)G`3(LM^*k%zq1gT@-@p#i91mv
z;MDhl-ubqm334>u*qO#D(B@-7KEp*GtwQV~#~ll=HG28RZCbsS)OrE~sLiw()V}{a
zUn?f*zVoAN-}{Ib7K*Y5UEZQ&PKOJ#X8UTWkr4ts)UJ;A!myRl$L(u&Df)~@i%h3;
za48c`A4D$Rc=Wf^i#4f7ngUXn@Oe*BhFb)+gu(O6@+WK4=YwwNX|s*A94)^p+&eyP
z=i7*UPq&^g3T-j}ySE1BahBH;`!1Q09QqPqd57E@iP?3<Aa5;2g%M)4o>A`1jh=B7
z;pMVk4u(r^Qgaa;UsmgdQTZ;f2NHYysUJ&o`l|fN+q{1Gymg+f`C!|-q?4(@D3haC
z1LP}3jj%)C4tp(~nvvJzOmk}_(F%pnOND|y-3eGzaXFKuqr|eMeZYGDMejK8S(bMF
zQtKz%#`L|}viW@EIuNnLk~AH;juzev9xKVo1JP91i8+D!hUQA$a;T7t2D&<~ni{`0
z`mvy=k=*j2R1=-U49Cc0?sw@eJgcD(o_Y8q(JxOis)1_Pse8V7|2K1XEqE(GOGoQv
zWV~r*&Twvn*pCl04G#P*Jyo>icl?iNzs~d2VYsDeD|J;;x@u+5930Q};C?pxjZ>2!
z=p-rz(s>d=QcQi4Nk*o$S2W9;)m)wLKA7YSNbrnAH9d`TWT^b$1g_?~`V5Ome65L!
z<A`!s1#P+u;d)RFbouw~PgVBJ#uS3&#y{H0hf!%7{oYo$v1u>Lfy14%uKb<^4He&M
zi5vaWqVK8kButz41@)*z$0IY&{~(b-nVIbDEupM)aYgikNM|m$R-#%i6{P6pvJaZ0
z!J)rSJAw8@vyq{eDz<-PKlVIjF0bw`Zi}v>S|bvxfB3lX^4kgViL~#aK{G1JPoDCa
zqv^gWmGFig&oeN&_q3)@on3h3CjRa8x1QtP$NOf2iU)1yzIpY%#NWIS%H`N&+c|XV
z0tL19dF1PT-dh5fMyT7n7Y=7ta50UU@<C){l#{Vs;l5qmQij~s6{t!z#;v52CoB@n
zEMXAiueu%>{vi<np7JowUnf1<h&LOUw{BchA8lRa(&|*fOQ)-CM_cz+fJ>OX_k8`V
z_^hwCgOsZ|^isy%S!M?=MTZ5K+UlO+3|!1pbM`FzA`kY6f$+SSW>uXP#idH@!Sl^%
z%<J{U;Uq!T5mCQ<`-hC6Dy2ft4j52euw{Yna*fnJRF66K_w;4&5iz`9+6Txln6s);
zl;#x%??h{!Yi<v6XmVAQ9g!4Z8{4Hby!MRJe><tP;d$K8wD5$Vs9z#?%R<NC7)nXJ
z?0i@pZ;~Rkf~~3ot`A``U+nJ_7C*^o$-qc?be|S5lAD&Rdv25gC&sn!OC5gy^)0N_
z@K*f$sZR<iTBVq9x!TWa2i~Bly>;3Z1$lX&yDC`L$bhvoAP%2rt$$M2W!4LHntjbT
zor*$hxhtmO9Dy)V+w)cF#+=?_Bn}eCgvo_Zty-(y+g-cwTP5a>NO2uN^77msD!F`E
zXmf8zdnAsG$>SN#nQIloa5NY@;spBDv&)sC_iNoI(;;VtbA%&Y$LU6$Q6q79501vq
zrrj=(MtL{$%wbH*eXG&>MCj&ys{4>10n^`|N(3`g9X3#uV}p?rWNP$rMN9B2l`|??
z7@X(DPE&F=K0I*_aYMzV`}u17>}&}#x}-jEo^$oXW3Wn5_$IjogTY0FgnLV8QtSx=
z#s~PPOd>@Y8bh{*>&2UdjW0O&!@1BZrKTQW3xYj^knd|`JckPjHV!d0P|4zySor7?
zIoUfT56UK<8X`QN!<?kK@h<;f?}Y_8ZrhAs!JpoYM`}>~4n0X*w`-2XGcnE($a}d$
zP$PgJ2Im_!=o!g*i{j~;H7Ra2CK}<zNRau(k&4u9j_2&0JXqAHQOP8;^hofj)qsxi
z!L>haT2fteKY4W5x@ZAj4;Wmpb3)gt-vR@w^E5Qdo^kXQs9t+t0#BU<`2-$5`(5{{
z_fn=Pxm)UHh8S+S3wfi_W6+Zp$Qgt;MC9hc?%s57Drssv5VopO7e3dS?6MvPXivs&
zz2m2Y%sA~P<CA4J=!RTIjg$zwq@(mJ&Cy+BbdoPNAj=0mg0Sw(bS^8==Tv^?Gn|Vj
zT*PoK%tx2%>aTg9BXqm==`~xqlNK%UQsMpbLpxRn<C@%8ifV1}*9MhC(GJiYYw?c!
zS(X?z*=G;0aC43*_d{8i<k+NO6E#hz&6s|@EUL|a1vY4&K;gWs)ipjAe@_onwmapE
z=6=QYB&jxOkb#rS;)%_z&V0s%{E0KWI&2qx6=wK?@m_4JO^cARD_Fi9-NGXiETiDF
zB*y35b#d!>deL8|Z9lMgt(hW1a~y95Ud+%eGhX@LkqHsu9=&hBAZ@>tm-nmLa<IMA
z$Y*Dth!$J#pxE+0Nm-EMja$FHdN+}oeEZD>p(jVW-6J=;3x|)o*5dQ&0&C08UTAym
z_2P8tJcWja#)$Zw^O^wf0Q-KM?3dbMUiv}N9^8d#o}==P;nrDyGDdyX;Wd;>H*@tC
zij*(Py)?A9*i)oU4r_RfdZYYp=FXpm4o3_47R6MuiQneepVP6b7f%y5tG3EuvCnl9
zsA0;kaig!|@-w*0vbkQotM-5{9ZZB|kX9q0?AJ)3bmh{;pX-a+N^@I7uNIetrJ{V!
zYrZ~nZM6|oxt@fQ*a;*$mdtG?{soKJ2}&c+#V2N0jP~i3PTn>w<XljyhwT)yvU7WM
zIoE6yDPh7De&_YkbhgM-IcLA>E^P*uvvtz<^Z@(=KZ$4dx@lml4QsT-@?WKHgK_gu
z%aPvEGTlEz78D4K$U$~q+X{XSvHQH4_-p5J!V(d#<<W0+`(W3RES++xvU#aO%N={D
zs0pT}&Ha*!VocDhwarNNVsY-#N}~*0D8A_de8u;MH9xTgSxlF%)G?X5A2r|hLRZaO
z0%z=$#F@@KEl{P8uqMZUGWtC0m?ssb(%YlNO}Se)7l+sEXa{3FTeG_lQ`=rVYqSf~
zsx&)U;BltjT4>yC8?Tt{@D*an$N&m@V-NYWEk>y)bB@sJSll!j+*<Epu%d6%n5w-X
z)!P7ZY6x$CC0-(9$kW$3v0{9SPC2&`aEnlclXO>>noAbl`nfSAxK_%wVP#tlw}izS
zOx_3Ff}q>aEcW;dEJ;bqhJpo)8?EU=+gG<D38@4h+3feCp|y<f5Td1L>7R#2v}AcG
zvDULp`xwCSfN@WoN<4FX<Lav&R^+&)e;-`9Nm%^E3?DDiCjv*#?T!}JvqT>g&>B+S
zHWXp_`JkpIHLfi&dU12|7#r}iQR`fUU!&lPT6m9MGQGGVS%||0OSzU-tzZQo%jx9!
z)AaUfORH=6L0-wnAiP;P?i9B|HdFB_Zh4lL2+TX3IFMlw8+q!~yE9F9Ks0En5g8C2
z=t8k@{x_#s6N_L8TXyx8*m5-JB4oyM>7s;W$KCSct)*;Savn&TxiCJeH*-Vyv|5Nd
zoqz>Ay5JsQcej$lhcK3NH6*cYw|bt+QZx6w?BO$p33-tT1(b@Vp`R#%Y4eK`&-`8*
z7&fmEV&lXZ-rZclBxkpR9(RJ)pd<1}i>gnaWVSUE$aQAlHzsN&pGBtbhi1H5$DKlr
zVl*=+G1)82o}SERuz&$W`^!<_>$g%8_Vd}R9;uCEnIkEn7~!suPN7(kSU97?v6L#$
z@~K)=>S!;=@e%Vp0xq%&fjVDHql8p3Tr@Nu0VR0Q!?%CyfuNPifKU)}Mb&i(O%u*2
z&!C;52X7zlqQX?cT@B)r$Go6>sl@?devL^qJpEYCMnEda+4u<ug?hjcqVX$n&*cC<
zi6)A}m9%*BPGJz^JBb!@>0%G!TEjH^&He`aW@V{-^N4kQ&dSZvYS5=rL%nT%T3Oa(
zahTdyyU)0V4vzWHEPuq+j;dqxI?qcX_m<?#Y1BN<ta~)%t`x>mF@u*(<_X;h-&bPE
zi6B$^YiZ--U68jIuqCJ7>GGL=IsV*yzYMoW4NUlGAY0r%Gcg{uhjLKzmw(c_0T(m-
zJh!*39!9@A^MsoCqhp}d!Lj>CBkatDtcsrawwhAuy**DEnmM;Gb6)0?T^`yK<@EWO
zWtOW-&Qu=*<ifO3$Ed32wScc}k#l>C73a7NVwdCA>+%vVYWYmH6dv`xIxBJZ)VmNd
zn4`yLx^#6cU!spv&#PS@1B1D}i3N>U5V~+bYN})!C>Ki0s+7?R<MTxihLgixQ#%`X
zoP^TVGo`Nc8v1NGv<yGGw>2~<qU_b{fkZRhb#jgL9ayk)z^sR}2a%d!O3ibzZl-Dj
zTlCTpuvV=gI}O4dx3V^fixVexO4=>DU45`<w>Xrh%342vJ?oFJu$0re*TTQ!I@(M-
z^K+}}Y>DP7JkzshW2zoBvpF#B{PaIEi+6-n%*#|iOj2sp`*cVhXdHrzJ6&NHWToAY
zCe`TKSc_^%luBJkIWI^vy6IU9;4<m#V?xJPU#0$ygV4wx*08yDJ!=Dh?G2gl)F(}C
zI``DX9&6)_OlclVm8h=o9cFGW_qgzAm>H`5G$H1SQ3bvj$0E~chTgwR7}u3_DnR5l
z=STt*B5q{Xagfo;wy2p<ZpXNpA}wu)ose8xS5e`{5C`!3(s`vb!tNaCKv!Ccd0F)6
z5(PouQ^$VzdP;Ik*@Molxzu3@XYp`)+rRA>HQ9y5$hP_?CKJanp*m8j1rjA}o{O+z
z?>kL}Orel~hJX-Jo+mk8@^ocmrP4zyImklm<|!!~j{bz3%$Lq;M_VCeCj88e%X?{v
zzVXn#me-Ls>6y`@E0yP~Q44~1ith*wY?b>+vSp^Cr0gIy@)M%rF`jKLZ#(iD-iw>C
zhTBJkTdIt*$Cvg-cYgj-S2-I{WTEeTI_X&at?M_HD)<vUtv9@Z*ld8IN!#3=-#msA
zI<Vh|OYm`<3+04^PS&n34r1^lkL3m=k`QXm8TPzq8<k{|Y&AEZ`XcE?k$vXsk6?yG
z#Vs?r4zd`KPSz{2ldu@Mq&q)%4BI4h0hPfIcNt@}jQ8e7aw%+juh;hy40n+AUB*{V
z<G>{q`5>CeL?s#1`q0!YMP{?A`kn^{z1)PDHkl^|G*rex`ix$+4R&2Lq-wx2eAYMe
zmpnd3ayc+jttept+1)@JLlg_NU0vyz6DcWD!VdH~BI9PG2aq^<Ru}*-Uf%wPbv=e=
ztz8NY&WwKiyzmtroy@6m3^?t4bKeZ$+^hpb7r+Y)?*!`(j^^q3h%TLb>gi{>Z3Wv$
zbyWKV&d0uP+5FLU>UkWGf3w7&Kfj;NGHp33t9Z+Pu{wJ6_x=JmcQ!eetJUnR3u<;>
z!_A_T@Kx3!ikl$iZSMEOs>QBg_+WocRygg63<Hm-&4=&RotfVoeN119*z?@>JW4CO
z^uUifPR_-?dAToEh5MUYMR?7h2WKZ~DEK_z*L=A?2h1oXJcqwqnMJSc{H|kfyVSS;
zz6E{iBb+0cFIy=3kKP|zp{>GX2r*$Sn`huVN1)ZO<2Hsz?)`e{P19mpY*m@np1WF)
zIbXb(>PpXh4t5EF(AkfFc`DsMl%e<3Oxxd^^zCi~Ir?y3n0Guju0%lttMdDXzE<Z;
z=TylmnG0fjS3g)eO0HDNsRTT~>wGRfGN??^?1sbp*%yafJHf;H7D}<PzC)1#f^fN8
z%(X$XwO9~{|E5tn=mz7Kqh00nvBw-FxsY!4Ih#px$Mm&3^;cW>$&zc$eV*JjJaEIT
z@TXkyvWA}PB|>?NJzb(p{rkuZ*xSRW%^E#MpD%=8yHHW$m_%Fn@|DrykFit~&uJ#N
zo1xP^0Uh^#KE$kSF5MSwcR6;vElnG2d;Tft_GmE4t@$msYJQKT+3_uQW1>m}n{`ck
zSQ%yK)@d1mS6Q_GI~Z1srr};04nv30iw%E9hWB?{TnQ*C-omh$N42o*{<yzk7@%)+
zy{F{12aXi0{v&<fsHjs%F8c01(uSX4sqf6ZnLOxMk^QDr(RbHuE20mw85BB_tjJj?
zBEQ5&-haJ&i)U-s?&=)rXs!66#NcQpQX-h2E?-$h{vjrusig25d^FMGvs3NrTLU4C
zhqQuRk*QHERETMAH)g-_w{@;~F*d7!Ni5Q5tvm*29%?=*`<M2hE8O{__#=T4Q{O9y
z8wnO)mfNKNG6e^ohBgR|_V+xicg|(QsGwCSS7}vqG_z!5sM)OvbpbWU&W(~c46;|M
zy_GUl{0{`xSJzu%kUA7{VK@*a&CAy`I~^E>;;wa#8VZYLk-W|khWU8?le{)L3+!p$
z_PsN0z`xUsFMNuDme81nJ}_us#5yY`o?n}`I!uke+Oxcmk>p*P-RQS)r)D=Bv8zOW
zJfab}L8OcBdVRL}$48j%%G^eAk!&I3dc#=RWbM*3(FYB$)u!m(nq4pkLL+B>Nb`*<
zCwWz?(L-kEoujS#iJ%}D={3=+f-BvDF@5c!jeqCtD;9GXgJKWLjM>!or8tpd<9J;^
z9!x#dg@+d=!rC`Aunb-pQx?_hOeOU=v~4U8wa2P%{SI4sJiI)SA1mq=?EIvNHXyVr
zCue49%Zata(||G3*ZC%A_Odv>m>zwu#sIo_<6|B!h>zvsjXr741$ILA8gFraHnxPA
zr+q8TVEkD8JVqIRL!*dXMpz%u{-fUfG1}z%c~MV}-Spzg;<VZ&!7n4mlM2kXgO*18
zl6&qSue<m?7&YKg5GlT$80=C?e~2BV$sl)%dG*90pC-mrzSC&&Q@-8G96nR}JBc7A
z_d#^lF{~+tDw$_@mh_;If2G)3M@b#@Q+<v2TL4Tf)-$kX_2N>c74(nqL`wA!^S4)n
zboR!V6z2A0`cQxghs8qd^KNTQ;HIi++8t%GH=~BPg<tG(C<rQ+c$`h%umXycm^Liw
z<c~I|sxv^8L3BcNtLvzdQeBxdvtK#iKR^oe3-==~v*8V>RTbR<y+cu#pX8vT-F=F(
z-v@hQw@rqePlM?fX;{&;pH3<Hyr8*CEY{FwFov)9w7*LE1^aB{CW^yr*Yc(+GFM}5
zF*%uL^4w-*;sIaFN<Pd+T!7JYyc~4Jv{32iH(?Oxv&T<Z)=Wql3i!oEuui#?AV~VM
z6<p<&n2#@ww{+zb+jWSD%}>ui?$&`D747FG@r!Hqt~a8i>1IFmW=gYoGSF-Wc!o0H
z`SbzQAqBcxlAVHfdvXG!?js^Vckim)>Ipu0)x`Z(@5nv%bgGs_qnTy4x4RQLeYHU|
z4+Pm;s;Em?egM`3YvquQ8&hpXGBn2>*b_jFg8SX#yiCG7cK!aVOBhiD`G-oLov(9l
zbr#9INA)Fq^ozHR@k@4>TV&k*<4Tj=-+7~VVWS3CC-Qp>r1j}qPPDgXOb8$7?j9ue
zOWz|4`wvxP;qgZPYGX*r8kX@<UQPii_PUUp-Tvga--&9__)q<P?g2n8!>xXtUyRp^
zj)f;ro?a$d&ul|p^yb^O=rPfp)5)Li#&A!-Wt)ds%p8FTm$U6LkTCKq!0TuFR{zI)
ztM^+8=09TC3SA-!%GG-Ds-2BnA`*>TY~@bT>A?HN<wl~*u(UR7_phO^VQ5&4BL?jZ
zf)jIEpECrzdExbsZ&kUStB4;IM;31rb3qQDzukyDT0pDGSpIkzqUUQk{Vf3fYvJ9^
zZUXp=VeI6u@!7hZTYrw?hRg;(ilC#4_vk;NvKL<d3}II`K=LoW5N;YuV9--GN(*YV
zIR2pjBJ!+iueQ^RHxaK%&#qeRNUOYfo<<hQ$)s;Lt)_8QNXmq@T=md4(2Fu6Vd0j#
zqkfzHIKDHD8sJZ!t0Hm?af#W^+L^Hm@?+_j+sr@L77n`a_7c-Yyt>?vL5BPo|M7Uw
z6sDOFKCr8nlJ;IF51qlUEAObjze73}G_#`lwrB@-wja3GP(dUs>%l_8Y^$pVzy9&g
z<X79vj>R4wE}HJcHCICxj;Ql*F8PV`R~^ixtmo%un9nz_?~RtdWW^sZQhcLtb2x#%
z79X<|qCPAtUnb}$F=+hM?KVDKjN-Y==AU<I#I4NxdEj@KHGU_rzc0GTVDT#^@?m>P
zoxcwelLosx#NM`fC_#(Q>XNvyV|`4&JaRoV<D1(uDq?T1a!$A-0U6j8->DUt`x{~V
zx(ge5N+X$JqxB-beeIQeDf?bAxVS>%yzzN+JKjwviuX(x2kqUVEhbB)+cb2o%6XQh
z#Lo+gE0)+F_3r#PoWxG;k$XVAKo-Kwz0wh(FJjV84}@*`ASz^Yh%l{*e7C)L^}!Ms
zM_WRKuYlA?7Myw5WvF1V>P(^&@h7p5pJPcI3kv-J2UXCns}JII_6CB-WnQ4VHLee;
zrT&zzwSh(-y@y&<Nr$}*9<K3<$-HmXB<A(hzFMP2W3*=+l314pTVJ)QN>*t99D?jb
zp84Wu){&RXBy5;h?>G=`IaZqN%mEh1#z!3C7SP9f$DsAKO&}*u67RE!rb2~|wU<}{
z-dG%$h>(=IDJ0)Ust{vE8PH;`$6XQ>AMCOp30_bVQK^^Cs9qFG3Z3i!SW@h{Oq)xC
zLrQ7d2re&L5BVRakJjBzxbydqfXYnL56uC*FVwSY63c#d=5DLP*Cs{w%VUYNq?os8
zFBy3Cv$C)xYe&V>j+~1U94%7^-nRV-(?QS43i;}7$1q|D3#6i{EA&oKRjZZZnZaJL
z007YSMfc0R;;t!RyO<D0j`RJM%=lCyGX1e`_V5c?ZSjjcXO$f}A#H5W@xy1UIJSJR
zJ#gIoOIXOvEi_om$+*;$LkjN%B)dP}X!(A6_1J$xuUI=U>v+3j<@skA(Ke6vOW2QF
z7dLb5M=KG~iF*yRK}@s_oP5e@UW^oX7>Pzfy^4JyIwN8ouNc4A)GeiwGn^f;Vx{RO
zIXL8C%B7{U^0ixTq-aeX2<Uesf7s@Y?&Nd6uQ4N6!u3>TISoU4CA0=jGTbDUQMP^h
z2Fc0@!DSUu7RT%@Z*GH;{&~vmYI>4T*roKE>LOfdin1r7ANqpBi)pp<+e}B*UN7s5
zjs*?-UmR;Q7JXX0V${rf8=-sYP3+4ww2N7T6WD-`)dII$hHr4w7cw+qkIQI4OZ7G`
z#@-am)KJIV2E`B|cdF9(=y2E2ZnC?}g}|=U?(pixehZISu;o;G(A}^rh<op&{PeNw
zchoTTSAS%3;!#oWl698!uDf49B{Wr9&spjD2f<g9+yvyN#7l-)Z10XBN9NjtIS51R
zMVY-y=ncP%m^Lxmi=H2O9bZf-N{y=Gl?nrrvwf?-Nu1ku--<v+jwIkBf8@q4%@5(d
zwd_z-ta(GwL7PyY5GF5Afd9u26|`};g$4aiYmRxJ;Ek6*h#8T<`rG6;;6rm`H?)M~
z%Y(*{k+_k$9nF!Ef}`o0HT4B0vaOcqHC;~|&#4NX(l2Mn(#<I|PBYXOHEk^(@Vuy*
zE#vbZio)5n19-V2Hl1(0`CEgqc%?5BLz<w1j=VzxJ5cz<No42kwJA)>qRck()*go3
z9jo?GeUha4;2mPY#A=?fWvAPonXLc&n=WQ_d!01faXZ;Zv?1d@Nl56D_W1nIct?;*
z(IJ=fxvt}&Aj1&9KEcy~>uYABRJt;>ps69;CFNe2ZZ+rmu+*b42L?3(rpPJHl6nt8
z7$*Sz3E-Z`w@aCTh#V2-fg7ckM}rWCv39&yn|z47Ug_*WWEOMu2e9K$UV6JCO$kDj
zI_>e>xnCxR8+mJ@-#sbd-!1}*%vm}8AK-VLRVQx8q4Exjb43W3;}*q>UPMA(Qy0>*
zy57AE@1cgPGp@kfcX(1=70%>QUq;_I5g&=c<Q?_|WJvK=mhHuFgFyKQxbe$iR~>c|
z$57`i-1pGUn!_**!kvjmmzS<gFl2E|iMi2CX#26AFSRBhIiW~jFqUgrD5h$PA$4{I
zh@9zl<bEw=fIyhS^vCE^)_=J88mQ<WPaPQ7_fC7=bi6yUuva2JU8&&hx#x}>*u{YA
zN00JP8SEjFLEmk)UK&utGHk9W!5e5JuS9%2Uhhrfwt2V`NS)g-i9egr@HgSwBmc})
z?RU);^JoDP<$A3pr-4jPhRoZOw6m$L($4cLre9NkC91N7@$ETgqooa#qJ}s0xMHsU
zWdSkH4kyhPA2B3NT@rlqXY-IwBD>J*OyVA=wC@8pIez%5>auJ>0{P|ds6Rz{crEK+
zHbqiH-ADGwFYe--N^7`;tr%rPF*TvTx}yW(GC5K)CB^r2@Ymv>2a09Jgbi1%y?H8&
zS7w^~7SPkVa5w6cM)wtK>hjNp&U0bjo;$yVdza{AMYwA<p3D^Vbe+3&)mo&hifX}O
z5ZSY`O58f_AxV&yfcp$<iR!${JN%NFwhG1Ty{$MLr^3;$$&Y>s5&mwB(DUy)1ScFX
zNhZGwjNcz>cw5!uaja`r1y0|8aTsxr>nwY{!PMHJ4YPVhec<0JqCInr@_rG4)eYr*
zydr(RBuR5I{?h8;mt!$doTUSd#6CiGD9kpZR-ryc+=`<)KBU$&swH&0;85evlRCF3
zAyU?e2)A$j!$S9tFSJcdOPxu9xN{7#u+z|v@Kux8DhsRNdj>7=VG)?f;d;iDY)pvD
z>YBGrz;x|i3yN{#*7sl^h2-O_I*HKjRdi*=i!hOnxYis;`5W-<uwAx?l%*T_?(b>S
z1a0qahhE^V-Fkdsqa^qfUbIJzbNeB;Zw<w$u_EL1P!Dw+(;a*GWduXcW$h7MW7ng1
z>LUp@+<63IuI@dK9)nj|%V`I_B)>f1J}Lw1VMX7L&g<Y3ZT=IcvN8lxukgda8i{Gy
zd~d{&srd7kyIX#*dCV1$kq#Wu#Gs3uH}yam>NU)1q}f3!wO;9L)N&7jw1b*$V#!`Z
z)QUmuB4gXe((S2@iabRLD~k2mjVsF4M8uB4hs4N=)-?02Xwz@wp`Y9JZ|AOUo#!N;
zi=lQ~ptQQD=Jy2VgjVrha**|Np4TpL!s?xVp!fIVG7##!BVR=AU?v<|gqWC(1JgGn
z*B`a?3Typ80Odd$zismQcu%Qk=Ao(_S2b6B)>bj`kQ8v2ADrdJwau%;oF|5&BA2m-
zB;&5}^BqD0D+C4eeh|Wn0xNTVTiX?X{wICab3|h?1hjnki8*{U=v*ZtaiC~F87FzT
z@TZCM)tM6_e}fLLM2qcQ(!$CU<&6U3@XbQ}R*n&H4!tBe*e$cVlMGf6iHVbs`mYh%
zYiX|$+G}aA5!!2Mt|BAL#Qb1OGjo6gUFl*_tPme?>;V4)gWhZ3;wV|vKH)C(b2H_f
zL|{Qszb537gGY(%VjPz*vRoxi$u4GNqJk0$|Nr2NwXMPtJ?mUfxUU%y8xt|Db7u%K
z!yZ~R0?AJ|9~f9hBg9~vf<7zs+$SoHK6(n~>d2hgFFy!qICdba!YAaNaa?F>+J_h)
zM#M&9BO-qZM;!kj2Y{KHOM-adoKP}A9uQ|E?-AZH8NtADKmqjHX{MS_|Np>yBiR4z
z8t>x!vW8^O6U1eurZW|oKje-Jh1-}gA1u+5A0}YH$-mW-Vk-!ELMNLb!LP)`?~ltL
zjD!Lkh!*1qu57HrRs}c?c`;r)ywAsR623z_(Jm96Y;Rm}BAz=t{8i&-&p03qhXi5^
z&*Cu=Jh}bJ-7^9Lv<A3J7>SWX1pXy@HPhw<0V4@HVE9(-{r7t~Pm_!Q1g4(HiS*GC
z)=_ChmkGv)v<1h;PJxVy3Gl>6yhnlzM~M6(;Q~vHv?Ijeo8jIPpvJ+WLG}jY;Lukm
zf=7VF_X)T+%k)|r#6sLx09SgO@Od#Tu{8Ei!1520TmKos<|md1n3h`zZEgAE;qprl
zA@WOLJDHL<;3J7ULoQ3hHP38A=B<y!v$y6p+AYh*aoh|^%VQF9!xD1d3Il3fcu^Ov
zhyktQ0Bd-B$mNI3oVSVN6y=S(sgMI(&|aUJM4Y#X;{0Z3De`o@UkSLhjXllaMXZ0R
zcqri0COK?k@9Ycop1g<u|1Mi*?zp~Q0F;@?MNj#LKy{Ng|Ap2md8pV#&2!de3DfY8
z6%RmW#ugrcS^Ttj?9oB69dR;<415cm8ppx&nj|su-t%H2IkxIfT!Dd{00Q{!1|Ck!
zgb6RvMC<-~u--a*@fesW;-D6JF+h0miR!p+*ROS6mv6wa`~GlfhLZKl*~S0~*plD)
z$c=?U!ShP?OUw;w9<b6UmNH>Hw8*jANJhT{P(<>;GP2Wg!@v`vrH6nCSd!j60XrI4
zBxCkI+V%J2AO~%3Yy1`iONmZ=4v~f^iRFiYl?g071i7V$*q&H@iRGyw>uT<k#sDW`
zOMW~7I}%uU0#r1&_?Ut64m0L&#@V{i$<K&mi}gXL&zl)Q8(j=<)|?oUNcsLFgkT+2
z_dEZ?UbcR8GCQ(2)T6s^+FPIprE6^m;brZcT!r&)3W+2{mwo@^G<ox*1|S0~)0Xe;
zP*)RJ!lc$<?AG<YCjZ%a`RNMP5R+D{xR36g{|uKfbc_AVbdhww@tFlgXBCbtI0NAa
z>4KHS7js`Y$G`sVT*)+cfB!dt7@pTR{^j8(tFHO|p8y54jDJnNEU`}=$Uc6j_+Pc2
zLBA;*aDxBD@}xa#tfY6+fv+TCP&x0W7ieBDXjXm7<}UiAYG3-E4YXtWBiABB<Z_YC
zbNn~Q@W&+8x8E}1d%DRR0Y2ylEQ7M}ni0+7`Ejy9b7R5}tDDB9c<%&W0$hO?fZdc2
z1pHtZ_6RG$^EWjtcx4T8Ta2bKhXoi)e>5c-(frlitMov=-!`=s-2aU~KP@BzlmG>D
zQ#b$$3W@RX>isCv_F*GjfBbzWFU7bJ1U$Q@o!<%BXAl$^=s;C*28p>pCL(@Z(AFo!
zo5EfWnc*zQ2Ebt9wZ<tNzpif%PP4~&XE@oma8UAv=7OJu`(^+EM=&4@3&WR`cB#$&
z8t(QJkK^$f(?k7dtkLha8O4@BQ&-0ziMTv<jF7x|5i^<(_?Lt?-CFXNKpkZkuiO*y
zc+sD&hOWEJ)&|s1gy_eB0I5-Lpoc@hXMN$M1s}^B7S-}XIXO8YHx-W<@Y*kTc#wu3
zNFRiI9+5o2(#1ese|W$Wln@78+&tZ?!l#Jvjk+5E6N2rCcHT~DP>@EziOb6;@=82H
znK^r7paO>Zt(g8NlNZ!Tk?<UASzlp+KmdLVG>_a&00Ypm*AN!ezB@^wG2-khe-{FL
zXyxzeSZ<)T*2Pghpz)6((i_J%7QrC&YH5u_yuELt5y@4>@=d%c*Iy)H<L>y3Hw2ON
zi~r`ly~;Qq{t)Qm<KkDKKkb-+fbcf6!8eR5fHldF8UGQf6sGdfz|RD5>MA72M7_%9
z!+ph=D-sa!1bck%><4Zwv>=o($4ER#zPNR1jt7VMDd`+wq>8Ke+wMnyZ~nL_<qd}+
zzYc%~F=6)&jZ5F+G0T9F<9bpwf6Bi+PyD=o7=jbthaigLc`?v`=ZL}_nNe5YL7$I^
zf-UV`0Wte8bKsUBN<e&%&J)uEX&v|=gdRG9pb_F)Ax$mcdG0d-0TIj7alD<PC*_yu
zetL#t1i_#FXuzuA4!XR(=8b$OT0=pIc)_zxPw{oe&al$@^Ck_~&)0Iyd>}94ImRRh
zuIs*DSchkxqGaKywHbU~?+!BG@?$7i{3|zfma=$`r*sRirc2*89g5HbUGe|ZY%%h3
zj|3RKFStX2aKGf`u83C&awRALkAp$zah$UvM}tmTLm8ud^`PO&-T2O57&Hjvtq%zs
zQq%l>W;PNi4-Lb1%^DEm|HaTD;O|Xw9NnRyiKU$l#7{$!$J!rH;w=Ja@0VWDPn(P8
z5QHo<p@tH${wMfLBZq(lI7C472ejB3|LzH1Jf((R<NMH1#6dk?8}5Rbn?Y`AVZ$8R
zpM-dc2#4p<<l9H&;U*1H+vb#szvARGB@h=LXz_h<5^x3nxDDw}fLAY2{w3z<8K}9V
z0|?(wukqYC#m*bjc>Ryx@e&M<mR{ZF=JG^uH3ybUnw;VIo=SG$my=p#?moXlIIi*B
z_(PX7QDxyhg)W#{-`;W42VxC!^0J5Jm{h+fbWd!5d3OZ8UQ_qg{!6|$mzG5$BbSW?
z?=%zdm@u8<`;<th>Oa0aCJj3De<p3VGZQZ~re7J&#^*6z>c-!NXO|ljuMEH^roS`_
zuLt5dQ<63vm<E6!-ZUpPpDiXLBcYSOB!qI?+*cQ{=e7mUf_XMkgNP7#tG<GjiAHYl
z|9O5dnx5c867urh|0VA!_?|yG>aYzam2jsdU>|<Cnb6D_76UUnC{L2Y%V0t7@0Y8@
za%Y~owylIXzZ#s~8s(r6z#o(VIeW0p8VlXCoS>gJO0@`2B^F5=o6Vl>p|Qqt`M5Ce
zmmrgx7?cm>>hPy_Cur&c=W<B<#jU2~s^Pv#0|9&^&2Cgub8IOvcPAWuej_e#9VBGs
znqS?MR`C^z2syd-L5dynDxbP0&$+mp(O-Wzm-%k@1iZRbgPfAd@^Ka0N}Rmh(T4eB
zLnr*R53-yvg8oU8W=JEwl1jO`GJbA5HHCWh@SRY0`QlDX3nv7f$s@t@cNOs*v;;p!
z1^KKq!jk5vP8jPHA<LFnW15o+OaUb!8qHVbeZRkQX(b4!jyKnR9E;1ULvm11QAGgX
zatI@#(L}3_lCo7rrbB7K5;)d8ucX(FU@>afqXaaXFK1=Sc`rNlE2->#bNOg>-MR<X
zrq%pUE{^@TvEck)eDgcbH%uj(S{)97_Qa*x*!-79^g+A-U9D{ZaO+BMR!7P`O2nb8
zsApj%dhgIheX3BwnhRcm<o!bEQ~J}>l8YX$@}01C9gW&?6Y?KUW9kZ5wv;($W}0SR
zAu}ZV%yi8H<~@l{DibJ=L7>GjF-!(+$&{HCJx+SO=;U(q<BobaIpN<*4){?)_^c9;
zTCD1<nca0YCB2n@?Q<5gNl&LZBJPe6Uq9>vg^}D!aJY^4EsN3W-`pE}04x2~>fT_-
z&2~UwUU~bqJRD-LaC((Z-K)+r=({_nmO?kh>sR+0c=Bf_lM{Hv+fHJ$25g43a{$$i
zHWhLA-dM4-&qd&-%Dw5=m1CYY$91Y+w8+OimabJz^XaN-n+nxC<=`P2%v*2&|NnAo
zA`~c+E9cwBrF3(ayV(^&r3wluKr4h1Cu2q7Vn*4C+64vJf)JLpxs01;`LLjml@`os
zVN2gZy{T-auoBq8do-5vn^U1*sIU+Fw*POgl!0Bk+My9qXz6x6k7F1Tl8W_s+njDM
zB5e%=x;p<nvkz5>GkcfZg6hRalGQ<)eU&gvJcm|k-ip{yRehc`XexSc1ueL|R#3%h
zuwBn>KU=L+k$Ql+j#Z@QIlYfrfylno8gzKJWPr#CxG!>SAjpbALv450eRIb$k8cE3
z3X~`)r30YIPJmFlhE8wFl9{9ckPt0G6B7m33ftJ?q*o=mP{Iv_U`Pd)5nz~51SVhv
ztnWl|*kY>5U0#K1hVLG|;?PKUG&!U{a`>qfN4c$|1TBo>7sb10K@1p(i=cGrSBO$A
zbu?Bgc(O&8RNiwZVoi!3g1WQYh3{%>%_+HWz6zsT&mE0dy{T*NoUC1wT`@}bz2vtV
zFAq-u073&nnjm@+)xNg++v`(xZ>xN@tY-~R8p3x3jMvgC(b8XqJa}<iLV)Mia5p0$
zCX?IJ@XflmzAUIwToLDv;dg9o;do>#$sWi3Q>WF)-dRBaP8KkN@KWKs0;@~-<JL9T
zrQyk0BE5V|2T`BmBn%1&WgoZ2_31b*^TuY+j2BmyBZ$d@4*A_@^YZYWSL2GhwesCv
z#Bp8TOy50xGLX|f0-i1q&E2AAE0>y%_#}+PZB}%T2t;cWaK^c@lHyyV^6G!Wc<?Xg
z<A7VP2_wR7kD{PY^<r-6E?#OICjR-43<3Fgtl|S?=y=1E5_iQue?KQSVG|hZyk|Zb
zgg=w7O%YeVOkelNm9KN-J@MR*I9gF7Rs@32I^w2P2QrrQ5XiV6J^wONPxW))j!?!^
zV=%8TH9B!z*WHCNfo1>v|I1L)4TGVJOW{~|W%i!cd@?6f{}<+lRb>z#2x@~E5NIe-
zwy@sA@LiP=#ulWkqs~0G8BAIwjpef-Kus-o%zex!t`hEjP4S1uXG(X^=i4tehDj5D
zbDvEVe^m1X@Bqs7U)R6?H39b|BQK7pD2?@ajtTMc3d>;~M#_XW$ux{!aNmMjn9s(*
zfla|T_(OKx5yTlsP!Mtshx}avQ6HE7E_KKjZVN=Kf=qnV-|FbDtbJa76R;cs4GAB2
z@JT76q1<>%JO{nU04I7MhP%#bej>Ny@(aE=XX&5#{#?3HgF;;O{E8JsXXNhVI<*V!
zo%8=%z7weR)+qHc2f|)v)Q22p3*DqYd=XvupPKh<{E^WC_?}6WF!kJ`7bDmK6Tv=2
zNVyha*3XQvJ3}B3suwFCFA|_}vCtBDK|h2#WLPgaI1GJ;b(5e!5mttD5*lTXnu=)r
zemXjP&SB^!ijsCq^2ar|K7_fl&lAfk7a9aDYmyyFub>~6Sx^ZPLW%_Xz__2{AOHKL
zP@IW8_4dc+_)Cb-9CilXukz4uOTlh#)-*Oh(XkbHfp4#^v*GVg=kxc;9o8R0_iw96
zFT5ei=FbIoSDIkZ4S@}$)KZ94Vc549`EBZBQ5uM=-+KX#3xQ(ZO$Ma__`9`YFkmA?
zmI8o31n~N@3(m3fK9hnf4ih<byVoTFoG!^Ko<1tjzyPSbPEgN;FgcG8YYvUTfN`gv
zSKR=IGw+Gxfdcu2q&ei_=UaXV?Luq`T-BbqjBIb~M`uU!^ZEJj^TP1&dA?q+T$z5c
z5vP3r*1ol$&&V&g)xNDS1=qiyy?1vx9Q+b-sEBVb33;*6pd=TP8by@gwFCSkXO@p>
za6NsKo0{!d8{w&vk!{byUL7C&IY1%d2iMXkQ}xYlg(;=QdAWoI;cwh*P}ddl_89Q*
z{HYQiJy5cr^2mpg3gCtqgLMn{$<-g0V`DiK04tE!B_f9<kBgikHu=O~#BuS@t{8hH
zpPQE}xP^{LiFnqJ@0xU}%#6IV2gqt*#5Ku=p6i>toJRPKLK@_niDo<fZJlR3=kxS;
z#Q!wxAq)vW)yI<V^~qptDdbLX9Ju*$z*zUee_@^#oG!l{D9sIWOv?b%@I}clUlY+h
z!HmnU6S7`(vjn_O(Wl3|=FAX}0*ggG%yIR>By{n#L2c{0BT(pa@SJL9f#K!DZy}GC
zm4Sh6^4f=;3=1wVIsk=%;e0-Z$^Qz?bi?SbQxLFKGp4^CJk*TpBU}<%Ms*wg*$f+y
zf2$vH=<TO|6XRfpz!{r5O5(BvF_FN4Yy}b@gff`s7tJ_hLYRN|7#*Et5FZidfuZE;
z^7C8VFA;=J`TYFneEZMI#Ocb$=V!@!FRfpA@X+MpIu1Nxc*vY+Uh9(%MX3KZhhdJI
zR}AUZe9ToE>)$2A*1PymNyi6PI}uvbI3Jrv8}$PBvCg~d^}#=EG`(z@1O~^$leK|E
zh_RXRw7tm3K@Z`(-lo5#cJW-6BL>WNf%$oCl3d#yzyKc|tr)@Wq5Xi-R!08!*Z6wA
zKU%|(HgE+V5uNIMo63L0+q!6nM{9(?lbT33-x$~OWSSi}$&a<qzHtR;3&A8plfS`r
z0i_80ov|dhlad)l%U(VyJTZ9aH?R+&7-<jSEBIClYC&4%u4nl#V?2B-hnGIVRvp%e
zW(L#z%F(Y8Eo)tRxjA%2AWkC@5hoouc#pz$T%MH2eExoOztywyaW*%xI|CwLzrBrf
zyTq%$BM!iFlnxA%m2WMoqkOn_?z`&h<)XQsxQu22>pCrQ^d`r}<qDMUlmG)Eq6Xh4
zSN;&7G^ReAq`1%^KU_~9n%{rMNMxcU*hxsxDe9KE6;(`XhxdYRI#_NY(3X#Q+za72
z;gk;?8O8$p#DBPD7L)!iqi_8Z@FwW%ipz6?3VBui%#?Hz*SxCre}Z}}hB26g7XJm&
zk#NB*91Kg3<+`|;)3Rz9i$mX5P2B;F#%SLa$AMixFY&sz^>A%CA(Ucq2XJ+HZa)Y4
z`cTJ_KLq|T3ljmHAe0rdxJS*AsjLIzb1q5YDBIGiY^Vg=_(Js1QL&Gy9sDG`CE>Ii
zh0zqx=8et&%LE@BTTz`#=9BQ8M!9J|xvP7LlE&NO^Cfr9j;}G_KcAbI&%RwNQ@_=y
z`ot@5f-B$G5x!ZY4@Jh0iLP9``Mh}yyqY5j4)`d;P21WSG4Z3g9p5R68F-qblsCKh
zx+4e8H;g#YK!z_q{8f&GICNqxD1cvuCPXp;Dni5Uv|r=dd1Hlfeh%S_0u0Ir{_2<H
zz=nYjavy$Z$-;UAQp#M81_R~w4(M(PVT2IgfcYf<CR8^3Ck!F9Xlc=LaNN2tU;D5}
zHgrFUoItP|WmvGw{%w<CD*{#XU6<gac*JYiZ4LernC(4)(q_=;P^wHp@0V`byOZ(!
znf^TQpU=<9HpSENblFY0<2MQC5E~)1i%N(yUES_Zr@kYO0vpmQ0|!4XrQas1Und!j
z&a}`n*s!-EbPVVff&#!p;kSeEhaIb+Wx=$l9#~1jbln6PNetm(krYo}u5QsK=Bm&O
z$ru?Nk88(QBP=$TinV|Mrb${hKOJB)?GsjSP{_QYyOWBb!0)A09WMz|p`p;(Ho0^J
zWHh{eHb;B&|E+y%<ee^4K3^O%@qA6l2SGMKH->YKwL)JWJg@udu4#h>nwT&?S${))
zUS3Ua;hVq~4<uK^Nj(3=WdH&~tOo4>0Gv;Jlbaiq*7!<Tb~wx@^LX`M_U1@8mt&cN
zg!ljcPN5BQ%Evb>xy&i^`TQpT|K$EN$*CWDeRtHHlEyoTp*?~BjP~jb_tz}jn^=Wz
zf93A}Y65y6i{Zt>p!XS+PUAK|68|K0Yk*5YB~{lEmx2lf9|$vrF~FLn$t{UIGhG1&
z34Z0L;_-}|SRDi8m&EvS^<3|KM8XtD0zunK`KLTF3f{OwwDF<C+ja&%FrN`fkn&3S
zo5QhwwuacF#?MwBB7l$^N9GG}=CCA`q<kSiX#o5=lTQ<Ko8s-5gAW?<s}i5CX-J;`
z3Cg8fRgDhimJxSP#r8CblaGYD=Gdo;;pn{z8JjX~pY`cDVnBe7f@6dQ=^fgEkgJa-
zlwi!0!Vu0z0uErxCf_)Iz{)82PF&^-q+qx1E9d34I0)e~aF#&&U6|M?@2`9%D3b#?
zfa$&%;-&4T-Id1mwtor#|K$D%e4ErG0texJ$`jZh_|I>s&wY2P{)GAbOa1Qu1d`H;
zAAHe}LBJk>X6C|t9&`93tGV}=iqfdiI1K{+NOca1fWMM70sIK!0&XkKfuvnHHik&e
zkD(;tIZ`mEF;2}5a%e`47n@D%f{g%%y{OR8C*t_*p@h+(>?3A|8^xRaMU0df$%n@R
z!tx*PJUXNPuQw%x5acjl#8nT4TR%q#T?;5%#BkgpvVuc2e+b@Q$aoMIG5FA^RtA4|
zm=Q$WYs;MTP5=Ysu+)Mg!=CSEx<BxqU&e$mbp<yUf;vPnpK|##gbb=zH3nTYHO1!u
z0T={`Nnha^)Z`8D<U4_6(E(_H?~1S}btZc;k0%}Gp{s$;>apCuUb~wa{`FXxj99-C
zr^%o1y5)oGUt0M6@X0CRR<rO?eaLYhItx$mmOMCq%lQ4I+0I!R`OIShZu}vZC=LMX
zNo*nbn*|Cb{t7vvhobO%{J7)E|BCF2h;R;?9N7KsMqXYCF~I^K2VIKl^}<vgPGeTi
zkHzFeFs3t}xSr`t^~P8lMgRcArIs9ux=j!eFljxH-nmjq!Zra&hxpLrD5Vp`aEQ-@
zCI}XSch}p_S`Z_oq!Swg1r##R2=a=APBRu8)+-DA2nGB4KNGYV|HOP^B*B1=1PA2e
z{CC?1h)MBz+HA(zeeradqacZ~HOt2ji=Zn=BLM@}`<?HI$A&NP-OPAGgMiHN(89xz
z5p=TK>_i%bEpbwxWwIayJq*SI@ijOAC=>#40PD=M^G*`6m@rp0fX)&(p?KPm04?Y(
zEO0muK!P{{io$aMcj<ch>9^t}A%kl^fBCn%=8lf~2aOF7M1MX4N3HlTnyZlSpT1q{
zZYzh9WxW}5^6?IQec^;G=nEW<`)T`>0_h+bxT&K!LSeXiK~w^N1$o#T34cR+>e2we
zd=&Hy^dNz1HW27g-Zl;e>_Yq@d*jeMK<-RrF(?iHxtgpHBnSAdMTtzo*xMw$PaT!{
zU*e;HLeT+2iyO-i!cwNdLxL`>Qz-LLS0Ho3TW3L_B7$<y#PG}8;8cunRJlB8sPK)0
zpdsO4doav`fOVMmPF@;FML{RQH;u=R7i<0QJRvZ#L<Irn>Ez9(6jTnLnt%B?Lor}<
z(CkV6Yu?bMqtvu1YyK|U7L8O|7L`@wBg5wThsYj=(6knXrBxP<r}3R45lRmo^fuA7
z)Px9uI*sJKU7`bdAj%u|y(4@^S>s`YtPd&&4}uO{%t0!t3m_E30&f&UFOC{1{|MM)
z!#zkq_nv5>0ibQ4;oUp|6)6D)hJg)L4FtGl!g1u(>+Xjf5AQZkCR))j<({}g@aEbc
z*uaU~{%wjjdGOxG<Md1WhUmPu0du5y9Jq)=5Z44!FWxi0?l+eAc6V+sR+#-Ct_!1v
z)&d79v!ln(dbr5aUbIm2e-5A^{|Vi>_?X&8#242uBz7evCmTq7S14gT9dH2pKOM7B
zpqkry4>*h9pPbS|z>Qo3^>ymz$ALu`;G*fE%&U}1CWZ_ARO6!|2pAXJ6CgksdiMMg
zOwNen0>i;o0V=q-7FYmS4d+xvmvF&*0YAbWvFP?3;6@7^(om~}u*5!bsLc?Zgg+$+
z3-^zx-JkWrM;sikMmI8=`q&W5pAPUtwh4&G0+a^%&Gef-zYvine-SfrdjG~(;SUH)
zh&8CgE%R2YP70%dAyhawq+mvG#Vsr}da~!Y#q$Ci;mh6Ylcqy>e}wK39OFhY3_|)t
zuYbZ+2;q^Oo)8N{0>UW9pM>Ql(j!<9_{m4)ux-a({qxZUx5UxQBjtd@E!{%*B3B4?
z!7PD;96E&vh*)nGxA;P&x4dkvDCW@v<_z~?OaRBa`TxWJ`T4}^Zf(koBt{eE=JB0t
z>r!%Jyr<NhCqoGwJ;1;KelwAR3}@r0wXinIW|Xqm1-xh$;>LyRk#yYF*58YmP;Xu|
zv-QV~y1Ye!jf29#`WV3LAV3%wiu1LK<`B{NMmi7u4T)#+Am##i?r}kxp`#0eCIIo!
zA%kI^bJzGcnml)oj|M@;fZk$J0ce87_-2t7r|kGX{}EoCC;$JA_Yv~e8{~YjQN;f(
zYj_YoPB!@G$JK$(xF=c=x+KlGED|_%?ZE#pm<Aa`lU#lY{0B+RSRDmKNAmyy3_%I}
zbfdYD)2sn_xIuyG9i9{8<D*#oCs1_f_(nYR_FUbFXolcgk+!(K4S|NGq*^gj`>m9`
z-t=FH^2<o^T$#RTkIl;<-I?z~Nuk`_u!Oq3@ppG{5`Ry@<k?G6JthUR@o;i%rGd$^
zmS9^Yg5`isPHdC;)BFOCGB-V*J|3?6{9FjVy6%JRsbFRUHm5aS2Pc%UJ?dG6*)W?g
zEF8S0fMWmB{}@{)m;A+zh?Fp?f25X@T160{6VJyGtbJlpFE@uS`sJj+=49NF+|&*q
zFDA)JPYCdpi^bz5zu^?*Xj}{8qpMp30fF=XEr9sw;q!E31Htf=&|-KS;6i^~U!921
zNf`hM_*)tSFzgylL>lf!e_tIU?5D+dcYn=${J7|d<cZ!R6ZnHz*Av51sK@{XeS!|B
z({+3i#zF#*W!1ub61+N5fN&vt0v^vx$$>l&2EGuF4ye+t%y0)pJY>;Bc;F5APqZ3C
z^PjN)bWa#33<ZchRzQHuL4ha75zETQ#dH}Z4fONn+YW|4BMBYJ-xb>s2zTf>JSv}s
z47KcvVsW`ZLf!|g`EMB^4n={zZ$^61r8FZxaqJC-BX6>mzI{(bxA64=l374xmQ`+9
zRNS!<=7Cn46-~<%yZ0V4!Yzk~fY>?#7x(8Ki<TgdGzXe!Rc9=!&RRh885Rzp*L}Yg
z6LP`9o6HQ*s@$@vxo;B$G3uQxR7zaB)K;Rsj4ov_hQ`>Y9D8Q_co;<sx#hq2|6>3C
z5x6Dr4<ozxfE-IE(;axo24!9|OTGp_X_Ig5;h^4YN7L@Rx430FvR%>!wfZov^_rCU
z2juksM*d5lEY0tO{PvF!&ho&{zT0if|6JXhw9S9+B38`XuLJRrtKQXqhDL@<RZ*XO
zU)360q#Qgnzd&Ws`GG93GXqC5kO-r{y&mj_^JlTZrRipEcJOylWYKpO&;d!65Z5U9
z!3^b=@sJKb$=CDX!uv8)>k~MZk8Ut+^km`QH4`--;o=!HPC#Zd?P1uo1@Bw3bF2cp
z|Nrksv7CIXOS9F!y%p#S{>!GB=3ImEk%(_Z|GkWzqZhCDbS>mED{e!ZcuzxbBf}F}
zm;3oi)AAh2{f%${z1F7F1_=4wn&W?`&Tm`$8FFrO#<yn2*4`!%=fHn`9yJ?F)^oSv
z;@;D6lwd>s4q8sn&5wtGe~9La0hA&-0<-u-%pz&WhbK=KKEsV0lNdPT#A}<!z~T2Q
zB7sYfU&r{^>a+Z<_#=dzFf%}lQH9sd$m4$<KxP6%XfRs#EgM7FVQ@ela(Hdb6BDS6
zZw*dxfB}YLsb7Ytcl=$T>ZjwQF1Y#D7yt>NJ{*8s0k!CoxKg3b_(oI9!NP>9bEW-}
zG&jfmZy74L2H+&tjvf=l&9AKp30lwd)htcx?WbP^_|O~%)lZ%rz9Ozy+c=Ddz4Fqz
zq%j>35(GNoKN6a-IXQUwr5!Cc;fS=l{7yIv?5GWBf%MoB``dLd73TDtWE2UzfA4?z
zzW}53XpLM^xWIyswM?z;x5O;OFC^~F)YmO*e7RCc7#}tsZxl~E;VFX!vK!pNOt!n>
zImKi+K*_`gz>aD4dgbxymECsylZXq{HsvdeoB$Gn2IU#FIvhd7_^Zk(xO!hL@RmI|
zU?c&|AR&eHtONyfWdyqMHR5anaRDqhzX1NPCK%7j6Y&+v=i@l5RDKCOf3QA2xZ&ji
zAnHOMw;8A~g8|Sl3r0ghR16*g<MGzMZ`<+K^M#L|jpCA$iT+9;%s~Ie!hGjX5!N<<
z#;W&rO<xmp{EB8nd_*_;1@Yr{xKhb<q(SEN%!;>*=JP-;$L&qp3!E?sjU3CgB1Y{I
z>mM?k*F1}C3-dg^NM2`WiR#mf|IgPZEBxEP-!6UT+8>iJKoUzY2uK-YMAT|dxMB62
z5G3z_MPi1yC9ZWZX{=v1I+`89T?@fBz~RUro9HqF2g3N7g93#g6Wf>gu0imNgZdGX
z4VZG*0GBq31p2@|Ja#q)2-rU~K$vmOKhUVq?goX@n-MM`o)NHr1V$qf%gxP(&o4H7
zX2CfBhi+@~T^E}My`gKzW3h5@BI*Nf^QL&t;szR^Urg-jJXQgSn}8Xk8vqM~0f^!+
zK=1$`HF5|S$vRj%3&(WMW1HKmz=Uu`58Kc3pO?)*-wHw@t)4S7JttFr(*tYFF}Ag&
zJ4(D)X=M%pe5-bQoi4cR@VhY4bK>G&*W9$EAxWCt*=vCCG}RHO(XRFgJJIzS*P^<=
z$tERN$(@3n{MhVM8)xu_TVXjW<6G~u@J)d)@HZcX{0H{1XvTp=XuO*R!Z*S?C_acY
z-mq6Q5x9>LD2_};#CV_0<G%1o52D;1usaM_6&wX!8W7Hg8r#8mZcKXN@pdX_GS%nK
z-vly2fPAZ-vd+Kc#~^jXs7F_VE+hNq^GQsGh5sJ~8;6A+Sqdhr(>+2jpf&noSr6IE
zNjsisk8dXz8(FE<@*JAx<nDe;zPT>=j`x*?&C18s<l_33QVfW6{9ZI&B|>08YO`sN
zhi7p4yS(F1W;`EB=D12^E>VWR@L8A`jT8VQ3h5R5Lbv+6;Ge^&jxZE_^xt-|0rFxz
zF<3%wPahnjL}c#}N>JPvt>PaVKZWGF@BkVpBfK{tKsadyp<lt2BsIoCCV=0|4RO0L
zK^hYV{y_na3GBA%{dMzL5#)kkE8k;(2;sVX+*1L{2n)<&;e>^b>htnOPpI1;%g07K
z{G4oXL4^4(`Fgj+X5Tjax|>_CtNraZN_yq@8jHT4Uao7mt_!D;CA+=zt#fvdAzga7
zdQwcOW-=LQywvGdTd$+_#M?o~rw|)VqkBFOyN!WMkYi(O=j0LmPChOT>l70R-;4e7
z<a~V6PH#UI$u&5RD|@@Uyg{-;WS$7?o3TA&1yB|;UwF;mFHIIl@Jp=|m;>X2|7zkh
zO}h64+A>NH#8`&~(ZDETVW5WX@DJfkXgU~m=oE(l&`VYXan@gCJuqRz<(*yRQu9kf
z1Okg2*P?j)4nHW8m_W?a!oysY6kv8hys?-D=aAcoi|rF|%M{#365=y%UE6#SLwu3a
zzAg29Ooo_Lbl&-Qx$!I3er^}=+)RT)J!XW8{qfnwBhv*gIw7`@)Wo2_CCV^=72uKP
zRa7EBxP31N!uhb=S(`%v_X%8!dNe_KFhH+};xK`^JZCO6E)a`{aQ_ksWZqOX1bFpz
z@2Y<h@I^(tj}ykr9bL{plLS5=(RrT*vEgx{Qeqtv;!@#h%s%0U$3cGt(T9im_Ak3q
z!ntj<bUqNviIyW3+;~J#Kj!hlh<;4Dghlu8$H_}B`FQ<Ncp}N=MK6iJR)u@(-wDUa
zFgp*WseAmFyiY$56JysCvy!pHE`DxfX?Q~|XFhmChhm9_>xiV@L?dA>ihK}5^n?~X
z4?|6W!X_mFJ`=C~M#F%1rTXBrI)jD-^5EL<PU!4JULe~Tc@=|PPG8wa>Lw%Qf(;Id
z?7U5krZWk{i7|H0{{`HUjRGSzZuvZ5bYFfta9p#tzcz6Q@S4|jlKpUmdz5v5as0j`
zm$ulRuYF(Y`PRlL0U5il6?_wBly@(^a7EqB-%tf#UirDh0V^w#yRKe;FJAagV8NW%
zG=5AuTK)>|5GaGUbwKh<9vFL0uskc4KA7kq&7LQ`{7$@GEh_?I7!uccLerx$-h3g6
zeEjfHzFSuqOs*#}Z~dc{M!BZm@dCJhQ}h@Q{wfo2=bf*e1~#+5#ZK9&3I6%boB{Q8
zYU=WFepzNR*?3Mt5zzy|vC5`1o5!;+1-sdE|I8zb7U_=s{hjmq`8xN>8(&FsOAh(E
zZ{*(oFMFLuc%A%JE8X5BtNrnybgg&Gq^UR|<qHl76OR`<SDh*=<%@m(UF~_NJ}?Tb
za0|gSCSqCZ1cpLsKaTW~?ygvM5*x<uBV5sl@B8D3Uy^X3>$hAd!T3dkOAa9aK5qms
z53W2E>M$+`PMrah`wt~ZAN-Utpt0+ozFVS1yV)3VL~prC9{(BB4T!LJFrcLC1O#|M
zeKQZm$Xrz6frr@6j&^=b5It&l%dy>YRymlRd6}@M_}72`8R3aB&?(1UFnnkc5wL=8
zW_SEog&wO%B|IfzpcG)7#Pke<-Ws%wr8O~;v_Il_O7uLd*uuP?UNfub?C+n?%fSyX
z?!K^mRo(A*@Jn`0yT1MiM9u#1;F9yPf0v#a$*%I#KNBRaA~GiiKfGwcCqjHPn=ITQ
zL6qN=Xa7<c!%~7-Ood_I$Nx13rc?MZwQj>3y<h+wB`Q#WMg{waKfyfEVCoAU9_$R`
zN3DI@*kgy_pFzV(F<giG&(|e@hQUPg*EbCzi2Pk3+6AuEl{^?}AiVYbHx)f|*TV>5
zJc4VI2_8<K@ZIo7E^g<=$}n=n4xs!3!G8{KO?-H3+M~oth>OI0OmHP@#Lj^yj*sNQ
zBgaUt4ERIBMv4EAj;)zIm<9;62YdWXJ1&csaKiM~1LyV4lNevUjGLQ@>N9bi10(Sq
zmha+W4!sa}&))=`G}KUU@KM+!Qv{D2td=BCpPVM6EWi1;Hk(%_^nUwq>xbPpBj~(c
z@4Ly(v}NH5@6AQk{%Qjwn@}M<))`JtgU!1P$b2JUJpjQklA|num4R#y@P<5ai+lW@
z89)pdhH-?V1_Q5-4Ey0+MmSF!2LV=7+%Eh_A57uMdSBD1#^wyJ9r^+Bo!@u2wC{fi
zZufV0cYg_Fg}t==u|JTRIkDv5#7WK1>xz*iiYRh1FB1qfG53u)dH;x@8)F0<6YT$q
z(NP@Vxc-0h@bNL9_r}cf_3wtPL}4vikuie5{!8jB6DL=Wh|s@WM;Q0d=kJWbNcFF^
z6p@FVpyR>Jc*}5?klp$4c{5Cd*2v>DgN*SV-=E_wj6VsYZ8Lj$7Dl>TykfM-gc%yn
zo+bpZazB1PJ)F_~XQ&~>%#!v%Ri0R%#qPDO@m_fVI~<}cJQWOwl9bo&39+L(emVd)
z1)t-e`{5rBXTYdl`q~x!a9H5siFs6O!Z~`4`|%h6MfMWF2*|rW1a<%PlwS_PQGaEi
zcgT^MPyf8S33+f!)Jg8W;T}7`Xn+qyN?c$X|G5Fb0+K^i8IS+}7FyqrReOR){8ci)
zeE1{a<K!CWjs4zqs|&&Lj>@ORdlGLMx-$~mEt_WZ15=Yi4;tg&Siqsmm|#dElLE>b
zwBWyE!P()ylpoXrpB5`&NWI|=<|F`=fG`;tBQo$hvNPtA(SQJCGK)->4OLmTx!_zU
zl}%7TFL&gC{G{cs4yU^J&3x>xe~ufS*Zvu@bX+N8Ltl#Gw$*|2H}LGH@R5OJ(I6CA
z&T3@IsRbn-1O^I%Mg9ulf#U{-fIJr23ZOp496Q&-6={jb!J$H4d)9?q!Uh`3PX7e>
z`e$9^>4uY!v~1c`u<A}Zd_?G)+G%_t@$+G`HW`Y>Dy{?t;sospS;NYE!}+_MJL}(9
z`6FY&hx~nmcxiearG~~8a6AY2cJIyCaY_tuv0uUHXT%EOl&-Y12Bk^vH+$sndU9}E
zW1UW&Hm*u^<>GO}N@lGwt4wqM6B<lyURCUWCV-`%iN~X~X8Ic!tNa%82@RUEk3udF
zjOvMdSL6r=LJIh8#(qD=RyKoxIpUh<t1>1;|9oAAX>!d3E0fJ@tH*P0zY|*>HQC=g
z=kxc(Vn?vwFn+N2?xBRMg<puc5LQIAn+Th6wGsP&$KXHrZ`6&A|0iCkopW_x8NI>V
zd;rFTJ>K<a14=tvP*V;2@AjJ7-^N&^GUfw!XiFRf3mBYseg6QPpncD8e%(I4m);vq
zXT#^>GFq?@FJ3<TA+ybiL;bn`t|O)uz_W?MLoNS~f%WWxX+r#Zi$gH``_qQj+t)z9
zcoBz}{vrUk4SLbUPOM$N>oQ~vqSV{F=l+<hXuO(WEI#A^n$ueE#eNDgfjEL<mmIGc
zTpvAGqyL+PIYI)E;SPhhn}01Ch{ch3sS!#L8_`z}NW$<i2hll6*H0pjyTdW0!#`F_
zKk;41&}gTDIIXDI18e{Quux^-g1BZbB@VK66~e+y4Vqt-^TBgyP=(5H;snMM9CNqz
z!gzWop5nj5{A{s@jH37}O|Peq%ks#+0gVZtUaUp($`p;49Q+bkGSh#E$KWWXj3M&z
zG)iaFk~#m5f&7@zq`xc}9R`vmicV4cnBoJ9_(I`K&&B`%d{PP+|DL4~5wKva1^ykp
z&&}@|7=2R3=<0z1a6tc_qNXx=FnD#`XZ*WGG5vb^x{rtmSCh?xj`{eWJ2+-vARrb^
z3=Qw%Hyr_k8UL57S0*d`5#N6LyXNtuF9ewB<HcOK&@C%WOTu%AGGWiA-nz<82`@!)
z;D;SD?_47=y3_pF5{)HBMc%AV&i|VrAQ{sqCNMeg-Eb{*Rl#(Dl{lY_q35fIW5NR(
zo+Mf{8O<lnR@dXnht~_}m&2em+SlcTY-C*Z{tRhvhjm2$@G;Hug`*<Cuf4J1V9x&}
zWNz4h#0tpD1CGvod`${l?ce|=JsX?QGU5eu&p-Tc4l>JGVC{0r8E&d;#yjYf_b$J=
z^Tcti&!8CU%WZ}<%Gn^oo<D(BriLqbt)v-bgDm2D6Y&^~#CVU0<E;x?HLVL;J@q<s
zzrqmQMt3OD75;UKW8j9uGA35ZJBJW#4#5J8#aIP{j64JPAM`(kw`gNSPI*-dSsWky
zS1l(ri(J#8stI!Tn(=ufZydXun@KlZ*0mMQNj*XugfRzv{7(tyW|;#L@)=Qo%XXFn
zr{J204NC{R+Fq@Fa`+*>b};!edR`*-XbQ&i@I`Ra1G1r`?}9oUvXQTbtZWUk7_2(&
zfBNg^tUo)k<KO$?D~8*W@2c)(<RI5Al>Sch2NPW!x$E$s!f)!~@J}Li?_;?2c{`G5
zP-wg+|Nr0&`}#Y0An}{9<Op;G1}xRT;X>ZNtV1ORy7dJY@CH-qv=4v%cO1IYyqrvU
z91H=NuzL~XK>~QPZ}3kWO#I%y#J(%U_19lE5wJgc@Xv{iCN)6C?lGzfAFJOtD*>I~
z;r|>H)p#=Z!_dmLhY<P{AO1Q(v=HnG<<RF4!^mz7Nq+2ZuZ!A}$BtkhHxo*L%40TV
zi2YyTIiciGg@pM$vLW6lg6pt%dsq1=4m<_}nC~Yo@15r2sWi{F--jbmk16FcXy#AL
z)+^?#dg5atSM7wjjI&pAs)rmm$<OP#Pv?)8OiqLIc*nh2@UJOhz))Z<W`g;Vo~i!i
zwd;cpHVy|-@~s}evTw!Ro!OKS4EcIX;^#RgRB&@(@^V~kUw;#sf&iT|WdZMo`v@e^
znSUAo=GOlEK??yS`K>Gb7RJ*(EW_`<chA=*9=G(;a=5G!v?fzrG0;PC*YJ;)Bn*ub
z8T1XJ?0V||SBT`o+nw`iwS3(s-&cx={muASf=Kwu_lP^^>yvwk;EFRIyb*c@m%)Y<
ziuryj7IbC5@K4J`h-!hza}Sq|-2C;A9><Em*91|4*y;19%V0&NhlVx5Cu1>p_$$hS
z#~K6?D(1Yaf(q9e7(b24u=BC60*A|0)(|ySSA;x3jQPcWCTgm$i>j)ss>CTUyq9~f
zOgAU`E*P7VE9gRykCywWm`>#}$|0OE5ZqWEA<u`#-znDkEryaN#r$eJtAu7?p~`&R
z!GWoO7h>nEYn%VWk<k&bK#YTmz)`MX@A!``l;H4aKO5cSd2d6gj}d|nCb@GjisJOA
z5E8Gqe6pCx5L{0N7p~NYm<;fZLaCESGJd+faON;^#<1P_T*s~mYL@SY=^q%pv;zzw
z+f)A)9Ft&REKRWC>@v8k1M$#+dI1QXwP2L)L`3=iC!f#Hh@hv^OGz*IkBFLJ&GX^&
zEfL~8M~MFJ`U+qoZsXrh<NyCQw!E<Sv-x~YHnDW?TqP;l529Y+2-urYdZ0}b@U_x|
zupz(zh5!J$@A=?WKax-U^`@k)An*PkpgCkS5nOlgWUL*dCHm#z4rZagy?hgSqRT0)
zA15;sb$^09k7A_%SBDOv6CV6Vm8wlN#jetE_}c2_-!_z6+W5VQ`1W6S&5aFwS9DL}
zKUevtWBIb2C}E4kbQuKWO^fZOn|>Og5J9&z6b8R7SZj?xit99}lcsaN2;r0&=Y$Fg
zLL5S#xamnKPVdvrE73c}^Kn^xsHEdYT>gG2C;$J4MT?2g=kxje{IN4oE1#2!@-Z72
zsGYtUrtrd`Pt=ZJGlBr92k-Y`<KTJtdiEP7Ys<Cr)?~HAxOPlj&5ey;$BeaQCWq(b
z*&xX^%TCn2Sq=;QsHc1HR#m}OF}2mpnA+;<<-PB{YQ?y(ub!~X?r{Ih%=8eR>}QoP
zHb0m1)N~bm>Hm^sH@*w$>F;E*n}t_P{2{{-;5FwI2C!Bn(9*B~+rst2c~hMchVhgm
zVl(l0j8C7>=kxPn3gf&Zz~O8MUcHD;e%A>`!NBJDWgHRw*EtF0FFcZGd?#UMh~~VY
zCC6+wB0g`9!O`ezhNN|dKZPwyogcn#sfh2IF)<iNuYF$nyxf?UADf;LJXPOED1ew$
zoHapVrlhFG&lrAQvWe%egA6-Q@K26{4+a@`PzhKquS;)=hZN;HEe?x!ln!F<axez}
z<*|59!}-4_a?8Z=kguX%-FWCdv;HEn9w6NQClM3Pxshbzqs_dHi%b}C4+5$1gvfFX
zfRXS%t?Nm09-9NX#k_Zo424+Xu5im!>#QFPSn{9G3gf4^e~78l73R*6`IiVr@JXtw
zPpjwb@11B`-d-Y=s_hemx1Ec-lalQh%f)!`xMsO3p+Ci5{%_^b-9I;u2@eEz6Dhb8
z#Z`f}t?76uha%bB2!O%xGpqN+SP}yn1QG|JhFSg)q)w$i#gRNa!p4&TkUvlX6$7Ss
z_)kQUI&23uPlh6V!aPSe9ncJT4i)#lRUWu6jfRFct-?12;;<PFpf}*J9PjXj@|zFy
z?^Rh?mxB&?S;mAv)N#|?KV5s}q1a*d)_S@kBl7gzH`Vj@chBcs{8ujY*q&|(vwf3w
zFur<^9x2oN>(#<pM`K9l$=2{er5PEALTf_-QXuL_1ja&2GAmxM|Ae8Nk>Cx1n+gd~
z^f1x4itB;lyf875q5KngZ7Ba>D0SB|WIDJooGxJofP<(kS|pA%5DO0*Jbe5o=YaX|
z;yrR$4<8sM#1q4*W<0iS+b0Q17KYGNBaDI(Iuhob5)t@14xo$w6AbY60D?ddO|pas
zHz!A51acf2oBFtl^h_c7yG~wg=?}P1tNnXFpZG_IpO*RG26xyY9QXLnx66I3g~kce
z$_c4$6H<mFl4~C=u&SQdZx?ogKu1ld?vHxI1nFUdbhAIq-@H#Xl!7ovC4}p(nSJx~
z@Qv)*@ShQU$=^a`K|EhtAZE@QI!A=Nz~8ar`%jYr-9e9ElYj5qo3J;+{1Na2DR;@Q
z??!KFzvCt^n_ABG$%kb*{MVHAaF$@Y6K97c-|-Ugw{pn)vacRIc{#J39Gu@1M5N%K
zI#~i<2(g-01RD>IxK{~Dz>5!}mHq+o!A$_**q0HINi7FJFw{2-;W-;NlpqvSA20wI
zm!TR&iOtQMAcf)BK%P!6ojqy$s%v~HjhTF4VU3kMfH@DLZhvpORJechWdL9|=n$_F
zhV>!@6!3lr10Ui!v{Ar9AFIL~UPdxLRJX!@Xh&qy^56Vf-#?%Ds6(#U9n#*}5~Xxd
z+(I5>CP7Az@T3a(IAt*I*zPj~|18lMg+CR4iO*@&Q<fn90t9)WIy7kV1ZdE8Zd1$O
z<0KK(j6yVMrhIaW<$=-NEJ8fcLca%B<5~3bAsRGzbjhGP9%%mxK$YWY-<=uvrled6
zN$>+N+l?PMjkBZ`Lw)w{?>ASjGg@N2@f)muAVbw-=fY-#mN&o1^fUq~TArS}zX#_!
zeC&K>PtX4u;BZ)iKoGO7#}|~{C0e#im`S0Kr@be4mQ@{O@;`q!{3b1ixITHqGgl@5
z&Hv*dj;4=~NB`e`n1_tM;TG;PPy5+DPMcrucmz#$AN9W6LQlg(^@n~+Df2liyZkg&
zJ&?b~&pX!t@!8?+=tcRey3x673=gUHD&|IK*M9CIk=CQ|Ky|(&^MAORx|*I4yZ63a
zaeeI_ECIecY3XsH0;d_7_k8_&xK6J99N)sYc`DxJ*ciw|YQz$~{4)Q+JYb*psvKOF
z3$7mt<p^T|phmB*fAzj-*yQlq3=~f`s;>}SY(8o)@Q;ZE^CTQ(c5@4%&Ryi;tUDJK
z0l+o*O~c;GGydyE272SN2P5uyGYq~l;8mbE!h6~A(puuNUuvZ0@u~zlJE{7;b9X8w
z#Y?uW>*b&wqTx9_XD7)wx1HbBu$zXGQ~vk=gm-&@mFu)>urSZwl{wyVeW&Zv^=bKh
zY{KW99v<y~$82HLT&<{>jp2c=7hgyIE2bTZ5a=js6XxRcK9R_9G8*z~+kc6`V<QcL
zu`MV2prohA>>ThqO~Uh$V9XG_2jHqq9s~-*d@~2@AZ!fJ9ySCo^7Olv0$df}I3Ult
z#t7gL*%tV3!dG_2zlW2#(5*KUlZx<>on+r^gOO=Jh?ko~gE4~eP2f%W4b;GZ?gl78
zI$(Tvgq$2`AmiJpzBY?r7v)?Oef4qWu}6~{<)Vbn5bwg<XItj#Q2`w*YC&K4E|^@w
z0YIn>g9(qY6+XTQWnw_J(fxh|aGkl9l3bi8Nr0NRIto{U0r7rOL7+uzTtL11;XQ4w
zzk;nZkCQ$gBC`Spq01aKPV$}6A4A;y9mCu+<>xWA?W5maPBf$NjoaPc-EY1xLiKN}
zSiQE#E~r+RjvU6#!=Ujra%2K84|adyT$(soz=xv$QRC0_{`sZWzdb{fyZ@Vr(C#^;
z4nK&Xral-&uMEYm@{AZi6J=u^D-Z?YfWuH>d^eS8%c;gz6VP_g{3ka+na2S$M4)Z}
z_(HZw0@A(qG2l3Sc7YEDgG*1^0A}1Ss=L&DvGV6MU=%94xM~pa>AwOmV}}!cymT5r
z#pTZ*5AdRU=E65C>)@haKfX+I1*Yb~7mDBehEZsLI{X&#fO+iW!&7`KXyEn}L_@Ib
zzP=nqdQmm&n;Z@eKnx!a<OM=L58gHsni16um<`viG>`YeK0s>GFvkIpN8brU$T%<D
zQwVg0;^YVn!ScZ^*9zek@rcfm`i`Dq>_72Y0#(Z&xaj_XC<8b^d=h0195~dk@XlBr
zCZ<sTgnOowQ}RiSDEL8qvrChns#;1g|CYj0;6UCSe7&R4om#m)Gw@Yzdw}arK4=cN
z^EBw9sOGl5YBlF~elbxF_Z|u$Pjj`VEMYdauTxr{fd1UVI>6HL8%)r5d|z8~%^<!|
zG7rOkU+#ViI=WY}@pP?n?F)44KYY8!>E^9|`>~gZ+A`AB|GsSRW&4bRR?!15bNY3`
z1-ZwE0t|+fY;r&xDr7em$HA0<#ev}ej@iCT5okQppf3&~qWA!?Ku^Ef0^JC7P`>4R
zUC?JB(@~Nq4L|VqK{=Q)4d8$*Lm^Ap*bR$41o7}~{|HLE7YsvwVl4qif>`)#tHKlF
z9ouLTIKmzRVhy6yXb;OnBRB9<&G?4<64EUA*erGO$Y?f&IDqC`<Kd*-G<!RA8B|9{
zNBBa$R*L#xF!*5)aPd1oTz7yn`m9H;fdTRU3~Ue?*x(o=Yz_J!=9FNR(b0Y<hEn|R
zr+g#a5w|bhfQ<m$TZ6h4f}{8)$4e!z<rC9DF6ckGToQ21D_mE}%&_@e;XMH0gYi_1
z44*#;<3*TZ2z%#LP@9pgzP<%j_;#QU-f?(6<AdY4VQa@9E8`v3IAFa}uUD6wkJH3s
zIGE^xbOwaT!2qWQP7C(RzhaGzFD&MV&M$thOkeeL<3H}$O3R-MoJQ`s<9B!6{C;5N
zGpT^c4ZwL=aYv5yd$~HfKLj$v`p@Ef;FC%Hee{)c*N3|w;&u?~BN$wF_rm@<Zl!^8
zhp!GqxBh;iHZ6Dm%fTm%1B2guXm&^A?-~FVxyDf2*a-RNq!DrX|Ho!{0G-9;2|WQ7
zVxOU|O=0vQ|5S&<ep;Xj)KPdNmY)yr&Ov__WD;OKMl<8Zn?VEoDWGwH)Ue^F#J3DB
zrbcO+=vr}nvjPQzAozdvZI6;N6eLFW_zP$Fd*Djl`}k-=d@0hLj>phN+kP(S@tIzN
z^LQuK&+_%PZ;SI^4`+T}ME!~la%r$&Cu_j}X1!7i;`}6V{vSwqa(K@TC*2J4oRN?Y
z!9>UiU-qs0p+tY=<(ZT{cbi(EYrT}ZPAehuuN^tk_=w=ky?ujXB995!03L|z486F!
ziT)>GY3jNS$=9oe`ClWfbsFz~d@skKJW?IYFw9F2^Ifms4Ju>0>iH*QsEnu7!_}<5
z+jx#?VOYLjBwrD<Q#jC%@^kWp*tOsPH!Nr>@E^iEbd<n=P!s{rg$NJeyC9jvHKtFp
zqCX4Q9TP+pQVj(L+gh5R`r-3qfCHc%0r_kL+l_hs&8h#3@vm>jC&%fw3<sn>3`_+8
zO>g7wFEeuT>&=r)5Hw}j0q{{=3l)!!=Jg+z^KwQ;n!mZ|GBom?elMB~iYho?k=i-Y
z!|~l93H@+oJu*s;9oLAgRu3Ey|L;zQ_v?r38N_Ps^b}-6Jm~S$-;<IVvfG(w;I_n*
zas`<f$9@>!3Ct?h1cG33nPl!+Y<{eKeX+@xo7;zVJ9o?ELRCH-wz}D~7%TZXb3%h%
zd+P_ne6Zs=e!cg`4{(QZT(Oe8ytBi;{9b*^E%l$DmbxX&z5KZ~Jst5YiCgb`Ua$9k
zt|Rq-iIGfT5Vru&3pLML6gd*#pN6o)L8?L>Y;f0U{t?zdLO?)|4LCet51RZZKr{iz
zj_t{$;DUB7`4S8QCHtx+EdTIHGzW#?=o!M7!WeEZz@QfNhTV*Q=Tk2eZ2=G<4sf0M
zd=Ybi0UQGh4{?!Q0924K4e{2<lzb2xa1jT8-65zL=qfOmi=#kCUmG-P!m|RtB1w=C
z2Vo5ZJtBPkf0;b+O>nx^ikcoU*Z8`?!8g;lsx4Dy|MPSVA;8i;FS>;zw4aOQ7B*vE
zc6oVhj_^^&ng~xnINgCeQ$NM<yTE-MKb#mMU~Ax`Nm8==GBWfye<kD}CV2SlY8zO>
zS~TCd0Qa?AeFU6jK%MzdI&ya*GM|kN4>UIEN8eaJ8<K40Vi-pqHpB9FB#t8~>_qj(
zd-u&mI4JN9a9;=<A#aNUw;+E~j3rwBCz}rNMf$l4aa?H!&G<uS)Tey>PcBVMA^YIB
zyVJY;Bi)aV4hPqKlGC5BNx>!=x`t5V_$8#wID$n8>@)o@a|R0xe+AN_Vot{V9}(x#
zhpwR~Ck7dU%K+wOj#SFV2)CO54@fXrtY|9;Xk;mCdWU!({A7pz`3_Y_;a)T9n_{GJ
zc%6U5^a36^jm9ZZ8Z)S7;jZi>B3hc1|HNP%C`2ZF)m$U%Bn_B##>R~_OvB(6AH{Im
z$JEY$#72e3@cfoPg00IV!jeTdk}NhJI+_JSR+$ePz~RWh2l=YUW#qf%;E!^Kw5jl6
z<H?+?R*Z1*|Ib)(?_sy(;F43j9v?k%p8O%)=Ljl?7;mj-;yEf!{nxL^e?Rb+_h~(M
zPk6owGhsplN-O86@$aYd^K7Hw0Dfy%o0?<^nL`;|d_QqqDU|9Aiq{Vd#^#sc!hu^h
z9y)N>+@B{T_?EdgNuEA?!wKB~*AXN9bWJt*`p5+p6*~ZxG+b~#J_+XNF*Y1WZ@3Y|
zTOr{MsOj&=%|5xMjK|r&X~NL!c4X$5K*z*}_$RTUAR&NxlFa+x1-RArQxK%!h~YhL
ztzpx?ez|eXxTE-6U;pR+CwH}v<=*~V-|F#P+8arD?M|M_dg1jzf6ZcA`FR(vY}p$J
zzddm>-+Vu<qqE1$bIVm><XkA=CI9$uFhCN32VIb57twir>$(v1Cae?*#qWIi^2SDb
zT3$OO(P<!_Jstl99%JaKJ;^zRRLPd+PyDh<yE|Rd&X2(zhc$g&;ni)A@^XA8;3eMy
zy4U`1{~6u30x%Nt1%`%Al3|6%G^d1VPGE^?=<DG+udp!uF`pabk@g)M*Tg|1LhFK{
zLgTI+P8)|j-Fi+5=tTj;=y}*3Ph;V$8Pqc1ri^G3-mBjw-GSRDCU(ihMu#u%Q06PH
zq0_#8xG=7HV_NEprT$@^rRx7B_hMZ{@JU>ud3-CCt-u=r0i>BP?xFaS6qgVGtNith
zgTPU|cl=C$AHA<O$}~ywIm;k79SuXUFfPA>dI7=*58-JRj_j^Y11_{B;oJAvGO<cD
z02OotF%x&5ANgnfa#uQE1#-vIdBh4WqUwmN$TfHPB%(kQpWp7;0>?QI$>Sqmf-aL?
zToFe^E7IhQtBTAJ2F#fs<j~n!l6WMvAD#pE!!@!%-c)W;hyN8v4xex3luuWDFKR<A
z5G8M)@R7;){Fi0oH_29}MdEqnk$2Z!L0R8FT%30Q^VGiCf0XZhUWSu1=dNEE|GVCg
zwkw7^8CS!Idb*8RY9H%@+0!85fdN(sRwNr4*>T~R$rI|sbLNMxDlj0h2Dlsyc}!EF
zUJ0ytdi`VN59}1aP8I3-ZfIuYj*i7f{pm^9tDd|(i{bwU8AOUC(^;rE0}Ahee+vJG
zXAmq7J~>o$^YqZa!8Hb90$6Nt(o!%s_1~MDj-Vo-ok~MNMaH=ExAo|bNyBVv8-Tyd
zDoE7RP_BCBOqKXy*W$nZoJJ9d!{>bc@>vH}`S8z%zT&*!{v6XvwTzxUo$He5Z}6XY
zyuZtk>wggYd`ij7<-uI_3Emz5*9%A^4a8~ZaqM*xjO;&Md*La0(DPFf$zh&SpYznW
zGHCzR>w-$-V}}oh_Ur160xwWvFK_>on=c4X5C!%It<Y}AC}3A7C;$YKF9ewbWir}D
zClzCDk=MxotJe`M_F2LgF9lq5cmF&iQ=P)(l1B@EPdD(z077RAupdM4AE6C{z)%|i
z>yCm-<p1Jeyzifh;T_U#-?|-gZvT62=Y0Hc4PM6UD8@8F@^$E_jd3(n!oy`Q`LOL7
z09S9%Q-%=4UepEp;KN%W;u9a`jt2yAIxic)#7Y=9tQ`x@G5WRUr1l?(#!Pl0VhR2%
zoR&lAWZ;uRgiK8z?u9!S#8h%(__r=U^JSA?nx?0S*A+pa#-}_wyWY5S$Dq_<CF2US
zANeL2E(~Q15q#3@dR=RqYB(f3y<IoO*Dj*Q;RuPksGe<BW53p?<h$#hu_({}y&?PV
zE44o^G#0NH@SLHT_;3xp&7jJn|Nasz+rC)gxA@^d$&@)EkB7CQDjFq%Ct3-sfHarp
zQC~K;KN+^HOmhMPU@eGx-r#BcMo8|v;F_6W-x^-PoRG?VzE1N&b8}KQ*?Pq%4Pg^I
zV*xBXPyhPE9=$&d%%iUv*ZemQLb%`tf$E)jKrRI1#)Scg%f`kJ?%7f?-;&S(8WfrC
z-lqKZja>ihz4A{QQ>F9O>W{)Wn4a%=?pmvoML+UyaU3}s0|2cga7*%~ZItkwaBFxV
zJp({xY<_xzM$J$ET=kh)@$d2Hd*W|6#4^3v(zyJm&A~M0i6$LWOJV1!M^6cp@f?*s
z{`w5MP6=~twM9d4{Cq`Xit6{n))@~Zq<T`Jq|*Y70Scx?R=BT@<3ISlUJSs5`~*Ee
z!7}jF*xs=y&;A+Xa%+i3f8@lbzjo=rh@0|C!b{7|?~=nA5FCZE7JTQ)#BX=M!9~a{
zV0K_6_Wg-puT9O;E%>h_gAaWR?Jr)gy)Rz)>X9!(Hu7fpODY1Lg(2~g+R26@H_yU4
zd2Q@JU04&Ad|h%)%8T=IM5<SJyiZ+C$)exCpQ!uH-S%(w&sdaa{{(U+mu?qV`KrRN
zf;mC}-fH*B95VJX{Jg#=mbJyb^R9LHDx#b0WKl*y0MVRr24(MptOF{N3Zas>gaYuz
z$KZ;WU~k#{{Qd2pba$VZdzXpMkzm_wJf!Fn#IJl1ZAfksFmzzh)9=rGc=j8KZ~b*k
z70uzt1Sg2+t~z;#>zB#bcJ7zHn_d&?6{dlaQ(Q4Yr8*@+Y2`lM7|92ND1=8hP2Ub|
zjo{_`&jN5sbiVO5*RCT!UXzHolOF>}ob{G-L&7|<v9Eq#Hr=s(T_<(l$M)0D3rwzF
zZ4vYHZupEg%RUIM?(cjS%3_fC99k3^02%;l>*9AHARP*f={%A8ZEeJ2`MfybZoMxy
zVn>Y!;DU(+hUO5Bo3}!QjYzWfOvxot{u!r?nrIzXxi9z0R$qcjcC7iR8A%5gx}SyT
zNt6&2kQ1h4F+zwzVdqQ!3#lM9ZI0CyY$r+8&x-S8kVDTAmzyLp{6uM7XHv$*t@_1W
zG2z`Q4yDYUYYZt*5eQ@WA@2Q%U#tCJ>i<{zy>)-9%hl}aZV~I#3s-CE_toYQv3!+W
z{d#V`goZ2hFV?Oh8p$W`|9}5-Whs%05*h@Q?zGT%bX`?Ts>_%t6jFnqk>CyD_KLL}
z?04F6a$>D>bB8xyJ@{GA{k~gPaRHlhJ9m{LW3gJ}?@H71X>~rjJ(WIkRK1}V+B$(}
zbre+|#!v`CQEXl|v2Z3mCD+5Un$DA+vaYc-Vq}3eDCv~jRbeV75OA0DAUU9<riaBc
z%?!)jM<XNy2pP}p4hXOqpBnLfCqW5{vr2J^Omx7)uMn^Z$vcv4VCO1%@#OC5##L0h
ztht$L1r(rW;}+87pdRm?|7A*VQ**z3|H6fX)6Cf5po*1+;)&AMtAJhx?7>msim*;Y
zvccaGj~UxND)xJq@Q2f$cNUt4J93RUPfrax*^ARQNms|GmkV3(df$CxY?Ym4o@-y(
zJ+_qWPP*;+>$)x+Z)#e+ELA%NR-$WGw$iF~y4$KPdquzi04Z)knm}p*Xks@2QrusS
zdclBhf<+Ey64!y@-9bT?GW^5@LJ$lCFhc{Gz-f^}O5feyK{gq?&7BQeU=v~<QY;(<
zMbV9TD*&aTHrLt|QuM=*)g3GcRwa>K#!8Ay^9BJCaAKJs%`A#Ym5e8XPGIm3oq`h3
z{Dl+%ZM3G+Gj_k*DV{Q~ET&3i11;W+<@k6oSJUATh`62wejoucCzxzCgkwDCVX%}2
zs}RpL{Q$#QfguUKP(&|pZyE&D8Xg4m3~&y>%6N<QsA2tpJYk-1<_VZdXcTl6zG4K6
z;aHZj$f|f-W^94FAR;pw&cuKy=slL%0j-(^+K1jj5Bz|O91^Oh&D`XE$dFAFvMA?}
z5Duy3zy$;dv*Hwd{Qos7p-sQvdWqkrWvM-?g%$7T6JN0b5Tpu#Vm6yzF6WVhGAmn4
z+kJ43`W;w<H3HxTDy$*b{0Lw(%$p(Ke~<I~rP;&;K`pTp%3M<#J<r?~GJs3znFn83
zo^QVq5itU|r1{~7q?P}B{uq0F+Ya~mLm0mJg~To)c!m545fSN)Wr)gv&99WG3!wnm
z$KXc8{2W9?t1_f`&t_pa{nuf@dIQJ{{%B1z@VgIr;ZFsT!c4<Ll$f{yynyi~w4ob+
z_A&z&o_zlgn3&`9U!R%)SbWV1FaPxdFR#EBfTzDd--!r>ICe~^MPPhnuIJ!&a<aqk
zt<+-#Uz1n3tfx`s=^M8LKR18@eP~0a%4`4mhzNx|ClYKLGECfrCZxL`83C(ICsif4
z>De$fl2Nm5HUUFOJd!)`6Id=S#j@J}b!Pk|Hqhdqzj!}>COe2Q0IzWYy+CtM(1YjX
z5eW^10pQ6eSVZ?Rl944|2H4b_2mf(JEb)ilApZHhI5jLlL|+a17i7o^H7$G;Mes0*
zC80qJY)0_nfa<w#_h_EtPKi6FUy7ks3MdI4us`2d|JzjXauF8;5^~FZe?Y($`Yk^&
zBum8V5R=wzz>>uCtzi;;L5V**{t01X2o?({d_`4&iwmhbAk8)W`b>Kn22TFh*U^x;
zd^i8#7HHw3ixAWWN1Wh-6o3cqirYZDz7Y2Sp{kUS1PTB=QRkSvm_UFWXDz}1IyB{o
z2Ko1=km{)hLT$JU6gAvraQL5y5+|2GGy?-BBq;?iSpiVTj{pLW6lWH45N}}Qgqm^h
zxu8y<nK{>o(aPX<N&xYUsao@F#T$GNw-A-p7yoDyfER}r3$qAR5C5DUUz&uCo?Msz
z;NQf8nBbbj75(!L3_~6dPZ5K6Y8|;O0f#gI+n^kYX+2eA>xeT7-|QcjEPqINLpuCl
zjPF2!*39sagq&{_XlS7O-{LxG8BH)f_!90!B6~Ob|L}(pRuH!V*?*1t_bohMK0fcn
zeP8PT1XtFZ@Ny(~vmRgAU-tRZBk*Ae&=?QA%b0><4q^!7FM|lm=}L0`0v~a|r$)f~
z7BX4y%+b%mL=;#t*8ah82YkHNxTU$l1iz>(jkOc?5F~ttkrzk>{`e#JHr?_Mr!G;~
z5Dz%Y)5tp&KLk!Sr`&%3xA=h}45sfv_yw(yHT`I$cK@X>%hfys?qF*a;r_>PH#9F6
zCvV@a#s(g501LOEk~k_#Af9lDM*%6CcJu((K8&|BbXI88fD}^ssB_;ie{Pbsvi*Dx
zRH^3oAph<U?==9vbf!1ezy0WcKj9I6I9y=A2q+zsH7mZ?h>q}>Q~IEa<6(qvN3*!W
zS43b-h5vAo`UA~24gbMIiF5Elh+ZM)f}QeXW#7UORS^ux+-1-fSdbu6$dmcnHq-jI
zNDyRTOQ%?gX>W^=friykfP#Dg$5r#)^Z0=w45h}&B8M0PhwUwSO8dFlcTN)JulGC&
z$%$u@XGib%z}cc<J<+?jeaL2QH*gB0MDeETcJD6(eRPIr6Vm_wco(_604*f60Acyq
zQ9xhq!Xuyt%EfFlm@4uIB|ot0fac`_2-rsz41GA5J(OeBj2<0j1N~VbkL?qw$8-!Y
z*7XN%)O+ZWm~a2F21yl2|K1-6ct_zb2^%-+LfoMr8&F~2_X5p>s*w5kKa&xiY$yN!
zjrS1|5%_<N3S@Wc)*E>RnU0XK3O3jo>R)GvktF$fo6E!gYvLD(5<Uv~+n{mJ-~9k$
zT8y?YKmY%rPm0^+hkjt<fhHHrJN^{7)X}f}1ZGT}6-TH4j{{j7C)pVr|JuX}86d$3
zpK9PO;Bh<TAz5%%#=iE1Fg%>N_!F5Jmdgmw|MmTZgy7GbQ()F=H;~o2Zx<@fM{8cW
zVXJb%*{G^9SLovLcTgRvhTnxuRLZ}Kzr3+iIk4+~e1SA0A0`Mni6$Tuw5cRa_yzN7
zz!RCZvkPcZTw78(|LKHdx50@7!Hweqa~oA^+!m#NDiz=M180RDX!3+p^|VApN|G}%
z|LVyR5~CWq|Jn=;Z3Ug^vZQzIq9lc+ld8Y|w2>icBvo?%=s27{5&0p=BXz(z;T&)H
zdpWV<0rX!O9ct~)r{FAeqlO09Q=xJIIPW;-H}&rFkUnZ(i7%KV=nq2i1|#7J_!`K}
zxt265|FAn^sq#Pn+VB@oU2@Ei`}IldA|Lnq=>j;~wV4_JFcX@^?6nbZ{k#p)vT5m&
zzyHgL8I1q|@UYFs4YI0Xaf}eof`F<FHOq^N%qa1&eg?e447jdj&=`BB8t;K;R^WIf
zw14=^4JlQ`G6v20%&)`V72JiT`Czq<3tkQjSPW68SNvqp<BJl!<cAWm!Piy~*;R)H
zue@+t!NF_%Of0V-uz-uawhpmcVkg^gKNWzP?gL<7;1M?LdE+K6u(^BS!|gS??djE1
zn%d#VcB0sz56=vb6EA1b?)jqpkF%0rfktos*RVJgdSiKD&i>zztR{`gN7uKGe~g4S
zt>m8n7_?ztII@p5a(_uneCZxTbryJh!FgcB$(7mINg3jR$G`Kh$Xw6?4rev^JVxs+
z;~-Ae!JXJ{vZi<-9S3hfnU^mDg38MUDZ6pvKCn012K$=o;ye4g-6=Dh@?qVShkvUM
zQ@3pP{Qnsk+gWcn!w1t9r|0;?-&3VAEX%?R)f#8}`k>DF$-c&`fHE~Vj&FCjIXK@H
zkM#fl`)cmrl{>7*RDI%Uk#D-K`Dv&0!-jdh02?DVgiPmh5&U)n#p^H$z%mxf7(oN%
zLM04h2TVrVAd*aFKJyLqCYpCU{=tV@hjIb)%?k0rk5Cs?Fvt!k56yu$*LV!TBZco!
zm7R+w3?#!94C7)1g04Cc9~15ZA1~qos?ZKqV1?{BlE}<Je)+A;CVGJXTtqJrB!3)i
zSEP!L|MUlX{fQO*?)(s6XKiQ4KR1fGC;^SrFDHNh&7@?8H6LP_@c;aF(ZMQScsw5u
zR~MW|)jYp|iIJo-cN^5Sh70+8C2No>gkvMX3j+Ig!3DHD!-<ZNiLf}lI!0})q_3E7
z{mykQ`1a9_{vY#z`(gHE*r<`2vw_N^8|{L=b*=X}&edW63c$nrx838?@c2i<ApseK
zMQkMs(hn5~{6%tOq9D=6LJ|LOhUL)M!v$dzQ#zbSh?A4GH26X@cokDv8UOQ|Y$|WN
z0sePsz2={>$ip4ej6m?wSgnTk*Z8N?n19(%zVJM#KEjQQlYN45{->ao0q9qF7xDU#
zL}OWVG2wZv!$1Hjkq*tA5oea@bc7T_Fs1~>y4VE9+%#<m*_&X#Y#(Aa#VTeGc<@x%
zb#PNK7jGXUCd`VA!MlOdPT*+)jMOo*3TQh+@cXYujZpsZ>-9i?Mc)ap|M&#o>)6<0
zZfp~5e}nma6Kwxr$3*^ZfkG`YP@Dho5S!OA-}pjFuSyDBFQ+-t&%7WYW<ACPE>S28
zU<6B{lev|boe8y^#3(wmkO87DSWHQxJv*ojPSK+al#XSI%-vcrRln>;7};>841+)s
zJ<JGP1^g94cLu~EJnuFO)(B3kNMRqm4xXZXe}uoVBs=2krEnX}IFD~fJyimJI}jEK
zgO6a?R}E!%1}RI736<kZr2+oQcp`?*5sZ>Rm&A`}t`X^QTL5@=U&0<6SVX+7KaIpi
z;yguuAV<O)jtX<fO%#bRJMZC?j%$zod<hG^{9uQYit#?{<)XvlcgPM9FT{LD$St|Y
z^vywIg;)5A55?<L&}uH6xo64PHQ-L0xtJ}W62dT!3|B;B!UORDy*c#3qPP$&3JHin
zf-A3<i0|kK_q2bO58bbH0rSK8un8WPeUN*;t7GBq;D!lyH3UDH1fTS_|LUH}B10I3
zh{Q%jRqqk<O&jwfeEdvA^Bnl{!7tSDfWK>)AH6@xw(o%QSMdTukjf>QYhM5GKMyP{
z&ra|B_24`boF@ZE?=~CD=#U4Ak&3R?_i!TE2=TyYl(P@rJQW%L(kq|}Zhd-rO)yX2
z40?jBUXVdwK70BFUOPxn!W2RTI@jcb{%iOFhE;=~bbz{{*Ub4OldQ1;C<M)IANd2k
zNsa@vM8%xAAcZ0_VG6_q{s76UNJs5QKTcloAfWa%yqdxz@k22?C~5D|_Q&PSF^(jQ
z{SQV8fJFeci^NiVB3&3gQv?&HM$`NXkcdQ90k3TJ?cM+(g)#Ofaar;m00J~Jug?k%
zo_LrLhV~HnfOaqU@N|!5`(cP)?@nU>Py9#SxES%f3iEGre}!~70ictMP2ZT{W!CrO
zL1v5x41749)kiPk#r;ifHU7Sr#6ed9uJ{rIK-BSHjAGwCzUA*KBWN^$u>xjqnUBS3
z8)yzp_=51<MSMVkSS}Cm36>B4S}GJ?n0|Xk&b!-x2tiB~pia96^Qhnc;5MUnU`8G<
z{1l=Dfx<`~>pgm7`MEQcx%@d5H!>?XTvkM%SLFhp5g8f+s{#$nbz7wi!~_zAZGQ@S
zToC{FfFKLW7|3^9cxu5i@Ir?5utEgCN!>U4-h|^_OL*{%9#a8jgctQHf9>yyfAdE{
z!=yx^`n|#!RwG>X^1fH+TsHszvB&Oi`zAJ0aW;Sf$I}!MV@#j=Sb&7e({O$k?|8&9
zroVjzZr?YJ+DWZ<GV6WQ|G`DzAc0O15IYA~gv#|TaUd1l*MDyT-L(?-n=|#4ePsW~
zctppw0%!aW>cvC~d)45qA+VqS{t`K}=dYFWzdG?CKs|iWni6nTrI)|g0(boX?g+UU
zk*smP_6vfnRIQ}#x9d<wcuxG0o5R_poh^90-SI^p1vo@NS_?4(EpZ}XNTUy;nE%5f
z8PFWi)#pPCX@>kdZ1;oVSc4DF{vc0dl#2u{HLM-1j&37}UM3OaAgBWW>Sy5^0&CL(
z_{b)=RF41C#=6@(&OwL5FiYe5er>?OhhRRSUw6bnIAd42fncXlA8!XMa=_-?xA=>J
z0s)MpFE??_eW$`4%YbV1IB7n723B0*AGyBrc;s`V0*?}J0SkEnu+fQ*$;cQFrakaQ
z(XmPA_~6g*j6@S$#ApHN2M8Xf@Zx}t`|jBucAq=-&p>EuS$u#0eYSog31I5EVmIfH
z@Y*289te0JdUMnQ&Z9T_Vz}r<=?qhra*Q>Rfmj>?Y*}v}Omuj0Km=ZQb8~T%8N~Df
z+`|$lpZ`UR;S*m!;$|;gpZD?QZ80RgfwE`((}ogly!8<d_zxQ@U=ayUNtw$24`Niv
zJjl}<<*Br=;l%*X-`5+pLSbwoXTSRUZT=aFp1^t0M)L9ge)#88bR?WL2D%QrzGznY
zJbN5Ku3$rX<paDXp+;fr3yO%8(BfKnFKa1pym^R1IS5%v1AwInga%(6CJ-<r?*r7z
z0TYy&Ibjx{Hp0UT_HM7&AiMaP=_Fj%hm#fpwTyX)e}W<p&xG&*i2Yaf|Nj8A_*w1{
z6I3K~Y#g^0de7+nM2HCCu`eM)*T76|lJ~$6x<GvK;qZrvn}y+ko9Fd-D1jLu*l(Ev
z^!2|5_b;3(Hu`^;z)@|l^#JqCv-=AW37{Mp?oez`0CC&c8${eq9U)kdTQF|q&^R!D
z0s(T{)EZ>5nBV(^BK!hYrw86(5Bq}M4agbC<stF358~sAPzMu5E#T?JEb4z38fY~Y
zbiaanjfP7%9$ugz9R}XEKb`Zx?D-)iF>9}aXgzH+2bR+?di2a6dS=QN|1<v!Y15}o
zKg|r#uB@(mzNCW5F#^6AU=c8_%dhaqi3{gN(n>%J@U>X=F%|s^yoh)yLOoPpK*&xO
z8GZl6+=4I=1}G*PA>N+wevk$N<qv1CcrfDms8TyY+OeWULwJC`4wqnw^gxfX34~uz
zTOK``U;II1g9pJ+gav(Y?3N@pY3dFsG{VG&1mVdg!*lPG`B6Y|aVB&8OcLhJK;{3{
zh!1ZpC#(<oB4Y3a_Z&43|I8s23@4=@);amTlEMO@iLz1`3{Jlv;=IF%zXb-|07h>&
zbiPABo+xtN&(t}6$Pc`=XTSOWHFIOLufbl8=qDhrr2R;3fWp2!c(HV+cISLH_Q%No
zk@7$7^{oWl0A2EI<3um`O0rN1u1Rk{&*R>|TCS|FCmpAb(#V$#39NWU*t`Y8pN@I(
zfv{s!;Q)wQ_l}J~mnDq7e1SmGf)c?P^H50f_Vqe{1^i|NTEO>=hGHWaAZmz!tI}EU
zeYDA$W!^6o&Kl$eouA^Q84LfYo2Ea=>);66;&b|Vm_+?0UU0-FIvSmI5tyE60jxsY
zQ<^|30scploS*v$&qOr(QP5U%u1EjwzAg%iE~U8$bAQ|iM<W#_rfwu6NQP!aegESJ
z0Sie|SPv9N+JyJC2WUG#j;GJh>5vA<WT$=H!i?iFkz^C^{}%zXbCIU6)<{WYQYd}@
z+M!A#c0n(nSo7Ji;;BtM3#YuaxBZ_2s@6SC=%4-IYIZ8;pGl{!vJ<|m#lYA(E3+kT
zr-Q-NM#ZvE7yt!<8d_lRj6)LvqF#j+>At(AJb6g#zJvQ#wwmsExB&WXhL;I%Zv&#J
z?y>SOFVC>e%>VzY<m;8vGB@xJV#_kh!t?*tG4I}#O`;U{i=Vh*3yH!UY)=OkUr2*6
ziSR~-L97^vOrRr?vP!~y9RzFCQgDPX>jejVr3>xo2%xSw|8~w^3k9I;JSd!Sk&F1A
zukeQrxDFQ~Q$8F@xeg+iJ{(0ZLx`os--uxlFnA!tm}w^OtjhieN!*7>?j`>QD&`;%
z=lGZ<s<W!@c#b3@KC7+saafqbgA`!}7w{OHzBB*)ARYA|0Lqg$K<0pKg|(PGL`2R1
zkKFi>^m0QhTJH1MVEkYeFbZkcCQt6*ADy|RKl8y&4<)r7kKLrJ+~NZyJin6r#hzS8
z+@H?*-0Yy6kGV&=lzX3)dznYM{Qh^Ydp_=1THu=ndSq9oR?^<-LvEc+S#u7m=i${{
z!>YOeC&Xb9h9kpn02s}<O$y|Jd1<a#auZy?4nk{|9E8_6B$>ycBx5${ddRi_uioIB
zUfv7%jMt^$H-QOQmc#GQBp`X(3i$oSN59@aq42-uiOI<cmeBNLzxAuMgK={0n0$Zu
zjtH0I&thip>uLHy$QDiZ@B4<;VANYZ{el0)K%R*FN7EHQR5W>+$T#hO-EB=W6QBRT
zxlC)fdoCeA_lM##Mrtutt9XsD1a6uUx56vKw%2G?7nj^0{6r9ZpQGjcA^v~kWy%=j
z)yo<C!@*3HY*jE<xBcX2Eu?<uzuzU#1LhFIBEAj)20(y;)W{wHFi8dv{y=;H#F+wu
zA@o@Qd;kOhfH(0!!)^dIt+bm*tKaN@1cPmM3jj}5tY7Lt+JH8`PCfWhs~-<BT!)yh
zCH$9j@PTS6`Tiz)`p*3S5)c*3A=++0!B`>qS`I=pCSZ6{5reR$U(V_NRd+YSxFzDu
zfXw!%@&73zFz}y9o~(8u;sg9#bj!gjW(76B-|&c;*PVD{+kgObzlKD>dfH|n{+52s
zNExHN9R7E%tgK7R$66ME0u(0T8Q-s?)$WJze)vEGM!EifgaRQ5I7kqr$B=-Fgwh0Z
z{q7;<0y1V`5gOqG4&x5b>)=t~p8%WC&o}@W1ioH}j1U$q9A-TnKp;I>#N*NAZBsFE
zAmA;4vu1BS;>QZ;I=x#@Px}UNp2&f4#6SJl#aMY<|AGKTgO{YrrYUi5^$#ZtK>HI}
z3FQB@b-@ty*2MMXJ;{8Jkw$m;bBzXp*T=?9s`I}RAZ&0>c6^ipJt+7BGjT`v01ED-
z16NnZzxq0-re7$C`2~vB5fy|^PsPl`BFF%A+u|Ah$7&==xB<aQ9?*9Bx9@^@L%D&o
zr;x6i%fEGVPN4)mCBPRE@i04AFe+W7v;P5^UX#DUTnAEQ#NY~7#?W<IcQ7_||Hr}!
z0We2)IsEU$#c;wPO4)oPz`O4m!S>~W>vGsBe?W47wZe<1ga7dyW%9!>md1WqC|^$T
zoT)vG?ps1K$VORqCwN2h?X_NnQ!+%&m-v8E?F<ZkGx)4(moqXLB_>Jv;&!cL0s$*b
zb%;GY3Ot&m&U{T`N>9z2L9@Vw`5@QCFNO;u@Zy=0AV4a@UEQ7kgg830Rd@r(TU0^+
z9X5-T11H(U%lmd&f&MS`?}&n7<^!`~KsraN37iWNaCVufXMg)`|C_)Ji@E9lrs72S
zMPWz+XGx!|7&o^6bF;@KQJKAb8pMZlSHY+XD9l7u3-k2^-vb=ILMc4r5wkLg_?an`
zW5bF7BDdZD`{3E9D3rf4_8=Kvk?#Ee{d~quXZ21noB#iS2rngXNb#N!@xZ_SJfX=m
zf!;sB-ZsGNPxf%^NPG}{6=t}dm=_2hX193AX@D0KzsbZf{6r>k*=cddr<s*l{6)g;
zRLg)*=UnexGYQx_vq$#6DpNx`{4WRInVLI!sZ3^$Bbxm0o#ewJurW<D$6*$*xU4go
z067C2Wsg5GM4fn7nCax7`R`!ppeDl$QFs)vAPJ3B9!oC=J1E?F{|^z~S5=Q2&eC*)
z5_CO@--reRVH3?=NB(ng4r19yh2!HZbD011V?8DuZ`bJ`fENAdV{e|Ardi$vyT2dA
z#qL1xkeQoO^F8ZDJnRjvu4W1%{GBiz6~wR_w<-it<vM;YTn@AWb&jmhGqGTvllbm~
z2^=1%By0FjU~nB6^LG&M_Y(!!1OXI`mUse2?%xzmz)bDCbj_L9?&4sg4&Hh#DSFvh
zMf-jaMpu?$f{4By489AFc(rntZxI(A$_4{<v)l8+9x|bzuj9Bvdzdv*zMu)6O!{Q5
zz;a&w<nG(q|Kc-~Tztqgv5wUNV4e0__?e_48h(&l#tdTgK9)n6Cw;nx3_igGUojJa
z!&Bvqa1EJDMd28_qR0;2a;xti4X(H1A)XDt0OQKc%rBa2sE9&@GKE)i6MZ%R&z%^E
zbIezewZa35i-lFQh9X&S!R9Y4FhsK7;IbN1U=Cu7CNdafo&h0|4ldlckGCHG?g`BZ
z*d={p0X(Q$bu55A$&<OnV1%`pklz|`>ggwkZphg?Zs8FSDPX{Dn92;E6(9E?KL(;$
z%YV;+WW>ynZ~gaxQ(#^@1kgTtDltt5QF+6VvG^7>MqmQ~E&sv&ffy}YTH_k`_T%9K
z<RMXZ0P2ihYXAA)!9e|rB#t&?0q<3%*PPm8-;B6J3MdG_Z^qljS?mAskMH$Yh?fyB
zc`x#2b8}7y4fv>$ma~YH5J=dA&4)VI8Q?<6hm0#e5PnWXY##iqgVM)CsCK91ANs$C
z2}edHHoL^Y^9ZLCdZbz4+B%EppegWA2o3;(icW+E&DXpQ#*)GVs#XXld=$bsDmYs0
zJUGm?$GX|jgQF8v4;}mVAuWNtF?c9D`{vI62nAktfPyR^%`hw*kqDKi9`S#5Jnxs`
z46!($Sd2z|;Q=#IelnIf)+BBe14%rkTR#95u@>ke=|{&ieZIpoyYmf}=<1dbg3iMl
zYHY_VawUEPaKj{5Q5@rIgtq?!(+L*G-@B+3_#(j88cR_DRM25l|3VGg`*U6j1k5e%
zhy91&BAwSlF3*Fq^nPOj2Z)!xA{WC0swMQIaMQvp=28P^j5ZLA!Uo2wvj)NfMOd-0
zhY1<hdXRYQ5EsA;yJRORDfA!v6u{;V`;bF+3?e-ghV6hyTOdA}A7m(2*hh`6ApQ}B
zu)sSQumwCfe1ma&J-GklA2m00-~0-gARF4lqShal<<9T3@)pe5#HmOgcmWS7ATfiR
z9V@2ADHu2g?OwKG7iGH>ehRUu#9u$*0r-)++t4|!cF|me&SYOEnea}?d$7?M&l|^K
z$6F`dvCIAiJVr-kfcAjf&?(PcDc}*Z`8vUQf8svgKPw=>$83KiiG!|Oh9i0pJFPuH
ztHC@0MDiYTcOsppHB3M~A+>;!x4G1ZsX&{b4GtB038y2Nm#5$VcM=c;-+;#H+~@zn
z)%bRcXm+#ifB^*pZ={BB0<fa~WZz%^gdUVX5}epW!Vx$^CLkdsAs>Z_vZ-(gza|~!
z5D<}3!l2gzv-D{L@eiLr{wu(dyzg7Y?HBS6!M1nP#y~OpyGQ-(F$KpUJdy13ehNFx
zOyFLcf~qFT50J}q0<=hgrI-k51^gju9RJg!K}=su-@wjBUbK+k{(r65cqUsFmvSrl
z^hCCR92pOIr4Y94@8JPZfy2&t`H2r_{txoidljb{p9B#e#CVSp;yg#;i^ComHWT6>
z6X}og&jd1Yupkkk%dnmP6z~II_hY{7Ebt(n!2VX5xGu;Ib^wLxo$k%jqfIi6kq-@$
z7b6|m*9hQNi4Zn$z+lTmOc%ui6bZbhMk@dFZU_USKp9qUa5F~5I&M?%kElrF``(+!
z|KR|KSWuBB?&Tv06#|>LKk)Yi-T>^S_Yl5-{}=Gvme%s{mjLW><yVi94}>B;Vr9Y-
z!V=id7b)liTo8B$GTGyN2pYh=f(r<T2GA6^XzyTbdy2z|tBH8h58_8a)Df*Cbwvu(
z_#9Q5@ypqWexoI^#c_}+S?7ZeXc^sEQ4O#7xl}f#P}=z!4$D!K?2U`uzs1acA*k%P
zj)!3AclluGb_Lz-_>M2f$s2Un;`v|@@GE3ilx+*%FPWYb0S@ow*6aCrN?tgG&AGkv
zQW?Vnpo@{3oPcIo0XkJn_&~4~I@W|7t>-!$Qv}_Jn&rZ9#1NheP$32ePZ$M5VB^6A
z*kId@4~OC=h|35<Sp)>&1K7p@J{so08!n~>djJY%MSGE-{iwmS*nir*A{Z0FyoOwW
z7T@Fq3be$*OuyjAij@covUAK4KBT>>(B^{0-|>+#Cd|%w1k=QdCRs$|QAO-5lIqF>
z+Lj96C??f<>i@<~S^^XW;_c$LnPI?7VBjUROtL0fV%=5*+WP>jRs`DriGxHqrp^F0
zGTGW6N<B`kPmhS<7)#0H4aDR)i0|NG_yFy?z0ZH2ja|tXw7t@lzwwqY{sd2Bo3u$c
zQg<l2ov;d`f4wGhic?e6{2`va+C2X^{TdU0_{i<wU_U+qyF-;*?GH45%h^7<ZGW@C
zB73m^lKz8N+lx&8{($q;{2_|D`Zr{+0pS1QWqkB!sAXyC$DJo^QfIzkYxHk?2X;HN
zMrwF(5H<)pwFJ3rREW9$;1)_KZ^m}>$QIre*s3bF{0UN1jTZ@2zVJd;%T10dyof^h
z59o?y%T}jg#H9Ks|5>t`I~K6XR%oYj{u{$?o&F2;4OsoF|9bV*_v#=(PCOJo0tM<n
z4uPSu<AC78Z~wppmFdXSLHN8$D&~Gbqksf2cX!{zAtXQlmT-P(`Lg@s1QNh;;DyoO
z3IG4#0yh7Z=Li#qc8UXB*{%S1Z7!lp!}j>`*aI22Cwbrrzg^jH{E1A=`^dq&cJBm1
z!aKt4d%w|POPOH9i^3msQ+1vGAYW);{A56Zxal-&KuB^yV)mOG+y58C5hl_{4!6Mr
zvWsbj|5^XNPx~%_KC$s2N}0p|>0NJ=2EFht4-i<M>p1V7rh`(7wM*h;;3474T~6sv
z`*w(vCPL=DDli7M5om5%48Or1mw`MSY{5?*quYZwOP;SjRwL!;Fx|};1QKBhxUNWB
z#(=+sFv9)_nXPaB{t@vP2!suWoL~c8{dB?WNM5<GUOT`K05Dm&B3>VBfCK@jfhJl7
z$-t%gi~<6q%}fz8ORJ*fp^U+g6(caj4G7zZb7l+9Zo^6Cp?kyt2UslO>6LLAI4mb9
zGHVLa{&$NQnJP8-uz^@)$0k4hpf@`&vL<i;`W~jbA2Jh?8?}=%WsEZ;jTQgJ%2OsV
zA;*}Ja+5{}?@m~6?C~Azl0E<v!X7t=!Cw^huK+mq`G?`^elvPU(fEPRnW&Hp%RjyO
zuz|QCXb+WWCcppS3=dbGxPXrw0;Eamf>y`14`j_s?yZkZ|Gl681UMmV59u%2T-XA)
z)WDC}0eRxQ?@;ah{onXg0U-6d03UrBCLi}xc#Ca_yUQNPS4h22fWdf5ioK0<|BNa+
z9^42s0N}kMTitNqz~zOrb;AJ9kDD`q)waBf^U7ZKgiT3db4h^I{}&@RK}epWH;6Ka
zo$hQjy(2VvdQ^BT<0_V1Q7FZe)*W<8GuUsIY`CD|3J~6giLg(1iq7BLfE{=&`|NzU
ze26~5$HDq-yc*;!Log-5lUr!1rd|sDt*ZlHYuR|8y;mGl;(}0Qo75PUcd7@q;X6?8
z!f@guAWp6|z<YOS-_-xT&D432!~{YdJ?{kinCgxm7@n*^MxhIa#}B_KPyhb`BlO#e
z1$YS?wf+XfQ~*~xm>Rx4a=nu91G&aiO(6Nc6jM3QaWIdLMifNAeTF#(3Jpi`7!y4W
zj|>?wH7SnHG-SZ>MEldfd?Vw}3NVF>VGv(!;1N8$KkOxbO@P0Mj%Eg$o>t%&s&6;t
zmNUS=_(lymD<UN|Jm2CawF2W8lM7Mq@?b2&B;Z6=8SK;%p{f)9hvRF}<?C3H3#nsB
zU<+=z3-ecH=3}9cSh@@71GhJdRI*TuH1OM82icggscRW!ZX#$z*Z8@K=xiKrY%Q8#
z2i11SI~!a-)NKKZ<9CyYhL$sae}H{_=+nWLARsR$;7Im-<kTDdAP_DA4%hPj3?<{u
z9t<Il5%Hc69cTw@mQ24ch<C#r9j;g%Q<lNNTRgBhDVA9>{6nqcV55OSlECdU`#g*^
z0!1wB4p!xpEHf|04RDB#5t9_IB@8QZGyQt_zC11v7S|d;Z4&@3SM!jJ!XNZQ>q8mg
zPEgoFzyufsauaIrs-oKMb;ftO2m7VP^I<OqVauNwed6+vXE;LiDKGr|446caXhk)l
z9(xJTV&M=El>=NN6@CAI;$cX|=-CKcezgFMtup%9TQ;pA-#83jm#^!-%_z*EMq##v
z(+2xnDG-0mNdY@!oAE{Q^7tr#)JQREfb+mHtgCCU|L7dRH$DU_vT3{TUI47Kz$_mp
zn|ELQ#ZQ-vgV$r?_5nwCuJkXPfeT%*OW!N~{;?5xh$0&NQgcB?7xVxiQa_Qb3*WTD
zPcldt%|U&`+dL`28CguwjDz{2+5-Ae0=oRt5c-NzNUeb*eR1DkZ&Qz!@AosmAqW4U
z#(iNJ8aR%aBi8^oW20LC!L!#JXMa96CAVh!Sa<7KfWaSs2OHklFZE19%zN-dSUh7~
zc1M?LQA;siW@<#H-|;YqINv;O3i}*h$ir#c{3FEt!+pLti~q&Wit;kxQOYyY%fa9q
zD~X%jh8Ick^Gu_$*hVjqv&*a%JR=2_3I*S02EM*8jW^5(^~~{stT--afH)0wnv5eC
z!-C{!1O;SjFrRWZrk`lu;|Rs@pgurgM-R&yG+G;jT}ub=7YUSdo=Ftm4Vkf=$QsM%
zkQ=`v8@RN;2>1dNy@XSHFmP8Ru)i93-kWD}bU5!VY&8$!BYS2xBW#;r6+d7=7@6v0
zk}B;uq@Qb|##yWEhOgrAanbfm-=K?J!B`gb9xFb_x-iV{f5%5|?l#s3eu|IY|Kp3-
z)0L<g&&BlG{38R75hi)A5D2@W!=4Zl?WcYa2=M_IBOU-<m?0X;1t#*K0CGmL(L&ef
z+g|@(y0&<E@b;fS6>pmQ_2<{06ckc}(qR$1hly@{pa=K&=+?{6lGEM_Mv#D)9o%=I
zCe~3rne7X`HSGj|H=VV2^{P~V!EHfo`bEInTiNYW=@hi}8-!K0(IJL>@l<1bZr)HU
zH~g+!a)m2#w}!NNN;+K(GLkU-J+a(~djF?NTW|F0j_LyvDlBzDIi*4bl{%6D<OCK2
zlXV2eLa2^l(Sj0{Y^$P*3MoN1lQbLMwu!X1%Q9V+fHg&RkWn3^*9i5|Mp#<*oyo}&
z7leDF%x?sx1tO<#pxjuAFE?*UI2!}J=Tpy*8$%0aq3W?Eun-Dj16ZzU#ESeXl?qT3
z26F&YiFpO0?Omz1fEe{B0e4Bv`B`9eoflPCs^ZW|3LLM*0zrX`o!L%t24ETxjf)$p
zTF6{(Y=EGRT>@w40vBvIpxP#Tl}vZ0virDCE<Qqe`kh_-tr@)5MI%^)KwPG2TIX&1
zp%fcW&52kIN#|Y_&Q}n|cQtyP?E>y@wZI`7&6mG_|NnAmq)9Its<w_t8xta`@DvnM
zfLf#=#SD|wee*8YwFp3KC+6Wh+*OZ2J~p&bXxrtKEz2O^kf+}LR67K8=cZ1J?PVlP
zPL)3-s>#x)c9oQ=$YaWV>(vMatL-R%w2Zv|8y;U$Qi<SQC0MoFWcFaYg&QME#nZKY
zJ1c&wg{}og$}e33usqhJ#WiN_SZvS(+D@35UM3R=%`w4};3FhTl$efVh!|w{r1g<v
zblohjNN@`s6iF1TD^q%MmBz+Ms=NgS6rg{`#x95%p8B=aNDl}HZKy;9<Dr)KGU#OT
z3^?F*`~PoI%-tqf8{lR+cD8;3YW24cLFak(<$H+e6)l0w6SWQxI+0QbI+lg5Br4{Z
zkrRn&Ye*F%1~K5`f~Wl&>(0u&-^-QBylBo)s<>}lleMosNKPFlv^fy0NZ$4hCjnUB
zMnYs(-~a$2DnXiHY5-_rHvm%H-19N6Bq2hAJ2!WCnE+8_CG7k@n;XDjLdXJqV9PL)
z@k)38b_`<X!(h`{pdWOlg#kPdd{S9#(3mr!NfWF3eSu~!>Ln$xG&h{pA;v>fa@qX~
zC;=4;PF9X?*Zpn0&~X~eZLm1d-fS2__%UL6;_DEL!QhwRGJ*glfeE26-@?M;14N4K
zTMO`@9mbb{<9NBS*iZln!8#uJ5D2{}Q7_KHvjm=S<Dkv(d|e#MSLc`UC>wdaHOb=j
zrT{7WT){%0{)iI2Y4IQcPMB#X90;*DWJ7|<yXzAf02PWMNk1IBJg^okrsMkC>*;_F
z<W@H_DEZ#o1g3L@0LYfRApBMa662lE(x1Qn4*$Y25j@FcV5p0!>W?%4GtjcV++jd>
z^#|f1cRYp4pU7|r;!Ng8_}qX@GRZgd3L}tnUZ3-S;hW!azm^!2_uOxWA}WR&l0O4g
zJsF*{Kj8?75S+K?pZE~2X5cfGuJ9M-4N%Pn@P`9=ByJOp>)&c~zyj1F$I?nIHGDUK
zRn1`UU@T&E3zf$g{vs}CJ;7J>+Xp{$H?STC-kK}XqHzH-`HP2VI}kviX^D*RL^?Er
zQ6@n-BrCQOE{L}CLH7H=ZM4W*(OUo`SneW!y*qhkGdxpUgez($Xr~jc{J`-s-h|aN
z7B~mf>Wn_;jUWqR&x#nE;Brem%}6t@_kjPn6Vpj?M;rcMzRBOPn*aZRP5y@7ZU?xC
z16S%Z#v%$ne?H(kjY|iL{UrPl%@e?NVo_jFi-W5Rdd67`_(BRHVru5_MOB@pV$!F{
z{$2)e(UZ|urnpW2_yoS}ZT~vdAtWN*H8_5JmC?3u{~rVdvD(KoP+Q=3xt1m4?<DRt
z&V>%3D;#Qge6|I6rlSSUewTobnK60DrDunTjDQ8R*i=PLB|D#f29-)l6N2VC80m;5
zfB`qtDS_mx#3p@S`H7ll_TXM#sKCj^_yHI+!%{PV=fDZ{#7cL`2BLrcf*$Wu@iN~1
z-*?|{&9>N>=m)-OF5tbZ34NP#0H+_ELo@q;H^<>)Ui0q)`DD0!KfG*Pd#?lh>+^6C
zwV*$vB^qUTEbtNM&%h%5;i39R96uJlC=J8A3`{HgEil>;HojdcpTjY*z?qCMMC<Jn
zb|G-0kNf8T{uvYSRqpQZbZ@6vLP!xeKOg)d1hiRxfrb#IBv_b3g7+#mU@1qb^`+9W
zoBX~66(dO*weWwvDgGi)fiu|g{vtoH0EwP}|G(&Ws6&cC2r}a}U?cpP@|)lAhgv>3
zAvzC{Q;73_{a6AB5qGBVZHxxA>|F;}iGTZa!ZAAnaTb!jwgHEm!-#A+m`4L0WEvcj
zn*(n%VLGF<a@z!6<FWt$_X&#WA2RpnN<W|ZxKF~~ehYXCdIQ8D{xS=QI=}yjfRXtD
zpl@o8+W!r(eMDu%XIWw#op&@_@BhG)2%^+%?LBMMs9k$gs~e?u&DQ)N2#HnHs;X6r
zR!i01)JTllvlLY$V$UQLK_oxl-?``9d+wjlbDs0u`@G+;_v<Yj3+2AS_2VU(22Ia{
zFQ-^SWgISw5*fHj82+S{Z5<Luz!-F*-KZKUEOUW)%<P(K)4epWLT93+b;H(Ni+Bso
zGlyvB?<pb)_$gfXC;_OCF$c_NXc3`oXFq@d$jh?Sw`tZn;)qFq4DG^%AuA%ACa&TS
zBX!BHaHr2@Tw};vzh$)Zwx+<N2u7#1F)r$3oXrpdY&pVknhr85(u&rmbLdbe&mu;t
zadDU9Edg|jm-^lVEM#)uS-_d<nHX&<#W>DtWm<^AotG@6BvB2}J2?q&Sf^woIQu#<
zER%bU7R+Bi#?;YjTiUQQeNF|dF*^BOkBhvEFnaK|^lJxRTOjSKTIxFhHtgW^kQ+Hp
z1)E&1IK)<;CRH51tRuT0%YE-wTB>#1ij)B<_Ec=msIKibp4bitl@Dz8>JjIKwSgCF
z_lM`+$jMDynDH(-p3Gj4_2*!`N}i>-=7bP=G`ENHmZ-7FuA(1;4uHeV4jdsuz}>xT
z9_^jy&XJ6Jgf^a``k*ZwHi{|2DHOu&K^oR9->GN)Fn9E?V&qJGVC5(^-DgK(c=tmV
zc`tjwld~n~@iX|ftDfI%y=l>$!EKX#k$si7n-R7_#Q4#XT4<%%s}0KqKB>kZ>NF8s
zS{?0;e^z2u;|8p3(8F(bj&$BOJ?JX2$+RWi>Aogj5HtQAYf*+5u#*`u#b3Kz`9<``
zFRx0<3pjkTxkl7QJ}Tp__^&$NYULLa^McDeisBi>Fkj1;UG=Pi5-5gU?bFsidyb9U
zqtqyWCDT{gF|5`Y@#NpeAuw+E`1IOz&~8jxn?Zc9KZ9*RAC_vY02WJL{72?sI#-tP
zI?)atf96Am!=JpHFXEL2BKS}2nzj4y;StyKqXn>c-3SH7;KCZr@i27gmvN`UM<uGh
z$DT~Q92LSo*x>~l8hh*{wD;WtoyJb^0iqb$Lgrxf0`1-S()RIO#jn@I6dcWFPd#6>
z$Vca>0D2x`w<K_0j2wH1$J<;V=)?Zd7*L~FAjiC}6_Vv^Llh73Dd#f(1xC9iG=H&L
z9}f1!f?h#yf1bGctLb<V&|BtPoqh-^OIDQG%>xR}gaA@17`n~WS_vV3+3~Wv5vjoG
zB0d!7pXY_g_+KLQD&JBLj|krqh(M}r_c#E&%?+IQdm+;eKPG5xT3L7&8oyY2sI(L*
z*qgSb_L?0{ePB7^j*$Be_}!bkVe$EX2P0Nwj%`#h(N^C1GEL@jNEG$E5zk^gW2bO1
z7mhXjbJ{!G2?mF+w#LDq9m1o523Wx+SVUXcXBn4i?F^`-<7a1Z>KG$f!1uBRKwpH2
zd>5rTvrE##VC3e~$<I0xia&d{A`EAp&PYDb)R9s2g&&vT86Q+%F83yH(n4eo$IOt2
zo8H_j);$?_cm?2E%cREMxf`k~z4!Nr+5<s6Ksev)cloV!yU}iAP6z<^okaQJU)?@B
zMmJwGYXn{coYIui8o%a*2Lo=*vj!e=*ln>e*IBNnk~=mV8vmVGRjKt`CpU%RqF4Hp
zxh^k@I(rt>aj9ndk^Jc>C_}itJlX{hn2h|a+E$i8oD++6>rZ_57gTUf9gB$+9Rha}
z$<dI|KcDe6lcJ<%em5Qw>q>4z($~X2UG7SCTEbc0K8v<>k@2ru>Od)gSFybaH-MT>
zK<aSdDthB)WP%5?T*X#z|93I|_P$>~=uB6Zg#qBU!4-OG%)Ax3sd3rrmj&V(z1yQL
z*$#bmH>y*H38SKS1l<BKB<&X;ZZb0>+V=j9L7?*Xa?;AOG!D(-8qP)}9~AOk?!)`#
zu1qSgTubcyven7mbSh~%oudPlIX750%ZUb0XQ6KvdrwiLB4!_BUwxvLqVX5tNvWaI
z_|<=jqWR(7v1EydAF~7M@82vCjB$tZ{id4x%<-1)a_r90lsY?HDV0~Jn~-CC;GelM
z!CM3)iwfTCb;r}%Sw*cVfe)G-vJ|g302l^;PUSp=vjC~*_sN^Y>lHlF(=VBAiI)Sn
zf*)Gt7<SG&qr(u)RPWeqsNwBbaOR!~&2~A}<zVnA{`i!9IXn#_t{?HC(`bY<-F!~j
zC~H`-hyvRr!$^u*ttd%9-hcH46su{%hBtf7yMnpiNk}GxQ?xd832gOCwL*I?0xuI+
z&#_rJRjl9lkchEg6hTc~A9mIrvKRbjSVSGaeVC~#qt3cJV;E5<V3N^rEq@L`e(&^8
zFy}QS+B#&^<7X?z5%A#sk_XD>vMYM@DeH6kpo3GwSxv_ZAp^>Mw_ge`OJ$Wk18bRr
z*K_i=;JmjPaBw;@GcA<CHVbs!yoES9Wb}x>=Z#mm$G?vMTFA%$m}zlNC_A;*LzJ8S
zGQvB7{_eT=YQXYyhnrz<S;O{OkidvqPtV~6c%saTWOfYB5=Wck88LK|T(2|a_7Q^o
z+2Uqyf9{Y)YcF!^U3|sZTi(C;^sG0Q%buvxpN>Ud7ZAgTmLwubpYSyjnxkdp(0PqL
zbYxX&Hij0lzH%o~^So2>QY-Ohnzzt<aX%f={u2#Bdo$0aJA!7gmyVPS;Y9nE##uy;
zNGp2=vnUNxDA%?${+II?qXY*?teT+vRW-Kwbbi9zS+`~ZrMjS+rgqxo9OFS{?yyGP
zl5|1kz2P*fq1QKNg{lKd!XmQVA0m}#IOS^D{|8$_+Mdm&I7$bSK#oGdDS5M>i}Ja7
znPGvVOf*|@f4Zr~G@@cY5(TyVd?2r1&ed&7jT#>QH$O&u&w2l9bg%V?imF28v~%8p
z(jjy_s}@Y+3axlwEVCE~HB;U<$(KGfyp|)ivNkJ1+S8y1rCk>Y%1eheK~I>+FLtYc
z@i+O+wESiDQYd6ow)U=nX+vjGV6&)2TK|Vs_EH>;?!k;0?Co202*he-V+sw_y^M{~
zRrGy69{q0&Ev}Z2z|1*hCTaRQ;)~**H%yVsg#tyYc1Tj^m2bUY>9ZwFb0FcJeoF!=
z=EizQOEyMaBwAkm+7+o;2y9zL1>*x_W=s6u_zP7D^?ifbwst-7<03O9xG!3k=Z%vf
zP6o;qr83SnH~8Z@S)P7&3&CAwwO1dDGI4aPXEEbW_8-)Klw;gv43nZqs2JYTaEA8?
z7VYbwjW7~h0}{;yII7uVJI@?I**DX{OKzGF9mU%Fd#$@*l@X>S4yi85qnWeiZjsoH
zIC%<@ViG%^KL+6P;*4GyA-^SHwDe7Du7%n+@hwN*TP}SDBJ!<cccKnDp8faJIazG4
zIqF7`2G`t`8M3_wy94^=ko}tR5CPwD^y0J=u=5jL{C7jBYg4gX_FP;Og?)P020y9F
zv}-Dc{CkcerqL9-!|F_lH}nFxsGpmLc7DueQgcCn-s2>jCbQnCe~|WO9R<%S?`G@m
zIxTU$n39cX7~yToE&3Z@mW^B@51*~5i>;%yO=68UylxwHG5Di0fRhyu1`&3Ok2WCl
z23Rq8tbtR%h^6Y*e;9?Yo8};BWi|kv`9<Q_iCD)t%hbsu8L^9cD(*$ITaeJ&`j-2;
z54h25X4k3r^dvjiMTU__w|*#JEj!7+q?BRpV2o3*zg8kk=g1iNw##yLnIj)JIguW%
zFX0&aK<`+V9QUG3uq-#3d=f*i$ks>5^<Mk%-pEb{$WXzsEW_h7Sgq1hN#F?{)#P`V
zc6^d@X0ZOb7X+o3Z&*c*UhFRKF8!&_=m34NVCA>S?=uyXGJ13)QCS+taLM~%iYB2J
z+dR{l0RGeN^`U2YqBcH*N@jTCRZpTgIW9!Ft+0BKhTrZ+Rz5{l`fL}Z@=M`N^NiEz
z1PAYh(kD4_DZFNC8Fjq6wMfjDqbn3~NZyY>WPH-`IF--y&5cz1lE7!r&j{bPto2je
zBbRAro@j6@NHegYTuOeT$8RcVBwH$gPBVCG6vF(=$tc3WcD9vFx2AhMEYh3-w;(eS
zhPo?pkJ(n^EH&R#3PSlgbPL~Z(F0CTM;S+&E*qwh+U*3JEsfzlZ8v3}RS53ROv{i|
z+Rmc1?u%bk^YQEEH0!sS^G;D>NZ3dNvU}3lD~;&8|7sPy8@dizL}>we;+6nspI`M1
zfZTgIuC8m`s^e_byRRl0cH1H(2)|nHA;%Z_X>X3&a2>Tg$Tu9QR_7Cu@(EjdbMM|g
zS+Spv${!PLC!KCXG6qzb%)DH=K{t%1)Xi@z^Lka5c$G{kKJv_0LJNngoD$flY;c&&
z0sniL%k?Nho%mS&X&27C|7}PP7VvJN3J6I0K5D1s1bTbmT_FUTEK0^D<+<*U&+rSN
z8s1XmJj^~4fBd%;qyI4QE+~GgW;9j`YsV5$FL|e4QbrW~j^I<~*VL5RkQRA;i*4jY
zdwht?FQ_ROb-X}SeLkZ4eEi~^n3G+hLF8v*2`RC>y5L=K;o&roq%*~{&7~$kn5FP^
z6Yl=Ux>PMZyM4rf23?01Fy6VDbnWM`H}!a13^^eV`-`4$^n=^TmZApPZ86aJ2)^k0
zG2Ln;<zks6_=6s`urjEtUq1#EdH6Lw<*^%<XgDr0rPLdVeE#YX^aH*v^n2|E{iUg;
zKHe*wcr|@!#?MS<G1^H~T8GyKy0XtG&mvlGfPb5pxLobkf0v1uM?3QF*IR(J`?gmA
z9@=+)JpT4Vywrirk#@}aWh4YVRhBb7?`Gui_wzVG2UYUMDpG*05SL)cl>{0nQDmU+
zOMXhnYd7X_aK+bPUP$C<(6Gpgf6iQ9^k+d2+$X^xsy=CupgZ5JU&+5PeNxG{{(Wgm
z?-Pg%EY0yqMS}PEYAc}WZne*y`CNc9#a%omB>KW%`vn{3m<q~RCBlL?uVy*#n0JM?
z8H+CJ^p-_SRz)I_QT%iJ(o{}>1l{XT6sBhmV#KDB<H0@jl)R9J>65zMn!oWA%kI$Q
z{&^uia{_(x3+>Ths6ilrQ50_5MvN0$5t%`vd%B{aPD6tUeq6Q;strpac!3LX8<eq+
zBYZSW3&AGF;!PKEetgMjHh~Et3<OI#ll**fJmnsL5<2?9DS7_@AwL}5OHuZy_6~n*
zir-<D61|~(qS`pb`35dYyBOVcA8|(<m-|Ne_o#(6G<t(oiVXgplJN1V3eRpdyT7O$
zOJMj2<GxY&RZoUk)9Z@y4~vOvp-<|>BJ$D#S(4JCuEclrHcq+%<P<xik;Goy?Cnfj
z!K&ddt6LbbG})z-!U07C4$y6tc?Daj+%`(+_26T|Q2Is!cAk1@^w9rQ#e-_NljF?d
zZVX%L`ZhF<2`FL<usCr?gjw+e9c(y+twAVvlA;iY$`k2Fj6dU7l><VJY8^!$+47S=
zkbnq=A?J_MLfPYtR<<%@pYQpL5O3|4%Wq;_H`zxQJhi%{bVoTh=C$&aFOs*Puahjq
z6e?6qy7zRMO8eUlk|A(T4Zi8O?x%Prx2#wAYK2*x9_3>%xWy;sD+Zs@{@&<SaXbS*
zBP0@8eDX(<7c!sHcgMrK{k77v-;oR(PLHB}QYQr53-YF*3j_Fl{UHiuc*I|~Cf)zD
zvi%MX5fr6rPZ<ftl|CL(xV?PV#z;uhS^+^*eq&7htyv@{-0$+tHu3)shCYxHEYhX$
zF<;{80eR4AqSh@k@LxFGGVjN&VM1_-58p#YxIqgbfBxvt&PuOEfxa+%u^&NLK7{;*
zCj`4LkRA)Y75zfn(gcA}_fq`VqfkzC;Ow-4H<E~U3e${K8v!Tn-=(ZoiAHIC`8o^+
z(Wl+;8b{H8Be?6K`uE(NxG_!%G#@%GH+~`A({g1tCtD+Bs*i2<PBAO=tz8B_Z?LA7
z@^>A{xJO;Q3*sms#Vr8_?-%Vquok2xf#EO;m=!}Q%cuCM-*~wo9T0oN{z0nd@K54d
zE0&3EUW(dli;YP^L*qUJ97f3z_>0<g)S#O^#3aGmS!9jk+~+yNx(7KaHvg)mwk`^I
z=su9^i?g{x1rv01GNr@Z{(BYpsQ-DMGB3I5O5RK~X<50-8Qxbuvn#Fm5c9jnzKQzz
ztsLU@Q2(<r-fjvgy;4qlXy>aRceG}55PnIuZ%{Ps-LGzQYhLtDtxP$f@B2o?(tj<7
zyjP{U`a1zt_?hGOBkxF09f`7Iz|gDY-f#1SK8awPT}HF_eSxkfvWSaDme)b!SDvq)
zp#h^d9VN^$E%OZ=B(G(>Mu4~fUy>1$Ken*)J#Ty1%sfZD;_sOl9z)M|v)eU;ph7SX
zIMmlKr^DCW^{+2?MxzA~kAlKJkJ{q_J#U}rzGCKSyFu?<?*H(XfSMW&l1#=Y?|bHw
zyFm@I>A%t=wJM_J%?h*_9cYw~p!_XHg$c(Ay;ldtjZ`2Wm~51Q=M~DoTB`_lwy#R6
z@Jxrqsd7i2U4Qk-B_S$Mg&<84bD;hz+MkB|c_nk<+c2r!80HStf^HE7|DwE1y(fy0
z^eYgUM0zd24YbTyeIF7F-seeXP;)K(z)}H>%TA}alIZH{XM}~S5u)UkxLue?_6k9S
z02*NvLQu4I!h*Kgj%*;~_qQ7WqfUF%Ei@Wyoo)@HJ8unTt@V2Nj)1wd{sBO5nf02R
zp5pX&{zWOMgkL=5=9|5HJe%Azks!l=ZhVC@HL?~8jvW;u9nVrOo3?o#L72iqPjlSi
zjBK$4-uf>FDbp-98pVo!(Dh?=VI~^r5>3s>eb2XH7W^xcSZsMRj>7lf#{(rUCCboJ
z&daI_)Sn^|Z*IrVj4{V2nDXlg7$oh!VXsp)v8L3c_e=P=pSB_%=sR-VJXf6!8c;SY
zKNWuGC8({wN%&#L4Bw5?T}F<yDAXlPSvoR5N3WY#sGF*Q+d@#8>FT5@^ryv8j7Tj=
z3?mBAF3<FkcRa_pX)j%9X(|QXg+BNOMcJklVz{1H3w=>T^lf$|EH|%1K$5TIKWOw@
z3!1@;ULu$GxauX04aVS6zlF~+#enjae<tt0&te!Hx~Xo<$UY*5AjuFdt%UWN%>*WE
z{&t=EXgU@ceJwhVM&;F2#32Gtz8W*LvYQ1PdeG$DL#SZxoK6VUI{W75bhmMNPgKs*
zY%i)ZQ7kI?bF!FxqW!J|B{a<gj@&T0>Z^_0kvTc;-;9r?r#y;_ZD;w+0w)2y?NjxJ
z;?HV&jgmHSKrXoC=EYU*Oe(`Pr3wWf&V2QBbv?cQ*v~T7&Y53=m{@m-Hk@EH;}>~Y
zE$zd|YJjn0epYhl{S)M+qnV2AMy$|k8W&0Wy7{;1Ghcy}911f#uWB~>);Q|%aV}=%
zGiO`%TJD9rZ~Mq>D>BNSR*Wnis0a;0=Zo3k&hozQZqa?WJYu_GC?LIR%95%jd197M
z#GumIfnRICz*+#uGUBGNiO3U1kR4h1**$RX1H5$BTd_?d+3}PkGO3x{E7JuGv7)_}
zqbZPNULjF_5y*nq@d;{ISKllxH91CGuj(c1N?Ys(!=Ynrc*;XF1L{}8?Dz-Ej7J6U
zCSx34nI=d-MXm~1&JE~Xd&apP7V+SH5VncV*8c9E(kMJRi+{H{fgagY`l@dwX7L5<
z?9lBpgGMq7qzf&_h81mNTrN4)>h&*pF`v%ND`e5)NA>)a21y`_)^9FeSA(xAuOj>y
z4jw<|H^vqrIgu!Jcr)K5K{V~#q$#<Z=~2Y;+E4lGI4iw6FEcf7IkZAsAd%V~Nxwtl
zG4%*GC9}{pqu@GPd1y^7&ywUB@JQK?Si8Xz*Q!qj`vM5?*TvH5)gb?ni$ukAL|y9L
z!#_yv<k3+oB`Sd*c^Sv2UmE>m{i$u?>pKMm9niEH?9PEYumnpX_G5AJT$no1`|vTp
zlvyWBm?Qj0<dtXXs`K5Ff^3d201`$n$6gUPf-5iXhr*K!@Jvg5og?xw(PV0&wTP&T
z_4h*dt@T?%3&%0XDwhm|6X>3(`!^<am4??3U%n(>(pRf;n#9oC{kP(wtxvm8$Cuoj
zHUOv#c$8>b*)u-61`?SPb>8~U3sI;ki625#&j1qtbN;@V3D=dh@R!JNh&vh+g`63&
z0>}rOKilSu-n5W*3ZhZGWJlw1pw%3$Ddt5514S(9IB)M`)IS}+*c@H4XfN&_YIX|5
zf65sC3|@$=!B3GFq86}_WCR$HzSENy)joF7Rc%Ip0-x4?YZ5JEjJEvB%_Z}Ir?3YP
zGIH8D&~{`i4`C#cv=i;dx6&51i<;tE5X%cOloe)dcml3#qa#e+g}uFnnl~$v!0Pwp
z&HPeco~e83cBVVfN@6s#gR22iztf#d``~MB%K9Qc;Jv)_&pS=v{VnkYo%mVseYS`^
zkLaE<&I7UDJwuSgf8oR7%Xt|+6BpCkh4FP{a5&E%lYrSnad`FWay*t^y0!?hn}lE8
z)_-zy;`wGWnufR2Xvr>mUpuVcjL;FR9c<F|MJJ{7$JzA<U#aK_#4-TuH}I3HS6vx-
zNrH5N%7h<_o#{-l;73B286O}N>+8KycKXbhW!eZDiQF5JLvs;q7lyngHW+{A<vBL)
z3+sDNCCOGWt;>Pz4UGaLyPz9NzekdOE99TL;?PMrxMe4e%a5-g3h-2b;UDNAC3ce;
z(QD_E_))&#m>ms!ioA0p%)i(}&AePfZlGQ9{U=7{qiK+bpN7}|huJZmej%`5nM^{l
zQGB1OOXG{VQmOYj3z+bmg46OJg=^b6FK-_s>JR<WQqu<Xh6lh>s*#D;uR?(nQ(8>C
z^d?`N^xaj9wJ?63ga5sMK{Sx?ermK?6000NkSNs)CnvuxP%Et@?tuWxKYkpMpbH)>
zuP)b|yCS6-+n2ybg|~L}e7JWB@YxZDx<QBU{&)1e+4=sI5ex-iEKg4WcygZ|Frlp7
z#FB?_Y1KV)fp4GnAjvW8oxq@i4R_zaUrWI3ozG-#eo};b_-kLEp3%vGLj_-XLmyzl
z4jk)p8(rO<HUPH6U)9^_A`^c-cv8Ydt5cM^z|D=WG&qy6h?Op1empr5L1qfz64boF
z5NLSwak<-3iU{4=JN&It@X+T@>v-rGQvl=F7(l$^fWqsor{UiVXo7zU-kJZD-^vak
zXQTEH|BRysnZ#^jd_K^0f7-;369!W|*dvcqlAD6Fa!s@GFpw5@T-jmE?^zN%L%&=C
z6@$r0l%7_PUefhHgdF&QXLf)bbfIiU{_P06`)Yi>ROoA-{PgvQ>%XRmoon0zB0KId
zY+*t|UUKx!m`Env&Mv>wl%yktSqDb~d>RhkLBR0~Lp-FSn>HddikHNK16E<&BNRL`
zh5S~hY~oZAeO29Xz|x+>D^-mo7cO0MZ;$=ravOxI5-EuIyBmH;?v-JQDqzewr=qYE
zqVH}yKIH6yvs=i{<2CE53@}BlEG%t3OZSYeNH@B81k7GmqBSo>83%Bj)|c}6)aHsD
z1+Va?@eK;!PPXe?a`aM3!44g-Q?|z$O7p)VS1`^S^PZ9rDse;<-{@KL89vC~fNjH^
zE$BR|Y8WgBbGwI9@WgR?V|o`SDCDjEz7P0oQ;uNF2yIw$1@I#D;z;Lf57_U8h3Yc8
zTPEw43~nOb=8n(o(_!W=upO)G67yrN=J(ZrB%?Kl+Zg^Bgc3t^Ysqw10^g)wAc7KO
z&^1;4PZ0VuzEfI7!Pbvy`v=AH;9>V`_Ss*nU^X&7{~O@b7j6$apuS&_15%s1F6EsZ
z+RHpxFd=AXK)o;W6tzAh6IYV$^shhAf278l@z(h0+W==lk#lOPZr9}x7Nxytf9&0d
zoo2@X=`{h)kucxoD+tB-JL4CB`5&pOTl<V<5>G@PM#qWkB~5oI%0$L4Vq&I~J8CB}
z%GdT!GO>2u>c4NC6{w#*d0bkS>{grl^|Q}+e~$f@ik*lFsUHCoMZc?JpS)M&@L=nW
z&zzflXjMzeaCNZVl71&DhfvtJjaE-sx5@Z2Qt|uUBN^*jcGS4<HX3@wJK@qR6wUE2
z{0E7w|30bdmI2RXW==83gUIP--Mp_e(Q)*q`YK(!DPyWzo3?^q${uIlyLRI%gLLmu
zwe2dd%z;-k!cMhSQF{C7jvH*~U7n9`b3r4oU#Zwg6_xTO^7#A`>i)Dz>}KdtvlHD0
ztgeE@SxQ%)G`nB+CbH~PY5d2Cu;%J(hJnlf?W$t?vy@e7L(6UEXJ7Pp{$Q?T`+_;d
ze5|t4-+g13#Ts$YP5(_fldbMG?r(TL03gh)^8pbC_!K7>^@2<!US)O{fJ)#KYLfil
zZ}Q8OcJ{BQ)Cb<-0}w1Ktd~(Pu>p_gZXPA4^5_^n(^GeXbmT16dorkGjwK)F#OTHN
zT%QK!>py>IP1Tm)_)DjpUH{jT^m|@GX6qN?FGajM!qtqD{=`&$jY2snH0H3Hsc0+i
z3EYtR0>z~zgM}F4ya;JS>TWdOA&icxS+bemmX;V_KcxPp)vb8s$kig1is=4Q_J+z4
zk?#VM+`MKqgyy5YxACueV<M1=o?OCvqn2i?0l=fdPsyt5P>7Ht#6JjN?-}+8T#TWC
zX)Ep;MpDU>*b`E(IgEdECm**77SVoAEhcsWU($?{gjAoyew|&mTPtGhx?~Kr!ifU!
zZz0La4xMUnG7GrgqJ2JD9eg&KHSx?5?$3wq?R}}A!3vgC@}c`V1h`MJJAYn?^ySjI
zH_B<D<fB|^57_n`7*`(b`=BhvP9A%DaT)PxRU=Ynk6(0N8OZ34^5UYKh`l?{ZFx8`
zo}Hp4D}Mw%AqwfF70mHKMi>kLf7Ug*YqZ|{4AvY2O6SEyQII6>_JtQDn@CW^;OD7E
zfGLR@6mf1TYf0)V!N46ksI@-s?zymG$@QlXQE(=|bfz}$5UFMO)H3-aG_f6$*_xAs
ze5-J?l0Bk9K<`zr!O3HR5IRn03#2KNRLFEEN79%0r>sw9lkGzK7CxJ<LhXb?D#}jL
z#W^dpMOCPaMkmI(ulDv}iTv@8UZUny*ZX;bmlojY@2p={@M4E#kV9W&jGa5M&bQ#8
zyXlAjensoq3GW?0eP{PKLFNfJ(ic(_&J(#j7@Rx4yy&YpadP|5Ftz~N*H#LqvWJK(
z`Q0gdI^<_Dq;dKSP|5W)EaEh3-=RoMmHqptRn4#Lt_G{0Vs|FzKRRBcI1H=ctMk(x
zT6l%>{RsS6{nc`e-pYL>4i1Z9z%sr6qRwzs&7uq_4%A(DG<J`LLBh^+04Z&|q@MY0
zwoA0QLpbd>pUx~nq2H)5;OS(esMDWAG%fB4e}ls>h=<j;+gb<Mqrg>r#?r_sTXTI$
zl?SGld1TVLIiAT6b1T}Qc#t*vV=>XauRELhB2qXvH)Nmxea!plhYX3y3E_nsWNj#;
zmqL!yVoS)yjp(n%&}WMLWXi}#+7mSmfGYb;@+iS{HryOKJt|~+sp2e121*9XJUsFJ
z{atO-?iP|nX*gBqmPRHJCOm=whjKrI(g33C%RZu=?{6~L%)hkXoeV@QJ?f(jl9~Q;
zL1Id4Ci4B;TU+)XseTTl#)P?2{}>tQYyDZcTmDuC5Bn6Qs_qdW4|C6x5@iHBuO&pj
zh51h~<u()msArW-QxeI$#_c3Q0emm53B&I)j<XmlnP_$jlZN&nhKQlEyqP3&_*01|
zMrhwc!Y!O|_|g`HI*Xh7bkL?PBO*Kpn~I|gLv<MzN6ovHMD#x%v8&o76LfV(mWs*?
zWeBgSNiYFr@PqR8s64Z-&lD$`n(f;ES<>W<HwSk5H5l{rTlnT(vFL1hL|5u*6#+Ff
za@K$T?hE8W+GqAQV(oPN@BN3#1YGjstm?{j4f)5n=nL%mSDKpJ)PV;IwspM`zOf%S
z6$;Owy~-JSX;+?|QT~;=!+#p}JDfLAbm7&7L@jb*lu;fh0OUc#VP636H_oh$Uum2`
z2y&Z8G^AMo9c8n5-_oXN>oL`#>?a}%3uz+4X`XW((_GAHMfQEY_n1yA52d@)qt56@
zzcWo)_q#rCf}-ueWGz=Tz9Gxq74691RqhKv2Zov;Z&T}7XwhmzO5wN0NEV6(v!s}H
zpKZ1@PADOzcdeTbI>+zy#{nKIw(^a2%rP7ow=aA4J2J+^p$GDgObJKaUikANNT>-Q
z1A3a@LtbA~2@R0F=!YY?BTk$y#KPD2JCy8Uw~!|@XU$~dO`ZLZ`n_$t1S&v{aKkjp
zeBw_d^ZXWq(#msvuCOx9U9@a@iK^h3^)g5Zzs$h{m;qD#<=1qwkI9;}o)eL~^1}^;
ze)G?hufqq8S}EEOh6~p}%slyTomcv=`iUwg`8NT%WF6d|{S-O1T(oFiW!vdPBW~X-
zH+qH4Q~N3rw$TAnbQFST4(_qnzOEOr{u(HksZ*vA?+ZR>L!lh63!gc#`Otd0R3Jx|
zt&QK^U3OyV=;~cLs}TwRixNIQ{jR)Ins?kBT?l}C$$M#2hfGf`-JLn{nT~+(Xn&KC
z)l*l4wJiy0$T8a=9a{VSvRZ<7gUV$cJ)erj@eeKAH<Ld_J+E1=U6pBeJ$pZvtl7HM
zekltoZ*EP6f6Jzc&tlKp9lPjZEYDy5@Br`HLI99mBTB?9ygQ6a@Y4m!+D3&hsXVD%
z-?EV`rdY}W)yMq-%k9@Sc5fdYjQ7X3QQZ{_&COl-L7Kbr!R0AXuNi+pp>y|OaW3-r
z;j8kz1>Rv_#&hRANQ2);IIK<mFE6vo9dSX{Rvpx<qG=i&kyYMy)0fA8wO|(g5k#}`
zyWV$RdPM&N-+bwo*j{S2xz<HtBo5~glzbwW%8_rm7^$f~-IW+c5kh8$HGe{GpUoLA
z3oMHLI5@`2s`>AJgYvD)og-QgKpj99|7;dcZqM6!k8U0=K;|Ai52B-Hx8>mKP_n*L
z>3*7A!EU^s`6M3Ncwcl_4Ll!QTq~WlUXOU$wE4M|Vs_1_Dm3Lh?V9zszzC8%VdVU{
zCcRRijXdPJu5J1~KTubrf8tEx&-PpNv&S}_CM#c_TYQqID6U=z-_dBKFRt?5VcVGV
z|2EE(N6ozov2Gerp9$m^aR6A;rC1tMUEY7m$j>?)=kV@=06;d_DyS?~b7tPZWQpIX
z(Pr8=(>g%V1;O&jhdIAH(o$t8RcIyp6F};}<H<uVb|*)|v@g-J?%y(PUtP}AsYUCm
z3hF;LN+2#d^r~-5OU8HJd^L&S=Ls{9I+eMmF>Fru82vQ|ABDa=`QSn_-9J1^o;vKx
zMSg82@8C1bD&X^UqlbUV^LAns&r~eKLjT|ii<}qgyupv~j7CTt;F*orPyg%K8ey>3
zVhAaRFYC9rm;7mw(@%n+N4A%glXQh1x6t*6+9?hXeY7IGg_H{?GUtdRq>h(}>(8&*
z_oNUQfTK5IUs%v;ecvCeUG8tdD`^;(qvDSog~Qf`lAhEk{f9dMDhDjM(W_6|dXI^C
zl_JTA`zyW!9q~jzcG1csx)RNYqjYPra2W`nO)ptgdu~qRMZ$QORk!#-V<B?(?@gsh
z%9W)yv$4EqN89ZJ5rOsg5uG-PRa1Y7;*Bt8Mc+f1;Khd*`&fc5mFRy5@{-8;B8pH=
zq3uL$W6%f1v2YTty(HGlC?b?@JZSjbYZ$_Nw{D)1M8G-p?<Ojzuk^Mw@Wg5s+Jh<3
zX@9ow-&(yeRLBUO$meHd(O}9T$%0?wXVJEm>3n2fH2s}_8P6{w2Ki1X{>uvF79cNC
z-zDB4fTOo%7ttV@fE4Npb}AB<+>ZsZwuy0`^!L0C+A&+uj4ENUGPw#_L8E&l_lR@4
zW>>kANTFVsxJw<d4JNC^{7v=MX9D#>Pz{MdQW$)6Yf)B7oTs6IKju<#J1x%y6haV;
zN-_5)%o6D?3Ps4uaXNKc9^)6aB>7U8X<6~N_s?7bujAYtm0|xuv=m3O^OcpguLUle
zLqN2xx4$|Z5eAHQ6)v0?XrPSq2v-QzWK4j}2-O!{^A7Goj!|DOD_gR7BvY4+a<T<<
zZ$h7u$}NrQe%3fYc_*rq?ma_ynMi#Cd=bE9{_9UMDJkXEa5NnNyHIkm1>{}pA#HbR
z#kYV;0}LboqYk-O;yZ)xN?lG(d9&IlSS^P;O-Tp`IWi7$#xvazI;)T9g%BcvT9H><
z{2@`IMzW;;u#1e%;J%$??unx)_IbIysL^S_*o}5&<HO76LTG1n1*dF%UssL`3pP!~
zCGXWUrTNJKShf!eShOzf9deu<kqKzMy@|BZ^HMRg9VJGpt9!*Tw<_^4<iW>bL3TzO
zs92Gi05799BzN$sE3#52`Zwv4838PRlhv1szBr)04KMe30lZqZnK?THV7U0xStRrs
zP-xq~kPoN4rWhd#KSPK7RF0kt-F#Q)EJwSNcqTi<%aVMWKnM@_+n4W?m$ZC_A77Y_
zlMgw2ze)%`CudO{o2LqOlb_2+Y@W%=bGFRnCSkFJIb{G}>3OXn`79zvNQQ<wB+zil
zyA$yGLb!dcK|ENvueFUJ*Q+DOGfna0<DAs{QC#Zceu{A31f$;*<qT{w-PWG57OI8+
zbymzpFkt-ap1}eP^5OKUe+~gh+8Cc*by3YERr|A7=o?9&LSsT(Roj&T{@r{K*DcSr
zg#A}JjLlHL<;uiYs?_U}jE!lh@l{$3p~_!>AZGyrZRw5hh$aY?!EffBdZug2oZQfc
zB~;nZ`$C~~4{pr<1?tqT8dbKNQMOljhL-~TSSHSihZS|U<vnNZKsd(pA6^#1TOrs2
zqY`JjG=r^Uh=0s<i0SP40vx}I=FSehFb~C8O}0N@dMVWX-4zI@t|Fcxp%IZHOoV8X
ztP9=&xGBM^({S@bFYB?Ap#jXJ5WmRG$f)*6-GsX!?43{15$#Z-6iytMdP9T|ESnN0
z)O`m-G*<9nR%OMo%U<*P!c$59ew;x2&$=Lx4oyFp272|62dRamzy0&GaIBobRVsx(
zkzbzCldRJW+-?}Ci`jy4Ro(lrxx4!eT^RjJd6Sw(ss7T5;mS9{c22l{7Sa2VlL1Io
zMti&5x)$U}yzo@Jv{&#s-h|^QtPbRvb|zLWr@8rBZr}k;A?Eq`2{p&m*CnYO3gqn0
zuwIZaB&Q=&8|_#=@VxMy&^0g)5MO=Xc?DjB1vTtz_^od0m`y)QrFxv(uG20YV6%Gi
zW`w#+IrncnzigsDzCv4~r#d)y@exZ1@U-XF;!?+wi?18cc9`^p#82L$hnOZR-QV+h
zc)$mYeTRa5BTD*N2E{`&=Kve5b=2K-e(++^DTbqSg<jDYr?Zm31A#>t1NzsAWH_OH
zqMmVHmW$MnUma?SyxF6Lh&wkS-SXT*j9QT8>K!7SGg{lBx{+aL{xX9P{%E~(KIZQq
z&X;wgIIFwF#qJ3@cC#|@hXOS4_XbV^?ReN<GTuMs(e4}?>MmTf&uS)PfK*$Kw}1Vn
zFMve>yq4a}3BrFGRcMPLupP2WFuw<FItNG^r5Uv1V&f)_<8rhY@5upf8Eicn88z9Q
zz`{7ID&78^SI{OZ>74g6LTqS;-;9d(Ek$m9yj)TXP%~{7%ud1O(37_Y6e3fT3DpYo
zMcly7lS;?#WnqC%I(6h-S8^*Rlbl`9$&-~fS#=X%qsZ^5h>)!AX%hSL;}~cDo|2(!
zmBZkiCyhx|V2%o5w29JAJPM68)2{fL=!i?`oysfQ*rjB~)UqpnOLSFs>ldO|96i&s
zu%hB#5c;=CN9feuEpl3zhd?hHhB-y8{rgx{G$G*qp!tN4m}8eN;!_uPqm99FL|>gX
zMs!~>kqNJ%j-k&`5&W94I>)cr)55Hgw&P}d)ASZUyx)Ig?4AXG3vS+8>nQjGKB6R9
z+VU>uQ@;7$3RjwLqDV5#Xt<0n&>1|qHu82b0nhBOTFlWq`{U_x7rmk}{J}2_7>|#+
z!oeKZm2z>Y3Mf@cG$N)*wvH4ZMfm8#KQYTtW$1`Z?h@_C{Stw6Qv;zX>i0CO-qWbq
ze_D=LC0ukR{F#NZvObV$+)%$k6O^XbJDNi&jp&v7jMi|M;mZDSdZyZOq!;0ra>RZ9
zI)ix^Xt`~<Nrt&+5#}CB=I5{tuv)qX-TThk=@TmGcMD;#D0|d1<96>JeFduZe(*B4
zCCRD}wj+mMO*eQR6XBPgu-H#q|E0Zd9NYHiubHO|AXAn8-uPv3eh*f8#qv_9KWUJ#
z4Km!kjC<dmDM}Rr68^Zj`P$HYw$mFRS{3?>cmGK<w8d8TINDqyr%|sl!|^d>rxD^o
z?VFhaBS}0|x~F;V!Nb3N#}R$sADZASV_$$B`*gi+-ZE0T-gh3!X?K6RHqIj3t%@#<
zF1Q9`1i={ZCGXH*v&f~U6fDu{`XA^YHcR+DCNRnw)ID?XIQ`vfbxCK)%$3YW@ad+<
zGnSkZJ|4r2K)M^HbYPeV(TIgEe7m>2*C|TXLdVvudAI!q735R%9D%p3FurQz>V6pE
zEZeKqi#mQt=laf-z1!r@|DIRhuSuWfDtfJQyLQ89$Il|vF&3-B4y?~OPn#)RFrk8`
zQgnNPK08mzc#a;}I#$a9EvsCBB)s5ounx-6A|z}d(*v6rFD#S`;mJb*7j5|39i37n
zQGeE&tNX^6Ty#kblhpS|{yD!T%8^8a!}w7jr{xcP|M>oh!Pfp<Jh?DfGu>UrGSdd%
z&AUmPAFE<NW4MsZwKnwKab~ZOAjh)WzvhC9mi+%|`DuP9S7f2(-BgGFooaIubDLot
zIL#W-=SGpBHDP>hgsH&tEYkWp2E1A#E1Ln?3=FW~cQeA=B#EVQMXID%*}OOFy~NL$
zF~UUdTz<WRYv{1ElRKxxu#Ib=M$Ylsqn;ko;SD`>iR_i6hT>L+pjr1^iP?L~t7DeB
zOo~;RUSpfZcTf+MiFku17JR?^(Rlj9|CX()ED7(NZszy*h^$bl4<@pJB#x2GuV++c
zV#~R0UI187%3;L*uHjhGjuEKAWdMtJ8B4fA_U9U&536fz{bLN*Rc)ea(uyAIQ9~$p
z-}J?fcQlSWtn3EZzlzq57mzG3FK5PR-nlN*{dM?J(NEK?o2}k0Hf9Q6We2on=*6FU
zq{#honqDu-waqr~vvc>)<~W;8F@17-!`{8W%Qj0g692zjX)-^VQSg_6$oq5?f4+pC
z9G|@N*<G4eJp2PUKTShxz)^_MGh=AsIiUhv&osxNoWAvD@SRXMvhvBsknwa^wNl7E
z9eRC}_Hw+Svj8DHO;$Ki=g0VPGX2+6w}dg0@NJ7cML}=Dc9~PbORZ;T%gmh?*P1x9
zQ8XRXnmhy7&&Q7Mfk&S)VAo@3`My>eN43MI7fuUZkb}R6)|&oP1^JRm0RHyOJY&2A
zjkUyxi{P%Z28q*?WU)d;A9L-+CxcH9LkMM`Xlh3TT&xA|I2*W*N`p~(IIikjSb)F3
zH4W{SrU7XD0lQOU;h7CtbrBOTw{-?&!TEU)ivH?pNtb^G&|_9Frr;Tkg7q4G>{)#9
zmN=t@eUHWH*ilu!GHRjRT6v#8^<Qy+sGt_OM$|j_Fu0|onxq2$vBtL-a1va&9(Cti
z<oS^4CC=bk<XIcUlyX)kTD1#uB)xr6!vmsOfM@jh7wJS)lV7@d2D+3WfA+?sm1cHN
zRnBAx0T<Ody@hu2nfetnS1pjTv=L6M3@?cyMJhj4f_nxNz$8#*L@i%qBW9^C*r&qy
z8)RgW_fyQ@k{Ojo-D?-1wsz{u!*>VAEuaEnalQ849K|RU^v1j6#!W^)3XauWu;vII
z#MQ+1)P0Hn?<2n9Wi`Uvg3RHSXlZKO@CTd+!J2|*FFr*P`ArM8XvU9i;Y?4CAFwBk
zXj>2$R$Rbxi7HX*>#u<{+*YE(B1(?`U4jAqSCVgFh4DDZ^5UFQx$Qi7Qi_$R=<`8s
zT%Ue2Y<|Sd3SC%y3b{cjyWJPlqsB65AFltI&N7j!r-7}?6*g%3W-yJ_<6>Kl%q;Ok
zt=kM}0^G<xB%DzT3ye<^64JrRVOJFZ>PEQtFFpfw{>JqZ#GoK_6d%i(>v7Q)Uk%VF
zOU@n$-*(hXFG|PMu1FL1>_Q!bJxOjN4+;s-z+LXP%+pdIqh9{*tDNiPFR@UQ4f(#s
zgV~mbRJ^oJ0X17*G2~$av1VayMB^NaC+&T3@2&`=`PbyJ^T?MVElbmv<F=zn3nYsm
zM_Q_^@M1_SiK5!Ix9{Y20ux69o=GKsV@$B6!m=#!?fBY&(AseKD*|WJ@lQwdg~EIK
z=uL!iTg}+EenAu9q;$_vlgqt(Q5Sf$gkyiKa_bf|@vVf}$1qBIW%@|JNj`rx>>8kK
zYQS_UTs**)LvHnz4|7`^LZk3y!lg*KGNHM-e`g?na(Hd)fvArz*uI}Ar`XcpAfudz
zi*=V)$nJBdl|`)UVEiYvUHSgLz1MYKNnl!k)i+zEcEvNhiD1DBe(ChduMs|um+kvE
zJs_2zW-7cgeLI0xZ#q6rnpGxta}8PMT|9S#7NQg$+3IUyHGY;f8EqiH0Mx=R(`5oy
zAfo4?2%lL~_+FWu0fB1&Xav3}O1gkiIh5^ghRWScz*A-8Rnl6B4hd^VWEq)GrAHS$
zIiQlr#=IC=x5JlOF8#o#&5qP?v+JKhZmCC-e{nnahRyx$fp#M)Z<R$t((DS0fC^*f
zFAGoUxN)(PGCr}y77lxfH<@RxRO)lA)<D~|uKh28cleeDT|W}8?X^PGBGe_@rYx~`
zFd%|&k#j)H$$909|ECbfQMRABq~<WVjaQ>)2E}kjN+qLGppU0h@XFd)5mik=p(UYS
zXLTdY^;HulcF!#97>A%PqYy;Q6v&71O$U@q{~ql2{o;Qe$WlQ1f2hkfE|;^5uVj}M
zE+fmUDWxS=%h9uTK~J}meWk{FSu|%sky{BD6LckJc!rB2N2`^^2C7w%Ks-cxEk*#O
z-M~zEF>gc^0LqsOY7&mbc|OL3pl*ikHfnBYkG+$42sy9g7!MjPq{4T+c`AUt3|qlQ
z{n<lx-udGPqPN%>U-aR~o_8W!%S)CulfUkdmb9-dr!h&sVK={0Y}9qAa(ZaF|6YNl
zGN-T;i)ugA=BuGooBRO1muB!q3a#cyAfHzcNq8<Ks#Ym)j-`eRwhGQ<7+bXyLI7>Q
zw+}Bs+CP1}7fRG8KSfh!s3qM&5&^bDX1Lgh`^sI9i)Ttrdz9aNHCPo?ykk?0a~i!a
zwjh1Dj9E8wwYUu%_4R=Sp<&U~eV=30>VF>5-KoaLNRT8*$YHin*WKzPOr%VYTGbno
zuPa<X{|x|woI{>HWB2PXu=nj61hPE;h&_Xv4+%GuEWGs8AB$v|7mJbpQL<I#iCiA|
ztqcbKdt-$4>63@EoTXR4yTFCk-ZO;=O||!qHD0wWEq;P4%x{s{zT5F=b9q&!TI=U3
zusSFCbbX5^#L=`9ZhLDJoje-jeAi;vwwuLSc;jPAw3t%47-daN+#1j!+kUZ-vdy0Y
z(PzdiOWoiY`w!Jx1Dg4oIt9r?P?oMCM~pT`JoU?bJ5bko#T&Xu#>Ut5u_)Zv#*0sq
zB*Xwa{?WD9EV3^g#EV--g?q4sfxOV%GPOldIOWCB{R#ISqv!{(9ANDG4=Tv35)K=n
zgC@?spgFnusgiVc{L;l<2(owNXUBKec0nZ{Q<G()(PX0}p4$!8C(A(T*dnZiLVA5L
z5<=45)jR9Za_6;6R3-||30xQ6x_3M_z{y9ZiMd-kXb+lg;fE*xc2xZB6ea=<YpSjw
zQi04z&ay9F{PUyDUXmnsbxAyp6(d@B_pJ;1P*~~%r&bOT86lcHm3gaJ`O8DX_FI=Y
zO^d;A9du5Ve+Bs%)J0O8atarV0zy;<wTSHFk-7{>v%)@dr*%*Mv{rprgnFTz<^`4J
z)C0WVKhSEvWB3Du&C;%*jaR0KL{djEmU8hfVfja&K-u<w_@fY#2}Ms`cxg(3I`XyK
z`6=0SBEIlLW3{I6V+~P7ksd+>)Y|t7ePv2%{%rV@bSE5#jlHU{JQ4!)v;TAhi$N(^
z&$o}De<_NKKQ#HQaq-oP?H!LI1TcAe0CwukhTw^&L$&ck79?~J5G?v%@*uebz`^^-
zlbi)(L#DG`+WsZ!CtO~D;`2rS>GCm9aK^IxLyda^W<|pT_#Hg&wqD~)UR9@{ZW`ES
zB!t}#rsn^b#qe};`0B-r>r?tFf7Ce`NZs5&&v(^r63i#{+mpFg!dui2Xfpch3z?A3
zU{=u@Paa?k{&@Sx4$j#JTZ_Y%8uCF8*buig!YQh=XGiYxePo;J;_YEUsr??6!+q=D
zmt74K9CQvADje*|p|Nj9Fh|y`%>8`$eQB9gN2cLcF74?AIIO-;fsaAj-sO8QX>BXd
zZr$yn^?lL+^K+Ub7~@<7sKL(z9jU6t^R=198>k6iW=7u$;I3>@0B@^pTPp<EV(E>K
zy2<nF>khRlw=&kH%LBO3UD=@d@^R8t<`oR)aO_W;5IhXh9%agANYzKsdAw0jtN`Ja
zBXKCNd-+#jQ4#;6;-^zW<avTBkC%ca{A?v^^S0VFxbR-%l<$h>$w0y5or{oLJx&;O
zDHEZxB0NM-8gYwK<ZULqCVo!-?xv!{0?5v2r6X#u4GrJD{0ncJf~NtH<*mpH9Qpo(
zNGqFy9WuZ<@UP422LiTpbi1>ZqX3BgyODOxHkP$2?DrP|cDtzBB~u-_PF%HBCp#>p
zb{DRGyYgop4&lM8F%~b4#qbj{JQUo+?`u17I$H5giGowW7;V}ov*s`q=b@XI<uchp
zPthbN@+N;z3*n5Cq7Yo8JF^62gG>5i$8K1WR)E#Ztt<Z!El2=e5L~>GtW8O(HSWx~
zTm-#wFN(o(L*rFfYk)THzm$x~4FKMjL(9?F#Tjzs=XCPWZJ2Ss1{H0xr?^(W(xufG
zI)X&Q99sQ)R3um2v$vmM?(pQcmW_)N5B(Mk#+!W+9^zbKA=xOG7rE3cNSV{qadck1
zZ_47{w~*rX>UM6Q0Oi_!Wry&;d~qld-P?3`zEzVLiMKRrpE=?CJ@~^IDeE&Z0!Kkm
z?KgqnM$*Y=P-l;Dm?kAxp+IE+!2%%#xuQCQI&Hh4mEmuWv6r)i_}i~QEowisR!7Ou
zRZ8i%vkw;W7W@8$2AjF|a<?RcpaA{I^7AX4H@o4<2Hr0{`Y$<}%+6FcY6&5DK8<ca
z7P5(atEUpihN}WQSAB^NVp+}+_LNnWN=25QpBZOhV_|^Wx|aV^JB#R&rd+iy0rWqz
z)c#yfeV|a9rv0`wz)w1lqM{?ADH@K8JufS1#)lZ)T~}{>fzff|4D>Q<sgb=8UN{f`
zebI>M^1Y@_6`U68*@pgH>Xr!KJypd4*M)y5j*<&xs}y2LSx?r`gQ(&^EQM@TbcWiB
zh$oFtR#~`P{IUmut=2RZbT3;6h%iMUWNP%lfT8kic^A)vXEZ(G78xaLKLy1Ejvffg
zK>RI#C<(9fB_zH6RHo;CP7CBZg4M)2M2u0}O-vF6*hXBTKTtaE-<Ox8Fvjb(vdMxg
zBin8+)XYXw*S@<2|GG2HE9%3jPNgwo<^T$TFLn;JV%(ywHc!b+wQPVi3#SuFZ`Ym0
zb|ecE+eeFcD49#KE6fV)BJ}H}Pf|JXbO)&XAFBDYe1g`&<gtkmyA}^hChrk&eaF2!
z@(4jaI<%R2LOJxeKsUrbg9_g6@$=iDfa4v4%I<r%0I1*#(F$@(+$td`qv}>ka!Ozz
zpJ#uMk9dgAGU~scAChdBMl>GjH+iFcs3u4sUvSWIRbvFvp!NBue%PpXpJUO$MV>G8
zU2ocsiP*}>8d~_o?2q#$`)gCr2RSYV7~EA$kMMHx{>}WfVuu;tN8Or?ask?$<w8PU
zPS%?@GS2^xuJa5_>U{t<-~ji|m6E&Ca*tf#$UQ2vEO(hB%~`nxM~>WDxy7>5%9(qk
zk|TGTdm!%oDY#J)UjFa<`Q;mM@!>q@;=uEq`?+s{zcwM<`E^P4{5@kHVU3rZKQ1qV
zq8_{PPJ*x145n*Q0F3JHV|8-W9qv^t3&}htPEL~|MZeUSzXwyIgb*g;S!58U=y`kw
zpg`?F=>hgfpnmVm^_{Ghug^S|DMw28bLQ?C+Ehf~ZxNKs83a~fu!TxUXuO9}_xSh^
zkCoHt3{fpRhntWKxWP?nuGlwcOjS(yv>A#jSys7mUew3$ey3v7l30h991A6(`8D;t
zsyP{Wtn+hPJwclTSpmjrIHc%crh;k<;+UPLC3xXH;6CNH-jhd~*ZqbmorZD(9NDVh
zemD^$tFJ<4&;Dzd%4z4(mX#B!n*`vZK76lQ53dg|)hY5mSAcEG=!>C+M+;=IGLO2H
zKnVm%;&Pt&J&s4!m3(o3_DEN~hx@D;E-#A{k<x|vkSD`ZYgbC2ct0}Xj^O3;|MbJv
zfXVK|SV`*i)7@=6)^D|jAJMvnim74K4l@8dG{Hk&{RSBFi3s%3C~*J){t0z=ykY==
z>x|r2zkt7e#YPTxb>6;j^!Zl8CI2zdJU7=H-;+ww<U~$-^U#}+k8}by_gz+e7I?uB
zWWBMn^H!dN?1LXqX}&0AW@f~^KNvl4Boa<~zbAgCP;$Sf-~JPbJ?oz<^=|a}hMyBS
zY*^Wp_z_FsH21jhSSsnqE%))*)cti0ejLy3eC(y`XB=DkiQfI6pZ?R<u%4^4uf4~M
zm}AxaSS&P>-`Ca0N7pg_Gky^F{vLy{QO0ATlJ=Q!=W9GEE)(LoiX#p(YRaQHb2whd
z7udHP{t4+{;p_f);dYWm0J@UnkJ~RJmCm2=&3CFw7NMj)`UG2U&X0xPR*P!*+8*^s
z(S*u50H_bpxBCi~VyNPw)wTZ~_?gbF2Zs&J{5!v4ZxKced!Zc>7?;UJIJ4XJfu$W>
z9F(9p);HD(>R~i_Uxv4&SV*^iRIde-M%vGpI)d9Nc+HaR&6fu+^GPF&xrQrxvwPoi
zP72+!_fy62t?fRFgTZ0Fi@_tXtU+N!$9d-l7&WwdaB3+RtV#AeSzZqo4y+G#XqiF)
zj^oOA+BzI(k5lcAQXlQGxrcPm9WPdejCirxXw^&|k2uaD001cFsIBT4d5qTV9zHk)
z=N|w!_L0H8*#LE&(aThtZaZ|uOxfR(`gittZ^!;rQ&!pJ^SzI^L2tps+o#Fz=5F<T
zzc6|7l|51TLux(JaH{L&$k~fuTleN}Jp7?6db`{^zq0K&lKIQ|)!Js2=ED4x-TVC-
zGyt%mQmFJS?(g-#T4Dg_<!{fJ&G>H)F<MD=mj^zcI4<;@c%xh|#j4~NE2uDY#fts|
zpJ4qL+8Z|V;($&m8q8FzuZ^VHsEJ21o&D8?saSQy+}`=x1yfy^j?GWdARZei(7YLU
z7<e|HWAx{0I=xYd);BhuvcK0eo_u=8&0PvH|5fn!iM=k!{^qBmU4P4fZ}&QRrh#je
z+qUb3XMFRw*qv+{jA=PU%b#Dj?@KndNq87@9gp9NAXOXN`pkWkf2iGdJvN0UyjFdg
zmq$;9kH-GFA0&FS=sLqI`^3?dcL(B|=H;b)lGhC5tyg#6SsQR_SEZS}lUz3u=Qg}Y
zQLIAd-Dy8k=d9jF0{}weI=Myvf7mX}5y;;j!Nh0i$$uZr-P#Wwj11RshO|yPZxkyU
zl=5-rO<zg;4tFhR(fN5|&KpcpFtO$0{j6YOLjyZb)Y~_vUoy(LX=*)$+tNw?ROlqf
z_w5nUwM!k)wVpF}5#hsI`})F+%VB`j$E^~|;lWn=Wdg0b7wYoo%0Y%Zi@9ssQRLJG
z1K0c_$1L@VW%Mr<4J<kOII*N#YgOKN&`Ep+eLR+VDyj6Bg7K?9;i#hfqcQsz=OlLR
zV86&pgJj_TTfZ~`t4#k_pYqsGRIy<rAwFvRgTnZBmt+~6Oys5TznUXU#O$}ve8s9n
z)`vK%S^g|#^BRVgAK)Q=lkTe|3PAb6&%OXsSU$ft$P+A(l1x>EQvlZOMhlIbef`^V
zZ&Ki)YRIvnp@bm4@8X<rdYykE2zRR4S9VX3goZ4cLw`EejOS#ge9Qj*?i~WW^0kk4
zL3>eH;J@bpe%>$pyI^oe2;1}!%47dpXmpu?@zpTs#jh4ol;gZ%d?MDeHvG^VAtHht
z#fhXw@*cVYU4Kst_YXvLyz859l~)QJ2&X1}(zj_Ys8!{gQB#&nBv%K?oAOdJ2_H}~
z6_A0wFefF3H&Y>3UwF1!SR!GiZ$lhA@6-L<DE3-W475fZe-Qi$DgJH8QB!=_%|4!K
zwdB^ttsR@Kt6(8EgKny5T=NMUX!g~>{wpncg7^=-Fz@eZDSIGCZy}qBl&jO$Gy*0q
z9?CY+hbZ{6J7^$N9q28iXH8Ty7aH0BbGLIWf_*ofy=R~^J2zLyv4p0?w_H$8qe<I)
z5&Q`)z@Ae@go#KF<;yY@;NoLt7s;OufKR<c2QSE`*(z>&JN91a0N~N*1W2I2!mIXy
zh?;dt1*kTA!-&tp`6=PFb}FlhkZ=B%_>UN`*9d=j{Yu~<F^u$#IV^Kf@k;oz{lW5q
zHdIspStBPYT;s-{+JVPxsl!XC7<D&6Ap&o}-!aKg_piWkBo<pOU6q`oMwU&lQxcW2
zyoQHSQjvG>&T3ljPBThvk7q3sy5>wxDQX`L&5L8S)jIi`17A?q!?(nC9ryei>XDOc
zXCDDF>UM<&p-HZ8N|Cb=2w$VYAGp|*2_fc#Hrnzo9PH_zXGubWNB*2-R;-Z_f6^(l
z)e<|cAE6=4utqxAhjojVIv8S0>V(+({CgWB4u<J8jIC1>TVyVKlI%ld;S0J(Fq)~m
z%29_zD{sq>wNXA$3AfLI7uy%@>Sp^-_j}?<6X4}z8~+PuhTx9^g>*+l<v~w~qN6r{
zkd%PjVcX>`ZXzJa@r^@j_Aj|Nm3p4o2B|3}S0}4u;d_^z#&N5bkx`h%HQf{6YkAt2
zDgE>!EwdiyvxblJ;==<5+yB#!=zs*JsVR(d-RD3oP?g!8LbDM+wT}qu0p&wd6d%5v
z{*MG8G{E)`>=i4c6TQ~d2pLKlK^G5AFm%`k?e<&_K+^?3PQ^q}d<7fQxESdH{cA_0
zPP3CS)|%V)im2O5(I>6X?|=FaN?K$%0mlSM%v3Q9RcU>LLl<-Ek^HkALZsN9Tl*I<
zU%vjgMx7nw0~C(sr1|On2^!>{u*e<~89=xVWShj3qqObZLbA?N*~oyEdGwVJ4^h$U
zY#?Gx6Y6^&L=$N{eCD~6)e{Na``IvnRZS^uBm&(A1~A%cOIXOa+vyE=HEq8g6Gh6o
zcKc43bMhxx2|SB9SnU8_Hs5o|B9%UDbk}ntbT3rJtvU8V$^Pm<RD^dCt>K#Xc&{hW
z)NdIm^^fLo=(h-gblG(inT14~xpm&Yw26$nWZiJ4AK^5m0)mZoPI4V$N3265d{~Jz
zhFg)lHnio+D3NGKJl^;u(z&-hS1FqA!I}JuajzmyVl^+QP#Eo_e8vYYPYhJy8X=0#
zcQP-7B7SQ$^Z?CE_x^NzkT_O^VevHD=8FUv<I3`+rCDVo+fpr64IW4DklVh3J=+b5
zqf{~o!OXIb68KBwdVaq~HuYxhWd%}=O}XnGm}!Q4@=f;_-0*wHI&Fc?GwU_>sHP`K
z16z(BcpgFMyb3@+JFmXQY1$bL*ZHs3{;LuqHDBLjg3#qXK6R<aHh|bq!%jLV`c~x?
z_My6dnmJ@PqYDjC55#x9ik@+|A)3cI`-)|<5Z-~@-m5jp7@O^Erfy(E#~f6kdp4H=
zh+7WoBNx7a8wi(<nZUov)((qy(-PBrv<_B=i?65Rd^tj#LPr@2Yj*D@<Jl-y2Bbyw
z)th-~P3IAxzgn!5N=W)X(7n|0Jo40Fd#lFTfouy~P6_Eh%{9m6rs&l%%{OZ#F3qQp
zvCT{yVl7-pNX&wA=}8p1a)9$3OEZ+FPZMFT03gy_1gD3H9TkA6f_9K+xN$Cmk_O~l
zaMUV#eZgUCb?pwMVJ|p=d=WkC;6hKf5m+&7L$y%Ek;Kk8!a4)gnLN~C<(S7yTnY*V
z$Zu~WNO05>MT2A5D3O9npl4#9t@KIadv!diHm~mn#YBwYPP3-sBEWUz5lWI5K}$9c
z-wF<vdEy{AYqY^Oz4GPg&qD$!ij+TAFh}g8=iJ>lq||k>@Xso=p_8{3+<oD~kx0^Y
zmdu5_l$Qhq;Kl&Y)RnUqCmlMHHJDkHdoQtg22|(;AP*d0*^#4p;Ak?cfe;VhNI>d-
zo{yf1pnNu_Yy-cy29%|zMteP1%8Dz95F&^NNA93OFcT+xUv6?kBV@4(=F)VIms~`v
zA7A)iiE&e5C&XmyVIsUl;<q_)^3Zsyn|HLSI9M!Wug#aWC7Z)K9m{-+N?gtDt;c0l
zy=kN;7lJ8o0`y&L+PcnadXqVqRVifeiw?qVzFd!wd)ds6_At{nZ0MTs1ZLqBB?EAL
z|HwTCab5zE{70N>6!Q3&3L;B?@ST<Ht4@!`ZK}Hf?#uLY(UJm@DlP78`!o~9!N72*
zfM^K`d~0VUqt}TphbNLz_U&M02N(aMbc`<q^%Y9_05H4oX_8&qK^ry|<w_D{#?v;m
zK|T{fi_$n1=Ip4z4={-9G2OO2TkYXg<>Si44{y>B)Jew2+TV|QNfOTw?iAolnJ+5*
z17;&F>(kFhSnJqcvXV-8@=|Cl%&*91(_c1Z$mf$@7FByn(m&D{FlkyZXK7G(%8CgA
zAcZv_Cg12AV`_va^KT-TFaTb~@2&m+1$_yhwdzAI_AireA?2YNm=MJlAr3_HNtAoA
z&FJ}1677vgapX<G@C$Fszqc~GUN~8Z`HB`!`#Nf|nssmTx5wa-g$NDVhG(w#JoUMi
z8QUUib;FGx_!t3sjg-B2McZS|dscXg2n_tU?>M2N7IBp)XeV|W7+0H9?m%-(B4XtB
z33l=NJGSnR)e)ty4<C@?Q`>nN;1Gv1OA1ltTZ=<f13LYy+LOt@ksTkn^885;6EV_b
zXPB^724&!53ImZ{;_QHZG5Z~$XAX+(lKdJqRl!*0@S|YM5^q`oP~I)X6jrj)|N8T#
zx2<GIwsvypc#+QHIfOR2`9aFhM+u=Tok~Ct3jy)YsDB&v388qe=WIcNVY9vrvSk-m
zol3L=Wvjg>`ieFu4@dnyE;96;9dWw$(QMC(uf-o@u6`{xH+bPu;)Ng+S&wA)*5Zlf
z+mAW6JBQcg_rCF0@4~WZq8^Tfz<3C3e<pOBOU2$lo8wxl%8Opw@4nJMn2w^$xLkuS
z>7A?c<TgJO+enA^gONP7W2J;A10iCMan18uPMoz1uOI8W)tt-PyHqDLG(t|s@DyBi
zel|f)%jwQ=<BM*8@4aoRY*GC@`_+kRc&6a>1Y+u&&#=V0rnJPfiG}`mya#2D0%kA5
zea*eNXJjK@jdj?lob4dLHXAd!e@HPVYcd8Qtx9}VOcZZbR;(cAfd{J|*owg3!RAIh
zZTUaZJp7^2yDLLGGH$p}(qjdi%vxIgHth1@?bj7P4?YtgbT!UpblrnObL9d?kXOTP
zhh(&#a-N$yRMYH>N;nu|?N1&dt7pHyt~o2R!Y~wG;vRhj09DlKXACi?b2O5U;%O%t
z4WeW9Rlg)K{-qh-Cp^OHUmTad{tqOD714;-J)|#mJRyp7`4k*W1mI+7HOHou!dhqZ
zYKRFRg@rV?E<NNBb~pcUG{ntIxXs{y%It97(>BHbKC|#8P};r~8PgLf=3mI=wCZWU
z)njvdgD;wBp*A*N5XwV8ukiIXEONGq^?K8pW$VL&RYpY2;0p>7nfggQo8yP;l$vX9
zZYh^1`*nbVY)dBMq&?@i_msG3Rx~i&z77YV9#5{kGVV^H-u8&H#hZ|>8;IW1)(*@>
zq|PMhW;^Px!185C2e7axv-!k;x&$bh37t}fgf2+Gv+!0CQSRph183Qp^N&cc4!hVg
zYbAz7%?z}rn-H2(F(ivC)3^JEA{=RDYuqqze{qyIQST*`g(y5?n!ULPYG19vkk_>$
z8o7hY)$Q2+`GH=d#&s(E<S{YZn{<~+4`Upjet)1h7|{C*ui|p$J2p>jOA8#LNpFJq
z9y(@^P&(>y%6eLwuDw4f;!GB>QuT1ib_S~mYC5V2Dmy~D?3hnWFd-F6K_2&<{T>5v
zGvuRqN^e4O+ET(_pLWB!wAyVlnPLt~hneQHsS+EK#8aQeE7q-L{=Eq|CHXGrTPQqx
zet6Zx%uXcE<9**Xk9V~L^Nmqm-<c(^A4+z_(7j6Kj#o5%rA#M$r+G;>`j2rMyd&mC
z8UW;ai?>Mdojdt@YH(P8n3)T=_JS`G7hDBF&AVb{%A{0Sh)q9ax^z$pE-c;Wf2Adq
zyTliMTQN-^q=Xl#B8iR0%@=(`RSFw7ihm4jRx8u8(+dsjYLm?ya~g7y=bbpRVEOY-
zGbB?+eQ;K2`tpL+O^c_$I{gwYc)m8Ecy#`z5kwbZMXy@!-_dw__PXbroaNi^)>?Pw
z-S=73_MbX!CT7Y*qr!x&%%Z=0q`fj%VEy)0GEJr9Ct1VaY~Ga2GrtU!*J#xuz2ct!
z^@NE*=<u06ePj8S%M;+-=)Fg2d6ZpZxNjWvYa2b;LE(y4z%nEsj!KsFcGb{}T|CPv
z#>o;Bak3Pten^sZl)KUg@lz}zzCZgG2frd%R8i8js5|2xZv*T>yD>{mur~w|k3J4O
zS%`l_>fFK;;fOtUe&G_>o^BvTihS31X$FBY&%fSvf@Sf}*vVT;<)0#pu_&M;`W%sq
z%H+v~$gK2>e~T1`JsWjB{XX@$OtBY|9u^eZD=6^&@hkso`y1E-#*I5K$@FJ_xJTj&
zx|S)QVVuWmH7Rbco>S{B_w;R}343W4YTZaElcU0iwZA1^MoS9%HthCEPfV=0n60H@
z2%cqJo?8V=8@RoB6ngOv#DMzj)-iQ5OyL5Hib+0kicjbmxszemb3cckPS}M0kYok|
zyb;N<3}gP<kgFxN&Xmv>u!1vBncu@BHe&M41iHkoC~297nVVEFF7q-Bo{KeHyF-)d
zNV!E<#J1b%ccdnC5bgLIqf*t`1?>K_?D=+X(=YuG9F3C)-dJa50le)I<JcRUgzxw-
zz;|vrz0Pm2p!q(|ZvGUbS3fFLpUOH1e?1H9?VR=Rnz|9BVOMSY3>)&T)QqI}dyij1
z%qD<^(QUHBo(k-kHa+}EOt)c;FUz3|g@Yy6VqC$vFlc#7Q!ArQy4=foeKf*RspT-l
zWiJ<2SwJ$9Ec(dG*n`dQq!@Qkd$2p+ev~JF{duJf09dQZOAK+0UfcItZ^^oKo&^ni
zpcwc`Jlaq4Nn^GcfqR|1OWW*P`)Joo{GK%^fOY>VIK-^GHM>87C%3xumhUAY`1Qsz
zCUu4haH7{|R>m3{lKEjCvLt~EEum1V@<^^>{uuB1{ALWxjsg9M6oOMy*&^2JPRysE
z?x43Ts|Hy!59wGOMdDrgTRy?*D7>yLO8&`sxGUb!@urDOd`oP)H`Dt1_bO<oxc|dH
zl^nm_F_-XHrnowL^z{>KDIFgsB%RK|xK^GoIkBdz>rsxtTEVo3w1kBRG`?52D#bcy
z`zt`j{#NRT2i#Sjzx=%@agAioWL6bK_SJi?e2q~7bP<^c1!Ne%{C%n5=%WPHA06Vo
zxa-Z8@y!+0!t6J9uE=trR8W|ermOwIdmxpt`BS2<>di73uPAXDAC?`t$XTsnpr2Kk
z-}~;j`|>?%N9x7r&g8WOT09Jp(&HrMp<;<2tbbQixqyO~^p0{g=`hPL<|+#>+Bx|<
zh+A@q=0{q<mA5uMOah6esgHJT%-f|FQ3a{p3qD!J_yc_ciV{r0&}nJrnp67Y<6$<5
zxMxhZUNrt5N7zW$;a3$>fbC!I#zstoiD+hcK!f-{LjE2nOAz;|76Ru4zKD3c7>t@k
zwXII(n?7m5$}QcsTI)2Et=dSkT-WwE@xh86qrX2U*WqLJ^7B!chqOd7ua|r5uIPm#
zPUTcW`0W_i+{Q9`RdBV)PXiWXxLd#bdnCs{(*w>^f-=4w0V;vUz)9;Wu#1LNES+U#
z-@_*Cv3>dbjdnfr2@w0y7Q(ABw5}!S)2~Q$z?9-aN!RgDk4wFGv9PJ91-z?w)u|F=
zJ%ut-zn(j+vE3}RgM+ZkadKBA2Q_RNu1bNV{MI0&XoRg`rdna&#k!x`1tOtt*K(jC
ztcr`0+CREG1*~^A9XF67E<<YOd<rJ@XzSJGzcXd11-V%4Ndl=y^;>sfk3Cx*>RQLN
z%of}6O?ISSQ`JR&Tlu%h!vPYI?WC4hDJY6)Hii7UPbEg;aeiv4R8gTk2C!uIiYKSe
z3#Qe$?##<*S%jUIT@3y2UpG;TKqI#0jqo(<5h{aHYyf>nxzNjI-%N~AyTZTtF^KQ<
zM1}jI=<?o8cJtCB1%#(Uk7^h#MO+{HrX)65{rUNR<{SHII_2@!ypy#~&5}x(DXa>7
zPM}X$wGrf<CW`&Vc2zMt{#f5G|8&VrEMXZ2Q&wN^31e^&0%M-_QL9`q_D9CtAIwAu
zzr<@JwMWsRcG*+J4)junCGAWqco{&AYy4Ax0VUkD>i#@Joj7pY4?IJhL9Q;w2b6r3
zv)%`Y_^gE^bc2ZTs%4BxpBF`-_vz7<{a$&)#?3%Y5!zftgfXR=bSqq_#}Yx+;04CM
zUH=HV_`~e5QsTM%oEkqgtYB;hY@bBd)?91FN3!DCrW4n+BTi|PgU>72szkc=X(?pK
zgEP!+Un{H#W$7FMU63D7t=M`h&PCsWKr<X+16KtVDG)5J&fnnT6YzbuNex%$BX5Ad
zy>Slo1WuRqrQ!V%dgcA~7vyb$7Jp`6=OMub$6q5a-1<jI_OzUBKNj^@5i-`w3Apnt
zrCtQ?jP~J=E=Q1KR*jGXi@(m{hTo3`MuBjjRz<h>3E?dR0GaK{JC*H){9)TkkOBKG
zXpXNl2wJ5$F}^E{KX?&Y>%>~)6hjd5>V%|eE+fnN_qYOlXN6%0Pt1P`$Y;d`eqm_5
z<pgeaN=E^A<aB{=onnrNFQlq}R!*q^?s&`0Kq`ws);E5#EIv>+HYc^3(cTDeZ(bZp
z_o2{85mwzI8s%dOoqFH)be)4fd)ZT#nY_N{5BTTdwW>P!g+-N~)@T);?v@?jgC(Rs
zw0jsu+wXT-szk!#1%h8NYg2lNSMfoZU+2Z2nh+O}6Bcpfk%SZ^u5DBb07zDF>RfJT
zY@b%}69ciqBPCIx9x!|><L%iU0m?+ZK^8J}>);BONOF{UHoVEkZ`z{wkJd3@`{L)a
z8f#k=7dq#d_5x|5J(7FBu#6Bhk4}xZ@9UtFM}>wWYw(M;guPpSoclfFh=hSoZ<_f|
z2$15GUZ^dT+}MVEU5<Pe;$$}sctiQ|4<Onh{V)GU9mD#f27q@UT(Xa{1Mog)pPH5M
z>Zm+SfKvM8j;$No<4K)yV9>c9ctwo@1f7o9XC8#{2ii{+LMBlaeMAM-zx4!z+6zyy
z6|&7hOOYnWl33W-*&jCXEV>8dGv`SUY64^@fJ8?7tS?xLrh<Pcqt>R59=)CAE2-l&
zwrTnL#9Z7nV<9Mbu=d#&Hj^Q{&7D&@F9(hwWm8ueSxD$@C+hP^8Y=T;PuP=wbn15T
zBM-pQa1=%XN;Jywc<mfo_NJgsrgBe^kkGUC)9*iCpWQTo`l*Fed-nH-d_INKU*;ne
z8YunbI}N0^qdVQ8%Yau++oqIMk>UUkHi`r5^9?ae(#M+?D?MRbe-`O**yGlLC!q)J
zm8=l};+G#cAQvOm2?b*f6%65Dv&5Lu1-h&oB{9KEvwq8L^5@xp%^he~*m3tk0kM32
zH8`jJ{M!7){vjm61)p3YmC2&hs6|Vm5P*DhA>uRGpGud79;MS&ciiF9a$Ap8`O&Mn
zc}6*7ZF2yB-WiTFYn28)Y}b;O6a1Vq$PykH(S1fV=rp7nO#$0~58OcsW_!TN$QLfH
z^HL|8jT0wi4S<67*KrD(c5(J>`lMqb192R)v&HV_%NO{|<b5<z5f7iO{LoJunIY^T
ztV`bqV>v}MO05u>N{fTUF1~DwQ5I=3D|0PFPJ3;jOd+&DD&auWV{`Oh$}k0RACrGY
zOG-9Y@^s*|9g&QrOJ;NEb=l~u$~;cGJUjX5OdLMLaGDPaf9`E7fAFY}4BaW8Y02C1
z9_5?EQv<~~@Pj<Eoh%4OarJ3XSCH60H!j__?@dN=b?39IbU8i63{E(cbhEm&X=TIJ
z0q5Ta?j+W~rr#53-OklGPo*$o69~e5@;5*C_Nt-6{HmAkwv$Qt!^9B}-?y;^!H4G+
z90cG<wPmRG&L%K@HF@L^$#(f$y}0zySvpZK&b%@D*n&@uxx*LmU&BMg$_!7}30+tf
z<u9<7S<p{Fap}1{*0vYTavByRLb;<o6^v<bkn=vDBRsx8VZlodx^fm^L@9YoT}a*_
z+4V3N>X7qQo5l}%gmDTSj}G|cg{d#hDi*D*A_GrA1`_BJ;@giYfLd_uBR7az{MAyL
zOKXl~1iQo+lwmdI_5>HK-(5yTRhjzM@@JWNRI!MX&o83^Ne4!C0~?_VTk!q0$l0|_
zS?0&1Pk*IQds9im;j%a`G5<aJh*-J4=dU}KW!coaza((2ty36@ARx5->2JWB*S4yH
z8<p?+=C;ol&AT$X@rhXWx)UPLGeI0w4)E7%oS;a*5`=0xyy)lDqW~*~&|=?e@6&nT
zOzwgOU}+wd&d6SX-fx`6pU>=lSB@OnPY~e*|DsWqO2Rbe%8n4@tDZ>1iwd`6`Evc2
zPde9|lo=Xzd%Bf_8rg9cL0Sa{2BcxSrqaRPuczi6W?=QtMpWk1`>DR$>eW}pSI(_0
zH*mp?Aj8K>xUbTwV?ldCkTazhW>+4Kagp!7y%!hh_1)E&;`BE{vVDRD5swup?Z={(
z>v3vs04tSL2K0A~;PcK;8F8J&<nTIi)N{5ox5$!=8jI^tOxWM%^*)w5ahJWj%RLGj
ziKN><LVS&e?l0Fjb0b=oH)QQd*ERjZy!1tIheJINj$jYwI-m7A3D*aA;IJ!7&w)(V
zaToPuTnIAM=!osduQlc58~3ruFH##wVaB~%xU;wz8&>suXxyI<dtpNUAHcz;p1Gr!
zI1;gNJV;e4(85JSfT?EnS?;xjMC9{HL+(vXMAbQw(!)Xv-JGC62y~A{CO0_;wzdFA
z7gEc{*L+@zKR0}3Q;3Rk5b&$|1qfL(CIXy8h{Q`30r8K_bQ9oyVfx>)xA~_3ZLzRK
z<p1I&vBDBa*$I~Y)Fz4nz`j&OVB`cwp{iXx8fQ}8!>RY(8LycDZ5FHvR#vypUXLVr
zg59|pYuJYG+oD>vgAaaJlvQ>m`r=v7@jYj-M~;WRh^(iZxAM-CFF1bLa($_LeEDB}
z8KFMupil18_x4wh0sKNrww-^|)lyWJBQ7nS6<?-U(+5v*+Xgv@Lw`I!2T#r_l!6GY
zvfoD=)Js48h(PkKSzF(I0RUPzA{{^2AnAa~N6yxVbo}9<vJT<1%1@*9seO*{Cp^~H
z{PclihGMTTcE}&A8(uGv%3E$}fMp{l$6be#cXoF2RJ~Sr*Hm{F=NI~Y{4E~zES#IK
zPfjkJ3mU9X_AIoh?yTks3fkJ{1@52Zsdz2EPz7JBt6gdc2#8qNHE)P2qK*a~_ZOC*
z4^(HXs$V?1+p{e=QeMc`zmO%dT74UMyUsbh)xB5d>W}O4D}}*-eWq_Tuzw<8KxIT^
zl;;)CO(y@Y@3KFZZXd6_IGKCEefK?&n~s(HUH0Ohj~CX~5B|p9w+<41ctr(2)6~}C
zeKB|9v+C_XSI=^87rWDP>^1AXsFEjm%L2ZN_wioao#}Wt)7HA?U;ko$e%@!UC1TMu
zW1)ZcVE?txtsAYyu0wf4EvJ%0Evoe@D*MO#$<ZFQK5Kb%d8#Ttt1nby7v^4j&HDJq
zc0Y9`%(eQ=vb5G;%pI%LC$|ihmnY|Sdvv(Zps9|UHJx1ab2dVONoyC#mlheT=C!B%
z>|e33&#ynf6B#Z8YziecrQ8L1`yil!6Qvv2rTDI^S6Gn#OY@0MRAf*3xpmU>%6WHb
zC3eO%c7z18(UEa3OhsPJ>oGuVD450@tZgy&y{SeglZ|K@w@iOc<(cnOR6nb3&C;H*
z94my7MUW0K-Wplb{QY#dVA;WzE7pyAC7u6`49ooV7l|w$(n;H*r`)_do0qHqlb&8S
zGnvI(pRWA{AfBC0^K0w$+V9Wlm(ycVrym;uy-0vH1GMY4D19$Ldrep#wV1YAe)9R<
zyu@8}R5s5v<fSP|LWhO9^ZkYT7mllm`m`dL@$}r6=8>iegQ7x6NbcS06$Vt-V|~uI
zOw4GRCu+RgV_GYEiEnX|X67)~U&)vQ>sS{xIgZBA*5?74nYT4A4k|gi!XF7gxa^~R
z_sK0K`qGP@eM;+Kgb#~I@&2sZBi|;{==<n;)tFW>IzM~*h#x(kG{8MOrNzrKeem=F
zwG@rW`PxcZ)s&?@erJ6G4vJhMnxOZ(eJ=Bx=B`dk+S)Mw+B;$qq5akCS1$CjqjAip
zEV?r*PjQoGeYN{a_^69bkP`X&OZjv(dAB{XaIb~tiCo}NsGsKO(0jJK^MO_Xz#WKG
zxAYW4YHYd-W9*dd9TS3(H-rBQ_LE@RVh4k(mE2SDtE~?8W%M=?>pXH%PDu0=*DTAz
z=Cez2{~{4FlF$B20*QEZD|KT2O_8O$*+;uQoBl1|Gz)?U;M8Nm9;tCM+tdLR%oytI
z_NLfLFxb>@eD(AUKd1)D^7ipDO8jBi-w6H!aF8yN&$%a+mE2^Q)w`9nKB<_w`c97T
zxAl`#89d06VdACMrliiaF@<5^BTVp>|Bv5%5W|@2P3(U*OUz5g*`)btS52{GD|nbY
zfFt*6Vj+769+{GgLUuKiqCF`;Kfbp{<=<IfB{@TyQg~^O7MI=#Y9quy?~bt?h$l#U
zaqDV(HB$h?FuVFt0$ZQ4MJKcUyvw_K0x-+c=u1TNLi^1vKEPud07mckMD#}2y&{(D
zx-gm_-f3*Ti5meg4}iGu<(iYow4lhUu!FcqC6?WO7tyqA!1FC2#on<eSX}rWZ*>S@
zO2LGto%fgPGaEiGA-ij8!{!o^Oc@XV@>SUOSltTB(Pd6W?Ohh@iFMFVW3bJKhPZwy
z5-yX6Q<=R4#6gf@r@RuziB*ChKI%LedsP@%NV)x<aHS(YKFhf2K3nBRBG6zW+IJ-k
zL5!yYKq|vLe@W0A9lvjECLIW^N<L8~CXLBoLSK2FfsoB^{R-W9Ct0O<O2J?r$5|2a
zof;>%mVc?Q^RB(S;-Kix?6NuOnT@U@(+;M8QXO?gP5^7d!(~Y#Lxotedw&=h!DFjy
z^-pgmi>)*}JZ4GSB^jV6I!$TRtUo&X$5gh9xo}lkPICHHL&N5BH1l&I9|09mD8~&|
z=X^PSUXZ0qTEuRLQi9WuTbC`l$~tL%O}=3Kf<*z^-pyLJphVl_(bPa+K(k6^>Wx-5
zt-P0#|51s7GGS3MBS1i3!#mXzB3R>bzUm>;h{?Ev4!)G}t#$pJcpQDg$S|IG(>Wm=
z6X7jnGe}Qtt*5t^`8;nYbh4cArE7z|NIV2h3AZu0De&yQ@>#K1l9g#t`)DM6TW}#i
z$$jsZHelFTG@%`~f^83|!L=vM6@z~t^-`-J!z*JSI(w%s=dJIhs;~GE8?R^l&c%e5
z%5HADr`Cjh%~`^-{#E!8e?r3Ia%;p-HVt2LzlPa8@bda0>DoemHQ(u>PfsiSUjs~4
zl}6Po$if-Oay!~NKnDze(m2A>ANet}NvzFUE~GS#)aFe}!)TzGA8CqwDzXqt6!}kG
zq|@)GZ_>xa^uj8poyn`5=$ji7IS~9R<FHi;$N4!twb%Fm`c;XF;NoB{G8QDgUzmKX
zBwHM|@%DQJ_=fAOxE`tx)-Kx}HZL~d+Qa+RR{|T|>Ci)4p6e^Wy7=?l601{Qd!l-w
zKzeaR9q0rUa_<?2lcQKN`Xve{QVM_f-r<w#cH-v`8IBxpc%o0K6|6lFt)*#QAaQW7
z?<%BF&V7X(5rEa$SW#kr=^Mcp``Z=m%@#Lw8vcQpE&cD+!D$9oB)CYbOs@8vM9vCx
z#LBF1e5Q@CGA~%0IymY@U%Gcw%ox48(D(<zo1~}icYs?rLrws?=6AE^0&WP_kZ&@b
z74)Dw{^1CqZe^1~#f28}r*~-g>}L2X6RY($tLxZ4Vagecbn!{!Lj5Vp%$^y2@E^;p
zLaz!TdEWgg(QYrdW1i{G`3}ANeD(Ffi|v>ozz#zCHHGb&TRfZZXF%PJty(JG%w~D1
z{Va6|wk3`-v1*@ioTbt$K=Pj<@RPOF6LJC<Wm41Vj%Ol)Q_H7M!fX1;gAcTm55o{q
zC~C&YyU%cDOhB>t{Q^An`poFYIT^G>@r!SyeO`I0O(Jv_ZD1m7a;~YNuQ}cVPoI!s
zTwbFN<1Lk9u$|(X#_uzw=hw<;mfBtj6;Kj~T)k8{RhMAUui!QdpV93M)|VTSmK4yX
z=PuyK9VS6~1Q7k7L@~;FB!ANauMf*Fsj@u0Hg}!ZpUY$ilPNQBg>snQzo4DSp;_i4
ziZqDwsSmcl?>ei$x;Gyool-y|OJzMbiY9Ya<N1<qgZ4Ks2eBKXEhV_df(jKOgTCc&
zyDZRfC~vZ$68&eRmq_jTb`2X~^o1?r0!tTt&xBmHQOGzEOo&relQTv{#H6<!S`Iox
zKVOCd&xe)ow*<jXTR~crP>L*FKA^Xw{Nkf_9!+r?T=co3*K&J#WFdAOpGwZwLbGli
zcJIyGg<U}SBgA}DEM7c~RnzIw0sh<LBHZTGiW;?-(-@}sM75Ja6$Cyb>WsN?Jv%i(
z``H3j)buQw5a&aq{W)^&K=EN5WdO&!g1zMT=<(#`jkzc`B<sSZTB)O5wC8z=I@m2Z
z<iFHmwc%>);!ihWM_}yA|K{o}!DT~UlpDG1lq#KHM=W|WgZbRg82tCff?d{U;9@^E
z7d4&%TwbZfkpY*!wDEtW`~y>r+P@J=>996>+Ap>ACW7RQ`tP?;V_LH;zUvHvZgA0O
zk=15lG;heNiyCN-!uw7k7JwU--=F^LZ*W1pj*y(ADc89;CBz~yrnLNOq)Ch@@GID^
ztpUqs=NGA-Rz<`4W1VzPwnLSe#SG;$)DN#V5@m}Yesw&DzZ@^`$)q$y&KAs>p(sa$
zdjSmsh7?(v+I;E`9x{@&p(qZ!2>Mu<0}TrfyY}<%oKSxf(_0x%|7Y*A)^n#FlRkTH
z<q{Ulr~a7ksXAWDmNDdz%)U#f>vnlRSf6-ie8<(O$8&GJx%FKJDO@DKxoTNr=*I8p
zBG)qQacExmj}pNy2PFZpi;?!a8mi#V%o2~w5bb^WGJfU=jc;j4xto>b4iV$RO}&4e
zdWLQg!wN7T6TNb%4bwCrJXeY=wJyWR)1A#;OGZN+S|Xr}0VK78krXuF$pG{)QrHXU
zS573pBjN+=me<<<gJSd#$n420#M?gQZj`#?$$IZ8+@Q!wq=umO$v%dqN~9Mz$QbIR
z_omAie6qFg60uDK+mPJoSc*C=o^m0fnY154sQZtbAI&3WP9Kk!o&U0auQsZQNJzsT
z`e6D2gOnSM7PyQmQU9%Ro_@1-q-QQ1DG><*lBBL&VG<i0j07II>HAYs$^p8UWI1&}
zi>J-@QkgNnfLm^VW-=+G0668h_q!9S$F>Ct^>h2l`hd>QTq`slu@%j>OH|eiLa5Lt
zdymrIcuj0X_&B*$3Pti;(U921JZYkw=7JDI7Rq=ixmEMce^^)+h;~sUuEt|mcc(5=
z_OUaCljUM6mEs__*hW->@HQ;T?(bD_oIAa0cI&OzO(fCZE=zgxFO5PH$+iFQ?Qzg8
zsn<Cg3-pfWrTA81E%Oi3_>yzvWhLGCVU>l5>&AwzAB{YCew;5i)~Qr@oBf8}Q1=zz
z%W3m$=TNY(OyT#8-`n~uQvK#3{+XU`*fc2mk}KS86fpKDuN9Rlu1}tu2lO49jh_#}
zg2m&so%|e5KB{j=$4pU3AfKb1l~$nbdpQN?Krz}!rz^fx94={X04r|T+zJau4#a9&
z#%FTu6FVbY9gT7_8S)LgG6Y?&hxo-Yd6slHP-q^_aWC~p-3q<~Y4bWC3;H!xW_hf_
zg`jkEg{*5(`Xy>dgTxnxG7telvUP^8mKQr~NSR+5BEyC3d4;(!$v?B-d}N_~HaGDj
zfV;gxfb#qwLxR&c-l}%7o_A7#k9QkgaXI<%hC4`R_^;qhvPX3((>Gt8?r)JH$V*M~
zWbVMjjqZMWWXFE)i9vBF3hO*aTzVSzfF0vHEQ$kNhU+#`Vn3}vOQSUF!J2W+*re2b
zk`cv$Yf|G=O-lh8U;ru4D28?hS1$`6>$q{$1P&O|+RaDqckVd=d`*abN@o&U=~8H5
z@9!aK8QXkOUOfE4BD7PIHd&sWfU<J#_83Ws6HXxugTim17J#O!sMRjMH>NRCtG%XV
zMRvO)fZ=WQuDB)pm5d})zFo~K$vLCr4oUD(M}Krev$}#K#gbT9c?URi-%cNYo|@(H
zq!9SCFD2-}h93k{(V*}QNTujnyNlA;)!!?Cs?cbAG>5K`lE9y~mqwj2c1I$Z+^4JE
zrmskrNl$>QsVlWui8=TSr+au9PW56WpWiw(EQt3%Lz<LEu~Z36YQL{7?RC$2dhwxD
zPb}-kR~V*ltLC8CFsM~Of3`b31KTnx2l38h8<7wm2MqzzTqpgBre*;vvyB&;Mo;bq
zVa$qDH<$Hj$AFYulg_dR@cNB=BMcjADv$5q0lc@Od4qo}>QD4G1(;KRzu!KIf|SGi
zH(BM_ZwF8juRe8Y|GgyPtsC8@BSG1s#rgz3@Dw>cuDRdXuoadU1a9J2!qIk$u3IBB
zXuM8=9o9#LSE!!l_z|3OZ?1$ditSmJ5?B8=$DTthZJyH${RpoVv*CbKSBtxLmUF^H
z3J>AT7-PD`{?Jr;dUQ#PKcM26@<IKRiiy?=?X13~TM&1XI+GOj26k4?Dbonju=4#$
z=e@hjjD}PbIh(rMnrEd=<YP6O$gy#~m*U|Ps4?SM(cqdhl7ncKvrfa=)J7P-<-dZ=
zR>OF%%)0ev32!!l!`YjF51?w$>$D-?)a|!SK4GoSM>2jDH5wLJ%e5~W3Qxf9SE;S7
z!MQ)f3lSX=>aD_c&2a|IKGnOtLTgnzl_LaIbh)D>qMN-$g}>}eRQgfmld3DZ^5$=S
zND<=44US}}ZFwg!lIJ*Y@=63JQzjJA$QzbhrT%aH=!@|Ox|<yPMjQB)1WG&?Vo;pb
zcRHYpXNzjB%UrRufLz}}``{iKOsYaWV_LQ3W7B>k6A3~=A8Xphgk5|}rgCekU!C|=
zrJL?YLu?WQzk*vwi%8W~zIIeLY-VK$x)5MJ1l^_AlKJhgPl9Iyy6%>lyludr^=1mJ
z_O$ImIoH}#mfy=e>147?dkh?WjG11uNwbN(^Jdp!s^P`c>U>QrNi$!6ylj65mD~Hm
z&ehcVN)fjbRkueP43_3sF~l(B$yut8-s|kNNyurxard;9`9aREg5=9FCx72ZNO|Qj
zv2$c{G*K$qG*ZlW9m9(}T_IBfFeV7Hw}Lh^crE1|pCvmb8|M-k^xgJea0iF8s^nLg
zP?K%Iw)cbi6MT}xmHSSyjqC!~*Ilz9VGl+D%mCNJGqGmZNtN3n*&TlAf%kK;pF+pI
zX)UDTF3um3d2Ql22lm>RIXX1S!|o{=?V<u%D7iz~V=?k`{w~0`qTa%P3<Zf{4|48d
z(O!2_!OB5;T~MZ1oB1HAI)}m<)#CE-XH?gLWDinMG%OS?HC^Y!ZPdiM#QXP^BV?LU
z>5BG`B!<6cMmXG;s0XXez4}Y+vcLbeOWn_IdduG93z<&TAf|FiapmOXr2JWb$d!EW
z`}_OfKL+I#>)gRwmW2{2QXb5B;(r2teLB^YUWV*$R+->vR`Y97z!Te6OJ%vU`Pes~
z+@?FIdj_{br*F$CGM{hc8OsxjSC$)_wQoA1^={to5)Hrx-Mk9q3ItOYiC=1OI>`RQ
zCZHXxKro*B+Vwex%7r(TA92#xZszg}u`4j?^suTm3S?jnWA^n_=zW2PFMLxN*V}bC
z<5F*Z5^n#v`8FY2jmkE}!kDl-9_dYAO%5^TUwLtSw_Vn|nhj>n!px1*PiIoc?H=}8
zDZ^s~z7mIF76Qg^xw9QDI-rjIJ<LxmNCpler_LdmEY;*IvRr?utDw(b$iJ`c)gYM(
zGUj9qUZ&<gvTxCfa>@Ba^d)`r6nXY%(oWxz?XbvlS|*KD^Y9n~0RBY2JYcbhs`6W)
z5P?pBZap>&U_b?2<zb1Kx#d9rLr8;Y2gd88dGj@V4y#}Zg+s(nNi=lJjqs8W8c!BY
zkm-hj{{9#8P7bk6;Yd>l9sZLG>7DZZ+-b?M_fFV)ku~O}Sv1GJ2J9c#WwxSd&SBDM
z^K`>`mq=LoS1Je7H;M6^!nI_^R@Y~W4rX@<G?A*`dL3cLzZHZ%lP`lCnhJgHF_-?v
zeo1l#!+>g`V;)aM<+1c_1Vt)VKF!G<jqce~Xp_&cX1tdCm^G02{|;C#s!HErZ=X}r
z$?7(^NeW_Ca$AVEorgnWee*41i6Q9Z2i?3Y{j6DXZ8n3FAfWa+BPjB7m9NUY4C@15
zFzYlLpo#{-uL2ng)ZIPqZ0cfOeD0ewjz$BP06;(ytt3Dm3-Cb#kas{_Ou~F1h%U_x
zf6QK-o((dH^8-D{yE|UGC6?zj1;V*h_vNZ00Lbq`{UDqMJ}NW*<t;<a?@s_)04)f>
z2IsrM)aNE`)!yL)dIY7lwH=lMIw{Wh-h6SR#2Fyhv%j9AksABHRcSG*{krH`m{GPf
z^Gde+fw6>x6PH&Zm-&ySb@VTfyn<D1E^x7Uxbax%GJEYU;y-Lfx)igh_sZ;-{a6|n
z3|qF^yoT{F=h{Lg#>d+1n6Q`3yEag7+s=~#@SGv~sf`7=ZB&+nEe{?xtEv40c;HTf
zvgPSsvh7|URc!JB7KoLjFhQvtZ{+^u992%XiZYar=ZyESxKz5LFmLx^QNJab`sJLy
zPq7WH{Ti^yzZ5e8V84A;fmvyMMDCidOFx1FU>g%2fv|MVZ31MoT-D)H!l8|9CgPnq
z=bxu{-L2u^|BVoUot@KuDsuk6N~Lek<$(aUzEmG}!Pu5*4uv#{sAv;3BIs(+*?mxv
zJZ0K12|&wW8Mdhb0D>;f5Wyu<$h*EXmutIlCEI2`MY=`|1n2cY?&D=lpVv#g_7GEJ
z@;h!i*=+*97vh^4vwa4;6P6j|gyiYJ3-}}yV@cWigPDoGY-Q)ttq_8ZymyULNa&ap
z&Bk7}#N<|sI(Di$$l=}cVVpNr=Igz9qTkJHJT1m==5<$!?h*gWy+bw8d!VD7j=%b3
z<hJZhpMCNh?T!quzaEt|Rzm~J{eu;vN>eNC=eW8g8nm7t@PwXTx``jF5^c>F;5AI)
zp=r&Tl6=*l?C*AtdAqj^EH`@qbl@XBVCC7&q06rgfqSvF-u<2s?SDsr@FlB%)D2sc
z!5XD}SX@QVszn*H`FsC01rw{UM`I5%<0&3=(T&?UWbNyEgfSUSFXhu(b9pNgt(8#k
zRvV^&GhVta)m3Au`7h#pT8fi=8RroP&kD6|Z{E}xQ`Ob3Z#%Oyiv)gp24Q~xQDN_}
zgF|?(BZ@`vp6S!DCfstux>U}mhG&g-`+KOh_0O7PBzvpd_CjWS+TKZ7Ydx(Wyl<)*
z5f5aI^~tuh&wUblthm1itFETvwr>j@q*EZ1SAIWt=l_=d<TWY(fltCp)Sx~Izb9J5
zx&nAomK$>4aGR#$YHy{y6JwZ<a=m5FVlRF0e?M#io&mZBO1N-ea#%^GliR?E-+V-)
zB{iNj5sKCM5pw?LR-qKv5SuYoB*PF$Opq73>MfSMkIve+!*OtRB=9e*8bMA*eaNg@
zM#Fzs(vHFZsj)VfO)XO5ERfgy_#b^%;x6LF(HZm$2#>hPW7YllI6^U<*i+FhtBp|?
zfvIlGF9|#@a?xDI?QFM<nl0ENSwolGhK=;@s-+8yVS-X*IfByFJAo`JFqX5+0Xk;X
z>J|T*Z$=u>@XPwcT4s82e8#qFJlJ80$#I5k%7OjLcbUM|q%@|!%<9f9pBg>fP}=IY
z@$D8EK}FmcdXJBmz3#qto(=8w{^PFwpuh)Nol-1RX7`dS%(5rN%)lljF2nujt;;T2
zePeu7VCF66f%pS8DN)rTX#$6~`oPmb4nz1uw+d;7>{fPGLG1}~pmfm6aK!HfNEX=O
zT94sh@Uof)&2}1qj&S`6c*8X*uGM-0E2vTS{$!wg%FU&1e9p8$81i&r-{4K>gMtuE
zh(MvsaqK$cU&Jar4)%gEqS?n&-95=IDS;R{EmdX^ZEth7A9`Lw?R)*FZO@A@>3mQr
zTr(wvWqCeyWggN3JLM`6SaIx#d-n8*rp*^Ha9E#*Quux+h_O|I@P5*>f61agOI@os
zxm}9z^dcftHF;(hcBJWQRe}CAdm+N9n|L94Mj=CySr0cTz1_#)5h(WhIgNNicqEza
zXIk!6&9@TFbf(m@mnbJDta?0d5~2+eDMbMi|8%#@Vf6m4pz;|y%8qGCU?@!x#c!+Q
zdhER1Lmn*S4atcRp6khb3?wXIeC=PT8S(o4(D^N)Qaa_yna^>HTzKyy9efHXM3(Dn
z@(RFg4A{+-vPS`1nAGeJx33N~?{p9f5%2WRDVB^8DOC52`5%e}J)720NL$;bGon<a
zm|b_<_?C8%zH&{W?*)n&k(esW&;ZIAeAZhiu5Tb(EiA_I?ww)$I&Swo)}CZu-(X2Q
zxjcbxw*m21oKRQf@b$M>Dq#Qd3Sj{O0dEgv55b??@-`ivwguiBB2M|T!$|Rd9Y~;|
zUF!@2PXh{6LB4%ct4e!e$V@NMO##olyHZjKvnvWE3U=Xb$>Qvb=A|xJ#4<x%eHwz)
zdSCv73v_V_OOx38Q<oAh`2_dUCrNMT6UVNj21$z`b$)p(8E<`XsS-A}A{{7C`G*6@
z_Sphf+w=TC$1G9$WDP5O{jrf)6_QqPuw<OLCAI{eUWRbu+@`r67DzZLIJCzARgS@r
zk1IIP8He-&mpr{jQ^@&%x&0SxXK<Pn+#+VT3?j8A3TH#KUaTgtB`q-DI$wE6c=&68
zzGeo`Gcd;5d)oAaiBM<cmmJRX5#VA{$s!v^Q3lf6PMZwdqA!*Uuu8r={_s*qDYXF#
zh%2B#tFg<`^4B9uMX(cOMnPBSa4)AsqlL9?6PYT?yR62(oil~P3gtOXBh}|<rJ}ZJ
zMQ{O6#83Ly*RTzc56tY~+D-<7p&5f3WPr}=e_9>jwtM}t)CLxER2#nam*=XFFa7Jv
z{Auws)y4#T<kQ>J(;7=yr{2uK)0&a}$DSuzEx-H}<I`%?X;?q{Id(AnzBk+G=ic|D
z2&gL2FN8Ut^dZg&D=@S2n869&$Z~D5T^ADm)XDl{c#BMMR1c|!<<U#Fe9WR76>{xl
zz%n^DMMB|{g3r8@raDkbrY%qL^J#2cSs&2FJ@f6=m$)cYn&kyWdW5b~+9~FL09Oc{
zZxa3f>S;^&`6>PX0m?u%znB*`07U$+w!jiKdFA<4`{H@K$6y9Vt8@C;0D}Cc(9~D6
z^o09r{=ejr|Lq1Igo&Gcg#5vWH!nJo$lzozv@m`%jQB3ndhER4G5+uU-eT*?!`LD>
zUEaU#sQ8@l$6D-N=l)pB=Xcxw4;7PI#6F`?%|k9e0BySLb9yqhdVeo%{f2&pgQR!~
z|FAv6U+_nr{MZotwEqo{dEP^U#N@<H{7HCfvwRX@AbQH6^HPPp>@s)9cuT?62N2Mg
z53`No;(sOt`JeU8gxmfA5Esh$ex)ee)F<mab^?8HUx6OyIC~1!tOupZ;2T!N9|^&N
zD9Q7o4~L+`pPI_ZGLv_N?5gLM!vdc-EExQLSQtUa$q>CJGKdekSyGs*7+yc)F@Bi~
z>wFxyPH8{9ctX3HX#ed4n!9Zk_VI@rPA>n8g7b}OxKGXdOaXG>sQ{j)1z&aDJ?nyB
z+C-hm&4D_CCh)jF&HkA9EB+r?8jQcd4}b4&8S-wn1`on}VH->hL{y<S|KJS2T<0I}
z@?tL$HXv4jFca>V_yH>i)_;5uN6c#hz=&BtwLuxM0DxkY%)5CR{cSw(KiBcHIQ$aB
z5Uzm>-G}}AAb<Y>&wWGxv0Pt-dLG~d=E;8XKQJ9o=>VNYjZMGDU?nqX4`2Z8?xSh<
z`ESSn(Gq|4idmiI2>kG2)nuSU`{d65!g%CnwIBcvULtvQAR|8~7s);yT_X$k%zWX2
z1w7c$h#HK78Nz!6Ff@4gzn8-cj<wzgdhH{+_mo6*G{bz5%9Hd&|6YtOxd;8%7{u;Q
z9|-V=;Jo9aZWH5v<3IzYvQ718+P(}ww>dxcctRWbX#JpibU2@|<8M9*b$ucuFg#Pl
zP3}HpcOc&|H5=mK6D#kad-rVDyZqnIdR_t++c;BVCHg=jY<aN~@P|wjzR!3GedE9Q
z5VfNc>6xkEgTqo61iLUq1P%A{3{R#9v6J6}_4#$L#9)tj2V~7k??@e{Y8$%#_(#AG
zvYvQ@)POZgdVT;8pJMmceerMJ`YJzY9(6`;6MvkT&%Xx0a0W-#(Es&njoIoW;=cV7
zPyGRxymc%1n*tayYVe23;yEk`0zVyckR@|tKmk9NY~cIeKaa)+3Ip0>7#Uh)jEvvH
zH<?YL0A-v%-gW}(f=EomGbjcJgYJ2TuVegFcwmvfEAt0#P1YtxjR+EOe4o!9{Conp
zLX|2%=m$H#a<=m=$-|!y@$rxs-3ET=Q?D^PEe28l7Yli^c${&=A8Dj~@V31cpXb4Q
zoaFI)`N5aY=<MPof+kbV{6)h}UG3sLM6}F{!V>t)Mi7_7iRR*BvEXnTz(R13%|)#q
z3Od$=iK&Lx=V0}<bBUMBSf3LS;VTdQKpCYb*p67)tkCf{$%I#n-xt6cSzjrE<5Jn;
zd#3;l-{pP22aP2+iSBw^zKS97fc$p=O6ffh3692qO<(}+HPh4hfyJ!$$WOkU_%c)Q
zIB!U#A7CHH@_FV24qCC9oL3}(fWEtpg8u;Tit|BonElNGv9bPbRN}rn#y|s`;_`YQ
z%Rh2)dlYcuK5y&zOVlw8(KJ3G^2}rqHZp7<h?ECqsDaHu#*yssi*#u?e)uk?<kVjL
z1<a>ep<k>-TmaEu=-2-dY3mtqowAB6PjT`uXJ`dKoU%99uP-a^z|x>H4W><xr}ObK
zGjJ0NSMU&jb?5$<i@-0wm?(D3B-wbXQmf!sqWzpB^aTe$;U{;4{~f>w&DBQA_z&gA
z)=uyQW_o@D*r?Bh?;{k6A>e0?fB)Y8_K>n4z61IBs(^}f0+%K*pHCJH+)WUAT_Z*}
z?&;EEz~7rJVIBnI@IzXT47f?f;{;1rSOx&w+59JGz6rMV1MuFwkr5xE!=yM4Gn#+m
zt==zNd&g1;Xj>_af^Wv*+#UYz+xqujggETam+*%M{W%;)Y1XzMBri`?K-+$A{}&t<
zovOwn$MlKn0M+E4f#3MNTa?ees~}Z#ydhtk6Bop7V0!r6mIH~RmInoPmhpTXAGEMI
znkj5M&0I0UF?@f|006+7^uUCotHB?Mi<r7O6;w|Cuhy0zhs>s@_(y<^N22vmR1E;=
z^Q8Q35(=~P{jrq%|Nn^Kc`??R!K)=Z1dop+5v21B&k&+6LE>PRMQGfp4&`l`<MhXI
z1MeTn%Ea8#h~5O=Nz77ZHxY)Z=Y<Wx@cv%e&OS-b%3~eLSyzG2tC76idprsp5l8?5
z4Z6yKL6^k#C#AA4lrS6R<O&9mf<8%yiJ`b8KZKzc9NTKd&t-A^wnq3vmeGb52lz`Z
znY45Wd?DJ93EW1iI$-DbTq9^Vakx0p#57Q^g@8MwzA75KI1kO9J9Fj@jju;AfWmN&
zxU6ttq3RoyzvRsofdzP}pd5mI@`eP|^4cgVHs^`rvIXI}c4(y8{C3*VrUuA;w*tVO
z#&}5N|2S{n9jbnIFPkK4xT_{ZiJZ?lXZ(}`aEL|07I^+{i0~7|TO0($VH(L&1m<G`
z-zFGK>9PC~#-^(8ClR1HPqwxh;Y(ai4jH)}tHyy>@j7mTZtyyB8vw_qhoif$O_B_v
z1MYzqr{Qi$;OO)P0$(h25Zf4p_(sPZ5jqGrS%s?>C5Cx3d{;DVcKRSIaF#V3hpS(@
zlSjc1b3M8sAon;zfXZWo?oTWLS9jxJ_ybxY8qc@wfe-+4WTwdHI`{hb_&x6?u*8(9
zl7LY~0IbLj;M#E&-X+emdI)Zjq6^OS2JNEcFWd226)bvA!hi-M0W(-)I)p*SOYe;m
zuy8Zr^#!sRRkwRym4*o-3#zVM7)Tb$QdUhR)M3D9f|qLYdvM7+QWs1DfIL}4M9>we
zlnFW0K)K3P2s{`D)1l`{vUDsgd9Z7D4o40{)t7>Pc*dw1_w?!VJ(xSSvhsVc1>@6;
ztm_c!ngffQjO`w6_Bka+$2w1cgWmFW%L*wKOTbY;-#40~zIjaF2lr0K^+0pa!H%2s
zMMsOgYVAweJ}-_wq(eI8HU4hA`~3RykJGHsepS7vWlFFh`*MUY2WnTm(2>3IQf?5u
z%2{eP5^QQ#N)KWpG6b=w8d*r>ic(mrV9Eh;P>=(F0025RL7L!d5Aj!ot{1aY9+vCo
zzZqeKJ>C^?-!bm+>0{%QQyxLvJsKEROUsr2lc^={Gf$tBH~iZTk<P9r$Ui9DDVURS
zAOHXV|Np~$Uu-uQbixB*_r=I%)aJ6!;<HAaO(r9Zgq^=Pf>&Ai2p+4_P%^X=($vTI
z2^c@Mz%2)H+|enn3V4dCrQoB`_Av->=%cYPhc%S4h4@ECfP*mFv7i7E3(==o^k+-{
z;qA}*KZ=g0Vf>$A%aaSxBP8SgZotB9J?F*FHa0##uuce-rI^ku#%FH{O2@j}50*?p
z;Km~j@=H9B^IM=Bt}4knSS+(c<+j5dr5BT&*v){a2=yMChUCP>g@+K@XJ6w01pUIV
zJG*#y`LN9Mh9zMTPZ@$%g;WU}9sisOvsMIso%x}#06pVI!1-aki&62F58B2g5^EXu
zDHI?0lUN6{|G<Uo?S4C8P@ipeIT`8z0fH8u6aJ{qNm(U}tsj<c+VWc*o#4lb$<xr+
z3-Mgu$1+)YD49tQ7qY4<6Ruez$9KyqjS%U;Bgy7b;$aIHU7dDQnM^w%>tlS_5<d&<
z1cOCs-;Sv0NdTLDIDD|qAa2h16lNdsQ4i&tFR7KeOyziAp6Gr%nMG_6K^W6I|MA{C
zlAQrH;(7jpn|zq$?yz+c;xh12;g|)6fXT4}?>&c%&<%tdxjOS6Mex0!x!E6~xTuRV
zGftiHTOu)b)WQSfym*-C!X71o$?jYsSwPi0@o<}y|0$C`$^1sne%a-*`DKa3Xd?2?
zhG)3GF3suWxwwnCn{i*i7sCi?==?<ijYhDQfB{)nzl6A~bW`e@TH<ptOwzv*o+7E>
zvzr(MA}0v=&Z9+^tb9y(3V|DRYu~uP@)O(lRwMa#{6`hxo!B0SPa9G5-a9G(3B$M<
zVZ1xx?pPss*!#=G<6&HEcm4Gz6F~=-8<?BT1;tgqNbipDBm6(eDjTW5DTZ~#jqb%s
zkMNE`0yxE{Fx1Wv=hNO>!~W<|Ir4ECA)XsAEaC%Jmo`MQsW^>%O%6JPVhU_z<(5P>
z4%Wkbx#5E@YOKNo<2wTgxKe<h(tG-K-Y<k~A3M1RMgO!Ni8IGupnn?%jf_G>*b+ya
zA!`T~%-q(<V<dc%{<$IKk1JM_aX%f+S>c@5^ii;IB0Hs!(&8;XFcj>_1R1}NZ<mcO
zxhRLT@0R%Ayd}391Wv;njT^-Axt-6<z#|d3f0oKIlf+5H^ZD77AR6YB%z`EiCE_4~
z;33JU`{)Xj4mJ60nJ4D)%$GH}R7CMO(ZfeFOK0QrMyRKS1cQ=GirHMS^~<J}ao!N&
z{t9)&sf33B8F6JT89EEbUyjFFByqge&j=hT40ow7iP~;XH=pl!_@0@3k!1s1RA^99
z+)7y}^`osa05f=}jMNeRvS+tt+5jJfE<2M!41j%9BgbVwMURdjkXr!hlaiVVkj4we
z?M4H@FQ@YI*xX<}<-B^E?mRN=3>)HXIKat6#s*%y)22=mvSGwra1ImZPE9!K4=*1R
zn&P}SYZZZ*Lc+LszCqXrqZk=0#s)!rWm#8b^c;BG9*y_HbN|CpVtDT!RSqnP7H4X(
zW;V~g^};-E(*`b3{;AC$O;{2%)qz@j;1A@hD)_lEl!iF|S$IpU>i#NiJ0@a*PtK)_
zz9O`DtAf`KPcm`0KZ&KfbyM{zgMtbKT8^d5!)@7<i?(eD8Tnp<l*yvF{K;E#{3T#-
z>I?|oR3HC54%o^5CP08GEb;ZPyTze^{~2u)cj$Kr)E^0jYTCoXaZFuuyYvrvCzXft
z^C3JRH5}puuYA5$$--N{Rp9Q*?szaYV=pI<5Pj7qNAUE^55!t2^fp(aU7NxYkRTju
z=NUqWkyLnE9G5FaC<PoioTDaCB|rvW521wka&uQz%S3{i<m33}em5DYj;s6GNMg83
zG!6rL?WVr2z(>B%HnmlC)M9wgMZ!54GC+;0*=`ZDyhtw&yRm=)V+1$uYQSH2hM@p;
z#q2X7P5gT2|15aJ;jkLz#}?^$uMQ+|b~F0qo8#1iH#CAJF@_+8e0NoV-$BET482g3
z0t7mOU%)RJ)kUf*OB*VIS!|Gas71jF@4t)jpuj`-#HAx)8}ZdJVmdNx00~TE06;DO
z;^Yx!8p^l~dKI6J>Kloa+Y`6E_b}8d^#C2=`MhQ|^6}|(V9%OFx!`_3BsNn#;xa=g
z3B$1t^fQQ@MqyHn6LL!4_)a~Z<SdzC^^`A(%*3nB^~o|42r;3<<)T4J0`Xmubl#Nc
zJWL$APdiU=3ERiEotBOP_^n`T<uVAgE<2<9feX;%uLxLp3tZDju1O)Ui<$2vG4Ydp
z*_axU1R?Jej%U~zjIib-hOq3IrMnm7S3i!>a0+`M#zVkZqYlawOZ$n<d)N2zHEaNl
z=|9iPgGz6o&4ethHiW!)hhpu69;tH#IySf7@NBKZyW06*z21}LtaK;B9MQ4JqD2S(
z4Lg;M&%|R>p5)2-wXcLVv;^Olc(J>sHsAJoRvkbt-Tb?e+5_9$CpDCq<9R5tnEwdq
z&=_K0=+N;3XW%xwcm{$WuiwYmSH6_8D=^$Rn5z>WUrLo7@SU^Eva9BeB<>DP#d)&E
zVF6DsPmae2BAIYPl39PaKo}dkm;G`0O3v`=?`Et6!4fYA58)##=qtGurh5dB>pFII
zPZ5$4>7!f;5BlKmzdQtT%{d^z&BxyrMryJlU;=YI8TICIpkKNkGlXm$UGcfIJDt4F
zXTx^e76buG>>A)=TBI*_Rb=?Rrjs&T-#;Z;P#3;@_(p*agNO)kucqH1m7&pL9&vm7
zE8@T6rJt2~RQN{~R>G<gEO)L6wsibp0wiq#p81;qovrvn`}BW+cSfpVzCBnj1=Wn~
zK?f<Fh>PeDYY?Escmw`IOPzxVN6nh}&?bIS-Lg1#GQd3enzYDaKnSX*lxFQ|bdqnz
z)&Vomg~A5l%Px1q6N(j&q#|l@14H6kY_J$S<caSWXKcSG<6s*7jr_)hkCsD7(p$^j
zGT}M8fe7>m(?1!aP~0ma`@O!{U?IMM^Y-ol0S|`Zpxh(l@uBcdj}>w&K$Dyb)n=`J
zaHYN~s*^RS3LvGCkcEq`zW2WOT;4bJ%fl-U`MJUXxj4Mh#z$Al#CUGbIiK)v!gt3;
zvxwo<tUo35h!2;N1H(CaeBJSL2pbKmq+q~(+n?VPWg*5<&|m&+-KGdW<A^Rh;XbT~
z#!gv2D#~F5=wc~mWpIu(GMWaC4Z*-BucPjB2p|gXYW%e^YgG69!|U^roXq}-bvKOT
z7+*;&<RAnWy&Sio)EJ&sMgP=L`x_a|55b)MvK2^}-oN}t<kULG{e$1GpYtO&YH;R6
zQ9nP#M#bl&W5WH@(fx9uNOQtyk3T$2M3xlT;W!a*@c(vh2oLcw5DPYp+-2XPU=A}l
zz<wyZ?>uE;ADTP+ZjTKiuu!}Ng3&Jdz8`-cMso!W@6@dS@qMQNGoRw?p%>YapQ8^a
zRB6wqw0*nrnvv!#J@g1ipgp_0=%dlw!w{K;n-tr)&l#D6kfy%yO|ixPJvM3CbRUFl
zD`+8T_viDQKM@VXD*NoK=8!Rt>G;15Ay|ZrHnfo)m`)xi1g!vR0#BRk@DBVFJ>M1P
z?q(jzA+GEM14!nV2-IK|2Bj$g2@Xnd5<Jdpiz?X$<NxuL*VXV%k_*fjvqcVhSkTHh
z!o{ZH6B(DjE6W2jlfmya^4WW|lPS3@q=N%oBjMRev4pG-LQ^~)IRXGD_^w=m5!OG*
z?qi|r-}7+x?a9aCt;@I4*hMl?0sYVV=F}r#;G6Kho)X64dQDRJLrREl<&dLsoFvvf
zxXOVXxHe7`nluu6vRr46F_sx~U<2v2xbojnDRXD}5%2ea2uY>z)Bkn_EqnZk_x#{M
zAMqRkquWP$kbeJ>wBQNqd>Ej%RqZ*xg^a)4J=>xqdSk_?{quH#x9mg|aP5{aC72cl
zua<ryFIR*ZNra~tZ-D|XwV)lRE#TslmIoA^x5Ekv9s~XN|Ik2x%k9L)(>TjxK5UR)
zFNfJ+k^TYZ?Lr2R%iyyar|Xm8P56>~+x{Xq8b%}Qv9r1k-_o15C2)e7cW8WDfiAm_
zTk7#}213=54u3c?hIbh+|C|4=07b06As@f$0*I8<;lzLC&4SDtK#*YQ$`0;4cDmr`
zR6x7L4cY(19{cnWctVdlR!d{>bP8jIGPp-Kfr^NeeT18=Nr^mW^4x!R@azzV4(WKy
zssRXba+)=3&!a>K{ll<PH3R|s=H7|$m5|Mj%!l6xJ<J%r6XwbwSurWNtJI)?S~bN)
zL$uHEglr%@rt&t|Q*j;hmGJalb3p@mc+7Nm2VpG3IWu4$&)SKsaqRz`K)BJuSvX6o
zd1RXJ9UcG0&ze03Jv-uZq9Kh5B8czfJYwK=60-+;k+qIm`dVbknK^0D<p2Cf8-8J=
zX5=fp%6R_>b)-s%6(MYSs>Ti=Y62Esi@S;q^JHcpw7g`n+Zh)q5d0V}gTN$I_&?|v
zQvf*mTgZIc1>HJ)Teph|UOT`DBl1naB`LB2tN<{LR@d_d`MznxCmBgcz~p!CQhT%?
z-xuIW>AyP@^)j*rGv}q@9|XCX0b7;>w6`OCh&w-Xf4AZ|N3Z`hi*wo!+Tg}ccK^b4
z<*3VNtI|vVn$7nJ2;w3t!UOd{gIn(U9-bq^OtRks>pe{y%jV~ZfX0}+DlIj~Uj)6+
zaDZPIggCAJ<Ezw>4SWrMi|`Te>iI$Gnd)$r^FDsK_y8SQdderR1Fm)K(Lej%GPf@N
zJxl=P;Rg*cWj&^=Z!x^O%l<PS1SMJyDx-q3u)k;g9qQ!t_x^$W0o+Ll529FT&$=J^
z{whNpcwmJ1zeRHo#S64Q7yM@q(DBMJVcDc@%S7ESWSA)QHSLtvhr3D1j!fe7aLvPk
zE+-vXNX-p!rvxn+4uN&~lZ~w3@Y)(og!1>4C{}fY;JEVcX5(WpeZq7GT$u?DV=?QG
zuyth{6TI+m@i(QBdl{8PyqN@MLp?Vb_=}!rfrW56n*i+o7sT652KhUax?^JtlZ)!g
zk&pf&K)`xgpWWvE%+bl;gg0ThM~9{&K==L{ZwG(?e3B2D+hupS3{QPLUJ#~DM(z>c
zY2r~s1dk&$Kdik+1SYsgzzi=b@punjlySIE|L-IKD@Nr;(fj=X7d)rDht!T#lo#ZS
zZQ7Fifrs}1IORQ%e|xX*@~Hoq@zjR6DDd<27O>EQJhlg<)8Dx_!B2rBCT=2tk+qvs
z1zx52=E(d1k9-MrZ5!NwLo5Z`;&+h3fA4-H!V=*LxjWcSaokVfsw>#rO@e;PI}!@B
zzt!|UphiBx_Qmqw1sII8zt!@a+5%?jr=7{v`n1V%Og>HyuvBQ%;v8)M@Q25PNCGrP
z#Bt7>b<gk$Zof@E^}ZZtrinf0hgx!ISRL=@#QKj3SD-=bjm?182YZVv{7)OX<DdkU
zD`L55&wJ$ZZ-nfhYLUAaTxF-ht}-gYh3iLWW@+Ji8@O>=OXBdIm<ZROqZ_*cK^c%G
z2mQ-E66U8?NAF{u50*QQjfdps$+;}DthlL*K;o0`%!{FVT*3mQ@o@4X^b4d(uPFba
zOy7*HTzcf6<$u7YG?o4|wKpVvdyl{s-1G<dymbzs1aIkE_5K{!;4EQBwSd2ND(U;;
zf4jkeZra3}f2fDmM^awE_(SIK6ME0xcp%3|2qZH#6FV9*9ULMxObLY>wAdQlgO2{=
z{^#cyM#$pCTms%o*@$uThLtSA_>A~MCz7mqkeQoQo<9ggZ$_K%m)pifZ^pF*o<<pg
zI)X3f{Npe^%s6&Dzs&iiu097VEP$Or7@F!g>=&$_wTbz@8BaT-w+LrHtq7WeEg(M&
z!Fp@$HNUIN_&%KG(jWf6!W?%_h6#4=z`5b_P8lCI8`|XP2$NhTl|hWv4PCLxelxr;
zIPgWwIV)c`cMEWxl&8nWLjnZ{8@PTGw4b&zm?sykZdlN4Tv{lv^GFB+2-`L?G2&y(
z<gA%FyaaW))ZRPP0JSaYxPSTpD_^a{|JHqf^soBY`+wR?{ssU$PnEg-i@m?;5&!K!
z-b&vAu51vuR{~tkDIa;4f}Uvtwg^BAJuo`V_;=ub9nSI*)pcz8{tP-SSd7sk4bQjY
z_<9@ekQBOLba&AH3GIP@Ktubh-b4M~!2Rl8Tj`tA@ZSzti{H2zzg|8zm+<_{TznBV
zcQn!e{DTeCX+Qrj2Re7ApZ?dtvz>RezxCj|r)?U4{y_S3n@E4bcw`&2*Y{pu#ul4U
z_|5)E^{QeVBl#>MrIJ2L4jvWpaoe=JQSp-`M)<E7JY2<n&Ko?Mm+=<NXWD-gqK;?U
za7oQL(Xa9K8YD0`kXA>2YsGQfG?EyX5|Yuw5|7YN@fhinP9gE4KOJUF+86{SzL|pp
zsDo_0eMm9VvSyTYVB$G6PhIDIKMC1ZRyIcBxaIWYw0zNkf;dHB%}d10ASqU0I|$I1
zi)ydtq7KhMnSxXYqx3(Cg?c6Jl~Ly#)mjO>IXLdvC(yp|0gL>vnzlM;e<hM+&vFp@
zux4n4R##vk-T)wNZzMNG#(*2HYzbOmLx3e|feusO2gA4$Jk7>HA!>hcU%+71{{P&A
z`enz3|2Fu^<~~TAxMCxldz**6%K7-Lh<ERgwD1fy)??xE;)%<D8bQA-AuiY-yuM%e
zPzX8QxASu2;jq)@g!jZ>N_Z{J9_5qs?1LjDF*iEDyL@p?mOyOj(DH)>2gx#sbEk}z
zMGlDXg4{=l&lc-Y-`k#iW^g7Q@k0XQFT(x!tHYbMxtjzhh3BAu<-&wmFO388To7>W
zV2%@_!?oMV0C&kDXV)c#Kdwwf$MA&m&LbQ)b-URH23}4Lw_GFP`EYn8@akiT6qa25
zGtZ!2GT7+IH*BAgntk6I7<L8&;_A*HqB1~%?n3^2c0d4C#<GE5d~6rrnuY`TPDQc^
zmRn1kq9*vw9L%NwaniPrzX5OEpmX^oed~Y@I*ZMT-uM9JUUuR)_koA^tZ7Li1|Q9Y
z-5`~lu(wOChpoIjfeYHsfD!Jn|M^BY`aUfAe-_%q{M+Lvh;uYfOd;YUxc_PH1YWj%
z=h9(`i8jq8+GHIZzvZEOA=U>(XW)($U*J@3?R<a#!WunnzeM|U!A_k%X#enIyGbSC
zX~^`%93M~glK>Q2^<@kF^ZaGf72<lVm083{dKvlGdEri!Yk>fNjNqvsE*nEU>Nriw
zMvvPWh|k=Cn74e=K&L2xfz5o_Za)(KOPn`si7|QUgkQTm?aA4TirMDS93xPz-ZDcL
zBNJS05w#26dq_>;klJTfdVTFSbPt+{f}}?U;TsEVXBku~U>qBZHX#>u0wT>3&Ek{>
z8{7b`K24$V#Mm-H;6*NH`4Rta4ijJh@BszsThcrf_yt;+zJm5#pYRcRU~lMekKyLm
z+CDi<2f`A0@PVcMg+Kn9dTH?<BN6zHBuB>7v`84owsmkPeU5y6Ns(4>X{(n+O9bl=
zFv89}B;hyz@C>%LT4Ue-Nt)}U15G>jk^kv<FH26gPoCZ<!qRQufG#ImnNYs{=8fHe
zIqG^tncga>&z!7NHzvwW;w0`jw&sArA2svemem3nMPyJ(%|Se)tG!xF$5Gh;3U1YT
zr}P~uHgP|?23US^qWp*toPZjoW<YNE4RBe?%m}anfxfo?!F+H)O}qQz*42UcSlDNe
z{*MKwjl@P`DkMjU_<xK-d!q=g((FSDq7z>ti=A5I_;{)5i3ihl7B9d*wOJKcc#Q3m
zey!YpfUb)~LBn+M^8f&HpN}SQT!uVb^GcN!m%lt$6(k$$B9Ao5PZS4&u1N+)Wq){4
z@8Rr3oZAE+h|3N5y?|jCeB>I^z}SeF#JH-4r0xNa;+FI`_K^z{$cf+ppfRPDQsz8P
z!`ws1qFAxugZZ#AOqhWBtJ3F*fSJ2L8x!tA5b~^cZ2a>d$q*tH_sfJ#UuE$D0M$sM
zV7452--mCm`gkLNV)o8yfcE;({Ckfk7f+^SfBb*K7RK!Th4?E<i{wWCx!}ltb?N{4
zuA!#z396H#clX45sUi4BnkCVs4N~u1ubBw&r0gKP9~r>cpm&_O&Q{QZd&4ktTn&SP
zp^5gmyy6C&bi*tw&4v<iz?T&%`XZRj`vL?U)1jC#WEJJ-^~Pg{#TI1An|AMiT`rD>
zo1o2@Kdo2-e3u$Y7Agb$A!vZZ2x*`2#5A2)<iZ;0-ZnYk9pD4)^{mqS&?(%0;uGJ4
zylSeo`{Crg+)I5xM#|iO)%30+P`E9Cd+eS%2pOi+<KTvx@Ip$qi%Ecy7?7v`{x`!o
zuQV4Ylh*~`1kTgqHnLz5_62yrua-TpV7UGxG6K&Vb(9>OVc+GXf8pV4oODNCq(8s$
z-kj8UO1!UL5VlPL3)E^m@1X4B2u8zDH6?BwPaT{=9;sl;E5Ql>$})WiT$00uxUN<t
zf;$*B;Vg<Le;yb<_j^A#L}OkfXm2?5kz!}UbO<FK0_%;OufQUE`&Zhy(=PnSiuh$v
z(kyTd+d<GC#5+)OuM-LNOWOYQ9F{|(V+K-Icz-v63#LEJdyD`9_#<9NGI*X(H;9Hd
z6aW9hM>gU<BgddTL&eNEzBKgz>**!<FySj)l1>_OdjB7|u^$BeWD*WskW+d5#72A5
zeK*Ui+?E47^}GJ_{8zv~b3P+IL>$)1JxtBrAAiSpYX#RgGo1fflQ0XNvCA6u?_8cW
z82C>!GbQKYUTE+lDQs)Gx@wp#=9Tq}<0E5}6v3ogaZEtR=#%&b_Wxs<B&hb!))+mH
z1n)$=*A?X$Rpwzew!G7Xz8S<~SK@qTlu0ak*A2M!J!|!?{>x=SPw<sZ$N%C!Cu%P5
zqJ)kUs*?+XXp5H8P2OD0OnHF)HjwA#3+D5_FSbO5IRD+E!09saerz{kMSLepwzUcJ
z?urVzX=X^cLU>6BnT?fMd9fJBspad<n2tNZH*V|`t0cF}{>D#C$b0i{T?NN@X(kQd
z)BVBt1L~figJLm!+fd3a4-uXG2@e<&TZ`@Bc{Kjr;tk>HH~9T6Z}6GP<7?q5VOZ86
zeu+%{0axDKd+Ty?#^#y$oN(gB2O~2wUTZ{_UJ$0nX+9A3J<HVBiOe(Kmx4Y?kutXV
zaP4l@B;qw$H~Ds?g66>!#|RTVxj}jZdEboVSb*`O&fv8lqWk=WOc#|mM-V3Ix&rPq
z(#VjnR?#u6K%E6KfU(gv^6-y>ErIUxAGSgGL0V#BdcXLLIJ3H1f#AS@#8@%ry~IhG
zd9=upKm>er(D}gxJv~ei@c6?0%T<N(5u)KwKE9rPANN4RN#}ROVcfT6I^!ubGKUBY
z9myl0<@jzcMqzdT@Rg0fe}uB%I~4pyO_`|d{mqNc_+7&)Woz>>GalLh0u6}#KrEuI
zN7xWzB^`M3VF`hhwTKln<>%ym?m}I?S9h(M7$oqGH~w3&5YZcsd3a_6jq>?oZWGPz
zjHWw-4qMo6`24KSr4HrgVnEzyd6?HXEQbUS!c!SDEv&drYrZZ>eH!@8Yar|ZReWAH
z8*t;dpnX>*&RAd{;nYd~JHxEra6v%bj1|U>njhd-!~$+(Zmz5t3f+>-2e0Ik*T2o-
zr8C6BM-N4=6Pi_L^@b~ia7^&afQ7a!b8I*gHx6hedaBP4i2U4|8BbE>@az}~aD;qh
z@wwX2aC)<jg(Di_7;@KU1Art4$N7I-RwnoFi<W~e9i$iDB1}ZMIM4jKyxf?BV}Sqs
zzCQ@~kWZ2I@&$|ZmPeM!G8c`%iGDV^M0xd=o9}%7|Lf2|i@-6Wr*g$$iCFMOe~G7y
zlVZ#+OYqaPyZYtxbMZSG%$2MYb9QC0*Eei>b@EwN2jLtiVJ#lUGY5xNU{S)Is+{qh
zg1E$F3cT4oMqe92sDK<eiND84FxN-tdrV3&eUdipc6hsTyumI4{laGu`T_vMFMLF}
zfij_h+Z^N(_shgvz^<?S>+zUz7vN?OXkVZ60w%q3`cGLzNAhC$zLHu=c>PiDtN;Pb
zSU<%|p^PM!OACtB@J{;iE02GO7pbkIXX0^@FDhmbX07}-Al8d)3-a(muGujUGclBc
zVg&hr4Jnhq%ZF){w8G*%K{Sce{t9{sW^FVao(}nsIp9i5#F6*mT-ymF#48Xc8Rqek
za3Z;|`WL9uX52dm#p63LYD6kS=_b5-hxoc)nnV@~X(;u;0aD55TnFASt60GLO<AfH
zGhpY7jb*K%LVsh8nR5=oCpOVh#BLMr(;6JC8<v|#+`N4~%X~4pj;0@4JOAMbzt@_%
zO}d+dapVmzb@kwY|H3#g%_W0C;3VQG>8?kH3aS&R&`ZaNipiZo=tpG9-|$bdO2n*6
z!f80KETCTR<Za2EMt{T!wG^IFgAb{i;<g3@9$EB(z7TH^GCZG)x@UW9>FCEqC;V3=
z<6_{fUEq^pi9&9N8o5<-`=K;EoK9uWKPvOT!r7x9QqwN;b@M`3%fU4c2i-L^)YE2n
z_?b|W(-1x5!XuQKgM`B=GY24qQfKD2IV{M(6I&m7SX{7&Zc1!9PvH(aG1JC{I~^__
zLbSG0<>&HqaiNETUQEx8+M~$=27V%R2K*N@=s0nI_abZz+jReutN<c|Pxy_+X8=5g
z*c#IQPEKYB^}<oAEfEp&Xuu$Oc#PP<=u8Qxo0q9gd9|;Mh2jDr-jxI2C*1<@aR}s0
zfvBu1E0rd2SLr_$;&D*ZQ#IsnE&lL`BGB&XIWe~;NZyKgZiNUp^ItqKpYb(_AK|$P
zm7L)QJ3{rThlmrlVXZsQi2LId*DT69JGM?ED*64DcY_i@%><Db2)deWV>|pz93~M7
zk^&cqC?Xx#oFjx#iTU7VQ6+b-=J@2jaD>WWpTo^u48^8C&fwelOM*J#S?E!Lm-s`+
zCt*Yq;qSFvl?jHshosb=CTE=}<U|f6cU;*NMvy+|_Mn~w4M2f6myYDvLG4ZiPHkgC
z7sTj{m+$q-9ymIBFB8V&Hz9dN4aQ{(N2E^)cW?J*Y5;|JOxYe069hkHU%{V9I|XK8
zT4g3jKh1)+nahb2;6AYlk+*|K#emK=`{(K3;b}rJ;<15)f_<N!CVZWX?4|X^U7?sw
zonS|SyPww;lW3s_5AuY3o;*e(`;<2f_1fZe>C>k19~}$6Dz;u#Y>KUx+=Sh{4N6T|
z@e-?KRcySf*%eza@$#<7b>%!7wnbmw1l>aH`8g-Y!yXv$$B6MFXY&OkVgvpW72z*S
zM-Iu4c^VaXKa-L~X^^d68t{d%xcxyFnb(R2h#}?fzX<T|=Uo{cy#JCVKjW>+p(Dq!
z*9e^)mUqO*alHmKID6)|wh4~4!9FPB5P%|D7BNOEEKkB9KylDOcCiTYR5<KrON=IK
z_q)s133!-$_k3SL!_H=^C7G)pYZ4|gkDn(D$-~=Exp^;t1T6u%%uA_$3u8X3^y8<W
zFArHiByLsmao!q4kdYE+@sJ_zm2%^ua-yC{<FEeiJMQ^2?1BUCPv!11(R`duafUC3
zJJ>yXWIodqzrj5<Gfhm_CUn%zncqL3@gS2<2wqRq*A<9DdIG;9Thm9XjO22q<a_n~
z%io$FOk!|@-@U|1pYl-9<W2CMhYa1!2^`2^r~E001)%8*WsZMwMk^KF-|&|-%*K-+
zh_J_oTMl!=P7==h9CIT=1>$G=Q0$@Fai~}#u@}V1O{R!Vta;bRIUDJ!G(?vKctMH(
zAdd?4o?Z&E1nLJ>_|QOzVS?!<?tEMbcNybgUv^22dg1uLNSTZ^i_4bM$-;Ie6gXf}
z&rvat@p6nqxo=iVd3h+8i?qRzgQ#v8PvJgs1ZW^m5ioH$i8v&d^<(DpTIQU5VXybY
z@Bu*m#-i`xi5KO^nFi#?_^3MRGdC!jVhus>{O_O7{8q3-UJ4qfMe<tL6;4mtP)EY9
z@+-sL*asI%_WHK5AH`76<Yi#ngRUoy+}!jR?u$}#RsR#u3bM(FABa?BKgj>UH|p(#
z1Ib$Fjx=_FtDd+|A?7`03X%!MlTBEJ%Lr?`_ctZ)c#09?KM@hl9uENjh<8t&bNT-e
z5~O#G-TgQrQ(i`aE;GR+*@}y@L)|((1{gRGWoAo!MC0;KuD@T!@#Lr$I~6LhA9DF3
z5aOdopJh&(=EE@%tH&RV$AAEvT{>@pE5E!_fxIvtvCymIArrXm$TFQUlF(Zq_%H)2
zO35#NAOHt6;nEyP$7G#QQrZJ{7ZtoNn6>k1;(7SYL`+DJ6Q9rgPBtJWGmnTS`Bxo*
zcgY|803udogQ#KrjSRq_r%{A741v%UdB8Ah)IE>zjv}2jfdq}Q&rtsZ1_HcyoA+_m
zoZ~?K@2kE{Y-pnV*6Fqxh`}!(jEw#T4B3wW0OW_|mXu5eSd5%AT@sl*bocL*OyBcs
zMdLGK3{^!55b8fG+{d~&Yf%}AvDhi`-x`b}K_;^<!3MeZb{&aA!*&ogKd<-qnf@jK
z&sP$q;lN~BY8?0CqoaU6REaiROg@l0M40pWSTsf!_r+thnK^b7!-*_wioq4bs~|5Q
zIYb<U7&`r=z0eMq87AN3`my>5d<q0H3`EAChOQhvf7~T{`{}rV?+?voo&@H`BR`kM
z2S&l?5seLfr|7<04z53wnU9aa6V!95lX5dRU7rrUEQrru4(_vDU)$bS+|uj{d*uBj
zxGKOyyO!UNybc@Ct%sb%e#JEA!2HL9J+b{`ONKa%Gr>+7?_rHFQ<2}+m;5H=O74*i
z%nR0fO5?l$b6%&KPyprL*~pFmXG(Bnq`mjSx~o5gd;P!*belov-io%%gsSdH9SflA
ziL%}`IoElVo7&+%JA2D5^G(m$HR3TaUEFlxz$O_x#s*CSFA2xj{AkEmH!MC8@xgZ;
zkZ-PHDakgW*d<K9{wMH<xjkFG<JOTJ!xZj>0@O!Bi}(mvYiM`>{2^-Bubw8SF;wss
zZvwFazooA_cIWSV`7p<b@g5L~#76Lqj3?o2fVZkm53J)zz<*@M?~!`&zumq6k9dC-
z;4S;K4M^TVZeR)P;0LSiNfLU!?iEU-c!YcG2Cwfa#d^G7COLD1zG|TDjpXsFc-Zl^
zfB+DuiF@YF0&JEr8jQ11fd?Rff;O4e{q;aIRh@s~3dwyP!Ul0`LXN0(^lO9h{3q*W
zV*jp;%<H81ci*ButHvhnr|WK(U_yX%-#I_uWLxXud|KES%RUaY9}>O=_IMLFSa5v4
zzZxajx0jOk1P@z(&7OQA5zQHB`owsT5s1x5kHlg!;)(b}=EIA%5Ve8+jPSNY*cYe{
zqV8XIP#eem3;w=38afVdKk?oG!ZkBb?noA79&k6sB^7TU3c=5t$b+}A3Ne1jIb0vV
z9Kks#BKj{ZY;iW6D~N)g6S9y+%44}Xc^~q~l`9Be2;>rBsTV5TA!6~P;0eCa55z(}
z2cDMza4Y8)g=muuG@cQds4JX?(68P+Oa2MGd%#7(p66`8M~=`zq#ToM4~IyFAjg_$
zKBoTeM9;u4_(IoiKy7adjZY>a74+cxKnOarM3<ODG#>alJH3*B{9ixt_rM%~*cz0@
zexE<!?T%~W^{nG9&jKdBhxgQwJZxAQ*pG%dM?NBaAukU2CD`HuN3cJ5>2<@2>Vdsy
z$kT;c?mTatFlf2|gm4RO!9mq6=SBZrz!@G*q4AgieYr2$KbwK&t@23^jNk9CZ~C;C
zd&8fWh;HWvTwSByag8XhZV@`byk99qw2X7b^9Bl8rSkNMEPf_<Q8I>gOk?=yCV6-)
zq`*0POx;E9jFSXM*SORIubT+4I*23<dE>G0LxfHTpOC4o!0SKwP9L_os4rZd%%AEE
z{<>%9h%BZ;0{rt+hfDrg2dgVkgO{HOR|kW?wvqRx!E_>6bY&I=mSDVqJGKZ<1nXc)
z!ay5{pPMH%GVqmw0LEA%z*fNt@X`t(2wt=8`1Q?z51Y`fy`Qas2#e}wkN--3)RaCB
z@i5H0g7VMN2lucCx>cBiyjBMo%B}z5{1Q-4GE6>RHW~*v6&?^cRiVZVaMvd)CkS^K
zZ)hMaBlyhsvwk+$(>?ws=<&9+7Zc4l{#a&exDW^Xlpy606o+zOOh+HA%e>Iz?=_X5
zEe^&0=-ZEGxw!Zt+YcY`c24bU`=(xF&r^)vWuIs_d>EPa+juWdec3-Z{IHF6%|)IH
zbv<@ovwrLkqt^+;;DQstb+ZH@7knO(A}@{t{oR4-(9n)=7s6NsZC1N*Xh8|#y?QHP
zgaPkX%g*)9fEgdF*T29-{{iWU7`$>YaC-6B2<zh(05UCC%C(Zb|B)Y>8@`f0s4#DF
zS?`dK%ouWV@aooUi_xnC*@Az84t!UKX_m8Z-S-P(Li7G$#ykKTJSKxF)Ok3rnPRXx
zgb<*<(6<cijR;CSd+Gfjo0A?v{2^dqP|+ZpIjt$SxS0~q9MIPnK(O2}LzX>+elz5}
zu>rJC=*$4n_mo4P>db6GLMPjpK9_+3^2s;Z|CSMb-(ULP6LR&${ci?UebM;1dJ!%9
zL~nuUa~~^!)AqpYU#aj;*b^z+;iqBs$9u~lY|KA4crpO*?!AA=u{f+n3|sh*f=uH;
zNY-z~{27a%4)_ULurt62_t<~gM$O&#;J&^Qa6>D;)As!7lk1xVKVGH)WqQ8F5~rU+
zyz$(6KyeeWAqR;JfQ0@5!ES{muUYr|frl?O5zy<5fu3&{gl=4_(eV7qf&K%{_#j{w
z!2BUf{lpDnmf-<>d<b;blfwaA*#ZF`ZNmJRG9|a=q+|Fm<(Y|;eePIh;VkB+ojQIK
zjjrwGY8v9Z83F*blIwz8>)-I4B4Mz$5y2a9!e5|C;s2|F_?sxrL4-KDRuOk>H%EWQ
zd>*{JS`jnj6FX3hctjgswg3GBF7Ec1{?wWIm2%UDf6E7tGJA-9SD9Ms`?y`j!mJ;>
zv2d?4@4xfyyO<u~Or!h6erQme@EN!$|HJ-M-LDaUfK1mk_tW@U=yfnNT+H<s*LLcM
z;+c-*@CY9K|G@;;|NJ`Q@L4DTI0+lGc~Igh;4$f#6u!_ADwrSJ7s{X8;FiGvBmG&H
z>W&+$&+JS4E1LixewVzT%>We{Ryu>>{I?pas{Qwlz(i-s00h?QJwNqLZle1bQsej0
zKJYXiTl$hi{{s&AtZ*Okz?HdfzxW`RAWiCe$BZMRm@pwh6JEXRiDb{S6@v~kum}EI
zVKQfPiE~);XM!v@2cTE)h?{UoH$jC4q~Ka)=Ho{CF_9R)YAMZ0$J;TVO|u9M1E{_u
z9h~Y$P3?adU?iC{$IB}U#A128+}zo}<1`RQf|Gb6^E&H7Tua=DX?lZxJ0l45`?L9X
zD5?SYnZpAN^7aG-dSCJRn3<lAfgxIqf5u>$pgkaZ051sS!a6^`8`T4s5db)2EAez}
zq1)_aXMmA(4RIZW2accxt4~@X^?9sjk@|Qk)3*~x{CGq04%WyHxp|4I+&*!F(7a*s
z$A43EI(~RBr*0;{=raw@A>F6MKp6G*{(?_T`*-~>bnuJ2JBW0~Dd7$TRj)mdY5lrP
zY|T%|iq8CA6N`Z_FKrvdVtKqcgX`e04WPUa1p5PTXZ$1h;27Vjul{FoF?b{SxJ`XN
zydSh`8x`jN5rPM=xFgy1NGtPT5B*I0b4L6R{}21&9{?!nJ?KNK0zLEa0;-IF)MYJy
z$rAd(?vc1aZQR(@pICqH2nT@yLiy-H>vg}|^pZdOL6?e#5d~%p2vU*J#9oeuV86q;
z1lv>Vqk50<^u2vUiD>v5etr?dep61#NDu@!4G1S{zWI^bc-#H_Wnjgi9{Amg;W5Hi
z6TnKthU5TzCeIO<mygA8a4p2zJSoi0j6Dz{Kbsp9O%NA>{olpH7pVJVci&xaF8(Hz
zsUa@?Vc+^9fB<}d5N-q5##{j5NP(b+k-35ffcK~P%z$UCb=~|1ekabPbnpbohRA#8
z-@YU8kAQvF(}0^gGxQmm?+hdN32>xg6dWgy!t(|XoFhIetx(yn6QMH~vcr6=WL#^;
z5BN%90Y%rl;~)i16j~7DbAkP@jwg%TRJr-^zKx;84fBP4rjYP_h5y^$QK|3vxLDDr
z#EpR;*L9bUsd7g4Z-U)NCgR-zmAdUw@<ZwBGvdmBg>gg62%Y{<VgKsinM#H8YkndM
zFpE#FoS*0K#6`n04NGf1t{98pIJl+04ec0WUbUg5yxhb<btf(0qBai!$AXz<irYqo
zmT3jJnS3F44T*w?z<8!Y`SjE0_`V~C=ZPbJd2GSpTKLa%kWZcQd;ntq*Uh{O?uvUa
z_V57#`o0_%Hw*gD<mYR7NZ!DHJAfERl-xcA?n?8?_s#$qN3A2*pmA~S(4TC4RZqa+
zTlz^o>>vH(8mimj{G3l4lZ5kE&7JY%%kH|9ip@#iW10RD%F4BT|2O<(kEV70e07H*
zT~|4<V6cM7RMcYp{lZohrW0l}8M&#&yWpcksvYoGFP0;DB?v7#UJ#%-?AFkNR8xa-
z>3iaHGaLje4QMJ8a7V=XA9Dr=e4aXPH#V>mcHlSnZ;tR7^eZrhhra*78a+{$o(v1&
z9|%~ye!yW12S$K_`d)X>8@yos%orL~-FLx7aFv6W2VzcBIm7$zR5CX$!wbCsHW4`3
zW2CKwd__iqpobv*13P1tVaEr!U_ZI(-vt{1u)}M)0#=|i=fGNo0pR#c;m21J551e^
z5K15_L~rxQ!Q=Bs!gt_Xsiu(UR9fy&jRCpiA*Tf!xa7XBs^1>}i-`=79t48g_31YE
z{NE^k0w3)s|DPmnBSF}ScxJVB-`&BPUHebxSe|Z4fHMkSWcTZMyaapaLlC`W;uDOK
zBzzB2UeUI2q0h)c$IcJ@cL5Vk8lD>)9b`1X2CpRC4hwm2$qyR^N+8b|pMTxOx5*pX
zgZkixr%B;28OxU7*3%6pipmz4j!s;N;V8F5%$1h;CO@a;r%8q6u--!-7eO^LEb@)y
zybwl$1K^G$d`v}82$-6AA}5N4bg<tPj1CIEY{A#R!afMv7pU3k&;`OAHr}I7rTFMY
zoXY_I#xh!&$}XTo{qt*I6A#dhsV>pdGtkM2!?ebVP@gtn01B=RK06HZ1l+uD37j&#
z#)VQYp}j8<9u`g!$Tq_>!Fk8$O~qBLa$NZ%Km~t{nc%$l%|ZeEcw7x_vIy{hq6FKP
zel9`}4^S09{6r(c{z)CD#Lbj$fUd$cpAq)EtjmAK0i-C4|3R{;`d{b&kFc+B2m)sz
zR!tbO)TjZjZLh^Xr{W<FY|D{8y_vhIbQ9DMUoHMF7^@kYL0X<~HP=*QZbI+H_)hrd
z1P22bA3$+Aqs8+q4=Og}WH5EgSRFK_yk7@grGdq&TL%+LSR56}EreqDI4d-;7kx;1
zvg*cTu`p2$MbaTRF73_uBU+zEDjA#a@Q)1s2<UYU;0`S*U>=@=tmE?qB&opv;y89*
z+)MCKHMGB;fI`Uh;sI5Bg%NTO#6xL&<i7(8+sLoo{um7^q40lPPiTy>!WtZ_(<J7S
zEUd}N85x=-pfdAkgr-T{fd<(G53IgAK!7YN<DiJ=jYRO4_me*@g>1+Cl3}NT3y8#D
zhi!i9`oH2boRtt?PpjYjxb@4DlZe9Y6SBH8>Zd`%w*v9<nXSf*C)REh{?QyqPSL-K
znoj-OUGsRZO_L{Fxgq&<jW5Mm?YkReILpFtq;^p7)vY9SMByq#PJ*V1KYa3t=F@I3
zl5<F?FoZ@5xFqO;27j!+ZW=-iNYsRJbQ28_AZ!Vp%$ziJ#N=hRs6&H6ktuta)#v5D
zcoU1>R!tNeVfdMmTB9JE!WYd%@)-H3syr}!UtBI|JSJdCR(@_~Psz)}X(-n<ozemi
zHltV(wVHK!DaOJB4f^%h1aDEjudljmuK(fjRih5GJR7btnDP%3*w^K;ninRz_shB?
z1m6iwg@M8V<`5CVlsK}#!Zjf0xk?;(5Wy}ED*&fJx<~cIX~_)!Zv1*X!gLYLX>rqQ
z=FwE#C#;GdopW^ro*j00ta4ga;V&;Q6~TQ{D?m<b`0pA71vS?)R0OS0|KTaKIgvX?
zh^KlmIzk-kI1%`)?6J|Yoty~V*lH|6;e&ePe0Er{C6Gv<hVSOTwtBx@7FaVD51k0J
zD=sOdG&;K|vOfjt;mw9Tre<|D;mEfS`0S8CK%>#MG2?Z6<^hkXoqZPUehP4pZpnjh
zh4kFAVTe~RBE(t<j_~=sd3+;L(Flp`Y}_WpeHTN*IMBv6GpQLc>Kb%i$S*(r>~8<y
z2Dv7Zb_OGepoYXHaN+6KUHjNc9v)2JH*@FlcGu>Ij_OepgdJFDfaZaREx2glvVV-#
zwjzlhaXV7Y@4_w=5Eszyj7K!eT+IGT40!Wcnem?ZV^N2jMhXOQgEI>1|GkFryMz8~
z#*Mh{6wQ&qI0C8bxWvu%pK~ymf6tgZFIC2CSV+O$K@NRChhe1z-aqp9Wd;HJ;-W{P
z{Y~|4Z#%;IGskaI7=+wBM*<JQxMk~;R4%#rLzN3?ENW>gfB~}bNvj439v`!?__>M@
zVd44#29VMCt~@jIFp7xd^{8gF5o_)6?|mi`VqeK5z=7y~8HVC{=n~`YWE#g!8;;oL
z<e8VCFBfILSl2BPSfGI{op(4}|NH-gAk@~r?Y-LCn+mZ<t+o^`HA+!?RuB?9)F@he
zm6i@$6}5>~v(?%&_D)cONPhWzuiyDI=XK?}&PmR>&bjaV@q7@4TZ2>%g^bTX^sPAt
z7fd6!r-B4{Z?!JdOv2{-Lw@$1Kxx}~<gv4L<+1O`$DcKWc+0RS{Q%0g&Rdl{e0_LQ
z8oGn^KKn)O*U59`RaM9%ZnIux=_26zI2Jam!~Wa3C%8I^#w=mrJ;M{1VakHZBamNV
zm904_(3o*^UM}{wH$lG3`43I3ig!m%?0n#u-=dT)Uc0kLMSILI1U02}7+ZPE5hEZW
zmF^T={BOYY`-Mn~^zpIrW=Z_+&~v$f`Lx6ZbESvuuKY!6+7EN%y<?m{gY*3py@UuX
zwOfUE0;s?vhg=Qum2FPsyh67|$8X<VF9H>*WxqkG)VG=Q0f2MDcEuf=7Gkj~`YetF
zhCoMK-S)GeSsyHONAj<xL911U_Y#YN3*lNT(ICaj{T@|m!pV0k4>&1eNE&PBrtWei
zAvT%@y7kj^C}nX2{n?^AJyfYi6e?0v-sTcp9tFH5RCd#xjYglgE`hq-Kl|O9^Vi`C
zL0Wuke>`7?i6^XHUXR*ND486U$n?k$Wz1aV_1mtPm|X9$;v1LP<3=@nJ86PleYyD+
zr}+a-lCaU8sY6cXUgkg#_^n~%rjLjj9%sz^mkSI0$K3s2ujK~w=%jam^S58syUw^n
z4JM}#eh_wYvad=t{M*v9EVok(M^|c|1BSZ+%`&m357;1(_j<MdB~YG6ZeNhms=qg{
zVY89+SHtJ1N6ZklGn<{lxynfrM9G#-qxH9%WtNl2ifglW*1CtK1NnW)pDbUc(ljtw
zLEA3Vzm6tQJo8(6D9qJH9vxty1G{<d^Y_>y)m3}p+ru*Tlb2)7LYrCKzDj{2^tm#U
zeg0rp4dAg{axqIo<F;eX4@)k$Lw~Xb`QfmEIAz>sF)=Y}SAcVvNbDr(CcN8j0Z5zW
z$2*!|AJ}%?u1H=^4VMniYpVx*pNqco`1w_Px$h)?bYobe_Na5|*275U2|m8R-~Yn@
zXe>Xiq1*i?2>^Vh>-oC-jbx7KnAf3mznsT?qo76HF1z9JO|n0ULak?Fd?%%;$!o!T
zBVXwPpC1x#``uT)Y9VWJv}<Xxt|_}Ik|cw$H4ypf<Gr-l6rSA_BIeYT-5EYLGu!EU
zP*qSkf5Bia@eiDme|AV;kaG2kWM`N^yF92)^(m$q|Gl#v)G}|Ys>a1&0q6Hx913Xi
zT5cR7eN$#rcwpp7XoKIv!t%GJg{9?&K<DuA$k8jR(fN7$`H-W<#@eN&1&YYY%txRy
zr>~CzQ(gaeF0>;?Eq+Blps1(%)e2!E9U12Q@8ylitY6t^%B~eo#K!OW-5Uo3boJ+P
zs}VOJF1@@K8VjvZ&GuCt*P^3u>bvnkZrJ<>RU}-1;4qmzj#kBTcYvu!kNLLJ`tjrw
zWt?|!9DkGho>WB}jiEa#ovZmI*^?yOQF*&#ni`Tmke?=$Molfo04pd^>2S{N!kwt7
zHlM6wRssWH7Xf~2$6H-0ep|i8418?a*$51jS8F&wO_^7W471gZQN?bm9&Zf>taVZ3
ztPLXr0??Z(Em#J!UIf`7H3KYaaC1d~b7VY?cufp&|6n8yj|<qw=v40-y?uN8_9H}y
zz1bv-jrZLJ=Wo>ptXy_A{zlyP7Vdd<{8C)_bde0{`U)NBT<HfeCHn(OCcq;$1Ci2T
zhN$NRtw$wN_Wvlg3}s|uGfNbkL`!b?>qp1jNf*pO+LkA<N$MM04AGNZviJ3G(A0i=
z`R^tL+3PXZK+CZ2gE>m;xA`ZfX{al%a=7+i)+y`0dPc3jH1R$68{d0X{vMk0no8lQ
zi!us3rdMYl(vhsHa_Oj5@qU;kBcu9K@S>4iM%=C2kD|l4b&a^i8jNani+02l3uhM<
z+X)n{AE~=KbwD04=xEqG`919~Lh=9Z4>r&6hdg=lvY_>`@ulkS=%<vCBHBgIylMEs
z2O70s#dRg?&o4XTOoyqUrz7imf0r)wl3!i_QOD;>MWwc`o?Kd@F5a`<tbBLVf24`?
z?1@6B0VMU--<0gef>zFB4x3~3>VMcP+NWogKFg&4l#HHMKHw=M7UxkgXzuG^;VZ2L
z)lMplAG02yQy>_ILUD-oBi&A^@)%*UwAwGuIor|UgK;67j;w(J8~!1U^KwGiH~;#t
z7@-(|V~jVyU6^Vq^;H4ju7N&wamk4cE)sRm@8P1M&pow>Id=M$A41BY-Ezeeft}U=
z0yVDS{_p?7`<<VS_(e>696c?l(N8rw>K2WrJM3j_WyiIMT#+In$Gq|qqRm7tZSQ1v
zD=X(;xW?6X7@Omatt?*MpF`Kz$>rKypDNnb=L`x4MQJdPrhMW4cAqmbT8?gd`rMJ9
zlk4c@F%^%teFhCYc|g15SGOQYB({WaL^XUI-!1#*i436zGy-YBg)wvz+;Ioa0*xXS
zaG*5Uds(eNz~ntqS;|^b{DD@_)1g*<UB1n&Nt;xYe2BD&1I$#V$vMLRQE};=<TnGl
zFVLidcQQce?JUbm_VCiOxf0iO*-F}bBJ_{b#|uHx-*)3B*8iD6Q(#*&<{#HuB)v84
zI>5OM=Q@>4fv;q{YnHy*Gh-3&*Yvw59yorkAPXhXd`hE_E=_s(%g$b2P#S~@lHO<+
zem%`P%Ka^aS4f_HduDr#U&8^+#+<=5nTUo3+|Tp~L(50Ro*EoB_&|EvRGWfNZrgDN
zdZ#f(NBpV58I;NaM!3?hIODz74Olmh8Zl{Uc2%{@ausB&dblAoU|xeyNv2Il7bbCB
z(;=1fW@#1ua$2tTkk@>)7sMhZ-o`V}P_*}@za6Z9N^)B1TU!I3yjrcl3`EABtN9hW
zy`kKTEyIf>H1aPFgr(3`sQP9^zYuQwW)NqDa!DxlhrM%}Jf7{~MRq4}q}{2HB6X(P
zMSE3{J#N?>X&M_AAeMrX<T_i=QGbs&XRgx8@ID<{e7{qbov)Id(;7>6Kf6R94aE%&
zOAm3i>}M<4$aDxsdWe;Z347k<?XZ37n5@5gXncpi3*WSO;_3<p(XJ0j!C!Ia@aL#p
z+*Z(C^uMW`n$Yu~6pS_U!V4LT4Di24|IqDx^x^DN^USmo6ei0fh<VF11OB|))@gW@
zeH?GiEg7Vw@HpP`mx}SIlsjwI;{BiKk4%q1wz!VeJ^kV}+4LGHMUNQo1?Cu_(YzAp
zc{@8566p~|oh`UenwfYm|077JjLDZ~cz3WT*roZ<Q08aWsk}&A8!OJY`SV9%n;Ps%
zq8Rz@n6$)kdSwY`wd9<u)jK3j#x+RHeK~&{$Q%DwwAXwuHelaFmp1gVlThOM^2Rzg
ziUKwn#?>J{4sw-Rr^K5;Coo-p@<zLl2`~AB-s-Mb=qTY@x$i~mymYRh>|1wLu`!4j
zTs<uTFkJTzg;`TYZz!)}rrMl>R1EvpgSE+}c9IwsNppQL6Kk3=rochWTm&|%SS-?~
z*<6prV@9&ZXZ<)PIR)KwC6hm=VG7)bhz!Of#FRBKP|}~c&h5m*aR*~E?quO;^~P`q
zBAd*6Za0w<6B1Gfd#92@)^S{?1Dn(?SkO(EGUE0Lgb5X_xSknfxwr*BMgIem^#gzt
z<Jj!p^E(Np6Mp&hDq)-s#8{Y`Uvt2b6tg`8#Z`gKhbLytooqkOdeo^R)ocvnTn&C>
zJ5P#_2uw}ipKWH&CB`#`O1G$(k1CHUE<N4`6=ctLcn*-!(1|U^hepcruJ>MY7z+B5
zkH0=gUq0*frx$gK6T;dvt-kGw+n%iHyh><dqVBLM@`5GeJ2doDS{aA(NAVFh$ibuX
z#snYK>pOlM#Pv}k>&u?5xQ&fgB+a8((;S)b@y(Iv>UVD5#hW?b(oER?eWgwB9}dbb
zb|1+`o!}IA{-N9h?~I{118sPrppE*^E0N6gCCpj?!;)G~lZOu!9+FDd(^9e=eb~?*
zy7-2kmLD~-Q0>v*%s`zGyB&x!5o;Bg26mjZj2ZrMX}h^Jzbf_nK-A2L&WvAP_;?5y
zd;%RECk;;pi)1x_67vc&Nn5qzIOnJX(nGWK{QqeOB)nx(d3AYaflK3+m}6}`ZX9q|
zbxBOkyz8c#nGNaQ5|d}#XipjKfeow)(Jd(7+<<df@Vx<0#HYJEQr1r9$yb_WM(h1{
zR|SW997d|WS24S4H{+Mid$*V8Pxg7m$H)Dx;@XdVy7XvDKdwj54BM}li!rGlD3<}2
zy?MGW8x>WV9+`Y#_;T?o198mj;)jmbT-U4WqA7AmIqUuWO*ZT|36$RAv;w<|Jca!$
ziekZ^p)sJ2r8|lb0U~$eYL))f8{G}acr?+2xHtE~nt1<vsiDUcJ>wn&yUSlN0bxku
z1aex1|Dz_@UD;gIF;A=ty`!fa1EP?jvbO2XdumWI;h|$twXtqn9ckumOV>MxEdo8I
zc;<vuQQqcHiC={8mX#oIBZ9uR9=1&45IuR&sis@Z-{l+Vy4f7_&bl>DDVBCk{rOt?
zOj8x`VUKYBdpdMu{+-T+L=GbJr+3SAzp%F4VWcimqBMuei=%gm&0mi^%$g18hibcw
zW2<ku`;XGUn}3sF3u<N(aB2F7(W_Y6Z!6}oIOz{b1vCr1T!Y>Snm|Li?vJEg^LO%n
zD=>&T>wc8Ohh=6PyFkRU`8fU#E#a(h9)aE6hNDIA7R4O(KlDG1T$onzVtG4$f<o!t
zwb9z2>U2Mks-A107=fcux~;A&LDva}6ngE0>1Vb={r>dds5`C6+yH<KdltD9y;9{T
z)`g@LXAz%u0{rHYqx(sE-F~1#DE!^KX{b)x-Cm?E3h%p#3&*y~mIP}mWSaMTbKP8J
zi@NdfXtYN|;bwevHhe*u^(X=^;WxW3wmAwY1}OvZ`sCi&D}_|&#{Pk;@vF_TQUYlh
z;_28+zcg;{H)XvbsJjaPhi6|2ayHQIBfpncv_S*(PwvOxcc5N)Ov|2`dP@IGinV@>
zUySN6>G?_@F09`oUBvqYMOE20xgGjS1~Pz~*dt}w0mmlhah<&Eca!d@-2drBHvcjz
z^aY)ZESL}WDLH#!*i6w}tUMdFRJ}R)`!0)L;r=-JC50RMB9^&nD)CDsb7RImP0pc;
zYg(QQCjV<qeGykJQvIIH7mqw@<HMx_oNu-Tt1nPiLBfWE0POIWT+i0t7e3tM;w)^s
zN?CeDF-3jOj265gBj?O*?8}Ym$`bT~rmd9H-p+L{SWy$oqITJ6my5f}0;aw?A|`Nb
zyIYN2V&#6xE#e)h+V#EjrkVMrrQ^@Nt^;6HzQe{iBC=N9RIS$8?H)0WfDw4cDMZy2
z<kAtb3Q~`5$CJI4XhXt?0#+~=?uZ(~3d28U`qNlB)i<26*=&tZUob!N!xVA+n6if&
z4W)4GKy_Yy=qX()^gk{QN=kb0jVX=MzVUJN)eGED_iqqw%-^ijw<dH!ps>#o{qYf$
zibfsx{Y!LzQ5>?C<?2Wv5Mogm4I(;tF=2}7r!Gc+Ei@yqq9|7B)L5L%WDhE)-WCXb
zHPWxQDfP}?(h7(r!&{=&e(Yu06Jwn|)BZN{?oRqRuwNCAOoTAn9`#sKy#-4C`kYq0
zrco}PZCav(n>sMZ4QlO}K{ZS!DpuJ&CaW36SEvj=?+{Dr04vAg{MVUzQ~?z2CHN2|
zdFvKgc3>DhsGDXf^`|jb&*txA#L3b19monCEnm}Z5XEJeT=vsd|I<dJ+DZc=YLDTk
zxVolnHo2~c>wl5$8$Yi6nelxqmXmUHE#AEN7M!+{Ufkk2yl*&ebP-D%g=LRZzo{9;
z)%KkrD%6|Y;J3vtF7^DmFn}b+Tni8nqPd1ZSSgpjKJQI`Q)rys*~<&cZkGk_4?Br<
zVD||k#)W%nQ3B~?D~2i+2Eyk>&i}?Ldg2>d1+Zgg9%&>=R10hw`|jYjcNs3u?pL#M
z6cj*wec-Y&qv~@obUla0r2J>-mqvf49m!~zOARFQ^^X3kEfXk3<Fvc&YURRQ43raG
z%sG1J$CGuBp0`58nf9se?aO(mgNHOD7SEMM<vin?i(DlFYhaUtumZ~}lOa}N5lf+J
zA<IE{iNb%}uUUI|IO)m<!OY*n8nj!-hv<4}TlmvrVHlE+j3LU<b@-Ry$}(loJsHt!
z8SZELF!Rnagn{kva0F1P7&)(s{lW<(W(c2=+$8|NQ1v&FL$jCH_YKHzY~c-^yLlH7
zabK?xyvrunCsYUUgoi@dB4CxfT}gUw$J@iv^6JA6Zhvbpx5SqDi1KJbLH!BlDmtPK
z9B-&?r@N3ZX=q&TkWG-2Q+~A^2qUuE<oMp(9O;}i4~L!f!nyB`x0U_xCiQRU5E7tC
z-Elad(CT$IJ~=Jy)e?vSTTDJz93#=C(^ULqbLfv^od?`*HW=EM(^ZgG2Oih&h{EBy
zr-xmQu;$Ep=n;(#$D|89wHlPtIs1#fAN_NL6Fw}=@nU1jCiKI7oBKVh;8;6vDFbSY
zvNr?$4}HcN7Kgj}jy*0$sfHJ2L);PQQ1AM3`U}}!xATuOCKyt{!@HPXp)%&?ZR-AH
zEceX9(eaKYTH}7NGazTs0t@~%y!0e%4y+un$Sd#hv@&L9jH%;DaUUe3oEAm|C=v1#
zh&4Q587ifU`DiJ#l2^ap@Sz{PU2b7Lp(5A!p}?DCcOr7niC>70)5;0dZ9=gQ{7miF
zUo@|}XuvDhGK&205Wd3k;zPro-xq>`&sCh2ft`vOOJu&JtjLYDgaZTS1wyYw1<8NZ
zbkw;f<!I`%D0_&#0bWq(SZHh7xJ(nbBQ;zG=Srv?LPD<KK!ww*dWiCv`~#I6J_qoX
z2czF&h#M=fEvm}Xh|1X*qs7SIaANj_OMHj>U;Y{Xd#ij>Lf)Y-?K0t%ZGS+aUm>Hs
zg2Av!2iidBuZH1gc+z=U$6Iy9m~j`r8yZ!j2Rzswx_BQqUAyEWvWcPaJ@F&{BTa`P
zo2<)-n*c%S52x^JOJd~P;_JItm-pdYBx=-lhlCPYT;o3zzchFghorAdrh&N%pzA0S
z>fPY(n*bFKdnOF-D%8|>wW`D|7|8F<z{4mRI*vnExkLDv)hG0SxEjFmVz!?Joks*0
zk02WpesPIK1DB$(IW|7__A16pt<<BJ;f)wdKlYlO{Fh>l2krhB{Mm(J_Ipss=LJ&4
z<p%y{!QPw!@t7znU(#^m=0p=g>924ESt-u)R3u2H*SLD3j{p3{TiI>$kDDt%Yfo<%
z;THpJ9Y|NFQlWB>23UKu7kTHum6Qh4UsvD243Y_(1#(HGFaSr*k7<#ibeXDA#Eo;9
zCFa*bCM-k?AqU^-By^eh#^?I}(GDLK2~@k3iqXGSv&{6`j_mvVaT~@n+5{NAN8$X2
zs@;*>!Dl^ct=8bXAF#?%C)t^Ynv0Rp3HKxz7R(@*XgeB1$#PgWsw=5?rhuwHI;#h|
zxykQ#9EC@m6$6MNQAMmG1Kk(P<<_;mOC?v0D;*aaE`&Cme0cTN7O`j1b|UTCwNwKT
zT3?UiIUMKH>9FwVTS+fF+$ARW4^cWJFxr@_M)!+hzC7&FgHk2GfC0-6+nF}4VAM(P
z3-)BY1wYsEr9TtY;2#0Um_mjQC|e!`{sZ0khKbTv^L3oTRVssCT&cS|aWqx;F|dZG
z;EytkyFv8H!Y0f|{we<0KlkZ;y2=E_QHW%{Ix*VQkL>UHrP1|Vy!E-?Ee~J*qae!P
zV+*l(oD7~_ErPI&A$Yy8AmjUcb=8cqh@GybQBq5VIam=l>93mXd61O?%s>v@-HT2X
z1(a!R7emIWDnxaay|b|_AvzsJkj|OIaGp!p2>|%cYtV4T)x=gac%=S+r!j=R?uekE
zq4Th7SMejVi*h9W<v8|&(UswQ?^DtDvMjh3tWu8#Pq1a~`w!3bS<$<f^vu8AHuKte
zLQ?HE4>jZh1{Yj8w#NtrjG#Alr}En6*c1R5-@JP_nNFZ?+2XhJq<Q9Q$41ucp0F=|
z<gQi9iNwDEP|QNU!BK9@2jg&r(z85@$cG&F%P4k^PIcmH{ql)K1V~y${x>)zTGYAL
zk!Ic$+RV73J!xy(=hqGeH|zAU5X5dFvFvH+HT%a$k2mazpsi8sci|^)t7aDz`{7@S
z<gQ+%1K~Wbf$dd|44pk<DbC^B<)Y~%#@gCSB!?4+<dlPpXqRgQI~%&s$JV6xv5-D|
zyF)x#%Ug58=S>IEC>qtJAqYWQ?CxPpy)l+kY%2~XFc7qkDIHZ|RaIH(AqeKuRZG!)
z_qNzrYeLY&-|eTpiu#>#b?9qL1x-)A9kLyBatcUD>^CNv(w;Q#xov3{b@@*NVy^FX
z$~KxP+Z#qe!D=xyp?E7Hl)nHYB?FwKFhK#yx#QE^L_@{w;5}t(wgSxO??V85|EdRz
z_k1bECZEc|M`Sw4<BSapd|v09q%G6<niR)fypS!ugH+!9!}RS(HQrveruk*?I6ZEM
z!RjsMV`oyg)aX}4U6y|aO^(x^Z-zaF+}S_<pVn1e)e$nS6AXzqQOIN^d$Hnl$n;8i
z(LH~kE`JD#l8%>UXHsug7Ij1@a<GnX5qwx>B4SV=k$$b;wPrXUGV3!c)6J#n9HG#{
zNokZNEXN|aTwA>fF8~_ZS$IZ7gMaHRYFs15mbw2sF=g7$GxlGC@M&?};iEQyDZWS{
zufP#x7^tD!?$%LVQc<sY`^C6|Jr|8*8!N1+-dJb!N7lRuu&+H5%kMbS?G+VdU6a|(
zZ{6<b$fjX0EOu_@hnCe0c$XTpbEwge6G4xwOJ208{wEFPr(=b}B}*wtzY2HQld|jg
z-C!gwHrYq5?U*7IN_IEv*SP-Y`xV(Vnw}=)1<{^EYa~M9_9Mr1J_;&0L_<)TSxlM4
zfKqW&@`co{{;=gLyhaobl~eoXh0U*S+}Ul$Q$tLpL-8_n)Sjirc9^p*m*_3ce4ilb
z82rB4z#qBJl8N1w|A_Xw@*vz!j#tlXeLW7s9+g98Huz3lDD<#6pMwJ@yOCwrRzOoU
za1rtzs`F;g24vhVmf+HAlS<BPIi0kcFWto+-cS=}!uCby`_vP(|Bco0u92o42hU~B
zs-}b!$Fzu2^_QNgZXwxgUa#8Y2Cl1KbEto_wuBgw7%eqbkHWn%{u^v`4{d-u(btNw
zJ~KCQJTl5dL8I-w_;2TF+6EufF4>rD<+7qZu?~zs7K|B>xev>PzSiauAq1Ax<YL-(
zaS`(+?$nOD;`Y_*i&fp`LI!=qOcM;H-E0QxiQV*oK7X}I91PtVC;8kl8gm90kwj>F
z{VA&Cd?ak?!hijv!`_RYa!^dk`ql&=#(mkM>(<MplflJQ{}d#umkVXhnv8s%z1k-i
z-0OR$EgSfcO-Y03vj6E0L2;QF3)akGYWKe`UNQgVKWQ5Cv%J}uNmOm8JO<K3HmiBn
z2AcwYIqhx7n3>c@oIEvB$w~eX8(MVrOJ&US_l1%wyoH#V?fqGn)LdW}D*x%0N+@!K
zA{{~JnKzikKsJd<Kxw1EL#966z>Y}w+sjJ6G#EJb-z0R{?cL|;CRJK&^Xu_<@@QSL
ze79&q(h}B9yFE~}D>vLWJ%fmdgO@oS2kLZe$A>zcx`)Rg)QJy~&FWFHF^^v?=F{Rh
zrwL=p1+MDH6mRn~Uw``nI~OPT*WeM8C_LE}9&0lBNfz9Q+H&ax96XuU$&Mx}X;XEQ
z=dVgnvIGCSUK>YZo$$JWWBl07gp56sh_F(cnfLPtSZLW*`LIe1F2hDbaB?p(VokJf
zNiiF>nA^}RNFhVMy`P-iy~t+Zw3^n@oW}EE1ZIGm0wxoO1d)Am&na!m4c>(JY4yrI
zts}42iFW}P%F;b!>4w?+-hR>U=QcWyZV|g*P%+JV?7muc-gkokeLb)<A)R5U4ig)N
za8{&NGs}n$ifyd=$OP7PtC@40Y7pdmWo}T3L2d&?dE(^IqOtU|T@bmaFwI>0j3>?V
zkHq{^emsTz4@5-zH*lW3GGqRuE`{PjycY-J@+27ljgCE679Zw0U#3~U4FHDSKm_;U
zhH%a)__myfXBvV%zG_?Wv5RGb(Eqrh3J8=*zH|8fNQ*2m0j+Zzz<A-}D(8l)QqW$J
zg9s{O4Zela8BR3}U=dpTNvZ8lIh3~$jcDgm=cn*>O1>yoX4Zk@-rI>x;_O0YAE9^Q
z$)!9h9yd&pGa=Z?w(VZi)i|`MU0ZXBiXjPb)r2JN((mMWq!RQ;Mg4j)_by@l-n0_t
zAgD7M=3y4q12gAblUdXK)omlxxkv<En1tzp|H9dnxa6H0Fe%i^`Sb<JG(!!{uZx!3
zYF8N(7y6RJ@BI96bT9D_D~NNWVk2c~<<k)f6nv$cD@q64%pUj=((A)*xRH%{UVZ=W
z)(*kl%8uXW*g2ZSOKF2_C^VhRbdpSq1v&3-^;_mf6JF+~f=nC~XW2;8v^!sKx><N5
zVMf*Nqdz&{_L7rf{eLd;+mwU+1cJ$T<pUq8{N?_zP;ezC^1&1z(Z$@7XYXe3HA{x?
zOnrlrX}k%Fjd{U~s3tIv#1mwMG`LUtyKVdhbf1~^<;sQNtq>o)w_P^71y{D`jnbIx
zA*TM%7{oS99Q+s2z?l`rqR{-*rC?M*@2*==NPd3WWFdj3KIwz^ho4{WEAndHz?gaj
zGof=^!rell#SEw%9wSo}<y(i>@fVy-?DI8(xbvbL(NKUOxh0!z^3)zzGI53MCAZVI
z0o97F^cB@S4VqGCfe)fAtWXXg;vtVBW+3ln7av>F_(`MhoQRA-W%}eZv-354CDKOw
zpUWM4eKb0J3h&pp^0P7ODic+H_*%||$5iyL$)-tIIP-_!E<8d;nVr3I&y7;P<tn+K
zBvu-~3kxH8rq*7@@}Rzz8m8tLIR%EonV<c(^ATF*;lAp2kVwqxgVj0gn>dK$#W(70
zElrwYl|$E(eV(vNmcEFCH8CUcdQRDLXOwm(&q?=<=-g!CObE?ih104IraA+?y=&ng
zh1tQsiJ<lVaIPgUxTMaYRc$15p5esFwaZb7;%ME-z>ffpmO%DDtZ_F1OaT6ykDrap
z19tAtvkCvF=^>uW4`33o%hJ>YX!2G+cvvE<!F<NrN_JZ$G#E*#ImKgr?U?=vz<(0@
ze)O%%|1Hvq1pvu*w}{;USx_WL!CvOk_lwc`6=piSn7zfsFF70rU7mZ{t6|?mk~cqJ
z_xT44wPEtpN&`@>1Ls@FS5SMjP4}}Wyl=}tBihUnw(BuVqL#u8I7+mhqnfE4`!qi9
zv;~?Y;2t<_`O0mAa~0%oGM%fk$=dwL#w|WStGS9h)r#EkpUPg+lAOZb^}YOW^0#La
z%{Crj`J}ilD40cqjFTqYghw~?a#3wLx+X9H^`o3QcDmvoh~Eoc<R+q=80MUDJ~YVh
zoM|tAvpecWi%{*uuH4(F6Xk?^(Rt;%ChU|?(cDCm$`N^~aZ(K?ykyz-%sVx^+Q@Xw
z5kpXr^jsivYRwUGkUe$mlkdcH9Kct&|2lS~a)m7UW6q^g2!MV)XZih`k22DJ_j3}W
zBGRts#7bzboVtp}YOYEJ4Fz3U-&S%{(21@97L%4|bHB<1D1%&P^z_-XN>1lZSNRjP
zqKlV_SFu=GlCUQjr@d;w+8G_FxISs~##E2-bG{ChW0$WOU&0|nT<{zyQ!(V>(0_vA
z6nKa1gWj&jg^=ZQMV4vcqa%-_9s{wh#r_#0v*O89TXY*l`t~c~aX(G=YMO6!ulre7
zPfQ+sPO-E6@;{Sci)^)t3o0LkgDXBjt}?QS1FH&GQZAJHzvT+;!*91O5Z6}>S`Xk@
zzF4}oNE<2BDcThqJnLA|d5d%NGcDa}Nbu$6wsD5Oi`(Wvze&<cUZUtOSp6gGyT(q|
zZPqD%6O~N9gvT~OdyQ>6E;u<=nORkw#@09`3)0lM_RtnC$$kOtbr{YARvhJy_{Lsx
zxI~j)lShBEyC2WU{DE(tIJJbzN|-0Uj*SF;(%{umafrY|?jc3y;LCl(Vcv>3{k+^t
z*#>%a{I#k0Iw}b#?1`pa5j}spw*_aR!EzCD2B9+4=T+uB30Aa*k2|8o^Itp!3&h4{
zva|(P13b6f_2>LR?Mf*ZIL(+!L-XG2*p*@<Pq3L7Gg_8c2+PbK#flD6m-Zn|@{0<K
z%-$67S{9cX$r6LJFh^ev-1182`KLUXi@055O!53l4ej#YCutd6em|9i1SWj(9pTvO
z&7tvQ@f-On(NE+wnAWsPtdjRr7!ua>$N1eG5t7Jb$`~lUeQM*lC$WG)p<&H@+v7hZ
zZO(Y_R`0w2F5lyK6~(h}X*PpFtpk^Xg_HL86Wvj+w2mU4Z-QaL)C5d1wunGXM(I75
zW}#`Eec<63wXs~3XA)72+o#(5fLI(PtI7h$eDVKM`HzA+2&{doe#w<%t2}i3tdzRn
zGP=Sv{XvRw^<!mWAj=Sy=#V{B>V8NPx_SL*C1RqEU2-Eg&o4nS{W5F~tSnS^QnYQ)
z(qt8K-%njXJNErsO1y>zatT0&x0)}U-@{hOYY3ajejNfYx0PRiZR4Js%;P(Em?5ja
zlyCot>hio$7;N<&{v_bHt|Q(%2CR*>Gt5KR%GN(mXF&i4|NV1uP!^fFGj3<aQul}Q
z3*6Y0q3u;7?>6A!VS_lKq!%xg0;IH&`x|odNjjCT6H{1Xc2Vx$!8D(nbL?g?uv2Zu
zUD+wQQNZn21PAj4_;Y-2x3doZgOB`gSxxU;FtBibT|ah&LG@GSSIW2U@ig#9^{e~I
z%RX9H3a+WNfy{~@2gC6lP8jjJ<;q=hdnsltB(?YFV44a1vFSqEDg*wYipuWhR<&A}
zbUSs_)pc`q8?Mjj!PQG&P521t;=WFel;Pk-Ab&0>)ihDxf)dqjB`TfN&N_l$sP&a?
z6t)Io2l5hKzsM>~>U8*kefSYrA}fBX)s4rHHjsaDW-Q~_WpsS?vPFjd={2$=1jlk@
ze!Orx{SIzpJ;Ch-<9vaFCPA2yNgIceIC~Y4-unv5;G#-E%)hc4#zUsg>wy~V+CbaC
z>rPw^Xr_ptHu!I=bR@vZWAVTt(n#!FxtW%>s@|`e-L~U{!F;IN+7HL8Y>8vPlmy-{
zh`p!6n}+iF942tlx^-STu2#~VeX^G`0=h166D*`VMGopF*GlM2{1`moT*ILZB><i4
zk&ts2*|5XKrtYzb1L?yy$(>351AOFHQpA}dT?@%o^~tc-BKPaPnZ!1Dj5q$^f(U%o
z8PS=BY>(=cUtl~(GLOcO%y^OLLLn>*rf)d_Cq#lG)$m>e(O%5^;kAPMUw^<NYQdC5
zqhj0<AbrvuLNG8^K~zvIcznFC!B_Fk@G*dWHeBF(pTXzJr(rSC0bX#-;k|n?X#;N<
zM8lI;d7Ng1+nf<mJI?)E>UcfF=IO#9@)07a=RdI`bMWeaY)u$CuO*h+iUMh#_!SC@
zu#fQ=Qz~85m>+zK_;J`0j*0iEo}v8`Hq^g!#RJd@HAGDQzH_buK|3JTLp$JW1ORFg
z8skmUTK!wS+Czu)NVKnTUk9NiC)+}jN#ZKKJ&FS@X==mW@3FUHleg4Pk(o;4cp*el
zF=NTn*K=lKM*&T1Oc(R?H;ynbkC2e24C5i{Be=sKL*fZEFyQef^zJ6AspH8(76_`X
zD8TB-i2l&OUzT|TMHO~*;?zV+&)I*!_-m~;J<f~na73u=jS`{v6@2;@L*411>eCy3
zheYO|gNTkN^77RX;zqQ_S&eRF16n>=MtCb^2Xg(f$4}9Vsfem7nn}dA6%4d**vi4A
z`k2$Ba!j;TW;>a?eVAuN9Yg(#L0(}9);+)h4`E?7(2-Vd36Z8rHtYM@JNp6>@raMx
zUX)zvf?(9%q-WLpSrm$xolxoj@_mVK@rl#E=KXt4!Q*R&G{dA)Fy8KLTpeqd@ga!e
z!fT+1vB&P$r@;qbGo`16&-RWDx!f8$SJi(1Hj2d&Q`knOJ&*MfR9!+X8o3Z#y7?a)
z*vCwr+4xRGjUf3s=SmMb_5Sb<;YKAB!ed4N3^?2Sz87#o<@ezxDgEj|V{>^kaq$0#
z`G}nOIi!t|gGWF6vg_N3X$C8V;kD(IXyI)k#6}{132-LiMfpGd6Kp{P2!A}nml<Bl
zXVtP7na+k|_v4_)Oc*S8Ii3o*pmEPdQR$4H2F6-I#ih@(L(6yXYH3BhxA)G}D}$W)
zoP>xo<X3wgX+FfIWD0`)_(`d?Ms>#60_t=o0SF)zSx2^$CWy(Vme77pf#4%irxCjj
z7om*Mn^Ug`Uo1}CNc(#M;^Vf-p5cqzP@)Qb?ywXYC?jS;1O~5FfFQNX|L!jEMF}UO
zOxHJ8?oWAIbWj^XkAP~NoHWhaLa(So*_Cl{d<-x&>R$F#&0f9`g1ysT@UlU`4aJ95
z8-P-vnqA1f5h`zHm<sV^Xt7#^PAh}G+0Znfs(rGcOA&B{Uph4<ti+E+%_}>0lS!&;
zAV|7CcvM*jhjd8%$SHri!;1V$o24!d#LohO6Mo30GkG2C+Y=w;(t<J@Ir9op1jS!S
z(Mhu!Un0D}Om0=?=rg*)*G`k9qx=U4CB}tCpfqYCS_&cH{PK=2i0bGdeD18mjPx{f
z+&gV8IUQehFCa%{-d^iG)y`mIw=E{uK-G(qt7}}E688E8x?;EtHzafsJ`>e;Ehp=H
z_}q5O+(HF)Sadf~d7$qaZC9)8I4HHPzaZyL(Op3254YWqY@CW}!1dJ53Syj}L2jdt
z9%2KtJdr~5jkmbC_K)P&OGj{rMrJMm!u6UG)k%FFI_wNt+%66V7(AZiJFU6X`bWR!
z{%8j>LbJEC{}BaVD*<K&lzi$cY4ecPk1MEi?UFXu><AJ_{X5}B&je%EVh;}^AhY@Y
z(Uu=gu4?EgU0g|%sDc~bJU>9>13h%uC|Wu9V(-3&Sp#F`Z^3>GX*xmPj}+M1k|FoO
z7;_sd5bw=ve?M!>M<U?+w=#aDf5pKBQs}yQUH9BIp|3ctDpj#z+(F|G9NKmU=kb8*
zr$|Oqp_ESm4Kh<Pbp_&Co51SA<~p~JhIG?q_r*Oaf$^fX6V}BD@Mx$@(aO(fxzr5n
zIFV?Bu5)DUY@@jVY-VIW<|UBPZCdwrFX8K&Zx>fN*RMgMFow>puG8>yq^TrYWP2-J
zyqUx<CaShEE2vH3%t07}-~E{*gOy@Ger;MTR2T|Ray;>zO6QYa$!3&}1%~Cm-QlBf
z*HzDd#N?~Y0smkg3j_T9*cL}b(LjIz|9~Q`;?;vl!=-hRH+y9FvQr*gw-L_)9seBd
z%V9?NJxC<3lsH8n@Jm^unE63^Ow#UE-1!&wMx#uuJzs0xuefFek@8`8{zWVO{cbv2
zpn8{c?7`SeK_vTW8|#U)exEmGpm!;~w)ud6Kaw$8bo2}O5=++E*Aqfr-gIY8M?lvJ
zM{w`%tLf2akSxt`&h1QIT{M5M%PPA*;MbP{NI5^RwQufZ7=8ogM{?Eo2p^r_8Ij2@
z!+o)(;qx37V@iLFWO5R%@*EFujOAR%cY=Mjh-nD>M%LJKb?Q&#;f_P^m$@TC$=3Y_
zTFb^68aF<i^I`qY3hULxG<~_l+s5s6)7m;1{_%N{oL7I&B@g|Xxgp@gY7s3zf}oIP
z4s?r>p&!?#@uv+)F8euurxS@~eMLvjq3R{jn*<PS3NeM@4l^AjzfIpM&2t!Y+4Pq&
zV5c<Uw%jNU+`uH;v_6NK81ORHgP#5e{gIMsZ2nTh<eeGg(d!k%DIaf&4s^})@MRza
z08GJ`-IfM__e%pUdA5QNp<&lTNO)A#NndxdEt}9a4xk8I#TR!%`Bz&*b&FOYS7VBg
z9rpS9u}}Lm6#`xqbI3%iDH7bpQ&;sxY$@f>^F8dP!C*`*Ig|v|Q#ue=UUZV1fx<dU
zL+e&595pqBB%N+BhCNdxV$!0x9?WxxxeGX*E$={@McnD9;2}NtdXeA2%400GuiOB~
z2!nHmzQkqxY&;0l?FD}2#mDZ$tQ*bO!Si4QOZH=^Z~Z-glCb-&V-l9tDxIjjw5%H`
z=TDNR$T4y*;PO}GzP|i&u_kxT@~r)ol7s9Mx%E>8bUEH{+?#W2iy(Eou`&~9*r?G-
z#yGaFaT%xXcw^bW$KmMti?uXyv-aP`V|B9fuN>)IPjhf+ER>A-!gRXpKn#agCmf%C
zM)q)oi)~R{f8Wl>hY-{d%G>{b-?Q1}a3mMJ5dDjhT(H7-mNvchlJTnlJODp0z7eEL
zoTUEO7uaK{VK1cy|MlSK2z&M3$Bk?W;n$;l72V^oQ29i3N&3n@`ObpzKHQ>#FLC)t
z$vin>wK+e`uE0cf%3cp;&PHK6KR}8PwDdml*2(fsp1ZASiVM;Hm3f#ke&KRp;)XJR
z=T#=lwI)JU@_~tqt}&DV%+@Kcd;fP!3pZ@sac8-v_n{}=)md|iU-|Hhemq5OYIDti
znM=JqS{-rvwh4frdL=xkbih@G#UW{I4TNVe{{YPr$?kf8a7HexES<V}=?eVvhy)eZ
zag`L6Ij9$-H<!XS$3r1%7o(al7P9nwk_Fh-{q!4DfJEcY(WJKwQjcby`%t`oOHzkD
zT9S@=ecy&BAgjCkLL{mi_IpO3^ogFtgBnMO?qfM5Zr{Z2luYBQ{z?fq^?mvRRW*MG
z#~IW*($xqJ>aA$(Pnman#!hhUAnz8DvEf6!ZUjI8YN4}2NSgIfKphzAROxzsQiDPn
zsAa&>JrR5e1^bHji*DlR=D4y_4@|$X!##0*eLO$o@vv#~$U_P#qtX9zioD;VDM)D*
z^~a`cC2b;(e$_F;`ec-N5$9pLD8!@~bLoQq_Pu7{cm^xZjD)1Y+0ghywvEUOWgnlH
z6u{5$uwZ3^P{fJF`Z|CNE@n}0zd4$#Qjk1ZVca)*TDO`l7Aeba<~1nd2wGTxh7-Id
z6r@ouO#hi8R>qG{p!dg&u&NRCP4A-p?cF6fI-1QnJKrDVN+(XeSuMhuj@pbWcMFd|
zg;ymX4f0!{LUdm~3~j4F@n7)F)B)dt7RkEJ8dt1W`;v<(fgB+IDddy|!MK7qbiLbm
zs+DCni0GDBIz`dpCpC$ihi1#<ZkAF!fqv(H(URTAc%QYkwtLUM#y)xytT02TFahBS
z588Zma+~4(z#|1Vg_^pd#169^DX+gy>qk#+YM2DlHTCTXb7XIqQoKyIrfgmr>pG)y
zVnPpXU{dNBKSwc0rSy^&xfM`!iAF}69s+&5E+>17X#H1XnMnMn%%qe&F~^-qyDH)6
z^ww&PVwK*M@6Z6=v^@Go^C6g+w$^W4o@IQ5?H*cdu;cPKm}q3J+_I&ZqWiJR?e~JS
z?9Y%?tjAn2CM%@=p|Xpf25Xk0N+sx3F+}mnbJe@hNMD9tQ#1_96tl_^4W_`qd1V2d
zx2pqNaV5Hz=zeMTMb};j`6=+y^=7vnx+lJHlAz%ZiMrtjg-Bbs9{(AE9{6P`$;ZDK
z>M+nkl@@2{-IVDup1#HJ=*2K3pX<h29Q%IucdtLi!)<=khPkx0mX>54Yx2!Sw5sSf
zix=k;-vj6oR8u60>@7=4g1eA10}k48KQH)r{{w<GRFox0)5hLJ(Pg>iE)!c1c!_zX
z4Ik{GDxpZ@fC~>K5CjW>zmsFSh#-rFh|2O!Zn_|mB0W~&^D@EZyslXjCZM_Sh{@=2
zpjSGFicS%iE9U7N;_KA^FqAh8v2p=>fc)Ve>f0xvKug8o1R$j&fG@RI>CrcqAD+<1
zrEv}&)-<jlaxlmM0dOusv-meD^H*J!u=o+%4?;f)A^#LCIt)b&4?DLNeEa;t-dE#7
zAO|S3NRD?s4a&HuMKQ?leTRn+E!$?UAmSX;!MtYgei|>(H_~HDuZ;h;W(lXkb|~<R
zMHqdY%)Di>YT`j=_3y3Y7|~AXt*(F@$0tO;tM-5M5a9SVX`=e5t@Uc0anww5Xb3D9
zPp%v-p~l>|_u@Q^cnE7VU~{7`ckb3t6V%q#QkL3rC^?A@q~+FbQ=prbv+C`PCGn$p
z=T#x{<1TedzX}n}*vEVXldg)W>`dilrGikfVowltmfjnG`U<|ZSn$2wJ?H-Es21x^
z;ee1C-6OM-y*59yo$%C`Fts5)5nI+}Q-O!<sjCcu*%bHI(<Ozz@rJAg!Sco9LWSh!
z*cqZhDBa`3cU}4Y0h;b))<3=IU-n;fO?8N##gn3MDlwjkp6Xpf0j|#_5orhk&OuK2
z=r}Q0i;TO3&5#B~=8t$*MdEj8zkC6l<XVkcy;83|YY(Y8VDw^qwih#XwlovAG&x5x
z#aqieIR~KrPF+cM(B3e`=pOF0hX7Dak?lntP*;a*hIOes&xdR6A=Lc<jP9g`XI<3a
z{<k9(aKb3VC<E@IHVi}nco;q~i6hCi$nI&H@!v=$?+&D~BmqEx$B!R`Pg#W~d;^f}
zQA`5>6m#luFTlSpfO-i4z_AzbaZMm&=u=`BqaA5+*b0E`003b0BJKabjiQTG4+R+B
z)XL{4F%oCpNkEhCm{lIAfMOt3o6zYaFKjxphp|h&fb7)@zt2QOA(nOa$ZavP&}OKG
zF?(^ShwEMVZAae$Y|^UAl<&VU@^`7`m9QH8Cb>LOHf!-@(ro<+y4o7a*WE?R^Edhi
zA}Z;ao;B|j)$k<^mKOvZHXJ*JCYGi`2hG2z*)mAYEpLS(Y)?ZJ5>g<~Ek5yayISLN
zD2NtK_JH}twTp@|T9xFf*(2)!D=yhD3VET2SDpAEgTp8O3-(VgfRweJ98FKzXO2u;
zM&8K3py5T#@o?U1UnB;C#Wku{afD`Vm+r)Qr?T70a_e3!m*9?lA;Bj^wnkr|BtU_#
zgzG06A6rT9CkJ~>SF^ZoL-J;mvN*5l9vZvz>cuOOXerTxoCF~`unOrVbZ7vRz%xLb
z%itF0|47zwIY;&$E&hkor)Y;C>+Aw%%>6#`aEtKsmrSxzkNbTaU5_5a+anszy_w8M
z<M+D^F}o+791qS{-o+QiyzOT-CxskDvmv<1<UjsI3y*WeN`5C-LtNL3Hkj)>%3n9<
z4fJ-l4N-)+M<1U%aFlY5XrDGznjR=e68Iw_qakVbwri@AjmLUe`AhHb&S$*~lUmG9
z@n~6Qj+QcQF{$<SSq3-HSk;xTKOKp2U?zJtdTnYm#8e#P&t+Wx%?%7Hw))LWCOwoB
ztIAmQ7DQs(<0TMU<@pr1%~YNBWV+T(^5lJPhamfLz=@?AjZ?`7cj!KieOw2SQIj{v
zO+sXy=oC`C+@}TaX{&4)F<gM>*07=Psdu@TzVhfwSC??28t`Y|w9gO1+s#{YF12pX
zUWk9P&62goTYbqnJ?fEV*NLWUEWrh{LR}xm^99+xZki+HIH{$9+!utMnrw?z+$9#^
z4A=6{bv>22O%9&pDvJ!#b@0G&jB;UzT=bxDXrVnzL(QXw7lXNn0(RFW07XnTDHm8r
zGh+ZPulwr+Ne>ekfA?Z-O>F($m9zw=D$toi`gqQnA5jQOW%&S`8PH+^`%f$R;>?qO
zVkV)kXert9KJ2WHnEhrT_7<62nHlfh^SHRB5FFAV!}|*~4YiZs!koOJLsc+?>ER<M
z$C6<x$RPtBO{@-}f^e6J@afQ@RIlzmd40y%W{g4mEb7JPpF~i8NcOGOW^$5rjKX;~
zR!i}GO-O(EjnzFe!VEki;c3o(P*$2jS&SNyL-r@ft(AL|$z;+mX7Y)zPQZW9Nm0R>
zJ_@EE(f-?o2HAMiCx&Gy(f3gKDp9G?<T!nnhUCwv+w+W}nEg@^*Rpm;@xefHn_J7q
z1A(wB8>V(x<dqK4TmI9yN@SZOK>7M47rYPH%P13{?%{^HZ170HTu2kH6aud)GWfE7
z&fo@{zYg+?(HLe8Y;2uS%C7TCh$IkMc3;-zqibJhYAnJ8z6R~c517;n1f0b?QK<Z^
zHS7V?JWY4`*z8HB@zHZ(UD9T+Tf8?Ly9|uc`JyF6xu1R(=;V$OC4?Wn-ybQ_RL@VU
zYNt{UJkQUg^=sj0QU7}qQrnG))IiE^m%Fizi=35Su3pjh2JgkfW`{+ytbV-eWY*2w
zS+waUffEAW4asIac+uW--sYJIOhLR*^B~F@jyCSjalz~U?JT|F$n(QUfAz+{m&C72
zxPL@Nq2-OA{H{ss!xS~Ims(b_TmrlPWXGc%0@$aMT=K*pml3GP>qiV#u57GgY{kEv
z19OBR^v@}M)&hp<CNh&c)IRLX`P(bx{2Iw$y%DNQ#ZiAfcN@`RlJD)$q*oqfCFjLo
z38d|{4_RfvtmuJc_D!y#L*K=sHx>!f5@m*ryF1lh9`B~XB1WE(gL@sG6v7tQqeFrQ
zcCG`wCY`5YJ`K|Uo-F76v@soZ%2U!1Zd1D-$ucvplvn>0{Yu3{S5QxtBx!FGv8-WT
zRnriVXS>_PeK&G6kpSr*cqD|Rts6?8<Kz9>Tf)+~H+r7970<kS-Usa=E79I{f=3WH
zYxC9kGT!V@V+zTK+Y)U)K5w>Xm3hdq(%J2~vE<erLml0Y%FX%S4DTIY|Hh;tHyg!j
z!?Cg6a**R^6L~DvhwTB5rf{-UG`U4L_e*;k3Z56Ixj9ovGVo^$uM|A44?TPtX+sj0
zPi06&O7}KVRW`(J?DLz<UNR}8jEBPNk4II3Pc&HTOVX$w^8p3dy9-<itkX&*N&Ir4
zX*T4?+*n&9QnzxIqeRKYpKOfjzAKxtBpY)}%)YntV}IL>$=CkFq=8<cQ8TcN<(@3_
zxPf)@e$Ia2W1XvxpS^F|#+q#mmLoRW0rhouu1tmpO1EDAbmnbISp_tvz#JGQij|=E
zza8tQ<LA1Si)7cp?%b3BR9IJ`@DqF9XhS!T)~#e;E3Ol=s|ddoAHygvYM|@iXOMT?
zpr;86&M{=g^YwE8alHQgVK1q2ZSX%#YvV%(tiu$Rc_$5Ybd;7;X9iRn@3+45@o?<2
zP3Xibq_H&@doTHhTqP5Cg~_AN9{(ynY}A|ia<jX-Qo%C*KcC?p*m;<u2EzU^Ip}6H
z=x%4Sag^W7#S3`<s!(~e<D4L<G4QYWP{FUc{(U`yC`IHd(NQ)t32&2mJ!ikShz#`4
z4;rX_j%pi^BPjcEojdcDaR$pQM5+dM&`}v`u;?6*Q&BYzeQ0$+?L1zyC@9cpmU}iI
zpP%1|NuG#(?QGJGoJstf%;T4!DUg;cKA~8wEJib!<&vCR<d8J?cD)v#)zP6*%k9V=
z&6n4K9PfPS&ZNT;LjOL#1~uv*T<4NX=Q2FS;%WYzbY1klE3KANQuv-TIQp6WiP~hY
zSn?3cO;cC4+$V`uWU|wz=|A=he+!8>Z6fR-VWkr3@szp%Jb&L?p_h<}^usjc2njo(
zAsOvoM=C2?0)TddwMvmN#NHDOJz<58@vnW)Ob?`e4*mJR4EM8kynxX%L)YfTs+~Zs
z=udWf)fSO2Sk^$D#-@*du|@3Jf_W=O(c+pmY1SO{i|98pT<%&tJZEglyJPSHBSRl1
zmV((Qu|TLJ@?X?FrK68TZ1!^e`<!5nRE88E?gyhAaAdSP*SR<r`>y%vGr%gxr_dLh
zUtRUJ+|P@X2ck_z<9rG;ZFdi9g~KS$i}BWY)BP7r?5CaU2X_QzrucKMd+_>#Sp&r+
zg<)6Oj^*SrX;cvA0uzwDi@6?zZW`H%+{+J*HArx65sQb0dVO)f8a-cFK`8pe#NLH-
zaeEx%bkfKZ-fF&F3wUvKXS#<)%EZkCG_Ui)?ey!R&)E~U6(5FAo_L|}U`Jq@!#zR*
zuf%jx#2UPrWPKaMDf9THrI7zW0Ny|$zZX%=ZCRH1o_JK#-!{mJ0~(-D!WxfUYDJCx
z#2{4ZNNdI3^Fas5`<fym68~J}HH~TbtO*}UTZ)S6ehRWX9dYshp!oBlM-UPOl>rGS
z>^vtZ^*~Pk|62H%)(|`)c`W+-G6YT!;@)q~P=%lPh8AtOpFDOMSmD;EJ)jP7fqfr5
z`OTaDjt!@M$-n$uvMKqWxy^V=TA1|(N`Cl4I54kHW-M<%hVc-`CN(+yCwPo_6Hqo&
z003v=sOX2rOCkAXF_Kg8K^+)8Mic=T`EM*G<cD;h`JRjj39kk4>3qMI3*zrFiT`)6
zaRJM+aGZQ(*#n5X10W#M70FO2D(`JG<*V0;`7jKkl0(LD(&8o(wWKgZ!w7Z|bov5E
z;3hQm`d9e=^@d{|1Sdh9SdqB>z0D>MaZ@D|Pc4$KT4wl8NIb~~r#%;!hhM)g>+p_>
zJZ<Kc19Tt$?3!YQxo?t))BGXN418q5<FLP*4o`3hzYm;d2Ok|!%p!)PV3B2XDhD>@
z$+&>`t_rFXACMEXe;j3*?by>YD~qC|7F)}XCMSrHo8SL<L7hgdI3L7R6TN&=cT!p}
z&v@>KTq9Z-b46_=YgRDT%Kx~`=iVT(vo>{-uxrA0RbUgsh&;0k5w1TZGs20KDF6x2
z$Lw_#7)km~%EJB?o9O8!gq+c^@tnDdpTPT{*K&?aH*9;%d7ljRO;7*{qmuDavdZA`
zJpv}HA%F8v2y1er`EcY0yXElq=6*{JfySpi-Jtep@QoM}y#WcqKK0u~2y`3>N%{if
zO85eq^1k=~#Y-$`+oPF}2;{R6AHU_E+QW;x1do;9Q;B5lm^c&frg%ci>E~azagrK8
zICR^3f1SCQ6c-~qVF<nO%6hOTfAH@P^P1qIF6?XLcpEh=$N0G0QqcI^cMsz`DUxG7
z;f%2mkujS*0-ZnwgBK;u;G*zo$0?k+h>=nT7S!xG^g~DcpW<wGgY!MERp*nNv<TV)
zUA{9iNDw~({=E>rA4Yk`PplENI_LX_1C1FEfB}uuKaAlM4&o|kv3dtUNgHC*BE-sb
zoXs37Q1=0y&+Z|<5yui{0`C_8ZPgYU2CTYnBOdSV-xtTC-qVwd<AV{S*h%1PCkW$U
zjtJftzg2`y_s@LZ4$<(G)Nz@tKU{&o;M<DTLKTQZWLjOSKK&E;PJnpPnU9R*t7eH2
zt`o*1JdpghR8DRphCi(sJ^vL>rKEIW{|R$!$*t2-DwE{GxJU4Y=14Y?S#y<flC{8y
zq_F~R&!682L(4PX8r_}_f_1_>A<VlWp_0|g|C-u#*9gpziqHyJ5w$0&51UY+g_r2&
zg?G&=vV!(Ogn3Vg!F2y=Cf;0Sj~T)k5BvgseCQUIWdcE#x4B*ek^i-oaDMnQlk@-L
zDM0@Ec?ra&{s2d>?eX7pPP_?!h>8DFF~OXR&FN&WZ6(hW5y2iOTi>1kfH(axJo5jD
ziOyv`Aup#N_XNcwexM$|srd1nPH~j<jd&!zX19pzrhI7Lk+!tP%<})@;49}f3wvnS
zKLPbSw3qwXt2pvc<YsQ^-|?7rr(uxBhtEJTKlDH6I5CZw;0IYJ@%6&}=gD_k<(D%s
zU@2t7gnVZjkP_?<ZZZtQJz!4V0r(m4eJgR{U43B-4BZG=U)|94e&|qj`dQo`zBhC6
zT~$Dl=y5P%cQ#Yi;F|_8$OPVx)f<2ST%!y7hs9A7OvPi#ir&qBOmi>dx%_f=6$2tw
z#(2C5zbxco>fAaq5<DFSkjiRtDRB~K|Hfx%_q%%jFX8Q58;jdvHuvGWj{pY}Jpp`P
zb)fIT_>0bK5KJI_%z+1FPn*Ho9y`qt-K=SzG&5Wd4fv^8vXTWc*B=`~p)wDZyRx=$
zLGYZ%@b2cq!@HTdPb4^VmDdRC8VCuzJ0SrJNA8Gzz^&8t&c6I*X3PS*upw_9k@?LX
zS_&I8iC&G=|1{zT@^Fr3l<LugM2K=*Hk(2L{7g2qeR0vD_05dUApZ#272<7&uN@w*
z1g%KCeyI#t9P(~5y~vJ@@bcLCd*s3$24BWnv^~~#Lz%S3hMOWBgVq}wbIrjMX4F8u
zBO!|(T*#1c-U{A;U=5SBM+%S#LYJPN{|t*fiT?=){v&`qVw#@N6n;Q-Z~?Q_^f{ne
znW(VwDSz%WI+9C}e|+2(^3Wb4ZgJr9<M4#i*$6%&FC1&e?pYwqe~YALk}}@nL$8m*
zF?4rOtKXMDFF4RrSaA~gNyeo=Q8InAZw~kTMVQlz&kKH;d=9oQUs#0Hb<!L&oRRYI
zgqz>MPE?5hf<UiScH%w$f8mF~XDjke_vjVseYqX!aZ*6SQNv_eg@_umq-}qZ<FVj^
zDj7mecoVru`^I1R8~)I49yn|-2vVnQJ-JZ~j77)ON}Lirl0?9eLSYcEqw@pJpNyMp
zD8Ii5^NQdbVhu);+<0hapzr8n;NU;*5oS^!S&bX;FM;ohk(w)IVym0NJk;{d2jN4w
zm~({VBQphZh#{q}VZ0f}ZzddwEBMXW4eIXsGanf`0bqVImviv$=e9ecqKWs3GjaJL
z+aw)<n!!C%^=JQnGCBqW4Xg{|fmWa|&D<x_eY)-qiSUjfFwX7-jSJONfb8*@<^o0z
zjG3{cLv>RFW6|I0U_HP5X9KaBIjP(Gj!XZOm_SWG7aF_Bd1Q?kfK1;J+6;dTJ^#jd
z6Mhc?z7{nP28o*!n#**i8>*t$5*r;luMx(ELrMIA(WNQ3jvV9%9~pcoYR4{kOEK}0
z6|GtzQb0TesW-)Tdta7#M?nKyg~fPbSlgF{Cf^xBPDlvax2@Q~nYq1y(dN<nAk%B`
z3uvbOFQI^IkbicA@zcTtO+F|ODs9AX90eAdJN-@LT~L_Mzx)3ADt8C>!AF8!lrlbY
z%qq4s4+!(jBk(i;@41;BTHkTGKepp^_wgK$S-zqK9%+>K`;ZUcA`5u`mx!S9_sd7|
z)yqNFgWyH(g+A7uSHxHd5&auR(}kT1*g&2W<VNMo88lz<b`(CIpiRyV7>nGt`QEtr
z2b78gfQ3=AfBv&B?!UkO7G;vrBjbi9_fP4(Vt!g5G5;BXD^a$c;5Lqt_Hu!(Z{z<d
zt6qm4oO)UO26kMKkL_F^YV6Wq`u_;hJSYXm!Qe&%z#@G|(3u^h_ILQrFrN+MqQIkL
zdXS>hdEr5M0CYX)7`T>vyWE^1cz1JFFjnTeU$j7GGF)6wR87;RYZ1iCCNtu?f=59{
zT;3^cJ~OHc%>)JO&7OL5e)DB$r&uC;I%(X^o?p>57(V0X2qOcw@PP1(?AwCDg{5GR
zgt9~6iMHzeBdp#r8QmB&Fs|>3oG=_5VLvc(WtWn`fJE0{bL}r5@Dg80J>BUuU|GZb
ze=2B`KZ%`D&%P?mEz+%%;T=d2S+V6B!lBC_U)*|YeqSG~9Ukz-tT9nhKgMohPnJ*4
z+;8y~)Ptof33A{+noUhu4*ogA9pMkeUd){CY2kXL?VgQ9WyF5KZqM>WC#}0dUjVP`
z$BeWf3uh<n;`#_d@sr49l*27oF9rln+#9=Fz>tLZ_2>C#gd%OReqIsq3+B>bb3f4s
z_qqTscct$me{cY`>W|2Az0r+TR;vH`Q~UA^Kez$blkyMvoY<;xAFc{K1b(nT;(<4_
zztualYFWwdd^_QxJy1k$P#K%LUs1&+|6i35^Vj#kx$uP1GI$0814$!wf5BGZp05OJ
zU@(?O*wEL3AJ`7n^nu``H#utI1nU%*6E)y_*SK7myR2#)v<J9T|H2a*uaEOrEVjnv
z2U~*=`&0jij9-&O|2_!$tG5yH^BRueFFQ>EH)n*SS!)EAT@0}W@M&Y~H?Q$>3f78v
zR~KYCJL`s=HOW=8SAP?V>hphuBSImmb03@Nn<9uM$JUPUU916ZSiJC*Zou|;vOyoS
z^;6OK$)mrFjk`JF*JJo~d8)!3J!y`pp80#8BL)4)njKKqF{nb}4a~vi1nmm^>+<u6
z3HbXPZP2ED(SBMv4nKr*WX5Aa;5|0yf8Co~_b(BXH^O9xhl%Ce&W-$>0i;Yfjk`K#
zhR+Clbgr{O3Sj}TCE-U$ir?2a&|Wj<T94M52t7%gfJV#U;oXQ7O=9-2y3fE${($@O
z@!p&zV?YKy{qOJfgY^0FFSkil-lRTm0{~=sJ|7%WZsd|aDf{wBd}#)`yb?BV)!?%Y
zp~HZMsiV;YdAX2nugH4>bto<UT;FbgHv5@zidS^M!WlVv{J27XP1@K@?qE&X|AM?7
z=o{L%W@c;Gfvlg$P)zLYn7_FZ`}+;@{4>x0FI;>t&s>*o2)9mjJI42|0iPbTMncP2
z06E=$nm=?0E_by*{Vy3_=RH;9rH7E=;YITkZj;*o6UyDGkohcu!vepS&V0TqMB0?e
zZ2!gcX32zo>8Q=aM0lLM-2N8jlMQc$xJx7w<$^E55GHRn_x#B-GI&=V(mx60T4e@%
zvXg{)v&V)I;cji5b-?4%c>TkAn+7;>wlqj$ja)4$5d9~wFSa$ie!X${$XDm0H9R9z
zpUZqC4jvwE&;b2UrRn|V@!!B9*Ul_~GtU5LeyB(3Pv5Bz`$2#Vi|V&O|LQ*KNI&kR
zcfBNs{h-$bm;_JOA4m}G;6^w2f88g3JA!7{$q7xfy+{c4nogenf2Z$;|8Ou{ge9zA
zCkRCFRm^4@-U(U!C*qU|z56zn=X^ep`C~JE<NnVw`>_AIr{AQw`PQ7^6AJkTc5rh-
zKQjvX23~pAwSXdTmG)y7nrMI0@Q(6B;Rfz{NB_0_Gq~}X=0}Q&m=V;extSu-g20B3
zg*-khn~x3?F<T$ROAlPZ2gh;olBnmy+n)g0n0s4jfj<?u9;M7qm&;?mA0Ow7=uMl)
z_(~dxFXd#6%9G925H9YJ&S#|qT#_1O)K3Xj(NtL?t|uI&Mr7acgwvP~%1CUg=HjuM
zOSsZz#V>?>d|~Q3I!1v33uq&%V>tXoaB>NaX0&W!tABMG3*-EDX?bqShGGyUY*ylZ
z@i|PC{MuGQUT!h0d}r>K`262$HHX7lbH{iA68T>}fg<2AQZ4^UUh0as|0nZsVYK%k
z*7p(j&;rMb&&Wro2Dz|Hm>kFflhrZsu1~se9f2!Y5cvQ|^)TT5lkS$G0D1X-|NKCY
z!X6^<#8(AhWN<_FafqJmYHw%0pGmWQ-vn|iF?%z1w89qVSH@Q#17}@!nt%I451UAT
z?c-<DTVCV?cI{ICSUqX_+7NziYtQ&T@p91uEb*R2>I*PwC@Jig#c}Eo;7F^d4>@!3
zl(3_byv}}=m;f?%cP$D{myk%VsUG+cy)65wcQa!3w4DzLW0K5^T^9mI`wrgOt@2bn
z#WX(`Bp<=9GHZ(Q;qXd}Eh~iX&qN7+1$HnkpNQ89=k}2>9L)K6*Z>danhkzlJ2jh|
zFTs}yO+v$(G}jZ2WLYpUBoH=H0mNb}jPACY93A?HI=~UNYw_-xfw7_L9_#PN!*PFF
zwO~YL89VH8GaoY=IOrdX^TVG)JQt_OVKWIpMDrrtD@_m4`00Hel#zB2y+}Rw(FJM{
z2lGfEQlfljSm}U&i}r)nfEgZJhsJGx|JNn{6GBG_d;&S5oAQ6@&}+{~Klz|x*94dZ
zd#pe1fRXJ!rPtMwzB>X|upz)9X1v9;0P+3qez^Jjr~YV1CL-{JXAgRRcW@#1u>Sgf
zdVxmva+_o-!?I)B@b6<!%M$NjUvaz<Kg2J>5CYz^S|R=Gr6$xcNvC^B|M6hR^!sV=
zyW=Omo^9d%ZDa+)&++^co;~MWk#@f3nmy^hs$&i_`0h-CHtwrBTPg2!Q~fv)^~rER
z6T&%j#&zQ-#|I@DUnCce-xY(m_|-g2@R6Ar!QUTbOO3KPWvuobddlN2>B)$#f05*7
zqV8ykH@Gt5uQu0HaD>~IlRq@kZ<|z__lK)pahW_oWF@5hliGCot82X1Z<>Bfc$e_K
z)|!tt9MuiP1JV9x<1q9}hKo9QR%Uosd$DB-Z!My=_q#rLNOKVrk_>!u0j_DWy9>fJ
z$|B$xAC<U%9-aO%Z2`Yn0Grm}|A|I2l^=V651YA7rT_T&)n}&Fe3k#;I8FcmzyueP
znX)6pz6gxRnIrqBKLU2J53BC0Eq*wUUmNF+v^AC>A&C4TAdkWymk4lxV-eOP#9}`Y
z;yyAv;2P81{$Kb^ED>gGT!ZBr2tD9>a_cZ^aGQVxA6@r<|G+{L*t$6H|0HM5x>#m%
z^oJYs!THzCUwPpV!w}bWv&7nQ0eZ{{bFSOqy*~d*dzb6trSubK@CrpQh>*ucBq7mx
zXpz*>7$ok?aPM*q7J0aceVY7)Io~~Sored(Mv7016NDQ0z8h}NZizPM<Fdrv#zWhk
zeVeCy@!BW@9bRZ~wrE>O4YGlPP)gCad|PfLf3O0^mf0Zs2Dl*F*=+yf07&&=`Roj#
zHz7hjZ2sv1{BbW1za0`~f{r{+Zx@J@2z(Xrf~OEq!j)eu*A1e?*<63(12O{5JP+Ur
z^r(aX@jAiu@8+*yMti%r@9<n*Wl?`G9~zmZqNd2qnGGCp<K^qdPu*!>31db>!v)Bj
zU}JEWL@CX(4#|c;5jDzYh%L#(h*}i10xoQB6ao9`_P{&*UW9ftKzH~<x&moT`QdxH
zA&@lWJ}UqjAL{tfqjv0`*8&f_^KbG+d!P><)Y%{30sFY`l1s^We*~BXo|qNzADYQ`
z=sa(NXbC@S$APs+H1z!Y>Rj_lCJ^xv9y7@h5cng6?i86BSpCI)8S-Xb%{a~f83tc>
zYWH|PpK6KsJJ^)bjsA}d;sO7@ao@iax*@Jz3vVmh*FVB{B-ca%kJCE98a>gk=iiLs
zKH8fLj>j#zzI9ejl*y7C$8gC1rNw1kfzgrivA9=?xkVcrw#vr1j9GbS^2%cv88GK3
zmQR}YHwp695??gJLq^)+5ctf2fWxIT2%PiNyVWbWvM!fW?7V&w`()gh$>sbZ0WYlo
z=O1F@1iO#^>S8@EexsKT52?l*IbreM0DJPYE51Xn`4ab@9v55v5s!dz(r%A7H3ydo
zK!^38_y*F~ta5w?G|8j~HSNa|5X9jK%tV1l01RI4?*IMpflb8OjlcXM@%-Jwn5OI>
z3F-vS5wF-A_@7&cv93P|T{OL~t~*c65~PWuT|fr)H5mx^@lk@jXx974kaF>n(@2lj
z{&wfPeXR_D2floD_mIRR!&X-9$Bx5sV1sc1$TJ(go!ocOsgTlte<z15K5E_;;W*{W
zTElAA665&5$?ixUB%kuwajfeN@l!KSE%I=kfzdn6^3Ws6jAk*OxJRRtc*Nqi3kGd-
zbuwQatu7%0(Xqb|Zg>14qr<)%13z)Pyd$TOBl_U)b+0xXC4}DP;Z-Mkyd#hyZlM4F
zt^aQTO3TcTwH{kUbKSh|8nf48C*jNlk6d~q{V~U}e~jtjXd_mq8^qDVGw-WEuZ@iS
z!x)Ohgt@7mXmL#9L~>ZiwH}`Y{9vuY-jg)c&Fc_q>3KMPxV={pSmrZ!F7f#?gU&<z
zvS4mB9paB2s_$-t?h&;>ed@pP1HVfmKKXciO<IrLYnsS7xWdEtLAhc1yf?2rwRljk
zA4HD1;Y2zyEQgoFkH0Okn}hS1Z<Cdj%ffuKEg4Y{fCLrIr#gkgd~)O9)e|SeRYkOk
zIXSyQ?a#+;G?3w(189yoXYUH+`4_{LFZfd_w~V|)=m^xEvzfzIL>|GFR_*oyb><n=
za~A$^?Dmzkkbj=_h!w|mEaV&apo^h~IzX&shA~ivFV_>fP2ndwa`Ugra}ngm@g5{i
z6O-GA5ppWci-b9hUJ!=znTiisgBsF#-~KDj1#Alp{F+Z(R|+z<T0B5>K|WtJ1AXQ~
z`FKt~Z1cgD0i6h*Oefht5-wUIo*8Fc-4RrHtThl!b2CI<Nc7iyn1S8|E}GpHe=qz>
ztJA2xyIYSgCk`r1xj36}_(fhHHuL;3g)tvjuJW-?FSMACijUJuk{ei#(^!C2kv#C9
z-Vg_~n_gpRP7+zi_xMjtj6vsOxJw=zpUVi25XMGOiGz{Hr!xb$H~FG4QN(3Gc3YQ;
zoehoTOCo_hnOKcYctZ8K=x2wHjvaF220ysK$qyll=H|fXE6XO*t`Eh=BOeU~kBpk;
z$3`<?jjRjc@tkl@E{kr#7srSOKh=rvUJqb9WRj@tr-%gC!Vhm_D;PQ@bmLkkx2!;$
zd8I%YdmL^M=l%;h!2pj3Ncjvq4JL*}??&S<`}{^3Ozg-=^3(i9gAZl8=7$U)<cD(K
zCl%u6`I0afj*=Y6@qlPL3R12jazQ@1`5#vw@foulj{D@B2AO{mb|87Nm*Xgy49X*0
zapcD3Ib%b_{z;A;kBAfEL3C@+ml#ZO-moB0ZNQJxUH|wscQUKFukt{cf%Uh;H1*&L
z#=t=n6T-v_i58jIZtu}RI_;Ch2krVxzc2YA;VGaqIM;`hOMKP=9-RrZnfbVkiYDq)
z9l>vRTWgbzPGsV9dK{@?>d_)Ia#&({P4N=X1iu}f^9CbkKR)k{?G72Fo}PX2{r*2s
z$;$u5=Mk)WaPVA%#%AMO3+rT-47;W2<V`id&rf3kH~9D2;I?prMA#DO7@6D<1gOB1
zSQp)xL=*7w0%G%IOV1&mg(Nn=|9Cn5LK@(M0!QJ_gJy6weM%5IeZc^84xjJ)5cZUp
zHwgS0I4VwQa!|&&N_@tF3ChgDfWBHWmcPqwFUgPl;sXb!{IHe;#9?>J`CszBSO1y+
zii}fHO+_^n&~3`18hxM0#4EY=`@MB}F&`{p2H*hvR=tF#0L{1RC;Ybh?eCRJ%!A%D
zP@Sn~oHno~62ASOKls{DwT4^RBzc~S+*oIcgkI6hz4(tlNq62DNAVoqIiHp}FKSpY
z?+-fe`{OjQhj`(a@QpzWOymTP(%mFJJ;AlK6AFrgF}L5hp;f>^o-;xOdw<ugHhZKb
zYgx_zDq=L66ofYG0h9Mby52f&&ZcVb73fS!aRK8}Zb@?+UhwFCGv13x19ot9b0n`C
zMv0JgjFUJp@e=VkO@ojflOCW!HG%`KI|%tSkUqV~RQxoO8&ZL5f_aQ#l&-!IZLVs>
zwDrYI$__s&GvsFA-w>?$CdPyXxk#(Q50Xxs5#lcqW8S`pL$35nXF<15$oU_#vV)=1
z{7w@>Ug%IhX^tU&ItSGa8Qp;qvLGX~RF@DQf05HR{RJ~z*x{c)B|E`KEb3<QJlg{*
z?N{cNd#B>#A&GE$qg0mAXuu(Mpz`4Q_`9JeIg&F(UN6hhU;ZnO<8nsmX5w+Ma8=1i
z4E|0@qw?R6tTq^M7a#a`CfvoK;J6g|@zAceiBduU${8}_C=Mgzt%?5#=B!2ptl?1L
z2H=h1{4!W7vxZ!$nl!Y@-}7W%RRrR^c*QL;@5ELi&ZDj?QY2_%;7!!lWUgIuW&a2X
zu|R8i<}_PO|C5F!#&0>^Ob8{%Q##AU@x;$X9YMwV`;4hGkKqnO<gmk;_LyjG_?u=#
zOX%BTDuu-JVNQUKz5`>?VqP`>WBeh=lr-riBWnZOhCY5AZ>S%dWAu(`aFrwx^JMP?
z{E~nKV65yXfC2;})YY|2TUN%YpZox@0fdAWm<P_eU^Z8$BTWZC5#0g^+$*2rE!WBa
z5gZ37KIE6=kK^Rw8<52Zdm+(~bYWG`#B+4Xug%MzY_-P1CJ&NFd*B&9lFRN-TA9vS
z8VrO^z{NX~<zdc1*~yqXL84-ni0IJ%clbn@%3`Ellan4nYd$8%KNzOCn-qOBm2}R$
zARS@{<3`ViX_(DtJ_&Z8<`~u>v5I#;obTd3FNKyw%Pngr=ZoST2HPx|WVM%sGP5RW
z23cz@Aj>2fZX*%+j7RWIT7yT~^a?Yc%<uBS>6i~hlRq~}uRTUlKmJV2elr_@vvTV2
z49~icC<R_(aEAjwfACWrrzeFF61N|&b7zFI^7t$6V-k$x_0PW!?sx|j1)E1q*Fwed
z6wx7}tG^NXJUb$In=Rho5hgl^{2`&pl_hI<^tcdnlIw9?WDT^K3TQS1(P$tX2>{!Z
z3;+W>00aSmDKf)>F5zH8bATvzz&(+$o*=xnA=@ntDis;yBq|ZJ;Dl1>d63(a2Y>;d
z00IEO6qq*BVDJDlzyLrP0+Rr7ci33ZaG#(6BY+g^3u~W7r`#G~;A#@BPZ$b;D|P>Z
zQqTYpe<Q;e{egM|MQ96wu6FMOPIK%tZEy%D-@XKz;cCR82*xGaZ=a0j&E{jpWHF9L
z@&+Sx_fx0*Uc*hXf!FeKd6)4rBpL@EB-$!X^3WN?V_IS|@thVcsq}=+()(an#zE>1
z5TQ2*yF$1J4iV9bhd3!LK}tJe-Z7T6Z`=G<1FC73u^@~hZ{c_*xlA`q-SC422d)sJ
zNn<s^%U7l}sJNEPjf@>|S-FVpHwajM1PM2eKY#XDCNv~;2v2vJd5-=g;VnKi)=<Dh
z@p2<v5^xlHPtEhZn2|GQCyiPTxWW&HO@yrJLP2pHd%|#e2@@j*X+hsHoA~U;t(iVI
z&;J{{*CdAZ=$6p?_n#R`-5IVP__lPq$7WSTY|v(_1j8kwMQSx|*T=`qIU{A`ej9OK
zxyPz_V0=vrlUg(^T|~2|JI(PSId=#8U7`G$zwXz`2Yg*d&VA_yu`yvh0B{Tj2&vfJ
z1S?XNJ|gS>03VSa-XJFnZ?^yo<=LJPCmMTz1N5HWAZ`-RTnDEmfZ}17Zo?c8N^1d6
zg@xrs6C3LT02&5D;yw;fz&9BY06>2AlPLmIfH+J8Pv;kyTdq-n^Ch1Du`~}BI)lDN
zzkA?Fu1E*ssKkkG*(fhhX+v7=?F|Sewy|Kh^jy=+jXh*aLt>&=fP|1G!3LGeAc4N!
zju%lIC?FiDaqIAXfiE5E<P1!_a{zFg|G=T7q*5dNKlAZWhPaL2E2Z5JB(f&u;;Un0
zGMdveqH;zCMRA)U;SAS^O^_YZt4_B}yqSGJ6SgQ~tRsveJ<{jZvUt~U%Z5i@oMhmu
zAozP9fPtztJNy$gIu>8$@RgrW@>LZe{>@MFWS043pzs!i0{^Z%MNsCm@&o~ZoAn;@
zUH^9>9q^7kAU1tN2^~RbJ(sx4U;Ch8nd|89o&F~7;D#Af6$+Va3xarS(Jb7=a++#p
zmP|>plhw>|9wb&|d$;zg{F~vAM6x8?6~l4cyL!y4Fy?y6rc#*veSM2dI#pmJ_aVBv
z8BYHbu<2W2cxKD~5}i&~D|o+E!WZ5!GW)cGT$t8>!g}U=47(y(`KWAd#Nr`NBL_k?
z^~F#eEcgF6;~J}P{tyg^fx5y-6~HXD*f`t!iIC>wn$)22sr~nboEx3WZr2c_Oz1-?
zPe14wOm{&SXM-4>efv)S6U3Tu)&ArR1?FKyYl^ZCYlJg7{}&*DohOf*GVo1G<#q^<
zDZ9_MyvORqm%~vIu*GneRyObORlJ6Vo&#UYFqbU(r{Ca?6~$>T|2I*Fj~65iGZ!2r
z@^GALoDP_23Q94sweb?f{(tFfAFf$yaS~tSxWS>S*A+*<#5kAI$;HF)!hCDha(BTa
zQV3vVpZHHf%(&A>{JJ*Ho(mz1kWO?8qb1GSpiF(qIIIWTOyjiG&U3%Sito7ti=^=g
zMoj6a%y@LoRtw*aorvKJ(P67u?uxjnxmaARrbLzwc`>7I7nd3Jv+$h(o)koeiE?Xo
z$%OI<mk>V$FAs47zHoYuWzR}J`4oVxuyJxDn&CYnoK&DYF_96H5%7khZhYf;d1&G>
z4(r#Kgr?lP$6h@NtxQh;1wIk?ITO7Per*}WA<sS{X9v`diDUd<1Z_6n1iz1b;_uZi
zYEsFJA8}keslc*E%gZ`SD_WIzhlr9|CE`CHBpbCY4-H<3+}OZD3?M1x;_#*!gb*cQ
z0Z!i2jSt53I_u|mZ~9$z834>aGNfjE3aA&R72pRhS&$Vs#A_XWN|P38ZODUq@30?_
zq8zgew3RLwn^=1rl84=h&dB5@Zq_av^TK)sF%dXp#9tHLqOpvL-hbmTEbS710FmJ4
zij`@+c-<#Yt?&oEHbdWw$AF%?8`inLSwn>Xg+AMSRK0X$eF1#LtuH!<U@^4Ij288{
zoiD*$caCO}WyXd|n0N7b$j$adV$?*uCjI;5)^1KJ`cay75rYmVKMlz5$CLNPPLml5
z_gC`RajhC+Cy%1n9n*6IcQBtOni%MaTxL7~0-}sv6xY+ZVCSom#*UAExew1Jf*&2~
z0&mfN;7{Y=V|J_!=VZ-`+2J1UnXnILhyTJkiMrnYf85_!bDxRk&jE?<mE-0MAS}m%
zB_-foI{;hvwEcHs22&FLZT%6p8Kr`_B>Kk2#%PQ!f)A2U*9+j6W7<<9<R)(CfEe|U
zUV8lSj}3*vJ~dRuzvLSE5@-Pa>e@b-@h7OhGb3%&``ZN10T~^scu#pS4uM0~Ij;ZW
zV4F?9K0ibsTxaptO^r!N(ke!n^okf1J#pC4vh~`PK+E*wmwZjT4fNq?b1Cp$#s*(3
zzWHb<^?5i;D2V1)Ac7jQK%7Plc%2=ws_ceNY-1nGS_>W%47|K(WX-~I7?Mxu47B&M
zTf}^30oS`tKdwV7Y0EqR=FYC)UxtIaq&OZJbe!j1X-_xJa8-zXtG}7Y1nbMJ&3Z~r
zxgsJOTrtFBF%gkJhj5n@T@ob*w)|i7ut03VFpr0<didzr*CK0<@JICdn-`<`&uA$U
zAAACuxw|j(gS{$$y3sG_yYa)<md{^zl>Ko&81LA14b9Ro6|!v=2xhwm+#zKc8D9)!
zXYYj(;48WO8R>}S^M43XW)U43K5RH*XrS-oEU)YzPW2@IbTn?`LM-kAjZXk>KfL*V
zC-{#`OUyf@_;z^3?r40R)q02COoQb${{?X~SRak~fv(@(KGR+q3mw7Dc`?--=_SG*
z5b%cx;xQ38i8w5e7&7LtJJ+Se>VpY5aC3@5Ht;@$>Av^UIse6YVQZi`$+k!5KnU4=
zA3xei{0rOy+O5o~@L{^$#II-hXPfJih<s$i^5eQx42zO^PAGXkY+z34#6)YoZG!&n
z3W)G05sVDJDQ5m!DCy(!=0rK3GmU{0P^Q#IAzVIQ?8@L@t;Q(srs7=GHPB=o8!aKc
z&ilrThe5wnvp6vK{vUvm`T};n<BSz89rE}H|6dQn2ujttvy8j{$NZqvhzs+`%+8&k
z41WDixbenqWPWt{i-${qZSFv1(QmJUc@=p78Jj(rtYG9lf$&|v8>fhFY~YJF{uY!O
z;T%V-M~K3oZN0Yt;yg#<F9=sQai~YZBRoz7t!L<fMAin>XN;)f?0@Gc<Gcw!Jk8m%
z1Ai<Hqe>5aF0XD!-#`X7R>*MwgU4OrD-8x#IZ_SwUMHRuSk{grS&zqNe;1Mn<&h7V
z5I8yH!*?(ELbMScJPH;=9|R`I9V5gO8mISb<Y(e=a<OVmYsrS9$9$aG3{|Wfg3Y1S
zq6@=4(a6Y!{b&85I&J_P?|*zfA+*lF-ff!T<+XV9Py|GHaq|684I*@Z@xRR+P{^l8
zc;5wAA@7~kDSsG1Ml1sHOwEPfFP-kd!~Q!2j}_QD3Ny9`v6MTiL2VE4bi0kL4{qP@
z;Rwr}%RC?2_OcP{pGUaR25!r}6aLu6cA6jid|_+S9}&KP<KRr)Y2HY72UzyQhY<F2
zXDQ(;c<50k9ue_5{AUI5(%>_{`g@Rp{0)RKkL7}GcpprYBE<Fh@!+9{o&Ul(0Rj5H
z9UB(-fW7VkZRj8YuI^sQ_x?ULNBd5%-MLTx@C^Ooy}2X(j|~yIC7KFqc)6*DY^^JX
z8Rm+nu<th+d~qGllCHTkz8Hvj+}QQgL1@G$HIXF$xeRYyEddwYw3i=K3fxN<#W02B
z_>$~&h@`0x_o@u(jS}8J^I;<e>^MQGfbIC~1fS>qph*3`(#f+4v+s}s@4DikzB)Fn
zpW4|#Kd=v^tz;Y*kj?I#-)H=@Gp!)~oO?^n0kA3KLy2(w2X}%K!9T#t$|Svf1|Qdt
zspeMu+7H+VqkJBQaS@Sc>k%h6o4#7sUI;KTutEVIv3)w=617-*fJoB=_R{_J@umCy
zzwP*hWOOj=n*b&5y^{a%C1zLm`%3@$;%H#CS=*vtyZ}G0Uh-e}0Tp9PN-M+o`H;Mj
zZt2Ml5%DC~e-k7|72>7cCeU^A($B|pP(y8hyOkH@w0p(#NI@U~2OrHuQ-Qv*!ai9g
z@4oGmkI=vY>%y1iX1+TN-^m8pCWBr5K!NRG%6witFnn&n%hxtEG8zzmKj1&ztDleQ
zBf=}m>Ld64TY`K7PnK7GKjr)b^h6Db!wdfyzP>wu{r(HEf0fhtLDkj(?${wb7I)B)
z4+!5km(R_HrFF|c@LPgSf%s4owZGFjZv=Y+RRTK)r1Zh>UCD9(^LP#<Vgx6Sz#-Sx
zL(^sj#}VJ~7n}JY^#cwEWN?7Ifd5>XzvhlyyvZL0942z`$eU@!Aik!^yM499YnwNl
z_?cMmYY?}4aiqaG{L%8LdAIWFaDd@4eW7kYFhCNcwIUPK%lu7qNMeZ;yqMKLml!<g
z332uls|zd`V@7QZKg%5m6aFv4Mt37&N3KHO_|5~+m=K?U^h5|x4L5Qo=)ig+1Sk1$
zC=8ZEOcMS-`1Qe51N*>oHQ)oX6X$*|Xz?3h32lMzM{kDw2={^4DPMg#{0(eLIbj}t
z@e|^2f=)ID0Fgdcq=Dhz4xzFdz)8OV*#aBKz<*&(&Pn|+d1_>)8P_(zVa-q)eTWGB
z@!kdIK=gnn4~>A|=bx+~I*fq{!SJMr{3jvAb1=CUTx4z5#rDEPPigBwi_h2Y`-uOn
z>en^bi1<Pf`^;YaQX24k#~}EByg~9p8#b=xJiW#Am{>s4_A~5{h{SSD%zl@I=(6rT
zE}kQNeX-T?T_XrCjx&~j!<;27Ibp@|bq?xyu4uoB)>sxF@Im3Iwe^II?1*VDJb}J?
z@sr2+PGJF^vC%<&j|%u^`an#&fc33I0r53M2ZJ@hgb;uHVIK$okKx+x$URS(ZtHIa
z|1a#Fb_OQBtN*LQ71!E7{jd3DS*C!P%i#@k-Us#POT_oyToV2HfG^!<lfS}ufh5Pn
z{EM==WJc~pW?)XIkeiYD1LnyC>k2~tk@Q9)Y)LRm+wj1Tdi@{xAc9YUxz7nsHWWCX
zpdr?D4IA(_bqMu=HI488`GfS!<gw6IX80k%mslMU8(?&&uw2*y$F1o--~mC(d&qT-
z8C9M;05UyWm#`on5YVe{=%37Wd*U^{;pX4zPj-g*XrC2=Yk>Qdj3$c(*@bl6e;I!S
z-YZ|yT1m5RD{-TZAs6S;>=M3bkv<02X*X>p;Dz$m+{k(#Hkvpg7j--)e}t;c-$&vp
zP<nLBhf?4G85>XW3{u;q^K6d>nETahf=&WIS)N*?f*0asl>n`eg4ZV>U~Nnwmp*N!
z<(DgQV3V6=2|Jb(lX!(Mz0M#xxUFiTBNLC~c0m>jpM+iA%#}dl>+us&-NrG<_>h`s
zFHwMs)rd$h@tSPLVQU?l>)+rb-F>dSSMtsOjMxwi&)J({Rnd=0Ysqwf_{<Uy8`TaW
z+~F)V96As0A@=F=5VqJb6g22~G5EYVo~psox^<MK*tq}VzoP;TID_q+AMSKERW_|W
z3GSDKKLPEhFR|k@PO&?D(I!AnrnlG#t<$f+z76%S*1hZz8rI}~|A)jwD}-fZrF%x;
zjd_5=CYh%<ggr;auK2GtJVEb|e+UShz<y;BCSQu+uNgLQ;uN3Yfvf8gJ+Jz6;U61}
zfP?k|-fq{M`GX$GnwkCn71;s**}Fvt8K?sqnMV*8yc_lN1cUKgd*L4dDD_WE|4@;~
zdO#!F(tCiy?d21%_yOHbkQ1DYRH$%2@el$4{ac3)ZSfn&HpNMJ0hT6z`6F4h#~B&C
zwx4_zbT(g9J@OMwk)w|TCQSY8SbR<au`IAKG>pEf&%!#K00i4UoOoci1CP~#9+O;m
zKwt5Yo4|?(`|#5d{yo{0q{~YISFGT6ihy`<&Si-467dsIk0f+qu9v!A5W>cYcwp6O
z79LIz<xw0Qv{tuA!|G-Td2W{b)m%>mnvXpKj}Lu|;T~b(=FlN}J@elGx)t$o@+L+&
zIZYJ602E#n?4Tm`9lkmitmC*nn=skO5U~Db$Kx-D!k++@u9MpN;(-bDK798Sb@t<C
zj#%lA_s><rJwic-#x5O1tP(UjC6)15U&G(H6MjEVAb%Z^q7U&?77t>0`m(hL8o?3-
z-%C13`kHu3R0$GZiLlonFo4pqKZ~pn#m_D&A^7+hs&&Q1{`t6PNr8-A$)W$B1U}s_
z%hzWKJ%DeY7E9{?i;UM>A>Z!*05`9qU)Qmk>ts9q-uWXASNug5A401`eUl#Pu@Q1x
z9>y7lC*mgKfQ7t7-5Bde3L%e73~pNonK@v2i_0cooXK_+Py;h{G`;VHURrDAzrnXG
zsX2Za=HBL7(cnOPjK7MqnZ(QNvdYF)#BtLlGU2woLW$S=ns6kbKKQ=?ILgmKf5ZU4
zxhTkd|Bz_D@++@F_|7&}0DCR`Nk9?i=Rj8Zak!8FJzsrEC;mZ-UHL2jkbmgk_goq&
z;raak$&F26dAQo-<M*P&X>xMQCpKSS1yaMo6T^x<uL2**`ux5#Uze=c_vXOL<=#o7
zQ7(ci6Cb^!L%~19!6Qc0SVYK?_IZDC>21?<Mh-dEH^pfSccJkTO(H@eL*<eN5|G4i
zB)XguynZKwxpT)J7%}5Y{otUU0LA*TA6NhW22K0K=4P1oAN6Ad5gXwtVc6SFUTw77
zCpJ+70zv2vqIm5{AR-o{E@1zHySp9WIla&y>zRCH2fqm6iE$2D3N3#E2cz}O60`)l
zSwmNZ9JpROnoj-SEHv1XE;H|hd<j=Wg02MLkNsduFxAu^0<gG`@h~KM9P6;V#?5#J
z?$3Y0M~luFCc++o*uMBv9vZ`wtjrEKkz!;Sb%rBr1N=^h_s``g2=ifwl(IgUuxI2K
zk9&WA@t-9aFay{EEBJ}tz7n{0=>j0BBOhkf`}p|CH*A&Otk$!zotBMDwGNDc_gENr
zrzf4`9_7a0@pCSAgWdy_{<e$${|vh4U0&SiqiSG9P24$C-g$VNk5V8Z_ghcrSe|bH
zPx;7s;_wk~qzB^s#Ba=hIwWmODPrc2e<qRIKzE!CZ~S)vVSY_LZyAm3gYP&%!~lfV
z`H|mvWm}3S^#jf_l>>wH{l{MNPV^7;-4;mkIsE_0>_eA)BUd-c^zOrCP9meDUU+F-
z*kM=Wz5n~;@wVCzEM_u(+R4?&^J_00or!iBmgmdOsEfyWxqkHHF%OK}T6P9_Ne?i9
zqWrzKmlMwlCRGM}O*(k_hECBuJ*`8%2y6d_P5%YAVea&B^m@i_fAL-dE9mbThT(l~
z^`PR@9}x&xZPxS7Z??na<D<)FoS{1qMsE4vx-v{ld{>U}wXON)!aN`7hi(dZ6RXEz
zxNih#Gz}~W<d38AxOD#j09-nM;VJ`3s|@_{-x+H%8L<pT)Gtthny83f70^QTf0^gS
z^=77gWKo0F?)#(gortfE-c$ex5HJpin%G^4_xM5seG^dISAcqJ)q&)2VERGsTmt^#
z?M?>K2l96qdZ<4U`J|%ba1?JfrD)~7PdDF)fX}qzK7AuofVPx<4P%1%aSYEP^*drB
z<<Jm!J)go@rBAQ;x<Qso)Lv)`xt1Jqo8B+gh=t{cBKqVGEh%gqMfER{+L#;$H-z}g
zec{Id8n~?ZyYK%jNd-IGNih`+xi9VUF?<{q+E~v4TWN@W1xphJ7!hWlI0kp+qhL=l
zB_l0=d?VWcak3g0Ob5Jirg0sV@~gEeOJFSj!7rlMFbzI&8|Od{ypgros-x7=l|LWi
zElu(_GfU=;zJU6w8S8)YRoVDLTw^pjP#U@aCke<Re?)A0B63X3f0lrz=Sof@#>%<j
zVMYCKfBy;GXE~#tE~|{<KNp8-i$j1&2(ZNRS{cr}KL~qcL5$>-eE;N-<J$+EBjtxI
zDriFS*#rfa*mz;8e7t`trS4fwwR~Wa;Y{a_s7JeX%h(>3j2s78WixIO_<&n1Y_`X8
zqj@-uuH|o>*sl7|+z=m+ssIF9#M8QsPyBAD8Jwa5Lyv@}O5T;`;UCpBd7?OC|G#fs
zR<iNKJN`O7HP(txLCpc<X1Sy0&KJT`K|Yz1{x8p|+>40G&1vbAgrtKi>Q)QK)s>Gt
zGs2|dICpb_SIESixH~}5&%!oTnq6hw7joX?HwJTY=>V7Y7alM8bv~~k?C{#+c1DIe
zGJL$=9iE;u!#jZO*`&5ZV}p}O+|<Ul6z-J`!PgVW@-b{gTzEiob4OD!pwRu(cD_z|
zFuYGx?UwU%SwHS`ip&(wxUNVOZin!f9I3FfG_CPISx2UfiTmz18K{h_$r~7dH+0^g
zmz>dI;`mLVT(C5PR&v|-4fUIZ56M&o9t7T5(!EK-azmOlOm7nfoZOiVaeglx00<JW
zJqDKqCyc}JP6@z-eY_<Ns0ek9=h8JU_c6tP#a#deUVVWcwb{Z$n2R0?eT|Io?Sj#h
z_rJYYHD@#ln%w?hhP74A+6h$X@tzsv4%{p_))ok~VA*oZH`e;?csLLIXQ53{$>!Xr
zP)O0-upw&kfEMU?bbnZxc%B__;XmWMMoPjTSMNT46U!>jBUQpR&G>KBopm^m#%<2Y
z{r@B=YS3i6yWtu7S<H|y8@)Q_@Rf&Fc+WR$AF#?0d`0X5^ThLKRRV9zIe01X+*lHX
z1U-CeGwjqrfC|6>8@+sIwyI>r{8mP|{Oh5@MjKcXu-7<2Qw$^Tl0y^1NO-!vbHecj
z^3a{h249mWOAcZo{%g;(b7KJz8H5l^)waA8;Ufd^5bPUCZGn7b{V!AN-W>LqySiEN
z<@0z##i;O(5$AIRtpLii<e*0Ny~eB^9i4Hc-EFQ3GR0BKcMpul#F35&eHiy3Ja5|Q
zdG6r@^nJ6R-p*zJf>)%T3UMoT`j$&X)orZrt1LS^1a-2wgtPTrXNNBEKSF-ZsdQQB
z60@V*2q*GN^6tOJduym9Xx@Mmet`6wQ2~L1HlfS*7kU498qW8}{qu7~xJZrgggeOJ
zuMPTD4Az<P+mgzZ_xz#*we=7s!Ny~*OCg6<_>J&~JS5M@wD6{_jf~-|B@SNl!h4;E
zV1~jA85<uoZlj^vXnIUOH&&{#PG-dBwCwUgkEV5qTF-dj=NLcLM6Yl0JXU?E!HQ^;
zGvKoc7&<V}u(-#xJ1%Y#fJ^qj2i>DzedYfL+`A)1rhMFRNaMIEswED|z|*xegcE<L
zprTocn}v0%;ZF_9;%tJ|-WCA?@vKwD8a2S8V<B&!m&fz3a)t%}h^2>l7aOfWjp;6Q
zu0$oo{<iYgjsjS1Yb(f~<Gu+VX9p6UqiV7BAEn-)6)sxp4-v^SMZ+zIJ`nQw@rAhO
zhn~yLwqQa*cyGJH9BImnzr1cK3ibYHj+r6hA<Q<dQtg+C%K@D}Y0t$&dkPQHEI@Ch
zNg#Q;mxbd#Xg+41u9nG&7H>CaOVV=u_sj_Yi2NZ$_Bo}RG}w>HwqXHNN5Xt}PahdD
zamgbRF)s;rNA&KvO2sn6mm|1}*y(dVG?XVIcpyGWuyhLthgC0pWSi@cwUI7=MDjxs
z`MEJKB}p$4pOTSw*5g#Z5cOb&<?Ego&6@!e$*WMJ_|CzA$Dvt(IQ2sK-EH$2@K(F`
zE&l|!!p3u&J<*wbKO#OSUbThMvH!zX^VsE5p_$k3hx`@g??YqUm>pY+sTg~(!7kfs
z;~0r}&>}Gyg81G%wT>Kh%`k#<8+=ThRPvjk9b2wTAb3z-E;)D5>o|{ucew~Ck}Rxf
zhVvF+EA1=@b8}3w1zc7(GqP!j%{Vwqlbq9G9&CKf6MJoLC;mGtB$=LfI1fkB$98kv
z*Ujh0+Tk1|VCdl9uEpJ`avTg1wGU+oC4`(m{_sDJG5_$MSd$ytY{CnFh>l!%j;J{9
zKNXYe%Mrz9gv>=pB8)(i@yu_8=_g8U$%*)knU3Sn4+Rs;w8EG`d*iEQ2wnh?ZLidu
zEIQ8^oXQA8P7$y0jF3f3C4-<too0a0$(T6Uf5pU2!;W72wvm$Sl2h-5Zg+_nagmpN
zJ6yrX7l&6UhA12oS+)1@w9#|?i{<U@i@N$Nan#4?GN7O0=l}j02i^B0G~o_Ep^@SI
zCvT-76O~qT-KtA(7P1rKCh^>OFQ`bvDhEQP4qh@Hg)vC%!a6x)q*0+`|Gmg<|M%SI
zHoVn&GtDod#CL1tg@|8-CXnpX90JV6v>e>LniSu}U*_%|UBfcv4?qQB2CsZ$2jVzK
zyM&G_x*>clj#O6;>T8514Ij_Oga^=h{qti~{7awkb-@Kgv(OT~B-kLvgKC?|ypD-)
zs|OkzZ%_PfG(0Y*ElcE~xW<`0H+6%VNPMhn7!Sc8-2$LTr~8RMhxhJ$QFjNfPcvL2
z!&5fdAwnF?zSgknE))NV_2g|BRZ+2)`g@>V=kstyd+_+IjG@8C4miX_LVP&o`7%x_
z+~%vY9l~&*^s&En5FSW+c-k4W6y=#SsdzA^9)KQ5i{sv8O9LJwy7~o%CnLmW|BV^0
zNx2gIPl%I}F)PPR_>$Z;`(V?X89Dw5Y6OkSaQ$}qCbxnD8@gS6#)lRVlVxyt_>6ZE
z95Q&1wx8WP#6(x2E=i{-kGxNaHe{tkpA!XK*S8bPp-RKz^SIyv#$!Gfh?eGj@EZ}X
zNbY}eADc|9;a(#)<dk-D7nWVm!toe$n;rlHQ*7#fCaPOU1hHVvxPbThU<iKdPUT)6
zc1z!z{}smLHbWtfBMfq5`EvJL-*TTgjL8IYP5vVcb7tFT<>8AC5#_g&f$AX|!<1E|
zgjFt(s0BeuQj{oCloU8$bI_T{4Tch=v<jx?p(Lk~VZHIeTX2aM^@1rn=tw0cP`d|=
z58b`LydrL&j#-$kV?fZX0#f%#_C?)wdOpgz;XZ9~ex<tXA+wSGzndkhhmk#*!lZmt
z2y84ds=RZbADxHnM`;|>2B+1mb&kL>7mhk-#~_khD_iTf`s+)`ExZ-lXS%r>Lz1L-
zzIy2>CB!PWR+!PGcpL~+UYgx&zSdN>4p%y67Mz+%ZoVo+1%|n6=wdITk_NRu79;?*
zf;57&T!z;x5;{cEq=ikGL)5Av2v278m5)<^Gdtw_#ljp^%OS&3zgn9N74D|IvtysY
zWhW5P5yvoyo8vworFrqKr2qiK+caQq1lA~p-?v|q6WZwp<E%|Kq2tnX^trk|_s#c@
zG5554rLVL<^fz8O6JetNr7)O~jvjd_y49pz`L1+@-AnG}XjWERwIvuN=1*erMz(HB
z7r_b0=29QB^Fgds1x~6eIgsp<LV$1~8qXiy|NsATZy^{chU6ds04SiMlm}~)o<%Zx
z>Z<&4J0a$_RhH_C(jb?Rbx5fDGFxW4t<@J#1HOa!*XpK-m)-b23Y_ky?bTYO*VLRC
zY_8oazmlHF;mIt(KLsrz4P4jC;zU7pjV16-UaRJt=}A}-F$f2~X!U-F*ibitwahd$
z?NZfTl$2ib6I%a3(XxKV`$p-L`nP3nCOnPtHqucDCi72OQrG$doyad$By>Zl+bMfb
zT6uT-P2*ytQ^+mK3(rdVNAl2q{Fi0CrI3?V^71l2MR#_dn44a!QiVUT`{Z0HaNVK-
zO5p}_b{J*JqT*yDL~Y3c002=zMJNVaOb3a?r${0Vn>WpQl*Fc<a5vKc+(0A0Zhg&V
z#tM;gl^mZHvvC=FSzn<csch&iLo%qPk+@v~rKxCQ<)>QhXatfRCt`WGFbd8<^9qFs
zsU@JvUL!QG(?QRKcs<1ngAj1b^i3rTe;XslX|$Tpu@(<nyM`-AgHA%kT@Z1x`geym
z!T~z5Eg&nwg3hMl8fv3%A|j`)(>3Aa_yu*C<t|TAR@Q1O6@MDww9~g+4J>c2TfZC^
zmA*M=n|*FwtAGFiLQO%NKw1y+_!>OcwzzVA8+Tf*6pDPwvz`=!c7V#;$uxRslRlL%
zCw*0h!yW^|O&C9*<ICw)nK+rhY{@!)D=JpjjDX%Ue~AD8iR9*+P#(DZ0}Z)aKabNL
z{|rQb|NrLY-~a#r{%<eD%cy(5O{ej83PTb2SF1RFO*&`dst~eD8`?aV{xb_$65Z5)
z=F-5UPo`jJEPS{|&aY5_Kim=z0Xp!D14YBZ>{Lcbi;i5&W0x^7l-)_>$!b#~vW@gi
zfj<Pb346LNH<++i7#eQ5&%2bx^+)j%C3Z-qx<7MC`iR6tYm3x#J@4^&*wfX{bZ!^n
z91yg<*c<hjda=CDl!DOtojezxb>F}78*x78$6j0h3bm6Q%a=wb8;7mqJSleZUD5)t
z$b0wh_$0%~dx0wjsapdlrTL-6AglxTe{k$)Hb~ID%pr_!pS}{d*NenLywgMbnjggU
zGN`!JmMSAACK=?K9q}16V=2oYgt6_0paSrmEN6bWM%dVpLrA7^(`my3)+7A111uQp
z@mI7{@qv^1Zxovk0G|lq-Z9URT0Q46h$eWUPYTS%hrMSQJq!0jihq6ozrsCMwSbv*
z9@rAJQMdjx1fDn60HfC1K`RM*KfpWx2^=o*qY^%v@t7j;8SVrvZPhpp6h7JgwNrp>
z)kpEzlEqLe_$jtMD9Q*e7*0|3ATNIZRbiiN^tTv87s*`8c#&`-Zl~{o6KrnE;_>YC
z4!GneEJoryMi%bL%MZ(`yCM*XiKk<8uXv7K)*>T66{bYmkka#UURcI}0^j}gjNA84
zo$|{_X3eo&yGcZGFp=s4_O9oqaEbAoOt2zvk@x=PN$`%ftzpz#pd{Qs-L_koj>1M8
z7!xr3N)FX(WA^#L0K5N))~IB#z0(9cq;NkG!}<zj&jtDrJs;+F&;WP-BOA#aoxO$S
z&>LpoC2+y3Ul&$UfIw~MQX(S?@iatvRP2VX_1tjV@b@-D5*Xiz>R}Q`{3GETfxfDO
zW{Z>?g9VAK36?i%!1MG6;Yyr9TyTZ(H=NRrA6@9U7D#$9iT-+919DTRd{)TaXox#B
zWHEtw*!Un`aEFGFf)0Y|rxL;j``@Y;0@~yy{ABSyF1*E<fB4uUIu*vq7lf@+q8Xh3
zmP3tL{8b!~$1Zooagm?Eqgph_%gZvDh~X-Bt2ySEB<;<<Sb7lbQ#S;<OqN-xp>odW
z$4We;eGZQWSi_OIbbs#fmo{&%`ZBgKY0XoNLS`dWuqJPe>KlbE&@VYN0vsh)an<Q$
z<3%Q)e77t{q9Ss@uv~BtooD|Q)FfeB0v6qrJG%wty#ItDI}aF<wsuI`_h)_TZV<3%
z)ziEG84c8y(7f(Np07HZIy~{d$Ui5YtXCE0?NH}u$4LV<WV;)c_y71q9nz{E?<Sw_
zPHfCY{AW-i{0CbC76Eu|!Jj8=2~_eIhffu_GJ&dkUHjj5%0J;N4ZuL`5?8_>g93pI
z(%mnsUMJS5W{S_AP9q-$4@zVwg2epNBE~Q;lF|y-mPlKM;xJngmxMRIlhw0B!k9$E
zN(fj%M>URW9-uE*oM?Ag6Fpb|STWgbJZmFX6Jw7V@Cm=ugzzOA9IGG#PlyjY1Pw0~
zS%gsgXZL<1FBj$QvB1j@2}vecKZmYJiR*vvJ#|X}ynXtlJvlm;)xQU_#z||MiG-8*
z>AfaLf5UA@{MCG%oCdwJ*AW8FxC7E_YyZcdd^WqA;qRy*4|4a)|C<<${t~|JWB9Gi
zMuwG)u*7#a(G!x!@<+t;`g!aTpN9LIQNF}?88&@zh2{^E<cFE)Cx|3^WMj<A^~6L<
z?|k?driFcc1HXy!`!CGY{N6orcg|?(9}|yJ2j^b+N6ey$6490q-*$&gdhc03i|s2S
z!}ksKme^(E>hwfKUNdZi)o_-|^9BPMjPRUhbNqRHN1f+pom2C6$43W@>No%sC50>z
zcxbUp0vmB=cia9Gpm^v(fdfsWC-AUMDdgwP&kN%6#!b7|32jFV=JIcdhqpKfzV@d6
zCc_#N4l&5VjIv1+65^&<a99u%?@NE>^)jnFvRmfGYNmW<f(<vkgxT+ZT4=sjk35Xf
z8SH@E1)aYO!aQbI+89OmN0%`izBFNS^4W&LzbuL*NPb=_%Xq|R^6szVd3^i)n0A@`
zP2vL|93C6p9q@#7Tn`AjEVQMOad(5}WM%SUE(_WGA*9)mxHPbs9q5=Jo3Js-ekUMk
zXdE;s+v}4~MsWfwgm$3|7dBY)QwQc?O5Z{M`EQShbEUDGj1+76UfpodDWU^{FEgxP
z5i?m>W;h<LHD?4LbrApY-fU_%OKK#(Zw;Zr`0pMT1QU6CiTXR7V}GcB^03azI5s3U
zfZIF#-fZxXgCr11{5LC#0}#C*MrpTB_wVGQWi0$$aM?>TOgytcCz>AVUHn!$B)K=P
z64@0CVP$^_%MZrTD;Io4vj|wG+EfJGg4tU?9U-)Ov7!Q&m>FIEY)@k%JUhzIlk@Rh
zZgcZIoL8DOQLlKrb3J9W5Dmx^5c>f3E;FI1&C22Fc04z&1dQ(p`p5M%2Z#N_MuJ3$
zgB#wp{+C~jq>=z3QEI@THWHtezxUE>$auy*tj0uVh{i-=jwY+nCs~-FP0!0PmN#<<
zYlJT;_6IES@G{Zvhrx1STfxPDE*MFO?9Y-iaPZQ&_)9AVhcsqkanap0uoKc8GrPFf
z%1$zehnhA^W^I>U$YL{s<u3(LNYLWEF=TzA!4Hk;EDw7-zA_PacU*=@lzV(be7E{R
zz7KJO+?-#BZ4?sGvEn~`xhDzaOGK@HK4dRg>5^;thStoB&F20)!?V-`pS#UlhZ4UI
ztnB)lT@oXt{}!x5E;G%Fu-Ljlqr+~Nh8*hzdW!JR3eWdR_XQr0dG-BsSZ7ez<&p=5
z67E(;ZYsN;5y&7bK<0(p53WiZR9iO*%*W?z;TY+-Abys8YR7#yI5b_EuwLOCP}civ
z7f*vSUkY)df2<TN$j~}BYSx@}!WIh(X7Yj(!T>YBb{+^kC1(qb27v@m7)1^NOOU4a
z!`7L@1L7mqPSELXPU3!{cc<YFGb>e>TGTUGtSk5_%F-}FX!qm|ezl!6kH~r}o^x+|
zj|tM8)wv?ymt<tWisrm`Pv!BWI|h8x`jz6jICk$pg!G{w-S8t$Q?<lwaQ}II9GoRI
zQb9}qza-ZQ%KIB3(Yv9t7scgX8dlHh#l!JGBr|0_CWzdAcy%<~!qTsVBj-uwC-gF6
zaXs|bA@n%op$8#pwAtn196QnhBVLCeM?X#zHq$`N9rWX~=asq7#O3I(JoxXo*9h&f
zlCYXFqf6Ka-DB&nUFJghwGY4nA+~fkik**o`FL?Y^<W7<1X&V5A%5e?!^U7U*QLG<
zqUh;@XPyPclm>a3OXUbB|8l%SfAP_va1u3U-GK}8TJQV2rYa?w36SaM@JWQM5ez}K
zfZTZOaj?n=Ee!L&0q*}ie$e+HKYO<r0B_44vwy~44aXWb#`cVi+-^(Q&DT!iE`!@W
zaXpmJvCP0U<;?v2Mo4U?NfE|mH6f000dP&_=Z*vg{ldEWFoC1;$44f-2vrv3=8S?r
z0&#p#9~n3iUtz8)Sq#;Hd?asIgmMCdYp;Q@8AKu$rM0+2c9{HBpcs8TuM7tS2SdG#
z$wcwQm)zUq@zJjW<GAS0ES=2D26xH57rtryUnux-4GL^sk(UG~f}24jJHU8hWf>LO
zqc}7l)(qAC!r-g9_;x3aJOg)vBc(59qKWx<t|Fc#28axheg_ZM>G<rEK*TR+dd7s4
zxY_CFBi^|qd!bO!FC=q2r+kzC4R}KIMWitbcV%s|5zA#9HZ|ts{6j#qU?2?~)tp*I
zX@nKPAN*y202RZhOMMh1OF+Lf<Xf#IIoi$GXn?z31%3$|w}LfWPw{bh=e&7Xd?7rf
zfy86SeQ?jR44)U02)j*J7ma1wa)}JQlM0>|2jzyhA$JmHq*M4xJcTKy`G_8tJZH)g
zu}#4nJG;LTmiPeQ@(2sUPULt-rC2~<Nbitt`uGI;`Oo$OM}_QfYXRDmoDwpXz`qDc
zeWjay{VspR)M@@<{i$k9Ab^l<tp)jri}?_ZaZ>U-<NU|wv<CGp{9J9)!?tkd1o@%j
z_+u;&N|qX#hFxGWw5OZGJ%kb93Sq0M+fM<u(7OnU<m1H0GOxcD>Bp0s2w6khu*2(v
z?)&kTY>*?gz1$J7CC|~UhQR$ZaY3{`ca9E;p9JXfl`?13JZOJZy@BhF`-@}F>*zrX
z4}B^|_lEeasGvl~EeT}G2$hQb0B!e2WuE!GGYBA_633$K`jl)yiN|I^9Kl3)tH}=x
zL<ontu2ZgLIv>Jw2sWE!J^&NX4+u&zdI83lyKRvvxh$iG%0}jm8A65e8V3wk-<V4;
z>ysohaGcYkL&^Xz;U5mu7W$LO^s-em<*Pxz*Cra>pTc+*5ngyvGF&C9Zzm5{>hbi8
zFH|~o*9goI1OzWq4|pMHbY3t)z%Bk4*Z{!Q_xSpLmQsU<3Uk*L>ghCUpYQRT?_P0}
zY6$+susbcO=^I{+)*<-3e$lFafBZ)SeY^FDx<fSq74w55ZXn^s|Kc}qq65*tZ|*_{
z;9UGihzfd+3~dzi8)xP}6A?(oLKbQDx5D@c*ZlAv{mYwoo-?F%KAl_${hB6l9yt;1
z6Xd1k{w}qxsvYApJy;w6Me9ZM<Hl-;2z>#*tuw;5=bh<P0@um@S8{kTmt9ZQ{<l~{
z+a{d2vb<+f1OYPOh8bW**U*XQGl2Ab^R)yoLm6JLm;Jb!qlxSHW8xrt>MNf6)u@bo
zGa>TEM_n)G$3sXGH4X);PaTAN9uc!&L-^%g^c24NBX#b63fB`In%*Kru<eKWcwrU`
z@QxaR;RzYt78;U<p|n9G%<`$-c~c78{k7vJT)8M8!dwHe1-Dn)((^GgyAQU2jjMVz
z%b!j2eAXyFXYMv-_rg@1|0hAb8~2?}wZ-GYXWsr0r(ACD=ZyTb!ioGN;FrK^ioi<O
z0k(1vzyTqlmVVcX)#E(~az9!iU!T<iO_fpS^4q`M*hrFF;VjVS5LSocWe5!HNT!LU
z&DjSmza5ND5XG=ki0=Q9_20&6OoZ^*&1^J58_lC5V>TCy@ik~Rv0_xRa^%BOzX)Id
zIdIN2_>c#}Hr~RAw(tnqdJn_Q83+DL|8oGxSLkuM!>`o7_7D6=0TK3qf2eH!mHv<;
z@xM?R?V}$^8izaoy7HlCe|+2{_BZ1BXaN0xapBf=h>MpGPSE$insNy1N5soo(6yud
z(9*`I{9g~U)I4RN$;H=~;ig)Cxj%DF{6-tm*|k=1-{l!MG@!77H~tTwH-t7&&GW|e
zunE5@J@OB3y&Cs_#cnmf!hXJ`zTFUg9qE@9M0jw`#{{e$o2oAzP|Uf5@eW}$OxPZ%
z@AeYneaXo|mR9}r7;z|%COMbzRoMN3kH<qh!ziH=M5~V0gwKr9<?B24>Y=->QV15c
z=CITWT89$UAP;}IM$Yc<Kz{hC8JU+>RNo~-4cPck69n9SH=@Qze+X=Hb;aYyeU6z4
zU*dV=mveDY^33tkio+x6p5fHa|HsFOIR;RjRhz~A>Yyh5AG?F7Y3O%!c<O+euRjlX
zPlcs%0Y(8y_Jgv!Ke6TaStEQSje~-TbnCXj&V1+E00ymcT!_CnEKU;lsZ#zkH;+gF
zGJgK6{>Ctq4gPgyv1UxBkj?uvjp28?r1AF0O>$j85Rtx`&{-w_gftFB+?u6wEJQbR
zn&9QObf{K~d{$_OX^;l7Fs7XN%k#)21aDjEs30^y{QQ`Z5$@#oRrdgs`aZ`X^jih~
zJKzlM*L}SS<aen6HUF!0p47EAH4O3Tjf?x>qr<UdN^slFO;I`ULBkCSavhW;-d=b4
z+Px;5kC$1;;yML!_ykSzDe-zbAMRlHGO`!0Tff9&6`I5ocleKT5)ZP<{MvpZu0;>4
zzI+TP(cuq`Zm!;J;*60!U*hbPHiQhQmzp@x^SyEK2YQkL`bBee1M&ax2@P@&&U6;g
z9-a7~f5u~DJv_~XbZ|c}j89((yK{fI;dc1FbOYokQswwZs7S>)aFLzR6FGQo?NA@-
zc+T}$<IWGpXMqi%J?s1?co!Cs$qWPKp!buLrjb7+<f*rOPCa*M>O5D3t>QGbY(x*k
z=AJW%-iOTE2;hOToW0cM?c<KbP0K%vFc<o3jPW{e>gP2Pa^l<`aGY#udR%C0L^U^O
zTqih;kT{FcGWR-J6wAqAfSa?a)eIjI!6WAP`vJBWQQl!M6K*{bnSUT)Z2Xe4wJ}4}
z@pHn%PHBE4bcc>>mfOwv#t)EuY-fZ#BKLuF<Ls>BCh#oynZ6wt^h?}-5zSTuisGwK
z6+CAt){EN$VNDPu{5YL}b$HJ*`*iSJBb0Omjqo4hX?{R!a)1~9uZP9*0Cz{ACK6m|
z-2K0#2c#eUz((CYKfh`*s=IK0xW5TF(7>6l*ofH&pneK`JkFqxa^!(KJ$74{^ugk0
z&NQ#(_n#5@c{%g(@Rz}thtt)V@kw|hd~etAQ4zI)uGjcZ?6j^ME0QJL!G-TZpPm2V
z4DSHN13T4kf2i97Trr=z5C4~U+y-a9L;K_W2o;bUbv$>3O*Dr9;0{1guZQCJZW<GN
zR(|SRKu=TtGjZ}qm_S6$c_48CrPmiYfoplAd?$GIS<G#GeU<p!o3)JTYvO)ByN#SX
zt5rF10T;VZc75n26Mkzm!O*;AVX()5@XYpGc9`DekHmBRDNJ_If@kLAd7_CL<(VVX
z2HZua9FfgB=CC=QX`hd#WsJi77M!mx%Lur*OPoNN7aW)F!+WTW@l@!OjAhp(i=lcD
zb_CicV?&F=9ua!L*z|p72GF8vnYIYav}5s_=*$9xRuTxlqej8)tQ4>BfhX?q<FpLP
zA=DTQ5$#K$KYtOV=xw3L)4)RhkN=EzqeL6+KyS+R&ESV`Bf(|~H9Ighuo|NK10ew$
zSlY~Hf4u*3?q|U|FSP%X5y^xic_z;0ib$W~J4?n#5}80Jd(Xt}CE=7Hr^mo|F3=xM
zG&A5Gu5?)hEzlqCk8Ey_|D_SN|CgAzaDV!|zsEd)hacj3;hrCgoHE8xz_p0r-pRPQ
zM=(GT>`D$1#^K>9xzhWC_<w||=?|MnmB^MEzr^tz+>8b0?=3p90{q)4c(d?d!W{&B
zp~)7q=i~05NYV4DD+J>EV2Ps*f!oj<_w=2!#&1su^q$FmR6(B-%#82??-S4c;Wv-)
zcDRhx%EoaYFE{wCVmHl@1{asl{9Zfl08PKXfRW~LTMq)9!4L5s(Cj39h%SEpQ~sB(
z2{7s|AbANY4(@C`Zv+n&REhGA9~~Xhe&Pp*{;BKd7)Osi;wQvKVm=9EI0$ng<^BlY
z1EioP`DBzbgcPnt$M0%D8J@q9`R?;m_z26dlljk+x_k?_AR)&$##fi{iMbni{~ek$
zgaYXI!;K383F5UO_OP0DFnKfA;w;~d4j04tPnvW1?wGDS!%+lg{Jz{GSTIlDJ;e8#
z?ETvwB=I~YWQpT5H-9&5aL>z6e+lu3&qP<7it!aPDTt|jBjXdCCdKapEH?6H+i{KM
zLH}jTViU(f3&42G4N|9fW?5eK@{E`KUfp0MZ-D<29Gwig@!AYdop6!cykpfYM1J!4
zkl!}OJTRzUJ5~k(8&?GW0wZy^tMBzs?$dp#JPg3#{cg}7zk@+Qyq>ruz>is90Us5^
zsow=SaR49^wSm_kpFf`a?1<#e^@xbTkuMS7cp!EGX9#r@!5nnUfgK}-$J$=y?HKpd
zk1uN0ucOEiZE7$i{h;^cUqBwuq);y>jI~DeK`RPXMK!-x^ozylE4LW<&5w+hxMzE_
zK3s`+lt=;I7)swCJ$lU)094-rd_8Ex@i)BJx>d(EKI3Bt@0z1Jb;r`$#3nV!AYTy<
z*8h#kt}0U)Z9HDFpriaoXi*H~<9Q~6;ID+aVVNyIHmB8wemk3((tAW3jW9prUbs#+
zk-|I=2~W?#2T=TitTvx8Bz{jPZS*1f<okVi$|v~vLfa|YHT;IWUK+s@Q%b=Jugy0e
zLJdhm4??r?*lP3yd7cZ>k3CRudQIcuR<G*&qr32*Ai2DVP;Y0%{MxGz!kUs1(7*|P
zzti=&1Uqr~VKKdQAP_%bTzpvxYtR?0tiSZ1ZG#T=!<cDgOvT*}e}@ye@Kb_afz1Io
z*z3;?`VJ3)Ptr!>BRDF{@P~lqnKs&_4glut9_-TB82BT&A4r!4>>xF8gb2Ka|DDns
z{{a(yKeIA7aDL7{5&d^XUMJjuy<}c9nnPw4p0G_Voum@)fY0}8Qz=OJ$>rAK67TSZ
zaKR$JcR!y}sAUrCbierdjGQM_NVTfw@x1)B={5HGw;H0Xml=-DYq}qwM-x54#}SPU
z9?=6Fnf#U;LIAgulNy}<Yf>1P`8&*Il9PhtGK^wmqIiM)f063Hqna^0xs|WayI*!G
zHkkRg7(~Iv7_iN+9Wq04<y|yKHMO5!@KNa7pF_?dTj4ms%Xrpkkv5CQYz?y_GA{s~
z>fL^n13%_Z`VZZ}6>Eq24UIv2f-|B10D-EiAD{P9@c`jB00@uOe_#Lb0R`k!A4EJ9
z_-O<n=qi81NlLEwLgDl3J*UJ=#PHNx5099<Fht=AxZVi12k3ZE@(D+t`e6g>$_0^q
z&GpFvi`{MCxtZ=k_;C0;hx$BcmQ-2P=R6=s`$699_Qv`546d|~{3nO_k<;ROsW-!q
zL~DxkV!S|6e)35z@m!gRM3<M7j_>!HN!TLp>tJEtT>md7Qo_0XlTIy8_Lm=5l-@HD
zxgktsIJl24Fg8zT@z*m@20X7qKDZ@*L)|>EKX4`9J=XtjOUkOSa?e~N-bENP2o7?}
zfx<@!;e(AA`i<to2M;;LVUG}QRy;-WZ_D^X8dh&0gsvXNW!|I^nUD0>AM<Ny518yX
z06$CQjlB3>!-}T0+r%xPH=-UZGcQJ|*TOz*Zdb<z1#DzryF)mSTvZg@zGh`#%XYMf
zL}EE%*ITj>uYJly5p!e2fJ!uMOk^(?V8q3?5NVq$TO6cecqztWTZzeSe49(*@mO)z
z#@ZJkBjq<ws0`30ZXIv;jpzdJ|A#X1iPHxU;Jf@nqrnU!<SopYIYRV=xQfCMmLXp8
z96&?mgw7R>Si(scXUWQD1XuiIg3xvZJ=7iRUT>7)19xmBUnKkno}>rk*Os#<-qO$U
zn;barHKbsGH}ys&&B+=PH`_k(@tg=AjluL4!4u$LN`+zFo$#$g;Efs<AW5-tTyRcq
zMC_1$?>i8uG?|hZkIif`WWfBsh;BgVHpxbAd(S_~W^DW?<8hfFz`~qW6sW0XJ3Ff5
z@R7YLsY8?Fz0_eZgN8t84|*@hW)KyR5c&cVWAv}_oNHn)KweqE0AGJ0Xba;ru*Q;H
zt3$v(3VZ<7s@fb^#Aiu($A_3-(lPOf$!H#W;olmKFyR^YR|ixlYK1!dcx)9$H=7<`
z?~d1t#9~R45%5*gp$SrBkpCgACu~b<<NLnhdR1=Tyk^}bKdOS?{V|)~(2jJyYhS7v
z-7nkmkkp|Rn4MZ*qh9^zzFxS(0-^A%fiug%5n%bm`WkPJ$l+K7ZO4Czo^1R?`wl1k
z*H{p{|Ae}tl@xX}#Y+xF46Lx%Exc&rJ|i!C(Jnt(chKh61uVZU?A$-x@RZQ$*hhq|
zUnI53tjytoE(&DNu0N@a#st2X?|-e2!X45=7H1@JvIEAQ+9?43=hGs#f7pCi2i(oY
z0UnxOc!}Rh+2DpR+(h$YoQ?i$dhN^mg#0#-3AJcH<H-zSVljN%QFqD6M3>^YA$eD=
za%Xai#C%o>-%X?~k8xBWeR5(u$ban0=ye`Db$=><6SbST|9~&*B1hB2H112DxS8|#
z(8&0Vc4lO(T>LA-b<Fu+t|nGs=z2#)8|2T;FU!WKGIu;SLb$ID^_2o7aWKYLbHi!!
z=?vwrYSCXNKCiA$M9}PKJ~CkLm5X6w8#wR5gzuyV{$L23+A_iFgNGHFD8Y6~Jl7@|
zgXTqe*o=2Cm##?S4muIn6CD$N8(f77M=J#C;&QDnj{+=`-<YjHd}L3ylks=953VQ1
zqYVd$4~W+^XdGOX#=m^jM!TS_$7Y6NWr)MPoTuN*c~8gkWQXo}OA))CD>9mN=3t!J
zgJqMEc<jOgAF!-5O!a@$ZhOj>PA9;ToRaVZ0p3ZAiPMguP^pz7bZ>~}=8Q))F-+7Z
za&U|Y8^;-aZs(6QX1wMl){*OqkBO|q6CE5PQ9OPpVYc$IBz)cu(DGRojq_0$&~ukj
zc$nqiJR!LkRGt~aFs~)#F_V)dKQ|vSiR6&P+xVJN+9Dd{&n6a|KZNk+e?Pu#Yb<{A
z>GpxXY#?By4&o724KK!UiN=>edNGtD8W~rNKCXnoyl8Crot#bhJ@$BdsjgV)h|sC5
zyd~zOaCA%n0brx#nmn9VZ>-h`{sz%6xYU#0BKVD&Wv&tYJr)IW>B_%?TSOq^OuqjK
z*fLj6FqqeRbj`vLmj_08!HPLC@&-W;kL-Hlz7Ux5VTp^BctaSg{C-}Jc~CKaUWIp-
zY)#@G?}Gjl#-@B~bCZNKr#FuX51>={u1votHf}sHQ*M4U9T{{dC3|x)bN5znz7yqQ
z*k(c@{xb~13J4f@Q+w2Rg-q<KGk-Y320X_7LBDGo5F6@c_zE>LUNf;kCjU;a07(B$
z{e(gu7fA3b)@t+|j03;>f5g}r3<j=5vyKX6&3EA&x4m;q`r#~s0vLetK%ItC_sm#o
z3CqnPqk`t)<VqUgk}xv;<>t-uaWv`Er#BOsnA&2tm$0}>Mr3C<woFIMAI8vtKNW$!
z62%=dmTao0gzB&(dN&(s;aU7Ub$~~>3x>*^1y2(pTtCS8qZdW-t;eQ+b<JR7)1!ue
zyqcbF@ocGDz~1wGXD-=(7vztOoFj;?Ug>z8$Wwnm^TcN6?G6YZlCaPE<fkd~!@@Xr
z29S|N@dJ6-BQi!rFE2v(5@(`o{~1KSq7T45opPE#Ebx_x#itLy2z}srcYA`sm-5MO
zMTz4xTYkTElLUVQ_WUE0s`#jzmx}%?4a#AWqK=vbN-{i@RTdytg$Z~n$Bd>P5b%e=
zHn783M~Kdcdf=}P!5g+Cpy|QYcKEq4nUe{hjMBx8-Yr&%gw8??MQ9S@tq>90wc>VT
z!^Q825%DFYT=6*d&Pa1&Ebm?C1T!*&Z}qR%xB49pK--z0BjkU``5#a5I7HzjPr?<)
zK`Til$!$QAypX?GZq65Y22;6q#-_Qg#|-~^Lxy>{?<OU?C32AQQ5bWH*iq3Dxzr2h
z+caQaSwvV3v1~;5<(asQ-Kf?X)yc$T#y>Pa8Lxt@H{nSLiqHqMtjq3<^7aRE6aq`*
zsa5Jm9xbhwv9`uuG#o#Jsk!5AHCZgcW&%Wg!`4Q!k=i-y8`|$}{2jXE$InIU1OmPg
zImkZr$UgML;wyrD&WWTpBJT@YTjF{A<~IHl#4PH{F(^siL%f&}W#F0vwWe!R8bvcm
zrfjYdv-ITnK+fzMjMg4)B1Q7?HU^xb09v<rHOE&pR;z6x2wQeoZo_O&-uz|hn57FD
zxx1o7^-R@lIef>DO@HzIL%W`*E!thCxQ{eV7w?*tgnk@|#d7cfL}+g*Bw%e8WY)LA
z>IZe$C1J1npM*JcFoR$~aT9pT_)0Wl+?S@f<ClVL;sp)O9S946d^n7}(YaspN*mY4
zLp=~Tt)Qdd_WGxZ{1j5cf=QnXHU9{GrIBSOV`fQ<ioy4$RHiCZGMq#clPfjiYZ6<=
zMAo=N8W96|vJR5gSPbTgb<N;oX`Dn?6C6RgO^#LMJNS=;Vb#IC2M6>A^u#m=x_G`?
z1Nvb8f*N>3GLJ0;G|NKLA@Lp~#D4_Tie|Mjq*F3wF|~1&*#@;5lV__uBPlGQ0JBs4
zCv4}~OT;wBZ^S-5jc|le#IuQ7mRa7V&3N~%X<Cg8NZBt4)hV+I&+ACYu#3JBwlM4^
zv}>?x!}U7Mn+XxHHQHb=!g1NJwD9icxwV-$%QT3WQ37C(jF13806+`@2r)Dql>zv3
ztv_IJ0ssO4U<g110Y!8q2P!mn*+@D2x_vnsX*X&ODhE+St5zHdw@CsMoPi^@4gf#^
zKnwv03m9+$00IDD2tZiC7zIT%G^kV~!A1b#Kfnk9gv9C*RSRvnh@xy93$il_^A3fm
z|FqyBjlBgThV}udhZeU$bO~GTYW23lNoW8FKah~ce{X>~SQ=i~7lT}X@1Ki^-xZM|
zzJxYls$jkMe~$C%^<`_0S|D0xrAU~Mj<=4O55)EL-n0c=k_eTEz{pM!!P+;nIvg_7
zeehKy`6VCNzFa4;FR#2EMw2%fEo2ci$!-hyRwP!HO?d?6((yHcH=+Jn`!1X@CdI_j
z$-9PONciR1I3(E1^wRQHbvKBd@8UjKcc(*55@UltOFDP+apcE4$%%W7h!^J2<5cmG
zw28cNpi?XJ?^+n2|9V8)iOGqmr;msDdQ+-$W+RGoHf%`Q&gS{ZS8hBCf8iUF88jK|
z8U!bH)U*68;7s-@zNnEuHfE<h^+J!_{qcD9UIiQ74McdDLVwLIB&atL%gYG-AsQ3F
z2LJ&AASk)+WW^dGwmVd-JpKS1$uYlSIcosbU|NY9kV|{-{lEixCO7D0DM%AH08+CK
z1n#we+84MbO;f<W#xMJnh)IY{!g7_^2_z9S4a`)qc2G{Vfiz&m3<IZ*9X<KtKp(<^
zL93iB0ki-F0Du*9aO@uAESXA%Iex=1BH#|xOjrjZ_S)lQ!}UOcP8R<3MSZ{eu2^zZ
z0t4<~&u)NRNti8#xz^{iGZL!?ARvM7{?MyvY`_ADm82e1ug}7KRkJgCp`nSyRwPVr
zp8)>yUSM^4)6HT_7&dQ7ClwD#r%(wRlQeRdtr%wS$3W=(UyT9;W;{XPJN!?_PZlpi
zpZKb3X3sMdF((z_r8COMxP46j;<tDPmuV?zW;~epsGGyd&3$|&X>p)mL8=Igl`rF}
zbK35Z;8a!oCn9WLXPR4drZPdV6*ogWIP~iCZ>~-?m-pm?8swT#I{W6?`8j!*4sj3w
z)-ndw2SXO6#UdgJq6md44-7D391@6J5NQwR@ev$CBt~TbAU|ma8*UDIq(HCo#QvK9
zyfDBA+&rYN%4g^NWJV*r-|$r`=am*bGwgynpM;#029croE4<<ZEYRzfj1uAm#f2t$
z8HOap-xINSdQ$QF0k}`#PgEES+ikDn<004Q5Lrk^%h8g{!FEYD>`0lta`IXS=9G~0
z=lQ&F6$#10EEcBuvuQJ2kbKPxKU`gdYMA3f#|QW=f!<7Oj~oWf-hsTFRxl;aoZ&aa
zNiOGq#bszfTS3hlG2usvWq65fCPT*0%|Tet*Ef${@RgBLKCkeGqB8KGS8lF;Tb39#
z;^PA?dIQf7j*=e^uCtru?&Z%B7jdI1xjMnizHV$9jqsjmEAa_@=<p(>yo^rNmtMF}
z4I;=<Is!i9GY2K+p$xG&oJWYnc#p(Ha%a#(qsD3&;sXx+`8Z0EBbf(j)yN=W9}4k1
z{1#JF8W{p@$!i7JL?}5B8-CL6_P5u*7~qMf712C2o>XZ>E*#_ki2NrqDxf_9n*2|W
zR%rK)?-9w4T=<L_@p#d&v2s?!*C%6tEtJ_4!FF*0wr8@g5@JPLzlgHAw%QL}Z-;6T
zuzv{v-XE`v*MD)*gG)U%9zE2ZIe+-rX#sLo1hm37m|CJ^;9)-LEJ@kajj%P${3G&M
znHNnTe+m{!kNV)AYQ*i~4GmN&9GQ2BcM+WYXD%6wNyhOxgOh0OH;E5pp1tNd|Ajbi
zq3;7yY%pr0AG{E}@wST>y~YSq6~KDHAT)OxKzt3vF>v7i@a6HmcQ_IYQkWVD1rk$`
z?UWGV`HI=ArGX3RA5O8B34h@~fAi1F4aEC*@p$KbB8vEoM-|#^-zz3ue>Q)DK3SB^
z&G8s=v+>KX{(9k=-2Nwo@$r+QV0C;}hHsEC8DaBtLHus8BOXcJ1lw(N59p^1hxNJ@
zIPB9$jw#SF4++PFzr(!VQ~|wpBsMk&@ahw4MZmu`!)cJ&6aUBb5qf&;Q5~rg{7i_~
z<^&H?aCghJyiWly(q7VuiJdBAAc)MInv$Wt=u$XnjAkRk5n(_7oBzQ+8ea@Ytp4mg
zFSrhbBi&q9I&GUUM1a-bC949h-{Uw0|N15e4Z$I-!QQ`t8&DGq|M=)Ht&;xkLmLBU
zk{%P35C@$GH8}A_$#ZAoc?3qxHt5LDymt3531rGCqQ_wlUoQkv8Mus*&<Yu|T7S#a
zE*G1$GboW4JQnMO?U$H)ks+Z1_t`t-nU*Bjyna=>M=oahHS;`cGobUBm6|^?C#NOH
z>!CeKvt9@euoy324W-Bu@w^oHMZ=I`$LfES<rfYhMZ<~hTz7#d>H(W{KCJi#q?_Xw
zzfZ3V8T6Nsxnr4k@TWXD_~q!24<9ygeA2ODkH>kjsn6xQCt0_M3gh!vDU35_utCE%
zZ+y}ydoMSe0gpEKCkRSokkpa$QcfcryXbRc56gLE!+a%~sVx(hMoajtrWq=!=XkCY
znTO>u7%u-ACcou9NK>&tALc3;Nb5l(p=;~-pXW6{tb?Ic(%Kh^uO_yi#O?$Q=lb*Z
z(1(TR5$gl2h$Flq3GqDscz4BN`5mU0D18&<^^BzP>x%K%m=@lLJ^+LE3co0Sk?sQD
zhe-MPC!db<TOy>rJ@1xC6#lr3KXDzbS))-On=q7#MRMw}U&3?3iLjO3*}@x)ClxqA
z6-<^!$N6S#{(fxGWP#Qbnlx<xinoUAGhYfqHV>V})#q&z^OmGMAQb~eKmZCvG>+<v
z3ZXl1{2vHyp<7;f-{M`%I`E`z&|GX&M*vIl{2|VO-^((+^WZ?=OXl|HxnalA&M1iS
z&%|5n;dm!}^qQ>1o50Mxvz_0E7v+6Cw;zsyKymns;yCL<){SdI)`*W0;y)2D1ey*K
z@%%>kTLevtVWL-BL<hgu!)d9(R|<FuTHrb0dspdupljU^;q43bz1RTb(}({<V^F!e
z&>uJXC!6Htne3wjC!3F(GILePhX*{GjB;~k_WZnbM1JLjZ3b>hVegxCRlx>46%EnK
zc0me>UVzkQBYGO^@4OsvU#SO&{6)!AwOh4A323+(U^m9~lY?X6yTj`nc<hz(%H`}D
zSZU7n2^?1N5ZeBm`r)tu3aQ}F{~c^4Vv7W?6y=1YZXsMS{&DxO{X_<Zzl1eg*NB@y
zUbEZ%)ql;eNDKHMDdE>2Ps`%_J_@Qu5|9to3_fk<mSw@nOJ~tJ5&(#tRwF;3&&|P4
zk3K_5Nt_tyIOg9BA$ZwxuS^Ssa0%M@tch#T7p&kTYvt?+_YeMw8fL41No2YAkKaiB
zU}4YA#$qtP3HN?#K3>RYFh|LPxvbDH6{^R^P7_Dw^Zz!=9Eo4MOqpL5=7rH$Codjf
z2uFqtkEVg|lNYTq9GI-+Q{#Y6-WS0oLnsEq9065M9eLj!QK-O~ho(f{1jAPmGB4gn
z+3f$WDkW_WbpHY+NPDI~r&|A)8Rfk5BX>WXQNZAfg1Aq?4D*N#2>pt0>cn6lh&luI
ztPc~A{bDEPjtR~=cuN@o2s#G<Q@Y3{Yz+7h05?2~n*wg-k_j9bEUWZ@haM+@xew|9
zcC;6c0no{R^H3WpnDX<&2srvqGnN$5D^>;(<er>gc4ne1e>J5-e|sf&&4(7Su>I7q
zEH}hvY#dCqIAkBkP%~N!qulY)z8N1XkD48B?vqQKHBcS+|B;;mDQwBNZUnD-59-<o
z9{~H1BxmyY2l7C?n&CJ_!KWNb_q?IS^c`PEhtNtU5z7&q5jP27pI{t;BS3!59sJwU
z;6=d<|9b8LU;oYFAfQUm9e^`$ssE}D1|tjfjM}iz`9H5<!-KOxg#W%1nG4mMDAYRU
z+pmk*F{B3U9rw&wH{z8ObK<fno5;m{Ol33QjHWQRCFN5mb<7|>T2n@TX_%~FzR<5W
zG;lN+hsDr0XW0|)m%}^2+#xIE5G}5T@#%Nu!`BP=PUz>6k0i)!%igL~o-b7l?hGjs
zYu{Ee)8jZpK%F0gES`AFlLj0yI+=o$2uu9F0qc+_Lt40c67lbq;3oBfv*V-P%QfS#
z;RDuRJN6!6Kr1*`%lIa2s)*5WrU~Vb{xjdc64c=jBlGgvMkBYwoO3my0x$5J%xA}V
z!1#{gG9C!O9v(#Md*%6lxx5EsK!ow$1c%Y5U`U`HpCd|h!zIRObAj)drdTdNc@ATv
zLxga^YPi@v(q?)YFhZ{2*#4;!h04M3c^|-So2V!VkATXQFu4iCQ0ITb72xBv_zO3(
za#vSz-X-=0{U28jY*sK{A{OM+j|`qz@X1zj5^)*;$Hyz+Z-|z#ftgfTj6cicH&-@O
zjI5kw%zh^hXdvyd{m^ZKoU?LqqdWolPtB=Ac4dM-BPc-)+Lj}19w2{(BePq(C053w
zH3=A|07t$8cF6k8!c(?-SHbb{Md8;IG*hkmqkF%;`oSpCu|q>Hb?~+fwgs9RT^x^}
z*#7DvQUAyALD98N0Lu4YUH#^J`VJ48jt8Q63`2dx;p_fb$M2JUPo<N9>t2dEaU9o#
zE~WwD6N8p`E8#c%5BKBukcZ*-fg{)wWf)FNgd%va2wY+~PUYlx!ag=gge_)<kkF_&
z+YGqHI=|qT9h7L|lJWrf8wdLp&47izKVSf^&>d`S)gzA`fJ*(#|By=9h5`PN`n182
z9+lz7cj`^{gAVwrfeY8Bkx4R<mL1FdXP`n~Xa85RdrJISE>lAA_8XW?&?OUt0TMNz
zuD*f;<>w&kM-rn|%|t#je<w0<?w{f$HrFqqh)PQ?!IlF*SDRF?myKb_Cv^()PaS+A
z<%<KkLfG&iaEZs{<~6D1X=e~4Ic2&~oJLMx8M^z*aL~8O=7+h00K&PsvE(1dRs=6c
zy*=SG3e8x-7FFkKMF2Rj3ui>F#^XNXUSA7lm(~+J4!X1eBH_rmU;IqD9+uGohSXn-
z)d?6QR8706ZzOix1R44yRcZnU{uHQc$N=wk4oZuSD#}Q^>e)kqel#+N*V^M+20p$R
z%i+jiwZkj{F3f2!*9gE3J+4EZdK-7=d~K!R96=<D543CH55#)fH~RLbxX%L<_o2(X
zrS_~iXG#o&Pe$NA6@oX+1_D3UzkB{DLC1C#1@-W>xTZvt{t)U*tjXR4i8VcGmL+@M
zSK^14n)niI1#@_H4U@tcCfFP6I0zc``OE*pF9Kc>@u1HSAtZ&VXN@!CGc^z&_*X%h
zcoHyo^#K#w|EoxL2ler?D(6qW5%5OwsD`I(0grR#^`MO)H2@CRqXJSjxBucGPptU3
zwR!|FFuUrVf8clqzy3(=|M_SQDsPYB9)B|?&RHJ-!?OKU3>`lO)xd;M3cjdByymR9
zj}g8R!>Bd{cw7!qk+K2^cHu%(kNDloKiq~PBmc;z5ze7EAFKeA{UyCY-G+ky1(3*u
zU&9;}NDvb#usnV{f==d0bci)qMe<`3zmm~!2}EY%c1(*R!^HDriSi4;ZFS)eH=5I;
z0Pr8Z^e@70DF4QCj27g?`Trd(@S~uvZaub5G4cIC5DP5R`n-hD7p-n#CNCRic-l!a
ztirU{1GfO3URrN&N`w<&Aej+Y?O(sBAPrnD8Mh=Ec#p0T)(J+3Dy$N;J0v~`_BX61
zkM{ztK8;LdeVn`Tywug2gm=?erX{m_%5=a;&}c(>Fto|mTqFJx$rtDu#0NTs#7T?~
z;`@KEz`T6XnjO?L+fNd@kI`I1+R^%@sjmQLZ|Q&af5qDya1*(IfS2hb{ILDor~G^3
zINtgO1SOt#_=&IC{5d|J7!dnLo6Cg0bNIOFv-$7`-z|unn0%Mw`Ee`|t6<?<mh$mi
zmO#Y36h}<E9c9o#)c+RZV*VX&-Iv6{CKUVk#Be~}Jn{{s5Y!VYyhLcSQ*W<j{qcST
z+e3dS3BKfgs4pNq2?ygm0Y+134^E(qI`9_y0(B>vH;;@jbc8#B{&Gj%F|0q&=l)4#
z^wuNda$z?=>zZf0kS8WRiFf1t@u~I%K=r#Dq{P$s$qk?;4*Tx5w(v>gaAb$gsOw<C
zaga>$`DKJRgVp$mghs@@@-{#GJ>Bn`uf9JVowhtIoHqJ*#pd?L>D_lpvxu@oxI$Ra
zbdGWM=au)d%ybd)IiW;7cj9@mq7{Jv`0U3ATtqF$>8MA7^S<TuJjuiF_t0~9L--)r
zP!xJS=O6$CXmSBp=;@#X^Z56-cyz66KmQ5SMafnO`^FJiVne<QI)N)uvZ?_B`nCX*
zeIwf*7$8}l?hlBBxM^4msT&{nAGiEhRZxou7(6d08#bfExJu3d+%zeB1JX{>v3>4i
zdkE_e{3ZkqN59F%@xT}+SV#|UP%S|}j{PF%fWAn6)xe3n)~}%m)Yo8Lc6sCAO}U`^
z`d{D@Jhk;^UwTjHRq!vwd!~QI;Obb?TBFtf0(O?39?ms9yhpU|Ys_5!b&2NXu#jjC
z;`k?ZEGJ~W%mLZz0A|C6f8)68XbhVDJ@cR~wLd8Cqj8tOsZ1FR525>r$4GCb|6F~d
znE1$7-MW*KiP<&ct)WlN>q*JNbWcP`9uh+lzArb>W)2fI#7!-Ml2>Xa%jDm6z3`Nb
z(Dp`#PFbRgX!$D2HIFXzLwO^k4d%1Q5rSS@84jf5>zf(EEc{e?0E29M@w!i4j!|zQ
zvHu9>P!ljxuECNqVU_8Z`r%><Th4%gavqBO{_jLiHp00QvvV<FIqlaPK|S<kSF;Sg
z%Y8yiZ;U?1hyE|c)Tu&#U*&lXCxtN5F6czT&_>j0-j)Qe{b7%+-tX_n1PtZ(WWzXu
zx@qvFyyFLiUDZyCUW(7aB)+2_2=J`>2hi|*DW9b??rU?Nut4w!W!w{a<AB-S$ew3x
zXxZ?5Wvl!Jdr(<;HHUBIWvy~v+H>Ig{_M|{{t@C3Ort}My6LaPd{0`^`No<rPzN{i
zuOIk~a_S#H(jo@7><7H)o-C*P#6lf2O+nxmvz(8?KfH7o@eyzxS1cH<ty^rOki^vS
ze8XeBBh#=jU8#%|Me*2(>+c*@0M%c3zB;H5s$kVL1E(o(7sFQ+?7jD}kRtWRi=qU<
zG{j|^TLV>5sb|OhBhdn4(-DAwv(xhlf2rp9N>wd^yZmQMK0rU-)BTVJ7n9PmeujpZ
z8qf9ipTCsnh|G070MXqeG5=VtoBx~3A1!V)*p4dE1ZyT`;X1yj5sm^7oFPG<lOS^L
zZMM?m><sxc8Pc5^6`UX(oDt*@6GGsZyqUaAbVdqdF<gI33g;6)kHIhJ&%PCyn}JdP
zV2#pUXR;^xc#5~q<*xtnu|%{gc*q3$_}}&~n;kf?>p!;UMV%Cy&g=M@6u>r!AD#$5
zHc)`czV(N<F+96R(jJuO;HsN_kb1SP2q)mK6TJ{=yfb4D-<DoJK85x@&iW!hFCUb~
zHI}Y(%6^EQ+e4@Bias)8IkH8(oSP*$U?=3h;TVh&#AfF01TOyHi|jODgO3~Oh~XLy
zjF>>s*%d<rYAym@cpAm)iJ^|B4yFxWI+!O6ZB()=8B{M8Uby<?hImYom3$=}GpfA!
zhl%Em47Dv06Yfp@1sDJP3AcvumoiiK)96*+Jvx?dXm+&P=)5Q7hYQ9Ji|H)3n`#q!
zz?*OJJCSYg@>^wJ3G>6A5_g^wLGnhBKljIT!(_?qn9qQtmeUN(eq5P`I3&Rv!}v!;
zHbI&%j>9N;7(&4c<b{#;y-Rbw^*b(sf5AQAk`rshTq2(D4a7%$Pgb2%I82)_z9aJW
zUoT*S7ZtJaUpEM_A;XI&Kw-GBDG-7z8vSJ$C#U`q$=ZHlcFE&{LEtA)JcH9w!64Ky
zFWrgV@<-BO`s9;;*9zv3Ee<k>9~X4JWoL=5y1o(eh`Iw|nlLyN+g#oow?1kCz)kC3
ze;y~Bwh%C=yd?y08`)_DA)f}s@!^6;)AaI;pWuUb?6h{Z>LC_n33NEDq*c@qAL|Y$
zFkzq1$ukouJ0$MWOmJ1pn{~}ju~8V#Y~WLX0UM@YjHu{_Q*7eMdjdq=CU7&%xFI(P
z1NY}#Z-;qG1zVDTG<I$@17ddU5T-2lo#DP#)$L&y84zS5f7dkFY#%c-!Fl-GWPtJm
z77o1)#QL32^#}unTECj^9Z1iw`oqb1RHKKhIRC@C#<~f)8^h+t!_eW|wHsN}N`?!6
z_)QAn=l`3-mwDiVH6a5)1M4Flw3ZzmWES!MzKhlzT!Isd|AGt&T7Zxy!3$7;dd7xi
z=v({h&KyoJ|GuFBe(RGDJz<ZD@a?VO2;hJ<KNZgg%O1n=F|4AGj*XAPIvmjEgDd6a
zqGf+1r_khwi=!<1s6(Gm#&~MV4Ov_P;1?Rhv10H(z2jMU=-9#Wtg#+*Y+Sn@RB=A8
z96bP^6Y*T$ACcU<_$R7+nW2%IxNqMX?YpQ;hLjzG8iR_-g~DeBO~9zTgW>(~oIm8`
zhbvEpLl@pTn<|F$c(@|Omn1PfUNSTFrdzf<g)m3t{H+Ah+P>G({^nyzm%T-wH;Lzr
z>avC)5VzF*$$SV<Lemn!jq81MTxkz$C-?CjV<mr~p&Pg2CE>0w#Y7K7{m%Q1kZAd~
z59CrhVr2Yp@a5hFjP53ERZ=%|cGG4b8@%IVx|6Xoss9l-j+;ESBxCUyzHLw-A$l^+
z;SC|^>xIz28VM#mRy=+dywpKPh_Ul?UlG1b?)a!Cd30(ZDS9ZdM)SehbPvbxFo{tc
z;_%a4J<YEgez~W~nV*t5cdV;oC5F1q@FYBwJ?Ok$QTbm7996VB8JXUG5~0eIE+>xU
zf!p1#2qR1Qjygm@&um6{#k3IHKmmLwVpi3oA7v@G%T!p7y(czC1_ppE)CO7j?2s|B
z3sLWxo)w*U@w+}jX!plCw{)M6{9`Xme$QD12gJ>IU(A{(V<)C{f+qZQc_IzLm`^u0
zc6NWT{xVtoHj5KM!fwsELUNxkHX5=Cu(V|NjW!V^B5;<I*&v>{`&wMPYLR%%-+b_W
z<&OA6m5Wb5;DO)|M~jb)ZZ*KLpAEa*d?jH17(<K3Wm<oiqzd`G`{TEfArHRjI9c>}
zG|_!?WJ?|}5QvMO2&aY`>pwQ73=#`NJp2^YCT*xc!ixrdme9QWq|ReA!FlyZe@^F|
ztAuba(1w9GkJ25%3(r_NiVp57U`xOLBSV*n?;X$hPa0dIR$dFRC$X#0SbR)y*zp|9
zXM{&}r7T8HPDnCbJ1SPGRI8K|XZI&;4wBH<m{o_yMCI!p3<PvAAN&woNg-fQs?1>o
zRzdB}Si#jt*BMA4Ab%zzCz~3jtNCsW-{7~CD;VwzHi`{qsAqN!95Vxn8)vC-{|Cg*
zeYFGgRA!0NKhJne5=+ck&kq@>_{i)51^%gX7tZh|dKs%8RW6Iv3Egm6jYkK+a438D
zdJs)U4S_C)_4jB%0OLR$zaIPHJJ@NS1&HaIMZobB@SWphPmLMwBgDx?VHPFp?~L*G
z&NMoMHuG%&1)1MZCL&%Kgt$12Mpl6nkB3hLt(*3j85@=rzvcG+7Pq#;cGybt&+n5W
ziu=8a@d>_2)Z+ZM8uHaV6mofBJA`nFhQbK2+s@QC(Al}1#!!NP@tiWh!b}Us(x4!R
z7c4h-TGRd}30?xuImAW~FmCT$C663U1|W`PXu!SS{2|0;`Mv<y5jS90_uqmc<ggG+
zgNtC4hKJsRxi9Wmi;`2pFEv?yUOT3KO5EIMmzx?h<G9*^lgc3EWE=-s(4dugz{;*2
znCMUbHWP7Mwu+4o%`7#2L6Nh9iS}Yq$zmr{f;>ti{%pIG5)-*0Ig6A);OC0)=dGvU
z!oY*{dDa93wW!HPun=GWaF05k5O6F9+TkseCz?!^nJ7aEa@6q8!g?~&F_Rg@24sfB
z!n{PufYkcHhxc5YY=<XTCWeNZh>y7?<b}yA;y1}bH8Mf`+@2QVd49(6{7x8=V@NxK
zKR4eAXbdO88QCbz;9es)H3;yK$H`l9e42E`;vyn4a8J)8^p;NCAUH{h1W@}?_kuo7
z<$&I7U_31wchTdyLIDn0Y&Lk&aDc}3Sc|6UVf;@u;fS!GI|F|H*DfUdPW~SEhe<QC
z3zJnM7ZHVdbHhJgo0j=fE=o;do+CV_Ncx}4$MV)7UyjAm>R1T)AsWs9yZ`_Ha%`Z~
zC~`Tw-x(v35|wGpl%Sxc0GwSy0gWlue-I5}S^}He04`J2YuhT&Q{1+|;ayhn76duU
zi_ogROVwFY^D2p4go02SP-R#nSW2xkcGONN8&48tRPu;L;(eBi?5w9sUoUO&t#!hB
z<h?iLk|*R-+Gy4C{Ytpz>DlVO{Y3q{?-V&_`>(|=&`rrxSpd}sgjv(iyr4BbHFgZ4
z#XQp=e?586G#XQlX&Rxfy;B{qMoIlTd8kb!E1W<WeIA5x0nA4;lSL#*ZF}P+a^slR
z)oIL>prEA#T!B6C3}qEon}q7DS{*=4M!7}|ge0s10Re}<;fG4~gLD4Z4-o*9cIofE
z235wO|8sKw*-o)9j5*}DJ3S*@II1O0w}zo#8@Dr8ybLNrxoTy0zAkL<ByPkfu*uDy
zw%U*2;hfKb8)}`#0hraga<)DbSR07_Lr1-8oh$J5LNMO6w70sEZeqS8grxe@i}e7v
zZ%AB}!XlA~NhNDg0EPT`002TaL7QMo5Adc85dtMdKa>71l;QUIp52MjCTgZ!c*sJ+
z4zPk*kWVt-$W89g%$x&ev=GSmePwut^7*5h$;+_imxQ%6IB$}HSSN(&Jndm-)xs9^
z=X_f_{t0-#8;mOO>7l7j7}!torR9viJ_&qa&&ioAjN&5c($bz-nC~W&eogs#FedyS
z(h}Bq$W{3&?>roI-?;nu1m|@J{M8HyNEZZ;4*N&7hyB1C_b3lqJ*=b3<2-*fW)bjF
z#8EeT@KMCA!uv2snlA^WSvZH!pYi?LOA`^7o02IBh{te_8}LHPNV<l8a!@+}6d@W#
z{%KkZ&ij|RU_ZPTqu-wA>%Qgw7lAF<{-@3cKvnDbDLp6q*eVT(I&<3md}ON`Jk<&E
zV3!F~W~|rzc)Dxm^Io8n;A|YHw1>~njKmwZaKJ$nM4Q`OxtBrK3Awy%@5gziEFUy&
zS&W=qhAfi3m2p)=H^`D>FX1gj&0Avtfv5SiR|;^B9n=kAmFW&T<5+^PM%>1#x#!D&
z`^gy|^Uf$Y+q?YO$l(Q;SkxW*UKGG4zNZWVVW|8?kW@^#aDUKu+WzVUgV9?6O5dRG
zAlB~39u&bS@iqXP{Cn((YXbPl+Q9qX1N}AL`Tl*4WMqU9quy>jb~AK4$wh-clhtXr
z?+k~JpL3aSnCOkfVaSgY`8MJ0+r&XOAe+8U63M4R)V4;C;waiaWG4U&aM|Gw_(mfs
zWQ4|;;C>?@0142w6GH>-`C~^OvW5b<u0av=Wk}7!T-lU<7JxSG$$4+IVu(xILRk{`
z0QGBHt+#9C5E%H$`LH1xmtc!Bk@u4E*cNCwfMZOVKp7+NGVk&}&maFKr`om5^w~ib
zbHaW*n4BUTMRN+Y7oPB<;AwcoZ&w|~T1m2^j|?B>t(t{E*h`njjv?Od?f6S>bM>MG
z9p=VY;T?pb$h;l^!S~nmz!G=Tb?pUL8)xJEKSar?RS&F)t#|ZI^tZ!OQ@bUVuf0^*
zkr}-VjNtE@W*ajBH+*~S@tz300~<Aw$^{r8cmuG_s>7A)*cs>e7&~@IvnF`C8|mvL
z*QK3t$z<2(yK5zm8NmFs26#ww#AJs1;w6zJZt8;zlKIjJ#0c^H$Ma@)%V_<Q9$C1K
zfCx<Y8^`vRu<S1pVSuuz2tmrfbR4~}xJ!t}fxvpBI`)?xxs+SCY{;#_r#2n324X-%
zm0yn;!Zr>GzI%4@h`<J&N?E1-w+-xx`H2T)e|}HRpu#rBgt)C>NIe=%1dqjbVH}gu
zF#jX|J^@FoVdc2OIX~Nmei_|7D>4g5yz9Qz<0Dv-*v}O3UU}j?ew};LuMPDH)(#zU
zejD{S8NYUir*DswpVuZ_Z{ll=@FZUg`T+~oym)KG+ZD5{5;{{!8&gn(Oi+9C{~E`P
z{u!(Y*aQ;4Ti!H&uJm85+=4v4+6z4ao_YF<g9UKE?_JMc=L(Av`6fcjXZdyqBt7;+
z#7oBRF(Tve-~U6FM+^%mZI1|M3Sru3%LrMy`~Aqy4o+E&w<JOQM)`To7Yoa&p_`ik
zjjyBX2@OA<Ga3X0KLp^Fc~QHWKCE>AjPF%8`v-jQXfAcu0!!%*Kf}7fNWP6u0#>7B
z4eL2RHTL!l2|?6t#gWK(T!*j9FrVh;)o+pls+Fl4IJmwtpcwTF&VlD_&!_(vR7w5K
z*%V)j^2Ru3oiBRnr2iM-?FK|b#6P*9<%avP*-V9T7N@xP*_{W)SV{T=|1<7E_m=pF
z|K-pa=1=&EXr<w<lH{2Q;Y7JCrh6sDY;icoZWDY)e)dx`1U~cTPFcicf#C55%*+Lw
zzeeTp>E9-IE8;CXpd;I$y&xeTxq0Qd|H6C70GuXFs>wu4L^xzj{JEKpAY9%MuzBAd
zv}iU3hlUle?~3uGA{en`zjdrPaWC+Och0=4*&Qux-{Bt&-De)!?S$M!hZ#(h9mcpv
zj$#zi9=oZW`s1~fvtGuy=;=w;xaBW4uu0`TJa>T};r``W?LXbvCi3?U?yUW}H@!#y
z(+|h^bwAaSqm2w88u@S+I`xHCJi3yPEm>+vkIfvHRaL?iN99GfoxFSyn&Enfw=fL%
ze7>eCTj-M{O5MK2`B;!Y<1HdG00~;)O~^khv-@aEGba%ANI{ywLU@}~Nf$<dS(Av*
z9B9sm5oAtk$cN(mK3I2~OUvP=<PGr>@^Pt}MBzBdkMqJ)<ELwr7{`21bUJe(CnTaI
zdN0kYu>J00NUkf6Mq(*v489lfp^$1YD~Oii37UuZ3;Z)m_{}E(0X1!(Y(BU^a*(ke
z@3r;#2)A3WFUANCD~ztYBBip4r5O;f5yqxh31pT;go$DKx`fpJ=Zw`sBh2JA5T9Yh
zRamh*1m1Ya&g!@DQ_Y`<A9t=1;Pq*M5<T#L{T3XkcUm%lADfh4=3p0c5AXM!V2#6k
zBjnyEA<X-(E2%cy{l^Ud<<!uH;;c)yMG8{|Qq>QSfZqFnkFwi#atwR7XQOV+37fb%
ze71xY|Bj`IC<wiI_v5-Gr>{F56Stw4s!QXG{3k;pZ9hp?Xsag`O|>|H+JyT1JY5mw
z6kI*;@I?0535LHq^teZ;NYHR>uT&5o2p@nut|Cm3Z*>0=0dLIqMm3sC3A4VkqWpep
zVCc?4`#qT#N%3bZ*cR}5&4;2e&Lzi_G;d!w5u$cS5vYuO56h1XxXHpE8QfgWG4vYx
zeoT=3A-1e_c=*ZZ5icj2o+5)JnHnFaem+9+_|>5S<YveIuhp(XdEbA=wed413(kUo
zAO^qmm%W69O(O@|iOncuA}ZygAcI6+5}TsZ9T=T)o(X&hu!jo_db9LY!(`RwNf_2T
zz!v`{%j#!u_>Y3jY(UL|5t2Rm$E6zr1=2p;z+RiE`*RyHFXe1K!9~&UJ>k7I!ZJY)
zv`r3XO=@56AKkiC0IhI@-rT{l$=`b~CdrXtxg$x0DrWv}<&p|nJ~LU2R26C$fe7k7
z>)qxt2p3WK;07**XS@dTjsVd7Zu@cHElNYOhzYf5KBMRnw;ldKPrYAY#ak+QvE483
zzYi^9Kf*mh3&0k(!5)YEz>%Hcn_`rRYtz5P!fgKK549c2%5(dF#mvhNiaQnp{q-#T
z{B{|LAaBW93(P3~s>JKNKfS?f8Ts#r_rDipGH%eKoYE!DMAc7-sEj2MhH)mAH=l~I
zIwy`BIk5tADA-WkA<VpzZ(Lp!#(p&sV)#P`cg)Pso8xyi$>Ul1V;J%Xn}jDx_49rx
zsu!5ZM@;Kw@9>KYN8ubLY(SgVsA0EM`~P(@6HnR*)HCxh;`(FXyaD8W8HS&JwZcAX
z%NFQqzffPePqw}D{7ECZdEicMkpTc)YsX>!w5K6HK9O<NAW!jrd3f0BBK}>6<ibHk
zF?aEu)K<JeVoU^E<8J^>`DZd-!-$F(&+2zk-}g({abMrW!8ez<nXy&@N7My;cU&YM
z<75Gdd-MKm66ollK+#b5tDla-cGwO2OGmuKdWHPY>7{)!;U#1%Iq%5T-*NsE{B3;b
zOCJc<V?$zFX*kzr`0*2a#KETt&kCLoA;Z9;cU+OV&KJu#jF2hA@tUYlr82O~Ancnk
zjzoeQ{b0Nxro)GIYM0A=DeSv^oHMF_2x(`8J=T7#g>q<N#9m6nXPb|L6I_}KNchcL
z0ULb(AtN@@+Gkai^$ZM#uT1j=A45I3#uT@}75#r7$_v*3Zr4Uy#=Z<o$X}fqCOp0_
zw9WHbusY%;<63Kke9f@o?pRH_@BZeK|0fqR9BOk~X=u-z2vxfXV>sEhFCB!f3W7$1
zWaDPkTv<<#dTq5o>yPNSX90urvBLA`=v5G+0*{fkPS?6{hlD-;`F;C|?y%TGe1C&M
zWbqjW2~m;tEy-R{r_ZI;#C|6{ZMI`3OMc^H2hca(6XG|F(HJh|#-})rBN&YQH2|^%
zem<T;346ZR|9A;+<Gd&S370djsk6pXep)waVF9+ydx?G}{r0|$!Gq*Ca%gRfZb<m1
z#7iXO=@K4k<wabWXx*Q}dyazp;5T!jyW;lE))|=5Vb=-r(8Cwm7m}btL;e%s*EV%J
z6-8%^)~$fYpuE5z-$M1<SVyG@Mo{B`$B<rm*8AQ6!g+6$U)~EbELy*Wb43${0Z%s-
zXS@-33pN0Yz5(5dj$T5C-IE@p5fg!kO78>Dl9Iv^dyh0ieV>cKC)eGdR_S50rN70-
z%}XWAd9ckj{~3hzS>bpsz8NJgaseeg%?+dmzHbQhM!F$x<#PkK8itk(Giif`MINsc
zPOAA9>z$LE90LGHlp6gncKFQ<AfVhpL-o~x{w9~G4^F%6Kr)35s0-?4_5Th}a5K9b
z^=IODjNpeLKAa83_!-R`Z)~c2Z_Xz;dcgH%<-CF*QRw%%${;tm00(?kO9dHGix8GW
zbp+(E^b%hnFO}yq;xC)cGIH?DB%mU3)bQVw$z!b(l85(n1AN^O(9rV9r83hTH4%q6
zM^d4IaAQz$Gpj-PLU?>)Gu?g@vYJdR(qS8taRH(_OhmLCe+c?T;UA37@rlF}bNG&g
z6_CHIKk`TN)l9x#5z~)RmiKsPvEpodtEa!d5aa{_JSL`iG%*;>T(YQ-(|jRiT#)s3
z!dhd-=9-U3U|uSYi14RPah@h(U_mp^<^xC78uh<`H_g)5K#}YW&w5O-I84*Jcs+I8
z>pnGFc+UWRz65mV=Lk~XpMdtQ=+9VM`9P3-gINEFh~9D8ow^`5F^M_nde8mA_MM}K
zJ|!c1a$lY%BBC{Xcad}l_@Fzk*bmMBh|GA-%Dwy#SCs?_<2YsX?1CA`G+<`esKl*r
z&-tcO!78JROZ;6DRdYsA6zZi{+Qc=z8Z%C6j~SLj$_U*&8Uj|j!+(%(I<O`w^nG<b
z{?Wy!XW#tU-jjHK)?K*>bzp51#$gL>fQ9X}<71UWRe`@Kwkzx4%;5&zb^7$<W0hTM
zd0T@Gy07m|57G9{4mTg%2pi}>>}ED%UlTuztH}&}Wc=6+YGesUfQp(m=VsTAs1uh!
ze~1YNhw@n#k>zOr&{%G-?)a*VRyKEAnWG#$JtFRzB)Z`o2_LuA1Ydx&RLzyL2p$0F
z0zL2-IwaoFCi9(N@tY0V_W~2~Tco}(OQkbK>j4Awhie1d>78@m?L&k1KKZ6IBQkN?
zDCTC24hJ-vV}pE1{Z%{vtaNwcKNDpehHBX%`J*SUBOf;r(?mI!h~YZn9}mlg#)1JJ
z7Xof;Z35=8#kx-!*9>)FljrL{T8rF?`O2vCerXSk<cs&)-x-b@I^8y9V1#e0116;9
z(EH}qftDUKX$DJVzDWO2g|@F5dc(f+DU3!gis21=mK(XmmfcyokS7@(8Xkun%+RS4
zWZOp6wm=Mdo95xv^DFV5F*s;&hs@?QTG#`Ot^?bU%0FsvzCafIztdheuTkC-5Bx^~
zY^&4y2~LuiAP|i>?*<F^?oMr}YoqZW=Ue5*n*1R&ajM3@;_DiuWxXRT%lJlEYc_w&
z&Sac{MgRN(5w+PikN^0JWkW>N-y6+-yM#Gm5NM0j{K2;D>3^OOh8ym;SJ8aXd$@iB
zKKUm5m@TJ#kn{byx~r$g>Ngn(X1yH_^7}Viek<gHg3Ule0V34_GeF*d_IS(*hM+be
zS%D2B>)2UIkMD$Z?+^3BPD<R?PXB~8+S<01dS1Bwvwj|zl0j&C$*u|UwxRKun#$Y%
zz$AT8XKDQ4fT)eYh3oBOaNbwqAP^7AH)v!;zmL0D#Z#xZESEP#9@PAIL>%#=+zL6L
z*=|@l;W;3~j0~x_M7U1MNE}4)&z=*8kv(v1A=$35?(H`pk{+Q04|D`yO5v-@fWGI-
zt7)DPf^RPrRmxed3SCu)+yj@*o}ddT2`AC7U<OWoOJc~l9~pu+o!}rIzBLYBGDg?B
zKhR5!uXcCnA|HgvzFzU1pL}18s#~rq$~7{#8mY!#mr6s2mx;)IVFCA*f5vzb{z`x!
zKBq8+43DQzxzc3cGtuWSiPk^(?=+AYGmOX}mtafRSFB*=G5^MQgCSR!h1p+Z4KgE3
zl;4}jA~d;fBMO&sRJ^uO)SDLQxUA4DO*zAT;ZMSrrTW2TCIFFcKwRtVk@Y-xi!x+{
z=)xOXd9P;f^asA6LjQFi?||L$*MKrNdLIV~|3w@P{)M%kWB10X@&9o#ei%Rj(k7t|
z@(+Y~eSKmU*`5IlW_=}IFYmqo5fP!@gbCtIF`_5?&|x0kyxg4leDNKl;o?AmUysa9
z#(-e&!{>zfaA!!_!0PcWW&SR#gQa3flT%ZdJK`7P;4|-B-*{&9(0{hC{@_WZ2ft9I
zt<#OK%b)R>3N=21yFQ@I7Qz9b;n06}pYRg_k-NFo-{UiS(*M`OBi+p({^tJ($1Zr`
zVc|D_U?6MQ4DVHM?%W%_RgZ_bAIHpMf(E^2^K`I<fi0Ri@G=7SPAzZohY@WL^T|0h
zny-W@PH8C;%_ORf>%>Wy{wG32!#Y8#EKI7RM2>i`Bp^&rhri6emme9y9*X9XKJ92P
z^~LKv-F`YNBcB5&5H*3<M?b&~o?m!RXT6@{B#n$dJ`VW$C-ITfyIZ32W5A>QMew3}
z;~d<O65Y|`5ZBk;fBrw#0tc&Nd*R?t!`LG6fB>Jw>6wT3GfK(ujy^EQh6?GM17Ks*
zR42=ml2^$G^6`kuULwP1PY|n$>Z!}x@QGi1_k=g2-O-Q@8&E;}Ibsv>z1|~w&RzK+
zR=NW6k@ibt6TYF!c+PMDok#0sMC4r#Q47)ozS5B09w075!k}JR#B$5RI1;s;cc2nH
z+#mlbHNVmyH&g+P-{^fn2ek46bpZy~svaT#-eBkn)Uh<f*B9d?C}}-NT9^3m1UniU
zj><5267(tR|L%pUZe!FlbN*aM%gN>B;GOdVU&GXl>%kw^8Df2Zy?=sc<&M5S@~5Zb
z>ScI+Jy{oK{apXaqu%ld+Q<pi{|H29;rJwHX;^=@#^rnlzpZEA)BjcTy^aH`m!LY`
z{s3OCmWRjcc<%uS_aFbzJ!=ErQm`}XI_k~oa3Cda18<_YRBulH{Z;?{!2T{s4}b+4
z87qY!HfxFD=c0>k@pweQ&4HcShbF<V;XKzinEhRG^IQY4g!%7gM0f&jvaSehg!b4Y
z^N+{AbTRRoxCdbswKhscMXNZAc>X`+Yqfzhm(I;K7^~m;_`m?H2ppD%FAfafgzpie
zA2u?XB>ZGMTXWo!hRQf>vq@2%J(EP#ULsi0!!mT4{9b)sBg;1=d}P>S$#PWlD2uf^
zG&Wa>@-u4sFwabgO}uc@MTz4(w8bURjO{)?M`>pPw%sM@AZO}}sXf_k5FfC-VEF0b
z0vV49cffmKMfmFi3*3X}>V~QU90n5afb`;i{YZRqT!a(jaP!v*VYa9e@I1^RphJ48
zryUSr<86Psofn%wgd%YU<5<thGSk{eY}%*zE}1&&LIDso!06zgib7V6K;>cO@FH(a
zICigGd>-7pko)&tWA6#Qqk9^RKKT#-TZjlk8@}WB`iJP#kEF?X>d}+($~bKJ1--lE
zJ|7?A;{zw6$Hq^^Q9Nw}cBq#K<3_>#TL{siVM5>L@x1(#vzW|R5#xqqhJRRs$EQ9H
zIG;8KZZm8?CO!ZYp|Ti^q2^@Vl_Wnj&&JXT#rP2J18abVwgl?0p4e*k2j+qwo7RoH
zFj>?uv&-N``)A(Xxv{N3mbXq5FE@ZSYvt{D??B)S`m_euAP4zq32|f8H(m)m&XP0@
z=n?wn!wU#U;KerxUI}=~ksn}rm<aY&<qM!zo)OXb&OeNeItWj$0$t4aml~gtn=2p7
zHF3N<v?1U*E<V)Lg8}btT!+KgwheIK1bwyNBlCP+)*03E53fFxCE+U|%8TMZOE~`%
zu+9)#l{naCKjOAV$RXs%y5qZ+BUw<RKSZ6@87lLW@m^KzaiIakM9%v^v+)p}(%id$
z9knu38E=+6{MwY`U=BIFP97u1qX=T~tBB0V))ZZFsh{wk@z5v<;mye%Oso++Y9sKD
zsuN=On?Q@eF`xk-uYkGAK3TYV8m2h4vpyyZXLw_(u=)Z!QmgfY8O!(Lxu{6nSff-C
zy|y^Ih3oM(n3i&xGtk8U+u!p3p7^QZoI&F_@!N0<vibFZGCsZ^{;TixPySQ=<y-JD
z_U{Me-|`<<30Cw3R2t^SK?odjZkNF>0!OS5-k_W9SKsfoFZ)Rd=E4<(BKRfDel8*Q
z2k$TNK-qyN`C+smoFI+FqT}NeeZ%9(VfUzi`tu9-AEl~X#a%mqdcJmp{yG_b_1{;@
zNPyZi#zQJ*g-pzlBp5rO2+V5uiB=Qm<4ceqwP<|jwcb2sU<L^ry}zJ(004U22V0*3
zJ74@tE05PcE<hA``!%+n2L*UaJg!T>#yniFG4e+Zmy#YQo)#H|GC^>UhIcM5$v^;P
zSz>0JPL-2UF7)mAo{-$6T4;gC6XQlP$j_TZNI2JorZhgRwi)-XOmNx!UNIT?){lXC
zFyffNkUPTR9|XsqIB~;ZB<Y{UV~0i+dbPTLkARPS1<yo7OkU~rpQAs=4mL9yJm`LG
zblM&09_qRH>^Rk#AY-H}GYa}o=gj`8eY`vsbdH(dZ5P_F`2MJoP##!OV?(`jXV#Kx
zei4kQ5gqytS^(Sp_<#C5c*uYwYIwi-mVn=pe#uO~{721?2Z0YOS_Hgy1g&6api1DE
zna$VSzxcrm@mNAXiiB<qhfokVfestv2^c!7bIU)Z5d>43;~)#_Q4f4{o4wMo%J-#u
z-*|nctuJ};iMyih;2u5eOWig@<NHVkTf3g_b?0D%;7fPUi(d;&d9TFQWD>V))@ecL
z=aiBl7*f{X7cw1;d=b(ttNrDHb6lA5kK%1&51EmgcfxjtVs#9gx>dqf=ShwxI5_Vl
zXOD>TXym$=<(HaxZ9Z)zpTuTLx%aL!A}uGwYZQ?LV>ImSdd$-~s~%?pX90=(=Jn`L
zXHA}LH{=2{!Fl+~A=8nIfHZoe-^|hI_nzrDNpkcr&ihfhji-rS4<0l=D~47bV7M;~
z4q%Ur&#f$tSsVBWch;IZ{O)Z5dcX!(t)U-yoNBAzdw`7FKz%axw@81pTz7_$LIFO%
z5AR>_mxGb&MHXBk;S5JE5b%UdNQ_5_{6`Wa;Z8zq1CDFlK8-F+)HOD6+6<+DfLgge
z0!2~-d8MW80kd8w!glNGJ;E`z(hvX3JZ5gX_DiXIhs~lL89x!YMZ<}i3E@TJ=&`7M
z@U9Zh_{G@Kk-SCjM7Bkrh}9;K{0N+%z(W2aZs73ONBS0}((Ad9pr=9R?TlyPDUoj;
zo&S!9cRCgTQSP>ce)xhqAU<dqa1rbE`+bx+@Cs__{=eIUTqA%@tIgd5NRvK4awGPC
zd{cQ}&j{x6VmUB}5D;@DU{J&p1#$lYg{L&%`hPi7fc%{y&Ym^h$Tpqi|9l4<J3w5y
z<LY=;n<VE921a~eXlTWOtr<Uh0E~bH*A<6S1q~f;vhVR(Oti?7UKHlXu8k%v9PxV9
zL$lNXrS4U#)IfY*m}+YE@I~fzJYe|A4p3xx<ZkqnpXo*;6_UTjU?bm0pq{#)>9_E9
znE%}x>Hu@9pX>YZe)0C@IBUcCu#1Ht$an_ZN4OESr|YFrz;TlZcta7w--!IMPxJE3
zN9_AqWx|R85WU^se*)>+G-B$<|NLgN6SoIki00kT;J_tr)9-#8=zV!t<Gy#({QPAT
zd%P~tB6&g@L0eZ7x6kGgGl?W<_nSl1emwJ<_{}gO7xeqz_$KjM@wjfPhKv3hGq~Tb
z5%O-J+-)$78$%kxyi}_uXp=~s0z5UuX4?xI&1sM`;VwBHpo;>-@m%JM7E5twd}Tsa
z9$d`@mxJ@uP_3Yx>boY)2+XxVlBL61@g6-i<3Rr1buYpYCVKGu`aV~g))GBu?@NWd
zd;d|#gvgC;1iJ7duN~kwG*1ohsd>x(;4v@sui9F|A_lGLao#dyL(Es_(|lZqnCBPp
z=u!U)`~UGD1z$99^OQ>uRCkF!$E^EH4#Ic%{uklJpONv^7=h?>@*d>oIdexe58HCB
zGs6QJ#W(TeAc^ME55apxZPYXK&nmn1|39lgxmp?B0iCf8tPS}*bcX}0tqxt|R;UR2
z=NmSo_sn{uy;MK0Uo;mjacn8YbHa%QBp)p(!HhS>Q*AmNTa%i~r8p3X{3TRKs~FE*
zR>w3*eNDlfYnvVzHyZI9b0XN$gs-6gr~VM*Tm|))M}2A_J^<&}0XIMH7z_c2uc7cU
zj2{)+>!2&wp+Z4LF$14^UHR@v_ba}kwV#^=JM}Q(6Nqq_QEEI)@<Q?9j79MsMjGtD
zhq(qIkJA|u<DVEi(q@{OugP1iN6Er>CY2^Uuz~Tkj+f-yhO)D!UCu_^$60viUqir+
zl|kQpAK(xANq<HHc6X=l^~HJKJ#&S4g3B3_LcG#J=$8|hY^*C%5;${~`;&{t22XK;
zlNa2l5-E@3@<Tj2#C#<oh|UpeSZkXs7#_K^a;5xsu=ed7js86|(thic;R2lj?Z4wS
zc>f0izHk@xtggsT(pLBaCbLFf50Ha&1hal{-*X?lIM4Ktu6p9NW(R4I_C3o&lNjD@
zRx=1!d6$kRS0(GmlN-Vx6IuulfeZM%HWDhdPAov3W90zH`u}~;d=5$ltJoWw#CzSZ
zFOOVY-X4&iNYKdCkhjg4(kJWY%J~F*yk@L3iH3Miha?JOI%Tp63FO8Nz43VAv(lLh
zFBOkn#}@oY=BSv6&R@EiL|JQy&$bjP(8-7$gg^OeIPc-_{0+>G2w|*4@JjHW4T!{Z
zb7jPMjc`Zh?Jf}U0T{r=&G9XHsc>T&rm+M1-_xa4W|UoZW*j}kq5Mvwy^T??#to~E
z@OFa2xuJXJsU!QSC(s93H_3?;X`AN|Ho=}H!@8#U#dCAQyRxv)4|8koA}22|+LQhA
z<#S`h2q9tnf-8Mi<BP%^*lPjT%Cla)J0KM6PLMmewEW@(+^I)Ro^V3@sH{Mq5-~h*
z2N@GPgfe#?YVusX+`e9KE^!yacxEml@u4}%#d3KWk(%OnyuU#=|M>mPtK7+m74hWH
zjEu_=Dgh&Po2u46!-wScG_dl#BN{XI59Edr;fHyzBxq)Z-!(}g;9ULYN@TfsN`HLb
zp_q&>%Vi`T@!7qJ=zcUJ24V#9nyOu=-yPdZW?4|iGwFP>?EROLNHUP;gnZnG9*P9r
z!R7|$gTk0fz}OJ{5D_kwwuY{&0{sW@<MgO8_8oD~b%2|EemgMu?O+pW@;=xJ2Zu&j
zUE$$6j=>=Cy@!NajuVG`K$<>YZ@-y_^y~Ss^P<@}jc|@|0Egrk!bcBu1n<;+=lyeV
zORzMER|rQn1sj)$!WJ8SYx>vM?{&oFOEWVwFIW&oUd-(Bc`*diT!;UP(j@)^3*TM;
zZhM`tN8t>S>StJL{a1TnVU5G^5r2TMunE5oJ&lcf>Ed9Nu`hVoES^U@d!hGb{c}{3
zVP@vZ2G&dBAkVpC-eXwaY}mhu);MN48`oS^@bRh7;dw&@2^){nz!v&X$t!L6WT1mx
z$*M$6$GwXvelj8d#&jlUpR4Al4vxsTHi9qs7dmjhtA*@|HiL*k+dQkQi^llrm}l5`
z+xG^*V^b>);H)4|_CPTEykA|y@Q;AramI<Jj^ODH6DFXe&-t>k45@|Ubjd>mj87i2
zt!6dHW3o&iXTH?`<01p^3<kK4(?dcBxjN+V{Z1qAk7Y(|K{}~0hlr3i`ClvkSH`Y=
ze=IAB*0rg4n-r`-?WQnxw9RqQEm!b_cntOdZILC$?N}N1Hfqg%fZ^mFZ{Lr-aeh27
zWR(jyH;)@Z*A*;!+xSPC2}*E=J-_CnIza6*&BXS{BaCK~DR}xFRSYTmz(RSOgC=I!
z8L?D<_{`RaPA<6@NQ_eJ8o`qE2LmzBrA5iAmP(lag36hS1Ry5!##8G*M!`3pFr=>0
z5BF+)hY^J!?4pnqS>NG+Pqjn`uS|pQOoQ)CbeMzJ_|?u3tRY+@jV3UBc})uA8lvRK
zY5XN7-r0HBYD0;`N?^PQFItz0q*FACX0<V`OlygNW66GC;?hjP*CfmwT9ZErXw46s
z2$4VKqM;Q>n_Bpv2=*``9^IBw;E8vTm!5yZ9Kz%nj$}k^0pdKFFC83C_t|iiMA}pD
zmQDA|;}V}XwG$DKh{W?i0p}UQkppSrWWQ^CJwe%a7LbSi5CH%O0f;R$IdCotWn=bv
ze*sG9&=iQVnN<LX?(fs5H82?$02}gz8jLW{AMlSAks*Qryg*A0fa`?5c~VKDaeg%!
zstqnn<ed8^Q*f4>Bj!1st~L`2F9v!6LOT&I{|_{RDxzUP7|HE{Te&W+x+20_Fe;QZ
zONug>*Q9?t{0Jn$>(eUG6A1jgVFtUmKdeBlRXp%bGD`xmghnIc`SAIl51ucd0pBq$
zA3PzAQmos=xO~roT;eevBgB3VMAoJ{E+zHC5OH!$!FP}qV_+**8L&|}saQ#Tev(bM
zhis;(W=s3VQy#cNP$-$iiqhSEdvMm_S>^`;b#Z=gG4Yc#qB>rX1g&-)A5Ul{A3;ig
z2z5yiw-5I|0^$U}J?^{cfiukO;_=<I#|+wvygkd`?+_Btn{)c&Xeji%^GFe$#?u%K
zfKW2KJh>`LIA5M;u8|wya9CS*nu8rw<862W=uJu~T+!!%{bbM^ED!($B?5&(xq=|9
z2M!|q?g|SFtv=X(dwgj?U>ZfcfOM2(w(0Pu@_s*x@->dk!t)D+sF+4GP}Ur2=j^;i
zju8R@p+@;K*Ceuk%S3dN$?%rLG<r$j8^mIF)BM2sYHeC4G<kgpNWRkUs-Bkt-E}e0
z>Z*Y*fB%X7qft$bPsL-YjTZ>ccwQ$1giH#tw8>6E2BnhXW2ud7mFI@JrU(N?T$zwY
zQvn`X5+^!^&BN5rDe)cROU5(!pO1scNST8)P<GzZ&VR&TCQWen+cUxyc+8kDGdGWw
z@vC^AxijDUA^2yT%zPKv00ahSzQ@DYWfq#M1T>8T|HS?Rw`tQ0Efe#HSsr)9-zoWL
zzUfnfAe(>%zyKfxz@i)?RHYrRY<~a^<g+$GBf0P<ZUT(d;0I3Y@Bo%F4F$&XfkoIP
zL=!|4l#EE4KOf0$iEZLC@mR`0^~yITghpiCC5~pxlXBuj;BfzYq(Ml{9GbXMe<JiA
z|NdSWNn<A;f_sVM@Ph`{bccpZl6iaxT7dsS{z<g7$;WwM8A*?%`5+d#bFcffLRi3?
zji!8$k^dv)eRA(B3yP<b#^xqs8<NL6-Y4$={8kAbc8FVp+puM71oGky<8u5*hq-Gq
zA^2yX0?VI>?qeXlzvsi!@-S+2_pp<P{|Qj)8B#eW_`L1daz)-I2*i2#R}x7X#tu1n
zM#guUEgaDxgKO93#EG?-CU3EW^}I$2_C3mf#EH3&$s+KclLRIt^TEH(8u!;Np{acQ
z*4I2l-Wbbbb;%4<Hb%S18JDgSndb9PC7q>{lZx7p3x&Kh!=3y{tzm;j3hW3@IlI*f
zrOIAerNwbmByF-YD;B}dCNB~S^`deMHKw>|H4%b$!?6zP$G>0M-{CxHNXUB*8-VE%
z9AV5yge2g$v_xjkdCH;^bEgx(!cZvuhb-AEeMFDTHDU=D2S7Wt`&XXvd;z0<dj1n;
zmvf2o=ge$Cm@eTi$YXquT-jxWIkDjaHwo2QyIwO5_}Ck*ke^q_{_0_UIKKbd0%7R(
zZy7W1=McN>s)TJYBI`7jeCE__Nc0{ejSf{KvHr{>ll(7FsTlOg+|l*P-{PqfV}3UY
zFnk=>lT1g3GQ@-<aS>QT_?@XC_V6Bn`Gb>Af8%o#`XlRud8DX}*$4<;t9pv`1Uk!O
z2nAU$WPN3J-NrZS-&;Zkwtx!%tTha+zx-tOvcK-{NC^Bt!29aZ5t_h_M^*ddzbTKK
zYLf2UWM;&2?1wY_RV=WwRKb=YwBl^vHd%OyYaKI@n1Oy+WAXaqGh-l6(JT>~z=Ys`
zpwmc{zU?F%yzd?0Ec8)=L55aP<u*`#$6+4EvfNl-!{3u__cy=dah{TIg3=Yw7juc@
z!97E(6iiGymJYWX9kQ<)u?T34FNQ0M!?AK{5;zGOPu_c|5d`(ccu2(hkQji^07bZQ
zWew}_rbdT9e^3AlB?1=X|F8*LfZxE@Wng<IKEsx#`dsa<U*PyoI{jI@L5-)|OU30r
z`O-}K;Vf`M`IN_j5#oGsPW#Bul2HMSjL;0cx|&ctN93tkMT0Czyztf$I!u8$t9F}1
z9le2zi2T{3A`<cV9i63BMVT{+o|11cev_A<1)M*~zLmvs`jLa$7#Jq`{N_Y#2u44<
zBR(pD=%2*+MZ%Ime18Z_$EJGYya>N(k)DIjcDpt?l>MV?iad4Phxiu}=8Ft&Gh`QZ
zIwQl)qK-@VgXUYZ@mRpYTWz&#-ASY1)02xVyjLVpP}jPM*9mNgjkQUsT8N3P9hid{
zL~|!L$Y^B0dmwg(`KpMp{3X<LJ~bKPAAr3sk{hIR{N?!&Bj3KTP3^e{puF#W#kr5-
zf4>MX0-B+%z7KH!a2cBJfpIY6x1>RYZbCXP29+m*;ygt};xQ4tBaRMRKma_^32@T)
zXTRP`^GpAm0(0noC>u{`XWNp${CG|P^;=2t;MZy&;Q6EEr*2+sBipmSBP_fh$__a(
zW%#_$+l*r;HiME2gtBRj@yTiHgr!1QBGg$Tmx#>+Lu@_sXp0ZTO$0@UtUFBckS@_{
zo!@~o7);{1TN*<1DifVUI!L}=r|f_bH4YjCEl0mQ=|=DW1vxDbnb&+()=<B__C6Uz
z1tK%bd5|9;?AOFS*?f2b2iNHxuMd0Hm%Bb_(B)vSrC_+IO5yFB*eHR7TosSy@K5p5
z%<(v^M~K9Dj}g`wyfKFq01|B^+i51(|L_JeltGU6*#RHmLOMabPBaQ3#2{X@5TED%
zGr)_vCIcOMKAQtGZmoPb*YY3tKn7;7U;mGdRqn8L^sy1$&!c8@I;_02Jf<{Dl2eor
zgyQ7H*@q-_9d{{=cJp!ZS-rX)e0>f^b9-^Be|D(<2~`p*qAW6VY>xOu;U6?Ppvo2f
z*4TU_j~GS@Js$Iq8A1VkkH=Ujx;^L8-d~7-{Q8f1_l<YO<SzkvXkLUu@E4ckJ!%0B
zPy{M=N8j(xCrDSefB>ipD~m6-fC>qhQqvm@KN5#8dE;;rUq-!vlIYW*$bjJ-fzLYQ
z^^TUQ4=u^L_vfgX%LKrG@P;FD$^Qv*0{-*h?vUH`mi+K??)jze{T4lIgzB{tH?Jd$
z><{&Thu~+jiys*W;wVQI$9djlSJFm-7GvQz27ClffhQk7_(vHKun%hAqv_l?;6^$h
z!kF2%vGjni*9*kP7X2Z|-T|OX$Hq+DnEA4#X7N6*GlVxeY{L;4CgNx*1WJ7d$WmNZ
zIhhhR1&87|QGPKm|K;PgyJ7K@XWtj*f};NHn*>_nXh@=%&p_qLjLAgsolKA()9*~B
zVmGJ$Yz3NykO{M+|EWaQ0qpQofJe7M|2hIup~{yVXQ8uJ1n!Udn^lJn=nOs;#XvQB
z%OU?de}FscKxd{db)WLZPkN8NdsmviDXmj35QoGNoFjyzMeiW|58pP(A#fZXCn5Ug
zj03=aPkf$EUJEx3qI_Q#a2Q3x&Apqrchmlu7d8MkzpK&z+60ec{{Pay_PkC4*?GhT
z-2e~r|3S*(gX@iR!-(eduRFrnfRyPC4~-@tdsA>%#a@SwW@tdY^FsK)Gz|^O#Yf|p
z3a^q8q#h#S;N0_>HWWM?KmHTwA+vMV`2U25=nnkGhqZgYo#F3V($A(S{~1USpUdG5
z2Q1-*`~eZP?QI|be}pC<-XGq-XM!fc&qT}5e?Wy-g6jk%?=((WjJ~<Cx30;;I1)dB
z|C|Z91zV8ANK*qyAw16i=I#IW&EQC0hxnd51mE3oEwdmt!GVBZ^q-h8;2X0bBlGk_
zd_<6CMV=SM?E*K4@vcJL!?f7gK_3;5QpPRY3*tm>VuXG2aGi&qBcr|NGb9CEMt6-2
zieoF+d{>6`;ZU`NU%Ivmag&pG{oX`1!V$W-la7o&_zet!%A9^XG?_q#XFjCa{}<p$
z{l3FyVY0ST@tiPRWo~@Rf$27Qb}b8F=>Zmy9^)VRe*x%-5S&8%d=WkYX_CTLpL)_3
z?FgK0XY%+ae631yEKW>B-cD}JIE6FEd3g;75T+ncYr{xWDSdNz0q&|igYRtd-U3JT
zSAY%w==H_Ml<hoWzW|fJNpx5<EJJ39{A3lKGiOBM0Sh+N!fWXc<^3coy77_`8RKsY
z@nZOXtNB=o`DZGw7#Z%Rcu3)ou_^d_MH{w0cu}&0$zNQVn3<n(vmXoc<V#X<^MEX*
zF>bp$<ZR18!9O;4tS@^eMT6#^XtVNLF`D>8nE7EUDY;{VDo=UlXnr=F$cHC<0gaXD
zPv1+DKqf!+w}AuO=yk-H{mR#!JyWRYV1LHI6xX-|@_(gUy7JbsWEgnz_lEqSzu-2F
z0XN-9)iyt$x)eHukHbh|f5%0Xm{oKYXYvj9`tD6Ha{gWa$M7Jj8Z^8M;0&$yhxg_0
zcun;i+Px3UFzwKN+Vt(fm<xAafa`SY@f~Oo4<I%NNqBrhtHEDYz1kT=5%}0(Bqqz!
zXzzSp#u54S(TG9B9KRp<j5>kXa6ldK_057Iaij!SpfkarN`vb>W{6_=3V!(qt-uIn
zS&$z7z{AIC-vEHaHs|-nU=6#edq(Sk;T*u+x*XS^8PH?~H#?r0DSQOYbCUbRp0S98
z^C#;KP>8(?)L-TCK`)PatHb2#r!(PNWLbL#2z?5CuNxqnTORzc+_SY94@g#{{}DD=
z3a`s7I^y_t4gywL=DpNd*o;?v(UXs)Xzk1BA?V!?-z;F0n=}V9fq3mtHXJNI*nRU*
zM2ND_&4%kU<1whvHKJ#z!Q4F0L{EW&z?s1Qxt(Nff&K|48r)O;q+#lR9dGG4VZ18X
z8dM-W9m9^iYPiaxoKA9}GWRum?U{XHUj<!)1vK*i8-X$1LHlS48i2f$E*=Zx{s;Jj
z{0HzcU*Ryr@dhU;nKf8vc6x+ZW#7i%_`D_XC08-Q8QY0#jPcsQxOee`*AV#QHGYTM
zq#4<IL*u-qf-R<czX*QS`5U<U-yQ+%w!D$?*Y$iI;UTR7<VGg;lig8oYT_XqmeiX5
zU&HC@GvhgUxFCF)ktfmdKt$g^ezzNu<>uafP>mCp5)<Ph1@H>DZ~1sA!_!YFK$G8@
z$dJMqILcqQ#BfI0d`2$;hRX`MU%nCW10&S={iN!Ei|E!GJb>vS1K!E{M`t!QOb`4-
z0tddn(Kl@YHItS7As1*l8kTVXywd!#M=YNoh(}%azw3}DE}gFV2pj_I`0G-E3H@i+
zI$)7MJ?_z{n$10*KM3L3L<V;ybjyT{?noeNt6Y=pxn1}1np_aC`tizZ%5ZXpLoprU
zs~{C=xRUs#A=^0YG2a_EWW<*qyFSPx=Ets-;fLLx^w4E7eAOTTOAm-~(UWpXd9mdQ
zTN6uGd)JKW5;1;!AP{=bdjSj8xO(gu2ihNtfY!2q*uWTsv&_fiHPB}kIhQ~^)(AY?
z;cp+whv(b1Zh*UA@tdl8V0CbCy?-~$l}7*;VOF$y{r*!exrTKX;ZJE7M1Ow%oAqmg
z&jF20wE%COKzq;yuAna{AAjL-_x$)i;4gFr#S9w19BU{nwxIk}gXJ;5kZCP{iiD;A
zK#BMW>20j>-pFD@62Xz+P@4^L816Iky^Z+!2cRcVjNJA481cM#G;NVbM}TKqkk#Vh
z16oJ*e}Gz~fbb>6wt&~`+(eN4`d3Q)M4aG&jR;&svCODn5v~~HO;Iw~RZhkjr!2ph
zPG=Jr#w(TzH&br2UMKN<AbHmv^IG7Sn#WoO&I)EwiRzyH417frdXpi9{Ti+P@qPfR
zto8R07tK6mVPB-5+7HHf4edaX0g?Lp_#vsZZWMO!ly7DXhNJ`f;eHl&`@pJk|DVtN
zl=90FEW3@)h~m6WEL)lWD<m5Xoqr-G($C}mGHuI~=e|0{@CCH$AIjTtz>Ycrw@?tb
z%p>5}?h*_g8AaR>KbrI37vq@|e-Uz-RI7yQ%R`Zy#0031Y`V?I@=PEh-Om?<{M*cB
zw}>w^Ade97yqF6odxoHk@d9M#!_3;DjX_88*z$ypjS1*|_Y4j74~y0gHx3(7r(SUc
z=wE`&J4hg4Abi~(^M;pF9a3@y$K9a-x;~8aoA;eid_-2sR(&@}ZfeYm7z%yxkAO~X
z(0|&T1lZJn@c<k1sQqKw!gvvG5Bq>Cw^6y196Io}W&Ug=XK({|JBZqiJNWE9FGL9U
z5BC$Qc-=VI>W=%j8nap0(2bLe$E6ZsuP1X6wH-PA^=iKb{{WQykYDwD2%CVurx$n=
zt+@qhg~wAL_{gg}X+QG+08hUpp6bl|dUJ{GS$<9Mm}KWq_`Ie@TnXHuAHYoUBX=;h
zdY1C=74uqY?r)#Yu{_=ghenT!;6HyS=8if>;~+<9->3w>`8m&V|Bm2A`M_H*`6eI@
zTFn8kv^u{jeZX(SR0Dv2Pux)N$dmg){cxQYFbG6V%OY||rMGMRBca|lzjCt%A|ey6
zSeIwU$;Ei|Xy$jxh%J+2a!cZ=<Jr~D{6w@}W~|u>b8+#L9}y-F&|DGXJR)BUCe_K~
zM#J&-vV$6wF?i*|gM~jsWq%ci5pjlvBms1M{FGP+&wWj5n>B}t$QK`Ww|??r^WWb#
z-M<qF81W4~*hF-no#GRZVTl4O?AG3F3BP^N5UX@YsvITw%m(gvKqm6TM0&B=QJs};
zHsEmCPiTM5!<P%q+oAYMYH^&t_(rNcfDz?wapMXKJtcxRp~qhE-#;4+bqdeD^Y9DT
z-*$FDBi{kB>;R14pw8@098HbQU>=^MVr`!UkC;pRI{_VT1NYcu)#zI{HH+vUqHQm<
zbLy20C+z+49|CMh-?zuEjKG<hPp|P96bScBg;IW6<~0JWpcsflnR}<$YWJKUZdt=$
z5f?GA(=D_-uECj>A}^@P9sGPFz*g~mG+HUxYZSIRR0kDL7r^dZII3W46tG~LDcchl
z!QQ2wQyDBNrj{lz0!HcX6sc~2b;29|5%7hS6;Y@Tx|Xja$xAkde~jU0Pym0%rYGq?
z)X|kcJ`)V_|3v;G0QN_z;2-g+_)hX)bAQ(eWMrteF_U6+xZTX0eN2iqp00CbSaiwW
zUHFpZg^@T;izE>~PVFShxI&SmMQsrR0FLF~+;cnclVmh9S$O_a=(ECtdan^J70Ct5
zPCa)9Q5c?VREO`h$HZ)n1u=?eK3?lrKG*Tmj|44s3-JK7^=Ev}^@eCM<2d{!G;;<y
znURul7;8}(onbY1w>tbG0ry@FnzF10<yl(-FKwn8Osno=O3WWM$8FLvram}lUpENf
zM3nm4>7~)tSHxXepVUMnkBl>RZC2QSgtHn>(FUxsh3^q2U83_|pNI)uBWy(g56ANw
zlkr&FI`3sS^z!hWkxH2&mQFfG5F|>PZ-;nT%V`oh#DqGnF|E}<k`i}BaRH(y3FXFI
ztWW*Zz3`S!$_Gf%X^G-Bh=Y!9NDUTVFSrmT7s5U_albZb2CTSV@yxAAUT&e%;do0d
z0|<jL<%Mb#<6bXS!qMaryX~QkQ&PfMe4JN_#k}3WaQ3&W7(ayb!$BNDU&2}Y;qA{`
zjM#!>Dw7Z5HNrUX!MM*iF`D4MOmj9+H^h0p5shnzw3c=`xK4{4jZCICes0(&(*JYC
z+RJDQ`nimNh5lY?{}EiWK;kq+=8>71n~LX}2(a)V^I(zSI3PvP=tlb6UJ7vS+6h=5
zgmKk@DghN+E9usLgQyZW`US({vH&*j@3XhsyZ%PnOs)`~3Vz7V|C*W4uUT+*S58&U
z!WK{=|4)lQm+*jztzKN(s33cPo*mUdk^6fD*uCWAW~e`3-WlDIjedIKLca~0WdGoT
z0RN^-zi=^nh<p9+0{0+2ECKh_=J|{uFY2dy!jJQERp_xEA|s>`w?V!T3;2jm_#owB
zkr2-X&6vvy{C_ljbjuxI2*yN)olNIuZk;AJv3zDUg1V3AIQRMyGiwt@xx5gx@~;Tw
z(<0_Fg7;__U2|+t>l4l4>-KovU?Xcsc*tULU5F_@-b=tozBjoijvTUn&&7Xwsi-;_
z5)Oai85bsD1)UCY)GCd^Ai%tmKJ$w!g?-P>Fko*T5rPg`<J3kL=E5cpggibAdscVX
zhjF6;D-tJ$&FDv4FZk=~qjvueqk-ViPgnn&!4H?Mcr1?~5_W*z{Rm#99)|g_0*}{v
z=j&;s{s;Jv>f6}y^v+eygpG_G)g+A<=iy8vXaFF17(>wE=Ok!nnf;=>?OreR7oB&7
zGrm99h9Eq{<GSV%#AVyfclaQ91Efu2`wZHxEC*a84W68BcOka67p*araAnAT^kvt`
zUj8o%e`?SZ7f1d;FL3-@D}~SqBzOt8UrG)(7x#nj-S@&AWDrh(01`p%zE3JFw4a3P
zaTyIL@B)s1_s6EM%~Vf(lQQxM6%i!TKD9nf@ca^Z40>jZ<2rzm>H=T_&rlL$83F19
zdUH^~Y@wlhRq@~BK!B(bIkyXchaljB8>{IN^v=BVf;g<%CZ~~4$IX8OzNEaip)(i4
zO#TtV99*z5rcDLlAl=tt7&UqR<G%QdjQLU_5eM*b5u2ALrD8D?@a`M)Wf?Llc~%>?
z4>+8<${V?zXI4Bl{<t8HMj1x=20p?UsMnx#U<e23{B?kUevijk-VBUytTcucpnyO4
z`F(r$`2#J-K`tr~u95c7UGoU3GvZd|t^fRY?STXE2e2V+urujZ`G$Qe-fsp3Ux0^U
zpGw?5t@GC<1P|a?V>z}28}KUhK4;+#gk-dp|JIzd3NZd@nY#}WbVTEZGx1R5nMi$j
zD0}mCJx2U@$1thj0J32lRs?zxs(^=Ce98m@*Xpmg{bF2(l@n*?#|@qG(LN7&OB~Fb
z%_B+s?ySrH6Z1g($8i|;I1G<{jx^t(@a)%<0Ra6Uj<ELU{^ynA?p_kG80g4YY>P+4
za#Z3oAtyEvvV<(74sNIK^YPek!7FtEbbT4Li>Um3{B9XzL*{$pee-|h#LdQ>c)WJ{
zO_m9!ig~^~AR)keCTtzlPCu61d_aFRhX=+^ZYPvQ%MW~!<j%P>NAJm^IcJ7=E-plt
z{2^`G;^Bx7JBUj-=*T^Uh)2QK2<fM{HzW64C0St72(T<M@gI|o8Q4dg1dmV}pJWBl
zAH4h&;h%>iAiW>1a`Z3Ez9F|cv@WCP=D&SS6Ytm6a6y27(>Mbjr!kBe5)DR@1cS!a
zbqE8$?y%ArQJ};B?;-J^U;HO(8VQni8%vsrH6h1{Hq)<&=7C`SkvREKmI%35nVFfK
zGDwNC#&{c>CPsk)@!WE>v&;mKGqRWcB5N17trIw75I1M|N@UUMZk{Zev%9OhP>(yA
zM0|E44){xla2E)e4-f=<jmA?pR-Pu5Zy1m8`OcI67O=20#j(#GA;`@*LxRW+6Zs(e
z*YD#2|ETc6&A?aM>UypVFqmQZfH%-_Bz)e*0lC4^fDZRi>svwt1OM3X@O|u|p#9%-
zZp+<SSINfbHN;~>A)%>^`{vOR4~V&7t2YVkrb!=+<>bTMn4*gz;a_?iP>(>EM#8sx
zj3THB|HScep$Ng^l$o$Z*t|mEVGag;Tuf-;xr4BU&Av=%&p^TN2;)%(3<QaykB2Vu
z40Rv}*@oKsyZFt>Q-8L&5WNmM^#D=+t*{7Que34{PiR43xDYSs`|D4?MY0!!`6jq8
zV)JI;z<g%w$o3F1hCzgPnlxNgzV=hozHaNH@m9wZCsNiGtW$i`K(NmdggE-a3bX(V
zAZQ6W^*QJ+HU30<{@=oIN9T;~i4B-mU@z9rnGhWh>uvH<LX!cUMk9*N@yz@9iw&su
zm%e@g{&Qg-8JFAyE354d=6toq+ovr!Pm>+Sh9)B!iH_nSo}Dj-bL8g8%&Y^hSoJN*
zs1n~MIgAV|$yQYn+{q6Q%h@=-D^8xSNQ@)Gdn&Nc2~U%oPG&~)OAW9`&5sNaL*wxf
zbpls-?lc+%6?y`E?+JUm$ZY|9ck~1Bhaon5?-Jb(f4EJjFR#{mUhk6}&xiO<izJBz
z@q9+MMvubWeO^;3UkSND15mt2!Z1BRAsWuN=X?MEa%87St@jeV$BsEg?xw1$Ql%6W
zQh?S1ECkGeE7eW51gD`!ilyFApy&EN{k-g)muV-N|8>f`g4*&u<yQ>sJ%&gr(56Pe
z_kP!V3O>su38LzyMrOC<)a=i{hioXgFGf`=YctRk$x%}JiZD8f%B9d%D^%pxQEsXk
zprE<%r9%BB^vINfRxhX|2&R^=W%b&tUfO+&sdiX&OTcqLUQ-y48O>{_fLp-+Pg|6S
zY+%SMKueP)7)mxbemds8j~sHz#_GDNt?5#V3MoPy#Z<vmBG5=}TMlr}8JCC6`~*c-
zV)$X810u(UEQA{*Ic$riI59vJ`+58i+wHQ{XLXw{a?YvtxS{=JRIS~p)lEUk7HOCJ
z{R=Q!IGVZ_`t6!t+D$!6>D{lTEgc-H)7lvJEVU<ULYSv}*k~!GWiQu`sYTVRLUm>?
zrKww_)4I(&-FxsM8qK!<|9}5-PmqxH=Q6mnvLwPPl8RKIr6_Csh(EHI?t?uK+LwFu
zNWB_9uPrJS^S}1U*8R)(#p@3sl1fvNlE>^gwlovaFXZbev@h-+J1taph$NfIUi!F~
zW*5@ZEV>1$#=2HZ*cG8I_w^~}Q9B`slD&D*dNb0tg6La8U7BS&li;1zpOERSy{l3p
zi-dNh^h*UkhsVTBe<Rv(V}dv%OlHezjAH{_!|EQ87{(xTnaMsuL)V<!jr8n^Fp8w2
zl_)7n70u)B9YqF+7%VLvTHB3&x6OCSlz1;piGL42anD2HwSCVE64APYxH{DsH&+3o
zXrHZ*T&kAWah!*;SWBX#%GZkV79?gu@jUU?#|LoSy&R;iRlA{BXNGacFB*(UIq|XV
z_wP2AyymdO-(>UN@W*E#D*kJxL+bK#X|^#pw$ssl7}l+yB+Dc#I?Ol#06IiLn}A9W
z_fXtNHwZoxpo7UYasx~sjST|#LAxKtY>0jk&OQiYKmY&ut}d|Oge;@qG2&0YeB8MH
zdi-+dKPDTK5esl$KVqMJM)3RF8p%j6FLr^C1!~G1C;O0IUhT#R4YU9s9}yKR3KJ)1
zC;tob`LH3wTe$~_`eJqQ@M&#-xcxtm<ktS=!LujkG9oW*Y|mP7#|4!hSszU6P?fO+
zjg-<oKx}o8+BWUZ_{V?WSFranF6h_1ZVC4ZrupMBrRnUwJe)ek$}(ci&K}3+v<bX>
z*aAoC2I(7K?D2IQWc$n-ja|mXeri^rhr29hbMnf~lY)L&(BiHa5w0p@IKau}mx_*?
zmKo8jmQ-3g=C?@i@je;cm0{f~g1i=0qhLn$8`{*i5ivAsdXfENA?VTV8$cVd_Y>;g
z_51UbUoIZ})d6Oq#2T_;1&@rI0XwFk4fGsJF6iw2`OtC9f8ZovMz<jHfHTJ6Nc1?I
z1sZ)lOj8}pKl-Ha9%6GwcvfrS0}uH4(MRB?9x`Z$p?+rAyW7rU%<x`$<8$5J8ObXz
zB3HtE`OgS{5%7-D_A65wNNRr!L}!S~e)&AQ&c6v~KApw}8I4-vyxB5VUx~J3PBW{M
z{^VyPF_9RKD_YI}69fOG_}wYCw6oKD{_6zq=BNktG6`5}?E{`Vp$;xsb}VQc$N#03
z+5fPXC;udL|I7^W*|_O+4)t>(=&bz<t>2fA<)-@Yo)GU7SKEKdwAw<k6JjIzv7=#7
zwjMiVLl{FjeIm^NgnS{_Lg1H1kPr_`Cc-B$gMj`J>W5@_;GCn@Aac6ya^E*K74cHB
zLy?&h-xY_sVc9YLfeoAd7IRz^E<ISo_+l>zT%qh?$BU#((ZrQ8@AKw^3-LM7jeukE
z`{52sB&9?nh=*w;u+tGXUZ+b4AfF0xc-)P7<3k3VBYj_3Ab4LOiH6#bto&Xwsu|pp
zYwbv=d2NCIC;tRp5ArIJ$U0}s_U7itu3DjSRls9Zpjm{SfPWRBME)OwL8E#suZvS3
zv>WlbdviC%H*^hs)>OVW(FaBqge))a@!jh2z7yYmma+1jGF_}!!Uq$N@4IOZ8U8Oq
zhpP|u*Cma*8{;*CM~dtO-aYKd0K6kZ2_4?5a7e;>Xa5bQ0`QCyc<=ih*U|p|P@(VN
zYD1BP7KVA47j&EXpWLpyzqx*O$#R&j@p2qIJkyhkl;q6YPCS?qiGdO$JVd*MuHenW
zK5p9tV>L#H141U%ZyADbFLDAs!~MfsRtDX~uB;DwULJjG#OSW1hrl;(Hd*7X)CmTl
zCqW3s)@ozEU`?C{zdIbPB7>WoWXNY2i^~GR$rmM2=l(J`oR*98Qqj;`rS-GqW@M(`
zV+y}{U`_nhk4;tYOnPhaUU#57DUa^ShZui++bJNpi4V)q{TN8t;z!h9tph6iPPuhX
zNQk-MvcDQQZ-jZB200#{LpDyLGjnaoga}+$lT8e;_)a-41gvK6^K)+X5&1C9m;L!<
z+vV8qxQib090GlyKiu(*E9vKdn(~`qW#-mqeddPvM{N<I!bW#vCgP2Mavx-`TqQ!2
z9TrGZ@m^@MY!F|#sRkONlV_ij!W_=5$D76{JhgKUkImFOb)GxNN;r2cY;dz-d`gUo
zwG0`r9sX%V9O)cK;T<?-)7<-KC-FWa5#7UXUCZ&YoBxQUKcDH+^7BHuBl5*qFQjzy
zc04Cx!ir-<7BV~V4BWeN$?<+2lpzFbzs1p1Az?DolE&g7<Cb=2XNbw(9*Hx)Om{!;
zRdc;}N<jiTE(y5HDVP-_FzrdQEJF?1(vO0LFE()m`pIzub`uCxpC7JGHt&Rauo3Ac
zmP1mPAS0;H@iRk6>Ou0MAX^v0SwwF$6!8&!ddJ62o)VQS&xRiE#{O>zTXON<2_Baq
zNb^0EKGlaW1YQEp89@m{`n$w_5vvzBRv<Ct0Fmy>JSU+ZvbEjzxA`jW!|^=uqRjkE
zo<A|fJ8Z^h;T;s`=J34QJvCKT!Z`KAL$bSJ{yx-<wCr!0gZIrJI#T)n8yXvpIUE!2
zzF|yhSEgY}@B9B>5W>!0KMcCw)LI=mzl+C;z@I^$`N|z01Ulm~o`q$L_z`{r9fOIF
z2{X6}nfyh>DVGqYckT%uXEjb2u+6H&mE8e&Mq!r75Dv*^f+aIlB6SF0Ld3eteoi}X
zV1OWNOG;-Hn>my}=FQ9?EZ-fQHIdr*+>-anjW1kYYr^oQ3;UUjkNceK(Ri5TZR3Cq
zgpBld|3k4}WNnXuI7i0g`MEyW&BSTU#y(^7XN4D+o*x~mjusG1^72bHdmgO)QQ-?D
zpJPZO^m_HaE)ljy3lwmzLIzAb8ff%0^G^lmJ^tH<2mDT+6`py@?~D6=@SI=}CZzc2
z#OHsx5^9Cw_C_^~P5ehSUWs#c4;!<_cy&h%Cgg(A@6of+9cR5mNi{*}R%VY!y!x-T
z5vwzW<2m%(7S{rA-*FRIr>Mw~?l$AXUPDR$@Q$$bz4d|zfIWej3o2n<&e`v0_=v>h
zO=WFzB;NFoqVP$LU?F9vg?VG(rffA}0F3JesQ0cnrQiOAA+$Q}&k@tNDkB#Wgd#9Q
z-biHTl>R<5dAu{b3*9n?1^;;rQnlUak&EIq=4E-eqP|)0mye>%hNWYck_S8?)qJ71
zlbZZ@-VwuBo*mMsg7Z*?l>Dk_7X|45Gp_e{r~BK9>bvb->x6R268V{J63or^<=@|Y
z@Wd^1YCJ+lLu&CoTx-szhcO%z@Jci%8M<3OKc1Z#jKm4N@v(rMAOQfIS<u~I@SVM@
zKM6neuZf3b(K|-e$zYS|E$3iu{9l_V)1M%;d(Xj5NkE@psqHUz!Tf)}bB<n@Upu=w
zmT`%07YN%($e<2nqXGx^hBJI#z@=R5*V9oLS|bH~A>o}c5<QCU%6h+AKWGPK@0Jjc
z6(l~OLjC?cXF&`IN|4nvuTcSLAbyYYT#=*ReGhZJ{3i_0rNWy7P~<&Y1Q?QVoQ5o<
zgwfv!=H-i{VInb(Q3Uz>v$Yj@Il0J&@lO@4RCr_wS;kmuJa!VZt^y_xaE+{SWNNX;
zXa2)>cka2PiJ_jz&8dp+9z;B_D*ukdD%e8TP|nqUgzaBz&mcXoi2k_C>qwi-i7o%)
zA}sx>*EU%q2WsyvEyD2|h{Jri;j@V4ohDP}?>Wg3cuqPKP23nO)&yUGhfdcwZ0QZj
z%wo$CpNr5^LqP<NG`|@^<BkCK>}ejO-r`5(d**pT!2$-B7kvuOTSaTe3Om!ki0+d4
zgBIgLN5VV22w#?aYYA9Qf!Iqh&OqPs%bHuo`4Q<5VLYd8<cFFthvMeIHfmdoDp*-k
z-{RuUEH-Le$o8glvrEO+5o?%+Qn}VaLL{dknmi-UlzJ0~d7y^0zsM+sT!OPk^uNqS
zhs4ZjsVewZ&}Exs=EJKjGK3c^U`&^c$AADpmADVNE3tc(gEruR_maI}UlaG-C1+F`
zG%@aYQz~UR6Kc>;-a|>=e02;LyKlaT{Q(=yT%3P(@QyGbGO9e<i~#_LY>nEqANgwL
zbJ-Ea@J#c=Nb_B|?-B5fZ$5`p8c%=ko3=Thj>{6o(pYD}-}YBj8~054pPM8zb7Y9d
ze~z4K87I(r_3r)tY&E+-i`^40W(m!sncflecC}$zV@JeG$9ZKu*|jN-E;Nn^8nX|K
z@aq!<FDyey{T}+w9*=qMhCykp0Ur7I7@oVI{nV!67;SxFZPFSNfvNt#8NT=Y0)0Jp
z4w`<SfJklWKR7u3YX9mF=NVOZ1OJHXwJ9gzuMr-eZ~R79W#Ck%f6v5lB`cmkp`iIb
zkBNw`e2`Au{#gJj&h~6PA;#b2XNP!?5;r8@u{}o4GpGDqM9wwM@b?*a2h~bWwhwCU
z$-Ctloc!+@n};>vpIG8aqQ?J$Yw0fjFQcFDMF|=Vfdi}R$`DT(j}ieR%=S##S_!p|
zE@RGv%jC2NTbFkkfR~y@quN_wOS65?Is1rO&v^aD3$78?yxl-I^aNBPYFR91Ja%J?
zlm;})konkXIObpbC}=<T$!xGdPziUu@?0Z^U={@I`^q0_30cblBf|S5Yd!Q%+3!dD
zelw6D|MG?g(G?>|Y62Ik-he{=E%o+$NL{Q)#bOgQv#7pqSdM4q+kW8Zn#yOgKQ60W
zBh(>bBT!A{?m$8Ktu?)1f1F-JN&XY)$X`qmDi}wD+<zD26P5<erS3C336b9}+hvEA
z%BO<n+ZvR|c+5J9wB4{%bLxHm66g`(EQ&m%1P+DnK4awJ91*<FK;fRL8l4MVGb|z-
zQM<+QYBiwM?9tGJct(R5I}9ruTC<;PAVaVvSPyl2IyE~+kb6_~Zyf)5BX>9di1?1t
zr0MLZqyfKbRDk>RXQO~GCpRC_GV(lMpvGD>?6nUFMayY%)`))$ct%^lgkt6-Vp(u&
z-^Ket*K3+Q?E>=g)`KTwKS4$R|Hdz`j^F?B7T1w^)@RZEPU<%hQb6<z_;^=@Aq&(8
zr(SWUKI1+A-LQntoPNTewEK{={&$=LXRSEqyuL5F_y0Bm7pv9)k$p(m596_+m?F%m
zICd*5wg0k;7xMDtOJul4ZURsAwi;5|On6}VSS}Conw%=n?+y6eLiDq*8o**2Y)>&8
z*7xH81JB=ynX|jIuK9NUBUq79)W+a|YWw4{>6RTQH|%Y<SV9f?s1F(%K3=4Be{;is
zdvc;T6|6gU51Gf*epX9Cj1V6PLIxh-#=fk7`=jex(0<<B5$V_^!NidM<Hlelx{cxj
zSEFyH9o+1qq5RB9eYpQ%XV&NUL1-&`;VrQAyo{AcmB@I94ZEMNF6cJiLlzNt<Mlxf
zj3qf6zSZf!<32S&DyhVv@6w=K`<R5<@v1#UNKhR9Bg44J*_hb)|HaJq4MxXn=r??s
z1PK`YXE%*df~a&&=R=dT>Zt(6((gvSOZ$Alwt50#M%&W=ukqgiji<=_0|Nh$=emGQ
z{EV9P+7E1MS?&+-f{zLKgP@ylAlt>1-RR#1oG{2o+ZseH=5eEnOZ@XaF5d}8iz+{#
z{3i}C;rqYkyYUK?Vv>wv7O?^)4Bv0~kGoOw!qr|Q0LEo%<K|D_2yi27G##Y8BzvXE
z@0b!1`!@-H;G?QIA#WFi&M<c~y>alXciLb2MOqY>`~YR^?P>RnKja^IKQV9oAy5o@
zoV8`+7()g3!{g44`3b)cwf85u_{;6ki@5&?_$2#3)ld+BfL`Dc?|_}Mw+9X{^aqyz
z!aV_w33*ubF?49;@=i@T;`r~3r1sa2rW^cMpI~Lp;{bjT<HM`ZPUSkvI1hm=L>BO#
zJdq?c2DrR631@>hK~nO@QyWan$yBCXyqLcc!6QcWq*v_f4qn&rFNvZ^p^F1&3<oE^
z5$z5L9FR6LDl_kh-wETU{~E{fUT)JieDTy#I#nb^tMK$ms?5H*DA)=*A-o}=EUyf~
z+i0dV9JYo6{w_1#`~<A62j9XtCh(>Jg|D1>FZC=q1B$%?)}adfKtfV90VBqz|Mvy2
zKu)7$QKx_P!AF8-&i0^}U@(z`&#!Nc@Fi;ltx!tL2lb9ui9fH&fBc*7Xz%L&d?7a{
zA7A6<d<`!?U_jFYqqtrWIM!do6CNoq2;2oN6Jpo!>yNHZx&j*H1mnNq4A!Jk^?}`C
z3F-0;cIe+NM)LR<SD-pO=<&CpG}j|u?;WgQF9djY+D7+7J5{;BVICdtowLUq+M|c7
z{wtLdMWtRNe3I!St`m=4`g?1H<D;#lak8S+qrNg=f<ai`d;PR^C<rL<_E1Xf?cY{s
z=IS{w5hsgYTy*akj6}GID&jnQMch{i<HH3_K5C^nu*{L`fAJT5WBGYJwDQ5MGwLN$
z@<zi91IB_ko6o*7r5cc5JMlV9La^@_BeXR@7kU<RcdQKkUsKOv5D541XJ?MmNCAcG
zbN&KnxxxB>(jQU&^o{HW1b>HMKiZ@JBjuOto4{ku+`Ja#(9#u8(Bgc8eR;h~gTF_&
z+$ZCCH#PnuNS)z|!V~aCs6K}Y+u*vgJ6bLiCmk3B?dN)HDXHdeK8e0xS0=dl%lhHV
zs=0gy&#pf;l?cc0r>|To9s_hD`F)KB?!3Q%N80a`^Lpa8=0K=a+E%%CIqU8^GJl8(
zbH-dyjk?rEUS6g|_)5Zmd_B3;tlRmr7>!0k2RtRKI~XF^672qH_{l<H%17d}8XK#P
zwUdN=dGXXCZLn~1CcbU?S^3%DjPAx+=_>wt&j~mo@{SjqjYx#tc<t~w0r&FwKjXj*
zZGMNt<^)TPXS@M_tpT;kF}l(oxv=~t!+=2W1>?3xh@1K72&@py`22wT!2gND5uAOB
zL+Bwo$n97LE%uFezm}09Tp$J=*N=zEarVDo+rfW#e4m@!zex8lgWme&KK*-FyVeVB
zcR|YEDZk%~{04LXA@6+@XvdDCF_!2J9j#wd(UV|qv}F8NtO&3kySbl_j*OqDUK{s>
zZH^g_O=^`10BW@r$x0bZhp3DkaFp{zGdY?AHwI%rHZ%|uOC|W6%+4Sww>R%s<;JFY
zxv_3WUkLVr7l30$U?%@t=m{Q|WX-dxcFURmIukg2JASPHJ0sPfqX8glGSPWPPX1~G
z9vDW!K9>G|CPm<8(=LZ6#rE%t<vwW0Vlg=32ghh5aQ?s&KX8Blp}pz@$T#{(ATlds
zuy8<k{Uh@X+Rj7%Bn@y$haA9*g>kvZK05+EGPwp2gDbn<Gn#+rndga#2uE^49w|=<
z$1fS>htNWJHO589={G?ua$a$aO>>9G7c5%bAh*;8U-Lq0n|(*qye;YLN8e8-5$BT*
z(<W>KYs64WFXji7H%qPl5~6XUU06ruKt$%CoM#>*^HCt9S-umlV>hCFx7-|ZK~`%U
z2E+4b(u4)ce0IRb!NFK&WWCw6pSX@mykt>Y;U0j1f%pTugN=^hNb^0DHdkd#6YqW|
z5-JUo_B+-_)@7@{-|>AK$iR0}2v;cleEfE98}Jo+jXq?0nb*0_tVYy0>&_s{^>3R*
zaRYucXlTh~bB+MFt?56Yo3yhJjZn;p6MpyeuFT(Z5Bbt<{*`;6!>(*0<?J+MzPWqA
zLe-x7fRk7pBl}n@$MO0(JIcG8A_5=SAHAE<G>+pdFAdClxpa8j#48H^9-YRxLIgb!
z;aT^SRF9Fj7!dw(_pio!O1?Fue!-vP<Dz=eGuOj?Z;q3{jN#aaXVlla8|FaUJs;h=
z<f1$#N#P$FjJ-{eoFIR5L4m9pd`IT-<Q`fbtV_l1)HtSVL`DvK+h&Np&j}!SK5Isc
z3cnG}Cp<q9_)l00l|pcQPHH1RHBH0z5GeH?{QPzqkbx70F1Fg?jUmTbepd3~jYE#S
z>AB6j=Fnyg1(ETZm{DnybHJOr#!CEGuaJNJKn6cwU;amkgZqFn`uKeQg@_IP|CJy2
zLHWEV!^QY_4fV80Ac$Qb@Fi;lJvR&;L=L|vTxKS0A$UTu7>~qwkBs+FA$u>p`pyWm
zCNn-jnY>eayuX1C@z(z*zz+4=LCWiIoPM{2Kboty2DY?*iToG^zayR^`uRGst`YM?
zg)@UQE&trmWdDid<0rDLL;NG-01>(X$rk^FA~0<c;y=D3!X@S!dUKg}`LkiO@z~Ll
z4JR#5KeA8%j>{MW)%+@j9rOjBKj26C8AfGo8MO2r@9;IjX0#Omk4$r?!;p#19mKMO
z5B)F=@py@Q>zMd>1#$UL+&|2IXP2$`hopaYd6~bHo;G^z;5gpo1^4Hh9ytFM<3`0m
zt$anx1;+&aXSj$<9E~g=80oP&#AqkK|MGFs8|I=WM$7}AYe5dW0EKk3u8Z7wx+ZV`
zXnZhS{|QomKlrQ?F6{zSPeK3w@DV(kueDN@d;#jI`aZf3-hS0l?(qI>1Z~<5K{J=r
zvWp|`8bU{<LxAML1&HQ|#f3lr@xCu7fQ73!jpBVSQ+{IiMwSK1pO45<e*u-+b0*Y3
z{~4{d{ZqqM`;d=MeGJXz`_Y5P_7S}xE4AN$@ts>?WSbpIAVLN#k;kZCoROiPd;bVc
zgrX_ps4lO#excf8RFF$1%PC2S@iBO3av7S{h%^IpFTwnp+)pis9J_}x97Yx5Jl;YK
z`Q+?w_{(63@cD+wxiKT^Y5l!a=LwtjzMXv#dJ^v)w9+O;R(>&`yuN7#V*p7&ymkRA
zSDjymW>@Kd*x$+=Q^U%yq;p`Aoo0?)6!`f030t%O)8xK69Y7<*9qTwu1j7+A0wXYl
zxQ~zMQaMXo=@*YSaAC}h*#BdMXMd06_y=Du>j3|M$ezCmBaL!&5xw%w>gXBYk`?ES
zhUIi1jUMw=tDf+_*ALiT_WG}YEaE{cI8FMq@zvw7<fj5gCxdNe9AfIQ<-5bi);ZPT
zz9Ym&X+osT{*YzJH<LbNXYOo3#y5reIc8H3LBf2@AfAddm&;}1d}>v&EH%aW_C|sa
zu5Las+x&J!hY&EKJT+0tbye|rCunM4jSr~2R~QFPa12(^_9Gn;&vE~V<|p(xtNhsQ
zAdguuJ<I*$d|o5Oc#%FDNn#GGOpV%S5+jT?W@=3HR(0zU@^SD$WG2VFd0`8OBM06`
zKPNR9rwBx?q#a&5ZsEcrJYZd_&!4ld&*7aSc+$ji;yg@Wnhb_xFT`B2%#-Hu_ulap
zG{U{nKDlK<cyALQ&22KXmy&}pi|dN>Lcqpud_$s_L-TDZBjd8AH;HMLC+{2e$-}b!
ze;?$EG(=*db_9bHj{?8sx%KFpYl3{haQ+A-RyyO-By(0EJEXw`Oh!8lXZ~rFQ@lrr
z6IwcaITv!8AyON|p)Mv-so{w+O(PU#R}c~IS#aCMl?%Q*%?4X(D2fK`EH}mY(SjsI
z-%AmL4ok@hQ=2a^kM4pQxHDJg$A%IPKONf{QI(}tn|CJ@w*{0;QOl+U-;!J`A%vnP
z<ne#Rl2bRXDm-n(ETQW^;2+Hs$M0`9V(WyZ5q*rY8Jyo2;VU>Bd;6fF5?C_tBr*N*
zvu3!w%*K-&{X~9kvxpd%Et#W4xFo1T!}t&r?|{3;x~vP{?}RweAS4%z^^dIlUJM6^
zBIMQ_d``1)5$&blquM5&sXS|mj??3(4XUN#9tgbMPXri5z|MoPLU0vqG(Y@C8HA80
zXy2>gF|uDb6{~6Gq6@-Yz@lNWnxan;aLeB&BkwKih|n3nj!byKDq?>%x&OpaF}A&D
zf5mZx&Vre!L9ShnUb!Ulc`*Q=CxGuH*M|I-xT@qH0iPrt2nUi{=VYEQ_|PC)eD(P3
z+1>bYHn+w2cI_Wa)T;db)kWezE+V2ZW5V*YDu~(->tw6rxwB-E@fi$921L?riHf2{
z@JWJC0isZC-KpOhfga<q$RT0$Rn$B64f?G-0|D=veU~es9Q68ujWT%dpeoet0?kDi
zayGs3;Vv3Why@imC1>#hXcAwW(Jat*dfUGdF9rC}$T|`@)-HnlXjs?rxp2}P2d)x^
zVfeFXe0apwf^l<Aclf!+2}n3Iv_t+cJw942F(~)>_r7=dstRU;nV_a<DVpMOw8csb
zR7$$Qf=K;0`7s37Aixia@cNmHx@Se=1!JOW1G&4GpY3OX?Z3uIzXM|7s=$~^d8upM
z$G*4Ffp<_Q^n1_|TnAe)&Uh)BF?k%pMc#Jp=4=Ucf2!u(XCDzSHhqnWfM*eo=G!b&
zZtoMeJg}L+e2|HpBvU!71tqiqo<6KtD&+M;3cOGTE7}O07IQv6^FhWhn=t%LBH&+}
z&XpI8^<LQV@Z_+CQL1@4#GkdCOBxBRP)kSrRy3HjHO5m93~?ckf@&qe;6u`!^<rL`
zCp)W-%!&{=f6xiv)+#@hI!{IM9amNH`)fhT4>MO4B9;_;t$)HFd}R9X4k?&2VFGiS
zehMVS3ZKvC_Vd1XlafYcW?op$F}qCH9SHJ5>=58ZCPD){FpiAvfv)HMjZA|?pBm<m
z3??)E)N(hQj@D@y%k^BmaL?nSF?fjHFTenf%0fD0@+$*xN*$!{pS!#%%c~;5+}XQD
z*Mive*V3f^5^#>jy;DqvKaa}B^mDnYel|f6MX~XvdcOdTCWsA$tQ>hC9bof&h!0lk
zbsGPTzy5^W1dLOIcDZliL$YKvAV*rJ>y51Uq01(CKWQ;zIvL;2{|p88sfJX@&eI_K
zX^Z!jf^l9Qn=o<I&ImQc^RYUcb;W9K$SPW9iE?43Gw}g$8$Z*jo!7=Ld|++L$6u{|
zeea#~y>VQAnAPc+yQXWB_mnp2)XF)S`IwoHv*K(-*sc(UIz+Pv7bMIaACWT$7ZPV5
zzRDMyBhtSUJ4*uojNySd*B#)O#{A5l`XK3b!?7k%@9ric#Q%glP%}ZWG|m_nI|FB@
zi`hO{P--F)jhW9rlk1D>mVAO(AOis))UMu*xGUc98p?(nYu7$=&wFpE^|ypO9D%F|
z>O4Y5Hl4>12ej~>A=sv14(X#U28{8Gfe5?M&if%I&JKF?5SgL4Q4p``(5_6~bOfR~
z<j4Tn6vDpm(vr{sL3Q3aF|XJRtRB5EehFZP{t0lF##4~2gLbh^#l(5A-3?^CoYt0e
z9}&?RDL3SZ*DgG5GJk~OmgV`qd}e`epdFaE2kj<7`y|G%s!VZFB9ax231si^$ZHw&
z%Crmev2t+M)@M?e@vE7H-~WVM+x3YoCx7O^z-tgcjSR?{X<5>mFc;RAE^Ky|^77io
zf&>tE&iUTBMx9L8h)lR#AM*cq;q%4b{5=wP-S|Upl1|a_%a6*qj7Ny^9v6T6z*zX&
z&)r-h2NRNEn>B$5C!~VsucR`BsjxCh7vge7KD>EW5&MNYCGDGHGw~GY*zCSb_ezCN
z@5`P#;<PyuO26fui^+(DqA~D51`Y@S!NC9+Ar32K(9RWDiPFSgdHByHBZg^GrcJ1S
zA15|6aJoJwXduiZy#Bl9<8zzgEhZau(taYiDzSj-Q<4inPWJ(#xM&xs28hBKagTn!
zS(3vP&xx0bsuDVR6HC$L3<}_*9|c@|BypkIxioPcS=SYvMBxC-Qik=-$3k`CfSMzH
z&H6j%eDB2mSim4H3<V5MBvU={-)8PVVltWh-W{fRP7?>jmTt*3lDA4^sbu8BM%n+2
z^MV(fc<4vKZ>E5f_v6>RPXxXn*6Izpii4(ea^~A0Md6MrgN-&c*mljrTMTf{@b@mu
zi4!rz@td(faN6)wnnatmi7b(k1@iBI3FF2)Vc3z(cv^3`X_ou%!%<{O#7IQ+##w#v
zmK%}6$FMl)oi}jHE&1O&=l%)0X)M-=ij>X`mCek=oZbVqrh9@H*|YpetRioaa*aQ5
z`j1Q);y`^Vh`()h%feLSV+IVG-{LLG6G{-a*cFbe4dLL2L%Xx|6dx6B&}cGh`kTh$
zAg>V<5xx@BwVFRJT%s=%NRzxub%&*Yx4n1;>e#GUi^0Wl(V!<*S#bCWcR*_$&>t`H
zaK@zp_752Mm#~UO?pVyD=Hm@jJiOfl3u5@Y2s@T$Y%w+dBeZB$7ZH=1Jjs;EMe%v5
zn1Yw$IP1yKPN3(X``%^zUbShj!c(s@i)A9RPHgc{o&GBe$rFnaf{Y<FNj}RFENsqs
z`7vd_D=LIGu-<QR895~Ukr-@VJgJbr_jsOLS+mVV^jMD(CR0u8lFX+jV4U0tzc~IN
zA<SrV^0@~s!xYWy)+8s62u^6mghoi83~CX?;ygwp#C{?pl3;*PV_2X?#Dt?lBXB?;
z9uX7&2*Hcwl*4jaI0Q<zjJs8%&J2v>k)AJ_uq9z88#Uwm8;HL?i-^I831-GuV<Q)c
z#l*x`jy<?nCpL#8D~BowbbgE=KpU1?@Sh3a_}sv7Pv9>iT>=+Nf)x6G;>!N@f)<;r
z3jq($q0ji;NQaOw9S~pWSDdH62;NWh3O!mct8z9!)PIU%Vn!Vb@mC3XgO}v}a8FF6
zZe(oXUNC7AVW-4r<1rCfi^Pf1#G!)^C86g(@wkLshd%;;zcvbG{TQBCxpH3vgBr0k
zX?m^i2_B#~hz;Wi2fnt$(OW<9x-Jd_{)U#Al_VIES%_*IL?U45D`BSz^=Ik*)fre0
z!_)r}HkGdlS{*a(sXyTl3g)~t-0G7(XfH>J&%#*@Lsm{swxTd&#O;}#I(Nx?QQX;}
z$_L?0GY{Y@s6?i|pYNuUp4dl%syJU-`0oteU<n?i8K{8jAUGRvX*3tI>3%!ZQ!#^V
zqf!C(G5DAajXu5iv~HK@9#OkVXWCZC%$ZW+V1whRu?u+ldG&urU)Pa-J-|x{Mg;%<
zG=u*H_-SOV5e$`(hQU*By8GYpSVF`pqZf>b*P-v=0E_i|M<m8I<9aiHER;Qc1o7wA
zG|{j0^=AIg`*o0?jEIB(!E}8uUNCQ(HSmQ84%+J4iD=h5vIl<<2BL3T3Fp+GlRL^I
z16(C-zDW{TGVZ5m2ymSSNx!l`;vUgsFN&F&nUX)oa63CosWoP&0hf1K`l-S6DZF0X
zQv^qisjeQ(oOo9wG|zTNd~{6`AAqYD2O~azY;VXQG2sqafQJwe#C{No3IG4&d^RWX
z-X2_FLA`;$gZ{vfy8#ypPoMbj0$1Vp`XlIjtK+o~oP3{p9{erG$^x?y;$yjFfYZm<
zGFRh%CR*s9EO_VGXT$`q%S31{5{SVU3EQG8C@LY)UnhC)gM8jt_)9UQxzDhw^KHkj
z8@z%7oxT$DLz*5CvP9T;*I<pN>9r$%2sjJ}>Q_Fr`%A?Nrs5H(_vR3@tG$}%%e7|+
zbj`Gf{7>?{Ki+0dbRY5T^9$D>++rDgnkT=Bp>k-_jL|5F9~Ll+b_eQ*!x1=$oFQ<}
zh>F00sP!C&W40Hc1lsgBPh8jt&ol<@fip+-Vjg^!B=-S1?JevWwdoVbh>6~Ps>{h`
zK^_mALy58udyv&+;VxNoWpItS1Y}FsQ{nUYkH>kSymnUdb7Mm(p#t~gCda})G;HRE
z(fko@Oc)Hl6p8h3pTFV6G^5B^fE;j;;%_vH6QT=4Joj4|$-(gag3!-CkK8pBZ34&=
z$3!Np&wE1c|A)Q-`tPF@&H1FK^BZv!$P4A3nW3Z+y)44;;@|x5@la3k(ltnF5Q4D>
zurjCozk+AL-LoI>5s2{~Bk+ac3*vC{0|)MBQ8w|}m;G_x98=&P%i0|2?eD1n{+|Zz
zpf6YgJ@WR98mK21lCPJG>Kn6^<83j*5g01wl>BQpoF^<Wtn2trV9r)L25a%&H5ke6
zQ;lPjn`CM!oZ=qQWs|v3wjY8F5cy`oGi^{8Kz{R<Fc7^*y&&`}J^p^yIBTc=8Odm8
zo^lrGHBRkb2><b!h9^kcp-I0pVENt|htuq(!%Gbzt`09+c<d!$<$zhB;-r6bNcpvr
zUQ;isM&3Aoe+X12G769zoW#D?TZHtsz7ulJKQZO*-hbihcS%SvI=s3?Zvlf}Vk6uF
z@R`9DFO8ll<ATKEJ`u-ZiFkL%L<l&G0-e@dNFSOx;6=d}di^lm)Yk~;a3*~Ll{kBP
z05UyWpZcZ7qkHG-1MD&WA}}`kAJ32|FpJWD8HmJk^7tg~T4iB!<57asOid9sH<;d8
zd#eL1HOEXF)G!d$HFtk9fYdjK!<ZNF{6IqUc35A+ybNqGzv0_Jk)iycNHjX7Ww?<0
zIREOC-9oU#|JM}(4ZT`_>fh1;m0cj`^x9VcmIA*1N7i`6|8V%FZ&O?q!hRhgnf-u?
z?*lz?o6S4^Prx|Meem#rEj&&`<mw|PBMJZfC24QeM7+>)@QuS!CV?wZ9cQlZ_P~!>
zUXGJ-tLanzxv&NnrswydNcLv?B%XMj&`>rY10Mf})I3*H8yEaX6;5vQ`5+hO<7hX<
zbL7Gaqwyu-iz^Wkf<8MmC4!S@#!a7mSB7_H%p>A1H<OZVlYA#tfdPAV{7puOQL6S3
zD?0Cr@zZp6kVk|wf%wmY?VvJ9^ge9F?Z^2z$D&g?{0F3g38m%mKx71o`8b9jg1Bh_
zqaygvvIF3BjoXC1)jTF}MU6a8PHzp8ImAndn}W<_VFE_L{m!W1#yT>2+#heb9r@{h
z{N4b^ztH-<<F*b1sh~npP%>xy1^$58p4imC-Q|e<6LZR>pg`Njhv+2YZ$rJfYm<$e
zuv5*lJKAIBpY6VCqItP->3Y{TW=GBch~*HwVgCgkpn-sPDM<;n9?$r`GKpIW8>7>_
z0R#9=UlqH^&J#E>)*{LXkR9^$Yu)WXFW@sG1aYnkqu~U3ju}Hj(xI~HRmC#BBJ%io
z4HB_DkjfyxbSA`HPv-1{t1H941kY#ap|gAoxJ$v+Uq|~Na)b!*Fm=t~FWCX>j~(C<
z*XTdJ05O&Rhtzy(znwVMRds^^J?s5Cy!h2$IGDm$<?cvz$HL8j-NXjE9Ar}S%8^*`
zp7W;ip9r16u@J`z^F<SKp+pLC70rw*B{Q5u!!P4`X^(__@6#GKEyDYn7Q%jPa}1zf
zCnlu+rgQ!g@R7p%us9;f348#)_3v%kvi;aio%r}5@C(^ty9u>rc7L}r77QVJt>_Z8
z1gTq6UMB9mV2NIins0^m|Ks>TP(3H$E#wDV2tH)|37fPT{y*ilKBNCHsLCQ;JB7l$
z5qSJxT4mus6r%hzpI_k)h3&8b4($DfKY_bMyP^|dF_4TzPXrSDBXBy*66^*NAbsN?
zM)~{U>iYe&)nOCDxX>*Twrx|)9B&`>_JbUMT-XU!=nc98FQ6Tnzmz?%9l<--z(Tr5
zy#RF_K!tF-jb7vfy@L+;UkPw1iWaCY%?uv_>kcVT{t&RZ!MD0Aup4pkrTktKu&+FC
zmz5Lv`QX{X4F+t*w2}1qF!<doePRUi!V%!KeRA>Pa3%}{u(u^grRW)=CF7SU!6!E=
z7x$g_d{-|t4c3gG+%s{P7O^79=HQbia`-N=a8A?58b=5PO%@7a@zh3u(9PDKq}jZ>
zCC23Q%pz)+og4ok()1!vKuIUp>J_K;|He#^61)VvfU4@=`Ytq@h67h$fP4sAmtg(z
zI_N#}|2G&27hHA)RfDVUfduFY)Q`XjjrVBhhNC$C5aSDbq4CA^nIInS^j>%QL>>~G
zkRP*#5v!r`vG7X|r>O!1U&42RAdglA>6rL`+_>%mggj!M8|_|8;~VCryySenB6_?=
zD~Is%8Hi>pZ=pj2{xU*e;vMkDQ)v*sDcTGWA(gA{e<>1gf?g4F{7Ui$auO8vdPMj~
zz$4eBYN)_V=K<@eFTd$7fEK-xq~zuZK#TDhERZ1}ynyKMfvCK{{!Ykqz4hid#8jXF
z(#D4MAc6Q>9!bQHqrCDaM-1mtH`re^MBZ9>Q^nK>_Zy6WLf;>=2c#GzCt}PF+$=a>
zo1gq28)po?e%TB{U;0#I&bSt6IG~w<>9C7|z$W!!lt5>%k|XlTe9;)*FFC7u5~3#)
zrI#ZpF@hM4_mo6vWP!eGC(X@=AOjc#&4Dg_A<+Pj)a()Z0ymeyhj2h28HE1~OkLfW
z#zHyfh~`@3Y4HEYNFp58XbpG>JCsMzf5MT-kLU>eq6BPlTrm+p55v!R#0%AML0W)2
z`hbaW6nb3nF{V|Bev}++FI=3XKjD}VjY|b1W4=X%HeXPM!%P48Ud0805)ATeGgzk6
z#IkJ02xXK&Wl{bTvS4Qr9=CXa>yz_!Gry046Z1j$oEV$BHuD{HgYRbhb<F|x34ef*
zQb2j>f5qE|oqad8?*8pCo3xuYrrI~Td3k5Ve~XVA`2V~l^Q<8k^5$xMUvb}Uz|$?_
z`X*Sf_KB8h2hG5Cxn-nGPl^0TD1d}~Ur?RM;=r|S#_<)gfQ?)%{Dk>&zrHWQA4dI9
z1{S|f_vi)>{D;My_|-q(<GTn7+5^-CyT`4DZU3jf8``6K0mR?Pqrd*=j8FXjek+?!
zV8DDk8!`AIcyb~k<ej{H$1P)B{vOV#bi2OwLjqTD5I=yKd<M(dUF46I%YjP6FhCR$
zB&#BSg`k%}LV>J*?kpt{{mPP|1Bc@O{qs(Q`h3JhOFT2ccYN@!Zyp#v@fA2G=9LK$
zj*OqU(XoI5yu8@gqGyuF$H!EVH~<t-LXg`6&6}IwaT8b&Nqs!#_xum5<NPCzoQ>uX
zJxANlHIPlWLrYY9>mamy&vUuvT4UlZ`6+Mx;2C~nY<u8?SP~CL_w4|0=+!_IZlL}2
zcuH`-zPu=dPxx8_%|nXX!$IHE`@KXXKmRrakID7~j8jDF#+y84LKfWt0|4-D)t>g5
zqPzH7OP{0e&am%)+Qe^y4q^y<(X0fmk_*WFcLutk&j?s|uDcNb|H3<WTm-#R5BJjj
zZRAej$5tF`-^b|+fiD7MXxt64y&GpXH%>lXS2_R1!aJzUHF=|d%m3g8_43mC6&iZ{
z?=Q`kFPp$mp8+A_`P|(7Kn>sGlKOxc^*t~B5A7O({yT;ixFq{V+0YH!Qq-#>)$$Ce
z;PSEVAbtbdr46?JxxCdUHfdMMB0|85D;3R;OY4MtW<|%Nm~Yqr5p(Wl<mTrw2HnJ2
zpzE4L5z*0q5u1vJq_MwJcj35jU*NL=8(rTZ&G6H~e3<Zi#S}Atmszze<oN1??;+#o
ztL@)i_kU#KX6S1t!B_Mns1L~lR}bXyPvY=J;3e1udw`hXGh+K9_{xV%qy$(J@XxB;
zJz$ODcI4eyzmPv}^I<m;9p{m0OOIvu#(A<E@qhvluA}kS2w5tj5^B^|z4JWJ<1qCO
zH1Deh!#_|Fe}Ip(!2{RW6LIe~I9|z{7qh<zKu5j<TV#)q_BXYG*3a#_VeQSSf4JeE
z_<UFQNgY8h+ZnmyI0+t0?r+4sYC8bj+`q^EBfOvyJ$Ly8=^5t4s`_Rz6+XONB6oI*
z6necjScvrU{6t-Q=@U)xtpYDxVkPP&Cr|g{`DV`=Xhvncy&hQ}DT$kgll_z1F)?`5
zX#mwt@e?eTdcVRx8&C8>YIy^^rL`(-6#=MdU#=I9=E8vW13u~MU~B771`3pioceze
z1a?OKK;84!2Y{XaB%a&|zPOz@&B6u)qLaC|lagcPOGGESd6`@z+Yf46M>(vA@^F?+
zG`Qwtn8Q&RA&CBdD|#qm!mvMh=3%Q(R7K>FWhpnuM*glo68)Xk3){luvAjTkG=85a
z5x6ihrR`Q5pI;pUFTg{xCa@1=ZD42F{?wcJ<i8irg%uH!c#p(#%AR>m#ps$%JKqTC
zGMZ!ZA4HXBkM1*-8|AJOl;u7|Ev!U$G;k1}V1oHE>~#@#-3{=THZ}VxVhwQ<`FXfT
z!$O7_Yn!P|d=%P`X#xr{pHn&fCgZ#}${x7kA7q1gfQ~n7iMEGxe<u}&{E5hwXo%Y8
z(ApZe-hF8{<|mVBv5VM<>*e@`5Z-*Kii$VFFwaLFWY<6S-ejewZcaBR=J3w&@Rys@
zNj1Pn;`4p!-zALwhV+<?a^{Jl0u01s;xL>>ZY#yqaCBM|s?YqM3Tg>_2b2PDJYsgo
z6{sO|i-WoQS8T5PdiW=#HX)|GC+oa$NK4{<0!-iE^lJ{exflSE?^oUY+*e!@czXSv
z@b7FnJ-|rxx)489&c5t3x+-v`M%FpD`mn-xA;@L_{BPT+5c^9$@g<zf5m`VJebf8r
zzoOy9{<+>zKp)m5)Z$dJ5gQG-3BOVA@a-v_VfEkZyv%QeWI~Ynh#g0+*99Dy@gJJ1
zph`Uf3A`no`wGHldel55j88VI60@y%De;NG{qa`gNgb^H(c=?~LI_@uhsS<>F^e0a
zmn-{5S&&DZT#ujSACkuhW@U)+9wP_*)i(^p;kn1+cqz05ZNvZ65#a8KdVq=U;itad
z!{6JSRmS-7fQ!R*E)*oRGxeV!g`dJ{9;4oXf$p3?uzPAo|8<Uu5b`eP2l$W0c)WDv
zC2CDAQSayDDjnoetz5`@D_DJT8tB|-UCQe}fBo%XYeAcdAGg`#wBuqqa=i-)UCZol
z=-R-~v)3Kt*f4;RjgC=ZAup+l;S$sFp7-le>=3|6^abu#(1Jk@pGd2{DlQ%;|K11l
zydU++H~w0qu+PWRf0j|;M3a9LY@6S<UnV?)y5YGlWBIMkfi46u!kvf=X^^8>L`B$3
zhL^r$ApJu~TX6W#f?omYPo=>U&$G=hQ%JJD`*Q9llOt%=YkDRA2ry#|fgW*qL1PG1
z{&&I@KUD*?QRmMQ;x9g+@zEG5<>rUYZboCc+}Q}2w8<T#|2F13%Z|!t4Bon{4UK(q
zn@}PB@dq79Ks`s}gGJEmo%ew&!*RHJits`;7vmTqWWEPT|M>ZTPv>RfvwM*(665u#
zYu3`cl?2875NHV#{vC#@2_9!*ivYNx_RJ>F30P9=aN5dx!dDnWCC~cdD$!6yfnl4H
zf*DM6b5&F!VVQhnZ#9N-KUc5NdIb6(nG9dTK6mk`!$S2D!tjxa@j=FB2f06mhOYEA
zWpFi!SfC&Hcht<HC=l?&%B!H*ZY-Z*?QES?Jr{rW6Mz5lpPP~}W5>o2I*859A789M
zpDi9u40m}m@tlT=NO7=2)MbJ`o)^3meLnB^&yTL@+hHh-R74@h4V&SWjF7%+u$l?;
zyL=Sp>I65`;`M|tS^jFzsM(ExL;9Rwm@u~t2gBh$tbWq3gggknt;f?-o^d{s%YS2;
zj}tOeYvbvUpS<sp3+9*X3lS6JW@9GZ%ze*|VtKlU6WQ@_?DGxt-Qb4&cD4kPb3R`^
zQ5zBBFjvW?Yl!hBs%Ykj@fr9>$-H>lO|Giungi1ANyNu;P(r0u&6wy)-Y4muejUU4
z1FUVdYN!0bkGhfGz54z4^Rs;JchH4yE2#19>eYgu>w?OI7-RzZgWk9l3p^ZX4fGsV
zF$2^<Z?o@h02AxG4AY|V8R10SbZgHM;%g|r3ToR7WB~yS0KCWxw-5|F4DSvG#2z8w
zf;=7_7c<W1(Bb{u9^ChaF$wjKi3a}_5x#8RW*;R}qzd9By5@+)a8ZPe?!b+~Pv~sJ
zltOp45Ep%XEl#aa21O(27Y;2)?}?{Q7N&j><NQC^2tOnJ^W7#9A#X{I2wPlcwSrv%
z2q(cCvWXM~k5c;vWzB$h=nwDjLH95F;Xba_fu2j6Mq(`26Xk(n?}U8N=7FJiKYLF%
zAGSk!hq*-+Xdnsq_=t`!2wq+Kp{l@7?T(?s^6{MidH(n!%*Bph6CbAZvM<4uMk9g@
zbWDa29O0am3b-&PoGr#NgZjf#%R2w~-V;UDt=Mc4wH2;(K^}E5M$<a;uKwWXO#(oN
z_x|SFdGuD$f>yBr??4d01?7w-#B|C&G+ZXQX=$fljK{qP9m4;cl2$CF<?}!<!nI>h
zNr7n`Fdw7g7vsXg{{|JI@5mBBIOTecgV!gA`7Jwf9GT%Eh&AQ$>%JmQqHio@zjIaw
zN!}fLh=jC7MKYorGmzgEls0%|F-NXXG%*<Hj8`QBxqO^f%0^J~7@)z|cGO*1C&lFB
znbtEo{6+?-jQrIMq4Z8M0ye7-8N7E0SRo18*Mkjv-!t@YPs90OCHDdO-*=Mm{_(52
zHNsj0G`M?~F}?6F$qjB^NO^0UzHV7Uksc!mb4q>p$%}M0e~9rJ;S2;EAsWx`z5oCJ
za&Dm5XoG8&3?Nd<sG@}mQh?ed>V*q6Im?m-=!j0$6-7*0p9`eBN#$;fYP3qC&nkw{
zpm^8CbS9p9udL^727xJ62Z$X^yyyu6Xs9MhEtZqNg2)IJ5!goXf+Xt(fPVBU9)(1r
z+LQq|A1W!GxTRO1Cnq4E_jwh-yDbSs!foT#hdiTiU}qZ<gfI6(!4sB)oT@ZcvT&3N
z>IBi;4oiaSl6z7HlBMsSDU|Fv)g;!zgNBt=9<5f{yl5&UJ0M2a7*%U&(5LFMnI*Ho
zxiwQuR6d%$N^tAYy(QB2l$kv@CdxF5ZF4Ne(3rBSD4{}>p=`+zuJ(nI!2O8x>tY-2
z1g#~w(OsgtFN0Py#+zy$$=UL#Xj$*$OsFIhcmNfO<xr$b5<%2fsnDWD21iZY#-@h&
z)!27DWD-k0<cCM!E}5y^gA4JE_4v2$Gft6&HOP8i`@VH+%~g+nkjnSI5~$NS;{cf)
z@kjc1J?JZW!hA5x6?L00Lt3)4@UgyZCl3cdInAER|6NX}g_K02`&4r|-%=hQht>|k
z60UmYD=8={&^=2BH~;`gF+rQ4S`YBfW;cC|$tDY~UK&I(lb0%sKM3PchDug~9?>Gq
zBYtR){71rc@tu_tHW&DjBJy#(+?4;qu@YQ{vUex(oL+2D?@bLxBga+B-kw{GZJ25=
z#qm0+kq=JaFBO%x2C04&iM5V&@1V9AMDCm<et?{?Y8j~svoTz8eE{oemkl1@j66F8
ztpLVUTpSf)4<pZQzo`GOhSM+Pgg^iP{wM#}G}qrQ@5F!q|L})59%#lyWaOy<AgX|r
zPpsa()V@E$9n<UD;2iwkH7m_iQa;h;hqB8VcTda9tk)-vGz-K=@Qz85gHP2AYa%|^
zh(_BbxWU~|;D#sHzN+qBT;ikbeAJ+yTmAeHbr-i6V*&@|zQK$$cE7@~!{Lg}7J_+w
zP$+$WdN9i0jf7;5{&&JRZ!Bkg{LvbS!u&+;MvA}F{7%N%Sf?Uk+(!|K<G9YNC68@}
z>fUkzl_pLLGrT6-8i)%4hj!8E-?F<t!`w2sKjNhf3rt9ARSY+V4}^Ay4B@ad2v;0v
z)45;w8*9HK;x!SVrUWhMK7aqu{193Wzyuk)KWzC!y#rNO&hDMJ)pvlSzmI&q-;{Le
zuQ&K9-n#4SQ(f9#d!6??9|RiBnyfWq1djoIbq5?<KfpUz4xTdzadN<s_zAB=j{F%f
zj~DA@77MS>t%O;USs?>|%JG#5bLbAkNq~LO<1#A!i>CZ_?F`-w{ck_<wvEWZ$AYvG
zap5}etI@)>y)U;fyVIXKWa#EH4-Pw$<&3|?`6bN)ekTp^ma2;|fQ;M~h=sVkYsl8L
zc3G$>CcppTBlE_1)<uv;&2(35Q3m9V0AH)u>x;17+9a4q&v?lFO1~^*9O80HLt-N3
zz1C6+F&upz$mjFI-v0NW{1fwYV`<QGK;Hrq$}9^X1v1&Q1H=g$fV{e-eC^BsMZ<&l
zapE@Z{!w!bd^^LvAbTXFAeK<S>$)$uM~}39eTERYd*2B0Ti)9nc#JvUSMZLl5_Zi<
zi6_DE@fcST5eRFJ!xwmW+iBx4kN7O@4~89#7GYxoXOGLIeVbNL;C{owR=_10ua1Hv
zdiL1eeBF@qTt;4PjNLp#o-$Dbz)k-9nPs({RM%mBgAQIZ;c~~tcuD=WpAU5U{6uRg
zxQ1aRGRo}VEsk7cT$Trw;`utWFi}7mTI(E3{}BKG$yn?`hy{h0;Fbe_P(f+n(l>KY
zenQIF@7*|r`Dt(OPDWHAyhJnHXCD)Y@e!OSr){u}hj2rec+VL;cLZ-8_(<%Be5vpe
zsuU{em)~5G8|KPnH`Yhuc1vtO!3L@Z{8@7`7b3JfGDGKy(RROB*(1iov14HefS5J;
z{JZU_Oxlom*NDWnhhE5S8*`5Sfy_K?i|^p36K$}L+V{n{wN>6=zSInP;XiHZYT~>%
z76^D@UT#iA`FU!_Z}|To2c6C1>AK|1`@R&duqA312G+j9{u>*=qXb?8zA!^@2lkAC
z-x=+;!9TB<$`fvKT0Q6C6O%lakA9@Id)J|7jEDSn;Q&l%frF!H`{~KaEe>P(W~6A}
z32|MUp}m10lVXvNa5rRgd5!aAV+}-ZBO8c?_>V2&+_P_qe74BAkE_dw_(PX7VUa0B
zW;KqNji?dsHy91^qw71VhYth++{cvAALaG+K7f>%zC3->Pr^_p^as5=33MoT@g5T3
z;shG=yp)IDM{Gy(?`?Oz-&gp^;KVn@`iwm`dmEVb*kJ+RjptDS6$xubg$vz8;~T6$
z33(~Tsp2OPQpeT%{}twd$fRMv?m<UwH^O$><-KthNCyPJo?+%sK6fp!c5+9&_x8W5
z;_>aCXj_wW$;9x-Ce~43&5xXV=7x8I(aC$__HOLw&x_@>i*{N!5&1ZVl@YE=dqLQY
zL`Lw0F^HR!Sywj|q9Zx~TzoSJ)5gd^K=uBW2Pj+9?_UwtmcS_1I5>YdhOC}S-5-Sf
zjWcKW$73^L8)q^MGfv{at``Tp;T*6&Kn(k;I4HWb;ePHA7STq!=Dh*6;`9crjL8qR
zCVp=l&%!cISm<M8TFjq|*Z%0*Kltsa@QFH|D^3wI7t_t*D-(|y+5s2%*U;DuZwxQh
z4tsw160@%(YduvNtaJSAA3lA^MWKzqd;y+-cP>mu^7l>O;S8%t%&lX9MN4RYxJnai
zSWk{{TB*P8kj+{S{^b%zhY`)GgntDT4Pop3)PvB_=?t2&^6;-tJBUJY7^p*dn0K3T
z@zKP08l)Y3M~M918nSs|t3+S(ZJ>+aCY9d>nzjUQTk4_1{~+=VSULvJiIF4W1VwMo
zhxKscGx7c!PEDIfjLPW;QDu9xKgW1ycqky)@tE&HF{F>?s<DJl318zpCSvh{>1){Q
z#@ekbxC8``+u6HTYwC{H2l}uO1U8$l5$aTu2#$l~W_UU`a6+9rkIQ%02=d7&-e{H>
zSYrC&9B2?0<Fv$4RL=_kb&~Dz{3W0?239BxXk}sl5h1>=WQ=cu&Qa##{tl~*#yjG9
z1LhM9eig6w=HlVC%%L>KID53N=VWlw`QhjuBk{FL^(-N6*~9f<%mT@p0Qbz;2QNw=
zQKUs=Ul9T?z+1ezg6eTwKX^i+_+nO3cGF?6!!lRAMh&}}hRO4HjQ}fA`{m!87>w_U
z&>ZhhIosyOW`<^*bH{k_<u7PW`M1|uSSJb3Ee(S!AB1~D!357^{=YwtwnW~zr`xwV
zr|abZi^b}M!iJOo_+rO#5SxQi9Y;{WZSd+{jl+sgY6CtD!ZY#qG6tjIih>C~I*si;
zV0z;`2_Lt}5WTj}8V3yJv08#HfL{H<UDpWVKfch3iOQP?UbG0FO$~bxN}|I3bnm*4
z$7$fa*V~-_&u;$hE)lV`HHF5TLB^_|bWop)XE)wf5ELJTu->RNGHPQWfTV${aULQg
zn>Isn_;+d^i7*ITmNczGr3W8BzSM$75Xv}Tba2>t@V`JH+87z}o%62OLn1~7nFI}f
z0F%snE?m2ig6j6X5LXCT0?r*mUN&`c5)yU4zP~4wVEASP58xi#h?^&D4zzWzp-vC}
zYevA_BpYWJ;HNQ(u-m$lL_uA5a*Z4-S?<?+c=r3_1DEl8ZA>y5N>}kb*I)0O5funx
zd#z;TzQz#c-lyi}LL0hq9Ji3;AzVgml4~LN!Z(*3Jm7D>5OK8`xI!>8TSC-n4FLCt
z3HYT6udfA_9#O1<C%D_&V8KV{`nOdxY{~BTIa%Jr#6kz?`RC8av`u%z+tJq*sAV&#
z7*yDNWYPP*%`()Vl4-M{lM*k*&5DW}A-3E2LWp2tltlw{nl+D!tp&eJerC`w^XHd@
zwC<{d!8bItOYl!OR7%h~N2dP>#)m~*D39>$AZOKGXc2C4gGbR_-O&56JAWCa!4__y
zHn_N#KD&NCG7B_6v3dXY`Ty`w;&|MRa^b@N8*CDM4jV`6Y&Pni1dgut`JCbDuBW5j
zY_@~l@v^--e--8F?XQfc_G6N$PNktR#>NoZ9|y!{3FT4${G1)cT^TPY8L%8XI}K21
z9D)L@VB*K2kN+=W6?!3fi8*ILfUIkqR)+x(<9sFKUQ}ohAq!FO&ln&>MZ+bbpOklX
zeX#DXzbI5RhFkdi2qPTv0lFwh_P8wN7bkSIlt<wlJl#xnbk<fw{Ydm*ukPeqlbcb3
zU`gD5%J?Yg`HSAxV3X>4gp5;!?VhZEg)l(yy#Pi2HO(Vn3$lb0zk1v{Gy7;)+^!qV
z_4*Dpp7}i3eojS(z2mXz!Yk5p_175Sz?|aF`*;0Ut`f&AkIX%Ri;p&_P}T3_EgSDl
zYDG5|BC!_{jXroDBY2p|j9+o^{n4C9%h4MIL}ligbOk8Cij<=qd~BI`BL>V})_6)=
zqa~f*%8$vH=HVVQwNVpcgqsFxxl7HzlcOP{@pH4BK=9O|9y30lNPm{Kp$di<%{CRf
zTjJMY>}Wyw{k=(i+RXQVgZNKf*Q@m9U%>`AJJnDsw|Ha;hokY}NYpr#hu+AVz;4OJ
z;gOf}cKlzOJoOBlQ?s}j+ll9guBEVqUED6WP9wfQVGaCj>24b{1QBr>r(nw3y!-$8
ze3Z+6CN4JVU>W^<UHO^UT@|`p{}&r{vfY?91$r!=Ie^Hd9DGpN?-@?|v}sskCg<Sm
zG^TL$>d+ubOnH8Em#3e?7bSpgG58O9PM+&puM$M&sK9sxI|jgXkBqU6gG8YLBkcT8
zs{_-x_4GUr0j7%^ap#B&vjRutyabOcyq&j<c<-1X2+^U3Fh~24A1@)G&@9Ksd<Vja
z{LsuoDKay`c+VN`_r6?fz+YP&GI4cKN$L37^HNR`$0eB4L>Zz$059lL=KJQxvTN}h
zM#m*#23KmWVlS3o@gK&Ya7D#qfw+7S>P{;}M*yN?Wwl7vFBjwEGKUtT-!C6yCB9(r
z8^53Z-o0|rqh>eFg!#WM{w~s15A;e<umAoDzvqN)pfU&>Iw7H_bUL#i^GTX(jPN9S
zJI?_Yc|?r^psF}MzkkdKpi$+ogbkFX5biZJ{ZDI$;IlM<guZGr@8tdg`$nK^r2=0=
zH2>K6i=a@(k$4I3^jaSQDxEimQ(w#f1OE|%G>jDc`@f6Gl{@+3Vm38;X99EXVc)|i
zzYFvK#75uf&oqJI5Bq>f@~+kVuLx=cjlCxMp*@@H`+2{R4N0M88lU3gJ)=Z#&{!}}
zRY2BX4bE(CLC+sipn#5<o&@Qw-$(8sD+pLpfJFXe>wc{Z?C_-6k#`OlByBw3auVO<
zA>h~<`#w1S7y|=!W8;V+!`<#o7!_`P%$O5-UCUSQZ~Roy??d>#W=O&a^Qo;3nuG!I
z(_n6Sp^0$pBEragcSl$3q}}_zD<x-PkDfmH@%7E-&l%NCfeY^Rh*obwhlDM*0w;iB
zOAcj+S>JyOW^4n;f9KN(!!SUqhf-K2&kPTBFnrgc-!?Un@sXQ5$H!sUOgiP_9FYcE
zWpclcrkL=q03E;T`TzcYHX|9`-w4EGIj4okbMjmYH|pQMic=po0MRM|h~XWkfR(5X
zzGAF15J8}D8OE26mq3N|ydi6BpXlDE9k{{NK<s#V07u~;4e))VV<M*IUh2ld_>FLk
zfe8c+9;QTd8c&w_u*?F%vu%VyUJ%T{@H(s-JS`e0-BpkiAB^*Oy_*6=WLt~WU}4RB
z^?7VLQZYBp;lFrBN%0)zW2u*;)K&q&)MRLoRX+a+P>sv@T$K5SVm!11fr3ZJd=HHC
zLgS+dg|Ig27@Pqa`Cs1qXL>%zU*G9S-_Xe4rzgnu2q6CvNx|<^`fkXg)OY%T4l=ye
ze^68Z=`Z(&2S41f*Zbz-(i;&A<)aZ7(a)oX{Lk@xWMOoSuscp$@Prh4sOv)3k8=(v
zc6z`2ZIsY9-&MPrKaWd!tW3473tB(HM0vklFjov+{69X9`M3#2>C@-$h=7M`HqNmJ
zfcog^*$l6xg@js9%BZomd?7dP7``bR9_xGij?`;#-LFT}-{yZhTKI}+{vj*VBLbdY
z12c8a_xt`6mpl-(y-WxE<87us31dP6BYNLMHhK0Cz|nExKi$FkGrgT3jNqH^$KU2y
zLO&k+ObrNG{ju4Rd0jD)eL?x?ZX2ZhCo|AzygFLy`6xM#Ho3Xc2e|$_Ew*pBoetHR
zW1q6zzr<r=HxaI1FT)ro?_)S_uQwwTaF2&z+y-wqRLhL${CvU!fmm)~_`jS1okn63
zFn352JpnfuN5Sx=LRJo1mMlvMvJ@T6zddXroIm79ta?S1yv84Kqb5gViR*-MgJWru
zVm>g;8_n@}-QduJuJbYYytCtHH=ps@*%~w`x}yKSv{5Gd^N-{Dwl#1QwYsyd$SD6(
zX?@;nH0aplX^A+ljiNlP!=N98X}dnm9BUs0uM4C@Zhny>^aSmC8W;HO1F!*F`=_J!
zffaxLk@xfgAGZhngpb!~J@KkWaDRL;;SYaQH>)<|GAq70e{6N@;Dd(sWGu@}5w&K%
zX^p?1&wgW}P0!J;dd1>7rM#gX{kSwI$rAZL#6lN?M-02Z(_fnJ{c~~Zzv3b)hBwpQ
z{vsM>oqIXMHrSPD>HZ>STuee!cr{<n(E1ur1$;-W%^1j>qljmjz0x6UwBFwZ6EAeM
zb2yp2>zkC@!L-2m_{Z&NbNLRb&p>)h|KKM2Kx=ZFY2z<7!Nz|ITLCxd4g8%v;`K=*
zv%eSpp`QWoX|0==;S=cr{)+LhKz};zIQU1yP**re#ViI}-Na9q5jKC1wl(8yF?*Sy
zb2bOK{ydU?C$%M!)blUmwT)qDO|tNXVH;8cb#@RWXBobmoOy!ELRgF^%aw~@r;|Wa
zFYfhp%fx2-3_P9QKM^6?0&5UQnALJDxB3>kzB+VErdQ5m<Wk4tHNrT=;tAjY8BG)*
z7aDp>=;h+PaP3#kmW>(kg`=NGcb8?Q`qF$Q8}`#EL#NyWU_Up2MgGI^{k{>vAbOZ*
zUI5C~=yTewzx0pP0y6(W?*nby(C5B`0p`V2!2j=6K!!-tuLIWw9ve=g2w9yT8aN)V
zhKk>Zc;;ptaDk?zW#C1X@qHH*It8lwFxxJ_iI6`%E&O@?x$y;tkOz6;AA<}}d`6zk
zegj|NOZa+`6Qf7Ph+fUW_E4@6{~?h6@YipnS?S=SLq2xQTPmRwfBC*r7MU(g=Az(@
za!2o(|Aa9Iq~&=AV>`?781A_@-f?$R;qCXMZ136tAk={GYsPf|jjxaNfJ?puV~l|=
zKG#9}Kl=edi}2m?A8V%_^B-wYf3?VB(hI~N!d!+UlG~KwCE_xYaLSg3nqeU9woWqM
z+=C-==gmjL6_Q1nK`+G*CkRRy<aEjqVJlPwt;+-chp?sqW`4f)pa0Lx$t}^x;vlDv
z=E4_kfvDF$K3I<Fmr;IM&Bum+#buFAM#7!9h?|R)03oOcb-6*(!u&s;GeuitC|ZIC
z+3y2)sNVV=_nY_X1P*{aymx>O)9QTw{DJfX0^QPoJR84J`v5RS&=Ta|Y6EDy6>nTQ
z;1a!9cK=KKZ@ds-NcQ~TA=5e>7&U+Y*M~DxrZ7W!!+*tJhZr)X7`gC6ho%R$OY1Zj
zMGu4|iQW*G0|cBaCUdkh37a?MbmQ?bfPW9oT&-pg>;`_y<u;P8=+JOM7P0>)%y<ZU
zpAN-0;i>%mzmQu1>en9`&-R3Bp^KyOctZ8|kN-DW1O&wYN#nbZ;2!N?L616{E#hiy
zf8Zl7zMstX#rY>13`T=#h>PURM2QVw!Z_SG!05a{Qz^t1tr;rfc)sS0w<Y3#Hf}eX
zV{`G^BkPS%E`aT#4lw;hd_)y<cqps0$9Q%W%QARisBUGvKz{Nfocw*d!P{nJTLLnw
z9wS(f5)t!c*#u7kE5HUle+jRRy0wht_XceL2yjK`gBt89yzPA*^oWZme14ys93AEq
z0jpmDck97VfHk6ssX$|8`W)T>fAqc&_~9{?F^SvYG1vS#X>q1|qnfD)gL>i2Fuo8H
zy<lnaO~3@dz^=wz`0R#4KbE|KaRe&B+o1luzqEhA^{@UA;upb0ks>Rb$1>pwupmpr
z*E|XRpSqrav7KT)usY>sWb!YU>Gt^Q2aGxC;EpHW`aZ8n$AIL3)yL&E`T?0&NPT&>
z>h1IVW>wN3UUkiRdsr`PYWY8&ZOwG2i~KGBxd+?F+L|5^#)f56GDbc=G<S%bJR^?3
z3a82TQ=nXDj*T`HV<5ECDr8Uu|MT%!)>YRklNcq$Q*TZ<ZjZuOCA1!fhW>4kX5%yB
zCWylP(&8`4NaVjPdM)su9pghKOh?uZGCy2SlT10_-{$2$jNFwvsvF@N*#ZZ*`KV`f
z2GD*nwI2KEZQH0|J~{}z1iCQBSkF6{@Y;S=$6Md{zcxq^1UKV18zJS5t$W`2wl>EP
zycFyVW@rg@@NfWCuOHmw?^NT;em~Uz_zWRx>b>;+0WU!O|B?xVdgj2Hul*oRn=N!+
z6~K|K4XQwyxBE9(ZeQ5=g&v6h5XOGQ{t$%tD&#+I-a&5qwCoaSuq}+uLk+e*SQBQz
zgL(MH#18*3HYspbo8lM=RrG!Nj92!D{1*anV2mSoL*RJhPUCM8e<$<vCH9ToALArn
zH-RUhFYMqP9sY=DbX4E}AHdb&4Z)>Q=pehyQ6P+O!X3wb#xMDDxw%-bFUDp=cCvx=
z4Zjg=X`=z-+&|~z<i?D5$z!H^c#P07txeC1gg=7LC&#W_mA!EoZXh}oOl`z*S{YKn
zA;TO1*9hv!J9U<zlgAVqK=X;LUhJbMK>SPsJ^maYd73HNo4cRg{t@uKc8+Ee?||qn
zXX#Gg9X2Y+-+^m4OiQQ5Y~3aFlw7urx#t|8`@N4`*$h@c8JIvv#lbf26@d0z(C0vp
zZeDUM2x|ci>i8kruVnr!Bkv@Ss_^TAOl)!jO_Plq@ITZg9}eMU1Q7FaoI__91J2sR
z{MX8^O85y0aK!w#pUZ*?_$upNTqn-J*lK=L^)Q8o#OsQVQ+Qeve6)#rdx!u*H@pw`
zLg5GqdZ0JzaAsd!Zw67np*uWc|7d^b&6~UU1&>~~SGM)U;iH)-B6bIl@Wy-LJ~Lw=
zsd^{B#87N_X$A!Ko14Ei7cY*cMffX--w~`lyF-R`{Jd8g%g25EnBITgpZLEMf{#rk
za=N|SOnBn1TI1`t?|qRHcqGC`Jq{8L^|rg?vtfV$Ci%mO^{1@jKI$v2oo_hAzN2+}
z+v|k$rI`LyL~n#>j>AMRrMJ>|4(o0w7oY);E82ZnFbVenW3So~Ft8pL^GJ06H-?r^
z1vnyXbu^9kS$IL1|1gWWE9;xK$DWhGOhw`+!WfRCL|jCjrm;Vb;~wjWA9k<I*!@pN
zildVH1_|FC>n8jdaVYv{4^E@Y;%{JkbN?r#0#;H3PfVWyMdEx5J)y;bd(-BRzMc34
zt!W0oXT|u~!#70>;xOXSN$SSk1JGVeWcuMOXhI<2%48s59J}HwBV0x^5&U_h-srf~
zOhx!Bh{W<#)N8~<Mw$`jzdmH-$H_m$O*lmlbm47`%&y}yAD;QK(aK>|j#q*nH7bGO
z@zg;h4)MTZZQ6TW{&_3jcyJT%hs*6AWR2()=dKZq%++uRdQO}YHaaBH!lOBy{|I9-
z5qLwyUJxeVe+YF+!d?r|rghwj^YC;Ckk=oKjp?WMd}evnKI?c<uIXRhK9Ily2)j|&
zXI*G{#m!`lk<>@#^D*F#wl2rgL}bK7L}ZDZKx1a#-yw@I|2G=+`FL+Fn-MHVXpKZ=
z;`XXNB2@Fu7!&1Xd|q1MLDT<^&!!L_*PEKj5%p{Ejs)MC)E|iCJC><pC*I!7`lvn3
z5l=t#e_(#|Gyv28f=o1tKrz|CZ!$BV48mRt#^?ka$M}9%!FEb>ctR@?5zXDngf9qu
z5pWvb6&2N|9}9X_hZf@GWG3B_IPO0UT*nG8;0S|h%$rC5{B+IjBYvKpp!1s6j<KHs
z*~QTDl8P|Q8@1>-Fol{f*k|#~z<NH6$PFKL@18#enpg@vqfe0hoCxL_?Rubr;16Mo
zxQm2w;6xC{IsmpD)vS+QGl*h9JVty(e|XT)!w>gg>c5(mHbD=3cZ4mw2}XEw#*LRP
zb07FlYDfJx2Q%LUxPHXG0MYN^@z)IUHs3>T=Sg4hjSF@g@z_Vc&n6UgKhTWx{<$FP
z@bL`!N$dhPoV-yO)km+I<2(_3>z!ba^c-ey3174SW=F-!{-yja%X{7;kLT+V@b*ny
zaFRP<YeyiqbfY$L|AU$F2;hLX-lG^B6aOEZJACkm)`kE0WLEA@pL<JfEH!#``7*?#
z#z7aPYIrX)3rD>AJ>$KG@4lcf8yi>%cffr#Hs!W(U-6d096v}29%rELtW}pGG4Jy>
zFJ}OM=FbUiBEv>F-Rr#6IKh4>jF^Z=y5o?<i15Y;u@dufJio;LBh0`;+p)0jwZ&#)
zK?2qsTFrB95XE7;$8n=3^Ce(w^41-`EAji`xFbJ`$A)>Aa_A3zPFe92_Ti_;xN~#j
zKDrIPq^<scf=tqYO|Qdz@+v*c{1be18^Hm$UJfv(BC#Nw!@YHCVmqj3#CT&Zpvy3q
zf-WC`7oyQ&4~pQQW2TWGurG<scl@-d06LKo`7jk<be~;eGk^~9)PA7WLg(ul8tr@h
zIhz-=?Zfo`ROilgE6s9wpc&@y*{OJ%0vQp=#ADetPD6I0FuX=0BY26qJZM6Dgn69~
z%ay2)6Zr24Rka>P&K5c;G7O|m_j=;|GH$`B$Xr#yCPNaMaxVCugD+E6A6%K=_{z@s
zZ6;*fOFRUv+#S7xoIu_fu11e0eM#%r1pfRG=DJ>yE`}gykN6L0XV-buKz6jr|B8pH
zo0QDV$}bW3OFyci$B^4Q%q|dwrOuB;dRKW*bd=5+4_-ipmgDK4{2fGGj~G&YaFoCR
zB$&z0YRH24uO1jkC4c~Am9FU$|22*523U-4Bg9R~y~CW_Z77~?-|s3!6QcOP3gZm|
zNvwYCnXC`<aFv}28kd4xi3Sae2DQSG=%62zoD|?+-^dSZ`7CIvhu$9`aszXdTwV^W
zK%8#vDkgm#MUjVIBN2$aA${YCofPl$Q<L5!!~)15sgl8u$b5O4GD6S+j^|6O5Gnx!
z$j|3}gqCar&+Dg8eh`CxUE~lI$&mQWZuz65iEsjvYJD#qRCYR7z8?zsA?3UNJE5+T
zGL6U~70uC?S2WGB{F$;^E^NZ9N8-McQK+Bqhh-bC80xT_0$va&dKy`HPlWgWHmV5P
zJM=+vfPQT2uAZj9KECg*hX4nJb+N${gvxuWGyjMaVb%)GGk9Rrx9wsC$cr8jEzC<v
zcrW3ZY~4wRK_kFUl?;B0SItHn>)@9#hDMJB2*JLcc#5u($$sn%H<tcrb}rYu=B^Pq
zGCu`A5^>zSs2_&%JPo<SWs6_$T$T(yKF^7g4gUA=pD@8*CC($^ENP?X|8V|jN0$Ex
zPz)!;;P3F89O(1MTo7m>D?F>q-o<)nUo0=;L`_A*7>WEy{Mq9a<BU^SjQ$gUt$(tU
z5I@3p4XDEu-kO<InAEWVp1}eL_M=fdHj}*^0d4h<X)ne93D_5cuqxdbuaWiSlSqSn
z(+V)q-`xh|pa5BT{E8*gskKc1u$!D9fAar|h~6RyId1+VTqlvVGCs!<h?B2ZHi+35
zf}Nxrn9pnq(b)2?ZKN5q&4=%Y_}YZ5+60d?ls#ZTR}lqYQ_tbGf$v51AV2NLf()VP
zOZ|FO1^x&jo9xi;P_C}VhGGZJ>_Urz>hEs~lyV?FjQ_*}Xu9@w)dT99)Q`V-Lbxo#
zMg)uqm>JCi1|D~{LL%e<Pw1pv+!5`bgeXv6SVQUG{JcL6K{^Ri;JO__MDUHoq1ldt
zBWmF&NacIc;uoRb&x}LbEV#c9D-9Cl1N_#XT$wyilZlTeHOY-~V_cZ{i{PIfI&|+`
zPMmg?w71Uw4rJuP4}jf$yW)HZcckB4{Wvd*^<Ih{DWAjB1_P8}nea-@#u)GVul(SG
z60p;6LBl9W<niVi{}ZG%CwM;VgnVerhT_2t%{b2!^thj!jb(}NFVBdI#71*?0F=m*
zRCRJO<@coinc^~YcQyHWuf#cgY|l3>-x0@Q+qA&e!W)+PVeRkhz6o`yjsYY6Uv4qY
z>lj3L!nCbF-S)ufXauTpk@8Xzvyb@yf~*TV!G=n*2|vdA@;=U4^zWAl#e8SH`vSgl
z7->Z|iCE)#``XMm7X$w`RwXj=6~x$bIb&1_8>3tl=Kui5!vnh9sA@?0HsR|VJ|n8#
zSI6}ZB*|O}8sZO=!hB1`$xPP`2jJQ=;tk#WO=Oa1j|hz!u?Fzmf@ghV0d|={yBzFV
zhq+ht=xk_gXg1-+GxNh`WcXLy+vS9?&&`A!c`>z3a8m^`U`P4`Si)_`ub1Ym3N4T|
ztoC?#n}_0XaqgtcFe{4i-wI{c1|HpybRLsa&BtNJt*05xZnlUHbGGutVTg=R2;ffa
zP&ET%BXL0>8G!%+0D1uA&Hz*iN=M>i#E3XR06-pqIWSb>E^Z%qhmZgeC4c}R6q(~Z
zB*3bf?Fc_4PIib&^H_jY4QZ~$V~i3s01$b+(B{W3^aci;7Nu%}Xf@-E{n_I@WsFgR
z7(EPLJ^~*!PrxhT>IEu3v^9a@<K)p9Jum=l0N0;+VBZPy1K0$oiPPJFEUzPxqa+gI
zx(G0kpyJB<zUbyJ%)HwJ4qao6`0R*S8+m)(-pkm_#nVfT>qh<Krk*s4I-5ra2pg~V
zyRPw6F9_Nq_)G|#5<G3Gzzo<#!PNzf=GQZ3uWuk;(ayokX)<^G6XAhQAp2>QDrE|o
z(qRBausC+MmizGAVXg=_BpNWPm5KdT5>-X{p)?*KPd{+`Y^l|HWA~33z|IqJ`kBAp
zczqq@JJt#T7Vnh&6H}c;>L*cZ;Rs-wU(6g8$eDwQq?v<>qD=9jh^BK92wbrr7;(_}
zZ7(3s4cqd+`}{>mhfm-7<8@FHFQTs7-b9c4Vxodpg;l6P6^ZtH-<FWtNB$9qW@Sv9
zN~{|hQ+mHhykCw&jSNVjOv%M&Vufy1#YAMn62xPm<PQQcn_4+EXYhi!&-lp%G7luD
z7!tKOE9Kxb^IXztgOEH3q8bB-PQc)31q_xj2*o;BcoB+punRe0!1fG&Pu2!hKma4O
zI2jCRN8rq`atDW>6cjLurVpe(7s5Ovltwe?K+f#P+t(LS>CpD)*8K8tNmG&{9xsl`
z17nVDwTmBI+*e2^ZMp{WR%80(<3^1{4#k7bl4KR_C*?0->?P=({s=)ng-oGSDg#x@
z9VR5$K;&;p@Z9n2`5{`w42N!_IG*(*tgkP8WI&*cqb1_z(4&`lLDV1ctCOTWMDU+o
zD`skC?ii+haW*-a<4KH%ek4JzatxB<LNWSl(DC0b_m%!`Z2Vjw;63LM;5YkMhxQ~0
zdGR^H{$35gH!0Ia=Z#$d5s2{~BlsqrMCu`dTF+EjTqy?=M45v{(Ipzfn9mL93>KiA
z^L$SW2So&$bt}Ll*6)mjjP6`KrpK`Oe(>}d))}iKsQu+i`{bdpb1&xGFxu(g9k!-1
zIl-}lKz*FvHYrq&PYQB*c({yDgt%){dIqu7TUhnUR0f$t0WS{7d?a^MvvZD3`FFwf
zFSqk>j&p(SYRqi&VOFfi-xaM)(v-v{$SInq43<P@+xX1!e18ZN#}5SL-e2IFW-fem
zXK-LRW={$0gdjfhIf*@vet(aZl&C+wVQH=lHDZi7*WCl*Hw3O$cj=d|D|Dq|Isp@a
z0Cmm7a)hC};`4ZQ02a8K9CSc<@%k?Q9M&Mazn$~H=X~$A9r&8R!GApl#vpz!LgVFE
zgiWRIYxu6Yp(YPwT$sy=@jn?OG%JlHU}Mgw%i9Gqnx6(6@%6@==^KpCwA^P#kT@f0
zo_!j#8%%Zb^CEL{YQ7>^j}hWASdS4Ncb}Gj#bPVF2SzP%5^%i1fU)`1FqSfrd;i^z
zKTYtJ69Yk#HE-@oXmav*e+1kH>=$odV;itnIxE&BPY?372JL~n!XE`&A&vwi68Zuj
zKCV3&Fh1a8OAh@Okeh%6A6@r<{{UglY+V$;{FQnuC;yWSqPTkI@XWhj2;rr$&;SgL
zj{mP^aX58N`HXD*M6M5@^bc_(U*Lv%C9!;WjTk4HNfN;UVYna&f$v}Jr+<a9PTE;(
z60s;?E%Z3u&2YWULD`9zp<nS`$%(EB@a-}f*2)9FYG7|H=o(8m6P*$y+Sv5wf&2VD
zqK^#1f~Km21zmH`Lr;HpN@HSDAN&x^IW9he#q!}RGD_bqvr~LcIBB``%ef*q6N>Or
z-evOf-W_u3IMuX{*E4?jA)kHa#0iGtBWpMjYFno=VPZiZZKc(M3gwFS{AVC=DXkcT
zd7`)I4FLnx2i)C$TdU`%elDapCxunq4BI?>Ul?CVA7_h>#L{6LJ3T+-jF7j^_$!BL
ztxP6?+bkf^B(#_AJYAe?-=s0`7ukf&n7&(5N8+QSGlUrU)+p{X-T9O=eAr@ozm}^>
z-x2t}G3cy`f0k@O{~gB$BG9xLrg#J=3w-~<4hL;9dW4@X0S>jfj|38VnVSbNnvs;I
z$JgWcIXJ9X6@koUy>VCw_2=Z6&ENZM0k_&`|1p?g`LpNY4m{h|*Nlw%=IS_S<dqUE
zS2b~wI8OzbkDHdpyeovYk~A8th|9(Jy`jd114F@H6Eo7^<%XqExg_-QJt%Rr=%_2l
z6?1X*))1(fviW-Cz2wAAi18SY5%`Hjl5CyN*Cb#bXby(BoS1@2ias!P!Z7A%@;-a>
z0f2ZDc7y9)`2PH%iLdlO3{=<&9yjMHxotqrt{aNx!JmAwqZ7q(U8bEM?=3eGgdq$k
z5sKimK^l|}Xdh!*IzNNtj<hXk@m!ls8Hsr&G#EyQn}UxQwjP(Ff%vz^;WmHhFdpl0
z=9RPR-(|Cg1Jq@KM)U>5-4+DTKy2i|F(KENeF6WB`U5DdToCovv+4|R3H{WfiCvdP
z*oyj+<*>U*JBx+kAFX@y<?VUdqngOCiBn!r4*Ym$sm2h^gfsD&h^U?MIKpovdf`p1
zUnIN%4!W0-YCO@#Z0fWazU!kIcTV<P>}CcJ|6hOT+Z`@)`Fs|37|?BCY7ubu(*^@m
zgl18azm!$UknI<XruRdQjyGe7*EVlg$<iuM4r3x9>RQ6l#h0u_a%*E35rQm4ytbub
zfsN*tA(g-WHaxZE2&v276FQrruVBX>si&1jhUD(rOLwLJf}WsRpyI~HxgQrU{3pR1
z!f4PNoW3iFt55d8y$)qR6NtJGc~8kD&l$bi5$in5>!2~$>T+By2%V*4HXH}05%TUP
z&OC7^$f7(X^I-^ElC|P|PvD;fyVQ|BmkMJe;D3q}a^&|{3*qki6Zy+}hM#<=o&sgf
zM!}@FZYCjz{uI<^`TxL8zqNP}KLBxmvE3!^bp!?1-w1@hGS?9V|K;$`HnGml!T|Me
z52dO0ANj0!`0HHUl9nS}BVi>Ql4z$;%;(n==7GPGBL>)t<>5Z=E{n@85I@JqvbM`U
z_-@w|e?3F<yZ^o~D{+Arg7{OfIGvy=$PqU<%XXIe4cGq~$|wyX*vGW9a{mIwIC|mi
zjL;X<`;UUAZ^{K_u9+4=-?UdYBN6zBsEl9nE|EXs+z21<&6ud@xhVb`<<jN16D|))
z@zSvcD5PBa<2(pIc>{6ie0jl{-qil-@Rz>lJNsdgcqM+4d;tB|6Si*TM>fOgEpp>n
z{%(PX?_=U<Xk&wt2Fm=rFP-hN_o1wDFALW_XvPnJj>JJ{FE_3dsgjt^sg74)kK>j3
z+ipfO^I@wYqSRbNnn4TV8<(a&Xxu%rbKrwSh;9E-*yARC5>M9&a8RbwkAH<Jw+iLs
zGONgpfUH70oquB<3r!~6$d4JQJxi9}yk7)z28Xi54&;2YihMpz66hbo)j~@(;Jpk)
z_Osnrja%puAd}%~<0$8f#6*aQh{W>wnBfcId^(gfW_&+{Jo(O~Z-J7%H{lbPf|}Uy
zLulWDzoY)oitzMFkULvR_;MDP)Me|!6Cp#G!=XoXg<GzMb@%9}OEMumS61eY2I4Mi
zUPz7d`8n|rS;@Aw%WZ}|HCo{=SV(<=qLZk#J|hj<(uly6ntu7Fhw${M9Tyqapcb{&
zNSIrX{x(L`Yja!!@b(HsV#57MAp~Acvx+yLzKXF!XkaS$t_Z`4DA1n&atlYlJBSZK
z{vP-X-Kik@OikQx%kv&fSZbt4GZrsgMWjE#ymwEFeS9wo+%}BUgVH^mG>X~V_`rf=
z@ZGV5&K!+1{vS(Qo)N@Eh^#@pC1BqkBMM_4E|+rYcmLurrZM8_cP^KI^@KQ&$zAXu
z1U^5X51H`!!4}0+!8UY|ApQrn;BgXX{Qxun3V3cz07TcI;o1X??R2kCfa_l%H|l~h
zgMwhmRo_^D9yYKQ#BxI&K}8YBn2cmGf_z1At>t4ks*0EY1aZmUhk{;eA)%tmzb(}F
z%@`dOqa%cM!3H?y8Idwek3bBOVWvw(`Nw~^wHQ0$MVt|0PVB$I4ql4#zVEZIRK7Ob
z0)$!Dn+Do!hSmD&&yijZBU%V07x1hR-oi4&F8{)l0sw&{QN0jaeW*Cz8V*>)BVN$r
z{J**mJB6-qm|?s=aeN`h4A=@cY9sYe41RR(126r_e=iw5wuk)X_Px?_`Tv6Ghfw>|
zbuTZ8y^rz&YZakMS&@4J_X(mRa|HkY@R7~9Lh%oe7{o(AhkP^Kj0=bCUEf*?gQF(C
zjLHtHo&FKZDF7VmTebbS90%|s{5B`WR6Yzp`cHNT<E<~G2J=9{(T+?1QsM4z8a6KY
zZ!Ls*W9@3;P7?BTGzPp!;<4bGJ#k>*Q;(mB#)d)6Fyfi7z7g=v)^N`38;|c;Ynvv1
z2xjIE9S7IKK5tbQfsHbPTr{{JW7*@X1)3T|Tr`v%zZMYS9{aR!*O9&h_>aY5bb!A+
z_*(bQW@|(r-rslM%K?SIq4CA-Lt3}w-*=Y<aQl;ZkPvBs?Qz47W5M_)War>P>%;5e
zfQX#DnxH}yEtB3NUJ=531#k`sA`#!texoA@f(1IH_y3>u&4OP6u>creuRHu3_sBnI
zFB6d#Kwhu}Y?=en;9%8L_x(oHI>CqcXN`_A0e4^gaU=JHA~SQ=MQcmKoSh_soRj0^
zh}Q_v$@zT~W7i5K)SmR25gX$=C)JLC;}eX?g{*#Ff8r~W0$uVS>(BfY#+n3fqMji>
z#dcANA@gYb>-Oko1@mTL(pM*p_zE}NonAZl^jJF<Yt#nI7{mYY8PWt<hvo1CySq*w
zSFRs~9HUwkL4ZTL!~Q(Dt!H`1?4b^LPr(df;HL~f1MH0PI_1`}88^-0sE`qelY$I6
zwm_AwXVUvrhLEBLz+m*Jz6a6Y_a6?Sh7GX8>zlv^zL)+-&)y1fi#Wmv2$gOiB9K?#
zBR&Qk1lwp0k7ojmYNuU$%gyD_E{Q;WS9|8xV8BBC>tk?->xauMHo{{2LU9`A$|4)H
z{t9r_k&{&^ocZp47sdEUFkZue1Y`l1EPwYJHe4q^AI3r8V0&%Hwx91F)s!y`Z72k7
zd>`@X0Ur3?<S*x6Lw`&UYs=#;+;fPV7w7&mGXCsw_SXGK=kej2*K>Wl=4R;!_tWWj
zvBG-a-0X_e&>;)*_=#Kxy-kQ$4?s-Z%9!=^jp58Yt!~gDdjqYXUkG?s>FM|*{1d)+
ztTJd8;b2g>N5Vb_jwkUGVh!OdyDyd!P<tN&z6m&Cpx=y$?}GSG-(ef(oIrh?cqZ5a
z)V`QKhCXgxb9e)N`aSOP-T)7OYX5rR0eAKPqvz<xs&xLbs;TjV06+3iApdPA8me{P
z_|<)MH4*uEOw~5ItTsoC32|3o*yIr%n8A6u_9qh#Vj+;KfJ)tA_+|J1Oqy@R%|ys-
zYRSz(7(_U=8ToRszne2q93P0HQiK=~%;Q4e!3Cv)7l12mjmM1u0!ZHIB-U1WLdQ9s
zKk=}Yf~*<Zs~-v4!?1ol`1foP>7Ia*v8J>G3CVfmZv9#_#~AoL2mDOS<VS#?e<SDq
zPyPzMAU$~?Cy~)vxCQ&yX-;qbK5sL9aB;Z%p9FBi*YbaUUNL)IKm7-{c7WR%J#b6R
zoMkS70VBW`{rUT(-w*s?`Kp!&*E8B)tWfEb6o`d6@*<9qT#UGfpY!?u5jG^ylZO31
z_$-(=f>y<yK@EbT0oh0qaY;*k&(jBjToUXCWI}9d>!o2m&*>88z)8LX@PIM3z7cm7
z_xh**rQoM1fdXCQliC^U{-6!L0vTg<{;>b4JKF<?d*Gg<V~4iKN8b#{rqS#MrbuAA
zKmEz&@^Gw+W+F5Q7Ml9?ArXSV|6aZb>lhD8nl&~iBNG$N#*P_zV~epR#9{c2b7T}d
zk|Ig*IRp|23=Io%{`f50kpCKt9RN%n`l2#Kek*9)|BTI>{x$?(PA=t!AJsj3*?)Dy
zGr?bwG8|3J9StlHN&!*vWpMxEXkoijvX)zgVDS4){M2*;e+8a~(iyP?lfczgVQu$+
zd~7hA>R2ozx?S@7->&#|Rtqp8gD|QT5<a?!4XMJhk`O=fa5D63z3szre}E{_Kl6BG
z-JU!08!lc12i}kq<`H~v&+KJa$q(=3gCpAy!XG)OFpZZ1>@q!RA8O!##{fI-(hq*>
zctJi1U?AUtrBwXqOa25q#(b>}NxljoNbP~|)nyOBe?vdzksB!25S4S~=Dr5AVkG9-
zKp*<Ry=Q{#AaM2$00I1_A*A&r4;PHR2-|sPeUS4vBw(?czwsO;;ChWXZ{i7C0$c$m
zuV3|lz7g<|!Gh%#0x!d%hrU7kCjety2U!`~RE+~He~7?Mo`ClX0Df-tki7%mH7cip
z{Ja!o&5S#1hNbDA9v#>QJZ&IAZ|*9mx}n^mx!KBq<0S<7IEkpwHKqH8AD^Ga<B^@%
zrrKTzF{1%97pSS)s3P#|kU+p(pHca9TUH19EB&>O1RTJDH+Xyh88q!yawq;AlG?zN
z(cUa2!NkS@1B7&P@pl>bF1dMm2qRhz<j~M=HVy~PAV7B~85?}ZpiFh4=3wJ$_H_}3
zF%gj;f=qir-K^nv$74W<HRxKG^)sJ*Bj$%R5KKPdO+;kilRk#w0X5CMzBaJ_fIt48
zyokvER3?7F{%_6m`PsokIV%4d@2Lh876``**Z;vLk=%j2CGgIy5TUzMsfwWw2ZKb5
z;QxjwM0!LeHL!xQvVs@OPmia1;T>TkhxNyUz%xA50p0xpIekL`p~K-F_$h%i&>pL%
z^tA{B+3nt2zP@V_&4ydrv4i8hKk~JRRAokjw#n<0;MPvZ@$ea+xjp%Y2EM8HW__+l
z(ed2tKtF2`&uaaKO1TH#I<EX&V?E6`-Cs$ER{-v(AU^ci$Es<)yWbJOME|CIipYyg
z5BQG)C-UcU;7_b>f8rwKz>R?VeE^$0M~I8%pm{!x;DDC=6mwW<meFP6OuRA6gCoJ)
zgT73^9hYB%kA!}DFvU)GNScm(UsDz=2ye{ue~Y3BxVIk<BmN0^)5$atP)D#ZS;u%=
z^<E$4G(Ph6o8efI?8h~vRG*<=7xa(9_pjd<;0YV&BU?Zt)8zIA`}ZVo*>R(5?;XQd
z`~|Y_PwfY{KnrSKN9-utFG%kR1`I!c(tFb5PaH%2*BZcloVwEUY=)?y5jcyvQa78E
z4fUA3m`j2575r|)-%jk51ARb3JHzN-M->(GL7sUS!U5DE4+PZUD9En=5gHk-v|$GU
z{@QN%ON`wkn%a!r8M?s&`0pMvdNm`er+m~XVI_@lpCmZsW)b2t0s)SQiUup;Tt&oZ
zh}1`k{JRjEo$-EXDQV5anIRr3V(`uQ|HkLgiH4F}X54|=n>^z3d*E;F??3=Mluok!
z|KU1g<#(t5f(oc1Y3Ic!8^2g(A!HWMei6d6(%pt5UmiW3H;n&|oFE8l5H@m0YG*$u
zJp=*!;DeilxDck*K{LQ=s8#0cLB{b=&v@<)0vaoC{1U+<;7{K}j?7SS^j-ITd@-$I
z76iNmZvi{V`i}JCo5PU)AMv;d^}tT}0Y3Wsu|0=F)Zu$K5FY7F+H&X~9BeFOOd$>r
z*{=vc|K{ejp9P%U4fM1iVc@|N4iz1*?I~ePpzreB$I1_cwVGH1^-j_^AE2LD7QkK<
zwA|zN65;UxKdCA0U|GEx9A$5$|F+o%{PX#>S*4ZB{`k0KG#a3exYL`-zmX{)bs8|Y
z9$phE%cJM>tWP(B4vBYyjzk?6m@dkF0TQ^^FrU3l+9B=!JAyXn=>`875`iAkxG*u=
zKtHP$-7o*RKY#8{yPq1PeOLPKcWo2AX@9;^0?>{Vmuaxo8f22?&kxHiX9y3%Jdi-6
z%F~j#(vi`CdHJRFzUf0qvKa1bN2V6UTt*@zCoVoAuC>8OjT;JtlUO)@pOQBd!#S@6
z8U#AjfbsWsHq%0zKrla6J|Dq+0edyTnP*J|tXO}?Oz>XY=^W@38WFjDrZ@2#<lC=^
zj6yCV6v02XzYb%9f&m`CM|$dETbG2Ge-Hd^p^yZGZJM#K>v8XyMi#K|Lv7(y?N^Qt
z^fw&B5a9fK%c^{w5M}@XffwOw8(0$vt3kB3q_0r_Uvw_z1~gTvo0hx(8=tmx-5%*b
z55-YI;7$AOfQ8@-ls@R0vkjjGI&!J)2n+mdJzBQyT7PG8pn!&UmRFx>%Q?D|!Zrv^
zLI*Ds|Mit|9Gem=Mn(Kqa2NF;*^nRIU0>t*2slU5%%2a=w7<^VKd0#%G7Z(fclayn
zrSuR2x<xOKqVySHCeP4cm3IFZ#8^VRrRsCV*DMh?U;FsKP}Jaesat>uO~!P1zR*Y}
zdHrDb(!uU%@q9g|fPYf4Mm~rF#KrRh&kQDN4a$KmOkN2eQlSG<IeW_x6y|bS>h7-y
z_7G>_g?&E`H&e}La>*Xt@h|hBYMXbtA05GpjEn{de<$i1PdTOZjkA!-T~K!8PtOqo
zteQ9aADTXn?2kyn76`xiPriS~s`r_E_=@88INi-r!zWxM;<^6ph!R{Qw1|QRqo)_U
zKjJP7b2y^D5!lSizv&i%mZSd>Hzu5r1ko6XjIlS31Aza08RZ|b9MH<QO+dqi;HPs1
z2s8wRAwI0f&Mpwi#ZeUG`NpF>6x0b`igE6Bra!9E0z#a+&_tPsJ#LV|_>bcTN$p}z
z8qL7JKwF6$W%lYcgQ5TNu$7^*hj(R*`SkS|DC#-;Xx|(-)W0oF9AsJ@4WIk0GgcwJ
za8s64#)lP3#ty<h4U9htxJSZl5wy=e5fvF1)qEqVg(1gBEoj1Hs=th;xSzHXCq%}S
z!krZvr2R(G{G5^*b2DOjb15B7{1MP(gm+Ge;=3a^GYCZC9U;uxV<#StvPN_KMBI@8
zyFf(0%bg*NyjPB7T3!phUkrJ&q4*e#^zfI4XZ8OrX7U5>aR<$Zzp|^`u{24wmxnWC
z1@|mCcZZ|@1@fD*l!uubj8S=ic&@>r)(|{8t2BR~xseayufvw@u$0N;rvLIsCDLev
ziQ=|1W09u!jNFCm2NC(aHhaQW1ao$p9-5*4BHb>`FN^MGIQpoJyxN-$*`48vhP6b~
z$)xnsI%NT;Y9Ql)l&uffBx)beQG6wWHl5*tgPm$LGhY!rMiYp}^6ZcQH1gRD#71*l
z1T7!EfQ{q746OkV@a_pb#}Gin(Og=}{5zwkxPbMzaW@cijQWlQA35#n|L~pu18X8i
zC8LAEPH7ZM8(96`#;b=l8o*Jf^<m+>9sXLz(wfjU&zFvO_}bu!;3ZHq0I|DPgXu%|
z@J8?#tZLPP8<IjE+#nBn!m-g&&gcrC{2|UTe_|UGK_mQcc82N%;gI<JmNFOfa`}Ij
z9&*(*dg8euEi$mUzcwN=C5CjoTsE@*D)XiC-!;c*Q!sy{$fAel%k{!q%*s#b!~E<!
zToQN&?~V1qBKXfX8^;?U$;M@Hv^+qs&s=TsAD363f=>+Yj`-fA<55sf(8}}<XHeKU
zK$}&Vs&J}1_T%9csg0Tnj$_AzB>Zo>q!6=Qn&kB(J_pk&VWiYR$bDcx?CQoq(isQ*
z{L>|(g6?a|invZlWPu@aKwctTMBET~zZ1w!i`E3pULxh5FA4CT|HHV@Xc3T_ZNrMG
z*?;R$biVo%N@ZtTIaB|eSWShg;HRic!McXHfYJ80LgV%BegZwfb0{rCkD6A3^WEC6
z3Ov~jO0akU^V(kLFO9}+37>0eYLCyDM%|$OtGRf=w|51oXRQ8&ahw3Y-<|}ILgy)v
zy)&mj;s4D5>_;KUpDZhy!@2UO45~EC|2L0S<8_fCSsAJUJTf+P)*(Fw30}Y1gU5wS
z!v6*JGtMj!jV`Ykff_Y9M)kezG3X`2JUdo8Re$&)*+o(PSgWp4J?B1}v75#C(8$T*
zc!wD{ee+FCrNqN6FYf+qaL9TFL(^-<)X5aj6wDFnxS-?c@PmN(K>c3%;T{ba4lC^4
zrGQ`xj)Q4OA|9h>{~PbOxN#C@G!Fq<G6>p$zNg;sZ`VMBh?ZmgMt&FZl!GLwjM~_u
zzwoSjIhWO7q`;OY|NLk0%n%u_1WiD~--hC+4fwyW^qrmj{JAKP5EN0>`M>{&!A>F5
zw#d;E<wQ1S&Z0gdA`r>P+f|C|*m2N1<qW@@RSBBuc;5-|^+gbIf{nOSueY%7qMHTo
zwG#`x^?iL|#7hA;4Y}w2NY%wma9}*+<pN$#4gkprc^{3x_{au?jPA@amAEr!V3FeW
zDsUASu3PsE2K>0*pRPN^`B13O%?bt_vvcr=Jgf}2K{qH`p$+g^<6?gk#<C;blmt<4
ziLW473q3`s>@#Nh<)W~T?-$3ceAZZvaUO2=ZLB>3cvHckGccCm8Vw?Se-+Dh(Spho
zS$hGd?z+K}JLM-Y8f8pKQNy&)ys-ZX;vpzw2=dB>7vUY-erZSZ<>4%PaCq4KnJDz_
z@e{;kh{?^%X#6Xvgpir|(6}LO<Bk2@O@?^ys{;ECx&QBk4gmdkS{=kfQotwMLE~qQ
z=R9W!_?~e-(mxRWJrZ_%9v!qq@EkNG{0HG)NwQvml|1v6+?oDPfayEx&BQ%`d%I4Y
zwCUad_^v_-z{1xb1+Na_CvwlxMo&6a0L7_PC>?#xYW@?`DUR7<Y0-Es=AGq#31TM3
z^FN;iyE8$if~lAAz7gF$YB+B8*ChGG@IkjXVyRTsp!_@%E?5qC_*$P<V?w1!<kwPG
zy+@DZImorkWJcO$rQtY?LGY2vm<Vu=W(^CGj^%xEStd9z>wodwBg-whjW3zs{z&U2
zjJKDP@8U6>6ZoD(-NB9#w#gMf3UmmR0vD@r_@~C!SAFT6K|M5^dVTg+4*0qQ0)6x!
z^4KNN;#@v3C~C?9jZCqOg%)vw98NF(2zWzR?-cxYG%^%RLB0G#4o+=sWZ^rK6XUHl
z2ycY)$Bat;E5mYN)HmBxMyyP{ZMYnPKjHqUaB&l0OS6UQ&Gk4NiwWd?<HkxbKM)Ds
zsVM!i!U}(l{ujs_yR!!n<{=Yp00g3J5Iai10Q<W5$W00Ge!t}$30!60mJrL!-JoR=
ziip%l;DV|UsZ$$<fKUEEy8}D2X26Q3Y@?FC^}mBm5UU@eUw3}_yhR{Kg81Q%fwhiT
z&`hY<hcZY9>w*f7gNV?`tYl~=V0vJe0uu-r14YY~`~q!Z78!OLhDZP4hp2%2fE_<q
zu1l^??53<w1XWyj;P~G{!#@YzoR^1QI&VtI>*GGM6FFl3Bb&wiE!9T=fl(F0THy=L
z=j)cE=G-U6c@#{e1-OX3MewIlbqE*-fJ(w_$N)S)2w|o(upq#iV}NVpb{g}m@DM+D
z{VXYMGp(~>x<ntMFM#TsC}}kq?kJW6K|pU;{u$B3(4lZ0Ok8u{{~Q#<ZlnMCId~$D
zj@1QD(g{o9>&?<*L$MHn+2TjwCKQbI{_PhUS9s{ts|Y+Iw*T-$u@uAp<dG0Xj^*CC
zosiUIPtWs8&Pcv1%>*7;cz{K8SN!oGl3cPb2#DN9P6+lSm5{eLQg;!83`N9iguFL#
zJaaD*9*l*+K0NdsY6ibo@%$?VAD6qe00HkU-xMKn=^y>#BH||V@%+@E@SSIZB#lqY
zH5uagPUMHSRs_Ul;FeHX1*iS>fWP#DE0Z*FkcJt=S1tE0A|r{d#%`fjK)`MAmXjg8
zA~cF2V~r7nyUEhuHuh_p+G=Dz?91_d*u~r%!V<();-WM0U0Fz$#t_7Kh+CHXiQ>Fo
zVF4Nq0-haTjm?Y-5Jb;e(O=_t2c=pvCr?lN>Z4_KFQ5MnbNabB-Ov2g23l)`bOIhY
zzYT-Y3Ge<kBOl&;#qoV7-LF@!60qmVHS+UsP>(%KnmLpA&1WMq@fo>%oDWbT8qB?W
z|NsATWhKaFcXaaJj?fCZTazV91r(q%A`t>5oa#Cn`h2yuK$se&>{0ds`)-A~@;W}N
z>+Jfu{-Nw8Vr>0Ng3aK8Wi5|d8W$ABjM+-k^lW-o$JzSkE(G@Swf0`JP1Cz+N>r6e
zl~H;bs+Glg4!RJ&U4<*_U#`n6G|7PW9Wr`A&uaONiRPbrU_7V&d4&kd91~6v#Wxop
z6!j-0_~#o|5zeO@2EsC^P7J3eQk@h-F$&7=_}-50h2pMO<jGQjMJNVi5vB#0?6I#1
z(P>q)J?qlBQ4<uts#inn?rEO!pfiq7oh#yLTR}bdrpxj=^?)kfdiYhYJ1Uv`)Geyt
zuO=kyGL=-WGy>Rz^P|G_s<x*$M!9{Sfn7JY#f>$L{C-$LbC#Q<ESQk}ul+dwVDWI&
zu4`CpH%(fFwcNbQstPLfrCtC4DEdL0z*-ORo>pU_0tZ_06!98ndGU}t_(#UYovr#^
z;rhtUSU9G;ohsG?ZZA4m&`}9m27}z!2>HJ(g!GHLAmAW3^4-?CX32G#_(E_%aFv3*
zY1TzeeGD{z_aGt0$yn}cS@X#cB(cpXC5Yc2Y7-xTJ+Aj>GE>^Jc(3;-@%)(BV2-pl
zg1M%pm&?a=QIh1XVU91c2BAd=@O#()Cg1TNUxGcgytw{sH?I(I7mn(f|GtuaL-LyO
zoYpF#`>;m5y?O+WO*zyPlQl4}G=UNE<{wWR{rLI2T-fL}+z@@)F^_?U1?7%G{BJC}
zJ)Z<z)N{fXgfU!P*ukWcZxCV>;k?u9Kf+P5h4GQa_sP!qzAm~vwo(X=CSzv|N*Tf3
zm@&lcuJVb8P{p(m2gyUuVg+&;i|>c?LqG&~B`qL9)!>VZ)>Ih<U&0nhgVQww!X8H&
z+>%A&dAwlD!d!W(=!6kee=J}T8<>-pNMwLhg>4{^8y#Cq(DAV^xBD5!tK}F;f4F}-
zfarUvg!sE_*do%$L|~dD^KsE5_<Gg?cdGk-Vw1wnm>DBZH*JE8@uTb^Jkktf)cn>Y
zr!V0;0yUv#rMdZO$8PI{s5n=|EX&JeNL_Nqj`|SwfN2qe9%~3hmx+Q-GBYsK67yLl
z3aO6-ma+}F^Vih$K(RcL582-7>f1rRS!ei(A<!|8-o8#>JI%yKjizk_S|lrqy*Wa@
zxv0s1mO1F!k!{t<JM&A#@t{F9qlL_4qlDaFXnn5oO?bN7ON~bXFPFND;wN|q&#9}~
zG-XLycjltKa#}VR-JhC!@4ab_<c)E&PROBypztN(I$XC_c|?$;0gu}8exkXogFMNv
z+dO1ojV;2+ZH}t*Y*T0Gr<tMajkCTn-U4~1q0W9TmS8?n;5A55e7qR$fPJJ1JVh1k
zig<?c9AuO-I2qLSrRzPLGk)UeJSXlfBhO!)KxeDu)@X?1<9BohDxlern`dVmrx}BH
zd$3tXzwt0gH@g@Z4i4*(d^9ilxVp8C8EfSjVraOpJxY!*-bwyH1`KmzFNcInJRI!7
zzg~^vXO)J?XAfs=oRkJhptJJFnjT86aqxABlfh<vTXiwvnV%0V-xC1;y{>R-$116W
zyncX-#AUKu31Ire^XujDxsr2czsoVCUzd^pei=Y7T$(l_m-A1YBgJeoDR~I_%mbib
zE_%bz%>14@TCQ&oG~NsO<0_2`zC3zfQfO~no@#iw`!BYZ4LQ50ZX+AQ6E6vQG)LK4
z6<a#`qlOaQW?P79_2C_d8wJ}#9t-IPtOy#<@h|y#GD6vSxJu9@KP3FX{%T`W*>BG+
zH?vIsQ!NI=@QxjeX;So!G+#$w{7$N)Dj5~C0-F*3;pkxhe=O=_q8ISzm#^^mZ^0Gn
z(<1i@CkfjJ{o{>!IJ*LdV60^j5LW{8etB-CNXteN;VVWS9RaO|kZK@*$HXMQ0ES<G
zdgrh;j7vHqaGlX!ivC_Xb6nKh%gxaSb6+naE*-U%-QV&3D|U4T%?d|40|Q$lwWsfz
zw5Q|b2E|n20e~P`t=`Rs6sKn({u$Aj7HQcpnG@-*XvpgL5Ie_m=i~MQjW%`Y4}u-D
zufYzP?z9jG#$I9>lnGr{Wlo86Ka}|lalxXT0`Qj7SR8U;&nI=9GBuOr^GC#Vf%Wq5
zzG^c+31&(`EOa%%9@6HNZXL@7?Nhv8BE2vLyV0523CeZ^dZ_Vy-Jn3qrG~N=RI<vJ
z(wJf{hjy80H~JlVEU9n73|wu})c6A)?w4hu`~MdMx;mp-uqJd|cf}GyMNVb-z6hG0
zV9|1&uthyiz*GAFH;d}cO9ag6`S#@I+e3dWI}V%v`9_clZ67s;WQ?+Nbc-@@QO!Vc
zSArL(wXqT3Lm!3){6uh;tcC0S@f@;3cp^6uESO6mZtVVUY9@~=7nh$O-1|p}<?ams
zVXnAFR#gZ#fC`o16Sei(CFvRgh_gnV#_o~7SNKbSji!yWpgx9E3;#<Sl>V>r7-3x{
zenxqyY;aAEPxBK;{vs53Zb2ETZ}c<<{(d7mUTKZM>#1+?5PRuj8Fce|#-Ll+1P!Eb
z=JEdQ`UAAlnmDy(1oT8h5&kYiwI#d>tBvM$rk=0}o^+D%+@ZcB{eI2PpM<W5V-HJW
z{r=`09~vIGuQm^Y2H>qMPYF#2-IJvW{`EPYfL|rr$=@7?$HZWxnmROH9DHP4(nm$^
zRp~_W{3FxsUXS&&!0()P2j%416)Z0=b$s45aPWt8)-X$!5R<;o_K6aCX7?Eg8N??y
zVFWqzc)F>nQ`CxLf36LCnQ@fxSwS#313Op2U@!v%^?Bdm9?G|;H_^SQ@P)RiwD_EF
zQb0%__rz>CkE7Ya*ZoO9;3N`&zz$cx^p5x6<mTs~4%aQ>{uyFfSNDjEjY?_0J1J{N
z;SEH^!;EQ6uToA+sehNy3>xgbydv_JM^E1o0E(?$E&ppk01v~A)YYI&*@f^Uez&ju
zctW5&2d^~lgW4H54FOk^BPT!1W!-<D4{!vJw0(5)_NM6=^}-XPuoH$-$c5XiyxhB7
z*hIzGVR*ZQ1jG=R-u>zx<{AaMKZ1U4lZN<CNL^NNhwe2s>@#z7s3RUG*%04mV1Os(
z^25aT)fT?<garU^#q3b?Si`D2{E!a2*=bw}hWzgtWIL|G+*Kk;kr09>TR7VXBEatN
zZBKqINhb*JhcAFJo8Jg^25Uk=dIP|vY~g>7{Q&@*KL5h{JyUZx{G)0l|Ey}NuLt;?
zHO2U8Jy46#MEP-BNI!&lX_iyuXkQTy_dWdXa{q#!tPmvZxN)G{j8ppevG-M*^P2|*
z#ea^tjp5d05#Nz|ui_;vh?zcL!e2~e_cw$&iQrKaEw)%r@ML3fX#W>P|D<NaUL~2Y
zf-Uj*?Z&ho_PrH*|A9azZma)Mf&Q26_(B8zE<@<T!V_4;?Z(@T!(SoYKg~FNV6+?-
z-;BqZ1}ERWI0HtzUxfAu2fh9i@b{b$j%>@{#&A!e)iH{VdQI8!;E?bVCRO7E&C~4C
zJ`CCA{H~nW5oC8-8uvm6*W{CUJLaAHCBkw-$sH76$lR9$*DalNZ{8E#(<Oo1z7gNV
z@yX4((B$H!N<iE3@Irqt4&{&G`68|?ME6L-!|$WQ9uYUBJEPN&jUkR1xs833koq?8
z{E$a>)h>;(C^!3FE(2HKgjzVTReropmcA~E>%fop^TId?+wSxT%Z>VkFZCOYph)^O
zoFAt78)pIofvLy;+%MGJk^YflWIli4j|g-4A){*9QlHV*zmm^>6ytFT8er|jnekCT
z{$-n!2Y*-3(u&*eg*{zYSRj*|&G<vYC5)c9rR3ogmgW3>BlnymTSHaoU0!3wC}r=r
zeb>dnhin42e}|LPNS>{7ZNsMk{YvDH&i}$43``gh6E(*ECoW&=@EDrvKKI7G+5_Ar
z{Q>|}N~2u7B{*k#4B>#zc<G<`x!|`UJ0bBCVF)>?%ie+=WW!63nDY06{3*CT{be3k
zgcn4K@hJ~;N;k)hnK)j+M!Rgqp6u-Xf&{u~EplUk;yGvD4tw%I{G9NL<eQEUNNmpV
z!o%%P2zn@2FthF=!O4hj#@jm$xDUo<eHu)t&iFY;pdpg!Xh5*rzz_c~LH`{*b`}Xb
zo}fy=0uSHx2C>6C^+V%mFcF*JKX|d_#+$F#H-wxV6TxmWAR(kFok8Rvgnxnis%{{C
z$GM}5YjMBA79-+v;w3*^mdrlXzl7>?-Ju^EU_{}0B|-zX9vkpMvX<BIiMg&m6aGMK
ze1;$05B%`O@45f&eW&t&udLXBJ$G(F{qeUq_5VI!!!xU-{(S!}_DhSTmXR~@duN>k
zO0hiFrK68O1>BpBH$~#-qb!Onksp#dlrCNn=D|F5{@EPaM+LpMd7!=6UT*+n>3li=
z9y@iw5$p5@eLxZK;QswCHGXZ4Lyms{FZ{nl@94PFRG8ksT-eHld{$T8e}`~N+H(Zl
zK}i1U5$S>LQ~zZb1=9Nb&?Rv=Lhyu7A9-N-gcZ`F38@7jCTj5i`At4N4t%sLyxmaJ
z5Mtx^68nJ4^7QZbeJ_D0(Kmdp-<U|;fXTQ!vE}?TI_^*A-ZPd(F{3ZVR#P<0lLAL2
zrA1xNyeD#h?~`^CFCE|vk6#auAR_G!I80=x@6`{EAi_rUjee4Uz^a6q>zfS-Ap$-N
z$^JV!K!(TSb<clU|IRgWL<sybctThq0tDPO4TxzsR1JI(j`;5?D*wS84SW!rMj$o3
z60w!X;`>Y1w&i_~GH&NIy@8BAx*z<Gsa-Ec{$2yG)_}^qR$?=*=}|uK#zaW~{@iYe
zL+~9y`&Q1srGXW3`+D9_004pw0V-L8jVsIGey)9fOYDis9%ywaH{ZC^FN6MVMuSHg
z#Bsr+oM5}LE+;qu3gn&S;Tj+tdITT@b@~n71PxVCOBe$4+=n_0@AVJ)0f$`Jai9@=
z4Z1C+j|DhK!uA43z|-dF^TYo=@9ao?2_D~_!X6?|AH`1z2Z1Z&E>E;EY|z3WSlM}R
zNg{STB%}}}!Vm@JDFL)kgw;LKl|X$l;}cxr@x}UiEDOD$GN((&@#F<AvrfNXx*r6(
z_PSOF>KFK$yo5bNu=_o1A7VGaiOI(T6@?ALb-J#XmzyQ#fX_tu#xu$Wwao1CUTn!j
zk9*ihJivfS!af4uU8j>=1?$|Gx&V!)fcxA6e&86dATmxFos^*et^RKUCZIJ3@z_ko
zyJ?YPVV(bkTq!T6_R0<e@t8xx5jc+#i2O&0`2J(~Y}*qpej<Au*X)Eo>{9alzKs_H
z`91)=x<j2Y2I5=9_l2Xn1H*WAzVZ$UzrY*yNDtnG<g!~YEs`nVem}=Iy3(HTAaYDZ
z!|WgKY_%sRCuM(deo8D-L2KDN=!;JsU?2%zyuY^)s@V_n$otZdy?AgDZP7oqKt#to
z(DPonAcyTuM-qV>R=v~Uk6;v<a5~HCdHsGFUt0wPQ5;7$P=GUr#R%(?QVD~)3NPX+
zKmH@(`avL&Bri5_MU^50)Q*m{Kz8~S%|*xKk9Q!e;g{Xf+sq4Aga1A9eb_?u`DT6c
zeEorLE{{{o%f$HOBop%o9N2Fa9)xNT4~xVMX1;Gh3CsY8y|4FM2QCr81I3gkHqamX
z@u=J4+X4@%vtv@YUVKi^_h{8iULVDHA!~KWyH>D%<+Z2oI&A12rTjbQ%kZz0o5RvS
z<l!2@lO~)y4}xz*>v1c17t22-)wda3Apm1<)FM}hy?mFR&(N>}^Qjfab4cz!z<_>h
zMFcE#ynZ~$pn@K@jtROIyF`Q{#0$sAABcm#TXRNk5YCbZR+w!`j)aqguncE-?zH|-
zf!k|mTVLS|DFE-y#myiG8+Nm=`-(sgG~M^w<MG@8!t%Z^V!sa5PG(=`?vVF@20ebS
z*9N%n2tUIs1v&KIyy+cfSkNRPiHH#s-uHf7A@Q9u2!zScU0KJ?OqNc~1LIfRE-D@W
znc(x84&~%55^(@){*)vB@#d=paRmc%@@|*H9N~h~kC1!MzPT%EHw;8_a#9I<yWu_~
zYDahjMt83z@4_42z_NFri!jOHRd<i&;d21dkJsom&yR}u0<HIf9<u(QI1TmcS!rD*
zx_iDI>1XWv{5qTSW%1Dw?hv?p$13rSh{Qog@fC>#-Wo{?MKcEDi4n<!yp}QUB-5`>
zu^$Ee)!L1>;qPnk;+${G1YaM?m^pQylU%~ffX(mke(^AR)2dZbXFQ#KfYbd;p4;w0
zXZxQK{=EW+CkC$bOZdtdbR0E%1R}wL5VA&gStkymDy=6V@Sg2~?{A6or7dD-QcdfM
z$RA$dbj!%!0-VvU7}$(K`8{w$hZN1TKk;07G0{hpJHj6X)OShox>SgX9<fwqVgWZ~
zAQ3%2&qJ%{vv8_4S4THmn@wJO=JBIpc`2IkpAj4LFOt#V!<UHojynWalE@C%eI9|S
zCh+k;Jt^5D=}eb;QPkH6VotF<z6o9xM~M2pa^{UW|EgQWd|Ya+XgD13r(9H?1f$jG
zs_;V_khs3*OCnVQ2YIu6og-W3$4N#I7O3%@*a%%2>x6$-{%(fc|KMG+cF>~a@d9o5
z7E%8?j!s>v8P^juXHmw?Xz#)r;U3uFWsCqsXk>ub6Tjj%nR!T*&TcDFc{M3RSemdW
zH6rJU5qw3xgbAsenlMVx>1Pq*MOwV<-mxH`j3CfcH3^;TiOkFu>6A)k5}7*q5M;y(
zz(K0pb0!Ba1O7~d)*zTf{veCZlTSAsl#tDQPc0utPgeOn+&{%rr+RQp#p6+a&7<M?
zy$yWJ`DO$Q9@m?~Mm*vK!`7J7y{M=EHV0Qq)W^9U@b0RJ*CsdxqejhhX|M=oe1ztV
z37&!1E^k-MMmO%_c=xm9gpj;O8*?cC;S-iG`Sv><2H#r3qSmOWzI?9>w+ixh;_q8e
z7u@huCLo!=;&{b3h6V^epRdJWnM?rWBo|uqzOcb;{tES>VML%j=Ik)(9OKq(Lx<d|
z$1bb@mxjT2H-HI<zSymptaz^g8!iUp5YtFKUXK6-1O<{zgMb1C1(Zz00)U4B41+Sz
zTgk#fs0Y8oO_8D+DkfHgV8Fy}=Z*;h;WknPCjdxAuS{eD1R$qg``wos(DEz)@J+Cm
zAXGifAEJVk5Sj3<tcY>}s7mux0-$RRKUiNi?-Snd6UAj8dXELeqe|VLGO>{v=6Pfh
znEqCX-v?en`L2I63bq_rYP9ZI5PiCM=xX|s<&iy6-nM~1e~jM;UVbWBE>dJ~lRRkx
z#9k2L5Qo7uH&TFFryQow-nb^iaIBASwWkeAV{el-eiN3%T+eDafpAZPtVpy9fTL&5
z@e|@C!X6-0KBj5Z&3X;$XnUbAuC>i#kJFue2qcfwqnDSCra9l@V<{$369{11fKhys
z&jtKe1lET`*fJF{1XOq+03Zoq9+?LO00aS~1JfYl00IP500aWlAxs(!Rfd+$@*;qq
z4bTGe22D>600D>$xxPOJ0fgll=mK`M3E=2Bu)My;6bub90N>B#00II6?m#%`7!o5v
z|Cor)0{kL~WZ*)E06T1QI1@UXX6MI@0f99dfB^;G(B?;<;YI+=00Th_^uopj*d$m-
z3{fd4+yBX>lt7~tU<*5K0SH-b2~;Ta!ayIvLBXq?3E&7^BEp2x<g>4Ki3?$X5^_=M
zQmQV4-hc10;Px^2^avxLfQj^UpeYf3Ve4V)KQxS>=k)=|D0}=Y0r!9afCkQh18@Kc
z0Y<<QDvju(snjyL2YwSG8<#j{0+jsl?;lodWH731=%wVL5gXl=b~=9(S~aYbdg)Np
z|H3&1<gyIAUyV1zOVKQYlgTk~z8O<0=~jZR0{pC8oY}nH1poid2v>8#9PDW9t`Vyg
z8Wqp69-}mhZ(5mLnGbBM9}p6j91gylY4Kbl#o*C5%nH~HUj*^=&b>3QOzYD-QQe7P
zpb>cbXD(-dlHIvOZk<e;{9Z5h^FnB6e~F+jB3Xlixsxz(S0ZK(3gk@uRar~3*L)?y
zb3c@&5u6tr5kG`E4D-U2bp*B@8*ku1HJWwuZdmhPoDxGKN8kieS~)a3;5mRR8`FRy
z*?=ptDGc#OTF33bd@yAdYo)*TR@!7@w8&Ef2M3q;p>n3e4bTFz449q}00sgsS%(u-
zkVHvfU<8k0Mn#)6GKW(53X=n|T1(h$-~h-t#$7T#|M(RA*EF;EC<u)FIBAQ773uJ!
zR5ri_1WCRv(6e)Sc!SqT%mS0nSC*NMypaH$DW^W|7~Z|vfSf6&zik$VRZqec5{r*f
zaNNYMDvZd-jxN0i0RhH-ukA`(s6U2N&bZD$!B`S?Ar7PnfBx|NPXxy3l7%QG2CN?5
z77?{1AfR}1hgmjCJ=g#afVYVWZ7ByJ!-TnQ<q#6`<)?|3)<FS32;k-EG7eso5aC#t
z!EeK!b%`de1b(2Hl4knk(J7zA=-_why^gU0wNyTGGMHavv2$ca8$uC;B|Du$JE3tN
zBoIf_Jq{0a2fAl85azyE5+93}kCuWOelFq~VE%#{d`2V0c#q(kUoVA}#<4TDclek%
zE0Hq>g12O<1P-|-X{nhwLOR)jD|q+&`tUQsSldM-E}od9$?5_l%>8rko)G*2&DLqx
z&rrZryf7XbZr$~i69^{}=iq~nq8DNrIAN~vNZe|S<8Dj@s@c^8vN6YXyEvbU%%ibK
za9$=5;$v`NFhKD6j>*>raKao%K(Lj_%Voy{!0fIoR0$_b1aIQ7gU%Oxr*}toE+gQk
z(=hkGMyMG)aWdg>LuStDgt(s*@jgW^3S`YfXD24X?(TJLydjy76`MW;C*VGwz4HLC
z?CH;Bo=!D0zkVK(%)FTI_%`lrx*>d==UXom4ZFqzcDC(v=6nj}|0i61C(8!CI;7$4
zyWxnC;3KT=>*tHmmnRG%Nb9-;F|S-T8x{xdJ=E&;%coD=q5?s`$saUOyW;j6A^YL&
z$MbiGoo7dU|HSu0ysR!Nid8fz-zPR^Z^SrG^-u94v8qUP(oh**xro!c1<lFa_$}r-
z=GXX(JOSRX@tBTb=SitN-aWq!_T^}jJ^8t*!#a!zoJ<z7V->r*!1^~scEWOgZVF>k
zRi&0~UVfc;xk3eYw3ja>B<8CAuk!L_M+F@SnaPh_(~=nX@<u7Kod3dj%`9Zu{9SW-
zDfwZYGqX~2aMIDv{}qR2J5fLp3fe){fZvcxh2-(3K>v%r)?x|Bh~(IDyNB<I<@0g8
z!TzPZA#iQ^38;^9Txzc)rp-?9Tawja$Lr>}PYE1#WY?3x?cL#NIXuzC2&hKq$Naqh
zBN5^;9wXv00Yw23+HcPcl0cOhKmUp0KmVKk@Lx!g%~}r52wOYAza$@>{t<{rh<eWz
zHT55S0##Y9^g~PKze|mNfAM*VBsW28h<zK4-{j93WHW^Mq*;)WNH+(OGFl}IM&bFb
zv6K)R1Mrn_<=;28e;=>hU%+SS`XAQ5klMf{&rrU}H6-?hz0T3s7ZndJ<3!Lw+I8;)
z0ffAs4~YAp@T@cO7sTyRjDx^+XgSy6-U9SLz6M5G#tUZviad=xY>4u7=mawOJmcW8
z(IDUcKLB?7$b{-ZhXluW#Pg+PA2#Xuu56ZwDV`6xXgT6LG&_QfIwIk1{0GWBtBaN%
z7V)EzfqV5R=*T=J2p{~MXKOwG1lg@Aw+IhZ|6beeBJ<6gg(4P!k2<)R$S&i4o@*|e
z{m(aW=mJp~$eDQ355o9uH<|<zvz1>(V5zUhPZeTP;GZ$bL@?$g7l%JUL%y8SHR=8k
z*1>H5fWKD1^WlC2%}qu>rS-xQ=#5#krZjF(arw>>ApTs8-^n$z!EZEnYkE_f9TRbg
z#H(5UCx-IOAmyfR6XGV2_e}*9U<nUM4c{Ltr1;k#q)Cp_u=|rX<v@jm?i7W>9wQO>
zh@3=hPvg8J<nUnS;Qq}DOb(nqaFjz;p~vy<&!v5rz;4kzF$TIs(7e8E0ylK#Q5C^e
zC-@i#+KJ*IZ5=d7d&+CLK3JRZA3q-{X?uu%Oxc6_Kg7*`@6DV!X5R3L!=nUY2uG6{
zG0DgBe8CtZ*sBl+qaFt@+`+@x|K`9L_4>WU0hXi%Y3=~y(}($v2L;j`>E#R(7@lbi
zsF(Kt`0ye3=Hoc(0gw2Bx+7lhbDbC!e7PKx53VD{!7DL(+>-*$yPoKL6>JDPLz_k~
zbBFww+Me&X{3ehWs{SAnze~wwi+y}l5&R15#IIwp%pipGCk~AMUj%P~pk_Z2SdWOL
zmXcgXKGEVSC8U=TkF;?T^LTXzQ^MFG*!B>1QDDQV3IAU(YBAjZ$9Q300T%XyS3#NI
zlzsW|ir$azfDDf>L;guIx)Z@2ajo~w8#{n}2pp6VBw-v^1bJKc#CAU4m_Z1z6BxnX
zn|?FZG^tMf6SP-etbu_JA-O{GQAu=GU&0vR4K$<&`X|J0Nt%A3Km0#1S^~^`(aYC!
z{{>X;kdt^DQS4{omnMZ56T)`~q+mamGAlUm5q#cn<(Z2-ycWao@Voc^97(V=fLZB+
zf8d|NBcag%m+&5v%&@}0lkaZd?l4~TL*Y0uN-84?@^nGGuqN)h`MR_6?2dhiM)JZg
z9Zge6A--c{S3N^XXec@h>xzbSffi(E$G$+BUqSitwEIA9Z}=m@dLi)1zq#|NZEZbp
zgb2TZyrbr9?JPpx0oR(oA>Y0~URoXz&4`l`^6-X-j%VPr2ypiB_U+Fb9srTqRI{(z
zxv(PqW<Vr*mz|H7qz78@I0VN12Ya9ajjQzg?h_fSpT9~U@<E3UVj+G^WQ2l<Dm7^r
zyHB5%Iyyf;5lINkaQR0oZ|}rjGBQ8CNV0h?$;bQ#&)PwA!>xhRa7tPPCxHcM4WlL}
zu1DS8U*U9z`Dghs@;~7TlY?M)q75JvQMKMeZ1<MKhY%CQ<cRSZaTSP@gmA+6h}z-w
z2ZKST`t7eY|M#|l1^+jIF*Usi-_yr!z-{Od!zbK9-sm5|N&O*Iz*Md@^1nA1k4m6&
zF^kOt6IQ4bVj~a3{J7fkb3=X@)UvGas@^jfaL>GD8@&j1?`?08@2`yR>qCq7dQ0K;
zSB9008GYUVwYYD9{hjk0UwQKW9h7FcDuQ>-+Z@~oTfmshoAc^5F^CYV_8wmZzZ-K%
zC5iDni4i|6H5VK2f=)ugq!5mLca8)H9T^sYM<`7S8WlZrcm;o;7G68R5BguA;P(Ir
z-*R8+|LHi@SM`$`o)`g)-}-U$<5lZEHA~01GjNvo#tom3he*2pNr29<<+CpD4+wid
zFn1(|$>9h}u7DrEP?#V*Ix^J_9>H1==8?P^z^mQAARs><tO|4pX7~sd$i3*#XHEKs
zdip{x>i?F~?tt|#YH6T9%xUgO+%6-8ebLSMZ7nV;v|@OFh#THM+7L3CUju-NuQTmc
z@Fc!!ZHdAX;tc|COYslx_$=^4yOhERX+1{H4MZABGk`z2@Joa}{YpRqGsNKvU)fyP
zLdgJ4zhC?r-l@lzj^Kr*hhTQ2AU)^=j)0Xb7Ps*Ie?Wfqcz4BSRT8fNyWRw!@swaw
z!u@EPCJ*lByFPH2x|+euhJF>#`EQg3f1dc8Y0)@{Ld?|K2m+`q^iT=@FPk|t>(#~D
zQx7l@918i=U`*jlO2Z9{7}*WAh34!}0PgL@yD*i)_OaX_30=KZW+ooT9el1cJ1`<`
ztoGPGFrVK`TKhpNuk46xasS~tfdF@)`(xlVt-V;n{9Jah-1S~#z#a9=x2`+kmAagF
zz9qGzYLp%T+w_3zs_A?o<+ONMkZm8tXZN7>d-@l^fT<noQ2hZT;v?mSVP*U_fryIS
zj_`+j5KP>NgxPvtl^*gSk+Hg-UYQIR#6<I97x74whlJ*g2%5nEoc<g`Lh*UtWZ|aY
zhLEZdfBPT!SAspuP))A_eqszq#uw}3W^PO02>2v<%rb-)0s7~}o_Gi!KptlHqzCwe
z{}F&8tMqSD0nFbJ9+QKNYM`y~{$4*|#@=n)<^Z<)_pK@5CVI{DydR0_olQ*XY)8^R
z1-?qG*YAX;PVa;l8NGd3mxTD&m3g(4KtlXXbZ9CU1NQBLKC+XqO~acF5b*n68=cSi
z{Y-$thW=JDk@X4Nql9(q|11z_57RLJOt44C@E!TbVKB!7zk6vfWnk~lJNWNl4$spU
zzx{&&kBFT`C`NwjGS>wDJP=W#3s=gxt-%QgeV(qJ8$0CupA0YKAU*Zy$nC*?1dlJg
zwW>W?20N0wUIbkcdDQxTF4ET@jNcKi-wY?N%DsmhyOZ4B_>O$aG!OH{N!URXW0x<2
zCFQ2XMfmGSjx=H+zNz51%lUM>iHA5PZbsMg>R6b%<{`%#z!oR*c<}M<p<(#$Hy&r_
z&_d6B`-$``7*CJ>31cG(B5HaRD!;INUx1HI8`+>Ed82h;y}zWt6B=8`cuXn%MUVp8
zdqr-SNlz~hdHjR+PO%~X_cOIfKj<IH#Pek74XCj^*zdoKrQEgUg@lM090PHDMD6dt
zmdIe)$9F(D&Ui57jf-#iE!Ygk-aQW@QM5DCb4UnV84dyc(-<A&0DJkc>T^niF9aI2
z7qXTz0q7!BASZ_PjYOFeutWcZtva&)cEfT5(s%iffi=d+5ApLE=cIf%6fb-259*em
z>ulSO|ELYyd+Qm)e-{j9pHNKB>Ta{ax8NlAa9qvz$or2khR!Vai;0`SN&B<!7uxrr
zKDmP3*HH8X*WD5po)k=MfB5bM&Byg2ET*Tm0Gso^yaRUWKV-&(DD0zhZ~wW6^g;U}
zF|q%T<0U?urIX@Z^J}XGQJk^}$7ES>A;;Eu2%6cc=<+{^=Df!r1e{#2`8-b*<Aa7l
z+HU?4)<AMBy9n^qB|HKB&<eWb<*_Mx8z--P5yOasJ&L5{%WDDny;lh^rH%n-lZe`9
zVO>wJ1bL_w33BhZUqbQR16G49LIy?V#yu<+yB)rti-DA-kQ3G5cidCVH^<TVh`JR2
zZ>EuQBwfgi_CNjHAs6r#UV(u7<-A|UnlOK<V1LryFM@xrVUDG<78hy4F?<iUhLCh)
zgiK6cJ|m!>O7){6e@Q>j3-FJYL7!8x3>>CzhMIbYYFqqA0`{56^41{7XkLL$E#e@Q
zy3R2bH8@z-k5r9J{}1xU22E^=Mo??Sbcja66S!hIwmX}M)sBxc8TGp@`Qjnmv<>-V
zg`dmBVWga7%J96h_Kd^2e|CFuJ>R%XzGfjlBc@7o!kowDurX@~JQ8r?>s&_<n}CYG
z1JvGrZw>Q2wtOOCdW5;_9zE%KIV~lM;^>+wRuRNRZ<iTL;yHN1vs}@cuYn7^;e>Qc
z{8xMeGN=!^Sw9u|xq$vzKfYcAw5F!a0;BKF-w8o=laD}LCTrEMFE7>_Zh3e^n<&v*
z&y6k<gs+&g=SXDWvNL##@0!K0EvY<5EZCzEkfU{At}8HLObWfV@=)dg0LFL9NgyNe
zSx)mF+vB2lz6g4{T@0&=<-v+D7#q6Qb^5#!_Q8>Izur-NCw1uVZVDs17hY;#uZzbT
zd_*IzYXs;dLV2)Rz%2e)qMlWf|J?tVnxkI8V9&2Yyt!1!8C)eWT_Yv-N4LdJym>zk
zwlX8mv31LM?+?Yq9TUEW>V}4fbLo>270u(2zAlJ5Wt2qUX{L<F<aJ92o@+y?MiKnn
z*3A4=%f}Nw5;OV9-;UObV20wXeOw4VcMLS~<HqI1_G_BdANR=!TZ)H}rt8WAnqR52
z!B06P5b50=v_NHt{G{UgMJ1`Rcjb_tCyfm}407dJu)J4lOELdEmPz=TkKWAXPL6(V
zRwnN~F<jG+sx~3~5p!oKF2qN7U?N^_<1Gy%#&dW?!>$jP9(@mmTxWb{BPV$6-{s?`
z+FnjtBR2_S!fT&wGzecTT3d(l5RWYR$8gt%^QHN9oG^?<UiqsX5W3+k5w!1yCHVY!
z^TPb~_-Xg?JjV@>c%BL@1{_P^oqTVE_27Tb^avc7_(9q0z8On}g!wDu66&4!k08Xk
z9z4*Xp_`MmVn*)kpAjF&!?)Eq&_T5`<6)(r3HX1r!f+A(&&SW7Df6I=jdTdSoNIVG
z;q2*e4xyO>9E|mcti0>*QPGu1Ab<WRpEUpuTk$%Fct@7>8JOZr^F^*N5eV|m&EdXU
zOvgQdmFCBQtpL-*WAaUepb*<;ai_PtJg~|k+CI6vGa3aPz0vr*$eOEkyuBoY+|yqE
zULI0PjvykSAsWvQ|NH;{a%v^sI#&7|iKgnVRaN3qK&2=Zpboa%icwUz>@%AvnZ(?x
zcOf?_i%8FG(C`Do*-L~)Y%^|{C}}x|K9zjC*VqAqXS{cpy9N5Xy|0jK!+#<imz-$n
z4I$-Fg?mWz_L}PG6!!g8&rh~lzlNc|J)H3mRs@1x(`w0Gk%*B_BKH-f{;FPIDLw1#
ze51SY&VIX%&>xi$nJlEeotqLruV=!7Spvx1@@XS*1M2L|23t;*xhGCS+bnsBl%srx
zbZw)R2y&y?Pfoz~TB{e0w!4#67E5^R!91Lars}R$X0a%sQj{~Qv{yGJMyY9_TD7r-
zm`*JdesEMG0G0gO^lBh0q0z?q4K6T4oakN^h!$KC?l+$?pWO6?_jS3~1j-56R~fYR
z-*xv)Bj(H9VKaKEwHP&0!rUGBIj^5m0o)3!J$yLESl95eK~pm$g6+Yx1b6Jzt_6Hh
z{us_NtIo=zYdHFEdEM(&@U)!iXvXu21gqZ$XNPgt(h;>4UU);RMaK(3Ij=(;6rX@0
z8q9R5)fGQ-Xrze@=g#K%j?z`$@<S4Z0*X){DH&1_0S-g&F_(XHK&X(Ej#G$A^*mP)
zHiW&;`I<Lc{yh3S>fEa;TXf{L7)2@<Ht)3R*-CjJ9I=`UCue2IZ_0{v#OV2Wtn`(w
zLI<{mKTLQI{$;LTIiaRkvc+3wb{I;Em$vjmDO!!&Qt5>Na@J99>@-7pT@0xoT5{%+
z+fB^^>f1MO#weQ7ZyMDD2%}8JSQXfN1jm33K$yT#V-_hT;ukZL2m+Qfir+J-y7KjP
zt?|rBy>3+6Oug%CQiI_(ulpgj#Q=7$Vz;;^^1&Ij6?H&+8W-hQjVOLreiEgq63;~2
z+4iK;6jmUIf@JJrI+%7_RMIO4U&Cm{8}Rr4^bh~+X;Gk#mP5V&qr2`J>kI0(PiBg<
zQN6ECXEPkRr75O@3zs-#ZzphCYeIGOi(eYnSY4zE@BjcRp+TGAS`YA5gG&TV*O$ED
zjdt0kZpI<c1|B{V@$B*a0S{+&yFQZRGBxFPES$(cAJ%z%lT3FtEO4>}{JI;4Wewuv
zMTRu#>IHqC^Uvf*CJ}!Uv!{;JcK-M+Nptx4zHWD5PnU_W*v?%f@48kHX3X&&BK&Gh
z6mbyabR>XTwI;N~1^cL{$M-IqE(yDuf8wAIZspX$PW0)AOHAQIo4bEk9xjYE4Xcq^
z58=(lmyyQuR|z>X0*5v1tGTFiSo|R`33$Nm;fDPAv6E?hu1TAbzm4UT{WO6Oa>Z5|
z<<-*)a#<pt9w(9$z>uF8FOma!s2ab^YbG0;FZ@g<vg>?0Z8L@^Kl_0HcGi1(0`p@8
z@zJYXk<`OQl;DBmYWyV`J^XB8e19yvVkyvn&CTnV!|`ssA*jpjh2wo@LVa~7Jsl;O
zQc`S1^Js2GyjMVrI8Dl8i2x^-f=p@NC*xeULm1NW8@F9Y^3un1HxbrGRQ`2dQ+xwh
zu%9GkK>aT*Ca`V7JYbC3o#1%R7vwn_^UTp<?V@?CC_n<CUUkWGZ1ggBe5|fX7b7XT
zk1b>n8sdCB*QgHz(@g$a13-pOpa{H1cx$hhxfWbkJXR{@U`H<%a&pQbQ?ddNEg3KJ
z@)}Wm*b%ja$wZoGi|TaXq7F&%)tX4Wv_w2ZdH9`y%>egD*Cb3g>9S+IUvd*a(~NNX
zX+B#FrkbtscOoAoFPF4K;ycSM34FX_nfQnbw(G+gsV`=<W&eqi7D$!xoL(7g&omOB
zh|ympCFbztAN9x0jE*o!8!#V4jv5xcWt57=0&~lBTlpu4TqT{3nsvqFkv5@$r4*c2
z8HOM{?;f^8V+z@scX)WqEE9MGvW3=kyTkKLIkPw7lt|t9i&(yIFV>(PnK>ohBXaT@
z4(>qnh|dpXNE5rCc%EGF*LhehD_on{{JfsIuywNm2tDiPjI^x;&dXK*q27xFnf<Cf
zCGMr==X_TmIDqexNGI8Ocs_;kJ`z9R60`>Iz8!H~t0o<g0tfB8{<xk<PYm!jASVgw
z(|>h*eH!Z+7}`eg`H_lj%y@Mnf)DXC9u%W$4uQOd$%oVZ$8+;YoRQN%WAj!%EC~n0
zovtrf{s%>at{orTI@W*2W=<Egn<?EIu{+-2?a7;iFnh#jhKUAvG6&_I5-J(FqXQ>E
za&dWSlFfVL<UfulW<D}>)*RW{P7}DKc$j%*&K?mXnw%@oK*e{Cr0>mWkg{AQLLVux
z_<Tv&dEPh@<=!1m#M~!)vFRG#CT`}I$@1fIz=7?@Lh{fP#z4vQW<bur5rll7fw4b0
zHBoZwzxlbE*Ox($-TYmc{I5%JX~*5UUyoeX&iW(q82&#W1T2l=2_a;PJ~DplFNE|t
zS<L(8hhB%AMBE_<SEe~bdMIcxo40{GL|?W?Viq@fGz7#NmHfPr`s*lId1e!vl;Ca@
z-!+?4)62j}_5Hs7xHobFkaNe$u%n^_;Vw}l5JTu~lpkD7G=(iSDLC%TCUSmdao#Ww
z=mfhVfc@}u!g50EvLp}5PI!E@*csso_aDSQP7$Jm9I|9HFH#T)Q*Nh5$oXq7V4k-Y
z$P<JpvO+d&{m}~KpvfD)N#UM8Sb1f6#C(1>``W0?*FLq2g`K;#&UraK+($Qukj*^3
z)@^)$vroD?6xQm@94f|gD}NDgBQixYD~O1$$2zS-x#DK>w)<W3QR8C>H_fFgfcGwV
zer`ewM&##*%UiIG$H@?fJG*m)JXUjIrsr%tWfBk+3omb(hjlsNK-Ov3>4aPh5YXhj
z(nFVo`b{o~-SR@X`7_4F%z48DD>5MPS&o>1_FX;yylg=qOcVYWs)DX(_`VPIEdgLK
zT!q;&Jy?joyhs7B{ytX%*Hgd21YK{4-_QOI+2NSD*Qi`MRHz<5<1ClS2-{N0a{qD>
z1QiTB#r2GV*C}m~0sl*Rc#8Dm@8WZKLgD-Wd6ya!4hMM5CvmV*DUA`RG0@0f1HqSF
z@mPE54<kH|(2n;1EAbrM#wri_q=nHRimc%WAIA~NBqQUp7nVp_A}0y=Bo{^E>Fr9w
zP-Ni>E25qr<b&d@^|x(sjl+mhP+TJ6J^(Q{O;^t;pU~_H^Iygrsz1V4fHC@fxi&vW
zVq?!(Y+;7~1iK7s{-ZxM4Nm|@%^TfCr*Hf26E2{-vts=5F&Y}_{{UzF&4~9~LSOL^
z5`UkOahJz`*5cjFwKy2ur<=#~XC7G_%tpc|tPQfisf%X_y%`<<i^FD)_b>1hI?=C;
zTTY7tHg$0E-Vktqfe0KMeg6QeuS>suDcQ@u56Lh*qLvHEbXHzl@8-uwlvs{jJm5&W
z{E+K*Gsi~wtp-*Z#a>n5^MtYS(fE49_?#;PBqxXFnHE##;xW6P7OR@!^iAbML3sU6
z7@IH_y5Mje9p+Ctg30rjl1Os#mDIoOV@-KQ?oS#xWah2d3&rwTEny>kXPK?9pV#3Z
z0v-P!1kYSiXVe*<m3j>N4N`kY_M!eGL=S4e)84v%M)ZJ)?Ew8DiT!E6%m0Kgi}L1N
z2|sosUf^JQd2tfQTEKq-1QJU^(`-VNmzEx2L&!hH*~$O}f7%vVOGlfApSk<uBM-Wd
zAZ|C)|HJ?jP(lILuZ-sKg#qd?+j$R495LWBdaq<13^){L0Xm*unTz~Ywb~D%;9(ao
zZ<muBo&H>O&#n=|JU6~KWV0{i8^zuy(EKH!QL~DmfVJU6`-e~xz!%>YV})4W*9V*@
zd^3ogML77%xu~*3%_;n5G~9l8d!iXqjx$+JPYLIV0kk;Kj*1t&!hwi$dATU3I5;wS
zYdOSAjPtMpUc3vseffDi$IOyRW4XIOBo|=QC%ViLb+f!7=w#Z+5q|Amolhe+!leTx
zDa|vMkn+)5kzX0$bvgu{#`mO$4z7^JXdP59B=jHe<aSP;@E*zk5tbkkI{E(*43G4m
z`^bOhT}<`Ad=z*lY@?woz@Y>8TRUT)32~8xXT|7K<ShCABM(0qJpFG60|H+%llX~)
zhU9M-Td&f8e(%I#MSu31+H2ws#B#Yee~6Zarq~E+_*OD#Fnm16)3%xqr>T7AkH3Qs
zW5=W_7~C@t4!ZdKPa6xv5*v5TyFw?qvp<^G^QAps5ePj%Z&L_*^ndjq^L^jKdeS?@
zMo)Ace;zIYo8pWmZXeFf4_qDW_;sgx57|5XBRm!o4iE9+^u09!`T)NO@J!LYW-L2}
zt(SoJ?_=NYQJDASyxeroHOn(4T{f@g!0Ks<w+|D-JP|Z6vr$WsXmnT5!P11jfX}m|
z{hnVj8*tgrUCDeNaGdd2JH&q;z}FMqXNT{T%gF>yri|aL@A>+e_>Tc!k%5zZ7t1$~
z(h#0Vo7r8Ge6Y*Fm7VS$-VoQUz&<lKD1tN0^kFV`e#*XK-#$p!*$tW8u<wkXGo&z-
z{dcV(HK$1xS09NP>w2_~!})o-2)tazJr@BUz3==ZgkA-J8a-Z{{|)U%r2tx|=+bnT
zMg=}Gs=IK1_YppinwkZExW65gJT#(0m|@@C{||Aqvpy-|#{Jb~op&^w|NH+Vg4jaU
z76j2!d&G=QYjsy^)>dkdsE{DFx7MgxZFPAYr8R2CE^4*4M`D+f7!{=Q^*QJF-|wIM
zkNe!`KCk<n`#$%1UDxA!Jay4$rE{wFA?<87gQ7|+Ys&=O<!3_mGX6}7LPO7UtG&cn
zoZ?{*LD<@?o&p5lFvb}#O<W<dfrPTE!>RCJzfufFsi6OYI5<0uMj@U!#4Shenz|to
zK7P&*y^n*!F=$WSz16EW!$QRelTdKDv)MGgdGPA-Am^GiN9B+&H>tD0Hp6LNR3-E)
zBs4#AxY+ZFxaH@F1zmJWzy&k7n+1?b;K|+Ag9lSV$4hQ^BHW&m_|>7==JuI;-Nt??
z13;hZnFDScpy?LIkCZUsawx#&8)~lB$Yg5j`&Lb?Ub~R$;S;#>qt#v5M&uX~igzvx
zPuuU{pE-kKG}1pd(x1OiTXf6^7@mKdQQc9$<LWY<8P1$GjK^FD($cmH`_^@&UKlWO
zg&uXT==TfN@dNyi<n$!OOdc}Z{9B-b>_I2{P8zv-JVVD6-G&wO*f<$FL(>}d%}D>e
za~nOmN>9@7Sge(9OD~6sX~m<USMm{>@O<9OY+)p)0fWD1qN4|&!F-&QBrs^@;3~A^
ze>raZdY2a7uh60L9q|L08&6>S*S`6AFb}74U*p2?;@hv?Rxy;%h*XsQ$~V1w@@&DU
zPzNcO`N@P>FR;JF7Wt3!BWf3`;(t6}!wemb&Jm#Q;mxp0yOb#7Ue>w%ZjCBtMe#^l
ze+Yp4)YU&7uP3sC?O&w7q|PaHYD%5=FD(V%l~73}9R3PvApRKZg0gpA5xn^Nyu<sa
zB(!gJd$9jLAX=kfiR;U2zs-MQjK@K;zO+g`(lgRDnvNC~ZZ@)eRGW3h@sV)l<drdd
zGX*dyXb~TgWigWAQMjAS!a=ca&K86PITb(WIj;LmKdI{HiD!y#nETM(qWxo$S5ijD
z@8dag3^ZFpb^`t16iI8WskA?W?l}+L&$0VP?;1ysj*DILNl-ML68*)PY3K*FI^$}Q
zBO}aue}U{FefJ*N$6f$g%{_^By20Ou#I>I6w7C7ah}!^I-MB^7(2a+38N!h`Rpnj#
zXjo`%=|4ublNjAZkWD}Pap0HJj6VL4Bv!vtuc&`IZd+%JmnwMeMSz`0ZM4jof?Y($
zjMcIfFHmIm#}0t0%$!YZl5SIBh|2-yQulHf%Q^EUbTboxZZnwGS|4z0AnRn3se1RR
z+vt0DJri{F6MB}H;pr%DrnUSHLN_73=?j|*Cb<DBLSSv4>fb&qQf}U*y%-b`*~JAg
zr=4&dIfI^1^xC0<uS!PEk33>&ixRs+e~i*&66~kP**;{BQi?*{z+d0{z17pRG%-GJ
z>IKBBJYBN+%Q)#tnR8xRc?yoorn+9m41$E{UqvpNFPk?S!m2a*CX3`&GQp=#n@HVW
zKlR1z4NeO;&~TZ`L>&1by~DHi{%+sk|F)TLt}{lsd!BKf=hGz|DnI(7dv*#0j0nB8
zFA&GbHy~BV$L+^umW-DbALo~g;7mN7D}qF)JtGW&y2}~v?@c3WM^UV-q~cs1@oBNC
zqN00gI3`A<_-#O1y8-PBh_8{ZcXx@<3>1zs^`dFuTD)~GESr8(@B0dQMN441e@t!^
zSU*o%s{LOZJOe`h_o1{Ki5+pGL|v3{%ENQ)mF6t59+^j0RKudVP7+HpsD+*94Z9J4
z689s0f1<FGq%Kv;Zv(YDRJ>=v#jPp*Rv|D}oqKipjWY0J^TImY*HfGQwT9Qox-M+P
zPG7$P(Dj7=tmUxNtqJC{K*tBVPaX{r5L*AMv8Y}MMj85FggFII?-vy*oiRUou=tN^
zhUd9Alk>SZP4*3}c?Fr_UT!cn3C(ZtLQ<T(7o~RlnvH{*qi!6(-K6`|B6AcDJ{*C3
zGTeV}l9K~(Ac#!)dQX%%@)DbRZ?EOC%`yqkg;<}-U)LA!KJ^le7s7sNYj4;V)AL>u
zE)6H!(mnk+zau`6fgkDfV9u>SUy!d(CQqwW=TR6|iskB@Wn+->tQS2qJ;i*-dk1J%
z$sVDX^3+rV!UrJ>P<M%X*4&Mb^Q_$zvjLyS@Lqxm)#ZfpheiXNBGDylf7`t{_ez&C
z`aVedBn+;P;6;YS9&NZgYhFxS0w7a2dLLXgp6#6CV*32wW-6r@8i)v}RuG&3K@c{D
zoh@z(0`b`{zkFOajyryZ7O@-}o}k5BAKN9wMCj2?Mk)}PO9U-}t-;lge#}LG?58~r
zzAP%u@pn+AoG%?O?I+H6fVmGdSUmiu0C+HF`Gl}2+Whc}cHWr83X|xkasRop5MS38
z7#`&gOKXzpPwcPe_)~eUltLY7CTRTD-MbI{?!hJszL<Nknf~JW6<P^bI<BYe7JW6&
z>4ff?^a&+3qz!ucy^<NVU|bg|q6lE9>KYXJHrk+;ivr4fi|fD;?UJhQwf3dw0Omas
zt_}ESEk_UVQ3S;UZIHhxCFDu`d`agXByG#bqAMhEFWQi4g>hsArC_wuZh}<jCav6*
z44#{9EOA~THyW`JWz$JVk)y8UhIi>@M}+Fc6(vo%Z?X`QU5+Ck(PyASQA|5S4&BGJ
z7p$ZCZJw-Bk*OqhAWFGnl#5E;HAm{S{+VSV6_M;oc49l{Rb`aP-i;6GXOCu+S19b$
z3rww;Ue9{1RCdpZ*1Mh|fV7W!KYLrPBdm~h(W)a-FOMrN_pY`E-p|2Z59FgiU{QA!
zf+XrWTABnRmG>3s>kCRL@B%Xx5xF8uaUv_;6P`i<NAh-4BQ^Q-Z+}eZ340vz**1Np
zj++X9Xkq0W=P=u%f{*&?Ti$4t=K2z3`Ge{mx)@@Smp<%*xYTj)>rICC*PnVm(_(cJ
z{_`Qo9Coj8DgL(MFPnU|x<^*x|L)zgDn+cgC2UYPunQrj`f`Z?E%;q?0<aZ61Iu=i
z_P2qv*INJ3?>!iSe>M8?x3yXK%zns@cfS5RKWhmanFAGQ5BHSR6n7YNi`^L=?T;NC
z?lm=$SSE=2!04Wd(?}LCe*f;aNh)=AXG$$l_$rldz7bhxZ$&a`{1^nDPIa@KltV(6
zYnqK!8U*3Y<Z(N*WHAMs#N#XMpU-0j@VC{f+|Qw@rpb)5g^>kj(K`x+XeFyu(@WK3
z_&<2Yd30trR8qSgT@-zBu1)9B7wOz9@T|+k#^Dc_Ixc|D*S#8mN03s#mSMVzF>ES2
zy9zMX@3tkEi#3sq|C<>#3rG;`yJ@GnsUb-+abN3-8|{JpLYYqZt9Kl_s!6NqDay4h
z@F0(fKDY$^GNJq2_ox0l^Hr_5d8x>_h|ARoMn`&@csmGTHg>GAbzpp8QRpV>_h5Ay
zJC+?}*39_A(v7(D{Gy(1u#1iX+#@Wwz32YQUW9J&IJzd6H{N}<SW>wnTK0C~2Vm=B
zX*Z!mIp<?KSN{GH{XdVE1|iF$@CBhy?5S<65)YvQ$PSGscN+NrQ>5#=y#QED>fdMP
zJTpWA49{a%WaR)a-++yiZk8_5S(U@sPXv;kPW9<>&rw++EnB+tE7Zl+&dFea(ic`k
z*_V$SAQ#x%qB4JsaNWLQ@GpnKNG}9((4NU{Np`pHxXt>I#`a%m@#mY506@+vbC=!I
zC7<h}RhFzV)#1B5!voK|*V8QtqO#5pHO|B;G@kYLTYT01i|UWwPi&)06P0dOTNGFS
zb0g+~_CE)Q0#4WTx%0sT3_LykPq;tkG`{>7sZIKTZkBpiedXH&_fBkAN=ako^neeb
zl7%N=J@z4IQkr{aK@nHW*L_>&!>-1D37(rAOv)oRvX|Sm)WzE{5c087x@gUsrIpTT
zhA<y*+#Bn=k}BN{9xvZDy&G}5FHTn4$Z)AOFPqXYys6N|9d4iOiH@B7^*NUL*z<;s
zHr4W$G(X}|qQv?J^L0a6rYDx2I7>9sz{PWmVFD#I2pap?tJ6o%k0s}0XZQs8HOs1h
zGytj*CSep;6m<?SD_xDa;;jHc2)7FjXV3|9{2Yrhc?Lb*n9tO|;}|c5dB?>NRu|8w
ze`h8p7fDhywc)4dO;%LvI1mVG1nG(Gc32>E^{bLH|Hd~^$kUvBXbx<}9MZY+MzWHr
z%m_a~Yn1jL<wAF<<smQ;00exZhbGzp&ck$6FSAJ2JaOgoY#A{JEdmYqROz3Ks`$O8
zGC0j^XB>ZKd`@@!;givo7>yuq5FCY61^^$t1Au`;`<|A-+wU$LL;%tY1aQYs4S$HH
zoAS7aKeS~+9wi`79HJi=PgiA-RRWkc|Bk6k8<yU2gv<Db+^FJY?0vf{r-JPC;5=4}
z7eZTT(CyFpfJJ94|CfSud8yQ8?|td4m9#`GidnSrh=%`~on(L1@pJP9L7<C1oj)k4
zy>NIz%!c!Q!PhOlCe&JE6;efAqjk4<zcrv`>wC9eh0lc6@k2TIQepZ;Bu}mHE?IF*
zwQxw-O7i~&;gnla#rvNQTPJN-r;{@QUkB4Ub4oi+vPTFk!>G75Jfl#^th=(<)K;<M
zY2H1amiG^0Ds=~~ZFqSg0OQ=!cEl4f0;I3p=E>t@MSQfe<cn;-L5EnoH+`BOCdo{H
z6n$O)M?gGhUjmj9pumfJrK*!sECx9LbohZ>`rwxs<~`tRgSr_}HkcS2;6W#uH=yIw
z+mvX4L)>ehSpBOi76F%J_Ca~(nX!hYr!juf*pG?*94I?QFRsj_7sPGB#5>&Hf`j*k
zMd@QnVC3H&7K1f*X@&Yr1Zy?~BF7m-#nKt%uPUqh#<J;K;GzExM&ItRf$Ya4yMJWo
za(wG5y8$krjWa!~?jT?K3Sg1u%M99WHdOEAH!5l)tzStHi+a=RpsyQC_&Tz*T3^8S
zCF$Yy51!X9t#l!|zo{18m4tZieHwT1$+5dO6XCj95_4DV&X2l!#qU{Nca$CFeM!ai
zyBQ3e{NZFMcyT*W9;z07Z<icA$Gs-27tPiC-ltnN+QnY)e?atOV+^as=J#@~{Au!5
zY4Mr#|M2yWF)d?JGI6CK4V9}LfRk5|+L7?An!zwcjrieWryVibClDR&2s|nNp#tmd
ze;{$@x`ih{3+U?nLShy}HmM8BN=)Ru8s1UIez}pbU+@|LQ110`W$fJN`3mn)syvN0
zAzOMhoWP*`W3YQ7BPmUea{M`9sM0L3`b8KxGEcgBHO>Am_Ej9p|Gyts2ZHxe#vPTB
z{e1T8PnN24@ahUo@#UI2x*uN%;Vgm*0wvHxmi!vuX*}nA^-mAwt14o5j&pLZOZXm@
zlJiU<h@)Rh^1t20)gwphLo0F9yU2kWiNDcJr(|RdZzU#|Du2+la!coor!1{t^g&#e
zIiaG;(I+&8=)s?c7JS{yc~DRVkGEF|r#`-c(x05{nj&X(^&|A&-!f*J?1SjRTN-kb
zi!T<v5Ax*V!Mq$jOMtBqD+6Emu1VgImRwM0U`nJ^0;K|9i&C|v5_`&RkC-m=4Gu)n
z*XlZzz=3zyb}814Ug7gFvRdlkB2FzJI5CA7A|oB~fn-p&^;6E=P$zg&@b!kzeMAYy
z2E*4J@#gq-MGU3Q(n5Z4Zqql`w6<k#)Ja2{hYuXo-Jz696I8Avb6^&u`4bG#PSRKS
zyZoBOlRdJ-AMCPA)|T&Iy_UAVRDyjqkQPw>`wcMA0f=LTr-_%WW0L#-z<+z)t>MnG
zoPH%?wo=y}isCv(c@|Kv<)BYu7v(0t?FHP65l7c~xa|DUQ2pg?wI&w986EvGb~|R^
zCeY@O&yX)1^?m1<3_+yAY2???Hf|E$T6i~Y^}HYi*<UFx`OYQE?8tuchLRDa{mc)d
zc=XnJLE_Wohr*m;fd70$#PPdL336th*5`cxD*vZvno;!E14D;MPy!^TkzadE*#3^W
znAUPbVnD%M8d1ds7J&2Td1EYHC)H;FT6aq7czTjv6nu+U&434ekh$c9`*2-CTc84b
zH$?#-@x8bjGWV|Hc?`wS8S8bw*10qC0;lSzc;jNvSlXwPyDhbZr+>h!SuX-y2mLPZ
zCjTclPHnT+#_4EfbNypZaaW6ff6=pDByG=wo}rFXM30l=5y%mB@i?H(Qro2wkI$s%
zd=ar(|0V9pd&O|I*sShhcvA(vvVzzzSa^XS*dEh@w9gi)JR2Om<IUWOF|Qv{HrcOp
z!}mMQIbX+K*qxH<xt8L%5wi<+P~{K%)Z&JBQ;6XPMZUPTQgkkPA3dYi{~P>nK$p^)
znVVz3OZqEp5_8zK>Ad34xu^8-V8cnkqS{5C>m?K?QLYq_-Y88<$+4hZ?KD2(p)u>5
zpJnPEUc1ahr#{oL#@ZijOwdEkjN8}W!be+s8T9dv2tP)(9VoS2jX;3j9>m@Cm=T@m
z3h2)7R_JrF7mQX+qQ%!?0w)P?_{bU*tIj6D*<Ky(<;2#skV_|!?rv9<8OOZ4ErMm+
zRqC2r7La>{^nLtq>15Z1<uhMUWYFLLWXF-iI#<r~;LUdF*=5_zHcD)HFb+;?n1Rbu
zg9C~NH3=}Ny60@vm<=4Rw##S_A7L3`)|6w9DdAtR;*fI1D?Z1DYpGX(rFLGEh3udI
zc+o>Ks_drAa`cS6b6IWY?R+VN6Cm#(E>9XdqlbLO#qp1OUv2*c_5{i6vgicbKk?Q#
z`1)Xdyj@{=O$Cog%;G)I2}-MiK|Xh*3`q%ngHMMV?J52GdT>SIgPK1hG$eTeItNH=
zqdyzva@C%fohCuT9ZUZOKx(|cr~w@<{)@N1UwVb>JQzc3^jci{dQOhO`G8pR8zR*s
zB*EW=l$x=Bb=obm<L~G3T~~5(%OXgD`Ja#7sqp@+i|!H_(R{8-qrIY<24JNl#rLU<
zSL4WPE0qG9EETy}s}rMx$FCmHAG|#i{Un8x4DuLivaCC&wMi#nlLJQEzU*#8&2k;%
zns4$p3lebLD=~oi^&WZp>Vzy8_PCB{3@IaqZ&YBj>r#ce%^0OjhKl`G*f-Y`_X@dW
zy1Hy7aQt5E6-%`AcA4<q{PEYM#%X5-j7`*W&7R=He5a$->^?*Gs>^g7n@o{!$MAx{
zyG=|;`^5`RgFxK_VV$<GKz+jrj4W==K;+KS`*Hz(7m1+m#GFOx3ReXN3Ve!*z6{`?
z8K8NQa97bDt&`xQ?sIlD+i>O!U&=N#JFHj8gl>w$C9ZJfp3i0HWpJrU7S4Q}VMC-}
zUZ}knu&BWCu{QS1@v4&~Z)cS1^VQ`eB>p{xF;d^8u!6twTZmPg6J4DHU1{~62O4!m
zdV2fUTNd}<fkQ<=yX*`sNXJ@sk{4`?c}WeJ9>8m}sW$Sh0!?d>*PiT16?V~@RiDzR
z3xHn#1HHOFcXk6<nWUkAJ>z)C8IWdHVLtX@QLs$*yer<f%w{QKE4a42#%s#R@HgSO
z>A(0!>*p0?*9BafKCy}{rfw?%3aa8xXT2RLOs$Is|JLIPEC*hxLObsj-*zJFfv0*Z
zcBOk~o{_6gPY4J~+50Dt48**|)UkjNzIaL$NCJLH)kdheC}cagYQ`o56=pc9<FAU-
zVqm`_ld6eU-wBxpI^pr7&W3^lfMmuN@`Rk&2RKGJ<ZyTiQb<9zE@=O6Yyi3lfSgAr
zJF%zf%N_N8++?H^a*R9E$`fqbN;BBaE4)zTCN!aK43Zd;dgJG0`t+WnA}r1J`g;Mi
z_;qEkJXB7YS6;+gORFDDH{-?4a+2KD4+#P5aCvIWud>o?T>-Lvf#u?0hTvhZU71i=
zg+|{x<inFD_)cIVCFjj4&T0<TeEf8M`LqO3y~5P4LIY_231a&*s_Qr6{};R9+Cgp7
zx;`8JK%-VO2Vu{BxSCMrP?>zHgKO&uPDR@zV!0CbTRmItm18>}*jnHuQ0?Fdv###l
zT^!n1%rZb#hKFi&^>-FYmq_c<rV}7p$Ay2&>q_*ryfLZHt)~Ogc?{Zl?cJBY{7vWp
z><n6X5_po7Ds)1{BL}+X312Aie%yPu&WB+x$SpKRA@!XfL-T^lQL^p@Mun}((C^pW
z?iS34-M5P2S%{oGb5eX>Ja?>T{Uw-^%sTXA%)oQHm8XXxr!anEAhSWL*M09OSCxK`
zWJM5S6!!2HU;qQzA1U*A%#G=TOtT{RwsW*2gt{845(t;QAGKop9gh6Ye5uo)GCJ?x
z98nYqU3{`z&kt68QTna1anr-~?WZwB!0^zUK<NEkyhr1|CJZ)joc`z|Ui6ke9sXh?
z`)iDTXvT&DR^evW$r~pS9AA^wGc8C&;;IzhJk3ETnGMlW((_omnetbaMmx~0z&|cc
z^)m1&Aybs>kN6mZ_6d!Y@inJS0gNbn!QXNkkf^`EMKxoNh_t{1|93R(Iwe3k_G${S
z<`O$*D086h3FodsG41_PBdYj1)r23^bYit5{z>+_cj|AaNjdT`ypOC$l05oi_^0u6
zN6d8lED}dyj<0CgU%w?vCI0N*E$n@u1N%y$XYVNSrX^;8o!&3&(v;%54TEjLsCjAw
zw<Z(w-sUZ732?-tU(#^&ln3iYXih$tSOGDO_+(UnpI7rtc&&hn0kyj|D5`yV;3Exj
zIO_SK2xWP!nrgLh7KuT(Zp%@eL=O|31fH#zT)fkR+Bgs5{Jp!C{2$jvG)JLjWAo9r
zCfd|?5wG6JkwLjUO#Z9@@bG^oeOB4AXmS><(a+^Ru70#jeqyPS0xsFzvmhk93W`$F
zAzx3Lvn8a`eoM&5sv!<W&fSk~6|fQW#~qgQNF+(iDA#iE<V;N=K@kW$M7NUi1~K@d
znoW)eG{HRLNkx@fvtUxnGXlQp9iA#X=k~Nes#4i-o|P!#a}FV5EekZDnNU>9DUk|p
z=i^F?kN2vteHeF#t|c66R-JRkA_u&(!D;=@A9lqc)6^7HC>W0sr+tmQjI4(a^z;Rn
z`P_lMt>o7tqNcx(3=ijOkZeeT$(YjzaJ@Ee^4N-Zk##oM6C7k1NGDqBBrpwLu*k!x
z0hZqduph-aFdC7yRz}!7c?#&+uh)Yq9#9&1m0zjDiJ;DYoFGy7d+RjOsrM`91I4WG
zs=aFbGofBvjQt!oM)w#-qS?2?9uO3+jIQvJ7rR<~!3$qkpl$U5hsgfQf_drAZ3Rop
zzxiakf|>!kOU-mA)4iXi6a6`T@E-3bzn-y3O#i4cJ`&n&)~Y7){d|CVmpV2%N;Piv
z&+XYqc^;h$^ieH|$L4^HxyP2_tpblhP}k+g$KhqBkz-pQ=vafzPrRbUMDlB9`NkGQ
zptYy<ZOceE*E><j$uQd;M@L;*p20qO*QP6TKB9I(2)BoEj?(jAbG|>b;T3r!)o>v;
z9-`qKJx{|mIKyxnqakOG(s}{YVqrNbWyPgx+p~sYud=c^8xA%pf@trpntj!~;19Fy
z#4oR4`a#gMKe1MxZ4%Ot!U$RqvZJM21$xt-B<w;V->Ci1b@*9yUn$Le1757iJ8cms
zXoO*^7R8b#6W0}n{jbnc-u%F|6@_~)lC9+M=Ojd|sMk+b`m@|_6Ot#T@!P-?of_SP
zFVYIh^)<+ld*-EofP8Y6EzpCym&6lBVJeGKf#{oxXnE)`-Q8Oag_{SrBB^F{8b!3g
zi!WrHZ_K3$ym^uV0eCK|MlE}e>FY4Hk4K9=vZOhzI>-#*!*);^*-@WJPZ?DBM>i%M
zcHJbj^KQ%v4En1WW+4=aYObuAA=<CE=jKdrB^D1!JdA#!vUB(1<+blwzXcK@Y>|5-
z`<CVXc-iDtce~2g5s^>ia1(SG5+3c%laq1-{p_8xxd<7Ji`j6gzjt3kvl0<Gvzj*_
zQ`mAYT(CY@ycKBg5l%n#4Y%28Sr8BN6_;{+nux~{x<~LO{k3^|%@IkM^FJp8^qm@J
zwO_+;F|r{Q;Tb$9)@i$CT57{{O#ZRdHZhAofqV1WfSPFTLb=i+?4R&mIir*`>@P8R
z25Z~`IOK8x;^TUndfV}r#^a}4!tYg(uFv6laU1v4=T*qzQLXJ737$SZeGl$jJ0MN$
z%R3@@2lEwqQqHbA7EpMaU}YJH1I|)qA3cxOH5O#MgM|)O15#VdKE=>kRy?m!b1B+x
zaTwzA(!KT!BU#DKXCIavW=0=3MmnsH!ANTVc#iKNqAKC&*~F()?ML_iln$2FbuiDF
zGKbF?KaN<vKJqUhPv8X(o1ib_!AG_a1rcw5u}F^7*||L1%c}A9vYhtjYH!RPXwT1&
z1p0m{s<-m$GUK;sM_ou^avF2)L%v~}TTj-k-v~iYIX-zXv7F%$&wpSF%+?g|h#L%T
zv`g$NH*7o~y^2VD#5dWNjc%B44jr6vlDaUOw6=mPG7ZV9^$<3>g4v6-XgTA0$CIzM
zW`np{fYdB}YB#!bjQT~^sY_(>EkCZAf4tCmJ~KSXG<Q#abry#(>`J#^@(B}mR@GWb
zrKc(8LA@0uYbL_x&~uKyWoT3Yh*Dy^T(b1B?U5N-CzxMo=V&rAzU5{P5DlaA+iM99
z*4t)dOB{ak_a3tc#5p(v$DGr)5sQBDQoddobdRrIub|74>FP}5g_c&0_A7f^D+^1z
zdHDBzJ*dHrioi@oOkhs?R?f3;xCm*71xBmQbDl18I8II=LTP$rr{62C2t6Bn>u0QI
zM;^xK(|A=wCvw)2>tn$-<b1#XReX$R=a<`ReJ<PA9b#lxoz606umgri<=@!7h%#M)
z!n|t)d4U+wzlGT+rDpT(g&E{&wfH}M!+U#knI!;=mA13vQe=cUPT~;>7La?(9G)T4
z-c3r2Qz39wbx?Qrp+0%9eHe6SQrF`(tCESDKJUQRvK<-Z#;EJ&6EIMkO7~t{6YGiS
z{zBZq3ro>D)y|b+Y0mpE9y*H)ewPW|uo4e4s~ML}aNlaR>wY!ZeDyxd1(r)jfBm^W
z6$=@LoCGK30<O=<#OUi^>ImyfeH!;|oxx&=_j~p2%MkNS4jDi-$WBYpe8aor+BAJE
z$l;>Wg>}Z4>y3FjvC}P?TJEC7$1>fvV)tFx#d!^!T{8e;Z$TzM#Gg*QGR=7{fAgJ}
z_~ngcEX?#3bI$joFZ=tiJ_-f@VKN<=uK2Cyt{6AWzdw6wr-KQZr3C$VrywUXi1d@#
z;=SLX34xADsbml3UJ18vJ1sgs_8Q43mRx)IVCFo^^|PGrXXV)X65ZpfVP})ycE9S}
zdX<!dg9HD}W)3+P|L6N{<uNS~NuT610N;Y|l1>zg#5$_@iV+nVVr)wNtNku8J2sa<
zrU{F<r{3wBSJLb;M^U?vK$cJ53qfB4)oY%9?W`!a`!8GOG7KPQE(YecI&v!o0HnhW
zUI6|l`Q`K-YROCx>cVrs#@=+yrt`?8aQS6Lgua%={n@+*X5saDVbcXco(q;~w1L41
zP^tP3&p<}vH7S)od^PC!@NXRf9{3WLJYRtckXQg|k&JD-TQFDXb(db{uuJxkk8EA@
zgYz!EzCdXi-|yuk2qX4i1#N)CCFr-eK&3#3ITErdPCJj*V<=BNk}q4x&n%2Y9{Zo~
ztn9H1%Dy?nomCQnMbpIN<`&IiA(fKGQWZvz=GZp7mt$4t8`x8RJ6yOM*VmLevGBuK
zrs+xAkyzU-g=u6sfp1im1HsqptmLSQ4ePZMhux^ANJX<RiyP6|Dx#x>?_;ak;rjb5
zoD`(Ra&1=Zww_DRFN`n)g??G{QsuS0MR+WS*Mer8=yq_O{q!3gC7=28-;*cRZ=2n9
z``g2)Q#=?uls8C&lFBjl9Xyh;8uV&$&vb<45~wozbeE2iyO=rf!h=;(R1bxVMn8TI
zq-mFq>cvpq*A4MKl)c+FRg@JG0VAGaSx6Qa>=&|<9I*0yWGUhC=f^trH;t;gw}%Jp
zlYkD}QYckgxQIX=&`f=mi|gHf5`lxjs+E6(9ZB(q3(_qZlkGYh=Jd1vsp6}zlFl6u
zxxtzG?ed7}7koBUV^aC|OALDP@vql%M(+&B%TspQ#OT4M!}n{`Up2yJiVG#pB{Zp0
zI_x!`wH;0?EecFES@?5VcuAP<_tqi(Jp8?xCzqOP_CA@stt1y1gEj%fXMUCOI^Rnt
z#oC(NTP=@7p^n^fsNovych;~k5lJgAuUhK<o9kI}f($!*RW&AiTPks4hXaED9sCO#
z6wZW8T_77bDcAbXm3E?13D{U2tMK7V5#p=+QviDE&oOzsplUceBrA=eN!Y?Dh*q5T
zZu;o?iy%<DSCl^8g#=n(!L$AF**8#_zHA3URQ*XS=rOF~9(aFLdXLBLy~wkzNvU45
z>m0vIoL?RXg9To5Dyanh>VC7*xgg*Y6sRTnLh$+Fz?VY*Wb#<nSozAB#5l^@HiB5Y
z@6~4i5<81t0DbKk){z35)gU9AZDW`d3Om_spG{pJv4;g$?HV;%F<sB44FvWNu~C0X
zDU;h)^c8*2q;*teFZg(sl&DVVIX?bMX%2#l7a<n<tys71qh~x^V;}Ey?1%Y1-M|Fw
zhuv%d)RAwzY8A{<4A`?kXzbjTa)GS&II!77(wFE-t7$CXx`1~OP9w-{=5AQchDGA!
zMIM0vmae7BLq=hlMm{~Bf&i8sW=KZKKJ66SM&3uBtds~H`=y+F_Eyp>gkM?C%}ncY
zcPi~KVuc)Kbp;Z*s&MJD;gk`b?eq!Qeyj$;Q9Q#cq41TL{2(obR6w|m{K~!<PHUX@
zW5*OsrO_=?nuu}F02-E{(t0RH<h#pl1NwiSm~n}yGf=vX6i!pFMmwSqx1DwE>93A|
zz5jH!ovl%oh}7_(2*=FqcH7Uie;tuOmwl;JGxc4_{9f%!pQV3qM81Ada#7EQ!^Qd(
zT8NShrn}G5L!C7!f^3qKQvs1XdpzemOH>_Ue90`V+wk;oSl{bb-<&HtG%<7n2<2&^
zs^-Mu7zTgvEbFup;<x$?%n?aP2mETsHG;o*wT$zLtiL6DgZ+?*(i_XQ$9*>Me5l}A
ztk#A?6;E%k4RAQmPWe-`30dfwyaA?->+2S+u=UfCJ{S!T5?rRUpqQnmQpZ==K;l71
zc@3;DuHJ{h2wF1R>&?k4CD6h31Y8aKV#;@Jgd^%Ab6eyPH`;6D-$4e&?53DJd;+@K
z!b^~2T?^yVAfU~=WOT#@vOW8jXm8#EBEQ~FJ2)ZTn6?0G=l(k<dJnX9MD8!e%d`2T
zr!GcO?MHp`E$49IG*vu%FsjY%_6Y+YEc7!0Cwh2gm8dhZ|5jI5IoP!fJ2tK3p#|oO
z;Oq#CH2}qzeDmyB%%jOMxk9=N2v#xWoK5pA(ngU>!XR!0$LfW@H{8j#e}@nf_c<gw
z*0s$W7mw^aQt)==&hn11oF;B)c8!?AR*v5pJXKoH20cH!7lBDiExi99Td>Sq2wvR)
zhF#-ERGx7o%eZ&xUu|%5>H+Wz2aDGi*@>KZdx*Uj|5!>0=Z+ft`w2{9C(QL<fGM^8
zSEt;lPk~+d8Nn=m#o23r&s4|r=`7WF8hb)7Fe)^*Gp`l#k|#*-xCQ>(J6?cuox}F~
zTXH~BnFj8GLqOQ_b;gT333x{pR6hd80Ue|PPiaN$=$ZZATR+0YeIK&F{8OT>nbbw+
z81~MM3XD3B5oL)150jpEhDR?IE<Ls&P#wSA7vFyfYsO~HTa=2#XSu}sS5I^_YM(eQ
zs#dOSeGQk)0~6M^<#^`Zxi&lXwl%&l)0SoXF#GX91dIFug?(YiStGJ(|7h56PK11?
z_8XU_7^3YFy^L5a-|z?83+0?w74Af(I?poo`A@+p*zsr4b0(sFP|FTdV(r)Op^&os
z<ziwEDI*~e77x^U>4_bVRs4w^=D9mUgCsl%HNHBtVbQqwo2=`UlS2MO;`e4XD`cdx
z?<B018T8swT2t#oudqDO<FYHAvbVG^o9$(K%}QzX&Yk1&?2`K;?ZoEwRC^I3vB7jW
z`n3xxDv-2d12*fRkEpv<-)5nvs|WX36g5OKh39?9JFZ!si%}={IZ=w-=2*i;M(FKI
z6IUsZ;kch=<f46y9(`!?oY#m9<Ihze+72XWw*6>8(0~*%pFPdImR7`7K4_PQOwEfi
zi_hocaC&>hw)<N9`re7rN9oe;<yV(*UP8#m^wVO_)IHLbBc7sogtsL%p!;ghO1^=R
z+BjJ^D>abB<6=ovNM5dgWp{Oi3Im*B-d3#af}H5zf5Jli)}bv!oOCo1Tr{hpH2qJ_
z_cyQMJ|yn0c)Md3`3N|IX^BP061yX-=7wXL*d3{yIw$`*)TQ1M69AyFg~@UlEclk%
zwitDEtUHcMCdxl>e~s+6Fh?zZIFsO-3qjF<7ikI0<MgCbnNE4m+-ok#o+Vi&(x}$>
zMM`2p)$Y^N+4kRiG)s%G(|%7{#GSdW{#{_yYW1e}%+QaR=*T}=inE`7Dn)7M5bLC`
z@dWz=A|=}x{o8wj0dZtSVfi5e56i?Hvih>Lnhcy$Ez*5&_F^I@PE$gwe9W}pP?~P8
zUhMQH9W>k2|8wCR8d^Ghe04`%MOjcl)9q=tg5-4Z9D%NX5qx))N|e43rmd!DKKeDF
z?Rwv!{BpR?0%WhSMJmBI-<$E8_Pr_Wm8vE9ws`&B>LZ}STt+n~Z@^&>MRH28{t3w5
zp}Ae4D`%~q%b+Zdj`iou-8*|ulI!#8|5n-+<couYQDb>vR7!m4K$)}Ynfu^K#*7J<
z2Z>i>U5CjuvVk0kHK;b3c>6J*%<hw;@67e0i8uI+>-(b}0&6!E&|lf1qb&dT%*ELn
z_wH_xivD8(f^6mjzzxLN@ucq83os|$wmT%D0#(9OlVvDRU-t0L)%G$40Wm<)TxVPw
zYs}tX=J&UbGLlw@PMxo=#6xag$@ol8No}3WtTgD22?$9Yh~3DDq2F&iui%D@Nn+^#
z^<{pGPFr3wYvf!^g|u93YEe3muc@(~UT5l@z%zn29RUof&Lgn`uaYgwP6GuLaX0o3
z2SzyYX!x)C&R!3YHD69AVEKujUKSgF)<$$y9atgc<FQA(I#9)7Vt-e1J#UV=q!Ic3
zZ8X;kjwqRs4OQ34Us={^+z62K9g#aL4|sXHYlV;_t|Q{U7>M+cqeb;?LlO$UdLoB~
zMQ_F56Iflra5Sq8IB>6#z(*uZBx<)4HaQBiTT-jnxw;(JA-(whF&o>JG}F>W`{^Mg
z^IK3(mdymwPQDHr?H~Fv1H%G;4)`uC5psjSL=^AIl!zBo4<%3AOUlGP3Y?r0f7=rM
zpoTF-@!N%-J}TRUG|EK(AkTnNqWc~D0{56xfuf^RF5XT-l~(0vZXDF#og_&N>?}1u
zPmw^#@0NhmhD*N>5}?qcC6TRZVF1u$XLm&9Y&G)^F@r9H^bt9n9t+&CYv^7W+Unnh
z53W(F<$PuO`<7e4G!ZOF!B;0LNUWMuBPH^uKa<`Gy`BCfDBq+jmkwIHSQl19x)q;k
z$e78BL@Y1wyqf00=@|P<qQPjr22n8KfE()ev+pNcr*;Taw07G82u6)g*<mHoScYJF
z7u|M7L|h6?GBr|P3V1%BZr2(movD~FYf2c`^EnVI8hQg0_I?e6;4iX=#li<0gb>Lq
z6@No}P!Y{cRsuK)Z4?axIt6TZgDuBO=C+R;0@xPos{6u$oHR6!V+TWuSsFP$Ex0&9
zO3T#t;=-nqph`x1Cjtqh4>R;Hq#rPyrkpj^<i)*1h>&CXIz`ZvGnU4S-F<<Fo;8}D
zm+HnRbHSzb`g&!=o0DL}&%nJK?*wleJnLrf@Yz4g@~biX+6npmn~GsZIbz~R4<n%{
z3{L>jzUH{%9_Pu$tYc4)zNm8ob)wD|f}pl(iAm?@`aZgbNStIq4kw6)B$lAVz+rRj
zsn48zur$5)slJEdPDl8#y&^<RxjV51+|KdEqQl1)sMW|$?K_QuZ3MsFh;IxRO3l|B
zGjD`$FeQwKSC3_sy6RZ-U-2>2F|&vN__5Y5fU^l);Q3=EWsd6_OnNwJYbcH0>WcPV
z>1|KgXoridGHhK=MHQDrTIoJRl}4dT1V$Dc$&r^8$MPwV`Oh6`3z36;W@*Eof)Jh;
z7ySv(#9DYWAKbCAmqJXqmNQSpJAm-~8Rz0B3kWI$x6LJK#POf2u%t`aR>rtOUH=tr
zH)(9E$CvwcOd$khJ?3}Iq(5B!u2-~UmriTvj4*T29NixUPb;!5v)z)q_l(n<IqpVX
zLajIU-=Rc!6*E=J%lkjBIFI4Q;PEQDULuUl_&wK_BC)J?tL(L;BXjH32J_e~f<mlm
zl`^Q+h^mlEy&O41F^Zw&7c^q-P83OCmZc2a%&$+Ra&3a<B7Ym(I1%(1w`DC}2!G?q
zz6bZNsaDq%_&m@TOsyC8+Yw%y4Z+V9jU9jLy$cmc;LX_1ZtU;ezUnMKhHo@{WUFF$
zE6*JYVAiKv1Mjx1Pv(=3T<HCODu6*LS0^T!?<Qv0T7A<I$X{af<4Wze!091xf>TO6
z3@5kRh%8Zk@!i*m6}|BDHavg*Uz73_eTy7CWQ@+1b>pTdg^rHK>F<{=IU<s2>}Cx2
zJMg-NS@fgPaP`4`FF124A6bLKOqCeX1-8iz0~LnsXI!I*C_0zUfoc|L7inS?$vfSp
z%>AgdJ4pK~dG|@d{=PeDPu?u4%*6Ib(md+L**RUCSOq3`4-Yok|5zSKbJ64e6)Ulf
zFo~N*$`Km9dDd4t^5zq$w8kpbZvTH_9Sxn0?Gv|@`ErPh;dif(@YH@4ct{}dkERPO
z%OE=9@X~?y0*Q+mGC`;OQ^Nr*?aH<r5^4d(?J}wMnZ59w!rmvuz#o0-Wi!Mo4|kPI
z8PXbwlwv^+J-AG{=6~hH5Nt-^$Pu<%V*`HqJ@Lyup^YM+Bd-BI4YWt7?JXwi+(?_O
zJo#Rg&!>^@rL5rQr~Zn4<@fF3_juCB%OGo<)WY_%dl1x9Wefb_K-$(&d2uw#fv5+`
zNaRQp&mWag-;!CbQ0p-g5t_s<R<C||OAH&F>%s)uH;vB;>>aua4EJ6-&5K+qaoB(O
z1|RUM>nef6UP#!~caSE+y}=zpvJ&Fimp%)zTlX{5xW}WS2mY(M9+(Bo!=Y6!$kH)6
z<D7ML1KKI60X2<%p=<`jJysKTGm2u&wNM^O?Zur)&(k8s>qCo!f*><q7h{i#n6%GS
z^D2{-TM|i%k^_k#s#y1Axi7G7rLG2en8>>T_#5ogN&oxcA4b8C*o5}Onl3AkZn7~c
z{9qbcpQLiPfbL8fSW-3ymUY|=nQocl>0c}Qo4fIs16m%HNc*?HSoXX4@px)G+8^8`
z7ZBeRg77oZyPw9+P(^vrv8pBT^}}fB)>_HOJoavjLWlz2+PbHi{q2WJ?<^nj2;zF1
z!ZZtPHKkZgR#rM;edo%M+2>|G9#l!!7gX^;DxNPCNm03#@BoWpSZXJ_z7?MOw5Rv*
z<<b0zZ$y*pQ8e?&x@~asw`Z_VsK{AUacUIMMu;Ib%y`mn7rR7%Ic)*f^FgY!43j);
zs%eCOJ#n`{CZXzLhPBuG_W`D)roT^)aSw01P4X1cu{Fe3TKgEl?5Bd{{{&>&XKvee
zZBxzWN~;bKzkx1Nc*f$CbKUN~(|<l&57yQln_w5FhFT5}lWOfl8I-wGDoz-4=GUq5
z<M)?(#;?^*CBld`i2w0xT)^u_Sn#<f6(9xr|4zWM+>CU>BBCw*mI+~MzL)<3E@t(L
z;sX2_KGA9flh@1vAn-jY##v?}gV7w+z!ZB<r%zdLgUX(-{u1M*w++)j2NFfA9^wH&
zz+q7JNhj<&z+i3P=zO4@-y)96Sup~v<kZgWq)STcFmquFdSoEO{y469E=n5^t)=ek
zV&40uD9+XxBO>rg0)q>cd3YuECJ1xD7Is^I$IiA7d^+wKw~)gpjR|sLaL;>i?(9Ax
z$b?C%yUI8}Qj7N?hU{F|7k;ltPAQ_cRA;L1?qXWEw!^fvCs{|954K7tw<P&gX?aO+
zt&6pY&NWRe`%FB>1#wB;1#v0a?#DV31k=6I357|XrIfX9a5}Gta{zY=VkFmAai^)S
zi!3s8X|79Wwndx`Ck)Ud5>x{pYVT6vSRf!a`yr#C_nV?irjtH25@6wK+9~s(EkI~M
zsohBYnzQ55b0tpTDfG0)KtRV?PBlX+kt1ffmd2vUR8|$wbXisQW0^38&OJg?Q2G7?
zb}a@2PW?>AfEP952w>c@)=w^AOCa2ZAId!i0JEn9-mX7+Z5-<x8wB~DBMqzlteoBf
z&<_Iuuus4DRq6(IFhCUbkErlt@uTTejp!j^@Wwz*a;m}=gR?^K7D=uR#apK|f+Ka#
zOn_aox5#f|;oO)i-mr-OQjlYBGqtf<9B}oy=_UgHtM-FyB+>J)>_ROdM>(HwC|65o
z*9-$8rKO`Zw=wgWyi=+J<rn%K2ps)(H6ZT&amF#GJ+T{=hRR5K8?mPqXKyL|;A$=l
zt9kH<L~2?@*5N*!NASe0+@ksuupQzT|IpZK9ZXMr?2=crk<>l=A4j{imS-mtf(0p8
z4xc~Jse2hfO#Ig@H}M%CU20K#qmBNB%Gem)Vgt_8a>-cfhnm-n%CCYfyMp=4qP5cn
zCxFJsV&==IYmjI801yBmHk!{dtRL5Xip^R-8Zte<r9KFl#*D=?c;nGd^<e(U!;WnP
zO<)JeP(l+ipE4EytkD<jpj=y6D0^{HDtm;Ubf+uxhRpa%U#^Nl2EPE`@Uf%8^I&J~
z2Ofjn{n?1;ukx7i_Rtl3aRKgzi(OvI&s|^r%wV#2DvZyhwZRMf=$3Sh-#*bMBv7SY
z{m*DuYTwTqPjZ-ocGb?10WB@=Dpk@o6Zy;e-*VJ3EqZ5z=e+y-|AYw=FG$Y;DJ}7N
zWSu7k5(VFHzK@VvMS6+s*;kJCkd<)XD`_guhiMNy_goQY@S)@B26Pc^`4D@a0Mr>U
znSm5mj_Q4Z-))CJk+<JkB`C1>uS;@enouB2;iactqfENN*DBNt2Im|mklo4OyZKIJ
zvV`x6W(>qNn_`+HtkFeH!DzU9l|x)fD_^I2qp|Xx`vSpQQW>R<MrdR86vNyTwXyl@
z6lBV~X?N-~4aN(at<o%8#KGf-tTrDws}$l@?6vi7L-$?FKKbXR)R@kTD(y0e7%50g
z_6^s!Ujd02&Ql?`vQ>X$2t}a`1Z;IOE#<SDio;uf;x^ZW{D`%+Y!?SP5_YvXz@~~@
zS?Ol9Gma|!X1PAwAO5^{$*3E61@Qyc_TYZt(V92K=zfq}d7zWf#NIv+Pj92AEZ265
zlbl*H#mK-C^k4A)qSFyiQa38qERkw#Y?+VV;@dl~s}hg!YUQv1Gk%p1Jnw&uY~da@
z34hYd@k<xXX?n%e!+zXaN@>$Ve10}ep6!onnMo|=8xZa5%#ijbi2ALwp~H5dex#WZ
zs@_i;IVUmguHY>$2aVj#BI$r-&qgx_3yQc~$t`mt@zwjZmTe<)_!O3s=m<yi_!t{<
zpMcOMx`}dC+P5Vnqh#(fv`1?Q98HNbXU+lEDQ05M*4ds)TE>6wGb~%t_Wi|aavnZs
ze;(6m#Fh$k4|D#U2%=mQj4z?jm+i7(&ZZi7(piVp3I(mV^H7YEmSHH2w3y$-{kNIr
zXFzCJ6phAHO!}K7AD?9DOFEGR-r&kr9wFD<<{ikH<RM~s)0r>jv3z=c(X^-IY;#<J
zRtP5ZcQLEo--W`IZ#dzE8{>w@LP45^T<xd7VI%WQN@F?C2Mk0J7Z9|}10^ngp(@O~
z<Fv+@jmZ5WEA&ajcbm?;J_CIO4fyg+*S^j_F}3{Zmtoz+e}N0!jk5Y4d){X?ngt3-
zk{!^ds}!&n-mG_mmU3|iFTVK@@wLaSG-<DMW7^;-v^c*CLg~Qbok$SNMwajpmA9C^
zPS&eyQgd{a1xL%Y+A~gKpy@KA@5*~{Ed*f(IT~SID^85!GqUG)hD|Eyam_%>)E_VM
z(235q5?%TJi#<5cwRb$Toi6Q28Ey!iyTsl|37^n?7Q$Cpxr#v0oPSWz)(pzn`>{I*
zddMY%jbI=DMrz=3HE*@pxdc;1R`Ahdh<|l*CV)-(pIHes4`<D$nTXVrI7a~KiAsV@
z=c4yExJaVvbqP{>EYJDRi93pSLnmII``zUZ{bNpYVeWu$(m;c@7_G@jMM)#FMsg6Z
z-RR!5^S`>OWZ?aM8iZN+ZnG4@AHq3Z+GA9;|Jr1J8V82GlA~<PvWqP!tDrLow>QgT
zFnCd*$!*3jrO(9s{RN}_V=D>gd&-RJ5o&Z7xF*D>EW8?~`GaGPtcaEDHYP8qu?m40
z-fIJZh^Q*r4kyw89bfOq*4JF^=68_Y{k~6c(Si&?3qJ72@zK)CV%i|!XQeCK9-_tJ
zh3pdDoP&q?V?@PqIsI`ti^;KysKC3${p{4bKk~0F=a?2?nNva}S}u%w&#C(n{eSnn
zl?fD+&d;Lp{Bb{hl@kT(H~AwN1BO10aKn<uPFI$J40)4$<&HMzkl%(doqo7jQy@^`
zDMrWw*Hp7Tiidm#gc1YbNV@m>&x_R9+f2hx5~xdxsPxOv+P_g8`uolpn)RYd4RF21
zC-)eYw03?Q(w)ICeJG|8kdj%B6j~NqOZq9Eo?hB3?}@}CzKIT>RqFXV)i5~<RK9Cs
zh^ZAYLJp>aD!BgGS)q`l`z2W*%H=AjI0*@7$PWaw*o%+2#lN%|YsCca#IP^X?8C7+
zZH^nD41Gtx&LtBH8wvG{qn9zFDO_G*me|m`Bee4*psa1wtcL=s{snznyLV6YZ?y7{
zBfk$zo+D<3jTzUM$<(yp&p^Z1p{<&96NAUO;pcYJj2ITXlK}dzQAg2l9>Pv`Hi<1p
z`@u(D3zH%AU0ZR(BXnirq+81ptAIXJBTpu&<qp9#zy(t0Oj8T!@doEw27?~6qX+is
z7Z35;!48u%`pVjsUZ#7y3c+1fS`3)Vbw5ET*IqL?sW^s_KhRJ~Nc^R>;OcCX_L%*J
z@UE1bH63kE3ihxT>C;bf*ry*2{_?Ml4*62yBB{BgwxQk;9GdSN^B1k)ml;h{{AJUH
zbZ2_61G3PMikUYm_(ijp|8kus>mEmb%R;-s)BaR32jB%K9j|W-IzJ`{){vCYdL{1?
zd1$oW(?NDgrz4y+vBr7|y3L(J0Sg`yU!76JddZK3)k_TBM8rn{vM1D#(K!1}vao84
zR5|&tei)hWU$939Y|ihF6Y^tUkR{;nuM^JWMsA(Q*GzMMgB6rImP+Tz_vrpx?O%0J
zxy!*64OzbNPv%URi-|*if!gM9GZ2DR3{Q1V@%p`O)5Gep8mpnNvMA@aHYmtBJh=1$
zuAnYX%OJoR_9%fDis{Bm`+9kn-r^$?3&%Y%Q&;x$dhNN<j#$VR>CZ0zu*&J>sXiuV
zQ&wv(=y0dP@M*2Q^1iSfMSe!%2BC$1>**y`0q-6RIP_kStQpEcWrqIm<c1g(j82}v
zTDzN=5&tvB;<%@`w=Z6N<uA_4(~!2KY7x9*BCPO2tCpK6xrX;US1a1YB1^wfc3Up^
z&KTU}0CJJX+Z#F+gxQiV)}SOIUzn~%XX!!6g^1xLDgUyw1@IL6yPrmH*c=<Eri_%!
z*px+BbLkt*9%_*%=b3YL65fw@4IBO<GIO0E44)joVXu$FQJJvRwQ}_x6<S6?UGkZr
z12IN3ElO8JKy@oY+FGG^XtswXIIw6*08uDNcUPTRCD*{xCUH^Sk(-SFfC%x&A+B~c
ziGo%1w02H6jY&y8Qq<38%J*VzR-OSkwCMO4sBR;oz{goj1uvr4VxjB|?}$+u(KM?n
z2ze|I`}?o0H%LL}Uq^Zi`=>lPoio{V`VNn|Bb9)2XZnx;<=X%8bk<Q#{r?}Q8C}wh
z(MWfvA5sCa0YOSq8UzLcqdTQL#X?eLNNkLj7zzp~vC&9v<bbjL_WkE~&dzqu{bzUQ
zo_qItzn{<N;|aM^$_jpE!o^^dlQ_Bk5fYnmq`wHYHbp^Lg?^ae9nz=YG^Vz5n^LRj
z%JHvPk*^B{tfL!C-NrXJ;5OqCQQuZ^>iCAFo_JTy${>NCTB#QOFLZ2vPa8%fO!+>#
zoDbnb-G`5bb)z4c7Qe?K=@zhwO;WWCfxK@M4eGg@jLZm_pXXWc=qT~{ip8*k7%a&$
zjkOCV-A|wLag*{<s_}fJURs-Y{^|p5mGadc4{plMLx0p(V*O0D|Dv@zMu-qzgv(lV
z3oO$V3m_u&Nm9|VIm6zoY5vw`lKhw8hhCO}kZh^U(@3ZYZi6;u#=rnd8+!N_+KiyQ
zXiXYkrnuiKzVHnMEHE_k=@IU;iM%M?itauUn!2k17K*NPVSrZ{;O=<+g=WtBAE%a4
zqvs@aqY{7gyd1539X#<g8f@%Uj_YEY7IYI{vmb$qoSd8cIWW?-5OHMjM^Ak7R<F6*
zNXi>^sckA0{)Q=(R6m#uta^W9x){1_`|Z=A)EsPb<$%0;jiNx!X1S}WZE<|)6`Q_?
z?O@QANnyl>a3ig7-Fg1Q0fCb1Du9wi_3^nZP29us*UAaC(^If?43=?`R8np|4}#LP
zuPqa}#|Fm_7oQ&_CbBEWAA6e9*;70#uf@)XHq!0UnrM(O`EekpD4|SxmGUvW0y%Mg
z%0*y@p4cnxO%K{@085LLGZ`InO-SmRM8;>)@HD2-i&^A|ZYS))x(ycT&g1x7#>XIG
zk()zKtD@gZFa|4W(cER~FRx*-c(cGI8izz^@36<5(#QK~X6QnR8XzBk!SljXblfR5
zqg4BfK{ht+EM{}i<cjV@Gy4TO{>SR2?#&#z4_+>`L)gY-*1%<3&_8<)?un;iZ{wC<
zeD1|Yn<c5Xa&XTGU!si+t8r!sjaU0Ut&&S>3YiZrAiR@hjY_Yo)cW~$xW)gJrA$Ju
zU*l5srbk)GPGzkn5#jGyE*xIO99)NYs!(X%6nz6Liph|qThZl}k68=e)YRYn*b^>x
zx`o!H(F<N^OOM#}&2z9}^Uf|hG*J6Ig_m61XIxC7@YKjI*Zua{WYFg2{LF(857(CB
zOn#LROP-bkPWLuRhne3an8N+$dxp{qWuwCe<pTh(jBmV()030_OGj=vnT=vjsAsvM
z`#%K3T5ECEXSQ&0|20m=>Pb@tyK8FfgLtwW;A-~I1|zTpHgSs76Y#OTOkDM@4*b7g
zWoJNj-pt*Jt7GBG+6|m39lv8|ExR3h_ar``Ii~cv_Ql0>W#XaoqX?}YOjJyY3`0Uw
zfA{8E<5CDXf=i)1`D$3Qe85!_3GDr@_&7eJw!qN(UM~w;hCMs&kG9aN*moM0d|q{8
zSPT`jukXuS%#)e6=tk`PD3n`7!D*}fE2&yDvzKKz@%iUFm1^+GF%-L|Q*IvO6rU!0
zp}mO&2wmyoJ(O$LZ%IR`UAe9x7p38S$8TZ)eNxLh(%e1_&ao3oQ8CAJoPp0NSQS&P
zc%Qby5?f3Ev|2qSbXq1Z`h`o%7Y>E1ut#)#u3*3Zh7S+Shr-A63EEFE7<XK?g0>-n
zmtHh&y(^>G{sjvF4Wb#Q)9LFS4Vln3IEP8H6!)1&Re4>t3tu*b+r$fA2(uxc{VbRs
z>jsSk7<CFeY5t+lV~1KWi$szJzAC0+k7Q5Rs7Fk=yzRVQv;y@WaU@Cv9Y8s`@T{X?
zUd~#nJ4hYkn6<f4YbEdJFPh#vF1k}GL$JJ=&DK^->ZdW_46s9Acr`03lT(r^K2(A@
z)i*bnR<*<mK?AldeVfYq(J}m$)*2ie2|b%C<stAi>@kwWrs*B58UZ%`PaH7E^+AXd
zzwlP<g_d!Rep@Q8cKWtMS{H3``Nie34AMpyJ-SO(@?kvsQziS;^2h$_%2fO(AmoVq
zL7L2mxh(@;fu3Ur@z_wuDe_-?)ns3ZhBV5@u7P9A=GK&$oV41FczO5DpIu$M1Nkci
zox5uqD*6gEo<I*4D&$yIvx;`DVg3-R{HjiFN^{6yBRc{9Gr%+YZzmwI;0NOPQnrpV
z6rs8O-S(a)|Cwz`X1VJIWaUmYrlR}jn9y4`bh%2wj1#oK04vZ9;6bHLrY1DAk60x%
ze!sB;v>PEkgmp4d<(t0;n3jm=6n<NMkjcOzbx(9rV?07Pufwy#RkHkfn(N&?#%(J`
ztR{iuBP&QVPTK-M^CpG*)7W_Q^_r;s_==cNM|pVKs(c=|&BohB%H6YGfFc((N7c;u
zdx!c6RfXhVAC3Hv@X~SRogS6RaUSb@WWSA^pOgB@K*bU~_R!#T*>?2ul3^p8neKrI
zYP`HKRqEgfC-^_YYA@uPL|6@w1~krDC^wl1$Gg?k70^P*Z0Qt?K8*d?o1>!$2!WAt
z%sMb&bR(3_jRZ6TA@I-lfX`0sv+!CQlL(Gmd;Sz6jlfVRKip|*ePA>#oC<d=K6^9h
zmSB4NkGhVB<|?Vr`g`Q+{!rA^GZ>{vSBf|TYT3l3KYhS3hK%PrWnDOa-M<0-_(o=)
z$zkczopUd;Uhs~wUQtPw(}#1V5Ut+XMda7IV?n|DDj^PRp&x{P>2^N&kY2#4K%ep5
zBE#A*`WugF@tFEp;O4&mzL`Vp$2%5$hT3;oWT&h)*m&;vHQD8g<PNQm-7>k!TCrI2
z=fWtf*0CIS-$AM`)U#MqY^4FGnXVSjB9zUHAN+l(1-5_uB<a?}n?ZVsVsY;{nm_J$
z>cGjq(lWbwkB&QQ2HqPlyjI={V1|E~`Oo$NIq)5Mq1`=BnkT=iWEnjY-6-PZPN=&c
zM;mf&#0bO}O^S1~sg}Y3mH#$4b-o%H>oEagY>(}xzgdf5Hu9LP!sm~ZglnfL;uT($
zeaf;OJ^k-%na`Eg%m>Gq_+J_-CG+^7fh6jxX9y8Og5ip#ewYM*+ur<C>HneWL*dPu
z`*+y<4oo?PCw_iXfj%FjyLW%|_TxLoznH=lzcf8&H@TZc%|E&6-m9Re(VP$P;-b0@
zyI)Z$?&oxH)B6K3IlVbOflnQ9#q*D;@`gz&Ve5KF?rl(+1jq5eAY*$Ob#zgj`hx|`
zU!&_s2{slH^_(Bxy3YOkuXOIa+%3~TQC~l$ddQn3HLs@f^;*wP)A~QSo|vuZn-H^n
zVD2Tpl9rB??w_J{_sDHKYuXY`n8cH~v8i<$(XW=Uy;>`bJClzKAAI<qcQlkDgDUC%
zeMDMQWlK#WBmKKxa<`CJXU~?_g!aGpbr&gx2@I?Q=lj3fIa9!#nm<@4#eG*<uTFg$
z-#sZAri^+ZhF8N$eAFyI`DQEg=o5Fs4@YS&3dhYRER;!gD-N4}YNnR4p-v+(teG<D
z5w>1iA|RaX$HRTdSZ%FNQ)iVYSH0;x7y%kB7>s7CpwRfp{CV+_($n};#|w#%VtWE4
zI&1Q+GNGp|$DT<k8*4$OP>Yw2UJM(<50!t@f%|lF{lQHLnK+?;f0iXbR?B(2EF`qn
zfk)lt9iveuc!2pEvLVkoao<qqooje0Y)R35N}<?FQc}Vho>fZnX9l`|p;W>BMjguK
zx=iS!v)M*YNO-cV$ZYg*c!&rvr<6c_jd*&^FxSAqga0kyc6`w)q4Bq0^xUbqeq)CG
z*fu-}!oRqA6QLedBD~tuE~_qJke0qt*HrPVuK9%z&LXTtMx-MNY$h<#!?o-@<+x6}
z@S8ngdLK+<#Rv)XxULM7k#z{aXiXbPrH%pE7&>ymSK4D`U_cp{+E~S2$K#;rpy5T_
z1U0OioE!UlQY&WFVCRfKf|w$x%LF}d0rrRm_DmsZY!!N#JEjd^PS7nbjk{{8^sZ^B
zN1NoV9_n>CFS+UzX;YA8rB+Xp^lIkJ;yO5PkLdycAW&`hGSTBT60T>RiTG-kS`+La
zm%*<Iv~d`&7LTVVmpoe`7?(xnGkw9$gT8ZFNd!q0@_T?uMURvF|8^?a2xIQqB0<r7
zLpX+liOgM&D)1cpZaqI5072o=dFgiZ)E@DUiN5cpx@Qhr3MRv~3Qo@|vZV>hr#7s;
z$LX^wOn2a_c1TC(c)7XOV-mNO)a8li4RJ|IWZSnC!{GyX2N(bk%P)e0Jb&#_6H6gj
zxI=mHvE=4r>m1;m8tknQn1(1UQRVKy;n*PRzCs#xaO7581o_#k*xcpt?j|23z(KKK
zyBLh#8j81GeDCienT-+l(L1Ab3<<ikcYtKkxkIY>evbF7crU<p^>8BV2)}nni-zG)
zZ<FE*88JWmIpul*&)@)!`1W+1qgfdZ3MZd^nm)`W7Pl7ZG|@jiOhlEQ&1GY#d7a|O
z0QMNY-9R+>WuPb_!0f80rE(lO@?3**ylF>UuqiA$I8@LJi(SkFF3zl0%*P6BEyz|>
z*}kf?D^4A5lwhJrM5eCjZ9!CnyCTI6)P5C)c&j<|^w!wM0J>BfYExGgHQzVZBm4r+
z$0U_;)x5u&wzf9AB}n67{HoSVlY+hg(!iWe3U9Ub+ZTz11$^JVsS&Q~@bzUL`g_+o
zXP1A!p6P*<8(P-O!@8JB0(9>CQ9(R6l)iy7{@jU++>57K0b$QCobbW3K+9upd?KaT
zmOaA1s(bTJcya!KyiMZ9MEPy*I_|OWE6_+3@%2{P#zkjh^iq{hKSKZyi-t+qsf7d5
zGx@=ZcQ$9RS#l}f8lh!8V=JVBp!6B?;KDgZ9Y<AZR73BV<y0qPk3IQTJ9voWG-W|{
z1@4=x2f}cP<!Ig=GkB>y+p?hl6i4*@|5gv|B&E>$)k|VvalE;OAa}bx;!2lZpsgr1
zD0)grB0(;A+g-$eI#5!fIBl(m;*)iBocNYlkDm#b;KEb}lkE^6TA;_>yc!r%%+9nd
zqi99gLK+0-4S6D^9d~A2F-57Z<+C;##W+(iML^Xt73m5fbSca@OFIRx8WeeL@S=+g
z%xZCOe%rDBrDG-a2kMh8{3GG=`UStwb3`v>imfbFA8^bwk6&g4HbTnfsf%vfS7#3Z
z$b?7IItQ|OI8ehvF)QQdA<cGy9-1C6qT20LC|G27m=j|(n2v1&?|+EhT3kX4_|EIZ
zX&jT{6t^Z;3<p<kI4kt&tyylJ)19Njcd?nNn`^aH6n`TcA>4Gx4(2-R5Sq%5mO(iY
z;OwitOOSy?C@6EM8<i8h4(J4ODYlVwXU+<&M>c<`zDDH?e<7ap-{1`>T>Q)lnap=q
zdDVrJ8c&esc)YdeVLC6k<o(Tv!U*!F&-SCaFSoeXsgQ7ZLhm}7g<n=Et8FGrnfCn<
zrda)W0AcH`XJ~)$wo#L5`Jv($bOb6Bd%WJ$nt&E?mN`DQhAm!=O)gRj%J#-6l+(U)
z6!h;e&#)D*(gA#$i_P&pd&s*~V8YZyT;(-b(>X#8dX|VTM8=1bnjuN2L{u9uSc9Zy
z%577rdvde5I@gzjk_a+6*~sUz?B?-WpX4PI{Ur>lFyxUv=PkFP)Vs&aWd2w?lmpKt
z8n}M|IMaT|u5*8ky7#Yie2qp1+Vj7?rs4!zZ*HE*31i2#)q-r?H64P>kt~YUWImBy
z&n$vX7i~f&O!()q53%~nPDds9lOkX>!Hb&$8}h1<3BYpXEcIYn;r4^L;g|2EAAQ`q
zV%zAkyoAriPk4DL(KT_D1DPmzYy-2Ayp24D<P1@QC7@J;6OF89A|l`$<>U|lUEOeg
zffV!XT`Gm)%IXUi&`0H&2JeLC6}5hT#7k;|BeQWZX1)rwzJCn%c8>_zH5Q-~m~$F@
zR(`V^w1zZLFfZ|E-*38%zDCACk(|Zx&pmr<<Sd9X1seDAu5a-(t-eD-gP<)rkFGT|
za0iSKc+U2OD$E*T$C`0J2sZc}{oLXGDdofCIKCH@JfBY>2W&92N$>q}r>*t)zbNN#
zmMmD-d^}!@)c6_$WxxvVB<YD0igP;q5)e06UStU5)OpmvGGdpvP7PZ{Ur^5bEv9Dk
zap(LD{0DewO0`WKv5M1J%2XU%Q<`zMI)BcnY#}JooFh*kQR-8=x8s^dmxaZlBsEYm
zr#J}duJha4EvLTvN7n^jjtU*fXae#o41hIcTMlZe2p3XclN-<i5-5Jkz^0i%L6Sd}
z(w^Myyp#0uJjPbmUVFP^@|Mi4dV=O^oFi7mCSdn<)$dwZWT*AN1>gcr;(Ju(DNxD;
zfm=BfFhrD$DREon;8lKRRq)ZdwB%$Fppu2|(2)(yw9)hK**lTaaJz`^Snc=39PS9V
zE}qBFA@aAbBt@)s5W3rDt}ZI>sq$6r)DQb5gPmUR6%$0sDStt1X?BAuhOcg3GtLwF
zmNg=)aw9Zh0KMTK@!H1Ns2jwf@r1n|GgRGEu8d?mH`&gvlp6yp#2kz71jL0muO~aM
zq$?OC!k#d|=gGwSAKqAKTC7JZiWWPtLOplpYeCmQ`3o#FtO07KVRmy6_o>cpF*PNY
zZ$26Pg#6B-8vZYQeCyIP##cPd&}rlQ3@#%!%<&(ssm~8*pL>{U<XF63M+fbi%JNbL
zVJo&Ayyc)eOD<~jC+X|1V%k~ge4-ZefIU3in@PAFrk|76U(JdB!BwY|;iC|bsi>nM
z`7Wj(Z+<MH?!-~Rs3Z`SYw}d4#{pz3do4o^eI^aWl3++kt$XTW7#}Wc%b8t&KQ07d
zJtmaRfCFt5d13~86W27Lp@ApySOrwtG*HZQ3kpct5p|Cu`R=n@m+64kx8Gk<9tQjV
z&Kamzg6m;p1YX?BXlDzs)6s<_LXCgF%WAr`^+VmSrzPl+bIf5~bhE~`m8e!A0evf}
zU+qf>I~;5dX8NI|J~J;I^xxYTPN)xg3`UmVak)Pr>-+C_xa0dwt|$KUpK&u?W@wQB
zSXV+X4Ka&jb2fP`{Sdjl8;1_Y;@7~WTO$Wv`ZflC|JJRoMQX4y{n-Ybq8Y`*Ojk&G
zFtriATQL;p3f?|N$W;FmZxW28hn)DSYKltEM~^JW_r(6cYHHkh2i_EIvSy7=^(zw1
zAGR66cq~t~d1kE81ELmQ2b)f8#j)gTeZZxv<NX4pb=ysCM-|@^aFY|21Cd9u7ZEqp
zg;X8oQ^D^L8?F~ULLP4u0}pZmplRCVun#Pkx72F%w#nm&xtBcxSqd{OSE+x}b+yqs
zEFG%=-3->DML}3~X0hXqwfegM7K&+j#~b&e#8$2)pC3dm*9w&U*P0Tarlt62A42_5
zP|2LS3_8Z<+cUH<-i8e(Dcc1s0PyrKgIsVFyBqCo2;c!0r4qY*k6mwsV6_DI{J3#(
zs44Lo;8M?RP2qF`TG7bH&~@4q0IXkoQAsQ&ZBa4XnEW%?ktj34S}RaD{HB3qSnqiD
zNyNp6?|sj*YF4?Yvn9VN*Np`V2S;oi@VCFo!<BZ47VEmI3{8-6X?i|_LN0vF5+mlI
z68cLN>Wu-r8Zn-v<Q3J6K9=KOYdzu~a1p%bjc6xMUq%i%4-79?%(n;54{r`&61K$L
zN@S#)<pAI8n;rR&LWGn-cyldqps((&E$5PkWz(%-?W6ey%gNKHl50#D6)MZ4n5gI&
z5~Y9E=LGP5@N^Az=lbo9T0OqGH8KVa+tY(eeY`1Ih0pY>^N2X64LseS_4K)B|J{wx
zKU9vqK0qz3x~S*@{tjko<14Z^?&IXq^3r7{wpDA%PEk&Y(aYqU7;4Z;G#7Iw5fH>o
zzvv$2p%>9nTU;JargTUMx*CZ%pnj%iXgB?{>B+j+?n<1@KgU2uS8Y^2P?_qL4F8vu
z_zK0TWH=$?8)IKcNVOwuJ`KUfdLLRnvdv?O_Sjx|DGZ;U5$Z7*SM8teE(P&&gD@;V
z4Nt0LqZ{b#;H*-2mAw%PtN5hcUVYnFf0Ofs*T?D8528yH`PRRFTTeOn91ihb<O=>F
zRhx+hv1oXp8!E^On;0*}n)UX)o$6;+4yfvFSx+nkW!&?aI`9j|RGL`wvnbMExqg2&
za2#&YN9hqq2^Wx1KY;fEs&3oV5E!{~1xA{E-N=MS$?mZ9Gpp2Wj~SM5v5l{R)8W$b
zkhm|NYbc|Ql;3M1qH7{++u+#JgIh#_?mH_l3+b6DxSO{K8)~&*P$Gv1F<qpGe)xss
z^5UHJ8SdRaZhKeE#X8;wxfCfiX*K9*P_-_eBob(|QpC`^p-S2i(_Dl#vn^A7ayD8R
z@gj|gj_h*`d$~A5=QWA9AJ?{>Y{1#oexP~=DQDKz2i(b)F#x6r%JVVHXyp{Pkav_)
z{9SnKWDxbYJ4PjZASRBBLOvFmOgTZ}(Z}e3s5cyy?083P7C<=A&uX4UmgD_sQ{ib%
z09D3#k;|Q3*vf^HAS))ZqDsSNB<M1Axra<*x}Ul3b8^tBf6md*Y+l}Pq0Ov6YD~(&
zJt*~a(V5Va7YCFqeMSVO&1Ww`*JnYv%am|~k$9MBhtuG%0)%(|Kj!OqmB$_lknZ-U
zn@1S2@UMRY$}@A~#rDfWaeElv2a+QW@Gq|fLU&m5fEja0<)A0F>;~jS)U-D>t2p?v
z!6G|2bOEbI1|*Qoa7t?(DnM#uIV6E2T=RNTLWM(}=e3wwDx#W*TL}^{CneQ%JwqOX
zjp9lS0<z;wX1BZa$tfKYh({9=sPi;}!aXAGpg+iM2MmZ71DQ>RS@xZ}M~N4)9E<{f
zXn|ABSwd6H{@~_vRH__x=&Fy?Xi*Aw28MSG5+|1Lt;Fibq*&+$-eUATs<urYK;?LU
zq%56;IU#?509L6vgB(v`{m;O0ay*e3vcdtgJdoqs)7ZI#Glrar>aHJGKO<)Hf)(@n
zzI=!3f+&z)KJ^FMz71<Y>{H&z+T3Z3#IXZl@^FG(=e>ihzQU)XD=7TOn}ab8T$4&u
z8pv$N8Sr(TUtSgBn|f)`VzB7^>&bZv)={TWGRngd2{l2yfw~L}y-L&-PQ!w8NG{&w
zE>0{#8Oo}Li?{=k)&5d;cf(f121w<nU@Gn}u=6LlZI!AHjqd`PT_ORvpaY$_!gs43
z9EbW5C?|l6NnYJhuwhrd^(6%b?UywV1Qma91lT8M<QDnypNDs2?4l~1-3c6v&hDML
zW^1i<r&zX@ebAJ{<G<Ivq=x|c@@h>aY0(le2cl)y+;-*b{mcm$_j#P@m5=CiFzdGw
z!XFg=MQ*sNBuNZ6OVj<i(b{3W_rQ(H$^nG6O3<e$HJZm_uPMWmHu-xLblFOjaOS8!
z!yKJH`@M7Uo_ZBZ*l*3q9{+e}?QchQzY}v9Es=X%MjY>U%qWv(kr{;B9(Cb-27u>H
zt|b%27vw@5y=*i>#>dhUK?wF#M*cWbt;`tCmCrO4#F<T*NoDhKgI8Zv$e56K+7c-*
za7AU1qO{iAf>pp6&59R_i}12#4n7g%01F>2?~nhqVH@LOVL`r);ySGbG+2y!jgZr|
z9l<NFC8Hffjy&oTlFaiBfK)H^x>`BQCc6LWUyx4o%HmPnvYWrxB{F*Syjn1IPVQF{
z!_iKat-@MQYjdX7)R<4%UTHK5DYKBpHa>j!HP4q4jzh`M!xCTjgU_oolMk)Ql-}KH
zmS%6$Ne%cXdb@toLBwa;rCO3HM9Hb=2_|K5wgytR_CEbtZ;(C>-P3*Hou)MY6xn~s
z#GbaY2W<zoip3Kfo1}h$BYeB(xn2jNqUimt@St=O;fLWcTsLhHW%P&J>M_;&f4V7B
zuJ51~zISiuvBlo5d^o_SyDTxxGw7<orogFOTJW&cWK~~flI~}Jg|Uk~iN$o9^j<L;
z1ARvonP$JW@_N`995ONXr9}VW7f1Git@0h{{!gvOQ&sgKw^y4;vVU^M(p?|0i?Yda
z)H}RY(7fu4rFc)|8zNTG{4Bt|?F;z7LA+1A&)WMe`qHmlkA(YV>iETT$l(SCs<^q0
z?Cf88nZP;m(vQu)7mlnKqE;XW<0vqMDR6EOoM%r(a!j(z<PS@=m2HeRdOV@x)%to*
z2O%Eh5af$zSs%&3&5vbpFzjenIVn73OAb;rN=wpe{W*sB;CmLw{W7fur6(<`+Hy@k
z5=>kZromRxTo+M!9N%7IK1CoTsl;&sv>97~GF^-j$LH5byW3?DwpB5-fDV<=o&MX$
z!Z~ELKlQslvy(HGUib%*e~c0~Do_uEyI<bR&sJ8S{cMC6e|(dCla=k=sO03$ezRuF
zl~vAlgrHDyZ_oo3QDqfTHAI9>X~iB17fUj2e}C$kD2IxU!sI1%ue`ezyWD&893d-#
z$w^<(+bY-nGE+T>F)H{jwXK}i61`vj=%(3g6th|+?_wMsrkY>D*sexef$dg&r<_E)
za?l&6s*ThOtnCvY+>dv4%HMJ!V;SRv0}L88oMJxt0>JPZWlqC_EjG-SZ>7T4{l`Pj
zzHgwTdDHT&PmIHPtgnb5Isx|a>6D#0|0R}J*FFvvF=d;d+y`xdHEywm9|!&g+bS!r
z#HP5NzgZxfv5ow=l}B2FO=g*`VpYu|>8W^Hn5A@`5|D}hpYc0@0F6hg(3|#y$xtUx
z>hJ8E$W=#6!zS%d5s$vV3Gog5S-R>{EI9>hR+$`73KFU}%65*3Vmfk{Qwn~5Q{j0k
zN5Kit-Tlp8TGVSKknFc<<!*Xq>FmhP59HwT(M2>SB`l?}cit1cFzf_G@thWR(Ay#J
z?UeFNPCexTtr#Z?uFyR-&--2|hI(5bOVO^DHU;=(ex|5g)(WK8TnHq)zimxM<zZ^-
z=4NVYLX3Nt4gN-1b7v(SPl(Y;{QS6x4=okl+i~D{)y_7u=kQNbg{@)efh)^NNo%SP
z|1H<uqqg8c>q1L!YB`nmE+xlO*Wy&(04du3fu;b3SGHD)ulu{|Giyi`^`rS4I%3K|
z{H;z{D(WxR34OvRVGF4eO)hn_{HoOD-iQ6`6V>42?z!5zHG?Br0Dp@@s5BB`-7nD6
z2f8IQ4`nO9X#I(wuA+=3i;X3_cmFd|esSq4k!zJK&JRJBLMb2lHx5qvkb?>U0+qKY
z;ZyW!Bn0l3n6P389{!o-897d_t_Vd#^I4$3Is}z61SH_tV;G+J)J3tQz7l)ds+5Os
z?z!yf(W2g(JH_U`Y9zNje$8I<{7g4O#Wa;{lu9>ci-hbIVw9rF^=@RpMN{IP3>k~m
zi@rlHt5p}vXdhCQX))?B;+oH_lOI$T!;!-;iQQh2_;Icf?q1zx;1KiO{K1((-Md&g
ztb(-pZ(9m3fyeGNSjoIU=5^q?GZYtuxe1K+d=uE`Sq{(Oe3;l_l{vRotiAeK3qh7;
z5?MYz=B)WkZ8Ev}F^c@zGGF+&RX?V+HN8L)EoNNKD)@o#D%0q*e)4mViH7$$u^b6)
z9rjh9w1i%Xe>#}l{D?%Fce}8qt%WYI`2i_W@M-q003C`fR;Z!Gi0|k4&1Cj-2$76w
zy|nz6D3nYnBejvQgU_;`?ndy)*R1jwY@R8ZvlF}THHNI}cGe{?y+i90^apX2Q@;^$
zj+TrpE7rN>9sV8}9UQ=tF{^_iC!;WA#j}&gI=eC4ueFaic?hqXaxUKgXZ{*cnz$kQ
zO~hQpgTJ5wNXKX)o~r$+N}A>|j^juD;RGl#?y-}zb+X1qiTEH1e@sR%@ILjAA{l@z
z_TGl0<VVxz{)i;*?K*6eha-QhWBqHgqgc|{Z0i{%nzAJd=fLryUZw2JEub-ZVgF^;
z!L+!RMi0EU51LzgZhdkmNPLY(V_X5!A7;Yu`$lC&fuW!7LjFg4M}FE&a@}36>%#DC
zetF=tN#AqC{fx|ChVTEnF!Lx#Jas2UM25G6+jQ_8^EWgse@SSy-zD*+LnmW9f5wCa
z2}a*y9)P4`l1c}zN>KNlO!vP=^gNCT_ck@gW$KJk-!LW1a3E8GyPR(_xL`i!)C5!V
zUlRbDB_iDtIw_T4RypgH&<ZvVB8R-D_p<tRW{<E3jf-SWv&>j^{9V-*4iNX4e(rjG
zNU$AKL{tg%-L#>CL0z)zD%X8idGj)Te<yKVH`R;hRY5JQnjV5w2*8lK(zEU0&Y{hz
z%&MpgJ<GA7=XD~5+_ZP<fNz^+SZ<8*ng`!n&JqK>uLEzJtg1hFqn|&NzS`3EHli*t
z0P#eUx2#wg+o7eQ!K@1`H%nAQh`1@KHsqH;HCcOJBP;RdMpPt<sO#j0Y&ndMQ7b$A
zH9%wBU{wjk?ft0{_Wy5f_YH~!&(@0(s_7oh6{;Ei%b}NOzBu8uC9$qEl*VUE^SOYP
zA&kYDJ);xD*UHep>jgjGaE>iqZ=6|ktb!{zj}CpEBu)*~9r>QsjBGlp@C#(p&=K6-
zqqRMMWx@#m6JHX;8$#50-zPuLn{z#{qL3(n9Lct(R^kmM+o*KD-q)!F$IiyZ%CD-p
zuyh&lvZbf3P|aHnOesgkCsP(?*znfpjow|bSZrP0{iqq*ol8!Z2W7bc*<)0^t>up^
zg^9fV#l+-dUc=fq2s%v&omr{eA7mL?CiH9BfM$v4!A>V2#Cq4kBQRFE{YLZ&5&M}q
zGCIMn7Zn}|RB)$^@^JaF#UkI~R+?Z)ur!`zR)-7{sG4$#LB~~sUlJ!@O1FUn>j;#r
zfBvWt30&vQbxKXNlw@t#yy)lQ%GH=e4-t*{sF;lx?BpL60e`I>55FCQu#OaZU9VDM
zSUC!XH_!#cz-47KFGvCrR6&Z%H#i79@Oa@X_%G<@NgR5~n)oe88Ah;h!&O;*h~w_j
zj-{*Zvj`)w;#gyHA;X!H-ku6!u~uE=#{nhV45%&1Rp{LVuAcwEp<e%kjIy()Z4M*2
zMO}^YP;=A`es+)nreOBoBXHJFtz8uBm(Rd09_Czrsm+;clMtWhw2R`^_WNIs14Qv1
z9iGKKo<?+fbl|ab6uhv(VDV}1$VJ16s^JnrVN=janL)jWV6Q8F?-k!ha<St4bLT`h
zj?_UDSB1pjJvQIRQnM~B?+wX_@w_d-PlOe9Q0v4j=SW%{H+pc9TCVodfobRAWuHZm
zY~}g{J`biXAUL@APqR;%WJlVytG2WSAMj+7WHutML_%K$NqA&O6$K&pGklW!aR{|b
zJ;D~jGK{S93*XL}=6@+K&E93{?K=Bj{a-&EQjCyX@Jx*1sb+N|mCcI|y6TdQ>1L_d
z$KX4t-6|k-TbF9`ffCa)Ka6C+%s)4B;y1<<N5J0x@uqTSblmrK1I4e0=P0Zd>n>_U
z93@rXDRt=I<bdwSWz8^b>9<=KCq_Eo4WK-)=wj6HQgD2QOlph~@j^%JSTbbNln)!3
z4Lgkl<$_jv6U>p2+f>;Td`7o($449h#B4F39ck-T<pjgOj8c7%w@WZQHUPv>SeY}G
zM@ulbCe-kFaHzpOTk1JSmRZ>_a1UF7k*`YF{E>cuh$P7d&5Ot5!?XB}Zr9(Z>7?<x
z8l-Y#<69-g#~EqR!oB|}uLl`dgw)en7HM~JkfLx=(`7sW|K#r^v%ep^FwQkFr%0gn
zqs)O@$3<)AS|o)^R#UH(ZYVsH5MXGtcKcN@EWCp7N+OuxlOCHOMc$e}F}Y-I_JTO_
z^~&r3w(+a~-DKf*Yilz{9HlML6Mt_Vv?4SUyv$0a#nR8lQGcGA4*-{K{L%uOF%GHY
zqa<kD$KMIjQDcXQ%dZZti0V`;2?OqX#bzIM?~>WuoVDna3wFgQ+Kv(bIr0)2k8o#(
zbA4&I7q#0Tyot&US9Ntt&EmeDgs-)VvbR1g7a2;#5lkLD!)4%vM*)qVDM#g~&<Uff
ziX;44Y{8fQM30{2g;irV#cM7!M?a~Zz9oX30$h>D3rmdg4P+)ea=k?pyQrL;5Ztf*
z2nln_rs!Di>LJgDO>eXS(IN@;<osT2o|qb%ZemKG?~8nWwf`6w9rI=xzAUsSpsDDN
zpZ!f4I!nZ=1jX2jI33u^NL@5Bwj0cGFS6}d#l2<~<zAe%1**{YxU+xr?0Hd~_mu28
z1a0|6b16>FEr5ChBLS%)D(xl!qJ2OPbXDJ{M<>d}wb#^6{03xsjxKmxB}W}~?uf2>
zd<u9ixP8&aJ>IsGrXe6(lrPAD%>!gGiqtu4XgbXO$SQcg5gh`i0^!sgvCDuSN?sN@
z#&ljCxJUr%P?bxhSxuYBHu=*F0Ip_pu*$D<p~hB6{S`Ih90H5a^WGEmA3XHq_-8Nz
zm;V*}>Sn8!yZVi{y61sn28V`n*RR_SIqs4R9x@(gKP<SfK%oB&MWOyXuNki-4p6bC
z-E(Uf71Abwkvz0`*okjhHf;2;fi3o0zmu4A?)t!Iomez$Nx43ih<)4b(x6h%qIggr
zHC`n_fsSs_V#q}Tk~&&;x-qwEW1E`^1K`4$*^e*<!!-9M_iAg2s1!!{5%}B7H?0oy
zCa6bL3RogG`_~ys&H=7k*GS;0n$t;pWO5nLP9CY(6D}0L=fgp13Ehn;WtWl)Y^vCw
z>u9p)bP6bmzj(=~Gg)O#!r&?$-ue!MW=Eir;-?p&!G7*Y$^7o$G5QXyD0YZINSh<`
z7a)y%K%TS&gyV;7s3EMG11UiL_NOK%?E)?CyP;AOJCuCiaq7dox3nua(Hg^looj+J
zfB$EB5jHf0<eK5dTq2uAck6M*K{GZuk}A<bqJr8YoPw@CSkX9EvQ?3DJ`08sBg!QQ
zjdo0BK(qm9gB!KH9W;(SIp1rbV?|9uFGgi9pF@%t$wW1l!kus|c1-E{$W#2>vAW1z
z-<Lp%W(G4vp!uH|*nq9%&>p+nA`d1!*Uw<EA7w#g8#ZM(e==-(gF!b8X9hQ232&mh
zLao`98Mwwu;5CmRy{2b0^pI4z$u;@!9mcGkK#^gm@u6UPpqTK$69`9g^Jb+yU~zd@
zb*r!IHbN&J*m84N89Iu%8Jp`UU?E_;Lgam-d~MgTv`G2jI+&6(gA+m7mVMW8LkX)J
zJ|2BHP$b0PG3jNWPQD@VMfK&WEMj&nr8A8mo<$^b(^Y_8U0Gv!<C(x7lXz<?N6`99
z=HZ7fHgDY#I&j!{Ay_OL&Q0iY%D}8-+}~QHeYg;5<kqp-^+&+xJMF6OOV+|S4%L9t
zKoAQ)%1Gx&!y(41M(tPZQ12K-W7c^aqrU?RF&G+*$*Nj92p!D&@#i4qZa}<KY|2?6
z7H_<!;Qb0j1(h-viaVnzRefFme0A-pAeMquk5rC>RV(WM(G^x8KYY_NJ`z1p5^k{;
z2^p{XTLc?^v+AOABU<Ff5$^U7bg<tfS=%8}^%xaRppRh8WRLe>jiyev?O&Pgv-yiE
z5)6hVvgpIUU}Ln{0Ct9i%e$&CDs{u-Xji{b7}V&}F)A!65ObX^I%|lnb!!jyS<b6r
zkItqc8o<KWrJ2=Z3K|k;_!93x2rp~SKpF9X0ye_U{+jG}Z&bEkBJDXz6_ODW(juqJ
z@49c?e&jGM?I1b0#j4WN8feI#igvV?rNIBa$&X=<3ezfyWOY<ZZU}|2Lnwd{BH#ek
z#}cD+E1xQ$cwaTh5&Bf1Ixs6f)P~Lpa8AL26D&jpERdN7OrZl^d;ygDD6W+~7}M($
z0cvD9#gkUqJtlELE*7RT;;gnu>umPjH#mDNfMJ378k>yVd1MMTgUSR?uMKn=6TE*L
z@AZFtXZTbMZ+6vHJtsI=mGc3zw(g|9m$rcc(;j@w_b4o&?3c7AK)7vL&HUNIVs0yo
zp3vU@FMtSVE%O=6H(0$g!A7xbtCv`wYQ%ed17v3*Z+himm)YofKLDy!Q)RQXlQ~|v
zM#8RAtIYn^yy(E=%X);zziL#mXrC+=slQ@DXl<{P>;%k8_p{O!;$Glqs>xx*m#I%a
z$K;GHSA$jX^X$76+!V}LkDlml_22#9X7;>b0DyVzq<uoQ;-uXP=yd$EANyBi<4KD2
z)K^8#aD=AtJaa~#L0RY&D~+~@`LF60NF3gS^6V68K%wWq*CUGYrD}<*5{7XuP~#Y{
z3<eDoNmdtcG>l<y^K6C9&!;*s*fhpzr}8dbsi)6h=k*$v@PV<F3G~?y=pY~e<StQX
zFaVd@MHN5>jJBA^WgPL#CGffK6Xeq)DC`TSI*aj*$1<rI+dK>!WJl%i*gu3J*rEm0
zsmXK9if-;lIX#-rkxRI?pjo*)U(&}CE&I=9=g2)sDbi2~>AA=Jg`#@^XEs3BlzMU`
zoY@#&{`tg0%^Nln$a7Xv>^AbYkem`YJLT(B6=$H2H>Pr2y`G`Xm{2sE{I@CO#n&S<
zIkt|Lw>>KWVu6icQ$7za&YBE{7XjLj%#y=4MXR*=+>?6m9k_xZ_Ft2y_p(^V{5{0h
zQCu%n?ruG14PZFeHhy;X*@EbgbXbTCy^t(6h*2dDTH9jLDHmGm<w-aTulAEWRD%A1
zW4E|JD%aq?E9W+BzJW%XWmI?(vzIoni+P^Bvl9OI%-FE$u+sq39|6N>N2Sru{U@Mr
z{|#WHmJPI4&s8Emt$)3vk=X5HoMs#f*4i8yfQyQt42c&=V0MY75THJT^LbzOCL=6`
zn>beF)XQ<Ft2<8c3!%@^U`s8Il;@w~?{o?4)(sO%K9-Z_H8>!!Ws3RT3Z&OSMH=4l
zfuFr;P)$iiORZLomZxug&x0)n+mMZlZenOZ_f|UEdbwAhDftc_gJ0}Kg(n}NcDSA6
zp?^CN`iJzg0__vF)o4L&Eq8=yyeavw%#ITXttCMvUtbU-bnMPZ<$KR^p>nNL`JuX-
zGG+$yD|6*^1U&JUS>!hLd3M*4ajkwY!*B8cFswv+a}7!jD{L8d`BIWA=cv7DjN7fs
z?e`=L>s=*80^5G#V?qY;qUe95R0Hg{1=z{6nY}o9|GC_PGVTtFXB?hK`BBE%kR3(S
ze)`V^xpMH2l^dZ8$zpDp_BG1nyAJUj<v+8g51<IR&JA_<Wu>j4^=x0>tS&Q41Obl+
znCfhxBMV-?okX<WSOlz33onAu0^02)rTVK9<<%JZOV}5K<*x!Pcu?@dR}Be+)cLjd
zh0hgE5t@{GHizou>esZjnQ`jJ%dH%{$PwF{!;nQ+ki(;)Gu6&?FGfwt56T6d**M7w
z%2wSa&c81j6`7}QJ!{XhiVah8JRO&nt=H;g)_sB~PW$shxvo?8oAAhZ7dAQEbG5ch
zWwVzvDm)y}En$entdeqoxp(eX1()Ij!g1^uvLXNJy#D@{igqwi$?jC<Pru~%-*;Yj
zDX8!BRk5ecfq!uKshY5MtZB8b4M;B#)OJT)28D!2^1)Bc!Z)Iwm5@qDUv`L_Z>j|C
zLueI5tINAyb7yayd;7hA?b_8@a#)0r;vC2a4w3ftw-~vNC?M)!F%BOjVQcMkX{@Eq
zRZ5SQV@y{vIM*&?KhlX}j?RT6OO_SSatGe5twPoOeWUR3E!JU9l{tlbvRYJxa_!Bz
z(lE#L+g;V{j%_D8hks^fkC@qYx^ju>X&Kl7HH$vqzLddlh`S7~Ztr7!EzRhHQHjIo
zP0S-I%8i3$j`d{V6!|D-3TgqU(5&GM0FCz-2&3j>IRoH5-^kBL6=6xZ?9nb>^_n)_
z*8k@Dk93P^1^)J!0T#oAHl<@Ji~vSO@2x*X;iZJPkr>I}G2P*$g$_r6>h4b-Wz1DF
z|JRq3LCZe3sgkb7&COo7;IjKEBZ5cCP$w|P{Tso$f|T46=-JCO9goQC5nAT*1~r78
zi?Sr}b{F?Ia{^O@@HHC46-CM#u$~yu?6FpfLRqRVGjc!4lp2o|*XAeaKW)Ik6!?o{
zGh#^yR+vF2$+qp*n8xyCH=KEgp()Q!oSyzh4Ie!5UafsqVeO}_ji%zx_po8I%gU{5
zQqRXc<vuX0mDsm(9uhyf^(!fi=3+#??d0BUC6i?De8i)w?>e-1Rmr)i9U#y5k1Ud;
zD;-B7NTl<iN4Hz6@`44sIdA#>c;Hh!S2ky|+4v<)OloA~eYaR}QA4{wB2lrhR$Vb<
z?dE^<Zf3rX+EFz$CtqE6sP~l;wCNYUrP+PSQw<rFq^ij%rK0^U8%WKBr~b<5#nESO
z-#*;AaYM>5%9(1^Yht-zv&j0z(%>{5PczFPQZykOC$)=vTs<%%oih_HFOZB55cob3
z*`@We#fCMgG*Sge8s1(}n>BnO@HO3hy1`(Ukksq-?k~HQMYR2|=syF6_Y~~KI$ZUh
zKA?;9nR&6rXb$xeD7@X(t~!+L8Sv%M_ETBi*;gMEG%}=bVX7$Ga;7psExm$_jF<IR
znc*E4EKWy->5!T3>aVJO>(G$z#BLaPl<h;#qxvN@+R3k4=>T&b(ZQ~r99<y5emrR@
z&<fEgzhxkgS(PBlvTun@-t?&P`dj*2G=CCrm16#Sn69Ye>F*p`0TZr0r9fcWd!#Yr
zFT0z<gAXIutk@+a2VIt>sho;-j~0rhaj5ZTdHvaRrSh{rl*ecZ_f=7v%Uwq+*Qhr1
z*y)%p2>^}zcK3(*o9NGUnx*vs-h54@WY;H-uPfqa+j_BnGvK)uXkI@#MGl8C>QnWj
z)Q8Gi4LkY4mdkf#5{g|K-&+Uz9L=S&tcah}V>wI7J+Ag4IzPSU?!7B_3OB7R$5hKT
zwEB(U{M3R$%UsWwe&i3{Wv%j|OqfxM5^r}d7PQ=4??YLyZw$6^_)4L`Y0%l<j=r7L
z1*NN3`M0IqR=b4me3I?FJ=Zkq^5W`b&xUjG!BJ|{#z$f0>H;$=N#GC9$juJDRac0D
zc@cGt2)PGzrX^*Ku}Y{HbR6o|C1v-{Eb-s>&iBweB|sR3*>_}a;s%`}5ybp<zl72b
z(a{bTVkZCcKDZMs?C?ZIAjx(%Su}m2z#GY{Y(;qYw?pM`#~b4d+{dMo=5Ed@7n!I+
zwC<b_Ht6x2R9}|A4#quF=vT2RQ$oZ+!K39gMARRCA$|t|o6Oz>KzH{SpL1Ns?^6Px
zX9}hO$wtdmGO%P(GcY(jF*(-G?(%uxCAHtD&vV+%<j^?D)@{I`z_5^Y{El{~>;kLE
z82a~pqc(3R(>QX`$DlZ4JW1JYj(QSEGvG<zT4842JeBxt(?S<@ck{FT3W)4FWJij}
zRyr~|xRkagFmm&L00qa7-X6=O&Cq3fl;9%1encVaY(jYQk6awAtOfU<u%kba{m51H
zW8~G8p-Quib4)-B_cY_|<dQ8WoFG{azbeB9{`Bac`6Vfol7HtBslYD&Q)klaj(E)}
zbuE1Zx7cGzfjso*Gh(x?z6V!h=$N7qbE-hF2X1OT?obkd1n_tK@)H36*Ed1m;{e;}
zV+D2%_fZ{;>(T}m11flB>sW;UrLZ;-b1LE=0t0Dz{g<zaiDC&Y{<jB*j>B&4t!$vP
z+kBq1<cxB?vfsOGK5CPOI@!d~fV0PT@*JY>Gz<PagbUgHv@2-et5^7{L}IdCJyD^Y
z@(-pr0$;|y=u~OZWjdW&=g@u9UAxu<H;eigwWx0w9w`4eOZ!|&feuN38a}p>()Z(V
zMPIW@=BYdVbeziU{2TCpVFo6Jw@^wuyZmL*5%nTBa)P^HRBYiOzVoNQ7Vr-9Y6l+&
z{ELWyV??p6$*)P`YrGS+(m!g!oT9lR7ueeX1!XUGiz1Dv5vHB!qv!8SU#G6(_KX6^
zqqPncAtMVM>YnW%g%`~%xxjsrF)>?sCyj^j9#NepCg0}|3fY83t=|X|>4MAnMC84!
zydkN><}=n$@*Ydw=f2)n$_Y98kEUkax&_P4$hPxLndCcf0S$EAAI1Q#|9Bl*Iw}#l
zz0NF2M+8p6)hxG~fgGTM>-XH^cDGr$ZR(Kpht4UtZL`gryFn*H(UZm}|3%1lMoB`Q
zJy7@8s#=?lp{AsZpL9q}NmS_Npx)!w`|)w8xV&F-UT5ftRiVncBRdj>T(AfAv0;$g
zxc5{!WT*1RKTW_i?WPUk1X1QMYQ~m#B_>pARZnB?DvXRpj{akrOfL0+lmop83XJac
z@4X)UAUrKfk^`+CZRx5FVZQSYY&C}Wi8y<esbE0H#3d%4uovL}65f2fei@O$w0=h6
zf*eJ;Mcw^DFxRu5Ot?{v|DxrQ70R(0D-`~}AMn{cX9)X{R&9CS68$8`T)C3(LEoSL
z-BL%^#r`ED6rFtO?Z4Wsk(-YvfU|a*FzSLE{aDIJtk!rlhngI?&xdZNi^unxd55-0
zGr5Bt^DU{C75&dx&eUd+r~~AY8NMfhaNF}Haq^~+=r@Q4v&ttdYX)^m0!s2B>RvV7
zYm_D>ng@lr%%Y85MQ=Y;8+IRNf%C2SUMJ0)ylc)Fekooy{`OE1rmk92%?jcjzV#+T
z(Cw-NBT3UX*<<r8-pTb!$G&6yg06QV;b6Ne)l5udltRJh%i;NPZw}jM<q6Gau1O#P
z9bt|kB-xBy<NP!0*SB=1>g^Mf=_6Hpgu87TsgY|#M~yYe?lHQ@Kk1f4{kLIaw5ykc
zZ<m!&74J{L|KZ%OD`nZAmIBHMzbXgctcIhNkHPLlglzzv1Y}&csjcM&+^I1F$dUgx
zSR6{8g{;uIyaPvhPR00o4O@?m!0=`!`p=Eu(H#ZOiop{98O3>#F^OS5(75Ce<nkR&
zl~QaAEo!g#4DxD4ir&H=L8e*H#CfwMlb2&(g0sV7-d!Nc<zpYW_>l^$>W9rgk-Z`#
zgm){YH&68#Lc9h&IMX(%vi-aP>%Bg&snRc1#B?a0Rb&w!_0Awb?%^fuS}#3*n=FIP
zH{hWQe@dHH=9<C#(|_tQ8otErDo%g^tzu#Swnz9sYuryq0G@WgnxgL+5=Ppa*NSS*
zW?kE~<ybfI-kyE@6E5CzBk>u?$6y@IMDZksbt{Pty_FPVOv<T?9)*>$jq#s4RQ!ld
z_=WeBrwmw_(za4Ac+(?{%<9NAI}Gu^`0(GAF0AC!qTBk>1U?+$LE9imMu%4kt)5fY
zB^QssSYd0w84EXxh_aR}&s={)awdKr83%whRld7I2|PlH_#5y<j8Toa8K#g!8ap~s
zv51M|c%2rGh{|;X`zE^jyw3j=ey{Xu^XC^5xX~U-nEwwhZHB0}U#>Cu;i1WkWE-DE
z%Uc|7^zG)ny#vTVsi2V*p0yFDrLTE387#=F*y>WeGo3zwSYqvD%zCaIT6pzhEy7@L
z?Mg%8{>WC*xm^(TuR8qVl^7W-Fk+WN?_~+AzU26;RA%w5iQV?2`_Sid++88?^5qld
zz-(YVE1NEj5t=f?iq-I%{OXqzqrvH9_Gn<vYT!@6tr^d^b}-IFQQSM+*xH(q|8e(W
zqQrN4vjM8c*Z~QvIa>e&s*0TX_SyleBj`{^u~7r;`kA{zitNW*P9&}z$^{v@Y}DJ)
z<HAPEDT;?Ud1GU2pT58$HTplk)qwwgmcBKqt8h=TQ#~vKdSEH2!07`7s_2p%isEVB
z7%YlAe>5=uGPq+w_ETQc0jgLHuufD0t}4DI68PD$f}&_WWw$9I`I9O~4as#>0^HX<
zFa?urP5Fdn9W5Da7B7*~%_aysdf4{$LK?@eB@R2#{&5r>Ow-^rXtH?ut?aEwb#Zph
z7*+0=F_9EC%@v|cUV<0a4@aV<-Ie$#a&9)^OP*tSQYTD<gFvacyQtWp+}DfoS<MDY
z&YIfY^I6+WOVxHYi++{EzWuik-X`;{uk!{5O$z4=kY<SAu?OX+KN6kRSnz#UuL_)-
z+2A=CB25*&aY|I%lR6r{RBMO%?Nmk4lpqjYfXMtRK{DA9#hFE7SXv4Wmx&?CLnAt0
ze#o?erEewk`am5GXo$>QadWB;%!dncVXcPEDYR@n&olbd-_i#Bwq?28{WGi>RZY1u
z<AeLJ!3{p~jY2I&fqaF2C%`c@k!k4XpPH|ZI{tilraaXK{}iPc^n!z04Fjh{MAHjf
zPqKa5P%1a2bR{z@%>MKBcZ~fqu6C0&y5SVxnigY{Q9Ks)xA{=;hHsQVulwb>7>iBw
zxW5p#(sBI77Cz~@<xw=qtSAe;ZO#7!&p<H0d;bBS=Eg(@;D_9-N*EZ}j9wyaA@a?Z
z9dcp@(ie{BJWg=NZ^~DZ<iw$e@EplR@qr(@D#h|}GZ#kN{xc)vsKBLk2c<^c@Cdx4
zIn9rd7<{!3J~x|ahqV;fG-40qVlke((~h8A(d5ROnUjPwKJtVHo_}0UutLyvP$W^)
zDd_?@jV7^Fm3JwO)PX07!?ueRKx6SQD+C2`IMQaYN2@WcD~P;B@i~1v$7s1LlN*_n
zjON+H0hBSD<VZXrdNZ!Ls3g$$8MY!||4EvvVEYp5WeRcpH$K#YeQ+1APki_ILy7s&
zFB1<tpCVkGcIldG8scMy-;sXdjdJ0=NtS*}##a~3W1UZlcy32O5@{KXQ(fwlH!^HM
ztT84Bghv3fD2IHwt_0qa=7uJk1qoP|dAUeHe>uC$%w61IN9LnOOvG_HMhM9Z=l?f{
z9dEh5C7Oz4!WfU`@WfmT;{4gEv&+Vy3>a5837j{YJhVfHa^5G+?95}E5%TfOWZ@fj
z@Qs6mXhYBQzr|yxPMl9Ijxw11nxO&L<(09De&L=@TfGDwb93Y;#bcyoNm;n7-I6Mh
zzRwvcWy!CDh6G)F;k}+VMc#j-8?y^|IHV%)FqJNlP2-@8xt=jxvR_lrS)hl{{Bxg*
z#hEhi2kXe8VkhOXMpGK*#wcvuK$-A_<J@gB|612Ix%^KPDU5D2VvbV+e;+fg*kbPN
z&2V1N(YIzRuEG;#>O{MJ;$aZw$LCY;@W**fpHJA-zcr&VQ*m1k9j0cb<GkE($MZ_@
z1&-b8j^e4)r%t%5-=D_tmk0#ssJhQ9P_#t;5WGk={BPO-O0GX#`e$({mmjWv3m`Hs
z05|0bH5g%@Kl8jX5ub!PSA(gT+HJ#h%A~=#tlr$;FA-?@pC1UF#?w4U#B$JQ+V(o+
z<)F{Fj7NypBm1W<E0$$3<i<`AkC}pBF0Swzt`(nbAR4QR^S>u(0F+mw@z>fO5cdg1
zZa*D=n*plfS?e;m7H^EX_$uPK0Tc_K48m5!c8osjU{$Qa034V?z&Y)wKwa860iKuu
z&cnz62o2x>5CBZsni^C(5V=Bl03gaiP+4U)j69=GJO6<mWNc56=u!u70;Vlc0zF@t
z4Uyh1fV^2>clrGMJ;&rHaQ4XBi<ftQ6k;GE^E%<4ez(x55?oeQ5s?v0lE*)Mz7yi9
z)2B~A_fBMyJWX<AXMvR_Y7AuL!~)I7y#ItZ0cAM%ox6g~$Gr1!4YG0XI3JV94Q_Wl
z_@50cGwj6D!AbXpFb6PV0!==m?yrJSJ_Lg+bF6iRG=RkEi5Q=@{{u>wTcicy>>I%c
zp=1czu*UuR0!QRNp;;5*Z9n~l&-4O-q^vL#o^JzqJty!#1Ttfw0gwO-H^QI*%HRO^
z&k5iG1ON}yoWLl@4d~gUU;GUhnouboSB*=4>EhRbzQF!@KX4j~aA-ivN&+{3on!mz
zDuNtOCxCaT^XBgx8a!_#d|VzlfSZ+nL!tbSk@@-gvibt|!LLt=6{j*DI+!;m1_f>l
z&psn=0bkdKCP#<PE((Hp03ZPa=WgI-%a&ZK*~ihq1O4m)0#B3Yi@o3h_GW-W_;k^6
z{aKmgu>r6{U;Pju03bE)2Y|?ofGqE31dAU4p0FeUsxx$69Or1v^W;DRKx2;mv`r1$
zL=7THlK7^CM!Cy0v!P&c0O$e6)WBZE>nZ}t;RHSg7=QsmQ7{W09RZnWX>n1V41iUG
z1hLfHT|mYCm<9`9IYPV;7+Bhy@KT7REQx^+6Gb=jb=;wV%orItcIEzAe|)@>g!|r_
z=7*%mGI3byVx=*A9Pjw8>%lci_}2pt$&3gXm`j_6nQy`wgBU8r#dZTj_q;KNB*xD6
z6#nb~xJMKt#CVUyM)7_$Cqr#}{(s>apC>&(W$;bq<_s|`|Kj*@Ji?>3cv<n9tRMGk
zNX0~AIIBbmV=eZI5C_M_;^!LwjHVnKkUT9so(c2?<}OJ>0Lw}FHtH}Z|No8fLypW?
z7pj`z=@M?wx}xz{hA;T}yWmjb@Rf<qvo4iBs+lfK$%&8Rd?CcfY{D6u{jJbkO%!BA
zbSylR$xp`eX{5&%Ckc1VPv*vjlMh_jBy@k|xF8RSgt)aI0pB$5x5aA%%}cZFz(N9S
zMbF5W_sfoM6X1_umBt1PX3P|t??{szBh8NoE0SU{yhny*X+QPCP!fBPRrjRF9uOKh
zmH?~8UlHMpBK&mn7(xset>0hr#Lq*pKOwX7VTTv-J_BFJrhYad1VrL75xm*^>zfEz
zET%X)9^+Ke6PUoM#%RdC0gAbucbKpTu9-J6k(#&ggy8_&2@A~YZb&g#Gp}xZC&mN@
zj!Xguhe+}Q8Q<if6ybolOA+ECc#BPKHNFypKM(M5YlP<sSSbh0@<#zzk}@+X86;Bz
z7sh@55aND!rvxn!QKo36z<^FJjvbfbED|(3)^ne0@je-eLvDxS3a5!dcSKm+L{4l+
zh>YdNKmsuJ#dvm1235Sns7CZP(}m(>Hk+sao)9W=Jgd#m)Canrx7JQ72s}I3ZjeKX
ziX^>1%UHP?;4{X!Li$mF(0`wtM>m(2O|zebv<5vpRA4~Z4OjqG&7dd{y#bz{Cl17z
zePbeap~p}76?l!@ARZbtVzqe&XWhml|C-9T$MJvwpN1mRb&f4k`FxDgSp1k0?gRW^
z{2{j&%gV%f&#P?mn4TvUh?|#=f!6r%0XO*f&}d};ge(CsX3fR#Ik%~g37Ps2s0zH$
zi@F1eZ3@O!9`Tl7egjq5=;y07<9NL$hLQbJqT$b%!_XdUkB@)^{x^-_QL*rO;&+IP
z;yjxu5OgSY&ET8Iym;>q*h*wE=6o}`SmdFxd*$HU^^=T)88gTRud&6{Q~RGa&gH{b
zV1(1dWDdAx@Pv#Fj#;I<!7_F@?C#y?kcQW&#x-^?6M$9j)Gz;!tjT0&@qv<-96{61
zmbLkj9(X~M4dQ%Vr||j|<{Aj`UNmlY4{w_~Ae(|+bK|@^K?p+_8jZ_Xm%$6nZ#cgA
zuLj^m!23#XjQGgzNG{A~*2Im-G*sfXt6RVq>sIxI5Ge(e(YHQ)yMYO`IP1faIEWW)
z5Skf?f4;kD$0rxqW33pOuj6<VILS;)g+imn$PIf=1NrBy5by<lom*{lz=Yg5>wYgU
zT!ccVmz{d&o2jYeGbw>6+_K-;%!SRo;9B~b2e<bB{xA5*0B9|7bPw@yQqQVH^<=f+
zJ?F1&+Tx)z3RA`gP1nW3E(vWe<-qu62q78i>AvR#0ZKuy7jc<hxkLoC8Qvdq!8gZ5
z|1QXImwqFh6mUQo=s<`6x^}1a!af{Q^2B%m5F}_a$tuRB{_vHBBxcU3<>USb%cj;_
zn274$yYM34{=fJ`;h#ZS+?0%OuBNe7aTz#E!Z&O1+7SPfcJC9U*|Cu3Busuc{Luy6
ze`EmmtDmk{mmoh*^CP;LUB8xW;a6j_pO5$txt8ACz=XO265sd({<+~i`0pVgsmJ55
z+Fi`3ryW}2A4Y?9E>9g8tCP1UL<UnPUlFxkI^%zgqn@t>S}#joD>%o8RLSIswST<$
zelL64W~L+DHFL%Q8-3&Dmt4}|>6i0x%Psl4GUMgprdifb=ov43UybJ)$i;>!fxE|e
zBk{c`LfbHb=nvXnAbvB{u>ckSzM12AuMn>b%zqaYTfEFP2zeIR8!|wZ$r&v^Czr_w
z#dLthIb;%JE&O-)U3_U1(sRIZa&G&6JaQjtj~_({4zd+SS*t&*!6QZpzl)GwanQps
zfax(K7M+Iid=fo9C5($<sfrG7`0oVIKai1t2N~gMP|zf8po{;xi$#<)34RMWj$3NT
znS$OcB5~kQiB-b;KjQV6wtvD$3*FEhyt8+Jv#r?t*!+0>-cBMpl3Y{G7+O_qyhjMD
zHQ@_Sr)P_d7El)+A~e78a>ynccKl(iFBi~2I_g_o&@t(67t!UKM-AneLGgTTt4U)`
z0RK|hn7-;R2DE+1S#KBdj|78Lo;AY!TqSAQQ4`iOA7}CXpzQT>6X-I16Zna+I}0r#
zxQIcnI2AkX9Ek2CSUNlhS<cYMe6NVON5yPON0-d}yhaYp*8+m#y&4xiebF#IM{;8r
z;a*NEphn{Ost}QQh-);Pu^eA$A-U@GFK6y~QieFb)9F8pvK{c*6xFHMCr0cF99J+w
z0LFc-uc64r{ImaD-U&ZFFE15NYKf{7k|{*v^@*38lM*j|riAfv-!1h9Aw3!m@s3Pi
zC9Ci#a^o{xo$+Sh^~G`OYLpCg^s}$q_)BQA^7;p;N1H7-&1tC)i{tGzwV4D8`)vML
zt)Ejz7vCUL=7Lkpxe=S5mUld~tYhL~sop<}gnpb>{0D#QneJRJJv)R~S-fS%_ayS#
zGx1$Y5C#!<>%WAtg3q?cKxuJYwpBa;pT$6G>=2s_Ln42!TrPNywV`ozUvMcPrzgcZ
ztHjf!*||&(=`+;}^GGvnuL6Wd2OcZ9>md78V!i%aE4|&v=o96xp{^&7jGV3~i=R$N
zjNoH2J$UTVu`qSXhhXHQ!n}~y>>&;An2F^7mx$i0&cpI9Sinj!2)OuS$lSpfnb(_w
zEi<LaMV&{4A;#{!JGu7c9+K08{v!<$cW(I&1gjUU58uWGc$n_si_a`l*T7nF9WoCC
zf0H!DE7B@A=J{fyvDYtYpc-%?8qbee`~UxPZlcI+zV*)*b9qyZ<XahK6bey5D<B0D
zyxLiB;%eDki6MzB;wpK^3AhCIm`iSEyhX5LB(`ggD6n?XNdQ+nQAo3pRGh%TD6lPM
za!bTBM!qQuAz;9$1c9(j0UW}Bk`?76w9HBfFL2dp+6KhVYay$7x>&mlOu7q5v2RMB
zO+Y+Sxz_u2AOas%w$o&-lp&;!#0_m#_WCsR6)yIjy8{p<dpCvCY09db(?Ir8pv$Hw
zLj9D`Q={yACpI<JM+(gamHQMLPAxbwR|Att978b?nSJyQZ!b7<TM~*W6rzC#AP^x6
zVqvnHC*y32gn?*<%V0RjCU>kN&J9!48e9Yy;3$d|H{<_f%<g2;?tdGgsJBdcCJg?2
zZt5GmEqp3>A(~ECCFWb{iLgQOx!Vo7zCHz>{p+^|0q}~$JPfBaN}>OI-#9VD!;n2c
zrlHe!2Gre+)h3UkQAm?$(@y_g32{R%O`5~CF?dTmM3eyN?2%{KwkSzJX=-!@BJ&t2
z(9yUd8q5R(zyIHIXpV=x>iOZ`W#`lLj=54$002$W4q#BNI@hm_ir!odoK4i6T?Fb?
zbhXb_2he1M2@c-hhq5401VSJnfDix>2!H`V002M$6aYEOks^|qDH1S7KD=o4k2pHU
zT_XZNtC9VWw!_=benX0^LXv<02lyxu$HDmc$`+)n2q`uYEJO-`EC2ui0000000000
z1VDva)VX@rS7<8M3WY+du$%w@Hta!~U|J9Gh8j9^Mg>Wlf?o@9fFB7QEq)%142Et8
zS&@7>U)P&3w~Ll-=c6^{A1{Z{`hEx(aKd?aUre04+7-fcZ#koCOqfGrKmY&#|Np3;
z<G8;a6Q?nC9{gO^ega0j>@qjon_ZD0e>R+RFE@7m?`XW5C>zpejE)Vi4)K4VxcNl|
zTm-^f68N8b`~Uvqp-XT;G2AClJQ~S>qY_P8WB7>~?(vI_g^>NbEe}P-<>0;ZugCW}
zq>^SUi;T6nrKiM2`KgS>;XnWUI-<nIcO7V5elHo9<_NFcCh%XE!>CbL8RtO(#D3OU
z^mBgp?xg=H!8h|}I5G&B1>-VX?56jU5201&PWbB_INnKVuY^3fIAu$3D-*<Fu1Lqf
z?sHFYRmnoL-o7qmn>>7E)J&IuTztf|vKm$}M}F2nEpWooD`)U0!d`Xbp@58l-np}k
zM?qKfY!GS^#pLfcz)6(%iR>8YQaY`OBQYk+{}a#aX1%4v$tx)gUNtm$j2Yr);_;@e
z-Aa0gbQ#H6aqz|?JWoou8=iPflf-tDO8+m7+)*+7a_@RcB91$I;$__tPm1E{B+HnH
z^F|{-6KWKJY)d+X&IC<$w*&KIK@DTq3)LnfNlgJOUH{(}gdKhvT94vx{RY7(MELF_
z8wUg3vEh;1;SEVF+T7-{#<^{kxIf_@lrq1=!-##T2QCB$@saBfg~kLUzs_6aPY(0u
zE%<p!E!cO>%R!ch&BeRs>U8{9IK(CQ(J{p~Rwg{Oqp{HB{C*=SKw8m1;SN{K^TI)_
zcTIBNb;r<aDej2rBbPsyb8JT>sF7=r$(Yfdz9}^ny8HN^taAIBK^IM%Hf{-hU`y{B
zO-n4kSBuph?Ku16+9(PTml2nB($oygMjE3(7ftJ$iVb<O;0qcZbK<z^D1-11WTDz~
z%-x*wCyMagS^>h}bERnGxMO|BrxgMR!7fRdcE&_UmiMj^*d&N@!2?v8_{o=!<HJ8p
zhw>alrS*g2(7{?9e}8GK;(6gR6T&=j@%bU@@qv@RB4ZXj;Q(lyUnIsy%p}CVC#D!(
zt=fLcvIp@#C-<gn{I`diEWFa16+GNuX;FlZ5xBD^ctZ}uDoMas8qtc(u(MCgV@!G{
z6UhOOs-edA?yfx%9=YD+5GeCX#BiSVGDE^cA1^#UA{h0%6poH#plK2S8)2N_Jqhy9
zEO!f%Lzu*8i;@S07I=I{8r_|E$-*7e5iDro()n*LNyW>XTz)AyPQzs&fR0ADGif<3
zHpq5w#m8f)Y{wbKMivAfKY^ZRbbG&K4+!um|1GqJZt>y*Zs-m%jJ!lddfvO`8?WIz
z#AJcscua-Y5$DUA6#esR3HOyoZZ9(wH=NN-PshW~w)Q-CP9w@ghULeJh70lZ4Z#!B
z^cJ&QjEpRV(><<xUbIAbo_JJ7J{ck8k_Wx_MrwX(*{|ID{w9dw09xBG*A<7C`W+J<
zj$A?$d$S3Bz<ONqwed_iB}PR&IbFfQ_rA~b3wMYAGjHMkJbF`XEb)D;apBq2`1p7}
z5S-dZ4gUo^z?VildIeb4q~bC+Pgm<6ughuS+Sxd}23lDp;WmG~tN0vnLz1*UmyhEE
zCt5T(L008qv-xzRpuX`J#LD>~jywqca$u%$pUa0O!R6$`e}5l*Br!iMJgi0|Ed1C~
zB4lk3<ng`}F+|&~2q($~+RZ-tLWl~X@Jy|BeWmuWorXp7{!&GX;W;39NMfUY!Y2tv
z0D(@F51`3ZJ@QCmH*%II&lBr()DFwc5KYI-WxX_PY(-OOSHs#2DMJ%?y1g^L1o+<W
zByU;l?!F4J_=m5DQG9e!mVPHN@a~}(>%!ZQ)}9;iaBu$zSn%$pMCJI(V<JpO`61oo
z&@#Wp<}`K<w76}0m<1sddDF>rLvq%<+89HB5lw_P6!v3`(((4diMaQ(^?$boeGh!u
zMo-|N_mATdo$!ndi^ff5&*i=l)vVVh8r`45b{&>wI5Q8hF*-u>#;)?noY0lQu^b?%
zjB5nqY1JIx@^p&@$Ix4q<Q+f|_)N$j7ClyN5HbW>`~QE5n{iu>9BB|PCdm>z7}9Tm
z+5ic8Iqah!EP@4xBniTLb75w4Uxer*!jd5J%(5O|H2zr790I`NNjz(Wv9q)XLC_pv
zeZENHvGCW+8i-qs9`Ie;wubp6P*n(2X5l!<&2*7Vh1SjTWe7)|e}uAHl+G9n(832B
z%jS?ESjYzaM2;8_$X@NrCE*S}V^ylT#i{DE><~vn8{dT3AJ^dy(n`mmJ4MeG%Y~yg
z244{uWjt$2*#W0DI-UpOIU$be!aO{@kafw9oBxZ(BRlem{JawX8|1R9FE3NW$qe=O
zsZVd-?GI?ULU>4UI=aekv#YtX2ZM;kazM{A)WR^&OuVoe>5`dS1WUqkfk^QjHM=9D
zU6ApWNu20lBc_)3z?Rj|=UDj3xtzfRu?OQx*<$!h!-;ikLdtw`?lTSioRUEBk{&KG
z8B1Jl=J~gr5Fa)><Z2>3xK3+hZj9af!*?foF9~554y>Q$w@c!DhKe8|78#k8c+9RR
zf&L|C+&r2RO}6=Jls99O69$|iJSL%7k{c<WJ~AJQ<bY|aO5<np-jW))#7g1#Q&`IF
z!@&m(tHj_yn=mI%Lhv7fW98ZWSFkTG$-)<hc|4HE#!Zk3_|qIlK?{7A7=3Y>@P~p|
z#r=6t(PN{(T#`p5d|d&<$TtOoILN~MeHeK@M4}9`*;fUe1jcxB<Q4iC=Q3jCCm&pB
zTc+xKoJUc+m4?p~oxgl0<fiK>V*}v$ysx6%G=_=d`KNb8DFFg990R^TiFFVEGt8#<
zXGcEqu|seL{QKQ3o<(u<JmreVCW0DErec<%k_@-_?pPWFCZDME^~p6^$)5Q0MjP*w
zTMKe+&Ad$9UNACs<0i;C`2L_|?}TD8c;w75C1>*1j*hEFn46D}V2|KEjm(%KBYni*
z`!(xSxReHF?$^_q;$y;_@X%Ai3#wa&w}MA`XM3xRYEcf*|HixZ*KR%W(1TToi_Z*l
z<}9|b%D)eU<`Ba$tiA)dgu{;!e7o6sJ2T&l%RS=}i^f9oR$Nyz&xAbiqBx8(sdilO
zmO36M1UZBV*eEUxKaz^p*O8wUyUHYhSYZP+v(@7GKj~nrDcf`d23rvq+=zS_h6K`}
zdjA(hpH-!oy9h!2TsM|>b79E-5QZ+XI?C`-h%loge4YUor&u!H5%S68pD;jh_E>;A
zx!zuee3Hz>=HVU(^rwS;;xdhx+yN;MHZ|TCgfzRlRE{`msWt6da`3^uCGlICgR+=G
z|KSCEoZX{O5#lw)^As^G61Oc@4mmfu`2MA$G1uR{5yT%S88+tQ_~p*7b7TW;*-$cb
z_k3sZ7~!*;_OjS<@Zw7(A?Bz}jC`1C9uxRZm1{Iw@iNRj5*W#+JYOa%Q0sMwoFP0R
z9^H$^O)Yb(kLYF)z9P}hV=)}M<32WaI69t@P!zD`i2x(r$?ery`j;FuXc}#5i=O`p
zaFI|L54S0pMD%tfmsU6aBM)r}wJIANl7EOx{e1WTh}X~=aBlr0=j4GaCE3&%OaI~_
ztmo8FTs~{AGC!nZ2Bcm-?yJUQJ~p|4WJbWvLnrV>X^HZaKjPvaPs;x<z+!&7rRA<L
z=tA+@7ldgdyL1nRUHuLq+-lZK-aifDD+?JX42J>qACf^5n96U&-n?YtGK4Jag7Z_)
z)J%NQo3(}(S3qtZ;JY`+M#hiGtqzu1MWoowW^Fnk#6}6ZFBU(SpZp;o87ZtbE4iqQ
z?}W(%=m4(?!$_XI$H!*8JGq;W$1Zg?H!#Xbep(!Y0ylHb9tD~j9QXMC9$(}pYmMyv
zkq}EmC;DWN%g6PG&iFG_*bLwD-I)w+@@X<3jM8BmkAuJPZzB==G-^N5_?cA58HlCe
z$GA=t<bmMw7@T{>?;CwPn>^kom4AeKfJ?u>vH;2J;{*@O!-wXm2j@Ut8-i@=o8kY6
z$6~~N0jkFRQK$gNs{TFPGPS7{Xg?<mcwv)L0LIaOgZ;!s_Qxe6DiaR^KgGf?bpB!^
z0Sdk%FP52TT5#fr6aD}AX`cbdbw9WC)A4n!6d#U%;$r*?wU!9p`i<g5bN(-@RV=d;
z)4AUGi;SW>V1Kgp#Lf{vKzCI)sm$<K9S#Gv|BUZnDD?pkxDO{kZ*Gu>&2D;O6MSUn
z`FvkO&+$>Apsq83aiDmh8!yYphI9tO5^`gcx$uSo%w;I_yD|aQ3^h5fK0ThFk_R9_
zEt#<|8VO$HA5vLnd|!VcHhulCYCaDE`8cT=r&r%B`il-i7<Z412A>2!HGNv;IL%%d
zhL^%xE!p*^e~-Qr7><AfS)6=i*dQaicupQdwAf0(nmIcI!_7gs{RP%|IAZG&q}ZyO
zB$enqvay8a<lXCt#|@p)gp3xV{JgWm8gBQ&aEx>z-a630cyy*wa*?_`=F9Q;0;tQ(
z`>&BjJd*}-ba!2!8KkQMJ>%N#Zkv#v77#-z8CFC9gZXs(?JpS^a)XCnX8;N1j^kWt
zS8;Pl!^~&KcvnC~^L=^LFg%w-@h9b-LOn74)=Ng%xc|gi0Vn!D{=kuiWZu<ujr{@P
zSHeC0@KNCp8LB(tC(H?N-S9!eUN+SPZNpSXu>ZV$zZ+El3gM<$5O)8sTF@lkT;H+!
z$EE)SIxhjUwQU<lI4Ke09QgkTd?Uj8x%MCH6jbf-nO@Ez^5t+<ebdyIbxn0+;vhh;
zdFza~<ZqK42sVZb!W<r~%thJ1R<*mMU8W3m@o>`NcqM*%Sc$C2xKD`X%#QH=k>DV;
z-70-v`e0eUGCRT>0bzoON%#+LrYE`#FPH0^;2FQm*Z<z&UMes$UQtFHh6uot{3Abb
zpTW2Zo4h~&#Q}}RU>`CW4}NH%+zB}?+7&MdMn_Jt6<`g*0`pUG(F>*A)PsRsPO37W
zf*Pg&HX&XclO8hij*aapuM5$=M1)NI*VW=?@H5=O?!)Ws_QzZYU7lZfUclP$^~6ge
z(va`GRKe#7*dTF%lo^IzNF(Lph1C8KguDRc4Mbz%j0~Odm>>yEP00>Op)Y*RH+_aa
zBDb-TAaqKI|DGOODk1TZ{8b#u7!;8FPc!)MhXDxFo=8I78l6##-FOo9(Yf9b?$q`D
zyV`$1LLcVhJVM-Vsk@o8YhRDgI5+ga%%R;%L|?bM{2&kGJp+Yq_D_KBn%m{11Wnu=
zH_FoC>46h<w#OLf^luO!7aO_B;lulvg3Jkb0kS|v_y~I^v<AJPOT2MjprB5OFF<8i
z$kyim|9UJAng3j0f-RfUWC*rp(jPDz{3*lo9FMo^4V%&@3X6{m?-<MfcefF7GURBh
z|4@$;=Uo4Y@W+HNms+kG@-h=T{9F7z61DzzCs(pOWDrGqN+-K~<V(Mckr{#Ff*of~
zT^H{837L9Y<oF4mpfl?Kge`5*8!Y?)06<OdLH^yIQD4A*yFhK!s?cxnBmYm1v&VSQ
z;0Ulc2ctR$n?2yl`7iODbaZ^?N@*=|I^i}`OAR$o#7<%dZK48k1;ljO_(O+(v_NJ#
z7)qrvzWI&~NBI6(9M)Wft+V}brvFey@V@w~=Pdk!+M6|=Yr^<5arlxXZUe0xc+Atn
z_7L_1G-9}$I+2O$sTIHDxD2OEd`Ag(XS$L<iR0rphEh3<8*rV1A%)sxq-QjVEpUXs
zqvIuz-yazd#%_A-q=S(G63y5USR$y;^4>^K#Bh&p&iNupd}Q*$k8@-X4-s#jE}Dit
z-8q9gmxMLKU2gbyax6m!$srSTd)K7+<-YNi#Z0fmAYkOP@*mCQzyKcLB!7)(f}Th)
z#Q%@g;0g8jtIpH0@(@o6m{=$px4olOZ=@U7H-c>0JHc)V_E`cP!0|@+{h-3al_(Z?
z|8Iz!ai)Led`5VVe~A!i$RIyICj`%xsei-LKg{Nd@W#zdird9_kKfpw{QP<?+K@bS
z)8q&T%i>Re>U!X+1dZJOk%_yX$CuLm{{m*Z5ASc6r@o~%EFx;o^Gp0CWDf|y$<B4a
zMW2=%wGBUpt!Ij&wUzF~RzECfLe&rA?ue6JQ!CO*5to~F2Wk&L1>BlQn+#9zg?Io>
z3@cB9h{uGoB@V4+H3K5C2yROpK3#twJ(f(5mm|YJEveEIn(6*Cgnk1w$1LkhiH5~J
zv@)>|usO3H-I?Y65+RLo`6Y>A4Q|1Wtkgz-EXST~fcVMd>&}UZ*vo$akA6Y@?c==1
z2^1X|0Pem59fJt?9ulx|EMkKOs;b`g!<cDu1EUjpyZk<g8^KOAX&jb?aF&G+{{T9C
z+IU7uf5JW^T;4ik5t9cJ@Kx|e_#Z}RkArhXFo}nT_W5Q{v6wsyM-4LL>_`JLfg>ys
z@G~GnbOr?|fw3ufXN0CmT2Vj1M0>e==Klz791sV+7FH{grw|#R<)Du;qGS!tKj1**
z=wYIN2vywPfOkun*c{9`xi^t3=Fk&s;v-<OV);!D`Y4j|^U}5Uo)vva$*h@jsFnl+
z?nx5#3y|Lx1p8py4guT8fJy6-^E`LL@(2SPU&G<>_|;z>QwU$jhXET)l(ve^>ze}`
z1Rw`$+RyOr0~*0I0ApAp&Bk+!4E*97?0j?@4>8CimKooR<b=)$vKC<vmOKO>4%+p{
z>0$C9OxHpE>%7$c0j?enB5DKu#ADNwk5lLQxbc)JR8Sbp=oDp_JN;i@y16pJd}!-D
zWwHpIZ$w5+4g-&m1P<SCtRV+P{klfhy!?KsISH}uKk}P<#_Q`P*mzGZsa$L9ryuf0
zBNDA<$atS088}CTa^vLkQ^&{KAy8+$JmqUHUWxF8)j>wGrT3}Jt(TXL&VD}IS!2@F
zA8>?xWYtbyIBe_2O^_YX{L-Kwi~K~hJ0s^GGMO3j+np!G;{Z@Bs3G8A|Agg4lOjZ5
zWv+n2CU-Z&Jyr!60&nr}rT}MxKMwi^mlA691#yDs^}!|(IQ=6H@pIv9XF!XG6Z462
z_IxFB%5bE^9vI?762yosWDy@e2q)m4A3+Jc5)*JlQZY?7J{y4-uMQ87yUQ}+<5%#)
zNp-<oO58cw!RQDQ21BP6sh$K4@(<fMZ9n6)mJ!w88MVqAwehd#T)$k@Tw{+ix7&xT
ziCXWmqamQr_?ZXGQ&snQt+!=XFEhCR%O%NC@sh}SYIsz^Mf?))pZ~%gQ833cs|cH}
zmbd3LyUn&3IOO7}W+2=lc??b<F^JE$G*w6C<37vAX7QxJA^LRhshzKHSPASxt~J?H
zm!x>R@0z3!_(F)M;iQg`S7yfmF=@k4GCmW8crB2zq1YR{a0iq@@m>Nw>3deU>2II`
zZCCoMVEw>m-{?oD2D;M9zYcgy!>nK7)fb0xw1}Tr8_p&U9mCJU4g}B6celpHf%%NY
zMPUyS;xCQK8JHV7N0RZU8ed^>X+(Uuf>!`I(y&0A^v&a?XP3x31K|IY;vuLD)XZ;n
z_|CDnw_o_gF*m|6{<*f;raXYq=@2iH9uk%LM6<&ABf>o_f<7mW+@NfNyO>9ah>cB9
zKgRv<ZKkC07&i(p@b@48_>YRKXc=fQ$}bT}b&^`rC-FPv`cmm1-F&*b;Xfn@afdoL
z$48}^a(3cT_zLLW)KtIVC2xS=(3r)<(7u=Dp13T8Y&iB1a4SZH!cHC$qj3Q0`bPgu
z2f`C!2+SZ#cJC4JS2FJGTN$B6_!?Me{KJekC-y!GEuGmla8-oczWV=q;Ka{I>1TEp
zq)OC3_G32dgnrrnKQNS#rpb(u@^VKmKk0-bGjN}AmV}Eh5iD_arf(4j{M(GfMdIbK
z^6=<mZbCt)ACABAbH|5yiC5MB5y2ma_#{0IC3KmDOdSD(RR(=nf%t!x2ZIaGe;@o;
zhPiY|Ap$P+uKjo+f<tG-d>8OIZ%KG!D+okE2Jr^Nu^cd82wouGD*Pqpe!%~p-;4+k
z;(Y8wNP=((FtXPOK#$V%kG}wq0Gs`%TbK|Y>C$cd6~`_<8#~)pL_y*4nA<@3#7}`7
z3~AWEF`OU<PLsD;jR%GKtTV!^h~=JOoHJ#x-<CdX)?J7(5tqECnQMvUg9D5VoGHR|
zZ_OIMGakoQW4w55biyTwLO!GaTX7G-e4ap;IcHy=2yUSPz?b)1?&=-`h+xuNyvvMI
zq2M+l^aLf}j>B~(EKA86Zm;9hG5UuU8ZkV4THN?|!d^3pp9aMI>0C@}THs2~TV2gK
z{C}~yVj>7Kd2olv=#d1VNk<YlnpN<9kLy3937q2N@RQeR|I%TxnrR%=)&$S=AC1Q`
z()j1Xb!x)Lfl0<bI)KO9DnWfnFZD=EZhW~$U-4F3m7On$%T4Jo5+{rsH^XqJ9~?G&
z9(YGCQo}Z4<e$v(xepPBcte(W8TNj>*|H2Vfjxu&>0`3;^76i3PazYoKVe>(;Y|gy
z;CcciGWxdv#h(91GRTK`><^UF>?Yp)Me$sb0v6yQZ=LN_*^vQ<ze)Z4d)bR2=?{WU
zhXQSA_l|rJ-h0MJCXie)iHOExD-tKes&QJFtxPT>qct(fd*HVc`yTAo;ZPXl-R}5q
zA4!bQhdgONh{NQ~#ufy}Irol{{K@GUx;W?2V0|w@Tu-E~^{h;OBP{dT$zh&8NFE+H
z8KT{nqVas<0$k@%c#JEFmxTDn7LJKe!(Tv#aGeDj(eOBc#|@8woCF8Sl1<Pam;7XB
z_ju#%c`xh3Z@dlv5D8km$Mwd)bG>t))(7+%<vL~E{|U879qWW)57N{?nDUtZ2_9#(
z!T+6@va&-GUGXs(&s-C4QOoJIaz~RNcthZ>nb#q3(@Ffx|1As$hPv$~aD`?<XHreW
z)txdc^nGhVym|w6{!VM3h}cDhqpuNmn*1SPs3UA9Y+X?7yfyGgh?5_A@59`-PKl8?
zLQ@vVAS&)z3~o)4aXgz8c*lf0;hr8hb6h7!7dVU5bYgk26tqR*DdW$)oK6U>3CWut
zL@to5&(IP=;&iT6;ef_Om`D9H+!=%@?>`rNN-zqac!Kz4vBbS$2aP7<TvduZnAavX
z$(`YkjNt_ZCYirv%448xp)M}5sPuUt$^0$};1RW@eaq{yKkyMf+n2w6VT5z<iSn@9
zSdT(QaWv!%1rD7?L|~7W%48>l<i@q)xj698p9o-c!l6H9`2JeqnBC2gJQV6Chx|l)
z_oaEL`6v$2Z^hN)#|`kVY!Ws*=*yrVAK)g}nfbW;jXCn%wPhOnT^nJ<34lQMo!{Vn
z>5~hw;}Dv}37EIz+8dNJ7^b2E7s6cRRvSV1A=n_F;hcN~LVP#H>*CT2T%Jquc<~Rk
z00W*62#W51WY}f`M~?BpYTbrN)d0ovN-`3#Ek|5N8_l1|4<F-U-^4jiZ^9pRcdjBF
zBGh^;a6)H@EZ^}Yj|dL-ej<UQz+KcBE+6CcA=bZvl_qKsY*SoL@wCP4PQv8JGKo0-
z9cSBoXmI#u%Ik{Y7W#wQX8ujt&k$PlE6)hQtu46~2l2|@@rZE^-@y+x7bsT<!5<~}
z^3Mq%$ZsbO+Wh#uN^7D<k$Gt9{zzw3d@;+OF1H$*k`$5CJRyXvHfxt}U(Uyij)`wU
z=oAqxB{+w2Sp7d0rwt_C6K^}uJ|~F8e+9Vlv)fhzdgj>2V=5;J*m49BfEzs^m#g4j
zQqd3aUoe2={E)Eu!vP~2=9MD`Hf8x`Adr^ugqV*IN!Oix?}p!6!lKrwsJy=#xvIH{
z=da5P_?Z1S!irXWK{rMT_AOo}8B4qPG=h9hFl}VNKX9~8(^Q$?bDx_a&%M*WN*s`X
zEco)0336B(B4X_PBSA-m1#L%$<gqw4^Q_1%mEYk=OU3H}tO#>+8B{;S*$EfSk%_y*
ze!wk%Dd&y(nb$|tQv08T-sR_1zB?iF9Inh5Jg`m>Bsu$-9=tK1;<05WP@Rf0nHchC
z{8sV?qbCcL7m1AtYz><5o%*56prmVw$4!8prTTlb3mJs#kInI+L#mU<#$lry#2R##
zQ5>`Tcm6AnrZ=&C@15%iRwU9h7)<5D8Q<b)2@-^wnTQ^i{Qin3l2l8Bz9QQ?<4JZe
zg(Cb(<UN4R8m%JmiMu<-k9kv?xf5Xw+-;>#^M}W1=44IU^CwqpA8{t10QvkQqo!J}
z9fR;wTsm|tZ8JOmO$r!Y2NAv;%BD7%Oa2b1E^Ky{wD*d3YX|~<0a9~GXA%jIitVaf
z!U4D?9mnSOE8`bFAnzv?d*1oqJJ%H(Jnv>7Q$D$JvnwUwhMdgVo&E@6>Sy2NzI*c6
z-&}U^i?~{W{E-dBp>G^G{uJg;Am{s~Gr*9mGrM;~hwQt9;S0?}Y?-hfPSSH-sysy8
z$dd=$S1x1mc#bn(4nUB2SMPX#reOb*3JOfwuK$(8`7sB+Or8D_;SKU_UtF5nUdMuO
zKb@HPo7%ZBoz4AXA~1#VGbpie>MWgcSH16@^S_Arjucu6Up=(0BQl7|o^wFR%W)Ww
z#9}j&_hW??j(7QZdYO}l<2p}qFQuN_s6cPa2RKsJWVCW=ndyC<N5+Q)ID7vQ*v^qi
zAZXEQx$yo0I3{cf(XJqa0R+FZ^Il+pcm&{MeU56&nFO~ofAdI{A<UT)a$`n+!gl7v
zN<^*+Ab?4u0t3Jb!gv9h>#KY3`~WivHb#)qSU(7JR<S&htr53okN2C6U(LhUaP6ET
zFI&}-ZGLGg&HMm+U2Rse9qK|3rAV=pA3OX>wxdac@U%H-)7!?VPIQbQE8<lab;1-0
zEO0z@P{?hc!R(cAmc%wTlo;XUwrdhAI*AuJ!OA;a+!C~TgmT7SY}l#+z<5IYyXmef
z_r3GJchCGxJ85rc1X6|RM<<od2=GpHQsENH#Bm2Z{7fC`GdIMeGzuk|13}q2F6(BJ
zW_a0$ns<_PN4{+hd*IDBTBC11O?q~dc(w`?aINc4fB4K=ez7m(^j{DFOIFg;OTjld
z#K@<|yD-<HUh9uL-!!>W<KaF#HF>rpnzqTqa6l)50Xz^1ggcik;<zK0M@a~os)BAN
z8K(6V!52v9_>yU10pFHBg|b(MJ_@e17yk(`<}xEk{u2QB@Z@^uufxfg_YE!={l~Py
zd;H!WM2p94a*P!xpO7#*umBx#J94Rw0;gO>##wa(Pu~ev4S`z@#F%814Bfzqtj{ci
z`}yBH=l-o+REj8EtGPL`wEx8X*b;tQ^Rh2?SllI@11}|4B8m4h&zr|+RH@Y;-2xpW
zO?FKFF383{YBWwJ-egl|xhmDaeD>wU!@uDR15E=fhr$yAgCK&P#UX4@!f~m{K8fgw
z$vw4U__*!w8yd7t(U*yYDsM0=?N@(|U4i$>KPUW1o*SlZLx$^X3|DsV@wUu*8F6Mz
z2BIxP=lv5E>*q>Dw){6k2sr`io$vfgLYIr=#JJD=)`*iQ1<>syA~eP9V+Dqve}YdK
z^B))4j2{n8FBi2kqGk9;q&%Y!&(m@ZQ_IT^A-R9c(UUx1Ni3J~b7BR_Pr|-7Y8a+-
zGzDwd(-Om<_(L-Bv&9qL9%!riry{|rq2RJMBk1I@n+BRcI63ZO$uT0l0tfy%`=kd=
z-0$#DfX9=0HYwH)q{z_!NeK4Q+s}IDpW2G#sL;ax5VZV)C@E!>{IX$#yidV59~_-d
zc)K9@PG`I|YYfUBPD+82he;85E6wqB5FNVowOPIu{9x~z@0daKm%lypzruQy$HS=^
z_#if4pT2()h{Sl05%`FJqV4V1|Kfa3_#lNF4_L(7$3KtbaTvzO+x09t$@oV_iFuIJ
zhrB`BghGSZFlw#8)A4s5@afH5H_LNZ2uK!|Ltuc^44rARwjszZ{Uk>Dqs<GNIR#zS
zaU7ARf!d$P#Zo$wT8xTjKP;v+MbR9TnT<44@SJOIM~n=TpNx#>;V99vYO%95C&$3w
zbhC`LVy4{JEj#BeHC_N^diq~%<JUxTclfF#q4h&XEED}t5-*$m;%11(M0`Y4PWYW@
zh%kacUOKQfCf`Vjk<a`SVBhi1$V~D}7Xc$RI2eh!EpQILI|7*?_?c9<o><v2z7ys+
z@tLF_;`GUxs24|95#NkT2E0_JHm#OZh9bE*+|FJK^7s<94z)W)8B_oRbZKK&OYelH
z5>^KYSR3^~|KcOx@u7zycy(f&zri<zxIcq~w-Uydm}uU8e40U7_(T&|fB^0Z#?Bt>
zmJr6`BO-qlkt`9kI^8jMAY?#)+>ZEn{}tei!>%DmiZFU|<)g=0#yw!_<^Tf<qrPO!
z3F2WdERcI%ZmgFk5$E%I=EGLEsEix)UPw7OiJ;Yy(pnJslJL`0kzBPg2lsW$!W{%!
zNe{~rZs8UvjEK<d<D8#|v9o94^qA5iBf%fQuL-`Hh75RTE)c|cj}hTN|CjtmA~q-R
z?}ApxdPt?=|6T|P6jnA5Z<Z;IlKJ1@vTVhu^L$M>2)D>SQ&;D#(tq{xWQXB6Z+GyF
z5GO++i(X$Yd1r)>WVopW7|6|d$l~XS!Iuxxnukd{caK+UL7ZfR<l?0<j$OQQY-7uz
z*#q%hlT(wIxQ9F=Tq(kKsQYoxWCo3K@IgcD^<`^*d=b&ZMZlMT2mP4(t`^}lxf&;k
zP51OjY766{;Om5*A}0~=5s2{~Bf_8mVKBB3<W-39h4A%j;pX6|R0F6-fqMPF9U@hU
zKXXnB+5gRgZ#9!P3bVw)E9}oBLEw}6KlPr`s#<UR<ctiSNO`&8_a(*oETJm}_LX&<
zNoEik;529_CI|MP-jyW=yqrG>8~9H{f)<=tI8zwq%$z4=`{pxO&ErM|@st8)2PCtE
zOb1PY1rwG++ck+>mRrVf(ISI?0Jw-B9MAD^g@dh{xbYYu$#@C%^?3Y#=Hw$(mONt*
ztFNl~%-7IAdq=4C=k$RKQzgMxu49@xLe&g68p1~fIosfm!UqRj+z>}3PJSyV!_i=V
zd?6+f`1`)^@yMSYhL-^kp-GAFv6u0X0UjrRSx=w%N&<cL+b{}t_oZpR1S-%U+W;kM
z0_WxEuqEWH*!*0J9VBFC)WSL6;x<DcHgKQIJSsdh`J{h5Mhy5ubdp4-F@cjpdP>W-
zUMH1_@z6~R;VjZFbG~D~K5D|N+xT9+tErA*0kpd5B<1`m)hUC7FA;ke$K*r08Qric
zN(`Xkly6rT#AqXjp7uDcq0T??J_P|GsR66w#xH*l`82H?j(jHefZHgzE}%m}O9W13
zfOLee4T<49xQPHnPHaS->BodXo(pCK1VQ`{_<)~aew+3N6L1u1D};OkJ$xT~P9MR5
zP49Gl>Vv(+2hjg41PAWf{Q<wqdSh+5xhQO^2g`|{lQ+~xE+!K3$6c7tULtBnF^!u6
zFA2+&Xvl&T{Dv)fzFK!A-z1opPEQz`KL|+tX)#8y@aMoW597O^E%KFLn?NCvYVfzc
z89`1A3gDgr4!V6?;x}8X;NbZW!k1^uNbm3%zPUQy<MLoi-+O<-Udj$;wOSx^<_SK2
z4k7k$SpYGjB1AaFK98HfKQ26Dmx9bV(+v#R!V3+c#t$JSsDok;xAyzrLYx21f-kpP
zwEjumc$@|%zd|nH5xO73c;#g8|BsRn;S=u86VV@vn`-hUoui^Loz<w|!UVm^gN(Vk
zvcbHZAujpzZl%(2t#lae&GEfX;(EQ9rs;p;HXlPmp0*Cp!q@yx>Km=qO?Suq6re&s
z!-Ry*vA70be1sdU#4j)DpaA}@@K+9?l57zf9va)7NC)ODQ!)d<d0f-Ph^S*&f_Uxm
zoEBhA)_)KZdOP&!I5spp1c-FuUE$*xK|k&HFmLexiGTdw0Uo^u@6R3KDuS2*_NIWp
zqy7RlS_A!ZFlwVPux#>TYm3I?(QAFJ9cWPDA11X8@SJ#HwI__2*X8oC;W2%oZt}wu
z!X2WB3B*?d2V65WK-!49yR{x1P5xdSYJZFIz%>t{ELzdl!Vit5@SD-OFAx52nP!XY
z?Afbs88SjQp~XIvB)B1YZ+$=V{t~w%^}TRiIDp_p)(7u^B5d&xAT^PjFL=YjAB(II
zh!d=GXr1}{;8(%!8{y7j0ugcHi~JUIqrq-ENE`rOFg8)9E${o6xLn={o&rgD?+yF}
zZNOjY7XSjcwLpK1!8^}Iir$-_jgG<FgavTRfivBPH`*|GRItV}td#*6;*BlD7As>U
zPx1P1wPaU-Jp>lWXZGMC_nzMRtRCR5K+gnINb>UdLiU}p*)IIXT%3I&qi%IJ<vw$f
z!ys47<$?JlK;SMjj|?9OOO^%(*wLNdCxQHx8l3(R<-)xnQO<&Jg@8uFtLgYcG!NU*
zXLu!kUd%oI=xT1o0scR60)=ouTBYE9+yq!*ohb;Lk^c<656hS5-_B^;kP)}jho!>3
z8Y(Vh%kk#?SYpr^F8V`7*YHsYxXKg&SMZI&VGF`)WJr$@zc(arKcm0F1|3Km(E-D-
z%!K>E_M|imO3c4Zza4tHFNJvMXcG<qb3TMmfO&u0<7T`rxv&xIyKp1%ss<JJN!N47
zap1Tcd<b9w=k@-dt>wm*RG7i}e$)Ct`i~7a#bh$1T9o|A&7JGNg(J-cTq$`EZwEr;
z+FIl;p0FZ)a`P?&xv{JEvu5MkUTL;$J{yrgwW8cBC-yi=!_t1DAvzerj6=Eq$;hmk
z&HQybEKNPgF9;f1c|pl$F^lE@<>kxb_oKtPy29KMOdu~c_r&l@-qo-$8dgN%ItY6^
zPn(Y7s&E){X8(+jYfc1#vA`&+haGlN0iaNWIM@7FA?_LT_Wly7ww2bS0>0sWc=6#1
zDAAjCfv%VAxX<yJdDw}aM?WvD&_2`1A2vRA|L}%=1TUYs_#Od2;lwm249f^U3LxLJ
zH-EDh@9((?eR!?{g1Gx2ajpk|ovV;~w+DY~0Rz>^_xaR$#&6*cW_i%_<2@Uh46WY?
z{<WVfUg!A_pc=z0<p?Oh$WM9y{6%ikp`hev*!8@BXF+LWcqosSi_3@9ms*pQNvPH3
z^5Q~pBz2GekN*N@v+($1LFxzsg=&C5(&TX)=F@)X?opM`Ume0f35`4o1iWF0e_y4z
z&)<Ik@0`*7aF2k6uB)a5d$-Lo;3rTcVWBg>Qh)IyMiYnPC}3tlJe%M@#G#yQeL#94
z|HtO|^t$lwr*yv;4gaCzChZFEH^bQxHvxT3FWe9Z!%OO}K#}REQHr2J!Y_^j{{+>M
zNPb_|<}4nw?yYqvB(~PLy&&q!rtXtJ7s*)sH~f@nw5i;zA6mk5O951$#mGS$Ys*vN
zE=rqg;_ZYj>$~yn;w(l9`;7to^KqNF5$^-dE9C>iF4-{1Hv0nunk*jK{If^@mNBOD
z_$r$1vQupLWOtSbFmQ$Rm>1qb%y&td7jn*|x<?1bYW(arpe`GJBXHo=m$s#AL1%W?
z!|Mx330Agz*ET)}Bf@L<4kTw@AHNkdQFw*sF`iFZ0%EWHP=Nd5I;*-LnqiuUB6hzS
z6E^|gm-r!Rm9iI&^}Aikd4w?mqr;hh;^>fOun~3FKIk~sj0$O@1JBn4wx0;NyCPWL
z-yg0Ro~I9CzF&{V{}*Nk-~jY_(y_(<FWlqVSoyj^rdmI*=G-CI`L~G;<q#m1T+YJS
z-^XQ^yhxLHa>n9I2zha!FZg$km0(AAVgB5JAL_@~nrDsVQdn2F|6}mmPy8z#@-#0+
z`}8U5zS8ylWBu`d2_D1*kJumWq!W6J8Z|?B&kxjrH{rgK1*2+THIUn=V!D6OM101t
zdF>nZf1l6%e(7uw8zdak{IhP+JBC(wPaL>jD`7)D=3~lk{t@A+PN)DF#ob1UuitP`
z*9U;mGxwWnPD-+p9$J^iG8@TeF3mr}9vg%gbTXou7Bptb0xV1B@^^-iCfsOGHZ}%U
zf&J`d5E3@d*xpRdviAw9pfl_LzF!)RT-e~Sj00LUOrHp2heLojDna0AU+1AXN5jrE
zz}M>r7xCZU;6dxT8a9urerv|vTT-nAUmp|t9X|Zf0|%;~?6!vZ&*l6u3BM})oBl4}
zy&rm2ns@ONRQGs3j=2n%cQ5{-fj|HJ0EX4QOZSWO7f)y*dyRm1Pz2lfKGUpXKgW0x
zel+rrF&Mwx_ZBkdH}tRmLHSts2l_P{H9<euA4QF2zsD}n=?!L1NvMKJh2rIs0L{5s
zLlMGyRNAXcgyjny)X+;Xg7_hf&hdI~N^z;hX$z7`4vZh=t1B_Qmn2kYW_bPaDXklf
zc?Mg_5rQ6CpU9L?AKehm*i2zceKK#42Lu7}KHCuc+0*CldeBmFHWHD^%)tE&po8PO
z-#23k-*sK%D}g>bC6Y=Vu1Xtx91!WjBfuVBCb+i%t3Xu0{yU1j#{y$gP%ZHg5jDY*
zv|c|D{dbzKUt0<B9wccQYOK>!5I-U2;rO^MOkj7ZZ%6P^igWQ1afvx^>Ii&qSH=1a
zahAA<AI%tIFUWCfa;otymy6{T$aQ7|_N9S0tDD8}f6~sTIp2%nKBo#)v>4tn*FX3u
ziYj!DYI^2@GfVv6zs7LxSk+Uuh8RO~pi4{Y{MGn~P42LR`tNpvpKP-i8iV|rM%i?{
zCpMfg6G@Q>aCK`;(4C~@nB;Ak$IDFcwoVh7A*Un<Z{EgECT&4eni}qIWAq_Bk-^KZ
z9F)AaRcI;AGaL{^NlAYv6;T}9wx;1+O#R+ptJQCewL5_**GK=~Zkc!`){Ckb05<7F
zFQiDY`{KFbvY8>GGxBAQxN=q~4b=jYiT{@JqMMJ0YrdXF$RH(RW(&(!RVN=~Wh61(
zJk#+T?~?<6z22}Qaa6au1VUae?yaeq_crOUF&q?8xrf!hwc)@%RmAq+RPh;jPBjj{
zE=>2BAo+RV=H%|sj_-+0AB5wv-W{!$V{@7FcO<-B##uDQI)6SvZ0;LenZyQD{%$@q
zWag(%e&PGN_z-xHAG9!+kN=8-9}nS&{L<G4(hu^(Q4P}ZKi?G3z1KGJ(VNTAuXG{y
z0qlI7Honi~gnre(=jY_R_ctYSN6R*{q`9ifubU0=@@^_X02@o1H^toMA^(h>_2f^e
ztg#t*=_tAbRy7TR3p3f>_)4iWdsd1N9r9d+cxSNCh>MWXJ`W;u@g0E1!K^Zg;p)D)
zM`nW^01+@OGbP`vZ=1%2FNpJ=13o?KI^wFsB8Buc0w(_Xti4?CFR=Rfc~PIZ#oxXk
z=ak&=u6(LE>Fyt&gz9)hwZflg8q40(Xd>}=s>@86xh<X&2oHq#?%RzuU@sHl<T$~^
zp}v9qBUqXJ1R2h}=9vlNwA2jpdqulHj?h)+&N?*U=<$nDHq31O)CrH8ClC}+AbTG%
z^MCvk;%k#P#COq`2XIZ{r9RSwSVZ-3mUc&p+Gx(d=F^=5;-iM_;=BYc&=Iz#J~8hs
zXf(k`5y?}_@P)nS5t0w3Hy17qv<(bvA5l58z_cxS;~~A^_-20PGV}*+%{dH2a8EF9
z#>W%;xgX{Sd%hBv^<JQQiQ=h}Of}#EDkD1NnF&r&d2@)#0Bwnd_*Xv(xNQh461{ty
zI8s;?*vdcn?zOE&H-k*>f4GnJ!V*QxvCF$d0ZaM2mpord<k?YqbxI?WWFt1<UR{+*
z#B2u{CmaO7!kSga{ectRTYLL2B|m&l(|OR6d9d!2JA*$7?51GJAMl+|2_R&H<0gE*
zctmnm-Na2~isj_8M2Nyml8CHH1;ya}ju=m&UKxp*gg=D2a?N~1U9=q1%}6`qE-IEn
z3qQx&9M-UPH*VTUIRgPFC1=FqxhyxYiRXs(T(OZw^~;QaSimmpn#m%Wf%vO&;h%)c
zNO=74jvF`R+<auw;xT;Lwx#5pMv(Bs@o@7)a+X*izY)C1#)QxOCB{^~RH`eh{IOK|
zc`@;uAghv{TJb!zNSWifB#;mUguFfw;RDjSPY-j)iGQzfp9LBnSQH{rb+-j@mN!_)
z0;mR5qy!BSI6@u&tQ{AK<Az?W^7lma7rBx$q8Z6&8#gx#$)Q3P2Eh1FwBbexA;j@}
zF~j_DCaK9%n&I!fNqrWN#n(?6%koBrz|zc++?Chg9mWl~OCUl=d<<wxE4Zlb6?08a
z5#*5kO_!X>OLZPM(Tv^Umb#h_6-HDKvR?(E<InLN+8o+WOC_>=mIhYREJW8Ns4?6<
zAvOi|%R&o?nt=AAB(m*PaRuoR(<DKF@&|yCYH+}F&@nikkH_j^vo*;0UwiwQ&MGz^
zh|MoaCN;^9jvanl>+dvc<>R=?#Ph>?gI)@7{yf%?r-%$h?i=RMosjarX+I6{oU_<!
zcz$TA8~5_tM0<$bMiS(&Ke%=fTZBDv`0jn?wxhZ6Jhf#|oJI~gDl=lEBKO^25uO#p
zO3X(kO~03FuakOYh|7tL<Ku>2Q~4_zlCOxtryaTj9U6w(5WKLu%+L_9(tq(fP?O$|
z_Iq=5z5e&aJ|I46Bg0%Lqz=*YzJ3WjkZ7J=szPEh{CubMxg@TfYH&v__W>0l8qIm1
z|NsATYNJ>vhb}j&hUVJ3WV)qBB?S~v1*%GSLIoG<S?NxN=whl`h+Ja1im6vkd2UG5
z60)sTaB?HMed6<8KFR5tC@Kr<0Ei&|B_#jEzEhy_D>_ZHMmKPEA6jw<2h+1$Z#xf5
zOaN^9!^r+0IhUV+@{5`qLh{jbfc9k@w|`Ab$(sb~?|XZSSC>cG-bvDW=zw)J?q21r
zQ+N(6>V!ZrD^T%b@biQWp}_%5J2}czvf6z^Ox#%q&ALdirn`MtuaI2|c+sIfHkWA)
zu7#cTmeHDZ+U?IflT{c>R?}4t%f-_r)haP4D58RmC0Wrmx6A<nTjn3I6Ho%iqan+|
zlnq#JRx7G`NmNf`um$>A>lwjPl6vR&YWerR$1(q~pYuZg#=ir=<~&Siyg*R@F`nw^
zy}*A8As>mDlH<7e>FVD?ye{6(!euUwS-jDABJsxn>@pI3)aI93;U5;RD8BxJ{=@3(
z6z=6=+oPlZE18mns&({DLlII3aC1L`Yr&A#)S<NbtTKf#UW5cQ|AWp1&)NW2001I)
zL7ISS5ApjPbY)>oTnA?f=Ky>mIALIgx-2q)^4YNCfY6WPD3KmC1D7j;X_7ITDFXvd
z(CkP5|Nr{tpeiGG%gw0G$*sR9nxu%ua%TGGlQ?6WkdbH*;VsZ0GmGI4`v{mfmYZx1
zAdljIo07Bm{-${Ld&4s`PPj%%bO9Iv4U}5&*c*)G@iU8uC5K_<xsygtT{N$&)+dRt
zLH{MD5>j{11WT6m;cjSt7e@zt+X8HWe-WS@e3=~%-||NVmmDqC;6~!;4Ab+%KbrN3
z;$#ps<Yqi1e<zpw!*DkZ1UDMuG@d+B@HqYu(LRz%=_llr`0&e1cR}u7Bmo}?P#m^}
z9uPDI(V}ULPc=|xdqV@_Jn(!5Ha?$y(R;&Nv%Vt8vY^g}?MNlVHv`8<7J^?MdsJuP
ztV|JddAQ!Jd|Y@6Y5quy;Vq8je%Uxqda}x+m!7{OWvAz_!mz?&o$^$4VrXxc$}t%D
z3h$MR<eBKk?%~d_1e{-nWf`^&4(9QQK#nSAK8as7wZ!oe!I6&UH5<7D@?!tE(2wl>
z!xHBCxv_zhlZ*319*+E8jcDk}iX(m5zD^Uyspj}3K7$0j(g-oZa}hedaF$7MwAstu
zEy>NXssX-hDI$zdG>moLIZnAQQVI#i{7ylr*!gaMH#{PFGXe>re)EpZlfn`#?UUOb
zcC%6GN!8@y{D0Ay&+|`PpkaPYSArg0&=VPXH(!=kH+(03k_u;(#q&nN;B`Y5wav%G
z?jxIEQNv+4Le1mhn*%677^sX87Jvx8E1nE1DY>~Zl*jT*Jc1|W=!*x&M@Q@c<A%*h
z90ykJ!-L?4#o~1oAPF7ew1s~O^%(^Mh&b3S6Ntxzm#W{*MVf1uc)-fI{Oz{nL_k0}
z*q|f^TuetVlY*}Kn2zMJOJ<{1efjX*(ddu)dP5#ue6nH02I}kyffq){@<br7@eq$c
zyXOVVdH}X=5aS~cY==ZeP{Zn`GI3NMSJN%;grU?N`&nRdz)?Hw+#$^phX;<}^3N&8
z*B2d6tG6{;e3mi>?VFFF=@`y7yl5i6KQ9|yao%_&jsdBe<TANDWE*^&Y?@q=@!Zs3
z!hI9IQEx4i=`LH&X%Kr83iqco#rHZ*kj}3W%|$EXIE!b7Nm&sOjIr01szCza-gyxs
zZh{#B5uCCjoMbtfjm=iS32oJuN_nhom+l))%^&dHIMGjE9TFSiTy{1kV4NA@yG%HV
zr~W4PpQ4^7I8LeIn4BvSg?Nm3@9x2)FD@HH)8ly~fZ#sHxK45nC9$k$eDJOkodLl4
zwSbrkxT^ujfnMOq*nwCG1Xl#w0}dfo)pr2%gyx)Z5RL#GZhZqC!g$!C<p?9gzxYB>
zlTENbb4ZSXfj}8j`8zY&IdVfU6UU?CW>8sqH<bJ2%=!ZGkB06wj}0Nnuq_NY6$Rq>
zA$n&ahH&)9BKd95Wxp4j=ooJ;*B4Wfpfqvv#Ms^5F2Jh|Vn8_1SWQ}W<?b;ZYHliF
zN#T1d;<PBxDy$gzc;x2gn?Qgkm;e7K4RUuxBZRpj(MOPYPRzQCV001T<Kv?T$d?_f
zarzj+<Zp5S08yp7=HVVmV*|79fZ2Gx?Y*Jfhvc#(kQD=5UOG5JHZ2N6KzKx7jVBR)
zGxD9FAoJs>9Ki_WeroV;B0OTscwL*`pgnbe;xLt{BYs`5HGUp32wG}?;D)Gt93Jze
z!WZ&EDOA%aEI;BYW}yY?=Jda^2biuPYDaiarJ9fsW;c@lE;jlhHpaU05%Cw|^G)-?
zyc1)guyx}=R0)cU0^RPDlgozTIn7LnJk$r47Vmr`An^6}1FIW^IPNewu*^mY`8F~5
zLq#^pjp?^wBXUlPin%;!vGG@wS}-SfE%RqMXjwTUVBqvJgcA2T28_Xv?)Sb-A4Bk*
z=wt@a-51TU2u1PA!E3@k5%Bo2$DK79kX|sd^b{BVBH<RAf)}p_f7Bb)$ze!OJk9`e
zb8({PFBijzXAaQszl*CPe6$^C{t7LkJhUw~`DLML__>IdnCm9z@o?%te5nHIVe<5j
zGSU?9d_+jpg*QU|fI>bSl16!8<H8+CgVWDKGtsw^eB9hH%r}GO;UBu{Z}Lkw{3p=J
zfrTF&nfON_>H)_ZUf1oQeiFuk*0fmMf<L+>6qpyoJ^A?TL@~`)1vV~Rko?v&u*t%P
z=AtB<qxUh9!b=7DW5nN=xPSM_#Caw#FlkruQ~?_pC>lGYEdCJN8;j{DN3b3VwzcqY
zn%S3;FNAg&$>X*`5i{@}x*9k*EJE}LM{FU`H{vi&@;3~?S+K#kx;WSv?}j@d(tM%2
zjaJK`m-1Lb`#*%agTPO%`OAr@P{DNkc4*-W9CeaZ&GF(K@fYXv)5+c67m4{ip4#Fw
z-&6DO)<5pQ5#Pz-A9Q$6z5}Eu3?O9wE@<KlVDLuZ>bHmpak;(;cW3)Dz-Z`5^*vxv
zrGN_Wi<p8Nhk;gQ%(L~6lH>8Frx5&Tbg^id8$2k4@Q)|}P6s<TkPrq0tOf*rN#bbW
zb=V)9EdMRz5@LBK2rj=D4a5BMMem2l;o1KG9kA3CT`Ks?q~OO-D+unV%or8~t|k4z
z9~a7%6)qX9@!njGWCY)j?o+gIh#nJu0{WnZxDLHP+}~|qz;(s=CD<9X8;5SBAWi)X
z#_}aN!7zey3+X^_zoy>4lQDx__=@Gn5;Tj+nRnlR5kiNMYWt0Ux>T|tKP-b91Z`ZF
zG>PCm#D59V!V7>^fj6KzKtj}LafuJe&jFt=l8q^|&Ce?2vKk%qF%Ni~gC6o<<;Jgd
z$IL1|k>C>>0l0Am9e^L=GX&>r?hp8`S|mz;mQ3O}N>d$?gZe@^syRUbwIn|^0Zzxs
z2wZPAu>hC|2g_*4>=%#6kZV!^BU(8>9smjBs45_ZfFNKfZ^JUva6<DYp{w%&yWbh%
z3vJ_NhJoSKGyO&j*y`88hOeu>z8AfJ!x1<_eoF%@e+kNdGAu6u0EUpDoCpp!P4e`p
zI3~FGB6trFpse0=fjiJ0EAFCANeu^I1>$OS41YlcCT?8w!pGsBTQRu)9p;&r%f-^w
zqL{})3|=ZYME?YzA35>VED0ZghM-8myp|#Q;2&NcgtLL@9@hkzCD<955Hxkq)aS#v
z?LpKs%y1OYXWj|@_wUtwc)oEA?h(xqjNr0ZM)F!hlRf#d^2h<8AeVp~Toqu#8U(DZ
zEAj_`k)03&{ZJmpe))VEfeEfJkPy1e&&fnKmHbbY@a(hxe!T?z(WbxhQamwyl41w=
zLSfq&$c}??8eyn{`u;vR2xp`6NWr*91#H_9-=78YPR+lU!$`QVmSZ!F8{_ea&&-hy
ziU{@wPvg7-ZGU&XH3u@r53#85MDdiL!`(?}4pV^FG-<<j&&T1U5Q92&E#vZjTp=e3
z=l>pDMxrvp8MrFmNplELaOy`bUr4-9NZtG4jJ+2haOeqlz-PNdT92DExyn>HRbW8q
zVMy?ejBE>)f>c!ijYhzf748sxBN`JlmuJ8xPZe7?0uC>SFlf&$qX(eF6WxSdWv*{D
zyuGA>$1bcyWW3oWK?&yQ7<MmrzECn=_U6aJIR$X(U`)Y*m;^Kgjqo4hC}7|S2IK;N
z_06ydA=>nBo)*JMAp_Stsd-iP@}*KJ$%vZ>c!$F);m2`Ov4rjk&^--9-cRz(TvZ$h
zG`LHGxShCr<N86(*-IwwZ-axFF<23`OAp8RPB@)bhBj@0|A>x<>I2hxL=0C6<Dw%2
zkkvmgKY}hwcHw?WbNMIUFN9}PyqTR2KmZ7B148DJLJNE+=3-p@SBD_|kVMY{un3w1
zZ)X6#z?1MFb)RFG`Me|K)#Z-{pE?wq1QTK+__=VomkXRJfCzg3tN;7|^BadmA~6Cy
zLchjMioceHWF~<9?=D}&P{4mL4L8T+_ayO9FuYD=Mu)s)Czik>`X^#0;qJkGSO~<+
z-zK<Uit4NcUBaE+B1ad=AItBPR9y0M@cc>o;HN&p28aGA?LbU3_~9eDO^&!Bet_2F
z`nXCTK?L6w>DXmRXyc?N5QZ@X%l`%!X$N7XK>}V=#-wC`negrP`2+=URnB<hI-<jg
zwukckK?EZBeFdk92L<NGlR7^yVHOMzg03Sy=Yv1V%0-|_-VoekFU4bJ#zA;=usJNp
z0G1fn1pYGsxG@f*sNDF7X%dJ0UxqOfVm=b#wpDHHH5YU6M+_n2HCd?zi<pJ@m_>?#
zXcEcOB)rLskD`;;o}`4Z|C-y%01$J_k~mM3Mt%GzlG0h@bUpETS#CqAM(hw2OM<!q
z#zz+e3_%NFW-6~Htq?fAI|NS&Xp#5}^T`^z{|-8t!BW9F0j@K{cDTvM6X<=HD9n>G
zLl{>PHx5GxxE)q%O{?V)9Eu{|{}oPPz+nRgyj`9|cnxNJUL${C*<*yyl8ZsVlS*;#
zbOF?uTfLOs^2%msq;786urtDQBa~3$0>Cz$FT)t&Kk(u#X9HA&4Ms>m;=c~LawEf^
znOxY&!J<J2;$ehCniO1~yXSp8F^H}b=Ok!M7#e;~Oc-V2xY#%AlN}vI{t@UU3t+-P
zfH3coRz@JX@jg2nuf{^~zJHS-_zKfLCqfALf1)`E;RV_y=48av6%mAad0vPRa$+#X
za#@K@VmY#?$-!0T4#tE9fz?Tk98!%mDs@~F!?zu~4pWDbVK@7@jbOqnms*Pn|Nr45
zn=spve!p0pJ$$f;VT)aSS32?J&qsKVg{|SFmHEQ~gzXI1&Lb7q6M$jcX%M{ujcPDV
zQpoVG=}b-;<lB-VUTk7B`F&jcly!;WK4;B2+`|>b;3oTkjaq%yvTXbWd`%1!i@az-
zZDGWMh)WPJKpC?m4Lm~Sd{2(k$7wtKFC3=jG33uQznzKRPA(nu6k+I-9?{T)m+4$o
zATc9D4<iTqOwE~pEXp+p9N8iHZ&>ad(aaz^qnR?_u1sX__#v?iFQ?|VHYqO+cp<fi
z<R<YQ<C>#@e&fv%e|T>#{LzuC$Z7CN%>)`@^3Vi$e1C|W21~CJUy?Y=gX@#Ku1sm8
z`>=vE%lR<Wn?DiaLLM}kx93wk6^U1__cKm^<ehqQaZ-OEU?G%_NV-psxUL+=NDPO(
zQ%M{R_sZqMQ}4oWGFTD&<G9bl9DLcm11a5<Hogh81tU=N_5sW0(L>BR_YV?7V?P8~
zNBvk`_g|ORBDgHj7)rrbMH&bS<|uDh_79eUMbh%}KzdT)2>2m3@qo2bI6AK?^D&vk
ze6wK=*w;2%6k*pFF(Q!rLu7@B3D-^C1NnGjvx{9<Hei4?;sP5S%){{oAbZru(>b`R
z9E|aV&R*lGI`fa@_Wz6Fs-9sm!VOQmnT-gX+?jrGo4@`u--G@tTcXLIh58W4g&!iC
zxpF`y#!EQD8J*AmKGgwb5P7D<y`PShKe%mx(a78;8~j!u)UFU2738wT3lL8mKwb&4
zi^LEeV-@dQ6Jdyjm<+!m(SzNU#ZC}oVr~wzn-9Vq*A*~%VEEu1tV+ib_eYN=7kJnt
zTGC;OaDa*v9L(3QPV+NOa$}5BFLNoKMtAs_rdZHIlC<!_<H?K{^HsJAFPb=2Q_7Re
z9U#CbXX5Ar><Hih832P%C4?U}2y|RJytvCFo!=&JzG;{^U~_U$yu2+^oQy_|U;2nc
z45^y`-Z~&iHISbbge*&o!!pH%1a56(NrlagB;dR)C}wpR|6e2_P0eBf2LbPsHRFUn
z65=fGU4A0Q_?-MYtm~am$KjNxe-Fe<fJky-f`9t|2%ND_@&@1I_cixFUvpn`UqwYH
zC5}FWT)Nb}O^!t{(wU-DIp5~d78>Q-R5ir-=m4WYJn`S)yF^1Uu=4LB*Uc=r=!`kZ
zI072mkXYVG(0cgZy)Pt!14Ue9*uaV<)yJqiPLAuT2mF}0tpA{Kl*u?>Vu;dWxHVSh
z!{F+LljY})b9mvAc{wt<W}PeQ=}z~-7bH)Q@f;Uiu~qndPU+m5;<z>ZF7n;JA<99B
z@g5`ioN#OVTxYp_@AAi!8sx@K5Zuhsnn-6_G{43Hp@3cyunM;oAOL7Fq1o%sY;YHR
zeS;gpM-Vno52(5UU_S}keWvX$ZydO~_rerZO}2{La~v`tNf09m-~pMw>#P6o`~WMX
z67oJnu}B|=xSl$2-H0n0c{Q(vA;r_cu*?nf7A21W0M-;H4b=>uqK!(ya6MdB54|#_
zF;ZjB_D&`eV5@fqHt_6RD(|uy+TfBhCOB8FPY$Ia`K^R*9jU4SVUF@}R}5SntTKQ+
z-uv!+MW&KK+G(3VcBMTpbUD;#e~G51QWx78nCiWK4PQApCFIVL62msWUkG=aAZ`-j
z*9*p)FxH2Lh2cBc+hN*&CQSS%VLaM{v6V-YRZr#9l?vp?CvgHufd=uS_Yfe~V`Ym!
z5F$Ii@8p_IX5_Fm<3c~I7r_;w!>gE=-;aU=n~8!}yRsEZagbU(=Rm8LKX+(=$;100
z4E5Ihpa3I8I>0_(jFBpY5%-sO%N+*+fO>0=+Nfi>{Nbq>@etA%ln2LICVu}Uq>Byl
zJ~jmdrzWoQv0{D9FoqegFB6WS!SgRa^Gc?0ten|=zua*rPNse<!cm$cC*Ug1tCyRe
z1w^^EU%M)>$<2Ei!(m9ABgwEnKmZDn(F|~%6UhrH1O%MEN%)={ZqFKz$#|G0@b`=&
zZOAQugiXArIGzm?_$h~O@X?>>kLCvswMD;udby?q0Ym&pg<wQcQIK#x`_l}e^eqG*
z7a9l&pa5^inD317z|brLMH#~aN_~L_`p<~IP8m*CPQUu)UFp;Dao|gb=E26#!ZIlH
zjAoE}ne%W@f;NQ2In^iNZc`RN88CYtv*hvCLp!|M!(5Qmj#ALe6IX+dDqqQ+aTw?$
z{oRIM5Z)Vv!i1#~>RZ|)1UgTRaX4}&I@H9^y3TOo+iz{3{=VCPmy^U|C`L^29Ce{<
zMzx`9M-cm{qj)Ti8SelCvXUlm41bkzo>>7O>a+LDX{_j@!UF?Q&b=A*ADfMXtpT1R
zP=@;SDb1!$!`<@3>)#b05FR@$h=p@Th9}L<uyK%hK1~}n@si6#z=Ym_yLq@{z$OKl
zN9+Z`v&_Qao^SvRG?W9wuD+}q3vn3)<?16Fh>3)JPWW3eV>;&u1CI-xd~9dd44UF~
z#KQr&FcKK-zD{t#zpKE3!nQ>aW3cVvGE;GqCIazXCk*P2N08zn^JPHneS74t-;2iu
zt`55hqF($V;K%%!ZcKj@gMmM;)%BQ-XmyHUmju#_$3i1D<?z5*M&PV8(HP7`Zwu)|
zNzrIvBN^@Zd3_d$R|Jv=hJ+wQ?<c3%!!hwQu?0x_O#jJfJ=S;2ryLR^aUi!td+eWx
z#>5GRaWnBVQMw$E$;49IL)@5>YgNn3CWY{yQH0380=xoU5Ar(dYnmQO4?GKq@feQ^
zf8&1t&%|OQA)gcYpB<5nLGWoPe_SOsVrk?yg?jD677uWIT+h%RGh=-9MH@Z-`FPfO
zIVL!{Vk^*R+}w#jJ#ftKe<vo2X?wmnu1erT8RFrM$b7KOj%gyyFdz?;4<#q?SL0w{
z9Y}3?>~sn`1h@J~h?~jr7?6}~6hE3(h{S#)5#l^4|No8jCx)4C{xtN{ctgS*L>5_N
zpa3;VAdBSQ52odFVI!1s!y&x!!^FZ2JaUE)7GlBcAAn{5<kL>N<?%djGf+Dq^j=9J
z{o@hc@^sw%oSOz*7+#9@W<;X|Ul=0!IIGcF8*F}Fe;LhPzXkEIe7ykZ4I+jLj0@-u
zq!<PM7O)g;b;6Nk&crH!p)ZFY_%5~SBI41>fFj&K6@N%<0^b(;_<K|?elf|bJUAfZ
zpm1=Ud<@YfqJ8Sq!#IpZVlbWn5u5J2ul8`2Cgb`1{(r<@Ce)Bz_5L^BI}dDZ320JY
zC46xEc+GL%1g&RHp@df37G0<WeY4z!I0%0gr2Zd)H+(eQv5^=t<i_{?;;SNaW64}+
zG{lH(fDB$vK?Gm`6UiP3oymSnBYYKQS9n7}rdXyO6ccGbD-t~pJ)a0IYlorq8-nr<
zP=Gjbf30``N)~XE_$O@SKv@PyVkE?8^Zzz9Wz;c~hkSHYENBfY8qf^_0B~#`{m0Rv
zJ1EY$tZcTf6$wKEp+<xyUglT2bAG<W{TcaTrLLv1sEi{Mo4z{Hgn6=`d{;Lp@uWzM
zyqO~^A3a7$J!n54#K)I`$QXx^b1*V+Pcp$72Bnyl_<ywd2S>llQ~(E?urdqYD~I5L
zwlwz5;p9~xj|1thANW_pFyZ`k^f$?fyhtJQcb9?;=?VY=<q#ABXh0GJ<FY@v_}W>+
z0cBSNn0HVbLGTz4!|>Su1lS^Y4p1QCsj>d{<^O+*t-Xge0+ATr6VC}xu--R15af-P
zaKD7}R~u_j`<&F(h~n{=-&7m|ss;XO?ScLikkbJVi&#e(jS|1Ps6Gd%tbZ+Ud?%`T
zqMo|FcaJu8%_UoGXxjMxpk(|p5@iBlv9<^5NZyx!f<H6C*PHyD)yw!lgzG{B#IIm~
zM=_|)d9Sa=(EQn0$%vc$n<Ib8;fO|w!dPVk*x@B%0Nf_vB80iS3~pbJ#z10*5pRIr
zV`zMhPtO83;6D_Y#i!K3Df{6#*wy6{ESMhnyHbJ!<58g~jAtLRl=)+Ek^}{6poVhe
zzTyS;hx_I-U0hx@Io~S-9My118ZMx5a`?&|iS@k|YpOKRCIZe7krp@r%GrKgbjS|1
z$HT|~&mGfCtI;m<hy1oUVk?{iHXyqcG>anmPs6uh*h2i+l4p<Z9qV+lO?S=b{tA45
zNJqgc5~2y?rce%mZCu#dd{DrU9suLVY$zky+PETWrU_hI5b2e$ICIOyMiMD}eA)WH
z!Gt{{8{&pOk#G_5LrAz7dl&eAfKGujhfo|Kb(yhv+cv<TN(B^vn^O!SmUxJa5b{g_
zGzN5`u5DH~l4*YvEOyN*7w>dmHI#g(KtAqve{+Tgv=_lt30vsh@~wp<;lQL26N8|G
z#^p2zkL9YI+CD%U;y6ISxBi(4C<0O>oj(Y0!hc<&5%6v87%}9vBH%=MxT&MV>E-Lb
zFF-MoptLvyG@n8R_CN6%qCiIp`2HvL&5V+PE5L7se&YB_5HJo}89@vCBel1FR1cdN
zF<mEz=mu!nP!2HS8WDi$<pdQ;8G+74{uty^%@ynT_ivY*8F^_gPHr|01|YvTO|cxg
zetr|vw;U}$n~&uJ4)aI=8vW5Oeh4EEA2<LcU9zG~m0`vj6Is?6Nj3)IfAHsbSY}A%
z|MJZ*@Sl!|W(l;bi?s3t0mnc9b-^u$n#$y7fco*E7X}H74N$|y!W{%b9_a7ndyRAh
zBKdxylVjfxLVh;N9>;{vH=)4nId#1v@WTQSGf()s6bP7W<Ni<>e7uC)b9_R)zFrxi
za7nX=Yy3FVc)lJ_puylsefrZM`6fzWP$zwg@Ao%%{Qs^CJZyN*LO2+RFFjx;`}`{T
z{a67v_ry$00zdp8T!@bWI*E*05&A4||DLfZ&;EMiQJ=m@=okjIldaEphnGar#%^j_
zt{TYbB0Bm;gX5wwNy+7au1v_U<l0om@?L?AfJe(66kK(~vS1}_`Gt4~;iRYIfME3?
zYB+rkh4OJ+!O2w+V8(z~$I)FcNqk3@mudboj(VIJ8Ur+-bj;bBW&|vtGfP0Ln>2L)
z1rk20&LK@bO0>~xipTrk3haEf=#aEPdGX&Nk%zBw67v|P=HqP(eBxqZ7B2_nNJB4M
z%g_iqyk1yxf0$p#bHT%C7MUIQn5g;w31ko>tps=H<IpGgzFmvvu)-EJ5-@K?iZ_hx
z1_^uy(2yXBfc0OcFie^-CnSwN@A{g0a6tH+cCWmD@wv`_KPPf(Epk$gU(L%J0)wW&
zUxH}pg8dYGI7|)Q0T<W|yxj1O;FmAhXmP1K;(J4d(ci}!2$2_}xGm+-aNw4AlB=%0
z^G3uw!2;m}`-}h;K^w4t;rzaJ3!Ajpmx`ootX~DR+LUk1_w5;@R~L_}`2K9FP-<g_
zjgeVA1n|%F2BrL5N&L`$r#$gt)B*;Ee4#i0;0R4S)|vh@i{Ou-Jk*X5U~!LxuSJO(
zkpCUvk?9jbq$${f1hEs&LKk(X;wE}n!xTUJ=dS$HV9C!|lxP1P!%fS*^b~eHoYCXI
zGs(-7HO*jULdw4_0OLm2@f;CKi%wU<e9`8Ne<Wv5f`0QfXcjrRDwaIh<7VCv@H`E`
z9-E8Um;~^)QG>4ZA(6NFBz=YOLotf|@<u%c{L%p#AQ<7Xck5=-?=AibbGIz!Ii280
z-^q=O_~BHYcqQVP&E~-FbpIC)LI!m>;b9=XJm2Qv%tCPo#qgg~yrhCw0=J9mnjM(a
zB}}|ub`3Jfk54eg(%vtFKhrtX*fHjh1s#|Z8)iU}s3dRka3=hRn-fRox~4WLNx#Q*
zK_d(5!K)>URWgCm|KcN9HDPT~*?%*_?1NY9y)$l3YZ++DUwhBKDmWl5NZ{W*a`JHU
z%*o9`(lal*3~*&!ox@NX`@%QLQmr}wBydBKDy|47z7vfPnD)^<7rEQVaXhlJ2hsib
zajJT}ynTe`l^)wn%rhD@CnZOQd?7u_9RZ5u)_D0Wv&+khtP)~jZf(d4fV|owA&6v0
z;`x5}8`Ut3;$(-$&5;v{=ay;4M|nGjF0;xIzG@g@(bgskxw~nGx$6ue$=wg~+n;CR
zaiP)Epo2)Rc#c`K`>Dih<>2oM;Xgi+5-Vosua*{Sxx6-sFN)5~elj;uL%B2M7mK20
zT=0nG?1_Lv<(Wr)diifC7P&IbxBoR!WZ;s2WrBW4<?ff)2{>yFE*mPAB^mv4Yzj$v
zCVpr6>%-9k|0Hx#@PFKfD~RhTju7XCTHWj#?wqDz-<Ds;^VK;NBK6B;k^>>nC!Py}
zi<2}48eT#U1MiYSA})oA;cLrC-~?}|%00=EUz>(5lXsznOh2}~IEtV7C5@Ftc#OPP
zjSXg1w=WmWGWs_!CUz3nCiMv7V84<_@!Szdf!En<<kM_{iV(HS#Zoa{a+j7EUw8aB
zk7KCO=ZF8x!fqXB;VmXk-Q~o_@SYmio=o2?k#F&NOimNW#4_t((yc)5Z4v7bKI?>?
za{G@od{<a2n?cUMzcwyRt{_ibCn#Xfl=;WwJoOzt`Bndknwva$XRMuGUapAcrug0n
z`m$r@=8f=8DkdC%BE#|DEl&(15r%m=X+JIBKMmyw3MQ_$*^e)UI7U2e`3@QjvW*B_
z+|x!wADX9xf<EYqqc?fxdHzgkf0m~;le)g*CXzjK<%$3N6!78zVRTyqS`7|^Ewnrl
zJYLa*1I`>|_O4z;jROdrWJdU|;~?#0aHm!)xOyxX&BAn7nF}h2<i<>LM1Jmz9l>SO
zr<>!+S#k7TpAXs-L~w%CSbkCG`hZZ_rlTf0*cbUEO4};r$71ON&Iu~1SOxgGA+85+
z7*nnniG_J8hl4(^7ZH!*>dVa-%uEQJ()`*tl3b)f`sb+N*z=?RSB80JLy+M)sb2f3
zPFN9nE=XkIK5gpK=C`(fuk!Lj73P-p8Hs`GiSe;7U9!L-8qayZ|NsATY9q-Fx8|Vl
zj%9T2La0<wp+y701DhjWlWJXn9Wma9rcuCUy0dVU>U6b(2a@$Vj-dhqLJ~$5;$>r}
zNR=ApDMC`5M8!o7F3TvFeW#&W?X;q(?>A6ejSJqYEK_?dbzM@_yeVf-6~d=aWu@*t
zt<j-n?^DrNV)iX+!i7FrV%tMOR2ZfyMX?^J1uozX+*pqzgDtw!Y)$BJMprl@Gyu>M
z0c{~51dxJfCQ>kJ+e(bS_-?v)Ayg_TP@;fjybJ;09&vs{&%)}fVS|6#|7GKr-$SoH
z-TkXb<aGQrT*gJb8q&>~lN9g6`#)nXba>~>OFg*L)BmZlB=t)tw`%jft&M7`s`j00
zkl}o5THBLWub9tk|8lVc(cyaIi!Mc`6XSK|SQWlYELOY=7q$0^(NMj(AsWaEBme+}
za&ds658wa*001hearyj)=Xd5X`|2A|_}$)gGu+3Ezuxh1TnhdZ*YZ5g9JmiRoIP)A
z*Y)1J+j`#Lt><}9KcC3^<I3`R2j0Aguj@U3SUs;_+xGpic^+TB0QSS%^^a-o9=H!%
z+x5Mtwd?ywv;)=v_K$7t4_pVX1KJN+>w)Y0KnJuQu=T<1hps)p;sNb@dv|i)X3ry$
zyf+Wv^}+1`KZNzYaQ2?j?StDre{2AH&un_$+jD-+{H?n;?A^%N-aOzQe>=<r&OG4c
z-bS6yIdE*&<?baYP*K-(uRbUZcBSWCVwqVjhbI1YacRWmlBnG*DL6)%DCJtng+Ng(
zvPc;fvu}{7vKK{@&eviyYgI$MvZjWfcBU)7!niZK$tR{stVg_BX={O;o@8OJd8&)-
zss^f+##4u|iuR_rag-t@9PEl(Wp@F(iK=j{r<;}bW`eewWyb%M_tJUSziiTW8Zaxr
zSQhZ|a;-dHQEjz(y(~A<2tJ@q-{1cq`2W=Z+N0ZTt6U*wb<H3;^xM1)x?SnW+qjM)
z3=OQhC|&>V_J8&M)4j?)g4XLq_b5F8n?kq%06k4XnxJ|NcYEV?X}B)S>@$EhBp=|W
z98dkQa~d3+iqXIP^th$gCE{icP$PY|Rr5^_CxquaXk$ibsV2E2_IfB=l2~~DFC4DH
zym)yqKg(&3GA6v(c_Y{{94#Iclm=?$;M@r~#VvlDweCh&1s*?^<N30|FD#bVh?AI!
zguQ#?@Xo)mYPJOQJfHVJ<m8Cw7s(*`1~z`<dHhE%VhtCT<R$rhe1AT@3-Nf!|6tUM
z#{+O}cp;65ECBxa`)kTfxCC&(PK%$S*B7v(=_P}4$8mCo1o<ia(Td?M-$~(aT)$jQ
z>^8vA%FBK$n;BjRcuQ#j$wCOUL!XlS_(p(_4ZGu_1cTQEl0_W}{#yz$7Ba+mj7MG4
z@J+W^^N85<p+_F$zymQC^KF=W@%Z>bMu2vLpgim&%(?^cNswJ9003R^Um6FWjg5a_
z4@LMNjO4adR{XTlHqCHN%zej=-(V^u9Cw?SdM|O9u|@EfaRIW%Zc+ps6kgYlhS#5y
zKq25%$;-6WcPwaZ2D^?N>}I&C3mAp7+w#y;Fj@)VlgCd_TwN^n#v*fZT;96*Y&Rgf
zprp7WhtOF4lb;m{xLn#02EH^q|C)Gl+!M+gM3xzdd%w%&dJS-0&ADOpksqtc5sMe?
zH&%`2-9MVC=H`*K=j+wYsKq}mYd0-fYmc;o8vr~kZcWQ+8>`<m?fxrsD}W}-GjGK4
zvk<5htb9d<C@|o8Ukz^06CWKPFwd?85`p8uspPP38HU2~7tNmL{#bXf;Rg`|2<5Sy
zENIa2ABe-ZpZFq~91~xbgJFyvP9m<Cl7TidEq^_HaES4)66CNMLI8||#)P`cZoMQ%
z9p>2HH-_k&m=3?gbGh)J49jN%V8=uUL-)&*^35K&P7?9zo&#K4Y#9xmcm?7mA2<LO
zC>w4?d+u;4v8V;&D3~129lQ0(w;daw9knSG15M`WW)K({&?0{y+8ziTW!C}N(8Z_y
zSiUZ0A1e*{EQusa(w{YmPC59k6=-)S6>7QT_(PsHu4GllWzfT1zE&4DFV69uUKZrN
z-E(7umzSE|ll$_(yxuDOyP^CeFbP;WfCe6xicW6PP|JJr&<sBeJ^_j1GbqDzncN>u
zcXOd-uJg<DNQGD&oK*GX5zduxML>qZfe6{^;_BtgD+s)taM>T0ozWMUj(aBw>^SI#
zAf`T9xR1x?mY{I3)Lhd1PcCuM0z7IBa%ap*@t}JSa^3aE!;kfMl>Qx*BN;iiQQ%QG
zUasy3&=q_qD-j$euxt&Ct1eksVJGtBg^b+3bsp}(nO8L|xPCs6$~+0@YzRvb-tcgi
zJY&nxVSKk_aK~JeT)<C+VZHmH^MnI#qp2W(y&*WRRpdBiCJ=SWu#Aqi#L6IMGDbsj
zH*j^w_@6+qM_ms{$b1lMgfRfxRd+DtzUYuy^`NxBWO+Da;Dd)zX+428jfqTvsnovC
zwDb9TO8Bg2{t`Ch_`4F6K(M@Eb!Fg>oe|i0calxvu3fugd-2l`geFckr;Gu?{9q<9
zRJ`7Q<;Jns7buc^*p~Tu{cvBrz^x6}>Bq^B8)e}O0%#B%&xBvJslx-{2Lr%$@!-7g
zK|mjuj|T%<<f}6g#Kz}Xr^ZgSUN3{ZJTn)Kb9pP_C~*#vPz+ueb|Zya@7?Jy@w;`H
zNVEv=G;n)p*zb7P1J~r5ckb?oKQ`QMi;~%Y;xfx&L_%MNa4d_jxp@Mq_^vyb14fc$
z;=Ljzk0x4hH^uR*JsSO-0)GUaU*8v|(8ygNEW(Wd0RAFS$oMv)_+~5>at{S~2MJj1
zfO^f)jI;qX#W55U!ai;P{GD=5PCO_7|C5`STKRJB6hA*7(`={j2o&R>zsbbThJcKM
z5V1}j^Kr9|PFtsA@?(dO;R?~A=Kui1u{_~sdkvun2ycjui-B?VGTJqtzmr7u!F0g@
zN+`m}00M%L5CzAC`b-e$76#I;ualQ1P)m!eetw2tIxsRS1P@`yiPCrg2Pvlk|17bz
zVF$-{hrl{S*eLTOfRx|?#!bF&E_tEer(-_~&=UdzFaR5?X?$#p9CgVd$;@T$KQr_2
zS4`<>4iPt9v)X&%FAQGk0mp}AURxV>KNBj70`TMwz6fJsg95ML7eS2Ia1wzaH>qI3
z@!3!yO&VBpLgxewdmHAOU&|Wbkq~pM!aUr%r{ufZ#AW2i!N86i7<8N=L1EWQwBPAQ
z#1+JsERk)8T$kN(7<%D$1>61Q-^qx>_a6ckmy^Vi(tUe~#c_Dp<+2<yyWG6c*5w{i
zPai^i2$l=qBTfJT*b^U@I)T#3;Q@TR4mL2?BxHBMzl+Q(GQsGvxOdgZf+)a0{l|tl
zVhCSy;{G@6-N+-anp+a0-*y9uHYLG!z-SQYg3cHl^>Wxvo>(A=#&XiMsw48-vPI;}
zwvWfqi6RQRc;t1^G)yu$p<Vy}HFD@KBMe<<plArET!Hd&9LvRJ+;C)Z{B(KvBd{{f
zaLVB(#A^8X_*vR@tbBC(MJ&cdL~D}3@a@w0yzrP;9!u9JZr76VnZ|MaRRf3fLclZD
zgvqWMaqqc{;wFCHH&V#w!dXY<2oD*Z_b`8W9!@Sp7i_`)8c#WLXKNO?dyfDmYoXoJ
zLN`)5ufIqhpf}6r=k9O-GXMZkUi1bsEFaC`rP<;%27j@hEZA?!RM;F;P9h^OH;Ug^
zgn233u1j~Qj(jqM{JZD#aGdEF8x76^J0=TK^7kzb$sHa2KbFYis_+1@J@VrJj_3s*
zH?lGIhODs60DcmrlU!<YkvL8=BfM6dfB}c@sY59pL*((11zcWs?1Ss6W6R0V<9hjH
zpcfzU)nbkSHbBC_yc!K1{+K_)a|Qy2!5$LeMY=yV34#fRdd4kr;_Psxr}_fzQ?<{a
zCV6PQ#6`<r!5-JU5k=J$2jc52a2f_`2J+A!;^61hvZjwphGfcr3QiKk5T-V(Mx1r3
zy(@134cxYxog$hUnlFTO1dzz-#2F#JZ{RxREE{^Ayk8)_GsTrHtB%RRCQV^5eK7d%
z4IsFVi(m4t1GSc~=s%9KDlB}VEH^Miq;L|%{Mg_j&=yWyxKmj<dP$Rnw0aKMk?Kw(
z#$!r#fv889x*kSB9|=-Ex1`bcK}-<6yZ`+)NAEA9A@Q*Mu#CJBW5+%IGe9{*W{KnR
zp~Kx42l$-z?28<n5_s+&xh$9%zz_`s^3Mq%$lSJ1`6XC6yNnP8i}<a%7v-<J?)jq-
z9iW8cJ})#|rZV5h_jE={u1q)g@SVw=LmH1dNNyZ=Abb}_L?vC2ie2lB!%6>Z1dcWl
zk)iMK1)~9d)6IS)gxRnMwS4_0)oH)RdSMg5o+k7Ikbh{@Fu&64jjDzZ^aW4iFimyN
zHYx*Pf)Rc*$uEI%Kk*dM5}?a|2i}7`{E&s0ClGZZ@qhRwr*sBE7w8Rqe^IV%jp+aw
zH7NtT<2fT*I|Vb%JuYu(&#E6EZe0Q+;C$2mE&~62omVE!m4M3qa(A{v2pHW1UJ{%z
zSBP=(1=2htct^x>&;d7_inKXEKM@)!`$OkZ=nZp5WP9Ex`_2#(h`1_V6PyqPY-pgU
z49DaNkAlT;jf}yj*eb-?22v$@AWmp6gzN*nk0VL|0pBEaO!Y8=e3XkVa(6D1miL7^
z^>RxO;w0wJ4R_?|{JbHL((pVqhvnCSH3NYdL*wzYi!X)|1$lEPSH4-&Fftr?r<*C$
zDWQ0tQz4WJ32*>35qYuX|KfP~>)kNxK>6<=(Zp+tu%5qp!2o<CIGN^(D$T5>oMKdq
z$v~Pc+^5C(=sWBL0yW+du$2LUH|~>wNZrBzI)uM~{-_I0L&q#lU-1|v`L#7}111du
zNAzCl^*kH$aefF}WbHcl7nu0I8EKKP6gfZE`C=i9%b3445G=|4q3M1KC1Cl6S!67?
zx$$)^RJHXj3>lfk{w^@xiS>+)$T%3x{}jk*o-d?kfbFuxyUWYxTjSvdxZd-OB{aaD
zArGJ@cJ!0}5baITsegcdNPeS(AhZXe?(PH!quJhHEut%2O$LT^J%LR^a#gBc5RHSt
zco@jbR&#;27#TuKgAAbq2>A(wJROK#!)|_0UlTI8C#8mu<mA3*zD-OJ2leROOcnPv
z2SgV@mmfni(ycPKd4Q;had=ztl+sB6@z8>FHcM)wUVbu+$jlj_DZJxa2<ao@947DK
zXD$3jV0ppLX@CIW7}&TH_mfim5lcbvawwD^e6(j|!2o|GHwtHeG=YN*we<mb>jyzL
zxbSdCK$S=z5nq1@=rWyyIB@9@A3>==^bgBw8HFEwF_~r<OP-ILK?{$;h}(tnV-m3q
z1%5U$5zmg%Kv)S~6x4k{dP!huv59a6$k5M6{qRx4mkfs4wupHM7}4L=)Wg9C4JWFN
z68Q)Zfgz|5fO*ULb?f%deU$K3guGFP$Xn2bvg3Z5Pq)NF@7*t}{q|+}g?|y^2U=+@
zqf^6iV1F$64|`mjG?~An{3|1NZm?@x*6|Oq#P8|}+!z^rVA8I4{3qZbfyw~Os;r;>
z3M~-WGmIR?1M5)L)xJKL#!UK}&;T@;<7sPv+DvHgS>|5-{}%~8z<DGmrM07{ZBCzr
zZ)gwbQ*cj;haKH4z=9n`!aN$`pTy`4<)u_T5Bs-nPH940t|nA6h6JoPMH)Q%v+uGQ
z4F}7|#a;O@?!N22<{}j3^1xpaX}@X1oF`NVHYtPlyqc&-@%*tUqQTu99gv`G4570j
ze*5wK^7CZR$#_5*0viBZfF$MK9ZEQzU*MuX5KqW_qknu7*hMr$^HXvIa``AJbK|5s
zQ3JTLp~Ap$46yz?z$G0D9?g585dfZUVGx<Y3-FEtM)(i$07U=6=^vuO0ylu{a0_L2
zfcMNndOfswi1On{!$1Ff5O5ZN0nkTW6nGJ}mGlTd!aL)CwihRIE_`P@0i--2N5fb{
z+4S4Xaf3z2g#RX#AP;{Nu!C@az3-Qw=UnUJD+qXEP6)N2fc8EzhI?-a89_YUi?^ht
z%_c&Zgx|0;Kj5PctWR5GojIomsB#nL-I^|Q|0k?X)CQw1rPKJ!Q}hP>w;$R<Z^cf(
zlohmxqrhIPNDu$$ZT+AA7okgq+VGTu0v<t>I4XUCgir7r{Fkmv$)5;x8R~QoY&RA&
zcpGbyM>~HJN<IH=uL;?}84JNN*xOt`N@fsAZI3<Gl-l^|?jP|Mf-1rZfGP?%JBZ?X
zO;T7m;yOk-gS`GC$+IEw<;P?BE<{Mb6V3=vMBrso?ekk!7s7Y25k?dWJSTq$XmcpW
z!R5<7APet++F9eQHUlV-MsI-q><IVBb`0;-AOC?dwyh9{NK+(fO#iMN<C%zBXL^&L
z;qKpz@bb|d4GNteTr{Mttt{nN=XAyW+GDt2&R9pE&-g;HjwhiUoGZ;Mdz$jY>+nmt
zkK^h_7Hi%8BKb28C3=zIsU00!Czs7T`3W1fartcyz=Y3R<EYD5gK$+DpQu0I+4>Ox
zbL)VG&IVpz!8M>lzX)5f&UW^AZMl9)g9Dup&1gQFU(HR1Iy*JZ7`^lI^+R0S#=!&k
z=Eci1c%YyE{(iAPb=wMaYJoqC%t5`UOU;;q)5!U0Fggt5!A|^aD10YiVdd878vvP8
zZvq>V8_m)3@Q;XdJgfr=09VP!KtcSx5I#ED*CcRawhn7=#o9UPRb%55@SV2)5U3Bc
z$9e&Pc6<mxC;9{YvPPy~fg|V$TCoZ*9=Ws(WDq6e!SUG0R2mtGA3pLUeABuGxeTcT
zfPYQI<%#hUW|4m4HhyjusT4yKcVp^B(bwe<keWODQX#ajoFGl(r;iQFL5~kqtGr**
z#0{=K^MFL$1^F&3-v^|D39^6{+CX0X^cRGz5!Z?Yd%M}i?tsV;LS6%>pl^hBG5bEq
zU{gR<;h<<n<fT8ZUL8f;{M3k+gb8@ALlYqkB`5vLMw>`25PX(#S@@aBFC9_iz|gFD
z`S?$F%n;1~2}VU(2W9C{eFn{5Mc{+s4I#k98iH_j7jTXpV~j9}^*VnYn%GV(Iv7?1
z38Mz#dCRyU$K1Rljs^lyW`V}#W2V>}WYj)bB>QXlt`p2D9v&2PEjKo_-!z~Ar2idB
z9huH_ls9pdf5-Gjb7kK+!yGAip9dIE;w<ulFN)GZoqjV1ORVry*h2u20Ap+Zb!l;<
z!(iWue*v)>->5tH5Z-{kkbPV);f(yCfGb8o(g;sq;WrP__;!Fn7X(;|1P7(KLj>fX
zKyrJ0^(1-3;tl5S6E7uqHxG3%eL4WdPzd4!9vFRp3qhwJg1!iwU$@laU?yw!&{vRx
zeQn*9$L0BxMS25z&Kuv<`U!zuAf#4g!3YSS>HL&7*0>A2@sW^3R?x>OtY%ltP4(S<
zc+LD}!`5n46ixv2GX?$wIIz*5o>Ui(nf9>S&esY&JFRg%VkdAw9N{I+9RwzpT+}~#
z$R#x#op&@_|NqB>AZB9kJ!|j1w^FJDZ4sN6+Pg>)d$zQ8tqv_kKh@eJ_8vv48i`m%
zD={jF<mdalf8BG>{o~$q?mhQ?U$5uu@i4>_5SDrWeRfr&($?nLXq_MWSy_{aY7h=)
z*O<|`VV@(VFJ=P?E-G>;?DtzvKHtxAB29LXvB@Lef2Ya=yBZ6A06ar$GF0<*f866u
zvhdze-i|dt|2ATujMfCuQh4i7Pb$=0gI30ymO%QH#Zkc<<8Vo`u13Vu3B`iE1BnJ%
zv`C~3NIr4Ga+8Vx&kK{c;ijT_?F_IvQ6{~bVR!dN?Cjnd+wRXXeiIwZ;`RoT3;=Y-
zMajeu6y<`VjBIf_v1}^0Q{p{PqA{304VQYsQZGJE`QfyP3!y}@9wcw<5P`nRj;t<g
z(o_CFEkQ_(L455Cs%N`j?tJqUyOJfuMZ_nv`1|25Mv??+pN|x22;}uDXaVVm(fmVO
zz?7LQSG^A=3?asTFUd!wH==7e`EuyBKm_KAt6V-M>_yKc*Lz<hoSrZn=1;RAL$2F%
z_;-pi9TY%7Rx2-jP$2s->?up4jIg`^dE9S4D{$<hA?v0KF7Juyxz1<oKl`U$xgHv>
z8Yr!cY^M|0-_@S9g5QOPcNr^N_NX0DsjfRoiy`B-eJV0E6|V;K0Q4-d(7FC1Dw5HM
z%ECn6z)JN^RG4yX;Biz0V?}C+Sn{hry8XhFdC>Ck)Kqfow{FJ<<qVALZ2>_k1@Bm)
zG`y$c24%D#UmC$Y4F|}0$X<#QrXDw%yL&i}-VIz+^H&P4c(+0iwH_YiAGMiT4%!Rq
z7PlIF9y?z5_rVPJW~=Mi9rDux87^!}S?ZlLh>!?YAWE_+EC3Ei9_gQ^1*ZO^z&RAB
z2GW^jqNSSl^gM{-jwnmkE5`SKGaeX903)dRSabZCD;hr0MTR{~Uj%;1vSAzpi9nR@
z!d|4p(z4UKf9TO_VJ_>VEQ$B|X@imquq!lN1inW4%MU-d;1sSxez`;ukNbCi($=M%
zA}IkAyq&(cl2%WGKMT51CUXDf3%!b;&}d7!SCnO*Mi5d@*9+glLB}x&uJt{l&=Q?m
zR6GRNz$EIdZ2tAtRE;2cr0)!sJm%qyRqp16POBDEU~Uc`m^pL5h<@_)*E(eZ<r%*x
ze{;6>@GSe5evJlvmd~ojXX6~zn@N$PQXBZfwYO=SFMOBiy9q6P)kpm^xlNXHFad27
zVA<GchI6io!b}2O3C;s)v}5<l>!sNdER!CxoUn}6oM!!%htNv(VStEVVJ=N}nl@>3
ze<5>K&R;a>BNdf^IjRI0=o+`LcbPvSCGbWbWP%`(j){;MAT)EpGEFVPL=l_)<_2$*
zg5b-BReT%om_A+9RP+}eo-V<Wejn__%l%|Q_A7AopQMK_r$1IEjphwLi%PiGs``8m
zFVlP}fj9D0(6U$hVCXSQgzE|a=Az_sUDevD52osoa6m+TFlL`<;ch@7o$g_a6quVl
zd`Z|AS+zauo1NwVUYv<B6J}?B_NE$=$31~;c6@XZJ~ib3CdSJ_hY1nPePHksW4cZ6
zXQjhFG!Zsxzk~!6%&q;sKHZk@<pocA6kU=<9Rx-6uLui1x!Ge-PoocJ|5N9Zjt`3B
zM!g@OY<0^Z-^Fg2b4f(k|LtyMK?pxvI~<YN2pIW;zmo<!dr;a1Mj3Vn%a`+Y3W1x|
z@+pz_TP!K9z$B&y`07vGqp$YDy%%~o-sm>!6eDWXyM7G=%VukTS}#+wlNXEYoB(SV
zsq%3jdMZ(L0LxNv+kYA0B={O+LtlXL&ACO&3eSCkUd6h8?{$AEO{Dhk1?KAO;?7k6
zSwwW(w>PuAt2J&~XM=v$Xuu{Nl=inalZlVv2lIPLMkIVGxjTcgb`(t!Ho=2%FOA9M
z?4At$tl>VydH%C))ZwrPX3uS0zm!4r=go9*(2@1CtD}(5*Ei^vy+MPb2gBA+WGozp
z21vjd#~7&oD}gv;acD}^{9I;FZ$w?`F<ZSk(iZqB0?qO&`i>%tNiiDV^z>*c7?*$K
zZEefehA#*Fpy!=TLUYx`_+?_}T!a;jf!$(Q=u<VmHzGZE6>6a>W-g5~W-fF!B41NO
zK)9;W)JcrG<>a$brtH0=qxF!ZA758eJ=yT$-KBw%ndmXiTg^4*6;koixg*00b0H%c
z#YB*hbkt{WG6|yM87-$%<N#nLy>=h9@bwhwDT3Y{%XnjCD<{ho_E`4U{%m=SVc>7g
zmdM_!|1F6?9S_%Nz5(^@ALj-4bcJkt<NO*E<Gwz9#B2CSo(Y>=mwI1v#+7@1g#%Pp
z;D?Z|oWLqe*ovi7ZlUsC6B0JmsY%#ZCm~z{a=fcC_y(BNJ06-wn$1*IJ#mSA(HrFa
zHqZ?(bo~u3t)UK5JG%J5sM7sh@%nwZ!n%fTdaJjQi?W&J>UrsJk8mUEIr<m&+r{lW
ze{p*!L>=gh^2+S$Y-QoDMn3TeGrm>NOm12`yCo6IAx>^Dc6t_ViThP_l{TSh9(%>N
ziDvk-M46&c%;4m+4Uva{PC{$P@Zx=PAs>`Y-aV`;CS^2O`{nZ#nCELMl5s+mL-bwZ
zMThwTlxT1Xg~#wYmy`WB#;o4OJ@WaurH+z^J{u>0yndLXCn^E9d{My~J*ZbZrT3H@
z4<%d>(VA)^r5T+BiS&jTOl?KOS^HMrm_6jRpYSLLnt?Usakr{c5;A8>&gnS;G8NXb
z<+S2syQc9(o9X<Gsgl<A5)Bzsw-oM$up?z8WDckBM|n}Q2>I*LkfBq>r;t8s?Y}^(
zww7nth3}chhn#MuO*3WiluM$jOi)gvDB1MYaJk?dsqW?EvH~9(V#>Q)QF0%>92G#e
z=8A6dqf*$DPihr%jf56Uj#liG>aK>ZUYbC0yh!-hn@`c;j?gboH^{T8v$hJpy96V%
z0UX?$(~taPZ4sQ3-;(o}I1-~UuTELcf3~Cp6<$`V^8H%D2^IDJR}Lur$>!eUr2NvX
z8%M89Vk=(EKMKB$WTqSVS*PXLI0K3pAhtFD<qc4}vgdX1HA9kkRFA(S<Gp+Y^}=D{
zL{I0Dnuoh0Z)vBk+_%0JRnNWAM-JJM4P8#{yvJPQJe-*Q(yT<vJ6mPLo~<^oUbao)
ztsYh0cRz=(v+=R20FOHZ+IXrTZ+K7NjGAGc2Aq-5akNTF00rA`1n4VfB%0nF3(Zbq
z3F2z{$qiH@1eLj-icOXo7+Hh+_YOJy2flLiJLL;-ymDlU$R=i5=?}z41l}b}QLc0>
z6Q2zA1u9UVxcJV+QmzR?el2!8K3g|l&60o3(mxQDaQB>W0M(D>^g0plTa8=D)gDLa
zv8R;FT$5>sZg*ddg7cN^bnf3Bj!KX=@IU)WmAs^*ak!iC^@WxGu(d$S-+lLT(@Fqe
zmTio`ND8@r;>w86g$)j$mcw-1pUoU@+{iYWZG6@rVqP0_LE7BHbPq<p;@%vuhbI2q
zPAoT4=6?F{Ubna%nN-njigFSBA6pP>nWAR8;WF^HQ8f=9%A)wThpXugP2%uOqfqv+
zz_C#sL>k@N)lSWL2Lwa=F&L)kXr-RE4jpFwKJ9OtFr?f3x#&FPAG*ZS7eN1|WyTXT
zn!7;Md!9tifA-Fd6=?A!EU1vd_`GF!z=#knA1laQwU}QZ7^@ztF!+ctVY*>+I%qSP
zA#hjqcUhT(Hq)<?ld0C5rn?V$>kHfGhf1t;4zUMsITNz{Jb2l`NP(J?T}E7$J8sB<
z<Z@n1H3HMQIzNFrWFV9_L^P~KZnN^yYLSlY#A<9A^9PU35z_rEyj&F^7QEGq=kHH=
z)u^|xec=N5Hbe6Ip+U6Kmi^WEVD#qKc(y{h8pjD?W?U&z`b99y{5xj>fsYfCdT#*$
zOmAY9QF)j?@J9xO0r#2GK$ZwnlTv<JHNzqzbPoo^e%#YMuev|k;$Oz>AxQnBsDb0y
z%*1Y49{20@?vnWrL2oVE2WY_An{fxhNWMSJ_jTnL8QccFMB1S_D@5^r8OWQvQyFTY
zTx5h!2WLSQhp!kB$~dquubz$|L#z|0A_UB%TR$z~<9rtdUKT&F<;|MeLZy~x`oKzu
z-3aDN<4==pk*dGkyp0NzL&om-5)>5#jcuszJ9qHVSh%P-SY)OW#b20GE_^FoNbOSD
zzh1$_Jk}&3g2mpg#Y+iT+1H93f+#$C(wbf8)whLxA&-yQMl}$ww@IR-L#|pJX9A$F
zA~i%kH6ad=?MU|@E%`7dG?uQxfBIXiMAh_va=mB#jYo4gmg5^^zi;lwpHP?)UHZ8Y
z-Hpz3R;Pyuj4QI*{WS&AI_XMWE)Z;aZbM@5zbopn9{{7X>G^Ezi&$J5$ZLRn82&xy
z&dp8#a2q?3-2FSY8A5b2A2-$DZ|`hPd{9E-qYQ9#Zws8Z)uhDyBs%|z%Bt^+VE47(
zN{(#-9R5F5n;;9a`qa@GHV*aTZ<`{?%)&iRkB_~)YB}2PdIb%5hCYPoR)1V+^=7sE
z&+NpTj+9+|b6)WS2gUc^1i|o1KJpE|@;I9Y=g~zlfpy7VN$AZhJ4^)N6#L3TtWwob
z8{NUT$7KU1eGEFnU^`_&PatdJ5+w;UOidz_Q=@%5hunO|8|4=PR(tp{!)Aa<&Cn^x
zK$*<MQ?vby+`6yrWBL3M`V(#OZLyBCSCpt6-mPG2^;Eq`e0=B2H&)cc6SsmSY#;KI
zEe@G<A~Pp?7l8zcjn+O4Rflw{NYan_w77VzN7jC6HlO^p%OICm-*sqks;#LwwGw_E
zbI9E4x60ned`w{a@agetDX2M#g29KvQ|f+@C1{BZBl4U5Xv0uI0Cc$nOHb;|SMr5#
zys++LxG%f8JxJoxW>R2#KKaXF3P36L-wc~$H9?FYBphw^13~qR*2{&ZA^9st?cZS=
zltDJUo2y9i3oq-<96N+-=7z>ck-6rV?(WZ4(fodZs?SAHc5Ct0Re*+oM|0hlw^~dt
zx{f`XhfyWW?hi8T6f2Jc)fFSt9q`780B4@>MsjRB3+}2FI04Fs*ytH?;N!}OFl7*Z
z)C@Z0j<El2h(3<3ip(%7SZe+6Y#P#SKO--`oAR`}A?DnrPgFk=w&K=7M13u(K&+Dp
zWEFumEr@H#^aG^iyX$6zX#)JbO(Io-#jq;%xO#qryj9|BbWw3yKyhc+vO0ZLEm0cD
z^64J?1>4r`G<9I}d$<BYt+c-!>*kRCpMiLZp-RmJhO`kegiJ@reROe&b^tm)`9Z{2
zNLAs;MBD-qhl;Odr$@ur#l<Fs`l3n0_spO1ewDXJoXbdh`c0HUEJ9{_M`emmo=51{
zW2!y$@v<#l@L`<&+YML#D?Tso*QybBIm?NBc>-U>c^K~B3v+(P0OM*K=s_qG1??S)
zP|WrdGHn^enB2iNVc0w~IY{QoVvBJVee}ZMj5z)EwB|taG`|f?fx?p+tgnkU!I|7#
zF55alB_X;MBc_kFvsZIbh17;P_YChSGrX70L{qyv)<4gbQ2Fo{-(f7=U$aER^&VA|
z1!=$8b#y93J*h~OqK;e9d0ueWkhLR$$1sxb{Fp=;Znmt>fXca7C@1(&FW?Rv)-b9-
zbvC6jVovdg`S<W=p`-EJhgBL-5Z1YjJf|u$UMO~7jt0khl39u{0@8!-(*r}aVSC%#
zdUodHLKoxXEs>LQzG9OLOqzj?!~mCg^}3<VXO>9DyUhK&IZd%&v$%|oeVB5|tF*>Z
zrG;Xp<kio%cerWr+%AyM>3<ENYYLw%H(nJLcg6JQBwB~|AYG115~1+~$!PJr>uQGs
zq4=CO+57z&A^N1DbFF{Bt`4KBt|$F+9_p!AZ0vpf__3+FGoJzSqu*MUG$8-KBW+Px
z=jf-(>Fc2W@hDWMrwbL63du<X<VZHb7Q?owIo)g8B6#6yNb1uB47&C4CIGG_VMyV)
z-yB`fo!1_e#EZ0<NJ?d$t!MKJI3#jrnLFUEUUB&}uuMUyo<mg6y+QQLL2zMBjXG4u
z-J6MR5^T2+uHWqME{ZS2IwkxZVCl%o)?=OVsG^)vnM!{Gf@3eJ#h82r6%F`nEtb6}
zbzX6m6FF)bwNNI_nyGiF8~cBFIWA!f>f@HD&IwmX+s6vZrTwC>G_r^=efMZZ4y0N`
zb*Vy#r)PIiuYZGfb+rp8gzBUiz1x_>)0>Ok(y#1RzG)|-L|_15P;RbE5J|g8mEBi`
z=`V)^pHe;Wg1B34JhqU00qNb^e-+MLo#)rp_##6EB)6fj_N9tr@>$S?nRNO`a$5t#
zVzuf>`P{d(oy}65)WY(zsh&68)f?E5{$V-{)MHPE5|FqPb1TCM$6EF(9<thh^1y{E
zR0w;n-Fsi1?U^R#i$|&F3MLovJ?T5|Ui$f49oRL*!}N{xL<T$*IV<!lu7Ts&+<{p8
z=pjRzn}~$Zqs0BG>vdZ#g>+<}?)-{v|BkR$ME;RX#FW-37-ZycF+>5ZVGMGr`=qeU
zOZp$Rrx(zp5TYcf`vqH`62*D~3h+Vfrw>!=9%77B`*r-;tM6RMp9_6jBtE3bp~y4=
zmbLYf1#pxOGZ|JyokwdZyp*}Y%(y+v7&Q1uR*Vxit^j3tzd*#$kvL*}<?eGD$4z_y
z>~HQSf!<raP{ET%AKo8TDpjf&3bFkTo)i~{S{Cur#4YsbYv1T6d%A8R+e%SZk&EPU
zjZJ+|#@<O+vwLk4CqtPM4uiEv|MxAso++!<Cm2TEKQL$8bXQRVPPi~ait+}JtVpGt
zqK~5@1r0pls9Ue-&99VXk#vTr7^|)7N*xl?Q`l`H2q7}V(~1Y3jgLcso}{_U&$y2*
z$Jhhi1(;K}bwD8A)*u*@OpgXUZITzoPE)UQa%pr!x!OU4{~9Fh9ds0RB($u!)%eJs
zzrh>`A?f^<C#&fryoQyB$0uugv2iY~@@*9HF+bd%D^?JQ?`}E}PR#`taXJ!jpSERR
z`+HSPh^cI@XLa$7e;xPzDI1f{7|`Ivz#}+#u6Mfa<$ligE-jQHv^%nBAA2=UWS_Yn
z3ODeK=<RcUppuQ+`93M@3-7ye6ipzpqz%}M{4em9Mlf~P3zQY0wg36Wn46Ms1&yKR
z>ksnydzqlt7}i7d2X>&;ZX}-Q`lQ2c{~*ilTu}=8r~eLh?j8~e?ru1psGxAox91|@
zM!ayBW87)XK0<6Y5NOAxsknRX5v^a^@?1LS@l{v^q8~CmM?BDeLSE4qpk&f&OZfbS
z54=;~FYKY;joF^gPaipX@OWJ%7Q)vHk7wJ?Ey?7vStM%diPu#%9sRv$Wg;8o82cGc
z<?fAcYb6Boyb*H{>BRV*@!;aG4S^LGH>vjWcuaORv-u}A(PN7yIz87zafIpO<#(>V
zh=!dKl`d}G>G2I+RDb|eA`Om>=on*5(!cI~WZ96LH|Qb<1<pGmPeZWZm^EO6j~N15
zDB8?2vHE2?zx7mjPri@r5Siem7cJS@<_k%5r?y4h@LU2_Lv~9{Gbi{v=|!Swihlm<
zrlUyMx|*u;qI?c5Dpk!<7%9)9|NE~C=Wt#BZHO-I)aFeE(_eNkB)YA~NBXu(G;_~o
z8GvlBT(<gFg(E-0fXiBA0J8U~eVtrn<Yx-06l*2Y;gXq+1nuK8CqC@=2g^+sl{Pn?
zs^WV#B+1=IzlZH`3lxleO3<6W7De=uJMki9(1d26-X6n^@Zd|3g+;RZO+-h1$!t~Y
z4Yn?4I%@5Hs<nUsf3l}g@X<7mBW-$T2i2{ejr*WRrcveiAvTarPGvu1i58gi2NePc
zd1l-I@FZ@EtQ)xD#S%?>UB2wP2B@h4z;Fk9aU1S}JwAJWn?q8{CJ{_0CV*~miPkXA
zY#Y%q+2}xV3{K5$&p`{pt-(6ooVNX27!fz_4V_LQbP~jS=aT~r7n+hOD^9KXcD!2J
z^J*)_<(8KrnwG4KW(qQZl*ndvK+DbjB{CH$sA{;HC!B3T>=Rz6v`Qq%&2a7QvN_!{
zvA<QHx;c4<<jwkyw2_|aIZlckg?pYk6HiH?(AScD2q&F;vkAMgRtKaDy++{YXkelm
zeUW=^3IWILE}xN2&XO>Z!&yi=jn)u+rvZA7!m?1qnD}XhN`E)?WE3}ET)p8$VpdiU
z8j1cQ*aL+xNN2_{>|GNe6h2)EYz*Qdz6b@mVH$~x7vy+(@JwUun#-At`sC`OY{Ys<
zajw9qmx3UBys(;N<!u%<hrmAP6}NNS!mhtIR^-OIosq-0IZEsjXkDLFj_KZb)02y(
z$<nk|2d4Dqt0=-?=_iyHzc1lr{4OFd@_K8d+fT~k{)m-^NS1>e8q>bPKd5Bsymb(e
zG*p^J{|M@h`E#2dk6)(%HOY&O&)gOZc(YoPOic#-_v>tAm43V(jK}QY0dJ)eKYk&}
zqpV4W7fT5V*hR=QIVd!N<J&JH|B`8XuSXSAwXxT-pc0Ur+pxmz5=gH*3{NMw!KSc~
z&S8X?pWMY!6)&^5?wu{{l8{ucO$0J>ST(sD;*k%6TyTwQz2a)PMgVeq<3=vHUy&O3
z3br_*{+l$}6vP7i#IFtRUp0Va5~!hD*NvcFRaasCUU|Fhdu*B6<UDBIw{BzA>7ib`
zJ-WfDS4RGSq}O%55i{5x74!{FR~xQ84PANWmzDvZq;cIx3U9g2r5|X9R#ijfn|&lK
zinqU7nuHgQ3g?`^2U55iqYUDfZRIJM_rMB6ufh4;5COE-qimE}u~ZU4jF&TyVuaV#
z+&!gLY8FKuup%vpXGk)hj7GnO13tuYT|R4+EUwrh`~qyeK<}c6nGBV`pDYH=1T!#p
z{J|Px{yby$=8R=pgHWY|q)n6bY&J}QUmF=kCvi@C`4L;ZD?k4Ov~<HCu5G{3X5|ZV
z&SAXS6vTQ*0>(_E$pXSIZ?4nayalnwC^(8mO+QZMYHJrbW9d1BlGNQ9R~socLgX(f
zuDM43uI6}{`=xm@6!sBzVF)){9Kn}f<PK%m`Z=F;LNjJrc}%ZCt%Nu&^RYK7HAWjV
z1}Z$pL^U183k=<`NJLV2lk02{Ki~DJ0d0)|>bdDiRp`xez~?LqM5K6N`sPH0rwffJ
z<f-e$DUOxtc*vlale3#fSt(!!{%q^5!+p0Y$J2_2CmjT)C=*hJ?V7!Be1JYX#j(GQ
zvCHnTSEa;w9}Bc9H{(YQPcHl(6!=Bb@Q}ZM_($3eE|jKPvr{X8;#%KfH~?|`TEvlA
z^J&BW2SHJP?y3Vz7v9$?6qFsN_*7c(!sZ(JKRlD<8w2g*RhRen$EvIx1Y_Za9Fk@(
z)k^2VLQ;;<Hx5|w9~w@2OrMjS>K_XO(oq^rGV082_v8m2a|#NpeL1~(NmExy%09%}
zp_?0TO9WJ)AbV$Qlc9On*{cIr+M62Gek03yOp91poMb>Lck{ZP!AX%odDuGL7FgMR
zZ$|CE1AhV1&`+x8xAfp132LPpBh!XbJTPeG&s?@bRE`#Rdny|2d}$mK1*Lymdmc)q
zIzqxuR>FrVmcL)!v3f)zEKPphs2Jr{#5(}4(MliANZ4?aIwy#ooG!%dT~VPHl!v}r
zxFxxIq}ual)+KQ-2O&c!i~W6_WLjmqJ(Gg`-iWF(Q4cLX&?O4L^eki<9c5}_Ihs;1
z-gS+(O(AGE5^qVLKUMcF!!kt$*v7kv2V#yZkO3tuQP}aWBagauE)8^2(|2$$)F6kG
zM%_(_)uB(1IGz5Pp{VokdP>Zh91T9M{&y1>NKZh`kr7eR&xAwGuz5azyq~S-fM|4L
zi(+v&026GtBQC(tkM+nufw+7bn%>5I<|&6EG_wAFz_swe=NEaFziBC5>;`v#0v_>G
z1Q==GeNM@Nr*i3fD!)#`5kyTDvKG@M5a&J&Me1N1L?PDBg>7WAYYuJ1&eJVSVEm`)
z)OIHa4)l>%Yf4YA(rluH-PLc8BFB~i<$n&pfwocO3Fes1|G<aqsHFa2Pk(xmClehi
zz*Gp*C8_0i(r$m+>l*Ce7sw!!Pdk52$f=;v$FXNSIAS-i&w@eSVd6A--0&AmfcTZd
zWS!yJIlyS0Z&U81DMRsNI~57|O^|b$2qA?n8klBg3n(`>Q&W;)`Fs$e`LP=FLctH1
zTi8ahQ3w2JqnEo#fmIUUs*io`$^bW?YNmQ55i-kvuJ*W$l$D+Ky8XEsT8kwIH=Cu9
zl3gE}q9MJlq$Nk0I+S4b;me(%)Nu=J)zEx<jdu3qdv;~<bKTGgoKD&J)m)1+M&5Xf
zLL$bkwOBu&&pOrwf?5C4-Vg}vrijxQm=aRz^bc3yOPPsb=+hHl?rTuP>gP7mklzv1
z(54e##!9k_-lk}wqS(wu&@7yi#y{VRZ^T-?YWtq@+!4Z%^%aL5*CQc*HR!v>+0YYi
zDD9&<BEj%pgH`Uckj@xoR%k&A^CkTFpTTtyrxgv0b;*@%2YP+zJK(flXej9=Q$Fo$
zHvA^`BMp($b6=^OKe)^X@ADubUw=%idp2S{v)^()_R0D-dR0fq3}58N?t?$<;piVd
z^7s#&vi@0NK*;@!#;5L##~H?3$dR)tOh(;d9tkh?SbZIDTV?5{9t9>17>DnXQ-5FB
znYrA+FIAJPb@TJG(tNAI#F1g%)>9yD6Znq<`@hVK#EDpZE>!gW?eS<`{c^Ei6}IC<
z>c9K731gG<n~ph)gl-q57Ithc@Y&q>w5CCqljAI*Rvzn+>wLc#pyrcUsxnu{E3N0K
zn-V}CtH)Ex^=}`OrWJ|gsEE1FV&iZ2(>J_{iWR8v*N5iHg}>2KFO|1F8gUOwx^o=r
zDKY+DhB7qp?&)t$#rF2?A=A~Mimi8<JEY-1s%4zKCP%#=XZflu$O%jfh_SQ5gHWX)
zW0xB!mzymOpx``zW7PRGpqAh|O+W=rQ2iocCviEKPVvLG5VxL2v?mY26Fw{I#z8m;
zLp~+jelLtsfbJ^Zq((6lt4XD^_|CssA!-4K<o0`fCsBH4Nm+$|Bu=x_L^-0}B46Qy
zW7<8HNsak;CXr@px^Ut3^~-8?Mtr4Xf;chQ&tkUaa{_g@_6t|Br@hb0@;I5|`6y&z
zp@)4Q5KCy@uiNp9U2Pu{zMLY%6^^WD0+iJBr22bRWD_*RCUvvW|0(R94bGW4hq8}(
zj}Dl<*9jVBi_)N%2gdTDWA}*GuCoM*&2bfK-ttqo4cQX;2Uo&kvUJ^BFAiVbGKkq6
zBvG->%=+EWt%e;<a@QIiT!oyw)j46bIc-E7jnhh>B~O2d4%=#(G*JNs?iZ{GeSLub
zW)O(xhYJmS$)LMglTfo}K<4zdE5s)iO?Y2uWWs}BLR(kvIE5M6o_|wJ5W$xV8zHjk
z#%NQ|3@dN!;jJ`;dwsX!D<x4Xdb~w~Ot_#XDXQ*b-&K7U&zW9Fff>-{cEKp<_BE^y
z7UiR3F+)9I+^yJ;j(E~{;8$qRFCegSOH^2BL)`GIuIOl^;$b9#)xdq_D-^x>(PK{~
z`lI`Y(<@x4+uK#dA9BTl4_RZ^k>Xpg-XpR^1fO0M^)bc0Nj3j#XJPWqMgGN4maD9A
zLHQG(Kn|q#!bD1(b}j#SlqAY;-*#Zn_TV8R>2Cewt6W43P(@PIa2_iZ6R$rpPo+Cn
z_lrauYTrxwHP9A+m*Vj*P1gn4r7`dVNUG6xN}tY2d6B^cgYG!KDs1i=`f0Hs(3$i|
z;9SZY1sk#pc%Zb+8eIogNU*q$)K{juJ9)g;Rw)uf^K%4|>%Uh?CM8aIQU8f$-hzF8
zqvErEO=H&F6XP1F(QD06kKi49-83B?@8YcG#_0S+zA&JoP3@E^6P0gvKu6R1B!M-t
zFUb9xk!(wP(ZvfJ9~$^;BW0MC?q{`8TTk!p19%sRsB33zymo+osg<C4GUxZ&<>@<>
zPMfm|-5}FE?jIze{VmfiTvYGUOpzZbWl_EmUmW@VNnb{fDhWy&44%JL`>DV<ZJohv
z8+B2wT21J@&l<#X$WUhBk<u58+v{nbA4xUY6lj1tbffjIpF`Ej1tTU-<C6UC?JahG
zW$ezauQP7%7*CN5<cxyVgtzEvP|&zle=!N~ep_Ie!W^;p1GK&<ljWE<IdGp|z)+0a
z>S{OmbFFRI>6u5hoF4O=SxPdyn+UCR?V~3$V}8@~np!=_!Fi|m!}9pGye8!pTqjZ|
zojjR3Pp5o+V=vJeAWw+E%+Rfm_wD)@H#gb{wZ1e=n%BcC&Q^h*f5{rfgUMICx5w#M
zpcPTURQX8Nto%x$1Pd(VpG(YXeXk>4c#XU9b=B|rFd{zSkcWpZWv=z=4E>{jc(IlE
zC{Km=moB5r@1D&{E|*n~M9m!bir7=hk)Mz=5@I*^6(5G2E7Zdq^B=N@_V_g~m9xKT
zeRE^C-1){o%0t8(=VnUuZjO$GtNAlo_PRtHPfIa#{n+^YhtKV1X!<%U0Rl`;WSkug
zz~Wt-hahYoW~Xst&~kxzGXnKKy|{Qr&Fm|9bLjI`j6_Fwyx%leTc-#z^vFDYm99Zv
zD#x+v;l|gNz5s@;v&Xl&64sP`s@N!IwD{<&5_@lTYhiTozeX3Io1w-7&oltgbBU{<
zc~60vUfH#mZfnCNmOEZZhB9h~F=T30MQW|^YNz)g*=%lxO-*X8Oi&F87y&$V?Rc5f
zCYfitKF&Qyw8A9$EUe4s75F%b2)-;Z{6sb6s)RM1=1bFeIaj%lz5jC38hzep$=SLP
zY=zdQeXGuSb2-EXRIiA8vDL9h0v2bhz7!_U04T;Ewh(tFNm#qdAqK4t>>B3#%8J;i
z;(e3e3BU2;e};_AIcco=9(*2n(W*)e91(-obIxIY$h<UgWX`b0-#V>IElu%A9r*m!
zl|}d|?%sbw1w+%5n74(69~<Q*Wc8$;BZ1R1ee}0DNeqvh)aDanRD%=gz)q0mxCHzY
zgDXGA54MNhyv`y5OvzRBBBO6?&!2>Hr)|HF`YS?TDY&u3>piL=RbB%?HEFeuj5Zle
zxNCUTp}GwKAq}(76?AW=x&FJ?lfI4do;>zf;|#eSZ|N*(pbz{)3sJn$Q{$+o$7dl&
zt)n+AoD0Ud|LxCRODay5Y7VI*@g;bObWuM9P{d6MTJ;yqes|&j6I*sRO?9na%>Lf|
zM67}3P2X3!pB#wVr4jdq4-b!U7~_GsXJ{gy^Uh8x{lG*|2{n=DTSm@He;@=+q82m|
zVqxhe+Nvh4>Fe1PB<h42{9TDu&sve7Juu;L6B&XB^oW^h$1;yxMi&IcicI4^Ouv3b
zjrwR2&PRQ9u9T1<QH75(d-=ka7>4?#B!LtgRa&T;5ZxY=dhK#Ne(G+cpK7P`%n}%-
z*+bjYKr8Y&itPQ9y9Ac`kEy-?kyU2K5#DW19)<d>|BybkOwlWj?YK`L8r3-7(Z_50
z)64W`d>0c^53^ilRNTldDF+2T5^5=(n?9$gkH6gS26^9oHgq(4-H|XEcvPi!k^R;{
zH+PZ7e9(Bt+|<=LIWqamsR7jVW9xEz$hs$yn@&{We9!Z^e{!)7acJT^zKN<{Z5?=*
z!kE~1xt7U<7alel?0qxb@3_QEX7DgOcdcztk9lq&Qi9k371c`i8R3-9IDQt6y%j*H
ztHXW|ekQe@#c`&RNnh?#tq(pw3OX3NdG}inj~OZXt+w$hu!L~;@^A>6z|Z#UgKai-
zm*I^8MjQtz``yEJN%A9Kl-PfjI@q^L7la>o?7dN$Md`m&C%ZT@s$)1rt;XY~CqJ!8
zAe2w{Hv5`~;?}r$sJA`Ai%{UjjmcY#cDzN~oe_{i7NEj#dMO|4BvH6-IKrX2j{dd=
z%hoWZyr?NOZ8*e|s>kvDhO$|ty@?+4c9;2(wGYiy(2M^jMS&8HanogGCcZrL-CaTB
zfQ!v{jy(GrAB@SCifWRS(DBiZ9<5hWuWC|r1t!0J&+q!nzTJg!*Av<L{L-@929reB
zE&TS)=3bRtgHBPS1P$tz!dPrV=KZ6imaRFBehQX_jrJ}h&IYc^%v;tan)xJodPDMc
z32BiV)t_089_xm<y>Eq<To#xGZV&e_oDTHs1o6|0S;t6_5(88K0-kR3g)=BTK3F2Y
z-yQw~TaEo?hmaBx7_{SO=kr5riF5%vf5jFx#?F@z=Bbn_5~BCQBxt$RE01tG?eJo0
zQz;wJ<*mrId6nkLah<t7-ZIy@^QhStr{a0_{6a?Y_loD}1SNO3sV?&A*pTqPLAVh2
z#I5U(*ky=o?vE=t;D1}ROavT&NF*bJ0DuMn069Ee5Mq=Lsxk$7P*iHZWfsg!HwD4}
zcP4L<$Z3!3|MmcJNrLrofXwyZt&DgpfEEsDj|6;$OHsn5Z?^)Z*#G|=3OE4p@WimB
zS2!hne{bEsLHhnj;=YS8=<hR9`bMiv)A(EJ?JGc1<e%BkxNqYH5RPVfum4!7I{^rK
zPzL~Y4(aqga+jAajS{3U-wZ^{t0;^g*h=uJ?I*T_=C%y_jWV5JF;=4sn2VkTB2>rh
zC|Z4Cp+6s_WesCAHEL#y)x4<%i7Gr6r<>{#f3c_=TO&1+%r%ab$QQtf^F~Q#BKxG6
z&~J_ZDNy;omAQ^v6B{V8mf>r7q1O*?q3{9797bXfurw24zF&C%qEj-mvb2%NvvD;r
znz_;TP4!&if~N)hNs0c7d<yuBzPh-v{rNuOzj&KQCZ=wY8wLJsGLHYQW~@C^zOf8V
z37o^$Wp(A%Q%n2DH!MS@ZzLW7TO|t&9MhN)zNFZh35)in_(pvu{gV$X*GVpYAbTng
z^@=Nd5egus0yv?}V`L=dCN|Sp=m^j}`Zo6shOg@dXrP4LZmTIQ%MHrYhJOAPKQ{sv
z;0t5#mf(z!Asb4KS`$tX;C$rRU)L8A*<W_-iI$ps%BZ3Vi}+-@*xg8nH8u&38;usR
zIzAg`w=I>wmQgGRNR)oFKC;w>H|BHF^Vs5V!t*$vzW@FOC@)XGJu{5t!99?vBEQJV
zOd`>)O&UZSna7a04_Q`+40l>BZona@S39J?Fw(%a*7CYAr-xcL#3YJy_Ww!ZgDJ$i
z3dEXeJU-spX~d365Y>i)E<mfR#xG*k`gdXFtP}-S-@0$tInI>gII_v^(`1}6#7c~s
zEi<WOqFWC>1r0sM2%@wHxX%MT$NiY;p4ET8Jgk9c3|=iRHWrrHZCu(8Zs-5FXJ&E2
zjh1o0kfaXKkfUCyEA1AvDm`!he!0pb)M-C4yLO7?d--U8?{sq17ZLQ5lH9UGYD4M_
z$*#m?s<P$J0m7g3v+IB<r6@)?!HEydZ)SAE?dWNi%J3r9S_$yzpwwz0PN#gO>_%l$
zfH?v8UoPcN+M_k7>I{=H6rtEOlc#PF0Alplc?8>>QJhuk)Q^%+MT=2YYHfmOrXE5$
z<rH|PiTkZ<F3Wx|p6C9;LW@iMmHQsZXI~Px-2cUzr!_cX7eUAIrJ=(LcLAlRDX&TA
zy8I&g52w(F0*P%4{t+?@(-qxx>i?A)h7Ys!98iWnY6k_1y<cRhT02w+7SCG?_8?hj
zDj#)oej6A;0i4`6(J2ftRYnl?kQrh;@AfqdcQvRK#o)`U3iwKK<Kg*Qo6OU9hlnG+
za4}e{h>0C=gNm+nH9<e=nk73!$H_r|+4x=nO!gMlQMO;80r#Xk!2ixOWK|e;9Z5i%
z@GL?nrJO>vk@n}BC>=&=GQZ*6Zm7L9Vw-*^4g3B?AY~f_)`){~DW;(%_y1~qy>{IX
z)aWBLAKTd3lMM}l_erJC^3&cBYVZ0RyaeA_Vs{q^O&TtrSn|H25|X3)Tt{Ty?(qr^
zDG)@sf}<UaZw~b6b%Xw~d_8ZAIAnpFH%yW^OBX&&;Wkb`>N^$We^D`6`CfrIFD+2h
z<8XrDBdw#zP&8<1sxTD61M?P@)L3k328vsmk(Zr5UD!|Lo6kDMafX(h&;)If5@Dbf
z0eS-tL#9$#dft8l8Honp92N6PON;$PQY+j*nyX*bg&{7{%=V&ZFlsv0gr@eyWfy30
zz0QL%i9g{ffHu(VnAi!flt_&TKK-)Q!p{}ncg`dzA*JEA)?MmlhnG$*bpBPDf~;3(
zZCs9ypsQO{IXK*?6~bkDxxU23>5n_A#QH+&+SMcnf;IXAMU;UQu|Km_@qy0~+(a?1
zlymP?Hl~8}bH=j;47igtc&K48X~rjzINqWB&_cR0u!kgDe0X#OOd5HQ&nj!SDB?sJ
zn4#X^Qhcrg+YJ`Xf#~9X!fW2?>?{$(-auj_y?D4^D2<}C$Ir<Dmvc7f%_{27&<*9c
zDTQV{CLgI!`_3ULZgDf#BVmhZo|F#+$ekDTmgqCK5>KGj5!8~YZNDxzxH3xDn1XtI
zW2EdS)K#^AW`ic#dn06m{j(A|*D+LP96G88WBLA2`OCT2Zw3I>qL{_LzDy#+ucHUN
zvI>Q-;K9W~;A?5N^|GaM6`u@nv!E;H{9W50CJm7V^&p!V!cAqoNa}5d04)<43PtX;
z0U&llzlXF*Y-El^XqfYZS*fn#s?+EoN8zyaEkvVa9IJX?91rd}@j4N`a}QCK_Bede
zIuM-CP`y#+_OA6we->TBTn~8!uD;iWwDJCDAIqMe9(ycQ?eBZsEY0TYbOoYB_TzwZ
zXrkUh0A6%l+CTP7MU#4L;X0Bb!LnE01RZoMD}7qV%eLEPw`+*HY@(CxULVzjzo9mN
zvdOYUSCHKpCru*LfG)a&vX49O@e?}=$MX&%jgBg{Dv@W2^*TKu8=vR3M39i?1~f5@
zm`lj1y}rLDcv&&T1fy&N-mn>}KNnTBPEURWMrVTpEgXOEK)HsE8+fx5KQSgaY*8Dk
z54A@L<-U5%EbS}kh!>hFQT6>P4-74}_`0O`L>ZAXAirIf*e4|^SX;g*`s-c%<Kui5
z#kBydHR<%>q~4z_DfDD-lHBhvGNpQfmxJ4E@vjBiJ1CNRcMZwbRic9TdwV}|u7>~*
zY+9wKf*HCswV%0$dl<hAhvgjo+x_RzgE)j(KVhTbXW#(M`38>n?|(U4LBhg*wV*0^
zb-oQbyc<VVjQya(!X*H8yw^?E)b#fYyvp*GWx|*;n1gWZO@pPiIIYF&->5KyMRfyf
z4w?sj+;l}Vu_$1)LTep2*_eW(L@I?c@;)jf=vt`gs`c~OQgU@*KiYZ97^MB|x}v-d
zAd3xCEG)g6?m5~`3m&6ECc{T$dB6$tyx(#?0*Cok>&`U6iS&)`pJ@Bogu3?+s2ZpH
znA5Bw>~GP(Wg<D>ER9UrSc|%!S@(c1#Ig%PC*5V9f`7c$mjuTi%h5!r4egEj&~L4r
zdu$5ee*xjCnlF@m84}40!-ulPCldg(l}oFo6T|h^2DSi?#a{vIB;?tV4}K~A+ty#m
z<Y+08`O~|P^Y5dKGm8{W;H42H`EUt!`SWnAjZF|Ge9ZIb+Ru0Gf3W2VUwGgcx5~$#
zC{HU}Tc1Sb8SLX4h)#_exkwn7nu2<ovXu||<ONLLL_Ijj)`TY!E3`Em$EyiW#UA?$
z&54&`ANjtQNIxZu@3#5aDw=i+%&bi?LI2=-;ZG++O-AJFrPcajltd9p-w+7}S3Pfq
z`Cz=O$#QAL1m6Yqe#63b$%CIGJphlmSsJs+ed07);`=g4q+#v(563p_LX_|&P642E
z(cGWu?pn4@%zwgJjFT)O`)`OCRAN8T5w8KRyuzcqf(*ZS@{~V?PgzD8E~%2CQyXza
z9G~Iv?}`TLnPJuH1u&Y<0_4l*0#UY-k)+a4mZQA@_DdmZYXBK)l*^)3VI(=@Y`+rE
z=5U03iMKTNR-RGHwq#^bTc-*pYHB7J4o+0x0*ZrZhc4j-fPMiS{v-H`N=1VgQf;)1
zJ;YkI1m+~{6YdT7%SLfWmcs!WNA&UR*i6Qhi<Bhf9Q0?ZdvWyM(Y48GwfOsl*NoIA
zNKK3r*hBNv#V}EmnxLL88~f`T8xErh@fxqWHk|u%W^}o`=Nw~A+n3wg8w&$m0$Stz
zw&vbdOD_((G8*1Pi!-k2Z|weR+n^%5joZyW4xV{RSmQC&(EFzegETsQ=^Ic>-t3{x
z>2rpn+7Z2&oEOQ|$lglzycio7TXh$_)L3HaJWMstsmRS^4I*9oA&{wC*cC1(X7ND|
zqEBx#RwJpC=(xY-o|V=)`#lE8_7RLl1VNhsl()gpK6*^O7<O{7sD!^{Pk|Fwyd};G
zi4Xb%4X;OTIwl^cUkiWTsT_4=i~@mVP8ua#T)WH%ax^Y-d{A$B_kcoB;Pn+Uh4x|k
z9@!Z~e%H>v#l%@?(19z3Wr5#C<;mjB$+v(UDSzZksry1-)lEayVJ(Ck7AQnD$6Na=
zdQX0E#R@)T)&PW$l5XnhpM`a*765>?zE<dwCVRVB#st_PrZSyd*9N1IL5b!Gq?aiY
zlv7iEDffyFS$)`g!IDT(DYkf@DZkO|I68E#@l1`xwv*8xQ6Z6YPw-IEmY-~$w7Dnz
z&_0)Ph15`QA@MW_@vdfvBLhQG_cNPUL5~wX2+sN{E826i|0_^Fx&q$?A2Lwg$Y`XC
zGInB~yt@`Xe8$wxl$E9%%-s||!7UZu$PYtnufTHqR2M3Mjxo1hUla5nBd+T|FRtHL
z{?8;CjUIZP*tz|6&<K4r*~bb6Zyks}%>!A8NJ@#5wl)<d!Cwj=Q>(#!o15$asKpIT
zE}<|V-}+83Fs>2L<0rXJ<9YY#;hF!77F35#`M!K+i-GAKgW`gE)2joZnL1LJ%tMi=
za#pzdyQ;QxIx&YuRW}MC>ggn%@eSw{CD<gUA;?|C>Z*d}-fQ09{3i1L;%p)J!@1Cz
zxCE-O+A`PwU7ky5H_Pzt>c@sqC#EeBjm_YCkmXly(;Lr#Y?I6MZ|4prO~z_R`yNUx
z^VB)5#WQccwr!B^FO&bXc_`bNu@TvM@x#Xd{M`5D3$ei+B1~S)oNO518NhrclKf5x
zYl+#k$!~N})AzyGJ&VF>Fb1gcr9XC5IsvwFpqNUjeH!_=BA3>=$PPS)XvOF7H-?gT
z46E{2DFX2mg4Y>`!kee*rD@AgU(YP19Gio6C~lpp+g|&uxa5^%*`}l&wOm_1SEsuF
zZr+J~3hLv$8Yq?!foC*mi88}4zc+rQSEPX={n49L_r#~9gO-q_Sg%EqoC0*h6H#pV
z+p2-p0*1X?+(YdZ(@1BjZP+bd)@W;y<QgXiVCwxTSYjrK{jt{#s~D6;5{^iFVX30Q
zeJA~{;F*f)TNhdp{#W<LCm!suh1CuAH@mA&m{l0lzK0ipfg|&Wlwo01c2N{fB`<mC
zO^k|~l;a)&CwHeJW1)Gt*YKAO6fwVg6+(hczirb~64ey=DqofpT(uQb)UH`H?0&s8
zO6X!uBy+cl{oRSWzPRUgT$JTe+I9^Ost8ZpBh-{KG<d%0@hifsJI`q1eTHv>fs4KV
zKN_c@9A6&SU$`2GZs13nA9AnFl1=U5MROSCPmcpUX_3<727cge+(9;yxAY?PZ$Ka$
z{$~ENm6Kuvjd}-;dG?lm=H6(5xAGZZ8R|}mZK)~89|<;_#mw$=^}ihrENf4@G;vK=
zo8xt*C1E`H&g6Be)NAUmJk3yk?IRNq@Std2@37H<Dfcz8k2^8x^ml7|f@1wf!U@|a
z7nU9yF*H6!|5Z6-p|9YVqoc#cZfl{%Rf5TE>V*me()3W~=PK#wr^p+d$9)t98+-ku
zZbREWvcCz6MuucOvt5=^y_L*|N-lK<PnI4(B&Q|lR9J=Sa~ZIgiTiQ3CwwJk|1qfu
z;->`3ldYxvsC(Z`AL|MO<P&Lv46uwgClFO;nikks70=5cfgYq>cZHfMzM%8jG?LZ&
z1GloPdVCl@oq4{D-28&1pBs)x@xK}2W{=EWQmQwh`D(>;{L8F=$tpSd3#~aI9`a{^
zGvSgjdsQBO<^Q|2QlTa6@XR1U`8(F(n%t2CQl|0fTl>WsO}X3~N`O2Bu^G5Zf*%P0
zZn!lWB8s$P<qm7ACHH@CRgfq{WpDiRl6)?i9p>}neg``GO!%?KCnpFkiEgZi@)U)Q
zt2|+S{SjX@z0T(D8I=40oil70K`4qrhmQ~8@V|u${&0E|XQ*jDTNViN8R^lhsQi9<
zLBT~$u3+5<)$(%Zxwf>A0D$jwKPG?ac(JZ7=&6?0n1eAgqwZ%`{E<&V*82Zl`?^EY
z&erA-j8Nb=AhWVU+U(xAEUEvTv_LwUyMm$$A7y>If4TQkpfl%%9`n(~-JSHMwQ_%A
zWZ+<MlaXg&?inMU7bKR+Z8S!|TibAgT~-mjF#McEGv}?XJ(g%NLFkNE*FUPzcq8N!
zxSyz7yQ^olfj*J^ME!>f;!l;b`L$ukQhR9~c;|>plKl*678P2_r-;VhEi%Zdo4PUE
zxE7<*?Lk6YBG$wQjx_LE6XHR{OtNRy?+w&1F&=6*!mbYxtjx37a4gUqKjLm`=R5bS
zMv;o5l7(K-cMGHApx~Auhti0lbY=jh&X&GP1;lq}Bb)T2DDgK?mUyWwo?>NVqhNiW
zd@TfJFM%FLw4v3BS~Nh=w^H4e=UAj@>bT<D`*7~dqVywoz?gT<$V9Ah!}~7Q{08t1
z-*je^{ddsGv8=EI-o0DIP3TqD12<2LX8A1@XYBADJ;Vj<D9U`QCn>f&yqmUad_PDe
z%Ta~7zPL22<6Y9zOEe>zY)3~+x~6^uY?j|;2tfW-TDTGv{H{`%^Ab32!#{_K;hn}c
z{~3GuMq!y=m9d@P^G|;!L0lyqd%yU8D};kCdQY#s6#&^<)f_M#N=-?vec*d*wQw}Z
zD?D3lH1#hSl_@pC5bQ|;a-tuF99VG9PLR>V82|+l-FgL61NR6Jl;}KIpfTe=cQsV;
z=PT9T21fOTnY_i8$%(<BmxtT%DZ+f5W6tJaG`@i=F?4IRA6%F!wt$ydGOo$@HLwx9
zahtK5Wh`r_U2;T+CCHX1Yps||$z)dfX$6<UgN>UB9yz(WXVQ)1-E^OiEy+0&^XP+^
zIjP5NSX%;Z?r}&O@P?7evbq8y8>CV$1PP}4h#M2cP|gvN;p7E|2RnW2DG9wzIwxqO
zLv`<I?Avw`AQ_LC44K4tvKihWj(`t`huybLQa7*;g3BNj{6=B@149KaPgj8XREOW@
zm}mVvqrjmNbY)@?jf(EPx=rQF&$YXNcUr*ZUHt<=Dz*K_#Y$bWLkq}5p!E5C>b14G
zDuIy{$gG_$;ox>vZ({XaWmlq`6J2l%_;lI#F;&7{zTbtIZT2KEqLn7j`$IvR`4aff
zzQ(g5U;4onH4w4e=o_?!&z?e0>>h!6@$0Aa&|yOUh8`hqeN-=eD8lvm_Prm2j=5C}
zFCHiK-Xo;XV0@_ume?=X`{-@-#Vf9>*7O?bT6+uec(LZRTffU~?tMvor^L;Vhka@)
zr$?Xa4E2#)jGgH@zu{Dn=x1gh`V&qbdGc9gNnoQHEDmcG*A+n(Mt@8&Z>DN^jRaUv
zhqXs?wU*GuExx@RB|_R6F9iCHRbBrjvY6pUh&)bI9EE+Pa(Uy>HJ&9K3h{Iv;$)HA
zGTux{Ivkbs31ALSvff{b2jDQd=~-#FddYa$_cA{6HPL7o>4-;BZGv1wH1XJswzfjN
z#Iid#UxcVqvS91*=;s1Hj?9*_@%;vn|435IHtr)%!|H{%NI@UpojyM3)~dhNH+;4=
zFc9O4<qIn714g{{wa`oYazMS|d#CoTBzzJ{uS-udW|$8B>tX5`%k-K(RwPkvD%J(W
zfN=V$z-^Fp`M1{nkx(~na}%@nfG_<!w;^~}>s#z=%|5_{?;lq+ny6x)|D)(U!`Xb>
zI2;5)h`l#Oi`t`BV$<3k6t!2)P-?}By=iMJT3T9a{B@{W5qlIxsVa$BMM<a%Lf*U|
z@+IHy<9PBMcdqOAJ5L(_zP?zZL1Lj{hA9p62gQH(EZ&^qbbWJ4k}gnwP@M*Yrf4&l
z-Vl6^#!Y+ZF(1z@njLc=uvUQ~CY&9~I{nL#5H553h0V;iVrn|xh3O%%$&6afMr7)#
zDu9(O<o(T~x2n3LR|%JTc;Up0br8#d$gj|NWmZs7%Qv~n!;<t4?++E*LW=P4A9w#%
z%qxqAyoPAmKG{H$N))SJ2$tqk4^tddLI=_^6VmQ3m*8t`3&00^KgLoWHH5j|p|4OW
z0GUiue*}6$M7K$ncNWq_%UY$kVda)gS2Z57u+XKfQgjIBaO1hkd)T<=Y~J_>pO~4H
z#`JCyh2S8aTxkn`!>m1)W}=C@{jyp;n}+Zw0zPqHq@V4D^*19lFL;8#P;$2e)>;CJ
zt`_Db=QAa9Y)ptsd*UlG0BsB7fouHx8Eat8tYHiiRT7$*tYJ5(QX`&5<6yIY&Vm-1
zPgMk@x19A*cqUfCX#)2tsho7M<jm`gN2iOqo3l{?Pw#hJf|}HkJ}kJFyZzx56*Z7B
zGsfoTv<d$&UeCvnsYPE?d>t&6;fQ#N7d`h&gwk@~PNCNGUWy^!;sw474<*o?G$r->
z?ydq=-*<M1?H?SumEaPB5>i6G3~*)%I5L#p8(wRo()54>xM~I?pY>)J7zHxjVR%a$
zIvqe#c#*?WCj*?MF<>b$P-y&wzdfzV7EjZZo?&~z@~2kEtq5n;7UxX0$HVey+Kq*&
zcZh&pWtr;ax5A{iURTFv7#!?7SV!v6*H{v#W0c&Mp3CB7oJx#esaBSq_kygC$WnBk
z`6U&RQANaNUVXm^Ne>9lXW2)>%kb(yFZ-du?IrD-72xk7*s+Qf`$d)jaVRjJ9Uu4s
zee)*nqyRaAcL;L4SdF()z3up8Q!~hb8e~l<tf7k6_ove8L@<7%uNz}k&?j0wig<}U
zW63#BW@17`1Qa@6V+$$%F`^C`oR)^=#luOP7b9;ULD_JbMZtL;(qpwnCSw^bp<D+o
zh$TBg1r8&#;`bmpAV1x@qNIE&W-amyozB&8-%b2pEn*gXlyP5c5I?!<I^G=2{)Zh_
zlG-uri?`K;Nz$5_Mo`_1sm{;m-WId`&hj1de)(1%ECl?Ce&0Xt$c+1jC#{SEkLn_Q
z`dat<%D(EDtB%kV;$NP;q04JWjh3%vB=NiL!?x`DL$)uIqCvHN7R5<b!hwB@mDGhb
zTF1NTidO<?-cjqR|92*0u!@zIk40IzXBdw$>dteBI>*pVc;gw47b|1GKV7@$%o+-1
ziz8I<R%x^p-BGX;!|VFep=3Ey7eEQdEwKp2K4I-wm^?4sPqo*emZVGZu#R(NA7tE&
zx!8^2eSsGBjfd>p$N*Ss2y;|96*HXxC`w;{pqI9IT@ro=Lv_!fxMLM&%!9gT;KzVP
z_C>(f`ekMu=b4@QH+saAS_Bk8(469U_AzgU28JhzG#mrA$sd0XrCVcVV3<ZX7AZdK
zuMe{)(Q-!A1dUKa+R^rmE@|05U-Djt6>qX&rNo;gPLPq__ly(bZ_66)=sf19rog%u
z;W*P*?Zh!$F5PO^y3km*yMQal>oCa8Fb3lJfrL68`s54IE-9w-if1Ych-S~(*=(Wy
znp(-O_oH{ffct}xWS-h^+}b8xe<b}vARn!j29daE;I44%wZ9`BxW7Xca$~#`x-8|^
z9Zy|w@hECyA>(cIUv&9e_*F+!j+kpRt^*dLw(K@h(Je=zw+)9XujiqiIVSf)k3!le
zi0|@P@jnWY@omm)11=yO#*L?*`j`-%6O@;}#GG^{@;TaJm5ERf^#vrI9qiBlSFfB;
zsPclDU35|F_Qn5m`0|E-IVwA}{B5bex=T(M9+HgI*v%pk3c{&msaf8$77?!u!Ke*f
z82S3izm=Vpq(pxdnCj#9`?U;`j}F6dKG<FKf;;Ui$B6H;oZ;a4!9Ca&*p!d<(cS{K
zvjEtkU}%&{=uP)%ToB3NSa<!eByv-eMrG9yyP3r2LM=}7O+c7;Lr9Oc^*g~@P&y>>
zT=p02;nFmB{;;7;bSyP6&{Tw;%8rRgi)LvwF=kCd^aK64Morh;?LMscWYd;C?Oa&3
zri^lXvxZ@9KT#~FqFm<n$689ZpT-({Ln+)i$MQWD;RXxHQb(`vBW{CLYV%vpGBe(M
zIQ!Q%u1Uu?)L9l+pOlSxy-pzCd-{}XeXaHd@Vj@5IvEAlD@i9J#OmDo@hKnvQg|X!
zR@k{*nzZjn|9%cSuiU6c{*-*hdhn0wNr+J5f{^<CEAC3U0EpKQ*osgZ$L8`G)&_3`
z)0sIE5`b;(UNR_Wc<SF&Knm7M*SF+7kp@y-wNGcgyH-nG$R5tVRoW#njU%!8SpPk3
zpjN;O^!7P`K8^gOk|1<IJ~eEm=Ow@Z{Pisd3+h05&tUWY<o?p=7=UT3g31YF!yOVf
zI2!s;F@1x~(J#%txs8(ULphNaM^S*^x!B(k{fFDPlHNZkji>g<bY)acZLI?j7BM<x
z`RI0K&z)9aGvl#?7W04$fSN7(7ODT&>OCf4LSsOU58YXU&dW2|m-d+d2Ama(BjgY&
z{56KyTiIlebXL1O?fqI!cXMQZ7QP7my%L6aA;p9I?UDKnuqte^p#kzlb8r49&~fBt
zY=<c>5=`OHc-gN|kuzldB^+zD(~E3^`$HYI<Up#KWI?vX5YP~knSf=nPP(TawdJn&
z!MXikFR+YxSoU`e3SZ@!i>kacjMG1w)So<P?)h_oy>^Eq>{SV(OZ@<vCLulv8;00H
zXZkhX(avjWl5apy?oqw&Fwm#&dv*d*)0>0O$@C&2RKn#h4)cI9VHUBU<J0s&WAxc1
z;~P_zohULU-8l1yAvM<Q8#?3*C9QR8$3ql*xOpIuUi5|y4=JPZq-2sflv+has!nGd
z^2n~Q3DFd8WLnJ|ypCp;EvbhuE;EyuR9KuUFZ}AoEz@d98UB<&^VX5`ea!#An{|ES
z&tJ_d?nuj>_pan6p~NO<no!RDkI}}hB5;Rx#o>e_W*E_gDa&3Yr;$J!Nq-bvQBqaG
zBzu`_i%1R$A|m0QHZ)a9zszO(1XtVCo-(I-YPuZpbGyc$#;>AzwGWcN^=>`AnVnEd
z50S^AmD8xvFY>?2crR98`iIWUEL_(DZwc416aLLJr4>%sD5dR76#re{*|vYOOBDYp
ze+h-b&vUu}<raPgL>V5Vt_XNLP$d3!*QdGUGjiy!aZVT3i`e})P0MV~wU@6BG#(t?
zuPwV|)SQq==Or*79;Do$rq;U7Z>|5r?5-wcV65QQ>0cIl|7$EcY>(63RQ>ZW9XVHz
zK|O8;xqtBY#m*|}U`vQdD~69$RCO+nRsyC*Q?GY7k9<Mg)&zb62QhhLeZUv7yT&k>
zfZTVB;tagn0HKl*1xMM`8LOEw<sW7oQ!z^X1zsamyHYq8-}{27IF6x2zKR8UcLKH?
zP=9^Q>o=ve_STcW_k_96aQmjARmWw>Z>}4<JdHiLaeC^WZobjY!p~7V?rw=Gr{3ee
z`Jdx9fpitUScaA)LAUOMFCuAM=gP{LD-y@IOea@)#;u%FLOJlZKd&_*foKz+{@B{~
z*E)b#C?6oXSkxA+cp>@lTS05ElGrk|uM|D6A0t$XVRRNFO5;g+BMDkHpw+&MuCLDy
zQXAH!zqMxH{mU}hl5{T<hoep)6Q98lZLe1|QZzEuBqYbj8Ct{nnptv49HG<GTAa?-
z;2sO69HhJgld{Ld9O^x(bWDgacyzO-05y+cu8-&X%5zV+Ek7UHf!hcn%GIUvO(aoO
zR`7-btFR{k8QXvf1*Gi4DsAZ;;X}<G8h-kWg$z%eAcP*p>~J_IdZsKr;4h(Y<t8uq
zWtGddyW_l!od>cEXrY*?i(9TDH*G<o-{L8PznAW(S^`gd_D?^1ls3l_Psk{ZVmd>!
zEuEfgN26&rvy(Q`lQ8!TyBaVP`VMoV_%5SNaHJgL0y!5a`nC1J7>N0MgW_NJfhj)f
z95_9&mYz>MArCFK95DR)<qZit-)*W2tjEuvwFDcE5L|N_RXbS#W4Z@9HXblLsM|T4
zyjX|fOobM{y2K&I`VkkPn_998&MRVTZEV$)P9?)%95pPES4f-^*Q%X22oPMz5QCaz
zCym4kg}#Cb%Aye&R!x5q_7I;H7Q7k;GgDY4(xj7#V=Za2+tN?pw9iD7prvdgG_*Cz
ziIIKnqX4g4ovn7AcPXB(z5>>B9Lx!vwksytdMFHh`C|CroGVuFC3Pju>**y<_5Sh~
z|B)G17C9i(DsM%~F8Qz>`i0(t{@+{|T(Sm?!w9veIMUa;+%uWc)ne_}lz?YR`Ll%8
zk}0un&zXgcmW|Ca%k}jw^`*^?DWqWgF{Qq^ifDaWF<wxmwLmU`2aT_))|HdkqaJcw
zBRYtChY<&Pzn>SQWn%#$pxla1=obTHb9<cfUluKvWB2(R6C%Mti%Z1b$IDkC!0-Rw
zYRoPCT6{7!gCR;28kTOTymDmEPi+K7%_S#mXHK~a3kZgm8W?t&h`F?h)}uR!sHEm_
z`<U#{4h46In9`{Gk~$dA5@4a3vhX$$zWzWVdcaH_mkwu9Um}ri2j)F6pN=8&AVX9x
zgWF3y?L4gz_KF@OuS%L5bQ6S@S?S&vGKl>~O*q})j!v;W?t!9J#G}YX=dPFRgxcLO
z>9t3b6(7&Ax~f@R)tw*s6_g<hSL~0YquY)mu+$w=MMYQBWRzxR`$o8TFnLS%(NU5c
zCAC^zzQEY}gf#h=MWPWNgd;}ps2RhJOxB?NU|f7XN&c}qKWA`A<HqIZE^wfERkLm^
zwpWhF&zpzDI+KfZpH@D{d=aXzHHuU0xsL|Eggo#jJV{mjCh`PR%%P2#{`veaaErE;
z6|Ca;c5p?jtZM<tZ5?HTnmuzq5=Ynz9tg!lU%?l_9(sh5zyM@m&-48;<}V`K;ZUPA
zQ`DEeGG#A<2n4@|d&o`T-e;2N_ld0T$y3#E#I%$$eh2eWrFT9(UFv!icyqZZCg(xO
z3EH7gKBC=Ddbi@eGRT?(D-9ICdXPmZOc8;_E*OeB4F~rnA(m7zP7-9P+e$BH4<z5m
zv#+NMRE{r~;nQTF%(OUj`_?w9;NtxiF!A?|J`O}2K05hTcXVWNh51ua-_Ga%MtcXg
ztA9<QkDk|yVKHI-TSc}LWn5=FTWIIdl%nTRm|wdk<FpGsU}YfR51gmbT5i#ja#Q9R
z_sM|5z~Vg3a^lRm{T1X=Tj-)O3ePWTkq2lxH%(^YvNB(A@VI>#7KIlT52Zz4^|4T6
zCXhZUSSCJhCOQed3KB4S?dcko#x)3wtQ(so$bG*ZmZ@3F-VHggQvT$~aZ!x{o!B|N
z-{h4|?@|!CQg_(;Mf~wSul0o_<u6Sq^w9YO>{m4v$Ffu3V^kc+lU5zL%K>LoW)2q_
z@e~&!Eu|WKNf@CMkd(9TcMAG9SIFB8`XklfDl+-bOrb0N0EGB)blj5m>ISzd+a33G
zF8gTBTS6`e*s`24@ABtH@W6!K`2qjGe<x9#zpWWk@8iGDaLyv{-ge|URcc7Uv<tI4
zhg)=L%vkT8s-~rIoID>=DjFBa&n8ycz&O*=KGMZto(wa?q+v}u-ouA5SFcU5lu`}9
zTB;GCgMnB&uPc7#v;yc;Ue?TA0c}^tYRwh%-HALI8j249dAM}QW6Pct{t^KxdNa=^
zDdN9sI+)4J%EDm169#;4{3N3&&KgK1w_rB%5>yBF<K@_)iTz4cBz|oGkF=*ROy4jy
zR6KNLLS5<!VB7PP`N`maJ)m_n_)iJ)nj}!{&#=Qb8R>9j|Aa8=+5>v^sZ0dn>%ph6
zCP<_%_Z00<xD+j2^K?!3Qs3IUh92K$5Ra}i$sVrWmaT?3ZSxSgpHPvFHQ5vDF4gKu
zMuW*;z;}g{`CSL13Y>TaI!O<er`WlW^r?;8e2pyy(;{JH_Ly_VXE1wb&fh~eL7sXO
zS$6i!7Lx%-J&{kdQiwVm{8s|A@F$ZoUn%={5*0@u<&lWibVh}whKJlf%H<CB<x6|{
zf-IMq)0YHM5WtR63Hq?QpC8v?2iC}GwVMYGW`veY7ih5Y*W$U>-FB>jAlv>wn$Q0|
z)Oc{8HQt5&U0A!UY&yj<%I)|@mR!{_m4FpkeXPCG;WD3w(Eki`mwp%F<xA#Z%Xk!%
zAPIMmW{&on!d7~jQD!a1%9+23Ma@iqYLqi=OI2aSz8gE?6KGeWV}!<=8bJ>&RhMG*
zSn{AlAPc|4xsiv9-Wl-D@(M%r&d<USrg@r@N>=vkN8b{^>*bSEe6JMfh0?06{i$tY
zaM<ume0sGy{2K?Koi8REB5B@|FLbmp%J^OE_k++Uvr+NyS>0Fi8SYvX7M*QQ2kZUZ
zDD=A1lClM$%6Vpelg2ra*QVih7Dm%{?AB#Uzqu3#gD6%cckb+Khm+#Z+z<_yx3nR%
zElpRIUESfUDP5jC#858WPFa*p-M^?s2lw`kdI2Q@;E7GjT$S}9x_oM|x%FpZ+C3*(
zDaz;iDON`Z)<9Gby&?#RX8UKqMt$$b;+_)aD8!zVNpaZ))$EahF1BGKlUL9mc;j?>
zC(-l&TvOx$fTP6Xa!)Ebprsi|4g5KAkB;b=sek*;ext|s^{xB$RtLvZE`nAHL?1W6
z7=YbBGlx97(8F+}?vC!!+_<%C#(_}zruN`T+3AhXYQ1bF$7&58EuuY?wqo(LYeg6~
z895}-*yAX8ijaN68xncW9NIqAf=@lDQyd?jC_0}M%ZPlSe~FuJ_VvXI|6JKGHcOHs
zkWW9Bm9ZZ*mZYm1!mw{$1fEZwy8m7H^=N^mjzC7ys#7!3xOaKV!K3Hu(ygE@TmPj{
z)j$a!`9@UjV0{!)#!)O>)C4c0u>?9!ZQ;!gxQt0FjQM7$9mhu=w9}_!O%~S`Ndx3}
zOL4LSHFi%aBQO_U1I+|v+?U6Hx~qv&6)0x$aQL4$XB`rGuLU>Jp}VW#@Z_#UOQP>!
z109c)PRsD%&?|YkwY(mm`4^)V(PF6vN_-yq(86!iN3$r(dwx6zcN#T%5M_v>i~M@J
zigoRp*g7Wstd?fBdKsa9E;w};rBj`DwVcsspv!VcjDzedWO39oFvl>?KdMaqz$38)
zl#4f1<{m!64|V?S;`y=bhr$nSe^)osg&rQ;MLyxJG>_JC)zD@)BIZR_=S&#NIf1C7
zWaDke(_R*!h?yqIOvF=1I;v)oOK5~X=pc5vBfp&DoDM11y7Go@xRkO<!LC!sP!paH
zy>xw`(@*V|0-xWh;r|=2(r9;@DX$|hFZ))8jm8Q<KR{p@Q+<%75-9hTDF5ntmCNvQ
z^#bj^V3X4U&Qfp`>%~#$(-s6#!W-dbl5=Ur)DgD(9*%3j!2ijm8vg2(#ROXhiIrLE
zze(fT@bg#5!vYdez(9*WL6$_r0<TmVbtS?I#)*@FSW)fEzf@0xP!Bqos`!c)E+#7#
z({jM5gi51*6~{c+CFuxL&&j~k0>cOKSlKicyHJNnK4tj7NB0=B>iXC5v#&6n0!Gp&
zjvqXztJvFL4bha;jcIuqk9WLF;<riYkz#wCwUCyy&>u{TKL#F$B^PJ8JgAvD3X5oI
z<~Inl0yXc^S_ua{CRte17JjVi*7CiaUwDP>&{m=M3Bc?VwR?GX_kB<<y1h)tqJcw8
zyvo;KbkX6QXfFjS6&-eiLg$7rgI;;!%_U_M@_!XFNuoLnSp)ci3YaftY!tC%3H{Op
z=iOD+G+)a6u(6safKe(p4CE0zm3_W3_2gBUYw?o#M`hN*>;nR?_zYeF$4{61@+6TP
z&HC~ZyUiaT{NXt4bNd#inD188d`8QVO*~Pm6*v8_WmSkjTWCeG6*9#b&)Crilo!ye
zQrI~>n96;yTQRa~PgE#kLIg6?!K9wd6ezan#;mtW8lsu^o>qOf<$(5gVQc=naLex6
zJ^EI?fz`y85JymlHe#P7WfY{<9r60PQc^kAsC-lO>=oW`(e&L?veb1tDpOy{NXtau
zv!_Ue=jc-@=`7CoYSNre&Si@!Ef-NYcfRG~5}M7uX*`5PvMUtb+@C2}!>=TqO^vFZ
zUXP-{ymJ^i{B_!ec>j@{f4K9;0(*p^&NI^=-ZHo%bN>vRqU$cDI!X_Hu?=|<FCSf(
zz`UmUFRX9J%4u%vJu7D$`qC2{KwZM_{$Szv(*#;P{RgX$^j={L?_(Y=WTFYYxycy>
z5fqrFTdU&EHEosNfeDmF`Wnh6-AB>n+kIE0z$D%EX7LXdQ#jEijNZRpAe(vbdndqu
zH<GAUKvuPbU+V%FYOMGa2VXElh8*~fjp`I|06^8-d;p7%3WViE)P;++rtYlOS>d_G
zdGKA$sQIbm80-z8Qqm{|kQ*D&H~=@#Sv=rdCRea2t$ZQ0-QH*#k%*G%K9M>=aGIam
zeKI*lnJfm0g?nD%G2D7uq2m*h=9S8jq%c?QEStlx*M}R1yJNL`FB!hn%bjxU9FK!P
zpjlv=q{8IL1+I*7%#EW40H|+9)y<vPsfKTrbdT@00-?q_S(;W@`M*mta9Y3S+9Za?
z?n*b?Q;2J8(mdRf<z1$~3H273?oOs`dXR9jpCk<|<0q9NE0|}`$ZYYtY#wh)SD<DD
z=$;e>{)Enu=4SkQJYJjjgtJ3(D7jC!iWT?`eX4uO@S;Jr0!@|jRn{YsGm&fSmqUSl
zjg-`IQq*`y@^d3M`4wVG|9<*GLiZnOM$0isApY5O9#Dr>#bC>)fAyj|E-(bUFPw3`
z;#S&v`(gbt7hcEr=#-pUlo4SWU}Oqt??pMQI;T8xNY)r!549*;k`Wb_CSJ)^+fd3$
za66Sq*)aGNT`d5Ay;kc^L{*9IRgk<Mx!dOyEI-q0;tL^Z8)m-!nBo?iXaw7NNTcG%
zsYD@r_DWO?(aVQCc#+r;p|F2OK2<Pw7IVK_=rZt3`TM_`63NwpM?UG8c3EZr$FK6j
zr$e|#H!oeBt6Pi?Z+lu}!BjT|ggKs@SbBN}jKs^9L=xqDybl5@b<_;q&E_rqTF59l
z^b%;j6kG#{I6(44;?_57a{7ombR|gbiK`L#XA`=W=ho=I>)O1$a@seU=r`rAp!*{e
zi0|m`eKs4}zBszq3v>wR{YjFiJeO}OzG}vpstsLFSRZO}E*T&`z8bVQ41CtaDv)^?
z&q`deHTOqN5MoQI-!G5T`|J2Pl4f#&MWcFjGr&u(M*6hBbcu#$m##NnZtYZ_c4;#!
zq=&W+B*|&M0V)g|{0i4R;8G{L`*iqIFEC?;se`CAEfJN3iwRz~2J$-6XKIJ*DRg&!
z*h`xO2f*l3;b0l!RvKThXI9iNDRlD0Z4(-86yvE(Ug*MriHWhtqrJDijMKakOxK@F
zCAflB5tY!&x3`SMxE+&4@}>9)Ogvx7%%)B7yQdCCnXAz1)3)038+!POH9C=dafIw@
z!u@Z3Kc8Op8W1^*KA^MN1=1@3IqB^T71+zg4ndH1@ZRKIs)Aa2GMnGm_iW`l@v}^g
zG*gfmOlI9~8Q)}0f#fU0-MqsqWOV`KSy5#TG=60tD{)P@R{0+z3zF`|n?Y=vZ{+Ti
zAC0%r#apcY`lU0p?++h6ltP|#w^ddJ3M)i5n_-^XP~UOQ>El%9oi)AI@K}hYPiZ(k
z-F{FAcjG$nnrCmyX}y+G;rF*5#hu-7W6hx7HcleoZ+S@iH^c7XjTdlZL+El3!%L|@
zj|dDbVCs+vARc7h-rLW~AiraSyA|~_;*DZr)7DN|H$8R{<JL73<aNEl4V8~QU&X#T
zlYwqd=(|-i5yF{iZ0;)#(wN{(eqG+m`6?xp-ImXF45WXr{UBfyr<r)GJfncbZu!h>
z<rGo2_9dUruF#Ht6$SL;zmw!itC9TebFHwld2BwJa<M>xwM`;dq0YR1lT9F{M5;5Q
z8tR@dJ?7=UC-(&)o%ZJ4%^!6Zcw4nIDLQsHozA<Mms(19lnx-vX}S5;EorUTy<>FL
zt&ND264Fe|HMZw-3dqqrLjzxi^dZ03J(C4_6`oUmyIFJJ<~iEEwJ&AC(d+}jD$Dwt
zUm1k0syc%Ct8oTDuInB9p-xa5UiSqRwJ0>$<9*gql+k17SV^f_P1n0qk$n7(bS>El
zzIPy_K?*CQ%BV-)cl1C)yxTeOo^KJ6-$B+XzfC85a$*$nOQkfTGZ(5&+_zZ_Er$<J
zv4kqWQn~wno@MiOH_51Q_k>tV!6K%U7ITJ@hU`8C@zIYO?T=K>XI&{!6>4c*i6kyd
zK0fpwLdiBQqz}Ys8XVCqY`@43%@|)MP8~%BuAj(-I9Ce|f0<hx&ltEaF%U26n$jdF
z`q!1_f@0?)880>7eVXz9Vs!vits3F5j^(3aQ30(3-Pgs~-r=_IlXLLjATPDNXsotN
zgt*>kCR`axdn0^Q2TB0l58!(YTVzgJ0WqCk;Za^q!71iZjfr|~aN?b0)GO0xQ<0s2
zyT5-zyWFz7a`ny0==>$<zcwHA{AF|c*@pA?CqZh12ao61wO7@l)h9AZ0r;+@hsIv4
zCP}nAhWceyb=hmta;t><TQ4;eFJ06U5XEh6{T(t#8&v6{uTx!_Jb|!$-Fkq0>(7du
zVNQ{2cV<4}q7wmP!|}8gwdd`&bjziuhK&w4-Ll-2IShYg>G9KNAN8ViUnHVvf}@PE
z4rMnK*t<;pa(pD#9!@KjRFCpjO9Ou<Q$Ln_T$WrFR83rELnSlEOXIYh`c40h%-Fxq
z*~$Z4&}sQKptl_SvIb{V6i5oZOk>~t7?4efCTwmtTCS<(GALKMeFsZ<acYjB=fJ&p
z#Cj}N4}-rcIES>jaw+uuBC%~h{0}Mp#4$lW@_5_G@sC60_4?nhSINumC;gG*zvLf9
zf4=b_`Z(cf>_B&@vzOp?hPEcqjm~bNF%S*^$8$<K3ZqF!43LmxRLj0bL*~HQYW^mQ
z9;MGT^ojjk>74DNYhnNth#vS}f)#A%Wy`P94aJ|)wX)Ae5+B2<GBWE6vm~pW8E+Z*
z{_Cmdb6%s)=fPX9LlwL;uU=1MJxJ8>hA=f|rf60>hTqXbX?fv%!Z@}pxWyg6YYZ}u
zW@pw2t}>&{E*VHsVU;=!_tKsi{yH(qCujXkizsXX!NZlO{1V#xKUiDSse|4Vk|qI-
zvH&j-Pd+&{&==V098SI4=hXXjrWbk2q7)e3mOA21t?O-l5sS%E*K*9h#%rA-5wK^>
zB+$BQvbl=Z@$-ndLc=f@aEMQ@7zry3*nKL<p>t&(H`vtBF#OXaG=dGEJ->Yrw*{t!
zNQ)G}hB-{c@oDZ8FHlLOb`VQh)T81ebe_UEN-+8zbd_Po#`klvF|iEXml2u>us4A2
z%3@luQVq-(Xyx3w67xOI4u+~)a!b56oUvYCNH)D)n6tdYV6Ckp()|9xJH#5buz4>P
zx1=cro_Cw1ocF1hSaHlb;K6{y^{WuX;~5cBzlWX=p8N{l%wtQ;eeu}0JQRx0u{?$5
zef-qetDU5Q3p0be7%mSYJ;@b9V{<)R6M-Y5UhL*DoYBJgMq^Q#^;*o#3{Kw>zoMZu
z=Xdn60g87rY{2Y}KO<j{hix=7?A^G*GNgp>3Hm9-FB~E$ba{X3nepCkkI6;MXN9OJ
z*J!Ilyy?f2CTkQ=-Zy&`mr0sbD+5C5354!vjgX6D?IHXfg#Y%fkFRmS2MHV16A8N|
zD6pqO@8q?cq-VKKJV=4*RXg~`2)u1VfqCH5C3nH7EqK4I^W#*5Y38nV{Rzr6w~F6&
zm1X*_kKX<19xc!g6?;7xm`q!qG<d0}2(>ekKmuk11JXWs5F~6i>U4a*0r|VwzJqx)
zrl{VDl#J$Ck!i!nd*7e)K8}21yfpptc+kEXV`L?fIdc<|W4hzKteK1v$sq9Nvk@t>
z4&<hh#zBULwy=1I=ulG45-+oL)&?YJ$CBB$WgPU+B^Clw$t7?0tMj9bjY8IMOkx))
zyG!*P|Hilh;l$->guq`V<)n+a!&%DIE}8Q`L9>2(yPSe>ubK;ZbJU(^y;{wNoQ`xP
z86`OOD2><im%VfQFDW%t8eevJXVFoE-8^+!e%$SsVTTWomS<Mk>@(K!zv{TPCn9@5
z5w)?b?@m8zJk9RjKfwPgq^7F1|9EMoTxh_%xG&nQ*ZEMlH!NX&s{|D;y8oLjke+|I
z2uuWA&$AL7qSf5K5r$vBm9SMO#zf!!7kZ9u5i$9%mQS}0iZ{Qhe*LH(m5QQa+2-|T
z-p+{sp23hr_0D!-$iRxBZF>Ur;hv;mZsRob^Y_A<{JgZ7PLpY#K?X-Vg6TjIl}{4g
zf9i9I>{;w;*>MOifBoJ90U@VZafF}y7|~>7P8-`X0u~Y6?@g@zJz*+OpD&!hwMLlH
zey-&`@Ro{X3J_bLUXnKaMsi#vM&4voRKqhkRg(8~9{c3OysFTg0g2hq;)EIy!%=sy
zkW;&<a)#RUAykPGG9#moN!t0)(RECt#*m30x7p+&6DH44u!h>8`KDlSaQa5+O$`nE
zG@U3N_BSwVrnz>-**mA5-N$3X+T-&-RwSNkjG{Obzk!%b5EhZHHRIY6@Rnk;8r)lO
zW*&9#=#-1V(^aCc(ka?s84`DLGFcA((EoS4+mhXd8(V9H@3WwSF|G6PMY@rR@u7r7
zc{hek)W>PMv;lp8s|)4Z_=_B5K9%Q{Uk%Ibu%#rpxZAWC#;=hciq8YxTylCz+hG)_
zxi^|j)!Q#<m{0B73HdQR78QZ2EottDjxdwjcjN?&J)C*Xg1YVvQ05|KRNBaU@FWh5
zZ(H2M2Oiu>?68c)fyInGh9-I`ldC7h=T2{5g+lXsw6w7FEZt_ApJrRx)!ZT{AN0vN
zOH{BR@@u;{lKP$1OMm=}A=W+Or`GbIf`WG%I5+E5RhlE;lHQm<fE$iWomqh%A*e$!
zwGC^#6T#vu$1Ana-EVN?FDowl;|l5yTsg~ZbNvwd?=ptvf=0jeS5Z)2kxO-bA?DaY
z_=8BFDM9A(Jte&DE~0@Ed2LNwWhGYktj)P3?(pX58$)~w;%C!m^DT)=jP=+X*LLUQ
zT!#OEOf%8Zot{@+7!;zjw;Bvk2XS1GgQ||v-)^$x82z_XD3cRW-$v5Edko!vUs5lx
zZO2lv>gXY9@ZDT=8UGo2`m*0jEXnib&R-DGbW?9W$hd%12AhcdS)A>pA*XNZOti*3
zx>WKOzE_zA{5%W@A=7bK3D)0X<*Uu@76Q=BrSQS2?dV?^JUFq*kYH5+OL`JEKSzuD
zq+Xm7C>x?eJz02I2A62xWw9hoV(gk*qMJZIP;38I!ui@qS{nY)LkYtR9n1Ihr^Co{
z8mjyR^a0Q{_hDR(5(jTf!oQMjh?R@bRLVM}=nzH$LAzq|Q>K_JCQ*8H1;lG8FQ3ds
z%LOtppT1Y>ic9C;<ttB*5cUoVX&rl$Z=T8zLtHmDVm&An!n-P2H4YI_FcZ;aJ;O+X
z!&n06U2-C86EOBcuFJAaA7GaRF|n3b+m+_auk79{^=E$07<{Iw=-p>SMt;>ltc)4r
zy$a`hN>g+|P$|IhF530`k{Dx4$Q($i6b~*8I7<BPm-C%LxanZv`TG15B|%nme)Wa?
z$}1c-8j>X`a>6H+$>5sPi@&Z2jaEV8$E=K8!hs03f=-``mshJUGlYDQ-d1pTkHIG#
zaa?;h)v=_fgcwtl%+@cENH@n~OoQ4r@3`fUx;{$=+vZVF8MhtZ0?UHzMt8B1uB6yr
zA+q|PQdY!O!m}jMR1B{K{`4i10&=XOSMW8Q#M5{Ka&qnC8cFX%UC$Sy^{;cLV?J%$
zEJ<3n++J|nLDKAOsbOhgskg0D7!q}q%tN`7(CfovlT-p(lu>r%3`)YV+nU|A1i==y
ztwVcx-_Du|(<{^m>+9;w0O2_V;*i(-e&5>pcRD9JEjk?j`3s%E>!_=Ls5rL4eGIYd
z@<~-<SVd|9ds2Kf;jMN=wHVcjt2*W1&NeF^tk||yJ17DyduCSfez}Zw&R!k<%bcx;
z5%G)hReM>&-N`yj0`!R@3&b;q*wwC6*~s%m0;;y5!m9AWP=v#wnj_<GRM7{#;jhJt
zti#sj|C$+8<P^nzI#5Q(UQI;FpC8AtV}K$3nIk8g!cpA#l*48<N!HLKhgw%x`IY?f
zc73SfF-n(4H?5^{+>T>8b_NU;<iVSI>9CIY@9kpEn?;buVrp1gxW8zO$t18~2_PW~
zdq)FU(kC(oKnmh4+z=ly($22KzvWmV(#k<CM5``<blU75h?wMP;X&6%Bw)X=1&Y~r
z_97`4y@=7fqZyRa4seSCe0xo<sNkht<Ve7fwe#W0Jjp1^)z~Egs}mUJrbOTvnnIV;
zCBo7%(TZrIF<L1qvW8dcVN_e<bAC<}A)U`bnOnT^xMA-CVUhg*Tu*w6^T`!JYbq44
zfC!!}F&vaf&&uo4lW+*|UchJOF4c%y`*JKr4sYdNzyfdmq3S!|Sgu>~_)?=2zS1H3
z$tC%E+KgrBby`;$=u|nwSUs8>$Zy!UcB&63qkjF<8ypvLQ?EtCC39zsnl9LE=HOC&
zdHC#gVLy#~|FHL4%^By<r<#iSVC&pW-b3KrXl)tvaK#suyx4s0&=~LnN*6l~rRAad
zOLr0rROm8a(QkS9QVP3cEqz`2bso_NDagNgO^tb=ZIvMMbetqTF-T*EgzOI#U<Ot-
z^0xGLpQI%h_6Xx@FnvOjUSO*)cO6`DwA6*bV-zr)O^3PcvmuS>75-Q1NE+COzfpu*
zlwNz<)eZ4G5AXvV+oU5>gpzQQjE~4AHkm9^(;v*|xWjrN+F}&BSsLhT#45{!x1}mO
zcuoF+ntW(=+wtK;pP($Pi-7*-dPtHnpeQ*pgR+<PjJwy1AMpBH1|25GF?zIRpvQUf
zs`6sjS-VWf-SiK_@cA!bpz3YP>H;PM4D3lD<i{<3UeF>*_-SU3cy%kyiYtsZSp1_;
zmg{@i(TjD0*8o^8i2>WUnLD&+FNYVI=}Mg0-7K5PU-^hbtHyCExJMEqK=6;GabSL}
zn4wTBfQI<1FX%{-u4W~mV76K4x%B~ZLIO^2aVu1VsG|0*Wa!NA-ao1xl)&>g{2%=S
zWb)5DjD7A33B4q1!^c$DU-Shae`6B;7}C;=t`ZR+_r$>n#F&*wzzQ!{z8AyMIKB#Z
z?Ag!HVQqKvoWpUe*(~oj7DP#y9MRF*I;!n*tTHWHR?gY1>+02}zimS=oV6ibbs_ar
z8bBA-H`V!RKG%?tX~yZCI#%6UDJIFkBFKG}N{w34@gC5Lr@*iolv-g_IppLxT8v69
zBO8-lu|f>ixuN%>qj<ZahuHj3JQSCH;xp0|->pD<`B>SYE0lu-6?Ln0%lO%My4Cl|
zupTx7%%w_w7T(af#6V{H%FEB8oWk>`(eUR(N+l;pwc*1ANUcxnr_6gGS)kNk9ZXoN
zP-n-wnI_X1+A_TGZ(?Crv~8%mUyniZnvVhX_L*61539Y51G_`<h!|@;#SIvHJ2m@r
zONvamvP$*3_fH7pBa@gXTQO(ltelEVGHx{76}*aHJK&dn=GEz^T(2&^N(ISbhWGRT
zhC?9#=qE}6Sel8Yc&#|=1!?(9;q>Vf@oCGi5I)|!l0CTLn(NlYgcjNg*Qd;nIXpdp
z0jmumpIF2z;MU`_Vl)W-u;dZQcz<*+FjtT;I+>`xYI@cnHE42jYXI2+w0|5t?P(bw
z->(7YIO9{;WWAM#P)g|%m@dtczT9-uOx1O5`IFBn%oz5Z?~O&MgW$ClknX?wi=MT}
zqZ;xQiTg1PFt+4Atgi%DH<3@`?aM#YD15g=t)pWdxfqrCEhUHN*>K|Xn|$c0>1`S^
zGMeL?XD;ss4yC~><f1&2Z;xIQr_C8MZt!%Yk%Cp>6D{EX64HOC{9#C7GBMaueFo=G
zx|aqJ*hDWp6aI<GX8sjoRRUDem!CrF)Y6T+0=YBf-NLTwJn3s=eo^VC+b<Na9CJ<G
z9=%9J+~CU3b3+6CVxf|EUkwIO^|?wbxaV%IZT0v>fJ7`qZN^=u+dltHz;<ua%0N3=
z+YiH{S2rr6n$6-8{1cY@8i2L5srmifx5Xm=U4BN<{+ah+s+Y5;<%vJKtUwCwlON2Z
zjEKpzMX?LFd8R0@nol!v_=RF7KHVab%g>0i&C?qZEl7*>d_GM*unZ1YJHngBZio9?
z)e%quNWksUsnRmguyoOXq~K9y8VzW`Ew|U)GlHkpY5)|HhIlcn_5yA3kU?W0P@SQk
z0e<fKr-LvLo4}W+ozUJ9OqfzY{^oqdB}ltwm)I`CbaS}IB5g&hVOx^Rng}zXa7W6@
zdI}Q?2YVqon?<&@!I<RbfE2FJXTLv*yg0pD|I4a^YR>lZx}o1!A5x&1(Z9qK#z*|A
zQxwgfp1z9%!sxqeHUIhBQiAB)=}BFpjabSEGt(3Xc4AGbWUZ5)D6eF`(WL!+dyU8n
zeR2Z$3zqtO01j`^$<|LmYknZfjju?GG2Ac}NuNIEW&fC$n)UX2M}h5kz3-{%Lqi-@
zS8i6*YSS}cXEi;5>U9Ig1DThu;+fHZgy?@_9mdzX2|WvO=I&HNWYXz5Lc*<UPU&Ru
zm}SkBks4~P&xZ3a`qZ1MO~<aJ!d1X<7m?8Qs_S-Uj*7BppVb}3572ErMUbt3+|RQw
ziDa!USERGY@VaPedXICErTn8g3-4Y6S4+yCw^Ht88SD1&INBkUr~YK?$R2&MSsJSN
zRa~FOq`(5#Jlt13m$+#vZBJswVc3My@dL-`2L&DsF=NV;_c>M>htvFoQ<lSdj)er`
zqvFL|oY^gSwc)$nX;(yX(Gp4Dj<TXW`W!;(UVwj)+_7^Ia<GNSYL5il?J0%P`hfX$
z1`Hj~&LNpnl}N}y%ep#NWHirf2b4q>96;kFNyl1&#<u5MO>c*+;XLQL8!%i6GC?C}
z9&Qau2D>40sTvaj@@f=d5h#IynoQjNgZu8M;iXFdo(Vlo642JCS&cphMAxnpjY4p)
zF4>pFYez9G$~PE22y-?NNLpAB!@DqznJLl|FY%Eb?TYd@Dno{=SCO^J7hIk&s1x$U
zrr~KF*&mvfZtEke*GJLn&QCRxI6XK2(v?481d15GbE8M&dh-F^9*=t;p<}4V4oF(*
ziNA>xy?}hb2Vf6D9K1gMkCL&j!!w+jSrt`czw6qj9BobRZvwg<WplC=VKNr@FTba-
zBirzDm!!7*i71xc?4aEnV`M{-zX1&WS8ttU|2gx+67*wKG(qGLd-uA+w_1>)C?mAH
zVxMVGJb#0lIe%jgp68xg!s;u$VLlPk=5}&$_)vsg!vC4nrO|nGx`3%lmIce$X7gi+
zxASSnsTq>x+YIk?(R9)>4Sj2QiiB5+`~1NVVI=I-a?`8?i-nA8HJ|yCx<2ErmxE}D
z{b3feDY4J=7t?NjFZ<3y6zLcNWN6V%;(v`G-UvSQO(d9-oX$GVO`Y5Yf6!2v9F`Z(
z(GoQuO9JMn@E_W+L+eOnu9abJdMun20=!e;Q$)9Gkt*F-5mB8*sQxg^DObFr-LrG*
z|0eDr0laOnL~VOs0gUemoAYws6;Qi&jrJ1cIjeBP@Ys3b_0Xx};=2T<ZMwp5@;9ic
z9L&c@0>~WIZ8+8dl&3NAF@D!p$%gNV5`JSxi^CtfN(Sn=0-uKwV|C54U6l+oem|F^
zYGX;xdifvo*WaBXm~zX%K;`Q!FCT22<mmMxWqy6H-Lg)v7v|#uesJ^Xp#6qxVowxD
zQbhsiL&l1*M7eyb&bDm8l1<-QW!gqrlCDN7Unv3_eCcTl_{K*I6*sNZPZ@P3513A0
zs2*L#?_pE3{1mQP)9<nHWh%M9YWXOFDW;ZgByC$dYoD@I|CI`kk8JB9k_EYTs;1fZ
zYnI`z)$i)p%${}=J3ihMQ*{a;@ZfYNS06$q$!mm*P+!`3-{wxu*TrHF?eMlkT{4+{
z*?7o^RnO-^E8gtQ_~Z8<neB7#Iz{zdd*f;QnhE?z*Ui1EbaIVoyR(=<IBEgx?QG(0
zNA}Ww)4pM9J^zb5x_mE9pvWccAu%rsg{!<WgSQcviPH?;S5$&nMQHESjf*LrLR9F`
zl}ne)cm4KgV<>aPWXdVjPmlQ`za`Knb{{#mSCpq#Uv|W+D<X2^(q8>y;E+N<>b}1t
zW=M1{beWE($B|@bydFnIunL)u^|I%jYKpfHbFk8vj5|lKTj>ej)QzfK^38dTXTD+m
zG=Ia(TUK>&_e0i<Rfo&{ZMsRmr}LmWbycq&`IeT0G~&o;6I8pEv`@aESl`%Z6%!|G
zulDr)#N@eFn&MDg9E*^i`?jV})l$A3o_w#3Rz7bAeM&$SSs(v4`aE|UR05Tv$QE*9
ziT0olmwZFLA96Z4GTyjEVzcEWFE773{d(GbluIm`tq5I%mjj4XLQjI!$xH22H?=Hq
zZl;)io!nuLe!7Q-b+_!k!xNzd&QDtJ>ID4{5b`;k!tJ?NlTic4#70t3XpI#nQNlDs
z3;f4n8}9a|_QX&T#&?f9hcy9z+r#?WYxQ?q11G0l>N~`@V8kg^RIt3uDdN2W*E(XR
z-JS<7i#LphJP~Y64KNkyxXlO5dk?D3I8Io5XbVq}`CF5?0GxgGt38dm8)23F^tP=|
z^eBpcXov@YSXqyFxLzSZ`*3iI)-Q2lFz)^_V%J&P??WqF))=`YpC#{92GomBm*v~O
zWSNC!4u8!RtpB!N$YN^N#d}jKWuzbyZv)mOlkJ(ZW>}J7{dexcAW-0(hG85t6s5p7
zwehrC*YqzrCA!Ny?v$7mKP&RI(R$#)AB|q5Uhw2)(62$fxxX7M1aI3fCvxc?xTAG8
zj(g9$62ioGC2IS4mID6%Qy|*haw3<`(i-1QA$Vk?Wh`%Py;U72WBSp|<G-CD>~z#Q
zBP&%+=)4su-W52N)Tx(6uXr~TvuM}q){f{so+~Yxy7YS}UnIa4FQo_=G9Qa!@!rjv
zVVeTd!J;fb$tT7$2G086%BHW;h2C|e=KWx$b25Gt27sV-as3$kwU)RTD-PUCq^G3`
zELnr-RK?9%B=%t@mmfN~D7H8=P3*guln<bH(?AJ@kXVWSZf%Xi_`K3vmt+!8>`QPr
z8YQifD_qSLv~6lX0;C+GT@he4G}8yTVhpIvT8#?GST8BRAUu?mEc<#G7TVF9^M@0+
z#a~7kdhIW>^6e<<OGf9TbyJ{rZylxtJRap)U}iJn#}FljIXmfRuhX^w(5}%0deOTb
zQPgP8Y)3PR-(I1lDzD|;Bu>6I^Gs9$z^V11Wx2?=t%c2%EyTw|-Z2aS=dq}57DaZ9
zpZ%}<l*0O#`^MiDSrQPX-xC%(^3nX^Ikn3sg-}Xz1zEW%cTMeIlYq-anl_2YCHe8h
z5{1Eo%@@p$X&e|zKo|bj>sfIj`a48;WlX1E654&8oufGB2DGlGGU{%=D;fO$af$hQ
zHJ)5dRr=c2D6u(FTFl7<tr$sKaY<<+aidjno1qgm<~!2}R_BZKQmMq7K))e+O}Zb~
z%xFcflNZ{uiV#oS3#{1jQ##k2%2easUbdibDv<Zz<7j#_w#P#Y>@OBrT24Q|0v`p5
zgqlWcO5$d^T&4NT*FHx>CoPY^ztlPobwLDZ>ZW6VNi#&r-g_Se$;<@+R3WZU>Y6(g
z3Rr<JWw`c$#>=K@xV+WoU`0J>Dt3;#`T^_WCW<OWFyRF+{VJKG$QjK*O{dOY)9pcY
zb!CuA26%&L;Y>;aZkoZCzLl8>?wK4ZL%1`M+K@A==JktCYPgkP-o!)hEDec=E?O}s
zqxPey@P0`b__G~pS62KV=D24xZV${}R`oA?_HEa!7%%5v@)P>t_k_;|$dga_H;0vX
zQ<?&egQr7sNo-c!Z!*%ptZD8&<A@=~%nH?~P{RPcGE%hKv}Y8du!Otn1ia7s#jtBC
zoGvlUVZ`QppEq+tMqlj>+IPE85V5D;<Uzmbud3cx=g`ztso3b(X#>1Bfj)w~;Bf^o
z!NmNy8}r`~oGpn#0Oq5=-rX(Xt7(oojSQwJT!f#us|)=h<IT&7Jp#|VPU1@^4v3C_
zIz1Fg@UB`ivbL+TxYhE4kZiq<cKUMOWpaCyT|+g@zBjXr=vMkTuG*RHK}(xX<$|2R
z_(CI++3(TS98R#+d)D&vCr!N!!_x_&WiBeiaMTJtNL9ds-w!}<c|~{UQqLwr<W82<
z>BmVpg#pj|(CoW_*#(l>Q>sS;eJk31fRK9Mv9E;3ebF<9#u*H`8z=hrM(-s@Q@Hg;
zNLoV~zvD=0*p=Re$6o8$w;wCUydTCUkT}fJVWVP&)%}r=93(m3;_5})4aCI-wyhFv
z=wL7|V_%A3J&tB5T`W@jikUgD{zgwn+{($Q;?q#<^P_XOp!5;}dcXTb5<;lLB7OQE
zU26a8{gYjuA#WAFn?K9vrtV2<(*9qFCv^_ZCNR4Olia*_6_DDST-n$+$mvkLjYBjg
z`NJsoE*TjMfruNX(@96iJlAU>2+U{A`eM(QJe2JRD<q5GPEpHVJSQkPvs;bHZ|=^c
z)qlmLZ&6jy-yjospb}L=_pX=pi$cFMVnKT+bn;*~9L3wZne{@5;{bhP$cEy!NmS{)
zr_ph=kWx!;MFw_w)54-8_S0oxl9Y(}dh#~oq<hzu`b%k1n4z+Ed0X`J?A|9sBTaIA
zT{plj=J&s(yjWS9wU=5a&#&*0!MG&JzGMSi+^RLX#a<HIdUi{Tq-N-+4{^2z)=Efu
zO6Om!c|(DnGSP1Xhgwg=-*MzjWOl7l8<|=MSZU}UkH+k225&U89<6DxwAYlPm3yC6
z?;H-?veV!|LBu$#*Vf&0fuU5xA?}`gKtl}2ZtKeS)fJfoywjMJnW<fuh(@un6I+TZ
z^QP41+k`KYz{4=YSqM^B&?^Fp;woz=qqz3OGEVZ>UmAv$;kOu;19ES^^%_sWPUfVq
zSVo1=kx_U4?9uB6lkHiKAElOZyrq|cu@SDcphtR=`!4z}7H>r-Ao(VISlN=zO%M{d
zB-<`=k<e6cz3+WKOh>8D;Kz2e_R<GUJxrdn0VyItKSYnyeuwMu28+;NXH`B9n^>~?
zpd<sj%#bP{G^S`{h`!xHmT#<eeo%4T*38w3Yn4i)7ynRn<9MVNZ;4h2GDtQn%EtME
znGD6Ps8r#Y5w9bE9u1hkau~K$FaaA9G%aa15>QtwFiWzh6>M`?DK2fP5M~uv#Rh?N
zo2T*A3y4~o@?DW;D-}=c$)U;0^AvY5sqEpi1D;>6$-v^LxQqS6Bj1+I{Vh!W+atBs
z2?bqSgpztb@}M>zG-}@^_@@8;F#7?vDN?UX_k`$sCudFwd#O?}Y|$O_S&uh81+On7
z&0<($J6CD#pPO_El`alQJNyNJFM|5&wm<e_1E&6D9qptaJR<KlyMi&Hg*5*1H>*^m
z$zXp%>51sh`+w`P5E5%Bisz$-kRwrktZ~CylE+yy7ygUzna2REO_|M`y+}Mux5q3h
z+Ma6OTl6rol^g$5!(XQSi;2`VBLZZDTMunP1<Q8UKPE0<I(>(bG=98p!U@ulP!v91
zB2ChHV1ji^jb(gcm$+siIe+ZAcEU2dEv$K+?9v0mQIY>g(s@U-^*{bUAxO+vwMuMS
zYVVQQw05g_mm1ZgrFJVc#NMm4X6?4xQlqrgj;$!#s!bB3N|6{970EB3@9&(~x#!$J
z?s?_DPEPL4^Ywf_AB)+j0x|ZTRb1EB^S60^!=Vph_e>r@35F@DVDm@!BfCPw(o;y#
zk3D{=^$)f0<D%jW#F~_1oH0j&Lxw0{tEonOxO*InSfiG#+{;3mQ7s1bfQhk1l1^6t
zWBKU$>{q?39>0Hu6I}FI*M)Uh&oC#jNjx6mmX|k-aZmUV$2nDGkfVnr?!gjP$1w7Q
z+RI%Of^o>4EJr_zVA6=Dm!6^ibQ-v-<73_-yy|wgIj`lHYkiqBK+W;V=0V7DMB6-9
zo0R{ff(pXb%IB=~?S(0#x=Dgy{{Ux^!Y9Bbl_Zz7Kyel3FpE2FM;Qz+E7VwltqPU>
zdZO$r0&Sj8!n}ZV?)-OdM}xbSw4Y$Jv~~M!F5`dulzk`pWzu#!)OAxL@(zMbRm?go
z!B15TVoSQwsQKYF`hvk-M~@3?OaS~Hxu4NCdt)-;lVx??ycNYB8cR@*fI5bqDFqP6
zYb!sBz%%AJbBS5pXu;Z}z${{(WIgNavN)@t)o+JCxilv!r?_BVbZv6q(VIn6WA=d&
zKg}Ui_g`=3_mim%7yb@jcZCIizo!uJ&nE<%<o@z_((YS0+z=M!W|7t&E!eDta2R>h
z&0lKEuohkeuUh<-L*sZ*1ha~!+J^&|Bt!(ZhmfW}<_Dki?KHScB0`qXO12YUNajT4
zC$^5hJKPBHwO2vw6tr{X4fg~I&rAa(3i+>W=;qVMkBTKU-6xi7$WhDTpUWu%S+DGt
zgnnp!DlRFJeTyu{$z$)x^qDiVh<dHvk(<6)NE$C?JML@Cw0{=;O;Azc-4)U~m)O(e
z08(^WV~>7zcB-rc&EN4s6|kZGW;!_9Aodpa(GiEFd!K{W;L1IJT0TC&3jT~2pPr|9
z?kbwzj_z7d`C<023E|pSyn#YzWoQum|1Qcf%u9UjUJvA5rp0BHTsR)MUefG*DzvxI
z<ypjpTWT&}44e(IxwVnpBQK^0F!Jl@rlQxnC=#5U;ZZ@GN`T8kKwjMEC2A6hWSHe+
zU$YkHjIpG0i+bGu;H6bKzPgh<F`Z(M4A2>C;NbZB2iZ>L9@AXknRey!NppdLey&yL
zr945n%f~@(JX1RTsE^Q4Ee>?Tv2i-SPg0W)6CDsODpdqM=3F+8$CkTDeE-$}`XqFi
z3QWEFhh&_QnnvT?YQB6xl6*G4*4dD<aU>E>lBsc1n;v$8*oenxvC99@{y6bUxk3NG
zvP9E=DXWYEUUU3}jYwYH*NZBD6uJ&3v_Y)lAdOKM`a#qQ;_;%4`j=Zn&Y1^~r1SFB
zR0!txLKFyBXRyinC-vP~+XN~vP9hfM{MuBS*0MeMnR-H{hCKZ2A+N4e0RR9PcwPbC
ze{m7}<N8Fc;ezWE0^r?AL)A^k@L%S5%95To<ac=z(!Ia@;m2FBV*O*6>@7u7^3dXL
z_X5H&s`UqtyXn!BtsXhF;r<BXSMQZC8Sug>;7$I;{R+V4?u_6T+1ks9o9;KygoHFh
zPWJqlTYu_J8jddZcy<(Y1YYX#niyT~$lC~9ZN1;slM_<%*FSJ!F2v=p#zD!D=p82P
zK88i9cS|JZ^7s{I6~MbG=J!=gTU85JSd9f6sut+ZwkKJ(y3^<?x<)6HH5F`JSJ}<s
zuC5UmBSLTkxXJim{dvh_8{-=TxZwi$MRO4pi5MJ=Ww)`-9>4}~;@2jz+S=L|ZER>)
zlms#u(AI<b(ly3eA>C~5p4gAi0*QqE^LuuenO%-MRaruMpySFsJ+(T@tj%LA#yUzB
zms$EUuGBKaTc>z$@x|OsVc?(1tfV3Y051P(<@*-8P7<B%_&090Qr^EKhYqD1)joXp
zuS7rUeaT;;Q=v}*^Bn<eerO4_qGwl6z;1t_oR5r`_il}>#{S%V#}nVc<*tr}`H!su
z%e&-?5Eo62lJJsYu`dr-zpVRf3Y|*t?w(nfX#UwKIn@pK7jnUL<Ok5!SW`$-gYoCY
zBCt6pq%}sve<_e2x!Tkky}S97_7GeYGDa>ft!M!NT%(4?Sn*gUCjfGrz(p>p>=$+e
zd~0uGDW{WeHURQ)566U4Pqmn%19b1#8tAz*qF)E;Y`atfZ#&PWbhcgqm>%w|{QGg+
zoz%^x_HS2GXbgSjhVfN2pEh*QCA0lMhmR%DZN&*Z<+;PSdW?OkpsH1SWSN`s18lFa
z6=bqa46Xr-)nvG+`POsgdh(#L4OMupsV!wma{;!X4vzG&m>DKza3Y)I-72mP-GiXN
zj&cBgqW7Vu?*gJNAoKSJSt$}!PA2b61NdIq+DLbElfsVZO)WxMR&J7PR%8;8&UKi4
z`&Dnj_e|+mOL4@{ecIax$I3yfhe+;yXG9+yBH|yT)a6QTHHt>uhGc4Ns71>e0;wq&
zSWQmi*7zSbiw6EJbKlk4gP>n*GGp$;Y;HanbJiZ2d(|JGlrsnk`~DWFUI@h#^RwRP
zesafe{dZTswMbvvc%RH=obkcz(H`nH23XEfs6$X0Lv}B)fB0Dx`ku%e3q(oWSt7A&
zvY01mmkGjv>~9to`wtMo6j8(Kt_DRg3=7}xS<WIT6Qk+ew-(<(qM7P?J<wYy>J=_(
z$}=bkd?L}prSv|p1tiy~=Bs-$_*dnR`n_^l1jCEF35^BLa|Tgcl>vH>RT{p`dsx5W
zIJZ3wB?`&<Y96}TsP;Z3h1OtWE6El|Q_FRmv_$N|TJp<KSM$-rhh9Dd?n6d&XZ>$!
z<#P*aTK_59ed~KuuuBZvviSYNE1`@&Fa;0uwqmSFEqgk)MW6`w#v$7*W2gp7AD7@7
z`{2V<HPLKVgVxdK8A~hRPJcy+hooOGRRmlL{C3L}NM~*k-t?-S9#L@CA1R~;n`IEu
z7O|FPvyg35x<J}f8Kna#=YWqlo2ux4F9gJ{z1H8YLuf$jjAuQP%zq=(8a*fwA^JE9
z^BWq)ES+8SZdy!c2g;S;X-o`iZyU&*2nmwerjKHwu(T9L*^GhC`MFrV2SykVRL2(C
z0kxxD8BU-wE+s{YZr$Eg5_<|)L^j*L9Sm73*aON2%6;KiOk}-2SsxGwIz!&*D^uqN
zcU0o(ORxLJzwlY%8Zm5BvzqM!QE5uo!cV*$rx@X+T*jn_k8tybT!a`_OL*46^NnV{
zKtn-4gfWT_#%8D`hG=71Q>b4gFVf@G-U_REzIt?uVthpB?cusPZR7}&$s%a>CeWk6
zwj{PChyc}f?*8L+4vdY)lnR`gMy%wao;(+sO=9cp>};JRrF=y^6J=h5xBvkOoeGyP
zG>|0Tq`x*2v5DiX&Hf2h5-Vgw7WM1Is*2hJpVM)lqL^OMansFeCXgLh8Q{XtVlsE-
z`H;?*n2+jnLMA`Yf#HfCpWle$W%^#8|AKPI0r0^h;#G?MO8km(vh(7xYtr?4ViQQu
z%uOkQGUxC|v#?&%ZOid;-6w$5bKop2PmE;>h7UpMXDe<#@$W5|=(rfpP?Q#54anX)
zmFYEFg`EMCop~3^2j^V<G%58Et$T{5n}tXp0RR~E&^uK>s_Fql9;Z?^4s1BQ|ClTj
zboMs)2&RB4QvtI}2w->#g$~kge}Zux^o{**%K3<YKK4P2cCQ>!fgCRx_eu`9i|!Ea
za&Q>fEMEtDr4e@fASDNW=fdegg(If(Iarq?=s)t!f%_jIZO06r0IF<R^yTE3q8<9x
z@2_$1e9bsX8RmFB^At|~vcvg(Jjm9k^Y0T<HdGvTuN;LQJ73MHJMI{fBfIwpuru$>
z8(mAU8P=Van%c?xNQqe;L*UV%UEo%Wa?qvE#rH2VR{x_0nGSo2F;t~k@}w~l%$rX3
z62D(fQOAI^4tN~yKMmHQduHda)bq2zJ?Z+Mft_ZOo|(kWl#(ITeksblkCVVmusRzP
z8j^1RZu9hl_>L2-DuiVI5Ao<QQkc7+>(1SQDdr_da6Rlz&Vrzw_;={^9g#%cSq<|%
zr_|L@cK*YyeY}XMOiXr^2$jNX$2wryr+@jU(S<*?bZi`iyL`!{OOL6k<O&aAE+H8@
zHgSrAH1Oc5m0t$(jy0EJvJqYRjaR{Q-qI<FTTk9GR#I+LfkIL3Zoa_3%IakCm3Y_i
zq?huIE6|IR*?a7%tedkF1teqc6sME~l}MdmJDi8MV2o6iW%gnlCd29nT%Cx1wda2h
zZ@V27Ynet&F^M_YPla9mfE({tde%b=?4BS!w9YlbcbYhn@y2g@n0B}crXv>lrF!PW
zK^J~7Ud27vdzB(T8kZ=~v;<DhCm75Lcpco=8Rr<l^`R(CVl5$uN*+W}gB$qj>mHyl
zdBW^~!TP%6J{55{Z+C)eb(v>N8+?rs$1z%f4`%op^KrmPXmhAb?1P@)PU`p4w6L)h
zjlSdvH)x}BB#$`m4_e+Y^}~pu<)!r|l{@#G!kAGuU~<ru{ZamnQ5=wNAz^UfcWK%*
zU1f-JPn(GtcZz!a&F0Rz7-QUz+xy7GFQoFzS!zYD4iT!L4T0Ix2(3B#;+IjENS3@#
zj5h=&+sPSIq=VmNa9Q@p1R%?CQR1LM>|4a`nZYtYnyWlg*Pv!#;2la=QuU&x%QGi=
zQS`6dMuHG36{mWRY*3@mS7#~by3Db)(qbJfnzWZ1pJpR|n6dHFcPxb@mEx;gV^rq5
zYeNmzq5rS?ELQc~U^X?iM#~-CghUh%qq)GIEdRkz2KMg^U(O7%s?JOM;eih%NFOl`
zB7fJ*C12qJk8I@DiC?+Spy01-)p3T6tJoj(ub!Dn7yLnizA-VAAep;59%YD*@Ueza
zK7Y2%VA|J!U$K*g5DX_W4f$fXuUaxajf}xHWHM6729)nE*4N$R0u%w`wXnN$aiJdJ
ziW^Dlh{5_=s0CL13<iZBys5Fm#`t~L{wx70&&#{0L1mpt*8AQegvx%Jod^0_T=15z
zfETMtl#gGPcJ0HrDzd)K<0Cr@DsszDIoUwhhL(-YXlaaCLmIbgEP<A6PEH`1V5Y=#
zCKFv3nN@8>+vyXuBTh1Iw`o|J*zyJ(zAc|zX1{nteP9I2Dl^cmx;im#Kr`m(hnhRm
ziPSQ$A0C8yvsqMzdbJD@=^qseU&QJ$eagF>W8ih=2}IoH?jL(qLXYr?0943mDY~9*
zqKLJEdL>lUdg^@tr1OP3%qs9scgCHyH*IY)dEfI+3OdFoXxX!|%KBG=F9+`lC?7HF
zIqE7iUQ(7xN%;@&9AI@{xmpoa%w;U@GO@~D5n+&;0=drwt<aK~+ts$&BZAgidjx<x
z+8&Wht<|>>ao)xiUtZ77P!Rty_Kt7R|J>*)*UB)%&}`4xB%WLFnSmK;vFY&vVXOb$
z)t!M4SvDf-W=^~ruVo!(>YURDzSrpv9uG{d^_frE6OeMn9~kLf9Ut+v*u`i^RM(?j
zZvw?WNMN60B`bVYgY(+vxZIKg1nT!8N^&emN!QgelAL;qW1$yRJ4?S-K^~VE<2@4Y
zYHyZzqV5!`BLrq;jq}3ER+6jZaEIxWjMa<eGQk`A|H&}S*<g5%#46b=A#(yQvko)M
z^sJU+vD`EpDE!8nZJCYhOIpTGXM4c>$q>6-t>or#f^}E$e=tZ=pqgwz(Oz5`m9BuB
z?H^>~{;;~&z|CTI*L|X9)@wBjqlkGK@QL+msn`>0!Wvdi=sb9?9Dg*Fz;PP3#BFXP
z&vq#(rirxNMp#bph|#b-W#iLxmm+Tcg`!$4AfPieZzGO{7x@#~81AKc1vuhcuyNp?
zKfQl21S)Uen<L07UxC6jreBfFyf03DRd$X0J~YYCFNtq{Q`xUz(^jWI$bQ}zB<VH7
zM&?$HVJBQ7B<0(1aZgYzCe_`vM5n*5gr9w>x;GH4ngIMLgIDIazgnbLl6SR-C?Y|G
zMcq7UC!61#xjOnTkH|M@1n14fWKh1gnWwUV-CkZm)%89*Z-0LiB@5N<(32Uw)|m3M
z_>oh>N~=wA+(IekvWmn$E0a>R5;$+bGAkv4SeVjjO89iqVuQ}jE}jMrS9O=$w0E^t
z!5s`Nav2z(>UgMNS?J284a4AfKKTrsRyHd=n!Y$a7H2xeR5M!mLJZA~PM((b8%WN^
zwq;2O(4uz?iEo|w5@1evxSWSwa&o+*hm^<8s;g7hYj1fQ!$SE29sNF(tq47t`Gwe2
zh=rT2RYd4!JJ*D>VloXLFPS41Cq2BK#Ly=q!HKhpGxQZ5v!vpK`BUb~F;O^x4~Io0
zm(t@*A-LT%Ncwe~nd!kp91EF|L?Ur&vTOJ@h71lB&5|MKcS_P~a;r3x;UT*HOU~<5
zw*DrTk@xKR4=k=y+RC`vtnNRJW~h$n1&E6Wi_q4V6OVxU&+{|1rc?@yz@hV3zcm<)
z2nsTlFLSxMpEin;uPlaWV~go7kl>AXWU!js@T6lZl2@nARmLp&$7dGH5nB;~oVN$q
zGU02#>n<pJ{@{yk46Xv9Y@)fc3Kx`U_>NOpF1kihGoe$5gT*VhVu=ByOD{>@7e+l~
z;<)e$&Xp1OoYmflMeGaBeS!k%FE|a744%)*uGj=76Q$v`M7VgQ?Q9|S(LBO2Py%^F
zfjfb$$KUup2L-<WSq|7I9(o7<AA$zW`Pp(9v?36H$1XR_?ZN4HQ4eXxowO}aA*MJj
zc3Sg!ib)v54q|CAz3%K{ok(ctbpHznI>&bQ=+y#cZX&hd+r#XQsu>kkWAZ)A1lda-
zF+l~%Of6EZ^`4Rlkco|(3r520aWfG)B@Ul^ps?xu6gYD40@EIxsV(J#X}THnCPrc@
zp}aytk~rrR1QDT!=$buGFQu?dP1>@9_PPXy2?kR_-X1J*S6IHQ4_BkuYb?ib^|qtm
zs(zpo<c#Pi3i+?7aP;bWzLE!W^k(-DkV^5=>#>Xknr}BX1O+*V?M!m}mv3GXuf;cE
zpXrG(eqfsXi9Rtzqfa{lLo=wJbL2iygv7CG!2J-|lfl|3+k~0M$SLt_DQ#}NH0Yi(
zA2k?hRviAhS+?t~CB!g3_t5)c(U3J`RP=2-sYp7^PTX6dRZw~6o9RiI17Zox9xN^5
z2D0_aREU}Ai`MXm%>SVI{M1axmtIGkNDq*0ftM)sRJZ8dozx*F4Edej%Ebq6T*DCC
zOyKT`>k70Hw4&QvKoH5{>=7mnue>GaJ^6tq8v{j7Bcv!X>u%|M7)@8vwdBt)ZJEtl
zfL-#U4RnlaJvX+)eC@xlo+5J&bPeu$a#U!^rI6+eDlWD7tU%vmfJyd91=Ej>&_`g1
zcBf1gQc+%QgM<}hNriYF0lXh{QP;OfV7^EykdVa{q{;KK3t$wWYy{?JikI60(5m3F
zyr+8afB4+|N(4Zs?D1$)7@N3x3gjjT+>BY2xON}Q6_^v1&9n)E%0K#1dWVK97YWRU
zlovOO)Qdtj4W2CHIJEIcA0!NvIhlr7KgfNb9<c6x@+06$Mr*gYipjO4)Y|V=*0zIv
zkA-)T7*dqp8_%cZX>n0(z1UozJV>er(5a5<21q@l4{wadN-f7e$501<C%8tKR`urG
z(GjL%Y_%k%*DiBuVQSqJn8-A&HmB-HZ|oLJBHJn!J_bl_n{D}&bS{FRZOWNb=t2aQ
zWXy81-$tQ(F|(J~$zRLpso6QV1es!@EW*6Smco<BY$gv^>u8f`=voJ59x*(P3T++L
zW@2wh?+bz=4E!a}CzL{e;WuzEkB$UF%F}T|U4g=2PG*6A{6Dk%uZCs@Qo+W-AqW_~
zWX2r0z?GFv-XfO-^4?8e=^{qZ(;?ShUUTp7>;nOx|7)7~25&@kXDb#k=l1m|?yMbX
zNuAGm)!nFrlX~ccsjw>p<a^VRf_zy7+G|-%GMVYQ7|V2(J$?q1&Ck=Mk3MU4%c9z$
z=@q4n#TCtt5yJx${i&;w_XQgLG7^X%{!3>&g$h1h#a5XhA8)0<eB5YwVi$RX-<nEd
z6khn*gC5NLU?G|-@MHGue3rEQdnG_I;XR${O^=Ab$vXCX<nTCmm6lJklR5nccXV%j
z8JMQFiG~qgo#m1Ia)(GfTA60{?A33h?*^{VU#g49MwVwEGROS501*~A^4n`?3%*Bo
zg|teRAF@Q(2TnLMXPA}KoK_Pygoz=qOP0_gTg~*%f15~(&=@_UGPBd2sXO01e@4Y&
zZ1C7B)xX8tS!5xfh|>JMqn2-9@z-VWFe((f-R*1irFs>=8CNrv_?twb$V*2^=<Sou
z1=kF3?3k+q8>A#UO|)iAY^H?Y#lB&C=l1PH;1!#0H1EzEo_`z1X^MFdl|-UEVgu`L
z96YuG>Th&mt#_u+H@twZDDbV-7M5Tr3)(HFnkH+GmX}j$vgQLx@aAH-UIf9^C|9Na
zogI(8arsj$YsF^igC?L2<mvdxt%X?j2cJf+`o_c*7M8^ExCXuaVm#Oq_#i*me|NSd
zI4pLZrNUa^c21X4jE>j{%dM?DuZ+wbJ_-Da9cWRAey!P?I$8<kFe!b8s}3&tJ8V=0
z;REw-tNoog;j7g2IE(bWbj7ywu^*khrCH^NxO2~@Du}YM)iZ0%n^EB$soUMqYxf@x
zOmayp6l#o*dl$UAwDCJmI|iy0pNqO%pj<s%&UlsC;!FEm1A9~Ya5cdmiyJro8*Aj#
zij(%$l?IieUi8XpQ`YmL85&H?l7QL!J>4f+#cc0TfT5rwwX1zi-?h73@cxFvFGCxg
z^RLET{@`sTHkiXX!y;37L%v*_*U*dOdoeSgYUDAoHqrmV*~xz|JGTP7^}Ll6hiAP6
zPoqpn*M6@3ehaU8_oFJ&fS*eWrOX1pZLrqq47q$G0h?2Yr7iby^duD>;@|mVp7*k-
zW>q5a+Oz9%LD%0AS`>@R_)fm`I*CGJqT?!Rp*=+O8Z$y=r9yL55&tjdO1*6M&S54N
zCPc|ka$Gd`fwG6)%a3;HThW?+==8twuXW|ZTB(2o+oE2FkZa}GYRBV=eTm0k9sf=&
zYCc>MLOpz6@>wr`-?(kDBVf0($9wbddC3rMta*Oy@R;xLp6GBny_hs~{=VbW!C#HN
zfQ9*yz{RoUHle?th5qi(H_=4b$<F03A)h{#25l|OH_izSEoWwSe4+`@{)=5*ZS#!*
zb8N5A`@Q_Uajkydo13&r0(LtV{{}4gc<;X6+$019Tr9EW27>^y6|(l%fQK%MRSSw$
z^AMDLiB0BKngJ|^1+AIHHxtFf5MohxG81L!=x{T}lYGGZzE-gD-yOc0S#w1wbK@|y
z^|!B2B7pA)kBc2+m{;NvLyJ$L9lw{ads+WPQ-`0Q*VLzgg~blv!1*4}9`Eyx%#xFU
zmBp^H`R4nb3ql$+1vyYL;Jo9n&|=A=wz2n~#ay7!#OsNY#gmY~d+cVrC7JI_gjzpk
zMJ**uc=?qFX?$XPAERy9DRg=zW&xlPpi%Nk=x<5p5H^tBmp;^kts)=@0N{LVSOO4_
zf!LwI#S;LK-Tz13U@x7vh0Ethi6|DPmBmLkee&S``2yJq3FoMh|F)#xOrBxe=t+;K
z<a;tDiJ}n1pvlpY75_p1W>f43BYpGq17K|$hlnqW4h{NEYs<cE_P3+8y?Y0veFBmh
z>L*C!NfuKA1JIJ?>#9TdJ+i36Sn*Z8LujdykXh7yMZ9tY=vHa(RT)wS!4t8pcEa;y
zav&Oisp0<b8}+^aq4Ae~O&LE}8!U3^=iXR56@EJu-1$H?N#iz}ffoZ*7z>)@Fi2H+
zHKi7clqA5a2-$HkSX#oLsWj-#l*Tws{GoGB583QL=!!mXrhx(Gb2=l9M@_z$^|3M-
z(J%axlWHA>zVx)<r?~HT9@W(SVx4I!pT5L9@-VsEy`a}H#n{IMFAcR)3i@MB(Xt>U
zLtEANzdGlH1vf~*C&L+`IHrh*JhtT6y!5p<uj?3d2JU!;V0wuBUn@)w=&RnQ1hds@
z<euTl;=w(vZIVBI*2q#{@7M!5q_HuSO{zdC_+D*eb_T(HjC|K5dW{G>QKv%jt~*dJ
zA`Ysf^T;H7OoTtOHwZRyYnDOj;OhYyDH_e)HBKW;N3{s>8~*tD5(OiM<roKNf0^zh
zcxn!qbSFi=B>k(|%10$vXlZ2-&5><J{ro=fRBf9NIAThTSgf$DdMlv!y@6i{`D*-N
zDP(nBG$_y#EY^9kKYf)CYxXz#U$)V=KH*{FauOU0-Y-+S(YA;`2oHwKl=?w^=TCk@
zAxBzMKB5My%wv=8S!blv*SCFV>Z5!O(kEy*bNrtmlO2+266NV@Tu2D_cM=*hUdVmH
z_pBv-?Lmy`*2ot8Q`CxxdmqylN4p-&(h7@`m|l2HW;gw*ozQpl2MBwwygqM^^(L@p
zVz=%PhNd;!sZS|SP09WjO96Xa?Lu0T<V5%jWnw`3=$R8L;az-6>iW(G8s><I%o5f1
zWPg3v62DC_-{6-3rfR!J%QTa%TMy{raK5#7<rzmze|kJXP!hy};to8Dg~W!I^fwwI
z_t`OE;W%yzSEE?*rGMBw$uFQeWTtA|Ez#s@AWcsk#VIiGW~@K+%*c4gmk$exz_wAK
zKE6j6)&2C8K{5v<kGTIyvT^1Kfx=h`DsYERn$Zq>p(H_Gw8r<#s7yVJ9zuSSU5Z}(
zHRj6c^=nZZai&A}Qb$udt=uJ1vL4KpjYbh37Jse(OI-XWCKgOq=JIChb7eg(CgNT`
zPRuurcztl1u8zEbH0SJM*#gQ?;B6PVeIbtl&-aXe-{{rSyZY-NZd_}R-ooOT!lkW$
z_N^`+z<A)v0luUCB#w9ZjEP*P!Zf(~-FhIzNI{s9bFcSoa1suJ$wO9$T+s>aYH|sZ
zQNY|zsPDOe1}1>0JJojDpqdkpTthKr(R%SxcY-LWc*~cqU6v!3AemQZ%c51$EIlQ?
z%^o?(7u6t$;J2^sD88q?09eL4!N52CA7lXOQB;_9uTMnOJbW3(iHB<_Z?(tZ{!VWe
zC(v8;#xwC}h+?izaW&Ff)Vr1Pj7Rukig7!<%?FWRM7XAWQVDxo1J+|&Pd6W)LUQ=(
z{=X87v4J%XlxI^^fgPl46N;)B`$ku(Ughb^F<e5I$-o_TT!vYQ^ain@A|5xKI@U<5
z(A?Mk<qnl7Zn;kFdwei>3kp(;S6)b+h1HbNmtc3)rr94PBU#@sYaD;OgQRQaO}=|o
z_?17%n5n7ab9a({P)|nPeE*7~fP0Z^*tHW6m$hL2GJlQZQMlr0inI;~kiu2rsY)NE
z^+0TV<ZfnoHusvgx0T>YHEWB4v{t;iw4O3My`x-A?Xc&fi3W*hJ@W}#fK&BIhXx9G
zaySbyi+3{kpjS*rElv)40^!=FZ&}kXa8s$h+0n=vvSGEs?iK>py3lW#_=c95GvFP(
z21^*X9lARz7`PdGp^#U*QSu*5Q8`LxxLwhN*l0lJJ`EAPn&x1kxy1FSmAb~SyRodv
zog$OX%2}8;kns6E{nMgn^@vRR_zSS|wa=-AM$WRN9a(R1vS@TDpMlhhs2?h3;lGVo
zIC1i1-@<*J_7CdOXHxmq49u*!wEybR91qD%__cE~kPE@?Na0jgYe@A85mO($9i42S
zBs>&A=_0y0+Y)cPDRQDZ#=nSc++MvqnkSROD+1;|NR)6OBrZHtc`9eJW@CS_5tP)@
zBst*aiwX@0vl1HS(u-eVfXf(9)1R$VrQ6yI^J?|lUZ~|IXQqJnlnc{ze{Bx144HiA
zMr1SAj1C#}My#~GfVQ5xTw8b;VpRo4=Vion1XD0ODq<~2L)B!}!x&DyBd*VO<F(|d
z;P0Pp@1MQEy*F`jkkzifXlx6p85nxIZk~6Xfz0xgo8>mi6P)IJWn$J{gtW{z6?j7s
zLr8kGxf<^0&qXlC?sIX)H*h5Xj1FAys4V1^mNfhOLJ-jchmukWmW7h&N5YeM$=;f!
z#0oKeJ|YiMjgnkPHVuaq3PGrkGc09zzjmc*#mn&K5~!f_7u0d3qvfxC_;zL+9;DpB
zEZ4ys6QE^@u+>j#tys0+^qom9_F){jDDC?ft#+e_h1&>85~T1J{~QA&M`ov=&^DP$
zs!~iQyVX)uELQ*HyrHylO0&W6FbA_1Am!ZMeZPmoxprSj>iyb>pp%b9GRUS#uFZZs
z86I=j+hYj*pHSXq{%I!)l&0Kr;#q#h>V91!H$9s~OWzxPV(*mC=ulKqQ^<pS|JLhj
z3gX*cuhC>YGU;15hq17Juy)QXXX8FzFlKEcC>x}x4ySKPd@26HF?+5+Dz5M}OJZMu
z`yhHNlvbihUb?9*@YGrxDV^~hx1O`zeBo%7J0yjr3*bL1tvsK?gRG@<wYn+b+W$Eb
z17F(tIv$;sR|0XR*^~;FmcK^b0XikvxZ7Yg{&lJ^+z3`U(pl{yDw)k)2wEkbtK#MN
ziaytc{=>g{R5>!<X*E8!aX{WDSPNQt9b?hb>Q~d&D(vx1>jU#CKPIva^{WR5J!iii
ztCAMzf?XWGyp9RlRSxldr3#CKBdnhm#uNy10Fwn78a66Nx*mnK#aUiK=`swCv80Yg
zk{=O7j}YULr(4RQ^%6QI;#Fh?nJZ+m6xyIjv&%ePcwoYGT~u$MsBWQpL8|Dl*k^eU
z`*n<d^>c;igT4-v{b`=cFm4I%OBI*!kQG7pHXCf`TWv4bLQ-gxMVZ{t0K23QY!xU6
zN9^f=t;=NM9)4DK1X2xu$zAD^a8lC@M9_MP$mc|*@R#Gdqh&F;G;cQB{!S~T!2yGN
z3D~29Yj}N;%4(K%gtvOoPLW_v$*(004+fPpIu@jkK61@5nO~hXIMpRK2JvG2J?yn?
zN7!mW5`))XKX$F%aM%5HNM%R<PCOgq2v7b&`z`uRFBEc*yTIJ)<Zb*Yftf)8QY~Ud
znvTDHsI)ragHA0Bi4MP%MQ5AL`zlG50+kj;_0RwjSy?dL{EzF0H@=3B%_#B>Y32Zh
zf#-K|I+I*>MdaIc9zkK8vZVK(ZLeeJ#qd6r^TTIJa)@rZytVA?<Fo)~rElg(cBcH5
z%Jgz+Yoi(2n+F`MCPn}IaJ;Ww27Pl{M45SS^x!|Ri0vqUQZ`Us&|^l4y{^g0Tlz3j
z>Z3;8^Xv@m=@a@dp_7+ayqO>#o_&DeBn+Vu!LW87;};XltFC5TjYz6u{u!Q+R;f1_
z^fXpn$_%l-T_qk8^dFn#kO_4%&T-iB5_iuc-?s+v^pWSRv<_W@)l;D_E+qO`+qj5k
z&i5A!moakxedF$5EjsKOe3DH!nXm^;lT5s$y^4@DQ{}{q2g5Y@O_EWzLl_`OmCvEM
zf)9eIqkXZ&Q`C=NVH$g5ef+b204u4SF3LEw+?MIZz?D9#>fN?m!IuVDmD==hpHOl1
z^qs1QorNi@0x6`r1f|2aI=ZLdWcE$_3#s@{-A7y!{cD(wY!dpo8*B3;KD#nG5$k~C
zD8xsaD2}*>ULc$OXlm|X*vZkIg~f_AQOqfvT4*NC-QmnkF1(%?jg?K>N0Y5j^~}U&
zI0v?64zB${nvkSPoKNWYJ*4h06bL~)v_wjLD4ZqAc6vrXbXGyxx9ueeLc`CLOwn`=
zyv;$<9in;02?@5rx2Of<`V!@NVt<$m4kqf>jJ9YkE-MlPcl2m`v8H!uvr!a6Afe)(
z&n(ztRA)6F*-1y!|85?@z$SiUwaq0;xl-MG-(wyrG+sMG6z~yFuw0S!kKI$CJh{gk
zwBnMRz#%KQuv`#K5#$ad;Kc)!p1)NtFA!!x`DiAs*Y-JVPgZ_!@k^*=0m}-;-1N&V
z2W4M+YQk;|a9YQ4|6o`yMux4Xo_iQ*$J29SZF3QnM9gDgX?j+igh{$%7Hd3^Q%{CU
zl#L;`#ouq0kx_7WD@k~xE*`|~AJ+Vf71Rq*gvzB6tT#64x9o1t!9{;~I8L6h=h!3Y
zf6)!Y);cB{5jVt<IbbRwsQtEMSWkh2v`5A)WXJ&U2@EZXBP1Ie?14e#&X4a0HV%a;
z3U_1qSUES}^DYA|Qz6c5^q^J5AB2ZE0Pt3rccOw7N|V8nFThk_i)iXlfsoyI=q>tc
zbnnOE10(JH_V;g%ypb1r6cha2R@#hI*y-P1%zy^1i^R`l2pit14<o{*-Q1C>L@C@G
zL%3uaSOl?pb#N`ViZh&%JcuzxyRHZ&C9ZXH>7zh(7qWXF_M_A?{ng;?41eQn;Nk)F
z=hJd#|MV=#==Hy^wNl$S`dT@9QDY$8vEKp4Nqi(OeZnGjmrxeiyQn%TQOu^GN(YB3
z=(y`%@0Jh{L?p~9u`bO4vmYIFEyxQC4e-%BMWR=o;8qWb2Ew68E<`|?F3qsQaRR=I
zA^GkaJRE{osJPKNkvJk?ku{X;oVZSwrKp?hjgb4lipGPad}0~wgdBP{wn^7|<sa8u
zcwUgnNVMfsqV=-az0LUTsDcH3#l5~I@g~Cwg5=(YQDF)GkTmX(Bb3=bEl#xHzbE~x
zE22`vAh|vtJX}i{$Tt%HUv--0PKoH$J+j%6Vt5uoGFl}Fd;;7Z%(OHmR_0L{*(DOR
z_!586z3$AlmPCGLHB>Cbe;|Qu$wJ3NxU}^hYwEzwT%opUj+po@3t}iPoiv}E<6!D0
zlSTk?L>))%xRFm9L76{cXi-wm3y}33>@0^rS}z@cHUu#Qa;T<-Q9*Wx8#;=4cSzkj
zKT_ACJt8S7sRnAQq>MSPH$3-JcdQ|bB>vBEI<)=jF%=eg3`E%<7v@4E)k?=uYz6m^
zK`@|BIesUW<yA7zeB!10$?|%L=S%9&AYYx}+rK0mZsn+&doRVq<EVTw!zE|QMe`)D
za;QGNux}{oS<1uDc?n_zuGv!pzc*S|IkBuo%RRSLK1M2z4W+8%r5i0P^lz@8yNVs`
zrxW|{a_Wn7Az+!jwQoDaV+7o4SM>>rX=9-yP14_Q(#hJ~5vF$i-loPD<dz9>cG#Me
z{teE+N31eBOv-Nuyu4!TN4|aalEwDay|(PO$zbpMLP?c!bEETt?$Q~S6!Fr0b&;WC
z%4u7-y6j-NohY(yroz$)fs^Of4*}oOxvNox`}Pdpvm{TbDy`6h_09~K38uY0h!i+*
zoxG=Ko=4}MRg`Y~hU_ZPX*we!NhWV8%B)cbxBlpLBqZv48M`U+O&smo8uUIq+D%Ev
z?fIJLf4TJ3@g)5hLAV)scD>grQfQNi%7X)c*G=Xxb8H~H104QvZivdHgkLc>C?~aF
zN9FWQ&o|pWEDj_tMUd`d+CQ2Yql8AQ9fD9)invg@RAMsIp@yG8N$gnOV@xGLdkt&!
z^SlCt784u~cVDH+n24q`niCNKV2X|f0E+48Kz9HpGFk(45J`|7$O{ZD0)kQvxU;l4
zxxf$!6%SF60U#9$00G#I{~|p8@5&U~(TbM~VDsqB|D8Jn0Nhs0X)*tI0$>LK%nS@m
zM5VK5s<le}Zsp6+#8WCKqX6)LuGnnI^B!Thh;-_Mt(8F14-be2aC3|pTAp;T<K8;2
zbgOz@7sI;UpY60&!<(<ODu8+WZj^of`d6vJsT<t+9!>KYyL)kC%p6n~8NIX!h(^?H
z;V+`fhn~Wxe&)6YueK)>0)6cMaVGu%cwL}aS}TQ*-kh9RZcyj-%SFZ7BW+F-Z|Ay4
z>xpM0xG}bmZl63>tc`jQN;X+49!@EKLzUVkOL>#0e?8dKxk%gY&=OC2bzC-CJ36uU
z+HAWNDwAZ#iXc?47L*9l0|Hq{of<U;GX-%e1GdE8n6S4&=3^`zAmrAEJ<zcyHr>%F
zZM}QHHgQGef;M5C+EA|r?}R$@WL8+Pe#Ej#gGczRG*2d3@8MfE`0e$?>rFoIoYpP4
z{i-1tkLJVux=;0X`B4$M2+l$O7j>MIhV?2j8T_)0M+#>L)2&s>?MLR4?Zc<R@mHVj
zcWN?Klg-&(_EIWicH-IhkW~gZPs_!7uB0Z!c+odtq)xUd$Io*KS6^Qxp)_4Sbwk^p
zn3FH;M>RLDVNALbClxr79&;wK34w%drxma8OHM~K^|e^BdU#bUed^5>LJaS><g4Z>
z0ayeb6cGx#SERm?IlYX%K)+^QVY96RAhX(h6H!sOWb*XH24@uzPr7h3?@vunPOqd>
zT>SjSFj7(tQSRFZkGAT4r)n#id`;G|)dCFHD`H>9cu`0xkGb6ig#8#-O*g6{S;io9
zA|I)&7W`adE1rzqQi<iu$3()xtwN@x+rC&)%8R!-M|bxJze1U3hHeOGNp_tpYRdZG
zq2`Zo>X1679^QM%F<ddbA964*+1r47|EX}6BwXd5^ttFEDk%RjTae6YHPowrQla$a
z%Am(vVT{7qILbe&Ldfus-iz|}$$YmD^>t@^J8{>Bhh>syD2FI5#anF|Xx_)Q8s6I{
zGm{B_w>9(}LBfW!zh1(#OeG`XFYy}N6`X(5W~J47`n7hvj!RHdL*sR^d2}F5Jj*Cf
zNY}Ol`}EWkE;Gxr-Z-4+*K0^CkTmce1>eIKu<JO;qHjS=vpqgv&OkOlphQxn1W4lT
z{|d^fIoNr0L%-e8#e9ZB=%bV8ZrjH*ICdK?sMKjBqt3>9)9}Re652P+YBnPJG&~~l
zU;6g6-r_1oxZ|JOL*4SYuDz8bT@3N0N;l#`kb#wJ#CD@|Js7n-obX$0I`=5OFJw&^
za)WHM+<i~vzDco%F~jh(<}B#O!X96QF|g?J<~V7K6Yl)`?i9dP%vD;?0Ru2+BK83z
zzD7hIhge-4@xqI3EMQp><h&ebs{E#QJV!108~9qrAJsN5MUYMofawvT{=WYlbgRLn
z{e*l?m1L_!71nU}%aiW`>3_M@kQcU-HuXJZc=blzS;37JX&c{$9CBw#XP~28dM-TH
zEFBW@K~`pBqHC7bYoA9W;f+AdE||T$g!7xO9`}$f&lAUctb&cFitpBknknLqKc6g|
zy^rRe5N3<5h!6HcMxQB>ixGP}e^h6VXOiRi$!iz}Bw!Jhw|Zzi`uKk1zt~`+-fMYZ
zuC;%ZE*X&h^ynK<yJq(~;96IY!i}{UFP5=SrcjO<N?pBMN%Y@Y+`q9F5uX=``G%jj
zBJR6ye)rb;r>Qm<mt)}0*)d_e{>rd(VT5pz9+&oToN?&RBibFahurNnck8~r8=>%=
zo_B1<Ea*jq@9mRg6fHc!Rj3j!9^<gOF=qh|UOu_a*VgMR0-JQt3?~?SID7gD%Y@F7
zeuHvV5izQ4Qa=k4d^HVh;)Qu@i;0llM`Qe&Z3dIu`?cifFVn}`S3yx<v->e@^GXsg
zp5Qz6N(OA<$>sUOQqhQE>v82NB<saoH2!WBM>gX34C<Nv(J(C|iqX%tmW?)t?<ZBx
zVQ1odTh5|h^1!7k4tBME{Hp6F;zr5e5*YQM)OYB-%hcL(ZV?bNjB%Y+n?Awr^P93^
zT*jEFR>t%0?wI&gN@M4X2OPx3pI4<?!v=yjn2S7m`ZE<BfzjYVv}J<ScDZg_y_Hk?
z#)^uV)(c8FGO^x;{$VjJzqX$F_nbFx9EZHvZYEt@Da9gK@yZ2#*k+PbMB4_z{JYy(
zw=v8SB_-;QyeKcb*eF#0-{?s79_h5PYp5TH<(qjvdRGaKjuTwMpCi=n!#NBr6W(0&
z5>8N44;(NX3XGiXd*r|CD+-R1Sv`TBkZqbahWOVSmHv(4ky~?>avXdq-(rzn(#D<;
z)+&1v^XF=x3u2T_UiTRa^9NDXn=cWXnyMER^D;)y8by?3qV_V2w45%c5LokO*IssZ
zUwk?OiocJVysW`ktWb=vra!AK{y4UQ|E$}TzFw|!co2Sbsk!-VuQFiA6wMp3RJT<V
z(gfd6oiKw*HlKK9WHDYOx(KiRDycYC=)0(X?vAtA3hFfQWsh$bMQ3K3aFDj-_F#}1
z|Cf_}kD>Q27~s>Uk{B=*=&_b-(f>_-IG^L<C+IN|jN3Ca5Ax#NT!^@ThavXniNgoi
zE^-X8-jCkTCb_*7k`)A)V`}PqSat0&<+BP7%UDIoO=r|7t<atLk0jnG#3VUSF!ug4
zE<P0E7q`UyhwU3%f0(>VhYQ1?i-$_(%V7^292?Q~Zul<LVuud(Lp6@aUIDD3H8I=t
z6#(=#(4ccq=I(e9Lq0z4?WxHo*ejvEOohSRq4?LVGOQVZs4L54O=I`&tXDM&ZS&p~
zeQ%LuY)5{wXruDe=9txuL(`8ds^yRYL+N2X7^Dr{<vmL6$veHIU$gT4Q``G2U$L*B
zRkrow&P_sZI&IYMv~LG+zX_H%uP{T1nJ7v=Z8!)-mI4(TT+NhpPy)t4a*GD%G^XC_
z&uU*VA^3Iwvz+bz+tKwzZsG8Xyho!+t>MI<0;RS>hz;n{l9WSx1BRz$sh}b134R@f
z`&e6NGpi|>HI+!q(<puP#sxheHWo8D%hAzOkG{5e+SY&*rU9(e)ZD}x#TRTa^^o9{
zRYQ(+9o>iJkng6IyOy7RFuC>431~ft3)?vzF=y?Hv}r$8`d%{2vc2?C3E*Ty5!pcV
zMk>cW4^oru;ne<~;l`Q&-x=QL%i}`nY{jvR0sg&?yk9=t=aI<l;oDj9SpttYNA|9{
zOsp)Qqc3px`7<3*DK<9N4>~qR+b(aF!}z=5>~zm>bB;l@T*~u0>-<W*Qk!tBHH9-A
zHubTUvwi0+V{GSSpAW%5q#1?N99r&pcZ#iS)Mbx_&&nX`<)o2V9+m<4y7KIx+fN3M
z>o*RDjM%0$IzM;F(w?+cMw$KL6BFf<PUOx=&4aCQ)FR}mGcmMn)K`}IfRTKBj)AA{
zuVlm~UbgGL)qrpO;+_bo5aJXtJq@>bl#7Fxbe<s8khCJf9Maqt@gd2k_IE}KXJqG#
zj&G>E4R+nQ%Pv+dgF6nZsDh>82<=X%&E=iq(w*F^@Xu1ey*KwLa><T1F{POtV;iae
z8jtr=S4IvFLfpPF;8+J4qqcrkGfo5n#GismlH0{W2cF;L6xRr*W=3#5T^)9<#BOF)
zPFXkL;7g{+&FV?<lYk!HVmD8TR0Z*j>OuW4PzGN`zB?~f-$62Y{1vhFe<KZrEaN+;
zOVs)t)c5039=&~coT*9o@ab}PLPSWvNaLABrkb7`^ta^Osux#9ret#o2{8b3jx%Go
zri5nIeg;fjt~U`C`}RezAkV7vfcfh{zL6`ojPK2g!|r1HJ31i1W_O%Oayh7D1X`SP
zp^MlI0(Jr<O)&fbKFH6ow^MKe(={DKw7X7}#Ou>~xm!2faXM0wfM*6bV(xCNDcX*1
z)^z>+9B`^7w}AL^+0c1JR)Es`!pv?B@@WcdP}bglw&Cf-D>%D%I@yz6*X+}5H>{a9
zHrmm?`7xgx#}ZGT>~kJ5t+*&lEFf6MR46xnSSR9UI`ICI)?KV&p5B}NF0F5jWkC6i
z{Scz5NG3%fN9-%Qpr3tqCr;O?@wTf1cOx^cm%l|6yfszRs6HkPkkG$3tJX~m>@#R{
zn45fA(<~Ls%-=cyhlt7W3n1`PQZIY6#&pPwp<;yp*ll+J%7rW*qEeAzA3@-0i1RQo
zijdzA%C@~`Iphi6t3sy?4`<kYtGHIcY@j%5r{+_h`|1T1)L3vMXR;vWMBbaKl#Cb*
zvfc^&23A^h1fqECEOTbvZQ6BW?$G%3@07mUqon+C7lgNyW$*zpo{6VFzg-ETt8jx0
zKTUwnP!$ZlECrZ&2ewLUgQtpcI;=4*g0hb|-DMsDu<B?9;T>J<2PLuVQV|{=dVLVP
zDe3sS^5K>J;|T3mofKG{h+la9t$NLrZy(jwCqCrL%fxaMi>cJnb2m4OsVZt$=`S4o
z{fQ*HKwmY)?&2b$bak1`cmEzo|3st)BhwvWl+@>)KgQMZ2!~4Cm9~2Tbg`Srwn?&y
zhyk{0W!N3xqyCla^7gP|?W&{5e@1k6U#^5tg50==O!O;Xyx}@@=Dsw*G^Wz(>k$%^
zwL2x4gL{pXf9pDSJ)#rgOZbmQ4Ua$OWUPEv*tqbO(JQI%FKm#=FCAed`jNZNz0%hh
za?JlTHlDT>E%AF{-U)wZECzlScZAMY`%kNYU~hK)%2nT6HbuzK5NQ5&TK2;ubB#TR
zh1527rB0+ULeSw%Z|Q!6&MK!`aLM~JyWnTnf6KABL926a(N7(K1%#|`-OlL@ROfwl
zkRVb`{EqQ?8<JJa_^Lu?jh=AY3NwwF7?YqWWq(*bf+~dRBj^AbK)|UFza9>u-h7X1
z&l`3exw%f4WMXmd*0JJXtkuKYmE{KZg<P6xmn%NYOXz5x@7Vc%^0Hf8-ttpN>01es
zSjYJZGET_yXKIiN@<o{bKUUPm=0^p6e7jn^15CVvz~Npdg3Co2Om9XT$^F5*7kTd7
zk8J_I{(<#YJ;&SIROt!#zU%Kid=SD}4_&#Z!Ze0%TjW+aV80`Tll)@B7<Dwt0_c9Q
zwKD+8wt_ro2_F*6`J6rFU%nCRHKM|(f(opY<1E7-&vDhF7Q|1NNyr3i;C?(vf()!_
z=vGY1`TAXy=bFlVG)n{>U2uybeR9~v@QMp0C-tNoe*TGkRw$Kaw``IlXHU5Ks#&g|
zJLf94pjCs@5}mSKqWRb#XKF^Xy`!gzbTXe_SB}VZR+A0HKOaV73uFzhS@x#>X*yb?
z^@$9Bl@_tl>K^Vx#jTNbz-$-Eu4{}#P61$w9m=$V*04Fn&4biwzf_+i9hptC#|g#K
z-)@AQPlcYp)mkm6OwgY09p&hItZz56Nr$w=uqU~<ym&gW$$U2$`PJ}xa!%R$g%n@b
z$Eu7kp>SqR^KmMwa9hz;rZGnhH~pl~b@m$N)^)sFea8B-BIm(1LzKHy;k7qeesr=1
z+(j{piX4(-#HG!B&*Y~bTinU^S3^ULg)d)Fo5$C%HwJ`EC>c;1Q0*4h|4uj^<!DW-
z-sx}!JslF*SKgbYuL8!awcZObpSX|3@r0Tuc<z)==d9&A2zUYgJooeaML?hYhGB7A
z0~)<CQ**4nG2QH^!Bc(Vb_g);3~be3Ex!r2O!`&x&>P9{f&;Kmb2i!nHpsj){Z9+<
zjiMLc%@S*hHQf7NXrh)>lqNi{*fApwJ|flM0iXkllwk}z{i!0l>7{~9`6Ri>@Ib1Z
z$Ok5}99t6-?xxh$RxBOO@#~0wckZnjvq~Z$p>ut%FC=};39sVWEG3y*L|H~7=*=U|
z4RKq6d?=q_0v$gX!G-|HK4fLUF$p6)5!fn&`+Qy%IW%%KBVW{SB_FBHiVv7z2YMx5
zU%^Fp7+b^n8AQO^Drl1$#uOCOzL_JC!D7p;!z{_T<qx_QsXnux`}?~LBw}GHnQ{x<
znzi>HxAI<ld32da%b7k!mHAi7LRdgbMftEryw-)HJ^&G8Iyvz|?0Mo?K6iqXQ~g8k
z^V<Z=w-0}|Y1>bY-{|J5XnG$;uM3OQZTjemP5Wgh*NQ^D&0=x8{6cuDsaF&xoV270
z^e|hyQL+BOk_2h(eUd17AH6;0Gpi|pl%oR@R|J#QLGSBSx~3TOW-3&BMhiAlf34##
zff$3ynvv|$$A{Ep90yR-%j5$i-8&g22m>sl^{ctY=?>|{FT0jLR-~u-u+#CKje}RL
zsv>|Rp~L>EWxr$76d~b{o4BV57ctcNN~hNv6GrbY;I&Y?F&HV50_rs_=Zh0oukNZ5
z5rlL7!eD}|5eN2&jTfgzz)JYRcNz6$Z$sb#@un+u?eL5|NA=)X!DxNIdMZgS-JJ>6
zIJu&CX=3cF`QTx$HqR|E4z1vskaXDuk$YB<|G}#uJwJJ3%sTwmEGU0hFvoIYEdnXg
z&B3%B-!Aa)7pZ8K<q2B-|FLu)P)R-R|3`7)-r~lsX>M~X?orM%wL)>^)^g@vxcAJF
zTg!&#NK4I$Gc{LfS}t&xrQrC8ity+AJO6Vyz=3lQ_uLEId!Ofdzg{d%#Tq-a+b?!L
zg!!LI_R}iViXCSZ(fT0mphycPkyPg-ra=lK=>g9p4Ip>!8elm4fB?L-xa|a)VK(<B
z2M&kDzQzr>{Y}>!yj@KZ7ImhtF7E;pdl|SKk*Jp~GOQkcNfxiai2nF@oahzuB>@mp
zviN*_Q;$Ln4Zy|=asW9CYN(U~0Js5Afbet!dkeN0D2(~W2(+e!&YAb47qoLo|NJHI
zsH^5U&1#@GcW((xV3NYa{xY!J1@S&sc&V3K6Z@~<Y2ZS!O_+(TF6vX<MPsR8H2bMS
z+e*v}o71zUI*LO}mLE^2o*5N$?yeI+ujTG<9O*tA{KYa|#?ivhOO@El%<&B9&zeW`
zyE0eBw%%wg5z9$MqZJB4x!XBwU}s0Z2<TcFJ!Z`yZ0Ya4i)F1332dXtY^IY4#|c09
z>(LT+fXd|qGi5yCdO;MiQxDqJ4mRH)F<oF@ye6YDQotK&`^?dvLl2zRw?+ogH}Wlu
zc?=$flhyD5qb0IA92-F_pJoU6YsVx&>vBH_t#5JsL`x^e;qIOWm5{?kcKi9Nzo1hX
zq$C71H$4ID0hV6vi40Dp8UGP8!j=mvu1Z8zG#X@Hb)!MQdo#w`et|3@0nNyi0^_iy
zNCt|tX@~A@LmJ~nzVZmM!oMipv~MDL7udoDIT-@pC)gZ5K#-#V9C&tPz)6j*66O4%
z)-%a{!k=J)_~pbjO4`BE(8Zt&Vp?r|MR-!A6OE!qOSFWu+9@NM6gPkF?v!4y-es@$
zL`KW%{cybpmE0=pF*@4^;2&~b-wmnp7C$xn2^MgjgQPbKHC#HuBQEHtVTAvwIX5-^
zK=0aq_F;^A=MWbX8TKcZf<?^PWYQ^21!0P>QFU6mPK+{sgCFk(mLQ`ycR-@lLwPod
zR6J|Hh_~u8xSjw?I7(MTo~`>GAj7An$U!g#TTbyI*kgVX6($OjQsdj!OOy=NN2K`R
z4XQb^=Br<zEQAmWkcnnu9Nquc9)&-c1wE!guXYj~Wp}>)HAy2V=Dzuo`&qyHbB_|r
zN9}2nsC_a915nhT<G7m~_z6LFSKOJwAvp-nUF7^~WLOR0>-jQJIK2aEf+Lly|1HmH
z+hg+_`tKANl*c+IbPHef2B0?|YeRD0>ZYSMFC@J}RmJ8ouPMTwx(7KP#(vI5<#w-b
zA;B^%=fmoYQiJhDzNIBZ1i!{<uh{sw72~T$0;uyt<nCnAg0t0x;KPlny$y;kR2Qp)
z!IlWyFsjhmRH!vqE~y?^LBjVdeP0q+FTvcu3+SRckyq7YKIPOgt-Z6QXr7?aQ)*j7
zHZK<#FEnV-%$5Mg5%9zyiTD9%{4?Q4_;qINzbgLWdCHoi%mhIds`1~^9(#*s*!lEv
zWy>dino#>q4^o_@Agg0ta9J~+G7)Dm!iN6BDWIVY>N(VrW<0u?K>|dQPP%jUE|i7Y
zbm839Y*=g%O$YVJrh>C``nQF-e8Ku~D~R`Bg`N^-IE@2+;8ktg(e^*_uJ`Fhs=9kW
z9;k~s*E!@^99sI5cHg>%Clx2EFbaLV<-C)+xus_?_l0Kc_RH?x`eVH~QsWFMeiYX@
z668UWqk2>(Zoh~0-!`^4I?VT4+8vi7_&#zns~NtJxx+Y7n}|7MV<aQsL|0$OL`w*5
z3Fd(zPTfySpN?Su0`6N2>p@a+u(Yc9ezzqWhhN+bLccNDli`em+#l+WckW3&Pa*|W
ztzYxEZXsT(ni0{wxu;U8?4+=&-s_lwL^>mEVZs=_a+0XniS*cAdq`V{OBbN)v1j~`
z+@=5kWxF`5*8JPC(!Wp|yD=RpwJmeHg)KN`slm9i{F{(vgFulQR3vcHvI%0JzSF*{
ziez{B5Fg^bvfJG6^qcbX3{&+mvdJn2j+P!@&*L7+&(9rhJ7Bs~<8NGF6GEkY%cfCj
z<g}KEh}IOJVA8dt9-T=Mh73Mk4JcTmDD$u(bE0^Uy&}btUNkqxz@aSDTczA-%8D7t
zH}n_b|G30_JGU-esQRcYFy+*Gdo7hPVb{%T2i!w>|1bUI0|JTJF3U47;Ancv@;_q;
zXRbjnh;kC=GI&D;?-bY8&ij)5T=N=Z(h+@W*{AA+6aJIifNJD<jj5b)*~$xZ;q*ak
z@GvSq^LCFbsij}8L~9wHxowyARxC-;Uge}`P}ez*TS8*K!KWLir&PQl#b$9Th@1*7
zmItLT6+ZJtyrF`-MN7B(=-HYw_=o}T_I1Qz)y2zTEC!S_H!>F@G^|jsxhYE%PN6@X
zY2mc|JC5UY<imf#{OAz}=KNu=>p7n<H{bB??qEu*S<p}-o|SVJ9bTarAAq434QPnG
zQU89E21!+d8%S*$zg<B&hD3#>F;FPU#0=8~*7Ahm-aMfPTQF~zsYy=_Q&D}WVyO|3
z7q4NAuM2f10<$xb&rbbcIs0S!%fBEuni<^W@ZkO5!a^er+%`3LUsD)fhc5KN(hgR2
z)4L@rqNCI{ck@hDeV`?}BuetO@I9U~T;kRuh|%pWl&}(V&`|ZlbFayF;Hs6b)uP$a
z2a2fXXCb>VKb1}X6Ap_U7>*640B4sH?QvG)UZj()=W^vzZpj;HzV=FU1%{v0&EYEm
z$^;1L+t44WN0aht4cjp@T#V0FjU`yv66w&gr55WZ?%W{#kyJ&Ge*S^G!<s)t^KsQq
zjMAwtve@z>%bB^Mm*VNyBttl*&z;<gH2OuXwrTQ4VH(qfUb6z}2ra%4_<=KiE%(;w
z5A|AsHSf>xi(3O#pBstYUb}?0Xy!c|*JHWn`U{ENXk+u4Lf;Jtv%dml@u2W?zfVQU
zcK^%W7Z0H~Gf_KipDd*=T!xFzksR|eCkAbdy=xFuf!`4<EOlihWCcLT_;m2Xt*~=%
z)1a`2NRX0#8i-za4o;gldCq|REdB;2=lp`~@#0J`o!#sJ&RChz`c}+B8m32UOD$r(
zn{SwBi860ZJN$7ndh(Kbd?Mv<h`s3ca?UuEB`tGzOn1E_^HBGK|D-;@coxRyX=6Eg
zpF>vg{&D7mnam+hu77J%ETlf6y!p4l4f>Y{Fpf(-@d@FMp2-_p7RyB;-`mbGR>7(J
zEJ;pV10)BKa>=Wcc>bdnd%0BB9N3GEX$XxUJ$r%tUP)n&>_toC_K*HYcS^dx6vEV^
zO~gY~dVe)NSdXPqa6$&S1Q|sAP>vcVl4?t5pb(8qrV)%$8ES1Mi97n^9Db=7u5vu^
z<NoX;Q-#EhtG4$g<zc?V5x{?c%%AmJ(sUf3FM=|jOneaU+@c|-|EOt;_{l^5I$H$m
zkZ7WJ4=ehU$dU#pO_KTzVOyD^Ip?q+JOgX~TiuDabOBnrsF%Uy_!{)Qf~RjOsgAV6
ztH2W6l)b5>YKt8|rm-8l4Uu+9o$2SsMJM==j@p>fZ%|i!Q*ZU~6A(sG;V$O6wmAE%
zSNFBnc?ZsOW{arBG$n6E-!K2GL`AMcdwX6>B!YXI@Sh<nCA~X|PKRxA-PE;P;Q%rn
z=Hui9OFQ%ta?xSk>|5zSYy2}lE%-!3%<J~-unjW#uP>t}l)&89m(2qH1Z8U#<Uy+^
zKa#fyP`{tkB{WTFe%LC6gkbpse_T?r{<{w3?aQWc^VMq^;xA6vP3B8orXHI6H;;KP
zvHud=ZBh@0o(v4J^18J_Xsz)&4WZ2-DZF97G9_8`H=~4u0wrJ#F)fcdhwAWhHx6Mo
zM#r5u7~3!XxLx$tP5c>Nn<Hl+uq{C97pbWbR4xf%XTrc=+s=&jCs@q=5X~!@HImyN
z^2mYaAnV;ke)<~-m=6YHRj4Vh$fK<g^tlf$!ts!d8q=9Eoxt_iBVDZ8)zkZWMAm)o
zbH^>SswdJ?_vl57q$&RC-`@Ppn3nvTQdQ~~&*oz$K17f;MNUYXnh`AX+jW4MbGa{g
zWJc11nR@N#diUk?6N3YUdG<hbuK|sE`{ovwl()<136j4c;qZ9ZzlSa$a3cTSTR*R^
z*5P{=hd=Y5(J#RrhO)h_P*puhRn1;IVwgF=Gw;%~<Qdv0haRP1z6WCdQZcxB;zY8N
z_(youK4MO1B^3k4^4C)8vfgyx4YU;&7f3N7_DMrW9~*%j-emugyk1DuBc6|iJ_4lt
zGhwO;_~AOXjMG3BGK}yEZ{EK?{-!FyLU3~aVzzN1OXF`cY<MkyUr?0sohYNwe=o4C
z3QXP|!m{yxE<rdC8vD$8UUw`$4*W&1{@Fgg-|Hg=gOv?tP&e%I;<1wv*0*s>rKS+&
z-+ZQRKA7Lc)F(dnuj=$d`!8H`Llt6v@S<YABt0vAO+(+;kq<JFWYP6PT{GIUoZRE_
zPF+CX9O%`aW3YpX5QKRH!9&JWxXdolfXY!6KL_zj`fOcqr;_UU+RiZuIL;8hw0&d(
zGjd8kFKh%1$T7@{Cq41D-AP68^4e|CplgeXyQ@AA-};t>Fbv4#PnrvN3HSZI>K@qL
z{ZJrxE1PWu%f)bd2xs`5n8rCDWIV+Cl@0SBR|ylHM_Eo?x6wn5WP2j5N$H$Sa*ZW#
z!)-?H@`}-<pp-j|V7e`p8>|ks_oVj+A{^xCzlzp`HTMTbpkdFl$B=gm=0x3$bP|?8
z-zx+))bx>i0)9vU_TZiU2<M<XMZOWFL{O0XzO2AHbw#%!XOEu;2-vdo=9GFCj#AiY
zmVVMR0OBPT%Eb1YS7VeqD&{Xkf-we?J{pOB2bg=Lk>&^mcL23vgf5@9;3sK>IXXd!
zo=*N`L9GIQ@wrP*LR2{Nb@Ohngi2g_<IA1th#6wIKQ)Rsp6q-QWUnfAS(v+~x+?5?
zoT9%0kSBN}cYyNJ7?T>cK*pbH;di>J^5L7EJ_!|SNd>`7<u4s%qqfEi>HDA<mn^3a
z{U~Q|dyN|l5fLBeYT|E&hZ)O*A}PicHB2QYC}X0pmABE2pn#y83=csS+DAqNw)en<
z{tznqZ&(FX_@ElO*8a_`QcYBKFo-rAkXpzwk#;t8c?n0KDX}pno)4a{>f3esas$``
zykpg~cu<AIw_Tqies8@`l*)dd#{FBglu27$AnkWnGbVTS9BSCD@Mph3qPxDUD24}!
zwIiFD0RRE$ZJvUlASx4zr!=0;Y7pY?94&KK*vr~ZgW9>D54=KD?CfI|g6g(Lc*pui
z7=JXd_F4JA8zH9+QhHwY;KZXpC7dNU4LsJ{_^U<g)Fcf{hq2&)ZQ_=i{HW;wt13UH
zZJC|ruY@yjF`nvox?N1c%$L^pcM`Hh@yu8&1x>z%jG0s({5wodKe`(DUju=*ozEFu
zF=k?=Vkh9Qn8qMSW2{G8`wbPp70_DOEI0N_ME*UkoPEkwQ*JYjv|BH!U3bGgFGYvS
zXr%r4DclYx+VNu#>E|UtIdt{=6On$5xdsAX(YZLdIKAxl?y&yR-R|}c%lmWn&j5`d
zHE(xLR`us1K`1h&JAaKzjZS%0?}=klTwxOlBT1jMF^d^Z%JH4PlRHK%$;>8er$G6#
zG&b|Y5z=keYgpLV5w5|sWC4P#v|{&i>YC-mL^fIcE!_ah<GFxKOAWNni@^GX<>%A2
z24;em-ed*|?};*l-XYF{nFWLX74TyR2aFcu<)57MQImQSja`*MWMxHntou&?tYT8f
z5u6obmWAWVXG377LSr-t<}MXER;)(QMcM000{c6w#0PF_nXUQr!wZutWPT{b26`vu
zKjPK%M?gIRt7K2NIr&Sls1)@NDm9RAWG8{UzpA5IoIm!-Kb(A?ZqdVtB5{KhRed|*
ztiF4VN4XU-RFXP^P$AB+r#g?CxjSFhd^JJ|)8m@yLY|EGNQz)tlU8*ao}Lq)JalK=
z8f$tBld%6O(v7=4qR2=de+;5eA+*`w&FFa-mwY_&W=u9lB;l77a@nK0AFAfuNFhny
zLFj&7`o}%UlVK969<+mRd-;oztW?+je_%aGPGTKQ#MvMophoTNos*mv3f86`hm|KP
z%zx;P?mIU4A}`QQViTyTA>(WK$dbOQGo|4k>LPQf66bTsjf7$M@wTDEMHIGoTDFWr
zYs&by(Hd{=IsVT31q@C+YH6mGG)Oin#cBO5Nl#^;7B2gk!5N0r2leNCoJdJOnSxF%
z$tCTns>L6cgOk*@J;}Mi+DMu#>i{MsKdg?PQ4XQy2aCFf@3hH_X_O2<dKx}K9b|&#
zlXzMDx8;Sei&h+4^_5R>U+}&BB;XC)I_R~^j6UBR%a$s=tbkl7D(B&4e=Dh&dmg-9
z*6{TX6yeR%(9TS<6j!@G(ppiei$mOeJhE~bHpOqSUfjlkbTU<*XLo3}{=jQUX?_v@
zU*w_DzTb7wMXz#V03>Q&mZmio{Q5n$)K{;&7b0vHH}GdCF9ae({udab0KeNXDOSEA
z!W&99a~#OL?Fg+Ggq(S+ho~8%m@*MjrTK;#{4o+L$=s~h!)ZBT#Eh@K8oD$NveY^t
zA7**oxaXk<N2XJ)5{Dkka>+u;-(&Mnq<P&b$hs8JXMf@E&{xy8VE**Q#9;=fC)NED
zp?Uj7i+7OhK4wR%%Ezm56!+nE>h(bC+?|Em>q>j1*vE!H;6}sHqsH0ce6&HU9K3+z
zWT7^d14?Q!9FtU>V`*IU<j&4r7!z1LSx|SBFK_1Zh$ilZM&OIqe;#809R%T_+E}Vr
zzvPxiX7gY4jLk|jpWUS*?|Q#yim=lofV^$gp>j#;!;@;J&d96BVF-&E3w>$Q-l~I7
zz4tsoXg}ZBBbjO}BAyA~!xm()r=1*qLvOHh|59*^NC{vP9oR_k#P`C*z#8o(#~aL8
zJ@kYgxwr3$?foTGPi`)orD}+D98(iqRxN@c`}0eF|F2k(sEwqqpW)5kD(h-Whki>t
zn$W_G#W<?L6vKU^%Zm-HgOGqDZtX&gf#wBQNyAs)gorRnBfP}7d%_LzPpkS>zn+vJ
zv?b1hym{KK)@ZkW%hK%p5C~PG!opQvz$xqwju6`Q*N7wDOD(G?|8f3JjU5=<k9X^i
ze-D3No+B9@Rw6a0hwqZ7K_jpnkjt)<1wV(6b~+3?-6y+TB5BqAa?`otqi$isg0pzI
zA8yU|A0$crDO0hu)t?~=s(J1dF}@>=!Arxtt(zMhJ6~H1i$A_eZ);zQIWzXtQ}hX_
zTY2g~Kp;7Sg)N`Fdm@2g;%C_+2bN5=T5rwANMW)YQQ5W17@5SRCM$4LWqQ;v)xCE=
zlX{`^XA`po-s-de7Bx^M5an3Mo#YK-ZrG8kXeo<)9NT3ZX5lbz%|PjL5WW}J5_9Ca
z({Oa+{s{}Se?cbzMr9N)#ynt|TDx8&vblMsoc9II?dsT9BW_SozMn*wF){q`v3U#Q
zc6p$|pmRAegv}q1Qr~&MIkguCGvNXLDJEMXOP@1e=fNJgyr)j65e*Ddvg60eQQu^{
z%_fyD*>D_&bBZsc&&|zBr0NH3q};2%tDwNTSCt^^C*py7a}$?JU&9w|rCeIQ`HE($
zD^`pVSLv0lTR1lbNu0&Y2zofpCf>8ZfioF%ST6h~Fx4ny!Gsr4!#cWr(BrNs`7{{Y
z9Iez~#Bt*T5mT9=EG2LJHYE+DAp7~Ux3_|b>R}L1v1ax$e|Ls4c<2bXi>_S8OE85D
z7~8`8KGkWQFMhFVERqRHKi*4`P9M9I%cSA-3_|e%ME{lRL0}D~%Q5bES@*jh^p)wo
z$Jk+2*U}D2hb`C9{kFMSqEj>LI1fQ182!fePaHpL)#M=Q{VSJQr5u8EU7`Eu!N0S3
zORsl78(Dum-Z{QIb#MS@90s{Z*{Vdqi%YknH<&EXr_xmUmo^myL^9Bl9t=Q2pe|)+
zw9b*1hX^_{=Q$V3Y`{(){PE&HTFnE@Gz_{l%nrxf2^jqQSP*Ys8b=Y3L#4wtM>D$W
z?>>~#v^0L2ikHx3*%T*-8uQOWlDw$$6RGp$*+5?Wz${8zNq4KvyaQW`^?tKqU{Wqw
zgj<6neQGpI@YYUrna!9XTs0dpKI>q*jZw29mNZ^FNfcOYAN6E|JGs*S3{TI3s%Rwi
ze_!ZU2H<*BEb>17nmL=8-rak{@Rark<ZQUyh@Ri{g_@6494h56Z!W!gKghj48bYC>
z@Qc7PRFUxNahZaaK@%99u;!d~X_{9v?eH;~LCuoLXwF?@*+1QdnUP4}v*CZ8`+;RN
zT(pbmEKiEe0ZOa<)c*TmNT5TNyH!{9h6D}*IN~do;`)Fs3lfz~>QE3;wP>77T>=88
zv@xxxw`w`4ddVd?#_Y}oz3_*ktG=e%k6UT0KvEUz+JSa6JpQlZkTPlJiVN&+vPY}~
z<%kPifINMjMuckXsoh^NL3sLNU}vKG#Z^D(sAt&mu0k}+uc^y!cj81J{(H;^tO_u=
zu8v#n5?DFAq3kh5z5;Gco?487qds$WU4jePd0!oDP_$j~nwvk??zSE<o9Z@%CjSmS
z&P$&69RhVhB`3F#YxKu)BdB*a|LDDIhhihi3F%64bT(?toe6(s6EO1WhZ!fXS8K|f
z!jB7-K=j6fj`aL#np6TsVX!$1lupB|`an7G-MLrw3mrGSaQBEm)>ooQHD_7H|9go|
zFEbz^=1V3`g`|#3qpP6qZE3`P=g^e-uPO?1T-fB66+?MBJo7=o(eQOOMUg^zJ13Jm
z7<tRq*-PK+2ILGg^ZXSK>!4*#XgT%-0ez>3Y4mSRFmALQu+pe(Tx}1BiQtVob$40Z
z9%!_lJ$9&EFgglctz5WvdeUsRcAoQW{X!w{S=>6HZO}+grsDV_gv*`N2l~Kb9g+0)
zcP7#n^Op;SmUmY6^YY;KUA{QDBQGdAnw1ZwTr}P(?5?NgVnsK41%LuZxH^}HfA+II
z)z3(c=L@G-ddA5RQ+n}9Kbly2ywA^ywpL(K$KA<tTplc$KR{$%9p%VDt7mbD;}6?A
z)w9*waj7kxL(BVuwr@;9xDe0zrJwo^Zq>M(sRcW8=K7~pFQb(Jt%C@ONXYL~0Ikjp
z7Z@kBrkS?>eCA@JnR#oF?40tWi%BYHx8%WD(uI6_!Us~9EbILI-FTonVRaphhH`^A
z7!6p-DJodLrONJ=OqEy)y2;&osh3=K`RC$5>O-A_#3lO1+-<<k5LS8-FDcC5K|^v^
zYDzZ?fNFrVy}?;+y%mw$*+s~_hFmuv3HY0Bj{v&$_=npkF*3eOI%)Le)c8)2Nb+-3
zqY^s}>$diPIwCV@Vl=)A_@t0$vzV5)lmO@eB?EoU4Gr;zT?tMPx87!zCg2Q-OX&SL
zXaZgMRd4m|G#gIlg++D|Unn7%M^)f06Cws+EwXPg<*<q}^tw*{iLt-se6JdKFK(`{
zUC^sp8ytC%WwrNkdn?{ypvi`>$2~>5WI`Wf-$T<*M2n>GL6M?ex@4EEo86wiYL|yc
zl7e@p`ZnZJ|2<9Xsd2NQ(N<;}3d>g3jrJ3?lJlDQjmo(iFE8|aUvnp^**dvPBIxCk
zm<_A~JQp52y_NX7R|#x&y_NgMR?exJMlz2Dx`cG+=1~NQujmP~7}r8mVM?XeY3rQ#
zBws*bY(p_cwJa?{UK>U?Ic7_cd_qt2h)+=O9!~Dl<Q5{tzr%<B%jq5jya(O9^Oxz&
z^EjTeKHT|WYwVFRC=?uGXn}iDO+w2E#R5%+5{B`@sNV$RxvQ@T$Ouh#;vhkd=G2$<
zB#jG&h&puiB)mU|d?(Pz=gx}7e?ubfY_$#6a#09}Yg3IV3_Lg1OC+8wY>C{%&}~Fx
z($Y2@bbCv8VD>5>F&0}N?dcMT{XU@a$HT`L4vtQrJ9>@c%k`M=Hz?slUW&OCCrp~Y
zOqAXDBKI-W{lu6y4$HjC<M?N6mCA-d<JYu~8GO)in}VpyaUIzu+S|Ny7NMC1w&c>n
zTegS?7_`M+70HxAn&F_+8TqevE5xO{8x-Gx<{Alu+__S3T=&|rN>uDX-O9fIIb_*z
zZMZE059Vv1v<%DZ$_-pLIY?fm(8oc_LFo#8ky6S%JT|LrkD$c+X_5Ee7rVnWs${a0
zj>}<Q0-@i;kzFaQ)Q<30$8&eRu}IL06|fY$Af=o-cqwbE1X)}la-AxJ8>u8-+Vg}O
zk-^b%_DHHcGOqhkDL)_t8Wr*+KM0b9Eb{XM8K_bN+bk7Y<J`c){Hy&OlcRvv1(i?3
zG;ecRF1LTekx2#rk*Ba`FHy)ydth=4i&NE{6%Acop%S8v1?IbZEyX;ANn3^usSyU`
z@*++myG^q;+L2u{eN6#ngAd^LMfl1!qP-}pIQnFLX)zrqy8PoD89nrar%{EoUXb*r
zHWXicR7sGV?TrndwLWzu5<xcG-TNgjoDu5vdl?$6K$z0hYwF%_&z192grkU*r%JoZ
z^hNAcfue6jT$iHie-qI(rs5i*+@&-50CPbnjzlc>6$~WsGF4X*I_|he#rDak*Y6^L
zQ9KHGaj*mtD*^ze%!OUCQ37O<eHQ_=f^l+xPXd=s4<F$CRid3k`z@KfoVmMOlQ;gR
zohLAoc4933z^@xsR~m8A#G!~WdNx0X)}*!mTO9$a(`Zh}0j4uW=x;89O|L)q>E{%e
zZ36mKE3R2{$kILlgWRW$GKq2mDJ%Uf<zv;<^&dYdpW2|q4nE2jmU&3kb;hB!e;uaR
zPC5>eDx3Gr<3~!hic&D#8>~0|VD#Gd92K`K$3Q-JY_8+ZwbV5aNf&j%Zt_tOki<oM
zdsU+T`5Y<B(j_{(t|0{`*XTPwyBGRSU8dP*nmb(Nr)V}|i{}ilo>iVA*Tqa3{y1}s
zV2T~OJlME-Fv;yI;Z&F+qKkgW^vHnMh}+&dx(tkmcCZFOZVzg3Hn9uRrWE=ajyb7?
zz;R`dfcI!TIOK`R?~#1>hlYXQik)e5Xf@vW2ZCm+{uZgj@v)P;y7`~0W3(xFkJo+4
zX|~8H24i_U@JZOC`F84?Fz^K_mK6&kP+MufpQ3&fxQQ-emY{z|jfkt140o0;jB54^
z5Fihmca>FrZR84Nk)yGO#9N*ntmDv+<WIgsNrwqE6V<n8%YvJ7gRSBagK{ST1t$L4
z)gFiy0a)mMUpf*QXbs5a*LPOdlcurO9n@e4m2<-Li{ty-4dF3MaE9=o=+wMqEBM5Y
z+v03tK5J~`_>>#-5&_ikfz0peiNm^eGB#$0SpdqaBP`ppsE+fAPel&;ka@ejU5mp^
z*Ex_0KJZC-ZB`GFlhd(UYDraE@7FPGxpm=3%hF2C49V=>q6BuQeqbWG_i_ax7Z>Up
zjhmN-<*NHfa`w@-yOLtNZhwx0y@WDPp%Ki??FHb>rikloQWs{C;OoK63rVTRD(Kmt
z@gLEC<#bT3*$?zovbDirX7LN0zUK`pjMhveCWiq(O=cwMsWEz4FVtDfSpPEeXN>PS
zpad=GhzJ?jh(fgXvC`v{;iw0Ke`*l{;gq63%0)p-1g@l}N84^GBGZs(r|s5>wLga;
za^)KkncR5ekHqgnRPusq%mm0Y;^xKh(EHeIGA_n9%mgRjj8u;ivr+60ivHX_ml&@s
z9O)zufD>P(5gq7-DmMmJ#(ooMRph^Fyi6+xracXzJlElG6^SP&r*5K~@NdEwQT3K=
z+$Amzrw_xXuD={z61w^Y^dI&Nn&Fs+iZQ@Qo=SoU<4nA0tZJ+?^I5A9l<-O}DR@93
zD@(pD51<|7s*dv*EL;4ttQm2GAf;#OA4`-H!j>#*_1=28q<HrTC$!>^&82w30vjx>
zzPE%F1Ed9vX+rM4a(!A-(dK1o?litV(psl*x&-YC>m&}bZr7wQG?BOMB~^%oy?-+Y
z$w{Il+FwM{x3c|^E6{;;B;Jvb@l_SOhvm_nnh0AGTlu*8@m0=FvtKIpV2w1@QrbMH
zyblH2QMrK3ZOZF$OLihcd!0y8#k;DFvD(C(g6$~gD|Gn#vXGWqQ4J%s!jr9h@#sVo
zoW8d+2LqJ~4GC!}iW96A%A%-9D6EL+`|kXgs(urjkT9MI$1~qfXa}N7L222htP~Ib
zDT3a=pbu|;!TjXz(GunLq@awYiY}#_-YGhq`Y7qy?ck)KWdlsL!C73gUw~491KA7l
z@dKG(M2MplLSZXLwt+&YpxVb_k$gNJO37v%Kf?`*)AbYQD&N;RH2oODb3+3sHUv=%
z7GV6cl>L6yN-k}#ML-~S7tbI!#Z+tikq*!9u(h*5wp9bj<mqHlrQu3_nmKIRkt`AI
zkGu#sKWQ1=`jGgyGx6g{Q3(_7FhO772{{8H#_HeFN8+Z?%cSYmXS4M3?P2UrILWzu
z#M8A93ci%8dipQtxG+!pQ3pvsHeA>Ua}|`^Rh-pUAqH@+ELr4vz4s^l=%hImC%p5j
z0zwg~q(BF!C=CQUtW~H`*6$u3q>8LA@|&dnndFL_8v2sAA&yAh+{QiQ%Y1#lUH_FY
z6k=q1Z@m*IJVW7aYMzPu)MH!ideQWl{Z8~8zDJ9(O^Qet?jl7L<II|iA|g4D$=k1C
z45&=CheiG3n(AAC&B0$|7eVnf)t9fG{A~<3V=ebL>}RK@9?^VUB2rw{^`DunNH|@%
zo?W~-It$+E52>Pw$b3OZwRGI?TOnAh#pne36TRLoBAA7u0(cG=7U(GtJxm~Q^}-1f
z-~8Etk(;7svveENImSdbZ9V|mc_&(qhn02%UAnBR49pX>4gZl*vY~n(vzSn%5Sp<0
zVIgUmD{ko2hMt8-tS1<hYMrp`9dOB)O3)F(rw;5(FVO_Dsm$yL02q0{xx~s=u_xgK
zFv!|DdgsT+RqX*r3{8*!cD{5XWlRk}TP*~sciqG;!@`SGxC}&@3Dt_0s-xHqfbY`S
z%LIDX-yO;hQ}9u>D7v+q3LMKC2WLY;X(I7x5nAI_9}1)t<mDfai$m0*BFi%($sThX
zvV$`lu?&0sL#gCX2rkI|-~E(ZSJcqqpfo>vFUSG1BKP>%)Quku?5Dq3cSqMkqB!8x
zYYN}q=F|QLWAxEpKsF!&LQOW5tcb;%7;11>O4(2q%j2GvO0?XTJF8qtZmmvnClcaz
zK5k5qM)x!xKh0{mH4RZFRqC2Kkl@hYYGN-p=x_7YaR_pbBeg#pv5ZlSry@h@*n$0r
z$YXc^Tx4{@>qw!5tZbi;Co|soAH$MBKQ>)j^joh)c}-jT5N4HuXeUMdd{-Uq3n#gr
zyt~-AW;j?f2B>&?0|{^`b=3kpa1Q}iYBIfQzmH;Bokg%Os*)(OXQEmG5C~2P!?ZAw
zSmeN6sGHwoWH%Wr%T-pwqCJG{{<HW$(qL+;=hc^6mWp)}nZE<A1cbRh-WkPso@sqK
zUTM_~?}gh=Fy4A)C8>SdnTdj*>ZHF1$b9E>-@M!#c_eLMX5<c~w|EEy3=-#>E@@XU
z*{tj-SEElLxO+ve5nOV%b5CZs6{{nyY6nIP=3bX+UM%xyN{$!_5Gfz^)9-mwVZR$f
zl)ZdVaj=%8n|{<%*g=5oqB*Z0<xVdW;CSMezJa`zW2X@~C;VIekM+=f8<gJF_Sns^
zp*~X(Izfs;o1)n?ZT=NWvkFK>2lY#H@xO9ajFY3AUlCD2E-rVtD;-@Nr0#)<9NR_T
zu3fXYOClmqA1o@Kcm;j99EC!ne+CWr;o${Gae=thik;n}4-8a<&(-B#L)~5SDRoP2
z{*Rk>Z_NF^`#TP!XE6xKia)cdomV@f{kd%IAYZw6PDE(xjXad0L8{$O%uX1zjrVE$
zhWVKG7~lzFv?=8M0Kc*0_xxl*MLZUQw}j2q<K!wW$PFr(jdfq8XSRIyzJ9d*L4(-1
z0ScZ^+!lUjO-VM=Z{dhvv502A{s|pci}}gL@m?v1@>Mkf<T7P)wRuBlddCb6+g|x{
z^E_3k)VZ4KSkR6u?&J=Y7p)Ut+b2U(F$f>hNTj(4Xr0$#&#sOX|JAmZV%TtR+|?<v
zLeRwOzCP0wlA}X2@~XXLNp?AuOg7f+({S_e+=lug81sIR&~J@C7p9(`QBqp%-%g5i
z)dul|2zC_M>^!+UFcmd5(X<<FKEd;+^Te#TLUo}w15=hrrDa7K%c~dZf}Sww@K3PK
zuH<~Reu`iE2K(txhk4NbXk0$RC{?y#Dz1@a3>1{0r_g37#uSU3#l7`bd*U<40KA*U
ze7gCX*tkRk%lyhE!OR)gZKv0zJC75}D(4ZQHrfyuGvif^aq5}R1%R7n?|G5Oe>afN
zH$jJcXaE^s3NRJv*9~BdJcgU<)J1Kr<Gp+f<?vnlC!`*Fo#mY*wZ3<=)rFA?y&cQ8
zy{z!?_8!+RiQj#P8@I^%#sbVzo~{mlp-!EODqA{P+Oc$qO0m9u`R(keJWofByee`R
zBu=<EI33TAqjy;ix~us`rqjViC6g_h-{zpOczZjCL4N-WC&sL}0v^S^yaC>E)l#j2
zY@IZk{7s=65bY&wEfLS|xP<XE5~=Nv7YX1RVFbBt^aOuGFG{+rwFsRphpAGgmUNo;
zzUa(TI%q*~p^#S-i+D5N0;Z~7LH`2+_srcDQ40tI6tj?!j7T*26TgJ+SS{7==V|-X
zdhn5m%6ZLT&6_%G$92uTRCm*!ms_jijH%8nmzY^#|D);Ax_}O^4@JQGneXH)Nb{4Q
zM%Jl*<I~sYz9VZVr_iCGwwS{wTOZyfSRmcmxZ8{PX0n@JFGuv=VWMRF(F>v$PND%E
z!En8d-%M~O32nuC`#N74Bq0?Lv1qwZI>G{zC{;om!iHn^@_edZ{WD&jrZu7xLG>n!
zmW$bnK%@FvqgxDEY9P+mvO#mQrvqm+1E%rb@(>8#kL~K;qo-t@gCcl=BGjtA6=e`y
zuqDPtB$kN#Y)Ecr<H3MV+{p_~>f#k-LdK?5i+M40d>yW@3xtjwyU!w1wpB2?Ecq1s
z{BGn60R!O+Av_W?U<8k7@pj+I8@-D+yj)06U8nAZp$q_5-x{8HwM)b$Vv>xL_7Qwa
z(hPr8!inW+C-YZwpx-^q3{x*PI#5f5wwNiCvA|^%`QaU~#*42ISf`6kzs~#d(O+H^
znCGqB!&ACCw7vgaveGQs$RVn6aP4sS6{0=G!QxVXY?FFZ^x8qWYOM~f7ACtaE3@8?
zcMT5yD%#sS$yPyCjo|Cl#o#<l+$HWx2yNqgS)CltV4R+$l*ciOJIEchm~k|y?V=lm
zt7I9Lj<@)3MA5AatI-Z#h;GDUTV^M`)0`oK3?y0KexcTcCx~C4k2Ta+OM1G`@Yv}j
z^9;rw@w$Mr0dgz<t~*+0MkxN-3S2c5Q{*MD9L2CmhUKbq)GW+crcdQ4X8+`eSCw~>
z$c#*qg=lwO2f1|<Wxah7Is2pw%uy)PutCi!JjBF7O8D&I?vE%8{Czx`Nd==(MZK$@
z#~+vZ9I-fxPUhBIR`R->jC}pkFPUnET5y(J)6Bk9f7~@vU2s00Glt_olIB~cke=CN
zeDc9vm;j3+uNcJkFCS8<ztluW!Xi7X;f;ySh3F`r%i|T5Vn8qtgGs_|0iMe7!h)*{
zg*M@tR}0f8;rnl*acUQB9YlNMle@YqDUevY-p4*3Ek{-OA4@6Sy?qcK^UUp@qpEhs
z8~;Hk{E4v|nrUIpcQ*c<U>~txDrvSFU@B^c(qMuyOT#LxjLOUP@g2Y1hN}x3M=`UN
z$*KI+q#$(4PK&cV^gjgIg<4RsDOG%-&FSsq2Kn?YNAx3sdpjw#ZQsAyLUEE6GW4Qt
z?ItjtHhad~2xq{{UR4PaSaScX4mD8sx7pi^M&a8#*xv&b5Bf4gDz`)oE)KG<h-}jZ
z!<TK20nN0#W4L9ub9f*+e7WmwaN-y_7!xP(-Jw6~<dw`tm-udW2O%l4i)At1q+o7z
z)8s6`px4BqKXPnR=xq!B4E<^TYOkd!FXs<Bc(Kf@P@2#ht+XW}eL|f$AH)3^Eg(H^
zV$}i683~tpPBpbV#?*%pe3zJ7;{9&7ChrRu(?QXyQ)kwL*{XpYq9aU4I6gPcHjg>-
z#+vRIOH#%Ytz+h8{Lcoht-^4skno}BgUZaS;6*;K7A8E42Vr~`rXw@Hy}S42(02eW
z_5H1PNy&>U;R~rQY)n6`R_jgfXEEzuHdjYI{f{<u$e0cw-*!mQfUF`zjM386&Q^Uw
z4e-y|MoE&!z*0X?4MRKKTf}2(#;Voo3%PFfYuw%?3gIxr#UQad4%bUjcYqYW^SV8d
zswm?0$jER6UvW!J<qm^HFmcvym9$1n;!@fH(>ybQF*du^(acL$=#i)0L^(!l%B5rk
zeX}PZZZohA)wu<Pqh9l+;cGo3uBFcqv7jqo(vXU_o5>58oTsW1Dkp_BSn#^ELEN(z
z$K6ZxMCo%5kH%YKaGX$)*&vx<Xgo~rg;v0>Qu&x12>ls^sk>KKrtsY^uzp%G*e|Cr
zT1mscRJ`97TmNeto2P3rk?oCVb=dYmkHqq9QQgAU&!!u~DObK*S@l1<LGO6ZH6DB(
z@p(yflC=iv)PFL0OQNc4i5R`MF&mKc_)E)>qbsgQ9X*vrZ^a?}36wzo!9ZbCO}Jhx
ztURf4fa7YUL2hJVqVIaeqO%$r&9dZQ5Nv!iCO9a(-(eSi_8aH(;PrdCr^I2cmX>eN
zmEeul6pDI<(lOr(24onA;Pm&OGjUUhwp65yY2C+()(FjSdmZAQxv)=yT!eEoo@)7W
zvCHSf!k6$r0jIr|=G!drkux2i6r6Zj&Nq@PeEQRaiZ@$E&%SSHdqf9#9*4PTgImm&
z>eW1S6nqX&xtnb#X5qQ?SD@p=b7W}oStl;1+3oUQ=ck|DO2a4atG#R&ufmAiYwL2K
zV!Piub%}nF6EY*1rLfcQ@qi#;uiZJO<&EL|vgYThl?HPzRgrkFlg8n^p^(o!tl1{5
zmeoWsgtdki5dKpM_rzOa&0xR$KLKJ@yIHCv)lcq-I0pCXq7<Ps{AC>GYgT*Ss2$xt
z(A$#&a*SJen&LMnbm1hZETh5oC6%cCcr1l31&Z$J(VR?5Q6@$&)y&449cNgAJ{ZIm
z2PANP@5&(k^xkXf;I1}@W4-5i9=OWJ?X6mAN55@<4%H59A#|Cz6kFUHe{|PnQoxe;
zuy6SLTWq`P3(UsN#NRqF&BVCs^u^G+k^4u88!q1xB0qOO4X<)Mbb7Sj?fXEzvnvO5
z-ZMsL@2w`X{_iY2fsSqZy^GQ9jZXhhE2Nvmt)sK>nTJ1=AGYZCI{Hc!PLpUgWbn14
z&QRU>H9@c%<s4a1JWLnNs|x@Cn%<Eec^^bs`Kt|NVKlS@cO!bM<_~cEe1nmLXR}@c
zD=TFGs=BB<B4-^BuAKjyg#iGO!#@E3t^Yg#L_PKY7q4CWFLIFVpFpd?a^(0YfiB>Z
zK=(f;|9^e0QBVB<q~!qubJ{h)N$QGYK2!*`JOB{tt}!U9LYHJr7MK<<EJ&MOLs}0?
zcWZH(yC1hhtW-mBpFT(7tC-{?s;tzaoLbdMA04kvq8(GW`~yU8{otqqzhc+QPL3V;
zL|PC4_`j6`uKeF~(jD0*fQgwzzMh^T5(oYZ^45JI&q-PsK%RU<?};^8xHE^%(y|77
zVfG-?`=$8woF#3ovmgun&0rq8>ah>OA2Z|(%9GTwayF4DbsF<GUrfz64C}r@8DUC)
zrd~O5H(d4<GCZFW-e76?q|d<So(I48g)g*4tEC?=Un5_KSKF9f(etM}^qJp9d;ea^
z7Jr_~&}(XS+ZMbvbmjj>aa_}f(l_33VSX~gHs-yta@3#ml_#nTTpPv@g6lFgPljry
zXc6%<m#y!bB<p?wbEV_}y;?Gzc|rYifXPhE6gC`QY7?Vp?2~4mc6VJDY!J}jlvrhZ
zpOoPDf){gd#B#?!b2q~6*bXZ4!uD+)O@TK4c5@s~0Pv!h%@c>@^9_GJJBQ@|x>aXh
z+5Z2{ax;L=r&ne+7b<aUZa;ZMOMmjh`t@u8_Pm3xQ~kHpx9#p6x5i3`N5!IatskpF
zDA)rTXE0b(CWPnnFl{#_ivQvF{`a`&g{I$!zG_-0RMQW;TR|B^?fCINBbvc8@8ab;
zr)N{ssCAslzL3Y@KSSsMD#0>iUR+eF=w#01Ggt1E-Ir8d-``wbEttKZnd^`nk?GIc
z@2{Eqe3{4tP@m(Xg0&2goRWjUS7%h5^D%ad*|wggk797~kBm^9^WiSK@PaxvVKzU(
z9diXtv<b9YfUja!5UU0F75d<C1a=<Et;09C8N4?VAs{F~`VO;1=#}e=lfc<*0W6Wz
zg~T`s3clX3WeSt>4<HA{b-C{#OpmXSwR^84m-%A*jo(32WpSBv27Z?fNfA%6q2|vO
zPxCDXp_}N{w$>%p^d}7=oD*Dn*l4#&5&1E6B$!1D?k$+`>em{o;tC<~@CGW4EihWl
zOEHi_`0$+}_GFil$S<feOh)JU-(ey2&8)=@f9{WNRs<0;S)7Ze4Ka(q{0nT2uzMNd
zU}79=$(L-8<(LLJBO+*;!+jXZG1V$QZLH7S+?TMS{`T%2x)|O0m3*4t;F8bsN+%KS
zXb8FX*!J9QE$Ui|SRG52D)wUX4ZN|UF-b=hSqx<%_3`|E4@ju;d!=sTT(pv&Xf5dx
z9t~_Bf9Ljj)q?Bm&+@N|o=35UBMA>$e5bzhFw)PHvdMgJw^qGoUxFU;GoTrZ(cuQE
zv+87Z=sM5Bn{q93%$LA<jACH4U)amkIkzN9@TPqFy1AIkZTrDW(yUZ1_<R(TiOK-e
zhX{&ifoF%bNJcFB8*E=<iQciao&4lvtrl&mTDq}1ZsE=<xb!b_J0vdoE+Rwqh`1Fq
z!r0C*>69>_CFW_W$;d{KICfBooA6t~WkpAv#{(P~nY-5IXfA<#Hxua!Is~n-p*GPP
zl``}<t~ND5x`|(~M=J{_I(!bSACIHTk;dxkwmMqK1bW{~DuJhf{C`MdDEg-GmT!DM
z?pqi$MmF!E%B#qKalOx4dIt_NQTZJgg8K9V5RRli2fXH(SBDqX4>zxWj$0fJ<k7Pm
zEk)A06aA66oXd24e=L>)#kF7p9hpX#w2oPtlSUNwV?}gDWa(@JEPsA9lxE6&;f8ok
zm!w)z<6D?2mW-D$VW@9ne(YiLXHfK%I(7zuMb48GRg;=Po;etr^OGa;o7CNK@?(@A
zrpd)C>;Pf;C6pyKsV)DL77twhw93Bu3g>Av8~{JV4zb52iKZ{9fJic&Cid_wVp=it
z5(VrQeJ7w4N6bxT^hD`=xJA4Ow?fi8`v>A^h`OOKaN=-BH_MEDB|&`>j(}O;nq)l0
z{AI4vbdjG1ker7E5=8rQ_iMNp$Q$=pNs?{AbOrdjdX9bV1U}+Qw>Kjw#?K<~ACR%`
zXfvX_*Um|bxhuqYq+XECP7pq2$81>|Lm|9{yQ>(h<_Ghef0PA0Ugs@yb~2}ft%I~a
zRB0k1@s|b^WSP4E@%~p8WxjKedD0v1ZufWro)R=D8fbck`Q>{x5}wN<L8{S?R*qq@
zwZo_P&@2XCbYOUr20HhV+S(8`09zK=$Fp_FgpgtKz601wzfSl&aH-eK!iIzFZ^$i<
zG$wc^1#?h;qR0~XiTSt89Hhyxf4({Pku<iBkjbctA=~}Uiz)$iiMotX2Mqqz``rqj
z_TjmM+8qfexd#;>qnN`7vXAZ*-ziSRH1JQwVHr31nU9iuUH8!#i>P<behaM{*>`+R
z_CLI8E_*7wt?QG>Nw(f)X+#n)T60q9q|y#nGqfup@nSFjXFxPPo@SSS>POB8n>{x+
zRR2%*M^_a@kI{QD)P(B$eh}!7_(kt(rJ4cqMhyCO;ATK-l9q)l2Wd_;!sqrz!t>O-
z6hMGrme;ov7(aK15L+a<W{f3H1h0~KgCuYmnI0e20%D;_<=zbj1}5w>3L^3LTdk?N
zO<#Xre&Kmbq@T4E-S9;$f4id#ux`k>2LNQ1$%~>lwLpwuRkZ{9aKZ8y=35HjG?p<W
zSkHA}=ovZ4KPIC_Keg^&*U!7nP&@x!oSH*^S6nF()aG-;xkmT>s7wEiegXs6S<0>H
zTm-om$bM?gdFgyJqV+kV5N}K`$0B$S0CGA!8bCOSmlJVeqzDhy*bf=8OfyuX0iF@>
zH)S<~oezj=XB6{-nS*XIVRg#Eh|~i4V=>hI%>YXbb9kVoAy2_yQKBG;kI~8lNILo#
zUF9SVGSufCu~|3Q>(!=P8Vwqn)Hz<_;FDIK`%mL*C0{K$rKPkb-)BQ{B3VyElvxY?
z$bgx8xYU9hgs1|6jY>@%>ZZ<aDbQl8x<uOb9G?#tv`BgkFa<x*>t|0|)?m;g*Lt#Z
z5&tQVTXb4)<mWfD+~U>8<J(B;{EZPDYNOosR%z=4=X+=_{hu&VMF-q7fUw!^zoDN|
znGtSp)&jX&z-j&OVYZVu@7*Y~*knKtgjZQFXo6>&mW3lED#V8PKp$lu&+jwLn1@IE
z17A-o+#Gy8vgtU%4l#5`qlZ7T!z?od%sx1y!|5%njdO9X5-gq(3Y42NawH7v*(9z4
z9seoayt}-)sW592)(^x`9@O#e-{&v+H=6J#MSyap{yO6G^HEb7iSL$X!?uDX`loiR
ze*Ei^`Ni=3i<_q{VB_99OKf+Ab+|*GCL4N@AcOJp+D^}ox0IrRxg&1D28q1D%%SpE
z)9IjXBA5&ABwAUz<J4>?`hr&ea?`AEWmC&E^S(3qI%&Sg;2Mg*v#%#eJY;r*lU{#2
z2w3UM9Z5^N$=H2LuQH16KgRt7i$*9l6mY9G!@gF8pX&y$IxUXI<R?X4z=Utw%C+cb
z{*c-o?wE`;`8>?kV2-zYCWhH8s|z<^!JCN7#VdO94u;(N7qruW%cTL-27X9*%1#%R
z#<CD$^2yq5U3`Jo-Il195EE>$u@4a!tTee9kRlW6kjwl?{d?x7r|V<%b0vZ~t1M%)
z9=dDD^N&0IZQb((lMEbklQ)uPqFg|h=2UW$Bx&;eCr9!9El56AHxPWVM5g;JYAHe=
z@Vc1=y$O&Ymm7Zn)eq?ijBiZd*$2w&B=c&?4L3f(>00>RTjtrHUH2<9>+PLCot>D_
zWb5y0woEZr$Z+3D0aGc+C{@OayEC6DSy?=Br4;b{Y9iUyq|<P_Px`misRT!kxN?wW
zwm4XY6?gof_RI)6p-DHA3pNn0%Tk=i_{c2dA@jA9$DQ)^5^Q7TxqMJKu~)e;S2b-U
zJi)pwu?WwFs{TB}n<XAgva4z7<Kiunx%Jx2L+9I}Sot+2rtLAN3nj4zc}eU8J9B&S
z8;{!<F2yntF)<?c4fgNf-7}l`7%`{gq@tpPG18Dyq3g#DF2A&Nq~f^~gOxS@!c&ba
z7`yR0Gr!5~riaNUoMrEXAZo!{_A&gQ0&x~^!LMXnx;nyNO4_2sa)uvX-s$%KjH>1~
zx9+J1T|gP+*vOwgD*w+_%dN)LH~p=aZ&L1-2t~y=irf>d6OU2XW4q_AhSekRpcG0n
zQxN$RnwN0@v}wjfV3^mldu@N7fEi7`cem`8IXOLI7Y%waLu3Oj-1)k}I;~tfcTe6Y
zmVeV_CY#dIt>o5Jc#N<w$eufC2BHw4%X7~owrc&1-0a=w?OY{iX<Ww5(BFMRCJ@mY
z04MPFRqkkfw|Yb^tblB5XE<kfmL~2q*v)tak}<yL`nAlh-Yhqooj@roE(WE;U%T<t
zZOP~*Bl*5=b#jXf+DR8v+SqS)Cr|`f|Dc!cj<^|^TY`YMk6Ci(s3WI<VdJS|0>5@^
zLbALAvOG=_$*j%Ap3mivGm^uH4^IeAvMN-4bAIfaiW0HPb3NnM4kgp2iEz-&S2nFU
zX}jJbGi3+<)e5^&CbKis{hIEL&2|m37s~SXQZ)aMt8<TM@{jxfHm5mnM$YGBIiJtw
zkW++?RB}oVCFYb7wjt+Z5+a8bk{qI<=D0b9oGL1ZZO$q-hYVxCeee6P-~Ipo`aG^(
z*XR9wzYapBNL6Fpu~&JL?&I9p$Cas0IE}=Zy9piZx4iPsHc?q5t8vhhlB*LB+T@`W
zA&ltn7E=l*BO^N%dgZ%T$$_rAnj$n-oktq;JvGZs#;i+1l<N*u<|tNH#zgJA>>WTj
z6=MAG<EkxM196&iQCr?vOQPHC6A4CGQzG%Vy~_Wv(&~h?AO3nlu7{lDC%Xy0!9*QP
zOQXP{H@6r%2ZfEMXoZ;~_F3pBfgFEEPixV+eK9IY*u;6gVPCuA(o>N>e7QpLcNEOG
zicr<S->T+rQN3R&!B406Q(ZICs5uEv20UzcNLVP<mEYbSBK%%af@r2#BYW<vffkDs
zWJTzGK~`ZLkAbw|0^zl!Xgz@IG;lTheiE?X(<l{6G03!dsYe}r7CIXgs>ZAuvG$xK
zY1=vKJ$g5(;_R&Hhp8UJUK>`9s=V$ql*=mI{yoN4vke8ngIjhn$Xwb}Uu^j>x7whD
zS6gbSt;(bW;~Mhc;ZelwyxRJ0ZtdLccm3~fFnd5$m&~2kGw=46kS$XX$^ZD&Lm`GK
zygU(3xJvlg<nBm8EZL%e15cgKoOs3!)@8(B$HxvStvNnS8K3m%E-F1~*X%Y&b%_X;
zo}l16=MSQ>Mj7^75;^t(XVmy|rMS6MrM=b`5~8xf(by$Dpl5z2fVo&(9k%3;Hr5gy
zE*9^<3k0{R6)s9KYvnvlRw#V>4r>c5gu)feE}T*GaQA{Lv0P-FA~MoNru&?8V2q_L
zLU6x)^HxUjuEr)0OE&zfWOOyF<7jbi+8TG?e`SQtNc+Usy1k(k;6!DnxyXg)3H;gL
z`PaMPU?j6dE&Ml7vFe}KkFi`9ki_!4lbbF}L{&6S!}68N?VY{REFKZJK$H8-&fR`q
zPGmvu!GwD2KDvB`_5h939mR81(}E1!L~nYwV$8}kwYr~RKZ5dT#-Pdr1L)C_B>Cp=
z>^cJ6;yRc46?Ez|k|I%+31r%h;(;fPaQ`Lw5)zZuvl8B(F#xb>EXI}39!lqCe$gEz
zCT~*a!4gk^+PL$j#-}{QKk59WN<1VGXc|#zzh5u@<rHp?VK~qq+^q$(*|m;p@803c
z^+o~C2LBC)pWKc$9S~k+xt+yoWYxc*fee7$mp7AMncMN+y3Cclg3BGzl$|D%+=1~O
z($s$+>i=Ai!GoNxl*BADT2*Z<!NuH)nOwTv{toWnn_wYz)7fMj@}?B4>+4liU{@_l
zc8^SzMb2yQGD={QVBPKC&nyzx+Rg!c)eHxuqgS1pq$WY!tF*2ZDMEpo-9e5BSU=@x
zCfiZOAeJdIx)+cI;_ghWz&Q%T@co?GO%hDhnKpTRQU%*PlsElI>K1F)mKl}#+<FQ<
zstmBe6%GP{|FLCot9|ACy$h~$#nNmD&nP?MS)4i3`aI2=l6jsI#=Qz`E()O=5l=vk
z%w?dM(Nk2}-)!HNTub0Ra40U+2a)#?cmmh)N^j$wGjV6%1HL=AmojzH{VBvo*u9vg
zS(|!f!_K~-aoHq+^2+W+jRF*rl*FxXm?tR@Pbij9_-KlBaz;t~K@;o7O?5I*8F!*i
z_67)hd^|orq0jIKYocr<oL2k(*;Vlo4mfF#Ggv?L>WD)I1rYLwI)S{Wvn4kALKvg#
zAz!@NLzRfC4oQzLf)BBQ{i*)sAF~kWo-1N|!8#D{cg6Xfzpv#9*G9EbB1b<(z^L8T
z<uKCG>(r86^EeTuug*#9+d*bkC@yy`otu&Vyu#U@lVZ;(ai~rYCrB|l1(B%Kq-!4T
zEn(IVB3Z?THgsX=YE14nfYFndfSNgP`W$Avwc-iAM@`h3;<R6FWq+JOqIu;pkKF|4
z2)unSA}LN#SP1fBM7w*{5hC5#LA(pT^ly?F)KS`T$R3?5@+&*mTKyxjD2Xhwjmmkt
zJPFUG?L9THY%R%Svx!4x6gA(ouf%-6GD60Q=ovg0BuW3fwo80>4b_ErJwSCBs~m=h
z#%gm^={>~=MqYWC5~@Cc3|4X}cng(a>N7}H1+IJ)okk@Ho$q8C)=QH7$l4&|psSHq
zVL#EMRvnc?U5$jyYCbtp2LU-pMSsKJahGQ#ivHX_mva}ye4bGXxZpNyeEp2$^%Y9o
zCClpT)o00QtfzR>kK~cJCLc1E-X}l$Dl2ja*;%48j1gQ#_x)))OYN-AHO-B9BIh{}
z_Vq{dZlT#_-KrBAlRAd_T<lN`-rYB?#LQNh(XAI31C;&!7|3bPppk4{v1IeG^J$Rh
z{MxIF(*q5kuu^9>uE;!Q;c%Ibq~c{jW-lWDM*38uFWkMOIevvx>C8_xXE*VQh`;aq
z8m4d7txxE^;rGZ0pU@Klxu`X{>E1PZ;a)2*@%3Wy#NScy%4x8Yu!#Z0aVOyvH%o01
zvyzH|mjfVNmdj$?PD`P}u9=nNC)5365?V?U5C`h6AJ0{K%fa4%flsLvQ(^t8Nva}t
zz@`-V`l>mJ6#TMo^n10zQmQ~@zsmmaD-Cx!n(Epw*S*tF;OAVr4X@t)Ucl2}Kl`og
ziJgGwl~s|s{==04uCO;x+!im|je_e;La<uT9qNe~H=Hr~S-t8N>u>MsfDvB}PTp23
zMb0>UW4k$F)}{KszU!)zEVsMB_4iy&S>wU#TDq9NHgo=@)7TAADF6UrwJ7oW|Bw}+
zXa`aJ`cAxh?E}>|uY8l67Fk<YR)?vdEN1wO-Zx27LaUP>5wR0&G!Mwz-S!Y_r-Rf0
zb9@mEYs@M0MhRAqkYzMMzB(hEg%Q<$Y>Uc%nH21bwWE2~y>>?zoHVQk=+dDnVV_Oc
zy?txb7`ud8i<fgo6h4VeqUdTbEs<dSAw?xbvRA)$OjK-?i(LZU+(^Z)=JeQ`FiIC;
zrWN+og*9%mc`z+R9nA0*Dk)6$Cvc8&Af(a`;V_0BiH9Tv2H_OyHLWp#6Q^L|<SPf!
zc3GL~s#1%pG{dOropObPmr|K|Mx@m$rbh+}9w0+bRnoCEaj_;a{0#+`+8|nhf{c5a
zK~_|>MFUd3ns%<DT$6+XJv?NB8HriK2Au|wb*}`V#A0Z{pWk%oqhz+H!Cb6N-SAFz
zT-JqW)t$0qCb3E$V5UV%b!C#W2L+_vCo%7FKh`>4<}Z%#`1{)mI+Vn{Xk&nZ%^Ke^
zh?GO6LIb=sD-m8#<HCI3HfCqN?bMmZnQFc{O^1FvSQ67aqJ-nb6MkygE8>GU7gaPR
zo=61?OB1<L?BtWU0RaQNFGZhsCi)4^2t{M1NQ~w)p0U)cd9rTcYj%ywujDHabN2Hq
zG(7kEb}rweaLdW>(V~=m46bEb9sz?MOzw+EqC!nhP<Vev%(^0b+q@0faKb^oj}aKF
z*^6dcl*U-_ya@}_wwdWlTD!D4-Cx{fWPa<SK3*kb5xl+Y=cspzWiy1QhkX$%;}y|E
zK%CmI-D}OdcfzM3=f@QCyX3J7ID*X?8<iX$<gZ|qWCUR8{-8*eerW+bnZ)nx&2}>}
zOFD1CN$kqe2S&O-PXcDl&sDd1c=Fs7iEtEPRQo>R8aOwNJ+~XIMCY<#$1t?YtO1Y=
z9;yFjO4llXmk1BmDS5~mNU;mQ_;o_YoWAEglp1~*uOI`~3OyE4_%d`|oY~rIIAgeD
zn#Da~T=F>$LVc6NB?hGeTe^mcsnQy%j3BfGJH30y%-n!S=2|AaY>ezM4aXmwc_n3&
z-W<JrsKSJ(1x$I;%M;I%M^wk&A!=Eps5wZ~Lg{blVGonJ?Q(*<j2HGjKzgQ&NeUS+
zsopRQ8Ur(2aIt_4T6_c*{NcB2Qqbn5)^-WS8^_^6T)L<%!TfV?5zk!nSBb{Gi#M<m
zX6~W3?0(8nhQ*2>*B(OiA23dhu<F#lFw#7p6ma_iyJ?e27NeNA$#mle*?G?~M|C+T
zTjK7Bf)*k$ooFaP;PGHKGLIVsYR|Fx4=?J&t`xoYawB2EUBK@k{qiaJ2E1twlLDVT
zPvvd*>^;Cn4C4d1yi8a`F1s`)qxVJ9NSb1{ilQ+Lsq)kgw&~~^#VseFN88%#Bay9N
z1BH*3R=8#mM{wL_8}B?vJYl~6;vko!-Ry2+l`gfMISZKQ%^A_LUG>a$+ycxJugILE
zbwPCe6Ua|&fZ4BS=P6ON^6acvp^=RNE4B^UAS=*&ok^_5KuRR@V1e-f6jlfljYZBE
zNFM_$<OeoVJf)~>)12&0Z}MPaV+4-bt1yiv1!M$9_S6*K+3G}gT7dBI!>fx3HPf8X
zCMDidr%hQ{Dg}y6LzaPc;5|j@yoAYK6Nzv<rRi+I1%-QgXE{iB!9rR{pYx|!K`b7M
zA}`EoW?f9!H^xQN9LPZoPpVVm_f)IqMz$05-`F2VR3$tWYw<2GL9*Vq7a4ep4cw(7
zD8RtRKBFt&ExBY18(5rzK<cq4k|Hyqg|iWscPzpY$%+tX?m?F^w?`3YyG&#IlSbn?
z+LqJZWbS@?I#0C(-W%j9obbAE+RF?fb4owy(*UvUJZ>_C>n`;UO@xFD53R{hzDNJ_
zAN|?pl`&Bs%lcl9-PU<LEui65ZU-SUJ*h(ak&|4JYtQ;+gyv<ar4!hZfk2~U4+`rz
zhggjS<ntrFhmMbcyf0#3eN+>_sM{-+=6#@YRYX~9y#wQ%MzzFaOSYCSDX1xe+YR<_
z)mrt+DAB0qSNmy&mL|5bbJcB$2>A!v6Jrqdy4k@_DOVxMPBY^pqSBg_XX}Sy?CUXV
zt~1+hZKY<Xj-^GNBBSTw!)Lm`Z%AIbGX};y==>WJaEw}^##uL<@%dF2f^iDA;@Z{B
zJx$S$O_y#Ln-<gU(LwHvpW&BB*o)^!h6UL<WGoJk_FfbEIXEv@&OZAzUM_d0DJ=@s
zvX|;wZ<h*Ndg4$+*@|^musBs1KmU}}X3<r*gm;`Z^@pG_4(Sz~{XyR@evg|P^t@HI
z<L99jMiI(cROoM`v<xtR0gOAO?1bi#&HFHc!I?pUDtbCksN@=QBMB7kaTzo7PJ?q+
zeRu^AiYehd0hfq1pDg}3Cb5gC#HmT;9mcvUxE#k#W@Sp^u6v}XKQRucKjGV`>8|R#
zE9%%oS8#4>dlT?*Hi9p*Fl}&%*Uy&g(p*$tZr%`m(p}bE>0DpE0rw$?^?3zD&ABX+
zjB%24!FK4SmIpHo?ZV!-Ws?5|W&YJ$Ml@CK{Zh>hlkb<p1?=-qQ~8mKy<!fRFKW6M
zwP(39Q;(IW1P`VI4O`5v$m4kvLV$GH34==riQOVN5l%IhjtMXp=UeKZ60+XdA5Bm|
zcl}7kUiozYFQZ(E4@UTH)(m(nR2^`-?5fLw$ku-rPKtz-qfUO5twdwEAw4a{x4Ei1
zV7&-cjbJdGq8xCV-jeByUQ+Y_WJ&mvnqQncQ&mtn2e|dproFk<RH*)J&4Uv;Xm|Pe
zpKKoDDTOJD$^EDD+Bd?>sYURmQE_cepX)>GnH(nSRn;-QW`7I39@$7*$?o+Yg*BVI
z6qc!f#{Yq33=jXtH&Kg)A4}=5h)LUg`Vg~39ypC~&Q@IGHofUSEAKtgYE8njm!#0m
z!;8bDblyg}lQ@ir1`zlnbl3iL2Xa39TDty|X9#;KbK!A!!Q^{n<G`%g@rEdBk<q#~
zqcx3~DN>$dsG_6tfOdX~kkB~#s^`9Z&QP^I#|yal_Q%)vDZ-lGIZ2017pkUWvX)W~
z$I`dN9M=lvIj)Qg8@5)pQZ#xU#6u}iy1*ky+Peb3AFr8L+nFx-lTU~0=uv8$yKy@I
zyi;dA8`E+DxO6{q_XUU7;Hy$aZjKt~?Fq?K#8wjzrce^)!*oi%$!w8^W`jd62Lc@y
z8rqXcyY(5EGHgC>=<qEk2~nIFK+`9T)Jt%*M4~b_Ze3!GMDc1?e4M`hrw&4!&|T#V
zlWhH1*m(6G*V%`2kHYTx=(Tk9-OcBp^g2BIy+WQGl`w^cA(H(TzJBXkO5Hg_V~^xr
zJ6Ir^m=zL!(&+f}(4*q?D+}2#MIo}0`WF(3)?Bxr-VJR0&&Vy6xAHDj6Ap&MV`aIA
zho6RRo`}>aeV1hDX}}7qw2>LLfo{j?$Yg^Z!tZ@oP`N<0MofRQ+6p0wPq!|w>=MP8
z#&-_~PKxRgA3qvR&BTjxRS?!pJY>_Jpr)A-lM^XHc0mlb_Tv}-wi{UF)i^f@<D3uO
zyzxD_FP2(968e2bx}(2YKKWUWsMt%qOAZH$;oa-4bZ7V+R8@pH|EpmW$lZnNb@a)o
zTZW5=dgzIWAX83PfF30M4KYo32GxK=6Zt9Zw!t5J65G=Wug%kW7fDRr%X%6-_h7J8
zJdCT)zrwOv5JoMtvB|ehvg*wUXLxIpd~bng^jbb}4-%Pfc41u8lV;@0RS=e!f1J4Y
zn5C3Xs}RG%8YI^4)N+_Q?~DF;xTueg!inw{v!_e?seJ|`&4E&Lpl%F~a{^lzbn3AJ
zdY^#(W`(tnB=uk>%Jm>Lwdhbho1AVPpNSM`b1HCl1;HF3=6{4>FRpfah+21(WWo;)
zv9t1KlnKzf&rv5d!5{tbInz}MLox=9z(9XW{%QV*!g%Jh7r`6w5{kX<63N+eu*w+(
z<md15V=bZ)0i}Cy%jd#G+M*X16h^wexr~S5#-munJ^mt9i}Ug(WF(BV#DFoU8kBov
zhn6{b5LkfXQSwswZY-zRW%gs>ceoewjtDmbz`H#)=;2?o<K9NbP@vj&f?qL=1Uc~j
zYSt`Y?C-9cqy;*S`N87RLa(Th!p;eoUtLNc4P5q6!@FDmE4=4rBALfSnOh~FhnEcb
z{1@duvxd+`o0}Pfi^OsRxmE9rQfKBQe@YVISN|(2BPX)iT#{375Eq|~Mb1mbc8a7h
zDssSU=I%^fYBO>NFW<A-b^1Q4^|kZ&cBXW|PZZqSv1e(rXBR$t5*W2)JO6;}Ghzn8
zI5>Q`Z;cz!-vibIOVakpeH8jAA&&s>rf#t}bzxvk3i0eCk;`p*53D-NczAJa$S;h1
zFz`@H)wcw}=MEHn)&PAXQ^#x^a1g7Db61qo=4q_JMGu-?Kf`QRKl`ZP1-&59s|O6F
zIxZyooKI5ICq8Xkz-?JX5}@!2dj5BLqCWG5Y1nEEGwm4nXX|hgE9Zqc3o0W^#DNb@
zmAiAuCl}^ZZYgb<hft7$(W<?-sK-*Uj_&A#`{liU{Dnyd60!#f!nwW9JM9chpu6uW
zGY)yF?Br1%r8V<!q!)N(nx;C#@fk(}Y4Fj}^yzXcQ+o`27Sn`;?;H_Yn7OfwiwI{I
z48PaJW-Nqi+jkpq-hEcn9mKmUxxy$fv;23!?8ws0Cct%Sr`L}aKW<3Y2$i(b+<dWN
zn+PPQ=+4j1p><@faKSVfvhIqR%-~-0a>dUBZ@j7?BN0p+M}8cK`)3f!D5o4n>m0v3
z0muZQM5%>*TcSa9iu|H?#pO;j#oX~wUA9%!Q3;lp-k@HgAxDej;AVY{;54M!@U=XW
z0I=WEoBxC&Ylb0~oVs$JuCn%`<$}>iH$RvTDxUNz<-y1jCpk1vuA7Je;a-J-kklUd
zsBua3ZZR{CW+zRkrWvwyg13*yN^*ltx)aX!+&uS7EJ8#3_N9*-9}cj3&DilpooQMW
zTC?lB>`4XN2KLxt7|0snhFV~Rp#0$7${_#zJHSn{U5tM4dJ$_<P-mi%d2LU{W66=`
zvGRr9hFRmLbP;YZRVP*CtQ($~6%=`ZJ(xac$&mg=^Tn&_kX^-JU^`U4TIppCF{{7%
zf$GBPo;VH1Q1S1DS4dR(-E3=ZF$iS)h60opmEbpjm)CDsi{zQqJ=Z9oK}F4u7T2_f
zM3HqvA<HXZy6`exDr3a&#T4=k1r|=Zf5&e$qEK&LX>KfI(77h~RsJm+zlDBHi8VU+
z_InZL^UhjVNYw8(=bq}G=aM@3WZk8Hg%YnbtQq)27*N%>6KCvr7boE|+&6i0d4l@z
zXs<+wK7iPK@hDojifc`O>MgfE9V({(qO9~9`{G9CXI_9-thC73SQnj65A(CU)=*&1
zknnJvKF52rLYZe^K+}}#M!=HLw?nQoT&8Q1F_9avfOikqB<|dT1WL5|o$`JVmrSip
zAW~66A-x+xmzZV(yeuA`T3)!)%IaNkK(wZdhVM_@1DqPwS+2G=NEc(`B6Dq2iJ0wr
zUcLXz{7RNktm>hsO*D(A6yQC&!mKda+xkkJdL8+FeQjqw8BnV}2%>Ebg3z5Acj}II
z`q9*1uAPnX2Fd&^4Al-0dBx>|^&X4RpSgD}QSaJ2x`K~O-UrVwZ~yuiGBfuMs~3Fl
zS6A?={O6_MkRM&)d0hpce__K6@4fj{npN^X`$m38+sv=7TZKb<dV25MMgML6!g7~(
zy!rILWHOU|rgSAjBP>|?8{<R(N-ve%^uGG0=1QVk({Z+4)jC(MMxhalzkb94QO3Ar
zb6~vTx45e(O07!Aai9z`M-z`lfe=||MNXk8S^D$Q&gY853ocizC7+(DGQNj1QZ63#
zVc+F0udAz@RegTg^1R}MQEi1%#ThQ-_9BHu99*HclX=|D+zq#vaVctS1F7Kzl9;C;
z4@wQLujZKp&ruv9;tGM3Fya^nw{p;FGB!{?R#K>s%P1lamt+*G1&bMw#gMdk6dRjb
zY$=YkVn{=VuOOBdcUHs<(FbASB(YLtsbLBLK^!O^E((hkYi}<dfA+{`McIV$NEqK=
z^JNZmevusW{qWg5Gyg+*C4Qv}K3w_h9{@d>r@m~1TIbO6B5?p=AWvv%Oj!d)O7#6-
zLPX%jAY{;7oA9CPg_q8In*J1sV8=#}{1-H@e$~64U&`gyW1rX39n5E=?p^o!`rr(Q
z?n7{DH5VF#EOvgWa_KU9C^v<_!ouGLH2>t4{39k_8xb!f(SvadfFs)JN90OqdPD%A
zI=dhZu+C;G<K6w7d17I+(4Zgds<vKTVBFLo=Wu`hX6L><#^8EPSy<E<57G%4Ub}ij
z*~vXjX<EAX_JxeFw0&3*M?N$v+KJNkYMF(8qm$;LR7#G@5r1H^L02zhc}JPevfpQ&
zv|N?Fj&_Kg?qyH7bbkdBJCNsL9Ag-_Y{U2%6!;EI9^6MXH@~_DW@eV+@0OFk_`S_T
zs@3NE^vh?L&tU`%008b;ixTwzg>0cDzG@HkZVOSM!Ib$O$&9Q*xe)g)_o2rpYF5zq
z9Sl~QLy7Umez-goJ5Bx6Wc*|Un{nYpeb54|7q0(JE2vR$VlnY*mCU=a9>aYQT(Czy
zi}sX<r`hmCc8DthBwFr?oGw<M6}{LQe;$m8L_wWKK9@?oo)=EPy?9tj=ytOkmqhnx
zq)<O5_c5{?aV{x^=a_8uGZP9kdav4x8H7aHQZw%>F^|oPg{}zc^>_h76a|U0&Nl;w
zs7jRS*;q@HTOa!7Eq?N7`_ta$p0l7q`x&`_e|M}hTf!MHeQ>nSdk2QROJ11Rad+Sb
zO<-I3{F~H7NKK>#nEa)7ad_&gmoMqaoAZ>5R>4a*9)d6m+LWN@Zy;500~kk%o%E`@
zowOk#BneyOo0JY1+oCW+PZVF4CVUHL4{l30{;qqtG8{^<3<YUwGG)DOv}TC8%!JR1
zmTL)pGlySZ54(vOb7n3Co6O#qxZXRwmD+IXp8hz$=_@s6Sl<koS#^TG87gto4FI1b
zl;vvdAY%?q<S}Xl({>)#c^(~pg@dUFgsM_I9LL%Fqe|3GUt4CNH%8P=Voz}3kb0D}
zm1z;5q*BBXL$%qu7mYk+BQ_Xuvjk2a+yks1M76{!YL-9-M}!^%aIu`Uc^xg}mL7<$
z+mLQ<1@i2+c!dVQ_VLs>CaJ*_f}~qod(()!BjZl9w>vNiPgt`azC)oDC8P)$^Q!xr
z=rq8J@Y+U~bM5-s5)#19pnYg%B_oxd0o>?u>&dIz7tPpthg0h<OzJsE`oW0q*+J~v
z(t+g2KCA21J;45yL|UhY7Nd?H8@Xfx=4WS%OeWEI^4v5cd*naop+CfZZu;$YyPslU
z?wZBK0PggoEn&7Y^+(~EN<-HO&-FM3;i61$IGl_N2FQ4~0`E)p0N{jj@EitnHwlrF
z;KV!z?5J9S@b$&^19N^eG~UJ_ZmFc0Q}(Il5Lk*>8Tg+;DsNHBHi;1?O_9{c%&#({
z0I&162FY1^Kq)_?YZaX&WmqFk7}@&Y&RR4;O67bmyI7H2E0oUme3zX=Gw2o40_3Rc
z$0gKk44;+l5vIF4>9GN9vhU-t(y1hqs}PE$q_hm*u(RX{G%i;8yHu$>;bIdr_Wtl`
z=lC>17}DHoI1EtpQkI@ZqhVn**VUy>Fq00}nFm*~@xom}w^xdTc3&)!%&lVT$cF0m
zf8Y!hCdlYA*p#@4n3su4+3?EpiBKA)j3TLHmSMHH{;<!|o#a<9n8R(S+$PXgAM`8C
zQf}l)dvnjOdH2b|La0#bS?33Hlxt_DQ$6eS?hZ6iSrlX!YaYv1>^$R8@BVf-=~JJk
zAZ*wv$qezIEQ#mt-{FHrmMjDa{d!(B<H+Cr)UVPNv@Nq>A%b*<;-Ovw{#0nUz(i}1
zakm{<e_Y5IYhJO$f|M}sUxlc|K>>qCo++iJ%VYOUyPwrQ7#r85HnKlEx+24rAe!ot
ziTAu8G=vZ~7&Pzx!L6PZl?I~PmOscV2DbYD7k}-UwsoQ3@opM1jlBUXQi(9&r=Amv
zpiaC&_3EA8Cbgs%64zQjZh_Ax(dp#8<&GG2Xl&b1q5G9=KZOfESPQJQFV?9f91Y0g
zdK^JE`{eE{^x0~B=S&i-{J+AAOQdic0IBwD06)7(Q+sIhbLxoo&XjuZ$h)^gsrtt3
zp_0NWglChCpgEtO!x5wx9Vh;Bj(ow~>Z9h-{q4T}hMPur(~DEL{m(njK6m1*EqE(x
z^MucI7?1vsLUzdZnZNngXOooNcJ>~ZP^9xErzMV9$4KoZo2lcO=eKox#EGJ7Kc7qG
zsLxX!a7dDoh)p79I{dLHP|e+5no7q%F$WW*<V^GV9PbJ}kt=c{%&0HD1*A15ZVm1A
zBC;^aMsl3I7W*{a1j$pBoar5tTtziMf3MjYhi*-~w`$6@khh}t=U(&$Qu*7Pm&e+O
zI17fn$Vfgo6j+G0k)_Jl{l4uLECXh9EQ)ybo{KL)Np6B>o-ri$<c=y0W_g_!_^r&w
ztONqCk@MkT+n+U@*dMZa@&OkRS!!-2!QTN$@bBI~Aag!r*ebl`v&)C79`P$Vn7`~p
z-gn@G?C_q+=S-j1C|UKwo@Y+-(>`4!?%v#l5a)2boB6|1&1w8ApK}g}$xZW+uUgk$
z%}ce8`{|}`q6WzCcy8-wPkCNja90(UxR$|YayMVJsId&z%Oas1&My{Ix5S`7yI<O;
z%kxV_EG`$tO;^WUNoA(;20P}a<Zt`#Ja~Q_=Kb;q?ZXH1w4Up@aE%ySLXhnO_m>Z5
zvUui7g%EwZe1ljG=uOd;c+XKL+<$X29*G`(`<uEq8mg_yJ*8`(C9Vz15okX<;)v%v
zP;pm(<``d+llF}|H|*i$l>Iti{N*3fw&OT4lq*F(i-Sj6H06L%4XdrQ*gE^9O`*;)
zz_<BRf07MZY1_LTEvfK^=3a8yC2bUb5<{g9)rstl4i}7hW^*mO0`Qa@JmMLtSKVcg
ziZt{;D|VsbbG*NmZF}3RhRVy61JnJ+JWbR_7_8_)lEKRJj<A`<l~HdF63Ok-St|*N
z^yTFZm3aGZfb1K|SyZO7?dHht@TepRNNun$T3*g6>mp(AJn?;flx&3Reu?i@FnkSb
ze=VT~F=azITKljwthGnePo1AW^IgeBzW6Yz(W5j*R1TfG!;6@`;j`WUta3Z*TUNNu
zQ|Y~4%@_R@F5aW(e?Na$cn*f5v%CG;?@`c`lC>4r4Rw<ZRKed8lk>m!Kd7gy77DZB
zHAkAaihub;{+jm$+D8!$%xpD}m$v%T$_UvqM#@C%Fnf$q7HFv^C<7?sm^VMQ?$7sT
zv5sj_O@3j*uTv?jn&Dyvg&61bmv8QIaT$LS>em2skZL)M2EO!VKuaJu_!~3vu-@Qn
zT@eT~$;5Pg?Aw^>XxxQ7gSOI`y1=iweQYWSJ`;}EXW<UR;3D{^0PhCs;WFOk5}lFl
zj)Dp>V2~@~CxDkWvwvym1qW6!i(SMv?5n9D%>C;hA!;cMrWWX<$wJOZMBzzlP+FnJ
zE$XI$hL=z%bYRjtZErX)9mFV-KbQAY!VAa#l>1p&092ahoD|H_kLg?GWKSFW4GByD
ztg=yrF6rw1`W5mY&yr=38B|P1cmQIqo?_7Nmz-Eg<Cs+xE7kID+Uu@`_yjg_h|ayv
z=}#IvSIEXFf9Ro%pFJ=9%`u)7zHMWhvh^e-;eMejBcW?hwv)Y;hzIqcE$MfNr-2;o
z-YEv1i0)iXmkQUVuYoT~u`r!4x>^%wMeFU{6%FevnGq65Yi5v)B7PY!0!8e4Dhl9~
zX&P9#v5+%;<=!5RKB~c_SdvsDB>NDtaXB6%E2$<hYJMvLWWl>>!V1_>Xi^D1wAbCh
zFn?2CPQGnOdoP;B<2;n(N|Qz-mfYTq_=ZI#Gg-WlQ3xtSd|G)Edv>-hkj?uf1b{kW
zqIV_fnU@Ur2214a?Sefk%))pHTw}9IDBOr@>>>@7ujpQsTUd6L$&`OoE$B0$phD3W
zTYYX)58VU2o6^q8^@^wlC`_p^VWi@?iE`(zvn>cFUv>5H*kv=wNn0p+Bx%v6!z;#P
z#+MNHi|QZ$>ez*Qe~o+5qFZS1*t52CO|NQ*4A!cJul$)SULl1f(8%VeUOYx3>~$al
zG=#v|$FnSw)8fQ7DcOqwvP>5hX#rwvUI0${#6)t>ymrzuZ#HkDb{~-+z#MjNJn10L
z1j;*<T#`d-pGkfqm;j)wb4gz*fiMIuSo@ZP>p}KdW{!^d&`m(-W-00q%8(AB^pCBO
zx0yWn`V)#|sC+LsE$70KXK~)hb6^Q*{>=|yF=Mu(1*XY$NydH3?)x~tl9qdbJdY_6
z;<!m6kHh=EXsU&9)wuP92u5wvxm@-91l43b_|WqIswI!-*{Dnz5o7yOhJtK6ohZ^l
zY=o2m!3Bl4^jO|}blEdu0z%>+`(2VVOpD3_c0<mR`FI4ljLHIRF^P{Da>SJxcorAH
zH6y7=|B{(V<7jF8YAob)-Wdg|(p%|9QK75LVPw1~Qz0~oegY1^zR;=MEf>>77XjoQ
z{$u6xiK&l`86%gnZ(t2#JtTT;waH6-?>mOPuJ6%m2g*8SbJojl^@*}|23Ypw+I;m*
z*QP_WA6dxuf33F=)yI{<F&X(Ox7$!jYyQLc?0ldE{xY!>w-tR^<`c8J0~IbAuT9Yz
za`}>6V1F-;_8yRk=<Lc^^ad&fd`|#pN6!Zv|0%^rxOl)<3ZW+g-Ezkfy9KY|187V*
zuPx~ySzb%yE;WPM_)JP`nmFa-P4b1sWa<xYl`6wqi`d6mLb{MhH;v2Z=n)4kRN-hj
z8TMV@6SKCwya;#SmP>AHqb8dc+w)zdwbfVI)8H95OS#k4B#k504MR!1lXd;>U46ly
zV7FTsjMs$)>p}AcqKZBttNNwmnAF<5O8LHycd@7(RU}#m^x-lK8%aedDM)0i$~kcH
zMm)T~I7nE}<{Dkl<(g6HixeNanxQJA@!b*<z12r)?lWw575semMT<-Lyn4+juSC*l
zM51u8<WrF;7taCY;nkeX61!qXhr9Fj_IhrSMa#iXfG<^AWGX*$_CG$rat5Q!U$-r1
zq~1$^nY0s?9O-d){d(=|UBPeLIL_le|7UxC!o(5KYsCAC!=s(f9Mt5(!^+@OtIvSe
z76CV`Km01=XR$E95`67g_3&upJ-Qp9RQ30s`KgHl;4=cybxK72&_i$neG7Sm@#|d{
z;1#+^ZSU(F|5B8Gee#!XZ}D3pc10;ix7-Sz%WCjc_x=>TuljjOFC_R^M@#UD&8Dl$
zo=H~8zs-=~aAcg=m-z6Kmt*@pA-pvuFDFJ;A|gu1IC~9oRpm7$CFM0$RXyu#YwPRe
zQW|Ye>{yJp3O6n(f5CIBq`azlY+`h3Y^o*v)`RHgrl7E2tP>yZ_v7x5mY9d}ocD)G
zPx}0KAfN*C<$BA+(x0=5@4p2XNU;zuXn!l{%DB^|+>7q5>jDV=`ciMzNz?3X{BB__
zz~UCG`K3;?6`=XK3RP0jGThD}Iv<8Zez<sA(;ZIqzLj|wR0yz5o0zMAIHSrL`sMXD
z*BdTPKr5);N~6Dmi^)i}^T;wI<aynjR;9Y1045Wh=$+@|90~Oy?`a!#=vq~dy2^L&
zT9<-E_5aL<CI9Og3Y$Gv)L30#SzlQrTZ~SPtQi3(#wH_nOK~L?>*A(BBI7uUzW^c_
z-o*jCwFs(r7vkQm9{NEJRk4lE1_1EpSd>)!pV6KY4?_(66xaSn?etm9e3$y8OwBE2
zBj#E$0ZkW7aul8TruCZIHYI;vV$y-yMty!CaUz%ZkX|^c5dFXcW}d5PMzAGOZJQPP
z6EF2&KZS(%I44M=dv;rv{CdYjE^YLO|DXslUSuk2k`Oo#8|Q;shJIbc@<hhJteItn
zEsxe4A~w|<cXe{Yrn)Nw3z5yzb#AbjI!QG{It)*9262m>LP9t76_SGVQ?<F-Y|g6N
zJahvPk56Q|CN-GPW;yO$jk5|8lN|1&JUKIX$z$P()+^x<O6WKMalj5Ki2Z=-Bbt5e
z94^nue7mb69g4jYjU0kK3rVfEJdeAXfP;)<rRR$HOo3V<eS81l{U8vNx?m5yu{Z$A
z)>x_cvQiR%E4m26LVOWE;u5?+niW)msYE*D`Y>Ymc3rH1EoN{vlWei`4xd&}WVk{f
z?uL-!Ar#ipMe|f5kk4(-J*sC{<}?-awMl}^npN|81VQ6;X7~H}EtKE;#a9p2MsVnp
zhYt%xAIX<}0mCy26k>690ZD?Z`6LA*kK~0B@~o*hEODOZZW>eoY2(F6EH+)lI|3L8
zV8(<u={*>Ry*9(yJVWBNX}3UO^<OTk9}=o664XpIs*hdGjLQ<G61Y?4xal#&j(J+E
zN6Rx@M$0=V5WOTLUc+dkj@2Gj`%2~FR{xYrd#{9nK3uA|KmsQ=hexeaHr&0Oy`%ph
zoM?tdYsl>$*3}zBn15C1eAyru8ci40OR|CJ;sk3d&s!0+3S<V-RE$~I(OqD_Ex}z;
zDiLdV$h3cvzl*{b9{nyHG1@~iq(kLo^HUiPyPyS03sxnCc=Yk>4%M+<o85RtRFa!S
z{z0sU1v?0|s*mXa!SKI%dNj;K2zFzKE4^lVQaTARn#~0$8C+@A-J{n%9e&g+A@oSj
z7NW@DNhSoe76@$7^H*g2^;|3pT#Vmj#XZhXY1*}c7oHPJfPtp<lio1osI~++0t{FA
z=cVJ)Q;gM`J>>K?B4Pb}F)9%Pa2R{bQD@4TTjE6aW@a*tsZ$E8lfhID)t4h+rMpMw
z!9+neZ6YU&YVRV|2Y5R`DmHau<BJuaj}=)Aa;nYN1q`<Qa*Z-!X~Jb;{I%nh42iK#
zT5mE#Z+}Wrqc9c`-nqa3&=t#*P9!p@fY&!ykFK4#L^t!xGOmGiI!~59G?ixF`9Sht
z*YGjnt%&vWZ-26>d<s164onRf=XD>yT}d{(ZWQ#c0g}`vW=MpAc9o?+-aS?C&aXGZ
zDdw6qd+#?N8O7UOe8Lb~7isTu@s1J-y?o0QdC&e?Wa-YENIPceWy~)DEQ=p$S$re2
z9VJhp9(pv6JApODigGfusWkA8y0K;t@{sx7xFmIY;-sm3!{WUbN4b@Isp5m2&9a9i
z6tCw8umnMWS+@d&of2?iun3qjZOsSY%;*+p>W)Y!8aHry*BaieGh1H&WkZso73CzY
zfSFA&;V!H>8s>737I)ljJ`&8g)zRt5Fd&q3hQ5xukv_n@$c}i%JXZRPq+g*N;=V^+
ze_QYKAUlgEO|vM`m-<Cn2MhrA274YeDzK5KQ;f9Wj0={h2<+?kdx;g3+XfWVPiKt$
zxi~iYysqjz$mGB}>G(W6<sua=GT<%~4=?_m5{vw4#PRF_1gh$=oNb_>4^5{)k}0R6
zu(mz^B4Rf&30FTw7*v^O69B62Fx*6-raE!7>jn7fM{g63Qr9f}PoWVZj+HMld<I?;
z>$tnl|8bMEn)!vvHTm@plpb2MjFCgia>s%&Q_GUkHR}1qiZNaetT@|@m-e92-F%SV
z^0Fx>{=|Ue<8a9}^Zx`h_x}u*Nvgz3`8|p@iO{cZQ^`}eG$`+{x=|CZm&s126R!Xm
z^kEvW@kHQTVX6Qn=OCna$~4Ccq&q=v7PY+*i=MgqAntKzn-y5opglF3{T_}jspNnm
zn)xZ11y0AYO`dw(jQA4LBlOC#u}SNELA?c*c2y>cu>qb|T_CaSYH3%4Zbs8z;X%&o
z4kYeEgY$GMEPf2t0RAUEYSPFM>I4MCiMmV#jg+4rDhk#`yI@v8_w?zFRT3M}tBzF1
zyjiAZQy%&<SNScd90o3Fyl-_;*+c$!oAr=C+XYc#hvO|kA#vu(1#HXaNQ`1WpS%0q
zvoL4vB%U@#5>qy7{2rb%Twa_lSB&|MYYwCH$r3-kpecHJXE#g8$tS31H^gO&--&gY
z`Pzm5_#7V=rrx03oXYr?pu~D*F%BiX#-lPN``M6NV|{`B$yqYR&wWg6$(QnVxy*qc
zF0H1M8-#p~UNa;00l7s&s$q~=hJoQJraZq{B8H4UIv?~iS3^WIH=1_#_BBt7+(=VO
zl&WS|91(bJr%5SBffwuwyZ*gX7BA7cC@5|{G_Txt=#TV*3nXPq7pil0<7ln?BbXOK
z944-~h(Y+$P!(IfnzDr0)qWIw-~XQ|o$f}uPCwJdtc@&UT{qa`?!!ooO$yx|e9D{%
z%W=O<j13Cd3^jwmO1^YQvThAOi?yH2fgb$c6EtiKb5?9zyS2|b>||{?P4aa`za9<q
zU+k4-0Ek8w&Z6S9BKNECbCFt|1-pt0U*F29N!?>Hl)G*U_{^;^p@LI=e(lrXryKVU
ze^5QMkGgh9X4Lp-Lxzgxvg!S}biu%S3pqcb>R6lqCQm&3@`ZswhH>d4_r+Vbj^7j*
z#wa)OI(NLjW1XWK_}y-!W1Av(z=b@SE?I$_mtwK;MI&czDbmVxfZ^*GixDSHaxuJ;
z3HQF>U*qgy^>qBilx{_d1GN9+CWFpM9kzTH5{jxs*c1D7)(ykyc$}DSi>U3b7Bx*p
zodB;taR}#kvNP*q=JyL9S-g%MB66~o3gDwiOLp;lqa(v`=5Ib$jQ^|d>8zG6e9wHo
zexpx<&7=R=hoMef4k_4yS;RrtQc=3q)Svi<Pi*;*`am#>F^ZWLPlORONHLkqp5>iH
z>&k$K+uMt)T}wHFF1%?=rOkm&zcMS1<KH#TFA)cS`m@oB8^1JMWgo2|E?GXPyrfT0
z@BjU@`5ST2zj^D@T~j^=DEX#fW+W9DGiuS#=x&&Jtz)keO002fdKh*aeNB^^&io9E
zOx^Wx3l_59>JkSF8-9|Hl}%E)>E$>ETssB2w@s0HxE57~D`8lAhKl;a&oO*N5e9#+
z+U{IeJy8Z|zPwA`wJ&2Z6z(VL3j*zqhH6I_pI-Sw7f9D==YQ}QS{(x9?TaUCT#rf!
zhD@`Ic>H@(Jf#?N!PS_i_|CE3o6~qYbrh;_qk`dc;!Jh7O{Lk+xiaJxQ9VHsKVH~1
z7Pe)q7be|JvVnBisT@pLi2e*XNok`qP)dUUPt%WTd(o;a?zDxKfv}$Pejk}i$uv?V
zekmSN>bDA~7`bID=QFK7QD^F|8G5k^Puq^^5yf>#mUZ!{E>JXcl_W5X9y=o?`Cg&S
zBnjDG209=LKA|~hrqRA~8MNnpJ`O|roh4gcOWs`u)xi3hm%R+QhSL{UQBR=;VWSMo
z6y8TB`fU$<xW~ysG>zsg1bbrX-qAN?6+;vP|6BeWXJQljweEM8$g3SX!wy?HH0cI@
zcKh=a)G#s=+R8Sd>5`K+HZ-I825ZBQ`*E-O{ZsmXP9;4%MtVD=gB3~>@P(dJl`2eW
zz7DgoV1L0I`VqC`n-pL}(derm*ATFjy=}rEE~)Z8r1L_M#2#B+Z>j+CM<~_*HknPV
z2u(f&Mrm$G!F1wkR=0w6)T|{NLf8$EX2v2+bHI{z_=yo>pNl6fo-cXg0%3y7-8msd
zREKNkb+f5?<50ynpt;{4(S&VW7)fK(Pmp~MGaCyuGvM@*iFI<f(3n(H6zz5C73k>R
zW&6S&b2puwm6&+`1-k@jpnTJ(w=6E*h9&z9dn<5C>JRs)Z@>mwnnTy}T!MWqfW3k9
zlht!Vg&4Le(EAyF3GX~g3@+pE;k<@{O?_5tf|E^;q3nxM3x`Yzr&4yXn$e;1f6B)^
zxtz967|m4PGcpp!GS<j98R|<W57nus+MFg_r0$5Vf4$u3B%J<wcrZl$BCRM|3YG8)
z&BQJ3eqCA@jo?l3Ge5E)ePa*nytz_IwE=Q^Ui(8VL7UA2rs?PCMPOYK(^z;uTCQt}
zfgn)B));l-i7!Q}#V*!_$vr{}+C1@wV>YgLg$(^Ld`OuW4v|)7xrWh4H@9);?2$Kl
z{}--g)-kiqZ~{3a*p6h!g@LU5m6bZ|*<6aV5fQNjfTSskccjIKU076H{Gh$bX8YiM
zV&k#J{=WwmG@!9Z6@77)=0JHLiKpTQgLtWI`<^wl`H)2{v(e7Zic7E;nfq_XK)*zh
z;vJn8vU=#Q(EM-t@E~Ogh*yyF@_-0?IvUg<^5|l!tT(e~Xy~{F>IwSZXFW$-usc1!
z9X3APk7QE5*=rgE`0H$YNY<cW=)|3UK#qA_Jnx?n<JA*r4?H>XxF}G-l1V6j{K3i^
zL>k%CGJy1t;9q~w#_1#Z-&%}`4caZ#aU6cKQ1`1v8rgu?^G`^%dgyCOh3$uE<4Rh3
zsi`rN=NA`#>KL++{<68uqa;)=dBD~6V&SSlUy8b-0M~HhZ|;}WXan0`e~@X8n)prU
z-0PBSF76I!*Ur}qo{hYOD%|M}^AvlD1$LV&i!AZlQCy+>eN?%KtCa*1E0%CC49!Lu
zJ?<BI$|R(GmChun$h`&cjkKtUpy&&0^a%-lFYo)_`9X&ddruGgpcAzK_3q7Gl(ynj
z!MbvLMP>b>jTdqsxU}TDs&l;)#Xqc6O}VyMk#oHRrS=kEm?G?#rY1{Z>X^jN(KWzZ
zT@<W16NRr-s=w@dR3B9)CLr5JKADfEr!Kyn8Kfhv4O;R7fbZaJ-eeTgKjPFG@|JJ@
zGfxG|DZ56oHvitvD`ncQ{X9t$e&|g4Eh|<iraLv-D_k_2KaN_ML*>6rJ6SwAKz72`
zaaXxr3|6HM8Idd0EoKij9gWUFuOPQCSu+h;`k2PlBvEGhVyazlj?8)@7F8U$q|Ol&
z#{mq9fD0y#>Kd7}(goR{KARNUM{k`D5u6&UTr>z_M2-Evj`d{KPuFkN)9zs#{cOj7
zYmjW8buzM*@l=P^_Q@e@{gd`a>ZXr*-s`LvU(6~S=};b@j5PL;Z)>aLYY3w#t60D%
zgtW*P$pwazCG6HqA*G9#rdvvP7H+<Tyf{;7nUD^+E~hehPKbPkAnC%_<*f?V%{4^L
zNy!O+!K7|?xgG^vTG(^rskyM7o3G~1e;Ry2`%|EnA?$Qlq!Q;2Rmo7iW%H|WD?}tS
zj5CmpMaJ<mf9(aI!F7-ulSSmj`1#vpBIicltb?P`Lq7J2nzos6|F{iTj~7*ZeJ5}K
zt>l0Be&@;;j>&{)lEkRYiT<5uh-g99d~*Ja9m#sFi^W$kD|@m+b{jI69@$%_Dw(>9
zh1}fxdByIcfJ>!?HPhx%{llpFYuBjaHZvc*M(^s#`hBx$UEN49yxU)Y9GmEN!0pi6
zpWm8xNaIn!v3wOX@YS^vJjTT6)!V4gS$p1Y@h`CvRSdr(Ycp|4Pqb+YF!3mdbLZPi
z)&~c}kFwfNpB~s>T9BGrc*d7~J_g0qG-#;)bm4LwUaYH3Lo=d+o2pV3kQZ=!s#K?1
zrvY>O<}TpFlWwjYGXQ{V+oGiV|4@*f`)8#NkPo(3I@Nl4mfP9uohjiyD-~0=lo-De
zI9T{aS4Qn0kJk%32o8Pq9Y0kQ&&%VlfA)?sug-#J=V1obG*1W9%LCl0^{HlbcEmY~
zt<Fya@7e`wCM>?3U0d=&asu<oO51(@SX$|=1^oHeiS6f;6q+ul;8Wa?F?mjq5vY^<
zZr=it0p@RdyS*osfhjM+A;z(?gkplUU7X%aNU%7Yg(OMq2XGPP!HQ8#b{*<F2$zh#
znrAX)k17BCbn9RfrSOup#QxZ8G3zF36sPt^U2t6Udsh21Um}l=C`}VQ@S4kEYI(&`
zKZ8k8aDoTWBg|o=B1xmiB9x2nNDB5!hFydxym(8KpRv#vYJMigPm6tU9VI0t%kzGB
zFnM_Xm-EnR=GL#ac<?Lo+6M!3$yAv6Pj|D#nu4JO#nlq3zb`XS=PlVcsB~g~O|R+_
z$)Nk**5mNtnv7f|LAWv(tV?Eai*a)gKHNVjW}>-Tsn--@JAsYcaZ3#Nz($o{<7(1y
ziAcLT>CKtC%5eACJk}{#TuvzzQrPbeo!EI_@vuT33DMZ(itb?>?$0Evha>NUo!K3w
zlz~8I5zjvd3~Nnh-R)iEf`mwj|K-09(_rUDT<xpoyI^}*Z5By!>GShWSWbd%sQ}nO
zrJiMZr#r;DH^QE~(hqaTF5W|fja5hxxrvX;;wm3NgW|&d4BX<4)uc?{G&<!@GXqcd
zKP~4Eu`@D37!v!pMD_>x2i;NX2e-T{VvR7Bp)_6afaA08S-e*oaT<326C~qxePu^|
z5$jv4mAMTgzQ3D6o>bwgRt9L3t-^{*A#7fZYYE;yiM<Ii;?5&y;bmLT5{ohqXTYD@
zAt+J&(Se)}1ht$DOZ;NtuK2<NNHp$x=;b_2C~ytpG?C8&Xb^x)c6^$@2STZgMQ}Mr
zgT~f1aCi#r={KhE!)-K`akpovk{1;WF!2jf47l*AMMZN#b%%05NI>#=vdF8PzWBq^
zLo2_)(@thFn$C?|la5-;&O#;MZft;6I^SohbtIUzLN9o^5gus)xN_c*FbH_coEM64
zW;qkhzV0FWpORRg;bCDc*&>!iym&flL!HIAdFFM(^>J@aAc3)<C1NT}0}dmuaT<Ye
z2=DGj{Gy<8mUP)b9T=u2lui*VnPd3Ns%S-+%Xm{jr%C5uu0-^tqUGYQ-R%ys4sjEE
ziSUVv1mKNy9KuVO*ZeXoq1$XxgrT!I_1eNktE0xVFt1=<MiDB!yjW3g)g=5Vsb;{l
zO=_IZoV+f++^NOQ5~{^4WQC(5c!iMTLx3|B18SRg997a}?IrFbDK<h#ltxUQXJnL=
zK!OZU?J&d!|IO~B;?wd#Tc9kcMqtsLps&eeea-!caPrI1O(PlOdQHZXa4$_!A~rIO
z`BCGox73SP<TVr4XcqPx@1h2D2DyQ6M;BD&?^m~8yxS?1=f=<|fU$4`D$DYtrMJVJ
zy-<ThWHuMxQ_U~15Tcy?NRjw-Oa-RHHtC{tei*XXw`iG&j%{QN^0-fF8KBZP{DY5$
z+@Xs;pn!FCR;by*dLhy8`VU_`XH`LJC|665@$cDC390)ghK^GEQny5z&?YtPU38#v
zOr!qc{@mNz(E%Dn#8kf8;|aKC9?SW`_Hbui|2nBsnRVn&{s}nV`Hv7kwTR@yE#tg5
zt#><AD+!3L#N^C<mq{q6Q-Pv!9!JQocfMcTyv#d;^!!F_Nw(1+7a3Jl`}hQPk?1A`
zxuO-%9*JikDAFo&!2urd>@AXImzW+6!G1`U45Kd>L0AVEVJHqj$?Ht0HPqt3(v~s5
z{E&oWL|Awb2c+piI;ov+q+0w@|9@J6@0VC*)pOcD$0yXR4CJ7OvrC^1m6l=?aTXP>
zPzCGS?f=Ksd50zS#%&xB1vj|&-dgT$;vTuO;Yf4u+-9Ppf|`3~xl6Os%yMOpGDXFe
zm8O;E#I0$GxiAr4e%Jf{_5RJpxef=;;klpheShx!BzS^r5qw`mrfz6i@8+)-ArUs0
z50f!@!cqGw18LX408#3BwbM`rk~^q`vssqI_|8ht$F-3UV`CmyQjpW^&2<wb?F8U7
zJ63?^ZFRQ~<OBS36w(yO4d?CS+>Np9Ki(wmOs{e)#I5CA^H$kcl}%?0-&$>(W)Jc(
z;4Q`5uXMdtDUB-)4GvT`w@w)Tln?<oUFYQ9lT#dDl!u=T2=eaJ5muvCfO@L7iGGT|
zaG;Mvvg<yt`bK3Rk^WD1w_jgBk5GPgo+V)~mcfC1{ZX`MKMJ;>9O0&Wy<w7UD<9Lc
zzs6d8H)L8vNAjy>VSKg7t`6%(5xcanF<N1*xFj|w#tz|S-l99^6T84u-~SFalvmc3
z@z)!aFXe@M0}h4#J+q517LqdEwSP8zD{{5wsjKX?bg?){GBPY`-^s7FS^ykmM@Y4U
ze-6-5B|xGr7*}G?>U6SJZWr-|4jVkZf&WI*#SMeaszro25bX#l-|e%PJ5Vn~s)}*K
zYWX#+T$iXK)I2XK{QWw<e(%1@Mb@R*>t643&(_u_81$|*T3-JVDnIbXx8B#40cE3S
zgz~_D4OSNMI!9S!UaSZ`i;Vr&A4VZ-k7tY#yepMU9ehuBe&-Y<m8<ivQC%-ZymBfr
zI%O6&T^H;d;Uh3G(x9uL-+|Go;xEbjw+gPk+rUT^Cj9bmQ&4xqS1`$4@bA)XRLA1Q
zp?;V3p2=sb2h;l}uiV^}e$cLOjoK-!!fW%~<e;QsR#x~|ob(FgimYPA`$l;olST+e
z=+cWCXBvFl9(ZBn%<Tr0s)d*N)1R!UnuHa#U5<cjWv^u)5UTQ^BKW@V>FB+zl3lHl
zNB@?2Y4<8mc~}>0N3eB+W_|kgbi*u<8~tL4FFA5<)2>0%7gi>);aI;bRTMItUI&~v
zBRg}6F#y6O@%QpBL(dI%nMP@Tja35^CfaT)A!MSj_Q7W6agQ4G-4oz=#uNU10V)BU
zLcs`;2qWgWOkxwXOYLnc>%sH@_Yy@zz+_mnCh(75Sv8SU%Z}-iXDenaIq+GOt7^KV
zavbgcT-ASZ5|aaOJYJFs@^_AhI9imq%n#}3GRe#Q9D7{zT$J%c;3%~Pun!SxfW2aT
zg~%DJm~njlYn-rxnCHsjWbicm@aIRXF%0t7h1x_rU&-_<U-*QP7(vGy|4Hk8A+Z*^
z{aRNu@w1uvHrJoWYND5B0!1L^eT;aAWu3|2)ezR2tNgz;#cq6V)=HRUXRpF}@~tf#
zjk~WR_qBd1-_|<aag~%{QtdWA_a7>q7ZGt>8@}iWWz9SS(bSl{p?W^u9MvfN0H~9{
zSEBSqu|#(kQx8o^408r=YRtS!$#^<wSh(TtAModaX<sCNOrNU<`(5h)PF`E@(eGy7
zjI)V!V={H}4s}OQ)@4GSti;i&$GyXWkd3sMBocHs_lQg_z<8|+rh7v{*|O`-8e0@a
zf<Zmr_?xSwC9n<S?%dM>#-30O0Y-qBSj<?nmR<5IeG$pOpw|O+LY~bu`H`!X<$Gjn
z(7%K8Sc-y&5DJ=9MPhAm7hE0i@SvB>2+vIGKS{0r55$qPtQACmwHYv5ZQ%I~k%Cqq
z9Xcel*BCJzgS0cSpI?yLCg3<0(oB)3IQN)HFl&rHk;ZPZ7kf&9>EaGai6>wB*URA6
zG5z*f*frPN*iNh{H_J^L?1$mcfGUu)ThaHNL?xA^3qM&zG<IDpmqA)O-OAe8GYkjR
z>B@ewinU2+K_%+U1GB0BoGOMdEWAbwxYZ^#>FJHX93b`3ywL5Xiq|0H>K9Q}ozd6W
zwlV&zXse1EDdZkF3^-tnuGdie`5=h~B7q0^ih6XrA^|aAn!JZPT3U>*r4ncTl;n#y
zMfioe5jy$$Dz4_KPI8zWN(uZgfsjrR+;`)_SkQkE?y(yu9wkwuk!}Z+6=LioZww=a
z;Q$QMF{z2W(6hQh`J><KI<*xlg&*!+0_O@%B*z21);8>kr|nAGyiCZ#3Z-N>;iSQ7
zwgcC5$$Nekfd60@PaqQ$-G;dCUK}#v(siLYR7<ZhSuy=*^t~T_%RiD$`Z-(l?P>b_
zV9JnHA>obP{KSjbfvhE0+LJ#TlI{X-mW0|;_VG$vV>Fw@EG8c#X_K94x)gWR0{9Y?
zP%KcMVl2(`&4-{G>6(GeJYS%ffpsoX9nlZ0TFIZ*$41kZdOz4CTA9~gYZ~0o$e<JQ
zyDZ@-nZihlN&hWlJ#D02KX4UtlbgIOO+4dQ3P_@HgnOn<eCc{a`&P$|eWPVXqIi5i
zT3rLS6SIFu3Dae82u-LPJh~}97E~^R(6n#5sQ89?{jGJ~AVKh#OKGz57USS>g@<eG
z6SaNe6|J8v#e!*Y|8CQoa{F57&A8_S*;uA3DhpP)w|9>c8T@i&V{4_A6ISn-^+1N>
zD*Ck-yQXB2tCU~hZyI*M%QM+sm_FZ9IJXs6u3P8#rhyyH7={qn^mNnol>nhnj<wo8
zx08;TD!QI<{$!Z%bv0Zol$%Dg^d;`28oPa2cejuLl4|hJSROAafk4uQP>JT_E03;9
zYYz?@?Ywohxoq)6R~*hD*20k8koqU=+xN!3VP4s`(9D;(*hLg<zpFlcZFzJoU%Z6H
z$7*L&CiP=&h$U!*-&QTwt@h@P+O<Ll244;wjA2Lw5JiJs`{F|Xc}!kJ^s4gJ<m9X?
z4jF6GKy~JSfSR=)59H-Hd+jf~qD$DUL<h3h2S(S{2l5rI8&@~SsvrYvB-U4(!}$<7
zx4?QLVe<fmtTMCL%xzp%R*xs#v-w;b72gm={JT870UTc)PuF)%=hnB%oELk-QNFPf
zOVZL3b{t+GY~gI1w^x^hC9ix}SJg0*cYa_<f9n=DN=qvOg2=llpjPwlW1X&DqRuv;
z&A+yMul!TijKgh}n;idXf59^{Rr}jL$Qw>v)Y&*TD1+ZnkztT|GSCfaxScofqaxvB
zT9AQJi5%p;frsXLmjl?MX5xijk9$qul^3r?T16wiGDurOo&N@y*sEI#)C^5d-qU+*
z-tlj`ccOJk@)pA9?BB@)IhiXO>)A~Pge!rWV>jVhH%+`Qg2V>oLbG0E8fcxC2Qc2d
z@Lc``ynkWFRe^Zra32#eG?Uv9YuNEz$q^`8#MCmwo>jZ*RC?flD%aEYvC5mqz^YVd
z?UC3EOQy${x~4T|!6R8Oo&!xe)M1o;`g5tgGr8RKmAEY>Ou&FVe*+KfCAN%Hh}X02
z2787zqY`pa<tJDAp{3zVX0$jvk8cLj@^W?$uU&uVuz2sosEH_lQ56LL*-1V8gO1me
zfK2zg+JDy*9w!Fhj4i){&=cw&K6RJHj}C_8`J2Tj?0q_ptzFHHD5j|mQQfRlEZ(BJ
z=hss&-&+<N@>uycBwD?i<>bOeO*Sy{8CKx`pYY#LyzI%&_@)oIkGg}BJuoYGvKC+2
z8nQT#lItzLYASyEly)d7d!V!A<}~#gBK$4B)(a{_wLEOJX?*iYBJ1{>!KPES$rgJN
zl(jtCdrwJraP`t8SEPur@B->*PCjMj==BE+HM++^mWkp5!D>8SFET!@ZLIZ{`0FFP
z%=0*I3EnPuF`%dehTR2D?+jRXD8dDJ+*!U7dCUgHkj7<u0=(I)v=A5`V4$*}sG&MA
z8@A6As)$Xqzp)i@1<6D^ibF>0d|4W_GAh^8j&#s7t?gKWG_G_IvvAN-@Gb|Dw8S3p
zls5l0YG$jCeDNjsN2Vc04a<El(VSip51DS)<*zlIL!EvPp3z-o8>0EyM_VWqr&cje
z-uNUpeExTwPJwzPSMeV92e)mZ6_4Eq7v<3F-ZCN&03f1m)OEVAEPSwsRn^qk0F{x7
zi>-ze5?|s)wr>$!a#=*NDXRugjvIGsgH5SP@-?k!AvYnz7fO7qTReCgx&C~O>7T0r
z13kuW>YFq7hSD`hqjCQ>a)nWj;A=pssZ=h-thKZ-OjIUe9^i3zw1u(%-$t`JO^-Eo
zKcCG@yi2+G-$dEQYS{0HQ*kBFepjZ`A8Nkg=>M$#v(gU<_r^lsq^bAzI1yKfy&7U}
zilv2_eiB~xyq3rhJQL%&v5sYh$oDO^E($YVL6?M!9b|-ylfj*~LK!6m0C6MiPCv^w
zh6*aZhaQRZuMX-LKDndE&bOkH@nEGTIW`{0T|#x~&W`bXkvHJ6#gV{Yn0HQ+ci@DF
zn|cOY(9qQuZxWEQrr-US@aQbjR?xJDEIrUnxb*~N9MKmp;<!Rx?`0SwPL8O5<Ka3J
z9>+Yfie_NV!4*A&O8vByep}rs)^5XA;NJ43ntZzIS?16-BZtoVWMEFFFpH7NXeOSD
znBZOb{&Xi_DtdHP9I_z5S@lvC&O1nCKGbbz?@DZ1UxrEs;J4N`is2Kn<9+hC8cv2y
zu{)V*7nw(4S5XYzZT47;>5JiQzg*4an@m@j)2pA8Ng|Q%QQf7<)-&2MEkt9Q-QhmE
zbfV^)Mmf9h=uH;jwF;S_p0&FrrIciA(dFNdM&?cY1(#VB0oHwcy@c5d(g;o77^d0l
z%D!8SiZzk{+&VP-epjp@@#{b6nXibbq3Z^1>zv}8hz;5MPYVmRyA5-H?V}tq;)Ij2
z35+rxv6cka7nu_XYGTg=^G)FB0%@i1dWDa6lrQURL7CO^JkNwdRTr(qnOsYa<l$5V
zgp@cAC7qLZWp)c800NTTxf`W{;v@)J9nTZQLN*Qb&i%XmT)BImGm;zKV<dT$;C{JJ
z-uQV{&_+&%qAXQpcjPO7!`QY+ONqm%eZLfdcv!<y*hO?)?}<qRYLTI>k{SjPm3{IH
ztSG%fp;q#cERj~-iS!Ze?o5Lte;gALkYxqwa8C+0JK(O8e7dUHRAOsigfmzA_Ig1M
zy@+g-|1~kYyKzaJkFr2HQvlPomPjqyvyIY1?;<#A@&T$e<u=QxT}jiJH2g16sF7u#
zRcHV3i|uW}opNPc?Jl+MhvM$V%C->d>^HY^dRo=HM5(JgK_!uD8>bEe`IebP@eQgm
zfJEkhgTY2`S;FjXoij$BdAYW3HNg|Y^EYy&?kXbK1q^FzL)gnQIAY%@H_F@AI!?JJ
zsDuVnfsGR%t~nwJeXCuKtlNAg>p8@YlEwgG)TK$*71}QrYj5srUlhmrjodr+Zr6Cx
zDCH*}_^4sH9%EkNab>rdoAX0<#J=+A=tEReq82L<o*`vK9P3?4{KWQl?sNDZ|7i(N
z)fTB34bxZ>rGH9Q?6FFU|8V1-hRm-6;Tk&H|6wxcE5&iQAt1qF1y=_LPn!GVf(EwE
zNvL_fvWiL*M=5YpIvK%<^T=D@KtP?6#9ikDmA{;ls2yT?5`-J`D%mA&l2n<hJ-X6G
z9b((2bO&2fn?xRJ{oA?!zL7~a&GtTXdiwn}cg>$Y;!q^AN%fv$i4K_N;i7)*vRfFd
z?Pi~v&wiV#UP5|>uX{umiow-7P`N^L6=hMY^!Pt<s)hM$X2#t|`uRMQS^=p%Cv_42
znT?A$F{J0TgNk~rn0FfXw#Q{FIZ-jK%*VPtv)E(|*^^m(b<E<&->5*fsf{)&a+8O!
z2I>#*jhOO%Db3vUu|`dWI@wJ{7W+J9(JAW-T%_;p4l0F=?qm*sE>5G)pd(x>b&ChR
zgtOFWyu1>{PEo;kzfhzfAvuWk;vdrmEMV*uN`F%XywZU>d_z1hspg=uxFk%Xr|!nB
z#8V&88fsdQDq>}pRI0Z+wtkGo!mjZqE0b8a6;)8Wno|`a$}W8YYdLTtysFF=bMuN^
zc$)X$kAc27l<s!gc^Kaj2)1#MhQs@vL}$<NR_SMmR1~T@*lxx1<)@i}eGxf>s)2?g
z-Yw=xvx3X?5lV7@t)l^cacg)Cfv#yiosDu@n2|}$B%bC)y)|PCXI>VEoF+9|xAU6f
zvNQT0N!+)TxNk+K-nu5{!hb2ZNxjA5IOtH{=5aZS`)+>DBg`$7%^NUSmF3B#5hIbx
zAz%+bkbfQ!%|w&K{1)f$J<eK^7WO@V51fx7Jq=40J#<+bV2dW+Mb1;{Q2Sz1>y`X*
z%L<+{ShB~eRULH%OZYr|>cd1E^u9$-29IaYC`oNz5gr2(LzzI<hBCJlMK0jzOS*dr
z?wunve^Y@X9&Wy<6!r#QnImd=#pp`kCq7=pJc15L;%-)mG^b-VuwWeX1@@#Ad)1hD
zA}FbDE+?N;6&?(;O?O_N`M@STP|{WCEqd@dZ3Wxs_dJXwDkzbu$#u$HD?#KRKD8s!
zFAaAjVc1>XWq%*;41rSP2D`VJuZ*rlRLcj3Ysmqy!kF7VZ|uhU{a7-m>4(g|j5KqV
z5qsEjK{RA~y&k5%iXwVK%o}R@sfc<f&dyVVSs&?doPI;By4nHde*~ZGK2bPZR!DPJ
z`?gG{L`z=&Mw8#jmJgx<$jC%r{$Hj5!oVQ+>Cr<2s~?|(`fhN1on9wcPiajHFC(ID
z!uMv_LbJyPEDXz9sQZ<kG-=G3iv-QYi7%S-V8saH5@ks<)%EIQYiYbL1L){8-u%^F
zP2`>s2%Ub-rZ2@EVz@k_JH0}PWTM*Eh4=dpoOxGM^YQup8ba5i!>zEk3zg%Cf3T&e
zox}hETQN6jtXNo`a2G)Yn(*_y2~`^Xk<7crBTC>8I!E=1=AVq-p2DPL;IpUvS8-4E
zSo@J($$$bFo%O(*YpA2YH5bXw7?96Roc!l8!IPLl53#t<Hitk^H03&wyZaEbtarhE
znZicdFImdo4c}sNE`FG3G0~oGOYEh03QU8sfdB+WoOeo}AV`Deenb!5MO!Uq;bong
zrD}Mypjnr;_*#krqKgbg;lCE3OHZHUK-E?ydFo4=&~7Ygfp<Sb2%tOtojTj3@ZMfg
zNpWmnrw*tzsmHeEIaU1yu2JkX!hY%{sD@Xrg{RZ7@Bu6i!DmT>|GWp!J)B~T^zS+I
z-`5}2y+Gdn>0h{kfBM)^9(bt4H_$uA>RWeKC}PtdN(CBvY~T0cW3I6!BL<>Y@LZN@
zyYJH62fuMyWmgSYQrXmj^>@4%1$+B#LxTiLvR4O(a|#PG)9Ow`+Js4x6H3P+JY!@r
z?~DM|?f?<fd()Vy1}tNTDBoE8c@I^Mn7w(BIvnE~=JKPTAr(s<<;jR%6W&=m8usAi
zzR+MK>0!VWd+$jYbEEfX^|YB6086`T-#B9ILs%>mYM@X!r%S?H2&2<{=?J==u7*t&
zYHn-~69cgV#`&5%1X@{{aNAeR>OQ)0bKp32D&_}=ynZ#-r1XKpB%@noi4vz0oASAH
z>A~!LjJbD&lz9D1r6#`x;WSvK;EZ$)zF~Y<JwC{?ON7}BiNjLRm#Pg0Kw|3t8d6Zq
zXh!b!W;2#Qor~>YDa&gN4`gJXGenAut_ab8d>!~0p8ahRAosTSl;U|^#d7lq<!0i3
zZ@TK@#U#zK{OOhVo~xZJ5fN19+t9hZ>(5~EkL*g`QvSD%v{l<39`j9UoI6Oq;Trvg
zon{JhZy0sCwL6fVc62%9rSt9QA$QB)BORKa(Q>_1Uv__YQ%h>Kd$7RJl{fBIP|4+A
z*-p+L9RPr&v|%|Q4sdZ?6QE8lq93$(>1GAxRpWj0dzFE(R4}jxlpjAYy$Kq<O6%ms
ze{_?^fVplJP{JY{1TVxGh+PzI_D1TV>1BMj6|t8ylZt249cZ!!Pir^2zk3b>c*2u5
zxV}+tpQ~XhCC!@59R-$<B5Sl1pHnz=$m*8bX%4l?O=Gs*CuhEw#Mgy{8pkR35iL|0
ztb@}z0K!~bc;lX)e9n9dUIRzK3#QHST*^Gw3QCdCBJ%v$#$#!uWLl0f9pHU@P>#zW
zQg8zM_Wg}u;DrZ<O5;lu*-A!ufrBObMrxmbwa}qB*Opo7{H?9XZeQ*Y=k}VBPaft;
zbU&YXO#d!fk|d-^ve)#J9^^{YYIDwD)2Xin6tcgyeJ5k6`NakVzv9Fr3S|gJ5H*IG
zBs^~Bm^e}LB+<W1r<*lRz-D-A0P(YM+ShTOzfQ0<T3bA!PU*yhZ3`H5qm47~GsRir
z1(zJd5~U5Oow7mDf?r7`JT;G`oYiM?GT%72`gMI~>ha>>xSW;CasKvF)P9dU49;M%
zZR+sJtCynsM>ROGqh?OD+JUA4fZ24Mt2O+Q=s8Dmx}p7CHt9VnZMfr@2c41a6>N9}
zy00S(7#4@I>|Enj+%uKCj@L6WZ7N1T8(^7k(dZp753swNi1ZT!#9#Lurm;)vB_d|s
zE+TR#8l?JFG|4Pt%4T)!|G1`89i8GAV4AEiN(I~SnNAMoIRpl1q!bs_Xk{DkX4s<0
zaEBc=;On~>LKYPF7D#kICAl&~K3S)JtJnh$UobZZ8Kw1}BM9h%I*l;4=EixThr(zi
z)5DFN<$Yz_Hly<Q>nje+<P*IA1_7AF3wru0O>-UxHbb)McVI<thqsORdu4h3oP7Y;
zB)xu$DGEzCWLC^z*PDK$q}4xXkf@o_*`fUE!O1QHms(`>=xmXdWX^)Q3Anhg9<Qi&
z>)*hUM45sM9@fCO*7%AaaEUKmDwa%n2l?}L&Tk(=tU}<BMvCb5*5ZQ{^D&Zu=?3-*
zS6%o|P{)PR2m_7;2NETsTK6hR>$!r~bHypeF991*Oo7s;r<CLVSG^doiwsJmdVQ*Q
zNY5!C#q}v0e=~UYGBYiF$Ske^!&yRhqg!&xe-s2`?+2L}l*rTYmHu0@!fQ?{u;3@}
zA<kny&xX;9_(z1|H#Zog5!dqf%fX;_yti`2ujCM2+l4tOJ=B0ZoYC46QspKD`p6Zr
zA_|v1oOzu}*Rr&v`jUyxJr;_hh}@O8{lxzG7zQm-Xn{4Wco`K)oIZRF1faw?76F{l
z(epTX|6S}o6Gv7;PY?1*z<a{;F_?w=EWoK>?#Im78y*xL%$D6$u7lDE3kg(mExlST
zdG?8iEb>z=Gw{MvUvDO@(pFyNz2tZhbuP$iDBCx>74DM%^f#Z#<~L{%K;;h5dif2d
zBzXT*vP^!Akg{j*VPOk~_AsN8i^z7VBBy|7U$+Zqe)fzhHSSsatZ5iq8ck-hlj$I=
z4)XrnsNu1`c-UOv3sES_4CUcWIK|sT30~5;dx_w)$|Tr70A>EK`|mShsXQB!h=kd^
z+B50g``h8AuDsAH^ob8reqXaHn*?IkuB|wR+2Y=R-dX<wgFlL3><5`+^}Y~IY>q(L
zxpxDgl;dv3_!ynd=?`~ru*@v-obRQyd$oKL%--zJ`OzaRyhVmVQ<YTv8FLR2>NX=z
zTRfK~88MLx=Ub!z;0tS0t8`<o*Pa?+#b>gWCIKf?$*W3M$uA~ZgzumSKI4H=ao~yS
z9j$@beo+A+y}6b*(A>qla~Z9oyRBILecP-jk~{|NC9mfAV)#2sbc7M-5s3^k1{3hj
zr%3?e(;n%+5#9(|eYTfC4YAg){s(W97A<^4%{NJ+oF0ARs)9OAnaMBY{c`_xgXykn
zW?TG9K+>w)js1z>%YfOzfP8iP-bpYCzn3ZN%1*SyigBmrq;JsA){>?O%40P~rzEh?
z;AUZDRqr(RCk}UVHF4ojVVQdZ`h$w~N57M)vA)vks8na>+j~gvu5N&!WDtM{0UzRk
zQ0B#S0OM2qqTwzQkg~A}b!iCnhRdZQ<pQ)xN*?#G6yAo5I;2-8=MTJl?d%uM-Z6RA
zl^b1Z=*c|r);zGx<h<;DKCsMMfwkE|L@x`0v&uRlcV-~=HGr>2N|*W{2+ntti^3@3
zfDiTZb1P&upNAMS9BK*8IE^K_niNjo=L)7kk!H*9k{#SaSIne)&by0bhaewpxzVZo
zs-U|~imGxp>6Eb*?hH14R>3dEStkhq?>oLNu@uTV=+0fcZutYcjNAQZ?<i(0wn62(
zTimTagu)%lEJ0e_=g*Wl<%gIGprI$juL|`cy!*3u=tR}Nba6#W^`{Tx7!ixMKn%lV
zmXta9-4!QqEp9RIHEhR%GR)qFpP<k-!uT$jCZa%1uZyU4m2wxJSCR3@Q^~V2ky+_G
zHS~cgu1_0Ca$-cj;wvt#AbX061**J!PdV}wyWBDzokURbe!#nvv77Yoo8{%4PhpfX
zXqKhZ!UE+y#mO9B*XIT`xJ(cVS&Ao2o>xuLz`Dg?MNl&nvi^)pcwf-CB3oz-1$)&Z
zFB6a!JDWa#Er2z^i!AY>^$ObB8%{_?F$a9AQ<zvHXy^pw$G=_H*s<ZK+#oEE)(C3e
zenvaj@OpgXlF!jvE``#BT@bPf8ttW2T6|JF0m*Ef%kr&%xE!iB!>n0%onGe35Bs-|
z(uDL+h$pOH3%IC15PosK4Ka>eMhJF6bY2b)gEfaXM|_<@)Td&ZQ!;kG^18UGv=8n5
z7N5MvYtD}y`ZcUM?H%h!xA%=Fax_qnFV(MK0CFfK#9G9}U({a+vJ|K!SW)@&Y))2~
zDs3@~dn;7!R65i2!#4Y@BAW}J^pME+KIi7%BTAS??-t8DmHk_el<F*hEiV5ouLoxo
zy7if=I6`x1+>R;BzWf*wT3Y3uSud&(GywV}&fvtuXgxYZH?%uqpm+gZGQ-0-#UJK4
z*~Ir9ab#@E_wqLeU=Yq-X==9p&^zgaTEzS6!`4Zm16$8Wy@VcV0k*pt&`1}3-^|Y$
z(mcWt{)`o=0j0V09I8DXX{4%Mpe@h@OKlrrn89w>rmMvYc})!6<)Srt8E~QTJfSTj
z({SxPSV-Q*kjbNGEo_HIOThFNx&@lS;8AdAl*ZY#+w^U+G_1Y(<v#cl1s$c4YQ28_
z8?@3eBtTagOvi;;zP!8a{iXkz_U%%M2><hDP+4`&-wn7Th23i?ZXGrD$N2T7*qVo@
z-En)#Rf2kS6V}4ZYY4ZeA$Uij<z=XYxIH50i&&4aNm+WPz)y@WgcAy_7$)lF(~cfD
zYm8_rnJ%NzBkh8}4P{q4*p963<j^#MTvl9eE|e+;Y}ke@HFAGVe_ac3{QeA=)DTS9
zfv=jBuO0!gdsf^9^$Id<VPC#MUa$}rWh0L0F}MU+2^M|H(XT;G@Omr(el#%XKe7-L
zLaRqsrHWUwNE6M0Coer*n_=}$%H7^&SgUg>VM?*ukF#B*f-?NRG{F&cZHD_51?WIf
zVG}DS+{s#mIJDF5XuLq9DYz=&zoZXjxD2RN{tl#cP-e)$i+hGPz>HBT=)u!!#;U_Q
zeAV6rU41YXZl`s@!pnsh+I-6NMtu9xvg%T}GH6?2A90Q)oTYL_?u+il5A4%n&0bd{
zeya?MC=A2!@a?vQ(TK)VOrnXf8#YII9S3~?<FW1|<T?`=$cOp8BK*D^=zqTJXq$Qw
z3dxQoCd&MK5}P$}cHwTo2}N-QoRbQ_P!i#f(N0@3H*a$}t6~BBjN)kp_Bd#%{EWgY
z;fg9VubfMkuq8^asC<Duxz#;7$#%B1OOn0kD`WUF|F7Ns^apiJ%6p(DT0KEGkohN=
zFj=6h@ltaJ<@iIybGa3sWTWHntzH^n5xvYMN<AE&^v|hkSthLL^FC7Ru5}F5(<x{E
zx`)A$iSTDddJ^oaAe$lK1dVeN>NeU3!jHwg%e}@8LgC68eN6e6#xSk`li&N+BjTr#
zUn+G<)bm48R3JNBEBe$QUC$<Q1Cy$NDDO-GTwi8XUf}UL1)$Jtk6(OO&tB%{!Q?3!
z@uz?TMWcUT5Z=ROXy#Q6=yy6|8R&%-%HQVEU4QG|m-<v|XXu}Dm&Y-g#~oK(a-N^w
z32Hp)0B$*G=8^g^4|+l<l#*4$-bqE-S9>T?CBsJkBH=W#b|gl?0OQ1Wi%S+fTjrvl
zYQGZt=G<D?`zBdT@LsEsvQ1?O_AS4biNc4#ttPt<L}d?4u_U8jhoy&!=cqD_zX@Q@
znvwBeL5V@I7J#k+JwCz}wOB7yg|W*?votug9;=uaQIIqpb4&UJ;Q6ks)X;dBT)61}
zCKez939W6$|LYbau!#<AwM|n73M_D{HCJsmQFdhctKsxKRqj}U*kIB@3H4&<654(7
zi>0rv9csBhp1MCuq~AO^CG9Rqv(r~bDT0^M>O1wI(95B#HQcFSQ0K_@p}yA2iGbhR
z{Im;qo6f^z+S+J?bUubC#{O=p?`8<kz|81$17nMPa&kV31_=I+JwLmb^Xdom6#G;G
zdi1^i8d=0V*K4>pHG*o<L*{1=W1u=wg?e<yEIQO+)+)-DYf`r0ZrjIigJPvUno%j^
zL?y=I&ks<4bFSGP`2_gjSl7FQY0={*)Ur0<Cegs)yvtm2GwB0?M)!9c8|7%V=CD=U
zF;C*D8tsi_^tDtYV8H6>pd=J}Rmp>q-frN^DwO_&B^X7YteH5_{dQd1#)4_mhD1pP
z<6*wnQDM|=^3Sg<!D3pa=2-aYH4Pakq&D3{>d!O(q_bd;x!HK^z%q~IfCXq^_)p!=
zkG2a8`l~oYY@M^mMBNp6q_#^jWUiP3_eiCa^ZLC9R?L4%G%hF134`4pYcaj*>PJK+
zp<7FHKSuDR6MMkqstO|D&FGCg722ek(mj2=CGq%M*vL4*GZaNG*ZNLoJJeGo<d^^&
z=JQSG0XfDwZO8}%@GbS(5Oqb9(}R(o9$+<}X~{69PMB?bdqqq%t8!O*PF0iQA=+%b
zubA>k^$Meo_0kT>Vv8*|ludT3myW^y69~X0bxC(-ISiR0nPR|o`6^aKSvfS!Li&Zn
z`iK1FAc!L5b*;yGh$=*~?ejx83lUPu{s<sG$FY2U9N3#OWNw|q7MRgY7~9?8i9p_;
zw4z*}qVzHGuEQ$27DB7%9%h&3xt{xe9IJY>+w_Rc_n~ZJ;lQZX6L`(ltosqLq6NWS
z_=spALcdb`YIK0owwm)JPw!#V`AiqLfqhkwew7cyl?(&_)Na#s0|1V-g<|`TNeE`E
zCHkC@nnxn{-mv&Z5|P4VmF1jU_B>=H*Mba^AT1pzQGyNAvxU@m&);9VKI^|OO<M}z
z&btGY-evvJe@;-0_Xx*kNOCI<P{LQd@U4%klP14<oYZ@ZT&77X!5Ul)NfhHadNr`;
z=>^7y-<pR#24>IENYoh7{E(331*;`&8<KIwLc(~FSd9}oFU^x>Do~wkR=wHckl?bl
z;8~ey$(mbDa*dD!;Cn1X`SK)o1xu2$pJ$2WsGE)9+fk-Y83UomfzGJC6vwDzRKb0o
zw?DWO_gY)ycVCs)hz1LJZ5JlnsIV&E8R=uI6${JoR8Z|5U)XObZz$9Lr*m4}AO+K4
zJM3jb7T9&@*lnb83{=m%xqM&}lj{Q7>Xd;U7#iOxW^NN@(?`6H)s^=$&^)vsnM3sn
zGW&;64ag6+7ZO#3*UG?$J4*E@Y|?1eHQ^3ha@{sbM4shh`-RbSHfv*`^|LoWu14sn
zVQ7Oh_n7EFWo@L<4Bk_l)&&olXUUl9NN<_jF<5??164{P2c22llf}+v^b5A5ymnD;
z+}`T!p%#t$(fD2@b0@$o=w!j(+|F}zo_r;~K*;&E^WI_fQEm)1^dvD$KMD;*I2y|?
z=#=Sh#?g0ii~rTn$}%7MC#SIYXeT)&&o6MwH+)g8tR-aWhI6=qlu)h5&a=-9WhwXl
z%JxCM#r7{zB5=Wroi<~i%1pFZc|<;GA^KN@(8&G~OUGQJ+eTDGz5S}kwuj(zRYsNK
zzS7a#$)f^&GK>+Qcm_OZM0z?=`D8-Tec*S4GnC4W*@#`ogn18ojIFhM*PChroK;yh
zLIuW#Fx#VO-yj;}fH=i_Y5m=9(lp&=Dar4p6#IJC$E7vsWNQsK%*vL_|0N(6k&cdX
z5*DxQHWkI*sy2ouXA^O=#BmDY3fJ}yjYN@BAgzg!b1&h26#iKvYjBl8)f@$2pO<rc
zF*ftH(!!d1TvGqe!mbv%Ns&-7_}JBaerK9`adbO$H<REito~yV1@%4+zH4$t%5G&Y
z=9a19bLe;cyL&>;Q7renh+;RSmnZ)u=8(+bJl<Ty5G>b&s1W)m!~v0KyE%VB#;znS
zi`%8)1=CuPSGNyozUF(OY=khTd*In)g3L19RRF+>?i<)H5JUqpjX;dn;e`T#w=1wO
z;m{HwfCq@c0867wY4ZTl@?(vu_lXZ!-fi|{KQ4GGfsqwzf0aqiqZv|47E_3l6i1ur
zpiDYo0*i_@HaM&Qcc5I?^GWxi#^_{r<k$Df1#OUtXX23VqRWnn;PENaqppPr0p|kV
z$KQxg+C+RM?C1|dRUI@&hEv*-vg^lQu)R@|ZFL-D8A~9;zmVbVz?~^2zA)km0Ro+=
z`=?t+y+*inr1||tXw{S3M#wJyJD0d<QU1a!D66>{O%S+6#DLK_DM?F?gC@GSoS41J
zt^J>17Qur>YKug`z<ZrA3yc-QJ$8~4YJ3AdCnL_jr~>7rh0wvq)4~n=^ns4mgZ0e}
z(Do-Q7{J?V&zZw;0~l*LtUHb=-$&r}`8hYn<AM_Xi!YB)(C}ZmsQ5KMo?F>!Rr)!@
zPF8bX9C6FfWhpd(*8s&C;Ajy$4kA7AfdAU<d@m4Ngi=(9s@$r#dRu8aD5>R3c15`_
z6=4l5$P<j@cr^a_xyz4mV4TagP(CF<>seepgx$%5eVJ5>?sDE&=-S`9^h-(rPfKg1
zH)8f7)X;rdI$>Z918G*tx4-Gv`6>X5J=N^nHQZ#P>nv4IHKPrkbS4RbY#Q_*kzpw>
za!Ls_4}JxY-rLZgqUg!|nWx@*InT-^#`~nuuQ}tuiFHXYhg>KbM{H#>>U+>A&-z7h
z^c3Q8c^fb5J|Keqs#L44<>?!;goC<e(+?x=rgNucV-t!VyN6o(QH6+C>Cml&y=FS0
zCzXiN3Kfd#O7ObT_r)tK@A94Ty`61HtIclDG%K32xW&$!wDq@D=+fo!90)pi)2qFr
z{EaEM)d?-K(u4ElZ$GBrt_nA5o-`?LguYHcpFUOE{YDmp1oFMfj3icu107rW>^3O#
zE{+%Td(Ydc%xCb_uehXN-5f-k4_`5lGh839Fo9IntPy|SaJrOrP%>Z2sWRCT)cRXQ
z>O6QZ5AxMlV2^laK2rBAq<>)NVka%YD_&YYk5etlVl*{(iutUccMFQk1~FDst)>8x
z?uQ@5hmoeE)gf|-&%DCI`26^pxCvQgMu_??+aSKjVt9@iaU;L;{q`i%-oXiKqMQ@A
z$0$jA+3Pzyg>km#Q1-gxCTdTLSBj70<4aH0LGLkTDFfXN7pZ?qssJ|At7UfrPpT0y
zLMvUS)yx?@uMzlxJ}zE%&Vk9dVBD{S#}{1XHk%jc#^LByR7U>G2W<8QC!=0QUm3&6
z?j61$nyWUy-1)oOIpK<k9(~{2PD!L>#%P7{ri9H~1lH({mafO;ceycg?H_tGvvCL@
z9-Hs_`9jjVV79M^`s>f9$r;{rU+<OlGTTpg`S^QpOE|R+5a&C)U4PIgp#`Iq7fJi_
zpIAuGdTuF_%=sYCt4-7aQ}LN8Ou#2xsS-%AemHTJUW=A8X3yK2e$XV)MY6u-nb@#+
zZ&&3VxbN%3^=3ovA+*w}SW4xXfSp!G=N}sb_Ute_JxP2VI+2{K*SlY-TAnKQ3VYHF
zj(>&t)9`P*BYwM;Wp*!Zk!2CjjWs)xOdPavT`z8n;K`@f@jVtcuKs1+L$|3=;M;7g
z3n)x^K-pK0GNYY&o!?;Ikf6kIYn4_xiGNI0Xd4Fbnx~$?Ky4zokW-4m^)klRw0xW?
zZV`L(i)$L2Kg}iHos_xkk5%rj#kuJ}Z)6~>nLm&70%^ub_nxCJ3z#V!z>O=}e^dFx
z*(#bYB$mI4*cIcFWn8)f%fj3xG8}Dj`@lb*MMNF|FzkNH2VkM`@sW*R8h1Y}9WH{&
z5B&1%Nq<C^gQIK&pLI|G?g1ZtkdjdsH&V#$l~(~XlJ4oZOVt0sp$5-W%~tP9jWBOo
z@DK1r<T#A6rm+MWN9ln^o9(K_3@i^#{IA3)ngf(zl1ZK6IrYi;`JP~XA^xkTFZ9Ep
z+@cJ{0B`FX_7O?*imp7KT|(HjVd;faQQiJhgJw+1QLhnqGSf_^QpRP$bkQ%IlPn4F
z(WO*yE<sE%zF8uE*fWDTdBgkW!IDZ6TL(Md>9NTBXg8mK@6wv&kokI{7fU<udjnki
z3Rc%FPf}FbmGRg5GNe;1J-`B@acshfaiqwCBo0*XvC`DdCSz3ojPb@H!HdrKZP~cz
z2=-;uM;aqU;xqbSXu&n*`+d4UUKzZwN@+mB+;kq$?!ABeBPt<>ec*#4Wu>LlNC(Dt
zbm-AVeQxIt42-TTKE#4OGjv6>R+WPn<=-*a-$!(jAaC^xmvy+Cg+Hl=O}OUg+=9ea
z*Mls>qS=H+y)L#vaO`4JC|A!#VQS?7jrH~gAILRqia$A(ZMP%T%Lo)-(N^(HSjg|j
zM7WSkcnVFPBRi00;o_o?dw59X@lx~$_iTHDV8ZByJFaFNr@1^oyv?XhR%y-w`2%ns
z>It&DDq<L3`y-Lc<ubc9DgBAo%HFz^9e}RBxX|{)*}tDsmKf$h=C2M*#!oty;h;!^
zBItX<q-Hyd!d>-a{r!9vT3ZzpM}{0zHaD}thf#l_?=fC~LdseV$vximx09o`LrR3p
z%Dx!x%^AMM*@-A7-q9G3$PNM%B!gUD*h0nhY<WuZ<`}HyV5wvunM&IU0cC-_xMe$l
zUr#0$UUk_@BNXMT^!rn^17g2fWLNjLN^dWgMq{zqSN1|z-YEkj{tw1ML`)7)69LHz
zy(+tBt!W1q4!X;sqx&!Q-vjWWR5=5G9K?2HL-IO;LSbj2y{6tur9dgWlB-|;E9n;O
zp{`3T)K7iF^eUG^PzDBWcM4XZEXBPraRQEHcInSA<}CddiO~Re_&wDX%RosARRi`5
zH(G{w5r)JGeb1SPhFJfk*po#Z(Y$WgB1d-YTM=IjGFRb9wa&r<O~zBXCl?WC3@t`R
zQ|DhA=0a=AvwX9333Q{%BH^*2kgxAcIXgcufsSZ*{f&D6)oKmhGVcNHmc^o;B8d8#
ztXsQgZ#d`PA|CI%efAMxVYme0yeyt%xs;hzWFlR8fu&}Ja^cEYO>(ATMjv>_2x(xK
zDw!%p$WP%R*d!}pv%q@Y@TG}7v)%!UUu2>t*6Ksj3))r+jNhKvDkA=42vU`*pMZv+
zP2T0d-<Rnp8i2@h<4YBGURB^%WO|>J8ZK{=!7`4E!@eI7RL}!fEf8-w`iz(^g!m&L
zzA+S6E12?-kP!`t{~db^sgaZc1@-pxCFRwd%2@cwi|7f3dfe-YL>X@=zo>*c|2yah
z`Rxs-U>oH<sx=m5*i@?`8ZwN7m@wrn;8kePTqX<F){y_N8YR3*U#-xW_)qaIet7?$
zGgA*gJ9SYk=($=>rp-}8pu*i6-!AL-`i)1tCbuX%)Pj7Ty(N};ur?J$ez``Tn=|Aj
zvht%BinyF5K2T!4m_6i!#3anq^k5FKDrf|(657G?MW1Fuxb@}wK5KH_7}P3F#9^lb
zO7z3h+)%7V?6J8Ak?x=i=sN<o3Baa1-AVl^!nyp`_co8_Dg9bpNV&!08b0~Smi(nL
zlU3Q`h{XyB$ge9+B3Sa;5|dpFTB~-%r{gtVL!;o&cgmv1?&YNb{AqlBvOvlsk@u5f
zzvFNaaT@9SjH@C|LqG@iNJR>o&NnVnZ6Xo*=x;<eRV^TW?^^gf{p)|C)n-klv~-KO
z>h(PZMSsTARz{Z3u0$bsffb?dJ#q$Lp1Yh4Zyeu^CWg~RWERCFVWsH%`iK%4Fbx}@
z!DGP0TJqqw@`onMN@b+VHTIe>`mA6VVll<yeG}kT1ps~<^sZWyeT0m*Rx8hNQ#1AS
zebv?-b1iQr%j>Q`07lsPs1xb-o65k>wEVzWNz?e<a~D*e;0&j9vG$JT?;!}myLzq;
zJp?+NnAfo;8R1txvL105Iu+73hv$chv7k><zv>=%F=J?EDCBCEC1<i8SsbyF7%ZBA
zWZQ3k8V34Tl1Fgvo2b>$XGK%KW8%K_zAzC9_Va+f?YP%ic&YYiwHpZVc%!t5+3E!7
zF)P$qKhum)(?&*mZ~;>mtaWZ`_oA;7*1m~jB1H`1MB9y}-!{}SmFvkOl1SGt&rLZ`
zr=gaa>$Jhq2awpf(TX!1p|s*M{T07?qQ#nL!qZfUUC{l*yuE!8BWy~)q(77}nxH=-
z2I|aP=o23rKzd)rWk9c7WyPMXXHXKJbAj#80K7_Z;=?fsOTf(cPs1{HpjPWRf7E|v
z;YQzAgDuec9v+~!f3+j$lVJBs`rBXMitC<3C~LXdKHy(&>asG4tRxc&?34k|t#8A_
z*TceS+^eVl^iFH=-2%`)#-3<&62kVom;vT*l_>9cN2M0Um(Zc7+}A<~Y~WhJ0doqu
z`$?4HpO?DS&m8kPKeG}UUu!=k_{b)aj>+JsYSD$Qm&SQEdrv7K9!o|d$KQ~qeU_HO
zd+la4(Vzotgn>&v7SpG<0Av#2eq3#X0V*1K`2)Yo;C<f5F6LOT$nYOz={q>WnfXtM
z7$9pU|Di;@w2~mL*g(Z@X$8z#(WH1F0}7q~Vv+Ur?dCv{78-5$*naXUF%xM#{A}Z|
zC(!9IdZiQR&L;VJX^K)oE#Ed#(dEU6-P?WqwL@_UN?d&q(8jzgcqnuF$sLX{Zxc-`
zIvgjO(Fs^;0kt^OF1(>p<LXN~XB|39>-cqRoWcDB`*}|xXDQjQ=|l8lvSSeW4L(Qe
zcbAKIRTopP`sRQ=TF)cIk^Wzu%sz*k2y-t@aNZ~faCnK~va|U0t=Bjkn%^V?O!%#L
zaVe@N=WbG1;Dy_-m8vMKG$G&r3j6Ohq3$Q63yWy}JS7?(AL-wBGO(;>y1d@9uaW+0
zqJqL?wMzfRdI<sqqAnE^SsIG57?y}1XpgnL*doQT8bNFdGa+D5d*kLrS)%CVUYZsJ
z;O*aqjyGyqRILUW(eIUEvA7+*(USGa@;;`YVf{)a<yg6+ayj;0lsTC`oF;#(di*=J
zk>HW-yC;acG_F1Rq_Vn$h;PG-JR*tlx*6G<XaMDPa75LD41glp`9*pYTXoWV#g0Ny
zeyoXpxMN6pD%2}FC}Kj`2lOTt60e)_Y?=1vTwXjmp{`djijUgGSc;iLSOlhjT0R4u
zG1m~B^XdrqhL}wycPI!NDYyiOVWzSqoAhV~bGn5Aw-}^Ajz5M>!3_=YKF=%sM8~!B
z?xJYU7jftuKCf2y&5AHZi@C^G?b!0H2)ZvqAp)ZB8_pTO(qH#beU(Airqv3HvqpTf
zC>RE6542pp??uT*55ac1I%9S@Bdm@dEgf{WsL+Va{uo|@Jue##y9fOHyGh_gv*cdK
zQs3eZlg+~M6xG%#ioAzYgmsgnzw~N?Uu!zSFTK(o4@*;$xV?)BUALfgM`woczo!>?
zY9v~oshOw9DkFbo)>!Y7OttT_NhUGl8d~a<Uxac>`zZUyF8?OTJOwSj9VR6H&ps;?
zOvi(p6!S{<v8Btnei}*%k2xk4*iq0!i5yq2oxmw1F*v4%8hWp_iF<_o@me?5uy76X
z{MZ|3Hfu4u^z>_C!wVLyKs{bHwHB<Gm!x+iIF}7|mFwGrB}Y4Jl3C7oD+(bkM^&iX
zjzU`e;v+8jOgvFMU_L<0^k)14h2;9;={^s`aXJ6S%H#%VsTC;w*SHhqHpW-XlTDEA
zvbC@`DWZcWTB2`P)Kv@~n6h%vR*ZaBK!T7G%@8zeE5{`8$uNK~pY1BiE`joek_=z)
zQ_XNND@nvJ0OUm~*l}a(+R@z{skHmttltvBDS`i7ccq2Z=>9(0OcldR@s1Kz!+aJg
z>UXKLUM9SXS$ps7wdzZjzxTaFg#p>SIr_&QLYmSDeTKvU#JzcTu_z{gQW&dO=~mhd
zZ`I21a5wtWpZrPd)%8rh{HgU?2)~q{L9*Lg=lo4H#1(bRfhCG|s{(ncK#1t7Z8k%w
z5czW{DY;ZUgxP{-@%sGZRY+&U%{rHzG*wF5j$S7^hefY!^JFu-9~1<GVj161qe_2z
z|6^i=ibMSq{31pk(px;tcz&5d*1%yzj066b1FzuG=8DXDalfJKYRs7TY{Z4U$%+u$
z@Q3K>XGad=rmsW#QZ5@En9_mO?|IB$V3d<nbaE^U8oSX5y_$UO3RIc*f&#SZ<|Xbc
za1ORgHg3i{!u#=Z38k_5^9`ow-X#Uw+e}Y>PO(xKZm4S|E8MX^qk*@7-Q<!CP+We;
zO!i|;PAgUXd8S}!JC~s_Cp|vm9Op+b${Et8D>>Q5_UOIo1N(Z;EZLBH2`0KH(q)`q
zN=1d3?bL^qi!7^IY*L*?U60C!CBV<Ja95wxa#U}uYh$fpH1gPn*|j?Spbzj{o$QCL
zNWE&QA;;O3-{AruOC}~$?$aO7|9$;L{HyAW!?!nYZBz6F|DJ1JyCb>I`hF?m<D#%p
zo4bVK)*WTR@BfDF0(H}Z3PRsY|D!^|ro~l5#Kjxbe>g_nXxYE*HGA_Dy{;n<owvgu
zw`2VSBf}=J(r?kRy+qsLUdF=W$*kU+3Hvd$N|(8mnA)XhR2K_T5Bjxgey<vM{h&3g
z7ZecX8|_)zqkco^XQi^r;zM1>`<u9D&v-A^u3@Q-D`^>7G^gCY;z&;PSWR_G4bVOx
zc}K7=@X{~c;j7AK__sbWA2z2isp$BOhsEWyZN>x!B>d^Wp6~$n(46klLn5lZxJzpI
z{2gR05Yaeff5i3n>Gu%Xtv#Y}&F1Cx5Ea(wI|+sln%))qp_4cJAFk})jb(f8Z<{7h
z-Qzc_KYuN^p(!-HTmRbj*VD^cT=etBGX0N#nHS%@6S<rB&ffM-PCzx4xAM*C4eAVe
zuyW(pjhvDjS3MXwuE@+<d`wQQ7-DS7feRdviAh<!^1<9XpMMaS_yL+Dn>SU6?G2+i
z?-8!%d=`VkKS@QEk8e(Ns`okWFsbf6?*%p6PqqBCUJ5_`WG>@nagQ%sIujb&^myyy
z+-%(~{gMhv<<*Cge)!zhFSe>b0uQ}LgZi1}Pt{)E=6>WISnlj|{guC0eN&d#u>b&|
zC}vnLa+8(tm{|&1{&S!YqNgV<umIeEIdf?1>2*J5j*ZW|r>K}~3Lnit(X^MlseoC?
z`r&?g_Y>nh1gV&>A-hzRZgg!@IFm2lq5=T$ehb{Q>g$z){Y3Iu!s1xFqDg$=d8=iG
zta)8y>1cMx-=Dj`_8&|PV-oQi-HQ4bg$E5>BG>QPj>hL&E&8abbUGp`=n>5fyH?WO
zU&gtg8M`~7EQjd?-l+H~i4yYM1d!-6osAs2J<hVHS>q;DwsC~>!83$94rgr9!u)el
zNChuXnxsh_+c@lWx6$aub{x=|K-4yK`ZP{F;NKtqw84nWzj=>1SoD8-I$tZ5Cy$`j
z4v(RS>!&OgE@7^U-fG$9Ii}H;U7wJQa0v^Y*TrGW+gq1Lf!%Q@5ObaQd$&q*Ni)&D
zfTi7r78@a*<!4Ulu%9vO+HrWw^xz=nujPYbZ{yV!eVV<lboiyfauhwO=o+z?A1gg~
zDSJ5Ktee7()$e?|{itY=Mff`I;4<zN-LlhuxOr<kZ}aPibHOA@+%)I*W9P?;enykt
zC&d?*6OWDEGg^V}8wF=}4DY#LkU923XVf<4yBQFRdZNQdz^nggg>x?^0cAd_?;U*|
z>F>^5>1IARusQJ?WdN;6?-z(`mfMs^o{uDHM~$U)!F%FAeI4{4&o7Y+-+FLi+#*(&
zHMBJ%(Wz0J8oixcKv%@KRsaZ}g7;g#_P(bX39KSKoaj)JB5SSM=m9l`;tk9`Vkx&~
z!<7y^*L^$+YmuKe#KmDe6fJtPF9l8RaGz@0#PZy7@BSaM-a4$w_YePG&<zu5MhPlN
zOT#DurBoE~0}|5RC9#c0Nm05?P!JH5kO2cmw<sN>MQS4ljP2R?dH#8R$8Y;<+i`5W
zuKT|3c)!o{e2ogsQ-==AGVCk<`MvjI$L_F$J8Cwy>m58d8*^YXX{Sum>Sqjc*ywdy
zn2Fgm>JNn}MSGo=+Kgg!4v$~cQqX#KEwHvytiwk3F~)RZFgl)QXDTl^ig=BeM@uuK
z&8tMBW<SG;Z}3~jB5{%ZG&p>pF7n)SwL-SjmJ{ky<@gL<06FDS`mnb1!XxNEa|zDC
z0&u;FT;hpXYB51ir#CUCY$hYMM3K(XwsnLKL{<IYjaN~Nu+nyA8BT2Bc2nTw;3L*f
zKB>f9>wc%d!bOYr>n%68({aL+b+tPp+Bnjq+$64q2mOw$7;R#VjIC(g&wXWouEoe9
z`T-m)g2d#uELD3)`OaZbg#v5FN8dhcy~|=}*W9qCQoQWE^<d&155!8KqtMSCo`|M4
z`nJf?{`)DdFXN-G`5TW2`kJM4VEjJ??a`f#41ifNx89O&3bqV;Y)Ve3Ip;Xj^BZRU
zt>^4yZ(afkS22;ib3{B&oj1&U%^|&EJi^TBDal<<)ZB_C;cSMzl2i+%=F^RKy1h8y
zkCpoP1wB)p1wy-QW4GHg4VuwYs@~Cvzd=QYVj*&P4N)18-zJKd?W=qLUtsiEIY8^8
zR85z;kT8<DFZerNqv7@R&A#b1y2zvI4!Um%DP(+PPj9$SSjzETKep40j1l{V*eZ_E
zL#HN1y*;m9H^e}Jik*Xu{c!`yHJz&@DOe8Oj_KvF)7MPZeuJ`WU*?w`<MlN3!p8)>
z$!qF<P{TN4@NM*B<ZNGq$ND0Re}0R>-CX>tiC^zdNU>C~BAvMRrH64sa_J-T9_8mp
zi6-8G+_k@6(Q6P^ywUB>M3Og7po9BtA108?rth?g8WubwG5+t6fxHZeG`(p$2U4bs
z@b@-T>GpKWG+5SB7-ftvUib|WDz!sx)2rAm{erGEJ-bpLE99iP`$}A+?OlGehWzj0
z;fxW=w7z7n!q5Doi=bZqqy4_42i{quQc4c7?>2fR%fQiqd>_D*){A<vm%z5R!;10f
zS<ixU)s$9qEaz;t_-JSJ;*<BgxSnED8q?Z)Y#sQcdJOF21%4mQuq95+oA$9U^O%9m
zUrqv5t@Z>nvVa<Z64Yf7RjHfpuHb9yLGrR@2K?<1MKQ3C7Vr>#vOBA$ZQ44M7ii^E
z|1yQ^C*sz)k_E4l06$xmqwLDn@9#x79X6!Bm4r-R@Ag-CUMc&|VjMX34#8HA%UKO=
z$Mr-XfZL|(S=OZ}_KNF3&PTKPE%xUQe+JRJJad5faJK}~GyRtZiDk9Ga$Q^W<DrXS
z`<;j4T{|maWX!L5BSY^#BT;cqMQ<RQSObDlH9*qbn0VyBJUwBl<QOXPAhx~AF4SNJ
zf=`ZD<>rg%mBW2cQ#6s$c1*NLaWeDLkStE`$13=)fmp<`h8rIQxv>+wr+AVYkzL}c
zHR|Es8J>o^46TwojIvZ!a`55K(d(?UZnDD4d_pyvDa1GQ!AEPw@O(GEI@heI6!3oQ
z-@^E(Wr|&>p^Fw{J`=&8;a~HBKA4X?T(C_L=;BEkK*B}n?k)Jwc=4S+f2qRgXHLSO
za=evWwB@`C-6ARg@yR{TVOY(r8KmUXfcrf3Bk>MIZEhbk$;0>iBvo?!Gm-G`89-!P
z^FR7b?aagrHb3D)q;!>uzVtw99I}AM|2KVRwSD^%8lcDhuJA05MvaEEW`Bg-rRsn%
zWYX8x-5FXMO7ni&-h%)~$+5fgrqFmI#r;DADnMQn2K-Jv{#q#|$&R<{<>2|6e~7>%
zy$A_GXk+^$h9|a0(WkV&{?eZ}$QWHM+u(-+2(Ikk0gdxC=;&RM<mWHuh8+F1KG&V5
zPWZF72e_uw^N|4oo<~35w$e<tl(#6JGN^KVbbLu`KsjOyZ|n%6)U5f4Y(HTh7;$1`
zH+x)8%rB7nYDS*;*}hir-HV>Zm}WAl+M9u>@^(DCQ~=rTOoPuZn06o!scI3vesO=E
z9q$WM362kI82{GCei}+y_Hu-BIMGGxGZDw)C15=m{=Y5pa+>YZx@t4ZDugq1ZT))*
zm9%>Zvyc)A#CD}UqniX-eGBdkmEiu7;wB?q;M3-_nVaKHmbrD=f2NA^&)ry-e1?}R
zVXJfyHg@n3H>7U9_9K(zc=Ijii&?aKsZf@mCVhQMDr|>6)6Y~9r#bTB=Js~!YQqA!
zQ*P>=QdYAqHtb<d|K(YaK1l6|rtOc0ja56-oBL3_a`mHgDz216f;pKC6g`?7#DAGg
z73CU@BOx0;<{5URj%(0b`mZ1)%MTBUpYFMVCJ40QhAo;mNqW|@FH?+PkIwSLM@N-e
z<S}<tH^hV`Fm@L*giEB9CEn!s)pLkTPIv3gAD?av-ezZLV(jHDP~AoH%jDeQv)B#i
zq?Y%-7HV}tNbUnKf>KR1&cpvy@_xAoSR`3hRJ@mcZ7DUi|7uayM00Pva74*tbLC|r
zXvq^TSb3^IgTzxVLBQd|1%XE&$T7Dhh{QY(@m}3e;loM{Ze&Cu{NxQye;#<YwK!C>
z`{IAEzjyX11ddlzW?po(R%fX=XSb&Wk_)&|TKdz0xt_rKoCVY}EX!UvEIzFr6-qap
zcZJGrIHk^b%I%QFJTP$WcR|wpMOBeoE&_vMdzoZlQzkWo8~fyE_KRN0{FR2neGLkN
z*ti?5e>w;2a1EJTt9j9Pq9%W?9&-ifGj?@PdApH_G`R6e+dzRgGeIzbjtY=t68nzm
zqI1QTs^i^Pmlc<;i@8(3#W|A|r!uG8m?P)S2P~^FAH)`>;pjsH{k**b4E~!=CWddC
zbxf9o|Ix4z4xLg4Um3k$=sjN8-Rb)!Iy&X-CHjwjf7(4`%z~G0PKLjOXmWDP9*F@S
z2FKhp@pg=4kzaza%e!+N;WPilxU+48|E|ikADp>^KP&uE!*j$KEozBqaTMlpO)4sV
ze-0nrO|^vtytoe*Y^<2<;CKGPyvap@&4k4CJuev?QkD87AkmUKvH$nVP>sEV5bf4|
z>!kOi<hdN~YI^;9R$fHWW!76+O>CMq{9wj4<O%KhS_e69-;=fX@M_d=K^3*PW3sd@
zHiE>?>HagARA}n`6Hajr%fn8Z52tAaz4Qd>M2#{1{KPEkYYTi>su&}2w^>HJb21(Z
zs3y*=FS3&%sUxjSRl7@y-lH2Us!lgoWs<5$(#!!_8vms?xouS+9vJpKI<Z8#;I+>5
zDu+KJ_V;e<cd8UI1GFeeoOh`=@9Dp{lE@{`i(g@3rfG)|?GtltPyiiu!_e?#V}Tcd
z@>9`U3G4URx1LclYc7(H21m;F|6O)*mty*vF>GR_5;(Rp+axsvam{NidgSyqJ>S=K
zSP#b~>FJ{vV(-M(9~#tP4AEEnjhJ?nY(J7cIW@R{wpv`Y0J;@=9_DoC;@%@F6|?Ej
z!~lAbdqGD%wKW1*Qxus5i3JqEfNx&Y^8LYz!W`h$W{pH&9<Sv^1hI97uNk@>zx{rO
zNo4{2Q)QzQ|LUz=Ds{<R=(q3(=1=amc-~UZpx&Vum~%cJ=F0^T((f%71SJznJoOrX
zV+v(>zJ6r;#9`uQpF5&6J>f92+1euYs6?CQwq>}!Bt9h_S>4H?Xl0Z(Z9UG-Jm?w!
z%9>S;y&&;+5JH+@T-GT;dtxHShV#szhZh8go2+gxip2<#!s?d;0WZi#^l&!eXd96z
z9q(ihe8*Fj{P+!zIHmBtF;e)uIxOo@e)yx_8{}TGwZ%R+dV_W1Tfi?Q9|ga=5BAuj
zgSM%G2$v5??i=$?NjCL^eP=9H{lnt`#xuqn7wkQlUY~>wu+JA={WZ%mp<)|qA{K_c
zSi%OVa?EBDpr1Y&(3qU|M*P-l5}9V7xL6ycNMBA<psa58K+@%vZSQmN>VpzFNy0tC
zm`*;H29ozEDWr5++TCt&164J}`CVDY6<=hwrvYFa!v%C&S?Cp$3-3kaRiD)H6r7zk
zY`WkwVlC0Rh9KG>tJ>GR>4R^%ev=&eI40w-J9`>uO!Q>7FAUT2Muh=vVq|JC13%q(
z4_qZ;jB7e_&b}*L(_J7M?I>dtUf)~$iU<ghbcAy)9$Yo6Xo(fdejZls?F^u!dR_}7
z!j`WGT+eu~3&yKtu=BA~5rubOgX2*unu#LTxz>CK?J59{agcQuDX~@`$6B@(nm90F
zDB1S6{58m!R~>&U_pZyx16W^nd=T->AtLpR+~Yqme5pNLM~>H=zW^5I`we2XHcaRi
zjtV(DwdhVpr5^(l8q;1r>Cuj{DJLXzd`Bm}<GyU|7i5tv^$m@hm&Nj-EMwH2<)olm
z8;tv!o1M#gLEUa-aWU812&2Q=A0NG$A2x6PI&W)-CU8|2WYmqP+r6pS|4e=WGR3Cu
zFb-kpArpMuLL#T9crsV=OAKR4(x>NwMK{P3=B6r3(y*_zz%_H^H+hKnGUGJUy*8(R
z9emcbm|UFjoZ9?zOe*5ulCtK2N5W4BpbGla(WIoO52H`b$Yw1pq5J!>65faIM=^QD
zTWJ9m(*ZGHUP2?ky4jz|s<o#q3$m(mbGHmBm!aSGI1IA!$RqFFEqHym*z@wfUZr)R
zQbau(ix8iWoJ#M-=yU=;7gQ`qkYyV?50@QM`%`%0tNN7JA5}Z-y%~PKB)Dc<S(H00
zJS8)SOtZL)yxxC{V%;TZNpNnP&)ErRw;f#izYbMc;urFN&f~b&DaeM4pU!AHqg`3K
z4IxMpOjcKA^^*jtZv42aFvKNsU4`X(G?F!5u}qG%y9cke1(Rquy7Yf;2h#lQjtWgz
zu&<EpPffk~UwD+Wv*u|327-gqtbb~%(B`Aer&O&5+$)*-A;jESNHh7=a3X-Zf;F;U
zkO0uL%V`&mxjd;hdvGG#BVuN@zem5M_4)FdAyKnA2y{O9@JBByG@Eg>0|))H<5h3;
zcx0D(H`p7#NYjie;y-kJjR8MCU(a+nYi7QQi4W4zzWuN%6^;Sa8{db1GY?9RH7FBy
zOU7C@hM32+gG(QaFq0!n_b+NL5(IB}FHX@c!57<y(_BO}Vk9wGnte*Owro0MXK7wI
zA%FuvVNm-kib!9Ow9@xniaGP3Q^QuRD#pyovTt-hgU~m4Tn>j}Z<+`+ux8cXZ6|}A
znV2&qGI{QLtwL)a*Cr9b+RruW7@q9T)b%JVLqSSEeR)?Ci{7itER7bZcOH`I&vM_?
z2)q^3ew=<M7DP2-Q`g_)U@);{RyFm&v~&bykS$2mG**i~&YD?K{t@ez^mM6HkP4nL
zWfvu}Co?1*VDq#@eF)?`9vXhV_}Xf;hG6tkYumnMS#T=rIj#`#^C7<Zv=iF^aE@t%
zpX)TnP#`{Nqa`5eM*A3)KfDW{mqL(SPLUJ7rPTCi2=bZbJqQ*haB^B@L^MB3_q=x5
zxK}AopY+RhcTIL)t~H4KM0xE%a*4w8o_<4aNHfU-vz%V6UXz3H^$vTqag}ZrJ%e@)
zk1451sf@0Er{Q~w)rIvS>4+XOtk+hbwPWwED3@3>KTVS%=*gNW`I-4&^@~PzHU3@(
zVp2HK2|Lwo!VYe~_z;@R2M>*PDT#N9El@LdvL6#mD!*Gr-yT`H_8aM+AdYw!)t*B2
zd%b2zEv`$UfAvB*<AJOV`uTjVw)0GTfvV9?rxk<D{Fr({$Ncy(oFI)gqgE?Cxlyx(
z2*Wv*{Q|G<BnrL+8$OTk`Ye9@?^^Pgm$BSyB(XLYG9|qd>2wIVr*n~M`rEoTwQIFO
zq}!q`Lyp_qZ3s}GGUBOSdDvl9BF9-*58wBgQgZi8nJbdL{sSq|?5HUDDk3bIM=-f#
zapqwec2X7-tVs4l&>p?lgoyp8@H4@?H6yj*Gxan4rhICBB(@6yAV9v{Rozb^_a||v
zUdJL5MU-y!FI{aR(8uZ2n3BxI<wfM%ifV<7`obd6*AsBbdWoqCLtKH+7$(v4t2|h_
zvwEGdeyPZf7ICcJ+FV0(MH&_DMNxOw+d`)F?`j91_S=^rlf{R0bZX6SAP};2f&y5M
zV?~1!n8QF4iG`C1Mh&a%C>oY990XM6>6+h~PZno~et=-HQ{3BPV;mIx!zNK42447H
z`r7tu-q5qGHS9&(f7kVLe(e`ZgZxU{IP!^pc5LgN)65El%c-RJD2<&lZcP>*2xH>9
znL*0;rCe!Fn+&#Z&kr|=rjAU84`egqf3mQ#?PrY9wQ0Nc;s5#==#f*}Tt`W;SZh{_
z4qY;Ek;QU7PIA-FX+_ad`T4@D9y9>;r$k6E3rIhWgyKau`YhU!qC<2VsB2wx+I{-R
z2J6A?>;i{<Foa)QM0;}F<T`R-zA<iU5Y8@P<j}Zc|4`o-o<c2;<<8F8?cAvI5n0i#
z6`BLTjnJ}xaqjHuwY~al(Th+DJpJVUh$7XkRv(_H7o4(hA;^8!;{vm_W16m5Jnw&S
zj&`V2Xh-B_Grd~cgj0!>v3yXy&rpAj`>}*_(sK>_9yG{P948+5-@xETSBB0X#Zeyr
z+$3xILYR(ezQ8ED7)CV42~TayyP*^8Vk+>9)a36VCF|9hTEvEm5#P^`N>r%!;0){s
zQ|F_DSVis(SIx6c$xE-|C=ok3le|oGgxrtk{L!y~*gkhotx=TIV?Q#v5Rv*l54xhh
z`+6#e=KMeS`Wh7?V*+gR3KPF6lgi!oOBD~LyL2i`US=ifKmRqj2c1&n(9EB%v%<dP
zE7f(nwN*EmT=FKoP2k)2ChYw>Mmp=pcb=U*OaHcH*;sqsP1rW!OfP=XOQ9M55fdad
zJj)$esJ`0$jjVRO8WOJS)fL_sUF<Wm+-sF4N7PtAD(p%&?BHc@zLyb2oYtlJoo+Ym
zkVFg3qVej!UpJ`CBn5atUc?92@t%FZyyQruQ1@Si2$x4IFRwq-&%$S8{F#<0H?N9o
zB=$X52`2i7y~Q}%(b)TYRP3^f&)GSbK2&bi1dpaDA>Ma_Y(=i3S^Nlbu`AbkU)7#y
zx{KUCloLJ7UNLkqx#_l&CWvA^GI{voGetT1oq_)oQC<8$47JRShL9cB6k(Q>KVgpt
zdfn2KK(MtN{Lfcv(kWO?5jFF^N(jGUGNjl_@e_-sFs3j!{MWP3z>&X3;%AOhTGqy_
z#rS>uua+$CN*hdG_9>kbtbWJROvW9Ich7KrU*+335q`UG^k_siF!TaJKrV(R`o|73
zKB058&~v~d`FqP4PfOWLzm&Dca#~xvziD8-(Lt?)Q@Wo)sR3nr;eV%9>U$pX=Kr`U
z@Wkpv?=l-==2mu{wa$Nr?sxBdj5^1JTsQobTh8Es>v?<X|Dtt*<;tSCa?e{A27IE`
zz8)D;&8RW;Re`r5|4X6CawBk8ar9Rlw|kVjmGEp+`yDBI2(B-`O(ON_ghH6c)I=#R
z#i?iL>Y8qlb*eZS_p;D=cXX1CYW!Q=r|fhGi-^}Z3sFWl$8VIzhE4cLwcL1=_S95K
zbkBTzAvuX6?grX{KPZ}{HOnh`$P4~6d|<lGMqevuDxYGKZr-su$3~z~b5oU;8SMp~
zu<I~vVDXTu+2-~+vEZ7*iilHV9OYTqk2z)e0iYDKj}(P<cvQ$QTbP+~xw&cRlzuHd
zzq3@{+U+ak(+)IUz>81Xo<PA5x^gRJPZbj2WR>4Z*Y9kXKhB*)B1|96y0#7%54(vz
zZSq0W*>A7@**|E<M(*k5?8zJp9oI}@%S@x?Dn0UUpLDgumVt6Kcco*Jo!srMv%@`2
zE+;;hT05J(ebn8M5gT$z(Wxa+0jDh!|I-lOy#ilw*Un%iOHG*~N<?tFt2ff_t_m-H
z6Rk@#v#`(^>}4)}idAQuVAPTJk$#EPHsLqBTM9gxxb3b*oi1dQ-{O+4IoG}jtBhQx
zzyI7#{z*t18~zDNS^Z4On#8vJX=_L1!hTttr5Xu(D;N_S4iFMznxrPyqy(1^a4wq@
z#ey8Db)cVt_UkE$pQwH~c-ZD?(KeA6)nAP3g&Jni1za%QO%`pW@NAtGUwD7zd)r8T
zQ!iSfB^T=O^1UhHZ_gv1>QN@FB3s3IJ9OpsE4G(~es{3iILB~3OhOs-YJWt2z|b?x
z-Q(rt!x-iQdogh~{{0o80i8OmhzL0E@1=n*S=C~a2~`3XqM7^)g*s(4cP8^Pw8J~-
ztBk7H!$a;>3I5Zcrb^p}9YsWlI>fJ5n=Dg9;;AX5WF8K+Rj4h*P=CX~um1O{(C1mb
zR)3o=IWVK*ck0+yT8-wUYI-4>Z2ruB<IPVK|2+_=V{Q$<fd|!crlt?SzN@Tjt{D4O
z35F|)+?v?bs!KF8<MS<DhVd5QauYVsl-N##%qTQnm77C-`7kv=n92?I%|kK|pNA|O
zpr8%V<_2Zc%$f)SXxssGV8BDy4BFb4%|0L~TbT$!Q@i?QrZKpb2>w16=nz8}(sdf=
zBhE_UF9N85h#Rs#A3CrAHv|A7OC^4F)Fsu5o&*3OtYx^zjpApYq|cHAwEe{_T@e<d
zhCbg*5tT<<!_YlN#VP@6u9vJ-)AL4GiXBVCuWr3<)O*VS6p&Y-vh959$tsN1Q;NEh
zQIBI55C6eQaiR3i3w8kV!So8>&8#LyNZi2|HR3`NdhYF%44D90N$7Mi;T4I>EgODD
z$P&W|N%$!ili3G&S-WmF%{^S&o2A-oeMa9peZCSUn`J44sDvG29Gm{r(v&15*L_SV
zu)z%Ned?AZ2M1Yf=W3-E$m7|2%tV)W8c$7g0;<g<fKy@vo-TpU1lBq`jA{fS)+!cX
zTv@K}<x{xgB7S){maqs*P>5w5%i5=i%A!Xth1st!iTV1}$np@<#%?>5_<En37H<cq
z$AT$y1sr3MZq*QeS{F21XO7D!A%uw7PWeR}-(3T~kJ?-gE_sN)AH1}sB)~UsfVO_&
z%7X2zTx+C~g9L*IIUsM#`;{z&S_PVlU_$^8%4BECV6p(J9RQ-KSwTx&wH7VXIr@7D
z3_$$l4u2i@3V}8m5(xh?hBlbEkEsIimjN8O*+EyrsDa8wh*+s?{XCcaCS}?Nr?&nv
z;g$Qf(m=zi``QlRaR3#|&0wL9Ea5$`$O-Yj2mygiWhE+*wMr*T%_;F`smuVAiZPof
z=raK&D**}%4<B-4gM@?q)CmrztaQ*XuQ79EivxX(kEDYjSw=!}pG37Ur1<e}Vkh3;
zY>czNY=rO6<JFKT`|p$VR#nrtgWeA^-v&YbMnb#EV(R{BI3iaYgmBGDG?snVp**N@
z<=Kk)=<xTL5jo!WMVXp|v;W94r!Ui^Ucl*R{EP+=<OCJ=AAi3iGo2lU%)^2;Pi*9I
zgh3sVv3a9Z3Wb4Sm^deq`u&D`*Jtv5>6#T6G~2`~(O$FURCAe?ohv;{&Ep@rjlBd6
zu5*2dt)YD?uG^I*g@`U6e0%A!fDhmQxnz%f!Zdm<k0q#VQ4`(!gwgh)bI6?Q>e3OK
z0#%?ImM{_SP_32aUn9!iWH{;#O$2SQLxSS5|BW`#p!Dg9N)<#dAalWf-3M;#c56<d
z`bjeJ%Dd|cS(GqFV)6IUcp5A_!!!zJ{^}Ic;$XFzaL1<XD#bX(ha7!3HInbmu(PJX
zX~Ht-pCEh<rcTITk!wnx7cxS35cijXZ5+8ofWs3)OsV{0Xp^8*Jk8)E^n$CI!*hJS
z1d9fat*bG)!@j?U<xBhEztdZ9!FzW0^g)hC8p54`yry47SAJbkI1Nl*PGEw}6yrih
zX)KgnS@^l)%Qqzs{OT&2)d9W4t>=rX;3hh;n$!b|hx_QZdDl|^MnIf4_=@t-RngJw
z;t`61FX)U(#mlTOrkB^OgHz-Px*QmT_$e|G7$01tfWZ}#<z;$LWVh)Ogcx@FdyyjX
zFW^`B8!xHf-P;E;Y7t-`f(5VQdvzsdral;I)9BPKqM8=k8k?YEV&8NdPF_gXA`Wjx
zxvuGGt%5+jchfYp(^ApV#91;DRw%_DqqevDP7Hb|NwFY9d&5I2q_|=)Mwchw%Q@Pr
zsjWDPw_MSG2%u0JKNu<K>@lVw&RoXkaMC-P$<I<^Yi))9m(GpD7>KCTfnu;(g9O@P
z`8?dvjN*cImNjjgJ{cK%rKBj6-mvC|$w>@LDR!kWuunN+IaI^j9RS|pW>HkTCnPG(
zEY4Kqmm2YgxRSI4zw9VoH9kWc=MD;r-H;UC{tr_*qVj`4^CFD9m(lOjdi<R_Yl$Fw
zpPVMYOF@5M;H~EhT4(pZ36%hA#{SvFsu;d}p&t%ME<+*75{0=O5_HxvG>K9O{f^1!
z+}{f@Ok-Hq$KOlYW(^})Bgvh7<G}Vjz-upgmP2HGp<Kbf+1M4lFuxF&c51^v1y5OW
z^?!0Vax|O7wSq@|gY)4DZ@aGkQ?Tz{e9fO8*tOrjE+-1edUQg@0whyBj*}@1Rq!er
z{mdUj!Xf@qgx#xw|1<bTX=kuY3msobJnjw$7LaoHM718b%*7ekYsIj|4Gm-7Lr-1x
zn8zb^{CYG~Xs*hCrcIa}4FXxw+qpmB<xaPk(p;cq>y+Lox62=h8V~L(A57xB&Os;U
zk0O|mQ{MW9%azZ<)$IAyk-bl|H4aD766Q0dbJ55qWJl?(%%xLvI-w*!X1{vUwC00H
zh_drt<X2@9o??zm8B9*Y*z;fonomII(>xZrB-uBJTe6xcGFmjm>rm(56Sa{B4qH|{
znu3&gwUfrwy7pWOC5mE<vJA#D|67b3V_uZhU_`>%K}(zksYgkmPAh7@l`@mB8KtEX
zHBR>J(>emF`o1GOD+Z2orw(*~B5Fdm@|y2ET#<j6*R<@NC5g^0w(T!nW?HIzFxf#)
zToVrb^5ie4+AYfeV^@b+Cy)36WHs#tP}g_>^td!6k=JpGZuuh)t+@r6o}z1(1xZw~
zlJK$*+tNwy6J_O(R`j*w@73@)-Z2LW9p6D(q$Ff>ehZ|v%sWbv!@ADIc(W7j$~YHQ
zwlCiII;7R399-BQhc0l=EJDxr6~;%WuDSD5JCO5e*E6=hP|;J9r&#V~-@JqW)&53~
z9mZtGR{8>uezd9!Q4+ewD)s(=CE=4surnVBIHg3-r{z7G(g!W^e-rnk8MdP9+fFd*
z9Yq&nY+Y44d1fT86gd;q-vWX}eP^G?&n0$jN*3A{Zmx~MK5jd(Oaz6jY1wG}z>q3$
zKTj#(_l2d5LX?%;uTn6NXzn|h)Q)wMd?ZHKdT{2UcRB!gzJYsEvbucz!Y(AgIgAgI
zxbH?|xa@o8P*Y$n@4`NuLtV44pAw!G1Bw22qmaQE|E>7GK@)vw&Yx`--k;J&Y=BGF
zy1%a@|I#oPh^A6MKwSb0`5%e<P%8x;3W|9nwrMz<^xpcBo@D3LC;hj&)>fO61St@c
z3(s$=;Q>+wD_pLGXY>mIK%{q6h4~%B-&TKuLDfh}5DiUH1Yxb{&^kYypk|jp9H-jA
z@5d^X)&uPA4Ap%UM}v7#@A!rb8R+tCnq7VGz4{<8K?-*@67;l){y%h58T)SWt3}So
zP1&kl%PRD<wOlh|;UNzsJ9r5!g8^mNYrxN{B2z*d^1APj&)XHI#8xflceE(><5+w?
z`A@qsnrw@1MLwu2f@GU)55FE{%|WJw-0|_iTu*|~<F~9u!j~#-<Y^ar|H#Q7`2(%d
z6dxPgemR>2wz2DmYK3sHg9Vl6<2~*>apxh!O?L*Ho|*G>it`y-qmwt|&gLhs8t7kj
z9@w08in4^L2I{>%8X6w#+3)e62qN+N!kOQ7f9dl&z<;hPdh<zgTtiZsz!8aZcOLEW
zzZVrvyRP;5_s~>J(I+)V@?hRynSs?~)jbFK^S#r>rCIKI`&C(%!386_ZFH+8Q?1O&
z<$bPF?9EA7m1>G_<l!l~5Lx0p#bEjx+vXXe;Vx>d5j#s_htC87A!TAT=O>w(ZM|+D
z?^z?KhPPg;Xvt(eRCf_|^5SE07N0Bp$NaWQwvdeDE^JYUSJOYUY~0LnO*0>|zE}IE
zI>y2=o+wHkWz=6xs==K<Z_efUauv40ogc2Q=qdf$+b|hrNJp>CEb&=BK;vrowZkB7
zbyM?qnx@0ckY)k0H8Z)rLwbw_zUESI@R`7#28w5PI_;@B_RmNhD-)LH6Qhzb+4<ec
zpl@ExJ__>}pA5s*z3^>tm5_mSNPCSq-&81l%_{r%5SOmzyirAWcj&40K!r1TRaDRg
zE>NT=!Q`$b?jOI32cn$6#&u8{m8zJ5%V*Uwj1k|4hJ^}aV$_KBPOMYsdMnt}gHx0=
z@7rz7@hG?e^+8wOHJ@T{f^k<jnWr|FdV3yiGCxU%%cuy69q)LZp1b&GARgEwzxmU0
z#&`oJ?S8)5y0ltGK~I4OCd~CROZBp4<QJc1|2oL=laF>pO37nJO4Rs#q|1S`L>4(E
zwa#`E$7FZrOS%kr`h*0jo@wycocK@(Jwk>lwqF?gh8(qb5A5eHIKs@!2l)8yX+l$J
zYG1%v#P8zd6D5}U&J>uI?&9>MXuWbsOwR~rgnjygWL8kBy@8tbzqp4Q-&M*OG)hWK
ziFDLqsRvz1dnpxa;`ho!kH%ys|1q)kVkDTabvRGsoYurkiXszNyh$<i&Ey5-5S&h#
z30wo<SO$4k$<pxoYC;>x(2}V3HxX<NKplrNWgn#)9;QrH$fRP$o=<%cJ?0ktKxHaN
zx~ILTqn_p3467qX>0iI_>Q1`q<railY)OG1;*0VF!6t{J6w_<rCi=F0wT`%FgdsYa
zq&CNWc!79_Vtz5CDl>1`=6SPA!|dj175ixm=Fsf})0rY+r;Q%Ubwsrr1Kr%<mZF-&
zX{sIN0JCxFeZh{Pi_r+Q{&5+4&VEwm^z)MD=KGxxauecd#&-CBuqaU!jbu+YLU-_#
z9>E_-{PiRO{l<W6k4oYY@5)~&Mw}M*i7ZoU84yj&z)w&AjgMZqV#o*85BSld=N>xs
zbW~nnSIaiF%ES+5+ePW#P{wsFo_5qM*1sZ>?AAASS`<>Vdi@C#vvzKd>xzr5WGR}b
z*F0b~23Mw8(8SuCq&f22f}IkTaGrvmmGA<tG<n?mXnqCNhD>T7-8{sz3yR3_CuJE#
z8rQk-4vJoV)Sw(&0?6C!3?^3y-w5^}odn4aquu{E^JD>H?nf9IB9^i&VotD5Nxx`p
zZapI>Tidit0(4hC9u?El=RpG~u-3w8_;JCz1u2EUjQe1iweTGMsrk2kYf&8ET9FCr
z55eB)z&<xlwtu6`3&mLfnuc`^pJ%u*2D#k27QPk2#Uk@@B)Ma}=y3jGy-*YPq=lQt
zsv)GulIu)LH0rceLmJ8hZ0S72!m)2^ug!D_&itis+i6I#eS>y!Bj|#v3N_#S)l88@
zY`YzlL`yu?<%nwUlp9Y)sV&GpozZ39*ChNNR%lNxw#Z}>XFG1h>T)@H+abV}XL$7n
zn#C*&gG4ul@Mkv5dJj&bR~%VgmcdJI7MqM;&4aG3Jj3V3I)8OGywSe(dlSON7hGqj
zP*;5u84x%v_i~x~dg62mBkCJH^MD$^Kd@4yUS70~Jk&O#Bd~iG=M<YVE&k;5oF6TF
zRAR}K?eFnjmV-&sXR&lm+_S?ymiD4SIrBQe<VKfxeb5M%X0&OoB3qm9EX|+p`m0<~
zG7H<QrJ5sR+Ka&U0fgY$NA)0Wy2twx{|wSvPTp4=^t#_8)MrE&7v1qv|Albc>t3df
zZ^sx??r>gND1<^ZL_;>20)2ne6(6q68>q7fihz6njzr`p_e7<%-MxC*)fH~#Gi?|d
z8o3g69!*|mDw5a;+CNPi1TU9DxN?<_@Svw-xG8CC2c3=eWz2y_tBw6|YxH{D#(InB
z09CVJ_@Zgn5;&>|h36YaDYc*_4jp@6A~S|iq4Kgw>0WKEv&=t8hRuIkgPSBtdh4G}
zDv};KU6><%S2N;%wQr^oj=v}@sj!xPw*=!Qqh$NPrme13LD{}jDZQ?ZbfYXpViU2n
zgG4z`fQlArcJm|)!?)gd-aia<MAB6_&tH#AzDewdr;e<6^+l@p;r{gr8fOb3Hn_kz
z@k2+9HG5WUAW0DwszyhzPsKrUz7m1iT!p%jZ+FV$+8lR<Ad!b^wGo|Wdt+GxZcg(L
zj)zk#3skCzuB-Cw6e)15)2as9NYAVD@NKTq|F`R{`2Q>XYLZk~$A@bjXnl0tZD2re
zz!pCMe4WiV&kc+B|JMghMTHpX#L+cf3yJ3?c*_tLO;sIY{D5iLc>JO@t)*qAKces6
zPBS^a%70e$T$`uePKr%yq)i|H1UP#z)dROF$E7nKtg%!TgL`{>r@9=-sFNguDghF{
zqjEg>k}Q9D?Tx;(el_D3Qt8mF7J1U<V2YZkqHin+*?Otw)LVLaM7Dhd5hywQ1)Ta6
zDCxaTPCtbf(GysNYZ8tha7Vhu6KVCcRz0(~<E#5~+<Cc2eEB0pBJCu6n(*a>5+nV!
zKhLqx80;t+iqx*&v0Nc?U=j%~gqp=ZSxaRqJ#dhiDxB@QH8tG-r6<Vo(?{y|mxuW2
zi2nromLm2Qlt})^=(xgto=tRHQvt{skhm98bpS3_h}+CHWM2x^Yi`LHiEt8oQIZ7O
zS27hSD?za?#;9x1JW7rV8KT}EjToCVp^_1WYHpVQ;>FfehYJHyE*oHY9i=XAM%0GK
z-x@Z+y=)p4Smp}BdW10h;n+`Xw1YPEo;D2Z?vUwLw=!2KE6sbT?ubNH!oJ>v&G0^9
zDY({Vxv+kC&}BO6NAnmI^+=-9Yvfy8?nQ5>-BaHtL+bEv;7W0aF|?EQA4Jv(!{wrt
zW7{afK0ELTmFLo&o?ZhPluhNvrVvp<CQ#gyv=?*)u!>LEYf;o@J~^q!Wcpr^dZ%HC
z7CqF5s(7Ig1lS_`+t_HLj;QGmEJswd!$tST(3{4~>dcOxHq?9urc*jjWwJ=3RK8@`
zX1l)_xiu*6R^Y(^bMy6;D1z3$x=b6#Y;`npurMedXcQZ=5*+u}hM6ByQ3Dc$uY{W}
zEM<<S$85D+9t8G)?@_EGqo-tw5y4X|*;S&(dwsL5xuW9U=j(Z&b#z}t=AFx_Xs-Or
zaf&rg(I3J9sb=wWAx<0*9llKUD&Biho?BN@A+ebA@;HQ-)~{sg%fc2c$W67rab0cO
zW2{Y&QV_c2bKhnf3_A+xd$sH==-W$B+Z%8(GWw#tvC}V+Um5N7q2E@o<Hq<T?fWaA
zmDgf@RV9zac8Fh;^h{oaSbd}+^DsR4J~r?>Gx^o^Blh3?kIK2;7Vx^<m?Vxtxjth^
zkBaMN-BmkP+QX<`O)Zy1K=S*qcN(zA``OJ5ZU6tr!mlRHIDZJ^xv1)tFwVZM#w9p`
z;`jMWWqS6Pun-BWb*m{&&3^Lbn<WEd>S*3|Xv^P!1zXmunnS6-ADs7G4$$7h=btvI
zU5-1x^<QXONwhn~Eb&<Ed&O3BF8-8KM{*C+t>trcxA;Vr4@wA#UezqgUk&O@_|`w&
zJ#m+0b;B$~K~(jPtboV1qozd}=V`a*zZt8@Yu>+#_bewLHiHcT0J$$Z1=@dM5GbP2
zS#_;6!E!=NekWjJpNr0YPTaFRJiJfzWT!1ffuoUe=R(?>49RdRIDj@fvR;JVek&eu
zZCH+C`XL}g7n}A<Dch7B9%nIJib>%qSKuMJ-dJe=-+TY}<Lr6jo^to#D~D@5g(r>w
z@8<_z_B_B%x_g?)BZe&4686@-Os&}$!L1jtQ=_2At*vB#y2>blHcanA+OVv+68!)C
zQYwCf-9^Th)Zw77u4#XZL#8{cMUGQABo5o)Fdj&(9s4AJ^w0T=FO~Ek8wcvkFLQoN
z(8KWddEn*metW^TQ$hu8Z6)=lLr=a$XQf9XI!j8}O`EgA?-f)nvTe~@;V0<oe0trt
z0o2o1%#78<_~F$aMvc3qY3UTambmSmB1m{xd<a5j*YX(6-umT2n{M$>beTWADfO|R
zo|u3U#e%`JfD~2#Ch+VvK96}e&VgsUPUnXbuSfk1InVoRDFx^}Li3r|lG0Fe97Itq
zhId7^z?2Ot`TyY#Q+w~gpQEo_eAz*T)-vtoJ`m~C+-#`DvR<0at;Poj6y@_2mnBNj
z>#wc^umjnjyf?k!q#QL-EnYOVJ8K(b<oyA;EGAnD0eHI}%Oso&B@LO6CdJ8Zg7pV8
zKUHi+)QZJ$O;crbUWobm;-`7GYe7pZEgXK{kT0ihB!j~xve*-`VItz_55JXtG6@mq
zG6hh*G*;`_k$z8i7(@u`lv5!T>vt2J7lF57O}FNq2f9yU#O0H5`uUtoQ7T4~zZNSt
zGOoDFpl7vj-6d#lq;T8|-Y@V|25D}rz~~6Z3-`s`0wD#x!R;?0mrDm|9s|+Mh<*J#
zbjGv8-GO>yFc~p^d#Oydd!hk?I$w&cN}Ga|w1@_Le`sH7t$1;@kglv17uP<3q^1;F
zGeL|j!}CVoRyJ1MVhaBN`0`8Et(0dAd+WPmv&_9|leHgHIdGVT{`LzT1a2Qf^~GQ6
z)Zx1D1gjl69?P;n@$;i4>RY8G*Tiq|so5vsMY+XfiPpQTA79a1bF^6SAE)lh?Nn;J
z+AlrOlE8FtoLQGniWBx(=7rwekDm)*f7X=~KFLDaQK)18np5_q5{`<i?kZ(0BXKV}
z)oxO~zrPKXn}r=uQtxS<OhPx;N;q^d0g79FIlUl$vv)!IgraW>l!fpGQSm*=7X83e
zbF)<)&C9a#)hdM2&OmOfW3x6QHNw!Ml1DrX2xhM%s^}z3v965JaQckxy-$Ds8~K>j
zqA{+%hK%)k({Ov8<?}w`@gMJxvxm=D#MJLrbjB$C*(w24FBrL=ocXv;EkOsP@>}%-
zgF30C%psSUZ3t#hB0z0LNcrsHsfir)=J27?NX`Go`cDGJ=?i~8y0#Lkn)k`szOX9*
zh|6W!Zt_m1yS=VZ<+=S`a34?1gPKdf(Hx>`d@=Oz&sDn-9qomO9k!1RlCDd=a=o0F
zE8uOo(_bpX6CKY2It2T*L>H?s-`gJ-^sa;2)c*Ew&3n@lUBdS6xeS$`WZ1iY(80Jf
zQq|`+dwFioJRc^xKtj=U@x?be{(|5o&gHh+d4U0w#8&Djs~SSIq`A&xr|foJ=|j+)
zF~J-%8aicOBO_*L$ho$PlGncit^JYqAFH0gao8fV^D$dN$p;y0Ce1&|HQL+p{ww<V
z%G9?>kF`1H{w`{O7wmrXtJYnjqYOFCs{N8Yvf8w~%+{FAzjbFlcY`LD*RIrwn)9$v
zqGwx(CZ+RK>a@N^zs}ac$@#&tV2j3?gG1M6Z88WOAJ)s0chr(h+N|vvEw)X=YEkrL
zV1&ghM%(UH?a1SpshH)aT5Zi%tLFnhzxu#4x@^8(1>396?d-~q%h&+_^i)lN>-?)F
z{xajGYYJZtlq1!P3^kzH@y(7K4sB*ySH^w`Ki$wuO0<f2J)Wq!$SYvcnRz$3pA3*I
zDVS(I9U%Lu+hwopiHUqpQ`p;j7Z_G<uNdy|YdihW@jCTvn7hFdqIv4+%m7={3iNVF
zj6<VNtaDkw!Nd%4kz2v^gG-3U?BUw_8}BEud7x_JL@J>V5w{{o)pFKkX5`Kc*^l?9
z4O&xg0-pVgo~;L1X}$Lc>>l$0aTv{F7|%W`Ay^sEcoukByA&6rcC1iE*YibT#~18R
zv`=%?zDkzdbySzU(7C8!g+D&2W&ctuJ{BV_D<2_j&G17B75WK%D-eN7rq3itZZ_%u
z{QB4LHXC%|Z`s^vzl#N0u2b;w#u+iiS3-u+H}mS*(FA?)wP!d<VtbUbQg>)uA)$vQ
z=}|-t-M=y(wOnbwMA!eF13rYpIvbKDFVV_BfFkOadJO^V`z2h%!|_W>#|Mk->f3TF
zuazY<v`i#FF7-SbDw3TfcvIx^%!D`pKmwkkoQ=`8IJ3X-7B8#Cnr7qExk{pmQh3j=
z+8%V-QLgbn7KZO8xUIL4GZgUhi!&+=0sCQ+$?*fo8zJ|bjfRaq&F0T*MFEqL;rtg4
zOPIi!yOh!*Zz#=56mY1rG2UTtBANb9!1?A@iCwq>@4Tea2Qf2AV)J@ap5c9|u>d3G
z2qECCikb>wTP9dwy;8ECzh*xrW9crI$D{svpJx3G!ZYXDR_UD2o4hRL&9&;vLJR-m
z$_qPn$V!y?$JP~}Q2UT#R_cS3_J2a!#1vFokA1aDz*7+V*@j?9hg7U8Or(i$bJkAC
zXnriZKrq4kTx=>ZcSS?#sXzGSH?CwSEUq1P?X~}m5s`v}WqPy`a_}`ks2o}yNz#tw
zE%KP!>~X%vi6?9y^_px@zrpX@JsC*PjYoX$U9Ay>;u;H&GmCr*J29Ox?j=t#|HQp^
zUQ!kx-#mX4V2F3LJO-6#^ARBWr=)_61=^h>5V)4EK~plGU!nBq2?xRO+Ar$VSuT>?
zNS~!MM}4e=>qzV$8)>5O!@RAO#?n9xkX84V!={ROc^(^6Os*1JZrqZwXhM1S*253n
zgG^b*5gualcW!CP)H>)A-775aTv=Ba)hPF)oP&_`NxPMg(wGX+|E(;54!r<&OM2<;
zJg*qQr$3>I4tLeS-mDZ|5ZBWER<|BJKFGh+ssUf*Ae7jlX?fnMX88s=$@0A(<0R&>
zH>#-2Hh~lKDAp|~4ULIvOr~4)@nf6AmU2pV=Z^p!xfn>Ihvwry`1Q)KjAHL>l#9yo
zmxM!KUF7YjQ1l8__qs8|F7}1Wo^3*?DqEAu#}%dB5zA(-R&>+cG^`c~men<n+q7Y9
zPxa~305N$%!EMiht#0Pn!2S=7HB}CRPliO#t&@lExs0mc1*Dh403VjcufLPPrjMJ~
z5Rx<QdmM4^ni_HNd1%#HT@?|b+a|wqTl!??ccX<E-fYb09k$GJI}9T&9G<}-Llp6&
zB$3>tv5zM_;IZax$3!_RYOz~43Mzczr)ly~Y!sY+=6f0$rMg}96K7*%JAMKq+WFy=
zVFerdTgcBzBUY<wNWf7{Ga})i*0ju;GC%d9Oo!s937w|#zSY9JC}FF|zinlQoeJ<p
zw&tMQmT_Zg6;YE+LTEpKF)tfqoxg3quqO8DoqMr*s2feXWdB91(E>>>j_|XtIy`FH
zs3Q`{I9Es05}6`^82vg8TIjsEZntAS;Z{!)z1I>+B7D7JtqgyY&>7m0oNMZzW>8yZ
zZ}rZI${X6j@vmV_;IS{9=scl7PE70Lotz-%$h+2FdG3rh(&U{VudxfPZ5fRk6WDro
z&hdJL<xGsJCqt#p6QLsW!AgaV@jeuFN>Zp-t?~|xz~kg{o<TQD1_)|#OZ(57%my3)
zjG`TiZQ_<{KDka}CciA-`z-p>hxUJ75$3CIf|Y7$cUJ-J-~U4tuG2Q884FS{L%%sb
z7cxyMrn1(duRhOOd2B!%q4?(Phpd}D5stC-xcu(x_zl{Wf|BoRYKP+e!+y8l@~fbL
zZS?KDPLhp>2MtpCJHrr5y<KE4w^4EItI-m2!-UA-ti7)*$-%5l^Ydg{=qYfw7ta>2
zdGKI!wZy;(-DWhIQF$$m*IpO<VjQXG$^s=xx>)PZIe<?tLU|v5uIzPey)Pulywz}}
zf_HbHc<<Yx6&%KyG|0qXEUtSkTJT7Qhhxj;8hKerc6LB%pIJX>1k5X+(9&VuN%rTE
zd2dq@7J9!iJQDLN#GJNx{7NsR`-x>4?M`4%qBqUZ-FWJsPMr{c>Pa8bzeC_#6{jTx
zWfsVF>h`ZEfWpgDd55|}jZmu6(j%bq{trp(Y~}-}kEO@Cq43e}VdyYtr!2Kg`(3-*
z1>_&h1NV_V#vAf>cNBX-d%FKkwrHLS2^p{2t$H2rjRIdB934h>3M?13%}f)3T!Us%
ziw9mKBX-ld9|U)?nHaNuNTb^zq#~~dV$ANU8pO`SFBhJKxWc|$_%mfrnUcB4Y3PH*
zT0eQ`=Qz`$W$%9Lefw`$)Ex8DdDG-n`W8c<gTa4%_gOuDB6_nY{~lUpGF>B|zRe{Q
z=jow$CM-RylUsDu0j$qhO@EP-mqmdjqg#B(di8(S6XgTg=8xfYvUA2QodV<id6XKI
z9h--)8&<U-r1K?_#$wxDkW3QMic^#`SmZ{~plzc2CjX({X^5k;TIa|-NW%uSGTg5&
z;q`Q4$qxB<jPZTHJqI{|720O?=HTV!iG1*Q;UqlXE4eFPN+=C2<F~Gtb{uzdJgG7b
zO`QQCqmiWM7%J1vy*hjN0<x|qU3B~adU4{P-hZ}!x-^Vgos(pzHnBN$@b=Ev>+12R
zv#*%?YU<FNI;%MHAHLh-X>~|uG0RVYSyzcaR`WBdad7a=P;1z$<FwktzV4upEF-S{
zu=}>V>k^*7O{lenr{Eki3oj9rFj>fOZbSZab6cxRv#@>DxX{*d*;3!3HaWA*%5V#@
zgFgN0i+)nbHG^#YlyDN{>TU0Grtnbrg66{>JS0$0JQ!cRd_%qU*bm$V5xur98m5>1
zwP+FSHDIJw*cI3Avy>AajAzTJMHed4w#)P3=ul(q$A-T>goNOk@W?pUJ*r!_8Fh)j
zQTlYPK>=gBk5l5m$E8%9F;OZaZxFxfXWv`En+&D2b*)n*%Jh0}5GA}NIu?X6k4gt$
zj2kc{zgpPkoA%mE$HDOInW=vN;N*cT_qrPQW59PVz5Ch&JpH*~9B04_uif{-ZBa{F
z$>l=atE(twaav|%M9Eqg>aXhX0C=KGHsN(pVFjz%x5S0%%|>vW*F<(aKHKe1R!Hym
zbswzAg-hm7yNr&?9lHN0Cjiui&i0UOlxsE@3Mg4T7a#IyPaWy-OoodD-|C){)wxa8
zX>?qaG}FUMG#9WH5gcr>cFB2=8o;0P_{=TAzMn>Ia_9QULaV6Fl;DMi@P*IZz0=h4
zskg_^Zw=YI6`uk^qa>q#65YPv6h*f@+QIu$GZ`;ZpUZ${1p+H?gH3I6OSl29N{g>&
zpNW1*XcoE)P?{Uh?PKqAXT6I}`+V6i!1pLBqmSih`#fHJpX4Vn*r}Q6uba;-{D}5>
z{tt5@tr%9af2Xk3;YBCpKs$SOHfM|#LXOvv2)GMdmZ7ul>Ar?7o*9>svB+gZ=||ma
zv%9;ygjE$`6P9sBfdAE9|Dwn$%jjqJT}u#U@`^;WQ$YB3!~U{0;K?uMhs;&YQAPPA
zDwyr0MLkUENIuAfn~o`jVF-BVdrsUGq0OXIr}`}&PvL{)LSvN`<9yLT-N7lbNSO0G
zaa=s*nhm$0jhxtK47*EQQ_5t+%8Kko#2&%*p^Km`<!H!Z2WI)K4wvCHH`GA8Z<UTS
ztoPIwKQ6{T2<z1dOU%@TcQ4ab!|sdttlna!IN|A+z_X+41zNWln0kKeM_HYZIeE_z
zn91&RlokRIcA=AYTXV@5XY*h5Y>c1GvgUN<4SNFlmIv`qnm82w5^^S2q}7x<Wb)<`
zUZ7bz-0d+mB#@s{M=<QF1>UBAJSG-QLl+WQ<Nf&PN3ov&DP5ilLZwv_q{%RKEp!?>
zEGA1`>e*NW;WDHvEs_QsnUB!Du2ZOPYaA||q8Q8vX`^Ykce^98qT<@q$j{t$V0ZMb
z%>YrG2P!e%^sS|5AYZmJIPAgdw|Ri!&o1)1@JWDA7pW;K1bX1e%48fb8cq^)|9jQa
ztryAe2OX@ZlR5LaKNcwJlx&J(#b42n5?{O2zl`>Tqf^%qOI1PbRV{#_cOd<yDujcA
z*7u}t{Hn72fi@&OWcu9%-2|a*754==Zk6+RvjxuMh-Oq=mAaG;+r@^;D@KkCP6wgk
zo?g3QoIifiIb9#$AN|;P@c%IOmT^t}|Ns9sYJ|Yp8)-&klF}U#N+?n)4FZA+Nar>h
zBt_{K0Z~FiK#9>HF+x&eG)QgafU*7e`Cj;4{$D!hT-j~sY_HerJYUcI<MG&Svgf<y
zdKoxO1jMa0*Ijwp(B_G0wChTp6+ZL~KN{h)Q3MM9)gT@6*nIpu!8jQ_1{WYy+%Ysf
zZ6lpGH-ThBs*`yzRC29mJ^-E5uX_xc37Hu1-^mb)gh=23gk%1V<%{MV4#Mx=g^grB
z1)X9<^(ZUi`tK{CFZ#RhQghx#1d*LVE$0R0U!FU-8NnHLzQYFo6G{FP3@Ppmc{xZF
zhp_dWg)aU_B6U@Y2`(GotZND~<x}{S5qYZB{KAG{1NOJmEqD^r_8*_6SwY&jPWlx=
zKAq{bn5m3mjnwTeFH%%Aj&~u2AP~yTrG|bOKxr@qNZel|nRDo`p4TY3&B+{`cjfWf
z^-n17w(?0NzWG{4@K5by`|>Dg1bE$z1^up48uMhwy4Se7w`zSs(SJT=C%!l}+Xu7y
ze*RCwDt6e3Crd;~I1RV<#K00ZD7@ZAz2qL6l9pBG^6p}z0?cc>8L-Db1+pjyBOZQ9
z$G+{glif5qyifR6hzu0q=P;NGO~c5!=0mtJM5ZRa#n@IFOP0_=xkGdwkuHQ~mmUn+
z^)ddJ@GYiiOB>&+QVrH@dbcXixyy_^@b%<-jhwOtV7oKF45l_?1m2*owv`C!OJ0|i
zwitSsFW3AW1o=10`vU@<9k<l8OK7f=ZOVXOuMNWz9!Uk6@8V21?6)UCF`@@n;w$29
z&pfhMnwQO=uNIYVY>DVGfALIU&V!AFCVL?~szcPW3kCOKTmOsN0Kbxu0AB%#;;QoZ
z?e%?WVP|0b%z{qlJaVFt^GUXR_)wDqET&sOR~JX%85jIGgX0>*w`iRe84`iFp9&si
z#MaE3=k8oK+8X56ofBwVX2w$J{i06kC->28eb25?Qns9LA^!0Kw^6soiioQSZc6Yk
zt+@7ioh$y4f|JE|3OUJC_95*SUq?jbLbE1di%!}8t$l`XExfWlHh}=ly3{AtuK6Jj
zK7aPL5$e%lTn1KdPrAS&KPB8_I4P5gVE?Qa-EyWXR_7xFLiKa2^KPec=Sw3z6lFyt
zjsE>ve`OiE+{s7b{#4=qiZPKofRJ*ij(yMW4<&Es&}!ogpq+1=3h*4`=xGk5oU00N
zQLUYil~9~<-mEK$Z*H&41e4zYS6XFE;W)jgA|bf2hLKsvU7Qj4qc+qQc$rNOFVyfU
zL%w4ezOSr@YPd^*0||EYI{LB#RzM_=DeW-*xb{yMN5>EU*qvQdybxid^;{8VN{U6s
ztV%+$`SV|Ba9=2Ong}X-yY-Bhh>uhAu9w-RZd|?;b@h3g*B{OVa$7>fsit<6U(9nU
z#xQS>lu$;oF+S*Tvc>m)L%05%HopvU2RVSKY>N79lfLR;e47n+0FJh|i8ZsaGROss
z29l_FT9m>MGpmgEjNEYp&`5!|+N8sf?2~K1)K-PXHrvpwA<Z;j%PSX>+Yvtl-`+YX
z@!KDwQMHP1+Wdib=2Ne3c)tc;-$c?6!83947O~S7SudMEowUClBbz|$ovQV(Q2u@F
zBcmTs@Q7%OOJzr^@|oelhmUm2lgyr+hg=KE#3QXJEPlSyv3xCUvLg=RiB*k#q)PnA
zttcdq$kQ|VXFDAh&7c+I<d?$RroUMoy5XQKpxGi?`{ljVG_>scy8Ruw^|)WRYFWue
zyiu_icLCLHok_I>gab#l7knpR(SE-W9_zrBYkZZE;-eC{W@i11`G>-vagQu-t8dq8
z!!jyPVp-R$To}CSrlbU6gAu2Ei<z=~1|3K`3@`gT&O)cW5cN!^_EH7$$i=#L+i-u!
zIYUn$Wh2q-pM2KPmABfReorw0UaF*lthg*_EUoLEtXFu$;0L2d-}!GG5PYc_ob+Pz
zpQ>3ciWz`ehkI|59f+e9Rl(WD(`qZAAZ<%dRrRe)L&1W$iPS8P@A2IoKE~vqBGeeD
ziZ@2n6rqPJ5NaGH!RTIZM`gdeNd0WY)#mg#hADoov$aEh9Gb*uBr=s@y?*DxhHq@Z
z3lWNXv^ZNb1K%GOB4rW?otFKS;;S+l1zd6N);>!rz4>1cveZCBmA%x6$Y=VlMt(zt
zz)R}-;u$i3D*+432)7-qgZ4b=IS3GsBh+dJ2zW_9I)Fe6-sj)v6<Hu^|9Y5X$(S-L
z-Rqc2VM)REl68avmz#P}5KN%j^>d9FmB)TIMRy1eod%#8a#F6%`3t`K9vbf<YN<D}
zT=^MEB=4TTBzoBJ8SO^d>uT2xWiIV7i^e>LRF@6(*i!&7N=~bCqh;vW$Qp@(Sk`si
zV5`G@`(*7}`h=1a(XYuzE@lM&6foPL{L#clv6BdOm5tSilzUTy-KbYX^%<YcUGUCw
zwTjreVTm1<;c`;kful(cgMcqI>CiKYmRBj0_IgCr@4B&uwlpEZ!Dmx1JQ`YXnd(uQ
zG|s~2QKzow{MSy;NN5-jYa?S5!==D{&uL(tXKTKq;0q^JZ{i2(UktP6>6@EaDj^p;
zUNr7$W|@(WJl}a^o`x656X}F?C2~BGS<IVelgZxfSh`!Vta^ywV+;7_+#qEoAtGtK
zX4^^KWw?L?>DvFTf!t**@ioiVAEsd=C7I<7;%_jM|HhWN^C7e`t<-Y5tx3M2=Ki{?
zurE$7hzyPDQ21(t_b)(k?%8ZP1$fcNxz~m-^RrA_K{qXUIVjPNhG&wKjOgiZgoR7G
zCGNRQs*FT^mHtWR!T<`9FC|O4`sKfrYV<sF{M>B;wR=K@(>W+>_-t1hS&5O2yu0Bm
zjyDq@IBMR^W|g)~m5dy@nI>tFmGDJc6uSHrCC<+8)_DpX=_)ZkYX^IdyEl4?tu8h!
z7;)DK%S?QEfeD6Yi$b9s&`p_pBw*ZQvwAeeMGia7u73Qt2|8ij*HV&Y9pu1c$ib(j
zEjX}oPtUWu$;!}Qt>yNh2RoG(M&CyuYiStMTNYPXs`pt$J3OB-&<R1@dc8>%qi1Wc
zWI#hS46Q!z1foI*rcPcQK%`mEYce_lkCy4!YWUx*+FEBcgU#NuRS)YjTi&SR@veCm
z_QnGstaV2+>OqG4;IiCvVn9|!v^vUL`yeflfBij^(6tV;d8#nsp9O}uWuLLlUf!;w
ztjZ#98}lFfpT~5gidf(>)XD=%$Lk^bGW7(5d43*^Www*a*oRK@V)yz)WyA2gtxIa&
zq_ysw99%75UrMy(tHU#%PZxk+wIT_*BR^sp0VJ!DmUa|8t#Svx_7m{bJW-K=69{O1
zFFvm}VT=0Bw3{JEbPKd;GRi;D#+2+7e2^^!vi^#m()Ea_WPbqIi=<Py1E8ct(K1Dl
zg$bEJei{G}C;`$C-?628g|U9DF6{?+{1ssN#Odudo)m$hdQRzNQXQ4viMrt9LVi2U
ztAaFjF2+qYB{a3eNq!I6XD_~xQZ;o&RVc_#v#%rq^C9zCnVoa%EkpD7!4JVF1Q84%
z;wGKuhbVqJ&D3@xWkJeCe0d&c9cgLf$ot8w=kaT&r}$JUr8C>?<EM>Xw7i>emZzC5
zxu(I&TE~>XF4PVF&>Zvy#CQqRuW2z1I9A<e*ozfAWcmUTv58?3urV4Hm}*@pfbfNQ
z`Q1ru=I55X>?@h7Yln;I7@l>8q_qC`A8e#WN2`t96QBjy??~c0m6LH6ZHkC7wFTO3
zKT<dB>{Dkz0G;tVK&DJe=)=R|Ux4dBfYejlWmT`Fl`r@xk?~hG!#SqvIv}NHL*~*U
zQT7S4DX`ose+Py}eJ+RaA8L_1y#s4f@rpX*J*dulvxy<tS)JMfz)ctC_mb+E>2nJO
zEDtMU!6dOjxcPc1q5~PGvx`vVeqyVZFU7~FKieoLr!3qZx83<7t>=+Se<gDJNqZc6
zpxYp%SCu{AyKa#Ej&zT=_o`*;|19zkkCt)WD^1^mm1}P3bnj2IDw^|w*c#eY$LXf>
zja-rCErCx24()(Pu3)nEs1Hd;iv5dLM%-cVVj@!D-2g>%C@KmDCnog>lYe%1v!zDI
z$a?l400cANT+UK(;Yb^blExNpH*O;Io?1$jt=E3PRK~)Sds3K}AUyp<LxtvJq@j=h
z2#I#p64gt&*-6g!CU``3A4FDbvH$9-b*zFQ=@*Br!~E<Z4YNnZu+No;xX1X9;_ons
zmxg@baoW{@3(;<TmZIq4lu~ZNa9q`!LbJjag3BZJ2D%}}3fuflhG$VOOK@)Pd|B%H
zDauaW*FCeeDJK!s)K59j*3FfvezpT8mDUOnYPkkIC%SWbx_>Fzq@54tPB7M)xl*h<
z9Da$K!265RA+~AfODp;>5@?siDch5>Y9gHll;SpyZtNr!=eO5TE=@2Vq2$67R@GBO
z<eTkPy5J=(gNyIEF?_REXYR}C^Rn0AenBUd1quCsRbab}>Ph0hb-gQ+x9qoYQFImb
zL)7mk^YL6|S{-N58T8DKG;32PQO`q&S1%yfI3r>B&$9u%S<%zuvlzO0<DMl;?dMlZ
z1pg#P^^vt<P!iNxUg4U2Wh_@6PLg>s9&ICJ0PGERF;sR6E)^WP3V_H(71#B|K_4;F
zNI3-HPylv)qQ;+BI)dGv?W~a@3M<UP(?3D76Vq`GNm#Tc(sIGm?&cjRM5nmt81USp
zs2APc`_uqHGgYmdl*mdg`l$8w*IYm4i*rPR+i1`MQG`w`IdI>xMdhP@_u>7Y+|Oxj
zEOWmrD9>kI;gMNXo+O%OT5>*DOQ&IOtN5C5AragnN$<b;=(}JG;J5#_+}T?$&Qq$V
zJ7?2kOkp2gf;}nG15Iz#D!^;4tVf2&9gXQC&&QPF{utEVY{|EIBb^Z!=?0j$p!u?O
zPowp?vt(Ok5(Qf@$SC?`35T9%T*1t6B;E`>EnIj{jJcp|Kz~^}dBx0SX_?`^gEIN9
z1CqN9d(Mlcz)WUdHq14eh^n)JV^nh2IR!TNH7OZCdn~DY^}$08Nio>%6!V@z+4x9%
zV_A<sF!&d5R{WV&l%F~6KM#PAFD~a#@K5CsKECJsu$}!z2Epl0h`H}{-?#8xY|zFt
zs<|!|sV%CH_^YBu?o%8A;%bvcH@agEN<S8>V$(?cH(IdsV&H~458?YL;)KtRk)_+^
z=;+8fK{1XA8ZMrnB8*uJB@>JntI7=jFyZAs#;c_>d;CN`{jiLm6yia5jEoGh?|GjI
zcE;xB-;F51=B-i)|65!AGI8Xy=Ioj~FZd1c*QElw`iMfpIn=fvu;gK?(Bb5xqfLWj
zrhi>1em)lqN#oWIQiGtMt8n+IFuM1KJ$V%*p_mpI_&UOCE9h)gGYd#$U{M}Hw%Pxv
zP3rEm7s%^Z@K5YDrw+ZrT{^Hmws6qidv5OT3CBj?)`K_U+YxQ6t^p8PM62^)<vD|t
z&8ig~#-YZQi%spIHIdK?A!B)n<QN@zC+~%cEw?t!Y+n_mlV77hR;N(050JbB!-L3n
zc_U9aL}QtfW*RC-D(1}QZ^}B8plG@+<N;puBmgyVQ7?$@WUh)~sD?+pN)wNFFv$uP
zk+>0W%I$k)e`F^>0>bPdVIZD&L47={HL3Bg;ODR2R161SJN!1?7$Z8Fgt(d((wtZ8
zNaF=f=hsp^$hYLsW6nuNWLY7uPQ{?%Fl4@s>?@|C60EgdB&`FPil@!x036;iChr)5
zTA1@Eha<x^#t_<}Kt>^Vzu*|2SAIoA0Iap&yKKdK#qK_iJH<EqW<u85y!I?<N&hnx
zKRl7i^~3okDy|tufI$pH<6ettpQF!dzBq<GO>@N3zxJ2nt`#q%kHkzS<io7(bUVhc
z8=TR$lMoQotqBbxq?^Tfu+x&g6s$3pHZ;2OU)M%+jov9B`Sck4V7pB_jAWw(u;=_y
zu!w|q#kGx-w5}@1DYYZ*B5$!rCs1Ff0&+cKV9VLTWl(@o+)KsVLa9>Kdi=HCvkuD^
zP9~C(5NBrnI7-KDVEg&fs;V<@E#tGxC%!mL+r)_z;iAgK1n^?Z+jt-8u~fvN3{o<-
zF54g-ZZ!M_4K=jh`;`J)vC_36ssf;g*x$cv3S><M`H<{Q<1PM?<~R9k7dV-@_KZ=D
z4(~}-uRwqQQ4{QK_2gBR{eZk}Gr*5u*JUblh_UB?%<A%>=cD#p?`N-|=g642gC*Dv
z;rrXAN|EbxAeD32r-$u;=k5m$I3*0@(T4AeJ(%+#bH#efS=~?d@3W4m<?2`8xn91e
z`4xK_zWvtuR8@cyoENYU!3tkcI4sxoc8Gm-LL7W`(VbEbp(P^nSbZv;A{8fhx36_!
z^!%Cf5UI<d5n86Fy9UN@l#y<kz}C@<@^A9evaPcu9O=#Wr(l>{m<}$e4Gacd9+}}}
z&-`@=Ry6P+*^w(gpken*r6GRb0j44Y?C<3O<4jNAr_u6(U<o4u!N?Xrvp&6dtD(Og
zw4xbh*{Z}l-~2ZN<q~Wyr2ZR3F@FP=&?(EwOrdLj2tE6Fc2P#EH@irbXHakuD`0GT
z`AsP<9`$_NsJ|SL`Ab4EXxYrA*G`@3bi?>`6(OEJS^K-w@y&XQL1L_s$Gz1Q*wkbl
zY4DG_9jr_-N1HNN8>&3gnyJQiow7L1)R_gH(KWB5B7Qut27NDTW3zKtbXA_Bz^AS{
z8q2zk4D||MV6cZG9Mv)gi77|^It*2aC?d<?olS1wqV=7R$QNRCH82FhpepA3r#mUu
zy6}gkHgR7)7u9hMy1Doe7phEsgx;~Z=fHzf(f!U39}j9Iw%j8S0YZU!(ahYAPfHGP
zZ)XjhhJcDc_U<<5#}Qmg#HbpU1U5pRd)@XvQW6|Q9>Kw(Z)1K0P+pER_Vh0;w<P!M
zMOaCA?LT9>d>f+e_UyfAPf{dpY^0K^LFe`CFv$aPvKs~6MnVP?PCDR5-`IMup6$xL
zBnhu^;j>Ov3J-pL4QOu)Xf7;KRBx1@{!rxveuc_#WpapVsWO$7BUd?iVr2PCrMKW~
zT#rad;MTYY{w9WoOV=s%q`TkG<4+Pf>|m&?{oekke_@cWFwUOW4a0wQ{)m6OHEI)h
zIKR0n_^i1a9k3k&B#mwVea+0JPYRL#MWOV)=H@e|PtN5OArc!xHgyteMooe^t2u63
zTSUySPOC1ROsaO2tse=_29Oi=`leeI<e7vx$;pN#<H0xG*GL^jWEqZ~=C^tn$xJda
z_){v~V9_wVHxS%u4Qv-*@06&yUc75E(I!6Em;AlFL~d-0wA7x!cb6>bP_Qjzasjxv
ztGmnq8@6n^>Pvw$ug%S?&j6J{6qU$@2S13nAJjI|tW^1c?3^}y*UB|wjc;-CcR>%u
zD4I$d+Hu`PRgg!;Wtzv%E-?cIsW4Hy{<)r-ez;8y-{k0eO}qUh%kyzI$QMNO)4D)N
zHNQl<m*g{$GuIsu+v2~3&WsDhzNli)2^Sf(WSmIvlEV5mJAHE&aqHJRkHe|O_6`9V
zk7^z!Cof#}X7e!O+c;K13x%SOl)g~F`FL_p9#-RW<;d(@n{g~g*LA5}a~tR)VD;jh
zlTx*6C4z(Ps->;4PpyDFv(;+3ugHI!rGW&tuL?+(hoGBFEPK5Ppav}SZr)7wu<1IO
zypDCge){|u$x|ImW0!bqZ!7wHaLc@CnVi7WtjNoazbg_-roC+ilpzgj((?JQ?I<US
z+l!aDMM&K*giu)F!d83YGD7o2$2lZ=8Lx{HP2W-@TmNu*m+uu`SLh2E^<W<k69A3C
zzE{}zygOfyIv`VqIu={fzvQ7@wqXF)#~ymBU1kf>PWxzb*QVWQ*MPf}OoPF5uHoH5
z78NeGNt5b|$9eOB#@7~egGYIocjNy4!6gGwwr@a=J&QRYxK)UkNGV4!5Kev6)nBfR
zXU^+A)8=wlcsnc-a=&btYs9dAesSBA?$Q|bZpY{!Hs<Bk>(*cTT$@bn{eK9e6W05L
z2lN~|)ZbaKbW?4mM4a$1L$!jqjpb5Hii3Z1Ar21Ms2>~3xm^crk&aI&Y$YR%@11dr
z<K}^Gdu6`&l8Y(Y`5t<E(=v|op4@olpHLFk%{X$<GR#jbwpZfsr8d^KfqYEAX(^=e
z%Q91fPrthx_mow{RJKWZmtx7dNnRCAer|Vtnbu!|)k;9EegBqA+ilKCmk6tU#HoON
z*QfWYE0>~B@KgTDdZDs6aSt4SME(?IanNK|oO-@<WT%UV^XYB(JCu7(uhx9b0*S^z
zqTCBHXYX6PlCBuo4I93e@M68{vjiMPmMlTyL6xcBzUa#WS_#z}uWnb0<5DO+g4!0P
z_ypltgYCb)HL#kvx0UsB*G)#|4(2I?omxLBq#B@$I!-JhTQKN~LtUSd^UHI-VT`VV
z(b9?#|2A{RpFwe#4q+V%&Obi{pgWyZW}I>+wEswKo}Cc+pUaI!euB^DmsU20jgA)k
zX-#etW;Dg~It_XqqJnSfr!3Dh%2Sv<*E#bbU28i35k<E-PF(82{uVNycSoPUV8x8%
ztt$wEL!L_4ZZOs-KXID*CT;m*lHd~1sqB>$32IlZ{|_5L_Pk()kfVoXswJ4y&?{Hk
zYgiF{)ydO<WRGz3#q0B<HhNh;-}goo)iPo`p1+5`fA;&}$AiCZ=pwjhmZ64Y$-IWx
z=O2qAqH?r{<n@1`zt{%)o>M?KEpDRBC==S;0;&HS*z|D0`n;jN)!fEI4j0lN-Dh56
z?;h7bd`)jCAuUHxszyNc=uIx1cFau=E*FgsXdV7lO<+-7x^uM|nG%qx8aE7;eN!l7
zdt<Pm&l$DzgvQ#cgMIY8z<X&kT+AF@z&2U1QiWjJbLaMwpAgy>9*5%#hLKJ<S7v?v
z7w?LbiO)7RP$ap*Exuc$6Sh1X8*6V%eN+Fr*gA$YL*D+Vd);ur1V;6Cm%t8qyLT1u
zueYL9f)<eUZw9zrYP<a4aw0lz_^Lp@&Gh0B<L+sWM!EZ%rM|U4{TDsVhA~llvnz!A
za>+T8%8OiQ35V+LH-p%|E&Zws;7UCn`L5c!6W}5T@06C*M*W-sC({wDwlzd!hLPRI
zcjp?~2CvPMK(7pDo11Pl@E+l2*&mVN&ke?Z&6|TQl5VU8!Lf`@cTiF9tr2w^J@Q7(
zDRx^Zy?ctc`d9TX73>XyK6JzU&WI|cBez1$TW#VT@0qC=-9Q^Du%B7C-Y_?!0asuC
z6sq>INW7VYOTZ&{={s=ql1<rqts+rVS<}}8%QGI#^6?TrwzXTCX@nz9>F0<yu0Q5h
zigKgx4H1mI`wM`!4)?X${ay$E9~Vpt=2{|H#BE?lc5#cWz1MUe?Q2r+?n?i<;qRyS
zSEXQ?-D^NPT1n$TnTk!T%1-lGe&;|TIW~@9PI<EtvU6J6$Z|9kKajiBYjN;ymK3fV
zbxM6P$kqJx=B@uoao;G2aJb*@H-?J{ynMGIbj54lx#r=xE6wgXqvBD*0|!Eg%0TAr
zZ8h{~*6d|&V1Y*wHXo4ImRQZp_W1vffSTi%J*i`N$n4m0=YlwK%~@|J9>Mtg2N~*I
zeg%!lRM<rMzBn`$Kl>3Z-3Mn(*I16^3DftRkqPvT>-V?~Jg7J;C-@lrbptkzmEzvk
zkcQRi8l5|oP1!$E&;B=l%$mj0ZR<24F(QgvS_`2B{Zr!x^k8lFu{X+t+nT@3{8fu+
z%Ka{%V4w>rm)dhaj@UU!agP!g0gC#HTK4`T&jh|u*&0?irxriG8!wt#Tw#qOzMFjk
zH2b-R+SHdzX>+hheu-ssOTMCBQFpvNrDbHt*Oy2z6ZReaVB^SZOd%xK+QH$T2iQxE
z@1H0nE;g<+WI>&0?-6rG(*MEk2(~lx6XDs<PFlzSic8Z0d36-;NvAwVaV{kjAoz})
zlk_j@#P_mgFQRuzmosVYtK|0;<0E%oTb`ofKU6lTQ;8u|YFo72t3umn>qM5`T48>A
z#gfEoA43sKMckO$yWW}^r6+gohR+UBLEbmn>y;wj*Y_<bddASBnEU%gG^93n%Yz<6
zmY8lzhnIDWk4#C)-tINF5{!)Zw{!7hn)cJ6|7*wprq=oQ%)(cSDm1B;iQJNLpfrY7
z89C}G>#E4C%5ice2IPxzEF{Qs`(%y0TosgHme=KF7ulhH8A(k+^O#+x$Po_bkVTg*
zg@LF}8k<<e;<qU2_fC1)0xOK?K}Hv<`G~*VrkVS@*aG33_TcH+^XdY~elS{DS0qm|
zRS6do@?c(JGTI{Y_jYL8@2+?D4)@eORkXw-$$pkkyn)8*nn3ZNOExl@+iD!vz+>YT
z3EwfEI{9<hK3J#GKsw$<!VKEZ)~#Ner#pV9U|^ukfX7Sm^)UX8;2mvIjrVNDO$7`A
z_u_KQz&gB_aY<OJ?VqX%t8M3iL7!msg)J2GAII#XXvYO?pImfq7@*aMbYtJkzH*W~
z+^PzLex$oCI&YjW+P%yK6z1m~srydWJ-l@kjooa|$4^VvXo;B%8$^LV0PFQW##1#P
zBXzf%gyTV@+?W0B(Z?GNr!BcXuv6cA@FcScE>_OhPpCe5Yo`489rEp_b#ld=0PW+K
zk@QwR4?dRuSK%*Le{Z*RE8nI!r}2K7ZBXuddSU6<yVqv7-=5qI{dmC~c&$9B2Q*`t
z|51hJuJKe%jYs-KXG*gQheVb6NbV>FoD#+P^1aI&MQ7%7kkDsdolNF$z1<QZnyi8F
z4>#g;Y)*EfCqXZMcYjGKG(oo6wVUSf@$O8-N<WVf`g@P2JHY=|t(bzHQ>k-AXSG;R
z8Jnn<JX-jYV|m*gUD|$hp1G&jd38;m#6<0-Y|T{Z|GT+kf2kvN-TDsw&!VW68;>v4
zwNGfXDz_dDVr?OH&;B4<ww|E^oZ8Ab9gFcF{NkRP)y1)!DHO?)gyZVJ%9~G%3VeS+
z;O86)YhNNiRvqa_ZvVMPSx%k&08{;$FaAtL_lWAU)&MD`lK#vUN%#8U-83rkp-RYd
z0M|F~hxqW!j~21-&@Hb^5<mO1H}yi!>3{=o7a#fYD@Fa|=IsH@U41BToSC)!toHS^
zG4S7TSs^-EVdH+!qyzHC;ZLPahw<%aR&fu6_7`@=n?E0p3YegY2Ub69Y)<ydUR=uH
z_n$D1der`%dSlpLm$juLH+Ngy$xP<$r8zRds)*XOxJWTuONCP<r>wK(U84Cy4U#vk
z@iQIA!fyqc)JTmRxXqxyV9>uek4?g(Zh+jmx1a8%{5ie{Wv7alkVTbPK1oIWlzcB_
zZC1heMV}S&B#x45iw!u~n#TeJ%kWnxQzZKVE3o~GtRa$9Z#m~)WH&_zeyUhCIghK+
zcUN%q<6jjO@=m*)UDvab&`;;je>YXfELU^<-VXI|(~TDUF}IRJAk_V|Mds$OS%IJR
zm50u54bherv2(uzCi`MSi_)G8eUhL0{^jYNR-dUx3;@6n)yTFZi;@1Hwg-xnbGQ9}
zSO0%bBKcv1z2vwDe`r;8-qAT;dhH{DUHhLXD|jugqfaj1=D9B*y2Hmv3NpMR;6?Z|
zFp52Z`mvMwA?%BlWo~B?RZ-BIV78Dkc%AluM94e*pI2P!obeC?jx2%*NXRUJh(T81
z;&e9)25LEIU~$3wYE}$m3J%iR`=S&U*@E|sT9gJpW|_SEN3t*+4l<xL;x5aI!sAn#
zF-yI8kI1GWao+0|g;ryQk2audQ>skNFTtDGc_T1Bua1AHom!LCGpUHXDOPZ8<H6t(
z`|)`|P*%eFhLEDAt*qib|8-pC2xAe?IgVMY(`s{OD~X-4xwgou$A-CDZHo!TS#ge6
z)>IHq2Y-7FQb$eiDbMg_)c1U2zrX$8sMztV4CFJ@U1_#n{f9mXVW+Pd_@9r0P>c<?
zB-GvZyv6Q>%wIRHE504Sz)KnA68KW*nxDUJ-1p?M4aSzyBwN^`q$p&*H5t-_2liQM
zX;1WJtAFqPYh&}~GNOF@1w@~iE+7Sv!KGKGXzum<yVw5kMsb!TreQPqSGi)Y9jhx+
z;F@-e<*;B<qyX7fyUp?;3kJNV!_i<&(DpIQRaYpXUvE4@Ob_)sO0PlT`y{aQir{XF
zu|>&Cc5GlW{@thKOGD*xj>F+)Mu>{N?dl%4Ihx-}kYF1#Yghetm*(?2S2BoFFds6w
zs_@y7-GFZ8LPG7T@{WRlKZIks10~XmPzzj$`j|7<H{SHZG^ZK)02b3ibv~kbpTFa4
z>>sf5sqW}!yGc`3CI}BgpWmzFQm4@CD~sy8shA4m(8MRCpWl)#&LH?Ud8->K^{-&^
zXYVjUHV8+<`yq|zpYG%o^bAIgSP`sP54%PDmGGhIMFDLRnw~`2>$kFLA)=^I-LLrA
zoBikt%CfszFaqslCT}j!QSH4mxyTz4hlj7&<pGTz1!Q$w{Vj{@FZb1m00qL1^BL)p
zhx<FO1yt2m0f;GXV|3X}s##D69k)^!Eu<0mG%4TPGvOad7C7@C6s?G$cKC68mmtiu
z27E#HT}Ds5E>z1kp86{#JfKCNUqFCqCU(nXK!(rJW}qXj`tWQYaPxwH(|VNOveqok
zgK(jGqW6dKrN@Vy0}7_tX}N3sPEjg05UloJZ)Od4jw`aL{+RuRiq_-uw8^$GK~3<{
z7r%}(FhLhmC8+F`(2hyx%CE*~nA}S_U44v?Z8=Ym`j5~O5?R80bE;Sn!+cFS;(*=d
z&3JV(JI`Px+MxTc3eBRtll!;lX9=VVh#YB|WA!%=2LqFvErtqM-|#lqtFgvEeM+o)
zPsP6%6`#qXEC~VcEAY~o1OgRPsCCP_NB|n8@x{EWp3tkCYFB(=KTep>n;6uZ0A(lJ
zO_QJ75B0ncL)?B)H??yn#_(z*-(M~&kzGG|vBG~<7p(uVANPLqfcKKl`1f|$s#hJH
zA}!?|Wf;myFx~OLMS!9Q&aafBD*rH5>x>h$t?B1@3|ZWq+hOH#{IMQW1&emU6Bb<?
zS7ELPV9zW_oAeL}ww?b9PAWNne|CX2b0F%KZ|+Zbgc$2y=OwN7Hq<X6mMtfb%Yy3$
z3%{t9-i}|M7H9HRWg^_}l&T}oD}Je^m*mXc*{w7w2f;!)_rkBC6!2i3qI_9IpU{ro
zk0wIed54S-F?gpV)#p{q82<D#t9S6`$tg|j&np5AVNrnu#*&HP0vno=Ey#AZkwD0n
z2fBa^V=vhS$KR0m;UgH?JYN)lp9oHYRXP7@@34*B`7agnw9KOgBK!JD2m1`~AGyKt
z&po8rWaO3!GuUA0f5ZvD%r2nXJDq)gTp?FNrQyg)^+$-$LmRAUqv&bv&LEzve$dO|
zZTkh*WtbZO2|&7|qu7~}{k*4_=G-0uPk$8m`9tJ*7mM^``aX%rLNfPPwmG#Z;4^dL
z(MY1DJp3?Ks5VuoF`b)<2;(vlO6PM2s_}FOdW${mv9hnm0CQe%37I8m`vTLsEGR1Q
zmH#;|VpVUpwi*0Ajy0O`dP9!!M0Ems1BR5wuHyrq>miOYGQ&v0!%#H1z>XWYNO>!h
zcM`}udx#`VeD+V@P|a$3LKGn9GvFPhljA~@`Xm2R$Y0#iBIat)VjldJQX*O{$%P0I
zPRHbs-*3d?gGIl!;Xa>}aWQW9?6yAH3^xjbRi}AIiox9X!}N@%Ln0tFP1MW5|7ww;
zsY**474U{)&RH!UAz!bxMc@M@^PceH(vq1sGZ$~w%6rMx(i7GqMaoziiieb*e37zE
z0YFx}0h9qpVtg1NuQH>7=vNX4sQD-yMSIYzEDtbtL{Of78mjT)zy7TTq_XxM1yV@@
z=>D)$gHrRQTj?n|eWo#WjST1eu8uroA-T4YYb{mOOgjoHS?ucFtM1fQJC8bxSM`pL
z(rsH@C`?{FNz)!yBkgkzE!+L_M}zGes5{(}&L!x@jN<vv!KqTt?$|9iTjjC5^scMA
zObGWEJEUo<a7g~lE(Fb@opwZU;uJc*WBU*hnq%HU(W^YO_VViGuYUnK4_qwVdkKli
zD^q1klubGV6cLk?6)?WT##sn#D{G2vATrT_CSM>}>!3biOyDHb#soxV;MZ19AE{b;
zf75vh#|Gh12VleKv-Ur%@&<68b<E=~&0Adc><k$qo<ueF^0&iYPwJ+`RC?HF;?YBG
zbi#T;2WQebxyAetj&q_E)syZ1j(;Rfw3rs3W#18jccF9e?=+II=t`s1MD^@G5%P!x
zHw78;zprS_W|siQoE48P(wnGyD*xKHy%lo%lK6?aS9@$t;3){otc;WRyEAomdF~T4
zy#T*w#JpnPZIxSX;FjV;Bc$!e9l-OLVr{9O*>re%?GIW{>tK}Y#5Ok^z87(gdU57F
z+_oKXr+s}*ZBu&H)c=5-8k=n|n0TrmDuc-YB>TpY`UP;&*N8CU7nt0?wd>Q-B6RS?
zZ4y42LC4b!moe?Q>b~Jp%|x=8M18D$EHZzMr|ns%IZ9p7jXaySk&Tnik@OQkz31AQ
zxp;qDr$`(GBZK7{N*z2#6{bW$C;272KvM9-71g5w%vFl*ASUgVHXAlq+nGB+9``$I
zZ#i>u3i#9`BaU<~>~OPISxwj<QG%W;f5LbCz|mxuhT!u`)rp#D$+`NF6YeeJPZ~y~
z?#%u1EWtiO%GRAhb>78LeInA}+i|ieHu#)4UQ-;hqAD#IKv9i^S`@6DmQIBUb6LVx
zqO+7#Jzg+#Bo7LZyt+>1w~5C3@9{_qKDKPZPt@{DSq7+tS)~R^H3D8=T0?GhRU>@m
z)swqgO;=YYngD41_Lk4V)zLIhCZ7~RcSv7<iK-<mGuFF}Ig77lcT!!R?}wlrK9)J(
z_SW|_I!#6F2ldo^xtyw;x3sfTxhSwYT}`UuA=4!S*!p}-WZ+bXtLOTgTrJY<ii5|{
z&gIDfi~wQ{{97D~bx)KwW>O;jho@yTU@`)zm4fS5+YcH$q+M2?+Om7hPzEFO)uL3P
zjNqCAJ*@T&2X-he0R#yE6dL@&lFki{o<)z4gzVkx1%5CH+J3n@4^aH4W{~Hfi3Ei(
zIN1-9MkK(qf5(>FPtZC8C6sxBZ=fKe>J2^1m;?zX&2M05nH(w9;WLOXU)KU&COx<N
zKI(On6ou`>kybmn9{mSBCK-GFE3Wg3by`gY<uS#$ZtuW$W+go@OVr)lE{`WGgj^0S
zJ&5HTR|7SuCHLZQy`)9J=A5AXGive{5_`c{*qKHuux%Yn1AltKXIP1B8SJWmr6Ug3
zhvGFkSQNgX-UX2Cr`GAQP`S-BV=FlQ{sOcA&*FBOv9p03J$OXdT%wfi2NJ+|x&+o(
zK!t<w+>@>Ht(Jb8@HQl$EQEN;^X0iKki>7EDTawtjUP@q>cG%GdXHLRWU(|73DCV`
z<eF=$Er_AJb(&sOt0wGti_W_JIPtQBH%nX@#58Z8f2^ru5wmhF#;He6G%m?S`0Oil
zE0VN!b=K7s?n-*v##l$2Kg#*jiz-^EH_0H(z<L;JybK1rIFwhogk!z79a+0bivcQb
zLEUF0l*7Kei}I~I9cxdb;8vJ3meHN~{Cue_%p95ZAh$66!E2H5g!Pq^9wT;k8M5cF
zgZ}}u5=OVIQAZZFFu2*aAa5ID-qrd?s)nnN72f$suDdUFR<w_Cfc9ESi3AC3&tA~U
z{a<(YKwKGvHWcidFTr?FZCE!2fh}s+b^X@Dm$woRX-pn7n=5z_cXH=?H}bO67K+Mo
zviEc)Kj$v&>B)4mZp8I<J8xvtCjsB^sef}V#y+ozos>kQp_EteJ=~eCNsS~qL|W)w
zFR_B8Tsa2&FqVzNqx)N7g5BxwZSXuBiMWrw$|{2S;l0}TNBg2#g~mj}Y$y-v^YF3X
zXc%l*pG&qOW~;^te*gIAuD|c<_b~zh{sAE$vLX<lt6Kw<)o+V2WXYbPsfo5QNbD-V
z2(`hOEna&BhHYO5Q!b3J$x@%^-%>-9@-Fz$1dAqh$ee(CCRI|npl38oCtGX_Eywh=
zrhiN?USQqlf42@VRazOZ1lsdZhDkW4B!5=KfhZ5|SZY^#?ag3mT3@T(NXK(&uLwv~
z@d<+%j=z!sHVZPjY^%}*IN+@Wl6`NtRJ5dJoM%j=GXJ?G8<Ii^&!QoeFKM{8ta9h4
zqAr+%vi<+y(m>AdL<V+)HC&5?1CIIW@{oGgA<~$S#;i$S=Gs4nM>(4#L_TI5V@~5Y
zvZp4j!zFwu=tCDJ<<ctQ6HV9S$MErQ_fLdlLPp#3j3YrXobbC*i}|&fY*o=^7+$wi
zOzmT+Hj(9vnj3E#<+WzE??a?4tdfQ5(vs3(Ecug7<xk^84j6pvZZj<h-Y%Dm>rxhW
ztBs@rUMq!*$Vw6U3`1`wtUY8`8h3Wxc28F`P79w`jGWQKkRp1zYVCJ&kb<*Kzkdh4
zi!A`_M=EPC><tgZl8u__XxHBNTb?ShJR60-fXY^z5AcOC2ngVJbQA9ZBvnGT8<U}F
z8PEA8RYf^^UQS?+`@pniPgEKHj6PA5&6O`@OTU-7wUg8p+fE@6Vy1MSH1RFVz&)YU
zobI8bE5le1a+Z5S;S=|6)vLCALGarHp5lXN8DO?(Q*<<yD|5IZ*SPGs3prt>3V-`L
zY6&vWhRdYoa%IBlrk)CZ{LR&yDnl`mYB{xwm#5z_Kz`zh4eD5Df0?<xro+w#FIf2+
z`=P-)*<Au9_kkhlEXzWwoQ`7kfj2Bv+2G#eh0Ke_CK+Xxztbty6e6B=szoaKIEl#7
z)s)GILK@SF{{lWNgPSv`<eMdOx(Qpwlgj`*Y)qucnhCGFM7I@tJ^D>nWSJN@YJH%|
z!EnD=Sw}itRr0`=Rf}t_KVdQB)ivgxzDT<uQKup1Fj}myp%mkULCJr=H4I)-z&9dC
ziM{Q^jLhFO>`%;3-P7cj?t~S<VsW4_&L`pyO7{mwG{OWS_+)~iwe;8CCtQ|je5yp(
zJMNA(A%g^75$*o}oeT`trg~a*dr`0D9JrkW$3j(X1`jppb#~N}?i$a64(<|<ewPjz
z9T7#}ry5ABmCG#^;FEP8rv>4Sr{#oH1#Vy%pP|F}f}@2uu`x_8p-4x~-7FgI@+_{G
z(u&EVn@i_Q(d6dQ*4Z+gGPxmT+14xUTtTYtwz3|12;5iPfm+S@WmT?-cH7<wl&peq
zXsazQN;q0C|8%+W8fAEq3^`US>Hr@-y|@rpThadCH||&?hhF(4eK*L8Nad~>`7bsO
zVe%-Isz6ZR*)eVvus>%;gHLm;Kl-KJ9haDO04WQ1>ATUS$*x^Ax(M~u)_c8g%>q=5
zR5cd0%K44bjjYrfWAx;yl%{SjEHzk7A;q0b@bDKq$z>};x`*kWMgUXpF(iFuX<if(
zM}WxI70kE$shk6GCL!8J0!e@XdL3m6pi{G**~RuSuac*5G@^!RXLq+r9RMu^Rz1Rq
zJ0b)(l<aP$cYkM$;-ix8tylhS6(8F?ws87(myB-a7|LcF-m@i93dohJbI}MMwfC-Q
zPrgdRgtZ%=$*fJtylEyuA4NCaYO{}+f6tvE^21l7c0xw3>VbRWgZNKZQz>o#9dH=<
zMpAk5Y)e~Zb}W*ME&WJa=@C*q>NJg+x83yG2DG?4HX_vquGAeh4+zW_8b*MC?srT`
z|8VsbwE*=8hkOhaR);OhK!kf#0O+`2i$RuiAB`>3H%EX&&EvHno>JMJ>8a2^UTp-R
zrepY%Z2+AQq|Z?47_u)%7H3iA<sio@?MwP5Mj?CnWnv0|8R7|W&vTCvp$}($bcLZa
z*G4W}cS%<V6Vd@7peum7%xQ||MzK}wYAZoxhsZ5q`XLpK%S=_4G{|YbS3!AS3J|x{
zogq5dt--q#SV#8|kGb<qWo4V8@x<o*{56-{aLLfIs2q$ZOTp0~&j_FUj=WmjGPZu}
zOYJ7b%^zYOzeUG+zkidUS3b!hTq;xSF1Q=~eV4)pvKm;|6;>zCneiL0mbVgMBBSmJ
z5LKrD(#DrFytAVTckBciBdE(7Qz(&xF3-3>-Y_97@F5_Vu5V2q58!0ZqSfrMHFw=|
z5tNjo+id|0O9xSWvA#N5{R9BpBO9>muVc@pH@}~Q8zSkn?RU=b(9PX$=@%~l1sFV|
zbN#yOHTg@p9&(G04Odn@>umj)xmNAorh$R9u<m~WVTr2}A8?iar`I$d7+{T_WsOsq
z%|C42XxBd<IRQIIN`7ZwWI?T-1&@;NYY8Yg%`5F$^+pk`&UlphR|F|zz85TSif2&n
zpZk4oiy;bj+lvuuyE{LyvmyarV**N&iaeis)FXe%|309BhRcVgGZF(NYDVpd_q9Z;
z<S9@l>J`SEx2`sBi-5l=-8r+6HJ^}^dl&5xIKAR0*_8M+!v@}+c<=>5z3}zdY~Ih3
ziibfW4Ng;g4618U4Qx!2BFN4~H{oH%=XFzx91oP>D=j!~ZZ&d7TR!BEU^WCN|2z)y
z`X!SiZT9-&k<R`ELi0>eTucPz^(nbvy_20RdXUddh9tz{Q!O{l0Cr$V7`NFmdz*99
zw-6IlB#qd8RnPNW%w5zf*;nCGe6tG<W$4{;w6(BJXWI%1oxsaSzQx<JsD9#@9xn4-
zT^3ymLDN|b4(VFk$}QExP9CzT0p)(06FVtrJ>L%Fn5;#bAV3%oIip30<7fHWZQ#;*
z^gXUrbkM4@@P8PQP~nEj6;=K~CJE;{s?ZQ3qdiaFszN}=FAk_E!1n_}xuo!uDlz)L
zU|Qm$C|)duckJX3?{Z}fNc1P;QB;Q&2xbHO5we#%*y&IA5Cu?%-n0MZnwe`PAkK38
z%{@9K6!d+&7)5sPp*4HM^riS{%op*W`PfA)XT-c7o+dvmHHLJFZgKaoJL7d0aWGDp
zr>RNe=uZ5@Xi=g>PqHq5UXG`e=^whB-jlobv`QoC_ViCqK(JOaTs+@~tAV$vJZAR5
z7%Kp$P?2aYct^BeyT(ELeN0kPfed=$Aj&f@$4j)cx@kL<9Eo<j1uv*5t{ij%fODs@
zE)$HRdeQI>jPKdm1+h`$_wP@f`xuJTx3MqYP$SbV9keyh;`d#LhFny%Mo&gb=Q|wD
zh;}HXr3AykHtVGPE`ij^JbUR>{R5YpC&g`^kZA1zr<tn%qp9YT@T=<d+_paEG-wqM
zCBKx;{#*~?TS6WnH!LohPW3AbuvfR=LRkcC?-&(Jdp=pF5o5mp-SpyMN||0Ba4y9d
zGuNaGkYcR%z6|eIK(9r7Yy#T+n}ZyvgPpRrgNxA$^Z1I-ZjJTbOMIz6zH*zl?=9yS
zc4bpQR;=xpK{6yZ8h(&=jRKfOxP|6LA(dBp)Q|N30!QO!_k1xHh9)O4C_A|i>`nuA
zC)9XG*W6(L8zz{8y!+>OViGP?F0y1@`ppu9lhv9}i!DR-Gfr{R%#EF~?q;vJe=g?%
z6k#zOc=_#5f^Lp@BF6~nk-O*)b>G@rl-R!8nc-6TSxkewkdpBoAXftmQ`xYquO)rp
z0`l^}N)+H;W#>KYxO^=V#kdy^MNM~rMTE4C$UJUbz+F^EKvjeuzbdB&n3GvEIBFQd
zJHC{fgJ7S#Vw6ivs6M{xfPMHJ=uFZ(TL8o@<QiRJ;Hm<20bd*dnU5;piXI`=p62v0
zWgAgk|I$u}V0r36R(SuEfxRcy+#OpKYp-h8bt&~3AAfvxJ%bpukuLRST^;0pM;%}o
zx(1+}Ms*9p6zz-5NxkX`1MN^00Fma6-Ft4*g#ZH583E+<g1;tRuOA9tXR&r1h1_XO
zR@bThji8)*PB5V1i?}br@GXz!LPzim>ecc+mit-2V0?SGXF_PbfshZcr;C$k$Cnp3
z0N!zVf!arhGPP2}mvf1Ud($H%T>d)(6^UNls(W6<<?hg&WMGEngEwii7T#s{HkEV~
zNASTI5eQ_peEH$aIyVmz$NL0fL9t?z5Jkv&Z<a;SVnRlyG5lbL)5G^ndLL`YvgxX}
z(Z25WTj!tB?<a1tk8K*4mdDkeyU=3=@{cFf!j_1lZbwb=9GB<y8PmN&Ux}1UOZVDN
z-_F-Db6!6B^dZhvB?WTHobq+2eHgsa-KR~I(=pRYmhF()@3Qc2VfJV(fiHx*P4sUP
zaV5?vu*h52hFy*mYZ;eZF*)^ziU0Ay5C3`;?yW*pM3ra1v>jA>VHru`<^iH1Ojh=c
zEt}PnDtLJQ7r1r4=IdNd4-y94Zj?Jl3`nJ(bb!aDh?2;>YvbfWWBB~NaAt~&j@!y0
zmD9w%$DQLI9u%r75@N4_Q9G-<fc}$Uv$MfgzDs34K+X|{bPklm&~k+eakZe^5B1eZ
zH8%oeu9)FL49WyHTmbZDRp~!cT4zntD+7KgeqjUQH!+n<m`lVC9+XYCy!iA?5=&n7
zth-1^<-=WA#NULNBKQ@OWrpQLzLxxkvsBvJ@=2khTDd%bfWH?h{l(eimb+==o<ZMx
z|In>sbI=PSOM$J)UoY?xv&X_jz*+0ZujlTL-l`IsFiU7NQ@8$bxOFWcs(Rl97RXB%
zBCzs-R(`Zs2Jg9Nv7j59k0OPromRa9rkzcnl531cnE!EGz%Iz+6n}-{58fjj@SuxT
zn-7V}p~#pPF=8r4;vZxX{kWtrIT}V~6(%JS^la$Uyin$lGh6O-49%cOwPg+6)D4T_
z*rbiw6k;(P_Gy-<Rw36(WEQ1ar^kc~a5#$HBp$j-g+AT~8wej=eU9lF&Whd2(9UT_
zSl<<kR9IzD-T&xem0~ahEhj~%An;nLr*b<e>(kc{OSD`!j2o`ad{J&SdLG;3rOGTH
zOi|W;5RL}7T+@nmRnKvz5^o32K35bbc{CXh3TX||{wc=sHnjsJ)NEls!28BdG|!Qt
zU(u1o&1BAG4uq6yehjJb!ChVG$zclVGgqiK$2>KCk$J^g<>b42Iyp+)hRbcn)W_)j
znof?lW#>W1tX@Y-K8BwFJ43HDxF*D)X%v<IS|;^}_Bs~@aghpa_@QhirmvJ2S@px0
zpITmUJ%WWreZOKPN+ScZ0*ni;mT%+=qpc(wjt*LscOB1GwJ_xcEJ9Abvm({*y>bIR
z)c@=}irOr+MF!WX-*6wk+Uci|of6Xf*<--3S7I}rbBoIE9(7>+V;l?gNP)#I*dEBX
zhfn?<ANVOMqd<}cn_Bu=cReXr75|VH9~yB~e&oj<sF+~Tq}?SWZ$}gn1c{GO$L2ab
zJGOh=MRO1t0>G??X&fwo9%3ZadDCY9^SRJniIHsMQxT;hc>+^IC%j1&x0l?Eerf-(
zjl(ICgxw(>*SoR;wem*Ud#!9&9BynldK((^HG0QTRmVsAk_WGqky5(u;K0D}NASRt
zDz-s(xl*?`zqD9pFf$cgyx&=S)frlYCe8@d;=vzJFMqXTBpA}-E=R(}bl=kH+Y*M|
zmfvKptZ;-G+&}ahh+Z2TKmVBpGo`MpfC*)q@Ms4lgCEYn_|$WhqUn<7&e@dCk&#p{
zn=jt?kieUhu3oVEKfZH$eP$dx-b>so(qTI3!Rmws*~uQnUStY|1VCxzQs7^@&xKww
zK{-%2{!IWkPT%q;6Kg;^hcC;JuLC|C4*oo^oc%@NI$LMeK^oIN?4I|47of?lUA$7H
zKX|j-OWs+uyE`n%p2pPvJ5M_r-~T<|q?^B(QFy_HY2hW83;oca3j#&XYtQw{B^hG~
z8&KC^QG`IRZNKna_PhnI>kT+*?yWD&==*{M<W}a7h0L=oybMpOvJnS3pewC_9%flT
zYOgMHy($q1nBY8)l!T$%d`WIZ`Vlj@76FbWSWqKQ2X;5D+7WJ{RdAVRyo8DXAE3eO
z>qG3lZmffUK8UM5T4;IsdiChYK7B*hg@~Qg)q{8Ab#Y52?4@?;=jWW089!Wa7IgQa
zj%@Y9&3(4s{B>Frs7*#({xU{ojD0xy|HwMepeDXQ+!KNjIwAB9p@<+IX`%Nnpa{~t
zNbf;<5kd!1dJ_>*5J6BtkQ#a~f+$i#Q))sD5XjB%KX>k%yR-XZcXrOq?#`S&=X;*#
z^Qc%y3XQd2mV)uZqA~sb1#=ezAd2N`6+XM$&=1?UGcl3=Jc91PZ|2>H!rn#>WRKs*
zEt~(ERD<h?r<awBMm7r<5un{5FKD)xS$Ro3eM7&BApN>MIad=r*Hl*N9ObNxJT@0Z
z(0>?DySiTY6X%Oum&wP1VUOZLx_vMM6f+X#>@T39Q0bp#r`@XxA%;QMI9#C_hr^Pb
z2DC4R{Iy;siHQl_K*{}eOLznfPuQO&2HektY}ZAvPB~o%&9k?pV;#yGi_=w+=pU6|
zwJ6!zaO_tEfgnM|Bv;m$(-?v4$gOfpQ1k!=gxBW;H6V{HU@rf%c`s1@#-q|u24JYJ
z41&Sg9|qSfYxVTPlVcuC^2FiGen`fNQwPndv~Xi!r+s-{r$4ftQsS1ugIbQBiT)44
z5#O~O9wCk2zlNuclNu-SsR&52PDXmM!##d96(Gh|SgTj|UgZBm79hZ|)<P6at8uz`
zttJc151V2<+Sgp8tX#*gJs6sD{qi|P;js8YC*<45-N;DArF5eSgbUVBL?CcrsFD5w
zx)N!~&-FnF@Q9afvJFq*<p$DA)Av65<a>Gei4J5goOhp~q4_gm$iVgbHE+%svK!g|
zU~1q<fQEunvpncv$h@;|oGW5u$%6fH_~*Tc>YS4t$>kGQqu?o|4{}B?>AC#-GnE-R
zU&nv1zWl1SjrU6b9VPdn#Baa7X!twF?X{UZa5d59j{-GK)eY?pe~8b_hD|!{Ehq$h
z`09Kjp4>aB8QXu|G`B1x%x|7@s(tpd_1lO=VnwpvXtTocE;E;Zpb2X~t^J?nkoCuV
zyn5Bv8gT}IR8$ZP|KIxU(Yz*L2QArNNY&8l-nha@a-?E6TrJ2H4z&izE!B31`~HOJ
z#<4!we|BeG!KizI`6W(JC(sgXtT=JJv}+!6Om$T%U(~Yy<yZT^{eK!oGB0e*O3%YS
z-*K>?d-r+t?ZU~Kz173D#|N^LY|R5b5v(VK#qJ}&T0)Uap4aufu5?wrn}|p?SG_2<
zMmR~8AS}5NYSp<zbw3CBVQu0)LF5MK|K^4PztEz-yxv8l&O5wLx4zrM=x_4BtPS{@
zes#5j)9PP3UtVWpZp{T$jnU*KgiPY`NX&n25l~H@F*kyD?(yCuC3W}2BmTSg|7|!U
zhvF%<{#&=1_{5?cV%wcx_CEBL%fO#=4gRl{UPwUkduj`1ev&@38Jidd|JO-#Z&pxu
zNW^tY9W$y!Y^*Ks`<wp1X2B@eF{I7^PAPDQ<&&t$o0!B%>1!=yq#MtSYYry|*}q^<
zY0i3n!@rdpQ*<|BliO=nB{}lWg5tv<@E5j_SdD8T<~mil;QTU)k4|Y!N_@nlW-|Qq
zF7_v49nCMh!yY@wD^~_Z3zEYi)ZD2a{ev1+lxBeLoVv*cwj*{2yd+DfkBc7cGYLB$
zJaK`221aM4q)k*Jl#SL?6aA}91O@G%D9Gy?$cYCuNxe-YNbD_P&huWT5Xe)+b((nv
zhLZx>kM$dYM7?ea;XVXBdgD9Ab`<7!@g)xQ0|TEV3i}qD7<)Ga5Psj^n~APFlD?Vb
zeb`Dj`~I-kCr<R9Rou@;SvoGXWc9;DY3iiEc=88*xoC*br&gUl-*}jaO1iHgh?f(&
zl@tcrLiENn+Ulk7g@EssTsDf|QXFGTc`^Ho8G=|d$hM{p{tzh2)wH}eQ=radG$ee)
zb<q_TxqRz!04%iOM;^&td!;!wf6=L#y|=xGM-Q{_YavC4ViE>pSnM))>%5>ak$ds&
zZI{fP;MN?8J)JwOH%#jtQ+aHM$Bs>;*`f&<G;(X0VrgOkGe)CeoP$O3+G=#N+eslb
znSHmFzrP^!F2AM|y-tmCV|q3BJ$HAPfq;(iN}D(2R;CmgMFndmrx+Ohfwtq9DjDy}
zgT{&EF8*oh13L_>f`Vgy-mB3{J}vt7i}TSug-SjNhi9c_;D5?1Spp={&{=*>>8P4m
z^gDhV|K28A_+vpo3J;jTAT&LX=8{j1t(NBY&$a1t6kKn9{MlJWJN^0O3?*Ig1hlAv
z|5`l6i@|g<y_=vxCJFzrzo8a!M%Np)ZgoH7gTg6x{4Mdl?DaYa`9BMo6LiLVw#%NL
zBdbyyGZjHxF{<_7pn_{U$o!Drdhu228pl%!e#h^nH3mJFx(wCtfMZwK;o&UGZtD#)
z>mO>|ExH}u{XKSvZ_i1^a;&dbf{qN^!Vu#0@5|}8)+>1*R1+l=g4B@Ml7_65QP7Qa
zuVtWG@#vCR3(N3;DTq~)n(B?aezr}-#w_=jHBlzV86b;muNbL}6oa;2D|dv5;Q{o;
z+uMxpV>}&Ek-FmRVg5SPv%de7{SH6mQ6^R`8}A4nYfUW+A#vJjkGH-#_=zj<K6{qM
zbq>hVXj-|}G9DCjPr>jBA@e_ABzSrioWnraIDr;Qp;D~_FxXbdD89Pt5m#V#x;1VS
z90Mlbizpu#0(a6EfxeECoR8OeaGmB+re@iVwr>79E&`{t7K*vU0_KdM-C0klb!^x&
znbw96_?Mk0L!)pp$zPrwebh<{ef=SO76v}F{%!s4ViV_@BF%3~7!u`+=NSl!u#oV-
z5qv;8{_F8BPHkMm+2z9#RQf~|q{*y)_4I9qaP4p6ZSf*_@cqPNVi)mS<o;Z*juC0q
z%5khd%6+pRW|p)}w{{e5Q3C5n+PtK=Z)3xiF?m9^I(~8@OpW|n0!fbx-K3D8U)K~0
zg<~h=QUaJ<-P^uAu$NA>eo12G=oQA;`RGd6$WiifDQ$9{g5A-bHS5c<jxP$%X10;X
ztsf~6bYM*JQfNZ>Nu+k)UDNf85OZz+OnT`~V2hgm_bUHj4Mv|k0R|7`KbGTzi+{yn
zBr@*}OR=9AE3|zJP4xjiy3aly(f7wdznIZz=?9^5A|p4>TDVrUTKgsB4d%xN@{hzy
zTjX2liDU8@d3s~oZtnQ9t+R^?vBl<lF2Cti!;_WhMM}63AsXXP=92==jHUI$*d>w1
z6<1ZRLS%mLB-v#Q>y~3qkNb5J4~)V?h#mMA7Ais1of0Pk@itF&QJwh7DU3(yjshj+
z>abwQzv}ai{!)`YQ*%)YNNRkf6yylRC(#LpD@k*{ZWDdGITKc9p^yBJ5Z?MRrvSNF
zShRNgU*nWrdhpM`VuOe!o%Z=OFn4V)-MWxqwBi*Z1wF~={1ava$f#(1eTofOhh>;k
z?EkSZczH=YS+*lj)WLu0VDKeT*lre<ad<3rZ|F&Xw8_{xVi@UjRgm!s^||MpPGwOi
z6rIWX2LPp*@~M0C`gXMe5EuDkpCOOq(TV~1YEJ%RDSn)7D0QZ*LiV4@O1XH5t&qCP
z+xpAqO4ngpaPZ_8Gcc=FIwG!*U3FZB+qUpgVVtBy<_BWt8oa^}HJ7QnZr+1;lViS0
z+v|d&%I7idH?Qx-1i&&c=*h&K!YG_t*a>+(3CLGcd;A#xyQ`f<+E}V92?E7YQl5mi
zg4Ug2_y6h;yK*W|Gl@?m=maf%m8)?A{CrQ@@No+75^+m{6V;SoVB($pLi2L!zAO28
z!i3@*#agMRLZkGNv1pjIGr6?10EUaOep@EQ-ftk0GTG!Zk)su9^fS9mV_4cyAe*e9
z?Q>)t<e4uIWk-QSk5J43IxFe=ec`DmBQZF{#Ainu500%J>Z#HB!T#fXW?3)211fl|
z{(5_kd^8cs>aFDv(4aBhbz0qklGh-9tfG!DJfMC#pKW*FALR@p%~kpI+EjsW_-2!c
zobI<GS@uj!dS5=gBBV&e-o~k2bw}It`K_v{)BUS@`WoG|X#nLE7xi}mLf_Fs0=Ha2
z*@jGpXRKi3tUGg!ai$4Pa?<=y`Sq*a5aH5Rcfpe>h|MBve{5{JqpQ7ldi-yN3bN*w
z>63pt(hOX<Rcd1{j~IGF6|6q?Xz#+ZTb0=90okFGq+|d)l4=d=6M}wTKGF9munL@W
zC^48_cljtxb#Nr$ltq+}GU!J|Sq0bPgi838CNc$bai9LIp86P`_^G+=klyrc6tNPl
zpXt$Qgg=IlU^`Ko<CjAlO=IYn?ygx)CywQ!*P(FaT4P`B9j1dx+Xtj2ZER<V-`1l!
zDeV?MEm7DP>je9YB$%0<di$dd`N2p8llkVR2R2jbujYtHZ0Ki|R-GZ~(dwlOnPPk-
zzC+#D0vd?A#o`Y4xc%xXnNzhq_o<?Lv})on&YX=uN<in3!fvwg--_-AVjS2B+3VWK
zXvw|9h?X$nnR7s`hgW#))0;t)%?tRgPhTCtt&zBZF4~x7u{KYNb@BHlVsQNw@=4CP
zV`L*MR`(%5d+59*n-G`<T@E6Q1@dFS0NppsQK$YXrIXlJ??d??k7WtrK&szj`47!b
zj$LdCWJEQA>^!ap^<d?T{eZXED;eg{AoKurJf}WxPs6~)W0#)D&Lvs`>7ekb%(ZUj
z)jg}~GYY;N^7EFiK2~pOX86e47XN_{SQH;t?Fki2o5`#m+kwUSAnFjvPN|U{CtORB
zK(F8zY&LeJHNN)q9&n8<{!sTIR;(skyt}sh{I!VLN-aKKoM>Q@^`GcV1^@9Tk}TcI
z_k9=aU!)yu&poT6MEU5tXwdo9nqM|33kS}yA0PJu)SqMzXx5kU_F20&J&9cr4=m!>
za)@=Y$?;0Vl|a{D5Z*pc=R#(<^>&{mu|lO*)Uw`S0IT3e!~4TBs2QKune^vY%K`^o
z!rS8>3^_J@!BS=~WZcer&FRYrNw!t-^yxIz9>Lsd>=|%Lp%Wo8z7`!Pdll!YrQ?#a
z&!)f~J6^>Yfkd!MqzC_b!bx^DWXNH6a@w7P*|)-uas^e9?8U5TI^t94pzk*W)lzKy
z#oGLk2rxsJe$mGeV(!0LnI?s^U7#3It(-2HBaRnLD)))y%&XqXT_uaP_mSB*valVQ
zv(`V3;^C7-#-|QmM=|#XBnF|B+g<2nS7>~r&Amf(amG*&{cP;QdIzs-Qapg^v@`qE
zLVQaTax8=>XFZem2&L-}qi`;mXj02)dP?kjuL%cfCL}$@-NkpxOB08d$wl*t?e7~_
zugJx7!~U#ykaNWr=mBp^4HD9SEE5KRvLt}RNXsQ<Yn8FU?KT3#Dx{1;5RBGCcTSKb
zOxpnD)^QfM)d~HcQ6xP~+?{0<L8(fVRbRgEW+jQJB|iZ-TYf)=MEGVr^DIJjJlnd5
zO)H15exe#grttsiaFAmuxhEeu2||<Y2m5KD8GrIR3}Y!(A){Ys42l@JaN@FqpWRR-
z3L~~-me4gZuv5*1UKcAr>AEO*e8fe&dP?Q_+i`U3i*E7SN8x^-{Y&YV+_H_(nfKtG
z^(tk6&h+oD?%Qt@p)h&0_9Y!e&fADJru+FdW5WS;R*MsGru=uRE-ocxYZ|8((FHY~
z(di$^6XOyTdS{pfdMxph+J=w|K}U`s9Z&{pFmGmF_<a%=0%>QUun2_0lW{fp`wy!(
z%d0I)b#}-R7(g**^HH}$C;l3LSrm9$gdfuqW@Y~I>BcFR`gxaXo7{4SVx0Oz$Ihit
z#hdF?1y>2~w|F!aWMG#h)|pHktmUxtEG2b7@|0>cf52BlN+6AeuKB7FVRYdxYA*+(
zQ@XB}QuCE4DRKxK{KFiqeYny~$AlAaBLDm>vE%qB+51o0Hd_t6A3+J0?%k4?9u7B(
zudkOtzbxz{Kh-)MFJEmGZ+MKFKyTmelcbyQMb8GIoSmx@MsI5jtGj&WI395CnV#V^
za)okpvf@M7KRy^Jq>R%^d$ry{<@w)eK900I0?Bumjsv>7LHOT8k=lPg<zo%rB!~|H
zD6t=6v!BJb!-1LAyf;n;ma_(NcWgk7P2CK~Z=i=gUf#p+65q^|jFyC@pYx9hep;6{
zF8YXO&3j*c^)Ut%%&mrQJdtrEIkudU>l)KJc1MfI%6QJ#_fnv|isi6zdBg2MdcYT5
zP8YS<RXM63#8L)S-F#oC-idNkR(1<4=@%yL;{UM9l(6-1|B;9Baw^QG_FfP8ev2V-
z|M*wsm^9{{q-s&8Bs-VL)vl$i?dr;2m0xyD3?g^nty7$MQA57~!U43q0;UxjEmIXi
z_HT@_^wB+E^N2}1rPa8V5@mETj1&iR6WQlO_4|P5n(2{I6RJW4%QdLH?&f#tdNdS8
zlD<&UU2Ae1cvDo2a}iWhLILKYPQS|EW`$G+(%vvU_r1ktI*GAy8zh4pr!C({dt>tB
z<PN_vquqtx2C31|a!RP2|42NRNj_8u@T)?06fLtc;z1_i#q{9zqbA73bwCLr;h|`^
zp3etg4>3K6&x=`&_$bsZ5&>V__qd~a&W#f2eXMhedTsrQdiiy|E-FA?>2zHGgT3JW
z?tiZm8TxbsqiywN<T!EK%?^$+sgTH#A5B4qQm+T5c-VQ@yFxXSme)r5hf5!NY!vBq
zY+>li`KZTyXD$>Sy->}Gdw%609S6&mlXeE|7t%wsdz1aKL;kJbh?OJ9_Rw|e8@tcG
z@sb>c1LS1c0)8!&v$oOpqlwL*dg6BN`g+r;QrBfAT@{E^GiVfX<0?-}Q&3-S9jn;t
zwN(XKFwLxiboteIo?RU@PsCBh>M5gR{t!WHPskp}?Bpf=p26fNpG)qSv7XCfa^A*T
zU!rhrvdIuLrH7bh4o!{m*0EGNteVYe`I2IM*g5Ec4tdl!q_)^}MIEtoJ4HH+P9yp+
zP3t9wSSM1tgNSU#-dH0B9`jrrIP49^;~5FG1l7^i_HT=C@kd8G#w1K_^-{ElwY~D7
z$J2OjBDya@nMbS%v01jEF+_-6L1XU7PHE2jEAym3xN%yp%-dZjhF72Pq6&`E;ZtvG
zQr@O_WJfwAV3|Zzxr^>ahDEfNxVwO{SMcWfMQ?%V{KD|L`Eee0<>By=2_f%*NF$Gt
zz!|x(_`e^Q9DmmJA=H~V)LVX?yAwOqo76W8Ho190+_zKrffomV5|NI-G4kp9!Y<X3
zMp{~5b%xhBj)3oSAMS@@5t^(soPKP%M;=|J>+@wv5Tom$^ZtjSByRh1w4c&?B_^C{
z9gVhRYP^Rfwwf-gWO!qZ7eA;he)MTL9THt5v438A-<y|{*)_BqW#cN^a2uv`7(kbE
z*0V3yOHAw$2z*0U<FE4RgzV6bjBKC4r^`=<^muTB$ZcypDV*NKzP*~AC2QqfoWA2*
zet||l;um!E7XEbm9agjN-;SjUO=C-<eG~i;{rlDChG`k|4S%Hg&U63hf$V4idB2NL
zi;H-R>2*u2qo1;ByU<at3yw6P{7FEUe9oey#xo&=+tp*CF2G+JcHB}svfs%nrBN#t
zW@P-jxDW7$8Nz&bH&0vg+_nL0D9v!H=RvNS>Jj=Vo<qNaA-JUH7&3bIsrH8wy;fLn
zxMO(AX0k!Thu9ca&WT~~x&DBt0KV07f8dzm-L*$neI$mWw34EY&NcEM0t6DqGOa+x
z#Xv@e=?Fa?Fj71PBmdl%E~P*NBej(va%@89IA}Bvk0WjlNiiR^Ald2_C2M7vaH1<H
z(9I_urO+O@-&v7(i_@K?7mpmxbI0odEuUsx8$xpebpuOZq!f3Pm`rMvnmK{~O4+OV
znjq+@gdeEx_UWch_W!t=WaB<uSn43@cB@_cc*A{={PRCZk5{py%bf;(xG*{^KA0?<
zJS0S2Xygap7fKOu)*ZR%xlEqqX!0&8n=4Z5YZB=LweoFJ-bg*{PW|+EQub>y{1VQY
zZ7X?@xsQ5f7XJ`cy;~AZaFVE=;G5oz9uPSQ+M<x#*DLGdz$+nSkvj3*2Vd9J-e<;^
z#*)YGZc8JG#4s@x1^*c7L!=hD=)-}7x<Lq1KWi&0u}wsjCoL5%-bey`L-*Z6a+GM)
z5iocF=TbCZmIi{uU8BiDD$5!NuDsdKb8Fr$d}ci6$HCxllhX{WJr!KVX_->3LJr<-
zr=#c$`~i?((JW%ZPRI14gfAlsvo-HSqVi0OKAZMsw43&zrVXV`$DT+2cfG$d4<kvq
zFJ!XN#5ryL^=GMTbDKZ?S(R;7US!DBZjF=4lCEy*;g93u#{<4nJuD-Rel|n}?BQ(q
z17B7(&Wp!HFP}9m`;a`=JZL)(6gJ)9=5-op)2Hl|0NkOsV&B^N=U|+(i>gT8jD+m-
zop1asE_s0mVu}+)d1rB~Wq+>^UNOXuKPwDfd<^5z5Xk>t))}xY55)xQt_oY@W}x3_
zd%;H;1lG+5uCMj`%m1}%GoaPpJ?AgcQO%83sC*ea^W|t)2XiY-*(fr6p%~&g%$^ue
z`RJ}p-(!EgnQlnPy=&INe`HsCFWx;)iOKjP7)2rWm=o`7c7yn>gmcX~eqtp@a$(2=
z<c+b2#utR`l%p&r!;~)2Q7pn#Sr_<Nz>Lz_=dfkzu+O}B%4Kd<9o?&|^tT^fRU&0+
zHpo2SWrH%3vfC%S-&jY32(r+J+OET+v^50=cB527$y9im8TGA=KX`~Hfo_^pwAGip
zL`d*j450AH>{IGipx8<l;}t!8f0^qvh^<$VepG-HAt4*|B#)t}G<_(Rg>jNG2wz57
zdh*2<!bQT&7Wts90_HyCsI<;*LExR=Kc07O-1vHu{sO9^rDRr|C~!|ml;hZZ5Y)6x
z0`=a|gALHx>!;B5h7Ac9Oy0acw*wGA8*mHHh^WzIMq0Xf<y%SwzpoNlK7ci(oXLi>
zpgFpbS%1{WWgNA?O)2aUK^TeQVuyHSX5w@Di|g>Or*Xn#Ef!XX>pX8%a&P?!WjMB=
z%gppxdo%XvSLfOt?`R%9iuBm4QMkqBJwRT-F85huP4(fc@2!suG17he6gDcpT%Gs-
zMN|MSC$^522am4^_GfJZ@RhI*B0#^IOz%Kc`@V>VInkLH%>Q8{(YdVx;a(6m%ZNaU
z!3yRqj-7s2-3r&O<^BQROQCZwowL;_#PhL>c*J1*tJbS`*<1$m2jPBwRxDE%K_(|j
zpUb}ngTHes#egH}O#{G1?g*<sFMx!LZ#OIF72So}%?j#pV`auh&1zuYl<e+L>Y&k3
z8mVhQxw?G|4<4u1clA})0>3pO%bEz^<J}wrqoZ#D!|{V={&RS&t|<nt5y^|#T34J>
zi_juf0g_B_vL(F}G&!(FJ>`=oT3l?WCcX2ON?yZEIDK(wabCxDLYjsuxz<y|Vn43U
zo3iY2#6aj^bIj&N0ZZupL$Bwz|I)@u(<t2zd-2aU@!!4q=FsCC>BW?;kGs#;yr-9j
z+YP9oC5t~6<3x67Tq(S7lz&Igu{z?v`=Xp(@9)2qp#Pj>)Ro7t-}a4#7nyaax6%Kd
zxnRGf<A?ebO{-(F#(QLbZnZ?S4m{&XpFoyXtFRxh&+IC96B8)6^?%b%rLQ!5vvRaz
zu<`?Y0KB;pTW!}bt^Vz^B*8=n`KJV@Y%W|_h6WJpz^(6*tb~$<<WfmF37u3|*F3bl
zAz}{Spl}Euz!Ev#daZ5iMm13Dp$Yna7&?NbT@#Xsk3Rz5i4?@+*FK07LN6&AVEIC)
znyGnH$%@3wEXZgOjLtX_nkYW1IYxIY&`f!mWYNRfN=<FN@~I2!eDT?F<lk8Z&w4b|
znXap182%evY}?DTfc;d@S9PPwV|N{yBIcBrg+Rp!QuPTTp9-P)5nvMAqBq?1{6c)>
zHd^8xB%SpYkff==U(|zYMDQ2KFEuz&1cg3?5L>ikB<`<j`L4#G^Lv1;x5mYKO<_0`
zGxbNgo5}Fi_ljJJ&37-v)FPkVegXXKvOxZX4j3m+^E~RdFC;LO)LAOXBAq%T01v5m
zCM0q1$N7s>di_(v8;5mMWVJ7TuSX8<_)SvHw5);BBz;xSd8u36o*d@-I;5nmhe;i9
zRa-Ko;F`B_It+<gh!3}I6j|IW+z+r3>D*xTYB8j`N%&h~Q>jh1v?ybqZzUYMFg*_$
z=^}7HN@xq6rC26Na560~m?b31VD6EQxN>g2X^AO77!+2F2JA_^&P8gd0Bg0nPd;9V
z0UcgM65Ty*Zlq$pO6o{?clu|x6>tx8P$oqOVFl;$sA*{Bp-*g02LXTuLAkS{<17>j
zRTACaL(bvVgM0SQ%bfV?1JZR<R{E3z<=t7x$`+}>Z_)I@=Lzk-iqBPAS$#(jcSpX>
zE2e!u1&UGc4&6Ra-%Ijc@zxzL=FT+R`^=csQL!)(uGjW>nPkVu>Gba%^!NvxO3zFS
z3?e2+F^u<NxW}W$EYB&ckn&<J1pGJ3E0;a04sJnjWLyN#>Nl?rZrVol(P^%g_NvaA
zCTbzIw$Df3Hz6a91Mc7Asy3WVO8VN|*Inj1iYfr&whUE(88>5>zJ!wdJ6e1C@zh3v
z>%Lbg7Xfz*-7duyS*1F5;Wx`+HUEMdGv#ZBD^wR0Gjlsh8mqIyv4#jnl?fmhV)H?&
zz#9=lC7p(@uSBTD2w%sinuv?${#Y(~$Y-FJ&<$z)HC`CAn*iN<`0=&hK-3>~?V9rf
z$&gpYhsv>cEPd4MJoF-a+nF}RlZD#WKWl)p0A<~J$8tG~9(%0*rJbx)UQUOCnF4kf
zPbc9y$^vC9_D~AYMp78~UcWR6qAko95_6-xvc}PnDU$z++_CM8c^{(Q;BSurb_o2~
zm<$&(u{W|2)Lim>_qZJxf2Ao!@kRdGXFgyHAnl8cinu);9r$l@3n2p#Aigp79eiyR
zaf&3*lyZH1T-!gtC^;BbwSt$+EI@H~(8;L2O;41}VMi&}*B%!AltVBkT76;cM(}&#
zn(tp4Me>=Dut@-I!W^Tdkh<C$Idy+*O%?$2n?@ei)BF(!w|+EnpK@RAt-(puP6qL}
z1Y+zKr-*np`KNa$Rw6{|>C=MG^r(9~ejY?=4Z0+!wcm71^|9zCxz)Gonz19Jetg34
zxu%RTSlq>*KQAsQDETaE{qotyU<w*hlo&Gpq4K<lzPqH%s4G1gn+!HB`xcTqg?4~e
z2G#0tKg4tD6xRhTa~*v`%-d~mlIW`9)ap|u3s$qS!S}X2=DXb7!Y*^^1d~7nd9SZv
z8pCZwL0ofK!A-W|^#)b0InPma$8Uik)Ey|&@l#&yLoiA%Q3aC!s91%MNB4A>yj8nz
z4Uc}>j?*&I$a9Cz5y;(8Eh|O9P16>VW;Q>&>o<;XquIgEX_ep$P_fnoJ+~?tQ*VP|
zQ}|#yXdX)%S0wCdsWUO$W#t{Y!d-tLIw@5q{&2(KXPuUGqSI}ONyr*ljK!|Y+q5-D
zaD6xx!@j$uL*OI9yt%-CSu~UGa5ubK=W~;|F`dpKnWSS%Jqx%bg4-;5k|ZbVNWQY-
zlbuvXHsB61u+G@m$V|7*ArP?|5hYJ+$}p`=7@hTQ+Mv`r!Jr8w%EIO-&J}MV;W-LT
zEblN<HbP5Arup-Q4Lk&kiMss1_M>HoBQyg2G**j22=sz>k;Uj$p1(B-E5R(!C;|~S
zrgD<vHAEx^Y7Ga8{IzmLwwlBk=U`yE>m6_>GGFrQ!J}8dg)$sP8Z?L(UQaUG7p{qt
zGxJ{GpBi5vl^CLw@Dvq$gMehZCJtI&<?tqa7xce%3>TS|Pm!+!{f_+|43qHZEL^oz
zEeBHuIYGGaph!zzXY!W|IY7)b{kvek)^(;{0JwzDsX^7lGsN*uoB3WJ(hb(2;H&cG
zTZbz3F}9rNEmHX+!>x^^oLi|6Y!Tavk>umaFOGMbt%#W3S_5^`5b-;Y0xG2Lg>8r3
zZy9)^#xM-7x1aWdlnF8RxD#`3dcG8DHX0Q;tbUsxx*QYfK6iUdVAA}?UTrTx17LCV
zC#q9$5nDr;d|KLO^^^HU26Ey`9lTB^S)U$%Y~DCc>VB~7k{L(gxpVL)mNJn;Rj^`W
zUNT|cu8Va}jo=O!+>hOv@c>`IOZ<DRrx->=@|1)Ym<1dHNhN!DOpb2%C$2oc_S!-P
zHi;1Y9RjC`x*-7Rljv4~`vG~p4Rfn77=YS1hi%CkM!fT0ek|qydE`1*OEL{EqcR&#
z%PKMXak%0ug6Rq6F~OB9E$+!;FstH4RyEX7U@UIT@&rXBO*!#Ky)kU2)JM<Z_)RzY
zgOqH_FW)yF?K^==LJ!_V&<FDg_;C@HCK~n4ZpX_+j8YMof#gWQ(WE(*j(`;d(TSc9
z&)vizyUD+`aGLjWA30Wv84<tY6!j93<$92=Va_F>d78He$=3OBA1J)YTWd;IEo@{(
zdd0_*s&n!wU&09#WI$TUhbkyh!B6Sm*vTE1_bIufx6P|8_v|KNaxAOgotT5tFAs-T
z%5s+m03N|(blUx*nqLx*Lj+zF9P#nFt@_;MC)3Lnq|Sa;T^LW@LzH8))J0hPlzz|<
z(;K;%@A5t_0DSEzZ1Lor*8WKB*2P%BLbNEeqvFTqgaw>OHlvdMhbz0Eu`_{^b;|Zf
z&723xcgzm|JP%Y|<KTqSJI4+LZ)r#`%f{**E9h>KQ)F_c90@(afHsUu@r;GxR<95{
zjwOq8Bg5e;zSuG{2b1mNHBh=PLQb_#onXEMBM##|tzM;Ay-E`SrKIJVjd5vc{oiA_
zXpLs(!G>A+f*4Vl&EL!LN2ma#_L}U=X=PW>R|b03Udwdhnpy5pQ5|vx9x8)txppT3
zzKhKcoi;hu6$Bz7wqD<np1j>WMgnbcV`a7O5X8vOu!)z6$UM{e5M5j#9WI~##^Sln
z4{yVes4rpP5Ak3RV<H1(cL-<AStNb=%>vdXc5mli+*dFjTybL6m9uc_aV&0v$H^|x
zOKB5p2OLh~S*7*0Y*xosKDOXuO3JJzM@6MWE>kx3H_KOK2|WWBS`CT_WcY+p{kD>l
z>ztk=U&hd@v6OB1fJv*#$O@3qBT-|7mVfRv#K~b^KvTk}L}JLs^>n;$0uM@^uNHGC
zCLd1rd^N-kp?zPxxM?OHbb(u1md&nzyf)NG!|s1+ys{o9O&5B79rdi2&+&-AFy4?!
zF<8gk=<-mSVV<AY?77WYm?3#<3|Sn#UB%^O)xicaD{5b5F@@e#a(M@f(9qDQ+#6D8
z{7bH&huirV7VNE-m#hTyUI@Kne>MH6Ln!C&*I!?;W$ql|QfH3@nWwcJYbSVJ6P-Jj
z2c>aFQ=xtJc)7bSy<t}65UUhPzBXd@YWZE&Cb!t?`4X0~?S(9e+8c)9PCex{{<}MT
z4-fGeYX<+B!pR=HR1QlC$q^Q+xU}!Td$}1iKp8-}(|)I_f+=Aw&`|6e7k%zTKBtjS
zkdE-t8aJI!&1wlsgW2pv<@7?PAU<4$yAS70GFsg1XSc<|BmYa;!7D@js#BiUH|nhO
zZ1v94X;SFR_v;>6NDcepsH>%W9)l_uyeQYvy_mbW&ipc|asxiYy9w`IO#~a|!0`wd
zX3&k%3R1saw@9^ghhH}(<hJZ^N$L2@>cc1@PGT{gMk)WYKQoSOo%%7Vfhen+Cr2(p
z^v+(XJ$OO0ot>RFam424ymD6li*L>jS+Trr6IU^lm?{m<t_7b8DNURZ^|3@MMQ(x_
z`?Etr_%TYt8#=j-Gir^q@>-g~rnCi@1`zmuEs4B(MD(td;*W1nlU?Je#Eb#2$8?u7
zhyY4F0AP#N2LR>UaN}Fde(`CFu}?Vrxtj)K0c=E$$ZkMFEKrS#rNBx8K~0pV)}P3Q
zUuEih`H_R;^>`E)6{Mti`iaJSrE``~;;Tkiv8-+KA^`3dY*BD;nDDpNo}?TOQLPTG
zL`HNnH7kdVxM%<dTQ4rVw1Cs$#l~@qhE046kuMGV#l|OgPKbq+HS+JLdHR&POQ_x#
z!o<~xH5~Y!9uGnK<r*A7#RS`=H2e@f;-J-kaNDI~l7Ir`zqStuTE%zA7Z(AHV3exh
zpH{nW%GfuzBHB-!7EGcqGu@SW`KkKTiJ~%_tQ-UG;fNxG6RU{J+AD+`vxe3tD&wCw
zyh{hUcQ#cGx=YfW9f0W=P_u1BQ@ppM{e?*aO-K#k98ZW?v;l^xdXe(PBS#8st_eNM
z%x&Gq*$VjUwVcw0&#}L|=~#o(Nr@!*9^XIfRuki(xk~O*CwdC%q{ZFvxbtp3|AEJ(
z!s+d+6l>_R^jX7Z&BmRb{+1qTUb*Z(hY2cL-Mxsq<50cI;U;D8<|A36jMY*zeL0AW
z=~kSbC;4T@(wYT%gVraJ&yfe&H%u~bZ9UJaDgRF)ORS>GAJ!cFVif5sv_>OH?g(60
z1jdp3)7W2WJI$s+%$?$x6K27-eYbxVNc32{RG6>drck;+M+B{AGUJW^T?!XI`d3*@
z;;5+=b7G~_)<`L<`|2ei&XuL}k03c+4ojh5m3w!&p#M1T$6jB8_&fO=s7nQ7D*x4W
zTuuFnr*1`isDX~j6`n&s@qzH0z7OQ#DO?&>1*;N(?98Kd3;cJ)$9LB>*=F)&v1)E9
zW6(G0H*E>_=|Xi%9QVni+E0&uS?yjTi)r}r4iIuJXXL+5D_>pt-RDwdvufqP>+#}b
z<x+b|j;TK|Tc8t{)Wj<hW!>wPs%80Inp*nk197W?J2|ey_OJ)oA$~ZmZ+<cGdC8R~
zj=K1o){~IaLLYAYur)x6s_USH-uW-3IBBKetT+-0FJVC&XMoZYfMEB#I~ULy)ZklG
zV4niYeYTUwwC~ps&7nr3L0(a8q6+U#5GFKh&Lv7TSnp9~O#G5SPe1XPs1fuH@i-ad
z5;ynzM26!Fmykwm0T9pseE`(1<^Dvn&+>GOfgvp=d4V)rKZ~{ssWBf77X<gQ#CG2L
zYVntLYK@U8d);|ZlxRh!Xm9?p13F!plICgH>f6QDFf8zTe*b*`CA2RpZMs4{J+D4U
z+3Cehe`rWo0oDYj8vi?r66>in%$@i*Y5Pvn=TWWJnxC22#**|tk8liKa=P0l_8CF$
zs^e=k)he76s7|xS=^Sa4qm&c?R^ZcuF#W@h2V{uB6r;%-_t_gF?4aN4CH=EhRrngY
zpkNeC7lDFL0+=pH*I|rViJ!esVs?p{4EjBCH}Ga$P+OCd2G`Dio2?l~liP_*n(}d!
zNL#^;g(Kvsq1YOymRHJ)yTxBpSzo7YtsDD+`u&Nn>tX{(y5+;NM>sij(ocAFE1OPK
zAs2<6857v@d=$52)eiKIn_+w_ANIQXInjEL>Y!eZ4d>#Ibyr?Qhn5H9s?dsD6PcQQ
z1F;W|IW0rTAwBz-&JAM-UWPewp%Ej=h8RSyVLkXw@L<{Rp99UCIRep%UtSfXzO*@Q
zri>2sJ`AR^<NNZ`AiK2jMmLuCYYTVgcUDz_y8AoI>oHh$F2(}q8q(rgiWjaAoa9Jo
zv6^-NNoz(L4i4e55k5hB%Xp)eZfLt#(fQT6OK*wE4C{j~wBegCT$NnTYx`}}(?Am9
z8x8X>_E&`>sf7w5W#HB=;q3dWqxGOpnMFimqzV1jqGp;kDj*vGc-c|hPkdMCbO0W0
z%O=VdgcnIC8DqCz5Y9C<cjD-13*$GTiRleJ+OZDK;p13xlk9@Xy}tL;)4E*nb9atH
zTUD%1&vC`W?1+gA)E$-+5s8dslS8Vl*}A<tFCmz)UM$6M(UaNw+<F0Ge53Ks4D{WG
zz+{&MTZ1|S()qx7jpY!{z?RQbd_sEt@QHky^mv|ygmb!WtGde{tj3cQvRm;Z2-i=<
zce2m>o89`lSpNpuw?-r$aNZijOatfAQv;`X=(?=uOwj2jLW!TU{;a*UqSHs;`tF}e
z_xXNCpuSzV!Ed#wp<B_hBf|y}W!mbu$CDwqBs3ro^qo@|A`sx0(>~Gj1{Xh!l@z1J
z#V$e#pAU7*|M`31wIRzN-iwkJ3{YNq$BKK$hS6+iaJr=7(nIu#tYXFcQ$SPr9!1Cx
zr}pUU0HBg{ctS1UM*)L}*(%<AOmL{uJ9+snVQ-Ctu~eJAgt)q&y#KKEeT^k9ny7zw
zGjweHi1sk;Xca?z+5dnDYO4-~kxkL?IFKmxixI7_DAQ&tA#kLdHs^HqEJ3`fM9Eua
zriT+K0SfW;?|7VXdkcREB<-+>rqzNdv^cxI4v{Ox8P^cAL((`ZP(M%aX6Iq4INh#x
zxIl;$VugjptG{_lL`bmz(*jqwxK$uiperazUav3yOJl@z@c>N~an$Tr9_}byr6`zZ
zjC3y?_P3+1^p0CQp^H1AE2C`Xr6(Fn_ak?yq?3t<tX0uHPikubb^TSa5@fI+Vv9cq
zK<$&ZOYko^mIXiG+MvC$m++pX2aE2_Ga+qt5rYBu7gt|K-uBs@VxA-NDf#<A=kv-s
zpFPvDd{J)97MK0o<Vo{EyBk>4j+Ne#G;o$}^bXY8k8s!UJZ5E`hx_cqn{dy}ciC4X
zR*92H!D#Mhd4yeQ=`UAfT}zgcm*@xCJUpbRaR0aL(+ssQ;cw0AS}+_Q3w&vy=f&R)
zhSa5jp;RG@uk`@Te?p^iS1xew<!=1CDi-i(e)T%xX~rzqU9_eP714)R%Scsm=HP8S
zUUk>?J!~0owsKjFAJA+GgsHAr`sm^0SGE(S2xZ6U!}%x2E&flOH{5OWN)h>@4(Qv$
zLPas$tGVs9UrCQ|1etE~##G1tGR>~D#f(W5&GN>a3EwSbu~Ovw+lcRe@p2-(3!dT}
zgnspE>(w?Qm-1)lC=8F?nK$DZl_ra$s=`E8>8&xSqGUlg3~Nk#v^y1Yu-gd-fn~r4
zM;X7Y52pSqQ~N$OUo$vttphZ@Dd65M_e3#|eu*rURsx=voMn33GHd?jg{j2Tp-Fto
zR**3SG_p2Ikgn_53kI_Pv4n<ut%isQArDzeae#Xrv?iZyf6{;9Ab^LaPO`?~d*n8;
z=N0tIzgXr-<Ub}Q->}@m>t7_$s+uu3;lVWpUF0m)!vRK5G>*qFFj8mLd$-OaP_Fk?
z)vIU^4ma-KFl{tu&D>a}+w<5Hn_?QWmUUIa`eG0Z;PnMo--{-7Cw6+s$G@L!XM1e#
zRXaP0h%7qLfQz5d!2pYOFyGm!w5HR^-=5n^7sh4Bgvam(P;)sjBsPvmK(Ey5`C*m1
z^vRO$3wGr(k{(j;ZDK#YEsoio@%Xy`*$a5FefQ(ro(BSshTe1m1-QP1DmXdbV^8=@
z#oob(QH;D7EU8-T>OhQHrbmZp)6pZi@;I!^7w&O|WecwOWqPy$u70e4?JGe0bSF}^
zkwNghPp+-;0aDn*loam!W`SJ$MS(7z;}6^1`%)_e{M2l3q(zi`**k<K9p3lh1#DKf
zvrSSLd%3-7#U}7x+tQfDeUsMhpDwU1b~}65km=$El-4{S)5bVX$12^DCpxcXT$I7y
zvEd9!VpYI$ytq?r8gT2^T6b`Fvh7x3cZ~;w0NjHg+KHPAAU6IiBR(t&o8~V5CTb)g
z6ZSb{9dk-8BBnn{@e0HTBaOV{-wd}P$)el?n09lGBr|><HNR?HSH%JHRqwCwTluFm
z+?WpqArhZ*M9$Xr25oo!CLU*QNt7Y?CL)vXq-c9EW@FF#Yab?Y^*81com($+di^?W
zMI8UQJDc@;GLwG*pJDxLWA`_HPoUR47h+Jh$@hE!NSH&|{>p4GcXlXXbL~Xl#Bq)C
z;RpV?qmzA6KT*YGG<QWg{)W73J28?Eol<F(!<@&9<e4Op<PuUFxZ?2p_MJ+*#l+$j
z(i@bw>GH%E){J-^2^4ajoYH^%I8s2^91iWY>Xul$wEddXWs{2fqPTaBdq5rX`sQp`
zCQAU#8GIVYRsV(ICEe@gypY(>)?CLC^b{0NLMAt{G~}T33rG3LeBLkJO7VAj7~j6e
zmFS`*le6j0WJ<?qmnSn$lsHr$)LU)~oKwEfYDIJrGne1kBa?-Ikved%dMG0u9rwJ(
zxue3*pyd1h_f6q6Hg7S+tA(OHFJRL-d1IHJ!#b$3%$Fj!Z+IMZ+>$PB9_|T%b_h=W
z^6%CPC>OZKFu?MK$eGmlA2+e>_c9cRQt~|wC9kQ5;*GiMqx(b;w|?oiI(gwS<#$Ic
zmv0S3dM>yPrx<llcq(^o)*_?HS0BnID%@a-@<9>XR)V~*DeI2#ksfiB3%|N~{Hl&O
zKR0kcU}*7M<qp2QPYY%yJyOl#C$>~vQXY)@xOl@aoWbbxa<b;pZHafVZ>e8PA2?TN
z$^RtRR(<vtcR!MM?PKqYo%!xZuM0sU7$djlf0x9xbOhtqP<oEy-*&WX3Tho(+e>^T
z9rO!*Wh9=P2<xIv8SPa8IQ*r_j5S#Ju?iahOI!W!>VfYv?di23mPGx!mz0YEc!*71
zT0RBf*JueuB?xyr%0edM_*>nEfU!J2@<Iw*U~z7GKe_{W_;taz(|LN?9oey?mB)a;
zHxIx?S-soJ#zGzz1p}hoi*b?uf%ckug0(VDXx8@&pxuAiL@f%~<tZI^c-E%?H$@jw
z9r~^9#2h{i_+;A@a<0FZSYC%ucP?{P3`AYD)cp^Vw?~+xacU?;VJG~!97Mf%bl>+U
z*uVaxiqc?=<#;&3kI(We-?DL)zl`3Vr(%$T-~8LH;2NmSifJKl@&*1JeR5uo7{qjb
zF0^}qnGbrhybxlY3sqKjhw-}@a~=Ci6X~5`|8(kZ)(zchw;V*qMp0!EA~^FVZ@ejG
zWE!~s<)@GKhyjk@%>u5au9ms`Qc{nYrpKB+=KmSJ7U5C02o|X`f;hRuk1HNeUN{d`
zy{mtWn>Re*{!@;Tvb2tLB}v*K%bEGeKK_;EI&3i4A5x=zI!SIKqWm8B4v+C?I{&5W
zq@QKi39%6aE{^SeS9tfBz;leGm4FhKSW&9t98bUG7Y{y$F+8Jc?p~UFomhg3G(99|
z5+D`>nZ)I$trqUbYya(71s|3JeJ+(dRvrRc=x{NjNr>2iAuU|k1*x4vs>Bzgp>r5w
z(w$!?MwKA7hJ@g6Sh+zcFQyH5g^;#&9)jNj{DCt}to^EYaYH~XS#|7nML3u%Z9I<B
zd_Ut;v=F&JuNwE<=y&r7sIy<{eljP?{hLJm#=tp-<=|pf52htTa5kpo($VK>O>`Ht
zfce5Zc-^zeAFQaB5S{P9O@Fco&GtGoS17l~jLQ)-RVe<FVOZ$wLe9}#Ykpj<y%iRe
zs9Hsd&CnW8s+(fPes@ch&4R?I+g7|`7TFU;G^pa1Nme>H*I^{OSgMQIG&C!w!nsWT
z=eXmoVDj+SqX-LetH|thha?=VT9oFJw{@~t;@#?}JYP8JEgH%(gN(%+wQr@Rl2(;M
z0kc>Ysk^ymj`?$A&Yts8_yWe6NFdizNwg}t(BFTrvXE~&2Wa7~)yf(=>l%|Qva+O7
zXuWjHu>5vb%9P@G<<<V48zAaR!WjlUe6Sv*_JX=|4R4Pr5%l=SlA4(Oa^h{BC4M+g
zey!7^h)@G_Id9`xnKKf~4-XS(eBb6JNhvwkoo-5)D(SQjSN%aze$FUt%|N=K{Oh1;
zM`0p7JI$jB#6r3BDlaylreuMFW`>V{GB3gBcHcDDhW|aKb|z+i({T3YXDl&XxQAVb
zT8+1>%3-dPcQ*@&$4VV0mI%jYS&OR(#>(<p>F3QZ98$c>v}XLJk(LzZw7_9cP%fO>
zdL&W-yFupw$sSJUoFr*0Dk2>>w@|hKQ>BH=i{O;@l&rzv{!!lSIL!cmg=7$!%J1i5
zZ8PXZA;<fEc0T*RTYHu{1UaPJ0eovwaehCnVxr0zkapc}Sg^lGQ8HjrdBy7@_hHhf
z(&Suo^cpv4c&n4b=^=jxJ0M&zJm=js>$;M!o~%}3D!s+RfH@}r9+gG+2)e`k)Yt|1
zHADZm*LP=v(#y2k6ualxN4^oMWvf&vK$(dZTp@i(;1YH;X6)ijuKKZ{@Hb?3hQRNJ
zPAr`?M|ot=^3cWUe|sgPu*Vz*qDHnP<FlCZgJV-bA2tPBpxa~r4AEH@mL1qlz5Gaj
z3g^*XY&79Yl2PqrT>2?8gukq5b4kl24fgupqxD4sQjYw|Zk~|dw=M8WK15W<-qVUr
z%8wNs&&%;Z8n>i<_Ib%vFz*Pd?^CjP`9~F-Hdw^eu}Eb6%D4UsMY7U&)h7ScP?c``
zYF&3<+_NjZyen{US`~}q>psiUCq0yU+VJD23SGdQH3?o6{emohbGYp__p)6uX{Gx|
zX2?~>D1Pf;SqNj*A}#4F?ccE|kc$|{v}ae~jEqbuQ2{D)X?wh1TccOBbON7f89{4>
zYNi|cjwz|gu0v6#*jCN){qf0jp?lqL^q+&}GBUIB*Yc*UbW!4|$Kf)bWQSUM2SP|+
z@bI$ToYAbUXiLg<X0VDN!F<>c&*y&E^8kv18!zDHu&uhR<LhKuoa>M{Y3A6hrf0e1
z#WR>5d6qNssX|}X;qEU-S4}sZg}1mpEcX=ahHEaL8lp!7XAV06-gz@Io3gtMik%t8
zlPk<?4^M;n4(}p+<u!h1BiFg4WN$yKxaxtj;#o(eVurH^9ai2y;!}D^v@%6sMgExh
z;Y#?qY)T&A#u>I8e9!YK7$Y^wfYU2NzHle|%T*nLYW8Uy%f4<l7#we<Pxs#wP<KMg
zK)aB=vRrH+Daod%4E}*M#1$<eiBHGdRd1y3_7>ilG@xihKbQ@PXOSpIk%TLm0S=Mw
zNC?E;T^}6(DJ5E{m(K~5z9b+`y3IL6x}Q6k++)ln+&D1sY_-XX>RDL7<LwilG2n_u
z)1S_eE0lX(<239%=Ct=A05a#XODwse#F_w9iB<K@3Xgq$smiU2DKCnbWJw$PNjsr@
z_vW0Yw*~_L-2_VP^}bv!=VFn#F*47~T47~qZ@N@=q`9f!<#|}<IZcJ0m!!$obfP7~
zAKZEzqO4BjADd8Tno?dYLUZBl_BUyriRaZ1q%WTzN%(Q^LlPIG9jejXR_#JyjG93i
z8k6650jLuR$xUaWbb8?xv+0;VMK8*BD$aZ}y~a%sT}_jVA2B*ikBz{+w>caihJSiA
zKt`BGvRY@4*hM4(DbGRHxbd~Fo;njjFh)A?20RYJ%Te}4YvuEByU&~+I?eG<kScg<
zZg0=`=pH;<<GfD-?QN=~Q&hE2yz;m{M)7hnmY)|Q*49(7LNx-UJkls&&9Fpli;<&S
z)$2hW+w)#|?bvf-Qov%8)DayaaFHS6`Tg}bs#iaK31*@%m7mSKv4zetpyAH9dN9FS
zYN@4Im)~%EJ_`A)VGnNa&nuf9*)ZB36<}cT%t9`UX1?+1c+d)KMT_A<t*qly(u<-r
zqeo%_gd~US?()aK@EB>rj}x4bWv0N(8R(Ky7Nbh-*g|{EsQq$r4Z1{Tm!|fj>*i*v
zXd$1rmF4*R{?WV;q95hD-VtuxU0NIE#6IWeMJi7f_Cx%7Rc8*^LJLMY{oI8$lSb*X
z{lt6lMSiw7wTgZlKcZIr7sjPxVE1)Srt>@DQQU@k;H-J~q?=xFL6OdqB*?{Tl%%9&
zBu~FYU&39zcAq9jGIV68M%6nOY&s;Im$j{fcL$1csU!(tTklvT@nH`la(ec03&`4#
zT=^w7ZWnm|t{#k5O)>%c#(_v>Mh?5$edb7lsQbFWt?627FMg+(FX<xY`Sc2O)<noe
z-3BsZZTe-rv?aMQ#ncwZH>~-2jl+)5-zA=3;|$ZD>8hq8miZ|8B<V7pxIz6`gB~Mt
z7I9aFU%-!e6nrFa&VYF2B;sO7%&3D$@Tca`m``D(FCTVzjh|Ib@|t3Y)To(bRtEcm
z)eK5eErWbZ`b+uKV_WE|+!Sx*t&eK<YSiCipRdIDKP(NUd!jg-vaz+f=gg-yItqJl
zIB1X}=zn`b=%ljI2B!S+XzaSrZ5fXYfb+8g6rJou-)9j#)61v(82THK!Q#Tz$k@Z0
z3}?rdQ4pTrWR2w$v3R#f1JuvMP09mZqC}t6utWr`Ihm4-^ThYu)n>7qS~C6q8>_oU
zt{|<T7nA;fczW-!B)|WE91s;ZIC5`u=PtLnwKPXIG|gRRS?-ksR8%lmTB$kHN-J}g
zBNr;J)HJP}DY#2haAG2SdA&cs>-W#$=HlX<>x}!H>pY*2K}M&^o17>668K+<*uT5+
zdI4WB`I|O6luO2FoE+cwHm@6FbYXl}u@H^7))u#X^lC-uecIkv5$h+<eDDb+TP%z7
z771%-#wS{_M%Vwu5GA{>n`S<4m6ffhr$*N>-=)bIiPmyE*C&tsSS+?X2&eNC_jlRM
zy`|Li^S7lXvhFkgYChI&T1$~yA<<D1-EPu3Fq}CR_Ht2?22WX1Rc7NbHx0c%+D<N)
z{+w%h?Rc05V{~XJ?_AGSyzDmc^s@K#hxwgBABd@Xz-h*5Noe)-?r|`WxtIJC=r#6j
zK_cC6fX>v;B!1U=vS>VhJLzs0qetVJ^iq6fEBLs>hpT3QZIwUX=k<DlvU&HC7di{Z
zCp3~8|C7>2k(7P!sY=QfyS2}EBI@=aBslkebO<7XymxPH!uojmc0$2nla<;JKK~be
zh=}s5UEpZdZ?xxy^H<C-It8L1zioQ%P6x`;&rFneycBPbnxV0z&~V^?EcTEGuh_TA
zMWn&RYd7D@JG``DHd;RmL78`DOD6T*^M*|1Bd6zXxEjA|eUkQC)5#dtIy_=oUKlmI
zBzNWFO*iDlt5-n{uICQ3&oiET88hQ>b@2Y(7l5ZwREEKMdCIvM$I679j>;z#t$S~h
z8C4~UJ1;%hl1-n#MUT()&!O_nybrqMCAn1RJ|i5$;kP(qtOjQ`R9!;r6c{V#rqKoa
zr<p(Zp!JOBpLY3b9c8~|RZe={C#&`M<wb`pa$e`h|K{LNGeGJ87KEE-ysLzU&l?`e
znqD-0ELG6VQ=$vK^#0meR$losm2yoC#w9iR^7U_OB7zQv-)f?p4;XK{WnKLe-I|d_
zw3fV|D{5j@{_{vta=DXfr3jVyXyNjJno8m05LmlkS4P9~oYLXq>z^vGf~E!x{Lb9{
zFd%#zUv%$h!lxIt84|Xy)CnD5vabA+bE)fg2fWyQ{v#T=o_St#ETxbs6l*D|V);7C
z?A7bs$J-=(;e_)E2{sR}*93Dh>aMjs-Klea>-eFP0XecvS4+51Z}Q@08AV!#?{`tu
z;26Oc7FXion39WgKkDgagF+3!7b*e!YxWWs=3}_dft_a*^&~!2#Wd2T6>ta|ja-UC
zEFqR;^XlPr|BU};nD+mD{O|dH#f1Q%_OWo)qSFq}Vz^K+5C}UcoSh%(!jQ!2zYpNK
z@00)CdTS6vUa1#$iSNIi-kjO%ZwHQ>=Ur~%yqkj%e|((dQ9)Y#UuE>-|5~Pl5h0R9
zv-Ffm>ak)07aL{qDTpq9u&k@sC=5%{tz)M)J1|YXiQ$|ma8-v*!-V?`fWkKl+9zm$
z7_O5FYFA7If^q}re*fGsRo`0ucjYmGYiLuUgDMi!H?JcZ2jy?9MaHngp4$&@-;WN1
zni@e#nm+rhiACd?_82#6yddVg6}qRM$Bl0(0CYYeb|R*?CQCFys5*EWe1{Z+SzIl_
z1OipED3PlrS^t*XWtL4@BJ>hMkF(bdcLk2XWAo0;%_Cg{2vq~Xztdu0=9#JG7N!SV
zo7~(Zh*lyTGXK3H-c&Prt7fhN7W4@y*0)u1_^0#NBB><}(>tCi3mby0rbJJ{Sqb88
zb2-wud5(jz6*R?O=}sU^@D%ij8Fn-OF-ad@m{fkCVV%Dh#jQ24OImQ}vobe^D`#s^
z-P*agf_cYQKLO&!hbj4Yo#5!~R&`8&)LKiKM~tV`v1QGiUq{4j*K&Cfh3>8LB_4{-
z^{*|2v_f=<kxpdIPXx{l9RH>sMTckrNv^u#%4U1~C>BS|N{SX1*fv?c=Ql7in2OCa
zLae?4kE-vj5p1i90*v$X3nXmCQg>e;saOj=iONF7gu(e0g1zWoE#|81n5PuVf(Jp2
z>2I;{89bLjX@jxy-O3Y1CppI?+HSX0{su}U7jLcSL&1L9z~C)qX0Zqyt>25^SHzsj
z_;0b-=;hBR#xJqI;2=?icL7mWdu~A!>k%UdpersFJIy*3M=12(G0uFW+R&!o@VWTg
zSVx0-U(}Der{4_d)OC?4t?!ukdv+}|4NCqfy5Vc7z2}>FO^d^JfeCTcVgOO-kfDyD
zreo$-+smxJhqNHJPo83f_X%+sD&*lhbr?tv4Fict6U2vxAqz09*l^5U;FkT2;!|i5
zWYg!@6;`d$jXDpSU|kFitPg?)6Z8W8+-|$^z=M4*$G30NP9BdvR6Rzo{6uq+#DK2M
zF_5oLKIe45((`FX(g9l5sj)hvRJ@~YjITB!E^mi$z{BrfTlzx!X!tt`=5B4z4sk#i
zc!!vyRfw@eZKb|6*!v5Qyj~q#jo}FqmYj;bF>iOQx&836?~*z{tOiCJxelP*voB)~
zo&be;E;fr?712+n#BZi%rA&>;Prugqs0YVr<qS#Db(~;iyYrPlpW&>G^{1MyDE=<0
z7)fDrv{m+rw_D^qJB&{6Uf{`rMkYwmVUoYkmmw2B89%y8T#|yH7qWvKx>r74mx;Oq
zkmVq0&=np?y58Y1Rd`|MD&gw0mZ4F!OK;Ad76yX`$p&?jqf}He&eWhCyz1V*nTM6u
zS`ZOK-ghEuep~KKkC(#BYHt`ilki7Nve^4_Z2-}GCt*j;eo#GzU$S@q9tnAL*TS{t
zKHklO)mZxn*H7CFe;}sAwBXg>--JP<Uy!+8p5CB*gC^^qZi_wae)h4J)oGV_IjBZ%
z6t1euGHO5xC;#nHMYDb1Tc~5(9DB4sEcR_d$xzZ~LDpz6JOK!-J^`Ko;-VVV#dC29
z!S_19`+U3SkB_-~jCE!hoITGA3G<Et_LHh&+)mc!vX0c}UoXg5^|s{wy?z8_Jh;(E
zx8lKz>#I(WR<H^Grt)%2$VK@t=u)4zj78VwCyXtsPA`1xnB8>9Izf8ai-ecxy3s>W
zI{_fgsE(eWCjq1>E^W`tN4})LGcQ7EhJR=1*;H9s(fK2FPV26!0tK8IgCGn-X2`nH
zIof^U$dmO`<8<-ghMRaUKe8P#>vD1K!Y`$aHY0Fy*CUV_^&lHs0!`(fRK|Da|F*{u
zlX4mHO%ICW^@HbGz66|xGVTqy?T-j_e=;l%yD(|LiFzolo%IJO)E@lfR`EBmpHDe5
zv)#ktXtTWSK`D)eC_)`1O4-QqBo0cB5k#zD8B0x4)bJyoLMU9c(k*|ZOp0d7A+8*g
zl{q=!`q7e>_n78YcKZ`j)~%N7MzS*P+TOqR2mrR#eKQI+$v;iss1-eW4iV>V$PA5C
z=fc8hoer!=Y^GNalbh&m4kp*W&Fkh<oh1Q1Pjh$29>nt$Cl+29INBT#@{dTMGX`sy
z>trjdH$e~9iXWK{bm0fcPfF-#6%tPOP*mcSWBB}igdOH`uendjO*--1;~;SOqZ^g&
zZw4WM_G^J+q&Tb7=?_#VKU$B-WKo=qQ?HC%qJ%40DoWuy^baJ|TbgXuvMF!zFD=&=
zXxnkxx!?EEIv%?H=l0`?JUl0@gECv1n<K}M4jx)m&%+1`FshQKGt@w{h0ijzr$JWL
zTyF+_NUkrXoB6XJMLU>m^{OwcXqc*>`M0o~T3xoXsBu*f;0or)2L-URc`6)Bsa7(S
zPkT=@!&$Ka<2GdxKt5xT{wJ*A3!)Y%&d=m#$_{rL#KRX0kV3+~XIQrj0fH?Qqme{D
zw(WuivX?OgiOeaxzL_ygV*m(VQziibvWl|HL>&O^<4ZZuAiz~2k3(JuMve@Bo@Me@
z!!u=rWYu2WMDG)BkDfGuO2pRP;jGi_CAh)ZeI_cSO*KO9HrdgbrK^wHuAxiYIm0g4
zJ^M~aFDSyZ&GSjw*oCM%&sY7hW#+_X3NwTSkg1e5M40aPQkv3UF&vZlQ_0I7O=X61
zGe|YFwsbOmBRx0t>MIrZIhXJ;cE(bCj@@sx=Be)yX7TojE*!)#{+g^O-=il;c2`Y7
z9jLImCcLJ?T4c`^hJy1NYu-TZSk5(8kGr-`AF_9C=AsPee+#*py^P6RcqmGTxZ3>^
zf&aXy8Xot0L9&r-1JWbK0WU1@$M1lHtl%;9z=fMFuUFy0lDdeUc22SHd-B+*z}W}I
z2vqepf$$=j)Vpv7p?t=hM}kXk&ARZ_gW=H}eq{kbK4iJ|C=Cm{BNIM0BBqYMOOr9B
z&7bjVX|7R+7bgLDfYu|niQ~sSPsP&*k;bl%fB;5<tS5847gxqS*8{k?SBuf9`QAsU
zO8Ex3{3AqFw&WYRQR}wOiAqjdasgCCBo??@p<_gSW+DGXrUp^oN3Rp4T=8UHIfPaI
zt+%R<4rtw7E4vH8>jG&X!)~w%S2cuC!mR1kW}*Rog}^v@C>I0~pF0)EiMmsiMUp^{
zb(A;`dliY4c>-vigzq7M+#rB?gi5D+iOOo%Gl2)-8Qr(YdIsc|cY^!47DqRxN<AI$
z1zdwh@1k*AZwY3QKa|D*5o27!EzkKl4!zUL+Gk7(F$#UsS3Gb<Ll@3Pf@WZSqJoXp
z-9@gOBm;t1mpdf%>R;^Vcb%!AQZ+qH^2mS9T4AbwF5Gi^t8OLyPxSp<%9=y#|4L+t
z@Ff}Xf7TzTg&fuI&_O-DLE|k?G>BJn71jD`L|v9bLhqzvy4?jai6Skfg%_wRy)XKA
zUAdM@d7{JzbZAuxjB~b^hB1Ys!|3CvukOr9C{R@X+@tPKXh;sOtn5xjG!hT$-(%q)
zZaqAbzE5<3idsSw52F&jiUk?U%Vc@%w>%Nq5r$=he+3U{j3D>fGlxl6DW@nJjhGe6
zEr;P*vgk)YegPN0P3U8+aXpP~i12u3=W=!RAN560d1}bwY11U^=Vp&a|4jj#SPn5}
zme||XvNXzB3N`#|I~Xm(LcAQ^u!u}xK$63qP}mfj*$x(-Q)<i<J>1JR)!kZWG+~%#
zXh)r*tjj4tL}{esQ=&lv)^}Gmg`cRm!&o(kzBRR&y3rh}@N6b>5gq#!GWe0!i)JUO
z6}i;JPhF@s-hrIVbEwc+YdXoJd#Wq}dflVVKc{_0YJ)X>uF_SFTG5>Ijc(03BIX|H
z?~(hzMueTb_wdh_w;3k4Jq@)(4+Kt9aFxvK3hCQpJQ5~JPu?cfQl2dyU`T2=*q36b
zvv~MM=Yf{jiBblBiH7;S11p|f(S`*5qv$tLOpUHL6ZXE<s;^>1C61n)we6ToDs9Oc
z9s`Kx(RpW2M^WDaQ0XEI=tZS_Xo-d|Gzw7uBMYa44p)O)-966J(}XfGKmqwcvCi{M
z{zoxYW1^f0Lm81v;8=#v$bkH~!?et|2z_Lc2u<onFpS+rI9uUfaDN1;VkkxSGS*hT
z+~z}SYOUlN4Jd!sC$hjD!XmSqc{ej0yTl9%GHnX{LDWjX#xgbE$=LS5CrMutJy6P{
za_1#j^*#mzh}0YD>}oM<4vfR5s00)7xkMp1A(0f#K1_ROYl9gnJLS;F=Ypzk(GVdF
zCCf<d+(@WGr1@vvNa<V9Ds^10Kkh#65zzB91qJ_WED5p7c!yYkcDidm=ZuzK)>c;+
zPhVh2J9Gv)E-fJZbx}O?MA+2k-y|t%ML*Jfdn9qWdms~$C(m$ru-wWrwl*$)xhecu
z%D{3-QmLG{BstdSW$tAfr1!iw+81z36SP$SZ7hoinziuj4f9MWvFJR{7)n6F(|BHY
z=IGNM14SCY*z-5;zvlWw-!mW~fGng(oF-E2&tgs+l5Npx^4HskCs#az)f>IY=|B_S
zPoAO=xxRHuM-fn(NAFON7%28AA^?4Q<A6p3TyFF=4oad(qS5G&VkQatp$IMbhbSi{
zu!t3Qf*B~TGhBtg`)P&QN}}d9f$yStswFd2i&3IBLBkE}coEBX?X;Yqie)n9$Gl;s
z^oJ3DU@hk-AzhREgdlqgi;GIJkl$~^+6TYJHgyw!8bxhh#a(+-rwqqY&u(K+yJipq
z-uVG0Rpm7;V}N^q4pz43&abH2_Kc;PlNW4IJF5kLIzQ16uGzLn!P+w=-PHnXN4RB>
zoXALFXfQNwr*Uy!OJzI*-u%YzIJR0mS4fjwxF1c+T@<EB3a(uyv-h4=3Rz<pxy-!-
z#leh;Ab<kEQKKLElPrmP?cBrKdy!F~&)=B=aTWQsO@cJoerDHcM8`;gscKoG#~&G2
zWo;n9BWR>ggyWLsi@T0a625r^!Hj!xvFv~#Lb}|7pnYSziBZA3SWbz%f`BY@s<qug
ziEf5n{Js4(sFBM0Jniy(d}U&zg(v5YjW8UQC-Wp+$f96%6%St-8~D=$S`wZ6IdnA;
zEnD#8iC{uELU1#P%2loXkR8I%YIoCGrLDoOAs}%<S=!@O&F<8QxgEPirFP8<JEMm9
z82ZA#n@KeO7L4cos>N;ujh^!XI01z2D7ctay_7RvDAHI?l-GQ5_srW%#$X@LR3xWL
znb@J|Ez>el)y0vOs-UQG)_ivEPXdC(83d>Y(K;0~Kt&M5G$7X@?9)k;-Al)kMeQZ-
zvW)C?I7xg)#iijXmqk{2fay_W97R%L<dy@Rmhg%LsCzL2nfsCqjJf`SE47UILJK79
z#2#316U0q&K7?QJmehah`f-Y`Srj%_RmA5Vd-2i5VA<biaigeM=_tCjPn54MNgTER
z?M2M(D^X8m``=PpJN6#Bv)!4QLZ_4Fn+VmQ2Z;Te_f_gN=E|kBsG`>31{pY)dWerD
z;=fL30uHO<kc!{6A3onQ6U55O8{&WuGVfiQyHDG>H9;Gr6qMcd0f&0Ni87ZiCYB??
zs*#b41Qt8*?QR-{K69*QxB9}jKbt9Rza&w!NAl9#XnVlNZgv1aE>Fg4`&aE&H)6K_
zy;jTv0UkTa|LzJOwR665JjD~_QWK+z8RL<u`y&S~T`iTT+U1zitzHiLqAOK~yd_1=
zFN&HNSg91gX>B+H?kLm`cx3j7e-u;~7!wK4{Z1NiXHXI&sW<6tO1t<Ax<#<`i4@`S
zPwx4Cm%t}G(>A~lVl?lsw5Ne2xPT&T4pGQi&g3&;#<QY;hx7+MUfYd%gCs4!fhF+g
z+v(P{uU$77Bup5_KunrEICRS$`_%ffb-eqpZ1Pvhk4X0o;0evxLILc7zhNUF^MIgU
zpvbPKTO+MvR&9y|7}wjDm#HTfQ$vpvKomEYn@3$I3<i83N}}lY*pj#&qk040Z92^{
z_Tr}u)y!#FFOcaw=@C}d$tSZz<26{7<x3%4G)e>enIHlycsvcf?!-THD=i>F)VUK2
zvAq7U#=fyl?z8(Ajr@2k-q`BL#9EWJf$eM+fd3z31h2p4VoQR04cRK#40Hgv5h;rx
zcpzx*edo6jNHvmpkIrB>1*~ezL8+5no>L@`S0q{`b#?7v6VlPc3}_*s0f=+mo7&sD
z&|fC9!6cjrambp@mrvg}{n?J_6}Q1zBIYExXfbPkIf{1a+^-5vPYB4ME#C5U<;}_#
zhQNpCC+&}T!uBamua00Wf4>TF$2%u5?UA17+~C1^SxeHxuKiv>XO!6=L+bF&efdkH
z_No#kB3%UGL_O~lkj>$Z2j2kwu6z!#_XDC%za9?m3>_j)mu?(dJ{Z#}O~8Ty8$vs|
z$~7bTdeA^Kq+!)+rbJ{k_Z|$+1Tev4Au1(@8l21ml3rrAv3xtj0*oGd7C>%x=9TTz
zbu|gKtGUhz71g2|`!*)I|Gep$15AtJOf0DVa*voC*twMZo_Q*+Cs=@LE&iY%v|f9%
z@{ESY%L4&dm@6F02kLm~FX6DHbf4cZQu(=efZ+F!5McoYSY%%}GL-|;D%M%FNiu?Y
zrf}x?^li#s5CB7;@+N@eL54H5JmPw%02%p{<p*S_yVW-Ko>h&Wr;Lg5P?<d8(o1QF
zohH^dLSm$l80l(0W68jlUi0g5c?&>28QkjUycLvMx)r7;zFsX|GY8hc7j^emk#%d3
zP9M-Jbh~>!m%w#MR`?yudVG83cQ!bmDx#w9Fx<?X*)9x_9W0R4DH|i_1`pb4SrO3o
zJkC#O_lmU?%q%r#3}8=^V<8IfzeFRuX$Fq<SW$29iODl4W?KzqqCzxLs(5`Wod!8+
zQ+szD>-8bV>mAv>ula9Vshxh7G6y%u2>$OS%IZ%0IT%UA9@A4!&l#1{v)E+6Uj0OI
z9+Wy?pJ&+3Gimtt1g78lcdNbJzNzf>k(=ArfWqghj!lujtTRFB?S~*FFX*mC*gOb1
z%dC>kU(>%#ZS2BCDf#xX+H$1G=90+js({BwMor{ko6>(QjJ+<i)NhxAe4@<#G@%7U
z%hCaeq)H*%s5n`pNW6>*pcYmY^K&PvfIW{?5;BC1xw>$K)OU(Mc$KI$#Ff$9SgmCt
z<R~I%P*eu=9HzDI0+a~!m<l1Z!%QzF*0!An5Bl03U}t+7>kI<ciA{onct&`FCaz>N
zXzzzy{ca+{u7kFIev+*x%RQwAX1|~Q?8aGB9M-`3yYQ{X<P0iZJ^rQ{<uYyABX4wc
z**;M&*EGmU#&Ss~dC3?n$MD|PWOh>GuYY#L$6jOWM4(_(aX#iba`kMVz29z#4cT4F
zCW269g^rh2O<PU*U2w=X1S<g{)mS~{`H~0mi~%{G6Wq^*L5a-qCAM|!T;7Z((;>I*
zrhb+_1>Zs7@@|XR3A2M`v5jaCCIf5TF&xvp#+#_sv7c_K*FyJ8mFc^_oFf6I;eAss
zOZGgZ&yr&i5-oH#)G4v5Moez^=6y#U#S{Z+aQM4sp2GI79)S{w&&4c)9FM5+hHf}-
z{nHsn%sIc^(EDzT0ME-DCM{tcdzM_zi+i<;yt@*m@E!?A0#u&N8`>$kcX-wVESbq}
z#w%C02B;YNeN3CfW@eQ@rIed#LU|}tNzvhxok&RBD4M6++IK!=9Y%Cu<R)gk+b9SS
z09x@33I~Z5+U~+vV!3XOHJ%J%s?4pc*(Xguk4I@uD5c?q^9qnIJWHYGkaRRm^?X~o
z1L}Gm?Aa$V4A?rySp>gh!(DdTJk1Kg^@yV+#pvQdQV|R+rmoCRJ6!Z7i*|>AKoY`(
z);NEBR@8ey-(1uMX!^&=d9nI8snvJvDhO(Im&U-rES?@Iizt>3KdPBDlg)ZE0zJen
zW6N#e(m!f981q*k*B0F^qdxW(x@3OUIzfkXzkvCXZBk9H#OA9JUJBG9nZOaL#9w7j
zcd5u<!O`<y#S)BHRjt46h{0GTHGv`K&S0(gT8ZAKP}gng*aE|JKiNAP-XcN0a7QCp
zBD(<NpEECK@SJ%KKkNbQfT3PwMqX{WKH&462%GFWi(KR75{SeGUY@kujVPuK6|SNf
zWV*#ucio<t0#FO!dj-#(%_UR?@17!(7hH*s{2n_b7_gXPpZFwb|0yD`MlRJq-`3-G
z^+DN7<$DrR?xG=I?s-Acng0o`(6w)xlvX?C(A+1El1qrT;f-ybM1_D;lKS_70Uo$j
z@Y8O*j5!C!&+DutBuyYZq34tbbZ?PW<s_lun-G9?lE7Q{ovXtn$3)Si<s6p%(QFuk
z*7}^u)}WH;VRE;kzPH;^z3IiNmJvrdC#CBW8%Zbs>>6IU)M3dP-O16EoDu4F!44r~
zS*{M#DN*?ysZcs#iiiV0-ca1i>-@%`Uf1_D(D(0;ba{sb0DHpjpKd!?w3QO)A5g58
zrQuGoI?<`-!hFzjVD=+c<FiktU^M_y#>yXq#yO0>_<kmqKI08#)Fm=%amxgJ7U$?x
z0ySX?g6BNswM{CIjQiQx=_n4d$r?Ana5<_yi-r6$cB$<CfiK5+G4hp`{;s5@fLU^Q
zA2*XXq~tufZ7DaZkfY|9VE24OP5*qGnMT?Z6nG>u`&2Yu_BNI8<vkd~*Z8~UTp%Cb
zN#+X0H=av^UkX?TMh99)v7e>%A(+HFOi%j{+#^){YPdd(RZyZuF$u5LnF3lnjST<X
z>@4nrvFP!RsI~G;aI&u0CS)1u6VlD?D=)T*U$WgdQ<&GJF$yQ5+kv-J1Ef9&0qmU<
zgTy#Kt!=w*CRBZ5woQa@lyiOYe!X`Z9?j4FX6(4mkspuL<&Bg>#wZ(<pgNAOz4sN*
zI;D0GK`}@*@h2iNlqc8bZ^!R)>8*(`3dlch(i|6mH!J(J%ke_xD)T~d&Z2{oQ{>M-
z_XwMopuyisxFy?eb2qyy#{RBN(TwIZ#ZKKRcqBA$qz6q$rO<fz`h!en>fKns;0;xS
z(xDIB{IwR}ij)WkF?s&&u}gg2@oP3jlXy16H+C1R#{*IdkJ$T>{&o!*kl|TtlYf&X
zGrv|Oq^=w$!p^dFa<rqK>yp5HG1X$(Gj;6t(Zc7?ZkN5de|NvgV&^wFyGMmsn6R0Z
zAVh8NKOQA*5lbf+eBK33qI#qx-!2&xWHB*RS@}hCeYaL8ddrP;saBaA%VNLeO6*_p
zb&}<9yp$`3itN@-+%E9Av_I_d0Lwa<KSdHg%2w_0D_`|39JpP3>~s-4pKCT=<8KdE
zI&IT%g~v({1QoD<5ehMVH$;Yg=t98jU6y?GNW01KpR~0UwMj`uT?rg;#b4RB^X|e|
zH78v7OHkN&0kLf-><OHoOiUrCgWq#5J5VEuYkObcAu>vrp=}MH4{0Q!gi!$=1^a{T
zBm2Bs1Y(aP=W^D&*A?TI(X>tkIlbn&QdMcO$_;Iv?M;gBnRK)dl_HoMCrMqT!Wlp4
zp8X|0i9J`Gcfq1>2m)e5llYkf=dD)uTzY+x!j8)9=da|j1kY9swt;v5sgz}AXoE?q
z3+{#{R^wzYgFJ)tv}%E2OtsmUdy$F!dEe~G#!u7kh<@xZH_#A-0SpT<OZE?GHWGt7
zb%Va+OOLvG&Jun+c9evX>BgmkBw9Mlg8bj}i9#GLK;X_lLw8!1+Y7+Y(^L3C_Nh5V
zN{@>I?sR!(b<@gVx-X=cJ7h5(#6U!6Dy=?0X^NHl^VU0`{q~-ad5glMf8jtW2uMH|
zCaA$_%9AVM&pN60$N*(&OI#jee#LfJA`yQtBtD3lSkN00^vpw|MChbW^UrZ*@*kYd
zzwROOAnT{LUVS?}-iWDj3u1Sa75|fA_Sfm#4GAvK^waOrF$VS8BCW*R?91LEC?c?N
zsUREb^y3fVuUlB}Yzw<xy5Y^#7cD_NgYr=ZKe|1oac2rVQ*hy!;Mq9yl*^Y#@z#oK
zV>G<<R1<-nhT&PI1cTtk_oUz{B^2OR=0&O(YKD7c3{+oZr{&#lTO&(8mG>o8IG~@9
z#s0pcysHe0g~TPCe2M(JA5W5cc$@^x)F3WpCsAL->K2Eec0ryOD&N7qe*DUYvG+U#
zEtveN8aSb0OU=7m_L~Xw{4Sv0AeQSzE^4#igG;#_%!nkQ+|J0lGvq}a?hsM@k-`@^
zg0976zTv5=#9fzSC9vP<T>UW&m31?=+aYZY0gYk8d}-{CX&Ro4*0BAdfLnu!>5ggY
z&eev$^BV&KGj7q6I6V8U&3V&OWCj4uK^2)Y?LSh@DJE*uZ64f$Fl6*wB<*z<tj9al
zA>nw<>nQI1cL_+8F>e>Rl(%&%5sA(}n4&|2#@#3i>2^C@@$53o=K!k@Z;ChoaGN&_
z7ikZ*o&z&Z_dtLj_fx6avHwiD(2#YClr>9a@J_#vv$>^)8bVyXteocen1)A5S?{#7
zotvy1G`G|zybqb0@xtf^Zk!T|HgQQgcv|<BNk}+x$d@WfW`Pb~xr-xxR97)uD~r7+
zI%?v&gx)Qmq?^@}&Ir*hLm8sQ+i&9jeS55y{}^XtAjQfyf^)b`qYV)=<zO<la`*D`
z+NGAda3hjY$j8k$a4h^b@%qC01Z@B$>j%PvMr8KS|G0;;IK3OI!VG=mDL!WtZb*0l
z<opsJD||P?!ieK^W^{-PUn^FJQFF<KLkQY5yy?yLQu>|Urss?Y6vkh8(#4I>-eL)+
z(j%!ol6hRl(ao_^ssrc}(P6veDU=CI%ho#(9`*gPec}roCiVN+ljx(A+sp3Pc6gqt
zJWVWM=FQM}A}5oW{q@|A12-@g5F|S-&9Eqau{x4R$mDrzyFU|)SH5&12Ws>^6HF~r
z4tihN_xm?J9wPFI`uBd-@Y3XQV>iu0bb8dAqpUhX_eFFgIHcVNK~c>DYOW0Gu$0Q0
zU~TChYaqWNbRJp###z45{?#gz&idzour1InOLi<#n)hjUmL8TVKvT1rq4Vk4k2Y7X
zjtkt>87v(%fb^YJBLcL=z}`9e&H&*O026_gCE%rSUJnx3iU$Pt+yNl4#wkUQV&Rb9
zpv~YEGp2}k(Um=<<n8wf`JNMB+~j6h3#klxJ@qX<$-GIu6U*ybjCo$PQCO9!?F7LB
zqILAj$7KY=11GmAu;*q@I-s*VJ-ZVaE*MVSbOu;#3}*!TM1^r^0v>m_wF`A~C6*?!
zpeWL5xUpfgmz7D`jy*sqMNv^b-3lNtuHpxD<(%IbkIl%1@ab^LjCuNs1LjVwv~h`J
zNQ1uJ2>eW0cumiF>x#(D7gzI534^_W6p5IrJ?95l=I(j{q~rC|$cgP#*><1~V_Vhl
zhhiK{Zr=c!31=TE-B1Izf;xAz`r@h_3-@l!Cd1%bHiN0d_1c9L`Ti&pkY@$n)f>GJ
z4(KdoabG<k%-{icgbjq%I`<ip7&M%tvO(O=YLHv1o|%PvS<z7C#X$8LE~$WHbscA9
z6>|r>t@yBGS!UeC+ham7+b(gUpvn?*R-eS>yaM{<<sDnkIS&<IpSV?hZW$;d8FHE!
zUf82}vp%x#iI=q4A5vgaG(W}mUb>A2r{kP}__A&wJW>79N}^~trxQh*-2O+!eg$WF
zWG1Igxz_t$SxcsG$(Aj|E1WGMvt2?aFjeMjDpk2bLir5Hv&lltF%hqC+cz$mKxFaZ
zWVq%C=mUNwQUNIsZ&^#IO3F99x7*^BsvO`p^^g1Rs&TxC!|i%X&yP{MQY2lUT0es`
z9CH>b=JB;#>?U`0z5*e7XLnL0i{<qdY^u`W8=S{%am04sM4sEEY*17Yt+y^+0w8hu
z6PR}i9H5bPjAvA6YCuVZQd894sdc59yxWIL!9#Q<E~og$VABjPTdFVS$T0<(;ZtR#
zajNKC*wWdxzgl#4V*vot7O+%7XgwPK3&~VpMj7q;i#Ql_0>dDMN#A$f{gS?VX)~=n
z{7Ou>w$!m}zjz`3zdNXPHPC%kOYox<qntN`b+#cr-;JMugfr<SipAG+<Ca<j4PGSy
zunW)F2~Zs<;B9@3zB5zfXDpEcdEDR`(T|Oi|G@(!c^_(Kt>5szm%)iqQ`x`k3yG8{
z=AJ%c_;e9LA0eVV1m(@3CC%Yf0<jq)(Q%VeS-sj|;l%7Kf#S@_7E4~DI2jIu=Pw0B
z|A@GuBL$%>w-0hxCtDW6U9B3Yt0OQtlUV2qJynE}ikIAu?e9@9V)+xZRc9NpUMQ-|
zd0U(&D*vlEp+T^r3Gl3z!LYL99o7@V77uWR7d-J;I})7$gMU48&L3ykq%uO^Ay!&A
z|DKRb6HIwhW91%+*vyqFYt-S|ZFxZ~#8DiR<}rn`gy3;N=S2B)r+|!kbr|DO)+R+8
z#1%~Uh;-iP21<LtuO;(=P)~LLwmRVZAH#P@r>-=EaIEz~!pSr^af@rAm%8OhYxc7_
zI`Z4Yda?)u7Da-9YMCDg^}21&k9fYqUVzVDPNVp;pDRliObg64G&@<CTL*eH=r%Bc
zW6f14q@hjhHeeK|S;b!U(o-`1J!_OuHH-DGz&V6-yqhSMOyBZfk9O^P313XuA13pH
zA9n-jJF?UTofe+3LavkA;^lHP&Ehqbi9I9zT6mBBwPhTbp8f&}Uq9xe$8^w67Gf8q
zUF3k8vNqzWot<!V*W>rz8f_ZJVTR7Lmw8g6gV!>l^tpmQoOCm{{BPD^2G)7G!;S(A
zn%%CpJQwS0&+UrJ>R<J|dOvBwvFKoqvLI&8hw|xUiO@;3`VcLf(c$M}TUx!j0^MSj
zq@!e9tq_5=MN9y5NiJSry)?$Ze>uwEp9+Ll_+<P$zBE$XW5xV+uZscA!tJ}p6qTH~
z4Y6a+|0c2?4+ZPwJ!ies-{bi^qeseAci;{9xy8f>OAv)s+t{lA=@FR);AJGmzkR`P
z)LWXiklyT2du!Hmcs1uAv|^;LpKeBi(ltb?BR<3-sQSGs(rBGN`MQaxTA>dYWDn-^
zQ;9NwdPX&sMh|>K#ZE+um|<$SZ{fEnNq$i<m}R#e?te$(0W5W@x%=^A<XAC<Q%cQr
zK|kdD3&!uBD9*FQ5fNTn4RB#1Kxd3u!fPqe$qaAONHG?Of&y}gvpaf80A*Axbgf+k
zSop9j7WAb7-Q7`0yLO;By;#i!;=rDHH-b!U>}7ga(VQct+BN}rQ2X;BK29KG_wO8s
zIl0JPN|=<Nmf*{n3Ieb}D~XG5$ee;%cU55Q1s}l3y!_2^Hv@penN`CuqQbpTqM+a?
zU;Ct!ICr7HQ;<SL0)qp8s~wdY_K!IJC>uUV)k4`@9`rrb&m&%8=H6=bt7G3WFxGA7
z9YJ7nID&zcOJv=z$BS$IuR(IgVb38uJav-UL@f>(V?_1Emf-sMV^v@&Fabm62I7k1
zHImlAS&V*~3!$DGKb7<+qRhC4GTRK0)trs9oVroYm{{P0NIAc1TUGRPIX*NAIwGBk
zA#qRmMv-}quL`H<Gu&HHb+*)gO=2oaioU#I2vDngW{%Pth%b=^fWSYE(Gmp1gbXI}
znuJdV?(Krk-w{Npq5f8~2b%*8Zw$O5jFimujS@SGm5HYqL-UPOxzvsG07^Ys2z|=4
z0l+3VGxYLEsgD(9AkArxo1B^h1F`2T5S8=thQSh2QIhK<Hf#e(E<r*76${RCX>+MJ
zgBXAA1Ot2=My6RxGP@kOGz28!3)!HotGA8l#s$V;E0`c8I)>e%v+lQlX+NOs{IYb?
z9rZ4ebh_k%nN3igOLb~aVK3v{sJ3jTZINYf{rLfc#liM~!S=;q%`iFvtRo`I6{c+a
z(LN2wx)-px#4#=H2V*hSO9^LRZW#kYUTZG;Y<B)Sci=27tm)AdZ@OCuSJpx+IF?r!
ziQGV~J&!7Z_u2ONk_<5X+4o%3C5H4oI8@VVAgg-n2A8%e4}K}57CBujBVRW=M$AnO
zO1vMq?j>LeP+T(NWH_Uit+syO769g`UEuO5(_-H(K}z1&{H{8e)z!k@##h1#a7d+r
zT_!uqkD4oe{~%#)dhYh?LBlPBAeQ6zWWG)0QSFrA&bn-Cbpkw{HP%{$E*xY!3JE=w
zCWd16DC~e&*CnZ-F5|GLOVZ`(4qjf}g0m?3iSIthnBlM1)8Ztd6fbeWK<)rQwDr%+
zjvzqaiS+{2uRnUxE1nAPcH{XQ!XQxXX&UtPYCY*7nEld4(H@=4+8GJ#VhOj;^gqpl
zfks@J8Fw8%<Gy)6EKMhOH%fA3ruiv_*@hVVBrigkk3TRVaCg?Q(nI8j``oT=@9wy3
z;Mx2U9e~Gj3F0?H!RIu|{fK30NI;lLYdeb*Nh3@D+3zCx;}BXh2?$qyteh=ljP4?F
zdufW@`xEStl@gUf{OWA=kJRoCxmH>MaBQbs_xffZSxS-Y7Q@nR_k*vF(3+zi;utk|
zoz9!LRY>hTB$fOSQkzw_FvSPE+e}JY^JoL&OaFcEwyykPVE>ti)!_KJ&ZZv65Z0UM
zBtCq9z?130DV&xqa|b>>Y}K1t`9T;t{fB7ht4Y?MWrwG2dkiqEz%nsTcDL+JSl_Dp
zVHs~GZ{jrvc#e7<%5x6YPA?Y+R^suD5T(BY#_rBDLy7gf-$f-Z6W+4kLti$Pj)@x=
z(`nO2CzqljdALg3d5fL2wG2sOFG*v(gQCVB<tgxO!InjL5iSdp10YsLSOq@pd7BDk
zB?`8)h-wDsq3U>q35m)qQA&s_!PA}rl6urAibc<h*l(PHD*{oD#tcf4zameLT}^0Y
zbd4t9S`KyL@r-YO0rlFX5sKS6$nxk`eS3t6nF;8enl^!_a^#Qo$z$3J_=T=DoDB~u
zSgl$*4KswH`%p1PX6nESMQ_CKNTiehWOIMVe)+N`u6rwK2~Opi@(V-YRel1eSq_0)
zCh-hi1D-~wwutz|Er#6i-J?4>luOj6?V4wMo_Rhv{iNh=5qEt^K&x?{CQ43xB)k3i
zdzbwgd;h%C;1Zz_{)A764&cYio%n2aZH9L@=v&a{*$(D%oF~pGF>Rhkn_wt$hp|4?
zR)gx@k~;!sFxWBw+^Vm*B$rh8NNpj*&iPxasWI~sLyy!tJEP>z85%I~uDINXU<31=
zAaq`q>Qbx-5h+3+-1R+*6zk>r*8hOVUBc)6$fht-b^R06gcqAzKR?0gv~-?B9afaQ
z`xuld$A`^MK{m2^>RQxh)JFsZlr@jgkl%}?;teFtfBRn_jZ&9Fyj5W;vew1s%jIfg
zC6JI^Gv2W@0;Ijkek{Wg<LAuDXsqx^)|r`BJug2p85_ak%J2bM>M5GdNEYuPTC{M~
zZ0C*g<Ndm*cA9hrKv0mzmD<>ScCd5ibo60WU&Vr$r|LoHlwoj*dm<o^J}}_^Q|6aw
zV>!hI!Ujuore429Y_f*W$#ac=DX|a<c@AV|tx1cJT~g%y>opiko%K!3G&sCI?%K>R
zmVc3|loYEFU?BIL(G1Z6gbHA~TNVYnzcF|)qL_%^Q|2UcG<S~snz;TRhd>C|naS+b
zhq2zq5-WE>Z&S`Lj@Ya?T$SJSyryDrQO5>j+8#&teDpv=9%reD8h=|3T{XR*IPUZ7
zA~|4Q%Ds6A@f@NBz4_0BN!Qy{7SF$ETe%eg?OQWO-s#bKfrK_O(!A3&f<m=`Ltgoo
zfP>K2gPfnA<_`A_s|SaAwjzKg!FoOC(K&Kjb{cZvpv;#==9auGhoH0f;XZJ3)>rGe
zw?T}XejS(h|E*)9xk@n$y6~XWvqwW`l=BO$W6(RwU9jPweJmVXWAmK91CC14@fV_W
zfhOH(RxU`g$`@!$i}4cjU6v!{exuHy+XWz2g-;4&{i*^(5h#`*qHBcAEHpgt{>mmv
z!h&S3&1L997XPh35cukBJ?~fj{)BARBXw+(Z#K|>ya+EHBb(2&jT-t!2UweXM0JB~
z7uSiC+h1?R^+=TK3F)$($C@5%B8F2v89n3g=kYMQ4KM`FhOkv!^S75}u)HwbhHtD(
z^8cOYD)RFja`P<Xm2Qjzugx<ZPex#KGa9-=buP+Bm$+OV_?<{^SeF1DTaM}!xrchZ
z8HWpwz0SfsABcUR;(vASg`9&oC<(U259?$#cHpu75f29NN|kNOgt%#Md_J46n=B!~
ze${`C!KCE+l44H%C7IAGEp#8#tVrj_9}vTV;C`;VhXNyVAbDHmvr~gYA)Cvz{aQ%R
z6H5f?=cOgCG173kXZ3X@zO*kK3C{Yz{eqCJ%#aI)bvrmf8BP@iaEK#RzsD?*tJ&hd
z7cY45qZ6yFdW{78OeN_?5X4MCQ{KrqyHhvYh@J}IFgIWm@F)Ju!OWvA+Q~{TRaSV>
z;ZCJBr1iD<t=qj<+*uq8;Hr6a$hc`~C_$tH_x$wFHn{Yt?BaAslser*#Jae#mPze4
z9vu)e(@ZN7;`cHKPsGMcXvC!QpNzbA(hiMdDu1XRL+3j#-F^Xky!d<&bFM0z5B%oP
zX|(T%y>|DXSx@$~sU7UKqA~0R(NJ$2pS!gw6<7SohRGv6K`#F2_m~**=1*H2Rc2JX
z-T-^NFIVgrstgo69A^4?E#^x+yhe^mov!8tMbkSt)^h{!r_c}i=g>VL&uY*G3I=K7
z-Q7)4EmqiTABu}02Rn7(56+?yCLTg=vHHuTX>m-V!S}7eN7pHDy6>(B(viU+y$&U;
z^y}a5*J+v!K<O`Dr-y*#XC)_cQZ&NwBaJRR<%EH2`J5_Ithkgk3;f+GM}9CNXTS0}
z4+ZxZD}=i(3y(b_`q+1Bu!vS18tBc?{sXQ(VTc;zsBBR|Xt*ey_S$?z&1=1UgAi})
zSmH02I-7H?`Z8{XAo82ZlJ$I^pn#-!q_h<Q=hz=eOV73%xJoNxXRQ8oi%az0uNpF6
zyT7qO?Z6qYZ!>Z`i6tdb3Fmu)U}>%<;YsX_=62~&F5z#d{pL&(6vmZ1BkjU5EG@Fp
zdR-(wab@YHc&Mse23=hLNr=cFdw^;Z^-2{tY6z!U?n0!GQK>U?V}g<`Bmz9uq;EI%
zX@-iw^pm0KeC^+MFAq|_&{7>Z@b?@g8yIs@@RK^_cBjGfFfLLHcG4lx)o=|b-8s}@
za8#Uy*ba0RT=$vQAPHc~r4F%lti3=DV@iRqZBxP0?Rj9KzD_Llv)vhRh#xAVL_@zk
zYN{kY%u3D%0sOI5*_)YJoy2^K)vpbXPPLMda4wO{3)!w``t*?l^`Tc+QbclSuMm;j
za(Tg{g|c)b@zCQ}Nj)qdqhkg3^F9E)Yf`=1jLb7<ytZ_}?Dlp?p>C7%W{fIJQv9+-
zTavV^EBv%H@8L?z73);e8UPMR9oF(H7L3|7D-u*ynlIPu6ykyfNlfdvDINWH+S?iP
z3EMJ4$C4s2Z;`o=EmnYM&j??Lupf`N{1L`x4gXs$>{&Om-skOT)*F4LzeiJkbXtz|
zvNUtb8GcqH5$Cg%;nQA)5Ut1o>Py-9_}{7jT_kyU=qG%q;6uOtgpx3ckOFGyGX7V4
zO{~ZAUS^fAmfXC+413Jp;gW6tQXq^`U6+_{rA35@yfM}`xQ-xjuKx5<daBD^8{0Mq
z33g`v_#Fo`Pm)^`IX|g(eeH8sSfKeNjUX;8D#jAw54x3EW?A@mW0j)QHQ&OtMrIk8
zeHgCd9lPmPI96oR(5NIu=P$zYP=qokRi|@N#p)q`+hHk5%2xa-dEgk|zK1n=lusET
z!5#)oj^*8Op2Q6+VF=Yf%9;?J^vI`_Ww`g;2*c)Kyw6^$I$Ou5sI3ca*x8-4S(-0J
zSN_lfZjDhC270ANpC9tH24s7<yxs<%Lxec4T|Ii;I7~;PPDQMf9CfI~!l%RJuZ)XA
zcDQU6@`Q>gbn?Sb)YHO7woa`=M4oQqau-;KYLl1ohGH3(ELD1yFH)4oWlpHMnDOza
z`*K+_Sus(B&y>I8yE@Cx)rEJ^oEnNGqw{ltbjekj2+qlAcQ;8$&p++qXvumJ?Pm2H
z*bq;S91ODT9b~^8WhLm~on$kL4UbXgTk7vl%a=q@B+ZATY>AVZ1q{GiZsLd}0aC53
z7avQ!!92TeK~%^X=;iy@p)fQfi7K+NXUx#{i{)K-1`SnyE7bWjf~B;JJ=#Yw$~CAC
zCCN8hbF26-9kpOr9`xN3q$epfLj8{m7GjtEUB*Q7^Pj+56Cj1N-n<U-uQ?-n6l3@D
z?pk!{2q*(R<qTHce?;&Wy;k|~gF57J?CS!ySa~)k<!NM&R+x6nfP8k*xT1Ldt^K{<
zFDopI+1!)=)}+0CH-Ko`y5Fa8KL5!KI}cPWaj_x)CiyJi`)XNl^*b+SFbbRbzY}z_
zk(rhk@p^_{KL*o_KcCg_NxNU9fAK4Ht(RA?N<qk}A_t#-j!(O0BY`)ko>iXrN=jV&
z{N(u0yuYoUP8whKXCwJ|FI`GY=lOcCNbtQ~rGV|P+qW%P9M)gFxcQxU{Qc(}!*NBg
z9SdX6=dM?tmfc_9^L?TJ$D_%jl5HWJ5NpRWcIoKjdO+cR{&r^jT5MWv@5A}qyBe1*
zl&+BPUj4Xq?W3H_i|yjPYsK`r6dFD~J)w`;{nvuAq>cyIuiB#DjcV}nUP<_?aprNt
z-OiWA$SXnW8tU3=E<2q5_nH~aY~-gj?M)a>ChrzyS+uLXy;f&*<|VJ%xpz5rQzs~@
zRjmn4S?A}|;m6%G9-s?->Y{nXh>rEA<6V(YLv{!o?m6ODxQ?Q)&vMO%Hh5lO&X>C*
zzcDV;btvu9*{ywtSyaLQ!CSo!#Pk;1d85SUKTK)glqO_%%-@?{x{}Y;@NXxv>DAuf
zFx6T{r;Ce&yxgWQzzt)6y@n()ijZ`<`ilx*-d~-okv;Qvr}e@&u%?n~iS~!=sx*r$
z|Me>IeIUqYmSdyE^0flyozBaQzcUYR4BqVqTy<wUda0U}89sF9wSTp_Obutn+bWGu
z=?|SCWdMvr`XBWUpZiU(T2b?y6{e{?MemZ4fVk`;_Al**zplBzed4M29dLS5t{PRL
zA#8kk_8`H)ttVEm5%M-OsyPYu^wy*0+f{vv2hgBze&F-YZDWtxCU-TQ+ZIFNv;_r)
zp@&?Nrr|F#;16FnE7@0Av8Ioj-JDOKX}n?w02ux>dC^_=O7s7Cj+BdPyqOjYPV-qP
z&yunW$9KSN47V1*cUhQD^$r%I#fWF;4g<b!Q0$_Cc%6G&(6_xCjP-^+MsolAI}Sl|
zNfLPfEdTv(zXHYn|Em07xdi|JzpN2^Bcs|f|0Q!QaY#o2OEy?C7XOc2xlEMwPpukB
zrEvO04q%mRu4F~`Ew+$SI`t!g6Nko}&kwIv`74bZGGoQ|k5Dzv(f?N`y`d%e|7@;F
zIyctoR@FS~d&egj*b)ohlqY8EsIekBfFyqAinr`JE0ddovwolH8Vh6VdwV#Nfv?4}
zKe}grJ~Bf@)kCy|2_vv|l+W_z5K$7Q@w)^ltlCQ}=r>~Tl50-_?BKBIhL3UDRiV-?
zVYf6T(v=DE2!5peZu@(r`j2M~!W)p7^HSU&g=nkQZm>{vfAABH-vj2Ba$x9KO00Am
zTs1ykQLx8R7=zNN*ErG>^L+(jI93+4wKWM>7qBlBRKs^%h#4EWHP1BZ-3U5pirMRa
zUXU``=a-}sj)CB<JC*8yDs$N(?F)+7F<(~0CJ=wKZ=7fRA>VCh!NW+Z%$*C33uFHh
zv{#E08Vkg#Pp_cTB291**8?S^e-%HnNbceo!N4!r{VjH*GRWwk4oy#3hU+*i>H5CM
zus}CCPd&t)=H_b&0Y&|>rxAziWMMPp>HmO*12`7t1+63*yK=8{xpHIT=q53#H|Iz~
z=pIM4bP(pP|Eo^048C7({qr2BjLayqBKV8ZKOePvNudPkjT)@{W`Nv;r{4@Pu)GPZ
zILGqI=K<=#mi+`yF`IIX8KXgsn6Kw|TUI$=`q~ftWKiRk-V8?vxi`g(S&J`wN1{``
zM6N>jNOfQ3xG(!=$_9e&PkbE{#Amb~2MvS*tX89M-0+LIuxM;HLpDEuNS>1A%arI$
z6*Mo%m#cKrm88&*0J51D$AO?hVWDo6ubkOiWT|5BM^dNrauUu|BrJ=l-d@!w<n@d{
z>8eX0-3#_My2mXC&y%t^0ODI)U3tH799c?EMU~%PZwa&Khb&8q!ywyAj4d7x4W9B<
zoa+>@r*H*c7KZIzl6u6efT|nUQPxu586IFY6JLL#4zh{@$B^NjSmyh2o!vzf)p72A
z&%BQq5(HaVGPo$!Tnjz%lc26~inNMKy%941z29;zlNFL_YBd!2k>s*BGR%3Fte$4l
z*h1$P{tL#jL6xGwiGO-CX5Qcpk!61<J1~|WlL^m9F{&>}MjvL@p-{*HIqnfa@Ac?f
zm=e3KB|}J@@dJR0T?I+jW0jv(9A|FR%)C_!l~!%hSARs5>@gCgw7xBo^50p~Ff)=>
z0%t{VkR2LdWp(9qm^9pd>e1PsK>TF8M9O)Sfj6sGqkyG96c=kJ7<9z}GF`Rm{uZws
z+Ww&hK{4*}vi5I(Vg3ah%s2hbQANK#qd{u(Rl5|#KW4ag?WkwT+|vj<f9vQ~(G#`j
zm_Hk@(3EUc?m=fk0yc(X1xUYQ&$(9(PxBn4SR_!(HJ9A4%iohzw&TFBpW#8!7v;80
zuE`ne^e2K|#pV|o7RUY{Q|BGe*89Kz6A5A`_7<B`d(YTfYE*}|_SUMcVw50ARL$02
z)mE1lrA2E5v1+$!mk6pwjiRDb`Q`on{PX)OC+Bf;?sHDgd7S%x-Pd(J?@*5*iF7`}
z3cMsE_#5RB$l)MP$xwgNw#ag^P#s%Z$fT-MSi(m-m&!fj%Ez}-MU?ce4wtC)n}%MH
zM%tpe|FmqaRAhG3=WVyjc2q}k<!5FsOYl^`H2$(lx7qdcqEz?bKySs?L22V&D4Q$M
zG!#u#t#E66$i;QsdX5vl2<OtUOeFc?@~?;BzC7bS>aKuggpUxA*J^GrJUu7lp}qR^
zZpWvdj|5(@Qm?-jXuEwl8hQjQ+0N)l`RRYAyJ8!*>hqXvd}{fHXoyg532?0r{0sgZ
zB)cmX&cUUPHvazX0m=N^=KB&wk3qiZt$WK0cGi^`mi%<?k#OrCwf8a~hhO!f#*$Bp
zXVD)0nqS={@c9}Dt9(eD-?w|o&yo$b_n-Obv`wgBG<(X%N}Ji%87&*c3h<Y54!Syj
zQM|kwE!Z;O_xXAEqjtN6MPO|1s||cnz|GThUP|LS5|J9Pm7mUB*r<b=l<`~1ffxqC
zbL)&Y`D*Wr3)A;RC3t(d2wv6EaN518nQ~Th5L~Y3lgay|mLtDrI`dD<5NJDEw;sBm
z&%XZ~G<Dkfttq-!y8n{yz(zq$UG+x>FC&GaEV<EomYq{)`3f26oxk#9Vej=T&{@W1
zd+I2<XCn^q&HgCB{oC0eAh(4o$*&JuY|?{P@I1dJA+Z-;=dB&GOxj~<Q*^(Fa<apP
zx|QCkb`i`+&<T+wkmECWbtia-F%vHoZOzgI_BSEqY|Y5ku5Uax@f`2m{Z*w6Wxiv#
zO<;lsm1nE&9E2E}(S0^V2E|hiDme;-&7(1Iw00$%!&O=-1wR$0>r6~UXGu`X?W$*e
z9}+RdxzB53&}E(jts?b@^U)`ta@y>i#`aY-ZDx0d`D`ii#uqx?FIZ%vepcqtil?|P
zAO8Q$n?~2X4aA|@gL4K8=4~+wJcA8=`TX}o9r4_}rpA)Hk-WoTvPo__O`j6Pp1|<4
z=i)d3V=yuj#?zOoEQ@w#lpgoo>BRF1Hl)uIADV);yDV>H){6|O05I@RvIeLv;+K%H
zZ_Ch`Gye=!s^~~6tq+JsigMp-^+;ewWP0m&%>XDzAX%Kd2t2&|VvkL|n+};rMMyCz
zqI0A=<5jEyS6L{>RIZ|L_8~U=;*J3?Kpzlg$1ey#esK?0FaZo-LC^fDR8LbRlw_|4
zsnHHl90H3#-^bvwpRNH|+j=6@%s2g$bNo{(&7`T0RgS?81W$}6jp`;aY8|yffX@X%
zi4>J8@Q6&noL_D&V~o?@`N#O|IUR7A<{oXw7EloI8F4W*|4x%C==23yP+;LR3JJF^
z+*zV93@{~ekr{N9z$H-iH=*AfSVt>>odVETu+m}>L{a7tj-%^4R(Tzfpdx^fVm#P3
zpt~$pe>ONV?8e7%MU<~$HaZuCQ1YxgpR$FZe?j`RLWbtR!DnjD$+xn{nKICMLo-9Z
z3xb(*`noUe#PF4tu^?oOR>;RX9l-(}LG0DWdv_(XJ;>u*cr11hb%FX&ma%i1j_2=n
zWA&>E%`EPFGmw!h!d!HQjj7e~j8C*Wz@H<?l6y}UsJ)g9`tlJh*9^#2XYACV1H&JO
z-@pm-!VFsl_|r_11KtK5Exq1`-_9S4AtLrql42=G>t3AQU6R5(r9uTxs${Bu1o@v)
z1H-4`+T;N%_`+?L6_P|VCV>?#H`V{4ZcJ7Fx7+?QM;<??TK3{c9~ULRXIwW2x*Ck=
z(Oh(7m2@IBdrC?nZv(j7h8<2%L4)d-ea7}}?jq8ja$r3iKq_h?I&8i(i_T{+GWFGf
zj@vMz1HqpRA;nhYJ5-Rrw6~Sx`J<EPk5x9Fk6$Jx!f`B~#6)}*orh&T@Zt7!Rq}jJ
zr0CV8CmFxPaGXf|o@oGyQuc-cFKz6Q6Mf1^h5@$v^t8roA!2>VJUAS<^8{|BA5Qg<
zs$#pPu~fv1w1%$C=04A?c=O2w|C<i*VV-%<@cg3-hnJg(d20{2TMs<Kycb0O;0BKp
z>jTA)aIzJjsH5)Hc3SQWxb4A^r=h|;8-@I@J67TSqBcjq<e1jh67CIl#P#`@hib$#
zx7cffxdu78g-M-tT4`kH=#qUu8LBblQXUH`S=??C2stI*%9{~uJMJpP{p(455$X!1
zP2w-==X;30@x5s;uuK2TwLNawe7LcFJ_g3OK&!%@-DN&$iZq7CpqB>w{q371;!S4M
zx0fe-#MjmyUW!qWvM2C1+R$d;@SOlyZd21oZ0278aGb?;gYNAKzQI-g$BPxi(~Yht
zdFeAMP;9y=+c=7NH+{GH-+5VLF9J_>{3;o0%n0HuB6FfCr_rOQQf<-!oM<H}*CLVk
zHv%DYO|C?=wM|;F-wJdm8M+NljkRGFe)_g{T;%)ffy!k5(>Z$HOhX}LtX6hqPsSKU
z#IJMy7e!q*>n+~LJs6x=uX2GyS(41JyGTsOljr~*B-2B)hW#az<cH##{o4kUYU80#
zy0px$YyR*Bx(rJN-Tnw%Z`MA|e&)=NMAD15RES}jMpR^_%)t>Z*Y-FOd`BlYDn!@_
z!=mFqP`_M%aKD23fZafAaAYAUmzq<16edW(wK#mYnYp2s5HPI>Y7Q@)M^|bG{E_4$
zxJ@kQ$<jNF23W~c3yaMoZA&|}1cMV7Phb2CbMYz*%kUxnvZ)=aT>Gwe=Mo1X#nx@0
z(GUmigG$ybc+EVuSIMB84mcCmg7|=p+nA1GlYL2}Y*Smg*3G~i`){I%L`Z6MK?T&@
zIdvJ9Ib*UqVuCi)Uw5N>!U`cv`y0fwArOp9Y0JN^J14VXWHlKJlU@98YcC6-y$eRL
zbhsck9BRSC<>V*8YM(M<<vF&H{rZP>t5uB1wj0Y)#lX_5Q*x!Of<ZZ9#NnYG+WKc1
zd)uqV2GyeLdgAKFIZ<EhF47Obx2s#brr_Ep(vIvac9Ws|^*zsvcr#rE2-~=j7VW}j
zvO<lwHxuPbu4DV6J)$9Y<g-KnU$#=Uk(Bj^mG9rQ8(bEd{y3t>1c$7X4&KX!jML&9
zBKUcu&6al<56vF$!41cg`hL|J5F18$R!I@GB4SEg-SQ(tr*6T%N`dnagq|l}l+eCU
z_vsePt5Z56D;<TYZEVR2u>qF*_?Tj;<!p&g-FsWEyr)o3<^_-}8}BTZnLN^67VVbN
zng53DlOPDC`AhX%lbnBx^+|k5Par_{x4;&7Gb)}U?MQys9JHun_ycd9g!U1sKXL3Z
z2Q<%^CqD|}SK+p1_2a0=S`X~wIo@bX$$=;<9&B{?=Z}eOPhA*uCg4TT>mO+Xs>2Q@
z{gp#&<JC&1rmm#%HK|8wPD3jV3wfZvdnou1@Zv-27ep65o?YYWcTeKsfQcL7RQ#)q
zo*s!3yCU29VUfAs%mMK|MR-vma~obJg3RigWG|`gDzC0FMq^Syl7syi0psSE5$vA6
zG7(P+eKuqYQ})veJWELaU#8FPvvgLgCxGu}5bNK|!Nc00-*t?!b%wQHPO9`jlI2?e
zveRbY9a%zZ;kLfLo`tT;*fo@nGO3rm5y-yvFSfwxSs-(DpbnJwPL`@&O=$Z*gb)1Z
zZ(P>iVq%%W)3^Z19$+f~ot-LeGj4$%RvAzV`^<|ZXaXk*03R%bVI(GVrxfdlY;hck
zoeXTT-<x3>>Z@kkH7!R$b5uAd571O$ZJxLIP2*iS!b3ob5iK~5FeY+3-;3n>J#Y<w
z=BPhqC;P9X$phgVw#NLNJ7zY6%U$nSdLtY{s-JYvIlfWvzGWjJQuy~wj|L0&scY10
zUsdGeO6#ijN{p`J#Qob3*g{PIsl8FNoi=VooDlY4#Z5Q&KD9vICd;7EvBq;27b}`G
z-`@;$5rggq>c)ugPUg6&adF8=;_@Q}Q2(8`gq7~EHz{4pvx@0!cQ6WA)`Ofo4Uu|u
zW-dZTMYYru%;5%gY)}1)a6Rb}Y@}PK1)C-DCqa3Fs2dV$ODq>gI7bHezWwlw%nnO3
z0xk7fLSpYyAW(h=%Z}-#MCQ|Dh;e6*rNS#yW8<b37Fp7b0>)pI-d6SXm9gZ%&)B8r
zG~#nr9*$3FxSTq_dYGIjl|5_8^_Na`KsZG0qk(^gE^WMSa4+VhIzk5ZsbxSuaLVtn
z=gu9|_sWf`%GXR%_k~<Z@u%|7TebH_SPMAXY^|^aBoaVFcL3yCC6?p%dBEt8#TMZt
z0C+gyzG$_b!kKygsn9MG>Y^T2d3;KfxSbznf4hRfu&9=<AN`k8y_RAiK&l^03lkeM
zUeT3L0;V7a?Yk;`Vgd$KP>(D;P-G<$z03)l1O*p((DiTzKK0~LjiNC4rn0O0c1`i2
zWwwRKU#+DZYejIb(WDrTEhFaG3P~BMqB(yWg1JS4QGSyVexGwDSAwjQ8Bp+l%OZmh
zCDC4f*ZA+Xw&W(b*C50C0_D00w5+*EzgvXDbTjx1;j{MFLWj*^xZU9iog!>`wOrr!
zkMiYDqEd?j;zZ{ntJWAg06pdO0{1g+V@$^OR7o_AU@^Gj2dT}P=%_>C#z060u(MFP
z47pQ8Ev|<_OP1hgBpmr{e?K%!%!KLpa)c6}jxe35ky^}WV~i3wE1IZdDs`B)p!H<(
zr-zOSbd>oOy36&?KfD3oBQJKx7u+{P0W1d{kK}8l;>}2c9JO2+U8Dh<D+EAO?s0IE
zD%?o&h>5>ir_B}~b}4bX?Y%kZH8OG!-?Rk0%pJzUnBVS|opuaCYxD&@zV>j6ABTeU
zw$i@u=2TPMV|3V}>^jPjc&>{KK*=e)3cYXYfYrAZqw)fwN)BOq-^OEoMWlx0MbL`o
z1`o_?K?iLfFN}o4bnr}dxb;8l0BXFisF-QZz|Zg3crKQCc!Tbb6(OT98upGOJps5`
zE%^2fRVVjBYmgTZq^e$bKp%M+FXNs_eEale2V{&;TH3^>E?Q6cM=20zySthGNy?qN
zfQME$pFMM5RbFSitzL>1skCj8tTOtuL{;HT-L8?8&kUyq1HDGaTdC-y43jQ_STVKB
zr29X%p1c<YB<0n{zQV>i-V39nJo4GWh7U_DnG3f$2C#@eN)`PR7qwz`b`>B)A$-Al
zlu5LTK8CYwXHL)^J0NDP%TybNP;8N!iARqJP2OH|lclZ-o*ZMp?aq$&wj6)(oYZ|a
zp5M8;_DL%{X_;cNhIULG2G`*P=u56$ef2ur^{DHOu8+9hl821bGor+?=ig$EqkR>+
ztnLdfRKWgbgs0UKO8I-XszvnaE#X-!q;e;P0dO=+xsiBM9hAnYVYrT?Y)<-#6p9O1
zz8&5jt@i1f&G6DGy(@fvSnwcg>rDt9Z{<RpKid0?Kakp-#c8r~iHq_l?wtnYtZ}{5
z`p{XVefC$eQn4fQ{d0Sjfh}G;rz<AyhRS-T{-Cu7;?nbcCl#BALz8HDa0CCvVfWEJ
z-OrGALe+9N*Od3)3K3I@gk?TP&?JnB{*TRIa+wv;Bz2Fj4r@a*j#jcOi=afsYWZmo
zXgAdAsHCzi=TrB46cQnOwJUuHtE=YjkseCL{aYggwTT4&XTqn8)@9tDMYZbM6#}KA
zT0;$vMp71Gi_m?4;QT}qhfKPm*gaOpvC1JZko&=ZUhgzk^8np^cASsU<-8TPf1jmx
zH_L7Lsg{CHtuK^)l{QHSJ|A=?{&x#Apu&m{DFCRzm{ys9X_t{bdcXvOyONv#iT-w)
zDfoI{?Gb&TaJBwe<)nlRRA-R$>yeI{Zp4bg5D}%EW}X$sf)7ZB|LOc%t9FWJqn_D~
z@$t&F3@FbdgXdI}a!Ps}kq6JwnrtRPyVYz$6*(W|gl|4F0DEv(oB^WMaRn(dCHgDc
zH4PgP>fsZ^gtpmujhYxgZz~9YE}3)agEpk-?@*E47$D$9iwR)Dtz!#Ej+`&T$rX|W
zi|Bx2QjC^mT1zd@Td&({*Fq?^nU|(6`c=(JJZ32F1}_Uq>}Kr^OlOSr`9eckhW3|=
z+k=kE*`|ugwDYD%h^Tqo*#*fz=3xQ>U+<rT!rB}zcU@aoxq9Yc(C!lEy$ZwYDaN`c
z3wy&OAx;6%t~MjY(TE*c9mwf?Zj?d~l_ScT0K+`u&zY`owY)2P`4gS{%>4A{vH2E^
zWGpY}aoMF>#c6P$t+=0H%Jr;?JxKO0da;S!k0>AE1{meZ=4#VOVEW6}8M7UQ&~91M
ze}$qB6si(R2VY_XUmScF8l_{$ZkP55K;-w0_lspE0j%mC4l)K2WNw9wq!GgugRa|x
z)T`+EIaUzd@538&k2rrWt~Q*XpGFa3*}C|SnWeE}ad#p~ncx4%QfXIRDaxAX(#RAV
z#ljBfG`e-tmYQ=($lnzLUVMs<92q)upB6tmfO}Ndk2(*73IRs*&@3hXUA0M*6A-qf
zn~z~;usGT0g2$7bp~oxs{T}DADKHgmx0}6K#pOYqnD>{*Z=Ok3#+%#!ZkxkPQYF~B
zxL<9k$%1`R02BajvEwrBc(=nxT70Z}By{|x)Sp{*>!p;N>X_kHA0B9ekgRk$MJaP>
zulFu7-j6u%{}SXOxTh$N)TwM3psN}8180fb-iJ6a3w6M0puIY0Rh|{g4fCwf*%K_I
z0SufMx<~`$T!%T>yx8dcLe4=Hf*76{5g!vUzs*7<ToCZ*OgZR_bEwIfm*n)t&o8Y-
zhyyo?mq3q$lWwDpaZ6M0y6yGoG{DFE@mylBMZhat;`WkJM`v}E;co;cP9<eadyn#+
zrq4Dae@{ccq^G{UB4Xe_g-%^d@4PM>T`OVzGrNtuSFCKak~R@g+aG?sq^q`@hMeij
z(2lrr(<fs(XnnP^1mpF-I_~S$B=&=nwBe(*-_EAfJjEq9e>{pmCvE+>=`kFOu_Gn2
zZo;{sqy{y-GYG-!n-kLGB0Uh&)v1;mb`{e4*W(BG5jK)g7RMB$iSe#N3y){R7ujz@
z%?m=vRybBiDwn4=n|!6@Y9jummE&W6+l;xT?f4rG{px2W81wu~;;#z}fR`r9aK{~v
z=gN4K+#N-lA3RLQKmX;)Mjc#HQrUXuQJFhev%X5>o$2TI%_&IiG^F(jw?9$u^ZxbG
z%~~dzp;H+XQAr{OD!sdP7#h)yAk>R&TwCpcF&H3NEe=@iRSmcXvhn#{fECTG!fmnl
zScx`cQXo2{bc@1lB(R&!im_>hN?w!k@;v*kq0WjT`#nvsXhBj|6eeOOag!PO#Zz04
zy6K(|C0ka>c-lF#J;re)Srl~7T}@t*V+=dfbV=!<*ynJUpgGj)cfyMRk2lP!M(TO4
z+p>-T0fyA8!L6{$3>1Vt1iz5S8=44m_DKqUYCaC1xa%okM?pwQKM{5HUZczKI7m$|
zfiR&swZ(4Uup*A0%3`y2OX<rr(9G7U>gc=92p=f8Knf|nYg)HU-!Itf7JC$CphXnF
zwKCuNap}vyTPDr+-#f2QZ`D4q_9um_z4p2y?J2T`3AwY@tqDytEfQn+;X^?`*IX?T
zzH3%aAM)kK=LFY%^7G0pMp(-H5|i6dg^DLDO0GLhrJ!l({8cWJl9RNbb`--Pp!iNz
z9o_KSYKeKwWBe)!zvGyW+aEGq>AtD<{TD)J(hYSb62!(UBaGyNwB|s%ly3H%)|)Bw
zWM&FB3J3KiC(;1%_v`WI<uq5cticQ#n<XeMyu~gp{65I#?;ePgT)-^DMJ}D8GLmnK
z4_gsR`{a|r<tPsc{h{6KBPQEvP;mOwiRE5^|KXSI#MY{uYfa$#!x`!mHz#9^yBg^i
zn84sxbjLQ#h%4e`X(!Pt+Iz9%)76Q^lwh?K>Pn%4lJcixH%ZpQp101<EFdzg&zSzs
z7?deHFB{d4V_JdZlHG#o;DrLm??nj~yTTPu9~K@r+U%PNw8qF~558ZBv?ImSBbm?_
z7?Hc`TXttV>(DvNlgAePQn`Z^6{#TA>tJ%xEX=lgE{!-GlI<+7u{pT5)-Ug9G59DC
z|FeG)F)?RwmF~whxj`5Kg>-S<rLc7PiT*QV04<W#dk`4S+ZJqx$3?X}W8|FFZU&LG
zx*pieAM39Mi*j`;VaL<@6N{q<(a+_V?rdULd!+YX%H<%K_f^3OHafb;Dmk=ld8U?O
zhB25pS}!vn!e`C-q$k9pbn@Y)__US#X@e<v>t0*%tNV;#S655=k$-NFpOPd`98_Y<
zkF}=)zF_AJFY|s8@ixifKQw0J1-p7E1b3&r7uJ=d&2&mF&>W~rJ1vNNXsr%eQ6?ji
zrsG5xgA{mR_QXeUB24Tmd*6-DT|IWModLmEM@I;*kwzWVhs3WIs+d5Je{fv<*By6)
z4mY6o4E=es<nS(W=b=+0{iYE$N<9j%D}BXt`q10q8WbP=**;<Fwow<vrEikhVWM{%
zR=0gL=~!bI!9kjpJ5+gFYO1^|(qx!K80&(#>FiuPC)R1B09R{c#HUPsfuy|P;gD|X
zv3*hi)lQOWFt7|LezNGW2n$3Q6L{nHX4O;s#tQO@XYA9-f2WdzeT_1xaYJ3&{2Z-*
z?74Y<>^T$a_AV2DeXm|1qy@w228#2!_NGOKcz)g+=at=ac?`L;HH}fm7OvduF_7d!
zuiaK-zw!m~zYq9-|4w%Zc|GwIrr61zl@7%~2C8{#^mIOZo9g48+4I4+Ub;eosuqSu
zTB}1J*ofc|7uia&qq_6t^fvxKr3@8u^w*g@462$UuTCMZ?81^K1S%Uq&7JO1;I|d`
zmLx-7o5x=uU`e4?gwT%m0K2+)r>L^Zeb}*o;PU)H6NO-IGV&XrXjEY~V4K%-?qX#c
zu4RXyclzWO>Ej23@jg2Vi3Yh9U)`X%Nm{c!I-A*>g~+6dy-M=E8j-cCi}sc7UlRwU
zW570NsaCGXi5p9&lJK>Y<uTVw4+`oMJ6@$+o2Qb=$fmgwmSX*rK({GA)}UJZj?P1^
z3luwLXBJ~>sS-k!bc>7RgWD4@4TkhJeV|s~Q+DR1M~=uO8b8n?s@$;odqklZHQ6%o
zY5hyS_v014RQiQ4?iZGYx{yV^fyF;mulqm81fElUbMBg;urU-R4lU?PD+yt00Za~;
zqNzkCAsI`?#L+hEd}N4iNg}rYgP{G6!+=ljWWR-ftp0jpemy@tQOy`f|1G3|r`1C<
zzFyBSd~qEI3477%rSng8J<T0+_t__|&`%d8UR54pJ%7leaRK%&oov(go@?v%@T4tn
z^Gob$Kg)*0_c}CmI$_Sa&HmW$3ZY}h<Uw-?bQ67&Ul8#FX8L_$pvJ|UAtoQywfpcx
z0{Bc4GdW%H1L;85SyGdG(vtZRt2y`T+M^nd8GjAyd)Pf8G#;eFR852`(8nvHU@h-)
zNkQdG%psdPcD#LyMX~i>XQEEwzZ2BDfhYF#%oAMiq$}@CYvOe11fyT+r`_Uo7u0%g
z4l5lZn@q_h*h&&iu9$r`Z2F9^l+u|!%JAd*CtdT$KM|VI?KvjxmOmB6Me7XwGJHUb
z$%Ceah8#pc?ug#SwSCgbNtex5<-XYbk*!RwO7e2Z7}ZviZLC|3NK5K7K|U7`JUd~9
zg}*B~_?F4L+Ns@t0z^cWM4fyGsCV|7r9w^S_5M(mbPMRe2iA$1cY4US5+*b4AQrE(
zYYy$=iUrJM%e|y<U4<>V99rK=KL>_S%i7xFXP+Y=AnRIDPv#;8EwjVO4L`Xd{>R+$
zph*8g#iLqDl>D2c4j73qjSlevq*G@u=9UoNhlykA#RvCeO#JVord<eO5BB5PEIU+5
zH(?Noh8~fvs5BHBryHO*kpz+8T6HZw^rp{I@t6NjWeU%e(-2WvbY|@Eex**aAihn4
zF6ooa%ivoP`;Owd4&pKFm#OR1P>cy5ox3*i!bXH{rcRZi_Sr(@Nm!ur!M*tq;@X-=
z;A4j|eahkAVS;^mf=h*+iv%rO-oca}$b4R|s^6{@PvgNc`WEHy4ar5VFW8gh7FD;`
z1-TJ#j5PQ7f7Zvxn=AK~=k$*s&r<gTHHL8E|1J!T5KG{!ynf+f31KWpX1NuTQWl%$
zmp&vzFUs}Ou86<Zh<s~chN|;pZm+CHp7OU~Nte2Wl{Rh^QdsCb^CBiXAG7{?#``hb
zY$B8ttG5SWcu{^Jf%?$FOa41F_TU${X+O5pm3vdr3wY?XVwdSX#h}wf_<ACz8)rt6
zgfj$HC~*1saacP6V+v!rjZmZfHJ*}*RZxB!S_yuWi1E=Uiz{Oi?#h|NNK3PWyQW;d
zBt<1VXLDhu`%cMEp~59M;V{@ptK!}=3$xeMNw@+$-gbAGFzitP|F^n{<Juji$>0S9
zxc%41vVNs^rnf&q<_vUmZXM0*|HXho(DRFJoYm%ETqKOImvWx#dc^!}x(jJ;5z-cT
zSj3|b{%~<djup3h&n)oco~pp`(|Yt+MO~6PER>(ii6^5sUXo-a5y9o8EaaXhVVI-V
zUYu8+)SL6PexPtUvx#Q7!^J_>(o&~n**!o$5n=vf-X8n&r$|A-Vm|x61i+{S@nchZ
zI@Ua*4enOjU<KsOKc<z4($<^dfweKVhmXF8Qu_dqF^&Z=e|JBYlh+u>YWB>7b6dra
zK_=p{XQ3XR@s|@*K*^IAU*c7o!g7uC$DfRyGQ9WYz)JTfAgnVGe`DKk(>gCk`a8st
z<xQni0Z1F;>mkmw{HLjpMFrsayRCjX5$g>4v`(;qdkP4W9^T{kv^qoBiQN%?@tlg+
z#Y1Z6z^&bj5`Hd!>w14jpnPQvzqFIH*;)W89yU1(6&raAi6?lGn$Kf4sy!(+0Y*u6
z23NF=jGu)0$)l%YW)}E>_X6q)tsbX^b?yRO$pQX6tUDNTVCyfN*GxN2afDTjc_=?n
zWedIVQ@akHtD>CH|LVjc-!ggomTQ63m6tE8Os5JHP~tPG1XL<*9C3UM4hG<WMymXI
zq`6>VB^50ku88)$8VNXlUS>ZuR#n%K;6Lc>zJ1cI+K2}hXkKl=F~DMZDWwbcaEJlM
z^37D~eb<$h6mOOv9<+e7dWBhot}tuajiIbA)$EQQsQI~@E4>2w`|>jQJ};Hs;-<Ht
z%)IY68Pv=Y**(}2xLA2!T$*_M``;;iQI_QWj1V&oYe_9K9fBq&lP&(1lUZRNe4_}D
zPC$z8OhaMSToAgevl@wWU`~h!jS5S-=uq!u<Ygx=SOy0*Sm;y^<*2jEqcNLYP%<pM
z#~2pyn`Vs+vd1mLmw|x<!c9BY)H5yMtEM>Ma?|Y!RkM3$`o~4A!kwkyJLXKENbSGT
z^c?>leEZuiHIpw)a+6_zWzn+oX_pCg6$ph--12zlr`$A(8Rg=K9*9lwwsG8QJR*5I
zmr8=LBN+~$cYuJv6TuK_-3!qbRcs%6LU^PU>65dF$?n7ny@<a{Gor9EP2uMF)iUcU
ziDygz1iF#yt1`jE^{J@^O8XQ@j4Z~|xSc6vW#LEXVlt%;+-Z2Pcq?oL!j{{_4(0DC
z5C#u3=IW-i8dTV2_wutDu`@&yrQ&S9sUQ+;#i$Ih3;1`4KN=G<cS%(aP=DHyCs$I*
zbD%v=|5F5afkI&?z3w!+0m|A%{pZxaFCIz-BKzO-d077DUc7iQRi>VZB7NM3c?BL}
zJ8tAp@`|xHdtt)Oy;NyzrIm1st!$oPbeUXdX2+&Fm5fy5&65{+vMBoILfX4Ar382q
zZ<&C2OR`H~VkHr8gIB$YkgwzFc2*smRACPLKSwfr;*=Gc@}Kr$ET3F<RphCJ6<u&4
zt#fR@G7Xaa_RMAhi1f8xm7KP?*$MItO}Z%0DYCpM-e>sRi)DE_234fEU5ER<Tj3mI
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%0D*XQWH&
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%0Aot`RAm>-=Zi_f2(0TB+RZK
zfF(V^BLUD{?r#EV!&Q%|*qmu85(A+<fZysJo8k9-52jl$m93n<t52ztj457y#g|Ha
zatBafjaA*oz4<}?j~&7OvUcXWid*2@>l}0uA`&Re1(^cS(R?b(&C0FL%x0;*Q7z_?
z{^K=?wPqV9Sg2E;xsU3?ZL6iF<bJv!#Liq>ij0_Qc-=+tfESUfC%?Wu{kTN-%HF7r
z9Kp9>T22LS3~9LpDyT#;QC4KBtb}r`m1dQ4cR7*a`k+?Oq|A7ye>*o_<m@oPz^S$r
z)T+Bnyn~{KE*;maO1GrIIe&;GTf!QXmpBP$OV4($Z%pbwYY^7W#OVP${vx5owVm9-
z4s6{1AOys%uy7Q5W4?l5jm5j?M-cb1ntj!a4a!TcdAHa>WH{Dp=Z4Hoe4^UCW(lNf
z&%qr31oGT7U7qX|##*TsEF}3XNz-TPuLl3Z_5p0IwG2J2HQ<8{(YcR~A*Yi`nfcBJ
z6otxsSc^_Ac|KR9Bn43vk8T@ND$~^pXAT}sk2cAME62e`>ziB6(Q`;3MuxL3CBR4c
za?|f5Kk0p-eH-M^Sq138lG9j3Ww-N3EFi$dIgt)!%RW2F!X$G*i+nj}Uco?eW`AfN
z{Vd7{i^IpAcQNFf?9aM{YnqNmC$_x3=9<R84##pdc!MLWcx*a;`-Nmw4Kkm(mT@;U
zrGd=J3j%l&+kWwK^xVO<tTI30q<M14jyUh0i~r#DWDPmW^>sviy9(_BLA4o#6gFk<
zjVgG^K{Y%BjMg+Z(AFHtWRK3mt6Q;8%2$m%P2%kOpN%m#c~f*Y*zyP3$an4EM!J^B
zd7(BPM~YeVJL(~9&_R3Xb-N{;^h*qPm*;~{(-;?>5#?nKu3++DLvyi?jVv@C)9aDl
zs9&YxGqP~qxR(2k3Ly?9UY>8$2HEcbjT?&T?Z&n<w>{FbJ>o;N1X1gc^9f*jFD8=@
z6TMaF6y&~`XF1*w?u9jBj&pCCdZS3TRUEyY-kA+{sE-lMR*QRT90XG+=~+cu8yQVz
z>fqpe=1*_r+X2qJ6XBZfheU>_%w~_5HNx?4{yo6K`N}ETbGG`;s0~T~FKqPZi1y$H
zr7c7LQ?(g9#)Ay|A$=S*kt39p#M_iH<C?c6*g(B_(aF2!RK#}!6d)|x;7a;DVc&$2
zJ+hs{rB2+!HbW%hDj2^tRKg3;8iRo))!_fxtmV>ebH}#49mbC1Bt>6FYUB_7Bfiy$
z$d-0<$ogY1*HioE-WXdqr<LPGetUzz1)w8OD&{nz;ZrVn*<;`XnU8lQkaIp2bB7oS
zhP*9+j1FDB!p;CNet2q@WuurZsP+b_zC*oK#&=7KvER-WT=#r$Ds1#l&z6+2kv<E#
z2erw~_e#+nhvVO(Z_LNNf8wGk&Ph7^A~Rn@z?|0V&!>g(%Va2kn7+5U{d?DH2T^z2
z0`i2ew&MNW<yJp~*!LAm8?OAg6yCZ$&;6^C3z_`7S<dNV)!Rt~nUfwD|0Fx@NPxmq
zlTll;cLV852|EM+Qh&zLxfm(!W!~5AuEv~TeF9S_SiaRnH9@39pGOFtmD7^6zTOna
z=7*BGG6Qfs75mcOr?uW!9b3`&?HEc7%6DxicU`$|ZJ(QNNn9d)enXgjM#p~C&q6dG
z3kNoz6W0j17?Al*ivN)Pg5p*(tsCjRmrD7$`kJ|^mnC{%d1A1w!XL-aqU)p9^{fH$
z=A));$^$9Ke=JR07r`#nor+V%6`?>T<g2lG+dx?Rg@eEYV^WUze-_?w*svpUDYY^2
z8Zb+S;OAY;bvZim(}MTZNq8jhiYm?4b7VyoZG&7XpZwRB=@QWl{=mk2{xZ7ln)d-#
z*HbuCfQU6A;C~0gSXNS8cXKfh2Z_Vq7&^G7|A^2DUAPwiQMGFCtTu*p^NT_r!X@$R
z8a$G&Tl%A=Hx1$yU_L;O!FkB>)UQ|~h6*zeyq||_pkr_;`^+Ac>C+c$KF%bWxFMwX
z$^;*En}&mahX@ZSkrW$vSgH)JptGv}aK>L-bc8CiIkYOi3f<i+3cI~Hnf#Z001jWv
z7L?{5OLz33nU^;CkU4ZhLcT+M4f3D-5)X@f%WdZolGk2KNqaa&SfuKl$&%;E&(k|R
zP)ppl=H0*XW(M}kMv$iW4%cREb_Y@E0%WONdGT1KnG*gaTj}DoRt^SB{Ir$#^;_l8
zle<={`N4LasegxfO4D04vgTOVc;Z`*6l&}Z`zaShPq9AF26@$Nykf*uF#Lt>6P5DV
zp!^oFC?daM(mrwj{*$o%^Bnc%ugjPu0%`O;w$D5=q~G^Cbs(;_K3gpJxbYFHil<AO
z#0en@$f3jP(}f{vE_=@4bdi+5#eMxR{R#4-$0v`pLY6`NuUi~t?|Bf;U~xh_OaW$;
zwS9w+50(KO`GhvB9!Yr^DA8Hqc>K8kh{FAeN6(y>D9!7BRq=h%<yo&lmEdiewa3GA
z`MZJleCWC-JhOv873=BhW~K)-H<<tBBbuwVwG@DAomxAnHVjiUvlKmPPnemPV!?1Z
z?d$$lD(Kk?8aDEmn>mqYBT-^Tw6m~`9S6hr%;9_iHk8nMsIQH^0+kOGy<egvw038U
zn(DnoW~KUefKkIBZyJCoE{Sb}q8ymoKB}7hoGe&z$!7&-lfD=B;nKeR*^41i%;Hb^
zXnngGlXlQ602$na2ap7TpqN6$qmnpyBr0mw4+sP=-4eZhc<wba-#Q<<(JGP4Th);I
zmaKX%h9qj+F%HvZmC}WOe~PX_Ci?%nb2X#2AL$)Wst1FT#MSQUx;*7Ub8ii4P7y<y
zvSpG3ve~9&<*Px`G+0^787|(n(()}^JqPaH;=8+xTegm!QKhF~LBaXks?XqvF49ib
z-CKGs`TYjkcZpBEJn@0$01{O-fXI)0zDN0f#(gfzb<y8`PnM6Xfc}r8^Nwcw`~SEt
zYR0HdtZ0kIrnN`WPmQY9-n;f_ZDO^Onx(ZjRZ5N8Y71(Q)+|EoEfhf{zkGk^ywCfb
z_doBP^S(Ft-q(0Oo}l=3p}~33fCV`aO7cqR&q}PS3ZIYyxkMO``cr3M_vg=lkg)hK
z#7XLTQIRwvjKQ_sL>>=gBbXW{natLBMSb}SmVHQf7t+qkq=imC%$c?77rfg-R|SoR
zQmZ0V-YG)DDRxlh_>so7LRHnaZz??G%Z4{Kw=0Yd^osXM8*tl^fo}fE$jN2Dvi_15
zIFR#eX&##wf!`C)-$8n!=`Q0=AZ2~^TWh`V&uBRmk9zj4+HDr1iYo89oX9S1SIyWS
zLr0i<VGUyK)#C{&jUF}vY%B>zz`sgx8FQRJAJyRKJ)3|fm5uFCxR<^BUUPb68YRP&
z&(E*I_91xZRgS7UCK-#lITbj*=bnrp_^MxlGPuhG^-kWc&8u0<b%jPi`i+AqKS7y(
zv9XeOCex1j*-`kabS##`I;|(YwXwnyY}>hNiS~ZOYi#PH8_yC!iqz`60=MlX4rk0q
zpoI5f{^@Mp&RE=vOHgV41p5<4l_`@*wtU!m7*JnJGq5u}ru!#CYqgJ&z(v_t&+=i&
z5V<Kp*-Nn+NEQp{hJ&T3cRuUkVb*-U)QE@0_I%3WwuaeS!Cj+l%n^jZjl%n@>Jfxq
z$C%WlO=>K0Ze5<PqUZpNbxK>aSnm$Le_z1{#!dfgvj6v`EEHu&2W_LWelXKNwtQ>e
z$(yi8Wld`PK4m&_<z>XoY@fjzj#zvAW$bb7n<xDCFWs>;H)fSg^#dASjP;+$4$QWg
zoDk%>;+&W~*gne-=i!A)Ic~R}PYN1x>xyLB)92!>ZoDH)sxC5FmO1^#!2{k%ZvTL8
z^|sDgkj_ydor*{Zg^KPzeE>)(pv2o$UZGQDP$;KSwV+Foy}i=ldX3u_c)W_ck!OM=
z8xxC6evK!|2iMY@V18kOUOeplN)9{mQXE@Q&8lb!(eWZ86giA7u>gzoTQaf0We{uX
z=AtsIVROtPSOdZNK6H#W7LP}F8uAdf0)lHLz>dxvf^dpe1c5zt%C9ne2K8!`?h056
z%O^e1{r2l434w7#80=M^&Sj#HyUtP_FO<9of?lVGmuh<;tE!JAyTg*GK4!Zr1yuM4
z*{CC){-u$eMY9S|0Nj(#R6}V$iMmOUZgSxGfq(y*JYo3JXJ7_{*Q3{Y|I=sqG(dUb
zDKXIa@A;XH(nByLpU5z8tkg|!R97IIFK@nVL+U3HpW8NfCS>{4XGN0wE9Egk{y*Ud
zt*_+xY>ZLi{*xWKjT8_SBfwUl3_Sg&Oz}Mmzr_8Tr{;(OYm?Mqn|<>!`EE5^JSyj)
zg%&r6IvgaVKHg&9t-kkK)i%#U;bK9`SDremS^Q95B51M9gl*$_E^e}55O>?UC+BZR
z^xw}rPS!7{@A$CPK9F>C!SXE-(Gj+?=jMa06kJoKj=UGl<YLPuu-ln+r(*xJHM^WI
zPxzJR=^x6Jz;EyHi;Msaesvd=2~(RGA@jj<9v*&h>&Q5HV245w=ztGPFFZkKSwij*
z_s$%7+iGJphk6Lo9!c5_H2rvX{4Fxsnepa+%F_j2)7SRgI7y<v-YMbmand5+CHLEM
z;ITo~;+SNg=uF?=!|PRp<FEeb|L9(~sG}#3g)+Z?r#C#?F8J>_zH2Vb1}~RUrBh)n
zf8=;DT-1S3H@~|j>vFWrcw$62lnweH#~zEeI&QC@WC(p0Pk1mrxu7a=Q@Urk_mOp7
zTo8*dB)MBn-*uAwqY5{bw}-r@kwsoNrjaiA*NCsEe%zs+3EDR$7?czWdO!DSU9JOp
zkY^`8j*p`l=3vd|_h#rDar}Uj(%)mxzDs2rwv=I_hmdS6;Dab)^2p6p7J1)+q{Eh6
za<8B1fjU~WDi2aRfGj@v=K$-)HQ&%AeLTR;+vutyeo*?VB#t?uyw!M;e>TEm>M@Mb
z;{fr&1~8gwXx0@=dIo*)S2!%&hw6NXrsrw;7d_%mb~4Db%DMNHb-+I<QMK+Y#;cz{
zu<?+C?>JPexu=dxqq%QgRQEY9kPW;`+JtcY+f8%<EUjI62&*O2p**F@TStu;?7oX{
zg2FkC#~{S4m-9C>qO?y!P$KpJc+r{YHQ9rVt%z^6B2En;NvkYt>hJmo9k=$)w4Q<8
zRyu1Ul(+Acfv*M<O_1xibJ+*aMrGEFGk?W@ouq0<|Ik{%pz}#@cDrWS1xAxjmC@#Z
zcL$wm9$TLh-`uz4{bAPcf18&2<r;x~8>-wuVP^MZzr+ClI2}CB?*W{O(|O89XrEsV
zbMy4CEvY?D;?x<A?Sbg?Gb|j-ECh)nMSW#}!eZ3Ax(1a0T(i~*(knX;17Pw-U+12{
z<?jf=+5jWU(Gj?idXDe`DajwdtbBCdizbZ_%;asrQ9I+c`&6Kzqis%7+EQN9t2`uv
zz>Xv_U+kw6i9ulva#CNatk|@`#fyV$YJjqq><c+U>vg8XA3AiE)@H=i{)PU7@#HqW
zE#l0lu^rruRLIR-ugUM`9yeXD86x@loOSN6+9H5~dZqfWFCX2?S8=w_Egi)qWZ=Wy
z;$v0>YcUkCK0w57-RT_t_fs(CZJVkfPYC@@A=%rA$bJ8i@&$IAQZ9uQyW4L2kR^ee
zm&y32N>?;A;l6~X>rg&cr~kVDRNrD?$Fe#pim#o6r}0VfG=Pt=HlpX1SnmmAMC8A%
z%{K&R7-Hf;Oe?^3Ue+`qn6sz=<(SawHON7_)0xTbg=0;?FwH?Yi6|Fw!ep1Y?d%MQ
z$mG$%F^<|D-cYCVwp09)oe!T+=imNo==PNSEYYm!@sYj5L;uetV}c3|DjCPCbV!rF
zf>VoGk}M+W5M1a_(!f_I1zoJ1>G6Br*5h3$K3>Rwu7g_IYD0>efnsEG=?4>+BcI`d
zHG;~ZK-!)ji`)Ps$-E3kVQPKBrIeQAVe|D>;h*`=%N8&IZFn`(_+pgUbMf-eUMJbu
zK8<(KFNtj{^0L)I>$!T2DV#*<`;mlwj!)}W@B6Qo$e5UQc{wom<=Hcd^sb@ouIztC
zC$S-!dP!T=z)xk{MYEoqtpq^)))vbz9RFsF=4&?rUrDnFI3{{UCSx5-aM)bB?8?zm
zRkzWjo6Egj$7t+stPsZ4AesOET2NsgHKFam=-~p*IwEuiY6cUHv<EvuKSvvuyrOjE
z59_IPK~~<2#=a@3NOJP4Ypf`|G0q|i8b%hbR<m*LLLz&Wpxy(Nt(2ELc09X)d`g6!
zA`!pJt6M0(o5>?Qh3+I7fKef#UAZ?k-_uz``W<O?<c$N^eymkaC|sLD)^P}=r81tb
z(VQ`7pzKuGJ{^#TznCus+q%1CRLi2NQItJl3gMz3_EwZdyNF8alYCZMOWBzZJ;Jol
zDEFPDC0I`Q4mu~;GW0mZg7)ou{R{?mucE>?{OBL^V+{~F?8Q>FSqRSZGwt~79lU^X
z&D$Z7d(I`Mmib5&7e(uI1Z1VP_0&Iz^W2dIj~}=~@t?%rJxOQWsQ#Q<bmhtak*`>V
zx0x;ES&Go29EV%6%viTrC$x^%q6-KJ^kKbEGx1_XU|f<#m@K-kL>a6vpt!28bFCN4
z<rxw7hP|M@vxG85@bw84Q53-i(73g+3;#M7MT@>B$K_LypN~abl|}1I%UVIW*I3E!
z0iB2L4zL<)Vkk|pgkt2pDu}5~n~3#)eb4eAh0r}y+O$-@=v>GwA5-*zn+;Wb7O?`u
zR|+>u;?{q^04IF`-`jaawEY>bGhzRIt`Vme`L&_=lLSSUv=!+FD!kZi`d52t5@ol|
z%OJcFJ!WL|Ahilx7vqlmkN3mrfVW&&`xGTMf}a`DixtX>s;i0HfB(Ma;5GRuq}%1_
z5}$e>=RU+<2P)t<%gTZ&NQj^aR1hXxrU>-~yPt{yR0K|yfNW&vLB;V8l;Ff3ySv@}
z@u+=zAWQtYY+4Ix-mh6-lr8-`Z}0Cyfk!hGeB8AQ8}f(mIzQeo&^u;)Fw;dnHyAXl
zDmcfNpE}8HPy5S%eE<Wrj=D?UM(+?+?cp;jKQ*^r3%HzzVm1I4rW?UedZeKfW6-m8
zj5SywN9v(_E)Ne#@w88buG}swaN3Zca(;P$Ouq0WnaHZr?Z|t)$K72pFDjUOEHdEC
zHq@-dhjcM~>+Lp!loI!Qz**mW`!Cyh6V824hiiA;EUQE72h@zUyc#)9ifwoGpjrQo
zpqrHf3y8DaTYNhw_-K<pl=j)F0<;_&k7}3@V7@Yo(+sX|r2<&X9TnLY0@s&R13i2A
z4|w!WikAxg(%jk;67m*7CB~JKc@y&x(jE9Exw=JLlDR@#pb2xU>5O3F0m{$u{<V4q
z(rKyg=8I_79N`QI8Wptdh|EO)c6vAa{Ki=t&#n6h^${PnZ1PfAkq?S%A1r?pLmV^#
z_#{NkgeZEpSASgby^>_Js3EFL?nfo`(RYbMZ|LC#1Zk>>$LNbIEb>e&*vs@vv(YJ8
z#)-@CJ2cXtFi-CMf>E~TXn2yG;{|qO=#OJ~v47>k^Xvy`wr-{<DKku|GWkZ+59l4u
zpoGjQZgd}`gH@cy3{Lma`Gpu(Co0W`lgEL*ikSWuiA(Jj$uPaJn)E=s#q<&oDq{uD
zcQYM@f0Ed_)Nl4siDbfVXAg+KHO}5BRLJ@U(XuSz>*LvLA+_As%o;73zd{9uQn&-y
zo|b6wBAv0uzmy6C4vuavf`5D^Zrd69cWJOg^Sg87@*F6f5tL?^H(#>E3zjk1OfvG9
z8G_@Nrhc2I8Nut>fzjhC{<xr*p|^xQGeod<k6((Y<Tt(1y<Q)#|AO4Ta6!x`%tHxA
zx?6Ka$Agh?R}Ygl^?pEd#;}fql2LX7OwXMeUWrm=JB4&ED&QAsV%ZSquR9|1UjCfK
zjmDe?FCLo<&DpD<pn#1u(#GW!D*9H+Nj`h#aMcj&4dM5H0!l75)USx^CglmrCt`tr
ze+Ps3=fB11@TqKGoy~wPCDv#(P`rIi_S7#@+wW%=Y)TuM=`qhCo^Guvf^9L{o_3|p
zzq?>yNbNtjAl_AMY9?phx?oq8ljJ__zl?kDce=^3na1YoyyG;i0#-YY)~oS;{?FIJ
zZc}m~qq{C>zDI|>uBUZ+{*Dq4I4C#L^&}iML%qWU*0siE_z{bCYzcBBR_Z{ue13m}
z7n^-g*sc`x82R<NND`ggcd(k2EPGBjBJ*SJ4@80A69hK78)OvFJi@0Z!+jXM?DHY6
zo6qz~(Z&}oFl+0mO6xfSJa>}wJl~WZXI?1Mt=U}_wttfBD-cU_2aEX(av~%nx5JLl
z{DOWZXah8gAA%PstScli;fyW{m?(TsEyPf}73a8isaGL>O{~o*!UJS^o!)mP5w}K*
zJU-ugRPO2p((a!)erXCzn2dWbiIRsqD1`T;#RtH=TUCw`tq=Jhp13F4f4%d4rWeWK
zN#6_QN?a$9Fy^0&Op0)T-RWeCZAss3oZ~iRR85j`9*RrPO9`QcqfOS=JN09*_+GNn
zo<P$CFdiG)#RRL?6XiW#m+7YTlO67n!)>D17#H+Gp#Adoy2nQXuB$qu%Tp%-kAyXN
zy`n0`r3U5VL(jU{DbGg`lvO`<8gr)2f8D+pp9Kbo{#j@yv3}JVA@wQjZ8g)f%9#<)
zaeD1vea@q=+N%lQLi2X-CHydL`QA1^MH!!nph}J<=<Rj$^?#1Fm@_avk3)<Bfh_8k
zV!Q9;pXIPG&}zwR_l7;QH?o`{$YW!xJg?XE+=!bm?`iHWf?%n|7Kg?~rRhxR#1Z!O
zsn&}wq2?%ot_P-!CB>xSW8D37;z?@r!xs}kKoB!v{5$1gO(GVWrAH58LX5574nLQ2
z@clB8gyBEg>!BvBz#Fgit+<jXN{<9YB-ieV3?(J#wbL$!bt;Rix4>#lqwp=C=;4Wc
zkZrpf(2oJdI~r?oj`0Il10Knov0{b`N~~Y~JM+i=wcjh<nJD`C+Nv9B&Drd~_LTRp
z?yCB^D_|GPi*)qVzFLIFs2z|wW2lzn35oir9bZ?IxI8goKPKN6K?aB6px)LW$b457
zAd1OCJ0o4kS<>`>axhq*1P7|5m*k||^?*C8=g$}-0uvw@Wbk2Z>q6^&v=>qL%t^Ki
zK8AHg*K%6*STc)OMa9kBk*A#x<G(MIb8+=%l1A~90#!I~H(ma0!x<jV_#n!M^l>47
zRqS7R4~Qac%xp)=onO(h;|#HP8gLVSM29bvP^iUu1Fn>n#u?U&1!y&UEh!YgIxe_M
zq%nj}JKF!Qp*rE-Gy9`29usEr86MG6Me$+nV{rYOf6uNSLI-sPx1|Xt<F$HzFJ`Q&
zODT6Rbmu!q-v(8rO=&O1srH7N##v%DwfXy|xm}H#Y}S;7w==gu-mqC`;u<|1^Zz10
zc+UIJsYmzy6z4Pb1x!C0iN|L^A+l|;|5F{Z^Glw&Q|#G89+8!G$#F~=vKRB+x6_$i
znv|AbMxh0dBiUz?;=AM{OP}R54HT0*I1NrHK>Qa?dj)e!UyDk61~AM|J-^!SU!ocL
zZOz7Oor=E=W9jz-433qQ%a*4B?0Fel-klgy+0$-d*{Dh=Yjhi7D)whM5L3UTGd=&)
z%pt*1JHf23SP5>wHIa<yY7~NMH^s2>zMTMNdk@!!zUG=}G`aGlY+Yr2(~T|+Y+oqR
zQZ0SGCB~qa%j5q2bFjwN3Yg&tzR}&FP57G!C2znxJ>f9)W7L^<y1{CJ985#}TyjeY
zt%$o2K~SE#(l|R+1tq=$+U=*tJO#sHOjv$}|5o2~G0NAG52SIg7Hf1e_ccs(UG^HP
zz=siUCCoERjfAn(;P>~lV+R$GRQrx=pQYLmWT%k9mz|u^^(eA*1-0ee|33SqJE!#w
z^U=?B6{OMKpq0TQfWF!Rf*4{f$9##eO4kM~Q$XP0Ctjnh5bE+5>__t#QbwKL#MCcT
zpc7<VPM>2vx0pKUZhtST7+uY(ILP~W`0oenoIYZj8D{{XYcRPo8_&3+p1<u^x~h78
zHp^ez&y5whY~ab?Mu9<@G08H8*K5j>Dz&5HmTaqPymIeTQmuNeH=!ud<2_UEw_^L*
zDsZd;o$!jsj2yWXb+jj&%<g9^$r?Q&AHAN27?-q_mI6|iGQ&HL_6_}rfsSXSUb=}5
zS)8vWY*i<=1NiM}W5*4+eP6;Qa%i#tR)=*_;58TUHhi<BG|dlz&XlNFMGY49IO__?
z2-9jhQ+46xt|TN{oRtM)(SIP=t_|26Fek7P;oXiD<SWR@U%V`uA%DqqeF4Q&K;UrM
zM)V3*ThK42*Z5!W>-6O3`>g@ja(fj^hIt=SWsnh4Es=YL`BN%<B9x*(K70WDJ0LYr
zEsD8#W9bUTs^;}eAq9pKr89BD8Og(5553spV&|w{^p&^pa9G`y8Ci?vn}Y-P*`6;N
zuw^1UJjdwVqusGMs7h(kvB6~rz2C!x+hdJoTI35gGxEsH2{b>kb)LM)?|YvH>#L81
zgQ9KaF3;RQAc&O2S*{pvN;7;@Om)s+e?E-tAf63i<!D&uiK=4m|1`xJEiLsgg<6Q5
zjbBGeO>#cyb@Vhr1H~D)AJWlVX-bq)7=nqOwl|m}Ll^8!FmY<Xa#a&Y-6q2kw#{gj
z967Ak6XsrcebE^FDp+x8MM7Q&RwXV~m_1GI<k%&J46{!Z&jVSg{%w&$Xz8lIIlx+j
zQoJTZSMPE%#&zM`ZHdj28Knog!(TzQs#ufhkb>4`!3zmu@!LqpPxUfAfa$#@Ev<=q
zu6>yGAJ?qe&s~`IAGM>OtGv2k$7*`7`n9xJNypjPe!+wvzGC?Ev6^89e6M0NK#7{m
zX>-@E=)o0bN4UFoh{DwJED6!i;bJHZKKvl{Lzy!sH<N*^JLWzZze)gqMMnoE{y|%Y
z1zM8Dm;dP&49S?UqsiQ?R3zmol?QVyz0m>-ARN%*Uj=oeeG7m<4u1KV0jaC2Z#aGo
z^0W2_c$%3CpwJZd%c%GE5kJ`^?JYs1{_Q8kC<)$LYiGpYx}@n`xHeaQE@ho!_|om|
ze)dn|H%>+weAB6lv-rtJC2!7@;w0*E!0F%2%hC3=I=i~jcZupsrPr=y>&6DQ!4F03
zKgTa&jT<v$V64lV$FBFfqOD_)c$jEVz!~~lGxPUagN`>1nMY<N5eZ@Q>{kB?){Vf2
zG1_LRMl37^zqUucKDyJAaI77|bAG#Xlno~xA<X?bmDTsHj<@fZxIN1xPLu*w=&eQx
zcN>9?2tpS6gR^9+v*gqNu}7{RdHg;d_4;Dxll-ngM_iSYGbAHLcGi!bhsi2?9}O%3
zZ)AQml_<&+x$AbDRVR#OdEvK-6R?+&1!Dzb?J|?c?!~9yZIvL`0|s@0EgeRCHQm6^
z#x$_d><=zyp#fO0q=!4?7qh-#!!L6&6+=0vVnZ0y_-_Jl`aq0Kuo2FvumrQT$LDmS
zqu<L^OtpkR3_Q2)-+B=pL`-QicX^CorJHIHy=>{F&2Qn~qNa)Laag1KsAO&CRJi1V
z4l-R3kip#A6GO-&2DdLH!Y62`Vyv^TJq>3WsI?g!e#A3Z*`Q3{B2XTP1$aG^6Zc<3
zN!8(}S?~9)RzuU6{d`Vme~>Ld)<d30#p}786yUE1s)I6zpJsjmJ5$ssG0*ZBgQ^SJ
z!nae@)7T+S{JKIjGWB^9#M?EnqD>kK5+?<bjbkaJrlp-rBoGjGEL9J<bX6Wo^lTSh
znL*q{#yK1DFeMNA`Kuvu3h%}~!cOVM=w{^;T;8`F)9xG2CVSR$0{1Vyo>J7YwGa+c
zau6f`;GeM6m4#M9Ig5h5DdxjmP(cU>Su>|0$3i!kiC*~ftKGGh3Y8JIue7N@gQ{IU
z@1})SemJ)VSaV(39lUW}sAiftf|A)NI%7mjo~2R#cwInZTyHKRAIeQf{d(CnRm0C=
zpTX>jPlnUOJF6<w&hHB~+7^$VrJ;MjhVZQ4Prq47Iv<H+d_+n8O4pLnOm#R-x&nb_
zd#$_rZl(}V2|fWtS>|~`giLo5XBKJ_PU5m`JF<-rK>121Q&QTdXbUh{L?%rsRm<sh
z;_eEgStBc>WYr-3>4f%p*n$WOkKXu~NmnmDj2u(^W~`X~4f@t3KzpM<Lf~=&Ac%Ss
zIz;P}J796u;K+9yi1^`$A`hAd9FC5dAuQu>U>PGMgfbD?g>VigN-48Q6|cKm9Z*(B
zaOd3C30y`K;90cg?L3{lmMx2Pt>C&JeMs_0pVYPJ5`?kd%F>s?UH$(?vV2<Cl+2&B
zKNfR|rtiY&<Z<s)2%QXPwg`Xv)3Yo%$~~<+yum>LZU;HePdf~Dgq{32`Bif-Gw0r+
zKoaBSTQ)I@jmU+(lKR!+M=r8{>=c3SH&vQ0Q71H65x{F7DlUs_6dkujxI*Qp7|{s+
z)z+e<+*7Dr94vlwBrTik7-b*))-3oT0X>1x+eEdtd9}8-no_MXYA*aP%)z6NZcnum
z4l`TvuokWPvcVtd$9Fk0D1_afRewtdTkA`(p(*<ZsOc96lu%gB_H?!pd*_5$02U{Z
zEHWPJMMr;oNq#*h=6$+ujq^%1&8iN=GNM<BnCo6}l6VlmpvPUpz|AV_d#c-m8h4|d
zf^I{sA;eD)9Vg@xLdOzAt51}^N$)&7u~hgLp>bzH^h~c{D2c7i5e~RBI5sQ#5?yFA
zft3{L^<t=XH*%|!ZD_+wJGIro#&B!vVpxd`#s@2T@=ZYrG6a3HUB1iN8}-Wm|Aznc
zbR_HFYOrZDT~6$Q^iUCI&1tbGhb4)$e@&{M&3XZ0Lrf+KaDa;qAmK#kOkw+_Og>xN
zxo(xPpyyZP@Z6LW!vSz+GI6s!V;f2$cY09;5!^8)OF;DZv7;$IP2-+5B-mxNryAa`
z2Li83y9X>VM+tw~|3Ezu?A~dNR8m^bA+3#a(k^d;mhA)-dMH%YbmN)Wa)%|oK;maZ
z-8nBuX=uxAF!Q7x{%E!9SlO8FLrnU@T+_>mc{TV~z8?E@#$2)zT3^xw`j7K6omxl7
zYK(vYk+RzVZhfCG?(#5JwKD@+nU`J7!PefrY-u&{uprgoxpiAAW7ufP4y-X&hq6g*
z`8$?0tQF+^n&u5lVX#RiROUFj!ib#7v^8p)Lg|SEfQ_^~a$hwrT2fjVx-MYeS{o4`
zP5Ykku?Ez+OVH!h+6fKGwh0Q4W8nu{vmq4$fC+CVM3^pimWTh-e3AfdFE5j*mIwpq
zXWwg<xBrYODG$QlXthd7NxmA`EBgJBMu>F{YldR_qeH&Mg%khu%U8(wxA=Zvx<5<R
zlHt=yAzGVc!m=)E)$KOyI)`kEZDA-D(fIblCR``Hz6*1k!5N?CHS+xqeL_waVb^@}
z0xhxsk!y^77QDt@Mi%8Ou7%-bO1`Hm(NnCza9oft%mS~{soGoxMz~&6oQ+BtX%rw6
zMy6~Ez-<m@v%|!ExVS<(Iqm`Bqp_=4p=q0pa{(~>f8Zi-Jmwc)=vzx5nQqv`k~oWi
z+?W`yX@oQNE&-Fsp?u6K72Bfa_)c^2OBUQDRAB){_EO7B*8<HFEFqDp#ew)kn1|<E
zw11*OADJ9Xe-yVQi`MsTekf}Ol3CHH4&DZM=RuOY>n)YgGkEd<QHp~jmFiIcKuEy-
z_z!uop%pl|AM~>kbo6XH4hXP!XS8AC5=rBccE%(i{q8{EJquZ%3hLHLh0;M!TMq9H
z0TU2v4}~}TeijI7!-jg8gNw>LZA3@g{160xyI6-u#Q1$F3xk|3IWH;M$($a!jk_`R
zyp3_;_#DFws{D7&CQSFNM`#Oyz4LH1s6d>86E0ohQ@~muvem0hHGl6CgPCkmAa3qB
z@{koq5VUJ5zF8s1vV$l-OadnLzo}@}(|M|IX|ZQsWyv%xWXD+ExO;dUr}Ax06{BXv
z)5~;zSpd5J7ljt=@TQyVS6JnU7H^aBuMfY83zWugad>NaPO=)d^`d4E>N#2oY{1+D
z30$=J1d88QXDDe$o?QelR=ZKM)KO^3t`om<tuwh(LvH<ga#QAnDt|}C1(MQGlW44}
zU9D~K*7y07g&z~N%`5_xN$^2mlTOK6cVi0O>vcuY<}XQ~OXg9G_atyj>1za>02zje
z$(5lcfIJK*?}L(I(fL<RR}u$dng%6#Ilc`Ou$FgXNv6q68L=UW_TQBFKmxN6HO4)S
z#u)0s9v;t9y3_q=!52z6UK};a6WuJ`+j4fXxOL?wfm;53L+_PO5`kXgQn5)Ta_BE#
z{7FKFEWAR)7SDHrmii1ofYA!xcL=t)Dw&+;bQKTD&@WSNw$lQNZY?SCLv`&wiO9rZ
zC;?e4SAq_6cBNf}Mln6V)HSqvd(kva>X2+1!Ru$|GY#4LRj?!$D};!?=S<9d-J(r)
z11xl?V81r&{`fR`gXqSxU)uL2TF~Fq=OIWJ<faK%xQxR%l}Kx$G;a|D|GD2ebLs-3
z#H%EdH^=JV_B*3TDJ+`r4N+g_s0=CPhf?A38#r(2L?Fse*P%!>QoYiNmzGLM;v%f3
z<zK?n*z@{laXvn>8#@7^p+_avV6KT;YNTq2Yx^S>dQ3n)k!Q22jWOxP-Wdsnq&tx(
zQlQ~%q;!78%W0cMhxIEScxuin4Lz~H{P5dsGty+5_4mGYtAOKJeDZrkaL~im*fZO3
zGU2#Mbz2{R{r>`W0um&QA0QO#D<6-DzS03l(k%h>DT9bW)(bU*K)U?aS~9_L9b1=4
zqKogP6KIvWW*#)dsfAi+S@*szZ+kuIk!^$xS_-9?)%=hEDYVqGcJq@$xCtX%Hg-9N
zXzcRWk-^no509sttk0ztwOSIgX5U?eS^fMgnz$a}xG~^T6BlguF6H=us)M)nB)TlB
z%^&t-pr~Vl4Foe@$M;4syDRMt2Ue@3gi%aov(czr^Zsl1wQi+M)SEm6$r>(E9&<ka
znl9P=_8Lt)M?C}f8Hru{$B@sf2H<gvA9zoux5B%!qld@d>1qq){eNT-kPts&h@-Bo
z6`06d{wq=>+H++nAfG4N9E)FRt)&PLhla}hmmu<=yR`!Gf-(`PvD4<e@)r+>#64n<
zK@2H9|KdYkhyCt81Re~Ow9<6rhqRDAGyZ**pJg@2xzY1?paSLXASopvfo4aMF&dc3
z8-z^U5zw@a2SQ|r(#oTxeBzRGMB^%j`p;ka$PH#LV2lD<o*qf>qJEQ$n@q*n(T{bR
zl12Y`4INLKkDhgwM1Ga4a)-J1ZO(0eU;CVP1hq*E_n#wQ^um>j&|%{ye+MKZo-tvL
zxyUsDw2Ib$L|q-Px4J*xgcp(soFZ)wUAmrs`Er@B;Fv<Wr9pup!gJqcix@}=H!|jn
zI&g`D3oC4Q>n^KM0q<z2rcu28_pyT=x%NR~l|OVW1Wz)$MZSlxjqK)G_PXwgA+*3Y
z14Q_nAQnYYOk*xKHvk&q{=lk>nio&~9A3`#0@3VvrnK101e*9%qW1*lAX*Mi079KT
z=@J$)phukbIaz83zPHF+>RK1(fkwByb>}2DuVGmlEY}-6Wl$jsVK66pt$s0%St5~w
zQUuxpnhQnntOX>NrdBSC`4k8Eu~jP8bIR}coFVapeo6Q^&qSX-t}dIZM0mrqm7D15
zqL7oQ9?P)fsXh9&uXx`6B8wxUeFvJ<SL~*a?%DXuQN&7WsJR+20}^+U|B%=_JcLUn
za7B}iBHWQ|)-J1hPsx{EAbOnQU0qAuLMt0gW4HFN6=?bN?TaQ`p&%py`ZIr0OhAK)
zcUaR0Y4<(d`w~pUA9(U~VG4qe=2|7mXYV`rw<WnQd1F}cJyJ6017&0U<>s?N+s9wK
zX+oqEpw}EP7jowNR$|i){=;|DD0q4v(4%V(juGk@0jWdc^$HD(Ti>u(LuY&k6!M~f
zYES~UQ;;oy1tb75GftgL9a@F&Z3~9@GYBbJED3yk+T!p8ig<QK5cqkgu>(Bc+Vm~N
zm^#ZT$l2S;(H|4JJ}$X=<H39SxWn`l#Z`ZjC5{nBSep~-c$rwozH7)QGngWm928(V
zoI^OFGc|&%5q%HXTP|bZoYcLtyQAX5n>f^a7<q%54uW6(^tDxeV>j`Q^oI^hpXA6}
z9KQnBsQkqvSI#ejYQ{<z7WtV4n(k<+fcLlSKEVBFDu^Is&C|I1_0ZS+1!IUuDR@m4
zZWgZBG`Mw&<CO5K-DX~l(M#1=le>jvHf|s4JQ%VgiQWjxR$W28q#x-H(wOxlo~&>;
zo4>g^Wf(S{yQ3AHRmqk>6PK=b`r80=IMYLu{JWs|NB0|KMG{cTtR_~4u61NG^b$%+
zWM%ZRbUk8S8B(-<mdpW~YI?$b_p%(80Ji%OSd_>J!zovw)+LaDh?(`xbOBZ-RG6+d
z&u?n=xcFP2<VgBW<x=nE5MY?<o!y;oTtXD{w~k|5at@?@67IIU?<V$1HkI_ENeSmg
z!7onKQ^EQOe$4fx4+G=*5@%mqybqK=+xkmZ;2YBO793il4l;GUsx$CAJcz|R9ovSM
z9<yMVgD8G*p*DtmaAExKap;^fK0Fj9)Pp-Nsed)rC;DR<1Da727`v`qt$nVV6NrpY
zDI1u5EmvLQXmIk+-X{{bY*&6FicSc)>w4zmBC!3gov`}y;rvLvCs~hm<$XQ_7(AnQ
zSkw8<et`ugb_rTl$ml@OQ#ec6atkJMEe&nR8~eR_*_m*-anXsjRavc$bofT{<b0NR
z%c{in1}Y!)G309My;7XzX+6=@E-69M8PPE$JCgpz&ZYoP?Z2+=`mV?;#JS+z0rsi%
zo^=BkFFPrVKhcHhkDnw8mVFliL9hCd`VMELl-e|7@9w|XUjPVxA6;9jrk0Y3@bV%F
zSI&LC&f(a387Afd2<h}7@!F%~dV*y|;{lZJYY_a0Shy$Xl1}RTcU<tWyaqDOk32TZ
z&{y+p6ZsY>91$T&bo3OYNX3TT6}^fG4+9XV!3VkT?%D3zT{0<M#SQhVe_YIm@S-n}
ztJ;>WX?QJqUtU<k4Av1&U<(0$hrFh{IaaoVd#(WPkVgajYn_UnZtQEw#F5-iuQO0J
z(QKXSfNf_{nx2znc;zj|o-EZjOneE}(7h9L;rFn6r;6_fG<la8P)T}}qJBO(J=nzG
zfDVxRQevk(6qYEtcoO$WQZuMvIct;PHTLSkD`6b9d0HHjJ~3K2vaZjjie5J+u-GKR
zXByaMvZ={4cMxzL)J^sD+r_VrQ9kAzA{VzXm78`4f`u8EW;4pb;olDA#OOIqNFj-h
z>Z1;vcqDEeYLR?jVH&&#dV;oeT^)Kv0H|V9toHOA0A{%gj5=5ssAx)vFoV#hJ%%th
z;IMu|1rjkL$KLX4pAb_0v=iYtu@NUCBUYGk{Y@knY`EaT6&VR)+l$PTwtheNM&|Rq
zp=~@nWmlZcf4yF8I|6?d2168<n>W|0uSQi<jL3o3BA00)7rFWhc=;^oac{A0I%DHR
z|EIMG(*%4NgF7g4uWVK4R_*5`O~EzrxawlVnoA#o2~dpHbUo6z3$e)a-^MKtA^$K&
zD23t2sz~g+x^5Ibebg`JiN~<S^RnM68KJuK9coc>8)Bc7|CnYSn}+n2+iLfc<Imot
z_Hv-kpMO+cP2l^Opg&t*`KAS?y(;iG{48v&kV&R-he@y4;LHVcHI=3%D(MkGp7nTK
zQt1&LM1CL$<=b~UJXr_ymCO0j3-Zcu^6ycoceAz@dKGn)U6|)zWgtgatrr1#aF;~w
zJ1fNiRr&WC4$L@r)DBRIjrS;Jl13*~M2uAVP_}4G%NBpPV5a6+(<TR>_T^GqQ^0|`
zF{3qB|HhxfCDumB9E*f!k4T3x1*<xB$|XObZXwe0ZaX4a{8;erZzXQExjlyWYy25r
z8n>}P<oq|6e&HlfV4MVHNzI4|^0jF2669W$D?&Y0nYD*jA*dkSM^K^pimKODcHv$6
zopNf9#aGqA=)69B1kXxiEXloV?U`v|MG1-Zi;Qyma|2abzquaWkULV-gDnFyYI$$E
zB5tz285I0Q8sGfM^;Bg(obilHpmr*@?3CL+pg)qGwvY1m;FKuNe06^WQvH^zYfsAn
zyTVXQF~La~%+Bt+*Di&a*m|06TNXSqx86WG{lh<R-|eiqQ+HPNmD`b)+Xd8g@+(gM
z372ixz0W=Js$|Rpkk_qlE?qZTDkf(?!0^&a`LpGT=f8V(VfSgTLmH2UmwqNy9<t1h
zci!5<S0!r|?((I*%K0gdLEbAuF`ZIrsegM^<2?se&XO^8380{NfBJ>)s|5Zs%?N8k
zHHNxtAAhQ<|95PwS`xbc0A1{*n?xGemF@kGXYK97!IQWuveDhECFmZ7k5Y~Q3|7-h
zlHFX(Vw$grw#@=-lOXf%lQ`3M{JNl#hgcPt`HODUbb1^WvA`@Pegc2`oA{=J*hfZ@
zeGS?SkH_?qYyjztPnnTuAJ*LR7b?v|vS*XdQ!W_o$i}@7WRwxRd*9~*Ol33-VDo>i
z@j&)&9(IL>CZZ*OoyfCp(pTW^)u0R)rm6wWdugQ05YC^R{m)t}*u%73(dm|S1@^)C
zULJn)uP(82W9tiPX;cA+l}yUurp`;jdrq)9uyluggmSTDx{k|fQ*N$6mH*=fo2)uz
zVMGtB?4>V3bl)TQh^(dJ$I87-*zs1HTKd<~iR=*|u+W9=Ht=rFBJ+OKQ{IHty(`<R
zF$xAQspwKq)gakTS@9Usgx%XN2L2<D+a?T~T#vCUzc4(d^rM5+M1nYGePP)={L2_u
zE-xp|0?eyUJPwr>>d*JB7hkL3xnRuby%#_J-$tdkI73|K{Q)Rq<4<RT*QiN=<5e%m
z#&LRUX);24jQ-)|rkzBa(^j&}CMFT3&hci;+1a8C;b*tP+aK)nXZMOP&Mch3KmO<J
zj*=jcv-$psfO&=u65z*Ej4Qyjf~REX!EI#`)+rj^76hkh-;*HDg%3#&WJtAIYG|*s
zn;nE>75P#@x*r*j727rGE|ktDTaWz+ZZrA-Cw#jBjK)h<6+B2iM}o`2S<T5dZzEc(
z!_*X?3YZ!_dFjrj=Wo<515ZMo*>fytLNP6fnvGZ?U{182t@aDvV|bWC6?k(8q}Kun
zEB9gj*qE(<qH~(1C6lfHODf`p&+r?vB*|og9?J1c^%I|Qi6U}%MCVw7#|<{GCE1Jz
z+PiX6FM-Q&9cer)bjmkhzf?iEXY?=yJ~~m0O*raigccB7b{EJXUfoDDjw;{jxPP}e
z8tL?VBK=SC>tg?z%ytc~4Qe+W<`rt>Sl6f-cfTw5e?k`ZYEL4Tl#o}{Kt(_%g1)h6
z!Wg~jEmZ(-;-fenn!X;$FVq9}85PD5W)-^r;RwywBlF9{?qSS6i{ZU1WRASBurGvi
zt^82Akc@G(*8NCMOzun6CqsC*`o->d@m(akgOnb9uRkjU8d^cM`Dki0iD(E{bmpoh
z<85}z&hd>#F}IhjR65M0+En4MA~RZf0IH~{1;RpQYYFYY840sw$j%+&@R4QU;>5CE
zY?$km+a1x{<c))-Yl8dgP5~vkbfW0?h5`+6iY7=zgXhkiciR^UN?2HLAU?;`BqN&Y
zpVHfIgUa<wHnB*p^T0*oD5MeIosxpGVD>SUEEHWY=1)4Y;9TP6R=4WtRdzdQ_E~xa
z4$;bsddM9AQKWE_8aKRMs-$Abkl1}k<xc2sjB1%Q{MvkPCn?g*V%V^-pm80NxTKyn
zhxDQ{CwW<|=>V-r_UcvKd%;WES`JdK;Z}`evXCL8zlptZ6L-7BZazV3<6&r4Aevwg
zGd-PfqIY4T!E{xxI(ggQ8jf&Jm0<gqDd_G#qN&ie?rFE=8mw+G$-C}Cq+d)b?c-^y
z->u+Lv?|F<Y7fnQ=TNG;=Y(IEA29#kP^}i|VQf8ebbD1Aa^EF@l9=-)`QK5mO8URn
zbf`z)Q#?i?U*qaiUN{SKF-Bwv$uOR;xDJJ!y3UJ6lgi;aCpVXwI2#H-t_mBAdEiHp
zxv%^8ygY=UstWsgp?`)&E7XYauqe)1oCEZD_!RMsJp&J+{KxJFW*7rT$6&mP7=q(%
zp6T5ndq-Q4v}nT%LgGk+#`d6M@KFVn7(_zGa&A4y-_5()`Q@xck}t$b=SZ%v-B#yc
ztL;yPXWN}$UV<K|n+dN8So{qYDGMnnimYTi@1byvd3mQn<grBifTD0Q;MZ=!tzGMK
z?PSpqKCTcS-H4nmGe>Ydk@P4`9Pcs7KgPqb3|bG#AcmNIww<I)xhB#QmwRhckL_O-
zYSw2>%s3g*@(W-EBA0uch`jd9?PP8BFe5J%|9cO$(_7BNGYB2Xxm+Sfie)kJ*}O+K
z^3|SpSBB^??e>-JRC&?@h}5Iu%A5?!Fb{)%z3%^%RJ98~YRA6JKO)7Y3w`(<XxZ)+
z-<@$h@IFScvZ>))>LjnfgO51#=P2_kiE>~7s>|{b{hFO2w3X960}qt3e_8Km1Ep14
zh&u~4-E+XC6qkVOp?GfK`yv`m&3wgA#r)NS3PS(%MgXz$)I=Z^F$@)h8C`8foR5h-
zvzZ6+lXyGJml8sq>kQiV8Z+}!7iul8&+U&}+p5Spl<=`W+Y+TlWlypu{)7rtZsG&j
zSON)90)heqA6wV{@%3HWF#QNuxIpVw;D|63Snc_RESUgSQz+vrs+#Yg-Ik|pj^Z@<
z{k`C`)!OI4xA;qh_5sIdYAgwV6Zz&!$}{ggtO}9c<*TOSH(3(uF<3p!NfkWykZ9vN
zrrE(u<_Q~vRWgoWm_ph1XYx{sglV)^ipfKr1WiqAvhU)NT(2;UChip(E2#iq1qrqz
zh+Eo|(oYDxUj)gJ@2feMZYskhw&-hCx0Nz_X9jW)Kh+vrZSomr3hQoWw>|={iIa#X
zD?EELI2VdfCw+1Hi2eac!M>_Fa^#TYF6rwlX;L-Q!R_FRegbZlg`eD(lu_St%%L>q
z&fLlKI}WXK2{M;{J(&ykazK=0@--fnr>Ut1*11LCJRL^XR*KqUOlu0p=>unOPnU?O
zT3ACmXBj$dJ>F1`Jcw%Gtp+IACcMsj6>S{(8MHhn?cR-Vah)r`$I{jPXw|-thkbhf
z;8eMNBoJ~_m)-AUuyvku$p93!&;H;gAP3QW(C(=-)XovdugNIBXx#UboNk7ux?MK4
zmD8ord4|wELq~7pIO+;VX_Cv$`Qx8!?!flcwbu<;BUA7kCuHxAWOf|lc3Y*wP$~=x
zqEZ^0_Qm3#_};x+Q+#>X@?N1ZJCX0m70Xmw$^#C`qb_%r=VW3(N1;u4@~RLWWghk2
z)i{k5&9M(A$U?PwGku-H7aiAAk)T&8Ao7#uXn8*i@*b+D$HXZ_XJHSBh6~9%!!&_C
z<c@c~JEwQs{f&4{?nv$J3W)Gw5{XOEUy@Ip=p|;a<Kd5h^wpNJ*^wT$^nIGbz%ma$
zj8&e^C`w1`f&>L%@Mea37GD#9Z+oDw+*VT+;2$7RbNx{icA)If0g(AV_Fv?{oiq0b
z@7<3=R%2e*trCrRkZ4`g?Axl};(tC)pgyd6iSMDAc10Gvr{M}MFuOT|pQ5}3E?qWY
zm}~@+Q?;yp3cu~)PPO`&q@cu!vA<?J5-Aoz#~_o4rUUT0*eD`2pA7o(&Ds=_n^~WI
zQ;aY-4<#W>wQL$j82EC)2v8_fjXSX?M5+vyhnXxUEBj&NO7uixCk%@nf-_^Q#1~6|
zJ(6d-D#n)upt}HVye5bU#O_78rbE;`5AcjgHNE%K{qI|lCYhnttY@35s05vgEGzq`
z$Z{iu%0bFgqn12*ACeRC#Z2l`Iaf;c+`#U>=gbdGNn>cDJl4&nbF)Y%?G*Psj%X?m
zh@!>@C4vAH%$|Dl(=T5bq35+%WBNkAw2-#lK#9P&JeQ_c>JC3M+>_qo6QiWilk?hI
zU&+dEui72-&fa4c%k7&QRCKJfW;ERHt<&=#;TaycI7EGSIUxzt`AgqX<)GlbOXq-Q
zw0{ytT(P;``4~Td?hi@ma_TfMXVT$4`%Wk!HqOk>B3mVHzw&iYf}{xT+++hg_-hAH
zq(bk}nf)_osWfYT5wGQ>2SY;wfxhhgGK3VawIG|Of}3Cmo=mLvmKO50+q<aaKV`TA
zIgTN!qWfKApK4`7_S#U8OkUE?=uTerzAm9TYEPIjjAZzu^3-erAduVyw3Rv!KAt&u
z(FEHDS1>lyHA-!FvLw)#nm0+j3*F0DIo<=xpAyvg5@@!hjkq%{ox~w*`&)NGtzt#3
zVo8L3ouX<K1LscLW@iy;vmQzMW`lb>g~;=%4g^j_BP)l?r*}>9q*zdf@Uw(oe_a7!
zBJ7W9>hGlKgpWJ|R4At-9V;7hBgL;XZ^KVMI+U84h6O@qkt!KXk5+&%B-Itj%un;x
zB*FAn8O(4A&nHNUV-Enl<Tp_lr<ASv&*AS={!(fiOkFF?N=a+t5t^6kM2F+HHbFam
zv9^U}_7PyV4T7=oPA~e6hX14Wufg*A&ATG&n_1H@C(%VU3+dper4W=;(zeo>U$Hg<
zyJD5MNuc8?v<Vl7Eu>cKd)~Wj$;9b)t+DYG@^K7H5)l!D{k%U#uc_VZzEcSJ_TML3
zzxC|hRhr)5qf2>5IX<7?M;<(>X;rLEw?8$KKU)l)v{QbY>Crc!<5+$rdoc4ow)y=E
z^#<u1pMlsC>D)kho_QCrl?CnF=5$`4JsB{o@qEgIFI7|XYR_!M-VNR%xI5o#7yp*<
z#$C)Ox;%k@xP&gge4H}+UKf)z^Ic+XrU>UPyH-7BWX|K%AF^ZZmTEc9nDFfQoGPAD
z2e#q_6%cP^)6!ulft$$JmIh+*bbu68&yQ<O%H4SWyzrCFO=+E@<mcm}UR2MZxvD)m
zJ0)C-$tsY|&GoIbARc9J2rud^#=oqNR^QamkH}P2Sf2df|1+B&Jw}^`?0dE89eeOh
zUfkAr9(Ht@Ud-p$^30u3Hts9g?dQ)E@zfn&PplE{M8t=L$MgKU{YWU&-}C(DCZ)PV
zr9#4+&Ii9A(wiN|5XhQJwV^IeN)EH6a~{ZASwA_Cg~o=EmAR@=yM5Bx^PWReuZ!6}
zuiL}J8>Lz$sQVmG>tX(+O2S3{T;uPlNxJ-qxVXvf$B&lj97^deDXZyiA_+(?=_eKY
zy?*Y+ruPboN=H^?g4^0&W-)77oAQ4%Y=+r!J@VDlw;N8Dbo*<&_F<lQrR|Z&eszK6
zHnDT%;{YqZnB3f*_QK%gNAl~#2@+*?d4^I=uf|QYa`IY)9vT!)ZP47&(1tAO8JMal
zh~REKiJBEwI%-qb^k0}1USgBRM~MNh7r$L2{(JZ?EcrJv++M$)2Exebq+X%&;7xv&
zS!-jIiyOCHk#DKEeyio?>GAjTn#TK9tPwt6D{H*0@*mjbbd%if{xVJRa*Apxrv+i=
zz!k<=YdzGqgK<IBeGL<Kj*Y3OANxY+_G=hB+MfiU2Q})gxFyEVkJkj1Zq^0TSInWq
zrO1D`<YZTOP8ENOEL;Q&)4GKJ1Kw$^5W_9nN_-t$Fe%13o(MVE1W)KrQ4_02P1gd`
zgWtlSjroeH6Y>v6Yi=?gxV$Ls%TNCKHXs<IM2>2ESfwVBVm3VaZRYz<b;z0i4w8bm
zcaUkoFA7cClp78pex@T7BCSAa$c}Dn<zvhg2Yy%&B08tSj;4)$kYC{iP*BRR5)u8!
zr<Su?(W6ZOM_~=_pj%^zqZy~q`q^~L^cTZlph1Ga@KSy0uZiuz$-y;gbG$V2Fb%aV
zKQ#|zi+?qV=9xBxdLTGWy+!Sx6cmpG+wdd;fmQm#VgGyK|D&|<c${#$fa3o@qoDDJ
zjXqTm$e$jcA)fUbK(7{yPo3<M69cMdVUHXFs_1?a*O0}jD8)s)G)3j=sNuBzfl`jI
zd!*RbvE2f5hZpI)_%>m*!P(Gyq2Bd;$?OMQnv&|<@t^C5Ma1}wQ=F^-o{@31WDJVt
z(#9iB8YEU@nBe7^52EhfFWJsI+RD89v}7gdTe^_zRHRnhwSQ-s4ZKC)2-y*=Tk&OX
zV%u{6RI@DpDFG{qKm#oi+B)zjC~u}`sJlVh?^vMtJ6&KRJ@M>FiJO)iJf?6O%7m7B
zrd4o-RFT%IWAZaGI#Fw+Td)+e4Pltol$I>~1F)$<rwzgrC?nP7s;KksXEMrljCv#B
zybX#ZRYBWpc&0FNFH?;E<gZ+!JzY4a^L}PlTco#}j7>s026S_o6iWt?l5rl8{5*s6
z{jq+2RKq@2m2h>Bt2FKlO3H8YID!q98j68CZP|`aB@qI9#J<Az87A&Stb74*f{Dt{
zD-*p<;Qj%3SwvlZh2{h&2xqMvpp!8GtExSq$(_1+|L86+!bVJ+Eg1()1yd_ZnYlgo
zrTr7@P9kLV<AR5uQC$83=X1`}Ip=2In0DT)N>F4pYsSwoC#^Wm9}MxS<Fy^N2czNG
z8+HI`r1PT9>>d$u*)3F#$aATrq5Zz6EoXMzn{JksofWTPQqvyd6LQ(Tjw;8rVKyGD
zkXLTd#A!)4(SufRS+2lW?+=^1-=%tmm_X6zRg(o_XV)G$DMmn<Rh7<X2w~U7WX@~!
zvSq@X21YNJQ^v;c656w1>egIN^#~Zt$16tdBwnDPZW`OPL_VnQ7&BFnsy9JTkaO+{
zu=ZcQZjc?ivL}mv%_eZTN%G9UfGtNTmprlWQ&Yz#k}Nxi45E=#7N+nmvVM{g<nS9V
z^zRdWJzgY&tVUI%loDMb4IRIxjd<Y1j(z#qh^vhJQ|4a<g`*+r{ob?3KPQqd5BTiJ
zIL}8Qpb@3>zf8PwxVDI?353@F;K;qoU@)QSiRvN3I!mA>L0iaVjhz7Eb=8p8YHgRa
zvWG_xiMt#0|DjT0|4y`w?t1*}APvj64$*m)eZ)#`z?djq-YJ*SpT98$G@Knh7$5t&
zF>qF^iqYV_h&hQ-b@=^wI7ICKC_2lqCf_~`Ge8*4KqN+wP*A#Slys;_Dbk^IH;iUT
zgOsHH6@xAX=`l)LkP-%rQhMZovAui0?Kt-7Igagq?)&~-*Lg<8ep5JF5=Q*N@Ds?R
z?%!<BvsO6`9wdX=9;C{S|F;5?^+D@y*QM!%4%nsCGJo0pGH#gyU%QVn%+>m!pSi>D
z>8uSa&W!v0H{)Ap<zHBQYYqMn3}{%I@`fV~yU(Qa;q~wT*XS$j6VrHk>Rq}My2sWE
z4uoE&+44*0@`>1@nTgddFoIj^1FEeRxt(?-{&s%|kS$MRi}#V@M7^Fz2;ERp&U4Yh
zLG9w;bnW)x_wv1znIl^Rv7JNn^<dYHf;USE-N=DR=Or@Oil*>9^<fZ2aMF<vG%b$g
z#)JD2uJ!TPvr(ga))vWn^!HCrJHuH&=UgAAh&c?laG6XCzY2ja4Sd#CG~yTIKK5;E
z>|KPcx0gMXp-_Er`U&lz^v~yt@6BKk=qTOSTAn0Cci@0%d|9z<rmvvipG42=Au;xb
zLt)-(dn&G}Z+Kp`Sg93#Ryvix92$GhY&O%hYvr{hp}0;6P<d^Ay3$>%ciJV?)gTM9
zgri+h(#C21?MHKh)}fiewZa4O@MZoiG=BtNo_Gs)iEbR-NoW$ccNKi3|MEDtY`ILn
zr}%ihN8qM=veR}!+H>zH@w=w1%k8@mL#v3E)49RGCsK8NVv}E0jP5P##$+oFWwggs
znF-h-Vlp<pVqnY9C)F5Nx%U)`9LaIH8fPFLxYbtH&yJH-OJ&vtJDP>PPwQgjD>3;N
zbhKk_V7rf~;B*b<^D1yMU#gIar{e1GybUCl$fJ;u9Xg05c_c2GEJ4*Rw0=a^7Vs#@
zoZH)D0#yDHeNrU9@+)E=Ms@Z)S9rw0nv4G;1x>!fx~PhN&LmWyu*CCAFC(Oz7CWDr
z<PiB#8(3VdnHQ=47LMXAWavKJnDrsb2ThW@Cq7>{b3D@_oh2_m?24-$dUh6tJAP{B
zRF941BS#`w4#)OzJtTfkI?=7CoxTO}SDxi5t?5UZ`J4?|$d?OLN6C2+oGV;|TYbSF
z<lW_0LboD#&FnHR2>*v5v%b?A9T>&8miXuCXR=Q@lB#jL!jCin5X3oqx&=?U1CQ<|
ziieSxujgyy=oz%9U}1k^OeI1)rr?uNd7oQzK}mt&Gc~3Moa!mU|Gsx<w7oml3Y&!K
zde9Z7``M~evrLJ6NQfbx^e)kS^ayp}O)X)%%AvQZCRAFC^r^cJkY!QpCJH{hvGwca
z3DUT2fLh4v9;np`!S;-;-;w<A`OjWQHDNfO*hR1n_Jk3+>>w%^DS0uzr3#-}_w|OE
z@m#C!->h(EWWT4McgbiM)q|LbziE%`{)KJgc~<Q%c)2X6VeN*wZ(5>Be$UZcNBN}v
zBIVM2JffTyb<5KelOPMirg&wGM~8J2pVE6DCI7;j&Bm~Z1urVYu1R@B@bANedLjLu
zB$+VEi}|Hlz%of!WW+qlkMBL)Ke?9E$LzJ5uF+zGc%d*-LJCXCM8gz)=$oH4QV5$+
z67$GfR41D58+gWG>zh+zq6edg2ln&t<q7C>jt?Ag+&$8XXHjA4`DLDG@4~O)^)dlp
zVQC|23uh})k)g-0SlJ5yf~6L?&z4zo!pX>a&{4w+#RNO;Mmen+2~HhT<X8yF<|lQ3
zU2(LN#Q0IU!7P-1+P{^NlPqBBIl$-F-f!WIL7D`z?LW@OZV?qQ*?s(1f7hO_lP)a$
ziR;PYtE8>)MPET_q4H(bH-6UdMF;Dw2VcLn|0tx!>MxFOyS5c#CcYQnLIn5{-%DYz
zr|r_&cNaf=p1ARMz$P8TK%rR~zHy4>Tp$+tXMb+{Nj;%IfPuI$r8E?!w84--0eI>^
z!CV?B>mt)n)o-v|zQ9f%5Id>Q14>+Qfd2B(v)T#SYqtd+MdAp#xC;1eo@1%flP(pR
z0@U2!#Z4rBc1DfSW-G)2-hPRPm#@eQ=1q&UjOq&{HDl9COlqWS?a&T14~LtBEv8D>
zXhN>jHgW1%)-m#RhwT8!uf2MCXW9rWP^7iyo3WS(<!f5w3AzP5PEXf5f$|X_E~;XG
z4fxv%^w%j$)XvIt5ZR{?a~ozby$BdQvp1Qc<@*t(4P@OMe1%DbxBC5hk$AP6ATv3M
z#h{8tpNxR0LPvvyvYzERkUp8_=<5J)jP5{?FI@EW)M!MQ(tMSXMn8YlXvt+;Gq*%l
zyM})zxV(%jpOy1SQ*ov$t3CW={T!6t3Fq@o{xhCBg73AQ(TE5pffE3Bj>gw_iOET-
z>&`S_#;Ww*EsniDASRFWffr>r4xqLKgQaA)v(lbhN0<p%oab^a^IR_BY}{H~Jmn$=
zLbZF5faa?#MdhYx;$wN5#W1P<g&rjS`2K|Zboa;eh858DGB(9^whNS~DBt#87KE0p
z9}s3na5IiD^AtzEoEU4l+Q{P*Y%MIMehB($PZV4g<eL!D)%qut{wr&xjmLo7bA5mD
zdhqnsn;aPNqEJ|<U<DCmjVc#LYcf6ffYX>qK;C!{6au1mt0RT;1zj5NB4EN9ypU>$
zLl2G@b)Q;^>Ygt(O|;4L7bB;kMeT-FWYeGhZp^#t?IQ|r=46}rIi)f3l|*pdll>33
zcT{vYdXn9J(r1exd+#9Yv16RGtJ{OJ6njZ-U-47lLE_qF-lmUv;zp^u;>YUq*ayxd
z+@0?Uqh{O?xr{$@e9q;ciPGyva;UT8Nm?07W{SlRBYs&vHJ@46Wqq5xT<)n7sn;di
z*cWUxPubLUzIAp~$qm0t1r^5Ao_>_PIX9W-*a!{!!ZeXV|Kt$bzIB9D5l-t9O36uj
z<Koz+`y68Vh<ni3=OuCH$`qy0Q1#E=?jC9_W*-khA|xK}f2gu9^cm!oPCj<hg_H@e
z9A06dDYC7SFNw?xdc(s6@-eI~JCR0x0AWV(6Lnt&!^|MAUqX!j+emMIF-~q0pI;lW
zXuwzJCXK+>Imb&TN)>*GmL+`;8%0QD;aRv<+Ed*Ngo^ySn54t?0}DnZHFGspn!rnT
zo(rUAK@v{@HTT8r{0L6q#8>bOpsb26-b2k6ACMu`CUMvWK_Ul7YCawH8P|HgG^V5G
zEPL-dhW0%=e1!T;o;k5J|1xc?sA7CCrBb}!_S3iE?z@QaXh@uNxiEoAjZ{KrJ0n!3
zwec|HFV3>n(5Lp=4imrbOY5VxQlf(^T`1Y%mm&$w^kFcGD1ngc|HUg`zFHq?{_A7B
z@BJy^9g>qR{KE*~@T=|0WEOAK(i|vpOG)jy<CiBbP>|4;sYy(pPPFivJb?f{1Z6)=
zyO{n;M6!vUBm77mtkN~vJ0_FfdpiImaoFsu`-Y<JI@I55UsUIkj@VN4-^<2vOS{a2
zS=M<y!h4c!&b3m%t<1A3b!o)y-5eSH;!5)eL0vm>zs)L{^Q6nmKz|3HaR!K{FQ*5)
z5eF;_Omm<v_sZ0D<xI8Hw8mMZSt)$s2<(CF+6B;E_#|}9s!-?M4T<myC0`4@>ZJB*
zit)dF6*m@h)Q<ym(VfFkxCxk2&)iBF7k_I!U#Sp@kPdPc=<_{)>XaAm72~bHeOqCg
zM4BVK9M#{%&6rW1(S1NYVMhM^i83YW*Bk_67?e#@{BYcmYD_KuF1)5*gEayeE0Pi<
z%U<KYsypTGtQf02$@&T>gu_$$Ih64^|C>9VK1!BpA9pvBAgNTOc&PSq((mQRn7NYj
z;sLLT%O<8zJN9f8KXSrSS$gFd$G{2ki<4XQ5reeD_0C&I6o&qVTi243MZu(ZT5r-x
zOqR$89B<HX?EVJRH@8<%@l-<zyT8s=?#>=}FOS7q+D?G)IXK?}%P#sQ%kFqQ*zIwx
z3%>Q-@VncQ0(5Wa?ayWAP)dG0*-Ph`kMugM@AXYqY`YY(LjQfhkX>h7>LzX&g>cWs
z;`nv_pE3YKi~OW~3tp)i3sZSZId@8Vzn2FkprzN?u*7~#0iy`l@iP?SHuwo;``CSL
z;b&8HugZQ(7Ql=9GC7FGIV7_<j%lF$9>-n+igbLdw%qQsy~KC5tNBA@uG~C^b(pv?
zhr+vP1H_aKt<dCK$v^wGL(|bVg6>?eBNxR$adzH6Yzn@-N@8@cxHOFu*8eOXMn}bI
z^S)zZJ%A$^%K$De74R~KrzNS+@Yvu3scA|;auh!j6*Q-|VZ|L_7&bH65(!U7HDN$Z
zDwAX@m17)sIdzP(nU~t)N!q{xQW_-nJcHK?M#50tv%=tObVvnBvg?01H~w7V^N;OA
zfa23UZ>+5<+ooyk$4{%F6F8$6lbbJv-%2hOrdLK?5!n9#Xl7spUqJTNBw-zb=1n<C
z_gjN-%l~!@CYBuU7VXOSAF-XKud7w|TGWwddgXqLScr2q8^{tlD|Ps4qkX9#|74yv
zeqPY&`7Fht35L~^yQwK9bNgg0_9GNJS4{&it}J-_PTGquYcX+`Q6Tugq!?b-8TN23
z#tD{|>VecC-ixwFN5uR2xz<>rj_RnvW-CnsP%}6XWy&?exilb}wliB18=(3&mUI`!
zt0&{7?Pc#3sy(Z4>f7N7w5{noQToAtlTlBJf45uq0%L+Ls(BQc`bSOKDwt6ZmNSrU
zq!NGkY0zxden!RNTlUubOGw8n>I4<_!V)7J^+H=l;tQ8J%-8<nua9&^&dF+kd+a7v
z#3+QUx=%nr-=F4p{1zI|wrODS5Zd$b=8KY!XxVaD5}|E=VFDxhBYGpXOSw`$+a7r1
zAE+>JY~vY5U}pbiK2efo>or(1(=N>?K93hdt7t<CXkL#_ElHJ1HYwmj=HW%B*$3-P
ziVk)c3BGnO8|Y$sAb);e08Aq`6bO2N1oLs9&WaA5bY5L7Jd-4~MdBJ;xYy0Qn#Q){
zV_got;O%+^6P5=bRW)?jnc=A~eOBLF;4Bu*;~V{Z_Da52KBhrP^%+aoVY{H)2cY`#
z*C2jpEN{nx`1<Nah;G8+r7TTZ*<nNeTNSe%-zqT2s_HD|$|s$9EYbNuNc$Q3GpULc
zTh!lkIxuBNxzXG#L{J!DrRP^0+z?d*TuL=a!4zcl=hs!2#6-Nd79XXXoUBWvzjo$y
zthdb!uV~@$ogzSYD%)&tl~?f1r7?1dQKYt)PgYy2VoE~P;$!YAvcByE9$`pin!^VU
z413r4#F%pAI@d^0O$E`*?n>qf_J(~UU%HRu7D#pD6TFC^<Q`Vt-STKD*+<1eEL*fM
z9)@k#1(rw6@6=WS{Ya@Sim*Bmq&wq`j&RQP(Ws4%XwG54HGB*t+rxgV-!saSLfS~;
zQ?bS$0<o2$_sO5!mMd7^#jOj`BFefj?<GzIw{CAGde{I)yaY?5rOioTn^Nkm)zLcN
z_Dg|{^kk37$~T(oU~>yQJeMZg=)-Tddib3p2wG@3#g0j=emVeKP6Q=uOFW$7hq2GT
z`|$otRLqn6IJDu4JOBKxb4Lbn6<A0X^s0xuoi1B2ABX5tL$B^FoNazCDeCZSikCji
zITi3!wFQk@j4Z)Y*nerg`;#^@svqL@+R$;AtgJs$I?$;yjJCAHSi3*07$SMQwQydy
zbRufS*);JPZ7;wG)z45HO>55onu_epEupHmx-PPFjS+1Vy%(flhX2g^20gy+a-9uL
zC~%cN`Jq0^UKl=COeo6$13_N<Pq^)lwGp<QTAJ*ZF$_p#2!J68{)$HYDrFcCkx|f1
z0@v0Z=_72~w|9ipNJ_c7zlwgTw`520<E(MFGSx;=3d}*rbJr+WpQcR$yB!HH9go3v
z%&nDwKDCCc&hh@(3VHhny|4$2Bu_tlF+;0e2Mx#t=<h;7awH$ogz^*;&TZ-|{F|tV
zEEwSzrZ`6L_$^H7JLP|&6seXv$`@fTORt<q+V!qUGPUvtkBcuCccd#Qe}!+X;Iu;o
zJ_>xSz*{<TF*DVe$~m#!7bsd+)K-VE3{77y3r76o=g!u9DSfXHLsujdc~TP06^N-%
zT}MSi9)r%>y3!Oztjlw`6W8u)dLOXD`;YAcB8WCN7kCa=sn86xH&%LgtQM&qDh<ux
zo8DtR70BB=tLI4J|8n@k0I1`B;76)`3Ot%z>lf~Fry6D*Tz-59j26o}ZGTrJLeDV5
zTfL|>1yB1$AJga(^<3CTnvfiS5A2=PILV#Gb=~?N%d#7B0|VVJ7gKIMfhpRv<j0(r
zL4SSs`-!#S2t<AfJ_M+Vxf!W{?pa(PT)+R-DsNFSz0xG{OKL%>OoCA7p4{nUEKb>R
zRR<-!#wlAzqB(an3mMx8`Kk`O!lHUeGrHBIha2)F@n_(9T4*cfN+lMG)d?}DjL=Pw
z*iFSCwwN(O&m={=Jce6Gb(C`!$iGRNuJ7oul9ChTie=YBJJb>_F@BH*l*^5lfN_1T
zq18ytIb~(g2Icc^oLd&@;a49XE)<E_>zNkNig0DgTF|9^5CJDLd?{t;*4y7QIt6XF
zUA!lQqx{6+vqm|CDg1TXUiitxD&#XD({d?1O6_z{<CIjSi(dZn-m0SW^WP4HvGg1J
z=oyYI*!`Cib?}r8o#$*L1e^Tl*bWalgA=Z!myV_fwp-K_8(STELtgW?uR8Lcsh@O3
z*9is?=ic#9xyZ%4II{A(NDL_{Bj<^Jtg;>DD~2BRnz{3?mgJ)s&8{dw-Vbhqism0b
z!3ofq&@HJh2u1f+?*Yz8kSaPbZaS=?;=)P1j>ugPZUTRB=La44Wh!Q*y(y)g;#kM>
zoOSrl3)+lOgpd6o8Mg!gUVJ<v+~<5#WX;m@mx}bB10kPReIj>T=32F8{)0kU(Q4Y@
zJY!S4hUk>0WzCK26tpI2KP~4eiyTT@mQcq<;g_V%u}D;mJ3-E5FMbK$^gQ^j5_2&V
z(ET9*K<<23!8pI-K7wEhSs~|y9Ne9<4^MK{WUXfKeIKX}3&nRoFi5>1Rdvm6x<1il
zi{(NN)9VkXlKR6EaI}#WSz?oHqca<FG1QTfl&E*SU|f&ODs^FV0%dgdATc#!_=#6~
zh%0Cw*nU=X))A~&5IjaKk5P&Rq~#KL2rM*I<<s0oLe0x5sheX(z9AC=3us52!Bl>(
z=6uwElbN>}hVNcDj3e^KkCEavB>S6F9qv0JG?L9xA&u?BxXi1jZFsK*sEi-9IoK@!
zrry4z0O<<H@M{~S=*oR?(CLWQqDw28->S%7v&-l3)V84?(N%R?;CX~#^MS;~xZCT_
zoy}Ffelx@=`MjHi>9}(P(oNW9=0e_9JVwYZ+GT-ws@4fPSJ`>c=r07g1ch!*A2y}?
zGhX=G+*_m8^8h%{CjXdhy@RD*lT@eYhEJKGg)k9y!=dj;2onhD=MV&dp`g`|j>?g8
zK&43sk0=njDD(2L>7qP#Ya(5)CZ+Al_rclTS)A74xv(lU@cJ;f=#@i;=^i}Qnr@Nj
z#?|9Z>HAaQttb!42)|!wLtxP>m1%lr=Epp*F<)!Xj@}d+O>B!OWR4VN?aWGMOR|Y>
zwBsP+LaLv)ZjaxEmsBGqx#W~+8Zgq@51kPF&(O6Z7}C(pF;BqvE0H7es8gQl;b$x>
z8NFmZ+&$nWmVkUivOpMZv-~VY1hm2@C2g}|<-tn00YrI?qXdGZ5=Pt0D1Lbmw3Ewz
ze>E~b(ezw%1v**NzGTFVsm96f{Ks|lCR}%9hVm1MdRN8%5yzBfK2U>|cq6cGGasmN
zH_oD`K<5~v;NU<fHtKL|hJ+Twm?Q-$#n50lz~bK}l4FjJdpN@9LEDR=ydL(tshRMw
z1pvKp^V=iJwxP56%u<e7#|b(L6@c3abv@7D{9P5Y36~t;^}jW?ja`s|lzFx5nb<Au
zr`aBmuPWvw6HOp?fb{+I72e@TWPd8VS4bu{oY?a}pF=5Z027nD8H@{WkK_bRf%mI8
z_NWqYZhA7)x=zf}jtrv(AnEXn&RI($K#Q{-p|f}hmc2rPHMsVZbN#-xILZzu?W#c@
zbMqS&6&H{6h6r9D0N~Xo8TO#We>r`tpWz1EDJ%K6KzB1RQb;&Y@VB_r3CTY%Tg#a|
znHX5=l>=XMEtlQ?Y=C$}`Vf<wEF012+M`-5y}DOf2{^nSOh|WVVo1Fp(D9{U%6RJk
z<0tj|4d6#Yf1kJS)K9AO4er#Bk(!=a>{d7h61qT{&dfeF{|3RRj~n;w*+Tj8F$;Kd
zNH`hvNCLl`?oA-bafSw*aq5Tef%Z#o+fS~aK0m}zo|VA*RCIqST&9x_*{>mwN3xO=
z1s)Az9nZVC2n01L_Qcsqy9LERfs`&YQw8`OtbV{WQ|rT3C7D+V6oaOXU%VzMS<vZ1
z@@3y(nB(gG;+e`fgATLHUTTVGSkq=8Rcy)8&7#Ms8%BC>scygsKhxmbB^7xdmGzU@
zLN>8c!#yD8%md(flYf4s>pIb1jbMdCT!W}Yi0h4SS(72%w6wNEp%yJM_ARBIGeTs|
zfEvYkO@refjNcYXVU)JAR4+|2yf`d7ej&wCCA>~v|1>r%rwYy_`a*n1HlJ5-$jszp
zk3^ydEy$tv7R^S*>eZ-NUh-UpJ%pB-W2XL4fTHV*o0VI!+7y6HWf)1!JCtrYI^pIe
z6}*-OSXO%OoS({0l1Hp|bj-+i*!6@Pj*-whz_R>X|BnqLasBgmf;#jS6UCCs_6;CZ
zSFEZP6ZFE87}axBLK0a#Cu_92YrtA)f+4*%c6rRgm7dd>|Je|+cL%&#`A%Te>p!cz
z>e;H=Q0iXqtMM=*gdzvr_mi*9`yM}s{;mbA<+a;r$+fQ{XQn<~NdGMsKowTKBD@0W
zd}oVgxc_*ZASWmNmfE;5bs*@zicW)21x-G?sy5QA^Wn-{2%Q#N1T#|8=KQx(G&X6(
z8J?5kz}#YVh!Rl$%fO{bcZoPLDYX*Zay3f0CJ0=MnbW0i1?^^FrX3u1$1gr&|AOdt
zJ5j^5Neo#BSo{K3(4UL%faJk<7R*T<LiIkdL#7oPOJ6T%Rc%ioQm_N1$MI~bNb*Yn
z6;9fD8^#Dl?-o9R8Lskr#m?H&pPkjf#E;0;2rnTZp5TsPWs9$7_YIzHJcKieC$(_D
z<VXAQq@X3zbWFrm*MdcsW#eg55-*iL^KPx`U*#;yU7$CA(sPVC1Ra4*ftt?FM{g8<
zv+9VYjR1C2n=uj@zHi9B_v*tvkspHfkEn1V@i(Jhr-U>ZZr+cT%piv9pg@c3mPxb?
zA3Rd)W(PwmaRnydMN4;>3PY2!$&V3kLQ>j;8=G>`K^T6WSL&31KZ^!{RywfH--5Ys
zLzUd|$C~M=BT9o89zmKci%H)01D#Xdn4*Yf?<8hg$;2-K?74-waAwCSwyfXu1%3ef
zJN}Sa9Ix{Iph$WW5bfQxaMcuWEOKK2g0Z$5(}FGeJ*VhX(FxU(XPL~LY-@20P2&T4
z9(*LW&@e2Z;I|ld--K*ZH#jq~&T*oVYej#50xb_>FJt6+S9!~t(c-wft7V|}=SNT(
zy2+^K!>HD*f70Mt1KK&(^*uC7GaIv1E7$RK&Uw87nV@R*6Wy+27<k?*{Qz*f(40O>
z6&@(+V-vAQ;HrFg>FbcGg)!~P?JXUOe98YjAmuBz)gZ9Q>L)lEbT`otWR*NXhY!J!
zl#xGq=<o-3=s>zcDrCDOlQfyS)iREONVMo^(vtnTI&7xyRM)DxkOz{%eaunq2O8~q
z@Y`R7w(eFnrLfC*H;X3RiqN~&%&soKwb*~%ds5po_Qm2bSem0+t-C^k>TL6w$4v^O
z*rM`1W|sma!+U4NQWwJ#AGr>_SQ~Tt{vWV`J`RMGzr#wj5HX<Sw3Z~K1QF1|khX40
z9SDsb>nA0{kqA;p1w-@u5S>1adK(LwxPH)2Z*U-!x5qwg&<0Y=V@aS|1u)p1MG<gp
zT}a)?dLbwBa&@oOK*==zp5XX*7(V*H6-6%<iV8wvXwEIgzl+!3UpV5~e}u0pXOWVB
zalU3JHti!NJJ$D)(^|+~l_oHuWhg2DiT281Ef3zic)q-!Zh_(%Tce@8j5G@51s}X+
z2^f7b3#0QteN9wTf!2a;?b6Jg<l(iz`o{R*qHm#APfL+-F3u+bY^;hw@h9TKf`7i$
z?mqQQ`8?fyF7g=6--Kc~m7iw99b!Pm+U1%_tt#31f5j}vKFCNzxdqX8yz+@r<y;_E
z$L=vH`LBY~?8V1l+Bo1N2~LjWV+oOZUkbgf{c$>%kfJc@6xJwA3C3n&h1qQ5r=#RQ
zq)$SNWh3{9&0@OF19qBWcaD0VQ;jz<D|vrqWBy{w-#^2WCemoxS;eXP0wC|*%%*NX
zU?-apG*r(6%Ja#Mlm6#eP-Tk+^Y%|O1calT#f*t4qb0`S1iqKqJmmAL4V2$_J1*c#
zW=8r}F&*qr2lRy;Hon9U=@r$XLZKLGY8Q<@33>}&BfDl(Zu0NLxN{m>3au3sGo#HF
z%EV|+RwCiyyv%~D<1^;alF1|+h&Zu5><=6tehp2TNQi`hiHZoD`KfZG4>Q`Mc#PQL
zOxKPUmGI`SE_c1PDD28>I#w|Qx8*HxIZDJpIX-epCrW}8)S2zkdegkC-<}RB+{=@q
z7kQPg5h8^joWzHk(hS4Hm#&ZuTdxN#A`%Xatv?A?kHmeCwzejoi>nx!MnG**@88}m
zT&3WG8++=H`&NW}FnrXa0{;fJJMo!ENkY6tVPhI2;{VA@FcMqPrzD7A??kR}mSRA7
zISy_%XvJVrIVha}Ee@s9CHld}{ujEOQK;=l%){<@t_H^Rr8XcSi#f$rt@hshjkKD7
z(;rRIJ=*2VsLI_i#FjG-L+S&5fze-*kj8{1QLp#A-E35x*da~y!v1TG^S8^nvyQhB
z>d7Zw`tQ*8Ur3T8x%^c6$SYz7bRTd@2FwjUSv3#~)jcvE%;j)*eOvUSHKfnL*<<Bt
zQG>zd4gO5FgN7xhL0&kQQDj7=np&yQ#@y8|_D$|xRpjfMY&SK^(SKskk;hYDX_(I@
zLLS7`k~(N=VnN1M2H_zpCXX=-HAqc%t4}6!!t#<Vc=7O&bTw>2!Qt!b+g@_!X^}c@
z?e_Fii~1eJ=!Le=dQB|kr}Ko!MO#?ow_rf|{?Kls#C_W-k<P>4rjKG*;xloc9J8eB
zT{>TnNQ;;1TH<?HyX$;NRwkJ~Jse2*rq^Aq(xsl7_L+cD)@ME93M|U(hF>Q!h3@9&
zrt24{B(U96vG2Dk-A(v@NH5ZCn0j=|K(9Ob7b@fOPM>)$toT;w2KN=L^KV3Upxb6b
zeKGvcx8)rZPw+pi7P>|A4yAKs`DbcQ|3;+gGcCb26RM6*^@rc@9~1L3@>X-m(Q8~&
zN_l!?wc2(PlCs;1iT=N~cC>?Zk?VBO>~ZNYo-M;^BkvoYtFGRyjsEbhlW1N+=&@AD
z0YvhWUt)s~5kc4__<`XV4&)usH!&CGe!P$vrXl@^Y~fMfhj@6q4F;5x<&a5U)4JS9
zy_(BiDg7_xuiGAkA>`8{D}s?|w7ztN+;?}VbN<Jro$OD#@%X9VEak)Md(T_fg<vIP
z7_xH)*yUL(S9fHPuy2y5#P-BS1!tgoQ2+B;6@H018W%^Y!j|LuiM->k_Ni%+Y4Lp1
zp^*PN3K>O7X*(L4*}Oc3)p$#9QOK&?#_`^MVSoG8%%cXBK95^QkMKzrtXCu6@;f0G
zVVwJ%0hnQAc`5Zuo&}V^M+*U!$JwxV{*nCF@$c;4d#H?au-2<gWXifRi}=ZCSgWDH
zV}D%%?V^wIaWHn)pG&qcR}%s4hBDv#&zsh-tJu_a4P&p&LQUVbKh;G$y(={Ol#lm3
zVUMEcMIFmEa4#I~;vcwypbvz5F%VZNwNEQ#%X;dl7&TwU%$I~45^$$sqe;Y#&`dw!
z^->Wf=jIw|_|8s}v;zYp6XFhoQ}gUmY={<CY>YF8ij3mrH)a@~WJt~^jhkSTCkq96
zusr~OWh+n3BB4+R@`s|zB9ce-(&X08qzO!YyMI4_KGcxcd^d?t7RAjo8gAhj^}vBU
zPCR$)?mTumEq}I+%_envH1gkFnu?#Kf2HDNcoM>;rt<#Xy&#5yScd0r6&Fz48v&De
z9Zjo)w}(Bd9m)L4Usy->BQ@M;yPrPv%7w>|YSH!nr#6S0R=RxCPi#fydK8y4gr>N*
z9)^I5nb8jSA+!h%_}c{liKR^;_YX?v0dV3P$COjHg4ahaL8kg7TL|^(u1qO6|4teV
zP8}6M0Lv87DgM{<U<%5TA4*-C6D?9W&GWlW>erWpDrN**hNx4v(Xe+MjDRI;YqmZF
zX{8B;tS~<~6sJ1C3crlVU)5E{IuaFW;YF2|KDIIf%^_Oy<gFqfhHG(EFU;cl?lAi@
zNB_678F`zl4G&9U6ney}@#fa74&244ms~;A6dFE_qzc_6);Lob#vXr8olq`}V|Xuk
zSVaPK?ng^hIrRI9K4M)itK-i^Yo|?ZU&#7!T2>dn@qltYR8b}_@(EC06$*{i4!;0<
zj`pz!vPpi7d1DmTzMpuwv|*3g{@?X30QMi{zbTY)QJ+YnsMdyz=?gA;umU|bahB<{
zg$CHP4wUyLU)jXaI7CiB*xVQwOJm0qWuI3eugI(W!(j)LXYwobczUwe<u$rtQror{
zvRf?dV>4GM6Jwg-@IjZ|&NLl>7ARJIVj+y+1~HS8UA=&j5CN`dh}-&d=yBsZT3?+>
z_KpcQQot0-#D<cE!{sI1hRtuU{=Pm;E*$@o8>orZte=SE`4Jzuk)n9dI{CI{m`PfK
zoRa83xJSoQRv93*9$i46<|v98FY__wWT#b+F~jbCtkk=FnttiO`$x+|eif~qw5BH5
zPH$5*M+4Eq=~$&{s~7t7Z@Wy+3W+hU2xov*LX4U?b?OAJ;y2f#y+4KjdB3>F8oE4j
z|KZO;F<wyE{Gd{#$(<vy-7DfEFBAk!fgkwA@u+Xkajnk_pZ{mjdT)%)!Rm}4vt~Q}
zC9RfUd22iHJ96zq@hdkC05KJ*39KiFG1_kOVkP?EZOpbnPy^MvJ*{2jYjTI2^?Ptt
zFG=4HdBHU0;WVy)(v&ZRp5gXPkXk5^ToBWH8w<)d$(JTT@**w`)WA#lJ-qE*WEjsa
z*CpQfwtI9t3JQf2J^n@0WHl{p0+K2+|EZ*p!fmGZ1~Vsb<5-QJ+MbUoJPmgl61Yey
zNBFUohvxcKe|AvOv%MFZD(USz=95TBvC%+=7UGl-emr+P=$Cv4zzg+Q-q6SxB7arc
z_N<zI`@RhnwMrJ>L_a7YVMt3#1z~?^`E+?sJfDP$3$pleB4S%L5+n_~nBTeSSyc?e
zOZ_4ps?wbsGR2e=Xm2~+VXJ_IqC^KTNWa+;6|%MKer0|DOn^?qK;~s+Q3^)d_|trN
z(+XAdsf>%SadM3$OQTgxgizh)_1<NG+Zsn78&sfDW^%{(XPw<JT%Jxlpjy2~qcyL-
zfP94FqmIgKo702nOECr4e6+yV0h=-me@FGh*0p|O@sm+IH066f(aL5eeNQ8-TBjfB
zsCXA-l`R6FlPR7P*!tGMu3*a4@~=tls2=#X<EpM=6;Yo6i9i|g`9WtSQ#LSH9*m&a
z<qd<Ehbc`YL54%ygAxjnKLcF(fmkNhZe@<mV?9ST>1d%f+WG+#eI_3pRP=jkV%`Fg
z%>f@gew@+Fm_`KUOr!{c8i_sHC@!Ko)|BPFY5@D<F{TA2Ae_F0dmedjHMK{QXf|Z`
zFNT!0CA|q5a%4Yyg12YlXjEVO_Sa3EQ4T=3`|5{}TcNDXFfDt((CF1a1hBkb-WXiO
zDl!33Hv96}7j0d}pjgHHl`V-Cc7^`3Zhs{E<zn@(Zm9=QpScX^e}%jyK{xwagXye?
zlKZn1PZZga-UXTLlV|Lgj9?z*vn@u=WJ_;8o;~a2M)w(uw!;JQ)^-yG_|WI+vHv3e
zdQ$NHt!&1y45aRt_uOf%`O`xI@@?rJEzj1pHm(p{__<MB#!XzY;Af1&NDQeHKM@=a
zN00_+aT^Jnk+ta9W-_B475^Vg2#s^}ME<IkFV~6f(G;SurV{CF_Hrs!---zv&hN1<
z4KsXEo<u3EfFkVufc!38sCdnpi&Lhcby~=xBvb~)$S><2{8$BFaou4OuMmelQfC>L
z(6}?IL_qV4xU8)5KA?M(5wU_%xJm}A7`_m`%)%+6-{2V91h6(nD!Bs>z0_2c-tfn=
z`bIM*NXquAarv(*<an!_&v5N$FT>R6weHi~5q*@QDEWSunzv?oj^aJKX10HnmqI<z
z;l@YBhZiLBE3=onjWrMUPg+HgjOb+vC{nw}&-c^QTCc8{<Oa_u>4hN?eTfd?LD%;J
z)j~7c?fzfT#4R^fz7W%Np5V*!G<YvDR;OT6nf~+$1BQ<bCr4qJ^(nepALJi3b$4;(
z?HJxb>Pl5jqOD#O+-Os&I?2o9p`<>MT*+Hi%!g~tGZgry9cppC-?k8yQjfUmk$qLa
zY*1|tft;@VYEc=4HiT{`_^Gw(l8h9z+>Kd=CR|6uIEaH*w-jxz3E@LHVGA>#Az%W&
zeX*Y&f$j)hh?kES6O#IW9BhpN=nk=RqiQGIxL-<~SA`&*k#G!lEDH^7g~Mg>4F%tb
z;}V0>@FIRGBo%gO*5n~G<}zGY#$Z948+_KO&wx>DV$1u&QTIE0Zw_d{D}fMDQA=%;
zTf=eB>xK*>x1dZ^I4YjZgC3nDJdd%E8iq%XylVnY<tIJONkU}6_e8U9P)_vw%z@b5
zp<R5k`19?)kkDCQc76%nBp0IOJvUcwlvg1wo8Mjdv6O2fQae(w%F3sh(s|Yi38yyF
zyLBx21F`dPBa))~alyfHcS~3He#3ZWtRaXn5-t65De0mtvGkHsx5CDb`F(0op~*S9
zS-U~7eAguCocg(%H+M(0PclX*y<NfJ%5XFi6{9ShOu~VF+Fl?KNUbKrfPY3$<rUlP
zDvxxaYEa`f0mlV%d#h;u;glp0Czm~J7qe<Au?td)n3cYj&-EVw4*Idr0^9u&p>h6~
zDy>EDXtR>2*Jz1tqsYQB*oaAaimz^!+Glfkc`@y>!#0&R6}>K9>~Gp0;qbbBZ#L?q
zVv1!#`ks>+6i#m&5_6te-coW$I*f||%>J+VXTU<!1121Mp2YA>I3fK~^@=lGjj!-%
z`)saD$)7C5C*~~d@J1x_wa2}G3fD3_hz@3L3k5|jkTDE*uegWv;A1mcv45SEOV397
z))W=jBx@uoU?`HV_jIuo#*lD#m9+lO@1?|lc=F0D_J57=kS$Lrs||~9X1tBO57=gE
z1d$laY{k<dBLiErqf+qIw4{i{cm17XCiZNzgZAISHokEklu$kUWzRTX)Rz^j?8ouV
z4FzKqVn^lhpM6h`Op;(!7Dt9^2^eMnUD3Ku83DQ^NNc-n?l@VcxO~U3wQ5lz*d2-d
zuR3W9@-q;*Me@aQZfd(O%ExV^{;fLkP-rXXO)|yVzz}8M|JZRj4jUKsQzY$^`u*x*
zv0DwuNayQwn@8CT9Y6n^5aeTN<`!|c&mS9|d?q!W0sqRnTuP#gV7TVxWJ(8!XjGc-
z!Hy`1+{4QlB1Sc4q<!-6JZ4GZ99z}~2>+SghpR980=S-@6OHrv1vX#=l5ddstrfz!
z8LvOa_7KP4L_Q2!MVFH=l97l=!^}lh48;J+7VQ(Tk4b=hNex0hT;H-|=}G9UjX{|N
z%hv^R69i7J_mnek7{*-^W!@p0A#Q%=_X!@6g&u*rDa>G?GkgpVTo1#u&kB365)*xF
zI`XvrnxxKfoVGb7^KJ^w150_TGd_x%#^clUhr{Vh*jOm2(Rnku6&_KScE}k4J1Xi=
ziv2xaR^D5pZvKWdoN%;1a+|K?!qbsTCnirQ-HHc>T`>v><L+oH-rqq`9pZGbPi7re
zc`j|aR7ELTdT4=!=<4u;T4R^VpPv?2c5qXp^_Q-8k%yPq${*VdmTqrb#ggaPiRiRg
z<#f@$(RBxT!m8AD>plTmKCz9KNU)@GWFt8*<dZ=_;w*^e%eHzxRKgz@h7!I(Q?8hs
zS^)cZC7F~Dys8QrAGC0Q<XoYMtmNPE^qoWnT&Qu6jg2<NIJQxhs#VzCh0uQEXWg;m
zMI@y;Unv&0r8tuJ6JsMeurPknB^@5*kw!5naz-kO3-9?}1gQ`!Mcnc-d#};#?G_vH
z+0*el*1ilv$tSq78CPko?T8w_DAZcL$s>N=<%NsM1JF+v1C)wUtFYSJ`(iq0a~?ZQ
z3EdZ_xNpmT-=PT>FKX3}rH}7?9Ng1#VQMM9R&_g~4z~{~#tE&Kl#e7T!VL#7CKxNN
zUJA%s)?;zGUfMLl3J?axrSXQH&0yfpdj(zl4Crn#u>EU{W#lC1m&13^qV={Zl7DQm
zK$3Gv9I@9w)&^&AQc;A?F%*<zv$NoOih!&<YTfB$U?S^idZqtl(mD!yCsgv#*kWoe
z<Cgd{XlV_np4Q|eWnHH&zee6Bs}6zz+2TPsk{VUn@RI=S7B0wTMOc+V{8;*ki)Ru>
z%27P!<e@573rVz!TsFd~-WwF5oqxZ=d4)Cd!d4*O<4o(3ZBySJ*a9OSy%xOva<ONk
zLH`*%iRb8}dUl}V3_v)F$5dR-;%5n^uH9TQsU_F-BjB^^U4Zb84)>Rp>ppl&?FAb-
z`DhXPO6Zn9Q(Xpk^LEN(T(p@<-`DU}={4_wXB1sPYuQii4s}1EfdykWi4sg5^1p1Y
zfQa@D917*5K3T-8ddv!X=YI9@n4>9g%r;8Qmebv;Rhthkq*pjT)l@9G8dH!#rlHe)
zNd6#p%bwYT>~Y_W(LCVKKVxwc`eG@#!?m!<i~aVFBeR%`S`vpaxpG|6;fM4+(w)&8
zO_+ql{-_1nEwH>Q#+CxBU`}g4#C<}_6UGzW0Lt2ZK$cw%{xSB|S-9YB<fTQIs1NhC
zOlxM%!m8fB7p}Pfa`v(;rLy$cZxe`riMxD-r1aq<c>>UCwN)RVfqcT}AbUwfO~;!9
z5!IXW!u>8fdRf%4!w^DFv5!^Ze442s^IS?U6Z7msU}+twHBFG#2RK38I?eJoNMRP<
zX<LPkx{dWhi$!g*(Ff$>cL~_CTdxWzsjWO-aO_Evc}|;NtS!jX5B}*TY^1h^F|D8-
zL<EeV45?5+-i<8Jb%W$}{-1iNB<Y&`krAYu6kaHJWwf*Y+mu=w_^Uf0x`X*k51mB2
zc=ism?^{pq83~(h*M*!;*2FmJU*8kcE|J5Q5O$s~EaTm<@3rQ1;}{X9MdGl6kG=?d
z8QA<|Q$=@O<e$s8y`Q`9?#;y9>~!v308-C4CoTiiX)Rm&_1`~r>b09_rnC-uTS!aC
z${eL^#`9*L#+H<EdbWJ|-P_$Pbn^w$_m_LLH60U%vGg!Ep?agkzLA~zGBEz$4o(-?
z+Aqo&N7Axn1X-ofT)rKBpss%NF_dJa{9gNYa&M+|1gS7OgB+25aX}<gv{D66g5iof
z+n>uzd0y#rkRdf#JhP&ZKFN(uB&RIB<OqOy?5C+6WWW#&JtlQd^5Xo}1N?_ar{WmZ
zkLs)78K>oUf4(qoyz8A%A1LcLc)Jb4X1H_zV+cDr)@N+bL|=5%L5?z$o_Bi#$WE^T
zG(F74EpDIcxh~c{?UO<oX5gN0JMPko{)v$)`{zbzK47xUo-e()-f#P{PHEu>u*-%_
zvi3jMq<)f?UdHlr-biKZI3QpGp8rfKSCTEm*j<=O&qY<WOGq#F7N**PRur_xkl+em
zQh$pa2Gtt1=O(LA@u<UE3o=5myi3g66!pNuS0u2BM?8_}svW2$N+9xTi*Ea^Q)YC?
z&p)B+EOi9r!}A1MjxA_+wC%8UdHR@~*Cbg@5DRUp^VC_aykq~;j{W1Y-w=1(h7dIs
z_8=cmQoH=P?gyWO$)jE~t`)F7mgbh)CXRV5<FDVbnt~-nrtOs*eF^tZVQPHO&b+<<
z8xjpcoc6Ae%U)k>yfq@W>K4jLB%Yty{UH&68GP%(^H*p>9~YCT6LeRs_a%uxBo>nY
zJV?$^8&$vVv}fM;HP8C$Nej9%L<tBsa<I$Vwq7z;d`Lb`ascy6X*a1jlho!ZB!f#N
z(wCAEb_{_NJ+3i-KI<(%f|c#uu~Ylc;q4B_m%B~nbwpUG&<CI2F%jdPYN+HLgf{UV
zEYHx0VoUAtB(EdtIOBU65*)Gg)A=3EYi!+|cc$HtBgTZtu&#IkBfA*UPnDFXE+nFL
z8%|p{>LtrPp>VSp$wuRzHFIk;9kz!;_sc&*1$Tt%QE}T?+M5+R{Lh$+3XPj<!G7Hl
zgkC17OYcMz+vQD#{cnUz+!ni#v7kN8`Yz1$cRpb*E$6FiQ8&r?y54lg$>ZXoM^XUb
zjgC)m*!_<4`Wl^_IWiyY-`_-Cq*9MP?CbgECjBiJR%U!#<WYC1ot%Qq6O?d*ETb^I
zHDPKKE!n_id|zn|xuo|R-q(dz;}ul<fcQ(nW5zICzMCvd#F-HQhn$B;W~+ieG1plj
zJlB+H6`6as5ipXx<_LUj>bLe}EVe<Z5zG7avnJAn9nSlk?`uq<u}Fo%K~hJF^9fGx
z?>E4c<S%)4!Z~7{l&UM|`Ku&%K43HBxNfwSMg}Wgko}j=ljIN1&W_k9uL>r8RDwwX
z;kxV9<ov%mPUQjFfCKsRlTe}1GdHH&N7-@bVie17p7s<d^)R-4*O3LZ?5I^hqde#w
zZuI-HM~FvkbAVf?S3#&<q^6w&&3_VmHr-^guclRboBrV}&ek`d7qRci)6U?qU(HUs
z?gsuXSyc>aqeO`#mp{Q%<6(*i<gP1NeD15c^ewfT?$>5%KSxH8T|G0h?A`W5g?AU|
zhSWnBHD;u#Kk+*>|Lb4U4gqkhf_vNp8r5PzMJE*z`W=}KW3Ru&PF8(fiYKIW7&m<9
z#lM##9w>CFJ>)%T?B6U`hioEoOsBog4f%nY-Jx&MxcM*0#{eN-L1~%OWFx4ZEGWc}
z4P_w2DedYgREA8)8@*geSfed0^oJmUewKO0$0PLb<x?<xVXam^cN|$L0=?gfhgNfb
zPvai#{!U1b@7x7iX)r>i`eH_uhVhIP!S84us8O+VweLsW3*shcAkZVuzLPgT*IE8k
zzO*%~7Jc<Wf17|0LX)ZxQF`gLy@L($bZ^)Maq)baR$`5i9u$9WY!IXNG(+N59Ux-u
z-NW@#yi^TB2h2u)BF*txL2dTt5l`3gSPvNcKxf^8A}YHjcFul2CjPWfIfJ(tc=baX
zh|L_Be4?&&^9|BNVj0BIj1USZm8@}(DXo@;86a=o6=}SB+EadX%IAP(s<ZIW(7md*
zQ;#mgGBN1nk_5Xm<tfxq`~C>^lZE!0=Ei2<C7S9Yy&hH8WL_}fXNg$PZt(b50X>1~
zMB*esO~3Q)7H)Y$1oQjogYUNX+`q~B09$d*$ri&lrQguQ!&C&Y>^fBRYq%Zq;i!tE
zmEo%VdrUN2|Dga+xo+xid<0T~UW^D|+k8N6PX;-&gAxecIG0MmL`x&-DhG-dli-Ns
z*$VqEIN*=*XO|q@l7YrTpRBBLKLv<BCgJ4@yUX<HzKqEAooHS0J3&az5=vz?;W*tz
z^T1nrI~=?QLyr|H$Ga$=U9Iu#2&?hOMVhB|sZTYotWiPp(zH#M_U8LU20~IWL~3LD
zB|i~E!N((Jb-Sa}#-qa-$vm)0{34|_El@HCLPtF5SQW3K*j~LKjPhVN+bw^7tnCah
z7Bfg)Da&?*oP(N*2()J<lJ}p~?i}hlTyAaQx!N6d`n_hqO8j0enu^u_1DHw*h@Y0!
zRpMk8&`Z)Fa*ON-4m6Qs#Ps-ATi`1HFKddDV$&lhD4im2#bC@$q#d;;*JQ53)B$Z+
z)Yx)v1{Dnuc~MfZsATP!dF>B*k!mMy@nho;IU%3D*nt@)*hV-?dM^eopD_~r_Fwi=
z&V60tYe+2E%?;FLq<o01Wk+2q@#BTz%u&C}T?wq}sVP1}x(GJ2TxhE;zj#ve;meTL
za%ORP^CRm<XROy(>T#?31Ls;{X({PDitM3fyrxL!nNC+b5Y|wyxO&)avvZdS|Fuv3
zBb1xAEh8=J!2D};S=UTX7>?m7NJ=<UQ9{cT??|w@0aAZ9esm(K;71uk(A2@hOi}jX
zG6=1&{wibzpj;5?7V~}P2T7(cGp8JXdqNX{o2cW;l@o99u<C@i6Fuxt@+Br89=_eU
z%kge`kSo|z-En#-7(>==BIg=)DqEwvTIo?xtdM@B;R$72HR&4^@CnwHkYy8?wR9mn
zn7EosPrao=?7^{f+Tz6*lk&!q5;RGJDFKC4wk7HXa+4GAZ%*qitxtUdONZ)a)KmC{
zeh#KEiI0U<bJdOHM(V<Gi^ZG){foA$JJvalY9KU!wcl&Mxdd6%vK{N7BOp~j-)-iZ
zg)m0q1H-<^U&Ni|SYTC0Lwkk!-m06N&TPb9O>z^V-)a4U6OQ~~tcg?z!1}w35V>i@
z^eQ>8;<$OqP%c_&480@cHcmA(466SVn-1JYSw+?-?`FnLUf(aw5YTY^{2_=@h$l%B
z#Ok3?g^tuski-xxVq-Q4vNhDC{~<th>bLrJL;csE?f-A%#;cn95J{I!EB5Y%UQ%FQ
z!skNXu_r<?v1=UqaOZCWtpc7eMYFHA))*`kN~8xC%%n!sLeEdjQy77PT-{w!C!yX@
zuz5^!I27*AmLL)6wjWvwT%db;3uEu`b@uluA?*4j$c$nzb{D7ZDgoN<^q9cj6BrGS
z;R<?Z-rYe4RQQC`UF-VA=?Brr-1v3{<!QdWKb$l4Wfw==KlNe6F@e^gdtJaQBR>Qs
zyGm5Ozw-WivG>m;Fmj?|J(x~>q^qIThXK(fd__yJhEcxZ1dl{%^Ty&Ei2qXZ8THIL
zDl8_&Udc0%m1XN(KW*HRysfbF)`?&KdX5?hGwhwBAEMETO-&z3#4tWi%a#-{eLSuJ
zH`sCQ#mg7>{h7ae8aS%1RFHNB9#Yp-wKxs<VY|H^cIgDTBf&g~m+#SO`6{+bG+1w(
zUpH$Ul`nsZrye4%nYXX$1-zV=mAix&?le;R7~k3=0@a1w(>CawC*YaO)qsq@#a%yK
zn~mPdqFK=n#u1b|(e>VpGEI)bRnF-PK(U#B!5Z8lDtw<{eVlrHg*>0Hr#wmS-B@4b
zLymX-7?XH5P-uQ=3cP?T5v{7pE(tKD@|9I57kjg$hN!z*ao)O^cum{Y&FiliO#ip|
zhlmXeLY9<kg;U1LxmkKlJ@zu1gh`bvlW9kE96U(~sJ*s0+Cl2}xm&npL~K#eWSBjj
zU4*}mxjm7`b4ITJD0m5m<9O2-c1*2vXZq&6BPJF((A(KTMfq;5M^BaB+w*s9z!ZSD
zE2l$)&V;N%u~!7T>>LPpIK(lozwMCUi)Sz&wrne4zI24q>eouSi*LoP$CTFC;m3r(
z;iUZE(n$zom>u#f*}Y-N2@nf;+lQnuYW#oKmw838Tl$*X>c&yx!eP3m>FMVRIv*q%
z9w|GQfaQcqTx}Fz0h!B#g8kjMcqee|In}IK!GT$?!)v(6MNw!GS{CI7^><z!#7LRb
z>lgwPNUcvj=+k`ET6J7s?Hc7^ra+hf<u-AxKTa&B84XT<XBvV<NqPQAw~w2emj3P}
z9%M36ef{5|73ME@I_$vUI9=(Yb1mA4-?@vQ8PRAoprm=(sEZa8@}BfuTU#Nut5D^A
zxK2v_cRkaJ>0^hwZl}1y)2p5W`}LiA$lPW<TNFJRo?pu0MO%B{-+SqqMN?#Z<t!R2
zC>-C@oJxu3k&oX78kFB`+~?fD_1d~%_$kcprKg=o9E_l3+>rVSp~Q=Jg*;o{?2*)e
z-Ippw8)f~L@E=OU8|dbLC{bkpKVCLSsEdZ4LU%IRM`hBnc<gn7>VIeje-Kjh#o{JB
z@Nx#8KpYvWK`txP(q^RCp2Ww+nEj8UvyN)=Z{zUjA+^B|X-1>cA>AS&Z2?L*(x5PM
zG^0xz0Z~DeM!I3dq$Q;pq0%D<jP2dK!#_KRb2vMPXV3S!KlkUlM0v~}34+H0B=`w>
zKECWJWD#ogv)uqr@c1ZFmGvt$y2?G?jZ^@t=1)t^|F%{P&RW4FR+6m(8K+I1(ZBng
z*Usimg@NRp+=9C6*1BSMi6BSlJ_d&-7AgJ#xm<tKbk&WRw@^!$eCoP{@`?;DSjtPK
z<-LZlwdA(y+b)|l$1wlsP!!_2jgKM7DOhXGqx0O2?-93f#oM{h*z^jM=-A$&cE&Sq
ztJ%|!#y2v{2&kfzB;Y$M(fWO?JID4WCwhVn2-^m98dtRC8hkOX7Lb4au*tv_IWFZU
zW4ZQTKBeJncK3F6nb{%pE@^82hp4Bq`!}_8HC8M}f|zuf{-s<$?F7GKLF`(G&d;qe
z9G}tMe*-O;R1n`?{b)g{_D7&CtlW0#Q;<k(v7v>r5%3QurKkQjA`Cp(;u8I+BBLNr
zL$Qsk-b##_Tliy7H`rS-o+;;#{habCPN3}zoh*HWiR2iitq-v$pMGu;FP~;1c&GS%
zJq#YB5Sp}o$X6Ue+ah(8pty^=Wf)i&p1ai`rwAX0uALWNGS-?Se)lP9{!nnWBP@=%
z_(Y|kl(bYp$KknVH-6_pd#La+R*7eZK}mT**^kof_jls!iF+!N^tCUtnYh0*VR!>O
z7TqO8BS^_8KAQhubg7)`{ZC)K`zqM?06`heqZt_#(RalIz1y17y2)}mvY|Kd-H<ej
z&CNaLCfl{b?Bm8>g_E6_L*~p7HO5JsHT%6~@8i{?kLh$qI3omsG*hMED|HtUsIb8X
zMsw>Z-gl>V;kzXI-p~-hYFMM&cj3+Fxqfi*&iq}pR`}0BD)`{X8|xW@VuFQmmQn%D
zu|yLG;e}Pq^njK<M5EHa%<?B>>;{4)#Q>uCBlTxhA#X|FD*vL=&bmec0Lg%dBTByD
zy&j3yn|0^SS{D8iQ`MXPa3WTKTSOdySQ;=d?w3-+O3ZZA!~eE~TBp7vOBIT^qvpaJ
z&@xZi0^s`jDD7q4n`dToide@>pQSBkrYkj`?dlHlz5?DfmxDM6NT5_;3{Pg}^Gl!F
z!_6`*D|UC1<;@*vh$i%B5#!&;$*Ur9a?hc@DaL<1q^p96eD_~y-yxHV0#6W{^*D#{
zq+rJJ76u1Dn8Kjue;#iLSUE62cX<iAm}LU9R)bmRYNpQ<phK2206_#_8sFGMaQIK*
ztbi-;0c1!Ekz0@Y!!}*FTtM(XsZ8eQO#hmyuUs_6Ee+0XTz8pMZ(N1P6MM|=Ttc5x
zH~mmbe9WvF-1GQ*@6Z1L%s?5Xk7nGFcAtBA45|Q=0dm;20gE1nAuUq?5x{dStov)Y
z26fbbbi^Qyr_<^p+C=M&XG9feTdtqS2dW;?Jn1HfoR3r`O|cOauh4X|W?Ao89v)tV
zC!e}RBc|Zwz>YG-5zDNT>ajb=m%KWq-*jNDoeT<@+d0wnLe7^*OIXKuJ;;+w1$xof
zj~^Fm$-=`awdzO>PQ8gcZ$+HK&A3VFB5=&_#qa({>u5~st*0G+49aXj^4A&cRa!Ah
z1L`vO(SF}@?CfzN<NWu3IG!${A<~k3>PEa4Py<A#si`&O;Bx8r@iGzIIbhPG65(H#
zn2f#$U#T`=?=3M&wXyD?Az!TveB*YCOf!#zQLjZ%``C9#{mYz;MURj+4@oP+COR~)
zf*-{b=#pY83Qj-}ddizC*KmdpM~R!}uAG?*xk;q|5zuRZ|G(ZnPLk$P24-pqxE)+x
zZ8oo5>%IuoFjgJx1IW|artW<nZWKE|xbuVV+r&`4q{rPqulwSY!)Fv9s_~kTZQctf
zB~{}AL_7rWQ37&H2>-omfGr{)K%p8FGvzRmU#%6_|Nn?Y|Dtkejccs)57pH9prPiy
zRQHSS#KrS&xU!c^(E3I10U%h7&f|b{zR4u3-ym>Pq;))4eXnQ@9nLwu6dYD}5V5Ch
zqg+Bhq3HbKZ}MuQ=LAy#9|3{ZSwhitvAVR#+1(TzHg%BdLTA2rqo!PA7DT|M|7qNd
z*rR9yDEnbjT`q>22xzp6+m8e)nz9e!mq_}Luh|cCWTXF{Ut3XOj9iEguCV}s&VqVA
zpu*S7dtcMBhrZ2fqRfurOFr!Tx%S@6yiY}Iu|durAdu8((H-=j+Pem1K<BxPgv;tQ
zGC=tvtfQpN=93xyvGhH92{{-(-ik*MXpVqRPEHdVFO%7jcAlw|J_uSBPbi21ae~pU
ze2KnY*ag)(taXagS$rkLQw%I-bB%JE&WiyPswMj&FK6h5+l326e;<FQmlV>Y>X3hq
zw_Y+n<l--;+_nDG&QVi(^R@88DS0a0Cgz~)SwXQw>%~y7zD+i`@v(KdGDK-`LG^pF
zFIM0tVtM(3yBoM|vY2MeE`@zF^4Qn%s9$^y69ih{E~51BHtf?Ymv46?yK@FH77vZa
zt^KxEwN_7Ndx)}$?Uc0ddf+Nm{cgOQzwGPn;ARQtE4*4^@&~*wQwl9c*Zihm6>eQH
zvI_39<`9u!7bsi9-erbWKe#Ed#UyEJD~2<}0@4D=ihvyo4Y8<ob*4BAjfWA!)xRyf
zmj%3a>=zAunwo>r;0qg?*!-SWF9V0Iyo}At02;5W-&uy!zsdP&3!O0<r)%xi3!t{_
zB{1pTB>TwIvL~}l(~WQL%xx))`Rrj7S&Hd(VL1hggI^<?H#<Cqc17}1Q4cQ1I+5}5
zD%;VdgTAliD{Ix)qev|pf(%+xM>z5?p71<)N4ifXCPk+=(w_m1f#;`fkD(;{nGdDD
z9p@$X_VBv>QrQBoLi&TQbApMVw}lCSYhk2%-_~BV|9dO)4^PJFo~pw!Q+6l(Vmg(j
zA`$?%N>+&J1S<v~sXpS2apXVM141eAG|OH|?Y{K2{OjDV(D&?t^bq35P+r#$d?DE3
z-Wpr{Ey<y$G>}$+<NScUbeKfk#ddluuKw4Ljy+Z&sorc?rnRZ-(B|dRpeFDNy6j<A
zJYwXcx@usg%Kx(E5d%0mT6O@lC-MprqApQTSZM0Xjf5dARL@9o?s9WcW5aRvh#@aS
z<o+6pKXP185%oR#Pvre|j3aMa5dd6p*j|GrQ27&3*!n@XjlOCRe6MZX73Qzke09rz
zA#vS`J3F!iU$ec>Gz75pj$bt=#rp^pefv#;b7I(0e!_=ZlOG<Tw&XoQrzE$6tp_E<
zQSC4=WLt^UChG^2*89Y|(vIShY4w`j$2&0CVDHfdIYT4N1<;3od2~SXeo^^qZaw2)
zYY2PW_kZc)gF#7eHM5#eCZB40_%L%Feof4MPN-UCCT?&t2AsQ=?8~UpE0u_DV!2<J
z7ZKM869rd&_bSVWcGw=ia7|i%ZdXXSUmtSmwy{J4P__`!dmv@u+JwpNS8(c_-$VzB
zaua{%nf{5|IbI6tG%4d?se@UJbS1OvihJ!v7_1S4OvtK$V76z!{R3-oQg8!Hal80V
zhh}5_Gfnm96e<n#ZFj$#zftE!-gfnFyqC}x;dc`@RPqO6C&-NegH&kF@WmZT0Q(hG
z`S`si*wg^$sW3%7#jKri6u7+Lsq^s5)x8G<I=~(K7Cg={?1A-p1Tlu>_okBcw9<q0
zg$2j<(-xS(ne`jGE|r75;e7oLURlP<C^EJ78KOy|iNhDw`rfc`%#zxFL2=S{1DhVD
zz(DoL(AW2BVXM-##Ej9z+A_x(m<`hn&bTnChox^=OWPe^Krr}ZNyW27p>E!(>7UaD
zWz9(8d`wz&8u~K>zIaX$F{752B%N`pWI|#EV6&xp5bpK$mtMF(*g~upC-pV_U@%9E
zl5}8*Ge4{#X7`<h%1d0p;%R9Ng7Tn-fh*vst4>vTry(Dq5hOHNx5_uaBxl5gBRsle
z^^s6Tmc+ohx(9fXUBwdT4*Qip=6!AzpgqbdH*HVD7;E_5ab1QQ%@WulcA2ybYT73z
zJEo|Ysa4oduDtv`L&S-rKCH;ge7^qcXvGzsXQa9ba~Jdo&x&;seEq0vKRYL}bh9t2
z+EVGLluduH>nvx831%H9=-=xAX9(eU4Cc=3zx8=eKb+G=R`^4HCa&&D5Q#`Jq)Lig
zN?c6#jPhHN7YGu}50m-E?i)NC=6<MHnOmI6R0EQvAtN<N^Psz+_%0oAjO&*O7^$}C
zt6RJ6v8>t<&4E4StMGXU7E}TUx>W1<a4UQE(leQ*@LH^tb#$_L=N3e(lD2o3NVE*0
z#AgVbDb!wX-A946k%<`I)d@U2|8Ix3;ymM~7H<P++aA6q8utJq0Gmg=-d?0ClKgx!
zd2<6+l5NZ>(MSli;yDvy68gxBx{^s7YTKS`iIDWM3VoAq(8MVy%~&g}s*2Ed)@9Le
zgEZ!uo%)QP+BqO-5u*#}Ywt>z>QY<I-ta+-8RI*L;S*|VjbWp_nbbRUVLVdu33Ewl
zaj!GEL3drCp}ATIkkEqRe&p}-nW+pta5ay@&m19+fU$RAQi<VjvD%OP4n3M){-^m8
zcv=EnbiHOSmK|H&LONin#SJ4#X|e{hdH!osPKpq2nf?rQ#>uM^TXfU^439Gvp>d}w
z983C4K4dyXe@FID5!Elv7g+staF9OBAg$DW(1<NHNYkF1+KP)`z~`Ih5lYgB0iH@s
zfw_1`=*0LWc+<8@X-Tl4E?!Jf`tWt(Kwmhsm(6nuHh-Oi1X?Pm5`8?W7eeHXL8+gk
zFq|#yC;q%gx7M3E65t$~4$}Ff!A;#}u_7QSo^{d<*P!@GmYMMxy^1dN<CkIjYsViH
zaz`CN$%Cyy*;LWqTnB)zo~+2qK7|LsA`&5zI)Ufw3J>jYr8ZGNdr;<yQ*ygN4l1sV
z`v@5%DsKoCgq_IJ;?d=XWh->PTdDgug9l>#*LMcI90S0VgQE-C0mi7@@jB9RQn5`g
zO%4mlrKO?Cu^L?d72Q=$Jr_Mb-$~(kT}Ivjl7B_lEH3-Hs6$g<y~WR(YLp5^S)CCg
zqomc<{~h)pl!a!hz;%rX#dF#(byvN*Hn%vjgX3z-M&Kay;_;e$%h>y*<{3qOh?Ln`
zHYG)zUbyaxu)<g0^W5C~{Xxe>2W^acB7<>6gX3P~eSLwD!$Qn3$L8A!BAkNL#f`UG
z7-?yovr56#yF!wBSd+F6dAq)-fCBR%%HB5Vxu$;Q&#{iAd>;2SBv^zxV@9h^7FqVj
zI-{NH%Wh5|XPb3Ky^{xua6K?8Y0f)dxoYga>Y(3skzv*yK8lC=pZo!{RfYRI*w%j|
zepppc&cu-{2+djzSW?dNT&Hu+|C5qU<Wxw~B$ix+akqk`#RY%Q4)$kJ*-z7wr@!o#
za_LC84xJxNRYDHTy2Vz$?{L;ZcuzkKrA&Xz;-I&O)iPw5P7Hy@!=t@r_e)gHs+SzR
zvcN1UapxdDUIPEIAw1O^(wQYk8$-xI_xjh<Q)d1UO|4<I2$js@WjsdvD<71WDsH_4
z=)|Y7@*4hTj^guQNPKh>T~GG9#(eKc@Fl_4+Aq3!pMl+ZgwQ-DvJ}y@7_IJ|A&{GO
zB7N)pybF&j)<>AZ#XwYu8=tox_YzkTn=_LU@ykD*Extt1h2%<)?_W%ij&EQ5z3b24
zDe}1h=sh^0c>SGpl~soPd}}O1>`oy?T+L{V8~OttRuwS*QHVyI@>K$l8!={rEqWik
z(Jrh0Jby*CUhS?|z}L{<YiGeJn}|XEa)d#9_<d)SrTyargLQ4pks76bh>qexh_5V-
ztD<?XIP-3UZ}OW;y4U2JGaB3visP^9sMD-?MERS{?X?u{S!mf~wOs5O2~8WeST_b~
zog9y;GP7ht9^h;L8%r29c6@X3<V6`|7sIy^tl6Zga4h#AG3BBdUo~$?(d{tI`{7>k
z8GZy9#tUIlOdaP@lqKwHU^Jv3Bc0R!Nsp$x%(qC!zu{UrtNZj3*U@mLeYwHWNUI*H
z=#25D1#&=M2>t0v3e-{cti=ifbLG?G+N?*IS6;-QQH<;*o($&6TBMgk(2z{FM6@hN
z1$OCK_n<R1wfAVHS1pffHWfjyG}b~9W{6Yj64PI18$p)ssqmaCsepU5yWS5DKEe)i
zCjXAUUvlZS>EU6_^zI^FqE)#1hw;8{jM-I6Q*Chg-al_Joi`(+9Bu0S(9}EX^$vX=
z8>gR~tZZXukj|pu?jf5r=wgY0g4KQ>w6>M*kWAf7=i${7fPvj>tk~wmx*&v<J|_N!
z8B>};VonZGZXr?fbsgl(YYI_nDUrr^S5G<H2;l5_OGiRy2xQG#V#iB~a04F4T0K$E
zo5nGqO8|;bo<Boq1n`OWaV4*zd3b*n1W>z8(q%@w>WA)d0z8any1aXp3R%B^E+mQF
z^fKeB`MUiHsf7;{5(tlYh_tnDP(|Q$H{uE>nCRjC^UT^FJL(S=Zg4yd>la$Y(*J7s
z92u|3k1+e9S91OncCuiIaOhHR^{h`JHUs_e!1OL;&~Kh;=b)Sk>@zLE+@**YVMNj~
zjifdKP}h;@Rnkw!WlvQmW)eljC{NxYDDvTSC<SK>`CVxGvHf^b<tmhO1RYrPr(I}X
zVu=0c%lC4PH?hREqbV&(Q=B}Y2q*73d>|{od_=Kr+KcHUudcifZRu|KY@ZUxar7uI
zeR1ge{cY;DCy=<5oBi#AdgDT8#(pU#SC3YN-F^)k*9zaZC)7}9S5VwQ!lSSYyhz8=
z4*`?myU*vPi-)Z9K+J1)ZdaAt-y6EWD>|T<XZ+IHD8cS<Ua)wKc}n{Dy#4kBpw$_z
zNtIi9T`@6M2$(xTvllh2W#31Pn-afFkiNA=Xs`#nnXCNSn%LP+CcKe4@>G=jIc)uI
ze(3b|p@o13ny}5MX^}e28vtW@Q#R~WE4y=R^>+nKt*&G<GP#=<a~QSV(FG;%hGb73
z6?|6tN#D=`p|<gz6_5}&|B@W<K(ma<dh<a)i)n(Zi|fHRhZ5_WBoy}@;=IXwr+?Dy
zl%m32!^-a5i-#A~6VX5ZhK>TZZye@kWGPTd*ZzF^Q&;a%0_CEqb#L>UOizi{WVHn_
z`ZE139-eq?0Z$@p0y)Ht4^@AOA_|E-*r1s%ze`4=Hd&+Y|2*ADt@YtEXkI5}G=?C(
zRO)cDB}%#D-4p$nBRjNFy!`4*q?eetRL36VRE@U#CB=0K8~Ly6b|V(DM{l}kjA50^
z9&^ub1qoYGUa^ud7xw+B!|G!FNPCMpP|sX*o~5`qgTTOLR&FbQylsJ`RYk=_5jzWG
zH~__8?UgfR4k-x0)Ubn)^O?~<G76|&<6_ZZ?5gB9UPiEV9rG~jKYYp}D~|fW7P~~a
zzYVDm4c+<V+G6;(Tq1+%#PW?<1aZ5F-U#Wlcz6V}uP^P5f#+-aRxX6QZO?1_{9na*
zz6v0(7effHRiwZTk=V)~VlU{NxLrFUQjv9K<2k%jMcyi)<ADY%l(vbSIwk3tTilQC
zmVMuz$JFD=Rq&ViS?_GE&IL^`GRSiz7@c|!>GXbWqo|aBv6OR~%HoU}Yu&^jC-&6e
zn~4u5r<V9@*<F{7hr^Hi@9)Nlp>ez>>!SiywNg7c@{f5l(g#;4I|Z}3P%|P?DYOJg
zcB9_JRWfdRRs&r~oGk6|?q!tc@-=lc(I<St)#nMQ5uQon3N4*G_jEyKHHnxY4<bxA
zDZUbM+<aHPl#_*hhu|V=g&QYhPU?Oe_fTG-KLCCg1CNPn*yw<#f7yHE?)NO2QGB|`
zmQTLaqg3h!xOn#yx<IlPs*S(v{Nj}od6(g+!zBi<maA0jc&ZoQNA-ysL4j7%T<p<U
zd2xzfB}%RM;H2cCiX~3{HQr5&CNKFV#d!6AZ4(dlQcZR~de`@Xf8F5k?evQXA(L8i
zWvR-_m-HvW)S3=NbQzauqS4XwFAgJT;1~wt_jwrlzhhhsE+f6h>B5wET+Uy5l?Wf1
zMX*+1U=lZkeP0<NlXB<42n5R3B?*)1d&UZnZfjZHhvlCchG>rwgdw!XKuEZ9+Jnnk
z1gR`r($k-*B)9LOm{I(e?X$w6%irfe`HyzSh=DX;A6Ym)+{k+KqyQ>2s9w;D@nJGC
zy5hg}HTO(%^#P^u)Y-4Bo8VD=t`L;P2WDjg<c5}MB>ri24t5bIrbBf<v6k+lA@_FX
zKQ6jx7suZvbAnKTSFEhD|7b44Qz|EYaO!{noX*W59bu<SYdQR8%hLr|1AmPF(tTMG
z4GcYfYd_ZI1zhtzHI`WO8W_T`v%G;ej!+rC-gr!!s?&`pSrbFS#2^m6#bWMnWZqR9
zQcb#8Bh;5Xrx0u1)G&e5iB(xU{n`~`woh8dXXB?~pqYS(^b6I>l$o%rTf1s=2Z++0
zy5DI&IBPuMWtR@cJMxA7Ep9v&NR=|Lcev_+8~VGD@wFRr12FJhaE)V59XPp{3rc;I
zD$(+`@{YBdhfmSw`vuvN=&e;9JO1e+6+NyYLG(?s^D+6-O_&)#ANalp9z5F&eM;It
zh1sQgo656~J0PVIJ!D>exVmkA7!8aZcFrxfI#u#hxnq0x-4i)+_VT#Ul~Jv|>!TIC
zTOVI~9(}Ki0UnP;Y_Qm=zJ1nX^E)0Z*zavqnPKt`$2U7OC2?XC`YyN4F+zNxsg34n
z@Hw%RQB?C8mk7Y0ldblO)){Zxu2QoQ;~uEvAyuB#<T-iotmD;-H0z?pj2`p9l=P3b
zTXp@(sji2rVI1$IMQU$s4+UJ?1W{h@5R~?IYR2og*bc>3oMHiaZ1^OSxb-6?PHLhg
zYt#Eq>~l_a^EICmniozcf6ro(k>4_YPuPztzd2<O4zlCrE*w0Wq{K)WSi_hctNo%u
zvKL!GycpB5WyhxwO@~F6db`1;!Mcnuzb2g0SjbbBb~lqJy9NUCsKcXQSkqg@5mH3-
zl!BAh%wMdd^4DTLC-`(4R;v2YFVfj6v8sKNt-h~_Cg3k^v-Dwds9FpBAke6y%ld)D
z98v=B8u80K-|)`2*-S4_!SY<zaF{0^mV&QUJ&p}PaeW%gedD5j`v9R~#Zgp}Wz5%E
zjt`j%KfCSs{-LpR&Oj>n&Nmp#Jv2<X0J7$yDNnp#5ak>5fn|AvAxu4x?^?5Wk0iHL
zy9aH%nI%}bH`jH(epI>auJd%I`W?E@>R3YQ0f;(uRXq#iQ>#eIAr6^!9CYt(jVd|s
z!E*P!XR)?^uo{#%|I23qAAV#@1~3X#`LlHTT*BXBtJINCg7xUXYN*e-M;^|do1W?p
z32*vut1Ec49FQd)Z!nc$T7bNBo>Zq*^x1K$dNRvE_-`Fy>#}9fL1Np?d4JgKSw>@w
zo%nlA!H0r!i4rG#W@#xsCg0?o*N{Xr$U2@9o#jkLb((eVJ6_henQNP}p8wwdV76NR
z9q%BMve2Q_=7_6Bs+2cFBPTmQ-G2e?XGKt*^n(BBUACFVgNH<e`VdPxWr4Oi4cswK
zpSi>s8D`@Hz3c>sfxaA2MLDo+vKOj(3@<8<2*23hdR2AUBRrz@K?zp(Oxt62b?{)B
z!ZKe?q*+^*uJ%>+k`j5#?3duRX!%B|*$*!j6!!O>#99fE_!s^A7fi4A+qXBhVA1Zx
z<X7JG%4+h@FOf%AlMK!^Sb&uDt!!`(Yo_}Am98pR|4n!^p;7)s;n&xwtF=BJEU2mV
z6R+A@^513H5On|R@slSp24ieKjS#%Ar?IGvfIi6e94&FeFnDVv$7TMBcmsMr)fCaI
zIZ!?y&HVIL>D_artLv9q<xC^q`T%?qMlT8hFxBNDIeN-I|F$MqGCQ@K6EevCvL(bP
z<hy){faF!zBCxQYWchx4QhyU?YPNtgLg<WKu=(TAxX?<*J>b&1YH4P{IvpZPZ}peV
z5p6dN7*tp<*6`N~(N0KzJqQ!pWyoZ7{Svvv5sK$P*i+Wulpnmor^G#^t!={ms`Vge
z`?F4nuFwP`DKdE3Q{WUbTxLo{X}j9~p*5<zX=SA|WW$t*iuW00n0(t8=|cqEbb(pB
z9mxRX#`NcJtN$I`0-~OGs*Y<-W063w0>mkDxkZJSs*hQV_e7hVVcby<k=Q0ATvwdZ
zny+tHL#OP79rclgXQuA)?XvEDsW%bL!4#)1xwhutsK~y2MN(ZD=h?34WyBZ0=L|2f
z;aJ7CG;(pzB6<DT{h5`XsxEdo_jt&dW#1?`a1-)sD;MLej#IM-Wi3J0Ft4F^lmA+)
z$4ega=_T`s5FI!WolzVZaW8U!`tV%qmn=iG6u04ogjQ=35`z)m5M_ziSdO~*Y_+C2
z5grJ8{x51-PM|CV4?H2P3d4ZUR#fcdR=KjO3JB$b&U?iRZ0{79w17Bi$8D7RX=~8t
zIu~oV^#ax_IW&ywKxM~h>{Kj2rcM1I$nB75WG}yX89F>|po)fS2l#26Yz#P;A4ly4
zY2#<F8lbq>+`f+(7{Pk7KZkZwu0@KYLniwlDJ$<6khxWZzi|+~Oy^z0s;f$cJYKLP
zzHFN6uDFtKby1jX?GQ6vmDiPCq~xZ)KcG#{XuzlUM&<GIDXdNhkJ=UBM8hSu&yR=W
zSD)RI)6rf*TeaB00rBHcZcDYBC~oS>&kSS}rfGp=X*W*+3oS20&`LUnQ~V=so3}@~
z{rfTbi+}QsN%%j2Qo6qn*~n24iDKwJ-jP$ck?MY~y7g(7<T#4*`SAF;dS3=!3&gt9
zC#EA88^e7WvDxDGOea5r>A&ofa8>H-nzb=<_TyLu5KzTphPpVKm~jZz3`r=u+Vk6E
z(%TGSXXgo4gAqjY5z~LTpgU4%418RXn^%fme5U=NH_>+j1Fw=d;6~jI<1K32zv9f<
zE->TNNgY9AQU?M%Mzt&8^oo4#fvF8>25tRK4E)Ja`o|@)d4`=Rp#g+V6AyhoTXtyP
z)8=YkDe2YsK~_cdav9qxo<c%k&-*@lA+wa^Y-R)<8j|i%$%%O4F*DKfwRAptP5X`u
zW$=;T-DMiQ?-6A~h$@)z=cR$b@=Jp%K|rVd*PN9gv_wm((p=lAy1FKI`l}{(_atvR
z3VjN-1<1#z9Dj)EiANg1z6_H5rM)dO`|bjY)SkSk)vk62o*xmb9LnMpX{wJIy!_q(
z$Ufox_3#~GOwq(7r=HJPxj;8PC!1+Y*gD!{I?nkU=Dx56Sn$2v2gxjDdgC<N)vEy9
ztx6uGZAt6#V#Wkr;2!^BZhKD{|3{)94PBBhZV^<5Hrh@bnI%=h`0<I3^krrlLF!7T
zOgHhn7ngY1q+htI+BaK#=Q*b&xZP1xgfNS8v|u}5GJTbW4NP!P89UVJ=jP85fr~jX
zJi>>)c8d5-Q3Li~$;8AvfZM7)-|(UtYh1421uaPus+rHb;gr~8rF*fP?{(5XJm4La
z_Uz*N6WyTe$+joRAs~pzVIJvtY)2$gJ`sig+4_wmUYwqWHX$#U;uDC^iR4u@NFq5?
zhO|Ri^z_sI-empd2iy>)yJ->MDuf>+mpk@cQ9*qvGO#&IsL6<v+2Bw0Z}vIWv;{7@
zN2)c)MdRJuvCmkjjVK18&i-ntBT=wp9@&C0m0NYZEhE!77nj1^8TojO$O(x6wF(Hk
zOuBT_HC)`I1TAz>Css01zLr+EMre{M{imhru!(o9@D-gI`-J<U)<8xhcIDs|(d)`;
zWUD!-CUWqwlwHW$Fe1LJP(_L)=UtxBikBm+9=hn-4lILnU+b~-FC_`9@Uy^%l(>Z^
z?`H1%5`A^A+6g|vYhla8=?j>0<v2*fCg{cuw0?K!la_1FuyqPFaWyd`g&)-v3#@!Q
z^4uiAw#t?@e><4r7{*8*HCt%MWAgC~E6%a)tLCh{!dfiR;wfN(%aAaad5#fd(4%SV
z5v5iMRiK}zv~!V1mwR9^JgJXf(wsI^pA5p$#eWo0nc>WHQM|Qyk?>T%|CQrPpkF-5
zi)Nq)qowruzzkP1`*@@!JQn-I!PLF#)Q9N8kcXk_KD`kjeX)jRqtlVGHo?aQS;^@K
zc=de}FAQ)9T2_$~lLpjyOZac#Vg}pQS-4c}H&pRhz(mzQTJ$RA?*ji<0gz+uCLc@W
zVxD*1c0VTwp~C$KVXL2)qu2Vj9gol@7;3A5Y@E}_{Gq96mGN)<t3`f{DG|{EczpO^
zsB0d6>rb*ty0^EK-=jaNEPAcYZb|YD9+nb!`oll}doOrt;162nq!tO*y}jaJp4oc!
zyuFzI_CpG6XSA1)%P>rTn~%K;7((g2p5vN%qK}M62{cex?t(@cdO3fs-HfQlruJd;
zx(S0W6mR_-{iES0ACwGE79RrN@aXT!`!ZOL!{7<yxoSeNNYaGB#LD{BKkn1ww&#65
zQ~ej_V=4-4o}-BIeUew76zRCHFZmu6iDTLH{t=xG6KR*1$f8L;gi!_L(v3fhz25B=
zDZ5%zL`1LQyT4I(<GYj>;Rx?ys8<{-VL4hAW%`P7=!*2G8hZzYSW`~dL$C0Aj$c#9
z3w3HZ^-KMv_)ndp1p2|j@66KPr|nr6WOMQ;GRQvs)W^0=ZcFVC${@gn;Do{HQr4s#
z$B~j3W!`dBKtqS%la<wtm8H$#;}npu3V&0aqjdA!qWF;2w%9Q7yu3%$r4%mxdV+3e
zNZ*(beaQZp&^9+}Hj?2H0~1DDOtH%GTNR*Qrp~}29|5_@Ij<A%f;f77QuzE{^$ab^
z?AO%8ViIXhSs}zDJp(c5!b-t2sPVsSACaa^Y$7uX4>Zf33tkbAh>MnGUiuPG_{Ldf
zW!O$tdOKx*|9$fY(Ma+^I-8rk?*OFQO}AF=5reR1M*SD(_%L3|K8C=St|t;7u-fod
z@CJ3Cua6S{0?*GeEgB5mD4{B%jD%%Ka4+dNODo)NOGvfDOf&EOdYO$1CMjDe7@_SX
zZzHhQC6+%o3A|cd8?JrJK?eppMQ%|Ba#^N0eK5vl2Pp!-eX7D-zvQ_rPT6W9;jr3U
zynC&Qj{BiHvbGLBGOF^a9*JDwUtlcH_nA=Q-9mGPsl<n?_61Ik42`<d+ke2SVINcl
zn0DXlgN4d>hhg%YwW)I*55bv`f8KnQ7kisBeYI*j10E$0pEvg4=<yY=VQT#cfb{Dp
zM;tOU^hz&#{tH^FtVTktKK1AvCUhp*Btg2Flqgug2tmBBQSFb~%yUiYUAaq57|fj`
zd{hJ;Fr%3Z4eV$bp3y(AQ!*O(lT%;|RO3C>qpc%umawGn^WqbZ!_SkNEVaKzw<@?O
zw@T*xqFFNy;ocEX_#?EmoSY?JcthRSSc1DzxnH1s;YU06@UOfjCig4N(JNw=Ud@f+
zkGqGu&YxZPhkuBqnT1mRiLZA%ou7znWNYul#qwL@+`saERbtR09}Bqun0Ts`3ODQw
zJ~`R&LlBU9ePQw&2$s5Jx<C*PgeKjHm++&?1XRO^5#2E5#F>WM&5A0x5M4{0{~6@+
zE)nN=)XlDbK!6sGJnU9FGjN!KH@gdt+sA|3Zhghgpc&M5(8OxEmVn?W1O5tz1Xt?v
zxK9~HBe0gQssnwPi`*yEi@~8hldZAccHFeT|JGzY3#j-=>78Zr_Hk@0Z}0&T#AfJk
zs8wi?Z24O#p}=E1qAc4BNtY%G$s>8HZ?xaOAVDqf{MwIc9;fx@5@N=ByGfjnxHDEK
z{!p;v3AjbpUI3Iy3Wmay#4QBybT}AI3&$(En9?f<@7`(0Wbhb){3i7jdGGhF4ws4-
z+j~!sQs(-Z$0I4eM*MI>bJ$)GlYF0AFWltZ$wl4lQ6IQPONJNfy!CU@EZ#F=SYItQ
zQZdke*$9!e6@7Lx*oUO$(rsv<zi%qzBIzN))Fk`90Hn~-Pu$-amM-wOAn19^5etZ^
z`=7D;gHaWORpTP_P}s`j9yL1&Kmo8-IO@l=kn!u^#mDzDD1JE`=OK~Q&s18fA^(kz
zMa>Dlib9d@e-3Jlk)Zo)_29;w+Qg0&KI;*eNpBgU{aqCN=~$frh9XolQQAI9UGATM
zAWn30SSRAGF_F4S9h$kwHH5l=#8J#~s;Ja++08Xf{5#9Wu}Y$@TlO0zXSkm-yZD3y
z`0{cSZM?!#a64`(PN&sJ!euAphYH!*(xB1xdl~jAbHc(9r<g=u<xj{}Ux2&l(O-uh
zTYvN(@ww(;HEp8zcIus4%ba}v+41lfP#}xpsShpYryYx==EbtYKsQ5qDlMMx_FtUb
z%!^tpa_VVKEW3@b)-tfHp(^_S8+-ha8M&A6sp6U>y!Wl1TsmvNR~uj0E6pJ!0p!(}
z2mLVma^<;pw4^PIEwwzjxK+wR3-iHa>Fd|ju>s@DI>q${drcaLzBZB3P*j+1(##UP
z07`su!a82`-!VAvn2oas{F+eFhkykHRHg~R1j#f(+avZ#sUpD>_qz*n$8AZr`d)du
z&?IO#97pllo#zK>1!ypD_Hm!R0zMQPp-e)w&suVy`Rd0PlRidjx9E55kZ-)0$zC)2
zy@I49fud7KzLpd*>iU%*IM40!OjZ^)6b!L?*->ctV%v)F<Lh%6i+?poPK=oqgyqmq
zi{i|cy}%YPQ=vBZh*sJKLh(~?ese%aV*|K!PL;m<d=3PXBy2vuQMj^ZllgS}tp}#x
zp=nS(Uv+WK{)BUrO9b;Y3o=ojo;_dfp_3`hU44A+X!|2>3o)|lMTju9nD*kp3{spQ
zRGGF%o?534)rcS9SFqZu(%d-(LpdWRzciB0!GfY#hGo!!2I<?Ch$sA&3rF}hvgl{!
z8|x1Q7-<Yfv)T2X9ylL*)4WnN*!P@P9t!+c?z2j=;CqxB#>GWjyT5MO@wWMbG`#eU
z_gPfgvF30_FTvX|rWb@<lX+?5fh^>{3ZAD`o6xTIk_C?>v$expY9=<Cv*OLJ%(7Bz
zGUzoPwK5f7cakqlmIZ!1)nHt{#vXSZ#V$KayuuoS<$|zj8SD}Q%zcShk1g;xDe_PM
z5f!d|4GCOlD@xw$Q(>I&Q|wX9`uk;L+uuYyHt=YJ4vZ2Le&A`*>Wgqv9MXgq^2Zls
z_+$qlG}Tk)iUnXZT87rFEJ`zE?i&ETvCWZ<`}FEtx-o*J7IDM0R8%eSr=|%O9$kL&
zT$G*Jg(@je=5S;9pBRb^E1t*x*TK(T<F~(fV-^t9>^I$;v>pSM$@{cP+J89RfP#Nu
z8X~Iy+*T{Z&e@b;Scl=tvG+fI_IPusu{m9dg)_j)yA2jdP9|PtwO0p>z-1mjd1X&%
z{lmBWb_gzp^2?F}{4u$Dy@So=&DLf-B=MIGcZvAt9F!pE`Hc|&YK2rvz_D<o(yC`s
zZH$I${KkNkPMPa}<FF0j&rFFd0s9B~gU|EOqjq-fZIXloslMTtC&<9-^{8m8w5kz$
zBA$pJC3kk-iT#MPZ<+G>a9mKFdfq>>ReT&*XKAeOHJo_9p3(7A9q|$65g~$!uX^h0
zJLA1lp=m&HlL_n$zaku6@1FVwc!5!*8CLmu$gxETa~SiK$otWhdhP0T*)ilCI#tS)
zjppjE2>~PZ^n$OIcy#D`LP$j^eEo4@bp3TL4VU~=p)Z$LiIVo1CEWxcqSzR}^H_(i
z#nC{DoJ_*40^h?iRyq+Vb?vb8$IkF>@x&EV!&Z!2{Kl?ReKGfHD|fTjEeb{|-!8NF
z<uF|zi$@SXa)QIC)V&?a&l3ZBbX$pt<jk@(Jy>UDsZYb7YJq2g`+&Nti6hIS7uMzY
zp+^KaSRMi*`r7$k@3Ado+OPTyX842@(q~$foPSSxuldz{_-@xt(Ai&raR+ys0IT>o
z{}mUMAwx&9L|ChofTkg2+|5qCNy}M%ya)}Bmx|@lNyiv1v3c176zM$h=#AB3#K#jq
zTPl7u`1gf_n9Aw<Hufq)mWz19i_$_^{^lQe=~|Q^m_Lvw74Y$0Ve&BLzFg1iM;Xhp
zQDR0Hat{UtlZeZY6X&h+Fq(_r%HL>?f*f~$9)^F4{}5p2o1YXHw4TaBO3`XDIZIPy
zA+=GQlJq(6!Tk(n!(u@`a%2fAT~>=tgo1HX8Q4B%O_Lp!z;!V$?%u|3!QdAV6QUy=
z@lH9SaVbMDMg5uQ>5=h33a6~<?tJO89Vz7v<=mcT3j3H8ihoSR&a|3`{-0uF5ic|s
zo}>j%h^Ox)@GqC<pdnIB@s&osMl=GSe5ax12^MNKoYjir1zo&8ETyDS8~upz{?JW|
zrc9OgG+79U9TuR}LKso^uw0(`AM0(Z5tF1--mdbZTJ4=RCI8b87~d#+-76cuf*)2n
z`^hNLw_e0q=61goeqyg@JYL5w#!+UpkxDPbq52U9ANqXwb}eY^3W{?DMh#=_+RGY7
za&=v9nLBX*U9#OI<DG4J-=f*Q)uPW!i!;t9g#S)kpRg17k?Fjwff}*{&auiuC|!jJ
z1li%!QWb&j`H#S)mxMiJ3+~aI(z7QmhF%UG_*h$Eo#b{0=P0yjTV`aT_uC-n!r52@
zY{By5o`Az^_$r@1|E)g(aaHj8bT2+7exi?iQ5@LuSUWQA+?q-L&USWA!8a|`U(lZE
zm9YI@4lQ0F%t&8-XXhU%MZoikX~+r9m?3FuJmxXd@eN+OX@0$kV{6bWzKm-o3%07S
zgGrK-2t3cW>G8wyy-cceu%<0VVrK}nDqbIAU1TFN5v$G6k~;8PBwObt*Y8|I4Nedo
zi7YK*j^O07YG5}=4%$%B?KaEw{j5nCv$Sq>d5NJd=o^<z<g<+7b9{oE6@{w&Nxa}_
z3Hf<MB(lk8mRZ(&_tGy(z!o#<kG{VLk+Oh<SXo3ifuzR$5NHVe<hof<Knx`b%TMwe
z{%u70y1H@%oB;2`c2xQh+XaTWxImLyYwfG<j3PAr`?sQxQFe0tf23bImiS~RB2upQ
zSd+-kj;L*x#4-egMq+mlU%YJn9&Tj){cwV9Bl{>)t;oF3!@1LnSnL>lA=L-$S{O4J
zR{1hGV4Js1`!VJZ)}0*x3D%sL{J?`Kxd9^XzLr`^RQx<k<*u&y2*Z<dD=>wcHIMc8
zNvo)zU#ZU~FA!wB?0V0`TE0!mZ=U@SXGt1IPp0sI1_B}}hHCMu=$1D#oIRu(Rt}Dz
zSq*dj8-cN3m-1zMRUDIvyf~h$erh~Y(>V9!jK~eC+gxH)MYr*aJoDM=XbRh_=ONqJ
z)gP;UyfF`mIcWMAzW8LLN}a8nfsDXUq12|eW;HRVb40xZZ_sEu?9^_rEB<n3V2g$(
z-3L0tk+Dt)@=au6QQka#{}H`V#$C<mV`(jY9p07D_@MP-(SHRME#a-EYz1H<8C-L%
z&ZNsa)F5k&RKa#{fqavuDqaxU<u+(t+0%RS4z{VXWKLETo(>o)d`GLQQ^FmT7R1JJ
zW+D6<6pr`Wpgq2F<dh5ght(%*Yc!kF^pjvNW9F_M(?t46pcN~~jP6AwFLOi-#vjKD
z(o>@IR+kl-c!LlLlk3bi;nfQ?=L-<M9=!&aqrr`*k6-@{?VoTX2bUZkeOLg@(RJ#K
zYt4A>kp-)nI#K2>#jO`t#%p!eO2Sf8Xbp=RR>-Y%p=p*qYcG@_kI1~=mko`<(>;H_
zMbl4En!*to1@FBW2%0!BIJT4E>zH|rL>OM=@ko)G;)fh>Pn>W(dv81HR+yiN1kC0{
z-h;Kr<Nh5PJ;R8l4tLVV13Q<z_)GS|Gw`_zgMiY_Qvv0RCzN4idk^nZKWbUlMjD_e
zALY<1_Iajx=CQW#4)6GLZh-uIZejw`261|tv89@51w=K|0Cd~wAhNsKz$GWMS4peS
zQ-wzr=kfv(hFKXc)Xrep5Tp#0HQs67s@S-)TakmO4p^J{04ZhB*A8o3^{Rzwp){e?
zuB@Rdg1^p=lP!t7I`rC~vmSx^Z~%l%QxYC)4fGxvWoMBZ8Z{QBU5RNiDiQywO?QQ<
zB2J+!lCi%eJ-Wc7I_ko?zn^tZ{(HUnl-)`N5L^DwtHh`NQPuWkSLn&V-0{u;>N1y*
z+<f@$px-aq?B70OnW*ItC?0VvHyoZhk{j<F!Obz5o1-Mv>wC^Clp}3!R;0=m{$7i0
zu<nH)ir0oraaSvJ*ZLi^wez<lqRwd2Ed~Kvi-k_NAvn#W6@`_$_$hIKV)OHXa|Ut?
zN}(aI)y)}I)y$_4r8C8jvDcJm9hL)G2aYX0bH9J<jXd^e6p<UaaBkZu8q~xOdOtYe
zlJ(c0FjP%#!sRsL-B&6)A#26YJ;U{9jV)cetr=OsY>(`Bc)aYfL)dmoDul}TF7!3f
z0I^vLqGyBjhwA3b?Wm4-vuse2a<REb7>3Xo?p=K#<D$L>l*0;8e4X6;4Jc3M-sjvY
zTZ#24)Vc7YVRQPsPyR3P(lb;DA2o%?H;(!i{Q6qtAqoF6;GG&fT&qMZ(+NQlLxwK6
z8i^VW0!nzg5gKV>W2<^bP8i1YFpf(|u6^Wu%$?q0D%SH>9Evw=gnHG(aQ`zEX8Lkp
zhp4s8YsN2OR$tst_WKfb@oc)m<SN*({Aw&v+I<Zt+e9ROtKL4T)2`;FDl+c`Lw}E(
z=sln)e<tpBd|PO|83v&Zt<Wa97w9r2g2y~E4YK9BNLx{L4S#<YKJlg5P}L?(Ps>yl
zjVJYr$aqal*+hZKpHwqTB%;OAaL~pNqSW1advThaMc`Vio`0l*o!%)dFV}TeC%v!7
zl|J4Hzu#v#%tnkwPkJ5g^1-e;6k3_a#=z)@V1YtDM+CA;^YmqdrqfQpSQjs8I=w>-
z_CKvdNw(w76%+9kFHV_L-Ar5jdcx#I@fSFQm`o#rl0o{*jo(KMhlmsxf8IluiH8>&
zByK)D4Zn7kz7aL!J}OFxA37ibRu|t7Kx2|-!*WaFES$U5Q!o<m3VlW^FD}LN0kwC<
z-Yn>rp&rNqmzX)j!+HG4prbYS`9x(OkUuOZ?IR$Z4}EIytp*|-eE*NTf^Ue@_YC#|
z83GtKcJ^uI73O7#*sP)s)``-B79pIv`#=Z>^_MzYjwQJKGT<EP#dY+S4*9|U$@^|E
zy2HQ#)l4A5*X}x6LaA-Z2lPRNubx$fhdEjjC&1%ppsT0Zv8;Vxpz32am#(Xoq5181
z1l_9HW2v*?@33R+{l7j&IVhWQTV6yh+1@{>zSr5J$CSEyc{LA1gKE;q8cQh+Te)dh
ziv+=5@zc^97L>4Dw1Ip#Yf_#6R_t->EMw{kMsvGF^xq_Z?^{pVeiTsc8fXLo@&XO;
z*9~i@S6Ez_AQ+CbQrzwm=B=jkPEA;#x->t2*$brHlidk6mFW-vM-xH0S*vqtLz&;%
z7nV@4MhGH2LozyRZ5Nq0AjL$t2vaH)R%vYE;okFJNYe)T)!63qFJ-}<m0E<)9V@|{
z&de3`wC>UEHwQ%Y!S<?xGXe>Zwxzxg;%o0bwJ!{;i1wl5{+XF6i^<=h^i_PgX@2h3
z9!CH9+S7yx3wqmibs63;^_kUWpbDzDsXBO=pUYW4Nzc3acKNTjLlqI_cZC%-*rTO<
zgH*ltT&iyt;n@L<>P;QOj1OSe*mfTQ$NLtp_f#S*1jCr@ztfdO<E-h*zx{#g6-2w!
z^%clT)o^Uk(acB#{!2a<{z-8xYu_gdbiVa-QX}^IjbGJtF0}lGUL}ElAV93n2-KAc
z)pa0QWiT`F57ZZB@Onnmok&~HQ&qTHF6VkYfRj#2RMDBgAuM^FFUJC6RWy0d5tqSa
zUTzipfCnAPg=E45J<810pVfr~6aXX>ZoQ;%>#Y3w&ae4ONzqKq<s<QM!s-h&86W*H
zC2#5C@YxZVA=-9acl9WAu3m!;fwg#e(lYkaVyBp2+&mi}*{*M!F=EPN-LxD`5~As{
z5b5N7dG)Bfm11yRM<H2&G)ikmXK4t?HV6H)lzy4i){fLrV{S_r|D+z5r;QVs_S2h)
z@Y>I}8*=%T+l?6)?r(jwe!17?=@UwZ{_luT*~J!LyM7WwDylTtjzRoU%wgsYfNf-%
z>$>)Q8Vs?Gr2eRX5+1_c4|lQPGHBR0JY`d-U`gNJ9d5yJgO9hIpIC-1Ov^zcEr9vX
zV`}L(K^+tLA?piM8OkCKHTu-ja<gsBJ}>|arDU6gpaLN#M4V5C4&k9@;s={qL^u?|
zWHoi%9Udd|l%q7|?nhsa?pfM8Hgoa-TQ)<<9D)&;!Qxud_HUut2ftcAt31Zcz@hQZ
zyP54uUw?N@f7vbKCl6e1N8}t??vyI&7v>QGzfINrL6z~`=|V9qFtD6ukCh<Ol>j}W
z|8<@R;!gPg#AJz#TA>9Nd`7WG$-qY%3w|o#_-I+e*$7Qwss{3Sgn&?X!Idud5e0GL
zI+u>oV-&S$Iat!>$K2o!qWX5H3q@KLOYIj&{8Td}@46+O?nfQDJiQKHLDQ#gmZx0&
z;-fHR<3?;!%1<TkwIjl0Wo#~nd3Tk16kx}~+aC{Wxc~W?w9On$>zgP!T9yCWWnab<
z__#fE({EvUk%^yHgX>N^Ct3dB`{kz?wjaVHRgw$f<zwH@HMRYOLJy8#kHP3Tj=D6x
z8lIOJe@ec$f#33y==f>{!Va%-ZTg%j4R}-2=shZ4_6(W(Y^Hyay!@1r+z37+$w{>T
zC>C^0mruBZKqo4#Wkvr3Q7~XklQkHOjQxX3udj46E_<CLc+L**MZQo2?q~rh1;UFO
zbZ&9$vKL$`%UUzx69;&t*ct_@Jm&wozgDR#orZ;<szP$H5&6F5Se)?96YD+{mnwSH
z=MBSDi`ck}$@<H!b~;SBDM%<;As=RAIEz|zu+knrV7N9E!4HM*qWFq9*`H+$ZfDe=
z`=ao>9umc99*(_JKjR?N=%6^gq`G0p&e#A)IwuP?VLXJiN~f(*?6D2dbvg;V$21+<
zbf2;P`y_R~$Ttf>=@qTQ4Z<sD3{BskRIl|af9C-+LIW~^<P**T3%9=?+3N4YJ~@*B
zN0*YWkrsiE@%ITMNwSc}NL9Lh_>#&&*}~_b??r0N;y&w~%eau{+(&U-@z{{;16F?;
zPuHRwd8suQIhFD3Uch6)KeE<JUZH6$7k4}rY=0i=H&>A#HGtU|X=pv!r6yO^G?el<
ze-M-_*1oC>_|wo)f-zY(g1uv?dsQ8&@1{DkG!FC^#ltLkoqS99f>YKQje9L9YYSMO
z@278kGPvx}m-UV$x>i{nOx)%?W39PdLUSMV9^}(v7PnoNFji_kL$ushYRYH-Y2s(2
zt1Z7w;DKA9y9P1uwLc?7;?SHtz%DYF0<23`Cv6n5IxHC8>m7eUboifVSn<DZ8vOUo
zx5@nm??go!aiR;Vy!EUFAKMIeECM1fdOMOEYPkJ<An@bspQC4IEsO-b11Pa0@Y9Cu
zhctD!TP0qm{-j2Vp?nDyLBuRR#9B>F?1#-8$`8!+G!7++SZCl(d${nM+pR8uSg}6U
zc`-wZe1{{gVC<?Ae07ut4=%84v8ftrvHA5)k>YB#RA>#Yq?TbB;(VEfW-zh7>=h8{
zTdGHC5?8}2>qt6X1L4ft!g<q7)4Y6LGVZ;RcUjkqt%5AX-k5crzv1rK#9Q4$*12Gx
zy@G0Mie{bfU*f6EY@%J>jRLi<^+MP^+04GWQa2ZO2@MT$@?nzg2(TmTkRnNLrRRQ@
zxh$EAQYiaCUh}|aFsbjMgC#U#K~YM)&!4KBrLa(oiBQqa%&sO{eQH+p*()w6TAu?T
z@aqy0>O5HzgsWT;w+DRn+*Le_kURIfCHWRNi31-W!>}MX(lEtLlalc8^cFhwqt!x}
z%V){wbDWQlRSzE!NB(Uxh5wM|XP_QS@SgofViYYpg2xCSgO9$*^l$~QkFS$fnKasO
zd8Wc-M`qks3w+3r;%u~ARnlLF@6Ga;bnJEB_exvAy*`EoCC6RicXo;A2WKUSAGLiY
z&6#oHFWX|ZN?=*D;G*eDkg&7sJ5qc_N-tLkyCMwZMhcujpxv!lg+C>{Z+Z$}*==o1
zQ{gE?rvC>ALHNE5)y<bVq)9=r5q4zp<KQj(<a+}jyP@~W^^bys8Ul3y-=?(p4Xnuj
z_$bwDkj9TO)TuYLSQNxiJR|(PggTK!opY>DH#CDtI13RMq5(DgkY}EuQs4-W`v2Tu
zexUnfzWfyM1{HOuso~|B8h{2zt99Ue%Xu7gp}!?bAm1jb#{S)6yN~cgj<kUH>i@qH
z@g}VBlf2ULA_6orGH;$0JQV#^5vw1PBjQEpkDfn!`hpgzzY)TJ{~quB+Ds$I5qaWx
z?j}frrWjUg5d7J<;%Xxs5#l24nwvta^1-c>K?C@SxiobRL|v=gK!+V{%Dv(yh>C#=
zCLRY0O0`zUd*g)zjS@Kt^H3kFx*TkWgnFCqVtycX*_ry(ah=KmAPs#|@U3h;zx+gK
z96-D25B{_Yy0ATo-kSBv$5bTU^+p29Xj;}isdo7d{l!rx4_TUFRE#3|lTQSio27)X
zx5Ax4A3%AS19pXMS>5Fh?+*nS0?P}$p`Y9DT6VCmOEA5o;vkml4Ylu=%j0FpRob#g
zhwqC)Jx9_fKz<Y|!GeryU4*q;)m8foXAY#{{x%XZOr@#<`qXu@{`tP*0@X+BP_seB
z09(2r)kNL~*Amba$w8mt`Le%*Kqi)Td?BY$=H!*J1wn4*{-)!S&A!K|VF<+k;yx=!
zsEaXfpNQe<<>W?JIa5aQ1Bi^Kako4tck_3G0GMKUbP07jAA~q|dAf?e3S-p){}&FY
zpfmkE-kaWfVF<oI<3kI!QxJjIQrIY)fa{d7b<G|xhg{Sh<t>A*Qo!J>(%5D%gRZ5A
z*@iO2@3Ap>&fl^m{QotW9zXa;z_itj3|iE{YY{+ghroj+A?60{gntTfPxUwoJCT{t
zBqyl|%0dV87|RGpOv3^1O9vAXr{~Mz2ljT?|H&jdl5rw@ax+67xc|a8i4)w$Gs7k%
zm>dl8fJMZD?==@BI}-O1t|tioNWX6pca+t{<iy`3pJ;SO6^QW|{wnlA=B~{Ae{LR{
zNgAFflCobEu@J0B<F*a-^p5`P{9yrnmo$-qRA7j?pZ|>D)qgR9ZpXjuF7YA>j<8X$
zkmF$d<%o@!i0D$6f9r*p3)uG4nC(&sJGkM;Wyr)E8rb4_P<2AT{ADiY62C}ChHbr1
z`RB&I{xRWqo#Vqn0E1fWcwsG?a#%FGo+D8bYRmG&Gh0jX9y2BDne*SDIFG_|nIFLx
zO||kvU#V-v_&_Dm4{3PzScp%OJY_TT#6<JMJUmAEbm`(UVnK9lL3>1s=(<cuuO3oc
zH!Mb8O>5x0F7n6kmReNQ2x4JKfjl9I<?`UjiM)5%iEl*9c!{$2ugM%T`MA8IGO&WT
zDk3L4CGKFoVgmUmHk$lK<Ajg9_=ql~=gCB{(;j8S%c5>(h??x1lasV_97ecG5!UP~
z`E~O@#NlBtU1mzO^%0keqP}=*i}141smoCwBPTZzOMI2B^Gs^j5rTda^5-2HF%X9?
zSUh!gBM%I4Nz@RJZLs2Cr>JHE!@cAnH`QQg+2OrXCbG9SRb^fW*ApMYO#ZGCql-`2
z$>%%)Nrh)*A6;UFz|a2#)VSAn<2hpW&CU3UctrO`_$;UrJsL~{9<jB7xFjAcU<t30
z?`$)bIOmT4-w%8O6Qktb?<iYhwqk-#X2ZNBd#p7zbiHC~5Z5JJ*Ck0eiM}J^es0+}
z5fjIJ>wVMjn%(b&V>cNBRR<bDci~p&i19yyjtKWXz!&u2l3ei}OXcHj4(~3RP6!%+
zI<VakN8min1P=gqMAiegSZ<H*sTgD-;rN>*{~rl(UHtqa6!Knq_lW^JK-ZuQ|G12p
zf=s22iHy9SK2&)ry~IKoAmIs_)AC0yaULT1pA`{|=GssOwfqEqo(g;crv3qY0T<vQ
z*xYKs>vMBh_TX?L`~$lWhzko7K5<tB7z8bPe>)9=9mzfPhZOiCVp^VQonUpzOt-#j
zz4j3D?rvZBg71GfP$O<1`#d{t(0U0(cwmFFn&cHgh4^kP2$!p7lrvZx7T|?VQ-T1F
zh6DeMk8Mo=E!J&&Y=6j@__}GFNV*)f5VMW_;nxV%HOL<*B+qKAD56UQH1;)~4&Z&F
zc`r{Ju-zZ~3~0DPSD}3S)h_Ezx`kQ`&%0;<IH@cNhEmAUE&qZT0i*pX&3(!T>ajdT
zvD0tFa?_2k#0tjl;N0Xp#PJb*S<*j!_)eSCO}qIqw`;}5&0bF?B$Tg?)euFBC^*m*
zXgUZlLp?PJ0;Wb10UIInJ>TPh8^mrhYr@p>AKdzHTmr?};kds79h5}PlHltpQw~>k
zhU~O7aYy)wnW3G=elOswN@@+QDqv64bEd#W-BTqHyWvd_wsr6Le?Az*LOm?&GJEK3
zTA925H5dQE2-P0{VEOxhhGGG9eHr)NK%?c0{!U4@m(9ecf&DzZwDARx=kQ$-Uic%^
zx7CR)^v%V0Nt)}Lnj}%YZ&2+p!w0njXHYUfBo8X!1&L=pFIZ(6%)ue+gmJ0{{Xb0W
zf(M9TjfVqli$a4?s<)?C;;p&8ws=#-eix9(SOCY-K752Qm!5DKhVNedPxKh<EoK>n
zZ}$Hg@2mu!sO+#7VA5)lura1d>ekmI?=rC7AMqEDq<$~|gtI}DVKf<L=Fge9B+D7O
zh45LAW2Z)+;vFrnCTYJc^w)_6*3ZM=4{OuHY$D_S{|NjLVfjvi>L6h6NwU&9T{7~U
zBo<Qac2M*}ul#QqAW--)_botAs=xdoZ}qivbbw92;puR&mAsO?Id|0gQ!ds2h}?-g
za((4CyWh<?!HI|&_^NUUw#bQmN8&#3x;rl|s-8u}#X}zx1mESQO}`Zl$%SYj+QC$*
zNKZF&pKPYTBvR%}6$oVG@W+umJMVzRnhVVX5|GMpr7sP5N}<0^^OlD@eHbo#zrhc2
zQ+Kp=*Iy=Yu3lV<<d@_G1Bl7Tc)%<`m+%`wc|CFJ&)FM?&Lk6xtpCUa>ZEtx58$W4
z?5ad`pkS|PUihw_H&?&jBzK@7c7X>;uGN`G+GBx<h?aarb_{&av~pQw|A@ZmkKSio
zF9&93VC;)@dc-V$<*3Sow0{w3NZ!zQPw^fQ$r0i|1Xfk`L`B?fpaBm_|Jt7X_x+n4
z$)7(6_ePAg+e=I3mo`9`l88fjVg!>ctToA+27?|un=z9m{F4&2iI|D3m>fFcIVysS
z_;DZq#7QA1As@tD8m~SIi18JFhdcy3(fF9Rj(7OoS{eidAz}Cs61`R*Sk^M2H|vHx
zFhbQeZFN{1UjFaZNIJ9>|6CSeN3`n^L|%a2a-qLOBhcfl6?zx1qxnnVmY+q|-$Kpw
z|9!RaT}5`%y5Yn^a!W;u(G!HGNP{XUnH45ZKQuX6nTs6E6ei#ke!7?bJ>E`_5GLXw
zI%SUg`DM$rwD6?fG-9;~bLoJyq-oM$WR^=4e?NEWVW!{~F@yYHd~bjMCIBqSiji;h
zcwm{%iqEcAAAt1F1?S(^2~V}p=ZMb`CZaq>9ELHm5?0^E+G|a$cNbhE%|<~t6tyG4
z>%>Ir)W-lu1MWN5Y0Q(S)I<|ePR#7bsq}nAo^RlS0zI_6;blt$Vw7|xp5s`tApvNa
z!N{dd{wXB)d;M@hjSh@!tGdxd5M$KI0Y9J*R{Nh93`#m1oyw5q{_Cc{fV1}!C3;*<
z#D3@ePbL#Fcu-f;f1U}yO03QBp+WfP+&_0;PI!+I7Xc&Feq|V<*j2-!;FZ=6ssmiT
zv%?YbKPE*Hq!@sMj8pFu;$f&m3c?v81m6T2s33XaP5|fmB;ZQXrjfPZnxx;a=j8r2
z8?z{Kl2}f&`m#fR!WK}Gv7tR0Jn7-E?Vv7H3mH6qCK;jH+EE0_#64wvdWckitWSxA
zF(97wsu)}WA>&4iZ97c??hl7!Yt^x%TsL<UJTJQh^eW9#`y}jE%!#^x?g~1Mx#z~9
z0jRMW#FG<C5oDZ^xh44)5Y{Ke!chVS)1q7ORq1(Qirv|Po{9bm?%Ozl><D&v{nbJf
z;AgQ%#D#c3!!CaiAU|smLU^YXg$_gWb$=Ti>QR!v)`5S?iHBk_C)Rb(s7fLpx}euj
zPa=*dVvhtSZvZr(ly=kd{wVPHK65|r9BQ<%mCx4e-fNnhc`-5gpA$a`=~~Spvn)sD
zs^LsW2yP-y7~d_PBoy3yq#PZ|4KaylB;~CA1!wUdexd~UnW8g78pIZaR!z{Ug^0<?
zT|yBVIJ#}?s^s1O56!hU!nN)U3P~GOC3tl6j(>>Wn%j~ie3bG-5vYt@F^h<+0%Bn}
zLlhgp0w~>}01yiRCB*{Hd;n201)r@HZ~gqRF~C0{0S50Z2mk^!0M`ou-~dK|8sT&G
ztS5mW15t{kk5XnoSe$=?3zI--bA9i@RX`BBSD4?}99h%@K<@pY!v$#Q1baZm`}z1S
z;mTHy4p)A>8=RSFv>{&n2G3jo#I$Lw{g|&mUf~Q^8RJI_koP@ems(nXFasM;;TLsY
zgQ;=@pYs>4_54H;#uLQ2NAYrkzyAH=SF4KFIEGDoH6i&iG5mfzpG&#z)}vkgUa0mG
z?s~a1a$-67LSrS!*{?}3?&oaEi^t=u;%L8@{w~{3&6g1^DxhLHJa!`yEhN4s&y8j)
zlO50TAcq#&!Vi;UnMpajMVAu@L|}S=AsWhr00000a%mw(fK)l-!;7u@ad+=7ZleO~
zrb-3ep~!$ZSDvhNX~>VU=V@gS`6)0|!4W<39*B~9mv2R~BGJ4;^U$G^c;@xb2o~Z?
zo++*DLskjG(dB=Ee*S46U1rYF!isc50)Z7L2GYHfye!WbNkK}ajWqLB%%ky=Xd;JN
zX{58D#Ac!hjL4R%0-~ToZb?PWh~@yeKrV0#y@KXI0001}DM}boWD#$h+V$NzJ*OtQ
zp4-|U+uQYzZ`TK`^?-jDwjQwd{jeU<>wA8)*FATvJ+s&LfF9ZH9=LkL*LvXg{h%J(
z+k0<pdteV}9@sr_0D8}800*@8f$fK`dtbsH+58^3_Rm=My<qm9*Q@~b$E+ApW_^om
z=`0HFtovTs?Rx&x+V#Lap!L0{w0gky{jX>}pn3ek=N@O7=JGtF%pZN^d7e-nPdM`V
zypACn&vW~~|NnApA<4j~DsMR79PQN3Qk4`XN~u5>DhL%a?_OM6>e6;BljSYya_c2x
zm?*bKuzDa%xvDvDWOWl;(9l-$R+8Gv81^DjL6PhUa^y6rky}Xiv>A^=Re7zo2Lr;M
ziW&*gT9<52yIQd^(jk|Jg=WSKYrFPS8fYtp>gM$4O=wPTN4g60>Nl{}(N3wi_MF`D
zM6+q|fRA0qmJDXj9kDp!XotrfKAc<O6??dL`g|ALvTn|P6I)-#-CCqva@)PhtW^a;
zQ+dYkHtJ_7N{SMtRG^-Yb2Ppb(<J(@jXj~F!rlh=QgU*cmdVJ}Y$I}Y$4;_=pb!Aa
z0Yt=}+8OV(+$4<`k3x5a)X(hw{(o;@`Xgk`C)XrM9H{zqBiAh*73B3FH<~<3M4ofF
zvfj2-?5Niht!$pjD&(sahYzjN^W4}*+qboPGgJ0IN!@EA8boR(Vw*3QDlvcys+I5z
zC!GifUtyfiOaoCM^!{U^0s2CC0024FL7E__KgZ*Oo>WkYTuU&}Bf!zNO~L{RM&F~u
z{N~M6;H!kQRXO607>zDu6>*V#sqxV~+|xo>Me%za%%AIvi2wip|NsC0d2yx;7@vsz
zMr`tD|NsC0|Ns3&Meynwk{xSyaWPrn7UX7#{8q3E?WJ|J^C<V98v;S7b5tGjGifZ<
z*MF6+J4v>J>&HHw6?K&Ri2@5lM%M^;7%SsxI+73WY#_9I%pi9_f3AKnlS<OWl1!__
z!gQwI%+$mPB#JD|KZ1Tr^Z3XOU567jXX*p48FbxdXZz%b(&fsmAb;@}B%s`Bk|Ps@
zc#q4BO5%CDLaPxkX{W{I$oG+!=fukg_vd{4-CsL^7#r)`ejO7C>ZZ!Wmv}%x6K)()
zw+<)x=;0uL0yf7*ZXcWd)%g5^SIqq3%L?)-=Lel9xMcK8-Ef5vhVkDSJq*KNPq#H$
zOk;Sid&ZZ79&Ls>E&s`A^6?VO?q&n9hG;{4mDkHf9-Y@FG48o$iBK<y*Dh#Fo)hCO
zTT3dQAWUpbR;me}cxZ5BPq5+%jb<I+hG8~;aK8(SC9j5EkN79?cz2W<NydvzC7&CC
z7vz{fxR^8tn#3o{YgylUEgN(F(rTa~Zoc`i&aC%7H;s%m+L&(ck*us?0Qx(w#sCAU
z&%qasxi7{+;V5B`#(9S&IAKBVIhvJbKXyDYvW$}U1gQSs8Huh+c+i33Hwbu-2x=pE
zW)$YrCVuTx`KEx)#9kuhjAn)%^~LhxX}dGx1!H;g1_iWU2n1AP)mMDJJvHQ>TP4C#
z$lsj%cvqV;iujmCgQf=UkU$TR|2gqwQ&Y<W@p{Xv{{)o|>P94tiS_;+!#^pG4|$`D
zT<;9|XkzaFb@B`oz@U%do*ROZ*{gppKodQDp56EO&3I}pL}(x<paH4cpK*JwBkQ=&
z$K&EWPl&=$hWRe{5ya!h<x+4OL0w~4LNOSafi(~&PsIK{tj)w~=1Kz}g7(pHaxoBx
zaKsRZ5njS0GXIVJ+u@z-Soht`X5yq~hXd}JF7Ej?r{PHS?R2!C4cur&nLyTjy;ra%
zZT<IG%Cx!|;v)RkNi*l4jOs}a$rOXMM<ahGY9qvKCg1@XzU#XG!DVcIBZR9(L`aQ|
zZ4e(N885_5<>rX|d=_e5M#4l)@AT<bdF&OrVNES~%YTm0CczXc)*0tCb=IRl_>3nJ
zc$Juh$TZ-S!d4XV{w^EWiwNj{PY|1s^#k3{nhCTJ8o&ty`XV`Oo&F0tqOD;7!+t;$
zALu*VUwQsApgUD;20Ddjs2~pe-n+v3n0P$DksYJ|FO92W?pJ{~o-|Y7*oR&0Iek5S
zF#!+x^^W^|wM^@8lRkbgGv!?Wb%cCPah@*?+;BqA?O0E81TSA}2u1+epg_}hU;i1x
z)BluJ2b9d<mGS}rj|dW=AtAN|xc-Ot6P2|5{{Iu=J|-iZGLI1x2Yy-2a$|ED*6}5-
zp`J-ItW3C=Am+Z_A|tXdEIe3G|NkfRb6^O{ZAZLiRvCa;8QqjKmeBiWV8%8&fO<J$
zK5v`;!!i@W1e7;;mz;q|hrMT^j6jXlS6L0Bx&L2v`-~p*M1CjDA<TVoRiH>qJ_Kj-
zPx-Roo~}@3zk-|+y&NfRo^0NWh=O<hGhal<-l#N7mRNrk<5_5O--yK0#{zu4e-T_{
zgeDO8=fH8FYTiQ?=fkG;AFA|D-<9i+K-0JX5i`J%zqy(J#7pPXL}cRnF;%qJo223~
zFFY_y2xE_)L%A^=%@N`<a7iQQ_8v-<R~ZMqUOG&qY+w14W+z%mPhI@kfk)OhV(H)J
ze=Q;-q`5q_#AfEUriM;zIq!(PZdwZ`CKazFN8)O2j#9G>pw|g_I*C~aQ7ckdd==gi
zjI7_wfb3;~|9?53+ce}#?TU!}k-?wqlFXU7h@U61j-ZvnK9pqQ1)d4b{DLRjCO#jI
z`*|Q-cNv=Ja`LV+X>Rd&As5U;jUIg66N%#G%QKoTUjg3-p$s*M9gN(-Hh;>zu^Ytk
zI*9Qa#JokAVbD$!mN4)5Lpkcr)=n!PIM~dL$d&L<;og+Y!APL_5jeBpqk>bzqP+_5
zGURlOA0*E$$)4!*KN&W+9?xX6{%G@Y{IMT|vAmvTfNkd__iR7oHC0fNgWG`Cmh5j(
zBWl1Uc-6RWNZUI<s<=juus+ig9<;|F0`LcS@?3I^6#E)Z)J7wd0$tii#s3>2aLbo~
z>-JWvbL)(7YWo~o#zbLk&sFoQ;l4kGqV6nANcsZK2fWGSZVGEp^4dfC`BGL1JltPn
z9f){|QyH52iE){rR#e=5R_#WC15lR@Ar+%dz`R9J?$8bO8d?Jl7*a$w<<|?wNOs;9
z1#YuRy>gxBaGv>~o3V_3NF5uH_it>>{rzGg>`Zhqgd#cerNm^2$;IKh9G_&BG2h8p
zFr6Ra2_-m<COCHNZnqC)ytlRTQ3D-ob$=OG8L%-MoPfjBx70>+C*7HjgJGZBF%dEo
zrR1_G`#Kvlyev+9W8dkY?j16l8sF@k)}zzEisz$nk1sC>VaG)3S-yBPp4TrK&+v{C
zu%$qe=+bKmbRdXm4v<DL4s<zr5C6Rm?vDTByduHZfw*cC+5&vy9)O)c@e#q%H{)Xt
z>fHYCT#%2Dn-z1Y)vp%>-)FN`G_K~SJiL=~s8*>bbGh*zBV67mo(nM5JRV!p=CnzL
z_FRVeyl?houkn$Mf)lIvd^U9Uzg0J+vNw+j@Pmep(muV)X3q5=;s1T>);WNfVfeVn
zE98bIGvhFm@&fySk%rb;ONC@#L)2i5d@LpSKi?d=*9l2tC261u@~y+{;S~@^fw6-S
z1KZ=}uw}eS_X<P_h4CigR3_)<j7s)zlBW@qA1<BLM!1YWBN(fjVq!c^-#^qLsEF)1
zk;;_Lnf9r+eoSe9gf(SD9vq&nuLwcyd=;5L&+vtA?8E`oX*a0wJiis;+ps5R#XiG|
zBkXl~--wXJ2-?8DppT)|_r8V$*B9o+(2p)5-I3+uGVyatfVVlMWC{3;p14nv8F3}e
z9trBIic3sP)Ep+MKgLGwmHvD-ae|F@2yV*k&}t*s+`42(ir&KFKk@K~II5g&X8`|d
zwXcq-b|k<;*XtO;)W@yTxdn6BSd`vho5q3y@TA-{Zp8@q$aV<Nye7CDZ4hDatfBGo
zt;3c!9s3~G?j!L~-{o>UsyK{hHRRSB@*{7T4^uQ_&&FaQj8BR2GsI?y{AL~8?F@K%
z=#?Gbm3^u8q3bR;Wv4C>rvdxV%lT(B;%A7GL|BN6#E-$=I@uUNZP&%m0G)vXONhL<
z5-r>7{|VjEhS7rxj6%E28?;NyUnVra$uuebMq`ZY&$z3a)7($uKQ$4JFxnz+Zv>AU
zRq>j@k@&9Ak7J;CM@GR5Oq+msCObd;l}DUk$Hsc7Yhd;raKYd$>G!tzXOpOv2Y|>2
zpIEJHed06mA0}kZxGR)M^Nnch0iD@fG`D$@RI)4D`}}8uN1H=HfjAIV*g+|{W+Qj@
zf80j=M~RYnQG7&j0DWsjHr$7Nk@|d*8^l7GiiSK8VzClpVn2wVnqYt|qrhfvO=kWI
zqZ&^h#0<flU+QwmUT0n46>GlM<HB+&<8E&;kVRd!fYorU+XYm3KpzQrE;nm_Cyx86
z^K$u^@p+-JW6dASEljn^i01hwj?&>Acwr0zqL2WSV8}s&%{&?>X>YGQPUrt0S~Knd
z@Rh>$aDz?pI+iq<@m0ETQX|RuJY-={q~Z0UU#3&@F9>hn;%0N_XhFxk4)raFm#%2=
zaTj<Kzwf8O+oivjmn{$YL!0;@G^jD2m;=2_c)kT+qcpmBLeuDs4z4_QIA&aazdrpY
z$K>Ylg|}yn)v%3#4i5~YS`7X>a3AUyP!WCuJyrNMvqT;CvCRA_F}Jq}{r~XiGCt9;
zAPom{RV)W*lmII&$eM6pO+ks+;Y?+(-Nbm05+Ea@xf1q@083Y!=RAO7>t~|(iHR>Z
z1FHnYZ;Q7|f5Q<NP9u1jn26}>CfhSD=o^{wuvm`bAPHG*UrAqM8$$<_=<ATQxc?E8
z8MgDBu37!-5=rDpY9ejo$HWQE4FKaN&0<M##--l~`R`PRCDQnbtb<)*Vb@V`jggoP
z!@xk-rLLoif=mQoe<rV+>b<jdxX&ij@!wSqkMWZ{2^;#POEM5P(dwGGxlJ#~+ME7{
zU;ZP$q3P-!jWNAn{^^qZt#9-37n~St$W2c&qeu9Ot70Ph=l>X#mTLI^0$Zn`;}bl(
ze#?y2GX5?DD{kfgzvp^D295M>t-xl#(zjaiouDS)|F{XafAF~pyP4z0E=V^WP0<$R
z@Atp95^(FE8S(9!295|a(1Kl^AeRRfsDS7nBDM#=Ckm0<ANn%`A3(fEgt#=OLrLn*
zjf$znt=zazyU(WPcrQFak=$cK0Pr8aphI|gz7F+s@3(x`I~(~WHa#!#HNrkLGFyic
zenNaaCw*TT4I;d>k3nEfb~_4tsgm&l<09R13y%4u3<e??7=9xTariN*RYVCadBo<5
zQ@_MXjwDo{EKHDwq9)dOE-R|TE$ks}*?9(I;SNn5@{#a?Wj7A)|C5_On8}IE-<J0L
zL(x>+A<y&s?j3>?$x(w$-#IS{@sCo{Lw^$M>8nALjFMBpZyrryuFkN@$h1n&!V+)r
zSIZ`8wuS=!5w^&(YFs5~5=}ioiQpI)iR%Bva0j*Ocp>-#K#RkofZu)k%o+c^%P2lb
zj}iF1xsJ3rm-5U=#Jo?5$;t9Jx%@;FznXTR{G{UY{<`#yuXZ7Zf1ttehGRf~sK=`v
zm1PJgW|%D_W)zq3C&?f7t7P>qKN_6wjY{~`;-ZBG<EoDj?$bOMp8LLOw>|$$CMKdk
z3UVcW60mZ{K@RImA*0R6cXA|cTmK*7ND#Fy?NN6NwmgHihvsMO)F2Stm=^szxZgjW
z+kAX^L3XEv#O$TzeJuAnyKOv4A;mLDrf-C@X*X2xo+b%-G2@5#<b&cqCR|N%@cqEM
zJ#mPk-^#akfCLgcb{U#ii1)7<jh%$fJ)Ft9!#nt}x<~hotPJ}B&yTi@plowT3U`d~
zJ5qt#i0$eK1^fys8LxmoljTCoCp89<C9W%;Su5f{CfFkUXKh0@rSo7V7jlrTzf*X0
zrat^#X^ESckB75r80TF+RLZkc1?&bld$SU&h4z2M_rk->*%atrp?>|?P874Lw#`@@
z0`drjazD;IN(Z$_4n4+3@5mXoz605R#<6AI0}p-vBC=IMuBA(~8$TYsI{foLFD01J
zX#aIB9}(PaEHQrwaFgF9IceE$q_|BU4WHuupoff8M9Xva$H6v$*HEh-t?{^o(msT$
zuz0UA!JU5@kUxRmnnen`@7>@+^;g?&hru?0*H<AtZ`JtD9pS^jm2OD+YGxSL89F2l
z0r&UDcSnLo&ADkHc=>?=bVy2#y99$;&!@^GLH=Zs5>m!x;(SMliS&f5N%_O3eA<`M
zd9Wt@wx*=?->(RHa@-Fi9R|yyry%S0W@yfUJ3if?72M<$nVRl@!}vxT<iaK|dDbMC
zXDc2n9G$c`Lu6R{@$(sZBB>J-(`5L>Lkg=^cD!e-Hmw|eY)rRu7NU2bE#%O^P-VZW
z*n5(BZeo{g<cPUoXc`;hp@fdH>aI16B{)#m;`d}a(ZBqDBxXr60rE6-YdZ>d)L$#^
zMl+o^4{k}lueAS`weHLx%IqO8Htg~IigW?h!9Cl)$V!iU1>bvSE3VJPge?%8Ahkh@
zT)oRk07rcfYuz+;DAD1UNGHVnBaC1=)a0}WSwI-~{33V~C~ab6IMX}T2mDAs`-G42
zkeJsm*B9aBK~Rsul0+$+*TGMWkf9HMQdA6Hg{gJ+jlvT0O&V{6>e2Ki|BU!T&-Mgb
zeL(92=(der{-=lM_?5z6$PD=V(^wVufcGWg7<XQ`TZj+z%?|7sHQW9A8`U=mA`N4U
zmM`a+a(DS_^4yT;F%dkp8)QsT?)fE>QIVSy6V~a=ULxV=VPS(8+jw3~$z6XLDBo*q
z_J9-L8g=G)yf6A@2Y6-8*{CKS&FjJt8;Q<fZ9LheezXC*M|L8{G;Y%KrJj4`kV@|~
z_{GvppNvN>Z{lNN0WeX?gt^_FaFl987CrduUx>uI%=L=^d`yuW#E;V_k;*NT@v(;J
zwa4^Zvxt{xy*%&q&p@cKmTIRzmTow7W)1f<uuPwhI=FzRk(%tNMZ8m9%km!j>qr2?
zwfTpz%alrxZuCE`DXTQOs9-&rIM#0X>d}UkwHp1TuO`B8XYbocQ2aoCulgU}!NvRs
zr9G$oZ)$+uFI?UbcgMmwYnBLGehWc#f-V7LMi1wQ|AHDMJSTmj9!b#-fWiI{qIP(X
z-`KSVYuG&)1R#9~aaQ!`m&4`siR#xM0S>s{aWk8*g#Vy6IlQ)j!A5MuLL%-1e4f_V
z0qAFrnkOc29mc~D8uyFlKXl`<{#oHxTu7+sHu_2&NnqTG_I-TP5pz-5<>xdR+Lj<C
z8bJT$gQxl@;xQ2s9$xIa?-uB0#7zhZf=)}l#Bhu^xHbDomi}IV{a*Nv6Sm0q(TSrR
zxc*Km`SQjchX|Ss=Y%^a8PHhsU(RwIF3>eT#}nqwy5s$mRLG*w^j!Y!_~{8)LSZ9$
z_#ln0UyN5^{}p^)j|3hs%6^VgZ)$+wm#%Fgl}6=w?sf*{4#r<<ey#!kh?|?q#zcG}
zT(IIE1;#Qkmmi?S5<5(d41wW4=m_)fKZssNMa}c;%lL`t3D>xY_+h+u3>Id`dZ*$d
z=$w9W+|d3bKQA^kn7M#|#Aaq@Lpl|kxR1qM%p8`iW=3hKfj<?kVc4+%vp^L{`#E^(
zgv<?y37P|OFq|w4kpA#B_vymbkH=C|67pQ0I!pd02Vb_Duz0mhu-Q>BZ3~lplI(gn
z@!kkL?i#3?U}1l#MAxMyq3!@p_W`r~_05OiI0?7~ThGBZGJq272{F89zck<WAxMq!
zP|Ol7+Byg&eZR{yaqAv**B=<Y+&|=~;C=(*R_*4=vt9<q`pqJ)3)zTrWGsNZuN8WN
zQScdXJ(UP6OkkNQ#PEdle*vm+tnF|Ww{TfbJ?7ZN1KTvw^k<2Q<<5JR{@>*0^6@<x
zt!eHf6%m^e2}ERsFt0Q)l<!6N4Y+^HHc>=!WMx>&=ClY#nP>t|`ZIVCACAD1=yB8n
zZukxQ>5lG-4p6)Oh17lg+Nfa@?~L)F&>`C>TM4xdU;@qr<3Qjebj`6_{`cY`KP%SC
z_(p;O5&i?L0x!d@AAX?!z6~28GGI-=gT2wDdO&r+Vb?YUO<;On{B{%Y90Xm$-dXbf
zgg1xbNQ}HxGJ*rZhs<6O2EJHB!@6`UgxJP*d}Ik3ATp=Vc-(-Ey#cY-Or);c{&AB!
z;luU%!&BKI6KD(8bg>YmqDQ8C=Xd{L!4juE=L)at@Bh&~!-Emg;oI{-KsfX@V8Kp2
zbVFm`A3V=+o44RU`qp3fkMDlVMKnbDw}7(YL`8QX)HwauB(Uof;!7I4k4)Dl7_z&F
ziSY8_)Y9G!@jOH)9iVrqz9}{NCg~CRVkOBdn}sm;=#tEEIXg~E5FC@V%!V$u`{J_i
zSa$63kSzPjOo!~CMd8;9?UgfR9|CX7GOTCwrR)jO`-B?<4=jt52%BpDz3_~B<+4l6
z$dHjFd`S8NIt}MTdV7$b9>Zf*-(MHA*9Eb>bw<R6MlM{NO^C!kA?L(+j}aBe@%P6(
zd}Q8$pa2+oJm_8j_zY*uOwa!LEuQO58KegO55I7DLzQ_=4IB+yYeNJ>lSarTdLPJp
zI`-+F;zVrsA3T?Qeq@ZgL&hm#t;@VYGkm<#$*;s?MlLj_=W|44h{Jeh5QH&2n8rRL
z_~kM9jxx~v#@TKlN6AWE;0nHXW~0Dp@jJ*s*I=Hd#f6#vOxc_t5xzT_;RwJI1ztl+
zegd~TnC(OS0G80D>x6J4-hPM@aBxqj4<*PDZ`YiE&4`N$xM|Y=-_-=%1b*XcZ~pkw
z3|9&8f~Svyt8m&apF8}2n&=PE{;5EdNdD8{?jPu?#pC=UYL=VDVE@x97~#Z%CM0GI
zb7h@Dv%2Z&%+G|pdrgf;Vr!SAkvX{57E8oS3Og-c6L0{`-*t8W-}o%8kHS!f6NEe?
ziipq6$C(j4e9_|X>IdX-f!!a3A?1^h`p>Q7<1-}8MwZLMIBxD_SA|n;7%<eK<FyVn
z5giKS{l<5>SF^+Uu<R9?k1w_N2>DEBRp5Z;@toc?nBfSnO&R>D7bh9G+keJoHr?=t
z)PHpDu;k%^xUJhUf~SDBe4Tx+jk-(B{2^6c8siP~S(s=52>f#Ka9kiDcdKo9&k3&P
zc?a%m24*+4NtjMu2mA`6(p;p$d(7vTd+`FZF-UKzej(NL_k<#Ou99(a82nF(o+B<I
zq9P)z@tHwRTwrucBYs?&z7)v_ByvxH9scA7{_*x#O-)Or{}f-0l4W$k&UYi<_t*Eq
z6b7GEYq85Y;bTxEz7X^)yu>|5;pREd0fE=j+j}DKKONw*iGiv_$M*<dk_Uk||9Auq
zaFqb?5I5_@K00EoKtgyzqCyc|C!8P*a9#v%4e&e;xGL8-d+31hI{}S^2NAv`|Jc4V
zMF`Pg$A%0xurIF`4By>wIO!bb%HQrX8B4FmPX%CM!4`yzaPM266E+0AJPR}wm?kbD
zh<-iQntonPXT-iqd?(s0rvDQi2x4L}(1u83Q5i8eh%}7I$wuEK=}BLSo+A~)S)gb@
zrh(^clQR}K$K~~JzCdhy0}7gS-@5M^@#{h^?4Q@dABp#SvrN;w3`YUkg_S$AhW{zE
z@J|5?<?{0s_dWJ_J?qKp_V)d;2mD7e`_p63Za*P^f13_HM2SO)aG8fO;zyu1FA4dv
z9|?A2#lyK_;yz2se-*+uu3E}#lRM)1Xj)~VbIX1FnOAFv#`T89<E?(&kC-lv=>%7i
z@JETf3pHUTJjkM$^u&&SBk31=n1kXb%4x3=a)tulq6EC@ZHtH#84(jelTAlVETMz?
z^x-@s5y2HaHES=pjUTK@ZqDT9@pJH&X=7tY<mK5K7P+=eh9>-W%Ht^?EIznPmJ%4g
zxFUeelh%d**e2&a+2A)XEdd{Ad?~onbC?}=cNg0LitT3^n7wE-y9ONRG4pnHjLQ07
z|59PZ`QPvQ5B~V8lYm9_6hq<{5U{5clrR~Wp~p~9&&2D)JxtAm;TJ>AnGw+b_S=x|
zr0<sJJ~GIdnY*Jo1syRF7~D^ZpOcSg;y1}P4H}BX)+V_!B&eP{<~)Mtv-~#rCn>3=
z!chB%<_y9ICW1M-sH{XzAUBzMYvQ}aaGnJ&+;BCLd7`GT#OiL|+LXarS8%*lE$c{}
zm}uO;5(scO?tgItWr!0jMtmVWMmi%dCxkpsUMHRuPfSiH#Bmzpxa%g;D7VFK=@gQ&
zkG^jWAjo*QBzRw82kUy!`?JKOW^NZL*#8HHS|WaUfj56|bk)*u_FCd~_n7h2#(_;`
z;Vyv>hXaRUOk{oICh5g@n?DKmW()_Lt_gD9Z0<?Kd3$Egy1fS6GNyK4Wi&m1MK=}W
z;sZd5YUN81Do6dQ?ns6bxp*uL4k8ol&A)Nqc#b;CgOhPQRk-<$S`UOV97ZA|3Pfrn
zCL|+n`W)P4Gpj+w@jZI60H-q<|11@HzAAzuQmAt<_gP(!bN|GCE}Lr0L>-eJGTvwm
z0C`<j0q7HIz|XKS-!Q=Yp}SUpe7gFu>|VbF6DSg@S}<zu>Oo<GHksCAi&NA91H3PF
zgd9&LQ~$&X(PCbEAdLAj$MbI;p?EFN76tL}M`sLS0d9t#Zt!oVQe|O@aUT_r0w){{
zQ-RbibK^MCz-S2sn#J~Jk9GXc*!M^G)Dw6Ox;#vTH@h_8#05KybWT6qMd+$*APZyZ
zpOuyR@i1Evdma4TchDN|$rE#QjX@lmBEx*p*-R&BOHvp%ekLL_fj!@Pn})IicA`W~
z0+Ww_9&7E}jazqTHU(8_XJ@W^umn|i$-TUFbS%g8c!rvp{&GULi4CT8xfgk(RAsKe
zJb!=s28a#vVqom#%35a(ctTz$a6l&v4nV+U_1^RT7>VZFk6bC<H{uuJ-Uewg8s&##
z#osjy4n?SS9ZFMuQwSVC5di-ahzNH?SW;!haafrmFzzOJi^c;$@}I<Dk>KSK;wH0|
zl5=7LQ-}%9Ft=rrB2Ae3a}M*f_?UVveX`hM3%Id6d!xY7woD=Zmz<I@&sAch45C~A
z83HpMw+-%$#5L;OgV$W#e1Fx1-0)@yq@R6heDmDy{P;(AHZ<hjuqpZg^dO3vWrfmo
z6k3^`;xQ8U#!RgQ-~WIz4U;1WzsbeUBKy8Wyha2Uz0^+lnU|eJ>L*d3`^Qh=9*k-@
z)#|dNQvAD_hs1sn;UC8gQ<fb#y!c4%OV)1uxy`!nbKxH?jTpkTOoRle*amet2zB2x
zv%<d<!TltssEKZQ8XuDt{7(^seo1u}xV>5oJV^OsAuF=W4~Waca$si4>9wvh8k2)`
zt3fdl<o`3IcJFIbAjo$_v#{9W68EL1MTSgV-ZmsSLisZ&m7gyOm@Uq*iEYCvImi>h
zNcG3R|A0G2(Px(|@Xy5cbljFG`LkVIsG7au9RI>Jh;ap{3{yIcPBt7sPb>=_i4yS+
zrDO7IUlTftB?6h)zX^-T;WF1Rc6Z=D=3XKcm3m2U4O8Z)neR6kKui1B&==Xa=6Egs
zUel+8;Sa{S#<`t$AdAfF+n))}l1LVVxoa*o`64h+&1F+WE6ukv4~WJiJ83~wMqV}x
zDZ}4|^bt0L#aTNQ%P7?PT+0n^i^<4<<ve;-)+k|XHq}4kO9UE@pI^y?w9_dR!tpmK
znTu>VBxnq<BZ}wr=mK#8AHi>zCSPjik(rd-PP^bf^v{G%fiLaVBzZ9Rg6PUgnTGy)
zmKc8GA~)s&vsv#sQy2?3i^qg#>?x!I&o*_g$!O?;_hYVlY%%;)2zLPvyrx+t8E1Cx
z{}Njic{7$HJVrJU!ac&9w!w!8azaK9VH&fA;G!`qpC))E;<4+sv>dH9MTZ@d6OwpP
zN6bfvnr!%u@YgGhxdn}P{v=EU463(%?*5JgKa%%0Sy7E*WahFQ7&B%X97Mh*-Us1&
z<fc)BpSlJ%(Zu%|Xse-a#>(P$<ziMPP;5!F1_m@D7ZvcJJ@RB2z9h2n*ND({xXwOa
zBRtK(YIM{E?PX!`VJ4s<c+J~?X7;Zv#%#H(2P`8|f{THDSjYd}IVYdLn#UvSlDdhA
z!EO+r5<epnFh65!5f*9D-^5f*RBq*PA^V9A=rdwO>cU;VoCUvs+OMokyhkw2Pi2e+
zCx|{SH4#8v87ZzWX)KY=%gd<zUO4!Wmn-<5Ix{L73@5!rYnwfPEn``JUQ0%PNP3y_
zaazDnqYpy6^@$aan+RiqwoGYJEoI>=Nig(`ijXkkreJLXub|<#;XF*7CE78rO<a@1
zmyE#=hq8nDt@BnTKX*Y61E!J8Arq1#aW&}95`_G`hvoJJxX%JT$#Q{Mq|1`({p&+0
zM+Y7;PZ#jB?2G(i7>ry-5{TR(u1sUyiRZ!<$sK5JP=AE!SSFdh5QvJu5f_Ym$m1{J
zJ1X-ea$;U{l-D<cJ%P2)j_MwlqKxLCazu<j!2cTpJwNuf#>ITMx>dJCE0d?I$jY{p
zDtCqed)-%8-s~cJNqKb!{3uG#=IaFi*97sC9x^&LA|fRAIr!-QUSCleVs!(?ClV(#
zD3%|Wmt1Bgbd&fU8Dwi)_CY@cadu5uDlz7m>{rhExwPL)lRTf}AufMjK!CRq+kaP#
zc&I4h9iV{^j>_wp&d+%RdzT5sWx_Yhts=x@Ij^`O!X6;8Zk_W{9u>r6F$BoWta-JX
z9u(>{Y!0OE!&I={o}q)$D8gmjz18{O1JLaFFPebtbO{EaKVyD3n~fOZw)#q=Ard+Y
zpZLzEJR$Lt^OWw$M{~Pa_?p2RL)V!FaQ0pZl$V%X6GCSv8(4y7`(7AD$VnO{{u8G1
z_q(1a8O3V?MzP97H@uc@x05d!K@eT_Ij-iv9m?2ZOoC}Y=GqN7;Wt6<alq&%-Ue*J
zG5#HmowUVF=fIPVE_|&X;jdh1^H1LiNFp%{g)*6xuDD!AqBV$wkAyF30yrUw6REhG
zb#9!7B;baL=&<53T(XgR;v#rusqFuVetpD2FNqKM14ny}vw1pJAdxm^XXElSL)Vna
zr`@phj%Gt7ttoK4HtcN-20U?Y;lvb&enk_g9}#^15a5?87)8U*4axnL!E84W=dv#z
z0|0D~R}~GbUOS4zXCy>T+f9s*VvM}ol}gjXh?91hWr)EB2xY{@L}ZBgo92#7=>AFU
zcx9|MaEW*ybz*zRuCl)f@QJElY*umjxwDD5vppr^f6O5=6GQ!XcN{fuCR_YWbUXv4
zTF)I2I%J{-h~habU%j*g9UO*+e--6mWI%WYT-Xvmhq?p~L+W4wcuoQ>w0?Yfo%)Zw
z{n27F#8<Db70J3X82C$MHSRI)3o#_V<>b)iU{3^-W;ABOa(KpK`1=Wxl_h3L6ZP<>
zI@g-GC$kS&%z+a@kVt1+u@d4Wl05$pf@ns;+%wINsbv{EAnl%BB}+q{MkebG`!#%j
z4wC3dO@6v>X3P|tT42u!Twkw>htNW3o+5pEGhea%vsZr+yZ{3m6OQKc!@)KP_BvQH
z013MZAUpe49pIJVJ>eoeKdky2sH8SRs1h+ud161fj}cyjn29`hBXY{e@RrEXyDOKH
zXwXtbek)idY!9-Bz=6GSp?$cY<NlBLtDMqA*o0l?*;mGXY30>lp%;0E4X@V?`-5h7
z6!LlDkU!&dU?JPz)EW6fi=kQDMTOopAtTTe8Ry0KzTa4V*`OEx5UQ^T{h&AMe*nOn
zNDrE2Gz3-fBX6L_-#_r4G8OOy9ZTH48(TAi3`9mYCqD?`9(QDj@E5G$i^<dk-;Fs~
zy8G7)E<NYzct4sZODeQnBMS1-qf~(eA)k{pCNgM`5q&n^BjuJIaX167sV@n);P$-S
zZG77Xpb)=NoBj%L&4~KCbvy#qV2js*1N|R;eqUb-;;GpKCM*(oL9~#6=O~%}SQ59;
zZ%4U;0ziBYdWc_y<D<dw;_Vd22)Hw$5J7g2m`8%#G=dOh5T76*5b6$u-QiP(&4N!n
zU^5UyJM}-|KOID2evz93M?<B7`@chO@A!>kd^0CD@f4waK{2yFxiO{Ud9&sm<dY3g
z+_qXsM9~6%C!|zEW_)+ek6tK@EJfZ_O8ATxQ$`H+?g83-E`>9AN&*My{gsx%3BEQ;
z?(dt&r+gJxV#-r|VsA-%=4S2=Q(!<jCqi1f{HJ66^8N!VfePV8{K>w*|Agp}@J<sT
z`Up=OG8>4AJNy>s004%Ns^eflBcTFrJ=d9k^LPhsphccL4?ClmAo%sgIsq^EN-!m7
z{bFyD=l_C9asplW9-hxKUkl;s9I8Q8OSx>&njgX?@e2^PBq^DRm_OcC`?Bi!Fz>jS
zLnI-GA~h3!FoyX&*rGSdp-uhYd`F0c`L3r(i3@Y_-Z?DEYU9T5{x4eGzyKlfwego|
z6wo0{@DJqz@^paS)aSPSQJIKfPKU=tzFz@fr*e_rxcF%S<6)RBffn#HPqg_m05kl)
zG6oBDC(XhxNFsc#UJ86T;9LT2U~PCP4gL}FnU~-HYUbpCO2CGA?+HZ$W&m|f0#<*)
zWdalaOil5S<fkz6lm7sFJ#DPu8rL(=Hvqc6H0$5uArAoc(>n}ncYqJ_yW0CpvzQ($
zEOJ&NJ`fYa0%ye6F83xTXhSjH8s_kyZCHsTW`86_^X&Xwx^XH};WZ0$#K(B#wi4-k
zq&Q~$|AZ~t>1#+)CEW86N-%QZ4fPHyD;I?@F{V&{D9RkYLInRm>qFm9{ictiKVtVV
z@zI+*N&5d1to4(6Mp&6K+cUu$N4<alAIUlr>p*_VN4GUevDrVk2ysn;uzPGq<Jl7~
z?tWRBzOT6Yo?yUxy5lX2h~Xcc>cc?z{I3^;+!K?sQLuoFTvox@j7MA})VYBAVFN%j
zj2GAVj3Hs(ppnHT_EB*Eu51$dzCaIE=&e*WJI7!X>)=5%%ah^$1Nt~gXmP*s+JM>|
zJ`vJB3GvY+p^qT1CgZ&YYA;)qXOw=HcgAeEQ+Q=zr^|2f?5^_w%IMQR_!y=QAvrg6
zfvVhAy*8!ez6+~H+}}eL2k=09ceHLdj-i0yF`YdfL<ucpa$+G2DanU@_>f6%=mp$H
z3OTXNm&9D~X{v-Z$%_0ypMpw;<cfD9_}$Tf$6WO;MrZ16{a2c1{oBqyEAz>CyaQ!M
zR_)*XZOU@wYf4j1o-Y~y1+p^J6U9Kw+6=~e-~S!u^K@ga9u&YCEc&d<sG&EJYZ(8$
z1Afcpd4F(EP*=EGB4nSn<!_9`bK*YE^rMkPkEg%u;`2G;KXIXy6Ms+g-VgURGdR=v
zG`{{n{--n=zK^Z8ydlAMcC&v1rZfrA(F5uRjwb3i2~B7Q1L7qR5s<0)Z445SfjlSM
z3Rw7HBRRO#YDJb_5%411Y1I!mkP+?1_ah7aAMQj)Ku)BMXM_E~M%TaRf;_%CKb_0`
zMldpVn8^dAe3j?%@mvzb3$==8S;;CnGKP$3fZ#WE)bTJ2ACTzP?XNyO#2wg2*P|vv
zZ;KVh_G|7VT$7mYxFGPAg08FxUajC0KS!soAUr%Sqx()6PUrk=W^G7@(EbAt?!nfb
z#NLC7u|4apVIH1(iaawCsqdt;d(0bHCE9w@B%(zT<bv}{k?TGqEJiXSN?BPhBu<%F
zj+{-9Ny$y}L}ljjiO&TRpaj1H)fbC_@)L9Sfj!%i-nonUE=BRxzG!%JfezkI*OqtT
z=)mRjTO6n0OS5ib<@1NTi{L!Khi8mVUr!L5x$e&Z<9U5Kx)Y8*lkog7zvCx)XmYG0
zqk!L+OYQ2}cwh2cXJ!v_-0Q{P<dTff#>pS{!86xR8(c6W{OFMJ^VK{nI`6n%2=;$?
z{|><x)O5=QPWJh})Tp>|U;Ws><qgC7`2XUdH7yj*&DqQmyHCk$Ayl^P36=a4Nnh*B
z_Dx2lP*(}~^tO@16V>A&3?5w%jyoK8iT1W}FWNn&{TzcHn!qN0<m)xOJYF+!9qE69
z9HpBv7`CPf5+eDfQ4tkYzW!b^`2H`48D{1U{ww|E<$sF*E?*z^CodP^vmU5)o}+T0
zOZ;yrU_mRz92xkC=m)7kKzu8}o%KoX0hjpZL>W`X<ETI0Mvt9`=Xs(ahO^Ai-*=#y
z6N>TcnCbX>YW*k?>mTo>RECzykXDECEmeQULRJ#nkVNVj3Lan4H$Z{t3-1JInI6^+
z+4_21O4~de?XLS;@KX&gyAbKO6V<dqcizA5ir$yP_`f$ES{sp4c$?uKJ#)7jKuNpb
z#9A%oF|fw2j);oWoh)o&a&bACh=v9;bA~xH{6t5H*9&<&dUeKAACe<41fB@|Z`Fs#
zc<E{||2M(>#@swthT*?f;ene15BMzpG!6s9h!rOoLO0e2-^c>5SQqpcqe>4DIwoV2
z4_@I>I`jv%yTs(m{q}w%@Iy%ost5J)eo6=Q0Y~W5)D&EgdG3?JEI5Yow|78U>I1Jo
z-6vOv%~ga<4T<4T6M)B=zSNEtn-DJYW`MhI%YP|2zXTsW=K)r;a*Tc!pB?4RniN}C
zn9SRgSQx7nx&7`Y^J_VH_>uVUO^!RwjMH?a)DgEI6Lj_0{9HiXWGIb3x|ifaZ+F+=
zk^uq!a`(@9dB(a+7_+I1=J4L7;_xE;;DRzR8Y@wCLfYsW2;Y&PElhvMa8Kp+h>nfw
z4x5OV8**lhyo|N_%E!6BfiM0|WzXj1guEj+IAAfGl`Qt(+j>DfMsB8b3rlYAi}UMD
zCnBhrg7W*sn;FkgLz2RKUM`bcO<|aU5m1J)GWj^IBu692JIeU*<nf!^;nW)i;z9fU
zJ&TWl0hh2gDdG+7&%{Dj2Z4uH1l1>KKbuYZkDeoZEr5Z1mz`nRF=R?X?RyQ9VE3rV
zg6(7e2|NU^QUWiG)&-slU`Q}@WyBT?jjwcTKn897Jl;Gmpt3qVKg|ab_|6%!)@xi4
z=>2&!37EVAq!Jj~&2Fw?_}g!U<`5R`S`DWgJZ9nO4fHgyLNxVyf&lx}Y{{G7fNymH
zEYZIMY#~HNe=i)cUq@r{8xjB+LFT@-aqr}gjnudxFYyyxy3P3U6Y!rJ_7ODTJ8`M_
ziD2z=(7&69GoVJ&xv)VO-Dn;Tssp7+QwW@FhyMfj*_f@6Cob6Wd>!gpad7bx@iBR@
z@nxn1waZ`O9)STHIMA4cwLL?9J9>{{(*GIpGzD6hK#y^G$)~CYrx2UX2F@3+86L-o
z=s_UC_`@&!Pu@70!IQqOSdH>w-W-t|;Rt&|nN8J`vnDy;?-7Z(h_56kh7*Xwkr>QK
zs@WLD1bd&BH4wYrPcMFDq=+Z@{DS{X>$5ilS%qmMD@pqoj<?K=0tf2!n8oR}IjT&2
zmS`zBaRa=snjMZm22K>(2rwcVfU3PM{13D-5qxBJGC%P6dOa*n+y}kzS)f8=GVjNR
z5w_#ms3Q4<rjifD@Q<4~e!{$86KdgGU)|LFN8_t3HI7T0%xlD1AEMolhKOb)cVy#O
z@(9KuEwPappPOXc;y1!xP3DkpBLw`sWtWNkMmJqFrMT9qxJw+vFB)yPiM}h%=1SU|
zo+EUbRWDe8mD*X-9qjT#8;HBT59G!FHyFh%M12yl^7lu`d3)rklcMll**M!@#SsxV
zm-r~|33qaR_1Wd(CFI7J@h->N5evkUG=csK*CfCBI+)Oij1Y3{jqlCPv6zU?YOD(Q
z60^Zifj9F{c;R7P7br}?BiF&b_7+W=nD~4>rUM#bo7O;>ZgP8k-pDe#;a*zLc;S5|
zR5M-`u<Yu8_?`Qz?K0U+5FPUI-)oy%`0o?(qhLdvRfgz<xHzJS*jkSYQ$wT$nX%n}
zfg@J!>&Yg9qu-xY0|5a1fc^QK$!TT(Rf)Jm;&_kCR9~9YIx+;^5C0AQ`ow~)-o`U?
z9sDO8=Y3xaV@N3Jic>zZPUa|{e_&^;h=jLAa=-+7nY8W3gz{sCzs6mqr6?0U45~Zz
zF@&rX;rMt>1!#A6f4Ad&I~i_6y|2@o-`3eb>VyKVLiwr%TmG$%razMte9-kXj!2Ko
zHgHoB6A~=vW_a+&Qa8tHpqb(Bz)9hMj4+K%a7ggJ%MIA35#A&4S&>>xLHQvqkpEny
z1OW(GL1Y=02~`)oR=$u|H-_P%cvGlK(2=krU_-06SAibmyi$FK6|j$ckLp~$J2va=
z0GqpRZT+bpPLtm6V@65DGcHco3*jpVE(MfCh;5H(5A4Y`6`MblY}kwnod*Z5$QWRW
zx03$~aE_1tvOs3>1*6`62%coNC9uOSqO;#}`dq#yVlelw_bv5^1W@#jU+MWV!!L-0
z@TEyaSPsN%lNwy&H^uq0X|FFm@fRM-KjP;!T2%DYBOW(tLu;9AdTBM=+{7Z}y|)&t
z5K`a-_jOrPoG(A&PPHNXXCT(RSLKnqTnHb4J%J{B<`~Qd>u!3R6XJePHh8Qd+fdd?
zH~f%eCYP4Lmvo$WmyPNmZ;KfkQ7Q#o<05wXs<C?Jja2e}uQpnkFcG4#Yv|D}|F~74
z_nxix$%*1M$r-uuPY7WgNF#$bUf#S!ZyDet-!Cw5f-y52OmW%#LM5@;PUbo$*9Dk)
zeM4TRz?AXfgdBhjpQnVw9YB%2dEzphc>U|H@4D86e%k{wMRA=}cwsNiX&l77x4O%z
z17R<0%6(`*zR6+u-Qa?3M{WaFMvYzf;u7Jd8ZchW0*qkQdw=i`-Dm`TkJlBlSz+-Q
z$cQQ2u<1T`!7;m>m6m$spY!lf49HQQ73mLn&p=~ZPl0{y`Wc3m#??FHJDjQhg%8$&
z3)`u`RtM^ygI3(eY;S*m5!A*nx{X<JGhrVSQ63{l+9z^iSTN*~E_+;62z<f5rAwC(
zE61>T`otG1QpuP*f~*5>;X0)~mgTmJ+CLq8`@RDnzxDqYkAj=;um}V%)Eqlqp^Kjf
z+$_o9-i6S<Oy9(QPbdF`<^Ri`OlU$J06rr>6*lKJH_5>#f)<b7$i6qJ#0i4|4M7MZ
z)&!klh*ttVP#PbXur^uaf7TLlmm$PfzyBGedml_zZonPgFS8E1Zq0i7N=hS|%Y4_v
z|40$9|BvB>b&2!XbZmLKn3;t~JQw_uk|6$mNb$2&x3Jz3v1y+zBEJyPoNh@P%EkKm
zXW5ecmXXOp5f#gbo48ra!<;UbRBMesWBehP6BEtJLB?2&67o-NW#rBOalwbx@Q%i>
zR!EBvkK~TZSl9d)VzX<Nd?bjkedolnoDz6Q&}3rx?+;(X5;07r=na=)%fOFu*d<$s
zMqFHHYk~}d6C@$%uR0iia8ZJiZO?dTxvZAMF>%j-;vt&-JMK<AV@dN%>n9Vunw49K
z{C{Nc-c&X@nI<KA@iKAMD-g<&s~XrZN{Y$|S-NT<J{0ElN61sA5W)(f{AxTnmK%Sv
zE1O7-fUy$GnspE+7Uty0W0PfZ+!l33!a;`gC^q7?F9*xuN_t(XFVG<fZ-q6BfeX?9
z_%Ps|+(&!2&8caWr7_B4-+ob71(<41!`rf+clZc(*4!T5lo))<o(s=-Z=ZeX;aT_c
z#A+iXMzJztK~FC}pGlqe{dk(-pBhX`I&7A_x5D22#xp6V(s*J~(Wt-sk~_^2t{B}i
zTht7+33C}5F1>Qh!TQ0l+lOS`|NJ%aZF}I)5i}qsxFGQCC6#O?7&%}|gNpv{D;pyJ
zhoRVMKY&i_AC__}hZs+t+uHna(|?G48+}v(v8?_Pb9%&C_^6DWe>DX*L)`BCG!)Nq
zFUE2YbaFwP0}ZMDUSAqB>T><n0;cGn@?vX*>D7@@Y2qZN#$P0e67^-o=fvJ7E0bFB
zBVZY&C;RHY8cDz%|2_5p0X44zaetTt+B<kng9i%~Gb?i6#EJX`zMeNa7)SQLVJ~qW
zBLv*Nnu~-oaHb!tvL=`HySE+)0!&q-OOU)?rFOcXhuuLNL$1*~SK0eM2xGY_jQpX3
zSdIQC@qGD7FA=znVth=PnYpy(=fo3(a3Md1YUeZ-N`rE7=qiP?zw<;?;F2T6V7eH~
z!8bQVJw~X4zVSRE@dEt%c=^uY5x0CpqBq}F@=uw0JCzHzJ)eu^%G;L{6^YKOVL75`
zjq+jNa`R@4%!f~`M-hphBYZjFGjI;Y<DLEy;414rYHah^I5`NLQ=+F7<NYyZe=Hq*
z%f*|2zDnfbej27+RwY<{IG_AZ*~Sh;p_h`W@?E=LUoU(oDk8-!(YH1s@=~HV-E>Fq
zyM(a<vokVWYuHjF1Ki#M08C+aV>LJ~IWaCVFfaf@HJNn40002w(L@Z5>z)8NzP)7X
zbGo`zikKBD2rDm_RRf*UZrE}cMK{VxX2Y2(^DCzby!g^%F$qbGo&=vHR|;eSU~luW
zf&M%!>ngow7qL>)Ng|g%yto(U^sD(W33mNsBMSRajQ5dMFv7Zt0-yghKbQOA?(MXS
zn_`?$fMJ0ORxkuOD`8ug69^2`9i0Eu|Mrx8E=?!M0000003Fl)u?f#dcLb@*{V7b;
zaq{@_zZ@@ce45C7LX0xY^@l$Y@m^rum)7>Zr?=~Me6DX<<8!(^K7NyHuiWZB@#gY8
zo_{Bs@BHJ;^N-<sLG5#Ly4{W4UhUgDzE6?n4>z02dtT5UvFrO|+XL4g(0g96AHw#-
z*8%N+2=<=Y>%DiZ4_JEP?Vi81^?-Y4tO4!%&u9nndt=%j+uD0U?Y(gJgV*+edtSTN
z_TJa78@743Ib5^J%icCUpgpkmp3~NP&tKXAa=gEDld#>(<no@2Z;RqRXSeHsJ!b#_
zKvY4RK&U^);kZMTWJf(=6K#+KG7F*XyItOXCw$?M66^*id8aSWvZvt-Lpg!hU~QjJ
z9$kfe<}as{I_>s;kK7wDUg!yS7`Uy4<*~804)E}onjCuIj!BK8h<CVw1>1#0<HY~}
z|NsBucyF6_L!kp)R<j_dB9AW!pJO)!{Xm<vA7<PfyruZa2KPp(VG7lhnE%O1gSGC?
z3FW!9CVdm?S#1^!?pw!A#BIZl(3z{fr2Du!-=ETG`;LhGlrnJ(G5`Pn;(jCef0LUi
z67%@jMSYsv>9*iRJk2E$6;Qs<B0Q~UIiqe_eg9uNgMZ%r9GsdtFhoF`h>GbBj75vY
z-lrXL3&ivDaeVgIHzY*dJGo(g5%37wxgY#9apC$nJMx4OglrCx{@|O-+$<`KIQ)D&
z;2=#-4jr$U(sfyT3Li`Ldw<=;O{x+<f=b7XgfB)~+3<zb-Vt~*;fQ;U?!FLk9A+Th
zx5Qr=(xYJx5EBh^O@!7RUQ0;f-wTMziQ+Kdb5Q2L7az&OCOQVTaex4KTvd=iZ#P3<
zit@oJ@e^Z0pLmQX!yQPFGrRy}Zme;+jj(laZvIXkLj&R?KmbH-nqU~&RgN|XxWR0F
ze*~F{l7Ux(`G18lk&T9S!ve7P<<zhJ_P3DyFY|q>TUy?}vG!rO=ja269y=bCG$#yL
zz0gVe1KcJbNzL#Md&7VDclbubLQu(<{33H`KC=RPqq@IekEgH}Gm4wrZzOz2#N0*`
z<i7DdP9fd1$MBDtj%a0sR3VRqGjUn}&0;yMoJ}rFL81S@h=_-KCMEE$!s12IYf$}!
z*sZU}+HFY_BG%cp{{API$IQ_dwYmQZ*$zphc$3c&eBBty5yWKX#Qe%UEd;M9p`EI?
z_qd*U>@<o}TH+B{J^uE-9Z3&+{s}Y*h$F(YapSU&6j;v+%oTbU&p-bRdJE5hEcyNy
zjQ;;VK$mguSJ8}xbWYohv-)EEX6NuzYabsNV*s%eYc|68Sl`kjZI?aK+(vEQM6*K~
zA~3ftjQrhQ<%o%dGsI)~?;0dB+G8{={t=pkvEH$)4;V4yWg~@ad3d?W5N93wZnEmm
z8Mx0kD;BYbX`QS`Qyb>b!P$!ZF^Bg^ZtHi6D%1xWa?RUH)e{T&;YPUE%liDk5v@MQ
zM}3wf6U6w@g0+nt#=5@|n~#faB6gv8gXq!GofVDEJOEeA5`Cs?;ySR<P5b!(G3Zu*
z+l08Q(?6ShM&S%M5hglB#1V+i&Evp?@w?e$zP1BmB5Yqrky(M*c&gK;b$2uvll@<p
zTc?Q4&ER&j@Rdqpg2}()ym>&I^_HSXEu`z{{3!(9+f!j$;|2b%>nu9&hqVmCK@t!)
z0MW;c!bj>?jg>g0FMZ+vW)rF#ap5{X?u*$NyWoIN&8njJ)RM$Ym6=&slX&UnM1B&e
z2_K**9tia2p#cu^Dj5w}Ib}Bh7mVl2yp7WL1A`@Q;u}NAAxT4Q;?>(He*XB(eXu1F
zdEu@KvD{~#6&=TWh!7LmRDw9dS@^FWL9R7GBJ*Rd7H5}b$_|;htFrG)<>u{zN4t36
z30P8r8w2o`5{SqF{sKp+sY8@fwhotvy|$Tvm*p5rFwczk+<8O&hOyL_zHv7J_x6KD
zsDtqT_e@wfcToZDuZY(sE6EWP<D-ad&zj@$dd@l=_uNydc9*yPaTl}jrLn=$=o-O{
zO{~{v_m4@ok2Qqvy^#nyh>qRO0qs6KZ2y}+w-zUT%^c@EnZ0~v2T)FS5c^X2VsEtn
zvVdLy<MjbIUUFsG{eB2(EWY;_slIEw2lDjGtCDEc(c*kaPIw}m#PC}s#ba6`M`mft
zkdYZNBJ`D|hMJs#3!2;)*BK%rxa4P#LN1viBC`0+-FD50CJ;J)e3&=Q2WP}bTK&ho
zIpy@95*3&hIM}Qdcy;0<vNSrS`eJWtcy4$oiFx*-HOplzB#6788<oq6vkum=FppGR
zu|&g+sSUz&M`V0OWVpX3lYMbE*p@t*xhotEah`0vvV?5b0FmlDnhF?l@jPF|2nc6~
z2!#h%U=Tw5j>&X`w-0>h-(Bf2xh|B~?~^_+$CZJlAKxCG{8o;%MTg|FMK(Sc$4d&p
zfcGYJBtSrFyR-CPjXr7yzZp`?L#hCm-EOYNMsN7fAR+AkIc~r^EK1q{_91P6?BYUs
zog(Lm(U6`l&Hh{m7>VLF+<u)YVgxyv9wrl&5&0~P`z%acH@I5`qugC?8><mqR-BBR
zv6^^8TvwLOgncQ^OU(E~K|(9Cq6K|Bd4k<68C@DiTtCrq5>g#8hvbZ$K5k56SMY`K
zL^<osipFz|tC=<1Yv$^{5y38vAV|@*7)K(4L8EE|u+msv<^eJP5qbI_!~F3uSzMA}
zdh7F#3n?)sWc*eMJv#>YBURlh>>v31{FB0`gT#E+i8NI47j@SO;r@<h95+mVT$#If
znemX6XRtrrFQ&!d0jnQp;$9_fZ?pe{<UicJlBe1DyrX>%%&v>wc<IjOR+vaS@4F<s
zXG<aM)@qX5JYFK^+a`&{QjHnHk*l{c;`(R?9BT0&vqp~B59VZR5lI&-FmNo;aRO0+
z9Z37km-uLgFUDcmX$M12F@&tu<f$yVVR9e$uknzTIqC-coclP8$L$7pXS^Z2>GAD#
z$<Vw(UTq*THM<!IV=#<A#LUdh%+5bUL`PW?6Tq8nsoU{8#EXraAbaDJnIbpBR+0~H
zYRv3&Gvv_K)m1r&j{LA0(Q%>1GFZMVN#b~m<d@BpKM|S>yM>Pj8J`&-HUzpe7t2l`
zWIekuPPwZ8<eoMwBp<VvG(0*egYYNZ@jH-3;SB|I(U+GcGQ>i0q{`&Ocsp{=S$Iw#
z)b<#J{}9h^NND0e8LeQ(83BwkDLg~5CIUxFXx*uSyxBqD)BXMICFKA3N5hHwxCr;7
zdjOf>7!$TQr|flk--(Y9Ve0~P*42SHgYNam<5GH6YBZ_-TcTK-zDt(5j9ws?sjPUI
z-zS;P!Zys9Ip8}7u}6VAjsbunn0N^*R0hkOdcd76&iR?~w3c7@tf8R-?Rn4hP{}>k
z7#DH^Yv}w9-(7z5)5YDpQ0x%Ft15%Lmx5Y{VWa`AK?@m+2y`Fe4bC^qJR<`lS6SnA
zP)*aufMfC%`@ct6QmOZ!1lj+_!my38(LZqk)h@puNN28IY#y4#VtKs0ZV`pzGva56
zgy(@Fxgf6*c%PQ0jL8=hnVTLxrEe3&UMl=e^U=Q~HMu@o_(OxdDnFO!l>OL8%-ETt
zBDa-`j^Y=DIFmi4B(q>IKJ_aUWZMG!j!b9DLEowPPd~MAyd&Wg45h<pu%L%W>&!VZ
zqkjc5f&r{x<<}NZ_kHwOEAAH+<KqmnaiWIooR(v4dgj}h&y2)UM`Rf`eLJY*1u1g`
zO_n^pUNb~r8=d?kY<Xbw<n<`3EsZGAuTt8V_|1G?yT0f(Hx!Kd`FV`K*llgDS||9M
zz1E%~%meQ1LqFj;n`d|Wr0ZWDfN$v4U`W0f*<mTl7&`C2r!-w}SbEbRn^gpRAMboA
z*$DvvM}VLrZD*<!@tE!o3BY}RjB7NV{jI&+t}`X%jRx{0SXr5Mh8`x4@J|pX5{QE7
z#8F3vW5AG)4BdQ~l-KV`WaB30jB04Gx1X&D0UK^rw!ZRM3)+$sRNf_3!*4u9zQJxe
z{v+~KcXh`OBwfh}_yA3ipA$a_@JHq)I1mdAU=V;M-GTJJown7uQC|z~FUE4%3}wtK
z&1^y3voTIzP8itMcK<mjuPA%)krDC;`OXV0<16os44s+&;r467n&P~8V66j4`dm-V
zs*^l+*|8OnXxhOJPz7%YBn`Z5B5VnCf0H)S@8j?uiXja%Nxo3Xb<4PWe15&v+1FYX
zREunbR@zFa4c0{RV~9VDg*qp02HvzUvXJ1joxhnj*~E`O_2p>y5PT&G7^W^Ru{1Ux
zX`;if6T`gE9MkzLdgk!Gee7{Gp=d)3cRYBWC!P}s34KclY9eXjkAV&&HyLdOYPQuJ
z*CJ6`K6(AJvw!Xzqk&~yd)HC%UC`L8N8_)?Oro!xKc1;B_$3>0`0L#>pStB`?yw#0
zZ6A)l2bdrc*Zf_ZHL_P6_ry)f4-@iagnR%e5)kZ!@E93C7#TOsT3;tfxrocj9~rlC
zv2%$0BaL7q;r*)Exp}w+UZ5|jfpu1QH}~=M^@kDr`|b?GBf|rY3RzZ6_^f$4OoPvp
z(b(B;htDA+^ab5?g}Q$TSJTf=;c2Uw6E>@E0sv9BY59a8kLj2Bur}1U#KJh3fa7kK
zc5_eoLO+xypIeLw6w<<#EI*dAk5CRa)=$qD#j}+;Jj~F0a|GX0rIS<5<-S<W&(8Ak
znBkO9tatiKopGa!N{8LImO$cv)0(aSn0>ST$s<E2jhgX#k-lPFC44N!)L7&XuS!R0
zuFFV;b5yQHF95b<|6Ov{-MxN4-SJ#F$uk{FVW_zwoy7+Zf$~*y!WkkV95nQHgs^%;
z*FM5)|NabLVj(T^KJILMyhccYFpM#{Lkq$gxT=Is9J<33M;K52^k$#LiR2JdjZJs&
zf~mlZ;|9%m07o3zJlvk~sec_LRl|<H@?@ZeKyQbyr-+34C1pi?NS+`^gnUQE)E(tq
z@cDUd86qJLNNYSXgJxb4hwQaspsX7JkK4H@Z^0{Kql&QW)W3Zj^u+H^WeqD49RQMV
z4%@uIpu9Z%;#EBcD;Agdh>O+pB1WO7^t?nxFqaU~?O)S>`J!Zop=>hnIQ&dT7{Jr{
z<_We^ydlDiQ|YHNW>N4Ge~pLyUh;i*p#e;j!c_}+ZsJDt^LWn*neBm?3k*KlBW&#I
z4%`?faVCGjov4S#eH<dxfeX#wQ#3hy%t5pSqtsETfh^7}9F&}9wA%_*PVUd~^ClZ<
zeik;t2gP@+@QqG?E%MoUsyJ*h!#pcL9k&GeGn~zVe80RT7LR%VRq<SC;ijy6C)r+^
z@>Q#Egmq9Rx&wY&YM@5d#v2;wICZHX9rW+V;l%s8q#<20w)n5dc^AbqAc(#y0pHZ|
zyWSurhLI*+4p@_fw<R1i)Nsu|<;28dKJRvc4kmm^jNgB^TqTZ1^CV?61oC2jY$d@^
zJP1q^eh}{FPcWg4o2&T<y*1~TWhtyf-_MtilLw=7Ow1ZFhq|%mNr;J){z!2e<Gj#1
z1FYCUhkyb$5HH4fdF*RCKCsDdII}K!ekOm)`gh5eRq%xD=~N}{XW`%fm$^m{gmN-X
zXv0ty`U1p;2mL}nwE&~a^dCN9vh7C-kbmMg18p9lg?$_PKuX#J-fAL-C@?Gdi|6<9
zb8=wBZ<ihS`J=3sviNa8N&bF+xY3O_SV;H4(%kO7znIGl2+K#7|NOjZ@#k8Jldt#j
z6K0E6jC}+#rcT6LpX`V~8RqbWi|{vRavUxQp9#N4_aN(6=s#mO^s^iA8NXD%+*Nm=
zIy({gs3rTosFZ8hP$3HwJS#sPjbT<3mvo907kkGbw0@y(Z#bQN3lS5^<5OH?GS?Xl
ztUBp!+b9wXQ2wTKQe$K&lP=JdOXL&YG6Q`A7lfdp%ly0ivF+wQz1h$)tb=vp5Ve7{
z<8&S-NC&Pshp;6}q3));yhw}<xiYGW6wg*Go5EIbd33YL6hvVj6OBjkm~TW;N6mOe
z-Q8~!d?%cP8iX*yVaKO}C86*WRpZ+6m=V1J_;As&yH*B$jhe6>+2P`9HQYPvD}g8K
z1g(l|Krx?;!X_smk-Zxq;5|D+*Xc{O-Zu?q-nr@BRYpexVda({`LUc73F0n@&|l3e
zL4lGnyv$GHd}=k55SAZ>Gwe6$&{Pa+3iHx|(px0>R6_MXg9fb3f6pCjEZ^sE@suc9
zkp^aZ{Jp%%en1-UE>AZTUF$eWe`rgQuU#_{8L@$r0Le>?T*F4Y=Ks|80l}=(ciJ&G
z(tBDiPYx!zrDY7=Ro@Csiw^RUYsDp4m+3Dp>ypf7Ne5W5WFQjh>Hi8r9pGo$8@@WQ
zARvyP8Rsn+#AkeIaktHZ=&oOnP<>6;_r>^UO_+=^MrVRJBzkybAAf>h1lnyV5B&50
zf4(s<oBWX0E<fTVHW7M153wbo0%BtE*?Vy@;GzEo9y^(n49MM<Gre)}6CO(Xk-h1E
ztNs9uS0l1?p`&2)MqlGFg_2yhp;nRM?_GK0vn$;q`^c~B@b4La+CM&G^Q8Ze@lelO
zu;A{K9Qp!5hV*I>2gY<Q?c^Ldl`hkmp_B>m3i{W>;qD1Kb#31D_G0Ltx~1q}6|G_E
zc@#9AYdj(2zJx|>1@G}VJjXTHQBUp=!I|kenuz>IN$xW~j)=lIMk*u17`zb6$%f7E
z@gYAn`0jedjN=0*l<lX%6!4pdAcQ~h8F>AUqNR6{&o-83KfHw9w*|D-Im7GyzvDQj
zRRf13?a1U0kJX#{tIc(?{sa>{I>R3m>WNs5TI}LKA2$PAWVk?Fpmbob&e&seL&eLp
z9)+x{0#C=}8!pS{R-VtUylmz02JwWuOh3NPNu0C+?DOTAOSy;l+1azC0qhZXPTukU
zMISDb-Q^{)OU!oy1ic#f8eN-ocnn`JPdB{yL!jRd%I_%xzknASH?x-bR|x2rTml{F
z{R|8AgZ;HYB5UC6T!2lFAU(oGiBI;Z5A6s4a3<W)f8VnKC_Qjd;ixzc2{ykGHuFi|
z!^e1OJy6nmmCE#}7`nbD<gQ=;60v-g5F>U6w!e>>_!9B*7PN)n*OmNTxsT<oA#0O6
z*a7?P0X<LrWw+c_;V(Kr7d=P~*-;oA7ry_*Ex>GF4z|04`|A7wAP4VS0%1=IVO-{E
zE&wD6y&t<!HJ|?D0xiIM>j3Yn-&62eoPn%-+1K~@L-+T>f-20f|1@LY;!7m09V&?Y
zTx4gVX*R-o<j8&;^Y~H&*zWPy6|{bU>V1I=0qnnDbYJq?_Kw>5RzAR;cUp$=0gJmf
zKf)4mR)Fhgja5B?*FdW~y$<WWa_inejizEgap-NsDwIi@_uYu$9+7iNrVQPt5&XFE
zyMUVrMIF@95S-Z^$~kVhnKK0$jl@el2?+dQ_?n7qlRoUxE^5mU5bmai@e*<Q8am`v
z-xqUxvc*cf0EoMoaDABH<)Aa{^W~a$z?Wr}`p~|~tmU)DWI~NKF4e+GlZ(IxMy*E;
zn%|ucL$p0)h`0^sP|cIaeJ0?WKKouek8rmL)v8P!LLSt;0KI+kUv5RKc?JR__38id
zH`<3BN8YK%&}*B==R75XXV<O*UJUAsi2)<eVW%At1OM3nb3O^lUGe{$#qw5NOtU}2
zchXn~Q`{d2Ge!<`US1kphPe2R-xai`$Ig6<=2L_}pfA@D#qW^+<x-g&2ZTQ0HtWJL
z>-Lv}#0T9sFAW>Bt}2`znH#{;2qkE2J>u}wEYf)2PB*_Nj$_@E-^pV?W8NXbb)H>K
zPE)<}cz(IW7Jcw>$zwd7$uSW;U}We-5go&T6GV83C(DAWN2!x17(V;Pan>Wmn$#oB
z%}Jxh!_3rQ#r&Gw8CYjj8vt>R=58?><L#bNsWtg|;a()XS$uz!DSbhI)#APgZAERY
z{0V-5+K(MxO2#m?Qb~JceL!(qOTiz9eJ)vT?NR@iu54^V23PE%$Lu}|coTm6ZEiNO
z2%60qx_{091^;M|8^`hSlkma;M}Z%|f?ws`f_0cU(v{AxK5W>7RiGTSpSVspAU!zw
z{*eiux0_eE5BR)h7MnY#A&7Zo_{7)K{@2du;Vwxq_DrE4#paa+FHGi$-!^7uXWWS>
zxQVZ^sE-jOwev)0h{Bjg8RNLO7TCgW&0&mYF+arlqfy**aaCe=wN!)1%#6NlBh2t5
zdL7$S9}$fVz>(v7=8b*cR2-py2yfmqw>Y`U6XK4rVp7=dCYdi#G6B2mUU-;?H@5Pz
zTPS<VMI_<xwk$iuisXdw!d1Zg$9N!k3#kVDGruYy@>+jx*%Dwnngl1VY!K}Az)Qi%
zzTEs2;XeV$G=)}wXV3n4-|Z0yWB87hTI)e$uQV?<cy2yy^5XtDc-J2??sJVHht1Ic
z_3)dPapVvcS|J*g2esM*ttUKUuLJpL3(4azFZ(GV3b3DbQO9!$g*TFo@7$RLsizNr
zg(JCj9sCFguI=By)0sbj-hj`SN_SWvzqf$zYSH%dUD;6^R>59nZEm>Z%cjb2@%}!T
z)aRueoAJYE#A+k)9Jn{_YgcX}Y7TJ$Rf)b6kt4Di&yqNqZ1)6^h7`mEtdK|9<AX(V
zRFOrfj}a5e3E`dv;<7T`nh-M?*EK^{SQ0%Q)Zh5Zgv>t>18$>BP=Gp!40y_87(hR<
zm~8JWj_@Y@vyqM;=S#3~WPN7$XTV6sF&|m<sBYO_`MhEQ<2-6HkPH7@2m0U!N3Vy+
z5#!M_QT^Xy8vOx!$II#i>8FQW*m)3xnbCI#j=?KnOOSc7XE^U4$$WUf;hsMpIP)eR
z@w-DSyt{ua;ef}1;9^{42~4#IEn`@X$uQaOmz_C&cpv=L%;m_}9KFDgyCCm$tJlU>
z;XbL(L5jFvpGy+q&%5+QPrQWB2EGuRDaX9bAEPBC4lkNKn)l0eGKtY)+QZ=7w>#bP
z&j}1q4khE6GSo~~JqWwoo8kl(9;R+$_(QA750?So2~b6Y=iW$-LIQ6PS>&F$%-#o_
znKaW=v;P}*{$eZ9I+=&9qvnEci_PJ_myEKYgR8azef9T6Zagb6IP?Y_yUN@+tih+f
z^59IKB;5oMt8DT8%7+R9cD*loj)1*j0-e^6{^6pkk9&X;_bcW9`fO@hWBb*A0O3FX
z`~Z(i&qzFXghvio7ua-X?L`T`%KKFr2oJ*;jMU(R5%@#IVjmFx7@G)TN2Z>dfBqyx
z<INc&GjaI{f2ZNp0OwF;3X}+FFuVWw341LbfA`6(&~F*P@*Ew7=Y7Z7;STaFA~u$O
zJ8SwtZ{?eL&8%7~e@P$z0kvu`EBsd-#<)aLyV~Z>6?h;IkIcpzR&qD%A^0QghKFZO
z5&NDLPvn(|{&+v+?H@d~AqVnFKKU(!+5*19MLQ__SeJ;}Wxa`}Ya?vhj>*DNsL6+i
zIW``sza3XOu_y@7=ndToACMVPFyM;jRA>K3`yd|G@c%3hb@)e}@$G}AkB!7cEnt5h
zK0ll1eDC67Ic?v=7ZHfz42HnNJbVz8@eAs5+87RZ`2Hi#X$w#7JOLVABsWhm{%~-4
zMYDbo{zv~_aU<l0yhTXhXiF{)7mMYOQl)V-VWnlv`KEzjVJt*O1Zar9GF*t4W?Ag^
z#iJ*Wo)OXCNob?GZWTGN6@)Dj0Y<CS`Mdy;>&@%m?IgXaj}D3c@!Ej)v%~qYkA-0b
zu1|2oExF@I0mqm^;ujFHI4JPX6ZvHE;~&IwP(kFHDolB22m>$qI1J!0-|(h0(oN#s
z$d{1~Q({C!M~@khOTs051<y8bVamGrLU<rKhUt~LhqDOqcd#U2a7^IfJ~P5THx{?r
zXtA^)?q;we>DKyJeU+Ie52k6J`TxacV#ggZ!n{?EW@m1AE)$~30j)2EqBjwjgtnx?
zoVs<(BpG5kyj(;^NQtG=a`r*+rm6siC)$qz-V?l)wcc}bIk))&FU=V%3p}!Mjj`{S
zdiejQR0_+G8xf1t&%f6pg;{)`_@Dj|_mkT=vXNUcu<qu);mL(Uvj_jn)#Wn$beDjW
z?NzV{ZTyqJyzui2`bIni-NEC>ez-~rxB2h*X(r0E0bE2^ABIvnTTX&a+E-bv5FU5<
z{)-3jdn=`iVq*Z`I@%HH+5`dc1{J>)z4OLg!56@MAS8GUO5OA`!3giwUL00vGyhhA
zmFU#(8GNfn2_h>)ssxWi`l;^2tS{m06ZF+#9T^{9<M`gbTL$wG_^NW4=_T@V+J0Nu
zXMtid(I158mpmhe$H7EGbHg3ck+R4y&F1CcgKS&IsbdgzS9QGb_sJNHrH=xLLL*$8
zCPjuL#KmKmba6DYq<j;`M_(#w48WI12*l;-)#cDYd3+)5Lv#DHv5V#D=J2BK*kgB?
zzO>=>cQF@p4iB^Z6=(PczAuy9Mf+Ycw<*g}wpt>xpx?-O$$ifMhne-*pO4LiyqsFV
zPY6#EBjwP~mH3WJT}gf`hGm(@b>>nf&La`{f^dfuDG73G%R4ZU!rp#NK-#iN{UJ$s
zcfjB<`#S&D63_`+jhq9(JNDfqz0<_C(tnzZZU5pqblo(b&iTA=FoZ^2Pr?(ziIi${
z@))>?j3*JSOq`Mk2=LET5P@+5eo4qKOj>W^OJuXd2x=l+GUbL`oUUxp4cV5tyiJcK
zkzkKll0tT<Ilp`1xAOas6^#e454>I!_UAg=J)OYU<cIhG7@GG|3<dhKNB?#u?fuR~
z4JQfK3CvXg)jjZ66@;&{9)$Uq3bR6!88F0t5S}DQgfssnc`?0tIGWJ`^Y~>Wmihk>
zCMD|}MzHhJ0SjNBeOO+{9bRghCNo>*%*ua~n{)Neki@7~4j(MYb@3h|ZpbynUTVHC
zlL#16pWX0DBM}o3gt0Y=1pJV)TP~6!O=nxnP<Mq8o=a#sKbD<M6~Y{lo(nuOLy3yc
z`fz;ATU^=RJ){Y9c$^D}9qDnA0lxS6Bi2jJ4Pq|^62xM$5jc$exPo!y$2<6e{cq{t
zD0W^g0woTY#N%UH8pu<8-ndIlo6RF$;ygv=kM$FS0GogWX8W$|{{@w?`7t35Ffw(n
zOk7ti(Z{n<5SBN0)++H4UON#<`>t;oobZlGT?RuKT9#fTT-CtGs-76f+L(Q_$|gF9
z2W=@FJj)W_^0wipWB7qL52=NR-zsBRiipwQ;`Jzp3Gmxr_nCp>%kdME4bP*lE*BZ*
z<mUtuV(z2OAJydKiQ`|Ewma(Q!g2S~h>s&NgwDBi<>)s5{{z2sD!ZEhBngPl{vcEc
z`u5#_hmvf-CCesV-!?>sgJ5Wg%oy~!cshg}%h1qMKCp~jA%boc*yisvf9E%$SyMOu
zqPZuQd3kB2XNic+#f(0tb>AJ~o!B&Nqx8^Fix0%lpN~t|7d$@%j+rkTRZvLrTLM-T
zq)lf#22EA5{1_H^Qj$Nka<7ee*#{n!sgz)|pYh+pC$q;sXGv?d?9;p8&bH+`KzMfh
zpWHy6Ap+x!37`DDBa99}-wXobhaGKzfH&po{<*l(YOI7OmO4a$`sJ7~8UUz)?_V?~
zg>g92W>?Zz(zc6)vF*ytYMx$ho5B^vWnNIgU>@>h?*20yItdyLls~A1*a+br@r~d3
z4d3I^A4Km(b@-fLF@2rfCChGLt9{ot$&p|PA~1#~A|qIW!WVV-&k>)5rh*y{W)VGc
z7?bhr{|NBhfd;k1m(8WoYbXAwKtSI6-n?b`$kC122mG0|YJno%pP^mmqA^_OhiTTt
zb7~sv?>%aXbnDNwAmKYy;=Ji@6t|T>`2KvqLxh8RMw2AS*`&|-uN_Qz7cT@jOvN6c
z_g52?IT;X9(;o?)-3HvMY+^<}Mk7}~zdSCE?czj9++{Jfir}UQS`MgWi7-mk1!yID
zfUiZcLLLzO2f$!@l6`Pw5C=wlpzo4<6<@nU-P}gv1o)C~Tuv*K+TDr%G9jGG?DnhW
zeb_g-+7Gh>{cCoA;j*7{6Stc3W^)(W?Z2=7RqfUI+6><8+2CWB*7Z@!VCg&OtTQN2
z=&?-scG|In)L@I>{3DApWKHx3-NzmTAWXyYC^<Q_YIog*x1IkLp~0Oo4_abKrU}iR
zOsw#Q;SZ1Q^d~DVF2=XQ9o&AOeEkI9|9~<LlOqSe$<258iO%)S$LXvD3A(S7H_61u
zP-_!9#LkgS*K&X2?2RNAl4w36TEr}qt{8$pF{F-lDuhk<oIwI6;{Bhkw{QHjBU``z
zc=XATEUg~%#C~rJ)$?c@v>k*nt|o6>mdLvvFM>XZdTYLIYs3tkGDmq~U^geP<=zSk
ztW+d%2)sx2?`{>DYar<j6DNNJB*_%U%ZaX7{XVf3&8)wO`{(hebtib$5GR~bJHbn=
zOz%-#be=e|nk7ionkvW!Vr<QKDwqGst$2~pMGG-6dj@4m{`<Zr9=`qNvjAEJN$H;R
z_>6quNH-s@efSRDbMRN&2n#8r-fD6-Y)2JvzdnR}e}p787#Uh;G5MrZ9B#O;H<^nc
zgtPtQ^ua#}(`RO85D^0d^S2R;!aPRt5j+uDNdt)VxQ~-s@QBWdc(JyVGXPq>uYW%q
z<`@n!W-4!LX|%`>ahH}5XnOV@`7*JWiKilo7#bO9B-pr^>SIK-cuwI-&CQ?O(I2^6
zdgaFj&mrDUZX1%vf*nNb6XJd{4@8qG3S`E>Fs*$DUHKAHCnOu@u26moAr^OS$whZ~
zJ~OA(JGrvB_nJj(h86H$X4v9mtjU!4oB#47!_DQgnuz>O{%FT8eRY?Kh=|@1hI@w;
z&Nel|7taYHvW{GQ1>$d#bO%WqGvWa+w55S*^tgjrnVGpUBDtiqOEw^%obk69yi71D
zQj-4v_g+xOI45<9laJR9Pr(C6t2XE-@avVK1#&`0bujsnKizM>en@GS`{TSilW6$7
z|4%PS^k?w~mk~eSIy5c_COgT51y?3D$&GSjO-#v&Ejc0gAE*3QGaXcdL#SE%E+gUG
zCBWdW5{gc~*J&3MOaZE{zSSiCfbV8s{Abj%_Oe2U4PFuv;`I@;UQwr?|HRF)N4ISu
zI9Va&saS5c5%DFOS>h%m4MG_>LzVR%$LED&SEAxE94Vbmvi=Vmr-P9%zTvn*dy)_2
zPBR=fer5+o4Y`c&qxg%17-ac)pMop<Q>EmjL@8n=;v=EpDPR)f;n}FHA^comFj`Bl
zkIT{_A1)rnQRLx28uWOH@e<M}scdigx&|=U&1{?bIVCSOtc0I5c)3hgtNceL6pYy#
z=8ZIcaFsPPXTvk-<l#AVo}&iciZj276|uTNBW~$$*?*fY_>IIt7HBfyz6hkiJKpd~
z$s`X7@g<+^mL%C&Zq4FiFsw(2f*y%`;V9B#x;?sKK1kq&ulZ+(#7mCpsl<LiBXT6s
zLN1;ByOI)co(SKQ%G4n{lT9)tTEwfzMBVRk8R9Z>-tyve{v;y+`v2)4M!0gpD`T!O
zb-~*5^9T~)&PgGzB5R{c3}Pa>K?C<S7v%BJVlhz?XV!T!Av}D>=@pnY!6vFba}SK|
zhWf)`^X!4O9Pmi^zWSUk#u(51XmogivtI^SkyJRduurs1Xq}jm=sn0f`JNS?=`#y;
z7)hGY_rj1c!z)qx;GQ3gi{qx66pmKmql7Fg!kAA)@Clyy(W<mab9QM3gD?nLeWv%o
zwA9{`EJmH=zc_}f4~?uEUDxGU12C(c+wPP2R?=cSFq~b;P=~TBLfV?ps;Ry$zyLj~
zW8&ah-}$`V#CVLNdhd#($;4y1Yp6yL#EDfd5UfFDQsGKxd{;awbd*A3GH}*9m@6=A
z6MyTC?S}fn;6f|~8rXX`nG=+ofO~h^x8Hmqgso?&(2qakb*w+Y5&4NO?D|iTMWLdb
zLA5^a-=jno{ITGBIAB>{@!s`@#~{)Ezm8q8jwDPK-`gSV3gv)o-S#*;<u{mueU&aI
zHiJ+KxeH6$L@i?L_EI=B@A7m0AVeX}#)0Qt6XT}Y6T|*=2Orr>Dg=)*nk2*FOI1~I
z{($|ri1>91KB0i%{&Uk#0JG6Xu`hpozB(O?7XiM*ncZP4wOSu^M~8~Zscpqdxh0X2
z!<C#z6XG&+PalZO5sktyz9+=Q;$(<~=`MJiCXk*?BHLHQetP02zWFO(bQIPgk#3*H
zaGkC{oo)9=zgK#HjbH|j=>hWRn4Y*l<ueJ@$K*YyPe&^eypbexLXp9-9wbB~!r0|?
zK&r@s_~H#B#P#y1nMHBl8La|-M04n5xDtNR^R<dDA9<g`R+ti@(kA{3bHio3)+7>N
z4Dq^1Ls)}IqOIaQPsDt=J_xxnUNR$in4S{qinLw`sEWjp>3O_x$hd%p+6i}iZbM!&
z+l?Im*cn|T)iz{Kpd@>M|MFJ$!Y?J_e+YNm@95A~opzlBP0-#=W#8bMZQ{Ivv-vnd
z1BY2uX2{4x6^NgT*+PCF$Q+9Y(pM+$o$vlD!`s3He)<0>1besC-(?T-J-{1&<P&{!
z7lVC!h?kD#yiXDF70EaMd{uEA{X}5L6XIm!<c3IYY$O|qIMhU)5uu3j749Q=kCILD
zar$XSV>}^bqirUC8))Uiy96tgh(TCHu8-Er02Xtx^Jf?vUqhycvJOD!vMa_(Sn%>4
z9|i*d86FTUqasC<=66WA8w94NM5yGw{AOBxpf`0`YJ3J4zK6qi-SG|fL!CVxqHsiL
z3hayZ@<MkWnXMbx5PY;yk-<)4qA_@hxx70MN5KwsfoBhkGq1*YBzv*1(dy5grflK|
z;r>_z`J=z127Z072}EGa5?dr3@FyK^{xpFOf5gEZxf0%NK#x05zWK5d7-OyoI*kK>
z)*QW}fX?+>{&);}uqSYRrkF_OsQ(3AgOGt!9R_$FmzR+Nz*B2<mP+{ld5{o;7uQcV
z^vpgKvjIBiQ~ZV4)?$=SHzBYk%fMJ(G^Xc4hq|47b+N;EcS?Ie9(yH}xqFTC%>Dk{
zLFr$KiJp?Lgt`LxXU=S1up?Kccbq|*Kl>;C3aYb0fCZ7817P%t>&!R=jh(pAB0+%c
zAul!@MQq|Zd0|{5fJ?8CS&o3cX9Pyuv;t;VU;I8bO40V|9YW~W;w}53{{j7ZjJ|A0
zC$O!U#%X=>%3~qMN+b6jZ1`FtUQ5pLaE2J<k_Uv4;!Vj4;GaRsqeDT66vuE^d8xi{
z6}XMWOD23r;b>;G-lcZ>f$x*f$!VJbvYO?tq;@!zaB%w{|2C{ZI_l@+b(v^XN<?}C
zYnU<mXP)rSmS=@$pD*pVsnaMTHV7~4ihv%~>qhRIB=AF!>#`BG-yibf^p<h(_JH?{
z)`#*aKp+VtVKc!Kz-PIJ2Y^wC@g5_@c#jeIiExJ#lMz1!nP6lOj3sbqz$AMEPb}lM
z`s07Kb6_L>m!YWakmHXNgbw7r&;*~--$KE?F}nYV#Kb}v{x5Dsgl4S9;vkPceFVJq
z5i~<zmy@dbx%A0N&5%G@St23r!B`l;%Tsv!ZR#LDMmZ9$lsF`DMhKDZ|Bkk&$uyuH
z>8<HqQNT+Ce-Rg!K3Lxw#HLo~2mEpAEW|7ZFY8XeaBMfn>HyBP1aLIDv-0>Si30L)
zqW%O=eeM7J4<Mu`qrh_2POF?eFqy`<o%8wp{(dJBi2OwSC4mcB?@`icjhNtR1SjvF
zAO3F%1p@MT><G6e;sz});!o&cx6pr{frkOq$Pl0Naeisy94bO`&+W|!XM{00l54jo
z3C+2*+fk!1QxW1KI&BZH-!_nH()^hIIXN}d*Wz#WcQ!|9_qM+k-TWo<3PSzP@tshB
zS7`x!u)BA2_$0YAySa^u;rpBcoghVtFOKr~B`E?F=&lSPOT6~CUx6>MJ`i=Dj5y6+
z-x@sEr{(aO#blBnjPD8XQ{w|j_NI<0ByCH>NK-S;dlk*gPzS2afSu=#@JZ2wU?d$5
ziTDII5UI{IkKPgD1boxNNFE+uNqlTI%4v!AZ6(?Rr*`H=@%ST30%gy%Z&P>Oegcm<
zuG#A2r?V#y{6FPbXXqFj^DjX79XMsy9B8i}&(<Pu2=d3J`$XXjPZ~43>D0zSR7Z#s
zY}6otzn_v>Qm#pr5iH-vUbbqw)=jf=#0P)WXd(|A8~!q&o4{?<0et8WdU!%@gji4C
z#zY3c8o&^>f2m&=hvC>uWuzBS%-Ec5*(sp+HmAKU^7I6j_q!U1SpVZWvj`Q@uXT8g
z#vfl-d+?9`?lA?p#OpJ=xwQ>A5BD1MOXZF|ay9w&xCy|VW#~QcE(v>KgkK%u)FH+`
z6X~IuWBrkKz6?Z$iRRwn4iWI`EP8ApfySgj0AHW*ONWpaEeW1t;Dq}H&47iTkJJJu
z^any?Ks<I5u<M9%0308$`a|kT85>gY@!E~Z4|coYpICZK$iUe`IZz$zbb!O-CBVzb
z8FLOzL5{qSjxYIxx4u25x&l2+J^(i1fen8xLVMOCO>2n!-CD#+aEuVyD7je;o51i>
zGXAVXZ@-I44RqiaUV<Y^X2vjV#`0bWLL(K4`DwRk5yApy=JCvU?;edvsd`s&ToPd*
zqsGR~CQIQ?Z~!63R)y;`<y(q(LYzBTZ0rM{meen$gjg>D&nG}ftY^ZQHKauwjwO#v
zjplZK58oHeFP1cC;jeg80!N|Fl|g22J8c479Y8g0u0lNS!GO%ode>rloR_{f&`jG<
zB=MGt)!wn!>aG0q<bPWK5$ggH-ad-sr$meCQLzWuG~tKw5J%u33oGMEp18_=PhDDP
z7$E2gRAIjYM%U4rTV7;FGvN*~d+C4i^Syy8v~CpEA1~W>COm-DWYxBf`cH*mNBqk*
zPU*klwc0|3F^`j4{9NGxLWvWp8TLdXdz%r9iTqv&+eyQt!S$q1_>OZB%6fxI>S?dO
z5%8U#87K)JZ5p~jF^~nnqe;>=EdTh35bj%ZXZR0wgso5xfX@@R{}GdqmE`0)#wM@(
zu3FBd2K`U^PX3q*I@ciYN>gtcc>_``Ol$(Va2LhcR<Z&FhsY~C-^MJ2viaT0L8wpT
zTtB`}YJK*ad?Ty{9+@`}L=YioUhodXto&qYuuZ&gtA^)?wfFk<XUQ+aiNAh=>ha?x
zrsOpq^zX%pf<1u88AZ^aEZXxKCoU56$#$U(PbRg)7)lV-Mo#=cyF~M9pd)L5+xqZ9
zmo5psG;CH~Y!GM&nSFpw*6!VExVx-a?6ZOe*ZfJatC(-cT_v^QNDAz}jL1!~{zshU
zBV22rCpLc<7e5r?TQi1C?Rq&59xsx3!{Z=1;%WkIT@Zly8HvyluSvr>|0%bOq-2n}
zHVf-fpX8)V{9lX+NDO)vm{H;HU*aRogC2!?40Q_5yY|!o2k+x+boM|rc>Q;?u>9*~
zErc_+Y5Z2Ws4OjYJTVz2z^iLq>~vyIVg3@wGc{O!__)Tu$&VQRKJAYT8~oTy9+!W|
z$Tp7334KGm2oJ=kXwrB1BvN?G__z$7_Jlv?{{lx+6|5_}`3m#jBshhkX=CalSYs{x
zMBZ3pKLs4PJM1c_P6xE*oWqI&J@fPb(cs&b9Y-y{n9+@49}_POGe_d(&VibKC-6%_
z8kl<Ff1N%rz(j9AKg0q$wu6uIF~6l>)E|uK5E6Dqok1JV&{1ji8`)9YK0C|qTC@CD
zbXxQGp}$Y_yzvuAAUb5`(~&QNdNLTP1@FjqsUYc3g7?P2v%$qs`>~@}|J%0r$3q9%
z1W(z2(^3jxQR+Hp5RXUCUZoiZgQ_0}2mThSprmDmN4p#Sxu{LU-Xs1ei^#={sx|Q#
z_=#wt=8f?fKJsh#P=(2^@TL&q3|<lWV@Ar{mvI@nyFuH7#_J8k1PI<YwNr^nnit#H
zcHwC&4cWe={bMCzMi2fk!*JdR;OK_62QICHmvjr<98#AAhQP1Kt`nf1s&VuGh5Cdn
zl!nl};1AzJJny``Bjfv@<D*z0jUMxY^n1_Ww{L%c&ErEij_MK&HaJ4`y<vYTA768@
z>{!x1yI4m@eoil_OvUOT-q0r0Io}7oCFuesDe-ehm5P44aGJ>XkATgcG&%oQJ_O3q
zxf^cuZ=Ff8{z1F8pNoimmJUkF0j%~isCaQbc96DxE#>7HgvJH)c7wAwi`ZbFbSx9K
ze6UC=eGuA_-4FbC2_GI4e?WJg1dCJBZ*4~PuYpxP1AcU#;x|aoNI$OcMJz;B$=#eE
zv!Rodo5yfY5Qp5Hc_Zkb5q|+))PFaROI%l*7#wNI#CX*L)Xvr~h{l8mzte;wB#Z<b
zvKquqmS2-JE=WTN#AJjq7?tXX5-Y<>WxwKF9!$)){nST^*EY2$6%O)Oq52tLKvh`-
zMsfB&t(E=29?t|G8iteO_n#(@gbX|>_>6|+Uk1#kjj-+S_*yzNvcTeBgU_4dnf9#9
z!ag1Wr~h#uf@!b{DhvPtwSH3aMX~+`0l7W!lr3p%s)A{2=B@%wxZdsYz5u;_eAp7T
z4z+|@P65EcS*QqFq2O(UVM>)#C_o{UTnzf+D%N_l*9t~+=tVK$iQp_LAp&j70OUX$
zzdnIGGmG%B<vtL6Y$j*)Ltk`Fd)>K@*EV~$tr2ttAV|>uOe0E$Q>g#=-O`x*#E(Py
z`{1u@WqdEr>Y!t$#8i|xlE<NYh=|}x><>%ga=gGq$qRfj5tat@Ao!lHf(BfsR4aqN
zK7SDf5rb6`zCeC@2>za@_YoIb(3uLq7HMu6V=aUt`@;k}C(FZdBw&IsgRZ5PdmU5<
zN|2@+Lty{Y1NYfKis@LHcslA@0peotFXFZd8GUEaIN#wOSpjQSFdyd>&Npf3`bMW<
z|M+)^zkisg+`l>i%jxLq^z}&9&gX+;V_ftyKk*r_NCYnAXFL9}pf?Msh$fEF>#9uA
zR+!1gv(j*c@S;IU4CyGO#E6n4HO|Uj6P^@D!^1oY&CxpL%=uO>BKb3ANfCyj3@r#r
zr9Lc0cb)B2eosvNBaP}0x3ql8$(#NoC$7gC>2-SGfNmCZe>qG?h2SLaj?D#;$wLkF
za3l@k+Di?h1^m2bsKvQ}dpX%w+q!a_x!;@Ztimnc-wFGBzx-tKF~!I^i(<7Q@%%sN
zIu7Kz_}%786XE6O{6yXwNx1ylMmgdxiQLfCN9M5F8w3aPMg~NVqf{{;3DjTs@@I}t
zOlwc#e2{q|@i)Q|q{I8W11lPlnRoKW?|t%POZbylQgd}9$;}*>^YET+=HJUolrMy1
zA~8`I-d=h-;VBf}WJojo+z@qpB#}Mcai9LUoebTq8`-^+nr@Pzd#NOg#6ory@S<dR
zC=j@uu!rRG_r>dNlbFs<Ng!#O4$l*NXp%$3U*a*~LSd<l`M5)p4;(goqIJU^G13*h
zxVifJ<eE9;UN35Ija}X(m48+AaS~<j_=h13XD&k&94tg#n$yV$W1F@TuvMNN)*X{!
z?7}1suXcD1{1s(R2}r5Hbb7NvhEt3GkB51nLOmTv;hTNiQj_{*lp^TXw@D^bNMHG0
zl1GBsH^CXb)2)@#<-}_eUTjyv1{+%Ov96~b=*=M2l%&`hw(dW=$4G`5a9}^<FC-OH
ze>>y|nznySv3p3Lo2b@G!F&fFRDii}`>ad0`8gv<2~-a1Qyy+xYY_=c2S+SF#p=F2
z8o9BlLlcdMnsY@nCwwK&#%3mA@p{nSczyChxp|2Y)*}<aO{SYAAd|+<0F|htAQCB~
z4Xg-R%P^cXJ`~{`swFcp9Bu2hU8o8~%aRe{G)*@Blf(%Xdp750$9S6M&we8XF%oNk
zH$0+ngl{&mCS4w?@tzy&0cH|p&5a6F;3|0bk@W%le__o2?_6fJfhD?(coBHhCp%IJ
zo_z=4ybQg8B4!%@qd&w6@h0$#2VQXj+S>vq;mbh-1>%F&6^u?);*g(XN$V)WHfjIH
z(hS~18(qc+Xmcrg+<fRWK+$p@=?z(UM@GBz{-UO}^}%KVk5&csNi;OQh4e`#hQMjZ
zADg~2gxTGoK=SAwL3US~#~iX2ZV<fryWPU`M}GG^&i_6&iSZ?(xga7V@@sAKM(%L9
zkHlYlZH^hJiMN12-8<#rr_F;|5%j%n6enE+9x$7H+eNS6JL7tnGAM0ln=G7V0*Rg(
z-H0%et4qoprw{5%4__MwhKJ%gr9xOI_$s86HVy=i;r;pq--E%QO09e9E$Hi{`0a0|
z+oErb*l!O9(J;Xn(c52Sc`Euban8fHE1`5RxO#f`V|ZiXj1zK3jN6%v`Dvw1admyU
zqc<1i+c%HndtfI2TjUb3rxqKcrUh>GHCUp4DGW)U+v;k>-~Tt8Ja3yO@Fz9<Rsk@f
z4?tG1C)e$Ny3r0Ly%+fTzJ9l$AF-!X48}$tBA1BbV|+Wv9g~7q!RZ1L_Z1`l`wg=p
zU(Y;IKJ5F(J>@6&@kHYn*@J49{~z#;u-%*q9)O+J*&v0d*;vbrAS)<=zw3m%C$I^i
z)Qh=)lag)PH#R)A2agx%ljt?~QSP<_#6dM|kxvh}jFB7Qo*VW<FeC`<kjJ6E$l<b@
z($`DNYtqOdlyHMZ@tpns7(j41JLGS6G*qAgs=>JvHdkS%6{G*)mPXm_=lv1Qa7IL6
z*AwD?Djt!`t?pwvyOU~V@<HjDSf3F*L_LA}N2lb4n>lj~4VJmqzrdO4XMd@nT7Tgj
zGY<hEAPQ+mYDB=b+Yj)}hp;6}z0zu(-GARN8(nagw&sFZh>1LqCk|@ZC3%!yIp5>8
zgpCG4H-B!v59Xb*%DfZ2`EhZJyNv%G-J4mUz9kWWI?mPv#KHO>?g(R7iH`7-MVlwa
zQxvfPHX-ldYeY_F@eoZhkfRlj5MrnMh=e?lo*5xzFf(E|5w0i2NP6@>`6<)B<;f07
ziTd=MBYo)<MH+o|;YkaSe-}9g9GMO>$zY$jQHxh5Ae+_VBVs&F>0882ZxF@uVmbLU
z5>{Zii7S!|n^g}>$>HA`Fu=?3G~$uiYAqtW2qjJ_9;T|aQj9;Y3oU|2PQ?rk=i3d>
za5Gw^t(vf|yw5qF<A@Qmy6r%K@Q$3auI?uN+Ka++Ldi)BFM_JwOY!osi=>FWzI`Sj
zC$`elnU~3%=7|&X+lO1NUN+fOnT`<R<OHn`Y1<6o0UZKI?2nJ|ztv?14TJ;6iWCa`
zBTFJ1*QfZFnImcbRv3eVn`cw+<iuP?_`f!D)R>CI!cc}7;;&B|-|&{BnL<4b9xf2y
z3~LWS1&;&<e3qdAe&iTUf8~W$$cmSiz$eQiF`8rICeIJX`0;@3nj5`lzoCt4qwlO7
zs7(P!2dPX_R7ICYy)t6<V`x9F2r3)!-Ewq$5#uJ&%5=|P*8n%&Z>-AEs|7#z=v1%0
z&-{~fZ{W8rH%0domLtS(x%{kOCU5whXC$CyjPWky;GYC7H&UlmQHJ&K(z5T4@BAiQ
zs$tDe`Wk1J)K3g)0~i%pK_sLrnbegJps(=s%(-lHCO0{V@fwKVB+<>GC}RY?7H!6c
zokm5-b_h*E0QXTv@Kp|a!YzYg55Ru5+EhSB)Hc=$_Rg=1?{y{b3<iPZ38>Rw{WSE`
zABhC?DPiWq#cT~$LXnxK{;vNSq}<`eI}DCA0~y}ReP!nd+JF0qUXOg|zRRDQB3Naq
z{GW-*iKvWJA-InSYmBK(Y!N^_#{yP(K){9jfc;K3{7;lYc_ZR7cN)*lr0dbq7$u0;
z6-jGNFO0{`z^*}hd6TVo7}lP8o-;p(XVBw7jjZopb!Us;x6}>UJkRxr@er0KeoS!7
znj<tv<i|4P#Km%O1^IRPf5N)Fza~KOfkkaX@B(|Ug<0Q{BMjnY!V%FJ*owcz>B_<u
zW+ePZ8{opqF!<*&n~z4XjUe<d6QAG9$q}9+E6l{qRNR?<;xRq)(WlMSsDd#W@i6BE
zokA7?QeO!0U%;l`eFRPpp5O*%fUW;FVZO%a%L$j*8}jcGXW~uEf!#^sDkBvLV!0(m
z-It!Y$&b&%7Fj4)*w)rWrR0`9@>d!X98E-Jh}1{%+$T2awUr1`5WxK*8p}Wb|9|gv
zXs(lPHZKq+^qH2WN(vO9S{%jc5P`OXsn(Hn2e1}Ks{3-FD7I_hxZ72=DQ)@j9A0lf
z4>;GW^t}E@J}hsCJj`U|IB|1vIXFBXFAyBL@CN`7CzHtX9s&Fx$HCz6JcpR`Jbcd=
zhnNn097hf#iQpbU1Igs_0q5c#Kpq}vfbcxtXM>ZIfaC!+HJ+F*8gLF=c^q8M1D7M^
z#5i)~I61iklYzm+1Ch++4gdlRGKAB@DQs(XzBz*N0&hu~YNVi|iVrtVRj<9D8__pU
zvDKoZn~x{Mo8!xF>vJQr_&yF?egWo<b{zTg=gW^Qc1>nuCq7(U9LF%=0Q2H-1DFBe
zc#jZy9z(<c0043TIGhKF1I6F~008#@wvP9d(C}~F2d;NJuXOib=pNub&sck*MS;Ko
z07$k$nqcX2UGVQ4P=$-Fg`RVo3_lW?hsJIY2h<z+GufC==AB<fiZ~*+FJu0u=n%m8
ze<y7Ec137kWTwDlMnz~}XCO9vw7z#)y?{mTVZrt<kYVc>3<-PFx8{bdwwU}y+El;)
z|Nk#l|Aaec$i#Q$-|;sZGlj*(fB*mg#A^}p7>JMYI-iU2$j9S5#6cedUwU0{ekLon
zUNuBc@vORjD^}_jrZITP2|qwzyl=ky+k{S0G2hsS(Y>xOn0srzanxSzPk%R#oVr`t
zUb-ysQ{Ovk{q?N*e{hHY|NsB-Kk+g{yfs6^N8@=qw75%<{kt=^zA_?Rp7wm^fR|!a
zPdwcK9MZ&bksbk#9T?}Y!_b_(Mo4CxtVgJsFq=V-=8rXUKkp+^D>fMYMC6H@h;5e?
z6L10pch-Bpzw-Z%;Ip(eV%#&f2L$1!bz0bP{=>qsLEtjWAkTUmXKyptUkFF~|Buf0
z0%5luo_+d6AGDq0{j6$$?vpszE#~}Im){x`fhX(@vDbpW)8>AJ5i4-)C(w3l`56eo
zJ$0d}!ve<$!c?tE55gi#B(I(BC&cO_!WxLp$*bq%`Fz>qvdG4^3~b8`@Z%yd=M&*G
z7ldH}xYHAN$x1LXUxd3uhZJqcSgtB&WDEqXUf-7>ferPG2EPQ{WuhA|-aiP-!DoPG
z`+X}gt16f(>)-BEVs@kdr>%pdzrz}?2p)t%tU*P8hUa(VX6C?&qsn+MF*8`~Gk>2>
zw%PaIuN+7qi2>vF>ivfF)fK)J!3%H0SXhAznAbiRnQaMGxvs2ud=%s3eY3G*MQPg`
zR6;x-=(W9IfB7)PbPuZe-&k=H#xoK~(yzx*h>iFth{SVVwFqX2&&^{yDgI4rZaX2<
z>e)j$e%=yr0e$=t!Y)fTCA=xcc)EujbyE1~CiBKxN?wP$e%pPDd)QMi&5j%Zhw|Ep
z{0I8$!A^8UU=(^i=4Xaye{N@mXS*5fXubF<+o%#v(mt5JaVqB|bY&OqH(BD1PM_+1
zpBwl{&}bbTrr0^${hyY8#r<_O_4s)YQSsQ3^WZ?(w>I&aeMD8y6HyxQ&mBZLAVS~G
z`muxgvIYXx9$z&A9NpYtO-rBofAJm=-xr@_&;UoKZ`xlIOU?K~@r;w8ge6}_8><ZN
zZnFoh@A~<;oZsf_lNbC}eHy}T&CEd4VfaEuwOpcso7fQ^0sgyQ01Qj-$B^OW{r}_f
z<CeFvHwj&;qTQbn_=%EaIi45Qz@A;$CcWbgAH+tqp?BQen?K>`3<~X4*>$=rHYENP
zozf?&%`^JG$Jw_&_<IOgg;;LH3iGP?{I}Q2IzDLdml1;)&dh~sFPoPO4|um0@fmzq
zH;Tu1H0sBNFa~|~iM9XyV~i93|H=Fl(zl;Yh+Dm%2=4Gi@E)vK9Oh^Ve%t^BDtSac
z%Ium#hjvR4C+<GK#Qr1A0kNO{5$%p0+o=ST?(qvy<CgI8@zm6DKAP{&`;$JO+F)VD
z?ns-LXN|V0Fo0?!-rD5O6KMbM+jBJ;+W642SRjub-w97a2!oa#;zd)XvBDl6&GDU0
zf$p*BRgM?JAKjs;OU4ilHxOF@0Ds_vQVJ*pkz_fcfLjE<185=Z0umv#2fbOtcR|Bn
zj~>{mmzzAKG4k`n<-Pn%q_e{jn~KJ%nZ3UgV?D}RV`~}Ku`V)MIT!NZIzY@sm7nB@
z*ZbwfgZ$Cfh_){mdp^P~IGK1)tCLc0ZZ7#_SVqK;8Q~jy0v6lA-@UMmPOwPu>hj_V
zM+vi~^5F9?1QC&#V}Gr;2yF|_4uHZ2A2mf1J1BTu`}=KuNV9mJ7qOE#MALxu>%%KF
z0WJ1DekD<F!`NvTZ4-}AgGNr!<^S8OCtn>!c*W@d9kH@>V~5KR`LU@)K9b9Lhm=VA
z%y^eYMmZR`QdNe`FfR8Ebxqoaj|?X13t&@Sb~4#fzl#48hpY+PIP3d9f0{WJ#ASj4
z`7b0H94Mg9%m0gdW<}!pL<G6HaGVgt%=eR$T(!hupIp=CzY_>*5b%a4lKan|LpzpG
z_VbeyG)7J;*+o%#Gx5}^aBz$D>A7LC#6#8dtd7(Z%<qcjq?yUyiZpC|R^|PZA(_X*
z84^J5uH%gj4P2j^Y>!Pqjfn_J3n9yw!y41Wx}xH=8YMaWq7TVguZe`Ys%sgUrZh4u
z!r?C-eZZ6P-l`DiQK%pfzW1=PABd|{e3+!<$0dIeQIsx9(<V62iJliC(BrsVRz0XB
zc|EQ$7^;MG;V<+B&QnLl>hPr3<E~kGn&gduc2@8xt-||1%wFs`KA%@RuqF4Ud4lER
zdhQ}iD{QeF=ErfX5iid`am!M&J#~Ex$Jyp?JEr7_3TEOri4(~SC9)I5*x__!qhv0}
z=JD-3B|8@A+NZ>RD>7T5m5HMGN2`4M91vDQTG+qy#&E)PlqGWCT7y3@C(iy?#?^rj
zT?RIl_n@8KjA8kogdsD!`qj>%cUhx9h{tC!ZGJ@KHqH1Xcy&~wI7Nm$kU5cuFX2GH
zhkW+e2*E}o8#z1@=-gH4E^)!pLhs?X-m;9H7l_*T8oSY>T-lP6I^w))QVESNYm4(R
zO@HE}<0f^PBH9&le9g9B#zIlMN_Q*U=w<h0+{S>jXL<}~TichCHdfC?z6a!dbP6|M
z9?s0Sba(%m=?Jq^_E3A#LUWfAukcaE!V<})BR4%r2{K$Mo@U50AN3kQ{^byI2qQz0
zSU@lE{&0dCvMB{Y2l2-r-Lpeq2I4w%@vsbQZ0->^U~P^K6kD#&=|@B8Yq7YU+aUma
zfZg-z32B?Y&l14Ld15~`+wg`G<(^T6@g5@!aW^xWnr>z*H+`i1ynJNWBxtOByNLLj
zh}RwG(!`>kIhH>W8<XlhGxGCNnx6@8Z!NO$Q?g|7PS;Kwd~|ev{~Me2;K1K>zOast
z!2oFHT=Ed*M*fdo#JwC0`r~ztI{l^bf-fT^PZL10vKE=p$GelhAOd}X0F#=GY_u|8
z$N227B#c2`S$-tGJDy%LRw*1t%IBkk0FUm0j|g456FEaJJI#=XIH99-hsRL^_+|iM
z*YJtzgZ1x(nE&`kSZW(at%f3OFpCpO6LkT2C611y@lP@WKYhL2E;9seZf=!pEoYYu
z`mGw6^k0dM88S*U+eR^{gKo^YLmiMdP~W{O@IqA?@<d@%@_2u0Tvd(Ghv>%jEIhoK
zKjA)D-p=^lVtJ4t2u+G6+Bj$<qpMgVf{nP7$Xu0vbi>`Zr{PL;KY;uBkipl9gq|J2
zmEY3({5uvvA=_3l0n|WkhnoUtqw=8aSv`If!*{X_OYxDn`ZtHdw0qCQ-}oQecYIx^
z<CkxM?I(HTJkSm~8QPH%LJr&nZ65dK3LV4u*bWckKQ41j4lh^2@BhcU_MQ;XPgSq~
z!nj5i?xW_!HZzFN5%A4KOANb)B+hYhIPj6jjE)8c@d7xSy>VSrj|2()B@FJxqaiXf
zYnnggn~$3=L*=U|Z%N{AB1|T=p96XS5f8thlmC8laXvhmxlN7YX5k76luJ0oz?h=n
zo-qyHz4{Z(e~jotdbyo_y`}swr-W*3je~)#Vrb!kOoot8tnPRCPH4_5rxc`3Wp3_&
z;SbGihMR8_eA*z-<%V7}D%79!s0{(q8Qmt?uezRILT>YC;e2Z-G<jK~LFj#~Z<c-|
z<fo0MMTtexpsU9toeL|hpcSU|RuV=3S1a}Uak$O+FoJI%qc#B8T_dz^QB+?WBF?@Y
z!49863psA02T;I!k&O>t{uITy@bdXLzu=R@df}fNhRy<S^}T{ecWn=j*bp~SJ_1*n
zRp@M61OwLU>*`U2qXt(6k?NaQc%}>m09<O=*X>yQd*#8L#mt;4|NrFpjC4iUQ^FY2
z;6dyQPw`jYU*bGQZb;DvfU|!r)I6qO(H<tRSV!cIU-@`aF)8_+K&3VL@P_k1n!*v~
zS?`S9+4sfSw*}vT_ci3?jn2GB936sUHN`{Ec$7wF_>FP+FOIXlBpZPVc-DWz{Sv7i
z6+r<q2%u^<(7(_pU&oJcPr{Qn4|Wl82Gy@)7&4s!2teLA<)k_(<%{IR(tb`3yZlTy
zW^@Dd)5Lt)lBZ<E*A?RShhvotzBbjdp_zaH7XSeuZQ;j)T^dq8s#a1HzP6gDKCV%R
z@@h^j;_&sQPL0kf=Vf+tRh{A73O6#kd}XM7?5yG$a$F(x>En+d1wR=XJ$fgMf&5xs
z``Deh463DXwKYE>AzcCFZ$heBY^z$&;qL%<dz0)59nY+Pt;1UA9ksdmK>x2?66B6k
z7)7%vH~8pzcAp#AeUDC{##`@+$CEbmcszOdh>sD3u#O|RjNFwU%RES*9E{b7Mg#%R
z0XUg>QX#h~Wtyamx`Wi~o}dsTZ<_v5F+9!i8RlmHS3e@I6`%eTk=-$-^At4zZ1uog
z{Q9Iz?7#sb?MA#MZ;sC0{WTXt=TXOmxX+u6X*CQ-;R@@<&D1rcC+3>Nvsass!?$O+
zcJ8TTQ=M>GhLLB7C-|7&tTU%5eh3KIJJ#Xin%<x%TN@ZX0@!#?4SJ2M$2J~l29=Tj
z@TV?K$efvhLF!j+&BGR=F0^VRiT0lttDHn9I->PQ94|aXUj*+@kfzD$(C)tl80>FL
zmKJGme}r+l-YltNw%5o5TRk6yDRu758@%S-#f*7MrJBQG<h(*^dAuo3{vWWHD6Xeu
zlk8w{f&Qh1RC>GOZ5Tq6t?QA7l^Hp@fga#JyF6t`V-CWYaDq}OE{SWzB49|!8rO%D
zHUzsmx+cWjCVr1^_)-wu^;9^y66#nZJr(Mc7{S7C(fhbk$!uYpanmctOQ-XjUj+Fn
zAred%t>uJMCP6dH#!LFzABf3`iV3NdfBys9=Mk18403AmF&TW2hF(cbo*#~l7L{ou
z9c5-I#AGoW#bqz7%CdhQirjqjoAvnYKi0YJ_20t={?gYK=Gzp^K1^;i3lSFwcnlja
zhf&M^U!Gh;hLK`l>pgN*Y}tA@!a7Pptok_`U%!46q+ForDBa0VMaE%V=34OW!Zl}E
zc@`sKxM(0p`S=L8yX&>YL05zc&-c0c161Ddj~en+EhzHL&!`t){71=$&>{EN&wt`N
zF+$LO;Q!6UaGPVefve$u`9JVW5Wb(Sl#lz2d2tiI3iyP2ekb~8`M)f$G{Aa-M)=#!
z@ZIo-E^gS?5VhTb{;Hp~v264%#3r%hI)NA9E;Stqd<#POMT6%eYXbYAfzoIC20W#b
zD<_Qgn+?cc18DLtiYz0OeO3+yf(KNHQ)wD5O5t!SAv{z+A4s0>0<hheXE7ua+S<#X
z5iS*y_$R)(k^(k{jm&%$<f57D?woAZKXOhJ=ko3#J?>u>+H~RQhi}Pehpex5>`Pn_
zR|xa1apQ2n!_;AbD%bSS{AC0z8~y}Mz(d>HZ(NtBZ9FzYN>5&wx@HXfScy5jFJB2w
z;xV102re~*aXc}+Atxp}zY+Vcp$tddpNsF!{F5XHczB3Q8ky{g3E|-i^BUQ&9G&o^
zMtQhSWG9BNBo_r8MA(K>j|mu7*6mmxp2>V8#dnedHh21e^S*Zu5c@z^{`ZIyY|to*
zlVLdcZMs*CEy%gx!%&y)j{<yLziXNvN~{>DCnWKlnV9<+_8`j<-48`mm4>9kyO$C<
z;(7g{fZeyr4Q|K7G9MX1$iH`>c9n*rGN~i+w2#fph`b{X(==@YY@=hm1fS8ibXJkr
zL;>$B+>P#Qc_ce9Ab;XG0ajgoKcO#4OOPYD->3!G?nYZ!=6|_k!S~I=9`(QYyfn)*
zr&C@CBJ>FNQ0qrkM9mpx{}<0LQV3xTCzsG;zMW_&zyIJNE7NFx|Nn@!s-rnd9y@C5
z$RO^+c<S5*s7?I=?jrDoc)GOhChV>}3HK=<OjW*$KZ9-GUpMHoLu~+iU3`tb<@Wb~
z<M2b}8Q%kf5#zcCgp3XdHI?hG@KcS6p!2=83K1Vn^W5%v&vcYo<m8-`$5?LRLxH{v
zHBdvP$lQr#2nG?kg#^=&nVpp%TxZ5X9;8^t4iI2{VVHOqx46N8!WIx+12)bq-NVB1
zlj^Vt!m6S5=OF!dsb3$rI*`&7N5%vX?~bma+mOyX+?J$LYpg_UMoc4Eh*A*z-YXG_
zo09~Fh0*a4o(CTsITAzbjqx%}5CxTdCB}^JiIM@^#s$QS#v{KSGtI$NBipfP*TUiD
znE<3}FbO`i?Ns6Lq}XS(2#*_7xeiMJ@9#K3bA(WO_VyVDMl>at9y1!i^rTTEnY3;F
zcSoUzrKkXHp-uag;T?#H#_}IoP``X%aL(*$fwq}AN+Ck81u=da4KOpu!DIw&@!2k`
zad%(@`UxE;<S@D=;e+?y>!5Ji=qbd*$H`rZ8h`q*5C@=5I{mgA2`(B@&CCgSN;N^m
zz&|d^Fi0c5YPuWv$&WrQON0b$Am*8?yUc7BVj<TEzoRV}J$P@XobVnfpJ(hSVgJ7!
zU;q$IE*p7}<6+t%RcWg;pxs<9hPwaf>(U5X<g{_`6A=x-$pF4MWleK&=Z8Dj9|1qR
zll~hTa2k5QpgxoYhSCGb;DdGCkN%&1Jm29=#ybWThSV`c^gQN@gH=$a`KOUQ@H?3O
z=>Kx}e0~}?XIe2efB;KIhG~X`1MZr=^TuAN04mm2+dpZt*$M^&TKYdtL<fW@Q7n^^
zZO5hJC8Ul+UP->&`0Fwd(VSDQ!2n($C1wlFQJ5QUXU1O*FhhG2Oge7NqCWx_>u=q~
zwE=zDSKaTi@^p)VSb;FMCgF^KB}%knGtHe%vvO#PZ!*+tMAT)vaz66$oce0^W>WWN
zXN70H_Yv9khk1?pkofOGm4)W$>5{>tHY4NZK8Gpx#{wRbl*o65s_x{TYE4Nm8BrT(
za$X~>{8e4GI??a418mdSNq?r)>W_Uq`C}ihVr%ENhv^_O`?<UOv%ytB3_CBA{~l(x
zzoyWDA+F2m<Zf%%xY;3zFR!PU_(E$d_Yf6JF}3bphPy9G<fQNJN82vH7w3nLMtDaK
z#le6|*TLSAh5A9tpbdBE4zLcZ;3raswW-X@|L!CoKtgH8s*8j5!AFdbgB_Io-SAW4
zJ%Iv*b{GhO`RQ~F!S^noaqex#{Jvi?)HJ3p65x&Twe?>gBW!4E!LKVL?f+g0zb;?P
zBYt~4ep2M*m<1J}CsX`oEWV?BEMt5OC}Gy<e+_RBw|M17UIKPs5PDxl-r8bNCr5(I
z16U$JP3k`q%cKEsUmvQ-UIW_R0fGZXyE_jPy&b{^Idc4*v~qFWW>?FMfcVXHeaMpb
z7n1@O(s}2`MrL<9*R_AIx*CS;)_M(FSN?DLkB0$?&h7ml2k`%Ji`y><Rm|)$C?E<0
zP$4umhre+gwu>}RfQUok3xqI9$-T|Vf*&&H^H4SpOY%pKQ?=v`m?MI_0|R3Q)yeCQ
z4@;3Lxx{lZ)xutAb3m~lkF#KPM7{FMA&V;FKLuZetseC+Ee*^F`#rT?C3FX{A=S*Y
zN2FhWmJGUV^k76f<oaf!?SXUI<30h#*0l-SEd>Ndm46>+87IHBWvZEp)|Zh87s&j1
z*%A|V6W!}3I%gg_$u$@f{Q>ZSH}>(P{DA9l<Nv@;><kFK@@=2*&>w$XztA3)>zlxl
ztO<y`5MkN(29T*E@7fL{H{*IW5PI{Gf3L^Ogk-vh;w^&m@8(rzh{f_lDPu;SXZS0b
zcoWdWLm)E)q`nfcQUX`r5<tZGh#NK{KztQMpMdDqnxE#(;N&-t#Zp9wEE?U8`&k#q
z3%)w(5MEO#AFUeLh7~V>jQ8~ZYxt7Zczjegixb$G&&<VMFP0e7QV?qKc92me|3)13
zZAq?5kI>CGbeAXA8Gi-RE4DT2H?lrHi_rqE0zCBm|KXH*!=SSaz0@K&jy9(N<Ai2N
z^cHD3vDw7&GfJ&u_r>)#SPX2I!7m7M<eJ`O^R{T%5k6`tZHl-LuA^4$`MKrSyhriy
z)|v3wd7~JNM_biQt_r?muG5a$_>VEZz90B+gP$E58U8Q^wfX`)0ySQP{y0xy)Fv|c
zCUm?MH>O7KT-Xu%1N=B@QthUff}UW(0!`;bgNs>R?7hx?7j%EzADc4<{v#I=;y)im
z6F4J}!gm{47CAD%mX#oQ!afX%aq?!lfJfh7(fRL<?LNNYZLj1UtGNwYz_+cb2mkIp
z<KZZIWX+f<8&85}OyluAvmrugVusciB=Cl}XXUbx#Jv34bo@=0^ZWgB<k44Sg028&
z-_~3I<mtl;9o0e}5W;*VrFv=jkAj^!l8zfGRy<&6*vGaXd?D>4A*EdKn~IS`!;3{?
zX9oC3s@5){E)FOIKTE5&<@oFb!_<8Nt1o=j7UE1D2Mfz76T19YZXvd~YpHCN21XT{
z%+Z6ZyiStC#IfYIo>@XwVeajuCC>N9coMgcG{BMg5BM|QKYC0r)E~2e#s&C({-86_
zprBq)T-eHlpE;e+!nh=C4XFX-0?hYw%K5LANh^gucdiJaA@_mHenHr#Q+%<g{gDY@
z(Q)wu&>QlGt#p0}@rQk@^SzYTyJ&a`f9OBHMkek*e|!N=ISz^ABZD$6-RoCHuNl33
zA|o|pr)@AE+gxYo<00PNgRZ55XV<o4MV9KD9nxR{T7KL_C;fkKcG$_9Oc08^?9-=&
zwO}!TgH_!__>2KIJUIJg0YBSuIX7sw`7?d+ou{TWX8`uRB~9MdxX6qaa`wu{o5rL+
zFE6euD+p>1&Vtjf3o`641PRNvn&43fLE{5@@sV$g!ZvG7aCt1Riye0w&JV(K-`g2a
ztQ@{?1df^I;TV2scLx=~;_#RxdA*2RT~&TR6LlWbUp45jg35p~*ZL5)0&TU8G{#9l
zA$tG4$-B@Os&BND&;M6867i)KMge=_Tr`A$hnItRXSeI+QCN&284;I-cFP|&X21S0
z01Etc^S>+*Hah2;K4}Y)agaXM3Z)vvWCuqZ+QgYE^Bf<-@_g_46zFtC@tzcu3Y>e-
zmOpMK6yxWg$?z0cb$i3KxHi*|dD?$jphRlEy{GsonOgWbKc4ic$~*hm7cb9!UsXl2
zXta_a9@OgO>S_6A5XTLWeo0}?5jQE6_>%JH%dFlL#@GKZ_<Z~=2y2AxsikGnz193j
zgeut;9Rs;$<>K~L%@N-|Zx3#2Bk-mGw!cZ`hD^|MY5m}PwFg2UX?ZChO=ex*Pww^e
zcq7rjbH-jD>J>&0EydO#YBQRn>1c9?#^@8LxgpYf-)mp^n&BM`ut6?EyfCf@7H0H$
zh>`dU)&VPj2Y<!Jw*PRDQA}VegWvrn=f}eT|M&r%sh&hTz8%VL5%69?H}Er0+6o*%
z0nT__eA|y-sps($Vmw9^ewun||M3&zF%RJfJq#Aa!as+(j|P0}Bex3B5PcG5zyWW&
zIj0M_073QNcmMDNy^5me|GrKoG(cyirKbUR9y4`oB5H1i%cFOgSa%>d>o!DT_g(c7
z)IH+yle>3`mLC;Am9fjOQ$vGX+aa-@1>!nOA+$qK^q)18r^IC82~5i@Y9pM20@vbm
zd6JJrd|o0I!Z5T%m)*h{Vm}cb7>}k|?GTrV<sgufOuyeX-zE~c_Ty3eH@1D4{6|(1
zJd$+!27vN@p8x9nM3|IE@Sl&H4-MB7<57h<mLDB(V7TBRdEv2-%4kRTh-0V=H1I%j
z7n7m->;f%%e?1>M{3G2&AQ5X8*Vg_yoJ`vu_@dx}|C%Ee2>e8th>j5IlN~rvAq4Bf
z6ObDfPIvhK#2bM5r}`SHzyiA0NJV`-%fFmA828c7c+s68H|lt()fOgr<O~dz^HG#V
zm9B3$;z157UrU4`9xpayyYyI$FUeZ)hlDVPH;azq{7*1Pr7AQ-;_n}kN0%G%ke55u
zB#PZ-I9OijFympg{Ypo|I1%qlw8iJ5c4Mt@mAp5euaFKkdOsTh2kzeVH1GeL3?c{-
zx3=2D;D!+L@NR`F90z125%7dp1X>tj3I;`adm3++K5XNECK)~VOa2tvq+m2>P#<+Y
ziO3s&gSol6{{V&V-#-iPdx#4bUm0XHY|$cc<{ci`*a<Suh7eLHwH!F{o?OQ9Y7Uhz
zfXwciZ~bj8e0r-MUqtx0BlBlR;z`wU8F(kAex93ZJTl6-POqXm86XnE6MiQ&MayXD
z9wJ%bG-brZVsRfXce8<bA?37jUl~`Hf=83$Hm!HOZK4w3g!(x~KoNOOS9nRnkH>N1
z4*{>b0_2R(UXG*5YoInNBIn?*_U60~{|}PaKweY3GICVwp~+rTvHlB#<GLsgt|lk6
zKiU6=E<x-9Yk-Pik#O&aWZJA82YAqM>QB)kz{nq7VSYS__)iE|CLWUmpyT4WF2m@M
zr-|6;B<hBa!gu&8^kX5r)_J3k&1OQ0;dr{N1^?wsG5lqWI=YbM-c-Vuab*67hSUeW
zdxQZmg$utl!d4mE<1ZnINaJ0JT8*?f@lAx;)Dke>odbVTZgl^T_kS803%JMt6C>g@
zSvY%h|C7VZFk~Tm+>nM&O=Vx*ScK&84EcCQXfX~#dlI(RJ@R4o##s*tdEs4g@snKJ
zm-s^JyXNtCiHPOd6R`^6tvQ)m%TJyDZyA~J?>0dKx;4#dyg36p=-!lBHWU_EssG@v
z(hRQctmWjj(fFHvciFim#mDTI+Z&y}uHg8}@OimfAIq?^m>?iRsZf9ZCVxny(?k4-
zk6V_19_Ein9P{*C59Y>_tP1;qAGDk6IC3|HF%O7bN1bB%Jlyz?mviB(p1em<hPsBc
z;H#*pJRxFvYY=Iv>+$?XBly02K4-!Id0>nFydop=V&Ae^5jPGtc<+4S^F2&i<N+g4
z5S4_S*h5(GAN8U_%fqcZ(hq-#+tnuWVi%>v#ljhQPW3zw3L?FCBwIIXgT!NEHRa@p
zv$2zsk9%txFD-TQ?{Y+D;Fm53wD~N<8OY@<M!VS$Ty1>bGJWAFz~ucCVXjH9r`O=j
zGI-svm8stL`uyMoNukKmQ14$z2s-!8<vQrCp*<znh;Qi|k6aqWf37P89|PtC3u)4D
zX9PMrf4D;~2q7#--rp~u`74t;%4FhfON4K@sSy>TW`E%hyNLKrfksS}PY?e7YfK_$
zZf<HngtkpHChy`SzKWYXKc{<rd%`)^NP#l)S5t8jly}RP7ZIK#3iZNRiDS946x|^>
zl`Znm3Pnlail*4YM}1%6ePf1xFmdf>f8sn%V!k`ZW=%*<hOLH9Cb)(SNX;bP0XPe~
zO1xZ7oM=N$94b|VG7+F*oI~-{#QeOI`wu((R1-X%c!SbT{Gv-B+Ed5kbkDY~h8a`H
zRF(h!H^MnEeGiE&!bqu$<gU0wEJhuOg6ks~*)k+0LU2hDCa~;}69~`CJ~JVY>($Td
z4XOA2=7DPjxF+$aK=xXd@cRC_xv+31ctd#zL)Db(U|$9UTZLw5;La!<h<+n}CW660
zBQuic&ABz>OzRN*5_x%zVT<6ik1GTQIy*zKG+-Fl6F+0%iZ<1wJ<8%SrjHvPFFk*3
zX!1@@H4yRT+-$m_zk(^{uY3^m3=!eq-Vph3f2;lR#2V_~bzj1COcio5ToLao?Kc&c
zyeNo^TRZ#{+Rg(xN0J6h!FT|_$Lx>GESZF2GQ?uAge8eLm!E=33|VIfiM|lck)#(f
zGY+i`2P8m7NJHX2BMj*Dqe_|VMA|~AGKr};M<Q6ZY%Lfc2(jib1b6>`f?Utf58oFb
z8MRX@aa_TG`0oUd6|fk_#RI=VTm+w~{Wu4yjriW+02^jVqe+@sTA)(C_{Jz<dWND$
z(5;~X{;|;@V1bYLfjcQTcme^`AL-c7=u3c+>yJJNFqy%)<u^lGA^nO*@ELed78Cye
zj~*-e^1)yCo1qIgE?RzEci+Wk5F&Y#Dd)pVXP&-DNeMWe?|aYR6P<|KVy!V^mBBoW
zDH+JkJN!>4uB764{W3fKwh#OfU|!($iK@Sk@w^i}@RGRx1h8<T7u7`WNX9&aS6>7z
z4vmy>mbvKhj0OG{gkH0=`0^%?Ij$`y#!A%`)&Gd*@jUm1=M`)Q#A+ip5QV~j|M@;6
zeb-+TPPA7pdA8JODtL+Ds3fALUHnXEH;-KKl>~6WNjzp}g;<bXajbVmW#0rCZ3B!Z
zV&vEmQjr{^CSITlH>CYF3%vKabYTZ-e~t7kE8D99&vk)2k>Fy)wdq#3ib<lh{Dby;
zI1m<f!<~i(>4rCz8P=^?<NSAZHWK;YZ`_MvsF9iBn)mxnl;8<f{|M!aVAWmuZM-o<
z!8sICpYd80G?FdDBAB6#;snFj?N#-$53n{bw*~L(jK^_PIQe+UsC1I+=Jnx$6X&_}
z@mxC&1L?<vLg%JGI*Fc6uW=mwSZ(vMJ0G2i*!A_Skv|9thvc#LDC%RKeiVm0&J3)S
zSdQ;P77n`95D!&?w5C%&3gx}uSKeqhW#;g9!$e|x&FhHA!x;FC(Go@%^RI?v<feQ4
z)M3f={|I?;lyyFSUT+NU!twP_<}+{*?D0z4UN;xmzRzuMfHySXWm}qN-JkW|I?O^Q
zyLZKI0QO-cf`gby*U$VdDD#b00~Ynq@2I!+xBTwXPv|8c8Rv!n8!@JBS{+_=xv(K;
zEDhU{2EV>?0Yc`0qVR#k@qTysC&BloLH5%qRLDN`#^DX{PvJNJxH_`%fi$ng{C{bw
zpC>k#q1wx;qU6M^em?N(x99Zb^b>#n07A9o$iw~eMeGF2%NgR|;wL+iLg0rl*<4Nw
zGGtkkEoN3!PWYJJrfX9g)W)?j&-j5f#WM$aCSdDHGY4FgKLy@eS(M_3JU*{nDb;Bh
zVa7<Rf#g6v5Ak`$JJ1ic;&b8q%LokryBzUp)2D-SBJMr;_TPBl2M*5X@^W83d3Tu3
zA_)6IoJU+nY)x`z{v!y(7*`115w2;cdc*{zP=!oyj>Zk(c7b`J##y-&W=uzj`1!i&
ze}@d>1$61mYd-6ZmRSJ|0rTSPcVi`>pW}*CV8KV5f~qDXW=V>LgS<aG@Y{foeIEb(
z9p3|q*B|%EiNbIHz=Ub%zt#~GZj?UXdIYAq|C38hn)htJP4DH;@8_?K8f)a>pN|6r
zu!Cc=xnnMl>$pe1ofJn5<z$2tMzCKIr@}fr)(Tx}V|ZXW|AZjxq|6<pkmirR3eudS
zES8N0+{`!eKLppS*urMhAzJY6=Na&(ZhlWDSEJs&%yMJ{+jk$XWP{f~`{0}OZUW86
zy!U1pHMbSc4~)F+<dlgBvUS6jNj?ar=~Khthf(j`MlZy~W`r?(B_7;bl?@N&l3a90
z=HjCd?WX3|8|isw3|{IZ;%4I@agI`S-h>sQ?Hl&>uAqv|9(bSd6=irvZ+<c}EyohQ
z;zeX#mh(XPMAHs06X0+z*m>Tu@F+C`;I0s(NnY@tJ~Mt?&##j+6(=7}JpNyM-wb%r
z@R!;k+x3!*p1%;W@gFSA=j(=ii>D6-x_`h^a_l&HC56o%2LZ@!e9MV((Gi$(e(Q;h
zl1#(~Ni5OY`dK)QnSx&%b5d-i8r&;C1+dqkS!NyF)a613s?l29cvCdQ<;{i_n@gKE
zgJx*=nj+!Me^o-~-w9}{M*Dx5@@I&fgBu#emdaTkIFAzrT(n4$?H@nBy$iz_xI^(+
z)jc9_<1lHFEp0C3i_Mwmg?D7+g^lK|{z&rY5EZ%A<;_gIBijgD;o4<8Vd64kW#jT^
zD5lrF_<=GDKvZDsl568gKPI-H2;ZN{$LhrIp~4LbY)G7RbgoEs3?rw{$&UN`t@K=&
zg@2QbiH-7OEghZ4l9vl@ViGwlgYQhKOgF*W6guFZxiQhq%*=UY;U5iM1#9ut$GCk=
z|KhNA@D?v2&n*mKjpVKF>*E@ijL14;(U6J01NWZeV$2UFX161I&GcU37QxSr<;`Pe
zxhuwoV_i&6k<S2CEn5d`A8G%@$IR8r<A1_9BB@rW<ikb%XvE7Ah{VZ>``+b<#KdQW
zJ|o2ZPaR!hx|X<)&BJ{-K|VisjwT@YPM;A3GqXGf4V@<sV?$qjIOI$&sK*g?|EtTy
z!`i24(*%r%u}>#6{v;9Rj9_5&ycI?~WWnDazCf@hXke`0e}YIw<`%4&{};wR4<Qm?
zmRmtgys^>4|1Tx4mN_3mMe<b1Q`Qi^E<YE@$k&~kN)h~BnA1mfKY}R24i23zC%Ec;
zEbo68XmO)%Aefc@2&2i3c%QI}d*ZgRoJL_flJmcb1p0YB1g!$JouriI`3<!AxA}O~
zWDm<nCRaCyZWH92=_sA`%J?VbP&R`EMGRfiVmw69hFFX(!d=+<y6(D&gfTdfNt#mr
z@hbmbt}8ZD9GBO8x1u}=!FFKH#3l2i!27@+{YmoQJN^7=By1z%ZuaED7ZZ%-@-~0q
zvO#%#ajC&RP~yxHv8+T7Yg_yDIo}L)7-?2Yfy!<!D$ifUd`Y`AXRlNtu1e}&OGRRf
z&DDIHhZ(b2it+ej6NreDKS?2cD~*@;5P30!QyCnW{7(eAA<K&kz7?ROq<u_BI4x)2
zQ5)vocrLy1y0i(NKOQt)Pz`2=0WvW+dc(AZW@~@^Z35D<717=Mzc|xL@z2_aruN)x
z>4YB)wdlJL4w3oe2H4w6-b?wEJn!*PNZOoc&FfC4W}H1@Mr~RL#Onx1BjS8UD~ZoW
z1Ed;6aiK|$clh0<^&qH$i6*E$);x!d912S;0MF~%|F#APEuk@`>jPI(!I%D(Q3m2$
z|HjfS&lci16>o-o?GMlTb-=*cLwcx8T}S>>{_evk>kd<!L_WA8hMNDwvK0r-r8EqF
zqCYf=ag@P1yxd$MCK-s-Mk9&NfXwOByhtv$o+E1E0n4WZPbN86#9pZlUj*^0a_BcN
z`ncNRE_A`zQcy0Ds!L3c9G8<khHj{)`)|^9fVC%<Z2!WaNwLQ{iw}Juv~=}t01>w)
zK!9H@>wNdYR{N9GNVK*8kNwBb+6Y{Yb?`&!Ll;@SaI`jyxusgof13;@;N0uu2%FSK
zgx~-CZ3mkBo+m#o?(d4nOij3X!f#vG6}1U?cbp2oq3Zx4Yv%_xwE_P{<8m?&_e<Tp
zJIFz4lXNEQEN<wC+S<~@nV^mlId5Er4LT&}*Zg!6v{ABvM??DI$xAS+UW0WgAA;@;
zagw&LaJcUTDwk4!jEvSZ5od`6a+$dq?-IRGhF(i;QI;Z3syZ0L{Fv(eMt<Q)o#8~p
zWaq4FzxX7UZD$7)E{vBA_ubKz%@az$jKDiN67nd~oF@H8zjm!eCPVV_1P$AHa8<2d
z$wF5T6H+i>czq8D(b$7;4$}leIGji+@uLCjgZl^_=$Hst125{~PXayZ?;m_eIy%@n
z5T}2_sW-vwcHQ6a7ae?lIBd(NoFUPOgHajr749NiEb;e`L;fM;W=42N#NQ5B+cOrt
zX6LT3S0;aqh{LdkUTo}N5w5U&vO^>Z!6jZrjtYqX;T?onJ~u2WF1i07ik{I8*x}k`
ztl}bhKa<Odd!*SoBC+p?c-rL=<m4)lf#!hUz{`~r>zLSCD@vwLLf_?p9MbA>x_qaG
zf=?#Z!CX3|W{wTS%-eG@?+jrZb_dhPq|kS?Tt@K|;vzV#Xya4`CxY?OFiTuljEHC}
z^ae;XtnrZl2ZHD(bUmj65Yyy`WBI@9x&QTkCQSGHntGEGy<C~$8q>nP;RWi+r3N?Q
z|9qIfp$t?;7v#lx@iIhY>(cOr6VY*VGKQk47?_CeJC$L#Pw&=!^K(T1!B%5OIiT=s
z3>6(+WZ?MRCHA2*EKQ<&&X5R|d>g&>9H0$%lTI*?)PMaH_<buVOiVtwF@LZiJW7EL
z2pVq;5BPpzMS%sW#249n0Z*m!dwmBE33Kke3+#9={C^R8ALW{?Pp^Q5`qi(VX8lL^
zSI%6#Kv(j&>w<X~<K3DDp$fx*|J8x>FQ)l-5lr;!jmGtS?=~ak(aZRWc&`=l(V^g*
z3?c|R4g;LX*<i?j*e(?Ck<VZr*M5)gfc7hV1ATuX|8xK(`oEpLY-(G#v=>*tPF#{B
z^3E6y5Zq#jgyZqFEaw?g8@Mte=&KALQ5=}BAHfuYFC;on2)fPX@PvMx9pqmcOn(zG
zsDwa$H^f10DN?NZ+y~Nga>yp!CpO5^gIpuyGkLgf5D?|wY$JLud-0x1V1tpgIea1p
zLHjuRSbix3umOD4P~<|WX&htzH{lI*1bXlU1%za<VfCYV=)uAb0v<>W%Ag0nuK|xi
zd8`C9mQnBgZXeDRFhn1Z_wBMJ5a-`<{jBzGI1pMr=ekVt`WyA0E)|CTen0SrlWzV}
zkQc1udqZ1t3J1gkaQTka`X74Ws%q}=HRY*jt#3+%6C(WglLH3{Rtw0R;{8U<*lgl4
z4~X#|BgA-*#7H4##9kx97>~jjkKrgs-N#6g9GnTYp7sWiLVDpGY_Wu&$$PVe?VuxI
z@LDxT14ne0atHT{(n7~jW`+>(hF)7Ly5z(-fxv!AyI81<(HVKO<d!)6M<y%9LK%4|
zhT|-Q;eCwRLu6VOn#U0||A_mVO_nc*Vctx@;6Qhql(x<9{Ci*gfig_^OLmZ5T@{*)
zqHl-%5@-k{{?ZPQUYs8e=NcV^Jr&FlvOVX(540-6ee2H|c~CL21JAB1+N($>YI9K#
zANry8Oh)T(`DRx7KK*-B+=FXS08}6l1=>;JaF7phMA#YRijZf7anYb0LHGr|{{rXs
z1lqtCgB9HPZ-34d!Tob!3?o+O_n=Jn)P1_IFC984ouD`IfC@c&16xDHOrFDAv)392
z!-(tB;Tnj`$z4qmlMH+o^*b~<n1Z=6%(^?z%|1R%BNNGr@$nzI<w{75u^)tdb~}#8
zD(zPZr2?HqYl!S(;R8VKV}iU1d^?!}zbFWq4<C1T+wavnTcN1b+B6{VukV|UVVmQ8
z5DmX@3&VZ_ZTA&_=J<3&P6<R!fqb|VSwsX?q;7>Q@Rgz0{Jsp@KuKeP6^R9KBK~~Q
z^Iv*kht>z|?`q&n><?;M1H32TDkK58L&Rb~m!A)Z;Ij!Z1IQ9Rf&YxI_B3Q5A<>hr
z{r}pzy8(cc`a%6X6ycTnh`<)^Ky45pKm8-~1{?*uKwh)>cdkrE72;Q`il@CRUKr{@
z14t(G>s_HLUwA~?&G=?aBgA5&KbsOB!Ny`{PR*$;$e#+T{G2CFqpN0Jc8B4CF_@a>
z*%~U$8xkfyuy9dVjLY&#jYt>|ggLiiNsn=sKOLJJgK?|Ad3@arFvol;dBGKE4`UY@
z_W*DsYmj`u&IFCZ2#<gJ&2t&BB55E!KMR0>dPYx|&<q3AL<r&FCBxC69ZRd#kAuwn
z^tT9vPByczrnm4%;p8C2zG&0)M9sr>4O9qchi`&c%o_$DM$Qfegt+)=4GO!>@9XE`
z`P`Da=I8<v3IvSsQ{V<;|LedBALPCsGkW7%?|_rN8v2tMJ{tsY^q8N7CrKn8NM$ji
zPsy!(DFVy4XIPnPPxFX_>39i$U|!!V%l*snf(EaF3&JL}2l|Wo>%f+$n4LZl{6zL`
zzZBpduHLg;Fm6U><*YIHKjrZpn$*}rPF*5m$=At^FXBQNS0tk*KXIJR5riR(Bh8It
z89BM;gIwIqaS~_#BY2WRKeO+{rSi?C5H`FeFoB^rO}73Rwp2@?Fiqe$<tSqz@%*Tq
znH>lQHH?e?Hp33XN(ovVrZ7OZL+S_vd*@*W(s~K?Ur$l;418n9zwt4Tvg!Rbw?^GK
zrU|v`x`X)p%t$6ixi0WF#cPPt1FcuR(jcCe3?Mh!mzE@5eqUGS#J)#NE(v?L3_;R>
zSWM!wMaPWhPU3fY1-uX&Fe&(peJlX8E(O<u``@W-*YV%t@P;Gt7>^LY3UPJes5lM~
z{irAI<z+eqZDv}xkJB#^jDiFv-eh;#LjbivO1}mDb72bzAQjpJJfmtJK05?2JOD`c
zVvo`*L2Rw@2i`lwx4f7BpwA2IQ407V>Iw9`iqzf8k%6B|H*mZ(k^k|q<1IqiKtfSh
z8`|$##t+N&%fBXRqfWbta#CjemF9J+jPSY`eZ)aGJTt??<jGeVv*U0U0$kh$^1V`!
znqKbRMyOx;LbK&P<nZyzGCjZX5J}<Ng#QudihAl0#^Ngs#B#@Gy@XC`b(5FNf*}kk
z5x9-=Q+BV4mzQm@$FyYA6YxoFd1Vz&_}wKa!NQ9w$lDyMr-b4f=GJ_14*Kfeti5)F
zbJTZ@tF#jFIR71?wqr;P{qcKKH!Ago_@4}-!1N)tF4f~|8<E8;j2QP5zqSI~x~=>-
zf#tmlLQQONg2-;)`~(|{bN)AkJiE&c;`vD#%G<1l(YJQtfb@v1n|bXX8;hz>MYaB3
zh-OuBi;cb+X9ySyyTJq61KnglLXCTI^<QSm=cIk^5D~k|Jc|w)tNsxDKh)%I&!vWZ
zfGOACr`o@}@~yzOv<E~{?u|HnMOc9ZEm$6WU-WS5bq3w*cq`;>v#(Zai8VaS+FCZ5
zSRSzP7k%HI;`n161(DE!ugK2~uU2LH{j|w`33y=)6Y!v+vKRI6kAO0_dK_t`hy;H0
zo=pSN1NJ}%w@K;$2`)7<5BCInmFO4VfZM3~en4Lt2C+5CpV!0C5AJ<3BWLJXZ8$i;
zTnz;>5?&!a8*8cQ${kSPkCb)i8UGUl8`Zud?VtE>PawhWgS`HJ{`p@QL<^G|Ux=<%
z$t^nz5m(}2$mR?_>`4~CxHX=i;~|#x(kK^ofFska*Ec}+?+gdpwwGAcfXAq;`}j@6
zn`d9o`8vfu5WFK1#ah#rz9Ly;F_OjdVcQSlUT2NM7)luN7`Tl@ehA_2TmAT7Ha>4<
zu1WKkh9hn*1Ogz}ZtOpn5qmc*=`vl$O4ld;UjU+Z@%~-@Hft#z$usgN7@V$vg~y0s
zwLP`@99E@yB;5h&Np?HY#SE@L^3*(rSDUa#{vAKYz-*<s*S_KaD`OBEs%raJvi1In
zAASyXtiYzMJ?cm7?RWGOFI;Bt_-FRm@{MItfxD{=`|#{|`-=#Apr1~?ciMiVW<UNv
zq_Max_S(RsdQVYV>uq|HQ^~YsL_*fLSA{R^$Y*%dV!wVM%Bf7}_$ne5mN{4?Jj#}6
zVeUS*<DdT-g4zOZlA6a99YAeO)pQj~B29kR1$L*6UM`HDs45Tze3SiIBh3w(*kOD|
zA7#3dBAH)^i16PfJTpFz%W{x^7ap4a;2(EJB3tVCW3vr1*@@n<U*`T}Mc)_7|1I|V
zR8NViQeH2>6>Hl6Y6*v)1w1oX_|7~GK{@#xA_5QCZr*_RbYIl)mvYpAe_Z`iV*?`d
zXS!g}C;j4lPtD<Yg<O!`j84aSc&`bvSUDN+^l<0YFdYJfd$~`kY!P<7irzRjKf;qK
z2{?3R4pT?`WMQhuZG(4W+{^W|MmTyh3q#!YQ!j#>U>Nrc`du~9&wKZuvwP;pBS#}&
zuM!KP7uxD?^0Df}KLwi6+o~P#eS3(;@m%pX$(b<#mol0e=#+2XC+|MBiaW&ksE_I=
z@LMMKGO(Y~5QpaQ<SYDjZGulcY#EtBz36X2OxaxuA-~4=rTJ_EGk+(ugj_l}BjdGL
zQZ<B2F~>s>`>~Vt+$Fl;h6oxkJpX(no5(O~Y)gn5$y3*HN*9N0p^gmgrMES?&bOsq
z*alsQ<NtzApbVY$FH-p3VJinL37=3No^AE|eJ}#wfg<SctAPxJ7#m>yQw*iSK)>^N
z?oWb>tTh9$#DMLz8gVMfLWAK?so%gRKPWieUt8+}UEOuwGlu_vf~!N#BkgoQ0A~Lr
zzP*E=-THp~jP(4x#JP9*>hFt=JnAzCb7cRnt!UuX1a0wZ_7c^pIpySDo(!2M)2?-i
z=I|1>&>oI27qDXgDPSiaQcqwJ-i^Q-|D%R*Kltttw4e^^{!92d-~}4J0RND!e59Vh
z<W&GWl0W;07y8I9uz&J&7Eg$T^B*?((2W~Oi8e6;wqAPCIUnT2f{bqGoBHuT3Gt&p
zHl(;Nn|RTgw1N$zg1M&ShU8zqIFr6AW$1IqzHB`6%82m-W4rQ8$<&7)CQfZAtgyx_
z#KIYPA%_(5xcw8wLuE$&SQ|QnKR27GB0S3)?${g7#$liRAAjeJ`){`iSQ~--)^7`7
zK!>I8yoQk!TR-v8MdP9{n>G=RVV!L`sQ>}mAY|ihnXrDeC1Q3!ZyZ&8a<90-DKoGe
zG2DXbq3_=x-9yXh+Q<A9dA|u5Ka&rP>IvEd1`eU8>2C`J-aqncAUH!n>_6AbYD3i#
zUijJRYr<|e;v3xxKzIYmB2zmGWCh2NRfd>rga!UK1P{~Zt)JQ9Jx|MBx5mWCC1?p3
zBkLS6DxO;Zg)AzC7C|AjoiDn|&+C53d}6QaU}Z$3@b(Lay$iO=$9Uz>@gFOy?->GD
zuZjP`FXJX_J*Aq0stTyMh$xXTMfvOFKP(-hSHBS#pu$_rZP~1sh?|gbH3Bae!$rz=
z2V7Fv;;0TKNK*h~-_rX3{$n71`!lPUFci|`6BohWrKo$QiHpO@T!ua5&y@wQ@Q-Y=
z6;Y@N^-;7$iz1wB6UX4`c+L_EfuPReicV;c)QSZu<Ju4f2Db0|S6TRo2WhGFF{3ZA
zo#c(|!$1B?Cz+CBeiNN8cx3KQNm(oDlamoK{3kg&ntHM(B)4x-5RZ<=L#~R0`WR#P
zWkV<Xt&P4<9F|y%$qNZY<DxLEN5seSUWxo6$A1#78b`C#M+EoXFC7z2EHjtKdFeS9
zX5$u!7yrcaWckU#Rx@>T_x1(t@|s@d-ZQ-1C4GUMtd-6Wj@56K1#!@E!b~X~jij(Z
zgn6s)%dAZ)INHk=KzlNw#XV&l_l?fu#+EL`5&pl9m(|aTaIg5w;1aMTa0c#xo|Fy4
zkK7GL<Nxp9G#e=zH&C80xevpf()Y!3W8V0W#!mE$j6?H?5#@4P3~c4bXixON5oEtd
zj$On{=9hv!WRH9=PMZ;#)2#5n;snVN1k*8XXN?z0!A+s@J8I8|WZPInY&(dSFl^}}
ze3;bdCng-M{u8|<Ydbyl2y2SW8(JF-Y=Xy|{MjY>Z#6iKbVejjtCL!cgfX~^h{=gJ
zQGYEYlCC>b?ob8zc<G-RX5gbrTr4_FR}*c)f#p*_Cp3>99mAqU|Hn{i$JbRk<n2H2
z2Ko7_h+DoZ%>ko>Cmv1_mUJ2^3{^&J24DEN!4vHopT8U#OUaI0{_lkCI$u^kFOP+?
zWOQp6-E9E=N%Ev;5xz_`ZqLMm8;CIS%=-AN8?nfsZ3hlQ9tbAIuMv&lv&)pnt|@$%
z9Z#uwEgvyBLNA-aBgV_TZ&2(>ft}dHoI43vJ37Sn^b)uI`&fAop=bYxuOt&Z*We}2
z?K)z8TdW;<>jE~;t!PzJT?MJbNQr0s6MnEVF75xS=JQ0HDb0;SEr=q_xEv9*?hk#y
zxCyq6;P~2+(mKs#Ab}?HNcFg(JRxOMT<~^KM0w2WWXS_ET!B45UDgg(3B_E-r3?kN
z0s?R1A<qUhrO1@q{=MQ&M3bWO@w{t{?4K@LYicJ*sFX+IawiSQ<;>RzYmUc+2Ie2t
zeH>~~%Fy3EY%$YI>*a{>hE5TVv=F=o)RRUJ=x}l1LWiOY#xSyg2*2Ze0hwTUBv@kB
zT$os76YKua<VhcF>HD9mi9~F_5yX?kc#PbbZqn<MwmB>m@J%lC<CkmN>cpFlMq=VI
zd=hveX_H~_?OJRSJakk)2yX+hyW1Lx!Z|nvR#@m^2H0Vb*8~x&fSUS?d2-e`d}T@y
z2_H`ho8ahu?!8MKC4`uN4}AYu`L(Z%))8P?!1`S+Nk2#G-yRr|^(}NytnQnuSv9YX
zf(MQq1VWu|uB~vQS^c*$6digJ;54nG0=!6nQGo-6K_m6X>s26u923x|rf3x?wTnMo
zBKSFb1zOl7V~PLcY#XYFhxg+gH_&dd?IGmC7p-E*N2t?3K*74J6bLquukftfI-T^f
z?t|)UiV(Pa*Z;}MpZG&j5>|D|k5l+A(wQLL!o7i)T{a7oH<2U6n;aclyk6P+N6!_T
z5m4R#1euunxKnO5f#q?e^6<Zy#mPy!b;EwYI6f4Y0EGOW>iKMIcKvwyEi%_C&{0PK
z8KMS_diU%1N!JK|>!~6&!<CVm(}h%z@b%tmR5u{NW~&5^<fOyG?abzw_C-uBOW>tf
zI*%JL<@rDJaNR>Z7n9(9tDcyFWoXH~7m#uTK@KAuE5Ian=_%oAd%Ed#a^GK!ckqWl
zQ8G&WWi@kW)}TLlZ<C)0&k=;740jb|-IST}C6+sWOW-isrNowaEzQ9m(e>y1>jgw(
zI8#_a*2oe(R?7)=Bz>McY!rPjJi^K?`QJadTo7ZxN*P1waRY&ZZ!MrT6@v2YwE=H`
z>|jBJn12s-zrj?`0#|ek+F47J^LHSS5Dcq=$Vl$WB-X$q)KA{h1inVgXiM75uY{`o
zOUug_#{0Rv30j8|55vP@2LWi0;6KK2Aa{l_gZMDwaYqS!|AhJ1`sDr+$|OMo)Kk4E
zOM)6)YXQ`pmQ@`Z@e;@&Hy~go=dTl|_$bSR?h%T@(UPm>ToCQIVxlteK^iC%-N;BT
zq4z_J(m2kO{K^npOTC5bsWu)<i6J)oe}{S@y!v7Ig8@6lT6;i$uA&5w71^mirNePp
z+>JUe*Z3{+Tk7wN%*@@otGV$ap!u3D6!79z{y(!mNIFaTW=ptIBMm|rt{1Vl8BC3x
z*2!xbxxY7d7JB@4HA<>2OluN;$;WU>83dZ8wjLdqeV~oQxXn9IgE)!hHy8vt5r5)l
z*tvZJ=sEx5elHp`!QG=z5hvMAa%?tEA|}1WOI(nA5_KFCg}yho8ivst2noVCCQ&Nn
zF;f_k3a!On5C;1Z&Uj&35g+&}ve}DV>jAI2f3d4P{n6xCOyt)!?~T91t=;EWYGPJb
zHy@~+ads!3J#oXeNqwDP#8KvZYcxQgj_{j!i$flpQg0AUbpBkACa=rFv_mmhc*Jaw
zu__2e*Z7DehigC5;(SluW;MZImo7CriM8C>%4FQUyuMr$&BJ<@xSuUHjWA0QtRsBf
zsyL6rSkTJG(-}lo&xnZR+{6{l3$17BBl1rV?v(h@sE^IJ8-)0FvvY<JnTx?&jofc7
z#^FRQ(x?e@gS`V=j)X`2N5KU{@r`<h3@01RwP-0q9(aqmSn=SKXhHuGu}lBt%tR%F
zyg8rx_toWy-wW#=yLD#OMz#D$_04NcpWwPyKBPzA7bLj!eQkVYN7T@2SxnD4G7I2g
zAu1gs(W*nhHV{2Ozm2cU{j{_V7yS_)Q$#nD!)=?qR@@RF?i488G8_CMiRR1bB6rn|
zb?*{dQ{*=hj^eo0cH~uluyGk;F&q?V5wU^-fWlvfj}TX%EZ2fU&NZXFjjl{P*!)Yu
z$jl+e^2Bd3iNky!lpWy(_Jx#8DMeBPHU)I~>uJ-1vq2ZG5zrxlh`8o7U5!*jXs%*5
zvbuNwatlYi^RGd1f4)jV6BOJ1Ux>bVC+_+g@jfC>6Q`z~S|l;}UkO+$$ZJTB%orMn
zwz01N1Q~;BX28A?FaMh1axvk;U-ecfoy<BvE`7|nAzl4)UHl=Jf{B9X3<M*=dGsf6
zG3RYw9=Mvp*@N-w_($)G%*~E3laf0N%PuAo!Z5T)@lhJWKLwS+9-B?!IfP*@*bUk7
zu*zL($U4*Z$AF7&6Q~d&_#ii>&Ba*-W~rPYAMq4a(l!yo-}{Kd94li-$?QqTiITw+
z!``?b_}$AG4sQrtexh<!6EmFl*~1GZQ6qMosTMy9#4SfpKkWQ(FVr@YPx)dXpFA{W
zr6>5E<wTBu6|l|qs{$u^q`Ul0V!lk@#8;znB*H|FXTq9KyDTZ8q`ZxBTKfP5&p(;q
z93p4acpw-)3g%DgfmXZidc%;fozK#sz&I((9`SE1L>EqjGtpyMI6$0{`0p>`VJssG
zL}!T0)tn*ts_2d2{|Z%LmY~0@;`)$LNL~lZyk!5=KMKhV!sU^nCruy1@u%}b7??vm
zMs7@MPvD1je&RnanMu?xBQJa0kr_B5$&)&sd*UtHsD_Oj@_c_>5p!?2j}u;~h%2r^
z8Gcya!X@Oy!g!cQBgFq3%QFM?*W{|yoqAKa1a03C?nx_Bw-J-MvZ<~kO4OP7FsDh9
zZ*@+@U;ZymyLF$haUTfr9wbV-c!4od86qH)xh2?_yi8OflMGx(<hk$nX{;d;zi}Bk
zGyjRM2|NOKuYd7zd~a5rFm@z?rW%eg<?ZTY`;eiYFT;(IXZ*04??byhd$dbGxzfMW
zi+_Ap(wNE5?WQ6lAIIYP&LSZyq|e0W%y)c_;qqEa{v(qkc$uzCX8(mT%!Q*d?3Y8C
zA;espmPvJq1enQ=<A|RV!V-D2h&0rU;{9IvH(0JrcwqlGQ{%(}eLJNH2HCku5s2p9
z<cP}=f$AX|&l&Dd$Nh3>p~`Hq8`pc{xb;iA+~b^u0H6ikSf&o*)zpWoFQ0Twl32|q
z&^U+&DjIuq0)q1%Xb)HfFroiob9Td@W)f)L@BooH1<_yYL0vi11!*zntvKn%A~&=h
z&F-!TuKglBG8d0kzpFX>U&GrfzL5PsR{8rKMcP9jZ+WcpRll>#@F4d7sL=MoG}A$l
zCYgg{A}b=ak6gk-R|UrOt_0v@n5&Szcvl6t_jR}FMQSzzU`KLhlm*PNRNlMXzCB}A
zNyj-bfKx0w@*867>a=8_QbXHRSb)PT#p3De@7Eff_Sn1cJ;oCseosF-5Oa{PW@TS<
zRa<Df7M()BbY8K7HX+$B2zNY+VQitCr9fICD%&Kc<B!!i|6TR=V#6uq+lSnlRa@)9
zb3%W=3X|a5ZqvRYk)Ec^cCRlVv1A36jUulPBY+_q&A(CH@pp1-B|rg^Q!;VRHL-XK
zl_~?fwPY#NbeuPMC)onaZsToRde4VhSW-3HGSN-fbx$O1%zHa5fGwe8uF7EQu_>II
z;&jzcNTr;cKxdVH;av)sL<4MOXFs5LuC4<-6(~|&0)!rdns8leFMr0F1YM9&K@D^Y
zA+x7B`H{B^Q5hN5LO~}Jpc)J6e3BD^fgVAvOUihSm-IkwB2>J+6c`FH5D<aHO9en~
z-zxYDPy)nL8UeXNG$%{ONuUt%#<a0OF{~dBp-43Cw+WysPz8p|m%V*fsLPXC8b}PV
zch`=&<8vge0`^LkGU^SZ*_do8bL8Ar3W#dzvWKbjP-^j&jW-oVhJpgEw^?0=V%N&@
zT8^avZw!_Up~b*~xG-UNIDWXn(~#<7K>(FDvbj@?B1F;AG6)JRI2xNd8Lm2?xyOnb
z4*<FnFbOImz#uXNRH9g25))BSVstcQq)i2IOL3x6!Us5-z*ltiSYzINwN2r_&7?%j
z(DwH_KNs_|FVj5#uD=?L%vfw}@D2t-Y3lR6OpNk{62Zp4002jUL7IR{5Am2KXnB+d
z2-?kP_h0`ua1YuH)x!2>It_+AR}TeyC=Ptrb~0_>nBfMz$=}SPA!zoE04xi{=?+s}
zU2BdFG4PLUf(Mgx<X;nD=HsxqMwS)i(pG+Y__xRLeAvUwW3g8RS)xWZPsMmhqMI87
z8r+p_-JUXVl96ySKF*(AvnVk)Z2jfebv3rf4hiq#<a7(fOCmO&wZk6spH;^7Wpe0?
zcqWManKEs&_)?iC3`zKWxTp5XBRoBB2dHP42oAmWum-*U>(Fb=W4R>51~de?n08SR
zx#7gbaGL+{S%>=Oxq<|+{9W`})I$6@8;@KpVAqd@ex&JA!ST@Q>D~weX~~yC-1~?<
z{A|MnCSh63v$-yTU1tijxkjUw^J1zJ&c8y6{1jWa&F(xQX@yDcf<D;SrBuzylGpq5
z9&T)v&CTWhuW*JJ;=KA;xXCt`h{{1vnsh!S6LIiW+88mcJV0Iv_^Kw1i#)4bm}!as
z5z5}H{=9?JN8qoGuCC+)p`783+ZzSNSP}XOs$^Y`{JSO$sywwOVNMD=K?V%?3B2)?
zEC+N6hmMB%87Blg!MD6XTfc<o-r53a5$Ilj8JvZKBkE0tYPHV``T>GAjk)wZ@fAbx
ztPPgij`-b1P&(Y7c`?D5HFfqgz6aLLm~koB`9}uA0Vp8;3UO9gs%6&UUN((-^T$E8
zD=gm!b#537ft-^tRVYhF%ZQdSmq{S^HijmbT+rRPY#?8}*6{x~9rj3#;t7>2(8<f7
zGa#h6yDadA{E3A8RRcP3?J|kBe~FiP{fhLC5uUgtq9|ZAPB9rF4BXuLg<t=IUu^u`
z*wBzwM$Z#4wiAE}+L7C@`*o*}!u>_<!fmy$@Z9eFJBOl>1P(*`8Jh=Q?qgn-S0|t7
zTKUr(1!~0K;-;($cd%W!dA^Mt0S2r(TwjO0qYGvZ5w^TjH@AI!)CnB4R4jijDEtd?
z7(<)S#&>BdFDHhz0wD}26H@2?U-EF2z<`gUjGHoP4iH!H{d08(_|Do6!SEC)d-%Zt
zU*RLhc$!vapqae=QpzDcEV?G+HYvFuQkdrO?J=xIY>B>WB8CL(y-$R1Fv8&rFNhF|
z#t`|b5wJQ_fL<?g^v9Y12+bAnG1GpL%#XzQ^*Z4@XqC*zaq%0(+%cDgwq=HHh|OPj
z$srMjU&s7)eR9dTW0P8mlB<`Dh5Ej0N5M8>t12vZ%iA_#{=+cAU%_k=JpWJC3{N&V
zt^!<rZhm-|Yo)~9<Va5IxcH1`B)3SE70D;p%UZ^8z1r6t4FbQ%JHj3^#1cGK-WLA|
zS)6L+Qp|SwT$JB&5J|k9>zkq;G_DcPu-(utTNn_M^jDaT<Ylj+`1%5XO2WI%KYh03
zNH{ZiQ&J^_4Zj-XVK+Uz?la0uj;FX<iaf{|k$ZfS$%5Y{jL9DpToz*>>IiguHZcht
z00smtOSebf_xMtc2oHU2sNkF$1O$(xvgRF+543Ppw?+0I=*6M?!i4!_xY0sMZajRD
zJRzM^d?=pZmzp)fB&Rbn;1cpuO9dRU$J6UMxJ#N6#;F^EDSv;0o@@l(KURS=(cMq%
z<PgjP-4H1li-VeX<2+zzIeRnynz3KKA?8WtG><%It2x2`s)-SoiqL&|iA_eGFQJxn
zluG^=n0ey`yUfLWU=WW_`@dFau?L$wD`n)vI?niaMg2|*1if${b&X9~fALs)TWw&t
zc>gq)!@`NlKZu*+_1VEEy8PWlYme&<o|LEF8r-_(k`E!wN8qy-=4B{(sM|K*^^Ku{
zej^~B_?raTA<8b+PCpzFpOQFcle$69BDYH>Lg&YJFPa(LnA!%vKND<l;=nuQ>ysFj
z{1R_4V)JrFMrEbG#DwMBod<#~if+$^FBmFWkZJ;Y+eiTFv_%O#!{>oS#_az86aCI&
zypS(9i}*?i+Idt81xTj1%cSi-FCtnjbn*B{$CpyJvR)s&b3Z30B4e&z9BO}rvxn9^
zs)wdm5t=m8w_ILMIvQGO0FXOx!C!K~&?2ih=S9M3fT9Ttvc1=g!`Bfhwy7m4whzQ!
zASrX@3-Ml6$dVB3uf*EK(Efk$oRsX+vhr9oQPDNxY#o9p;iy+=niw5$Phv<CJkJ~<
zs*^Dja?j%!OmX4(*#~k!mxb_HR#}8RR*Rl^RhAHS7tC$8$P8S(&4(cjY)6Q~+$AIa
zRSZ?)GH{%b9~mgOV8mnLuadf#k_mLWo)v&6#P;P8azPc<<m33*tF5ugW5tzJaq*Im
z-C2+LjLb*o5B+dYrf#(0#i>#yz8sr``QAYXO~zB@`f!oWyl#<<s{{~+b@eW5v2yTr
zNZM={+u^D7!fpW1?(XmZ=KmAPhxosY=$5C3H>z!pv4Mv7?qLAeE@&DW;ZD;{4;ui5
zscCl(Ad49sIN5KV-1ttQ@B3-^%!w;eO%>ch8nMg(P<ZK7MH(Jz`_(X2z4*>J3zhH4
zYjR#PKmM5OKbK0NcJ%O<kBnY5BI5irxKhH0LtG`{8x-AIUL!LWs*T!)xK}s*7VPZ&
zYrl=9b&&**ciohDr94X9FSGwP;FbJ~v3(f{<?e$=csc%{(_SzNz9%>1zUGoDg?KSw
zq~GxJ^JELx!+V%EwW|IcXQq~1A(;~sVV7A$@Foom)G&7M$7B#8_yx!k^oG;wYj@wo
zX3!qO8N=WFDN3K{#oh7NMtBX~^pf@E65K94N^yvX(E0iHSP?uhTudd2pPQE(@=>&s
zL5?PzMNEN#nPaFo5uO#cSN`>>`n~a0O_Va05Byb!E^opGJW29mIq@XQ8<#v?yx`p9
zA=Fc^72M=y5n!*w+DvG;5w;KHF6^OaXX?B7+EhLV4g3)G<!xX}_1FHs()&4s4J(^C
zk>mz|grpWMJ+!a!Iln*2%JVwwp$rM!-xKmqFKRet8FHaj@4J_T{zdX*KN&Rg`m#kB
z5Z!3RRC2==qgvpyq!$SoJM-q?PV@)kVd;4!eS3-+JAe0omhFBnxrGA|t{QPlAbrqY
z3?bR{a5x(QJ(YYQf3M;{6&>EHXJ9}YUo7%24;|}?m6%fk0!0r>-{SU}jv0<ie)YxI
zB@D~=$%-v<V*`g@mn3(>H4e&EJU2QB+|7ZtK%Zl)&X@dTkD=Z7{2*e8H-45HBO24O
z^F_gF502>|Pv!nH(7;{fAP;K3)w2*)45UYn^}R0{!xIn^y+B6T!3!hcYG0^=Qy#19
zkMVbuASf!J2~zmpOpMN<mu03pA8H|xTvHg506$*H`LEfIgF%(eK*s<4vzte_j4=_o
zfQ)Y>SKKj(!Z(Pn6R<~vJy}s3gs1*qaD%RDhky0SMVi+o5PB?)Kv4KY)1d`yIKb<V
zjG4JBTj}ydeqB0vjNF<da_fX3XWT>IzLM2%HbQAX$q$aWcN#S52dex>03QhUgR+Qk
zki;ZnnlQv%p56At+;C7?9KhqQE5?D~ED4b$sMjTwV<oyMjd6Z2R{jv}jvH8O^FVGS
z)Ra7W1b%8W!dZAn4aLBzfWhk{ExlO@t^R)sRO9oW9w1eL(8nv(K;g{kJ5wCa2f*xn
zWN1SvG$;p!|GWC#?&`4?WX}ZEWD>A>&M~cPJH~>E&w@`4LCj<0u+rBbUI<(qfufeC
zA%G82AEFfPyUPtXEk+t=#$lIR*p$J>S86%{0%MWsu1s?;;F}&gaK|TkaU3CpVSzH@
zBaeWCb_FxnFAmmXIc?#s-20O{h}Sh)QDQUkwj#b@fIG3+K#|}+$@9YkJ-~4*v#GD;
zpwXn9moW2x7gklz3y9Cj<!j+QXlVGr$^0e9VJ9Qh5b(T_^mjMH76Q;fMBM!SW`lnS
z_up^)K@dQ6J*=EmV36`rXM(oN+$DYQAUAs9FB_M~M_0Pp8F;Tg^Gn2A;U0G(@RR6;
zfV@QkJMj-je+pY5BlZTPfny1|XH5n<uZz{C^#y%4uB#p=a-fOC{67YM(YsC7JP-~9
zEyjhP#%}bN&Z8l(2}VFN@)3wu970uKRQ19$B0-vnU;*mEB4oZ!Cr+Cpq|6m1|NoQX
zG1!QIlGzQzu{@6C&Hovn<hG!dByTf64AZv#_A!b77wfpKOnY>O-Z*=_DGhG~mWeJB
z7^5S-nhN~`f4YZ-$_kwcItiUJ4wUkW-@6_1>>jkY$zhZr$(|>k5x`ufun9Pi9YXBD
zB4TTj37P|OzQBIH@w$>4hhXy{6D0`ne)uyAt%Orax`Flh@!;vx@$xptqU2b=sU7*R
z4qbE$8-ws!fXdy{xZNV6SX8|YfXLciSQL0|(&m<bi}F8@sRM;-OK9iN4)raBJRui=
znBNCJxsNoXd;At;%x%)cZA*9;d9TxMN5U_B-{7vu#+cq?RGDgU8_2X+9vS!)lk>Cy
z0Ht0EI1cqJN3{LH#uNtL81g>nSx@x;2~Qu5wJn#8$8M_t7F7dKKVgrBr4w!m`3y@W
z5Jnt&%9VU%V7ho<HK+^(b1vIdnQD3*Pkl!27SHRG&z=Z4p+w^sku0@INFX64R<A2K
z_P-ptaEUp3F`q0<f<K!klX3*q5i|$MKmUR4@xtH#`93Edh`dcic#Jp2NrOQJxd?OJ
z{9Zl~OOW%zkJlz4W8!P8jwW6SF|oqHG}-V~30m{B-Nm#FHq|lUFO$08&+a_cW%;u)
zY4Sz_2-oa2#q!93hZ_V1s0qS+@aKhc<3>M^y_nwj!blI8Zl%Uy<)`xx2Vmwla)bl|
z`{|TuGL{UYf36~R>K}qsFs(imt_L0$0F~+A?+2+{)A%xd={|8)_J+m&(W<aNzr<23
zN3K$UWqlVH1jAIrs=tiz2*1QusMK6a_?2Jg|HiNRqGW<CoydVakHo}Vz^`n7J^(AU
z_F0LK^z`(B6L*I^-8ebH8s>I{pO_O_{RQIinZ?t5cHk}#jv7i@uo(xRCDJo<^So_w
zz@Z4ZEXb2s7u^>SQ9B7;zx^Y@>ohAx9S4g22IT%ToMARJ8sLH~2X3ecGr9^GsfB2P
zH03?11v;DuX0Xl(pAn#GAUR>Y+1cC(Z{A8ter-c_6HB|sbLdUWl(1#Ln__F}XFj*L
ze4SBvh}m&wbU=yWdjEthm8__xGmRO-Tq9|yZY0*NhHs=N+f4ww!||3d@_E#=E<K^3
zVH0+`hn^nr^7>{xtq$655C(u>7vrZUWy1R!jGRx8D{El|EuJG25p<IL+RXsGM}#tA
z2|0N)h|9%B%y%pQlFg|E1#vO*&tg=qNRZqoT#z6DN6nT&a8X>*hasSZd7b!tXJ$Dw
z=jjmk@s6!@hE5ufu@@&V8AQrpfHCWXyFiefdnnj92~zoc;d~_+X82`_Ql$9H5muS1
zFgER@cXqB33h!=PLu@eVmx|1xru69{jQ|7ihIsnn3r}PcxNh%^^K@6tGO^IjFz$dI
zr=pszhK455zp^_~r8pn>js$z!563vGy(2v!1iR*!ZZSVe!V4Au1P|YT{r`gw`M59f
zgSOG;=fM0lKMY2^(NCjbS6|u^novV6-@-9+iw-{h0S$Zq%f^crnVo1TzyISG*T--F
z`21`2BX))Fr`OPz00lJQmxNzjHaEuz?+M5FQzO71O@URgEKf$hPuiUz9`>|;>V7i&
zxz~S~9-JId%-YGv>37THJstW#$KykX?Wy3c3xo_j7ALQc&B+M0=f@JQ!UcXy&RW4a
zI-7j6n#ZNCGKvc|&4N5Kxp7r6fWxUKO{8rP<ngeLoNoZIgxdDz7&oZnLbSFGMcWaz
zfgLs&dL{GJoXGzl92qZ5m2l<lSSo*2d?(Eeh%9%)Hik1L*3ph4-z|JZ5Mm<vyqtF=
zkT`(Yeh}w|z~qKL024n2+su&60#BE}s24r)m`dZ7vOv4e+M()jA&#t|0y(@j6Tcg$
z%rcBCr{0r~x^>g9zeSoFsp$Wcitwgz&}|6)@qF;{yWTUR9smfM4>6JmD!>4Lll&>x
z1g}GfqC#`pc+Yg0uSq=GXTPlUeo}u<H+*FSHR9cYC>TwGR6HTJ59OP=Yh-_fd!zp@
zgdYfUu}i=@vKEiTAnlz<2<J8IgW|T79g^*a6xWQWfMf5GpoCCs0yfm(BmV)jh4R3)
z`2jntl>V+i9eE{V^aPKz2m6R&|LH#Z&=DV=9R1_3^&8j(7rr%4f&KA*6CRYoutvUI
zz1F-I@R6srCT;-}>6`pm^8dJqCCM{=KJpq7jS)Y%h#{#K>xPHF_?aon#GI8e2l7j-
z1^9^v0)89#{&t)Yd?DBvVS%-wN%J?lMqFI~40slAqc@6b*I&k2#}@al3a#B}-XRS%
z(YQ<YJMaPh*L0uX>M?!Nb-qr!-@Y=@l5n1WwsCjV^Y}{84|Ew@yM6uhia@tlttYto
zm)k+Zxqphhfr=D5i%j7LzZu5?ox&V;SBwy<8YpV7fXlw&|JCDNN|323`8Oq=i79xV
zlIcyy#01JO!6pbE0PLB|{H6Fqa{w*PU?OiXf9%<fi*uLl*dco>==<^V%gI3*5b;$^
zd`3J%fg{|&w<Y&CCK!g3u1g?zPz%B~5rD96xU8#V2M`rT4Z##2uZI-aBhJU=@%@8D
ziX_VlAoTVAswE5yDIwx>K;D75uTez<e7-c<;W?n_o$ul+kC0%G<x!U8SyV<rQo&yn
zpAy`1ovD5^Lp>H1^tG0WeN6yM{{&Aq><i0MJMbWT;QF4zJN$n|eLO?IdfZ0Ekjw2<
zKv#SQ$N$Dn%TAJ*{5yDs39s)wxTS%4Y%bd&t^f|Jes2Ji*Q4D25t%^?%$xvseB2-R
zPq*Zc@_;Dm`UCcGhPRL&)e{(Z@%^e>1K=;X9ZSdw)UhZn0s!lRj|7`Hj0|k`25*5Z
z;u$jV??C~Lg)$L%0Y@Qu6XSlr>+!QR|8pC~(&I3P#b_8#<28L(!BoqE67WFT-`R+L
zf%HrKFo%EJ;G#fm4wB$Nv!ClC)^F9tT$bnUe(NOY3Dp0_K#9AHuiy>=kGKI%P4T^{
zNO%{91OKbG&I7BjKy|zM0D#vdZ+DF7F0s1S?Aut?5kZ-<fU%(bL#vorm`jIHKp$(u
zUR*p8Q)S^U!!D$jPA83zhjnPaCv0;%@hPv#Q4@0W<Nh+kgc~)$I{;<h*!~|*jwR>U
z#%cm*k2ac$&Dzuun?H>4lO6+&$VTH5O8Vov)&Z0b|35dI_^w(M#NHRgmNlllu;AN-
zFC-A;hb=!OVlp*RjWgw`=OhotMlRBgbHa(+9+yLPV1VnIXa*1q2y=Y4n@!&zRU*xI
zA)sd(UNUY-cutjZ{!Mst?rY%DW=0=~CTl|I;J0t9{$4N`IS}ybkVe(}w~WX$$s2aa
z&o!J>x9o)uF;i}PItBq<@DSt2V`js^2911vBvX=x3;ILv)bmEr7)I8P@sv0IryPmw
z9w)}(zr&sg_Ad+kI^ys_gnt+b8en)5pyIZgK$~XOF@yuo=)P_E$>xV2f*BuX^((%|
z?3yC47s*SWMD1sKU-*Azif#Zw4$3)iFgmD25!yS{yx)frNUxnOF%h3H0u$@QYtLL2
zK=0fJyOs2;33qA7V}(82kpJLuj9=~__XNL@TKZi*{xUQ&xeH8oOw7Yy@C$ou(jN~#
z5Vkj5MsMK;3Qcg2BnTjuEH}VAMfV<ru>bN$D%N9MnTxm!?T?cYH+HjD3_g9s9Nryj
zeoQ9p*K_h?((s)CP(>KD`_o`05w0uEHOB&lOV`3Z+@OG?VFrRq5HO_z2K)zgJ`<?+
zdA(N!S*5c%uYW1Gp1zg@-<ELy9nhlUz+bP>9d!X7{tvI1u^hP8Zvaxi&;~X&CkN;l
zeRE;wAWq;rDYyW<JEjqOMvf)|E(m7kJB%}747Z+Z=NK+ZxKEqHd`}!l!B;VvItWkT
zL+lLkWk~WHXYg|0Eix00UPK*$ZWkY$y}Sv9bc6fpnU`EH_;s4C2lw>iui%UVKKi{s
zo!Oh$M)8=`KYS8n8wDSko9I70`l+1wM{(9W-Zo6YCBr-a`KEyor}+B}YcB^;^olEt
z{#v`7Q(}HA%*5+QF8L_PYx7zmufkO!GQ(_g0+uHc27HnS3dDee;&}Lm_lLUUaah^|
zsj{<X=@iAyqiuW>?Kaf!I6*LX<|6n~r4k79H=$jhXzrke_!}n3N5kVZf^R(xlu(u0
z>bh<C;#NAnZ&Dbz(knm>UOP$JH2Vv;E`1lYH|RC*nyjS$JE$Od5J%ANir5e}uy{Tl
zQf3Fa2lw~`-u?sGU?4Tkgm-;`7YgJ2MgYk5So(n%6reDVXaL{gOh$LE9^@ys{;mPw
z#|R}B?d$2V=cktVS{n!=<MoCRKq>pu4c@TG*WLe*%T#zz2tbg&aDI5(?f~xa#lH0F
z-Qy?v`e!DHc*us?gDwA8-Rik{5JBeQ2GCx9GCEv8f@WY(vJd{!9tNz~yiDN)4|OVK
zMIQbv0V<OM27ACvpNZy<AiYT-Q-8XDkD_0m5s1$Dw#LB&p{_f-dZ{w4@P``9!!}>z
zSv19PPs^4QG=_~he7(6oA{dCnJiQFdt`g%mHbbKz=*hlX>Rw3IH%P4V|A_n&XbhOp
zfH8b^gh2#4f;zjQol2C#1@1onZwS~BUNfi>?gIOfrYrKpm4w;jrLKoC0DW)X{t(zi
z6|h96DH%Jf?nN0Hx56|SBE1D51T9*BIwaSu^8qTaIOn1c>fE2ij4$e2&knh;+!>IU
z37r=T9tv<0wP0t|6Yw0Xzvo@=wtqu|+JESxBM421#C{@7M7%w!7YC(82cTdO`q+Pb
zvYUSUQ+?K-hV2j=1PJg#xA6SSTx0<+sz>XN6&7&>&s)w^9dIADJk`B@sdpo9>k7Sn
zr}xu?@so86?h9BIZPJWC0sBw8acmq!|C>Bq-M9|3Fmh<{fNHE3FNwx`>0D}ayl#>A
zjyIpdsedtb!g%4c$q&WG<2qsIGLq=p0(@3&j~Jz<QqvwL`?ZI6Gjm?+gg1z+L?;oL
zPN6;`uydNte-$$bu=;(!CnVI;@jUR2PA|)8)dUwGU#{_^VN2_b!X^%ZNC4;xy`ldv
z=$<E?50-3@0C!@;SMaOyVZF!kno|T2Po@9-IJ=6NOL7FB$`-i_Xy75gw!&u&Ri_ET
zJ(H#Y#>#F7S|4P+{sA%Evy$UWy=(3QJ?IbKNsJ6`KH8%*;d}rhKUMvI|G*PwI?bK&
z*hTt~wgmDfK1rJ{g@l8H**6=+A>^?FJRyjDDF6TD_>hFyiLn!L`rv^1753$)K?%4N
z2;T!*%6NsYP1*oV%Sb=TxQ)lM@txp++P;xJlxv=vL$5nW{}X{~2m}dU<Qw*15vSm*
zjc2WruO563G9*`m1J%vU%U&y>#|@W;w`Y7KnlU_APV>)}68Cy+g<%LTgN#QB(ny9i
zNuR!3`7Yl0sgrGpnxvWQ=(9f^HhrfprUgZK&CahTYlJ6+Vl&AMWFd7Cl)T;<+a40j
zBozu+W(|1hL<q>Ru_zr|(5fKv1!MFLKn%~<-F&~$>cGw4`gg!{ufb*RKyn*Jr05Dd
zATvh_Wwb-H_M6`?E<}3b{Cgnxy^=)2KZ3Y=Q>~5@xN$2@-2yBYiOIEb_%5GaG{65n
z0Y%<u-*v&XkM7U2tRl7R10C7|)t(5uUn~3IlO}S$TCd?B46a_-_J}G5rZXodnox%~
zHW@FPhFl!W3LmrJBzoU~hntO%)P`>b78A6pB=VxX00Y;;7E!2(EH;x$T2-vARMiW`
zU|#RTfX$!iN9O>JzK>VhuAM&xcTd&#a6fzdRmoR^0{A4u&I2e?A0E*u_X1b3^T)u}
zKi%FCKPDjFJO~dF5y2KPjlo!=L4Z>qEE9bHM<M-|xKV!spxSdL(f|J$Gw)TM=B*$p
zt+E6e6A5nU^#xb&nJ{~clB*b48>{eyqZTyL4locsC=r>{IDs4xh~V`2&ONFop(>V8
z8l1MCxgsz7{{5PZ=(s1s^vz+KxpoBFN)_ggM)j79kCHiMgm<-U5F;@c5aKcTo5C@C
zPaYZ(C=xHf?|QKd!x;W=G`wA{Cn`-Znr)p+zBe9P9`I*?^S|n2oAiVmF@6V;e=M3X
zs<x<K;Fm<tHP|5@d0LQI>}ZQ}^*p{1)7oFd5sqX8&0ZU-Ruo#Bpek>+>&?>t9U%k~
zd%6P|U$iE9|Fv&k2o)i_@{U#lEuqJQ#D`oI_z6F6>j-qlIm%_hz<jNV$`o7+LcS}9
zxFq?}<j1cPzxOY)k<BwiP4lS2k+D1cenx!Sua5qW9btam$e+BCwvKAu8s2Q8U=BQH
zjA$O%BxodrJptpr0s1pe>RKh}9_QAT4Bj2X%@CEH0Uyu$;rNWH28M%-rP||WKk;{%
zf=tU_kD3UdAI+|rjQ$h!+LJyfgfN~YAsmd#J7njMgNGmGcO*O~jv7DkI%~fPiSL^?
z)+Y(!4+rXh<^NohGaNSWtiD<!!dQfOzIT+wGSq!>S(%zKo@KrxuBcTFCZYp?HOr&2
zUJ(36z(Q!%H|s(J5c&dK`cC<N3cd%WQp-F6X&T_rh*QH$hW!%^h$Erv&ijZn?JK^v
zbbf3m=}oyWJ;Opwd4rQo_+l<2z(8iid=~Q%OlTkAa8p&OhI~gM5@t*x9|jy?vO_w6
z^)@}?^xb}iAGyS0Fyk%60xg7W9#qQ8QvWOn8^;v;X$ko|!!StmD)H9Dpnz5|iNP)j
zh)~d~!Jnl3(}F$0UOc_xEXc@HlZ?K<gzlWrknK=QiPdgyejKaT8{mq>ffiNEh~Fe&
zAdNW`1M<iK7oru-j~lFIa>*=^ePF&L9P&&!q|x=qc+_UtPdl-$2%|j85&!?kL4gXF
z#(omF=Kqh0=^@6z%tCOK^C*hi_+nx!fQ7*Sebjr~L($VuTrZFx9w3zA@_J;JGL8ri
zzbc8=aEF92wjkM-x5NqDy@`x?{{VBZ#ayCg5O-e1ClgG7&W01YG@(f3uLK5v;F=LD
zX$8)&0QIPzBw>>8$&kd;{|Rerjz&Hb$AT2dxsg!G$>*1d%LWfM=MQ;gF>45NVXKV(
zBS?mqVHaryaXuz~X`cBxGSY~V0%qi@l*R#hW7+gE`0pi|On(S-!boVd!{)|L7X}s0
zj$w@|Ag_97Ieu>px4#Kl78wVOCdlN(4$Yk;>(kG7@ExW{Fb23L!e6YdOjM>Y36vut
zA9a(<5j5Y5#6;o?j;1{S!96;`_k%SwvT;z#={s12U-_-aJNSW6AZEuEen)IG*m}nW
z@!mY>P@Xpk{1a4}MXpK)$mjBP={aN$W5N{C7)~HW(HPi_u!gyOMJS$0Dv`V&iRQUb
zn9+4^JdudcCV6+K;(T{YDf`T#>x5%bodbl!qD193?C+Y|!X^hz@xB{CEK2@EKufsa
z??apUBQ|yQaWt+!)cVCOaiR76K%1SCGkw2Qys3?H$3!N9Ir`v>ZSQ;|&It~o55XS5
z*W?+v&Ig!y|M3{>Q+zbe0(A`!?o%csmz%>-W<IPum^+gFT=<DdS6wH`jWYh~nKYO1
zP0qZ^V~8|`a8EJBWAy8{bK)_!y;Dd0eSpFz4^{XXQf7jgv6|v@GZyA%UpxHVMS+SF
z5Kh3Lcasyphy?H<Ygtt<>hd$`^Y9k-Jkvh@ZT?AWKQd6NG}6Rtn`Dq`32(iSF^!pf
z)>E!p>K2IcI8q~AeFQ2|jIizFg^Usj#%yyW2#3k^3mQRz^2RHYIxu(@cb#}zXAnzE
ziqVYe8|75pa&d^tUJ5T$2zcP;{~2ie9t1FQ6*GVU@6(_S6b#gh&}-6qvmo)EymU7|
zcqb*Hw5S%BO;X*z5aLbXSL@Mv63>V>^LN1vzW1&X#)d%D9M6mkjaZL*0YB@Tfj*cD
zDmi;zTM4Y#`MEYuuk%_RX#Q?KSuhYjJ1JR?wy+L^T)UvSnN-TARWhle?`!XR;;q}a
zZ#g*kubLA=xF*I-W2YUWO#j6}OqsLPQ)i4*^3D6?!^+DR;tR)<ABx7d3e<(<^$x7v
z{BI#?Y#0bWo?l`5$IFM*#<G_i|HQ}-0WSQ4={|WMN%Mhyb77s(Ll+32iPM<t9r$BD
z5s1V=2MN$eg#<WkdL4Yc(?NN)oB#qpj`5k6J9BOz_r`gYTst~Oy_|aE@tDU%cf_sR
z?3b`IqsCAzJXA{O4K%oMLq!l)YGCDya^%;P(Xv5oCebhT;~pLGq<@aDntnDJhyVry
z@xhy-plX@{43TO7gl&(NN<k);dCP`H6h!I2$`r)ORX^ghF%2R8;Niqa2j!0*chXKO
zML7Awq(ojA3gU7ovCiFdR>*_i2>D3_t#qH}!m}Z~*~)jWD&4zw^S*a<J@5OL7dzBW
zPFQhF(kYzl@a#zHK-`^{Me>dw?Klnp2s}u(;0?q;bs)h#N6mj++5xMCaWJ1ZNVqy9
z^2v<an~09)v)@xvqW221Rtp2?<k82-e*0@TB~fJI?PryGI`}HaSZ{GlVX2cX*ni`2
zpTKsnxf5e)TWY!k^qAhfIRfx%?@WaGe(ggX5sF%<$Ursd|Hj}ofeG3SHLzkZ%0Frb
z!o@^xhyt~+hywb+P~ujv{A9ugl`K(7lq8T<hhe55#2++?3hW=+Or8D+1#oa5dSo8G
zG7r5ln1I$9R{H&9V-c<rr0LtY;yylHE?l|CPBSL{8CJ`#Ouym;?mtS6-0D3)dvYm+
z+yEf@@4Nr-0u`-`qKEt7hsPOr#m|(k{}F`TKBj-Y{*LCv8*;H)va<iLvDovzcU8jt
zewuYNUV~pOGQvom@U%N=jUt((Q#Fa5e9TP7f8t?+<@~|K(oDg{q?v<@Ni*=5a^cUQ
zXZzr@%K+SwI9x#Vez?#Mah99gi{P)Mk*{&q#x2axhI(#$E>yfH&+}bL$&MiB<&3m^
zAQN%gfBkES6Ap3NWp9pU%^z3!EM-wBU?k?{I1*?v;_%}wvosN@07m2S9{wdG$$97S
z)z;F}TK|ohV6ZZt5bbanKQx&N%!%M#B6-Y&i(Jrhf~e#$jT7-o#eL0U`QPCZVEfZ5
zQzXQS!>(V4T)ikw|NjI#X}?@ejuAN-uczn!Osv8N2#cFDFrWD175*lFFY^C<pnrUv
z_5LLg7{15VtCl<^YXzo5yK9oZpIlC?v*zM;gBM7qZd0H5DT9kiGO*Rl`H+c32-w4j
z8uDKk;DC`epNH2Ez0Uu|RLUEohw9(N`>b&Ox)dE7czFufjIo`}kPr@u7L#`lw{_%>
zmezk6-|$(kcS#IL+XDt@o8#WyD^d9EdJ}SP$uvs2v4h1mGu$KIG>N>)5r~Mzb8blD
zF);x@|N3J(crUxRz0}k(lBoaBRPB{NAH$h-J!Y-{-8(^iS5!oQlb<gWhxm;nMh2pD
zg$lXqT9rCKKMF*vlFiLGFJ-8;8tzRj)W(R%`a>mzO>*<CzqX5k^Cl^ihobQ%kqzL_
ziqn~~q{XNU#L>xPOC^nX*<%=EaJVakpT`~(xb!WD83ZoEcPH^!&?I2Pu_km5xL;BN
zxI1ar=6tF>-~Yl_yLYwa=kjt`IAuEDi1=nrjUVgeVzte}9gRaF-nnqnTpC3&aNag~
zxHjYX?S~VrPl@<K8zCq1K&FxpaafcW<v3H2iNo6|hN68;*49o!+%Na(l)DR|hyRTE
zpCx=~%5RT(!0`--kv(%q#rWQr<SiQzW&CyA*lP614xLUlkwXJDs>7+&FjM{=_UD&P
zxjz|+L0)ZUcl^EW+(#AEgcrR+0&yA$A&H9Mza{OMLm|aHCQtrM53GL(d7grXspnTG
z36Q=?e_SP#=g;Js?Wv6TL(f6sA@dA6mxOtkWy=#Kfx)qphPfepX!D2X;$RD<l9TK7
zUy1vv5gJ6iTEvOt+3ed=a8;qgKM624CisSs{xS<o6F<x7(D2&slY8sg$*xIh{E@?#
zm;U30(sq}w3+6L<NL0z+e99q|;P`^sReUE>hAOyFhtNZO$8d|9;g6RarVVhtI@Q?g
z^4wR$9tu1Vd{>Usz>iqvUa#;^gB3_+@hpI0AGuGQC*PZo*1SmkldXbHFf81A&UC-R
zm#(kNP^0IRk*9-@(MHM<e)EWzbIK2g^Rixl|5^}l;<|^_|EK>6Z$nj9Mu^FXn-dLj
zau~HJZy(DF@KKJYeJL60UJL9FNDfPzCPjqYqXxtCaWWfYobfN1dg`<I5$%DOix4Kj
zp)T70BTL88CHi8F$MDoK9vWxg;G$&DD5!;A>?y+T#N5!vq_MO76mw^UTIPV?;`qxJ
z?o3}7V9Rs>us~10Lv30M{yUTw34Q|=hR}(?4*^t5{mIRa1S9!uNP-Ueb7z;62uID8
z3SWXrjt3?t&HhNmH3zPL;&9SS7Wn9k{9O@mMpIvc`IN^h&!r=E`2Ej2;vYNweyrEQ
zC?on<g}WpS9(VYxk0hrSNFBZrG0OZo9V7bYN-;0QaTagI_sI;b?K6!HZ-x1uz=xNh
zRh>kz@IeuimO>7`ZqUp}gluPJlfnUqWh>j1GzSWD&?-uy55Z>JV}{uvv^ZP(x&1dP
zf0u+Q<xD_EZPM4b%>==BNWd-m)w|xkaE3Au0itwWz7lYrF}$3=#P1RHd*s|;Kz9*|
z;JyI&uU1xJ$*-UcY)CK2@~G$j5s2PO?~mjKa?!8|dfGnes-T<%I_pC6-cuA0)(N>K
z-7Fz>U&)K)<*2Isv6zMe3^_DL8i>Th7>-P8IP?4v+DaSz+IACg0yEcicR%noG-ddX
zE|OT$bN>w9-FVsK{m(yq+h$PVwasq?j~i6+x%NG9cJk4Uz?X(61RKIkcb+E)oTCI9
zN=m=@fwZo}Mo7L+yqAr8N%_`rpF(e{JR|%+yx;ivp!rW!m2HE3f#|0Q0*L{yt{0hp
zv}th|hXl`#QfbS;zc`F2h(Yl;C+EaP@U~$8#!uz=NyFQI_-@>Av%kagj+(AQyaZov
zwkm*I+>EsZ11+H)oN@$g4>F)Wfz~)42E6p~U&cow_G3Vs#d-Lsov<nPn8I8sl#!qb
zDL8+t{FLZ}v1C+6p$$Z9lNbD+Gacrf(-Uo*5yWBGU`!>6jN-K0vMN>|=G#*u@Kc+c
z62zJ?`0xti3xU@}Ge;Z-zSNeA4~K6clx2fZF%ZovTN%nAm|^@FZWXP}Rj7_ZFr5E_
z{MUES7#zCQK^K&N;$&94V5gz(Fb?eMYWlC$kW8e?mlFtG)?m+g_2!$c5jCgR-9^BS
zi1>q3Z&4Yr#7`B1Hh}3m(GWf(uega4XRZnHp)T`~*%8PH_R#$kOY2d5A;>d05NH=b
z-OBoSAQ0*r<z_~l4;TDQZVP~I5FIk|I7dn0DxB&p%o&l4-hpvDbD+J%@>HsKiHqjD
zyBJVH&k>#@TuhAE=I@h&Nbp16i=z2FvV4)(B|rqlt{R(Z)<1LqkHE%ufW208&1b-w
zpHtU~uaK|ILe3xH;0<y4AK-2)wJa01ewUiCKLbqI@Rjdhn+IY%Any((V8UEyfgbH~
z8_;=O$I1fBK4WXs;rPN5?n!t9dvDF-%i$@+1r(<je^(2<XdVZfn~vVZVHhOjy4!e0
zu#BB@_(P0^4#<?p#=;4cx+kLY@Y_+7n{J|cxbjMo+2Z^~jNryA@tX}M`oJJPNZV{5
z!~O!bZ`^eBeEco=$NQ_P?UhIkc|H@lbwQnpaPu|)$=O+7!qiTdm5(tKdi<onk0-Sv
z_|jumHZj<V`LchA1TabPGfoAEVVv~*FND05t$@G~73UO)1)iJotsEGh<PCxT;s4;D
z#z(^e>b<160!Qg${7=8hfBt{rI0MyfC&viuQcU*k$-y5Z{ahzO8ZpBmsES(pyq$9R
ziA&Br%4ufrd;8X>=H1|*u2S*#h$S;?IupcX-9yK-8^S+OMd3OOt`E}8ZQmIupc$GK
z{d#zzsJdNNFKwX!*LYJ`(q`pyc>4?(86Bbh&V;-_48oxgz)yoWar@qetb7|(I#VIS
zvD=JtjtTmaB|qWsfW3Dl6CyD;G#~e0$9oexL+59-`j4%`{l(@N!;2Ts{8T4!=r^JQ
zec*8IC57z%TmeBd=l>=uBOp!x_|JYLmNsnpc&xebi-jkJqrM=vG;B)@PA~wboGQ=y
z_+@>5#d-gNp9Ee`fo(1NGhpNI$vENCfxB%1eRv3-9Ro(G)_Q^CCoP8!+FI&xaUYu)
zy~M<4i18RG>y(^U)$Pse;w%Fyjk@?kox9I3G=%WSk`d^NvnAl(MD@W2vC_wctPQ?6
z!jTYG6K3H6!Ic@Pv?Bk**crA9rA}PKYag;*D6PxFRCsrXWfQzVmz*QQwCK*?_}Y2q
zMQ$C8`c=73?;&Tyu222^0E@tDoDVNBtXJb%@a!EWT*qZjpZLyl!3z(1y}86^cjKUb
zLukRDUv!Ecf5IPthw=k|o_NFUa^E%gD|+#XzH8n3d6zo;e8GuTNa@6H=l!eZ02dK^
z0Q_Pt{M&+4@g5MwJ|o0<j}hWO2oo%?!x22$OpS|&5y5P990z`d6TS()21qsp1MOTR
zjSbKhYTko}>BdE<1TAiVNw8|3@rS>V;=K&h#M<9c&)_iqWcrEViaN@J{r8kaAkw@~
zEmu5DyGcvM@sZfcj<iGmE;r@5Ky<u%JQ8w71`E>Y55>-Y$6GI#jj!UlVu;m&7#FT0
zH3*?`4bsH*!nh{1#ehNj>zU&jQf9^WwQX$quuj;&lVw&br@>D#i321Tk9&r~zW`ml
zy$_AwYmU10TvQ0#SqJ~(bOqoEmE41s*<PdgBY`V!N8Y>{8^62!l+g$E2nY|ua9Vs2
zv<JJYTHi6?{1d>5ybSV6KKL_{XMFyDKcCOUa@Z8UPAA4d1ZfS6fzQDP2=*^PpMc`}
zAjl!v?g1ZnE$=uZ|6hnkN;9qrFajg=o{#>}5`KeQ@>$9L38)MQvi3k<-T)Wn|Do<&
zXzkpXHZS}9C&>m(q=BY>XyLN!3eBUijl^c>uA}$=5sQQ|xJEA%d_?=@Z7&gqY2~3z
z=HVTY^RROKvR4`>eEv>8@Pb0}^4l`B%~m$8T6OUl$oNi0p#W1!>pWvYH2v7e*EVj~
z<9q@pU7$Zn_+E$lkD7EkA~aT}5lCOU-NWf1LT?&WC1n5Q!N6B_Wa0fj6koxYr)9KX
z|L}&30=;Qr)vEw*iMzW-3I`9Mgq`#G{QOoU5%_?X9G}zY#)}doJNyu1^MDdPP-XMy
z7E##1MA#B>`O9Cg$}%7Ae|YcyKmG|eC<(jLe@FQ2IHgKB8`=a|IsM2C`h)sX2uu;}
z8lzudmy=4@f{W~~cq?L2UpB`YOnG4M<+#pD>aj5xl27b+$&D}ZmZYR(`6XuWx-Hpp
zFrbVj{RE;jaOGIg1*PELME?=8xnbQzYm*{~pL|@pVVVknXP4loMI1A?RK{Pe_<S#p
z4z8X)9tCLQkN@$rE7u4AJHsno%dg(r^ML+``+(*~UYtGM0X~Ju`x;H{UgPlJ%sCqw
zx>}99<tlo{&mZN$pnA(dPNT!ikA(bEAP)}ic#*u*kJpA!rhhMhnZGxwUO-zr#svTW
z@^kQ0<DlRp_ZAMr2X`+4D^>#jTj$!jwx9|1yo2vl@!bLdYrjBspa}BxAN<2(P#N~V
zHDCI}0XFn~v|MNj7I>4dFA2*1mSlnC0Ak}{N%(*L)|jlJ(D&xT9f2aW&nb7GvpkFD
zaEdGxZ)3G7?8g_H_tEMyQdAH&f(QQvd(|8-W@_&75|3lr>aY(FgiSdA>)yDluR{2c
zPdCR6m9lb|!hI__<;ih35r~8_JeaQ+i6*te86rGR;x)~(9IroD_(Pw^X1I;4M?YJF
z1L85!nFg@WD90QaUJ$fE)f-gg;RVKOh|mr}QdWb;;6l{0MwfQbfc~mee;z^_q$fzP
zIJ#fq*h#)Y&(ts*J;vO~00hV1hS>HxkCYSt!`)DTy5iyjao#^c01UhJ+I*Aj{^AH{
z_wsfBF;DcmHhcDe;_W}6Keg~{fWZrExuD~9c)_b&EAkJ`>35_b1d3!J#rPr2ZWs7}
z)_?(Z0v2cDy5X-fag>(inS1Ldj+%scAm*TML*PrS2dc83a1phis+hnl_a7}8vivJ#
z1g&5@lZ1CeA@DXY`yT<1!AJhNum(r3hsMwZd-yiEZ`B%?j?55&3t#h0Ecq_n0o54-
zW^n%o`=~i^GUCwR1pFm#h<Y}@7E)ywcMkA90UB?GBSEnWAj*ub&so^_UsyNZLZc{w
zVGg+m^U6c5fq{vd<KDIpuY8w?5K8zL)>hZy+PBZAK?u_MPt2X9xI7Iv4QSU0%D$a(
zD-85uU#=%^k)p&Xc>W_vDhX;QuY68;h89;G!UHD>z}D!m87fbW$EAgNF<vqwaUYv3
zW;Nn;NQ{YLn+Ln(^2@>!e@DAirs01#hir;ZFuZE#_(y^djdipT2A7IT?j=4MxM!}T
zh{d}k&u^cCk3#n*Z}D?$6y~tgRQxH1W!i03e_J<E19!RlF+su?f?8-pn)p*tN8@@|
zH8VUmx`oh>hAbZs)!~^0*BMBhz8mK>5OGAfJ8%4$OwJGEJP!}p9Y8;F$O)EQPamOx
z%-?83|0$$`Yg|A|On5`#KLIe8lQq;buJoVI|D5n2+AtyaCI09?fcK>MC4|odOGsYa
zaE;4nCYH&*ALtP5=x9*Thz*~5JcqIIJlU+Y=_p@rO*tGyy>zI>^LS<lzl3~dZ#3eb
zFNqrp5(DoB{}ITozvzMa=?4%oG{^6Rd;x{2^V(oToPLTEe<F?mTd&CIa^qP4#6!q_
z2^ew%(*_a!N!9`<!Id4I!})l6Aw70j@v=Y|Te=t4`};-o6b}%OciQuW1JV(CFEWQv
zlzab$s3Op|CM@Sxq_ftvSRFwI-W)<pSV@b?#A!9fQ#Zi}f@Y7z(FKswQ6Ew)4!^kK
z4;w%c&=KzwdII3Cu%yNBGnm>}D1VBF6eIZlF|$v}&Aq=DNr{;ALI+k&f$=Kvk0jcO
zvZ607Q0RP5&9u}j#a;bZ5sczC=?C|9ee-1O_uSQO6r3qq)0BfSq&){;F>p!e;k8QV
z#r>2(O%;GM8S$_s_152t-UjrIy~#HEvue<Qt649eLR1CoY%QFGP0$x4qs0patDrCN
zrV_Y+x#Ji!cAMZe0kzxe@%10lWVAJPJPT?2Ik#$Md+%HrMjwADAQKq~_+B@cW1LRZ
zzu=Z`tSg5cp3p&wszc-X3&3<VV2tg=$n62_!W2w}Ml-!2;4cYLFOP5eG*aPzC-l$5
z&<LL7A9&K9c-!DQ*0gV9w+(0yEm+47fo!xkCcn7JtbgL<&AaYei|rs4{c;cUJ2N#p
z``dv&BZLm+dV;NSbN;==K^)zJ--wRp``mCm2lzr;-woghT4|*G|G?rS%MOs`;SagD
zuj5kHON7(`7Se4$Klmp9m~@9MIEeD_kBN)p1^<$D!7mzWM%x3Zf8FsB*u;Wrdb2O@
zi|`}PKU|<q_4c5rxAGiza$|1a9n=MTfMFm<<un4@(YR1%f22730N8Uss6Mbi`^eQF
z^YhjE^uL#$wVD6mo^ykSO(jIG9puc5;eYM${LzO-RB#w&00Zb&mUCqTlqAjODpY2n
zRX`CbbPL0>hSvcB83(oTE6nTkRlnOG!Hh)tc{q26^6N5(#dAdjSY-%)B5?$ybZm6d
zj^py~HFstp<6`UieBFS_%dJA)-SM6DG3nCtcU6RIo2YFCAIA7`3fhMtJ3!@lC3!nI
z7C?CPEc&LZ5PBT=|HWJ2jiLYH32;5Z;UtA+G7>y11JX>;xCEODk^Z2JelAo0<gYdH
z6dvRJnee{U=!Qt9*tu&A`ZzSn)SiFGS||c#g45{nf(73^BdM<i9&Bq^@E8ZaJ3uIQ
z8c-0o*8kp%vL74=1B_&7APtj(j~j^~!XCwQA7-BTOVEIX(lgTfylu_Ytt;s-AGS|a
zcqS@0>cU3!ZJjBgd?ixT^ZppL?nl$jOyqB4`d<Mzk~gyswEcb;@mIu4#4EJTbA0Qa
z;zD=;M1HIK|Nnq2M8`PYJn?)xw)+1JFKCbTpa!iy8^B^~dUp6>ye}QW9@y3a?bo#V
z&LCj`-t{6y<py5d)B*wYe{g~NKMco>-}$=t)z^uWlM2Si@W#|>Qozb(QPuy%S&8TP
zrO!j~g*NOdcQN-a#%?1WOzYu>Jl}Z~Tf|qR`pe-yJCp`nA-}>~BS|fe%;odMVa`t)
zx#74{aoiXUNA7P?@f??K{s<w(J<JXvYl6IARXSHe7X=Ua74zo!4p^|_%&8K8;U63w
z{TC<zGAm$qw$=qb!))Ijhas9c66tPrq5{Evczqy!=5T-I=B{#Uj>o2ek@+inc3|vI
zz@*I>u1{~pcAJkXu!qL$2^@EDW(Zyaz#m{x4OoUjJNRK6S?87+OAw<!`02@y(k@$P
zQXzHR_SfM}CX1GvB1Yj<Jimz>XS5*R@9KT<oTy$10<;w<2}Z|YOxpSe@ITnRJI#k}
z2n`SQJDGYeL-I5S-hbn8>NiN);C{F#?Y_DkkC()J0MEWHd#mSK;2OYY*%|fz6uwXr
zjdSq8G^C%)5Y_4VqAp+K@qg)G-1xcy0){<Zb5N1Kf6MQ|M%@2wBg-3;ALZaX)UtX0
zeB5cF9$U-D<c67IV)(&z@J{giyAv0UotRb4(_1UhybySINFiz19px>^orxJ8f#u&9
zW`F(^(GdryfXMgqPcX)H68@FWfvU|A>|D`$ukzCW1hAOTU+9O>#RI@cd*W995AX3F
z`uN-ZStkfyNHFAvLsUjZ68Fiv9}!-Yge78A?+)<qhkTV{O+<caVad%hDdi_5-@YnR
zau~9b8156<O|5T)F#JaQ(z@gD?&s@`8Tm6@lEc1B(?2g0>NsFrm4jAg%fr=X(T#)?
z0x#Td;<uXH8vBT0qs0YyPSmyk@Keyi7l97J2x);Y?=FCuK3TQ6@b6YVZWe+Uj)Rwc
zWf6ZT3SfkCALd~Ta{uY>cnCU&U{=&YT{?Mn1yAAQ><nmhRvD`ZCJ-<OuVX_*h|w%Z
zh}=w9<7Xo${3g67y^n~){72*JL$A^*EM<S>jqRp7u1#4Y@$-lYS>=5?b0w3L4PLh|
z3e5Rgc3AMrqeF93bN>^^+nD+bhc2-XIAC0yC97jv>SH1}N6fi~DHK~QXwF~v4WO3%
zcQo7ZhVc;BH7Q{m#qxjvLoQ<P;`?dUM}gpd^)gd%)=?HpV^(32(j@=7iJ$nKtSeM1
z^<RncHNj_$&E?eQT$~Xn%kDZlwW9~{Lweuk%(0DPc)b*iP-a6{noIAKA7A1ujPP$R
zFqB4Eh?;SkYb4j3dgAFg$q{jLuzmg88#7PxSvEB^_z2;70|#Sh&*OKNRwbXlO&vi;
zJ#pjRU+<dk5X3_n;ygxPYjpxgq5R$nt7s))<-n8YYg_`tNb>l4+h$@c#BkHu39vs4
z7@mE<o$9`@<hLLG7X4$mQ~)lG)N3(<gZ?I7H#cuK4GgA>zyMW|1QjB{zdfV28AIqw
z2m?T0;YtMS&3JWne%N75x*K6We*%NQzJOm?m-r^mk+|WB3H$fOTRcb@HOnpcIjbt>
z$43QVjpo>DIFk57H|%kw_rLtoez-8oy^eVVkM-)K$A$mPk{aNT!YgrER7QSGGHRd3
z-e`!{13?-=+zqx2XlX!X4IRJu0pIqNrot{8P&!4}VgCwUC>EhBeg)RM)p{n>kTb(*
zLOozrukLYA$xfV+5J`-h{<uR8Ll|d^^5Ry?Xpf1gLwq^f9tbCR=YNj0+-PJDA+~5M
z-aHUZOy;=Ft8I};OM$x$ey}}$G=xJH;lL@--?#Vqdgkzv-p}DE%-w89f={Xb;DNmr
z(dj%P9es#@r`0jqfZWBWiOizB4?jZJALFLxhmDB(&IXQ~XkaOPnRR>>S|B#P7O49=
zkbpuK57hTn{w89;^GoYlxPw<dS0q0c;r160TPX}(#AM++Dk0&N;xa(x7c~)?OMUEP
z@p?)(y|o%Hyw)3c@mEHtLmUJr^HQGL@x4khL^K<t$uv;YC%d0|gOb%p!Qdgr`2X>}
zP~qlIALK%iDpR*kI1mv|kv37n4e9#-J!_!`5*XnDOps@Z;GZan^0730j!S|+6MQ~4
zpc(fQ?F7yFB84R$6M8f-_PU#wlBbvWA><jiF`@F4yfwLeMz|uCC6`cL$u`m=Q9Li>
zZ3?bmTsJ$q{}C@SjBbaB&&K#_9N_4=fV;?TC(UvucM9GZ4OM7i4=Lw4SarfV0sw^A
z60%!BS-Np1kwZ<GTtA%0;p$Fb^aEa-y#ox$lC8xuOIB7TpRPB<bqqVPG?F{aoB8$_
zTp)3$OPke7FlDFsQt<}S9a4{h!5}ogMu4W;7^Q+4Si{v<wUuy|PRbo32p<t}<%j;^
z%AY46hW8)KNW`vgZ4F1N@JB2tlgOZ$_)c+yoDgF(yhjCIBLgE4>phX90DR{Z5--16
zgaLFMH7|uf$>cs$j6gbMyg|EiCcqm%Xn^=uvFDz3={MD=wHI>HQ2+S6B4J7XRwv+!
zUpD%<BAR{r4tcjSRro(2y-l<`$iFrt;%yUi=RXBlb)ggBk^wyH0_5F3fsMZM&yVLZ
zZMFd<C>VC_yyx;ueQ=$JBwHwfqB#X}_MgHzpuF$2fjr67XIwrzZJ^RFz;^301ifJ>
zGfXS6#_ik};on4Bhg(Alj^7YHol15>u*q!Kt6+(<``*9t-!+ENkqL-yceRY;2k%J|
z83=qQVDrJ2GJIZaXiLZ8DCD|TcH8^Jmbt0Zu1lkonQ=GGgXn$=Bj(KyE{~e5d=OH*
zc2TeZZ$&-tWq*$Re+kQ*R#gRjUxy^4Zr2s7D9OU9QT(&#_ez=qCk;$8=@S)(54ZmW
zJd`0WjOORoelx}=11-5E1@$mhcNk6xDs({o{o7T-o^J$R9Z)n{NoWpjhp?kWcAhrd
z&pj>WS9~j}+_U`cYPBC5=lbA=cy94L6<v>%?K*VjCL|J4y09chxo<u{g8asi8${DG
zA)?BYg0K)j(T0EgbY^#dqOJhW>i_S^1CjLnkQBiw$k7>ME7!}zF2)>$Foz$tOk$>}
zxcuS;KgD)sV6fVs5kD8u81!^K7Ufx4{wGZ)O$gXT!Fj~Fw(I4L9Ckhs<9szGfbuPB
z(1KtldLDt`Qp6xKUGK}7F9T$H`<X=&;DXyofRX49|0_hp0v4m*zuYh!7{hSWwdWZK
zH`loM@Bgk#18Pioml_ydDS5Mfa$stt%^wm7e4ctvB6C^gEXgfmc#UvNlJy%J<VTi1
zd*RxUarF!ir3Wq>Bv&G;vtS|QpZqg8w_8ddQUCsK?rsy4{j+C+4(|>l8U@}YXqt3U
zKE%#}htVSS%gn)6KNUP1u%=@OLK4fHK$nuQt~1S*P@Tc2mJOkykTZQfEm-_N1g!wV
zTmfvF{QaSzQ8>hAiKWZX)NDa{4kfJr48<6hUe$vwuf)`K*P$K=s#EB~XR5B4!U)I5
zUALQPfXuUN48y6eoou`lM8AOB?)BpkeZLf(+R|JSbeeg1CCwDtVmkQy78Cc$<cQ){
zCz7Jfnfz|b*vJh53E+S@37X@x`ERXcLK`pEh)jdvB}us8!t59_41|pwM~@JEKg%m4
zc};EDg_u3h<5zeiJ-|kp>smpD<h`cXUg9e9@?Jo|ez8ZyWe`Zwei(?$iM}t#gaoLJ
zYxvmm1PXbYQ}#V<+UXW)O6Si$0TVnfwo&!}1km#Ibd|-jUYP0MP|P8dgt3Eejxib6
zHa!~8CMLS~iIc7s$&J<V6LV{1h|R$kfXo~a`pnKgB9RDk1cEG7yP%pPeg|A9owbh&
z98Z%C>KWz4ynZ)~gfQ16khLsEClGtl#4LO<$wQFUb7teq`^}BUxVyfcD&(I`k)PwI
zfh7z&jZ_P+0s;ObEBNa!CMqL+U*+Shs4+a95Xgh_O()O6C9=LodJ*K-?jmnDpHQ!x
zt{)0`(389|yMfq~J^|{a>^!u{mE=cD&o}OYFcG{BaeGafDBvJ(mkaVqTLi)RxpGb~
zF6qQN)8RScY@vzaxJ#b9X1~N_JA!6V3W%DD;fpEr-I<AD<mTtNLz6r%2e=^`%>Q<l
z5Cn2;Kv1p}N{j$+K<}<xc=GT(_@FD}-hf@EYQh>)t9OLb#al)+OR80~ZRJV6HvE0_
z=2vw^Ps3fD_VYs%2~;vV0<YB<v?LTuguwtKR&{d#<9HBXOh{8Z@I1$Q2b}~T>i=)K
z?0^6MCmGp+bPBX72~Xw8`N<#YahEdl`bmih7g)JXr?0WIdw$*9P1kX^lKBg+!%5|$
zVw9jqstr-3!bfV}iObumNIxisjetVgRUlFokL59fysLaemJ~`bcuYxSMGSMAb_ENa
z<KgAu<{l3Ly}-Ms6U(^>xR_%Erreq@pa1{>001b}Et+|9lL;18<8ICAOq-_HFnZOk
z1NPrWR7DW}ZeBnNtl+^n%=M4rZ`r-Q;hqnH%;)g>T>SnP?pE%8Ta&l%{GdMk<hSf>
z-OC)7-R<0s+g`9A!uFofJ-4)a?_KNrf5JU~Xdc_!9@*=j*xj|T+BY}sY~Q`Hz026!
z<lVEA<OBE~)7w3#@E*|ihqeRT_TIbO4{z51_PuAU9@zGeSO>NbSoPkx_1>@#S?hz>
zJ+D|E(0f7BbUDtBZjNU^gW+?Ij-Qe1_zq_~+k0U4p0Vvct^fc}&q11?S_$DF|NsC0
z|Ns6F3TO>Ol*xbqFm=*I+1!H1Z@DT_@P%lIro)CD9<atKck{LAtaY*-GU9*#_<&JH
z{ysYQd{(giagP|7&B?bmd1l2*PF*ti{aBNNI<C-%CR~PM!h7{?UlkE9t9+7S-24$v
z|6(VKq?IE@n;?hRz8tqvp@zRQ(WL)y!<qldDq0baW#X%ho@*{)_<m?W90G2Di~}Hx
zZMRSl14O<-*&fZPygf2JV_o+?d%hh`kK}|U)U1F1{}b00CU)e_a7AMu%P;V@c4ntl
z{K=bqGgS5Y9%QuFH9boa{5c2+;Q<Do&%Y7yPs7NU@@MnoYw~D-xeHrBY6DCLhTNo;
znYwsroC~q=gAb)}d9{J@0&w?QShe<b&c6h>!H+=c5R?7OR=AE@t$dTjbZPz*@`)72
zJT!lapH>qoRK8!-M*8*fRj)w9tY3nT@+Tv^CNGc1>hP~%q`02FgxmlyHQ#sd{J-iD
z%gGqa!<39f*0(nq=Ig_4f5RvR;q~@)g>LXG?XmAAtO$BP3QivcdKvj%9}dn>TA{hU
z;lKVE+kH&BgeCoIV6TT^tMt%597U@1h!7M4!@I?Nr_g9(N1v09uPh@3n9zg``s0-2
z2+v<k+mi^_db6&t6Z7#0BwR-&r0IEUMutvG)^2RLl}75>{9ml=HV~7NUrDSXiRFz-
zavBr?_=$~6w5MDZPCEWS3h^9bGUHBs)SS)N6+k)BxxH+@E097GwEc_;zAxab)IK3A
zYRslIB*gI_tHyARaFL$K+aDT^7<+JqempHOs+wgh6QU*CZ|~Hf@@sFxn+XAo0on%G
ze76nd3eYqRtW<#N4Mgpq8N-M}OICLzqT3+6Y`cHczIOOV9JiHlU9pWp7;pofZ!xN-
z;$IiZ--ZYSpObr+lB=Bk^LVZD@pz6a&#?B!!q*ks8W~Va2N{Jk!Wf=fax*_SQ)ic`
z&BJ0mPsQ=pUXx;C0wulggyj_`b`DJNM=o-OnD|bJ;OZGf1dMNl;l%TrV~!FgUZv)}
z;(02nq~MEH9)YF!CbtP-*7|a`<HA0Dvy00r2jgvX2q`c<rUt+43F#Gt2l&4m5Htgy
z6&(c+M|7ACz<{*92jHijLXVHO9oQvFYlDZ(2=1?35n0~Lh}1?{L-*BL^RN)$nq&n4
zO$_0bM@sSwzG?{&X}d8n$L`vA&TkdI6Rmp6#bR)pfgiK<m;PV>CrP4lnr1Oz_8e$~
zVR4b7qacwJ<>0RLO))Er;|9~DwTl-JCiskuW%N4alQr;;iKLZ10Xk?8#zz1QtYlu}
z?{|X7#U}Wu3w>d@w4M^Tx8MFdBp4ee?a`c==l~1h0QJE?83YqhGDFokKID=M6Tv;W
z!*k}n-|z7j%-?ObeO)gF(STKR+(mfzH!-dL3USEuQE>HRXiC5UXf}uMbS1@KMIM)c
zykCuuq)k%zX)I3!o?Udjkt`edn(l|H?rrY~Ny~j=2@Yk2@=prI^4ip)MF0qo)qh|A
z@s2k)iu@zJXTkOBJp4V)yJId3dIT^Xu&A>i&>%?A|JB5=RwhnvZiVBkVGmBRpBoIK
zC==XhV1IL?U&hcH!%@HhH>h3<{d!f_9h4!O(19QAsXYbZ-N69Dd>z@Mc+g3Z@E(Ew
zUk<~{>aG*zrc;M{(UZhz&h}4cubUqjJ#%?Kj@F5Qrb>)4BM6dy(H4jgg(D#0t+VtF
z8-rj&T*wl^+_)IVanUz4waqWJ_lIOBTvrY{ya>~<{GMD~PVIG5@JW$GJxM>^?|dh6
zQ%uOeEr$<44y`OhJ@T4YG)IWdi8iYj$>Op6(=`a0pNgWL+1JZ1Ttah1=J8*alSl+d
zct+01D@4Z(xf@M`33zpHj+`)f=x0_1BkwaEpn7dHadl5y8aKw|QCozpTN1$rZ}1L=
zsU=@dZ17WpF99~eurI0I*@W1<6Ye*t61$Go&7jU8vG2VB5hNmFNse66_{s?xwNtdP
z(i*5tAh<)U9{*fjQ;zs-xL%fqycoQ_VY6IRw8%Fa7@crUBpFSTZsBsv9n??YkB;fF
zFA39Qo)1MQH6h8(VVFbnRemIx+V#y{eanZ&v3%WBE6reG%~gf?oslbVr5^Yq=Y_#I
zt&RyEXEn)YQf_;{i~JJOW$UEp!nO3sPhDm14cL7U%J_;?4F2p5GdkfvG@*@4`D-ER
zVkuX17}+J|r*8O1CZ*)udcv@wIedC>-Cnt*iP?YMEq)Nd80;ZE4Th0|WA}J<!aTI8
z1&k016;w-K!W{%1TuBYPbQE-6(XI$_!K=T)K6Eu&-SYBjgjW@}Dlw=;C_jYb4~o!X
zy;t(si|)7}%0VbQtyKa`*l5bTi~Ks1$Au{)1YdYx0NWehmj*rxQA`>Pa1NH5Aox#v
z=$yR0jo&uR=-*!#vmpxk)^B0dE(}H%<cj#dZZ8+feEeSob_G(CblkjP|6G>CwtwFx
z5KGJaINt=)vv0=+i>sGft~ykbqR_{ual!F<DA+yb@qypqyE2MZHcP9UD-nQ1z6v{`
zmRiR|LmwApG(TdAxixHl`7IFK@$nX+vvA7oeEcUJ(}WzgClD6cWn<iQcmK(<UyhEB
zPOP50Yv8v)agcB=uo{%gP+TvfI!Wj-Ia&|}NCb8t2kdKtJJEaQo2C<Z4Swj6tnKfb
zffc`m=Qf!a8-&a{!$(GbxF^#=I?UgHf~pu+;OGQ8>nI#38i$_ExHZ;**m!mwe${5c
zH21hO0G155FN_gp6usqj{Mg!rJW@5xM7iI=K0LSSj8NamJcr*!z}`FHtF8%#F;dY6
z`sg_uzr)jl0%42^QCQu1jfqNQc0OT+3OqN(y&v;;e<e*z7*mp3Jp9l>EvBlw<?-B+
zUlq$UGcw1B$%yza!l=Y>#Al@U$sxlahGEwDxsovJj+n{8E|+5WdxyqvEK#$76Mz6-
zj>2Qlza;5&yiS=^W(kZUu-79u1v#iu3<+>NChZ&X5<bJi7Y{Xv27zNun2y*WG!+~^
zg}LCGfZWeo9s#Z`X_7@N=Co}55>|$RSI6^Lj*KWuOFFg)ywZ#pKx`Md=)r|UWVp)K
zGBLU<t|%07q2QDt8Vv#*6ACBziUeAh-*wf$g?42B56oBiVcPhK0U<XIw9^~w=Y0ls
zrg}fY7baigyktZ$Hwh<8-Hg74t|q&3u!f*q9|>p#jK3X>fEB`0C~l3p)m58<=*^9?
zDUKbj+usRVDgn{eKxW1We0;VZ6tJ5*o`#ZM(;S0hmaJxUHki<F@L{7#tf7ho(7;#7
z#aJ&3*emR8qXnhid}I(hoG@q0QV^OZ2n)l06t;M_WWbSu_)1<I#xQV=hg5V94c`n8
zIecEhNkY<@Z=jD6jThVGiqhOLB;8eWX%buHr%n*%?&t1wux3={_?zbG7Eh~#aXFc%
zMRme*7_d5y4$mQr;yEQ92PP3%5Y&DPYW6&4oBUmk=!%x;-xZJhuCIbC+Q0w}S@#X4
z>d;<foJJehmnm&0h~lz;Bt8_<9Xto%sQdE8dvZp`9zyuVr}#$QNIRZ~R&YQpl^5b8
z<7KHDqaPjrT)sRoebmWP{C*Mb+3s|0DS`my<1@2EFhJk2$#4?zG^!hn50s42;Vo+R
z4J1g7b$^1~fP&ir0J-XO7LaS<3m2g15*rMp5{#=KB@#eNV=uvUf(5~14)Y*~X^eam
zPpAz5N-$g)9ijqMt?>L;>s<P9hX3Q8<8llt)MNlA1Q!UljBf}6+~_3(Aazym`GQHJ
z@BB_o8TIetp{t^!(?dErd+$U*z;p9>tRu~#jMY#`_yEJM?%(eDF*9(V2Dr)Mq>IUN
z=fwTln*I>1N5Lf#(oh?McR@J7FvW=1Hns7VW1|t=wR%o8CBjxIUYJD1b18WA5~5F+
z%XQcBoRQJ5p_ZOl=*`d)E+^!mIN-T(TfszRAv6MN#OO2NF%5wLv;cF14xi!e%Wn(?
zx>l*KC#lO2wVf<q8kg+x66c@*2Kb4@Q~^MurFEEVNnhjoX>Vz&UoL<6zZ%4odH2u6
z+P$Ax-&M)u^4A3vr6A>IIu5M(>a8)Mi)|1Z0SMXG$_IV{_g{#yI0~CNW&S>mc~MAj
z&^TrQe$CiC%ven1=)?%DM+jx)ww9TX##M{`Bv`Ew7wFs>fmFg6aeO;j504M^Tn%k8
z+GT1Ezf6nZdgJDmSniX#jMw<+L4~TFE0qs+K<Dya_(nd1q0BNfxBS>%=KXSR@ev&S
z+?U*u6IJo}i{|sea!a@IF}xI2JTvB);{zu+ABXA&E7@Wtp(d;ly_LtaUmqe)ai1AZ
z8iRqY081U_Jz&E1NN>epjJ}=_^5X$-k|c*8onn4WwEWzBWZwjSF#u!bjS&|$|1C0%
z6r7;EMmS~K#e*_6!deZO@H`AN3ZsD>5D$;87dnh~N`1Prr47r6VqXaRGbm?jb5p1q
z1u_|Osk~nS?O#7w%t|(c@5YxS3CVw9ZPjZCK}F`^_~S<o)`HC}$Phj{ZY~HQq9Go0
z+-tr^{@eyPyB`IY+*zf8)M{IhxinV8ZA)~R_{+=?O+0A(3tG9cN>SjM(Gt#ehMZu)
zZXrZ=#m0t(_`cX<)a(soN@pOV6-LwZq`IDO6AoQw6ch%m5%^ka#v<zGN6Qt>vWMka
z;kgf>8jD_={*$NUCI%dY=adZ;2K<5d0SX;z4loYd;<vTUPZh90&Z34z5HAEgl=N^-
zKnPp=<KOZB`~|U`2JYIoTu+x0uL$r(d)^U*H4rC=*LDb!*Ce~m%|K&dg#IGhA@WA!
zF$q8;@KqYh^~TaR00gHfx}l7mnpv0d?g@<|1{f#g3mgPL@_(3OdVVTq&~pm4CHSfX
zshOu=Czq~EuT{nKIqH#^^2a~|YtnVe456Z{By5M4iPKfWJbYoeOC%FmYgc?0N(4Y5
zkV6`FiGTtK2cVYl6`7y_8AZm^8@#8bV)~eP%jp1INa+Agli;QZO1b(w!QH<`Kzq8>
z|EvA6sLjkj_$9~~PCJo#hI8p;zkmv{8Z<@?P0!TeAYT6jx<aN>J5UeW{#`3g|Ml0t
zz4h;}eS6@SfNSj*U9aH4*HXRyA_KL)MtGHQv%lN~c}OVZx}0waax=%xCXHie8S8Wt
z%ntb<__##VM*MHEgrpxNdW(pFY}3)fx^UGVHq&r{z&(WQJ|px-!G@ylPSJ+#l=t%>
zNqsV?NBBm_>PA8lK*klSJHs#yfQ~SH6Lc}qgnPRU$Gp(|CAD2gs_>L}RO`%P4j-RW
z>*6)VZ5%KvQz83VzfggMTu0!-onr&zZMTtMs*IF=GBEUjZVWr2MucjO3LKE}i-pp-
zT>S3-Yo~t~r80@*lZu={=tdEweDg$W1BCpuXYx&K^I(ErT;B_GZ)n`s9FX}WF)I>D
zadNz(8!lPCOhU%^C5&eDKRg&uToP8mPu~T1vTWi7Y}ZMm)d8y_eB3=%lZdOzb-J2l
z<Gk~fDH<9BA>nYZ@>#Gflot{vyieY`<2mn=p`AW_A!ttM#>Cr(@-Trr#89G_@pD_W
z`*UD05^K)y_(nWrnF(V=fMkBI@9jhY%JqEr!R^=je{-wv)ldBZZ*_Bix}UvLdq6>d
zf?Ikp_E+fqP8@gChX4yJG(QA_^M9n9cwhkkNzK5K=2_&qi?$*PIYuIR$r+B~V4^kU
zxpZpFg(EHQd@<^ytqWQ`e;$`s5tg-~#J(mj2W_P?eIAh)@BSF<!|b-54GCdkU&>^=
z;G>E4fdJhmN?#VXzCHmC=_blUK$iyx&~1jN$!Kldqw$&`8U5VVdpP7c!L6ot_Oxgj
zp1nU?zfl4)H*{_7?6}Y#{+^Gq-d-6!cRGLYAA-!Yp>r^H`T(W)-v(NlV5>t&lNYpp
zX7o3ehV~M>>9ak2MqWtJfT!61$M1d}i=#H-$XdK3KkN%)94&k%?PV_o)B|)w@3i#X
z;yw`gu2#8(4rG_abt);<+#?afi}}C*=B;9}IJa7g<i;}Z5gpC9DbFQ_ha9|KOlHUO
zZBkqoM)lAsk#jJhc2G5<X5)_qc)@NsDc}#BF)0Pm93h~Whr*hUC8-Y<k1#i!;k`pk
zdjS)?KybVi{C7X_+MgAUxu!^PKorr!P`E>Bqz1<-Mk}-Ushoghi`Svw$IxR$z8k>+
z+8~UA2sAKM0T1{?+QB4+WPBEgW`$TC@HnI5wTuWWXjPxa(RjeR9R;r3B<ImU;7xos
z<N`PP|91I<peIrO{Ttl9epMrxPma(v?Lav7PnXcb|3UBEs#ANZ8~EUU_|+R#hxpYG
ztA;xu@P$^8LeQPWzot6%@L9)v5$k5e1bSwJtJu)}JL@z0W#OF)@)|^FgBQ$PZJ)$J
z4B()~Tlc{aX(XTEk1kvPh{P@MOXfbI@rC>1C>A7%>gR+%7}0O?@K?lo%NgQ1j@T!C
z;UO29rLXq*zBSDn>YDL-G=h4!$HJ}OG{5xSX`nv!FX8ZT36E(98}upm<euZ{IP1^w
zrCVI!E<@S8Z7&f#0aOR|7H;1GiC&M<UgXWt4##eM7SAX{#|K7cG{+MexbYu*p-ANl
z6ObC<Gr7MF^77CBd`5WVvq%?NqwLowjt_(2hQdb#1;2CPlO7QiD6HIgEaM>oZU6#g
zDG_`Q)9%0_q#J;-^3(6+!|<Xy<GE@w`5qXYCPp_Fp$t9C)kN}NH&}wjrq7r|geIIs
zM26_smQUoc9T}2%O2{(nFd{5NYY5yGYi)sm+=SR~p=a-cnvjFB)*9h~0qr+f7Um`I
zmSZFJu-;|yUNSjQaGtrhdg86WJgB_b;P)i2$L124#5UcKW=tiDMkb0Mir3)@>9=@b
zHvq=tAAcW!YK9g8vCX3+Snwb&V?ZwmY@X0Lg;iwW#>vnZi|mK&_yarF(eDV-0Ezm;
z=l1|H)qKD7+f@ND90A2%Ky|1SS9|R{3|iw-KUja>D%t`Xk~JLs1Nq<Kj|urqm=HzE
zBt-du-3fn$s|r7bIDTs~<qXIRHV3G~zq!y&8}oR-m6UsY63iZbZfnlY$s#@w&P<}z
z67N;sBjnQoXZh)W1yEPaz>?^+)3n^i#VDP2X__*_!9)uF%{;W1OoHqUb21OqjW8}v
z3@i`|YL<ikE_^>3GdIwEvf3@5ul++F=S}|(fcxkO7;L|f{9mI<-^2i5G`dggJZ6=w
zhoCQcD37*4B{qJyf?-1{tMPO>F@hj~oQ4AYW=k0!F!Kq!rlF&=5jFqv+C?bC)$pGk
zI6!4#G#|ni(4J~AJt%mI_ws6@;_;m0k*>!^4H7NcK;R<)0Z5C-%=rA6G!3O_?C@8m
z2^bx5$R@5b2u|*Z;VzqKBH+{S8O_b>o4N6fCs42PFo!hq{u0>_h%6(F8vL|J6_%&r
z34#F7*ydrhIUsZ}+&P~u3R+)vU&3~ZBxE|*h?lC9f=g&}95^eF(S6WCD%Fl82s#~B
zpTzi_iM1E+L3qqd$-gC7yA&bg*vbe3z+DCaF8*KoKR>*7Tp&y;0LcAwbN}-JH+0J?
zxBnyl-jA=TJ-{Odf433$st?;qjJ~<NB;boY7Goj=0gYORV;DoYLX@cwj*9%_&x+&2
zG9JM7MfI=eVd80jiFtl?od1CX5WgnCoxJ>a{6E5lgj@6V>P|M#Rt^lsgNjJr2wv&0
z00ML99Q13;=C&55xcCgG`$LxoChniv;j>=3?$^T~uUER-2sIf&9n-&~Ub?Nc@zrDQ
z#(={OFMvneS84qE^~FOqea>;D6}3vS3*zZAUe%<M(`&*xAk&%SAc07JuijRb7v<GR
zH26*fe~alPI*mS*_Y(gvE=$Q&Uxe?k;fv$<m`M#hIcDbEzr<vOFk8YjSkuKC1UV!K
zhu?q1_2Va;MP3p&5tX>`p#2Gaodz;j@z!P)hqk_(z6v#IxWwo~pHG2B@pjN7z)Hh_
z-%65N<9p-mG9Zm_Z6UeTdR|^CUmsv)n#ge~v^WA)Loh-@=mqHU)CRxM2jBJoAFKe2
z<^QMVY-+MGs;%A_1a15u^M%2t>uhRCy>Ll{9JoM2)c(%2@58txepiF~8TEK^w;7fR
z(S0tw;k(v2AYa(|YIRBHh{j?(LchlB6E+0uaEILgztZ6508H0m|MRB)f&*n`b@Ukb
zWANNZul+yG@e_a8U*R)Djc`>NTe|-A5udM-`p<#5(MQ5F_i{g5b&R{N_6*LuN&4H{
zeZ%MY%+%VDMGxSQzg@`v*7(rS{!1o?OqcO|xw>o%&5=jq>>7|U%MNbt-Pdy|Mlf@(
z60jOc)`D-%yut(Gd$v3vKQ}efn+p-*aFO$dJVYskWC{QO;G6#560nS9q_z>z+qU3d
zZxcD>slWoq0`P}8fR7IH7_J%YG2t(DO3lF}$_UCI+(x)4+K-{MK?CLRtoxiE&wFl5
zM!)cnPK%o0$}%O<tT<Al%J*6nIj{8J1YCYI!{fXXyaqr4k?FX9%s<+rJf`2ehb#;L
z$G*A$+0~Bzll6i6=OyoeOV_?^4cjmXwSfYzg78y<R>12Z0~6I+pO5J`UtOu-Iegvz
zQ4tu<ubu0MzJY<LK(Tu?bl92v37#kF$MbrA2;e&Q2u=Y3t6+pqR|QimcUI`<p~oH=
zpSjQKZEAC-AM_vpFKl~2ec+AhEb!~TvJTTf#$<-$L%cYOr(px%aYh1zHFII$Sk>e7
zJ`k~}moysp$5t*wh}rPo799j4DGaRP(cUXTHe;juZ)4<~Kw*pMgC_)V%rypQYVUaR
zt`mk9mc*zGrZy5a-GmW2R$P4XAHD8QO=hQ?H%szbTqWh?*5L?@oDt<&e*3kEe~$3%
zSSAUqXEJ6q55Y&)Qu0yj;GV@)IaHYyeOy1un$8Fea3C^@sSO2qn9ul9s3e0Z1fUyO
z5aR)(0FEoR+gOn<UpA^5hHv9B<~3l6UJhRZU_>oyagT<9|AgocV=b06(tHq4Faz4H
z==<mZ$FFtld}^GKKn73M>-zhHdarIH|9z4__a%D+4!C95{c~XtFK9HfNPOBnP7rb7
zfFydr^yQpJ&zGbkIXs-$j7Q=m#7n_E7F(>$Scj1w9d}Kq-H(=J`x&DLLn1x~*jEZb
zi=+ke%|r%MS9zItLHjvCo&9kA-OJMaZ^?JSVD_i4Ro8AXU*jYljUQ@{LJA4gx_1!C
zSL&~IVB*q@$?%2ZGzfGdpf$o_0kp+ffqilPQ#>$+!U=UhEjt@tB8;I3(8}5lfGe(k
zYqk3L!fpV>-Fo`p`G3V?A)HJl%YFQ@pMSws4e6i~zFKDo!d9IFafolmt}Oe$S)Z?y
zO4{oe*Hy-3JyeLhzj#NSwr|GBy<a$h>yDTp69GtjVFiZ*PSo+EV<xm9N(b(4<dg#I
zn~jB4?jIZGfx82sU`M?!${|=fl(;qahUUGbKkk4r>e?JvfPpNk22VfxfDgZy?LSx@
zeSK1Y`M=HM*L*vM(C({7gzbTz-Kp?Lv3zG4uc~`|XIBg~UkrF-!3HDo9wQ1o=8kJQ
zqniKWM<E~o;i5=!1&`DDu!o5Ik2P@zis9}gYhE$j8&QMwxeeN!AWiX5y}Ra8Z({QJ
z6Ewj8@c+r+z;~{Y8T7Q>z-@0C;kP}Z#r(SgV_vj|>G=T$12@!={(USLS;#&Rp}CII
z8cb;^7koyT=#>eR8v&UIlJ~AnjyMn*ctRYU-h}F5gO5vre-WH9lEbTm=E6P^lfG{a
z^6_~7YiT82dLx9ilWN4qczU<Qbtx1K^8QV0<h8Goh8nXb9Dj?%SS_X-UhWcL%{*(G
zf!HwC>bNJm8C4GuPLq@km&a@f+V}N%a4oHGNB2kj$y@Wr0+1s7kpF6c|B)ML6z2fv
zUxLbEe#4*yM#WR1z>Vw-+P7=Ko29fQsQD*OCif988J9rx&KUn4@Bjancx`*I9B)s>
z;lF-3Y}OE7h~fMuusLjHha+hZ>&rE?$pho6I|z{1$gX+~X*>KCaHsE@yx$pp+#_4~
zg$>+;zTVq+6UTn8-VJ9V{bT$UPYto~f-x-v0BE@xX-SMe3N&|N8I+i8!281z2Wx`t
zfPyz$FlwHhz6kq}Qc=+!BllYI892FUgIY8Z2{IvmZl#Bh)oo_N(yg81`K_+tgF$y6
z5}*FRskwILVPOvlXD2^=yzK~_xZXbIRKs{dpod0QM{~NDh42dJ$QpFdKvm!ocO=0T
z>ZND#t?2%6IZ5q*-bTNF{|;bBrZ~7COZ6x0uJ7>*j|{?I4n}bq3$f^-c=9L0T;5N_
zekY34528#_F14Jz#r#k0bgNmKus>AG`uv%1@sI-_*VnDQt8PR5v$dxg5fp~#jP~tZ
z2zqP^vjFz6!|<e_fGpr62(TOEkx9|9u|(hi6p1@U7oN6WA0Kp(G#%JYm@qbPYnzOK
z0kH45$nL&;M}#Hh@?rR^D2kbwMXnREl*UmA^D6Qz7UYro-(JFQ0KngP>*xMo@^F=g
zjF}9=ESvk5zPUO{6TX{5@imDF^FzjoJV;B7%&?Z`B;&0RF=K!x20kb+wg{S=;<V%A
z^5DZp8(OAW_3RX2Cm4_cp9J1A2un0#@YoRHlsD~s6yOlOeZJg1y7Y$pfBHx@;{gMS
zX3|qY2>rPF<6~FduUr;LdmilE*bqJark(^%W9?=K{o#He)7%8{7@mfcc%DBb7t!UQ
z!(MtAWAGXMUO(pZ+Z(hKTwG*Z-{biM!qd%c^v?oM@(v3%3<z`eapl<pzJdrxrC#ab
z+YRCc;gr!=wi@w+(0^m5YKgPemH!z$Bh;i|wxAuh2n!CNI4#Ramk4Aw-3h9gFc|6A
z@f>m@-g6Td@JA#k6k$c;W$tgw*RPUDXpPNXtRfNkPt3w1;s(fhc)Z8W$8y~_BPZha
z=1@9gYYo0g;2|2uG%-99anrw5&693kSxr?n-O{{D&B<+l1vGlp3=xs#2OxluPwMIc
zE8?T}yf8U}3v)}sUga^!Uw*Vp&}?kSGTp%XE&eJr9nvA-ONBoG=>RRRa#~JG;q!-r
zXnlL+x6~Ov)H?5>oR|0cviJk8sex8;4gjwEO87bIhxj*!JRyiu=LmR+OA+u><BmF+
zdxvJ2q*EODj*MZhp{zd@!_Wk7iD<tNF7LbXABY8?5hoD$_+BTurQ{Zm-+Mj?;RA;g
z8S**z!55ejU^9EUZ=m?=zyL5D)}g#)Yk-=C;Q&BheabuI4WU{7^AS|cf9AGO;J^Z!
zb?`^Sb7}<1hU(Jw>f*D0wOo@^Q*eccK@N;_@A!Gl#EJXHM@OiS!gF1fYw~qpCO_})
zy_NA0h9V<z94CM=`@BWnKl1<hX0xnULiQ6;)URLlnjQ$d0L?%$zp#cQAo`SF1e1RC
z$y(PZCQHFTjbTtoEyeJzG+EI0q+rL#vWUfrnP2^S`FWR3a7mBf{qRGbd*OXx_$QB9
zZb~FEOt<CmrN{^h!AAHjI~nTasR7?kUjPUb0038p185*2=d<FvtKs^y_E!Y_kF$_R
z+>ZxqBbb4`Zl0RrCavX!ad<$m>LstA5N{Z{#0GWX3`ruGzVW*p>+?zHUQQN-f3yGW
z{{i30ijff^GdqXRm1)#x{t2cV=7F_Y;G3d&hO<HWhzKvMX@2&;3H*>mhAz<p0cc<)
zzPMKx$&kv||IL^0mNr;=b;Z&-pFm?`aJ;@Q;f#?Pcup8}eANEt-nb&IZ8Su((wuL1
zuLxv_*C#wK5dC0^>zB`ihTW&@uY3||o5t$q&>BI-$olnghlK0^q#O*adb1}TZB-_`
zm$(88{m_we4W`@|*s%bcA4#Q&LTA7o*8;CZL}IZE(KtgtE+7-ao4RQecq%l%^S{A7
zV1tG|e>I|Ag8x=q!@e7~`vj&}EIznKS0v~Ss%1nOPnX{b=Z89r44j)GUv>^!n3LwJ
z@2it_Xit-OpOYEK#9r#>=c$v&Pk#BkL!Ijf)(#Mo-C{V5_0UYxe=Kxh{c>cN;XYYZ
z=6?udBg?AfAlK)w9PjW;)sh31j9)DNwZk54YeA1_Egm`F;T<8t<7b%rlYt*FG&K*A
zaBJ{QX_k#DJl1^GiDq*80-EJmfix^Qlh%zdZ_B}N2(z!yML5Qw0n`!vzur)6Q2Y?b
z8GZie0f~eG{1<Q?xGbPd2N`&^0a8vIv^+U_{H1|>Dth3G6SVZWpL*f`h-9UBUQou{
zkT4f~+h3D6oAEz+v-8)+hOX;}Ct`Lh<eYZr=dX;*Q!o5{Y@zlAj8j2O)F9RnR#yb^
zie)u0`5?#KXw8yh0Y3;a?qyBIQeyV<=YPdaThsL5FkG9+yAy|ke;MXb8U|7c+u*0a
zoM7Yx2?Ow<rdnAA6Tufho`rd_UED@v<Fw$T6zK^G|NOt^;W;4m2M#SqQ380669yIx
zkg=RUdYTpZp0Dv#XHdg&)jDJNb7o_7oaII*zv6OlEE3`gY8}7=9-s9+fByvp_9f$;
z{#j6w>_x5|#v>3tV`q>4ALY#_W<Qr$c1$lDJWu!_up0y|SnxKu1E3&xfa`}4(Q?(B
z$3p}EjOuW~a9#|_fv2iN-%`-s+Jyl2Ev&5Z0%-35b6#%4I*z-_Yx?Hp_rV4dup_|r
zG+GJ2YU%~R=*QRO3?c8g#mY+BY!P#OGkXZ>7sFGF=u3kAB4-+<!J_Bk>vsF*jI@8t
zODwz=#(@Ie4YAOC`w6e>U#&~UPQ>g^#Oz|pzCHW=YUZluuz;Nh9i{ARf(XSVQzlHx
zCsH#>nuN~2XjkRK-pj;zg2U-Cus85egZ@mIupJS%CU$%maiA<*FBom5DC0pad=qSz
z#by%k6>!IsCj=-C*N3}L_p(DTaULUF6LGi`60kw9)x>4u^;uib%|lH&dAD~jddH3g
zJ~FsN_(!jCFiGXizFy^-Vm>3{{JFCv56@mX-{B845=`O)pL*t%=s57-;F21MO4=J<
z*%!voM?4~TS1F(>xCI5oIy7MJrE}FoKsLo-xEMAo-AqX=8UG4fnvmLA13B6XXeUm8
zgW>LRiG9VHGH5a7eryJ4Fft1=nd$%Y*Z8er3*egC^5_ygpPr6O8sKvOTy6@uS0)Z#
z2mh$Zg!4xLbE&*;JaCt<(_9n7@nE&aJT)L``}PZpj=et_5ggoCmQ$ft1U?9B!41cG
zgKmc-5-~@k$i$3M=<Doi#<RY6bQ^N9`}tmYSKQaj31M876x371#MZT}n1M5|LY0UN
zYYEPE_~;o)F$(@HXER}2F_}`s5^ZSM9sYy8@JAdOKa{+Y)xEC-d!jbM4B|MBd|mgd
z#_*i<*;!R`XWH;lCp}HezoBb-#Eb6xyWopC3wu5YWY6!1Bf4&R*j#V)US4|f&h-OE
z_#&9r(;goRPzuA&y#fx0K&@N|13+$rcySk<dAq&}W<ckWGzY&NBNuH8Sl|FC-OpYj
zo{le!-0FD&(60~%D{y(XQW%slp>0=~Ic$?Be}e!|yfUUneKHSQOmvulNsl1b_lOZ=
zF_TAk@gE9BVz-LgrPT-x<;k-W%BnK4J|H1@NB`z09lh22zj=Rz{CsFM8$-+F;i|EX
zeS~DP*Tv6=%byRMuIpQg2N~SkJLh`iJgbYkW}QssUdC1FjeRp*Rf=`v$%%UU!WY3b
zjM`Igh<tShlRxl;Fj^v6gMzseFmP8QW)2GEO!)1e1)UJ+&={(|LRfYzf<?qd@isGz
zVLbuGH#1xicQOisc7QGJqBz=?aAlytMgQQlkI2GHXu!e7jkU$xK3PMoWhwbBY50Ga
zBdh#|#=-+$E%>hJEcm%)zHA})yU7vzswB9L1l$wt8~^5oS9N?V$$j4^clST_!<89?
zAUeA>RaqC;1-0$Un+b3O!6#V0Zo!T*#6;!(@PJK(?z;FX^TlB5;iW{t#u`}oC)nl;
z2DR^nB{Ksdw9C2MoE*H9EFRiSy@x)qXuKIV6cvcGCS{%e2thtG>69vFsL+LX-n934
zM)4wb8$9H7;oT2E@mi`%H6$N0R|aC=PxED37*ae}lTV-EuKPc_eE#>#VMB}htO;wc
zNx?SdDdu9~9n+ojx~@po>6&$y`v2gEI+(~}>co7!FRMYf0M7sap082Z|A3yJ&engg
zvHAamAmFY<%p4WSnS-uLiXY^5m9hBXQ2z<$gD%-fZE{;hUk>t?9b9H|8=;!E{Al3>
zarc#b`tZa5hqhw@xgbv1^}}Aqk|3@kU_efj%E&&3M$Ur&3`5JgaHS@q*}CxRcYpX&
zfa3-=ED-LrZj3UaxchK%AE{I2pV+<$dQM{@mCzjqC3xX3uf5)Hcth^{u1kAjxFO-O
z)y@e13HOjEI6x86+VKxp1bFZul#40}I+(r);}dYNmN#<0iTz)Q_(J(LvH04{yL7`b
zW=w`D)#P9VIoil_8dS<j$Q|^LAlLCFmK7ks_^yg*OcRHa5WEvcjQ0iu1U?tg!`7fq
zC$1lc66kHF8$n#5hKJUMf!D`|eNckyhOwce{yrPG7%AWJTpT3fJZz$x<L>8exA%y8
zI0pE?33zy*>iqi=d3C`TS4wz~s|CaGhnI=)ot-s2N*0Oq1~^##{E7)wch33VxNkBT
z>S4#@cRWwvl7o*XG*fXt5%7ieVi{97O~3*p^<UTj`~uPV+3y8$ZK8}*CP0JLN*DOc
zM@htU#}C4-TSA)BU~hu^0Xrf@J)RWjTEOrZ&N2;HVgJTgp^@W&1h_$BBVD$YIuvYm
z)2)KPf;fE@Ltwzq1@(I1iaQ?%5a66~;_I9cGG=aWk!W~B!A4%{i5CPJyT0OhPVdX-
z-w0lSL!j`_vEjw?YlQD+I$+{8agc=BX|5LC=l?7;zQ6t)gxS-5UX_L=-^;_8@Y&@}
z6m38Jy+=eJKZsv~FCX_;SGb8Z()eD@H{jazqmi0tTMoBB{6L-q8t{*~h&gR0eoYdY
z_+%4b;F+z<P%d_cKgq#Xj!bA59G%$EM$i$D*WWLU008Tf$i}}td}IIcN#QF8w0FrL
z1PAMa_)hz8;gnMPOnu{Hcj6(WEyxq-_YqI<t<O$hvG$F-;&GwdSP2D{0U#fUG;A4H
z10@geMZ?P*VuFkK48L1}@BgmlA{b9I&iGBkgVt7GWn@TM3gK-cM5aSfdv|Bx<99P+
zOA&-=Rxc8+_$Shqf^w^>lMo!Y@?GY967jfx4QR>N)STD40Qk)nX)J`$$VEUVEk<;k
zbNC>jG&BY=Swx1Jr8ViQm|&P73DQ5yMC0&HQoo)QPCPjb$-`h{Szylna(N%(<cF<S
zC9_jEc4nr3Bt+RY|90s#Od$1HIWg7#Y+iVY>o0;lIJ%887s-tn<2kZ5@f=mg?((rf
zub0QN!UBFfH8~HU3(_q5fp~6KDV+~bSjk!WcqXxlxN;E52#GNv?wrYo&i*7V8ccL4
zS!;j1WN2mJs%62|y|^N2>*|036oFSQT=}#%L9Abk@e?voVWY*-R6ekopU7A=KgV%_
zMxX#vrQk{rwGp@92u`OOqeA(mkU<Tvm-r;?hb`*hqQGT9mZ-P*YBUbCCKB_XGEtYW
z#QY&#630OW;9TGUEqM83p$75>2gTSNgqIldk1h%(0067ZL9LI4b|8#l+%&MlC`|UH
zldp%lpIi{&Z_~<TmK);hdrN->k+Dm;O-)Ri;rq$LnL7zGP~kmucatSTjAaeS{hj^^
z{K9at8B$;flFcCM;>4KQ^63qX|AyhlS`!IthPeN}YbjLtkCKxd-w{)%)Z*a{a#+g6
zKLm8kN-nMoDWbVZkb}?p?jwBKQ{b*`QiM6Ql5Y_=RZ$;;DUcu=e7+g2m2)Nz+x{2M
zpkWp4B-gzfaAFo1bp2r%n2bjRRx_~0%DBB`G2`F^`E7N4m(uda=6OLd-T<T1=jZ?6
z@5NlbKk%Kz)X@KIb%-aZb!OBV-{89$5fq6q4SH)v#?yrqKFcNPMgQPY%@YJNv9$My
zSCS?pK5o<eo4rI`&ZB&r#b)5Pl_MGvDm*l%R+#fY@RSCL{Fi&%+EVxCq@X7&X}vc5
zyUzt3k#h)KGf!8+ZGn!+o`~r<CghVfd=XI&zw`uK;g2^Y#&p?#Ins+?;xppFjTYz~
z_q6{e>pUU2j}dxlUpI=vJk_ovcZrJb&C)=<aKml@8Jqg<zrXMr#!`N|Kc9kJ_ni#F
z2>5s$zV>fJ`2QamQcp>grbfn3FI3ljIgxhtqk}lf>xTT;ymP<8m9rqJga$muBT*12
z2WkZ64W$noU?(AIpBjb&10tVl&v0pO{s_Hmni!{36YqP+ssW@0nl&JYouOE!D;cUW
zq#nw5_$PrYbl=~fLA5hyIkiL+Hm8S2#Kg#>&+fTw2M;HWml4EC<mH5N;z2fsE<ze>
zuxQ7ornk=j8zY1E`Xmkw$>OGOJd7(072~`Ky)_#EC=IrH1AhGCH|5%2K*F7lHI7+o
zum}Df;rrS{_{Pp5w3PJvj)RJjAPC8naA~b^0!>DaA49l46x7)aXnQ;Xp*WhuC|GLM
z)ZBO>=l4Dc?qW%CP02U@TP7p~z7XuoXx;l7)JD4WRwh%q;qS#`@g}sny!_j(aNLZ_
z#c@*jn2!i%;VIOiu~O4qF({FP13+n9Xm&V2pdiwpICuOIN1*6!644F6)jnv~oIeI(
z#tA{Y{3)%Y1hc(!G<L`}RvCK+)dVksXb)@XJ>~=QRowBjJ4;#ZzT$Ww?!8BQI=Ci`
zj68$$qs{moQk1E@NgK`LY;gjweec9ggd(^nz?0bQ#-o=osWFhkPSpQ>>%Q0j#bMn<
z4ytlvIWG==0!6?BO46$QZsKhBV|dWSY8_H{5oHpQ@Qe>VN)k{Q5YC?nG#~Kvf&#=4
zcya>kq{q6FsVem(Py8ckXdsEcjLVEF1Er3RkHi|PzX?omhKKNM!Tp*XG?Male}dgu
z=g#Wu)x}vojBsuL5x!{O{-Q6FQ3Vd_Ba<)9i6>X^m1`Zxo(mH{E;A3w#mSwVjX-#f
z#C}??UL2G`DLP72+l@_sf;u{+=f}-@ILX7mJ@_H<iu>S)4?+sjvGPx&@xQ@5VDE!1
zFv_wA-vwVNo#Z^{k>P3ZBKKb&89m&cb-cmpqratnWP0K3gR^cqpD6Pazm03^a_}}7
zCw%mbKZoS3ZV>S#pSRe=M1&^61@Yble#buu53{HI*TA9<yHAVeZ;tTFt^?YBL)~6=
z<cCPE0w2rt@9hp7+lS<FxbkQ-=ir+T*AmznVfVsUh!MfdgDNT?!hWllJ_-2vy`Xc4
zaTte|caNZ@t_WfK^?$Fge4SUpZrPRd%W%EoWDu%ojq`Y{6L6eyeWA!ISmKf<O&xqY
zA)~jQQz;H=jawcg{$6f1laBaC$|N|{uc5CO-uPo+A_yCq0bi+xZI-{_s!%{iaG$_1
zXVjcRJDR@GigYN6qi}o?z(Dm{=d?e^{7TePQGA<!;rPgf&3G?EHR%|4Rm2`(Wlv=e
z<FBAO#t8Z-ydf3Ec)E}~FxQ0lC<Vg^_zP}AIvxUkD;z9jJ&u+KkviT)Pl~7e*hQ%S
z^I&bFVW1w*(m}U^m>ty8#JdK*l6-k%|K!<xw9%>!bJVpebbspO-5C2Ni@{d*Jn)%<
z0s*4JUP-v{;HVp3C+!(71K;9t$8nS_5CmbEkIiWE{oPu;BaM6CQVL!Q_oqi09dW*{
zg@tl+h%FzlXX}DYc-m`$cf!$)9{hq&&&pwu;w6;-8-gZ>cS;}F037|Kz|3?(Gh9yC
z2SA30U~xAa2GuNBt3kBGmXB-y1vzkdN^VeHoHS*^m$0@F1zD5h{vv4$=z?nZTVJQP
zm|2l^nxg<q{*S7Q@gnh4HGoqy?y>;zAod1S|CiB1RfJ|M6BURAe0W{`hCj$m*0=wE
z5ibOr!zitd@J$)<wSY|bz<)m=+lNMf*w6fDgwOeeLV=L;IQ2o^OSnz^fZwPBR@wu8
zRgEc8pwVz6XM#wspQPfr;j9mJldHr;c#U^`p+{E)A$JbLVE<bD^qdhxf16A*%^<$I
zsE@+>s?g<C*`Z(XO?n;om2zC72A2_h5_5B$i{OWOtJlFNIo9y{;qa!7YmN^FcGi({
zhXx-&-1t)^5}<4rYcEL1y(V2LDr<y!#-U>PQfG(o%o)b;W=z=dz*56Y2^_tb7fIn&
zz}TGWoL>)6Wf-fOQV2m;w$OeSPzBk~s{|)e&}CL7DHYT|@P`n?z$Bg8$^X9374Et)
zIo<xJdG0Zj-r@f_ey=It7QXm;jS!%V*1S^ij31$LWDdZ}&jRfN9ei|y=TU-yh9I0r
zi18jH#CVU12us!F;=FK+R4aopZXe<m^S_9fhkPV(biu&jafDSqTha83+6IIWp1%pR
z>Ig$#xGc^P7y(A5y+6L35`LcnF7yV?HZnorz2BrCkCAox|AipBt^SkuTo@v*N%1$(
zf0Oc?hNcj3`b~<AZ1J!Bv6~xaf?Py+aVK4O$Bt#-i_P%*)bNHj2toq-zcf5u1IqI7
zNypTL9Dd&_@>BJL?$uwx2C?ET0-7Acj=Ezd2d){gG}f(%QvZZE$y!Nx%E|}@K6oHD
zNF^g5#6d>y-M6l?z8$tu012A+K9{y0rsGFVTAV!{On>2f?O_8n)&u3?3ru7DY?lUf
zv@xq|`M?*wUG4CU4DY6M*XxRa|5+d}?=~T?i);+fS|RuAn{apXz=ghp{_Ej3ha5s4
zt&|`T1sU6xv5^5XuxCk>@1M`-^ZESz(IR|An1ayYk4JyQ#{SRLPWUXK7$eyCpahRr
zAK$V4J=#U<^WT2qb6`mR2m6cxh2?p_+Fno<$Bv=QS_1We5$kY%7Y&VD{zF`t{d{O~
ze^<gApo>W1v(W7&JH8_?3-G@0M%u6%l8+e~{E-{w&jhnXVz{n7b^=pYtp@ljobHCr
zX!934@c|s2RHxJ>iSaV>OLP>x($GUs$$B5lG_BtZTxFgC)f}#(r-_XDIEw@Y8X9ZG
z_~CZqULCl`jv0W}zW0$E$TqvRCxcEH3)w)F3k8&a=Hb<@-vwTV8E?B!&HCQn;AdVy
zORq|&2+%{K1X-yFc)nW%F&{{L?Efb{r{iEE^?|YI`5pr_#5!Pqb$Mg|DA?o{%Gu#F
zf-GMKP+{=Gb!UA3e?Omy=BabyF(1M>Z9k_PYN@Yi*@N>P{tGZmurmSF8B6UD618A;
z%o;%nUBjv)znTvJxLn!;F|Y^UCI6%Oymkc5$N1EGOo0f?{6m{{YGZ&ERd2{d-GDwW
zG_bGD!6!(<3*k35f9C&uyt^kQEL>kTw`zU~vG9kirOowxx3%zHA0GABEfSWPOA)^J
zrc?1exUUt7B*YUCd?AV8qRmiqN`U=*(Y)f(_#(St)^huj64p)#Y0!lB$X^6i<13Hj
zqYhtv#>bO<C15lJGCFf6@9<HhL~M@eVS=c2_rX?P-a83}aRK}6aFLgF+kaxPwar|E
z``b{Jep_Tcr&>Q9iVLf#u@WCIMrNdj)<LcwfjeyIb(Hw{g}mG~@`r#}F0W=B1m45Q
zjMr!7@Sl%pA~vgO-ZuzM!@C25eV!0!bdZ^W^=7PiOTp4Dq6haLjYH8<e!cKXkYKQZ
zx#+D=@Kd5<01LNifBN_Ud;3fOF8T4Q_4&rCtigap^?&L4(Tu89{bN;EzmPl0#MZU1
z#pM#H>EA(D4#o^?7aRk1BzjZ?($yynhe7)v_<zitYE)_^EFHSQTDs5xOIIgW9t#!v
z;GZ6`R3dDMabxnEl4@*XIV!fra7Rowu^d3ZHN<bPTt|t)9}aCBqLVe@sh9a7sTcK$
z`j-0P@mk&OD(<#d!4CGy4}wk_yz7JE-Lz!`nE=(_9yx$_%Nrt|zxcVJ!O@(Al{3ya
zf%sA#W%S5BXja)#*U+Njf3|T$gbLAxhrv{Gh%EFCrad21pZ*^ig8@vC8)jWJ$W7oM
z`&>w^(S1AOJTQJ-8H?8jcMlraK>21L@(=%)n>QRFCU1~`d@duKI5bBgHUkNGCw$tM
zhxrTQ>cJau#0Wp1MIY!!2%mq^3uXqGc{0qwRCPT#VlNSh@eA?2S@DT+@u(r;x~Mq5
zj2uBg{(t6wukiF#J|e~m8v|%UR<rA;kTz%Y>ze@G^MDbx=s0&N`|6PY_2aTk5&2G1
z=0$u1sh~nwhQZz#R{u%YUIz^Dd=N~<3~)g0wISE|aV~dZnfqQaf5MkDap`+?$k&FH
z1CE{-`@sNHC%S8fgjk<1Z0mwN*Rb$k9P<ld%lLBUSVM+h|KmASE;I~_;flB)MuKp<
zBr8j;2sO$}gsm7eu{+zsN5f8ob<5z6d_Xx8>iID3hxk_mWP)*f)NJ?XSN>YkzAMXx
z%Dy6gO4c)*#iR1f$3F%0pn#t%Q1wk&5NwJ2;-|t-BhzC=;k~;`CNuop5@DEyT5k`B
z>4#Hz#<l6NK^<tZ;%0$3>~T<L<HW+SOaBh+r%6@Iku9b&l2vB!|AIOxpjnh(8)(s(
zA;t(35V7x7O;OMkC94xb`FP+j@U~M&s<04LfB|nbfhh1xLW_vd_x>g?-ckw4t{$gZ
zMm^p2pk0`rS`Gcu{0RI4+h1u9tHzI%%P6Qj1U7j82z)nD_`N@b5C>V^=y0!4eFdO~
z0=Zhyeqo8{Pfvwm^z|C>w7qEe%$63=jiv^_OXwI&!u0<LZ;hf1BzwTV8ZkdwU4Pk6
zqcVKr(18ei@DmJ(KfjGLi^9Al`J~7*5Qo30iSQUp^oPemO>uGe!afN+2jL^&v;iw$
z2ha{(@1*-+5r5EnllSF9KWJeO_>2j!KzI}bJmLeYT8IqeRYwE=o~l8HHQr7)P0$2r
zbnUDG^+N?L#{ym`82ARlvEcAO;o9kR6d6(!{_Ce8-T{CdN+qCc<m;EjWmIxfd_cP5
z`iuw&;5-G0767N=?nf!eC^i5J(ttBnVGM!~!B3oY^?aONcCvq-xivrXa`rJ0hveOO
zi>l}3oZ|^5FH#ho5${h>_cxy*J-__F<>j!DBjzWY!+l4B3$jBq%rHiPMim265OlBF
zkSO8O90U*i6k*;N4#43X0Cz8q)H)glz$Rl82l1eI3<uIlHib77oxuDXlmCsbE;^y`
zP59}p64ULXVbl^taM2eVd&n^l>ZlqXSpUg01{gnre2|1pI|Wq&mYg35azw`uVQ$=D
z0P4B*ufYV2!6QTC$Npv*Qno_ysNnto;F{jEC?7FLwLNf8`Cg-r0mWm=9>c<sD`?y(
zW^UzgbTPjAH>rHhcF=tDuFb3LG@c1@4%O2GwQIRO|GQdy{1ieN>bY&*0M_tn0KF@A
zn_6r#`)EG*EavCF330H1xG%i>AlJaxvGE=dznLcK!?w`e@p1Nu_zJ4c)}TM&jzMT`
z_+9>Uh>N_m3HT64jd^nUuL#S=z4^HFPl<*hBNAvn8=o2P{UMp(5y!}c7tHo)5VRUS
zrQuj=drlenZDW0WJ%Ilbx!2<S0foM4z1jd?`sSPNV1EDHOS_jEcwdD$@Kqu$Pe=g8
z{;k*dhhEmuejcMWxkln3L4uXu{v-eS%Z&kU;QaY@48+Gi39s!@><{{!_s&iA@0((T
zS|iDi5Wj+6YGs-_Jiclk@h^PX;m7z=!Y-in4;URD6La3$ph+e!^A8G0C7@kJOK#U^
zAKXojfi;I>=#nnL$v2iC9U7^im`{Z^ww}k|1et&UjQaZcB)nio&MV=5fXfR5KlPaz
zp!xrgjI=}2E?`td%lR#?H<HtIGH~3eP&zd;)eGThot<XkJML)gyxCa&Ub%81GFsmi
z<GEAFAM2^O?E2IIoI`L3;t2pGO^?bKKfztL^LFL1%uECWA^2Rr6OKW)+7Jc-p(aMN
zt|vjIZ2a*272jSTKtf>;P4^eZTVQbenAupM_2;j)&!6CvFdz)T*uEavIWd9-?otr#
z5EWx;tFpG&{a*Mh@m7tY!N`O~+z?)RFNCr8G79RQkmX<LBQj@YHRIkqWUbFgMW8_R
zfZnYD{BVDKai86<{?Yum)upr`KZ1w{QOZ~=aM8C-RAv&Cw0^*-(@~FtK9<JcI_FyI
z^YeIR`@u$r6m?SqE~o$r9(MLZ**>NSy&L>@1TQQw7_NU*6Iyu47gVQ=5%cOiTR4c=
zAgaIa0nPiQIkK^;s`LGI?C&QP;~}Bk#eqa{g=m3pIO;tK(tl-7;D#K(g`k1d>F`6j
zzQQg0J}<`xNmy=KI4`%O;rNFOunko2GLPR2%A!QRF#1_59X$V+vL7~At~-d>)=>sH
z5E8LP;ES_(p@@uEd03H^$*hRI;Li53u1_4zLLZa5WZ<53Lm~vgmVh)nXtac(-G*e}
z1{c@lYXLpVi8G=`_xS4r!_$`VKoFh7^dA1WW`S%naP3h-i45;N0PS5+iM8i0YM{vx
z^ojoo&%Zw8&j`#A1qu*@pbY36A`Ptr0AOum0ly%A649p2hA8jgiql_wlxQgHPlc>2
zs==_auyRa`a;qCO|BIX;3M3h^vA_T%F>D?M;SFyH1n3ul0WjZ~vtxr?CF;1ZaE=h;
zLISGqKwb%MMg-<Wcly3M^QG`lZbPs?-{ZG)<^;Vi92f?z693(Ys-MrqdqKLjmrKM#
z9g=|q-6m=NkHNn7GX}TLzYzr#DgJ|1YvfP9v31KL#rF{f9KfJGM$81Kfiqd2;r=h+
z3WFY%gZ)bf^GA!|_o-le)V3q~pEl<)F?=|^#sF|N;;L?G^@)qXiRjYUGgUoB?m>|E
zPBv%tf8icIFo{0k5?AzZ%w!#|4D|nwqA!-Av9vk<9pGzIFOCyispO_0j3eHX|J*3a
zDjdWyaiKu9ZXBHd{B!}TxX9i(?%ef(;j2XctuNz#Xn^=6%?RvAea5M^o9o{Qc8J*R
z?A&bT1mZs=_0#g#Bnidgh1dG1j3oN^*Q<gX3S(p7yZJaT&_Ua%q1qlF+!|#6`@dQs
zbthh~Nk+4z9l~>OPfWN*p$sJvn-M1jv%}dvI$e9<yN!>6(i5B>F3*&r_#w=R8$<^V
z5ZFyX3?IA8f4ubj;GatI+ao5QzA_!JplpXgWBt4zAg=ZDWrj`(ZVUy&M(N?A67W90
z2s8vT6fOu-GgvK?$IaYS383m_|AcL#OCoO>Zgihlz7^cOJ15Ku6H}!W!&S?_<7jl5
z5C+h}y5nI5N5AUhpM@avjG)y?t40s{<E}{YAdwT0vv5gTKYX%b%_ZRoj(qB?To>IE
z4HP)DstYYfO4zo4<fm-J*DlQiD;^1CE^ofa(sFS1PwM<e_$#iG8XdB^0vDk9NzYi<
zfAdCSJ>Mp9Kx0eezFp5&(q?|F9|ak)sFEp1;QPB?(YoRD`;JRuKOfw6eKNurVi49M
zXpiOKj#U#>qsCEO7uOGqL<|Ar!AYVAsswtTzn7b|eejl~5IoQVSD+@Oht-L2wYz8u
z3fpQ}OAowH!d^Ts2bo8Pr-10ssaTsS|ALIL*+Lvcsy#n7ftL)6d^byNX~xihlFZJS
zFkc0ck-h``X2Y`o9ttQSk(<*SEkAsAF*x4w0iUZsL3aQQ&)s)k|IPmLM9bx$5^opq
zQO5v*XduTyOl;BD!3;Q){wDJHF2rHRBR*eOzIw*H|AIZGWXs~FW3U=V_M$&7!;Za(
zh`|R15-@{|m5dB^odw14L(2?Mt`NRoHh3?Fpy;&f2Jm{4VPF_Zrh-%mq>cyz&;CB@
z8?+|i)1*}clm!pN#J5M`DOmQ%Y(Re}NqiSpy`uKMZKHYcS(<}@&~8Bj#<U0(0Sx?l
z4abMOkZZ8R^b*$1B6C{HQc(}-s3r2>r9&%~uOB|U>Q}BwsJh|qNV2<SIVh4#1Pic#
z5B+=ZP0@PcU3=iWpk>3Dk;Fm8!y4fzRYAZOoMe2y3uQ=yKDa<=8TJ!CZX*idlZ=l}
zQsP&o;YtmZm|dKK`v8RO1f&6tnD4KLss+Vx)kmd@<EN3HfzH$7$7xRNNe5+LT%_QV
zE%%p`KG6J=z_G*&-JpYsq2y*xjG?u|FOo=V65=!v&t{!v=C@J^9~<E#3Y2pmh$J&%
zau5%pG~2LJgaS~2XZ&AHE@=25%)y8*3~k2^(4H1?1?pR1W5?9L%d@|)d~b%`dZs|D
zS~NEZ12^M(3B49@H|s2w2yEU#sDI(vzlP+9nm!4Da___OChGBne?s-a20;0PNG0o-
z#DWDtrD7WK*{NfAi2skapWweyp#o?IP}*iVUIdU_LKw5+8yLbb{1C^EG*;ZD=F3L6
z$(Mg72%28_{t&~@k{Vt2@I#a^64T6lHRIzuvqD;bnnN8|C6h`+UK`z=awP|C{~2K<
zxbVEtvyB+Y>_h|F@fFC_!hVEt0+P{*;IFy#G6*CjVTRHvP(=gl;J$%Jhg0N)K3H#J
zYM61q{Cs?TCM+s00q^W(w`qW)Ijm+B4{pDQqeCxTfq;$#21mdX5a~I%7t@;=5F9V?
zmNR5vVlWZ30v!Pu{6%a6x_jvpf-3`*`z))MoPs*h?_(^Xf^JB!h~hS8z~=2Pr3CyD
z<*KQ~Up;VZk$>{}Y3?&s9ma4+pbR2t_um9DUyI>NtyZdL!v-FS0H_Y<2zvM~yUb1>
z&=rwTy13l!lsGjAVkIuVZ?SmMlfwaDnvvrkI&S4pRpl%?1FO~;!WjQ`A)tF-2+=Y-
zy3wr&NBwe_h2fVPji>2HjC`@P$MQr8SFWX3!37X-h%4m<gx%^usE}|=sncz*`Eo+S
z^}<d~5%a`&kHuIvD;pZx5LzXV17G8B7&r)l0YG8(^}yaRSj{+J#U9E4LWt|2>WE}Q
z24(lyK)W_;<L&?m__)2b<0BEbb(;7gt~u%{iRt)@o9+ZIgT7g5A;w1P(NKm?TiL=~
zm0Tgg7B{KA1M1|N3BxO8;EOT}eeu<#F68}E{P?bbUAP{cU-8^0xHg=q$<3!cJ;O<U
z9$^8P5M$#Dtb8IyA1(4GB{a%-W@-QBE9>I8YIN@TjCcKe;I8(L3^^x+=@Iu+-zP58
z@pr#2AQzH|q68tpjQ9|aODB(l6W3o?sDVEUTgQeGLJ@?YKs_1M938hid=+KGd8P-#
zF9#fm@D^|-H7JMW@by4=EgHI)Gg&}*GcQ5MlPTsHGr#^m@31k5N72<UTtK`Mb9NL`
zb?=0!mWgD6jWEA)zryC{urhe*=ly^3M*Xr3y?6L9t@OuenRS~Sp#cuK-e_YJ%Syiy
z%TA5LctSy*ri3vZnUUAsm1N<*r5jlB<x!@m_%53}JJ|Rs)?;*#87DLbhBzC8VkLwD
z44gB$jLO2<fBoueWa2TAj}7D-hJJd3?f;0x@Jo$EX3%OMNKps+xbU9UE*agPH(MeQ
zQZ~bDau}Pi|4YI9g*OiF$Kme5l52)7Mo031cp!tofA|#X7rBnHft+~sogD}`o!Y{U
zb$^0M;YVTOI=UV6yRL3ElEWT9WmngO!tP!5cfloC><`z;jQjfG^6E35qCX|ketr?t
z&zV2)j<q?tjIcTNrJ)1xq-i<lU`-R92|-XASSb_0I+l;5ehcb^2eLCyCg2=s5FxP9
zql9V%vnyVg2UG`2Je;0hClT<TQ%ri+y5$InbPLOU9A32x^HqO8v||%rjS0Jd|Ihpv
z`S#NYa39xEl9%{fVU>)0Fgl}-xt1@>`r@`Zyo_52a8E!p8ns*Z!DJwEq1T|0DR6m0
z2?#q6NNxb~4y%Iv${078=)-Ypve;=4=l&U}Z});?IcT5%-z`~w3wLkJxP08S`MhlH
zM0km+($`!otI5Kc8>3+m`hB6{$RGE(+Zjh(TM2k4*qmr+*kemCgl!x_U>HY}d?(Kb
z)%-QBSLi6d_^Rn8e+WszMF3|;HOL%CybkB@Rl?aCW?F!FM7@26sNrQX|B_Wz`uD|b
zb2DMh$=<aHcfGtJpAm5w{_5pp7v87Ma9?hsh%F4wmKoC>7J<oN*-0hQoj(K`skn9f
z)H4qua5=GiU+aG-@U2i71?W+rp(*F3;r2Cu*F9!XHdWK{u@!kZ{5c@iNxA(1j2Kdg
zQ`Mgc10tUp+lgjCVK)%)AkAESf8Q6uG_c-JZMAtgsZEC=DbFYIRx<64_4g^we+2s!
z%Avc{*WzH4&jua}XzWFaWr|pHe-m60Lz{+6<@JL3G_Cj{nT}YnSdwM=aD_qwB<fq?
z>jeO4FzX1#O1(x<_!!Xoc-nrXp}+7^Dp0}!pJbeDTstp<FEbf@5ocqI=AaES**UiB
z<>PlSn1>|`5roe5-tY5ye+U!1@imE8t{2LR+XE~Nhh7+Vzu>}drU0a2p+({k&!&%9
zzs`q~d^?;#QC9NL&9)O(wGYGi!~Xk?8T=)~R2=mll)oM^{a#3mrE^hr?~k&NC(^Z0
z9j}`mAA*R`%@)AY+E4J_(BDen?Wp|Rl2>cjRn07=)|Uh_Lq*a;0)D;oZ*%a~2P=by
zqWB;F33g?3!v&AkWpVVaOPrW;En+z&Le9Pj>zvcV{x_EN*px;un)mTP6O}dthQNw2
zvAvHZ^^aV>O<i70PImwdI`6yuY(Z+4Bd>j5=Gu&B<dc7rnK7HqdcpH!`ftQ#{*hVm
z{I{<hess3z$QTVvRAo>6v`3>4KLl2@YlHG(mrIwMRq%xg!d9+l<f&5YlNw*^gq+pW
z8_m1R-djuY7H_!DTp`7H(qRp)L;Mi!U#qLcomFsO%uHx}QyBmRLF+Lif&ka+xNe*z
zy)M@ss;Z(mfuXAd8Ojh}f^8?y@82Yw?~0fCH}_3FaHfJeDaNNW%^Y?y@q^=gXc}g&
z*iEI(A<+)SQwG|G-JuoZhrbg+EsuYbleq{!TB}6G)sKQXCq{}m^K_aoCM(x2Jll|o
z-Pa4`jEu^|AK#UR-O0m#A(H0PZ<Y|r5GN6;<le{$;#I+L#aj8RTp=3H(?VH|e{x8Y
zG$cbA3{I%;zrJT4Jo~kWd@Ad>A62z*=Z<tJ1pUBU)IfeUvHz$BkqsTzSxi}UmX$Ox
zq3u88_Zueqm}2x5H-yXaf@^&sKp+6D#8}OZYc@ahxww~ZzZv>_6`Jr4IFO5x7{d>U
zhX?4pBE)~?fp810@;o*oXV@5K2u7cWN+m>X)=`BWdnFe)PRTk}19AwC?tL7VhjmAN
zJ$pQ11xkuasGv}wA08hrR}}g4(r3BdcO#D{HBSc)aZ!96oQ^2C!Ntdbao~fA-}Qxa
zQ%jRpw`K5p7MtA+nsvUeoO@dp#P7T3clmwLIh=6VX=2u;P1{Ji)S>^pKlBx)_V$Z+
zj^o`5gl@EfQ7{E<r$h>t7R<V(FTf!h$>V?j|NnGtz**@4000001=MY%UTLbjURx>g
z;Odpmns2w7%Lh%oZtC;R&9`w$3axT|-=2mYwe^YoFVQy-*V4~kMTV<ou6T3{<iAyx
zyx7sZRbNVdyr}Qd?qAlM^(KaDWb{>C=|yW4b}h3UQ>N}5>p(<@ktzkC=IeZZ-ss)X
zr!TCsSH<YVMfA6YlkeeDT}5nVmqm1Up2%pKFj6aXr-c7Z-E~Cg;m?NIY~hsZwn=3A
z?V@|WsixVfO5FSTBW$}$U0m60<<g{>t^64C;u<Ummfee8A7jv^6>ix@O?lK`MmqG<
zIju77;{Q#jKAP)0HTP~snl)K^T$O%rdr!BSa&em-oRhgG=~72Yy1!A%R?|~i_VbG*
zRZNxjQV_j}!QABEU;qFB000$~l~bf{+SbcOAAyq`+SN1wm+$1KmQBxYrs}gCaHdQ)
zT~1P5($BtscZ0sWyA+z5lZCL9ERfbuLad>}6K;FzXu@6S{vOMAkU>m3r$eN0XdFZA
zT3q*Wot|g!eHZXS+b1AYX)NFceM-}bY@+IPki_-&Tuq|Nt-n}AV00#FZP#N<<-<Nc
zg{E&~m2WF_N2X2ED#WdV@OZ(Ul6IdAQI%!Oc-*$pAhvc^#Ojn$vPtWlBx$eWQdYK2
z71&bEa-CCYuBuWX_CS~6xJWq>EJ(A^Ygu9v*yY5rvnIDS?y8UyXRyM)>n5!U!o6JB
z8uemWwxU;@C&Ex9)Jd*h001%zL7Kp73GhW-YBP$@WD|18_89(NtuH<PI5YS2WF4d<
zlL#CxU*({WaiaBiq>~_y8Suif^<&~P@69&6k>LZ_F+};PE?x-ahj@;z_#@+B&~_`U
zC*Y<*16J$fLBK5szukaGg(L5+MDo(L^<m(SJSKjXc_mYzkk>C#8XSHW=A?&f)rXFh
z{dC_lYnPtBj6~KatHt$Vy0vw9&f@%MEm~=>6R;TY_|O~3HrK*2z{|ZAbj;2;?zQks
zmCPl=2f_&4yN3chtv|l1Bbwc~N0xp5CzKqVl48a1l;k$(mwc7fA<JD(HC_G_$)6-V
zMwtKrJfk-!33eiF%t6-)NT$*re_Xo_SIc=0$HaI*BYY5cnzuf-VN8B$ew#7CX#25;
zkz1m#!6l{=oL!HH^C3B<!;iWq4Y8qFuZ<KGpd`F2Zb7sHARtf$@P@uLINqB=2k^C|
z2O2yemK7ckja}A@9iNNj=56z8x7F{H8BOn(T9P9-CnupCM^_=P2z*+57rVk7k+4E+
z=sz~WA%~*rdA8~KXms0+P}<8!{I#rqldRtf&t6bKF~EX;=oL;ITq9_~0F0YE)p(u%
zxcFc{2z7tDZ;~Tj*&>zxwJ$f9;xPwsnab`zB!2hCVrK4tZY(CC1Sh+{`+w#CCmo|k
zYZ)E?83zkP17G33*+*B}sL)>U-2g*S4$)Ds>1WqBG^%GBlaiI|mSi?I{C6g6RnB;v
z)K5bb%ZIL#WUnBu2`beCaDEAFCdL5->|-Nd<HK4R->;OYWfx0?yOD!{b=B*Zoo|xX
z*huaYv<Vxkb?z`fczDff73Q~$K715tB?G=rLxe_L8<uRhT)bux_^Lc~5N8Oe2hsWO
z4lZ4W?Y>!rPJeyo`{9ce%344>OW%o%m}gyTxUO`qOdnnIZ*jd@4)XStPYK^PwWhHT
zQ)aoTUKa0r_`ENDee3S*v?a)hoVOpDVKB+LxdzC`lFEQa1)t!yfT`UQWd(Ri%dH~v
zUNFSc0r|1<WKn(al%dKRl3cvj7B)Lq6HO`r!hTy{@zK*`%282TZ$5spUj(?+o~ld@
z>zg3^Dt@o?RzIz-ZheU6^XliXmboY#;XY~E*W|9^c&WcWZ9;emz2VRPU+=j;g?Y5?
zu1sjZ<ittM$vfn}$KaDU-{BenoOy=Qa+R8!CHZX64f4-@b8SY>z3onT+)s;WYz}vL
zt!F-S`UW;b@ze%V@19tGRQx5KtbD<Vg&Z)hI@tmGE91}+&?tX>wOrGN1CTL%zAxsS
zFld>0iqRlSbL@NS>g%tDF@j4LtN;tDzBW;GPA8YkAj~0~m%IA3Gu~aZ@>6doH35#C
z+#g)Jni+Xxg5bci0sxn*KCBlf8w5whmb>{Y5*_hgG+I;u0I(0>f;u@olAsf-C_oq<
zM2AYg!-sG8Kz?0rxh7@l2;%&B*&zHZoH3*yg9e}w>H%)?%KS`Z!#d%Pr35U_8K5fH
z^%)u-OC${uLgePKHU>ElL6@r!3tEuJ33vRw%J^ju;678{5Rd?801(@}oXzLY;I7Jv
zv=ro%$TVj>oYu-9G#{78VGD*WvNRwPA_fILe?$^IA#pYmIMDY&tO`ip5H1kJa`#ZL
ze6;yHq!#a;kCJw0W^=eg<n=dphlGAk6OD}D)sMn5w8mI1I%ox&e{<h_U6G=co~-r-
z<+DKJz(3@NlbPiJye}FbZZnM=2nNd|gBS6DXf43W$yNMaq;y%pujQU8a`*E^@I{;<
zU>1M?SS|}IR2>AP)L=-Q0eVJ!PGA6${Y-UN5sU~=c0al*6Rr!Wh#<;iNTzpu)Bzp?
zrdjzbIXHfn+~I<Ws^<!nQQ^iPFd$3_6!S~NQXEEgEL6{rWTa&H3(bcikrYSpTWVR@
zI8Xp6_dYL{eMk!Ml>q25tz!nP2d)V7C_y-d{;Xef$AscBJ=1(S!g4`@&_-DX%>ns!
z4ke=3C4yja@$kN`pO!WN+FK3sWRL3C#92O79A|u|h7CR@b=VooWj<k_&0uB;7yde7
z)xbcb`$tId!#+vLPJ(sGV8SOYmlNQ=LCx8nivcg`gY!r3++a@rY|kMt$5MFe0PQ-U
ztF%Sr9L0R~@XBy|F9>D}m?fk>512ab*92Ra?jLf#NEwN7dK~NSqC4{7N4+GktE2g|
zFH9lc5c*Akf=)?80U^Y)aE}}u`BYBr*)&c_;VB$Ry62a?*j8*zoY>))Ckpo4wK^sI
zgG2lAeN^U{EW(83$dbMY=}u<laaGY36j`}vrI+6$nR>im1<}w)`GSK$FVi11<0p=}
zJbY64t8R^wHOq*uP2Ljas^R`>DA3u+GfuCFpk;hu0~XWs@e+Y;yJY|g3n__wTy{DE
zXa}AjH#Ri6YCceR-cR`cG}^#tA1f7HU+%c3;U6@Peu~RL#3BRX%disxy8L4_f0irP
z#Z_tjRBo8$VGhs}TgCGhxd<1eGq!=;fb%*(r{{RTc{IeTA^~Ry7_hafbb?CfabXC$
z!QLh7`?vg2sdC@q>bxweZx&Rr*{N^vQ6n`%)}$|78C@+7pmUU^Fk!LLd|rr);2)rP
zxl2+JpFnxq%=$b|IBq219}^eTBDXtvc>f+^z(@&T20tDy!KM<X-zHLR&<f?!Uxf8|
z*q!-$u`eYeX1RI*hLER|mc)|F%RD%^Loao$^GpA$P2OC@^6ptued>o?n@Xa%x(N<E
z2#qS&eiP%Pi^d)_#_&Tnuouz1y&L#XIO5F&sB^mbMvZ9A?SejrW{C8Cu>%kh`J-xT
zW-Y7yb^vbp1aD0y-k9;a!~2awJtG0X#ACp?BWf&Q_{N56!tMWvfk$*_8)F}kHAe&I
z;y+tsxrTtji;%m2h>)IJu!{8Y{%rJ-MG-cij|JZ_K#6Q%X7RG1Q~Ti#UAFnJxxc|K
zPwhekYofp;dCPAEStNmOJVk_M#&1U(2b!hfIfy8k9UzMj3hSFAp_DI=yx>S~D`_~4
z(AW&102z_^LzzlRF;tSY6qlQ-eiF7(hQh2pxp-=a90sj?hKozS2_+7oBQ3H{S|kqR
z`{@>omaOqTT!uMk{Jgl`-nq60Fa!gM;FBLd@q82SV;lf0YEGr*&9i_BIdj+X^h2R<
zO@af?I&oJ77EcS8iM{BL56x$SHh^Bw2;>-GO5SPL05NaAefEI1`1)9!(uG?6Ii6pd
z1JM8CJjaXDBdHtp06o7_Xa)!SL!Za_Il4hVd#@MZ2og5IW4<uFU6HMe36565+i3hD
zt}YxIWiq;rc)Nea^N>K+W6b^3q4{`e3nN}`i(6k23{O!9!#ux%Hsf$7Iy^hVmI7dA
zChqP3IGQ8o()TZDL(*y2KgM?Mgx-7>;4>iI>bc$VkC$XK`|G=Znux-z0;CY0Cq&TD
z54|T`oRQIVz#`Ez3G;a1x%1b?O3tV7?SN4`8P8t^&T^}3;g=WJc*3y%3FE1r^pKwu
z<eLSY`)i2Rdbr4s-!4L2o7^?WSmU5yurc9Jp*AKZ9|bWST>I?}3WxJ)uuc1$bl)^|
z7gh-VyWW?Jy*=gyc`O7&p(b+w@zaPI95@}2e0+3}#lfir*92UCGjyC5Pz2#IoS-cb
z5$*$Ds6a{h4|<y+`G=0i1;``uzg2pJA|HVIGJcJU{)T~1?}Cn)BzSkr3A(HZJ@#(z
zgm`I|GUAkZh#+ozkIxtXi0WTU<$@M(`ZnV#KPOj{f+$GWRXQhL$HY{T8=nud$&<_B
z4k2qk9cJ?SbPz7SQjkGE!5oa*Zr_2_AZIU+$*2r02X4`|PJu@NGw<y$?o4#I*NJxy
z&EN2bI^2y3J^<)zyiGN5jjjSC&*%=4{3mE+Qux$hZvI+``E(I>o=$9XUwzoeM{5Fw
z;<7@3Z6Md-{vWmU*oR_N1Xt_(V@HyA-4BS4=IWc^lDl<W)aleQiR7fa!Vx^3r60+L
zR(|+TW>JI2#la52gL$|jj|3-b6P$zL>I1zJCk7LX(x7Z*F_beEGynbQBZuLil7M+%
z^4RAD64%0fa7nl`4Zzv!ikBKNS^>!)!8H)@Z(tfXkZhtG|IOfsZx6g9hJFDav~T$a
z&-G3BkO}|t9uO9d+Y1qmjZ*{vxC`|9KVc%k$R4=A0!Oods7T=R49CD+T?6p%8V!m<
z2m(j1Yb$0LT2x*5U)RSCY5#O7>gX;vg4;tO!1b-)4_XKUGz2wZfpZQsAuW86es6@n
zz8_#UM!bF)qeBqm>nK3-^E}tVme26;i6>l_oB)QdN&N2NkAyM(G~6qC;Ru_J##}Gc
z>G6r$^f~<R@FFTkdR`}+G#$jEs1AN>E6K?+OzQk4;{gsgF<0=O`dde3agzkzkt$4%
z01Ngt&X9qC{t%9Xz<iZz0ZbSUb?hns|Bd&nN#9Aw#9Zx}m|vE)isZe1UN0{uCWjfz
zOB;_THzitJlmj0a)7KTogh#L&YwGWtz(>6S`{T!0@FUtc2?7U%CKl=rT5oDVd(dD7
z|F6*ae96oZml{sLT;3jTUJ=Qmq$P{~G%<;{f!3-n4hR1BYv6_in$Pi0udy8rZ-OfC
zo4BeykAx;&#qQ7|YdRhHC23=T+71FTaPV|vNcns>33j;olT8LE`VRE4#qYWQ=Juv}
z_%BP~CT?gyzN|9->OT9&bM7+CrvBlX>*@N>^4?4!RdUANe=j8lGE3y-wW@>e2%`_K
zJRex6;F`pSb9G087v(2ZkKdQR3aFlfXE2j<Pr|vj0YLzZ`~-Y>Dd>PE-_CA;414|&
zI$UZ$4->HPBisk?Vq;%G#C_Gnm?hbpMgSe;kUxf9j|Dj3;wGVMNRUEw1=F-^&;RNC
zR*>&;7|cfz_$uS!pn02@V@8R(ydq)TI-J;eBdGupz=J410JU-bNI)iPkbm!vVGZ#E
zNLMv6vV`yrw{RJC#A{oBm+<%6<OioO@J*ButOh!0+!0O>o0WgK*q8qVS|wrhqZf1T
z)9aQ#cfckvMa|{mOd}D*(h*BZvZVah_ctVP*tkq>YUH+wm%$Hdql4iLf~66A874kP
zfeu7}gtKQyl@FFgGJ*~F*%Lez_Ar^BKuwFrSmZOkQ;shUCu4f-A-WoD&^y(^CISbn
z5A}Em_Bx|{MQ_5m&A^9)(s>Q>R`mNmItm=K;Y>z%t|KyNf5e_7?g9Y&Km@-DoD#Fa
z96Gg}1QR$VV=Is007w$I&~IL5J=`C7y&;9aq4CA{Zp3xG39niXH^+<og^yqphBNPu
zhB{tY=_8513DC!ZAI#jH^8y55-{zyo#zOZ&=WmG7AVbm2i*PIw!Weg&8kH|)=FcC^
zltq(X_#x-gCzPBPU|*nYKofsPyrHcHKoT+J58olB8``7sFW@UHn-3rm1W#aVr6b^N
z)8Sk+iLfO3t<7f_1I>JNPVB5kB5Xz@@e*PMW%dC$e`A-3)Ruk@H!!V_f;h+kCW#C|
zqsr>x2n);V17gm)PC4X^&>V`I{lI!h@mFbxlO9jU+MECc;D9ulvLaqE>`wT}xAMY_
zXTp8;P+QAY{5c<-`o>Q!{$6f75a3JTlPgX03*?oLTwPca$Tc`f;D9Thsm4t|lZuSb
zj}7_*2j45{fFo<rem+2g@IwMGz-Oibp*o;AFM8v!CEf<2y*>?zVR9O0KzL~;&C8=s
zx8Oj;cZ574h<qsE5<gr&{%S@$gdZoH5nbe#Pd60^IIwvIvH#iQ=E`1L<j@EY+@v_^
zo8niA{2=`S;kpcFyP6R`bPvEtdO&XY@&0I2F`R-0?3Wkiz7T(BlJ8~fyxm^7Bbq;^
z<fh%QXV#|gjt`ALA4_~$w5%HZCyxLN>r!_$&`6h4g1Ksdrw|_<gpcb)B6%Oq3Sa7d
zbHM;$P53=KPo#c<PI};iX#~y>frPF<Nzif#7<CdG$LsPAJe$5c90R;aOUW&m@9`Ye
zi<;(!IX3NZmUJfn9u%TDLU6!A6U)l5JfH$APhDt&>%|9L6>WatJtgxi-Cxw`8HZ}0
z4$pwx0JBT<2mD?ge(ro~cg>J&;Q;02@!&87A<Z-qAb)))Cw_Va`7d}T<j%d<6@ZoQ
z1J}hP!RG*%bKJp_M~T^>VEfR-JO7IC5<NY((j@?k_{IPe+%k*Z@_xT8BLW7o1j8tk
zKZ}kweuoHH6KljTL~z$1F{yqNoRvR<Zv?;HG>EwxoG(G~<m}r2;F<)#)$;J`-Rb`C
z$RdF=eH)jMLO;#02~aqP!A2g2gvY!TP=R7zpA>&KnR5}r6wIRD81Ksi^J%a#i@peW
zWx2TKUnFFe!$L0?)mtL0e*_*o9X#lfyy47hTS8+se~Y7KGc3>PZ;GWT;#LAEfYb0_
z8U>!TLturDf~-n2|Aa4YbF>DY<Do<2um(o2u2`+YoW9T)`}_dn-;q27dUDUkn7Ho*
zyKN>zi2NYS){GlO3C{7HPo9`a;R{|XjO`D{O`4NGHr0p^oXlI_;dtD35Z%b#Tn8m+
ze}i!IgD4~-@yvgkWs%1Lfm}HW96CLQdgRo<#bpw13O4+}UV58Nw0;ok()TGW#{_e9
zlJfE2VvbDQo^D=Ut8bHP-<DBC<N^?D{};{N`|j!fOwu%RbJvb{_#&_&;^$5en~_ua
zDz;I5k#J^NKt^v%eoQaY4kt19n6!U{ea*A_^r9TO5WXYC8q~~1;wQu_{CAI}YCz$`
zBQ2{K>SM%mV(LurVaf#|pyNp7gGH~+GeVaUi2g1%$qOy!4_hf{|18nbv@jo&O&7q`
zf(zkqBYi*Sh=9}lsn475n-+#j5B}+}Nqi>?Af@{wga2GBuBC{p5geXwBbtt9*Ih$g
z+P}?gub^e&J}OpFYnw5B(_m<9Ym)lDYS-b)up_@-4dh?-)p6Q!z*HUv?ZO3uFu}(P
zEpV)43I)Og)Q0*6))q=X{wfpw^BbrJsMSQ%!!JOmGki>IipIebIu8NREoNx&V|>0|
zJTI^R@R7~BK?KQ&H-~AQL$SGf1D$>shpCu%lQq41#}HQkG%tyKM~GjEhm}138HY7R
zYiIrmp(*D_qYp_}iLa7*0hyh3pIg4rF0Kf41R0fYsX2Ii-<v1^BjE*vxjF`0@>a(P
z^<+mS_X_al%4Vt-IC%JNzydRU%ew!;GBl50uG)R_T>PL>yt~Ja9#1bXCfO6Ra8rar
zwU9S{lFJ=;_@BKg*!MWPyUY+9OPfwB;v?}2@qAUvH01Jp@1M{7k<oB}JN#4&X}rLJ
z{*RsJ%^^C(f0EDfGKL9~`)wDjrRC7l889!BiImR}cNZomBb!x-=FwdICs7|qp$-xH
zMCQzee=ais(izJhC-8qK8A65b%;-=ax$77!o7etHSnr3j5h@QX84M!8^fhx*V8H(n
z7KU7}6(&U0o;HW-wnOoK{wAD#(eTPlYY1Nj{Goz48D#(hJP<|{Ve%vmM3VpFHBN?a
zjt1xp`6JOUCCkH}8bQim;l%EIM~^)8$aWQjABdfhKbk)r@8_?dTl__W8ZG+9pCQjS
zifDg{1^ClPZryx6auI$c64f+*IMLIeSFRH0QI&ZV_$7_C`LP4v;mH|{Q(rYEg>vk3
zGPtU8B$0|4n4R<a|BBE!$dIcOHwFfG@dCacU3>_)vp?E?G$y>9iA;;hq@D2QQ-Rbp
z?2_@sPh6O7S@49l)V$tD;xOg}hZXTXdR|<M+g$ZBc<JxS!4#u$m=CC)_C?>`34H(0
z^3e~32**HP2<q47FqXCRc)x`F%t$cICE$*Vr0$$wB_4E(f^N`a2nkMOfLTo9`1>1D
zjA`8i$I$#up&5?UWI~hPcnzNr3H;xgcl)n6f63+lTqBwW2|yiVLLodqkM+%%Fd-{~
zURgp*&tKX;_#>E>JOBjqb4or@v#R{EOr&+h<JRaJ5a22z=j?lxhkccmak_NQru8~>
z-lp|6_BCTzxAqruv1MfkL)lp&(EHa7<WqI=+n-z&c+JpLCO$SPn-s$o&$ym{KlM%W
z&*09O{8p(pLh@M>H(R)k-V5dkBLmHV`!wAIpGDE(C_pF%WR6Sz7SJRR!85m?H7ZK|
zKR;KlS)#!rz9+PkRfWak?H>`Jg=RuwSs{;)txTRBcE0#-JP|PZnPq>Ui|3Y;w0?Tf
zVTA5~d>8QS9+n|M+Cw50pkt?{qJQ|gV?an4$N(Ru;hh|8Uusk1r3xp1@mSkQm7_)G
zG#r;U@Fw0lQFxyn75hZw^~Ym?0mpD>!hNp$yZyC>er?0nJV1qigzlixpxA7t3<Yvi
zLC+#^&OVXX$1Zveab9mAfSfQo7WcEg2Ha+nzE{%H%K2YQO20)#JL25GtDB$KB|>LV
znfQq~ZW@x#wK1=(%vS|;6wWjbd;vw$etX;Ft_d|N557pz_cHQ%f2;gOrSs&S)`~B?
zby9O~^K#fW4D4Z!BB-)GgR&=fO7+&hUGL|vPBK>iy3Vl<ir~6rP!xR9$e^mQ@Q%&2
zX%u&$H$=ev7hQzM4Pf5+AQSu(;Qx~${FpcZLoZs!fiC07s|EtUpT^Ktpy3PT(M{Jj
zJ4z)p#Q5ANdo}c)BjYVKwZ^HJHB_bKe0`(id*5Y$4fFc@;{->^7>;oN_a7awv9oWE
z;ig${wZ2>Cf(IH0dbo?~^miW0ch2g#C!L5c>6&#juF`iPzORL=P-{?bQ!lTb^S-#4
zD!CqW2NOh@gNekMgNekMu2}{<`L;ObJbvx7E@|{j<*+K8SHVPs6U)!OlY&Wc_lG;r
zbi;8Ul4Mjro}rZD|NmD7;yn8tCGv84y63B8yAS+K!GVw{h-5zh$L=s7S}=QQG6;K)
zF_9iQWl)@0WLB*O3YluTc{={NG)iVa6ZrdsUIhXC|H-aFUL;pGFlVFp4=rax`EvZc
z(DaV&3=GG2o%6eElJK3$`24dFQU39&S(r!R3+|l0xR^McNsxp<nnU}}k^<6iG}O)U
zTSr&s{t%7=e=HM#T6uHjup;l^hmH)}k2Ip2z8a!o-9rx7pRT=JnHR#x!4AC+;;S_k
z2Jx{hA;U9Es6z3t|C3hi{c=(o1ttntHBj^LzOgY?LI{*<b@6}1mkMq8YfdsZugv+L
zUKWf94!B3v2oI*dbrLA95Qb7YnsRva{~ju}!9E$2!wxZ_gZWnknAAJ{^?!nm>E=>!
zKpy#L^4z$Ec~0v)=X&8D%y<xdH6@eN>zZ-;ehMllSeF?CJy4+jZw%IWo5JWIgIATH
zrg#u!=GMLn^*P@?C_80Gxm*(Sok-ooz2@MHy6Pi~x>v~v{`{D^GW=hBHoH_M!tzQQ
zboP*ABeznghEurloSgX)#bi=4?d>BVkE`D_c##YEA+l0SdAOJb`3V5}hkWkS^BeF{
zx*v%7WAynrdn7V1378*(Yp~Qfa_uj%9YkP=xhroNahV=Y3APj{;Dl@SpRViz6T2>4
zL9w$9<?cHX0r}tLj8jofaXLjjwTTy@tRM;aF_Rjk#;GyNP7~z#CEQY(C0^t7*vE+#
zz@Rqla}W?l<xih=3{AsSGk^fMxKQd7v~&Khu1UH(Yp!2jpO?jBd2Lce&ge$w@?rTi
zDBlyt=61yBQe>A2#$C8WfSWTU32`u=bgjw7=!XQtfeIdAV@~w<$>w44GKK~P{3D8n
zObTj)(Qnbo-{NE7uXt<5*q4u};IKcCF*M`Eui%bB(c4n#U*82Bkm(Z`t_d#xUwp#_
zuLN}(0WQbI@<A<0o-a}cI|Y`WC!;4IfZs1H!v_K;;qI?5CMD(L9*e<5vJFA!VESe;
zqVJC5K)}9Z6wr0r4z}oZ!G?7fAa=p9A^eZV?tNhqUUlOcbW(7?k^?7$Nu<YVuh~bF
z6Tih_J|_`Om<eW?v%t6cEa7>k5gBMpCk3=b6l+AnJie2H8AOinE8vU9K@ThBvaH?9
zE+?BRN24zUJ}c<XPU>E6HYpo^Y|~|hI3mgnodg%fXf<;sU!V85za(fT`y%j$7IYJo
zw94TP!EUdas)1HH-{8Zg33)sMU5`@U5Dk3K%DCR=&xx;IBf=NOalnFbVf0wpKYP5q
z7FH&6ZXGkjvTme<a5=;W`-%U8$bPfsdd-7(IJgO0cJmYRH>ettZG|{LFNW;qt@&tg
z>#m}@<y`e<RSo_!5YN@)c_SBiJMYg@@@Dvs2)1vF<fL+z{mY&shNGehUs6zrzwqRy
z$IGs=+kcmWOAKsscdkzt@?-CcCa2)C68n%@@~+eZCi*(E6l8<gom8<V2xiXZdinFe
z!tl}~jT$8a4%4p_zn`M_5^!(FhI*m0J|~3V|NJC#V{tKxW=vXR!Ui50@ffc7j6cu(
zO@lJ6@^#P?Zx;IDRcRl@(?fv^@?G!nPag<H7SKhRKoXHe(7?U$Q5w(4BQgX~7kspz
zKNplR8zxB8_+O0W(Ii2RynPe=w?lckc`_y=1UyE{TeQD=Niux(4<~o$8Sy<%pFKv8
zJTj-`=GtwA;DS&9m=ZAUK;}Cf6D!5Qzr5{j^YbN7@zw^jnlM~wcSQ6f;LEw+1y`hR
zV69E^4#S8(JRA>8uZhI`vfs3BOV5vNZ-Als^9J`>rU}Kw!Z!)bhp-dQGVCXC=m%m8
zvBpe!caDO@+}O}SHUtyGJK=mM)m_1nfLT%w0<;XZ`^JQax^<}kh4Z3>tW6LJ1Y8Is
z+JDduLFe0!8UL2h03SjyTg_dM-qHx!>i-T|8d}9n&;Qmb_+F{o(n&}A|KNv@X~8cM
zwCaK9m?z}T{2`ZydlCADl*a|~aGe2_^eR#Cfs>kxQGMATHNt#^(EhSST*`tHiQ_Y3
z)Ilx`HNfyZd=UxJWogk{7vn<*bMd@aFUQ5f{7a6>phfJ$9CwBi5eiIyur?C#WH<qf
z=5LPi@b(0s`0C(HD%bs8`+U$*JV@$E@#elmejJ=InwAM<Mq!py*IxPRsO4AwUp9K`
zPAjQ~&esH3RlZ7#<?B(fh8g6>?tgw?KNHO?qLJIg;ERpUYzfOw!!l1cXjysdkKFwI
zUicu=0C#kNuZ<yzz~8)~YvHL<D>EMdED+KkF_|@yaVN=%UdI&wiR^L5!N7MR83YQ6
z7LY5=fh*7*x#&219uvc;qgV$GB?$1^<P8Y^D-NzzSUd%i^a12q5BHS%#y|dS0S{NJ
zer2=))5kzZzFzZya9u!UPj_xuEkCZWFD|D;t|m;`OD%PS<k_GY%i;}rCSd_(;W;DB
z1kMl#%frff`FDBvjK0Z{m2aD8e<cBs`vkbhf+)cA{9g&mzhLQ1YsPSaxgebx8t#AM
z{Z{<{kU>z#NEGHqYzl1O2L><1i^A|s*!jZ=eZYUZdP~A54vg+TG)t}F*n@3JA1@1_
zshgJ_5k`cTaN>XhO{AM`B-;94@B-}aAdVOR*#RHm5_hGZ3T2>0$<UqOd*SH5UrO2k
zj_@JevakV-tNGn{9R2H6?cZwKkMHmSmsi7;&5cL0^Ha+b^Z&y$x&3q0$)lM+T=kiW
z75JXHL~~Y@HOq?e{Idoq8)R8>Y1&*b<0to}OI+_?^3IoI@JD2Wk`Ta-Xx@I0!47FN
z`{%6LIiFk@TOUp1uZ%wNuzzTl$Nmd+GA}@Kh+F{97$pD&fB|FRuHe974^l#@^Slwh
zbYL<!+8kDRe!m?Cp13fM8&aUaIUB<Df*+66gg=Wnzepc9m@x4ef^i-r#CVSp;y(~t
z)ys&NitrM8!21*qJ@i+>KOO)L`SIo8r_Ey^05{!g1>XAsBt$qe2v22kU62WXrJ8_8
z`0h*16x}=&pY9`nA(MD>ca8`bFD-P0a$d7yCE+W+_UoVBA;+(Uc`vw2f-Q{5KA)bX
z7)mmF|K*eNa(S3szAx&>)z6C3pk7VV09!AhE0%waFXg4Y+#~l>jr!@^s6ZeLECY=@
zpXJAVgE%H^bFA;5&*$^``tJ9emK}6%HzyO}qyYIr4im7?9Q+nwO4J8|@M(5mR-r!u
z!KL1OeE|LUzTLn45@3VZV1IC7?vQ=#cf{bbfd~OU{Udo}l>d5w|5SK?6>74vy5#QV
z;D;W!;V)W<?~BE7mYw6NI0^M=j$HYM`Dn^(@I@sxm3JIl<nNk{{YsK`m(6K+!!rhP
zyS*PCgv;yy#Zd8(&|iP6=l*RJXmosM!`^+R?w`y{!2e1E{7q03L?6KgKyA>#<2M0)
z-{tX<UCHLzfK$O1I=#LM@AJ?QHUzq4KPtDFa2B%;15z|Jjh*xP{QOQM#9}{|B_N4N
zIgbAYngb3tC%zEy&IXXeUrA=Wl=J^@y7m8?zzKVo>HGil$9N_k0qKHAXbq)+gZLzP
z*=7MV7}Z9;zkJ-azIx<JG?(v_C_@fb1rM2*%{taOIjkZqv>}+7cZuq?uZ4OL*w(~d
z>Oq2fo}c-zW3CANviHFbWXFUjubaim&r(t)8T#VoI%75lgBWwX|Gr7r8;`kAW@`F=
zcLHtqH@+E~?oZFNfcjg4BcY&RIbLN&TeJb{`FcBilw^a+CH`MQMYq`J0tIkY4zHn-
z#y}aV7<$zax187Pe7=r8GBz`~ap8eK|NL<Qxwy)Z^8?d7cZO2<EP_XL!cX8sj}A2~
zU;!t;BK5&0P|-&KYyVxH@!ZD%BUR`=-k<^-*ZMzSD;lbe=EkEnL4d?>^dnc37`Ec$
zUH+G=%gwEP))aIe0|1{rYaAK;CLoZ@3=^qnE$iPTzrF}~YLoJts};#ffR;Ab!m|b>
zEWw5V?UgM7tE&uTB0s}&hz+`s5@J;>3xD9Quw3*C=L`$y&i@~zK~e&DhZN{r1_2kX
zFXYtSW#)hK4iEHTKzr~}gz7i13|_mR{*i!hk$;{+aB018OTrc#$JYXvgq$`b9~U?j
z1dUi7AK(fQ@L3T+@*9YgjOi0HP^9J@a|eSYs4Nxh|AJU$+8XlOl*VU7vb$gQu51!K
z1`q;mzW>Mj)W0LgaN|`0-F$$aa3pj(rDA{2+F3{p{0urf{8gp~(+)Nd$$l1^MIgZX
z?WCcot-l{L@(h=gKqC%X;x(Cp!HfS_nj;Bv<(<jFBxpka3dBR)MrmZ172c4*s{CJI
zWz5+xJ$QSK{t>+9IvGO$A|ct26}_pBrTMwT0WNrAh{xi2!hir+C{_EduMK4Y0GuzX
z2SE>O`{VyLrFG+)q;Jgs0!EM>YV0(y7lb?qpggarrXp{mw>V?bd=MHoq?*F`CBv!i
zb)bdUkd0am%zP9=J~KsOVe~I;7=%7+OtBL3jqRTV`+!7G;`;`B84dw}U%@X7qPR^Q
zXCUGbQnp{U@Q;n>jphRrPm{~wBK!t?qv;xuCH@IxjetqFryWQJkMsvygM4a$udF}x
zoSIWN#Zn;@S`ompz#8{BFyH_d+)?sQFm{W=(*yw`wgJb;b-;#(<v@ZDJ5VpcTU?z=
zpDg4Qm>Gg%xoWtMNm4P`4871hM@S&}raP9K;-Wt-nz}d1vwP}B_#w~`K;X@k4=<BS
z{$D1(dhyJEiu2N(z<@rl@%9mFfvSD$gfss@IKTi`%b#Zsc$-WT2Im~cOB(z;jt_(2
z5a>JvY>Vv`Qp~P2F2BQ8*_28TELpf`^~uecL4O|sZTF*i>$2hbsYNp59z9wnCJSi+
z(p102!WP_r|5rd#{C_+dJ>H*pw%4vZdwbxQf+yZh*65H!LiYIoA7qJzG>Mt9#&OpS
za-R>f);Ek&C(yr%O%&E5F8DB!#1AO^Ur01E+pp%~p_Yryz>L=XY)ca_LLP7~33;Rh
zt$*hApxDNdcqNYbkGahA2N|pB6XN^<k9W(ohzXs;pP<A2(tV`kRaWPMp8_*z35<>i
z1OaVNMx9dBl-2OZkz1@qTps^;+Dn1_M^*&ji&}m08w7Rtv9KSleOMcojfT-f1H`M>
z31x2_6PPay!!1q#dWf1LU;XK%nBEAtU?uOCc~ZUzaNHAzL)YH)VNOpjd!?<$b9N!D
zyiSP7b_0FM*DsoqDcLUw$^aAuU<&uKz>07H3xEM$9$q!t`RkQgoBlFUg4<_M!Hk2Y
zEjEx)J`VT7{h`SAEaImfb5?Kbf-b9v!EB>U4$x-$6owT5O+~Mp#*HN5t>&g7KOKD^
znMVnX9n1fZn3|eTdvq3}pf9Rge%oN)jPsg5NH+M|M*X@Ec)7=#exQN4$2R$#vH1&A
z(i0CO;PUo{baFb0*Qe(2isl!^^92EDBkFrVA#0DqG2HmTS`B}U;7hF4;=g{EZZQM|
zesR2Tz&-LGHsOJW<jwy%kNb!J`5gByG@n2GmO+X~FL-gL<?6tk5!+r5pM);U|M<JF
z8`o3sBzM6)uB4-{PwMz1lR3fn=l*)e&v<|9sQzf!KtJ~xoQteY^Lf9QO=J0bua~=u
z=AKBXW#-L7G5gI54Rv`qo<b`({2^gy_BH_=2AU>p5tXkM-s3>`4g`SwC2rkz$=vY%
zI@YNmGKgUiFg8J4oK~z1iLtQc;|Ieu6)Y%J2D)Jv9P$1W&c~NNy<A5Va9307&4mo;
zG8k~G8yNB01r*Z6A)@nW^294eW`JIO_`D=A&0JlNp(203@p2DS(lQ$z{sm;NY(x?B
z4FQex@81{WOtFtk1Ky>)Uq_Zlmesew7A7x*jv8ekU>s{w#>Rl&FM^Vg2w^K=L|UGg
z_$ZLtxHA<sJv8+SX>Wgs;G<I-v(}ja)>6WnTf{>=V^s`OP4Yf~U`W-={F0(N9YlCz
zU3yLxlRV?7m>BgKz=f*s^@2_lls!btV{&uUWP_<9uwnluA<x3zI3$YN17}h4j-4TA
z<mRx72m&%32QLIZcd+x<8SnfM;ia$r2n$hqkS~#s|L64&@Xbh<QGz1|AO3omTmQ)z
zD*hvaJ2V7&dY6W1-%}hgPFnirw#}5B5<>|t;<**c_<1fbh}~2c*_9T!uN@Hlcy#N7
z45?7|*H$4Y&+CS>2InzZm7O|%ZhD|q7%P07y@<K%(HzsCGEtM(PF^}DKRrkL{$5Jt
zhlcq1FIA_Qdw=Deo1mHdoDdA?VJ==@9)HA&+r2ujT_mIUjS?oA)^2XouJbKO-Sbkr
zuq0FRaL(0M&JDvq_?hCs(XpOhyV*(yH$8aDC%y`+T`2`dU{nqbhFZIpop8=HZtaKD
zsABy5n0E^QH#$~Jm!ZFwJRv{lscJTO{$6hB0{&WONWieKe7^d{@P}+@L0ME&R1JWS
z|5<!=us}>CiKS)n?ot2UYf&2N-#t??QrG`3aY55^fP+3vX0G|DlV@DHLu1hyIBqmC
zDdU<i4@~~}FwPm7mN@uu9amNVH*Gb+B<LIUT-<qo32Mrc1ZU6~t{dbKU4ANJ5ueE`
z&?W;o07Y_Oe`(hY^paVU3{6x2JxBZg8}9Fp>y>kE@UJhM___m+0mF~meQ-h9yx>wT
zv;b(CmJ2_PgWs-hqrlp@CzLQ9je*aN;an738X1fZY$(pY$-Wbq0&=Gg<HMyo66!j<
z7u~k(6@H^(0(0_mO9H<)UieBd3=i0BWJCEj?URb~Vo)1Rdi=glbL0cOFW|B`DWOn`
zb~bi85?27L1g-<JBZ~3uPESq0dMjYO7(<Y9Is>pwGtbNA@$PWL@1M!VZn(f`90%s^
zau1shU13d7{dx<zBk_>Gf+;h_U0F9bKG!C*85_e{!T_T6_eOZ@hB)}}*ziVZ0BE+y
zL(>g;SN;;GNePgzt_(C&Bq$a%1p>6?Wma1M=d3V?s2GP`u+RFz_vN+EP;2-6y>)!M
zy?51o5^<sN;QGJS@p;!yy~i$myiT_5vTbm-2SK*y-*6v^GQa2VFZ}h7q+FlACt5{+
ze>QJJp9$-tcSbPN#NuF|yo1a5BcM7NH21^ZS8cMX=Pa|*GM(k&$tTuP!Lq$STqPS2
z{Q}8UbPRV5UO-|2D0wf#1)R5&o}q-xXu>pHf6cnrSR;5Kpx6v}4z>hffZJa3s)Mb7
zhRCe*RCx3G>d~)3|AnX%4CyRkGj0s)Q^WrZMnn;(`W+@UGNSCM|F2EL+O)x=KxIkw
zHqT%DCCPqH`}1d#TD42nfqA4$qkVFOIC6}?Tv`^qCVfJD5a#*Q;J$tJtwtVE|0gDz
zCN<TFzG~L_rc-12EF8v?@JFP+o10pT>hFn|n|c74ZGc`F3gWYlwzPi}UJwM~f!8-a
z{qjOySkadPzD})pXE4J}eVg1*a)bh!AJ1GE-~Dl00*ogxC#7N8IjO!ktHJ^tqYt~j
z7KSz6w)~mj7<v1zQD<_nxv0n4a&y&`e&^v18P$xy%(3u+D+!NWe~J1u1R9a%2+hRJ
zg<pu1ecxP?7@cbaeRVGcc6lK%KQ?evbc@fI45j@4;EtHcK#V93z6qs-;#bkSBc8ZN
z#%T}XHwm5|zw>{-2>fifaq5~*vV{e{q~w$ELBpCN!%>pqk1!+elNu2XLHn%k;SRZc
zvbnF%Q2UoWVH4!*m2=c=_rS`Zlar~UPJdK*i~aItQ!1Y<pF=|5Rn4un!3{~9MDR^K
zGX@F`6bH9Mz8SGc1IxhbfTO~pkNtYO!9Q0652$OGjWThRJ6lHa-H{Ma6DmyanWzC2
zzdd|5o!{3cWD+G&75qEbtCl*`^~q_})qU$#)$h7g+ZV%IrhHKPBEBErUcPM^N0*ZW
z`Mg|_8997Ifj(KYh=|GGck<d*lY&WM`fjZdG?z?<aTZEbJq0YhlS4uHZZd7<0lJy6
zssHQq<>A?N)$Z@Edj1*Y%hn3!rKn4*#BkM=;gj|G6i)z3brE1sH#fd&1Tad);Eups
ztp$7h7iSCxn=I=*xJDG=dEsH~s>P7toz~-rkKvwcuMbHZsl$%fCoR`p+dB9q!+&i!
zue(Z)yTyN(xsb;5B=|vYS6=zFYw$zNMJFJOntAYf)!{)3gh8sUh*t$rAsWn)6aWAK
za%-gk19{QT<#9U#l7Ux%7e0CJq->v8zID|vur7`<RxM9-wk^}cwY1}nzH6m>HJ-Z8
zg&zlGTv?jNW1wB-7fY*DW_29F+Qg*82!r#%MnTdF=4JxNgu&54lQIB`#3vjL2r5t$
zpa7=>&H>U5H!$%l*jcSe_~f(-=wcysjRuIJDjNg<hYY5OA11)lgNC9@2wM=J21V-(
zcM3Fs_*}(_zy_H)0K-5NCap%w5tP6T7^PMY84W~0sc|HjM@YM%R$w6JL5^Os$())l
zh6}_1000000@3)z+R3oOyF-MRSAF<%le;kU2aVe4kht;p(_vA>JVLnT4_G~6?Y+0P
z>w9lMo#lD_-cjax2b0e8y?<;ESbFEQ_Kb1425FxP^T*nH;P#%^to6VTY3+L8dtTUk
ze!1(tuzO%VpdQ!&_J9C;Ko3}ZN3I9A>-$Hx_JQqtN3HFH+xGv60DFG8dcXknp4dIH
z?EnvGJz)0zvF*KZ0QLQU;(KG-^@G~>!`eNu>mJ*H003bRL7L!tT$J+hooXkoeQWDq
zTKd=4zP0tQhpC37Ed=3R*>Ya?&^7SgymTmN{6$#tgpCiULc1>nG>M-{-G;-BnDN@x
zOoYcdxZo58q91iLts}|RzDZ@#K3hH4G>iAu@2h=V>fcuSwRMUkn!5O2cxMC~GgD{c
zr}*iv0Y4|Yi>^toFT_&QRCzn9;yLU3ViR8c?eImA`x65%@JGf*O)z*{!`EoZ8eD=j
znfVcn9{*N8tbJIn9L7YObeH7y@QtfQ9kGCrIQ8mK++iQXv<ARwp{dveWFS}i#>iLW
zpBP6yb+PhSHhDQ|KUeuBhrS6TB3E6N$w_kZ)jbRCooxEVc#ec_E3H}IJLmKH{QdP~
z;&r6Tk}nC-<pcqkB$QsgClOMc&yo_cf3vQ2`L6rx-z5efL6gw@XPpx(F(|>HkTHnG
z<#)}DrXC6)nGgJ5L_IpT!nt^v2kPGl^0!Sgfq3{k$$Iph(s9hX;ETqyVs32TCnuL5
z1{K<*aH{a&SLUlV;o$iC%o86dN5RG8^*gt(!uOn2xdw)S;5zyQY0Ccu6&!?WEjtm>
z7$ALpzBK9ZS#9yrH*N$l0@*4YKz_G<`lmjz8~V0&RoyEz(0!fWBVSke>ZD-X+Re6v
z2Obv({t7JHC}8=i={QSNxJinH>x8P6XlQEtr>EwkXs?k6^Z!=)FTC#a?>^}6tnTx#
z*1i$(;cz@V2E~EzI#B`eoVVE5QV3UPeExqwFEyt4RYz`r;ve$}TM4)%Za+W&ldi9c
zReZddh)*nJ6<EwA=WmFh5ZHKa)`X~~X=@&7BG$Mi*0h_m;T|7WmV^xmZWwSMAbC=M
z=CH8zuYnG2Q2uIqz6&$x>u#vH6m%jeEWQz(^+yFff^mt_P%ZM&e6=M171^9XR=php
zSk4J(Aoy<pV<0EEqP9-C!uiu*2<b*dg$#rfkavc=kp3&gE6%Sv{c4W?6=geFLlT9y
zi>p2x;gnO119$M1q1PujcQ<vc=kxzIU*ZJ#LLmG2za%UX006Zr;_|YFv^2A*04|Hd
zaj`P2LolAT&aXPW>-DMn)gQ5bsPCW8-!7fMHK)<t*H?)<uYy|YXrMR-lRhFc3ZK=#
zb=7fPxWFSLLXET6G{Ol^-^&~qRF}Aa4ADu?3ch$=xK4?-bwJ|-q=$L<Z<hyvEzjoD
zYv!4c<lL;};W)@tfKNB#y5NE~8z|n2h8v3Py&+gM8m@juSI9!le;<v<laup?A*z19
z0a~dA7l=5(x?i$}=l9}hHDCc~AC%T%hs{>BFBh!(#P2?w`uf&==iYU`=x1J0Zv@>W
ziVz1lKt@JX{|x1p!|>{Nf5q~o8U&gCbY3dj*OU2n?ztr0{a#K=SNUlx$=@>+eqL<9
zoxmseb^mAOu{MS}06&C#2s3XStJ(koFhTvncLF|vX_`K<8_%pp<3tljdgYZ#$kJVU
zUS8U+_e8?+TL|8!4odtG&{W3mb@NI3JGnTmXk!Pc0(fQu@cca{esV+%uwlprJBk=9
zMK-^T8k*+UmV$B&{`3fm7*o}cmeh>jCpwA{v+*7qYv~~c`RnJ}{|wkRQ^n7nDFztV
zE=@_|_f5U>RL`%5q-rwez8^y%hp@b661RjBD1QUJ8vvkiV+}09@B*skI=uSCZ$7ae
zedpiSzO|opFIxK7!6f1(60&7*_SZ}>+hcBTxbe%I7Ov&re3>QrdYqczk0dOfxKGWe
z&iN_rzHR5y9q}C<z?<?FBXUqAXwvaG$psfxknXeZKChe0e&^2}wN!PK<mY@s*9E-t
zZT6V>xkO9=1fkah?XVhNUNO24!dcc{Pe<-ab;4R#m!j7;H=9fk`6)Jl{v6N<%&!Cu
zez3|B9uR>a;5sZ%os3n031~nX4X~n(nvDVl1MsAKMu(^r47}o$4vk==pq@`KU^Fub
z9t!5E5)4j$6UqcZ+Uw$F2_S8<hEZi&sdHH%<v{o>hNkk1Kp6o6Fct!!5(F7R1B5&y
zc~;6tD0PA4x(fhA-xFX=ct>ea-Wx$>{nrFmG@7~c$HxxAQveT-jE>iW4p7+XpVbb}
z&8B8QEQD<(=Ab#1kooyB)T>na>*s{<&b7~98tcZp#Q8CcVHJWOc!gMnvmbw2&%FM9
zV!Zp$xen^NCp<9I*DTLr{^tH9n(sd6@0&haRr=S(`Ev7MK>mHmcYg`iygNN#mqb9l
z2jHIj^JsGUUb%R$JLl_~fjHTI;6Ss!ez+;5l|1{9OntSb+3@|NWPlLjDQA#e3R*wI
z=&V(H68WfbK$R!pmOdXh;|fTP0-Hr#o4ob>)w8Y%{RVy-hA~0+9tbfHii;0V8z_d$
ziv@9s)$zdKzHd?ZoHHH{!4p8#9{#wEPB`)FU*?YrI0Vr@%P@equ1r3>pX0Bkgn_*t
zJU&-^_3{3X_$25M;hP^W_17mXSuRU*ga_u#)%+G^K{A)L$4F>&c3)TczA_p7xW-Ny
zl>}~MUmrx_-wA0htl9gI2?z_bs`}dz=hh)!bzfG_?>?jXbz1IYi!E1q5HtO2I=`(^
z|E+ykK5E`9_zAtwelLpf)DzvN{wBcdL?uebjQ=F|gVz<tW};|9*SrZG!Z#n7Cj?a}
zfrn+>{}Zgo&AuI$bnjdvW3V@n{WY^4AH!M1G1BdP^<Tmk0=UR*@vmDyh@cgL24&Qf
zP%JC||A8@^4dE^ui(^RxekKICB9bHKJC(vy1_cH(Co`OwRbqPO%^$?;h&P}o_01{?
zq^qlxch9=!ux+rDeBM2G%Wd`sxN=%``ArFoyw`=}({Ppo2dP8jucNl49bA-UAh3VF
zP|3$(c)IMy(?48AI(sPSRq$1aXaEz@r5vbnHo8e~_g*O>K#qlRSj^plgGhD$(a#B4
z8Jxs#6+`e*IreNMW<Y{~hYwFDByhvBKi02{>S7Hcfl*U6;FF<-65zQDb!iUkKlQ0P
z+vLrZkl$!mmNqc>0v$DC-&Mg?jKKoj0JlR!V@Dy!`L(8AO9Wkz8{rN%KYtq6QaW|k
zSHV3H-OAu|emfBV7h?~#^5b>%T2`aOEd1Lf+4!4DvOvr)PgTh}R!mpJellr)))IJM
z!5oN~*dq_HCwAB*W<<}t`td5&#c|n=F|(u>?l$fJE>M9(Qe(%)AD?eZWe1%L!kblM
zH~@}>JPv?{iXH=EV?IG#y0(G%Lsvm<m{}0uQs_S|<oSwtt!iOf2sZ%6za{Hk%((0g
zfPXH1lo#SQ&_id>d5v&IZkV|1noykhF7yqU&_d(`kKH*7fCdka=L@4Ts83M<O(zdL
zydg=ZuF|0Pn<pPYWFDrDHBOw^#o>)1pc8OQ9ujLuqW*0hEtd~w3=449hXBy1*k=gR
zD$P{BIEnub^adD0I)h;KY!DHFch|PQG6@x@cVCC`yNvsC2o|se()jQo-aEzhc(EOw
z-hV&x?s{*NM=d<ue24hHs?{gq7`{yZ7%y8%!93y`hD%Kvek}|Pe|)<{XIzwr!3lvA
zt$aCd><xZ1)u*2mX3YlE%5u1?3WPKYwXpj;ALO7XlaM{*>`ZM4H8(u?**@QNm++rx
zf>N+Tf4y5@c9ww>SK?`92NW)V)`NnuKM&Ev^X20~VnCY&3c>Tx>*2&ynmM!etLC>R
zARn7C%1G|>s?MwCvKfD{8Uzck88KuTy0YfUA_LW<qQWX48XJKFq6kRmZJ_{s-b(mW
zpGU{K7~?1h0Ll%3R1nD^s(lxH5Z{kQuZp!P3BxVs1~uTX91vT>6R~Rne|zih`lag6
zgnd*ni@|WT0-zopM6s?~17^vuCcq&x6v}|T<*QKqR_HRNSOlH&P5<3C{c$u0OsY~~
zfbWXR2m~f#-5M%TMSxETTo&+Gpy-|m16u(*$dExmW-9<s2nN0iqXUJr+uK&yGgoKB
zwi!f9BUBxr8aNGtcV8SU?g$6wqd?<eZ{WUj&r(3oU?h{-dN+L4KtqCm;EyOEoB#{b
zvGAQ`@+&}xH&4am;DIonFXQ0Rd?jkRTa&L}FCMEnzf^UQ?@+);=H34KO|A+0Y)Xl0
z&yzR&)bjD1*|%KU&xh-}xp`4L@2jp~Ha;Tnln@CS{IUU<HUvHqQJ&u)j~4f?$$13m
z83;aGY5yNdl)|N*S+jB{pnh3)?fb`o1lEr~2}-136vhFXvzsxUa6?KsF@Be;e3Au2
zti%3VuDLXw{d?xKzr@#8Ta&9}RqD7b(AY8<pfs%)DE1A<mVu6d0pa)|pn0*M1QU(z
zu$`>%(O1UIeR6oj$+@i|u+9qc^$o$bAV3-ecwlS5H(^Q0jRQx)6>D?r*TnC8r(9hl
z1@n+nK{N4K@DfrWA3)cU=pTkTLxnp7jFue>!`d)tb>jheC7b|Q2u56J4d8(FG|z`@
z8IqU~7Lis*&<z8ihXWn2kTEA^t`fJD>Kw#TydV#}1)CB0N`WLeAXEn%0s=8Outt0*
zYQP~56uj@3f<4~%!c?uvt+x<&a`Int^|y%n>JaW&PVbYBu5L+Bk2lyN_>R+D)bjOT
zb**roM)F556KHrrPAS%xiHG_A^s!oH=IyHC3s=e*Ei_?4Yc7=QAeXLc>*eOh@?Q)!
z=Zd$D1MvB40RM}|nEc^^D1rR6*_wOcy2Fo)Rr(xM#F%lpTqo7lSLT>Fa}zr+HEZzX
zd0|k{m-y#+MsS6AU_%K&cL>J(f&1kF{^~$M^t?SV!C~2)AR9&TkaD<9{#7PU&&0`}
zRC9HA+)w)Cw{PRMkogM`0@U6D51@Yia^_g4SdYhd(Bn`uE|nHBj`*EM^Yjs)lY%}v
zn5p4D>#vT|yE^KyhbAl6HMpz#*TQkhh8(BSIvVe3=H!@|;9S<m?^)GhOuyoA|KADp
z7;OnjK-OWj7#GCk&uu<h>xkofS0=J&ipQT5)_{&Hj{y6@zA~(Z(5X^jZezK+p?OKk
z6_xza=tKd36+xMfR!T|+xvQa*g#5ZZ;MkAixlN42FmMEtUN0&NEM$Bfyj22+P&&<+
z5j}7?J#blUctD4Ml7`sm&M@?GM+nicbk^s`*Z?R3^H2mf0^AVGGoD(X{2{i{y}|Zz
zviXW=*x<C)&ET$Hy0Zm)PwmbFiK3PxnwVqa`H@#M8XK5`I%?+B2-qNkif7;kSH8YG
z|G{NTe)uShDp+YXE#T=ImI3XF;!OGPg1LbL%)<QQYI%ZZ>Za)QBgawTBxF)Ur+j4W
zQ}BlrxWP=bp@0gGXunK}fPikzKuq0RcuG<;Qh?%CGXFDUIt(urC;%4G(MO(e560RY
z4JZkqRB(6FAh7HN5(qvxC@ekdN7lpBVCcz1z6mS`928K~H{LYA%fm=pXg^q_8@;}*
zTtx>Yvnyb30uzE-<O~?Za&Qgj>hv#K#4DWrb*kmA&2_Jv$I$)PRx{f=;ub5b4_cE5
z6CGdgRd1J<%fdDo_!HPcRjET&LHv?}0)XME`+0D7Kd!YmF0W_)OPkPMNXUUxWWN=p
z^0|Q}@QzoYCMBsvxx)(nUN8={ADhO!xUQ>?kYH<xp`amv217=MgQ)|6I^?*R*tl>n
zFO3wJ31RsiKrTEr7_|?}8Y;fH+6e^@s_rrgJpt%o23M5a`=FP40(y`L{CZDB{Egxo
z{OQO0!af2zdNzSI@|lY3@0=Oll!rYZ=ZmQS;xO9rfe5{#Px+u4pPU0e^vL_vT4ezb
z@encHqQ*iW{-AX8@I?d?S2zqCX?L6c_=-QLKsId|ea-y#!1MmWuxlqkG;c`HTf%!n
zT6&yd#NQmQf<lIB0jSqVXMf`3AEze!Is)(sytJOn25!v`>KNTQIERavyY8F;j|#nP
zO5#t3BcP)JDHD(p2ZsX-572Ay+GS8z@L#wVK@`j!k_;EBzhT<{@jE<?Fkor0G0{2U
z4A*IrY#Bn3+DOB&5r2aEG#NPP6H34VC<Wp4Flg83sp-Be8i_*FX@g)d5%%e@(be&q
z*Jy$CSjdb}L1G9G@$-f@ju<dbg_^0$T2v_zN0_*ux&N*Z(oWsb6l56^{lkz-o{{A>
z&EpsRW_+R{bl^WgN3r(bzO6^qcP;LQ?^V{Xo4M=cv%kb$`yBW{r~m#=#}c)O>xjkC
z@?8$owtqjL&aoZWUoBTRCK`LLtXcQ<s^W7}K+@0TmLarVo89D=&hNr=O2Q9a$nW?X
zNMgN7$u;EwA1^+yn@EOX_%P-K1@;VJ{dUK6{}*qV+^3EO{nH(XL;REf5U=Co;6*{~
z#)XtrB+k77P7ppOg_G-nGxAEKvhjA3pz*P?tRnnW!N=SCJvZ?*2!j)cp$?XJ3BMQ5
zR#~Zhk;~K%86Dmb^ccuIr2vKlf~EF}t3miqFbH0POM)-R{~54n)rR^V1O#86B5%_L
zRB9RClpGW2+d~vHDJdOJ0dzkExsZXq%C`A`Qak!mU(^CR%>n163$^d^Tm9m|X7{eW
zpZLE4Bh!9);sUvgwjy2+=+YvpKI+6p!Zvu4Jy!K)goUsYYy2?<9qL*ZlP+Ne1dmTL
z{&P)YV&Nmv7a(}q;$WgtNzibUKdEsO{};vlQHHU$jxBBV>?ptcYkb@P{vsNB)R*`#
z+JP<`p};r@*@O`tqdlGq@f<J~=I93-f+jyM4@m)<15@%7Siq}Xm?t@q6R7_!bekOu
z!B*;Hz$$@opcMv$JaD{S$CA8t&>A!ks*vB+#b*QovBp71`EWT>4uCOm)lQdRtT}Ex
zWMEthlb3)1Xl@8B8<Y{Y0RJ%{hQJuGaW4XU(9ZwC9*z3GFC{t>1RY8?C$0*-BVpgh
z=p^ZTm6G0*PQh~H);c?^M_p^{S=Hy%yxmmXz1u@Qv-B@pVirTbej|#HW7|cO`D>Xu
zCS#-d`sA`o{7k%<AH!ew<3r7(ON!W1W)nCk@9}bo360Y@ATw4D)6lhAuI0|SP8hPF
zSpcjDAi*iW5ypVv8mAo(psJ_fryK^W23iK8Tx1<L=U*&%a&w*Qm!@&Qc8AU%!gd)K
z<`bFgg!>5dq`wc&Jc@^HOb|#D83la_evMzjRDaw7utyoDo5u&<7g{CUHpj%+OtJ7F
zF9hm`!n8OEINbxLfhuF-?7@N9CQuRYKzULlJ#Yd3pTy&i8OQZc>jPhA;m1=&;HLwC
zEtTp11}@x?|KcD>@lH4Dl?(`dv8aEG1Ooft7vM*|%?{73ZL>yd?<a!(JLb@aY^;Gz
z;4qg5>-c@T{v!$exDY-A8DC97GuiYYOG|S*{6)m=M&tv1&%(Nu5-`o*%&jBW$*KMc
zW;Y8By!wDT5|&xB4J?fK59z)T=o82*%(cgSO#TD*h9CE<+yB8ur+3@`LEu>zHZs6(
z{bo;lXIkPQO7+Ol3;XW%?!EY(Qd?(zxwRYqMq9cL9ghW;8_lp!7$67kRnC3J-*V1%
z#6aPZ{$2dKu&YkohZ{Y|glsadQ#1>X0YF)2<MfIex1vT_G|14UQX-R*XOs)BN*SjK
zTyt-hACs2^Xec$p9B2?daQEE#0Qm%;AFBZm1P3+0#9~e${z?K(H)D0LtzTOD)g9J-
z;uU9G>s84o?~;@LT_srUZJ*D)>a+R#=CsziZBm^7#cM-{_5bmB2-iLBHR9=_X{BGw
zs@Gc2=kxj2Cxqu1GK8bR$*_e1`8jUK;T-2mfMcN%YqEeamy*9)`nT5E)#p|4jhmm=
zsW1xsOl`wTfw0Dkstfq44=0m6A+9epiA8|g%wzxx7w&>!8TH?DQ^(FBFd!D(17KJL
zHz9xkEE|jkmBKUvI3N+wa&dMMzQ}Z5S<uo?wgLOl3KSpz<KzYq${i75fv|^1dxQ)H
z__<5mIex0(1}Cd?<9Nu(0W2HvN9pDOIQ70yc@6)hAA1Z00Pdbf;YNY@jpKuyYN*&4
z|Lz0zwnpJZ#vbeu>x=M6*c$2t9~bsU&gV#W@;Waa!3%d_7HYug;h=gTHg?rT#<J_O
zg)c$>49p$`w@W(@6HCeduRbH-r?|$rfmL~7<)z$s>4yO^i`b~Zk?Vu+bMSYTAn!8J
z#yqO{xCZ*vIZ1V=6V=Sz53^jHpaMWV)Rz<aJO2fIaoA4R8jv!xujJkD8FyV;_^17#
z`>kw)q5<5lKzdGpgm$uIHv&ck&4A3l={?ihvZ3^KABmeghWH*B{3V9eo+F1-u~;j%
zu!8em^~nv&C;k)Z9PN$Jp9UF^1g`6!M=~Te@skskCxj;=jX3BcURsU-n{1(hx!!&*
z6Fc@gMWZy37v<+fKqET5`_HWVu35VAzOTC0xg~WU)~xS{^ZES#ed2fZudQMhE03<L
zT(GZ}wZ@XQM|}Q&Kb>=|M|7tmm#iNNaqnyp*?oaetV6%8zP9??>fawiIDm`<3b-CR
z@#EtV$iFSGN&abprV=RaUiu95*AvU>zPOF<)PIEJ2967A7?}tJaRzJk?~cF`0Zd5J
zX&wik_>x};Uh(&)uw2)TgMj`s2{AHbdRk`y0H;HYwEc&WM3ti6hyZ=*Z}j}{9j6Y4
z0K(n#+Q1S$@PGWLEB-<*=7#@N9qkN60g12Bj<{}W0F{kZN&{Tp30niOj|I3#*?>mX
zpNZ1nS4aq&!04uYUn*`&Uhlc1ic4}Io04T5Uj$k(nPQBrqkI+392gI6_{C%K90&`U
zfbS&shjIcv_Ey!nJs=`>x69#y2ScttX8p$OFt+GF?!01tv_2ukfXcSzzB&{}>u@92
zwOo(;ucO4T%lHWIT_*3(T+!f1dkh2twZc1RO1n)nh6JFUNjviDm&f?ax(Gg`Z~`_6
z7uPmDkKm?o0B%jI2;?kLt=LV%T>_u@tNQQ8vF5#4HO=88IB$M54g=z|eo4w3_tBk8
z53x>{t$l0ex+&}C?WT_IyXl|#ynTE|J$Jv?>si-2;uYuf`TYKU=hh?7=kx9?Z?zwJ
z{QiCC^YL8XIB4?P901tAENo3so2?Jd>p!1ZjptSMm%<c=%?1&12F)i9E=_Gg`62f|
z{8e?Ni1J(#ZAu_Bj~6&hp#XWohXes124o0d#p0^2@g-nz0{_eOJ|1}L1;8o&0bd{k
zH?P<4_<U-Yjbjn;0e9M8==;XTrLE32Rqx=}HWBx70VC4`_o`du$Bx6v1RGk(?ScPr
zBx`5=c5*&|`ft}jKEAy-6`RK}y8a>r4dN?|(S+_6k^sJ{gTt8j0jD2=juHP8`vY5e
z7lJ(=?pniYHtce^{it{_A!xK2e=ht?KY=b@lJ5FVa0JSfLH+z=Gj~(^@QsEXMd(OD
ztKmKOa(=e?K>*wGL-!*9ZU7Frtp^}9aAMa2FE1CXUPTL%PuC=bXIy`V_9PTGgJ~E)
z5A#z^zrQ;RtyfylyX#rkKE6xZ`L8ru@=v)l>sjAFpTv3m{(nF9wtqjL&;4p%6PBJx
zXh$zwXT|69^mot2a987DxWuv0zinIh&C`E*1O_lPNOxKHT$zGvNpndH59Zhmz~r!Z
zypjc6vA`d}U!IZ22ZTNV25d;2KKPi%;-F*T04)Fj&<)=;69*gzA060$NZ$eeAPVin
zju)B{x9|OOU*KRP-)f!r)FQqH4(>ud{06zGfMX^Jm;?EO6QEuRu$#J|CsSYMXS2Ep
znVVu>V4wf~e~89#OW`92KsYKN{d`mhZMx2b3G5Kc(f^CV9Nl1q=omb`bwCr|7xzD4
zbPW*cl2W?68$pngkQAhm5(x*ROG-ex5$TWy>26ROB}PkbgbWzlv(NYUJikBo&-T~u
zx%b?A&Uv5L;dUoYaNRlWejnIu3Zjv^q&dS(6e84B4aN^{ijOVs`FWGsA%lbUD%e^2
z^?(r}BlGb5-X`=pfmHk^X((1bQyob9XL6WE>UZ1~0$K$fbpRo$5=(45g4pgCa~L@e
z`SwXENRX2^@~Em|n>Y$zi8t~oy#rkYE$1A0yAQvPs(vINp8BlE%Q^sg5$)e$ujs%N
z+Q7GWY^{7*WEUI3p?MLS>-m4etqvCbxfe;f&6hC-_}{+&&k_fh=hVv_n`zyi+qWX;
z_v@&ZLQJ8x>Gq~@rUQx8C(~sQni7%vd<Ui7;<IEYwiQvdwt2ve42p?fDm}TYvpQJ@
zHl|qoW)myozI{qBkqS!>F(wvbHB$P3soE2;V@G}CQ#Yc;&IGUAlC}#HXp`pSJTcg6
zhJ`l1ZQBt^ailF<WT4zLNG9^fGnI_^fpjWx0kpol!mkSzZtNzL+<8;!^kMpSS?C4h
z*&pS}2?W~E|6c@IyD#?R-bO}J+!&D9B*ITh&Joxd{F1}VrOZD-;x7NCIm8Nn2OcrX
zCCy`tg_Fl3HQ0wjSbt2oat`V?t8U9_#v+vi2LHBEWMzT`D^;+U8Re)zf`fI|-86!@
zCVxOssRnmFY=(r-U4TnoxgXH>PY4Ff5Z7tOkk8UcFZkW4!lM+u(4-XBFP*A6bYGA$
z#3iACA{q-D$<Zj=OPj-oWhJ|%LNP{k5^;|ROm+y@TQez?u=YsK8B!+mED15Tg=6yL
zi~#R?7V(x=U*FOsOrzYntMSswEHo5FHKMBh`I*GTx9a!<3_6Paks{T^a220phxoSu
zYf#mXj1D#2%PQBX{g(R3olw#h5Kz)W={GOELX9dyW#)M6Q#D3iX5=dPzc<Q%XYT)*
z``9?-onG~^S@M71U<{2h{sqhI_~6o1RfMw=!}AyU#vFma(2*5d_TThL2n|UjF8t0j
zrJ6hM+9qvd>B-)S54I*SC1;e;J~KRe!)j%cQ;H_^b)!a7?EwHuL_Fq^u|$T;rUO)2
zHAPs-*y8=T;gZn=FJfG~*i$aUWUV8_Q(ocB&?Mbl$X@|i-hDY$sEr0-!BlbLH&iNw
zXlYQDB!3KVy9lnsP~?eypX)2Ku1~L4b`eF&HFjZPP85E%V2O-~B0cS<+q=i88H7H7
zAbAmDgC3CQH~7ZYi`lUMIT#c-9GEQW31ZlXsY4g@)c(j%1pqAv5D8D-^*x-R2naVv
z735iZp!0bDg}1$Z>b=%-K`51vzhUYFa(z*z+|#$?H}4R<cUV}-M~XCUk|}hjKb^2+
z@$PlB!15Sjy!*lNRz}OBnH79BqO#^u6;|=~XR>ds2=?Z1HJJ}bTb(WGFWpDKTzlrs
z+oa`;en#jk4~X(&&^O1&3YXP0b>Ah&cV{Iueim;uVJ@HlXP*22?@amy-rh?0Vh-T{
z`{jZqH)B*0lgsbXl}X#g=pDcpl?;%J54ktCqA6K+5G$MGP2w>%XR?<UAzy!$p@%F1
zSo%xE{2^2|kAC2RuDZ(<Wr(2k*e)uv%BiQy&=nsAS!E2H>uCS{@I|G^Uv!<)`R?bN
zdNORL_Wj9e014ytpQOG66ag#yW^Qlf>yPn&I;RG30J(m>RYM!NjZQC6z4By2gAz{=
zTo<;->eciA_b(ulho~e>-tbaT4BjT50rj0`GVr-tarcc0ELHTkJj{1+Aa9cGj^Y^Y
zOHe)`ib>}$SZ;#|o&@=tCM!FK>Dh_aWt5QBOGen#*0ZC254_TP(xXV{fgXmJ=6u%B
zEW6vYbiArgn==||ABz<j-A3A)za&^$DtSk&c^u#N6^zt?Qxae2+w^nNL3;;YFICVh
z3jFk8$ut>GtJ>d-OF(d>hZ|_%RlHIE-)rsvKLHp|XO3}pO@8+0CT9A87}J>bdL#=P
zQzrbMWlm5b?QEAf@kf6V_9pMfw!Un82OK~mrD{7Re)e0+l3zr?-_y~mH_#2gHYBuG
zVDZo={m`ctl&gQ{ENg<Mx!WSR+@;bGH@UfsTf>#^W9i(nYC!Rhs!cJ~B$0BAfgLy7
z3F))wn<WI*2Y&DB5;6YY)w~{ub|}IrmV4o!dN-4CGLPVlrlH|)qs)d}`_~vuk^K9X
z>Fu>!HhlMdGILQ7B8}1AGf73L7Cytd_Cs4t+lLg(iwQ9S+{^?7`=8`V*|F||-&1FZ
zXQiR7@jw|?F2?SI{UHYB%d;L5$+F_)1h?GYTi-nt@6)dVMXp#P>SzA~v^E7&!9YCj
z)J{ciHc`z<Bd6n6Y#}_VaG}yDMt$G$I;wOP2`a7Rug(7dT_YH$^1n5^TY?<hn8xld
zCU1LAN4T~^j%kK}=4S||ArguceBai)4KV2r^(TyxfPM?cRV}5p-pXw*?m`*f&kX-?
zd&;OONORj{_~OzduMJx8f#SO6edc*2-`lrMAMozQV4qj#-YF3^gmzIM+sp8${ZdNG
zfW*UFu3}h>6`33W0~d(bhaZivx=~!b^~!qkUlq3iStpt4TbXpw&LH+B++!KWHfRqq
z&+GvfgZcf_Y`TP(HdNTrzCDm5G|-1YIQ8-b_2?y@ja8B?s<iLLx4U{YqK>GYZk4e-
zlx9rPO4n&@Ut`0Y{I7T9>&@*V-K(^~(lL||o(hbzsSF3;Q<dt8D+7priR+xjKmyh<
zq|C&b9Fz^Seau2WPr^1>hvR{}#u&W{C^K=%pigABvHXFeXmFI!VvrIk4yCh=z<O!S
z^OX}S3n(r#T*F=&8Nh;>l+fWn=fa5=<UFy*?!B2^W>G^=?zm@f?p+EWo3*?e;>~#S
zd<kO#G#Bj}BoY}Uupagelk4aR65aWqa0s)b6n*PiboUi+#AUbAq-=E%3WT-Ky*rAx
zA_F?VMhLO7{p)QXe>;3>A3+Y-q_ZriS|QLFT~%8f0L(EYN(55Dnvr48ae-TXwq&G$
zOv(g|#|>vE0RW1ORi8uvlezanwd44==U7*Yy$atzHZel!(6NY?&%-E2>RIwB#4EYJ
zkkXmtJwFrpu0CF#vQ!K#`Vr)|`FHM%E|qOX0{R(|Cys39v9b>zk2knwCu3=1n3jvw
zY+!BS^5us#fp(|OOP_UZR1*Ind4Hx}m<<LYvWrD+;<vsWo{mk&P`~CDh0`V$f@oI4
zZq!=FW5(v*A&}i6+~k8^ce;*x2K&7UmPm?#G-~6?9jT8&6f(_!aK|3;m{)~LID>Kh
zYCk{R!Z)Fn27{#r&YkE1#zJETrYD(5QBG1OwGqfb{2&^Iz1s8WsK>&?`RKB0h_|QZ
z*`{KwO`6Dago-yVl{!V+8+Q=XYLUs%Nc6cPQ~nz5XBTw!GEk;!(MvrsXjjjha=P^D
zvgbdK(uIr(+OLFcrCPXqMy{jb1;{*ZwFfe_PmwNPcyMf!=GBBRV~`Z5lq@ztBi#9X
zL2x4p2#Jj(9&)i!c*WJ>pw#>X6BrhyO7#b2>%P?Q<iJzLg6&r>GszF4KhEF$QiR#)
z-VH0QfM65e$!o%cnkb9<t<sSgU@m2+<RlXj3ufWjlA~Is)#toc<&7O`l+j0MCWjg2
zcTxgGc*n|{;RL|WTOd-L4YpI|d=P=h@t7`Sn(uYwK@jr^Ja;C|W21D4&YCC<)dK4#
z==1r9%~X%)z4mSk!5x|03Nczf&zn*Skmtx6kr0M`+t=<uzP{gft*YuMVik?EL{Xv9
z{WNaowgEF&>|IJ6@OfWEm}Fxl_GjH%U8SA;5T23Mtf>;O8UG%_Vk*;m$4|R9^+N4u
zPqR;~D4ig2tsg5LOOLoa@oamZ*L`!9W$zgqycXjI!wjl^kI6>CH{_f(gP!SxW4ZEa
z0CDdB=DJ!bsl&TuzlC~dXmx$dHaO^ZDTKgOL&vOaX@cSH6Ey8Ds--{T&Ml03ATrAo
zwsvLzNLZVNel}>Fye>&#qo`}a1okn0f)Wa|7Dt-`)s`L2jnTfh%g~DTOl*AR{s<Xs
z7DS%;7c;F`S`wC2I@JIdXHp+~+o*PdcJ`B4T4HjbtTND6sb~}92Ujf&Zt%zZ^>BjE
z@E*%`v<Pa58{FuV%^fJDp2b*0v><~AD9|*mx9(?&!Ms23yJ~hX+X<Q5Z#sKsZc$Iz
zExMd1DIwdfQLjQZ@n}{zl5Q6s2qAGJY0MJA2axFEBgYQm+kdJzbn@ZeXwj&65S~)7
z+?Yr5?oas{G&LaC{7DF0cXpe*Q({k^5iOIz*JiX4A>fHd;x^ey4)z2m)0;^SliH2a
zp4;-<N6|tx(Leqk7j((5p<`1b$C%8RE3wjV2CZdt{+l$_j)-34_26ZexoL{6UgpZ#
zluRYCsg$jqPV0ey>N+HVBOm0xSUw>3@qL!s_0c=>w*fj#-;y~L=*~UN_t6J+qMJQD
z<zvU|zi(UZRdj-HJKC${ekM+%N&j?m(bMlZB_kiN__IxaYebj|10B?q+-YIXkI2nk
z&Cy%AM7Fdm0grX!P=Zk(MDr_zmJ1K9P0&cnfPZS9;ly-yO1pf;lP-BXR*n#Xdno^@
z&uBlnMA6e8F46aC>i8)uVEo3O=UsDwoOS+)ztjQh13qCU??`qWr7~}y&C*8{Mykl|
za_4=FXi#w`qB;^UL<2kAz3f!P>246N{i*aw6GYaN1R^PFRV>^PTv~hblJmpV$oE7&
zVwYQNDSg`537kc=AAoUB>7G1YAQq+!A1PFzi$POJFoGnQ!|;pS5dwdgC+0#&qp6`0
z^`LIcYk0Q*CXxSBmA-8G0$ClEM@NqNx_<(n(lx>K`*pLMFrRL(R#_9uY^4*EZ#0vH
zcKIlpw83Ffj=5P5BO`}TCl#x>zaxim5z5(?C4>dsGrdBg6SteNp5*I_a^*gH;;Yit
zrI<;2IEmuq)ddeMqeJ+R4m704wT2_DVLX7_ANrFfZUnc*?1|q@*K=fki<L#^+VEW(
zRsM0#QqS{Rd+kLQlWG5D?zB>PSJsSlXE~;d8UP(_aFCm}Z3lDi+gr1t1^l=Szl)yT
ze-B#Fq?XeC(1kA#G3#My6n40#`K&lX310NF;W-CVY<U?2qz4{h^GPqgrR0$?LbBPg
ztYZy2Kg~IYn!(=MvXbDFRPnkMxmuKaBCX@tndTfbV*)?nr*4pj;&<b$;TW<N1vS~S
zHMPwmK_+2ozLC1A!KZ-rdiB?a>?l?$ty<wyC9JXd9v`v7GqeN+W1Oz+XnP`34_()7
zruNv59g{=U#cc{LOK`ut{*B&h_Z1+;p115B@RSX7VbzJmw}QZhj>z=WBiKmA`@wfv
z?*#M-0(Cm?^W>u3VmNf@@UfOJ-go^>9TD6rQLyC7de;q+i&k>$p@?~-och8`$=MN`
zP32c984$-*=myVWQeiiukqY54G5qDr=358k&D_kDWVg2rF45Q7L@p;t)Q(to!q@DI
zZzVZ*3>)L~H>|cIDhM}v{l3g|KB+MAM+-(adc;FSeVJE-;dQF+?3<dsQ1XRP`+g)b
zwx(9npXedqzfA>%+z-c*$5s`6gc$UIWixVv(K0!@-XvbGutjqMBGX<#xu3RUnuX?c
z`!xSa_Q9f~rBbS3-(+@j$WOib7bToA%jNud<;5nN?tFUs7adaw@{Cu3aq3Cv(6r5@
zHQ6|1AYjk^5z`NZ-m1dd0aV7leA<X&+R;CR@Z{BucI``j*lR|X_fPRflFuVu(?~}m
zWbumx-xm&iZctmcru`P_owbq1)~-Ow=3p<ri>%*q+^?<%y{N^c^uZK<rm&X;?nX~<
zLSyS5C*@{c2u4X}Z{;l$S)oV=xtGbeK6&(UTq?F}s#EGP+ulvR*-@}`nqifBj}HfA
zAkV<}TjBZy(%?;e1UdYb;}nz7bT|7XeBsBCDK*QZded}P+LZ=zjRN-V57Nttp?fa@
zap=Ms#ncEuSRGMS?=)1w2U~;O9jZuS9m~9Td|Zq72ZzDJ{BnTiU5JUl(BJ&&9y85%
zy63R&gjX@N-+IPjoqId^JzO9dq;*k(j6g!J&JSTx#xWZC(rDN|>J16gFWna4EO}`?
zq5yQj+B_v0W{8;1y|l1AusCBJLRmYngd$f|^xQw><@HDxX6CFG2Q7tgr_s;W3Ao+3
z?X<Y@X!<;{-rwrcMg^D~>-6sJR{KK4rYsOTBP_W|@%sGVi|g?syYe`neUlFzi;~Nu
z_Oz$RrNqZLr8BGn$9trx4h=JTk=;hOM%evV5n6J@%Gh9$oHH4AI3pb^saB*=e=xq%
zxD0jgZ2T(%QPo0t8vxhr*H^}Gi45E3xE^JEwk)GzxDmux3xnE?obj_H<p#%5r_shE
zYh`W!7Jo|ay?G^90J)BnAlnG4bC0*()Tc0XUoKj$H4fT253bhzbs=5NtmQ8N_i=e6
zjiM}|SbWv4aW_U2yGDTT^3;cbd@DIN958ExYf!Ys1m|qpW#S`KoMLm9Jp=R3C=0wD
zIDnAom2Y!y*MHmye`gN4-)Kix?++HZ{jL9&uX_N=q%Sj(>na?Qu{`h}ntMVejY;!_
zK(=kgaNmwIZTDI4%k}q}P>AAVy?2-$e1s>a@RB9ceAn+clNdUxO-Q-qzO{5TF<=F~
zi1H{$yfN5k`+TsDH&UBE*C)7)y5(4ve(!sb8B^e#jeE3;(cVKcgKk?Y^=Bs+v!!$-
zf45z{eyf&z0Db2?4FOZGP`%9Ju6wv#67~8!k67Q7-KN>Q810A9Q*}qnZ7oH_M>Piv
z(wJc0VFQWyLjATB4Jv-5dOJ%`&^vG|x@x6>L$(*kNRN6Jay&BX!|XVfK=KgQ8ka_f
z)XiGA&kI9d+Nhp(?pD-V`k=G%$Z5N3z-P1SHu`eQY@6rJqmjIGZZEI@7KFX3YOm!N
z$;f8v8n0uVq06j?|1O|N(`Hc|?@i7;J1-oD0HsKVX^ys%D1}1e!(N8e(TzmT+UR(g
zaeo)!Qb+iK{^2Ng)|Uqz)F;n>q+~jd`nxdpcpQsy#{%JUgUl<T=o3QB29`A5?QHiw
zwA2#>e~jB!j4KxmJ$1=Z7cE4LNfDQFz45}m1VCiyW?Oz*#yJw#Y2U6U<HlUBkTV|!
z&ZCLVwdiH>=&Ma6WgwQEZ}Xo6y86)6t;P4qKtbs56?0N{Al)qU79n2F2th=D9|ZP5
zztC6iG8Zs6xEMQ1)EO>_X=U8^U)kG6pVKmGDk7fkEzdC#q$mW~_lw*3P?SB(`YL;{
z2W6h#(USi;#tznqO#QACYuxqcFXOtUT6^ygm&@B*1n-dyE){MyX1o_JhH*|hlD|b`
zxK4-1GNc3Er2selDsQ~5f`Y#!t}*=e;t$<Ru^pj8kFJbNZ&-BdBkXzbq{P<lWt{X1
zGh^P8YJ`rI&fzl69%?07=?b+P_trgGaqB)zSv?&nu`IBtW6WCoV*mC7!!atT{`_v|
z9l+KeVB9rq!iH1v%K=;SJ-MyvG=A3gA_Li_(r8!&EEkRLGbts9Y=4Kz^gSh|mbpmL
z4u>_{j<^o<IeaWI>Zj7_>rL8RCQ`+qM~h3VmN64eS?n)lfM!2TsS~j|KyqX_zl?1J
zqby(bt5)0LQxKva(7UtSy+HrWbxY%-2q~MG6s*qeVyd`HFC3+3rU)HEGoIN=K`L77
zzEX|5f8zb`WhsW|=;-#kO{qU_T=~~g?y)8$<L7Ip<tjYhF>1h@pN4Es&!fYo70=Uh
z-7<jJ!sp95r&X8#;f*9M;j4~>CVp!iAk9tu674KxnIcvCct4<PmF+w{h!l$+w3xBe
z?>?%R*Z&y%Sz!Flz$HsXAgNL@ZdhXkBY-+!E|_dq84^{)lez<6TsBsIi;g)R^VI~u
z!Kn%t_!-4g_gc0{eCWVDod}HlA%(zhFRXRK7`2__sP<`F$jtfv#Bja1>9upj<%Qi_
zQKVIZSfxc^Ik-A}tv1a8qzL|#RVq~-G&ju))8}a|RPH+<A+<%E`4C35Fbgc;#Y<WA
z83_VS);EDhMxD1$slOsAW?cJ|$>NOmcD_vz<Wab2k$P|C7CGiW{vht0A;hOQ=2K9(
zJ0^?$43WCx#TtlZ9Vo>!&B#2tNPhT+MO$(u!ho$ggsj)xl(S1FtP~N?WjYsQf5mV<
z5~c!yJ{xF-5AyU=9DIkzd7~-lUAOvo-VkE>_cMYqyt}f{iNYalO9#eYae0`P`&SWc
zU=$Y{tKBiQ8pHKu?x9_`wTk@nxCd33O2-CGjvJhAutXf$d1;f*^J?m@-jOKo<Uno^
zvjko*|4z`DaK|Ee=lM}L3$utCvdl!B4IIxnhj230<$~u%#c9<nxQhWMErUR43G0+#
zQo2&3kOGeL#P)+XTiCy(E>fL-8-?EI@>ZnIWvg(j-|unk=~R|ExV^2>$JDSt5x>;F
z7Hu0~GHc)mAN>;ub>i2PQep*by_MeTpNpH^UlR0>R^bCHfAU{p0t9RK__CPzLg(Z9
z)UlympaR_i=#frR0Ti7k736e#M5nhC9RTUEir@b$e%@RTwM=+%tZJm38lRq0AH&Ck
zX>L?Q(HUL%8n)e705)WH7th1p&p+Bq)#p%~1R)8k;>?freayS=Ws!QXe&r~0DH2+C
z0gpFXNK1aj<|Z=xe=rWf7j@c}^)PjXf8bL_B@LJ?qAavz@BaBA^u+ZV!$G@Y##Hp0
z@Su3sQ$t3OAk7~&*pyo4_94*(>zrdb^r;VSB7bpWP|u0z=r*=d{ZFP7oLiwaV$Vwp
z<zMiC4>mag9gkSJ0^9rhv$yY3GqAXfU?U$#BXN~jSFi6pqE<uLOX&jfo)r`-!twzr
z9M5sz;OXBsZbBKc#-R)Fmwlh6SGx6AH+MwNm@j^^agnjdiaOy`a49%3-=RKjH*lYo
zo)0n@rrP3CPDQzeN)=`x(ZI~b*|??BvhwMHp5S^a65hS|USww8^rnPo4-wyNa9CoV
z%Rl~y!n!&zr&UjgV47ae<EoVexg3h+{~C!tD#q>}&1M9j{}5x+@O>@T8?a4}AG<#>
z)p)s-ASzpk<h4@;ee97VP-l<}G`b#Sz#-$l_RcShpy#Fa)I5&)KF~xOLB9p-qta@8
z{5-)S!ekQ)VJA;vu(pTJUkNUHMbmZ2{@VOmlJR%C`euKKP1-_BrppIy*o{G^(IpEO
zbqUdacoZx`bMI#ZpV8Iicgy!hL{;R&E&7R-e8N_Rm$z+X7j)Hb4?YOJIu6%own2P?
zGTZFk_)8LO(2|Ix2^e`Lr}gC{C(&p{nDVpLT?OmF!gc%|qmodSvK;BZ>&=CUiP{pO
z_$4+`iKKBpXmH1MW<R&q`}c!AT$8dM3;AvXQsJgU4&6Ces=^Ln(5Ys`PSxm%Dj;fx
zHP1gE<zDlAG<9W{8=-I2;u<|WJ<Wj&m3?jgVfJ8ezgAlP?NIQW`v(uF%S*KvnJDcY
zi`|Mr!M(JAI+n4GfrJPZI}lRhIo6Vd>vSpkeUSr*mnMdNFec2HKL~MadSWeTc;S72
zF46w9L3lajpLa7RkkT|AGIPzrF@sGuDtl=+k8yafVFFwdFJ=x<fDhp*1?DVV$48FH
z9IH4&5>D9q-{QFcE&BvN)m&5lA+VN&ZEHKf!tusH&H!8DryC(AV`){rZUfDDCgLT<
zh5Ui7?xt9XQK_bmEdS@ZDL%BcN1^;ux%LQ0qRx;0`9Vnu%%xsS^xFuL0a3e~QNs1#
z2XvRbLwX(;vEv++J_IOZeM-ISqu_Pk>l<rVvv?T!Wq-L8md^ZD2|cvPzj-kyT&8~8
z#&4X6Vr(!Zr?(n;+rqLfaEH)OduC$3j!@lQ-Nd*Qp$bA1F;lzUl0~>_eK|cj3*l1w
zH=~CcP^V(*bqX@CwW{X@uXXLUXYO!FxAb-F21Jn?nErP)*!8yBT<?gzhw=H72u(P#
z3Opz?_e;84HCWnSI*#<^dRLX=U=BM$lPLx<{n~{@EbMrUm0c;d2G4*vl9&NSvq#7{
z$GW<C^V0!n32uK&Km%O~=Btvy{suy9t=>Dh`n}1rbm2zoT`l(A|I!zFylkQLZ$Db&
z*wVz)_-Svha2p!d9QN-;*u$FNbLuX7uLlix=qtfg&`I*XVl12)oX=9j22%&~6MjU5
zzJ|852Zydw_z!h`R}5Fsf4DH}`a`u-OraL1^h;v}KR?+O3L%=KWhGESW2vvm*|lji
z{dR<xD8d_(U9tSUaONhGo!^TeNen5d9%E&Pjr<G%N1%96OpQEIp_X&mCWo|+7GoO#
z9Ob^ueIt5h#55pZ9ynO2MbFA=Uoux5dK{_Ho{)YtM|a*&TH}A;XbWwH3(DJ7&M8M-
zqfHUdS1m%1HG+!rIQQ0E5jtfbnUD)4U+Ifi8!?ctv~F3Qw5k+LV86s><<}bQba`<z
zF@#)Pz(C@kX0wH2y*-Gj*j)zxC~|k<T~U1ppvXP@QI90%GTdzASBToahP^J=tD7gs
zJgFo7z+OsSSwbl1IahB?nn-F+3artqwP0&uy#v)jQG91g`u@{Po3gsdCgH4T@J@Mc
zTeQF#LcWv-_g)S4C>tlZ+Zk!|U|H*l*m|>h9$uq;8kh`MmfBbBkE#{~k`v}hlg&nF
zJCF9T=KZhI3uk6eqktRTY*GIm%=mW<^jBicI|$lo{KcRR#qj-#Kj01RAJP!2u-_^2
zF>vYqr2OL#@UAW5`?Vmb{ZS{f%urc_sloeiydY5IEl&9-s7&P~V&xrD!>2JC7r(NX
zf}Q@ZKBpQ{=U&8AvI8AMuvWnb&3?Y_y$mctRCa%(Ki*2#6ld=2Isj`DFl_`M?A$F+
zzxMIH$3Pj;vupwBPKP#C&|HJ;M}3Qw37G4XTi)?GL;fg=at4Ga#~Pb?0f+KpT9xg<
zqGl_*Md_v7hcxFgLK6%YIJE&;vxo=2A}#_FeN~@)fEHB{ivAW?TP}=s(t*C!LU`c&
zBAV(p^ak7Uj(m2x<-WdsohG^=yW0B69g?v7XcK0Xvr=#Nq8G=n;OyK*newJx{fB17
z)c-9(UHBSMrL%OYrU<?Jpx-ZV;>Gq)z9?#R?~vsjL{%gjsj1vr3XmjIJ>=ToLsMsw
z60{owYeWat*TEixzZKWb`qBG+>`Ond)gP0{qcZ=%=h#olVa!5OiXL#b7MRcXJl9H8
zIqW?A2#*JmE?hEsF!-B}7rm9iV&$WKfFxMFhvqy3fwr^7e7RAs%X@H$*n25*D=&3=
zs`E*x?1&okx6P%myS2x0b7j^HpQXvFk5<vSCCnXr%{@=^b|=^|&7YS?_Q#3}6uB8o
z73lF?lxxZOu%n6Y6eRlSH{ICq;P^U9j~L<7Mf<@wZCFn<I&=9rx41qt4QUcvr7>wO
zQ%_MiJ2`93C5obI4qJ~PyAnY<IPlcF7jXz>1Q9rgR5Hn=*fP}s%dxShk&?C?d9>dR
zjbV8r$sMK$9t7ajYF*~ESm!*4f?-G2YWm}b5ZaL9vflMw?+s>x+3mbpFXeywc@ht}
z#^Dh2urG=Mh69kg?~WmzpD!G^X!@@}e|zgqv)p5L-f8p(-`Suas7k|)R6^pz4qZt!
zYgD0!;Os!*4HVNCo5T|UPhXK3qYTk`NN;3Fg9M~7&-wU(L<Ec;3HaNLE$@MUvP(OI
z=KNUD*T;3-mWFNxM76QpYKZe-6@|!22E3W_3Wwh;Hy@Mfop_a^uic=9{Ir9#yqGEI
zj`<PfMNDe^Fl{BVkuduS?#S!+Z;|Df*Bf8HvRzi{Y6TCo%+8Jr9-e&#)p4iMfwR`F
z8D_rVI6Q&wo}s~wPH+k4581)wTRq~wCwLWa;|tRCQM#oRKS`U;k2fhsbz&Go-KD_=
zS^;b+szG$W_mfHSL32#xgTJ+sK*Zl7!~sGT*kR-mzhc;MIMh`;FeMIA=z?sXJVA>s
z@gXVH@9u5(KbDvlHSZ0aPYCOUZn=X;UY1Npy-+e*KA~Sky2IT7T8r~vAqT?@N+D_R
zoS8!O;~vDrq6^Vrmk=|s=M-IL7qhO*^_Vbw=yCPf{~(OWrkDJe%+`cb-jpml!vUIu
zO&sK5iXeiu8rh{V@_thBCiLQTE=E}*;7yyn(?uya>&ykeuNdq_EN>yH_AM!efF2e%
zx5we65ur~fukav@axq7ga)dKu<|Je&)%!!TF1dkT=x>!<tnYImyD6TAsd4{r5wBm>
zj3r*ru9i!Zy?G*&n_^dr<_qvvdiT7Uf;hI;-2so|yX*kf`7i6Lq&kDnMQ^#)y`RBL
zy`%@vw0$`rcX^7xFZZX4d`na7^m=dl0;Zjw{}GBAF`{xPqK;?}lx_Le3zggDza4vq
z&=k9qPNXm}>_;laN8T=_BGpQXz9)~XG5J+NYgQYem6^AqKrCS^zsda)W-TQ;*whtE
zr|Q*nE>ZNR2|QIP!jUe}qf{oL(Ds$o$_i3?hrl4f$6RrzU2kw)N~ws+9ghr9K^puL
zubn%AD<>tn>OD3sre#|(((`B+a&P_U+Ml4Kw?2aw5~RQG>G31<>Mt;8Bb}9%Mm2@t
zFC&kPQ;DSy?wa1n&>~VTPp|Lglcin)A#}7M)M1ETK64XDODP}L(#N?%NdoP&!w0MC
zG=56t5;8>fO0jC_LpmR>k>?oH>6c^Z?>;>JYc~{<0Wv0Uwez)ztnmS>sR*muCx;3R
z{a!)TD(X>qe0rhta43W#;axA$c}x!%`cv|^(x}2^<q~EhG55qi0!!1Y)GnPehfxhc
zr$701>>+<6_`z-aeWk!^pa=I*Dh9!TC0IjVDM0wNEYq_cN<__t%z~E2#v%(`Md9F1
zlQ_TF_3KJR&);{;kuB9FNYKP*Fbhz)86##-uF<?SYVNW6b?cuH?=&vR04iK}aME%U
z1pXO|SGHpO3lBEpIzq&=cby)44oGMd(_E-zM)KiG+3H1kJ(1$VW}z13Me>JLjIkov
zN_37BsaI{lkebQs&-FW5v~oDn@0C7r=p2%@IZIML+W7qgvb={BY1zmxT<O<-qoGRN
zf-UZO61fU{TvL3hNmu>T%V)Tf18;P@wqJo_CE;20#pZ#SulY3N@(@*w?PcF%65d~6
zE;Le(BL+q6rQY6OJehBfCDDMlrFrQp*dRUHO+#;kp3YmqirqZaC{G%6TWiK%<v%3u
z)F*$ZBJafr^5PFsxyqVpqg~WWTc!@f@h+R4zT(`Z;Pz0YaY$1Q`y5fjXF&vh#Wa;5
zHGZHJNp_td(sEs+aU32eT3c-@G5>H9*Qsy`735|<wt!AP4_j)|Kk&N@n6{=^s`+f1
zc#pVM1q$scRhsZvFh&fk@11F6c9mcoU@i0Ooavond{j_rXO>EhO6P9QbPxsuQrBYH
zxf-DF(Y%C~cpq05nanq3X}W(=*CF@avSY{T%<(th8H#>oU+udTWGjY81E;5sstCF}
z++at0^%ePf#|@A`dK_M1cfA}8`}ppRjsC|}vZb3$arSx;<lG;y_M=p`;bXZC+qHsc
zQ{h%JjFX}H{Ahty&{Cf8kH;GXbKFzl*en)$G8Cg>;Ilc|q{G7t9}O#pt+(s{z`1LB
zit@hOVLZdutdkSs4*h(b3_+7ps%{Eq#z-BWvbN%_lPHGX|3k`psxwZtQ^0~$B>F50
zFv?!Jm);F+kFNiXD7VV{`osf-s~*UEtz{F!oPpN$4>AFO;Je=W+vG%pGzoDtS^`hO
z`MYbWUteA!cT7|uGbCNtJn!G?FB3ecv!#V*sj@26u;xbn2I3;AS4zvLUuNU?hYAes
zyft0^LklbD2o#g9z_g8D-d@LUju-qD;Bxg~Mk3P)yna#4hQ|$H$432qlA(Z+F?FI3
zDpt=&CltBGO@nv8Ddy(vDfHClU)K3SI9tmW`~#O2Ej1F4tIpYt3b_<t&_jus+kX(e
z*-l|E{u=&zD_$$)ZgMx*JcOz(!@15}?N|Xt@RSM|8WW1e|C^1Ab@7csA(DTQoLLOV
z!Tz&vLiB+F>hTzei{zDBx(UpF!8QW7q8~kwM&cx<%;<5~k+Je2y9PU=f?rE8>M2Q|
znzrZdtPtlRMAG))I@{v2Dt6Q+@bS%~w{x;i&s<ZRqUZ7)qe7TBBP6gM+%Cv#TuwoD
zOlFUUi{z{HZ-2`c4b=2lfR2OT+dK8bG+iyXB=z7VyFc&avfGsNM@)vms@+bLS3eN3
zO3ybxnx0ke1jPKlY@rZDkUNfr%v=ki+Miz@CashUHk8w{3kwTi+kgYYbiejq(hJv&
zB)G%|3RA}p1w<iO*H{5m?x+rxEtTbeA`#echdD#ZA&E#XufC@t)D22n|2*Mz!2OR0
zo4cb+6p-Z+omz_PY2_G7dMxH{?h}G@WW@ur%OCK`AOHLpXkse#rVHTs?@Ib%cqFph
zyG%9+M~J)w|7L-fE!fJEQZq%ag@F?D?4s)jG-TkXML!3P73Qj?x#jf#)>-bMP8Vmv
zoea<YL+dD#)assQBS9hM8&(u{eS0(oQ5x`9+<qeAA9zz}Bk4OiE)rq1?V#{1ExLq5
zq?i$iYfQhZj{^ODX_r$jz-E#(0;k7UIF3BYqVqEyleMLh>ONL@HuO&QN1`l7uf4=R
z1mTkGnYmf=>^jUT1^--qx&{)%-zuS!Vy|}?Wo0GikLw(U*^MZjZnqvhY4u2=?%nym
zV3^?*Ry6SxF|Z;GdrIuPnFPQ?it<=cnXtZ@at2Y4Lv}>GKLF>_B&}nxZ3~|Ecf5PK
z#d<fWnOkJveS{`LOey@3%_9lPEWi8#I@n@5UIyL$86P1uHWP%Ew@GS=hL4c0NH2Rx
zqfc=*&UU3eZk0{Lm~91h44Cq@<N<`AcD6`7{gV`@sZZA1P(^@2-G$L~iLXCU1d{#~
zrw@CQ?)j(y4^N7o;4pBIAXW+n!_cR7-3x?+1BB`a^pP4+cG6o8D=*G~-xaxm?UMIU
z7GS}-nXUF+SV-GYauPte<z9dNV+i`l<er2yW}A~VlxOjfT(77by!`?hhM%=)_zJ%d
zMYtOof{&#g@ez3gC68gL)B1%T_&Mig3K%}fNlXJ7RH{@+!QUz8sX6sW#vUnB$7o61
zh6t&xLtfQsll;J8S0He|^6(%1CCU&b(6=80wcNBaEtrJt1XX^I_}swo8t4@!^o&?{
z(7S%*wv#0>IW^<)DXnuBh;Q!6l|fx=Sfj_cL^frWev@h}yf@|;%3BMB=IFLrZ+^FS
zS7GlQD42ZNn>pwO=fH3ftX^_8E*<3{e-zN+-j$x|@xJy2n{src1^#8PAE0XE!S_8j
z5&`UGt;4>avS6C=ks-pazE7ME`7hZ}sAS|S&c4`BPhaErAjRG8uOdEvHvB+k;fNeT
zDjl=6bgUAXk*z43s%vor!Oy3_-%=vn!|;~kt$~Oa@iG7nuTV>8g&5mDXG7r%0{t&|
zO|uU+J7TrGc>USr96M}LIMy6;G&7uiwarhjP3WHXB76ou%uz<)_o}1V6XQvB&9)|Y
zNA_u8r$rG2TZjCIza~R#qUIf?Sc5fYL+sFS*v*F=jHm*TdzEZuHvV_a9~ENf3i4oY
z^hXKeFIX>J$MjHm(=koaDR@SCC62i6NZb-kXNg?xz{-x{p!(1kNA+K|HW^}=R^oX<
zGxEMN=uZjQ5wUV$oE%yfDBZ{T!Q~tZ|9fl1Ygi16`hDn!y8R7hr)`8w2Jb_zY!_J9
zCd2GJOLH*KuVnd>ojOEtWYwVfeG&fffVG%ywQvV>b8Lc336gh!#Ye56hHUXts(-}L
zhWZVqVr&>qgM44(XGJPc7F7NHR%wwC*YwBtz>nVTjHoN86R>NdbaHqhCbAfNAQ5^Z
ztMt*3zV|CmX9Vu19=P{%GLbT3<zw`RTcf)Q#hDkri!H1eeUcUZ^A7f+`|Eyx*#sy&
zs-b<QV_>Fb(A?g3dHy3paAnGXl3sct^XJp&I~n#~6HO#iGmylXtykATJ_2_fXDPjT
z)q!fiMf&fU8K`Ko)VG75>Z}>_HxZ6@Ymx2DFEJqqI*n|wodtR~$NH->;(6nU@fXU3
zX*_E^p0WK?^KUYA$c9~R==&P$>t{EDxC?V7*T2~ogKYBHf)>3J(}Ww689bHbO}E-Q
zIg2;<&NeYmYemfsb_4MG*JTQa)b-A7U}T%lYj^9G*bR(Yw9#tdcyX|GEr+jy)5pC4
zL}*iqN10H-k{0<)xOh$@Iv4f&FIBGDhew*xV)S!MeOU4a-JLT8z@|cYr_{YnixAVo
zio{IW0E}|W>ovXFGK%H19@N@T>~3zEfwc+U|Cs&<x`%s!iQvi0+Ig6E3Uj_5LMRcp
zMLm%$T=67<MKuadV)|Ml5qIlL%6u|x(X#J_W<T^^AE^rsO?<>Gej-%}>Lsy|)sc~t
z2lo0l5n77t!xFH*bRHK3$W}L!*PwyZVW&?3e`pUUpIa-4G?kMn$o`i1EF?c_F1+-J
zn8s2c?>MUVq$@1@h!9y+93JkP;3J&LInVvnZaab3o>a?ytU<#nJ4qoJS?_&W>xWd+
z-5^GHJ#ruqo$lTDdUuvO8cHSNRvzBd8pzuzT=j$e9hZVEW;UPs6<OnH6{-S<*m6F2
zN>3#1%H4J2@X|-SqyGx{re_EDKGt`p#<j{62Q6=Jg`VWK$v-csm=JO(M`+Rsun#fF
z)0MpA;p(>N5I>)V7JM<T{P{&Of6>RTS$A{V?yG`%$lglk&J`~XbG6bZ`~f9V0^$L$
zA87a)+G%z<vVaLPE3KOL1AV{sDND}y?z<wn9kHTQxf1&;tUrxvAB@+(1bbyve5_w0
zIyL|s?+%VBA|^M2Hj{=KNMVlySl`nMuQf((^|Hl9(*k7#Dg+w3s;MD89+je#qgR_;
zUn((~%V4vZ($3tpiPCk7MQL3%x>|$v@o8IoM+jzEXE|{iL)_tReXf*kTipwnk7+Wf
z+UvG)a@X(fT_7z292^FwWFS__ms*AS!lq~vuXU8bKf|br$B=<}2fqD7Dp&kf&1R?b
z_>PqpJ!KrI-b=5ygrUI%Z+b!<9`_lyDaN*2e5q=gDFlN37Z`d7YiIUxgaCMec-j*%
zO@Iq<7~9yC`6Aa1en}_qPPg6v+bFed+v~SjGT8&!$s?}7Xv8s4iu_U6X~B>Je}D~x
z@(AeA$)=)6Z*>q`l_}m;Sqrt80$C=Hg=-^NvL&q9S$xBo>p}|m9l@E<Lhkj#K=}~S
zcavk2eNwBdGzX7&t-md6LTWWT;uW@!rI?o^<u_L*4EqItpcKhN-s|H(=s;pWrJ#B0
znERHiXbqnG6{-EZVQhUOxT1fN%m4Wd$2#<2ZTks=QhqLE(I61Ig)R%bH{1}6*eDA_
zzo1oIXb_v#<r*4>`5u|6Ujgs^8z(;r;xc96r@|<x=7(Ql>1cmMf_$;CBwPFPuidd9
z^3yKray}USeO{J(NRMGD_rmj%EULpj4`*>{6O*=(4?`aN9&Y+GxXmjoEU4^HwTW;L
z>Fb~4W*+i%bNw?#0*i_o@s*?KD72E=818ee{x}T?Y(1O~AE#Z2hjdx|Ywsq>qF<sv
zn(%ZzJ&dX^FO|fsW_0ZrY-98Tu3kbVy4IBQ-8Vk!!rOAvIkn?(tvBT7F9>5Q`@x+=
z4663mfl?oG{SzFNnK*dNRJ)T!AbZf2YBbT*3&5*IDo#$KLQLds_Fg@PqW`hY5`^Ml
zgWU)t-ufB^=5BozG+n@LF&TH_S&iv+4MMK5d!ETXlh^L&=lpWm7`A8mxo;hRQzF2t
z0KoR{zRmOE_V3N~3o}aVT{c!Fx@d*-1c%NRZ&M8heWRHCKcC>aeZm(HafC`VN(<zq
z{J8E+NQxb{fi>q~=DUge#zc}Z0OEsJxUkvE*-O^iT00)xIeMp>moen0XD>e?L4(g!
z=5j#z=NUORg)8G*wm0Z{ok`3z9QJ-@vs<u69Ud5J-7YvqON<lHZ<i1QhkIE^82yT!
ze2HGyVwEF@N^}0Drr9biw2$tM*gi3vOE-{^_^v8QxNc}GO5WN}7BRT}w&YOu&NIp*
z30I)IG=tRrCuQMQ(uADEj*lK8w}pWQX6lNA)6W35R7aZC>mw**bxRQYD-mXv<9Yu#
zz|UEC2NfACqyB0aV|kD-%F8z&LuwO)o%SB<mAqk1QlubtNXn&*U1!?FEG300yIEZ=
z^+2HgT2hPU@(ArM`&<@I*h*C3^|fcDyS+Z!cVQg6oNsM7^qF<-d_9)->K}D{_fMmH
z6$trh0hp%Vu$!TG4v&QI)`aGfYh()2a-2e}q*JUs%G`LCM19bn=Ns*sf{DzC;el_B
z^id()LKQlIvgC0wVkR#;CTxbV!JH&OytbutjSW)oevhN47M2*gQ&z~rkuWu<CmVv)
z9heWJ%XF#lrzTA*puAiX-$e4$ig{5C5VEg$zIy33CWH>xTg`;zI=t)~fK7pE*Gj?+
zDkkjFTLp}kQH0?Fpb-L_9)c@gx7GDc!tqvm_q{i_d}R`T!gbe{uMCXe&po};gyy|A
zVL89OJ2D_Txr;wS<K}j?f7%}{cFlJ}wFJA#9GFW@)F<6dG6;XVW0*xTb{{9x4_*Z$
zyLxvE65vjU$cNXvU+A~`io~Ip1Moh88R5XSF8vc2SA!jyZ#M^=M2_+_&punK%QJOp
zGhCm+Gjnn&oF(7Ht1VH650I4UMgNdhiIjh~f@ce;#WiT~*dkAkw+a>yIymC1z8)GU
zrTjt){%nD3+x-?EBoR+Q%672UX8^l4Y*;e{efj;{{6B&x>>;lIIcWGJ6Q2E%F}!K>
z*7-~krfn81kj6!}^l5)~g5p~T|0?J40$(oD_^Ze_Qy1zDZWU(8ozMBFquJCDf-5YU
zZz<)t(<bAXdNf~ZFZj_I>1l%$hMxTWaK#|~m4YZOh@Zg)tFKN(RLG@#T_p$@jSwi<
z`n;ckwz2^tr`nqQwFmr?_997+Qiu`HD+**-H)zq+Q)?Jbym7ixuc2Q>(}iD+X5kQ6
zlLph0Iy*iv@3{}6j7f(jCKn=6&}Fv=A2)BN*Skj!S~gXRg*`2Tq%T3<04duyFiv~A
z$83>3<nxTmbwtOn@g&Hoh`h~a2y78t4fJ9w@Q9@ILfJt}8|WJQ=ak{FI&v2dfjgbo
zY$wDJX8i6UGByOfSaI+MKvg_OfG0w7LR>8FqI=QqE~a?k59``H;E(~Z$=HX9n$Y6P
zhV^dm;kVEeJ(K7nz=!2U>Vd(f$2Mj?FPt*NWk&&TtBH<x%XMONhb|XUx;{6sf5)>r
zx^!~}&x|sPMu3H|86`lrtGJB&rVVoG=ZIafRia6KwCg5+y!htvCN5GedS3Ty)@%d)
zNc_*i7nowN#^@ZpT!BudZM{Y&Z4^!VA<k_~jcEoF)#*sdD<(o6_~l;6EeG{DoeE3D
zYz&yk%4Gf&@%GcQ#dqQhYZRw-yX%aBa2QdSBv<cFTaF2C&5<S^JqPQ&9%+1ol>f7>
zURpXC(aHrj@8foq9`C!nYy^7@$La}xu&!Wuo@k>n0JrX+i%FvxdeXzIDBSlJi9W;t
zImZWO{VZkjH_`mSc;$%QtfCK~b6EN<7%?3hmj8Bd9I#i9q?l#ie8r1Vuw1|`R&IQ}
zYTw6xZl=6G5-C`yiaBAqp9Hc%t96OIu_CVMjGGWn%H$DWh~q!%qiJLwjF1}Y9(!E2
zCYcFyl`&=qw!&ezU-z6zzStsG*z1E|2JPI5vZV-V0`_bLYM79v7jI}OS^6JSf6LL+
z!IDrAw&w;KqEGC2HzmH8*bfG8W2eH~=^tD&A%vqFa$FP%4bFopK?)%T!iBs0BU3-1
z!8lJ6gtNqm*sIO4NVxiC3%o97cR2h<P5&^5RbvTpy!hTfLv9^JUa|x!=%qy?g$*O^
zmDECK6rfhBq8+RHcMDw^|B#eUvQn%fb<`E<eI`Lf$}hK{#b*?k+mk=o-g1Z0A=~^g
z>=zRPCd-oR8kMfQyj!Mi@Op;@X0u~@Tr9TV`(xVwpp_b;Jd7EJgO%&(3-jasT6(PE
zp07}T5bSPe5Q-vrr{qWJR!F!XtuO(&$JDrMn=W9rSPjIqh(S!xL7%xzW)qU#*;!|f
z*8d)NOU^y3=qYIgtYv%lxzXcb4ICu;a*65wZf{3WaoD14#LBD7+HO9gm^wV=zy;_@
zu`PaGA3K=Y3Bw_Mrz^j=;6QO`EjXSn((c;_d2=EN?}2XwqyYC%Qas8iVF8FgcoDWv
zMGHDEICGphTL>z3wlL-8ZiXGabTlV@p8_+EMF?>N?HDnu<cl>YJLrT28N(--ahykD
z!NYZ1+-=n$U+;UZ=<oXLGF&?GanX2Dbk!D56iMFFax4AQFKDHeOlPU1%0G#T$s?(1
z;<J9C(br_js}&<*u4_VPl+nA5n43dvaRhWEHc-yKN^73>bKAQ#)|aFgtIN66n2g3%
z1cEDODp5MG((_%75cSkkVCM!*+k^T9)h7B@?r!@@efNPK(+LVfu`F+Axs2v;f1~+u
zalfB6FZjm+9R<5~o3qDBXMIz7y}V@iS-9|Fgu!k8)2SvHz5XgCNiZj3hSrC0XXn=0
zl#T^vkQ0P$M=LR67y+%3{?PefCxMNUXiCy^=Ww#&%s(6-nO8KP6q?l~S8ZQ;@){x=
zi(J0qZ?&2CDm1`5#)@kh-b%sxtf@=dO-KW<{DeO4B}KnUm_;sq|BeOI))-)U`cHv6
zfq+Hn`@uHe{G96FN^*2$6U+Bm6QpF8szRmFZyv~h*~f{(y4vecP<}&Y?Vuqro0V(x
z3J8%Fb}JwfVG~YY0qKVAJ~{XNT0^@O=jxsJT=Y0ch2u$MhiGecjEGQZn(P;3=Vr`z
zQCS-f2Ay_dEE4?8hnAS1kQ6rxGblox7nbP&LsAu|yxk&SuN2W`eZH0%jdYZ>%GzDN
zb*kg6hVl&1jIzn<y2Xw}>-9&Tsd}jy+!W4!(`&g5{6TSWSr?*;=n_jEu#jCvq98K8
zRB?M-C5AFu9-kSWqQ%_`?^>8p?mazMYHL!bu1UQTH(<_8+S?>1!L1$^$o&epjkx`K
z55bN)ziq?a5EZvY6XveSj86f$kjLt<I6*_C*b1X96R(VAkc&LYLo4K!)|-QL3rWe>
zSd=d(9)q2B%IJ(y1l!%_Z!lw1Z=2`^dMYltEFjSVzYh${2N~qi;m#h9Zd~x?oHzGJ
zU$mBQ`%LtuC$iL?G#OlH4ti$?6NKZ?P$nSr<TV^*+4GhD;cAzWms72xYinFFw8iMu
z!+(l_keCBFA~|{?S`!<`E3LX3SlS<{%}|Vvb}P3gUq4b^Kwp~hb*&^Xljs%`*aFDk
zw;<i4Yd~f%`gE6j(Y<g*G*AK;kjQx$4AW;#4{*$uVwHAjuQV9dT^lhvN3idGlV%J-
z=%vm{K1X@DVW6#%Rh>(-59<M&=C@?GNX>jq8xN>sc|ZGcW=9#Gc1Y_?v)^sw&M%c^
zWB<GFV73<ifNcf>hc{1g{Oqs;R)Iv=BqfQX>&0_#Gb-I#(;o>PsI1B;rINfaxPe65
zElAy!Od4FM%^ru}{jMq!#UoDsqUxPz-J<DV7*O|)Ik~{%c1Z;y=a&#UvEV*R4w<zW
zAiMjRs3{_1G+-EwudvpZcnYSPQ1DI7p3YLBYnT;iU3!5AF03%k&`NXK9en@vwDEe_
z&BSJ-`bO1`cIlRnO!%*$c$ht*XNPEJPTJm)A>ud9ihWT?JogOaln{x~_M=2TP2RpD
z9;QzVbEOeju2UeIghzi7Zt-`w(d6=A=_HN6&+rKPAAkLXdOc|h>XjcIp-{|_=Hb!m
z5~Zi<HTY%og(WSfQI%a7J^>qLmT;Ef5er1gf(UtEgR|-{=1nm8bf5cf@A?{*2kV)u
z-~*HYoHV8tbRbY0ji%b9o=(rl$J}feXEz&{&n$&^N?pQ){y4Uv<l>-AJ1TNm8bg8=
zp%FTNj$T*<2;d$tPZl)%IU*2RK2B}^iebKEMDgr_cYD?59o*sgZ?}VVlD~>X?$>ti
z4*K{bd7W*A;{uCbE{4gu!=;VT{|EO#2)_h4@U8vvb5oXR9A@`|9zB0xBbRMS71f8W
zqIr2c#P!c_!^o(Ag`tE__YRJQwU1vNhZznLefm~k;&}vCB&|uqoid|StH#fN8tR_-
zBBY%J#hqe0)pe}=;#WTN@*klde?Omj|Ep*7{~59~SqGtIH@T|K=C${9@8#_zPHi#5
z&o5f|BFp;ti>2u%xOaSY2G8t+syg{q;%rtY;xlI4!QqnGb!41=dim>*>)5?&j_SFp
zxQ<E+!w=klf^U|`BRFR=;qg~*v8`}jF_IrSCn-)*M%?&9faw+-c3p<Fv!4&p<bw%d
z_vy|f4rVoG$Ubyt79JSCh?ZZ-$AXIq<VJA>@yLQ-3r0<8bRo)8+A-ht$y=oQ<?u(y
zfMAE!!Zp>V33a#UtrT+SuC)=wbyudy{58~caw}txU;bG$z8{bP3^3oJ=9N2gCZ$J>
zp8T9SC~Y}~7R4O7;zFPQ`TIN9boSpDpvX>JH2*bM@=Y^_2lG%okM*qlcLf<4vu`fA
ziPynDkJ(uKr{weZ!6vbQ2=~MNvyBi|2UE<E9K}qh$U6`G67z@)r+s`iU9}9X&mv!3
zBX17b*fm37cm{c75=@+t$v$2PYP-eohm#I4ap0D=YpqMc4<(O>&uOY#|KYgFtq-rT
z?8leH+tabPV_cZO?ueWCN~yAKWH)>h>uNn8`{0kFkBnF=ggcb9Gkw0Rc(v4=)L3|s
zo=(|o;G%*Yer6Ijhs@vQ>5WBWxMnas`Vqnv8$I~h@6W@0bkiFD2m6TFPyhcv^4jW7
zT~>l_|NqB1cWrZUU9DES`q$RJwe_m&Us{ktwGyr%Lb*D%b!j@hoVBb#g;&<3>u;^7
zLcf}|u3Fant$te8Znb@CZmpfxAzZy}^|#ij>ak0RTtcNf=U=U}s>Q1IAzmSI3b6|Q
ztzsATZ0fO#s_Ne@Yka!b-nCq{ugk4a#d^doa%#9C8qXUBf8Tv_WhBMG_3SddKD}|B
zy3K5(es(vi8?ZIGjlFGNPZ}@a`&sLyttfp{xE^?~`@fGrNxXN1J1f>;Qk94Lc>54q
zcT+`YwQE%(Hr)15#>!U7LYy=y<w;a1AhyibuEvQMRkY-2b=iC|=9D=j1$wCIhMWGB
zqq3Wmk68YFIpvZSj^@FNh{LTEmq^Nyheq@uMc1@`|F#K21R<J4$jT7G4%Cs!poSWT
zS-oYlrDnFxY@w}!f`PT#TM?5>%iUX^u3dJ`t_kRpq~Cn|k>|MYp52mF22H<!E4DYY
z9ojZ#WARB#m21Zz43*(F&6u>?R{L8^No<@ND>Z$WDz6Q1$L$}ceCmzbZEBWR*eXw5
zV4IHLBO#%M`v1OnjdlKaEnA{qSGcbVr(KOjlBj7~ysMx0$Ft#L`PyeLAsWdbE>B`Y
za%-drfC0VNowmJSisN-s`;#0~m<#ajs3J4nfZcr^)LE~S`KYOEZry!m(jhgVv0j9z
z7QnphpazptcxYEy&Tur8B&{OIjK-SyofFg_z4laXP1|>tt^s|F9KMU%vXm$QARl<K
z-lMUjBhbEAmAFdjb}xL&L={P$I8;3lND>giMB}7cHK5mn@|w+|<fP|G&Ojc~28xOR
zDi(f#YxmdI?)lQb6K3+*eRA>AvqO+fPPF#h;rOnqBLC}~`7Tt!T+~xpY;bYSGzW5F
zqZdLU+~d0P@hIzRs8w;gs3^RmfJobS62x*X(sRhqponH+^iQ2n>x^*B@mE0|t|ty$
z9Juh|g~n5C8$J#pru!{WnZ?poCT|O7W-l3PD~j%<d>qF&9!rbJ%_1UhbpmThsjzYb
zpD^dhIDq8l95}gg4pf+3Sur+qIUJlh@*IPYCk}iAh&5FJEy(5p#OK4GBZwRWh;TS^
z92^dOfya<ExXWhkAd;K_0C+4xn*bucS`zN0&%qA0Xue#a(@XI60FDP<hGa-|3~UZ|
zi4<LYFoX^4NI=KI4szU5aPB->ve006@+1f}!;wb5!ABGS3{yr~Y}-acb@@8}NYgL+
z_t(C?ToGON_${CPIcCp-D?_*I3WxclZyk8}>xr1nkU2mlR;b`XFT_i~q~D3RW_k_x
z{apFH-^J4EwVQ$+?&SSj>eazE7<CO*kb*KCqu&L4Ify)xL+ccrM49YPs%}iISHT`?
zR;!Ptsfc`H4~B2zyZ~P<gH~)WA64wj8V1BTG;lu-SPug(0K>mcN{_)09@BYvEw<F*
zm0rFUpdz_SBd&tX6CFNZHNIm7T1ch5Co3@^XL1%yCj>X6M^kfB&Ath%NhuA<CqD0g
zg>%<fJQgpYqWmQPpYhft-VZLmyAtrBc)S#41POufWo{f}V7a;T?n?PMi%zqBxnT;t
z$JL!**0b)q)_v9y@XSXSO*>~GmLI};qa`P$kHLKb5HUocLmO}<UyXP0jH9$?2rL8y
zgUG2>*TR$oC~5%Jv15HbOlccA<(+e`b^5vS76W@{^Ws%!^Yy}AQpnZfKCklfXT@?U
ztg`%;l5K<cQ1LV6=n0#R&XbcD{FT#-(0Nxc30nvY%g>j@+K`s4Nq8faFcA86CJ-76
zr0bNO)@(vLvGUgPVgh;dRo4j5tj*w$rXckk9-8-$g8R@=8Udk((0pJQ+<4$N?EfD%
z!pq^03pT@*wPFd-CjbCrI`9j@cC~wK5y1g~a4PU&HBB(gI5+|#(*`+*k2QeThIf1+
zEmo!LUsUQhcFykkEO_CctDik9{5qZ9P7tl1Hdr-U<+hElf{L$NPCOCr-q*zO<Uf<k
z!4z!;wNCM8-Xn5#uZFHr3leB<tK_op;cldMsEATCxII)7{w$>8xpywV!ZPz{XGvd<
zw8=NLX=ESue3p44B>i{Im)5=r>M>e-&A}aVch305clo@0K>QLy7X(LFFNm%h*hlhp
z!<azhp($GV(vdA6jpKuyQ@rC;K7pVKg6hG*Z*}>Su|B>Ct={LwO_=B|Y-Cec=9GeS
zpN!P3EqB=4Nt)rE={%R5AT2KhUl(rhz{#B4Cm;9Ke<v9B&(Oa3g<lhWxpw~VZo8#v
zuU`0Lk&Pk1TG#5)kN8H4m9U+|?<>Hi;0Nh7;mXIti~%p|9E)e++8P+ZAsgrp^GDRs
zTIdU}nJecFc*@=pC`ubbpvW<7xWKAtAYcvQbf{MzvVEd~_*YraR%YOf_t`6w4E#91
zStQPnxQ?}5Yv8(u{p<I`Te3o5km`4T!4E5MTqS)xh0INJUWf2aRQF<Z5A0z%eb1l8
zai%aG(n0tkq^%)2Tz0iu*07%m@rI3Zga^S?qsECpGVEJxLUG|Ov@)DriF~uiobR8Q
zM`u|AfB*RBE@=b9?==4<DIq5prD)myZB=}pNO-v+IpCKE+_ci(=i=*>G(g3PGAZV{
zt6Jcr8v~NTGB3f=F_@p=x;O^}!;Sl>i2D<1zr^xlv~Gc@2%o`J!2qx^(b}YBWzeW-
z82jzWvDW14!5xO$;1AtgR}Z4rair5s{c#%A?<l=r=B*gTm`%-}_?S~u&-jfmU3}7H
z>*5Ju*A<jB-79g?6XD)NDZK;31h%kVVU#8e0d=%l&x7RI{}o`#D+z-Rp}*)CkFa9`
z<%Gs)1m%&U*gAk6gZ@5B>K?5?9F77SxDVMd5C_NS3>X4d8r%Q@XbHlvN_o@$a*ICx
zwe#1@T;IZ4r6lOcsdHou6bE0q#tjl3a$dE|)S%ea#q()KPJ9<tbzQy_-L{&4$y(15
z`uEkMde_{wB~ThjpZTGc&BerWbd_^yU(2fFS6SAN%6_`r;JeG2C3@wwYHPh5y>LS(
z@9<4-FE{n`cx5BL5|NRiT*1(1ID=3l{x`g3X|K1+gl|8NgTTN|6rr!_hbN!lqG9v~
z(F-pQA$38#+(z7tY;&%;E#==A=1|5nHA8u?1icXgtI1u$!(>>#6Ya^5pxQVq!W@T+
zWx@*JTA<OPY|cVHILUvTo@UP<QX?=R95jY3VBP3<GAPJFyj=lT#g(maLmnbfbq*JA
z5PV<5`YDJgCWHYXQK!e^{eDDY<hY-L%Bm%uy00s__ukMHndO+2!wYMPt?#N6s^G4i
z0X8rI<$HotP+$NWJKEF88|z<OqmR7$t_&l?xhzQhU>F~{^-e*9;cH9dW>hzS2s|Xa
z{t2>1fN{}qUWYFT(9c!EGL1Seu7R-|{#i4}DSds*R=9<K2+OzXsp;VfWy|uoPP%yZ
zJV+pO{`oG8G28)_tMC5NyQaUnNM;gNea*?zPr_757k+A+ujT7sHpI+`yfsQY8sP<h
z89k+To=%(jxhe3UJUQWw)}-LSVB$GBvxp>5UmWEnVv@7)Ppz<x!P&<EcOD&_vH>t3
zKx)F?@YiUe+Uw;60pZwseh|#&=oNt2A+Ha;|HbxZrfM&eXxHH^_H&rvt?Kxh|L1z(
zvKnmlBe%6yDlh;vCxc%2pBf!>F-}-?ye%0MJOkB_2h1>A95bchrtW|)oet5E^qb<k
zrj~v8aKs}2f=W=zS{;vqE+0ck+)jKE&<M*6#c+d_aT1-NiFn}Q)FGjLn2xzN?f9BV
zx#h0R2*$;iI@dJqx-SjNX2gh>@X~N`T0uUwpLzE}75(VQKlw0zqP{*oPLf+m<jdxv
zqdH&5(zUIvSHTTQWF@_GbxwZ}zX;2_da8R~O1=CL-&(Ftsrt7C8Syb9HJ^W4t_e8M
zY=r*^QKPC(gKRMm(u1JbKL|?Hv7z%rU_esBkoE!;8tYPUhchUq7$^>u%d-5ms3DT<
zfjj`n_5T02pZ~$MgU9n@28p&?0vmxZ0G|a`+iZ%EO9LvCZ34L1%9;~b9yheXkP1gV
zDS^vN<$?*dO%;AMApw*S1|Pc25D(X@f}3d8f{drvM>J*dLmM*td{t{>qaPo>9nKgC
z<Oc`oPA+CR2$;eeYv!x#hi2$IV*_o3KUH6b=ig#K5q&X|u_Pu~4`r8$p|C({E8~bY
zYq^7C#WYP(;=FXp2B38^tH;V1RnAZxYtKH7D&GaxNZ1JQD27Bx8;>SnfsMrYDZC8A
z6tQL0L`4fwbO{t%svKPJh`<TK!|xwDguI%q^H9e@;D3VMHfq4!bQhQhW8(X@9te?u
zK-diO;6!pLnczPamQ^cz3&K3tlPPOU&C!%#`K;N?BJhWek@(1|M;93ag9&kdTz*Ne
z7l+fS^o<7%Yxrq6HTWZ^9T-juJV#oDA~nmcF9}XlTUGMx&PvXAe+XA&-KVW`%a^E-
zht;7@3N@}=AhSLbuq<SBwDaeQw!p2vYq|#a^6~P^gxnFneq;YH`sA1<L5%BoA*u>q
zYFEJy%+XWuL(^AL_woK{jsyn-fHDz6jDT;=R$qi~RPh-3U4W*g1Fa^!Typ8J6P;TX
zM#0Bi5c%kpcqZ<tu+fw<!^CA{AE{{U*#*Hj92S(BkPKk^d*-2}akmKhB+4vawem&+
z4gWN?VVnReLqL~;EI)Hyz6m4ol<B*O)pX0n(2mf`9w#s$BVdLMpyK+yYvDX}s#pl<
ztiEliJ1^j(V9<RAHo--JF0n7&@cmIf5;$(Ef)=J7W3l>eA7CmJOIrTHj-q(Fy9HU8
ze+C!~@J^A)Eo<$Qe;p*}E<|V{`)GUfrQ)kV!!QYBIJJHeuqDGkJ048_YXOgo0yQ@C
zJ}N|(NDg@Z7O>K7whgo~GDr#j^3J$!kp`(R#)bVF7G5?Og4X`vJ3%Tz0@^{dP$(#R
zlwJXl>bFekTo6`J55m;ph$K|ya|N7vezX}la~lW`ua>FCyTaU_((#c4*YpX|&${Z*
zg1V~Pk9n_=q!2U)o8|0AU@ghL{M_))^L47>I%S2V-}6-}i9W9g#c|ac7F}ab_GSna
z0zfgcVGZ7^t$Y&WVa^?6yg+U|maVnoI+zd^A(MlFf09NB7!1L`H5|-WTKKw@K+ZXm
zPdmSd<qQO%1%qA`BpxGZ|6%u@3*g;zbN;b>6IG1lsPkpY;RyrMRAfV<T0!g&N1w0@
z!E|JGev@1L5l|fWYUZ~HpZ>3bJ_+*~n1Vckp;U;jieN50KZ0)od})Z_DmYorkO)>X
z1O<H?Wm2q8BfI%1vEkA1RXBi@gX^!WT9>U?6F@{nz}^!?*w_ozzACny$u`sTR>Zy$
zo6r!^Zq^tx0s%oFPND%loa+1%!bb)5Y^Q+pO^4UV<72M&amLozv=tc*V~;Pv7Jx+r
z0@fycOt9BUn*ooEFLi(1c+P<Ti`1Dw%sQIk@R_)zyb;GnkJWSGi9S(4${j6luD?}(
z9W=BZgN=rU2Sqb6*)hH<tZSsd2u=`3!U165A@E6nwPB2j#dss(Y<RZC1lvFWG&S+j
z`C90o!hHb}@t1>z3Be@|4nTlC@pO!Ctl@yr$QZ63&;<<1OMjCJ7#2Sq<k%PRPYs~l
z53n0XKF!pN;VE)B4tYWX8o$@RD%GmhVTBytp5L_A(_Z)_&6e1kmqd*1@I}pP|1E1F
z_gqc1`fn4-ivL@D*<izAkCxcSy>VGR?<+#w6Lw(+irWHjcg<s!nm+!u^LVevP#A73
z^xm5I$Ol}6ST6X}L3aR$-J@6k<^Q#DJgS>4nm-`MG41uDr{#==e;5T%dT;QT9$c}t
z^{;~20uzIn)Q>qpb17lqpGF>rTZLHoG_&Cg!KrKwjBFjAZD9IbI=|qG)S2(Ed{=qt
z64_0@CPE3RLd;Odpg+ZFBrqeMs?Wy5x|kP*>i|vwvjHXDei}vae}t(h5627zLsF$c
zDj$oE0+N$NKIzw5`Fd`+B(~Pa%V3l>3AO_X$HuQgQIs5FYehzx0Ra9xj*hq)0|?D<
z6G8ep(tDb)V0;Vy7|?=DQ^LT3>p%dwKMTsUDEt-B2^+ky^MnItl2umtV;vr6Z3Ado
zC4*Y@=lq>J@L66kpx!8fuWe+TS?l3k6XO8(z-wJd;4#yL9eiBE1qTzYo`2yRCHAB=
z9+D=bu-GuulfgEvHAbLqBa>}>5n8m>d|yDrF-%6I{)q~I=I-x^>aPd~%|8Vgc`2++
zH(*-fb7$Lr3N{8j00kQX%VSnt_~?1uE`Ctp;4FcXgaKt<5tyUK#zKzd6_~{OJ`+03
zk*XC8F%9j1OfZYP;ftL=X&Deh9vDbv2k87|=~~WqI4X7mQIn!t4s;ib?s53Y#n<4X
z^=wWEFe(8SPdfhy@<VKNt>c_w_$ZKjNOhjTfG^)K4C^(-*qKQZZ<DL|LN}6+cgxSH
zcwi#7u3Yg;TvUOZv7xcI^3Kjh$MBa`(;_qQgk{vV)2S+I1<B3tPCP!pCC0J8Ed#0?
z?(2fv*yYan-EHyk!VhG5++&SK_e`xP9mdXb-(e%Mt}i%jU{Js}kRR}!J*#W*)~qL|
zK4i&Q>F2>5>`?Xa<YXb2jz3>i?fcP`K)PNCr35UarPqgx#{mCEn(MVFkU7^7PsC9p
zW{P6$vUg^hRmEz`o2L8_8mss#(<Zbr!(DYWple1KprzNu>Z-udFv?z957ysWlZWbn
zVbDY9b}Z>IA%H2Q@zw^{%EYSv5}~t)A$Fm%9v9vVum+8V=tSB74~eW=s;`9Vs~jE1
zou=r$%Nc_okFadkLb&h&+f@tvw6MNDcKD1ph4>qU1uwxZ$DCO&CTr%{ILd#587B-r
zm&M`dd=g2W!Z|m|Gy}5h{t3Kj0+3*j6IUJ^ut=q~`R1F{_{u0GB6szaR@40`6sggN
z(JZ2%C!Vh#8hl@V=Teme@TS5#wgLqe0VjuM@)rabm2D~QKE6JUDC^td#GiP6lL?q|
zPy!_A415Q}?XHLHrSn8QhhSI=AA*^Paw{NfMl&7C00_`obK^3PT{@Ss4`1t}ko#Q>
zgd^~pACB!H*HpAqsICdP_y7q==wrej(1PiE(zH&s5`Iovui&<9;`P_fyA6-YX?NXC
zf12InIKJ&rNXG>ymzPO+BJ)M>mfZt$aFuB!8E1sHw}SF!Cq1qsM10#`IYJFtRoA}b
zLym`-KKUVsX2g3Ri0oqlyx{_XFpj94DPUtlhN@{<*O3tP+W`XLfZ?cb3jqO_3KeVO
zbv9Sb|9Y(*YlQf1&$U!V=Ev!C6T0|~%xynK^3V<%Ku+WSwekFDDl^s!FJZ>Oq^4kg
z3M>EwfkhFtGZ8s@9dh_7qev!jdurjSibQ+~?o@)0JaiGfz6h{B<@)$2&GrJ3LK<I$
z=mg;1Y?iq+qk?n7QTGqWApM#UzaN$O>&xv9>c5xA$2Nom;G;FOu5#hrVuIqB_}eyz
zpBIEI5~o}N*FkFnTJXSoX?-!1-}g{O|Ar)?16hDXI5-L$zr)GQd8NMiPDjrQ*1EsR
zjW6<3ZhlPjkHGwHI)QBhAsy=`%rR)ks{W&fejd&k7B;LMo+p90K(7a(@Kjz7p2N*X
z0#Ne&As7V*DWH4X*C+7w#wjAy)xKcZ9A*cPfHB6Dfx*|+JANX-iW8vIEzAItxksNJ
zuu<{IKJa~LvLLkZp1=Rb`^`gL^{gtPCjra<`9G`uYd)ss@^f)}x?Gv%>b^~Ch5J_t
z@WO66Gh9?x?@@dbRdyb=@JpG+CF5nb%L?HgV*gk^ug}RcC;YYn9s=eK5=`TDsW?Mc
zQcLAx_)4_6z>@s5^vl8#(9GaU6cNuAT{^H_KT!k2LEsmF0DMfLhJ;qA0mu&wUtfa0
zGAm<&Fos3E40w4liQDDJ2U@8D1M2?~K-#t(MVWvY$hU+f#aN5y011!KXa-J1d*HW|
z^38zbe05mZ%Isu?5sN*PzY|R4ar(WQ<b&2%`=;^-mla@T+ry{;-{7h=>fju#eKeop
zYIR)oIz{>f5^;%A^4o9lSu&zc4a4ZKU?qW!5q@XFQKKW6cqr~RHu(9hFa0e{27ubL
z8&g*$KA(t-lG1N~z@nh4-{5YTC+@rn==D74FTn&|)8Lmr8~&hRuYVUPE5gE3-XT!a
z{KIjw8h=gy;Ym>rj#8h#5WM*eTal`8kI`b6`w?_yDQA3Ky}*CD6Z=R4u?5)xsb=6X
zww||%jRsZ*TB6Dj2M_K?lkvHoKNl{p>zg3KgiZ{r!~Y4~ept~Xpd16?&Ik#`BfyHj
zm`U%Y3-ObRs*7SAX7&lf*)%X%7J{wH2xuR=@Bn*&0r)QSVnn|$jJDI&1PKQO7>ITn
z2AgG^4<87BEQv2(y0n2e49n;L{Qu3*Om6nB<j>%;-adF^*q9k_U}qyYlZ3W9jzp~j
z0rDN!!4+$Nf=?CK$ucM9D7|eE7bIyT{nh_c@RXSLuFV$+f@`j;)**gv6C3$&TI2GP
zDF%bBZA?U*l(dBL9i>AcVS35IKbLP;`D~Z-PChKGgmUCFUmq$)1~m0h*)sV~kq$id
z{q$q<depopQUnF_&`F+h2tF^54*uHx)pB!Z10Xi%mM}V~3Y+_`c_Ty>u;-7gd4K{?
z00{vDLXL;dxFX8N{}ILpFJN#qokjupodd9jfjH>naDOUa7clg6CU!OfD&AWGu|2Y0
zE>w&N;`rdVfIIk38MQ74YzAP829vH3$U$C$0EOgf!+1}=i-$1)jNEGbn9jZ=AA2yt
z2ggGYpST=^SilS|$o1(4Z*A7NDL(CAgFEpg_cs^#C6)k{qYvYY{V(;T6tD(5hm7+F
z?|nZwFYmd*+Ds-FpwPe8znx@>i2ks^3H#>8uKV_(-c$bsunGF7_jn)O9-p7`9v0pP
zI=WzGrmYkE^PKqp6Y8())H-O<8`Q*fP=aoa5!dG+ADv5|1rl408-s670f6gyXxFA2
zMsR5~AAMno=A@Kg3ftQt0l*EA4dBOo)NG4>KcErQRGQA*7NAT8GO(S-y73f<IV})6
z4QO@Tk^Ga8Rj-2jR+twehyMulIPg`Dof%}%E5g@}s!N6+cX%MKD=+}dL;|8V{%Y6Y
zu7E00T>=e5z;0Cm-VjFE^>Br$+|<g~8Wpe{58#5qoIp<K5f+tUml5HcfUENgDv`GM
zCA7h=I5bQNaAp2ZN@BX||0Y=3dAYiik}XH&U%oT%)~NfJf-PsG*Lu?RsXE&F*TD|c
z@{I}a|NL{jC2sax_#~|@eBKXv<=y@>Z3LFvc`{W!ebd%{xjAR^cVu3*^F{<tpdwPD
z$@61VKg(zU2~iPB;Bfi4PQdy&1?yGGkEHj)eBt{T$k{i;etQ7k5v_b=NLG;HJNmQZ
zva(_QE7&p6L!yK8Rxk~)FLpLXGjD?FN{|2rs0ktQkm)&B5!z`pve)mIJ`&n&a54u{
zd)0vg@n01lmgdlrr5<%`!~<}L-u2%kd=Ot42seaw&LCMK;h?SRy(fz?^abGzPtZ8X
z@=^@MBI`il2uq(Cj|G|s4h>v5)r{3|L*veF)Q%azSo=Ut&@*nTyafI)h>y=Q?!7Y`
zdJpxu&N@;{Kpyjy(~sgBKcWL)NI&pHjB2OG{}26qUx1Nn-<xl)uAyyRJH_$?_Z%Di
z1)sUM00HpDBT{%E4t9bqfPgzr6wy|{uz}dl7>lrw%SS0Tf|k+n!h%oFSN;To+7()5
z;fM@rm9eATp>#pSeSbEb*Nd(9kNd0vdb@{)Je<t*8u(R(6y@6fCTkbk`1lA-SN@?5
zdq#}i3qshVn?f5)#T{wJ7C`WU*YKs9SMfR%!k@cJu1_HkpcwtbknWKlW%A+EQ0UMX
z)<y79Z$HyMBn?uy@V^-i1+9QK6(1Z=4l(`_=y~w8p#Y=Kwd10~qi8XK0I!sDbiMxc
z%}B|@9Ci`xj25dI7k`qIP}}gOEZ_hs>NOc9+HeU1Cu)x{PaI?6&QJt=2iMuz2NSvR
z(t-luKv+*wynpRV(D=3J?}@%dit{?=@a&-;J6mQZ!)!3d_;ACxl>+xT%GC{5t3KsE
z^X|B=?b5a7)qb^DpNXW&Jj>Wnpa1?(@3hts+55!(TRY!3ZBM}^jZUX$!6cv6@f1s{
z{#xrleQM9V{G1_SPeOnT47IRi3{D`?L%`M#FBKUbY2X6&B_ESKA)r>UKS`^A8qf<=
zU=soOPlln0XatEZXLVg$<hvj1Z-k}=$IH3_$!K0Obvcd#9*Z9vQLqS%z&Z_q<^y=&
zkK3R!5RQ!vph_8o>;%Hz6QDDO20C4%t??IKc7ATExVr|yje&dz9u7yxqwrIibZkwS
z&=|CfhiC<Gdqb(`7Xt^!-=8o51U<S)?D=433_dr6zhctyKqN4~mbQ<H2m@fZ<Y9?@
zwC4T_CLZOYI~5VhSC@|x^~P&k106V~Kt!v-FaV8@Yw(4jh1wVwfv6Q60CVMj=ks_F
zJpc!urrJmPllS^V|CI;erqia6>j0el(YgUQ@4l=41^p`hZ?XT<kHRp>U(*|O0t5d(
zxo7?_vk2}3Kp=j(!UO67vz`&)ByD$77}--_N_>2P!ROaK^wa<1FcLj;#)kd+U%z(b
z><8FepGWJHn+`|!H7Hp)ibeUD=kiS$vSfGUfB04lb(!c0_2~Xk1M>#++7$AyobmA~
zqow>m$UT_R5N2+*DlGx|o0ilm!wEZl#-!3C@o<s5KE1yy5E-7kX5A|d)xJIez~A-F
zxG3LGL!O=ZgD698?wj8>tCpMTBwC+b4KA1PLF|UYi2$T^*h3mLun@i1Kl1MfT}NI|
z{qFVir@dPIRf8J`Tk?UBFyDqGRKQeog;<Uw8gTP%vd_UCDe3Fu@@CO_GN(X+{w{IR
zu`BaZxG9h}!wkVKfEsx(j~05L?^^h)pN|jv+)F_n7nYS3>3&J^f`rYB#O!KE#+E%F
z{FDJ$2<ZQL*UK4f^?hqT@2yMCd!AlhR)l{pOuFUJ<8pZIQtoc{z6g6uXpBV#6dj3w
zw%*zH-?_6<Jy@<yS$t0Rjr`qeeom5BkL0f@9|_uL4H@@e1lDMdAUMo4dQf3E0H1!2
zf7$#G6I{VfAou>YCj?k+FHe`nN2Xd37!(19A$~3fPw_njI3b!=kxW#AAJ;139LOVq
zYF>kYYuNln1~_`4T@r2l-go-$_{(DPb{%ry>jA-zGESE3*bZp2bY2mgHW@+$Y*3?u
zW$?<3qRYUq!gj|4z?H5_aD=A61vX3u{TfPP#?pENC;$po;n>cuLyXzZv&LRCp$sic
z?WbQCAd&%`aYz^v00AgqDB_y_FO<;OknjjyUHx~0%LI&_)W8^;-h_MNZU0hx=ouGa
z5%qKQ{`}z<-y*jH0p2xLU+06=osWVT1Ma8KmiNbrTtokzei-l}dp>y&4~U0Z-0BWC
z*F#^zN8*y}!@LAvq;2}pA=_9LYR_h(@Eg}Iz=hEGCTYHYI1Tg{;D;0X@YVD@+)U2#
z7ZERx(D*~dd=t>ib_A{dZnf%FU7wGSn4Y~-YePfs0?+OQU+mr4iLXFmQNDi+L_TNk
zr9NG5i(9@vLZ*9aSM!k?HC&wp5CPh`E+^mTcs~ka`kBDYf9O8$sJ*~v$$U@Ielyq>
z>H8B}&=RPHb=w9I3f%j&{N3{QRefFm!aEdfcd#N3mN`+GaC1dV{%H$`GB4%85s{BI
zp)O6>YvcIH9kgdCFgBA)IcT5&d`@87z|B_jo;naOl3gf3Ka7+yNN6lB2wz(_uwd8F
z*eKaq;k<@4G|Me~sm%saZ)@Q^($=@l;U{-*kMW~!@`fUC%mFPO+)4K*5pAy0wP)ha
zvY*ep;XPJd;<~jTdG{w5gls?URht9JXdi@URub_3+EPGh$Sy@GQi1ZmTO4K!H(K~C
z<K`%b1)(43ZJodmun5TJ;GVwqx8WZS#e>wr0FJzLB%}Zn@KKSpI-0UzzAL%DWJ$gY
zbGK@~_>0PC5GP~Kr^_HpG#oBP<K-*2Y@+BL4UGyqE)Rl<L`(n|C7{P;Z4Fp>DB3vk
zp_sx6KmaSi0RRx4U;eg(;HFd0Adb2MLw(<X21V5L|J6s|RsY3({#E}tU={%T{V()>
zwtQ7iv}09Q=r^t$@FLbzFYrgJ*WiN*xIzIIre?aksBsnqCf>lUt)dI)1Q<?WhGKE^
z&Ybv&PpzB!K*4>6G|)M*59g4+70dmFNKcE@-wDUi;Lq^<(Z-pH8uw*h2B(d90Ku?9
zs5}t0;8Ak8oH2oMFZsN~*DnyzGkJZX>oVQzg&-og>$hwUUDv7q?R+J09}89-9^Ky|
z7je_#0so1(0sngMk@K@FbzeN=!WtQfECoLYw$!|xcYHG!Bd!ReVAZN-_F3}A;rbnM
zFqZ%_*MvnnclhsV*ckXJFsO)q3$8G2fdIZ~&Qx_Uxw%m{;ESYNcg?)E`{iTclQs_+
zrEh}R*hKV65Y2cS?#}NOwqbhJANY=TD*ENota<p3O=U<o49~(a>^KYLv}<@pxj_O#
zNLQr50O93-mO|zSI0XVX1h{1&zNnW9^nPCjRtU1E8W^YqogvfM1#tLBnytf4wmPtM
zHNg)jH5=o&y*cwf{tI;uTva5U26(Z2Re{H+?a{G+*BcoG>Vi~XJyFJh0X%5SfFZK~
zPuIosa_``#Z~)!_%-8AP>?O?^`yU#k7Cc=Gz)k%g`T_}YsmuPZ9KcG|fb0T2GPXab
z-oL^p9-HHEL*wpn2=!op@X&W8WN=E%?_I+NH^=<^m-83x`gHz&&&$`dtX3e^9H=9}
zzF*=AMY@l}-VhS|GT4B81vS0T>~tpJX^n@2jP(y+IN;DWUr#IuefWQUK2zxMiLB6a
z;Hx)F-T)Yt_Od_y*#KEdp5Pk)iXlJxZ0WvVzZsc)n`aBz-EVv&A=yC!fV+&U*C7tK
zYCHxH@SZ@xN>v@vAQ~ft*`93-#8+JRn7P3(2tF<_2seft6YL0be_wN(cp)}#y=wV9
zW_QF;8NvYWx?gq#S{xL^o(SO{2OruH2w_Pu@z$(oB)Zc_0jpjkavEUmNvIsZt!LhS
z-!?jIdOvwJf#l-5YES-avbMUkJ=UW*sxgpcN`OYlKl64(zaL;!1UMZ`5EBS?F_)wd
z_$!$DC5~FaC^cvZWiM5CA!pasuYyj|sc)NN4c!3~5BNu<lLoq0hnhb&T@0aadLIbp
z5k}*ShCvnsf>1Dj1vwEBR0Cx|PNb?>3s*vS#Mem%L52w-;@8B^$^p>K5DGM@Xx|Ru
z)HI1a7VrVYPb4)mc+w~MDdk82SAS0*{LBP<;4W~O+gbh%fcPT%b;P&QN3aDu-5}*~
zA>s>%EDR#BLV+5Yw`F(#E&c@G$Gvzd!$Jr^AIuPy+#UU#Lw^$QTn7(<F*r~E{|cxv
z73j`cYKxz)9=Rpd2Cy1*5S<KsWJySd=>yL}z)QmL+)H)`wJ)Z^#1o)|@9^R-7hHX>
zefL0n?)H%DUqORe+6DwqYJWKJmYs8-{o(@X0PMn)9@>9seR<%vKtSv3$@4wBUxKNs
zJT&!y_u3G02X8<_Wrd#wd}LL4_y9U>2m-7>|GpHM*8r(Z5+EstRe5k%={W6eAQ{9%
zu>KdEU{Lq%a_fI49g8nZ!hL~9Un7pa#fSg}agfA0Jq2gRM@9Q!B}sz@rq++gQH<L`
zut2VA(-x)AI4|ni_n&$9ed7WLfkpbhY8`$PttRMmZ<b>x-WKGG*0?09?Fd5~;Z3PE
z13jw`J52}?)HX&9y6x~o46eumhi{GX($+#z)A0W69}-^7RWXCu$>;xd$@~#WZ<r-w
zyl5hz`Dlm00P0Ps?*3fH(YyP}ckx(gVi%xHDCOV54dfWLbK>aG3AACX*+6KbhQr<z
zjFnC{!H&RcA;9ATQdV}3wsyPVo;=ooTWba<Idg<E_^83*N&3KrUKdw@z3lu?NhF&d
z32GV+^SL_V90Fr+An$en7yp*f{(U<ds;Z6w3s<=2;{xwUMZA{(`iJ~97=K>)B)}wU
zu>8;n-mo&H!;i&b<FJp1RskNd@Y{q9_U-r%-+yy(e2;jzKwlYXQqiesQqd9OJ|sXR
z%xvVSPc|T5mN*XeEDrT85tx?<3ym}?B(#f2FCeg5d<2E!35|gRP+UvL;K+L!b&@0O
zdp{2%%p^s9{j`1v<R-w+FDL*+i3??MkUw02y<|z6s1Ez&27E9<`A2uqP`?2%k3qD*
zK!1zMy=VbzI)4Qk=L`;4oM*l!a~7mP7ZqaaIc32uN(0VLX8Y#Da056m5okAoDzpv&
zuvG!65~X$Tg4(B`jrNn4(=-fu>EkG2*l!bxs2sg`sPojZs5lEr{M=WFcBk|1xvA%0
z*1ok|R<_0en=94>_m-xn5$e+j+$G6$wZ(N>PW~gxp@`w$z7wq`nqStltNPc$6|xE0
z3Y+2kap9Myg!CPeNFtV_nKD=W(O>XK)m!GmM(jE|xCh|6jCdBqac-<d!Y;4(H?PEb
zqXNAT!WU<ww$8vN>VTWZ$G{aUfPi`l<yZ|m3xa2dZJrPZL+inUxNu+$P!^~;R1F?~
z#K*_|JxY3=pUFLs9<}+j%8&5&JPeex$ao+|a&STeBXzOyJ2*fP{TreKX22S)qtbAd
znNq+02w*K*evsV@0ZF;2mf<_$&jLrW{-J+@Z~J&D$1{O%c)y7cuLa0X@)|q{+Q<3F
zUH2w{lHvg*5VS8!HZ8nXAl@65^<qID5wK4z5B=gk@u3U|n;rZ-8GGi3!k2I&d$$}H
zfL9f~LF^2v@jpvp0ttQv>om2t9$z$npMo!dY1Gt*{n9ftr)2*V;I^Up0l%YF5rLWm
zcAJ1c0KIgFI(RCeIAam)00Q;_=+1$JykTKn6nN}t-g@H6U_A>P;Y{k%?9Q!d#6Zrp
zFK9hDyWoy<95aXv6~RWvna2<i;Pd|awRNwAtQm=n<s5L&_(G%wwD2f5hJ$x4C^v|W
zn=kSHZcy6?XdyNw+wf1x>~`JR_n&lq*q3#}8mg|jJNWFY{FIvwJ_=92o4ZefEJrN6
z<>@Ty^Q**f5xU^2j5$B*HQ}4MV4Nzt-SFKS)k<jE*Zv5u2vv+u-!*K$tb7vTq*m3|
zikFaF7%vEA@frkk><BvXAs6x32eh20lGT3;SQJy1hXk(y*q)<DpBg;>i{mEWhvKX8
zz8GBU15#|H!N$~`17k)}0a;RvlraCtQGk{0oPB1f>Gx@5;hp<Pd_G=Si-8?q7N3<-
z$%j;?&>#M=Isbyl)NKbYAr_bd?u7}yDI4dhH$V5fe@@&+UI=9*AB#v4U^`y_Uand3
zfnq=0Vq^X<Fi7es5rcd_i*C83kBND@zrl1%?PA3a0anaiTEOaFOm4}5hu-{VJ#2lp
z{{>jY-*CUr#q^(V2%ybK3)XeU?oXgFx7Vrp`@!AUYhUY*JQYYJ&FI(7H$%wdoK}!P
z#b|k#+{!<}UyXtnSO7B71%rd;r>}&%kk=j%-U*|^4Z;`8hZN3sqr3SnQ=zMDLi`kE
zV>LdrzJ2{_`73YXJyx_0FBNLI;-jy@4N}~r_tv2<Yw44lj%ThfWhP4*qY1bGgYNqO
z-+$o${AU$?V~4Ng=Av(}ecs2PdH0`r_lQ^VH*VbP{;gb2qnPHo-xjvczc(ZUkOw{t
zId@9Z>o(K>4%LT&rwJJ7n(A&)EO9$gqsvl2)f#`nWx_qV49*kE_sRdAod|e9@PH8?
z<(fZlPBm1W6}QRq@L&U9dB&=nclg0Cf`0^i4G3DWHgyENvrR8~s^0j>MZ%K$4g-+*
z=$>EkfDQA=q9FOWlm9k1co4P*@QwQ5lMV8I`;GzpCWkrJek%ZQ-oVR~dw>9G+VD;I
z*~d~MHHOe5)&JsW3NPSPZtZ-3|H2T2J${kByd~?F$^7f*dP)i1sRnnU4rmLn0fYE^
zE|>|>$H4^J5Cx412NcSsV9I~Ok(2%a&;<h|heLvqegg&_!|Vy6RB1qdz7o`XEn50N
z6^;ld0Ei@+2?bvKPON+*(S1{mRjljqL+0-<TKd=4v+lSdt~A%HmSTFBf?YJ&m=uA4
zw&&Kq3TQFVc$?6Cjx1vaUkoPT0U5sQy8pnK7;J$5AIqw*gmtAC-qQP%e4G)}Y1@CT
zd`3*<&(*<t_rzR;IfMBD1LCTxwLvd}KAXMsX6b$iuQqyyDY3pQFZkKJ#A{R%WtS4*
zO!9tFT^-(i=iTyZsQhP^d2Ja*G9oY}Aop&sUm4R4CD7K*=SfG~1Orln26xZ=E8(|Z
z8qGP&%}$_1XI5df<+A_6QUCx~fxsjntgtj(J3~+5Z49hA8w-v%-igl!u^;|B0$R5q
zu$IyM#l~O0AIdOBcc~#B*Z~f&H95hqH^N>{NRU!Gw~PXta&`eXzkI0j=I?*gkHhxh
z4b8l1LC5p<eE-2VL3mHY>;Oslf5SibjN^11-GQ`46rXcf6=O;TREQ}W8)k{qUnqdw
zkc)kM6=~@mr}PIc;#t(4kHCkfmxxK&zkLC;QdF$t#?ciV3FI9i^3&)FpGFWcZ)8+c
z-DroWQBjgCJb#2?$YB~Q4uLSkYb$ZSK677%qP7G&J{kjIuV&jeV<^Aif?)$_5=RFR
zG*Cm=kXH%>dQ(0#{yN6FuEt>4BhUjk{{_8Nikq{8<j&?l*RO(#?HP}6t6BB+ua|V+
zhCZ%O!9@5PrT)M}Wu_IuU(PoOxGy<~I_d}5F_6%#E%5jw)xuq01=`l~WqjJT@KLn=
z+hQk#b9?f^`unG}`8jDPTE^n-@IydDGLob0Cg1`OySx7H{1v^A*A+OR$S7Bz3<iaP
z7mOVY-~U{s;%%U7m*_&O<Fuo4$N%<Se3+Lsd=oc4Z0`QG^Ks)(;R**YA+!J0d@JR$
ziWHL!T4`Z<MjxHu|Ae}a0l+H1p6z3Uch3J__-bH+IuMW8@H8Y&zwlF`u!e_>0G%yJ
z0T2ZO8~~-DO!#{rfS^=5AW8bMr(3}KCj33{gBW}CpVpw_QI-F}3@|?ZOZo1A-x{d*
zyXL|!S_oe-^PUshMUe1)<i@MUJ@F6W0(P3=3_{{R5NS$d6eyLW@^M&cKMi4kK=1;8
zG2g@*fH0dE$M`AWZZU){t!r->@`KswiqsA8Mbu(ab>Z&AfbL5KdqPydG((+Retgv^
zfc!=yXW*xUZ^E`_+rz2&t@__h&z1sP-Uj{`(cu&FX5WXby>A)L=<pcxy0O=^GA;#p
zsS&=RT<F8PbkX<m@m2UOyg12pm+ytAQ%7Y$*$oFi_*zx}k~kp$3Mg^a|Na8mzIa;%
zjSlnD)RD<R@c<X7<;{x!f#W9xk&%b^r9QqA<zn>lKgC}6Zr&gvToZEBQqyUA;ap7s
zhQz&Ajwsw*M@`h3Mo#hhzv6i%d7yxg!492b;xBvodaCPRCr$nA?tUuH#^b|%@^Dj>
z7BbVIG4OOWAh^w5Uo15VZ?o}yddvpa**Kl(W{3L9P8Y^V@C4bxv;vohssH#Rjff2e
z0C)KAOlFp-7-<cY_`O=mh`$8>PRSV|206373MP*`gK~sY?R+yD9dWcmnk#h=CsF^`
z2+q<HKpG}A41_D5M=#f0Asq)j!UD$~HnDF;J`l(c@TCO985=ANAPlaP>U?;u#^)gT
z^|zZynivcbd_G=%=qO#v;;EZDU{=YE(u;Cf(5{obAQ7l%9Q@fBz4+DpKcCO>Ap&W;
zjUhol|NJ^ETtxUlME~RC!Jh~Rh<*)(Upo8~!_>{nW67Ky=`&_`&({-N2pCBB`^JW6
zeLo<^>`bIqPX7pZQUY$(9@F2*E%Z6$$Y7kg6|%SdZ&h5z*C;?NH&;fyOlSPotA=s#
zU;q9B*|59dg4dzGjRD*UqZ!$_g{2tbNB@$>@~B)nhtT?lM*ag{9_@eEKgpy}fUW{h
z8?s<As@T_tC81y-((s1>+?h!(*wN?w-P>o^!6e&Vd|jsgMk4Slx+nXpd|$7vS1&J<
zf-HO)7jM2$l&knHqN*O+)ps}J1@7M^GW@)l>o4n!7ru<tg;W4yYrnStfBY4_kNkZM
zW(bg=_;s%P4n-bbPkl>#6lOl0EPS)dyW(lnK~q}mEbn}q*UOhsN{f$zs@Gs~sn0(k
z$HLY_QIHA-H$Inwjyik)%_})V1M6Q4*9h6%hKFaEv3%9xz%KDIpYq4S;s39EZMz}|
ziW*=`Mp`kJf1wgI4C|VKgzm!$+<%jaz(moc9hgVs*NL_Z;y<j_+*}i3r4%D>*Qu!b
z$sO1O`qj;*UR(9-{(nE8;vpz$Prod&Sb&u_ZybwgW_O6;oFZWN4$q9-;b&ik>8Y6w
zt@)EsYY=JIk%#Ad;-M(zK*%T8uQdjFxAf<Kih#$LCGUOeWnjGW73Y}>Cm({Tkh<XL
z5o^KGMg-U2H;ecznI}Ngb{u2?&|@Oyq`!PrpW17VRIA{lqavd+*`w3o3lD~K;9)-u
z9-;2n|N6c4*WAddqMg?eCxkyGC9J=`Kh4z_y=U|Ih5Oyy+_d)*#n)pTL+GaADqBfi
zp&SxN@~as+a9#+d-_8q~-ZET#5%lYf+PF`7wA=jt!>-r=hj@Jr&H};P8_QPO#=JDX
zzx~#a8n0g`H74MfML);YWYoS|H?X`BN03z+f&qizlFe5Pc`Y+RC*YzO&Cnl5tY23?
z73U&0Yaqh`ym@}9r|!LC-v0!fQl|e7S~&%TtkI21G)jBF!88c=((Xo+gF2jOHaIi4
zI8I{w(Px|21kmy!IzU~k*E%hcVH=gNtFK~u;DdyE4U8Bt^gW1n2u&8u6D$Axd*&H^
z_*TTq8ezO`Bo7a}>l$n8f>>{nKnOoaDL~vAPWY&Obw9`;pC31kM0hFiNYUFea7lxQ
zcyk+r30>p}C5R}#Li>iHq9_Ir{t0E&xwlR}3arMNda_a`FS+nn&<JR-#OOvq6$GAM
zLt~J{NPS)R8XPPbFn_#hqxo!Z$6Odqd5;}T>TB#$z>xQiG=C3J5OI$F5Sa4}$sEvA
zHSvd626vN%<JW|{tfrw%ASfx78}ZBgk&K*IZV)*>nt)J3&Mck$K&wbY?L&az$4#$!
z5NdvxTk%@FD~vrCbLnE6`nC`>C;#E<resxzrCF~VzUs9YWJ+iM1U93dv%2^s)OZ`z
z^j~&vh{0mSKE3cqAr$w%Dplj)ao)#V)Uu!XI3b=|HfQmD^R01HQ_jchR3m>0S3b+_
zc#By4nqE!r`K`*OQTsjsMQZxZdwSGQ3C;1+X@&~5KM!^X4L6RkYTkoQNEitf$QTd!
zBePwPzJ~r<t$Zn_tPG&)@Pc*<JeXVtE)Xh!cYm#C-2L;cI68d%u+y>s#nK?LkvLnK
zM~<e&8yyxq-zsLDy^lxljO50L!Ghp`a)jf+;QXj02oIJ+S884poIsr)JFWO5j1(|B
z&?i1FIa7g*5~RRn1QN^eq<kK=pa7MWI@Ji0e@YB;wBQQDEatIdKIgMH#OvZ(*f7Hm
zM0v=ljQrS4;e{aVw9X^McnJmU|G@@21R>av(A*L1pXxar$dUd3GRz6^Tvv{k8xMvM
zj41~P!DlVc%SVI-Wv(TRf#*JY{u_#uTo+Cd3j>D|{5THYA<s-#1+kz@Vg*l5I&IeY
z-xn?MejQ&R;2dZc6Hnlx<)%BMNBw-<Y(zi!cX5jiE0*A%$w~+WfY9|o8n<%)=ehDu
z8BU{}<=~!mGpU_S>TR5yHsxZ<%f8CX&;GWqxMw@|`^Ro*HsB-jaqokqRw;NoI8p~k
z3Q50ZTuj_}W#1-3Y&%cE96I5LrkMNUwT4t8w;?WTDC;~wtqJSE>u{<xWLNU$Kw^r<
zf29p!=)Hg9C<hEfxWKn~t$Y?$X)4M?o@gvS<3D2=kCU64>w;Q@4*oe=?RbHGB?wU*
z#NKQp70&MZx5U<{TQ!~Y_t#n9;wyaALx=8GdzX`1itABaCpCSvW{c+WU%j;NgzOQD
z8yYBCu`px}cw%;RA+hzPUV;FZ9W}50W$<CR&7()@WDEv+{T<)dtDD1(GwSm7?}Vcw
zWkz%j?3@4))IDhEYldwgNEq9;IMH4nI(h#H@X98z0yZKz{Oq^k>kM>vuu8|ltjw$q
znlx6$z|qnn_^8ohl3CE$2oLys$}}<|Y&`9t%=$S|rk1D{KlrX`G|i1lTqisuV~d6I
zHqy^JI7!0gUzQR-*S=Wcui|{~@i0R3$iM&splm)QH<`TkfB-t<FzN-PCy?i9V;EL4
z2bcy#*sr^JHTZ#>zW3uT3R*QSAC0DAyfl>7ju~f&Xd$E!<RrG4*{5HRiw7%$dXcf=
z^rtO!Y-mfu9|YOinMCCy!kO9sf~{a9R|#~Hz#Czd>gaEG6BWgLa7<!U{1Ec5+?adU
z(NSl7?qB7-{wtk}bNb?>Q-YZ@XZV`;%fnGNX#Me!N{TrK<1{7&1wf{0)i1^*AP50}
zBp$NO)jMj}HB1YXkFF%V-aIgTXLiRzB7<`6CN`Tuzez7%laGx}N3Lw5k&OJD(e_-)
z!5tXKmv5TVUxGfXS^Mh6iPiVZ^SZt#YLY!h_l`z?1bVYR5l6ufo@@)jENS;ac-U0s
z_b4Pj!$0d4o!xO#!=;_|!EE=)7$Lc9e`7E|y_Fqv^}!TqdO)jbrQt~#ZGg}jrP4(q
ziVjpmYLOBkWoN-eqNq-0lxz?tJ;#lY0=NO^92Q*B(9vc}U7=ayBFZu3+Dt%+V0c&L
z#JNPnaQ+AN#cW;~Q!3D3{1Q*^{o(;W5imymWm5IchLp-BGs{k#$I({=`j=Iqg^6p1
zwKC2kukv>@J`uijgY@gd%Ks1MOj#Zg;w#t$WCTzp8Bg)Cu|=6T!4%<SQ^&p)qYUFY
zjUxa8OtdeIGl!czXA5UzDfXwzeDHua+7;j6m$}ID&~KgbG&&c%y>T-!GZU{m^~d#A
z?c2AV^SNZWCx)FZI+=^QX1<%NjL5`{G3z4}shv)>iC+j`1ks+y{tx^g`byzxz!j)~
z2RjD<T@f;{a0IAC$MA3$L`;8w4NSkp(#&TW6I2D}z3Ytg<>oTLN&*z)upCN(5JSI$
zuNf>mf(6i{Vn&-jdf~MGuq2&#IGgX=#uI{=F>CMER(p@wvsTTjS#9l#qE-m8)%qIM
z8a1nG&(hZ3s!G)=N<xiNBvb{Fy!jpPANlt=avb+_KlgoI*Lj{F_9og#^qR7aE7FfW
zf&G218>r;J5q<ZA<Dj*UN<~!eyoJ(UkZi@y5o1e!*9WKJeUf2wkr6%pQ3!D8%A9E(
zo^hqIy??s#ddq8&(0Ov|r)y~{amjS;)-BrT?+(}a<-6#|3^cZt$aON;Nlxt|Y)z8>
z>ZHVr48Q->I>5nLMUSXvcD@I*0PI$Ih?^$8n_I1}FuZ8_+JCEJVeQl{rXmc$1{@z9
z<b(iSn0r_*94jQbA)K;ZAe^dWr57WIRgptBb$Usi{N##O8*5nuyun0tY&ODI;8S07
zgn@%1a+LA8`etYPuW#Zn@zPcE>UGl_zRs7U2k9$c{EEV!BQ}&VpUq>YIDtS_85WWI
zct=@){<F&N4uT9o-`1Jl^l>`pjUN{WxJPASqejze31sbSl01~L(#IJ6iQaTnk!nFR
zdEAm-!LzlBqr*#HhVZXvgKXEFCXQscSY=}30PcgzOjw7|{|ZFTr|1VwRvT~MNZ5G6
zo>ik*rYIT{+yY}ax--y1GotsSHZGH%%Vkgd;RPzZjsZ8IQ>UABkAlo4nn>a74W<At
z`yGa2XT3SOU&UZ7JcjGNSGW&0*tT^3HJM8gs1KDU0^l(iIAbtImwOyYt-m6|;~8(w
z%?`52yy@9Yq+mj6pCU`soId&>9dHi+U<m^|^n<*%S=5q5k-tlzRrvtV{MWHW&T-@R
zVB0{6o3|n+;u#k>{-bpfty^6hcNV!N@w&dSesc66;LD~4{+6#+lM_y`ENn4`Asmnw
zmeNSF;+&njN;U;xMnb~*H6x7T^K%A0XPL_M<4TQK-C3mm2qitoBdEu6V)6&O&Ku}{
z$I=A3D$~Wq?R(tMrg!V)Kfc<T{zXSJb5;O7vu{RQ=De66X=tKpD$HMbMFn+~AD_`0
z7GFc4)fdBj3DlC6tr+81&-U)X4L@u3z|?R;pKA=6ao3u_e=w;Z4>S@iiWra*iZD3W
z(*q5>NdpuR>|?4F2ixPhO(Yx>@{m5d@jg4t+U;QO?LMc$E~H>bZ~Q(Q%ov3Ez5(6Z
z^Nve8CjVo!3DG~%9{7`Qj-+Gi88-xd#65!8)hflsAN*7On%BSCDNKV(-15nN$FCT=
z#6NCidGeQ*LBFZI$BM3Zoih?PKYT-8cnSMo@7}H9JlU;5B4XmgX_MMsKo@^@qW9Q8
z0leqkL^;I)kZa;DcUSe0Lyw{AP_KV}dUjZP+6x=A9%c|v*q#|`KlyFH(U*(s1$+-s
z5>#nEi%MI($>Id?WPnKer6qFjB9I>=BZFUC!8-CHR>4XRA5JqwK@>w7nym@$eUYy)
zColwd&K2YV*fSY6iT`UewBO7k{tqlgy~X%*&L@D5gFi_$F_e$2aUdR&{xVRNL^!Da
z#JeGtl)>^5Rm9!ZZ>FnfM1zjlGjn>p#X-gCb3mfGquT$QKrhCB?c-EYkqH_P6Qtty
zyOOY&#eKB(f0D=f<6QghMN<LZ(D}^v^vPCmed3w(l6ETx$>(@@b`|+(Mq>%|AK~|>
z<k%<v8>shD0{#Y*_lDpkwoyI6F6=mg28|!kaq`MakGacD*GrZe8mmxWFnGI2A2*c~
zdiUZ$KAHK{_;TU-@u@8zt#8M1VGVcO{XX{B&&a!+hs6eqiOGH@`A6e)Z-a?R|ERbW
z89qmAd45>SWYt)@9!@Jm(W>LE!r-%*lF+TQi0N$5Y~1AIh!-Ahb5>tsek*95c%-##
zj1V+66oO||$?}pEj36v9lt@tA^(Fjb=`q?V`P*bNyzdiq(j;N+gT_*Dj?XVn=%8pu
z20KnVM;qb0)ji8WVWKK~0}cBcB3qDj+NY`*gi9L+nk7m$rr0gvnXyG7Mhpvvt4B<*
zmu?uG1qt8?V$bcWju8GY87Kt+USa{sB}LN`m|v(kg>(j_I_}BOOEO(U0-1bIvFSMx
z&-hmaro$_QG3TMAd8HNk={IFKuJ*yJTw4v+53DQb>p{R*4*IPJj0fwzW#Q6FLnoE-
z_?L(fj#)rv3_XK_*Z;B)pu^aw>N<UYq*Ut~@5mA)T^s;jzO|8vAH|(VFXi!ly3!Lb
zB2v|csU|eXdsLoUN>2JNX2#)fl`smvAv!T-z4VNwZPp#~@YYcmqBOKu8%IVzyspd{
z2*c!Sr!VOLw#oQnl)KwU{gf~+RJp;j<L}~;cd#(U$71I<rY6c>U8Memz`S!J9XV6@
z@E6~CW)Jg5q)(qvvmW)`a9^f5xS)%x<Ms~f`THJ}XmSTx)~oHr{$t{p(^0WvXE~Q#
zP966?E`C@KV_5NJb%T1C`RjTrOxKuVo(4#t7{Xte-FQ$R(1;VN`{R@{^KAoF#Zhu>
zkXTF$NuUvf@x`0G_;c$->`T$X`PxWI8DbDr9w*Ny%Llu#7|@F6bN<aKp_+k6-s8%*
z<XYdB#5M;Zp)8(jg3cq&BO@7GjoC^&{q!7f7(oxbss;jMQ)$}5aUyZqOMF*tk!zDT
zt<^qV26{)KUJP64U)|Lp1EW2s(1ezd2?&21*h)V9?Z`*)i~j8PyBF9<qcP5#BgsRe
zE0l()$_LbA5=sNlF}%a^*V#!S6raI8s?=rt1l~u(CzrsC1cTx}I<eL<Bm|Q85$AR%
zG86YHBS)5#(d>ro;PXL4fbY%B1fg5xxpEjA-vnzqwbsOOFI0VIp2SoiNJQ=v%W|Z8
zGb8nT*qq@@Te1E=3nOR(&9^%P0ImR#FpLraIBZ59i8tfrv=amDHJ7N26dCz5pI!x)
zjc)IW_+rLQiti*Z3lRf5axvLish(Ra|26A1c7Mt>817SEsHsSQtT)$nnHIhLtQAk>
zfc2)I4c!=i|FT0^fZ2;_*^fLQD#dv1@oWPx^J>XskwBQ<dmD|a`&JY0nZ}Y}H=?uN
z+^Yj(QVG&p7}OT^6V=H+JPnc*(w#RvRW|v4Oy1e?`kCED#1&RF$#i%@&!#31>1Pgz
z-p;!@%piJK)rQ#A=%V1vZ6QWP%(@!eLN|_=23bc~0IL<O{PatZ$vP4(t1zPm@xGzB
zE7qQmdHHd+FEo3x$5+<AT*a%I)XKLP77OMyPTlDxfP-fT+!3D^KlJFoW;qEwQYa?n
zo53He$TT|AZwm#i>62O)BtrrXKCM;I?5#5cgMOJbXA;$j8TgI2_U((%??Iy{-U>Gm
z>UA3FA^pR)Kvhq6iLvAZe**0ur&T-bBIgd6Y+wl&-g?=BDe2V7T`bHKQ==U0r^nW$
z&MOx|iHW~u)lebZbOh#8U#Th@ayzbGe>J5cu12N_x%Z~E=3(m_M}HFs+;%I=E>8Og
z-I9cJZ*QFl|I3SISwS3+uV?O_kZX*F#fltiVU?mr$e_HIzg26k;s<)wulqm{<J~5k
z%I<fs`=MhQ!3_8RhSwT3%YayI_-EghL>&s}sT19$sL4|qx@R<jgw!3f)oXEo*g$|a
zLt~|9m05Q9E&$Fp<!+Ea3@K1=Kcy;3kURSVXPO8SfB6z_WfI}>QpW*6TVAn%AO#pR
z=W!t}BIRDGk&OPg+qSk7wffgNb{KK`#@q@5ro8}c+|RS6K4)RQB(y~Iy*KC3c5TzQ
z*KV=?Z`GSYKb6}asAvkp^Utd4pKrn=DbiI75l+>pngllDYl<q7iOVuHgFUMRQ$@{P
zwh`OulgNu_AUR3QpXA2&aE}~%M+dK5B2HxMR#?S&^!^}!1#PN**@(;_Z=I92JhT9~
zJe#7=&GT&2>sub%1HANI){0pnK5D0s{(bI0YsLb@1m~xz41y$rhI=MYi?R=TY#+c2
z6kF2f-zD&L>N489^Rl?3BQsl*l@ER1!psuR2&!Hf-HbIY?_?SHwlc7f(|jT>h*1|v
z9VtkliUSxZH#yevcK%&R<m3NJWE%o!BsQp~uV14Z+k(j`55zI?JXk1W5Ia_V0GNXr
zfi@R1(#Q??AV90oWfhzdc0lw>{o6b!+a=OqdV3pH^pKpJLEzTY@bAyC%y*(@4FcG?
zWu0^h)kW(Kxf{}ZvpP}q@u_!YnKdDYZ^~Zf^jgONcE}t;lSdO6-rmP+bwR3FIc8N~
z$;$M56~&7?J-j(${?8QLS&4mWQqZhz&Bcyv82fJYTocVS#7kDg``VDY+6@fJP8O4I
zWnisH#RlpN28&I6hq^d4yIL1q5<ZAOCa64LZSfi)j13qw*7GyBe=O+uA2iSnC-_4o
z<csF=T3H%Sw7vEH!PMqcnFY{8KFda2k#L3H``_1ou}>b{zzcqaotSCcKPh7WAh^xc
zbM?P@-M(<HN&#uoGw0CP*O|C<R>V&bot<w^Op^gQ6{<IN4l%EvoY?rIpA13FZjorF
z<q4&MH*)Qnzmtj-uVn&F<JcXl$sMD>jJObR-~gFI%u*N;IZQ8b-R)_3#k5NZ$RSlW
zbAG7jbb-8m)IARw?aRxmOccwGWS>Xxx~EPRm}pQPb=XFsF?|Dq&wFuGHF0eyMqf5#
z0?pR;8>)Pm1_N@}8l^V(5lc6Nq#>u#f-k`0|E8A(Y(1+MxRL+hzjz*YycLRjP9M*z
z_x{-GJ#Mk%a!1`9R!NYfZ>)k6H^Xq`-E&}ZPKNh(ufn=Z-)pF*iH!6Kr;R{<<O|Sx
zyiVW_;367%3|x4lt6!oxKXhdaoO9)!o=x>`IDYLM)MkEvnA(|L7k^`V7{)(N7^HPZ
zygo*9M-%xl*H||)tq;)|##I*s|IGvzl~eVwn4HN7mBr`+?rq)Cu{$2*O-o2Yv|_e_
zpVfOM%F!Avn?gNM7dBjM1b6PZsP&}T{cLtVR!uSi0R}^U1~YG}hkmy>hbD~)ZVHm8
z)^ZE(Q|&w5f{ie^fieldVtl9|-Vb6Ge<?62_iiFm%S)Wnk%-h_{2VnD%-Ant(COm(
zD&;TTN`K;;zMtw)X!J*FSn~Gef!#skh1@Ou4d=^+vS7`%2B*^9g%i7WJhS<`xu|2i
zf|ENObgw@(@LcAWeeDN1OG+*crcAi<QZgzKOSheFiIOrPM7Vghcn^vcfPe7|4JAwu
zWJwwJnm#(7E!Z=+_D~wdKH4`T$(x^;*lUId4d7z$_YbuQ?5|`4mGZP-)P3QnOd*nb
z8B~MpIyb>H;bVA8Q9rY@@6^w}olmJ|A8{;0o^d*{U7B8Eb9^5smbI}I9&3@nk}03`
z^K`5n$znESLflg(21qpde-u6&pvF!s-m&J)t)4ak4`p~IEx~kz65vUm#s~I%qeYyf
z-m^M2J<!!;TI9V(+<Oo<XqiIy^KgW0rec=P@LDUb%%vWNT<(+VQy8PjAwOHd&&98W
zU*26sajW;fJxlW0Cgjp2hwRBvJR_r&uy^$d#Pq1ABL;kE6pQD5#zt0&^q2W&4C>Kz
zUw4VaPu1eTY4e1h6H~V`6Ve{9CUfv7?}Ay$)vdtAzgUQQQvLM5UccoWK9zCx-zlHv
z%<I=Oz9OP|G=Mb>$j^){sbI_k@s@PI)HDHnnf>D0h3PDuuaRl0x0$oX<gzBrbiQk5
zacO<BCN<`PN?AnXhx0NUo?QIucA50lWMESGR0aFD3%NH3#UJ6UjuBVh7@K5Ihy!EP
zhnagD(6i>m$YhC+SxE)f;xK{X|7U_05`k5mrkCg>c7kM$?GM>>O~Z!Hul-2puKDt~
zTXZzvqO9TUPIT!!{P7~Wj~VZyK4q>?m;NHjkv5hbhdxx6a>OY7DK$O3KG~lg(2tNV
zNw<?jQQ*G2jE|Xwdw8vlfQZhzS895J_urQh=74g>T<YN4EN(MH8^6K_td^>IkF~9g
z6~8dBcr-#!9%oQv2{#6;nU9u|%BX)cyuV}+9py3N-b%@|+0J24-Mo$1C4e6rTApI>
zX)jaUZ$0)*m{0iv#@GvjCvMS``^T>-cf|5D*=a6kBO&yo6@%_lj=1iJXakVNI_C!8
z@wo9#*R0(^1_tc;46zxBfQ(AUx%N3MoNsx~#O8$e-NHBmSo`W$h%1`<%CRyg_@x&D
z{ofR={mbZWIKF+IZy{}3620X50nTr*fJKD9A>U)+<?o%#2${qN_SQF-Va<Psd$Wh{
z=Bg&tDopvg6X@hqyahXI=@WOGFVA55;%k~I#8k_JU)5&I_#1n4zN5MwvC1+OCr&5c
zsb_ZdpWHN@18*y$)(x2tJ__fi*r$nPp>&qiBZUL{LP#X9V{PnxuMfB6+&3VPT6xr3
z8$Eend?Fr@fUu<V)?Kk8CETv&Ru6|RMXp!?FUjPOAG(dMC+FpmH5dE+Jq9t!SABr~
zaWJ-@bL*8QrF_V3Aur)Xt7~UV^)(;3lIcGiq!?RpbZ^Kb21<`6n+TD;hs)G)W5DGq
zFLVsun7wcV<;@~V35KWfw>b|9${vc8>0s`m)nw87$x!m9L>(SjWDe*31SFt5a&Q2F
z?FY(N$6fkD&Mmvfe|w8BBteG7badRCa?h=PnizQi)t6@!q0h0|DV>Xv5R`-Lf1h-f
zb1{@w>*M%4SN+LvRy*C1P!~~R%|sKn+-9z9W&~Ei$`OP`X>dX`#fWd7l@X_eN@P>I
z6Q9B?=2O97qS4_Y|JkpmYSCs8|BlSk&}-FHfETCx+skFo!>Qa)<K-L_oz0!G-GI+O
z;RhwJhexQ^Wsp-$@2NugsE>tSwJ4N}CH%JiKAe}HZI1dXHJ7}fSmsEZoiF8S9`R^u
z&xkcc8*kq$u9ZERS8>`;Vx9gjW53y6foIxZ`M^Z#v06Iptzap!uk{?&hu|;T(U*%c
zOCr+WNl;%jTQ)IKb=ilXhkqk8zDon|p8aSlHn97!j9Z{IZVXAdQuTNfdV}2h<{vOk
z0W4btfw%CW@A(3Gn<+zWEt#|Vn1M$&6z&=}j86OY;?BOTZWnRO;cU>=(QhI?i35}7
zK&8lOi~jt(jRb=n)Q*vG0_qB>b;SV-hhSgCT1uD}kUC3499)3+>NJ{@Ce=QQ_Hl;7
zF5BZNKKb$7KIK9Yaarw$!1gLVz-9UU8U9(N(+s8|3Fr`i9Pfc$Lcz*v$k)N_7}aSs
z`%F#t(MJ6XvHlH+LoJI^1cFdi{HlvzpYGdx!vNaP6W|*xT_{BFgA3c66|WXiPT&Wc
z#w7MKX^4|O!oo`-%$(uKhN60MxdHX!2Y85(=CXJQ1EXE-c}i)lsqSpSRFt;B$0lJc
zM>Yz{gt-akpBXX2@p_>cd;dTQ9%;`U%Hwq7njXB=^mY`hI6zJVMSz^wIRRaeZ~$HA
z2IO@r?r%A<gG%92cTiSVh!$<)cKv~SKibPC+!fG3eM6hHK$9h3M!QeEr(#_{|ErXt
zKjT$!A<@(~Lj6;Jy{?%V4{iLZZjS5iNV5r5&6%1WhhA+i&^p#_ulGsT)hJ43j8JXQ
zex?uNoNgRBvH18%`wdzn+QjOi8@MIG#E(KB{06J7D8(<pI_W*gn?KIEG<4strO1uM
z2cnG`qa)zNs)sWSB4Sxy;2zlBxv*|(n3<LNwsBOC6MiKRKg8U7Wft}4J$S}@{7b_?
zTv+Arqzl6Mud1;pIERF%J=Fzl%^YIZ4hJ5*=6<ue|AlbpnG$bCg;hfbH9-Y+0;uA+
zV9v!s&hseaejGNP03*(Pz{(qAv!mbkL_FMBf$wW?l^mq}Y0Uw$h$gvKl5>J7d^`J8
z>D;K-m5)nLFG%UuP;Jre%nnjy$q*^yja-|MwWcG20sZ-yji=Np$A?!TWd1!3=?lBs
zeS&~u-u&TAl%;g28}Am{=HdVO-3lyVf`_8^8K_4C!J^l)x2a`KKD96t)ENg3zd?@g
zkkAH<RBbYm{4PMgzdf6+b?>4X8c*Uj2Iv#shxJ){Z@SJKwDJo|;d3;Da#sR!PjH*e
z`)7;Ixvq03Q=J!~FDx&F!VI?RokhPRhC8diWC9I-BvOvG)3t>Y*#e&}xhOn|D4EO7
zk5#wFWi_A7jj^~tTVk2i_RYDvoHrH?$6hwyq_K!@5>gEI5uj7eF#v(RnBQ*7unMlv
zMQ`svyuQC#{k_g(-rQpv8`xTIGj<m<Lv12kNAX5%(n#O8@EDm9imupEk~78$=R#8!
zB~U{;Iw{<s007_}xowz4RU)v8$o+tu*@!95*JIEvjg%2@-g<|I4nDbM;WesW(PH8U
z#k<VvJj>wvU@3Ee%2P#Jw;N5ty%TSoE>->h!cLVQ4(P3S(bLjEo%PAJkv(1#bx6qW
zHlJDskW*ZDMp^A3lDiFlmaZQBHT_AXd7>T)UP{0uGaSgXJf4gi4&sP$)2=Vqn92gX
zwV#GiZ;-?(pTk>0xHzjJxr9G_a3VHj>%Iltn1!uVMHYH4KxTYtb=0I8dnB(E*;mVW
zS`tyn5H_<*Xii)M2wWbMa7^Gh;vj{9NHo+AX_dPoP)p*xUZKGE)gNh{BMq-*F7bAQ
zJ+g$qs>&oK<qwg2fd0i<zLE&>Z?Xe?^ApeLDE{`7JZ~s{5Euo69J$RR;Dub7#|d^a
zVVJd~&pmPTadvy3i$m-to0>7k773-o><i0*1Kdlw*`B!{aFH}Se0m?QLWZ}|n)CjX
zc_;U$>Jtxl>qyX06PT3j2laLo-PHk$)^VLV(gkL{=6uWHGx;NojmYUP;&lUNKRi|#
zx$<S)ZvAWP+jZf{1@l4HSAXD4yVKc7-+yaA)wo8_{Gg{!fl4kH5yn;SXth>yepLzJ
zP1WUi$F1t!n`LE_Rxa+3pKg7pW0av&q(C7D8p(y2i<a)q-|;3U;ypJ_y1Wk-21QiD
z<IFb$gA-1rtICzL-x!8q8aIY+Q%(b=lr*vl{LLgj(kxRVMTCI4Zn@#;^5o!i21Q4Y
zVFK@GdNF6R3i0?5N_rlkXueOyhC5E6WD!;dgsq_W&ebcY(etO>_1IU08#<7yr6<N;
z_vF%=-iQCA(Antszko(<UC`501Q)NM*;>3^;jjPffgc3Dh$YIv1~Y!Hr;L^oIx+T;
zPGMu3JBiEuy&+USBiSCzZUYnRK_lzK!?A{N+5-^1xAq+Z=giqgn6(Wl;_;&GVSLB~
zi?Ph=tk=99Yl5hH@;AC=puOxK$hsRy{rZasaW~EzLA;>a$c{;Bdg2hr8iuGiiyrr(
z0eC&Svf2S!?U83@+OBs`zQqAPEf9afmE|)anGPHDyrxt`v!)oj_eIniO^iy&ocXJ*
zlx$C&P^-`@eSBb^5$$u&iO0z}we9j0RY^`(MR7R?hS@#Nu!{HQiF|qyC23}5=pKYr
z%?&%#hrQHI$`MO!c2#KBdymx<pi<LwsbMP47ydaqrqi2zmONiC#@Lc_-HEipL)z4t
z)`GYmsR9HpTQOs{?h&?L$%S>i1LmQmd69GP2G2t#K6e=b0oF2JXNNN7uu<G+COgLp
z|3>ehrw>oCnuQxvy%wZEY1^|K8t7WfEoDM2Ga=|~db==1u;X=AobV<|p@ezOkz$vn
z<v3{k0-P;FLWMiG-QNsPrkin_8T7vO){NJ*^5yIc3{6F$J8vcr<Rc0-E6kvPtKl64
z%mYQyyfr|9PY)q2F=X*$E4UD&;4$C=Gdd@-57<6~7Z<w?(vujG@hD*_zR|(rtVwj|
zPx{l;@?xV|^y5|JF#|F#)}=e)nCF3C)7f&g>mI}Vvk2jZskm`>pO6*WqhpgRTehLT
z70#5LK8%79Z?7^6lX>QoLu$08eTM<46Ec$|J>=NGCq5xmYJa)B)AJfJ#44Pxx2b7#
zkeYQ7)Eo5TYExTyL}tvWr~aG#LL`JMF2m_Awql-z8>5*@9TVTRAiQOy9{{5r>P%n+
z_gV)XZvUa4L-b!55h!OPp2bjdlvOp+Xg=m+?$QxE*S3-k+qi2LOpQ4PU2RMVy^f~?
z+&690m@nk=ehs`pTR?wlUnftJFRck-n@RIecL7cL!W#NH7slue$6f4CP4@AwAH2W}
zIvEEt2k^sj{QETbpDOufDPE&BlaTnKLc!GQ7HK7kP|v<4y!hh}-wuY>yKj_aeiYgJ
zuIm$xm(&v27nqli`&v)7f2v9%;)V8^&dlmR;D+Ang?DuH`XAiI-Z+0hXBv@S{VA6}
zukNC=P>y{%59T^Pg&-a0>6XkXl3~`ZuMmUA+)}bn6M->%dd)>C8b0Cgx-;Ax4fQx)
zH)G7-pLkj3;Xk&^B0tm^s-;6i(t4rF0ldmhYM6ZW_`T{d9nA>#dOwLW+VRKs16rvQ
zIVAuZOpp))d7p16gS{#x8-4ygXg$o>rpaV6v^}T~fzj=#FP0e2m%FE#0KrM+=MMn9
zX>!`ar32I})*F~;foVFbv=B%z+oz0KpNR@kPp<XAnHcIsOn0~wL0~H9v@<iTO&54*
zmamL-BGQCX%6`j8vUu}yxe<WH__*;nE9tN#^SIM3qbF|g)+LWVlZ_^V))mThw$P@7
z6Mb$7%-j9z2KZKs9r?=7-~7DY>hH<1RQqSX&wkA0==eZBHYx4&C~9G@lM+JTCW~J9
z;&m5~e4u@eUjlcIYN>v+n-0_U%~QJgQXMCGYNVT(Ec$K}fjXi=9f(SQ*a_}gxU?YN
zq??h*-`A1^*$mwJh;JM*8i;zC`uaGn_+#<6(^#g~AUOVIS+XpCktO1{erB%zg|$vB
zNw_$tgT#2?9QEj>9;Q0wdnB&Gy$=4s!%m8ylina>ojZfFpZs(MO#T7yzvcJ29-!U7
z1}*_h5zJOZzu>xxX*bBGs64sbzqox^Z1Jxk9$9PbRX=*V=;VEsNCpJ~ydyB4k`?vw
z1@4`R7kS<9v9au}8i@k3l)HEh3pD_ci-BA=`0obYIB+ojyTJJPME(^nE#%EZ?#J%5
zUlnsLqyHlLW`c}~)8jyks&!hqp4GeJigXV{_KjJ{BjLha^er@CIOOGv1OY(#KV%9T
zw299tmuvf4hO`_QA2%d`ea;U^QTG?`-y%MMMY6ejWBfNS-;O;!i^N_3iJ1Jgnd-5(
z$SK91td^Tal~A-*Nq&&n$k6}wK)pGS>jPd|2if;l`<v68ZS5<fi(A{KtD;O)Q>Q@Y
z=vi}7`tJx!HL`7c1Y7;Zymlv?aryHlHNnk^tzd}fM_^O%^ZV$MZ0-Fb5CR`mx0A`h
zmu$<=@H8qdgNW<r5f>SAMuadvT}9;$lY;Kx>_)^tV}opQ>8aBMWiw}AJ1W55OE4vw
z*y16C#+FYT*DVy;|JODFFZfLaH4q?HI1XAt+q&{2_mlsNwyb%%%raodo06-^1HsGL
z`Ncai1L?Cn(OCz0c28V#4#0<H`gg2CTc&_4&%02Ed^w8IH(;jo5@1AaBq>-0$@4J?
zcQa1|ACrknR;TSD<9M|ML7oqRhtz5C;(_a#(VaAZ2MRBd#Ivm9r$j3O-66^4dl9Nr
z0sm^L4h<*2oa^Ct2aULX#Y+102F4!0gsK;5e^uo6eG>OCl$OqYe^VR$56gff1Ky|Z
z&->^`BOFi^UV>y!zro%zqQ})L;x~Go>9DOwS1xrJE9#!g%(#V$JH#*{GVottWcuhB
z*y2vG?ox9MOvRZ-Enk_Q|7Mrf_@k$P2yC7ldEVK8Lg;+HSXF%buZS^N$Z%Sg=^$<i
zd$|qFS<-99t_eN(G3EwpyS=-o_eru>h9Jb{G{Kkvm5tD}c3*7uH|b#wDI(+BLUVFZ
zD11YUA6AJ{(&d+j;JqIJvfc7lZVu3>_xpsq$wDWf8z%ClSWaH21-lqrtP_<)D2UG^
zC2eLs*J_W7&?j6{wAnZ|x|_VrP1-v$1IwRvhcn#gVIvG>c!S6)Yde>lsBl{Lw3aLp
z(7<?&w8Fk0PH3i$x(4@n%R2}IspeI#d`r-dY*99#Gb@tLWD8IL-JpJ{_zjX;^=N-c
zrE4DzGnK6!P;Ft@0DY3L{sH|ZS(GGyJ}v8!8E**G;ZJNMNL?Ltr!B_puCrPf(@$A(
z923)an^<s5L|O||!vHGrvBIRe?2Dhfj#!PMCz|I0X>ieRg;bnM*=V(w@m->SE@!gu
zRB&Y--DQ4*@5nXFB0A@Y)t@X85U9K-ulYgn9E&p0M`K2w>DIN2kAW9~O!ts8>Xuw(
z1SYw%gAX?<gMPIHNi?(H*-`%iKSR^Tx^GFNe?LQ7!7-4mflQ!E#tj)c-vgZ<t#WUk
zn9qvb3ONB>HOfyUZb%b^bp-#`(za82xu|U?tC9rLw?0ojUBWIhPPj2lDGbn#T^7l~
zBAj#N+@}KpCQS+0_V6q@9UCfZsT5*Kud1Lk;Ei}=?n7GlxCU#m{J|`3-rK82ZhA0#
z@sdjMMFUvzIm$ntX$z6am-SU%p{brSqa=&z=hb%sWdMrT_XN#S;7^1+xb0SG+O<e^
zfAU#s&!46c{TQ*v$IsWn)0?@`TDBeeV~Eku**qB;ve_Z}n>EY9{YwtSq?1OUC{8Z;
zs~MSB=s#-*Y}2T!7<48;N2@+I52oU8N|XiTzjeyBuBg1@_<Z*ob2hF{96QO-Wl~hx
z2d88*G9cD-(5KB@bq&N({|nP255u~m^O-n#1uANu3nG$p_(Xn-!c>2NxD6x3zXOn0
zxTp?M85?Qon4$CKOUFKgw0Yo1jNTr&IvO6c6(qL&8ts;=`)Xq?>OCb#sm0Z=@sVtd
zO;*>QrELNS#T~J$CJp^UFTId93#xXU&`;yB#l9P5a<bev$zP<C>cD*OCALi)GM$8q
zWSe_9p^~S6kr$*qc1j608tQ*d&8Ie52LBb#j62^WSpy=-f(Auw$b)2%T$2&)$J%@Q
zl@Y05#UgzDRdQZJ&@pvJauJX9T)#R!cE^bvd082n2lfeZB&1Y)IV5ztPQGX-0ZFEU
z?(zq_IF{K~s=rflZu(!`re(ka%>I#-xYaN26p0zRq3+u=CC?y$k2rTrYxz?E(6vRQ
zvKgN{g)3TecI!QRryAAMFlX@Q1J@}V87CBVheAqCV~cmTf9M~XZfnW6DUDh6#>}`*
z;%y`5WZb1<YSq`pRap;c((ha7zqi}~Z0K&p#@4g!)_1&h(^Ce8927o$J#=KfnUt8X
z0!(Nk*~njzD_0$qqO00~dKPv}2T4E`nf)txrY(Wwgt(0G;$<dMeQ3#3-R?_Nma~Zs
zg72S59tpLmgxtiw2kGCN;sH>3PEH2gjw*G+jxS-i4FBNe5d5@1YW`B*wi?g9%|FzZ
zNalI-37FaVk3Pe9A}Zl3l@1NCr)S8;Gz|_cvZzTQF!nE=?8YTF-nBZufPLcb;^fiN
z=d;rPiVKM&S0`$#v<P@8#7ekN$nbtL?abrdn^CaW0#pHb_KoFb-X1ky^JoqP800=Q
z$8}GNd+;xW5TMMM%{wUR4FG=qV)LY5cr5SkYOVaaCa}Bag{PE(JBa_aZno8Z6>B8{
zwWt>(h8U*sb1foXNo(xvNc++W(r*_b_CIQ^Or7kVv-{+E^IgGmaK^*=O-2m+4Tes0
za9GBD77EVDxJs>*STY&(m2M@Y-u^$ECB!N}IHWf7e7}eKVpQSN7!^P-d=H}emtF(L
zZ3M~q`VgoA_rFG~$G|J{zXQSiUkiiZSJs@-Z$!!r?n%hC=<vRXlNpqv?khS(J+F`L
zhcQMCgvCtqf0=z`HFK^_?RgAICb)w`MMcU{VCBBUz-u?0Ox^2Z!HVbARfY^J$#2;=
zsPE0!!3os6ddPeSonNVKxcmQQGu-@2>9{EGbw2Fu@A^N^sG-XjkyIZ|`Lbg@mD5Ge
zSBR4>KvH*bu)@Yet)*0cnqLu7tk)4a*KRzb;Y2v2eFxnTtupur6OgiNu4q=U?bAH*
zMSWh;kdR3r<8Gd2fE%?!v<h5>LE4x%_$QQm@b=Hsv41fS>>WwY2kFlH_8n_&1lyAn
zyARqCQompP_l2->wJFxw^sb7uv92z=re&<opOwmpa?M;Q%qRAPRQwU?Ev)FfaR4*d
zJC-u^u;kt8fT>OdG9W&#oY?^MYi4QG-&7J2)<0@{pItc*8EwQ?QLU5C>|bq&IpPQx
zqXH;WB01R^x=*dD&~dNIh^X}35R<q~sB;r*wK5;8DvREv?i&$DDf>zir)k+o_Lq6a
z?GUZBA+mDmPJWzV;vZi0UrXxYm6jFB%5vpp;Y517inzASdL)tEE1-gGAWr(gBbN82
zVXlBTedRj>M?n~wO~MBB)N4xwN^R^v4^>XeQK3^mj&^f<#;nH{?asdJnQ!n#Dn0p`
zCR=zleKl6+OnKSHPStl$n{7B&He{u!ZWe*84a#0k^p!m!17lVMo*ShLT)=M(=Ptp0
z*y!s{aKbr3ParSQ)qKj-TYbvqD+AjSb`<oV0rRc%;Js+?`54h3QTu1ZHdXx2O+@r1
zgx=~cYt0x^)RU>pr!HGl<ph@D*9WW+(4`$&qI$-;ccKmFQCT5emTGgB-)l81H7o0j
z8di`Yu>UC6KdO4?OA+@nO4ei8NImbMe)A0Rx@CTkL*OrQP&z#-<k2s6d~T}qQWeJC
zBjCZ!E9Fw_n_GqmOkWBwk6>+ekfFY=8Bx2GAE~{zL92bbFNu^i?_+@hh7bCViNs5_
zz3kl$5}6~spzuN-zE=GBi=&8T87i-cFaN4f(!L<RUAY$T?zoNRS*)JgtmnBE1wMSr
z4_<X87w=~C<@%<WjkExEcv2!hdVd=_Rskt6Ml4#x?`Wsz5v(vJZ-sTHC?8V45mnrG
zqI*W(q(bh?%&nZB{>DSimy6q~10VtUK6q(`X;4l!YVrIw^hJA|-ixYD^rE|;UtdR(
z^)2eXw$R^tQ{k79if^-@zi*k7Rv!C}NNKpI2jm7Y1aPr_p}Vc4%q&Ex@G_(&;so0)
z2$u(FE)gnv^R>)kPF)k;(A?8`hKr9MKNsQ^S`!1@)Lh7IMvTRYN2~YLMANw?aksIU
zVrz?diaOfA0qiVWuSZlPVE_p7$Ct11Qw;pnPppR>>QSHU9jgjzubMdW<)oMsCOFK_
zGhd$-DFwk<#;l~I`LqRs=qTx}D=u70{t>{MO7E=zLyV7$C+`40)2XN<Gl<(wHB8r}
zSW!Px+4_8EtRLTHj<cHf?)VdHZlBi};};u+PE0~<XC?Ccd?tq%naaJqocXx3Dqd*2
z*6s9YXE?R^aDgcg2~pY3h;(+NVnYj4E)p|ZOI$al#d@{S08bcwvJZVk1RDx<ezIS`
z^T{2VS?T6<ej#~(XVpgqieOmaON&d<HyG|$j5*VB1!k16*$9IE@RkucI&|X1oI$HV
z<r)^(TpJ?Ee-hv!oLv4MM)k?XV`VadqSY52k81K2T;i3GMr8mjo8AfI`lYL)s40Hc
zTa**w6}godefzm)hPzw<(82J}8Jxh@11k?$v(7*ASsr-jF*cCv*m5Z)#*vey!6SFq
zY)ZJn2eI98SM#1Kk>Svw=s)=>Rgd2tO&%)jr*|9-IJ~oQPgoAk_xt+^EKNNDbr_;a
zw?_IY84HrWiXxjXnDOEJN+N?rspA1rlzsZus-E%araJnfe$`3<wh7weVxW6yl45&1
zfynIyzysO@ZY7mA8tUG%4L7g`u+wb2-3v8l$62h;^!g(<?eUW3tPew984iJUzKYvq
z^7Z3{(=zYzFw!~BxKGmbadkW%xO~z|+Q;eMGOZ<xgQo67&~_s7XxoHg{z&U-s}|TP
z?^wJ2NKE7{H3^A!>eoHzR(-S>z%;rnp$ny(7{(u*C7{zR5){S_70jv~<sUX*^x&;P
zg%Y+c|EftTjzKbPKRdAB{kNOGquM&{U26g>KB1acQYv0X+<gPU<SNqpc=+P2^6GGY
zBOWFg0!**9f))9fHIPNS70w($AD=u6lX9nXy4j@8wWPlM>)F^yt%-;_Q!p{HLmx$^
zEEq*5CIBg(#;fr@A0#y#rDFvh74aG%ezvY20cw4+2ed%zVYygV&=AAp?n}A3_f*<k
zUD4xn_s~R_3y)7FW}^OtsK4*Dh`);6U0s^)jES9%ZVk#V&W-^EB<KRz@oc|4RRuj(
zbXRjJlleiHt=cGbZCiWw6<Wi9I-YFE0z|gHvNQd(_GE6yebA**Ecq#o-Lm2v0Hr~b
zCL@Z4+#tUdW1~%#lcL}9`@K*##|;+i6%29)34U@U8{bxL<8#wPN=hi5)!BS7IC5o)
z)?`0{Q@JWdV311;N@4%*_~z-9P>UqFPOfMMo4|%%gpQP2b7B6KrjU^3|9a-aDnG+z
z@HZS}@X#N1hb4MzOy3%QNR(kl<BLZtN~9h)P$G9{8X9^6f#r0qpZPtOzB-Q$aJ;I|
z{-P*eB2=mp-qCW8`MeBgIiTw!Kx(3w8wg}}{zAL7{}fJAvS}afBx*ybxja4G(Y+<f
zg(tu7;+}qYzGO4@vcg*ynRdQCxJ#mPT+W+fTNi#63(t&v8DCJq7$#(Aaj3=Y`xgv~
z$_<uWKJmee6kEn}lt&yz(T98(hwxw2PC*9glhvctrFYPhG57r%%r+paT1Bb<c|MVQ
z2_OwPG=_n}*8!f1DI{ky0o*93?apo}WJJMDdBZN2uSK{(Jw5UPEIByw<u`k}3Y4}k
z^u+BE#jUNd{QEjSUei(=3Pa>i)yZM^SZ{aUVS!)2b)+Sz1j!q}_EMLpl>Jo!FypXK
zr9EBBWCJE1afJOyC3#yG;vUY?QP|(Nfiqbm?hbLBNuMm;4GVgn83%5JvywYI6-3y$
zlR!k;;3t>1TiAwFMykrY+>kp+x|&(qVcUppX%5OO*VOTJD8@pPj{Ng)N@Y4rf~36j
z3_Ywgt4nnd&$eF|%3W0*r#rcPK6KepO-~Z`{-LxsS-y4qHa{tq)+ZVQx>3|IEfcb+
zitVnnUjm&7RqFyP&4zh+g5gCcMig6$tJ?8fg-Yfl2L5Q@g*)Q{mt$M>8vHn+f`Us-
z%A^Pj)TJ`A?HHAH_iw?k&0Dv8w(P}k%bkgzmj&x;vOGB^5)eCc_RnLirbD7bKBc1j
z?5b~ehiQBy4&BH9{VK(*_P0lAg;!bH6eWZCGnfU;@5cI{l+V?YDoRG@+~m^#Al(wv
zD~wckc!WlN5VK}2B$eJZPsDbcJ^1_nMJ!LoaIf18&9GfKMAl;&I%v5qHb)JXwvpXa
zuI8ub6M;Bh$U>7Lm}K#kfdBLlh#x}*+nz5Fel_Fv7qzd`%HtD!0o4zU*(CnZro0(n
za**ps!>*lY<*7`RRy$Kx)%|g|%XJ$}JanU&NUCTN*I-l)w~h`91aq|Us>08e`&Ll)
zAcuz(Dyd;CW1G5D6hZ;SK{v8m?7ol>##*ZaSSkJ?Caf%cD3rC#8=^0PU0&8{xDD*k
z$t->f0Qxm&OtM|R$rC(|30@6kds?ZNNgc6}O+V(M2vNO)@?SxxL=ccKV9Gq8S^{~w
zIND~sImO#?a)Cf6RGzNor6xCk;bktas%KICwv8D{@y%=+<M_<dy@5zpDV9ps&5Z9P
zsGmLHcg|y$nJU3aB8$LhFTfo_8JuJE{P0^ps~O~NVmrZ!n3Nk6q;=X~?uk^ei}@NJ
zK$;UO%y6hKRAIR&yB}dVPfvE{y9RH5`8oRFLlvWPDM4hk@JX`_cp-WvbmJ&(nb4^c
zRd*rE^mrKx@!+YY8g^KeI(onc@!lYBzjYCjp%i6$$*pp(^Q3))yVrb?g!Pbo#nzhF
z4ay~Be_2I0(n(yDDOz=)LN%>F%P70zu-rP5T>RLo{pXe-Wddeh=kiLCPK*5#&<mT+
z5A|N)lB?`de?)@3R}>kGJQfQT!_+(#C4-=!e|oH^d&%LW-%)xZ*)AXQ>2hhIFDl0)
z-=pirySFEMYZ|tTeGQt65q_NgMfoG#n}V-6umiBL?BAykKSLd~Z)Y_ynVgDaEL4a6
zU*Gu-r3)kPo$!WcWba<sdP~GoOWl=JwIDFH_}0Yf&(xBYPaw4MfxwX^c_3=LJV*8y
zt3KQ=U_(39NA`NYhBJhmgW<ctEmO3C-8+)jNo2gq{Nd-kx`!7%Du(DIUAYRl#X{rL
zS1#Ib5H1Q&84G9nYDqNM>j#MuX7DA;UFw|_;t2xu_jRjkU@%99VVFPKr6S|NF%#6<
zW|%;Qf0lN$NRFC<N92%sJ#VT`?Ss-gWQ5hIFOi_K&c8qZkXm)mtI(Qx^Ctr8Kh(YF
zWX+uynH8}`)w7zcdJS7NwO+mVmdFCu+T2i!)D6mOv^f_iU01^G71_Gl4c0|*A@oy+
zOFyz+Ba)BgVMDf(TLrI%SZ@FAKPwzvk=40D{w=@%$a75Y!WosWY<Dr=ikX2_d%J5r
zz8i%zpHT!lY|EW4jYDE8UD(GH%gE6A6^dLLjP^MmGWd`EBaV+(!%1q?{|4-EkK>;2
zstdAk5_boawnT{_#XlCR@RufU-4PTVKh%eC-}cc-$OCt<wL?bT{7;IpM@?oT39Alt
z1g>(qIQ^`Qd64dS)nk4`dAu<egJD?AJ@(5zDzhKb4sdNpTr^GI2^n-uDhnJenQKmT
z)Pe_iuZ<6N<F+y4b169!=}z|~NH^WHhC6tf=`8!RO&AgM>=zwRa~|*6&};C&@4m7*
zSNT`L+&QB0{4G%I25|--`fo-}(k=$iWE8y;l$W2Ib4fcCV=syqt=pMde5<_~VLsJq
zD+Fb!ym|W5pT+gwiL>v`p3<5gnc3t4y>dkw@w@-Ba;Ry!AV4v#N-DgP03Uru+&RBT
zab^KNul7fiq#SoPl9~T3tjwtys;44&hUI0dsJr}7>R(i3$BwKuIo{X<@7$+eR@vF+
zh!21Z(%tQ;-^7WWd3Ne7?0AW*9WeZZ;-1J`r7ZpVG1I3qZj>hcyJuY|?%o1C{rr}E
zEcH<`Qs@SY<?GvNLCBR{4c}b=ZJ)?dU%<t?_df;!xCgoiX?t5nqog(2479)7)-@bl
zImSj`25Yk?;L@Ox^If=A#hhj857W*bLXT9{Tk_RK!_g1x&!@5-H<VpsVA(dq3!Se>
zCoNALKx&y*Cz3ngt^$CQEEigEI_y?F;Gr<C(Fp-O(Uei#<{KY4Z~pL3c6gsiGg+D>
z!Rl9OQ-)WPF?NI|J#t44jq<(-Vfyb`Up9|cUiP>#;+JC9Q`>e_*2qsV++3`|s7Cv^
zc;xD6y^o~R4dlVUb~(4`*BA?Lj9JcKgX5XbocsKL@~4fnXg^{O8#RM(K5at!xGg1B
zW!bS%(o4rxq@h?N1iy`%oI!Eo8B}pG@fu!Ce>uBaf?QY@fXezTdeFXTyjTBbi0s#z
zcS|6Gm10-URnBD@GMeIaE#m1pE(kbY!%;Af{`y@s+)$8esV|B|nNR+ck(Si_rMO+*
ziq0|sCgt>+&XY$WgUwi8?-r3E%%Vrc7fDnO`{Un(!MkNSRZYWof|@slp-8n{4$rIo
z4eE<q1!sdvWJMGpYUYufO8jCtuPqNxmV?Ha(~argYq!hZV0ps&Dk`11^{&DVP5SJl
zch;6qBqBp!)#ocATsZ6!ATn)HAhR)(epGh0NH{L)P3%B0#vp?Cm-;v6cG7?ZqyKXo
zQ!?#YZUh28@|dVDIm4m1F0hCc-X@mK3tyL!w5d9brkAQv<(F|dyRohx)t~BP@6%(n
zwEC(3dd_M>j5F?2|KsnmG}6Cw>F(W)BpFp-@*XS<yJXoX*Cf*PWBvrtP^HL8)GeN}
z)5{Qx&PT;B)FQV^fAWV4BS0?My|jlaG}xW&>Ua@cQ0Fl5btmcb*F@V;?63ddGTcf^
zu5uY4qZPojQQF5-QInizF!z?26nHpm`ljGpYZrknJLx<_8l*k4_v*q-gy@W$kx%<K
z<pq-Vb$SvQt6kcx#IfC+yai;bJ?>AWgF-|>7f-QiS>wZ;9<Tl_AecBW#2E&l^?0?4
zpNL0P5tc{Y4Y9QM`!^5U>m*B&FjxBqtT`g>lZe|<c3fGEyTutP;)OQ!?#)KW@zlEY
z{@vzQ#@Or95K`l5YJ6)88vg~Bt6x!28djSH4)54-?lGi*60u(~#yy;CgV?YJVqYhT
zR=!6PAf=uj?=Osc)v8DJ^@^36kNynA{4wogF88Ih)-3)^wM%hvkn}B&2$}GUdqndk
z>FGCKpiI#-Z?kT<L``xkjuo#TQUOhx5l40{qhSqKGyRDT1?1JQv?xVM)VxyT4c_G9
z&Vs!F!8W}LPDfO3F5QgFX)sz_&#aaRo_14OFM5L$oTWE4;*$^Hoh-C@HOmmR0M~GN
z;U%2+`tv7$ZcW7L(jLcge~J_biYz_cwstHYg+Leot#Rn*KW=iRbJjm^XgvuxAEeiC
z?&E0~^T(x5+Te`2IiQ@6fLm|D{K<{q^Bp<4DLJoCT!|tYN_d57)^j2!u_y!HvOBa^
zBl6sMucj~8mojg^f@a}lrQW<T#vht`Uz@-+65_Okz?66Z8vA&Xk9FSB#hs#_b67Zm
z78cu2P9yr8nxCKehRpVp@O_OAeVwW9c~4}6H$!@?NPTF=TP~Yyrc2d~-J^~pk{3ad
zW0E~R1#WWs7mxFhTK?`NN%+ZPzmmU<bMeRKW68cw8MhR*`g>}Ab@fFgB(L9MUA+^D
zd(EXnBwjuB$^0uMu$vII6XoxCoa_3uKn$QWsPMZ_Z(m~l?kf%F1MV>D2L;N4+^Wos
zJglrW5-;v5R>~QP-pvn9<21`J*ST4l4iZQb0C~g%8BKBkWIz)!z)i+-6951}o~MY1
zAmTTB`&N3Re-*mCF#`bT&2LN_{CjwtTPkZLe|BxbWIo*R;Kh1<SxADRzf`?NXwuT{
z$`!rmv~d7er8s~X=`l{E9{^~GG5`Pv000iOZn1z+Je7lhs`>{YWU>%VuvjN2|FDd@
zsoq1u@2K;00VSyZMn_HkBPUI*>A+JW!IFaS31H|9d!oPz)fmP8n{PA39nsJlJn4LD
zdocQQXg)z&kem@U%2nDAVhXDgd-OZTF@>#cba12vB7Y7(kuNzBOCJp+K1beE&8I#G
zKJlZyCT%Y0H_06=-1@(LV7an{VC#|liv=nf@gN!UpY%6jOe@<2;HT$kVU7RFXSzKE
zI951ovuk#U)G(2;zAqZ?6Ekuz-_?q|^C6CSvV07#!>7)uRoM|?5XUjg61C&JztqI;
zZ|6*{zqzVTPxOS|4agYH8+#x&rOUo!-ptNU9AEUgg(o(KU@RKaBYQ*#qHVu_eXa%v
zm`!~Y+~sT_VuPP;1L8f5-kAQ`n&#LO^adWL((|lS^NlBll7f0M`(&<X9{e4Ciu(zA
z&1H-M!kH41<U}SIn6K|D;;8q((r-PVd4wqg5sj-u-{;~5h!I>}%~zXvu=7s%rr*i~
zp$kedc-@-MScuyPC825HPW{sRb{0SpIm<`#E{nvSeRxn>g&t)PEhgTN_>ps<wDcGE
zs$xXtkq+>(Rqk1ie~R!HvfvK3jD0wxwF)`%5V{r|)0~>f1xn54?uaV4AGykG7_kC}
z7{x6zwe81Og$PG`<GiAF)rsNnGktL;-*qBbPyW^HM=o=!_LJ%U@)ck@$lE0+YGI)t
zX3lFF!Xe|H%k3T<ljZ!g6U3Xubv@%PVY*{`W%7SxRr)UxaMowCshC@!=mFDanNrt-
zhju-T!5iEWtl<5&H|+8K<<0F@|1Nz^-I)?&OLQ*Ez7Xv0QNRE4mAFAIadm$A`H5-$
z+SE28HI197LDvMk85u=%{{Xrb*@<TG-l_EFO5O}g`EC+_l0v#=ta3T`<`Afirh96s
z5!^+7j^ktAAI#1vp=*=ZKg+g6!p+@i3GS0YpC~$>Z8FIHgK6Np={OystMSywA62H$
z>)nBWma0tGDfxmx&)Xx6K@c*)*qcj!mHj|MEj*Y*0?=jmkg8vnz98mWbk;x997gPh
z%>44z7$&K7K+|`qrzu|!YipMe_J6Nm!yT#1CPqCzr}}Q4-Sy7~udTmjO1%0OT=Dy4
zm?Mi8Cx))L-POEF0{sX?YrnV~b|U$Jk8?*(_x80)KI3)YZO^g)tLnYO*?Qpj?<7KE
zCZTGJt*sKXwpc}Lb<<W+TBB-KD`sNUp4Hl`164{@2Z{u-ic%fajIER;W)R6QpWpZU
zJlFGFIoJ8;{F6V<b<X?T@7I0bB38y%gb`Y;ol~=hxOL|yBXGPG?4ApyxV)K-La*b4
zi$sniLN2haDFgN52kcweKeZW0?T3c5i~K!Bz2(eq=MOlso8241sFNTmkgX;GBFMKx
z%&$h<Pr_}FjKfTDkQwi&ZRY!Vr-*xL{;ZtDcFDW<&-%CfAyf@j5v`?dcR#R~<$7Fv
znOc79Ft~8eBOT<wFFlxu5?4!Epg|`nhRWEEoTV0WUCKfD;%B5StJi?N>`W>&o^O`q
z*o{cwws!RO&mC|IO$*$TeN=kDW6MPCp-h@kIE%L53*-&MrrKb(!@V1Q%(k|=i3mI{
zdDrRI`qE-f3)dt+hE0;0@YAygbE47_aOaTzR7Df~F$avsB}G-<!pVQq0!D_e6#`NJ
zc#lZXUDxwp=BUE_=p9$-iSyQ*iGv<?SgK&?3o!TQfY<#957|Tn5h~Gs2FEIDivk*#
z2F}cGpR6N7!2yatwWE$cG<!ulVKF$B_j4fr)dUh!M(Vyj=&A8o_N|tdHa7LO%)?!Z
z@`DShP<A-K)}{<~8f5r4R0@GLw#-Vqa@ujI<JzkJ32Yg{dTKkPF4k$x8!RO}CatYI
zr)u`jaDY?)Yg7P^St2{<ZWK~$#Z5NyryMqJ_7HH71|se_MOLjDc|NY)=|#`yX84h_
zHYEaC#{U~wvPGTcV-ioD-8wpS@o<1U+A}Ut#(5Y)1Gv{6>1)hi0e%2k?8Y+UL?LU2
zBgktRt(UM;owY26_#bQrWT*f5%M^tHEd=@E3d5@dj72x}JhwYMY!tNrWYeW*c`RpP
zaMYXCcQ2XSKYrNB&Y26j8c(X`C5{<8`@9n-=N!)3GeyI^>E?M!nAdisu@Vr>Y43CM
z%wn9;X6?b?ntA|(YZfZ+6@C21IZTXu5Zm^rnZSgI{v%6T>*sN{y>bq|8|>*y1k>Lc
zW9A*&uf&}Je3AW|AxFkX1o*F(+-8n3EeL*aUTMC*vA5Jw^xDmP*bZw+f#o)27twQT
zpNYUEQAPec(@rh5<n3|No-fC7797%Y`&V^M>7~Gg5O{`NzF6}RMqy95WCuO6CBGZH
z^_Ky7V0}?%N*L&p-mVxsELn8`+R5_2l<|o|ik|O?ely0l%}6{5c)$e1Qy`P6yirjU
z-~Jj}Z=(o5MX7u9D5|gb)mTE~x#-}C|I!FIi_f^J;!;4V*~<kfDILdQIufyG*V+pS
zQok(!q7dzm#~)pgcY{MihR~|fZ^e0cA?E(NXk`Awt#r>hLr9xMFYm#S>i#1>?M?K7
zfpTTlOCMa-Z?3s_9M|4HmmHTE{ZMojAo9>pe8Nb}dPdFR(~tRS$i~<&qY`90I$Cxl
zGQ3X*bbO-Hf*kK^-Lm6({;QL6#QpO>z2oXRdj9^Fs>k_J@_TeR7diyAOAmC*X{EpB
z&67>OC&1}kbFPr;(btDtM2)2cy{Hj@o8)#}xYy@KBRIRWK0vkAJ~cUlR?3~0{KR&4
zTx8~jLo?u}k~bPR%5DUmD2R!4Kipb>-k<!z94I@kCD*1hVH#mKc}LRH5;c6$2Hz2~
z%={{ScYc%2lXiB3U|Gj7Lbv`ojEhC7ps#Zi)5}B3l%=-vc$&6KY-C-cIm(U2gWMxK
zi>?vW>ia=6UO|0vE-&~-4Li1&SqZ(r-q6QFzsvrM)Y;3ek7(txIZqVpr-IZZr2~<1
zGE{JX#dgxd97e3@UACXklzD$GCrx2GHa@vbb7ey()xu{EcpNx<|6{QAjA?z6bK0e|
zib;&l+^iY9{8H}v{WIPB;eLrN_9U5gGxEJK>))8dn{xEtV;APDnRNDs2#}}3<~!PJ
z=<dp<yMUQmQ`U~ND?V$dbTGgkD75bXCgqFZhms>1*)+ZUkDGq`eM8Gz3|Vr<4}Jjx
zND{w#$fVtYC(cQ_8t1D-SSHq<>e7JkXxQ2;htKYR-iDLUHO<&7;G?7kLf+16rw8wB
zLET!&R2^L2L%FfjnTwe-mA(d%*&!YxJ?$(T0k=oTihFCb>wFU7eB@iN@x$EU0GGd}
zB~}J02>~ftnGbE!@5vWi6>&CSnKVdQUP-Wsf1zRSRu4#-I#6s8&@>Dk6@-M@v`=Si
z{v34UDRR&$>RgghlO4w*Pc9tQy&_ZWfy$=+QwCFi(W;pSBYZ>F0c_7&xNbe7<;jJA
zj{cJR#Q)P}4K4mHCxMG{c7W7IJ9mAX0p#&th&H9cSGh@~WIg_0?4{vL9oJyGv}pd<
z+q!uEb5MEN+J7(miUTiZdi^f8!A*BRQhH2t%YSXNsP5@v%XuqMm;W2_QLcJDN2OwR
z@*bx(Y`~_G?TM22NC>SKoML78JgFj?Z8{rJK1f0p?-My+g^WEeVY~bTzs8)!a%=WL
zYjRN3iIRnoA1+j}S@B^c7$pi95hFypdN7(ADImc(wz(yp_BUXQ8(0)y|3{@<)KgW#
z{tQ@b3`*kNF@&KG$DBA*qy2)g^XPK8<if4d7IN_>cj(cBzyqHrs(C*z6O#ngGj8~2
zpJ9}COd~IAbCikU1qv8y52)8Uz0oJn-#v>bu4t~+4sm8Y$-o$r!yoI^sF}_5U4`->
zo7DLt73`RBC0FS@R43JgW=6Id{ysBzTk>QSz)U`mW_1K?uKRekRs%|NZtwUEZ8ZF%
zwW69eF`)e&4{jpD@W`Q3<X)Ty{LKDUS~aagx(Y;hmajdf14Yftm?7bQSVfdg#C2Lt
zuj{kf9g-CTujaZt@NzorYyX1&<73<f`VU-e11~1ucTc@M%cqEm8RinpJ_^(W%4n$1
zXq-9zprXR{;@rn`sfe>zrRvSeG{x~3yNj1t*)#&nXE{#ghBjL?)gM0lK-D9CsfhF$
z6*N!Jzj`hkd-`^ehX=!I6+e6B&thy{|AZnU&PIY2#Cy74=KGvZ<OgXHUueIyh@Z4G
zO=h*WmUG$dk)qopWy=Q-+YMK5?`XK#>g9hZ`i{#Vq<p-`>#M~o^mWldtQBl5X}t5R
zH_q+4>&(WmiDezr*@{?xp^4Or5D};;9a*mgCY6esNVFWk^DU=I>qBdXypPj0i3;2N
zmU5iTWBDiMUH%WOU#PM|OFBIDHa9sw=0jQ|ho^WY21n)p4Jp8gK{0?l2i4P$=^EAQ
zaxO4!G$kQUr#RrFuLgF@F}ucQjU4HdW02QAD%b0|HY^`_J@aKB-<{ITD@%CcOA#~M
zWU5pt2GGyS<=<C!DWAK|r<gjGbeLa{G0^4bZoDm@mgJM%>&saIv-1j@eVcrC^xuWK
zTYicvQY>pattjvbY(gv`lWZBb*uUgdueXRBTrNBcRDIZ|q0I@YPnF9)&E;)E2KhVZ
zvI2Cj=RLJ?ZP%05{fNzG5A)pY2xJzR=cosiBrmC|&Pj5V@c|BItAS~8Y@@Ra{f8BS
zWn93co)~Epp;3V{ZV*h${30+K`LI9VJmC4>i8$X}6)8nyPriZK-eSijy5iPr%jSiy
zP#wkilLc{uWffj03t6`)XDFKQw-9(&XWV1FO|uXmXGCXc`BUNy|MewR)(Dr!+_t$@
z@LYd`yV+ycNJ$ugIDYAl&GF&AC2Ql$#+T<@Wv9#Q)RfXhLMViRY^jLt?9C8bzBNKL
ze?ZFjQAiZ$%z2i^7)3hEOIo+?P+(iRv7G;LHT=QSQ<3-}Ok2OneAmE!4SWOpiySxK
ztEG7Sq;Q`r2R7x6G}hvLXk%|b|8m{a#6FYXGW!qiKnrtDhqVR<&Iv$u8<)@0pB@`D
z-C|+}PriEJc$zX$qQ&>zCqqgKYt52Iu*q?a#ZPMt7QIzMJ7qTVG&Q3PceadD=H5N*
zQ$LmhC7Jd)J|zfOtLrXD+sCPH#F@i_z4dIwdbIqV*`6K9*X+;C@>uyxR@5mbWew>z
z)c+{gO;4((q}PML9dpf%#XV6trN;r-5F|VeM>9K_D3boD4;<=W_iEwGBI&*57{{QD
zY`UJVGVc%M^`izRl(;-{qr>6*jpa^$UA8v^+1)X3xMwIQsTY5L!IcjcYyN!x9jCu8
z&EOmj(yu9IaIW0)0B1akWZZ_AK*F{+qXF%j5%x>ntxiz;T=-rVw(Wi?8a!s(`OOA-
zhZW>?>!v3*sr@kJx$LXlMsNsUD9L<hm~wK{)y(Nm<Y$)EpTD{f85MCiV5el_fk|jp
zr1DzdE5Xu^pS~X80y?>2^~g=(CUl2%HOa_C=fFZAZrh|pN;l#%eE+w_fqVW1yG4rH
zC0(;~0g+MSPTi$V659>TWD18vovG1Nmz6ZIjjcuGdArZ?52+Z{Rn@!~F}G=gI`*?R
zhp#A4jJ&XMfB~N;$j<qJG+*RZs{dZk)+coPT8uV9_s*@i(WJD7Hnql#C&umK$5}B8
z5P~n7fpwbrlKtecO`nkTkI~0}5x>)@?i$2pZ#>tRZ^Z2?y|!z&MY6gr`A3@BZ3L8T
zkR`Ja-2;b`J6tWLfV=)9t-Zvlzw=~p!1-4p4VDU0m-f{)+$XUDp?M1T_c|}BUTBTu
z{lg>*bz!7K^*H9(D11~E5!37Q0Gp`$a-@kXoM1T&P0DL&(D2CM_TSl7dt)axly(Bg
z&2~t%?Dd_c%)3u`>MsljgmH@1&+XFd>zePV4>9iZtK1omi;_E4q5!z}Yu!0175D)a
zwJ);uLu{1JDG{chQP!IESimMm8Ab_^@qhU?qQY#dundSi2)rvak7U0k1S{`QY+3$1
zX&qDZBQdh{>A~4WIusjy*po(#_{1f0_QYVv1rEiwI;K4x6uFJ11GJbu2d`OyGo08_
z=A8Tz%N0D*BR0`)FZ&tArZ`?+J8#Xn+b)h#eVejFod$>R{RSdGWzb`xnJzMzmHE`q
zFSp9Twh?V!yQ{<eq2Y}iHhRn(d=DN9QWDBYO1Xg$@C>4H*CZk2$IJ%x*J>|M;U3&q
z2S0;sOqBkdOohDDGCF$A_XcbyAwrXl#N^@P|Ff?m=2%WvT4r2}Vuz<<Do?N^+wdi-
zBmCn8hR1bN0Kc0jW4Kg?e$cUs)uTmUj_0_zdy(SH@WCTyBo;4-$0wX^$0dD?E-Yoo
zNP~<dduo*kmd?0oFKC9Mnf@>I6R2g7>1$+TG8VpU+zl2!uJamVcnhBK2Gf5)4)|KV
zFeRxLZVNkb*&I;bMqb984c&RUcf%8xlc8{D!i7?VW0_=w5VM-lGkTQ;jUjMrGMb^$
z#tJ!R&2?Mmeep-Mm|<>Yi=AS3LZj^P-e?(~sjEAq*VoRWE(sKeKyWF)Ayd&pkmwil
z9V<H1sI|=+IG%hok1yqBE)h)Y(y!<|;=jqr-og|Cb{AXHb^yZkPjyV**b|0W|G%g`
zllX4%w9ntPc?OVibVsZfOOo=HI%8Ne(|mISdN>-9Q9PSe`^9(hsI>{Wn6dfj_dnP=
zwv#SJ(o-x-k!T$#64`RxH+`&z*K52a>>0sQflCvKhBBA2iNw2=aA-XaBW3vy%XIlm
zQ*Hn$yfc(C9%l&h=~Ft>fhrLDT9Q~HS$^v=bL+paY_rGC`UE-sO`{^{_e_)&7Jyo1
zn&miaUA0p=^-q|8zYb%W@kEo9+TRSL&G(HjBa3?3Qd3H%fs(}`ipzh}itRjG@bPy?
ziAO(1IpD?Zf5j)k&hK;sykP{JqEBp95g1lh+DvYbh0LQS&aJ>15sF<;OwoNWTMW^)
z4lFHj_YnqR2s>;<5_WleSRPn^fKX&LJ>$?I1eXy83XwX$b>gmr)o*`*+f};kw89x(
z>Q#}&IlUIHmJ%{ON@bB2eyLx|P}GG9pgrLrS|nEk@L&HG?=zL_n*(PXoImVgeie(g
zI9W;=ar|z+BiEofk<|t!8+e`xxiaH!@x=-rjP6{wvYHN|0Ww6qYsP*>yJj_rA@omW
z4cLhL3%QVThV6Uez~P`v->y5_YcPHd;xZ!W0Chv>(y7;Do0*=W^Nqa&Y$KmD5dnaK
zDn{#7_w&_Gr$NX8zJ1834g#Wh-MFa(pVBl>fIoalg;dd1x%@1$bJvt3qz6l0Ir8&5
zF{6+90zdZC&^Xwezk%50a;*dw;5vTSHtzPp@w&p(7vqdZ6Q7`9>-(1=KYsf5-`g=Q
z)eHzaZ<Vqpb1Bv00mky5Kf5UO$Dp}V9CXi6Msa}SXej2Es(_&<_f@--#<^*6mVfXv
zUzS?ic4mZjI*h<!rA;`?x=%cBgZr2}B+lIti9W`5+CLSoQYN?&l;n~r;U~@{`h*6)
zobv27#**2D6bW~*w&)6GM#A-pUZVy&FyBQ^nt9F5x6iPy?3)uXZ1KBc4?{)u^F5^S
z?(<qcUXdW9o`7{(&o;qMudBfq{#`X_%}6M6p-Lj{FTh5_=^w&K=fDgjmB2(}Qbbs(
z@OTLAL9|o5x)!}FqfL0emfdwYNcO=1%)1{oCt#q4>TJ%?PCx9TyeZc8|Fqmi#SNQi
zH5Zx|T*WlPwbrrSMRhd!S?w!>XFOw_pW9!JP=X$%&JM+2{&f`5ZNVEpN9Q+8l)(f7
z?~k)}#iX5YE72!#sWkn?eg(MQ+qK8;usv(rwvSv<<=z>}p4@W38qI7yVxG@n3}ZPI
zdn!yUol_S+YklKW_v$L8(ct^NMlUA{7n$!+%E4Kk0u9NSf54);5r4c3HDEqy6V`Tb
z(4GW`Pkw1=@8jc-pZ+5j`aA>xHTtr_q;s6f%IUav;fNa9Tk8)Va$<qhTGe;h=!492
zhwZZS9ri2u2NqQ)#9i18<AK*g#aK;u+aM0bb)8uE3j+m=XV;=Zhoyn`OFs(h2d|nz
zNOxCBEfztOjb>$mSG{53^ubcafZu&D{rpMD#MLPHNM^u==|KJc2H7@~D3KD2x~&%J
z0sDu4Rxjm%6gFTb=;MuF?*WT9qtMhxt=kkcuSJc`yM&i=<(XI(_H7&4t9r}skLYl}
zvEJvZPaTK|bnFG>lo(Z~r#xE!mn157x;!iYJ{<oVqFi;~=2(Eu&I7^A7JP=*{K_zD
z<V~-ymk8XLjLR}pI_01IDH+k+7}yV?sMp~Ar#~rtc)P5BttZvQ5`N7YNEM|-w?(B=
zpXd_3QawVwqcDkVVqOdQ#N4c?yWOSO&ka^XH#n+FNe>og0*k&(au>C%5!Odv>g8Qf
z-}wfdrCHI&R(W<#nMOX`2>{u%me_jpI3njPTCkEyn_)TT{-2dQL8Ee#LsMFG@O(cG
zWE|xG9Qxnx<HV)t>IM@dKEToMz%2cmgb;Dl%vWjR-w!`tN)H?tcG1pnUeURt^Tg9F
z5)0Y76*&R`2(;2Z$wy9A+820jy37hIN9e6oBq?k>!$tgglp2bf={U6|1-LwGpAa+<
zojT_T;1E=G7?=135Y$uJyqYHLVj(mDa6Eb0Lhx7GdtRN7?&rlj(;BUSHmtRdU~h?C
zL?|6(kjHbq=Yuf-C^XoANxa>~PRmwa6(G3V%Wf;|a+Zbz0FHC9t~wGE)yB&n))itm
zxtC&P6{cPTL?;XYRWE9M3HlrPQ%r99n_`AfEAwEXC_8e>*1$>W)(&bZXWp3~FBo)A
zHSS)6WZc>32$<yc$ekfR4B)EU)6nhBqn+~*t=%^-eFV=sRD2m3a0oi}{!KXlw8V>x
z%E0=mH=d`(AL0Pb%iD`3N6XEN*E0uy`(1Amgu3_wHj-|0r4&7T=G2jwqojMz1qwLk
z<|w2@xFXE;@#w}F&;|Bj>m8uKGma4q)01|+B#SIN8Mny}0RRwACWXc_IBvM$g>2j+
zlU~GSFe!iETq!;l)21;b?LHrUd)(Myk+y?ri&f@XGR|wYVS*8XPyJdBuiir&SxGcd
z1Kib*d;24DE9b6jUZ0^gm5r)3SToxZs|GHbsxR3j`Vz-yDOMRg`u&6K?oZ0aIW|yn
zHmV&c!mWx_eM3h>2LG&*30yH!MeTMm=-S2L8Cn{mEn0@77V~IbL`TJiF(>rW;_jcc
z{e3ClD@28O35E>h-rpKaL+7*i&gPLX#z&(#w>%=vRR^TMzSp^p?i#oeDMoV<*w8A;
zEc?Y9=u6OifKk}_M#)GEllZ}j24Vv>tl6>*AT3#1QfRsb$d~GxO%Z!2J9MQWw3-gV
zq)slu`nvWXhydArEK^opBw<v@{)cfVY0VEJUJR8EbNQU&pq|L(4k{de4;SRe1Wsu)
z2xCxWd1+`A=5mL)^{VyUXY@%Uwl1`1DqTvFWcWKYQlZE7&KzBzt1PR%{m${UDh~*d
ziHPP7J6>OPb?e|ols1?7JzyAq23(k)p0YCorT&oN`}RT1Iv|fV^GqXY4&b-_>X}~T
zN9n$s<&wFqT+Ov~P=%k2#_jo|A|LGxj9L5*8?93HMClKQ=$Pc@z_<;D$4BZ9?l}b;
zQ)mh6KVWZFz_f-&ta&=;NU`Rd8XW?f_jO8Fc0<hAVA`qV4#(-++yL`OWk!p}+6N$U
z&&PKe3&(K>4o3m!aB0<AN20s5jb3foYyB_<I|F%bxc{^SDwy-nzG@u3z#EUC<bc7`
z1m8$`y5U!;<d_z=>ZcJezkUom(88xwgXOtV9Y)%Lqlz6C5GMva$vI*32vBCf!dL%s
zU<E48E6PE6w!yaJDzx8%Xsw`5LrXyC0FP_YcQ21?Z_Z-a#6~;k7~Js6#J43)Eeadu
zB)kY*$gcPj0H|tT?NZiB$Ns7yqR#GwbVzcFu^k=I<Tn{<F}l2!J%p5D<j-;p=ihJ(
zNiY+akh@CB#|1ra#i9}macxy3rzJ`f?!7@swDz#%H;(x8!lxcdt5R&|cVz#W!)ou}
zz4)E>&&`n%B^5DI@NkY<1&XCBCW4*C68cA|OehyPl`ccrE&)lth8|%1X)<>V|3v$z
zQ&wRZ#0J}5N7wST4)slgsb~gB47W9^iL3vfsfy!a3dCoca%7rD1^(IE!Zc2rxORg|
zvy<lA{$8+aq}gtO$eRw2S9h{PC6?@oZ9`K!dbquY)pvXb_{<i{9%u+UJ0=ZC+J>m%
zBHFb}MDvE#1-3cr@N0!I<CB^`lz0}oiV!|rvtQTBM$D<f66u!ltTQX^hRX3O7ePzX
zsqy}<I??DQj9gqOG7dPHM?!4_f<19oQzqSi6aED_9Ks{mlEiTP743x6fzF_7G+w$e
z%5t|%md;VGb3{1DFs)jQ)~}Tq4w$<b&nJ!|<=*=p7QFj#&sH}o<QuhR8VETsTn`io
zXbF~TmgBbPD}(4q4ygKuMyNqjHX{(4>}xW&eo~Fbr%*bF6lk<-M&~j>i8|)3sPWJ8
z9@}%KPP8hq0t8v%oiYq~7X1!Bc8nt?0Rb#KFEy4ReunOXxK-rCU8~V9JM|HV+cOS`
zkho?Lz>^~*8+WSb?DGT(0K#VNAk&D<+7HAj2f#d6=M?-+*7Hk6(#=L_Jg0llyyKd@
z2Bo7Z17l|hUhvcKIJFS;bk`Phc0ebq<K$axf{@yV=-KF<y?_!~(o2csc+SR0Kk)4^
z*k}9i;#%+1Ctd0-!~4aA^lC;cgap8$DBNH`u*Y|hs@uCUmgEnfre`@LFUF9!Ii`Q1
z0yy7__tYwO!?d&o-jzt%sj9$WP8t6x`*GwUW-{rEllYJb1h?k(%0?^j!lrVGZ{m_G
zp+hldJ<k))RpbzZlCLU}JjEu!bZ8Ba=BB5HcORqcK2;SqAvo7jTQJh;+>muls%4^+
zrAXKQeXq0ohI70~wl}AJBkb9hh7;`+vTP<s!A_hvhRX8RVRPWnTMmhcUk_an9Vw=W
zoE>Fesr}pA`FA9ew>CX&@kk==k)^t1;+k+{-v39q#|nbOF9&xI^ON7wBR&-ja<q;@
z2POWX%8a!5!3ABrQSr02wpQVFqK(l857oYdu_MWso%n6K()VZ3#Zg?VaeT+A1@5y=
z#-E1hw&%vq9&k^#YAMtRJpDlZf6IfK+4&Tq9MHZL?aYh8x(gXkwz!i9OMkh~dpwbk
z0yoK4%%qS?JQOaf=jS!(FK;mgYqcLN=09S^AVYUf;f;KZ{T>J)S+we?`rT;zq-f+q
z^_pt9m_z)?&05Y^m!BmXFFWylO`KtGlX(0>*w~b}<Il!ncQi<?%LLoh2l1?Q`d-E!
zE)!^U=8Odn=hdX!cz&8k+d8h{ve~nYMt@}>)4@efJI5PEDowq7(Y9o#Q`eyapHZQe
zDEC#4Rii~Ku7*E-k4+DuJ3s>$u6;uB5;6~jXzVIVX068rFzMlibC|KAKGL_?NuvrZ
zk+aRlD~MNIyWd!6Hnrs`Ldt7#_7n+FI;#(90cuc2*9N=ni2qoJ{lXke+^wZHN7=;+
z%G~QIac0xA%sYmu(fGJ%_FdDL_QuAJncUfT+H76Tv?54?q3}oK6m8S}LPD*EtclV+
zW$XB#s$X+$pW{!aW&Us>@{?(1DvRwi58E&|_7dBuE4)b#f=j*bZ$%&|qSM|IFMgWI
z>XMLtVWudz>N}I2^gN~RMX{xm^09F(;iZRbWCN*-q*6<p(NkLuHRS!zctpfC;jF$o
z#idtUSMr>6D|t_*&>t<AwA~fS%|?HmRng(n9iEa26gDT-FozO`5JL$Av<MZb(W(C_
zEb%G$SbGX>*Yq=l0lj-CI=Xu1^gxeyw0&}SrsE5-3KIrPtR74Sg$b$_p;`;X^=;Ou
z)x{4+*Zi=j8LmHz#zs7{`ZkR6R~Q04K@+nY+kXDgrxK77d}3RpLWY9&$%tf$mGI`n
z=glHIG8rXkrJa6t8!rU+m;6d6dyQlBeW_dq*W#WCn6%1xc;A}%#!UWMaSGggRja>U
zGXNoGct0UtU{s)oXj!BxmYu!4maWXV`K`B)&>~y=G<N<u$A{zZ9`8;54fEPqSR7ki
zi?IsJuQC1O^zoG)RmNTFBC*aBkEHBqIN7jjwmjn=^ACbE2`~E+Zc8#08bmqOVp|o0
zxo2zIL@x`?e?})QAhX5B;;*O&?m0mZXe0nE^LDyOXxP7oy__@7R=vi#eba6>Yjcoc
zfd)Q}EBLY%9=QOfqRCK~)qvZx6BRECNQL6S$F&I(Hky;tiunq{NgCA7$LJ{JWwc<i
z4ga`(A7UiRfzS2w-0k=I1zfuGe|k@y+t;Vta#?DQTpw(6D3PDl=Qug2s}a$1JIBtc
zW-4gMeo!Qm*?v5jO@!>2kV`I%xt7ZihILBFc$k0#pB(xQcyBrmWMn_NFtDDTJS;t{
zl7(2m-QCyI*5>&=;#xsID8wnF&1|^@nlutdIZ25xQ3>T7x!1;BZ!S%weq%y!6D<W_
zD2v*(oM0JkE#aK9?o6`c8S#_=Y!WNjv%QzD7_yiejXNwBU<q7-2FGu}Ij-Eem<0?!
zBDy>vy*KgVUQ*XTxBo4Nv)S2=<5dRJxU%c2xH@R~6Xu-BMQ~W+0-1W{#A6@t1?LOz
zXr+TOhLwk)i8AfC;bY(65LA#@XRD;}1}(8xu`%+@u^vfC8!OoRyVV`eiG@fV={v0#
z5|@oD`!c5`xY?*ii0=VQ1G?@4T9tU|gSp!Sut}%~w<k9*F(PmO{R|O|2T80+8g^PW
z!KG%rnZsi-x48#J!Ai-0%($vbPm%81VVk$m45f}UFjB8C>V$570e=g;cO90;JjPX|
zxMgE2W%ea23UumZ>R`fapO_j$rMmeSme=mL{1xU~pa^J@^vFrL6Gzt>+Z;%!YIu=!
z|EDvGI`2K~<H|TZ+7=JndqU;?<7#ZGwp;}<ZyLM>pECxm=sMK*YuFscZGHLed?H;d
zZu0p<+76ybqe%z%0v9dAuIWg0&958Y&L}Nx*Pkn&pAY{DBO}8wfmJ_0qM<a|u~zlr
zyJg-QRWD&h%;1yk%)vOG<9+FTvBbfjP+^bL3B$x5ic&zaqsb*>SxW_g$*S3-s5H@f
zmewlwMwSp=jR3{4R<2e{ljbFU{BaTNWZJA3zZ*Hil4s3?U`gOGermdZwa>t%F0M>r
z)Flw-7e4~hp>gl?YJyLj5AcDx=y~T3%)X%KB6RpgaX%~jDUxN1M^e>!2ATm*{9mQw
z($TKp2`)p_N8%RJ{}b(pnA2@;X>o`-Ll`A6K#`8fN!h+cVw5a`9+J+L4}5F=^ckDX
z_*@Hg4M!%N??JV{lM^y)^*l^;PH4shy`$ZeqlKO`t{=204x8R-|BY1^^f*iDlj0M0
zA;^W#erEm^;)hS*u>NAgT4t85a<@MnBmXCC?$f?05~5qM+d$brTlGvdbaopOf1ash
zA|h-H7nGtNEPegmas03UJdyNl_6n>9EASCU3672S$skpL6-j4bp}(O8_*HO2BH7Ft
z6fW)XFSE^Mxvmq2<?M+Y1#~9fV~49|WWQhjPmdHxqzb1JBP_KF<_R=`6POw8)9SmF
zo>}qsYgXUc&z}m;fU=9ik!yvW`nl;8xhNqD|7(ONMI2;EN6xSTfc4dcrk-6*{$-ge
zi~xGr6IK0!_?g@0DLI$Oz^yfmvR^oW+C!a0e%IMvEU<e2P+hzK?*&aw-laum$OM!%
za$hHc^>FN|PvQL3IwuydLlMPLr^P51lh3m*gHb?98s}J6ZGYN*3Mz2l_nA$?@?$+V
zlJN-0+Cg^Cf~5C{i8|&dKgHlduNaN1$i_eU{m^X2UkwEf`iINRCFIV#s=A3Kb`;Bf
zc*2}BFr^D$4SaHpyTav})z)acN{8yN+Y2If^-g256Nc?#ygbFQ*dC1434t<bsd4Zy
zA%{(bJ?ldwJ4H1RIhd|+k8LGAH;zlxGfpotRW7`3xc^ISByA86-;h|n<{h*^dfb9V
zU?L3Sxy|Nh%Vh+exs)NxQyUJv{FB)Q>aCw-3p+0f%^k%LC-dg8+Ez17I58WtP(n=W
zT1FAN4ME8|r2ISt`BKEfaA#@#f|Lm};Lu*2@<#-ngPsR<b)TOVxP=1UGR8jiz4<Z<
znIp%+u~u4LN^5Q6BCdN`rue)V-0Wi1%EBtE$Hs^Z&PX;f1?^#Y8|0cJ?L-mr9=fs7
zV{?~=cSXE=KKy>BFmCGFKF1_De0iC<IDCJx+@-sGKTP4ez+TEqyUNfXap(>;u;NWW
z?5)%Xce-VqIIl972_6AG2nxQOQ56{sYeRLvkFm^*Jrd1PLrcsmvEe$dajT{^vgbw{
z9YNfGdi_Env5c*4e<X=W+wRp|z$J`M?-qaG)o1pscW{lIY~VS0`d8_%*^~Ao43&Ew
z{}OB~N@NpTg$k;9erl(XvgUoP3)wWR5_>1((=Kn(Lt;?E>S^(DvQd`ee?|QQ(zY|#
z9ohC63zj+8WiLc=)XG33ZIZh;WnYFk>!XMlUfCMR<rv_8lJ5V~PKk>bx(h~ezsC`<
zJC?M@Y|3{D+o+HQS=ylWiDz?%mISpXp+fHW#mO3$DWtuTule_-(ljw`RZq^K)O_+J
zca-N24C;CAYP`D|1l)CYp|!ogP?5vQemRkG<xs$$E;~!qQT1yM!=X2R^z6;GkoIWl
zenXl$5e<gGv~3YgvZ@pvEP4S|SDO`olYs7-m7RBg%_c0+5v63$q_%-@_8_z?b{@|x
z#d+E{@_4ZXBQ}#l*Z;r1GWEQpbB@OQB}ju<UsYV0EHzdWk}?OnlpiZ){qPe@N})UX
zj&uxoP$vLK>I@a@J9-VV!nfI~s{E;epUM+UT4p*TL1rhdF>S6_I2`*qC(4jT!T8IP
z&QFv&1V4zlY6nJu&M@$Q&xc(FA{T4U?H`B~Tq$6q<N{HRu+trkpTYNzkeA;a+rd+X
z5sWD4bY|A;Q<?`HWc#1Y$r<~y+$%*<QC4hiH!$UuqYN3oK~dK2F@yTG{Yi0>wDe52
z1q=3meazDEMz9h6{8yFWinB}1E<#jD<+7FcQ>xf0|3FEG`qxYIQDrRM#cDB|B|~ce
zUFDSY1^O*Oa*|#<!oOr?mll*AhcINp*qo2P9PqC@H``UV{g+B#0%Q9+B@wGp(VD&C
zD0L>cI^Bhbkt{B|J<AM62_duxn0Zo`H-sn`eSyU<Q|a%%Ew-vZJ_auSyU(QX_>pn0
zYCCP{u1?Xe#v3#S^k&mc*MPm<zrA*4^&?5tvvqFnB3!L!VB~94x;gybjkvV#G<ycL
z1t1rojxj52d{84g>dKK8rkzIXWIXUB`|hAat4dNoZBn{tf|pu&id>?lw!Nif>F8$$
zCr^to69+CpnZVcQKM6}Wmi=sp>~(Dm%X=_i6W}K<ThotI&NYPFiJYOj|M!^E&6|8<
zEt)N7@4iucWpBCkxAZr+pR+)e+)!0vjy6rcAh4LX5(sI9Vq?-p1z2H03NPfTAngGT
z^MX>+3juA{u&IM$q_kIN%x8@q;@yq47=xc&p`0~tXGn%8zLJcRFikkA^ONY}{?ZQ1
z8~Pp2EVP#MW*w9y?~mKg1RNeP?U%N&7k3kE%N}JI+m)%*u~udrd4u*0%Jf-3W-Y2i
zAob^EoaruP?`cN*0lp{TS+cG%jz>DvvO!--!f80L=79ZZq0Jk6RzW60I`LXdk*gM#
z%M?;`m~(NKDmyupdp4{#|L+~tJ8BTOhaS9;O=Zgx#r;_+o5X|vknoF4GrhfMvV(Mh
zad8%q&|yu=VpNR62zW)!_1}QaBnM{m$Uy2H>H$VRSl1z)B17khz{&fNj$UcBj<}dF
zK~3V`9DB-ZUtodLihO|a=JHIZWVn;E>ZfER33qdUMVJ412z>jeG*IjQUNz%FDa%XO
zaXVeH)<!0v1)o}O6C~iKKBZZmG|1Smi!EdO7_i@v^l}>8b`>*?a;S`_+x!MAhB0{D
zEgJX523$GN-*P5z{f<(91tB8?RfL~?@H<9LV4~(vf&@Uz+A)@<I~XzmAI5gqnERnE
zaQ#nNIF54SFR^|d@~~Zjzfqp#Wtv|UR2d~PE0pyTtn*mox!u>_L!;gHYMrG}3pb?<
z+KMp?JSaqV0w|l6o5N*G_Y=>Pwo@{OjSc0XHf$ux7gAQ=IM`1_*K4-4fdqq0`w1Th
zS;NA_P&x(SpBV-eqVc`Ac--sOhQzTUFYFeejj=Mkfw!*PNy)yHXQNohMex7Vj1eH$
zk&h}9yXPbW2&@pS=-PHpE+AysRDZF^_(5VV`X(WOJ9Mfy@)pt0C-P$z${^gnk?YFn
z0UETWvB#mc$UK1&=QfZ{LK*uH00Qf9L-shUT@rI2<olG?*%r$zIIec|z}>h}{WKT7
zMH<I&jpKYv{OdW<kin{r!<Zpx8SuKquhxmIT2Hal18`&o(G3mfl9zLJic`OsL1*!<
zG6}<`7#8!Iw%IO5x>IoH-dz=V7TvHi?%1(s7P=D8yOKCaLdk=Z|M9IE0Zd29xJk7U
z&>+CDoRK<)4v-%$W76Mgc3W>@WXFBy-|aZxC-u6+Q9qzGdCz6IPXAVmomA$*S%v_U
zc6JcIY1vK)BO~@)XBTemH!^&q>%%gQ>jfNJ@txj5SX4$Hy%ca1;)P~3Xf4pF=(x9i
znEH9XHQVXJo7I*dl%8<n>UwVDjcwmjLYBIBtN1(<fJzY@jQH-i+Y-#)gB5XR`yGC~
zqFU-P70-^yR@>9h&m72=Zty0i5U<HJh51F<%uwR`5*`;sR>PTSi$LieFAXP&ureJ_
z#rZA8<uixY&Ucx#wTUcdzro;II_c~5OS1FS1{)U6lB+n=a~q@C+DtkZfMR~mGWYKR
zKNpiTu3^7eym7{01zF=t1!?2lh~S2}sW@FKfRCT3G%CO&GreXC+y=(+%n>PP2OG6z
zx>RVToQ=Siq<3h6cm1YwuGT-%i1k=spqa~aSL^2tP7#tC;S}{x3#1j%$?*olN=hru
zTqWo`XU~ta?&o0QnW0@+?NM-FAjl|ejdQcps}Y$xzum7ula9DmU=Emuub!XZ`D<7L
z!I-;UTfZ7PnyFb)b}G<W(r+xAvfQoo;^zEh4@9kZqyP`j<JU^(clVb(k~h*b8><^K
z&dvQ562?#?&!$UR$P!g#DRIuS`ZJLen2eYb?vxz(?vJHkw*8<rdSuUKJ_lF;f-!vx
zmD3))L=esI*W&m{?Q^EHaENqXq1lK1H-tGaMp@`OD^~iX#?UthXo~&|1CA{$eJf&d
zR^aEmhVg>ClAG+ubXJ*6;QbjuX_v9(&4#Yn`ohTSp-`Ml?{Z{PdZSbv`r!BLOGW!*
zvJnr447H;!3V%slR%9UzG*c9ua`e^Mz(UGCa2RJJnAV`)=&Wn2rQwt}s-U$`a&#iI
z>MEc&8f})9;)v$cx(AC*TZ-Gu48_ktwH?b!$>+M9_8(#f3csj+Gva3Tf!#bKWc-{+
zI{)bNx!m3KFjbe$mhFiXZbAZ?s%qa6m*m*apZ~)Ag(#2}OiXGA6nSebJq_@2x}x7#
z9OU^x;N-V`I<sTD&%nbe$D7}s@VJdOV{T<bBvUVNK73+SOdWqRB;WehXT0?l%NRn-
zLqq{?np7pd`b%=4=Ngtp8DA}FEO1czAy=P?#yf#>6i|{-8Md?l9T+|HA1C*CWC+Yj
zp?YD7lELOJ^av{JRoI5Ef@0*tKk_)?*4r0|N%`y^7uA!A1yjw$<k@78=NvKlwTk{}
z6)GOi^?+pLlW&Vc`<V7pbSX{o-IvtFB)r_klj*EF917>!*UGoB^UnSRag)z~Pq3@_
z0!{cwE>DL&iE_)=m}B?utabX8)N@gc^zxoaN}_7WQOwdeb^VhdPGXT__&X}a_+kIE
zLQzt-#GT(W?8m>ejVo&#UGL%uVkmaLfAL@~UI|i|{Mm1+nY+pH{rfNfYFf4%Q^}>Z
z3KG}cLUuxSx-TQM1uv?p3STyO#~NwWw9lQUoS?LERHrG`oCJ&Q;`mIM3aCGN-<U*!
z?%@+@5{#RC!Zo8JUla@nIOx4XvqVcVEm>t+0{=V{+7m5%HTB_>-_9R%>uZ%TV_i=J
z0J-sO#E7P+_SG#lERK<=n(`Z=8Z5a&6}o{ZO7v5P=3ZC2i9QNH3cPeORUw##+wn9;
zYgMH=ntSAlyW_4B`|E(y=L+t56yA=uO#c3(-{G@N(u`xu+^02BlY7s)LSORgxezCh
zB-0=HWJ@B1$|FJ~OvxghKfew2++N|}3S#KQ>YgjjPVD^dEP8At*^X9yNDK_gvFrE#
zbLZb@#9k-agR==w-fNR)2+eO#4=~z#+=Uw(eRT7%)o<N|>SDa}<DU+`(L2Am+RZMh
zWUM0}dJ;m<hqT!^UE6g?t<W*uS3i*u4ln$l2kq^0_1;73flnb{UneT5^~=cIol<aP
zaDGz@=V#a!M1L9k1Z}t0QuDm>N!0f5dcn!IGcsEJdK8vI2FehO-^FJGr7oGA6;<qa
zu9s=lbxdXRz2w>=aOKvh;wq7x*WbW|O=RBwmSe(}7EAcIKcmwwDOHP@MRQN~1<nE;
zVX#q64Q{{Jb{h)L{PagomNV*G5?lEG+_7BE`^=yl<ZPO0y%ft|tL-4b8|skXWKNBl
z%w3ZD3d0<0%=0K5;8GM;3o`X6us|ymd`29eYk7BYb}g>kPI7Q5NA&4NW02PVW0(2k
z240F0c^<nr{1d4!%0bTd<R?fc<eo_1WtRwfQS&1WVY>0D@k%>A05tmc<F@IjQ^G75
zG$$s%tRlj4n$^hJSQTs6BWl9`N<_z$rPI}X&xrk&BYK(l4Kbk^To@Q)L%$}zCNuDz
zAL8vlc={}^l1NkxnkjK}Xgs;MjmugwjP-_<C}NY!&bedS<M6ak8{3cPw?21sSo+;y
zT<<aAzTC69ui82g^ER{zn(03KO~;3yk)_=k;pU8gb>?8RgBPNSUZPm-`ANMq-(RyQ
zr<7sL`}|_8Qx*u_H%8J3^jqMc{4J;AW7(PDmJUS4W2k0k_GH%{%}kw|%`drb*TH>h
zxnS7l$7fbGoYbl`M4L!!v*RS?K3`Y5etP)a0aV&&XI^8Xo?Mr|?IIYHVOC-_a*ihQ
z){!{)7*tPU;nUlxa-4xLFmWYowg+$52$2y_oLEFCUGCB5V@_g9tLHr^t!Q)x0Y`i{
zQgn=VRzJDI^|wzzknj1wh*?~R5t@STCz-s)CNb{+;hpr573ea~xN(Ed63=!@Q#K-w
zn@VqFggYKsU+wq^OdSsA6}@oCV8Ngl)*e!OKJ1t8Fu;b!F5sKZD(^#R&ci>0<f{UT
z`<{6_;x(6rW#^(~?wjr*lIH>xey7<!{UXo1sP>I15EIh%+x*`-PaJC&yRVvxnz_YC
zsO-z*Ix#dCtYhW6tES<Fy}FjK8uz2b1{(Qi2uoz}2W%IZ=TY+eNPaSn=S9P#-KE)E
zq>>jGw*qejzH_iD_M$EyjZU&i&u{PDx}13gRtuG;D?&>NRUHw=o8t7>tejdNTh;tl
zV8hnj3^`-a$y(J(HgLc@lVpU@IVF4oEc}@DzWiSxP?1)}KR?_4mMxk=;u$B`W$e#k
z9GDc&<{uHTIUUxT)aCK@jItZ%=N|9W6&YJ_jP-u`5BB6w`(P8A&S4gPe0J;(`sPAw
zFN^)+k<)s?e`wXRNjSfQ5;HoGN46i24tPXUpwN;ujN@b8K7b&J9{+>%?eD7zC6yLJ
z$HeY|?Opx!Y0(t+kB=buNfECEbt^vrS$Ks}bM_3J*2YKUYk|p~z|mG>6vvLWK5&(1
z`k1jDZm+dr@;F1rH|Jg2KOZ5dN*aIM>WsdbF)Rg%dKI#5ar}z|Gb8`TIvU^J|7;Rp
z!gwc5hqM*Bq((%=hZ{t1dAqsz80Eh3+j3y9VYq<NfJN3jk)@JJ*)y5oTW{Um6p4Hk
z4wq3_{P}z55<rjYv6rYm7kj?82CZDo>UH+#q)C?O^PYDkociN*g1mAQy`VtI^_(%i
zUW>q;-~B;Lq@J*PwxciuaG%(g-U1KO{8tS#JFy_Vg3WG%-lN<&G~n)3ugTt5$|}o3
z_aM~aH|}fc=PD|;jjI+44hATD*<4+8RwIZt;>f$;Ai7bKT8qgVEo^4t|8ks+rA`ke
zxDp|W#?Aa$PUmdpqoAiCr~{&P$Hl{^P6di4G)O-#!__9!vV#^jiv)Rk`v!bH8>5(Q
zQp_l4eh{kNM>@eKrTwk^DH_D{IxJjMq+E7Xa%|K{3~N2UZ<K@1X*8zfvRq@85FQi>
znl@FJ!5mSM6I=<g{bUmVUHZ)3K=eB!I`*|RxD?Hf`*${u$)s@n`Oribh##qs*1xLQ
z3^?^G0C_~>FeY4bL&XI~$E&Mw0LmVJPK~V(3`~>|0>hYL<S+Oof@RxN!Xsnv>+|nq
z>V_XNfCA5nW54cWMrX_k<Xfc_<v=Dl7&nt`N;0nkhL!wi*4pFgyw$hA*E!YDPhZ06
z(DQ)}fpxQ-Vx%yeWD1fl*x}>fX$AgN4MqW?65NnlA|3gO>slX1nb}@Z1O}QB#U0QA
zg@^JV)6rjY0^M?bC^T}RD00C_KZ7|)DqigA!2nSY53nxA=e)RCT2L*ZyMNnA(n9Of
zC#QS8sw#n-$X3o0WATl{S+?Me`K3cI#Umh6d<GJV<-FR<YY;X+s~>avxhELdU!NHx
z(kLO8xgQ}je@|_SvO`=XCg?%I%8tnS-0hzJjF_S_fNJ(PGbo_b@>p&{(Hj-bD)K*C
zbs@oFg;RdM1!3R{$Y1=rAeH^W`w{Zgg|Sy&`h?b=Ic=_hoOQ8F+i7U<TdA{g9=N|Y
zEHkkFOpZtR^X2@~CY0!2&%dgGx-+E0rE5Mj5z%~vdTOV-K+jAm&8#ZC!H8C<a~BJH
zZYuL{ri$e~L?lwx1G7H889y+1Uy*j%58ON$D273rC*b6|x)YdOzcfW$!#iF{*&Ikc
zEZw0TNWyH_3c=1-2s|0184L%psLV(*N@C2F+u;Dji9`HaLC@Dy--wU>45^EaYu5ky
z!AP7(+;W9<Ux>4N8xlH0AQ=C~?QvnuKDN#b9S#r28NS^6)qYQ#gO<j?70#jl?zG8p
z-c&tl54y!%TcdvG6{0w_b~u!n*@Wwu&SNsA<NR|o3;pi9us*W~n+?<kXx|dDpb_da
zMm@RfbSyJ{xy*PL!+ZL!8e)c_PkvR(4BJ>_jzVeBz43nnSbu(fV_R2{WnI?ZQ{RI+
zx{;PWj&1>9hOxaW)E}0dwPjZ%Uxmd%C~83w{vTh4BdNPfjWA`G78Aa+TA9;Y*K#5W
zDys{g#g+_|@=I$F$HuvNz_=HB!V@+uY{cRo^<$k3hEkx`+_zfWB&nMn?lYIq8Q%Mx
zRj57saI-*#!KLulpjT*r+e$db^WXduiw@1`PV^Th6?*tdi4~bkf9)crbT2)p{7~kt
zV=CPJ9EpFIaQAgyn?4z5y3@|2kER@^!uyp!1{|KjH2!_+5@&RPO<$4z6DGecZGZ6#
z0ngy{IIj+u{xTI+Q?qg_c8<=82Uu~25Q003hwLJIyWbpVvFA4vw2hS*z@M=@^o*_-
zM0n)oh1*;6S8hWXJAaQ{C~gs9cSM6M&IB#WWZY2u!z8f+dRQMMkH)~fBY}Lpz5Pg%
z0P@L$hmi~wkwSdy!fu7Lv}pejMMSpE%6GjCS-iOaetE8`MaBy;N0WG4^%p>7J_zD0
zSqAjsr^1n<Z`oMJU4w1^Ie3-nQRFu@GvjCKxShcJ=zwp-T^zhug|N}piAj4pqFTLk
zU+8wzugxmP6Ns)$(ib%S35S#uhxWfG44l9<A6F%tbLiHM+%Zq?S1vMB@_BahJfY(&
zgCKjy^1E~U4Zvd%r}FoqaOCPu=vj*W*dH0imsrIcRc<l)n6}h@S@ki6@k+MbDu1C~
z*{Y(~Non^S<A*svr!4Jg#(b!8<9QrapTiW=WVbJG2Zb7zL6J$2C|+jbLK)j1Lwhj`
zT*-|<QV#z|sjS_!3|GU5oV4H3RpZPP5E@-B;{HQ`JLrFdn+O*;NtXX$^bqD2h3D@c
P5H5X9+L`rpk|6va>SBHd

diff --git a/osu.Game.Tests/Resources/Videos/test-video.mp4 b/osu.Game.Tests/Resources/Videos/test-video.mp4
index 3d5e3a99539cd4a0237d0cc98a864995591dfd90..795483c096cfcc14ef0a4f663ebb9b8443c28c2f 100644
GIT binary patch
delta 1823
zcmZWpZERCj7(Tb{R@i{uyKi8Ox)PTt?xVsLnz8mWWG0%xA4Q|MZyBs}u$EB})-lIu
z`LNrnW46Q<e;Ab@iXoY1N|8pLq9lrt5EHtZ4I=^85?sN$>+{~N2J|FP&wHNt^FH_7
zzIEtht|z;vpin*9+|ts<7_&6DHP&OlZ>fK0Olx5rV_fgq;$C~cN}bv}P@vLUdWV;l
zFf&34j4f%Xw^_00HCU`Rg+YpvO9xntsb2T!xJ4?~>M?Q4RH`D+cCLH@chhRCwZPkF
zwOJF*DZJD31DB^kb+hLNx7@L`rme1mTOCM|M_JY;>{oa%&zPFgk2(-3*upVQ<BytF
zq~=;}$}BLI&MVQI>`b(v8EH`qLLRs}BCrx1;uSjv-!8?&9Lh$8w!)%-bRY|u2c!TC
z0pc(Zn+s$BX+SO@01JR@AP2|<5`MBNhIq;)oARhO`KWdZ^(QA4pgrNFB8vdpsQ@)e
z6sCa+fcZc^Kyk#;PWdz}HKHbo{a@Q^t7`#I3#w=YPc*5CXIgD@eT@wwtW8dm<<*}y
zC!4q|gU-^@(p1yfP*Y!JYiz}4T~+G&N_!JC7c@A#jKTq?)enT2ZuzY0Q_r`biMDRP
zx^esEou6O-=-!18IxLsGx<|ff3aU<)Retd2t&=DAG?^xz^xf&2;7><xO<uir`>x!%
z>-d&GZd`Jh2Jc<g@RhF}xQ@hmlGj|+uj`3#NR#9B>%a(-x4NjGpFMhQXWa3&e5UXS
zHAs=X9fp3rd@S!JoRTH4-_ThCD@XDM4E?-(YvlUD@pG?O#5H#J*!b6exKKJY;}YVP
z>%q*Ce9X`tF3sKXm~av2*^*C(bMdTd9MUA8+0dU$m4xu4b3&j}9g?q_0{G}B0h}`>
zUx&e+(I;HeZQSr|tU`!&{?Y_~uH^GmYIs||UMZX{`2wOlqrWhmbZ6rRXRw{m`tFKt
z0-@=WFC-2wm7PNT)Za0;;Eb;Yn<04_;*Wg!Tv??vXg{PmVU2?39gtP*8FWp>&w#BA
z(-WsbG4bfS$=lIz*;;*sE?X)j6T9gcv{M?i65rwDYxEQQyGrx*0dSe5*wM^xQ>`&@
zEVMqjn^(I>z@u}(Ffh2cFtl}IMQyo;t!SqkH;1%4=yF6>xPwzf;L({l_;BHP%&ZUX
z7s4jZ%9s;;DkKySV&*r7*Wf5XL~&rSt35YpcXxBzunr^-6-8G@t0RnIB8#0J;F2Mw
zQF()~{L>a*Pe7^V4k|;WOAd(T>Mnc88Cl$ADt==Ba0scGjolxH3!@WVUG((r`snSp
z5iNqCfjJTM@~f830dP<bb0h-)>HsyLq#CZ;eBwRjXQ*OIKRGu3oBw!`67TT(jYDo(
zc8y=G&Q}kCBfX3WE0kTqg>K*R=)~k{(Am(-IJDQ+_tVpu)fr#6EWGV3_p4IG$EIrp
zcMq42ybp>ro1y43=RmV^bh#U!!nbjOJ{7(y>BXaPIr1T0`A~(N@E|0ZbFOb|^n6L(
z3)UDyvLNJx+4q8*=%y`zt`9n7KK<vaxg!fZ;GGYx|Kk;+kq?cJQ%y`1Qk;(aM@rin
zP!hfDe~B??wUS7$V*1I(&VMsDasH_{kwKrhLLM3U{#-k0Lig3UuXah$exL(Ky06B4
zR=bsdrqWq_xW+sk;urU=vThsg{FeUu5EBr)BYUpy2$xBpy&IX~LL!yPaW_Pgq9uMM
J5BGGY^goslS&IMw

literal 2885141
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%0D{u>+?w{Puvb%8+~T=^M2
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%0DFCuqNIngv-$+?F%wtSajABiXuR}i1evP
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%0D}*T1S(B}Cv{0b~qn~#n_H`g%#pSs8
z-CQ9(d+;(F*yy{7rj7^h^{=H0uF_2T0YWqd?W%R0UlIUzthxp({@N<t<EBVt=_P({
z?uTm(fuYWuBE_!DU7R72nV{lgIYFaUhU3|3Dh;ZV=_T7`ow6^pUoHMKP9v!4q{DtN
z2S4rhY^CN!CRqj{ILm~EHK0-}El*`*sW_BFDDT<61h~+r$WHkFN18~dDU}R9T4y_o
z<weMOzTxd3Yh@Y!UjI&O|0{Xg|3-$oxL*4z3FGU4ehvM*u|qQSl1nMeEHWxM3WbRM
z_+?^b8srX_RZ3l-<)5ANic$$`=i1CuAcH=|k5h;WotdnrLOl$BiB|kfbYQaJI{Vi`
zvGtW(UuTu-EmOHL@-)MH&riGs3v?UU`^jxmx+EI|(9zV4O0^H=a%iNA8G=+?w8Z_G
zO}g;Dbm0TCl;8h-cJ>8AOTz17o29r{2yw=e3+x}QX5KlxDHQRfz3nzdNa7x_ym<Gm
za0QC$cY+AyaP`~)-TyR#S$@Q=!=G1QLNb^83&M#0>a5Dfl+JD;pEgj-giwAydb1p&
zQXOX|0ED-ggdXo~OeXQ&#T8j6uKL2LBPV8ZNrc`mMuGlcgM$-+rm{h<?NUVwWa*{A
z(!7*@)>=QVgFy>W-!jkzvqmBM^~K!Uk+!Eu!&3J$VHdEK&t_C}%3I=?$9WHsBh0;7
z%XAPcr+0G)mm}^WYr5e@^vl&&zp4_J0YN1YpQ}oBe%retx6ma>FpNm$lF|e?557PF
z22(|nK+i@!vvaTa@Ctq3=Sat4uyuQzXAE2+_nnV*5E}Q)6BO3e83SM|Mqu&FE3}wm
zj$f7Vc1cYTt8fS7M>H-;z&MNylgo^wg}Z**3Vk)YERf!uK}lun6MSin2$`o%*jJcX
zv4v@5itpC&bep4@FJ(&7=W$SV0>o!CmE7+qLSYGln^X%F!K~qgWL{rZu0Y3?0;P%N
z81}Y#t$U{+{?FateAjkBz_+CDFVlCGQ11R_Mp9(X<E;^^AI(?cb#4-PP>8QuG7;$-
z@onUo$|QD$hmE&O?J^GMudTWtstBuaQZ!-edWr=m2*@*GbwP^DxOiYX1;u~n_on;6
zDvjNd^tFO0nUVe)h2MWc^WJ~FWF6Nio2wlwz&;KwDVCYGgVb<L9;QCp)<P0&6Kl6!
zz{Sb}`N;YkSVVwyCPBxjiY4kd>!b1JSfL!O)2u$FV^9MtJpZY+B>MEbMU%vckl?#@
z`bC3xe#xUu_@hQ}Y|%#ISS^36Pp=CIaO25*$>HhQiqG)y9dO)oSL4BbMmd5*$7LH2
zk<GWW#ekMck=S@ZNaf$Cb%L4Hxit4dc!W^$;naZANh(ln89w5!P}D#BcB5rwMeWd=
zF7jX<sUB<~L`$$Pe7}E=?uZR6)zV7fw}M;r{CiT<LsV?M`MJa7gO}e&K?qqa7eIT_
zl51#e9?5KyhX2pZVq)wGMY@AFsVBR44qUcJi%|@JGZ3!oZsO`!>}}dezK%Xg<;i4X
z6=|MR;$j+P&Jd~1@>Kvc?j{qkO5#D1mmj?ZEfGG=jY<54F}3VOpP%7txYe%cC(o7t
zjBN@~w!16K3F~zbE<QeTQH^&V>>T?*pUQO-(Iv7=uPzjR>7PUAii=4@{kXl&=_y<x
ziL=L2T>VN;xA_y>k!K#4c=a~zcX7!INfApw@LJ%W+2+d9FMkD|tID0irDyJmTsE0I
zb}MnXa0i{r79wj#2k}=Xjy*XK!r@L=^=u1W4{VrZllL;qG~)n)+uVlp3dM$>MS)D)
z+y$T0#L`M{u_9_H3_{+tM)9w>O4y>4^2RA74i}(sj(Q)D%<sEy>Per4k~;!!l(Z5;
zzCRj8m)62gI$!m0N!_w5usjp?#a~rEeAC9{6^k3NI_a7wTRplFIoQcPI(j80bu~HL
zxvp)0e{9-4Ir&#_CIgbXwD>V{K~`9<<O=bRmr!*`se>SmZo}#AeCki<rxkW)!B4kO
zD5P6u?*u(N^A)SEOb@vh&PcEJ4w`^U+0NI#RHB*%?b`S(Z2H>1({?rL>|~b0OxzOI
z0Rqk%S&SI#sm2xV0&&e*^P`z~vzvw4>>NmHj5}JRVIR?gpYwO;{gV%c?hK_qhms)P
zHRre&FZE!2it-|OUB*$@t?$Pr_}Cw(a!Ip!TAgkh5wn5{Vz6T*icR=~T7>|B+h_g+
zf-Q!hoL>FLlqB?PiTN=EsPJWH`|kj?3iztDy*^azbx-Ti0Odr28_i>Ah`0HW;eogK
z@GN@4$6!(o-3iEHT6`$-DN2QAI1LCMq$upO{C>sJ?#}7qL(L}P7xvKXcb?#qUw${J
z^;%x0cQL^&WH-&RMi{5J%qjv_FX^nKM6z90l59lx%UqJ9cl!*^Zoq9D_+vot{@N8K
zw^2-ho{iuJx3d)w+~ur-Bqq7qXBbz7sD!jkHNy3EYQ9)tF4+u7JMBNVSV$%4ROP4W
zu+?@vj52y^%|SH(=>V0}$&&g)fMq@baSvyf(qm-Wp^p!xu1-%S8*}k!MCew8OpJ;1
z8&B3}NpNE`Y0f`4L+sP=O>?ih@7_vEauA~?w3VmjPCwpE-<^o$pN=kQa))i!!vFao
z&#1+O5~~BngPtsC>h7z+>4WgQVO~grQBu_N_f$35Cuz27j(z)g{5lT?%Pk~qG}#z8
zktx7@jU3)I8A5#1p-D$Jh1vkqPTm(|u>vShIRCln&81O89Qjz^PQV6fVBIwTww1}8
z#Nw*xm?AMq)s4FEJC_by4bge3n^<Iq=;h=)oRyLn8G(~b;pYeItRFi!Hl)2Q(`PgR
z#!lQL6d7hoW4B|{eU)1C;yb|bfL3w$Pk;_VBRG+e&}sAi3X<cG$l3<}op7w{0@ROW
z7{sXp6)cC;uPD`tJn#0n?M0Kc{d_co&$G<6$;QLMSH1CFh?QDu2IX}a_0lfI*Y^w|
zu7v+7b5Hb*xm>rv5R+zzxD${$UxDAmg$;^#y+|~^?<OwI%D``JWD>94N>66GWP47s
z`loxIMaAOO@#flJdapb7tMg{*xr4UL6q@x+;c2a(_>EE4OB4oPO-W;&j1HdY=73ul
zVeS%MT4{%W?wp}JRa!(G*>PH|6eVZG=fDKE13Md2D6kkYPr)Vhnp%tt9R29c_Om_k
zqTz9h*cMwyfwSHgT!rspc_X-iqbLJ02ZNF3v#w<HL&sp8z@BhMe1mFY&Ff00&s)!8
z!eEJPf=`zz9ln3QQxLh&upU>$PCRlB5s*{<h!E@559yA}In?kO!>BhJ%S{b-_s%vH
zQYdlH&mQ6xB4*11XX)pN;SC(}^29NBwtB?zfgnVqu`R?p$rEB`mEU0FB-%m^_{b$x
z-_NID_uk(&`ktte$9G>zbHAw7P`1*%E*GSlF-18^;lZVMg*okO;O3T?DrPjS!gJ~Y
z;fLAs(BjICs&EF9ZnT1|xdSVg@%_v&lX6KUahvL8FXE?X4xo`ybjChKfCH|&EZ8lC
zL~&Bm*Ry)G6x{M7uDrGh3b0K{Tl*f%tRnpKJI}DhJdmNuMvwSqBW}!x!(Ly!JxKNG
z85+nF)x6iLT~&(LrP=&qdwr*Onq)S5yVoomNtDV+5n+24|KKW=Dg19*eQJ?cK%Wqu
zWH_tJRuwFDmMM$pa{3n%$#v&cH;fF;s?3|FQ^y_ab$j6Z8Wvm#B#BOW2R&)asTDdW
zpRu^pR^wS_V&9>Nl1|NPQuWV^eXcl~fzmv^@5*V6bwX>v(#BJ(Qp7Rwo<YnC6Q-a!
zl=2h7ageCRvaF93RrRcQKmC&Zpxd@k6Uv?XE_wS@aUjX&Kjtr!hio$uU(>Iu(1=i5
zx`Nt-osb~KBeJ-Y5RrQ=`x9y4J}AKuWq+J@cGAhKmcrC|u{Yyml}fhZoNkZc>#zNZ
z`{5w;?aYAclMwcO(Uf_3-?p=L;vre`@UInV64NQx{mVj)wSiFTPPDw-Vn4ZzYPNC_
zUi~y_-0oz1zSG-zyP5OquBe`X2z15ZpG9e+cAe-#r19YM9}~>DY@0TMbG*Sr>J(+m
zif>a<s-aw3585>X0>uz}havGj;9cTUeFrVjZ+PbuONyJ>ikP5(fB)@$Rc~>Eh!`~o
z#~kKnnBKnkKLdcmj5zN#uL}*suXANwk#4^;Zy-bYcDtD4Oz$<F)qR07HhGvVn@#$U
zpqTGfU`;1nQ_B4yV%NiWUxvWU#6(WzJS|vMWlbn|@kgS|yyP>=&M_z$WvTW;GluZ>
zi@;FS+wE#fUQy2wQ`a>&PT%t>Q}>5KawxLTNPXr@1wqMY9#sB@cxucUQzEIFygcfr
zTq0Kb!Z`T`(eL%EfP(K7pejfh>kGuC8L+s=oi$08eZB?*`-1z#{iQmqISi_9Y}QhO
zdpbi1qBLvjifHMEi=E-1?+w~FUWCNy^h)OP!NHM#s>Y4CqJ_bS=v0>RpTjl6Z64|8
zq<Ap3_6d8<F|laUlISIkuln?w7&LWNE)yYA4tAw-xe6HZSSyXFVs9}~Wo!2sx47g5
zWP%3(UdO5YYPEZdb>rEamS<LhkjEl!TE&KT$G(ozwiNJzj2Ks{OkUMaEwGKhmx2{O
z*++a~*C^ecU$PM{6!Epti=vF)`ZW03M&V`p?^ejY;avz9<mpxEuBfZ6?$R&20{0NJ
zZ6U@2$9Hy!0S*T;Mweeu<4~8;$a=rXyZwcy@Thwa3g^$ESkaNY=c{2L)_fmp`>m+}
zTpxhXrhVc5cU(1p^OTr&d~ZT9>)|iL-+~mWXTuz-rTy9ex_qMsArZIn?;nSbbd%*y
zm)S8-OByJfqTu!`{Y$4LL&>#o7p3j8{nsLLtWt(u?0DiFmbBM*_DM_ZLtZL~Io&7V
zT@;d8{Bs%Xh_RPNm|>Heh~m=aIL9Njl<wl=uq+y?al;meAJ_2;1!P_G2FL8OzpN?#
zI#k=K%-)Pq@StEumErEwZy$z+N}Rq@S_Wdz(2zQzc`1cgk48$M)GX1@d#42sNsOVp
zb6?-uNO291uBWnITa=S^-N!S;wz(aPXYt!q^mm6pxUW%^mz>krkEPNghy1OfdB|j`
zjP|!bk%Wz2sc6q)_#s(<TKz10C8h^IIGd!5I*p?1{38R8U?2n#wW=Fo4f;_!V(1yw
zU*Ag1n0hEnh^QNMp-dtusq{-mOqNpEZDGP9!1XCtR+mXvcT||Fck6Y6E8AfCZ$A-w
z+JQp5^e6DR+kode>SD+7W-_l+*j7tvy?-n~ta~0yQS?ZaDRjZ?#~t?Ne~i7iAoD7{
zq{ZgDFkG?_#LRyU+~r7C_>%i_nceQ7`gZR1yi<7ps~^V^(K{pw=j0XD(DR#dfYq{x
z<-^F0_ic!8*-T$beolKSq`W41%#&2|IT)H75I@J?Bqyocooa`(_kWCkE8oFyg+2{D
zPFBwgjct<rY(s5F1^LQVZfyJpl~|Mln~rYS9dEFB5^giLHFxc`8)ckL`UU|~V%~W-
zdaDqWlXqKb4ArL-#%>lHxImU;zT$7S$nj^#l;YCWFhnbLGz*-LYpLpA>--lbTN<gG
zbWv{{iE?Kn`M*uvC5B&KtXw10upqU2<~i&jv2?X<$OLX_D*DlTLX_?`^I<%35Zyth
z#;NSp{hO%C6GAuB&UzOP?TpD+45~p9aAoK#fxE6$A|+Hw3|D8q&q!_~n28wRRg>Mg
z_V*80%d!dWH-@}f&RQFu!V*J6l2NQmv+Yb3*1xa4?MdojFB#3bXTX;-{IWGd+2%%b
zR@f+hfLU8koHNl~<6C*b;;FXssu%dP$|-7;UsBzJ;&z<eVzjzUY4#+UWo3jC>d`qh
zq+?ON$tvROAKm-^<}^M=yhI9_f3OpsRHfZgO_dCIKxa6{-)Goje#^haFpsg@8%(-%
z=RB^-7V9l4;qTR|{JA*l<l}~}0rRO3$HvhXgUDiQXWMl8Z~aqCZxTP)vUp;I;>H7~
z!BYnqRT?ysq%r*k7I~4aKBh`@50MlMYx=l#G3+<#u|6Y*K6q{ESV^0JOU3EjG|i&C
zJU2v$&4Ms&-=f{!Zk7fgCJw()R&o&r#HN#<*W;D<KflxX`|^YmILeT(1Z-W=Uqzut
z;nF(_wy1Wo$C@BE>wK%fy!Osw8SL3%m#zt`RU_#OB*sU?Hs5jKYF-G5_^aTq|LPDp
zRW&~GIX!JA$;Qg%u-i^w%%c}I6dB4-UQ4#g$(qt&kgv+GylZK<3MdKH73v%QjGnFB
znB$LlBwXCisq4C%H!KbSnd9FXk(reS)Zquls^A2ss%yegPAaS@G0pctncKxG>~H)j
zoy|$_Wb%bMc>g~3mo4*kZqfW)lnqo8$7r0$K)E(1CjCYJ$ga{El;S`STLk|t)e}5H
zb8saZ#!6r{joO&lF4PbJk{rJsIiwNj(*fm4lp-qiUNGZnTH>V)Xf6!%;+}6<9M$lx
zCVpD&*1#HI%0&DNO;cPBCVKoZ^j4u9nCUTIDAtMwCTL6-Sf<I!1N%euM5tNgO6K@d
zn-!tfpO2#?RU_~8gu1IQL^_Z-E%;@;Jh18Ot2u;!(o4Zfs$rh&z&VPdb?NIL*Ov*`
zi*J1X%bc=kwzB7zqkB7+<w&zAtaIe~YPSyZIC`Bha%m^*^xH135Yz9^^DWm0!b(({
z!UEIu*_;|y^T;~bA~_Fjv|p<t8x}$}(+>YzWAv_5F8K0bMCfNU+oHLRa%BVCI)UDG
zm0#%8?^Kyzunk0ZCh;s#3?BwpQ6tD?+j`zvy1Gy`z3pFr+Hp|0%9Dz{9g>w?=^nh^
zi&}60|JEP8RW5}r!g-AgV?*hE+O!;dhO7gry#+4uSX^ee2P(#mUeA4%4M$Bex<hx5
zGoQumZc0&bIT#lG!Zh~fQsQqw-penUls|x?e?Yf-`5Nz-Tc5xEYGxPIZMrUYLSzN9
zk|nR%J^F;tgTEvdE48uNJ${@0#--xIeMQA>Nr7uvm09GtLsHUa@&(7{V7ZMu;xy{M
zy;u|0^Hfp;`%p(<IIKRoYyFL)-wx4cV8XmYUSVH<Y_#~oy;-80n6Hq*YoO+!qfV>s
zp&jC^&GT9*sT)cE$O_~SK?IQBU!vtwF6BKt{ZRnU_^R-UaHZPDYKb!X;H)1pIPq(#
zjppzADpzojNAQPFHyR07hBDQE?<xJ+v5q65x!4d_3jZqi#Kej`E`@-JjG+7{n~6h=
zM_X^ZGOU8MXkQER99F1iWk3+$(cq5!3}X_nx7Q;;Cb^zO32cqq%?;V2<*g4@Dt)(;
z06P*}w(~fu!LoKI^@X&jFBf503)<b_djO6d%6;esKoxwT(lNpEWcxtZmk}Jt{ba!k
zVVW`-xV-Ru+i56lEL5S+9eGTJPPhYwI0%IT_b}Wa5QRSvhR{sZk&3fytG70RWA}8j
z?UL8qVhucL{+r5Qv-#<=D8&{QrHe1#ke|-#{@?eE!gD?5cQ8uf9GN#;i7((YwyD?_
zGUZ0%(wR&nMaV2)N__&9xw`1d25+s|x^9MDj3m4vI95HfiYdE(%ZoWBA#JRLP^t8{
zw)1d<Z?itG>%Zpg>J6Fj?)H#tj1Ka956d3%3kidlm#*>8_afS9X8y=!Q($Xnpd<>o
zixStEC%Smujj=jhj1Xh=P2H#`4&addOeRx3Dk?pjq-~q5C+V4+M-0_16)_oE<gxRJ
zd)6kDSQfC9<<E7-{VtDWTvQ(oqiDsYzm4B>*To2EPA6bw@7PS5pE-Urcq?>2VuOSW
zq2pb?GYI|S*a(d<tBy+Ai~rg`O_m!Ky?;eCx4m4B$vVkyV|OG+-s3;v8`uHW1aya>
zQ0_6iGQ>=!%z)Z`Wr(EF+R+Pn6Q}n5krdi_kg_ja(B7=zny4CPH_U7y*@iGt9!g=%
zH?F4cLZ+VUImvRbA0Dj43il>)vP06T)^w`R>%LFi@ih7GsdmYpPFgJUnZRqYZ+d&h
zrWXf2Ot-dRLaLt`*sA<70IG)OX@KD{edU%cz0H^!(3$v4p7^lW^vddQi;iR(LKkyV
zrF~f^elALEC4iCIF@guU>&Jt!x3qr=2WcjhR?ef9S|xF@K*#Z9YJsqD=8;IVHs&bc
z5i)s@NHg6wpFDf@yX&5P@i4*Cjis?yef&Y43Nk%O!ipT4ZY0W2h)-x10>_ph{}V5@
zlEYr{GUdO*!Lh^eLlD@uTNH9}6#w^AJP-9rjdQEef&(rcpv^}q0aGt(H2wCDLmjPu
zQ~odj8rviaBQ#oKv@|Lu-88y=tUd6}-<I*)x8(d(kNiJe`Xc*7%{()cXW!QTFX=8j
z%Xd+yCoy8v<W>1ng6qThxVjPlS0#i$WhC5BV_HlOMlGV|c@yoIWr|Dtepfcj>L7)5
zv8=h><0VPm_ophHbQb$u+sV>~C$I02B|kw#Hb|E5hpb2?F3U<O9;X+gdXKg*2w8C0
zD~+oZENha6*XAe{31RUCvC80R%Gp_3;xt!DTK|F8HM~TXJ>rlDL*nvCRMaoCtUUF0
z3fN^V6ax-4$mr`$%2JX{-AV4Z;iqJN8^MVkK@b0_P1PTaH8nlB<VlS=z}pbWvLyNs
zJ(7R*jGXSu_V)4>M9d+F>C(Fq)60P~g^9rU>=hhHRLeJ5*t71S2BrEs9DFW?k4T%U
z7JJ>U^wts;%h@pg!9yY_uH~GPVdZ{v5tP?Wk|O{I#q%ZlA$%3UCt4bOaLO^GDEm+<
z1x3QdNns4NxxPCPA5!+pdS8De*Ha5}*?@)vW#KUfomRl{bV21dT_b#}N+}B?a%MFL
zh%TS6NIt3Uc8p!Vz>V;HpuQ$OW^(_^{PT{HwS1l9WmOv@*L@hwXi$IwM~~}loi`SH
z^p~;H8~ekJU9;}QfDP#%r^oeO7WcDX3*wO=0$9qUC6UiL^)&crU}?`78%>$9Q1abs
z%>6gsda^Hp*I3y)ga%g=`E0$8qpnu<;M0Z2g%Y8%$6Qzu8vSS+W;K=jV@t=~r=F!=
zQEIV~8EbjLnzBLB*`oI+Pj&DvFE5UHvy<dipJi};Y)rZDnLFmGn~%i3bNk^~-f9S2
z1h74CH_({6tj4lpPh->|W7cWziGaG<={djDxpDf=c&Jm)U-4!bJGrU44?yFff<)c7
zo)X@Is7KCXWtDa9*cu|c2Hq{`tyIuGaC3eSI0<c0M?}6Slu-m|8)0{rmrkae^JrWx
z15`$XIwiks)&*~|WG;p+h8E4SP&F{H5;{Cwil9x;KjdM%W%<hZbq*gFM3qB&iEiQ4
zspi@N1@!L^;qLIAHLp>B^?2E2zR*-uT7EJob*{2mYC3+3w+bMvYw$EPR3+vUlW6I;
zzmh>TVt;Mgh$-#-hWwt0wKVUP^xk3NBag2u;^~R-!2CI42I%D%%o&I6{R^7<$%*p~
z9MkDItLE9YP^<6>LRDhjFY#3OFEo_JiqIbI7;z4;M6v7};bC|>i5Hc%l-Gs1{4m#&
zt-W{|X}lB>y9EQ<kF!ji3|a~?yj((QC@mI{_|1i1xeMQU>6a-PrGv&ARIB?t#+8~a
zgL_O~kJDJhB^z^zXc*0C>xJ*Ws&yC0cg*rQ7N&m^yjK`ENEPsBzR;i^;NG@Jms%r<
zUdCNFM0DpZDzaW9g{HRm!^Ro4zcG8Ts8h$0cbKVlZSebib2b`6^f4Z~pY(?{mbPu|
zp=^A0h$TRm_qAAAhR#%I1%fj)!)vN8=+6pNR$*3i5!6OQg)P)L;{dVz<KmpfqRNjd
zR}E)1tZ$`wP`X{G(90~RE%cxiZMFGE3gi`|_?{nOBlMbsyI=wGX;>oA|FMMe%y`qp
zw>BR}1r9M1&zznrOPgYC>|^2Z_0@!rmSOm`4OF0WdajRZS`CR8BO&xt>yEaLsoyNd
zh&ODn5pVvo7E!e>rcI`a371wUKUQ}tibe9;uNl#HJ-q&9Iew?`P)+QB*b?$l;9MZK
zm8N2DacMdQIvML*2YVhW%+b$=*30YUyDDyY9*!_|$!|*pS<Q=AOnt1e0o<vYH*GJE
z`<3bZGaj|S1bB#k#h#0UA}fu957V3rE>v<KeOt8&PWL7Kp%tw)F##ZSg<Q{}t{7Lj
z-<wS6b2<iAZ>#hB2foAU#3w)Qn9_Uum4qam)5wp6mL5m%P=HsFj99(em)XiO?83#I
zrd;TWkh>O}rUA0QDJSLy)L>g)f+#e#b1_HNLX;@AW%SM82BJjO;cTcplej1R^mmL~
zbcq3I?TP#l(v)x=#fnj?<v+*Q-Qj;xRf-(E<+}FNwN#F$rV_T=T<=Q#FiX`e$Mo^<
z)!poh{coB1`uImiC445M_M9)X=PK;&?P|f)YD_no$)BlD;$C6o5<-Mr?^ZNNQWOU1
zJ+!F2W-m!%VWNesi-|G*q_9Q?RkB_N(Y9)+QWyl}vyyugAr5g)SC?^Fg(B+*E*45%
zp83(GV_tTh#Noc6hipluIyXP`={P`>eS!2A9zLJ`F>1Z9{TyP*BP2-{N}ePi8JAJc
z8gWVSN32nrg9vVny~+=Y9kbXm^rWo)rj@^XA16}<w}P0Pm0zx+6&7t6)x@PrWZSP3
z5=)`4&Hxefn_E&Od8%H)&2}~WgY}m8RUY+4K4Zgn2+o1O(VsLLqFGF3m7bekUt^8l
ze8uqH`gA~kx*-Eb^Ry}|a@D?q^D0%1B>2VYAy+%)AAv6Ew+{+8#riqTgl;aSy?r}A
zt4eQTj{Uo9Y-WA>VE5qT%_g>gcCn}aJ@LHWn|_+`Wme;dcH*da-)DIIk>3Cnur<+o
z+sTd!zLtUF5(*bPk?#A4cP<&?N5-Lk>~F8ADFgMht3CA0g=4SWD6pmC8sc%!PeoEI
zBG1ojwSSfA@6epY=!74C8M}bt11@E}q6g8xsm8?nj6A>1LqX|KLGq3?w8$R$2YUER
z^^e@EaN_;PluVRCr3s=K>UmRh_-HA?{(ldfo4&W=(3utORIjPRS3x8CmvU$82(8)%
zm;E*P;VEqzt?!T92NWt%S0669Hu{45xL+0fYTSnoQ8*J>T4bE@?)o)>^UWUjZEL2}
zw>#Q8(4<-m)%>r~!5?-{;b%vx<7~Jo%lQv6U@XE%6vt9t+@1I@msgNmj~+#8<@bJG
zJbB5M^&S@mwZqT=e*-rROcLHc>9sOny|fOb`84#?EDepa6%-IAI$sw~Y><>mces`M
zEc^tbcyg8~8H2ve6;G6?mSr5=&EujM)ZYJ^6RAijUO#JyUsWt6SoYSzRjU8e4&vGL
zCYpi2Gx7+q+Zm65f?rg2mHVP2phTMpzUM~9w4J1uU^$>_zqGgH@ft44$y$WWwNa|>
zvw1}IO+7kU+x*aT=Y`nc_x(!KyGci^Q`w&%QI4a2lo)UxdR1J6CBFHOMAda@-h#>Q
z9n2hd!HXARS?e`<MakN+_UV?_@jXu{K#_N)fSx<Mw0VmamXz7{=n~CQ*f2Jj%dxYr
z&7Yr+k-F^_Gk93b{?29e_zCp}p1)P2$asv1>t2P*RK5+s*Z%!1)#!8`x%s|-mE82e
zyWsKgja$gXF#dce-ueH`j+a@zZ(LGg3Z6_9n-(K85eKim+G5K)>GG?Op*T~CD6S}p
z|1wb<V*<;zSS`)_OBA3(hPHJ-CsBDXStx5(M8ESO{2=*meTiASU|FvT3L}$#i5rPB
zP};%0(6#vsjMy@jy6dimVpnC)v^2ji)3E#lzdcC7CYuIc{ZKsR^pOV&zXna;f7uou
z(pyvw7~}V3n<we=B#<}=QzTXZ-7+xW0zVRvIMg2d9<n2oy!-lP$n(8=VsJ6s>&{y0
zy>r~>kke|+7juRJ6JTs_q^KHTB}nrMZhJ=C$?)C{w<~&kC*D_laB24#9OOgEEcH*D
z)xy`mWkS=ZeOR-yly;YILUA2&1LDQqZ$5WAJaD4S*0&O7>2ocO`h;Iftr|7{jf@sc
z)?xL~RRX#0k;SV2sSgf0Meh@nxuilmN_6&4z;|HU$#u-D2_lU73G(Keql6A63~`*k
zl>SITE3lkR2utXlXMIgYn)-|tW1a$wIbFCVF_Ug+-5<<K__ur%!iLpS^w(h0(e^um
z6N)U{|G@%(2bUMjz$85EY-8gI9T&(O9#(ZTZdhCE7%mHsZKANxW}@OuvC*r7&<s}D
zM4H{%GoLej6a&kDC~C+>E?0{is0?O4Kob>`?8s-Nh=>P+xE%gZk6Q3&t5ToSJv4ev
zuHUqayEQ%KlORZ)Td-ZmtB!Y+<RZm#46NwQm8VpeQP`(5(Ak&l>_kwq*FxEipQ==S
zB!eC#mtb@rHD8I_Cd#ggXJeAE&PT0{#&tY3>>=%*OejF>qZ6<vrL~+sH#V@~4DSXp
z1J>)d;9CzG@^n;#i3(lN$L7KaPguf=Z}MhxCpSdmhdPbw)1M%rClsb2CeEf<@hl)+
zIozzbd&!5Pn$ACsyIDg@$jTZ*l*%lpv`5dV=2MvGOifSM!pBy~7I)>_(fC+YQp<h`
z)Y~N#yfp!zJyo-$z76=$$S@9n;gnLsh+3gsuo(opqVgZ1`H%|~syF_jLdOv+ssh+6
zS;uF*AL6>BoMiRG@ynwfszfYoa&&kwuRAIhCinlCdJ}l4-tP~5n6Ym&mXLi{lr2$~
zu`k&wWr?gwvMUUR8C&)(MYf2NN|wlyW$bIHR8*L;lQJ_TgE9Ai_4)q(|Np#RUaz~j
z&%Mufo^#&k{hY(lz{vCh@_3-~+`}NJ!peB4$fZhMzC5J7o72-5vkl8&D)D|x&RcHJ
zdAlYD&^#YFg4Xp!+LpIbe*$y4X2oxqfU%S0#;whKT`ubI-$PNl_cPB&B`vQOi;8AZ
zWA4>0d`Eu?6PQLZ^-$NYX}wO0xcbmmQ;B5glaSB#ip;l>JjItq|C@l7>UkU@O&W{k
za?E+x%WSR1dqWOzmXist|DL3#c&B~V`E)H=`*tAqW^p#jxahFY^WC2u0pE5UPtVK`
z_d@k6cVsUB_lMbkhHQWRhrMI&-@Gmy&ex{K;B%QQe9sg;&@FDUyZ=`u0&Tg{TtpLE
zZ#oDe9we`l^6EyfNrHYHZBpGqpZ(c*IjYR}^SOzLdy<DSJeB!3&z@>@VR`cK*^4s)
zUMZp98I<C#-Tlb>gc->~u{U{&5QgI~Esos<okiU@enyFjXs2PO1_#R}7NKc(xZma{
zznU>6B=N8_9&SxA`&!ZO$m>318r8cg$RXjKwQx#jF1CT>l&|s47)Jd>+e1e%y_y&s
zm{K&^tG=b;wdFn0AC^}9$eQ$-hUq?iJ7jV+K}E-146XC5Mk-TNN-r61es*EuKvG;-
z5I0{KI~Z-aNdyR42o(}VaxvbnckrWXtj+n<S(h|~D_+Mm>kN>adoB0gjdAkid+p)9
z2x5k4DDb%5=T$Ng$EEZBAt#-vm}>((oyONeA7Papcki>Z?%|`g+^jF3LL)bA@UTMW
z2cK$B6?WVSbVX$8$_7-&gHm*PJ1CmjH0>2NEJvGa_jiFpTb@{|C^T#TY>_UoTf?l4
zs>)vARQT>LkPoF)+kI=Y*^JY~zLnVrT|?G4FMbo6dR2?|8$9t_kSpMf=J{BLoxKO<
z47~zIT_|i(ob&CRsKuS6`SV;o;l(cido|F>X7G8q-NT+-fn+0h|9HdBiJj(rOnnLT
zlEz=4`n<KJ(Vc7S#Cx=T+%S4w8$ki11(;5qoPUh5&oMwMx#U*8*5!MktVz2L^McDr
z)|XiX?tuBA`n*=&Yn|M<x3aFlW??L7aY!=HKit(H)G7@f)=IPK7TNAz%*s0r@8(1-
zsDnY)#H$BRI92|nas9YUJ%%zN93)OJLJ)56?`%hMRasCA$^se5Dh`R%Vm_~(SWZzY
zK7L~>MsTEG^SP<{n^#*w=DkJUZtpsFhh<VQxk^*&TTi21ZW)58^ceMo{Od_~(b5Ml
zuhj&PD;WRnWL<6g_>S{+cLTF<-Ct4W7b|l$%yr@U`0(PXF?(<$Q-=WhNo=3T9-5++
z_A5p48)9sEWq!CLcBG^D2ARhCYfRTHLgpM=ja`4jeOrWKNqT7ysOi`hz*FJtvc&6A
zeSM**mJCvLciaQFunQeOuX?p{QLQ{}ePdxa))0wE*aJVAegpfBgQZ+1lTvWo??!C`
z@%lso!TMc9>$x<~{huX~Ezau87k@R>4zwlL?w)6KJilz<f>_?X%vJQ}Viqid21J?M
zlZB7=YPgT|%3exSs(E3b?-pVex~;2?wRcJ0AW<$TIds_W%I<u1g=u{Ook>|7rZzEW
zQfSPt?zhsMG|9num@P0heB-jl^{8a3Qp$@GRP$@kd?le4>&4y9{XbWXUEb{kxi_mC
z<=MC2-CnUF^F_^9z1R4vs<zs<jlwY-ZF#?!7=CLx^Lcen&fO9{y5S0_+gUo#G76+I
z5sJD3gT8;V-2{-%f}1fdQp-liZJuN$v~ma_1Jo)AsjdfXI6wnr<Lm-7n~jgoh^tKJ
z9dwT^>U;W{oLW+G^&2i*#S5MZj642~Bg2{^@iilEdGf~KJTgyi-66)Q*TOM3?y<_|
zP&S^;=H<$|Qre`;`;~UY?kTYaa{R-EPr-bV8z1syJZgj=Jb3Qw(BqmLmwBaX$0g;S
zMvr}S)a5>-iG9%+rYZ<T=7)Y^*9CHZ_<ujtES``Qj+-NrHKK{mZL{IwxVAaQZQ?o2
z#PRw01?GOYV17KZw9hTE<BDy&sp%S}ngh&3Oj`Wd;@;MVNYpJEZ1C>)IH!R+&b2zI
zmeCb|*zBo#-P_p|ym5rHgC9byQ(e{jsw6U6uPJ`#d&*Ui@kcc+>76T$?XqST`E5LJ
zrEu;XnAupjUTA!tNY_QNH6QM${Y!UjnmoDN(Z55i)f>QQt;+pN+Y1sXyXL?%G?)wd
zhy+f_c!GMkCNQyzCjQIn3zo#U5HcDkAjI|mT>>rdVKV>hyglT`-y+x5{jf3Dl-@I?
zwcvMs{jZoksvH1hhRHJ5MlE1oEtGV7^AilF)Oh^l9U;fD$|)DTv-o?fs%=DKSYmI=
zH;kFFHwye#dw>2{?@wyCrE{2ceAtYXk$kRp0!8R4znm3?*JEYO=Gt+tIGyu_^rUhu
zTan>*PW{+-fN|Zu%kn;zQ4iu@>7y+UVM(}xqdIdiIlH?S3)-d$OoY?IDFh(~Nf#<&
z#qm8r#$e@#21O{ErBK#M<k|D$57QU`x}j%*&Po&fJ%ry&e!+xnbJRr6H0NE9pHx!F
z|F1&1VALC8RHq!u1`>bxt^=TYwukP{&H{M{djUY4l|nm@ht;AM8BKTPhU$;A;x$0`
z<+R0tXvifM<424SJAUV?ieY|I4*VAhWMx~($qz+5BKyDYX3*aZPWv^RNiPwshA|^{
zMm)#2xjKx~_Mh(?rzCe7{OOJ3`!y{LztOdO?c&GBrKF6>4qzogngC-#*Y+TIg7u;y
zk-%dd%T{;{zFjZ=%6lWz6SbpVuF+0bis3b0yY`yNEgx<<#~&Y~dly=1c#{#A1-h{&
ztuj&S|N4C07-b6v93(v>#%xkvZxT~Tk0BGawL}aspf$To7MaDH&W56-R!DR-<II69
z9JOyCLR_ed!;396?aR14AbX2(<3(6fhfkCtErt)=eJ*7v3}teYksk8675qkQj|%it
ztfth0i?8zQ-r^CfynP2uer3A)$<DsZjW;HJ5yK8fmQ~@WOUrI!li$}_Ng7Ss^G~+?
z{IdzKlrUFve)Zad_|1a{=@BvW^3P3`8%Q$SR!FPWs7}akM1!g?f>n>Hf-~n8vNqi6
zo|#c``2}-%<v|6iI<vj1`x{+)CGtU^SaMpPP&3;ZO|_#M_XmTaa)Zj_c+)ZQYhMnp
z+b}<LNQBKfagv^G9z?Zu;Av7jkw}lAsaP&%3dG&{mA`Bk>}t7VfgFyWNA0t8<0=Zm
zzhNPgqXsOeNlO2^+ZL${(Bk|0^iu|yf8<hPN^>5Y52WcknMIBvh_TtI(vldZ9#b!Q
zh!x5R5Lq;?ywPok?Kr47t^b+FYLOaq>rb5?iRmHBu%>y!Gt_cl%w`B@fTfByJ|+1B
zJd#gaF{jS}9W%09)#p1)MuZILbzLO=;*W1h&V;nT!%_$5*<Ra!4hh3XZRTtJMj0mP
zyI5&!^Cho34uq5VHE(R)e>mmzoo_u5(=D*^EaZ7yDUJb}R$fI=MV9sxr{nJIQBPn~
z+Oi^N@HCz-iD)UVfiTzYJ1&K21+4W|hp2-;H(ngjeqiQJEj18ezGi?gsozJ8FHScQ
zB9`O--puKDN<tlz==+Q=i2SR=?A>j`$UQo?Xcv7~Yi+~D;>5py^m|*GHorweUCVkW
z$STp<#{KeV&%J^|x@gE=Ov?H(7Cg-?-O?;mauE*nnf3<Xjjom?v<omK;A$6s!|2>j
zDr&cK7@2RY>F5vcVGv?$#m%fq9?A;xtQYtJt^@bPOV5?64}B0Fq!`Op2r^`Z8}r%o
z5Pv`&J22nW#@!pVQT##F77!b+J$G(O_ef->_V$LP_R^Ba79w>OVA|8tw{_i2zQVOB
zf9{oMC4E_Jhd5_tF-Y?gv2=@8tXux|_~d3W*TMYVT^fy%2~wKDMITD{2(#BFo)rI4
zTPjwg0r&YV6m%nJ`1aX$GJJoIlila~tv;{22OQt34Hii3J1v3Mf7>nxkly9&^<V&s
zX+}#rEwn~e*v8(FRocqY{ig|6L>b|61x&fU6ZV*P=Vnzh^}r;Xp;^7f;PfJ0!Ak4!
z^Q71|X%Uf1vuMXgF(3L;635z`lLqvPYc39qfzgowN@C!4>;w}DDrR+N5+Jx>_;DWf
zO(|gaa#SA5E*}7-M6^g0s~f%4PE;)(6ww74ALg|o?u&T?VVG6oAu}a(le2@#r3XbP
zIP2pbj;Cm?$%IbyyYD_Hv!%$vttBpMKJ$jZFg`8e*mqh=H^`8E+shE5=d+~F%Tb~o
z1~K-HY>0v&-gY{Cjxz3Pr$u`=I`cNtpq$J$nk{_grKOA_cigzSY`KVf93q!u*ERio
z2R*CwxOJ{Y^%PQPU{aTX{6$>WGWm(9+{BE{qApXoLXIxVk!j@*)_i~3b6~OM&}+}#
zPR)k|J6$4x7<b44lobu>dENyHCnvxpTZ=h`91@^Zn`Nv=;Pu7!W07KJ+J>{M(=cT)
zVX{va@H$H5UhL`sclTcj1DVT-=JfEB&T+1bNYbmG14Idle6bRufF7HJVSvsJ*2<@u
zrjOn!hTL0Lk;~j3v=K?Hbm4t)JpG1aOYoI;&5hoa%fCE7CviWUUbrHBp|ocjqWd$j
zhz88CyQsd#H-O<x1~g*81!VkJu+TtE&kZb0DeTK{3|tYdR}WV-WQ8cSXWMbJ27DDd
zGvAiGt<!t?L51LR>Pe9u<RMv5tKj?@{Jcf0rck2SYDiU;0&l&%fZo?DvEOC1u6kHX
zr1cETze;tYSm`l5tlPoVo!!<__I*1NRv8wb7-!Yj{%MnXys7%Bd>JhKmV=XfXVkeW
zr^=h0{_Mxw9(DZjXs#0j&R#V966wM-0KaLzZFhFfbCs<5)mgZQItMYFE#N_hw&cv#
ziKE5YyO`#xN%5uA#}}QH>3z}dHk*YpJ6BhbBXmDyZ%ylSu(Z{2cu9#AA-g%DxrQ)t
zX<P5b>8zC=<hq}BGjU>U7}BN_`|HX?Q@d28`qCVHFXK1GXr}9MJ=kkcz*E8c#SgF_
z>3FXxCHx*T-kD7L#SvTcx+bfkQ!=Je)gv_5fl1D%$s8biDmD7xMn@?^Z}Y2@2LRd}
zn-QVbG6ij#9G-k}eXUyJlK;?i%Rlzcrl6P)QQ@n;yr7<JSI(d8B7w?E{wj4&yi@w-
z4?P3*Q)L1tEFb)sAHn{<rldWEV}vr;O31iG6~k<7BLV(D4|+U#Y&N+4q;XvwKEGUV
zqhck4M2EVW5j-%*-B0rXvxjuwxm(xFM~5Lqn@Yo<BihXb<2S?o>wS69>wgz*g+1zo
z70re=!m|Z`ZQSXy{aMaAHX8B1@tq<d-C~L>H9d@6Zv~x7zvmk`Pt38|#J!%JFN|WT
zf>hqlQjt&E+&Xr*T+A{re&2MoHBj+WxZ`fB?S=4wBW0v$928%rj-X}+s**uCJ_2+m
zm+RIb<`v}Fi1+=7?Ckrlyfr|bgO^gez9F#Hb@(F{%pS3=4M!IBxUlCeDlZPHh~X(^
z^IrjiX)bg|0ML-=BYh(?4iswIzyp+-Ib)Dd?e2n`ZflhqorJQBM0obl%=oS!hsa?P
zGp_a&a`y{O`i7Iul>w}vOQhAb4z8L~Wa7RvxFOxH<ZAF>i0vy^AX(S0j=tBaOOa<$
zS@HRWPTmg6o7UfRo0~w-OFA0gy{BB?reD<)Gs3rU?=+`E=B`p~Anap1chU}lk@~C!
zw28={z0WqQ<ZEDU|EHUha2g4iwiF&Z`rM32zd$T)>l5*~)3fGSS3?{CdEQw9I7>al
z(EB~2`q7wmkvF6NB&zW7lqMXpR`82c1ck3>%7S@JZuNudsJTxfHNK-BoHx@%=+OQ7
z2x2q)M73@QoI@609RFk8<ld#EL|({Yxhv^~0A>`WIb&Eh{tTpH7n>bt=>2uqfm5br
z#<O3e4K0@>3LL6N&L={m_$Nhl&Wv83I_}?87?>~vJ)6$xm}@)v`**{<Hheb#x4az!
zq-=MB-PVKR(Lf>r#&Jide6V^k0(}X0G`QNkrZ%C!n`7@YZ)GMYPhTM^EoCU}jKzv>
zAGpDys*#)V3v^c?VGo-}LACUZu3RY-m1mx6)8j1G{S3>z6UYAla&aihwa#*cc;hPq
z0!Ury0*)8KJa-Ns%aK;gvpa@`lBs56$w6j<TyA%36=A~fKFO2l!c#3KtCDcvMa*j&
zh?AOw&=UbAdeuq^2H~pF$iK9{c|?E^c3s`BUQkNw-g;GHPb$5YztFR&pFaWa%8961
z7)frs78qSw29RL74cy8m)ktkH_&%RXXElb#LSy)Lkj1=>-Iv=)CVhwW=i{o4>?8(0
z=}N(ESXx72%L$yqBC#jP658rKHl8^N=kR^03-r|&zA{z+pg^W>@NV#N1)9J6cG#l8
z6Q|RV{1Emk-=3#voRWU#&t@?t(&mzjl;ey+MYjkMEr&I13k7q6w_<9{uLP}v(__n4
zLoc=SvmzuCQL`GS_bGM4Z3HtFRTOwGI%(Uzsvgr4DkZe&qQvZhWdBEK5^hOdTI~i-
zixQ@`w;?>&-+U3P6+P+mNb|wuSwOUfj69Xd(fyHHa8<qc5D)OIU1W%7lYecp*pqP5
zR?!ewGM}<&DYw0*zOH<dC+Se|-h+{T?m?~9IVlb<gBplR$Mu2RMDO3VrHUSP25;L_
z>{IbyNHq-GV?h4cC@>b@TPy`Rb!_tu`@xTRI8=iBVdMmX+3emG)xo&fl;>BYCZY~^
z2XQoO!GK?nkM+4X17j>tHa0icPXBUce7pYz@pO4a;X*jLpYjWA#KQo^QQlQFGw~AW
z68;%!MW~`lF;spvs*##l&^DO2q|3Oy&4aP^J1qU-tx?Ku^9}=Vd5yF0dC8*n9Z)LD
z-|GviLGXNw!OpJ^`_|}Ha@RjqHO-|-TVHIv#UHq6^2<B&WIdO7Mqdz(aZJ`EH<t^$
zE?gjVrr;ZK=ao$I8P&>A3YZy=hRD)WH*d*jh<M%R-NR8`LX|uziF^8LF+*arc7)l_
z;`eDPpBUr&8!7#uK@3iK#JnYB;AH1nj8H?-FIx46E?nmX)nFlv%6)xzFM^tledNlV
zl6<WJCtm#iJ^y1NCzf%g=9K&d)P=Ilf*^GXw)pQ78cddl+f=LHih>Ob=6A=HLx)XN
zKT>jp(5;PoGH|%o*{r@6E$6yTeX6;ahn)iV$p?Zjsw&G%xg{50i})ItI8pM)A{W;T
z11w)Y6){$^EJ%N$=Aa46BOv80x8~(WVd6Z(6$V(_*FrFD)>R@dg(%iCpFH9?k%d4P
zw%O|Ehv5d;JLT4*hILq|CSt(9s!8=cg84eTH?IYZw;`Lx19c(phjUkGQW{|Pu$se7
z(i9(o^>=yj`iC?bZEHPS|1MLGcg3o*C9*_4d>C@u&59DW9bn4V?ZpV&ck>}ZfI1f&
zY|c*YfJ%54SuHtmlmBcoODFbk`+^3`MIL(O5<5p<$=X?<@X*&{Z(f^OC}{E77}qyP
z#uv^nH+`29va6ZtpSl>YZc{;ve~Jf5P+6vaW#Jkof77;McWl~*nR41b;<{G<&Y5%>
zqt&i}b$9!MZCzdvI6bLJy)^hoiycG_YyfiSR5%zFpxabL(*|;B=?@hkq>>tvj5xvS
z;x{{pz=Cxj#TIhAHl4|*DeNz%p;?z+w&QDxvs_jN7qCRDMd#zk#(WrBs!{T(1xye}
z)&dSXN!~pDY03M8lw6eV65J-`E?dHR?;2K;Y$x<qESs0Z(~tM%a=yq73aC8T>32%t
z<nvDYJkrPpKM6~JOA%XK(9z4E;>n5RP5UsGphz^0P!|7656L}<pdQX6&ZK&ODD(T|
ztwps&F+7}94$8T%2Hje;uI3u>yG!jhrxFv$-8`cVb6P<i{yn>(*iKZ2)U={T9(U_j
zFx=n!@D#sN{Ds#cb~3X#jJHeFCSE*hLV!Df1^h!P#dMdwISeGS22l9&ERXYQWS*tQ
zI4pZjFS{*!;YpPc!_!vIkr*Et?(@Y_4p+n;3Z)5NXhkN2cQ&j8<{b}w4m)|e?&gg8
z95!ujV3OO~X33}J7x)(V+2tYmA#z=sYF4;Z<>4EQHA@{y88bhgOfu25IOXX$SfgF*
zYoj<dDXSw_+6(fE(H@n)NrF=b1Aed8B~~6aE;?Z-w)j!hRBPeP3HOlgJM`H~5?-8=
z8>;RXuVp1F^IYT)VygcZqot%>KxgZK+VU!DdHGP%VIp~G*1+*6sgy51;q!X7{IQO~
zlUWeS+mqr1Iv$q-WN*M#S}MR@&s~T6Fq~lZK%AZPlb3rb_rmvv4FtMTvxjTWHNVg`
zf<6EO-=V!C0tuP^DpoBEYVD5-Ia)aHpP67xnHfo$p`Q0_O|lF>dw3&(8r#f&?M8Qs
zGqv1aHO2W5oqb;r&(Q+436LLzMR;)LauL>5-0y@C`bnaAmO(S+`gWb^qd_{aJ&|zG
z>KdaSG++KI5&Kn&{Xc;s5p%H7{wQei4lwTwv8KFkYOw3Z2jfkn0Z`gVM74ENWjT8O
z0{;|_RI=73p+1x?-IH=7e@pi0AUo=Q_%Q1%j>h|AFbWzu-SN^gswd6XmBxE9SS_UI
zi<RBqz(=8Jh8bY`D^FhD`sUm_uGKU7X>#o+`rQb0LURR-5TlaYjtpfl2CL&7E-t+Z
zpKpdm*&I;%C+-KBa|{BWvI4SRK#4mS+_8c^1YFo9DWqh|T7vVOShnukiBi7aH}xVA
z#5@ee&lC@v6EkG84K&Vn)dDy2^#lSvc4w)@*>4$1UqVbOC)IbBIa;jtvx0u6k#1M_
zPT!4h-KV8#k?D;_usJFjbQ#a$leLXT^vWP<@1dEf6UY)$4dn1;rsi2-&O^Yf_>RqR
zvDjLv%s!~COssZ`u90km9UjI_SKDnW1Yf7|rfLK$9*^pnvD=h(qgZtvKhxYaN#n4$
zc0EE3K~Qnk*<jVdJ`OER=eM36#L!Tw7g>_>Y3ZuOw8!9V35}KE)<u}x@5}RCi2dbz
zO9P+F*skw1){ECvTMSLGZYRsQ(S&EQzs_Zq<Kgp_P6Hl;f>%<8#_%<&AIuu*-uYrS
zQa_q6Ovq-^4+;&ga`vyK+fELgsG5-Dk8R35`H(Sdqwp$RKt|OupWPdi68n++^0P;p
z3~iO}*h{W^*kyIdct{|F9Qk}u1r}zvx%qZa>PrWZKw|K|c_PqLiHvNvLMv|7jANMW
z!Rio9%~qGxGtx_e34rv}URSHF{iqcj@;imEZ~<qF?)Wqgf3l#SkO>KJ9I+ahiup@+
zn%98oG-Oea*U->5|G-yTbkB6$l?wHzZ2&XNF2@xDXBhRdYJ9SyM`3JHNnqB`x{$PR
z?1hc{T7yZGd(VEG-@5mUAFow_EMUO_vF0^9-+-kY^tjR!3mQ#jVav2{qCdpSAZN5^
zx|qsPdkHYlj{0;%Y+VI^M$F*^UtD%#ok*@_Z`FrD#DW4l>l|$GmQEXoI`4H#?CGcX
zy`PpnrAdv0@|f9Xb`X&tk7o*G0zm8s+L?FU%7ukk=NYm|0h$)uIRZvv<Y!q3GFwC|
zAWiu&7{%Q_c8$i@4Sl~*d`QCpobnLkfX$6g*118zVG2Wf+8kgj)Yj_1xghF<mMjwo
zVrhzP{y?HkbMR@cyxHAgC*ph}+U5whrmCdya1MK3lRGP{{e&)M7D+x^-yLJLy+tPB
z)VH~awlPWX_sLMloUgW~6)s9CdHQ6W6iq3<Qy0zPx<D%Kbjgm^aqS~50Q+d)`?a4e
z`qzZEPltH0VAV9v%^i@Y_&HTayrR5IwOtu;FK70W^GlDDgFZzj?0;;c-R$~!d*}*)
z4j+h#J`MjaAfRq0?G*p+28$RuWWLs1sT;<}kTbbWKT?^mEk-b24GcZ6i_dc2V78OC
zzqfQJR%0X3*^Y~nn)4U=&^kAWJ3R2|L-kF%OVoeus*QQD0Z?zWy7_TUz<>5k?<8ZX
z3(YZj)+#83J?Vl4@yw;i=P^1Tjels|ESU@KxeXihUZ8bWeVqRS;d(ne9u1^?q)IAn
z0Dsl-)Ei9;qBP=6)8-~|d6ta6h?m_wYCW}NX17ysPGv-n-um*|GyVOqbfXq}W3MbK
z6GgJ!WEEuy-`rE-@z6Gru(n9<Q%XMQ;pe1U3heiNm6lR|ZR9=0CMR-5hY6B)DA-BI
zxaf^P-96rQ5}fV}{Cx8vdIsYYG}L~%%MMVoO|bkLBVP;?A&D)dUQPat?AH@oPq0xa
z2C|qm;9I?X=-s3-K@~-m?RS%3yK#Ttn=hZ6O1rNuc}8_-zVt{UY<U<hVsRq@=V2lq
zMuf&p<?jZpxM(Kbgu-*t?et958d{D88J^ucVk}?9=;A8=N#I0f_@R()0B&b%7gc;V
zfuCoU%*Hbsei+HO)O}cy$-MhG-Jn1a8QsT13mC|tz#rnyPo%AA=GVw&rR%trkVY+d
z?n#16y^$}E^EC9TRaYeX_1Jr^pxTzuPv!;N?V&ess%N2&D!e+H^W%Clm7ZQLs;%wy
z)j2X(>Zj7q4tRKCivoq|Wh_XVmuE+A8?n-SVmn}BzSm7FmYq#n<)HHq>l0KErmOP;
zvbS7l;?Z;mtMfd*U<?ue2|7H<4wRj!EYRbVyxqcc+PSI}L2d3J8Ak74e3jt5y0iaT
zC52B=Fek-SF5YESDq^9IUFv(#=AWPGrGd)@ON~pcT*Gl^yMEd%pmm=HvU4x_8F2QQ
zM6Hy~z%nAX);Egu4NRCC(GtuQ{9{6wmIC%iF45)<&N@=MR@@Gw>k7h7))-{6^CoQ6
z;vq6i`sBx$w{k8?C>sgcdb2s1I9sT$o3v%h+3Nu>@QXXIXIV+>_lqlfycvZ*?x7`v
zXq<w(eZQDQ=&=dT3RxR*L({_0itf1vP3GMSA|qYgAEpnjF);2nIkK`HMx<$Pxc}AP
zqs3x@Un^Gi(=tk-V|I3qNUSBq=MtEzGqTrvJ3h(Zv@AaAFAM2K@l#xhpCBiHj`RUd
z&T@#o(&>TVEvT}p8xzJYr-c2i_=pstXuhXhW{XUf(ZBbpM^l^&b}F{fO>UaW{_;Yr
zp`M(^lmpD^+aWiwmAfh_$ISLsNT;B$1+qocHgrCDND3sY9Up8z7M$M(q7Iu|l>2u;
z(El++y#%kh8Y3wD<O_~ak;&V|@N@k7+Tj5{ugnh>ahov(9ayT&4|&hY;jRrqCyUU&
zBQ~O&Ag??<Gs+fydZFnEU2P)wUGr%hNC4Z=d#0lI!v0*s$R1o_>fRn`p#)j~VBofv
zu*hNkY%p&OVa{y6COZYBKUw<S)0E3959wd6ecntYKTt>Vo$!<<Cv=|6b67Xwy_l~=
zJLZ)lAars+c$3rDb`<^+i?FxMK(x7%dfvaOeKR_L>JI3-GZel;f3uZox4G~{83W{U
zxc^h&i~o}qY^&JT_tK~Ss4I~L%B4h`Eg$DvLX8JO^S$OL$drApg^>ER*cy^2g3`&~
z@CT}PeGw2~|1WIK|K;pHfz65*1!%|_V-I@GHF5DGZ^E>`rb?M6?30P&8DTK%-R?vw
za2BDWt|#=VJp>L+wp&AV_gvTaKR}VTw`>+Vk<uxLE7hy}a=5?jny2{lJI@)`hK0Cb
zSlwhY9!kyeiB{Y9^=OQP%9e=tDCfQwQRGkfv^}0;%hPdTv$=onR2qij1lj3$V}_(H
zXKwSpDZ&BZc+$2Ld$Ujqf+mmXj!hm{t3TMD@`1^%GuBp=0-$l>^OWi7F){ofra*(>
zz8&R)&T!7ZtS24oU0nfIH$nU_`5wt;o;-4|qjG=hmzZ~!0TL(9jGV>*eHU_UFD~na
zGAw^vC~76U)*5Picj<MTKt0Qj{jNH7sMPhq|B2T2kY9oKpQaZOryouRVq6)Dqx|_>
znom?+bLVT<$2O<P%Jym+C=8I5iV0gxzInR|xgO;i#`F}&()?G~_byCsg^6ejsgW#q
zi|1_hbl~a4PRK*0c6)&jf#Tzb7lCJ}861&v`-c8K++9fmu-6Vr?yS6lIRLk$FjQ{2
zHc72Q)FQPd`1ctdMj<LMoNgQhlP@QY<IUk>3+((XWZmOktShD+%%QmXP|4<;!&zOt
zR=a5_7z+)Yid5sx-A?!dh>oHUK##5|$AW2>A=G<h0-!Qn%`>`*JVbeNt_@)hbZ=G{
zBpqr?B;8I=0?I<K8Ql~El%T7*J|>2k{Rj+0X#N?QJHU6!CCo_F1dsyy;@@+b<Wr=>
z-0h6~n|*A}eb~sV6ocJ}gauepx9EhAhg&nmbpw02#3m1aJZ+jN6{LZit+=9$=^G<J
zGoGy&*zYcbE|#mO-kIFM0OBknYU04&)!#oQ<!EUgrEAHiRFWIR$G1`*QE$DQ{$7G-
z?N#m4QsjWA$NRc{sJ8Qdkgw~x5@eyJ5qgaGDtV3y>rx>9+Q#;Xkh|~scZUC`a-nVd
zd=aEUWNE}s=|pe6%C_3Ap}n#9AFzju8?5SN9uMgE{2wzA>Py7acUJYwO$Qn6a~igP
z7$ye%@)5nvjG{}){*4|U<WKyoOqwQ=N`pP{)e+a^Z;aWMcIV+XWU;X>v-3q|krBMT
z&`)7-Zndrp0%V~`ESr)!5x(E($!&qAynKDp4Z7nTol-5}rPaeH`4?Bv^d%ljN$Lw^
zmuC_jWN|<nifkh5d_z1+`435j*i%1Cp3vrYkNH`&ZJ_M4h9}iZZf0WG-0qrv1X9*s
z_Psm#4@QXg-linRX(nf3FBIPu;>T|g+A}K5PCNac&wq2%63wSl&XgTY9z+>7sSp0r
zCT)g?57&-s^*J_-D$PTwjMG8qRxjIwk&QL9dq14;2o4sNy!FuwXh}BhkqvgZ@C{;9
zJDH@3;1Z%!_~f{yYs5q~q2JBzf;2y*C24OhI$8aCw!uWTW(QdTrm4;*7F~LMSHnCK
zx2ZJrH$<)+sGl4LYv96Rm$=cQ*9MzU432#P7%ndAw({*CWD)GqF*V9lwXKK#yKq{c
zl3^;2nD*z1R(vS-Z?j$?*QasYPO}Yvddj0r9(7SV{t^Ww^Qc>#s9MFmV1$bYC#wgA
z@$H?lWj)^@eg5UVkLmMV%vR8*kAR%zQoD(0zv&`QER&Ra_;-JSirDKE&uGF(h(2c6
zu3D+-!k?#1KnANZr4ak|EvgaATuE>rthA+B%sxoWEIKhgXwb%+to-WTx@b30p1{Ot
zdIZ>(1Qn&|5CPDxss4vWPua&gq=<7RuUzO}#M8sxJj+bsiUt;u^x<V1VLg%1@AwBn
zm@amKt^_wXaW;P%{a&H266w;jzztGP>{^S_cfAPzT$=G2-aec37S^v-6y@Zy$r$8j
zfKt*!H!a(dp#(jH9U#XlP`yqWDKh`mv4vYFYx_YpqMT4)C)#yru<yrD`S_7%2Dw8L
zU8*)ml0nDzkxEUuFen$A3?3YPW?apA$mFYuZ`t?mHYhesR^GV%BlCpS3=!h>GxtvP
z@_H6!qT(?My8J7B+&jXPxoG7gO7)OV{g@Aqg^L_Ul%E?DyR@r73+#-b+r10!W8^ok
zA~z^nKFvTRb%?f0@%IGUegM2bmd91vby@V2df!DJH^pwVEI%=Z*!x@U0iWlX-sCZz
zRkeELp%kyvzsV=`C+?=|HW9)9;dvocAyRsG@5$3`KXtK`v=ku<)7V-z{*j$o+pY62
z<=)ctX^hi|ErSDcF@4tQ;m00mhTZaX{CUX^_HNmohTgLh6^YouA||KCX!y*O_kslf
zQv|IGkiP&tU_AAT?`iDe7fP{^*pc%<iz}%J6oyB$228Sw@4zp2Pz<3L+mBsoaM$2m
z#{K>ABY<}>A9(J6X0Z-;tncM`>(u#wbBwpkXm+skEdX`jNp?0^5IZV`#!BqKhvNpW
z&(0FV!`sI9C^fZEK~iSa6&gsRIeJHrMtD@)?40mL$jI#M6aWxjM2P{q>cfLH9#A8q
zSrLydbjH?MgQ$SxH%puUm^Zzt5R(AS^u+md!4>+h4jl!UE}5h#G3w1ZP<H{}lf(;=
zYz_~tjeGVBvpdiR6z-z(i&AF1%73@B4}RtA4zRQ*?yvsyEljME7O;q-OeqPJ(oK`N
z&Nt0?5{o-%ox!xC!YP+G5AY&hX05xijWnJS9MC~}JO^O@_uw`qSdZ~0@wFIHWHBCh
z=#8i5w---^ch*8xsC)UP*8dZ$7@mb=3G+M?_I>yZnY3EyIjTbJ?ZEa8jO)Kf2A3MJ
z84g7@UUhv!%RcT4L>p8esY1q$MWv-cT-vm@qQOhZ(E1=(Y7q^=l`a^PQPlq2>3*@f
z61?TvI3=?ufZp`=9<X=b;Cwr~M^K5mHQ0+hU5vII=u5@P;_kd*hSCxm^B3}0nDXXf
zJVpvwm7iQ!dXVKxF$X;lbPB{PMUU}j2dL8JPh}21s{K{IZ5zBPLly=5=c|NooDlKL
z7lIGZLQ{F;o#mE{_>}LdA17AFayzAJn2Bv*ymlOzUa>1s4+1%ROTUn?K}W}G>{0Jf
zZKuGO+W&tCKuUkGrgKONSy#@XlxHC{g?zq`Qp!_plk!z=;OBI4l(4ui*l)Ad*5Hi|
zo~|CWJ!l3je*14>0w?FhLOWO|Q&%LC;w2iirjm!z0s;A?XkG4eFYrhxf=Y|_P}xxX
zZzlhHN)F2`zJI+S0l>wLs?LkInDJgaxg4$ZI*asd)T_BIyt%Edjp{W!;z11fON=@i
z`4T31Xz4q8p5WWsO#}ko!(h$f5i?Qe{^w8wX+Gld>tQ!}Xf!z6KB4?0eOg~<6aUx2
zo@qLfs`5(*UD?h)(SG0?z>Fg&K#E)H?2Mg4csOO)9US>>Z8&heQ)(CuL9wHEU{>N`
z-lvP!S^uwas@JGT{q?rC($;`k{Ly3qks{|)?IaAV#pdk4A2Fr>4k%ioCw5Dj#e8^<
z1Z(owaIVOswpk@T5ofmbQH?>J+gk<kN(lVc&x&)^s?wNM&SEW~PwD(Bn#w-d%kk~s
zb4N<zrcUvZ%sZ+!Mr(AmR1AtBACm(I;?dPUU#+B$qjJ&USqZ`W=<vT=plKF03I3B5
zc%f6mH$N&i`{;p*)gvMs2?kBxo+th{M@zPM=7>;<f93sqdIQw5+I2R29w|)NAFBJG
zX|aKop24mE7zIlvme%-g9<|JWg@IS(;$+lfYWHvbkbS<|&9rif)%b}$jF=R-3$S`R
z?zN&p=1n)3-=fmdp%VC^VD<ieA>TiA9gw>h#O|Xk^KE!?XC7#$`%H~-O+nkkDM<_b
zY;Jr$ZlPW!m%ah3!F7kMi;f3g+Zc)s2tcLde!6Omg0mZ5XED~rKJR$XZ=ZlJqQg#~
z+Dm3m5Eqqq=aOPRX)Fr-pu9H=I7NqqX1HM`Pk*edJY8Vursej`g7LDke>^0)<uS|3
z-xq6gaS>RB>B5RF-i!3|&(7v*_|ou+-~5~C;dlW8RWDxD1;LzF#1Vf|jW1WqLpl6{
zqs%k#MPbmCt~s`QC$N!N^-2`{_+A`?R=riV3M*nhcOLb?f*EG9N}A@h`Cq4$_6i78
z!;6bc*MS}8UiP1SU9viU=OPYPSAm84^*Knw^;uFS9rKj(>Ylg1NFlOeHH?YXoy%1N
z45{3Mg8$C6P@>gtlT6_V!33Q=y$D^YYKB_WqfTbp?^u3{W$l8{{!c2mlu`J82fgeq
zPHtwF=IWPskhX*rmN&_v6Zw<!*gIDeUhMZhYZHPaSoKQ{WTg`^`-|UP&zFp04JL85
zNu|@qwG?)@S-uY1?p|~BI9Ee5b8?<+kNtyNv;40f=Md??`m|cc)KHC#Ooor2{4zPU
z)un99Qlj-<0?mSebH4ZW^qbR!BiNETc&Wlhmd4j_Hx32Xg)&Nv+@;-qF5H|>&=p8i
zF0<H<oqATU)=ncwk^2%>4RByQc*7jhmOts#*bO&sWu<qRc{=g(&$Td-g&*>`N1Lf?
zVG2xkrVrH&J6%%wijN<SbV@%HWkAKuq8>JHOn;sv{&{Hwpui!13#v<M*ommciqg`x
zi3y-n!K!699K8>s-jLf<%KXcZGbcdbwFXN|9AN$9?vDVTu7nujw=|gz-))lq7y+h!
zOsF6=dK@805bT8U+0#=xx-+y>{OWJ|5!j>RvmP5cop;#m@pGsxk?Hv%zmrADl!B7<
z^yv6GVH$Dq_)X}A1~n7`01198i>J8g_R8>tpNDJmxIdH2czSkj6ypBp0Zm>>YU<_l
zaiaz+awT_anOWrEZ8r({J{AP*9q;2yG60TV`<jB_W%%JFl?Ex>t>Ox*tLBLLaCU0K
zolb(8&MPzL<jKsy6@McMbMj@m%~kO~N(;IHym34!rx;XkX>}KXlV8x`{T_9rwCA?#
z{-JM)A@5M4sEh%M-hb4${h$-*TbZiwQaim#Nt{?EAMcAGxx5SSQ`AWjgcA8k3|?wC
z^1H&zp89j{*Kkbb7~?8WE!TBH=XkE7+HWAy9J&|AYB7y;e5NfSIrRQ@ht+H+*qAUK
zOnu3P%usASHmyrpk&!=`QmOMCYb1#HB{D8e+!gtd)0vHINqP5jp~cMxkwv-icUxlH
zwS8AW_6m$)HRXOT<xw&>5<<lv(xvBUmgc9k3zY=3_0XGs$|+~oYn`vy`n4rBz)2G~
zGt@%`(qZMB7xK>7w=3q;=!Zu6@5FxHWF?~=@=KdYH$bRJr1?ltC6fh$^O6T{mS0^U
zy({qh9|73p^QNe_2uS|SNKw{6q(yHcm<eXuzhgD#G#>gmRz8I+PJR~KMLFp{OnRyG
z>UDS_O&^#6!}Se)H#vSN62i!^QN*bYZ5*@O9z@yn9T!G@A2=aGbLaAWr`C)iO5>k!
z^++&RiBmDL$U2>$KAqxkUlTO8)8}5$q|M|%xIbv8+h6<cH{pRt_HswY4V6*#vhUH0
zaKY(kGp8Qf2S{5KZBzLi&sKdbZF7a9AKR3B<7N#@0s`pR)~?<J*|ex@pDmA!TLH0t
zBFLNhC%R2b``w@2{y%jFL2YZ-7$Y!3Ad;t~gb80)`cgy)jJ&xzN};60ra_1@)hsc#
zIV?Tw>nGX9j(A9l$gm-{do$$(3jbOFzq8M=wJ1R^07tfjG8s^xXKyS7l>&X`P;xN6
zc{eiac8oM1#W&<4kH(<1a!%=YYf%^P1b%qCUJhCEu28IYEO%r5ZrsNw>#K<|fo4}K
zum1%e@!0joED1hLCA!kIxgMAF-M|Ao$=qu6>ED9RZiy(^Ch}<BuOt)=h5KU5GAdnJ
z_)8CK`vY5)kR?a6-39_HGDGyYJyY?w2MD5m2Bb3PPoRhERE}Vyk>BLu0g$21jrB3n
zU>O=>uzh+0OK<)h!bv2+_Ygn{d!xLhxS=HDD8%SP5X>rp1hJeHA2A-X<sAd!u~N6_
zt5dRN@vGY#@Yb21a-d@<ef^4QqRIs3`J_$yka@bvZ6j3rl4t!PGNqeqjooPQle46Z
zwfA3P$b}E`L~E)0z)ro&2gET=;_$*OSqP1%=Zc&9uDIe&g{%;ok9mp%<e%m;S0^IN
z%`X&r9}v0*y8~}EJS=TKVQlXF4Vc3A-|+^@0#hHIIfGLo#ph8ji<_N%p{CyJi@aA`
zF_8MWcXY+fFPUPX%lxsxr$VCiu*~G^_50eu-*%BAyFv}xD?-g1O7b?a7Yg-%Hfaew
zW=)ktXrqHsViDn1LIABL=TYcLSDf)EF~<0l<oN?#=s=)Z1UIvJ8EpXmCT?-jCuQbR
zA1b{7bn<&(-g)a4Zd*@{Yezv}z@bi}3{73gizhd;lYQcn>iTHydS{Ni!g*6w96qlI
zB`Bd@)eXU)$LX$f46$59v@5@(yBQR9>Od?$873vZK*u~hx-cCKNw@*6O-|2x6sARb
znk;lNg+*18&O1wa7jiF8(JNh~%g_Sa!tCR%RP&~LaM0}68SNluAHSHv1sFXdTay64
zKNCK0?)Mj}#zX%kw)Z9Ky+>KKT@+uR)E0C13d@>KmxP>tWr|FEnm{!<Rb_fJyf1<(
zyXpl-g<T*^Q8s0Q%CYp%MD3oKW!*QUFkCjdGwjafNtkEyfV9Uy<+n&?H7!4#$C6hJ
zprCN1BOBwx0~X24NQt$yXK}u!$hkcp1f9ZF{|J3ag^N?NuvnS3o?|6a3vlr{2Bf2d
znL*YAzpe|P0i(VzFRIm(Q?Z`)_(Vw;@#S&4-yVvO*Q))+Ay@wRe_%tP3)h7(?U9n}
zo-o1gTv(=*-UF@opCAmP#py#lpwCKvpw7(X13T(o(2edj23R)zx8H<fOL0B@j=>n-
z+Ov?*O^In|{`)-k9vh~|+#bO-br`N~2`Bcww8H5uO|vD?_3x|;xcZWnus6(&mX#$P
zdm77S_=6j<Ed%=1Pxe&q9)t=9@v?}2e3h0-Js~Qon+GYal^6=BQ8<$hIkx-C^ENEq
z;h}l+YEpA{2!oF1&saqD-MkO_Y`X&Kgkh{ox)tF;+?6PnACHDlG|O+WJYZhExJu$q
zx68Z8%ONosRG1KM@u!$F^5VqRC?JM5q!f`=eI?awm1;1r&N+#}6B9u+P#TXg(M_3t
z^lSQ<r=GbRHDMYi4qcJWy?l9_=S|ka2?zY^?t73Q987`+51wRvJSF-5dA##9VXf!`
zf2SUSpr;>5vba~?9WL;LMJPhK&w{IaP4s>+R}bQE$pmUVlf?G6uux#H?)c}Zi~2y+
zf|CD3nQT?vvZkBe^{@jLK>65@7Ik8l64t1M<793_m0RN;nwUUB9Avz}QJ}|L#ZCjr
zRPxE06xS3NjBdjo9$uDnP=crnhAkZP<o^N33ABHeh>@_$VYOuIQ7Nv6RB;v5(Ondi
z@(_J_FZ!3hRB`Oz1}rOfR*3GKal|hvN%9XR6YPZF@60^Rltz;MpWXB%Y|<}{@@|-l
zs)uiKX5*<_JFnTU>GImaF-pK^Bkp;wo$Z_9_X?O#m2Biz^a#x}U;cPT<JhQ2&k3K*
z_4>Y@K$~up0^@oNQw8*vuF{(*M`jOOI#aJR>QKbuc{ZCQpWK#yP3*Ign%MMQZHY`S
z;iikBg=EIx#Oc=`E~+%qR~1NeK6+qx(G9f-3d8q@lZ8qcl4E)tO(vM_9}82L<yd_A
zb?@z((D7F4{`lTb@;u5!O+4ifYy1sM$Q3b3w@N#$puz__-<l!8A~`CM>EA<_Ii^a7
zI9DxnosWwVRVpH#*4}@v4tAlDMd8)@-c$)h=_`g|`&_yTT~ohxSvXvkCj+TI8NzVd
z*JJB9_3PxH$hY-zTrWgVd6Fj%gM8#wR4VwxE(I!H{$uz8@S9PMv9}uXkaV}1r0?B;
zKY9Md6vEQhW-Yr*DC<+k0dU?lV>eX~`B!y{6>{$Kud!Xz)sa4-g!IBo*YD@M(O2AI
zN@;j4&nM(A3_46$8gHrPmJ9d3zyk=n%PRxV$|A(XR?+t0Qc9kV`ufk}I<lC^E;0Oz
zWg>r_?BD8zEEV}GZ}52eSGfh*@AN?R9!g&GoMN7D6r~54DN$}-Efn_FJ`XT*=>GzU
z#Ymo%B9n5GhIB7N1PG5vTcV(0+|F~0C`1Y7*KGmTtsa+Dg*9x*6=LgX7?FF58R<PS
zj;G0V=3lQTU{RL#Zp#D)k^^0wTajJ*Y2#prYWpw+KJwtanUe5@GiArmLb)OQ<I6C}
zH72IG$lr5hC-R_HdbQnoqf!C7VkTzhSdH+~eotS-KNB&5WI3|~5PsxYj{axC^?XQ|
zN}+rZri0-Id|%W#UOmR9|LlCA^R!Qxt@ub339&IT90P|Tw5N^czm+DZ?7$^sE-b#C
zhb+0$H3sG(TB4472yd3tOG)aoNjgMyf2TiNcxeb4a5;jb!!3;N>E&~7u>80?`L;~e
zHt$X=HKO5?7S^m2iLOTT{6QZt@YGi&9v@dg^*8YjkbzK4>X3<&XfH~@*dqV5F<S1P
z%Mn!%{8APIyW}T-mneXch_AbWUMsstg5Le`OX4wbM&KOQ0M|dzcmCJqgDlK;C7x9N
zdaOv4*XlBsQ#VHp=qU>M0owH74~IR@@Wmcpp}RXfuK`i@UsuIYi%Z#pXCiL(h-*~r
zS17K#=_B8NfY^!4aNhU)%FK1@rg)VRyyp@(CHw(dOi||;)9SqL-RyNa_`c;W1WUCf
zQnP|P=}vW=pmdCW#L79<<z?)k{gS5Bsj{^$X*t%qCf13hq6gMuW-tD(l39y4C5GJl
zI(&Bks$KoHJDt2;N$;711C^Rww_|vEl`tSnl7`_VXmUTy)qZeUkZ!P)@S9o7+6lkl
ziUdi!spBg-0Dws_-3O?U4^Wx5woPJN+XRR}<-XNC0G5_0*AUD_5J{yAYCJg*4(`U>
zJjyPF*DJSBzpX`uubf_a2{%Tll@*m$LYx(!Lxh{v(~Ii0$A-eC5kVrs7K~{Reo^!T
z&;yp<eJl*lOgzSlaz0w;XP$lMQ+;E1zocDXbMb3H_a-Wi^qD}WX9&W)H<Wu_e*Hs1
zf3qxQJ%5&nOOPtd{P3sR8Qi`GyPeP)?y;l$*oMI~mRs*~%jx|uz~$otUAnGWC+BAG
zoY7rEoz&I2vVUjQ1MTJ6Obd0$7gRal%-hm$*YAEWoV7)Q#J#F9`t$$SIKo}@pZE9H
z{7@*~d-^<!#?dhfQ6jf+2{Vwa^?_{M^3`uS7~`w>(!QJCJ^5`Nv!HwQkW@m9K8*TF
zszET1^(LHL00czZAQD%mU*?^SiOXk{7@F3noSw51Vua0*+yc`^8(tm~=j!QOvk9NL
z?jvBjg8$O*9J8*~l?-rLXZm$^*>e+xwqVZV2ffbr_B@hfbS{FVW^T_A#<z{S4y*~3
zbj9?XR*m{pG}@$IR3cd5*OGl{-)RLHvQrb1iJ;U9IX9hsgI~_5_4FmY%1&eR&A1fC
zSJ%W?)y6vQBvx01MI35=;-|iBQ&n1f*+$k?I6m4fvUy0>=-g%VVDgB$$>%%iI^TM>
z<Yd3IP39-x?gxsN_1d6SGxkL_QLOTDA%-lt1!fIOhn2pVU4V_j;e3Nbr4LOz-mH|<
zLmoq`$J984w;z4}^Zw<eRy&wq2y+Gv7pvBz-SIpudCcFU+@`v%)y^lzCM9isE_qeA
z^9VNr6A@{hJAcG}>e0XX#FU-~9J%2~v}lcaFW9N)2Q*i2N^qChxYVJ5@!b2g{r~HW
z0{)$YlXo#3Ep%d&g$BSw`<upxY*nM=;EIWD-0bW|9x)MhjdLdJ3GqWX4brVr$rlzK
zckiO%pQ{N6!@-zpqk2h$>k=svLLAKWhiE2;Mg4xd^%HI?>(jxvU6YPIONw*_p1T+t
zsgos@;jE2gUqMH&d07rYH9!8g$~;d*r?lCrwI2RK-qWQqh~z=XC|M{m4+N4IZJJj{
zZa}R|&=@LS;z<gI`MR%>QbHg$`nfvY%>vvNfLr|Tna}r5jG_d#GAN>~Qlpp>v}PHz
zOIzFF4ohO1n_2p&2;i^ohX+$BDIX7~&nZqShcp$$KWrQevMu9fH?O3>WaTj69wbER
zE4<-hrP8PT?wc1Hr?C7wANak?-=N%oF7Wyf`<mk!E(M($(N~W^!v%%ZIJqS2wD-k@
zs|eD}^|C9`o**$VRmDWU-=prhCu$eQGfgKAo;1^2Fs7*1#kt*eQPx{5l-B~uYKG53
zr0AUr*&?2a$K!#20v;R%gP`S<&izM3D_vH?l848KQmd$&MupPTLpkN?_das|c#w7o
z_R`3!21#1#E1as*#$S^OzU!nPN8|7#8|`$3;t;O<B{9|Mqn6nIPKXQX`B{4X<-rO!
zsrS6oyD6Ij$~pQQLaO?6xx%tIV9{Pve=t|5=TlG~g0wb<mI&NnM-{ZQd^aJWS{U|^
zBQ-Ifn-{mPEqE=$q;B#(@epQma!c4w$dhi7s9h3yt*X(MoJNA`&Q<>wWSr05X*fnC
zU6L;s*HpOg)IG&pzaPFJyV}(!Kj$(rpMLs~wtKK}uo}%3dGMH%BJ`>OY{YqbPctMl
z+ODgsi}5q&0n6MUDLb3kg7<i>2v543W_aCQEKEnAn1wpQQ*E17MtW*Tzk{2use;JL
zGPH{uwN*jP2~7$NrtBKsj!-P$Fn4?w>Xy^5%}^fD0@YWOl9IX|NTWA<VLZxLFQn`U
zqRlK%zX?7aN*@JCtdgsm9xrA4AA>5Dk%<ZX<egB)<GJ824mZU~y4E5{V%|mg8_;Bh
ze=C_SD46|L3hb3}Fq;R9qQgQ!hPqYns09YMM5+<sF3DqyX$GvNBm@#EV?V&<t0jr^
z|KaI7;Hmom|L?snu6?cSy(23jdu4=>GNQ~VDXUyE?zJ*9Q$}V}LuN%8_u>-CC_;rh
zgk;<+;^MmJfAsnO{`cX*rSAKj_xrrZYdoLNSH$!pcT~6G%zQ&bQ|orhh|vY&Jjt_Z
zIAZ@oa_gASzRqrhksKnGIkpJh-rY%p8vYK(eY7hRttvCf;MN)AK=Sg}A|*eV4$~d1
zjihzH_!aDEVt_6q{$JdUkBV7}L|0B~`z<42F_uFos-}pgBs(qh7Km_5Rir7vk${yM
zTtoBh-4R)6+ueDvh;H{x%#&68*|2!ia0oy5`k||wz!>;-5S#uj@ig37QMkb5EK>Z{
z(|EJ`oYQIp#qrX-{A15I@5+U+SU$8}V0UV#q)o#jz9Eu;o%!Jgu3VDx^?1E*3F$R)
z7U&m=9!wXt^H6X+kimW;@DV8`n0@$zGh1z_pnRKAaHF;AW&KlZ)sKvVlEvX97>n5V
zx$tO1@F<WK$G|&3unNI^fLz3RR=E1z=NAuq@H3T2_dtWPxg6e%6N^c<kIsZctioL|
zbE4r8fmqyYz9VoX=PWn!#m22$502eEbZkVe+VRO<w%1K9gR1c@65Y9wU{-G5)bbRR
ziB<8(8a1|b=9aW%u>hy5ug%5l-m;G?grB)2^**?PbJaLsWz<ZGmS-a6bcPmDlx7Ff
z9jUy#=O|*h#~{$=r9~!8WFk1oumaCeSXb`4s}m*E>qypB=>(={TPc_xUKYvxe!h{U
z(P7S#lXzjx4Gstt!lG6k>7UG+GRtg`85}_XUGG6(QQsNq)a_8Oi+x9<=~JA&PqlBG
zLYOt~KF4I2o8Hleu)pEfdTIuFG%C)5jI0jxZg6Ai?EFI(Yudeejzih+{6RC-y?eIu
z=^9aL5cuWbEC@`#!9n;~h}vFchHW0BCQaVVuf_@i*M><8_e0Bf1+As=m!T<&!WP<!
z%9t*G(_5Ml%c9sT&1{&ws=wMykaMr2z6U~*^*laTwOd1A6V^#7$~Z5}R3gOQ@%EQy
zsOKqT?s$Jc%vX$dm2Hg@4^Qc{!Vf$la%IiW-^!R{^&g%?P@g<06g+NQD8s9asnSjV
zC}EXm6oh{5HYyQ!!df8aau7u3C0E%WZX~G%x~emh&R1ud>24x^@*TH=x8shV8UndY
zAN?Co@vy{?x}bFf!hkMF6_bi$0Gs?LNm=dS9vP$CjpMCs2_MMT^>X&OGZ&X0Z?$8U
z$l~R0K7t+Z4uIT4ahDwl0DFgCR9L)B7k=@k<aT0K=8cP15VM1AI%9pU!olYp*#wEm
zOb&I3VpWz^^qq%WeG;$EE=?}nA#k)Z(Q=i1`=bEDZ|&A>H`Y?`>r6GI1$Sm5lQ)kx
zC_f6h>Kpte6x|gUjRKKn?7mDxin{2wX2V2gmkoB|D^~f<U|QbAj30#x58DUyDF&yf
z;`?Db*g*K@P>h^C0OpP)wB-<w&zu%`96y;=W%dw?$K+`MI}Gr&?q0)E&_8&Sg04Rl
zc<e6(qO(30367oSD}e#ooovzJXwICjZb9_C!leS7f-V509qJ4EFxj@P7eW<%0*Sd1
z59-)YV3!@7*L}7z-2jm6fzeWp*E%L#W%?#B`0Y76g>TjJ*E2yp%w+O&7$jLcPBuT=
zdp)dW)1lx0>wF7rWdYmLwuKJO{$BsGTi?o^6`WWQ+<3n)L=Bn*^!qYlgvIDdq+N(_
z*iTCLHN;lcHb5-cY7$pn<5P67_%uk9BW;$<I+(wm|C%fX<4Ed%EXV3+DYRWDTQ4Uj
zP}BPJAtFLhDb=9VC1_eUu2lPv>7do%b>SEbPVWho1V2$ctb|))H;CKyatYCh^_RHh
zTN|Y87F;u^*Qb5U*%6?f>?1sCub5wuHw(5p2nbWllA{Z4pJ6c%cfgEYDooaQQ&!Q9
z&DrXB7Bj!r{AXC<vf+aWs9k7r*L-+A`V5R$_InnDSNyC;?OWyE0N<h10{AJsBD!(O
z4CXoI*u`N^V1)D$4#Jjs+`deEogp@Vzr9VE9o#2SJ6ZhUL+=CYj0w*dT@_AoDw6nD
z&~r23ZIpFi6MlN-Z#~(Fq4D-cZ(SpI!^3JHJ&>NqPaI`&hOs^}8<injRJhw9&3`+@
z-{iYeu@tvIEi3PUu@l}P(j{}1@@~cC;1TQ0JvUm5mxAw**h)r88ToV*HOjCYNj%&-
zu#O)m@%9l+93r^wjgQ=}C#=>=v+3LWt=Kd3>p{F+M|TFzpz*vG+=9aO4l~}L3!r1t
zhzWUzo3CsO`v2yYP;F;tTNQ5ymc|_Ohs%uoc*oi6`o;>u;RZwczy5S)snCZW>VMx~
zac|@o#apghF-cA)?K_*8;K<Y$fNXd*3TfRzeEDS1K&Tbj*fF*kT~*dDQ#CR!Edq*$
z+;^b<3C(>%Kjr(qW~h?giQE+9X9m?764BO{3=ZoafDDi`PXGaUX1Ns^%_Fz%G-0+{
zfp-M_v)?NB2t-<Z8HLJw$)$#VKPI?*q{2`d#`5y!9+=FXQ{^r0(Pt_>!u>Jlcr12s
zBR2M3R}QN7c+zqvR4OZ$AhOnmeZClXD?H9Lbq3f#_mYH*KZfoKfQzXjsxT|w#`zXM
zKC{zV<X2Q~=)(<tPwal5Mr;0H(#y+L^0roJ)a>2Tyv&h#s#)~vj;7gaUk%yH`g;+b
zW60P)n5_Of(|BugryW{woreBGhSR1F!^M%>KsgQMS>D9wj@1wmuG&H%+_sCi*Pt}>
z&Zj2Osq?$?F2T>355=vY8rL@mZ1MvD4leY9V3SL=os!b5HAAOg<iGB8Votl$81*Q*
zfWXW1faQI;->=_jxK{0xX6CA!h6CMyRdU!%pF8-yX<*e$L=Dryq<J^rn5-Qt)h>7J
z9JxWBUire{3De;%8~56x@C@^fvAN_zTG|KxHOMn~n#S6kUD{B!n6C)5j7>Wlg+inB
zTVW570$&A}n`?+L__F9Jb}gH!TG4?ip)rVp@i!#2`)bgTvZRBRIOJS3KMtyUU#rGp
z#Vw2>iqm1omAE`#+?l3kekc<383brPko=H4al~1JB*Gth+}rgveXSQU6B0PSP`B!Y
zPv>}UINg|Gh@0W8Sy>;_TDY%&3I3Nm2K|xlhKvHeh}%yW)*RV~Pu=NKyg|)w)Dp<i
z4|xMSuddG_#V^D*Eusr)50=-&?7y?ff_#15|GkWn+Wm@ViKy%2XE!@krYu&e?#<a`
z!#_Qu-53qr(NsRB2}!_r$8a6ac+`Ue^-$T0=AYeeh9)Yi-!nG3D}6~&RL=8KggJlT
z0D5IK@Co_esr1aeCFw@qNTU5W+<BmMX|nY>7d9hf0e3GY5+-BmXXx`>Y^n<z0fTvZ
zV8vOJ))^+qL(@2?t)YDll5jg9EU<gA|5|WY_Ov~w%cueGBj{Oje!hC*qEN=|*D=sl
zAGzzX-`eJe?re_Hf|Fa+m_D2cqIPO6E#JoFyc*i5#@kc|IJa`qq;E-Y@C|a>4aV3|
z?u=q5*WcYB`!<QSD`{B`WD7QrBbYonqGIr?3oCmJvI5;4Rqp4JeEo+<lIJWRbxUWV
z*5UF*#=XPrc_147_6K+H>=CIdj>gJNHUlIm)S;TmE|t$0c6#O(g2-zP;p8)OJ8xm8
z<G?Ij>w=BYufOLfd|KC7t<ly3PQ_zjMJ>u04zp#5#`!jU^z0s6>um$RcK}0917v&N
zDqaNuziG(8w9_Hrb9*~so_0^ww?*V)y*<bh5Skz3{%-k(%)%-RzoOgq;JOU!u3DqR
zvGLmghgD8J2v6~lYm5DdNCH<Ud$+8$->VBn&xtHNUl$Ty?`lA-7m7M|!16UY$Tz7*
zS{dFd<$1vRYjGJR60al@ACpGCB@<I16`q%FjXpoL-UamzPBz|BCgvVm5GuW_T`q?G
zIk^0bTg7#_wfWC@_YVh7Q9m(en+-7h>1{o(lo!10^Xh`a1vzC5er{0s#nim;x$f3O
zLwz@|ufD7&8F4hjwG0zX>8fBw(_TMK!htn>5Wix%YV4T+{E3WL<wJ@=#Ev|LN>FX6
zlFG)#?mYK+#V?w%i<~AG3{=b%(V^D#kd9F(f6g^WjhYeKzy>0>m^c^B#57~u&{Cd_
zTPb<*M*!xB63a1Mv-1IaDmZ6-{rU)~9fgy>MhV+a4aWz`(#o?R%vs1S^XVzO2#1*V
zLykCd_xpdjf=-$Ci}qz%-K=9bGmO$aN7(rjI*^t6qb)Bca-n=*ueDC3I24yoJ#*mn
zFM7Kns?sfD^omt}gaPDm;E`eQI!{`I5?1Qg5PFjA!>+8<&K7OIIuBs^?0bDJW=s$I
ztAycwv+Ds8d7aYUX>vH)a%C~GwQu^ytqrC6htC!j7jcOqNo~oZmd`RkvMc@4so3mp
zH;!;*H*fweTJ7~q&X2p`U;%FKMrb@#6(4kF(-PL;b|g^pv99#%L9`Rh{RHgy-G-US
zaRAYy8<=kKIxa64>r_uKe2?w|c`9h3jHrX?iv_uuuQg542@LijZUP`Pj|j~z6rHw0
zrBa#n-n?dDC!_y%ZkF+Va#Mu>hRITx2!4_g{}0&tJG=8h`>cYSD*Omx7&St(c-PkI
z#+#<|Se&hrKO0H8HSF9~B*Nn5*Yp%Uw?)^!%~XA&p9GW2J#8MOib>Bhy#QuFou_k!
zeH#%$=eZ&(*(8~gwfMMI%Sh*b*|A9EM);#kR86b;{E{eSArQqAy9KI{fPSbdDm=og
z^#G972CP$O)>bOVuxaXG6l-n4^xE2f6^w-{(+6paae^8;)+b&71Ev|?Zo<Lgm1hCQ
z8&0bXxCm4~6s)0sb9_)+OWAL==jtd7c|(fPcgYUvYW$;b{^Kvrc40I>Jg%+iZtZTP
ztnckPhJ<e!byr@0MN0$`#;3|78x<g(3h-_O_(Gx)JlT(u!(*LIxU}OFoN9lI$9!DU
z6{%_vtm-98eIxt}j!Py4Q}3s-RK@L6h;@6N7rbW}9O~O3j0(H1?rGI3a?J}8s28`m
zu8M~tf~2Jdo*2Qg4_N6-@9IBgX|RqCnh67*=%H~@#gk=4MGs+x%9eexG1f*9CZ#XR
z9%>(|f4gQqJAL9*xN_BP1hJNJWaQsv!C7WgCGO!0f$O4z!B>Dl6@(i<t&xvbRsdrV
zCghfDOY9&tYmFiBA1Z5x(ER?ubg#l|40iPJ^2IU*2SHw_=_7SEW%fG1k~j$uMlL14
zlj7lOBHnJKm;B0p_<topa-F>8@|M^>b;Q-ccPfz<zFi^D&T^c89Q{YkfL1Wd`uK3>
zg!1z^7R`y^;l#uf%!ej@8!kvd*A5a0-~q_Cy<iZ0@yu~ki2w2&u>s1DrXtb`Se`H}
zN+9}L_i_{~^osUWfkZtja!e(IyWZ)d*>CiTISb9h50v4dg}#xS5PPp>_Cy>`2Ri&Q
z4Oem(-(6s>JR;0=tdt5?T=H*%cqpY{@|7wj&62rnW+kBT_0YHAcj|RGe^2AIB9R*d
zrE>7;r_YH)_%8`U;DtiVA7P>%%u5ppiWfthv;1=v2vJiqv0B9|f9z9Xi<SxRl7=L!
zI9Q0+98a}8Hv(WdU%EHxK=pb)mGlo9(T}o&z_*z_NXL+=k)>@{Mit9241S9B(EW%v
zdKWQ>qe4KM9tf+0N}Z}VI!GkuW#a~tN@FW=Q1xk<Ch;+tUV;xLffbqN^m5Pl^aptW
zuK5IPa9X<sCDnQI@ztHR5_kodWI<xjFHEqrrGHGJ;k&;RFj9RAw`%f;6#ki+cZBGJ
zf`WApjz8u(Q3gY8ZGrN^ntJO-4YER-N58F}++l5qIJ0a@NbBOc!)-J<?VPKD2>y+n
z)P+BC;M@e&oOZM%pDX-uPql>Im}Gj4RM$hAp_4zyb;_xOzQ9um2A(c`{6j`w3~%bK
z>)crv^t+FwdGa(=M<BZoe6MVf>~{R~;C)reN`823!dY!Z(>J*1jk5sgYW>RS&&dAN
zAL0X1`Z<uQo_#JS#vq63*(8vr37tAt6Rt<!fz_p5fwz35;kdU%JG!hgVeBsajW8ke
zZXq<deesg1C;z?(-DyH`&p$K*Q4HFepTF6jX6?SM+J#rXfm`g$%8Vs)hFB}KKKf?r
zWbsp&0f2;&ulJ=PN7f5UM6@Ps@6wt7G_Flu?YD*)rYK!(dHFjw)z$EaOj15yAEhO6
zl|T!C*_8@&mOEtQmo`l#5lv;Kp<--L=JdPRLOK=2TMJ$m_I0TgeKFC5zuDi}<f=@F
zUNp_m21#oGuokbP31K_O>)UtJSGxHA+h^w#H<o*Z8WcED6H(Z^p#9uD6tO){3u1XU
zLI(YYYa=M*N`_%({40M=s~^nVe$y>`Xp^_tADmVQp7>)Y{+=A6EY^MMD*Nt;eb>2F
z;`%|!h?q5d|LVYe=9|ZpVD>UH@!gX`{qE=ekLb-uQLBF?&m5bH`<<6*0c91HkV1T0
z;gr)5UQxMaBpoI)nF_teCaLNi_<rQp)ox727Dt(wUfy|_rb|puN4*3lX}$#`z1CpT
zb7RTvDkb+#V#fxRBwj4oY{DVQ!~9_)LEi^*Nc;5ZTk2d*IWt%yS8+J&{VO_}e-8O6
z4&CwXXaScs$U}(*9~91){MNPZ2L3Rp7}ZzT$dTo7CFfynIV3$jF}ZKD0;SUwETON~
zo7ozFO`$GSkcm&caRst{X!O_YJIj6R)FY^$m!CQwIf~I)F<OT8l6~4$kr2Tp?O@mf
zNy~4#iUdgtQmpTsBro{qH;!SMG}<l>B4W%s9(g#?d3&PgRs>{`y5i@FP_CEDaV4Hs
zeV4zcS}?UksO?R6?rLqqh9y#KV7t}M9z1dl_i!n;LM0leRZ1Yycj^^sG{DQs!D`Hf
z(ReuqQpnzWZA-Y|aT@A_RGM)X{%yX^KUgqd79GK<7(&psT3Pwd`U1uoC-{bIbY^|}
ze+Vj?{5kGS5S33nYyTV^4ujg|3cq3YW_!g519-X4-0u)i=d@6ni_DfG?#bAPLsECY
z4BYX7ya^U|8}ud8lv6oN?{AD{hGM3tHBEc3OAd5II<Z7SX=XBA{Jz1(>7!3kFs7uV
zQ<7?6`Rml+chgvOCeF;^zz>oMS#LqW<D+>`eqlMWE`wL80%CsQJHqWSJWCa4W(hcs
zSy#iaLX@>B6M=4xQD~l*E1GfY;#DAI<ofNhU_uHnoc3WI2V@PD3Fc3`@Qew`M9tm=
z*(<|S+3qCA3V-cz_uuI$>P#M=^|=C9jukmTZXJN6JLzt8R7RSv>LF6K1N_tCVpeZL
zR*zq_%NB-X8Q*VoG$m%CdgAc70%WvAuGI-5n*lKv;513)`VPz?qQtXdYN35N@p1tO
zEHc9p2RoWDc>~B#(%w1<+K3GsiVx?37=7eR6W-6y2`0R|*J+3Z$^b1cP2ROoKZA3k
z>NhI|5pecux%Dh7Nlf6ygQ{=QlxRrASI!FsESt9ZV#_gqxz8NqywdzwHJ}p-hzAw@
z<=@l!d-&4;<)jbcY&EBPO+emrBWbyd&!z48zbQ*6+KB%6?GF<-vrw0p!KXsyFR5t?
z1(0>Ry^?LF92cJGaoE!c({;Smsvmu9UNJFgT$-$LeF}F@Y0Pvf%!gRqDog9u^aUeg
z-q!IM&Kct?aD)uIXO^A4aV>{E(qgs^JO)qzB)hu^gSWl5ckmnNL@vhD<i(%m_KE!9
zZwI>$&LFnRSIjfya`ngEt-K;f+j~1Ie11KvA<<<|vADB^rpP-LGYISNSDBo--Y1qo
zDc66Q`bn}uAlYq#>_F1;Eu8D8q*W%ix5q6s<a;fMdv;jzf>}XZ7n$S1b}1_^(e`uC
zmV5>x9AnnnCDjdOikXN}Mua;f^&ovu&-q5U41)e)#7-<X$VeZYPiNnWkwJuKn6;x#
z5vit1LZo-H$!-|D(!;1ZBg8VM^9}q5Q$ito8{V#F{oEDUr^H(J;@)hT;Rb*3F%G{(
zVtG+<SY&IOUZ(fS#RL1FA1A{6RV%^t(XY=V)VKWagmVbM22twdF?M|gxAkVQ{)^!r
z&~=Dc9#)X$DsWc5?NA2vagwbNRL_(itW7g}3JMS+KS7?g5V?O}F=LKy_!gXFAvS36
zTd<ca%HRJd;!7~{+hGr*2fY?uJ$K#vUwK=yW){~W5OUjMt{fR<$v%2o%&V0e-0I2_
zyV*S)MaW8~&;09%*DW=i^&-O%xSkLbj~UdkK;nb+2j}R;=}PGm<7Grw0l2D7tMn?s
z7}kNU2P(R9sAn^iRbi;tj$N3}wVel?t*0DkstT(H1_%TO?d&)JibTZR)^2Kyh1^)c
z2ciNl2$bG$H+lLuv>4I2SV(M5AoFV9SHC}4`!2BYqCGl7Grepsar4uK61_)~^?^c<
zeaH)sIDUyolFKwFbI3ZP6;Cgh1gY=X6tQqwxAk<;I{7uHPd#Pz)L}h$saq@F@G0iT
zM=yyph!d{uKHL?=wT|QAAuA1CiWk(`uD!#@e-sTW;bK<UVChaGVyStyFr{7r6EiNf
zKI=wT_DjaK&Z6-#(=;RhA>na+6P`^pXzCa`uYZ7^->IXQ&8mi&(;WRi(CsV2QFDc?
zSbrBzg*dGU7nNGjPAs<-GPv@<F##YAZEgQwXO<{`b8Z^y+geA!sPV>uycp5&QwbGl
zrK+WO072mAT}>U1o_9g`n4Eyd6*q-{&LKFoBnL#<m*r(2+C?+rb04)NXoHMv6&+2>
zq_a?tXT!twPfr1kZ9uPzk+pY5{3&9P&@z~cwK*V0F~o4p*9+Z_$?P$P^}d;Z;@&&F
z$DRe3Ql`walq%8nFzj2#hZ8O9w*(W_dKju(`b}@OyrvGhb)Bwgs@dp7r(iVMLDOqi
zW>yYQ8~!$Ffcq4$s}~49_kXQR;IsvL6|7As^8C`qGdG=b1pnUaTuAP0{#;fjz=s9R
zovfJ|0)Xue3jlgzAb!oNf(>04LqQF`v(~0rvmXvW5`MM9p$e8WuROy*aj^$lWGyOz
z_r6@Q!Qd5ql0fJ>wnlG=5rLC8<`zKTk-!TEOe4$?L&FYf>v7sT?h|f%jOK%WD6V|m
zO2y8oOwmh!cI1Rb#^${%M1$#vtnX{fKH!xARlj!VU+u<osUDtQ;6(*a^N?E_d+#+q
z7O-WACZE}OcEDZ$c~07Ed%f2{^3i&6$J#bZ*;m&K4WH~-qojpbkUR}{0ASsSGk9It
zMeBd03saDzls)~k-$yZKG_3a3_I{8PEeulDe56Yc_;ASW!#tWpx6f_wKG$Z{!}qy?
zW8go+fD;=p_XdA@kAf8EloGBlBIkZ;^sF4p)PA-@0LeONlKlZ7r2`zgIrRe?6u4hx
zgPJ3h2rp1+x%uBF*{K9FHsZ4m#sr)oU`(1@8D8&gu=m0fz54?IYmG&E_!al+Z@wd#
zQV)!0@O99qf1d@nSP}3|Os!>J^!9pj+`+}#+VJ|68e-tTh1{7C4AO?cjkgoTC+vCT
zafAANHH!}(02<<Bs_|-5SWkw^kt&8Z#lJ-`Yx*q()qXU+i<FB-0}N&VZ9b5G4-!VK
z#Sb;bZ&n4HXn%~?8MLSZoSv5d!y$Kqn@0Bw_$y7B4}TI*onippQ}O;*ixl8MD2iZu
z{sM~}>DY>O7~P^d!&|u;0m*u!^)g@spfZUSgbQQqZo@?~T+E<cqIDXgQp)P=07kO+
zsSLf%m#O1UsFrMMK92!M^5OSU=Igdu@*h<?6(ZOh+4;3VdJ#BhseHy^{jN}jWuF|W
zfz3iCbmt*l#eRJu77GCQoxc@PG$*LYI1Ui{lUQn`k3O<S4B*c@YX~ZO`o%+(|8Od?
zxwkraqRL^GG0>l@MR>?spq2d{Nm=iF;afTUtQl;#ifOE?$mh?>OETQ7kwFg+NduP|
z0=H6lRC_o=K1XB;TpY>fEuzl6Z>z`oYs5ct=5)e%ZAp6Ig6L8%N{>!F{A3!AM{oMU
ze1+Yu*6((&j%18jO7BV@-(%M{r}7A|p!g58HYi|cXu*&|RZYTarzpm$x+c^HK=bT^
zJiWrUTo<Br%#>OQReCgSd=V)AN6i6G8S9(>`gOm@<}bLUKp;x3wZDs)i|7G_r8e65
z7HGPHAV-DEN!+G|e<D%a46uHa$d*J0KVfJS07)iPBqT3uZmud>xt5_SC6!8LGrrn0
z;j?vd>(9X<X0w#U(D+F&uM{^rf=OvfV#vmX0|4(ck>ho1>+JCddX&iLR_Ze6GR_{*
z3f&EGKOhi|OXg*eWk|Wj|DT#<6d1$<>17rE|JY^AVn6=T%k<9SX$OD$(74b^yvUyg
zQW6fP{eScI;0MVFeq(6|=uzHCH_vVcg+l%@iT;OtXMmu0a9tf)+otu`&8&c$BHMAa
z)2iUkrW&D<uy<Tn#{StF(f^>eel!dLXEl8De=SpUW)GI&HVT^!%25rnqSPcO=VM^J
zt)j$Y0YBFEhXMvvP&j<u^R(46-zn+xwOFTr^SFw3ntZ`0dTkA)j;VWr47Hh=VSn&9
zG#c`Ank&2*8Oz$4XfDo~z7C4`(J2)ZawGqdwKl-yokf{l&0-28mH<GU^~8(fZRBAo
zBjiIYM=1xl6;G-1$TKm%d(eH*A~X$W%iU>d6&|^L;CG;gY4xT=Ve$X&15{ZY{tGDq
zhZj6;rk@`nVSend0SVKbHnRsG{<nKj5v+!J7s2HY4q7@oxAheP)z;3LesFxC{)0LG
zA6+cb65A~_ZMogn_8(vDzt4lHc;3bE?V7F&H*30-g6_J@5XjfoC@~^D;6Q*qJ7@@0
zL#Q|Q*<5{EWg>D@PB!CgH_C`WVF+~PRJ{bKb%?}aZQ$k5c0L7E8w1ab$#}tzJb+{j
zjySIG-$RafJ!p)k>YGaBWF^;Z7Y}Z%xac#V^N{c~Y|wWX9r+Q9-Eji36aNuLTN;7=
zn+RGb)JC;Lmn$979J*|yhOah#KxE^cZ*UbVV=}3EIDPa<`VVua<>;<Y7w*UdiNuiU
z*Pv|dnU@AZtLQhi5|TeaEu4%oR+gCc1b&fW+$fVRc|`l!1hdsdl65#Xb;GsydkW@l
ztnZ;Wkz)Iw%4Kh@2-{wzc6OM5J}`|czys8@ia8WnjyS$!*c(qt6W7@;YbP)SolmT*
zf?Ta%AZL`Aa{Ct?USu6KMa0|_#)!E*xDX>H`>{l163|uDhLj%(keP{()hZ*z&3=M>
zc(vq{$nhe6L6^d_<t(?}=~9Y)EJe+>`u40h#=l4V46{Ts{W6bG28ME}8IZ=BsI<<Z
z%b7B2Dt$2lTtjpMNvvl26}GQ_Dvd0J>_iqWToVaPl~r+JWq$u@oEqIcg4lRO9Rm<n
z*E!vUn?ps|=AgQ|*sU1Ll<od5)s(k#M3(GdpX+xLAX}($Aq@)t#7O=bI9KeRw){T#
z*V!`GUN79#!L;nVh<|ZFz2eB|(kmIqSwWKUF;1L%!4$&A+?b08x}Vl=4Kx14yu(J)
zL;5WJ2)j12NTQXDaMARL)(>tj-n(k+bHooT)?`&3GS4wSvt9Gif75`nt|j!~%3Wy5
zXJq2S^kvhADu5wM-iUZ8dwD6<f44~hmLf*rq)CFZ>fH0~0pDIucP~GW>6D3Wi`l-k
zdu*hVA5`TO+t`^jSmz6GUYGiSQ`6lykonP)?e(649lDl_d1!g_L@Cbp+f^Ok`oM2T
z<vJO%+7Od~+DU`Swx_s{d@j_$OcvPEM1bVYz)b5L7I2kpX9EY+X|g-AwU)^^vLiEM
z>DjBh`%<6?!=f`*+e}_R>h=PTB{a0q#Ek9dwd6EHxR7D=k&}$2uj|_k6FlCM*#0r(
zbv%akSpM4G^cCdyZve1=X2>~^B*mk5eO!TLf+5f+BqiGQOMWf+&lv$19+vKCEl%R6
zKQ|J#2hkczzBLzQ9d&$0GV<;(g%><S+&sQ5>M4ZWc%AqhMdUtm<t=bK{m^|psqgm}
zCZ0~JphW#4LH!z_CCI8&3^)#w{b?NlxUYbQyvaIyGjY;kc=_LUu-i-#ct^XY$U6iL
z7YqAb7nxat(LQ!lJj`*`r2``HKK|!k8xtJ1hv|AXkbS>b*86f{N0e`Iq%@yFgW>n#
z$!;&ras6+Ngm8;Jg47*kvG4Jil2R@8m`u&@VoK{<KZy{eeS?Nespid_%mZu*zCOqH
z@pjc<a^rKWq`6qPq@(5`Lyz!k9}mvB`&YJSIZlR;8L8IOXi~LRhm_obYu0XxIxYa_
za@b+DcPc)$oKAD58{qDD&=pYIJ=x2A7NFn{7U9TL)d3ZjD=Hce`*`X^W^S^VZXB~F
z2fN>$27v19Zvy$dRlI9T!C>96soQ{gDqGp>C7PLShLMHqs1pD{jxHzg%<>Yee3SU!
z2%~}L@K;HdW{c=6VU+JI)jnkyDaDa+GABIM$=#d9qtvK8m}Z$iI{K`ob!QIOHrHKl
z70>37%7W&8oI_?>o-lKG${H*j@-o=<beQ^-$WyZuYQ?b_x4E@}o%WWGM{g7~QjLTT
zNWDOJF)G626}WXHKE`c)c$lDeUD!$UIVAH4sBO*>Xz3Qb5ygmOyq$C4d*f?#Rqa?6
z^!PYtaZQ>CS>%}&II!#Pn;1#RJ;~{M=sR)_X5Ik4Px@lu>72TB(Snzc05ap(C@GIa
zJO&znrv}=aah@bFRKZ%mWFfXTp*_O7u$-Qi7BJ@IXrkaEsbyo-CntO<!}YXGL`Ala
z?N-&&=Gez7p_3HUt>caDL~XCj+7t;QZ@pCy4O1TJunsqsIaY9{X7O<(pZ5zF{v^!6
zP=T-Ky1$*N%G#jVCC8_~qc&I`1})^vue`dz9<QLt{ftd?XerWEbfijJ@{gv&$X*h?
zWT3g29w<ZR^`IGCtosGhXaQK_l;rNn4w{F{<&H-I)$)|mOvY}P!q_`ys$P}S@W3uX
z^ho44V&~7@fxTKSm2ICN?W$2<^LJZ{sok?yS39<y)lDmA<$4pPRU*8y_F5ng{g^$a
z^tj||m?D!&eugFFgNTHrKO8Qnu`UZM4*z`NSc)pUp%|CmErVtjxvP(C%h=eAau3<r
zG>EL|V^Raf&16Il;mm#?Cq_UK{RUI+{Ei3ksRAYiE(5`9?1&0E%W1eyQ<ivB)^UF%
z@>6;%T&HpEgOr$|$-z}rk5@-PZh@^>XwPBUZ5|sRnX;(ED^O{E#>86}*{8Quk7_e5
z>}c*KaUx?o;iHB`liq7|)WJlL*gZiiaFEC)3mte38105fb-a&%n)yqE&>*UChB&i^
zco@e9Ls~_W?Y06&OMRvM3IX1J&4W#|>>J%$-qCg|J>$d|9B17!Uq2x?>CGc1`Io7`
z6s>ngjr9)+Gpl%<yOzZXkrd9n5@)QF<RARk#puanjP+`8muZ@Vb!QQlJwN9=6d>8g
z%<@kONx(;B{F(Ltn8CC+d(?Oz+^4b(r?$}7$@~L>m!|nWjLi5&&((OB=0lVw|6Wrx
z-E(<YNmXyw`mJ#Imjs`PC7K^+aSF%XQ}yDrv4tkoIn6$TkS48N*2b_XzLe9t(RDHt
zapyVbU+RZXikyjWxmCys{6yEF!r=D5$;^07&gaABf~R&b%;N&vR}G?1FCdDOM#k-w
zv9IKF5~0rNXjKh9J=529$7V{eHU3bxjUaS?RFa^bHsTYqheQ~xtG!HYh<@w~<%pTQ
zlw=(vdo<!m6*k@oi)c1g8Oh0`22+;OegzfS%C{w2Wml&*h|9pXV))ARd|#Oc@Ewy{
z(rp#w|G3H`-9#1QCp4Ssrb>^N<&us;hTex}zO`8D`glS%BNt5}gi06d`t4^uerzYr
zkn0W+6*Sr2BW2sViVdYQF^u^`S&n}Wb5M|~mXVP?8N;_qz3{?ZBl5@yg$i@OQ@S@y
z`^s4|8@BIq)YoCm6dCc$bTej6{6rU0q8Y;%_N9KuG4b*TI$AIN;Sa<d4N=xn88HW^
z&p_;7^mJUgdTo>p6dl#`l45k)2aUqtw;O)(DA;|R@`$^Hh)|d(!-92KuV1sTVL9rX
z|J~F&;uiY+)tRlY&n4y{tvjU^)J_QJyEU&%pV3rkjgeD^aXsPuI-D%%e>?-7ad7ev
zFC(i@?C*T$0L}ahGSSj_^>4_w(@5trjjNq9Zb)aoH#Ova)4{gxse+QFw{n7qrg+Ei
z9^E~c!PXZkh+}`@kl(@RO5Q3C#J!9jP3-l(t|NwyE0O~E!XVqc$=3ex<cbe<Szhhd
z4ZxR1jXlgKD|8y=CWFCbgp(fF*JQhTzK>2I+tb*tPl=h1{7F1Snvx=0yEhLVdyH{R
zxMb|%^^Os(D*Ev@HN6;$JxiPiE`JSCzG=I~V15`+A;XH5E@@^SeOq)t&z1e;_cYBE
zXkpwwzNWfQ5Mxuu?{&>;ss_$mKuFVT>)7v4E?%6Okr@6j07irPm7VRrrdfJ!{|c=N
zT%5H&p(nu%?(Osb#k{Wt7plydHyc(y=b}v@!rvS=&riq-I)=`x{+JoyTK7ugu;cGU
z&l&Np+<@3T)u<t$`{ty5@~CWYKNz4@*O8U7iAPEL4Zl8~Bk*3WSTVloygNcSj%R^8
zY2B=#+o?Qw;5EH2VaxNqQfZ0mHw_JudMl+C;lp@~!&rotx$$H3qnfNEh#qL<OHN;?
zz_o>3xlU-&M6OIa==f%`U&zN|Fl^7R-BR?w=&z%WfJ9C6Ix5huW*8<~k-e7O9_6fJ
zLaBWm`D|U{i5z+zr>*56)?P9nGD6qm81aTh6|>-@CyHmtbgceo@Ba^iK}>IJSIv}w
zN&J}H;_T+D;Nj%?-46L_hzAhF6ALQ6dmoYy_1)o?bzWvHEXd1{wf;|+%|<9=r?Fa}
z3GZ)#WIjI<Jn7VX|BR04F>5qNW_!<i_a;7XKRF~;w$Sp}p=yvDCD7V!5vD;&t~^bT
ze9fNUPtVVDo;`#~Eh0g&CljOE$j3Z_*dIEp%8v+vywS}ND3?0Nkr1JzhDptEsGsqV
z_l6Y%WFy*uP%`J0+n_H78bdy?pv6TrDaiAv#_E42#Q}7oLs0`PV@L9~wF$5?gK%^3
z-OtU)dLf>M@S4>9z%46|Pi6L^B^*)+q1*f)48<c?iGPqs;RdZzbyWECki2ln7+5h~
z;>&j=>(38KPzI993@unX8GU_@`*@gjf>#y9WNGxGsZEegxLf=V{}Yoi<SQ%x)?T|t
zb`QL|{@qt;;Z{HNH&=^6*@ugiKl|WRBN;(o6ke1BXcpM&{+-X}bKtR#>L8s!-|kU2
zaAuYA0`aO>SO4jepf9$pv1GQjTUN>54LXOnXh(VJG%#;AHfRclJmEuTXX5>3X{Ehl
z*-S%M*Ba$EDNO1wrQ9FSOhUcW7IF<Upw|8Mx_sNjdu>cWw}odbnC`#obiiL)z9sRd
z9{BR?38*_lazN79qW;ja%iS@<==m*>x&+3uK*te$;oI;aeu%|wEwT#Oj+Zr^1aM;_
zGlRwPiLR@Ii<1L0v<&yG?|y2Kp_YMCZb^wxQIt76PH0u|Wz3~lvN1VMVnCf(a;`%{
z{0mhP{&h*=vZ3x--Qfl4m2Ud?ONnw-Jf&3a!5F6p7n}D`11e1#J23(8>Fzk$4+b8s
zb<6W_9{YyY95Kx#YSCdDN3s?dVvG|n2gGexvgfs!R{7r^%nr!BLhE(cGQ`K+!yoST
zt*Pj)LsISQHJ+m<Q`gG@kaYwmfrXsvJGG5YKD6Gna7lEirj|;>(WfqRFq~HY5h6y&
z;-7ki4^(1r0EoQ5z~A*UFp$?;EQLblMg-80^q!G4MZR9_hzU8StPo9Qm2j{ZN};UV
zNp5Y|+Sc-!z$<@C@EaUg^G{WmtF@wK`X|as&JEn#G>}A5!w;J}CTP7J)7u01`4goG
zQj^&T&TlCsULLXqujy0uf$Wi_`V4tpFP`Jyh|ip=)B@tjfWHw1jJqtJt%$JCz~z*l
zeBcg~GPAr5mf_r@IdOI{Kphc4VU2n~FgpHNgBtQbf)RJ4u;q{?2xj$aYsC`XswM$1
z^tvn<*Pw9t@lMr0UEMDU7VNeT$-q@@Rw-m^<W*&Nvo8p&>O?u|j5+CS_<#l6{*k0K
z`HUmx$od&x(2w8!&3-mJBzZ<W`HFe(r}UAQwnONKRbMK7>btC4@`=@9=;+~1GDwp&
z1%;eQ!%oE>xH|+xnpI**{o=y;)RUskPDfnz51V*cEgzzM`xm&~03#!K4HoTL3Omtq
z0j^(mFz4D&Cri~hiEPJVL2W7llAL9IZU-1uMXejT?P0SzC^4>x%uLO%Nw-wt>{>4`
zWAZMKP4E`;otL2^=yuXJuV^2wfK1-gqut)AS>_Y+d@-ZlvB!^xho=23_sxEd=Cv49
zy|^NO?n<XiGM^C)jel4B4#aQX={X!!cmHROjpAjn#3Uka!cVd*{H?H;RikFy&;F}z
zJ7<#Ov(Mh85W{0GJ3Mq%if5qli#~{~r{?GGnceyn`$+Zg(wA$@HUo2}4A6vcWzN>S
zXg+yF;5stbFl##FRv<|b?wFEEgAG~U9BaMW^D9$EJ|^G@Yef>}l5B<<8rZLzJTMJ6
zmcj32O?%?fbe4>RJS#($@C#dEPnSc*&8|@vItaY*7Az|MWLdmI!t9#B!pDwc&dlUv
zA}-?Jw8Y1v6z=Q1d<Ss8D=s*$nPCH;HSoR8$>e2X6k}$kVVPR>cL-<G+1Y1z!Lxyw
zM7jS_vS27Y58TM-w$(V-(plph7t&oz;+B`sNiJa*Q>m7O`WG(>p%CwoduPCVquXhX
z_dO?&Pxv0`e_nnw+G5Q(kokGUE9UVzpWSuS7pZZkpAW?7*NY)_0VksHq!OR}apZvB
z4M<CF#vCG6lnA#`7E%3tB`^HSXF}W}NVDN&_HCL9eCsh43_wH%vM!wv@aT#Q@V=PH
zsR7b$EQ3(IuhzD-UIhb0W<|9X7poMUdqSf~NOlb90)a1Xh*=&=Lz#c3q8}>mY8KAh
ztAhp;7}8q86CJq$qFar<0Kg@f)Xi!2Zju*7L8eag0t-Ogj*$}PcIV6eA`UdxQ9p+%
z<4il~Q@jI$DS~Z3+USCWYikNxwmg+a)K(e_B6xSt`ZKVEUL_$keyKaEYJO5L)u0Da
z+9+Xdy8u4Ez117B?pe|}MI@Z!w8FKTAP0i;zJA{ga083>jT<T?ldq&{W~S6;%wp<t
zkNceS<-PGb_(AGXR?CURu#TvJg(H3uKAd)0o@&nhx7%;%v9y8bOIK`sv`g;aufHhf
zC=mx2_hpvDi{Ctu9O;+uz8)Ze7F#DTJOVGQ|4#8T9hrsmY5TS1p5600{BB1O5|J#W
zxNA-_0BH-;h7Rlbj=)q)K0N<g1bH;Ol+yacE;}`ZL))JWRco0=`GYY}RS~Nzhf@Md
zgC0ORJA}Um1^a4w)JhL9;6IfXSA0*ijIseKU6Q#)7frRRTGv1TlnAdd5;8Q?n=<mt
za@)5td_}oc+>9mG4-W}0CUP?jU9s>(#G@+dOnVO7976h-$8XJuP;W58Jmd&re$g~V
zWoNZ&&==r-9?)H?2Be1c&g8kxr{`N<Z}@|_RwUzCeY4XG6f!`u!je9#aWlgndbIfR
zhCLf7THBcVgRD?9N*3Y6t6oB`qvg~)2Nfawf73!7?*-SVw+L%ik=DEqO&nOYv46(!
z2T2qvGYl#taSnyLzSMq>fb5i3K|vHInWg$xIdc;B7Q<B(iUwF0a5@>n_@;X|orA=F
za?2^p1`1VFcX2agpex7c3Ic~kjTDkE$hzjzFi%$?A%nGQ7lMJS;bl41Om6^=!&UET
zV4s$JgRe{hFsXh0iw&|SuY~$PVPFPM)vnTzM?(wH)J`U8PrEdtU6@*XzCq@ll`=EF
z@brBkO_#`i#30n0Y`Q&4UH??n#>yi;;47i!J8d&p&2`V<>N<@ju!jYTz|g^;kG-d|
z1EFl@k;#_X7{p05>6Fpo<9BdUuaCOR8kElAo-NozocP<hSZ=OJb7pbCPuk!w+*2UU
zz|_Rb41TZ$pEiqUaESLX*+m2yo7Z2!n(`o%G|o);c3=n(Xvo8WJJGz`$j$u=+^2|O
z^GU(MENLM5djI(q*Tao(=c4FB#xjiVusza#ZlBrxTX#p6|JEZiOEk6X9RZL~5bg5K
z?4w=P`vn9nISh!|ADKYH$C`!Bo4f9p4NeES4`%SIYB#Ium}Zh_cl0IoFI9{wGV>aX
zuY?CUlk{%VrA&!C)Oeu#_U_?Dpc~4ow<6lFv-t@)AmHFRC$!A?0=25)v0-9;nHalV
zeVCGSX=8zQu;JpmqyP@8Sjd^ScQ;kVNVG&)ZWDwN%ZV8S0H452!Mp|kle(|c{Pu^D
z6-U5haE$_nVwC%{;i@gihOUTh>&J%Bts|N6z7QmHF+c}QLA3<11l>Lbq*<mI$eb{_
z+VYk__rFv6Nx7Qou!GQ;o02p<xJYb+ONEMNfm+^?$o2}AJy9SB7xO^_>yRSaSFdGs
z3J0leZT$6u1#RZ(AS6{sk<wyhcAA+>;iMg~?>}d?coniYefjj6DxlNcV#kOTH1%cx
zP$mFrwb5<|FLw2b%C^13dX<6I=4hFjGRz{h)p#He&qs*0yU}d2x(1RA0+E$$r!2)!
zMmp6eNjrpm4|;L+=#u##yK+UM9Ki;AFE0s*lxj=Ev$gO%FB$(HJb{dGe6)PKaq^U?
zUEYmNplpbKMCEx_;HRU?8@sgqkxr#@-<+jTKtt@F*-)25t+gw{Ik_kD_~<}@p#wIl
z^6S^1WS!STmko3zoPMq`5aFP3e^ju7q5@Yd8`fnNO6QEN?MeANGPzAcDvN16AVD%p
z+X+Xt!1@I|)F*ufO#$Q|h`@#}511Ts?AjVBMhljPWHS=|qZ^?Pkq`E3fpCs|KXo|{
z=(?iCiVgnzPZfM!Un$n_eSGp!FeSks-h0&N73es;nNR@rt<+Uw;4BVm_3RN|cc*sT
zNtoA4QhJh%T*$P&%(Hf_Q%6N*HYT~FvD6P48ql9=rR&0Z_;`M20X;>dKS{H^JRTUA
zq$(kPDzb=_wD+|el|fUR6=uUgoHJVaNRc=z<J+`7WzF-=*k0d)$i%aVEb0yK_Rr6p
zCKV{>heh(dC*eAC#nBw^zV+BS7N)k}#WWhF8)aX&F+#4_TSgJ@Kw;NI2WJPzPTJiv
zsbBZt(X7yhCr)aFWIG-<UlEiVq2;@xP|bYz#m*nyTBB@dush0#aWFgJ5Y{@L(u?Tu
zqOnYJW;{f}1erf|<DoHY`?(wlpY4*)Q<SdL;s%93n_D=i+*&x9FM%4#DKT^4&mAOx
zl&T+A<dp%WQ;G$)s>9WRJ&88uu>^du_i`0&AA5p313IiJ69!p*y<Pl=za=}~R`zqy
zLwynBk85`Av+ra~lzqHUMawPT_DuDeBx`m&!Ub4Kt^LpqE0S^~C&g4iSO*94bRwya
z>E|3kim+;-;6Qq<EE}D5wlwAL_XCDjnKKxF6*FtCeQB9oN-UeJ1iA7jZ&_vVPE`gp
zS<-WvKx4SVO>2dAnz6>xCX<i2b5t5;-*r9PI{#Jgwf(j~?Y0H^*4N)Y@P&u)VxsgZ
zYYG>!#;pylmU5kADJ(eM>(z<LtI$C;sCni;H1!sF%IGSlSph}=jgq(m#=#e~s<>40
zE8#NV>DYZSEheUht`oDgV$i_qM4S2>DOYpOEX5N5C8h2dvs27Jw$FB7K9ejxqhSRM
zl9X}vuAOMZN#4uVQZx4Jv@WIQj@$fdd^$RT?eV+wcc<*vyEbpd>N}CX&5H>SajVJE
z&qpLaZ~1;QQfA9D@*CVK+?1lHW3=ydoON(ihC()F=3D=wq($s;oGqt}6XJC$9|mT$
zmP;&YGvEKxp|CFt(7iV$wyg$T862`)OHssZlVYPA1;u<LxeQ6h<(Ir31?TVC<Ywgf
zpRgRx`B@|<0-q8qpA-?1gn;CZjTe2YU~LQ8zfvv0N@5ksHgS`^V4zux#gG;C?L|1u
znH#2i;##7GZklILTh`uow7!|yX{KSBFWJcts*)m}z#l0~!$$Q>ART+ywnmU{oAvd^
z@q%2JuK)wh-@--YtWqjO7XxWh69or^4k|_qL?VDFFu}Gq@>z1z$^iu9=K&p}!=VGD
zL!fytq^?69INOBWWA6dpf8Pj>!%iHlh{Z}6d0&|{xwm|j$&i+BXLyO7fgI@;&f`^-
zZ4}N!cFG|;W!I(ixCd@5&bAWd1#-)h6(mMSF*)PRoeH!wY^<MIg(p552LIy&AYUS1
zIpv+t^tL2#1eB0(WS_aC?9R<`wC2=z5Twrh1Fo&q8}Kx0XXm&cwr!@n9Q~0#%r6K3
zNsD?TmKT$6|KL=ma`-2=?($8^r@1AvUqCn_Ks_5v0pRN|Vk~~{QcD|+j48>Xeylc}
zZebo){AOvjMo2@6@_8LWEs{7oU--I+$PtyXx3;_nZCpe9KF|IYXV{>XBU=QW?q*x0
zN1k}`7Ig|Om}I(6^H-SQcP{r(xJbutlkG_5(~gw5?$)H^u}K%sWyZBg4Mk}EOfW^z
z0O2TP$OKJ3S$8a#<7=;P?rT8CgvJgurM$fq<!eJVRtCDHoOY_8f!0m-mjGcqP%iNu
zsHK-NP`KJ11F@Xk2Tvae=k<~avRo$w<D0i_@9&w_8^khIj-)eXRQNe4it}kRe1J@M
zB@oayD>QfP%SI1UV!e_5mygi0iNF3)bv96w*CEDszD?0I@Yf|JkU3Xt)s9N{|N1;L
zc)=haqGKdjH3Ft=>JCI;-76y4TVW6=l<M_wKKzqjMWLi2S7&B6h-R~J{mcpeF5|g9
z2>{#hBKIrs_xbVqR#!fI-@|qf^@UOIZNwbP;|3uHCxVS{@5C-h{=vhQ>|h}BXzp^E
zk<$fM`hwK!vMpZ!by4$d8%ov(2P?4;drA3LH&NE_8Znyi2au6enN~3|&Pakfr_B8}
zu$qJj0SP9s!8r-SVGPpJw7?L?+Tw5|$LO;YA3!(i0HQ<oZmME3EXw+3ByMS>!oP61
zH&8!B`g~zlzdO|Eg^05Ly%U?PiPO(~URJg~Q(0iKBPztcp==!QBn)c#Ws+3CGyQeq
z+{Kr{^P)>fPsiaTzc!vh)T$UqR31Z0+#6f?;`xlF>6o@l#c<56{ljEmkmIlq;)_AE
z{Q%KGe6hCn8#F<H<bRPBPzhJ%e{b5T%*}4Yv^r4z2-U8Ysr0>9JE|=ELX4#ii+f;Y
zK2`CH>DA280IJd^ocAW4ho&Hs)MyH;>&l<t#;YEJzlxRulpO&&JN8uhXNCqM2CQcH
ze~vuJd{_bNoMSkD?6w0DOznINEVj@+2cbd++uKAQ+qarGx`Gf1=gr++65|zJ;$Y`Q
z1J_SRzP9yrJ{(i5;3XwMsD^MJlHxl6ANYV=fm!JoZbh>v6*FtSz9wLW;L~f|istrA
znfa%OiDdj`U*5#7n+PCoCh02^*_*S=W0kknN7?l)uIFrkL`n6>EUIlTIx|hS#W+cs
zhxBBwb=^<YL)^o<D7spb$w9kkid|3B*}UglXpF*;8aG?iK}tdWU&G;-+0@o@YTFvZ
zg@)9iVXMX%v*jpNp9@=Yj2j?mJ7)C<7)IM`Yike4jLIboMrhWcX0}lfkt-$wzX_e>
zE1JSqbN~US=uoIc9M4-P8^uay&(Q8ha>Cd)17zj11AZ@Tr|GLmZ;2{gB(H1$HTytM
z7zJ^7o%3~JL9R>1EE9uxHBN^NZR5zYj~j(-UZ4UDN_ipfBgCKlY&2_uwY}DevCjiF
zG;8E1L<w}-YsxQm1ak0y3j^k*<-~TFv|3|5Q#a{IbFf%WcvM>Jt3!yM_<;w{*DxQ|
zMg}4FFRi4)n%C~*^2ae>sf|!02~C+nNh8Fqcj?=>gy%6ulJ>KL3m=;F7MGEH$<}u#
z+G%_=xgdiTn(vja&xMn^khmv5%(wO+LOYkZ>Nxl-iDoEC&Ed|6Qh&^!67VKcX3po7
zz#OX}{UDWwlV>fi@)lW;$QShxs(E^<2^fdwUpg@`L+G3V@ZI<Na*CPqAfk?H;t;!1
z$q_#syfi-?Dy!WF9s&%|>}D&eb?8;Gf9^8@ZM}ZU?A$%v%UAGZfFUqtIlUsB0wMkp
z^-QNak9;maty@QF={&G<|H&Zhq={3eYQ!&P&`Lme{%5}^F7SQ$(eY`WGty;-ZLKB%
zyNCFNaHP){!ug_GoSnr0zxVmDqS8_(Uh(i^>Q9^W)S*JH8y|&an}PPvT++e0dwZ*3
z$kY*Pm{j=Zc5|tje!aC<mvk2(P*C?NMSAY$?aRre6#aO4-&;%px9~b_<DZMI_*p0G
z_Vy@1cL5cASVy?SEpeHn+d=%U;mC?k)qX#T<2n&<G+Qq-IkS(?bZMs7%xuT466mZL
ztLcg1qwmP!PkDFIfV~}9tryMKHmHT#GD>Pw^tp740_;+Yg}xl;*iR~G>K_^lmp<|N
z-XrOep<jvKdXLs)`=$+69OwC^pdw326W>0BVG`djh%-hK72{K=NBc9WnqVPmhDS*y
zg{ly;$+#eh7sKU^N|EWPB)QpbA*KxTg4ej^;B?+`4{m9b;rZn<gr~IpKGaeVoI8?+
zu&^iP5c$}v`eby6v~IUf0Bw0QleN0bx0QjSxyD|M!wGEk_4Quecr=cC=-GP-8Xet<
z`WNyu0uL9W^re$vdPoQ)L*64w$Mk;9aA`sW@R>^UiU|KduHFNjt@n)|P9lh%P__4}
zQoCr4SVfDX+G<O!YIT^^O3cKLQM6j4W|t1Llh#OVN~=q$m55D|m_g*cM}Ob{`~I&t
z*OeeRIp;pldCvXZ_h&r*8b>tn#rHhCT-LYzNL>3eS!xUa=jWjuhYYiO7v=8-2@4E=
zRd#dvgkGV&7@BwnT=fy(#tpgSqTnX6J2Mo4$ULE!79=Z!8gvA4>gP_B?TD|#op&6y
zvL*UL(L-Df^!s5?g0*4hj_C=Aqnr>d9C&6?4)h}x2l+-bAc@tEbDY(m4)salZK~tE
zc$Uk~D_OG=q8IC~5ohZut?>`?cZIe}TjM}b0p$&9h}X*?kMLTs?(_QZvaCPm`yz>X
zRo2!jYeep73jYI;)b=$z0-|uEGbJzGjV}<Q67W;{9p=9#z@A**6VKC8#u0n^t5uj}
zZ136M^fj$Xw%uPl%JI0~={93bP<Z}jc>xAfX7^|8+c5IIfp$`;#apN<`ONtmWJ&$0
z#Z!lc6k*HZPnR^|4u$IW!fOXyj1_`M-BbSz<;G#Yywhr%*z;J2xu)oI`pC&ZVxo(r
zEqSP2lBN%Ys#)U(F2_<&q{Yb$uuCIi8r<3Gr6%dRr`4x2;|k>h@Eq?O@R<i)48QWf
z<Yd~4tV!(e78A0bYu)o6Vd-wRln5d2C;ee+>AT_gKRom}Hg&F4*ZDGD;nFCOI@^zR
zStE_>?>|tvNIKiZQ!sl~xHPl2{Qxx1_RMFacOr6G4mu<i#02dbDDA&))zBef>;y$U
zXwFFb+57VFq0Zm}JS;$O=$hUSfE3ee?j!*Yosv%PiPni#MlL8my!kweaV@6=D$vNt
ztP7L3h0Q5T=NPMDU{xZyXP08;x>~y*UhhNT>`SqCZaJxt%?B&ttv3eGf3<Vg$PSZx
z$C)XksP(3?!QmYB^0aILABPy|dAl6^b9h_^7F23%Y~f%KyFHQaW%0?(Ih+@XTaqB~
zZXcL`<mS3xg@Y4>4523WAr@SWVkePtZdypHwt5gm&I+qyA*k%P!Gu}Dzvnlbr5}(2
zMu8$aRxu)p#*2`vUrf2Zw~DfE;;PzNV&uy75uVThF<2nw@cu(B<*8V~K(<-xUp7mJ
zWm(|z0cOnzq~&{a{_AkgW?{MMVy0t4lma~4hRCi%yRp-3KPFWoi4eN^?e-J65cb*z
zl9o(8Vn+IF{>t+vub@lOjWpUk_to>TgPI-w9Pv<|dA3<Er4i2eSwprq`y5J+TIxi(
zh+YlE;*)O23xO?5uo2KUN(OrZDZttGh4UcVuWyEQu?*V3?>Vnu3+zsKeS>33yIL|;
zF~^HH-To?Z3qbhG{)t#Mw`sWCafhXGIdDbrL!JnasEvIdW7Og9sV|));aIcZy&uhQ
z<R6_mR~*QN!(V#&KvN`vAN4DkZ>CFNn^e^4_pL$c$WMIoH(F1Hnk`B@zGEsw1q301
zt4%dfM{?cY<2{(%tTsil4|z#?@m`@4@w)hs#Ngu5KkF)u=$%w1I5yzgf;ar=+T_oH
z=r5x^kP<uZ%^ysF(R2QGh1HJ>0gP&eQ|i-6neEZBx^f)(SC|VSpP4_3yEK%Awk)+C
z{9bIG;BD`iV%lG%c$a<|GKR5co-sYS#ETBOCnOzi)sBjNDalVh+)<q)!fyYKisuV=
zn<C>Dzd1#x6E@h*<K6pN$h2uSfsDI(kDJbKQspVQLtQyJ#x<g`Z&id4G)@8D#Q7WP
z2#DA3RZkXISjgbdbLR{1kCC5hoV!GO4i`gCm+DH4i9;32V=Qi9&NxL%Jal)FI?2Jc
zcuVJc`VyJ{Mv4@DpJ+Ot&EqSWpN=dQj!rN@0Hh1VtnNVz_mZc!I>GnljqRZ<$Pko6
zxFr(f*WJCW62?6Hr6e4T5%LvRU3#BR?wB7-toi%K;|AAef*b}s$#f6!C5nZcY`@8b
zX4#DP1l2duz9NP_{%-s3>aVlfub)-f+W-jTUZ=pJZP=2%Y%|ILk4o<^K<%*lnlrpG
zgE>CJ+(&GpN`KmbnD#?&&tr3gd@gd-#;9!^u{KW~Bh62p0I57c>?2R%%tvkaUYmj!
zbRWZ41=J;+Fsg6bX`);*jZ4`(>)`RwmLOL8XC8x00$$hEZ;C;$#^xf$8}|zEy_+|u
z$Z^Cy0s-{Z&>M#08EcTDaIgdYILvUKc6NhX71}(DE^0mDYe_X;PTdPq3kK6TCPtFb
zcmgwKIqs29Hd_V{(?F;>z~uFbVr-@CeP+p5#tle*;e(jvN{})@WSw&$DQ^^0gWh+h
z$BY^K)P9<fh79@6TG}N2f<x5~ak)}c%^!zxx-x}#B!R^H2#_`q|MdwNM=+QyRO9GK
z6B!2|266kepZM5cIL3dUywf<sn@krE{oirYo0?8MJDk&DcP<Fh^Tmxo{Q8n}aeS;j
z=(hXl!H9o7(!iySC2H-zGYkUuK?Lk5ndaOGI><{kg2ZXY$xX~Cg3be4W$Z}q9mU?6
zRH8k`pIC3L{selp<1I7<)USk`1EK#$|4_#uoq<}5CURfg^MeB)0J}lt-d0)MnwZh;
zzW?yGVBElk4z<CR@LS=?fjiagt}%NaEFgJcPeu~t9V9JnW-&qPgP6?TXMQ#>5xZ=v
zw`UizXX%0CexdNC5T`OZxxCCglsUN<YF1L<#{Z29M;Fw`5?Hzb=yrnp#}FO`b?Wek
zU+Cl^)+}IRoO``4u-nB2PpWVy$w_&HeERflvm^4#aNQaZqN{1Pe-uDggS;tt^qG@;
z!8C<uI`$=MDK-iKL0hKxi*^}q0u3htPhjgK=u`@Vxj}?{^|&n$%~v#;1es!oz`GOi
z&^Zd^rW6bXDgED<{q6;;oox<>Mq~35D0nj~Sqs^w9CPjC$H7*HXtRTMv&1c@4yP8I
zcIcsZvXC}c$|c#gtxs%7^Y2af7SEXZ#3=UcAaFTf_>(e*(q--W#a{ZiDnx%0ur_Lm
z9POi99SX-V0Z<-s8C<ggnT;Tl92eIE#<jjlDENQy`7PXYO|i&-YLv?;5X3$6drzFv
zD2G5x4&ALw?DRf*#|_LO7_P9hHFBM6TYF?MZi<{ACFrpFE^d0OfstF~Hac*4*^e&C
z>;4~~eMhv4k$5h#O|1>*(WU{)iLpgNAnI=B1+oi}JnM^K+PwDwq4s-5E+DL)gcM+u
z;1y*6@Nt2HxU}NID0CI7g3au`L2(mFB_BD`57zvOz+t?nfV;XNHjIBU?hlXrxe6pX
z&+rq%RN72cC<nr6JwHJNrXqVXzK&Ff1FPxc;9vh6`{2KUUAp6QZa$lil=e*yb&__J
z<_GqTPR6`r=QOi?iN!s$v^3=ddNF{}S_3UyTvp87y*&0NJCM<`H(~9KJi4h6iA%5E
zzhN2N2zP@p)?;rQ6j6z|SMxsx9n&r`6~Jh=N6YkeMd_^BIPDh|0WXoA&;>!p9l!tf
zgrU|>J;!@p`}7%$d)g0`2Kc)%V9mn>NI6vdn{2}wS$A1<*=t}Z!+9885}OB>uJ#V$
zKPmyxEnOoaQV%kbXu3SRg@p_M!hxcOe%{-?E*v^o+)zy5zrAH}aAbne`hV|7<r3S*
zHi-kJdn5CI5qUfPXUlPhelhgo=(sz_TyX^P3+D*0-#^^=Uf6bwk{eu>(J2cV^^K!r
zIIM$%3@Bl?--CYe-|+q~tRqlF!U1b>__`G(d-@*uVFT>{;Qphu@;K$6teqo7mV6^P
zUo8LAZ3cf&jZ#UxoV#mu?fKUyN7}H3re(TY%-xlxWuZFJ%>NT-kSlYxnF}vh((bXc
z6@%FUow#YQl8Se}0ON<@Xg>+o`p>T)w~hod<fo_KHF%2sl0u!j@DjcfpBR(V4EH>B
z(YRBLhwq$h+7B7J>m8c3)u}Pf_^#A*#<?|$5mf_>Mzdu-wz!W<HQyz#4f=O&8+(){
zY&m5_)L5e~bR6F-C=lmV`F{fe?h3+ke0oYaa|RVFlgHDxoT$??U;ug-56SBQ^8i{!
zIQlb^(=wSs<dTqz3v%|-c&$x53u3ne0Y$ap(5qP{Pt*35Bdq&lqrL;zR(qnXYz)ni
ziAjQHr8`IfCC}swP0Z6O=2zKQ^WG&!^s`))y;UsX8oJNGJ0Ic2#0lN@01^xZv!BaQ
z1lE6c!u@_sDHBuD@NJuZp#SA{dp`RfYV&I_#C=rYV453M1XZJl38#@p^Snd{D??<;
z$6dKbK)o~o?Nb+-)_WDE-=u>$a>X~A8zLs|@{`d#d{7sOE6<Kse8G^Gmmk(TQ89S^
zSnLbw7@gO**|w^JHeqay;~mpLQxLo|w*b-3eAjV7l#d?eUG?B#QWUcNi$6=W2TO!P
zH@<&JM{6Q>jX>KFAr%;gCW&E2Svu<IegV!vhwoTkF_`|6#;D_V?rxKrqh!}-I7S<P
zxj7!_wd!)b1ve2_G%{(5n%W?G^@2CH+WqBB*3Hl=a0W?j<qH=aU;M0kesA`bqw}PO
z{GFNIX=>yPiO%8@4yg~7MO=7j(`hdSJsQtxjNu#Y;^9!-d{h-2%8Rl|8uW{KYAVPp
za<-2uM6Bgx+Mww%hyV5`4wB7s<N74^Id77pcXa`WAE1J#&rwBH4uPY`<=Ln&S>sQ&
zQsbbjE0+`<Cnv;=y=lpMTA3Fvh6q+qO<s$I__-e-vV0@QYXQ18ZL?O_AcOaFu0GJy
z>#%WT_1dFYYTQ|3!O+|MVNY7}ux=o>$Dthhd9sbO&e<q<R7{#Tb0!q$3a04)s(d`n
zU)=tcrNA_lBx}rwY+geB;D0=Tck8xXPwte0WH{F?LO`+Ut;yYJ3~@^yjVt|hXA6OD
zY);;Uhz9&v1$z}Q#cJD?cRshDQ8kuapvM>#>T=0uGdVwf)#M6!tXyEnqM*OOWINqA
zVoS(Nsq+>IZELfcqm8g9`Ez)V8;|qwBYr?0RLAe$0ocVWCf^v;_?8~l`yJSUq5399
z{QfB;%HF>4k&ihB(2^;rj}ZbJM$ae+_hJHHpr=;Vb%E{hyF))23Yv|a{FA(n)L)wR
zrV9TZAIL1?|7ik{Q^2WIXiv&KizVls5fGcfpROtOlJ|lHexHQmh8%ebLREPR*Lp1u
z)BU_tA@FOn#d8Ore^H|G7@0yB!4W4o8GD%cEBXPlkuAnN#t=CkTRw1=y%uShy#?L*
z^M&uox`eSD*J)LikIX^;j)w9Pxjo94NSikr$k<s;09lk@sk-akLQDD%^!J)fIf}zO
zj#B$;li}r#7(~%k0k9^+%k@WAr@UvvgnwZ`24d2f(~U0LmW6~ToG>%dMQk1)W1OB`
z8yBc-R_eKMA1gkSz4Io<m`E-O<mqD|*ukufp|+P#;N>q}F?vhG!jLOUDQAxnjUy1Y
zIk-52Aq@FLDVBsxx~pyizxMA5HBu8}Zxd)bHAPT)bnZA!Zht2oYF9r>TLmYo?4E;`
zzAYi7Qaya|sc^60TPtk{7>BPJUe?-?_KZB*+<biMPQw~f7J<53dcNR2kqqYNSck9A
z!NzX`D*s!DsFLQ|&!3J5eMH1woe_Q7^%`EG3e3$t?@&WCQB$3@bY!P~P5j|vqZgz;
z1Y|ehhX8{DU3bG+;YN6sv;x4}95bF}1Qo0#QqhaeRsII$u>JLHM_z3($GD?lsbwBs
zHU*|9YNx+Tv5NVBUcrX_GxwsOO9vTwTgNEnn3gMD0%M*`=z0ad$ebr^(<@_Z7j(hd
zVScP1#ajI&?XJ98nV?8KUG$Z|9EEJ)JKl>=Mjm<cEWbGxdIp`(Vdz_b%B4B58}Mar
z=57h_zodZmpS~Gfq9!g3;=JZG;1zZJ<o>TZ5li#3Ey|n`wq_NY#cYI}dyc>GFvY{T
zL_?0!Kj|iq!eDFhwcqqmCP?*I_$$ZMXhDJEc$2k+5exfbKQ2LyAX2Xdzg5i|5@Uyi
zSb<JER!L93nRn$t(b8&Kvv`=&VIld{;##_#eVeWd)XYE2!V4eFt@|FgjD*`?H-^hS
zwG)6MZahoITXpBiBJTe-PT`+q6R=>v^%jxyuKKGiB*ozjOzOwygd>7&;KrXqP^#q&
zysNBW7{TEqUQIYlFMlmM$6J)hc9x*PFiKhRACzq^@+!StV<~&5Rbp&(@9vE;LIvvM
zF*BZfJwu3M@4dtmH;rfHIeht-mZZT~Xv)=veQ4Y$YhNaW%c4jf@-)rAn2*ci-M+Zy
z*j2sCgtu#D(hzsmdn7JO)#rK5qlx_4NQ+nS?5o$fNR3aPLK5Tl&HvF6H&HOeD_cLx
zIems$L4aot%ClvDHfGPS<d?Z0^*B{v^S1<36)_^5y8na;16g|3m4`!QC|KnJMCr%z
zXQCM??xeHu0}q^!Z5m>s!P9o4>5qh<gxK?kq!F0y(I?jCRNfd?*&D7qUv{AcZ#!``
zaYV9TBI(NKnNk=Jw@kcI+K@d9xCzM@C$?nqsu&hH&(XxLE8EfdlYkqMpJJeSV+%t5
zQ-bhB(vc~iZtSTNqL+uB)t!@*8lBsJ+ltXP7oNp}QVkK>B4MGUoC*YS4uNV*`*O>5
zB@kvhmJy}(+WBw1d{MXwSN%u3_E7&LOd5DV(hw1D-x{c+Y}M%L7zJLjjD50OuP&c4
zm~NKJSNz7;7BqN(_SET_K<b|jE^FwiAH{GH><50FVOs}Ew*~=-e0X;o2ptUEAKluj
z*-(Lp^0@oXW%hD3{E^9fUb~uND(JUE=6V4m{JATEC<;fgU5>b^_bod0v2BXHKo<mo
zl%LkR{$de8P5hddVvT1Q<yh<3a`XOa5n#;1I@6?NWp0~ic(MHvDL}20ki&L5pl^N0
z1J7YlKZwukq8W!tv;pu;^!FxHfZb3<wHS#gJ}3S3JNZ$&@5NHqN6>R8jLuCTBxFc$
zaTO@FxHs@^h2N<n^Vx4b>(0H<x-pQ$MC)`;eYnxr9T^tJ@#UCn39U*9uW564ds>Ai
zUwd%?pf#=dRLB4XNKCg+y3|rZX~I}cwb?-R<zYFrp@_^^mTWEQXv$Y{4A{n?Asmqa
znDvbtc!JWQ`xGOqkS<y7I{|d=*F1(Cek3hZm~vILJ0r~@;4mFYL{Qk?L@Up1YQg_j
ztFlt_0Xeh*L?+;IL)%WUx=%hMK8ms_{_24VYvmB}xE#Gr6sHg6+_@cTr2V6h-H=Us
zyR*ZqH6eK*PP_X12GlZr%JucSSL?gex&=(DcZa6lkWnRunJ7ZX5J;l8HQ&Oq>JDyY
z4v|+(2Y-@=tJRi%hZs?UJ$M62hKnmLGEpAiKgQNSZ%Kt98%N1Fiq0V&!?vn#08{Rn
zLFjcHnAnMNJ`YuCa?CgS2#jBz@{i+Z{z>|E%jja<Secrs-*#=>&n?>ZZy~bfLI?a+
zKPpcX(ie;DybzF(Dw?^nZL57=yllDhO|ir|Q3l>-t7d(8kMz2SpQO@k-$@SUwrzFy
z(bPj1OkZpAu6k+aOVWH5!iJO>ok$8QT7jSI3D2-MiQVRYnYK`HD8P+{7yT6Y(}n2Q
zW~mU#JJB&hx8gafH(8r;!#->5;*U4st;poQF9aDHYQ5B89z3F_`yPs1aMh3xP`5a=
zNaZT5u0ed>(#37n;E49=xUa?MVA82poV(8v6At_p+N>wPNi{5$D(=Uk_hmVq@0Jz}
zDBnGRKVb^*i8qTanaH*}VL>2e2SYjbpC~Uw3$bHjJ`~@1lmo%<bf|EML-FM2Dl@9C
z<ujPQwbWPX^|wtpwBSAx?{LJwmV1;MK?;6Rw=y=KjVn1DEd*&;w`7~I(cfW2j(?wW
z<CiE!4&9)!mC&J*f=6L~NlXncV^e=g?Trf|(hC2duL&rnnAr?x5Q@1eCx&5Le!qjx
z#bYNw5S2N<G%$rWj-G$-!$}+dF@f57t9hf1k@f*S60SJ`d%ugn{kOYR9i2iy652CL
zM*$q~2j}ntf)G&xB~$g+W|aNDR;+g7Adg{2&?;*7>8-qnempnDR9ge=bfCIQUUE&F
zx8^bC_Jma?oS@aw_;zcDYh1&VsotY}c~>S0TMaQCI;&^8W$`&O9F>XZnJ(|GwrtaD
zuq+6Iy=&d7S!`CA9dGQ2?K!57U`qwpMogOu^E!o<H-2q`y<Wk}5p37|as>BDcVyVd
z*z?^kGwlY17Vt)ER+zf!pkyni;13xJyWc9~y+Or^2I~w}ySsH?9g0Fe8^;Z%>(#%c
z7lJGKGb9^_7n?xKD@f1GY2+BhkHd7I3bD(GmdMH*QF?91Fk;;rX6-wp4)E5^nMp<m
z;b`3OE2CS1JH-NxWY{rJR4Pp`xC$!2_R$kWoiKATiC`C2;+F1>!O-HJrI~msd+vtt
z{hg=MVw!lo|7b7p-hL>+?W2iwOu9FMO<_1@x8C#)7?8nll(aqw&S!GyqfZTYbA&+a
z-%>V`*Iv=*o6m!#*p9HTb-C>UC+jlNgccQyD!A{oCAP%TY~u&EJ$C=cdqhSE6r&Y$
ztA7dr_2VcOkp<8DGPVgK-Rt`*=D9Y~_fK~!NN^s%t4;Od{`6K>_2r6)z;nqd<ud?b
z%X^_}r>)(ayA?!kP|*mxFXLT0X}RI&G~ug!*_{c;PA#%LMYZX$Ca7R&CI8Xr!qrth
zL><s0ByijyrTREp5rjQ~y_7?)uT!g2+ySU1SnE&|jkc<@Y}R;W?1x?fSjtPAV?rbZ
ztMG>i!*fW*tAt!~euIf3V;Gk8W6N02R8n;Kq^XD7f;<^=x2TNY>xjVl4i*5v``xIY
znMX*M+hR_PHJw%R`S@htpUL?x0I6(oHO%phDT0N&_g(fh&NNjuqzBA4LFv#vai+R-
z)X=L$caZ#W6C^)?Oz*DEohg8q!u3gESC9B7cYC4U$_UP4er7e){6pHm@LYNIw`W&4
zka@CBb~kdmHbOX|uQE}a?fpG*iL8Uni5Ch12r6#5<Au8%y23Ui(q!f>8L3d*7yfq>
zIV*#}T2hbv-7FqLCBP|1D|Pr^mYpq=UA&ftJg9BIprb4Ld=D1GEDT1PV(4r%%lGrt
zE0e=BQjskX(t?EoyAAz9=e4Hje^92q385&j!f>i30}%$V`yYay;jJ8_3sxcb3J^lU
zF!Xc1L>6BlXyGB^oJ$pUJxr!KV#YSXBBv@rhz6*W63kziYyl~KGCC{N<0=)0l7wfK
zDSyj0FYVWE1i(5LAj}ovnf&9@S4V<y9p~_Imk!lyS*LL#DK#uv;ftdbJ#waDv$C70
z)gW7#o^=WGB<UhO!PSXNa#@ffoa@mRKXwkhhQK)s+}l0p3dT{4MPiLaEz^|<v{iQm
zj*cxyj{S3|*dsAqv_5|qXT@TDbOF-9QRyDDTtCKeJzByfj+;8v1r`V6mE)|lJ>*bj
z*<mLR82I5*#{07mu5D?{Nusb^x8U}A6|o%S3PR0%j~3D6g>XdS*jwF8dj%<^{ozn?
zcwGgYZT*J4JL6sho9ioj$4(R!_5^TcxIpVOl_6Y*lhVw%)F)oR$zKnPc4sX?-A|?H
zPSiG=EJu>jRHzMJ=(5EbcX#)=-C7BqW6QWW+vOU5C10I#ws<3zd2OccKWI9Oq{99k
z&n>#*1rt0cnFmP#*Do3T_7Dp@wrmLU-rx}}@cj?}8Uh+Z!TDc<Hi;Fgu_6)s>&scY
zdgHu#4`LpMa5wRQW#7~#HQ{GYV-WM8Navj#K=7GUMKQc&7w1UbwrF^_Gq!+Q*$mF%
zHdTw1yv;73=YFh>N^5fzdfnTrS9W4lMCi_`S2@}WLSXpa9c9WYIrv@6qGZ)NZhY{}
zIc%S8zptdTz6`(#anFMAS}*wzHe#{|`QGJqS(mC5-unTwFY25_Q!VmpuRxCdHslh^
z#&h?v)m>UWnM{VgsG?KDiH1kvBzCJ(N$yw>TMMw?Lw1yI3EGP%p|qlTl-Ux^i`4mr
zId0YF*_H=;Q}ow$y}04K?Gy!NF^ld@Dy+yAB7ek7^5Y9EZ)*b<j^9=1hsug5eR#nj
z-1{wgY>2bXDn|w-crI4ts<fP^I!KBQP?zMwH>x9`PhnGE>e!3E`M;^{Fcu)BsGBP2
zy@qLgJCqo0c+4k|_h`!p$AhNuQ{}-vSsO)n?Ziw>!L`pS<046Ub8ha2z1{Hps?8Wk
zshOhu<&~(LQ6TTHja`GnQSOvRq4sheeeMaYEg>S$Wq&}UM}S)-xQ~+3wv#T`FJ4Dp
z9T%mPO8U3b)SxH`Qf8jxF>Ky8tJNm{iTSZ<^BIOq7(`?N<rXoon!EZQ_1bo|?$VEr
zQ>MXA5dAL6Q$cevI4NtcjfA;g+2qiRKd!~=YX?4EXxlOu$f?gBEaD5l2njOxv_i*R
z>q>tZd^F_QapR0fi(if~&AyQGJdg8)BtP7p{eBgKJ+YdkG=vl;54Y&VZy(H4Cv@G7
zP=pZT^o&VK4{c%zwn7JmI4(fa^Gubk+Bi52a*?`OaDE%S+Er=BmiTX(^aS<+G&CkP
zsnelc62dFmbb9KzWq`9KR9#0_+c5XGA7th5>x7wgOKNo?(y;$Z5+gWIZ0We<#qYgh
zqy7ltD2oQIM?dm6iJMn#9wu>qx?8L4ogoqYBcC?^e|b1~<_MCQuispXl$HnUP$Nno
zqe0R{O0d(q^}KS;I0koV64$jQvzC`h^|_xP|6TBkfc){iZpB`3Xg1=i6Ez99AqOob
zAcU_zolX8Q?QU+JAk~C>zhjjp{Pt=F^7ub1nvE;^jV_yXxs!xu%0oL-E0lO<+_giI
zVDT2keo8j~)l)@N;)U|AO5mJK{n*}h*Efz)Aur=T=)#{!@ljom5M1fV8>R-_oZ}#{
z5e;k~cwQ9&HWW%cRJ(6iEq{#e56~FKE%??bPuw)B1zQ4|f?T)BNRTSl2LPF`ZJQ-s
z`Ugs)XN+x?^575c%wN5-S#_Nl79Rk_Tn8ooa<V*Q$m^jCD=6ygT4n2z{4@5F%5%T^
zaGs$Di~7cE;f~5gfGy~TTuT!bI5qxozSpwThbK=<PE+9AdQVHX*vD#z&qBc`f7}3|
z=25?KTmVpUeI_OSuCjUhJ^Rnsz1R0H<U=f7dBzb|0Oa^j)CAPk!M5IH#@ILgfviY6
z${Bw=gngar2P&NGal7`~6Aec8{>l{7r(a^;GZ#`+P&DpL!Mb}fja0ixYAqLC3rk4J
zk4@<~I*`26IXOK3Oc$le>!RahCp@l@KpjWSU+N6}k#;`j&{dZSnQ%0LVUwlkMY2mQ
zdtKd0g&ywy8-=j0S-E*qf;9hge+}`D`^&cF0<6-|jg+t#MJ0&T=3jdDcdx`hvL+rq
zW(?ld+!&`en=k80jgGblZZgyg)*x@a6|%0>jyDplLtI7bt<&MM?{>~z_eEL^S(ZUw
z$mheml|_P;)&+LSf5CDYsLTQu$@YUn|M3n45bIo$2HpY34`ikYA*v&Ov#z^kuhyOT
zBDp*+_*Fckw7a|2i7n5w;j(s|yQ_f9;qIcFm)clCBI5#rYQpdOI$U^C+u~<0UNbka
z5c1PM`nU4P<|t0<6i%>i3d2wzst({$fY_WI9T;1#Ckk<2$gUe8_8UUaz`Llz<+QR?
zmvAqnq)6dJJkl&B^j;J){sB)mo}kLsEHf@#2-A?e+Yvkko(de#3&a;t0%_{0B~(=Z
zrVTG>r~WuxUMok@5%%l-!$FeIn)K=Kv1d-Q6q}BQ1!^F#3Kr{Krq{)J-8s4TO`yA-
zzFKv7dAjQ4&bMdYH?gS&tumSdwhyVL0Z)5`pJFUlIiWMqg{|Ya-ylK#?-ciW9O3}i
zg`f1ypG-lDk3xf9mR<*np`ZuFusw0Q*ZU6nEw#|zsuX5zmZ5SZ&x7Eq_fAgbDPmIp
zIp3%A!45|~phAC-Z6z%fjbU1`sNCmM097jeWmx_#V#meNMW$<@dt@yp#kDyTox0js
zH12QvMF@kX^aie<K5%z(fAT7*ZLas(K!yNHwugu!Hos3$wWX-W$EZA6TDn~7wl1W*
z^$}xs=AFBfAIlger=vzGdtlczP^sNquJf@g@>w_2^Mgv;#1qAN>HWTr&AbJmsy7a8
z6Lp}JBOu5b2ka%+MdZ<;mZ;O*TcvCL7wg&vo)%l2T9kb=JaJ);Of}#4qt3@(mx~DC
zb@Y~W0mL}3oGFsf7AI{iYxEWn;w`_DuSv48PrVdOBG_cDmz?|h78HwT5YILJ84!Ic
z>WLiBxnN`*P!w8qyIoBHGP(NVq`Kf6#bS6dcz3y-FapiqZp1MQOQ`T3zR}U$<>2SS
z6#cQdAiBKQz_7z5g;8zk=$)rr^{#s79C-w}8iJ2auC@yLa7K=M80#h|x21M;I^ZG5
z-83fw=x@cdpV`E`-8t3+X2yrN5D!T^Su&$k&O%^Mzn*zvXMgS2a!`Dah2yIG|KWdO
zFwartwztBmz5G!+vc{yN#+GqQ2-^pg<1<lqOqC9L<LXCT!X_rNrQwQVcx90{4T<v#
z?`B@t(!_+Fjc)dp-F=|JHA$yfVQK2VG_#0DlDDi?5PqvG!7d4v)Fh2#d~-}tMrftl
zF;MQyLOP8LeSYUNDd%n9XypqMxdI-bRb4$v15XY~lzo&ez6oZk(rRG7jXwo3gQ<VG
zJUl_6*4F2Ogga1YYiViGsJ>xI3@L3@*Pt5j?zPDR1gnJ;93BgW3=vuH>ACgb-z+!S
z4PXj8_O)?Sq=yIY7KCv*<S=5<_<b&o_fYc<Ce`nf=60kY7R7JuzV1f}iR)cazmN%4
zdBHcTTYOmVyJ+t*>ai>I($nr(cmBF+ctCfSNX*OFXfOMy2b~Ke0_$2DAvDj=xp8l|
z=;(hvg}r^oalOQC?yykxLt#(6OD}?cJ3l{0*OzFFj;Udvv7rwM7o$AnLdPHBpOpLo
zA=UI#Px3hdYJ>>M_MQb>`1ADmh-<s^RSNq0@)H+e>uGUV*lwuEPbOQnzpA1&iBd0f
z=rs{R?d$O7GL&o0@_?f?1T@_-cuiC550Kh9>xQ!tyX!sT29{-4V<2eei{23#6uTb_
z5fnM&zSjT&hXK$W0Ad7|X-~VVK!J33a3P0TP9GlLE2V?X?JBi4u=c6a5-5q;-o<^T
z5tY<lO0`fekn(f7Xo+5n3`>FKz|1m8r0Vk|%-Z{sb7aKldFwuwM_nW&@<@&5c@INF
zWXxdX`Z`wDOxNJ%Dljyyf0Q%&VQV+Z0QG+(jOj8x;IiCSl{Rt?$tk|Z5fOdI8hIq7
zclnppGU~1}?tr?P4TP_9zFKD&pSZBRt+u))v^W4U9r@rJP3iURLuS6>6g~LLV5e9O
zs}n~mHjM|CvAO@s)tFGqB0DKXeQ9|~P*WP<4#pskdx6gzcP#X31T(lsklLUAszZKg
z3#R084L@Rg?_v#2A3T|9maSIVrEZRHDM-!NzaMq=9B)DEIQ^*H%g>JmFGQW7<Ru_@
z1!M8Ef7=$Nx05Tt^c;Mm!TJ2^b>zKPr-U4g;E&F&38FaRxVNbAqYul$k*k&^XNaIe
z8Y7W1Lo$?Ozif5@hLwh=gYb;eu_dRUiFk+ZEm|3f0!BP9?DyA2pIu#VZ#_ZkSw!=?
zL9=jr9L^e&FP3WYi`$KNpXsq(HBjuZCZ!bZX+Eme8A8)n9gb0gq2dAB?;!A&RNF6;
z&3`%1`yQ$19W8_)gLm6x6iJ21!+)9fmwPh7`4*--eX}d+Q)Q%k-&jL%VqSJ{;kQv!
zhxfs+;Lc4#BeP;Mm7VAfCYQV~yqPVDx~3hHmUOs}{pK{emb0>UqqCE?xct|m!Gc*E
zb*P)~d4vuw;@Wn)8$Qm@d9nqEaTMCp9pN}h`}Da7iK#cKtkQwT+`&AKx!jxpl^y^=
zoauK)fz7r3!X(>TbsA@NDC~@AxJySLG-if{qYxnlp2<$(N;0s@cpu2FmPLfu)_pOJ
z*UBXJx{sNP?dW=l1n!5_(vus*S2cs-m2S>O)kl<OAS(@nlh+s6WG{elgjJ#tdlt{n
zV5}HfdZ{@*s18$>k$HH~=_LQs?#2?+Uf5OQ()Yo&F79(z3C9DO;EVTTIi)HP|B_47
z`Os_pf^a-YTwZYRw|)$l1QGi(4wc<jD+@cdV5fl&%oSHi!N83>)weLw^&kstug||U
zvh_jE{&=us(l-ggE@<Qw&!M>Qi@Wr!+jT91RImpFr5V45s;_(V2r1}qK94<ha932;
z%SstOBH#T@Y>>TYSOHJC|1hm3ls_nAhZs$4$(@Cu#8u4xxD-J;UvtaOr!Y)fT^~jQ
z-{o|0LpM44eRXOFuiwZQ<K<$VA5hVH;rJ&3=b`&14$Tac0BSLeUN6}G7oHXCU(Ufl
z!0rb{9v`y2^nh~vtovY<d!|^WRz;UmJG~K54O9&LP}6B}kNN?Qd-Y{)SgX`=P+*uC
zP3~|Rx!FPUv17v-W9mUo2hIe^wa}e_)>O9gXT*(%L)Ag8lDN+I04aIf99W@0x%O=G
zQKhWD#+{ebl?&gu{KTH}!#ATcrZpMA^s{=BORx7L?_|Jk@34J;mhOnDpaHjQ(9v0L
zcggEP3Q;d7{4zDi^&14}SQk`_DGJF$tMG+>EVYp)=%2^OQjGopOzetup{M&GS1%(N
z%Jb2oGvKkSb>yVRPNx^!+S{jBN_M^p?f<rKfDRDSfbH5^=5dA1zoOW|MtQz5STcJ{
z)RK&g@qSM%+r1hc=vm+O!5LrK<pb4bLXs;l$tY@+4XA_)0-3|x)t{VYa%SSUz7?uo
z7n@-1A3EBFZj9-_0u|p{&)$0XeTvFt8!qvcA@c#bh}&-1BoiGn$Nm6W;FG(s_YOMc
zWi@mp{O%H~ma6N8D>ni~ABNeUG?6vOpDG}b;#@7dH>LR6gBd5B%;aXzXh_BCZcmdC
zMJuDVB*BA$0^81RN9I)=8^R!BwajWfn@F@<QNx2<Ux!QUj=NtP_)|b>9lYlkl$D9!
zLo8R^>T5Qhc=T{^U@+wt!St`M@E}|)<Jvb2E)gBHsPbiL^M;X`LdSCO&}@4@hw|?(
z_SN9dg*qHC@xNO^6HX+~CcZ#$!8FKJ8k-!oOOiFbkvRwHI=rB{TOGesf3<iq(y0f}
zlyw}t{+GH%deVAwVF#;(tqVDyn;_%A+>d~9cRfTkgz;vE7U?cK3z{X?aaGJ=n|V-(
zn=*GkVmW^${k}!4<B%z~QU;jtGocS1i7iM1zC%YVnM-*&<*F0l`5}O;4^PXJX}}v@
zYg#P_Pbk=&=-yp{2o$b(HWV~HC$8PYZ9514k+&J-HS+4GH#0?L+B88&+-2ICjStGQ
zwPesf3&AD!;&JeK`0q%Fb7=H?G9l5#xkgt8et2HyLGFAl??Zh-op5cZ&lpCIcQZd8
z{%S^(rtH(^m-tN_*#^q-HZ1{H<sQ+A#%E6RmXx)v-Nbuwsji=RWB`E=U3>TA+A{!u
z%l_2;mQrb85AGY9>5KNGYZ87(8LuE8J<73Jr7bIm9LK%j4Z1p_^!z$IRZf6pdLhtK
zpbxVk3!TBGojnE2#AW-nRhFc+sA&}TZBg9ck6wxjB@l}N_9!k)K`cw=x_jD30aMV-
zzO~DTg8a$@N(KE$@PKC)zf(t#_+Xl41X}hz5ul^GuTSYAWw39~ffB`S<%|QM5%lhQ
zjQl>zN~Eyn3#i^-&D4Y^OPjbNZ<Oq(<w^77K>#>Y(W7-J-WS?G3HgBuAU-C11p0Oq
zzl`*QpD&~b^|R8VmP?W!`?9VBnfNEuf4vzt`ug?*UslArnqYrk+4D@tKFG!1(a5+u
zD%#-A`{#=9m7jfor>=JyG#|6?!KZDOHK?FCXn11Mc~?S{ZZ4sqnFre{6f&LJPBRLC
z%ol#(f7!$Kz6aX`e&tAYUyQ$Vvs=txfqHr7tFog2+Q;YUezghoE@|=Zz8skl*fE;&
z?(Vg$Xa#|mVC4JS1pg;GAwN5a2rem-W^ox?Uv{QNOff{`>)CKk7901-ips?~?f7!G
z%u|Z-#hkP&VD+#K#K)BgHbG<Eu<*oy6uRSH`ZJD(_CUHu&TexX?onWNJx)4;E$+bw
z$v(c+p(zHTYu~n)!)4FRwJt{fhoDfLn=bvCIvTId08k<j=kk&@{aRU>1=a)4`Y<yd
zBjj&+5A%x8v1us<&C*}ys6O=Z`{G}}Xw-;oJH(DT>s|^xm%dJxBH6BdS#s(alwOO^
zWRuQMQ>)*Kx=}v%R+z7K)b$o_Phye@x)xP7$baao*zTjjTfrg5a3tN_6lNsz>O?fD
zcE4?kK~NRrZZC5wMrNX<O7pxo<tuM>1w061$qS9Q8E|n`n92P3MW-cPyoyjRo-X_r
z@=?Ck?zT6f!PaoZ6Lv;0CX8EttM|C0w#BQ@iDH~q>5n=g;w!a1O~AxKd%^x_j-<J{
zu;?aK+W5T(yuVK`TefHipMMrxGR?o1{*-V54MLt5T<rJ`9GzXas5mm=pSwvf{N8@k
zH~4#UNpUFVyZ1t(Wc%&f>Sn&+EAsjZk#rHq1KpH=QlS*tz@;tbzxY>S`eM~C)Q`Bv
zK(lzGBZVqXt~TuBBC{KsfGqmeD^L)0w-*Z#x(g_)(RfL*AU<|%X(#8dq2uTv_KIeC
zJ+YtSWBQg#kNF?mc)S7frCwiUb16pdM1Nl8dC&WY^l(Wu`20YM+n=>a;;BpZolZvW
zj-W~{om=O%nv=v4Z?UT77L-BEa$Eb@<{n}d_a9u3pTaBoQe}ZcYsZ;zd?J6D2WarO
zD%=At4A9-sDU-3xXT%TWPOq$n#v3Kw@5+eMy*S3GB(;IW*MG(8E#RKs)Bb*S6?|a%
z7EffA_D*;M(SU-uVz1_jmm`2KHTCsPn_pMJ+-+>>e%&Tmw*Zl%d-~ruWx(A~`Inxv
zaG<mjyy?2h6bKq7g7WT{7Y!4Di2`QBnCG3)+YvZ^FVw)h)VbM2DpQ{#?4%?7Wi{Z!
zL6NU3!5JX9a$^%G29~5!N5}T`k3oU+y@gPsyUHc284&78`UheB7h_CY6m(yA^8z|J
zqQh_BbZ3iE6WG+DIn*~Tlf}U14!DcUAUO_vFdh9sFyj9f53c_x;~0u$u^fZriu`gt
zZ61%T?z7I^!cOPw_BfzB@pgVd`q<bx6L3RGw<bOx*#$A#PG6}WX2tN&`3z$Ax=J!X
zhr-s1soKBeb=^y$mW%$X#+kg$oMfE@(?Icpk2}Co(pMZMNex5n2d%M=7n=$F?G+-n
zQ-ovzc2THUz2#rbAe+Fijr6j9es@Rj+)?rXYu8P<&Zd|Nwd!Y8+eA4Q%`&*8YbRA>
zm1c1}xbC&5%ga0UW1#Z6rh5UoC9;vsCbs%=uhO56kN3XY6b9iiu7S#XQy@NAh-k7o
z0`COT=8r=`cpb_gG_MHS#lVYDcohLF*#xs+{UxTCRGbynJof!EI#S5>`1Q0?$4!RU
z_hM-D3V00=FkQdI62{N`-r((tv3;qo_3{dS`>N-x1wzZP3#SV|w5^?f%ZswjiN1!C
zqYc;gf%KET)Ri~*E4+Y2eB&6la{G1}3%A+kz7-w>`h6)kFzp;y08KDtpt4qe1=EvR
z<lMSbKWi=S0%=oezdV@!^sy-<;l>__m9ak*WTcO~D=bX`^D{ugl3J8&_{O+DqOl}x
z3Sg?lD*H1p;BvQOKwmmgUr=Oi`}!T37EEn@laf1ck%zYc;Wr2e{D<cP(b#Po+5ttU
zd1(;HfotXkW*11x!nlsx*TN4HGpmZ0meZ$J&h7U?Nu`~cwagY_ern)%SBadfZn?Ly
zi~)%N%R~)9u^CckRIoVzyh^<lxuu|ftVF||wX@_5)d(|sfAcz^QO!Aep53NTfv(@1
z_Fg<8{IFFMPY_6>oa0}^Axo8S*uyeilNoX~Rl7))Sd#T5I!YC6RxORU?;imu*_h3i
z$dXx<SGF(5xK#slWcaZu_TY#@Bqp+vg{Y{;N@UKgHar%YXs8g`X<AD3BN@o_&4ho9
z{2)HxCbS;RBk+g*x6yO@7m#uu>lj&k<P{}p858?9H-dI2QM-aU(i8;3v6KH!Xl{Ls
zB5UTBGlfRU;e3s^XT={M?hah<9L?EqjloC=v<ucY-yV4k`-az8T86uOy10l+SBNq!
z?4M>rItqKt&JeC%?fq4?;W+)_a!rCqL>zIpg)hDT+;MXdPV14SyP5XWS^O|--;cq(
zPljbV&<9%~w`IGxPn*8DHr!(T>R{XfXN0KsBS+ouZ>@y8jl}1I#7y3j<<_r?)$*pt
z4wYDUA}j?N$){HC%rotyM5Q`zu@Um%x)bl{V`{?m^E=B8v~MnaCeu@^xYb~rNMaOn
z6qde2TT+<N`5b4akf4CazeLtp(^xI%8dDy@oy~3yM{iGW-VeG$dpiBI=sr~HabOJM
z^u)${=aN|gXwjAxktwiCv%7#k<`2b7Y+h%)0u?zFM?mReb*%wLYQ-n);UU%O%zH))
zG1xo;*Kgo)8UK4m$sZ^2#sLDZhr!m?=1@F&xwX94X4S=6=p5Nf?ry=7@#REimlJ-1
zY+kM1Huc6Z&mqr}qXy5nRYqO~(Gn)5WMp-(KIVp1>lytrvc0!5U+36EN@?^Cf^jzV
zUugSeJy9ERAV-AUY=g-?bZcba*wW_ct~+vt_-(+zE6%u&Ui2CL^64)xqxq`>Zn2n?
z+iny%mN6Qqx@2u#asAa-fi?&3>{IDh2+?FNnLDt~rTEP=Px^P;Vl-QVTrOQpe4L3A
z=@5P^gS4`*<!SGYPFI_Ham1?U*!VF|z~8b-88Ojxs)tNv_=pR|4RgpTo;-;ZXT!-5
zhV-sm2O9MNX^_O&hp)nrwa}#xq7N66$+U#nHe>dr1es?yjZ|Qon9y8SHNs<iF*4SC
z`}A*z(*BQ~e|_O0YCebQdOVuB<5fCGj~acEv3>wwZ;3r_g+#u`-XLGWkJVP!=`4K1
z4L_MUvxQZC*R=t;vKzXorTM9B1sH}34LmRL$C-s!l)QO>CLOsE{Zg||^p?|Z<k8(o
zN_@vLQY-D~&g#J2owu3b68|0hp}x}02{8?JmCDQyOa;oVmng3gl(1ZWn2A*Y4A4~G
zq>Ba!-Ix}Kkj!KVgoKP`_Se;Y$-+(|$qI_LpF-y*{xTaBD5WnE9JkvvJ6n`^oh*J~
z3|zjlNNoWmY<c{wYzbc?)Av5V{&V$#mmGIaA1H~^yuZ<Dpyv}TaPY^RNyl_eK^@>^
zOiBJUD3dKbjkMdj53#X;eNUO3D#RGXTE}wJi~UKq{e>b{2dB*(|3K7gJ(5`v+>f#N
zJ8ipbFK|EJ<ZP~GR*2$)VLSs-G4s!f+sC4F#f?7k-`@J5wYD@HgZg%CYjE|h`(1gy
zUPht0L7tY3;w0*uIXdn_LpTXCuE{YM9%Uf)U_v%db6n;%qqb+VJrKQb20!g-=CN;5
z7H|4dRs}o!$uv+_Mz1<>8~=NX*19|g%tcj0;OzBoSyDc@oTLZOScgE!S;BS6>DHH)
zRyH#R8Ba<PJ_C7)pJL1+P6}e6wY}=RUZOJdRPw?ZbhN^Zvm5Tmt>)5V2ukJ^iwID7
zn_rj9nv6?lcO{3sxBtl0$6DwhtdrO{saTafPbw~rpl_r*jt2PA<U$nyh*juDw2yxc
zCfOr|H?W7BUHgRxWS~*?R-9$4z86vxxSwJY2nd+3GkB}{yVfkVKL3654W@z!z29V?
ztkIz4JtP|P$U(%6?KCf=yuME04`_HRYdsK`nBms`8P=PM$UkuI=I8yAHQ3=1l!$93
zq?`Xni^+(t?mofIxH02YF064+>#F3NoFhSEqoXVMWkf;c_*&<o=;h(uwD~!ustQ++
zCdBo6X$4BgW|+1k58as-<NJacZV}c%#API@y#2)%c@BSJJ5RfI?IBlj6-`vo?S-%O
zJzymm{R8<<e7skI75^@u9#IJJmw8CdLG)s3Og_h{{|&e^^HY7QvxOY1PTM`zlpfU|
zGP553@l}Jx|B*I8C*b%M(@sy|ixyXdD|!8`Vo*o0eKQ@l{lyHKB#PW-Z1hjcj^wSB
z4>3wCnfx1>v4>aHmN|_A%y4O)62G%X0<s!dw`A5P+t<sN#FK7a!-hOB%MPE=8~G4(
zNxYQPhyP0bi(pPEu{s@U6TGMtjc6(0aa>h>_*hRDc5da>3%?xtJ?-c|ul=h`LN<~6
z>KSsOeEP3C-iWhpHXXAI-*}ZCt9ozv<ecFM_d)iJgWvJGpMGFod~V@`wm|ygc&Ji*
zlIp6g$|~foGTc51|0BIdXyUeixzmnMj`E^(hneGe6z#<Y`5ZZ3mK+BTyC7TUp5m90
z^+kPqcfw7u<C);ka=cQ+@Ek*hga~l?BmJK8!iml7{7v_A=5qQQ#cvSSduF)AvX{V9
zXNcC@z=hAf;~&F;pd2ML=;mmX<5YZFumbnDzY!ykS_;E;um*?iLtGhl%++94F9c?(
z^rjiYqgcN=_AN20LUWqXzlh6<vzm*jCgH>`$RCECO~OZR!(<(WS`L=5cAg)&`lv4j
z4by(PtN`?<2|l_tq6guQAB=r+XH5nds(-3lzY&^UF7DubEs_#_7vHUxgjvS2h3a&R
zg#=ANAX#HuL1GZ?yfx}=0Cw=wWX!Ff#28atfTxm*1liE`>CvBt@S{NYMpu^8#*tR^
zLw29b2Tj5Sm?4}oLf=m>|D=a;UsL=W6+>lB$X!3;2y7L4J#Lg+fAiNp=4F+<j?NE&
z$%Yp5JzlD`WP3ffC}=onII5to<Iq#S@}O?h1N?OrelKO!A3WBm+TG$vq;DO=?S8w&
z3E{~YtoXiPq={Fu;WZCkV69@)S5^2Lu;~N!>)~b|BfZXffX)=sJ-qJ0TqJ2UC+ZS+
z=NUw@L3W$5X7fqw{YkL>z;hgcNhJR;<rwb851!?acy4xRz(Wt^$$;`i5xbdf9s9e~
z;_QX|naH%d19d*0rcxyH9oSA5yyP$N+25d~<1sBGya_$CYsniOrHHk2G}f)|j074O
z2mV`TOgC$gX8V2EmRdX$1oUN9rv4h=r)`cK6zyvEhcp-_lYPeq1~fkr)T(Qjr=B~`
z72MSNGR8L0#9g|Py&(6yId}B?aBOXi9r{WO%mg}!6xHHf>B2X?Z8`f%OJVu?Y$h>t
z<!ASLU2|~lW)Fp9c-gKbVdZySh*{dsYU7(_7BPsr=dcP%9$v!Y?UsqPBcK!-KM=j;
z&AuMc_+h>6Vr9{4ose;smRo|in#eii+pD|ZI2`*ohMr(n9Gk$27Lq|U-<>@)7by!c
zYYuljB7ZWm(i9l)#h%j=TgTz@aY>$74D8BzM)J+99eKNnG}iTTOACZXla&2)c|NK_
zxI+9J93fLr<Ho|nsvC6a*V3}b%04_~9wTGMkIBKyPWY+jhyx5ua6R_N>%{NZYU7dU
zef#M{e4q#8;_(O73hKrN;j<}!JzfXkq?fz5xov0(f}^8z`n#|1N>Aqmi!zsz$E5tK
zPYP8w(UgG*YaOGUyU_CImh8+c$9zoW)qUZ4Ll;$UyZ^p-VeD*wjegF_Q!Z~whU6o!
z`Ih0~{i@BXR=c;4kd1m!9*Kr72392a;cLVjy`qMpJij12X&dop@Q9KVBO4_<_nLlt
z!VfnF<8hCaBi{o248ixY#Sn25d%mLBI~f-00+yu{5mv*bX?Gs-^F?l5S~8&}AA!~c
zb^ncz(~$4!<D#)xDT=IpNs9=FC7Rz!!awzH^yk4R@zWwWmLRTrn37f(i;ahm?ISZz
zJ&eA3`@ju|+T%rJhT99BgInZp4@WsGGhf1HH709sc+_J$EcX{@;=-Qk=yUN7${qV-
zto`oYWr;Vz+aG>U57FVyFCtyh&d*Zrw)~lJuGW(3r@YzB)_qyrnxkp|T6#stC~Zo&
z9NqIJiIj_pQtkBezZ46V^T*h#%3Ol4DVe?CVB~E9sh^STIi%nd4YNMw8;Zvg(X8Rf
z0J^9Pun6k!q5k_3wgZBm+m87dTiFP-xeY9%d3kNe-lhZwe(lR#<A;;`rXx)gHT{r)
z%&P8ECi%+Wk0#KkDZJY6s8}Vvuu_rRL2;V)J1KD<dCni@nu3JIr7B?Xi8TOSK~70j
zzFr-&)g@XmZ~*WLtGW_U^w|8p!N;z+j@5VWp2PKjR(Q9EyqaKFz?OY{;GW2|#g1Jw
z-&E(UOKPd!FKEA;jj^{NQEm}p<8pQ9`^2rt_z$%*%)zc^mb^<q7KF#y-}F258?T4F
zyh8K>m!y=W4PVEO&u!)n$L=i7j8dFLX|UKm<p(H-*)n@aX~YB7c#fR)F>Q<QY79-f
z@xVp;z(?=;Za0c;ce7s2=;o|zT(K=&{l3ljtt}vS^<80m&vzuFc47QLh`#e!s6-WQ
zUK0=|5ZZ)%^-cM=w8w+>zI(_UI!YkmpT)EMuln1$o8a$!S|h%v1wj;d+>Y;7QrmtJ
zsEUvpWWl>@%(}O*^W%EPqPKmV%3xBxh?Ox<f8sP#C4FX3dU!SXqW33*$YVO|Es<k)
zqZx9IqqCl~j)_y#{GXK|UbiY)KtS1ba+~M?j^+Ses(kh-SU-2lFY?j>lX3DieRzz~
zCF?eohvc+BiKMe<qyVkZOav(LKwxCWHXz(c0J7mh288ummYCoXU1sKKnO;_X_sBU$
zMz6AOhX5JU`O)c5ll=s5&(<}Yos}pKzF*Zt`S0tDdK)m01lXj0QFluHWrd(f-$m<S
z39}VjjsJ(F^NvdT|GzjYD(;o3xwoa|&b>7?XIYxLx8+{BP;lhPS(ZDsw5&8onIi|_
zHn*mj3*0jSM}h->e7--<;T-<paL$|aJ}-Da@4b&3L3vQmHeB;zg&!5!`gO5`(=5jn
zGas<;Uf@872FhMWx1&fGkVLSkc_`|=F4ig$Bl!Ds60_t+rS#vbwvVY1B>tF_9w%DH
zM|-%*SGAtK54BcRb>;u3fszxug2|dzOFUu!**bK}aqQ2zumzV8A}hz5p<sUx_}0oB
z#gT!5TLwSE{*B=Se)WzQ?U&_^5Xv4#%6vI+fIZIpsl;d7a0UMZi7>BgVZrFsvVp;I
z-)E_=Yv1!<HycQbcQQK+bvkIhLmo!QGoFxb!}mBk?n31|omogP4lrP|R<rDB=*<~y
zl-Z#f8@gt^>7D!=RL>e0L)2f*jQZO5rT-I*PrJX{*DDtv593q8(#pk0_VwnlTP^hN
z>@39Mm?yntBM+e#Sv(pZJ~Hae@R4=d&lDro0_!tDX(%+VdcVKTgqV5qvW@Inm4txk
z$?!-ou~BNpD?{aEEm*MM7`&)8FwN3DKK_-F<|L}6B~1`|5-4hl!e10Ja5=S}u24}R
zT9gA&Y-FZ$pA%-dOft5MC~;;)4i;~a)oSVFwq_}^cVc<%8)q&T^q4l6!S~?!F4@uj
zjIm+3yNJ6YsfEFonOXs$`Hlh@PxUmD*ZJO#AUEE7n#xLgz{R|zPDBZ{d(1W#6~ri{
zf;{1&4(oIWo7@}#&=@?@%gG5r2Wxbg4Z`^tU0RO}(sU3vMGt<$gsY`U>Cr+V5O&Gl
zRwK04)8gLe&nVueJ)xzVF#DTr*p6=X_OJA5-<1DCTHaV0dg=qoQy}lx$MFdd8gj&A
zPTyYWeqzJepW<+*4x|Y&Yg*n-onZ<e>H-Rt<D3);h4!cy`o>g9zsTOcuD>n6<@jRL
znO((CjbSj9OP3`G6Ft30JK*&FJZ|e8337>@)`{C1^I-c<7v}Bl9hIPx>YDfNa;*$E
z-rqO}QOTa@V0GiAg1#0K&{lF)2ITBOSR$!yXIP3g<$h}g9pc4t+Yj2yK-7ZnZTlBm
zas0spnT7nDt5_`mIQGjETzGc>XmU(^z}QemX6*?C#34Hu(9a?5@-@EeN7`2XmmB15
z^<^mbtOzI4_$9uA;rCz4H{u`Voas820ZLbuk@NKUn7MeztCtXq<-LQUS7<H(kjl{o
zs&ISL_FzciK_sCS^t<U=qfOsN2Sw?*unMU);>&CmH-$2@D-hW?wee~rO^!lY2o9XF
zYY3~L=I_Otg{>{DeROhM49H`^8x%;f1Y+=F2m4_5(8*hPsg3GeF*@~joYfZG?&mkN
z{$&eUsMoA|eE10iJjbU;lgMpbjVIkjV1;c>J4Fh?h%)Kkkf9QA6E#C%{0-~w9$iJT
z1j&k9^1Vu2V%uy6J96#6I`+G+b?xDw{M;)U9*necqs0HB?*8+8>|=!DXOCSIS&c0W
ztHk@#a1Fe!?KPY0Po!*jkMMWlZ#5}hSvleiPt*4%jJhWqMb<mpY!o@-vL4OgO8=F+
zf4eoE{^fj5;pb-7t#gM2HIGSy)VC+>bJRW`HC2_&AerPeO}|EyvTHEhB%hWMm>$Gs
zUF_B${9RWn<1IE`aa&Y&kMirBKo1@Z+%|O$2G*JeGCdfxe-EYOxgoLfhK=AZG&q>%
zKivOpf{#Lj{Shn0a}S%6+{V%tI++v0c>8<ThS_ND7=G+GP@2N%47$0%ogm9bmw#AX
zK3Va=S)J7K@Gw?~RuBNyD(isy4xoj7Iq*Ws_iC@ZLE0kTo&S+F4LSOwR)Hg1-C10k
zTnK_ys+I8j4*s6`Uu`eeMk@xN-ROF(U+-jdP4_WYEi57Gp>~Prqk<Ug>EK&toF+;S
z^+zrbdfU``kSe=+SF2X*+@3{UN7oc@3KU-O1N`36+(wi8v45j!cD{@$D4x9DJo3mT
zee${+`KHC;;`#ve&9z6Ae~P6hwX8JKDN@D6;ZZkQG(}Ho0H7b;`}UHI6wxwM%Nfl-
zO>CT+p(tuY>Bm96*UmF{&#|oBR$1?w%nD;a@y>BBqd$rZP>Iqq5#CqA3J0W)Q_?f8
ziO`DUBS3-(+SSJ2eYJ)%cM(*6XUOf3F)p~8QaO;TB~jo~YbH$w?7p|N>RllaZ*CIE
z6AP(dJJnHANOCjd==6=E(<t=aH(@$*I&`ND-`Rw2PvW5l{UD8D#O*%0f|gfZukU&e
z^#n!?p2@y{e|Cn{!CL698Vn-VubTI>7AY_a=!tj+NjfLGVa$kKf**80Wcr8pMThfj
zn<`|**S;>zWm;X1R(iM{?}E>A=C{^0vCW|sw#yfikTzZw5n54}Y50Eiz{OJhK*Wed
zdlbS6dGe``^NzhEn4&IoygCWbKJB{)Kk3Y@`yN2V;BS;qVL9_uHy_T#vq$s1L}^6w
zWX?z0*^<#DG!d|%MgBdd9+%&2sMAhNdhJ@#%x?_-dJfy0jS|G%@A(q^62|Knc1CWk
zB=Q`CL@=R#v8}c~O@-wyPp;eNX=1QL3XS~cthY&|EXOacu>JVQ^gbu)q4k!}58bL^
ztZcY>o;%!mobF-a1$H<<aVSqePvzZ{zWe!J65n08T<4T+vW2do*iyyw@N>Fqst&L9
z)b^>12fpe>&T54{N>|PFc=DFmA4<Q5m0$1Y;0!xoydVp>qA(ZZnnBn*xX^b34~9T`
zE_BE)VJ+9lu9CS|_{+2?MYH%dYh+#>s};ibjl{TV&SPEu+N27s;%Ls^_19N%Q6eL<
zT3Nza`?#}fe(lq*PIjo#WL|QyXw8MiY2KnFLR<CZi(<L=)8SQDFY8>bzt<|6&teIA
z9l0Ai>6|I<8t)A5`t*W;DkKbB8iWm}Sez)xa`3|y+B#4tn94<)^7eIl!*%PNV_?^m
zQN^j)KC{mbRnK0?7bEkxBXXomrQ>N#*7zCUJ8Two(VrFc5Et~$V+jG6E`MzZPP&FJ
zzsAw-9`HxaQ4K-m8h3)k3m<>R@7C39in*I5>WJ}iB&yC$9HyQ%N>p5t3^CQEKL`wf
z4piLdNYrHA_xRNjK?YI&E4lciZ_FcB)L14_4_>}zqxuG!&I#3+o!u=aUKIWN;L?c;
zt+=s=Z~;0}eLPX^jo<mhki#<HS#hgv5K>Y?WoqFWPC?wuSuWO0(R9A(ttkw|)0Nnc
zDNo(W>5dS55|_5bOG73$i=G|mlm3x(gEnz|1ud+it2(z&Pom7&C7s;424!<*eoj*S
z5aG&*#T)ei9S$h|ld9LS_mU+)IMS(5e4d^<BnlQ(o_%ZE+g3##MVVGiZsa6uQvKRN
zYQ<X)>&Bo{{LDh}qS-9YoHfb+!mJg6Rw!U&!?TPm3`x6F61ec-jwR=9{=077tM3Hp
zMxzQc<eYe4;|;p0w@5ebR*k^wZ*&;V;*xbZpLcMsigTIH!v7?UI_#)WE_1>hT6G3z
z_QBfK)4jfdFre8FBtJ1d(+7sPQMw<+d;0QwEU4o-)z&IWnYQFTUtjD|{rr_Fg{Xlo
zv1o4UPl1B5uTAn151ExJ@b@vx7ZOP)b)rpc&V#5L$6vKwAVOocVn?Tc8ku%(De;Z{
zYL#g2h`G5Q|D>$M*Nbv|5iF&OY1M}OU(wOXW}87}zyOA~NGRcAlm&+Ln{r@|Peuj!
z7^%k5&DIibp>l!Uk-U|sT?|cfNYAw-A=hhhGc!b|M;y+e%HRSZMba`3*b0h^>k8J@
zI{$l1TSL<^tg~>$MNj({+`!N>TL6SGmzU7Ax($56G>8&tHPCOmM<=8A47X?hBz+1Z
zYuh2}DrI9{mGn=%l=}kHn+(JUFdlmM45*`993^?~t@sLSkCE7KKuv}1DX$hUsh<HW
zs9~Yiu?v9=>NC9vbJr_-7Nq45XBpow0{*CuFM86(y(OLRN{JGWL^|hI-Asp`WX;|d
zkfnUHI;4Lzp$?cEeWNX{tp5I4@^*BV^_63zK1fSc*V%QipyC!6VC;AfdwlEgAB`?d
z+@fT6ez#(Ou8N0x+HVkx_v9v!f3WmcywVt92uJhA(4RY=bqv>0q_`^2&@BWlb4g<-
z2dv2Kf<!iQkBR%0<5f+=!k6l<=l#hvDIY#bLNc+mm|&4V?8LCDwWRAiFkxH6?_+G0
z&NuX2TWrT*w&i(uk%`xA>mAz{7YktBD)Zq73hF`UOMCgex}s3k>`spU0jqhrinbdD
zb6l+(5koRj3Ws7B(EAz`=#Xmh@)ukiM|UiYW1~o0kkJ%YlX`h4XTC#h)eucg)7@OQ
z%~V1nes9)-ks6`eS1_36&nbH2>Q@Rt)b?~MFA^kmaJ-%f(36yXc<6-LSW>k~l&x5i
zh&KS6128UwXX6<=w1j^IP0+mlzLV9x-@u#TsBqzxOyg&&J0<Hlu5QAcyR6hWY!ow0
zNi<1)1+1Ev1>csqAq~(!TWFv*$`adw)Kwr87wy0kZBdC~XNgcZ@bx&2rM&j#OULWr
zT5U}9OLfM<WwyPkko*<-s+*b+YTw*V`4lvuNKVcw3HVjxR=}E2f>Gz%YLIMiFSd*_
z=yxoMgH>?#c4#~V;*rGRcm)qy*tm3FIWKZFetFUT-CgLsVj(kkjrq+)5DzW16WONr
z^i&dfx{TRnmI6qWSSU@K)<d7)yuEaX1^>CRj)bm^Z2_}ZGoaPm=5<bJI9!?fiYZr^
z5+#Bw)=J-tURZ58e0(^*{ZOsa^dE%^^3WO4AuMSpP=}YqCKTuCCHPZC;K<ITmq{yp
z+Z~tp8^mao0n~5pIT1eDZzmYT|FG#h5a1M;#G(;%<$<!;9u~orW$F63Wp4+%6J-Cq
z80VA4K|{g}3oYFjF>;Xi@5`0*zaQ{@13}hlAPdOH%i$tdjVJM~&Y%*0j&4rqY6Blj
zP|u;=1>3a24S3k+5hf=swcgcL`A*0q!#V7O;uk>sg8(Vnx5O)0iNB)O`JnWbr{5$1
zCD`Tf^?DWk@0DpTy!;C~gU8R8mrw}C$&`*oyL49bn}{nry}VyL-fGjI>leHdxF*6^
zpOy5nLjy_e0>JEF7p6ThD~y<n$My8<EVcg&I8A^Jo-KalrE7zb;6^8l8W+y2xc{P>
z|1IYJztrcV1JVRRcc}|dpwF4r^^t3IZacl?{F@A1_}U`Lb@vvd65-6?eCHFT?bpf!
zU4hy1%JYh$e8gRrkQMCTko)1-vHKkY1Zj@mu&SZEufqq>JufDqJPvig6^kN+*|l8#
zLUFJD1Qd=u&6A;cT;QpBP~B$LS9qhAzv+$q;+t11+38Wk{lT$nd_z$RQVxQPglp=L
zdER!+t}^JWK$Pg=%;E_Hd=XAP_*b~szJL5j0KFKKJV^V2yNLVjB`h_+bi&kOcy?w6
z|B?o7a`|^+&Aj1{?4v@N0`}hM>d1Mwr=;>$nYN62)fOi4ncYUxS6-&QUlfqfJ8eDU
zg^erdU~vg@#yb2J7BsF++M_kJH5UL#xPN@`G;}E?(gq>9@R^yWK1A*wh4Q7+=`6;7
zj@RsJAL!2FK~jGvO`a5sQ{WWDp?TLe`u0PdoI`Bu^6mU)+7e`EkE+89XwO^aI6PS}
zcmimtf2@5L{b3c-@KXlJGH-err%k0%zfy$B#YeT?XpR}PTq>s&{@C8!yiZB$Yxft(
zg-(v`b2-D0t5A~V&qKHnV6Z#zyod;<$daX0rzMvXCwO|E5DYv9OM`X>5E69!%xRnn
zaGq;L7~Dk3-by;rP#n#;kS$CC)6nNXQi9NE<`y<3{n0AUHXBY`e5S4WjOGjE`?>e%
z5>XOMB`t0w3wDFVpLdbid~L^)t;>tPoL1Sn3E*yZ;5WpYJ6<Z!B&!n_;>}}uI9TbY
zITlJYoax*&d_5lOyPO?7`kb{<e}3`4SwduBE1p~TZ_3*%^o;;Unon3E#q}Wp%!4cG
zUbAeM<2t=YY1Yn~0_3c&oIkp7no4`fNPEgG&M6@9Ek5wEF)r^w8b<F%_hN`oiMTIn
z-m{TFxZe-?SK^mjyf^b}t-mU0_qWaL#;@1{!_JH+kiW|37CH#VCi%^OEOVsRJ9YXO
zoZ#NY3CQfR?&bl}`EQi|@$n?-uNMkLGx`<a12yV$Y;JCd_1iPp?U8muU7YkxP`8Xz
zJv|Ce9q6~9bhxnEe;>3gzs})m_AWJ(lEKQVCr(-DW&PUHb9wH2zsyK@KvpxsqRhb<
z07ztTWOt?Es#(QSa9lcG?l_S0Mz`?$01L>&Cel98<#}FXq?F~zdDmx2(k3<aA90ng
zGy)=tkLz#&hH(04P5Jd}o-}N)Qz`*Tnjl5ax{~gMZH0!gCbx9*hs4ZY524@KyT#MP
z7gWh`x@=ju#+H!&^B@O2bLty=oA}m~W=TvIaqT$%t6=#RtKY#m0rhCot)Q3tRP!#r
zS{DY#Cap2-Dz33Jw^lkC>;gsp1+t^#DKwnAh}r|AU@?Cs)g640*Z$pq8kF(<MY7m}
zl#{-4rsL$WFcAp#F;Jz@Y@qOrz(KQmgT-+Uc!p;LqH1biH51cF-w~D|7w1h1QKVpV
z6>=<ZEbj*MBYK8D+rP(FXsP%!Sb8?S6qQD#zQzd{MgnSHZ|^eD&Fu%pYZKM^mi8zm
zJ83V%aY0x+%LYBsAJ^eLkAIRT4gh>ql8f97=0@ec2O!nh$?PB1ymRq-oMW9;5Rxn-
z)wG2MlBZ;y=g)+Kw<F8DPmvA3)~aE+;5{1)TGFnIQxe*h>q|yjSXg6G`$v^7-hpm9
zWRJ}Grtnp;)+(7;gr(pO+VJldq2igE?LI|<qcorZh)by(lY%Zb4O;8@7|zK5>J)EF
z|KkK90W7z?1ZaJ(kljYJxKOJCzmz0(QF>MXUO0XgYqD^hqya?)@Z7MK0UGQ3x(WLn
z)pBDW-YQWQ4`_c1phpNX20=;evS=0lD~kmO@^`?T8#UhtLx6X_7*DuqIY{rBhj?Z&
z_XTgKFNtcWxXuR#9hIZ&+mAoYVLiT-JuBW867b6(Kb!@msn7p_k>V}uN=n)e!9eZP
z6~p==_t4KhnqD76;kg`1La<}!w##Lz0_0N&B<FQZ5`eyO%`=kDI3+b%hw_<o((<Vl
z6e{?p@@W<)8Du@7?y*&$bFB(q2BQXhdQKg7>qH4e!+0?z#Cohg0cP`3Zfw<iJE@^N
z%J>^g?;G9k9?C%8qga)ff}So<Nyvs5JILAPR%5u&1idxW=x@Ny>jci98rFg<(9tuh
z`Dzv-S_F0T-oPhH1?O#0N8YrzXbnP}l^`?FwkniAg)CXb=4;-&LQDNz@!flGaJ+=5
zhJ?eF@ymnfoeBt(E0PC)9}EydAubarYHJ#+CFZ@pW<MQ1F?E*jx60SbxfHCgWoIym
zK<T@QGSydGKBb9d=|0fW*&_F#4U08Qafyh+eOK^l(g(xBX$SBM^S+-NIQGM>WF2Zg
zpPojUh*yQl!#(`H8Rn|PVqST&tNh*CBF@yPpN;O`$)oAXKMz1hx7?C4XD}JtP?a|B
zdlh8LwUqf7t1PaV2H<(3q7xc8GQk@NHHzVza6ZM+j;qT*sHmmR`Tbc)XFpLBVhgDL
z8W(67oRiPjAfxp_ST+&}HkSSbtd!Kz0I@t5ncr?~8TLyt(Mx7~3B3=@%0Emx2p4E3
zdn~pPhF2<oQ!V`EO@?*GbPT<v6f^*j_YSXVLov#3#ZQpxy+^@pg#O=C0u<iZetxK{
z@zbLx36jS?rCm98HotT-&o3f@DuNM0DWEy3c<AqYTx9^1=3Z2KGY!@B{und$-+9Tr
zVOoU1!KFMN@~R^Jn;^R2m$VK@S=TRAeSj?=?XY&C1u|d4&Mm3pM@4IcGET-D_@nvm
zI7q-B>q{w%IG&Tg*^^rDN*{<IN=78KDwFmt1boFJ>a2x*g$rVBPzDVl5oM=Rvcr*r
zpJ+dEWvrwr=*RV^`F4~wsL$M7#Yc?l{h1JrpyM-lMwHP_M7-nG1)W)p__h|dGM;S~
zbu|Llkic5*tC=JamWp*TNBRr%X)b-Ia2Hc^1}`6)XH`SG*pwcHACn&(WX62PL7&&x
zYuh~Xh)vk;-|kV^p17N6JC=xJl?fYMo?OmGIdZXi=(q{K`jV2uNCvDqx3xU$_!)W1
zd1Q#Vv+ljLOtMR~-0zgdU7KY+V$X>el6=8`>#4h(XlOJf(X1&41&pz9N%20|#z;z9
zTnLj*la>dl8T6C&u95EivD4up)M)z!>(Wh}VQJcOgKjrOyHVOWX0<W?fEa+n#5|8V
zc5zNnEIzBNH$Ebqt=6}l!nz#ImX?X^?HDjV^_>~d?7g?H305`sWJ@eM<Kq^~#xjv!
zrELw>b#RjQ$hgj0PH>#uqS2xBExXSu+T)B+ABlBX`U_*wiCf0{{BGhubUN)`Y~A`*
zKRYLiA%Y@flgabrk14D{<T6vtu|On`bB#_pUaTF~#om5!fMZS|bQIE9`n!t-DG!#(
zrrf(*z{o$NNo`d`UZ+a@&<S}H4+|AMCvV`-mzILxpxWWX1KoiPyA@k)MMW&byhUa}
zjl_7x)cdW96`INjeQvd=_wX0T+Xl-kNgTaqd4FGqZlYhDle1wwF>PY3o}2A1IUQ#%
zFV<={|6r%vWbMd91&u(!0c{!pplP62;`%hsS+PcJcbSI_DJ4Jlo^N00b8}0$o<QMB
zLh;dl9r`Y-1<w0bC*4keTf)^NT66|%Wk*mn0EPa&^PbR(UO~#5H(|}zM888i7U!j3
zvHtfdPR{M)#Vem?gnnMK4q!LAZ8O$KE+c{!^JGyHj&AM*aEuKmJNF$m;RA1x!&w{7
zX;ACk9pjH@$Bv@566-t7=ToiPyNAIBztI#ss<qWTt)>i`+}F^r(pe9hXij<~lob&v
zf%W`-YXCT!w_qZG5Y*h}PtVa1*K_J>P>E~R;k-usrs7V8YQz&A-kHr_vzZlVj;^nE
z2k>>=+u>UpodLXw;IH_J{iv}gZm64#heN|&k|OW3Fe-L+bp;tKP4v5ciDmKir-3Fc
z$#k3Dd@e_qq1n466|pY!`WAGhk@~S!OmEz2Xv9v=TWA5@5^wubU#J<gM!o4!^U3In
zHq9$={t7|Gd-pKH4U_X>el=?3s|nBj38P&cpH;E+*t-ay(eAd9%LP{>!AG1Z=d)ws
z@q$@}=>8K(8%&>M9J-9VSab*)dJ@{}m*^~~T}JmdVKVrDVP<`+{!g#Zih2%BB0NqJ
zSO~-#>+AbcR#=+tl7J<`jh_>qcdu{hmuzI!a|RnfE&45Y=(Zil>q`(d@UC<Alc|QM
zM5eC>o?}*|4|Jr7&T_(yaW)t6FBER{rx>{ctf|XKxEUx9&3_6b`p!F7)%LL8%vK5V
z=qUPdI-GLHA*M^)A0=BR(0LLa-F{~rWLY$2{lokd%9Z^jTz)8Hg;D6Vgwp-o-Bz(?
zxI5$}0dP$D@S@n}1i?SSJr91OTiQC<dbght9U>9}*1W8E$*RM>yjJ-O(Ac02E|>{6
z&|_wb+iR=J$BPW~eYH=~W{BpR5K%)zWx%DiU~$gVTGogtp^XKlcY<BMRtQP|Z2?OO
zXw+QmJxzrdTqTO;DM0C0@SYIE5XXlcqNV+J$MXul^WOj$g9aZ!8Fn#wcOQsv7CDJg
zfLT{|yu+=*Y`AoA7YK(p#&Ae#mCy5+wMv!Lgi);Z+({;Bfu$LBj*x>2yahVU?wsh<
z4#eQVrAx9xs9Ty2i!AVAu3Vg>q`E~GQ^I#qvDN*N>)<AWrvG2;M*1(E`W&ET_pY<$
zeWU2szbfl=uS9!3QX_$#-*jtp<trRH5wayx5pG-cDI9HQ>nZG83BFuE$8K`Ypn$L5
zyY;7Zb@?asG!j(t+>8{r*e6~!@#@=?Zj*oG#Es!7LY0nieO~`ChVIn#6=T%E;el^&
zSX3><E~U37sH8n@z2|lLX^fd_*^~R~QeB;F2r-2G`{nLBP4>HYbpadzEa7KBOq=6R
z-Xg14aYR$b>;dQGw=OF@B)4*Vf3^t9%a}kq36Ivp2%q(BN*)IohpPKI4+Nh@$s=$s
zc^SK^$jk@Yd}94Ua&<#D(UkTjNu2wTT@ale9baD4t=YNQ@h4s<|KHol*bx5ZlO>d-
zQ{3-F+LOHl1d}#FO>GfbGc=r1@jepyksOltj^F!vN(?$hlEi#1dIqIem?}jQQjf99
z2?fl0GH4g2sH;E4K&7l>204Y0juFKRNmt<&hs1CuBKwrP1|A)7cp4V+;KeL`!x8EP
zl2(yww$I?Dr4_+8l-@{CN-=hC1RnN;1je^X<r?;j;I8D{4QEytIT>Bs(YCj)K(9F0
za|}KFG<JC5a_fPL4&90g>vpBb+IV+3#n0=#%2;Dw_W1OH{1l}b=q$QaSU=bBFguZJ
zYJisSGRy<;{1&nPbj<Yqp?)C$Y^!68U_Lu~!TJI55w2M!FG@&Ic}~jbKJJ0J#LL=N
zTQZ!N^&6OL{Rxxc=1>o(HSMNU<a9r4#*|u~+Q%e3?fUD$Q`wU@FL@gDxPC%=DHRVK
zwILMH<GT((`Pih%D@`;904wKLZ=NMO-+FaN_i-FxN^25|9D&<NQ884~%&~TbUo6YM
z8K1^V*ncZ~3P`R^vN}qER69N2#GX-a<@cz1S(DGyl@hix_zCVk^JKo^Ms4yZsT$G+
z8#uS4qc>5KW-gt4jM!{#Pn6xBB$ZhFgxsoO8)~tBi8b!%(dZ)jP4LD)0S4-Y1(&JD
zbf*=QZ<N1No^4)g*`;~O1l_SjAD$>eGp)$_3LO-OUipy8t|S(Gph;zMYUuH-fD3&m
zk_RW27Tupx!J#1{hEhomm~$;Gc9)}?YOb148_Cke(%4?UpTX<kvw;cUJ<Ch){*^s4
zQK49>G<jKp!Ldp=!$xfD;bE}#nkmJR$lL}xm96wNXb~y&%|~?@rQ)94MRZMToZy9_
z|4tA^@(+FMgf?D6`q;dp#R?Ok<l=zvgOL_-(_8}mzLe$*>*Xz%)eGS6&1<<uxJq)T
zk4+XWhNdqrxQt8fD3M)67Z%1N)va(#a7acckv}>84+nyApeu0W1kxJE#IRR_$l}@f
zEIK}97*t*&+oLbHD1hTz=nS2&?YQC+FCDYlI5<tCz4IZjEfk5Y+NfZ=U$N@sESe~_
z@|x?SbK-$<YT7~MTha<IeRLN<?Qr|VU!-jEnk7K?cJ;NO&V*t6bHnq_;VdoPi|bVY
z=eWtyX~f~b5FUS^ckB@&@XgkS6Kt4pT?ljS&Apn00)$wzz$!<n;T8;2f)Mp<?ln4N
z42J}9XC;fWDTyAhoByy&5!v%nQ4Psg8(Qh}yA*56_(|+u;chiS5M_N|!&$F?=y16Y
z>>mSY*m7UZiH<I|v8jt7Xj7^^ejz(W%1Pv38u)c49o9mm$?O@Rx(4?4jjl8d;ts2G
zfb=2eKbpReBL>fIPj+q`cKm8j`r$P%2|J~tZ(qy!yZSdcjV}+fI68?BlvhIc=<Tf>
zOrBI1q&M6U^@D#Z(27?>4XZNEKrep@GFrJM1iku}Dx3ezdJM$OiOz}a@BzjxVQRV;
zJ5&oQ@s`@EQJm{ca*8;cluecj2Ikvz5%@MkS{tguMhf|8p{xp(5jZU0YG|q9;;|SE
z=s4;gd+><lNCG<KshIW%08zD2meLtQb;LI3+mL@biy0i!xTb45{BYr?5ah3-PQV%z
zlw+!`xaxvCdpG;pGGVgivdRulB(&1kcyIF*!O5&;;1};w0oH_s9E-E^WM2QvJjlYz
z0d2IU4`o2B0`Thy`e9y~R~=8mRp2?CRJu9}UKf?EUyXVw3@Oxc85H(Q`#IPNoe+)W
znU7&XST5dvr8sgwiHvb}{h1@|6E8teC>h~r0o~T2$hFP71bjWtsQ6}~(}z!U_Ki|#
zG1ngGaCcEh3R1nUy7M~;w2&o<Yh>K}{Dz*!WZj)IFyT$xN&HU^k44A^2^6$J#q+s2
ziP+;v5w1)1`^Wl33-Y^B)jeyLMDrc)pgcj29=T~bKe=R2nb5;&KPRUn|Cx-TyTv?e
z3YQU4k*_cXHNrM0qZSf(tXqk5liwclL#-#qKkgNv#Nr=Q#`>UNz;g#dlnBW>kQXC8
zrSJ)D7eN$&)dXCKii@KCbkl^a+4{igZ1EgrCY<C7$k%3$qE!I7XB%J`ZBx-Vs>SPo
zn>IVG-~a$i`Rmg>LeBmxwKwlhuWO&fd(NT8wiA$}d>zz<sSatU@$&*rs}xo^;$|0J
ziG**gYqZ~A3luY6%tpDX_0Ilqea-s-ba<p*T>RV-vR980FhmMJJ(^WOTt=mp`5M5R
zAwwd!DTGvZM>I%+8T-o^=s)d9))66dnUSEY69|CA!JjHJX!vcTv`|Z;qMW7;?J2QU
z1PW=lpuL=k$ZpoVJRo-A$0_7=SruM^V|zF>y1IsvFAK82?Pu+SLu{v1{8o_Wv~}wE
z)ZeF@_k;6R54y~|cJBVBJZ*`WXxrQ0oIYh+y>S?#ea+=Vmg}BT60^A-A;g7edHl;>
z>MUriUXqiaHBfEMsOMq{n$=|j4|M;j)BOyomz9!)5R&Ee>~W!FAh-F{7BT}AARBR{
zEfav&>Z_R_WrSmX$&Qyxy84u65mHs>+vRU%b@^!1kRWVoNA3drDKN&%k|JPDKl?B5
z=EGu|Z~0g|3h`;Gy{f`sH_XW>L$NaX$sI!OeQbS>1C|bTPZTAT3+s@0_Lm3*GS=TP
zzUGYVdKZ}#d>6u!k{c|j<CvTAFOsHhT6ye0hW5ib^@{iwdc*eIjmwrWszvehWD1rn
zvthXVN#I$KBN%YBkvFJwa8RHNWjMAE(F&4pRn(fca3P^#L;sp~Mw8S-R{m=F9cXr4
zkz3r%BMmV089@a2`9mU#@8_B*3JXfu%c+3aBOvL;KxM}}9AQx!dSTBz5gqfE{hXUn
z)HHN`KA&Q@S|wpqemJUCEheA#=4ZDJo?#ZLu}3UrzoIi2{Fr_e6s>s3a*1fo34Y68
zXR*nK#(T-I{4rzcS99Cs9gcRreBD^~+A#2!*{R4$W=Rbvf)nMj_dBld(Cib8=Gq;V
zif>P=%q~icR?beaR-i}4KPfBq`unyZdD(QNM2pv;oFPRPY9(5zKut)i4pEnWMuh@T
zo|V$@XQmfuInE1lt*)vLv|vksnCdwN!f}pD!%iP^1ofNM3xZJGTd@r8Wi5ms!*7ky
ziZGz{msrxCHrxJ9qPUzV7eg4jGkl<X1Y6UQrH@I}SayMGg=NzHPUbPB_0?NR0A!<X
zirRFK{G)V<;>9_F*{0iPVMK&v_`DTq7-4B?Wu8M4q<7r>CHU_rw|Hg!WHqV6cX8f;
z6vXuUV9@etc*Xn6U;G^dLtFR}m9;34hN2_&5&Pz(OD{pFAB)I+P*}2uoLO^Ylw`|$
zK?I`mO}woTz9_%SYaS=zfNMLq3srl)qJwzYIEK)V^R6EchB90)>JfXLiR##zlX-l_
zy!q}EhoDq%j$e<!I5U<z7#S@d=SR_+ACg5s;{~#o9|blCz%+gCf%0132uUwZB>Szb
zIDAOW^OE_L<(0-(Pez`>2^%tV_9JpJ3bhU7mzrhwf2A!yit(@y;t-5B<500-3sYrx
z?Dpa+dM%U4`CWv4Vktl+pL-QadI8V8plyP|(=iuO_cblAyRroBRIH2vo>Va&O?%rJ
z_b-r0b2!xxQ1_@EI{e#opng6GqyAoRa6<+OR=A(bXdk(}8>e%7s&kF0&A0!wjc8P1
z&v>mKMLaY(q&V$27vM(_2^^}c6kC1|<|Xb#l1}Xsv*i@~NvD}53;Jg(tC~~rM2cCc
z`v?@RcAC&GWI`x*Aq%5!kD;t_cDHfQRc@{cnP|42{1)I9sWrx^l*0v|63kRlt+etB
z-ciUde&nH*evVeu%D}Iti!oO@GP?Wh>BM#4!=TIGi-7wGqh^`-ofP&?SIN-f&=V6Q
zhPeZ-i-BXa4$r7;u?A)J`@E+lNauOv!bk5>BH*9da_KbXK59Fpe(9sV=dSWWsMoY0
zaRtw+g^wgTgJgY9a@-B$8e<cWOYQ{W(|CZ%`65VCnIxoOAo6Vk=F^xqSy#MESv8Gm
z@c0ATQ(U?EDST>W(6jSI7<208(Nm4!TmAkGA<#vqz?f??n)3~R6Uw9G67*I7uFtX6
zl570;7EVk8{HnZ9F4q^pj3LQjcQ{M29m(vfk36MNX&o;n(FyQHU58uj>4XDsLO9l7
zRI_9PFa$Q?w$loLm58{9g}Dl!%BoM?*QPxb5b-xg$nwPb3G$k4>Nsee9D!+9ycxpf
zv5OQ$SV$#Ncmc&o6nNX;YDvM5yR1GkV4ePXL`o!7&L76d1Dv8gfe{hAw<yQ#LvE_P
z_=Hv47SXwoyifDFA`3B_8c?!<n`He78)7s+Upt9e@6SSwYI^<ca+pt~2*MP=^Kie>
z1&$xq$3ulrF!_VqDx-`ye)3X*JBXGb@5);`L*8MHy~CS@Le>VZFhb<x6$>WDBRCKB
zFXtzu27vwo!3stySU5MyR%8az0OI;Ob3^BsZ1*Q2T{Qf}y%z~sqCcI$xvENiC9kVb
zbv9fmzF~QgQe}^2jZDWrN}_?JULq5bZxgQ5?&8?qnFC!~wvsK5e}$5WqN|Eqtd_5w
zSwE*On-67FR9k2%9kVm&36aluLEdc~^)qsVuCdmmYiSnsR2PPWo!7bMR<&V;t^+38
zPP89#7pN9`O>8v_N5<OQNIXn$W5r`NIjh5_We>yyYc1Z?<#bn0d!-q7m7}F74D3DA
z4|ckbESUtEdhR)gA(T8HojsZ;zSMCtogq5@lG7V*flxboj4+LvTg-NCI5m!VQwu`l
zw`{auDDi!N2Tgi19W+{>=r?`t`60Btrt&9j^ev&i^r<RHm3I#X)I4(aucKRkyjbxB
zYM>i|QW3_%WwEa}xEbZSU~;ax8oIJco5STL0Bf&iUH@%hA2x;-a#yF1T!|H%r+RsG
z(+j}J@P_bL(&d<$gPhWqAUQ9qz?Eyrb%w`?tKdjnd1Qj(pR@O{f6cJt&Vi9JltSCq
zVIPT&T{OLy0ior^4cLqOL(&an5l0p3U&QPBPZ#oDg`jU}kDE>=Gvj-SV-3$yq#ll#
zO^wSgbG_18n$iRRm!wT>?9*q1kl3j5H)M2!5M^rK4awvEe~&vR1Tz=PKJRxliS{^h
zY%xB13cd0M`~jT;|118Q&7H3Kp!@{V{nBXOU%tt%{^i%V<tKWUtNs!fJ{8Q66q~*M
zIJ}SVy4+=6@xuw$bHvzMYyTy2OF%Zp172xG|0VX}1EI|i4l+-cHS(CN3B)!#=QMO#
za*A=RL67bZZe9xTq5R<w;+&RkkkGAt=8!kiT5|7>#zfeLp{iPMid_ED>R@xs5@i_0
znD>HTAn<w}-r{D*7P?Pu@VZv&TuWBH|JlO-U%>9=&B?qlPP>rT7ApGs0%|MNL=BAP
zCl=u$Dro2LZ0An(RRi{HKhQ3qVuHgehVtwP*$+%DsiW_p06ESJ6YaU<7R!Im)90P6
z+g-k;WC;%+WLk(s)AVPgB}ay!nC58Hgn9jxb(Y$YXN`{YVc$2h${>4F5m8<KX3<d{
zDD!6|`rd(PzzM1<&kAfJ?>PY=W&SH#D_-L2lA!Z&-K(dJ?)@r}`bEaHK#P(THktKr
zaz*I&``FTl$&<SGt_Y8|4@5*qSq<n@c%TqhUC}!qSzI{3aQM5bipL7w=r;G29fT6F
zfQqwXXBi2(_@LGa4^Q2=7g3Pgz?kV@TdY<rPO-km9{BP%hgBZk^;DtKVS6hKT_48}
zCxlHd{%7$fkk`w-hO4s00wL8>Vi&Swo~|nhII&sXKGaMZj~(~dY+#E;mJ9rzpS`Iw
zl(>2ps^CJh!oRJusio-n)NVqW3HLDj2wiGMV*pd;FUJMgn<usrwk%YlTjj->Uzh=u
zaP^H%eI?1fdURz?oMV?+jPqkN(<6`I%g`stnLQ46+4z!zFL>b%(q-&QoetN7mxGlk
zrKU#4cleQ<YhNh#LG2Z<yW^<DI@I(Vj9%orHQyv<PfH20mJd*bxw^!!8*3B#-<Wsq
z%lq6m+!xu8ZS|>1zi9+>p~jLO25|~!NzbqF$%!$}tqk)XjpWUWlC$>zU9?Vl9mfC^
zF4)b;Uo2X{r1pp^D$!$_n<0&(&}8k`K7ex^5t%zr!RqIy1_!n53Fc%TIjqgMUff-z
z4&UcF0iH0oV*S)u>gAG;4A!)k?jG6SMpW;TlvdVB)UyKMX814*%d73rF}umNSGqZO
z_s%zFHrD$NLznPnik(?R3;CyQdrBf6+Jr_(PZ+<l6!UdsvG<ToID1D|&buJ-O=F~{
zIkmmB?^%O~X!|?1*wrsNQ4p2qc>;9rB$@c9Xvy_Q^z-S*)Lw=cW^0t>D8c_ON<!S(
zU+>!scv95Xc1OH63(HC`JqtgG0Z;&RDhv}X46)x=GO%Y7f)T;}nSNNeo<E*AXZDx~
zT+pgALZ?S6QSbESVEqB=<_+0d<G85u7kGI5V7+z`#beL7(6%&kKNnXsH{I(JajPgB
ziy`5wk;dy4+;{rME3pQlzMlkSJ7A8>@vOb0!vo>H5mA2aI~kbVbII`#xj_{+2$;<n
zccI-0W`7u^tsqBV(*FWP!}UGh&;!n@^~h(onX%&E8@Ycr2D6272Mgh0%Z-3?p(b_s
zQxlr1VsP}@H%rroKh7dxlREx4{K2L89AkTVL5>ag+hW(L<y|)|uO`R-I4EB!_<UcV
z^@rT;2Ppe@8F5iii_$~HxOI8G1x2%J%}~>iIOAxwh=}esFYa%`cTu->p+%e?ZHn4Y
zct1}ca64`FIQ_jDY-Huv<?Lh;iito(9GrfbbUZOu@Pav>+z9uwLTN=6j(34VzrB^I
z>ZL4ANSsTZpI50*!Mw|wDy$8CzwsosTfLFG=f0Oh<WWZN*wqp;_`Falvd~~v@IRzN
zR8BYLb@31N1z)~*MRW*B<bjz-<(cQ*^ya6p3UR=_*x5z|3{8tH%*knq3*odL9^af^
zmX6}{otT~rItcCrxtxIxW)-Z@S=fTG(l>|+7`n#@2GcE_>m8`|DP2a>HafqLU1`f*
zZt|doU51wA2@FWyst5o1&V>m4w~=z>?&jJBdiEBw@eiUb3w(>hflqFZlwTD77R5X0
z7vI0GQ>ygA(idEMQlVGiLAs^wkGSQcau}%L4sA`)u#lj9!Cvzuu|~q#A8~MP^_k(b
zf{Fn{W1eMmlRHo>nam5=_5u64f3qV+`DE$Ei-hXBuWhf{2^tKX^%lD^3+ipN2O|Z3
ziJ$9je<qsIXii=j@tu|IEKHAA5<#D2T$4#0%d`Tau1}$8{wt((u^`l{U5BYh+U=P2
zOs2pwb6w$S5!E&;J5HXe5yekO?uFgVWSAyVTK?<IUtP-?W0(dWYNg=1yAPVjJk3zv
z<xu3~+v}1Q(69x0Dst4?A?wS&4CUdMCG!;;Q4$A(R!SB{uY1Y-Hn#_C@@iJT+eJ0B
zugdvdZ_5XFUB<yPP$DNC#M=Iog4ydVIf=bwh3T{3`b$Rt;JteAj~gkZN7A(}Olw~5
z4lmz}yvlk{OOkM-aIfyA444o5sP_t?r<9^O3ktXpUgdw(8d_X>iOpsYUV4ep+w4xs
zeSCer@iHtpBaxJC4sJvvf|*HL5c>JOVpl-FZiRB4G&elZQlMgC>2R{xhm~lr>rc(3
zOiJ&*O5+NCva%}q@#5KfQLAK)bXnJs9r;)zNvH>WQd`xQ7Sjdl-dsnqo!@banmiab
zSj_LZdFiE$Jbgf^+O6|~k`&ARTN13;4+TDzP`p^Yvd-!-E}$f-QPveC%ZaonG$aS{
zXHinQn`K*=b}vNmX5r!~*k?YCny1{&xI}HDX~wskm|xZhab>r-DwcbS1(pTm54@%p
zPkK%1x4Q9dE)-gvDn<8c&yi=FK5R9n4{O{c-k<BTna>5Wl`R<7@AcmL;>pigZM^r2
zuiyx3(lJXDF2j`ACCN_}UfDI=6K-t1phutm;(74R2^YdwQETJoAh3nOz}k^>T9*~2
z)8I2LXG_T#*1rlAVn&mTeIauZS1aW<YLr=J3zA#a8|aGr{64%kjDKX@^)xsBhMfN_
zk8!4ZnW3YdPI<Ss(`u6={fhq!)xaXxCpx=d+Ivg@j)ks`nMBFN0I4VDbrOMIHR=7I
zADZ5&s=QCWyY|v^UbWPNqBJV+7hROj!cR}#WI1qX-atk-MQ+U(<`<T?H3*gOqThY!
z`v5?vwmrfW3{&uV&z$htF0H%32+fMQ-rm;yLB6h*fBxb19_Jz`lu7*&BLxcEoz=!g
zS3sk8f!<w0ud_>v&OO=AQKbH7!aN9_5EvRQ?wwByupGVF%gGVen9I_9zh_!8U!bV8
zf%xlD+_!vOIW5Hvu?AJTdmmb9vn%hohxo+2_mR<(ul?T}e#m%SHvHXp{rw5we{Q0I
z`B*NsWDoWMh@7A2?57OL_#-%{VV*&xopS{NRNhNDzmFp47MDg_MCyz6YS^xU@y#fk
zL=}r*qzV@W^UPT+$+fZhU2$C(kIMBxqK)j5@Ws=n&;43gx-Bq2{&hYuCXJ|{Ra>0T
zgML1EFoQ95{^uwfUa$Uc4z_i^ruuj`^R?g+jkGAkLPyWzKZ#|F9bV<Gn}6^fftgxn
zW_2>eZQMW*PphVU^CPN-$DTw~+P%z@R&K{E-v|msxT*hIRjeT8noM`^W24=q;W5IV
z_PMgn_Xf)wQ>rBB$?kgJ>A0is*EsTCimv2#ir!S0bHEJXLYZlP`Acyc+a1B7Ubn0B
zogJ#`0lt_-UZ8atRbafJQrpGDrm$>%`Fpc%S6?e>s=wP|;?O~t^Xr+Ab8FHzbXA)@
zO@pzY@FfqPQI#VlJ~=XpD_<q;rI*@jmcK;t+fQB;B+1=~@00{>VVVc{fvlvVG|rW)
z%vG)f&$)Wd5GfjFv10?U$Oy#k{30{+_TKX?@MX#(f569k@V|~18g_Dj9WNzk+eqnT
zIHcih)FE41k<f~8ks_@ycY1l9VEFwC14p*CbSKrQk}9w8!6z#Kh>~Z(#I(3JO`A-L
z@E|XedJ5Atvlb;XH>ojjDxrHaT04i=FN=`JQFJkS3=IL31l)KD!#X%YDanHd%SVlx
zL=p8U)iOWi=~2X&UN<8O;Bmg)1d9c)Fw<vJGlitOl7;pMrKj>7)hH5C#AS-V%DX5Y
z;&ir@Q|KRb)sNI`jv+<@mXUc+P!UmMBtpZp!IbSETcn&Epk4E$o40+6il1P%)=Gl3
zU9P2#d7NJU5#K9FzOn-fy=UOG<|yjV&t|W{$ex5^rBT)R9@eF*=1X$KVADiqKT304
zuUc(5wV{ozgr(O>rik@7x#6GQ64}I>b+)ud*jL-=aJBf|=GE+&^LJ#!A->yL^v+#*
zFRCjIzdQ3a0zuGZ?SM3dum}I%x0;}FG1OTKE>lX(wn)#adyNsYfGhqN2ti?W4m<(8
z77;|qs_VM2nj(disf;2;RGYrR2+#YZA4?@!>?8>z>%4faF=1@+(G0WlFAxl!t<JVP
z7bh#0Z2mUQ#jd2L&)uRUSC%J0#5^EaNItD(;9o#9CIldyq0*heP)7)}&osAGO#F%w
z;J%$g^^Esc9q635Rq|0+ygjXz6-tG-6lq6z*QRm4hV_c0LW6?MRRPrS`P>VWLND!o
zz3o0NEunSSEB$5ftNI}?W?wVfn781lv0{F_=a95s9ahm5-$2pqY<`=00XB5$`Sv^C
zxh-<ZDqpfAE+Hv7gXM<%x*DXsa7!B}NFRuQ`b;4pX-^S7r~61fXttGJL;A&}SPB5G
zw-2djKN+(1VL#idZ=IN!Fg!?=g3gLbZd>mOzy$=7?8itPOd3N>m1ataCGJdQ3VU!t
z)(((Rdx##d2de?{J6*J<W#i)7MdiEc_q56J5kuC+_g-94FCWt@NrY3=Jur_NP0Opq
z!5PHb5>kEk#%e24CAHkD4j=>%Tvrk<Oqq44MffA^R?6K*tFrg^N_UCe_uyCXW=g1w
zp|}{)ysCnNC%+?sWzzAi<3nFfQ(-(0Q=ia&<149AIC;1sxxc1x@W!zDYpRXCKi$Ui
z`=1@goN|6QD(elzYGj|SwyE9b@xs?KAM#~v@O@4qULAH2STmiA9;e$=2=I~Wmb`Q~
zJgN1PPq=$|3&u}|!H-{Xde`nmJX{s1P}$SrX<7iR1y(z|0KWnd@u1I~>A6vYJF0h8
z7OoiURm>oP^H*GPkF{|hSe~g|7`Bcp7k+f6Q=nN%`y6Ar<|aZ=l^CGVddw91=_$I5
zd9P<FbDVutS<$kqt+f}HE}<USD#zL9?haOoE}YMRvqBzfoS(!?XsR56>`yp&h=F{g
zC;t{KlxOM5n}!&>y{+S>ELJzd&xRAv(h{2xr<oAVS5$IhKyrN`?xmKy?95JVuP_U!
z`g`q+vCY1+0a{mAtHpsmHq^6k`lEzwH?#t~5`kxp`xlfrVz7`mx>9ySi9#a@2i1$R
z+WP!(?StT1C)T)BUc`dPx56dMW&8eKc|kfl!;H&(?EKI9vi?MIGI5bKwd$#r8vH$l
z8-C@#{AUPPFGmw_aWXiGK5gi^7y1>4;_NeBt(<~vww}YSSHyonH^Wb2@%4_92Cv<2
zh-H}xCZ@qJ9f#4IjBGjbhlj`UvbVEeI!!R#``*n52GP|6ksq?>nExa-^QvYVuTtLo
zl>cFv1(I(TlHjl+pl&h)26H+rT0pR-bdReVCX3{vs_~FipW-GkQNtD4xWJULcBJVn
zx^m$qZ&;hwlHfF2!YHU^k==)5ASI@|EAPHd$s`o8-yAQH!OOgyw;IW;daFHoOzyTh
zn=8{HIx4g#79*((LCY04#<^qXuiti)sw}SJMRGEoOz}E5QDrR+bd9KFQzDJ-w1m}m
zl!m{|tGQ_DJo=r)_(KSjef0oa&9)HP+Z?YanIK8@nbv8PXPt`tp^Ty9iFsLkZ4DAB
z$0!u6eBlT68MRW*r%d{K7FE1Y>h#{|T(mAo+v6IysT{D1w>0A_oI`AlhdqCla~NDL
z<sV^5r5Nc)3cTipJ6&@2$C;NF*y?=2(dN%})k{eyAE(P3VmTmYE>C3ov$3#SAvC;8
z9Qfxf-zMIt{_)=13nJYTio6|656MhpW^%t1C0gGcVq)y57^fA~!e`XM5-^E;F&gdn
z_4&$ScvPLsXw@~WQC9X>NqomMjU}2X-ZtiROlI%Yp`k>yn%W1p;l35ix;W?O7aKTj
zN6QW$8um<%!tL_=*ZNJmq+finyoQ9G{BmYHMBXvX(2ugD!l~1!2d=N2x>EJhXCF`2
z{__Z2V^!M7CBxk`*6gam=00n87+xgDT3MKYslNMnTmiLRu>z6@sZUaiI89=_4GB1B
zsBNv#OIxA*Uer$F*Q!@T`9`qG4j{+CXbajyQjv~Sexwz)YG;g39}wMoSjy_G16Vzr
zyOQJDNr1JEIVYcWbhK0PO!k{0yPTv`+cd}x$IsqD^<<S%vNDIShxMa()nl=Tk@1$i
z{gpqlryfYHN5VJ?IXBXf`!bcy6~RPb3YXp9g5_oYYmqM(IxwYt^eP&-rWi96|D)U{
zDx^ph{PeNa<HcTeD7ltnA(t?OVyKj;@>x|S2AH)Lmf((4M+JemR(V$&=yYUsNc4Z|
z?OQ?Ls~3H98ZUk7q=EU+OArg@v$IS}<ZIK*If~xzBEAX(Dba9HMRfnIzQ!H}HYlun
z@%R;Jj?-KYGRqHqPUNWkbtvm$aDqv+R1!HOgm2oceqs<%Y3hlNIc8(9?Jzot8go`G
za}K=mUQN^>+uf~>PE9m&V6AO7Um!9Ep(TvurjBokAuizpr}pJ9W1RO2Si+;95<NQ#
zz0Dz_&yx9Wsy^Sp%!Or%FTaai`ah=LGpdR24cko!RZ0TLkKVg<snP<1pi~u<A`%1y
z1d-lLXwrM{peU#)pr8~Xq4%apk(SV_B=i6w^YVYsIcuG7^KsU!WY3=c-1l{Lan&8p
zM$+U(6*J-*T=Sb*FcSn(m+v8Xy-Mbdx+@%goI7t~gv{6(%SP+hfW#Eeeznea=Iq%q
z$>+kaw>ML7{OPN3pu*K^yBK%c8X~6GU+V@~L0+d&Lq9$w2!0(rBxfxvt>{bi1$HI}
zmPXNIFIeiG$_Ta5XH)($A-k!^Rr=9lKS+27a9~+`<+SN<WYA9)V0`#^RQ>Dge|$jV
zo7beQFyuKQTsL$s`F(!5I=B}ZSz1Kx0)Hv7bT@0O-o_N(Ht(p5Nd368ywA%r*ea)k
zi=tzCiKHu_FmZ|G{f5?zj>CT^$o-OLx3P#2@onTfQof<wEqEBgW@Tm?-s79O5Wc$3
zt))Ds5hS6!nms|?cRYP#<KuDdv=p~eo|XMoc(lH)+b%DD(L8@YBpI7k&hAsWIt!ns
zKV*N=-6h}vuW1YYcJGJ9A1r}?xLJ#Y2v#D05%fX+gEJzHVD2(oK>ht&Q7|UL6q%iX
zA(gTnHdmbKtERR;J+ywZofH<z+^+MbtZd`T)t699hO#kL{C>2u)Fvt@Yw^-|#d$x*
zG*;lORgEcDkd=8^d6Ak#aR`oS(x_2ur+<<=2;g}hx_7rte3VN%cBovrMo9N3fIAxg
z@_vgTQE!Ujcjptg4+D4+QLk!g4z^0ILe{TyDdfdCGTS-WHT=$TDOli*64w&t>#D;%
zJuq>z`;RD-|H_2Ftw3u!{xLY}!P`#>A!7iAf7J`#v%npZ<cNt0A}H*y^;?97kRukw
zX6pV9IBJ{ue%dupGuP)dqR!%>-H$PqQ?66GF|QL2VYZMvHa<C=GS|5p`~Ls?NQ9)7
zR!^>2ZJOG?+h3^|MS`*QG<u-xWQkS92^eE76|mw_k?G}quy*ccdNkcFqGLw%$GBGe
zOl}Xl=&Ge=xyau(2J)u^sWvNT4Rb}G5z3kT3=-|qhtE!zq&eWp=T<UYGmJ_m5`|f}
zcd_i*(+%2OBN`tSSDF>Ks1jK`D5CAwuJnP&%Y6JPk^g0>4|H?(di7RIwacPrb!E_@
znq+D+vU}JsyQzefpZzitYVWQJYkjrb7}5nmBxAHUA)ST6udLz>Ui77J{+?p?A|TW^
z*@W)(uVE8X{<f#2a#jEzKt4S)$BAQmfVS?qtG1McHh?<;y`Z>bT_(c@iYgf>y{1kH
z;?Cmnb{4j}z<L%7n$dyyZDTsJ=8Rhc{eB0rMu@|H?PqMYfvR5&^!Z%dK_w+bC0O$c
zq;+Ok#pe3@DYGv(DubmP;Jg_T;0Nim`=6_-)`qVt#WxzBh`W(_N3&H#`n&N;lEb;*
zX#x<S`<{(uaV2F-k0^s-HZ#56-4f)}VB1%}ET67;`J1fqs@}|<mX2RSb_NJ432}h?
z`Z^B(Y>(C>Ywp6Olod#L`&Yj1OR2<%^{uD5pn$b(zJEtM>_t_MYa*UavQZ-Tn|G6%
zqef>qoj`jt{1RQu)OtLseA)XQ4r@aMi=xMB*dH-mHg?c;Y7@|#cd*EJuo9Y1Y!*oU
z-+wdF7n?K`m7ZS>{$V^R^=oUNGc71*h5_jsnfv{n8Y=9BSAO|>Z>HVWt5R1NmM`X;
z<FTDl0#-3)j+Mq-1BBAEnpXy}xYYMLV#;YKx`JBvOTrxknC9HcJ}bMlXX)jd!&8`*
zHqS>$qjNIOz@n&Mvhc+%IZBm|Yh|kpVQ(snqe}6W_u1+q!z8aDNqjO^c6Utn(STf~
zIo-+|={>-LZKe9s{U-Q98MPa^b1WV-g$3Qefy#9e7PtEk<2DQVel1td>=%I8n|{_X
zQO2%H{zR^vih_?kC?Pmitj*?W=!N!e(bt-OcSSLu>z0P|Zke3UX#FY;;MZ$=b-`%y
znrQRQ8u)M0`}Um;+{Fo}F|uJwL@nCky#-iF2o5D2fham^#O3}`ty$V-+S`RGUwVeW
z8OdP?342BL;D&0H=ppt_dDi1I@f<mHPwq>Xs>>omab<7-^?4CdGU3R(=UBEQPJ==F
zsrUJssE|L$>&q^VvZ0ZpI?0ml;#S5LibP%v-7bVvIy=Fu9)p4}3#)jEw91|z!vPsC
z=aDD9ZyI9pI;MgFH{r^}y2N0&nn1N%JKw^eWsOx8Nz<0A?ZQgIi!YhWl|=J%`3So6
z?Uzd^7>cxf`!sRMNUK)Kpl|t~V#74{M-+KbB;1awP1az9j2eg!i@fR%$f})$SSW!U
zf>AL2g$3G+xAGp`k*q5(LC=B^EKH64(E-sa#B9<LTd=r$qd@o$B~SRPTAM{Z`jKwC
zas9*$u20XA)Lwx?;Ty_(4m?Vu*w^Jt+)vp@S{`s6FE!5tnQ;1j_4!XSQHf&s`UR<+
zK4Q<GfvySYibe%)sb<>okS^t^$15<s+qaucfF!?ifXQjp(Se&4JpWnq(DS|y)c!PI
z-lB*83*1ZSBUx2tT2R5ov$7IE+9AYWaPj#XP2&k!=qxpjt=p{{f#yJQd{UyU@ZUOW
zbjj{h0(2Kva+$c^e&+&$bOLiD++C}14|vu3>=<{J%I^>schC00oV{8by1a+laW@0H
z+0Q!SY!=~&gq7RQ)j6iQ3oWa|l}@2XaLErJJ~Bjl;5YaLlvEx?>N5)NgYSR@+NSj{
z&QS;;CTNFC9eL<uV$#MsayN1=oc4=5r@N?F>ITv7nO2@B?|mGa_++zY{UyGpIdmF1
zP<Hd+p8*Sgc!hG(q~N#=7bD+6)t|sEM2Fr7*t3t*(S);vqI*Csg<`;q3ZQ`v`6Ksi
zfjx0`YOyRTUPEQV6n5VBd)|e~iki8Cx~PVvk+>Q&N;94pGJLVJ1XYx#Yi0ha)Vi)w
zQr*wI)stQX;OWMEn!^EDsPfX4JwSg(TW!!`FX9;w#V_(y_UW3JpbN*gbYz$ow|+dV
zi}Dja23Rs8du*zGDhuKc`4o%<row>LDq#D~W9MzrtB3XI{e8Mf@c!5H4r!F}J1azP
zaNRg3#l}}+$oCOm;L^59Xr(u02wM@%)4Qt^dP|kE0(<a(my4Pw=;aC!{S1iQF?+Vr
z6mRiM$MpyXdmU$p5|ZLPC<v+IuS)*<FD(i0<`Z5oQBrTVAkc`DQ6vyWNBUB|JvX3+
zm|FVLjiI4Zc7kai)w5XIYdof+9nvbdV3bfD^#Fo&;|nIvQFjv0M;&=`)=n||o6xe(
z4=-T^As}{@hu@m=9UXH;AuH<c;D}`0X=O%n#7U^N3!WfBRF#`f4-Y}V0|kA~O5o+X
z(^9d(P<q`hcnNUv)0wK{)hQ(iuip`n0Ke9Rq{&nIxml&fowFsi=V5?WVbbV&c!q{8
zb(!<cvmF}i^Y(qFqYplBxEE{#Q6AKU(KK@IXzngP-TB3M-ax}&FQTJ4F-IzBpOcX~
z8OBJ#!<~$@;i=4)2UvXUD?VhXAeMsH;v28hCOGdPI4ltK^vu*zrRw9wxdGAzx@C+n
zBChpTo$z8~$!rKvyU@y6K6vmu<k>w^dKmtWw#4Zmg1#5x4C=xgSukDc?WOo4QlbPV
z`%D&TB5axCA5h8)P@GQ7)LKZtRwo|Uu^B8yBH2d@nnv$sP^OnRTrN7j16!%3I|ed9
zBH)rPbNiv<K|{==+ux;pJB#;DlmiI-eVqKxmw%+X!i~~KLLS%@-K^H%=vj7vZyXsp
z10Dat^MXPSFh$xqbm7umugvDEX%2Qc$k5jY={$eabkwKfvPD*=;3VowF0Oz-fTjMt
z-Csb%`1bh~OPpch+S3Psw%&S*Ptc=*QBB^A{d7(@PD<ZsSa^G^A?lho7Pb^97SZU=
zqd&94+OqYpsp)boF7;?8?Q2Kg=yvl?HBk}zwwb-yQh)8FvkBeVSkW2K=hR0PW4VY@
zW4|g{?a=bF@%wt&xJa8Xi{N3d5l6WKh!rWec#nwQul{$3u8M0OBOO1+xql>^ChW`E
zl82m583D}Xs4RyRmHqoG{~e+U`NI9CRj<lDfa#tq{vR;;x}oyGa}g9$eS-h*w};@q
zDhh63x(C@WCQ~$xi|PFf*3bgax>Z%}Lx$6W6V{}!y$kd>c?co$MFBQrcD6eyGHkqM
zqi9V!19_mdDcgCctq{UFY#Q`XINKGox^$#2ZL*$;jJmb791|$>Q(EUW2(<k*27PJv
zwv0R^?Fi;GosbNazIA{f`uqumJrbs)0P^bOGJLSP&(p~rjW1^|wt>fCwpR%5o?g(>
zqJ3;2-&T3+@!zEIX!1;6p!bX<aKBgW;XNu)IIU_FD8J;tXi}M$5qmY6>ttVA&Q*Bu
zPmi-gWuRY09&IRGrBH7p^2Dq@0l9<PwUq{avyK^^r#-*no_7up6)`hQyLoDP(M9pQ
z-xRsmZMd9b=kbzL$@=B2-{@C4c~2&WF9g}P31*B%QoC}PmJhl=>uj_k(*y;cWNn14
zQ*jaRrfoxsOn9=SPcQSvUHz9eH$bn#BB1sUicNf?MG_4xAi$z#f2K*q^i|U)Ks$}*
zGpqfBGU9O(zt|8z>3i6YV3;kzgHy?mDS7!pnGI}4=Qa&KVTWpHIDVO0C(5W`>A-|9
zjg##^lc%Y^Z+H-r8o!i|2R1swY|nPOdy!+EBJzOEpLHjbvo*Z&gzw<p&i~R8dn)Ag
zPme>eC<UgBHyv<|AQwtD9Rl(+x}Q%bnmYId=1bn&;75nGhPYzRDj0k{QEX|^5@Xg&
z<k>Kacz-JB1iL!$lU=A|C;lv<#O;(M*6>vTsp400<OC<`rGNbEwqMCFoBoNDK}Au)
zbce<KKwe1zwvxDrZgfrR8?;Q}*@l^{2N0T|JjG=t@jr-$yZ%h_lX%W6xkm9MH(yl<
z&FcrRm(RuE6bjNRD#h<3d)`Z7E25JOEV*A8KKn8z<>_ivmyCb`3VMq$!FeL~{THa8
zoSbLxgo)vI{yNb=h@?FpF#8!e97oWPvY#BKZ0M)tQ2lNOmM_n2-9~}4A!E34IMkEV
zOg-f=uI6EXMC+hGjiY#r+TO!Q!^z?TBoP5u?=z74;9oR7EUfwD)-dn1BA4$SBJ8BB
zHje*G7yuR<6=py1w!C{w`6@^zqCS1S#JjBae(EcCGZgi@nd)vBdDt&_V~xaE97&!L
z|7YwmGrirEAW1Y6cR@INX?xcQ`?HAxBu*gtI9fhq#We>eIXOjYi3R;<1E;ZEar|WN
zcWf_M=qf9F{2QtKQ0R1zsQcJ~U5D9%*xL2tZ08Y%D4cm3QdZbeVicL6B9j(vB%?aA
zYjh|?G-Y&}SckpHDzx-DO=Vc?dg>~l_}d_C6)q}#G`5J7u|-*Pm5Ns9jXhCW8?&*H
za1r8gR9-4!F`pE0L6k+grjkc7AB0y&{bQ(4H<CR*=wBqHfRzIB?b07aF*Fs5=+-Jv
zThw)u)G(JMuJ_sZbSrN4hIwz%N3B7}?ssMbMKP;Mkh9XWs-(x{QHdb?<0;@`XB_}y
z8svUW>(t$>g)mOvf2Sv(yZa8AXRvIF5iQg-*%Pe2*YzMmYwP~D%8eV^k#-1xr84t+
z3eh-~)7G8l%Xn>+i4t7lgR{`zw*+gQHSJl0imH|dnbS#x<@=4}jJG8+$BE7F<0SQL
zgNYRajAfm(1t`xBXUb0-<h7cIhgXLS`nndS)J?6fKEqWz)x+V<A<Y+yyKXJP*t8Km
zisp*+trZdI&8;>qT6DhMg6<HqvsXdz-N9IBvKMm)$4yiLEF+J{xxJnYvdJZVpbaI+
ziH(uIA}lp|Yjm!cQ*Qc0ge`Xa#sX0yQ8`+hG<<Yqg>f4-8q&O}SK3GdhK%Q4xx@Kt
zZ`G~ywZr>9oieq!I1wGbe+G5^#hu3kH_cM`PCH_Mj56PoSlaaQ6CC`8iSpn!wuoz_
zE&VE&Ay;;3d$sEE_XP}eQ}vl}tncR>;QWTx$E2g_4HfU+zsQ%II&Yn4ywCa0?nc13
zn&1RIpAY*_gK2_VZ3G9NUfL6CkPi)I!WKNUKO3@R7tQw76}5!i9#%G3^0MiYXoQhD
zhkp#@i=Bz{?-(;4VN?B?daa%vte47H6Mz0ZlLyTht6@7ADtaCwU!hz*wgH-cuNqC+
zI({2vJ$1e|$8QqAbameAt>oftRq8++mI2xUQi7Myo44A(WwlywUrTEm-A@Tp5kTSg
zr^9gpeSWyoA6{8~HR1nps5p5BlG<!0>}I|=ws%~$*+G}b$e5F@?>T8S<3=jOz6Y1K
zf^l*dwe^z1k<CBK)_(59j~1Pg(VkTbIM)Z)3SkI>eGqFhTMBS?aVdYqUM&TeMUhh(
z_S?nX|E%BvBJ1B;64uhe?j|r;o=_*3QdAWF8HS#oa)*Kc7LObdUro#r*9G5ey~yDk
z3<E!3Pi8v{`rq<7xl?%0tgL!k*oI93f?thPoxhMLPx0(N=zk81?U*>WKR@>QgD=q^
z80k$_Sy`GCjqg%N-K<=aQNM+?trhhqzZ-;}zP5a<qV*&?p)989a%T3nRl-JG2c1G5
z?Y?2xllKqmF^!}roNL&`f$N)=ns?6{XTq(P9gfN@&bDI=hRc$6rbph&lA3pzl7Y2U
zcK6fy@#&!+T$TgYJyhGnqQ*n!c&i!bsDACZIUw}c9Q<i86E-X7AeLqlSNQf_CT&+n
z)+ZFN&ADwYoI!sC{a|8P-O(8zM{aJpl+7}RDD>&@91Z<cpx`4)NG_gVCR^TzrG@V6
z2^JQuuO7U(K<x<$+9;OX_uk=`+$vEG|8F^{jF$_2=*}rR*_XvLR>QoW!VvpRhV@2R
zW&v~?L$d%Lv`;jbl;b+q=T`4JUU(gcA#XYDQg~b0iEz)$s=ZBIRMYYCd!UXo)>bD&
z`a2^@h~vdCW0R!QmZcgk5KaHb4_U~4#V^-5$RfBLTUjSp&Kn1G?_CA(Dw5+lR!7iL
z8fvdXe<)5fD(35)luiEj^V!~6o4F^{l<@nzP9OiRmewY{w5HNkkK?VD9>yNRAlikT
z3j`8)rd<@_3VIjN=*cv{XiHXA%|~yVgk?bKn7BVGH%RB8w0Ow+nQKvvO=eivHu9)F
z4BM@tPSGiw_-^?6os09x8}TiLPabC1@uq)zz#s<B`FON<2JA|3*xW0+Epkp@w88)x
zI)6cE>)te)R;4sM%uEZ;g`_oGd$6|mrU}V2gI<`&CjX%~jdi4drYgtTb0AZLe3#DI
zgu0IfXFqNpZ8-v0PoK6*4($%Wece_i$r)P(`vlwNzBhQI7$8i8AJE&h1B7MK4XPzB
zApH}93`&Sk`Ogz%Z}hixe4HZ2JQnM^0+HE=RdnVALlX-n_6yJ}|5O;?Fe!{3UI{i(
z8e{`l*1a+Z!h+0givPXeEN5&rg8nkT-1uIshmWJSQW;Y#ZzaPCxfLCB^p8eVj3S2s
z)>LK9@Fw0%DJnWauT13M*ZEsKIzOp#5L4E2Ey&h)ubnV0qvra{RVkpIhFL;Ra8K)J
z5i-5;q60|9LW&Gm1{WcZYk%xMX{W2!b!XtAviw*;b@9?=zzkyaY<e7M3dZQ_9d%qD
z2AWt_*z>1WJ<>HwYF>RrL?;w_Fe<nTeYwE%Y3sH77dKL|bJeNzueH^^jY%Pclg#+8
z%pnDCp$=OZY(?7HMRDkI?UgaDlTzAm6fN5BSEK9U1jHvs7QEEypI?B(-_Mb8P{YXn
zxvm)QEy60WL3R>Z*03;QN49*ieE?D!Xs52S{l<9ON|z*P#-$H5QQFF6X;G&cyn?Ss
zFlb6Fiq=q^-|9}9h4xuq18E^7Jc&xTTD44N!Hj-mX=m8We=c)3db2--aubou85f^<
z2|B7oMC2oNe+VF6z#*vg+K`c&KoOGHO@5*CHCt(7C~emglNag?TW}xM;f&-@uq!hO
zLs%$1DIjR~9cT*BR2Nc1`}b<dM2Zj|!O;xYpBP^euSCj-w=qJZ%n{>2e3Z!Zt(ypP
z|0#AFj_LPH&>%Y2*!$xx<B?3F)kH+h7^T)orJb2T$x4Y^S_GBr(6>RUh@KJul{*)K
zI!9}NanakU3F(9lDj)0O!1hCH#%=WS%IDQ_o)QF>+T1!GDrNcRl`Hhz3!D@a2+mk7
zss+1EvNy;8B_Lko!IV7oIM`><qd!c){bAJ_*X2PHlJGyr22SiW-t+zCrGY+iAQ}3Q
zYiEfuoXq+2iMFs4!T8*0(fem@R2g~V$Wi&-9R)qI<6VZB(?urmziQ`Tx1G_;zE)hm
zA<%7ZgxtrQhYfpwRf)8sn|Fbg;qUOJU>O#Z+pE6fA2IorY@voH!6{`*D!Y5)6UvNX
zbex6cEAzkV*Z2a(VizynPaEe*BEBP?#prL!5}A(HHW%QD!kQC#T-qjU3>?I3Zf^6W
zv8Z6;uzgPrEmGEof|e+983JRkt`}o(C`~ML-KQYEiqK+GeFeR!<t~<Or^aMoOtGOL
z9d}Ram>a%u`tl!wBTn|deL-*W=1T#qsPbv$h_oRH(Uw{s3d*Qf_MGu>@uKggo@8Ub
z#yo+)nIcC5(2JZbYdju955^y*b=ZKz{){>EOv#38*l9RH>v$b_1dsSb^_T%{oZ=S%
zt{iPCbkQYSDp2ZIV^Gh>`>{9d8WLNJrwfoP2g~G6%zGEjE<gK0{_llG5_R)1)RcjH
zU@UJf?6^h~MEu65u?c2uxtLz0bxYWK1Al^{4_(i0v?@ADnGp-PsSTKt`%P}u5?j$x
zs~g7e0Aefqp;p%6VO-uvS2R=4{|ZX(hLF7MdRoWMzhudOjxrElPv_*-$OtXE7upvO
z7o4Kj)8T*W;I3A$3EwwzlZV*0@DIGlF|$28<2oZ)riOW*kUj*6^U0P{8jug_Z!xX{
zBs67?-=Rm5Xwq*PA{*EhU8Dm{Y2Yq}%1D30&INH1)8zU3V_NYuoRo$?o?#e{*ywya
zR6z`+k8z*Ofj46aKKa77v}#K3P|~w##u&N(2TryO&+Cxx1A4=?Y4PtkFR%=*>r`0?
z-cB#OoCMBXRZ(?viAVoPZDA-|5}6d{^Zaxq&M+-X%49u-_p)4dBcP#-G#w@N^q<1j
z+lZ2B`f4U|(t3U8V`Um}msM2lWft%oZ)R4jmj<{E5$?4VnO%%vhY|_Yr@bT^j2Ifx
z!#c*t7@)kAP?Wo$-d0_x>@p_1(qlBN_@eBrkm3{Mul&IP3Kt$w5S+^!oXb=1Jy^Mx
z?I#I?%N#<jn(YHZ3RbSlb|xLXkIZg8JNZ+0RSbJ1pZn;QwZv9`*tS(&<Fg*KThFN;
z4ys<oy_%nG6$}LyQhZl4cKbRtm;13rLgB$X2qm`+^kY`#;M`b`9rejxI5J9UY+Kzi
zFonrdbTqm2x__X|`ja%q)m+fuP}fHU`K`-<w45U%nE5^55OBFQ0r<lIv*z<4TVnJO
z$s_%B9|YLtpv8Bad-N4WGXbpW4|yJC<8bPxe{e{5h#?vHnxvHf1S{I}2U!4KSu2zb
z3X!;fdxits1nt$uylzs~D9H(TiXr!Z)LhmCWvzG{PI0_9ejqD7$Ix?6bBUz&`V07U
z%sHe@@xoVeN8`T2mjX)CSF}y^g~)`nU3&OUb>r)G*JM%*4>fk3-njeD`dmO9XL<4i
zutUx6=jR4I9~Q=N?b^+eEw;3^8|kO$T||<+YcJK8f2ZH<EO}~~v66nf|Kh?Jtl&#m
zqb|CTGmlH4oKk-+_>^>g3%zP`9+ObgOml{R$uD@V8r)z9TKVF<ikq@=mApcA(K>BK
zGJrC6Y4;>rey-FByD4DFhAPQbG6}PhM4$_(*+NdiB+)7B?KzdmH25A<lj_D>L#v{~
z`|aK_5N!3yGl~QHmk0eLCm^(_f46Z{nEzr-(OT3_?H6>xVbLyx*cSP{b7du3q~PhY
z;BR+qY-w6UclawNh@7-0yrqSli>pXddvU9dFBE*wN|$mpqV>te8Xme>s4cxY6zCB1
zB0~7Nl0GIvYWAPh;%XMa3X*h7Nc(;|4v9S+g(bC6^2P_AhhIiR*SjX`CgKIZPuG_P
z27u)!;9Q`zDJnt*=Os{a4nK=VU_9CULlZJv*7rXL)yIJA)dlnQU&~%dhG}k0-~dKK
zq*CD&O0YXH`3j7Qt?oOayvNhcW{kB;ODd+C|C+aeyG#{Nsj-B3<hm@=QlFFs&P<a&
zI1uGR5DdVDCM=3Hd&&H7jNI6yO#ylF;B`(V{)fxdl}i`h(N3N)`_*WSc=4Gvpqdyy
z-tI7&!XYT)X7yUZ&}OnX$ZPyi_Q8k|=)p8=TH^(l{AIzPLsF)ezlSG?^klPM0oYd`
zyk`~3^c3wVNSf!m@*PFM{yzE5v%d%e29kF9-?d}XHOu!budgdE2v1M3k*=VgD*7=u
z>e3+M)H6R8qkN^}AWG7@|5t-@=>?S6os4xnkN2^3=U3yEEA+<S_5iT#?k^kq&_qT(
zgyN@ACZB(qNSrOhpsH8aO2I)pneNVH4lRJ4yIssfF<0X*6W;za_muFkQK)kDZ;o&3
z^;K&74<ifsYko=AHK8^)dO(G#Z&(!4x_5MT`;YI6uC#)D_8vQ;Nm@r{rjO+>@5^`p
z?pN^AfU#i7<dSYefo=vQHu}9?5=i(kAGt_zJXnH<wb^;BMJgW8onFxRJ`JQ@)If7H
zK@yO#+W)WX5)Q-1#R$le)#)D}Xx*N6CWh`D_}JhN+T$#Fn~`1j+O7<atJqq#I-z=(
zyEIg@qq!x2YZ0*?&`^Y|jMWy{3xHCYdVhmfy~jh^Y6R|t2bLcumyN30f`SYO`Pm3;
z-p?ZKX8KIKwRYVsK=bZK|3Y@bWzW@nD1ti2XUS|OxO^g3vWK-^5jdE^4t@J9{~|0C
ztsV)|fvDzh{0zMlcD6*E(Rq%Io*GEyZx@{Ub^5M%c9`Kv8yIf25Mh=LHto*68AwRh
z?_OG)jupnAu~$HVF+xO{3Afw0VL5y_aPyk!#@cFskj@BKTLJlJ`k90F>bl4BhBD+b
zBD7gs`<cKYNyO3FuaU@|nfsf$wt1zj$dE|SK!AMTjHm@w$8%$^tuNg;Ot=1hkG|{h
zcxj&3_@ka2-V?Mj*`hd>hs$?Q3P&+T^cE;=Q@&^*5F`fTD^_ipmZU&h@J-IE&vVhN
zGk|%Sd?NN&2%MaxNq~05fl6@BI|&)v0VFMGh`Xjd^J|gx(1`(xz73Awp)Wki8@Kpy
zcy(3vk=tR%eyK+;e**pTKB?2a&a$U&zS3qWii-UAC(f1EFEHP0)i^x>4SC6%fwSGt
z&P?h$`&yAq0srmn-xLSpI!CQtLTI)d2Y^3q`|5wCH_3(MNK8O2iNxop00gs#cu3J2
z@pWJpSg8XY{x>mS)+AEH(>DKC3F#zHy*do#o|Zn1yRMPjEBqnvL+)DyKqM4Ya1dF1
z<@;^P9*<v9wE0FaFf2ZuqMmno;l&w6|A_Uhu$MF=A##{y)PFC^x*gs)-?B<nY~C?M
z5|xdGKetQY3fbW}#s&Vd1|m%p`}E+tS1|(iM*T|h>zN%>dGB%B`R)hm8#NNBBr-4B
zWtt+_5O33EmSs8S1AHDNbzkP{H@QPi&ffsW*{6}EElE)A!4rC8+OGRuwIS@0^v&i*
zXJxreozBB&cCj;Rhp7JiNL6XxwJGYG@<!G9I!RCOpim+YvR{aXp>8ui(6ocIZ!tXb
zF#^kfHe03&WSW)h9h$Qkmx*Se2dVxpdh*rNY^4&)TMIL|p6`j!57L#Q4%HVWzc4>I
zf5fqta#(|e2kLZ!irlbj*7h&14{96TA;&F&?_ZTM^0^X!^Mz1l2n{n?rXOOX8JFQ{
zWzz2gGIB(XJyksG@9?~293}CE>(47=uYI|Y&kEbpu=}Sl%;i0WZ?qKdrfJZ6hQ7A>
z%A}#@G4-78gk^#kzZjNZS&Yo0lE2BtsGP_|%&f~O&kP~zGMz7V2Zl)MPxj?SnbPcs
zUGS364SOonF~`#PlmDQ-GEoeKGctZ*TQ60;9(d=Jj@g-z!Df}Tcn8V&XjC@<*?pF6
zxq*N`MPOqoF3r@_JnOVeh_J*@KR;BS1!1m;Ums=$$KL2?{RehN!ft5e0pt@Mne7oy
zQvZ!O_0uO12u0{)#t*UV?knam&Abwke$iCeydsfCZ7)z^v#1Rv*EO1b;WCZ8*Y;0G
zR>ahee0d;;$^#vgTuDvpvc5W<HrL<HrS0s$5it22)!gK+(JhY6lU$O3K-=$%N~^#U
ze@S_T%hIj0{Ygz*%Lb8MEH`ZY?wUDeGphaKB8}r{e&lmronrwHlJ(qwH&#MoY&&}R
ztuKWA>dtFy;if%~iPThIjo+%AJ54E>K5~b$yS1Wm*xJ;Q?aD88BOJ`jL^9#2>Yn~T
zW5nO{5bHmbY!x`xigu#|#0DpQvbLf)O>I&U{cHZKi;v$PGTXE++Q5|qEaMFm7ZMoo
zRG&sDmw71^kBE;kP@%8ppl}<l5*r~;E(Se!@#8*6Iyzr)L&iP&g-r*AY2HFPm7Tb*
z23aW`CYOvto>m+4w`9?A)7<95D>lvf1yP5ATNw=7FZo3KUPS7@P$Qb$<p200r*hlc
z5m#2@?y;5*o2gx$J$0r>#H~fbv1%4;&zH4M*`%)~%=E%TVSvrYXFuM*`O-u`*(a$X
zK7>qOd6moQ+n6z1K+)y^HD8PS<h}T-)<92T9ZhuZi_#W(xM;52`R3ca3`d95+s}UY
zxy|>>xUaQu*0wx!4dwnIdRy$mfaxHL>a!_(r-*{6D|fP8iv=Kxt2wPsX`+>7-0xIs
z$%hXAd`a6z7jp^}fU$&88XmYL^Eua}(ZF-P+hVqq4N03wesIB8#SQc@_W0o?{%?!j
z%ex%X4FjJKF0Bi8NdYD)hdAzbrw~QxMNs<lr0KCvrQIIspK?Cj$bbMUcDF+fS2k!e
z_Jk!DoUpo!xY+-`JV}6J7KS6A-B@QQr&c|GSk1p}c0`1C&)xHQZ~hhEd%Q*X%q@5?
zT~+)kq<k}RAlYu2@$XHkvrw6Gam$<pOGHUhR^tA|%W;SPdJ%Q4GSNmgO~K{H_l=zO
zE_U}HAi>b5Wk{f##Cf;y=qZ4c{C2Q*z$3zEwA1xxWM>o|Pt$2ZK7Ik|q~xs&e7dOU
z{b}Ra;zmvQZ!fiioDi<S6*#ur|3^+k+t!O5^ODtN7f%nP=k9VjTdBxp=ey?JhU#1*
z?Dz6-k>AV`>*(i)6-1$2edI)i_)lo}NrHMRr49*8+DeFSeddntL+09bWcTaqk-zMW
z4mi!Ab7Ueryp;Tv3DKBoV3|L8;Z;aKFSs$RWQ#4iR;t~THy&epoze+4gaH>|E}>x`
z)Qr#CL#dVpC+MFi@0?a`q1iE*=*BPAjo}v`WUE+|Ao2Q+{r}xD81Q!bHvHxAD#PrI
zjJbVgd3N=b5@tk2BnL7d<Dyi(I-!#Zv|6}{7p0FScGU21;4#DQ03p&+?&DHr{pk6!
z%Ppd2R$7nu;PuFq%-*j|-cL&CJs*A2w#p(lwzds~<ZLAuFmeIi9i4*L3!-9R@utJq
z1q5y!=!oSVQiMMG>3TmxGP;^g({_x(Z?n{O3m-2MZCeHk3*y`5{&RH%%d&CW<Dla^
zc%GgU7tV(w59z{m+w*pZ8nL)C%ZcW%0u`5DSpCf>dDrg3I+56dlg1uoLwu?n38up5
zADG5;tw{r`Oi*Ke<MKRUNNMz|B^z|2&CANNPV8?)Cl^)kGK9mE1}@4Q91?b2Yqz-R
z+V|9;?;Qw^6#ThFl^_$pzav-H$c<B8CD%1wqkGT%3y%r97Ev#|1L7R}njwaB@D68c
zZQjN^KH?9QRFX5QD=V&DGpZdC|48;qRKxw2i>}RocbX-;QOB5GnN|UsHn4s-)qPPM
z?S<-96N|z|WT}sL9%iTa$ItAj{Uk>tqfF+rO{>(~R1n3A11-Y-!8eiSP~U$6PB(}0
zin^#RP=@3jcRIcCKiJLqj<?c-XC14IWO5E~H+`}%sH}9$;#lpAr+du5pYBt!Y#jT`
zN$jC_(`N(Lin5G<&*@<cCC}tZ4@fKX#{|jMpLY#r7nm1sJ~!F5;S1cOR!<QP{z8Vx
z6&#W_rZ~S|>E`iq`S?y?#{0s8h!4g^)o*t1iganb`-AY>>2R0jxpem!^%DLIB&4o*
z@=|k^f22@(3S0(EA>lSme<Mtr7`|WaP<tntFwaH>uJIYqak1#QDR2WiNrvOB7Oc4g
z!BPVqzT3Vx>8?L(vY|UA{4|V31~8R73a+it+re3rd#tum@^SCoLPw>!W-Xn!TWT5O
zNlXnM(Oz1}Zl4vqL|2ulCZUv&NkZC)Wc<q)L;F7W)mTJ3jUGSDAjiikL0=FH^Ghg}
zd6%HEnU-(;S^liQ`MA83(@<FzV~4v}!2ZzdgWlw?KeH(m25I4cY++}fqKi~b5LlRJ
zY9TMZ<}Tx*A5UMrU*yl7X_kSD8x$%{i%dmWI7zK*`q56<lR^sO9ow9c!H_u$x=@se
zfYYHYoog&fJ7qBF)7G;hxbW2k_POI-!IcBLaZ-{M_P^HjkWNa}JEZ18g+A=`>=4}<
z{N~xu39^4olXyE*WtwL+Z=VmD_@Oq2fbHWB6E2~@0hL%3!=&K54suDWjmLb>5oxc+
zXnf-HGVnJ`H*^v#6bd6pcntjgldxvXb>=RJjqQB$z_${i+1GDbhJ2(HY*F|zfli?9
z4(M0JXfyZ4=<>Vw_@Y%4{wpEqQ`?IsEWv@afYtb1YLwbXlsR(QCv2MfkKT)SB2C2{
z&HPvB0pS9^ZS2hb`1Z-)I)7Jg1$>Q?%fGW8pF?J13iIjfPKY6emoi%$p6p(9h5Qt3
ztHnd~TI7-8x-!(d?IoA)VWQB$L&CNle|$o>tpMROqr9>1g`K-B&D?(@{pmlv52wiq
z%*v8~8ICX&I~ANPKO3Uk#zBo&_1Vb!<zV<_rjZm`6>n5ay-9M)bfr^(K88NeP&j1z
zb(KS|+|lWevtKLhKg!EY019gjk4TA$iPFQ;ne#&d9DcHcF=9^I?$xd<E+lm=hsEBD
zSLzm;F)OMV9})1mq^J*{cJ9%^ZRK1#nZS)@4o6IJUH{2G;T4SzBb{7evAcd5F383R
z;~nt4&BIy;AHayh)|3s~+oWZCB0FjkSk}iL9Ko~S=bFx<vHm10Qrp#l4bjQq|050!
zASi+myh+rLhUveRjkj}!%&`1+3Mn{2o1UG-dNJ8+J5is2RKd8(pv#FAuGmb6VW@E#
zz=La^#>_#NTdC1P;{oOvdw)BTMyj$unTKtipFS+|^ISlx&rGg>L|-~Ak|{qAT~VO)
zgpGaNQ4C{fm%N|7M!Wr<m*_gknA=;;^T$%h`wzwOGFAyiDT8aob#>w6NKzA!7k?c8
z%Hh0}4e%VSniBeJa{Fe-S9NCdSSN}dP{wCuw66%&zp^9r7FhrR2YT9E$lE_(kj~4s
zLq}<lW0I|K<aC>NpAQ^h7y?UZl9f1cQlE(4_8{Dz4%Tw_xE3vBT@v$j;sT`V|Lryd
z(n#BwN4e|H)BrS1CJ7OWZ0B-*Nw=T5s7dB-HZR}%WvlFxV<SS)dY!WG9wx@iGM>bZ
zXMQyXl!O1BP+6Wca8E|*6^#Bu+v1HYDZ?V)ow<Hi#nzMAAMr$P|MXWkC3(_VDMjzu
zk>L!9F{(>3X0KKgpqFi=^HcPe0Adfnu`_NqfMtS*)dr4r=cdban(CU}xBgM0-7O;}
z-|Lqsqt+#`^Vh+eP)arQqL`1vV?Ky3V*}_^7j(Kn(VzM1TgAsZ;YXa4BAB+ado(X_
zT_JK46{q+0X&$Ei`h0lWPjUYDANY5&OQMH=lM!S1L;aLU9%gk!JH7dHIf*b*eK|xc
z5adZ|+ZbH@7jqc=w&k8WJLVjtRB80^qNgj>JXj;_9@5b3t=MHdl_nV81)>QNG27i0
zyKed|&4YM5SUuuUc?c9xWui{wpqHZxZT^JD(e2+42~+P6wbd?Y*$KcUNIqqwow_aJ
z@9z%`QMC-N>g<duIQxTLgI)59ul|JEzKl<}B_kxMp4i2Jrv651I7cOk^>#PWgf$%z
z#YZa9-r-GB?T@k`&m-g}$dd^=b^{SwQ=v_Z^foh~i(r<MinBV<=f>Y7yrk^L^Gsg$
zRwIq5j$`@I7|n93Rx@?&#Z9gigKA7T7u$hB1Wd*;dh}b-G%jn*0odowD4dY7Y3MQS
zcGCDBp61n4z-clQ(HTL`$0_OT{P`cA_HVvWqIkNElK_{zADIbq4&D9AhLPciu#(F?
zbOLqad*}19M@HdtzzNDRw6Emk;6eFTIgfOy9RBn5<5zEX<6bjEFC8--@3s1eE%W!8
z4{BJ-jRk^k`K~-nQ=svz%-cXDpwCy|`2P(qgR8n_fybUXuN-eYoGaNDa6zF1Q-rTa
zFx+Qe*cfal(=ZPIY$54P+h>I%rE&@uSP#m6yF!xDmQh8Xf4hRQg|DT|?U6f<+9zgy
zCi0|ci~0vVHQvEUDR&Z)G>$l9_+@STQ}9}#Ol_J`Sy;Q{i`iuS6TP&bqU-x-4pNJ?
zJApEj8kTv-u}(jmFJWkkaVm~ETP0+KM)C^TA?QC+2xK;Qmp~m$gf3QsZS?#0F;XXu
zLt*$h_i(kh&)+7;z{ud@O>Ky~R1J19g8o$Zg4f&G;g2!?De-I}tZ~$oeWu(Issme}
zL3el!UOl3*BE5kteBan&!9k!8Bu_h$%8)3qcAT_(hcoZ4J>9+@BkrTj<~303{c7;P
zhs29e(CZpR;@|>w=p_k*h&mpch`IEj8<}m+gKE<{U4ja#yKt<EEt+JA={WIoUCJLF
zs%oL{4Ga)#kx(?WZDknhk4)F`TgQ?Ue4y{oX;j9uJnVE<(cNz#E3GuvcFrHj;8VPK
z@i~ZFUmp=lXr&9zXSND^a_M82^lKa>?{QuxAXi4yQ?k<ZT*i|xVGB%0PVw<Bbv-&R
zS;CN->U~XDWJnr8rqp!GbRBiKN{hL3&bAO37x$@lNdty@c~+NL%Jw}&hTFO|tGk#3
zY%xnGwk&)+OD6F8Z=@y*f>)=95lx?GD=l0z4?BDf-9_ZAR{A~x(zw8R^@V5ERLeT8
z+dV+{r962CAqwy*w=-fMhkbJHy!=}EQa?sl#)5U}eQ!Gz<~>gIsTPZOHMjF=Xaz@g
zBhjCHVG1PjkG&i?lim1$>ba(mdjOYxwz8MN2b@8)hbG&lSBv>1<&m9S@^lC(Oa8hj
z&2)ajU(r41r)0lGDho8DZZwyyVP(V7z!tVT4e-Lx&`z07#Slr#);dX1<R+=}#=MuD
zE9I;)>Qd{?R~c5stMhgl(c5(?hZs(~`Qkvuoz`z^p|ocU#ik~q5@4QIU^&va`aJ9u
z+0eFbxU7*HO&qy%aMG%4Lu1{NAEMwI4p|HcDLTCgQPdjmFKF`n_^zyinSyP`Rd74p
zma~Cs+|@ZU$SnS~XF~6Egvz8mb2)q~B4zuP`v@;y!v&5IhplP>+l(+qyzskrZ!Qp7
zBtv9kWIOX5P8mapr`w~}T24#5Uph~YR3^PO#M?!l<<)%Eu44S6kJ5X*cD4O<TYrG;
zK!}!0+zkZ!+ST4B-R5$~$^|U0=S_oqOP|_?!u#HovrbWxUVPxj9%Fjm50Rvy9Je%?
zT^Kowcc%SS-~XqFCs_U(SWRhV3=7aH*42}B*?!&xg6zW#X*eK9FlLg%^YsLQD?}Ar
ze5<_r9&MYckV_zRS@`EQ@nr$x^9qJ9<y`k}dB{+iujMubHLcwDGr7Xlh6zgHxmXgU
z5|Rjfw)4Z}ihFs>ODXodnb!e9Wn*NwC&{rWupXw7q-q%-|AJOXQuqRcx~3vb7|(~a
zJkT#@Jdb>R6e012wf7es_l4x#l%57`(!aOVx_h;mLI};Gu6=vLt=(4)a&{MVndee>
z8jn6P31v6Kt14gKk?=&GvMHM5{s9A1)biV_tlpujpO%GyB9bPQvpCc^Q2wOwXX)(Q
zX~U&*rM`^niKkrp>tP-;Bx(9@0^m!~TxI{9+6tX>@v7z_(=SC5#YC1^mUCWm&zF~>
z-U=ll2mfy}QNyE)-9I1MD8m}TrvI@i6nZ#krQwJj5SPI}S8mE9aNHu@M&PJO+*rnQ
zg~GsmjUBKWNZ7GRC-UW&GvSowhYBE{-r6I#6bB%HyOEK%&W=PO{q|3+fFNlCtyD?q
zUQF^hW}xw%VOW`Y9DwXFk@v#=>}{0%N8o7#iWXXfjZU+toX(VAXc#?RsKr}!xqAw*
z@KK)vhoOj1VU!nFR_LVYhA{>9OH<_s^=7}j?1=oVOQ-9U4B+Tnrm`wBLO-YlE+KT4
zmMX;$+m~J5zv%<9%Ig+1{lo#(+5j7U*J?8<84J4IB`LFibHrpW&`Bnpc0EGhwfTby
zOz+7@dwXnB*J`Iy+r=@)ZHd;+Y%^jLD(^uQ>?M)EjC%l&@U#%B<8~+it=2`EX^x5n
zx;<AP*Y+b`Q$5eH2M2STfYHAw*uA0M+F`8qzic5_Ck1JU{X~OLkwk`tzCukh+FC7`
z*D2U*N=#al`=K38DhTu>NxP^#_!w79YC8s|kEbiQr>9UfexG(Mi%q*!nD(krz`xTx
zQX5P6OR+6`tw?h@MHos{?{zZxuMRkZA8%eRLmsM9rULcz3to27i_MT{ncvwIwn3DH
zI+_yo43`^O280xgihkPY?^HuhlS9gCcM7#4oF(m;w#VXbrO?yACpyM&m&NC}I*8}{
zi@l(*h;o@1Iib)_{Dos5c=6>5T|N#&S_0IYPW~O0-fpq89l|5WL8@(jyTEk)`T%hU
z{uuTB_`~8wZDzhZizvQUJF4!UK*TJFjPvP{C!mtos~gpB383Dbm%rO?zYIP<?Vzt8
zp=v&rw|)^>`>5M7HniGl`AnBl-ZY5j@v%KYs_lf*9EWlf!{Y5=W`($=6i<DJ8-I9E
zmVZ-8G@jc$FPX%R0>^V|3;XmufmnWJUWJPJdh*ZIO0n4SJeLrZd=VR`q{WiBOJbDQ
zWC-(8sRn0l?oM&>j?JSVN)JD*W7B@N{^Ed_jeSzv*if6k$^cgxo(@41(kJ^;c0=lv
zC#!SMJWYkv>xl^4tSD)J8Rkh6Q+{CO5xJsLUslYm-)wq3G2=78un%rKLGvTeWYAHU
zE~a7AD|xc5ww*jF?vyL&^>?zOfE1m?{gK&MTx`NudjdD+gsd!`((tugz9^27V-gH|
zGRDaX8-&bX>A81n`|Fu?VG{;IROIRupQ0lXs^PJmC4Fg2A9PZ0sxwNO@b<Ms2m!Wp
zlnqoNS}!U82!1@>`Wkn?lhl%g&0-KqJ?*>-!p0(Oeq|K}oVkDM<sJKl@A6N$3Rqe2
zUkr;i>5JeTGWxQ3u|*kR%YO^!+J?$Bj`MYE+lR-<>N26fzLI*cUimP-Q3<CJwe7l!
zhA`I9syr7(#i-JzX&pb->*{_2Ex(yM-Mzox)o>56Krr_9mQJv>tF$LgW_fRl?`Cjb
zrK~lLTWUV5>%}TpbdY<hX>sbZ@y|a3IlyA|>EF#^$ZZiAA0c%3=NhAnny;aZcR44!
z)_w-5?QN2ft8L4v0L35cLla!oLd8F>Z>}lXqTV#i&CTy_ic%ar#Eh(wYC{XIGs<AI
zw7NXQDVfvg9AWHY-8cDs=|`Sz-pJ8e-(OljduOOhhqHO49vR8SoL<No2<`gb73ZyY
z2#$^Y!?PRygj<aN%#ng`hM8dC8IjxxTV$u#mH>)UqlP{-38o8kv{7y^i)fnrGfGcB
z^xF!w=uLH@(MBVjZUzZmxqD!Bb766L6<%F0n!;o6Yq6X6_vThFeVkJHfr<U#u#P={
zzO$=+EZS+qj1#-TRR00D?;mgAApg5HejZthdQOWVw{F}DY|Gr=&w>k!`WFxh!_U%6
z@2LG~8hqi=ws#r?)S7mPJZ8GU#tktfZ*-723IYvme)HK$BC9oP%8P*g(u<ou3;R*@
zn669^NXJE#yqt2H5RSlbYYXkN4F8Dwai>*Yo5Ma@OJXViXVJuY^V3zBWgdeJ>jay+
zbz;-UNFiOVj)?oaHrz#P_|;qSiUXC7vJ}`fZ9NftLL!-1deHSl##_@$^1MV-B^SC6
zZ+a@51oJQQ`6QoDcKDkX_{5Pu^DEO2v$3_;S$l=z+wgZBIAbOZUB{B@UFAzZ?Qz6s
zvHu+C`0v{avF(wcNo&!3+sKxMbYq!UiM7tpuWD{FxRCOD#Ju_WMTtX8{;EC#>Or*F
z$uEUg#$U3rVoU$=aPG!}7sANG#0kjWLp~6dtg3>7e>@a59Lhu9Av3uthE53p4!why
z)IWQuxU<GKn_FyD?_?T0=eki#@#_uu5=CU8*ul-%W(y^4$K0r@OjTv%$Xf<0bZaJG
z+p*W$N<H%DwPeRD@(FkT5p}3{SXxv<y1-43T)6S%fR;`<`o5a_{B7;CZ%QQUm6h5r
zoD>UdFy5lrCuP`7mFZl1lJxBWSY5%m{Li62@0jM6s%>n^ZVmUcj2rh*e0=r5fV;)c
zgSa4uZ4(I-RglV-;hWH(n1zMNY2Ld_p;aq_@~^!nFrtjBS=oFHa<{hE0t~c;Orylx
z!8hdR!wy~;qPWXvuh3jQpg_FGvPm`eXX)*`iO7UHqhGnkwUl9s1KQB;^yNC;kYfQ>
z8&UrEn-B6$bCqa0RJi8(*KETUe=Bwyv0YQ3cqkNZ%RD|x4WWO>wHZGg<(4JB)HGw5
zP+{Y@OWBc1&(hWQE%_EXBVIiFd6sV8Rzfm~R`~j}uFd8O4;-ZY&NK)jQxyAN{!EY(
zzJsAA=*~{Fb4}Q{zDZn?VPkEza}N@4l9lhn=s2jeDhj5^&V#5r9_tJ<M}gY9*!Jc7
z@sN<Ev+LOp+SZMzWVm5?9*5+MTkd61x1Oa<cc^2jXzFhC+#5qisf`TgcHlSSWcZQE
z$dOx#>~~ygm)Or+OQsfhV;J^Ko`@2Qoz_jLn}+E-YeIhn{-ME_NnGEA8ArcC(NqX(
ze&c^j#n2^(vw@vi=5>fl$%HZwv%v;4ZDJKDRd2yXm1G0H?1z5l?!xa;wQAN05oX!R
z$mAaCHdz1iI*oz6YoF;?ZJ%fBB5axCw9VLudTYnw!uJ`>t8+EaTyB3{154kiqf?D;
z{|ItyS3r_0umnT<y79ZF91*hj-&o}}ju<(@%>Qd@bG)fd!GiFSLl6AQ3Z2at2bpHd
zva@7K-!bg+e(#lefpAFXMALMozx#g9@uIcWlzpJNAhSfN%eO5ATWz5H?aL}T_@*-F
zeBf61CjaHLY{+|k>qi=ap}TdwE8F_2wD-HT(v6d2j_c%p7%{3I=?8pv4nT#Cn*x9+
zoV?UkNv44>pdPRY{r$B$<WmI5IIECdduzt=14imsINL$TvBk<}ez<KxWwYPcvoDnq
zi8zIZeA%b_mj2u7%{5o_);a8t*dGBY1xT6XwazG6)kTP;ecXFUZ@X&)j58O%aJSo>
zdhmU#66)}_N$vi*&fC}RDE8aUmg>zRTP0=Gzs2mbDH?uT_NRX{lbP=*B=Ub(0a5QH
zk%2aK>JT={nxi=p7CW5UtEK;`uFhO9G_eV^tCN`|xoi$q`%Ej2VMKj@{jG6N<@$-C
zIH%;!W4z1d_jU)@3tpo34E{Gxn2QP)dzg?CQw7S;jB{jHan}lDjU^jzci}-1(nRkA
z?5{4s4GP*V!v?V%@=HaOkKE|aLIt{{fwe)umR4m3{yJHea<)xH!gFa_aQG`{V$+tR
zCj>gsYqfsO10edeGVaxwo-S^_lCK`SIy~+SI((gTxUb)Xk<N4vY?ClGNE_%3T;@^Y
za$K?^BxlalcNb5XnEjJxDkb(C#dSa0$;;l!%H{G_@zD)8M78`Mj?OZmsrT*U+vpx8
z%|@$qBQ=l`K~NEpZhj~oO0y9XN=OLOpeO=LNZ06+4h6{#q?L^xFt%s^=goPsz1WML
zbMEWDuj~8yboz6>AAUV_3eQl1YKW2@`Xj2YmTWuC53NPPBhllH#i(-qhSINJ(aQk;
z=^iGe+TineC3?=lcy1+~w-AZ|(FE=8UjUv@+`b4_C3F)LQ%<eRw>KG@f|{+aV3xc!
zj&)qv8IgJTjPe6y2D|c?^Y{}n!TICpNHRC9gJA=KvShqRP2C;3kIA@KD~&UCR483l
zEyjyEzNLpzO71aTqFbr8g&ZSGpf>a4W@HfTtJc4Q8@DuxuYX85U6XTec(AS?k#na!
z@YOL0q%5|N6NHgpA!~Nqzt+|tb}%n}x2)gmKOMiN8li7rLvj{Sx{A@$egRQkcp37l
zl5jIKyLUc1)28tgi@K7}OgwMv`&AphcT-7gV-I;X&+fv{5TYu=!=--1Mr({Uq_Q5%
zZ%$KdTUWX<%fs&bx}xQ|HGjO-Jpd#$Kzg*SC$%Yjt+?IQ>L_50TcHd9z&Rh50K$2{
zBy@wjTBcb?84TBpwqR8dnqmGQPvXY7RK6*XS5EfLQVM-21eiDO0Z<A8bRj&}AylW>
z-urlS+@+c0PN$<l_Z`IT!mi%X#T6K}>(HXBV<teb>zukayvq?fMB{VPl%tpztSoYV
z{_Vew5YeMUyKCFbb)%#43TtRlt8~Q84X>`Fynk8KVW)luOuuc6&4QK{Z#VO(*{X_f
z=t7{|X=w`L3}g+A$JxpEseGBl<Q=j%-ads<``3ohro$|JyQLJU!(f&a2gCZ@>!Csl
zGwbs|`(4vAIL3?VpGV^?ie#8Y`7O5lyEw_YK*Z#3A$mikyglfp=EGb4UDOM|^<%rU
zT-1`0^wEImh|B-pOzBMDHUcRgpJWN%m3Gv)lB8fT*0tM<>7|-Sc^FEZcdz^*CmVb9
zXz8iUn+~^NDXGWzttl6?xt@Gy`3YV}s4kaT5~t!$bsJfFewOsy@=^dvownMrt3D&f
zDS?t1=zch{2=&C?PtB~o={-r-WA~}!zvNQ9W&*zuGo^xp%uVJG-`fUZZM*!%S}uPS
zq-{p;CQD9K9e;n}g1(6oZg7hE5}~fyhqaO&nu?AdmhgLqLJ!n3lv3ocvB!(pAUxPg
z0uUqP<6qOpJMkh3%+Ftke)dN_aVBk!F!{Zd!IP;6Jf?inVmHdx$R^i{DM?*sg6W^t
z2=<Z43S6?@(LYG=h@Lt#37vG|uV~x#k)%dbjs(8bg(S~7j?$l`r7pwUaUHJgYQ1Dy
zCKs}#2*L9f!Su5Qp4&oVV!3eI2ZEFYO;E@W!fQBj+=(eI;X+eJNn?7BS9wk9<DtF$
z;y4G0DJdDmpP=>SrL;6h3jJN4IS>ay5K`M7D$UdkQ|5|nnU9l;0etkxqwM+FgQKbn
zG+9Q`dzE*iUtf=4)T<0#290GNrh=Uvr?l=7d}F~PeTk^CvT>nnf!Asg1|8U_x?7LB
z;r;f(NV#sw%Q7N@`6p&AKPc6U{Z{e10BzN3DrP#j+jN?6V`8&!$Xbu}m>4IT6l1pr
zW_2$_F*}%CukDzIbz_At?GA7J#kn*U3gJZ`&t{{`E2k3hblh%q>h5tMniu@05sk8r
znUBXeI|NS%9L*D%$JKg|h;i=OD3Nhh+|kR{?x@HzuW;sK2FPB@KR&`gsz-joK=nII
zs+RmFN=7$FnL{LpUobf-l|6l`g7(|u)_Y!}tu2i`_uROt{m1$S`Ow`p+K)SQscUP>
zDtAM}<Cq$VaT_ii9#$Q_tdwM1$9=uHg^G_l9$Auw%x`6J(|5blI%HVmfFD0Ns(~c_
zF&7@0e27UFMRp$E3E1IzN5Vf7i7;v52KcIHgLuq?wn#B@|5sO|%TDFnFlggDc5ryS
zy~AuZOY6Dr^tp0)*DA(fDdI_lE#nl~OCq_Y%E}d*7PtYec+AWphb3_00IRG8U~UUt
zNPGtQvc8PmB^ABo{ASARLsdArUC9qgTL(z+?o(EGd2)4rB6-9$k1(2E^G(;rtk+}2
zs2AJFfH9bjGFHLC0*EbWIHT-#f%<(P8A*6t9O5vr!$7VnOs_EkhS0jC+I0R%u%O9~
zV@!&doWP0iP%2yL7bG$~IXwdbFsJF~wLqzwgh!*m*D1vWy)|4NhzUs>0*vxD$Rs*4
z*ul;kqX4?TjXYAvwZE@d!(=Ow9n`ZtCB(=+wUaW!6b$LZY)5<VX=0ZSxio`BiA&32
z`=Y({9fJZincZ4!Vylr<*4qy2%~#bn=mC%^W|CMcQ+w|k%OH!yoog<+FV@Khg>cM;
z<|HfOTKSYC-}h`6a}SSSgoqqQQ*EejJ7l7hI$2G3h-vTmQzB5K1$)bcE=0nz_g|WA
zTYo;xm=&DsZGy$kY`Kpp+C#Z3iCpXwuPY@o=Pww7@D+qYrVIn2iYJ}6A@@H;#4XBL
ztCK|uxyJBOllzJIaMJZrN&7dXUC6}&Yckw#nj!GwOe#}k4t0!-uW>}x^2c>BX06?l
ze9ZI9(<9fq=w=;TFeW&8D@U+ZP&Q(|QA~8V1K&HpX8(F~Abjt<*Z)xQiT}AVQ1i5h
zM9!05<46^)J$?I-|6z|Z`D1cAn#7M7EM9|FuI#<EU^@2ZjRo#0x)KqCgmwt}FAC(O
z$mj=AdTOYe#vj#nAq4J<aBC&VIqz}&_1kZCtM-zA*_CN-fXcrs@Mf~E(VK7&tEtr$
zvupHTQ6_=m!#nNz4JlQ676hoTfhi5d*7v5{(9ECb2mFKz;O2DXM%fnXq3)Ksv(d9}
zFTHBx0!R;>g5yg8{+k-5gWFm+-tz5IZ6JXWmyXt-nxR)i09i}{@*j05-=0~Dxe_8x
z6SHYZB)dYV0pu|I^Ae0apCh@2Bf2w)bP{->F?F?@3WKj&9>XkN5o!IM$F<3p5V9su
zY1?v3>l-)Yz%X!3W{9)2OI#6odPwSx=#<jam6fi7oT_nFVRSb|=iDKYxvWn?Kp_Da
z+ykq)Kr=nWx_aTB+{P^@8IM8logLKRW!DjM8X8H25m9$Lg!}aax31Oqa9W9rUoAMY
z=M7q+yiEU0Qk01~$&+yE_6@|tsJtB3<r8$JI;HYvUpBlC+*BPZb~Lw*;Bq@lx@vaZ
zY+TB`YTVx#N~@;+5|Ah=_@~1jf-peOh(`K@k8bZhOAiVhs^&~adVCSxfXdz;1-y&A
zgL)oP<l)}^BEYSmwGX*#CrEE;pS-m?7@_M=%(otN?O8Z@QICYHUWcPn&x0eap@b-t
z7E5I&y~+>D<Yx<v5Us<SNSvl75xGxOO9dEfyC26vcCLDtD<&45hlbGWtdx0l#3{T<
zn4)(eSJF!h-yjwHus{TR+tX57NQ`GNtp29f5M(o*(kx08ks+&MtbIcGLIH_6=+|)^
zFY6C#_<i_((-HwN(`zhMNv1COlZ3K}(G=Jk@ac@kwM?&0X)}n`4evlTnXBl@-6M9W
z#f7b#^jAx$_{+=A5Md2o`Y9rVO`iua!a7ALPAvqCTn04sy=bI8tRt$@<^~14(?5zj
z5X1%;zbZ%8asFLQzlNJqXvBaVJj}F&!}G%Pq>eickpx>@u_K=W9DpI%V0c8`>!M%=
zq?Hs7rmO$(wps}q-hcQMeFo^e7h;MN{2As)eN}l*6s_7^V|u>Ktfjy5uUk1PH+xyk
znr+Rnhd*)2@rCj}8qM-RgKGV_UPiH@AJBZ&*>O4OzVAYquQu|SEk>L-OJ=UL69>Z{
zg2o5#i@`l|8|gR&^N#<EtGE1Iyi$|$t~GLq)#rk!<q7BL51ynp7L`%ldqs{yG_Yqu
zRVW7$!+f!aN&(3b9r_;|7zr;9Bx}o#Nvnc^qUx##N}Vnpu7C!<mElJ3Qc8h^X$auj
zHJ?M#Cpi--@9NLBpqJtg{K17`CMMxGu>?_f@G(LCn(z3GMBzO?{rN$)W4VCT=vhQ-
zzR*>2QgQPCrV=HWgy>7;%~OClOpdwvWzE_FTfs~BH~x#cW9*S0bsZs6GP>xQk`lEq
zOQhMqKkE?uAv4?C(ai$Y6*JC2sUn^{#|pYN%U9wH<_g@5pHh~!A)_5F0$*`AIrgKY
z10nzx4^F)yM9b7>-G@)9eJ$1jhF6nkO|$%3@V1O6OS?>8I04rVw;G83UXj9Fzl-4~
zWyEXkYF`k$!vHFlarq&0TmH3#%{qflo<Kh6#Z9%#h93u<MbduU@g|y@wjx|_2K#Tn
z=RXzeN-IqMujyx~js=VPro9`N-U%Ll2s#v*F<PgXF*1}+<S>*J?)u*aDO@1)CLArN
zMZUDZN5n<k*dRoC2`t&hEkF)cqSZsdMa~%fzAdw}#+Xl-;{&y86&(Dlqt4&i_|Hvb
zEjUxJh{*$|^DVz-FgW(5_g&n}h=^EC`^EYE&Hc1Qru4F&T$?uE-R~v#MQK~4wwzmg
ziE>Jp=N6UJKT>KYC;C37DUWa-r?MbBlGeSu_^lB}v@8e_*gQ@)n`akz1M<%FB3D&~
zOTJ%&Q~%Y=kwFwxmKy5lSb!e{*l4G^Rd-5rjJ;x1SQ%Z_2E86<F7C*W3p<0uj<p^j
zYchTs*_wVBCMA)E9{2HQf0z5E{}ge2CCwfHH|bZz-TXp*SG}phLugcJ)Wt0&C!!W!
z;i6QIDOTIYRN-FlJt_I{iI8D!=ub<E44T3qCnvMNpueg=Z*;Kunx`;6f7)#Upg`G6
zsnBZ1ItK8n#6;2TK#zE0w1E$UG}EbquUceoN^Rp=taV&Y12*-ztA<vRUzKp1#e?2<
zpS1`wXbSO%M#k{)aTH*!1`P`-yYD6N_@KKYBKDqYq)l|+c*GFb2T0HKgLiklth~($
z_~%noyaEL-uGth5Z@`Ebw}=FD_+<rgmlE(mGc)i?l|Y<HBQ(L*&a#Ln41rGD-FknS
z!l1BJ&)x#+#UU%(-w4i1H$HD_sr;A=jrJunnAgUz2Y?LcL~o?Z?WhTsJZDa%3E)Nu
zp@dc-XXN;ToY8RHxac@yw$1GdNr4sdl~c7G-%FSls3vE^Mi+E1Y!GY*9EEDduV9a4
z>rX_62K5(biRo|tiQ_w4bGU6SN()jtUNlNgLDuPYUd|8~vDt;5rbMG&`B-`y9<V_o
z#F;j9ybN|7rFl%SVf?|XS}fJSllr3iLCem2+d@hOCaTdqw?;(}D-sSnbf7;520x0v
zNnZB~%%bt@-+A(<{x6MVOI4tP4Y3-BgQ8#C3*UE->Mxi=<2`P7k??d*dDJyIZ9lHP
zhp?ZWCm$JGcGMCpoQRL-f4l8xe;;`ALec<vyGznn;$sEr1GnonR(a1{#=;*mZEAk8
z46Oz!zQq3~E-pg!QARl5oK?(VJS6#z-EF|Ta_zwg!>`21;_3`_>&M+%MD4EaA65=_
z{;`j8uU3r)_D-$zdO~C4@J<QA#8(0_m_O(Et=39;ojwP1zdh6j+`}(yQ*yI>zn@z3
z4Fv}Lwnudv#8hQu9X$AmB>@<0v3-6c#xOH-hST7nkkFG`ak_Hsb{%3Egg<u*=i7-Q
z7S&V*&suG98ple^|F#LVXG>$f|CBmmvB3IwkHr-|BL?@wscP}w#q3K<L5l*)Ds>v3
z$&)S+)fH18eDZj82-f-WCFM2qWYp_$q}W^Ci*BmL{QB)R^yFwEun&l5c?rEc^`{+`
zZ<3dgBS1h(^YMIB?n@d#=&xTKYxlYb!h%cZDe~$X^F8Q8f*q-t;=bqWPQM4LiBiKz
z4W*|}pCQk?X#DMCxTq))6o+Qf9;wnP91H;5KR^k6jpbwnDAI>ahA7f8Q~jUshaLGC
z!0XN}C^`}$&*v)uY2z2zm7<Xm4voGV1~Rn0XWrN(l6`hUFAE)@0K=zdK{&4A2<j>V
zgAA^M<DIpfB`VrpP}JT*nH`nB6&@rb;@MQxX&wbe#Qv)D;EJ_OxV|PveRTIyx*HNK
zNz5^7eeu12T&DV7NO&n_Rf6>haDiomM7RA#Wz}d^JdfTnIl(h`Czv=9nWW#JPJ(!<
zm@v7$8>p{^M8)gWdc%oYWu(~h$i);bSLDkoB1t&0AL`t-XB%Ua;Rvp}Jx@(64$)Vl
zpb8K~7SqrIk_&+D1R9sxNJjnIVQUJifnjPcGLTjb=Nt}}aj$gPwZMRnEZPGgc56nA
zRm&m~%!#jVN##A{;Z~=QyWYI#545Ev3l&YEDI`dDGYwsr&HSB>z(m4N{}Q5vGR+;j
z%p4LMe$6^$Bsb^8wR<X5TzoI}Nx<Aq%P+Q-uGx=o`|ojgOyfHPT=K~Zh3Vk*QzO?Y
zgQWbl+-BNzEv_L}E+Qp6B1VGej6U$waH+9e8!;#8VQq)VM})9GIc4%Ur!Kzigc4pd
z6)i92<TxHAwE`3vxbo>AKe3xk=*S2DU+@~C)!{^}x4D*+%*U=dow)kQNG*W%7}W#V
z%hjiY;{>u5v6y2=(UZw>pyuZK7eWmaZWC2b9&QFm@O-BXVCSHsAeIY9_y^Fl*MPfH
znb%eOLy}a&mk3@@hM}I02E{L-4HYz^DYOR%7nQEt<uP}7P>=i;yDyzN8qQm7*}FOR
zeydHx{{3?Q?+)y(;i<RSS#XTn$4l3U>$BCpD_=6Y{l#JBW<^;{QcCnbTkn%>g<5I!
zox7utm@#^`>FJAeR((-wsf=syzB)Bg9O(lOUPL@dP@4L9*B)1`Boj&g_QW)&b`~d+
zC3AECyRE<>32st7(->x)6SjC;pKfr8H$>v#Wa=&r&um?x$NyY7glEJz;gL2s+9tme
z#F34~rJTBlmR0lQM~R$Mfg#pn*$Y==-mwp*$d_}Sys<w|=KNU+En&5{CS~}0eO+Da
z#Kn3wm0&$oxo<uiSePG95P9?v(B*lqn@*7n(_jmC+xjY5Q@jwL6ij|}xho~vbR^XT
zPI0Cr^FuniRoW~W_0Qq(%AB8Cn6`9#2~kp^oOC?}urO`NH^Ah!JieR1OfKXN!83k;
z{ING7DiH=lpcRQk0N5ZSx4|G8OP%}j`LmTO=x>(`F3Gnn>O+?q*C(qj_MMQS`NTs=
z(t0SdxZr<*x%5l#esVm^U%Csrx)Q#)DE@sF`+*a}5kdfSMzt!|s64EU_640G&Hh7;
zAC_L0txfm(0Kk#KE2JN@*v)p{`A8hlx0`JyYpyxTY42@bkz+kCm?6f&=*!Ck>xpjK
z2um(q;$8tr-tM`K!nXZz8iATs?~gKCO-H1OtMA6+>K5U_=qEj1<PIWAyzw2ToD?+z
zi()H|jla26E*LRGg1E!~@Zb&qoA?jyZ?IpG^F!0(UutAKY0HAZcX<@V9#6B|0w*5<
z4_|(6S<SBkYxnac8@-!LtspsYF86-pF$NK&lJVkdziNNYKBo-`Wm^emw>#3;qS{^;
zrRdOl>pXY^yue+EMXqcg7u(-iL&dm%*K>C?>U*G<z>+Tm=n>Z-5>$KI0EipoKgNo$
zpyrlc3JzD@T7uo3tJ(~FcwLpJputCj_ii)7(fmBd#9ttdiqA&~!^?B0eb9NIi_%NE
z$dT=Y3OIPX^9LzNnZ}HJ(@W9tD=uK2fu`g5+FzYIKNE8~ZFYxzDmnjYSHgbj`<<eC
zY74U09$gfG-*KXIlQRMPipM5loX`9TfFApDPiMs_w8A+eeDS;X#XnTpMU8P0YWUoK
zpLo?9|K_n+V+Z?`K<gO*#~1c?i;njb;%fc${of$|--^;{TM8QjrI*9M)qbl7OElE<
z+Iuc)(2Y!Jt2o{jBQzm}FhxNz;<tV-zUh&e)NpjznW(?I{ZZ8U^||h+k7cN)$_jIZ
z!qW;6k%;@-^pRAGk26mk$j2Dn8`4g4RCmJ~$Y8P8713jwkV-FsXusOUkae<LMho-2
z1~QME@Qn><?3o{>^l7T{Y3zWfs+%?WgXl)rH!n}#ouim5$6}kYG*_ecmn0-%0(Ohy
zT}*8ZkjeZ4u8gzdED{_-lZ`RP@N&v4O>ZU$%;TJHv{(oVF-L9)qPJ01@-NqdJLB!_
z4u~gPE(*IZf+I{ZSi3Wg&mc`q7tytFh;)`tHqOnw+l8tIx?ffAFt<uR6S^v2X%K3`
zQ|$^TxbcE1)VtHV1{Q9}DY<_vAsKY-Rk@bmIJ#i@am8ls9!%TcTm(7#{S5wG_q+WW
zHz0YXjT0?xr&C;Jj|RKlzq&s>{%4w+8`dPEe{}jR^p^F7_vn(Cq_5p51XG#iBmN@r
z1$XP-pF@s(Ok90#>Kj&GRd~#PYSXMg*W3_87*2GE^@NI-I|@QSQoB^~<<YAyJe!HX
zsxddE3RnVtxJpNFOlP024)=Q%^fm}|!)o$0G<%;ERHQ?(MAiP)B;&wH>iTgWizVJz
z9qLs6$H43OW2;0xqDAjTNUHIUz7~1_Ti&aLXRzbk=haB7;W?I`5VG%{C+lxsjPSN~
zOMEbExLJ~>B?^YBotD-0Jsp*-v$;p&$B~b%%p58<QgwJU7620j#v}otYsxacYXra>
z%4dZRlg2Hpya@@aeXfO~#X9!*o5;=>#qIo%ZL}k(8As;))w%`=zL8OldQLNa9e^w1
z+Va$w8elm(+{6xox0+mt*>ir|5zCp$`wkXJ>B>Fi*Qe+7>+>gDdp~>qio4gmcgtEU
z^Bj~KQpPi2HAc)=?^vJVPm_{K4bGP8rUiZjxd?q%vO0yEQ&ULId)V)1phI)Si_KVQ
zmc_4A3e__Bo2&DrSIwr=%|PI*#^oxX%fZS|m=0LJI`sY-<?K+4PS4Y`I&D3??n)66
z*P&CwHdLIL!z}ZFh@;7GS|cR^9%>$`4Lwff)O5qM;D#FcmvL8CiE=VDi;PR3KR>H@
zhZN@|OZk`9;Oef?AGZ*EG*&$L9L+_-R2MF_N=1T$^)nZLA2h6C%K;UBK-}=TmC^@K
z`fpN?&pTwuHh#%pckaif)k+{a@(N1nyFqvF-yXGrV>c7?_`#19JsC|fYviiKhVN(K
z`gFuZw8~VJ)AGNp!ABxJ%HkgP9_?g_fBP9|%CBHk*95=O@{W4r`1$7VhIS=_y|-@<
z+qn2lDQt8wumYPM))hnm7sx1JLXF4n1{K+1Sl6V3r8PqGA?qr`J=;t($8#0a?_ftq
zMx+6k1RmXaMdsKONULa{qikJ#%X7XQ-x70o8B0!aLQC?q@OWb|g~*pE{)0+DOOVS2
z^k*$u`vhg(V?!Y%#X&~Y=5eft&F0p|oKo>e(*HzxHsvEF9!?bR=N)W8#VrkKsu$V|
zfo+3KT;C^?9DR_VTm9lVEt7}KKc0PAcZc`W4w<GZG|K|%ZxN63Zhigy`niCKLI2o!
z&9uQBPt+|(z$4$97!Rvv$%>_FvX^<XBR(}$2l9)z!xnDsh93v_{FhMx^Qezg4s)=x
zq@BN&fvD1@{FKZ;$OO-fDVoAjO!zmrtrDx=^!M}oEic&HRqEUkNuO}OBj3B$D$Uk=
z9r?WN#6XIaoc8v|w>KJzx}uHRk<We3gTvPpeL{+>&Br}PVDxS|g@Cc%oJ~#`DpSwC
zx+OyLGvax~|7;Dd&t^+K!!~O7&63+{eeI2Gh(KTFt(;0nZs#PNZE##fkx*Ac*P#+t
zI^#EsvsmWzDip)jy8`HY?V|A7sXeRa^}#VI)v@ubAbAEqr8Z7ih)J8Z{2b$Pl5&Dy
z=7@2V4GZi_q_9oMYQ+Pc;VCoQXw#knA!E|4NpfB6YkTJDK}wUSzqDdIyAF?`Zh)yD
zoGQCrEa!bnC#Mqo*h%util+Rrh+3|nqo`C&Xauh1*}`>Tpb=W)MKI+2kkjJ90VdzF
z{|KumO5)Yxa<BdRPzG^9*M541Y3B1x`HV-_3H_(4oMcZ3A@HN&kJ?f+5`Bha&FI7B
zSQq0RbvK3`w%9w<Q}#EC2VV$}nu*;OS@3;^iFUzfhkZ@EMCChBQ@7Rt)8>N<uR-5+
z2*O~KY*lcEXv&%ptH6Q_i^2<I>ZLF3vCh%+TN3n+=2bn6d{tsyldXrG_vfWrkF^QH
zio7-@`+w#L!tw)l5xf80_YBDl5eNY;B{6Soky<7+NUkbo`W~ho(2Xjldf(H-K`%wT
zuCV8;j1ZyIfO1@h8?Wm+6AM@2BITpaGhSa9-l!HFnu@|@Sc@np@ztt4GltOK_3l$&
zk^W$IJ5&8$s<hO3^-&F+g|(W~_OUGI=UQR)JC7^mVOUdoGew%hkv_KZKkG=!c2QAA
zBlD#Cu0-;aiS}-x{r2F##p|=nV7p?925#9Mrdq_#4@ykTP27Mt)V3xcx<UDl{J+UZ
zvc;s@n)U^*r`=X8gIA4th<yaoFA*#)DJk}I{f@j_q`eu69<tB$&60Yfha3u}k611(
z673u&6m><u-gjV*WNb{atcg2sU)%pV8XQvORcZ9kZ>~`$`s35!I$|H2$7iK@Yj=f4
zlPt*`LKL$iCmkj}bR4YpW!sO$pvT6?GC?=}5<tbXa%EP<y&))_EQ|P{YzB^3f0-xV
zi%w~AJr-z)sdx_+>OLic#XR2TA}Nnfc>|@L61Ij6Y;7uf8MXSzZW~YkYLVzWMd)=z
ztWtjbaH4W|LL>sxNBl%FJ_cZ}dxc6>+adcK3AcqYmBe9Z0CJz@d*c}G+>yLSR>M<s
zEfVqTc!uFuwNNH50G;VA<Al-un#xCq!CW3Dz@`Lp;LKsbI@toPjuVX11I0AyU@iB2
z&>``?%Rc|<naRj6MxfF&{R&eK9@F}opMUyUZSFr=zHoJiW04OK>2fq@)4A5mU3*o}
zWJ9)!HzWa(b1K6!9SPhL8oxkUe5{dgJ3-iSz)Cc5E-0tdx7w4$0B-?*V-FEbcpME^
z5#4<Is)6tHuPBC?e7+tk>|VGo7#ikt&jo9<vO++5KEuSM@xX?;&Dt?B_xoy*B~(aS
znf<_O<!{d$zeHZ-tWn(f?bVti&+^6*MR;qy*y`&^DhS_fk2Y4bBLA7Dge2`mKl4ol
zA6$e6tC!)IJy|hXO0M=bw!VVw7Syp6pzBXAx3W_|d8jY|TA*J?Wd$<ee+nhNc$j)K
zdq4p<fsXHGj(Fbu;z=qA2TtFTG>G9c@y1%sh~G9+jse;~dxe<g4ds3ys*R=s!F66E
zP0t~jp~){~CQe6hYN|k0QRQ5m=FXsw@kGC|2SBcsA)7wZ<Am36BKM;AtOhXW)&{ZB
z_A>0J^P6ShBdjgy(|w5pwti9Eg|`(yTa?(Euz6&EtY_+xMv~H6zvoO!fo8l^9Ff~T
zZFOiGlRx&s6Q^<HyM3vH6w-xw&X|tMn=QMo>Mtq!X<|K$7C*m0<60r$2k7@Fu$X)Y
zp{<ZloKl=is<iGy%U4}rKW`mR_VC;2{jjHzEPt@xs-%{a|MEjfmyk*F+}fzsalfQr
z!g|xcrRH@vx7BP_aS)fX$?2dc<v2?~U}BntxqV*5R~pUL#z7nWtzgojDz>}m%4^a?
zd{N_rdHc^Rv`Jcby8T7K9YqmICp=%pR>`bE#I2r-fZ;w+k1?m;R?D-S8gu+pD?N2l
z;X1Zsb_+or;Mp)S!$Ci-BVygt*k0uw+W#WbZFrj8f1QIHi<W*oXo{uynD5KgD^F22
zF_LGyz%&|%r8kdZ{%UQ7bC=f$iNxE+qV!Z7#hMLwXb+0hObQ9BY@a~x)lApdS=HO^
z@l5vC#e2phn(M{5{>;mV`xU{x1$PCrT_v@AtG+i^g?vE|&ayB;4z?1=hF)BTd0r!Y
zWEB^cM;d-99q*~mD~nx}J-U8+abWhGegl>t-|AH9BKCH)fha~}mYJle`_-X`+_w!h
z0d@Hp$qe`l9sEKabkvVUz<VMclS&@srMx#s9I?2m3XM)??VIAk&SSZ{OR~`c2$|a~
zb3cG|a_((pazAvLwj(;EHv}a({zb%Al=TnoE2zX?t#{6|(yL7r8qZebDI4^Icwrp>
zK_V===hUVH68GGLtHt7^8I|i`IEVN<d0e0&8`;RA!GWg_#G?3Jv00tH-&A(r;Y^sZ
z%$T%d=aG#kSl0a_$Tfx_n0m3=(t$+u(Ucd(krm>p<qnl8(F5}LK0jldfFIQL(cyH|
zC3wixKi_+r_4pOly0`Gs)L5SBep+eStj&9{5LhY=)%2Lw&|ru>=)pV9e~WSyqfcZL
zz5SKnX}`4ZLqyq)tGo(ckrq{Qn~ZbYJ9-fmyZkqR(1`s6Y*NCaJ+=+$g&+U@xKXdR
zM*eUQY&IQ*d%W}8yXJ@(9KL#uHMbbyd2qS{4`2K0;I)7AkzU_y!fDnIpF4@}*_xIW
z#YARlM4w_^{VulZoxD=7PjT7_J)r06Um!H{4(1Jx>)q19#foPBvgO9!w^5okTvu@y
zfk1$$bxjbL>#(N5&#Kx-sc+RqtzncJtC`=qnn8wMZLrG}R{v*vW1`%L*Qkl44(kh5
z5uS=4ic~?;D>!W(B;7YKr!Qx3>FO&`&2sNz@F$)+e^Bg|PjJ+yQ27&dn~`!bBVZY%
zxBji}w?$5JlL`nu$G$c*D-`h_yP7wcnF)OzpKya~U3tK9@0r})^YOK$uST7@%<GW#
zke3hBnDnAmD;4KSr8BR}GLgo`U%ksgBf@p=T^O<b;j7mb7hY741N~+H^ss*<q8enU
zB*--!O^=Dhq`^!@!}PlQ74qM9*VN{j%enQGBmXP7M-VEAar*0h*2@%QyW*^B91Q;7
zs4V_{&b`l3@Xcg1F5%qjuz0reYrp<zAP=zVc}%fD2i5Bq?zU92qfr95B1`a3TKdiL
zH6Ew`${HiNW26D^IhEON*%>f}PZvO$aCiNBq(suWfgLh1Zf^0Sj_2FBTUieOB|e>E
z`wEL-cQ(>@M8Krnuy&jrc~4uxOwdTN*PH7tIvrk)B)IZ$*K>5}``Ozs>e9;22fR#P
zZ8qv?`Xf6}cNtHA)mN5=5ng?($q&4>y`LASL?mF?5wh2C8ZQq95?McrU!&&ggWv#j
zSu56`gpcLg*c$h1GbglH5^PnH_Wo!Jw)jUxvwvW%<{#{yDPsg(yFbgOptz7&r3OJ>
z4?OpeiAiV__HNT;rnCI4(aZh79q@DN%&NRSY|D0u$R7O-!>WeYiax;D^c?aFIDnBt
z>y8XXdy|nvfpL>TjgMX{u2Ysyz8cbb?H=t)v$*EH%;oI%u^K&{&Qu3K2itEGG`lnI
zP(VkSZwh#Xr!zet+)(gCcBv7>xmlYu5rab-fdL;FziV1QsmjnMlP^Q%L3GuQ<Ak&*
zP&ewkdgty!w0t@V=1|Jtozl#Kc-85N|2?fQWQ|fvii3#}!E^Yj^);<bGj%OzV?ohw
znT-w)uw}qI(>Og6O&*mKR)qR2a#2w>=$rJz?@PculIA1}BqE9cjGH*{Jah<322c%-
zw}d$)R7m5THd`M4Re^jb(u}HVM9YZlfgv=0@_$QS0N0L9mJe;~`_m8EF)`LQO+6(#
zB@d;KfAY%9C2VcY1RwGnqd))U7&qJw&hxdpD9xq)RQmC>N9w$J@eP{6g_`o<4(8sj
zfj00?l@<9UkkB>yb$VrbRjnrS+~s_v*gv|DXrG9-b;Wec&faIx+O?I)g5yuoXtgf9
z#qgJ>5emzZbl0{8NN-ZARn)U7@z+lj&+g}zkb!sh%&giI{qzg%#}WL2#S^V-=mXP)
z6YqzAhPlZ+#(s~4TgX67Pif1ONi*DUUs54!klgQesdn=Uqo_jWaUxaJtiS1FvVbx<
zYXKSjCi|&BXe6w`<k6=_I3II|x%3x9uFfp2ck=(UKaoDC3H&dy;3f-cnafvLJ7ms&
zf_o<akm-27k86KF=~zljJH-1%54jgnkAW(S$#mirdo46o?0=|<fVYnMv`3NF>i%;s
zW0HVb>)w-r9(BH5dE581W->2k{`)yFiRSKWyQ9mX2{jIa6ExX|C;MObMPX;86dxv{
z(_$j|6roIFe>mxulb-PHyf-?sACe|FBk8}hlmVVdO*!!>z=8&uB*zmN_0vaJf}`JZ
z;@iP)wojF9xx+phcVhqak_l9nJgO#$Rdb;mz81B;bsEJNussuA5v#*yd5m7bM)I0Q
zl8SS}leQ+g1Bo`43`TS#^iv{7C-9WY=@Di{UDXtWC$sJc3N`&ab!pkiSY=ZzG1&I^
z_o2i*bVAKP+Il}jB{`qImA2pK%p>Dg7cJdDNM>rX!)V{U9+G*~MCWgjj6RUnPP$4w
zdqO@i<n04meBPI86m7ei=UQ43<;B{1#0|Dw95uy}^`8Tf{@=wsIPA!^N*YyF0ImAu
zhkMSl6+@QL>Tr7<H}u{>032zmSU2;CAxiD83nW->=O(aR`{5oY{-uDoko(3^QX=uq
z7yoF*?uHX1tr1gY&g`DFH`&@PHX>6)iJ!}Gt6;yytz;4M$F7=mqB5bfmP4O^ro&mF
zE5a>0{p6)(OmXDCw$@kh1B6TQ^>vJZdj<9p4Yw1R=bF;XK$~9i@Gz)OMuSW=q>E8_
zY&ql=fj3o7a0h;)I0^1ygDt;Rir|F0XR1@KojEVRuSq1(o(k%3$`~~|jE+%8SDp_H
zb6RI5<chu;Ev9(ud=j@+JJ=wp4we{+{#;eRejzKVpVN=MG`0oz1vmHss9wo1EBj;O
z4F!mJq4<BzIq}q}xS!$;G`Y|AF@09s1YvVZGBU!7CKs(8Vo5!jsbk0qW4=ErKEBw}
zR;={XGrx!FV|mi*kj?{^C?VvawG>C~7&G5wtd0;J`R!pL-qz!ef_A<EUAKM{xTeo#
zJ1RRyF<_CTU3GUAaxf(DrzzTDW_MGTs79HJPEXz`TrWnI_+c`tE^c-09cqN5)r@^-
z?iq;5E_C0$*iX`rYC-Zg!sz5QcVePAim^6LzmseAsh_U2UH%O8N@<|lkTGh>(+Zvl
z3QzbZmXQ`N86|d0M4?+%QKzt`UB#>`k&^fGkh2U_<mIp3)t!G)_jI11?yX5+B65&m
zv-K<QKLpVW>5x>D0!2!*SbAb#bL_)4mp4BP32x9duPUvaWm(^;ga4)RvmX1X*6!mo
zeg*mV-Jgt*oZFf6*iHDW_xX690d*Tf3R}gsLg?p&zj5u!=^pxC+qY-)9h-fUrv0T&
zAtia6+^(5WW4p*IP#BT!aI_Gp)GAWLm6!x8PTD6qGNgHI4fwn-#-3i!9NB(WDWWbn
z9{ekI)h2ea7v#>B5O;ttcrvES^{e=HOMz<(eoHdsc0&q%gz8P;sV7;qd>Z3VkY*tI
zJ_4nnjG$PjdA0j-zxbIA;KxjhRX^wnfIS*mL@5~hHDRzc@y^`rwe1+@@DVnIDdnxN
zfw4$pA`KBQu6?0*KG8+zBnH5#;e$r2k?QGn7sOXzs4Fj^;*Jzv9lsh}48<d37t;w}
zah%i=HhcHE>28aH<it$mLPD_)+%L*?45vPJe{rmCQ1a|K=)w_So~%JyzJ!HHr|{f<
zC~(3;*`n+z(oB5QTzJnZkh`?8`jg#}TZ)6|!x^Qd5SbJeji!I4Rc<8yyYSZN`{W1b
z&+8J7an&Z6t~QITWwFtAy|vN7`D4q+$HDLjFHVlar2UwGsk(aMPq=<WZCqSqb@+{m
z$Qs)mEmwNV=n&xr)@ORyxo&_!15IfbqqNyrDI!<V?Hp(0_ASQIixTqM*P$uMy#`ed
z;Y&n<=bNubvz|s6%M+}NuQoT5gFlsbHhTky;D}q5_h`>-jmbK{hxCstc4=ZHwEy}o
zZ>t_2Zf7dvkx?8;tPy!Xu}J2lkn|?CF`%f`msHG}9$U}7Q{1BPWwHS7D@A+m6RN<7
z>|ADxbwd@v#$pQOl9lU{$Yca^kM{lAlfGm<?bsmP(NNZ{)w#cCt*D7}qv}@eke?ey
zUHNZ3@QjfFPeE(QVo|-HHvUjkbbbmIAS$^&nHSTH03U7c$IJGt>MlHRHvMICpU~p`
zTBq%s)5xgIB*9J<*$G+wTJQ*ux1_PluH=snl#aU!xC+8|5KNxpdUjq6S^KPDZUVYs
z5qgyF&lo1~mh{tkPwqo>Gnstx%)j%_H809-3s!N9ju_j0ljfP+*;(TIVdKjS%bRMC
zL2aES4IcD)GAEgG)ngSJ{<x%XQgC29i)FNb{gO@XZTFQ>>C6Sf_h4+?OF{8$&LsK2
z_viWI+x*65QjOqdxaqbxug<i+7%m|&tPN|I&Nh>boGs0(9fq;VGL`THV;%fy-V$-h
zzpq*bYzi0@fXDlQ`4mbNLYJOEa0Uq$O~B`Aj!NKeT*N7FYi;m;jin_{aH93CjPtJA
zw^S1=g6rKo5nsuf1_E4!EV0EO)Jx+Y#M36c4gJa#D)R6ICMunT8I40%m`-?$h=BdZ
zM)9X(&-vgH@ZyOIV3}2HY!xvvg_Fol9>E-X7~&HQ**ov!S7wDewk~%_-X`|)i2RxX
zFGzTR(4dB-4Ux>d$?y#MdxXDnqPrgrFz*pY{RU+HegfJ@DL7Grr=i5de~+UuN<QD2
zRki5EaDp?mlMYP7OsOqBc_Ca@9pJbL<Ga4rM6%iSFY~{+jVM-vVIA&ZQ5_epVvfYR
zNCI=Ot<rKr?sa{UBUpJ6RtwirO6g$gfMEEprQi-du()I&#GOxbs}2|hgH@!sH}Rw;
zCvv;Lo2qSZN#wjc^zt7I^IxnFSH^{RI*oJ+iYk)S7J_P-<p{m%d(0L8NMmnddYhQ3
zJg=eOc65`(hX0+VHT&>aWCC%%CQkh#l}1|mYG=jI;O8nQ%nr`l%Tc^357oLQgO)p#
zr?>Xl7z^{c%I1ELInuAu(05#Wlj~or)jnge4%J0fdbq2-)eW+f$zjtp?{O<E8~kVw
zwY_=l885cl>May+F;wGVD~#@vw2WEagAIgss^at!+3~Y+q}>q%L)tkdw=|<RM-=-P
zj^w*2R-M0!=)w?>j<yel+VXhc=y(}VH&#NsjCg%}xsBPyear~;sZIGWs$1G|E2@j|
zZ%yRtj^YiwR8-R;_a+-j<R9!>t-W!~Y6)}LF=hf*hmGt?@U5=(x^UO8A<pM&EWiok
zgU*^(up4Ydn)gdYq&KAxbEBi}ZEPbMvtsn6mevACMmTD4l58oB5y{*TgyIjzO#=9;
z%T5Sh{O{@$>9V8uxgS3YM^Bu8V6*_pR@jdank3%7K_T{I$fI$0Rj8Q^5^}6ID>LIu
z8!Rp6wTws>0aAb#o=P%TtV#5e-JF3joU05tANGiCZEoDO`O{7~{p{m?>*7v_4sd7(
z!`x%OvMNUn2@b|oAz4-r4%Xu`j~uvP+H++A$c&gGul3WS6vA=Mo!D%|$BMX{i!O&R
zNoYbbUy%>ej7EZacBH#m(}Z`-b>sy}se~>l)X*J-@26$m?RmoeRy#0$Q&8tEn48Fx
z2KdMO(5Hu?=lzQkpmJO-`{!((SG>%RKFhoy_WL6WL#9`46;D4W47%u${CS4CQ}*JW
zp%9ZxW3^wPC2?KKurZy$SVA+JNictXevK(0j*}YFq2c{2tO_NsY!ADRlsf2<zIy4*
zjfWx2qBoqoC;0A$`dfCvUSkGRzLMGx{QuvW{U0ooE@bC6CKa1M1G1=9og(xlF%|Zq
z)j);sPUAUZDE8z0$f%E+IUTi{&88rP?}&%2JSZ)fn%|6VUe7NUyWoZ}0#qwX%)wze
zlem6ZN4CN|WI@T^9bIiBqV_%Tmk8JOk&a(u)#Z14JLY%3ncNN-zOMXsuJ(i3IK|Pd
zd&kkZBDvKWI&In`F`oJQ(*YMG0t>k1?Zf>52duhv2D>=i5S~mb1_LPQsfSenY)~Pg
zg6M|;NgC~BEV(4Y@DnSmT@lusO!til@*MPw`pY-k-5^n~%z>d+&-!1_@Xp@{4AMqH
zI0m>q+X^ffkZb%3g%aO<6;b;ZFq*8Wt`3mtGg4YCbe6221oSr=cC1}<&K&~)rIdnC
zc>%Ow=TGhE`;WNSm;m(5Gkx8R%o)p+-vtGD<%m=OP_isbH=Q3ix85T!pbF)waZppf
z55F&~lV+F@r>z_u92~ZFxQ~<qN-jE`w@1mythY#)?mxgh1SQWJul}R|?4wIOzg%=N
zbV9J+F;f@Hfsw0mvvWOm!~zjv#_|h?9DjP~MGLh|D7s!&PjbBTo4zM|piCRxL?x4H
zo(!N_9*NUH2O%`G|Dd14Gh3Rd`p*O8pM(hP{Y_|tAHctw&s7wzP5z@FCC1pxNn8I{
z4B6W7hJ3Bc<UAMC_}_bXqk(fuJ?Oz=k`lqB@?wvqPTF5%{K3ifgYTnT@sCdOVUGzK
z_MzcSf_N^?DJ}DtKbmrb4*|UWhv~=Vs$LAWq}u=Wt7@gMvF|=~s#yim{b)>7(HxsR
z=zFt<uT|b(M2Zn6GY`5seb>GaEBx$$HK=zf04g$z9%?1<gLIJSv8l7x!{iPm+aGLF
z;(voUe=3o;RM#=?P+iv2VVh<xv0uQg>Ob3&<AnF>KYA-9c={MyYk}wZ&ddWWKsx&}
zdyyzbybytO`LdGNyceS7QQC=n(tSJIrk_{&ZqKujxldN8KAb7LusWtx%2=uFQf*E6
zpEDn+Qz)7toyl$A-YU?c`!)e%JoTn8^Hv&Av#!?;dlYaO>n=fpR0<v(@P?@D|L!^e
zD=DS_5FqeuKL0vIWC6W+=&8SSf!x3>X#wcWqbvFWKs|B~;Z-Ml(mhcGGGZcKDYHpC
z@xQT*EC;O8Q#*XHI(!HgbS)CyO?N{2#-8nkrZIeh5pe&T1Y;zq@e0;)JbNso4BJ_a
zMj;db^k~O*3CM`Eq;&*+>1TE%sz00EY^b**+KJ04S-~UuY?cgGnpw(t97B|e^7nv>
z0cqxy@^@q<V}4!Eefu;ves+Fky0O8MIq(KMN|p`W(J4|H%A>xMX%z7#{707lYp=D@
zeB*kdkHjWk_0bfE=C1lfZs81Q7>)GCFaji9*%6cM{{k9zMr|(hW-ow&&f9~5fp~v%
zTd8A`$jbfHY+Ya=RAH9ri~i)G+~0Mza&+XK@6Vh2`@gF(x9E>{0*7`=`FDPURz(pO
z0uA@AOUX*s=w^As(rCp1WFIQ?6?ljQ_Kj#K$c-Cs9<tM{lev2Y-U|06<~;=Plxix+
zW)>bBtwAAxltQ~&1I-74LZ@%xbbH)9cGAgd@3OB^B2Mk{pNP^4fXJtBX<jPWjLdk~
z;KE#-vr46SMMuf4exan6K)A_np%t04<A_*cLrw}9Yw?Z`cXRMnh-Knt@0P7pNO0=+
zCMV@JAgHHD)q)m#7a;k~%E8na!bcB%gj!5H_l0i;6UQ6WZy+{woynp|D5BJ6gLu6!
zj$@?Re?sQLg)|W{*at+6poe2L9y)FB$I=Anvc7z79<qy>Cy%oIZ*+u`b^Gg79^}BY
zbaXV?tyg{iQ=|jhR*8J0FVkMY`B7iLy5Hf}LGxGL0<jeVoS3IJpeM5?GR)*Wq<R}~
zAf1}5H=c0tm}U_FuK9EiJr=+grfe@NPY4|#&A^>E-4+{3D<iUgwnrQ$Juql$fo_xl
zpXYks1j<_}+?lzA;e1`fCvx{DiF^e<nZR^yvJ+Zu&M>-eT=*Q>A?+`++3-afj#r-g
zWGg??=;mvwKkQ41b)7?-erh}_t+{ZA&%It6y#2GhMw`9upbLK&A62se^0kLxrKxwW
zqUl~FTm_(n=->%-dy-e=@<j5Wy1;e5TKS{b1o9iK)Ta5+d*orYFd|a37S>wCha@jX
zEd3*&fPG2)OP0jcTtt0FUg_Z9<p6=!geO#cZ6O4nqXyB<6HpDwkbj6VYAB*X9ArUO
zrbI3VytfvNsAH@11S-$=@Qc0pbsN>|4^oiz71w5_=T5MzNzICC33C+EGmidTNT*sm
zCa~g2@dP=d@<Tc$;loAkbHt8txsL84gH$wqbhr7AY;6clX4@Bgo6)Y<3v8};>%Nj!
zV9F?)y7fDO;g>Bi@+X<iIejlFdy{Xl8*q#F9r<lWCnvX&lT4U?hXj^`LpyMhXYhs0
zoOq5-KMtk94{()*G87)4!GQdi8ouYUr!oT;b*h=jjGBD8dYU1$U1EvrjZU$$PbbQ1
zc|io6brU|qmVMntvsKX=m0+!m>^%1CrF#-ZTfv>L4e;=w{_z?bguynH0ws3%$TIRP
z9y$&5!())kXmK;DA4*SJu(VEx%u|Tf=lRj*opaJd=iU0P8ZQkd!7jgZkqOQ5d(y@U
z8r`h62WK<a=S_@xup?sj?XUnwCOgit+0Wugy8WOcn}5@uzA+BTt5?CMi9dgz+!Eiq
zN~5+};GQc8(OKfD?{GUoPD7(JXS}W1ZUJCYxd+cy!Ew5v)t<CME8u^K`d>tPbeXzf
zB7q!9>Q_gS;9cOOCFu@;)^FwXra;t)Ilme}rlTgIo6_LZF0nGx`%+i%`ThJz)~{4l
z^Fw=?S6Ysv&J@V|AyYST3)p8LU93$7K>}J<HrC|HL8kj2L)vF__}??g)(ZpEC|8H|
z2JJa22#*Aj?q{Z!Jk>35dmLjIqnhPpbyx};+b)5lo6{PpP9#KO^4@L!8Da^&s8GYd
zvkg`h;?qeR_$!O>3-tVu_-C9b9el_cM$?0LWuB*iFzo~j^n<=k2SqE)y0z7(DVjB|
z<Ab!EHsmsdj*cBx<U3C<imMyhM<em(AL_rk9u&y!Mtzp<j4ly0#5$A?_S-8^vmDA6
zW5@Hkev*nkLXFddD8;pFKf{e)5RqYl@ke2@=yV3!#Zilx^t)D``v<4kqxFzWhm=Gw
zj<|2bU=D_XZEth3?w@E+$`+;M*Og5EB`-^ICUvJ9(G}A$$WZ-hPXusr2C6zYwZirS
zm}2s;fAkQLTOgY>d|3MW7qfjDUI0ge{oR$?7<8&et2x>kPW!{U)XKMDi^MflN;RC-
zvd`1%E%$PHg!2+A8)Uk`|2;G1>$OlYTC{`7PN!|3>?#n#k=*bCp@lQqP;?gAQVr#5
zePLdF@%a+zGwjRHeB|Xy%a#aX`X&hPZ81axxUR^~h9Q&Vao+#!Wu>KFcHQeZbBaYW
zWAE;OGN@zJj4pLCRR`M85|c#k6jS0k;J@c#)b<g$jDyLV)g&?E7SrU@tpA914m>hC
zX7Q<<oauT#L{YCB4*~h+m2Zt6u$4byBqOlr2Axr=K_cON+EX)P!e4CWIhs=169R+L
zyePm^S_ST#cPIa4Y55ZPOFY2dFYX`!-yf8*g-Euz-3OBkIA5}HcaLzX2)(>;%|UvD
zoyHNph3EGQt=NAOj{aMh6zyfyK0cLa7EK%4l#GP0o<{{=R9{@E*V;b8uAayT1lFDY
zd;xFsj^dqwrlq|1?A2g|^)5V<2EMw{%i(bO*0HgR#2AS$ork0C79Crh05YXxSBp$|
z<yx0@7h8`t$i<#sL3W<71N<-(Kt|K}QU_{789iJ|J~hr@_6Z%+643oVAr{e8rBpJX
z0JtO_LfltpP|$U8G<u?WV+VrMzrzHOWOr2Lg62QwjGS(9ysXwtuQ2F+^OZWVAl#2d
zo`bI5X%a%Gu#Q&QNcO!$MeUX+;yP829_n<3oUzGWmHl2Ak7z*F;9AW8{Ci8xOeTC$
z#J30(A%)k%BiK*AZ1uy5Dss&$!I|F<*(eaj1PcBfpU8D0Pam81$!Q2RNVanJa?Js4
zw9m}({**l;0xZn>lY}1%9HW*iR0Tg~)_siE`9KwMXUK}Iaa8(W>S+IH&*Ekm2kQB9
zWBz&nfa&3IJY_7orl`=MGHc#nXUc{S5+_M{5Bjp%7t;v24r@UIw4-X`sXDXI9-N_y
zU(EqA&&SeFZyrquLppRJF@=<_Q1)G$g`!I=I7%J*?P$8ifLP=^qvZqj+goxIJ_pPn
z7KaX2zN&@4!4yUb@e@NSyriX;?n#s9F{+hENY?&9=1Pgp|4<K)nk9}H!u`LenX{5$
z*}s#4ef}O1oR3a3Zu}or=M~k|7j^ptLX!?ERRYpfRC@2Ipa`O(B7y`#nskvKNGMXI
zi_)tF5R@VyAT6OIAV>>6300&dp(Q}bx%q$hK79A(jGVWeG4|MdueIj<O_AZd|K<Ur
zA=gF=hbudm*b6OAR8ek<*Pw{S6G3(<R*kpCi?5sYBefY?6!^aUqIjd7Wx8vfm4bkm
ztbAD?Fe=CxA23(3!v4RtubqmQb$#CdT)u6r{<g2k>i)&BU9RmZ*^YaATABH)iWYqG
zvs%A2Z_V5bZ}SQ}{@`&~$@{B!xD=}p3%iW1tc3I3qCz=s{ddNd+QS=RvbK6`O1+4m
z7y3Kl`*=ztj5On0Gv$+htB&RahX7})FG#tv9~3uZkH>lFv!JmeA|g2Jj_L%BRV}5$
z$i~S7-BYm}J)fqSzJj))nn#Imfj-~<x&d?tf6-*SK68o)yCBZ_D9af3W$Y^wp#Is3
zDyoWP=SV2J+W*7xZp}rWCz#zG1d~R+`kun#N>>!YoPzr~!qp}giS;TK_=)QYE|oZF
zaSpp``-4C4oFLL2bZ=}d-QuoVae7ptZCPhFg4m@wK6#t?e0av2I-9e5rlhj)jOixs
zsTajpzGW${4v@dFU+VAN2UEYxx&6sb9`p^4V<d(9$_`84(seGr@|ki|w6*n*UYmZq
z5Q?MxWk_ghx?)!v3Y;6dqOPd@p<x;LGpl#6UO`o(|KSujAnwUGY85{m3%}`0PL({I
z{)1r}*M_K9EUhY~zj<e*D3+4qNRc6>Wj=LsBA<JHPWBN5uW7!<!AiM2G8HM^ad0<^
zV|Wxc`{nIBe^FKKl>LO|Rlsl4tSWA&t5;2;tqH#08CFFL>8!*6G3#fSuI2n#DsAuC
zdF<+wgm35$!gXF4>q9)&YgJdzz1wb$)t7%%Sq~rWY`eNVPKN=L;6L5e@ovM_Got*Z
z&PcPf6HC{2clOscDm3qYmr$>8qGab#|C+K?Q{nKdTQfRq)Dc;>-*$u0k&^3$vC`Kg
zR5}KJ@KxInQ+~RNaI9go5lo~%-D{15_6`;&=GXYd3A9a~bzgw@W?8_rakqYC6B^{r
zXTK?>kP;Ql!E>6(O?gWE3I`49LzXsq%J_IVA6tuWfUk+j)66`axJ;oSd5UZ=`q<#3
znt~aeCy3$DD#X}M?_!$Pq*A6lz`MYZV}r6=d+zy$12DlRN0Kc?PqKq<d_vNkyYxj1
z^Ces%FG~<4o>)fjZ@p(f@t(=vSO4p_C%qf4N8)|?^;<h*rh4g`)!>V}d}_5XJip9g
zS9uanT3s6Ou=4PL@1+J&FPo~nU}~M=t5aT`EViE`Fc-ZA(3p$%6XRP^2@k3@<Wzph
z$VZv<#fX}unR;+`U5Pox&G0y@F<89katVQ~UnDMXk+{o(cnDPeBc>?EvF<3T*+RA5
zWr-4cXIxyik@ge!>w;bs>YWOj0wnFVgQq25gW}WHZ_d9}&sO|Gp6sy?M#{uBkw!i1
zAVN`u-*K&h<DV~jkK_JsY_Lqk=8SI+cRPadBbt&F=Q)&IqBpD`)7A<X@akutoD^>~
z4M$C9fs{XIN#kN-)Y#Xzn-?e!HQ6mbZpC*u9=a?qPtt_zg=3$nR(N=jfQjCU6kT6-
z=&6?v0|M#3tvkCrE4^L5>aFvH7SBU0#9!hZjn%8q^<t0}M3MVs(dzSd@~9H=*-iNA
zpSNE4MSX9lNWRULrO1)SJn=V2X0RfW{vr7M=Ng~xm;(LX%ki1|NmhJ~DTQZ{OU}Ri
zmh%KMJe`2J=vQvvJJb9WE<XbLFIh!j&auL@$=qd>K6n4>8<CQp6!cjrDy%o>!R1tF
zzp|S4sY_Ho^)31|<H-XR`!7N3J;nlm{>uUe?AlIIB~V>XT)l88XJ=gPoOF?DuZ0ga
zkLNe_)0Cds#Tx3kQvS16?zs0H){C&CCR^#>XDzrYXU8Sv<aI9@tAzq9Z}sPL2Gcs$
z{CDPoz`%C|d8WKJ0^t^oZ_Mnt`Q}k(1%`L{eYjLQ$@X2&cj9u_eGPO>iwde8KcL3^
zK$t>WqFP+APrlx2k{jFdw#2bb&sICp!Sv)M0iiZ3iS~2ThQ1;FI<27K`C<PVuG}8^
zn9sF5!9;5t&NuU;Q|F$+wxqv!?bkfM2eCYs6a7i@<kh!!=eCd47|%;T0beveV?2yi
zJwubZ1^d+->2C8VrJ1R_ha39)qc)c9pM7oTDsyrk07<tLxfG!H;-(riHd62}<__b^
zE{3ZaMzaAcXgDx+<-vXK1X~Sna*ef_^8XQ+;+2P+U&Out!FU<s_o%v5+Di7x(X3W(
zZgjKrfY7}gxaN%eA5urqk(mCcePR7*PAnov+3`=@>X`X=|7VLXZa1qJ1Wj2LW+*RE
zJKZlBz&{HYy{B(;cR6S-M;<ng%r(jcS6#SI3E#|qR;PRoyxw}Y-SPEfJPcr>p|0@^
zrSLMkg0~YiVwPFue%X1Mis|skMr)~}@t=UWqoB2xA8AIFc4pq4xq>^EX4UweK*VBW
z+-r!ANRf@5ok|du*S6;Ubr{Fehd|?!sEhc&G8;fH&|%5Uda`xOl_Nejml(rX{QmUl
z!Ng0Cte)$O|Mp%w<KFlfT;{nfo3*jz#NJQ=mg4sTn7cFLiu!w*E7og%>Ib$-B5d1a
zlkaR7pj;LuKYE4Rm~4zJ8(aRpI7bWjVqNFD<0e+gU!5<R^USf<Sg)$0@8b9$k;Rs&
z(IPc*XL-)QE*$b-qCSH56u8?fSudn!^)e)g;$BN~p`Gql&&WMf?9iiZv6*q)zly)W
zTgTX!RK?kgym!;~0Z6YVN}SG0L}1#~y?jt9#S|32hgsx)@+ks$@fCPcqPn&|E-EEX
z+qnq^s!8V(?fv?^k<pIQW5F^{oZvtrwR*Xs)EXR47~BhHTOQc&FVNJ8&q(er;9y7J
z$&UIh3-29O&%^If1~DyfS*}&yMDc}Io*BLxd5&N4@_M2$fQuQRa_>62blT(W1!78B
z*<RlfWbgPlLP2O~>604Tq}(PXcKHTDjCx}l_K!@u-?9S`or3j4h4=BZA9gWI(#+H=
zgW~z7d?U8iwJEcD-S{kG^^1ykdfV-^R``L!Mm>O!@8%Hq$kLR$FTX^1nBKlRGzE*B
zuao%0vb*CrO+*v3w+l0xbH9bTYj+XzUnl?0qV2XswnsO8D!3=!>Ay2#Wzmfd{CQYO
z*4!myDqh!qNMalarK{^w(lekHDV+Fd#;s~`bP_wC!%imUQZ>DC%KQ87EPwTiq4Gkb
zvD%#&(qqU*-6x?a1*RqKn~oi+$T(bVDD$>@?+?zpFX7yT4J;&-@A*fJReBYC4z5k0
zd(Sd*MRc{^QeGlI;?LZ=w%hzyq5K}ADIF^Mo`Kvk7JuDQHA8dRLDS@v?wg*^KxT@|
z(Z43yNVzt-M4@-OIgTKJsyHf*>g{>dUMZZ4J(=4KXVd<9*S6(dZbmoPdFxOydf7d>
z5&0*qtv-KIqd-%0RPk6UFg-I<csEd4(gFifn<>bHEB8cl;P_6my4ukkk=i?za+w!&
zUO4Sy`GvU7-=dmu`jSjSUdM()sfwbkvbDbirMn#(*SDc<Aw-j<V+%^4eW&txk(~)6
z@^n3@KDvaJK{RH#NS?~)S%S(Y?v?h57YP{lcsq?0@VunucOr=6_1|lZ%7~_0h|aW#
zd4_*lp|K;q76?3hdooue(;a7+6x{S9wlllH-o#EMe>gq%0>4L}zt=-g8w`YA%>={u
zZ_(QnD{JLSrB@JW(f8T>vh<BYxq?Mc><$5l!N(Nde-<z5+bXI_<Ir+hWxOeGtMWQ6
zJ$4$wSDCyhTWTnv&t_q9JtDhU5-)I}hUK>)2hHEHFm5^7X@BS^R^`<bPlu*&u$AVO
ze<U5gnd_pq#-TziK<1FnO_Ba#%fIv_R+(fk$_phf1qSq$$J`gLb4CAllDStY&>3fU
zL#0~y!raryxnCljw_2ATPZ`{+yo1;se?`7V|3>=tY3IxDhxBs)+?GBXdj5t(qo1P!
z@~0rZS*^dEsd%4w>j@ntNu9V3qikzt=;t#W0Og^$Sj8hVoff#~6G8$O;)jm$WjrKq
zC3HB7GUSRNkHB&x6QA0ZioYiz+eM7rIEvswZw&s`eV3SuyCfPhMuOE{&3Q$DqhC|o
z0XK~cV;S@90s}Hn+CpNhs^D~Tpp@isegCWQN+TAOBxdAvc=B$-e!kyUdd5CQqD{q5
zzUlF}H-zkk>|?PLKE;A24%+X2Zk;Uss>{)^cg9lW@EO37(o(BD3#DUNi{^d>{EPP?
zczVomcMd3DW$(PHAbiqeB$178di*b6yZz*)Gf=SXL0&Q`Bw7i-73-Y)X6TzG2DOGy
zXD83%y(Nc2^Y6}Whqxc__h+YI_5Y`7-=8D{sIGB2*d1ytnrxhV+SP>7P3iSQ_`W?I
z<Y`PC)JqWg2Mt6}seDcjj)R9A(TSG+U=M{Ev6KvA+WyT<={RfC*x?6$GNy;YlA1tg
zUef~~f+MLH6&u3tpjl<3PY&%mw+lQ;SiDM}ALy6*i9Z(~DawdcB&p2V{CWqHi_VO#
zMaIcT93pJMXM)6cggE3Be$|>y^gnPNES-bH8x?;Eo|(Lx!fArG=(+7gF=@AJl)yPg
z(aCSOqIR?k+5gZ(A0<`3oO84IC?#dG*1S`Lu(Gm}#&!NE5W`%4d#uF~8b5ChH*K*}
zmu)+5PyEYSeMh)Aft%FYTXz1moxuKizWubbTS2k+OG*Ug1%Tl8HFVcUed3MGfhM@}
zkO0g@SZ9oQ?P}2hm>(zMj;i{$AC$f+O~1JjO9SWU$r@-n#P&4dwRRi9$)HivL-)nW
z(~zUdKy}->td#!1A+$;6n*$7-_dfP>7lx@##GNLxuCQ}caPn?#q}|q(aih1~ti${M
zX`rBZ4?)b7&Z0DxB@*W$LARK$3}$=E@qVSsI)-X;%HukE_1-^xE`{<ScLE7nX`bn^
zcZV&=NuS6AcV=Ah*}r)n1<Aix^Tp?rpWpPL8xi$suI3DZJe}#0)@ZPOxk04A>Ir<G
zdfjF9mr%&<$R}Br(|T>8q$-*QMbguvO4=&S&hCjhJzQ_Tv4M`2AewuYCnklT5UoX-
z5~3K5)(p8m3zITW3Wuk$8&+MG-fm4F@mIWiALNbaukil(+3Hgz)E4Y7+D@uVtgFhr
zB;-TyahNUeE|Yp*&)2_bwCqeAxJv3k9P>FcD^V22*k%VLMn8ONvtQ7P#~+C--*~Jl
z4`TSIAb!czu?v^q>435mv>`yI)$hz1j??pbrk4&k2wz=y{#~siJ;kVBx3iPW;2{b9
zT-hDBaVHPMlEmO&j=JIe>&dJ{_<T~|g4~byTl{a!ax2Xak3X6czTMGRlY#xfR=f-R
zy|KLG9Vw(<Khghu*JMDaJou{HXGC=A?`?8_Ce3}J(Jx)_DgH|)C0UExHk{9A99mG^
z>jn^?a(!k^$a{7PVuRr_OL|nZ)SuSYCi&Le%d3^YGi&2Ei(w7Dr3~o(c>eqzJrG$>
z1>yhasD||FthHqW?q@;Pao{L?oTJtpgKJ(pufh!}j((=8VkJ0AyrH9<9)(NK$&jmr
z!KZgIJUQ;nhn}~W%f-A{S2=joo!Q&Yd=_~zZtV_RD%=Tf6YPCS`WVyrjgB6bkqT+D
z&6__jvO}7~867&t>b~3$S#2d`kP9oqZ2n;%9nEfde+zrTyD`RT<^GR2G9j>O^wp>-
z<S4vqKdAW4$(hMwR(j^UyJ0RWge}HLdfp-om;qT7cv*mRho*R#o{-llZ4a%Phksvk
z4AvLTEb-wo5qO~7!;?T`@D6VMvWqoGivZpg5MJNMn_hnI@{G=(GfBR+_qzsQN*-Zd
zw~5xhtTi}Y>C23;^WxIl=x>}v*Hfzq7fKs*ltWjz|I`zOi?dQXoi1@|fcAj7&1<c2
zU$FSL8Z<(kbwq~2H3=p8f`rI6&x_J5g520K$Dry`4hGKn^}N^Dkwn>q!<i%Rh(H}9
z&XrT~c1(T1v_mEL!bPdV2!NOOYU9QiXO;|Or;t_TwW|G`FS(2^#>X_GKCc|s7`*t;
zX4k%0W)x0RghJfCng8O-L31bXdcz4MMcz|~$_P*Alr{rTBOC{J<H7;Ou}KE{Ix|`$
zT~wtYjk9Kp`2L%|o(lAy$m!hoqd+%G>CKud_rfJFTOFne)ggAo_AN%PUn+F$(+d|Y
zyaW9Z2CUI@iPpsxSOk9<=qvPPPxAx!L5ef-&uP>pp8PZx{C#e!2`ETY>=O}Owa}MK
zOJzus{8M&TX#PWQPuY_C;#EZgJz@q}qj`Y^ob-2g&Es-oOTRp7jCVrCPGWH%68T+x
zQ+=&2b6r|#9n>fmC&~gu7Jn-7uOJNzZJ6~4v1#BJcp?mqY|Fl+Cy<FM1YQwMcZhk<
zjGqMl$2(hsz8qOip~R)7zY)DgDkb?WGe>0Si0m)o*jE0WIlu*$t9}oo1@6`H6d{%0
zpYVE8Pwf>?)o>#Q26omX(i4c_C&#6|TjC1fYu}|d+{KOrZ%jrdvMe=#lyzl$aWG3S
z{$vesynh|AU<?i!LDU$l-Xm;rhwuNp7>1)QI#3y46$;U|hNpwg`bGs>M9?m5yE><I
z6+}lAo71{X{mRxuuc_z9p)hk4n*XQ4IT>TdY0;WOfsY}sm*a%@Q;HBw3ZCJQ#q}G)
z)#(8{uuYD}1ATJ3($2LlGbp@)5;9`IQy8tin+M6g`hifD7dN1f=Mvdwj)QFt%C^Y}
zjBB4T*wy~M{r&ZD_d4m}!F3gJy~$+{g9QcnhAo_#dXI-QOd?USmmkraC{k(L#?A5e
zJbd`T$B_Ix<)}qL{qyGrs;$^geI4M!VNQn4QeC9GQxocmP4mK12SI|3CRYq(AIynV
z%UkRj?r$Tx3;S~WF;o!O(YtV2tXIp6^4Nc&h)?OqI~@9r;H~H3cP_7?Z&{#De0q^4
zN1cEvt98qBv3VPP{-5qtt$1iMkqLXTIZi@3h?ir!AT$2QuqWaKWiz4XnTK#|4|=^x
zH5PyLN3EPwVh({zVA*ZxbsmyMH1zi8n$0;;?XUNs5Sh?H?-d&3(?&j;ATpYK<tLDW
z2mPE?`yAaA+|*jw+4o`Nty7b05Ld{7g)DguL6Muk78U_&c-qH7=Fm^N2IySCOvcjS
zoFTiGa~8)7it4tr48LI+;>Sn%41hY)XlzZ)PCMznJxu*ENKt=cx9HJ0g<`TjZ}ebj
z&tl#X`N(E@4%jOP4sW#Ys}bH_14i6qbu?n4+tKP&Vlt?+ssU>c;kHy?e>~CNhHeRg
zgvrMEjp)%(Zr%n=JI^R`_2pT@1>Py!_Eb6IR^GYlbG0sUT~4LEM=OyqcI`!t{3y=z
zX5*RMYftbMrfr}1yzF0u_Y#Mp6gi|bIk2j=R5O<-Sg^s17+7CC9unjL0vzAGV%{@B
z+YX^_iotr1o7_{7Toq3OEW$t)hXYLj5P3Ydl785Li!bBuAm%oY*#QR2tF52thG<?@
z?HpHtW(Vu4bW=_g+BFg=Eq8rVJ{{DEP>~#vb4q%<e(Twz8^@fLrdA1Q(CoiE^ODfV
zDVI~Ow5dd`d>pvIdW|^L#j|ZKAEQafC~ysUnU?~&y+M$k2E<=*id8xAkbIO5JcPPk
z(8k#_^R9RzsHKE{3HpFN^hC-8a8*UiFt9vg8vUR6YGYMOc#p`EhP0P4m@qlG7a^kT
zDKN8oB#GdsusnUXC+cz6Op+w{`ajSDUC$FoqlcbBj#0BD8kiAVND+B0p-(7go|+lB
z`49k$95WJr7#$R>6vgG9tHKkGyr&L5OIqkzGmo}=feO#aC7hyidaTfyC$7j?F$Lw4
zXjh7V{@*BVy>l<^=|7UDmjrTL5l1^THcgBtKR|2bQCe&h8F^*c5s>QdS5Hbe@gYGA
z^L<rS#RvW{e~eZmQq8%#Hopg0TN)-`wwiVYu=Pt?I@Qi@Yda;;!A`UV(siwjCm#Z=
z$NdEkwXZC`$Wc!_bGRP%=yEZ;^Iq-oz(Ds#I$M@4O^NGghGd=hX6ZY@bRm181%C#-
z6C(o?%U3sfv#oAdswI|A-0Hc}T%KjR$Kuw=*pMux)_xN8^Zr6zX2wb&h_#S%w&X}K
z_(vHx>8+gO_9(mY(~%7g<)UWG?<z;W6C?al8l8fNoAcWa{D1b!&|7XAmOx_cs}cTI
z3lf~$&l1iY!MtSN-8!kdyGB(@^@vun9>uo0&b`>iw@!h;!=4Tl_hcfdyM09urQ2L&
zGnWPp`CjS0Y_c7ZtT|FK-<U~8is?KWG+Y1}>5=OkDG%dvz>;H(<f!B0!gEOdz3Cmu
zA<{Q&<H9XqY`buH^1KI6kO@8KVQrTtK4sPo%Q0yam!LRWP#bLrUiT&C8D}tnj3wz(
zE?mWGSP-vOkWWjPT`Gs_LT~4Kow`2)>xfHM(47@KAq$K%aM5P>N1r!R&W~^R^#NN9
z%iFn@z|dkzNS}HzDLWsd9;sPMeh$Ck6#($P>_XX93*^&aZ2O69TED!M^Do^69Rmpm
z7AMtU-hXr?%PhC|;Y*9T$SdDB8M;5@?(nXUJj_jFAs3;U7WLQ^SlcgaI77Z6Rp6NB
z7HK_gkZ#qNSj-^gqnR%np?p+7!o4Bfj@_?fD$8z>hp@yI$aoa~_nn87JPG2%ErQ1m
z4@GFnY@>raNG#7l6lRZzI-p2qi?#M<PONnNSaQ^YMT@f}JpMcgU1*UA)^j~Jh}YN-
zF#+mvIY)Zgx(AfrK&^RzyS_e-eM3ip^sstlOcWw}inT-bO=Qa>lq-sLekbf?Pi)=%
zkaZ8o&^nRBOSl*L<t`Z{AktXz9I#3<z5jB}O?f#9!1)w_c%kLAb^r%1IXvC_hntJS
z(}KeGu*o?bg9AR6v2Iw(Z8<I-UvnR0DU7X(cD;$<eWsecUPS<wIuHPb@2WLHg$>)Q
zMO8#p0JDY%(ZQ5U%W^L%23Lb*e=rYd39<?kwfY8*YlzF812j=UiuoH^i-2)I36aFo
zn7MyjB*B6gLn6V^&X^aoL6KwD;E-WvyQY5Bh0-c1$%P06)F=1U^aJdq?Ol}%rt$6F
zgE<`aO+3QSH>clRCsnDd8LBg>>43r-tA_M6G;3$X@jscfI^cNBRpGV2DF+5;wFdmo
z9HFZVDdJ0*WIl!`_Rl#d{;`HU_7#yqY+PV`Hvlg$dZ~-JU@t|z7Pb9x#B#l~gl_A5
zt(Ozx29N~*|5vg9(%5CYPT^I*VTjog2iQfnqejIwl4b(~)MT{%kiKKLSLLX+qxBtf
z__y4kKfj_hX?Y861;3VP7MiIdb+pK8@WhP`3GLyQt4VrFdc?u`J}WA(z!RtQ0EUt4
z(v0+L?SaC$Y=wHx$EPL&9il6wuLw#ne&qr49<{-)MO|K!WuspcKOdeYf4UJ`)L`l-
z`7erG+HmleHq4DnhiK;gdB<Ht<1gf8J#NIBiRK}Y=??;NP88o$G^y%;Z2RoLcNaPF
z>dZMo1z`4xSS&nzi-uSt@`qq3&{d&G)d~*g7PdlUfl9bVgxK_8?y;Ph2r>y^bjCi$
zZ_1yOqr9L((}ny?Ec_5%ojhapoG8JI+N%#>TeGBuiOwVBBd?A6W1ur<g8n}%dc8p+
zdT&S#v_{piL;hpBsmjSaL{bc-)RwM-Z55ojw`a3Ye8*dRj=fJGT896Wb(8zyI;Dp9
zvB84~WG@N~j~7ocK%iOaY3GuZ0_ZhyqDi$%OFU63jdBUs?D6XRb&pq~Ni`wF*91n|
z=HC8$M*GG~=z-(aOafxWp7|u;x`s`VcHda7Y%qBx7R*`IAFOjKZwlhS)H{>F2}{r+
zD?0BT;XFHcTB~;LrGkAo?7rEN6!_HLXGoXZ&*qR@sVqUrr;agqPw76~V0ECMK%{fe
zI4%IRr&m`-39JmRRPGTu4i@a?&&5;;{QsaY;&`tLDB)j1IPGE5+YrySBX)qk%~4a$
ziRzmB@swo6zjZOXctQ@5O`YP2ofF(2b<W9dC(!Mu6h^Si{u{M%xw^B@j&Cg>XIHYG
zv_a4Qkf#E&r@3?Dcbj+{gt&KfEHrptY=gA*r5&730u7=W1#Z75M_5Grh_%PPtp<(R
z+#bvmWFG{_3K*!hve)(`?4{~%(5*0gClF~st3&-!6iv@$Y}ZYZS1{59yphty{x0p7
zlhl3dXlLn_*t_$pQVah7F*!Q|z(ujW(JJq}Mx{%6*cysQ*6t1haghD~q?eAXqp7ei
z2OT2{()_}~OHvBa_*3hd%wLAQ%CVw)SNs<lc<f63)4r6b?e?Y#M0^+Lzarh*te5DK
zV}fw6Dil0TVr=x`*U3KWeo9LZ@{>M$DO)??eUs{CgS-zMKBCMHT{~%e;Q_XWaDOFj
zo+qysHS!{B#=G~TGz^s6<5d!G?f!=#yelOZg?$=NLHSp%REBT3Pz|VESZ9}G<ORiD
z)y+jo`_Ipx#(IIk3<cum9cqAhZj%S6!GrWun5gpS^Ir|JNGY$1%Nmc0B{C!XM&eRf
z1x46cr-ZAOw94#nZ(M6Xp-D365BK-zaP!L~0+5>3*F$1W#i<0_$s3%;gZ$CWs^>(x
zcph*0@~%ctdpjd|CFrcwk3)6L&zStYg<ZOmJN2_z%0Btd98qt{puZsEFaMHzoH}WP
z>3Mb375h;<>h|$sv|xsdby^N(pyAdegr$j|I{k_C=EcQ#<Mi_ac!P3D`-RjsWnr^9
zr29Z+kw`VmA4`vef&+>i&9eYxT<O2tV(c1UwHNCRB2uHASy{-2V>GrJ2Kx_-w^c^H
z(FgsBiF^LxYzjk8BkMsXqD+SPNVMPxz7k^eH>J|+_PNt`Zjqp@pbz>P1H#I-Jfl4*
z;R&=Cst0`ypBWs2`}nJIp!*{;Lvj7f)m8^ZFQ_Ho;^a<(@25^V2IfGD$vK@@OAn2e
z@7<w8TxsU<jwQfl4R=*X#A2OYq&!1^>U$Y_KJYB9tm}KtXFaAoX)!+icLB~Yfmq>|
ziew;%PfwpF&*rzS!d&sIrM}qRB;l*;<B?RSN{-s^^&i!((le8`C}$VH{{W9Bi5Yf9
zJ@3;pPS+48K{|ae^nHu4V@IpyY%*nK?HftHyp7?)t508tPWBOS0v>|g?^82lYc?QZ
zVZx4%vWw35ihOy&{nUpnLT7%NI6r&iaAW839a&`u-=$j#jMrBh!q0okW%9xwB=!v^
z_6<D)Yi1{vC|uZ*g{$EZW2#iSCh0i<=H&Drhiv;BGn3qmHHn?1@Y<wB%;@?cE2k;O
z__NfYfKQ6Bg!I6*%S;4i<3}l^{HxYiZEh4t#NY;Og}n0*S8l&irvS`A5CG24bZ+B0
ze0A#3OJ(FA_ex1j%o-b>n{6r_T^h|AZ;*Ks1AIvl+(HtB@Fym<Oi4+SCP{y?a!Z6Z
zK5Xby?9+a%U(2{NDcvN04#S%&#7TbcW*k;B*}xE7ix)`5QJbDYYb^?&4|Q>iO1xSB
z$!MNo2evn9k6Mc)ir41}%83W@l%9z=-&A%SvuT|!3D4FBBH_V`4rRX_J}Z`_=gKLT
zhsMZ|H+Z%<n0<P?MC^;z<h{H7xGrvfyk8!7p&c1BX-x*GyuIsxW^tLqrAuH`!0nFv
z!2853WZtjKmJLU(|FcS>56Wr{d&fixI76%9HNxv}bf<Ef+33Zbqro1;;tPJd4;77&
z^0#Xz3GF`WKcwD3WG2f0KBiPk9x_Slcian5-*IfE8XsTz2@Ol$_bEM-elg3={gCDE
zA0@81vTSWCPx}3=az3f9^oJIlji6Xe7#1)Ay?nL_Cm$VOn&jo@tmKSHN@gvz^Z#n_
z)jIvkHK7N$_%xbY0t#fHmMWW)cIQt5li4_hnt~pdG#03dD~WsS_v%}u|6+3xBisJJ
z<?!-JasUPzB^(QaOniM~33YT2LjE!G1{Uvu4;2zVS*k|L7E<zl3z{umGD9!lQc65S
zx*x-$fGk<P$lztlqk7pj!^|6lX7ytBmIqH9?}@bfED<R7SuA|%ntVUq6}y5GjVK1W
zShRZ9S-7U|*L?OIdw0i**HX~DmJZm=JnO7+w9~t~;O6+-2>k1rh=w?lq{cm0qXFi{
z=dWH_8Qj5$11X8I5rO2$iZ=@%d{EDRpxXJnW&}BWb@7d2C=>g<J5V0ltJ4)z!e^Im
z#aJ=Xgq@0^vTsP@?MWZpbMhEcMy)BxuB<eL#oHREu?_lnK^zW+thtPyG6o;}V_VEb
z<KnX8IPO~?CZu4P@+3I=1epC@U)hRE=QpsN=65if!L?Q2qdb`6d%bI-yLyoGLwqqm
zc0c+$F~4&KXGvuWZ`(6!qHg5V#5zUdlN$|)R(+whbfHAU?cqe2%SO(jdsXI9P?HkT
zMC6>X8QYfaov=hH+b(pWlt*Lu9XnSm)dJO>z!>4=#xFu?*+OYKi~h01d7w{k#_3d6
zqil+8y3*IIxvncEnVo0mR1)IbDc3b4byId9C_RQP<!=|!&Ggw}vq@!vHZv*422WR5
zd(=q%p%m1!-wr&NmnTz!l$=IvCJ)L`{g;^0S@+VKN6i-9xO4Z*Ky1a)oRMZXbH)N$
zc}MNGk)dq|E)z}HIeiuRt%rv(OMCSunez10vg;9tq#38j<iIjFw485FUVv4w`e%!F
z3BE{paaB!t{5%Oa60C9Ok)z>RgM`~BMw?+!e1ZX3P5&){YUISUx&uoXcs^uOc=`h=
z|5_@Xp<+DXU54Xrsll7{%9l+Z+@7<tsZ=_%KP2jXw0LyAG4OIG9xB}5iEsL{o^Bv?
zn;<l_H}2Z6o4w*EYnZho-Fj7WF`$O)V$uV%gzn#E?p^(!xk81JeOk-exr^3yLWR<A
zelR%JWb*?noiBDpF{gaU?GPI1K<a!M@sq(_Xgu`oFdT@7oCx?!WO;+t=8U1Wr3v1V
zwbFiw3{74T4%hH@E`cPRYn~)DOi4_Q)L%>FEwS`srBF}Rx#@m%QhA|ENw}%IsI+)f
zH{`rd#F}b6+cGPfCB}p6)#E~`_dtiJM6_o0;Nv_>BDH|BC2VK+v)@s{horG3-j-vV
zPgDMHA_Y2d8NIj7OuEEp(x&u%>Dud8*0EEWQ40I$SS#_AH^{>QrCY5H^WL;;pZt5k
zp-H2c!nl7w9-X*+^P4ok1*E+B`qBFtM}f#ITdX9_kG;JxJ)Vvrkg+#i^iBN6vP?#+
zv8}yBnasPqnQ9U~oiz#px^QOtyb>Oa+HbjDlq31AzU$R-Fxpo2FzMZ9YuaF_0C2gA
zw|7BrS10%Z?JhA5*V^6#&};X;%$5+mtAL%QpmX(eMfS&MMt}VkW2&!K4^W@<KZDgz
z?h@9J(vy)n9DR&sT`{!C%}!}!Bl79hA0}?41f1I<P=ok4SJp}@1$tAzIJ{(xg2r<x
zflSAzp&qR6mnE0wiPs`3o&rHd50;4K+ivMc%Pza-*5sj#$|-iyU&YtZ>i%@6Y0uMr
z=vA>b_1RQfhJ*8z$bKQq^trEajmXqo;#XJK*k}MC-q`<o;UY4=IR&nCiyP>A#N#^?
zM%?DpG!;io>K8o+5L5ye>JybU^~N*35R2rbq?a;{1dxBae|6c=AH6$UgYVvP`}kR@
zJJEa)zLE`B*zJ%HmnkZDRv$<L=BJcPlDK0QWDl_8-*BVb6TCoa@S8>)V0OuE9~!J6
zLG~q6`E7EDx*IcO6?KbRoiqUtf^UOblcPkQNyq(x&bOOEy{$fN{c$q*HLwi53kE;s
zBZbL33GwbV?pE{&O@%47Q>s7`h^mx;5!`@gdNhjJ>itgq(V>+7Rw(k`r-mLo@J}^_
z?e*4{Q*(&lipAiNK90oog}bL638SGYT!}N^x!Bs-rdZz}q&KZ&7mK(W)DQt-vND}4
zTwL^y1%ZXybR{2(3s^<9x^(geB})p$$mOCr71XS8xgaM`Kg1`t8Qqe?msu(}E&a{k
zz&RYV@k-P2>gn}Hi)|G4%q3mok$Ge0PY~aUKu#F>dJlIJL%Xc7x=PCuHu?(oK`1(4
zC-iaQ(OOS);A6=Z%2#83@)-J?R?|mdh!}|pNx`ajSGDPVVlk3AU=GvnLsHFKSOl_8
zro!((!XyyGYGgR*2gd)lxy8{QE7ye)3DLG<(F|uR7hD8(pp3)<R-4(}dYpf?d1f)a
zCf4m-M=-j{?RRK^BSs6)6~+Fs8|DSteuF;t*V8MqH;aSqbcD-ivl9#^<QA|1ZV&Qy
zIj<i?3{qGo-kCw@$$fgu%uifPr2Iz4T8e1hhA^2r8W32uq13sT%KY6Oux1|-cAsz^
zzWL@eCsZV-$fJhl6J_$_@L~7TM^0i2>~bYR?S>$w*-u^mw5ZWrQ7BPvw(PxV-h~eW
ze!xkD*hanX!c~UAvQr}0t~wV?{~+~s#s=7fwX>BzT6l<uSXNhjn=HbDsk1B5p=a6i
z)>ZsA*715jbKgX|*m{~-EKC^}g5LakbWeLDwNGVvDUizBq5QoijyyIS;(J`Q6tE18
zRm9@7W+AeXh=}j~?ZRT`gCn?xS@n*0?TDR6Q%Bu99QkG!IrPjMzskk6@uF=Y;vP3X
zwY4sTIm7J3DPYN6#v=s)0UWrz2W+Rn6)%QhG*HZp{^?n2n(krHUxz`KY!}Zn$0%0+
z0hhNxBbU0xq{<iLARov6#JC6RS5K5alZ5<?&OhIXy(+Fz1ZLZA-lp(Q?vC`_i}%tT
z`azrZo(1B@0`NMduq`OxkNA-RlWFDx@Ai{f-dGteyETJ4D^pG2NBB^2xSJn0A%$1z
z&vV1s>L5liUQrLVx>#jkv@%%AcMx8gTsOwu`lV_C(&C$<j=t){#xwTp#3u->m93!Q
zmtxs4*;4uJ?A%w1R}m$Y!9RX7%7avqYt^}R^z!(()e|iCm`*G{$XTm=G8?0DiGtlV
zFiE5iZ5QL(e8nDFOpdn9ofzw8h!eCFkM&?Eft@at_Z<8}JMofwK$|{*>zDxaLc&X;
z%y0geVox;Fmb-62>=3k2ct(PYliPH6i6xRthptbYirr8UfpS_QK(Wkt{RzA^#`qC}
zVX&m1#3PYBcLGpTRh78E@>}G#rYay8rSax{#Mz*WC|2$X;^Ndr%K%Lg!noWLJf0jR
z=mX(s@kKU`=>L@c;wrmH1cy$%N#9q;Y8~@Mb=e`uXK}G#UJLXdgVrPz)XswqC|q~5
zc-~cW_eHb!w_hnQdX^9kku?oMT=d!N+OGz@tnN|x>NfRhPhN()h&>w+Kfmp~Z!s#*
zWn^im!wH3i=Yhkp5tAR<O2QswLnu<XJCm16=^5{uL`z(P299?Vq<-+Tg@#~cE~hUT
zdlZ!BGWTnn=DlS*MSQ{<`~uJV`3cH=tk>fL!#P_AM(h-*X0gXW?=VjSImxQX84;|3
zVAhfUMQ`iTPyj7f$JDNN;yoUvd-lW+!A*nMwH)uFH^bH)H+r^$po`q~{t-a3@Pj4Y
zrB&zKoxsZK4LjJt@K7NxGljy~AW-@|+&j_Ct!x&J=s)Vm*sB~J{yFw$8q(S?CA(u2
zqAOp_*=z^Rzg)K0@fhgxJ~tgtw&kNWzi$8m7;}+)8blv8YzgJ24B<k17sDwBTVL5K
z5h(8<VlN?(R#X_^d9UsJPNIb1bp!bweTe7#U<MdkvNN<sjF*Saw@3lvdRh1Hc?7Mg
znqlqNLM8xWEHp|8)jRexeyH4Q&nSB+i@~u8!=ZcVNBUQOO8z?)`uCPWCkAsU1ssF$
z=t6F|&OZX<ks5*{nP5IkpCJ1>djk=f^Gi$AvX^!(?Ese64;!me-=fG-bu4U*SsL$V
zejD`W91-za`poYW&IzPQNYsApwddM??mXU?6Z4QW2kVKDBk|m$d=l9t={HJMt*_&K
zp0tm9r)Xa4x{bQ=+gv?xnE0>@!HPElv&hAFL4)uxzq`AMxg~AAbRPDbrY;&F#+#dS
z$53dw3(`@zqztn??ku;toIVH1$!}~0xL@19_C%C*bc>8g+oXo7k8+Hib|T?CA3XvR
zQYg^D@m<&|@%G`W&`^(bw1su+?G8Pydni^|TXj+k_OIq~dd6LY_O53cE)ttFFBlWY
znS`^`hD3Hl)sLgEL*U?3t!4{d$fAT9;{H>QQlyalyI$_BgYyi~MR7)1FRNan6P<}u
zh|Qz>=#WB-q59}LGd>(a#Rg{BgeV(XjN1<DW$BL&90Hi&g^81~<Z*di`6*M4Gz}BN
zf|Tb2Vz*y>DGdfW_x}0qe<AC`CRRx8Z-@-5V*<%HXItqUU_}AvRrzEiLVEpvi$i-G
z;}Ri*&6JbzgTYrj2wvVPalSXU)W14l??9-oNJf|8bxmV+pSsq|;}Ss&WNch+BL229
zPi{=AUdH#>(~#tEhd_D8z5B#)hf;2l+pwu?->Ij4f~HrHM-IXHDM8#p*$z&4bOy3U
z5w0`<p%K*)-=qNn2DR*u?nnfyfL<XKZ^xe@HBy~6uh!1FhUlm^X<7$g{Jee1dlq{T
zb#&wiJ|V%2d{~$+^syWousXb<c7+jG&e5(5oEXrwW3xXo^n4bH-xvW`{PJR9wzl=K
zAj}O{?O)VCW)TutmOSaxKb};5C=Uc77;eViU4y_tm;Co+w#mudDT$e1`w=Y@N5)>D
zTLseN*yvM=V8UIOBh3fRf-x^w{AgFtjF~^zq_SikJqIet_R1B0-~4_p#Qn_TESo2;
zc#<<CcMkiqvEKQ9UoF(ZVuzHonHq~{NkL%#6Fsc`qs8#f#PGv4;=1uT+EKtdl@@XP
zN9a8<08AF7Y=aC>Brz>qb=iyDSf3k3cOlMJSq-!$Z4zH-min8wbcMm3L3{M?dGtPN
zq6^OU;P#hRg{B4FKTkwU<{mBqT}JFS*WxR89z9iX`<s3=g=-UaRPM?rAJ*{1qFg>c
zb>*=3R3dZ{4qaIu?kyoA<0QwL5}UtJX7B%sW&91%w8W<*9N%KNF?Xo^g5j^I`9%+&
z8++5wX0lY6a+r}l8L^_Eans*d!n_Y=(dWY&J!{*(ywLLbn!$g0d}WfP2p2U!W$kBc
zUc&q{8;#S*Y5`}CEfop3JmHd2KAFAFtkON(-l5~#3~qj|!tem46(IW686y8LTz~xh
z=#(VT6`Wu>$QZHH;=NnMmJv6Nh_#WH`FOhgTu|JT%<x#$Qw!2x4C(}CG-xao%UBpt
zuXnA0RchbO;8N>TNbAc;NxbsB!s&S@218=PyT{4i@(gQF4K$uQf!?D)pmXttxw!u&
zH?j5d2A|W_*MTJ#{W<J48?+oMwrGK%e*OF$9DV*THCl_akx?5sp2fbclJgdbxVo;p
z`@T%e_&#<Kx6Ud3Hrt!+1UrUE*MTuxMJ(UA5+@kVSj)%J7jxJG6Faq>VHQ!vfKC`0
zq2H-lZc=whttIbvQK^9<+^F0Hy12ulog{DAQY1NSffCA}s{$T4l*bmZYcR57KH?`O
zdAR?2{`m95r$c@~n#Mwix)hF>3QA@<9v?K}lMFB78m<9<@l8v^(j?h^_~*ETZ-*<H
z+C=zub-}^g!>@eBKK6KXrlQEN01~fekL4&haeEvN;LIE(eV%duwCIi2$n$--7iXd4
z*#UbD97b44(fq6^+y(&YRoK-uDvQ>q_Wfs%U_Y+qex3U!i+g;j0-#b)!6l2U1>O8p
zP3pCg%xa6|bl_0F;SYb<CX1J^-A?GlE12)uV;{t#hGKjw_g@zNZ@igz!4(xbFdBM?
zj%2T0dbnSGf?<A4J8Wb_xDCHhU!+J5wjd8fYeu<hzh1YM-0P(N`@?BUF%nI#yW)C4
z8`*0YcrsG|alsHa1Ue`+lHEFtkJQ&OvSqoId>+OGuiMBE%GOu(T0`*C?{ew+{$;NE
zM4`_N21@iXIAT4h5!619-~;B7WXq<;f>s)@P34k4T~<Cy$)p`H9(^2J3>^^)Y6ofT
zEYNrP-)FN}CqC{V!hItS4X0Y7NOPbbjBQ&uyAHW4={NXPNixyx-+i~5vPpu6lLj}P
zCCeoNE<%sj-Zg5MGSy?%kO~ipd;-KVo@nl|giJTd?^f-feDIEKc`=<mU}eUv)}yiq
zb6?-Upj<0UKiNI_NOGh;kGONf?5*vGbzc9+IW1yu<~zR@A9;a4$<<^g0!kq97*<9w
zQzR_c4P=6~sqO5>=T99f_45TEsc*{!3<=-gRo*zDG(}~IR#2eRU(&)oMCqCl`bM4x
z!-~(I(}>o`te%E}pYq{ZHuD7Lx9{-7A2qB2-JMXv*fBEkB=8)TDtWyBv0YDiE%Y`}
zf$HwikoG_~f}f1Ja+4U>JzIGWe-<$i>e`<pum(&iXSgPzqOTkuN|kPZN(E4z$4IM8
zlV$SpMAE}+xD(%S2A4<Ssf_A}He{;W`kKqVu$3h^B*ly~tc(p_OXD;cYA#b7(qTD@
zT1CtSUq(v-!C1A=jTpGBTP?>gR>tJ`e*XSws@`8?;B|0f6Ad)HwS{QF;BR9nm)_6J
z<{mxMMrAOv+h!3KXi=burs~abn0I92>e@=PLH-XnZDp^iFqit5X6BRaaN}SHhLA!U
zPgZW@H$aH|j~DY-VPQ>{X6IUhMEkJYj#6UBPi`UgzW1?>|0f!`R6f&Cbq*)xZGeaa
zr>%rd5Nq||w*qbb2=`Tp_8d`|Vp2B@x-Lt0qfMN9%jp-ym|_`Nz^-7nJAlMgixweN
zaMDCUt`leKUv9$EV!OX(uKX;Xt-kFOc?R)!@VoMr|NFT3F6G$VQ?=5qOqbC0O#Ls7
zr*(jy2&Og5BRN56s|tE1;KQrNLW^B{vOIPSaYp4^5c3TTt6x{C=Tu8P0QCSKi2l*s
zG#c+V4U>u6icrw?C4#imkH7oaylP`ad;>%Cq}J@xfg#-5oxL$&hEt?LVrXN#V21|w
z9D*B#4>RXI{lN32Oj*w+BA(JREj9FJlzo?OPg(mp%AxFU8o{EDWKH<@t?DF*z;I)w
z1(Z};gspBFOBgzB2No+xpRpO&s8~9B0L(?vWdY`!fC6t2I114?V+z06DfE~5s0E|J
zx0Q5>aH=MbdkWSGynIj^Wf6T|5iF0g_zA<od0Uz>g>Pj^%^_3Vp<mhN_gI=5g-^bh
z+P-k&2nN2THw<d2u*yUdP1yW#FEam}K=h{gtFx@2N{6mK0ta-qV9u^n00t#?>=YVD
zC8w)Quvmo{m=uiH(NnN?XiOsc$G6ErN{h{mV#z-fu?0NQW><eZ8W@asu;0?#eSR?9
z^Ni6mCupYb{q1RmM>!HKU#j>Y{0a~@8_uSDRVqN>3UOYfrHkMD{il1a#b?M)YM+`!
z-gy09-*b&<U4vTm+%xMr3dHddBXX4r-X4hZHjicf;5W$-g0xi$Wkn8%i?i~y$~G2*
zw*tOuv^<|uu=VjLQNs_cmm3X+S1++&0f8!}4oB784eKx&&bUMbr|$x&<Ja*NsBfoL
zKLJWOxu}0qHb9NqT^2<BX8$w{k3U3irija5P#ucA+>ZlSJbeG}xSce`AbeyWP6SI%
z#A2qfhz3F{b&OC4e7)|iW}R{8x3~mItDMG7n?w+oF4upg@1h?hZ-YVNb6v4d4uh#`
z{3-jw>%`bG(88gG=du^IKvQ{uv()-ydVJNvRlU>h|H)?9G-q840f9vQ)hf?j?tCv|
zz3WygBGf2kEGYSF9A`7iE-<o<7sWDrqrLwS$sg#+0`xcCmo9=_*>1rCwz}^Y#O1#{
zhK9!jZHBS*#gbwl$X55X7|Vr|3PGLx<s(|lw&mX<&mxHG5wuRgaqVBegM^u}gnP=L
zt4BYP3ZXwVJ@+0jC}uGW$6)b|X)T;-t4{-*Ys#Ndb+waxqCxEyS1+9GTF4+}=8tcM
zR`-qlC=A@d3-r(1bkcsraZ+p1h%-G-UwdtdJH#KW{JhZ?XPAPjK;rsV-S;?h``9Nz
zqA(j1!kH*jQ|oPzX7l@Od7wY(;f?W@jb#{sa!(%dNr=46wlO6FJ$FUX2$^=wIJW+D
z?jQ4RtNzy;fuUW`*hpgH&aoh`)-8u+3)E$e>x)8Evq=aRy6LhM&cHu0yZ`wps5RgP
zt|c#fafpt<;0>kb5=w*vFfuG{6_BvQfH?9bu_SPam0ZRDSL1VO*;<RLRehYv_AsmG
zd?3oMaO00WfP(d|^Uu3xDH0>4<7BNe4T`hpYr*>Gs&PzW6E&<S#L<Fi=3N8yX@;|H
zKgJP=uFR>^FA7V^BdTa;(2pvI1CYmFmJqsSrI>xYkC!gaMGGNP{vA0=)P>{*#bOCN
ztiyT6l6t;k=jAd{M*9&2au+|hJc(*(FXN3#kl!r{KZSc;ttQjS1JMmE4tp~-AF<W$
zw22%HHLr-QipKouv1s4hgwAs?e7O?HU)hk@yjoxwtNl>yf=GY`-ob}iG&>-n%Y<%v
zAPi1l(H$G)^GRmV@=7s!^HZmAgA{2XLHaE&?WOWZKV%fjiT1RZQ6z@%k}7XrFMy(D
zSP!(seV?VayyDQg&i2IKI-+hhfGLYg_jDfD0%zjlx?pEe2H3)XRYZ#-Idb6}+%+n9
zi9!ylEz|j8uswVDf$A8ELm}Z2;(JTh>D+Ic^E7%}EaX;;J<B`~?I|3q&DQ#{U0C}Q
z;xUt*HtrNhOW&yjuC~8%$4i~)v#mgC9_V$t8{zEL8|^Tr?`OL$-|}x>!=FhvHXW2<
z%}iMBbY&Fd2dI#tS?}E)ydHO>8$S<EOp#R*9=wFyU5X6LrVMv3_^l<D+|29mTlLzO
zG4=?ReVw~@&o`pF@uYOFWeEViY)mEhMtOXje2(~swT=e~F2LTZfGu-D+zkU&N?Kw;
z^Y2SryS(digR{3J+e;~a3}>qkMrDiuZcBh4EH??1_D<^m(mRUXlL+^6C-JiqcyS+W
zjauef7zJuIOILOP-cb&xIw98<#LX^INYviTVX+-E^g_CNx6hp|vzyk*Y31H4k<jnI
zoqH$SWiRP0Gwt-DFe;L>!S*Z`<^0ev9UZrYdj#gJIK-RI$$2(`Mv&r8%V?Q{lGxKV
z<dXUaJL*1K&tP*6B)wnsZ~h?dr4r-%#;d%U(=Q?wnah{y(gKsXwGOZj;~mIW?+H#+
zd`le<T6m>=wQZ-9KKKv(G^DEhG7Wp~E+J3iwf?c^Rs%6Y3Ftcb2I?i+s^PVmn=e*P
z|8cL1bZ^rEXTN_N_Ec>9YBWdlb6pDYB58^en#M1+ek}x1&dU?879UD_iI-)saX5dZ
zy|${owv0;%{cNO>m+j!Fw8Np?(jw1UpTne@n#-?>B3CWkw4gp<7(CRgy7(aO6lRrI
z@XYZocT{QDKQ{%4|4&_X-cW@lnwGBGG2)_l`+Xc!;D#mU*CF<*l=KDb)R84yQAUvn
z7Cf^L)mTGgP7#@r2_s&!@0|8pLvu!J-RkO%SN#j=%d3U_=8!_jh!mPU&eTmxuIkE!
zLMZKBadj#Jy6&W_A_EFhl+50A?XI^*>@dDdZxqdMs4ywp-g)&7hc&J1zz21>+>J6c
z8?jW~HJrZH?Q?0XrBM;N|6Nmc?L5|-=MoRo(BpT30yq|tisAD2`!y#Nx{^R6>d~BJ
z`^lJ5_GqMsK{nH;Nz1E67F|QDS_mEw>2>!-vAsuPUo=cE#7PC~q?PSx^E1e_!O8E5
zub}%w9eUfRnN<fm$#S+MvFXE6m6yV9#Hj1Hxek~th_`9zPnq{M?hpA7V{9?DC+t4I
zvi1ZJL*ez`tHrI(+%vnMP7mEMa*>fFB;_H_OxPDZV{mia6kB_^#FW4E!Fi-VxN*a1
zGDSd5<boDQL!<a&O=={nZHVQ=pZhg^Q`5>cIaKBpbUOJSFLzyUMSs_kl7_5`&vkX_
zO6?1d5P)$=t|=@dmD1M;rO75UF#gc^lNlLgkuUrSn!>tSDNyo^nZL=*7@lkucmCv^
z>h;F_Q_dRu>_ahWqTxLMhp6`qYU=x=y#oXY(v8v~bWnj%q(}=*ic(ZmsssTMrGr3#
zKtcy8p(wqI3W!o{hyn>6q)HJ)O6W~VLXiL=dGh<ubMJkTIWu{Y*(bB-ocZpx)@OZa
zGj0tS7P3`(fNW@GnZuqwM!>n+zJGU-i}{yNSF?XGOo17nRSt4P&$4=)ffpFn#O|o6
z4@>l$R(urm`;`3?L!wOk{Nm)Pu3Du$?9})+eHH4au6ARBRQw<ZgvazK990hmpr#nv
zQ<kqh=?QqtQv?xgoG&O^)-p?#Ax^Z(pJi(YShWsiwFGeg!Lf>eW)5E=hz=1qf9?q5
z>LDZi@vhi3JdLI4+1O-G?CEIUWv%<RkQU`<eYQ`#Z@+1FuWf&7s6$b{gxBBiyW&#7
zdTE@kA78XkeDyvf=@@C&{dimxvE`YY->lY+nJd<=DZ+{j=A#obJRiD1sstWK!<W>)
zc@gd{I~>FS?|ef>7a(M_Ld)_)bF_3EJ-L1sysVSe3sqSeZe%Geh^3kj9mBgUbL-w<
zd8-fW2bRKBzF@ne^x;JC#)xylW`fq+7q_3v$H#u@*EZxeYFr@@gD%mRq<kmyvbE4&
z2)S4@-ei8z>m(wX1(kC!Ok-B*SMOwPOjfB$XTtgM@VEU5JoYY1rOe%?DB@)w;KPwm
z%4raxW9M9N^1+asJi+;Pbm5){Q?S^VG#yKW-(QA`0gIXp>~Jw!XNP&T<+(5PRe!Yd
zPN}n8JD~K=vvkcU+jSuR>L_^d>bq3m2)N!K+gBpB>(Oy#3E3;=<EdhkBCDPM(m{oh
zzr|F7V%9M_SQ-c>p11kHkcH<FdNWN^B{d2=>zFUT3=&9<|4kIadW3cButhzqK)=0^
zTlTN;(d)uT^^o=jhFW5T83@XaQG7#jlf`TNgY-JzHSNq&DbH?C+%Cezho+XLR4nw4
zf?H(Tf0T%B$Lh8vE(Tc83u0KEb2J71r_x8dsY+@yC0-~y>+`nVrC`Z*mn}!xmNz;A
z*8WiN52HXT_~8qeEPQZ<30tG2_wJ7u@EB@qxF^@eeoTMHI5D~89C9wx(Po%0DENqm
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%0D1!}=MW?S0J2sA
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%0AS0*vR63sXUHXxomFZGyGQC5AhnT5ug
zh0p1?MxlfKc>>D{O!W_6^5BC*mU=~?w6-AwWo?ChUl)!M!?P>F?4cGfuB?B{eu-vk
z6!hm-EEF<KA*w|3-SO&IMt`Ma1xMOmJh!T~<H{_Qch3$Ma)PYByw$e+;m@bK@>;QF
zrU|lHzgN2Ut5;c60@{|hW9{JoSljosOYH+*)mwThzYp2Dq>^tSDfdwz>@xwGX6`F>
zh6!1s{)*x3JzlwNd%*&_$3f4)3iaT|U56K4$vLQ49eBswsDv8s*6Qq?BYpdREuH0c
zC&3%9VmgX1{Qq-?H;y>o47YPiTSLo<zHt2?A34ixVW$(Zo}MjUb|+>TFU+Q0Q7iuO
zr;3`YnN(^a^?fZUTmD$q>7mi&fZd6VGx71|Uw)e3{o%3YmiMlVOqBg_zyAu%7XEQ|
zqt7^~#Du?5HY7~pxJa<|)5;C4gs4g@gRBDD*;4FWFU2}~`O|-&uMjt39HfHQ->J%J
z)jT{&LeHdBkbl$hOk22)-GlvA22O}l`)|R#oaB_XBsUH$F+@azuiS_Sv$~$8dQH9G
zS4VFBw7ayI_o)S6(#f?c+j<{T)`=3jI6BUJ$kIYu{A%Xx;vWUppakyMErWS8wvO|(
zg@^Rh*klm{@BrGhHgvQ6L{`-A01qo2_n1+Z?(g?D62i1;2cZMRRiXANG3n`S^)inM
z=_o2a9wI=4koM`B;3v0Bxokh!wV9na?uB-$LibOC$UhQ*nIMTp&xbtq{*Q|o7i7#F
zy0JX;!c+AegTAB3U^fX=J^;2fOX*>sCw5UrhuPj5)I(<;v6=W^Txx9L>Q%(Xo1tP*
zfZ_Z&ht%spRI8HR7o|}!smLztGUc1~EraCV(sSy01(hoJ|NBynxUo*iZg01$g$5<_
zvJKMYfp0+Q-(rLAD8W_Gdi7T{laN2T;;lCrz7pm%1X5|8q$4rdthNI}MhPI=7sUl|
zZ7~PQEq6Vm(>L!F4E?$P8<Y-va(f*e^hvZ+cM|O-1zqO+ftOzd>`#gZ-4@|!RN^jk
zy`bW$XsQ^u-dBe(OJjRe8dKth6a}pd0fG@%{X2ex;0%vrbhI#9@x9XYL%POZkcold
zkV5m&_^CZ~<#k;;Ab4JWqeo)I<A!f{&G2^tgA_uaeL;LOk%8KjNqr8gnxikF$kO8F
z03~OK)}JLx3oXdBXy6cNnGPEqEpl+o@ho|OU|o3V`-P!@vLvi7O~81<sHqfn&=S*K
z@tnQU!1jMzj&etF1Od2#@Hjw4zz|ctWoL`Xhs;Tl<pY_gndDL&z5C;#(zAI{IB2Pw
zP~wjQedvnz)miUR?e@Q(q#^nFH>6SLcG>kvrE3`PYR+I%+|5%3{vM6$k@(jMi5Cv_
zbhu4XU|PO{)Ns(oh8AW1kgb<b-&=z%&+oRutbR_yIVy0GGFRP&P1%ZXDY`uV`f}X?
zHHc*tt)m#}MmypY$;;g;MtaP@@a=lnC`cYy?*Ui=z!XvDh78L8gq;+VyDfGztx-Z%
z_7>={X(d`A+VcFd{?Q`@eBP>;6_gItadeUZO$a;y7xBr&-&ZmxD1;a_@~xCF^*BrD
z>R8-mvXC)&eU;D&_7-<;+Q+6JQ8-GM_&s*Op_V>k5#wYt^K$&*K`bFN1BlcC3A7=z
z2kab^*)IMvd<2)pNAk2a5{lm%o6_6doVuHTZMe^F<Su*X7i%0gEhA$kI(&ck&PBZm
zQ626tOuOEt=0zp^w0{Vi=C-7J%2wFuI!`CeJ|_1wdGclDbdz6icYmLEhTfzck$_?C
zk&E0_x-JVlvIk2=?7%yMY+795Ib|X*&wr|^s-Evpu8Q!mG^D%{z9TJh^44H2P1ANe
zwO~9dDDR{qt_v?;wjvk*OoRf>$mMTINMSsm9ii4)$$uivur?0<&+YxALn+B=Oj7Yi
z(NP^hxf&8*lyrq`j2&LT4EEwVhEL{ISN|Acl0;aZ1A&u#S(ZtbV{1~5i!Lx{bc^xY
zcG@AMu(xnm@>gngknxZ&NFIQk?K3aZ%!PL)<8rL2w4)C#`y``UxyWRt(A%_R$C$5Q
zzr-nG)UZ3#tlmzF|Mg#9uj)UrnHenLp%Si_!QBAv=U#@n#F(2PH5%5nmnsw<Lz;@U
zY42q%%Yi>wTV)Z;x@9@unL3`IYL?wsi-V8{+nlVi(KLt#nCH<5*R>WQogUyl06@ma
zumBbfkg-(N)S!<@lR;)iTu{g#KX>z*J@*&Jib3P_hIxg*>N(Jb9l>N0J~f-|8a)FD
zV+5;DUyVpVx3~cu9ZLU1d7GsLygG_Sg7)OJ0PI34bN>qZ(5Bv(Rnyp_L_V0@)<9#B
zQZRbDx6Ij@2DrFQU7kv=Tk$319P%O^+yKZ2PQWNVYVOR+1K8`g4x_EB@T_G<0{B3N
z??0n50h<fFG%PI<z}0-U?m4k-@}SNA_*%6IE!|X3Ggu5U0|G`B7l9kD$7i#H_MGDO
za0r?BTFm1v81bTVekgzM`{nzr5O4~qep+%&DM;fW5>UxU|5koo`*=Pp*)-A{Y5git
zlTX$8YmGqzgX`tDky*)RJ;DUgWi#aQy_kboQss{&hZf6!f|NeAu@4CNYty7wyPSg%
z5MXlD&Ac3#j2ZOm0~x~vEN2ZEs4|X<h?RDxCXb{9FB4q^+D+V9wkqLP=*&OSrd+ae
z^26lhruH&xLiouR?a@e7SD#VlpxXoGK-}3`Ch<u<Gy3C_@5ueQ)?Oe~BnV3X2#WYS
z&@d3~eTnvCi4VhZFs(#pdNLR-D*mK1^O2@RWAgh#V*8)>jS-|jOAaNj&(|G3n_Y;C
zD-se1(pW=OZ6zY<wH<`m393Do_a#b!ini(+lHw}OO)D)J^whO=+Ay$t;A>hE^a};r
z7rlh>0YC)W>AMjGBee>zbLagR+gLG<$hk(OamT#+pOYx9#6nFL1Oy6g$=jhfTl@5{
zlWoNve5->*eZNKHyBK|20z*Jc95Dehx=-hD275bnFIl&Tp|cbZ4lhu1{t)@pwQ+K)
z7}yUGuvz9C+b0QSX72)Q>Kui_z?<KcZt_*`&<ftji3GTEqjO$56eqch3Ji@2(nr(w
zE3FN(ng&DyTE@9Dv!5a6Mf|U}h+^Gn`=KYc^}^|klv~$RjNf)4#+YOq{M~Oa#!MEC
zjTc9X;E~B`F22}GnePD_EOTWorAs`$26{Ak>W1{_BMD%X<2hc0kySH!XoZtAboLYb
z`5M=<bGx^|fmE!*WjTX)M6wyno{+uBn+|Nc1u6Miea%^&U-G-vexfFeVekdCi`lbX
zrdQ#jIzB@026|?rf2{S1#p;l|KWj<>ORc6|-fP6hmZ-P{?t8X}RDj)ak5KGuZ;`g{
z$Cb1jkt)}gE<S(mdQYBB2B)QPjsyN7wGEi^oy2xtzZVrgM0rToFkBX9%D=0&${{8h
zqCH@B_of=~3$ji3ihGWK6up>j0q}1VjfKuwPKk%qI*qK@=Qv?$lWrFjU!(L=U_37z
zna_UM*wy!x7f8u5!+3yhJ^ryf@?roHQ^xv(Y=}!JjtgKEpozWiR;Wq!Orf|UwB}nl
z!CxTU=eC;bVJGz@%Df^JrLO&#mx(J6`DyFNaeA!Cic6X34W26fc98D6pVDo{$)}Y?
zp3^x2lL;)f;_&GUs3P*-y36%2Z_A;L6gr!=SB5J|5x{8~DQ^{rfA{Z-TB3Aa(`(!q
z=oy6*`{ru+Zg6rbx@95GoMyXdFCzAOfsiDpuU~D%+6@7X=BGF{F3Y%xc%^S#^>=!5
z_ek_5S1u*b=MmGE3IQEpv}u^%2f$_Jx&gPBNDr=H^?Bj%-9H9;r9Lj0?g8kURC52C
zXN1O?V{P-2Q5d}eX20(v{^I$RL$*E_nse!vr^=`EkQ6WSG?d&^uhyw~Zpi!_)Y%<2
z?{!HjGa<-}B`y<FO+#rV)Uxl4(ER+7Jv<4c=$ai7Mq=aqjh#VVKU;wLi1pBm)Q6f4
z|L{np0@($IwubqNN=^!F!$H=y=g5uGpA*vbpA~JoVP;#(bHMNxJD_&idH{9U6v;8M
zY9RM^$rUJO5t0ES!#DWyP=$tO?4^hu#)sY2gg3sQiwPy}pVhz)dwGZNB}7hq{gap#
zUJR>jB-yTg7@QO;e*n7lsYJg|${V3HJBWFPi4Tz!hxR@LGZc|)UAyuD=*o;q>nB>W
zB}^chqEmz8%C*a-=QhBra`&)*LzoR9xbVLW(&BS_v;yhICM5C5Y0%l#Ag4&={6Nzt
z5|K&F_u~La*bz<RC@DQ}-y?Q_Pi^%R1D9b{yk_5j4aO7QEmE05t~cUos1-Ab`n-Qb
z(!^hMoz_TUHEnBF5u)F32)inQW+B96rlKISZ-y}OTuH$+PgU&I2(w@D3Rh9k;KU!o
z=&n=erjp~g%L|(80r$>a<gbfg*OK!640ES5cNbxt2TtgWH#+IRaP210Y`C<-3c9gp
zA8*cg&<hzeE`tc&Y5zBvA&Q_`y3OCw`d1N>B#0btf}+0yXE>9C)J&VP#(whs=<Bou
zj?V*C7xL~6uqpmgZHDf|mh;0N@T*pRx{s<?qS?BZdTFjh^R^CR@p4Bx0w-+=M>uIA
z)?N(D=L>+r!8?3c$40yxl>O=zUYdWKXWg{IhfT!QD8p{~pY#6@PhTDm)f@Lcn=#fI
z`_9-)#aKetv6DTLRQ5H=nw=T@kTsHhiD*&QLW#kMvX(-~43b2QErT)h_&v|{zJJ`;
zb^e@lpSiy0KA%<OD($ZU%j1J@H2U0{7=}DP&K8v8DHtKl(325F7S^Q)EjhrK6tzrr
zIR;$+%WTMrjb)m}(*x9XJFxf)pjbD&=MhErJB_#~vg1~JT|FK_PQb5g`JM_ZZ?xVl
zvqQ4&+qNcD(mS>d7J=fh*+KX6nF)s9_n)dVU39MaoFO54+d}!DlD6ghLpNGTk;oy2
z7Y@ccBpW7++c1RU89Oe5Z^!~~q&>_xN?9h5N?SwFX&zFCTk~6|k))9LCY{%1QY0V{
zIfehW2L<gPfV5pLebRVvDz4vu6AY8p%Ly<tp{$7iV-3ZiFW5C(i{)LgE{vDGuHz|G
zN%m#Rx-MoHg6%6i+>F%Js$iy-G8qNel}k4g%jsMc*%~G*A=3+6V$J9~j;!!H4M;ph
zW|L08$uN3<#>S5mo%1a>nx7?t5!_c-0jgKSLb5uH4N|5qHHz@KG<_3{P?q>41?XB)
zY|MGJ+|zNUE=BTrWqiu&_$%#DH$|^0$bHCc7*!VSDNBYBU454Ja9XJMM!|8{uI_kX
zcLR6&&%9^<K0e%^9eYjcW2L3(aO&Yklq;)T{hNbvGVI4O`=CTJB(X7d;&0`X%5K)j
z<qcp~a}qBc?Xh|vUvo*%N$cD*?fS_eSCr*1nY;L%j#e*jRiS^!F)Fze*TS|6g%KUS
zXP)>mbOnOSB&1@^|9Y*r-W3h%(Q-BGYoN!`*R%1L|LozS-)MiCMRrmc@5XhF9u2rF
z!g0&Nr-+*8&}r)&-!kdI9B`bc<L74VW;WppRiU?r`g{26sXaQJ{zWal_V<vAl;T-+
zkZ4*vc6&7=dAT2cA(7jpn+E{$UDmwf>lDVH!F=ujRPW4y!A|}({ec9eQ;!(V7)mS#
zIW#W0!hgI8!sD?8hknq%-xzR;5C4peKVLL@#epw;^GHvD-SFTa4Yu|y*CNpM?(_+{
zY<>Hub*ebv)VW+aJ`Kl@#)x(vYauRV<5B4`jy$VwU@~mlGA(AhG0$i{Bf-n&QQ-F(
ziSV!i2@5v>&O`)^wNm^0;=?e>b~)Bs{0W}T{M>eY;)*_RB=a|brwg|S>}L}|`YamM
zwVc30g7>H1xrX242PV#ipdmucl3K(_owd}P+M$t>HP$(hnVNh+ql^~giM9Ur;KWAS
zsr%+++b*`GSikRHij?3-MH+mC3|lD0#78fStHU2MF0j<ke|~b}5v-KP<sK`5eG*cO
zi|F1n)w-r6*_tWD;&j2To;Y+t|MkD?5%lq52|+qH{H%F5<Odgz_-G5N`K}FjWH>Ka
z$Q*4G7T5R{Z3yLHG3~er0AY98p#BwzP%P=;{GA&Xlrvgv<MsG6=N2Amf(O~1p|+iM
zO#4S&UJ_=S+rMq>L{o0--bA=5HtOf<hx}d(GJg%@DERojyVa6%Pg)SUft2!s$yG;C
z!kosF01r`l_b(6A7je3`9fi-$-stUn{sq72{AGbou!NP63Ch1;rsiK+0PF1e|J|g*
zV8wuhCE5iD(Z&i<e&n}J!rc%f;f@ByKIC)sy!g;8zQN)yTw$JJO^guDK^*jdC_69j
zBaO1+t8FPF{xB*2AWCC@Dg2nd=i0(^B7HMi!!wFa_{o?FH0$yCg1kUbvJ(HrB0$EM
z;-A*O^0JIeb|UcyiFdlq_xhREAaj8g=c)c%U79Zv@0@EY%eaIRb+{+Rd8vg9HvpXn
zc5-Js?u8ml^^oMmO{WYJ148$FmLrr475y7jNo<V|MGv<>G*WBkvpXad4qFIY8Q7Sx
z_m$z1|E?=8!WM@zH?rl=kzW1nUAlVl)s-<0=E)okj7dNO=pqI9c2s<edG=YmCb>?M
z<lGE_P;&9IReG(y4TR{QA+`PYR<ZoUTDv;V@c*hX7y7cxEVs`u3C|NI58w8rio4EX
zIsQrIecg{{ZofDablPQz;?D9^2jt0PBm&>>_8>q|D+|71(ZOvUwrIC^ZkO`HD@zFJ
z*n`fhi#qChu@SOz*SGxlE60-pzZRHnb$gJUVwtwZu~}w{hhKZSC;s#%5AF}#Sv+KV
z9aUh>iR^;y8k1%LO}Jcwf8VD<@NbJp8Xp|bTRiLce$rL9Bi%?C1&4JR-eN635ywVq
zvjPj&j$A5S{6cp6P=g}pwYnHROrA>I#TVW`_MVr7+3EDWLg1ZaVTSdn>q*LAiHo=n
z^~>(VK=SNM(Q6+lXRplYE7acSF*mO827H(vbJ{?ckZSNyjvwyN7VeY*P}Y9MgJ9*t
zsPZ&!LeI`b!u*sRLR!9?WAbqC?rEFrq84l{^k4?*A~8PGQ!^QvUS&EDwTm+rNaWI%
z8ctOQERNxJ<!{p9Jblf?q9Sg|il_t?pHOMBu`2$Z#Q^{;`^(Et%!Uk4KvNO=(KJ2*
zM9!&Cf3zo$c!ax{@nV-@zeG^l3_1_UX?xcCZ3`+Lx|4o0Y0$Lu$hymbbt{#)k^4RN
z_A=@DGO6b~UwW-WWUN^x=wV8qAc4ZrZ2VJt$NgS?K(~rj>f3`s47etei;OFSPS4)@
z+<S6<Io_8=CRg)UKul-I-~O<^CAI{C4yH_i$;+B8lbpzGPQ^1giN5U%F0zn!XT*Ew
z#Q&NyoH%2T^DB_L`1N<g*6;d2x7%62ZL3v4;cZ8*ChaSjH$)hn=;$yR`5@@i8*uSo
zglJ(ipJ6H*9jE=4<s%ma1x9>T8r)0Fe0ScX=f}yNsyQrae=Tv4beJ|P@|G7~)Vs^2
zKgz;S;By)<UaAQb3Oc*K{V{^JwP>rfXMYnon9qMm@)y(<u}OL^Y<N020kQY~e5RFF
zsHJlqEiKoio~*fx`-KlC?AD2Cxb4<;D~5V(vk(lT>@Qcxju-C<1%Y%v+xfhhQD<l@
zjG?AK9O9KE7jOML79Jm?fu*h~L3;OYOQ4xOn@*u`rbR+7#mi!vN5g)m<S8&^vGwP`
zC4C;s$bxZv&7B(`J0MpB1c72$>pls$b75Z3&+Om>+Da_=E0PrLb~&*%XLt_R?~|vP
zJ`q!5+d2L#FrlI&U}b`j{rVb==FDlDF;kh^v0-NG(6}I561PP@pb4rS2{Ktf<;>1r
zez>80KuxD#+O7beGiyBgf#$6T*Qyp;bwhl=@KD^#+N(1iRtju~-CZBMVJ#Tu^70A~
zz1lBqi+@!Y*>X&@h`i`A7Lm*XbMo2Sv`&qe0rc1pXpUSM?cb`BJtDOyJE*BBzl}z+
z-C!<*-vWpNb^En-luOGf*-D@HRQUQOFkKen-;7U_qfVMc-i=Z)AmCbP;pBX5ysR*S
z_wWMyr|8Ss8~$lzVM7OtBwY5#++gHqCH7q3q7T7)MpP><15N6T;o{M_=$2QUf92r&
z*rq~mp<w3h#)ou7w|L~qXxymmLOAS@$kqX5def1)AM;r+qw~=4mFv(3GA80!9#P84
z_X^Rg5383>0ylU;fY`&w4~9-F9{jedxc`^~#9h}EDO?>5xyki_5O52$!*K91I;}`O
zcawvQwK3xpvGU}71547lQT*j-v+#qPZ+=lKHCL(V2KD=35b~<U<Q?gy%-W(QNOo`h
z&llb&(^#qaChGarv3v{<CiZn7U9?y0_6gx5xt8YwE4z$ipU>k4BvVzQljnBrrX#<K
zycky9qZc5H58{-pLpK$cTyK}%mG&2;h^LM#ta@si6AqTV{=zwN5e5cCqCxd)G!DU=
z&{^jdpqO(<?{7}5`>)5Vy5)b6F!9WWPebm-|Kc{9I*ItmjOUNP`M!eA7uPf_U0Y-!
zIB@V3pMR8l+KXL3Xvb0ev&u4AA6buIzYI&eUL9R=lT8>5ZYZd|Y<jJK$&FHYAo{N$
z-!+!Hy=e8UNZszax0N%dl8k+RH7ADcmx*GnZ}C&CJ`-8L{!n6T$M%ZevD62%Z|kfK
zE#SF*M&><>B$B(7aW0fU7tJ>%)z=Jo1#qL&4&EPdINpO|84p(cll_hrExFKvX-&az
zasEHnY{xcyw|qjIHBavl2okI!y`5BzZEBAq{><_3{Tu7j$g#+T(mzLHO>{2z3V<eR
zus<d9ekx7`=&Onhv&cFA0P4G9*_4`wStZ-_{4iXeK)zmNo!i<;V=17b3Mc8Pm7U#;
zMPvx>B|ZHtCs}(hKY(P}%a{u3#kbp!NL*bf4i+iLv=ZIrKadAV$@YGNGH&l{#`99Y
zntCcEB`;r4f(yxcDi%ihxMa`MT=*?k@DD_K;ebBD)SwZrv>cis&u__sE78{5GCU1t
ziuAB;_SePliIk$l=OHSuivjN^^WH?@Qp_O>>!+osOE6Adt@uAt^C-~$#+#S^>JHBe
zSk$Pm-LyaFd!{aD&~IA|GV#5TQJf<m6(XVJDSEoRqy|qX9f#0li7sYz=CiHqTqk>d
z2sfLJbH4WaVO6AZcf=AzwA*KddUn>|ukn=Dg*0mj7KzH#>B|9mnrsn9z$(sXrGqx$
zUCF72gI2`;ywWC};0#G{WX)ExHX&@aV=o6bQ9Jp+e$m*c!ydfBnqmM!E~=b^(wcx$
zDpCf;>abg7^es8@S;9`mjP<RC{XS<GiR}#a(=aqQaVx{Dy(LiQ+Q@3XkYfbQ-r@p~
zG;M14^6+PJh3nnWP3c}`Qh#?I<%+6?+~UY$LRxJf9d>;`uD79RX26X@UBx=(kgHj`
zLPsR&;-ef26VJT24~?avsCV73q<MQ<HQYE~Yir5yx0};j@$1;|$J`2r_@1DUm2}8n
z#JZB$BsJ^bJ9WnWwVy(7g2oPsOdXAM$V<bX@^}S7?tEj}1j#juDDa+NAeGyQJC4Dy
zMC*A8<5f-SO%{!EEdJZJSk4|l`q9Z-Vedhs>-z)g-G2N@f+f9xSB&l^XOkJfBUDZZ
z3{a+*`GYWgc`~GbBkh@}_TS3CXIh^{dP_wC9+W;MK3MsX&*=mrCnJMg#){QG+M`4#
zE%3yKOv_jF7*a;qJ!9p$g=WAbfTC*m2t{08_FnOR58mqE*lCatm)Nok_ho-kKuuqK
zPH#?-3&At=?x@g_VPmc8Pr!aW_P*{q=efZICg0o(0X~~1_PV|FbXAf2<{^}#aDa5I
z(VXX=xGxSaFW8tVz1rO+@zg@5;1%&RrqBAwCcm4UX~InV#i^D+eR(^_#$BTMhCA|6
z63#@b>Ee)T@pm5ETKy5mj)(;jJ?<u?!cBy+vW$|>;C>mz+5#RRw|0l^@wHHw>D8i{
zrt9no%G1jWU5q_nAGwe$_VNR&R4F*w)A%%O^n(QCy{~WhQzF$nMg6+VYs@N=taQZ=
z`qcPZi-rUT(=$Ge+<s{PygsV~1rSUzy}9mq*~ShGuGP`!0WeCR5dd>Ro&ZQ5aDXf1
zoMApMumYMiuq|iWxI(sJpXKc<k37Q?Yl#ziD495d+UdTOWe5f8+V*TDKCniT<Ovo@
z*cTj%3ZpH8^1?+4{P=Pzr>e%x6w(0!TQm2UtMi-(Nqgtsb5%{ZpRYV{weACy-oGJM
zVesMj>E3l=dzoD8(066>=W@Ir|DKjna?3$jeS!SRdIG{|Y8?E^{@~3oga-YvD&o={
zUfZ!8d(8o(027WV)GC8s1{Go6HV!K04Lu%9zuB%xLn3AYjs%fZum^YRM3!v$76sc4
z*pV5~h!<A!;flPQgy)Vdid4*Re1mL8{vAjYmBb_o`_x_ERyrP%wW;5wn&1*gIAbyA
z0oZOk-}q1+6^_Ogko@8x63j@;f8QmX^?ufp?yLI*&eSWL+j~xzs%p9lyT;Ui?%O77
z6H+opqXDI~*@IclCJY~PJpI`g%!Oc4iwrNuX4cn}a)rOvRXn_aVu>AsgOY@z`|j~?
zgS|MA!mMt|rf^WFD}NO~^mx{6)Ai2h2DHA9$X7j%XL=;1H|@vvv^O3uFV|4&VPS>O
z_?MEJ)Ik@Q+BcR&`377~_qEsu%&QdAg_uP9)HSNLc)5Y3I=eFn)~cW(C(lNabNHlf
z6Ncho$qSgn;8u(|J8_ri@v&;=mnI`CP5c<@qiK+CRn8H@Xdqu%jc8bgNNLiP^O-3U
z0fb$X91A|`_FQ|Ns;9#aYWSG%!Ntw>J_fEJvM9DEluUoASY@7(@JnmZdK{X>#LVFA
z&2B#B3x6r8QcBK-Y#^CP7fWTQKzrUeQ~AgUf6Dr}@P`}Ov;VF^c4cI<yLiW7nxBOW
zwiS6&Yz*G1`IG#ML>`E)KI+c^hc0pnMWs~O#D`FIg<EVN(SLu7hSkLy8VU|v`en|#
zI-Ppz9o*?x6jJv{l`SJDQ4PV3oj=SN@lO?>s2CQo%F9OvqanAvX6J9Oypzn-u7!f{
zN>yNJ#Ik7|uEBN8HJ0Pgo9@$aRwcA|!)5a{@`xdiXy#vi5-Mc1iY-8fy0thEFi2mG
zW-(=Zo<r+?)C)0kR6!Cymv@a4cVaQPx@YScT0Yf~XJgHa;|EALS&i%Dd8CJh=Z#Ay
zIPQyP#7Y8;SRTzZF;(ImEm)tKQJJu+NJS@zPT>2b3ZY9(sm5C%R?aV;jusRx+ZCvu
z-Tl`gWx*1RL$w^TMXnZKh)EL<uIKi$R4?@Q2rE8H?`53ap=9FN+YJ2?+`Xa&bEi-F
z^>=yaTWXZW-7jFLA<^u%GM%i2W2)s4*EXmda@@UeHEbki_n}GxqPVkBOFxiK-_BVt
zuB2Hc?#%GEF2zbJIo<XK&8|J!%7IZPD(N(}nFP*YXBSw9mFc6L$OCDMxZpN~Lh|bg
zHg&#}e?S0}ABdAR8^XqylAys@dY{0lT_5X<g~cva1s4{dWAkc%2^##tiV8lcDj&=-
zWbKYu8sZr$;2ge~sVs;B<ciN0R%j<jJikg`Z||L}sIpGh2UO0L!nJhmuQEX|+qdIb
z+!|(tC|iP{^HNKI7ZpsMtP&25%zp2-!cnCAh`X$$$DT<MHVEb__VD@&@`wKRL6;uP
zI8~gS&pE_uIo}vSK<bc`r7ThZu}J3Wu#pF;`^lL+%M^)@d+s;7_OgPk6AvQL0Y`ZH
z%TIwH)c;{0u2cnIMimo2{EdJvzxR5wm3k=%A;LLG=8DW@qb^gxFHOTq3?lYwCNpd&
z9e#|o8Lhi3yP5LWIAWO*xP*gFNwm>fp0d&Xa&>7t=j@1WP_<ay`$H-SqTTXT`DKo?
z;kcVYAe}5fU6Z?0O`{LJGA+AltZss|rqcl&?cLWZnA$?rap>D{fZXIB^u*Qkwc0fy
z(q--1H6r+|(@Gg_plO`h=~i1e0{=%YSR=7-tN9H;wbWXGpzDh@;7~l9{V;!7H=PTV
zEP=cR6Eh@Y*;{lAbuGfP#beR>DR)j8j3dOBS=%|(Zo#W-#`hBj3CW75#fqn8;s2}f
z`rpgb&BF1N%8joAOixTsmc&;q<-3n(e+_!(OK|m`2L|X29#<7G&RVF#mGr>O`TVK$
ziiFD?2n5a*gTD0O#u>CK1YAx<%VN7<%qmp2AUI;icpWWK3LVGU$R4cn>tiv_t~_-o
zq@scvRz1HMm>*dNb}Bk>6?f>$0eQbnTZ|;HCsz-)CmLpl7JVAxUPNHWE<dQr#dBvQ
zzC{pUWEJU5`*X0cJZE2~{l3IboztxVOniOvAwwU7$qfhw0C|g%V)x%hc}5I`%vKa1
zGvu%&{@rX#+MaL~JARV(3VX3LL8GLaQ=G=Q0ENlWX^@e%)dSW=7kw?0MR;;m-g0~(
zcI;auCAJ&3D}p#v^@^S{n#uuDv3VRi_`wkRfOnb8-N7L+!7l5FgVXCa`O~)1DN|rD
z1mN8RIDKmpy@~^0uaassdF!n``yxHZ7V*aL!GNv5b(|3W9Zp?lf=);|?{c$@Fs<T)
zK_Jvv^)6Mr>$5{*(vES0uh%ah0uPE<FL5I06?Jnq(Z@P2(*h*U_@?71U{)d*O;hj9
z6#ivGmJFoDu;t=w7o~w&gW1uMkNOg>cFB+j{NSj>vbt=+L_&Fg9}r9XWBw^~{QENQ
zW5KUW`)%jqFywdQrLNqS545yCl$S`@olQt18qlZl&yKNr$3D3=X<hf5w>nM;#vy}j
zBX3pNV~53HH%*b5n}Gua2uRx{=T_l!lU^c>#A<E-Z39-k&_DYr(V_S*Q1*{=AYHw#
z;>$Rk056opto9%P$dn9(ZJk9G8CP^cv)34T@!Tc;8xw+yy{oHi9sYD}QhsvFlY+GD
zvY>5xuL~(a1hG5JbFzTQ(^|U?r=G39l)BZzTz`0Z|BoQO=hw}3jBbv0Fh>~;?1wnV
z&n8r?pgwk2h?zrqMwC7{hSbBUU{9n$`P06Zbb5M^PtO!gc^j3gghX;|e}O|Zor;*M
z0d1JS+O+l3ATNzYF#zB5<)4`+w0V%iFuWTLerva)yPrc2pBa9*oJUDOzTyhPyQNV+
zffI)Ha_uE9Irb+9IY+31vY8+M8~1k>JfACipgl0SA+1S@@xi`+A?NH%eG^8(eDGd1
zpy^Wco~w<da;?;O!q6FyuZ+bzc+<6Q80g2Cfa%J^=*7c@lMs`@-{5{rZ;r$a6tu(^
z`1{M=ucKR?L|-sAXD@zjQ%aE|5jTXzo+pdXDLfv6nA?H9GmqYgP=;Xp34enZ=VKDB
z6W%Nzj?SLmjK`$880|EjrA~~F6#V$4=gZqD;-c*f@1um{gmV{Uo<0m8IeO}Hq4j{q
zm>hJT05MoVOZ%norms8n1~n~O8iQ<TfFIZ&&)9?oWJUdVvA(J%sDhV{7fGt~0P+Fg
zMq&r`-iKT9XsP?ahF2K!X#}MsV&|}>)stfbf2S1ny`1%G`~gt?Ye}j^yjfhtADXx_
zYOF_xeKOFanLZb9PiF3}Zq%J{!(fNrNfy1W)uoZKN7f!SS`1U)qn#KYy_kXTkF43z
zPaBYH4R!qFZ_HCoE^Nv07b1~&fn57(Urpw~vyZaL%M&aYQ5vX=j}pE(1D5SST||g=
zbC4z1&0hhc{Ffy$YFO}5kA2|5PyLEZV>NLnb0X)uEI`?2<Z^*PRXSGu?A5qZdeYfz
z4!3{lA2;!-OScIilM*`)4nZ(TV`opvsqCGOXW4(XeLyQoeHpVqb+K*F|EXLlkTY^y
zO+1Pon<V2J$JpK%5BWV#?>|Wo-ms08Cjl9!<B0SGrW(_LuNh-vQ<$GvBI+WW7_WXD
zZUI5oSt}0lzm+Sb(!sK`u9p3R81s{Ht~8n9&+V8h4P}pc|M>vwU4%;0I!p*_()gyf
z>YgLcqy<1Pn#B_@l??tt>28&N=pj-$2hGt}^FjBJn2V#!!6yY=7&;j+bb(+eW=Jl~
z1$+p6FGJ7za|3)L4N&s=N{p!g-dT-Biv=;hmlVkqn>|ij(nrbfgprJb`MYf-O`3=k
z+v331V+#r5Him5V*Af``w~28y0!6SsuLKY&e*)k*7OqP7Dv1#<(;@(v=00I1_mxOX
zZ6X)wd=Em42=f4K1?)os7P@xvzc*r?yZN??qUMn#7w5P?OEA8P*i(#AY}4qMiMA8Z
zwEGOwO)RgNNXB-#xX4ll+d8U}$fDt?M0%!AmLOx#^sZ!jA9R5sl*L&>AuXV4F7vl1
zc-H5c<^`JOpj$B4?|>EQyn67zEWOGTnf1VJggNXT$KBgu^2fyQu`Y?XN^HLT6>yaH
zK3-No>3eer;6a?BoIF`xpLx;UeJm06BKcL+11y7H-=GcW?8JR`*d+?Tgg)T8?<are
zHqqfceEy7D2Wf|8ZE2>h;hxc0nT2i_cFIHI296FkNb-Bv`1G2jibPt}CtN<f{F{DM
zLKx>YhSi5I2gx)ex3Qdz&>a2y12zwx*_9YI*mG@d`?lRZg4SqGMAD4}O6rGf9b$ju
zm#lY8$&hHg-t!kPjzEB{?jD#%UJm|;Vu#+YZLl~T7HNQk3FhrCf`S|6ynfC?1LK)I
z2*#|Uz?WZ3mNv}>4qpkavdh%RbN1u<VS0{wc*_p=w3d%2pOL<CY1`ub{7WFI<KoPl
zrgOz27J3Dgn{yi?wt1~Xfa_c@ER^+a!b#4Nu4d_4ZjXrJjI;@%;bcDj`*6Ovq9oJR
zBKZJ{CMmiyQ18O$WDOBaU&%n~pKplK`Fd8y^<|~+j6}PrPK&5Vjp1Lm!yr_Po8TXF
zF(#gJ@%6OWjhHa+qgdN{2qQFO?ImWIi?8?C`Q>Rjjq#(H0fHqScWs3I;A=mzLII-L
zBK&Cqe8RplwaU>f&@*wF2B~~U1c&fat1Sk#LG6)t*j)e7AM7-AlpVm1T1l4<${JI4
z)<DC3XgonYSAS^}`pGiTjPv#u;!`e|KMvFpu?xR-nb;-3-BTa7&F7_pafQJ>cgHxI
zb;XwSFHr<e_hgr$^G6TiBVhGgw%k#ck`Hm5Vk`l!6FX$x4l*z&BV`T@Dg@HTEa4@0
zZJYWOsgbe2s@UanuKt=U_?ZYf%x_!ZiqGmMF7kIZSuC(ZOiRAODexm!XgljOiunD6
zr59nl!0Sy_f=AX+$j$1Bdk>XzqPhFdz(;;JF1at)C1joZ&9V5PYdF?#`Rz=sXOwH?
zsV!?#xzMU8Y=fC2IAf*4D0-#&>DL9SA|H5?|9*w5*1Y7n8ukM~!@!3N({jP9Nfbu5
zdX$R1c&BRpmoV$^oju%-PX!b9fIeQaCb6Hc>I}X?w@mN0{)Ey>6d3sb=)z2bpbJBz
z&yo&?eB(KqdiX@3L~++2T3<0ZO~ZS`SpmX#=^XedBT=>GbH5>ppOnZKO(bNm(yrY?
zMHW%Q7~}-|8}W;BMPQcwt$*!-L1Oj5OWcj^0CCD$^LE7rF_~jUalQ&_&MGMg2YWl-
zr=Uge7v~3RkN|))U3w+1w*j*D)|_1u983C=;!FJr-XFJKMSgt1jh6&~s`kY>6*u)T
z?C^ZpKw(-sugSP0Jr4fShhdU2P^PZ!PjRG2Z!G{1X|liz1Mp|;i8WxXZ)oj1EIz})
z$BP=7t*aoRJlCYw3lmqf(R@Nmmc%x`f5qdVZ&DW+ky^OvxV0(-S}_Z8<cp5HiO5W7
ziU}pvq>xI3d%6jD_Ib)IZ!J%?>NemrPf*q8A^w!o2@~EwMM`Hes}!t0Ps*n>VMukh
zD>K$YW*|ejrGbA7i%N=y@%F!#L#QK=zI8|#WL2TR7Lh-YtS3mmk7m@NqQ#l<1`Ngs
zc}5o)6zb?2u$XLlw--y$H~h=U&xw0<LDTdom^_@e4dmbvFo!63hSzTiLq^aMfk^-y
zE?nkW;>#7k+;F~bZhOQGOLG5>NdxTqkV;x3y)OeWDuY%zuG$)`TD&0w@U`fqegLpm
zKZO3Y7nxzpAE#5<fE-*2MWIFE;A|_`GQk7W$JGyyiplIuU|gN|4V6p6Z3VsYu8y#r
zRNTHC$Tr~oCSyzFS;Y6jv)BS^_(;m<Ln;i2c!C!t=ju#MM8U3{$N(T)dI*5gk!vP&
zh^eYT6X|O6X>imkiI?}%<Hp3-W_%bITCfDSwv$%Ryf8#xKyZ*O0G(XkoD&SrvV2ye
zjmGpi*u?*Hy0Eo7iSrFQ4>ccOY+?g(FFT$+)%1l=_qj9=y9qYqTkX^TzytT5MjTev
z@xwBAJp)mu?B_=dNydj*e<H)bq*0oL-~!$Eo7k!=hG2*eywr<zz0wZlw7Kx?%JYA;
zBe2{z1H04^b3fc~Iw=X!NnQWHZufP4J~GM>%_+aD^6$40_OzNc{b!nkD^tId0Zia<
zhFel*C>Jd3Ymp5sc2e@75qo;!JMBS2@92N8v^J9Qo|0Ibzi<;9KdP@gGIihv5{aDN
z+Iq=t^koF;?1C4;UGg<5+VM$v0Mi#|2OK92{>ULIG&%Hp%J%kc4$HTN^wHR!xPs3S
zim2mp<Y(W%yJg>~_8(U%<cDSd!gmfunWCH0sz4tcXo$)R1rgE2rub`^L_|`v1Ro_w
zlYE6k4ZdvrQq$c#m6{qSmH?38Ae&R=Bmg5nF5KIi6H~0xj@2<-4<c}q<@w)d?%vk!
z5B(i4Bl*gA*|xs<+0KlxA?F=NhoB|wxxF@OKo^ILYbK=KhhB4aMafQw@$@eT7vk`+
zSUiMj@r0_v0?T`UWg5!%W^GX5YfE0qBg)m^DTZA?5$RL$O&^g{@4)K&1RZ7KB6jHL
z03l{tV(&0g)Y{BInZhRD_TC3f(SG2590?9ZJsJAsCiYgBjOGwP8@|A?Bs}W{S>%1f
z!U}G+fQBB7oN+l5kd@E9A;^|~5Bsy~`U=#};TP?U-m^_BG3Q^4$<=zYY-O$`l+V61
ziqHsv8xsknMr$mkQ_lQy6o(~;Ctl?~Jw*QjQ9|ypgz)5+P00KB`D$LQrn5qBwkkcx
zU@Wl~v6ok=h{SABeP)$lW7x4e!t2t#J)2I8W*~=lt9xe8PuxY#_E<VDtK~(T>Tq8X
zY+>awaq1tP+C|r`9P7wIyoN|bo_e%9$)44U2}qHvT0PovB-5P9nb+>*oF-KYNsQJu
zdF-$%mTRXR)tZRwV0mW(8xF#BeHI#^lUbtC_g<WRO)%r<b0*yT#?o=CO!*c)5rDhm
zU6vX`at-RPW=m<V!h>%`eN5=i0~fk7QqJC5Nk;O}PU9>TA|+G~Xf4>YHU*3iK8h0q
zv_6;Stam`ZAn$!Vp-T!d1I8)l%gdZTL1>uKK&x5Mszn!o<6SWFgOT+p);U>Uf?}br
zA>E8+4JuK`gz}OBd;(Qwf8pK;7iw>UD(i4Y->fz&GeQ-hSV~2#bf_cZfh<2d5pf$}
zot}qcG<L?f!b+OH?&9-kLzip-pdU3W&x(QAEZ3(0d82-R=G$JEH7<4wM^QYroKa5*
zKNGQd3NS7%T<0#d$L{H&PCkaIG;=vgG1vpX!1y3SO{^aX#25(;gW4^=++&nE6*0q8
zhJq*0)zh3P=5~|8?eDfgn?t`Wh9>Rz++xjJ%N!f=3P2|d(T&!C1iYh@2$5de8y})p
zX!Vvzsy%zxCP<l_%5>`v+FzK=CS4bOoFvmb9=CLR)sv+T5gU}%D}MEHWEnAUg4KLW
zMa?yk{_7(V^>oA9N9R5O0d4=d)uL3VR4b`@@+k=PQ%L|u8C^#q{dM04d}X7ErG>vB
z#B@MRo*dtSSX$F?xXRgi(?5>-5M56UTA*<Lg)#$OyoZon@r_9`qJZg;>_+}xOtZ<W
zJV|1IEJNm`qs>EMz45TO&P58DdDWl6DGMBXUHsBVC#{oYOVzO)8qc*zoJr;QcX~G2
zbcPO#6~k;V_CLxe@xz}7R~+>ugMgQE?|KT~Z6qVLjPuho4-)g}XEjv#)<-y`8jm7U
zWxmyK^^U|hNgf=I{-YpanR}@MB@+MWmrSstgy`x5W(^x4Q^bgXaY~NG)}h)Dd3=ls
zmw1zAqr-hI0eal~!$>!hQ>uYPmp?Nw8T$A3cF#V5(cPoP?5g3()UMA8QxUy%FdF+Z
z5`mxsbpEAiQ$6O!u>_nC-rdx-f4u3j1PquKYm&tXf+!f58wC8LHW%hBB2u~OKUEB_
zvmvJcgOW~RC9zal0<07za?M4YgBWQ?GQ9vvq+|1r0#5bPiKFKaV}+AVC~H?97#Gvj
zIdy}3PQ5;+hK3Pi-Tpp(8PPHoB^c_Ns)uiN0_lsnxcewhHT1oAbT+dBwrx77#;+wn
z?U-6UuFT6Tdy2dx7fPpRs8E?Dk?cJ4IlQlG*|5q487<}Wep6Y5e7;3-!~SY~{A4Qc
z^vg)N8dF%bj%akat79UEOdm(P>ke*}IY{+4*-irqdcEfj!;pa1f0S7^^3})nk-v6D
zzteMza_GLOoowM3{BDfBX@AmTLWUe<(-AAlbOM2iK$k(Fd~^#DL83ZhX*k(aIow|S
zjq~1K?j}^FzX3vrI`C%MXB7*xH?!JcpNp+ZlxZ>67A<F{z&$;Y7ewaF*y!;ty@1?g
zsA@okp1(fSY$IP_1RAaSSX{70u`Lls`^73`w%z7SCue+A8sA0=gPJVyH*9u!duW*S
z?EbD?&aDu3;TesNklW=`6n@UQFa18(`G>*3pTg;;EX3}|`cVACe2_4p^ke0rs>pJB
z<PA0n0^mj*N@Fspw|gDam|3AChcq-s&ViE8v)Y$kWrQPV;?(g;3Q}RdQByl3yu&;k
zVr0hONmq_WA9iPIzLIAM<LL8B{^F>)1r)5%_I2;mFh7Ak$D2Y};{tE8eolz0W$b3_
zTJMTaWcY26zQynRb0Tf9kb~2M)BYdzkTp#FGA}bRpceZAB4Lca9O*&y==<yb#ImWo
zC<gIWN>XD)qFT>VO4xztoa&rS$pB4Hd;Voj|548<2}-1tZ+4x<qTf5BmOowZ_#u>b
z2NwJ>>pef?U;Z$kMxs?G*TtLzF;dp-HWw7ZfxCI?UHuQ)%%*fZ@fQ0!!FI@H99=p;
zG3+-5BB{P^G+3qJ)kWn*2aH1MHSa2{>5%<9d6c+F*qMxZ8PM~I9Stu*6rsGJ$}Wba
z*a-E-cRd0}gS3)n59Xn4<~uX-hWBC(^#_0hPsvX`hR$);A1JJnlcsf)DmP|~804}a
zjKhFy^dcRb(2v6IPi=UR$)=QxY?#qp@k23v#)8eyKzZ%Hivsn*{2Bz%OyIN%@L(v$
zI!j1#PZ_t(e+td&o}QsY+;H35xdGWt!mJ=$4yW_<Q{&#POk@l;r}Y&D$%#lo=kP)}
zU_VOn4b^cW*e37hh7Atus53}qJH}scnvli734Eo5xg(Ivm_bJg@V9q)tCi_|#2tA<
zF}H%WmvMOsFnFf*e41D!jo;W@<u^kG<6ZWzTe;<{j|At)>xcks;!W5Av!PEi<aF*I
z5h!_DG-0!Bj-y5EWH~K7{oHF+k`As5#9^5WVzO3zKld>?4{%m3%~+fooYbBP$P|xe
zIOB;vPX=Nx6J<~pAn`s=EbINB9s)7zK|uWjz%8Vm(F~|WMQ+7IoAwoTGw)V5l<!qT
z)dMBpD`^J}7Hn%pFbUM*zrK0`-ngz$@o_J%vMX7v-5OJX%b6mtC(ia=Tg;P(8Lw!?
zVCRuCcbS{!dBp~M?E?Ga;ZEe6*YN!IolL$t)1O}j4ZZf0v|^#4CAdrP;{X9|06BMD
z$A!#vdmGfl8uU5r6l`VDN#uNB0X6_G!VgaHUntpVx_sZ&M)Im6+OQsk>2`J9GN}pd
zWTR9XD{l)2+lP22dI|pKb~ntz0Rz;9+0Et54LgvMuMV@&0PGdCfvPgv1FaVqs&uS4
zEiC;ketZ0F#k=0O2c?3A6ATH>|2o*AF;hwH=d{iMlixrCLveVHA1XYp%pBchb6Q<T
z^X&Urvj4&4NpHd-F!e);q2bnK(0ezaGnjiKhWl$$xXHZj$DHc^GQ~yymt_smVz;#{
zuhv71cF_pxv1iYZy7`g-)z%1gocneB?a(TbfMHijMX{gV5sk}V7P~Fazt`oIvQAKK
zeQ*BHjJ<P0{)r(I+?Rg6_{Mp*Dbs9SV`IiMQ_y;Z=X1gO=42%a^9!@z+fAWHz9gP^
zLa%pQqc92j0<4i(%iL5|SqWVW@#!`wi>smEpYb(mgL4xZ%K`yv)33`v6;aX-buT#}
zbAM<pr=4nMOP@Y5k~?c_nv)Jh%Nh9PJj}M@`enho?}|*2d0pb7m%#iLjlSC9_ie|~
z;}aw2_wMTwn_O`z`kB=@lvOH2)FO;_+iiI})rFLq`yDCUhpcii)mPn1a8#eZXK*Z<
z72uOz?vMQxeO+REW{iGxv>@Uxt|iU`V~S?>${b&8hlEY;jvQ8!QT9`Agcl`&BZLu7
zBuW?`_cOF{@Rf6Qh<`FvD9kbvJ5-Vp{uagNx17@cK5C*iTBZokMS1#-F~e3wcO)nn
zRL{>=dsX`Delo)y8)`ykn28D~(p#bT;yCm-UZ*`Y(nB6_(64>IKUjMnn6Z*_*Xj8D
z^SjqM%(v~OFQ#+4Fi7)?yD>#>we+LR-oYMPsEenl#RariAsAKv5}2P&rqu}z%gL<d
z!joX`dhB6QRQ4k3oAPJpW3O$W<t7tc*v@v&Zm-#}^?{7YpzqgPEJV(d_yz8>*e3G_
zV-EL@D;+H`f`yYe%_89e=7?9Sp}5lIJ5K#JBZ_!1qW|bC;(e$(>rb{zsPFPfhHA$^
zcB-)?Mf|PZH2WEVVcgZf*3`GR)*Ig5!Z8l|Nma<WRAu-eq~3=-dq5D;2Zd4s@Pg^V
z!ZAa${vFYq@hlHYucv{GI_pkuTZk_LwSpxbnFI}sz8YFE%58$9>63e>N|G-TT*2w5
zdw4$2@j)?rx=<<M@ZKM`t`~@NXWgFrKB!65C{|EfiZzw!Z>mLgFN*X@=y$LxvvIvs
z0uq<E9Hc3RrX3UU5^n<6K5O@Rcfskh9YrR1QD+-`xfLM$(1PV1(EnZ~)zBF0tDU@c
z|4>oFl}#{2b?mMF@bV-4{3IWQC{R1}$t<tLBJ+#KS3{ni3_bhAXAD<ZgREDy4K3eq
zBP^xuS)+HmBPN&ll946sxQ1fVl0=L5e-}xQ&&dSpwZqNcdW)}z9!}%mTORM9z;(%8
z!lK2>j86GXlYq?!9-s6sTM)O8D~CU9dJ>pk_1(4T=Q8gHX3Ja?!VSB&wxm}6E;}uT
zE%`dFlvH!3B_FAzHm}dkbju#`+hCw`t;y)$y|?PV{E%lG;dgCLNY(_#pm0~_6!WG-
zH_ew63zTQjqNL<{i9rg<qeuHm(w{Mb^6_;9)5-wK)eT%&BPd%ZGpv!UBfc%xYn@t_
zpbK1_3})zea$5yR9vX;z{?S%k^pGOeXQhS!oCKE?2)(aAI!N;tRmNwI#fNKiTyYdO
z3@^N#$en+=c%gGYyG=AVDETI!qA~Zu@f`EKz->5?y{3JwZP%44#N+gh%Oj!yyfvAr
z`2&SBY${KBxsHFa8~InuLV^U^jc22XG(_VP*&!doRt+k${s1mbhrf;^ogtilB|Cn~
z!%UOE6r5^l#Wl>cDrxk4M|p~mo{_AwHhNBIeH5HQUP%q-W^I<B%VPt-s}WQyA3aCG
z`qYI4D|fbAmA_Sgxi&rMi#=U&x}R;YLB1Oy3$DPP=S#IQZOHsKcX^4?P5p8I2kqdv
z+d<mB8X%QE@$4b!)+ZTTT~adF2m9g=Gs<>npY?D`SfC9eUHdccGKgAeKN;7#814O7
z&(!&BF<#G+v0Oi-$(8#x-dc-njjGn=hg9D!fG{Si8`f<;cX@bEKh>=QK)hQGz28Dy
z?T<YtsS0b9`X&ue&;?=3WP<3sH=$>4XUdGR{FZ&k(|`Ca0wTDwd0gA)6W++2==Z#G
ze~@38<;IsUz357Xgl~0sZ{|s;=beT%uM5o3y3NK}*9lC_qy-o&+ikM)&wF#*)alQx
z!H!e1q*81-4g4)o0aAs~NKJE&j_yO2q&|M}7S`-<$0_6^(D<SoM(Ojhwnbcn0ASl2
zT4a{`@XW?L^J<py#XClPJqoO{dAVDs@<yi_OZ-Sai@LS}X&<I-uzR>r4M1F?s*+6B
z<Y|jMrSVrai{vMcU(=pTiAN%zo;m}i1wOiBoAbVX?@dSgfFc9%KmiiZRqo6W7ZXbW
z63+-);S9s770iw`8mZmZtIp-3>W|?ECy2DHndhe4#)t_%3ew~iBgwG@@G7kG&CyNz
zskm3T#_wUm*H`f(mw#$J9RI%4=V*^aJjGtQ1NQPRNWxmwTVzGY(o+rloUMt!Y$FXh
zR@wT#vf881uzWX7Ro5Fhs~j;3`!*Vs0x>JOgvzn|a0Mc}2xY7#N=Zh%6gz-XF7nll
z?M1Y9a*wY@Cj(4RF+Y{W7;5Iw2sA85<p6go@>?>T)Plb&3aam<oUSzHn3BMcOvolF
z=7a(3e2Y!Uv1DcuURTMYxdE_Teg64$#bkmG%m7fr+hQBQl*OcpT}-jkok+;hpMG(h
zUovLmQHA~mCA32|<JqsL;$<*#FZw+x?_Vp~{7s2)Yv&QoH(0Y5-M|g{F}ZX0APbZr
z?;EoeaSCGaGDaz4``$UoYHvY7;ZcZH_a=S5f|~3<1`9`+=bdl)2sXUJ>C?b8jJx|P
zzxda0Yd+=Xka!TUjB_E&m-s77wF6o~k19N6`nx4bB^C^4mCl;wJ(SV=DP>`83j(sM
zByLuW9nui2Am9Ht*Ia*Rd@Ry99dwl(6eb`KaQLH=M08AJu(nkX$6%_iib)&}!GjM=
zO~)0xU9;4vxNesDvBW>VJkmvghIoMFf52{5;?3{y(Yr}sPV0?XCh4DNQAF0&yJA7l
zt5)9z$u4rJ{IRx9Kac(=HGtsWHcZN`NGBe-iC+GgtYumOZL}CI6dp9H+y;?_tl^g^
zT!EU8o~CzkYALj)Lnfp=%+xk{6XW0t^!;=ex3^J@et9EcfY%AvlUr1U;+?035~4#4
z3Kxx2r&s&r-Z%w}2bw86Q+HG13qC(_om;Jb#{bzJsGTQPdwbR^+HLP!vYx6^ZC}e7
zLkot{;V)-_YnC~Y(F6vHN8sq4A~NGEksxW?IMc^EQUXNXQ>JR!6w_EevD?^d4A2wA
ztj9R4BuaNzrW-t4Il8)tQ&%W)6b8z1-sr`1R!b+;l$`yw_u}7xOJatnQj>wU-Fq$u
zSG?1Jxtar_i~j+t_=r@&fOQ(+yZXFZqVM6AVQxH{NpiP>5nuGDvJzd{Ctz<X^(&vo
z-iWpCZa8>~W(HM_N@Z=6g|DcLG>aoD`184p!6lZvJzUc5zJIr0QA~dlIg#f^c`ia?
zD$8?BRSJO<UdWd02QF;^mBAds1`3l@yFMJ}27CJZQy%(gsf*!yT-6zQ)8>vJfK1;(
zCh)=K3HzQLLaZjl+#nasVrkf;_b7KcA)_@%ie?}%dQnXKwb6K=j=?F({bCS$&oZ!2
zQEb&I5*}Tc;0BW>1w0D`rnHpTSiQ%W?tQw=UE6OJz0%*53lk0L4(lq`C1foAG#4~}
zU=#>g53EoW?O1Y0vTnWeSbR_K7j{K?x5SGN03fe_M_*rvI($>}1y98JRbY;w0+bu)
z5g`tPOAvJ#e=B-A=Q;LCiIL(nUkk2k-IbjXwz;ixar0DMiPpv*jro#NK1pGd*(V;G
zf~z!5a+r3jnughv2FT~<LO#j=Jd8!OtuF#qNc|UcJz|Ubzt;{;F&jDhO^~uH8$^0V
zeEK-`k-kAbcn!U;L#Q%(V@opH5Hysa<#BxQ-Ci=$g;DS3@0KEG-;ZD44>b4BBtmG)
zg0*Gpb)4(9hM_DeW^&b0_uypD55FD*dz)^3Oh;@)ljn7rqHMbpK>@CqjG`B(Jtj46
zKHqzDUPjOLKYAK$H?OeWv*bnV^JZ)bnQR;-N%7WEcaEFB<i`5N;CUw-*!Kh&2|YNT
zY+TmJA5s-k0jqf&ICg7%x0JcFqy0_9B2$OahYhMB@1mp!3Z}1%z7y*D_(x+mSCPmO
zoU%dQ-khLhEW#njf?ntf48yNXrmqqQ>B5uhqsB4{`&BY`@OKPfjvU~&0ZBq3p4amg
zpH4h4TDV+75(icIz1dpM^Iw9_Tmk$Rt6@fqfZNV1$^zI|eElU%%jr`v1dF8JL;?EW
z6~)<_rG4gi&*9?>fYa0FKel5BMz8iSbGF0_vcj3L1gm_*amkZSg8}ltO$490y6MsA
zoatdtO*;EH7+8)>)<Ohx7RtIMudZsdvJG(U|CHu(IgHA`@A<Cxijr6G((VcS>gN);
z+Ptqux|$m!Ia&7^{sY2ZsEVf`RMA8&EF<i%JJ3@u@sfH!1LC6({`)i6Al|X!l$>U3
z?SQL#4jOtaB$5@=ciEN9Ra-~byI>p0gQcplp*eT9cPJYdzvpflnZcjoW)JN6BOg3D
zYkr<Zv~jBJm}I?F)6QT0)=#(O)Z8R0PUFNuA#=-Z1W<Z)F>>@Le<MjR(UFB~*;ZG2
z)BBK-0nvgdF~PLj&kk}T4WE~QFg9?piAc_hW9{y{lE6ms@Wn>ErZv08JP>lpp7E;U
zuY{SL-XT4_XdAa5EJ8(@BYt%(l{K~piZTc8U$OczurmQ>lnT|9S5H7JKT3MLzjDQw
zQS=IN>0F6e8HTvyo%MlETr#{#KJQp%4d}_L^+y{&Hs`&rebZ<S<EA~iS}K^m??gE!
z<|Gkd(k3Y??G)UnC%InlO>!?cF3F#L($R^s@#j@9Ub>A`5=+SNdvx5Fz=s1%{4(YM
zRql`30h5$apL|YE09T<xwznN--v20TR~MPo#aD38^hD766j2cW)st&O6OAao{h3_M
zR@*4bEPD1FCsP%FeJyoe-F32U#|<}s+NFaVPJfEUx!}2s+c_2)x=VOsf9V5sE&~+%
z;KbhpS$jOfRUJgPTz%e@>8f@B5d2OjMofF_or$;2<<vyIc3_0;giTWwP!AL9cmuN>
z`cij}M7U|2_!)DU{|iF1SO`pZqv(k!K+h=CZ4?$H?xwRcIo^GPLb>Bq469I%6tN;J
z`6$3zoX2!laVU1Ho5hC_>bS~Zn_9>kGlQgFB+do5mWCcvP)wd!Wx&13`yRawQNrxv
z3kOF_&x{ET6F;{}aIQCgzdQ8#cS9CAhw(PV1~d|TX`~`tu65?#!XiIAeF_2S7Z~UH
z{AJ0gEj*XK=vPz4E`G@<dqi773@H>;WL>bycV->?Njq`nQm7MZ+P{v0-<bK;<wv|h
zQIW4+ztq_^u4{tyNX^G?I;6h|`O4pGr=S->e>=?7L#I7brKhT6dp!}HF%Y|L8?+23
zK?p8Ey%#Jmn3tu$p4IpHJ8Q=3G~nS&@ov~(^Ag`1!0zh8t3WC*^Y81J3(BH_P~_z4
zX}_NpmAHq#rjLpSdJ3w5%%N@>xzGX2A}4e2%-6m{+=dD`7W6b-BXAe0Unp%qs*as!
zG+}q>k9+IF&D7Rm+2gY6!V2$mW|?TahAnPX3{>Kogi}uq<rZXBi9W#6IgbBd*rWA-
z09-7RKe#cri?>&FaKEDJ9+`KlFhLX#9SgWksst#;v=LpNsfxKW0~8~sb>8Ki-2q%z
zN#9`bc_g@DPYL&%z@~OFUE;->#h<bf5!<mi3m+=8R&h_V9$=pI*e0FV%KAlUl~%Fo
zZ?Ep%Pr;gsTVnQ4%|mi6fI?Lg>#~O!J(Vf=6xRjXiHORFXuS$uz1^N<rZnf-$>aKM
zAW%0^!+hS=bkbKBK1h)e1?>Z$q79p{u3QwZco3H>9I0!n&RjtcV%O>nINY7ydi_3l
z1{n8H>(jsLxa%E~TPD~X8X$b3xhVoC3c?nuqA!2^z@To3WRc=~W#xJM#&!~1d?<nf
z2FM64S&h(pzVBqEmDw$qs4oJp3CtYWF9_Tiu&ty8nh%(QUk~5rc%h@N9nnD1+X8=d
zX`m-F!LMJ$1J3N9M;r7pkS~*u$cniCWSeBH2dR`PNXv*-7n|lzpj=7pFaaoqzZ9Yw
zC<#BaEI!y><l{y&9=278(d}8ZVs^Lr<cdznr$5aT1rzsam*gShy>?5o$D5VmzEVDX
zpe#J&9q$Bl5YX)2wGfbAcO~zXQ?cOUc2PM)OP^euSFdt4CFSNYC6V-A#|7ybw0zU4
zH^}Xb;~cx*L@ofN>R=Btp#>KP{jnDP^-l%JGO-2T1}2iJWy?)^rw~zsY~u*Zm~ay6
z5!EK{j1G%PBWn)3`V;}_kF}w*4;2UBrgW~`To(G`VRkz?_-((?CvglHD0XpkP%tx3
zCn88rANU~ZXdCQ$C&V_0udyv}unx<@Wq?)+?f=XC@igR=Y%X5vE-V0R&4OH(A?)jI
zH2x;A$Xl;6q0f&d8Jm>s;Qvj;IjU9kAJbVn0DAkx2s)L;_NnKJkbNt?ndM+Pn`(HM
zSu&V;5kdywPOj~rN^_b1hpP7gYO-tIhtnXT_uhLEr59-lML+>TETHtNNCy#+lF++=
zB2@uV!GaV~ij;(o0s^9ff)I)zA`qGh5OROF&+|Ut{C_hHlZ1rHIcImz?q1jKKGI71
z`r)zMZPF?iu6Rs{3D!~zDQ&xkrd@&%=e%SZGf@frJc$_)hOomH9pk&iKPFSz!=(X2
zTs=7yfwq$7Nvb4@e(Bpv*>uF|)vbrPR_M7UJsFNkwDo<L1QRZI-!6<2LDiSO3Tf!0
z<`=(o$(5JiRd2GJop26vRFKBj>2(p+TG7=YWb<GxqYEzeIiH+V`CtngZ}?FCIfNs<
zgghBXRz|Sbs7S<#vZK0@C!FuJwzhB_HbF06bx#x4rZ_l27k`w;Bahsmr5cS>TyYBt
zPm;kRiPWR$sImcoh)JCBHqTK>*M)t!;65$93F~D~fV3-G@e*F19YY9K<!4O`B--XX
z25<TTTx?y3$|u-!0{7a)B_ipIE@o#KWih#TzQ(oX>P{IotaY$=P<ze4=~^*M%yf6=
zHOK6=LhJs(7~i}qosyVFMim812zqW^HKZtRsA{^cR};CsZR5UC#Q`Xgg~7CoH;`F%
z1xA@s+6k_%jY9$k7}pR92slo~SDs2}Cqf1;^G<8g{p!!p&B8I!1{2?y0d5d1soEm^
zVL7nJKQ7tn-6eUG8QtM|;URXSXI_{|1?Oe3M60lSB^qq4QR)0dXMTdUs|nstSG+E8
zuf^b*7>Qwy<!%k=SZX2O21ryK@|UmSRxj-g%)J(ceEiAF1P_?F9{2-$kl_EpNa<w@
z1WhNWlrR?|?eS6%2!IzWp1W`&cC%^kC^eTEmuyN55N{6x{xI4lbDynXS7(U<hA3RE
zh2Led2Yc^yWCf!taE2!gjf1s`R)1m{Z*_BA4PNZ;5ks_t)2|Y4R-hLW^c9qW3#PNE
zRI>s}bpkV+{lGN{zW15LIzQQo?F`@pWvaMCJbw7va|a=oOq$)5Y2m+<aZ+^3obmnC
zj&INRBIDHzK{4tkY!1=!btI?i<gvrW@Q?LpT5^8C-!Fv88j89527mhP*rI~&WE1Wp
z_I3$M>VMyya@J(eP}@YjMx382eS93f^3<0gMSsa;vNIthQ#T*op3{l$*-So^4TpEa
z?|&{to$B%2f-${FdACkeaXY@5z|S6y{(<f`XFZ*he6qpi6Y>vd5nsP~CExwbBsdQ{
ze~pTAN=dGs)u(zRB<<6-sr3m=-fxzZv$8IF^$8*3TM*>ju_Ls8dEQO)MLQDLrrc2p
z_NfGl(8ewhJwu6a-*CGaEb|<(Xc3NaL&T(TL#cw|H@w9Kxq6arAywFV5;W=I-7zan
zDVOKfDe+KR0sRSK9^S#Ux_JR4ePsn?MEYW|kjqgh7DB$PMIY&;<_q+qT5@q2?51Nf
zKSf1KiZCju=s+sQZN@9DmW$ynuxvg0fol?=gbehi(2-$KHilhOCCo(+4|lJAzzG5l
zK*lX{X`<Nfss<ybzqSD6GV0JlT4}e>v-&g)Z)5-+5;7NF1>a1fXV~B*AVMN2gJuM(
zLNk9O(<3z-J)}<E?$w;@zVNGV!(Sh+Hw<`H1g>XZ!Knsc{MhAiAvf%<16>kP-e1M+
zgky~I`D#?U5R~W9{SSS*d159@xug*{+Q%8~M_ad~mR2yvqwjQ>6T4I8uhNcT-Xk8{
zM^U-sW$YoF@n-0~iN~HFMEPzFRh+Vs+V$xAePcD9)ZcYoT;`g4pD~QuP*F0`Kq)dA
z-F{a48)M5Ui59TFm-Wj`N%i;!v<?DKFMQs12h0;Vsywg%#c^TGP;4j#&Xz6I$p}Xf
z8F(gB#ZJ1b|0Gy2Fp`2H4@Q(&p^C4Yt>+f)zWEU`sI-+PUU=cNYivlEiHl|lMfJ&N
z(qO!ZRUBe=;sMaxYmNEDAxgb}e-`3@dD{#>Y$`=$)Ljuek73S{|Ar;9UZj1GM?26y
z8yy~PvFb81k^lkR%Ye5%eXiF~#a}9zwAOZYc1E&!8v%=twz1zgH#ey4Np7AgaOr()
z3S3h9-U_Z;_{<?0vc#Inp<gcp-?3ujVmuX$+}?)gj(YN)6+gaKvrCX^Re?{ROE^Yz
zvQijqTv_5ga*O^IN~asWrJSoN1$iO1_%M#V5uzFrG}a-0+}h9Qk8J;wXYWL=&9Fm*
z?g#&f-bycga(FOYDk>`($g))d<hW)MdA06|HAi;H<wE@0s!o3KyGV>$xlMJg=iKTP
z4XJ0+zA8UW?NcxtIZ8Qu!cciuy_QvPek#0L=NX?*gmm#IR*x)A{!&pk-+@225^uWA
zlM|oGQKldR_UgR$G&3V`*w%cxkP!20^`0Y;Dz3#y&t=>iOqotm(fyXoJ4tHiNM@N<
z6aDR6i00%#d2WDlzgQDfIK0Co@9bmUm~^Y47z>F}!f49ri@<`SK3PY6=cce3Tem8^
z;0Sb^XCbpuI9RX1hjWs7U|(YJc3;Tz76xjeY$(Ntd%0{UDn?*kYCXvQwng}|QIX5A
z&}uCr53Y0NdOs>`^K7kCNBw|c)b~|Y6AwqgAW0R6YOTI*b2J?QvH{L_SGnJ@(F*{Y
zzMboqq>qX#bI;+4Yxwi@qDcQ$A9-@G8EIVuaxIF3^2>v9_~T8MX+v1?@M}7vsr##E
z_Y20gGsJGP)-sw;mk{Xdv@=Ma9B2;KZnFXQ_IJ1Y6v><qDMCSr_o2$X(lK|K3oSM2
z$3=b%jP=@_w*vqU%`?$RKCE7b0V(ZN&lk^#I4YQIBP_nVOkkLXKs0GaCAc#XMXH6V
z^Y1;_^~tmL6|X&vB`hST-@~4S`Kd*$+Qsi*31BTyO0$<T@m4ITs3rEQt-ykgHp!Ip
zSuGHEc>bd2+78<ZH-ZdXs0eh&4MC5OWVRdfiG+M&nmY>{<7bl`K<AL%_PE>pNZ|Mz
zFG)#=yHhtGiriCKk7g&BcB55{1oP7hKg*MjeRQCoHW2tQ&moYe#V&o_gQW(fN)%bS
zu1n{XaiG#NjXxO<Nn5!Rg=0p;h9x;T5|qNmp6`2~4<&@t9~Z)mnPe6uEc*}#Q@M$k
z!2W%wPu;aRdQyi<(y^1IXdaEd8oV6Ti!i<q_MJS}-uG*{v)0evDAVTgzJDwdYs1?G
zXK=*roTK2<j4w_eIyNpfTK8UHIVZv8)5D*j=55$wDpmhk9)4m!=;$fj>1`0O&ytq5
zVnJv-7d?bcPs_H1P2LsqgTHvA)Q8r%dMyg~>)M`~S2hQJ28sTr&TNlQcYP4H|F_%p
zgRokONL;!!K@<o(C<ni3!07ph3171;girwjQ!W8EH5gNgA4S&pRU*>LjJ=FVD8Y|5
zD}S5s^n^}m8U0}tHR&p(S&_s#RZj)lxp{+RsGmxHif?hqYJPoL>&`R4N>Vta_|T>t
zv-NmdN}o7i2XXjF&2B84yQAHRMBh4RQ1O>zNY8h#y^h>pn}2m`@y!wO33r`Ac@er7
zWQQ#nOWans<?q$Y6F862^&rXgUqL*CiY-KgNZFMSC`BLX+c}$fLY}t`XPQFlWj|yL
zU6>?7A^6JZ<-1L@Ma|4^^x`&{c6=DgSaC|!-BQyZ`t^4Cpw&tD30Bu)ZudT@yl`s8
zxd$nlPDt)2^S$}?3&)jfJKs*6oofb5AqV#ZQgC}iJ(EfXp}>)25GA=g1Io@!&DGke
z*Ijj=crri!&V%@M66h|1CRw_djJDoB;7r_+g?QhEsBJZU)t+~-XIx9=hPXUTTCEKH
z`Mqwxu!7ykWgrWh@9q|`Qac?TK=CBp=x0!(r?B$3dpO;`U>e^><<VJuutP~+fJqv{
zbu727$%k8hf!rR^O0r(#^<Y25GE|7|g59__p;zI%%uz@#f0$``a?Pv0ujoZ$mhd+=
z5kGM<?dQ<lBYlBh9?s<lC*lqk%#3er=DwWymIoUg<vFojI+t3*?92NwSGfiiFZ@V4
z<@M;XcXWDg8iRyB&~j03e7XR$f2n+c^3@Vo{sqbL$31v|>+UdE?WxXV;%qL|OqXN%
z6}joq@+n6c$b(MWV$)s!9#;+`N9a$zh=6!ZiqVBBibgL&jM$pW#tGrItPyDwPOHI=
zG))IIp^T2Xe~I^l$P?=a1??P}#0t>*mp!-p3L2%3(5Va%rdLXGg6!jJ_ygSC`buyY
zRs`6E8!y4SN#fGa7A4^YgSa2$iQ5_zV$gs;tJSRXFTW<gyAnG&aQ$YdE@kb_w9RdO
zZw}eA`!OmNLgl@m+nhBf=xJxsl=^-g^Bd~`O<?20GDxU1Pjiy5VAPnI%WiH`1Ssb)
z8iHnQVsDN*wEA4BIu+0$b!L=RkC{Z^A>oXC>kn~=gz?t4Df^`bJ=0vy44$$}s-Md`
z=_8p9g8VNQ+&93{-HpBwgvVso0;T>dxQ=*3Rp;#HFJBi%9bWLb$y%j9a<79eiaX3S
zbUtWq(gQ?YnIqv*sulcni3TK5jsu;S%Ro7XZ@av8wgQLA=>fize=%#pG_zqSDkd-Y
z(s(0I%z$C9{@6>aGm=-Zzda|+JM4#_BAz^qEPJk@hVWfWIA_}kcuP10UOFSPS-tNS
z!rdxdh7*G~iHO{Tl^tBYv&i)7Hb9HQ`uiOP!FDA%_<DZo*l4l$(%IA98>HWw^~Er*
zd>W&yV^Bi!TLK5=f)8;rVl8-zP(&~C@voj{U%kU6v39!;cIIRJk>%;AR26d)dJ-r9
zj;)?mXh0t#w*W(TRsD?2g(ziRMaO3ZVrQoVaIZcJ3BioKQo1@UF7HA^hLtE$PZPHW
ze&h^@6};`6SYO?pzt3zZT%efz`9_eDpNKbJWIt#K>*`8*&#iOr6oaL?=<!S})h5l!
zcx7ZI1~gvfqx0<$*N@h#s#xlAqqVtqEei<dvspOHfSxxRkmAJGs^3f061G+MGt9${
z#Zj7mG&g^NS&BQ;v>dTJbwShf!wh*@xt5I=Sl{Oyh+9of8A4dM;<Ytkb_Wa)q$v(w
z)t7Lt{!sfkzQZ&DcaIe47;*!i(NXWmzY~Ko)qd7Lv2Nr^kRmD8UK4eXWv8R^EPhfE
zFK1r$djWvNLPXB!m7i<}#J5uyl4U2OJflnC`8ppQBy|b$=cjvXti;;!>CsRxo5-tc
zW|YKd3sP0ni&s4NqXOCM=k*XbU=P#bHwi=88WZXirrb1BSAJg25jY0&Q~Q&Tbu+d%
zyq6XC!dzCKknJ6x&Hmc{u$rXGb(h^0-bm-Y6d#`|Fm4tZS-wJ=g|Jn#XNkmeaxCI$
zR0iY)QonA(&?=OXl(!3cL@3&Oi0AKp%F3}Hv<5#3P0mD5qvvNJqLNAX?)*A20N|2>
z^Hw2G9JGhxq>hfF0jvPVJgAvenQ@`%FJ<t|Us5Vf>hCxN@InE#eE4-bx@qygtT_5y
z&jae%@#BXpPBiiR#`B-yA;+ceX&CAOpPP?&)N@$N>I^P*DReLeHSc%cfU0BZwIjjp
zxXc0-EPBM?3UorITR1zjHHY<Sj$tP>-NL+^Rkpjscekf;`R!cgE_j2m@bAPgs$h<;
z2rT%H5tqhZ_JIV*`TQ^k9&8Qgqpp!9QssCVj&5DdY-c&};2X$6F)&<#`#g!SV%KD*
zse0`nue(mKx7%%R@+A}ZhLeM@`^wZB!o~h;8oOS-3QXw2Zu2HQNTkgpP><XK9Toi|
zC|})7a_^e&EW><s03N_u8^rGt*w!sH#ba-s(g6j&;ev=>6ig-OWMe=R>``td#B&JO
z;??76cJXsxCQ*LDy_!vvJx+((u<!S>{)_F6cZaL3tHPRzu?NFmo)gsOAGIB^U=#Hz
zGkG`ftfJ)Ol6(Ra@_ofBozPUXpMW)*XM)+JDBt|Sz?Z+`zd}k##N|IJkmQn{nBb+H
za|I|XCV>$1Tdgwdb?Iqr2b9q`Ap(L)_9tmX4@fsf7RaoAIX*H^C*wdX31I?nB@Eg3
z_065o=@DRZkF-I5yXDHu@tge<x3*eN=KFIb->q+2f2ntf@6yTdjrMNd30CM1i4*zr
zr%rG)C|wyRaT_TDA>%>11|o+dy4}|@AI@$}@HUWTfAI1736dyFb0`vQsdij3H-X^m
zt5W`}{VlB5!t|10^q2D6P0SOAwWM2*lGn7gY<LLo<MQrekb~-&TfGT3ko+386y^>?
z5dw6Y<D<GMER<U?N$)4hC6Tq=wj}o~zpTH|Vk}LCKTU&W3m*hP3E~VwzbJF)$)1xs
z!2kfr_8+?l8j1xz_Lk(H449*}c?XGfM{K9grCp0?{G|{}zD?dd3Smlf+We<>;a$&l
zh}VV}>hSFWvMWfGa_tWD!yumQuHNR&UOc1n{Jb<sdL?pP_%^m0cqK-OoJAfFo2-q9
z%wd%G-7E!2%ZL_lhf9Q?W>09-3AV-#yMc~3FRD0r=rG4^ehVu2-V`E8(4HQTSf>e5
z5jy_-sJ)*sn)-|}372=|qvcg}+V7Wqicx<DMDv>j)VcC{@uU53ktt@wlL>zN9<qDw
zBsl<Qw6B3_Kt~hmx-Yt^!H{<Jh>~PFj<860mfTGkXKFAcW>Cn>pK!)5VT==P{c<~L
zq#9~=r3Z_3KqWt99~zqz+9VSrPysA|0HHP48TA4o0H8HK|DWcb)QN`q4Fw)~@7Nz5
z>^XZh|CdajA4cRjMFVS>fJpyb82xvne6z~K_-kEqf!Mpv((9uG@5noySXMU#@64b;
z`K@NWh!JqRB53acXb|M_;NJAppG(>Q3JrS`L>5ou)T{|=mOQqt^|d#kGiaSq?4>T6
zJ$DdPNTMJ1k%s*NT^=c7de&)2wRHA<e1*YdHCvyOtw_=Hv(mY(*UGW+K~FhvMbi#?
zmhY>XqR(zW&*VkNY*Al<85L#E_rf97$I0r^HuWKm+;MR_jN=j<_jyLHI!I1E_S*Q3
z_)&eX()r!9^t!43%^Cj5vb(gzDTu?fKlUU}1zFEFT+6Bi#Ea(P{il1jXzBT37t`!s
zvW&5oshL(x^yaG>5&6JIa!X<Pj9lVr4^8i|W51r`Irph+pc5Vbp>>jFex{iQx^s1_
z)r<-XTc5;e2EE69Z+^eE!0^9%|I~Dd+KI=?qqCiYcf=Nh!y`7c?LE=uy(feS{Kp?_
z*M$uM%J{A8d$pi)cV`GjF9TG)1ZKyYqs6E-xx+vNqeRhe&^bI77I;}`j~p}R)h)R>
z1*q-kPBdNoG^hQ5REdLG%a-_7O;CA@qcT2dlhMFDsypNr_w(3pq}!$mbS*x5EuO15
z(9biT5;bz>>M*(snS^GSKD9^8&~R(RJT$XjC!NYTeMS}L7`q9pxQKxX)a_Pn0__m(
z7d~T^&lWuGtZNuQ-a{%wPJ0gM<Fk>%5V0*uomM?YouD~L9yQ_Y6nlozQWri3p<K~X
zuPkkOncR5@AzHdp{6=#E+V39C3ISN)9X%gG;8VM4-A#PmZz;Y4iNCt|ufBF?@DKgN
zM*sI|?}@*Evo){(=}9*}#F@R`42<9Zd;9k=!d%0?|5ycLPY6nz_*Pey1OESf<RS)j
zW#S5Y^7X_IpcLqdgc$VrxK9``3)&Oe+1P!w4ie+KFZw1@0pCX^9d7^%!oHV9FNjW_
z`%#?1%t{<P=P@6vaX_8FT~IZi%a&{<Lh!%MfwF)sTQi=^_F}oVF<Xnff7?v)HzB0%
zkk3~AEAf0fDyt+|Y0BkV>HBiTZN?i?_-SK$=RObEbc-|6PQgllWdO@|i{&XqHm@m<
zqf`<N#7mBg-<YkuGITV52ZNO4l#mU@lLrwwUp%|MKk!9N7?Od`!#Nt`u<8lYGAh5P
z13PJX2rAlNv;WUk`@aV_`FS1(as2a=L~th;)BYR~{g2t}Jt1rh>EI8zFzJ+YxI6bU
z@FwEyYZBlukn8i}*7`D$J%KZ*7npBB0hZPacEc#ikjlobvIVguM6%SRX=tuFRs68w
z(iGnZ7cN;Z23U1+ZM2>4&PQ<z#v&H_2?X@<CDWk_yX66MGwA%i@4YBFJr84;kDD_3
zjLOlkcm~(UhXAvC-mvmylR!hCOJXk$+2AVqz{0BhNUtqHlc6f+mWkPD2O)W^L%mnA
zcx7OEvp(EtI^sL2?4j!9n(GJ9a7Qw9%CcG3(cb*EF#l)aTai*#!lgoOSO4_`7x;L|
zpa$wL=o{dKhmH>`OBm4ODLaIGJFzN0%{I2s_UE0q3iEyjXse{ZM9gG(6n8#v>%pD{
zyWL(8y!pUm`Hy!rR}igvaK=ZZ)JMeMW^=eOm7-stP~e@HV^bB`;Dez<)R5%29Db(a
zJRj4=$71N+loZF@Bg*ojW2qrVGMoM^0l4qk5OGc{`rP5yWq-mJC;e(<Or!>vEhG(n
zTKh5B_5wDp{_#>pL5WB(^zkXap7XR_L}It|Xgeqd-;c<LKvr*|OAFX+kCcE*Z_81h
zdqA*0$g%l9$4%48jrY}x`0!8k4m!ZUAu79i{!(q&IvR}ECFu=BD8~DI!Nt%nX8rx=
z$BCT+E1rD(J%NzqsuG(~s^I-bTfapP&D(4M#Fnm?oW6n8137@l)Md{xV?Ve6NtPCR
z6AG=t^K<B54v5Kepa5atb2PWi*@Tez40a!km#{eVTO)1-JJhZSQA=<15sLoN=Z^~X
zxg+XOu<|wMr>eT+<vS*)x$AkF$;#~X66Ft0L~;D#k@<0>DCiU{ONzA%<{kj?*Q;pI
zCg`>#75Yb?A3C$;Uur%}+WW2$n{(v>&9>4PsF;O_=_s7Bb8>f`YyYI-Bu3(>w^rFD
z`RQ;PTutFGL|N%QNVSSUTo7?2&qojvclJk@!3JocO_<`kRrUg?bKTVYKij69lthc`
z>?{=kCFb87pGp%7A-?!DBDD}i%do({aFn>iEfktkePGP?aNGD~Sb6j)6ZkLLTOxDi
z^iMt<4?A{vFrvWR2)VUSKcTo?x%{Mm<NWA77;igSoXYp)7x@9j813veFd|<i1><=7
z^@J+D@`&@D1iNhw3K91Zm1HPu5FYg=0SW!AcCy17nGS*dc@CA<!N*o}g>aQv{&sAf
zjfUDMO^D8ocOLDucoggX4RY990tnW-kG=tQ)wKVe`M(Qey2D!DK_mYGzvF*PO`b7S
zD1NwO%*@$(XlqTlXlXMVBbQ3};#YiOBdjyxZ?wc<JtZ2$T)wd(b3Oa{AIS94Lj5}r
zLxC{2A9Nvl^fTu!S)5u*a*3FSO1|`>9ur04X8Bq9nF~hMf~***#g*SGFk{vPi@gCn
zjbqW*wAQ2+P9G>VyBoxSSK|I83K$GwrL94~=-;!5M3F~Ff$pm<C)GL(@9R`>?%&ne
zoXke|)D@<3h4!Skdfa52+nw)&`IK%0B<*Kw!g&>n^k<l}UVr;`J>nlTCkFrtx|?Of
zgkXyUM}XCOh}HbZ4~URbFml!QfzNml*SMT}G9U2mr?~dBpD%g>VLq$-z<q{Xb6v_v
zc=nUa&7~oMoE%iMEvA%DkYrk?wjYpSFlQ*3M@GV**=ub*3r<K49mi(t1OOBfx#Lfd
zuv+u&2=5W0^Vr#AqU*Ew;_CF~+o9%nCw2gs!A>`4=uZ4Nq*zgLLTl0PUFiHN)=_QX
zNzs__X-hC&6VUfv%@5c+x+gML4T@P$2IN%WSt<0UtE4h~)FXK|dS&az+Z~f_68-k}
zxy@uglKEy3kc3FDBsG=lhKAHwaP3Pk?#hh?5Ck6bcJtN6T)z{g#1O+OuzN2xcp@mu
zJ<=KETGlPQ{(I^a6(n@3q7Rw@=cbouR)X_0JJn!R&XQ<xqPAOc#pn(02nhB1W}1^u
z1uQ?c@uWlBCpr3h5MQC|$6*N$Vo%@Y(1(c%1w#__{A?qaw8lrXgE4J6=lkYRrHl94
zS^O1)Zj%S1!G#4unBnMP+Z7Hf{mMJS%U8XSw#Q#{TuBBh`8in;{J+@|P$lvBLWc`x
z?A+w7&B85+YUU3xuY#Xv3Ii`-XmlC6<f*C+z~NaqsI12#;6!6E<n+CdDsY+afHRqX
zb*B%X2K(~9gAx!<9v)@a6^>46a#Mr(3DC@iEgQbRm-Vx7@!MylO8n1q$O;ixjal=R
z?1N`hcIyi`rc0*pvT`C8x=`01V{^!&zkvb%ahEz!7V7T4VkreashwuK@>y{X4>^(g
zSDS)ilI%suVyB*Ad*z;f%K}j~Cp<?8V!`25h!iR>1<UkS%zLLB9rpX-1{asK?3Xty
z;8B9!*m=V@K+23;@#CwLMViA;xmzi`r`#K7onW|ABb{g7ti)lHBrJMM+#D9BRk?~s
z2Run%zg|wG2QwRS`(MSkjx&1?G++}&mlF)!VR6zvjVb~Od3SBy8`>B~pwtfk8J;_A
zbQ(gz^wMgV@h&9(E!pj~6q`|4FY=m9)^h1liwW`^o!U{;-@DytwQ#+e1q9Qh?-md|
zV<bX*MG(1^g)7&L0?}R7^m5OamaBzmEhk|pX;4{zLvmb^0PXjqOKvmXf9{)1L0Yvi
zEdHF_anyjniMVMAMt(XON2a)2vp3!pG+dI*t(guAXbHhUQ!nSs1}!qkJi+3gpZd*0
zu=iXt4SyffE8t$r+4};5z?j!*N*?}g$ZXzPbvcjLC}iM*s>$}Fh42YrlgmicIE2q(
z?HY|CwV;VB`q%`vf(f6BoB_JWG0?oZ--!ENk7x7L<@i5+^Ra+ZN^%|q&qDYb9+}+l
z6+Q`%rqPf^PYBYNiN#!yT&G4tcIBPK53lCF&<iJ&@@miWM5l5~9L5wXRX*AH6h1lG
z?0SL{24V8Tb*lxc`1`$Z3qR@p@nqzU+YaE*J<BqT1>M#1!FyJ)KN8{ZV?DRNH`q5R
z&NoAt@{%V6pYiJf9n2F}(oT(|I5^uoZbW+z5z=k;Xq^OcYsK|4Nk`hRWe_9wR^;^B
zK|zJM_q?%a{mvdPjaHIL-Q)bi`6br99rAu^rC<Bkoc8Pn)fGPrny`p{sw~lPcW7SU
zFw%z2s97;n{&WA8D=+S3v|3sQ?Ugem(awS?$dnn#cXv)pbL7MCGi6G#eUJQvAL^Cg
zk-2>N@+nI+II-jp>mRE#k1u{zKI|NUXq;vBePUW$zz=i4&?jjuxv{$kva0`NnH@p@
z4m~Gc8a7<ZY*Exh0-3+L>8;19hVD2AUN`P>adOSO2WC3eP_cyNJ0R_wU%FUnYn39b
zun{NxsP(p4?<wn7G^P9gS2iDn)iJ|yuQ3o6LZFJ5j|Xh2Uo${m+BOoOxtUrI(KpOH
z!!c%K&>0boBzI|yrz;@3<>o{kBj@d0uj*gT?h9m<OuN$;W1qq;W?Yc1@5l@6zUQ`u
z!D|{Ca~%Jy$XO`>d*IfyLrcwgI)up;=iDZ9wMzFaH9wrAut0As_kkvdfv;vt((rAW
z8`n*Mz1t+cifTePSklD|^%;wvafU2(hOsfUu=!TS`t8-6_$fVeldJwv!8L5>E7c%=
z4fFlc4Yq1vFsqO)ifu$Yf+VrRGVp`q->$2%WFp_3>77F_+^b8pnxO*Jk18KVQhL@$
zIzR{ymhE?~tK-!q&?GQQ27upxZ`Xy{{YhqdHZR|DzPc|RU|0(hlV>sqHtc6;oj+nn
zrw<ibTEsL)X_}$WSJw93v)2DczFNeSvJ+CAC4(W7tyDe6r5mz_r}btXu2L`-Puumr
zgm=vm%9Bi&vwx|$x9PseVG`q}ZJi0<t0M2EIk)cXg&BC1{^QcJJoU9Y=*h7E5xAs#
zcJW}(+zD)LFE6kTUm^0ZhRI8|?i1aa;#>En4o?iB(?E@DLCjSz#82qu6ORvU%{L%Z
z2JXoIuBmCfn=%*8F`Z-2CfWLB=4Fd*#xnTRPHHD5%^;$Gl7U$;PiWN7B@PIj(7+Nt
zbAKGRfNrUOMo$h5AzrC03FH_p@r>XJRxxsFd&DQO{5NUcnxi$F4sN;9&ckO_3FuT6
z4x|P~ixIyMwa?dLOBzi$HH}Cb%q@0N$pvsnJw!=5ho&>co}%+$>uQMXidKoWn(`KE
z#)^VXv?jT7S4eD?Q51ZfmOy(8?%+E`(C62yp$P@6ua=gH=}YqJ7kYz2D`uef)0!=F
za=Jhy2c6N=Q^?Z7!Ib7L0^HiJtlQL^*Jgf}bHdDEs;42Rd>)ea)Zdt?>x*F#YByiR
zbG1ZGQ_Lz?ZXT*Ca$TnPvWtviv)!B0>-zDh44b<d@PAydG6sf3#WjdVfU$>Y3mG5^
z#2EdIx;HRcn={`GePH=BI68ZVYCu+@Zp6J+1`}|l3A}e*N%F0D@$opL&6OA}qQtFr
zu@bR<e{a(WgSdeYl#3Yt#)qM=fXn!1n44|Olu*GOO_)%cxcsiC2vvvvWbD)5MS?^S
ziY%D2ak-Ei77#rZ%rOs!p)&BD22pWe{q&H2F(P<S?|?J(fjy7*fTii!zm_}U8DE1E
zV={5eJChMr%Tu7lV06ArZat%;!9I<-u*g^|_Pz&KbdqS-jqSi-zR9-Ik6+@}35Bb%
zZ4nXA)A35Y0m!z&&yjU~AsM_^`Z9yNtYS8kX5OP0BNR74Xb{|grj{63k%J{$0cX$8
z4b`Aj6{y}#e`uOy2*CYZq>s*=ZznbDW7pO_gW0csFB>l1)b#6}pHGH7-7*VpT*j@Q
zjM^~{2R7ViAYdo!L5~l0Mq?F7@B?9)k+dImao@40q;>%IM}{ff46XSQbL1a|0*#A*
z9o~Z+KUycg6Ku96(h3$!pfVDx42u)1G_5>vnrIf2*${or8gRnvL6m_nSUaM{^!}OX
z9-o@UJIbmmJd<bS&n4%D=JYMc;D_Rpfs1p>b(38PE{x_Qm5m$xm5sWQ1pb?sAeyL)
zhWe+~DFFoGOt0Z#l*#9X=Fnot7RDIaQc&A`x?Me*!^#ufKYr;8_8z~a^f)D=8w*e*
z^{z}o7SgVWLr?&uc8dSO_IZuPeSRq40xhD)3&%2gRx&T=^sikyQSn`#NG|I+lB<zM
z*K;KXY$e(L%G+K_4tvWv42xiC`SsbaYry<(MqJAcpBQ;dpxjX7$FaUS!*uIUoniD}
zLQh=I%q%eLH;VQ1^7#Dal@Z+xw0RA)8O^H~dK56E{>bmQ>u)V0J+U=gZZYvaNpQT1
z`b{W`ajV(p$6RMb&lIFO%0RI3z`uW{nf00L$AUiMq-0&3D;QR6miKk+P=a%zA?jv>
zxa(SVlwg72g?thvbX0`6g85N%zcjghB+FLh?d2?O9IsNos6rYG4cSv*p#-EBZ1RY+
z-Hp7x5+hBNjXO6#wK@5L;*K%>W*D(Xt14w_fg7RE7&wMr+Q91Yiif3!t<`C$Q^h$1
zh}=;sBvpOQOx-ovPD6KHFaCbiv;EPFDso#Vi)!YKnjyvsN_g{*y2NBx5{p4mw5SmL
znfJ(#<W0S1blOg*D1mLsKh59$b3zc+rP$~$;jN(E1<6b8GtX9@MHLRGJZM%f<8YGG
zF;HAybe_M$Fb5*UnN@Ap)jK{~jI}JvfWv0wW@K<KB7*0R>ipq~plZc^!7l$59}Uk_
zftMW%fh|$zw!kl?fneTb{mloFt3fXvR7@GDBnGRUaRY24V?p;5fCfbgWPLkxqu*c!
zlpMN}Di3Z)PeJAR=gLV^rl=ooh@h#o_2hOqE)LuM92EgkskC2H!9vaBPt21EijChX
z&1BMbNCsAHvpWc&afrMn$s^ry5Xmoem!Ao!3^Xhx2o!yR$BTm3Ev1;jvahdGSQ@Uz
zlbgx?{mH8@LuWMB`f<k#njCT7spr9OtY|e|YW)(to=nMTG+`yQtB3~9R3pMFC5jv%
zp0LW%x-mHM@BoBmL_7{pe#)|rrEYAPxRvyL?T~(x6Nt!^P_Add&(3C?(Ta)fJmmYZ
zal0Bf7u*&vRdjxbJhwfRLW0PjdHXbb1x>E>8*<Tu9V@5%%2G8`k+GQ1+2VIobdID{
z@oqlHrLhCa4XsceW%Y+GFg^>GqEKJmbfuZf{DVw@;_<-^i{ISpJuT}>O@BbKfv#(e
zro3OOtc|IxJ)^j!WdR+L6HhNGR=4?yikBMN4OD$tjbJ{OvdCce0eYa(X*$ZPQX3hP
z9G0f$p4isCU0cpkqw<=Wo9k>v%GcDQ_qD_!Dfxg2plIrd+yy`1#2>T27j!i7>kL(E
z=?CQZA=RF-8NDcYoTq+>k)_4I>Q-hkwzojiQcS%&(gt-j=-jPxYKKhT?$^n_8e=^F
z3d6q~hx#7r6y9NyK51A18u$5LW8q`v8?T~ESnKpixcK5`nhU$0Y8bycPB=iL{HP2p
zOX(%@){b%|xfsgng2MNui6cV7#=cYZROnx$GJln!C1E5ta>9c@gjptOV{c`L^0LJp
z1HZCd>|<W1Ju-=<^|U~B@-7vr?NQXR070R{BfM=V7^fpA6iM4~jA}tp$DC%f(^YTy
zAICdZ9s2C!GpUf~N7vw4_%4{&r@7Lk*~OJBtZvY*&(fMkmyTrvbySWguHtexc>8Ej
z@do!uwRQ{XIuA}(hdtyqxGr3GI_N|q9>fj+38Q<%rbcxJaD<f?<Q+EQYOIF6NgVl*
z8idCKV#1>|EM?ALiwJqsbT8mB4P?T8h%mt5Iz|_|k0lps9OFvzYvDE#i|?yP(&s|2
zZX*TyWxQ)|m0a9EWx29*w|9gf=2K{3s~kTefC_`Kahyxlj51Mpa<~b?I&^e*rmlLV
zl|!`qnS&jU@j#J{IcB`q;`0w1#B$8^$3*yF5k6qfJc^kUB1TZvvskBwk}jI{OU9G4
z509`hD8g-}+%Bs*W_gI8(}dFC-cIZ@ZQxzL9**ub-!r)Kd1LiCDm|yV(pb>cvEBx;
zi0Ki6I-w(;&56`>c%^i`bbUem5eY%A&@opz?stCf@%1YgFyC;@-H<mK!oyleKvyta
zUW#48gM;x?FWrSL7rzsKwo8QWv9!>kmW_8|1^m-wYJ#!Qz*Bkn$9XnuclPYX35PuX
zO`S)(S+_Xio(@#|Z+vD<M|>m(R{)tsKHer-p7(W$tUJ>K7k_O>j=f2$dWyzrRGY-#
z*)M5K84dwVv-fDhlKvJi4}qnJq10cm>L0)N+|&oX3rUfhtj)7AtctA^J+IcgxIko)
z-8N@O$?uMP^fM6jGoSb4b4L`h2z~bFf7vb=#*iSK%4A*5IdQw^gUx>;MoHpE8bK`T
z{ljXq7_-&o6RRaw0172g&`=g4uj@<Oxg?uqe?NWLZAUvEol#m(1l|G4Y>)dB10l*+
zmt~LG_aY6OTF$4xjk}&S>mmCk8n2IX><jCb0cUunIh~(RhVrfN?_iHe3rWytD*7j0
z;+^rZ$M(=mSAdzLPGQ@zkEef~E{IYmY$&+T*a6c)y6fdPOXmBa(i+LTI{P0^AQgs)
zC9G~q5QYh$s_gY!C)K178yyC#z{yLL`#}S~H=Thz2b*R56&jXNc>|!TRN{O>R`+T<
z+hTp1hFt$fqh}L#OORqZjFY%1I_3A6CwC$AuD}Bkt=X^SR32_Xkk1JEKJ+jEbU{c9
zI2=UnjM8^<pM%?Pw^eGA=a6Vt)T5ju$?A{uS=#7|i*3&RB_V~r)ihJZ?z0TeSLy(#
zGYk6i6_Q7IgNA8<RG9?1ZU*o9wbGpMs+z~UjwWpDq>&r+d^A5FucOPFbQRDISZ@X~
zjq;z%?QBk+)7YL2I*A36=3ZQ~5x~o?8(Il31lDY-dl>a*n2Ps5e=3Q^i0{{(arZw2
zB;7AIVvkw{R^M^jxlB^T2wdtl&zPqXtIqq28F@L#avIOHmeJL-ne#8>Zm#9vDbstv
z8uL>KZY=a#GE>q}N9XHghZn#H_frxQ>DOfr(y>5lK2$V1#l8ZMeSr<2Hj}Ygo?>h1
zPN4G=39X%TSlHYwmZo2CjLGGwcpTxrFtqkL%*~_3OY+Jgc7R=MLW;lgP{7E~Tlpv<
zTIGIu9`$=!WJ~l(3b#&)uhOsVPOerBrh6)fwth)MT^3D7Z=Yq|>X?#Utu?4;yt=`t
zB_FmEEPGT&VukjqEbvEx8QWf;ozBp(yZ?Ycx-0)dK))Dx6Y=;>r4}-D^>hvyd<Te$
z{Y4~47xaziW1tV}&UAdE;hXpf=1parn}<J=oNdsvAQo2+=DM}kkE=}WMR$pQTh0=c
z3e@mSDfsj}f`7o@twDM2?R+e6(XC$Q0Qx3~WsKEObx;R9h^2!)?52g@6WkbZW-QYC
zJB{OQ?4S5w1#~E5?UagHRHv;&rY^6Jr5pr9nPXZA%}uB^q}XZPtTq22n?W^*gV@@P
zw#(muA`dW*$NC?dBrL?plffkRmAhPx_s@`{Dh@1FTGYyedS1>*u@=;ax802_@fgYg
zXWK8N#e(TuO7dv=KRMI?u$|k%luIoe;r~7T3-xy=$f#_(?oD{+>(@xPf?NwUn1&G7
zA2^WOJoU0&eqa&{Gx#an7dm*n|5*9$E?8lm6T6YP-W_&MhAWqAc0?}T<L3e}K^>(H
z^uT0BVj8S@sqv8dAcHUGTDU#^E46QgSH+Dul&5TZI~vT?i^-}RsyO>*z{;G9cmG^>
z_%%E);3jbtQM?4A8@Ip+u4BDHy*2HyOFM{ql|y2mZAASuF)=+t491I4dYu-db9nM^
zzMA8&xB1^PQb?S?d-*y+uJ9{bdk{_H|HZLD<PJo5z!bIJda<n6;hb8_4NjBc-0vfa
zxMoq9xYU<74vC&szZ`Ds;Ho|=j&?HRTD<GLgfur9i-P6N;9@sTpl@DpjRibLS}cm&
z^&(UpC1|HMBTw6jYi|iLE0s4W18yEE=1=1wH(#0>&ED7*B_MAUdwQhdH_Eo}MK?1i
z<u*rzp%3bWZmJFDt}ytrQ$lu&S3wCKU1<6r-RN)TUH)O#8v_l1lKd|&`9FdE=gEVf
zUta$Jlf5{;4lRHDat%Y%mtx&}K<zRi$Saj<hl3vZC5&h!AV!t^MFS3#dbq_In*00|
z{Dn@>USes-5kIJOOS;*mp^(p5S@+ulH}v`ug}APy++aJg_tmpq>9tl8f4HpqFWj@@
z00PBBOq#rkHW~C_0a3qnmM2NLpq)fPhsj^jyFvseE+1nBv+!tKWB*ifv2rtjyH_f8
z^K0Cn1G$KVYg{G<FMsP8ej)!Od;ft+{|7Mv7m`duk&Dg(=vY9>^Fa^yJMcJJh;-k+
zNipBsp!`zm3o1+q>YNQ+o<hajyS(WZWA`6)E9}V}a4_a6k{Bg%6yWw#pJ@Pfr-<lp
zoOEZ!lB@}hvrCF}uPd~JZzQ_OoSJ@NLgV;Vh$ZU2n4p2xJjdk(_%A$`?=*cC?Se|a
zyS^iPKvbfe_eOTVX9Fe9OlY|<98kkfO7U85A3<Ey=L9xD<b0_5$q<lgnk%|la&fMG
z^B;@yf6>DK$ypD-j-%+uTfV^328d&Us4^H*r&b@y)d5LS_$8h<H5V=p=-s}_j)0Vi
zBcT^aP?{liAFxozck7AkAmG!uM?YC#gY}x1#3lLSX|D8wr`g-C3BF=)w#8fyi;h(A
zhhB@b?YZzU{mq*CvVRzU!I<tR1a2C9i`9+kRd!`Jcj8wX;boqF97A7T5<Uec=6`Uo
z75s_5;y~*5_U!p@v#F;cS4B2qPAj9NchYDg7EE8QI0jGSK0N;B99`GnHgW`UK3v&i
zdhnk@{nac=`+3^GU<r6+f2j!F*Mk76{<`}D2D#?zBXZ2;bG&0eyTz+WAnAkT3;de%
z2!2WYORM7V`8&<vurUcQqzk0qYUJTOiUhe`?--20XKBndIR1dahaP?R<7S*e)A3C)
zKG)GY%o}+e@-DeW<br$i^fl@3si(SUlBUAXbv4iEPydv+{b&<tGZh9o=gS<AaZPky
zbOus<Tr}VBM}cj=NO0|JeHlRGO{a1vRqZr$#~~<n#-;y{=<P&(_fY$b;r+L`)OxtP
zq&{;MU-)(%;rVbUW6dCgo{s^R^ixL=6B-()+Do;e1)=(nOZ5_y*NLdT#;BP@8D4rX
ztiGfyU7Q*e8<_9Fm8+|$6L8bv=#zAqaraf|y0FJ1>0q&M^<sdM)h==@Wxt<y&YAA_
z;?O?BqStF-0t?*}`ku_U%){;KYQUoNqLXTt_mLXS6^v_j?|NJ(E6wfP2+lAe(LtOy
zgTUKppZfpXH<3&L^nv#E|9gQ800?sngj@vVw=FaSqKW~3G224iuFpX)Ho1sH+*q6T
z^=3u5nQb30QSW=U%<W8yEXLz-0<X$PH{bH@Q1$d8rT9}plW=+7;zB#4(250%r;zh6
zhnpvbp=rK#cwmli=rZ(a#I-Z_p}(Pz3JO&DTwP-=c*&OsMs3Xj_~jMB{S<W-qcm6L
zrI31qs<99Z=ewou%4f8}wo_$$sLPiSNGdnCH-U_(dQvU0`B%q$CapE_;~|Z_M8y%7
zau6l%k0y@J(4_u5shX>_*pndP?|;uhc7@41{G9+Sb+C(P(K~{O!sW;jzt4*Nvs4cp
z9D!Rr2D$9^)%7|yJ7SKch4IKxo%zhaS-#hO?&E+HEJo#Sfe4Bz1j-q7%E=<H-suUw
zQ;p5h4w2=FmZ!m5Ot*HJSiJnqHGRlaq_Tmec;}txFSYQ0^e_p-AE5QVsrTUoMvACe
zPUX)$V}&Pi;+P;3Z1(zu<=P(?d0oWNuCOhXPwK?ra1N=6n<oclwnC-DwTl6Cams9N
zuz-o&vBZu;*`l<oECYhRRpkj@YYbb91_R8T9|V{p(MLt<MGv+d!#e-klNwrRh|6D1
zTl&YIun^%kqQB$qF6~h{TvW`;jKp<pNBhP9h>=cavD%ViDcbz0^F<X9Lf62l2v=?u
zFb=034|lqn5R0qfj(ws(_(6l&S<b{jmEZTCq~3Q2j4JH6Rp1nTuJD1;mp6p6m2eKH
zbBT%3m8D|4oeBvIVLQ7Xe#H4Ii@`#Hpd<xovc@HcL)w0Y!n5<#%gqPaa}<u%*<hv{
zfZ}puK27!nyp|@e9flB#`3aO3;4i-D6gk@|zGncE{@$7lFYZi(dE5Fk1AJms3856s
zCoC}zw<0l{lgg2?MLmgQDrX(=5I_84SzuXs=f|BNk8Y2t0TkmIK7Nby$H7D(M-CO7
z<6#!K5B#gHn`v9hX<I_QihV88BNw#5#2sn&RtgCk8o6S|^f<_M-)L9}50yS-7^fjs
z<A)=g%Gg>w3=y~*41@q`M6R$7S7$|TFi{GhL-+>wUYt8O_lRl{9|ws&=s+(1M7$)%
z4kc`ho#Y!pQnGw1xG&~pgiF}m-$SLx-;%Zv--gLGA@gRvnGpg8_Zg}c5V|MlpPsa8
zeLYRdlVBBYDuJ41J!<!7J)hk3<vyxt79&-8a@X+kc)%f-a{R>_w;MO|968DuVSh)?
z2O8$OE$Ki^kxG@Yg*jeIWG?(<xckN->AoPLxBde_<vR;scy_sI=G$~+7{n9$Ap7<V
ze##W?cq)dv?WN@XNSnSsP^xlPs&Yn)C>v-qO2Y|!RaZ9G!S6ShhTZ+Q@Pf@vY7UJ)
z&{rC=U|v^To(%wxr5o-q;j3-G*RNg{KX+kXwDYmWdV=ti+#gDo##bg}R}<GkR=lK4
zB+KWv&2BaK2f62_p;>FokzD8)hC)Jd@34AQb7=rcp3VaY<(EdXviz8bmyHZi(;$@Q
zahf=PX}suo%i!maf}C5k92yK5lTNg>bgTeB#i0v^3$48%fSqSi&#>7(`|z?DkJ(L+
zyyTK&eu2>2pabdFTkYqY@l{1o9$q0z`+Zc;_}tBs5!IhSCK7BIdUs#E8{M>Tp0Pq!
zAZ?X~5)yk62J%8RXQW3grK@Mzk)mt}^zpn4?u(Ct*&x5H+W9!JL`C6oHi0wjWZFhl
z@2Rb`#5YTBkt{a`2~|pS-mLOa*snmJb!qsmx<UoHaa%Q4ps#uuoE1))z+f%s*Dcwu
zy8`11G0QC>#!k!Bm5B|cRcKGuN$fu7gll&OOs;jGDxlykqYR{S7uS#VHudUOUIBw2
zFr3t>K!nF-O5Kc~8n+@bPjAK#%+YRy|CB7I$Ok`Iox2(*E?nvk(R1-5G><ivaT2A}
z$J>oJb06chTP@PWEA_7T9V-`setq-_PTmq!cZ-W-7^T^4Mu1};)JTr%eibH_8opOQ
zd1C@cl(AV&V%O$I6l!isaWB6KW1wF&t4=L#ID6h1%IaqOj*`~q1sk5(@s?6Dwb!4Z
zq~YoDrB(ui*<Jis)0i{oDf~q$;rxHVHq^=aQw*Z&=Vv??e^7%o-EX>esS@&%ci($=
zt6v&0k|Eh%{CJNp@t}>1{<!V!wuJ9|Ziz?L^ZY;I1ILzzW!^;-(FQ*B)y_=1&f-a?
z2Uo+kKcm<vxmhgk$r-Xi!q~%@Qxy@zP1(vhDR+O0?)Z6W-V1c?zZGA%PPy$~#-(t~
zp~$>M=MS9rCy)X*$8@(s78N)!%n-GkUcH2_c!lcl>zX-TjXk+kE^pHun#JKi(qPoB
z%JDF{fCW-~>OsYzKh76&?Xn5)B|K@ZVSkw|+2CFHiNeJR8-SUD%YwWZ13TFNHY%xj
z3N;N41Wu5lM<Z?hq0Xcep%KAiGt>A!a_kJNu<Nz2PvIApZH86Y`Qq#b(<p2=1-)~t
zUx2*?3VNzmo&+*QC)EFf{<;<->^KBWpxR1zXzJI+=|mU~(SjLf7|gaYmGce`LO8uF
z&~FQtTUb4EhYRS>y;VbKNbGmhkZCeF86O-;&Ho0SS4=xfx)mEgVJdB<sUsBhq3np^
z3(Q!`5@G%{J5oXBtX=+V`I`PuN@`QyDd$-Xd!*HY1-X201@}94-_kxE&!ppE=P&tq
zoWfRG;O`8JWjY<Hla{7)mR@X$>TfZ1;?&kFHhp1Z&bVPOZHDVUm$B!F7#E{X*Ca&N
zZ+9P~eL}>BYdObi<^l^AT76b~F`sQISzTrEcoKG}Uf<1^{ZWGsx8%Nu4tgAsqltwj
zMc`t$<1c-dXB9>;b=as830pBJ4tAcom(}e8F85gTu;^U9GF`fUOgsl9^vT&1MxSZO
zG97m1)cKe(B^3_7`9e#M*B^eQDv5K%7chf;s^FLIDoMf5Ik;~WvN%ey9Cp`G6WCgb
zIcN0(?~K0@w<H;H3}D_JuUdwMhDH9aF?IO}W$w9g-#%WFNuOuC>r_Q^piKAox8Cu_
z-1}jyY6BY45p5A_^$WN#n`$o&WUY&6tNU6ZupWS4;P$TMwl(|ofo7l##KRa5%&r`Z
zh=>R~20oT-P{{lmvOb(uAHr8){A%{@f(+@Gpw!ZSQM2_H%$#u6_F$Q<Ox2u%*ykIw
z-sq@z%L+Ypmom_%j<SKy`Qe8sZfa@=k@<c5IYMuJZ=*EeEH~7HwnCR6R<~^!2xduh
z134!!J#dWa4A*bQ-|XmOUUqgpuoI}EcKwYCHox)s<5@BAke>`6<1coW({|>>R#NBa
zL}ogE+ZT2}7-Aqml!F2{7Mj&sR8YxM#}S*gn-LKqjx9Bp4AIOU!L=dh9j#@{58aa?
z*i#vm9<yKp%i-e1Ly)fdH-6-{g&RHnU^o%5P;(KyT)A5}43dU$T~48EGnY1wwbbS;
zNSvATZjdTE750iJdB~&TvVYS?b{!&gL2~M4&k~V+tthmPSRrW`Np~+Y3Sl(GfJmIt
zF(T0;Up5^Ubw`^pZ`Ac<fki`&q6E<ez3aqp>Swv46Xk*~xoxEuaT3^bedDUFZwA(j
zDv92~{i3V>DPRV<R>7L1@<g2fn=av9qzs4GL1vYZ&XzXz&l1y^3c?Iyui|KOp@n}0
z#pTo$5FB2)pj{i14nb`6xO=f@!Fr-<D;S7sT3g~Wq#NJe9Nita?`A*ge;gc{mUgC@
zpE-)3>nRGjvr<fJ5!p?~I?d`8CgcS2$KG5%E6d$u%xiQZ`5Q-!eNbE5zk4VT#c#<3
zPV7!tqyO|No->r{jrx!7_P5le)ADfbcJM&l`&<l`h$i=f)mtorR^xwOf+S%g4r6zW
z;fuy?$3RQ>c}A0rzQAM6JdgakgfBVq6wI{9b4qRT<cfH%S4q<Y$;kM<*Dvp|fs-NZ
zo=_R@B^UGJwA|LwgoNs57Vp6xLUs1tO5=xyRXy7^@QcR?tOiee?ap1h)FE;(PJYOe
z(<dm7HTiME?k!*Z=)+IGvZ5}U-PZnm96`wYuq9?F`(xIMPjn|U7zq|vgGKCeyPnpN
z(rjUm7OuNx$ai@~TPP;}DRi07Ul?O<%fhj{$Qmgwq<k=gNK%XXpXTr&{}^tl{WgWq
zJXHZFV{;n#?3)@a^-~o-hW?l?`2PL-Y&KZw%Q8tby2LeMtubLko4N<mXa6C@rvK}w
zr;zBc1Td_9r)r#L(^S1Z#&)zAVpKsN4!#W>cA>E`q2aL;7LBENaK~T#|G4_nKq%Wb
z?3pnb``8KDx9m$O`xb@Jg0hn>yJVDQX6#!iWl2SwHft(mnX#o(R4U3cGnP~`Mq&oT
z{at#V_kF+b^CR@b-1oJf=W!m#ah6Bjtnz<MLbl<k8EUZ}4PXzJzJEGbmY}B^7kJ$-
zN~yh?#lv`xd#y2spYueyf{{u+lK;bdJg#b^J3%tlIBb{vOtAtIt8lP7o&CwT?}*pz
z@y}&ya>K-5bXsZtSnTzdeZS`lOTCAQ*NU~Rv}oG#rbg!;gq4Rxe4`;sLbUqC+7ZVR
z!6LKkH5MoFG8S*t)p|ru!Cw=-Yp3KN--jQIvaEWpCG2bv0;wo`L9<R=yeqpF^FAs3
z6+0B)YfR7f5@duSk&P|FEj`8gc@p!OC@PhzCY;wFpDN~}x9{}%u*H^VBtezT9SmTH
zr3RHPM@9Uyn*JwqV^~`7hZ$5Z%WZ%{5a9G^Id+RTv`}u@pE&|VO*WVxBu)Zj2}|?m
z^q#>8x0f2IIZaMB^`+-EJuS~<99g^MeCO}yRfs3bU(*({ZSuUruh75nEMeUh{$q60
znH6!sVP9QZ1I+pBXX*KZ$1k3K(P~r^K0+1aN=f#!YhY1twipwUxxpY7oe1hlgoP}|
zhkmNUN}bK=eWSzGPWAv}asZk3PO3>H{N_cuh=4K_!-trkrVecm=;F2-wp-Q5c$BYj
zTO-Cx`@<TCU?EtOHv}5`xMk!v1Tk^i_xt+`umL;L7yw(vtikMtXZO*m`_rKTm$1~X
zeSk3dZw70K<A1sp05NiK3tN;pi(RHH>WOEHJX{BAQxyXg1K%5fDl@X|l)m}H-3R&J
zGjFjJtPwt^7`+|m2PnL7MGE@ey@dx|QLriIp}^ZIgtttBA#izRI5yfzgW5W0o0;-8
zG4efH48QoG`kt5*X~uZ`<JWhomVNH<O87ml9(tIC^O;`BUogR79r<q?<$<g597;dB
z{|J_3%ikW1vUqg$%PIfs_>-)-oO07d({m<OQ~{4f!zmdvbIPh9Yq`ISl_pG?q#w|N
z>eCpn=`~`*&?~L9Nu6LEwxp|u4*!drNV*7Y-X;~SL8A);t!UE_EyLA5)xWZXf8f2u
zVz!`<SwmAmwNVfUS$^7DHpBGfZ%je7aUA|xPSkTcmi~uryNv`GI6XMs8}hP6xkr;H
zI7+Q`zLTO?uw5JkX&8JkgzDLy8S8a4tEZZ0oI@Iw60aZe>_)1TH#~FZg&HRIn9I01
z>BaXw!baD#vRsZ4MJ~N2zFt|<!QHhgCeR~<a_dc{@xQXm8FzH54p`3PdIL&dPCE>-
zeV1zOsXw*VTXDc3F?fHEze}&8Y6+cti!it`%b7e%cv}nW;kC+})yt9cQ1Fi|ZcArC
zrxmAshh1=|#%kTRIqzmp_6Ib1)VfiNh5;RRx9l?CKk6TA-np`kn0W|v*S_=U&j>h0
zf=>o&EkI93zBc^$p9ZtwLnMC}eYsD103FJ{P3vO0ecVwILnpjr*$-|ykR&~M_qCH$
zNZ%YdXSi?zKs<d~{G48`Yv@v$v`7=a<tRbk=_b$V7HRQmq{#A#4Lr;q!oh6|>>p$l
zn^vw&3Cj|1nH<Nkq?wx#^Ohf*2wUFS*l$&1WXv>ttRL}e`PrNwYxMX9eKG!7HJtjv
ztP>L%#H^Hd&Ma|N$N5&Q@u!Ixd1!XefzOw7$5|x&6vPcso|}$;BD7p@oDw73nfI>F
zG~W`po-%kj@SZuhJ$no9+(`nv>`)cVTCR%BPo*)JVzp~H3Il<l&%R%CYjUK>yFG6L
z-15R14-Y9WUtj*OdgcFvg^h}N-_IBHJs$?6B^xuuQI~DL3EAKJyZN-Z*$@{`M7XIP
zq6@d@jSD}wh|y+&m-YCV%ZY{+^Sui<s^EHXe1s)Mhif!<kL#^&EyO*?W0nygmJKK9
z-Fct;T@M)}E^{E*$;GiP?ooIjbz*?=buNy;H+934SAL-W;CNTNPj$FWw<WuI?i_z(
z6W&c+88oXql7xl-!B+o4+(f&jw3iwdCNGfQZ0}Sa7@2Ub=ca$j<)GXJcr=C()3IH+
zKLl6%tQsfANxU`Cnw4nWp*lin2zd8qmm%)tm6EI;)71gqeVl`nvR!X$PIvLoUm8^k
z|Jom$hFP?(a7eWGjR_BLJn8#vTX*2lWmd6=t<UH*RU4#TEU)xbWG%aFhNwCVm+VEm
z3B;`_KknOCUgMK&!^1o;eH)zafLYoIT9n@kGuWb~LeNkf(<)7=_a0!$|K}C{{;=Ga
z!EyH&P-Xq)%jfmHy0&wiG3}423Afh%ka*lkrLL*PV+Sq!9-L-_$*{`Kn3}No{50`W
zlSdHP0(3v<%;5~)Poo_zTZQm)ZX(|*xvYa+SlWu4#kLaFs5b+Or8lWM8P@pw%M&*v
zjIYQssz^(}<Nd~j_C2kau|Fwu=naf$bL+OHp?@P>WT8iXN+PmGDFtc>ix_q`6>o#Q
zM7-S8l0Z0usp$jAQVs(?ruez}@6-Ml{LJsMD4LE49RCluAK(MBv!quB1PF0D`l(2f
z3;z$AFCRCGGaAIo^DV+%Bmg16CtFFCP|@J4FQ-n7c3)Xc0AnMYEXUCRme+*a>nu2t
zIld7ibZmlqp2XFsgcqQw+6`Hi{VI=c*~?S%IeN`>XyZr84K`Sefr>U}49nhpwWs@*
zIqU8t4_zMR*6kxkFC5euRDkY@<g*+*`N;^uF~u&R!A)V=b(?PW(vr~U$tjDI&k@M%
zWnXb+a-vl@IDx=?H&Gq!g%em29U${o<6qpaEqT#GRMJj5lyA1Hd3I3g2)o98yQeKE
z@1D^c>W9Al-d0dWt(%;XD{sNXjgPmt7Zv`+-}*E$aKoRb|Ibu+@9w?zirshZe|ne}
zwm-u+mbuMDqQaws9$P&#%Tund#4SYXEYS(`E8F1Mahq<wUpm<zHT}#`U~LFeV)=D3
zUCycYL*q*!>qg8fe)+?NWs!GT-;9iW$G7cOUiQKEv*;>+v&14!S~I2X+=dBwYXPCm
zQpbCjMc(<Ojm^~b1rtf~lx`kYTl4E`XpUu0`&#{+{1yyM%hngPHv+mOin{Ei7JY{o
z`royhAmDqjsUi5kCBCc)_9G)^LQ++<gk)Ytug`h;^Qp)}a6ti4U+&X^uBXtl$@a3x
z7AQTybOmvNUf0#$Q3kU0c1K8$S;zxM`QcEC&u8fxYoA4YtuB`)_0OFD)Wk>tkQ0HA
z1v-kXMs=fVql=eYwrx@we90X#QR(S_?mu!e`Km$o$dqgHY;SKTV1nbE02x`{a1!Io
zz&WM`VTS1dof<m4BXHbLW3yzfY@Zu!jaD~y?K8TCh4xir_NKSpz6t~p&N?OHV3p>5
zTCIEvy$ol+ZQ*ySWZ&ZNiu@Qm$9-dut*0w~89)&E?7r|VqciaCkg#ax`z73b9BqD|
z|4`iPyeDs4-POx9fnD>Sg~JCHvGXj|1=o}PKhFJdt5O^+l!)P9x=n)2M>hsqIS8(E
zTeK;l$XJ1B`>#FLF=P179H9*G&Ji~HlwvtbU*|Q4wI~iM4rWat-vaFh^3(!(|6$)z
z=Z9s(^D$C2JK`E}DomRx$Z_0yuH%uR&F`JpAEw6?L)y(8BR@<3)wV0b-uU!7Uf85M
z?}}2gz0#W2{x_WCs-*cp91~whGi-XfvO8@#oxXG_UjWRD#T2oj^TxNX@J}$s@+hvx
z8RRHoK|sqjydio+d?#fA8VWJCC?U0y6-JOW(!2bf`Zr%1+TssXkid${sa+qg5_q10
zWpzKdJn?MqfafJuAs`?D;QHv6FBalJ_EF9~7%+x;YC8zGUqkbI1eyBuT}w3^B(TPQ
z6xkeFB-?{21ULAUK{`0;1D=NN4b?BdLQ}AfTThu|91zOuPe>haj{LsW-c{5)hB~fm
zmU^~fW0g)q*a+H!%#u;Zblbkvs$8R{rBPNoI2hL4B@w6hE#uw#P4;7&&<PSp8}<w6
z)+lJD(PNpS0Ir8^G}uejiS6kY;ZflaAq;I)9`3_=j-ggD@emtz?d9-nZMhl~&cevc
zV`|&J!3Wa1I>wiy=?CIho_>aNaS9L1d~1d+K<Agav-)G7B~1M0qNJ7Fl`Q3JbDly{
z)jU9F6U7S;e!K%&s_%_o++xp1_M&h(D6awX#~(=@vRRJ@HzRlA*BKmA&*$sWaES6=
zLBQ}#AV+rn*mcuB?G>h7k4_@lDm#mj^5UI)0D)CB)}yxdVuX8%a`&+af01R+_SU+c
zHznk-8iK3Ay=uZujV0Rgpx1aADQ#%3+q1nBtckL;oVv-0RyB<kE!K)Lt><8{BKrfL
zc;_Z3J!ckQ5^O-(2GKibyj-X+G#cA+dJhb}lbGQh#eXvS;<lNz8-iV;G1C>Z0SC<X
zo;iLdVkv7vzb1umT~@NSlG#`o(=>cxCy?reJGAHZ$9jWX0o<_PnM>2Qe*D4)wwq6H
zOevdjIqB|J#v9g?yM;4jUeD>@)9bJ~4tjD<)c8|w2A2!p&@fYXGz*+LZPaDNM06-U
z>8NjoO=z4u=hi#ziV`6Pp#5A2?AC*N+6zQ^O*kgp5a%+!3x7WMtlAjgZyr440E5F^
zkn2c&7y{;pI>SWIOd=`{>>9040j;Gd=%d2m`Y?3%bplbMokFc;(}|R6gsi=HWMY#K
zh+DzQ@qS3wR$73Qx<4jv9E37?Kh)CBrA!GO6`_YDE0HS?LSZKW2{OlYwclYd@IKeM
z6>!Mpq1N0qb=rN&WuHwH*={SaR)~J)#J7(Cig-c~r$Vt~0YS4Y@E{^2;M`wvU(xw3
zVIj|v`Og}?AN&4bh8U4Ux4#ii-1Jn_x}GQ?*ZN~{Zl%pVug8B!QlUv!w-YuuW1oCA
z$~@u{8Z;P!&9aU3K~4??Vl?Ch!phOGG^H`D?=x-X7-yX3=AOMUZR^(x1}>6D`|MGO
zv|`I_BFsVvR>c#7&6s$@Y<Rr!8FLuJ3+|t33mixNemT~}+FyB7gL`Bo(-NIt1>e<4
zx>)IyY3KyV0qdhYtvbWICDbZx>Qh~8&!{NI(r#nx+?CT)WDWTq6cIY19JCN2YJN5T
zZ`}RNqwN>}?^yAbSnmc_SI<K7vz=@;pvlv@+eA4#j<g9FMBoSk62AHKfZ+~KxwY}}
zD2aGxf&D<_W1Zu6-Kno%V|t^2Mk(YCbnBMWdX+6lYiuS2^4tll4o&ibGg)d|i=-Oy
z3DfV9c46xcpYN8Pe9Ljum}1Mc`8tdREPF+4?v=<b`33T58?7K!<dW<r?ly!|fxhtu
zv<r>R3y#h%wc}L`vokU`DQ!p3Oe_pq-n(?kSGmEMApq-f?D93f=y;}T)A+&;W#8!!
z6C&?<7;Z+=SHEvSep&*FwGH=^F=|)o9W<aPa~fq9ugkD4s=QQ}Q9JB=`WjXGsH`oI
z=?WI&=d@|vCFn|3$wKThs+(Gzl%}}~gMC^lT;t=Tb}%l8X+X9a1#B0Z(7N%HYR`f1
zGsC=!*$4}iz@eJs`$!zE2^CwZrg6__m#T(V`;W#?8amA@f_zjWaI(uQdkdPQxm=;$
z_Z*FmNQ3hvR?!qJZQKChD4aI}_IGmUKNF%RT;qD`&qEDgCdx30QY$;@4*djD5Sk1e
zH|DUx5P%bv(sDjWs!s@g@cmr3f&4B2yQFq9HRF>B%WlX07%;4AZSm%m76swk@3$^k
z-&KVOU5c@s(Z<Vgn7i<eoe!z&k9_gt<rR;MUhcw!pzb{lcLJN=N9N>4lv>QRLf@7C
zAbMMc#t<d%)Hc8=rmf0iJ!@DeUR-Gb5ucQSJYZV${CvQ2b=_y%eN2Aj1nGM|VVfOy
z7yOaL6E)P$=l0B{-@!L^W91FMO2ojmN&C-~ZKEGl8U&ukzKq+J1+ViNjt7)>q|=2n
zfVBq8IyD}8u>#A8BHe*szf%5+EQc_u%Hp%mgRLA0Iz#x*&HLP!SF=>|aM=&HOI}>O
zDlBSYzTptEtIH_PtFi5Y{_*}T<TcNmbX*gw{_JR-_tcxE93Ldm4A%jOib|#52L8XS
z{&#ghF%I=L=OD%Q)bre^bqHXOzd!7JGt#;LDI}J@KX9Okc)kCWV%cohQzDN2(m2jE
zKKRC&E{PcKrJT}PQy<qeGHrXSvQK#R;}6WN3?~gxLmELH-fhCD8nzMW@O7|;&}DJl
zzITxOiMiAEX$_oHBIs?v)ql2I1D;1eLy0T^rcNC5-cReAD|*xQuSk<Nm{oKhl&twr
z1q<~YKTk|qngMSAa1fZH_Z<#keeBGOkzY~qeL9EqJGVN7bDAg3y}dcCD9y9Iv~cn6
z9Ur;r=5N@AO0Bqw{bX(5U`#F7F2VMXx3Cye@p=A(oPGY?_MDge#3_Bihp*HR*MDvs
znX9Qr>6caCNEyCI`Yi`o(#~|@s#Tngt^dHSPF=MTxlTQVJ<>w8vhi0Ee~lnZN!|dh
z>DPhsL~ih_2<!vSB$D_+9TtM?E=1<2w$}AWZ~UC$^3$KLt+wmvt@7V$4iw$sYEAjl
zQN+;mdL3T1T{OQf1a7=x5;(DkXG@G3r^+MGNjy48cjw|`2$G3xsPe-w!2z8GGeP|;
zsY@A;q3V5K<YRw;4JYm+7a?c1EYY|oB}28M{a}x|sfPc+OS!~9KaWTJIp!J!VkuFH
ze8NtAO+Dyr1uG~}#t46T!<s<SK-Q-&E6oi|TLw#tSeB-by_8XGPm1+y>AAL$05;yv
z_3_-?cp2?}hP9+OzfL<r9*fByrM-(NsRZa_&sA_E<^g;HEc^Hf`KE<ev1)x*WeDG^
z-sV44ybEl$snZ=(z1>N-!w2)!&XLUhfvyavv}eLP<DdaVeCWm^y}%_9seYNQqP+Rk
z*Xg=M8&&pGVc9TRf|E9Rw+Czx=5NPijX&~~{nQAL;Of59Q7m1a)0>El^Hz*|Lq8f`
z3D<J)KhJ?BAso`MPxQ55`@fT)@b>lI=ZIGHdEi;w_u_<K{EHKzmXhtME0>I0^fvQn
z`B>Pp8BP#m6e3>ip&~{0Kc9*@O-((H(S6jmv4gHLg(lplTQ;})qf}lgVV31?-qo&H
z>pUb@aMt3GYIoqfDfG<ygwe)kEv2B(DXL1|KNYV#Y(695&A4GU8OpoWy{t^?fn5=s
z!id3uG0lQSK{)<!Zu9wH?g1^rMM@4~JK3Z>n`(eNw+g)ay;!KvNYrNJGtwq4Llq3>
z)Xs>46zDtCsM`95;m6%&%MYqI%OGkBp)XSjriHMHIdhxP4gwM|>bI{Q%8T7K1fX@4
zAaFE|`qcGo5dzZYhc}#V&s$HV?y<V3VsUrWcm4gRE+Dxu@;n%Fm8HInGU@=%i_Mh%
zYk=Jg`=FosJ1159-R`zzLD@IFFyt`gd$;#BB6ja5o|YEqWyYPW=fjpC0@mlHY44C_
zu1p~qkwqzPx+Uz{+IS>^$%Ve-Mg_GMOsq%U&QqWN%6=Do#%J&kL`?<y2Md)1d_$#p
z*~dW(7H4QRTZl)hMXt#mI3X|}&Ry|poq+;>DE5l+3}57bYB&RvUAitxB|*=mT=e3o
z^@Mk?&TIQ5da#i`TtDT4EY*0%cSiQ*{pKZz`Qz#Eaav!*siT(9v+%j=o;Qys6wXc3
z!ICwk4MfwXFDA}cDv@889=Qu`?C_g)K977InEU;xbZ?5(Hhs$+o`z&6?O-hooD)WP
z5^ffZS(ZsFR5Y{y6oaxWb`I-J7wI9!HC(XIQ?u9ZsHW<cx>*<=v4zAFZ7xSMEG(>6
zwq*C-lVZL9%KT4W#-Y*bxOVfMW$<AS?6;Sab3viL>A9z;{bioq!?GbBg#s@2+)mcG
z%$0wJ4)!EJ&<nSL&+j`2jP4kmXhB};P7=EF->pUa_Kl)jYZLw~6~=6ZX{yF*<<JPw
zMvrYXmP#LDilHR%zm<6QleuLpwaxtupR;sG7bCx1G=<3?fAdVhWHwL;CknUjXhgIa
znUr&I77UaPB{j)c+ao&tPMhIQ!eY&@kvxJd?=qCmX6>@jO=BOeHol|Sp9c>Xqu+*`
z_x(92aH*_E&P#d|P|b;nd%P@!I1g5exrtib@kz@0at#g3RWEY+In>m17g*%Pz}=tu
z^G{@?kO6^sQ|2Jw%TD$Vw&aQ~Shdv@ZRS_G%bA@;&$|KM9%Q`#a^igW(|iTy74nop
zjJ*RLc!6&@UOH(3Z}WUp3C$8DG`M<ccfn@(nASNtx%f)S5TYb=ocs{(Qd?-s{qQAj
z;?*>QLrtDlyPpzPM#gcn#5Ad*LOEGrFm8B8d^>lw-Z=Ynm)D4tM-1~kG>)`kTU2br
zVsu`Gvz$mh56fC~?`9s5G29+;&C^6Ua3Y#w7-6Cfj_dn9XnZu4ZkVJsjfeH-m`I;B
z6^Fv%&SggAT%xID68|_WYv-xO<B@^Ht9vlk^*0Ad)m#4RIjd>nAKo${BrJ^8Gj%6U
z4At>6G5H0S*t{3x_zt=X-XFk9Rl_tP6X*W|N;^ONwJF-qbm~1lfK84VFsEI>|29!h
z6ihv#v4rL1B;$DChbx$dOFRt2X-N%ntF|jLu4yp+ymGQ_Wh!hUJoxF$W5=g!J)vdb
zxwdLP%9L>;fI!|5D~_IN4(IR~UpeM9kWm{+V?~G(xHx&iLx6hS{~m~9TeD*s_ka8P
z`~$Fe$Rg=kdOHuzIP$ktGY$f>&6wC_wr<|F8cQ)3+8w<UEN-dn!>`V&v-J5tprRLD
z8P}i4_Mi1$=Bp!kF7t|H-n14m^0P#>Za~DlNZ1M17%sY|ZIYS$-jAcRmtz{mAL$~w
zQVhkeho`1`WRr0mGLIbd@pDZl$ewvWhW?hxgbOSFe*X{X_J0i?t|(<UF=l66Ga!ie
zGrzAtK#X$*KzWBU{63D+khkrJhcdn-+IAnVOV!}yY%S9{ET+l^%bI&Dn&x<%^BXtU
zcOixk&$eBG>}|f!y+$_n9WcE&`M=x?^Tp9BY<3+y7gwi^(mc%RJx8r3_#fpGz!NGm
z;ll?^=lisfFiTFW`(iAKwQgX>XCB9m)yBg!pG5PtqUi6JpsIzfzzHPj{%>FrV)qwi
z`gafPtb%`8y*a&Inc6QrchZxcy`Q<;OBV&-J2^Sw{?sPNz!&LAWSKs5Rw!{3A|TOw
zEMaKtKNmJF?8n2{q1T?Ceb-)4i50BG`@FCGlG*mI!Q{@<xwBH3kLE2o3VTxzo5?g!
zi03GX%wUIr*PlD%$aK?*&4AxpQ4b$7T`0fM<wdFCP{U9Pz`z&<YCDVc??CT7-rH&Y
z{}GS97Op4TtNy*5j@45alSQo6IDM2Fb9yKE-^TQb3BI*Yl48hmb6nf1qPVv0BOjm5
zg4Gm0h7&WdZJFb(&`&oOR~aYc6Uu|l)PlPBoqMhX&Db4l-v=MxZFFTB*=U$uY~eo&
z<9EB-R<kt9G3K9`8pOb{l>J`Knt)%g`LHlX#~RU7%y*7X<18QWc>kUo4EV9cEB}4w
zm31gnbEn7$>VM<6{TOzVtQHg8*Hm#Z`KDX^-+68!7hOAiq%2Xg_>(C3%Olq0wGNdR
zuT)rGyyle7koptQyjaXg^1gqM_{eW9hnE|UyCD}HOUa*{NogKzx>*vc8f%WoD8a#O
zV>VEtnR4wKt+fERys9yFm>NS22G4OIdM6?LXMU$sWx=TKWQRNF9@e}^4h|}klYO0&
zgGlUzJ17~$=|7@JRvQ(TTlLhfw*|{px<WR4(pu3r#3m%HPgRnQ=;OG>BJ(ld8n2+g
z-?GibB4%U~&mQ;GNTrYh2Mu4$p1(2W7j~<RVjJ#PviF{>IKQ;8-KKD1TPP>7?k2#U
z)Px6!u*aUll@6h=K{cd`O(SFnU;|IInh(BDi<&wAyQ^~3DnVp1QFG1B%<6+y%=gDB
zmMA}wME=>4Ar#%hZn6h6+PO_eF+1U#v#p<h)`lIjkhE$Qsm|g^+3FtkV!>tPJmWBO
z5PAngvb1RNT#dP5n$sn{t>+>A$H!<QjeWtt?9bQr?xSifR5o9qlX6+`%v9K%)tcM<
z{;h?yGnbpU8GEW&LB7`?(6(ZKvjv8F^Yuqf*)~crt4FFg<Q?k>xk36rvW0~m;VHN=
zj`Zw|F2L|mi3QtodRkCM5z!-7_HT-m9$N(Pqr9H`q5LOSilq&U*0l1w4cBNaMX|Hj
z!&*`gYB8NV%r^_@c8q-LCf@lf{VJ=t2@XDl*PtQQ_mK#cZOh&Ygm`e6MIwB#!RqM6
zC0xDsgnpjTk*OFq{Ee(T;ilg^V4m;;GQswx%~?1lr|oqOjx)65!g*Bcbn}<D`g!1X
z1ZtP7p7d>Wy8S60yZ487-ePCOSHUEBIfHUua+fjp^}*)Wpzr^Ei*2dc0OEUDM_}Y}
zubWQB3GIa0XTI&X*|4P=?#cY<IE8S%Ph2Q)RLss`t03E5H57LU<%mn(b(1jh?Vz8z
zKt1cWE@~S~kx20E5oL?u@O)a=*!<*t*N8=|)(?Dc;c|jv1NuSM1r#qgB)xl<T&gBK
zZ0S*d(^Hz$_HV%voM!Vw{pW3YTH%+Sbd9c0VaXrou5nxwZZfXD|HwJ_$Fsky8k`qE
zo>Ys~TSGIUZtNL-_QqGX6;i1^H}{W-tc14Ypb(XL6RvqW2UPm~Z<_So3f^MBo0A6C
z<s#3__nVZ$v-d%>(hK$FEO|2)MhjQp#r8{>B!7a)k5s~>tM}^XykFPa%Q}Hg!p4g7
zu87P}a7|9p5e3)aCf$vL0ZiyZhElAyvQTGKP=_NBra0hU%PjbdbxLTLR|UW6RS~O?
zce9k*Du+vH>${DKt+SXfnOSyo+}3CDa46^5&_Ew%U)kt_+wXPGUy;In_Q-hQWaH<^
zb{<z_g4q^(@_bBiuHyMV-t?GzCo%BS_tP%2LUCJ?aGZqq6Sfu^)-$Iw38ixK(sZlA
z<4hX{BQ&UJS7NOFp^Ja6mtL}USARGM{gzX@I^vumq&ukflwzxtTHHr~a<cHHsmW&_
zH7^UCN#uVx>yO3}Y>z%xDi&`>b8ZRUkRVM5KGtT&B~syiH>&Nk-f{2ZXu9zhvB-Jq
zxz|&1`)=vB8S}i&_LEUd-QXarEXb0}Lv3cAN`RNGCP&S;Ic0E82?zx=X<~k4!FJQ!
zi8Ibe^brc|aQEMPAPskTgX4vuGn{+gpZzAvFDhpc_TDe^K>|guvoa`Z-K67y{@d+3
z<*RbyXsuhUS2P}KUP%1lFV@8}`n9T3X~4lkdP`nE7!pLSSqRR4yUuC+vfxjv`C4{P
z_D%V~D{R^J)8>8$3KrJpO}&yOckitrSa^y*RkQs-qXz<q`JVl$dw<@h_4U%MS$q{F
z3NALRGIDbEy}x={l+||k!;_3x9?dj%rjuqYP6+q<>B<-vL&T<}6gL=}t<CzlAcF0~
zl#J`ZZT(vjkA8}?-#@aFli<^)3?=VUy?N$<SP{9CZPtP<PTn5wU2u_<HumD#-sMe7
zaQQ`+J(KF>s4uN-KZ7bSxSmpgRK6Kr=y2+zaG-8w4KSS<Aw6(0xO+7Wrk`zjwY%DK
zU~+1Sx{dCnW0JaCL_r0n^~N45b&27CX(y9Pk~TXhcG0d(($7<uuzRPrJ*QZsBB!J%
zYVDI#o1NQ&ol{G6Orm6K9d+q!e>4U=Nm`a5VdxkPBAX*>39}yEdP6H|avKe>m!w`3
zTaZ8@ocB&{3sRR7Z+KJHDw7z_m=w|=hS>YIoluF{oSaU)u!M<Cp;Fm29l9i@wJ=G9
z{Hdix_xw&022r$k>G$N6aU}+u)LyTg)ZXE%L^m|V{HCAn@$8&j$nBzIxN>7ghzl9?
zlu2ewM~DHP-u@gsEO;x2oXN?hWr@ipS}Bzdo{%|Cn4Bd0%uX$2w4_XKO)g806W&ht
z#kzNrmdD%MsZbu3{`^~e`(}FwiaAc|kpkm{L7l<CWqumY9+o_v$VTLrdH7OX_7a13
z%38h=Vm;W1IE5>(NPEWeKq*n;F|26F;(!zpkq@7jT4k#(G+yyr>U*Kb4VrO1?t<;j
z;d{vk|CJ^(Mjqr*AH#;1JG})clhGfslgnw`&fD<sEU1^TTUd+C{>sjkr7Ehu^B3CD
zrt?9Ae2}!5i@R6ozF`>;%clhf@WVmBlm+Z$GRj$RX~^t;h>%>_x;}8SFPc*Y78Hru
zhXo>k=>@2l6V~}Yt7JaToY4I#ky^a4hM`FDlPY{iMO{mUhrd5;17*G#afRcBd=80^
zgt5{kJyD`A(R9*<H8_q<)}j5vH^cG^@BKn4nqjgXFIpYay%dK;+X=}XZeChoN~ufU
zAgj-zZi1|xSki-O?<Dns5sST6=0MJvg3Wv+73iXDS8%NTS>k@-uS~=`;OND^Ox<w^
z<_J@<y67Rd_U^XnRN@+<D5G$8H}3^FeD)qW=3>nLJxqy)DJEnRM1Z<cImh5fUhIdR
z;(wMzJ8+^o)k<;@n`fHEB2x;xXKjd?9T&=`$Qir|u8xYuiBaUL?s<q<$r<fR&$rbe
zlQ~@P;)$^G@9{tl%TF8+-y1%&hz?_D-=$|Lq^Aj+11&Ai5BL*(TNFMQWIOoVNWP3{
zNEw`gXh<BljfF=Bf%OszPmzmDb)RQE8`UP`{C1Tv2^2Vg23kKLu9M-fM0nYXNYYjE
zC5Kvkz2=}p`i6qT*3tLLEPM=A>^wWnShZn4^O7jyYouCiqn?vdwn=<b)0L_!qE|Y9
zW%rLTUPtBpxk1TFpIzc!Un^4B=C+WEnnyHlm6>a2sA4pBCSjB#COo69CwS&Sp#a(P
z{Mb*D+{leW!K-Fw5bYk@U#gkcBxx*DJV>y^irLY+4InNIRxoLbKG;d@&K2d<ovh}r
z`g5-e^0%$zzvs$_Gj9{eTVAK$B;m;!7Sv*DF?{%#p<wBDBYeQr<^o$P^Ir4vqlZOl
z*Q=h$lBf_3mrHtWb3o{=3{9dAKtjx&5S9O<^R$flL>U!EdcaS(BNY53Sax{cPaXD7
z7dE2Ps=9v9uTGq|rFe)dr6{P`&p759udveT+snx5;o#*|)#ni$!uRYq+F;^ZYRQQw
zWwq))%b4277sC=*ro--xDCSBp1dkg@96EPcIzE&;=f~nkTwa9S=DR~JjxzDel!tk&
zrQPM@k!=Se<Tu~F4@=jT7&SVNh1tS!cS-s8IUNJgg9Ca3=~pbm<M~5T$E6A~UI>_A
zJ-+QC@)i-}bws&~jOpDnvw`N+Y!Rk?pp^*I@vGQI+y`QO*^HWhQHmeu;Bvbk>%mmr
zXW;>;^wrW2sPyH%ucLDJ^};WXVp}f{EcTv$8SFaV+?1R^Pnv=RJE=4US{bIDP)emL
zSGKPwJ;#$#a!iD&sj@u}6)!WtZ<+lYot(%nUwt~;A~hVPGC(F}7;!!+;Hdri=X--M
zBfHkzy#d;g-oAxEFxU*P6^b+;5zznRO~wI=GiOfewL2O1T$WL9ZKU3GN<RH&rJ6Wp
zPSnbVKV~<+c1(2HZ&0k(ZFBRyoWo!pLkP(#lUr*$!G3BE|FO_>a+02uXran}*1^Uz
zwlsSVWD?XrfSbtBeOq<r2OX+axqWv_J>bNlGKe;fH)0>r1#))d552h$QYG!~W?Nr^
zpnaRkM%8-ReizOpsFkYo^v}b-<D~fCdmLNaSYUiI1Z9-?FQJdWO}MQYmXuX^X`@*M
ztV{4Phrusz@$rvSSzz3()EvVNOrI7i4KEFgtNYeQP`Cg)m0nPZblE%AXcy`;G-3U$
zM~1A*ZSmp+9tnNrJkTbG=KXew{T}|yz0uDPs^?YRt7^t%FRQBSocAxst_s)*o!ZX~
zf<<<OzWEkCL(WX#oU*vHdsF1)0Tx{!<S^B^l?hjY6?57hbt57(1x8(AHiqw0;E01k
zIU+ndN|A}zf=Nm?kO*7Ny;vnHoh>=D7V9&99cg<G>z-;TJIE5k@(mT=9Y!25(hs&m
ze0{k9x{~}L3gCng0=U}Yg~aFi<lQ(E)F<11C_@W$j7t@5<-hsx`*P>B(W5Eq5=DcA
z!7FEAFr8BnxF5moI-PiZip~IsW*6)<?ZijiFC+|YXDP}R8m@WV_T81t;LD%9J8;!-
z-quU6B|osCYGlm$V-&;9lZlXd?{1V#bMH~@*LAWIbxDuM^CoDxqddAVIEZCY#g-4&
zJX=7y88GU4In_2r53NUqeS0z$_U(2NGp|?7>_H^R!`J%u7=1XKqYUWaB{|CIR-n%F
zp@{lSo>AEXG&<1lr*se$AqFk*7eT12CJgS;<zb}uox@S8GaC6Gv8FqJ-V=@*5)*8M
z-n3fy{2DFoKHjCy=P7&Tps2S1Ba`fkWFaq>_^UM+-8bdEtmSoMdt~e0w^GVU>#%6z
z=Z_Nx7ffhZji^gY<{AD6#T1rsJmR(XSPrioZdmjmRk?Tj)+;|7pPgz)cy@59JX8O5
zt0bM(cnQW=12Zc*m+G9PQcbhW*z`Tuxlex-T3z5%VjRJ)#LjW4iykBz3Gs>0;+CX!
z<Y(PpB{<S#h^aI|qRR+-3QLltMY*RC&i(M7LK-iQ1AnQe+|U2ZW4Mj|0lYn{PXDn$
zaSu~-B7qXu_yH#w{?NjC#nVA}BO0kR6M5sKf;3Jt?&R3VA5RHsqw(f&ZhL~xrXP3U
z#niyn;dQH^Ec2fN()|hUzc`lf!c9gyI3y2%kO%}y^-(Zwr9UDV8N}-b|NB@LLM<yy
z#LhDDyLe!6P+`v7M$>Uz-Fbwha&x-<I_pXtb3X^*tJtra5NSyM^WN?4U2;NKH5CT|
z22F3Rn|#mc=kRbdm+M<XuLB&lu8joz3qbmvl?x00p?;Qn^(kW>I}k7@u(ad&#LaTB
zXy0nX0_)db;SdpRA%rONdWK9j&uT4L4JcUN@$h8DN^v%RVD*iiF$v8n<wyI%`{8)i
zcf_?jH!muTKVG#H->fr9y*BxFMswe;wZ2^Oqk+|SwFmL?JnV8F@rN+U4yTqkYpQUG
z%S{_DTbH&WSoo`1wzsZB-?J{mq%UMNUGQT4x&*aX;j$EbD>nUjj%dA^e3FvKQ3Vr;
z#IaBP7JWLpTDU(wylAajZQT4r#=sVv(ZGi+_)EC9(9?29^q8xwFWHd1B|G$U#o{9z
z86+=(jey_3_5MObq`6lf3j2%6QjG9ZHKDNyEA+yvrf_@XpJ|V-*-gUA?S9)_MfuTH
z7zYn?mH#lkYlGV2no?<))?M~&^yM7LrI;<XuSX{e$=Da9$!9*<>u^C@=vL3ynPcr@
z+PmhQpFVnJiLXCo<Y{x<rLQYy-eEVfk@cc3G3bdDw(Aq*()Sg1)g5nxf|d2=jlfmQ
ze?2SL)=tN{r(hpGeAtvX^%p4txWr!whlh+j{O7#{uo!D_+8oI+T-gZg;f3)_KcqYD
z*)mzm(3TWQC_O}QGRicS?T4|y9IF!6eBJ<kTVrtLDH$LioC>|&73e!Ui;zebn`GeJ
z*Ac}M?jg8d3#F1TT(6@G4MUUIN0M=$P`T6o_K0R-+oLjg?agT%OjZT;Hh-wp)(%>&
zRD8stS~N~<eBqgBwrz@Io0d_!(ipP8IXYSIu#8D{5mi{44Gs$~;xNUB4+9Ix8jG{`
zS+gzGkFLDX#h&akduJ29RZB2kMpr-!oU~|c7Dv;DMg%o?pdlWP6W=nL)p0nT%7zZm
zYki%S@{7&R{@Z*W$K9WEC68s79Gx%Kt$KfeIQ@`q`#2WM62^Ge?knx`{=(|B!KH%D
z=^cy4d*)A0l73GzIS@QJdwMq%50k^roj(#uxX61V9T%tEI>xa}4}ShPEq}`<i>Hib
zXSZ`Bt^*`w5=d1%+uLuS*0FR}KW6(6&m5@jwb|-=Wqisux9GkLQjexZ_w56DJwPX{
zDDyDAMa8|4A<sd+)eTMGE=6EQ=(l)B;!$EqJJUoVdy7@MA^+6^KgAZd3lpxZlR6n&
zM}p93)>JiKt|#-YYK?*`S!@IDUlSDzk1jqwb(0_YtKN{@CzdG_;^^ZMnKm$$$Nf`1
zLyg5V+pGxN@%f~v__uy>92s?@*RD?`pJd~4Ddpph&YNxc8nctqiC!pk4XwjBuOU%6
z?+<Ytxbj=o@ADEa%z(eGqL5>-`oN6x<SQr=>R8?#2j8T;w3m9>-xSg&CtL3@PlD0l
zxMZ}tw7JBPrb443Wl2+*-|uRE^`4lW)W_>MDansTz5{QaH!#Bvn~k^YUP$Y~b2#C=
z*l9XeY)6N8j~aMMA(1V)ner7SC>Acvcst05+HYSA&)fVLLff&i6*E`bPmkW-&Nr`@
z|F^wB4(%Ik(CMaWQkS#xZ!B4Sla^mPzTgFF`)uJ(dq+Fm%b1wwaC09Fk2xrqt5hSU
zF=K>rh;b2CPsDKTGi}E|$U-@#SU3*&XBjw_%2dIPJMmM#(`>P`@Y6c+{e&qNn{nP7
zCAY23;To$vvT;HEN8nG7%p45NIsMfruZ5*m;sW<BIg7$ILH*|Rw3ilHj`ch^)x~t_
zk_x_UYqrKp9ET|+6zmH@tfGyaS^-VIE?qEDJx`vaUb(+Hwfuy9dN#%yQ$A31Yu!hg
zCs>&*>*rM7uXK5!{DXx9t_^j?r<`L+6M@SfPP76?I;I_Om(hZ0pFqNNq+o?EAxI@2
z<k@f;mVN0s!pWDgzP{=!NRLT_y?k`qGUL|X^+w&79z041@s|)M^}@I%=!NGlYb#S6
zJ8oW@+))PsNHB`ZOg(#U6ddILbaiMAgaxi$ZNLyV7q3tKRg3&BUYsL}nUqNTG|WPb
zVbXBNwmexB#t-M}2MqsMA1qkYOr37~Q_4~Xbnebdk)sIjwL!F65KMFmdGjLtMsem@
zeSLE#i2@&GWpBGbXLZ_JZy!nsaFEZQ7yjX1bd8buf)`e(urNwSk?rpvyPt#3LrO)y
z@|awXapeiaBoS}+h;~kG67m65KqQNETG-+*%T@OvwiaYq&ZehfF9AANR$uiYGUCpa
z5M^hi-yvz%60`3Vdkc@x6m)M(IC1ojG-WRYAs!x>;*#GN)a2zJMP0I^!6ji9$oHQ*
zKOOVV&Daq@WQu@>77%dH77}`J3UCyl!?$*d2RppGX<T;SndTWug0Iu&GT{pVp3&8c
zbh}%*igH5X?*Sj)sG2|iRjcvj9H-&er8T;FH1QVeMKj=rB<pz}ZSmMVV>^NmIswHz
z4#KC5<z4$eC8OI_fq@DnK_1BFMx_!Uh;wNHB8$KzwN-w5Ll|ryZEP>R$R^Au-mo@J
zJ-giuL%t)47@Az-G?ZE#iDCI=$qg;#xbPdgE@>%W23PT402(}*dFF%^@G>K<>#hHt
z+ngSMtsKxJn~Q=5e3|)!8UQZuk1C=_=P2nIhUHFTd#*OyJ9zjTlxBB`$kw2Lnbz39
zOO$!{At$>YhRA<yeK#akh=>5Goi|OGJ`eq#;xPV7yv>3;C6BX-)<0Dec#3W7RIBby
z+FtniVLFS7iPWEWW@m{Enf1pESChmeyH4_jArFGwgyFLj`pfq*YSDj^-VFQ$;Dg6r
zPPDgMHu%>eC&!D*(Ir^~in`O5d#9V10Rb@r)LBx)SFfdCJ$nrOvIm)NAGCj0>6Ldb
zqqqZtafWq<5M)kNfMuNGIYFn#yj(3wztof_5tcT+PGTZl#5rSPHGdFmxsS1rdC%PK
z@pt+j^>}Vb>4fsUw(&!wvw7(){Yx0^U}vu>DJC+*((%q-gbx25n9HP59D9E$k%fg(
z)Uf>pV)aYb;Yjz{vt)vFEDDYgSBG*~D<b=2re*dTYW#AqdGY-7Ux`^1BKl*}*4f|x
zosTMH5^uhO=*f`gu775UQ6TV@*KTE}t^zb?^)n1m0KB&BefuXG?I>02L1Kfsa(cbo
zZw9-6k!?oK<Rn886iybCb`7|Q9hvZh$)I4)RU%cKalDDzQh3}_IR#(Un?(`eKeVf7
z!^<%kehdDpby~FG!}r)YxenazyR!YaalgLgE4-{6Ko|`s+aI}k3whnZJ*7Eyi*1HY
z0<Z1gn$DJ%n4*n5Bg&pJJS4_0?JCh5BOXkv-m{1QWv!TSv)BN$3j$%KV08?t61gX2
zJ4g4lddp+OK9gSq?fXr3tm{QAsc6m}n(5@k+Ri-hyelO_VD&V?cU5&~UG5AB<CnIY
z(~jHf-`|)B8PpErXi?fwjn{L9TP08<JgkBFV`nmjEl2UCo;S$#%icg3u*^ksO1fUA
z7^?Q<3LX~S*B+@Q2YYUME^62A{tCW5fAIJl-27vn?<3@se{H+${v-;|j59c4wwHMH
zxG|Q`k0s&2aRs<6HxmBn65G*KV%<8@`t9Gunmfgu0WDcUd@8Ui?rcZl!iV8y9!`DO
z49}+tg^eayqhXEX$0P4Qcm@&G&<;w^{1943A+H6HiKTmcCp6XB<%Z(%=4hc-@${4I
z*{qD=ORKfABSAjWNi^fThjPQCKFMJEuS3YqWR*(6Mskg(zajgb5*2D7HQ<{$5DWod
z7zzd!68>SQH_VUO|7_xa<tgJ5gywb9zyIlZy)=O2;WP;8n}r^zKLdtv8c`<PUNoX~
zSR!w7*y9T%?cwL9J7zQc*|P^WJB>!1b2zb!V)!(i*f?F_rZ${)jHpbcAm8Z(z54zP
z!SIxtxs~uPyLlVUT2iV(%J5PK=Sl!@z~8B>0at>HPmR4zv6>$fPI#6MY{XP%hg3pW
z+QPBx8#@ogU=howevUXS5hG{_nr%qLeIEQV`e%hPj}j?s-uVk0fVyBuSi$}+)M?JU
zLQ6>@$(odYy>Fq(?{a%~YWRRFBX^;`7Ha<ZmAmx7wNdlE4h@3Y9IdeI(G(JNJKc2x
zw5FdsIf6k;mud&_=GZBc6Sq-4`|V!B7n(}m-ErpgLuxjC?2FTmrS!V8IKbK)%isn*
zC*$H28BRomUdqT-!gy&t3E1PydfM;r5|?(6?&DUz^OVU!GeQYgk$)B_+-U>sf=Bz`
zXfJ3iPA*04Few-uZ~#Jry4~cI8CvvZP7}g=@?js%f*;xRh0or^O|42m1=yi3))a>x
zLHm+hZ_1LbFNm!&;Z`-jx4FOVV?yv^eok*du->_3LD}?=u$P>i8oGcV3aXyknC*=w
zaU(6Yv?kn}0HL5I+U8}$d7?PI*%o`XL(u6WP3iF#|K^J%6aOrlq{uNxhJyN+V~GZ4
zd~AKYdD8ki!@2(4@CVUc4&_<p1z&Z|w&))IWlZVe!PFH!@I`Ux%$rme9xwf31S*vW
zV%E?P?yt|B2;bIEr<-k((Xbp<Pz`MIuvlq!qN7dRVz!+H``|Ld79S@XTQ!4e;oFj)
zO`ds^@7*vxQ7jL_ZU8U$boVoR+OGjNw`3Kwf${0>@wbM*?qyKL&x2~A4?ik**~>lI
zY8mDt!J?jhpXJl3%P#YVQz9v8Pc3fX?_Ah;cY-yio$U0LPt!p#^t`oAujW1@rVK+E
z=VYSdq=0sJcY~!m+Dl(Q($PQpBAOTVLBS}%CWJD<!wSDOqaPn_BTk0=>MoQ%5_B(-
zGz#YYVzU(FMV0)TDqeY&B^`Y(?P*JC1OLS=F$+?iA)f2GqIfSK#~{O-sCYUq9J{(Q
zzkxTdJV}m0aojoBE-Y61Cr0+|9g;cOf>odyGdVGEpD%1sYq15~^)wuyWKb!mtc=^+
zr=~uk<+EgNOI?<o*N=pkzVp<m@i?G)_hzf72Ic*-_^o#3R2Bs4<{kFTP6O?K?f;oS
zDa8ue3yfGgNT+MLz9skN#CkvPOS>RLR*35z0T_qpH6cL4oo?X<J^`J&ef=*yC(B|!
zC?K@VXt}7!9=P$lvtmvL``KBS-x=A1UX^$10+!jtC#E!(t`AZM;Gbu^y#d!sDkWK)
za6txI&6rSnb~$OgjWBdrV{qIU7<YdOs~YC(T-*kt2EfIKRx9$h3J0XJeRg&n!_SFo
zfL}<MXB6Ww=@;6B4A`UP=`~V0X3hw8=eAKD;oq)ytRZT^2*!w$t*9dBScd7l=0-Is
zyj~1h(vcRc)p(58+v$Z#en?vL>yZfI72=0TLL_0F9b2CE>ugMP5oHv<CV1bf#fG#`
zVSav|!d?Bk5oO8!$YY3u;k0EpE0cA+R<<}ux>o9pxggfX^$jGrr&ltN5^9{?4yV3I
zg#?$TmJrdxb>Z;Ni-0_bbG*Ldzr;{2F*Os65ipHig07+i>aC+hS+zx@f?Ow<`v=bO
zHcf0vLSBIoFjfTAGXO;~-P=YFdI?f>Tfj=M18p(Q74x#^Tx%i|2BewCMz)1q@J>=v
z^u%<JXmiE^kNQ;<67DVx2qIu&>?keBF6YgyGFst<OABu~s;6b0TKyecFbP&a)r5O;
z;|lHv`9gO6+m1JbV6ipRKPsc^Ax6s=aI0Z})pVD}s~^BN-<X2oRjs<o4E`pKF$@7_
zru*yk-aA70PhPzb+Zyzw0wmqdIJ%^a=eGgBzC1pyeBShR$t_1nfY(Y)^Cj_-3D1)X
zcKgtZE?*up;(d8>ZGE=hjp_Y5^VeG0`C?U1na~S_#v<yyx21?KDi8ZmA#w+O1v3MT
z7YrK*%rV2m#KQ**pI>`nA$0ot>9i@!pTSD8I<z$O!9Z;XK0;fSFb5u=>m^1x-q0B$
z3~49EGSIMeM5vS1>yU*g>pK`TDfu>bw{Y!j9?D(4+4f7`!<VQBF`}CTU0r$k#%0PY
zOdCOKtBMmB_1?_)Cjeja(0DBenb<?KMpw=ZCHe|+IK`QFH0Jo{Dx(R=QS*ex+1Gx*
z1XVLGOAvn?%kgKM9G(k_bHfOEy*@rH6GWPljNv!9mbBvghXm}`yKM*SJzvC4m>mo?
zzSoO@AA3d%WVp?>+}H(}{_%rYN=rD?GdpfLcgH-x3v3K9^1O354Pj?npCx_fNlcm8
za(c6{0<<VnZWYwz;q@xLA5EvS<K6^lU$HA^zk@~`)awGL8#a6n`+D7Xh2hMWs}v^u
z%CqgN_)Rs8V$`?L;0%Kq6|<)spQ5puA}>4(&5M8@)IF&m^R|<Doiv!#DqvJAX|=CJ
zW}5#cn5T#e2gmD-XdZ=0Xg!R}P;_Z%Nt6%*2sH-et7CDa<i7eKelJJ0s*qQlpy7?x
zmR%c(X7qg4==zz}EjQ4ts09`Zxh^rIW^sH^s~Q$8F?_~aE4{rzF}vC;)!G(-J);F{
zu&@35s^=rA<=o^}Hwg@6OSpjP%i&Ba)AMo<XaW-55p{d~`NNw9rJ_J8d8}MxKD{mS
z#|VH@V_|!216A`b_a6%Qteh%%6bqH2BPVu7ZHS3LBZ6<j1a}lU-D@MdmLjaJ)TM-_
z7axtP&!#Q{Yl$<9OoR?+OeDi?xLD$X?k|?w_7*Djg3%{PtomZ;K20t6;WS|x;2oJc
zAsA-9#C(?yIM81vjiO<EgqMT}hb<<j`6_YXJ%S&KkV@}*^@;@bk&-%pM`Jap+YX?1
zI>CWP!(_Om4FmNZL&11GVUALq-k5UEZ!u{vQURwfH?8x1dq6YM{oIzK6&&V_!RRTr
z->O~OA*ZQ+;i0P0YtgLw2X*Xg64o}YlG<;d1D&ig`&4#JaZo7ayW98>nTR?330*nX
z_)DPig#2mw{ZD8&q}E*a9!Z4Oq+$&F26}J>7dz`QZxiTq8A=o`-`&uT$2`b&O^}F3
zAQk{$fa7z0g@Ch9w6IVGRo*&~Kks7I!<D;Qr2dH1i;6Tz*MEFPtM`?I>JbPnBkcVP
z_?pDh)%wGPJU1mNrV54g%VKg7#;|La`fjOeSYblhQwKc)teOpB@OxJOk`V5q+aX>K
z_y@2UP(Ht2uV_sROXpqYow~HjMEG-BVER9sq?0J;(~s4B80%S8zW?ODf*K^%Y9Y6@
zJvY}$>i5N9Vif!`93@ph=_LlcOw@vvCb8Y;{DsfG;6z7nzPtGz7R?}B3B<p>?1LF<
zt?QCe1<W8S9YDN&jly5e=cYaUZJBb>4G^vx%@N)0qZX^G7*UzajgV+_HCH|zQL7!%
zh%l_yYNJ!^&xy*Btj6jlf4NQXL<`a&lBrKgIkyC*t%NI~#`}=xmyP_i5y-R!(*p*2
zw`rEh$72n`d4KW%K%<=eZSL6+a%`Qfd$&myyRj!S;nGK&DG|rSqlId*o_RxPwnY#)
z#bdc~R*8P>M72@j2?K@R616uXgO2m(c~y9y&2`8{Rzb5i2SF!990O&vU^l;guxkZe
zdD@Z>u3Ytbft)+}*<OKa7v(n5dkLdGd%b^?1k1@~_1aq@s~#z+4(o^MT+>u%Au=6a
zaQneB49I0mXScZ@T|>w|AN{<3s7=+~cuPo=BBr>qxxHN`_Vd@aY^u^~=PMErSj4f1
zZKQi10e#-QQ%yty@AigdP4`Hch}ID)F-F)IG7QB_>>Wia38K}Q%klT66?fgs2%a_s
zSjNQ+n;z90L9H2Sie9d1s;#B!l9`4D)tHt6Z9nh9s4pbI*FCJ&$EvBAKBWd%(=rSN
z7t)#W=Nz>bIM<}SWe?p`c1AL2t-d2(VWs@}KP&cxzE^&@tbGtn<cPYXY9>3PeGwSy
z00)rPI>~9_bTBP02?9qxM9q(S9U1<JoJ8hK&+>AqE_qC87x>OK`FJJEi+(B7$G3cs
zwXk0$m@`BjS$6MX_%4#~XlvE0XMgoVp2PKIb}?0Zi#Xnjcc$f7*mh02n=OG)><|5#
zHNjC-Joo|hFl^qK230!P`fe@JgI&Ix`_SQ25+m;CFKliSia9Em>lwkETg|1D6K#!q
zUeqVzQ(A@WuYPuV>1y2;y*)LaD2t9NJ`viN22UyVY831Ol;daYJQ~{S(YwnEU$>v<
zD*ntNJgx>cID<FZ9cdl>i~16~sU6^Me)-UB^_8Juw;|5&$u*uW1MRs;$uXAF*C)n9
z^<Q{g-WLSRGPu`}7{e*8cz@3m)Dq{R>_7|m)&IlPS;sXQw(Wm|(KWhZG)RLI(x8Hb
ziUml62udTm>41&yFhDv)v5-;;M~sjV6ch!N*k}=02(kfV``!3F@B9Av!w-(};oiM#
zSDfc@e2+&F>}VM08SYacZm8z?Z5@z8Q<B{Hs28q@V#%^Pw%y&{kX&$8leB{kjG5M_
zP!ezF89{7;nj{?>>DkU;XJyJGYJXRj%<HgGpsNhILj@9+3;Eu?I+>Wz^|2Jjl4k>a
zIy*xQf+TbkP358SChQ5V)esl%a!3b7{1l&%KJ~VPtP6zfj>)OSL<4U;fN~`(0(m0N
zH7m517H>K=nWb;}u`oI99Lw3fR~GV*jxUIEsxoEkXH$Vh6b6}-tL}<iBqwv%$p?Rw
zuqD6DuvKL@JLN1-?#EeYfOZ0<c_t^l8QiL|1wg=67rjpvKK2-WB&MLE`1;y22B+_T
z$-ccWnM}vc_5Y@*%ZDV2h(>SK)AeL8%}IOmt3TC1{?w4&{1Q4Lb@#}6;*q?jY#Ltt
z67bs@kutS6h(Mgs+TV7o=h|4y1n@UGs>j;q^v82Dw&m;mqnL%5^|FYcXrAC}r{CV~
zAosNimN;$0S_I(+8dq)=^WPGHB>Hf>txZH<TgnRAsuf~o#U?yXFkbiFGj_M-nN*qk
z{hZqPBg%d%T(GrtGPSvkVd`;CGGR{lW6W`-Fp#C#F-|>Ks%n)Yikr!}+9f^G5R-t$
zPTfmtmlG|#oOM^f+1WgQLL(bIkl|}j>WK&sf>PDm)#a&z)E^6+!|cDh#(GR2ihaw}
z^R=(J+8q!f{odx4qxKVLm%l^phw@UuR51GQ=uMVE{X2nEgYpi7yNHy}>p)!0E^P@Y
zn*v%-of9?ECJDBQ4c6>89~^pJfIZ~y!R+W#ei~%Ar!e+C#AA``oY3^$#Dp(?ykbF+
z@W-q%61^`$$r_LhdJ(_)8LPZY8MM~v=9yFMRT?h8!;ktMH9<`R|K(fnw{oqYG?;z4
zpxg7*uS=vm@jEw~Lu_q&r-V6DNHRD2u2FOzt13t1iVKrf3{=q}8_7@Lc*gNPDcxOL
z^tNs5PDcq<%H(w`IgygRR3Z|qq5ZJLN~joNOp`8b<~|<*7Ce3hlT&)1nen_)nzWAQ
z;(C29GGZju9~W*RC^n)~*zcR@K#B`4$|2E0m!&w`9Ix~6PMIi;C@)<a?`oBPC^=B6
z2!4_jV3Xl@_1HZPeq#OK-Eacr7dsU8Kws^XEe?-9^I*@<bZV!g@y+BzdP72nZp2eV
z45niZXz;clie>fh{JYElsty*J-ST5mSN<cI{wIb6^z%aI+t!D@#)WYA(RF7SJ`8kw
z=dr%hlej#cZAZ2O-c+ZIN;Tc!&y|AVDXL@slT9cO3vE$RQH~-dbPHgg5x!RTNl+`<
z`p=M<UsMHSzo{fnrW?@uALFuZhfZ&UD{WBrb0U)FAAW_=-jIB9&a-8@gieQi6#U6!
za-tcH2<J7b^&rW%b@G_RtLn&18tDa}ol%hulwri%K)^=Q!$&T19?`o9t>R)qjHIY!
zN1W7d`hz>H^#Od`LpRJ}m4}Y9$izy;U6lQ2Mmel0N6IMlM}GtuUnJ;0?g8-Z3NonX
zP-U%ZDGI-9{@5zDr@ZkN@H!5^oFk)xK2{5enD=!tqd7oMVwVucNx8nIT@N{pV8T!M
z{YW-$-KV)$(?rUIPHseW`$>e{YX81sv>EYq=AI@7^ZdG-E4zEtH2JWa1i&T!=bC`;
z|F6*h@2a@cydk`lf1SfV4oo|vj{n|86)c&B#Cn#(K?^^zA*A{OcH~m9z!`v#%@*1B
ziH$Z%?p%y9?CmHh*F38;dW}UxM|Mh{`jr1pPW1TYAi2xms%-nMu?kYMs<3Fxjfd!!
z6P(T3uIQ6+j2MtasVq{^vc3zPSy%suJ^SDL^}jbRnUv&!IAGKi>-HV*36luu+8!T2
zqtJ(9F@(b{VrMRM8ReaJhE=+x9I(r#BWu|yeDs9RrfU9*;Bz?FoeP5`<ZejwMucpw
z$nf=Y&FrD;`n|&QhD;KH9~oUZ9z0i7KkYztPoEwacO}64&V><u`~`G8cY-!r#58`&
z$4GvzO1N#37sbue)%5-hGt*NZh!aujtdx(qy82WqNEjRDn7D_3#Q{v^DSoHi2V6=L
z*nuj-8ex`l8>l=T7K0-Rdw^TP`hWEG|Hgypt5uc%X}$Dm-8$?t%)^-0-W*jWz`E${
zB9Xro1yypvP_vkd<mX1IoR#q?*Su%w2SsACyD7gvRqklMm3j}+q@SM8h!m@qUN;}y
zy7SWP<)B#wpAiJkw<c?WX-S+-Jf-Ux-lZI{i8L&YZu;vawNGUQu`@?ke+2dK7!|Pe
zR<88H5Y7c-{8aPdGXDOWvT)KGjQf+4AS2IY`%7*Y1ND-R#u;;&(m{g7D~96vIO;yA
z^Koq%q;Xj;nVS16gI*c&niX0qbsXoUx(!X$or5;xhly0nPH@2WpV!Rm{tC(p2LmVT
zN|3;e8QNhne?0IL<C}0|6CJ1m^Z$QPY-;-~73}l>&jvsqPs;Uud!UELAvJ~A*<6C$
zv5+D{bX`y2^H>MEUMlMFW9{0+WIMp-qwGGD8!>mzqpKB|Ct3d%io;O&MS)j9FwMy@
z!diWeAp=GK#9*pr*Oeh+;6QT*>T;d!wCt+#>X(r4xUlw$MF$Omg(Zu&dt$17yo<FH
zNN^A#_xZWc{z{}v@au<LDm{I#DIl!$XGjK+#_(<%i~@KwH~-g{uuF&VqWB;EuWJHm
z>Ox0KLKS~9_ERrfP3(eY&JLKQLB6=wy2uW12-*1vA)LPQz?hOm-$ax|zK&n}tiHeC
z!ydfOOnGB)ein2ru3{m7)vXQLDpYxziQO9Hum5pqZu;*c$g=2yFItc9_U+g$Hxl^I
zyjjM>)zMKX=i^3?8u_ft?m}U(n3a3Lsq%lPR%(Ygv<4V-|2qJIi_=mt7`r!{%pl44
zkKBc%H{HU^3p`k&NoFB4hM89$TZ2bHmAV~r-;;?T4c$-1mfIBv%&eoJ1X7DOX+yx^
zGrBA2<s1zw)21FWqWWC6FJbps1I%ZqG`Ms}HiN8Q7O*r&7w9B*73{~`L-PEfXc2LV
zD?!j06Wx)qIWRR}m_2G8&w1QRuBvnhe2y>ddJ^wqaT1P!eKPJ<9JtrV<SI6r8%J35
zg=juGcUWB0*UHMuWU#v@$Yt{kY=fhz`V?r}VLl<Sh5(#+nZqUf@Sm++Iui_nJ*?y5
z^JEI78l*W-*YSf8b2UW_DV7ht{<sM!q>#fk+Fw~+AE8<0)OQM>eD#y%tkU8%dq^cq
zuZW0XE6aOxHqc_c+6A#z2|pt-);l&>P?E{XR4PQ@=ZLZ&7;{|rT%M1PSf!5JlCAv$
zkdeq^`D9$E>ex^h4WC-ir{$XlfBUze*S|RXlW(4EONkh3(*y~Jbnn)_%JS|;V?EXq
zg#P^QgXi2n^$ewBrt}dGsCuD*3KVhP1n`gJ(Rv2Q_k-LvHhaa~h39Mcg3_TRXzCfa
z_l#Usqdt!_RwxZtNzB0+C^y^vFGUSEc#9PtKWmsSlvYW4yUWzEgBLe^bKFQ`=MlDV
zNrj}7cpv}sB6Zby3;s<`kt*zOuFUzg#oQg!*6pEO)eMvY@j$iwrpqoPGfUCJzKciU
z-&9pL0jx@h)DMX4)uGiG1{lO-sRneS;c)g<^Kz?*uc(SJ=%MdG3AWl>`jz|ab2QpE
zUU#q6E`0+A{Y3&nEwRSeeeaHbVcWmK!bsLod;jN5ouB*^vsA<70`3o%)dk%?Vt4IN
zD$#Y>zzHm9hjO2y?#RG7<C<7!apO7)1vxqdM?Heat9KGw&rskPY6)PjugXI^Y*OMB
z<rSvb>s;aV3qyGuZ)k!WFMOeCHt2+>n<|v$y(iopLh<~~7ULvV=1&(&P~f{q*I7nG
z@F{jwOBa$b003!00-O(ZyY_#t$XtYShb#*WzibJM%<qTuv)W;UCAEP`T7R${)rC3?
zME-pBHujP^{*6q9;0z~7k?9^_z!0kz?(38Q7ua!M_`}>1zs*0-p8Z)Tnu%3cu+@?m
z5N>zBxmrjCSv+q**;v-kxmYVGa|Lu^vQ7k|opz7LE(e^P4b;f<Ia3`Yoi)*&_X$}A
z3hIKqfi&u6T(17Wf(Xt`KH5@d&bfpQ3lMr5we0Khl)^(g-I=q3!5u2m@uyb+K{O+&
zK6dVm0HB>uXO|$*oNz7kg;a2pH3izc@>{H~^bw<i0nuz%1s8QrjP4tZt(+34DTqpc
zy$7beK&4!80O8-RoYNf*;Tjt1XE_TX*szXZEAmbkd!Hxe=6zC@0MIfXEx2dH3AvF%
z!;$PTfk#T4UJUQ_W^^-_j^%yf3Epfjj(E&iJy!bV6VNQTko>qvH5^t>RMLL<u<8Dz
z_3ddOXpV`Ss5dzKdd0f7y|OvLs)<4Sb>qcaCJGFaUyLIMnp@f8E%0`$SCZsudW^b1
zR?NM95JdRx^p4^&u)mhT*EGtiu+&Fw@+>weg7^6BE9!YL*GCH)B+mJgSl}E$Nu!st
zrOl{c;k|L4$;<uKk(U9&)-x=20$|&RFX8YFhjukI`={A)+X=FFT}u~L#Io0RhO>PV
zH-s7b5RRO^={aXtWG*r1`o#*@mnJC{Ud32pnIj{<VQ4A`=R#ps=`{o8M@3Uh=fEe_
zGXz!b8OI^FL7b6~(z#HQDa<<l0a%1RVaB85s?bctX$Crt3GJt71WG!6(Ot)gsmlKC
zOR%KvQ+9MZtY!9S>2VI1dxP^H6IQ27683}X{FzA#x8AHSY@FtF&3?V>WRZR-umkqJ
z|D+l7U?!RXpL5O^4y`jVF98E17MI5?dWf<68`u?(=&Ru2V0P<LlY&dXn66yY=)%Wu
z(q(1_7XPpgzAn7~>ZI+y>T}6I)VI7dj%pm2KCOAl%7<!rF&2+J|J3$ToBa;98^pO1
zEZA<0=Kb<%>>8uZeP%5DnNv^8$MY!f%1aA==;qHx=~Q;8YEII^bk``+=|i}=$&DL<
zW!<X7&74-;Tr($efUjZB<FrM%RWexBKz*-BM1wp_o*amqEHaV+RSLyl*|^3X1HN(R
z)I#-aZye7a{w`kT&x}4l^arov=%eH)=Z(zLKWt0aYB>F=ye({EqemY-D{-XpU0rU{
z53NrWvq7)x@#=3;jKsbpRC6pq<K5l3+<8YZ>*8I`@v}~5j;=RKcyuOHgg~jWFF*Zc
zv}80yn~iI5!y?47(I-#)YJU6F;OOj~I4Bl4%+7Sah|xLhEgnMAv4paiN~tUr2;2S9
zxz%?EX3DHD!lj$M^2>;Km>&*=g)#ZvEtG4LI-OX|FDHwRZpR;uvJo%rq9&7XiF)ut
zOCf7^5cVb7YWGROEk^vrqn?VMzs#?X+|^95?&LY2{TLf6BD<V^^;nOGbSu;v_H6M^
z_R1yBMO7Dbp_js=$s0zMY(gtamW=qz6ot77@-E$E=2K}P;J#yfP{y$8K~bnUI;Mbp
zv!5!xcSE(U-|-RYJbMg4?>ls(+}wf#u)#DkCwmb(@_2y`0fgvj^wf!sHNuHJiLCdT
zd}NN)<%Y`MTxhITWMK0+BRQo|sUDzm0bIEL=2o&7t0t%;gll4;fOWs2+BsKpIp)%i
zF58K-RH)@bC=T$v)dgb?W^pSW#1c$r=<ET3NFYW$GaxLQ%;B9@Fo3az9!gvUnq@@b
ziL}^RO2_QM+}|GL>>OPI4sTccgrUU|;ehBCp1y*?pXRJ(Fm_u@Fmnt8${#NZ@H`v^
zGw_EJX*!7l7Qj*d4hkxEM(Gn~QW)Mb+e4ei>;eWKq5+YD>6My9?$6RGtpW%PW|qKp
zM;p~K+jrBGxQxMD&Z`5`W_!x){FyUEA|^q`iMU8a0t_GKv<?b__p>^tgHC~iUx7dl
zXshCdc(!OWz-aRcvk>WVHWdK-7F&(4CSB|lJ+FR8d)=GEixIv&i%+~yOu7>e=O216
zNCluSbOi=o1yLcm5OX#izysA$T2+_IGU42R2*4FkvySz+`A{^txI8cbjVp|yNs;UW
z7Iz>dwduP6!|+kb9{nO<NiRGt-^k|7$7V(#?6!0z)x(iPpJIDT6$<#^aOC8nU8w^Q
zB7X2j7KjoHc=hj7>Kuq1tzg;l;$(U_j|nfG8}dGR7v6gFP~=ILEx`cJC<n{|ft0F5
z(bl5CN-xU_w)z87DMkUpXj4DZWR9XDJWCW{93zrNV+rdR!hYw1aZ76*fq}vF#1bRC
zga@{oQH<TT7F5!HYk)%Wi5x$KEpm&3r0!#I8Z5|zO+r{Op{@N|IX~c3o})F8=UhcZ
z!w!aqkzFOojFmZj=_!1DNmLzUo(qFR&e$S5D8ij*Jm<Wey2z3<4VXt69h9#7MCutL
z2LGynk`PAN1yDznPIrQrJP||eB&ZkcXD!dt1pv`Hc^}g;M>NzTstCi8votwC^)^QU
zI7++7)|&;CzUS5*XvQ&|wi3>xCDt#z1il-_D1nz06H)A52y;X@0=O5n4qT73b|-=O
z08{5V7xwRd&MtTxYT`Up0I!4+j+8vN^*ldyMm5Gc?~J&JK!puU2VsjWI;WIKS0=mX
zXCmqVLj|LlQYV0EzfAN{z$_>35MxR(IV)stQw8`ephH^*<k8xgSzI3+K4YN5?$VGz
zMTCvks~pVN5%28J5$_Xs!*=&)=e-<1UgPFVGHem(0e)*<szF1`)dKh=bkem5g#EOI
z7eB+1yM}OQQLxEH)H1{4)N(SW{TP3hhY%b-^a<W-TR_=u57ZXjq@dV=SO8K>3Nu0q
z%&QRfXHCUg8fOS6#{#Z6%;Zs*BWdLhUGpZL#F7$tDum=bFiV63I|Ml3TnjXWmwh=w
z<n#d_d`11x-Uf7LbsOqkPiJ=@?U8msEOLL(Lla-yGj7cmp{jpY#G9y&K+CIj0zu^_
z_g5@!cg?{K;3nx@RndN*3rzmv@jR{&@(fyVL_%A73Ubqk=_$yimTTZP*z^PFVr8wJ
z;@OHWfQJ#0`-Z8tLoIe>q~KV(zO*1XLY=o2WSpOOHmQ<KE)_Zut|%v+Q>mNe>x=w;
zUTJ=p%DU}naxlWA<KX*!J@vy0%Vsrb?BKxH)L&avXRJi_z3Lm`G}@)j)e8Wf<v(gP
zeMA>cs}ek|_judOb87anC$2wS^zfS_Gt>ZVgk2PqU^WTIgCy6-F2)=qjt26j;+6?Z
zD<AV3XlICjR@2Kx2>p~87jZ{7;+(=GOzMew&K-H9BSM>kNi7|~Ot+7rI{*WjU|9}2
zKU#EOmd}+E$F<J^_o?r^HQO@<01Ig~L<aCTWIhXGSu|TMw&mytr>NnXPGXBW2G2Kw
zaW<(mbu{x!ShCZZyn(gC<BN4GJL9=<Xb&iIm*X4v9kS0nR~Gvi+I=-y2Q&ebeN||E
z{!&-x(azgE%rajP6?vARtY(%RP-sNA<-Nx71)aw1m+Z?riw8bl$MYatjsP(Yl<Al7
z40=gRr>Q`4QeZTLv!BM2x=Kk<ZYF3Qb$P`|6uSU4!E0TF+d`jqob+E0V5G=7-nn?u
zvOxu;YzeSFevfgiaCd9KNjxhtVrfibJ`ERH{Tin&RSLOu?5(Ou=bTgiJ??Vv=|xWk
zXb*pWI+W$d2M?EScOtnyKzJczTiK5P$2Hs8ii!`&^)5g=B;NtLl99IUj~=Blz0m6S
z_SIetC4`l$wmlQ(NsrNNOVicqemA8ZFk;x=L#gvr@J6JTau(BJeZEN=<AG;$EZziS
zgFr(px7t428NG4Udd_;`H7hl=Nyi5Nv{u*yQd2T6Y`+?#hSp;)Nc3gI#ohaBrnVp^
z<)iw8n;FXlxf<1xvf-(`)zOu>;W-)TixEBD!JmCBMG7Pkq?M5)mFlM8wI8^kqq8hA
zDttd@M6q2s+ve_h+o3q^8H4NG2E|>y)5H}ls;}nQg6&EZoH`VR(-4!MX=v%{0}hsd
zKfzHL3{H!p!V!+d4R}&8vonT6@NU2b>fuR&qtX{z$`k{1+QR5!qeI9q6s$JL^d$9q
zl%x}6rNY&kKfC9OXSse_5|}xNQ8wmnWT`AE+RHC|hqv>U<X~^>6|m=4qB8tiQ388r
z#Bm#@xa;)~E#hP>AiNgD<)yJtG21b6{O6V}Rem$kj+$AS&ai^63VeUFtRcej1Iv4a
z%2LXSKGk3XvY%?a9Ba+zqXll6q5;pjO5!!WXkUEW3f5}vtLn=vT#wdEMQ=N>f=hbv
zUSK(et(3>7v~=4oy3ZtfOW6yZEd@KjHZ;V~Dk$rx77IpzoN9_{PT#wSA_bSZCGcgU
zdJya*R6a)8Mg{BH)TQ`NR;W%+9YVb^)Z!)8F^?&(HuQ))gly3y-W4!Q8`!Gbu-z~S
z0|vU2{;5-^tX9<T+{p{+Q9D?#XY`tjf`sDj8lkUC_MDGpSAS~#(ae8YCUI&qW%PMF
z_k|wqj?lk*Td-;NXOz13$ZX#hie%)Q5cyg&Uft&ssOv^PLTFCA^KvT&khyYFb2;{;
zq0fuWG#jEll-CBzvx|}+=X=ew5dT6%{nVCEE$7Kjs9%U}O+%QU<T)}KJ`4xRc|K5v
z&vpiL%qcvGd^j+#IZGh+*~odAtCcXk6XKi*3YlaBPYS8j1&N`-0V{D-L;(>q+#l9Y
zY>UmVnZ_+{^&%HsErom6%Eq}<tR>%1>|zyJ<<tRl;w@1AdY-87SHa4vVigjdjdYIJ
z_BNDRyRB!B3g&bFN{sj0-hpO=*PrC8OW*p-%Jt(7)vdk(MNyo?rBDub>3Ay$>td&J
zfKQDWnfn+nr|XeB8EJSk&nBy-Up2D8@v&$;1Qtd_H)i7BFIUejntQP-F1JlW+nFty
zlWa$&5|vx|&FT&3;}wo*LqgDhJejEJp^4lcdS+{yf7%_*LmOwC&YxPD!6z}eIXE2!
z3bdszH#G|_KNkA4d)~;EJuuD41Gkzq{Ko9ci=t{4=5VWBBPG!e<IB<8V!7e1iTqZS
zXTGH%m(5r0xXG?=?>N-XexVbVZT5nM{iAu&+rqf71iI*tH+KpB;ry33pz&ALX15d1
zsb*Q_&w>)sWi^9o^WZh6i!jR>E}rW~#}2x&I^sbHG|Th=zt01qIwiiHG%(iLoC0q;
zlKO7mgXgJaR<L^PJ~hOdS*qKZ&if}WIX=)kxq(M0HPB%n|L3Y0eHoCkO&t^dyC*l*
zwQJ(r>f(J=d45#7FVaihi8yagphTQdxvj$2gw4DU6k&+SnbMN>cA$^$MZ5~S>UnCM
zaSDc);g|j<c#t*U_m?F(xJZ$=oH^G0JsyY#3Ar*4T95d=%nxPsXJ4p9lstGF$~eb>
zwljTY26-ojkL6tyH#|0CX(@8s_lYLY0EXh&a30EX@5jlI^kG0u@ZKUl+2m=Q$k8&O
zUqtvthZJf6^9q6Ri>6bpDYQM#nC8C^q`&6w37s=BlokdWf{geYE|WtY!g~v#zRW}4
zkm$No-&$)kEbj9GoDT|w$U$BDZw^^KKfQS1>odxxzF7;XW-K=vbkd)zaX)bFJtgjT
zE&KC`)6Vf;xx6P=&?MdocD2Nqc<v=*H~SRxr$W5v;K+Hw(A35oqo9CVjC@5`#pC%A
zkvgDslO)x`&SWn2j?>cXNk9a@oKttV<B`lC_eFe-#1h6lZJ!C@*|pUg#rz7?<9$8F
zlCKF9ctIz)%TVm%;(_I$?pSz1IV?7_!?3}{H&l7sehz#NRN1O6%{uV6U>L!I=9Lq>
zH28Ruqj`{a%Z(L{hsko?1>H2uylW~V%5n#*3KHV~Tf>r{I{)pFWB~e>z`VO=j!Gv1
zc-uPZ$^@!sm9KB4IyA;PLB^p|A-$9M9{Bjq&IMV*_~$?@ZymPeq#2v$AWZ|Z;ksR1
zv%ij4NH0C@#s{jk0w{YW%kU?cp6QI@PWLE|L9h4=g^J>H5m`Ck(qGWzxnR!AFpdYq
zBHXcPoKn_g3!Okfpr71J>lhAbK>~FV+3bT16@gZujgRsJP%2~@xrlo(ZW-s?`Up2K
zx~}yO0F{w*WbYiVi91L-e2W)4jqywJoK(J`Pu6O*+k^`yM}hbuZSnkm?N%KD3(NF<
z5Vm(Z_9|C9(=n-33HAMya_25n4qFY$)AM7ZE!3+4%cI~V3t&yNxwlZdyFX2QcbiYr
z^NG#+_o}NW__)HDUHm%c(Sz0))41UW$hR;VUUjdM9|<CIwHWl6xQ3636>aJ_q@YJC
z+W6k<RrF?qoe0k#&N#~tzQdg$!*3UM6n2sk9Ehu|LzuKE!3dx-cpJq);kpAtP~3QM
z&sDkOBx}FVt-SIg3)O=U-`<%wtP%XoaxwGmhOi_?tj@@uvDp8LS?JOkvFd6gBuz<y
zVezPVKWk-<PC<N84@8=)cH3&sE>ImXorib^aou^44}UAT#&<{V6euaWa7ud3?!>)s
z@Ku}Bh9LIoP@!$cx%5+!OM;Y83w+o)U#eBl^p%?t+hT~bfU85aa>`PNOUG^pdSN@n
zLlh$vp(l$h3aMY+>H*c|SMN={`tB|97|8jsSumw5j2`wJSE)=!%%CH{G13qY4+-8k
zCnw>c&lJ*<4G`WDHj4xs3}%N&fF`8PeiX%~zh!$TQ~ErOf$lppkviZ{s`%8;_+|it
zZSQ`Rt@TDulI5UJ`hW1>+2LL}b@`MJ>|n|VbXEaoTOtH;t)0KazQW8%RFa&|6Zj*<
zB^NyDO>&ZYE2USxWld$EPc&|2SbZ6U@}F|7$0w-`z9_3yV6_;3WR#+#JlwRyrNg(%
zLgm<5zR2}Vge9KU=QXGpp(7unZgHyz$<&v`2c0nfrinJqiiF=R4$6_OE8BQgMtcD;
zl1tyY){K*?3WZZtOn$hS^yGkE+d15b8TFn=>WN(Lzr0_}xwm&cpJp}_+3O0rCCJ<G
zr~vt$(kUv%EF1qamt<MQn$yUUD4qf~`55{hcGfiM<_V6)=c&3^DT`=(aGF|DcQ!ha
z^+RDat2Q%8C1(R{I*<p_yv_FB=Qb$5ySq=rZuBHKSA!V9{!wqV*E*lsaeT|`lISc>
zyazr@A)9m%Wt2V-ssrGT78GVK?g+7inEAsKsAUqU?4T%p!TGV7T#~LPGb<lx{bcA9
z31&DW#f-O_FZDf1z<Nm2g7|oXSqGKZmZavshLG*JwD58Z>C=lxp9Mo%%9%hMu=-&%
zNBQ&KiT5_ReSmk}eT)0`ZJrU_-gU-i+NFO9+|Vb36i_mzk}(N=zG(8FQkz^v0{Y&1
zt~MoQhW(h*&wdle-ahpvNSAU{obN7OAGbfI%&7It)qm=o8Ddn)-2A@Sa4Q()%Dr%|
z){`+_pABDNl7SGf-QW7Fe0-oN1j}}18$8nn<0F4~x2SPc2qc9lH>xRUI0qHytweyO
z?{ktYcKR(#u)^>9xv=IUd`d>9aggy0UZZib-1PWahv!V{4{enh#G;@Gs4?t<^ovS2
zOKv@3Y$3N@$fb`Vy<1fG?|?i2dyOpeSM?gp_4JKbS&j=jwgoIs2+6nJ+t~EdQ|yv&
zUH_(B1d%w$qI>kBWd&q!c3$!zT39gMRt@9mZP4<)Ey=39<i}=~&^(cFH>GlfW9qk3
zT0DYaQ`m&`=WYcL_{1dBA?F1)=}foJ&4|UD-h!^Au>^lR{JBQ?M;C#+O+%ZuLUm1<
z_-LzZXu-?+-`jVq<x`E48&0;Re(DL4og^Gxt0@j+SxJ3X+MLj>y~E*|ox0%c?Fu$6
z=$>{F^MU51vBkq!<Ns<H<7+)_%tV^^SYcM1Mq1!T^3<0maR~Tv^3g2c6CIN>IAORz
zBc^SB-sHUsy!CT1ffs<ew7$-t#StjfdXQ|~;3azn1_GkgWFg%3^_L!61(&t#^MM^s
zy$oW4Z~?n+^s&1QTEE0%xIoTSjlwY?sJy{`xCKx&eQC(v>3i^>JeXV#AGx*pAE;Ww
zL%=;Hb7(w7yE22CN-}^F0I*O4Q;GqeTl%r&BnCB1{KfOPP7OGzTC$r@jEk0hlcc~I
zBo~-;j+XSmjv<{uQ^JmBJ+~Cf?S*{~_MVHoYJ6RZTRvpQUtoNsbHifY##o2ry5I`Q
z^Vi24;mt%m8YYB=e!D<6x%9SFxcU2^G!0S9TN(Ym_NLv@*psC39^1cJ;1fgn@6>5p
zFC{7)Les`GSPLU3&*c$1j79nzSZ_6L2wad(At?rk)<-d^@gY$ilDsLkne*HHcU&PW
zKR6;TgCtq$H|`a%)jO2RCt3!JSgm#2%*<EOWD_rsIFxW<>)7ZWMA93y86VHPr{5%;
z8GGl~RT>rzvAWeECp&&Uo)9<t9fk9MeTOwSh-UaSv3X{!j_IRLIAF?#_tzi%IJP87
z;ByUk;KkjPwE6w&PXEIs|6iuU^zmWGtFAu{Q@@|aNu1!m_FS~<dGE2T+_x+_s<e|k
z%?CXU2@4}6U`0AP+)}XFI5l&Arq^cR-POV?@y#>RVyYeJB-Em0NfMJ%3rsA3-7R~1
zK_!LIi%M_LoZE^DkH{<C<1*<4R+~;rR|%*TR-NAnjXNdY6YsEz&SRDLQ3X<a<F5q=
zF_lQCDPO`&v&nkX=cG??NaBajFBb6h=E`vAcaI8*-CIu7kl?Z?ukT;~@fQ$R0o^bF
z?#6?cyIwNewZC_1Z-L{#`UxOt^V;htIOHDv?L`!#MHn!zk`~aqyVXZ1NJf{X$~qt#
zs_4l8_58g4muPr2n3KprUk2%dIbO4oVxOia-+yJ!Wuklc2G|IM=c5|s^5TDo67L#~
z*ncz+Q-y#nj1Ub_NWtT)UU?a>rd-&Lw_-<gfs|?YC58t!2z|x6U=3_3SEvA~zu5}9
z%%3pmdNR4`-7cnehO@FbgkwR2_Z521Z|agImsJm5?Z|0VpEu*k%<+ALG_aXcBBQQ>
z^J_P5twNZeH|F9ABmbmb#cl>e53g8$Izp&=;;co@;r>0vT-;~+o=d%0V|=w-b+Df{
zV|~M{xxoOnM%J4t=5TI=;bFk^&JdSJ=*q6$5_dp5Dm>2eZ)Xm#MT5EWs?{u+WYpwt
z3V8o^hSL=`T$G6H>5;VVXYiOY0nm~VR)%lYQeYL7F=N>fx-H|Ds9bQKIj+|Hb-d5%
zsB*L4(1hV64Zbo{zUcX5xsEL@x5XB}^Jy`>X(Pe^<i7tEvdo|44tQ|Z$>I<r{-0UC
zb-`M0F&7YgkFL@=Lm$X03mU?2`yDzv0kE%Vb->6wZ-#d*v~Z&7Nys!|@5rrr?-(W>
z)`a0l94vp66gSOCA|O{zOX*XJbi3n>H>&pRnWUHQQZsvQirqLYe+c-v1KR;;F0eZd
zEmy&+2<CS7<~F|W7kjrP_O|foE<#lnfnR!)*Nu3{{A@a>Mu!v2j(+kIfdBSbF2x;p
z5UVb5L5uZ!KZxztg$D^|_c=-a5^IUPz#{8hbZfs)%kBO=@5(V!s>z7~NuMdPIhB+4
zbNrSiV+$L4V9oXSoLkf!g$MAY6RX5x;%*&{S}TFIW9E0OX1ZK?9P^nE&s1T5P#r_H
zKnC|R*daV$W5AYHM|m=R_D8gDBN^4LWxl4+=ZTLFQ2#N00Ym&h`Ww-Nf`pLp4ckLu
z4p$~J&|^J~24!lkO+*En0i9C<d#CA{ub!-(1kP0yHz!(HV8MciM*Ikp#PUzxupf(z
zSjr#i*prL^rGaqzH#Dld@VEFk>nwL{4cfL8;K&%(oh7%I+#G&mj1=6U%KE0mhn2i7
zQHhbeTW*gMUZ&2-_cpfbq~!-Ny8fnoD$$7#i!mxDKYJVLQyON>!_mJaT|(2V<dW3=
z!F|bfJ~PnqWjVj&UB1q>>@uAp<iw19IluqdmvQd2a97#b1HG4sle)i*9<QaB@c4jF
zH`cyRm?#{b!!6o6UbVS9{qV59z~Rwv_xCgRLDa7AN(Wtg82sfySCUElt3ff**{CoQ
zx=fxdIY&vBdPJUM(1Qs)k)UTsY~^<@)lwPVhTmT=m(hjD<GkuE_m#0<9pQj{SyVoT
z4n22bD(c{$O5y)xP2{WTs5k#+lU1_oTIrz*P6*;OgJfpsxTlw-zd!RrhzlgolvjDf
zx$~RB)&QDWoJCyh?45aB<2kOaBoLmf#R?{hIKIb%RzLU@&(l5nVaqBD5JDa=o*0TF
z2a(C2|7fEx%h|QCxkp?(_KQ-NcExARfRysET2~0RV6|4y6W^Q(;8yBAq0{VDEsy8k
zbIOvQG^-CbyE6wYL&lI?V^p)^ek{&kX-FDUbF8Y#)l_iv$l~JM$wu$qRsr#RXuQjj
z2@b310dZ4#M$o`kjnay^!g%YVN|N^`$DOQu>#R3rjpN@&E&L?IvhLa)OJw~^4aG9w
z9uP{3Hcpu!?gw1fa_5jw)Vlff>oaXS7zUBEJI>d7oNwx)#N!i3%+Rg%=U~xsSts5K
zWHdZ{vRCVE@SUb|gi@rDH7O0Wn<$6WxcRtX9H%-B-o+^1uU^PLv`xn;o%BH;d5L1s
zu0qgqEP2t6)=^%$u-<w6R1mgRpH!Y682i1Rgtq*F*mU8Y=i04|&^~_!hw9pfo<#vU
zIks5dZkCqLcenpfA_t6rgx%SN5S#zXw*c27`?W*$%*V5g#6S%hNeO`mYa|C%RbLyQ
zfUZA9{mZW&Ekx@G1KJ~llIsq#3Ze)7sY>Jvex}D|{Mw4ZWhj=*#(?|miJI_q#&AI+
z9IlB;c4p6D;ZC@Bj+_5$hFMhz`lihC&+aM&bBDDR{S?>@qD;~qu9{&l;tNs;!)0AD
z@p2rI&+U6pesfe(a>rn0n7x|JQ#ck9J{1le%UlcnFZ6FYTWNjj5<`3ryLg?!>jS>b
zS{zxI`;mI}X!WZQHtAsI4qvxo7WTat#YV0sTo_|)C~wK?B4^jum}!XRvTVi$y?7Vz
zc{DnErzCacDWZl#N;{J4#;)sdJ|ODvUCP3=$}K^qCcSS2vpogO98|CkN%*BapRDVr
z!`K&SRQVu=1o}2w6m!@uFo7bih;;1)?9E(2>*u!8a?5*#e{KqD^5;XB=(B%<xPLPb
zwaMmp;G6%-CaIw#T^;m{jIPA0KEd1wmzuD-y~`ImQJkvmC9RZiPgfZ!5s%SK3b1@(
zPV0O2)-=1kEp+x#CR)&kOIe3`g&M~#N$*fn%Hb9V>#HY6v9YehW)YXq8iGpjXQ1{~
zFX7qOR)7>35#(^6D$VoVc%q{pAXJBg5s7vX17KTC^|CHZ<yg*qb+cY?F$KHXdp^#!
zpbzHT;LjzcXU>-MBu+*5g`a_Jrk9#Zfs%2@{5c-Ksq0fGHf{oq6%~I$ZQa(<JGA1M
zn&RuvI8x&4`_;-FwQj=n1q!O4-tT(#@d0p+tk?GIhz!QM>=Y$7njz2>1&7ZOxhU{%
zZzT$Unjj}<6(sFQndrT%nnw$LZ$Q~u^r*GX3oYVMNx<0#`1pZjxI>MAK(Fc3Lq*-c
zyGXRC_<(;hc8aVGOzOD9he*?@LZkkTH0cVqz{&d0RL_yF#t}vl$;3t94R``oxdUJV
zY<vcgRm@PAm$PT=tR+-3iyC=FxC<dL72qSkZEBh8@gpI!>nHhJZr=ro_4%m~iz~bK
z;wh)(tM{S(;%sXaUSPVpBy}s(K=aZdrj$Vgw}bJaTfN^ar<t#;IdpOzvC0n;nAB-I
z*<l<K;aLb%K~}KJvxh#di_8EhDuTORbTKR&;n&#^%yN4if+%snD;TqmKp}`Cy<wmq
z*Ch;U7`eAyHsNRYmKl9k9<_jD0?c0K6LdzWjec$Sjl+A(IJKKVOsGksx%-?WO!=EK
zw}ZLGS#~Do06ORjfc11j&C(C=$Ny$cv6L!mlRsl&puR(i%P?0MFDym<c6(wxD@WL>
z;-53yxK?YS!=l@;MzealCFn4yYLvu@)s;MyK?%3YZSb95t$5;{KA8k7P={xH@L5;<
z<LJxMwk7V1V6}uMxVKuiO%(;fo3<Sf>AP6Hsb8bA;iQM)c*LM4Ti5(V%RFQkFAh4-
z83r6GBm{rK;kNT1z?0{vGvh~xdmjz+dTTS5UVW;;fxa>2U4l0>jS+r|d~6G`ZVS(<
zg|S;df`@J6;GrA6VeDs;|IlS_XRYU}L`f^O=Ep6%=<tHnAT3b=l|}L<uL7=%h$Xyg
zvn%~F^ZKm_<-PKSPRYpPxNGLdH{EV}*WO*COGY>-@KP^WtRQnd#)16+Fq#%v0ZZhY
z1K`DW$nMIy;SxaNU`JMC@xej@pO6(flqBQ6>`1yUx^z&Ey(8biao@J3w-BWGLtf&q
zwVXpqcsQV{WzM|F^JSBHoBWvuN#o>ih!yBp`k3t3TrAHE#BNtT7s?@><9=_)oNYP9
zEw;;qU=>)=_DkhTl6w|VOqaoelXtJ~N8P_Cc=pWEajxzWelo1egSBey)A^wsL!B=&
zlgh2ZTF*MA&#}Xy2QO{czs{*sUax-tcrd;<Cp%~I!+jl4v|dMbE5Q4#qfx6xFoLdd
zPayim)RFM|zO2G)mvCoZplnyiE%DDk<hyXqDe`h=xrRT~x3@`A5@&E6teBTy<pN;F
ztpdmnVg`w;M32utLGiQ(->DuJRW)bg0+W2x{@iVODRC!gNlH=p!O`vUG}1E$UBI}R
z-3C;!(CD%Mt7??$<9#$?Nbth4`8*S8JCuVpx)LqVS$P4Q>?M{UJkv}dUkL%&voKE2
z*$+Ol(-1WvC-b4c^Vv*+Ue@I*UtTqThQR~3#vfP5+B=oKo9B4_Xy&0DZl-`}BBz-h
z)<hu4CGG>FdMbrW^%(W<$MpyGAM88wkw<ne5mW%Jv^MfC&|x1~jX_S6r}JA>Vzd@t
z<Zht+i!wr%=Hc2D^FZ2YdS{6UzG>_<;A02{>e3drC^-C<TB`c>B-Hv*6%>0sMEicV
zaB6cB*ld;Ez6pIiKbyJxN1R?_2$MD!k~F9)X%X~FmGw!NWFnUjud!&NGs{mDo3EG1
zf^Vv*80XM#3QyAyL5P&|uC-Muzi))*RILfO73N_%6eCN8`0#-3Lc86<rW2Z`{;}Ub
z1ddXX;FIIu9@aMaef)!=oWbtTUvL*J-{jRq3~j76gVwoj!~{MJ-?+C{|I+JgYdUF;
zc{RLFK~!C}e{Q<jjbb6Fg)OeTfHpj)GRQM3h606v&aoJ|e!X-g%Agyr_u_n^I_o>K
zn+-TOou^$uR><culcf|>twz0`ZKKNrlH+SDy+pQY$Awn{j0D7{mabco=A)k>zOc3N
zduQ4v=j{Mcd87M2(A$@^Dz}h0h!Mn>AdmDxI>)1{d7rlgj*}!Nz1}m(OV*0Tcl~fl
za!&58F=sC!2Gaq#2iyv>;Bfr!^$K>#>Eb48C}Z(g+i8yjl&KLKtK8~VJw4lLpAMDj
zNrN4ehc&xv0<QfI2z|F%EF$WvaX15Vq?v75oA0A*-1&oU5W0raMg%&%v$NDyNr0EJ
z)mB&*u|Q|L(54PIzf7>7?T-s`;=lo)X~78Tf}-83Eo<&epEUtXzfsLysoEGmOkwQI
z<htwRR$vUkP}(TzyjV6EowNFJzf614#gsS?GGd|mKfa+MA}@HehgCSYwiTb(W(dKU
z_o)+8=IG4%&Qrq7j7*{Si=8V{5kJcOpZpnIl++nheKhH>qM4KsW^RF1f>}wLGmGc-
zCfd!MvQG8SlcWWEaUY+MF+B6&3B9S~$tL^8F|@pg5L@A}jHTH60Ge)4Vgr-B;!RpH
z<NWLTR|C~M1-c^FQ@`jXQNLfns3RO#`jOr|)Aw1R6ZETYq{K3(FnCi^My!X6x331e
zwj_`}@Is?J5?E$AgO#c<=hEL=f8(9uKRQUI*akejrS*BO5)=hP_JIazH(Znp!Wf`J
zFd!`JH2d2V)%%37aHj=fvOK#=gjbd`KmQsyP-m0SwA!1{v}B~Nb%v3E1XhOkA;b!c
zOd=2*2RIjhEpE?T#`_fq3I@{jxD>WKs9*hder1<U$RR9+SYBNa*UvhhQ>5<{lUFAf
zF^!&K3bwN&!CiDC{N1Q{J*W?N+wKC#9Dq|Gxg0Jqh<f59bX<w&i6IPW@Prv0TwHk?
zk8Z8|a6KM2hLYY6K)S8*wDQ)R$1xy1UndTZ(DFaD!ZiT*IiO1iazaUjE5MvSh5`b*
zcC}U<+As$Xfp=WmVXvgPq~b-}eZyn)49(uQYx?-JI5n~PxEG{i`n$ae!8itzA;^Wt
z-^|xzwKr7C+sw}sZ+T-OEV3fKKR?3~f`XpynR_pfdbjZSPEgcrY=5&Gu^KFLr$>yB
z2R|n?z<8&n-gM%1%0nx*XJ^xWwPHfA7tH2b#F(I;s%0rIy7=BZ@rcoTYAO>s_Nejg
z-N_t1M8&>)jKkDVv&*>pwo^rX`#fEI-qhzsiOh>lB<SE(CWX0=$WIT2MpGkL#7@HP
znfof1t&v%Sx|V|1dWFq-dj)${Cs1}g<Oq-7!Wk2On#H+^&%Q2CdTPkMmL(S!&YR$o
z%%EA(i$ZLi{yo*AfH9l5?43L3jxOc(9$hcNv-tJ<Z$6UO&4mp}HJ@iK(!P~?QII%M
zI1wc{J4@iZV~7BvRe3sJ50%%Wl74i>api|z)dH)858-%P6+<nEuj49rcD>6eInn#j
zHsCS-@}uwRh!}~o5v|@Ep_EP(Pb)O{zUNQs?C9D_p<1}{E6L#3*HR9>-$1}8kt$id
za#{Dm&c3t=U`z);jWsYb>%t#7QamEcZ#RMB)LsGD%Iqv=vlLlzmav7EmN<(fYtUl?
z;fmS&fFwV>+`E?5r()mTr8I^Rb2KJAKW9+5He54fnWXEa_aUIs+Yka$bjtmD%%I5F
zC=}~{H-@23H@vAReGJ$%0wV>7z73K$inIhDz2<RsTnTrK-R`o*`WQz&=RTetWT^@a
zbWDvG7wqrb;h=7yQaTNoKeejUcSIEpqB{;4r;I*Ge16mRCDO>rk`*U!kT&Yl`FJ^>
zDts*_k$>>qwlUf;L-&$rQjhyg3<@_9hd*1wE9mc=A=|wz>vMOclRux=8~|7kpQSNZ
z=$q#<`1*b{q)pJond8`|_Z!ENY$JrBFeT52=4?R8?NxzG7brVJ@{uL<qxfZJ*LEi&
zlgJwT$5d`(mK!5AZ+!=PTVap$BwkwZK#`0F8*PEkvBld4w(q7=+Ov0>iHk?q*;M)$
zebyPLW_sh?E+;yenhzhWd0qdT98)Fu`g%{drq6L(C-=3jXPNQ`=EaCRSW{g!$mS(e
zE*j5fl$s;W&BPl?KA4^Dx#Ex%g6!JbiV9?;cMvF~Y+NjXAqwxn&70vcb-{CO+JFHf
zu`?8?Oy6g+)D!v#?GHaGE${(_t#G;lFuhbkUpZ8hBd>(GS2V{4j*=w6hm<aLzMp|E
z02pZ*lg!UQDA)xaQxyDEYm9H6b5H%^^Z2E*AYh%M2?z32)c-m(b2v38mrVgS8ORWx
z->E!vnB(-HIIf9)uowxOWiStF{ls=2d?_a}wR<cgv8s0|-4kGnh=qf!^yT$cRvGhS
z0+u$PC6gd`W0agbC9%MfWYdB{WGoM8@W;Mc->WCT+{9|bj<61k<BgWzK5kJ-ppM-9
zG^0ni5>bAq36S|@%}%TzQVh61dAnFJa3<vaGM{6rxiWO(@UBm$z@cwI7_&3C>l$?}
zok<Wy5BSuDJt`2Xp$2U1<<sl3vNCY<yN?nUId~Lqeng9&O*GDtjM&s?P$NQu4~*yL
z(O4kR`X9Ci5d!2YU}i$W{DeWk+=oJ{73@qio_c+0>4ShTUS0)&rEWo*-DXsk^awlB
zZC06Ey@ik)r9E|20|LOcFgv+2aT?s373=SEr0xtI^bm~oW|_@h`Gl=-9At-N8zUb}
zNi!cqUur)psGS;d)csPWvu@Vv0OM6HtLTe2AlsU0SPWke(YBi!aYo7G!);&eT0NT&
z5n?6z+D9($qlK&L3J@;o^P$CBud3&Jk*3?ji7X=;SPX=gv;dzs6pI9lom%8ux@6=i
zcvs53uNN%CWLbrku$CHe6x@i?EdVllwxxOJHuO3J_JQs4)sVJ;=9yob5ipy0V`V>C
z!v*$W$0;Tm)e##|ONKsl?1BFq=8!c6opm~WQs{Een4#oTY}WILO(NDK{)r=To38$O
z>yIaKUXp+ahf_BJPWmi-c2biP(=sC+kx%Rx9(s7v*VXLFtdAmugq9QTSQ`g6333r1
z6J(XTKA~_4_h5D4veU<-Q{@60v__!MIzcJq!PwcJsLC3J_<;BDW02J`=ilD(SEY=d
zE%<Q*K*%DMJG!lp>C?>RL8BxgL4wb98XSmfBY8{hodFxMfr<%~P+El|v?cyUX-jYB
zFD>&R#zu^vyCFV^X%y7X{J<x@QtzBL!IOGHr!&#+AzvVH(k1440x%_Fe~<on4!ciX
znTpIp!?6;z89FH0XhLRs9I~_^3T+mTNUASG{e9L$KoR3Mm~$wNcmk!Ne@7h4&&Sis
zx2r!8cJ<Tf#LV6Sk<SSHXlIQwTLB8P4Qs3gfu(OQgFrcLsvyX%&x&^^v_(@J6xCTv
zY@cL4ID_l|B()hFnxkLKlrcQi(Y!akp2nSZEY=q{e`m5^pjjC3H%z@(%fdRi<mAUi
z7CJHLf{`N(AZO>frutjtYJL28T}<%(1^I{>4Tpmf>*)tw?D3X@Lnkl}&l1NC&dzWt
z=2&Jwn?Ru*c%Os6YLKKOL`hG*4-%kR)nto8!TvQQ-T@d`bpR@7xe0%+;Y8y-$};);
z2UlpSyh!GpUT4Witzbq!aEw0n4bokdhgH_slMo>Pi03GUbY~6v2(n(YapYLUFdNrE
zNE_JCei;vi8{YEt=v84)1w{-~7Hkx5GKG*~3WY+#8vwZKzZ-DB2C29>Mh_yu5fD)C
zQgcq@DSyJFqP$UB6pxd01nN0zHA~DR;I&+BVE!IxP1=IWw*>L<|8mK_qocIW7bh7J
zzW*TlZpRLaskFH0rQn@CP*?IaQ1Sc_+M5CPnjr5-d^x@4y-&x@+wrtT<P6Or`jL>!
zD)F$#?<49yg#F;N>JG|?KB>hH_7>PH+9w6P^%CN~GiJnUHLzB|ipFY?gzck6ZH$md
z6#hJ)b061$pwZ9xm#zhx8;6<g12v6bG~Ha)7hyo#cjGgVi0(zqP2yM30A%c&Jvz>C
z#KS(-w-zH+C$&%wlX8zGNSq*5meSTMCKz1wFbk|wEho#iW2@y5YWIbDx?BDGG{b`c
zbas+9^?mmvME(2&a0hWXv>zCBersP-$JTMQDkEwXv-Tq_yVefv+|ueC#OG8!uIg+>
zv|xxoBI%&dGnM}MXa$L0EjmS@5Ik;T(T4A5Old4{Qn{9Qh;ZA3Hw-Wo><qBI&jC5s
zVR*APeaF|_E`U17T@zC+$E$kZHY_pB>+&*yVq0z>tup<bHoQIFD+hY!{tMlgtwTw&
zaN1pVUUJ>IygxU~k}tD1x-SjbNEJiQv8pl)fipm(K#r!4;L^a{^64DcbF5%Vrv^q2
zC|8D!Xka0L{b|yZuVXscz?pZNnI_{OU~949o&pFAzlxu|1*fTMxym_4?dXa0h(>X*
zPQ7|TlqAJ2^m2&GfwPZlBb^u@NVjOwlr97l3=9KG8mrvA40z-fM__ww1$s^WN!J~!
z7J6GY6k=3`t!0OFfTBVLU7Wz5(YCrZiIt2S$fI*?j9)DSGXlfRE-6CKKTnc`K<IGC
zQdf<@VJ^M%SwKW!0f=2}PiB5VGi-Irhv&=z40E|-jHO>rhBLBV@55^)22iuiKg-1&
zn~>2leEw<E)V<V#Gqf|ZskJ;m?YmF_fA@y?K^m0-{q^V!fp?F0KR-~bh04OjxqulO
zO%*OaHMr08%=#JVAuBk{wE41|z(`S<p#hP92##4MtO|CwC{bMVQu`N{GEB7y5uz6(
zaUdVhQ_-DpydvnnP(S5xox+^2Qx`7y5Ca5Pk!94#oMf&;=6UkJj6zfE`D93@6%K`a
z+P{9b;`2YkDA24TbLI4B?TfYOh6y$j0pO1Vf%$-e0tL-KyVLpcO}@qcdOwEDq{1lY
zy{RZs@+6M|F8)6LjM3#v?xOH)YR24A7@HlV(RTPX%sUZr{E#nh`xEL{cLL)SEoZJq
z7fL_f&II%SUZ3>x>gK3IF#XYoZ8;bzLVxbKwEO#BVG8~Hs^wCABn@OWvIr6Q%?o%M
zK>~6w0>%_;aLMP<{w>0(mP&0cAMF?3fJ!(A{Kq)|-jmQ7w4N|IIwLdQ9>==ZVtc~#
zvr-3Xhv~+B!z^A}oz5tULBDaai);Y_p`kbY5-&atP}Dw`6qf%nF^BoK&*>$b^N5#$
z@jQ*<)*EqPHSVM(`1KzLqdf7QUIg)kEU`%GIRc%6iN|uv*?mU*nm6M5jlH19dEK$q
zBU0I=O&xu&V1l7;LP|TK&6Uj+$_;4|?hh)Vxd6u>YStW3!jGZ<ry$CJ7<T-(61oLY
zQ5QtHRR!n#e;*?<?4Av_uOISTnPlkoohX`~d11{AOkpxL_aT%C+LeSTYv9TEFff}I
z2=kJ83T#rHg<oOq)9+C2aJ2Jj_X6J?+)4-$PM(gL|Io&M@wy+LbvQM3xgs*}gqbOs
zq+!U06AR#$BDJOnSQT8nRqbRHKA-aT`Kk`&$beN>F8Zl|r`OK^W9u)VntsFofBdyE
zVDv^vH-ZvUN;e29Y0(XWL8A_-jSfkXP^3&$q*TI@V}J+<CMdCuREZ4`He_tS7w^yK
z`~QD`=lpgK2M%n9d-v|VuIu@DrmMTKyZiv`*AkW|>ktx(n(v)d#Y=d4e&g<^cXh-t
z4hYeXSAypVp%njdHcuBUVmNc(FDKnJ$Gk%O8G{YbFnHsN9vTd|lHG)iTU%J_S_aj(
z<TlNv*@gAJoC9~3u%&iWCUfLcs`H^O0uv{Lam*7b3PS$7iK-ry>iKy3O*#B@D|k(Y
z`G)6Y&I<%QN7q141&xF{j?2bTC`Tng;O&9f7VOynSO#eni{{xx<`?^8vIC-4G5H8u
zJ`!|K2g@Wtw@o7k8YlA<M9^e!(ZDzk|IP)3d60*?+Ng@w!M3uhajK+h*Y57e^M|$Q
zEWWH5y4VZ9iSwuu)vHegdWFgy*vx*E`CgjpskvBp7P=%2#uKgBKd}nF)S>-I*=&bN
z(l$P~-~aa3H9%6cCoi8a!{U#D9&;AeEV=5VL*ux8M`&-Mu{M06;^StNPsHJ<FmfN{
zA0O|dm8YifvWk@D{|RJoU*Nq9{WXeNQI_}qDgCzcTbLtw1H!;$*9FaqMlE2=-}5)U
zK)US|y3lXH4)SwGAp7aRcmDrDOt{@E7W_L0d={w#kX>OkbTc!|6@+PV<VbG=IU@wj
zp7eE<cAi5oC;5;B>c7yI{$lgwql0y#9rWkZI<<cW7cgtxJ+`|`b39u{1jQFYYNVNC
zzIQ8QtS{)T^?|wxix&lgKM6Z>ByKpKLDJ0W<A!eiS>jQQF?~A{*`fLKq5l})S~Mp<
z;B{%<*7?Cn4({62lNNV`bFW+-d8b6#OkS_XTM3NOei-Ij>!l#m1s@OlgKo}khF{`P
z_JgcjA~BX{$Zte1t|b)yR8fx!?O{$q1;WqBtaY6LVc(lXr@LCP`|)tEzNx16l`KU`
zG73-e8pXEXs%NkRnTNA9&Xx_JXA6fvUYdi^_zhABhL&?)>E0QFfNUJLi^;F8ZqMA_
z``s4?TbjzTi-{D8=ZHJJ!>k+lN+~$GO=0ECp{5JE`<{&kJ6R>{|4zRBZ@1%O6k-hb
z7)%#XVbAQf2c^6557|^qg??)@S?|2gOR}a#@+Ar8o_o7W@ugia02D0u$KR`5Xjo<}
z&jpC4AJ9yEg#((8LC^JvgS?VFH0CgHoTsPkwNNALMw4rRO(5*2U(71zWRv;1?8(TD
zACQ(K&&_?XNhRD!@cHR3{SC{js|=Pv1hihIGuT)5QciIpH7N*IQ0g}gxJq-}d?n!4
zkNaypiKgv5n-A64Cs%X#2Xs%5rXbmjiHfhtPr3VJ$SZ010{fg)aR=`g>)i7&Cq=u{
zej1lu|2-VNPjrQ*bf7mLOms+Wg2m+()VK*9@&+oAjAX%Jo<fXy-6Sij&_s6BG4tLv
z%EOwT*vav|9U#s{KZE%#xWB6n4p+)ghI#ZyY$}jP5K|bQwI9|v({~IyYqSELP@Mrn
zDS3!&H=p7^%=&Ea6VQg>sQy3MelSOrr}{sOC0M}<?nXYz<!!H~ok`H1BPyutLf+sl
z5tES$xgd8X!`0tPF?YMZcewc8UB})}OSBtitawWU%u41%o(}@5zk7vzLwgomB<@ZI
zynk;znjzac2z$pykQm$MOHVK0c<$;3+hU^z3yo-EWNbq3cW!}vqTO8q3^6x*X7KJU
z8=a6INGQfDpwpZ!=95{vl#@{1P7l0{dw{~)d5n{bi{Cux%k|HbeksXE1ce8kgzv_I
z%0^bi`H)kX=R@Y2cw_VJr->s}=qWR+W93ILVsW^Oy;X|T1Zq?y=ti?Jmq0-En6UtF
zASQC-DU8rXb|>?bTmGs?>io{VAnu&+WgK=|z4bHk2GJLuPb`avKNWnAJMTIaz)O_h
zI*;9+@FL{jJ4oqgj{g7lm))&+pydDRP0(cb;4$r-B3`_~jPwWw07^LqX7i`Jfk^|F
zALiUZEN4;X?{esvrpN8rX7v0u6#(5qWcb{nK}(OQVYUx}v{goS32QIEK&|d>|GGs7
z_ajJzmCo@}@MHiTy?v@qRSl`nM4Xbxe0GcHa1d(kwKEIi2zVRjCq$~v-|9XJC`g{7
zIq4t=$L1modfIIuxYe$fA9Og7-qO+S9#oLyZNv*?i?E#I9g5gjkI1x^5a<o(@ZRg7
zV`nx|H*hpS$m#oi@uYJ3qk$__rcW{Lasm?y1e($WsH-n=iu=n%xVdYwMpDKm7vnr$
zido6OGGR0ZxMZ*s@aj;Em9q+}1ILmC$O#@u=DaGfgdYSjH1=PD5}d<q5)Ao+^d$XY
z)PV`Pw%nHF{-dl+%Go%GjH-$>;%=2=@^;fYX`7UY#=`=#{8-70(u^Ki^x2iVaGBFI
z9&Ev1z+=8gx=w%BErORkZu!?troao9yoRZ=&pUqa!F<bP)7GJnJb_YO5qbfcPf}0<
zmzLMShy%x)$a`9r7KPnYMJhbfk*yS%=QDCRcN-k_EuXo(opBd9f)e<;V`fyy*l(x7
z|L~k0=V{Pvxife9(;<n*n__%9R@^Dn8lV`i&<4#vS6s{4vH3)eCST+dwu*T~n0)({
zgFewcLp9|?W7GT0d+$H1QHBEiEH{Ab;pvtI9?NS)w4|T<Br^rbv>aeduT3GuxDv$W
z_-LC<Kw{<mqr|mF<@LP|(9~u@0_rVn?cjmnlLnw_)u1ypkfVL&@#Xj31F7tqVQkvw
z?7yJDDd$Go=@$QorQ(_k#_(mM!R#G4yJ=7vmY$>k%PWj9JL^9u;mnZ;G5pxgT4p<N
z7g+zDClX`D29@;-eh-<t?rWLaC=r{4FpZ4pdsT6tV#ZnB`{Yaml}$>4#=4`)@;NIa
zfW4tosT|Xr5x_zb?J*p_hn;GjUy1JPpeA<?=G};TwzK7?sNQTo0SoR1>7>{16$GzW
z)Sk|=P;v*g$+=uXf8SSngexnLl<Vv;oU*<*f&#IWpsgU;9<g+&AIGo1=k{a`@=q>p
z(og`O$yw8HcT7xAlRH}y6WPxVG*P(5zuy$f%E@<?{4DmdXZ}UN)4zY^@Rf?H?uil4
zG)x;2%}-v6-gWdK*OXq4ecjh4c5a(n4wV{?+8tVODyee(!NDG(OfluXPjS1Pbej|}
z*}OqFxaQw}$^T2nd5(CWKga1@mxug6vPv)*W0)FNnG6_Prvzb{BI!8V*-J~yIsh*0
zEzB;ZKxA5P@j?SvFeg7fyR5qfJ*Spq{Nd`!#<P(c8QDc1veLJ<yNn3juag|UMD||s
zQ+567vb5djbRsXgm&BE+FD#w;go5!sDk$>m2w#5+3f1$i@x@}RSSIpVZjadyhsCY`
zfy=mU|7YYPuc`!|W_gGZKA-IbChgWwF_v_oyYJHm<bUq!1o3^Y-@;!m(X9o+nyY=6
zZ6*^4QjxY|Z^M`;DO?Q*fgH;T;<mAkHG>GrJa{_VBmZwMMMc8afdH3PGGk_*oWcve
zd>SpoCgO@PW-)1kkMcsbEz`|cXa(;l#p;Kg*^YvmR!TB@Nx9)xucq5dc}v2ZvQwt)
zuTI;*s)^~?HsjLRQd3x+(hm;*$>&T~;EG~+UmMG0vkab5+;NAeEI;L;TS#&F9JjT2
zxTLMxlhAITYW!7Y{$VZs^3gKKo+ynlBxeSz`fFJyV#jPHBnBb_*Br<Ct|hMy4EkE#
z^MB$SzWPDl_gD2ua4%=a-F>=Y5=*+DK0!{@{b@JuOSGMeOTfvdf<x}S_u4p{=3J)_
zUFWzcMtu^~cW87Q0H%0P5ZQWU(}!m>_MbQNma`OyaA%u^NgFjei`EjHzc?Zk)VOQZ
zHMsS!CLYljjH-<9ojp?Hkk7<#2xn7c+_|-)e4;27)P!D*V)O|z$Rk;pnYI!fqCnzF
zYOdTHgJBG~AKZfVgous+)1!AFFBckZ+QyO?@!4@ae<E?C2l3~#>Dzs7pz-Qp|0&6?
zpP-^HWu=SE?8~0S>X~kE^<a1*7mzI!-Yc7MxLgR~t&jK~7=LSMmB`(V`d&%O`XjF<
zi1O2A&ISEm2G>oK*PsP<7I@}9M1p)&1Q#~hh1sHO`)CF~%ec8?BPQQ5nFi80xV~5r
z1ku`E`y#45{1ADHtC)hw=gH^c_2-`4eeUnhGQJn__mXa<<ecOn4!WJrgGpNfukZBF
z+E=X%hq>W=F%Tc0%kjPtNuO$i8B^c4^IUvlblj32)MG*9$5*&WytdQtII~`zR3#mG
z(&b6o^-4r*J@iKLq>@Gj$MPL#k$LH@EsFT?fO}}GX{HVjBU&av^K%=^+uht|nVXhD
z`yA{mJmGjBUwtjNM8%DLR_(KMv>QF_85`ZWhwR>2*I}FVOFQBB;E7p8;Jw-SLcfy}
z<DRCt;cwc{v_3gT6br)9jdx4Ydf?{<F82KvjHd)>sob?*h-Xnb|84B8nk-m((Wh-!
zu+@ylj;4#tqBe#52sG6(qb5ngBZVvvF~4e<e$(u!IhbK)l+&Fis3Rs2*8Ic$Q*Gg1
z*d)iDp?rytOIaaWwEM|UX+wTaCCY6}6K_4O^`tc7-(QY6zjarXhgTr1Qb7*x>l6VX
zj^2e_xePkjDR?FQbPedB44O@J$o)bUWiOL&fmQ1rl!Re?2q^s@p20~{BjYEgMIyaj
zmB#qsw}|`g#9iW?70<nKb!|zXI~P(<n7awuy}lnisGSNim^T}4Q*5uhfc>NBuZc*1
zWCf|WTsG=>iWV;X>RCq&Gd;Uk5z6Fdr<V?*^X4rqqG&Jsc9NLvgxp@sIct=IcxHz_
zB62K5>yVOGF*?mb;DQ=MwZdOGX-S^=ZSUSO_sw;vFE{W)CF<pdoE7TK@F5C*`#Okh
zg^Eg7@atoJR(@oAlE)NNQFE>I0lz`u!jEjjEvESHg~erPpqb*C)VEJ76@IyZ+mxie
zEt*)j?DutXVWj2H#edI1xT*9Drh|9{D|_Z<BAPf=BI)2AVIU)L)WuP(#I_Vv4YQ#U
zE8#vgE9!fLuWgEqKHMeBJ!SrhbuIm4U=w7XJT*yQLra|S9udu@4wi5pc^>bNSu&aJ
zv#1CEjAVb2mutOU&KJ)L+k+qKh8iSn9hzb?Akh0UAzzBQHN9dWZRYSGLADaW1})uC
z%cP}|i~wYzXzo3v*N-YDB_jcNkDRRzH2e)l<pJ4d=U6-5Ljl@;ePjuU{PrqO3HyS%
z%<HP}+mNe)QdSRk)q*)4pyqzt4g1NG%GXa9_wb6yz|-Vwsy+L6>bgVqYvQ{g)s)6A
zo3zwwNyPxaZ=j#k$H3rq(}_jb0hi75O*ErgCa)?)aLY3uO=U6&K9qIfNi~<I<OQDE
z9o}Xmhv3NL*29|<+4rQB9H(!re9jEyITlO5fRCv#ji?Ymq!x3dh;p~9(J}<XKQrv~
zdR8E=xJ$B^hRCdH%;n24FXNnX`}ZX^<Skak=<K=IolK$c-)|(%HdBD?1*tXKseh0C
z`K10X<gvI7$xb(Y`lS19X~QO%V$Xh($J)fXl#Jl?Rl}X(biIPEV18Hoa4GxfmAy(n
zBjZ_Tg#|3RWSx0<nKGzGRZ=6v;z8N-&`{?n=&gGjOHC8Rfx|pLP+C--R^E-RJB{iR
zh4DQGtBHEl6wEM`!*Ak|C0vQVd}wxm$yB8=Vyxvg3I0(Z>z|HVTs^01udH0^NG?6Y
ze8a;bZc%Yd6z=I78dG5Uo%P~<Zl83Z8bL~!H@}r9OFmt2u?n-Ou2^H*f$pV#oz*nn
z;bp-F^4?VC++R{KkKcLrfO|{n>z8`)N`qHFphBx7IxOalj$&AI(%3oOMY0!$R2>L3
z7~xllxb29DqNA)7vGBNzfGRhul~w-x0N@bZlMmHVYi^U8KqYdW<#}J!vn*KvTmBA^
z?v+90>8v-`GhyP`zM$6Qr@BjHw;YcLULu`h^>V;WK99dEmfEngz#*>@$1!35EZ5~l
zI~Y>twxn=Y=+M4hG{+4}Cw6zI1hsr<B*(C4oQ)IrrKPjK9yXE1q#a$WNIQN>e9`&$
zGjLR#410iOFo(XJnECgcA?d_zZ<;HOb<;9m%H4i7Z~bpS{NhG=Fx?QN@l57;-?HOB
zF~#5E*EL?NJ~}$1+EjG?Go59F6+2D4%-82yyDIZk3Z{mpJ5HRPF3+o`D<#aVtKZqn
zTj*kVthcwe$uG?=E?}3)SlTOk<IHA6DXQY|R}HxR4DD#53@YZVjT@SgTyFmPCtOlZ
z(j(p6><sYWHQd&PCVVdfI1CY9X7I}O_;>R9a`V2(DsFgEAUK&+$c0*>TV%49R|%e5
z&VfJ{??PFI!#I*yu9~oC0}wzxl1Uir4d8C%43{9|flNLc&u!_P;Os}{E%c;1RMq|a
zJ!zj{q1xKBLYdD8!p^*l-#An&5?IEUOCetYy$ssMMcp;as+uXG<|xdz4yR;KLGPK;
zPm}TQl@1y2f&s9GQ=Fum6y`A9+G;1pOin<R%)Qx{EUR_!)%%b0!7cn@qa)RN1wTEQ
z`856)73HiT#v62C3yfVw6B_pK=R<!_raaXL%S{oJc_PzW%+JhZ>xP2n-|wy6d@lzd
zDKwHo+GWG7-2&xR+x*O68oo(ia`m1HGrD`?_myK*fy)&hter%nR2RUZumJ~zruVf#
zR*~^NNZG9cSa7QQ9@OSJ$?0R{!&`Z%9N1&}5hXaRx4<l2wHcz<OiyC_pYKCy9DuMG
zhm}7k>*MRpzt#T@NSvF7v5^eYYM9@H8}<@V60OEe`jCLUV{U+aR_XTk1d-j1J54*q
zs&<dWxOLIB^Wy2ZJ%S(wGA4YMGhUZS$T-P`i35>LQf=%V)nHymz&YBuo3@}?(xu8U
za-Ze==e75{@O2IoQve3_U-eqoP=Do#ogdkev}l(+=0SXh+vfTjrp&>)YkXSyob6o+
zSf&KTg?H~MkC=}fuh^4K5`dwx7%+80hziotnp}zzi+@wULKC*t(Ich#1JOPa`G={J
zLkYd=iqy^Z?IA3^e0uu8#*&hkiPM>Xq`1aJp}InDuy5#gtus^xBU|@orwiWuhVTTx
zHy24flu>(lv74F(+xHDoKS7G<kPYz7r`IICOKKw7H;VOUcDA3>i<k?#sK~Bjxo3Qa
z^D_HYR;)rdi2#t<zA6XC2M3Y+q^qiO@Q-+3jbR*Yjjl$kir5cQBo9}faE9osZag2E
z<W}Tv^wV%pFz7;P%p;plnP47#jUAgZ;f19g#!)+T=hx=vuj1oULtXDk8CUlEH&%1z
zAR<`(p;oi%d`CDiA@@RCGOmPZUMacdhp1Jr9sJ$tLmC0%CqB(GLVvSQo&Cl~W>j$n
z(+#SH?%(V`OCMA7Z&2Q2k2~A*v5r7@zU?y~HRzg;a1iP})MG5fq-p+>?BV0@xam7Q
zGe8S(h*Twu&nNs9zP6ITYyQZF4mpy}gNiq(mQ83py!)R89Twd)2SZ$poZhwcR2Zl8
zvcOL$v(ZO#pvYc8Gpg90HQ0cXX$``7vKO%(k{rLBO^2~vrsZ*avx{>EO*6FmcJ+8;
zj7C1Xd);SX4`iN*lOH8)Z|FXv!vGNox9&m`ju^KmFc<Ne<^3x`3(`qjCXL|h#{!&r
z{6*ohi^7Fg?oGZrj{{4A@1jl|gk8csnwflia-G{Or5BC}T%4H}<#6Gt@NaL8sq{D?
zJI#uKoSk~xb@}_$B!TQ%&`KR7OwEFN;p<_?<wCc@qauoD$>_XUavT<q!tN6yAGBh#
z=UcH|>!2m_%q%QPMg0IAHNg?OiCb@P?rH26C}B;TVJJHFc>YnFS;^e^X#zs@W<XBQ
zUN<Pa$OdaXE0s4q)*1ZRP68{`t52de9wjjI;o*848PQAV1p7k|Ge(YeVDNXY)7C?0
z`Xm2Ee&uUTpdUuXb%Am#p<VU3rS*CJ@OHytXy3*KYRb+rCG0HCF>aROKwg+(klT0F
zW0yKfyx!~FR$)q|sMOtN9AmSm@h#2;1)_RRkaPOOGu_wsYD7xX7O~y9^VGOmmC^%u
zdy~1=cuG^3{W@|k(xZK{?NvlENT^UhK?M_2q*hicx_o$){(Q2_;o7>lJ(&n{{j-)j
zXEuG%YE)e{D%<o;Y9|?uOjt~rJb!0z_ZZFW_<Y*|n2LFNhAN5k08>Wlah;1xT_jn<
z8fEG85M5*^HNtW@Zg?nRyp)Fzrmx$L#g2lss*HXSd62pF?9Lu;T?*tAbr7~?r_a{r
z;Iw1v3?570As5}>%M)maVUr<lzY%Xio<dx5BDqarab{7V4ekm6*Xqs7Au<FciV*X_
z1>|XIV{}|jNbM2!8Cn|mUR(bh@8oE!^SQsDmm2%YYb81ho(RniSy|(Qi;WuWIVN0w
zLP1E+p*&mBL;nH1vNlYVh!_nrdc!nzuPf$)b(q)8Fx(c)Ja|yXxQVRj%}<wy^7hrx
z`(s&H&;Yp`k7my4JvdAjICw3d!E5U21Di_t?inAR==G^Jc&<VDHhFHZlR!qrOuI~i
z%rA6yURJ6K#(1b|aFd}uLs6ROgeGV=U?C<A0o0j!tGV20Z!$>*J41VL7EelF&HAo{
zr&S45rSoNLN%xZ^dy7a$-0L3prr~sz^rG|jrmbIE7f8Y==}b|q%##;(3-*|sVdS;l
znK`5VD6g40O<qSZ(?V6%5`AD%S!g2IBY4Z$)Rf7d7`Np`2GNgTJz!2bLEr=dPcnDS
zz#H18M%cf;im`XT^5d6Gd9DV>+xx4G89K;a&KFz-t>bcn-j{aDm1Ul;b8#Wh(UEHp
z*q)-hv)1RWu!Fw^AO07Wn>!Sy{;_Y}PZ=6c<Jv+NrIO>iEO+TlWNO~J4DC_oMvSAc
zp|lWa0EsJ;Uj>aL(SJ6?*bflKHvJL@K|EfgQ?hVc*+*M4c$DxW)9o&j6TZr$rVsAQ
zGjq+ol)HM^*B}S7`;gM0wV6j7m{mDt({u5uvmTrAC0}{mYjW#Gfvi}5>>lBuh29XZ
z?VrSJ4rD4bm4xj~7-h0;6kHFaWpH$@Qj!SLd1D8`>#oGa5XyV`=&U}Ln^vUnt646Y
zo(Fj-lqq~OYy&FjVzBH)nJM%bD+P5tB79e#%7YO{+35Nk5c%))%yWao33#huyzzQk
zaQ|=|y%dFp6HwsnAM}YMpg1>N?X!M{p9~~QdKG`>jI$Mn)4-+%q)s%#cbpB$cs<sa
zTMpgK%)#a_igm&St8dbdlD@uSKWwcX_PPjpV-*K2+%T$`!JiDHcA<puM`An!&y2(y
z=ms)wd~E;PrIM;=i<+5(9lasV$MZv|gO-5@n<v;~@%7WYgm27G1Tch0%fgem+Jq05
zGP*a5`wq)g6$;Jo&dFNIXBZAr`F7U2wDz!F6?$PS7CNXa<N>dBYJ)dXyj@+brM^>h
zv1=xZfIdM5ubGZ<B_ert*^^!5Ipuky-IA23&c4y%?pqt4HaYuQ8(bC9bw0>SNy5?$
z0eONP{724f)?B@ctEp(0GXF{MQahePI%rUmiXA+{vMaGkR$3ekkjLya9@&}Am^y;G
zj+!@2PdUB#F>>#T6|%~!Wp(|P_-l}c7uSt*wMpKBQ@l~L$%pc9Wn8&myHT-4H%h;g
ze6+bmizQ}=FvspAM|L2iV&~|M316*V@BXN>kM>P_@+az^_PoZ-K<cf2LL7R3iw+rl
z3B56I#3I%x3w&>S%uK>w0s(__3LvYCFsHq=SFcD$5whw9urt5MhN{MfhvWKu_-jDh
zy{v)nN>NekJBPPO!ASjc_+8p{aw-ME=S8()j*b1)o?EA)NJelU3{#j9F1e65u}V&-
zWONrYSJ?E^2xq#V&2@0czKG~~uEU}l9w#M$DNGPTb1$aNqWHr6bSJxZWKKOmu6jem
z8{>=*ZbAekPRcqCOUu;FshAy_P%7aniUVgAmJE6!U1Xf%z6MjFdSbf-dc89k;wB8G
zdJk+jNUb}A>hkEG+v{3)5a`@%i?>Y@rY_%VjTLM_cKoM9|415q7}*}Fw>rXz4<dS`
zwxT*gR^0fj=hGbSzLxnXc&#Jd;?=S|^7~({7rptu@hBm&6*PU{s(n;JyFCnT+SRjL
zCC};E^aoPAT!ymhLx-7h9W%p=0bop%WVpTua_>54RuF%#Fm<^7?uzssmD4w}Ub=my
zos1KH^@#~D@d`W?W}A>;DgX+VGO=B4;0RtRLhY(|3wX*F(0PAy2oJy9A>JNY=_}1C
zmC0&~L1XCxI?kq`t(NgJp%hhAge|>2ogQxO&g%FKIj8w87|a6DBIhLgUi~n+f$Ny{
z!CSF5TK(eN==j5q<zoookTVd*v2LVjf7MtiE*q-!hMo4Pb5wlAW603)J2mwyOnqE>
zj(K1Aduy)v3T0OEX~JB030RJAmc7)u(kZuCn;YrUxwuZN7g&zQCP}}oFvUs42X1T>
zt($1M{x^FT0}=>2XA!0Bhe!`L$~4oR0=R2W{?tcEUzcg~qIOP*zOXa5ad$oO^U}_y
zX45A#a1Gm82N9QDE2XG<``Lp&pxa_+qM}$r8|Ib2zxNLID(zsoSXUR}dV6-82~CKb
zpgS%H%zzuLgqycIsrc^ZR6VlK*;N%c5S4Red_?lL=m(7(2yw=*lRx*+l8{%p*BuJz
z-MIEFxkTSTZU{x$kiAG=gU2Qkw{rUWZW?I_pqP98q98@G2-R2#6<%Pcb>pogkyTZ=
zvaC0HC9UrqzIY5^|L%9EQq(`0py%DAcTk+!0mCYSrsYw6o8+j?8Kx4>Bhoa7QrcE&
zq7{F*RbV>t{FS-5)Q>_z_d#Vslh<DYQlNxymTum>>$))sHkC!}Qb#5Sd5L%3bS9#N
zXI@4(r=$m5%)>?1GwZ!(Hu$&xkqikSv@;ejj4J2%Sf`E5QB)c&k{yP(*V)#JnfXxR
z!4UuBT9qcV{rA;Q)eTefSntDBPh9#Vqw%eT?fCF2HJrLmUTV}Ro4*Fpe0{ZQ{;8lb
zv6VB3yhGj`<ED5{Oe=yl2Abcp2EJu}sxhb!TNlQUjdqT|dMwZ*NRDEmyFK4PJ`f$f
z-b8r{wW;IVabYex>0CKGOO8L2O)u{fc>jzkMW&z3rFNhM<h7a{Zw$qa4tUcd?UE9|
zS1pmJ2zctcSU0cA;IKMJz#|#^f#L-dj+QHZniU&D;5liXT(Z{{W?+>F+A<GU{3zKF
zZF9t88Op2|(*jQTC&t{Tqp}Nr=~a8p-5ZPOiwPgxOXPg*!FDx{Ui7BusqhIlu-ASK
zB`WdC!gy83)(DH84CTN2qMdVo+O&M}oE+iTBobDxm1oX20iUgiCnM?J>l6zE$(sX0
zg+{?~>pLKa{)@P3@kd#=wzgcb6i<!nnb7p3VKAs`lI?9!Y1T}&^`}-1-tBjJR84w(
z+r~yA6=Jf_I#Ju;Kh(dFx7Wo#5?KD_^w3ZOed04EKbL#@#HFO4BfT>N`i6K<ww)iU
zBD$(3O|p6{wq&h|pD}XR#%|TLRoZ1=j~k=qOBaVf$!v=W>x-n`;-T=N>utO2tYqYc
z@HgZ2Hchy;5ykkJG}aIh#oZ=rawsZu(E4(PkK&79+6SH0uY-@mK3KWV{3`E$6gGMR
z{LRK!m5#Sh=h<N$Yg^}waz+;Bk#mQ^Q!Dw(=4Ri*`ts70uB&#;n*Fp)Mk{J7ejRlG
zvkp2>$+>Z~g|z}6wq8%xRlI+0BT=&Lk+!1bH&tDmM6C<*iaq8nH&HPnU(~m(PFx~q
z9F;ga7jy@Cle@E%P{^KP8ixy+l{w69*iTI@5mT_~>5RzCv55nx8*)x#zTZUWHStw4
zzlvg$11XPxmKqS5(J!94Vak8y-o4WJ@|j4~j6u|vkK!)28=flD{30*Q@Q!;$CokPh
zR;QuI5HPSPKoO7M!@Ps|_syjAFW&(Wy}y?q0*H^wPV7fU;NK&UMV>rAB#@t}`J8h&
z{&H<F;NM#7xaY+@<Tp2c<@(mv7u#ih>C}js38>D!iA}hS^tU{2pKv}2K<1Fgo20rP
zD9f1UXKpdaGCT(dmH8&b^ZJRQ;u?X}S8un|cm2Fr*IG16qc?FuD8mA~4fo+uSUx+l
z<=sQ|lqWp(&r%KKGWk-2XUM0QjAuo;ch+3==Q<)#(@!s%Xi1z2<}GfE86&e_W++?V
zwqiXso<tjZ_&CaxyY0sB+k6DqC~X|ax?o$H##F8wgX-CerP=gI#5TX})rm6`*)Gnf
z&Pi~8iT&8UHy7V!eWl)Ai9RdVOh={HHRkJKznVpSE6wqp7ctH0z027c=N?3T>}FOT
z+JK#v!PW?w8_tlVJi79i2QGqDHu5$4H<hl(pT!$#;%@48k->^4JIdHB)l<HcR58sV
zr4lPS1GC4(nKBUAN|A9Hx$rk_FS4|m6>D^*nOWwEb@BleeYdWHK}Fy0Xj>-Vl#e+N
zz$#Gt<5Ru+`O#X-lt%@GW5<0tFwi-{lEJSRrIRjN-(e{XDHBrFnekni6uvOaa#gd|
z(umaGChot_#DUH;cERDV3rq~YRAF13FNd?vhYncQaP7NEzRb61gS=xtl;&fke>LaY
z*V|IT=A%hDK<KVk;+SI>OZ=5q>JL2bj=<|ik-Xz?Y{x#nP!XDXSP&R!a3UWXQde9g
zh!Z)3hW+JCc4X;|f*fw^by^1^qH7iK_NhxR&<SfP4Ji$n=Oui5cF-rP(mVH>GE<OG
zci8P3_y6L2%$_vb6T}qs0)FpEKk4BIcnZ8i&asBfy$fb{NqN}~ya#?r^6Y9zXXP0^
ziFp$D;p)|+L=gZX{|iGe|8d7dQuj?wukLGw77Z>858{c1`753Uo5l+;LO`|h<cR{D
zadLI&&h^<{O|Q#5L*=AzfXqi3;j>(~G|#V|(iHKZA`kLk>lZKFm~Hb`Pi?+go52=;
zY4Q&ttMiqq6tml~UEiQDcw;-VQdhKKA8Qn*?YpHeN_sU(vuu>Q$UP~!V3@+n|M{D&
z+~o%R6;{!HwL^VNbkoA!m6BGPO<!N6m3FQ2cXc5DQoze+c&i@ihL9EJ;t%};aYel{
zd)uWoXr(KX?A1cf+$BjEN7k(5(s=(wc4NO<H_2Ug0nzSZl(Gj$9?Q=wr|Q+q_s8Vn
z+y0E@e6ZPSkI=@UI?0~*NL8s3M|P%VL$T>mqO-`evJxa6AGByz9sDMWAr+>F$PMm*
z8s8pZnz*cUzP&vd$HarIYt{!qz{ED0x!281&Tn)G1uu-WRmG_?7R9iaV@ltPwl-Ps
z1mip|Brg_{rIWP5gTOJMa__`SHxNhAuK(@(SR_>;ck1iB8U5)yn3uyNxl|^@m@r22
zgaqAcmR6n1d3mKG1<!@-6y-Wx-GN9lI~vOd)SW%TREwhcq7g<;hB`W5O?8}tZfZ~K
zXx>3S`PQhfp$z0`5&1MF5weE6_5akj5FQF+I-2N5!>J?YE%Qht7qwA%fK311vn1wP
z3|=_<S^M)90!9^p!$FP3+LI<vmsCZwS1q6HZ?|&)v5?4~Y-O4p2C>8MmGC1%MT1#i
zJ$M<gLQ@pa#ate~-k}Z`o+B(m9_F$6%zs*ETkct@zRLfV5pY{2z{(Ih+5}20fROwb
zD<|SeE^I;tm{Pyee_lTd(caju>EV4t(z5{I5+H;)e-V5X=S?~SGTqK3G!wL50Genu
zN-qYN?%1v`FB82}1~K8be9UM?xQ9NC{X!8RAsPVDLVM9V+*YEE{xXBJRo1fqOjC6S
zM+??Z7r<2Ta=3(aYkAp;&cxyT?C;2>S_}E9eVpe}6UxW%)QI9n1$A9f8B;xD!<qdx
z{2l?#5mB6ezb`_aM5_suxPg!cZvwK|4xXka>TTe=K(~kRLE*b9h0uT2OW&nwHyoY4
zU~)R;xdX?2>F+ghIAPH8ogzo=^!e}XyS9l!gIkIc0=!j#Yzpa^|0$4+MLhJ(JWoXB
zug@#$)F)nCTber_*Y_xFjF!o}9Zl$xobJw4=ck{0%XtKHJ7JIfm&xGmUIdGl8sZ%5
zO^FRnF>8ZB!>TuyVm0Coz%Tl3A(p-5Hx(eh5N}n9B$zCWi|-l}`K4&jM;GJ&{k$nm
zw(tSe2le-F7i`pcRWo?Y>)k;z3wYf&bt<ZhC%!v|kIG$A7RkZxvpD}*#z>IBNTEY~
zfn7<dBdoh$9^V&zNRB+hqhEBhjE(63FFhvB-kSS4Q)9Y28G*@@DKz`l&{LA`@@Cxa
zNjFT+>W1CBrx<Rra=ub^ij0*P+l6hP>;&a6=*N@BxZBqT^mJ#om~>er-${nC&@K?=
zey4YZSqD$7s-W{AkrU?zg0mgEyIBLIAY0bWi5fCc$i^{NjI$mjSbxveCf`yQ2gG7_
zNEE4f&=JxZBWAt^8L6R>n+ZtK{W9|hm!%93u{hm4iBW$u2uCID%Qo%sXR&%T%II6f
z>8?e}I^65iInWVZ7T*msxGv*-tiw@DD>0_dIZmicECNsvTQq<7)2(WG@ij$KfqwNT
zl_R&zG#~<h*ec~-7VF1zBs;)Bas%Ig^<o{f1NtJRD<Y(vJ$`K!UijCE#h)86aaBs+
z)34*W5OV4TN_<@QQd#g0@a?f~=kKBxMeRl$(<1bS)^(0J#79VAk7Z)I_8kk8GB(A(
zd=9t6ssP<fa3x*8E}d&^`E4FitJvL`fAU($2RKJ!+!AD1ekT%iMsJJVM|}w1Pcd6H
zX(>1h;t}4iX1}JCl!!S2(ZP=^bGAp`xa@=Ozq(H{6527^f-REU^Yd0_JqFG^$Ax}r
zY^uS^OMXteRJ7Wr#|zkF5DHVlq3Atdy!o4X=|+LCL3*%l(G-MI<*AlBj+`J7y8sPb
zlF_F8eHrgt@?`-zw}JsX;J8JxwDZT57+sJ=+UFs5{_~5Mr=qpa4mDPa$y-;v6Ub}W
z^~ZBmEqt=Kj+d`HQ9J)Sk2G0iEGIiQZOEf??rK1n3NC>y;0|*yHO3h|MYDnY^rxp4
zL^ijbttnIRFDv|cPexdlKv!y<l_ny|)r=jOH;Zvv;n2K>Je~c|I1-H+dvhr#DxQKJ
z+j$21!|WP@SI<%c&JDB^Se!L<RI<Fp6m@Pp|544sl})=P5?#~$@9p>xbk;QV#b1-?
z_1kEHY`@k>Bl;AUmbXrgx7Kh>lRz%1JHF`NGqw4zB+YP6*x(cBv{HpaO{fuc6*JVg
z!ei`vPHmTWbu)YO{H!k9Vp9NxoaBfJi{$IQ)8DoIxj?);cZ#(%YeD0qQ6TG0m*nA&
z8y2B+P!}`hpfhYelIU^B&y27y5`RCRvVWM-Jn<D081|F2HvEUHA<RlTk0m4-FK^49
z<crAcoVF9Jj&vP(;ftQx%6aaQB54<P5w*PElMH9w`249o?T$?fCaD@MAI{Rh`ho=Q
z9sb(<^ftwk_*ll3Z(EI=44A3s?3O;35ctNyq^Hh;x`QM$5q_?^ZA2H)y`i~zbXLi(
zTe{F_z&YLg@`a>_gyV<`2Z`c43Zl_fhCbEz3DQxQX&T(zxSN!w6vLz(Q_Rr<){JIv
zUHzxJTUA!D6|W?-%~<Z=lOg&+Z@Q@~1zms%Qt~@7Gt807rGw9&?Y$^caj)ReW;eAw
z&Od~LGoU)&5;;MVr(6lm@b?@j;|LJ(0rX(KTJ^I9x4*2JnfAv!)M`E{vQqNz(&hh4
zVta4=UG4AH-ftAYOE-losi~uE@-dv@y>5Y#AUN%M&d`~SrkFEqd&xZrvHXab*JneM
z5e~0of?3W&gU%ifJr7T$oHHd^l$rDh6t7-?8v54ixUugG%PmlLz@z!pf=}7^#NBiD
z13p{NaBV;={2_Vg%&4|>RXHxeyoH&eo7`M7>aE4@Eft#F+%iSdHgDPRkkBGtXM+ST
zUsL5OCSLOtY6N&hXSda}`+Fd{aVb_A*`-{|fASii0&=aWYs@`L_!nk9|2Mm!Dejmr
z>*8rwCl>2TxF*e&bdK_T&W*B@y_MExS~zc8j#$&bJS4($RcdSEI?Yo3o_(Hu!URXy
zUZ=lwc!if$;1Y<epP}VUV>{;JOb=ou4Aj`C4QnZ|`p8BSJmMyTZ{a=D<r|aE?4P&P
z;EoL*M@3AUqTx}?kXLiff4+Z()<Sid#jQ+QrVSt}>h`9b42bOfEoUBuMcAcU+DcAT
zL)Ue(`d%?>`C?ra=Kl<s#!VzY7W9|NyRT27nQ1IPreTi#KngTo?~b!f!lP3mKo{)c
z*>d@bvU|zE!@s#oH^R#@&kx-1y%-G>l<o^SZFGEXYajb?5ubK!jJvt7K?#M5^uYS{
zLxYFDZBE%6UOCSEtZr`#*vdpW<3W$oOwS|rQ*j5jrYyO-x(j;Ma!rME4b1I`!-DP0
z^`|)}<=`p-4Gr{P9<42h32-Rz<cDe2Z-_u#(k-3slV7lvaMnp9zAfBpjr<7TNR2LY
zv%HDHYpJlHQy9`?gU&3QwXWEgMe`EnJO<qG<MRP$8<Njz%|#VtnePB4koO~XFA&eq
z<q2159jk`@BvLL)P{;TE1V*%zWSU_%(+UP|?YT5Pa5R*BF6q48C06cR_x5!+*Bj~3
zwPkz<E}XMV`bLs9#})RqBsCA!#qZWN+(dSXJ1iU(kp|ucsZXW2Pu8g{FRjZX)78Ai
z-Epm+{V%b5a-L*_KS;u_Q@J!c2>$fZ?;^m)7Oe95kcKdJ>K5%*3+IQQ0-|ikXc1Ga
zm(;3gH@|RBdxS0$x<F0={QQSDP5u`TNx835eslHgl)dj*a#5{)l@<YPrCvw0|E+G-
z`6qr^>{^VieR9WITYzR`-NikNAoI?0V#ycWzxvjO^ap^6b)fir&EwJ3tMOkPPg>fk
zg#F@rM11s+t<Pw!MO8=gW`x;?8$Tv#9~Y9gg}4JnF}#wR+@JdlJwUnOao{>5!q><Z
ziF-5PARG`Qb<&6)FHedgdf|e_6)A_pjF(+*2rniD(WniS3tYNVTM4VUkU!{D`N&cz
zL_6C2Z@EhM*_I;ymul3N>`on{@wsC|Bf22kYv4-wf0-*&q4q={`=L?L;$$l-Y)cY%
z3$torWMi{M%LfC|2lbH%kaFI*jC_JhKv{MVcj75|U=RrmQ;mDHTOLH$`Uf;>4cimz
z;->*^@o=m1Q`SivKUtORcz}iLp^h7<S7PIz0p}_kXt3kjxzh7fXh;e-w0Gf7<x5@<
zHn`Dg**S>W5sHJzj)lq5<Dn9-Q~ewyZutO)RhgfI=pfkp-$O!__uGq!tQdc;M^W3@
zwd`R~h}zb`f6zh@FgV<jy1l*&O6mEi^PWvRng{;8alL>_L(T;-i3sL2lc67~+m{m|
znrti#z-zzy{SneNa>`7fN~%!V13Nes^_`iMbQ`9@yTbbua;Wbe@3_dslU_5`AvS=&
z7=XwjmkhYNxKquH)r`=9@9jzscUNBzQH&tOA_z$J{nfdE0n%#f0AdwS5w#DCew)ZL
zsS+Y&?xDaz4DNNHyt0~cTWcNUT@k@EtvXZb0^yRn$&B(RA2&$zPbu9`m-~*vy8Kvl
zZeAa%viFvkkbHw{JwyP<YJY2;O=BneL8`@YL+-OtorUfp7Ii{85T7PPhE&cvl_z4>
z8?u`Q$Je&Ku1%=bdIktCE9Ho1!H&hdxt_JLyn15n<Ez%Gn*=c3aqei%3YvFbN}jw<
zJfWZbW=31)x15$n-!Q8^x&ax53XjROUYyF<5!Un(({J&Q0AeV9lb-nm8il1{uKGlq
zGYa!9qHY!qr}f0Zz)-Wg)Lq^Cm%b~wnc}XSo2t9IaL?u;j+hQ79=mG~_q(1C|1mRb
zc)<^nH{?S{zWLb6jGe=ZkIf(7D0kqHa_pH_v9+z(|5Msu<@RWHr0QnO2cg*@-lKuS
zJqD(&uhj7-n_MBQTftPT8L7Q)Fqs;TQsSVZO0k*XbyP0Km<k^JT_2$J(l}Px157Ip
z@+$RUwr2uNl^vwX#&FXU@lC>2-AmJr1hC>^W^;}Ug$9uU5|=NDi8|E_a$hOoFnWg1
z3t2oF#z*ZLM~X_z0qw-bxfit$%SDCg&T1GfBS%f<DGsDJ`|r?e*G;GW1L}d$Rs~5W
zhC?Wh@1HuMvP0ov?Z(UQJvJ#d?MNgwDZ|MK0z2fVRrQs>_FT!a7LM1!PHczGlX(BE
ztY=rkFcyN3<j(KgUwv`M@wD2AHQNa_(J%fSxH4GmKWWBPc*SU;)PX7o^riCsAQ~*>
zGuHlhZ_^ab>kA7FFA`=BJ<0@065YM_2damK%F{czY`DlmcnIv))Jj*h&4DjmJOaAP
zRwgOQIGmE2cf43HoK=eRH1K9CU|?0P^n&2q7?x$%%@xjsg=0iHU*5E9V#<o=<n)#H
ziV8FukLjfWkd@n-R-EJspGjc5KldT4{PuXeIco&HI=OA~Mz8NFjzR;2X1DGJ-tt}#
z`%&-9k})YUDjqip9QS!zxBvOy6e{fUYB({cn|3WMa=%hWFfYIEL;0CUI^iE<mxOxQ
zhK?sjsH%7|2&SfxiQ4e}YR%fKDPN{GIH_QOj_WLbgb$&-I`(c7c{ePE!qO(dDODM|
zM2J^tcr~Cof7SD_>8}$mWu5g?cO*Q#Q9v8uZ)>{J0d0i1Nl&#m03}OUjtOgik+=xn
zUDEk`=#Dq3Ucm$5Q<M>zC$CE&4uuq%vtjkGOKcFz5m)fSv=4{-qD~fdZj2wTs+NHN
z%#aLLjiWtxw_7vO)piZhIeva1%+kGSR?PF*jzwM6Q4#0AoXf|>@;5&nvy|g5Eg=^b
zx(C0ejkc^dtN2Roh5jfermuX`jU%Uw#9P^sD|Qmw)!X$N#LYp?zJgWjOr-8C^$-fS
zi@71o>6v+8Yz?NL!3yL57TH}oT~+qvW#@S0P$zw6X3L8JqL5P+uPQAMo-5<$=_^^y
zk8$yf>BR8;O-s;=$Z+WCVM9*vvRnX=hOsK6)`p4FYn?mKm|Wkt=E>E5Bu9`8mmmBv
zei8wJAKe%kH>-F=72j$^Zu_FMvuF5n%hr~kx&nDzm2`9UgY<HyXIv7OyH~?X4*9>C
z1cF<wFxt1&Ca`%jOlJQFbP^kvF6eaBIdy0U-;gCxDgJo91~_MmU1!OD>h9jmBOwAa
z)Ny_vMs>GCbaBd_Nzyl1(Mm0NSK{zNG_6QfW<J(9`PlPC5#(MS!o#xa=$_a6SFK4_
zM-Bf7PrnxH;rf>`LMV(RT$2|}e3?CotZJv?ReUY8WNd~qZQBvQ0#dS)%c>x2mJ#LS
zd{;G7XES^<%@MKT=irytq}fTHInHziWZ!r_XQpX{H1baCT<aWaFi$AYX-!`1#EK23
zi~y1O9xC--G5_*vRJ?BlH!mb99Iyc-Gh%iL#6!pjs=R4I9|}*?j<nu>p>(@s`)}5k
z@Ur1Y;vs+wezfE0xkD~yqt6<zK_BO^OPD`-_mL!)@wUP?es6v?e^ajMJC3J*e(-X(
zOebf}{q^H;pYF_ci(OKqH}T#ZZ<|GYJBe_Z8jtOm%&b?W&iu0ezd!i@9RZXkT3gn!
z-D(X0$LY(IfpVFiVteTOoc*eTs5#EhJnPU6v*EdGfc1>5f14yD9z?zFaD8r}j?yHW
zOp^g~4kNl~;f4%xqZ*e|fNbLC`PVn#3R-6hUP>ODr=tg!>1FxIg8|0`3^Mo|4$3q^
zH{>~t7TM|s=$zasoJjY`uiio7IH5k*ZzXoDgA%nwPHG$$n=B0xM4#TIaegXq#f$?F
z_-H5F(>(Ly6W1^On$$SYWb);SBn*gb(SbLe4wtPv-A_M~-GOKT3ot*C!&%?kPo0)M
zERu79K9PuUfm5Dp(kSAp*faA29>J@jDO$$xjfN%4<7clRJO*5FcVFD+Up|*x1Z>_Z
z4{&F0(7g<Jc`sYf<XXG>S{A$?D5O$PdEI=Ja@l+&R<uJnGG|(EniXK{Im#CuYq6)t
zNCmFpocIN95jBh#ZtB&G-TK#84;;UL+u%w3-}^Bx%gZE*nqn}2mz*wMgA@rnk|i*!
z>cMG6&EoRQJK8DTrw8bTUw)G^vumwoO0=_fjgC>vGJT_wHDx~~D4wO^0&yyFD+G^`
zen$e|NBiEt>gORW5y>Xc(@OdIg=;rD^y3345psnUl`=1L_%;zIiIRV0JtAIr?fGoN
z$m=ruD{|L!SH^A?dqR64eyn<v8<$5brWF|aQ!@RdUw>Ur|6+iRk7LHq8qXfnGtfv)
zZ*oN4M5`Zd?&z?dX)VsuZ&2Sw#aI@hic0<^?sfd%!oq`3madwJ!1O>f_p+iRSnaOK
zCSfhxlIVPtb8;d7ge(wl8N@>mWC$EtrLN@ZzL~fI0+TszMg5Pu{+}&*wuO3{^Hdy~
zA<wGpuHAB=P`tpaS8#IL15D?4p@~obY(yr^%xGsG2FcDHtRThV`n&zgwHcDubS{FD
zT`oPO<&=rJ$Tp__9(R<vB(W<$Kbxi_b<;P6?L6O4E(jJ`rlCur06l)cK4B~?eZQVp
zD*yx|&LkK)M^^otcfv(rN{A8MtSZ?@q#iE;yYC>xb;{znvjx8HwG1HR#d?wR1ly3i
z)Q2k0#1IA9*z$BcKYk;<TRq}Wase~>zOr}`eqs2e-?t7Yfy)8x(=vxOL`ojm9c2><
zLm+A&&{NrDVmcShfb=7rrP>PY+*wC>aLG-u?t9FCUMnuQr+U<69iO5(+Sc8|(=JY<
z<cMs4JVW_jfnYuR?-a^mY;@j4*!j%4crh)W2dhop;xNg|DPQXc9$6G4FH_-I-c|It
z)x&Rydq-U6r`gJepZWq={UozFv$ks_cM&~9%zFUO(bmwflJI+NG5@JW6-n(}&~q&c
zo9WGc>}F3zM>J~5@S^zqMs42T!WF*L_n0Mpk@G2bKEgj)TC@&9T2~r|z2UaP3$`1j
zO*?E7VkIfOs@0pS4*MHO6A^)`qUdT=VREC7wLw%nDr$pXngDmc_w_8z;n#ISl;r<w
z#YyDP9Ll`w&?huXWcgx<@8`8(q7ZAq=?1@-n7qe-_)=0rwDxdNixOvaTo+g*8seYv
zBkUs?*%5#}IC!UlJJ)}wEs2^Wa~<6sw83&b=zIMSALC~(;70%v-=^f=Oe^H{{(GH(
ze}hH{0V0(dvd8=^D%JT6Cz$|{lEN*D`sH#iQnw=fML@BKTj7ZIRG4f^D_Wf6(3PvQ
z=`Vm_maE!##Tk<l?~epVd&eTv|D<&!{ky-G#^RTzJy}@aSe|RHYj5iVLg9+pAQ=h<
zmE#!gI*_dZW6AL34@Ahs+&#>_f~W3QRG(t|C&=pQ0{uP*1sX7ce}z09F*(MM8IhqC
zxqLZDRjzeOF4hFr=V0pSl3m(r<=xBM16_Aq)ARVR^{w<~N;^wBO+}rA{wiE|TU3cz
zb4tyT{YJDef(T^ZM!b8P@M3-$P*(6I!Z9!)+gyf23H)EnRdAN1Lb8|$!tiR~oBj_{
zW8(MwFt6;t*rU^)RY;3huFU_d(f>XlW!~2B<ccn76+5~AGrHgFD+%!XE%{=w^u}Mh
z{9;<oBFDs;y*GNz=#2uyfWvF{9FM<n9uJfH33<nBhn8j`yKfp+?;WdYYn16~9nZPK
z_hA1L|0wOfc)3zSHzePVaVyvQkN>GW$7${>rRFmO$l;%JpxPNM<<VS@H90Z|)?-7e
zW@c_|=rb8)l&3v4ZaJQT<{-YRY}hxr(we5t&uncWa1h^CHvEgd`G3aHAXwR8Wg9mT
zHM3>r3xNeH2-vdIzK6?hd_?dK=4J*;!fdc7zI>HIvX-Lo8ob6{GhYIVyT(X%vK;gV
zMi=T9;eXFO;MR9rA%XpM7uvJ}q)Di_fr4L}wP5?&w9F9$?fUg~s*%1jCj?NYUDxSS
z5!_ozdzDaF)gcIRdv4uWG4;gr-aU=?r1RA(({kMAHno!v;~8xG$gsZ07?%4o*VVKg
zd8QL(Y4nHj+&;kMe0NQfxa6Nt^CpT5%JBxC0GEt(9us)yk<oPBBcolg?aW1uTrId!
zw6$*KET!R0OJW=oI16Iw&&lz8nQcC7v@9bli4Yk})VTeZBYwK~Tx|}E`vZqXd2H=B
zUS1h3PV%2Sjh7LVyST7pJUhHyvZ==fxC3BEdlVrUdzQGNrc4KuG-hchvySXpggc?1
zsB(49sGm&rDWxZdJYP8ZCUJ;RlPiwxk|Rp`G>?d}wTQXwDr@{iN3PWfU)!Hyf;^y^
zgTjo76YIaoRg!obe`v)Cd0M^++^c-sF-dW2!|}guKqvm}qq+Q{_JqAo`swhfWyJbF
z@}(P@0`+qj^ND<;3y-`JtWpX`-DQt~{!QTQwwagOrTg!3+=09EPV6WC|G@zL#Gw}<
zw*T!j2f#|`g#f?94bdd}p?7HZ^Z`LgdkLaYni5!Vnaxw$DyCUCkaLZGORPbx<b_XP
z3=Ge1Ba@^NviRaS`bhDRRefSoN#|5NIrAJ{4hb6{RIGDY#Ae{jqQO8a$3H7*i?`_W
zKC~Cic|qtwqPXBkiMTEg-Zs$^w)%^RD|u_o(%e&#d#6I~dT*8fKSZ4cRFm%?=(jPt
zMuRj+C>;U<(xsG%V2}bL9XgQM=ng^YvcNz<Q2_^Rz$htO6j%U)0Siz!WbC~!zyH1G
z9?y0L$8#7w&z|_k=ac)bT6lP15YqOpv*N`3ThNIy#<hPFcchqiO+5+K@KeCjH~f-x
zqQRJBcLbf8SY|5pq$Eqfto7G{4uL^$D#PH>T=rVg6-}WC={(bn=-K*&z@(9=HR{qY
z;b@j62|{b$+3%o1aW}92^73nWwcbV~{^fY=cUSK?HR}k$V8Pw*cQr>3eNPV97wnhi
zd0j8Ixb|-Sz4uHrXq?IS72^eigHB=m9znyB1>^AX^KVS7ia7uB1Wl=2E;cPWmzq-#
ztKTl{9+0BNIK6Ryj!;vogyB3^t(!03dofT9WJD*NHFdI?syGZ0;J9FclgQEM?!MXr
z%tuEKEUD@xwm}o>zApN=y+=stF?lc>#dtaN{jmXDa%l8*#<G>6QR=8uI7LN;IX=zu
z{hqU?7%R89&{vfb)3Em4OB2klghc)Owo4bsvJPZ$t+;m$){R*JYq1LsWL5Mk2!3$R
z)-RtN{D=MX-~EJns+<Z|zZ{@Dl@^$lJXKp{*%X5w;)7m#NvSse90;GRut2!3&b_OK
zxx={Z$tz>^@c{Jm(K{KPIPGc^2Kl}L5gCYV*lI`O{qx<-|Nq<)IwI*}0f2;Z@W-UE
zWfOoJfIAfTvpt+WhG0g%>Fe0`+t<70=jhmkPf?NKL_PtXy&P$^%xBHb(n9%$+F|T8
z)JBFEwNKa)KJi|F%gN4J<lm6r2Z^(za(_O3%WwC(W1_lYW7(&ZGRT#mu-U5cT{!9d
z35P2I2pc~CmmfwBL>i1ST};1nF$?%+Kei{3a9l2G^ju`n_`@)?oF^+_ML1uiaw$Mq
z`YkM79pajSK51gELqlgC`No+Buh2jLj?3*OEV}kL>}a*lccW4|LT~p$6jM8Y17`0a
zwwZJioJmlxc;1amhzTT4=y}e-?;!5P+ZSZUm<7Od-p7dCHer^lRqU@(YYNFL#5?Pp
zll!4xwE6U=-SqJ9hx}S}g)im4)rqggd)o?)K6Be}>9{!Mm{+*3AFQjEY4NnrG@Iq7
zsx^j{+iud^>|*ys#e}t$QA$9piJJ3P9$hg%&$@t+g4C?ymE+cI`fuAFc6;ueH{5&K
zlXs+iI<389Z$(cN0Y$#$)HL-|OC@O~cS;dTRm92E&w7%-5PUzSSi$z0AC7-`<72$F
zJaij^Zn{-i@@@?rwiy<zS;+Px7>gKVQFrOx;7wt1zu3Uo<`odS3J-})c<&1E;)2u5
z4k_A5(ax5F;|wBp?07!i)w92bWvXLCGzHQ8tsY<pZN7z&rqJD!#BF!&`>wA~Kf9&<
zzym8+B@P;2PN*5VnuY^|DjU_W4u8SbI7aUr#}u_#(~e#2`aKtkgDGHt?f^`ESyk(y
zBjd3)v8o56Sqak|`L%=iz2}3XpK6nh>jZlsPC<s>$H%d>D~AI#ro)MEI9U>AOg{+5
z_&9L&Pcy$DiAVKxs8<?_raC{HU=xW>7}Mccd%xr{Tp&M*0!pk3us_J%0QnQ<&#uCe
z;ex<FAkC%+=7a>H(+7~q=cX7;ulLo5rKer|r2=3daKt{Ex8UvQZ+{Oh(zB?85CyyK
zSLq75qn?+KlE*;1;8p*!6N7Q-%7euvS1VY8O4_h8)wk9A|JI}O(o<Wb@ixWR;iJZD
zUm`@~=AO_LzQhPwbL!voQu0n0IU?&n{xL)3OpjYvy6Z~^nBWc+-8QA_@+cz9v7Q@~
z=%O*lA^p}T!fXFvHX}Vjz?(Mv^!yhez6GzpUZ+?Dx$OAKD|G097^d(^2v-nQu7Ot1
z(>U^Lb5$eRxD5W}FZtI%nYv8Doh9avaNY&~Cw-2KjEQHj#Bv&y+=rKH*iY4)Lc#MN
zK2~E|bHNP#hi(PNFleJ!6SMJ}?`CiBg*EoPa~>LryVAtTO_1zku`;lNhlP=ZX@TYe
zOv*tq&Gf;QiGx{C+{uqr<mjpRn~xto1(Ard|8G1KL~VgF3ohk!DP+u7A(&rPkDZ%-
zlVV=RlUEQ72wI5c<hcBxfyspy&#1#-Zu$>UmJ=LvdxEX}=At1^TwQmR5RGhYe;X_H
zn7ggKJ%G6XKt@=$9A6uQZ4ccchpZkmBX@J31d`WKGus63v2&|Wu@|5SSXt}Gq_fEG
zV)cU+l7GMd64K-lZvXR=@C6G1C{8HUbZ3Q`Jsg!$y#{jqx2#!?tbGi_j`%F%`ZepC
z{OTE&Lx{j7{9Sdu<eHkgWbl}iEpFVB+ST!y)Z7Omu4%YSVy_S1h`a)a@IkJruIv{5
z7BAye5)ArKsu10a{s~#9;*^vup$WQLX~yaTwmg12sU5gY1m8tGKX(ts^%5E}Q2kO}
z4SMmE{;>6vwtk}s665t0CCw;n2XOBXl17vWz?40otJF({>htoT_lJxN)A<(h8CJiW
zcn3%5*R(*SkBBj8NIYZDRtzEtK|Ip`USMgf5Z)x0)H5<Ar%)ROy-W+5Soy5c;p~UY
z4Qz|y&UetzoSH|Tnfpu!gnIQ|>8VxL`8rVCOdgf;6_uCO(d9dx6LyM4%!*l}*jFW;
z!aS3^IPNk->og6{S*NlMxA>{vf{a^=MuW0$zrfJ&{92moh0lEp^L=9}Y*o4etPea3
z>iZ0@n_~&U-p)gIv`;@Iq<kCI8i`#B0eKL-52kq!rEmJuZw}u+rMQa2*Io*AH{yX*
z^F@K>-r%GNaBOL;MX~HyVtb3y+e3CrXf=7h4CWudxSZ%5SY7HzMn9pbO;rpRER&@z
z+e@*$OwQnGr{54c@5ze=hM%`G%W!r5RRlnS<ez^^6@ILSCdgyPXJat*rj5t=aA}Fc
zEHocF=o8@+u3e)0>KcVQ)hUQRz-RLV>t`z{G}etoA`?(Bw5Gt2?VF;3AwnW`z=Hwq
zZaTXSF__F?XYf~Z>Lpr`yP+RyL)+dk&&F#$uHC(LldZE+Fy;n|QSg&VC^!VC_c|(k
z*x&ED;8tcScb+#|u9kmYm-)#Lg(Gnz&R)|(QXCVV8-Bt)H55_nAi+ah__rLh?FNly
z4UGsv@CWH<LNr3}^~j0M?r$>~wUUNf$bX437`1L{O8@Y*F9qJDtdPsUjnby#5@6{)
zO%nbVdPWePJ1(EoMM<~b;)e~Fp+0GY6-ja~s%nyU&n*gJiv@#92Yg0eXf!Pmh{FDm
ziVEe|;zdoCvzbyem(#lyR@Aw66iaUP&FD)U$t`U~4L^cBa&r-${v_f#00RYv;mS9j
zq<G)w4o|)^beT>R2^4Ku`rb&(2^8@3G*<W}ohA1BMFHcL0KRn&FE)bgZS@uCK4zQ)
zBinOlOGg2E-6s*zL%!zv&RJB&5dy*C#$Xlx^@LGCPS<QdYo0jK_Lw=rksP%{6aIHq
z|Io`&anq}dK#VXObO?`uv+1X*ezth5l`1}-cSsBF!`l;B)A0!l68O7Q4o@Occ^DA2
zg(pz;CZ{o<Gz5FX+<@IHb^jyy@5Jt7s`u{p=sq7e4++bA)^pM<wjVq+Bavy=2=d?a
z5Ems~=pjNm_bE587M%cfkU=dt^r_4Frl3Gm{N}?8V-mu5^!jucW&>zvlV5&wVe`h%
zBdpABgdj=#AhTkeXHypmaxNZYJg~A;Ah5ot3l%a&+AWN=OaW<V%x;Xu(t<_hvD@A7
zer`a&eQgC(qq|C-!c!Y)b;WBzPj|&TnIm$SgCt4L*BxdXXqem&gO6*Rdbb@fygs=0
z!>r7hkBWZSV;6Me1{kq|1<c=-%N!QeXUlP38nSW4YOA$&wmrJh`d;r}u(sjJCh`b0
z%C^jE^_Sj}ZfoU($34W~d;aFQPRIPLcbN16j>E3x*a(!}yFXXD-NAMLdJ&YJg#j}1
zPT{|G|F@Q$$Ly^r=gA<}FyhX>$F~t{reNC#4(#`wT7`0wzEX2zAZS=g`q5eIw{O8D
zz&oGSD>!r4q}perqVPHWYLj~SO4rm($Y5TkiNJor*7qy}3#G+TVIctpIn;0gyr&3_
z*h%=8RP_pd%+td<`UN6#dCcY#?=R=AefpP`cM~7<UkZxq^Yo4~1P)zf8)cbAJF*H{
zDN4I+fOoXTPf$d_DdOw-u^_v+H>XnH7<6VF)*(*H7Ck@zY!9t>eAK&sj_(EkjMrs7
zI$5^&@_SjrA#);Gi_mU##;_P;AWB62*Y0?T2;##O!EPu1JYUr%*G1MvV)9Z93B9S2
z1Rkg&j0%R`j;U?Y7`jxDY6<of^%J3JKK|lniQA`?O#xJ2M`7IG5nbexe<^&iwL(i{
z|4rE#_ul{(H&dm5YAFos$x2(ZV8R{5d<Dl&34N01^L!Ty;?&`SrtXa$GI{cko0>$>
z!|tZP)~{LGp%JOXKyvys65!QgcyUSxgrn|YQlAR3^!b=0hokVl#pC!yfm7vft!dI3
z?Yv3+?<t6&#dPqylySR*9KnrB8#xP{?G;-9U0cOT3P@s^kd)Kz5@~nuwNVnDw_w}%
ztW8vqGbeK6nW6C~uYoHf8%=+H!_p)ex#B_vh7;hwO}A%mSisyoa$tWS4}|xUkvN3+
z7^kMVR%`Sd3oI8lZGV{yEx||WzWRv;rk(4GI)JJ~L{Lz;u9C0qFfMWQqY%g?gXLN9
zvf{-^gk}72?zVa%o?_Vysk&#w|LP9xA6}#T<(H{|FJl7`*_yu>8zF9)m&2}^mXs6g
z1L6%^_$;|jpB<3LLEoGS`~G93^i?_Vn{@_VUzt=h1&i}p4K?x~vKfCWWxVof_`&TO
zp0K=g)ujRFK5rBMaKL)GDEf&pL0~(dUIF~4z*6iY*oetg={tt4^C@Re_mHdYb202S
z>$D7BnMGlQBJWi8H>*Tv!Gbr*&C&k^=i|5kt$gvDNTBpQFnF-h5;Xq07fY7^(P5If
z-PKK(KRvmMiXd~1uG38yOcrY&-ip`sux=_?H1(*%lXd=l8~FAg^wDlfyjLv48E2ON
z2|Q6%yXIzpGNLhfqqb8Gj)QP(F~{hompL#kwaYHDhxHC^20f?EzbIuM8~tLZ)zq<;
zqk#`$UNRK#(W3s{EfBA{T`@!X{ortIz;U}%L2Vyl5CrsW5(kVL)uG%Z9cv@dR1wAo
z(e2F{5oP?;BGJl1;n$Z{B8#B=Aw5WUby=E?(tNH+S~Nt>ow&w=^Vmd!yXtV}46n!v
zN!D8aYFX?fQc*e7nX@!maVR)YXm(EA4(dvwP=c-(E7FmSM7axZZrB$<_BU1HuSWl4
z;ku{$gbTb~gdLG&@dKBR-@gUj`Vmw<^1_%p2$!_|e6%4qp@u1VVxL3%p%bq{*77;e
zA_pIdNOQ`!yyH?oR}hA;rp3TBBH2m@z&up16L0invUDU4p>BKI#d(cs@-5vYWgGB6
zw#K~AdHy|VrjIQfyAJNS*xwg8ZD3*Qhe)PjP3e%M>if;#(#+rvACuk=`qoJNXw(@d
zpL5NpONY6EW*F^AP#n)Ca@?mv{5aosGviy!**D$t^U_ENTu)F>>Rig|_ydvEq&3M;
zTm-@QzolNjpVRCXQ2uCT7A6<Jrtt?||73N>-*PIFyR@RTR9_2|2I+&KdG0xmu)x2?
z(ZkA1dL=EKs((NJDEWm~81$W=lzq9a@3<~e0{DsC$oUKZLf{<DQS=+0<9JiQ8^?Fl
zNwK}f0#!KYWq}km49KeE8*ga(DUOxm&kKlVCgC`wUBW-|WZw5>qc+lIPZ>ZO>o9g$
zq4D$Zi8T<ZSW0gci)<V1SSGZi2nJ>{gnh&K<&65n$Qmd20Dxz+#?Y9DuVRd+C)TN<
zisiXK<r2xZ<sq4WW7z%VLiTA?^zy%ljl~$F@1DyC3T}?&4>0<4Ndiy)X?-b`-tF@o
zOW0lq%ZL)d&M^A9E@wJn^9vyCuYCSE*eMpQ+V}O}IvdP^masu*Wq#N4E61emtRBy(
z^-xe;hM-Wb4;`7{Nneq2t+hGvi5KHJB{;II(6wVhlY`*IH$a}<WN{NdG1%VD+1jNg
zvWWpkZ`<Kk@0{nh+rE6B%PGyU?{ejAsg^?=HB4u127g<<Fmln#N;y#pp*MW=XFbCE
z7)x@VADR40_k<n@+6BgsJ$Uob50JU`^Uu;&xDa*?(s`A1GdP9zKtk%hi%L(t*4P`|
z^gU+jo?#vaF~IpB$SM2U>;@~TsP@c<$UOCjc~?MSUM?4jy<3ozO8Q(Q5CON7W8OR;
z9N^}})Uqq1=#jf>2iLte2;q1575N^h(y>wkF!WiwU&+d?-CIk+8Hn`6(F<(V;Y6r7
z;;8tleccNnL-HlU;Xulz!~-b^zL)A32b95kEqLz;d5LBJ+14~Q|1rqE63`9R`m~Yc
zeXEqTul@M<&)-u($q4+Iv$i>Eu%K5&Sj=Kqfjw3@iZ}&o$k3&!3ILOzD(o&6CBwcP
z<F5sI>{aQUuj-che;>mT7d}U~_G@W$IznDw;JcdCb;;TQ|0&^1(Xk{0I)bk{5yAr*
z!`mDT@P{aI7-oIRkh8+h=}{~=F0(f*pbz`FWH!n~Z?Bt>AWY+yyYB;LbX`E3L59>D
znZsshP<8E~lImV}&0|OjEfUH6nimsLLE8N&l5oy=xo91?zr#|2!;Jg%!H<8v58U@b
zr2iK8KguKCWdrqo==fAxG+)@clYkFPRs`?u(Z*A?vI+pf6Z;1jvES$Z!_O<`E=SD)
zv_4uXV1ZZVj>G}a8<1<LYyEW_X!5#NSl>&!jQ()r(961QAda^Dz`agDlP#ZHH&|Fp
z@lejms~1nPKy&0{EwVk6OaryHJJqLi?whUd^DCK%=hGYR+)5mi-sUdIeW-cta7i-X
zuxtx3Z2w{E4f)E{t&~YDec>>&BI06HCvYXtxsbqgH8~i$cq-8e?}`u4<p<aKtvoB0
z9fRf|fmsH#fk0&*qfn8vEtr0`MKT6#lcDTjMO~?)OWlivRnfH>5gnqg2w4#d%}8-+
zpeFD1FXFsmWi1wEmUP)nkiS8<iJUuQ;(}N!=}hiae#S?q(khWm-SKHtWWtv{KIW2?
zkY+OW2-bY8_-bzc{Q^Ym)z9qWvv|yKK}OQ!`<UxI!aYswfgxG}`q#z=^G1@fbK)&f
zhRMAzRCZJDIH!GhcoSOjMxwZ~Yx`5ub8TqVMb!5~-&Fo*p!z|Y|MbH2SKOaT^2Fg#
zh&t*YyGckZT+(xzk?LXo$ldz)F<%262W-jk$I>S6Z04yb+T$C-4Koa6>Y`${c;V@-
zP~%1atM7*M-~H+UAPx{4&Z<;!8zIgGg#L3JpgtTMsN9i5ZRAgqvmr{0K6%v7KGC~j
zolBKjZ-QN;o|RWlw__Pr^B`mch5<}M@Pu6~@t=WjZHi|hmDWO`f?$c6ifc1q9LEeE
z^Hl1dU4i78jvd<!N!t~(XxMDT7>|DGge5n6u=wHaEXUHaIub0%(pda}{l>|-XW2SG
zh3RLNWVo~xtKYfYEd49nw*N(<-+B!R$IlVjEObb7(B|)P&v_9yc`gs-t3l6aM{NnV
zIsW>OhgGj%9?y2)o=}RTXSNG8OD-AOoSTw?hllw5D{|*E-Wfz#F%4VSs6&5XHfCG4
zPvNOo0emqX(}axicGQ-QYfiE$TO)~{hfI0>g<5{mcYIe4tE`5S8@Z~tmu%Z8Z$px?
zLL{x<WjqRZP2wMbFkuPa;2JqX1U_Yc#O~ZwNo0@n7XO!ZwBZU~x=8<lE0~oYy^Igw
zJz{t{=H&KYE_?gp7`hV2LT1ZoQ=+@sdv{}2i&^E%6R$|BpN4SY<Gnoji*E3f7nY&N
zm%-z@w%0s#wx;$0qZG8l3@Qz9H4Q(zFxX04uhJirX5Q_y5H=NvE!_Zta;uTeS>a`%
z{^CW5t5<LZ=!8>~c0MDz>h3j*T1ap;nOp08V$e^l{Hm-l^t9XL>tm5$Q2n-=k#3Ww
zIuuVm{R3Akmqh&TDh8DP=&~vvhZ^~Q5SdI}aI)o-ipkalF=ITr?`?rY@|4%kNiRV0
zXas<FNA9Vf@o&RbU%95nUO+i+ee8Ix0WZOsW$V{%G_^net%|=2%ds^}yck-C#4mN8
z$p@1qYEvrwB#PCwS#JhOTLmR1uk(?dzjL~eEu00-d+=4NpIl?P7w|3wvl2~s@Zb&}
zx<<&-RrsFr_-)q8lI5>GaQsL)e6ifzNcQpC1z_+Hhyw{7@#o`X=4fkRtRe0-_m<af
zM7gLJPsLjiJ7i9u1c-i=zwx=e(Gf6N<B?gRjoQ;_k#-s7DEK*d6hxfSXYh8qaQ&Fd
zF(IW_caA-f(_GXMMMJC7fuWzK(PA>y`dbDwcD$bs*`9h5!jy(&m}Hbe^i{+Ahms?X
zn;c~89XMhW_mnO868d$z6RH+c<RHQO#O7qzJVYlm!br~ewt(E*ymX&`i2-8*a`{E~
z4!AOrgT^#CuVD?wk3DCAh_q_Ld7jd@sU8hzg>Aj-Z3f#9aNuJY(uZ`d_LnO85f2V@
z)-j`7tkC16ncKr!6i>7+T3fK96fScl_NEuH&5NKVL2~}n4^{m1TVwflO^ibTcXXNn
zUNJYur1KzbY-zk8CC@-W|BGXNMvh5Kpvj4aOoA$N-EzTT=~jnoU9}f&J-buVVA(i8
z)9$wROJ|dQF4g1j!D@_8W+MLHalB=3mIfg8Q1k-X(dkyA$V+~2lM$|qPUd&_aXbu{
zlj(Z&V;@R%SRt=9*O~>@hoLu|9tE8!<Ga}}>|c0?$uX^2eo0k<QGh;^!Buf(7CYqh
zH8<z$>%?hJplE0swMd|D)go*4f{@ecrQrvryU4=27x>5@{2DG(Q>08~+x7G=r_A+$
zF@c@Mh1St{yR(R%c&OMDC|i@77)yu*zI6daBxC;7QZj~;MY=J^En=30Q8^R3wY?oP
zRV}W(;5-QeafrzaXC*-V%9EJ913dO;WArdF{y3M-xSHv|Om348Ilr+JW#s`x9=Kgy
z{5{M<f`@Mog}Tm0iGTqka3X>sFy=FdR4_olXCA$}_a&Hir+r1kkDxv>fFWm-`|vV9
zGW99Ko)>jNst4`QyE}l+$GJ`!DQCUrwPliq6vk5KUuF;Ws2bn=c=}xojrVdWH^`B$
zIxgB%Xg^MF*gS82Y0yA5d)>=I(ywFozh;zXD{oT&Qo+YUQfYwq{GY9`?H7loI@_*M
zVEGbm3ioQmH1F`L*uL~LleV>)dmGx!%iVM5uHd?tR(+?I!^0@P#~B&=Ih<?<B2w^c
zdNj+(fF%sUN5Mb6o)hKQ9h{_3iRffd$F2!>YHAy&T(h}}^M9TVh9J2h<H=94sUW4(
z!Ct4uM`sjM9N@>cUM^*EIvn`yUb8R~9<NhysPhFMXkYPB0#ohQ`G$>egA&CQEO25x
z2SgxeBDT!_(y0MH5>k1Cz^x2oMb`4NhO))0GL6XcKC5Sa8j3PHm#MynoF61KPK&%K
zG4DfWq;@@czcfJNPwTi&O~K0K=a7FT3adR?Yh8E{VH$AqBB7_40G6KiG=i2X(^pH#
zWP+{5-bjFbW=E}*Ex@D-4UnkOZZmzE;}NzMze%7XT-p)GVMfRcYTayD7D94|ETVGv
zUh<gAXRFC4BHy&>iz?T%u<qP0?f{U<KCfLg%Tn1d;cwdFmb&;g(W7|@^a_HdfnYlP
zf2Dz7krr5nbHVPvvJ1Sf)R2L7BO3r?<=a3;I2iOS&ii3tJ?N2<D|*=b#O;)WT;WGF
zxzP<jIB1HYD?*f(ln2sqZ40z0)8+QX+Ua9?^fU22*zBO*Yki9w%gocCqYt(t;pFqW
z_q5Py`h18gAp=JlKA$%WeMA8m!beq763*NYPdb_)*By#zGcki4?Qu{t>DE58Pinp1
z#<#LdTKS?;X7vU)V;@8!w@v98&PBK3Ly?`Td1-&lwNZghCl~V!NE1S8n8s6jSWje0
zYH2;HFI;bWmRmzYdi>at%-8P?tCc#G0Qs*mOA<F~D(`(%8@SAUf;HbyH+U~k@Ul8j
z%$uA@{@}PqtpckFD5ZNTZgyH0v(!BMZ5aZrM2G=tv6GWXmM3y?EyXXzteL|a(|)%0
zK6W<}K;Phk>0uXX2*`>u=Rk>hfL`h^t7f9-4XECgfWgVb14IZ$t6Y}wi&b6KVon@{
zDDg#<dRIm8e`~;CcHUZmHW<(@!vFt9104JR4a@A(0z%+15`Rfm1QZh33)Iwz9onJp
zISC*$yWe^Kkgo_B3YjS(!tNu6hoEMw4!0D5trW15!B+a#%|Lz5aBl8qb&kVn$mJ9n
zG@t)w-Mv!*{UJ?^*)}DeX19<bX=~;>M<nhogHyr&sJ<s^xQBmVF@)Rg0C$JbWKOfj
z+vRfZIkzhtlb7%IS(loIjqLP#maK?<eW?pT4FSys<H$T0xmSY%^v8FUxpcDXokaAs
zy|GTwBo#=Rd>7Z${wer%%)5@9Bu-^M2a2Md)iutCzg|>i)d-Hw9C>r00?6V}%G8z0
zQoX}v3ZHSsi3uDZd|@|8d0$|43>IL3lG0JS^>~dLiR0`t9!JwCN`8LJeEU32R=P!Y
zJ_OEn5%nJ@;mzm$wy@J5#C|lS8C|J$)$388SKIwToX(Uuc2_}t>)&%pprTG!jaf`!
zRP+KDG(cwj1Trz*0_>#PD@kpL@0d&m={yDRN|4``zwK!@+O;qk@E~CK=T9=gBnr|8
z{uRClc){2k^B5ILK+b?yw*hIsizI&~f2@A?PJHP$RX}9h`Yns)0gH(c9e-o7*_y>~
zanjj%I-(ZN-qlAtoIaQ#%CfkYcohfT4Xa(wUE5t`+EXI8p6E?(?df!k7=k?<7QR)!
zpLbKO8M8}9|G#)86<qQ64h`VPlRP5)24M3PhWntpmY{+oQ8>-pq&v|<Bk4<ABq6OY
z&|5+`?UQgirn5!?7;n74#O=9tzI=%i4*##Dlf3oN15flJ2uKmHroPebnU%0sR`hY%
zq^l8JB8THd+IOyULt|oBV?hvm;c*BL6rOP;<9M&_qgZ|DvWv{;3~hzUe7-eKb!qv^
ziZhaL+mc;#J2|sHE+pJJ%Wu#HRj7-Ae<3%Zgz)FzFxM@}OpfQFwY)>=Nk0$gm}&IK
zNPnY9xCH0<h;=%BxSk{v%xu&@U(sjo0udjSa4IhRZH<JzNmvT7pBa}qHIXm3ZXP9~
zbe3cOx%p1sX_2k<eOiYUWD1U~RYwLb-_=mp{5^-yw2Rg254H|q+-BZ6@s(-gl7{@v
zC>?dPHGO<mQ2IK_!6CQlh$q;h5_+f%cbx=yU+5sm-HvP41&=X2{t|5rH1D%E2N+4A
zhzbHKKxML2P!cx8R3vi4ua?AnUxv~|D#~pHE<Z@;7WNPfZf;Z7N9x5~b3jr%6a>5H
zb$iz5S`zgRX#s)`rT@tC#}5_@bZZuBd1WpqgZLQGVBc5oMD3^V<Hhs?z<*oqHqcKM
zd&{DTduhcuPNYswV8~;T;>XJXu$*E#Y0;0u`+<<5!T~CC2E5Is?m1pTOgIPC6;LOz
z52n@~+Bp+VUb2xsbar;gXBYq;1LSm;{9)ytP@Z2;s467Oa?QMWKS#n>r^~`WJ5^sG
zhX2NGG7Z0eeIJU=7s1&-$CX;=8g6ndJ+jWd014IoXmGY8txwWx%(qD5ms<RQa{R#m
z&IH?AiQtj-e+L9w6KFuQ{*2%Q9Z&|psGd{rWY{V^#wJQ`zUInx5&D(mFs&4O4wN=T
zc%^4}LMNH(yjcAe_y9cM%T!nJ?;M3lkrK@GN@8zTf=yfS+(^UPpTfCXD4hA(<&9f0
z%@dD&iz0Kf_y4>ca&jRDn)KrW?&3#87{TJu)KpLaRhm8}0BM&A_?x74>GbE%zrT?C
zxNLk%0_*n$KiN$(+7#?VFVjztPnMQonlJ0Pc?t=07AHMW6Kz|nZdl_V9JS+8;(fVs
z<g5(vu!_co;7sr9+3NYFQjUJ0aY_F0X%0zm*=b4H(%v<Gok6VTa>L4%+dw)_fFo86
z2bFkBX&2=>YUADflSg37@dV!&v4!0uWw2K>fnHCN8ZM2XtLk~ru)ecF$6LU)78!H4
z4<GRFitX545mStXq2QZqDJb82Xa3X_H^yz#V3*$WM@W5=U}Y)w4LNT$rG&yq^3@Y|
zdOsCxxYCR{Ag4O<qK73)|Cs#~jwZl3NUd7I7etI*fvJ|5nU2Dz1B~qskAtcgZd%}Z
zM~_DQZ*+!|k(WH3N8-tjfenK;48gokEk{STXBajs8nehi@emk`)Gc4Cb;I`~Xxm3W
znFr&}0=w2g{srej9tVlRmJ*iVVb8#q97DcL-lVrQ{`xQ_9%kIocVu$30J8GEDM#^;
zxx5_zugeB$x?JeIhez53e%zwzJ5j;R)IP|j`TGIZNkE2z#D{=$b#Ib?vT*-@EnQ%T
z3D0%lF%=*=7FYkqj#=b!TJ-v}W(NeY5?nAS7evP-JNkuN3dG<=q>yP>kc&3|Dx&t%
z)o@Fwi=<qk6JPp#XB&rFkD5A^c{7wQ()Iii3^VjB{b6q$XV_q%trMi2pP;2F7VZx@
zdEY=v*X5zyF{!?@$JIvz<PTp?SvSbci0Qbcu$j@j$&7{}itKK>?tdV5O5_%n?{7*M
zD(lkqBUk5}Q#>u-wIc^$jN2Ep9L7I&^4X`)&u~iPz8VW#)6~cKUPh8sWUBs5gV$F9
z>3{Yn{5dZq{yH3A^Jj%<StE@?84xIXTuDnqjw|pfF)Czqzf6$Yw58lu*8QLUmS&i+
z;Y0!SQ)M?JE+<|9FsTcpFa_25X8HO^^G!lKeLINOK)$aZaN!b8IUZ}#Vq<u+fsTI)
z$-l>^b0L&n*#uSLD*u~em$k16ET_kc)XLcZ<+2j*t5ywb2<Y*<nBzcB!2dTDvc6%S
z@_?D5<98lcQkV3Pf>0n|#^S^xqrn63L~G>vJ7eAYiMWcvEa{?_V(kCMTH}TgddTB8
zLiRN1^%!Tbdog1(ysfHEHyVxnBraa|Vv_!qra*bW8gRm*?i#+>*$;UW=PjIgEx`XR
zZHM#d!qL`kR30&u)S~*#%sVD=HQt*KA_jGNGRZ}u(27TI)x|EUzS-2QO4`~cS~roT
z751(d+nY(?x&pcnChZwR2CsvGL5bx{f_0)?%UiEAPNp8IHXb#zaa>s9u(LuP4}i<5
zk?}UVZ4myY{%7_m;0^Tq-71+}0g76%)06@ITfr?Urjhlo$X%PF`~$}b_FP1$;cFyp
z#?LRGNASj1j!-|g|0kuM)3vV-<f*D$nNiG3#D{!s1YH&<orcbt-#Z%sw<c}Oc@51+
z8SYf@pgNxvW9Pd&u53mQ7^I0#J?o5H)*X^H<9stL+uN}I{a+$jcdu`9PD;}c&Qm4K
zfp4RsoANdlhHPL7_|zNX9CHZBj?KK1xXqKs!?QBWc+S8plZF3$qJi8PiI^g1_2b5~
zrnK&7xpLDE^zX##yPv_^yeL7V)QheQ%9D|MFP)~2SU_`<Zgq$K?8%sWk`S|u=J;Mj
z>!dW;e6SuMnsHiOK%%+!J-l+iM^U!O5=uSzrL=5*m3LsMTmE>_6#h?tBQy_|lcrI-
z(<Dmmd3!iOthfy<wk02q0<V35Slh1rP(hn*bn+e`E+fFKE%&%WT_qhkNkz$HC_4mI
z0fFaEhidT`#7DoOp|(FCz%GXgeoXHp8=6TBt4tlV4q@IEEsPD_-k^`0e9sLjgRu{N
zzphN|(~(s!ZLYp%G}Bl}i`PBxRLNm<HBfI#^scJ+X=<vkhs*~y%wGuditlCI;ZEA8
zx~Ibi@j_PRl{lJYq_pT+`Mul}7-^(~`Ey-8SufCmuvf(;;S%*3fLYQz(-pQ?ZeAN}
zPWhLtA68_KM}yf1_P3~B<M%>l6S;B$0r=bx+yWfS9>(w89td7M(ix?H_aj}XBn*{B
zgV={4uZ4snLr}mVzb|A+eFY{$3=x2Fq=--vobd+1Fdx`&(vf7SqV8|VIh{`@mCt@U
zZk}lIM?RnYPZL=p&ZWaYY$JT?<=ol34zS>Khrk8#)aU%cw55-^mmX<1`YKC58+Xzk
z(9FCm>HRzOxuaCN(sNOsG@UbhGwp$ibISKeL)!K}bj6ovWM#r}m5okKJ;;wvqaM3y
z9GZTY4y`{jG5n0i`&|n4{~&FnD$Mt;acDMG6^yaN1M1xEUmpT6d;gowb3RFxIGV)d
z!okzcb1-18)FCcx?rc{kr#)jv+gI@ma56YAOU{q|WvnTV0Z8HNxgDz;Q;t9yh+7!o
zO0@U8Cn34a>YF>fz!3p1)lXexOixQQCYkMCp}{y%!d_$bX`~YVOp{!GTR+CTqR`Qw
zW?Dy1HRO(kWjVZ>U0cETrVMz94N!ZO#om560Y<Z&iw4ibRhO>kvAUCIA1y^=C@y8`
zrj61yO3;7dI&bb;{dQV8k|y-U%03W_@pe!`{BB-Sl@NQ&d4wj{^WHUDy73#5LCzBm
zAF^ogC-b^j7#c98I)Bs5A84R3lY=P@S>$q$-4r{TB?Qek6dNPcj6Sk(BnC}A;__|t
zN}31{?D4BFwONxI$+6GAyM9eWey;&DV50(W?W6quZjn^4d`U73uE_D#ewE+_sJEhB
z>|nbVlD5~2V$MSYPQIDXjU#UROlrk#hFlCgyZSytvjy1Imi=~XlRN@Bo><z{v>Oyh
z`}?hczoFy1icGFJG)qDGovGgLSAN#<h;QXwK1#v2c-+HUtH(`U!Qpt#ec{w5(r>V<
zQgL&H8{PMy<K{8HThOW0{uYOl;ViV&<<uF|r@a9ilLrN9BGg7*u6!=h%Au10kZwv^
zXsIpuh2vk2HD`yi#Q^}v6Vdk7m60I~aSM2?QmVui6!I>JMB8L>*&L-#7O08thrr;-
zK~QkkndEi)vJJ=Z!&zFHSGwNS5S#f8%^#--g9r45hqG4Fz^NWnk?CbCoOJHI1+BN3
zRH14MdziZ4!;PbE&_9N@bOCoT)=CkUidOik$om)e*+c1U*q{<DlDDVA>G<M))N!F@
zS|CC;>LvQjQT&`o0$e{NaLj--@t{19>#5F%*IQ{<N<9pHE93<t4k#U*)0|bt8pNkK
zi);$cw~KcDOFvc3()|Gd-Aw9G0VI^+Be9zb(BLs#>79b=8|lx!c<Dap=(+<(RIjCQ
z1<vGH&)qq!<iFZgKPvn(s9cy)$~b)2a%!Tubjgn|0E+^wagt!tVqfN|G5%{>qWAbZ
z@`Sew_zmza2RBt=V$`9S2n~OE*rGI7=3tTX+6f8k!8~y%yI27DK_iP*`2=;DlIOxQ
z<6>zg?y-QP3|3*bB9ATltx7>AkiJta^RVjiezTbbW8d?H#Qdm5x*<}0!ow(Wc0MQK
z<*F?rRHm#@NRk$dtk2_LQp-4T-h2R8z0ZIh_Y{Gy|KZ@^I?JOb+VS7z()K)DWvQc|
z;$677y3#01S60mW9B^RDVo|Y;J83I6r-_?N_H-K-LOe0eIjaBjlQI?kqAf!9ZRg$C
zU%YoKZPP_N&WHWth`5~Hh++&WLvp#bC~vJ%=6E@dJpYPo%c;jUHPOMhN`gBh_%)C2
zC&=4&Oyrtb<O#SPqe}ksT5y9-CdzSKesohO0ne8s7}~>k@kZeTb0NulfVG`ep6~y{
zKHyx3C&_VeC9GI()uRANFyEB4Ta$rFB1Dv*2GjSlQ>tvF%29LmA#rzq^1L<u#?r|I
zc3Duqve&XVXpjx*iB>dVItMvNlq%F7*$!+QavM4Rx!Pcd&+$^wTU^T2%hRHQPP=`^
zBnXa{pKwF-c8;uz%0V38Q}0homZ#l$#1y%6<vfKlW3VEb4rM!~KEEt|0%ti3w9jOg
z4vu|$()oI}3QX`;TLXT;ybwv*Arj(#+9T!lNj@@%XruGLv;`Im{w=ho9w#-I%HTvV
zI_6as$sM|+JGuE{R56srqlAyV<f&0@Myc0L%H%Xi*NtnFLU>my6+k7w`|8qCvfT-1
z@&H^SuWZHB>nolfH3u!t_qDaxDBlg3;g;pL73v=}lH&_9?*28Ob;?K1l2=<L>$Ga7
zVi6Lo7lKHRd$b)50_$O@*6YSHxN463mU9mT+{+Msn-E^ptO3rg1^{x81N!XxT;}*3
z0#Pr+(I|kJ&fBjh>&5>$qQW6#LwQ8)=OfP2qj#;Fuz7f|0WT<x6PnZ`R$erOyK*c@
zF$ShfyK_*R2R}5Gd4Ee4k`F3+B%2#fFbz0drYH5V%)i|ms<v3i<@FAw;<+e&!^+>T
zSucN_vtnCo_az1slsx%-wM=uv^75!rAG)U;XCG9!T_Qc69{wDy5tiBh#WFGY^VlF#
zQUj(aV-a(4BtP8wI=w=q{UBq2?V>YMbgabPA-aFQ^<|6xp$Q~bOar-KsVZ^%7-CLs
zg&F+gpC|xUAR$w{G?%Pv8BGP`$v)MH*ugdR<fv93Un^?AU_--~81?nVH^Y-gB8pM}
zwAOO-D+E5B@y$IAsZI-0y6nXJ!hi)|KP|CVDtKS=NAkyt_5Wm#bN=t<g*M_n;kw3U
zA0H^7sETqz7LmprIo9bW5&CZ~dq#4Bwd0FANE&sPH-An&MCp$(@SEf-U%m?3ih#(M
zA4Cxr{yv>);pukohqUFo5RhP6YGDe8(dX#EL&pgg3Se(n-W=3C%?N%|IDJy*I|L3f
z^nCV+#3NqKgC5C{KW<ClGGF~jt$(ErF)jx<qVCCM7d#Y3kb|cn4G6>=hiugtGj3hC
z-=gULhL;0o5{66Cvek{E+5maTCQHvv;?zLWtOa0r;o1F3bq@`2V)?(*meBP%`R!%{
z8hWD9K5r#P^!*meZ^Dmc2Y4U8Zk?;oIcJlYUw4$S9N!{4k0zg*9N!Pw*px$ae5|b<
zcK_EcaC5|fH9gr4Dg-(1A2v-foJcC%%|Tnc4&xS^Zw>miRScZ_{k`58?MPNlVaAkk
z*<8!xIRi|yyN@S~uYW_!xymSUR31#%=UapZLgbr0GS?d8?rL|O5_1#mJB;R-x|X4F
zMr_IK%ombSO-`7l!oCCIBr}VMY)+>KB9DYG#6S$cNFC7sq-tiFjD}XKR8;h%1pHxN
z%KROdvh;GmWNwlvzBLO16_L<`E=55^!^rm_QkB*KJs=yx?_HbM9bYN6g!(S}!e1za
zOY|l0<={FV#H=>=^eO}f*_UWO0|(6+O7@n|;6{_cUlQj84ENpN*x{&fCI$Pt>k(zi
z8J|g`z%wd29HYD+o^ARkbZ%(iROHmulBLkq?5Gwdn9Q7K52&ikb_hQoiHbO%^qeK3
z#W!~zexQ0mH%CFX*DOaoO&)jJHqKJ4_VHhN+V{%y$L8amRCyA-eC|hG$75ED1vGAU
zH{5H56M7G&h*C@J&!1LPkXL<|wH)7O)(lMuNmQEOJn!hoIF@F3`@SsSJ1uKyuXEiw
zbdn_?Xn;6+Kt60(bNPxS-Lyzb$VvexY$BrbJpIN&28$!E)Z~RMmx@4n-h89=EGWd|
z4418@NjQjc=PE8Yfag9z(#pcsgMU@#VUuVA_lx*yS+9_<rkd!==Sz0y@Y3FEui=v!
zb=J`+M6>AMo6$45;yhO957OsLmzROfZb0Ax&(C>KL}WUg(uw!JY7=+p9g+Gpx-b}v
ziQFNZO(lm_1~r4B7&%(jq40A`7P7_aiC$y*WV578-=&%3DF&^(!=gc)pZBvS7Ktfp
zmyFD$rIO~AhNv9;ebmti?)KoXldOhTc(T?W%5i|I?IgOShv}b~sA9Pk5;3{6HF>vq
z(}qOvV3A;cYf*8hpIJ&^Xc!Nr=d24Uy8(*d?oLMW+-kb}NJsm+-w3s8ku8Qsru{sd
zaqWweS~3$m6SNe7SPnPk;Ym4~pD{tI_%n2P<dYXf^G_pv0a2{51y7bLru}8ueiqD#
zQMj{U^QS{Sp!?5QrL<t%+MV*q)q24;>&wN|zaRG3@V^*J4(xe#=)GFDkEysPiUUNh
zDe$}veELga|85WPl*&4QK7+-esIA0QLsU0_L%8@KIN0}um$Y6Ll44y|o@@KDCcbki
zyG?u-zCtwd6}GDy)l+smTvS!$dP4hay^wX@51r^oXIg16xj|1ijf0+N_%p2;*rx~g
z?&HMUA0Zxh-S*|CC1J;og(z0_u_9r^0)WJ0?|iV|jq8$|X#V4XeGP%ea$iUpV_aW=
zPX;$g8v!OcevuT%+}QDBT<_uURniKnN8RxZoHUvj+A06!B}A<4u?pvicOIN~wQ_u|
zuqHUF$5P+c5F+xVWxNBQ^-X#@6`c@#gUMuB)=>vtZuIyzZ{VVRs$n~jXrE5bzdE8K
z4L8Q^3|BaNwMR9+I;+4ZuGob}c`~#7{rM9I*=-m_<|U;_qNq#i58}$$?VbTw!Vc!A
z%6W>%!Mgr$fP@gf{=GzgovTJ2TXaz2HI7rthboWDZe!$9MFuVs=xPLN<>){Bkb!iH
z2Y(ylhMCqNFQU27Mh>JwU=iVqOI<6@*2cL*9tUhlSzTBW{{ZEY2wt=M*4->MIKg*a
z|H>D}v$qw`ve7?B|Km~*h~ORvByxIt_77P~Rf8D%*}`RFiZfW(5_;E@)Wt8(Z)}X=
z@9V_OGB~0Hbw%ESuWY-aMhPHJOH!Hm*%OTF!;MrUZ-*uTprP5zuu@4RaV^E%1=gxm
zR@0h2vbIaL=0@eooAQmG#2-f%@MTD{T)w`412Ms!-v8e4@QdFhVzro&c3y<nO7QeA
zayLX(N37-?_Ah8o+el`aGz)yHkQFYSW}D(4)?U$*|Lxj)s(hY#p-k++xE3q<g}VGM
z?Jwl&sb$rME&70WCeiXuH<siNRi>SfcrFgFHd1keR|j*+9hV94v<y&gRNppTkhheH
zZrZBJ>6&RmgrS%jSN1Rc37FfphWIL-hzDeI91Zp&w5F37;<vgax=OTT>cn)TqUb?J
zKbXp>sAaUd^wGA4_ORyEx=Ch!Z*&hKoPwc{&>nnq$_gUtXXMmL(3+igfXMX9-2S(U
zA#%zjvZN<!Wl?_;$1z9#VaeKp5yt7J`#eJw>|M6a+F-6%72O>If${>&!QywQ>b%A>
zz$&pC%ccKXSwu!IPb!I6lrgpMg6a*Il`f*rPNm`irPs8hi1vr2san0?M>{d?lUYK*
z3$gBag?YBfo5|P4Mpw#>jRXZgeN>d<RN60yOkRraU;Ug9Hf`k13Q@j+u?j|ftW*_c
zGj5TPnCF??Pd;&woNj^F)bh_#x`k4su&t4cj8~aO3!lOD=G&5To$k)stcc)ZLTTS6
zW)hXo*}t+(YJJ`{p0@bpo_U71vH8;?S&&1&L|L!#oovEyQsU)6k@B_iX)B&Uvmd)u
z3=uy8mUn1~fVCKTMBa-8YEuPf+cfbsOIIVYUZT^^@zQ(T4Nw9w5agLxmDP%#MWlR2
z(uJ(BdZxmtJ_q-OXhk^I<ne>T8?~UVxSx8F7@N|KY!9b?!~DV!F6T#M>x!K!S!X6G
zjDhnMH+M$W`&cQ=a7OF}&xU{itE(V+`-b<hS@9CsLA|W+HORxfH4?mjs(_`sjLTV`
zH_nq?%#-b6xjnEKoJ)UYu>nZ%Ug(n!_4d;LTcJlj{VbMQj1R99^a--pq9jfUeG0Na
z@Y?+(@(2;U6kk4)SbI3e_Q{5o){W-?#OY)6pE-***Z!52ezxw;;;-7B0nod{NO3n$
z*n5gjZVw*|_N$7y_4i4Gqnxvz$qA9$H4x0KOs#gFVraR<(9T17MF2we3>x!4;ovz{
z{Ne*P_D9Fg$^grqZh;}JEa`!!3Jc7DoLB)^c#yWwT4aPdHQ^zl>J~j_f38smFZhLs
zoM%Tv&i}*~jwW(n`LZwOvDE^U>NOF*Yk_Q!&{)0>mBbZbhZ4V!!y<j25CwhwgWS3`
z2N^Jh=e=8Wjh%KQS&QC^g#oH<o*R-*fGmH!)w~r)?GgDU)xk)qBIY-N!Uk|2>P?I+
z?qDa9Sq;SLETTWppTf^+M!W-W65|+)Yu(>91E%P2L)?!1ES?x^idBD_+Q3#-7z{iF
z^5Pk^Gu>b}%#z3i;d+!6d%$9NdK`3}05R_U9o>3r3_22pyhxzgY2d9;*0LgnA_Z?*
zA$uP(Qs#b}8)hjp&?=4G3)O>fXBubgaEs6SkXebMJ-jbAu-&{CdO#M%FX;MJ{E(!J
zvlr*jBA>o9Ujx-5JGQzzSl2jf_jwEds7xkWvFLJpjgynp9%9IobWsMhA@CV3o6%2<
zmD510ru~WDE$xpsTxMIy)Ce@|b(#i3G1fnWtiGF~WzOxYQAS0q53giaZS&t@X*R2Z
zgd{+>peNQ=^*zWOtkr3cWZB&ZTR4~WPp5zl^enJ#cBp|Gmv`dAPw@8;VVH_sKwj5~
zd&fe$bjr(EEK>J7X_bSEOn}X~MSrQOFbld7AGegZoRkkS3Xp*LxgL47+Lr#v_uWeV
z(XyICochD(Oj`CXb<rHfOGFZfz|SlwcCw4vd8;^yVS(K)1WIoQ2!)Y%h_1Vy7G-SY
zSBROTpn`h4QMJ@;_|o&e4*qRsXg^Vu!6|dt6otW(E!HwAHg__OynhdDm;h`FRRWBB
zcN3?TX`B0Os>zeq1hLo__(E9ID$V(6BAp;Y>ywc?U`<xwp9SCf&OjuQLivqa9bg|#
zX*)WN>^q;6_2&rhaK`l}iPpq7Q;4Tm`<ZG(mOq2+4c7lsQ3&%Nd_&OT?TTK%L1#g|
zZTkFBQv1&8qQy!-F+W>)4`gR0m#D2O(H==C+1yIJGD$1dHM=r7K;)@@HJ_#m&N}dq
z3Xb8}30RQpV@Q%!^RJ&X1oDP@^5uwve{@R%wA9C&P5`wuP=4n=phtP%ku~-=$_}%R
zn!MeO>L)xsg!kQDjH5h5B43I1g&^9vgFf#+k}w^6wR^d*({YjV6JBy)p>NJPJKoQe
z2bpZCH`s0%jIZ6PDBsC)SbEj~w&!{s#joN9RK@1n&gK#2$&W#80|S%?fC(d#`;%+>
zr9)9aZB1h>Hi&s-Q%JydECv8{oc=X|q9{wJ;KeZ%Y77};Kzfpj8HftUl8+E}n2!kz
zP}c%39gG3je&Qi&-q|g`B%%n$JTHw)=zwF$%KNsCWm948%J*Qw4EbBdLdqrP4XeXO
z_hg5M`@{E)g;a36D&JW$7?SHRAgC%{!4IU#h&8E*CpGsuq<raIH8+%Y#wRvSBGXiP
z<NQ*b(yVp}RBX{AWf!cTF~!z0+VwC4^usJCS_|*>P*E1aH+qvTITp)~)-(N`g4nIM
zE5Paj<UWCWZnBe(+XqlqSE>7j<(#zeffo0X8vEI2Bo-MOYK%={Y#`EkzG1P+Y%ny1
zrLEC^k!o%Ca!LOu#YG<H_!~#$L$QmZA69OnHVMpnFFDH2PX8|q)x1PKP~2F_vcXp^
zSg_}-r^AcCuHUfVof$|xPppt4W?-j(q5gB9f6<BAlA<ip=JYSmjmUhsSZhIAF}<eI
z$WSIa`hfn7Usht+)z@*zKQQ$d+@fGLLKKA$<fGSNn2)JQ6mK+GflyJ0Y!{<Y{#hy0
zh4Y3z`S(Kk;Ni@rXpEpbLcVk<nVLLGvSFub;QuUAvoA>282rN$wrG|(2qY6~Tc@nl
zT#pfJi+TaNtuAm3<Efyz%QK(tCV4V+$?5n_U@h{h?Z!oexxZwouM6EndM{WuKu;2~
zl7Y-QdAMAK0u&IaNLu#dA|n|9*cx#Tm&E!!^9Scgf9?skQaqkoPo|F0&x3VC_{~kf
zc>fqYb(JQ`o=sB$H`8qfMeG^~Y6p#8EKj^MF~%*`JaMzsZ9@Yk-*>Pi?~FWRY}MtH
zUvFI(P?5a%-eRbwpaZPW1CGIE&gLz_v!W=}RN_(;BbBA`k^%P20zh^a2#V=x1@lXc
z=~R|inP4d2Y(F!vG?qN1@LLvV$a6MF96o#Eh4J|jEPJo6%F=lY8SmhSRAxDAi0pOQ
zsi=TGB~%cxYoSPMf!L;<9s0keAB;s-ci+*8G(=rFHSv~U_oZJA(S`ji=;H3cl*2WO
zoV@>!uK4X$8f~$HSOuQ&@oaOr5q;OKI^k_xQ0n^Cc8-0Q-t|jm4#|TpM+nTr;vFC#
zvkI5-20u*r2mkSH^2#YJ=ez}FUIK&2Lwm{dO9=S$#9;!tbY@9h%*c1YFI@0BTM=gy
z3RbHGXgiBYq_n-BYAc8GPNiw?@!c-`(y!u_|JpD)lM0rmg!eDKydyyusRKoJ)MPrM
z5quJ5q&O(|gEiqI$ykxnB~wiQ+I|z$K-nEKKY_xA%J>ap*743!<U<skUjH-pdhlwB
z<zija0<cP98)16d?6bH(KkRASd;fQRP=Jh*aK|YC{94rPYEMkkc=mF;$UVJMwxOKk
zLtt^RZ;nD<r3sq`?|x|vWmauu+3uAR(2<ya;;0|!f21PmreNuId}7BC64}4?J<(1K
zLrtNGJ(|2wg^U?cxnmG`b>F@r?gLdVb*aGIH#h~C_1j3|ud;oq!-M}r)LVx&8Mgn!
z+vslTP6a6`r9(hL5d%<=PH8~~5*s)=Eke>RBt!)qFk*m8si1(cU<jzd#z5F$WB2d&
zdA`s4@(0Hb{uuXt#d)3Ad46JMAm6W`hk>a;-=Q}lmgZk#uv$$BUVnDUKl6IPf6NS<
z713xi7|Je#d|eFI7gX{GgA-f?6n5<LlSHFeKDZ&6GPphS?BfRFOQ@6666~c(g~87s
z9#yN8e<ss;tdiSHm8WXW&r^(AjT;&C-))y6FWjAG7i7T!vBa@iU?cm3Z&lpOrH|nE
z&#Nw(#N?C*^`v?JNBE4TN<U2oqxA^5{Ly3zIPT!`S_%Ojm*8Z^e3m$OQ(BWor)h_W
zDwd~6?0IQtAc*boC8HLf#ml<$Dhk`V<tij2OA{8+odE#P@R9bF5jlr2c+$K^z}_(L
zLj&l}HJ0*D>=r>(^Yz(#&*G<7WG`L3!xD>oplRZiyS+=xJ4-1<%jVv_?-kNvkX}kn
zCyVh3)edV+d_-gJfxdxoP-z2)!v-2CsI)3uk{ML9yNcHNRQan(Pkl0yfPT|-JQ?Vi
z83R`Si&^<McX=$a9x{zO-9tlTP)%T+4_x;mmfVPHG}TCb>X@oTqoa0mT~L#9>@6DI
zsn2-$4<3q+`yDQ(Tl&d?#cr0r16^c>5QMTE*RUBDh@AIZ2C-ci-+Ciz?;m~rFEl#@
zRSglRA>8zO&}}GkER~*F-I2=?{^Onzif%_e6Fb>BfQiMj$Il=a&rcW<@lk@Eo^$w=
zde&ZV=sk|WJQOGl!A!H~N_&k5czpljw}9j^gK?&F=01+v7V=Q}N1!d<LRtRP!|de)
zbl)^xUGjlbnTqgW$t?n+q~i`&wLQre!Dh8(%12?P)B`9qnzA5I0T*mPxL|NNmK7Kr
z(5n@xjVC(2>Qpt<G}9@dhB)j<`t&s*H&qc7adrYxhr)DF;Y@Yn3*q1A|EPri2UYtI
z-mNWnnseoheTRR{2ar=)xWmjlGb!N&7mQEWL{o)x;o#<=ip5aGa-E)1<!R|(nEO;;
zSj;cxDkNiXU)u1AEY0Tk5xj~a<fS&labbf+)~4mfdB|P~=9-<R7Z&uFcC`G!UBz~$
zVg<o{jz^KYY;I20KalLQz||74cHTV{tOE^>==Uy{$3L)eXwN|Knt@)#<kcP>fN68n
zyc<ui1fAYJdZr8ER7GwETJc@}3Q!HFpQfQdGrQ^~n5V#HagR({1haTB{0`y>Xp#!N
z8~;F^ywq={;p#Gn7mI^RqnjuMfDUhEdj7)}_aMME1oB7zef~c@5ef8`tObqo&YS4i
z<ceV9t;8?TO=$quPT?QoX%K`gU|rB?9*`Oenzw;p^y+7K>BH`;cE(~#7rSYQ(jOAj
z2sD}H4GI`(r=l?;CbaB%*viyhL}A|##WWAIE}N32G4P$ie4S$J>d8!60s51yXz-1@
z6nLt2?ZyKny9b$!CQSfX7dQsA98ITC;3NlGcz+DHNv-{~@wBxw!!nnuUyH-@WZPW#
z(zzcbWxNis4R1aQ8%l3S93Fxm|H{_2t4qrO2Xc-etnz@JU6;(+Q@Jo*nM%Ca(#3R8
z?ic)%US`|F{cfWkl#<2%y(XUK?3UWIQH|s#px;vn|3-*~Ano2lWBz4Ws(a*Ypc>q0
z^=1E*YW_D?E2CXbN_S<w9#^tdvo}y*gllP_G1p~+Sn0u|$KG@rzr=!;ap}wo0&b!n
z)%wF*fFL%JRXS7nX^_<FV}~iii(kN9|60?sGx1E$I)Cx@v9=&#+(Y^~sJ0KY1W`MQ
z2Kp<H&6Qhz(Is6Lr2rydz-Qw17cDsF=uJv!V=3oWJYgMT;OK=oRuqgmmEi#)Uz7bN
znHDc{q?gB<Vsm@#_jnZ`CJhJo2yFn{O~1+3g7|nhFzy;~wAd(I5cDeC@=FK=#nd%U
z!^VcY{&s~v<1;S&{%eMFJM!i0k<h{PkF?5czbn8kFi^Iqf@Wi)54ymUik4bZeJ~|8
zr}|!A37*vA%rJx0HBWSNE|mXduOD139RyPVdKF(R&r0hJ=wtmi(;DG1SmtS_@|}Of
zH&E)9<FIYlLH|$>eEaWUip<iKX?ed+rw3R_`n*mzS_k^+!N(r~o<Qp%b3=)KwP7(c
zW06*=CQvAFMs$ga2Uz=reoum|uV(T&sMtIgy~`m?L>fpdZ~N%rco|27gQ8Xv@qVDk
z3sw(|4=(6V6}29gE~SU1nu=rE8u3Ft>cgY2b1hmQS;-Xcf8IJu>pWs76KSPc?f=Wf
z12O0{!9A+5bvM}sJRbg?7?fl;h;%)=lSKg*RMWwg&|fLaaKYqBxw(PZ(<L%X!v(Y4
z7be;vKc`et7cUv7!8+Pt!<sg$>e4Vs9d)>d8z^b9z*Q~7?NNlJ7*xA`53NUYGZvvs
zp`}kb=RVcbRjWv4pt~LH%)yhX!|7Ahb>Ab3H3Dk0(Y&7+1e!esE~sldboolasABj8
zT?oKrgZl$FZ;#B}f5`QtyHAz0!AAK67~@%nwA7CH@8;k?)L^{cBZqY#u3tD>!I#3g
zk7GsS-OctwK?SCM-A|eVGl6N^C6x@q^nVw1MrjxG>CpM7TOAR4?DUQ^j@mwG0xF80
z9OHg+O6z$V90RI!&~P})dp>`alm_cTlB!wW1mm9?v+x}F)M#{Eb<Uj$W-5j%iKkH|
zag<FzaN*47#tY?vJ6rqj8|KqtMPNY|Jgv}!v8ba{9;k(iR#95A8_cnd)(`YM?y=IY
zHM-^b9Q<z_AhOl~dRd8rsD}T9v*#-2YzS5Kt7*m;sBZH5yaoe&!8VJr9ooY3S`Usa
zEC(8z#itL(_-IY!7540g%O{*v|1RFk-?OSj#h<_7O<+1`wlgrL=y|DDvBFNV3^hO=
zZUH02+YWw5*sL4O*f5=)pn&mrC3r^)UjKN4rSL_rly=Y_n=E&&gnTTHqo=i^YT^i^
zq*`yhA58{8$4xPGS5mdRN)+S&A5wZiK>qO7e*?w7;sog^`?Hz8z-#qbf6(nrm0vo%
zhIvR;qJM@v`ze&AXEZxlzstVMQt>5sFu-Ed*0aPE4t@2=3`E{9<HrEg0nCu*T{Yod
z9KLqU1>M7Xh>kpaIDNGFJ(v8a%>P`;L}Zrn6ck*kgqA$>3pI`A&QKhRNs#=wvrKsh
z-~jHp#YD5En+bFEuN5jfrW?ysKusEbNC6HvovM#O&`Tn_ncW02ZaRO;5xTmJTq9`Z
zR_@7%o&OS!q};=zlvMZ}#>X+AxE<MLubjBp|6&=$x-|=TxvGasU5K>Wiyd$U(Mfxm
z-*7{l?HL-|1{L5%7+efLM|LzPDpcZIbH!E$`1nsN{&o7l=&9L8FF`Hbo%70~CGf;8
z#+j%}<WoUAI&iS`C&yJl1WUqWrBV@Q2#t^rrlhINFy!}li8C%Zml=srxgZ>`K>Tg0
zmBPg{YysMUT;IoCEEYVXoByr0?vWCe)0Dg(3b-mOm@^uzc^)+GWcPXM%$mQ*@4J&0
z*J)^A6;A=^-IQ85bq;HBtxdVd5-6_bzdTr`80L2bFokEth~WAp2hWm^8N#}}svCYu
zE-JAU$vy_@g&lVL+J>YB!J$AE{~L_v(~c1}I&Qqfv^@FTh+^YIc8+dCjLlx74$1tA
zu~|t2Q5t-#OD$rZI@gT{jiT|&ej@+0AjaX?pc9qNR#IMpalq669VoS~EcH+cs;Dp7
z{^fX+2o~$$KuH7gz?3evOEW7}Bfb<4x?1Y4i?vR}t?RJ?Piq`NJP^goI7M-so=soH
z#L(cRK(NunbOuxEG@HzH96Gti=r0+(QynI=^x*C0h7K9go_SQm<sGVu0CDJPQOBvB
zUV$sLkR)8;x1@}$BL<%=mkORnF<tSZrm^yiq5Ye%orE&Uw&wXS{aer{?fcWLJ;X+7
zZbWIu<t~R{HMr>N9XF}N11_&>G;+#J|9oHFPqs@+zxD7TLDcI;W5PZI_7i$)AU~DV
zl{ljypSSpRJX@z<<JHqbI&2QkIO8|U<G8<S)0;NKHT#p<aV5jWB3R?<PZ~;a$$6?r
z`9!$SL&;UpAHKEjm}xz4j!0ZPGQ0I*=r08u`IgZr)vgJr-DWrzl&xR5pTs*f$F8%i
z+Zd`3-@>qH2R!$&4wRrI>yPPF#p+(gxhL01s=8$1p5BuS_AGA2AD<_1II4*L<j{Qa
z%+BL44-^!;w<wfUQpmftFv^rFc1InrsTld+djlBqh4>ot2iD$rh;|=KGr`^70YzdQ
zHU)a&G2V>~)c8uKgI1F!Ld3co4;ta2+R?ZL3-;&_OmNbE)n?-!BpoAzf~l$k79?wR
z8rCs}OzUk97=*Z2WWIG-1P`+`_ETe#FH*E2WknY(t`R_a1EwPgGxyPiQ$Wxdcml!y
z<5`9cxKGibZ4}eG$&>|4a^25-6m@<-BH2E=^<!$au8|Yp$WRYJF=we&cY`<pSAWNm
zZv;P5%~^-pI*}4t(KnKngZC}Nyg2pF^aPoKgs0`9-&g8&Ev^lZw7Uhu{C57N6GT|i
zxX0i#M(f6GFgP=^Gp>wc6P`)e72d@A{@NowJ*Q}k0n};khH?4R3JeSS*s9=x^ygNP
z_G^2V#K^TeE@;y1llTc~I$!&{C&rbKr{KPUJ)|xbcE*j#J-MEi#X&FJzPVc={y2VQ
zzO#ouLV?3d&2FQh{5nee>sO7N08)(HMe9z>tDrMnh1^P}CiVKh<#_rirr9HezCLfK
zq|!?No?~`FUR*_Y0-XQ!p-DZ)vr-(v&eQx0)#v|9(yU~J!A8JLz16Tt&YexMfj^-D
z;#Z7S^Fii*Jqi{0CjD8it}rEA99s2$TETp%c>5IvC}+^u$uuy91?LZD^0&q^2)Cyh
z01vM%L3c9uvkm-)LE6cuZ-}uLjmwI6U@?n--*e$NA^Y$5?cckCW*FCY-IFJ*;kw6K
zbK`Zm+16Ish1!~T>AzmS259L7FhB36z<bmx+$BNtabFcNutrt^77j5bdDkVTA%6A`
z3H9g?V!ty(oJuni78f4ld6(aRD=9TFulO_U;Q4+|Idt5svPu-4+5=Vwi&seX^sjU~
zQ&BealiqvD9}9c963nigDi{)qU8IX-;DNe-_P~d+BK&_4BhgCME2kd?9M=X*a~lHJ
z^A0yyygH(i<J8@bRD<yFk=i2y)$>t_19SD<UdR4gc2WcuSem)st^Pk>H@pbuzGU5_
z-I~I|5}A$ez0KNAR!gseD!1dim9IjCh&l2;)+^Kf;FJir-F65w;8o?3zf&9n(1r{F
zEJy@|SrV`4%Q<Y*LAz3cD_rz}q>nRk5WZ~ayKD6yR|{|(pQ;c(s>v6nWwiA^-Iz4f
zrO1nI<jUMz<4lEHjw+K^Do-56{}YJ>_aT_9fK{}DkEFDH?vdLh8HZ=AaQlupMu<5n
zO{;-Dl>A0de$jF7I}I4bfkjz8_(o~b6FB;<Tgu))wOat|ZxVfV+Rwl=%5?4hh9kzp
zbr9#qqTEt31S<nQj4ls#Rr#DUJ1b2D&wQh0g)Zw9VUg0|VAAcDre<(`?HzP4A<x~U
zc;a!6y|ON4H08A5UkuDy)ajcR-*wB>n01!oJ@oHjKg?GULw0Oa?EX}XQl^@+?Wu=H
zslFo67<Pd|%ZdPNpcD?4va(HX*Vl6<@B+ZbpG=KUSa!Yb1NIk8i5lHTzi&_Xhbqm*
z=XH6e-V+|O#rPU<kQnp0>&Cu>-ZaP|;U^KnJ_-#V;0Av<KbA>`6v+4<Dq;7QYBGef
zZR#<PAO*kNf5@pvGZyd%kX;*%ubx*hHNs8it&=^H#;hV*YJQh&%4pWf;U(_8EA_2F
zIzwFZ^Aq;3hA#&ALbaeU(S>Jq^b42ujYMB!vkFyVkWaZ%=~AVk@O&{ZXsRmTpF8-I
z(jy*ipR@+?VN{it*l`C1`EUFiuk$4&7Y{cR<h11?VNS39a(hR0LdT^hSXS{jP)X!v
zgOe&uo`yT~^oo<~bSH&-LNV$6R495*{y>*q#*r@bevd@<#$O6AgR{7@iRxi&7Qt>U
zBn09b1r8YZo5n5npJM#j_<Y-6&&^lkcFA8eIuLi0IMJXRiCTP}lx*c;p&Iu<KTDS=
ziD+BA-{3MRKa@X_5DAb&*Zp7sDh5KkTY|okcl(Xe0^7R3lZW+m`B5VS+Lk}B5e8-n
z(fYyUeio=eR{hR79nNV?bgoG*B-4xcmZ)#WHBLiFO|)kE#CcBBwIueU)?vSQ8~Hn?
z9oGh^R{mTs)=v{Mo=HA(9m}6BJK4Be-=s@H|BKqHLjR-dWZ%4%9@xc7(>ts9u<OLP
zeiegD)=u$zd2mn{88S-qxxCmFPPl{zcFi$hM~;EUm;NJ~f)<4WPilf0crSLN=!;Ls
z5hPkFE(df&?%wM7G(_|yW?N}`LQX(<276;sHE6^5J10tdbs^l3x>BtnSV)H5&3ViB
z{3ad}Fd2pd@%mE@<ywverN%?-aSVBm)HKU;jrIZ(**1ArqbJR4TKVab5Y-zE&mt(=
z8Z}R<5Kjo7N-}stl0Nz`VGj{639^Z`OrJKFy4=fk@`h_$`k8|bm&HNt#KXe8?i0C-
z2<o1gg<?h4c1^Bc+EO5IEcxy0qWjHPUfZu7LE1*YJ$^`prh<v=^q80^O=@0guPE4m
z;Mf`;)wv_qdo`eJ8*v9wchK|dL~hW`vVbEAc@?4$b-7pKtDR}G-T5Lu`<uOp;pYL1
z{!l}9;ikdB9!?ptLHEA$vG?PuUF=9XyIZs8pU*lzc}UrLk^R=hsaXL-4}%<i>d5c+
z$GF%b7Mj}s`rYb6(v9_wa~Trl&aR&$DHcb&v=2s41IRv*2)UQ~?r^o9J5#LXJoiY}
zem43@X@4afMla(^S_lE))#^K{KjpUaj?^p>*vvxk5up^$lbvQXdj*DfhkFYfPUi{(
zdEl{GSZu{l2fv$iH|Gh)U%}r3EB@n8P{ym}Kgu8e6&EPjD*=eT;zhOT-UTN}w58&M
zT0<!oL1}lm-nhlHnRcHI6i=>rznD_3=TcexZkqn_P+a@W<N2Y84b!Qb<Ywr%SEIAp
zVGA;^tb3}jVI6%F^w{ffvZOCIRR4Vxc}>vU8l#t=zy48jX#QK1&)4dE`6Ycd*SOFj
zCtVr%^S44dq6>sFQVeQ<>J)aNq8=LW!v{Qwwk2UvDvU{PR7@=f=%*V)fu3tp_5Grd
zy&Jtj(Fxt#Cq_Q4KQ}c~l4bNB8tMI^!)e&3`lhrTaXencT(*7!#{fI$)jEn;{AFCA
zwwUb&NG(tcQW_+Z^Wkax8x>a{!{I2FdM>slKLBJB{4a`s*Tn8_5N=Lc2+T~((vH%c
z=5;kC9)bz$f-Ce=#A`ODAM=f);Le4ehh3WJ?*B4>L3Lt|RF#NbPS*MxvL3K#j)5nc
z!tn>~Nhm|&aVAgfz90U9N-P{DG!G%yQ+((hGrua~=RV$jp%&5jPBzqPl(+`vhG^bH
z5;>GD-JWdPfBZWxe&*nfo8Bt^2Y|@$3Pq6uPG%u93l;u`=KP)p=-xAsLpRG6j1HHp
z9O?^?W40`&T)rU{S+dYJ_}Q($&}G0+xd=KI9XhEB$l#YUaIyFOT0IVpLjZxapAa=3
zowx7%L`GeH%dfzE0PIUqn9@NJE1eMhDc->Zmp@(^hYuzq_rtkJU+*d%ysg`x%zpNh
zt9$+4g5TTuJ;iz|{_^at;@2UtSIQTl+P*hlf>xyfw4V)iP&kge@d1x)M1(%=nV`z`
zLZLLdXeHam#|KZnQ^jeHbDrJoy8CjD216dO^>L|RUD2`DBMY;AID1k;2rq$*?iP`|
z6S?RdqaPVL7{b1dEeht%LLV*wO<gS}{XMj#-v3!|W2*2%T|KlJ1zS4tSNX0gJ?VW0
znicySJcy%vL-=y)%S_(jx`jc2ufW+H)?fa!vXyb#2)iKMGww}&N)#zkX!^YX0d+k0
zehGpY&X%{f4y_Nk(QgwRte@y2LFb+;@0F_MB#NwDzu4QN1q}`pUzQggk%gIj#@hEC
zM#(MNC{{mFo#Ux2;;<oI8tTQ4U%BUhvhmLqpL6y{vvmyT&wGNJW=^)Lb1J9DUTL-!
zGL)DXgmC+!W@Z64(%$3*1Y<pVCn)qgutVQF+~3wy#@i149!nObQaqIp3#C(UuF2}F
z#hxU((z@Z!?LT?yXw6pU@4Xy)kG{O*II3+$RNZgb2CMnMwV<Dt;(}t|W3%LacSufj
z)JiUQlt*eZyYkPUJ8$<D^xnY@3}k;$t1F(!AQyf0ibkXDDvXPV>Nw9B=PK47VQeF>
zCWJRK)4e7K=nmwU_kBq+7mD@HV!soXkc6gj1|an-)3;IR0?=>8;eGHmS;p>+Ld+<Y
zQNwgtKCG9DNo>v+6-MUo$`1a<71;HzP;c*>J&7#EGr~&su>C1s2>2#`E#sdx@@=pn
zqd@~ZY_&Ktxl`}@5{~6f_^+BknvoK!;Nwjz)d|w;tNFwtN*;Lm)I@5ZG6Czko0H{b
z@RrDRC*4yNuwOowzCu+%Sfe&34+Br<V*6$Bv~E%YLM)X4_MxS5dI#7G8}vM*gOP7P
zOO``cwslrB@ty|;Z}*5TNYR6NpA&zyu5DO*cg1Ev`eE-m{lk~0^pG6$6Lw1l-vM}X
z74ng}t7q>Nl=r(r2yw{vJJ%K2;b*Ag=0pT^y7#s0bnvjVR4;5$ZP?9WiC#>M{XtIW
zq78R)uemu3mKi^g#&Zi~>4k~%w+yVWaP<pkA1+ilr^^!L&VKJDC&H8XW*+<<+#=s9
zK7CBO7gkxz;l1#9P<&z>bYJDJ$S)6=ZZh&B=e5SWgw~&ytu*=&EE<w5s|*|ivc;86
z6S`SDhKuH@()Fi@fd%2S;`zizc6eF%iA;Xj{Xh2Qhd$Ux|I8eAktsGlr<1yo80RYR
zflI1q$FR%r4@acO_PmlX?}@8ifqq}>3$^dy9k`rRY+of>AE^AT|LgWWIE?#%(@>YY
zuTJB^t{Q8uud5>=ORqQQ^=U(1+XY=0rhy*mGi=p|^aFv^`IE{MP%sHRJT~1g^}%F5
zP)`ECj4~*Toi1|NXrdWm7+K)sl@F#D3??_vA+J{JrYc;K`kb?=$AXqYk>XvD0jV#d
zR(M;9hwbmQB{~}4Nge;?%i!;TwAKtB@GY=(ymA$K$S2NRKehX7YO;MowZ@sH8(ZKx
z89_7AT9r-xj_c9Cb4AdAE3Cdl2GW0oXg)wb`Fuh{LioMVdZB<sFqQ=1<%~>=Y8}(b
z%BBM9HVnVxH;`8i&6nPo{F(ZLI1~Vrmv~~t&SqX1sIN|FKpI7zEI0#CLGTh?R8=AU
zNz2{i)oJI|%fpxF_V^ti{F8$@a-H81o&3z>;=}6LOdDQRgKrBn#;_>4hPbg5dZ$Gr
z<jY0F=u;b_w6}`u0eoDJl*&w1D;U@B!0*b}6^(PxJ0<X+AaK$m*R8sB<Q5w?KEnKF
zV7E^hhL5ov4S6DlVkG7?i^gIjn3*39^Tj673Hq!?DyB-`?*Qr7k`0Drsiev>`vb&n
zN;K#3&@)f0-uRLlY2@R2UiXqjZR3ZN2On-vjFsk>M~$yMLY$oMLOjOxdqulOTsQt9
zaJN{`L3c|Ll?LN_)!7c}JUsrPq%>{_i9CnPZ|5T%UWh@Ul#SOb=6b5LDIn(!Q7SaG
zKexI_O=@sJU;OqaP=S~p8|JHKQ~R;#wI?S>d)sNu9;tKx4PjB&2l;v8!(fm>o$Py-
z?7P#$GvxyDH+5GQ_<I#5+h2r>K@T^x1^R74J*e14QLwXw#?kXuduVuiehe)iyl^<i
zBrYUV)XilPEDdWAJO}TuJW-Ifi(qxa(_9Kj7U11^!NN#wn6^(nhTUcE7kCntlqxFF
zgCSt?zCW3p_JsoE1&Alt5Ba6z!5%-l=bCtA1$u&HFiML1bp3(;khiFkx;3F(Q4AFM
zqGwj55Y>^e_m~-n^qQ;7LT^#l@q<qgD5u3t2XT4CjOy0VzU2-uuR_-1<SF4l6V6~}
z-+@To=9&tN9=zo|L7C|Nejn5AMk6Mbg_PO^oxyQEXj%}%7ob7Ug~|SL$T9uE@Ep(L
zD6fhg9nROb6?haH_2t*gj#HFN@NJiw?>qIqT$AZ2+pjM_vqxj{WqCQwGxs+D#K4Cj
zh_18>GDy4zcKS&I;r!>8BmS+?Mvw<7!d41A97iCRTh<(Icb?lg*9MV47b^5YX{g+m
z(+Cs9FADLxe1kE@zZ<%Q+^9YJB`ov2K(r_4=VWMKu<9-``<d{8l`II-ULA?Fw*~;D
zR0GtEyOtmNQ>P2kIU{x8R0g8tM);!<zuUu9rdC%xl?qV#K;o4ON&BML<3Qrg^_qqw
zy!1K=&b|q-%g16z`m5xzKbTsBeKalcTv?0^5ujVB-f?Y5#&?@knh#IJCC2f{q(Qji
z1d=6q%D=uB@ycH7Ectw;5>DJuy|Wt&g-CEe+ytjjx$KcNSzFqWD)W9Lx#6^I$*KNF
z=MSt1V;U9*!$|I`l%X%;(Q}ytIaja&_HEF<N&4LvH*DNL<(RT7#Vh(^x|e9RR7FS`
zQmO1QnO*wI_qI7VtDNwhMLEq6U(Qc$_SX#tVx(;LLP)xJ-FQJV<Pl6&ml2v~IsREp
z8YW6qMgFF9Jz5XkPq%WglJ0f?beCKB4do&`0O-;)z#D2IK6T|s^pIRL?<emI;?a8B
z3qLlx-i&X}@rl9`6C4cNZbLo%mH^!99C=B1XS2Xj!k2=>EqcBq@+xsS7nOIP%kI+_
z8z1ZJJWwu8R}64hTWWNGV_W#3<MPJHsHRgpQU!|=^Y0$mQyt!fyfht>I&H$y&O31C
ztJd#vMD!n2-pzCWg3YlU*r`8ye9Ln7@s@2f+Q~<u1FP_;feQ~c1CH~361lJaj!YO}
zM`>P4O-;w%yfAX8Gh9Zdt8&@%@P)q!zqv(|2kGe3mo9&0q>EL2C10N(cx#@=oKa3q
zf;kP+#%JWCHi{`?k!;%59j?6<D8ItBN#{R{dt=8!aNhc+c&y9&It=%(2AL_Ef7h$2
zUykLcI72`2^sF__f#457+Rse&a_OCB@}T&n{<&0ENPvgDdZy$O1yC$<o;=3ayqoPU
zc+imCSj0$_7^SbGhf-x&E=F;GejdjCo{P_T*6lf~(R&y3gSPaWXnD^p0_dT;WQ|dp
zC<tkn&VW~I6)wF(u{|{4kfXxeMa|Fer@LI;FmS+KEEe(4ESY;S<IrEjgV(r)!8ATw
z98xs@^It?+iw5Ym4xmH@$P}iZ<9~h^Xa)(W05UV{9O)hCYUp+*=Yd)`;Um23G}THu
zLlfQ&c8R-A<~lf^ez|a%kg&4Iz`(nipnvg8x<jxsG~-J5?kvoqs=e#bWciMaPYha#
zFR-{$c(5eat4u9hrTfv9VdYQ!2ORU*J^7~I=s*g;>aPV_>l;||S;<MlP9eoF6@FB5
zZZY@3G~@Bsa43=uCElxM)ERcHyG@W-rm=nC4OUFBE6?ZtU4QXQ9@MDs1?H~|j097E
zr=PzAVi$<V5<ROL+z@M085@P|(=R4+nJWAo8&afX{-{N6k-xE1Tok)1!h$f5^I@X<
zYMDG<t+V${%W^<7HDg5>dV<43Aovhs>^lcXzHQBnr}-|rP4FPk?sAdqI9G^{*@FsT
zb-g~>J@%K9^%4Lwg%X7xxzrad-FnR=$_ul#6uqivt^AH#P=fu=yHroRB=BRrisPow
zMhmQ*=p|c(ONnfDWui}6NU=e%Y@1=HV@?D?{k|%<K58Xm?@M%vNM~HS(Z0!akT5Up
zgNQoV$PEb~9Wz_aZIW#Tn^}YYqOT`~fHLDRaRVn|@KF^(yPICk|Fr=?3O$$-%eFC3
zW#b*my#JxJ+x_khx}(}|X?Q=j*j4A+9QzsRq|94emdv9_3y5&8*J*)1*}!IrXykqS
zc%Fepo!#+1%Sx!at1E>2xQtL)ykecc{w%j4g#FNs?r@{U6MY4VQ2@jM!a+<Yy#1ru
z8w&Z;?dX{b@lfImKImY-@XNQy@J6o!gU-nG<0ngbR(e@Ho7k=tM~dA~UbD%nSg>js
zp{oZeX>-YA`$9EIX`)-EWKV+=_Pm9vqqqI*L^v|fDB<NfE6oI6G_pw~2UbS+UNmt?
zsge%+Xsa1J=w%|@9I2B|j~I>huSXX{#rridmd9CF<3Rg^D0le_pGOaYD59VZgEZKf
z|N5)PznSJp&V|t%e|zeF5OAs2?&;rA{&F!|JLRDWDjXuvBGkJQd?L!KFGRp3x!kKR
ziMv1W(w9UGQXQg{t!~5NG7zBCg@h$oTz`H&&*=NrG{fxj*F4ki%byMXZ9T7XEX)qR
zQ9G1oHp_zeL*i6kynu5b&ss67JZ<dd(F}dDa4}PFkx=V&!_{ehM>>73k@}xVBH134
z;K9`~>wTjfu@(bdB{5ZV@HfWWV0$e`eifbKAHA`PhA|Xo2~ic?bQNm*VVlDEr#7nd
zF@`0P)?yir%tYzj_aYagMeoP%%(ARpHywY(7(O20lJ#C}6_ga|^lztrK~POLOgaIk
zWAB$8H`zBMqRPLn(k@7aoBmuv6Y`rxakT5a9Z>0>`3ZnQ*jYrg#Cq94FP49pzkbQR
ztyr+pSTIl;XstnU>bv&D?O*wpcLC+>iCA6P`l~4<FvH_EyJy`mEmSel1&ZE*HL#Ev
zayzikl5<2Y0^fUF2qazd(lBOTIA8h<M#o3*n6o$FuA;6r8J5y4R6?v$9h>lqgY385
zJd|C3Q>d5i-rv763EQ9N3t?;vWpTvjA;Cof?7f}rlS55)-_p`%s};F=%S1M^D<HSG
zOW8b0ZE~!DS)XYI_LUr1rPPLvYvWm8Wd-i9iLhH4h~4WizFnY>Sa!+{sbbS0f8<!o
zaX*kZBg|;PR6Xe-W8je1urLAuMDLh2=+@n^8<9`}fK~Q^q`90pA8nXeQ_5vL0mzPE
z${3UmK!Ls*Nx4Q5L>7`~Ry_2ELTdBd!iI}y2aEWM^iE~l#M}LCrItz&QR>v}*M`Ov
zMCk-s;qNiU<P(yWj-kE?itpvP@Fz^7D{t}B$S+RjMrQJtHr^eJ;M^9N5uPthDNTyu
z6yu4fKB+uPZEOfi4e%R+s_gNWkmuhZ2F%ps4%v@Ev<ZJRm>pb_hem~Vys%1nnO|yv
zI9ct<n@=+PK3iVQUJwix+?hlLUmBQ(7}~JKN$BbbyS|nZ2>IZt-&O+oWp}&i1JwVF
zf}Cc#J)4PIknmLU!nOCQ31>D_g8iZV^Qw=pNJS~lg{N4&)`#S11PNyf2-9V3kVi&4
zix$<}$uGU4%Am`G(%&u@^}nsB;01dGnOyh!e#|ZX1O$nYU#JT{+7XAh3xE|)z0B#}
z^OIcBhmod61MkqmeU7@uOMOqFlln=MBCU6%TW<*r%}3|1)pKZaLej@i%Ujdo(13$}
zpCevJ?Zat?hv&54u*a8X`JQagy0l>M`Q^HOYr}rb*hr{lOQ?DYkYIJlfiE>csZ8cu
zHPgZw))R3@<Z}Urjwxb+@~RT*<-rL~p!fFt^x{%89X89Itvl#;_0P1w^0JMg@}u2+
zn|Ml{g3BmUf#+mi`BG1Y4HBK4BK<D01NJZsfprYoAU3*NI9Y@|!So7bpi_vPmOZ#F
zNwjJFujCH`cTZbVuD-(Ilcp86`W@jO5L4l%>kkth^61L%u@5QpM9+mZlHT>TKL9Gt
zK}qnTZG*l073K6|mGolG3_~N~11+k&rPk<(G6ct*phnbUEId!X?%ns%E|KNhInb<%
z13xS=$>SvS^UeNmsOVaT6m_nGn{W0zEJ$Nsw)-l#8EhNq-g7C$juERLlMO`TN`}5$
zRXsf_b9XnH>-y}Mauu4r{YE(jJ>`~%GKF`Ohgf1{TGu}lI6+Hnn7g-?!e17MA)zXy
z@ytzx+0DdP08gLP^Dbbg_D$AVC6r@5D#yT%Wojo&MHmf&aavAsU&b$4|JPL59dQZh
zf1!9z0RZy67vvyy&I2g^!$240)(^+qQzykgJk`Q5&IrHVq4g<z)^4@?^$@_hx2-)A
z4%pD=iF@uMn4R)qUMfwzj}zKPg2}P#R4PoB1}F??&YTsbu=fTdpB5QJ{T-hSh}zNm
z!d@}remITO;h^(G6z7}AXHO8|^ZmSb+UxCDUAbPVOQ{zb(F}4AzSZF$66q*1Z{2id
zWs<VDZzbEy-)x$HFV(6(A*}g9`)^R^PRea`qz7YFpH81p-#<2_^=DdGT2`fOV7=Ea
zu`+=2agi>XZ``eH0wbql{D(BNR(b?VrB*yQlnQeulUwAsb3FH*lGZ{ylM^;XGXx%d
zycJl3T+KXnFY+B<!Nhmi^S@UW&RfXWMoAvU=uaH-%b&BAIBow4c?3Y={_{79jGAI;
z1+nWhJ|x7*CGcWlBgA$zGw7=(g7Z?2y#0po$cmvz$DOI;Kf4}DaC`fgs@92|j`$UE
z-h|_b7xXklvG;>+PHyV{kKkjClf9+hpGx0r<NA?}=Ezs#uADq0%2toh<j8W)6`WYg
zKOGcmz=7Ugcy6szGTdCLp|qpk@Wb-!Y2E}llV3?7_@MhW_A9QfHZ~^NxgRBNSf60Q
zj&jOHDH&ZOyds*_<RQ7V1ui*2-;Zo?jJO)`ArC`1^i4>e*Y9;$d_1qzbt1*wsj_Ub
zg%|lMs0WGal|66TcqL71@yi{gcze_8alYI2K(^Ac$L~a%`-um1`3tzJ=2Ri<;{uby
zN+ea(gY*4oLgV9p+Vdh_R82}9yruC>C*Jn*nLk7=sLk1$jJqfL`lQ9=w6`D@HUk%)
zAL2HXS^8<oRjVqiq7_T%;1yO-dZGUF?TXZCVc{7UjSmo>QJ3?g`aFlLgw3>F%`<h1
za^#wrUwuBd7oe&_OQJFN^lOx6PL3D{`3VP@MR$R<ir|Fkp@VwW6-?7iIp=jjPT7l-
zm)qv2=Udp4AGc#lN3%rwhI>g{?GV{QawIwMV!qR=#K}=uOnkp4d*&t{vv^F-VJhZv
zuv?VF6yjU-ZKwCVoo$)PA5@;knqRzmn`7mjvMkpIJg#=$BOohmz|!a9xlQ@$6IokS
z{o)&RV{_#zuPXNWz9c_?EJV!2&mJYd<e`X2quJ5M7d!=Zq!v}b8_J#);Z_D7+CWZ5
z?`)rwstYG7x-7kgq}H08R{q&NEPUt}=V8_vwOfs+0iD^}FU9FM5B;R?Bagk`Py>%T
zGx^%~DOfK$Mte7o7xwDy#~FH8B2g^;%c*|a@7Se=g$2#}e)BBLw%MtLw|K#!uqq7N
zniLotH+jC$Kxg!{FSqCawE(#NR{Ldf40($9Q&sEQfzksYl#x=uaf8fs&5|G~T5seg
znWp0Ys2l+aMilf4T+rbJddi^!Gm?rHepT~--F)p_k5)fmdknqdFT(4~%N7$~4Uy0q
zmnh{Ydnvenw>@cAoA%He!ap>(WC}5~gby>Rh>J!^0uFJk!`5AfV%bg?9c$n5TeF-0
z=wpw~Rp9mx=RIpRp>N@@tk7EaMBy`DOYU23-9NYNG(pntpX*dideMF!=ztx!!_y^?
zVeBDR3#h!UAZ1uB)upUcNjZGn@*1KWxXo>8N=c6HRZ6T}O#&#tCsy-4bHzD2#%0eR
zJMy&a3nu-9ba^<T_0|!+F<IK6tF{xBOos;AD4g(jekB`c5&uLkZav~#pR*FLU2c+U
zkuy377MxiUgcol<UX@3fI_EyS%g^(+>8N%jO>TPwZyK{~tFT>co0gbhTTI>v{}4`0
z7;PcLhPXctIyg5j7lsE3<o<4#uMbQbS~Iznit#nB&);vJerqA4+P7Myr7jB%Y?uq<
zc~>zuhCs?FLD%@Pthf#TEdRvQ;-iZG2cpZqdheS~7imHc0tegCaXjovado+5i-)C{
zZ}>izoF?I2Ah6Zq*y8^o;Y*)6+>VaUOOoi<KYD!&&4TKnnU+Z1lRB5A<y12^L<5>J
zUs{51#M7_6!_CD$X$I(Qm0WCpF1|qKnFjYE5(kv<mq8dyI|iwW)G{x@i$bl44KL?O
zroGZOWf%Ag09y^dhN|ZUce9*<E7JNmEZiY<eKM@}_;HRSdd5vJWB;RxK9_;X)34G0
z0P3UrMyJ{44Mdaf>$Is>$7ny^?L?4N)f`iw$ydOCxT8%aNU@SMf0zo{;p#A2aM2aX
z30d*b?>;3lb4O+js{y6;?e8EuF0ZJ^hj{kwJ&m?F$V=BVhjZK=cHOEpZJH6NwNxzW
z5%YY{7_?49FPw4_Hn?V^2+iv6-l3(V&80fr-pu00VhQP&cPQT+hOUC%t&{F0hdaNE
zX_f@@vRtX#AMyk!6qa>CW9PAj?5r{JxUekSrHq)TOp%>H&Sn9X1r(t8X5^s6sMTv-
zDG&LorGZD2+Nc;ANoPL&>_%v?1uoO+7MhRj-OsQl3`IXk0Xlzu&>+l3_nyMEH>g=t
zoW^YQutg7iC})sn*AmNa)_$_|T6)Qzx|SxH!oNBGwE3dLpzjf%=vm-uWhVp?f$R57
z<dT#JQQmQCdbFktGKjfG@WA1S!OQp+8frshC)){ZV&{P^goVe3hX-R1g4?%Av>S*2
zqvC>>%bR!HK=r42Op%ZMv#gnTSU4=Cw-v+Wg^HBDf3(6gFmvQg&o4`s2;j`|@^<R0
zy*@~=n^H-C^sd9DUd3@s&I1B>+RCPJ7FPW1sOX76-{oG*zQYFCkNjb8Chju&_2lP^
zb_=GdD28xH);}R+N0>+FuJCgQP!{=<S?ux<d6ZIgM)b|(SE#`cqb6k!xxV1l2QAN1
zCAxnqg}#0LSd6EtY&05Zhf3y!QoKvn*(ah>pS!i#^Q4*1+dE;FfGp74%a08b*wx;s
z{4h~hYL_tu@#xMrH4}@Sr?$_7DYxOQs8M*XTuyRaRM8DK&1eeQYDjC*t$5d~UY;TI
zsz(!K77*E;MMdbpru8~gdVk963Mt5uA-2e?;%_IVi(PlR@*vu2QVvU*j#|8TBo=FZ
zZP=$iX4}LGmmK5Wa<6%Vx<9`l))SQ^t`>!T#Q|XXJN`f~*$U+JlVcjhdd(Sjy1r0+
z+Z}RFl^`@tGPO%2x$l<43Dl{=E_#p1hQRopskhYcvIh#4)D*JGMw4NIGCQCZVK7ur
z<EU-W+*WtIyy2&{6R^=AgSYEkzkb{WNd(&Mt?{Bi3Jh-M^iEi=35-n##<<HnZ~|($
zc{fJUSOU`%j$>B9cXfdxJfnw9DLY&62`ul7sBB*T3-2)mi^t#(ntqZ7+9ZL5n(RBH
zub#w^*F!dbI!w>sR8ZA4q2#Bz+4%{Bpz(hc3JU2TiwipjM}T~XbTU&(O%-B!qMkj0
zayNZ$F4T0j7k^a{(*OI&DNA`<=WD_OD}jrbF~nZmmYef7Jc{}Cr$8B5)nP=d*ZObV
zKdUY<ID@k2<BzGqxl=>qrxC)tn``#fDv|<3-YAmNl^iw{hGr*heSBwg!G`Ce&?JH@
zoBJ_7SwSmdLo!i@Y$Q~leNsqa4N?hF<FMg+o&4GH$6#~an%TX>`2;)yDfDG;#{u(}
zL;w2xG0l^JC8){`YH))qoFowk6Ni-Xy1!X$Kem*Zi@5sE>_ez<PJinKn?nB>ZnM_u
zF9RjVGUTuLhs$xVpY&A=^Ab%res|=QpYyt#C<W5v8XfOa&uJL?voeo-k8iqetIqPs
za#-Okee{zB+{nB2sTmg#Cg62$^qd)pD0THtI$|U3A9Hy&a^%!^X&Q>7oz*DGgmhfS
zRu#leB1FBVGV!i|G+YJ3Yfkm8PEJVohIutIDg{>gCQQ6IEg63PrZc`5Qc}_;)+1kQ
zVntb^X!0Hjqzf(KDIjA3gzFdffEwp$>sqQ*+Efd+9e?oWPyCwWGAJ?=suD?dE){7t
z`y;on2p_tPBhx@|Vm}@941d-GD3GOSAg@h?#NG|k2w?&(x1PO7;N}s7g#RsF@=ITD
z(`xqD7m}g{yW{DPp3xS#4{o{mvX1dU761DF(ZG^Ah93_Svz?E&{f~gM@$i;u;eO#i
zZ&@Xnl4$%x{x!PVhNxAM?tk3JRFEUu<`&1@ROY8scoy0fIbsH8?cS_@JSlWTIt^AV
z;N-o5b%jE{KKSzSt#5n&pI$>oNY32eCzY|y@I$ihFS4XlL*XV4$)zGIRPAhWRnu$z
zfF8g+uGdzWxc}TyP=(w7-qsb*rfGVbC{>RrNLl1op>Dh`I3Z6hJHUL|hGB{%^CZV*
zB9pjuHwWiu&~?l-wPbTIr-1mnzQud=s}u{@=tLg9;nAr)7b=4t@nf~PQ=;{HjWAz2
z>vt{p+new8AHFX2arKkY=ZlP<*f2`^gw5dDw3=@ubX2|s#fAT=&FjHy?fWbLsY3kB
z7wd;<G2PS&PQ)B=CQ1vYO=z2VzkIyrL~-NES=!~DZIDr2fne)B$l*TEmGtuB-HPf!
zC%bNI`@6+58`e`jkg?0#E0_*_s_>IFyIXi#YBxw+0w-D}>VH<uX=Z=DF_qclozvE(
z@!E>}65=Mneuks+Wh|jwWbSs4D)9-=>n1nzUi0N(k_ubISyDod1B#x=Y0M0(zZe~p
z>aTW1VVlVKY(R=DwEAlb93$apnJh3?fC?+VO3s=arEEJo$JlIa3xa!ui=pa;ovm=|
zSb{#1esC^VvxEC@?7ZH9m%md-lHrN25rN_E1n?qCNbXF%=Nm~`;65fgH73=jnzcE{
z&)+EAN#=Z&q~>hLnR43!jm?XIFB5YIUepbLc%O$t_nfhj#A0cwc;&$afE!1E!{@&!
z7yQJ{w}6n`%GErtWRD?|M$ekY(}{ax_RG0>-9N_vsdv*uNP(AelyXX=&Ee0I%<q&O
zQFB>C*9;|LF_Exh_zoOYycFIBJPAOb_$;b|zTz*5G|DzdqdUKzV;Gbsru0FOE@(XK
zIPrFl!@+xpG}BCxuv3q!qt$)@Oqk=j*!z+QVG$PZqK<%4glzIF++Ym!+u|)2=k|cT
zvo%q3Ti(a4!EuTS>{MA1-OaPl%<g*5t<0McVT~Uj$%q%}Z7Fej@l;KYd$Ug>Hl6|f
zHf_F2!o~mdZiQV?uIBL9YiCI0dnPAb`Jtr7?;3d+;Cj6I-6vNcN_n8l8N};Hkhvbg
zgjQJPp`6ctsBF4q!wkHnbk)8DQnCAtl5}f-`<FV<WkG~-%g*9j_((mN-lDk)!;*_U
z@}tLs%H<74HXF>KSu80btqK7mJHp1yyhd;1cZrvnUsb5XV8TA{4`z1Pyv9<{V2KVw
z^=AfL;Nb0!bk}+!dkWN0oQhjiJ5iOhI(XG|a#XH7qPj*!SmKcFCy^JFPv*Ziq?N-r
zVVl<6Uzd3y&MRq*b4v#KR0a6>?p~f~l=jEW+^Aq|9(SJ*n*UV{cD=`yKIiu-a9*Hx
znJLP$a&k70<1l?^CY-)nJ(S}nKho>H>jg=Ax)jM`JF?T043-k}MGq-nR2^9Lb~?aC
z<=D{bs4pFi3^d2&<vo)|#}R)z#{oP(vO_ki&2qm#oAQ*b_L{C$<!TmnYIej$NPV#o
z)#6SufU}ntZrRQMof!XV!E(d=BQ}11DuJba?54{8L~p&!=K<fBKtW8Dkksv*prgZs
za!z>*bs(eR{ZHJIdDqDbNjN;g-$pF%fPS=9GR;E~NjXue&jG2wnZn3?{$}J<NrLb>
zt<ub3UZ~cofG_oUk7Nfan6+s@J_n?EEMZx!F~T>eDiE4)Cc2yX#%&-*V0=0ht}Nu)
z!%-`nA(krf8`F1W%=Gi~Zo1c*WFaIsBx#1P4oX(K)LnpOYy-<<pF|%((%{|o0?(jV
z)*wXX;jb)ihgWrwp|5!-p<UOBaw<WwRM4mnDq7u^fso;2Kfc3zbA&13>=~A@M9A5I
z(tC>81Js-Mp3J@{p1q@x%H%ZpCC(`h(YaOwY5nyfMQhP-J~b<AQiSq)HlW=U@Ou@7
z-^Z&TU!2zfoa&qD?Q91%B6&JUVZg9%z>iKMcTmaIKv$M*99LGkfjv4`w8?)xKcRa9
zhOH48aflsUNFRk1>-Si2vGKSfcjWFX+;&2FTn`p5QMXuPejej)_d=5tMHbV;l1N>k
zU+OBjT*Bqg%D!`x&O<>J&U`x)?@xXzONje+<|}|<yCm$FRoy7x;Q!#S!oagJRiSrM
zdLg^%ex%mld4}m3wxy9tu3OKO&)FSqdTX!$c@!1nT;Zv}g?rul!8%p@oT73>t!0`Y
z@<CT)LcfgogmlNRvE#)ReB)2g5srmT2=$u^@P-IK5s0YL;aFZSRAsYUE2sAmuCo6e
z8k3rq$U#-BA2$3$Mo5pw(a>3LC7rLT+m|wxneoHcG;Y5jz`WKC)kHymt`H9<Gb-sK
z%UBZk`~#l^5i<=s-{{KL*44|P<Wr;R*rIk`mI9gS=#NG|_;7n88p=4jW2M$A>a{f!
z{b|@pQD9@J>4MMW$I+3;)l{|<q!|MoPx;STxE?I6v!dlhtOXo!ZAS;5_w2K&OgmAW
z-;4NIWplQUO^qA!l0(GPZR&u85fhIm|7L?K3(cR?@V(i0_OrpKhdhvo8V#>IS|Wd*
z{`l-kC+MzmICD6ZLm&lA@qy1qi}Lv#<H2E36DJ7XEtDKD*RfC^%QTr$CSEoUQe<#1
zLV$M&;PCo9OIJTovGiA9g6`lqZJyh0PGXP<I%MNJCPblF9rIc4rHO$Top)bWWBf!U
zO3vP^^2%B=Xwv!m(TB|Lmz6Wm^=8tV?P8Pt6S$T9kxs#?`7fB?7XzgAhcr@FlC_><
zQ+Bk91vLjj2?j*RP4?`>kWhWUcps)HBTjXbD7CF;*|YyIP{eW=_i5X|2+->LHnU{z
zDR42JQk#b8jUg>9`BYWNk5=*Mgbui3ie|WTx@bf1BI;WU<9Ocgze9kI6GQ0WHQl1j
z#9$M8VNjET_)M^<neP>1wwaS2PPX;oH6LNj{{3s!O=`~7nESRWJAmP4%(keK7)4M}
zwjLwGF;|W?ihFNp#dJ_#xsk2(t>}(`L(ui^YsvJYqyJ`iI<>166n|n5sFE;2Ou*?k
zk-r~Fe*Q5r5aWPJU2NBmiT|q$B;$wR8@XK2T-<`GA3!WzHv&(LfS%yf5%K8y0ygiO
zH)r<P^*+#Zz!n(izJbR0)0f|nFHbZwB}KrRiH%`W^<Pewa*os)6($qd&Yo+<0H6xj
z;dP>9lk~lbUs9v3$$XHJPpgMILp*g(9$LBOtR2Ma`o+($cf;{qE+V^&?`miitrs#5
zK?WP!wlqN8T%iX=c)~HF0a)Z&wwa1X%kAERsw|J8gh#~SM<X^*n0`6)g}^}KqlSW&
zzrdG(c8H4Q^D4azfOC9VUU^>WsL_YF2(_>@N?}4`N4yQ^tkAD-@w>_86pKz?_%@4u
zig4vBpOFhw3MV-L3jQ{(HGN_1ZSy{vJKA7$wJI7h^<91fY2IAkvxl>^{fRK&9wc5r
z<UTCWAu{j$1!(5H@Zq|4Uh|%sS6;LHBmR<pv+HUqqr#tm6ToCe;abYH6;-HyP;cxL
z>WP)Ex%RqH*^?CP#<>NB_<)y(Y35(8%{^Q0?AQJE_cM_>;O@Zwun2#Id!5YTep5AM
zT!4^in9eGdK`@t<oX*Ml%mYOzGAW7g)puX4KDym@5w6tzanmw(V%&Ul<E}Y*TTJ56
z&vmXdy;Zko>wN>7>4(V#SrcP6W@z6_X;W+qZpS2wfNI8YHU>Au=8-8e4-DlObYm#J
zHtzFUFY@{y82H#VI?7y!UmJ`~C5VW@K^$!C7<!+)8EA3b#)gOeTW9;5eE8+}L6gE}
z$`QGkK9q<}&71;r{bX=!L|c!l=>pO-uJ=T4GK7z2U9}C}9^-F%66dbQuCdIS1}9eB
zR*^dcy%YR}bk=$~wc*={q49yx^HVOsI8vEvDMeWrW%EMmerEGT-N;k`)iSTyy~Fes
z8X%RWLZM+OrPbIKar?V_Y(0vKh~6U*XTIYQSe%zwSr!s%X1o>9=MT|{+DI(oth&X{
z(RBi4o6E*6%md%h$>SN<zdqfo^Rs9c<&ZU-HPEon71A*ufHZ<}3vhZ+k^Niex@a$6
zl)1KvXou{Mn9GGR5v>ctc7FXw=78Y^;XoC|Y}G$K?2wU6*^BATOmEbS6S}f-HdRN$
z$U}l)T6BOe!?>8gs5nC(8x=l&O?=W|!}E#1BDc=B^PY$ouc`<F9Z<;+Yf;y`e^o&u
z;L<{T2{A^Qy)7S{EB3U;K3wkQcr9=yljkJ2+IH%%S9x|2p2kQ^Dj%necH0yYa@DcD
ztuscQS~pV+-csw6b0<jF*#=!iYuP)um9Et#gawOR3~-6F(s<wexkTja<z};pij<K?
z<g6zFJ)l<FScz!+@M1H%2R7D0YyP32;&s5n=w1!mNY(#i>OG*@e&7H9#NJ{RwJF+C
zv$Z!xYgHFos}$9$Q7SYcv18MPs?oiTYKsQ3Rjsz#qC|+<H!^4?B$EHF-_QA-f6kG^
z$&qpAe%<$VU)S|~KJ*PQOzuy-5+*%ofZ=!GGGK;Z`We8KttyvhrzEvi3s3e=Xr}8q
zMxgY#Q3YCzM~9uHlc=gZ;g+5=il<x?OF2`cNNF2)CL`Kba2VLb!rq8GMwU%G2j}FI
z2=8?2$(`q0F~KcXhJj<U#_fgMzN2{3J;VE(C@J_fTeo~mz2Lb!hwkKtm^1<l6#j<b
z4&(qZUE1&L!3Xs{3ZRY|l6oc|CMS1JJ$mlkQ16lRCC^Ljr>qf)YW`YO=1H8URJX}h
zEJxPH))=fh`*)R8n!-&$ccCQ)aZL+wl&yN^=ovVamDXE>G;C0wXN%t9>W@QoJwAbg
zZyQ}H%+d;KRg-|C{0RsuS*E{iEOd#^eYzEmPyJxlZPdK<_X#VGM`ms2l~8@M{0YrJ
zmyCp7Tvl%{4)M?;pjg*`BRM1lzM+EzAVVH<OXNy4IhABh1<%Gy7V2r4oQuzgPdT)|
z-dJ%~@fAjC)iRfb^e4Mw?&@|4=sx*q)A?k9-^G*79<GO?UAPdPvaf$Acv&cfC_W-Y
zWf<*TIrs8q!`{YO*a^w0Ze7KYg_%f{wPc1()QdCVMj;k@$39f(f2aWaeaz*+0Tj#q
z#l^!VDO~d07P%c~_U7ikeEISf^MJIfrGv2Zv$Ea)c>|VW-j&ReXU7Pw)0`21^nRy5
zSzBQ{EG_VmMfUUPynms@-ZXYFpA|HzN+dIvXC{&1)ZyNXTZC+=ssc80{QIx4sXdaV
zLTP`5u9}3=kJQg_VYoS-JYPH}UI<m5y2Ya?71u1NxKYhFp{p1s&NhE<s@cy3ReUIq
zT~7W`V8({4lI08(=X=Kx!f9(W=FZRd3laequ*MvR-iR7xWtl+uAX7r7?GPKDCBd2f
zdaE_we_xz2-j-=UV|73OFmgPiMOJUjU*`LlODDr{?{7?cp5|-08Wc&Gb&nGj>03=O
z5avK!3MEriy6$|l5LsnzG1+`vZr?c-pXucth)}rxx-9f~<`r_3APhtPtN*Qw;<|M$
z^z&YMlWe5!mnYW5;BB|rq1&WMxYNL=sO}`gS}}!~dZ1fQ)17lRpod#eDaAU?%Bb9|
zwrg?cU__K^fBj?hghL>>=;1knEPieyB~-7XET--Oe{IBwLDgv>d}s?}5VFS*_!zl1
zvQv!jP7IAVA=LVy-5g=gxC&an)3?LGv;4`#D0tEspC1sz!$I!fZcW*`hjrxF^cjNX
z1WP^n3XXr)N(EIuFtl4IWgR5ZrnMktNoK0i$0+JRYH;*Mtu?6@$U%YOpyX0N@E2Nk
zmv}zfZWC00P7HKmI_;I&$MvQ^aWraSC1mwJP`zc-?ZvvsClCIeEWYpf0QTwABdHwy
z^D~f_UtY-adfh11ih6uXMSj+zWt}Nuslnuf%t&>;9Jmx{jA&&hqhN0pfR0Eu{b9a(
z@5?q6@R0jIrrZg}S4B0-r*qyAu|AY27e;oe6y2=fc9^eLd!?P<hDU6i^ZCj9Da#?h
z46Ze1?Z>2lC5y`QoV<Ky1udihupOD|&@oczL9_sG5O5q^zT>W)#{pyf!sR`tY#9z`
zNK-yAC@^`eNgj&c^V`CN?;G!|jZyIuy9**#^0wW9$GiZ?xwyA9Q~1pZ`iO<|(AxCm
zRYCI??yzGyyhX|r+7yQc&H}cHEa;)-X!iIi-091-e?1Y9J_QvsjOtm~-&<<herlP=
z{k|D)=ns}IGZ6J3^j*oV20hU0@I?rQ>5L9P#@WGULK7fc(xCO(D~HZOfvyXxsR^#y
zr)Xs%jRAM?;7#6Ao_zq)rT>Hbjy=vq=y!Lg+!%-P8}i)^b5!p$D-DCYWbP^NdmUe!
z&eStrPjtRsy;t@PKU*uhb0teN7r)o{zVYnB>#$SQ(&?-Gf61Ohh%uDl_y3Yul;Avi
zDe0}+y;*XLUP<ANHbox`_tyjM#w!6od%x!$BQ-r_VD5Q*IR#Zq=B49UM&WW!N;$3M
z8`hZ=u6z%7MO+oN&Dw3;JDBm6rI}oa6>j1?`wfU<7O7yW`Bf436l}4x@g(N)RQONt
z3nI(gBTFm5|Lda_RmStQR!<_6m251wKhH}Xc=OScy1U(W{YWH^;DOpuk+#GJj!fo%
zGo|a;e3=eC1*X}FH8SQmA<~x%GHE-dD%_DojbOpV6o@3pYuKFB5{VfX_sy+hV^a-C
zFzI>1E04^BEW#q3^42gLv&Fv&;7vm}N97DNR8ZKNTjg%XK8>mFSB=YGPim|4uXOc&
zSF(?Ul<VUs@`5V{gW2r%JvZeZ7=B@NeL-J2>%kxh@e9}(iG>K3F0%=(8G|t%gHq?6
zG2;F=BA^l8W*p-LUN4J-hAxeX_4-faw|fO&<f{vG)O_T)bC-W6B;R_crsK`1;C)-G
zl9_o936MK5Y*UGTh!$#xxT+X(71`=oCqOD+yt)YCLGT`JAAa=f4gtmP%$-qGTCq0%
z^ZvFE7o@<qQO3mPN$xA}qwgObOM{pSoj7@@vi%hFm!Dr`dNUg8<+O+5ttK`K+Is6#
zh1a6b=m>ttKn@>9H?46R7QF`M<O<{B4*KW6?-@ts=jeMEC1FeM4stf$yPO}kUtK`-
zQed!6P7LU#mXk7K7<B~eU6ROBni1mSP&R;=WUY!PcFbMR?~a6PZM<)DYD9ihO+wI8
z_bmB}I$F<Jk`>SJUI{tNdHpT);{+;MdCW9>(AH_TXYN2GRVK6Stgdfd5@IZFD*S9n
zS}uz$DbRNKMXgdACEvYPFf81a{w?lIEhhDT)(1<NzwpY?`EkK9g-`Ep&F0pW^ajRd
zCU$&1S2h>n;GiJ&B27bk--c;Z=>YDW_GQEL*NX9nuc=o_f18RAcGs!DNWMqgYP#UL
zwb0tsrUu8eNGvsP$F1u~yMje`F)T>BQDOPJxi@$P(^0(>uFYIRx(9&9(AfuE`%Y%-
z<xnl2O@mTVdf^01>?VzP5zA5~W9fNLQosgRWWNfMaPP>W(;r_-{ZSb`!~P4JXx_?5
zV1dVlLk@b+N&Xx5!ii*&_~u6|)^*UnQ;$P&|D`ri+PnjCggRv&69?x5RZSfDN&S&R
z1l@yA@6Y!W&!~c7NEYh<h=RLjbS*-c{lL!OE`#$`dx2x43tfjsbvI5y)FJYI?YHW4
z0>9jn>*I!m%c6-y*R<ShJ<iL)&)XxOc$#JU)t#zew$Z@+c+hpoQ^rF79oG`iS@AD7
zc-zW5P7CctJ%8~h)dt%4J@KM<UqT5sTp~k#zlmF=W<r*)YR$V?<11`7z?mRo{No5w
zduhY9u%=zdJCH5(_mph_jn&5Nk&*ULEd|yhR6<9%W{EDyHx*$hA;Pu#^Xy-nCv)?y
z9UlYvvr8_%H&*?<ls$ezEzZ`?T&3g3@E3b0Z=fMp7UPJYNgmDeWs4i;a`hKGa<4DE
z)|hin88r?&#b`g$78WpTBJ#7JMIk&e_lokytW+DpI4hXpdX^iSOvyHD3070CUHg%>
zJ1NkQ)Qn`c#>_nd!KMkh-vr(Uk9?Wxt8uNP8u<RG=%Zw2@CRIaE`3NVK2kDbe6A8!
z%1qYpTTLE5d+PcI#`B7WO3YSA{nr3_PC?v%Q9Dz0RAbH<vW}AMyf8zn8d)swt~D#G
z8rsH^0Dd8a0XRGil|9*r=$<L2h^R(aVc%+c@&ba5zQ~-G<We{Aa04Dl$r7-K@6$~%
zFHi^~4Qcn?F;WYTpFVKD0$l5|_f~SJ&A$MHpc&7?X)+B@QO@SG;pP2v;FzRZYhzy9
z5@Pnw%B$^~j@J{B=}XL}r9&p;+B==ZAaV7xOc<A~1vGN0bjh8Pw?|;sAobQUeL&)~
zX2km3M9^8d6p>4PwY9d&tU1eJdLI5C5ENOtTk-^kVl6QH-S*iT{i6OSG~cbDI&oA{
zl8xt)x}HGl(tpkg%0dDZDD_>=xKPNNr0Kgyy6xQSt_seW1FaOzbldiE{-yoGJJ+ic
z#-AKLWZjX6%hu01ezu+2xr5mowck!y+iA>Ie2+<OPGDA)gK}o3q{QAh1deHW5_T+5
z-}w_HcR19tGoP2!+?C(Ot<%$7io;;OSzum2OV+6%<6gyfNSj={pi?DPrDuOFE#^#6
zm3iqSywT#0i2T*@6Qm2`)Yz!>;p3IZ!;p*_J_uJzi<!r1b2QYA@8Qs4yyWyw1XH@p
zXZ-4W*tK|`ywaKHkQchWYqvh7ITQFZhpZLEhhDptrONb)eu*Ro{nbOgsh&)Re1Nno
z;SlZKw&GV!tx|Z7y`x%l-!6sZcGrQ1T5i~vy4f28EoV+`P-JuZP|fInbKbi@VZ5Jb
z6usKmkOzJ#EYfv*Hp-NhQ%t*(rzkI@yD~B{N;x6K`-lC>Qlxn)hpB>!)t1if)RD%v
zVlM0aC*7hOWJAF|o%FNSnDUN{Ls2XE%%eX|`l20Q1Ufxr%xyk0?TYyQ`{NK{of^Ny
zw8zL=_xiz>^G>;<aY{cJQf_3|1$JM!P2;cXJ*;1|(GLWP9fj*~lrB6W4W1Cdxj%(Z
zVf9L)ZZIQRVfE_lbYD<F_m?n;UTeS|HnmM|p<?PNiJoXv+#*Uvv6W_7VFzzmQ<DgY
z;n}4sC9pJNyJyDu`1zO2Q$O(837jV0W&uOuWU!%9p7I@3bs>4@-7jyGi&mS!0USeH
zz~9~G<Fb#*sD<apOU67v6t^-3T<oJL9DE^l>HB1&KBOGGH+Sm}iKz$UyP;T^OAY2@
z<2=IG(UC*XJmflFB!>&~NiugR`xjf@{bDN1Dp9l_jnDe-gv>k9JXx^kKXk~QdTyE}
zPyO9hnLORet0aF=2Qr%=>`HX$dP2M)LVA66FR#tfavrW5D)Q|)Eob@KcoI`=uLSiK
zO6V5I7zA{cautrfi%I0ta~AuZu!IugQ$P!5g{teOl|}{fE7gWEzCy9Ny)T{ZFSI8a
zvc$O3Z|yWm)YgVho@Y}YqC+EBx<}Owt8;?cT}=@0qKLfadWqX7(E|Q&FZbV4yPB}D
z;^sqeEtB&aBkG>Ja7!cq{aneLBY~NjN;a+*W-nI9FU2|H<&9?eI$ISNapZ$d=!z;S
zU&Sniu+7gM%m3BrNEQc})~=yM+>%GkXI=SmyucoY+Hy6}4j2zqTOHwlDSNdJE4U}E
zo*G(Toct6jYE|G&;Y}UO&ZtR0Df7fxn6cmY8`3;Qc}X}%ENF=@7~wH<kC39=CU2$S
zGmgs&ZZ&!PRgfNUE=^g5KN}s4>Eu0Xa8l-&^958xSmu<>5ol!~nM~wS)PA0Ijo7iq
zG~x1XI&I$^;-D~)nX*T3OQ169tFRBZIe#mKdxi(?R{24JIbhNv?GepgBqBU}gXoYt
zP_5hfPQhht7RU8B;G0LI6zhn6jGWK2Q=+nyrcZ3EQ?I`D+x%UF4OS{Ht1CRQPfiH9
zTKi~t3~9G23r>IAWY>^1XCAd%G2&!S%!cmxY|~aScfa#h{=7baW~gxgcXZC1l7bGS
z&905Idbda#Gqb5?gq_oL<#o(jsr<30s!QrshmKlZT#pTilj=LsMqodv(OR|JAxA3i
z<I1Ni5!rOM=z0N|?cM$)s(^YX>@E$dQsdI5DP}rmUDX{2*2xT21BZ(kf<IA35Rlce
zj5eSk!BCaBRJm<mXIZSSqVQK0+f{$|c<BfHH)qe3$>fk1`7-zT@1W*nhnpMIwQvhQ
z!@VQ({(_U-pd5ZSR&r^_y2GozH>q>rLINeF??n+(EiMOSnwLtyEyqi_22g$~3iP3e
zNrA8S%2`R~vAJEki+jY%8`_ebf#pIAL}i}PZ-iq*%VxPG<9oZgP^t6;7zcD5tmDFd
zC%zycZD_+T?xW@V$hE0qdHgqq2ok#Kz3C6=l3a3V`SERoloa8L2m5;D*$uoL_DvjT
zvTx7p&pC^!lk>{t7%8!a-h8$xd2wcQ5LlPY{6R>JFsGw;!;D0Etipm$JXE`cFiXhl
zR+rEFdHM8+v21msM2nWvwY5a-WY4OW;N+~K?FVAKRB`L&dd}VyF8!vMoc*7=o1%eb
za>cK9zG@DxJz<o6{?7;*ccd!&Cyo{Z%D4QP^v|yzjJ|t@LbI3f&d1J5%}T$y@H9<U
ztK|kW{_itc9)rb}qbrUw`mTb}`=^VZy)xRXAod1aJzT4n_ft1SYiaRwdVi01-41Sy
z5S}PeAK0YoP!=J{SD~oiXcvV)cH(<~YV1`^dP;xoOFe9kE}R{o?EWnfG0HCNO6Fbu
z64m1_iE^ujtU}R|rR63xniQVM%VkoO(%H-Ft1Vb}Rb<B$Fy5hMi)EH%oQk37`A-)!
z6CSGEmCgRBwtsPLjLtF3$u};&pY%zL&cRM#tvvBE;#7ztR|lcCP;NUT!LPq1Hu3K{
z5!L<07JrBXDw<i7Lh<hX??GET-?paDv1BoE!>*w(Mh7};&GLeE-{c+Nco~6s)*{w2
zPY2%4U7wvM&A=(m&mZ>O^1XTqi+>gO@q7!l^i$_}%o$OHyRPkriwpzv8YuZX4_@=~
zQ{<k6nfagh6*%?YDQAmmAeH!gAL=cSU(FXvvse8~RJ?^!Xp&IslSh@y%cnWo<h;47
zYOv%Smy>z)YZYFUjJt`lrw=TUGIUNk362y`?Q_^RCOU1S)(LR2wkssMJELtSox~yw
zHt{9xQ?h-$7g*IXzPkt&ftqs;ROxQos#@!hL~Jf<$xRm+nF1Hn!?)#wVkFgWpWXk@
zK5_RnMtOEuZ6EMxd=AVY)qnw~2AQ;L@9Bp~w?(U_hkl<Y5M-_wJsIddJ9c&YeFq<m
z1D1A8L^2PVBy?Y5I$f608l4OcbsjQBDl8BeV{z{&ZI0Rp?Cjyy4cx0d&gWJsB^>+a
zsLYU+mPv|o8sv;8+U&vpIce9wd-NTnztopwh6m<a4+xEM>-ARTTX{oMkD_bhrFmc{
z#J9^j-XtqO*}DxEfkQSD9>PtK;C*3K2}K&4!*XNzqB)X#Y_{ErelT362O|C2VOsw5
z9YV6WHFwHG8;O9rZk}=dC-qNQr(6y^xx;gUE$VpS#eJa`0cl~5H6AB_Xk8lJBvn+w
zIGXE{6@TZ@D#Y_*L15&<i8!R{&G`(0Xx*l$g4`%{ZbwTtWgX3-zcZP6w#$4CO+-R3
zr>&+%b9_{K7+d~zp~vL#A!Q5Itt<50x!SuprvA?ZL>FT6E_`iuPR-u#K|xd$*Z5iK
zMmE}6utzdv0a(U${--~bVWRS;7JBP;c>Aj&CnK%QBQ1FlerD=mlBNE+i~6Rzg#xE-
zUr%$kIh_1tdh?Vr;uwohy^dE}6+&wl&(;3fjsELzRr)#+V*P}1dnCfVZYx2;O7?vr
zwo$I`8zwrp51iDKTG}fQKE^R>T;~&}%@#xuon5hcVvjrqV(x!hiseK)UMeO~lPB90
zq7QTXoR3t0m|8w(!@yI%9=KpECa-nl+*u`oF8$|^f*oi1hcX;XIBY|nx&De2uGJIK
zYK}Pj=iXV{W-qImpMUQCNR2MwzxM(<7HV^)*XtJcD_A3gEUY%gMR_sG<a4#=^wx|E
zH-g%V<Zk<S)?r)k#N}m0rPU0UvyLp*{Z@u--IVA=xpRIBV>C`iFnQg|70yCFP;NZ!
zb=HTxP*1NeZdNpzV9G=l+zTxCH2teHWRg$>y&9yI>U*}~@hE9VH1R^qETPU_>gGDi
z>;zA5BWKgKv!#2JvI;YuH7m&31$cXpt{>{h>+5Wt-?j<u0w{t#Ea~<!leARL3Krc~
zV)!rJ37(?#hPldRu@hjx7xxjlg__$DGH+>(o?lV^aJI4wHhTIk6_(EZ-kf#ifcEB9
zy;`Hk8(T|s_2=WO+&+Erk9|cc6qvkC@${LFs}U9K{L=iYx~4<D?&>a*RN1l_`tel~
zo+S=S`j`PcP20hb0AE5n0V4%GQIE*^>5jFXURkt-xXMKdq9V97|1~xVbtmL+L|R^7
zC923xg2p*Y1&PEi#L`;HyDG|VehDmzltCWPn0c%$PWw~CRF#pF5;`1W+y477hgP6U
z6I+HIhukQ*6=EY+e5)9J+_C|S%Sq5N6Q2=1C?VsJn{YXof|2B8D(AOTUS8O0<6~~@
zS1C+MPgJ|8o;>p=UX`b@_^yxMm``)<B=U<s_ey($Nv8sY;{<m=hP2*?Nu~iuV2fu^
z>;cpW;AEn0m$S^|@zu^c<B^=&7FzO6PCe{prI!g;++zqL`$aN)y=y<+<jVbEP;l;;
zJjcZ%SrijvSCaF9<4Tq!@4m1@S(m+IUL?dnxm8-let5F6#KF8vfP-ge>*w^IkXu4H
zmbOVXmt5-`x%W+9rdlkULwLj3TR$xIqrhvYvnb8RFD~0hU66T_7JRn|DzS__aPfi*
zo0*bnt^WYLfV{SyiyTu?WM^ijgTP$24gWwr>u$i*sOFrVJ>eV#oA*1YLIl|*g`%l!
z3(+kKMB_XYE&AtFo?fKa14+B!!xRgCNOcri7<>C7yBeA<cl5#ip&bszlG)pGP`N7>
zlQ(QsHQ(?rn?e>Nq1)!yAbH;*?0~U`iTvJ3-qYMa1fcD)9aF|?12*wgHW%l$qh9}o
zKt8ukKBz$pr(k+J?N+X9D~CgSPIpRHy0!1MZ&b{O-h#+fei`dJAq%xuGTVQ~0AhI9
z4{r0k-Mi8w{CL+d<dvzd{;qL|r8fgJ)QoUK(LfF$9%p#f+8R2M96HW>Wy5G70TW@Y
zYCu_z4v?R@8k4r;@w=;uqwC%6?2N7hYs<p5h7nHU#X1gq{SAA{m!o)kWg;YQb#W$i
z?cu!o_VnoQx!Kr^Cr%QnmXkuOMiCSe<i1_pseJL!TS9f$9>WvPj$Xguc)e<+51tWX
zJQC3eDY(%WwUQu*{SvFA?{q@mwCB5B^u@P)_=o2k+WDfnVJ=Y4uUVnk{R$hImo<7>
z(R=?~;Fd`9DmLMM%xiN4aXURy>*8agEZN6dE?Z_o2Hg@?pjh*|Q(8hq&BM%kMgq<E
zX<9)1xbcnjWiLm6t=o(h$=GucN6X$9#*kxQW01NtZg&M*ic3m(p$~rCK+?u;TBK6X
zaSod{it3&V<O@WQZTIN2Q`bDJz>eZ5i**Pu!l9y!f|V<nCo4QqY3OJHVuN?!spI3p
zK#41NDEgA3Q^c=aIHwmf{AV;0$rHn*UElof(bi}g-QkR%ZZuY6!OHF*JQOl;F4MK(
z54JM8h#sh+l%6pAHXm+r=>S&*fI0-oI>l^_`N$qRLVhl*Wcma)KCdel_hw=$*;=N|
zFj0rQLFA)QZPmU%ntTyo6Wkftsb_F-kn*bHm*?GI5rniW32TpENCmt8Z?gsLMw{BB
z|1~~#c`B+JB3eN`VYY|M;}e06apOF>P5oU<<fSE%$i1&NRbmw3&oM4=;MHnGBEwWc
zFD?Bz1B>m7gmQY$B#qWtb-bvoJ8O>?n6)I<g=D3w_lZ)sTOVkSw|V?N)YlbtpmjbG
zl}j`8NYbQiP)OUyMhmJWDA$suW-xe}eKG?olv(AALD}c{BWou@9V=!eGV)TxQB}4;
zKq8G66P=g2_o_2uJS?E=ZFymP=};!$-w%T*k;Q2xrb2ODpF|9eGjLVy@Flf_@`rrx
zv`OyccQ8})sT<diNe&x0m>5)EF*ozu1@^Nl!$bSU0_I%i-lfzoj)&1pH6ONDt~Q;5
z9I>BoMb{PkGg1mtEh}Ms=>uJ<Dh9hhOyLHJ#HF5;N3te1w$P`EOp|Jk)dNVoT+jtO
zqrcF`nd+n4@rd&-T?)ecn6kFqnk=&qdSH0fgsr=MFTXwbAfO|<Bvr=OEkdNPcE~pm
z8e8w6ZY`p3XmO2K8pe%QLsLqmA%W2G_V*UVKLajcAfRj2dLEx_T~7SOayXr)c!zg6
z%7~KnAm<Xym^M%+`sanW&0)gFg<jX3*VSHfzaGaH34}TeJ_$1xeh_YMBmOg3Ly7;Q
z;cp`6Y+*xJw4_|%!P;WTJ%1x@&T`>u-skMTzfYC(#rVsFOnyz$C86l?TGmFp)-TSt
zj6&%Cm;-JK-=~a1xjs4SdJfa$iX=x5uc8Fx%N3AJzQM?Z$w&xPB|B5GlA|f|-9g=c
zqaLq$w+~hM&zlMvKC35FzGs<q)5Sz{Mi1pi&<_aZ4{~$L+ltud!YI=W)u#&m;euIB
z!mkLCtB!>?ifpoPn%|(RM?alwG7X@%{_*?Ei*G%CGJfhAKppZ^EH`5WiLcm^6M9cg
zbTx_=dzW6HNoii<sR*8&;o%eF;LA#daoRf7${S~^d$n~oaiTkn;#v$hIUKfan<zy$
z1mTD1g2BIv(tyxXq5kYs{vQ|=U7>bxQm$B5t|;#vvuzvoFXd^8E!CvUSdRh3A_;Qy
zf_AC)g>t&dy=L_0MnH|j`EPZ6>k5uJe6ic5HAwsNz1w!Tss`!bd{PV+FA4}gOPJd$
z@TjHBA=}P*_?Mg2z6hBiZ8KLc`{N&D-iDttR}z+cElSXN{qn}I^lL(`fv>_PK5?Zk
zRxJu`oea)&Yi4Kd43>Q-^O;_!p7?md^t0WDY>nxA?GuL{gbTfw*~j88>^yQ!ieAaT
z;6TB_xFBbwn#tGLnSB@!$EWm&OA$ZoQ#?}TXNddS9&*y{xIBUZyomq&9Chqxs9zk8
zexN96++MeCeF3xg+Y+R&fPKQsl4%8dAnmi<82s&m#MO$#hND;|QK`r33x#9oB<l62
z>2CUc_1!36zuBJNqg}^LO74<lyR%D48?$#8tQ4L)Y=N?2Uo0%?%j(v&vODc#BGpM?
zKO~n#YGt!U_5-i(ie39Au=sSP4rWBJtjABXx99;9n3!|fxzi*Pr87mBR_N-4Vs+)n
zR7QP3;I^w!OCT+u@m(y`lkl{var)stJYfhit*j15JOp0JAV&)<-Vj}-9FBHwi(FLv
zjJ&STk&7}S-tQM!b~e|BAkYuo>W3-_rY9a{xNr)YDanY({bZvr*>eWlj-WY?kPeFO
zdx22!UjBI8U~TH``9nE9fpDcmJJys<PQH!9_OmNB<U!mw(jackZ$fl}b-k+;k~#0s
z79bqTr-t{^qcY#m{;FC-WkqwUeC{{CKJ&|<{PsGD?aZiI^UztVWgP)WCWvR%{1^He
zr5&vTY=!3zdvk;ihgjVIB>W#=axtrkmYjSwr@hUx;=}IS<w6VU4I&qxpB`B2YT7IR
zFrv|+*Wf~Hyy$YWs(#)jRmVChk5A=6FSayBx4G4>$(SuB+p+4kN2a4?`g9WMPJ``g
zgQD9K$53HiP1;9<TfZ6U&!PNB0ltv`Nx|Qz&~FWcKgt0~^kBQYi&1DSWG(sETVig0
zni$XMZwk7<J9cp~%O>*Z2mxIu{zqU1K^K7qsSTKXoS8qSj&VAj%o(UB@P=DlVuKC;
zc~=Gw5pc{B&^f=@EXic@1T_$1A%kZTq_Ezb5lv5)(8Dg)@v(EqxSxITNRDO7BMV~E
zx-y@$vyvpPrizn74xAQUnh_XV`%qPdUP~UT6B%2)dh>vsk&v^o3JJbq5(^TnNDF7^
zU+0tJui8b%%J1BgjHtgU2s$2)7h#n~>0FO_(EjrR+2f~$25!y^;E70%h=&;K*(r`z
z$TI(mHkTE-)M1EcMLa^P{-cDvY@KZ04<W0E=@Y-@M=TaQAGtsyf@dBiF39&t-#_Lp
zl~1g1eC-9zgBF%n%FEu9SJm{U<SAv<sqC%h#t8m^IsN9?J8bdx$o*)K0KQ=5$!qyM
z#fWFduelb21J*=4UIiR@d?1{gQ`JWE4WvwvZ0aaVmFH8QN2-LzhNqc~d?>Q{0xNfo
zmXDFcj0w(8J5Oh4a7qoS4^`F&{|aNeW?JD<yz~!P9DloKZ7XMIz<myv28FULRQSD;
z^cs2JOEasBU9XNbM5oQXT`ah9J^0W7pn?F<aU1Tl{}n8=1TbZ~%f0#G)z&O?37wt$
zqnMn=$c+YlO3F;PNA_;quhxAaUh}9#Nl+aC1Uk!`Jh`537x$aA#f&u2tC|M|5B$I5
z!LBJ=m72a4(&{Nsx>k2Wp>-AUh?wj@bq$uBokL=@9GvmkG#zEN{T18oIhbY;xu_g|
zges}-D3L(U-?R;v?F3TUh`^VmV+C(V=zi_8jC+hK>W`V)aX76jheQ3T4Jvmr;5R%p
zV1@Mo1>(k~HYxwQd~6K~Fldj|?(>xI3Gn2-(!$O;)qu+I<u!09mHsL6gUz<ix(_jn
z8^a%fF6Zwsw5rhY%5Vt(ns@w<VdvaHzInwCymkQOtJL<l1exFsN4`IYD+|c<tL?ly
z@1CY6e^guzrRtD>OZu*0Mce$k8nfuv+vUX@4w75hQa#uHG9fL{lsftRp)Sv48>l=D
z(wem@98N@kf68TGq8@xwC5o@ll;dLju|(D$d(wFy7tR9VJ=d!UT}^ztP{U%}zDuO0
zYu^;!y)-fir7xu*F1<(JznfS#XhL0g5xeM{hofE&N{BJl*B(uHuWw<(F*C$pv-o*=
zWbw^kx?cXf3l~zOp#v3_qLQ4`Nz}-pBkrH5_IpRi*y$7w>zZ%UOvGE<6)cqtBmqKK
z?yV4Do$Q@j3W;Oy9c9T+N-u6cmLS|O9SC}_SYZ_3zZ2*#xjDGlc1&O@IFNG>&+$a1
zf+Lrqv@@L~>#RDy_a_Ba3YZ)>n1dgV-kb~U=K+MRNa1dsJ~k0)iROMZ|3%;6&$$XR
zdMd2_)sXU%lo91OZ#1&*?w)p5XYn5%!J+i)B5D@5ahQCJ$6++Y#%fZU{(jud&Tng-
zv*%AaWN8k!5&EdVssLxq+Gff7MRQIh|N0bCbRn$xE}Na5enegu%kOXz`>Q=#QqR3@
zN*S&=y-$S;D_!LkDpIHQRo4~9k1f_pBtNWv%7yp}XEWIyp=k%+ah}W@ED*6T<yi?s
zU0uQC<>!6Q4!G!-63T3TQCE}`<bd?&yWfYiDylKqNUPs`JXc&X?cS?h)|Zgr@)2p?
z$}*_%h`ZX+kSl~Od?i~|m3jY7#v!dY)WgqJP%B}#Br4jA+hQLag}~uf{^noUtbI1_
zG(5{KT2gFK;LoG=Qp_owo(!RW#<R>_xsc(PzSA=lRg1bi5qM)z+g3O6f7ZI)2^khK
zyELt@Af?=y^Wc1pASmWlnR{Jf>aGs#=#ahovA}72m~34o%%`Gy9YdA5fYt1kP)=1f
z#{!!~;P*}R<!c$~5p3e$+ps>i@)sa^07wMI9{`8PX$p%vJXc|uRDeh*08WJ}yeiDA
zkZYx1gmJuNvS3g0j?{d~YVj}^6^BG8+54VxcDs=0ztYTPa^CQcpDg`%e^39mgWx5O
z_ZKF^(dH!ugsxx}o(LI?Uf(E@t2!`SO@(-Ej5Z?}YDDknGKQ&J_jS!=qh<3#xz1KS
z;Q3G|)Ek%r84T7_>9CwfbGgb(w-iCjB~L&6pa?BIXLsB1%bazxfbzXzW>iqU<NlFo
z?qI3%Nn5UN1hnrUeG}pjg}RAZyXAQxIv~g1HJqFBSzWj}v10VfPUqfm{t1Pvh<)rL
zGDSJR=}k}ki=!cpXX-`j>#nY-=Jdqx?>ImoL5a)=)boGOn9g}~uszd5qU}3EPWf-`
zo~N2wa)>MX@5$$raIk(Nd_uAJljW7q2j;C4WU4>&^S0jJv{Up5K+DV+7-#j|Ik|pQ
zzjd1*bMf5+pMt5N43AR;z%H2K-VYTQFmB<`)qD4?IXikjPY2>wv=>U}m&t=pj?N7Q
zepxLV`<k`MuW%D`=(*%w>fF8X+7oSq=Y2@snM}RgSANCCv81Cl2hpbq4BTH&{baGF
zQwN4+M>-;HdLpqtCy#&9O5dLAltZ7XVFV<L&o(w`6)g=#$aEQUBW+5jcslRzHStG1
zQf$)fLfQ_${h&FYHTG1bs^mb7Sot=<ZR_}Nrm0;Exh0E>@s~*DWuVY3QebiYhG|{l
z8p<~b84R2I80soL{XxM-#hg;$YEoRt!ZwXO&m*e%MiC=_D6)~El8!<OQok{tf%(Z3
zDZKq+{S6vm+j2e(pB3n@(2C#BEq6F+;#YqKGFaTCP=c>LbjI!zK~JbFzYx(zz@(cD
zY?{fD04ok~m7W8b;J?`JUrWXDN_|scT6R_zP+A;rYEi1NZS)F(9(lcLs1z1kLqE#G
zv18=vfW})TbV_q$Hgh%mXR;Ikpi&)EbF9*K$m>dc*{P2EF+<b4qE4_c5fl)3@H-h%
z<dRug#bq5PZ&L$RWLdpGl{20fbA-giEVDnkw*^LcW9;8Z9FW7QyH!2G@0IqxG#NB2
zuOYW}I?#oefy>LQpJ>SNNm#G4A-@W<SKuM1`ZYXD`0342mu~pE?59%vgiwN(M}K$-
zFo>`bh_n012YsFQ6=$VgmTz-n;n9=Pi(lj06!!`L*!dB~-eJ%E$L76})_OYT)K?ZH
z2)3W&qsJq=%lsd^EgtkW4C{#^nxJ_cYB4=oW*0;+JTR`Q@15WgpDsLwLCA4Uzt!4^
zl2S>ZPPfcYi}Jo5vFZ+Eeu<EIY_3|>aCVz52e0>QLsXGootX2c7*@ZR7r<~`b<JvW
zwxJg&1Y~sxC#AxEB5OT;<B&!(K{s6MMxOvElc;XZH5*Qk$DL&|QaIZEI}oDm+0l&s
zbZFF7@tvq8B%8yz0BF_t%fmd1?#I0U-Zo=M29C5VoQj>&=_=MCFS)p`M3k6Zcgwhy
zF*xY8M0e_f`v9J)O@pA^DTQ$ye;3@ZBBq}bp9O>c!qypaA|_%sma=Z%^ij1|CsQfM
zC(V}lK(TXv#&y$VWvQ=EH1CPSc9;C|yPLB|4Np=DhnBC1yHc<;2@ShMMB$vO=PF8P
zxefvG!*aOtWiC`yEVEvTev4bFF(Bp>vS}wv8Q3;+1eS)&#nMpsXej9<(%d7>3>}h!
z53l2K-p6|XeP#h^c=l87vW&&K$JkPAu22oOU+fTJ9sdWO$khDTSjHNE1&q&C2qT&4
zuwox0weDcopu+&o;DlK{O9zI~htMu<o-{fw^e9-GTaJBLqgPDc$@Lz2VkHy#sUmEH
za^JDwU9#svzJm5*Ne6YH9%h~at8qKEMu)_}Zbg!oUD5^lJkQsNVX?btB@ISBu|l-l
z4vy914V$)Ptq(3695d`Ze|ys07(xH+NdBrr86z?5R&-YTBUi^=NS2!@q=VbVVY}6U
zVDoRvPYs#V{EEF`FUSx}7aAG+oqB~ZOoPOpA4{LN8pg3S3_k}y+%T#|d~Si|xlE0q
z3N&xsy2i5hY|E@#>v|iJ#jU<iqXcUq)p?<Bj+WQ0G37@eAIa*w!g=l-=lfgX7koSN
z486T{sps){lG@hCKa~&n0W3>T*btdg2{?qOat<R8KDBTs(Qp~YF{1qUoBcRdEDc+y
z@cn&}Y=x;1Uzlk59^O$zXY!)X3duR2=rVUnjDX3;FVPs-jV8$Ow%_9o2LPCSs|0+s
zv*`tU+BG)sD9z!^r2k;s>d@}w(HrLJwIS}0gRT!Z|5TV2CdaSc$t2K=C-LMYqSTly
zINX75R-|MA9FQ1~=MbZZO04t@6NX5nrDF-<8tu7R+Ec84YyJ*Ye5Bb11Dl?NFD>S*
zjkcTY?RiT0kP!xulEzZ_O&V)%i&3LPql!`|n|waORT4KaHc2<CGNhD68(yOsW;+fY
zVW~kg#tSnB%gup%NLloo3WW>KNTyeGj5GuuKo00^i{j7GO(f3h=T4gh&Gw0E7u6Yx
z|GEGDH@&c6<3DOl%N%eP(tDC@sgSgh(5B`)7EJKJsfmd>4}giX{gN??GAB3;;l8?Y
za5hQRk5oA8YK9mXT3`d+Gaiq3_)kp(hG38ZaT=KHw-Oey0FDP4VbrXkhyee)D_ZsO
z0A08&HKMf=wv~V&s_HPNhi8ATf(JYQ^6`24bnkz|54Vdh>(B|hCPpo3xoYSa639+O
zOsn}e!e>r=xgTN(D%&#QWIkW(FRsnjx^O=1HWrvMf>8rx!;p6#286xl)QSU5kt5YL
z($Tf-?d%N7zE)AxyP3t<L8DpIMMtR|mQU4Q52h=YMkz#JyIdA6{mc3~<o<gb6sDt=
zK)L0}WN$;M(oiGz8fwa6THw#1LkQ&_Eihalg!Q(Z!y!Sdvvi=~v{(1)vj1`wMwZbO
z{yDeh8M-wYv9Zt@)Ypdg$60P|3^R}J>Y+6f7BB=OvZk)wQ|Ig`tOWg*AE-$}LX%fM
zf(tdWiUFW!IS@m}$A!d~+Q0<%E*aRnWk~WIz$YfQ;MjmLL@%80cIgB{f53DWRHD<8
zcVjb^7(o>#Fn1$L>g46oYg9I7{~92H!9EtB-5Vx^ObkMZ(*S)H(2-79TsleA>)fZg
zvBkaxVBOQ2;`3hF@JvZyT1)zvgacot!IjQ+Kxe_?SrTXl>74yEy;y|SRHlE{hbpGX
z%U@9*El3Ks{v<~=A6HgXXH2;|CTn5wgwA+I5?R}!5l@v)8V3-teA3c7-L0LEg?)f(
zDA6bFp49g5(h<e2cR^)$o>^P8Ob4)upggmHC$|Eoy?qquF{5Wk!K<WpKU8wzZj&~c
z4I6*6A8k#+p=rdtJ|r*)fK>y=m-;38BV<4d))F+;ge|P8V{QQ~(}745S^Q!17$8q(
zr_<o~lpmS>c%0{|-uhR?p8l%7$=uLT7dRU1HOumea1wY9m1<iYVWY5cg=uT10~`*>
zU}{xTch!uI$e<ZX2|rE4b$S7oopbp#`I<v=BzbX4(BklaK{24EuKQ>tEgAj~Tlnug
zbBtWcm}?bPATy1sg&2QcTrNt!@z7gvi<G-jqmoSO-J(29%RaKcsG-4VBYLE<&Hr&$
zFo0*f>#orJ(>b5N!;7zU)m0fj@=2v9#?rygvg_4BlER)7a+6vfb!a*U1KgiE2hA*7
znW1uL-B9P#o?V3F`vhO4UJUgZ$sXgI1_zR^@ADtDjb?yf;P0V;t){1AI|FQMN+k{5
z`_!gK=)1yH3{)`HX+k+;d#RE{62n?!Bm_R{LOsp&YZrBVaogGAKG*)JcZeEAH+dki
zgl;$jcu$ZK_-;GDX>xaL^J$0K(Aa@U+Aj1e%$h#{JY0@lcYzU`Uaw=keEsm#WKAPZ
zMOTXcQ~&E=tKe7YR*==cL6Y@@XJZn~uH+1jSEL0Sv#x<4-wqCxfd3|l$I?a<r2@Dj
zAKm3Lg0|~l(`+g?mUW)A&ttczbT`5Fuf_*^rzX{%keBEbbVWiEsakjZ)9VXC@a$!B
z6?X&-v(j!8+v?yL1&8y$8Bm<T>DYd~Rhg`+;Nz3gzClI;z#BY0kK}Mn<h9`UZYN*u
zasg$H$UT+zN(*hexJR2uFnl!rwuuBcT42me(PZr2fElw@mNMV~mn~jtXt6FSnCaPs
zMAZ(yf7Z<({VHHXu#i11*Dm$6931@Fb4=^cCg&;(sW7kT|LjZ<hllgd`jKd0IYNh4
zM!gY!jibvjbhpiNtoDr|wh&nHM>8oB>5WO#w&!b9f%Auk&Q=hH??-S!b^fa(%TaW@
zIn{Y8i!`ewlBZyV%1-$<D)d`CCTz&`54g@PoN_u82E+GfN1;;hbJJKA9>s^*2*O+q
z$;glgsFfl@8RkT3kwD(JsEg8PlpZOP`!=ioQxyZ{j3jV)tJ+m2D5?pIx|3pwAAow|
z{|cyJlvnBNg;Wc5{4~>{q~&3y{VPCz%K25n60BjGyY5ijI0%;$WY#D(t-Yn9wEn0K
zMm8w0BF*Dd1p8)kLyVrPn$4b$v$G-%UQj2qD`{+r`Vn%17gzo-D*!m<mxc2ESz~8P
z?eIp0*#8%nNmDhh(;_FY5;+-7+>N9!;wb4_s@Lwyg9QtmitUap(}`#oyD&}b4w+Su
zAk7p;tVaFl9zZVQ7D&q;K+vJp&94imjzPCw|5l1-cib;|&_?>H$V}?+*S1NY887RL
z3?ISb`XWI<Ll~G}luEU%Cs8VBN&P*3jA{68PwB2q<NqcYK-XS)K+>=^VZ|td#m5wk
z)BhV8U_GOFqVRcMQ=VD1^CS=luqP_>sGtwaj~pcFWj0>niC>DP7n&0#`QhrN7`r<Y
zhgT^GJR5GB`)xfEfV_a!9~@WS91|mlgJ<Jo{pfi{2A@_i{;C=PB@23)kZLm`W19>U
zZrtQ5Bo+lh2>p8V<Li;!RZ%f9{z9y7<HuFf2)0c_I%WS=?X9WH-gkbze15I^>rp+%
z&lu>PLP|cKhLvAsHX^FaQ&(Kst*m4^pvdBSfE5M!z^yD$3dir#piAKKnjp4g!P;mD
z5;3&zy=WwY>41}ayz2qRav_^%`v31^s{pD<vRZeHdBY#zGV%YW$Od4E6cz00mX0+5
zj*`yPKvTi4%$w*je#C~uhlx_$n49DWz%=H0xNF5EhVqEbu3}8H+{i=#w>8f(DTKZ6
zA;6Q>kH%Q3J)##B&gso;P=P?k2l#-jZASB6VI-lQciKMP>mikuoi|VGHc7-94ifxE
zw%#2rg5|!7{@cxQ1)F(t5nNFWAhZ}r8k24%Z4qENO*kc=0PyM*^V7c9!Da^%4jSN&
z2DsC^Hx#J<ug4(pG)l&<y9$WCu}vY(P*yNgGuoNn!gIa^iv?Pz<7O(5E2~RncpQ9$
zk|mY%Ndg6WM7yKQ|8<B~)^&kFK@qXozTb2g1eSVGYa<}RuU&|R&1L^HYC+WtV$SU{
zu>R+%_HXsd+_7@28m@ciP(hd`XL~7UbUz0N#q4v|RXyRuY~vKIFR+zvJ85|Iz%`b-
zKIip#(}QKmlD2EHTU#QVC~Iv1*%g!ETYW0gcB-yEuc}J^y*_MOac<*MF+{)SRcj;6
zY@x%4dvp2@mobxfdId$k38F(Xo-&!9;Z^o*ed=r*;vpN5a$A`o(*n=#+rUKM*{uCX
zt(_*Lq<4phl0gGwR+zKot5+?~dX$VBeD)V$Fpq<=N@Th(|Cg1W{v=v8B6nemUP;Da
zu@snGy2<OaL^a?&Ii&(W$@8a=sJ?76(a?{GX9CRXG~KO3%MaIw4RK>*Bw7gxuf0H9
zRhJBe{g~BXTbe+N?!!`8osp0cY)#e14MS8FsM7xb#%%9r<dNnFBIb|1vVHA3!+Juk
z|E=+)VdUWfi5x6bUD8b-_LL+S4HW%gGWW4aWa?z|pp&a?o>Yi-a*X#N?LSSTzW1ni
z{;s9ao)Iwhz{2S$uc+-HjW|$_1-U2Rhn%J6TOI4`e&l&9IPuVEcXGSuwnmu$n?7XZ
zfAN~WS}BInFk-;2(5$j>7RBDijwt}zFQVSWu1?<JRrjIpkU3iGLomY%R-fzBd%5Zx
zf=>!7v{Ip3t=}@a)A5D=Ff6cyY0;TI%FBw{OsFbs10eeO)_)6-P#}kn2kHBxpLyT6
zt?SCsZX`6S{3~FZ{tFQPU5eBN<yzPu6{?_+64>UzQSZ8L*okp`<$3&f2lZ?CX|{sx
zu(FOP^a-B42-Z#jeuvRecWJ%iT1dN3prOBIcMgh(3X`#0#_)AKsi_>CLvV#4BS&j-
z%8p)%_oz6Qen_c%foftmV`576wI@oG5%k=Ro$2f5iW1<nW=wgp%Xe6Q)6J3KJL=Yv
zX;*)C$#~Us@ek_JcH#dh*I<dDE;zxJOR5`6tbc#_75-t$eQ!u=r@pVF0L4y46!W=L
zY|5d0>Z|<xC-t6K5aOY%<P{~vsQO|Ca6o0pVrLtn#{XHe#D$nGK7R@5{Vr#j23!sD
zPQEQ(ws~A5(PCS=L!_v6_Va_Y&)WX7tGFy1^4y6=n*3LFG)}dFEe!<1S(1|9de+uH
z+(RunoW}Z|)jMZ(bys%|9^iS0=|6zFE8Y?NA8A)J_`k@a?~a0R)-;?Ww1KLk1I`mO
z)fJ!N-60?nrXl(qotljE&`}fCEGq`mT;gZ!F!pXCNOP8BYb3xDLp|?IGP-ub>fZn(
zu*7Cv>^yb>3|={);(_y-G#rcThcg?KlZboL68O%~SQES$*Dh7A8MRtIWj4Z*N2mXC
z?NZNM>~VK#UBjGjPEI=F53`3cx7Jvi=I`v=cK0T*-(!63W{*N(;AI13!NDM#1ftK8
z*&e9smQsa!x|e~y#mI!m-%D%|j7EZ%zYX?URn6h8ntxYR-|c6gx*e$r62PQzm0XoV
zf<P|n*_PX?_}=kX>%Jm(SIkPYdqv`PRD}B@Q~j4`bj1yvpB_12rYFK)z&p>o9#&43
zOHR19HwvcwHWhNG1jk;<Ze`$ZGP>zi62u!A_WZ*n2e*Pz_7JFwf*Ube4cu=baBNV2
zVY9I~@E5psvz6dja@Pq9WEebYp|?xW>ca_9MwDQ;%NPeYF%*P*xLK`f+BNFQ2kk5S
zhPz;P$VV?NXSKt4VG3#|3tgyU@K*A_XJTncU|VULQmyz+O@3|OKyQs|jmWAh`YS1v
zwSt%e0{#Hzc=$e<7)<k*e93#Vf`-ba?=o6dJOSp7f35!!Z7DrqIi7CKrkClEL4`+q
zs&%TRVTHHoWM<z(khk_%36M~qrta&d(!iQ&a{Dte3PJA92G>oLeaicr?VQuDB~8^D
zZWd=q%QBO?#N`uD!yX8>E}_u_5_CI8D}EAgCB%>K@>K^XqxtDl05WYVBxZ>dg1p3*
z_Qe`jbQoV4)_}Frl17Oa@l(b6G(4e|olVudLqIS!f5mnzrF&qIPE{b|ZY>93Kz)SZ
z5Fj!w!Pcy0t-w^x41Uu>X?aAQ01}%5T#7f7H@5(SXnMBB4L=A^D3mG*>*-D?xYDL}
zk4!Y++9A_+W}&j)jdJsV0)U{ql;HpN;2EQ~u6hGV9GhlgbZU2+m6yZspC@3%L7cVu
z8GYpU5cl`6q7?-8KUD)x-Lz~5(4jLOIageZJ#<gCos{?{N~~ev$Bt~Y!;Q#%L80a?
zEVV)qfsz>0F(%_(*+3;kem^TuKgWMA79WcdUEHe#Q~r43dM$FYIVK%Hp$J*yrdjn<
zcGeey0i$EN(PfI~@0xyh83T)@ueLJqWGZOYA&4E3A{SQ5wK6Fc8yi6h<)D#wDKkM)
zcIFf=n^7Vk`0m*Pc2-BD-&_+Vp-yAg%OJ_fMtI(=AP6A=M2WsczdXRV;dLRY06MJ-
zTiTb1JYH;;6O@=BDE(lB|5xIpKP+VztQ@@x1J*gpoqgEKMwHldOgRBj1H+P$c_|IY
z(5KG-M0|#EMMzmoX)EEGnjruj>jp-n95;k#jwKP@lD^!z)}4I|ytAduInhq15ePj)
zs=6F#KWVqH;K{Jl8!=w+;mh>A7OxbhA<y|~Q;vs0B8hD2))yD(9@;XBq;;V#t$OO-
z8uCY?&dSgou@Xz%JqG23M5ZMT)d^VZ06E?Yc8$e0un++{_&jwAWb3AvM#RM6AL)*V
z*y+YfS7>nfRuryaH}v^Igy#f+9Usp;N@9G(eEptWT2@2e2)IUcK~jQHxp+KH1|FRy
zg(t+=0f!Xs85#Ner8vwjFgw7ggCHFHpIR84Xp+7E+k8R?OLec`OJ1@^wmNy8hEf1;
z2T$w46Y{2ha&XKfGzAkfqSp+`g2q<k$vTWy-Fq|&O#GTtEOlz^2n|G^aAuj$ho)CJ
z1zxdsW#d_`=Cwox@?4|cSS4w6<_gg@rz*HJ2|Q=4|GGoJttG1oC^7xFtDwvV6f_`+
zN*{sz*yK7SL2~BAy~RP!N8xhm_pJR!geaQ2&Rdvtot+L?yw7{p%_2`pJ1`5=xtiad
zR>|Pn|0alkfzI1I^A|X4=3Lz2{y(rRX><2buL3H(cn6f{-o@de78R<63YEjWbuHl)
zu;o-h039UpNFN@^+bnd`;nCZnWd)Sm@c4kdR=Ie;>ALZji8>fBcBFgVDR!Nl+uBMX
zg53+39)$q+i(PfcZPnTX&OcWcSfubb(g+suCb#q)KY6W@ad8suvL#cK+idz6GOCrd
zKFhJ--}`XioZ2BE@tqQ2^{n8a*%Q~CBu7$ScfOxG7C7*8pBkQEp}-`^=rcy~Q%z|t
z4(izEShS_@y^Z@e#TA4y_;kqMPA@+i(V;!%dF(4nYGHBAOQC5Bpo5$0VWtk(wIRa{
zuaT%r@#(YT$3M$OSyx>c>F>ku;Mds_i1m&!_3JU>G*n3&5ZotjxUHW;iAm$f4Msi1
zzC}IK-}b=ewF$@E>?$_WH42Go;IaJtVgN4Ex2I4{VbNrf{Q72?DFaZF!9qi&C1?Ht
zTiR4T6L?V~W<=m8*TVSj49(u95s_qbx&n7}#fmk!Cd%Q&BLhiO&RMyM39l*SWKBup
zTT1>ErFEL@J4OI=eYd^d9820*gh{+`n0x6jj;AGDJb*62E7EI>p8@j(5yMu^&4!m&
zW*BUv2h}7TI@`n`V=EN^MXA=ebj?ab3<PM?z}Rm7-Il3w^On)vX=HLj;%ud8$xQ`X
zzOJ}fdD`buGsNc%2~;|wNz9_XA?&*0R{E>obGmoYL;d)P?_P@|E`nlwr>2^pZ>Z(p
zjFDH<3-nbrjXU2~7w4MQj2nV8lgO!F=#nduo>1QR)W<zr=2#*~jZAAUw9bLKL84&t
z>@jDrbLd+@wFh7qMCfyTh3Ne-`y|@+q1Iv(7C<1A%jHeVtFPucs6=W#&sSXysG7X#
z>`_UXZ&FmBy*$5ADH@w|>cmt@r4qkWh=lfo=TuF4kz0te$%`is`rJ3n%^%MW#55y|
zp8!BLIoXt+M<FF7>yU*tU#^_{|9Cp@pr*R^YbOwT3%z#)5u`WiO+ZBfl_tHTNE3lj
z6M8R-3J8Lt0xD8OAs9;NB1jRWNJ&EPgdQLyzvJ`H_c6@L<R6APXYaG`eebod#SqIn
z9Us={JZV%qPRA#VTj0?li76;-^eFhxlDpDqjh-$KM7_MI?w&dKAdz~lD=qNl4y?rS
z8mcY3na+W9WkqQPIO)zDcpU-_AZ=j+Tek^*sdGEw^mMV}ibT_0qSkhBqSivD!cMak
zA_+)7?k4^1jrc~eATNB`*c0p=l9NGwfz6t9?JDL6DGz+XAbhIm!lM~SrS50MZSdCg
zL?MP;pAUgRC=6p)ePqVJU4^rRRLtD=N#NI}=E#+&JJk+ST|uvskF-DPivQ}l|N73r
z6JgYL?5%jAK|OYDEtz3A8v_6zp*4FvPjmmeSJi@n-&*i9gp@B@x8gg-(Abwy^B*-1
z$ibN-v~F)7rgc?a?%)R09Xm`wSp|Q3HZR|TQw8(y>9O^q_T>*y_40=kVMfRZoWKN%
za7&Nt44BqyJ5i2iz{2JNRCJE{y}|QqtxLVc-^aY=Cvy8ZMNuuSeKJ%YwGXE=`tV^t
zd2vfm7I_rw)aw=Nzcb&=dCe@XScsh2QQ2eVtt{Fz{-A=&lu6X2^zy_hH3g;flpl==
z(fDi87o+gBy59a@R(Y<waoO97&=f&g8E&@5ipss}tL-LxwP=0ahcprFgota;`%x1Y
zW;dW)GA9tse#m2e_qXH7TUv!wU;Q62%o@Yu)PJGcbE|R<740>e@%x>NtuCp3ec$oP
zWuk&R;bA*_b2~UWY|J+R&ee6O$i;T}L$3OxH#GaNobwKM=@AD&mpBBfH=vm*3a`0v
zETxL;xhUvh$|hgHRPS@<nMxEFP&=zF$04oPlP~>VVU^nw+7%KpWu=9+*GI<=z~{8u
z)f!zlCE|B?3gv|e$9L&lfiC}S7RR#e#fXp5=HYY&{wtLCh_=q_g+EB1he@T?*MLld
zWuVl!B^IcXPxN^WgCxYHY;H`uBpdd&k`b3%&)3NQ2(^I2#V-pz0ig405A#Oj@0)hI
zK5|#iNk?1C(HEj?aots2j<npp>p3S^<c&!VBbqoqds1L}%ha2a-zUzu>}-L?(p;I6
zF&1qql4)a>CU@M`w*+*X=5|D~=IJWq#KrH0*>x%{fqmZI%yct!=BVHyWf`-0+=I2f
zpf+j)9Qlo?<rb28lrSqds&x%!gjzYC4Ze~@u|KGzgjHVTTqZ{M(ogdAW>x*3T|#fY
zs{itP7F*kB{~k3cIj_eK8ox7}|2xM}t5nCE*X$QdyB?o_a~@`%;1wQ)(cFdR#HnL4
zcZY||Z?=_fz3n;-X-rLf^GEPV;bC*PvF9>=YKP9GGBGrs`|Vt7Vk+eF$W9ev_jIF;
z{dT__`r{RG`U9EUx~wOXwu>WOdS~@vRF3(WcEJ@!Zdc^>ZFT9WZEet)UK(vs<`h&2
z=l^R`xRpGn&{KI<lum5*zF#c^Gdxz{@mKEgl$h=^6c~HxuaGMt?r{<++L>&f!p)Z`
zfg)s}h6*yZWfF&0R!yQ)`|}7%d2DRkJ8ju5Gb6FvWZG>nEsMrE-_)&GVf(_Ywhx6*
z@3i4`&a!4&h!?{5t_|PR|9|l{opM0X?+$8V6Wz6}@;u>f`{<EPw7$Mj@2|fl*gb;W
zJ_UDIqExaTFY5Jfy*C6Zk+EoVR^_8p#b%My#^=3w7*e0?fr;1d<aVMa^G1Q$k+XQ{
z_7Qoz)QwVS<s>@5qRW}onLFx0^of%u{0@A4OCXSGz(78$@|)B&t)$il{^l6nKxKiL
zcU1pRJ!C-*pO7d3sr%{(mALu7G%d5>?y?NU+u;{z^095=Bs?gZb@^fFWUgWAVXi+4
zn4a}f+h`MA;6w&0A)YAyxO5-P09^Qgh)sUL4o|_t4mY;jcn5*JQ&yE9_xW9YMOa%D
z^oYqb_qDc9%CmOZ=(JH7&V_`F!Jg#BwYK~eD?b<F<m&y4IrFL>b>K5h_cSIPXrae+
z4%+PUEw*sZ$0|9ZLm#Zb*cn<j4iSC<J}yWmANm1@ZbeqT%$4V|5Bs!QF+QbffYt^W
z(|_|9n!;hCdZzm)Ct7n)>9F(;|GlICBj~6}b>)X`WNaTdmC4!7vUTO;whoCul=1R?
zqU$fRY|g02=0!2D5f=-Y7_?YvUi@KHm93nb`DD-oQ+m;Szuy?o&_8_`v4dOnzmQ5o
zl4u_fe*A0Rk8I7P70S|?g(oU9`o=IZnnwz6Z&px5!-ebKbhbiQ!o$Fa1C2{~mI;lb
z1%+HIZG)X_=~biBuVQc;sX^Cd4VjFi-nG*Wla*l^i91$=1wv_uhT+<E`{g@4rn6Yq
z<Ht9mqnh69<@%G@53(*AR9>7d@K{7c`LnhGOz0Ic`O+u>p1x96S#-jsxc<4DJE^p3
zKY3Lu;~dQC<)m<I1)>EicKO`u`P!|TO0ZjL2Nv^syaGHG;L9`d>j`zSB-c*!h2l(b
zEc;I}E55xYW5e*Pk+xRq&r=(hn?hn1xFb3qP=0vUNb={}n>>~SN?no|uv-Cs<5yWq
zLCve{lzf$?rHM5tOlp4law@UOt{h-><TF27F#0%Av@$P-r-|I0JMPRu;HIK$kkn0z
zGh}v0(~i;@(Xbo&$tDl3f5WF_xrJR3eeBG>*X#ejCwipgPYto_rcX<(ogW6QFgenI
zS;Fh9x%A?#AK<uy;fYsfr(qPwQh`o)fdv?pqpGzPYthxA5qOtBXH4HC;VFF%?c=?7
zp5)Z*iHbE-qIcK#@-8otr2%tMB%30N1>-b!=QZ`_8D&7@Jms*$wH7<UtvW(MmRJuR
z>H|ES+yM<>VsRyyB+2vee)~)Z9f|f_5`_+Wgy_|cpa!g>&7PFZr7zN|UqumXg`WNV
zJCZn*zEFl;O{%3VvIR>&;(ckC)*v?Qv(zlE@ac#60yU0ZpptXXV!!dbjGl1bWuofm
zBGo|xwba!6S_Q5*?iUijk9(Q|Cd<!%(ugG*QYV+GA*V$BIEBn3IDwGzT2qZDCnA$+
z=w4aCUw-0EPW1?^BUHveB!F-S<aNG7u3wKL6D$G&flUkX6{goE95uIKjJNHNB02+6
znxV({x3pT>(HsqbfkPW2%l7zQ^+{8OM`fJE9Er7^|MnoX{;X*)QI@nCM(aS^M)}*u
zD^^TCd~cMUcAX;aq%JSbYZKa?lKk!MTCil@el~{CcY&Z~6r{M>eJAKi9S)S%m>Mey
z9jZ0?syCOi)c)lPI8jS#^Eez%xDBdt>UkTtK}D%3x|nnlwm&aNka<bWT`jZmKgQh6
zr*edGgtyCeZ*0=5$><#SV|h1x90_Ds-p9W(8iYY^vy+4<a;;G<b7KSvirm#Te{Pr7
z@#~v@%I4N#XImt@1v~ek!Ic}uA}kBow0-%CIO$Qbu8l@62u*zxp}3QJXI>0$`Ebtt
z3eOrphV4?^g2Vt~m8`;wv)?HwAnYb^F&_M$n8OGQGj6vRrqA5BOEsLtj@&P>#z%4Q
z$AiD3?c#()jM<~`OSY%VK+Ll?@i<Kw9tH6-gK7j<H-yYz_`vHbSj(Nc{;P=Y<!imj
zR$JE)*R)EPJ7sObEzc)2+PGD34Rswsp>k*GmzZneYS_~2A!OMm(2XU0!0|$lq&TH-
zn8;zXzt2b8kkZiZI~5ji-f!UE+vvQO+EjVv4T9gW^()65gv58RYe$OEq~KTX^4>Yx
zQ&SI2wfE{ew!&aOyLOKLdl<Nswno;z)6Px_XP<4g_<Ss|5kO(T8ls>83MT0U)dc(X
zPmy@`eL)_D0&IbYy*ohH4%Gppcrk4Z9B6d5`9;`9BU9=yY4Z|OfIJ}XJ?AG~n}}FR
z`5tdeV?*2=Ul6GA&0-!uV?rrH=sorB>Y#37@9}H?*2I1mBLS!D+vBfC$$NNqQ5L(V
zrwv?ki6i6koXv^|n(00HX*Mz($ZJWIKY+H4Gq+=c(9HP|IR_gZ4-5kq6l8OA^dmnE
z7@BxEIpAX}GdaOIA8+fb_2XRLEfge{YP`f)r<rt?BY7uN9Ax|wqoZ(-B}PFOvq$Hi
zs+(ePp+MWC7rOQxSEw}ZH|;;<W94`e(5QV~ektzk%r=uL)JCQ><1@JHd^=RWt_rGe
zdM!<93T#qYX7#SyjByzH`s=mcO^TBGTa6f9Rn-v$JZSCX-w3~Wia$4%gmmYiuVzu}
zJ=6g`p^xUoTtHUe9-T!S?uuRGZ=&qXk`octyMh--t$?R*yidM76m#Xu4O>s$xBZO^
zRl^1^4r<LM9pui^{tnH`lcDBXJM;LCj4xJ`iK+L4g^Tz=^g_9xq=SN?DOZ5k|FF=4
zEMuEV2J7n?_E$NvwrWZq^X}N-p@tjb;H;&I>z%h_m1TYn3azt$?T@jlr#&X;p!e@C
zY}{W;7f|`Z?Psa98mo-ERqQ-tBc;T;9QrqRSVJd7c2R^G64g3Ro?k&yXpTEJlbi|J
zI|==T@E-G0_jU`D=PxqZ9p^FBRCk0DgDaL=<;2df>dgc2&v2k2)Uv(3f856^i^s5L
zF3#?1Lto8_zY&7#$zK@EKW=O*ih3a~bs6X)9Y*acDzHn@&k?smoz<4KDF(mZ_ZBfT
z(b6cgcd%TCHf)OGnbJwg%mTfLRQhB|6=QY~xP6iV!6RNKsq$rVcFsUvJ7Kcy?KJgn
zcl%U$TC{W=Ll8grh!z9NcoUAx2mQf0FS29QoiMa6YwWeCZ{D5Ur@<==G~2wiiP)s>
zZyw`1#6VpN2*(cpK%nvf%~i%g<xa|=S<K`e>Wf=>EjCe~TN_77(6%wvI5mNH_i~b7
z1b!_amgRixmbjolcFkMf=azy(u`g3)!DR5(v$bse>8qq5swpM`X{V-lxmiFwQ<bmU
z^r@^=uCnC4p3)*04dVs>#!USe^{mr@^w^uFQe;wWY*8IxmwCR~Gr_cansk?Dag1vF
z&mzy}ZpK!&Zh0PyF4Nm^L-a$CL~ex{S8fnvvu%LGqsc0jZ;fu!SI3zQ0N|a^Pr=Bk
zoL{86Khwa<s+15KmzGhhVvYP=`=Wars+z6+^@YKXMnPMD;2@c|4m$4j`HTSN_Ri6X
zYB!B|S)=|ODO2kok%6i}#LD*;J?9$!XlEkb>Sn$|Y%RX=KDX~Ax6yNJ#igjXybhWr
z{@Ai=S;XN0qpk6EGzg!<y#8`BsU9Bv=n?ay*jo+C1jG0ZBs$H8>Rd07Hs}#{y+^+d
zW1>Gi@9t0IHJ~Z^u-sIP@|{hyxp-WHVwdoW=&LC=c?mY{L3E106OPJ)+|{9VQFM~u
zak|oMd*{t=r}BsJd2K%GrBNN#ZWE&k44f4maYxEV;W6^FUNFmVKYNTo@dRq#7$c=E
zpBL5oU>miKZQe26-wU7ZHuh_oC8Wne#OUALd*ybqU>>|~VhJ{<uOAL{C&SGbun^VD
zU$eIIK?u+qFN4XKi&LOLKL-Vss<XM<_E8tiOJh=|*)&&{A7U>XtBY|GK&`>t7lRrP
z^p(@izo{6egIbLGH1+T1PRvQ9z(!ij%yQ5Ig0u}Vy~OK}XvJ@EQBunVLBB&-lskZL
zBJnE7I~1-=*?Ke!%V9+~sZVvhNALSx_RTv(=y#l?;5w{d2wbp-GrEE@hFFPDeq4|z
z7?O>3TtK?aqben_5+K^2Vij(dATJR$3%%VW1yBR`3Z<6xBll!X90N(QDQkJHl(6pi
zL3ljvPD<8$tOT{Ww2CfG!TX$o7K*E#lz-wb6d>x{xr4x)Hrw`=Sw2~K3}v&CV5R*^
zJ?Jo>Cj-$-Xm)(v;fb(tX>BZ-Z%dzVV?^<IQr=18{7TZokoeH_Qhf6&octu=JHIUT
zS}q!YvI7SBL$$RIp6dugy3>Jm{fkZ{!;dSS^=)kS=F>sp^UuEJ+|e_uquB>Cr7m4~
zQ~$8n&InRT(Sr+Lx*8%m9dNh8Ul=Q*pQ}}wi!N4I5gMi0&Y{0Z!QtU44GoR>7orqO
zhOv$cMS;<vr-u2^;P5K6F;^Tbf2QU@*B+ETn$ua9u2p~&T=&e|Bov9@oa4NiizphV
zF1YrD#Hk^`&x}P7B;S^Gc<|-J@1LBdT9OXY>`#Z3uM~k(4U+8W`n(4QT?J*d553z{
z4T`{t?O#u0nfUYwCXo2mkWY8G?Dk<GgYSNxqi)&nH7MWK7?$KsUy0D5`F^a2tr<XA
zp=3%+DNp?Z5<S9|wfi=Tl-Rmgh(5+_wVJB|oS5TlpUIHR0ma#3cji4b>@%BhHx}_y
zYDNc!DJIMdnpF8_O>sxS(&XdnwdPp5hd>kdHkvy67e|cSdQW(`-}oG6UD)Aa;zMnn
zu4Hm)r1n+txnxliAtK!?q)J2Kp{`PQ5)JF8UmeC9aP@an1m#R*!HqD~8a^jZ>Hx^>
z&Y9kX<S38iHrCFTrY4HAx<6F+uWO6Cv4dB5((sa-NfX1W2FWf&x+dxy7wq4B-}_s-
zrG8OshgssRCmN5u|Dxe~|BHe}<v^N{b!%AK{dbZ+NA=pi%@fVVu?K+qi*ReF1$Qf8
zC-v!Z$_c7@=bzu`_Rny64cl`+l9>oCKUyHF;#@<6N>l*EvRHMH2@+QvH|4+C>7vH?
z88Lkda$}b<cyd02?vQw*K>Y~8OWqj%!eQci?|#v`YbUlx91A8IciJn9Y?3I0mG0Fp
zRq<jHXzA(1ML1L@TA)`F82oRR61?d(=*x2S`POOew-JKsD~a-I9R3I*<+WrEOD6AK
z2`iQ%vX`_6__Hoy*s8)ye=WF|S%!w(*f3WZ`!Z-g-eSm>R6@;gr>;!p)hRg;JPfv?
zVvWD>LY06k6MS*k)T?O?EoN9r%wwUTT_uQg-2gvLD(uBQypZ6m15Yx<6~=Ar?R#F@
z7p4{`J_VAJ^%5<eDb!!Xe<t7IZOb(&x$OGdt*d;7mg(7BVReKn2YY%_&7MTP2sjt?
zcozV9fKyF|eQ6r;AdR<|WZ7tU(2M(`?N@5x`OwFV60JUfu);0&j;{;3G;7bJ4&ex5
zr@g~4CV$)T17*sdVVg(mXIe^MCi4}y8PJDinh@MovFwtzM1@x%X|{2%n|~RlY`X1L
z6~=su?bHB=5MJL?<{>t0SSxzz<{b+>BnX56t1mbE2Yh*Wc|)Ne8zl7yHd0LkWua4b
zb<30BXK0`W`6gX5gA~*my@+oGe@^&K&1d%wG^rBv9kdEr64HbiW_3b(4aJ}4<chve
zv!3AS*izf{t@v-kK5OUv8|-*5SFLY<jbHh%MWyO4EGsMg8njn+j<!Hy<;}tp-8pQ(
zHJm7@a<~As;Is(g_9}gM8Qhrq8>VmU`Q`pBKxo7Kc4zFmE06PDoFsSfTPr)S--x68
zh)~}+uGt;{At7v<<Zs`FA-5S|UuX7Rt`VMy`F&Z7c{Szgyde;Bw%bZcx*(3`XqyFs
z6&d4q+^&lp3yn1Q{_#v9ii7GeGn}fNMn%0uR(g3;CvOf#v83i?ElukXhxi*zKKJij
zxnFe!g`6$)ez%A2@mvsTDtQsI_>#CFn%Jh5nyC3>V5Bi}l9;uJ(sa7h)orMDVLP66
ztQ>6=BUsX@FgR5-H+Jl>*=2el@YvltJBzZN8+&AzIv|aYqY08!+uA^z^m{uQ`ua2v
zxyx_YWTdguI)phI7v7FP+i846=DcTPS*1DqES`_{zL$VXB&m^|ccA#e4{_R(<Ne>4
zAX=Qt92f!P2A)o#o@W_SZ07XQKbSBttI}?Xv3-{c?nZ~UMzT22vSgy4R(DzSJ{*}l
zEgGWVu*pbYm=m*arL|MumnqU(&LIqhAHp-<1}NFDERpn3t&gsz%wK4)*UrY$gz9`I
ze*$Q*FuRKj{=)KPLT>3}hccE&&Ijyh!<K)0#5t{>s9pZ9P+I3>sSEq)yA)80F57T~
zxZXwd0g~$8B#~O5_Q~W;%nXRLe97B22ZQ_Q2*&<=F3j0E65YFp`N^h0=p};@)KL50
zas%W8j|T-5IWkIB{mTZ!g8V~kFfQ>R>Zt|`{LLcOTJKe>ig@aZPuisbs`{hWei-4J
zZ8bZ2)FOR4?LP^F(^pgH9kR=KdJX{b1Rorzzqo9DzK^^<G0|Q^^^l^$!pDWMnXr{$
z;?hM!gmfes+-z6PXsSa%stQ5ugcatXOxa(n6uYGRDGA!tabxmaZo64wU<GQ?*<ONa
zf#~}?E&~gGsUc(q3ue_Po!0_L_zY*ZXGyw^Xyy2Y=UH&4IS5E4NnKxvGvI6CSP-Al
zQP0?3H4Sx)R^<<cZIJ#>t<DUe{<`Z*vjYeW-WEzgFb;$<Go!iv_@o4lgf^LfyUnp)
zMkPQIGdccLRzb|anTI`vu<RU~&5#@XPei1sGtKCGkrZER!;^1>V7pSi(N|>_AN0KL
zC0w|s<wM5mgYJsSDJJ!6&5TBiQ9z_GSRzNM@RhuOR5~=Sn^>B8R=er52IL5b<LDSg
zB6Z>+0#^9_AYM?Pt9BFuoAf<^D8iM=wuHa&{s@C-6}beyU~t!Ql3`rfpiO5o9K>R#
zVM7(uxitjedh+?0qTg5>yH@4GJoT8Kt!lMrD^iNa<Z}A5OyNTFjqcN1Q)Ge&C_p@z
z2C9EVr7^5uf}9z9@k7C@I4~uHJ(qT|;k(#3jWVNYZ5BSYUl<|>;!5teNI@b?L~88_
zC}l$BJn^HtNYQj9NQJf_7^}jiixy+Z5mNDMAa~KSuP5kv`Qd+BwRI@?rYXB+q{`%<
zn76$SAR1pqSCeD(R*gP$3OT-D9GM%(j|14b#V18F?vv-E_>}D4^<T+Z4G*vOiffxk
ztD?YKEr9V|PIms`q=)EGc47iareTuCsp)ak?v&Ouc%mds7gg6`ZSk-#{wzS$4BLJb
zD-l{g78%K*bF#Jl>8w%nZBk6r_I3=Jr1d^rw*AjqF{=IdU)O>31-6HVKrVnx?BPx}
zXaqIb=gs4USa3R;#w1p!pY-@bX#ArtAQRGZ2rPNQGtVJ3G}T^D#p!cna}?7@wE@+*
zuF}H=c5%re!mSLH6wz}i$wS#e&NwsP-+m{Ijyo(vqQLuSy>Q$_RRJ;DU6`15pZbMu
z+xIs`L1=h-3vg2C*8=o)%J=Dd_hn5IQC62?qpt;I*gf3|S{t)zl7G_y`yb1B!Rhmo
z6F!j|!C~U4ufPb>ZUgV`pqafjGhgR@T77+Ra827?)s@<!MN}vV2GvJ1Du6d<pGaq&
z#~3LVE{ft0ghAVq+-~r!BMA;F?JQ6%u>rCyk=1(y`l)J_6Qe`?F+phU4p_~^Z3*xH
zvz=C2wlomBUn$HZ(i%n9&&e_JYXoW##alq+Oa<oLkCh+AHG+I5F6FzptdUBwbRzy+
z-@>g!IU7EHY%TV~f!;$j)+yChV5+36-5uEji6YU<liNFy(_X8rNLTJt#PmJp>(>oY
zXIS2@3K@PZ$O801K_`)#r0vnJZ!GGsb}%P!8GO4|!Gp!0o?B8stzE9nao2R2{7A-?
z;njfjfkMrG+<NnMrJGKcMJbOkWQQo&!(7mju}_9<sowtapj}BZ2|S@F3=$u6o0}Y_
z%#B;~lOTgKK_B>q<b|9=Se+_z*2cN%<H2r*LPoE}6+Hg-kp$7;k;*PA5<zan&N@LD
zA;3}pjTyhCgda_K%dKBiA++ei+y~eoM)A%oGqnj5oyz&L>6>Eu@3Yr^ma64bg4l5{
zeJ$b~NLzaLCj`NH*SR1ug&AM|ibZ)})>N&yI%S^b`CTdn-98MRaF8Nl^X^PAtJDN;
zf`K~mo03H>28F#XdmImV?>8F@_Cdw@%bH%zlJ{&V-?b?=fbQlm`xhNZ3Rhti3SwWz
z=n8o}jobd+hQ17v5UjNVCHxJif+hVEptG`aKH%c`Ao|7}lZF^~-lXeY3Vi%*X>3XB
zs>tg}R;fo5dhBYR3FRLebtOjSFXp7uUMq!NbDM`)P>9YU#qrrnZs^T6&-a_D37fgh
zDy6RvBONa%(i~HNIh=RwbAHvo5-ZhZy2<Dh*%#IAEQl*aAp9fAbbi@twbxtIxF@Q0
zKdmv{N%HA+x9o8s;e<l9T=Ey=S{?6C)X5V*IsgsluYb<Bcec;YS^!1!z!UbS!8(B=
zOe$yjviC8QyI;$W*1Rw$pp9jf+u`o=cf^w<Ov7ghIYlr~#j1=b`YltNE5b|$&DrzC
zrw=T?NW%e7sH6J5qiqa7&UGU|zfFfzfmvHAOv|ZzL0NY+hkWWxC`|L5e{Xq<%Z5E%
zpf6E0vFqlej5}M83`W%hf>%dFf^kg4r}FhufvRa}6`)HKPF<RqI9zLs3=Z_>K=Tks
zo=3I8F<I>{vV>rL%9)Xjx660AqbUPLD?ZQARwajNkT8Z{$yCqlYM`uCCv&;&BOeU9
z3>+G~0$UJXJX3CRSjxspztSmiTL%em$;+?oD-1bhsdc^fz~%l62!*Dbz5untuq2Dd
z-R29_b0+2pu1TTv4n2`%mXtq!Sy&;y<?IALr;wMK^{~5shY5euQ=i^Mt5Jef#V*uf
zEosEvVN`Vm^vNUmsf5uXV-Q3|f@}<;EwEYw+ueCHEe3+1+^u9Bw*Iu{1)Rh(X1?3m
zsQ>^fX-1helkq=JO54>H_Puz{ci!eOw_W7ixRPR~mB+6pX5d&LTKnR#@sjmNjw4~_
zi;PUl?PSJXk_M?X`1wX4QTsIuUsmPS)$ilon706*<#GP98d~$l?k7)VL7gyS%_YkL
z^zWj+YOZJB?50F%QPEYP;<i0P#?!nBMHVQ`2U)i}1FA=;sQ!)Z9Cz`x(g!YrDZxLU
z$9Hp(^qAy+tADOhi8+&d^D}tzSw+uo|2G9QfO1tJi3us1y^(;!XR8bIvQ@Q$4qcEm
zUT1y^zrI-X=nM59T|ZseXJT0>`|kT@MaI`vLcYkc?ClTddx0LKF9WSuEepQJt!#d|
z%oi(t<LX-@aZDzT`_W9|6z&n%bhU;ar7q{FAR=RcXvyhnRP+6oqO5V7FM7KoFAr7y
zuj5MC0A$6$St6iaRo&?jxRE|%!a(H%*vNp9t8G)zN?U`PF-5FW{E%+9xvhz$a-UwL
znm7!cZE2XE;TrqsgTiYJx7Qy-p!Rb}@2mLVat3GHMTplc<G`(O2Q>YSdPi{0`7fJ+
zKAj^+e!D#^_Z~y`@wC><A|2|*l_=E9!CJ80Pj%`(MV?1wzM#+4JdE*Gg1@5>*Hs%=
z#-7{JSB{FL$LtB>f?Jjs+BfDkJShDx+#X=<iekpzy3YrS3-I7;o9&^<wCE!LIXy8{
z;~PaTNTrd#SY{<3HV%7SsA(vBBz#nzjAe^d?SZfNZ4hX%V3i~>NBBv%`l{>r$QNFw
zyNi_=x1gRQ(Fo^=3!-lQF)N4kTR_~>!xVd~mAN+ZPHdZTS(8QdB8X4O?i4Y|x#_0{
zey^;Svtp@y;bw7g14g*vukq!lL*L->>sO$VzHUd`KaaZnP2Ade>^#T~bJG!b{(lO^
zzf@Hy(n_CpYo@8DkxWRPHjr1Sf-axdWchw$$k+{yUy~x5JAFKKp$~cgK3Ti_;Z?Qg
z*47SbNh*3oGJnqf_snlBs5L;3>D*mqPeM|YM0hrSt={?-V9a^s>VNX_tG63(=O+hj
zO(uV6U*@_0rKYZ4yocjpTaMt9=%^vMj03qju2lSGJKOw)egsdy`^Rd0VAq3xRz4u_
z^k4MtaaSPw-kgnOqQXs9LebpuNqF?RA)E6dYw9}D?0IAtg#}1sQ}&Hx^vW)n9;?2p
zy=;8@kK5+!Y^hrsuADYh|3vIzU4C@fBx8ZLjsHo>3C$AnD{26|lfVbU(#wZO*zE<O
z1vqy<wNXRAQhZhuBA6@w4tz-wzXfgkJ53yP9*%|uZmAXmL6oZC47M{^mUzb3ixj*p
zesD*zo>~C`3y$&6W|Y2FOwWdHjG`s)aYBt4jrgVtoes7I2#l12mQDuE$4%-q3yKA?
zfJ^=38<G@D0~s4Z@97q{Vm>BY123d*oVC^b?BQ&(2|N<6-MN1x=oQBeAdl4n_yFh!
z*^g(_T#_yU^*;r7C8ssFqhz;pp(#-sQp2&bGafo&ZB6U&&~#Vf{R3YX#+Sl3X<P*Q
zQVy>C{5V3GsSS>1{}*d>JK8hMB4!3TZ+c}+b7Yro^@^E<N*$P<7^6VrysQ~Up!Axp
zDb0Nh1Qx&ybu|y<YBTqBxUG(R3l(qizHXV~!_iC4E{WjEKM+g+zihaKiDl801<Mzb
za$Zy#x{k@+Ls2B}Bblvyz?gl)=3@=|F&H9_x6JpVd>`jhn67>6(SZ~UuP?&(s4h&p
zBSV_#O<Tkq{hz#_&`332kO!!magCHA=DSwirueXEX4R0JC&E{mkSt+^hc)A$qKKzh
zUMLls<5x5}aI!<f{0C=Pw}1Lj-}+zsb&#9cXQh-{P^IyM23+{<M{NWfO(h}A{Bq8M
zWWQLlEX~m-$6@r3xwXlvBN@)dcaRSg@jB__GgnL+Kr-6jEj#;;lYMA9k=l1b@m&Y{
zt$QL}o%GLNjQB5Sns8w_WiFRZ2R7~san{ubLfsWQ-g_Q6#IXHJur+E)(y6(d02FSt
zoyz8^uquo5=HPpOvxX2d(`3L~AYrzoRRhE%u8ef~8~a~H;@<4O+WogU0?+xnV6^nV
z2V>36G4=`C_c{HIaF^lp+#YuKmjP%QP1cCpHOhZ{E?N0X{D6179J|z7<i<{^79@ul
z_qsYRCzsQ+%-W5h>Pn^m?~jDuMQBab<`ATRab5-e*zZ5da<MM8orloJ-HVHe99}bc
zKiYq<p3Elkit!yuO!dgRnn&_e$*0=u1>~;n9ZwrT8U{dLTl?N$ciXiOKEXs`03#DB
zEww)_6K!lJo-78KX+=_c!n@@{<s!-0lGE{;bSXAM65-{~@p2ysI5Sv`%^AxHO1%Ue
zp0Q4Trlmr}&E@Y5UCp2Y=N>44SUNg**Q*K54+8ArZII7#au#kJ^6WQ&0iorB`_L39
zhES+S+apwu-d=h!;!bcNC(z!WN%@<P!sc}Tviv?bler&y{38f$%sM;UfPJkW2}C0H
zqsRO%ZxGusrP7pL;epf?)IH@(S!f$d7@M|`=DAV5pl+*V!W67?kq(vcTjf=-P|D><
zmi){cl5e_UG+jJQCEZ?ic4mv^T;|)J*R)SIZDcr;$35$5sz!BqN!PA1Qb4Jo)+VL;
z$R`JnM2Y9K-z5jKgmVQe28i5`B}Pu2CDr5#z9Xl(s~jC2oitiF&j-45Akb!opUp-<
zxm8ZgexB-&4*NQ^3`cJ{0?CSvr=0<Go^EsA3R<>$%+ijX>9#7EFJE5a=Rgnla00=P
z@Ry_QcSH)RDLyM4r%1{qN@~URrQ@2_aNy7?%XxFrW{_HMqpOkS)9a+;u8S6WLqVRe
z!MbHDZF?ZJPO^fAz73_H=}&1Ll3=^gMakJU;j6JOuvGnrIS)VYw<Ty_s+&?!A_q$J
z&;M01$O*(XGgg1$y=i94z>*BD+&kJiG{2$ruG;0(U3hoPezi^~NBd{YerwD>v%zl8
z|GW{n2@qG_RBCR8LR;xsR$(DUKxfy+NYpTAFJYbq|K3F8`h_Ap9Kz&}0(p68$;bPO
z&*{fXH#cEn{Ch7$pk%YX_I~i2uv;#UiMi-Y>+xwNl0dZRGJFyY`~>}ZA!mzqx;o})
zPCs1Tp_3zBvuV0ZVfe&PHxX1)C1apdN%JRSTDW8((!y6K;s&qe$Ua;C3*}b2Pc`80
zjovMxL--0gs`1QM&pcb==rb>t%Rg+KH_nK^<@fs=rS!#2-sr2%#>R)RYi-4~=kQ%;
zhQD53m<6$xW2k~s(P?&Y3OAup%>{1+9Ysypo|2NjlY!OpwAsZr@6);S_m)FaXxHT|
z%Q4m%Dcck=k-YGhAd7#K50K>#5v19j9thkqx&r-0O)HXqT;4;Pm#RNj(KbU^0P1UU
zFa-sE;r+X7IXvd}#MpYpPH^mT%j^kGMgU5YG4rWb3#&xSuJMFIaZETQ(=m|IFdr4W
zjeYtA(Jd6oFG$*}=ZVi!kjT%BN?EJXGkVjFyj?Id<B%nJe>ZT`p~xwDrk|`#@)<Y{
zoLqLlj4o={vhzpJrCDsbr$rAHuC>W50m;bFR<&pEbesul%?7KFMCGD2%v65_<=)6?
z+pRge;=kXj$2`gqNxU&H%zdW0Vw-VSeQ?D}HwAbvFC06QQ<KEzA2JN`J^G+D!)+D(
zi0J5?9m_Gs^0zQtAKlrbuvyl=uYqi?L^eT*0kCdLW>--Dv#fei_h+SKfTtSS>;I5K
zUW!bA^^YmzZw;RzU6`M9_i;_jkl6f&=`Qqr`STtIlCW`MB@)?8tE4>NYf219bK2g2
zt`)nurDW_T>34^4sZjaD8)J6k@7syS)Z-?_OQJ+!oCUwg7g__8Rp=;Jf5gtbNJ1N{
zJXLY-ypxBHhhlQpM*Pifvh7LT2o&732hVRe-z9$K_bOwz^oc194-aI8{I!NL1$wpp
zA=Mnh+1gI-yCkZ`FanR8yiWLbcu0cl>Dit(tESoZU?JS=M3>VR>LBXy?>j2{{Q5&j
zaAJKcT(_AKRJ3ryYu|U-(1@Z_G)SKoP_^DDod=^u(UE_>s+8N&Qb3KHlgR4$=#qvA
zRTFQ;q}e6Pa5hFNA2*%6TH$y^)=<dImq8^y_WpP%dg`)#yiY;jOvXkjhBDxV2x8A)
zew+b^HDipA{();xnBwzvzo{hdnx3ZxtdB?Yh7}|$ITEg$b3iK|nfL9g&pwc40ZQ&`
zav$7UiDv%3f*<xOpSrtE8}SC2dx@MB*%<&Sdr27;crLqvSbwyqsJn2z&HA#%Rb*HJ
z5ei`4I#EbZE@c?wmV^**AwB4e8y0jsu}d#`A@>nA5Ce#YrDjHVNG<(d)uqc_{!zy4
zLWI2PFS$(H$IdyFz!*dKXL#gk%-ghg0256lT#*`cz0K&vh2rh6>vTcW2&NRb3(^;W
zaj2(O(jG2?!^9Z~qzsuNG9c9)-*!5Yl!ZJqMd_Pl*pAfM&FYw#Lg;2m@LzAA-bh?!
zIAsWzNz~m`;I$Oq-PH8Z<r?6J1I(gbx^Pw?9qX9S{AC~}6~BO>zF~@#y);WAVZz!u
zq920(PUockHgXjX&*p>oj5$4!pSfvRv-7kD+Y_*yYg*&_BX-V_OmFQfxG@QFisIcL
zD$eRnjt-@`(lc{?{O!VS(}L(OQf8EmIIH+dTY5M_JlBZ%`RaK;)*Angwq?i0SU*O;
zKjb$<it&j(Z{TI*ec#B8^KMc$@PD2j17j<VkSdik+3}%%hyg$d+|(83vS6ojgqBd;
zJ@2%=_xZ7!3p`%y5p~21vrMT|U@+31#O%O7ox7xt%xJ^rg?TdvAGf%ypUmB=IgH*p
zBwcV}bxtOT?;Tgylmci3bwt6*Q;dB5W4XOY(T#0*v|+GW_){A%Ym+?Tc8K-%;vMfh
z-Az$2eU91L4qX8!+weA|r-Gd5TWsQ;rv8|uM7>*G)L<czQQ5O;Y>G<44<<c+ge0pd
zVeE&PdHWLuftd)O5{-+6@5tUd9~p2L(;f!27cX?^?`}oMxOIy~W6sFyu{KLP-#(v=
z%1^A5<AU62z^$wbBXwnQ;ggWiBVju=ZP1@7W0zc2dlH?^fqIVl4HIOjiOo(58GlBU
zeUsM%{{h6C`pfSmf^zAX(RRgdR9E8!YhM20G;8`GZwsAIOo<L$CS#{x2#V(~1vom9
zSLJ9yo)nA_=3XyXuEHeQ`*Gs)A|Lo~>)mo^`&@cR_@%9e<>0z6fj)t_FsRkN8L`s0
z{=ND-Nw%2jXFu~X8FHf|MF6CjSXfXzT&6cC<Q2lA=!j%v04II(EjN2~mboc0;?$=7
zSS^OV8XT0QYHju5E80Cz@7@5Lq{It?zdo}Cq^QdG_>(mG5KnXetNqsevt;F1<M4)N
zYp`zD_G{4bOL~P;4FdZtMY*_lmEtvLph0k6Y^0@_9C&6DkL%P<NJ!#3oqYC%Hd5!{
z^i=-%_3Z(BV94V{r1+rWToRXkE^&n+{n0*9laI=uN>n-gGqzawqUD%+`zo*Bi@w??
z|KfBdI{1njU|n=vcYGBb15{_Xs)88+goNyqG5&foKR1Ih-E{$dcmIsF^9OR5N2xmb
zUFMo#1d?e093c-9p%Ocy7Dd=Yq%@PBJedM^7<#Emm%d$HqVK#|%=ii|CnqO=v6u=t
zFu5&Py|fN|y-3_H@U>LtuKK8lGeds=_}SX}v74voHGH}EoqI}LBs-T9>a-uOs(7QE
zA_~6^OSH>Eedr&{%2zxeG!9yM@3**Uo=2XxhQqp#+ifYe`&W%`d1(w7Y!!Rx{@lSk
zXkXb$koA@_rXq3RN~RuvEadvOEsTj4jIoFz)i_0dZ%ebCzeKjp|2H*0%|Bv0gnyc_
z?FJa`c@TOM1=s~xx-zTotgMD)4L%kT?e;a1NwqIi<Pm}F4ivOddgk5WzTY2(M~Fgz
z=-DWIQU<!<9|(;rHzd>LUz;GQmrW;c<v*qf(#n9{4WqZw?Y7=WR5Jsikhz-8m{@$-
zGO-g`9dxZ{)R-kJCd1JE9y>3EUbD_&Ck!OXETqgKXpm;lz=Wsvf~p$mMc@8KxBqt!
ztkEcETO<N9!aR9yCfN~7K-|*l-Nlw<*QP1<zUJuc)xyniRdKgF7|W0gZbS$~I!ky>
zai$0xO3XxNcUgRMe5Nt_L^61-<$dGmnrVfhngIXPaI9HDEwz$p!nw$n)&_zjo})SX
z=jR6>KiQqJ5z0*OLkT&oD|6zy#(s=gP&{Yu&0BW%D$5l~BGe_cmkw(_kApx&Buxz3
z|8|n;)<M$@3oT}hiPqonK}7j85ar(DYmjihw%Fg{eGRys1BeE~yXSvv%wb5xlw5m>
zv^J<Wb`_>%J`R3<%V-b*&YxNAxD_AEKC-3W{wM$ovyKf+1>VcuY&HtiATS;Mz5CYI
z4?fwKK}rT+eT9RZ6v{<gD)2WYF&V>{@YiG?TqR}Xjw-Q7Lm<br7D|1yxV$SQc?M+S
zUm<BkKG)m&)o%Gb)^I_GcuR`WSbD+kM}K44J%B8spW{q0Bm7<^$6r}Rw02N1dElk4
z=glwU!k+a@HR7+yss}H%?z{xdNC59)sdZN(T^#@*v~@jN${M_fs7$qxPsNcp^_pXd
z6R4Bw?Tx29v69FeDAZEwfRrB%DBh~T*MRmgE`ha^W_kNKn3Xe@vZn^^3o%Ah-M3PQ
zW|2d7(`Fh#Blp#Xf&e=@`(i$+DW3K=#J^S@2G9>+=Iwo59bbh1I2>(CMcd5$+wT&n
zAv~!c*PH+AzW{`Ziyy7zYX2f2I`BWoWOPn!)P-N=`lbZfDX@kclrcYBwqiRN{sa~x
z?w)h_x5J4p+z4f!A!E-E1wSCd+O$Zh6!!GISpfjqi$Mw%?kexinLR_~X4zA9HPFyJ
z5sMI^t5%13#Yh@7N7mr}L<xOif0T9YjYsyqGZIOcnz~Y)bxqw$Zu|g$1gV!bec!I}
zB0W|(EAu1i=5x?by`gFNv>sd!4hK8!Xvax=C+xSQP(gFx5hhVHd98ZV^uzQQOg1{g
z{LN*H6E%&mc0H4&<8?}bo<6W1_qKAQfhO08^=yJ$pg0*%x$?xF{`xk8o;jaZ`ciBj
zv(|tjlann-3Qdz3_+bTc@vGQTECV>6Z9Pa2^6kTi7wFb-0X`omD8x<Skb9z@;!<2r
zn2oX4MRh9OX<i7U*ge82ReCVXz&j`XH^5e%l|H`GQo+>dBBNSDw@A(aH47&57+?+w
zex1HA@w=6t6iH`o7)FM`fh`T*nj5Iy9g%k81WGU{k?K;dsGt2nQRv2o<<Z9ZW6ggr
z!cX?suh@A<HN{W&I-dMY@_1Vs|MwGptzWr!4&h%r<|F!309L#)=<Viry|g5;bxv#z
zuNv#QlepBzho>V%<K|fT1(jK;KdsNd;Q3I@k{^R%#al$@o$xW!ohYmw8+%^hQV)CQ
z99ccT=xqCVC=JMRT;W6AV6DvBbDC}Emi>ET?A{RCdJHSRF-ItjYGs9Tq-!vpx>cP~
zU7x;p-9r!6F0fJJ2-iLC+L04A*#}WBzcTUpBZlYqCCUiV9v>eE>5FjbKWpwi)UCNr
zQar?L5yX5M#&4e}CeMHiA7>Vk0!dQKCOYANE)i9)&lu%q{@0TEM<ANe#AOQASCp5Y
z6=Xh3?gKFoW*Y0H2>8rmQ@8vSZK+ZFoR8=-c!xl#^$PhX*PEnm!Hhf=pNFFv#(RTG
zK*rSUBAo{6s<4+FSI+PhvuuiEMlu||<@7-Ur702$>{0U&p34IuzmG;bBADk2vyb&N
zm3Oh7sR|Ay0tWFjXnL@E(guL`6ap&VC)5=cr2Z=E%~9!iN3rleh;O~+HRT-RYsHa*
z@I=gCsc6}=yZWPUIX$ACP`EQoSXFkzUECk=wOHAs?v#tA<mN;PKYJd^kgG-ooVJB(
z4QqG3QrGJ*5(I5pZPeX+I!(lBuYa5Cwh!Rs54h=SRezsZvLGl=7Oo60leu{O$#SJ(
z4ulpZncHf<6#*;9yT2PKpy+gQXA0CU;Z&oHC_N>{bN+{p0bpHp2zXN2#Uja6u~dX$
zdx}l}aQ?9f-s^=`ssWkAVF>|4SyN9B>Mp(h%*J((k%1}G>LNrcS6hs%_}h~Q>YHhA
zP|3%yF!(OcgMS}R1{gH*AXgD+T&(I+Gr{|`SzNIQhLL_gl5pA-WD*bz&%pARN)a5Q
zfcBrpF|P6(uD|&Q)DFAD?6efE$2A6RAu&rHaYvAWjOIzSd#|V|MCA!?L~ouGzhX=7
zqrb@0A1!Onu{$zH(A;{u%EQyFg1B_l1f!fi>eFN8|Dtq2{5CoVJM$P`^(T)y{H;rU
z@qX%Dg*QhcmJmWaFn`^u8)osAyvtgwc{!zH6)Ap4w&r@8)~zp>ly@CkkN2HcE~Li$
zW0HrvQBm|b`S2^TK#tZ4d>v@>r(yb|R%T{ilmbwM?L3?eCcO2Zt#fXhc)RrNR#I2Q
zDL}#`RP9n|FbacRp;SQ@d8sS|SBB1O2bBEfqBnRL?xm$0E1j!5@%(fFE8C`!``dk&
zU8|R6&h-;zyxw}`z(iT1IiMW^9|xKpjdv)9Xh`zl?0(OozvKKt><$vgey4@%divaZ
zM3caOJe$*hmkFk)AbVc>^!8soavNBQ5A}pNHGJQ(T6`dZO^-F~k98ZoospS~8~d4;
z;;R>a5Y)-JEs<^2lkf;;<rIEO#?sW;CqOf{kf8XzJ31m@#Z1kvzBDs?o}W>V<2>k2
z60ll04e+P}Hl9w4$f(CKE))bBq_r^jqM6DhH=TK!jq9+A+Z~9K*mXxv*i>`$B_fSN
zW-A1bBx4|LbZ^H?EqF}g3PjaTA%Bkmf;k5TZ)&U<$YI35mMTav<d`IcX2{D>EWAG`
zd-Xh7QFY<t`0u)|&4m7PrO?PH4RrE2z5yNG_&~((IW5%z8FakQgYR3x#aZ_TUlpri
zeUyvXnY>h6BG%abi&_?_IN~rXe+#RA-dfsb`z`8n$loa3%)#GO59FOz{JU8Iv155R
zE&+E_P}`qFG-mp>MD-ytVS9Y*t&VVZ>rpV9^Xs^*q}1&7!FKj+r1-BA^vSo9g9fJT
zECxQoIq2ZzE_{v%b7O5d#Xo!Oc`PJYN-!*Q<6(;U@|`+FU+?5MSLiW3ZNrjNs()MT
zrqWN6(il|i=*pia6tHK<#7p*G4efmU_G+4tq-J%9F4Sa2IFRp0cFT#Il%L*Ca%c0e
zoVEGt^Eu=v)GWcj-A2b{ekxFCt9eci^AixBz8wEVURj8)N8w~zci`bs_=}DJ<VsAc
zes{i6@l@})<p+o5^}T9c7a*Y=rj6IW(iDY4)aBu5BPbKE<oqH+^bxkq1K!n8^z2Hq
zK7bdOKeKw}5Flc_^zwjHYkMs&_hBKwFzm8h8nk#^=(XTRdk9C(;<kjC(3`OydTOXo
z!Csi1MVNOZ3O^uH-TUi~#DAS+p3%+CMT<T8DtF=EPwZewaz_OTnz91i?}O0C;Xs*b
zG;!_%CsRDsCAi>(76Ewtx`O$9s}m`j&V1?!%%$crks{zGrRFhqyb0e;XOt$>{XFIB
zabd<Xs?w)C>xK>=+~f(1BEhi~41WUOB6!w27o`S4Q0MDD@2)mq6wh&Q{m8)Drs$Ck
z3OyGla>R*9gYr&6V2aD9dQ`*WEVRP$2?|@u8sqx4ng&-%Cp>*sbds(Pzp2zwA(~|r
zXWO$W&p^_P_~fto`<_?M+#jmOyyjD78W(yN%WhgpyQesJpx*TsdClGwClNWiwy4ag
zVCa9qI$AI^U6brj$YqbbNRN~e(OlUfF^UnJk!p=trbK4&B>O-ljL)Ihm30}{+gVH3
zm;(~JNZ<PlZCe;O{zy`pjAds5;lYWsXz}%f2DBE)jXyOS{QN_?4#Fx9?5q!M<xes%
zQ}(zVT;g`n{<R7ez<VRiU@#@|-ir=$q~QS6P*{zdnaL<KzfNWZbh-17$cl+&F%a8B
ztHnHur`qSI4&<(FH)%MB87aBURCrT-UM#sm)Xd>;W>DiU@i@C*p3~0pme-b2*{g0|
z7><0RN4w90NDD107EUk6o?TM(5Rx-5QI*Px50tmUNkarzV#B)EciA4_zMnx7JZYLF
zoDT#D{#m`Hr@_w+8{QdS31*!UZw%w<WAS2)mAR*Q;OAr;FvK%Z9P2Ef^~H9}lGNAx
zw>|xJ_l9;Xo7(ta&$g(Zo^Ssg^U-Bt`Ij+P+!6arvwly{-e|CS5A0LK>BgGh?22V?
zh3PH=<uIzrC>?-2F5+UHX&X>g+AU-UIQAWsC4LQZ@KecvX_GC`U?H_)H!$uG<Q&=l
zs&{J~&sfo7JcL1VKY8*2@hmEkE}%X5F2;o3IGzBN^X}6}E3x3HZmIlsiGdTJ?-K>*
zA9rk%B<_)^kR&mo%-U!NTCKv$*Np=*fTW-9Mwh&oL7HjGyt7EiuA?6N)l>?Q`&DMa
zU$J!GJ$M9{UF$m#b%k7dIvx}3ll~KAnJe(N{Qyy4wbu|arU1oA{%_<2AK3z~h*YLp
z@tP_08Byj1EKI->Y@c`y|L*<lF<$J=NG@I485P1ecetN1ZFYZXxR3EUxU&=|gyqFG
zGk10&Xnb-mS%-+A=7X-nrY^vyDyRe(yh|<kwY1>~9w132^_-x^{AhnIaziggfhM7g
zH({cu-XNQv49uOMjX(HU(Bc;=!2vfCEPvLxDvn0sAm8+M6-4ZVspAb@HBPDAU+W(m
zJogldIDvGz@@9uZ?+nF?JOowm?mnZDFL(bakqZSeV};lpJ#_Wr&Bi1Tf@n&Dd9V-Y
z@Q>Ly>BNJkhf{D0H&>02=IoJT-&hiIuv@p`9k0$~sSvjX6Ek?4n%xMwR4wwq*|ke>
z2KEzti?3x|!{>Rn$wW0Q{f|pF9VX>337=>F#5X=_ISS${R%zAcR<#HDZZ`~O)^oNv
zOm%oY<2eHZs8!{$VH8Y*jpsw{V=h*Z5S{+rcnG!1lq5&NYW5Ig&HOtW9D|A7S>j(8
zlA0yjzr4EOE!(0X8?MQeju6E4LisU$W+}}iqZxu9Aw6`94Q_(Yc@`|P+tmO1X-6Fa
zVob}6VbK8bk(KD_M=Z#s%WmRDrhE(-N|+zCLegfM(%bu*K4-kGuZvN5g!2y+qy-II
zwp{uwu+Fuh2NFlK8K{+nE0#^IPE5Z4s!Nd3J+Y<hG0dd@&6_V6Pd&gFEN0w?;FW(m
zqs8VeZ#-}H&gfyWF2}e#?PN}60UG{y`5jG+lzRBpn#6Mbms<rB0xvwA#kf&ig~5Fv
z;+l^OYNR-;hRJfFySkFfl19r{ud`0yr1>nImX=7xMyoIGM>&^$G<}2Gg%_WLN={`u
z8kK<k%{k?;!<;=Y?CN#fHvg!RcaN45i7$J-G>Pi!4h+uyXf(iZKSh(+5CP@QDGL3S
zB8Pt*d~0e%NXnmjD}~Hy#q%t*;7eMMK$D_`akB}Ismlq|b@ey~(`EL22UYtr@$PnK
zL_}NvenbQcr?s}dkq!`S9RIbFk%O1cP|bGPth%h^`P8X>LYevdJr`|;j_@JM&d`3;
z_w{{)A5VlxSjr}OC6E-;Lxxk_k~jP~e-1gr6Ca14?J3quVh(hcS%&`Y8fI=B)BYRN
z<NS3$kf!*j9b?=tbekcvj8){7dZwe?ZNbHMGgnb8<FDC}SZ*O_h?T<sv2^a?O#c7l
zABH(^<a|CWr%)*8Lnx=t^d`p~DrYfr*f31aDTl~9(m@WLsIfT=$*EEyW;Vy79Vi=S
z``vxMKY#4n;o7e2-d^t4{X9J$E<27tUx@O-lHXQS#p##D9n1J$)0cv>niSac-I|eN
zp2O*m7Uk9W5j~T*o<|dFDloUGRtak}pBiz!o}%5i8#S>ckF2RB^4EmECrfRNf-Bm9
zTuOk#FIym^vr(_MYPuhBk#0M3CR{1!P^*4?w&L`=<>o|x%X^SM0bY$to8K^QAh+(C
zficL&i`UaSOXFkxKD{iXdK13Nb9dW(E+&&lKnmWAAllV?t$Lr;5#5le7e9@AkGEyL
z>@Ha0IYhTmTI3O%`1F0_$G7pByd2C~*&ecxxNq^WZ_^m$YH4YE?k$kzp%{gdd}tJm
z%QHAH@aO*RH%YwPYbb~P7g4Gu1&eA^I}kgAOiOm#wof3S$*G8sgQ_(s*h%Owi|14f
z9<^tZS}A#adgWfUGF)z4`T6k`Zg-LmX@a32$4~?1c?J%@9oaNic)s%}yIlnvjnr>S
zo=D-%2>y}U)m9FSo6T%V=c$aTXhB}(45f*cz`WTV=E$M*OS;{PYvMDBI>O`wzily5
zmzopD$(qRm^e%d3Ch6xhmICiyFK?ss0?)uiuxs%YkC=lln#US+JWjYHrs)hTx;L&;
z$Kji8W>Tr0O&S*z!s{TQn{_>Br2FD2J|sK3yLtqCe~pa>IY9yo1zJya>%9uCyCUh0
zKpup4C-b)zfrO!H2Y(KCXLay2+VMr6I%(swT&8Hp_oC>*aT=Er)Y2#86Uuk^K9W&h
ziF;D5+s>GG()wE3LvTovdb0vX*H&vpF)_i_=doyZ4W6PQ^Ccr^@0)ED5}AH1iDD~E
zmMkQMsr<Uno2h$2*{v5j)db^Q3!|4HL;Kcn(JMd|Y&SC7K*^UrDbfAi=OCu^3Fkp|
zWzgJzvaeu}k<OBajG5jU@%QS*k4YRD<H;b(h$?Bc9)78hS|}DzLTS2!-hPbIh-x0+
zx?^$DW#Z_l@6olCkQjr8tjXCJ_Oz(Sf#~drB|JhWkmcPlL(QbUJCeE=5_=PXMfwou
zRvj_uW$b*>ZUvgUl5cJOst-O?%l0P08SpM9BZJ7?geN4BE}?+5;$>(wt(PxTw|l>x
zgPw{GOJ)61GKh=nwpR2_;The&FX!Tx)bIf)aFTyV-8)~FWiYKQq{sl=qusKf(rc#X
zU#l*?Ij3TZ5{$`LM7<FU{hF+9`^6aYT662S;?~6C!!Hs&j?JgqQsSJXpzKo*Lww`p
zemV2s&d_T7b9t0iW3>k0^IDd*e#hyTe$G6+CS9lF?iV`?J&F0sq_1UPtv={m2+e!5
zID5G({zEl2u{M{dlf`?zCVNhzCrvB%&9gD%LLm#8!#B?$y6;(uu~K7r*0QLaG8=A>
zJ*4b-&$q0^#^8}h_%BAUF1$PR=D@WIHYgY5z^}w&WI4#~Q$E0WCtj^4u{WnK&U;2o
z%W`@jPt6KM$*@$fJE8mVj=kw#uU4LZ{uzx)j#BSmk+0&9EWi=G1B@{iAiJq{zmYzV
zzxb8S7Jn?Z@aezMe5nGVtFFOn#21zdkHz+WrAoOzW&FE-<Ve>W2wFOHnn*3K0S%`g
zrHw-pP7UkR5;r&Lc@Ga~rRcm>kvCyIV;8hONOQjZdOlSSyHNM&%J-wmnbOFye$jg%
zvW}A2NAS(IdIh|yPfu!{_WCLN-w4h-b8y4Le;gf)S^k>APR?Zu`wJb+`dec6L5{1Z
zZNNN%7Wlyn(LDYSc-g%&0vW7w%?{q_v100OWsbDhC*@L@ylC^=!!;%fqE8g>eaUc!
zol)F6Wa+ee^9qB0j^M5&W;LKLWr-p5f8OV4j=6;vQbDvt{YiN-uiT=k&2vgh)}t=|
z;G+k2!Toc$mErroT=K1NIXY|ksJQ?DL9`J(hdVuF(jiu^+_dhj)xAW%=DReUzq2mH
zm1NCgeTe7%hAGNBC#HKWHv$ujbnQ$p;pOP^%C@}8du;qTw%N*}SV+=#eAtR(dFQ5c
z#3Gfd5kn)evJ|^Wkhn@3mVn9YKQe8s1&p>f!{z{z7<|KHi~|LBALi>A_c<@1(fUZ~
z0hDi;Ximu75t8^kh;3%I51W-Ce>5{w@CuOEKKx{m=FWP3U6QR;`d^&Y$vGP#AOd*M
zOt$E{{D&(k_rd&~E(fi;#m$dXdjxTfo*qq_{N@-pFHjn;Wzm4}bX%AVJfi6OY@>aO
z(s3(!V*bv;{;%d&35q%X8A~oE6WwmeGDV)D4LQm4figU<?|X6rt_!H;O!4-^a>mW7
zqwW2#E4D}q>>|yDpBO&r#yBvp3@+EG#koJ8)!#Ah7K#^NmM!@p(6CQ{7kSW4@Fow9
zHG9A=>-&{M!!7h>aN1=!m;Njp>(+(f=~K4N9n1DGcb(=OPRfttc{9Vu6O=6h&sGt$
z%lndeN@DpPpR?-aKabvnIztz-DTmGx%^%rx9V9oEJyqm?eLq%_gwC@(ySSeFOZJJO
z8OUQEN>ZYAL%WYCN?P*77TsSx_vDod^Tt!LUW0k}2N0JpEG^#XppzDvx>2!E`^cyO
zrnU8m#1(t)6Ju5&ME-qNoqr}kIGyL=ne{LP$rC%LtH)PW&S7G0!0f8~k4=as;b}Xk
z?zd4xsXF?jBDYHiy>{1v)qfxf<y;<2;Q$LgZccXJ&QvaRiZRp&om<39u+~iBtsOEt
zy5fD`f=MwPwX;0szgDm<aov9ec*9$6l4c8J>5runT9(2BdIkNnSMK37RbU_d%2ZRW
z`L`}?-GVfP`K$9ha2Nlv()mc9UyLYtEx?vcIMgBj8y4&g&=+6a<wliT6riqvN?UyL
zR>`Xi7i10k^KpLzVX38slMUB47;;yW6LpDq(EVDO9+~lig$tW~X)Aehlx9vXK+a}n
z%*l3(#cUR2#4=jy9}lKQm%@EZAgRXq+Tp^RW{FEO^QGo-T%eQm_dl2^VL?+Y@gl(I
z15_6H8>GkQgsT6H@O;0T|2L&n63B~6>gC8(C5v`XfCND+m@Crf$s*#peCtQybK<;O
z5}-;2iTsRXZF_}jO!7i~hqJg`tg;~9KwSpf*_ycU-cUMIIgVe&+k2cVh$v-q`hT*I
z)Y=U{o~n64F-&`enTKeJ^F^EUxu|#CI@?d@(JsvzR6lu^46ct6uT<2g#=TH33q1^2
z19`Xag<Fk_VQB1F^7gQJ$5+|D%{FD!2OA+1{^TBd<*7+lCf9Gy_yjaEX$C>(1?A+V
zh|p#_rMKf?6S7lDB=?{y4iS?liJ}?-+LK=89M#;ja;wHH{+j9C#{~?NjE@@1s5ZV7
zJG*4JP;)ye@naQ7z$OwK`%g|ZoB!u+%vyhNAMI2)5(?4NUk|WZJb8Rj5RJ0q`HKxu
zco#zwG^HB7kzyIOetibLA7Fo8?rM~Eb=Y@1vV?No#-mL7fZw2#m-A`xCk#15O6JhU
zx56waoY_)uTw8qG4i%&9{!rqNM8aZLbn2pje&3DQuT|5Vi8n<|#_t^c91ps+^P3(3
ziG`={?sJjcIYzj{%w@S^8v!fFK+Jb4GlSUMnDVJX;3#eH(M$sdAQ-0g7o5z0$$%3{
z0D2G(&*TNcVjS_EZs>^R1f8cfR}vE&jt`9*9Q#ptN=3&gdR)|_Y%^2G>WZ~v&}+x6
zp>U|QPWOS0FDsdnQ=!Ot>%$Rx#S}Xo)e!vXyknx{PqM!5K)x<tbTp!nUXxGBQoU!_
z&)w^5?T<6A2nw$WloF2N3ICHeNo?qo#_nVrM|54gY13qI*k9i&XF*R+OVMm{=v?>i
z1>IdbMwfqDYMF&#85Mh8hlB^_!%V#-U`4c3N9QqOUo9m5Yz@Ade_3Y8I0WGtXFVs@
zYe*pnUoJf$hZtWq{C6+qqP+EcKId0<LMasrf<x*`>cE5xBtSWtqFrUNGU1edb0-d`
zbuGM-1hh}5&tO^4aksX`(eeH+ZNhTHA`2~PI3|1)(6|7c_l-IBzC?~ro7RiT(Qyu-
znNjvO{Vu9z)YvxG<VtBT`GP)k;ADup8(;GIzIV-g(SwE^3zoKgXiVmVgU=Bp<>J2t
z2cL_x4YRxnXVUT?2(QkX6b=eUwjMbz|CsLCw(RtGI%9+J@eNdS!R-8GdDhmGB+Bf<
zJw~_BwZDIUa=5qybPpzB(%;>_>vFcvrxd?YEVjoW!l>(KrwM;;Y3k1~g8#&OrUzBa
zO((B`=2R1Zt4C7c<IKQGKhVLhKp8Fv0Z5KQ{(@@9l}u5RU<`IuF~7WPI?tqa?fKxh
za>;_058hefBOz}GjE73rN}Kozo@WmCq*-W(9){%^QAfV^q*>#Nv3Bx@4tl?BO}Gn|
zeO{L#pFJ+ibZ$y;D>jI>)A@=;1LO(|wOcix*bz$~#GBu-r0D@cGFMBl@6yZPz8|Tr
z*YNu?p3{4j0DgqP_GaHDX;W8q=HXB9q#eq?J(9r$*kK)UKoy1J1Is?YoKkWC_-Wvy
zaJYXMV6~vq2;{~GXH8qjCk<%;s$NwIf8(Y+CdQX_;^C&|rupI9LaYBh?6q!_tO%9-
z5!uUcI=@3n-J6Of6v#VQ%{LaF>XA*;W3WH*9Gl{tam6~8%L;vIF-NZ3cJwfM>BuQ%
z-1KCDRJx>}y``A$e;+!~dRZ;!_VIZy2F8rIC#Oxr&#uik%l##xQonvYaN3F+DCBPj
zzsQ^S${n1+nzyvoG0q{ro`9^{s!64UB^=Gge1l16$GzRS7d@X}jLHr^X4k(RxvqYT
zAn|i#jh>qor0lh2OzLjQ-b|Ad_2FM;?Vt(K(>3PP*P^E*yi|HEkJ=tRr&_D~SZYtH
zoZuMOZ&pk7GV4xR^f+)54WCS}KXRmO_tiPeOUB6|>cac^^V2Vx_0tSS`wEr~yax_%
zxe7bR2)!n8IkBvB4pvvrY%rQ%&^Q`?H0l=Hlfn%;Xci#2jO|KH34r=Lw?FoF>&++T
z9_I~TS>e{V)n6o`{|RU2WNh_AZa2X1J>+uU*uhCWZSm^)>AGDsgf#Gz;R~=hrfV8G
zQ_{pUPc_Qxctoo{!eB8ZwBgrMrvk-^z2C;7{G1#XtIW}_i?|MhSNA&@nD}A!(F~Yx
z+!^zwe00&Ruk&=*S{r1kd77vZ$1F*`lI9<&l944c&NYUFtxFsyQ?++$Cg(Zb@Ve9c
zeib?6UXSKkVtNeU_6>7bULsa47Gp&xNXV-9<+WmO9ym)EWRIT4cfZ6kh_9qPla~lW
z{09{-JSn@F@+VU#GNCOzb`q`QO``zgdeDy*fTnDyFO7d-!itx1!h<c7;xcwoORczJ
z4Khufoa=m)uFC(Z`0h$dtOOGCM{wJZRn<MSZg}FI#XpM=Y1X8YTZ%l@D1LO8u0CtI
z_NlI;`$4l(Qa$@{CPs?q#(d{kf_iMcpPR(RiLQ;rUWy(6Stact1#G%<rv}q6oWqQz
zF<7hnYk`vt&=O1*i=RyEqH-%M@I&^gQ>=P$gzwDp<W8IT2G}sH5Q!Wgea$soxImLM
zrFHFMmpM9{tRG@c5oZqRX)}CBetK<bJD$U~IVvs#e!wmgtZR-7_@)3~5VoR=w!q9=
z+5Nh7<Cf8H%)*&N<I-ECIMpsp20I)xV-_xu4yJC6AfL><`s4QsIXM=A8~Yv8vtFX3
zQ;aom`=ykoir~|Y{9N)b{&VhEXRi-8CR?JzMPGmL`~rKJ`EpLf<Ck5t)#7Lkbvrd?
za$(_dZ~4>&;^R#av$6S+QgxDP$RfaOaReJXmEgEl%)ZtyDKw$#Og)31hWQj%SMmOW
zCrIW_XSrOnSISurfYK2Hpzs;;9b5~wpuS;`VE@7ov)RM8xTCZfOOTx9OPsImMncTr
z0tz_2mY5KT(4m>IN-k1SR(6o(EsHtdKv?b=MXBJ_D^c3rNH2?e=&U^k-NpO|9F!yi
zCv@UQqOWLp+*3OvD(3*W@cuBI7(qi65NS9KDJm`1(zQEx?RUCXcU{o!dF_CE$V2`w
zEqa|t$@=_V^n5t)ktoDzMMi34XEb?_r>*;n@6h%kk2@Dt(OP<=iL8PnMhv25IV`X-
z#)(QXr8ximNN9?W{k4c&TzoMJ+r_eqItonG6#<?#oY2uSgdI^2(J-R1O8yH>-ao6K
zXSQfNFQts`%QSGl*_KAO!gdkIdlmO-FEZkgIPeRu^5x2{z{1zk#dBO8X2Br6O{10X
zBcthZbVE<U>7lG4R-2JVG!a<KZaqY6$xblV#g&>KF?790SG$q@*3F~><y-BZP$@kX
z?wV2)Jv{45Nq~pK%cw^a9#}iK&$?FJY^P}BShd92^IF(0XU~*hqA7R#GWAQk6meAA
zNvJ#!$grBJyA@IlsKH3uXH&<|-i(*?Nxyxn+zW_Dd@*yn)IXKHcuZzHx~Ochl0Uyv
zW%o%btjTjTW;5a9%D4f2oS%?Pf@`^=Q7!MtonG?S5$J5IuAK)KL&{_Os#0nf83-vj
z$r~UU&rz_o2o#lu9m&+9szM#5cs<m#9Sd^owJkr$Se8mp$}ZUR#5(Xk91a13u<Lr^
z0Em?3b(gxG@*KO=(>CX37!SSs!#0LVaJ0POu?A0T*SGbfS)pUpeGd<(H>H|4meyh!
z#@LE~b}h+`gwIySH<@t4Wh?9tfPE#K0dyF^4V<geC?PF4<!pCgnufkQd%NZN9(8*b
zbZl=jiMtUJE9pgj2k$61dRX#Wn<1C(eRh9!3C3#%QG)KjJN~f48~YNzjl~zupNKYC
z`@Nf|@?n$-a6Z6Gm$z|7EQa_NsCfd@Se4<#Gih#qSVAE>#9zo|0A9%%{;n(Oc6m`#
z%)r)@1mLP^_{v>|z-CY4#R;4wc8LpX{yEVcJ)6;jirMW8nD)cI3o%U$bvhWcmIUEj
z#ufHR?4OX<h~NA>gk6afNXEYBY^PWq6leFgb++coKwD8R3^Vj8-vzEYpmkdb{U`F+
zgg{n*nlJQr0^IKlr4MsH5~%u{p=PBlj)3V=TW{=jS3B08E4Ri2@MaN-ae2slQLl&O
zAH~cX2&yW`qS)6i!RgjlZ~mcUk>GGZQO1=)te+`fBs?(;zAsw^-?n-$9t2B!%vrgR
z8T)4#aq{gRoH)r}FOS+caf*zxVD~P@OaqCmBOkXE+$xy`3-nz4pXZRf+!*r<<`|&F
zBcDp~XB_KG0oxS|l14cPW<2}|fBX(y!vn42hI0$0({l$oNvL-KjWkRoNON+K3&1co
zZGr#lUA$y8P4a%Qyhc*N$|99kL}gzoh2Q*n;*53DZN4TVXSq;&WqDv!-PV}-5h8ns
z3A8gg3cc>4f6e9BNf7yX$>e>bA;FGjdPaLvD1b?X%+|HTQ=+?h%`$*RP%yrR|2(U)
zj5*XP{VsHZ;OIkq*9t)MMu{KH#M?tjkRa^w)MdG(@(P`?<j;Rc(+DB%U0<DbGf0^_
z`=~o@N_ImTlTrZ1n!l}+%dr?-XH^44`>85Ie0psc``BR(MtjL%vcJE27jXJwsEbf(
z0M4CaCks4Uo?E9Kaz!2Pam|A&y%e<wmI_iCn`ag3)2_l)tGcR9tnW>K?6Z`r`I(40
z)Z}uxnyMT#E<}Tq0CF#?nL`7%2a0wV3tc?Ntf<8TtZwQakdpHwDe^Oi3k>95d<*{e
zy$X$Grqlx&3>*!QqQNh->OiH$nNq~xhh3O#O)Tz0O{4!L_7&@PGp(ZpNN>!L`eT@#
zowc15E3y^!H!(gy!Qp})$isFWVmrE4t8ymM%SBQHu-gGz2P~C_vI2PQ+bvi?xp9>w
z(=v4%&^UDw3$!GcW4~@2?GSjQCA|lF!&9rA<`S918ACig*$=mOmZ=LVFKC0y>C&n3
zOt~T#i*Qd5oMDgI&#$c8eW||8N|7bh9ZY1)B5W9mEMvu`5lQJDJ;-v1TvJ)!+Z@HE
zcCL9$OnI1;6b1OXs2opHuSTl+f9y#TArRhKSB2=kNF<?Vh3ap{GN|O1j?#apqa}2<
zV(uLq09g(9mDHiox}dpf^v5JP+y>{M*v0vWHDhLKZd}}+)s7966ryF!(Oa}hqL4us
zx4XxjGl7s=G9|%V+5e8SQ*ORh4!*&WrExusyUD;MSy9ruy55Ze)=8nv2@BreA8bfC
zGg;%qRL(B`29=o#fL?&#i%K~{FI7lCMye?-FsH%LRj60Jmr4;u3yq@k4^=9(B7-L{
z+~4eBNcKJVeZ?z_nUi~F)RMtWgq)l(5c0Zz>5}WJ(+$cIie<Yu&NB;%CtGz~&bU-~
zku=mrt^@V{P50w2q+1MIK4tg;Oe~<AYMafb=S7yld92`;=`%R(fkd>fupW4hip3ji
zYj$zzPXCmIoC8eaGJ0k36?)*6e|3>ruj2CDB3bV1M|>I%@P%o@0f_jMg4pW--JKc(
zsFAYFzIaG2Q5Og?1VB{i$`F14{!0K>9+5`TFTydqm}!)hGZomedC?i{Vn;Cvu;8qr
zfp}me*m#O#*Eg!zwZYuD$OSZ>-`~LMHRE|ro<SS<@+<Dp2rE;~x;#ASlYD0I3kZ&8
zatmCP|EzXGHFvF38x_gXc5+kKxK#^#*Kt}QEH}oFDwLTvOe7ARQBq_Bs#?IcfdYa*
zRHyzRnK(YFU=|bVf*9`j^*m6Ac996|xc=2i?=GhdC!Qmfv~*nV+W?GOfF=g;3II)x
z7G0!`xvDuTN2DFwHFs|TXyc%lYSSzO`OjX*&qP}#Y$iMcp9O)!Y8+~VjsI@|4d|r{
z6rJZKoR;}$VDd;6Zw;c@UzrrnImSx;B+k&P0ZC4AxAy&!7jZiybHNkA$-jT_9^b`I
z7y1L*05l@#)xo{pO)l&78nnDXg`XezG~mx?fU;LWZw3jywN*U9-JNKf=QDksU{)b#
zcKS%|^OWzQE*DtJ_Cb;vN>FtS7a)YWr7G=5aWduKwF<x}E<t~+-B_=cI^}cruWQaK
zsSRlfX2l2d)^ItxeU^d(rv~Jy+}+?h(7AcY;g%@4qhdNJYG@r8Fmv&(jtumgsc<-8
zZo8~qKzDYoe9*wV1yR2l$ej@m5){aOw6t?G>*A@e5+Md(R9?1aB^fz|c`G;GGbm+{
zqWaXU+R$?+gHRh;6j+!lmo2J(d_JTmD5Uy*;gfqI)%WD?7d~k)2G}BC%{Mmg(INwq
zXL$<l55OtxD?P^fR}L-PM+VM6edyf1R1fOFt8xkhhtrQtMXf762)c2@E>ll2?)awz
z<|p^*qofl0F?JCJA+6sKx7ud}5@KI}w>H46vj}{}crNL;X~zV6f79jTFl0~&g+loS
zbS&b@vmod+v94sSKSa6{RJ2xC{YUt%$b&kPMJ8f$p^GgY+Px}(%-WFk@J;gP(Niyj
z3#gslR7JWx5FGH%T9nH=J*tWH6^$rZ^0^%c1yvnsy~+|ue#mf9uM;fLaAx!KKPwr`
zeAq_H_T?G51CBcw_S1P@EbGP~k{StqkS_N7Xr_-H^nnDXyjW8;4;s$%_?=I-U!${a
z>Ck|=Sa;YTSQ@BRzK^A+rQV8aS95{LtsY#!&({MA3#yg!{{%DX-USR>UGWL^Iw?-#
z*4wo}oUR1lXRH5v&8y8;HwCcJq<b-}2#c_SIbC1iQPRJ6{JR6Zmj$`OAhjs({JR;*
zB%~Dod-D7LUPb)>r|Acc8P7S|=e6UWA$d(r9z1yU>Y-ISD6`+TS@N>qYVi9*p0-^2
zgE|n;r+pTBF6(lijMQ?3j6x*-`yGJ-@g}&7JD@6g8dpsosfdGwh71ll>?%Ln<Z^q&
z{m;9KXw*`(zKdzyvSm!sz9w7c#_@KSq2yzHALkD)gZBO8D{+^&wa$2`me!!QRK{aK
zKN6(oq!y<DuHv#q)Eedm{at)4P1YQG1dfz_(bCY|2-QGW3aIQ3hIZT~`-2S98yfc9
z9kp^n`j;OPq|-8A+DIs2?i~z#lUgQpZmQLxhzpQ$`ClVVgx+^tBd|c9|Mq6TcxJx#
z32m~Ml}>NEl<X7CD;~imkb65o#{^7GO~oLmQ}{aba>scu-@kcW_%Kb>+vGlmxx&po
zvTs77Dwwg2zEi1k<pRi9JD(@R!1`;eq_zH8adF-q-|`<HxAFguyZajzx^gg>MVl<4
z>-C%k1>OoPy4>TJ9%vz;{?Pdo>(o(@w1D?Q8L#O6vN(raQ#;XmE2R`Mv_A4sDt7&}
zwB9LqX4V4|XdgK6SKHY~r6g|cvsVjkgY$XM+NKuh?nv>k@}9x=H<DX^tVI+nIL%M#
ztMQWSppb)kPHlt2L7)mp@(1JH`GVrjN{~fd@rjj~7nY{`VL3tKmt=M4vjok!lsMq)
zgUN?abf}n&&htl$|JUR5x_Q+)!A>{-T)4ed)daV<7WwMcN;d+(9yw7Q6*k}>$y@Y=
zVjnUz-~fDc;mJO+Tx4WWmFxQt9-6Y8p8T%C(2{-KeEM*BAeW0Y(N}K^EJbiZXAinR
ztP3fl$dP76M~X!kJyE=(>bLulSzuFfUht8!_4s+Upi0mc`m6V@ew{tsxB)~k?`Mz}
zWd7hBaLn>IfXk*NV9m;QXUhrui}5NC6?L!r@CQZMgVeNhx<U3<9Uvais0ct@aw{L0
z<&eCK(?CYN>G^%4FvBg&!MFjCV{$(FlKnFgj=A(zndE8No;6{^LZxgTj&A5c7}Mir
zcpy%$TZQrPoa_jLw31EnJr!S5gC9{c3%R^Lp&#3iE7cwbK{zoVPEN(r9|NwIS!Lh`
zI9v;3j&wJV&=35aZ+d8Lx8OC3-~s-?KTTbNH@v?xF8HZ|AOGRf8-rhcPfnRp<!<st
zGa9BqtPP`+qNzF}%fh}R>(5Et-Wu6cLPaO)1qFc&4e%E~wV=Z*2ux@Y4gju7$1sK5
zR*=K3#{KrOUXMcxJ@u5NN{#culwoo8LgP}7T%Vujp+6H7-k!E?;M{#mV92Vt`VFu<
zAKJv>OMl)4q$c)~?CU;Te!jwH59p^{!t=4mr643lCRmvMATQ64>uGa{d`x^Pqh)Jm
z{y6_hL4l%}?a!6loAA_U$=dy{8O3YqR`boEzj6yx8u)i_!pBuL3XTjUme!hi9=0`Z
zd)6Ex9U?2PCzSD-Ry)j{T%&7Mq&^mY0#<m|60FE%S#jBp_u~Ief`7X04jfjeJ=CA&
z&oCttiYuG!EfWxnFA|@}i_BlBbIdB*k<tQ>j$P$eB~W!!vQxl(YPs7c*XP|RvfVj)
zMLuX=(LrqnPgWHi+ws9cWi{uyu6+zd0xfAK?Naam`2I6zLq79iEbh&<Oi65)y&heJ
z3P^&a4J2wwl3oBFqrl(6S`7@76=)epGQ*F)l6Ud9vA=cU6f%n!g1%~&sxDFeYoz??
zDx1T0q)1bIj<TSxL?*(dG50KFQquu(<Lyx6>19^`wU27IfKNM1IcrUvvKKledlGfB
zE<I|P`>y+*fb7Z`SWdHxxa#-{eI7XQb7=q5RlG1Y2l{D0T*)@u6{C12Xl3yc+r`lx
zrjjmY8m<xe&uWV94R(33*Jg}9+c}p(Mph+b(oN;GhmRXWjuYdM&=gmO)R)@HL+4mG
zmy0~>!BXzI17eH!EkLmPwKowQKNVVSg)AL;1Os%tdEp^UWqBj=>%c5!dAr?WiY$d6
zp8CaVi6GI2on!sXW)8#nFZdb<faD1F+NWmkS~<-iui*W$1(i~WB{G^axBWjZ!~e$j
zj{@D^o$68vkBx_?Fu%4C-Pts_E+l}K*2U28Zsk|y^%#Wf-KAL830eAqfAermcFhso
z`Qt)>d=s!%sftU0!BhhI5wwuE1Q_08C{-hGuaOcQO(tja)ZbjqvSm5yV3ISKOgMx0
zpFoL)RIAmp{3lPY`)bUfj^Mvgx4l26pCTlrp?QVwqnz#{ga!vB0H`>>A90TE@&hAi
z^3@fmD}KnzLC|`ftzI&8#rH=oa^&@LE*GC9c_c)4Cd%0h2t9TL=k=6moBy-Q{a-_`
zo$rk$9IL4DOdIr``#Vay5NS{mov-X$7kxZS)Ao@R*6LmF4RG2Q8h2smBBTlY`=lym
zGluPgvTTOm@<#WSishMW_qmJyl1~-ub5mEzP634i4Xc2sZFPVJ$3Y<%iND`csVub9
z>i~wO>_EGC!>1b2KA{efOYD0pe&Z<|=qsk7bsq3q^lzsz2}0m>^>ZV6*D!<|K-^Zj
zyWO0Ud66WESN)X#J~mt^#Pc^Ktv7{7b>dDg_u_Qb&P9^?_Q6ET@r;gW`;bc-Z~NO~
zp;L#8GGdc<1JocoM24{Re<mP@3RLh?Tc=sZyf$&~&yoiPjEY4Zv~xS3nv*mAg0RE2
zN>qi!XdgeWFuXh0p-raNY^)u0fzxHhj|Yx-{%=U)U-z>e1_v}K<5pV;-vFab=<|3v
z?bk}Ej$eeQNqry(0z+{2feGM?G=7cUZZzgnY?*0RpXUhaV2H3(Y+^y5W?YOBb1pQc
zAXY%t_IltQD)%tc(f?2@UF}mYNKW<FwtKCfz2rE(($T(4O%H3A#?Z*<Fwfgn3#bSD
z^Vf#s)EEGMd)QfOxU7~-Z&7X1pv+L!+}u@_rR0A==r4L?C0~#inn@QGUvAoPEneOG
zkil282p9-6CN1Fe$H(S9X4!0eXaE_2Zo>B9j$D=B8U^rlVA0Xisk!1o8ZvkI*Z~HE
z@BO)x>)cF0ILiS;ywTW#m`22C+OQPE7OW__@LclYm4n+U54#`?TkXhj$v9<Wa~;hR
zvXpEmjrq?!0r<lJD=IuoaG6L#c1tgBA_m;myC69;d!)Igecx}cHm{FbE=E538eRL=
z1Gj3I0*7<ds^Gnkkma8Ls&Dk+R{3N(BH56J<3Rs`g2)yQI==!5tp&k<0RtIXMa_PX
zsy;99qrJ^8Dciy<t3?vVcFQWuSnMXrg-4t%v4<FK`cQbV#uRnoq**TDeDQ(+PDbQ0
zpx2I7uLd!OZyT|9fsG|b%^NnxDtXtE@`?)0GjUCDzDyiTKVP!FgXZ-HRxXLC5r~##
z;w7)ndAMm3XAtNg@7BX!us!P96-^NX7k|ZN>x(}Hd#66ldB}tH@(gj&-in2sF8&=;
zcDr2#S9(5G>r&yy1}#>o<D3JR9edweQ1Y-Lw`I58ur%KCIgml`&cd+Vfy#sqE%z)q
zZI#LGGk%PR1SYoun;^r61ZQG9fi!#61|1a!MEk4FI|UWP5<>78X1ZnuUFM=fivNqv
zOVH*B(Bw2Cc7r{AwXjNZxD<#7d4<{$XzWix`B=219dTm<P66EnPA#3RhyDTJZ}{kq
zb+r0A-!z09u}z|I)|y^>JM^Z4B{(*uTiy|K>I|g=+OzgmBAS{~=(ylnC&FF&Lu6@&
z3U_z#&qe@ElB}7lwT2FqA_#T5by07u>(!laJKSSeJGC6f(Z%8sfI|IB176Zj*iK#q
zo*{wWHZ~^kDv%Z68B?2W=uIw!W*h%-e;m@zpg-+GNiT!fHHONh89sEM)0)2AW~}8=
zTdyi<j0J3eOe}4wi-Z;qOzf6QXVxgrM_}?*MAFX(n_%i$pIM?nv`i3xB5$k~G%h#~
zU!_G1r{Mt^d^nL+(2kdsnqwjWJ)3ctxIc<6u=~Y+-J3meV@SeZI#{YSs%#HyXX5*!
zwyb#I+$eLv)7SW=M7K?is^ilUOmb$3!TFK#m;tnS&Zf(&m`f+dTBy4ePz5F>6m;eJ
z6@agf!yjkaLBTL)TIH~-Ms1iXxTlwg0nJ?rFuI;&+z|OqjGOnNtsTwlrrBYCDQV$B
ztZT3SW92FU5wk3Y*h!wC6%6OuE^W*^_;lENiw48wn)1_i7F_I1<Whe3wfe=aYy9JI
z6a=VwLv^+-(g>4jL}AiEz`vp+LXw7u0l_<bZu5n+qwKzGJ%3mC#cZO*KFQYhnN|}n
zEpN{1%>Pe|`AnoCBc+53MEjq;1$)inL^Er?gC(3=@4m@xEp=Fhy&h|yiU4#O-p+vH
zk<ibI7yc0E__D!F=;dB_%Rt4%MGTB_%{6ZwvxM!6SH#g60lqePbn<R*jQE?+$JO4i
z4DnCGyeC-&()T2S&b3{+epheblqZ+PMA)I|>S<0)1lNwj>r2b&T`(Ru`3U9rwG;!f
z?vPS6#r%z9ygfQ4hBMe6f5bJulxFk&E>9>Nou%+C82B1Zz|$kgXMZrX@&!Afo?{Nm
zVE`$~MN0UP6HPI%%+W@u??%vgMu3#n4a(7@!&$mQ3qE!X1YHf-*_Z^tR78ToGquWw
z`_YxPjlOr#l2&P0Y^7D%cMVM}mhDjvy_IwmlR+y$zpcfxFhkWNouJ2<lY6SziNRz0
z&2~xHCu;0zx%Q=hmY4Us4^VW-%p!SBh4ybh9>GsuoZTfP4Gr!wR3VF^^1dmH5tpnS
zi~!;j)Gj;r-_&UlmaQH=-Q$7<&Gx=>!oJM?eRmh>Xu8FXTEOki0S-nglL1fby6t>%
zq2lP`Itk6NwwDZGZV<PUq{(G!arR)@7<ZmGs6WPR5=UPitTsBf;>LkdnaO>I;~Xz)
zo4OUgTZ%lbnU~@e@5}0t?D=W^vLBelh2CY3|5EcxD%+(e#)FnENai%5AgBWLw|DWF
z^B?tNiA~vYU#>XAhv8pcD1g)HE+sQS?2MkT9H{*6+&;kj#YI<P%e?-_F8VwhUaqq5
zq|mu|0a~x4!ecwXp)`fLpJ@t&N!d>h?NC%uK99{YGmWFC;}wtXatQ$kO&^4}OK=4e
zsj+eV@&Vns$}9v<^Nr!kwne6ne%ey*#wisE5tt$KMt^2hC*5(Dp}~8$*Ysy!!d*A}
z!?)iN;qDB{R}3Mq7175AhRyG*PUKefg34H0{z|BHb(r+r!V6VGw8}lTXaDVxRfP8x
z=WfenK??ca`etdcA-kH)Z*QaRpvM#0&f011a7xI+1(Nb+LjAUBiz90GhLDK*UoP|+
zJ<)Z}LewI3@H%v%I~P)L@};Tsb9dh2y8|m4=S!Hqi80X%W}BD2j-R#mEQtS`g7nV2
z-_IAVb7Gmato}nOX^(|25v%UdQh5^|nx$E-W?80H`?N*MSmx&4?wW5OPs#KCpM|&m
zMk{>wAXt)dZiDz25(vLbZ;&!KezDk99E)IKVDt-Ow5twr!m&s@^0kC)URTQd7vf}{
ztuYSUS=Ir*oQxncSx!P}TTCd^>}96R_#uxOEJNHk6D&fg?G9L#IKFUX-b(-FymQ=%
z^&APdT5v<X!eb`9jc)&G#9f?K7d4%|c(pqRJ@7-9A)*WGSt{ys#Z#<+<$sKXB^eS|
zcV&6S1QNL4_O7NlCo5lwjmx_)dJUQvbpmsXHM@ACb4^!h;(EkLni(bCQ)m%gNM&?>
ztfB}GA$`K+mg|bne0twEeif%-ON)iivEA<MA4$VQu4rQRrQ5#%R=3eE#a64TYx6%t
zR%roixZ87gCf$?>_#lI>)S+^)ou<UiLq6AjmlW*|Yg3Fb-ks)B9JFSIM!Hs|e%{T%
z&mL^88y`H|W5ztg(VA14>C`56i!L2Nq`$|kwqbDYH1xY*wo<&BgGF{C++4%BHvS5*
zSI2@#kx4{?D2`8|$Jjx(yULEG!&<}0)DD~t^9a1csQ&o=UAQ<kgB4(O`T?8+PV2@!
z;`ifU=5DuJ+ZodSN#qwAx@)N=RRy>Dg}u~t!?t$bLIgzU^6T7=0*m-_X!Z;-zP5`B
zo87^dIh~?WuGh7Wo>aRlRVTIq*wnF9R?&gifImTfZ3n-{{dYOzV4Imo9=Jd`sKz=n
zo-coysUv=F5vB8vW9_1R!NW@(<z4WfP{;J`tK3B^iVUl80!Jf@;MVFdjA=fvz+(4k
z2ty`Deth&@@#D*FD!Q(T>|;d0Ia)RMV;Kw7JXu-l`{SnvmKY3ZULZV_mXd4hY_#t~
z#XO0`Eug3y5_1#!2t-{tW4op%XO}~xduJbO{`8uXsV#4&ZfG3GcGksX?L4R)v&u+S
zKGmc;*zypM1m@R%bA>ZC+i&ccU?QfIUn%SeLfpt$dG_7=W0kk#a^IQuo7AhMq<bqX
zt9qF}Ud;7x@z=f_NNHCaTey$>F^&pjhl6<D_Wa22(RATHO&CsO)P=d19X7L*lUfV#
zD>+?o#VmEv_{ydEvP_;@rkGmp0;Sn3v5&Ztk0K>Y7si7b79u(h$%zfUZxOm_B;aC*
zI0<1*SxRVq{!|aA*F~xBSYan+iF1G8g1^+QK_;;~I1;zdXb?-Y)sLXGs(p|;sky0m
znfq(EXUHPO_uu!7sXo!kK}fzS04(-t6r<z*s_wuZYN5?!j&rC(oTEbC;^%LjKVVW{
z$(||J1?mf5O(@~O24GQQg)cx^j%DC>0SydLh04@18!n>>h+Va(BcDT|BOmOB=T=h+
zB1H$+?^}a<ckk#jOX=mfH=U8BKnx+N$0ND)QKv(P=5&^W?%i22MRRUEw74(k!l@Yf
zLS75wjwPr?Z`n+IvVu1=Z*wJRWb8U#<VcF>U+=X&k>pG(97X8}rsU~x%8U8{@}r#t
z;y)iu9_o;BfeMm3u=26SWu0S0hF|Y^lU&tvbJp4;TT>myV^tpgTR6Kr2b(gB(q)2V
z{IM@DZ|zQ+`wEmjQpDr4Yf+d(i3&0M_bi|^HgS(jV_bugm7Gdgf}MB^0mGq`dRlKp
z&c%(;SAm3ux3#n-D*L!z+^zAZAe;KN+16+In{k1-2f}Ico!S}9C#kcC8jMV-H2CB2
zw1lNV98DUv))bM>_7V>h?)Vb17Wg6#X|ipRQooB`q*D4*sye`nN+*DDn090CmpHuz
z4b;?5X+%;N7p&t=X`O|SsdJa!#GVao(PGtp35^W0zGLf2_0piy(wf~n0qgIJMl7P@
zKZ-`^i*%!D<IATz)>kSV1{_>_<^D_h@?mmXDf45;&<my03|p;B$1p12qVIhhRFy6%
z<g}JEG!7BBZkQgiEIXBO!qmk4#NWZC@a#8nXXfLar@HD*Asky(r$|;(h60)N827Zt
zxO?W|@Mxsn&~`IjcHCyA0F|0x>vlmktnxdb$WoS4yO--zZsEpr#lNeZ?L-PYIk&sK
z=Vy^prUh#^@8kpzM$CdkB{xKgA70ucQVf6A!VTiG2J;Xw3+2dY%d$H9oEvz`(24JF
z<C}%Havl*q(ZEEJWPQ8scG2A(ACx_ELFDgf9f(&dqspCdQtkt?2*vvcPDF6!yIAqm
z6svBK8;S1+i6Kdrnh#VGyxwZT$ZVV|UzO<pbW9X%Bal%xF0Pwi6-*jVrV$Epsk86K
zZ?JuOnoVQ)Ivd&Q;f!*L?$WoJSnDfsMI+~G%UIq(w?u!$;7}KE8OQDS*F_%qk&ub_
zEkjRc$U(zJj_~0FX=7w|YXVPJKcPQhn;f8Zo=V;7)C?`JSA6xfE_0OzREZ0ui|;Lo
z3Xxe(F}pxGlhhC7k%r(?`QkQch6Oxg!!huUy>gYcza_i=mx12Y>GxqI_F0+O<W&__
zr{e(14P_B&uY77nZnZL<jyuuz`J`DiR8>|{d7tbzwxO)uO|y@t-%3g)jm(c4mLTbm
z;?_!0-dt;);DF!VII5#eIhXJ>l?4EJ-C!2aJjVe260gOx^SDw-9m_QvUmC^IQcylE
z6c>NmmQgB2KfbjJYOmtT^op%MK_H|R!IIHgme-C83Pk+@N{MS9`*Ba1^xW<{P4wx(
z!nZaY=Bd0YR{rQ;jw#uKm^IKjdL%7@ORCrW`s7E%PMRBb;Whboh|EgQPZkRCUysCU
zr*7@NTg%qE|LZWI{UaT7?~vQ1=HtJ7g{FH+1+4SBw%Vl~l{r}Pvl;qMaX!sAmtb47
zDqCeOLyi>8j?VhM0-BXfpUJl9-Wo@s0Ls`dP;dO|p-seMw__3SQ_mV{UQLimewC;M
zs~Vx0&&iT)#ADNa{HwZ9UjY)$Uj&}ZC5!BZfN}^z=7Fh9bFiE?(%1g}zXX?bh;-dA
z^G^gD3K*UYPdVc?e131dr4g_M-;{CA8%b@VS-=}N`XfJ7YJ_;szkJ-9FG=Zid8Zye
zd+L?d!ijdd>d_AIw=4Gt%`WNsD4msTx#E7P{YfE5&BN=e>Nhy`BS)>WG+9RNSc2c@
z6Kb|la$$3#Oy8;UY=p%93V&~T`72k21w5OMx8BaFLmnr(vL8j)kEuz|evVNSAC9j}
zwqZvp3Gl#KK*StS-ePjFh$1c(r1;h+NS&lwBDH+zNqDP`(H@Orl)II%C5vi*chb9v
zZ{dlLpx~y3;USUPNe`;OM{@b}WY-F**QU=&G6O0*^XrJ?oq5rVbEed?D`&Me;XA>v
zC5-=L{Sjt8bt|`RO=OB6_J%MoDP76h`doc&o=Z7V*sNNx8XIGeOzQuvqC74^@H<-g
z?lP+;svRKN%ibD51FqdA>Y^0N`*3gdjN#iYF8g>p;trE60oA22aWtWM(OADM+LoOn
z8FyiD6VjK{-K2}>GH?_zBKv&2LKjewj-O4TN}xQ6B-ykjX~<^b%X}n@y*em<SOOP7
zQf4~5L6`QuDHpGnXZ)ytdi}3etYxA?1f~OnmLfKMai=hlZbFJ*&EELXD#m4SEOcRa
znyoLOdA2px@bt=Jy$hAlhMcMpT9q`GReu<<h|{F#{6+@<mRvt+8Yj`?d|o)h_m_)=
zLsBjK>{9_3Ki|8q6mnzAY17q{Cv4hSwQ?G^M^388Znzn%{6657I|-?ERjF#3tnG70
z)6WE1gz~+O(v6UPGu27!3!#~0m#k(!sd>Vehe)aIG`N4nRlcmHkqx8o)U?v`6*GT+
zZ;KlEoYV0UW~NUV1My|rXWWh7*39bJ5KbxX6BSq7jyn4GVJsj6t>n4eKH1ZFmAh73
zeUVjuwr0GJ$9BBpd8eo167qw(=FZY5wI8$t{*|WHlLIk(b21@^OhNSnSJ#^76vzj3
zGk#DsE|JpdTFx&Q*vFgMCrTSq?og~c@swj1=eEMKrTPm7&6wD}>_8X+eUjFg?6KPn
zG$9hHJHioKGikAnT&i1SaqszsKR+k@ryToY^0m3>zM1M6-KOoC3m30HV$aDF>yKVC
z7E2Hi_dRd);dO*)YzL;_W%O;ICoQ0(S|0b`DyJ#fQTOFjohX4<@5hhCcV{v7BI_2c
z$1i=z7TnqppJFgz6>@*PU25exhG1CRXXp2<zmz~21Ar=In|#}t%{G~~E_0isNax+N
zp`V$PXNWAUz_6P)PwCmKu&9QVTmaU!1fM~Zkk!+xrn7&0u0@q?rVK$Syjd;;-E>W3
zHHlZg2Yyc~W>w|Yv~Xx-c}GwdK8%kQ_b~3-rOA?UR`FWf0LKc(au>Tb-5a3mxk3MO
zy|xfLo&H^Z<RX%XF_FjT48d9Usi77q_neP>;kf1Vj+Y!38HgSnxOz`lUQlV-_{`X)
z^WDL!6;<qu%(O|>{Kr--&;HQ9Pt9D}T%H${m!CvoxURx&WBg4t{Q<!}V^W9dTjzao
zxMF^GUANpDNIy~3McUyRBR5z@5ow)JNPmde!gN1EC@KjKSmk5>_~C(Gn%S};p<N1<
zmcfnyMDtV{>p96U)5_%DqOZjgp1<hztG10hVa-;38y~<N)#u9UroW)x4rGF-4E8~o
zsqAP2rbp(2>%#<!ChH{BQ=(R(|9j`pS0jy%)fLH?VsB5e4ot7BUb?k7u$NqLt&p1z
z>rae-s=#kKJU#bL{j-r2IKD15%*{cL+bPvIq}F=q=S}nsmhJt-JoN0P&HVfIVe}F~
zjzDmL5b>u6UDr6-PAJr5;l4$F*_LKc6+7(i{;CbetG&kKYn@_=@Pnnf+9#JCa|OCx
zUA$+3mi3#K_VI?dE~pso&Z{TA+JbRlgT1*2d^2kGMejf67QKdw(;X{S(w<}phwD5t
z5;@W|+JB%`R=OX44N5)O>Eg5+?tk=cv6Ji49K%Z=2)0!#(R7kAT+3OPQ4^b~qnk!l
zBHI8C8Fj`8CGO+zY$+fm>W)g8^H6fz=fk2QxQAR7*#2<$rNN--?RGps)7p10tBbJ&
zq*EY{>q9elbg_K!=o-v>478lB4K6LV=uezsU4lw{`0vdLbjnbg__LqqPQc02KYMtB
z6}GC|o~$a4orgGpu(Ygp%xRIQ%Zyvz{;%h)<vpwqgeKgzgQXYvB<ZYmOqXN|KV(#7
zCyzc0_c-Gc+4pNUG#X;Fkz6HZY|w#zT93S;rdRp)DVMEDmhX=`X&PCT;;w4%9J`M(
z`Gc4pxSMf=Q9jkv*!zLFSI<3vKE<Sjt9*Zo_bGldD4=2V=$~=vagZkyh15CR9-S5F
z!`?3r*=>+G+<ED|XgAMoaT&A-);4y8V3}YvXh|#DD3U4*a&7Dcr`9yrzHf2L#MJKI
z#Kz$_IUTN0a-6EopnGng57;2KM`W+cI)hN}BAZu>aZRGv(Vgn~6*^cSSie7c^H>FB
z4g~4M?l}qh|5RaX5<kU#)EezRT-CCV=Lhrj2M`~1;i0<f_FK!Ou#__?Gxs77QK3Oc
z-+ufseArIhXfhqxTKqbu`fle3`Hdd>!EWO+jfH?oR9kIYLdaDtl`QI3cd$bv;g>Be
z*&oPkcX~;YxKLW(gMB`Bm^v4w>qmN<RS1^X&V(<|0d=Ji*`vjeT=nuK`qYpC%xmCl
z1=CTc5MF;Rj(~*{|H-(0`+so>C&3R&M?u+wPjP}swBGztm&aLO4jUG09uIzW*?<-1
zcx)mQ!I2*RsBK{VF)-Kzob+>>%UbU|TG#qh31G}Cx=X$J2E_7oL4I|NH`uTzhX6D~
zWS7}%?3978?%M7ytjhAMAv0zNXm@z9tdnB#to>l#px->AQ1Mqkdu{p7c=#B74r6W4
z+ljej@4sG9(uixn;UMw6<3SMSL(jYY4(9tJ+XtMJmOT$JTqe&?vrIo<{6WfaIq!wG
zFK;<PHx9TqE>M3o8Pw%@C#m4)E7y9_*07Dk6(-0poocuPNo2*})|ZT9dsJ?z1!q2+
z>`Bs4%e&bB6BguXWCFU=e&&-pczB8KIf2DP7CMa7o!nD`jrAVBCvi)266soj+f%%x
zB%`dCrlA30U*u~Tm7)#C_QA2aD|D@0r6l@mlL0}W;<09t#>^B!pU?K|QRTVuemxO4
z1m&4XZc#hRD}WFFzC#G#Bq10RPd_=hVAoH%r6wXwSD5o}QJz(gLmf3m>^u4rVb778
zyO!1e`rgYtz6EWQOG_qkFM|dvKMa_@cey<WTfnnDvZq$rh^|R++uh<!zri%U!Qmxb
zfQL6a4d1`nS6ZWTbAw27-+&{0Dxh9euV^AgB}(&<nwFQZt%W;IO(P0J00(P6Cxi{?
z-?t*HEDCj;n8E|z&T)}>R6-4@%Du5Ic3^ZDs5-{5X=;y^2?^*R*6s89Vxn#=nMCs7
z{U%;z#04%JgyimTMW9;r)Vv(T_Vb!qOT>7-SV`xyB_jp+24}M8pG3A<21C(Z{#OLT
z^I?3M^4S<++u>Mv!@NVbf{WjOvFn!2#Ec~FdL~BPc*oF=8`w@p7T%E~NdqNB)Y4&>
zY&ae1?EelY<(tz9<>Q&v3i`UE^~;*4CNR>8)m`R-`j#o`02&vXz4|<Bpa`|AH8m+J
zp0UHQdq-pa7*lDze&K4H`0CVHT}TL{DG42ruN)%VQcB}MQZ5)}vQA6cZ0WvF2^mjL
zG?VT837wd4el+d4f8bpB7|T6T<;EF1oLn1*QBwt1VyS&pQzvMix-Ho)kExXjp*FZu
zcM&M7-xxq7t_f!bvcp)n_Y<22Zp&0QoeO=xyI*3d=@1cL)SlOT^tF=U6Z1^i_3VOT
z!0CX%7v<%ex%lnQDLP9%#9VHFfBVVRh4#4NMESe9{pU|`=ilFruZQh5QNU{CdYme_
zRdG2Wg8$k<)6El18-H0>#`Js-Il^e$aDgYV-!~;mmhWS?XY6vyeiHw70%(9vc?(tQ
zaTRZ>)&6LnV(VvBM?y8vLW}lYElQ1}(~n8$ew`o=O5pt3l`V08_@(DOGPj$f$bSOS
z10)&#&azbDN#+%Iwo7^@a<h+YYkCliZN7>}PwG&Yq&jH_b7M!}55sy9TooDvz{zR^
zP=QSRN9{RXJI8%K!cQQBi|t<!*3+B~E}Gte2i$7VW6Z=JCNL}2Hrw^R<MvobZlDfx
z{y17R2yB!7(2fJ-%J|f}_-_Q}vuL2`-EQtix0waxlpSa__Il}*3Mkjmf`?<+h2Oo&
zEoXjpAR$%Mps0D=j)-Vp>?Eh$-U1cW*jo_%hBuUiz`Z~Zmp4b@3}f$}-*-~-|FLu~
z@JxS?{~w0A&n@IOce&p}$UT%>>JxImri<K)DVMq5??OUCx<{y7hB4QYTPeis;+n9H
zv|+aYyYKJs@xUI&W1IKcd7t;|yk5`O;Z!t2=?K`n#q1BFtCn^sNYsuPScY%4;fmK&
zS1c<Cr$9ouKbXKj?&*aL$=MqOTzjk-+x}1+%z}R>+PIcA?{L8_`6y;9>TFM+&1^G2
zs$N>sKBq3ahL4AmDIpv@(D2`6+9}UAlJys#@h=*~vGU<w<j07}sXjYREvLn4WrIX;
zF55cJ4#f~KmAS|CVG{AUeB;5Sxvm9Qrhwp9y-h>~uMq1aUired3IQDa#$#0B+_}G~
z&S6MA_PnmyovHgh#gH10xmd4|dmYsIwt?So@+)|l)>A?)?go)A?-=QD$-iE=?92bi
zO7?{C{wBpk|9r+S>${m-!IHs~gwH->9X2~EKax4S5^rOe_uycxWF#TXELct?`d#r*
zNWF8DEae$?^~n^cFM$Y0&Vmz-w2eAmFHIe35;c6$u7y>-2L{j6bgYbw2vT@nxM_Bl
zfGV=y$o?b&i42T(|J0)Ou!eAFKUv9m-Itk3yOGAB0CXg0&I*!XJ^<q|Cu)S7&C=^H
zApGz#9jy<_!ivdX5rZksfft@;Yo_uI_a8qyXAJMZjUmPbz_Z-4eA6`JJ`(Q_#pb^#
zOuLD79j4$0B~rXsOBX}qPn_@8;)-C^u`2f|m}DGMnU8a_dnfI%Z`g%;m@h=I_LV@z
ztLEPYIQ!lA;2$*PlZpk5h6m&x$U8(zA6SIRX9X^5bHw^C_H(x<%`T~c=X-<fCLlXP
z53uKnzV8Zt{2KZ9<KH~;qdHW>rZDOO@u<OLhZWdoc6m7YGx=IZ5tp9Ce>_L4DWFlA
zKFOQ0%WuF{$L|t^v-mOFjC9q8c;2Oo0s~`nIA2|BjMo5OVogmU@T#Bc?Osq`0&<nr
z>n+=kM|eRIHn^Ewrf9uWGn?3JMy|wjplBY`@pjeH+t&^v1WYxhjPFc+L%tXAajlM5
zc6hg8X75P$@#2xa=%uUyL8w0!a(T|^Sdc%px)*7Tf|JDoaq@&OV~-&M7~c<&U0D@z
zWW}8gVths1Bv8Mz6n2B>H1%~vxTe`GN7zv}IwC*Lyh4GJeff`I1QhkJ@bE)LNv)aJ
z!>@F(pfk^Uqz8ZPV_8LFn5&_`?{W|02+vDNnB<MsP+5+ey2~bH&F&gVu=tO^?b$I$
z?K&gb;P*`nEhRPP>|As}+V>}NgV}w}{T$UyRRg_C>fav@^#UHGEHCA{yw)4P0D(ah
zDAw-P9;?Zs!QSS%c*X_^dsf<rEZ=H|aBZVynGmPmX`g>sbh%>x-7Tl;jsx5Y5APPk
zSSBubA5)+=`7zKJaDsXqw)&plqL|H0EY5%gf8&b_E>Ip^1F_gP-s|}eX3f6Uo`!jB
z#*%X*Th`C?zp1EeCaw{xe3pE`uuc0xnfiH)AsKQ0Z*-=J_yj8>6)X1Xe0kw+pr>c$
z8B>#4DE^b0Ol<xl2kJ4&+GoPdk?NDQ<5!kk{oul*uMC6y+|<>y0z$2GlP1p@GZRz$
zT7zu#O+f5S?2PNytZ`=S(OV2}tOMqJ_={vFV`AJvTsKkP+}60P<)meYJsh*n<-cNi
zAGQC&;qVsJo5;}t@dZ2(^a3A`L({K)rCDxTzD$@LkEI0!gPb!?s!!st>cYoHN|-US
zQkq`BdeQAo`kZ3BeOj%n9m{x!PFfwDWWJnkBX%nsE*#MO4<^*vPu7{cp(yk%^EasY
zhuP>}p#%L6TGrxPIy}?wDWJ>+z-z%OuwPg+09U(5;}i}(8jMYEdP_D5M-)C>0v9t8
zAA-^KEb~7HCXHA=e$rx60NR8@P7@-awqOq{+oim^HaX|$@z$+}|8exEz8)<kfnh9u
z#@EVx%c1A1KNcO0&;}wj&BAH0C#jbdOc@zMB3^B`x7!&*|I?nTE%75Dy=x0ViBI)}
zv3e*fjwYJPO1R5E?F>}tJs}Khw)|g-3bZ5A78>KLD_}Kcb$Ba7$p5XWA%lX>iPHbO
zz`zfIAlE+rJYRYL2BQO9&3NYHOxjFh{Sm6Ob9wG`a=Y5q4YU)z3KYIt1^2XT+);xk
zIkvA?oiJ>{_SdK+8XwXnE`qDH#pzL%>tn&CI<(4it~Han;>5BJmayYtP<vw8!zKmq
zoSQ+6fu~7Yw)zvDJ^@N<Lt(yWJj-2I8MI%DrJi)ji)?Fc1B)8MK%fR;n@%Q)ssyWT
z(`YELoaq8Jx{u?*)0q-Ks4oNb3X4wt<?Ax?w)~?nvTVnB#LFTgQUyMA)qfy|Mes{U
z{JnU+E#p<jn)6RQ;O#}4ZwjZjhlkR7mV7%=5@aR^s|?GUf^ydP+b)+-75QMcm2;cy
zr|!j4r#LgSL6bAa4+pAV-Ys#|dwQ=JVNHMj*&yyViI8OX^H&@pqW97L8>{U!ttVRV
zUP|#5jx%g9CO@m){mte1x>L7_laoJ0tLZU+7q-r({mzXFtB5aRj8+~cu#s4AJe!gx
zFg6HRb843gXKd{9ru;+|miD@<A9Z&t0M4I*+LO;lNH8kYLXr~4tt@b?Fd2HGo^d>Q
zh0NOxPU$`6%<;Fbk;8p`i9yWuC3EF?Iq5{?_c>!g-3S4pT;QXkWLLzf=(5m|w!`I!
zARp{t$_rh(8^08ZCZJgJ<Q|F@!y<wXsyy+~h9lVf&*iWkI<SraJ7zll&!A<w=<+vu
zqT{yJ`^kpXu=UTF&kNZIJvldRX6AQBRp;2}v?MQ=Z^b{V&5b)k!*a+||IMSdJjZYs
z+63Z@o`~(jwllzx%a`*jt72k1IyyQ_Z~MIt{g!fzP#9WT3`biqiS7W5)>r@|KByrc
z;mzq8yx-ghy{X*Xq+I;0h3_8)doZ?;+c4mvd-&hW+7!TV{vr+(<lda0xYs9f?^-vG
z<ic;dZW<Ea=e)J)GmYT$D<v!Z?R<1}jOU~;USWQ#0Y&}b?Z@6nWISL>J*QfmBo5!v
z@oRo1JPAngKjfr>d6hxlJ!#liuTpN^Muy<ekscci#OFC}i`HOGK0iVXOn{`jclSXW
z{6|xYsK9}?`f|N>P$jGX#KK}lVQ>ZEREfPEX_8CLIEgPz4dYkapVRKDEDi#@E&kpn
z)`+<*>0EwjcxsC-)^}lY^1xZspn~z`AsocZW^H^s_~*ENrj$m5T25(U3c|FrIa2~i
zS@XUCBe?3e$BurmQ_M^PW?Q9>pT3T{85?1I<8$_jVfPvX)IbhMRq2OCx0yG>Y<+!Q
zPCnap(yW1c2P6YjtB;lv_ii^tj=4!~ON1c3gM#1X<h5Ib-ky*&BfpyZ=}#~}>hz!$
z9ZMdm9Q)!LJT{vPF0Z@!(!8(SeATP*;nl6(&G)A*BdanLQgV7v4?gv=dbxT=UFK<~
zs~b&1b47%Klh@{)u_Oq6-M`1mKr>^G1UeeQi4s1LBh-cl?%aVlgJKqfND*^){Z189
zp|<-BHl6ZJn~_8jDP$mh5Zm1Lde97A5|o=;aHUiD+|baX*h_~5v<$y5{4;Wb&`B3#
zhNvTvi=iN{FvaVGx6N=RJAZ)^G3Y+S4a?|T&{d$HnUev22ZL$cinzotqR?3Q-nSoO
zExe?fV)i!k+LrSq7}YaSc;i_del+@#-R1{(c&Vw`z^lo`(7}EQ{T|Jhj73&@={kcc
z{K;Rbb9aifzK<XZ7uVx8@MMR$V@4aVChmgwdN-qaHe>PRf0=(1@ArIxzMn;Ky<5nO
z4MpV6J{HEoEV3{wRcS#}X75yVcwdcPfQs=a-)8+!ysoIj+^-qFGR*wbYN?aC>6M5}
z9}o1zjC)Go!6gzgz>EQ4a+MHdgYNP1GF~(Po%50v?erc76mS%S2_n3HMvokhu<IGD
zo_ewl#%PV_<3zH3&HsS09QdChy92~vo{j_ux$VI1fFGu{#CW=RA4~MFSmO<Os-1};
z2kSukOfc{@smRMPpfg$wF$~*a@Z#8vxGX>Mo1RcMG9<T8T-`}jS!;2cJbU{)UAYvP
zOj$hsPTK^`GWv7Zg=4y%@6!M_s>O_mCe%5h7EsuAPfA`eX`AWEj9WQ9z5i`-TmA`!
z8V6dtq(DfFEmL7IC_TP36C8&aM?4%~=Ubm5LgU@^u`)B<!Tsd?Avd;<-T@Kc45&7X
z=NoFCGS01fP_X=<VC5Y$-901Y&hC*>%(uT{E>q?=8NS5K2P}JfHd4<~>kOV8mroSd
zhFSbqa~5R5LP`l^F;RK_lAnpuuRn}$bc4Q;<%B<{Rm=dEuuMyVr%SmFH9TuO&JA05
z(0j<Bc1_ZRhYV9!cH`fv>0g}n8KO7!WK^FO{I`;zZoc~cUl$3=McdRA=tze=DraU!
zO}qwd@`sF*ul`L*GPj!Ps7b)B+{$%a6Ulk^@&DaTf;BJKo2Q<DPrf;wrr~7voe{q&
zNU7j@aX#=r1Op00+mrZy>5*Rv65fPR8LABGeFFe(?YrUbbv({{cblsvoSJFFsNTr*
zKMjJ6Q@m%Xz6*79d7+`9q3>BYmWF1$xC0!2XIOzs083+Yw=5@szA$=7B&M8Cnegjd
z;Ny%)iWTq`N1Gtw@C<KgX-){C`GI+$EK6a3FteiuM`|J^B`-I%ZDq^<gD1L%dISm5
zlQ_UE;O)g0I*i`xNIGg!I%2-@O1>ZIc=$&0t<FA_P-*wfQuFi?y}2;v6#Tf56$Xn8
z<5w&VNrbX$R*>>e%@@N{Gnvr4hl9|*b3<c8BXd_Q-f!mKJ9^8=r{wQWoK4}YGhi~B
zvt~KoKT-eouXpy{D=*5=S1?GAL8iVh)4$A8W#*myCGPL+_gFvuaii;^$mBX{A>|bj
zOEiI90nR0)15AL4B95iDo;HZRMecn*ba&WL-2xp8LZP0zYo@%pk{X#VFxaIsW3Ry&
zK0E;K=>5_ZFUS7&<5}#p=kJ{>;O})0XlF8mM!pOd?GD`c{n3Wv!Lb~B(O9@qzevEF
zfwQ|Sue+>sWm1eMlmp&Ig@e!2!SXwwP_zIfjYboe#?_YUd_E)kU!r>#G11~KgHM3T
z+36FQpMI3=w%Rqexbt}9^|c4TeH4<65$wLM4D?M97v|&JFtG8lvxfHJ#67CN2TxcT
zz(zfpoi)^z^*g*lkw$Ca4~+My%;(Jrv~@In?Dqo!RGElA)jcm8I3${V(&_63x?cF(
zaCMv~<<S!P6xE=p`K?)I1PcQ92H~Rm$Y550T9)1&`XaKVUC#r?YoIyW<bEzT36_55
zx8|G6hzxsP_p24Dt~$D0pQel2gn(ni9l=6syi|UD@tK{M!9CGNw|3n|wr;!W-rl`q
zWlTn15iT$(0+}&;zK}1onVv{D7(0`gR}XAV^ZrFV<zlP@2M|87QE|>AJE$^ZcWyS(
zU}`gosYU(pyqYhb_wyaju4}QsoX&>dZ<>hBJMr&qlvB0MyP4bam^1jrB_km+iP+9~
z<+~iwr}*^U8fbJsf=ZmEKR)}kr*<tRo0KNx!~HRLzW1KdzT^;)Q>exHH~*X6WXPg7
zfOYfW6?${X-flD<VN5l2J7k#E@}BKW>dAFo62_Gfg<Ik)dqSdyRna@(;8Cs=vo=hX
z*<2%cHfMUog(<OskG?^_IeQXh3_#j3GpFNz_uIBEo+WS5xDcscgY6tRaLft!kJTGj
zEfm8N@4P-@aNu}mw?|T?{|>CrMHSN&n;DOw0d8hIoru;}x{bzhY^J#T?MWK3hGC31
z2-i>iV|cs2hm~k6-MRE9LMZWOr@_|qcpbc;An;6?URCZ@;Z3!jGi#){loubc$A~ZV
zV5E03VB$Jz;WVAU|K~T@_Ki&LfzuW2w;WPm>W$uB24oubxJ1qA$nao)sH0K#Y>oA%
zI-bSxhUuA!b96^y|EI{D|1OE&(T7hk=56mD_5e?rJ8nmsvYr#0GH{^0!7JZz3fhnn
z@#OZ1;w1;M8ylf244bDBr+-Nxobe{ix9d;L8c%ADTnl@oqJP1y&HlkvKVwRf>A%WI
zCJ?=0$?iPQ&gfMLEM_fvOZ6&^E*K$jY#yF|!qp9NT1yf&gLh!^n2Sv61u`q(8Qy}#
ziAI+@Z#$fsvTH|eUGKihjr92}E|hWiK>@-nQ{qdU%7LHVeP0S-eZ0uw(-D2R!~hn`
z=k<cS%kuPG$m#`6Dr36?W*pbge#TO-nxEJ?vsGxoc=YJ8@ZIlqZwNc0o2=fR_h-tE
zzZfJ5-u@`7g7UFj6KG!2eX#@yRQ^+J=Qh}ozTV<$_)v?K2)V4JM3<6hVXN;EuLM?X
z490;c0|00jZcMxQ(0v4EdG1pgLvrENduUzH6AKKlU*#H~EFDl=C_R-#-Ul|dJJ+Lu
z>Pvcu+vC-RAG8vevM3IfB;RY6=l*x{^tN#z@JSEM7htKEZ~JSK9lEC%-(3#jdy-~U
zqP6u$ZRI7JneTC`WhTh*cAo;!&tZGG*(I=aW_0LGxKvp~CM&EwwHbjf0BM$elwJ%J
zKI`@wIouKcp}QgDjB~tF5?8}7lr*DT8+*=fQeDBj;`&zR``a=mt&D@?GbFj2dcSyZ
z>J2xqwoM}nuY0NmQoDU;JF=9jwfL_l?ozP0T;AL~BFQDSN$gADwJ`*8r$cVD$J>{?
zgUPh%0N~QtZXD;3rTcj)|Emg(r~lImT&9b;uF!!F*KhlqziIRY>KWhly;l<`pTpi$
z%ZI(%3E5s32o=zdGO7#`OD!8znQZ6u<1ahpX`0+R(!Wu<XrC9t>Cap<{}&Uo-8MM_
zM?VCmnLN@{FqkqRV{j9J4AL`@^MA@QsyS!Ajj`YLWRQ&vI?h1OKY9h!+ljs4H-(tj
zbKp#W1}{|ngudl(>r4bzdkPqgT^8}XAh<oU`t45;^I{v}!)TnOb_`u;hjQns{_<U)
zo%G5=S+dByok4^>E!JuI&zvw`?%VVv99@!s;b%`*!>u`|CkG2l#!FaMQv;5jBi|aO
z1otM6=PpJ&NA0uS5QXG2#X!Bs<O}66A&!c}1w7PJsBiR{49j@?J<pcI?XiCU^W{mP
z6n~w{Ci5PqNY_t;y+Z{?<{3pg*_mFT#C85AecG{eLJy(gHwtgS#3GrOhCpb$YCl*L
zkM%C^^<@C5Iy1yi%gNaxp#Mc&yyhZ;0ra@sMn@G~b=!|7$=n5)G(h+TZwrz$IHRZO
zk?eLWj=|}Nd)qo@h;-W<IoA?eEfz#%(A1N}e*X8I0vgdS%~=LA&~yZ^;r+@u%{N69
zdPnA9EF2_R8Q`PQdEC7>l^Y)l<>P%5oM{ni=)JtgOV?(*&`jD)A#yY?dx+PnkUs5V
ze}}dXG!$I<UU9lMpZsuY^O~L!nLHBRd4@3%EB@lyMGKW3Mq30?SL=Jlr#hS7cPm#6
zsowazj$Shb5?n7vol3v?61+}+srLmK)FFJ0cq|XHUQdLV*&+fzlgi;E1gteP3!`Cl
zP^W~Q*jHhDj!Z9+e#g3?rlyMNX+}zO7L;$~jU<?byz##qsl7ZSHif{fa7iyUIQquK
ztXzTCq3aE`3at7IAs>uxdIc8$hDjLNRC|n_p)lSkC20kApx+$Ny%zm^ho@U(ERg{O
z+g0~=%WD7f?9yXitV%LyK1|{>B?oiWCMg0^@`5jHzHH4;(25xK;nR0YdL87hCKlq5
zLlFaI<)4e`kd7<*aH{H}sYWZA3=C;5vY@Zgm26*vDGZ{Db(>6XdRkrfZ@~>5t&Ga+
zd3S^M<2{-~fIi_^A&_0O%YN<TF(R8Rm6+buD<@H1vpj74R|!yi{++{qs7h4`uA^O^
z#Py|cwzjO1qwsOo4R`|%R%X|D8vXYBYU<)gY9R-Mj+OdF(@l0e_ZU8Vcr*x9L=p&V
zUgfu>I-Z@%38>DmW<AYOONDZ<R_gp&j}KVDm2W7;;#Rf?`+3}Y7g+|l`>N{#<0zBQ
zsSE@^xE)#e+xZAr&K<6@|FPus_WL{8DIRAX!*`CB=DwpoN&jdjz<j=csZgiF)w|{H
zc82784;U(jEZ`rxG1~jpFPm?oG1>T+@Go_Vy0eqMq+4E}KTJ+rW{^M`w-zphF{r|8
zHjexi{wJF8i4TiLJ$N~_*@|H^#flN9ReQ{qde>8vV5~CYPaqt(&hRD3Gl2`Ex>7Z8
zi$!&cdkv&_N+6%bYvkXWCz-4|!a;sjc9YFwq=ZD;nqY=>4g+t?Abo!PZ&o5LBpt|)
zSNuRRizwHNMi1Ns@%BBlWIpMaX0XB&4>~LTWVZ7n0$2Gnlie*0#`Hv?4_<GAgIqmY
z*6MGR<VzUI1YPI2GmxYQ?#zE^BIgQ{-DI2j?D}^}B}huf90!5?c*Dq81o2n$NY2l5
zPS`NofBO9uZcB;(Fq`c5Yr4UfvW%h8g&4r1_Fo5+|9}vB0MS}m_<Vxu%wUK=)yJ`R
z3Aev&zi_Lxd6@daMhVWgRQBjujPA)3QHc!&^-c^vKiJJv&!c0%#KM7VA`}Dv9mHQ%
zy>W2xcA$_^9!@h(I#Dw2u8M~t#jZ6DB**B`Z$&KUwv^wBz{TJi&vYSp{g}E|x(#lY
z;#wy_S0~u6r?OV#Bvr+fQzl@mb03+w8h|S^&GZk2i-qA$4$r5hQ<$iK%%uz6&-5iB
zLIr4&sl7~c{y~jCv1-Q2tu+^2t|ZPGGf3(56p_Pz^fmYfT`~fMUBm>)9&gAX=423W
zfWH_fQosMXPjk*9^@7a`Cle`~OXH^KIl%)aqqdM^{Wsr+{AvO3Qmc8Deub)UGx4ue
z^BF^+h0fH~=q;V|mt}BH>>_$u42xIa63}TTJ$qlZ@|oA?PL{<>QKetRQucjB%B|Ia
zJql3INOsP0DUW;wUNV=ALHz6L29|fGV&V^M40Zpt(+!!%!|j?#kPG|L_x8429e{dR
z=oRv-9zY9<f60ckC<Tz9k@h)Wm*&z>hEWno0x<rf^X}c9IZ;34&~pMtP|1%Rl3xn#
z-mbp2p?;7F>?7KHe)@8BaPKZEUCT+IwUO;3<;gduBczU^yj)cO={K%=bHQ;j!z`qa
z9M^4EGD2mpn7nJk-;~-89_oH_o!-!`n-qFaFGZju<v6VXtMGB=!nvN%ODF~Q=L4Q&
z&tv|QVCf1EJ7c?Efy=I1lJ8p*RtW?K36?@T0UndT`aEd)e10YxSqqjaax=K9x6jSi
zf0hSO*{E*`lK(QgYaIAz|02^S=MB@VVGxe!H9`v>I;w;g78n&w$aC7ofgs8(bDb|b
zA(nByLS4!hE&kOdKizvve>C&IGw{C&WW6KI+3^kvpNgbnX(}JM48-^p!(=B>TtQw?
zY4nAyC7-B%+YSK}Lv`Cmm$8zBaKp(o5{v$w*Hbr7rmU_$ZFfP_zV5R(4+ir1e_`7E
znA%G@z$g2RLrQr`xp}95QhoUV@x@MgV|`hs75Cs1;)wo$$$~03wGIjaRiT7mKLoX-
z4a^K*SH8^xT_wA9SpelruIJ|5qv<o<pYHQY^j$nzb2U}jr}%i}1%u9iJ8}?xRgT0l
zA8RNP4Z7WTo&tp1#}9It-8=2NA?D&i^{)i2tc6yqxW9esuc-M35;8lCcYCsOBnUp?
zo&w@89t6qBjiRa=xBb01jQrrwY43$CPl(tb5652SL$9z=Z`-yx2xs3YseYj;%t~<K
zPyT(()+C3Hg}yJ>zFOKg=uaJ(rOTP)9inw<?~djzoy2Vb5yk4w*(BEakC3H`u8i4n
z)*9x?9A85QZUlFgY|q~C^JM%&#~&()r?eCWyob;7H@bixto3ldSzdSQ!dV{=*SCBO
za(<sEt;@TZkX{*GbouZ;f)~fBw&t=XVCI!S;&IFRyusZJs_Q{=#o+4A&$@lbHxBY5
zuf*{DtX@`Na1g?>=#}r(+<R5(Fh*CDSLJ&C>H^n^s--d>YM*maoX<}Fx~r=1_2him
zSy#Oq!*(?z|86=rO1&25h@`0_`C^jw53w}klwvud2B-7z-%m##0rN|=SfcJF{D_E4
z`Asjw)50eO8^zy$k7^qkXaY$qlw9QBw4!mxm2e)sy><n2yH!zUyYMS$+@b$X>@ttC
zSlcVYk5((*7a+HL<VWsuA`A;oh9B$fc1A#F{`CF>Q!@hZSGPP*>Sa^Ug>XiC1SDf!
z(ikr{kbNT_-mR3>^lH?MCsSW1+*_Uf^E>4Hv}$A-hv~^sQft!0Pgxmq&<-l-i1lep
zVnaFQ-{KSvQ?$^#oONJ!O>W?%8Do8WcZcj=H6U6IF(b-GDCiv-DRGcU9dCAXfGpM3
zi0pPm8YSUMfE%<UFD=55Em8_r{jV3WB~t<K0DX~Z65Tw`UMnQWb2E|H%K~P$N*7|k
zjNH4?PM1>vRAnF`Z}@~&zos7U?iPu76uI;rHtRbe%5uUn0MWzsyJC$Yx$6D)SG<ho
zqkfHy3#0ivKSiFs!<+p<?3#gPpjYxkwlPF*S&MlrwDaF)5Aetx|1_h>9G*+yP8!g(
zau)D%5Gf2Q<j)t3E+ey-<icHi!;HlAXT0v5S4c!wac3|ndGV2{)nkEF(<GJ<U3Ene
zwmOG&Gv%&o8dNo2;w&jGub?`PK@+|w65S@`V`)Md$Hq>ly^heS<-8L4VpSy9wp+$L
z+w;*&bO`gMc!8mz5tBAF;kQZKpu@EXExEb8ehTk5DBahz|3fiaoKeuH3V_}%&vgeX
z%h~!Q8R`de=>&h^ikc>;Wa#1$8CgjZ*RO!Wn_^>S_lWd!pDJc?D*~Ua)r1#bK1r!d
z<Nc3R*a15?|2^NXPPzqOF5W;0#Oa0x90>idk1_Jn)YXR;%B6IakG6&M<*AwgPzpyt
zhO(&YrJ-Bs<aExmX1+XY@QV}8tY=}de%nRE%8j|)=FmPXVPW3FDlWrs=fJE}xjr2J
zmd}r#sGbTy6#X8vD7Sx=%yd_FHl@-pB*P&-O9%Z%&1zsKpj>oQ6Pcx$@w(sPqPF>`
zf^)%mCUgMgs+_j<^&8q5$z5!)e8>m9Jw5h%-n+N<oNUTs24BXIor%fZ;{W$Bz*D<f
zRe<+zDtCx4%Copdy@U~QnA2s|cH}R&7P}Rvf7B{ueah-H$kJ@<UHk2yfBWC=9Uc|Z
zo~{3Q8&RLM`|=t|@#l??|2E5DB4k~z{go06=x6J>-+w1v==@^4pmWP<(t}Lkf1584
z9ZAnlmBu^n(><-_8-%2GwKIjl($fpHsjJ(yD!H0Xs7&Fn7gFp#FlK*|kSW)a&Q@MO
ziyatWY2H#wbFxP;CTRjbbX+R`>}&puX$#nF1q{Hkq#y*d`;uui7azI7D4d=N+pyAA
z+7V90JTxHQHY*<JRv!kFlIl8&+Z{iCbEc~*!%m#?s0lVTE+HZZVg<PY&?}(#k%a@L
zCr2yxUIQDI{{}Eux{xuk9YAl;X5tP^Ic`ehl5P;I>3i86{#xW@buz}UroZ&V)jlbR
zb=ooerBi<{ei5K#iQeuL`}wEqFY5OOGo6~Z1Y}Y64uF;NI`C%og+jt8MD85)(WPs)
z3sxDE*Hbe#z_po@EObsLb0<+2*{tHnQasDb5A&#}&?hj-Tw$Y+0$bX+ul<VK(%3tS
z<bP=KV~f`y!=2W$7OyTVcl-NDW7y;)2}vX8($gB5St&QYr@O7?0#?=QPf^Hd6YuJ3
zPoRk1i<sqQ`)?O%vN<J;c*<~NjD4K%v~3d0V<`>(sKofT$D18;6EMyGUE5)24$L5V
z78%wZG<PpJHX(@Y7DPu7AM;o@NnB+6Q3dSfGjPPvnMm>JLtJ6u(-9TI0a$~A5b5E;
zdd<cS?~t`mif8!TC*C_0cv2gZ7AbmbtO}ksaUL(WAoy9q`jqUI=>xEG<c{3R5)C2+
z=69>Vj|C8N|I_so(_Rm1_QQD%;1Ld_fkdi$BOg<~9*nnR^ZFexK6xE;J%KmSY}Q1o
zId%YQhp;=IU+hHyon|za)S-L8<zX5)#d`;rO_J$<4|NVi!@6YZA>0*od(i!|%`URp
za9^R%QHttatc(<6RBdXRB#n>iA;fF^$Mfb3sQrm#vo1(Ii(pX+emb<oy8oAE?bzQP
z1gkX@^k?dX@G%S`Td??3Z5=ONPp?9um|>GODvD3D?yuoGu3%K>+vTJuglo_J{A#8@
znDS3_eqRTSk$3~<vlvH4)p101C{#MrvqewU$fC<cK@;^f6--l#7rprH!JQLA_Iw(5
z1SPJY+O?mOpgP$vbq$d&_wYUly6X!+sC#PHM8``DSB#3wGnHx-5soeAut&dnVw#)r
z&ja^So6zxoVM^TE65Sp-RRQL!&4ntUz4YEI@$wAxCCgB<@Z21F@i7tgMrgzKdjTdk
zy^ch#4*py_n(wlmKKZHi7I1YpRclr|sL7q-%OY>_w98ADYb!-}4vHQA*dZiMZlYSl
zr~~FpCRQZ39;}JR&O9*ByO-QKV6gBBD)h4~A0Pzy`37{{QGKG6Z_)?Qm5CXxCHKW2
z`wYGWsxlksnKB3>V9vX&&n&8?^9ST+<u00(JWh>Ambl(yxGZ{)pG+_!IVPe0PT3>I
zXix6;=&~|>egDHsa?h8$d43t0a<(n$vro?3#?bm<(%0AwiQu2&gE`|knZ)wL`3Q*n
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%0A_9R8YpiOKy+YEQo(a@YACFyab2d#@VxlILDmAP
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


From b41b1e239438de47012033fb11a523df35398e4e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 31 Aug 2021 16:16:53 +0900
Subject: [PATCH 0035/5547] Write out `DifficultyControlPoint`s into
 `HitObject`s

---
 osu.Game/Rulesets/Objects/HitObject.cs            | 4 ++++
 osu.Game/Rulesets/Objects/Legacy/ConvertSlider.cs | 3 +--
 2 files changed, 5 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Rulesets/Objects/HitObject.cs b/osu.Game/Rulesets/Objects/HitObject.cs
index c4b9e6e1ad..b540dc1b6e 100644
--- a/osu.Game/Rulesets/Objects/HitObject.cs
+++ b/osu.Game/Rulesets/Objects/HitObject.cs
@@ -68,6 +68,8 @@ namespace osu.Game.Rulesets.Objects
 
         public SampleControlPoint SampleControlPoint;
 
+        public DifficultyControlPoint DifficultyControlPoint;
+
         /// <summary>
         /// Whether this <see cref="HitObject"/> is in Kiai time.
         /// </summary>
@@ -110,10 +112,12 @@ namespace osu.Game.Rulesets.Objects
             {
                 // This is done here since ApplyDefaultsToSelf may be used to determine the end time
                 SampleControlPoint = legacyInfo.SamplePointAt(this.GetEndTime() + control_point_leniency);
+                DifficultyControlPoint = legacyInfo.DifficultyPointAt(StartTime);
             }
             else
             {
                 SampleControlPoint ??= SampleControlPoint.DEFAULT;
+                DifficultyControlPoint ??= DifficultyControlPoint.DEFAULT;
             }
 
             nestedHitObjects.Clear();
diff --git a/osu.Game/Rulesets/Objects/Legacy/ConvertSlider.cs b/osu.Game/Rulesets/Objects/Legacy/ConvertSlider.cs
index df569b91c1..7e5914677a 100644
--- a/osu.Game/Rulesets/Objects/Legacy/ConvertSlider.cs
+++ b/osu.Game/Rulesets/Objects/Legacy/ConvertSlider.cs
@@ -43,9 +43,8 @@ namespace osu.Game.Rulesets.Objects.Legacy
             base.ApplyDefaultsToSelf(controlPointInfo, difficulty);
 
             TimingControlPoint timingPoint = controlPointInfo.TimingPointAt(StartTime);
-            DifficultyControlPoint difficultyPoint = controlPointInfo.DifficultyPointAt(StartTime);
 
-            double scoringDistance = base_scoring_distance * difficulty.SliderMultiplier * difficultyPoint.SpeedMultiplier;
+            double scoringDistance = base_scoring_distance * difficulty.SliderMultiplier * DifficultyControlPoint.SpeedMultiplier;
 
             Velocity = scoringDistance / timingPoint.BeatLength;
         }

From db3fc1d4afdf4941fd65a6a8386bfb2567b496d6 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 31 Aug 2021 16:20:16 +0900
Subject: [PATCH 0036/5547] Move `DifficultyControlPoint`s list to
 `LegacyControlPointInfo`

---
 .../ControlPoints/ControlPointInfo.cs         | 29 ----------
 .../Beatmaps/Legacy/LegacyControlPointInfo.cs | 57 ++++++++++++++++---
 2 files changed, 48 insertions(+), 38 deletions(-)

diff --git a/osu.Game/Beatmaps/ControlPoints/ControlPointInfo.cs b/osu.Game/Beatmaps/ControlPoints/ControlPointInfo.cs
index 3ff40fe194..dd88d0b539 100644
--- a/osu.Game/Beatmaps/ControlPoints/ControlPointInfo.cs
+++ b/osu.Game/Beatmaps/ControlPoints/ControlPointInfo.cs
@@ -33,14 +33,6 @@ namespace osu.Game.Beatmaps.ControlPoints
 
         private readonly SortedList<TimingControlPoint> timingPoints = new SortedList<TimingControlPoint>(Comparer<TimingControlPoint>.Default);
 
-        /// <summary>
-        /// All difficulty points.
-        /// </summary>
-        [JsonProperty]
-        public IReadOnlyList<DifficultyControlPoint> DifficultyPoints => difficultyPoints;
-
-        private readonly SortedList<DifficultyControlPoint> difficultyPoints = new SortedList<DifficultyControlPoint>(Comparer<DifficultyControlPoint>.Default);
-
         /// <summary>
         /// All effect points.
         /// </summary>
@@ -55,14 +47,6 @@ namespace osu.Game.Beatmaps.ControlPoints
         [JsonIgnore]
         public IEnumerable<ControlPoint> AllControlPoints => Groups.SelectMany(g => g.ControlPoints).ToArray();
 
-        /// <summary>
-        /// Finds the difficulty control point that is active at <paramref name="time"/>.
-        /// </summary>
-        /// <param name="time">The time to find the difficulty control point at.</param>
-        /// <returns>The difficulty control point.</returns>
-        [NotNull]
-        public DifficultyControlPoint DifficultyPointAt(double time) => BinarySearchWithFallback(DifficultyPoints, time, DifficultyControlPoint.DEFAULT);
-
         /// <summary>
         /// Finds the effect control point that is active at <paramref name="time"/>.
         /// </summary>
@@ -100,7 +84,6 @@ namespace osu.Game.Beatmaps.ControlPoints
         {
             groups.Clear();
             timingPoints.Clear();
-            difficultyPoints.Clear();
             effectPoints.Clear();
         }
 
@@ -277,10 +260,6 @@ namespace osu.Game.Beatmaps.ControlPoints
                 case EffectControlPoint _:
                     existing = EffectPointAt(time);
                     break;
-
-                case DifficultyControlPoint _:
-                    existing = DifficultyPointAt(time);
-                    break;
             }
 
             return newPoint?.IsRedundant(existing) == true;
@@ -297,10 +276,6 @@ namespace osu.Game.Beatmaps.ControlPoints
                 case EffectControlPoint typed:
                     effectPoints.Add(typed);
                     break;
-
-                case DifficultyControlPoint typed:
-                    difficultyPoints.Add(typed);
-                    break;
             }
         }
 
@@ -315,10 +290,6 @@ namespace osu.Game.Beatmaps.ControlPoints
                 case EffectControlPoint typed:
                     effectPoints.Remove(typed);
                     break;
-
-                case DifficultyControlPoint typed:
-                    difficultyPoints.Remove(typed);
-                    break;
             }
         }
 
diff --git a/osu.Game/Beatmaps/Legacy/LegacyControlPointInfo.cs b/osu.Game/Beatmaps/Legacy/LegacyControlPointInfo.cs
index ff0ca5ebe1..d3c0559ec8 100644
--- a/osu.Game/Beatmaps/Legacy/LegacyControlPointInfo.cs
+++ b/osu.Game/Beatmaps/Legacy/LegacyControlPointInfo.cs
@@ -1,9 +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.Collections.Generic;
 using JetBrains.Annotations;
 using Newtonsoft.Json;
 using osu.Framework.Bindables;
+using osu.Framework.Lists;
 using osu.Game.Beatmaps.ControlPoints;
 
 namespace osu.Game.Beatmaps.Legacy
@@ -26,35 +28,72 @@ namespace osu.Game.Beatmaps.Legacy
         [NotNull]
         public SampleControlPoint SamplePointAt(double time) => BinarySearchWithFallback(SamplePoints, time, SamplePoints.Count > 0 ? SamplePoints[0] : SampleControlPoint.DEFAULT);
 
+        /// <summary>
+        /// All difficulty points.
+        /// </summary>
+        [JsonProperty]
+        public IReadOnlyList<DifficultyControlPoint> DifficultyPoints => difficultyPoints;
+
+        private readonly SortedList<DifficultyControlPoint> difficultyPoints = new SortedList<DifficultyControlPoint>(Comparer<DifficultyControlPoint>.Default);
+
+        /// <summary>
+        /// Finds the difficulty control point that is active at <paramref name="time"/>.
+        /// </summary>
+        /// <param name="time">The time to find the difficulty control point at.</param>
+        /// <returns>The difficulty control point.</returns>
+        [NotNull]
+        public DifficultyControlPoint DifficultyPointAt(double time) => BinarySearchWithFallback(DifficultyPoints, time, DifficultyControlPoint.DEFAULT);
+
         public override void Clear()
         {
             base.Clear();
             samplePoints.Clear();
+            difficultyPoints.Clear();
         }
 
         protected override bool CheckAlreadyExisting(double time, ControlPoint newPoint)
         {
-            if (newPoint is SampleControlPoint)
+            switch (newPoint)
             {
-                var existing = BinarySearch(SamplePoints, time);
-                return newPoint.IsRedundant(existing);
-            }
+                case SampleControlPoint _:
+                    return newPoint.IsRedundant(SamplePointAt(time));
 
-            return base.CheckAlreadyExisting(time, newPoint);
+                case DifficultyControlPoint _:
+                    return newPoint.IsRedundant(DifficultyPointAt(time));
+
+                default:
+                    return base.CheckAlreadyExisting(time, newPoint);
+            }
         }
 
         protected override void GroupItemAdded(ControlPoint controlPoint)
         {
-            if (controlPoint is SampleControlPoint typed)
-                samplePoints.Add(typed);
+            switch (controlPoint)
+            {
+                case SampleControlPoint typed:
+                    samplePoints.Add(typed);
+                    break;
+
+                case DifficultyControlPoint typed:
+                    difficultyPoints.Add(typed);
+                    break;
+            }
 
             base.GroupItemAdded(controlPoint);
         }
 
         protected override void GroupItemRemoved(ControlPoint controlPoint)
         {
-            if (controlPoint is SampleControlPoint typed)
-                samplePoints.Remove(typed);
+            switch (controlPoint)
+            {
+                case SampleControlPoint typed:
+                    samplePoints.Remove(typed);
+                    break;
+
+                case DifficultyControlPoint typed:
+                    difficultyPoints.Remove(typed);
+                    break;
+            }
 
             base.GroupItemRemoved(controlPoint);
         }

From 071c56e90bf51fb5bf6eca5614a1077f9fc8397d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 31 Aug 2021 16:31:48 +0900
Subject: [PATCH 0037/5547] Update usages of `DifficultyPointAt`

---
 osu.Game.Rulesets.Catch/Objects/JuiceStream.cs |  3 +--
 .../Legacy/DistanceObjectPatternGenerator.cs   |  2 +-
 .../Beatmaps/OsuBeatmapConverter.cs            |  3 ++-
 osu.Game.Rulesets.Osu/Objects/Slider.cs        |  3 +--
 .../Beatmaps/TaikoBeatmapConverter.cs          |  2 +-
 osu.Game.Rulesets.Taiko/Mods/TaikoModHidden.cs | 18 +++++++++---------
 osu.Game.Rulesets.Taiko/Objects/DrumRoll.cs    |  3 +--
 .../Formats/LegacyBeatmapDecoderTest.cs        |  8 ++++----
 .../NonVisual/ControlPointInfoTest.cs          | 10 +++++-----
 .../Screens/Edit/Timing/DifficultySection.cs   | 10 +---------
 10 files changed, 26 insertions(+), 36 deletions(-)

diff --git a/osu.Game.Rulesets.Catch/Objects/JuiceStream.cs b/osu.Game.Rulesets.Catch/Objects/JuiceStream.cs
index a8ad34fcbe..1aca3def4c 100644
--- a/osu.Game.Rulesets.Catch/Objects/JuiceStream.cs
+++ b/osu.Game.Rulesets.Catch/Objects/JuiceStream.cs
@@ -42,9 +42,8 @@ namespace osu.Game.Rulesets.Catch.Objects
             base.ApplyDefaultsToSelf(controlPointInfo, difficulty);
 
             TimingControlPoint timingPoint = controlPointInfo.TimingPointAt(StartTime);
-            DifficultyControlPoint difficultyPoint = controlPointInfo.DifficultyPointAt(StartTime);
 
-            double scoringDistance = base_scoring_distance * difficulty.SliderMultiplier * difficultyPoint.SpeedMultiplier;
+            double scoringDistance = base_scoring_distance * difficulty.SliderMultiplier * DifficultyControlPoint.SpeedMultiplier;
 
             Velocity = scoringDistance / timingPoint.BeatLength;
             TickDistance = scoringDistance / difficulty.SliderTickRate;
diff --git a/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Legacy/DistanceObjectPatternGenerator.cs b/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Legacy/DistanceObjectPatternGenerator.cs
index 26e5d381e2..411e612909 100644
--- a/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Legacy/DistanceObjectPatternGenerator.cs
+++ b/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Legacy/DistanceObjectPatternGenerator.cs
@@ -47,7 +47,7 @@ namespace osu.Game.Rulesets.Mania.Beatmaps.Patterns.Legacy
             Debug.Assert(distanceData != null);
 
             TimingControlPoint timingPoint = beatmap.ControlPointInfo.TimingPointAt(hitObject.StartTime);
-            DifficultyControlPoint difficultyPoint = beatmap.ControlPointInfo.DifficultyPointAt(hitObject.StartTime);
+            DifficultyControlPoint difficultyPoint = hitObject.DifficultyControlPoint;
 
             double beatLength;
 #pragma warning disable 618
diff --git a/osu.Game.Rulesets.Osu/Beatmaps/OsuBeatmapConverter.cs b/osu.Game.Rulesets.Osu/Beatmaps/OsuBeatmapConverter.cs
index a2fc4848af..151d2d998e 100644
--- a/osu.Game.Rulesets.Osu/Beatmaps/OsuBeatmapConverter.cs
+++ b/osu.Game.Rulesets.Osu/Beatmaps/OsuBeatmapConverter.cs
@@ -11,6 +11,7 @@ using System.Linq;
 using System.Threading;
 using osu.Game.Rulesets.Osu.UI;
 using osu.Framework.Extensions.IEnumerableExtensions;
+using osu.Game.Beatmaps.Legacy;
 
 namespace osu.Game.Rulesets.Osu.Beatmaps
 {
@@ -44,7 +45,7 @@ namespace osu.Game.Rulesets.Osu.Beatmaps
                         LegacyLastTickOffset = (original as IHasLegacyLastTickOffset)?.LegacyLastTickOffset,
                         // prior to v8, speed multipliers don't adjust for how many ticks are generated over the same distance.
                         // this results in more (or less) ticks being generated in <v8 maps for the same time duration.
-                        TickDistanceMultiplier = beatmap.BeatmapInfo.BeatmapVersion < 8 ? 1f / beatmap.ControlPointInfo.DifficultyPointAt(original.StartTime).SpeedMultiplier : 1
+                        TickDistanceMultiplier = beatmap.BeatmapInfo.BeatmapVersion < 8 ? 1f / ((LegacyControlPointInfo)beatmap.ControlPointInfo).DifficultyPointAt(original.StartTime).SpeedMultiplier : 1
                     }.Yield();
 
                 case IHasDuration endTimeData:
diff --git a/osu.Game.Rulesets.Osu/Objects/Slider.cs b/osu.Game.Rulesets.Osu/Objects/Slider.cs
index c4420b1e87..f7132f4f56 100644
--- a/osu.Game.Rulesets.Osu/Objects/Slider.cs
+++ b/osu.Game.Rulesets.Osu/Objects/Slider.cs
@@ -140,9 +140,8 @@ namespace osu.Game.Rulesets.Osu.Objects
             base.ApplyDefaultsToSelf(controlPointInfo, difficulty);
 
             TimingControlPoint timingPoint = controlPointInfo.TimingPointAt(StartTime);
-            DifficultyControlPoint difficultyPoint = controlPointInfo.DifficultyPointAt(StartTime);
 
-            double scoringDistance = BASE_SCORING_DISTANCE * difficulty.SliderMultiplier * difficultyPoint.SpeedMultiplier;
+            double scoringDistance = BASE_SCORING_DISTANCE * difficulty.SliderMultiplier * DifficultyControlPoint.SpeedMultiplier;
 
             Velocity = scoringDistance / timingPoint.BeatLength;
             TickDistance = scoringDistance / difficulty.SliderTickRate * TickDistanceMultiplier;
diff --git a/osu.Game.Rulesets.Taiko/Beatmaps/TaikoBeatmapConverter.cs b/osu.Game.Rulesets.Taiko/Beatmaps/TaikoBeatmapConverter.cs
index 9b73e644c5..0523f9c8ba 100644
--- a/osu.Game.Rulesets.Taiko/Beatmaps/TaikoBeatmapConverter.cs
+++ b/osu.Game.Rulesets.Taiko/Beatmaps/TaikoBeatmapConverter.cs
@@ -154,7 +154,7 @@ namespace osu.Game.Rulesets.Taiko.Beatmaps
             double distance = distanceData.Distance * spans * LegacyBeatmapEncoder.LEGACY_TAIKO_VELOCITY_MULTIPLIER;
 
             TimingControlPoint timingPoint = beatmap.ControlPointInfo.TimingPointAt(obj.StartTime);
-            DifficultyControlPoint difficultyPoint = beatmap.ControlPointInfo.DifficultyPointAt(obj.StartTime);
+            DifficultyControlPoint difficultyPoint = obj.DifficultyControlPoint;
 
             double beatLength;
 #pragma warning disable 618
diff --git a/osu.Game.Rulesets.Taiko/Mods/TaikoModHidden.cs b/osu.Game.Rulesets.Taiko/Mods/TaikoModHidden.cs
index a6b3fe1cd9..e882a197bb 100644
--- a/osu.Game.Rulesets.Taiko/Mods/TaikoModHidden.cs
+++ b/osu.Game.Rulesets.Taiko/Mods/TaikoModHidden.cs
@@ -24,21 +24,13 @@ namespace osu.Game.Rulesets.Taiko.Mods
             ApplyNormalVisibilityState(hitObject, state);
         }
 
-        protected double MultiplierAt(double position)
-        {
-            double beatLength = controlPointInfo.TimingPointAt(position).BeatLength;
-            double speedMultiplier = controlPointInfo.DifficultyPointAt(position).SpeedMultiplier;
-
-            return speedMultiplier * TimingControlPoint.DEFAULT_BEAT_LENGTH / beatLength;
-        }
-
         protected override void ApplyNormalVisibilityState(DrawableHitObject hitObject, ArmedState state)
         {
             switch (hitObject)
             {
                 case DrawableDrumRollTick _:
                 case DrawableHit _:
-                    double preempt = 10000 / MultiplierAt(hitObject.HitObject.StartTime);
+                    double preempt = 10000 / MultiplierAt(hitObject.HitObject);
                     double start = hitObject.HitObject.StartTime - preempt * 0.6;
                     double duration = preempt * 0.3;
 
@@ -57,6 +49,14 @@ namespace osu.Game.Rulesets.Taiko.Mods
             }
         }
 
+        protected double MultiplierAt(HitObject obj)
+        {
+            double beatLength = controlPointInfo.TimingPointAt(obj.StartTime).BeatLength;
+            double speedMultiplier = obj.DifficultyControlPoint.SpeedMultiplier;
+
+            return speedMultiplier * TimingControlPoint.DEFAULT_BEAT_LENGTH / beatLength;
+        }
+
         public override void ApplyToBeatmap(IBeatmap beatmap)
         {
             controlPointInfo = beatmap.ControlPointInfo;
diff --git a/osu.Game.Rulesets.Taiko/Objects/DrumRoll.cs b/osu.Game.Rulesets.Taiko/Objects/DrumRoll.cs
index b0634295d0..b151810487 100644
--- a/osu.Game.Rulesets.Taiko/Objects/DrumRoll.cs
+++ b/osu.Game.Rulesets.Taiko/Objects/DrumRoll.cs
@@ -63,9 +63,8 @@ namespace osu.Game.Rulesets.Taiko.Objects
             base.ApplyDefaultsToSelf(controlPointInfo, difficulty);
 
             TimingControlPoint timingPoint = controlPointInfo.TimingPointAt(StartTime);
-            DifficultyControlPoint difficultyPoint = controlPointInfo.DifficultyPointAt(StartTime);
 
-            double scoringDistance = base_distance * difficulty.SliderMultiplier * difficultyPoint.SpeedMultiplier;
+            double scoringDistance = base_distance * difficulty.SliderMultiplier * DifficultyControlPoint.SpeedMultiplier;
             Velocity = scoringDistance / timingPoint.BeatLength;
 
             tickSpacing = timingPoint.BeatLength / TickRate;
diff --git a/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs b/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs
index 8560a36fb4..22ef2a301b 100644
--- a/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs
+++ b/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs
@@ -278,10 +278,10 @@ namespace osu.Game.Tests.Beatmaps.Formats
             using (var resStream = TestResources.OpenResource("timingpoint-speedmultiplier-reset.osu"))
             using (var stream = new LineBufferedReader(resStream))
             {
-                var controlPoints = decoder.Decode(stream).ControlPointInfo;
+                var controlPoints = (LegacyControlPointInfo)decoder.Decode(stream).ControlPointInfo;
 
-                Assert.That(controlPoints.DifficultyPointAt(0).SpeedMultiplier, Is.EqualTo(0.5).Within(0.1));
-                Assert.That(controlPoints.DifficultyPointAt(2000).SpeedMultiplier, Is.EqualTo(1).Within(0.1));
+                Assert.That(controlPoints?.DifficultyPointAt(0).SpeedMultiplier, Is.EqualTo(0.5).Within(0.1));
+                Assert.That(controlPoints?.DifficultyPointAt(2000).SpeedMultiplier, Is.EqualTo(1).Within(0.1));
             }
         }
 
@@ -393,7 +393,7 @@ namespace osu.Game.Tests.Beatmaps.Formats
             using (var resStream = TestResources.OpenResource("controlpoint-difficulty-multiplier.osu"))
             using (var stream = new LineBufferedReader(resStream))
             {
-                var controlPointInfo = decoder.Decode(stream).ControlPointInfo;
+                var controlPointInfo = (LegacyControlPointInfo)decoder.Decode(stream).ControlPointInfo;
 
                 Assert.That(controlPointInfo.DifficultyPointAt(5).SpeedMultiplier, Is.EqualTo(1));
                 Assert.That(controlPointInfo.DifficultyPointAt(1000).SpeedMultiplier, Is.EqualTo(10));
diff --git a/osu.Game.Tests/NonVisual/ControlPointInfoTest.cs b/osu.Game.Tests/NonVisual/ControlPointInfoTest.cs
index fabb016d5f..0a4350021b 100644
--- a/osu.Game.Tests/NonVisual/ControlPointInfoTest.cs
+++ b/osu.Game.Tests/NonVisual/ControlPointInfoTest.cs
@@ -46,7 +46,7 @@ namespace osu.Game.Tests.NonVisual
         [Test]
         public void TestAddRedundantDifficulty()
         {
-            var cpi = new ControlPointInfo();
+            var cpi = new LegacyControlPointInfo();
 
             cpi.Add(0, new DifficultyControlPoint()); // is redundant
             cpi.Add(1000, new DifficultyControlPoint()); // is redundant
@@ -159,7 +159,7 @@ namespace osu.Game.Tests.NonVisual
         [Test]
         public void TestAddControlPointToGroup()
         {
-            var cpi = new ControlPointInfo();
+            var cpi = new LegacyControlPointInfo();
 
             var group = cpi.GroupAt(1000, true);
             Assert.That(cpi.Groups.Count, Is.EqualTo(1));
@@ -174,7 +174,7 @@ namespace osu.Game.Tests.NonVisual
         [Test]
         public void TestAddDuplicateControlPointToGroup()
         {
-            var cpi = new ControlPointInfo();
+            var cpi = new LegacyControlPointInfo();
 
             var group = cpi.GroupAt(1000, true);
             Assert.That(cpi.Groups.Count, Is.EqualTo(1));
@@ -190,7 +190,7 @@ namespace osu.Game.Tests.NonVisual
         [Test]
         public void TestRemoveControlPointFromGroup()
         {
-            var cpi = new ControlPointInfo();
+            var cpi = new LegacyControlPointInfo();
 
             var group = cpi.GroupAt(1000, true);
             Assert.That(cpi.Groups.Count, Is.EqualTo(1));
@@ -230,7 +230,7 @@ namespace osu.Game.Tests.NonVisual
         [Test]
         public void TestClear()
         {
-            var cpi = new ControlPointInfo();
+            var cpi = new LegacyControlPointInfo();
 
             cpi.Add(0, new TimingControlPoint());
             cpi.Add(1000, new TimingControlPoint { BeatLength = 500 });
diff --git a/osu.Game/Screens/Edit/Timing/DifficultySection.cs b/osu.Game/Screens/Edit/Timing/DifficultySection.cs
index 97d110c502..a0439089b2 100644
--- a/osu.Game/Screens/Edit/Timing/DifficultySection.cs
+++ b/osu.Game/Screens/Edit/Timing/DifficultySection.cs
@@ -42,14 +42,6 @@ namespace osu.Game.Screens.Edit.Timing
             }
         }
 
-        protected override DifficultyControlPoint CreatePoint()
-        {
-            var reference = Beatmap.ControlPointInfo.DifficultyPointAt(SelectedGroup.Value.Time);
-
-            return new DifficultyControlPoint
-            {
-                SpeedMultiplier = reference.SpeedMultiplier,
-            };
-        }
+        protected override DifficultyControlPoint CreatePoint() => new DifficultyControlPoint(); // TODO: remove
     }
 }

From 4eb09ea1a949af14fee1b957fae543ee4898ef84 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 31 Aug 2021 16:34:31 +0900
Subject: [PATCH 0038/5547] Update decoder to also extract
 `DifficultyControlPoint`s from `HitObject`s

---
 osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs b/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs
index 75d9a56f3e..bbc05f7c75 100644
--- a/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs
+++ b/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs
@@ -182,11 +182,19 @@ namespace osu.Game.Beatmaps.Formats
                 beatmap.ControlPointInfo = legacyControlPoints;
 
                 SampleControlPoint lastRelevantSamplePoint = null;
+                DifficultyControlPoint lastRelevantDifficultyPoint = null;
 
                 // iterate over hitobjects and pull out all required sample changes
                 foreach (var h in beatmap.HitObjects)
                 {
                     var hSamplePoint = h.SampleControlPoint;
+                    var hDifficultyPoint = h.DifficultyControlPoint;
+
+                    if (!hDifficultyPoint.IsRedundant(lastRelevantDifficultyPoint))
+                    {
+                        legacyControlPoints.Add(hDifficultyPoint.Time, hDifficultyPoint);
+                        lastRelevantDifficultyPoint = hDifficultyPoint;
+                    }
 
                     if (!hSamplePoint.IsRedundant(lastRelevantSamplePoint))
                     {
@@ -209,7 +217,7 @@ namespace osu.Game.Beatmaps.Formats
                 }
 
                 // Output any remaining effects as secondary non-timing control point.
-                var difficultyPoint = beatmap.ControlPointInfo.DifficultyPointAt(group.Time);
+                var difficultyPoint = ((LegacyControlPointInfo)beatmap.ControlPointInfo).DifficultyPointAt(group.Time);
                 writer.Write(FormattableString.Invariant($"{group.Time},"));
                 writer.Write(FormattableString.Invariant($"{-100 / difficultyPoint.SpeedMultiplier},"));
                 outputControlPointAt(group.Time, false);

From a3d9ab1e2efd96ecbe988c9e24d9ca877fe61e4e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 31 Aug 2021 23:59:36 +0900
Subject: [PATCH 0039/5547] Move approach rate to `EffectControlPoint`

---
 .../Objects/JuiceStream.cs                    |  2 +-
 .../TestSceneHoldNoteInput.cs                 |  2 +-
 .../TestSceneOutOfOrderHits.cs                |  2 +-
 .../Legacy/DistanceObjectPatternGenerator.cs  |  2 +-
 .../TestSceneObjectOrderedHitPolicy.cs        |  2 +-
 .../TestSceneSlider.cs                        |  2 +-
 .../TestSceneSliderInput.cs                   |  2 +-
 .../TestSceneStartTimeOrderedHitPolicy.cs     |  2 +-
 .../Beatmaps/OsuBeatmapConverter.cs           |  2 +-
 osu.Game.Rulesets.Osu/Objects/Slider.cs       |  2 +-
 .../Beatmaps/TaikoBeatmapConverter.cs         |  2 +-
 .../Mods/TaikoModHidden.cs                    |  2 +-
 osu.Game.Rulesets.Taiko/Objects/DrumRoll.cs   |  2 +-
 .../Formats/LegacyBeatmapDecoderTest.cs       | 26 +++++++++---------
 ...tSceneHitObjectComposerDistanceSnapping.cs |  4 +--
 .../NonVisual/ControlPointInfoTest.cs         | 14 +++++-----
 .../Gameplay/TestSceneScrollingHitObjects.cs  |  6 ++---
 .../ControlPoints/DifficultyControlPoint.cs   | 19 +++++++------
 .../ControlPoints/EffectControlPoint.cs       | 27 +++++++++++++++++--
 .../ControlPoints/SampleControlPoint.cs       |  3 +++
 .../Beatmaps/Formats/LegacyBeatmapDecoder.cs  |  2 +-
 .../Beatmaps/Formats/LegacyBeatmapEncoder.cs  |  2 +-
 osu.Game/Beatmaps/Formats/LegacyDecoder.cs    |  2 +-
 osu.Game/Rulesets/Edit/HitObjectComposer.cs   |  2 +-
 .../Rulesets/Objects/Legacy/ConvertSlider.cs  |  2 +-
 .../Rulesets/Timing/MultiplierControlPoint.cs |  2 +-
 .../Timeline/DifficultyPointPiece.cs          |  2 +-
 .../Screens/Edit/Timing/DifficultySection.cs  |  6 ++---
 .../RowAttributes/DifficultyRowAttribute.cs   |  2 +-
 29 files changed, 88 insertions(+), 59 deletions(-)

diff --git a/osu.Game.Rulesets.Catch/Objects/JuiceStream.cs b/osu.Game.Rulesets.Catch/Objects/JuiceStream.cs
index 1aca3def4c..cb8056231c 100644
--- a/osu.Game.Rulesets.Catch/Objects/JuiceStream.cs
+++ b/osu.Game.Rulesets.Catch/Objects/JuiceStream.cs
@@ -43,7 +43,7 @@ namespace osu.Game.Rulesets.Catch.Objects
 
             TimingControlPoint timingPoint = controlPointInfo.TimingPointAt(StartTime);
 
-            double scoringDistance = base_scoring_distance * difficulty.SliderMultiplier * DifficultyControlPoint.SpeedMultiplier;
+            double scoringDistance = base_scoring_distance * difficulty.SliderMultiplier * DifficultyControlPoint.SliderVelocity;
 
             Velocity = scoringDistance / timingPoint.BeatLength;
             TickDistance = scoringDistance / difficulty.SliderTickRate;
diff --git a/osu.Game.Rulesets.Mania.Tests/TestSceneHoldNoteInput.cs b/osu.Game.Rulesets.Mania.Tests/TestSceneHoldNoteInput.cs
index 471dad87d5..3e393d5259 100644
--- a/osu.Game.Rulesets.Mania.Tests/TestSceneHoldNoteInput.cs
+++ b/osu.Game.Rulesets.Mania.Tests/TestSceneHoldNoteInput.cs
@@ -388,7 +388,7 @@ namespace osu.Game.Rulesets.Mania.Tests
                     },
                 };
 
-                beatmap.ControlPointInfo.Add(0, new DifficultyControlPoint { SpeedMultiplier = 0.1f });
+                beatmap.ControlPointInfo.Add(0, new DifficultyControlPoint { SliderVelocity = 0.1f });
             }
 
             AddStep("load player", () =>
diff --git a/osu.Game.Rulesets.Mania.Tests/TestSceneOutOfOrderHits.cs b/osu.Game.Rulesets.Mania.Tests/TestSceneOutOfOrderHits.cs
index 18891f8c58..fe790b49b0 100644
--- a/osu.Game.Rulesets.Mania.Tests/TestSceneOutOfOrderHits.cs
+++ b/osu.Game.Rulesets.Mania.Tests/TestSceneOutOfOrderHits.cs
@@ -148,7 +148,7 @@ namespace osu.Game.Rulesets.Mania.Tests
                     },
                 });
 
-                Beatmap.Value.Beatmap.ControlPointInfo.Add(0, new DifficultyControlPoint { SpeedMultiplier = 0.1f });
+                Beatmap.Value.Beatmap.ControlPointInfo.Add(0, new DifficultyControlPoint { SliderVelocity = 0.1f });
 
                 var p = new ScoreAccessibleReplayPlayer(new Score { Replay = new Replay { Frames = frames } });
 
diff --git a/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Legacy/DistanceObjectPatternGenerator.cs b/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Legacy/DistanceObjectPatternGenerator.cs
index 411e612909..51c8040687 100644
--- a/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Legacy/DistanceObjectPatternGenerator.cs
+++ b/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Legacy/DistanceObjectPatternGenerator.cs
@@ -55,7 +55,7 @@ namespace osu.Game.Rulesets.Mania.Beatmaps.Patterns.Legacy
 #pragma warning restore 618
                 beatLength = timingPoint.BeatLength * legacyDifficultyPoint.BpmMultiplier;
             else
-                beatLength = timingPoint.BeatLength / difficultyPoint.SpeedMultiplier;
+                beatLength = timingPoint.BeatLength / difficultyPoint.SliderVelocity;
 
             SpanCount = repeatsData?.SpanCount() ?? 1;
             StartTime = (int)Math.Round(hitObject.StartTime);
diff --git a/osu.Game.Rulesets.Osu.Tests/TestSceneObjectOrderedHitPolicy.cs b/osu.Game.Rulesets.Osu.Tests/TestSceneObjectOrderedHitPolicy.cs
index 77a68b714b..904aee7b0d 100644
--- a/osu.Game.Rulesets.Osu.Tests/TestSceneObjectOrderedHitPolicy.cs
+++ b/osu.Game.Rulesets.Osu.Tests/TestSceneObjectOrderedHitPolicy.cs
@@ -407,7 +407,7 @@ namespace osu.Game.Rulesets.Osu.Tests
                     },
                 });
 
-                Beatmap.Value.Beatmap.ControlPointInfo.Add(0, new DifficultyControlPoint { SpeedMultiplier = 0.1f });
+                Beatmap.Value.Beatmap.ControlPointInfo.Add(0, new DifficultyControlPoint { SliderVelocity = 0.1f });
 
                 SelectedMods.Value = new[] { new OsuModClassic() };
 
diff --git a/osu.Game.Rulesets.Osu.Tests/TestSceneSlider.cs b/osu.Game.Rulesets.Osu.Tests/TestSceneSlider.cs
index 81902c25af..1b7a859ccb 100644
--- a/osu.Game.Rulesets.Osu.Tests/TestSceneSlider.cs
+++ b/osu.Game.Rulesets.Osu.Tests/TestSceneSlider.cs
@@ -329,7 +329,7 @@ namespace osu.Game.Rulesets.Osu.Tests
         private Drawable createDrawable(Slider slider, float circleSize, double speedMultiplier)
         {
             var cpi = new ControlPointInfo();
-            cpi.Add(0, new DifficultyControlPoint { SpeedMultiplier = speedMultiplier });
+            cpi.Add(0, new DifficultyControlPoint { SliderVelocity = speedMultiplier });
 
             slider.ApplyDefaults(cpi, new BeatmapDifficulty { CircleSize = circleSize, SliderTickRate = 3 });
 
diff --git a/osu.Game.Rulesets.Osu.Tests/TestSceneSliderInput.cs b/osu.Game.Rulesets.Osu.Tests/TestSceneSliderInput.cs
index 590d159300..c4f8a14aef 100644
--- a/osu.Game.Rulesets.Osu.Tests/TestSceneSliderInput.cs
+++ b/osu.Game.Rulesets.Osu.Tests/TestSceneSliderInput.cs
@@ -362,7 +362,7 @@ namespace osu.Game.Rulesets.Osu.Tests
                     },
                 });
 
-                Beatmap.Value.Beatmap.ControlPointInfo.Add(0, new DifficultyControlPoint { SpeedMultiplier = 0.1f });
+                Beatmap.Value.Beatmap.ControlPointInfo.Add(0, new DifficultyControlPoint { SliderVelocity = 0.1f });
 
                 var p = new ScoreAccessibleReplayPlayer(new Score { Replay = new Replay { Frames = frames } });
 
diff --git a/osu.Game.Rulesets.Osu.Tests/TestSceneStartTimeOrderedHitPolicy.cs b/osu.Game.Rulesets.Osu.Tests/TestSceneStartTimeOrderedHitPolicy.cs
index 177a4f50a1..2b90fd7f38 100644
--- a/osu.Game.Rulesets.Osu.Tests/TestSceneStartTimeOrderedHitPolicy.cs
+++ b/osu.Game.Rulesets.Osu.Tests/TestSceneStartTimeOrderedHitPolicy.cs
@@ -369,7 +369,7 @@ namespace osu.Game.Rulesets.Osu.Tests
                     },
                 });
 
-                Beatmap.Value.Beatmap.ControlPointInfo.Add(0, new DifficultyControlPoint { SpeedMultiplier = 0.1f });
+                Beatmap.Value.Beatmap.ControlPointInfo.Add(0, new DifficultyControlPoint { SliderVelocity = 0.1f });
 
                 var p = new ScoreAccessibleReplayPlayer(new Score { Replay = new Replay { Frames = frames } });
 
diff --git a/osu.Game.Rulesets.Osu/Beatmaps/OsuBeatmapConverter.cs b/osu.Game.Rulesets.Osu/Beatmaps/OsuBeatmapConverter.cs
index 151d2d998e..d82186fb52 100644
--- a/osu.Game.Rulesets.Osu/Beatmaps/OsuBeatmapConverter.cs
+++ b/osu.Game.Rulesets.Osu/Beatmaps/OsuBeatmapConverter.cs
@@ -45,7 +45,7 @@ namespace osu.Game.Rulesets.Osu.Beatmaps
                         LegacyLastTickOffset = (original as IHasLegacyLastTickOffset)?.LegacyLastTickOffset,
                         // prior to v8, speed multipliers don't adjust for how many ticks are generated over the same distance.
                         // this results in more (or less) ticks being generated in <v8 maps for the same time duration.
-                        TickDistanceMultiplier = beatmap.BeatmapInfo.BeatmapVersion < 8 ? 1f / ((LegacyControlPointInfo)beatmap.ControlPointInfo).DifficultyPointAt(original.StartTime).SpeedMultiplier : 1
+                        TickDistanceMultiplier = beatmap.BeatmapInfo.BeatmapVersion < 8 ? 1f / ((LegacyControlPointInfo)beatmap.ControlPointInfo).DifficultyPointAt(original.StartTime).SliderVelocity : 1
                     }.Yield();
 
                 case IHasDuration endTimeData:
diff --git a/osu.Game.Rulesets.Osu/Objects/Slider.cs b/osu.Game.Rulesets.Osu/Objects/Slider.cs
index f7132f4f56..53ecb59c85 100644
--- a/osu.Game.Rulesets.Osu/Objects/Slider.cs
+++ b/osu.Game.Rulesets.Osu/Objects/Slider.cs
@@ -141,7 +141,7 @@ namespace osu.Game.Rulesets.Osu.Objects
 
             TimingControlPoint timingPoint = controlPointInfo.TimingPointAt(StartTime);
 
-            double scoringDistance = BASE_SCORING_DISTANCE * difficulty.SliderMultiplier * DifficultyControlPoint.SpeedMultiplier;
+            double scoringDistance = BASE_SCORING_DISTANCE * difficulty.SliderMultiplier * DifficultyControlPoint.SliderVelocity;
 
             Velocity = scoringDistance / timingPoint.BeatLength;
             TickDistance = scoringDistance / difficulty.SliderTickRate * TickDistanceMultiplier;
diff --git a/osu.Game.Rulesets.Taiko/Beatmaps/TaikoBeatmapConverter.cs b/osu.Game.Rulesets.Taiko/Beatmaps/TaikoBeatmapConverter.cs
index 0523f9c8ba..d444c23450 100644
--- a/osu.Game.Rulesets.Taiko/Beatmaps/TaikoBeatmapConverter.cs
+++ b/osu.Game.Rulesets.Taiko/Beatmaps/TaikoBeatmapConverter.cs
@@ -162,7 +162,7 @@ namespace osu.Game.Rulesets.Taiko.Beatmaps
 #pragma warning restore 618
                 beatLength = timingPoint.BeatLength * legacyDifficultyPoint.BpmMultiplier;
             else
-                beatLength = timingPoint.BeatLength / difficultyPoint.SpeedMultiplier;
+                beatLength = timingPoint.BeatLength / difficultyPoint.SliderVelocity;
 
             double sliderScoringPointDistance = osu_base_scoring_distance * beatmap.BeatmapInfo.BaseDifficulty.SliderMultiplier / beatmap.BeatmapInfo.BaseDifficulty.SliderTickRate;
 
diff --git a/osu.Game.Rulesets.Taiko/Mods/TaikoModHidden.cs b/osu.Game.Rulesets.Taiko/Mods/TaikoModHidden.cs
index e882a197bb..5866538bf7 100644
--- a/osu.Game.Rulesets.Taiko/Mods/TaikoModHidden.cs
+++ b/osu.Game.Rulesets.Taiko/Mods/TaikoModHidden.cs
@@ -52,7 +52,7 @@ namespace osu.Game.Rulesets.Taiko.Mods
         protected double MultiplierAt(HitObject obj)
         {
             double beatLength = controlPointInfo.TimingPointAt(obj.StartTime).BeatLength;
-            double speedMultiplier = obj.DifficultyControlPoint.SpeedMultiplier;
+            double speedMultiplier = obj.DifficultyControlPoint.SliderVelocity;
 
             return speedMultiplier * TimingControlPoint.DEFAULT_BEAT_LENGTH / beatLength;
         }
diff --git a/osu.Game.Rulesets.Taiko/Objects/DrumRoll.cs b/osu.Game.Rulesets.Taiko/Objects/DrumRoll.cs
index b151810487..a35a1631f1 100644
--- a/osu.Game.Rulesets.Taiko/Objects/DrumRoll.cs
+++ b/osu.Game.Rulesets.Taiko/Objects/DrumRoll.cs
@@ -64,7 +64,7 @@ namespace osu.Game.Rulesets.Taiko.Objects
 
             TimingControlPoint timingPoint = controlPointInfo.TimingPointAt(StartTime);
 
-            double scoringDistance = base_distance * difficulty.SliderMultiplier * DifficultyControlPoint.SpeedMultiplier;
+            double scoringDistance = base_distance * difficulty.SliderMultiplier * DifficultyControlPoint.SliderVelocity;
             Velocity = scoringDistance / timingPoint.BeatLength;
 
             tickSpacing = timingPoint.BeatLength / TickRate;
diff --git a/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs b/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs
index 22ef2a301b..e8590d0f82 100644
--- a/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs
+++ b/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs
@@ -191,15 +191,15 @@ namespace osu.Game.Tests.Beatmaps.Formats
 
                 var difficultyPoint = controlPoints.DifficultyPointAt(0);
                 Assert.AreEqual(0, difficultyPoint.Time);
-                Assert.AreEqual(1.0, difficultyPoint.SpeedMultiplier);
+                Assert.AreEqual(1.0, difficultyPoint.SliderVelocity);
 
                 difficultyPoint = controlPoints.DifficultyPointAt(48428);
                 Assert.AreEqual(0, difficultyPoint.Time);
-                Assert.AreEqual(1.0, difficultyPoint.SpeedMultiplier);
+                Assert.AreEqual(1.0, difficultyPoint.SliderVelocity);
 
                 difficultyPoint = controlPoints.DifficultyPointAt(116999);
                 Assert.AreEqual(116999, difficultyPoint.Time);
-                Assert.AreEqual(0.75, difficultyPoint.SpeedMultiplier, 0.1);
+                Assert.AreEqual(0.75, difficultyPoint.SliderVelocity, 0.1);
 
                 var soundPoint = controlPoints.SamplePointAt(0);
                 Assert.AreEqual(956, soundPoint.Time);
@@ -248,10 +248,10 @@ namespace osu.Game.Tests.Beatmaps.Formats
                 Assert.That(controlPoints.EffectPoints.Count, Is.EqualTo(3));
                 Assert.That(controlPoints.SamplePoints.Count, Is.EqualTo(3));
 
-                Assert.That(controlPoints.DifficultyPointAt(500).SpeedMultiplier, Is.EqualTo(1.5).Within(0.1));
-                Assert.That(controlPoints.DifficultyPointAt(1500).SpeedMultiplier, Is.EqualTo(1.5).Within(0.1));
-                Assert.That(controlPoints.DifficultyPointAt(2500).SpeedMultiplier, Is.EqualTo(0.75).Within(0.1));
-                Assert.That(controlPoints.DifficultyPointAt(3500).SpeedMultiplier, Is.EqualTo(1.5).Within(0.1));
+                Assert.That(controlPoints.DifficultyPointAt(500).SliderVelocity, Is.EqualTo(1.5).Within(0.1));
+                Assert.That(controlPoints.DifficultyPointAt(1500).SliderVelocity, Is.EqualTo(1.5).Within(0.1));
+                Assert.That(controlPoints.DifficultyPointAt(2500).SliderVelocity, Is.EqualTo(0.75).Within(0.1));
+                Assert.That(controlPoints.DifficultyPointAt(3500).SliderVelocity, Is.EqualTo(1.5).Within(0.1));
 
                 Assert.That(controlPoints.EffectPointAt(500).KiaiMode, Is.True);
                 Assert.That(controlPoints.EffectPointAt(1500).KiaiMode, Is.True);
@@ -280,8 +280,8 @@ namespace osu.Game.Tests.Beatmaps.Formats
             {
                 var controlPoints = (LegacyControlPointInfo)decoder.Decode(stream).ControlPointInfo;
 
-                Assert.That(controlPoints?.DifficultyPointAt(0).SpeedMultiplier, Is.EqualTo(0.5).Within(0.1));
-                Assert.That(controlPoints?.DifficultyPointAt(2000).SpeedMultiplier, Is.EqualTo(1).Within(0.1));
+                Assert.That(controlPoints?.DifficultyPointAt(0).SliderVelocity, Is.EqualTo(0.5).Within(0.1));
+                Assert.That(controlPoints?.DifficultyPointAt(2000).SliderVelocity, Is.EqualTo(1).Within(0.1));
             }
         }
 
@@ -395,10 +395,10 @@ namespace osu.Game.Tests.Beatmaps.Formats
             {
                 var controlPointInfo = (LegacyControlPointInfo)decoder.Decode(stream).ControlPointInfo;
 
-                Assert.That(controlPointInfo.DifficultyPointAt(5).SpeedMultiplier, Is.EqualTo(1));
-                Assert.That(controlPointInfo.DifficultyPointAt(1000).SpeedMultiplier, Is.EqualTo(10));
-                Assert.That(controlPointInfo.DifficultyPointAt(2000).SpeedMultiplier, Is.EqualTo(1.8518518518518519d));
-                Assert.That(controlPointInfo.DifficultyPointAt(3000).SpeedMultiplier, Is.EqualTo(0.5));
+                Assert.That(controlPointInfo.DifficultyPointAt(5).SliderVelocity, Is.EqualTo(1));
+                Assert.That(controlPointInfo.DifficultyPointAt(1000).SliderVelocity, Is.EqualTo(10));
+                Assert.That(controlPointInfo.DifficultyPointAt(2000).SliderVelocity, Is.EqualTo(1.8518518518518519d));
+                Assert.That(controlPointInfo.DifficultyPointAt(3000).SliderVelocity, Is.EqualTo(0.5));
             }
         }
 
diff --git a/osu.Game.Tests/Editing/TestSceneHitObjectComposerDistanceSnapping.cs b/osu.Game.Tests/Editing/TestSceneHitObjectComposerDistanceSnapping.cs
index bd34eaff63..7b0f13e9e0 100644
--- a/osu.Game.Tests/Editing/TestSceneHitObjectComposerDistanceSnapping.cs
+++ b/osu.Game.Tests/Editing/TestSceneHitObjectComposerDistanceSnapping.cs
@@ -56,7 +56,7 @@ namespace osu.Game.Tests.Editing
             composer.EditorBeatmap.BeatmapInfo.BaseDifficulty.SliderMultiplier = 1;
             composer.EditorBeatmap.ControlPointInfo.Clear();
 
-            composer.EditorBeatmap.ControlPointInfo.Add(0, new DifficultyControlPoint { SpeedMultiplier = 1 });
+            composer.EditorBeatmap.ControlPointInfo.Add(0, new DifficultyControlPoint { SliderVelocity = 1 });
             composer.EditorBeatmap.ControlPointInfo.Add(0, new TimingControlPoint { BeatLength = 1000 });
         });
 
@@ -76,7 +76,7 @@ namespace osu.Game.Tests.Editing
             AddStep($"set multiplier = {multiplier}", () =>
             {
                 composer.EditorBeatmap.ControlPointInfo.Clear();
-                composer.EditorBeatmap.ControlPointInfo.Add(0, new DifficultyControlPoint { SpeedMultiplier = multiplier });
+                composer.EditorBeatmap.ControlPointInfo.Add(0, new DifficultyControlPoint { SliderVelocity = multiplier });
             });
 
             assertSnapDistance(100 * multiplier);
diff --git a/osu.Game.Tests/NonVisual/ControlPointInfoTest.cs b/osu.Game.Tests/NonVisual/ControlPointInfoTest.cs
index 0a4350021b..71f3b2b105 100644
--- a/osu.Game.Tests/NonVisual/ControlPointInfoTest.cs
+++ b/osu.Game.Tests/NonVisual/ControlPointInfoTest.cs
@@ -55,7 +55,7 @@ namespace osu.Game.Tests.NonVisual
             Assert.That(cpi.DifficultyPoints.Count, Is.EqualTo(0));
             Assert.That(cpi.AllControlPoints.Count(), Is.EqualTo(0));
 
-            cpi.Add(1000, new DifficultyControlPoint { SpeedMultiplier = 2 }); // is not redundant
+            cpi.Add(1000, new DifficultyControlPoint { SliderVelocity = 2 }); // is not redundant
 
             Assert.That(cpi.Groups.Count, Is.EqualTo(1));
             Assert.That(cpi.DifficultyPoints.Count, Is.EqualTo(1));
@@ -180,11 +180,11 @@ namespace osu.Game.Tests.NonVisual
             Assert.That(cpi.Groups.Count, Is.EqualTo(1));
 
             group.Add(new DifficultyControlPoint());
-            group.Add(new DifficultyControlPoint { SpeedMultiplier = 2 });
+            group.Add(new DifficultyControlPoint { SliderVelocity = 2 });
 
             Assert.That(group.ControlPoints.Count, Is.EqualTo(1));
             Assert.That(cpi.DifficultyPoints.Count, Is.EqualTo(1));
-            Assert.That(cpi.DifficultyPoints.First().SpeedMultiplier, Is.EqualTo(2));
+            Assert.That(cpi.DifficultyPoints.First().SliderVelocity, Is.EqualTo(2));
         }
 
         [Test]
@@ -214,8 +214,8 @@ namespace osu.Game.Tests.NonVisual
             cpi.Add(1000, new TimingControlPoint { BeatLength = 500 });
             cpi.Add(10000, new TimingControlPoint { BeatLength = 200 });
             cpi.Add(5000, new TimingControlPoint { BeatLength = 100 });
-            cpi.Add(3000, new DifficultyControlPoint { SpeedMultiplier = 2 });
-            cpi.GroupAt(7000, true).Add(new DifficultyControlPoint { SpeedMultiplier = 4 });
+            cpi.Add(3000, new DifficultyControlPoint { SliderVelocity = 2 });
+            cpi.GroupAt(7000, true).Add(new DifficultyControlPoint { SliderVelocity = 4 });
             cpi.GroupAt(1000).Add(new SampleControlPoint { SampleVolume = 0 });
             cpi.GroupAt(8000, true).Add(new EffectControlPoint { KiaiMode = true });
 
@@ -236,8 +236,8 @@ namespace osu.Game.Tests.NonVisual
             cpi.Add(1000, new TimingControlPoint { BeatLength = 500 });
             cpi.Add(10000, new TimingControlPoint { BeatLength = 200 });
             cpi.Add(5000, new TimingControlPoint { BeatLength = 100 });
-            cpi.Add(3000, new DifficultyControlPoint { SpeedMultiplier = 2 });
-            cpi.GroupAt(7000, true).Add(new DifficultyControlPoint { SpeedMultiplier = 4 });
+            cpi.Add(3000, new DifficultyControlPoint { SliderVelocity = 2 });
+            cpi.GroupAt(7000, true).Add(new DifficultyControlPoint { SliderVelocity = 4 });
             cpi.GroupAt(1000).Add(new SampleControlPoint { SampleVolume = 0 });
             cpi.GroupAt(8000, true).Add(new EffectControlPoint { KiaiMode = true });
 
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneScrollingHitObjects.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneScrollingHitObjects.cs
index 2f15e549f7..9b444c1f44 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneScrollingHitObjects.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneScrollingHitObjects.cs
@@ -93,9 +93,9 @@ namespace osu.Game.Tests.Visual.Gameplay
 
         private IList<MultiplierControlPoint> testControlPoints => new List<MultiplierControlPoint>
         {
-            new MultiplierControlPoint(time_range) { DifficultyPoint = { SpeedMultiplier = 1.25 } },
-            new MultiplierControlPoint(1.5 * time_range) { DifficultyPoint = { SpeedMultiplier = 1 } },
-            new MultiplierControlPoint(2 * time_range) { DifficultyPoint = { SpeedMultiplier = 1.5 } }
+            new MultiplierControlPoint(time_range) { DifficultyPoint = { SliderVelocity = 1.25 } },
+            new MultiplierControlPoint(1.5 * time_range) { DifficultyPoint = { SliderVelocity = 1 } },
+            new MultiplierControlPoint(2 * time_range) { DifficultyPoint = { SliderVelocity = 1.5 } }
         };
 
         [Test]
diff --git a/osu.Game/Beatmaps/ControlPoints/DifficultyControlPoint.cs b/osu.Game/Beatmaps/ControlPoints/DifficultyControlPoint.cs
index 8a6cfaf688..92a1cc5e90 100644
--- a/osu.Game/Beatmaps/ControlPoints/DifficultyControlPoint.cs
+++ b/osu.Game/Beatmaps/ControlPoints/DifficultyControlPoint.cs
@@ -7,17 +7,20 @@ using osuTK.Graphics;
 
 namespace osu.Game.Beatmaps.ControlPoints
 {
+    /// <remarks>
+    /// Note that going forward, this control point type should always be assigned directly to HitObjects.
+    /// </remarks>
     public class DifficultyControlPoint : ControlPoint
     {
         public static readonly DifficultyControlPoint DEFAULT = new DifficultyControlPoint
         {
-            SpeedMultiplierBindable = { Disabled = true },
+            SliderVelocityBindable = { Disabled = true },
         };
 
         /// <summary>
-        /// The speed multiplier at this control point.
+        /// The slider velocity at this control point.
         /// </summary>
-        public readonly BindableDouble SpeedMultiplierBindable = new BindableDouble(1)
+        public readonly BindableDouble SliderVelocityBindable = new BindableDouble(1)
         {
             Precision = 0.01,
             Default = 1,
@@ -30,19 +33,19 @@ namespace osu.Game.Beatmaps.ControlPoints
         /// <summary>
         /// The speed multiplier at this control point.
         /// </summary>
-        public double SpeedMultiplier
+        public double SliderVelocity
         {
-            get => SpeedMultiplierBindable.Value;
-            set => SpeedMultiplierBindable.Value = value;
+            get => SliderVelocityBindable.Value;
+            set => SliderVelocityBindable.Value = value;
         }
 
         public override bool IsRedundant(ControlPoint existing)
             => existing is DifficultyControlPoint existingDifficulty
-               && SpeedMultiplier == existingDifficulty.SpeedMultiplier;
+               && SliderVelocity == existingDifficulty.SliderVelocity;
 
         public override void CopyFrom(ControlPoint other)
         {
-            SpeedMultiplier = ((DifficultyControlPoint)other).SpeedMultiplier;
+            SliderVelocity = ((DifficultyControlPoint)other).SliderVelocity;
 
             base.CopyFrom(other);
         }
diff --git a/osu.Game/Beatmaps/ControlPoints/EffectControlPoint.cs b/osu.Game/Beatmaps/ControlPoints/EffectControlPoint.cs
index 79bc88e773..a7423e4710 100644
--- a/osu.Game/Beatmaps/ControlPoints/EffectControlPoint.cs
+++ b/osu.Game/Beatmaps/ControlPoints/EffectControlPoint.cs
@@ -12,7 +12,8 @@ namespace osu.Game.Beatmaps.ControlPoints
         public static readonly EffectControlPoint DEFAULT = new EffectControlPoint
         {
             KiaiModeBindable = { Disabled = true },
-            OmitFirstBarLineBindable = { Disabled = true }
+            OmitFirstBarLineBindable = { Disabled = true },
+            ApproachRateBindable = { Disabled = true }
         };
 
         /// <summary>
@@ -20,6 +21,26 @@ namespace osu.Game.Beatmaps.ControlPoints
         /// </summary>
         public readonly BindableBool OmitFirstBarLineBindable = new BindableBool();
 
+        /// <summary>
+        /// The relative approach rate at this control point.
+        /// </summary>
+        public readonly BindableDouble ApproachRateBindable = new BindableDouble(1)
+        {
+            Precision = 0.01,
+            Default = 1,
+            MinValue = 0.01,
+            MaxValue = 10
+        };
+
+        /// <summary>
+        /// The relative approach rate.
+        /// </summary>
+        public double ApproachRate
+        {
+            get => ApproachRateBindable.Value;
+            set => ApproachRateBindable.Value = value;
+        }
+
         public override Color4 GetRepresentingColour(OsuColour colours) => colours.Purple;
 
         /// <summary>
@@ -49,12 +70,14 @@ namespace osu.Game.Beatmaps.ControlPoints
             => !OmitFirstBarLine
                && existing is EffectControlPoint existingEffect
                && KiaiMode == existingEffect.KiaiMode
-               && OmitFirstBarLine == existingEffect.OmitFirstBarLine;
+               && OmitFirstBarLine == existingEffect.OmitFirstBarLine
+               && ApproachRate == existingEffect.ApproachRate;
 
         public override void CopyFrom(ControlPoint other)
         {
             KiaiMode = ((EffectControlPoint)other).KiaiMode;
             OmitFirstBarLine = ((EffectControlPoint)other).OmitFirstBarLine;
+            ApproachRate = ((EffectControlPoint)other).ApproachRate;
 
             base.CopyFrom(other);
         }
diff --git a/osu.Game/Beatmaps/ControlPoints/SampleControlPoint.cs b/osu.Game/Beatmaps/ControlPoints/SampleControlPoint.cs
index 4aa6a3d6e9..fb489f73b1 100644
--- a/osu.Game/Beatmaps/ControlPoints/SampleControlPoint.cs
+++ b/osu.Game/Beatmaps/ControlPoints/SampleControlPoint.cs
@@ -8,6 +8,9 @@ using osuTK.Graphics;
 
 namespace osu.Game.Beatmaps.ControlPoints
 {
+    /// <remarks>
+    /// Note that going forward, this control point type should always be assigned directly to HitObjects.
+    /// </remarks>
     public class SampleControlPoint : ControlPoint
     {
         public const string DEFAULT_BANK = "normal";
diff --git a/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs b/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
index accefb2583..a9b5793565 100644
--- a/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
+++ b/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
@@ -380,7 +380,7 @@ namespace osu.Game.Beatmaps.Formats
             addControlPoint(time, new LegacyDifficultyControlPoint(beatLength)
 #pragma warning restore 618
             {
-                SpeedMultiplier = speedMultiplier,
+                SliderVelocity = speedMultiplier,
             }, timingChange);
 
             addControlPoint(time, new EffectControlPoint
diff --git a/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs b/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs
index bbc05f7c75..a317e6e129 100644
--- a/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs
+++ b/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs
@@ -219,7 +219,7 @@ namespace osu.Game.Beatmaps.Formats
                 // Output any remaining effects as secondary non-timing control point.
                 var difficultyPoint = ((LegacyControlPointInfo)beatmap.ControlPointInfo).DifficultyPointAt(group.Time);
                 writer.Write(FormattableString.Invariant($"{group.Time},"));
-                writer.Write(FormattableString.Invariant($"{-100 / difficultyPoint.SpeedMultiplier},"));
+                writer.Write(FormattableString.Invariant($"{-100 / difficultyPoint.SliderVelocity},"));
                 outputControlPointAt(group.Time, false);
             }
 
diff --git a/osu.Game/Beatmaps/Formats/LegacyDecoder.cs b/osu.Game/Beatmaps/Formats/LegacyDecoder.cs
index 20080308f9..cf6c827af5 100644
--- a/osu.Game/Beatmaps/Formats/LegacyDecoder.cs
+++ b/osu.Game/Beatmaps/Formats/LegacyDecoder.cs
@@ -181,7 +181,7 @@ namespace osu.Game.Beatmaps.Formats
 
             public LegacyDifficultyControlPoint()
             {
-                SpeedMultiplierBindable.Precision = double.Epsilon;
+                SliderVelocityBindable.Precision = double.Epsilon;
             }
 
             public override void CopyFrom(ControlPoint other)
diff --git a/osu.Game/Rulesets/Edit/HitObjectComposer.cs b/osu.Game/Rulesets/Edit/HitObjectComposer.cs
index 8090fcbd32..fe41157046 100644
--- a/osu.Game/Rulesets/Edit/HitObjectComposer.cs
+++ b/osu.Game/Rulesets/Edit/HitObjectComposer.cs
@@ -392,7 +392,7 @@ namespace osu.Game.Rulesets.Edit
         public override float GetBeatSnapDistanceAt(double referenceTime)
         {
             DifficultyControlPoint difficultyPoint = EditorBeatmap.ControlPointInfo.DifficultyPointAt(referenceTime);
-            return (float)(100 * EditorBeatmap.BeatmapInfo.BaseDifficulty.SliderMultiplier * difficultyPoint.SpeedMultiplier / BeatSnapProvider.BeatDivisor);
+            return (float)(100 * EditorBeatmap.BeatmapInfo.BaseDifficulty.SliderMultiplier * difficultyPoint.SliderVelocity / BeatSnapProvider.BeatDivisor);
         }
 
         public override float DurationToDistance(double referenceTime, double duration)
diff --git a/osu.Game/Rulesets/Objects/Legacy/ConvertSlider.cs b/osu.Game/Rulesets/Objects/Legacy/ConvertSlider.cs
index 7e5914677a..872bd86fb1 100644
--- a/osu.Game/Rulesets/Objects/Legacy/ConvertSlider.cs
+++ b/osu.Game/Rulesets/Objects/Legacy/ConvertSlider.cs
@@ -44,7 +44,7 @@ namespace osu.Game.Rulesets.Objects.Legacy
 
             TimingControlPoint timingPoint = controlPointInfo.TimingPointAt(StartTime);
 
-            double scoringDistance = base_scoring_distance * difficulty.SliderMultiplier * DifficultyControlPoint.SpeedMultiplier;
+            double scoringDistance = base_scoring_distance * difficulty.SliderMultiplier * DifficultyControlPoint.SliderVelocity;
 
             Velocity = scoringDistance / timingPoint.BeatLength;
         }
diff --git a/osu.Game/Rulesets/Timing/MultiplierControlPoint.cs b/osu.Game/Rulesets/Timing/MultiplierControlPoint.cs
index dcd2cc8b55..61308505cd 100644
--- a/osu.Game/Rulesets/Timing/MultiplierControlPoint.cs
+++ b/osu.Game/Rulesets/Timing/MultiplierControlPoint.cs
@@ -19,7 +19,7 @@ namespace osu.Game.Rulesets.Timing
         /// <summary>
         /// The aggregate multiplier which this <see cref="MultiplierControlPoint"/> provides.
         /// </summary>
-        public double Multiplier => Velocity * DifficultyPoint.SpeedMultiplier * BaseBeatLength / TimingPoint.BeatLength;
+        public double Multiplier => Velocity * DifficultyPoint.SliderVelocity * BaseBeatLength / TimingPoint.BeatLength;
 
         /// <summary>
         /// The base beat length to scale the <see cref="TimingPoint"/> provided multiplier relative to.
diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/DifficultyPointPiece.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/DifficultyPointPiece.cs
index 3248936765..cd1ef9127e 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/DifficultyPointPiece.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/DifficultyPointPiece.cs
@@ -13,7 +13,7 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
         public DifficultyPointPiece(DifficultyControlPoint point)
             : base(point)
         {
-            speedMultiplier = point.SpeedMultiplierBindable.GetBoundCopy();
+            speedMultiplier = point.SliderVelocityBindable.GetBoundCopy();
 
             Y = Height;
         }
diff --git a/osu.Game/Screens/Edit/Timing/DifficultySection.cs b/osu.Game/Screens/Edit/Timing/DifficultySection.cs
index a0439089b2..1332cca0e3 100644
--- a/osu.Game/Screens/Edit/Timing/DifficultySection.cs
+++ b/osu.Game/Screens/Edit/Timing/DifficultySection.cs
@@ -18,7 +18,7 @@ namespace osu.Game.Screens.Edit.Timing
             {
                 multiplierSlider = new SliderWithTextBoxInput<double>("Speed Multiplier")
                 {
-                    Current = new DifficultyControlPoint().SpeedMultiplierBindable,
+                    Current = new DifficultyControlPoint().SliderVelocityBindable,
                     KeyboardStep = 0.1f
                 }
             });
@@ -28,12 +28,12 @@ namespace osu.Game.Screens.Edit.Timing
         {
             if (point.NewValue != null)
             {
-                var selectedPointBindable = point.NewValue.SpeedMultiplierBindable;
+                var selectedPointBindable = point.NewValue.SliderVelocityBindable;
 
                 // there may be legacy control points, which contain infinite precision for compatibility reasons (see LegacyDifficultyControlPoint).
                 // generally that level of precision could only be set by externally editing the .osu file, so at the point
                 // a user is looking to update this within the editor it should be safe to obliterate this additional precision.
-                double expectedPrecision = new DifficultyControlPoint().SpeedMultiplierBindable.Precision;
+                double expectedPrecision = new DifficultyControlPoint().SliderVelocityBindable.Precision;
                 if (selectedPointBindable.Precision < expectedPrecision)
                     selectedPointBindable.Precision = expectedPrecision;
 
diff --git a/osu.Game/Screens/Edit/Timing/RowAttributes/DifficultyRowAttribute.cs b/osu.Game/Screens/Edit/Timing/RowAttributes/DifficultyRowAttribute.cs
index 7b553ac7ad..d9e6898379 100644
--- a/osu.Game/Screens/Edit/Timing/RowAttributes/DifficultyRowAttribute.cs
+++ b/osu.Game/Screens/Edit/Timing/RowAttributes/DifficultyRowAttribute.cs
@@ -18,7 +18,7 @@ namespace osu.Game.Screens.Edit.Timing.RowAttributes
         public DifficultyRowAttribute(DifficultyControlPoint difficulty)
             : base(difficulty, "difficulty")
         {
-            speedMultiplier = difficulty.SpeedMultiplierBindable.GetBoundCopy();
+            speedMultiplier = difficulty.SliderVelocityBindable.GetBoundCopy();
         }
 
         [BackgroundDependencyLoader]

From d4e5a612ea03338a9e0dc1ae4daff921f1fc1ccd Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 1 Sep 2021 18:05:10 +0900
Subject: [PATCH 0040/5547] Update `IPositionalSnapProvider` to take a
 `HitObject` as reference, rather than raw time

This allows fetching the correct `DifficultyControlPoint` from the
hitobject. Nothing more.
---
 .../Editor/TestSceneManiaBeatSnapGrid.cs      | 11 ++---
 .../Editor/TestSceneOsuDistanceSnapGrid.cs    | 11 ++---
 .../Sliders/SliderPlacementBlueprint.cs       |  2 +-
 .../Sliders/SliderSelectionBlueprint.cs       |  2 +-
 .../Edit/OsuDistanceSnapGrid.cs               |  2 +-
 ...tSceneHitObjectComposerDistanceSnapping.cs | 11 ++---
 .../Editing/TestSceneDistanceSnapGrid.cs      | 13 +++---
 osu.Game/Rulesets/Edit/HitObjectComposer.cs   | 44 +++++++++----------
 .../Rulesets/Edit/IPositionSnapProvider.cs    | 21 ++++-----
 .../UI/Scrolling/DrawableScrollingRuleset.cs  |  4 +-
 .../Components/CircularDistanceSnapGrid.cs    |  7 +--
 .../Compose/Components/DistanceSnapGrid.cs    | 12 +++--
 .../Compose/Components/Timeline/Timeline.cs   | 11 ++---
 13 files changed, 83 insertions(+), 68 deletions(-)

diff --git a/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneManiaBeatSnapGrid.cs b/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneManiaBeatSnapGrid.cs
index 538a51db5f..5ccb191a9b 100644
--- a/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneManiaBeatSnapGrid.cs
+++ b/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneManiaBeatSnapGrid.cs
@@ -13,6 +13,7 @@ using osu.Game.Rulesets.Edit;
 using osu.Game.Rulesets.Mania.Beatmaps;
 using osu.Game.Rulesets.Mania.Edit;
 using osu.Game.Rulesets.Mania.UI;
+using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Objects.Drawables;
 using osu.Game.Rulesets.UI;
 using osu.Game.Rulesets.UI.Scrolling;
@@ -101,27 +102,27 @@ namespace osu.Game.Rulesets.Mania.Tests.Editor
             throw new System.NotImplementedException();
         }
 
-        public override float GetBeatSnapDistanceAt(double referenceTime)
+        public override float GetBeatSnapDistanceAt(HitObject referenceObject)
         {
             throw new System.NotImplementedException();
         }
 
-        public override float DurationToDistance(double referenceTime, double duration)
+        public override float DurationToDistance(HitObject referenceObject, double duration)
         {
             throw new System.NotImplementedException();
         }
 
-        public override double DistanceToDuration(double referenceTime, float distance)
+        public override double DistanceToDuration(HitObject referenceObject, float distance)
         {
             throw new System.NotImplementedException();
         }
 
-        public override double GetSnappedDurationFromDistance(double referenceTime, float distance)
+        public override double GetSnappedDurationFromDistance(HitObject referenceObject, float distance)
         {
             throw new System.NotImplementedException();
         }
 
-        public override float GetSnappedDistanceFromDistance(double referenceTime, float distance)
+        public override float GetSnappedDistanceFromDistance(HitObject referenceObject, float distance)
         {
             throw new System.NotImplementedException();
         }
diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuDistanceSnapGrid.cs b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuDistanceSnapGrid.cs
index 9af2a99470..c8868d4eb1 100644
--- a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuDistanceSnapGrid.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuDistanceSnapGrid.cs
@@ -11,6 +11,7 @@ using osu.Framework.Input.Events;
 using osu.Framework.Utils;
 using osu.Game.Beatmaps.ControlPoints;
 using osu.Game.Rulesets.Edit;
+using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Osu.Beatmaps;
 using osu.Game.Rulesets.Osu.Edit;
 using osu.Game.Rulesets.Osu.Objects;
@@ -179,15 +180,15 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
 
             public SnapResult SnapScreenSpacePositionToValidTime(Vector2 screenSpacePosition) => new SnapResult(screenSpacePosition, 0);
 
-            public float GetBeatSnapDistanceAt(double referenceTime) => (float)beat_length;
+            public float GetBeatSnapDistanceAt(HitObject referenceObject) => (float)beat_length;
 
-            public float DurationToDistance(double referenceTime, double duration) => (float)duration;
+            public float DurationToDistance(HitObject referenceObject, double duration) => (float)duration;
 
-            public double DistanceToDuration(double referenceTime, float distance) => distance;
+            public double DistanceToDuration(HitObject referenceObject, float distance) => distance;
 
-            public double GetSnappedDurationFromDistance(double referenceTime, float distance) => 0;
+            public double GetSnappedDurationFromDistance(HitObject referenceObject, float distance) => 0;
 
-            public float GetSnappedDistanceFromDistance(double referenceTime, float distance) => 0;
+            public float GetSnappedDistanceFromDistance(HitObject referenceObject, float distance) => 0;
         }
     }
 }
diff --git a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/SliderPlacementBlueprint.cs b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/SliderPlacementBlueprint.cs
index b9e4ed6fcb..14853c6ba4 100644
--- a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/SliderPlacementBlueprint.cs
+++ b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/SliderPlacementBlueprint.cs
@@ -212,7 +212,7 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders
 
         private void updateSlider()
         {
-            HitObject.Path.ExpectedDistance.Value = composer?.GetSnappedDistanceFromDistance(HitObject.StartTime, (float)HitObject.Path.CalculatedDistance) ?? (float)HitObject.Path.CalculatedDistance;
+            HitObject.Path.ExpectedDistance.Value = composer?.GetSnappedDistanceFromDistance(HitObject, (float)HitObject.Path.CalculatedDistance) ?? (float)HitObject.Path.CalculatedDistance;
 
             bodyPiece.UpdateFrom(HitObject);
             headCirclePiece.UpdateFrom(HitObject.HeadCircle);
diff --git a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/SliderSelectionBlueprint.cs b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/SliderSelectionBlueprint.cs
index 89724876fa..a7fadfb67f 100644
--- a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/SliderSelectionBlueprint.cs
+++ b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/SliderSelectionBlueprint.cs
@@ -230,7 +230,7 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders
 
         private void updatePath()
         {
-            HitObject.Path.ExpectedDistance.Value = composer?.GetSnappedDistanceFromDistance(HitObject.StartTime, (float)HitObject.Path.CalculatedDistance) ?? (float)HitObject.Path.CalculatedDistance;
+            HitObject.Path.ExpectedDistance.Value = composer?.GetSnappedDistanceFromDistance(HitObject, (float)HitObject.Path.CalculatedDistance) ?? (float)HitObject.Path.CalculatedDistance;
             editorBeatmap?.Update(HitObject);
         }
 
diff --git a/osu.Game.Rulesets.Osu/Edit/OsuDistanceSnapGrid.cs b/osu.Game.Rulesets.Osu/Edit/OsuDistanceSnapGrid.cs
index ff3be97427..8a561f962a 100644
--- a/osu.Game.Rulesets.Osu/Edit/OsuDistanceSnapGrid.cs
+++ b/osu.Game.Rulesets.Osu/Edit/OsuDistanceSnapGrid.cs
@@ -11,7 +11,7 @@ namespace osu.Game.Rulesets.Osu.Edit
     public class OsuDistanceSnapGrid : CircularDistanceSnapGrid
     {
         public OsuDistanceSnapGrid(OsuHitObject hitObject, [CanBeNull] OsuHitObject nextHitObject = null)
-            : base(hitObject.StackedEndPosition, hitObject.GetEndTime(), nextHitObject?.StartTime)
+            : base(hitObject, hitObject.StackedEndPosition, hitObject.GetEndTime(), nextHitObject?.StartTime)
         {
             Masking = true;
         }
diff --git a/osu.Game.Tests/Editing/TestSceneHitObjectComposerDistanceSnapping.cs b/osu.Game.Tests/Editing/TestSceneHitObjectComposerDistanceSnapping.cs
index 7b0f13e9e0..8acac842c7 100644
--- a/osu.Game.Tests/Editing/TestSceneHitObjectComposerDistanceSnapping.cs
+++ b/osu.Game.Tests/Editing/TestSceneHitObjectComposerDistanceSnapping.cs
@@ -8,6 +8,7 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps.ControlPoints;
 using osu.Game.Rulesets.Edit;
+using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Osu.Beatmaps;
 using osu.Game.Rulesets.Osu.Edit;
@@ -198,19 +199,19 @@ namespace osu.Game.Tests.Editing
         }
 
         private void assertSnapDistance(float expectedDistance)
-            => AddAssert($"distance is {expectedDistance}", () => composer.GetBeatSnapDistanceAt(0) == expectedDistance);
+            => AddAssert($"distance is {expectedDistance}", () => composer.GetBeatSnapDistanceAt(new HitObject()) == expectedDistance);
 
         private void assertDurationToDistance(double duration, float expectedDistance)
-            => AddAssert($"duration = {duration} -> distance = {expectedDistance}", () => composer.DurationToDistance(0, duration) == expectedDistance);
+            => AddAssert($"duration = {duration} -> distance = {expectedDistance}", () => composer.DurationToDistance(new HitObject(), duration) == expectedDistance);
 
         private void assertDistanceToDuration(float distance, double expectedDuration)
-            => AddAssert($"distance = {distance} -> duration = {expectedDuration}", () => composer.DistanceToDuration(0, distance) == expectedDuration);
+            => AddAssert($"distance = {distance} -> duration = {expectedDuration}", () => composer.DistanceToDuration(new HitObject(), distance) == expectedDuration);
 
         private void assertSnappedDuration(float distance, double expectedDuration)
-            => AddAssert($"distance = {distance} -> duration = {expectedDuration} (snapped)", () => composer.GetSnappedDurationFromDistance(0, distance) == expectedDuration);
+            => AddAssert($"distance = {distance} -> duration = {expectedDuration} (snapped)", () => composer.GetSnappedDurationFromDistance(new HitObject(), distance) == expectedDuration);
 
         private void assertSnappedDistance(float distance, float expectedDistance)
-            => AddAssert($"distance = {distance} -> distance = {expectedDistance} (snapped)", () => composer.GetSnappedDistanceFromDistance(0, distance) == expectedDistance);
+            => AddAssert($"distance = {distance} -> distance = {expectedDistance} (snapped)", () => composer.GetSnappedDistanceFromDistance(new HitObject(), distance) == expectedDistance);
 
         private class TestHitObjectComposer : OsuHitObjectComposer
         {
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneDistanceSnapGrid.cs b/osu.Game.Tests/Visual/Editing/TestSceneDistanceSnapGrid.cs
index 11830ebe35..d1efd22d6f 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneDistanceSnapGrid.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneDistanceSnapGrid.cs
@@ -7,6 +7,7 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Shapes;
 using osu.Game.Beatmaps.ControlPoints;
 using osu.Game.Rulesets.Edit;
+using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Osu.Beatmaps;
 using osu.Game.Screens.Edit;
 using osu.Game.Screens.Edit.Compose.Components;
@@ -81,7 +82,7 @@ namespace osu.Game.Tests.Visual.Editing
             public new float DistanceSpacing => base.DistanceSpacing;
 
             public TestDistanceSnapGrid(double? endTime = null)
-                : base(grid_position, 0, endTime)
+                : base(new HitObject(), grid_position, 0, endTime)
             {
             }
 
@@ -158,15 +159,15 @@ namespace osu.Game.Tests.Visual.Editing
 
             public SnapResult SnapScreenSpacePositionToValidTime(Vector2 screenSpacePosition) => new SnapResult(screenSpacePosition, 0);
 
-            public float GetBeatSnapDistanceAt(double referenceTime) => 10;
+            public float GetBeatSnapDistanceAt(HitObject referenceObject) => 10;
 
-            public float DurationToDistance(double referenceTime, double duration) => (float)duration;
+            public float DurationToDistance(HitObject referenceObject, double duration) => (float)duration;
 
-            public double DistanceToDuration(double referenceTime, float distance) => distance;
+            public double DistanceToDuration(HitObject referenceObject, float distance) => distance;
 
-            public double GetSnappedDurationFromDistance(double referenceTime, float distance) => 0;
+            public double GetSnappedDurationFromDistance(HitObject referenceObject, float distance) => 0;
 
-            public float GetSnappedDistanceFromDistance(double referenceTime, float distance) => 0;
+            public float GetSnappedDistanceFromDistance(HitObject referenceObject, float distance) => 0;
         }
     }
 }
diff --git a/osu.Game/Rulesets/Edit/HitObjectComposer.cs b/osu.Game/Rulesets/Edit/HitObjectComposer.cs
index fe41157046..847e6cc1c6 100644
--- a/osu.Game/Rulesets/Edit/HitObjectComposer.cs
+++ b/osu.Game/Rulesets/Edit/HitObjectComposer.cs
@@ -13,7 +13,6 @@ using osu.Framework.Input;
 using osu.Framework.Input.Events;
 using osu.Framework.Logging;
 using osu.Game.Beatmaps;
-using osu.Game.Beatmaps.ControlPoints;
 using osu.Game.Rulesets.Configuration;
 using osu.Game.Rulesets.Edit.Tools;
 using osu.Game.Rulesets.Mods;
@@ -389,41 +388,42 @@ namespace osu.Game.Rulesets.Edit
             return new SnapResult(screenSpacePosition, targetTime, playfield);
         }
 
-        public override float GetBeatSnapDistanceAt(double referenceTime)
+        public override float GetBeatSnapDistanceAt(HitObject referenceObject)
         {
-            DifficultyControlPoint difficultyPoint = EditorBeatmap.ControlPointInfo.DifficultyPointAt(referenceTime);
-            return (float)(100 * EditorBeatmap.BeatmapInfo.BaseDifficulty.SliderMultiplier * difficultyPoint.SliderVelocity / BeatSnapProvider.BeatDivisor);
+            return (float)(100 * EditorBeatmap.BeatmapInfo.BaseDifficulty.SliderMultiplier * referenceObject.DifficultyControlPoint.SliderVelocity / BeatSnapProvider.BeatDivisor);
         }
 
-        public override float DurationToDistance(double referenceTime, double duration)
+        public override float DurationToDistance(HitObject referenceObject, double duration)
         {
-            double beatLength = BeatSnapProvider.GetBeatLengthAtTime(referenceTime);
-            return (float)(duration / beatLength * GetBeatSnapDistanceAt(referenceTime));
+            double beatLength = BeatSnapProvider.GetBeatLengthAtTime(referenceObject.StartTime);
+            return (float)(duration / beatLength * GetBeatSnapDistanceAt(referenceObject));
         }
 
-        public override double DistanceToDuration(double referenceTime, float distance)
+        public override double DistanceToDuration(HitObject referenceObject, float distance)
         {
-            double beatLength = BeatSnapProvider.GetBeatLengthAtTime(referenceTime);
-            return distance / GetBeatSnapDistanceAt(referenceTime) * beatLength;
+            double beatLength = BeatSnapProvider.GetBeatLengthAtTime(referenceObject.StartTime);
+            return distance / GetBeatSnapDistanceAt(referenceObject) * beatLength;
         }
 
-        public override double GetSnappedDurationFromDistance(double referenceTime, float distance)
-            => BeatSnapProvider.SnapTime(referenceTime + DistanceToDuration(referenceTime, distance), referenceTime) - referenceTime;
+        public override double GetSnappedDurationFromDistance(HitObject referenceObject, float distance)
+            => BeatSnapProvider.SnapTime(referenceObject.StartTime + DistanceToDuration(referenceObject, distance), referenceObject.StartTime) - referenceObject.StartTime;
 
-        public override float GetSnappedDistanceFromDistance(double referenceTime, float distance)
+        public override float GetSnappedDistanceFromDistance(HitObject referenceObject, float distance)
         {
-            double actualDuration = referenceTime + DistanceToDuration(referenceTime, distance);
+            double startTime = referenceObject.StartTime;
 
-            double snappedEndTime = BeatSnapProvider.SnapTime(actualDuration, referenceTime);
+            double actualDuration = startTime + DistanceToDuration(referenceObject, distance);
 
-            double beatLength = BeatSnapProvider.GetBeatLengthAtTime(referenceTime);
+            double snappedEndTime = BeatSnapProvider.SnapTime(actualDuration, startTime);
+
+            double beatLength = BeatSnapProvider.GetBeatLengthAtTime(startTime);
 
             // we don't want to exceed the actual duration and snap to a point in the future.
             // as we are snapping to beat length via SnapTime (which will round-to-nearest), check for snapping in the forward direction and reverse it.
             if (snappedEndTime > actualDuration + 1)
                 snappedEndTime -= beatLength;
 
-            return DurationToDistance(referenceTime, snappedEndTime - referenceTime);
+            return DurationToDistance(referenceObject, snappedEndTime - startTime);
         }
 
         #endregion
@@ -466,15 +466,15 @@ namespace osu.Game.Rulesets.Edit
         public virtual SnapResult SnapScreenSpacePositionToValidPosition(Vector2 screenSpacePosition) =>
             new SnapResult(screenSpacePosition, null);
 
-        public abstract float GetBeatSnapDistanceAt(double referenceTime);
+        public abstract float GetBeatSnapDistanceAt(HitObject referenceObject);
 
-        public abstract float DurationToDistance(double referenceTime, double duration);
+        public abstract float DurationToDistance(HitObject referenceObject, double duration);
 
-        public abstract double DistanceToDuration(double referenceTime, float distance);
+        public abstract double DistanceToDuration(HitObject referenceObject, float distance);
 
-        public abstract double GetSnappedDurationFromDistance(double referenceTime, float distance);
+        public abstract double GetSnappedDurationFromDistance(HitObject referenceObject, float distance);
 
-        public abstract float GetSnappedDistanceFromDistance(double referenceTime, float distance);
+        public abstract float GetSnappedDistanceFromDistance(HitObject referenceObject, float distance);
 
         #endregion
     }
diff --git a/osu.Game/Rulesets/Edit/IPositionSnapProvider.cs b/osu.Game/Rulesets/Edit/IPositionSnapProvider.cs
index 4664f3808c..7d7d61e1c1 100644
--- a/osu.Game/Rulesets/Edit/IPositionSnapProvider.cs
+++ b/osu.Game/Rulesets/Edit/IPositionSnapProvider.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.Rulesets.Objects;
 using osuTK;
 
 namespace osu.Game.Rulesets.Edit
@@ -27,41 +28,41 @@ namespace osu.Game.Rulesets.Edit
         /// <summary>
         /// Retrieves the distance between two points within a timing point that are one beat length apart.
         /// </summary>
-        /// <param name="referenceTime">The time of the timing point.</param>
+        /// <param name="referenceObject"></param>
         /// <returns>The distance between two points residing in the timing point that are one beat length apart.</returns>
-        float GetBeatSnapDistanceAt(double referenceTime);
+        float GetBeatSnapDistanceAt(HitObject referenceObject);
 
         /// <summary>
         /// Converts a duration to a distance.
         /// </summary>
-        /// <param name="referenceTime">The time of the timing point which <paramref name="duration"/> resides in.</param>
+        /// <param name="referenceObject"></param>
         /// <param name="duration">The duration to convert.</param>
         /// <returns>A value that represents <paramref name="duration"/> as a distance in the timing point.</returns>
-        float DurationToDistance(double referenceTime, double duration);
+        float DurationToDistance(HitObject referenceObject, double duration);
 
         /// <summary>
         /// Converts a distance to a duration.
         /// </summary>
-        /// <param name="referenceTime">The time of the timing point which <paramref name="distance"/> resides in.</param>
+        /// <param name="referenceObject"></param>
         /// <param name="distance">The distance to convert.</param>
         /// <returns>A value that represents <paramref name="distance"/> as a duration in the timing point.</returns>
-        double DistanceToDuration(double referenceTime, float distance);
+        double DistanceToDuration(HitObject referenceObject, float distance);
 
         /// <summary>
         /// Converts a distance to a snapped duration.
         /// </summary>
-        /// <param name="referenceTime">The time of the timing point which <paramref name="distance"/> resides in.</param>
+        /// <param name="referenceObject"></param>
         /// <param name="distance">The distance to convert.</param>
         /// <returns>A value that represents <paramref name="distance"/> as a duration snapped to the closest beat of the timing point.</returns>
-        double GetSnappedDurationFromDistance(double referenceTime, float distance);
+        double GetSnappedDurationFromDistance(HitObject referenceObject, float distance);
 
         /// <summary>
         /// Converts an unsnapped distance to a snapped distance.
         /// The returned distance will always be floored (as to never exceed the provided <paramref name="distance"/>.
         /// </summary>
-        /// <param name="referenceTime">The time of the timing point which <paramref name="distance"/> resides in.</param>
+        /// <param name="referenceObject"></param>
         /// <param name="distance">The distance to convert.</param>
         /// <returns>A value that represents <paramref name="distance"/> snapped to the closest beat of the timing point.</returns>
-        float GetSnappedDistanceFromDistance(double referenceTime, float distance);
+        float GetSnappedDistanceFromDistance(HitObject referenceObject, float distance);
     }
 }
diff --git a/osu.Game/Rulesets/UI/Scrolling/DrawableScrollingRuleset.cs b/osu.Game/Rulesets/UI/Scrolling/DrawableScrollingRuleset.cs
index f8d5a6c5a9..adef42e4c4 100644
--- a/osu.Game/Rulesets/UI/Scrolling/DrawableScrollingRuleset.cs
+++ b/osu.Game/Rulesets/UI/Scrolling/DrawableScrollingRuleset.cs
@@ -142,7 +142,9 @@ namespace osu.Game.Rulesets.UI.Scrolling
             var lastDifficultyPoint = new DifficultyControlPoint();
             var allPoints = new SortedList<ControlPoint>(Comparer<ControlPoint>.Default);
             allPoints.AddRange(Beatmap.ControlPointInfo.TimingPoints);
-            allPoints.AddRange(Beatmap.ControlPointInfo.DifficultyPoints);
+
+            // TODO: fix
+            //allPoints.AddRange(Beatmap.ControlPointInfo.DifficultyPoints);
 
             // Generate the timing points, making non-timing changes use the previous timing change and vice-versa
             var timingChanges = allPoints.Select(c =>
diff --git a/osu.Game/Screens/Edit/Compose/Components/CircularDistanceSnapGrid.cs b/osu.Game/Screens/Edit/Compose/Components/CircularDistanceSnapGrid.cs
index 730f482f83..6b32ff96c4 100644
--- a/osu.Game/Screens/Edit/Compose/Components/CircularDistanceSnapGrid.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/CircularDistanceSnapGrid.cs
@@ -5,14 +5,15 @@ using System;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Graphics.UserInterface;
+using osu.Game.Rulesets.Objects;
 using osuTK;
 
 namespace osu.Game.Screens.Edit.Compose.Components
 {
     public abstract class CircularDistanceSnapGrid : DistanceSnapGrid
     {
-        protected CircularDistanceSnapGrid(Vector2 startPosition, double startTime, double? endTime = null)
-            : base(startPosition, startTime, endTime)
+        protected CircularDistanceSnapGrid(HitObject referenceObject, Vector2 startPosition, double startTime, double? endTime = null)
+            : base(referenceObject, startPosition, startTime, endTime)
         {
         }
 
@@ -79,7 +80,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
             Vector2 normalisedDirection = direction * new Vector2(1f / distance);
             Vector2 snappedPosition = StartPosition + normalisedDirection * radialCount * radius;
 
-            return (snappedPosition, StartTime + SnapProvider.GetSnappedDurationFromDistance(StartTime, (snappedPosition - StartPosition).Length));
+            return (snappedPosition, StartTime + SnapProvider.GetSnappedDurationFromDistance(ReferenceObject, (snappedPosition - StartPosition).Length));
         }
     }
 }
diff --git a/osu.Game/Screens/Edit/Compose/Components/DistanceSnapGrid.cs b/osu.Game/Screens/Edit/Compose/Components/DistanceSnapGrid.cs
index 59f88ac641..9d43e3258a 100644
--- a/osu.Game/Screens/Edit/Compose/Components/DistanceSnapGrid.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/DistanceSnapGrid.cs
@@ -9,6 +9,7 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Layout;
 using osu.Game.Graphics;
 using osu.Game.Rulesets.Edit;
+using osu.Game.Rulesets.Objects;
 using osuTK;
 
 namespace osu.Game.Screens.Edit.Compose.Components
@@ -54,15 +55,20 @@ namespace osu.Game.Screens.Edit.Compose.Components
         private readonly LayoutValue gridCache = new LayoutValue(Invalidation.RequiredParentSizeToFit);
         private readonly double? endTime;
 
+        protected readonly HitObject ReferenceObject;
+
         /// <summary>
         /// Creates a new <see cref="DistanceSnapGrid"/>.
         /// </summary>
+        /// <param name="referenceObject">A reference object to gather relevant difficulty values from.</param>
         /// <param name="startPosition">The position at which the grid should start. The first tick is located one distance spacing length away from this point.</param>
         /// <param name="startTime">The snapping time at <see cref="StartPosition"/>.</param>
         /// <param name="endTime">The time at which the snapping grid should end. If null, the grid will continue until the bounds of the screen are exceeded.</param>
-        protected DistanceSnapGrid(Vector2 startPosition, double startTime, double? endTime = null)
+        protected DistanceSnapGrid(HitObject referenceObject, Vector2 startPosition, double startTime, double? endTime = null)
         {
+            ReferenceObject = referenceObject;
             this.endTime = endTime;
+
             StartPosition = startPosition;
             StartTime = startTime;
 
@@ -80,7 +86,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
 
         private void updateSpacing()
         {
-            DistanceSpacing = SnapProvider.GetBeatSnapDistanceAt(StartTime);
+            DistanceSpacing = SnapProvider.GetBeatSnapDistanceAt(ReferenceObject);
 
             if (endTime == null)
                 MaxIntervals = int.MaxValue;
@@ -88,7 +94,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
             {
                 // +1 is added since a snapped hitobject may have its start time slightly less than the snapped time due to floating point errors
                 double maxDuration = endTime.Value - StartTime + 1;
-                MaxIntervals = (int)(maxDuration / SnapProvider.DistanceToDuration(StartTime, DistanceSpacing));
+                MaxIntervals = (int)(maxDuration / SnapProvider.DistanceToDuration(ReferenceObject, DistanceSpacing));
             }
 
             gridCache.Invalidate();
diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/Timeline.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/Timeline.cs
index 621a24c67d..4296581480 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/Timeline.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/Timeline.cs
@@ -15,6 +15,7 @@ using osu.Game.Beatmaps;
 using osu.Game.Configuration;
 using osu.Game.Graphics;
 using osu.Game.Rulesets.Edit;
+using osu.Game.Rulesets.Objects;
 using osuTK;
 
 namespace osu.Game.Screens.Edit.Compose.Components.Timeline
@@ -298,14 +299,14 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
         private double getTimeFromPosition(Vector2 localPosition) =>
             (localPosition.X / Content.DrawWidth) * track.Length;
 
-        public float GetBeatSnapDistanceAt(double referenceTime) => throw new NotImplementedException();
+        public float GetBeatSnapDistanceAt(HitObject referenceObject) => throw new NotImplementedException();
 
-        public float DurationToDistance(double referenceTime, double duration) => throw new NotImplementedException();
+        public float DurationToDistance(HitObject referenceObject, double duration) => throw new NotImplementedException();
 
-        public double DistanceToDuration(double referenceTime, float distance) => throw new NotImplementedException();
+        public double DistanceToDuration(HitObject referenceObject, float distance) => throw new NotImplementedException();
 
-        public double GetSnappedDurationFromDistance(double referenceTime, float distance) => throw new NotImplementedException();
+        public double GetSnappedDurationFromDistance(HitObject referenceObject, float distance) => throw new NotImplementedException();
 
-        public float GetSnappedDistanceFromDistance(double referenceTime, float distance) => throw new NotImplementedException();
+        public float GetSnappedDistanceFromDistance(HitObject referenceObject, float distance) => throw new NotImplementedException();
     }
 }

From d587dc620321bc4b7563261bfc652999bc8f485f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 1 Sep 2021 18:19:25 +0900
Subject: [PATCH 0041/5547] Populate new approach rate where required

---
 osu.Game.Rulesets.Mania/UI/DrawableManiaRuleset.cs  |  2 +-
 .../Visual/Gameplay/TestSceneScrollingHitObjects.cs |  6 +++---
 osu.Game/Beatmaps/BeatmapDifficulty.cs              |  2 +-
 osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs   |  1 +
 osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs   |  4 +++-
 osu.Game/Rulesets/Timing/MultiplierControlPoint.cs  |  8 ++++----
 .../UI/Scrolling/DrawableScrollingRuleset.cs        | 13 ++++++-------
 7 files changed, 19 insertions(+), 17 deletions(-)

diff --git a/osu.Game.Rulesets.Mania/UI/DrawableManiaRuleset.cs b/osu.Game.Rulesets.Mania/UI/DrawableManiaRuleset.cs
index 614a7b00c7..5247cb05b0 100644
--- a/osu.Game.Rulesets.Mania/UI/DrawableManiaRuleset.cs
+++ b/osu.Game.Rulesets.Mania/UI/DrawableManiaRuleset.cs
@@ -94,7 +94,7 @@ namespace osu.Game.Rulesets.Mania.UI
 
                 // For non-mania beatmap, speed changes should only happen through timing points
                 if (!isForCurrentRuleset)
-                    p.DifficultyPoint = new DifficultyControlPoint();
+                    p.EffectPoint = new EffectControlPoint();
             }
 
             BarLines.ForEach(Playfield.Add);
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneScrollingHitObjects.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneScrollingHitObjects.cs
index 9b444c1f44..88d295561e 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneScrollingHitObjects.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneScrollingHitObjects.cs
@@ -93,9 +93,9 @@ namespace osu.Game.Tests.Visual.Gameplay
 
         private IList<MultiplierControlPoint> testControlPoints => new List<MultiplierControlPoint>
         {
-            new MultiplierControlPoint(time_range) { DifficultyPoint = { SliderVelocity = 1.25 } },
-            new MultiplierControlPoint(1.5 * time_range) { DifficultyPoint = { SliderVelocity = 1 } },
-            new MultiplierControlPoint(2 * time_range) { DifficultyPoint = { SliderVelocity = 1.5 } }
+            new MultiplierControlPoint(time_range) { EffectPoint = { ApproachRate = 1.25 } },
+            new MultiplierControlPoint(1.5 * time_range) { EffectPoint = { ApproachRate = 1 } },
+            new MultiplierControlPoint(2 * time_range) { EffectPoint = { ApproachRate = 1.5 } }
         };
 
         [Test]
diff --git a/osu.Game/Beatmaps/BeatmapDifficulty.cs b/osu.Game/Beatmaps/BeatmapDifficulty.cs
index 1844b193f2..df78af7527 100644
--- a/osu.Game/Beatmaps/BeatmapDifficulty.cs
+++ b/osu.Game/Beatmaps/BeatmapDifficulty.cs
@@ -26,7 +26,7 @@ namespace osu.Game.Beatmaps
             set => approachRate = value;
         }
 
-        public double SliderMultiplier { get; set; } = 1;
+        public double SliderMultiplier { get; set; } = 1; // AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA this needs to be renamed or removed or something.
         public double SliderTickRate { get; set; } = 1;
 
         /// <summary>
diff --git a/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs b/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
index a9b5793565..c19ab0fca9 100644
--- a/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
+++ b/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
@@ -387,6 +387,7 @@ namespace osu.Game.Beatmaps.Formats
             {
                 KiaiMode = kiaiMode,
                 OmitFirstBarLine = omitFirstBarSignature,
+                ApproachRate = speedMultiplier,
             }, timingChange);
 
             addControlPoint(time, new LegacySampleControlPoint
diff --git a/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs b/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs
index a317e6e129..3a206cc63e 100644
--- a/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs
+++ b/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs
@@ -184,7 +184,7 @@ namespace osu.Game.Beatmaps.Formats
                 SampleControlPoint lastRelevantSamplePoint = null;
                 DifficultyControlPoint lastRelevantDifficultyPoint = null;
 
-                // iterate over hitobjects and pull out all required sample changes
+                // iterate over hitobjects and pull out all required sample and difficulty changes
                 foreach (var h in beatmap.HitObjects)
                 {
                     var hSamplePoint = h.SampleControlPoint;
@@ -202,6 +202,8 @@ namespace osu.Game.Beatmaps.Formats
                         lastRelevantSamplePoint = hSamplePoint;
                     }
                 }
+
+                // TODO: we need to pull out approach rate from EffectControlPoint and shove it in with difficulty points where necessary...
             }
 
             foreach (var group in beatmap.ControlPointInfo.Groups)
diff --git a/osu.Game/Rulesets/Timing/MultiplierControlPoint.cs b/osu.Game/Rulesets/Timing/MultiplierControlPoint.cs
index 61308505cd..d5d1c849ec 100644
--- a/osu.Game/Rulesets/Timing/MultiplierControlPoint.cs
+++ b/osu.Game/Rulesets/Timing/MultiplierControlPoint.cs
@@ -7,7 +7,7 @@ using osu.Game.Beatmaps.ControlPoints;
 namespace osu.Game.Rulesets.Timing
 {
     /// <summary>
-    /// A control point which adds an aggregated multiplier based on the provided <see cref="TimingPoint"/>'s BeatLength and <see cref="DifficultyPoint"/>'s SpeedMultiplier.
+    /// A control point which adds an aggregated multiplier based on the provided <see cref="TimingPoint"/>'s BeatLength and <see cref="EffectPoint"/>'s SpeedMultiplier.
     /// </summary>
     public class MultiplierControlPoint : IComparable<MultiplierControlPoint>
     {
@@ -19,7 +19,7 @@ namespace osu.Game.Rulesets.Timing
         /// <summary>
         /// The aggregate multiplier which this <see cref="MultiplierControlPoint"/> provides.
         /// </summary>
-        public double Multiplier => Velocity * DifficultyPoint.SliderVelocity * BaseBeatLength / TimingPoint.BeatLength;
+        public double Multiplier => Velocity * EffectPoint.ApproachRate * BaseBeatLength / TimingPoint.BeatLength;
 
         /// <summary>
         /// The base beat length to scale the <see cref="TimingPoint"/> provided multiplier relative to.
@@ -38,9 +38,9 @@ namespace osu.Game.Rulesets.Timing
         public TimingControlPoint TimingPoint = new TimingControlPoint();
 
         /// <summary>
-        /// The <see cref="DifficultyControlPoint"/> that provides additional difficulty information for this <see cref="MultiplierControlPoint"/>.
+        /// The <see cref="EffectControlPoint"/> that provides additional difficulty information for this <see cref="MultiplierControlPoint"/>.
         /// </summary>
-        public DifficultyControlPoint DifficultyPoint = new DifficultyControlPoint();
+        public EffectControlPoint EffectPoint = new EffectControlPoint();
 
         /// <summary>
         /// Creates a <see cref="MultiplierControlPoint"/>. This is required for JSON serialization
diff --git a/osu.Game/Rulesets/UI/Scrolling/DrawableScrollingRuleset.cs b/osu.Game/Rulesets/UI/Scrolling/DrawableScrollingRuleset.cs
index adef42e4c4..f0a0dd1367 100644
--- a/osu.Game/Rulesets/UI/Scrolling/DrawableScrollingRuleset.cs
+++ b/osu.Game/Rulesets/UI/Scrolling/DrawableScrollingRuleset.cs
@@ -139,27 +139,26 @@ namespace osu.Game.Rulesets.UI.Scrolling
 
             // Merge sequences of timing and difficulty control points to create the aggregate "multiplier" control point
             var lastTimingPoint = new TimingControlPoint();
-            var lastDifficultyPoint = new DifficultyControlPoint();
+            var lastEffectPoint = new EffectControlPoint();
             var allPoints = new SortedList<ControlPoint>(Comparer<ControlPoint>.Default);
-            allPoints.AddRange(Beatmap.ControlPointInfo.TimingPoints);
 
-            // TODO: fix
-            //allPoints.AddRange(Beatmap.ControlPointInfo.DifficultyPoints);
+            allPoints.AddRange(Beatmap.ControlPointInfo.TimingPoints);
+            allPoints.AddRange(Beatmap.ControlPointInfo.EffectPoints);
 
             // Generate the timing points, making non-timing changes use the previous timing change and vice-versa
             var timingChanges = allPoints.Select(c =>
             {
                 if (c is TimingControlPoint timingPoint)
                     lastTimingPoint = timingPoint;
-                else if (c is DifficultyControlPoint difficultyPoint)
-                    lastDifficultyPoint = difficultyPoint;
+                else if (c is EffectControlPoint difficultyPoint)
+                    lastEffectPoint = difficultyPoint;
 
                 return new MultiplierControlPoint(c.Time)
                 {
                     Velocity = Beatmap.BeatmapInfo.BaseDifficulty.SliderMultiplier,
                     BaseBeatLength = baseBeatLength,
                     TimingPoint = lastTimingPoint,
-                    DifficultyPoint = lastDifficultyPoint
+                    EffectPoint = lastEffectPoint
                 };
             });
 

From 1aff4c2238a9a56a863152955cebd8675f29ff64 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 1 Sep 2021 18:26:00 +0900
Subject: [PATCH 0042/5547] Ensure all hitobject level control points are
 populated before calling `virtual` defaults application

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

diff --git a/osu.Game/Rulesets/Objects/HitObject.cs b/osu.Game/Rulesets/Objects/HitObject.cs
index b540dc1b6e..4cd9297170 100644
--- a/osu.Game/Rulesets/Objects/HitObject.cs
+++ b/osu.Game/Rulesets/Objects/HitObject.cs
@@ -106,8 +106,6 @@ namespace osu.Game.Rulesets.Objects
         /// <param name="cancellationToken">The cancellation token.</param>
         public void ApplyDefaults(ControlPointInfo controlPointInfo, BeatmapDifficulty difficulty, CancellationToken cancellationToken = default)
         {
-            ApplyDefaultsToSelf(controlPointInfo, difficulty);
-
             if (controlPointInfo is LegacyControlPointInfo legacyInfo)
             {
                 // This is done here since ApplyDefaultsToSelf may be used to determine the end time
@@ -120,6 +118,8 @@ namespace osu.Game.Rulesets.Objects
                 DifficultyControlPoint ??= DifficultyControlPoint.DEFAULT;
             }
 
+            ApplyDefaultsToSelf(controlPointInfo, difficulty);
+
             nestedHitObjects.Clear();
 
             CreateNestedHitObjects(cancellationToken);

From 2b9157987e6539ca3fcca85762c15c8152598dca Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 2 Sep 2021 19:34:09 +0900
Subject: [PATCH 0043/5547] Fix regression in `SampleControlPoint` add logic

---
 osu.Game/Beatmaps/Legacy/LegacyControlPointInfo.cs | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Beatmaps/Legacy/LegacyControlPointInfo.cs b/osu.Game/Beatmaps/Legacy/LegacyControlPointInfo.cs
index d3c0559ec8..4059cb7c01 100644
--- a/osu.Game/Beatmaps/Legacy/LegacyControlPointInfo.cs
+++ b/osu.Game/Beatmaps/Legacy/LegacyControlPointInfo.cs
@@ -56,7 +56,9 @@ namespace osu.Game.Beatmaps.Legacy
             switch (newPoint)
             {
                 case SampleControlPoint _:
-                    return newPoint.IsRedundant(SamplePointAt(time));
+                    // intentionally don't use SamplePointAt (we always need to consider the first sample point).
+                    var existing = BinarySearch(SamplePoints, time);
+                    return newPoint.IsRedundant(existing);
 
                 case DifficultyControlPoint _:
                     return newPoint.IsRedundant(DifficultyPointAt(time));

From 74f385bad83a4593438535dfdc0504fe44570842 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 2 Sep 2021 19:42:34 +0900
Subject: [PATCH 0044/5547] Assign default control points earlier in
 `HitObject` construction

---
 osu.Game/Rulesets/Objects/HitObject.cs | 9 ++-------
 1 file changed, 2 insertions(+), 7 deletions(-)

diff --git a/osu.Game/Rulesets/Objects/HitObject.cs b/osu.Game/Rulesets/Objects/HitObject.cs
index 4cd9297170..9446c9aa95 100644
--- a/osu.Game/Rulesets/Objects/HitObject.cs
+++ b/osu.Game/Rulesets/Objects/HitObject.cs
@@ -66,9 +66,9 @@ namespace osu.Game.Rulesets.Objects
             }
         }
 
-        public SampleControlPoint SampleControlPoint;
+        public SampleControlPoint SampleControlPoint = SampleControlPoint.DEFAULT;
 
-        public DifficultyControlPoint DifficultyControlPoint;
+        public DifficultyControlPoint DifficultyControlPoint = DifficultyControlPoint.DEFAULT;
 
         /// <summary>
         /// Whether this <see cref="HitObject"/> is in Kiai time.
@@ -112,11 +112,6 @@ namespace osu.Game.Rulesets.Objects
                 SampleControlPoint = legacyInfo.SamplePointAt(this.GetEndTime() + control_point_leniency);
                 DifficultyControlPoint = legacyInfo.DifficultyPointAt(StartTime);
             }
-            else
-            {
-                SampleControlPoint ??= SampleControlPoint.DEFAULT;
-                DifficultyControlPoint ??= DifficultyControlPoint.DEFAULT;
-            }
 
             ApplyDefaultsToSelf(controlPointInfo, difficulty);
 

From b2a14b13dc8cff160aa030aeec30f51bdacf645e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 2 Sep 2021 19:42:41 +0900
Subject: [PATCH 0045/5547] Update outdated tests

---
 .../TestSceneObjectOrderedHitPolicy.cs             |  4 ++--
 .../TestSceneSliderInput.cs                        |  3 +--
 .../TestSceneStartTimeOrderedHitPolicy.cs          |  4 ++--
 .../Beatmaps/Formats/LegacyBeatmapDecoderTest.cs   |  4 ++--
 .../TestSceneHitObjectComposerDistanceSnapping.cs  | 14 +++++++-------
 5 files changed, 14 insertions(+), 15 deletions(-)

diff --git a/osu.Game.Rulesets.Osu.Tests/TestSceneObjectOrderedHitPolicy.cs b/osu.Game.Rulesets.Osu.Tests/TestSceneObjectOrderedHitPolicy.cs
index 904aee7b0d..093cea39e5 100644
--- a/osu.Game.Rulesets.Osu.Tests/TestSceneObjectOrderedHitPolicy.cs
+++ b/osu.Game.Rulesets.Osu.Tests/TestSceneObjectOrderedHitPolicy.cs
@@ -407,8 +407,6 @@ namespace osu.Game.Rulesets.Osu.Tests
                     },
                 });
 
-                Beatmap.Value.Beatmap.ControlPointInfo.Add(0, new DifficultyControlPoint { SliderVelocity = 0.1f });
-
                 SelectedMods.Value = new[] { new OsuModClassic() };
 
                 var p = new ScoreAccessibleReplayPlayer(new Score { Replay = new Replay { Frames = frames } });
@@ -439,6 +437,8 @@ namespace osu.Game.Rulesets.Osu.Tests
         {
             public TestSlider()
             {
+                DifficultyControlPoint = new DifficultyControlPoint { SliderVelocity = 0.1f };
+
                 DefaultsApplied += _ =>
                 {
                     HeadCircle.HitWindows = new TestHitWindows();
diff --git a/osu.Game.Rulesets.Osu.Tests/TestSceneSliderInput.cs b/osu.Game.Rulesets.Osu.Tests/TestSceneSliderInput.cs
index c4f8a14aef..f3392724ec 100644
--- a/osu.Game.Rulesets.Osu.Tests/TestSceneSliderInput.cs
+++ b/osu.Game.Rulesets.Osu.Tests/TestSceneSliderInput.cs
@@ -348,6 +348,7 @@ namespace osu.Game.Rulesets.Osu.Tests
                         {
                             StartTime = time_slider_start,
                             Position = new Vector2(0, 0),
+                            DifficultyControlPoint = new DifficultyControlPoint { SliderVelocity = 0.1f },
                             Path = new SliderPath(PathType.PerfectCurve, new[]
                             {
                                 Vector2.Zero,
@@ -362,8 +363,6 @@ namespace osu.Game.Rulesets.Osu.Tests
                     },
                 });
 
-                Beatmap.Value.Beatmap.ControlPointInfo.Add(0, new DifficultyControlPoint { SliderVelocity = 0.1f });
-
                 var p = new ScoreAccessibleReplayPlayer(new Score { Replay = new Replay { Frames = frames } });
 
                 p.OnLoadComplete += _ =>
diff --git a/osu.Game.Rulesets.Osu.Tests/TestSceneStartTimeOrderedHitPolicy.cs b/osu.Game.Rulesets.Osu.Tests/TestSceneStartTimeOrderedHitPolicy.cs
index 2b90fd7f38..994f8db4da 100644
--- a/osu.Game.Rulesets.Osu.Tests/TestSceneStartTimeOrderedHitPolicy.cs
+++ b/osu.Game.Rulesets.Osu.Tests/TestSceneStartTimeOrderedHitPolicy.cs
@@ -369,8 +369,6 @@ namespace osu.Game.Rulesets.Osu.Tests
                     },
                 });
 
-                Beatmap.Value.Beatmap.ControlPointInfo.Add(0, new DifficultyControlPoint { SliderVelocity = 0.1f });
-
                 var p = new ScoreAccessibleReplayPlayer(new Score { Replay = new Replay { Frames = frames } });
 
                 p.OnLoadComplete += _ =>
@@ -399,6 +397,8 @@ namespace osu.Game.Rulesets.Osu.Tests
         {
             public TestSlider()
             {
+                DifficultyControlPoint = new DifficultyControlPoint { SliderVelocity = 0.1f };
+
                 DefaultsApplied += _ =>
                 {
                     HeadCircle.HitWindows = new TestHitWindows();
diff --git a/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs b/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs
index e8590d0f82..b9244d88fe 100644
--- a/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs
+++ b/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs
@@ -172,7 +172,7 @@ namespace osu.Game.Tests.Beatmaps.Formats
                 Assert.AreEqual(4, controlPoints.TimingPoints.Count);
                 Assert.AreEqual(5, controlPoints.DifficultyPoints.Count);
                 Assert.AreEqual(34, controlPoints.SamplePoints.Count);
-                Assert.AreEqual(8, controlPoints.EffectPoints.Count);
+                Assert.AreEqual(13, controlPoints.EffectPoints.Count);
 
                 var timingPoint = controlPoints.TimingPointAt(0);
                 Assert.AreEqual(956, timingPoint.Time);
@@ -226,7 +226,7 @@ namespace osu.Game.Tests.Beatmaps.Formats
                 Assert.IsTrue(effectPoint.KiaiMode);
                 Assert.IsFalse(effectPoint.OmitFirstBarLine);
 
-                effectPoint = controlPoints.EffectPointAt(119637);
+                effectPoint = controlPoints.EffectPointAt(116637);
                 Assert.AreEqual(95901, effectPoint.Time);
                 Assert.IsFalse(effectPoint.KiaiMode);
                 Assert.IsFalse(effectPoint.OmitFirstBarLine);
diff --git a/osu.Game.Tests/Editing/TestSceneHitObjectComposerDistanceSnapping.cs b/osu.Game.Tests/Editing/TestSceneHitObjectComposerDistanceSnapping.cs
index 8acac842c7..cef4f7b8b4 100644
--- a/osu.Game.Tests/Editing/TestSceneHitObjectComposerDistanceSnapping.cs
+++ b/osu.Game.Tests/Editing/TestSceneHitObjectComposerDistanceSnapping.cs
@@ -74,13 +74,13 @@ namespace osu.Game.Tests.Editing
         [TestCase(2)]
         public void TestSpeedMultiplier(float multiplier)
         {
-            AddStep($"set multiplier = {multiplier}", () =>
+            assertSnapDistance(100 * multiplier, new HitObject
             {
-                composer.EditorBeatmap.ControlPointInfo.Clear();
-                composer.EditorBeatmap.ControlPointInfo.Add(0, new DifficultyControlPoint { SliderVelocity = multiplier });
+                DifficultyControlPoint = new DifficultyControlPoint
+                {
+                    SliderVelocity = multiplier
+                }
             });
-
-            assertSnapDistance(100 * multiplier);
         }
 
         [TestCase(1)]
@@ -198,8 +198,8 @@ namespace osu.Game.Tests.Editing
             assertSnappedDistance(400, 400);
         }
 
-        private void assertSnapDistance(float expectedDistance)
-            => AddAssert($"distance is {expectedDistance}", () => composer.GetBeatSnapDistanceAt(new HitObject()) == expectedDistance);
+        private void assertSnapDistance(float expectedDistance, HitObject hitObject = null)
+            => AddAssert($"distance is {expectedDistance}", () => composer.GetBeatSnapDistanceAt(hitObject ?? new HitObject()) == expectedDistance);
 
         private void assertDurationToDistance(double duration, float expectedDistance)
             => AddAssert($"duration = {duration} -> distance = {expectedDistance}", () => composer.DurationToDistance(new HitObject(), duration) == expectedDistance);

From 8f24ea54eeb2ee469af744aff0c2de3d8c4951bf Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 3 Sep 2021 16:16:40 +0900
Subject: [PATCH 0046/5547] Change `SamplePoints` to be `SortedList` for
 conformity

---
 osu.Game/Beatmaps/Legacy/LegacyControlPointInfo.cs | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Beatmaps/Legacy/LegacyControlPointInfo.cs b/osu.Game/Beatmaps/Legacy/LegacyControlPointInfo.cs
index 4059cb7c01..c790ed0366 100644
--- a/osu.Game/Beatmaps/Legacy/LegacyControlPointInfo.cs
+++ b/osu.Game/Beatmaps/Legacy/LegacyControlPointInfo.cs
@@ -4,7 +4,6 @@
 using System.Collections.Generic;
 using JetBrains.Annotations;
 using Newtonsoft.Json;
-using osu.Framework.Bindables;
 using osu.Framework.Lists;
 using osu.Game.Beatmaps.ControlPoints;
 
@@ -16,9 +15,9 @@ namespace osu.Game.Beatmaps.Legacy
         /// All sound points.
         /// </summary>
         [JsonProperty]
-        public IBindableList<SampleControlPoint> SamplePoints => samplePoints;
+        public IReadOnlyList<SampleControlPoint> SamplePoints => samplePoints;
 
-        private readonly BindableList<SampleControlPoint> samplePoints = new BindableList<SampleControlPoint>();
+        private readonly SortedList<SampleControlPoint> samplePoints = new SortedList<SampleControlPoint>(Comparer<SampleControlPoint>.Default);
 
         /// <summary>
         /// Finds the sound control point that is active at <paramref name="time"/>.

From 6894ed3426a9e86959ce0a326b024acab33a6a40 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 3 Sep 2021 16:48:37 +0900
Subject: [PATCH 0047/5547] Fix new ordering of retrieval meaning `EndTime` is
 not available in time

---
 osu.Game/Rulesets/Objects/HitObject.cs | 13 +++++++------
 1 file changed, 7 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Rulesets/Objects/HitObject.cs b/osu.Game/Rulesets/Objects/HitObject.cs
index 9446c9aa95..49bcf7a10c 100644
--- a/osu.Game/Rulesets/Objects/HitObject.cs
+++ b/osu.Game/Rulesets/Objects/HitObject.cs
@@ -67,7 +67,6 @@ namespace osu.Game.Rulesets.Objects
         }
 
         public SampleControlPoint SampleControlPoint = SampleControlPoint.DEFAULT;
-
         public DifficultyControlPoint DifficultyControlPoint = DifficultyControlPoint.DEFAULT;
 
         /// <summary>
@@ -106,15 +105,17 @@ namespace osu.Game.Rulesets.Objects
         /// <param name="cancellationToken">The cancellation token.</param>
         public void ApplyDefaults(ControlPointInfo controlPointInfo, BeatmapDifficulty difficulty, CancellationToken cancellationToken = default)
         {
-            if (controlPointInfo is LegacyControlPointInfo legacyInfo)
-            {
-                // This is done here since ApplyDefaultsToSelf may be used to determine the end time
-                SampleControlPoint = legacyInfo.SamplePointAt(this.GetEndTime() + control_point_leniency);
+            var legacyInfo = controlPointInfo as LegacyControlPointInfo;
+
+            if (legacyInfo != null)
                 DifficultyControlPoint = legacyInfo.DifficultyPointAt(StartTime);
-            }
 
             ApplyDefaultsToSelf(controlPointInfo, difficulty);
 
+            // This is done here after ApplyDefaultsToSelf as we may require custom defaults to be applied to have an accurate end time.
+            if (legacyInfo != null)
+                SampleControlPoint = legacyInfo.SamplePointAt(this.GetEndTime() + control_point_leniency);
+
             nestedHitObjects.Clear();
 
             CreateNestedHitObjects(cancellationToken);

From 0e6660da30584a04de86565f0517fc35c3d1f5bc Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 3 Sep 2021 16:57:25 +0900
Subject: [PATCH 0048/5547] Replace todo with permanent comment

---
 osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs b/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs
index 3a206cc63e..25fe6e4a30 100644
--- a/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs
+++ b/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs
@@ -203,7 +203,8 @@ namespace osu.Game.Beatmaps.Formats
                     }
                 }
 
-                // TODO: we need to pull out approach rate from EffectControlPoint and shove it in with difficulty points where necessary...
+                // In the future we may want to pull out approach rate changes from EffectPoints (and create DifficultyControlPoints to handle them).
+                // This requires special consideration due to precision mismatches (see implementation of LegacyDifficultyControlPoint).
             }
 
             foreach (var group in beatmap.ControlPointInfo.Groups)

From f42131ff89125e4d8e3ed3c55f36dd42b8777d92 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 3 Sep 2021 19:08:23 +0900
Subject: [PATCH 0049/5547] Add back editor functionality for now

---
 osu.Game/Screens/Edit/Timing/DifficultySection.cs | 11 ++++++++++-
 osu.Game/Screens/Edit/Timing/SampleSection.cs     | 12 +++++++++++-
 2 files changed, 21 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/Edit/Timing/DifficultySection.cs b/osu.Game/Screens/Edit/Timing/DifficultySection.cs
index 1332cca0e3..7cab9890bf 100644
--- a/osu.Game/Screens/Edit/Timing/DifficultySection.cs
+++ b/osu.Game/Screens/Edit/Timing/DifficultySection.cs
@@ -4,6 +4,7 @@
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Game.Beatmaps.ControlPoints;
+using osu.Game.Beatmaps.Legacy;
 
 namespace osu.Game.Screens.Edit.Timing
 {
@@ -42,6 +43,14 @@ namespace osu.Game.Screens.Edit.Timing
             }
         }
 
-        protected override DifficultyControlPoint CreatePoint() => new DifficultyControlPoint(); // TODO: remove
+        protected override DifficultyControlPoint CreatePoint()
+        {
+            var reference = (Beatmap.ControlPointInfo as LegacyControlPointInfo)?.DifficultyPointAt(SelectedGroup.Value.Time) ?? DifficultyControlPoint.DEFAULT;
+
+            return new DifficultyControlPoint
+            {
+                SliderVelocity = reference.SliderVelocity,
+            };
+        }
     }
 }
diff --git a/osu.Game/Screens/Edit/Timing/SampleSection.cs b/osu.Game/Screens/Edit/Timing/SampleSection.cs
index 52709a2bbe..96a67ab046 100644
--- a/osu.Game/Screens/Edit/Timing/SampleSection.cs
+++ b/osu.Game/Screens/Edit/Timing/SampleSection.cs
@@ -5,6 +5,7 @@ using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Game.Beatmaps.ControlPoints;
+using osu.Game.Beatmaps.Legacy;
 using osu.Game.Graphics.UserInterfaceV2;
 
 namespace osu.Game.Screens.Edit.Timing
@@ -42,6 +43,15 @@ namespace osu.Game.Screens.Edit.Timing
             }
         }
 
-        protected override SampleControlPoint CreatePoint() => new SampleControlPoint(); // TODO: remove
+        protected override SampleControlPoint CreatePoint()
+        {
+            var reference = (Beatmap.ControlPointInfo as LegacyControlPointInfo)?.SamplePointAt(SelectedGroup.Value.Time) ?? SampleControlPoint.DEFAULT;
+
+            return new SampleControlPoint
+            {
+                SampleBank = reference.SampleBank,
+                SampleVolume = reference.SampleVolume,
+            };
+        }
     }
 }

From 766d7898458164b85bec1c4b7168b1a6d235ba33 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 6 Sep 2021 14:56:34 +0900
Subject: [PATCH 0050/5547] Rename `ApproachRate` to `ScrollSpeed` for now (to
 reduce complexity/confusion)

---
 .../Gameplay/TestSceneScrollingHitObjects.cs   |  6 +++---
 .../ControlPoints/EffectControlPoint.cs        | 18 +++++++++---------
 .../Beatmaps/Formats/LegacyBeatmapDecoder.cs   |  2 +-
 .../Rulesets/Timing/MultiplierControlPoint.cs  |  2 +-
 4 files changed, 14 insertions(+), 14 deletions(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneScrollingHitObjects.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneScrollingHitObjects.cs
index 88d295561e..283fe594ea 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneScrollingHitObjects.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneScrollingHitObjects.cs
@@ -93,9 +93,9 @@ namespace osu.Game.Tests.Visual.Gameplay
 
         private IList<MultiplierControlPoint> testControlPoints => new List<MultiplierControlPoint>
         {
-            new MultiplierControlPoint(time_range) { EffectPoint = { ApproachRate = 1.25 } },
-            new MultiplierControlPoint(1.5 * time_range) { EffectPoint = { ApproachRate = 1 } },
-            new MultiplierControlPoint(2 * time_range) { EffectPoint = { ApproachRate = 1.5 } }
+            new MultiplierControlPoint(time_range) { EffectPoint = { ScrollSpeed = 1.25 } },
+            new MultiplierControlPoint(1.5 * time_range) { EffectPoint = { ScrollSpeed = 1 } },
+            new MultiplierControlPoint(2 * time_range) { EffectPoint = { ScrollSpeed = 1.5 } }
         };
 
         [Test]
diff --git a/osu.Game/Beatmaps/ControlPoints/EffectControlPoint.cs b/osu.Game/Beatmaps/ControlPoints/EffectControlPoint.cs
index a7423e4710..7f550a52fc 100644
--- a/osu.Game/Beatmaps/ControlPoints/EffectControlPoint.cs
+++ b/osu.Game/Beatmaps/ControlPoints/EffectControlPoint.cs
@@ -13,7 +13,7 @@ namespace osu.Game.Beatmaps.ControlPoints
         {
             KiaiModeBindable = { Disabled = true },
             OmitFirstBarLineBindable = { Disabled = true },
-            ApproachRateBindable = { Disabled = true }
+            ScrollSpeedBindable = { Disabled = true }
         };
 
         /// <summary>
@@ -22,9 +22,9 @@ namespace osu.Game.Beatmaps.ControlPoints
         public readonly BindableBool OmitFirstBarLineBindable = new BindableBool();
 
         /// <summary>
-        /// The relative approach rate at this control point.
+        /// The relative scroll speed at this control point.
         /// </summary>
-        public readonly BindableDouble ApproachRateBindable = new BindableDouble(1)
+        public readonly BindableDouble ScrollSpeedBindable = new BindableDouble(1)
         {
             Precision = 0.01,
             Default = 1,
@@ -33,12 +33,12 @@ namespace osu.Game.Beatmaps.ControlPoints
         };
 
         /// <summary>
-        /// The relative approach rate.
+        /// The relative scroll speed.
         /// </summary>
-        public double ApproachRate
+        public double ScrollSpeed
         {
-            get => ApproachRateBindable.Value;
-            set => ApproachRateBindable.Value = value;
+            get => ScrollSpeedBindable.Value;
+            set => ScrollSpeedBindable.Value = value;
         }
 
         public override Color4 GetRepresentingColour(OsuColour colours) => colours.Purple;
@@ -71,13 +71,13 @@ namespace osu.Game.Beatmaps.ControlPoints
                && existing is EffectControlPoint existingEffect
                && KiaiMode == existingEffect.KiaiMode
                && OmitFirstBarLine == existingEffect.OmitFirstBarLine
-               && ApproachRate == existingEffect.ApproachRate;
+               && ScrollSpeed == existingEffect.ScrollSpeed;
 
         public override void CopyFrom(ControlPoint other)
         {
             KiaiMode = ((EffectControlPoint)other).KiaiMode;
             OmitFirstBarLine = ((EffectControlPoint)other).OmitFirstBarLine;
-            ApproachRate = ((EffectControlPoint)other).ApproachRate;
+            ScrollSpeed = ((EffectControlPoint)other).ScrollSpeed;
 
             base.CopyFrom(other);
         }
diff --git a/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs b/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
index c19ab0fca9..d075af291c 100644
--- a/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
+++ b/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
@@ -387,7 +387,7 @@ namespace osu.Game.Beatmaps.Formats
             {
                 KiaiMode = kiaiMode,
                 OmitFirstBarLine = omitFirstBarSignature,
-                ApproachRate = speedMultiplier,
+                ScrollSpeed = speedMultiplier,
             }, timingChange);
 
             addControlPoint(time, new LegacySampleControlPoint
diff --git a/osu.Game/Rulesets/Timing/MultiplierControlPoint.cs b/osu.Game/Rulesets/Timing/MultiplierControlPoint.cs
index d5d1c849ec..23325bcd13 100644
--- a/osu.Game/Rulesets/Timing/MultiplierControlPoint.cs
+++ b/osu.Game/Rulesets/Timing/MultiplierControlPoint.cs
@@ -19,7 +19,7 @@ namespace osu.Game.Rulesets.Timing
         /// <summary>
         /// The aggregate multiplier which this <see cref="MultiplierControlPoint"/> provides.
         /// </summary>
-        public double Multiplier => Velocity * EffectPoint.ApproachRate * BaseBeatLength / TimingPoint.BeatLength;
+        public double Multiplier => Velocity * EffectPoint.ScrollSpeed * BaseBeatLength / TimingPoint.BeatLength;
 
         /// <summary>
         /// The base beat length to scale the <see cref="TimingPoint"/> provided multiplier relative to.

From 52b6b058834577b799b9a72b7c0f392a45291e29 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 6 Sep 2021 15:11:52 +0900
Subject: [PATCH 0051/5547] Update terminology in timing screen for now

---
 osu.Game/Screens/Edit/Timing/DifficultySection.cs | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Screens/Edit/Timing/DifficultySection.cs b/osu.Game/Screens/Edit/Timing/DifficultySection.cs
index 7cab9890bf..52d38f19f6 100644
--- a/osu.Game/Screens/Edit/Timing/DifficultySection.cs
+++ b/osu.Game/Screens/Edit/Timing/DifficultySection.cs
@@ -10,14 +10,14 @@ namespace osu.Game.Screens.Edit.Timing
 {
     internal class DifficultySection : Section<DifficultyControlPoint>
     {
-        private SliderWithTextBoxInput<double> multiplierSlider;
+        private SliderWithTextBoxInput<double> sliderVelocitySlider;
 
         [BackgroundDependencyLoader]
         private void load()
         {
             Flow.AddRange(new[]
             {
-                multiplierSlider = new SliderWithTextBoxInput<double>("Speed Multiplier")
+                sliderVelocitySlider = new SliderWithTextBoxInput<double>("Slider Velocity")
                 {
                     Current = new DifficultyControlPoint().SliderVelocityBindable,
                     KeyboardStep = 0.1f
@@ -38,8 +38,8 @@ namespace osu.Game.Screens.Edit.Timing
                 if (selectedPointBindable.Precision < expectedPrecision)
                     selectedPointBindable.Precision = expectedPrecision;
 
-                multiplierSlider.Current = selectedPointBindable;
-                multiplierSlider.Current.BindValueChanged(_ => ChangeHandler?.SaveState());
+                sliderVelocitySlider.Current = selectedPointBindable;
+                sliderVelocitySlider.Current.BindValueChanged(_ => ChangeHandler?.SaveState());
             }
         }
 

From 3c7a34bdbd8f6d13c8c8f7bddede5c7b1b32e309 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 6 Sep 2021 21:05:43 +0900
Subject: [PATCH 0052/5547] Move mania-specific conversion to converter

---
 .../Beatmaps/ManiaBeatmapConverter.cs         | 22 +++++++
 .../Formats/LegacyBeatmapDecoderTest.cs       |  2 +-
 .../Beatmaps/Formats/LegacyBeatmapDecoder.cs  |  1 -
 .../Beatmaps/Formats/LegacyBeatmapEncoder.cs  | 59 ++++++++++---------
 .../UI/Scrolling/DrawableScrollingRuleset.cs  | 14 +++--
 osu.Game/Screens/Edit/Timing/EffectSection.cs | 16 ++++-
 .../RowAttributes/EffectRowAttribute.cs       |  7 +++
 7 files changed, 86 insertions(+), 35 deletions(-)

diff --git a/osu.Game.Rulesets.Mania/Beatmaps/ManiaBeatmapConverter.cs b/osu.Game.Rulesets.Mania/Beatmaps/ManiaBeatmapConverter.cs
index 26393c8edb..0ff48122e2 100644
--- a/osu.Game.Rulesets.Mania/Beatmaps/ManiaBeatmapConverter.cs
+++ b/osu.Game.Rulesets.Mania/Beatmaps/ManiaBeatmapConverter.cs
@@ -8,6 +8,8 @@ using System.Collections.Generic;
 using System.Threading;
 using osu.Game.Audio;
 using osu.Game.Beatmaps;
+using osu.Game.Beatmaps.ControlPoints;
+using osu.Game.Beatmaps.Legacy;
 using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Objects.Types;
 using osu.Game.Rulesets.Mania.Beatmaps.Patterns;
@@ -47,6 +49,26 @@ namespace osu.Game.Rulesets.Mania.Beatmaps
 
             if (IsForCurrentRuleset)
             {
+                if (beatmap.ControlPointInfo is LegacyControlPointInfo legacyControlPoints)
+                {
+                    // convert all slider velocity adjustments to scroll speed adjustments.
+                    foreach (var controlPoint in legacyControlPoints.DifficultyPoints.ToArray())
+                    {
+                        double time = controlPoint.Time;
+
+                        var reference = legacyControlPoints.EffectPointAt(time);
+
+                        var scrollControlPoint = new EffectControlPoint();
+                        scrollControlPoint.CopyFrom(reference);
+                        scrollControlPoint.ScrollSpeed = controlPoint.SliderVelocity;
+
+                        legacyControlPoints.Add(time, scrollControlPoint);
+
+                        // remove the DifficultyControlPoint as we don't need them any more.
+                        legacyControlPoints.GroupAt(time).Remove(controlPoint);
+                    }
+                }
+
                 TargetColumns = GetColumnCountForNonConvert(beatmap.BeatmapInfo);
 
                 if (TargetColumns > ManiaRuleset.MAX_STAGE_KEYS)
diff --git a/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs b/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs
index b9244d88fe..eaa15f28ad 100644
--- a/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs
+++ b/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs
@@ -172,7 +172,7 @@ namespace osu.Game.Tests.Beatmaps.Formats
                 Assert.AreEqual(4, controlPoints.TimingPoints.Count);
                 Assert.AreEqual(5, controlPoints.DifficultyPoints.Count);
                 Assert.AreEqual(34, controlPoints.SamplePoints.Count);
-                Assert.AreEqual(13, controlPoints.EffectPoints.Count);
+                Assert.AreEqual(8, controlPoints.EffectPoints.Count);
 
                 var timingPoint = controlPoints.TimingPointAt(0);
                 Assert.AreEqual(956, timingPoint.Time);
diff --git a/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs b/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
index d075af291c..a9b5793565 100644
--- a/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
+++ b/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
@@ -387,7 +387,6 @@ namespace osu.Game.Beatmaps.Formats
             {
                 KiaiMode = kiaiMode,
                 OmitFirstBarLine = omitFirstBarSignature,
-                ScrollSpeed = speedMultiplier,
             }, timingChange);
 
             addControlPoint(time, new LegacySampleControlPoint
diff --git a/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs b/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs
index 25fe6e4a30..7672c4039a 100644
--- a/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs
+++ b/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs
@@ -170,24 +170,22 @@ namespace osu.Game.Beatmaps.Formats
             if (beatmap.ControlPointInfo.Groups.Count == 0)
                 return;
 
+            var legacyControlPoints = new LegacyControlPointInfo();
+            foreach (var point in beatmap.ControlPointInfo.AllControlPoints)
+                legacyControlPoints.Add(point.Time, point.DeepClone());
+
             writer.WriteLine("[TimingPoints]");
 
-            if (!(beatmap.ControlPointInfo is LegacyControlPointInfo))
+            SampleControlPoint lastRelevantSamplePoint = null;
+            DifficultyControlPoint lastRelevantDifficultyPoint = null;
+
+            bool isOsuRuleset = beatmap.BeatmapInfo.RulesetID == 0;
+
+            // iterate over hitobjects and pull out all required sample and difficulty changes
+            foreach (var h in beatmap.HitObjects)
             {
-                var legacyControlPoints = new LegacyControlPointInfo();
-
-                foreach (var point in beatmap.ControlPointInfo.AllControlPoints)
-                    legacyControlPoints.Add(point.Time, point.DeepClone());
-
-                beatmap.ControlPointInfo = legacyControlPoints;
-
-                SampleControlPoint lastRelevantSamplePoint = null;
-                DifficultyControlPoint lastRelevantDifficultyPoint = null;
-
-                // iterate over hitobjects and pull out all required sample and difficulty changes
-                foreach (var h in beatmap.HitObjects)
+                if (isOsuRuleset)
                 {
-                    var hSamplePoint = h.SampleControlPoint;
                     var hDifficultyPoint = h.DifficultyControlPoint;
 
                     if (!hDifficultyPoint.IsRedundant(lastRelevantDifficultyPoint))
@@ -195,19 +193,26 @@ namespace osu.Game.Beatmaps.Formats
                         legacyControlPoints.Add(hDifficultyPoint.Time, hDifficultyPoint);
                         lastRelevantDifficultyPoint = hDifficultyPoint;
                     }
-
-                    if (!hSamplePoint.IsRedundant(lastRelevantSamplePoint))
-                    {
-                        legacyControlPoints.Add(hSamplePoint.Time, hSamplePoint);
-                        lastRelevantSamplePoint = hSamplePoint;
-                    }
                 }
 
-                // In the future we may want to pull out approach rate changes from EffectPoints (and create DifficultyControlPoints to handle them).
-                // This requires special consideration due to precision mismatches (see implementation of LegacyDifficultyControlPoint).
+                var hSamplePoint = h.SampleControlPoint;
+
+                if (!hSamplePoint.IsRedundant(lastRelevantSamplePoint))
+                {
+                    legacyControlPoints.Add(hSamplePoint.Time, hSamplePoint);
+                    lastRelevantSamplePoint = hSamplePoint;
+                }
             }
 
-            foreach (var group in beatmap.ControlPointInfo.Groups)
+            // handle scroll speed, which is stored as "slider velocity" in legacy formats.
+            // note that this is only relevant for mania beatmaps.
+            if (!isOsuRuleset)
+            {
+                foreach (var point in legacyControlPoints.EffectPoints)
+                    legacyControlPoints.Add(point.Time, new DifficultyControlPoint { SliderVelocity = point.ScrollSpeed });
+            }
+
+            foreach (var group in legacyControlPoints.Groups)
             {
                 var groupTimingPoint = group.ControlPoints.OfType<TimingControlPoint>().FirstOrDefault();
 
@@ -220,7 +225,7 @@ namespace osu.Game.Beatmaps.Formats
                 }
 
                 // Output any remaining effects as secondary non-timing control point.
-                var difficultyPoint = ((LegacyControlPointInfo)beatmap.ControlPointInfo).DifficultyPointAt(group.Time);
+                var difficultyPoint = legacyControlPoints.DifficultyPointAt(group.Time);
                 writer.Write(FormattableString.Invariant($"{group.Time},"));
                 writer.Write(FormattableString.Invariant($"{-100 / difficultyPoint.SliderVelocity},"));
                 outputControlPointAt(group.Time, false);
@@ -228,8 +233,8 @@ namespace osu.Game.Beatmaps.Formats
 
             void outputControlPointAt(double time, bool isTimingPoint)
             {
-                var samplePoint = ((LegacyControlPointInfo)beatmap.ControlPointInfo).SamplePointAt(time);
-                var effectPoint = beatmap.ControlPointInfo.EffectPointAt(time);
+                var samplePoint = legacyControlPoints.SamplePointAt(time);
+                var effectPoint = legacyControlPoints.EffectPointAt(time);
 
                 // Apply the control point to a hit sample to uncover legacy properties (e.g. suffix)
                 HitSampleInfo tempHitSample = samplePoint.ApplyTo(new ConvertHitObjectParser.LegacyHitSampleInfo(string.Empty));
@@ -241,7 +246,7 @@ namespace osu.Game.Beatmaps.Formats
                 if (effectPoint.OmitFirstBarLine)
                     effectFlags |= LegacyEffectFlags.OmitFirstBarLine;
 
-                writer.Write(FormattableString.Invariant($"{(int)beatmap.ControlPointInfo.TimingPointAt(time).TimeSignature},"));
+                writer.Write(FormattableString.Invariant($"{(int)legacyControlPoints.TimingPointAt(time).TimeSignature},"));
                 writer.Write(FormattableString.Invariant($"{(int)toLegacySampleBank(tempHitSample.Bank)},"));
                 writer.Write(FormattableString.Invariant($"{toLegacyCustomSampleBank(tempHitSample)},"));
                 writer.Write(FormattableString.Invariant($"{tempHitSample.Volume},"));
diff --git a/osu.Game/Rulesets/UI/Scrolling/DrawableScrollingRuleset.cs b/osu.Game/Rulesets/UI/Scrolling/DrawableScrollingRuleset.cs
index f0a0dd1367..c7b54891e7 100644
--- a/osu.Game/Rulesets/UI/Scrolling/DrawableScrollingRuleset.cs
+++ b/osu.Game/Rulesets/UI/Scrolling/DrawableScrollingRuleset.cs
@@ -148,10 +148,16 @@ namespace osu.Game.Rulesets.UI.Scrolling
             // Generate the timing points, making non-timing changes use the previous timing change and vice-versa
             var timingChanges = allPoints.Select(c =>
             {
-                if (c is TimingControlPoint timingPoint)
-                    lastTimingPoint = timingPoint;
-                else if (c is EffectControlPoint difficultyPoint)
-                    lastEffectPoint = difficultyPoint;
+                switch (c)
+                {
+                    case TimingControlPoint timingPoint:
+                        lastTimingPoint = timingPoint;
+                        break;
+
+                    case EffectControlPoint difficultyPoint:
+                        lastEffectPoint = difficultyPoint;
+                        break;
+                }
 
                 return new MultiplierControlPoint(c.Time)
                 {
diff --git a/osu.Game/Screens/Edit/Timing/EffectSection.cs b/osu.Game/Screens/Edit/Timing/EffectSection.cs
index 6d23b52c05..c8944d0357 100644
--- a/osu.Game/Screens/Edit/Timing/EffectSection.cs
+++ b/osu.Game/Screens/Edit/Timing/EffectSection.cs
@@ -3,6 +3,7 @@
 
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
+using osu.Framework.Graphics;
 using osu.Game.Beatmaps.ControlPoints;
 using osu.Game.Graphics.UserInterfaceV2;
 
@@ -13,13 +14,20 @@ namespace osu.Game.Screens.Edit.Timing
         private LabelledSwitchButton kiai;
         private LabelledSwitchButton omitBarLine;
 
+        private SliderWithTextBoxInput<double> scrollSpeedSlider;
+
         [BackgroundDependencyLoader]
         private void load()
         {
-            Flow.AddRange(new[]
+            Flow.AddRange(new Drawable[]
             {
                 kiai = new LabelledSwitchButton { Label = "Kiai Time" },
                 omitBarLine = new LabelledSwitchButton { Label = "Skip Bar Line" },
+                scrollSpeedSlider = new SliderWithTextBoxInput<double>("Scroll Speed")
+                {
+                    Current = new EffectControlPoint().ScrollSpeedBindable,
+                    KeyboardStep = 0.1f
+                }
             });
         }
 
@@ -32,6 +40,9 @@ namespace osu.Game.Screens.Edit.Timing
 
                 omitBarLine.Current = point.NewValue.OmitFirstBarLineBindable;
                 omitBarLine.Current.BindValueChanged(_ => ChangeHandler?.SaveState());
+
+                scrollSpeedSlider.Current = point.NewValue.ScrollSpeedBindable;
+                scrollSpeedSlider.Current.BindValueChanged(_ => ChangeHandler?.SaveState());
             }
         }
 
@@ -42,7 +53,8 @@ namespace osu.Game.Screens.Edit.Timing
             return new EffectControlPoint
             {
                 KiaiMode = reference.KiaiMode,
-                OmitFirstBarLine = reference.OmitFirstBarLine
+                OmitFirstBarLine = reference.OmitFirstBarLine,
+                ScrollSpeed = reference.ScrollSpeed,
             };
         }
     }
diff --git a/osu.Game/Screens/Edit/Timing/RowAttributes/EffectRowAttribute.cs b/osu.Game/Screens/Edit/Timing/RowAttributes/EffectRowAttribute.cs
index 812407d6da..4a01b2d861 100644
--- a/osu.Game/Screens/Edit/Timing/RowAttributes/EffectRowAttribute.cs
+++ b/osu.Game/Screens/Edit/Timing/RowAttributes/EffectRowAttribute.cs
@@ -12,6 +12,8 @@ namespace osu.Game.Screens.Edit.Timing.RowAttributes
     {
         private readonly Bindable<bool> kiaiMode;
         private readonly Bindable<bool> omitBarLine;
+        private readonly BindableNumber<double> scrollSpeed;
+
         private AttributeText kiaiModeBubble;
         private AttributeText omitBarLineBubble;
 
@@ -20,6 +22,7 @@ namespace osu.Game.Screens.Edit.Timing.RowAttributes
         {
             kiaiMode = effect.KiaiModeBindable.GetBoundCopy();
             omitBarLine = effect.OmitFirstBarLineBindable.GetBoundCopy();
+            scrollSpeed = effect.ScrollSpeedBindable.GetBoundCopy();
         }
 
         [BackgroundDependencyLoader]
@@ -27,6 +30,10 @@ namespace osu.Game.Screens.Edit.Timing.RowAttributes
         {
             Content.AddRange(new Drawable[]
             {
+                new AttributeProgressBar(Point)
+                {
+                    Current = scrollSpeed,
+                },
                 kiaiModeBubble = new AttributeText(Point) { Text = "kiai" },
                 omitBarLineBubble = new AttributeText(Point) { Text = "no barline" },
             });

From 693ecdf62a8843ab2fe42eb71a3924712e5eb316 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 6 Sep 2021 21:30:15 +0900
Subject: [PATCH 0053/5547] Refactor some incorrect/outdated terminology

---
 osu.Game.Rulesets.Taiko/Mods/TaikoModHidden.cs         |  3 +--
 osu.Game/Beatmaps/BeatmapDifficulty.cs                 |  2 +-
 .../Beatmaps/ControlPoints/DifficultyControlPoint.cs   |  2 +-
 osu.Game/Rulesets/Edit/IPositionSnapProvider.cs        | 10 +++++-----
 4 files changed, 8 insertions(+), 9 deletions(-)

diff --git a/osu.Game.Rulesets.Taiko/Mods/TaikoModHidden.cs b/osu.Game.Rulesets.Taiko/Mods/TaikoModHidden.cs
index 5866538bf7..ba6a2f2d66 100644
--- a/osu.Game.Rulesets.Taiko/Mods/TaikoModHidden.cs
+++ b/osu.Game.Rulesets.Taiko/Mods/TaikoModHidden.cs
@@ -52,9 +52,8 @@ namespace osu.Game.Rulesets.Taiko.Mods
         protected double MultiplierAt(HitObject obj)
         {
             double beatLength = controlPointInfo.TimingPointAt(obj.StartTime).BeatLength;
-            double speedMultiplier = obj.DifficultyControlPoint.SliderVelocity;
 
-            return speedMultiplier * TimingControlPoint.DEFAULT_BEAT_LENGTH / beatLength;
+            return obj.DifficultyControlPoint.SliderVelocity * TimingControlPoint.DEFAULT_BEAT_LENGTH / beatLength;
         }
 
         public override void ApplyToBeatmap(IBeatmap beatmap)
diff --git a/osu.Game/Beatmaps/BeatmapDifficulty.cs b/osu.Game/Beatmaps/BeatmapDifficulty.cs
index df78af7527..1844b193f2 100644
--- a/osu.Game/Beatmaps/BeatmapDifficulty.cs
+++ b/osu.Game/Beatmaps/BeatmapDifficulty.cs
@@ -26,7 +26,7 @@ namespace osu.Game.Beatmaps
             set => approachRate = value;
         }
 
-        public double SliderMultiplier { get; set; } = 1; // AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA this needs to be renamed or removed or something.
+        public double SliderMultiplier { get; set; } = 1;
         public double SliderTickRate { get; set; } = 1;
 
         /// <summary>
diff --git a/osu.Game/Beatmaps/ControlPoints/DifficultyControlPoint.cs b/osu.Game/Beatmaps/ControlPoints/DifficultyControlPoint.cs
index 92a1cc5e90..bf7ed8e6f5 100644
--- a/osu.Game/Beatmaps/ControlPoints/DifficultyControlPoint.cs
+++ b/osu.Game/Beatmaps/ControlPoints/DifficultyControlPoint.cs
@@ -31,7 +31,7 @@ namespace osu.Game.Beatmaps.ControlPoints
         public override Color4 GetRepresentingColour(OsuColour colours) => colours.Lime1;
 
         /// <summary>
-        /// The speed multiplier at this control point.
+        /// The slider velocity at this control point.
         /// </summary>
         public double SliderVelocity
         {
diff --git a/osu.Game/Rulesets/Edit/IPositionSnapProvider.cs b/osu.Game/Rulesets/Edit/IPositionSnapProvider.cs
index 7d7d61e1c1..743a2f41fc 100644
--- a/osu.Game/Rulesets/Edit/IPositionSnapProvider.cs
+++ b/osu.Game/Rulesets/Edit/IPositionSnapProvider.cs
@@ -28,14 +28,14 @@ namespace osu.Game.Rulesets.Edit
         /// <summary>
         /// Retrieves the distance between two points within a timing point that are one beat length apart.
         /// </summary>
-        /// <param name="referenceObject"></param>
+        /// <param name="referenceObject">An object to be used as a reference point for this operation.</param>
         /// <returns>The distance between two points residing in the timing point that are one beat length apart.</returns>
         float GetBeatSnapDistanceAt(HitObject referenceObject);
 
         /// <summary>
         /// Converts a duration to a distance.
         /// </summary>
-        /// <param name="referenceObject"></param>
+        /// <param name="referenceObject">An object to be used as a reference point for this operation.</param>
         /// <param name="duration">The duration to convert.</param>
         /// <returns>A value that represents <paramref name="duration"/> as a distance in the timing point.</returns>
         float DurationToDistance(HitObject referenceObject, double duration);
@@ -43,7 +43,7 @@ namespace osu.Game.Rulesets.Edit
         /// <summary>
         /// Converts a distance to a duration.
         /// </summary>
-        /// <param name="referenceObject"></param>
+        /// <param name="referenceObject">An object to be used as a reference point for this operation.</param>
         /// <param name="distance">The distance to convert.</param>
         /// <returns>A value that represents <paramref name="distance"/> as a duration in the timing point.</returns>
         double DistanceToDuration(HitObject referenceObject, float distance);
@@ -51,7 +51,7 @@ namespace osu.Game.Rulesets.Edit
         /// <summary>
         /// Converts a distance to a snapped duration.
         /// </summary>
-        /// <param name="referenceObject"></param>
+        /// <param name="referenceObject">An object to be used as a reference point for this operation.</param>
         /// <param name="distance">The distance to convert.</param>
         /// <returns>A value that represents <paramref name="distance"/> as a duration snapped to the closest beat of the timing point.</returns>
         double GetSnappedDurationFromDistance(HitObject referenceObject, float distance);
@@ -60,7 +60,7 @@ namespace osu.Game.Rulesets.Edit
         /// Converts an unsnapped distance to a snapped distance.
         /// The returned distance will always be floored (as to never exceed the provided <paramref name="distance"/>.
         /// </summary>
-        /// <param name="referenceObject"></param>
+        /// <param name="referenceObject">An object to be used as a reference point for this operation.</param>
         /// <param name="distance">The distance to convert.</param>
         /// <returns>A value that represents <paramref name="distance"/> snapped to the closest beat of the timing point.</returns>
         float GetSnappedDistanceFromDistance(HitObject referenceObject, float distance);

From 8ffcea2e51a26aca9f86bdd89d96e49d75c6f5b3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 6 Sep 2021 21:30:57 +0900
Subject: [PATCH 0054/5547] Remove unnecessary null checks

---
 osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs b/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs
index eaa15f28ad..ff9f585dbf 100644
--- a/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs
+++ b/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs
@@ -280,8 +280,8 @@ namespace osu.Game.Tests.Beatmaps.Formats
             {
                 var controlPoints = (LegacyControlPointInfo)decoder.Decode(stream).ControlPointInfo;
 
-                Assert.That(controlPoints?.DifficultyPointAt(0).SliderVelocity, Is.EqualTo(0.5).Within(0.1));
-                Assert.That(controlPoints?.DifficultyPointAt(2000).SliderVelocity, Is.EqualTo(1).Within(0.1));
+                Assert.That(controlPoints.DifficultyPointAt(0).SliderVelocity, Is.EqualTo(0.5).Within(0.1));
+                Assert.That(controlPoints.DifficultyPointAt(2000).SliderVelocity, Is.EqualTo(1).Within(0.1));
             }
         }
 

From ce197b632234e8b493537f33828b893708bd2c4f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 6 Sep 2021 21:40:30 +0900
Subject: [PATCH 0055/5547] Fix missing attribute text (and give slightly more
 space for "10.00x" cases

---
 .../Edit/Timing/RowAttributes/DifficultyRowAttribute.cs      | 2 +-
 .../Screens/Edit/Timing/RowAttributes/EffectRowAttribute.cs  | 5 +++++
 2 files changed, 6 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Edit/Timing/RowAttributes/DifficultyRowAttribute.cs b/osu.Game/Screens/Edit/Timing/RowAttributes/DifficultyRowAttribute.cs
index d9e6898379..a8de476d67 100644
--- a/osu.Game/Screens/Edit/Timing/RowAttributes/DifficultyRowAttribute.cs
+++ b/osu.Game/Screens/Edit/Timing/RowAttributes/DifficultyRowAttribute.cs
@@ -32,7 +32,7 @@ namespace osu.Game.Screens.Edit.Timing.RowAttributes
                 },
                 text = new AttributeText(Point)
                 {
-                    Width = 40,
+                    Width = 45,
                 },
             });
 
diff --git a/osu.Game/Screens/Edit/Timing/RowAttributes/EffectRowAttribute.cs b/osu.Game/Screens/Edit/Timing/RowAttributes/EffectRowAttribute.cs
index 4a01b2d861..1b33fd62aa 100644
--- a/osu.Game/Screens/Edit/Timing/RowAttributes/EffectRowAttribute.cs
+++ b/osu.Game/Screens/Edit/Timing/RowAttributes/EffectRowAttribute.cs
@@ -16,6 +16,7 @@ namespace osu.Game.Screens.Edit.Timing.RowAttributes
 
         private AttributeText kiaiModeBubble;
         private AttributeText omitBarLineBubble;
+        private AttributeText text;
 
         public EffectRowAttribute(EffectControlPoint effect)
             : base(effect, "effect")
@@ -34,12 +35,16 @@ namespace osu.Game.Screens.Edit.Timing.RowAttributes
                 {
                     Current = scrollSpeed,
                 },
+                text = new AttributeText(Point) { Width = 45 },
                 kiaiModeBubble = new AttributeText(Point) { Text = "kiai" },
                 omitBarLineBubble = new AttributeText(Point) { Text = "no barline" },
             });
 
             kiaiMode.BindValueChanged(enabled => kiaiModeBubble.FadeTo(enabled.NewValue ? 1 : 0), true);
             omitBarLine.BindValueChanged(enabled => omitBarLineBubble.FadeTo(enabled.NewValue ? 1 : 0), true);
+            scrollSpeed.BindValueChanged(_ => updateText(), true);
         }
+
+        private void updateText() => text.Text = $"{scrollSpeed.Value:n2}x";
     }
 }

From eabca016d4011587120b10602137b7ac4f374243 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 6 Sep 2021 22:04:37 +0900
Subject: [PATCH 0056/5547] Throw rather than ignore on invalid control point
 addition

---
 osu.Game/Beatmaps/ControlPoints/ControlPointInfo.cs | 3 +++
 osu.Game/Beatmaps/Legacy/LegacyControlPointInfo.cs  | 8 +++++---
 2 files changed, 8 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Beatmaps/ControlPoints/ControlPointInfo.cs b/osu.Game/Beatmaps/ControlPoints/ControlPointInfo.cs
index dd88d0b539..9d738ecbfb 100644
--- a/osu.Game/Beatmaps/ControlPoints/ControlPointInfo.cs
+++ b/osu.Game/Beatmaps/ControlPoints/ControlPointInfo.cs
@@ -276,6 +276,9 @@ namespace osu.Game.Beatmaps.ControlPoints
                 case EffectControlPoint typed:
                     effectPoints.Add(typed);
                     break;
+
+                default:
+                    throw new ArgumentException($"A control point of unexpected type {controlPoint.GetType()} was added to this {nameof(ControlPointInfo)}");
             }
         }
 
diff --git a/osu.Game/Beatmaps/Legacy/LegacyControlPointInfo.cs b/osu.Game/Beatmaps/Legacy/LegacyControlPointInfo.cs
index c790ed0366..2b0a2e7a4d 100644
--- a/osu.Game/Beatmaps/Legacy/LegacyControlPointInfo.cs
+++ b/osu.Game/Beatmaps/Legacy/LegacyControlPointInfo.cs
@@ -73,14 +73,16 @@ namespace osu.Game.Beatmaps.Legacy
             {
                 case SampleControlPoint typed:
                     samplePoints.Add(typed);
-                    break;
+                    return;
 
                 case DifficultyControlPoint typed:
                     difficultyPoints.Add(typed);
+                    return;
+
+                default:
+                    base.GroupItemAdded(controlPoint);
                     break;
             }
-
-            base.GroupItemAdded(controlPoint);
         }
 
         protected override void GroupItemRemoved(ControlPoint controlPoint)

From 1952ebece93374e89b6b96cc6708438298c84803 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 6 Sep 2021 22:04:51 +0900
Subject: [PATCH 0057/5547] Update tests to use more correct control point
 definitions

---
 osu.Game.Rulesets.Mania.Tests/TestSceneHoldNoteInput.cs  | 2 +-
 osu.Game.Rulesets.Mania.Tests/TestSceneOutOfOrderHits.cs | 2 +-
 osu.Game.Rulesets.Osu.Tests/TestSceneSlider.cs           | 9 +++++++--
 .../Beatmaps/Formats/LegacyBeatmapEncoderTest.cs         | 2 +-
 .../TestSceneHitObjectComposerDistanceSnapping.cs        | 2 --
 osu.Game.Tests/NonVisual/ControlPointInfoTest.cs         | 2 +-
 6 files changed, 11 insertions(+), 8 deletions(-)

diff --git a/osu.Game.Rulesets.Mania.Tests/TestSceneHoldNoteInput.cs b/osu.Game.Rulesets.Mania.Tests/TestSceneHoldNoteInput.cs
index 3e393d5259..4387bc6b3b 100644
--- a/osu.Game.Rulesets.Mania.Tests/TestSceneHoldNoteInput.cs
+++ b/osu.Game.Rulesets.Mania.Tests/TestSceneHoldNoteInput.cs
@@ -388,7 +388,7 @@ namespace osu.Game.Rulesets.Mania.Tests
                     },
                 };
 
-                beatmap.ControlPointInfo.Add(0, new DifficultyControlPoint { SliderVelocity = 0.1f });
+                beatmap.ControlPointInfo.Add(0, new EffectControlPoint { ScrollSpeed = 0.1f });
             }
 
             AddStep("load player", () =>
diff --git a/osu.Game.Rulesets.Mania.Tests/TestSceneOutOfOrderHits.cs b/osu.Game.Rulesets.Mania.Tests/TestSceneOutOfOrderHits.cs
index fe790b49b0..89e13acad6 100644
--- a/osu.Game.Rulesets.Mania.Tests/TestSceneOutOfOrderHits.cs
+++ b/osu.Game.Rulesets.Mania.Tests/TestSceneOutOfOrderHits.cs
@@ -148,7 +148,7 @@ namespace osu.Game.Rulesets.Mania.Tests
                     },
                 });
 
-                Beatmap.Value.Beatmap.ControlPointInfo.Add(0, new DifficultyControlPoint { SliderVelocity = 0.1f });
+                Beatmap.Value.Beatmap.ControlPointInfo.Add(0, new EffectControlPoint { ScrollSpeed = 0.1f });
 
                 var p = new ScoreAccessibleReplayPlayer(new Score { Replay = new Replay { Frames = frames } });
 
diff --git a/osu.Game.Rulesets.Osu.Tests/TestSceneSlider.cs b/osu.Game.Rulesets.Osu.Tests/TestSceneSlider.cs
index 1b7a859ccb..03b4254eed 100644
--- a/osu.Game.Rulesets.Osu.Tests/TestSceneSlider.cs
+++ b/osu.Game.Rulesets.Osu.Tests/TestSceneSlider.cs
@@ -13,6 +13,7 @@ using osuTK.Graphics;
 using osu.Game.Rulesets.Mods;
 using System.Linq;
 using NUnit.Framework;
+using osu.Game.Beatmaps.Legacy;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Rulesets.Judgements;
@@ -328,10 +329,14 @@ namespace osu.Game.Rulesets.Osu.Tests
 
         private Drawable createDrawable(Slider slider, float circleSize, double speedMultiplier)
         {
-            var cpi = new ControlPointInfo();
+            var cpi = new LegacyControlPointInfo();
             cpi.Add(0, new DifficultyControlPoint { SliderVelocity = speedMultiplier });
 
-            slider.ApplyDefaults(cpi, new BeatmapDifficulty { CircleSize = circleSize, SliderTickRate = 3 });
+            slider.ApplyDefaults(cpi, new BeatmapDifficulty
+            {
+                CircleSize = circleSize,
+                SliderTickRate = 3
+            });
 
             var drawable = CreateDrawableSlider(slider);
 
diff --git a/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapEncoderTest.cs b/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapEncoderTest.cs
index 896aa53f82..60393a22a5 100644
--- a/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapEncoderTest.cs
+++ b/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapEncoderTest.cs
@@ -97,7 +97,7 @@ namespace osu.Game.Tests.Beatmaps.Formats
                     // completely ignore "legacy" types, which have been moved to HitObjects.
                     // even though these would mostly be ignored by the Add call, they will still be available in groups,
                     // which isn't what we want to be testing here.
-                    if (point is SampleControlPoint)
+                    if (point is SampleControlPoint || point is DifficultyControlPoint)
                         continue;
 
                     newControlPoints.Add(point.Time, point.DeepClone());
diff --git a/osu.Game.Tests/Editing/TestSceneHitObjectComposerDistanceSnapping.cs b/osu.Game.Tests/Editing/TestSceneHitObjectComposerDistanceSnapping.cs
index cef4f7b8b4..bee5d86654 100644
--- a/osu.Game.Tests/Editing/TestSceneHitObjectComposerDistanceSnapping.cs
+++ b/osu.Game.Tests/Editing/TestSceneHitObjectComposerDistanceSnapping.cs
@@ -56,8 +56,6 @@ namespace osu.Game.Tests.Editing
 
             composer.EditorBeatmap.BeatmapInfo.BaseDifficulty.SliderMultiplier = 1;
             composer.EditorBeatmap.ControlPointInfo.Clear();
-
-            composer.EditorBeatmap.ControlPointInfo.Add(0, new DifficultyControlPoint { SliderVelocity = 1 });
             composer.EditorBeatmap.ControlPointInfo.Add(0, new TimingControlPoint { BeatLength = 1000 });
         });
 
diff --git a/osu.Game.Tests/NonVisual/ControlPointInfoTest.cs b/osu.Game.Tests/NonVisual/ControlPointInfoTest.cs
index 71f3b2b105..cfda4f6422 100644
--- a/osu.Game.Tests/NonVisual/ControlPointInfoTest.cs
+++ b/osu.Game.Tests/NonVisual/ControlPointInfoTest.cs
@@ -208,7 +208,7 @@ namespace osu.Game.Tests.NonVisual
         [Test]
         public void TestOrdering()
         {
-            var cpi = new ControlPointInfo();
+            var cpi = new LegacyControlPointInfo();
 
             cpi.Add(0, new TimingControlPoint());
             cpi.Add(1000, new TimingControlPoint { BeatLength = 500 });

From b16e0cda3d45aada00213fe10efa2e3c7d9d06a4 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 9 Sep 2021 23:45:32 +0900
Subject: [PATCH 0058/5547] Move control point modification to `ConvertBeatmap`
 method

---
 .../Beatmaps/ManiaBeatmapConverter.cs         | 50 +++++++++++--------
 1 file changed, 30 insertions(+), 20 deletions(-)

diff --git a/osu.Game.Rulesets.Mania/Beatmaps/ManiaBeatmapConverter.cs b/osu.Game.Rulesets.Mania/Beatmaps/ManiaBeatmapConverter.cs
index 0ff48122e2..65dc65b28a 100644
--- a/osu.Game.Rulesets.Mania/Beatmaps/ManiaBeatmapConverter.cs
+++ b/osu.Game.Rulesets.Mania/Beatmaps/ManiaBeatmapConverter.cs
@@ -49,26 +49,6 @@ namespace osu.Game.Rulesets.Mania.Beatmaps
 
             if (IsForCurrentRuleset)
             {
-                if (beatmap.ControlPointInfo is LegacyControlPointInfo legacyControlPoints)
-                {
-                    // convert all slider velocity adjustments to scroll speed adjustments.
-                    foreach (var controlPoint in legacyControlPoints.DifficultyPoints.ToArray())
-                    {
-                        double time = controlPoint.Time;
-
-                        var reference = legacyControlPoints.EffectPointAt(time);
-
-                        var scrollControlPoint = new EffectControlPoint();
-                        scrollControlPoint.CopyFrom(reference);
-                        scrollControlPoint.ScrollSpeed = controlPoint.SliderVelocity;
-
-                        legacyControlPoints.Add(time, scrollControlPoint);
-
-                        // remove the DifficultyControlPoint as we don't need them any more.
-                        legacyControlPoints.GroupAt(time).Remove(controlPoint);
-                    }
-                }
-
                 TargetColumns = GetColumnCountForNonConvert(beatmap.BeatmapInfo);
 
                 if (TargetColumns > ManiaRuleset.MAX_STAGE_KEYS)
@@ -105,6 +85,36 @@ namespace osu.Game.Rulesets.Mania.Beatmaps
         {
             BeatmapDifficulty difficulty = original.BeatmapInfo.BaseDifficulty;
 
+            if (IsForCurrentRuleset && original.ControlPointInfo is LegacyControlPointInfo originalLegacyControlPoints)
+            {
+                // original is cloned so we're safe to replace control point storage at this point.
+                original.ControlPointInfo = new LegacyControlPointInfo();
+
+                // convert all slider velocity adjustments to scroll speed adjustments.
+                foreach (var controlPoint in originalLegacyControlPoints.AllControlPoints)
+                {
+                    double time = controlPoint.Time;
+
+                    switch (controlPoint)
+                    {
+                        default:
+                            original.ControlPointInfo.Add(time, controlPoint);
+                            break;
+
+                        case DifficultyControlPoint difficultyPoint:
+                            var reference = originalLegacyControlPoints.EffectPointAt(time);
+
+                            var scrollControlPoint = new EffectControlPoint();
+
+                            scrollControlPoint.CopyFrom(reference);
+                            scrollControlPoint.ScrollSpeed = difficultyPoint.SliderVelocity;
+
+                            original.ControlPointInfo.Add(time, scrollControlPoint);
+                            break;
+                    }
+                }
+            }
+
             int seed = (int)MathF.Round(difficulty.DrainRate + difficulty.CircleSize) * 20 + (int)(difficulty.OverallDifficulty * 41.2) + (int)MathF.Round(difficulty.ApproachRate);
             Random = new FastRandom(seed);
 

From 1c3c32b724ee7507875f6c3c513fac511fb6bbfd Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 9 Sep 2021 23:54:30 +0900
Subject: [PATCH 0059/5547] Add test ensuring converter doesn't modify original
 beatmap

---
 .../Resources/Testing/Beatmaps/mania-samples.osu           | 1 +
 osu.Game/Tests/Beatmaps/BeatmapConversionTest.cs           | 7 +++++++
 2 files changed, 8 insertions(+)

diff --git a/osu.Game.Rulesets.Mania/Resources/Testing/Beatmaps/mania-samples.osu b/osu.Game.Rulesets.Mania/Resources/Testing/Beatmaps/mania-samples.osu
index 7c75b45e5f..ca9e5b0b85 100644
--- a/osu.Game.Rulesets.Mania/Resources/Testing/Beatmaps/mania-samples.osu
+++ b/osu.Game.Rulesets.Mania/Resources/Testing/Beatmaps/mania-samples.osu
@@ -13,6 +13,7 @@ SliderTickRate:1
 
 [TimingPoints]
 0,500,4,1,0,100,1,0
+10000,-150,4,1,0,100,1,0
 
 [HitObjects]
 51,192,500,128,0,1500:1:0:0:0:
diff --git a/osu.Game/Tests/Beatmaps/BeatmapConversionTest.cs b/osu.Game/Tests/Beatmaps/BeatmapConversionTest.cs
index 64f1ee4a7a..6d63525011 100644
--- a/osu.Game/Tests/Beatmaps/BeatmapConversionTest.cs
+++ b/osu.Game/Tests/Beatmaps/BeatmapConversionTest.cs
@@ -14,6 +14,7 @@ using osu.Framework.Graphics.Textures;
 using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.Formats;
 using osu.Game.IO;
+using osu.Game.IO.Serialization;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Objects;
@@ -109,6 +110,8 @@ namespace osu.Game.Tests.Beatmaps
         {
             var beatmap = GetBeatmap(name);
 
+            string beforeConversion = beatmap.Serialize();
+
             var converterResult = new Dictionary<HitObject, IEnumerable<HitObject>>();
 
             var working = new ConversionWorkingBeatmap(beatmap)
@@ -122,6 +125,10 @@ namespace osu.Game.Tests.Beatmaps
 
             working.GetPlayableBeatmap(CreateRuleset().RulesetInfo, mods);
 
+            string afterConversion = beatmap.Serialize();
+
+            Assert.AreEqual(beforeConversion, afterConversion, "Conversion altered original beatmap");
+
             return new ConvertResult
             {
                 Mappings = converterResult.Select(r =>

From 34f875187c8eb00b0829fb75d22b8a9483fc3dc3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 10 Sep 2021 14:35:53 +0900
Subject: [PATCH 0060/5547] Copy time between `ControlPoint`s

---
 osu.Game/Beatmaps/ControlPoints/ControlPoint.cs | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Beatmaps/ControlPoints/ControlPoint.cs b/osu.Game/Beatmaps/ControlPoints/ControlPoint.cs
index 8203f2e968..4079a0cd5f 100644
--- a/osu.Game/Beatmaps/ControlPoints/ControlPoint.cs
+++ b/osu.Game/Beatmaps/ControlPoints/ControlPoint.cs
@@ -15,11 +15,9 @@ namespace osu.Game.Beatmaps.ControlPoints
         /// The time at which the control point takes effect.
         /// </summary>
         [JsonIgnore]
-        public double Time => controlPointGroup?.Time ?? 0;
+        public double Time { get; set; }
 
-        private ControlPointGroup controlPointGroup;
-
-        public void AttachGroup(ControlPointGroup pointGroup) => controlPointGroup = pointGroup;
+        public void AttachGroup(ControlPointGroup pointGroup) => Time = pointGroup.Time;
 
         public int CompareTo(ControlPoint other) => Time.CompareTo(other.Time);
 
@@ -46,6 +44,7 @@ namespace osu.Game.Beatmaps.ControlPoints
 
         public virtual void CopyFrom(ControlPoint other)
         {
+            Time = other.Time;
         }
     }
 }

From 714f55b6bc524432a83ee3d197ae4b969934f63e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 10 Sep 2021 14:36:32 +0900
Subject: [PATCH 0061/5547] Clone control points when copying to `HitObject`s

---
 osu.Game.Rulesets.Osu/Objects/Slider.cs | 1 -
 osu.Game/Rulesets/Objects/HitObject.cs  | 4 ++--
 2 files changed, 2 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Objects/Slider.cs b/osu.Game.Rulesets.Osu/Objects/Slider.cs
index 53ecb59c85..23b4f812c8 100644
--- a/osu.Game.Rulesets.Osu/Objects/Slider.cs
+++ b/osu.Game.Rulesets.Osu/Objects/Slider.cs
@@ -174,7 +174,6 @@ namespace osu.Game.Rulesets.Osu.Objects
                             StartTime = e.Time,
                             Position = Position,
                             StackHeight = StackHeight,
-                            SampleControlPoint = SampleControlPoint,
                         });
                         break;
 
diff --git a/osu.Game/Rulesets/Objects/HitObject.cs b/osu.Game/Rulesets/Objects/HitObject.cs
index 49bcf7a10c..42a326da80 100644
--- a/osu.Game/Rulesets/Objects/HitObject.cs
+++ b/osu.Game/Rulesets/Objects/HitObject.cs
@@ -108,13 +108,13 @@ namespace osu.Game.Rulesets.Objects
             var legacyInfo = controlPointInfo as LegacyControlPointInfo;
 
             if (legacyInfo != null)
-                DifficultyControlPoint = legacyInfo.DifficultyPointAt(StartTime);
+                DifficultyControlPoint = (DifficultyControlPoint)legacyInfo.DifficultyPointAt(StartTime).DeepClone();
 
             ApplyDefaultsToSelf(controlPointInfo, difficulty);
 
             // This is done here after ApplyDefaultsToSelf as we may require custom defaults to be applied to have an accurate end time.
             if (legacyInfo != null)
-                SampleControlPoint = legacyInfo.SamplePointAt(this.GetEndTime() + control_point_leniency);
+                SampleControlPoint = (SampleControlPoint)legacyInfo.SamplePointAt(this.GetEndTime() + control_point_leniency).DeepClone();
 
             nestedHitObjects.Clear();
 

From cd227213e6baf2f002064eb8f9725480bed34b99 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 10 Sep 2021 15:57:11 +0900
Subject: [PATCH 0062/5547] Ensure time of `HitObject` related `ControlPoint`s
 are kept in sync with the hitobject

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

diff --git a/osu.Game/Rulesets/Objects/HitObject.cs b/osu.Game/Rulesets/Objects/HitObject.cs
index 42a326da80..a7a3b5dc72 100644
--- a/osu.Game/Rulesets/Objects/HitObject.cs
+++ b/osu.Game/Rulesets/Objects/HitObject.cs
@@ -94,6 +94,12 @@ namespace osu.Game.Rulesets.Objects
 
                 foreach (var nested in NestedHitObjects)
                     nested.StartTime += offset;
+
+                if (DifficultyControlPoint != DifficultyControlPoint.DEFAULT)
+                    DifficultyControlPoint.Time = time.NewValue;
+                // traditionally this used EndTime, but at the point changes are being made in the editor this should no longer be considered relevant.
+                if (SampleControlPoint != SampleControlPoint.DEFAULT)
+                    SampleControlPoint.Time = time.NewValue;
             };
         }
 
@@ -108,13 +114,19 @@ namespace osu.Game.Rulesets.Objects
             var legacyInfo = controlPointInfo as LegacyControlPointInfo;
 
             if (legacyInfo != null)
+            {
                 DifficultyControlPoint = (DifficultyControlPoint)legacyInfo.DifficultyPointAt(StartTime).DeepClone();
+                DifficultyControlPoint.Time = StartTime;
+            }
 
             ApplyDefaultsToSelf(controlPointInfo, difficulty);
 
             // This is done here after ApplyDefaultsToSelf as we may require custom defaults to be applied to have an accurate end time.
             if (legacyInfo != null)
+            {
                 SampleControlPoint = (SampleControlPoint)legacyInfo.SamplePointAt(this.GetEndTime() + control_point_leniency).DeepClone();
+                SampleControlPoint.Time = this.GetEndTime() + control_point_leniency;
+            }
 
             nestedHitObjects.Clear();
 

From 943e0d49f7dc100eb20ace83966c6ac447a96968 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 10 Sep 2021 16:51:10 +0900
Subject: [PATCH 0063/5547] Handle control point flattening of nested hit
 objects

---
 .../Beatmaps/Formats/LegacyBeatmapEncoder.cs  | 53 ++++++++++++-------
 1 file changed, 35 insertions(+), 18 deletions(-)

diff --git a/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs b/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs
index 7672c4039a..ebb326ccc8 100644
--- a/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs
+++ b/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs
@@ -184,24 +184,8 @@ namespace osu.Game.Beatmaps.Formats
             // iterate over hitobjects and pull out all required sample and difficulty changes
             foreach (var h in beatmap.HitObjects)
             {
-                if (isOsuRuleset)
-                {
-                    var hDifficultyPoint = h.DifficultyControlPoint;
-
-                    if (!hDifficultyPoint.IsRedundant(lastRelevantDifficultyPoint))
-                    {
-                        legacyControlPoints.Add(hDifficultyPoint.Time, hDifficultyPoint);
-                        lastRelevantDifficultyPoint = hDifficultyPoint;
-                    }
-                }
-
-                var hSamplePoint = h.SampleControlPoint;
-
-                if (!hSamplePoint.IsRedundant(lastRelevantSamplePoint))
-                {
-                    legacyControlPoints.Add(hSamplePoint.Time, hSamplePoint);
-                    lastRelevantSamplePoint = hSamplePoint;
-                }
+                extractDifficultyControlPoints(h);
+                extractSampleControlPoints(h);
             }
 
             // handle scroll speed, which is stored as "slider velocity" in legacy formats.
@@ -254,6 +238,39 @@ namespace osu.Game.Beatmaps.Formats
                 writer.Write(FormattableString.Invariant($"{(int)effectFlags}"));
                 writer.WriteLine();
             }
+
+            void extractDifficultyControlPoints(HitObject hitObject)
+            {
+                if (!isOsuRuleset)
+                    return;
+
+                var hDifficultyPoint = hitObject.DifficultyControlPoint;
+
+                if (!hDifficultyPoint.IsRedundant(lastRelevantDifficultyPoint))
+                {
+                    legacyControlPoints.Add(hDifficultyPoint.Time, hDifficultyPoint);
+                    lastRelevantDifficultyPoint = hDifficultyPoint;
+                }
+
+                foreach (var nested in hitObject.NestedHitObjects)
+                    extractDifficultyControlPoints(nested);
+            }
+
+            void extractSampleControlPoints(HitObject hitObject)
+            {
+                // process nested objects first as these use EndTime for legacy storage.
+
+                foreach (var nested in hitObject.NestedHitObjects)
+                    extractSampleControlPoints(nested);
+
+                var hSamplePoint = hitObject.SampleControlPoint;
+
+                if (!hSamplePoint.IsRedundant(lastRelevantSamplePoint))
+                {
+                    legacyControlPoints.Add(hSamplePoint.Time, hSamplePoint);
+                    lastRelevantSamplePoint = hSamplePoint;
+                }
+            }
         }
 
         private void handleColours(TextWriter writer)

From 5f61936700a90fe2de71f4cf0914aa98d8ac2ba5 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 10 Sep 2021 16:51:24 +0900
Subject: [PATCH 0064/5547] Update legacy encoder tests to only compare pieces
 we care about

---
 .../Formats/LegacyBeatmapEncoderTest.cs       | 30 +++++++++++--------
 1 file changed, 18 insertions(+), 12 deletions(-)

diff --git a/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapEncoderTest.cs b/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapEncoderTest.cs
index 60393a22a5..d12da1a22f 100644
--- a/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapEncoderTest.cs
+++ b/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapEncoderTest.cs
@@ -46,8 +46,7 @@ namespace osu.Game.Tests.Beatmaps.Formats
             sort(decoded.beatmap);
             sort(decodedAfterEncode.beatmap);
 
-            Assert.That(decodedAfterEncode.beatmap.Serialize(), Is.EqualTo(decoded.beatmap.Serialize()));
-            Assert.IsTrue(areComboColoursEqual(decodedAfterEncode.beatmapSkin.Configuration, decoded.beatmapSkin.Configuration));
+            compareBeatmaps(decoded, decodedAfterEncode);
         }
 
         [TestCaseSource(nameof(allBeatmaps))]
@@ -62,8 +61,7 @@ namespace osu.Game.Tests.Beatmaps.Formats
             sort(decoded.beatmap);
             sort(decodedAfterEncode.beatmap);
 
-            Assert.That(decodedAfterEncode.beatmap.Serialize(), Is.EqualTo(decoded.beatmap.Serialize()));
-            Assert.IsTrue(areComboColoursEqual(decodedAfterEncode.beatmapSkin.Configuration, decoded.beatmapSkin.Configuration));
+            compareBeatmaps(decoded, decodedAfterEncode);
         }
 
         [TestCaseSource(nameof(allBeatmaps))]
@@ -77,12 +75,7 @@ namespace osu.Game.Tests.Beatmaps.Formats
 
             var decodedAfterEncode = decodeFromLegacy(encodeToLegacy(decoded), name);
 
-            // in this process, we may lose some detail in the control points section.
-            // let's focus on only the hitobjects.
-            var originalHitObjects = decoded.beatmap.HitObjects.Serialize();
-            var newHitObjects = decodedAfterEncode.beatmap.HitObjects.Serialize();
-
-            Assert.That(newHitObjects, Is.EqualTo(originalHitObjects));
+            compareBeatmaps(decoded, decodedAfterEncode);
 
             ControlPointInfo removeLegacyControlPointTypes(ControlPointInfo controlPointInfo)
             {
@@ -107,6 +100,19 @@ namespace osu.Game.Tests.Beatmaps.Formats
             }
         }
 
+        private void compareBeatmaps((IBeatmap beatmap, TestLegacySkin skin) expected, (IBeatmap beatmap, TestLegacySkin skin) actual)
+        {
+            // Check all control points that are still considered to be at a global level.
+            Assert.That(expected.beatmap.ControlPointInfo.TimingPoints.Serialize(), Is.EqualTo(actual.beatmap.ControlPointInfo.TimingPoints.Serialize()));
+            Assert.That(expected.beatmap.ControlPointInfo.EffectPoints.Serialize(), Is.EqualTo(actual.beatmap.ControlPointInfo.EffectPoints.Serialize()));
+
+            // Check all hitobjects.
+            Assert.That(expected.beatmap.HitObjects.Serialize(), Is.EqualTo(actual.beatmap.HitObjects.Serialize()));
+
+            // Check skin.
+            Assert.IsTrue(areComboColoursEqual(expected.skin.Configuration, actual.skin.Configuration));
+        }
+
         [Test]
         public void TestEncodeMultiSegmentSliderWithFloatingPointError()
         {
@@ -156,7 +162,7 @@ namespace osu.Game.Tests.Beatmaps.Formats
             }
         }
 
-        private (IBeatmap beatmap, TestLegacySkin beatmapSkin) decodeFromLegacy(Stream stream, string name)
+        private (IBeatmap beatmap, TestLegacySkin skin) decodeFromLegacy(Stream stream, string name)
         {
             using (var reader = new LineBufferedReader(stream))
             {
@@ -174,7 +180,7 @@ namespace osu.Game.Tests.Beatmaps.Formats
             }
         }
 
-        private MemoryStream encodeToLegacy((IBeatmap beatmap, ISkin beatmapSkin) fullBeatmap)
+        private MemoryStream encodeToLegacy((IBeatmap beatmap, ISkin skin) fullBeatmap)
         {
             var (beatmap, beatmapSkin) = fullBeatmap;
             var stream = new MemoryStream();

From a7ae3cc03e128d0527049cf70f43b439c094e15a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 14 Sep 2021 16:24:55 +0900
Subject: [PATCH 0065/5547] Change `SampleControlPoint` time to use leniency in
 bindable changed event too

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

diff --git a/osu.Game/Rulesets/Objects/HitObject.cs b/osu.Game/Rulesets/Objects/HitObject.cs
index a7a3b5dc72..c7bf0cad35 100644
--- a/osu.Game/Rulesets/Objects/HitObject.cs
+++ b/osu.Game/Rulesets/Objects/HitObject.cs
@@ -97,9 +97,9 @@ namespace osu.Game.Rulesets.Objects
 
                 if (DifficultyControlPoint != DifficultyControlPoint.DEFAULT)
                     DifficultyControlPoint.Time = time.NewValue;
-                // traditionally this used EndTime, but at the point changes are being made in the editor this should no longer be considered relevant.
+
                 if (SampleControlPoint != SampleControlPoint.DEFAULT)
-                    SampleControlPoint.Time = time.NewValue;
+                    SampleControlPoint.Time = this.GetEndTime() + control_point_leniency;
             };
         }
 

From 6015b5037a4eb49e82c4323537e583e910ecef1e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 10 Sep 2021 13:44:39 +0900
Subject: [PATCH 0066/5547] Display difficulty and sample control points
 associated with hitobjects

---
 .../Timeline/DifficultyPointPiece.cs          |  6 +-
 .../Timeline/HitObjectPointPiece.cs           | 63 +++++++++++++++++
 .../Components/Timeline/SamplePointPiece.cs   | 68 +++----------------
 .../Timeline/TimelineHitObjectBlueprint.cs    | 40 +++++++++++
 4 files changed, 114 insertions(+), 63 deletions(-)
 create mode 100644 osu.Game/Screens/Edit/Compose/Components/Timeline/HitObjectPointPiece.cs

diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/DifficultyPointPiece.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/DifficultyPointPiece.cs
index cd1ef9127e..2a46667806 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/DifficultyPointPiece.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/DifficultyPointPiece.cs
@@ -2,11 +2,12 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using osu.Framework.Bindables;
+using osu.Framework.Graphics.Containers;
 using osu.Game.Beatmaps.ControlPoints;
 
 namespace osu.Game.Screens.Edit.Compose.Components.Timeline
 {
-    public class DifficultyPointPiece : TopPointPiece
+    public class DifficultyPointPiece : HitObjectPointPiece
     {
         private readonly BindableNumber<double> speedMultiplier;
 
@@ -14,13 +15,12 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
             : base(point)
         {
             speedMultiplier = point.SliderVelocityBindable.GetBoundCopy();
-
-            Y = Height;
         }
 
         protected override void LoadComplete()
         {
             base.LoadComplete();
+
             speedMultiplier.BindValueChanged(multiplier => Label.Text = $"{multiplier.NewValue:n2}x", true);
         }
     }
diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/HitObjectPointPiece.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/HitObjectPointPiece.cs
new file mode 100644
index 0000000000..6b62459c97
--- /dev/null
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/HitObjectPointPiece.cs
@@ -0,0 +1,63 @@
+// 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.Game.Beatmaps.ControlPoints;
+using osu.Game.Graphics;
+using osu.Game.Graphics.Sprites;
+using osuTK.Graphics;
+
+namespace osu.Game.Screens.Edit.Compose.Components.Timeline
+{
+    public class HitObjectPointPiece : CircularContainer
+    {
+        private readonly ControlPoint point;
+
+        protected OsuSpriteText Label { get; private set; }
+
+        protected HitObjectPointPiece(ControlPoint point)
+        {
+            this.point = point;
+        }
+
+        [BackgroundDependencyLoader]
+        private void load(OsuColour colours)
+        {
+            AutoSizeAxes = Axes.Both;
+
+            Color4 colour = point.GetRepresentingColour(colours);
+
+            InternalChildren = new Drawable[]
+            {
+                new Container
+                {
+                    AutoSizeAxes = Axes.X,
+                    Height = 16,
+                    Masking = true,
+                    CornerRadius = 8,
+                    Anchor = Anchor.BottomCentre,
+                    Origin = Anchor.BottomCentre,
+                    Children = new Drawable[]
+                    {
+                        new Box
+                        {
+                            Colour = colour,
+                            RelativeSizeAxes = Axes.Both,
+                        },
+                        Label = new OsuSpriteText
+                        {
+                            Anchor = Anchor.Centre,
+                            Origin = Anchor.Centre,
+                            Padding = new MarginPadding(5),
+                            Font = OsuFont.Default.With(size: 12, weight: FontWeight.SemiBold),
+                            Colour = colours.B5,
+                        }
+                    }
+                },
+            };
+        }
+    }
+}
diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/SamplePointPiece.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/SamplePointPiece.cs
index 9461f5e885..40ee7055f1 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/SamplePointPiece.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/SamplePointPiece.cs
@@ -3,29 +3,20 @@
 
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
-using osu.Framework.Graphics;
-using osu.Framework.Graphics.Containers;
-using osu.Framework.Graphics.Shapes;
 using osu.Game.Beatmaps.ControlPoints;
 using osu.Game.Graphics;
-using osu.Game.Graphics.Sprites;
-using osuTK.Graphics;
 
 namespace osu.Game.Screens.Edit.Compose.Components.Timeline
 {
-    public class SamplePointPiece : CompositeDrawable
+    public class SamplePointPiece : HitObjectPointPiece
     {
         private readonly SampleControlPoint samplePoint;
 
         private readonly Bindable<string> bank;
         private readonly BindableNumber<int> volume;
 
-        private OsuSpriteText text;
-        private Container volumeBox;
-
-        private const int max_volume_height = 22;
-
         public SamplePointPiece(SampleControlPoint samplePoint)
+            : base(samplePoint)
         {
             this.samplePoint = samplePoint;
             volume = samplePoint.SampleVolumeBindable.GetBoundCopy();
@@ -35,56 +26,13 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
         [BackgroundDependencyLoader]
         private void load(OsuColour colours)
         {
-            Margin = new MarginPadding { Vertical = 5 };
+            volume.BindValueChanged(volume => updateText());
+            bank.BindValueChanged(bank => updateText(), true);
+        }
 
-            Origin = Anchor.BottomCentre;
-            Anchor = Anchor.BottomCentre;
-
-            AutoSizeAxes = Axes.X;
-            RelativeSizeAxes = Axes.Y;
-
-            Color4 colour = samplePoint.GetRepresentingColour(colours);
-
-            InternalChildren = new Drawable[]
-            {
-                volumeBox = new Circle
-                {
-                    CornerRadius = 5,
-                    Anchor = Anchor.BottomCentre,
-                    Origin = Anchor.BottomCentre,
-                    Y = -20,
-                    Width = 10,
-                    Colour = colour,
-                },
-                new Container
-                {
-                    AutoSizeAxes = Axes.X,
-                    Height = 16,
-                    Masking = true,
-                    CornerRadius = 8,
-                    Anchor = Anchor.BottomCentre,
-                    Origin = Anchor.BottomCentre,
-                    Children = new Drawable[]
-                    {
-                        new Box
-                        {
-                            Colour = colour,
-                            RelativeSizeAxes = Axes.Both,
-                        },
-                        text = new OsuSpriteText
-                        {
-                            Anchor = Anchor.Centre,
-                            Origin = Anchor.Centre,
-                            Padding = new MarginPadding(5),
-                            Font = OsuFont.Default.With(size: 12, weight: FontWeight.SemiBold),
-                            Colour = colours.B5,
-                        }
-                    }
-                },
-            };
-
-            volume.BindValueChanged(volume => volumeBox.Height = max_volume_height * volume.NewValue / 100f, true);
-            bank.BindValueChanged(bank => text.Text = bank.NewValue, true);
+        private void updateText()
+        {
+            Label.Text = $"{bank.Value} {volume.Value}";
         }
     }
 }
diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineHitObjectBlueprint.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineHitObjectBlueprint.cs
index 911c9fea51..35a176a635 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineHitObjectBlueprint.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineHitObjectBlueprint.cs
@@ -14,6 +14,7 @@ using osu.Framework.Graphics.Primitives;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Input.Events;
 using osu.Framework.Utils;
+using osu.Game.Beatmaps.ControlPoints;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Rulesets.Edit;
@@ -179,6 +180,15 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
             colouredComponents.Colour = OsuColour.ForegroundTextColourFor(col);
         }
 
+        private SamplePointPiece sampleOverrideDisplay;
+        private DifficultyPointPiece difficultyOverrideDisplay;
+
+        [Resolved]
+        private EditorBeatmap beatmap { get; set; }
+
+        private DifficultyControlPoint difficultyControlPoint;
+        private SampleControlPoint sampleControlPoint;
+
         protected override void Update()
         {
             base.Update();
@@ -194,6 +204,36 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
                 if (Item is IHasRepeats repeats)
                     updateRepeats(repeats);
             }
+
+            if (difficultyControlPoint != Item.DifficultyControlPoint)
+            {
+                difficultyControlPoint = Item.DifficultyControlPoint;
+                difficultyOverrideDisplay?.Expire();
+
+                if (Item.DifficultyControlPoint != null && Item is IHasDistance)
+                {
+                    AddInternal(difficultyOverrideDisplay = new DifficultyPointPiece(Item.DifficultyControlPoint)
+                    {
+                        Anchor = Anchor.TopLeft,
+                        Origin = Anchor.BottomCentre
+                    });
+                }
+            }
+
+            if (sampleControlPoint != Item.SampleControlPoint)
+            {
+                sampleControlPoint = Item.SampleControlPoint;
+                sampleOverrideDisplay?.Expire();
+
+                if (Item.SampleControlPoint != null)
+                {
+                    AddInternal(sampleOverrideDisplay = new SamplePointPiece(Item.SampleControlPoint)
+                    {
+                        Anchor = Anchor.BottomLeft,
+                        Origin = Anchor.TopCentre
+                    });
+                }
+            }
         }
 
         private void updateRepeats(IHasRepeats repeats)

From b19dc5e41f60030fc89c413a46ffc9b79aa90f81 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 14 Sep 2021 18:26:10 +0900
Subject: [PATCH 0067/5547] Remove all legacy `ControlPoint`s when entering the
 editor

---
 osu.Game/Screens/Edit/EditorBeatmap.cs | 27 ++++++++++++++++++++++++++
 1 file changed, 27 insertions(+)

diff --git a/osu.Game/Screens/Edit/EditorBeatmap.cs b/osu.Game/Screens/Edit/EditorBeatmap.cs
index 3402bf653a..669371c835 100644
--- a/osu.Game/Screens/Edit/EditorBeatmap.cs
+++ b/osu.Game/Screens/Edit/EditorBeatmap.cs
@@ -10,6 +10,7 @@ using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.ControlPoints;
+using osu.Game.Beatmaps.Legacy;
 using osu.Game.Beatmaps.Timing;
 using osu.Game.Rulesets.Edit;
 using osu.Game.Rulesets.Objects;
@@ -69,6 +70,32 @@ namespace osu.Game.Screens.Edit
         public EditorBeatmap(IBeatmap playableBeatmap, ISkin beatmapSkin = null)
         {
             PlayableBeatmap = playableBeatmap;
+
+            // ensure we are not working with legacy control points.
+            // if we leave the legacy points around they will be applied over any local changes on
+            // ApplyDefaults calls. this should eventually be removed once the default logic is moved to the decoder/converter.
+            if (PlayableBeatmap.ControlPointInfo is LegacyControlPointInfo)
+            {
+                var newControlPoints = new ControlPointInfo();
+
+                foreach (var controlPoint in PlayableBeatmap.ControlPointInfo.AllControlPoints)
+                {
+                    switch (controlPoint)
+                    {
+                        case DifficultyControlPoint _:
+                        case SampleControlPoint _:
+                            // skip legacy types.
+                            continue;
+
+                        default:
+                            newControlPoints.Add(controlPoint.Time, controlPoint);
+                            break;
+                    }
+                }
+
+                playableBeatmap.ControlPointInfo = newControlPoints;
+            }
+
             if (beatmapSkin is Skin skin)
                 BeatmapSkin = new EditorBeatmapSkin(skin);
 

From 87cfcf706e56606648c44f58365509d39f4b207f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 14 Sep 2021 18:25:58 +0900
Subject: [PATCH 0068/5547] Add ability to change slider velocity with
 shift-drag

---
 .../Timeline/TimelineHitObjectBlueprint.cs    | 28 ++++++++++++++-----
 1 file changed, 21 insertions(+), 7 deletions(-)

diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineHitObjectBlueprint.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineHitObjectBlueprint.cs
index 35a176a635..9a9e981719 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineHitObjectBlueprint.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineHitObjectBlueprint.cs
@@ -382,15 +382,29 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
                     switch (hitObject)
                     {
                         case IHasRepeats repeatHitObject:
-                            // find the number of repeats which can fit in the requested time.
-                            var lengthOfOneRepeat = repeatHitObject.Duration / (repeatHitObject.RepeatCount + 1);
-                            var proposedCount = Math.Max(0, (int)Math.Round((time - hitObject.StartTime) / lengthOfOneRepeat) - 1);
+                            double proposedDuration = time - hitObject.StartTime;
 
-                            if (proposedCount == repeatHitObject.RepeatCount)
-                                return;
+                            if (e.CurrentState.Keyboard.ShiftPressed)
+                            {
+                                if (hitObject.DifficultyControlPoint == DifficultyControlPoint.DEFAULT)
+                                    hitObject.DifficultyControlPoint = new DifficultyControlPoint();
+
+                                hitObject.DifficultyControlPoint.SliderVelocity *= (repeatHitObject.Duration / proposedDuration);
+                                beatmap.Update(hitObject);
+                            }
+                            else
+                            {
+                                // find the number of repeats which can fit in the requested time.
+                                var lengthOfOneRepeat = repeatHitObject.Duration / (repeatHitObject.RepeatCount + 1);
+                                var proposedCount = Math.Max(0, (int)Math.Round(proposedDuration / lengthOfOneRepeat) - 1);
+
+                                if (proposedCount == repeatHitObject.RepeatCount)
+                                    return;
+
+                                repeatHitObject.RepeatCount = proposedCount;
+                                beatmap.Update(hitObject);
+                            }
 
-                            repeatHitObject.RepeatCount = proposedCount;
-                            beatmap.Update(hitObject);
                             break;
 
                         case IHasDuration endTimeHitObject:

From 2114a4729c20edfd45144fb5631c20ed2029a450 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 10 Sep 2021 18:03:27 +0900
Subject: [PATCH 0069/5547] Set a sane default for new slider blueprints

---
 .../Edit/Blueprints/Sliders/SliderPlacementBlueprint.cs  | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/SliderPlacementBlueprint.cs b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/SliderPlacementBlueprint.cs
index 14853c6ba4..07b6a1bdc2 100644
--- a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/SliderPlacementBlueprint.cs
+++ b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/SliderPlacementBlueprint.cs
@@ -8,12 +8,14 @@ using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Input;
 using osu.Framework.Input.Events;
+using osu.Game.Beatmaps.ControlPoints;
 using osu.Game.Graphics;
 using osu.Game.Rulesets.Edit;
 using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Objects.Types;
 using osu.Game.Rulesets.Osu.Edit.Blueprints.HitCircles.Components;
 using osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders.Components;
+using osu.Game.Screens.Edit;
 using osuTK;
 using osuTK.Input;
 
@@ -67,6 +69,9 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders
             inputManager = GetContainingInputManager();
         }
 
+        [Resolved]
+        private EditorBeatmap editorBeatmap { get; set; }
+
         public override void UpdateTimeAndPosition(SnapResult result)
         {
             base.UpdateTimeAndPosition(result);
@@ -75,6 +80,10 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders
             {
                 case SliderPlacementState.Initial:
                     BeginPlacement();
+
+                    var nearestDifficultyPoint = editorBeatmap.HitObjects.LastOrDefault(h => h.GetEndTime() < HitObject.StartTime)?.DifficultyControlPoint?.DeepClone() as DifficultyControlPoint;
+
+                    HitObject.DifficultyControlPoint = nearestDifficultyPoint ?? new DifficultyControlPoint();
                     HitObject.Position = ToLocalSpace(result.ScreenSpacePosition);
                     break;
 

From 9551e77553aa43b0928814e83916d0979ebde629 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 14 Sep 2021 18:28:56 +0900
Subject: [PATCH 0070/5547] Remove difficulty and sample sections from timing
 screen

---
 .../Timeline/TimelineControlPointGroup.cs     |  8 ---
 .../Edit/Timing/ControlPointSettings.cs       |  2 -
 .../Screens/Edit/Timing/DifficultySection.cs  | 56 ------------------
 osu.Game/Screens/Edit/Timing/SampleSection.cs | 57 -------------------
 4 files changed, 123 deletions(-)
 delete mode 100644 osu.Game/Screens/Edit/Timing/DifficultySection.cs
 delete mode 100644 osu.Game/Screens/Edit/Timing/SampleSection.cs

diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineControlPointGroup.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineControlPointGroup.cs
index c4beb40f92..2b2e66fb18 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineControlPointGroup.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineControlPointGroup.cs
@@ -45,17 +45,9 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
                 {
                     switch (point)
                     {
-                        case DifficultyControlPoint difficultyPoint:
-                            AddInternal(new DifficultyPointPiece(difficultyPoint) { Depth = -2 });
-                            break;
-
                         case TimingControlPoint timingPoint:
                             AddInternal(new TimingPointPiece(timingPoint));
                             break;
-
-                        case SampleControlPoint samplePoint:
-                            AddInternal(new SamplePointPiece(samplePoint) { Depth = -1 });
-                            break;
                     }
                 }
             }, true);
diff --git a/osu.Game/Screens/Edit/Timing/ControlPointSettings.cs b/osu.Game/Screens/Edit/Timing/ControlPointSettings.cs
index 48639789af..938c7f9cf0 100644
--- a/osu.Game/Screens/Edit/Timing/ControlPointSettings.cs
+++ b/osu.Game/Screens/Edit/Timing/ControlPointSettings.cs
@@ -12,8 +12,6 @@ namespace osu.Game.Screens.Edit.Timing
         {
             new GroupSection(),
             new TimingSection(),
-            new DifficultySection(),
-            new SampleSection(),
             new EffectSection(),
         };
     }
diff --git a/osu.Game/Screens/Edit/Timing/DifficultySection.cs b/osu.Game/Screens/Edit/Timing/DifficultySection.cs
deleted file mode 100644
index 52d38f19f6..0000000000
--- a/osu.Game/Screens/Edit/Timing/DifficultySection.cs
+++ /dev/null
@@ -1,56 +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.Game.Beatmaps.ControlPoints;
-using osu.Game.Beatmaps.Legacy;
-
-namespace osu.Game.Screens.Edit.Timing
-{
-    internal class DifficultySection : Section<DifficultyControlPoint>
-    {
-        private SliderWithTextBoxInput<double> sliderVelocitySlider;
-
-        [BackgroundDependencyLoader]
-        private void load()
-        {
-            Flow.AddRange(new[]
-            {
-                sliderVelocitySlider = new SliderWithTextBoxInput<double>("Slider Velocity")
-                {
-                    Current = new DifficultyControlPoint().SliderVelocityBindable,
-                    KeyboardStep = 0.1f
-                }
-            });
-        }
-
-        protected override void OnControlPointChanged(ValueChangedEvent<DifficultyControlPoint> point)
-        {
-            if (point.NewValue != null)
-            {
-                var selectedPointBindable = point.NewValue.SliderVelocityBindable;
-
-                // there may be legacy control points, which contain infinite precision for compatibility reasons (see LegacyDifficultyControlPoint).
-                // generally that level of precision could only be set by externally editing the .osu file, so at the point
-                // a user is looking to update this within the editor it should be safe to obliterate this additional precision.
-                double expectedPrecision = new DifficultyControlPoint().SliderVelocityBindable.Precision;
-                if (selectedPointBindable.Precision < expectedPrecision)
-                    selectedPointBindable.Precision = expectedPrecision;
-
-                sliderVelocitySlider.Current = selectedPointBindable;
-                sliderVelocitySlider.Current.BindValueChanged(_ => ChangeHandler?.SaveState());
-            }
-        }
-
-        protected override DifficultyControlPoint CreatePoint()
-        {
-            var reference = (Beatmap.ControlPointInfo as LegacyControlPointInfo)?.DifficultyPointAt(SelectedGroup.Value.Time) ?? DifficultyControlPoint.DEFAULT;
-
-            return new DifficultyControlPoint
-            {
-                SliderVelocity = reference.SliderVelocity,
-            };
-        }
-    }
-}
diff --git a/osu.Game/Screens/Edit/Timing/SampleSection.cs b/osu.Game/Screens/Edit/Timing/SampleSection.cs
deleted file mode 100644
index 96a67ab046..0000000000
--- a/osu.Game/Screens/Edit/Timing/SampleSection.cs
+++ /dev/null
@@ -1,57 +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.Beatmaps.ControlPoints;
-using osu.Game.Beatmaps.Legacy;
-using osu.Game.Graphics.UserInterfaceV2;
-
-namespace osu.Game.Screens.Edit.Timing
-{
-    internal class SampleSection : Section<SampleControlPoint>
-    {
-        private LabelledTextBox bank;
-        private SliderWithTextBoxInput<int> volume;
-
-        [BackgroundDependencyLoader]
-        private void load()
-        {
-            Flow.AddRange(new Drawable[]
-            {
-                bank = new LabelledTextBox
-                {
-                    Label = "Bank Name",
-                },
-                volume = new SliderWithTextBoxInput<int>("Volume")
-                {
-                    Current = new SampleControlPoint().SampleVolumeBindable,
-                }
-            });
-        }
-
-        protected override void OnControlPointChanged(ValueChangedEvent<SampleControlPoint> point)
-        {
-            if (point.NewValue != null)
-            {
-                bank.Current = point.NewValue.SampleBankBindable;
-                bank.Current.BindValueChanged(_ => ChangeHandler?.SaveState());
-
-                volume.Current = point.NewValue.SampleVolumeBindable;
-                volume.Current.BindValueChanged(_ => ChangeHandler?.SaveState());
-            }
-        }
-
-        protected override SampleControlPoint CreatePoint()
-        {
-            var reference = (Beatmap.ControlPointInfo as LegacyControlPointInfo)?.SamplePointAt(SelectedGroup.Value.Time) ?? SampleControlPoint.DEFAULT;
-
-            return new SampleControlPoint
-            {
-                SampleBank = reference.SampleBank,
-                SampleVolume = reference.SampleVolume,
-            };
-        }
-    }
-}

From 9d17f84681f3a5dcfe1239067ed18f5ffc93f264 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 14 Sep 2021 18:33:24 +0900
Subject: [PATCH 0071/5547] Adjust timeline height to account for less global
 control points

---
 osu.Game/Screens/Edit/Compose/Components/Timeline/Timeline.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/Timeline.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/Timeline.cs
index 4296581480..b8fa05e7eb 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/Timeline.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/Timeline.cs
@@ -59,7 +59,7 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
         private Track track;
 
         private const float timeline_height = 72;
-        private const float timeline_expanded_height = 156;
+        private const float timeline_expanded_height = 94;
 
         public Timeline(Drawable userContent)
         {
@@ -159,7 +159,7 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
                 if (visible.NewValue)
                 {
                     this.ResizeHeightTo(timeline_expanded_height, 200, Easing.OutQuint);
-                    mainContent.MoveToY(36, 200, Easing.OutQuint);
+                    mainContent.MoveToY(20, 200, Easing.OutQuint);
 
                     // delay the fade in else masking looks weird.
                     controlPoints.Delay(180).FadeIn(400, Easing.OutQuint);

From e4dd59aee235cc280444a7d33a752bb9030a5c52 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 14 Sep 2021 18:51:22 +0900
Subject: [PATCH 0072/5547] Add popovers to adjust SV and samples from the
 timeline

---
 .../Timeline/DifficultyPointPiece.cs          | 80 ++++++++++++++++++-
 .../Components/Timeline/SamplePointPiece.cs   | 65 ++++++++++++++-
 .../Timeline/TimelineHitObjectBlueprint.cs    |  2 +-
 3 files changed, 141 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/DifficultyPointPiece.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/DifficultyPointPiece.cs
index 2a46667806..12757febc4 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/DifficultyPointPiece.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/DifficultyPointPiece.cs
@@ -1,20 +1,33 @@
 // 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.Extensions;
+using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.Cursor;
+using osu.Framework.Graphics.UserInterface;
+using osu.Framework.Input.Events;
 using osu.Game.Beatmaps.ControlPoints;
+using osu.Game.Graphics.UserInterfaceV2;
+using osu.Game.Rulesets.Objects;
+using osu.Game.Screens.Edit.Timing;
 
 namespace osu.Game.Screens.Edit.Compose.Components.Timeline
 {
-    public class DifficultyPointPiece : HitObjectPointPiece
+    public class DifficultyPointPiece : HitObjectPointPiece, IHasPopover
     {
+        private readonly HitObject hitObject;
+
         private readonly BindableNumber<double> speedMultiplier;
 
-        public DifficultyPointPiece(DifficultyControlPoint point)
-            : base(point)
+        public DifficultyPointPiece(HitObject hitObject)
+            : base(hitObject.DifficultyControlPoint)
         {
-            speedMultiplier = point.SliderVelocityBindable.GetBoundCopy();
+            this.hitObject = hitObject;
+
+            speedMultiplier = hitObject.DifficultyControlPoint.SliderVelocityBindable.GetBoundCopy();
         }
 
         protected override void LoadComplete()
@@ -23,5 +36,64 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
 
             speedMultiplier.BindValueChanged(multiplier => Label.Text = $"{multiplier.NewValue:n2}x", true);
         }
+
+        protected override bool OnClick(ClickEvent e)
+        {
+            this.ShowPopover();
+            return true;
+        }
+
+        public Popover GetPopover() => new DifficultyEditPopover(hitObject);
+
+        public class DifficultyEditPopover : OsuPopover
+        {
+            private readonly HitObject hitObject;
+            private readonly DifficultyControlPoint point;
+
+            private SliderWithTextBoxInput<double> sliderVelocitySlider;
+
+            [Resolved(canBeNull: true)]
+            private EditorBeatmap beatmap { get; set; }
+
+            public DifficultyEditPopover(HitObject hitObject)
+            {
+                this.hitObject = hitObject;
+                point = hitObject.DifficultyControlPoint;
+            }
+
+            [BackgroundDependencyLoader]
+            private void load()
+            {
+                Children = new Drawable[]
+                {
+                    new FillFlowContainer
+                    {
+                        Width = 200,
+                        Direction = FillDirection.Vertical,
+                        AutoSizeAxes = Axes.Y,
+                        Children = new Drawable[]
+                        {
+                            sliderVelocitySlider = new SliderWithTextBoxInput<double>("Slider Velocity")
+                            {
+                                Current = new DifficultyControlPoint().SliderVelocityBindable,
+                                KeyboardStep = 0.1f
+                            }
+                        }
+                    }
+                };
+
+                var selectedPointBindable = point.SliderVelocityBindable;
+
+                // there may be legacy control points, which contain infinite precision for compatibility reasons (see LegacyDifficultyControlPoint).
+                // generally that level of precision could only be set by externally editing the .osu file, so at the point
+                // a user is looking to update this within the editor it should be safe to obliterate this additional precision.
+                double expectedPrecision = new DifficultyControlPoint().SliderVelocityBindable.Precision;
+                if (selectedPointBindable.Precision < expectedPrecision)
+                    selectedPointBindable.Precision = expectedPrecision;
+
+                sliderVelocitySlider.Current = selectedPointBindable;
+                sliderVelocitySlider.Current.BindValueChanged(_ => beatmap?.Update(hitObject));
+            }
+        }
     }
 }
diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/SamplePointPiece.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/SamplePointPiece.cs
index 40ee7055f1..ee6c1b9fb5 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/SamplePointPiece.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/SamplePointPiece.cs
@@ -3,12 +3,20 @@
 
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
+using osu.Framework.Extensions;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.Cursor;
+using osu.Framework.Graphics.UserInterface;
+using osu.Framework.Input.Events;
 using osu.Game.Beatmaps.ControlPoints;
 using osu.Game.Graphics;
+using osu.Game.Graphics.UserInterfaceV2;
+using osu.Game.Screens.Edit.Timing;
 
 namespace osu.Game.Screens.Edit.Compose.Components.Timeline
 {
-    public class SamplePointPiece : HitObjectPointPiece
+    public class SamplePointPiece : HitObjectPointPiece, IHasPopover
     {
         private readonly SampleControlPoint samplePoint;
 
@@ -30,9 +38,64 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
             bank.BindValueChanged(bank => updateText(), true);
         }
 
+        protected override bool OnClick(ClickEvent e)
+        {
+            this.ShowPopover();
+            return true;
+        }
+
         private void updateText()
         {
             Label.Text = $"{bank.Value} {volume.Value}";
         }
+
+        public Popover GetPopover() => new SampleEditPopover(samplePoint);
+
+        public class SampleEditPopover : OsuPopover
+        {
+            private readonly SampleControlPoint point;
+
+            private LabelledTextBox bank;
+            private SliderWithTextBoxInput<int> volume;
+
+            [Resolved(canBeNull: true)]
+            protected IEditorChangeHandler ChangeHandler { get; private set; }
+
+            public SampleEditPopover(SampleControlPoint point)
+            {
+                this.point = point;
+            }
+
+            [BackgroundDependencyLoader]
+            private void load()
+            {
+                Children = new Drawable[]
+                {
+                    new FillFlowContainer
+                    {
+                        Width = 200,
+                        Direction = FillDirection.Vertical,
+                        AutoSizeAxes = Axes.Y,
+                        Children = new Drawable[]
+                        {
+                            bank = new LabelledTextBox
+                            {
+                                Label = "Bank Name",
+                            },
+                            volume = new SliderWithTextBoxInput<int>("Volume")
+                            {
+                                Current = new SampleControlPoint().SampleVolumeBindable,
+                            }
+                        }
+                    }
+                };
+
+                bank.Current = point.SampleBankBindable;
+                bank.Current.BindValueChanged(_ => ChangeHandler?.SaveState());
+
+                volume.Current = point.SampleVolumeBindable;
+                volume.Current.BindValueChanged(_ => ChangeHandler?.SaveState());
+            }
+        }
     }
 }
diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineHitObjectBlueprint.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineHitObjectBlueprint.cs
index 9a9e981719..ec9cac03b1 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineHitObjectBlueprint.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineHitObjectBlueprint.cs
@@ -212,7 +212,7 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
 
                 if (Item.DifficultyControlPoint != null && Item is IHasDistance)
                 {
-                    AddInternal(difficultyOverrideDisplay = new DifficultyPointPiece(Item.DifficultyControlPoint)
+                    AddInternal(difficultyOverrideDisplay = new DifficultyPointPiece(Item)
                     {
                         Anchor = Anchor.TopLeft,
                         Origin = Anchor.BottomCentre

From d825da3983b11be7a3a45247bfa9cd1eb1644396 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 14 Sep 2021 18:54:21 +0900
Subject: [PATCH 0073/5547] Add note about a better way to adjust velocity

---
 .../Compose/Components/Timeline/DifficultyPointPiece.cs  | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/DifficultyPointPiece.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/DifficultyPointPiece.cs
index 12757febc4..21457ea273 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/DifficultyPointPiece.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/DifficultyPointPiece.cs
@@ -10,6 +10,7 @@ using osu.Framework.Graphics.Cursor;
 using osu.Framework.Graphics.UserInterface;
 using osu.Framework.Input.Events;
 using osu.Game.Beatmaps.ControlPoints;
+using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.UserInterfaceV2;
 using osu.Game.Rulesets.Objects;
 using osu.Game.Screens.Edit.Timing;
@@ -73,10 +74,16 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
                         AutoSizeAxes = Axes.Y,
                         Children = new Drawable[]
                         {
-                            sliderVelocitySlider = new SliderWithTextBoxInput<double>("Slider Velocity")
+                            sliderVelocitySlider = new SliderWithTextBoxInput<double>("Velocity")
                             {
                                 Current = new DifficultyControlPoint().SliderVelocityBindable,
                                 KeyboardStep = 0.1f
+                            },
+                            new OsuTextFlowContainer
+                            {
+                                AutoSizeAxes = Axes.Y,
+                                RelativeSizeAxes = Axes.X,
+                                Text = "Hold shift while dragging the end of an object to adjust velocity while snapping."
                             }
                         }
                     }

From 563bf925291f2737ccf4260503253ade60374e01 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 14 Sep 2021 19:21:23 +0900
Subject: [PATCH 0074/5547] Also update the full object on sample changes to
 make them apply immediately

---
 .../Components/Timeline/SamplePointPiece.cs   | 27 ++++++++++---------
 .../Timeline/TimelineHitObjectBlueprint.cs    |  2 +-
 2 files changed, 16 insertions(+), 13 deletions(-)

diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/SamplePointPiece.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/SamplePointPiece.cs
index ee6c1b9fb5..6a26f69e41 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/SamplePointPiece.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/SamplePointPiece.cs
@@ -12,23 +12,24 @@ using osu.Framework.Input.Events;
 using osu.Game.Beatmaps.ControlPoints;
 using osu.Game.Graphics;
 using osu.Game.Graphics.UserInterfaceV2;
+using osu.Game.Rulesets.Objects;
 using osu.Game.Screens.Edit.Timing;
 
 namespace osu.Game.Screens.Edit.Compose.Components.Timeline
 {
     public class SamplePointPiece : HitObjectPointPiece, IHasPopover
     {
-        private readonly SampleControlPoint samplePoint;
+        private readonly HitObject hitObject;
 
         private readonly Bindable<string> bank;
         private readonly BindableNumber<int> volume;
 
-        public SamplePointPiece(SampleControlPoint samplePoint)
-            : base(samplePoint)
+        public SamplePointPiece(HitObject hitObject)
+            : base(hitObject.SampleControlPoint)
         {
-            this.samplePoint = samplePoint;
-            volume = samplePoint.SampleVolumeBindable.GetBoundCopy();
-            bank = samplePoint.SampleBankBindable.GetBoundCopy();
+            this.hitObject = hitObject;
+            volume = hitObject.SampleControlPoint.SampleVolumeBindable.GetBoundCopy();
+            bank = hitObject.SampleControlPoint.SampleBankBindable.GetBoundCopy();
         }
 
         [BackgroundDependencyLoader]
@@ -49,21 +50,23 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
             Label.Text = $"{bank.Value} {volume.Value}";
         }
 
-        public Popover GetPopover() => new SampleEditPopover(samplePoint);
+        public Popover GetPopover() => new SampleEditPopover(hitObject);
 
         public class SampleEditPopover : OsuPopover
         {
+            private readonly HitObject hitObject;
             private readonly SampleControlPoint point;
 
             private LabelledTextBox bank;
             private SliderWithTextBoxInput<int> volume;
 
             [Resolved(canBeNull: true)]
-            protected IEditorChangeHandler ChangeHandler { get; private set; }
+            private EditorBeatmap beatmap { get; set; }
 
-            public SampleEditPopover(SampleControlPoint point)
+            public SampleEditPopover(HitObject hitObject)
             {
-                this.point = point;
+                this.hitObject = hitObject;
+                point = hitObject.SampleControlPoint;
             }
 
             [BackgroundDependencyLoader]
@@ -91,10 +94,10 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
                 };
 
                 bank.Current = point.SampleBankBindable;
-                bank.Current.BindValueChanged(_ => ChangeHandler?.SaveState());
+                bank.Current.BindValueChanged(_ => beatmap.Update(hitObject));
 
                 volume.Current = point.SampleVolumeBindable;
-                volume.Current.BindValueChanged(_ => ChangeHandler?.SaveState());
+                volume.Current.BindValueChanged(_ => beatmap.Update(hitObject));
             }
         }
     }
diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineHitObjectBlueprint.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineHitObjectBlueprint.cs
index ec9cac03b1..a1b2878719 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineHitObjectBlueprint.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineHitObjectBlueprint.cs
@@ -227,7 +227,7 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
 
                 if (Item.SampleControlPoint != null)
                 {
-                    AddInternal(sampleOverrideDisplay = new SamplePointPiece(Item.SampleControlPoint)
+                    AddInternal(sampleOverrideDisplay = new SamplePointPiece(Item)
                     {
                         Anchor = Anchor.BottomLeft,
                         Origin = Anchor.TopCentre

From 13f88cbc4ebc1b6769544b494b9f48b641f8086d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 14 Sep 2021 23:56:57 +0900
Subject: [PATCH 0075/5547] Fix `EditorClock` retaining a reference to
 potentially outdated `ControlPointInfo`

---
 osu.Game/Screens/Edit/EditorClock.cs          | 20 ++++++-------------
 osu.Game/Tests/Visual/EditorClockTestScene.cs |  5 ++---
 2 files changed, 8 insertions(+), 17 deletions(-)

diff --git a/osu.Game/Screens/Edit/EditorClock.cs b/osu.Game/Screens/Edit/EditorClock.cs
index ba83261731..86e5729196 100644
--- a/osu.Game/Screens/Edit/EditorClock.cs
+++ b/osu.Game/Screens/Edit/EditorClock.cs
@@ -25,7 +25,9 @@ namespace osu.Game.Screens.Edit
 
         public double TrackLength => track.Value?.Length ?? 60000;
 
-        public ControlPointInfo ControlPointInfo;
+        public ControlPointInfo ControlPointInfo => Beatmap.ControlPointInfo;
+
+        public IBeatmap Beatmap { get; set; }
 
         private readonly BindableBeatDivisor beatDivisor;
 
@@ -42,25 +44,15 @@ namespace osu.Game.Screens.Edit
         /// </summary>
         public bool IsSeeking { get; private set; }
 
-        public EditorClock(IBeatmap beatmap, BindableBeatDivisor beatDivisor)
-            : this(beatmap.ControlPointInfo, beatDivisor)
+        public EditorClock(IBeatmap beatmap = null, BindableBeatDivisor beatDivisor = null)
         {
-        }
+            Beatmap = beatmap ?? new Beatmap();
 
-        public EditorClock(ControlPointInfo controlPointInfo, BindableBeatDivisor beatDivisor)
-        {
-            this.beatDivisor = beatDivisor;
-
-            ControlPointInfo = controlPointInfo;
+            this.beatDivisor = beatDivisor ?? new BindableBeatDivisor();
 
             underlyingClock = new DecoupleableInterpolatingFramedClock();
         }
 
-        public EditorClock()
-            : this(new ControlPointInfo(), new BindableBeatDivisor())
-        {
-        }
-
         /// <summary>
         /// Seek to the closest snappable beat from a time.
         /// </summary>
diff --git a/osu.Game/Tests/Visual/EditorClockTestScene.cs b/osu.Game/Tests/Visual/EditorClockTestScene.cs
index 34393fba7d..c2e9892735 100644
--- a/osu.Game/Tests/Visual/EditorClockTestScene.cs
+++ b/osu.Game/Tests/Visual/EditorClockTestScene.cs
@@ -5,7 +5,6 @@ using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Input.Events;
 using osu.Game.Beatmaps;
-using osu.Game.Beatmaps.ControlPoints;
 using osu.Game.Screens.Edit;
 
 namespace osu.Game.Tests.Visual
@@ -23,7 +22,7 @@ namespace osu.Game.Tests.Visual
 
         protected EditorClockTestScene()
         {
-            Clock = new EditorClock(new ControlPointInfo(), BeatDivisor) { IsCoupled = false };
+            Clock = new EditorClock(new Beatmap(), BeatDivisor) { IsCoupled = false };
         }
 
         protected override IReadOnlyDependencyContainer CreateChildDependencies(IReadOnlyDependencyContainer parent)
@@ -44,7 +43,7 @@ namespace osu.Game.Tests.Visual
 
         private void beatmapChanged(ValueChangedEvent<WorkingBeatmap> e)
         {
-            Clock.ControlPointInfo = e.NewValue.Beatmap.ControlPointInfo;
+            Clock.Beatmap = e.NewValue.Beatmap;
             Clock.ChangeSource(e.NewValue.Track);
             Clock.ProcessFrame();
         }

From 80269689393f5be2f72d03ed85a829a4448140e1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 18 Sep 2021 14:24:50 +0200
Subject: [PATCH 0076/5547] Move difficulty -> effect point conversion back to
 decoder

---
 .../Beatmaps/ManiaBeatmapConverter.cs         | 33 -------------------
 .../Beatmaps/Formats/LegacyBeatmapDecoder.cs  | 27 ++++++++++-----
 .../Beatmaps/Formats/LegacyBeatmapEncoder.cs  |  2 +-
 3 files changed, 20 insertions(+), 42 deletions(-)

diff --git a/osu.Game.Rulesets.Mania/Beatmaps/ManiaBeatmapConverter.cs b/osu.Game.Rulesets.Mania/Beatmaps/ManiaBeatmapConverter.cs
index 65dc65b28a..5903e161d0 100644
--- a/osu.Game.Rulesets.Mania/Beatmaps/ManiaBeatmapConverter.cs
+++ b/osu.Game.Rulesets.Mania/Beatmaps/ManiaBeatmapConverter.cs
@@ -8,8 +8,6 @@ using System.Collections.Generic;
 using System.Threading;
 using osu.Game.Audio;
 using osu.Game.Beatmaps;
-using osu.Game.Beatmaps.ControlPoints;
-using osu.Game.Beatmaps.Legacy;
 using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Objects.Types;
 using osu.Game.Rulesets.Mania.Beatmaps.Patterns;
@@ -84,37 +82,6 @@ namespace osu.Game.Rulesets.Mania.Beatmaps
         protected override Beatmap<ManiaHitObject> ConvertBeatmap(IBeatmap original, CancellationToken cancellationToken)
         {
             BeatmapDifficulty difficulty = original.BeatmapInfo.BaseDifficulty;
-
-            if (IsForCurrentRuleset && original.ControlPointInfo is LegacyControlPointInfo originalLegacyControlPoints)
-            {
-                // original is cloned so we're safe to replace control point storage at this point.
-                original.ControlPointInfo = new LegacyControlPointInfo();
-
-                // convert all slider velocity adjustments to scroll speed adjustments.
-                foreach (var controlPoint in originalLegacyControlPoints.AllControlPoints)
-                {
-                    double time = controlPoint.Time;
-
-                    switch (controlPoint)
-                    {
-                        default:
-                            original.ControlPointInfo.Add(time, controlPoint);
-                            break;
-
-                        case DifficultyControlPoint difficultyPoint:
-                            var reference = originalLegacyControlPoints.EffectPointAt(time);
-
-                            var scrollControlPoint = new EffectControlPoint();
-
-                            scrollControlPoint.CopyFrom(reference);
-                            scrollControlPoint.ScrollSpeed = difficultyPoint.SliderVelocity;
-
-                            original.ControlPointInfo.Add(time, scrollControlPoint);
-                            break;
-                    }
-                }
-            }
-
             int seed = (int)MathF.Round(difficulty.DrainRate + difficulty.CircleSize) * 20 + (int)(difficulty.OverallDifficulty * 41.2) + (int)MathF.Round(difficulty.ApproachRate);
             Random = new FastRandom(seed);
 
diff --git a/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs b/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
index a9b5793565..68e6a8ac00 100644
--- a/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
+++ b/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
@@ -376,18 +376,29 @@ namespace osu.Game.Beatmaps.Formats
                 addControlPoint(time, controlPoint, true);
             }
 
-#pragma warning disable 618
-            addControlPoint(time, new LegacyDifficultyControlPoint(beatLength)
-#pragma warning restore 618
-            {
-                SliderVelocity = speedMultiplier,
-            }, timingChange);
+            bool isOsuRuleset = beatmap.BeatmapInfo.RulesetID == 0;
 
-            addControlPoint(time, new EffectControlPoint
+            if (isOsuRuleset)
+            {
+#pragma warning disable 618
+                addControlPoint(time, new LegacyDifficultyControlPoint(beatLength)
+#pragma warning restore 618
+                {
+                    SliderVelocity = speedMultiplier,
+                }, timingChange);
+            }
+
+            var effectPoint = new EffectControlPoint
             {
                 KiaiMode = kiaiMode,
                 OmitFirstBarLine = omitFirstBarSignature,
-            }, timingChange);
+            };
+
+            // scrolling rulesets use effect points rather than difficulty points for scroll speed adjustments.
+            if (!isOsuRuleset)
+                effectPoint.ScrollSpeed = speedMultiplier;
+
+            addControlPoint(time, effectPoint, timingChange);
 
             addControlPoint(time, new LegacySampleControlPoint
             {
diff --git a/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs b/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs
index ebb326ccc8..d903ab3a6d 100644
--- a/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs
+++ b/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs
@@ -189,7 +189,7 @@ namespace osu.Game.Beatmaps.Formats
             }
 
             // handle scroll speed, which is stored as "slider velocity" in legacy formats.
-            // note that this is only relevant for mania beatmaps.
+            // this is relevant for scrolling ruleset beatmaps.
             if (!isOsuRuleset)
             {
                 foreach (var point in legacyControlPoints.EffectPoints)

From 76ccdd1340b3480036207b94c6d688fdddef27ef Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 16 Sep 2021 18:04:26 +0200
Subject: [PATCH 0077/5547] Collect and sort points from nested objects before
 extracting

---
 .../Beatmaps/Formats/LegacyBeatmapEncoder.cs  | 65 +++++++++++--------
 1 file changed, 39 insertions(+), 26 deletions(-)

diff --git a/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs b/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs
index d903ab3a6d..b0ed6c4f79 100644
--- a/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs
+++ b/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs
@@ -182,11 +182,8 @@ namespace osu.Game.Beatmaps.Formats
             bool isOsuRuleset = beatmap.BeatmapInfo.RulesetID == 0;
 
             // iterate over hitobjects and pull out all required sample and difficulty changes
-            foreach (var h in beatmap.HitObjects)
-            {
-                extractDifficultyControlPoints(h);
-                extractSampleControlPoints(h);
-            }
+            extractDifficultyControlPoints(beatmap.HitObjects);
+            extractSampleControlPoints(beatmap.HitObjects);
 
             // handle scroll speed, which is stored as "slider velocity" in legacy formats.
             // this is relevant for scrolling ruleset beatmaps.
@@ -239,36 +236,52 @@ namespace osu.Game.Beatmaps.Formats
                 writer.WriteLine();
             }
 
-            void extractDifficultyControlPoints(HitObject hitObject)
+            IEnumerable<DifficultyControlPoint> collectDifficultyControlPoints(IEnumerable<HitObject> hitObjects)
             {
                 if (!isOsuRuleset)
-                    return;
+                    yield break;
 
-                var hDifficultyPoint = hitObject.DifficultyControlPoint;
-
-                if (!hDifficultyPoint.IsRedundant(lastRelevantDifficultyPoint))
+                foreach (var hitObject in hitObjects)
                 {
-                    legacyControlPoints.Add(hDifficultyPoint.Time, hDifficultyPoint);
-                    lastRelevantDifficultyPoint = hDifficultyPoint;
-                }
+                    yield return hitObject.DifficultyControlPoint;
 
-                foreach (var nested in hitObject.NestedHitObjects)
-                    extractDifficultyControlPoints(nested);
+                    foreach (var nested in collectDifficultyControlPoints(hitObject.NestedHitObjects))
+                        yield return nested;
+                }
             }
 
-            void extractSampleControlPoints(HitObject hitObject)
+            void extractDifficultyControlPoints(IEnumerable<HitObject> hitObjects)
             {
-                // process nested objects first as these use EndTime for legacy storage.
-
-                foreach (var nested in hitObject.NestedHitObjects)
-                    extractSampleControlPoints(nested);
-
-                var hSamplePoint = hitObject.SampleControlPoint;
-
-                if (!hSamplePoint.IsRedundant(lastRelevantSamplePoint))
+                foreach (var hDifficultyPoint in collectDifficultyControlPoints(hitObjects).OrderBy(dp => dp.Time))
                 {
-                    legacyControlPoints.Add(hSamplePoint.Time, hSamplePoint);
-                    lastRelevantSamplePoint = hSamplePoint;
+                    if (!hDifficultyPoint.IsRedundant(lastRelevantDifficultyPoint))
+                    {
+                        legacyControlPoints.Add(hDifficultyPoint.Time, hDifficultyPoint);
+                        lastRelevantDifficultyPoint = hDifficultyPoint;
+                    }
+                }
+            }
+
+            IEnumerable<SampleControlPoint> collectSampleControlPoints(IEnumerable<HitObject> hitObjects)
+            {
+                foreach (var hitObject in hitObjects)
+                {
+                    yield return hitObject.SampleControlPoint;
+
+                    foreach (var nested in collectSampleControlPoints(hitObject.NestedHitObjects))
+                        yield return nested;
+                }
+            }
+
+            void extractSampleControlPoints(IEnumerable<HitObject> hitObject)
+            {
+                foreach (var hSamplePoint in collectSampleControlPoints(hitObject).OrderBy(sp => sp.Time))
+                {
+                    if (!hSamplePoint.IsRedundant(lastRelevantSamplePoint))
+                    {
+                        legacyControlPoints.Add(hSamplePoint.Time, hSamplePoint);
+                        lastRelevantSamplePoint = hSamplePoint;
+                    }
                 }
             }
         }

From 80197bae48f3deefae5934c680d51191e58d6045 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 18 Sep 2021 15:32:08 +0200
Subject: [PATCH 0078/5547] Revert not decoding legacy difficulty points on
 scrolling rulesets for now

---
 osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs | 14 +++++---------
 1 file changed, 5 insertions(+), 9 deletions(-)

diff --git a/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs b/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
index 68e6a8ac00..94aea17e9d 100644
--- a/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
+++ b/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
@@ -376,17 +376,12 @@ namespace osu.Game.Beatmaps.Formats
                 addControlPoint(time, controlPoint, true);
             }
 
-            bool isOsuRuleset = beatmap.BeatmapInfo.RulesetID == 0;
-
-            if (isOsuRuleset)
-            {
 #pragma warning disable 618
-                addControlPoint(time, new LegacyDifficultyControlPoint(beatLength)
+            addControlPoint(time, new LegacyDifficultyControlPoint(beatLength)
 #pragma warning restore 618
-                {
-                    SliderVelocity = speedMultiplier,
-                }, timingChange);
-            }
+            {
+                SliderVelocity = speedMultiplier,
+            }, timingChange);
 
             var effectPoint = new EffectControlPoint
             {
@@ -394,6 +389,7 @@ namespace osu.Game.Beatmaps.Formats
                 OmitFirstBarLine = omitFirstBarSignature,
             };
 
+            bool isOsuRuleset = beatmap.BeatmapInfo.RulesetID == 0;
             // scrolling rulesets use effect points rather than difficulty points for scroll speed adjustments.
             if (!isOsuRuleset)
                 effectPoint.ScrollSpeed = speedMultiplier;

From 587cf09d2a1e91fb51339730404f85d86c861bdd Mon Sep 17 00:00:00 2001
From: Xexxar <xexxar.xexxar@gmail.com>
Date: Sat, 25 Sep 2021 03:02:33 +0000
Subject: [PATCH 0079/5547] base change of aim refactor, isolated

---
 .../Preprocessing/OsuDifficultyHitObject.cs   | 22 +++--
 .../Difficulty/Skills/Aim.cs                  | 96 ++++++++++++++-----
 .../Difficulty/Skills/Speed.cs                |  4 +-
 3 files changed, 89 insertions(+), 33 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
index 8e8f9bc06e..52f18539c4 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
@@ -12,20 +12,20 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
 {
     public class OsuDifficultyHitObject : DifficultyHitObject
     {
-        private const int normalized_radius = 52;
+        private const int normalized_radius = 50; // Change radius to 50 to make 100 the diameter. Easier for mental maths.
 
         protected new OsuHitObject BaseObject => (OsuHitObject)base.BaseObject;
 
-        /// <summary>
-        /// Milliseconds elapsed since the start time of the previous <see cref="OsuDifficultyHitObject"/>, with a minimum of 25ms to account for simultaneous <see cref="OsuDifficultyHitObject"/>s.
-        /// </summary>
-        public double StrainTime { get; private set; }
-
         /// <summary>
         /// Normalized distance from the end position of the previous <see cref="OsuDifficultyHitObject"/> to the start position of this <see cref="OsuDifficultyHitObject"/>.
         /// </summary>
         public double JumpDistance { get; private set; }
 
+        /// <summary>
+        /// Normalized Vector from the end position of the previous <see cref="OsuDifficultyHitObject"/> to the start position of this <see cref="OsuDifficultyHitObject"/>.
+        /// </summary>
+        public Vector2 JumpVector { get; private set; }
+
         /// <summary>
         /// Normalized distance between the start and end position of the previous <see cref="OsuDifficultyHitObject"/>.
         /// </summary>
@@ -37,6 +37,11 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
         /// </summary>
         public double? Angle { get; private set; }
 
+        /// <summary>
+        /// Milliseconds elapsed since the start time of the previous <see cref="OsuDifficultyHitObject"/>, with a minimum of 50ms.
+        /// </summary>
+        public readonly double StrainTime;
+
         private readonly OsuHitObject lastLastObject;
         private readonly OsuHitObject lastObject;
 
@@ -73,7 +78,10 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
 
             // Don't need to jump to reach spinners
             if (!(BaseObject is Spinner))
-                JumpDistance = (BaseObject.StackedPosition * scalingFactor - lastCursorPosition * scalingFactor).Length;
+            {
+                JumpVector = (BaseObject.StackedPosition * scalingFactor - lastCursorPosition * scalingFactor);
+                JumpDistance = JumpVector.Length;
+            }
 
             if (lastLastObject != null)
             {
diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
index 16a18cbcb9..677d3c06aa 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
@@ -6,6 +6,8 @@ using osu.Game.Rulesets.Difficulty.Preprocessing;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Osu.Difficulty.Preprocessing;
 using osu.Game.Rulesets.Osu.Objects;
+using osu.Framework.Utils;
+using osuTK;
 
 namespace osu.Game.Rulesets.Osu.Difficulty.Skills
 {
@@ -14,51 +16,97 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
     /// </summary>
     public class Aim : OsuStrainSkill
     {
-        private const double angle_bonus_begin = Math.PI / 3;
-        private const double timing_threshold = 107;
-
         public Aim(Mod[] mods)
             : base(mods)
         {
         }
 
-        protected override double SkillMultiplier => 26.25;
+        protected override int HistoryLength => 2;
+
+        protected override double SkillMultiplier => 24.75;
         protected override double StrainDecayBase => 0.15;
 
+        private const double wide_angle_multiplier = 1.0;
+        private const double acute_angle_multiplier = 1.0;
+        private const double rhythm_variance_multiplier = 1.0;
+
         protected override double StrainValueOf(DifficultyHitObject current)
         {
-            if (current.BaseObject is Spinner)
+            if (current.BaseObject is Spinner || Previous.Count <= 1)
                 return 0;
 
-            var osuCurrent = (OsuDifficultyHitObject)current;
+            var osuCurrObj = (OsuDifficultyHitObject)current;
+            var osuPrevObj = (OsuDifficultyHitObject)Previous[0];
+            var osuLastObj = (OsuDifficultyHitObject)Previous[1];
 
-            double result = 0;
+            var currVector = Vector2.Divide(osuCurrObj.JumpVector, (float)osuCurrObj.StrainTime);
+            var prevVector = Vector2.Divide(osuPrevObj.JumpVector, (float)osuPrevObj.StrainTime);
 
-            if (Previous.Count > 0)
+            // Start with regular velocity.
+            double aimStrain = currVector.Length;
+
+            if (Precision.AlmostEquals(osuCurrObj.StrainTime, osuPrevObj.StrainTime, 10)) // Rhythms are the same.
             {
-                var osuPrevious = (OsuDifficultyHitObject)Previous[0];
-
-                if (osuCurrent.Angle != null && osuCurrent.Angle.Value > angle_bonus_begin)
+                if (osuCurrObj.Angle != null)
                 {
-                    const double scale = 90;
+                    double angle = osuCurrObj.Angle.Value;
 
-                    var angleBonus = Math.Sqrt(
-                        Math.Max(osuPrevious.JumpDistance - scale, 0)
-                        * Math.Pow(Math.Sin(osuCurrent.Angle.Value - angle_bonus_begin), 2)
-                        * Math.Max(osuCurrent.JumpDistance - scale, 0));
-                    result = 1.4 * applyDiminishingExp(Math.Max(0, angleBonus)) / Math.Max(timing_threshold, osuPrevious.StrainTime);
+                    // Rewarding angles, take the smaller velocity as base.
+                    double angleBonus = Math.Min(currVector.Length, prevVector.Length);
+
+                    double wideAngleBonus = calcWideAngleBonus(angle);
+                    double acuteAngleBonus = calcAcuteAngleBonus(angle);
+
+                    if (osuCurrObj.StrainTime > 100)
+                        acuteAngleBonus = 0;
+                    else
+                    {
+                        acuteAngleBonus *= Math.Min(2, Math.Pow((100 - osuCurrObj.StrainTime) / 15, 1.5));
+                        wideAngleBonus *= Math.Pow(osuCurrObj.StrainTime / 100, 6);
+                    }
+
+                    if (acuteAngleBonus > wideAngleBonus)
+                        angleBonus = Math.Min(angleBonus, 150 / osuCurrObj.StrainTime) * Math.Min(1, Math.Pow(Math.Min(osuCurrObj.JumpDistance, osuPrevObj.JumpDistance) / 150, 2));
+
+                    angleBonus *= Math.Max(acuteAngleBonus * acute_angle_multiplier, wideAngleBonus * wide_angle_multiplier);
+
+                    // add in angle velocity.
+                    aimStrain += angleBonus;
                 }
             }
+            else // There is a rhythm change
+            {
+                // Rewarding rhythm, take the smaller velocity as base.
+                double rhythmBonus = Math.Min(currVector.Length, prevVector.Length);
 
-            double jumpDistanceExp = applyDiminishingExp(osuCurrent.JumpDistance);
-            double travelDistanceExp = applyDiminishingExp(osuCurrent.TravelDistance);
+                if (osuCurrObj.StrainTime + 10 < osuPrevObj.StrainTime && osuPrevObj.StrainTime > osuLastObj.StrainTime + 10)
+                    // Don't want to reward for a rhythm change back to back (unless its a double, which is why this only checks for fast -> slow -> fast).
+                    rhythmBonus = 0;
 
-            return Math.Max(
-                result + (jumpDistanceExp + travelDistanceExp + Math.Sqrt(travelDistanceExp * jumpDistanceExp)) / Math.Max(osuCurrent.StrainTime, timing_threshold),
-                (Math.Sqrt(travelDistanceExp * jumpDistanceExp) + jumpDistanceExp + travelDistanceExp) / osuCurrent.StrainTime
-            );
+                aimStrain += rhythmBonus * rhythm_variance_multiplier; // add in rhythm velocity.
+            }
+
+            return aimStrain;
         }
 
-        private double applyDiminishingExp(double val) => Math.Pow(val, 0.99);
+        private double calcWideAngleBonus(double angle)
+        {
+            if (angle < Math.PI / 3)
+                return 0;
+            if (angle < 2 * Math.PI / 3)
+                return Math.Pow(Math.Sin(1.5 * (angle - Math.PI / 3)), 2);
+
+            return 0.25 + 0.75 * Math.Pow(Math.Sin(1.5 * (Math.PI - angle)), 2);
+        }
+
+        private double calcAcuteAngleBonus(double angle)
+        {
+            if (angle < Math.PI / 3)
+                return 0.5 + 0.5 * Math.Pow(Math.Sin(1.5 * angle), 2);
+            if (angle < 2 * Math.PI / 3)
+                return Math.Pow(Math.Sin(1.5 * (2 * Math.PI / 3 - angle)), 2);
+
+            return 0;
+        }
     }
 }
diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Speed.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Speed.cs
index 9364b11048..434074da17 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Speed.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Speed.cs
@@ -15,7 +15,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
     /// </summary>
     public class Speed : OsuStrainSkill
     {
-        private const double single_spacing_threshold = 125;
+        private const double single_spacing_threshold = 135;
 
         private const double angle_bonus_begin = 5 * Math.PI / 6;
         private const double pi_over_4 = Math.PI / 4;
@@ -81,7 +81,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
 
             return (1 + (speedBonus - 1) * 0.75)
                    * angleBonus
-                   * (0.95 + speedBonus * Math.Pow(distance / single_spacing_threshold, 3.5))
+                   * (0.95 + speedBonus * Math.Pow(distance / single_spacing_threshold, 3.0))
                    / strainTime;
         }
     }

From 8c6a035369251e4ee67278a08b9dd46eb3a32d4d Mon Sep 17 00:00:00 2001
From: Xexxar <xexxar.xexxar@gmail.com>
Date: Sat, 25 Sep 2021 03:04:22 +0000
Subject: [PATCH 0080/5547] added slider calc bonus

---
 osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
index 677d3c06aa..9f30c00f39 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
@@ -29,6 +29,8 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
         private const double wide_angle_multiplier = 1.0;
         private const double acute_angle_multiplier = 1.0;
         private const double rhythm_variance_multiplier = 1.0;
+        private const double slider_multiplier = 6.5;
+        private const double slider_jump_multiplier = 0.875;
 
         protected override double StrainValueOf(DifficultyHitObject current)
         {
@@ -86,6 +88,14 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
                 aimStrain += rhythmBonus * rhythm_variance_multiplier; // add in rhythm velocity.
             }
 
+            if (osuCurrObj.TravelDistance != 0)
+            {
+                double sliderBonus = Math.Max(osuCurrObj.TravelDistance, slider_jump_multiplier * Math.Sqrt(osuCurrObj.TravelDistance * osuCurrObj.JumpDistance)) / osuCurrObj.StrainTime;
+
+                // Add in slider velocity.
+                aimStrain += sliderBonus * slider_multiplier;
+            }
+
             return aimStrain;
         }
 

From 010078778e67e4b4c133f39c7ba5b96221f5f1dc Mon Sep 17 00:00:00 2001
From: Xexxar <xexxar.xexxar@gmail.com>
Date: Sat, 25 Sep 2021 03:27:07 +0000
Subject: [PATCH 0081/5547] velocity buff isolation + small refactor

---
 osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
index 677d3c06aa..f02c11a0a3 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
@@ -29,6 +29,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
         private const double wide_angle_multiplier = 1.0;
         private const double acute_angle_multiplier = 1.0;
         private const double rhythm_variance_multiplier = 1.0;
+        private const double vel_change_multiplier = 2.0;
 
         protected override double StrainValueOf(DifficultyHitObject current)
         {
@@ -73,6 +74,13 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
                     // add in angle velocity.
                     aimStrain += angleBonus;
                 }
+
+                if (prevVector.Length > currVector.Length)
+                {
+                    double velChangeBonus = Math.Max(0, Math.Sqrt((prevVector.Length - currVector.Length) * currVector.Length) - Math.Max(0, currVector.Length - 100 / osuCurrObj.StrainTime)) * Math.Min(1, osuCurrObj.JumpDistance / 100);
+
+                    aimStrain += velChangeBonus * vel_change_multiplier;
+                }
             }
             else // There is a rhythm change
             {

From 9802f4fc908de47ffa59be01f770bd3df32c9f34 Mon Sep 17 00:00:00 2001
From: Xexxar <xexxar.xexxar@gmail.com>
Date: Sat, 25 Sep 2021 03:37:19 +0000
Subject: [PATCH 0082/5547] added wide angle buff to velchange

---
 osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
index f02c11a0a3..5ee984350e 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
@@ -73,13 +73,13 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
 
                     // add in angle velocity.
                     aimStrain += angleBonus;
-                }
 
-                if (prevVector.Length > currVector.Length)
-                {
-                    double velChangeBonus = Math.Max(0, Math.Sqrt((prevVector.Length - currVector.Length) * currVector.Length) - Math.Max(0, currVector.Length - 100 / osuCurrObj.StrainTime)) * Math.Min(1, osuCurrObj.JumpDistance / 100);
+                    if (prevVector.Length > currVector.Length)
+                    {
+                        double velChangeBonus = Math.Max(0, Math.Sqrt((prevVector.Length - currVector.Length) * currVector.Length) - Math.Max(0, currVector.Length - 100 / osuCurrObj.StrainTime)) * Math.Min(1, osuCurrObj.JumpDistance / 100);
 
-                    aimStrain += velChangeBonus * vel_change_multiplier;
+                        aimStrain += velChangeBonus * (1 + wideAngleBonus)* vel_change_multiplier;
+                    }
                 }
             }
             else // There is a rhythm change

From ffa0fac5ebdc183f9e3eb48c6941a9c30653f24a Mon Sep 17 00:00:00 2001
From: Xexxar <xexxar.xexxar@gmail.com>
Date: Sat, 25 Sep 2021 04:08:05 +0000
Subject: [PATCH 0083/5547] refactored to clean up issues with streams

---
 osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
index 5ee984350e..af7e9900c1 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
@@ -29,7 +29,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
         private const double wide_angle_multiplier = 1.0;
         private const double acute_angle_multiplier = 1.0;
         private const double rhythm_variance_multiplier = 1.0;
-        private const double vel_change_multiplier = 2.0;
+        private const double vel_change_multiplier = 1.0;
 
         protected override double StrainValueOf(DifficultyHitObject current)
         {
@@ -76,9 +76,11 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
 
                     if (prevVector.Length > currVector.Length)
                     {
-                        double velChangeBonus = Math.Max(0, Math.Sqrt((prevVector.Length - currVector.Length) * currVector.Length) - Math.Max(0, currVector.Length - 100 / osuCurrObj.StrainTime)) * Math.Min(1, osuCurrObj.JumpDistance / 100);
+                        double velChangeBonus = Math.Max(0, (prevVector.Length - currVector.Length) - Math.Min(0, currVector.Length - 100 / osuCurrObj.StrainTime))
+                                                * Math.Min(1, osuCurrObj.JumpDistance / 100)
+                                                * Math.Min(1, (osuPrevObj.JumpDistance - osuCurrObj.JumpDistance) / 100);
 
-                        aimStrain += velChangeBonus * (1 + wideAngleBonus)* vel_change_multiplier;
+                        aimStrain += velChangeBonus * Math.Sqrt(100 / osuCurrObj.StrainTime) * (1 + wideAngleBonus) * vel_change_multiplier;
                     }
                 }
             }

From b7444ee9eb7970fd35e1b307bdeb49fa927be388 Mon Sep 17 00:00:00 2001
From: Xexxar <xexxar.xexxar@gmail.com>
Date: Sat, 25 Sep 2021 04:20:35 +0000
Subject: [PATCH 0084/5547] replaced original velocity alg

---
 osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
index af7e9900c1..beedb64af2 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
@@ -29,7 +29,9 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
         private const double wide_angle_multiplier = 1.0;
         private const double acute_angle_multiplier = 1.0;
         private const double rhythm_variance_multiplier = 1.0;
-        private const double vel_change_multiplier = 1.0;
+        private const double vel_change_multiplier = 6.5;
+        private const double slider_multiplier = 6.5;
+        private const double slider_jump_multiplier = 0.875;
 
         protected override double StrainValueOf(DifficultyHitObject current)
         {
@@ -76,11 +78,9 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
 
                     if (prevVector.Length > currVector.Length)
                     {
-                        double velChangeBonus = Math.Max(0, (prevVector.Length - currVector.Length) - Math.Min(0, currVector.Length - 100 / osuCurrObj.StrainTime))
-                                                * Math.Min(1, osuCurrObj.JumpDistance / 100)
-                                                * Math.Min(1, (osuPrevObj.JumpDistance - osuCurrObj.JumpDistance) / 100);
+                        double velChangeBonus = Math.Max(0, Math.Sqrt((prevVector.Length - currVector.Length) * currVector.Length) - currVector.Length) * Math.Min(1, osuCurrObj.JumpDistance / 100);
 
-                        aimStrain += velChangeBonus * Math.Sqrt(100 / osuCurrObj.StrainTime) * (1 + wideAngleBonus) * vel_change_multiplier;
+                        aimStrain += velChangeBonus * Math.Sqrt(100 / osuCurrObj.StrainTime) * vel_change_multiplier;
                     }
                 }
             }

From 4099726d594b00f02456131bb7ca3cf76632fd79 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 25 Sep 2021 15:41:06 +0200
Subject: [PATCH 0085/5547] Update SR values in tests

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

diff --git a/osu.Game.Rulesets.Osu.Tests/OsuDifficultyCalculatorTest.cs b/osu.Game.Rulesets.Osu.Tests/OsuDifficultyCalculatorTest.cs
index 19881b5c33..c85ce49ef6 100644
--- a/osu.Game.Rulesets.Osu.Tests/OsuDifficultyCalculatorTest.cs
+++ b/osu.Game.Rulesets.Osu.Tests/OsuDifficultyCalculatorTest.cs
@@ -15,13 +15,13 @@ namespace osu.Game.Rulesets.Osu.Tests
     {
         protected override string ResourceAssembly => "osu.Game.Rulesets.Osu";
 
-        [TestCase(6.6634445062299665d, "diffcalc-test")]
-        [TestCase(1.0414203870195022d, "zero-length-sliders")]
+        [TestCase(6.4766744062777439d, "diffcalc-test")]
+        [TestCase(0.63190213974653298d, "zero-length-sliders")]
         public void Test(double expected, string name)
             => base.Test(expected, name);
 
-        [TestCase(8.3858089051603368d, "diffcalc-test")]
-        [TestCase(1.2723279173428435d, "zero-length-sliders")]
+        [TestCase(8.9926029916156764d, "diffcalc-test")]
+        [TestCase(0.78116445583636385d, "zero-length-sliders")]
         public void TestClockRateAdjusted(double expected, string name)
             => Test(expected, name, new OsuModDoubleTime());
 

From c4430182dd001f25cbb91d28d149766716257b08 Mon Sep 17 00:00:00 2001
From: Xexxar <xexxar.xexxar@gmail.com>
Date: Sun, 26 Sep 2021 21:32:36 +0000
Subject: [PATCH 0086/5547] used new slider bonus alg to not overbuff slider
 jumps

---
 .../Preprocessing/OsuDifficultyHitObject.cs        | 14 +++++++++++++-
 osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs     |  5 ++---
 2 files changed, 15 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
index 52f18539c4..126f5b86c3 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
@@ -31,6 +31,16 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
         /// </summary>
         public double TravelDistance { get; private set; }
 
+        /// <summary>
+        /// Normalized Vector from the start position of the previous <see cref="OsuDifficultyHitObject"/> to the end position of the previous <see cref="OsuDifficultyHitObject"/>.
+        /// </summary>
+        public Vector2 TravelVector { get; private set; }
+
+        /// <summary>
+        /// Milliseconds elapsed since the start time of the previous <see cref="OsuDifficultyHitObject"/>, with a minimum of 50ms.
+        /// </summary>
+        public readonly double TravelTime;
+
         /// <summary>
         /// Angle the player has to take to hit this <see cref="OsuDifficultyHitObject"/>.
         /// Calculated as the angle between the circles (current-2, current-1, current).
@@ -71,6 +81,8 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
             if (lastObject is Slider lastSlider)
             {
                 computeSliderCursorPosition(lastSlider);
+
+                TravelVector = Vector2.Multiply(Vector2.Subtract(lastSlider.TailCircle.Position, lastSlider.HeadCircle.Position), scalingFactor);
                 TravelDistance = lastSlider.LazyTravelDistance * scalingFactor;
             }
 
@@ -104,7 +116,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
 
             slider.LazyEndPosition = slider.StackedPosition;
 
-            float approxFollowCircleRadius = (float)(slider.Radius * 3);
+            float approxFollowCircleRadius = (float)(slider.Radius * 2.4);
             var computeVertex = new Action<double>(t =>
             {
                 double progress = (t - slider.StartTime) / slider.SpanDuration;
diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
index 9f30c00f39..b93dc52581 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
@@ -29,8 +29,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
         private const double wide_angle_multiplier = 1.0;
         private const double acute_angle_multiplier = 1.0;
         private const double rhythm_variance_multiplier = 1.0;
-        private const double slider_multiplier = 6.5;
-        private const double slider_jump_multiplier = 0.875;
+        private const double slider_multiplier = 4.25;
 
         protected override double StrainValueOf(DifficultyHitObject current)
         {
@@ -90,7 +89,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
 
             if (osuCurrObj.TravelDistance != 0)
             {
-                double sliderBonus = Math.Max(osuCurrObj.TravelDistance, slider_jump_multiplier * Math.Sqrt(osuCurrObj.TravelDistance * osuCurrObj.JumpDistance)) / osuCurrObj.StrainTime;
+                double sliderBonus = (Math.Max(0, Vector2.Subtract(osuCurrObj.TravelVector, osuCurrObj.JumpVector).Length - osuCurrObj.JumpDistance) + osuCurrObj.TravelDistance) / osuCurrObj.StrainTime;
 
                 // Add in slider velocity.
                 aimStrain += sliderBonus * slider_multiplier;

From e4fb5a01c93ce43fc8fd3993b9a1adf50b00a965 Mon Sep 17 00:00:00 2001
From: Xexxar <xexxar.xexxar@gmail.com>
Date: Sun, 26 Sep 2021 21:58:26 +0000
Subject: [PATCH 0087/5547] readded missing aim nerf for low acc

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

diff --git a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
index bf4d92652c..e936fa14d9 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
@@ -114,8 +114,8 @@ namespace osu.Game.Rulesets.Osu.Difficulty
 
             aimValue *= approachRateBonus;
 
-            // Scale the aim value with accuracy _slightly_.
-            aimValue *= 0.5 + accuracy / 2.0;
+            // Scale the aim value with accuracy
+            aimValue *= accuracy;
             // It is important to also consider accuracy difficulty when doing that.
             aimValue *= 0.98 + Math.Pow(Attributes.OverallDifficulty, 2) / 2500;
 

From 7001578045e509ba12c06ca9e3afa50e60182cb2 Mon Sep 17 00:00:00 2001
From: Xexxar <38889014+Xexxar@users.noreply.github.com>
Date: Sun, 26 Sep 2021 20:39:57 -0500
Subject: [PATCH 0088/5547] Update
 osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.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>
---
 .../Difficulty/Preprocessing/OsuDifficultyHitObject.cs          | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
index 52f18539c4..b9ba6364af 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
@@ -38,7 +38,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
         public double? Angle { get; private set; }
 
         /// <summary>
-        /// Milliseconds elapsed since the start time of the previous <see cref="OsuDifficultyHitObject"/>, with a minimum of 50ms.
+        /// Milliseconds elapsed since the start time of the previous <see cref="OsuDifficultyHitObject"/>, with a minimum of 25ms.
         /// </summary>
         public readonly double StrainTime;
 

From b82ed3f1674520ae8680e845d873eb88d39130d5 Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Fri, 8 Oct 2021 14:23:53 +0900
Subject: [PATCH 0089/5547] Fix potential blocking operation on
 OrderByTotalScoreAsync()

In reality this wouldn't be a long process, but the blocking is really
noticeable if you add a Task.Delay(1000) in GetTotalScoreAsync().
---
 osu.Game/Scoring/ScoreManager.cs | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Scoring/ScoreManager.cs b/osu.Game/Scoring/ScoreManager.cs
index dde956233b..5481eea4aa 100644
--- a/osu.Game/Scoring/ScoreManager.cs
+++ b/osu.Game/Scoring/ScoreManager.cs
@@ -72,9 +72,12 @@ namespace osu.Game.Scoring
                 }
             }
 
-            // We're calling .Result, but this should not be a blocking call due to the above GetDifficultyAsync() calls.
-            return scores.OrderByDescending(s => GetTotalScoreAsync(s, cancellationToken: cancellationToken).Result)
-                         .ThenBy(s => s.OnlineScoreID)
+            var totalScores = await Task.WhenAll(scores.Select(s => GetTotalScoreAsync(s, cancellationToken: cancellationToken))).ConfigureAwait(false);
+
+            return scores.Select((s, i) => (index: i, score: s))
+                         .OrderByDescending(key => totalScores[key.index])
+                         .ThenBy(key => key.score.OnlineScoreID)
+                         .Select(key => key.score)
                          .ToArray();
         }
 

From d6ac6a5cd60263ae778ebb488541e1a28a65a1c8 Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Fri, 8 Oct 2021 15:18:01 +0900
Subject: [PATCH 0090/5547] Fix intermittent results screen test failures

---
 .../TestScenePlaylistsResultsScreen.cs        | 23 +++++++++++--------
 1 file changed, 14 insertions(+), 9 deletions(-)

diff --git a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsResultsScreen.cs b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsResultsScreen.cs
index 4bcc887b9f..d948aebbbf 100644
--- a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsResultsScreen.cs
+++ b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsResultsScreen.cs
@@ -32,12 +32,14 @@ namespace osu.Game.Tests.Visual.Playlists
         private TestResultsScreen resultsScreen;
         private int currentScoreId;
         private bool requestComplete;
+        private int totalCount;
 
         [SetUp]
         public void Setup() => Schedule(() =>
         {
             currentScoreId = 0;
             requestComplete = false;
+            totalCount = 0;
             bindHandler();
         });
 
@@ -53,7 +55,6 @@ namespace osu.Game.Tests.Visual.Playlists
             });
 
             createResults(() => userScore);
-            waitForDisplay();
 
             AddAssert("user score selected", () => this.ChildrenOfType<ScorePanel>().Single(p => p.Score.OnlineScoreID == userScore.OnlineScoreID).State == PanelState.Expanded);
         }
@@ -62,7 +63,6 @@ namespace osu.Game.Tests.Visual.Playlists
         public void TestShowNullUserScore()
         {
             createResults();
-            waitForDisplay();
 
             AddAssert("top score selected", () => this.ChildrenOfType<ScorePanel>().OrderByDescending(p => p.Score.TotalScore).First().State == PanelState.Expanded);
         }
@@ -79,7 +79,6 @@ namespace osu.Game.Tests.Visual.Playlists
             });
 
             createResults(() => userScore);
-            waitForDisplay();
 
             AddAssert("more than 1 panel displayed", () => this.ChildrenOfType<ScorePanel>().Count() > 1);
             AddAssert("user score selected", () => this.ChildrenOfType<ScorePanel>().Single(p => p.Score.OnlineScoreID == userScore.OnlineScoreID).State == PanelState.Expanded);
@@ -91,7 +90,6 @@ namespace osu.Game.Tests.Visual.Playlists
             AddStep("bind delayed handler", () => bindHandler(true));
 
             createResults();
-            waitForDisplay();
 
             AddAssert("top score selected", () => this.ChildrenOfType<ScorePanel>().OrderByDescending(p => p.Score.TotalScore).First().State == PanelState.Expanded);
         }
@@ -100,7 +98,6 @@ namespace osu.Game.Tests.Visual.Playlists
         public void TestFetchWhenScrolledToTheRight()
         {
             createResults();
-            waitForDisplay();
 
             AddStep("bind delayed handler", () => bindHandler(true));
 
@@ -131,7 +128,6 @@ namespace osu.Game.Tests.Visual.Playlists
             });
 
             createResults(() => userScore);
-            waitForDisplay();
 
             AddStep("bind delayed handler", () => bindHandler(true));
 
@@ -161,13 +157,15 @@ namespace osu.Game.Tests.Visual.Playlists
                 }));
             });
 
-            AddUntilStep("wait for load", () => resultsScreen.ChildrenOfType<ScorePanelList>().FirstOrDefault()?.AllPanelsVisible == true);
+            waitForDisplay();
         }
 
         private void waitForDisplay()
         {
-            AddUntilStep("wait for request to complete", () => requestComplete);
-            AddUntilStep("wait for panels to be visible", () => resultsScreen.ChildrenOfType<ScorePanelList>().FirstOrDefault()?.AllPanelsVisible == true);
+            AddUntilStep("wait for load to complete", () =>
+                requestComplete
+                && resultsScreen.ScorePanelList.GetScorePanels().Count() == totalCount
+                && resultsScreen.ScorePanelList.AllPanelsVisible);
             AddWaitStep("wait for display", 5);
         }
 
@@ -203,6 +201,7 @@ namespace osu.Game.Tests.Visual.Playlists
                             triggerFail(s);
                         else
                             triggerSuccess(s, createUserResponse(userScore));
+
                         break;
 
                     case IndexPlaylistScoresRequest i:
@@ -248,6 +247,8 @@ namespace osu.Game.Tests.Visual.Playlists
                 }
             };
 
+            totalCount++;
+
             for (int i = 1; i <= scores_per_result; i++)
             {
                 multiplayerUserScore.ScoresAround.Lower.Scores.Add(new MultiplayerScore
@@ -285,6 +286,8 @@ namespace osu.Game.Tests.Visual.Playlists
                     },
                     Statistics = userScore.Statistics
                 });
+
+                totalCount += 2;
             }
 
             addCursor(multiplayerUserScore.ScoresAround.Lower);
@@ -325,6 +328,8 @@ namespace osu.Game.Tests.Visual.Playlists
                         { HitResult.Great, 300 }
                     }
                 });
+
+                totalCount++;
             }
 
             addCursor(result);

From f199d6c5212c360fb9c2c16b70d21d3e9730c7dd Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Fri, 8 Oct 2021 15:26:25 +0900
Subject: [PATCH 0091/5547] Fix another related test failure

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

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
index 189b143a35..9a75d3c309 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
@@ -163,7 +163,6 @@ namespace osu.Game.Tests.Visual.UserInterface
             });
 
             AddUntilStep("wait for fetch", () => leaderboard.Scores != null);
-
             AddUntilStep("score removed from leaderboard", () => leaderboard.Scores.All(s => s.OnlineScoreID != scoreBeingDeleted.OnlineScoreID));
         }
 
@@ -171,6 +170,7 @@ namespace osu.Game.Tests.Visual.UserInterface
         public void TestDeleteViaDatabase()
         {
             AddStep("delete top score", () => scoreManager.Delete(importedScores[0]));
+            AddUntilStep("wait for fetch", () => leaderboard.Scores != null);
             AddUntilStep("score removed from leaderboard", () => leaderboard.Scores.All(s => s.OnlineScoreID != importedScores[0].OnlineScoreID));
         }
     }

From b72b071c257f8e66e9cf8bc7d947c6f6107db9b1 Mon Sep 17 00:00:00 2001
From: StanR <hi@stanr.info>
Date: Sat, 9 Oct 2021 12:35:17 +0300
Subject: [PATCH 0092/5547] Fix instant spinners giving insane amounts of
 strain

---
 .../Preprocessing/OsuDifficultyHitObject.cs   | 29 ++++++++++---------
 1 file changed, 16 insertions(+), 13 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
index 8e8f9bc06e..6574fd388d 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
@@ -69,23 +69,26 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
                 TravelDistance = lastSlider.LazyTravelDistance * scalingFactor;
             }
 
-            Vector2 lastCursorPosition = getEndCursorPosition(lastObject);
-
-            // Don't need to jump to reach spinners
-            if (!(BaseObject is Spinner))
-                JumpDistance = (BaseObject.StackedPosition * scalingFactor - lastCursorPosition * scalingFactor).Length;
-
-            if (lastLastObject != null)
+            if (!(lastObject is Spinner))
             {
-                Vector2 lastLastCursorPosition = getEndCursorPosition(lastLastObject);
+                Vector2 lastCursorPosition = getEndCursorPosition(lastObject);
 
-                Vector2 v1 = lastLastCursorPosition - lastObject.StackedPosition;
-                Vector2 v2 = BaseObject.StackedPosition - lastCursorPosition;
+                // Don't need to jump to reach spinners
+                if (!(BaseObject is Spinner))
+                    JumpDistance = (BaseObject.StackedPosition * scalingFactor - lastCursorPosition * scalingFactor).Length;
 
-                float dot = Vector2.Dot(v1, v2);
-                float det = v1.X * v2.Y - v1.Y * v2.X;
+                if (lastLastObject != null)
+                {
+                    Vector2 lastLastCursorPosition = getEndCursorPosition(lastLastObject);
 
-                Angle = Math.Abs(Math.Atan2(det, dot));
+                    Vector2 v1 = lastLastCursorPosition - lastObject.StackedPosition;
+                    Vector2 v2 = BaseObject.StackedPosition - lastCursorPosition;
+
+                    float dot = Vector2.Dot(v1, v2);
+                    float det = v1.X * v2.Y - v1.Y * v2.X;
+
+                    Angle = Math.Abs(Math.Atan2(det, dot));
+                }
             }
         }
 

From 3b0b8707fe2e27cddcb740444d6d03628420b5fd Mon Sep 17 00:00:00 2001
From: StanR <hi@stanr.info>
Date: Sat, 9 Oct 2021 20:28:42 +0300
Subject: [PATCH 0093/5547] Reduce nesting, check all objects for spinners

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

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
index 6574fd388d..f4a1ca6f4a 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
@@ -54,6 +54,10 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
 
         private void setDistances()
         {
+            // We don't need to calculate neither angle nor distance when one of the last->curr objects is a spinner
+            if (BaseObject is Spinner || lastObject is Spinner)
+                return;
+
             // We will scale distances by this factor, so we can assume a uniform CircleSize among beatmaps.
             float scalingFactor = normalized_radius / (float)BaseObject.Radius;
 
@@ -69,26 +73,21 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
                 TravelDistance = lastSlider.LazyTravelDistance * scalingFactor;
             }
 
-            if (!(lastObject is Spinner))
+            Vector2 lastCursorPosition = getEndCursorPosition(lastObject);
+
+            JumpDistance = (BaseObject.StackedPosition * scalingFactor - lastCursorPosition * scalingFactor).Length;
+
+            if (lastLastObject != null && !(lastLastObject is Spinner))
             {
-                Vector2 lastCursorPosition = getEndCursorPosition(lastObject);
+                Vector2 lastLastCursorPosition = getEndCursorPosition(lastLastObject);
 
-                // Don't need to jump to reach spinners
-                if (!(BaseObject is Spinner))
-                    JumpDistance = (BaseObject.StackedPosition * scalingFactor - lastCursorPosition * scalingFactor).Length;
+                Vector2 v1 = lastLastCursorPosition - lastObject.StackedPosition;
+                Vector2 v2 = BaseObject.StackedPosition - lastCursorPosition;
 
-                if (lastLastObject != null)
-                {
-                    Vector2 lastLastCursorPosition = getEndCursorPosition(lastLastObject);
+                float dot = Vector2.Dot(v1, v2);
+                float det = v1.X * v2.Y - v1.Y * v2.X;
 
-                    Vector2 v1 = lastLastCursorPosition - lastObject.StackedPosition;
-                    Vector2 v2 = BaseObject.StackedPosition - lastCursorPosition;
-
-                    float dot = Vector2.Dot(v1, v2);
-                    float det = v1.X * v2.Y - v1.Y * v2.X;
-
-                    Angle = Math.Abs(Math.Atan2(det, dot));
-                }
+                Angle = Math.Abs(Math.Atan2(det, dot));
             }
         }
 

From abd32e30f16521ba1f1df33c8ba4224bab3ca2d5 Mon Sep 17 00:00:00 2001
From: StanR <hi@stanr.info>
Date: Sat, 9 Oct 2021 21:11:24 +0300
Subject: [PATCH 0094/5547] Update
 osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs

Co-authored-by: Liam DeVoe <orionldevoe@gmail.com>
---
 .../Difficulty/Preprocessing/OsuDifficultyHitObject.cs          | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
index f4a1ca6f4a..5e5993aefe 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
@@ -54,7 +54,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
 
         private void setDistances()
         {
-            // We don't need to calculate neither angle nor distance when one of the last->curr objects is a spinner
+            // We don't need to calculate either angle or distance when one of the last->curr objects is a spinner
             if (BaseObject is Spinner || lastObject is Spinner)
                 return;
 

From c49d0a501335832ecef06f02a79750cdf6c1ec97 Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Sun, 10 Oct 2021 15:43:24 +0900
Subject: [PATCH 0095/5547] Rewrite query to be easier to understand

---
 osu.Game/Scoring/ScoreManager.cs | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Scoring/ScoreManager.cs b/osu.Game/Scoring/ScoreManager.cs
index 5481eea4aa..236e8a4448 100644
--- a/osu.Game/Scoring/ScoreManager.cs
+++ b/osu.Game/Scoring/ScoreManager.cs
@@ -74,10 +74,9 @@ namespace osu.Game.Scoring
 
             var totalScores = await Task.WhenAll(scores.Select(s => GetTotalScoreAsync(s, cancellationToken: cancellationToken))).ConfigureAwait(false);
 
-            return scores.Select((s, i) => (index: i, score: s))
-                         .OrderByDescending(key => totalScores[key.index])
-                         .ThenBy(key => key.score.OnlineScoreID)
-                         .Select(key => key.score)
+            return scores.Select((score, index) => (score: score, totalScore: totalScores[index]))
+                         .OrderByDescending(g => g.totalScore)
+                         .Select(g => g.score)
                          .ToArray();
         }
 

From 4475697a9c55897219fc79cf032f2f3da2b5d2ee Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Sun, 10 Oct 2021 15:47:39 +0900
Subject: [PATCH 0096/5547] Add score id key

---
 osu.Game/Scoring/ScoreManager.cs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Game/Scoring/ScoreManager.cs b/osu.Game/Scoring/ScoreManager.cs
index 236e8a4448..c5d475d631 100644
--- a/osu.Game/Scoring/ScoreManager.cs
+++ b/osu.Game/Scoring/ScoreManager.cs
@@ -76,6 +76,7 @@ namespace osu.Game.Scoring
 
             return scores.Select((score, index) => (score: score, totalScore: totalScores[index]))
                          .OrderByDescending(g => g.totalScore)
+                         .ThenBy(g => g.score.OnlineScoreID)
                          .Select(g => g.score)
                          .ToArray();
         }

From 49a878dc20ce004169333f86021e02f528a6cf9b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 10 Oct 2021 16:04:41 +0900
Subject: [PATCH 0097/5547] Fix comma separator support not actually working

---
 osu.Game/Graphics/UserInterface/ScoreCounter.cs | 11 ++++++++---
 1 file changed, 8 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Graphics/UserInterface/ScoreCounter.cs b/osu.Game/Graphics/UserInterface/ScoreCounter.cs
index 7ebf3819e4..069810d736 100644
--- a/osu.Game/Graphics/UserInterface/ScoreCounter.cs
+++ b/osu.Game/Graphics/UserInterface/ScoreCounter.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.Graphics;
 using osu.Framework.Localisation;
@@ -29,6 +30,9 @@ namespace osu.Game.Graphics.UserInterface
         {
             UseCommaSeparator = useCommaSeparator;
 
+            if (useCommaSeparator && leading > 0)
+                throw new ArgumentException("Should not mix leading zeroes and comma separators as it doesn't make sense");
+
             RequiredDisplayDigits.Value = leading;
             RequiredDisplayDigits.BindValueChanged(_ => UpdateDisplay());
         }
@@ -41,14 +45,15 @@ namespace osu.Game.Graphics.UserInterface
         protected override LocalisableString FormatCount(double count)
         {
             string format = new string('0', RequiredDisplayDigits.Value);
+            var output = ((long)count).ToString(format);
 
             if (UseCommaSeparator)
             {
-                for (int i = format.Length - 3; i > 0; i -= 3)
-                    format = format.Insert(i, @",");
+                for (int i = output.Length - 3; i > 0; i -= 3)
+                    output = output.Insert(i, @",");
             }
 
-            return ((long)count).ToString(format);
+            return output;
         }
 
         protected override OsuSpriteText CreateSpriteText()

From 446f091d329db500d7915aa53d75bb8232a6a3f5 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 10 Oct 2021 16:06:12 +0900
Subject: [PATCH 0098/5547] Use comma separator for tournament score displays

---
 .../Gameplay/Components/TournamentMatchScoreDisplay.cs       | 1 +
 osu.Game/Screens/Play/HUD/MatchScoreDisplay.cs               | 5 +----
 2 files changed, 2 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Tournament/Screens/Gameplay/Components/TournamentMatchScoreDisplay.cs b/osu.Game.Tournament/Screens/Gameplay/Components/TournamentMatchScoreDisplay.cs
index 994dee4da0..3624c08187 100644
--- a/osu.Game.Tournament/Screens/Gameplay/Components/TournamentMatchScoreDisplay.cs
+++ b/osu.Game.Tournament/Screens/Gameplay/Components/TournamentMatchScoreDisplay.cs
@@ -132,6 +132,7 @@ namespace osu.Game.Tournament.Screens.Gameplay.Components
             private OsuSpriteText displayedSpriteText;
 
             public MatchScoreCounter()
+                : base(useCommaSeparator: true)
             {
                 Margin = new MarginPadding { Top = bar_height, Horizontal = 10 };
             }
diff --git a/osu.Game/Screens/Play/HUD/MatchScoreDisplay.cs b/osu.Game/Screens/Play/HUD/MatchScoreDisplay.cs
index d04e60a2ab..37282205f4 100644
--- a/osu.Game/Screens/Play/HUD/MatchScoreDisplay.cs
+++ b/osu.Game/Screens/Play/HUD/MatchScoreDisplay.cs
@@ -4,11 +4,9 @@
 using System;
 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.Shapes;
-using osu.Framework.Localisation;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.UserInterface;
@@ -153,6 +151,7 @@ namespace osu.Game.Screens.Play.HUD
             private OsuSpriteText displayedSpriteText;
 
             public MatchScoreCounter()
+                : base(useCommaSeparator: true)
             {
                 Margin = new MarginPadding { Top = bar_height, Horizontal = 10 };
             }
@@ -173,8 +172,6 @@ namespace osu.Game.Screens.Play.HUD
                 => displayedSpriteText.Font = winning
                     ? OsuFont.Torus.With(weight: FontWeight.Bold, size: font_size, fixedWidth: true)
                     : OsuFont.Torus.With(weight: FontWeight.Regular, size: font_size * 0.8f, fixedWidth: true);
-
-            protected override LocalisableString FormatCount(double count) => count.ToLocalisableString(@"N0");
         }
     }
 }

From 6d6de5b677353235e9a667c17964ef30fb2d1b73 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 10 Oct 2021 16:50:55 +0900
Subject: [PATCH 0099/5547] Remove redundant tuple naming

---
 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 c5d475d631..cf22a8fda4 100644
--- a/osu.Game/Scoring/ScoreManager.cs
+++ b/osu.Game/Scoring/ScoreManager.cs
@@ -74,7 +74,7 @@ namespace osu.Game.Scoring
 
             var totalScores = await Task.WhenAll(scores.Select(s => GetTotalScoreAsync(s, cancellationToken: cancellationToken))).ConfigureAwait(false);
 
-            return scores.Select((score, index) => (score: score, totalScore: totalScores[index]))
+            return scores.Select((score, index) => (score, totalScore: totalScores[index]))
                          .OrderByDescending(g => g.totalScore)
                          .ThenBy(g => g.score.OnlineScoreID)
                          .Select(g => g.score)

From 06cce0119c4549cd0f67c98fe08a617cda470040 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 10 Oct 2021 17:41:16 +0900
Subject: [PATCH 0100/5547] Use localisable format string for comma separator
 mode

---
 .../Graphics/UserInterface/ScoreCounter.cs    | 39 ++++++++-----------
 .../Screens/Play/HUD/DefaultScoreCounter.cs   |  1 -
 .../Screens/Play/HUD/GameplayScoreCounter.cs  |  4 +-
 osu.Game/Skinning/LegacyScoreCounter.cs       |  1 -
 4 files changed, 19 insertions(+), 26 deletions(-)

diff --git a/osu.Game/Graphics/UserInterface/ScoreCounter.cs b/osu.Game/Graphics/UserInterface/ScoreCounter.cs
index 069810d736..778b0ecbc6 100644
--- a/osu.Game/Graphics/UserInterface/ScoreCounter.cs
+++ b/osu.Game/Graphics/UserInterface/ScoreCounter.cs
@@ -3,6 +3,7 @@
 
 using System;
 using osu.Framework.Bindables;
+using osu.Framework.Extensions.LocalisationExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Localisation;
 using osu.Game.Graphics.Sprites;
@@ -14,13 +15,10 @@ namespace osu.Game.Graphics.UserInterface
         protected override double RollingDuration => 1000;
         protected override Easing RollingEasing => Easing.Out;
 
-        /// <summary>
-        /// Whether comma separators should be displayed.
-        /// </summary>
-        public bool UseCommaSeparator { get; }
-
         public Bindable<int> RequiredDisplayDigits { get; } = new Bindable<int>();
 
+        private string formatString = string.Empty;
+
         /// <summary>
         /// Displays score.
         /// </summary>
@@ -28,13 +26,22 @@ namespace osu.Game.Graphics.UserInterface
         /// <param name="useCommaSeparator">Whether comma separators should be displayed.</param>
         protected ScoreCounter(int leading = 0, bool useCommaSeparator = false)
         {
-            UseCommaSeparator = useCommaSeparator;
+            if (useCommaSeparator)
+            {
+                if (leading > 0)
+                    throw new ArgumentException("Should not mix leading zeroes and comma separators as it doesn't make sense");
 
-            if (useCommaSeparator && leading > 0)
-                throw new ArgumentException("Should not mix leading zeroes and comma separators as it doesn't make sense");
+                formatString = @"N0";
+            }
 
             RequiredDisplayDigits.Value = leading;
-            RequiredDisplayDigits.BindValueChanged(_ => UpdateDisplay());
+            RequiredDisplayDigits.BindValueChanged(displayDigitsChanged, true);
+        }
+
+        private void displayDigitsChanged(ValueChangedEvent<int> _)
+        {
+            formatString = new string('0', RequiredDisplayDigits.Value);
+            UpdateDisplay();
         }
 
         protected override double GetProportionalDuration(double currentValue, double newValue)
@@ -42,19 +49,7 @@ namespace osu.Game.Graphics.UserInterface
             return currentValue > newValue ? currentValue - newValue : newValue - currentValue;
         }
 
-        protected override LocalisableString FormatCount(double count)
-        {
-            string format = new string('0', RequiredDisplayDigits.Value);
-            var output = ((long)count).ToString(format);
-
-            if (UseCommaSeparator)
-            {
-                for (int i = output.Length - 3; i > 0; i -= 3)
-                    output = output.Insert(i, @",");
-            }
-
-            return output;
-        }
+        protected override LocalisableString FormatCount(double count) => ((long)count).ToLocalisableString(formatString);
 
         protected override OsuSpriteText CreateSpriteText()
             => base.CreateSpriteText().With(s => s.Font = s.Font.With(fixedWidth: true));
diff --git a/osu.Game/Screens/Play/HUD/DefaultScoreCounter.cs b/osu.Game/Screens/Play/HUD/DefaultScoreCounter.cs
index 63de5c8de5..87b19e8433 100644
--- a/osu.Game/Screens/Play/HUD/DefaultScoreCounter.cs
+++ b/osu.Game/Screens/Play/HUD/DefaultScoreCounter.cs
@@ -11,7 +11,6 @@ namespace osu.Game.Screens.Play.HUD
     public class DefaultScoreCounter : GameplayScoreCounter, ISkinnableDrawable
     {
         public DefaultScoreCounter()
-            : base(6)
         {
             Anchor = Anchor.TopCentre;
             Origin = Anchor.TopCentre;
diff --git a/osu.Game/Screens/Play/HUD/GameplayScoreCounter.cs b/osu.Game/Screens/Play/HUD/GameplayScoreCounter.cs
index e09630d2c4..e05eff5f3e 100644
--- a/osu.Game/Screens/Play/HUD/GameplayScoreCounter.cs
+++ b/osu.Game/Screens/Play/HUD/GameplayScoreCounter.cs
@@ -14,8 +14,8 @@ namespace osu.Game.Screens.Play.HUD
     {
         private Bindable<ScoringMode> scoreDisplayMode;
 
-        protected GameplayScoreCounter(int leading = 0, bool useCommaSeparator = false)
-            : base(leading, useCommaSeparator)
+        protected GameplayScoreCounter()
+            : base(6)
         {
         }
 
diff --git a/osu.Game/Skinning/LegacyScoreCounter.cs b/osu.Game/Skinning/LegacyScoreCounter.cs
index a12defe87e..0c9a82074f 100644
--- a/osu.Game/Skinning/LegacyScoreCounter.cs
+++ b/osu.Game/Skinning/LegacyScoreCounter.cs
@@ -16,7 +16,6 @@ namespace osu.Game.Skinning
         public bool UsesFixedAnchor { get; set; }
 
         public LegacyScoreCounter()
-            : base(6)
         {
             Anchor = Anchor.TopRight;
             Origin = Anchor.TopRight;

From 794b4c46cf9c93ddf9c1294a722f3e4114d11e0d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 10 Oct 2021 17:56:32 +0900
Subject: [PATCH 0101/5547] Split score counter class into two distinct classes
 to simplify usages

---
 .../Components/TournamentMatchScoreDisplay.cs |  3 +--
 .../CommaSeparatedScoreCounter.cs             | 24 +++++++++++++++++++
 .../Graphics/UserInterface/ScoreCounter.cs    | 20 ++++------------
 .../Screens/Play/HUD/MatchScoreDisplay.cs     |  3 +--
 4 files changed, 30 insertions(+), 20 deletions(-)
 create mode 100644 osu.Game/Graphics/UserInterface/CommaSeparatedScoreCounter.cs

diff --git a/osu.Game.Tournament/Screens/Gameplay/Components/TournamentMatchScoreDisplay.cs b/osu.Game.Tournament/Screens/Gameplay/Components/TournamentMatchScoreDisplay.cs
index 3624c08187..77101e4023 100644
--- a/osu.Game.Tournament/Screens/Gameplay/Components/TournamentMatchScoreDisplay.cs
+++ b/osu.Game.Tournament/Screens/Gameplay/Components/TournamentMatchScoreDisplay.cs
@@ -127,12 +127,11 @@ namespace osu.Game.Tournament.Screens.Gameplay.Components
             score2Text.X = Math.Max(5 + score2Text.DrawWidth / 2, score2Bar.DrawWidth);
         }
 
-        private class MatchScoreCounter : ScoreCounter
+        private class MatchScoreCounter : CommaSeparatedScoreCounter
         {
             private OsuSpriteText displayedSpriteText;
 
             public MatchScoreCounter()
-                : base(useCommaSeparator: true)
             {
                 Margin = new MarginPadding { Top = bar_height, Horizontal = 10 };
             }
diff --git a/osu.Game/Graphics/UserInterface/CommaSeparatedScoreCounter.cs b/osu.Game/Graphics/UserInterface/CommaSeparatedScoreCounter.cs
new file mode 100644
index 0000000000..4e1c612f09
--- /dev/null
+++ b/osu.Game/Graphics/UserInterface/CommaSeparatedScoreCounter.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.Extensions.LocalisationExtensions;
+using osu.Framework.Graphics;
+using osu.Framework.Localisation;
+using osu.Game.Graphics.Sprites;
+
+namespace osu.Game.Graphics.UserInterface
+{
+    public abstract class CommaSeparatedScoreCounter : RollingCounter<double>
+    {
+        protected override double RollingDuration => 1000;
+        protected override Easing RollingEasing => Easing.Out;
+
+        protected override double GetProportionalDuration(double currentValue, double newValue) =>
+            currentValue > newValue ? currentValue - newValue : newValue - currentValue;
+
+        protected override LocalisableString FormatCount(double count) => ((long)count).ToLocalisableString(@"N0");
+
+        protected override OsuSpriteText CreateSpriteText()
+            => base.CreateSpriteText().With(s => s.Font = s.Font.With(fixedWidth: true));
+    }
+}
diff --git a/osu.Game/Graphics/UserInterface/ScoreCounter.cs b/osu.Game/Graphics/UserInterface/ScoreCounter.cs
index 778b0ecbc6..25f19aa0a9 100644
--- a/osu.Game/Graphics/UserInterface/ScoreCounter.cs
+++ b/osu.Game/Graphics/UserInterface/ScoreCounter.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.Bindables;
 using osu.Framework.Extensions.LocalisationExtensions;
 using osu.Framework.Graphics;
@@ -17,23 +16,14 @@ namespace osu.Game.Graphics.UserInterface
 
         public Bindable<int> RequiredDisplayDigits { get; } = new Bindable<int>();
 
-        private string formatString = string.Empty;
+        private string formatString;
 
         /// <summary>
         /// Displays score.
         /// </summary>
         /// <param name="leading">How many leading zeroes the counter will have.</param>
-        /// <param name="useCommaSeparator">Whether comma separators should be displayed.</param>
-        protected ScoreCounter(int leading = 0, bool useCommaSeparator = false)
+        protected ScoreCounter(int leading = 0)
         {
-            if (useCommaSeparator)
-            {
-                if (leading > 0)
-                    throw new ArgumentException("Should not mix leading zeroes and comma separators as it doesn't make sense");
-
-                formatString = @"N0";
-            }
-
             RequiredDisplayDigits.Value = leading;
             RequiredDisplayDigits.BindValueChanged(displayDigitsChanged, true);
         }
@@ -44,10 +34,8 @@ namespace osu.Game.Graphics.UserInterface
             UpdateDisplay();
         }
 
-        protected override double GetProportionalDuration(double currentValue, double newValue)
-        {
-            return currentValue > newValue ? currentValue - newValue : newValue - currentValue;
-        }
+        protected override double GetProportionalDuration(double currentValue, double newValue) =>
+            currentValue > newValue ? currentValue - newValue : newValue - currentValue;
 
         protected override LocalisableString FormatCount(double count) => ((long)count).ToLocalisableString(formatString);
 
diff --git a/osu.Game/Screens/Play/HUD/MatchScoreDisplay.cs b/osu.Game/Screens/Play/HUD/MatchScoreDisplay.cs
index 37282205f4..b1c07512dd 100644
--- a/osu.Game/Screens/Play/HUD/MatchScoreDisplay.cs
+++ b/osu.Game/Screens/Play/HUD/MatchScoreDisplay.cs
@@ -146,12 +146,11 @@ namespace osu.Game.Screens.Play.HUD
             Score2Text.X = Math.Max(5 + Score2Text.DrawWidth / 2, score2Bar.DrawWidth);
         }
 
-        protected class MatchScoreCounter : ScoreCounter
+        protected class MatchScoreCounter : CommaSeparatedScoreCounter
         {
             private OsuSpriteText displayedSpriteText;
 
             public MatchScoreCounter()
-                : base(useCommaSeparator: true)
             {
                 Margin = new MarginPadding { Top = bar_height, Horizontal = 10 };
             }

From 21ee24ea6d82ab5b8f42700f1829673f18d79add Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 10 Oct 2021 20:21:41 +0200
Subject: [PATCH 0102/5547] Add rounded button variant

---
 .../UserInterface/TestSceneRoundedButton.cs   | 44 +++++++++++++++++
 osu.Game/Graphics/OsuColour.cs                |  5 ++
 .../Graphics/UserInterfaceV2/RoundedButton.cs | 48 +++++++++++++++++++
 3 files changed, 97 insertions(+)
 create mode 100644 osu.Game.Tests/Visual/UserInterface/TestSceneRoundedButton.cs
 create mode 100644 osu.Game/Graphics/UserInterfaceV2/RoundedButton.cs

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneRoundedButton.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneRoundedButton.cs
new file mode 100644
index 0000000000..9ccfba7c74
--- /dev/null
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneRoundedButton.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 System;
+using NUnit.Framework;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.Shapes;
+using osu.Game.Graphics.UserInterfaceV2;
+
+namespace osu.Game.Tests.Visual.UserInterface
+{
+    public class TestSceneRoundedButton : OsuTestScene
+    {
+        [Test]
+        public void TestBasic()
+        {
+            RoundedButton button = null;
+
+            AddStep("create button", () => Child = new Container
+            {
+                RelativeSizeAxes = Axes.Both,
+                Children = new Drawable[]
+                {
+                    new Box
+                    {
+                        RelativeSizeAxes = Axes.Both,
+                        Colour = Colour4.DarkGray
+                    },
+                    button = new RoundedButton
+                    {
+                        Width = 400,
+                        Text = "Test button",
+                        Anchor = Anchor.Centre,
+                        Origin = Anchor.Centre,
+                        Action = () => { }
+                    }
+                }
+            });
+
+            AddToggleStep("toggle disabled", disabled => button.Action = disabled ? (Action)null : () => { });
+        }
+    }
+}
diff --git a/osu.Game/Graphics/OsuColour.cs b/osu.Game/Graphics/OsuColour.cs
index d7cfc4094c..c1acdc392c 100644
--- a/osu.Game/Graphics/OsuColour.cs
+++ b/osu.Game/Graphics/OsuColour.cs
@@ -225,6 +225,11 @@ namespace osu.Game.Graphics
         public readonly Color4 GrayE = Color4Extensions.FromHex(@"eee");
         public readonly Color4 GrayF = Color4Extensions.FromHex(@"fff");
 
+        /// <summary>
+        /// Equivalent to <see cref="OverlayColourProvider.Blue"/>'s <see cref="OverlayColourProvider.Colour3"/>.
+        /// </summary>
+        public readonly Color4 Blue3 = Color4Extensions.FromHex(@"3399cc");
+
         /// <summary>
         /// Equivalent to <see cref="OverlayColourProvider.Lime"/>'s <see cref="OverlayColourProvider.Colour1"/>.
         /// </summary>
diff --git a/osu.Game/Graphics/UserInterfaceV2/RoundedButton.cs b/osu.Game/Graphics/UserInterfaceV2/RoundedButton.cs
new file mode 100644
index 0000000000..3782320ead
--- /dev/null
+++ b/osu.Game/Graphics/UserInterfaceV2/RoundedButton.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.Allocation;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Effects;
+using osu.Game.Graphics.UserInterface;
+using osuTK;
+
+namespace osu.Game.Graphics.UserInterfaceV2
+{
+    public class RoundedButton : OsuButton
+    {
+        public override float Height
+        {
+            get => base.Height;
+            set
+            {
+                base.Height = value;
+
+                if (IsLoaded)
+                    updateCornerRadius();
+            }
+        }
+
+        [BackgroundDependencyLoader]
+        private void load(OsuColour colours)
+        {
+            BackgroundColour = colours.Blue3;
+
+            Content.EdgeEffect = new EdgeEffectParameters
+            {
+                Type = EdgeEffectType.Shadow,
+                Offset = new Vector2(0, 2),
+                Radius = 4,
+                Colour = Colour4.Black.Opacity(0.15f)
+            };
+        }
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+            updateCornerRadius();
+        }
+
+        private void updateCornerRadius() => Content.CornerRadius = DrawHeight / 2;
+    }
+}

From b30dd2d4ed97bdbf6cbdd3c06df9d95850405d11 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 10 Oct 2021 20:32:56 +0200
Subject: [PATCH 0103/5547] Use rounded button in settings sidebar

---
 osu.Game/Graphics/OsuColour.cs                |  5 +++++
 .../Graphics/UserInterfaceV2/RoundedButton.cs | 13 ++++++++++++-
 .../Settings/DangerousSettingsButton.cs       |  5 +----
 .../Sections/Input/KeyBindingsSubsection.cs   |  3 +--
 .../Sections/Maintenance/GeneralSettings.cs   | 19 +++++++++----------
 osu.Game/Overlays/Settings/SettingsButton.cs  |  4 ++--
 6 files changed, 30 insertions(+), 19 deletions(-)

diff --git a/osu.Game/Graphics/OsuColour.cs b/osu.Game/Graphics/OsuColour.cs
index c1acdc392c..af2bb26871 100644
--- a/osu.Game/Graphics/OsuColour.cs
+++ b/osu.Game/Graphics/OsuColour.cs
@@ -225,6 +225,11 @@ namespace osu.Game.Graphics
         public readonly Color4 GrayE = Color4Extensions.FromHex(@"eee");
         public readonly Color4 GrayF = Color4Extensions.FromHex(@"fff");
 
+        /// <summary>
+        /// Equivalent to <see cref="OverlayColourProvider.Pink"/>'s <see cref="OverlayColourProvider.Colour3"/>.
+        /// </summary>
+        public readonly Color4 Pink3 = Color4Extensions.FromHex(@"cc3378");
+
         /// <summary>
         /// Equivalent to <see cref="OverlayColourProvider.Blue"/>'s <see cref="OverlayColourProvider.Colour3"/>.
         /// </summary>
diff --git a/osu.Game/Graphics/UserInterfaceV2/RoundedButton.cs b/osu.Game/Graphics/UserInterfaceV2/RoundedButton.cs
index 3782320ead..5cbbc40405 100644
--- a/osu.Game/Graphics/UserInterfaceV2/RoundedButton.cs
+++ b/osu.Game/Graphics/UserInterfaceV2/RoundedButton.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 System.Collections.Generic;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Effects;
 using osu.Game.Graphics.UserInterface;
 using osuTK;
 
 namespace osu.Game.Graphics.UserInterfaceV2
 {
-    public class RoundedButton : OsuButton
+    public class RoundedButton : OsuButton, IFilterable
     {
         public override float Height
         {
@@ -44,5 +46,14 @@ namespace osu.Game.Graphics.UserInterfaceV2
         }
 
         private void updateCornerRadius() => Content.CornerRadius = DrawHeight / 2;
+
+        public virtual IEnumerable<string> FilterTerms => new[] { Text.ToString() };
+
+        public bool MatchingFilter
+        {
+            set => this.FadeTo(value ? 1 : 0);
+        }
+
+        public bool FilteringActive { get; set; }
     }
 }
diff --git a/osu.Game/Overlays/Settings/DangerousSettingsButton.cs b/osu.Game/Overlays/Settings/DangerousSettingsButton.cs
index c02db40eca..4ca3ace8a1 100644
--- a/osu.Game/Overlays/Settings/DangerousSettingsButton.cs
+++ b/osu.Game/Overlays/Settings/DangerousSettingsButton.cs
@@ -14,10 +14,7 @@ namespace osu.Game.Overlays.Settings
         [BackgroundDependencyLoader]
         private void load(OsuColour colours)
         {
-            BackgroundColour = colours.Pink;
-
-            Triangles.ColourDark = colours.PinkDark;
-            Triangles.ColourLight = colours.PinkLight;
+            BackgroundColour = colours.Pink3;
         }
     }
 }
diff --git a/osu.Game/Overlays/Settings/Sections/Input/KeyBindingsSubsection.cs b/osu.Game/Overlays/Settings/Sections/Input/KeyBindingsSubsection.cs
index 39dddbe1e6..2051af6f3c 100644
--- a/osu.Game/Overlays/Settings/Sections/Input/KeyBindingsSubsection.cs
+++ b/osu.Game/Overlays/Settings/Sections/Input/KeyBindingsSubsection.cs
@@ -7,7 +7,6 @@ using osu.Framework.Allocation;
 using osu.Framework.Extensions.IEnumerableExtensions;
 using osu.Framework.Graphics;
 using osu.Game.Database;
-using osu.Game.Graphics.UserInterface;
 using osu.Game.Input.Bindings;
 using osu.Game.Rulesets;
 using osu.Game.Localisation;
@@ -59,7 +58,7 @@ namespace osu.Game.Overlays.Settings.Sections.Input
         }
     }
 
-    public class ResetButton : DangerousTriangleButton
+    public class ResetButton : DangerousSettingsButton
     {
         [BackgroundDependencyLoader]
         private void load()
diff --git a/osu.Game/Overlays/Settings/Sections/Maintenance/GeneralSettings.cs b/osu.Game/Overlays/Settings/Sections/Maintenance/GeneralSettings.cs
index 803c8332c1..43df58a8b1 100644
--- a/osu.Game/Overlays/Settings/Sections/Maintenance/GeneralSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Maintenance/GeneralSettings.cs
@@ -10,7 +10,6 @@ using osu.Framework.Localisation;
 using osu.Game.Beatmaps;
 using osu.Game.Collections;
 using osu.Game.Database;
-using osu.Game.Graphics.UserInterface;
 using osu.Game.Localisation;
 using osu.Game.Scoring;
 using osu.Game.Skinning;
@@ -21,15 +20,15 @@ namespace osu.Game.Overlays.Settings.Sections.Maintenance
     {
         protected override LocalisableString Header => "General";
 
-        private TriangleButton importBeatmapsButton;
-        private TriangleButton importScoresButton;
-        private TriangleButton importSkinsButton;
-        private TriangleButton importCollectionsButton;
-        private TriangleButton deleteBeatmapsButton;
-        private TriangleButton deleteScoresButton;
-        private TriangleButton deleteSkinsButton;
-        private TriangleButton restoreButton;
-        private TriangleButton undeleteButton;
+        private SettingsButton importBeatmapsButton;
+        private SettingsButton importScoresButton;
+        private SettingsButton importSkinsButton;
+        private SettingsButton importCollectionsButton;
+        private SettingsButton deleteBeatmapsButton;
+        private SettingsButton deleteScoresButton;
+        private SettingsButton deleteSkinsButton;
+        private SettingsButton restoreButton;
+        private SettingsButton undeleteButton;
 
         [BackgroundDependencyLoader(permitNulls: true)]
         private void load(BeatmapManager beatmaps, ScoreManager scores, SkinManager skins, [CanBeNull] CollectionManager collectionManager, [CanBeNull] StableImportManager stableImportManager, DialogOverlay dialogOverlay)
diff --git a/osu.Game/Overlays/Settings/SettingsButton.cs b/osu.Game/Overlays/Settings/SettingsButton.cs
index 87b1aa0e46..be7f2de480 100644
--- a/osu.Game/Overlays/Settings/SettingsButton.cs
+++ b/osu.Game/Overlays/Settings/SettingsButton.cs
@@ -6,11 +6,11 @@ using System.Linq;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Cursor;
 using osu.Framework.Localisation;
-using osu.Game.Graphics.UserInterface;
+using osu.Game.Graphics.UserInterfaceV2;
 
 namespace osu.Game.Overlays.Settings
 {
-    public class SettingsButton : TriangleButton, IHasTooltip
+    public class SettingsButton : RoundedButton, IHasTooltip
     {
         public SettingsButton()
         {

From ce864011f20366179cee5281fbf46f0f2b29c234 Mon Sep 17 00:00:00 2001
From: Joehu <madamba.joehu@outlook.com>
Date: Sun, 10 Oct 2021 12:19:56 -0700
Subject: [PATCH 0104/5547] Add ability to change ui scaling via keyboard

---
 osu.Game/OsuGame.cs | 25 +++++++++++++++++++++++++
 1 file changed, 25 insertions(+)

diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index 8a018f17d9..e604e91471 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -986,6 +986,31 @@ namespace osu.Game
             return false;
         }
 
+        public override bool OnPressed(KeyBindingPressEvent<PlatformAction> e)
+        {
+            switch (e.Action)
+            {
+                case PlatformAction.ZoomIn:
+                    adjustUIScaling(1);
+                    return true;
+
+                case PlatformAction.ZoomOut:
+                    adjustUIScaling(-1);
+                    return true;
+
+                case PlatformAction.ZoomDefault:
+                    LocalConfig.GetBindable<float>(OsuSetting.UIScale).SetDefault();
+                    return true;
+            }
+
+            void adjustUIScaling(int amount)
+            {
+                LocalConfig.SetValue(OsuSetting.UIScale, LocalConfig.Get<float>(OsuSetting.UIScale) + (0.05f * amount));
+            }
+
+            return base.OnPressed(e);
+        }
+
         #region Inactive audio dimming
 
         private readonly BindableDouble inactiveVolumeFade = new BindableDouble();

From cce4a41c5d97e2aec83e6e1095424b3cd3a13e3b Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Sun, 10 Oct 2021 19:33:45 -0700
Subject: [PATCH 0105/5547] Add "disabled" common string

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

diff --git a/osu.Game/Localisation/CommonStrings.cs b/osu.Game/Localisation/CommonStrings.cs
index 33a6eb5d58..3ea337c279 100644
--- a/osu.Game/Localisation/CommonStrings.cs
+++ b/osu.Game/Localisation/CommonStrings.cs
@@ -24,6 +24,11 @@ namespace osu.Game.Localisation
         /// </summary>
         public static LocalisableString Enabled => new TranslatableString(getKey(@"enabled"), @"Enabled");
 
+        /// <summary>
+        /// "Disabled"
+        /// </summary>
+        public static LocalisableString Disabled => new TranslatableString(getKey(@"disabled"), @"Disabled");
+
         /// <summary>
         /// "Default"
         /// </summary>

From 545cfc7bf1e2b84304e28caf381e200dcb10d59f Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Sun, 10 Oct 2021 19:35:25 -0700
Subject: [PATCH 0106/5547] Localise tracked setting toasts

---
 osu.Game/Configuration/OsuConfigManager.cs | 10 ++++++----
 osu.Game/Overlays/OSD/Toast.cs             |  8 +++++---
 2 files changed, 11 insertions(+), 7 deletions(-)

diff --git a/osu.Game/Configuration/OsuConfigManager.cs b/osu.Game/Configuration/OsuConfigManager.cs
index 9b0d7f51da..05a18ef88a 100644
--- a/osu.Game/Configuration/OsuConfigManager.cs
+++ b/osu.Game/Configuration/OsuConfigManager.cs
@@ -6,10 +6,12 @@ using System.Diagnostics;
 using osu.Framework.Configuration;
 using osu.Framework.Configuration.Tracking;
 using osu.Framework.Extensions;
+using osu.Framework.Extensions.LocalisationExtensions;
 using osu.Framework.Platform;
 using osu.Framework.Testing;
 using osu.Game.Input;
 using osu.Game.Input.Bindings;
+using osu.Game.Localisation;
 using osu.Game.Overlays;
 using osu.Game.Rulesets.Scoring;
 using osu.Game.Screens.Select;
@@ -185,13 +187,13 @@ namespace osu.Game.Configuration
 
             return new TrackedSettings
             {
-                new TrackedSetting<bool>(OsuSetting.MouseDisableButtons, v => new SettingDescription(!v, "gameplay mouse buttons", v ? "disabled" : "enabled", LookupKeyBindings(GlobalAction.ToggleGameplayMouseButtons))),
-                new TrackedSetting<HUDVisibilityMode>(OsuSetting.HUDVisibilityMode, m => new SettingDescription(m, "HUD Visibility", m.GetDescription(), $"cycle: {LookupKeyBindings(GlobalAction.ToggleInGameInterface)} quick view: {LookupKeyBindings(GlobalAction.HoldForHUD)}")),
-                new TrackedSetting<ScalingMode>(OsuSetting.Scaling, m => new SettingDescription(m, "scaling", m.GetDescription())),
+                new TrackedSetting<bool>(OsuSetting.MouseDisableButtons, v => new SettingDescription(!v, GlobalActionKeyBindingStrings.ToggleGameplayMouseButtons, v ? CommonStrings.Disabled.ToLower() : CommonStrings.Enabled.ToLower(), LookupKeyBindings(GlobalAction.ToggleGameplayMouseButtons))),
+                new TrackedSetting<HUDVisibilityMode>(OsuSetting.HUDVisibilityMode, m => new SettingDescription(m, GameplaySettingsStrings.HUDVisibilityMode, m.GetLocalisableDescription(), $"{GlobalActionKeyBindingStrings.ToggleInGameInterface}: {LookupKeyBindings(GlobalAction.ToggleInGameInterface)} {GlobalActionKeyBindingStrings.HoldForHUD}: {LookupKeyBindings(GlobalAction.HoldForHUD)}")),
+                new TrackedSetting<ScalingMode>(OsuSetting.Scaling, m => new SettingDescription(m, GraphicsSettingsStrings.ScreenScaling, m.GetLocalisableDescription())),
                 new TrackedSetting<int>(OsuSetting.Skin, m =>
                 {
                     string skinName = LookupSkinName(m) ?? string.Empty;
-                    return new SettingDescription(skinName, "skin", skinName, $"random: {LookupKeyBindings(GlobalAction.RandomSkin)}");
+                    return new SettingDescription(skinName, SkinSettingsStrings.SkinSectionHeader, skinName, $"{GlobalActionKeyBindingStrings.RandomSkin}: {LookupKeyBindings(GlobalAction.RandomSkin)}");
                 })
             };
         }
diff --git a/osu.Game/Overlays/OSD/Toast.cs b/osu.Game/Overlays/OSD/Toast.cs
index 4a6316df3f..4221bb1069 100644
--- a/osu.Game/Overlays/OSD/Toast.cs
+++ b/osu.Game/Overlays/OSD/Toast.cs
@@ -1,9 +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 osu.Framework.Extensions.LocalisationExtensions;
 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.Graphics.Sprites;
 using osuTK;
@@ -23,7 +25,7 @@ namespace osu.Game.Overlays.OSD
 
         protected readonly OsuSpriteText ShortcutText;
 
-        protected Toast(string description, string value, string shortcut)
+        protected Toast(LocalisableString description, LocalisableString value, LocalisableString shortcut)
         {
             Anchor = Anchor.Centre;
             Origin = Anchor.Centre;
@@ -60,7 +62,7 @@ namespace osu.Game.Overlays.OSD
                     Spacing = new Vector2(1, 0),
                     Anchor = Anchor.TopCentre,
                     Origin = Anchor.TopCentre,
-                    Text = description.ToUpperInvariant()
+                    Text = description.ToUpper()
                 },
                 ValueText = new OsuSpriteText
                 {
@@ -79,7 +81,7 @@ namespace osu.Game.Overlays.OSD
                     Alpha = 0.3f,
                     Margin = new MarginPadding { Bottom = 15 },
                     Font = OsuFont.GetFont(size: 12, weight: FontWeight.Bold),
-                    Text = string.IsNullOrEmpty(shortcut) ? "NO KEY BOUND" : shortcut.ToUpperInvariant()
+                    Text = string.IsNullOrEmpty(shortcut.ToString()) ? (LocalisableString)"NO KEY BOUND" : shortcut.ToUpper()
                 },
             };
         }

From 7b37b1597640173a1dd51ccc958b8c034d96b7d1 Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Sun, 10 Oct 2021 19:36:50 -0700
Subject: [PATCH 0107/5547] Localise some music action toasts

---
 osu.Game/Overlays/Music/MusicKeyBindingHandler.cs | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Overlays/Music/MusicKeyBindingHandler.cs b/osu.Game/Overlays/Music/MusicKeyBindingHandler.cs
index dba4bf926f..6fb7fb6591 100644
--- a/osu.Game/Overlays/Music/MusicKeyBindingHandler.cs
+++ b/osu.Game/Overlays/Music/MusicKeyBindingHandler.cs
@@ -6,9 +6,11 @@ using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Input.Bindings;
 using osu.Framework.Input.Events;
+using osu.Framework.Localisation;
 using osu.Game.Beatmaps;
 using osu.Game.Configuration;
 using osu.Game.Input.Bindings;
+using osu.Game.Localisation;
 using osu.Game.Overlays.OSD;
 
 namespace osu.Game.Overlays.Music
@@ -43,7 +45,7 @@ namespace osu.Game.Overlays.Music
                     return true;
 
                 case GlobalAction.MusicNext:
-                    musicController.NextTrack(() => onScreenDisplay?.Display(new MusicActionToast("Next track", e.Action)));
+                    musicController.NextTrack(() => onScreenDisplay?.Display(new MusicActionToast(GlobalActionKeyBindingStrings.MusicNext, e.Action)));
 
                     return true;
 
@@ -57,7 +59,7 @@ namespace osu.Game.Overlays.Music
                                 break;
 
                             case PreviousTrackResult.Previous:
-                                onScreenDisplay?.Display(new MusicActionToast("Previous track", e.Action));
+                                onScreenDisplay?.Display(new MusicActionToast(GlobalActionKeyBindingStrings.MusicPrev, e.Action));
                                 break;
                         }
                     });
@@ -76,7 +78,7 @@ namespace osu.Game.Overlays.Music
         {
             private readonly GlobalAction action;
 
-            public MusicActionToast(string value, GlobalAction action)
+            public MusicActionToast(LocalisableString value, GlobalAction action)
                 : base("Music Playback", value, string.Empty)
             {
                 this.action = action;

From af9bb6f27721e63f4e07398833b40b710710f585 Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Sun, 10 Oct 2021 19:37:46 -0700
Subject: [PATCH 0108/5547] Fix padding of shortcut in toast when widest

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

diff --git a/osu.Game/Overlays/OSD/Toast.cs b/osu.Game/Overlays/OSD/Toast.cs
index 4221bb1069..1289943123 100644
--- a/osu.Game/Overlays/OSD/Toast.cs
+++ b/osu.Game/Overlays/OSD/Toast.cs
@@ -67,7 +67,7 @@ namespace osu.Game.Overlays.OSD
                 ValueText = new OsuSpriteText
                 {
                     Font = OsuFont.GetFont(size: 24, weight: FontWeight.Light),
-                    Padding = new MarginPadding { Left = 10, Right = 10 },
+                    Padding = new MarginPadding { Horizontal = 10 },
                     Name = "Value",
                     Anchor = Anchor.Centre,
                     Origin = Anchor.Centre,
@@ -79,7 +79,7 @@ namespace osu.Game.Overlays.OSD
                     Origin = Anchor.BottomCentre,
                     Name = "Shortcut",
                     Alpha = 0.3f,
-                    Margin = new MarginPadding { Bottom = 15 },
+                    Margin = new MarginPadding { Bottom = 15, Horizontal = 10 },
                     Font = OsuFont.GetFont(size: 12, weight: FontWeight.Bold),
                     Text = string.IsNullOrEmpty(shortcut.ToString()) ? (LocalisableString)"NO KEY BOUND" : shortcut.ToUpper()
                 },

From 4b01c23c11a6f2efd8e47ce8950104d6b7e5c49e Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Sun, 10 Oct 2021 19:55:02 -0700
Subject: [PATCH 0109/5547] Track ui scale setting

---
 osu.Game/Configuration/OsuConfigManager.cs | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Configuration/OsuConfigManager.cs b/osu.Game/Configuration/OsuConfigManager.cs
index 05a18ef88a..9aa6372c66 100644
--- a/osu.Game/Configuration/OsuConfigManager.cs
+++ b/osu.Game/Configuration/OsuConfigManager.cs
@@ -194,7 +194,8 @@ namespace osu.Game.Configuration
                 {
                     string skinName = LookupSkinName(m) ?? string.Empty;
                     return new SettingDescription(skinName, SkinSettingsStrings.SkinSectionHeader, skinName, $"{GlobalActionKeyBindingStrings.RandomSkin}: {LookupKeyBindings(GlobalAction.RandomSkin)}");
-                })
+                }),
+                new TrackedSetting<float>(OsuSetting.UIScale, m => new SettingDescription(m, GraphicsSettingsStrings.UIScaling, $"{m.ToString("N2")}x")), // TODO: implement lookup for framework platform key bindings
             };
         }
 

From 3d6602b8df754fb8e1fefcb66d048b6854c336d8 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 11 Oct 2021 14:05:31 +0900
Subject: [PATCH 0110/5547] Ensure `FailAnimation` is disposed synchronously to
 avoid test failures

---
 osu.Game/Screens/Play/Player.cs | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/Play/Player.cs b/osu.Game/Screens/Play/Player.cs
index 090210e611..444bea049b 100644
--- a/osu.Game/Screens/Play/Player.cs
+++ b/osu.Game/Screens/Play/Player.cs
@@ -947,7 +947,7 @@ namespace osu.Game.Screens.Play
 
         public override void OnSuspending(IScreen next)
         {
-            screenSuspension?.Expire();
+            screenSuspension?.RemoveAndDisposeImmediately();
 
             fadeOut();
             base.OnSuspending(next);
@@ -955,7 +955,8 @@ namespace osu.Game.Screens.Play
 
         public override bool OnExiting(IScreen next)
         {
-            screenSuspension?.Expire();
+            screenSuspension?.RemoveAndDisposeImmediately();
+            failAnimation?.RemoveAndDisposeImmediately();
 
             // if arriving here and the results screen preparation task hasn't run, it's safe to say the user has not completed the beatmap.
             if (prepareScoreForDisplayTask == null)

From 6b35ccae95368c6e81aee1835d44cb945b320bc2 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 7 Oct 2021 17:01:37 +0900
Subject: [PATCH 0111/5547] Fix some cases where interface specifications can
 be used but weren't

---
 .../Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs | 6 +++---
 osu.Game/Beatmaps/BeatmapManager.cs                         | 2 +-
 osu.Game/Beatmaps/BeatmapModelDownloader.cs                 | 2 +-
 3 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs b/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
index 79767bc671..558b874234 100644
--- a/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
+++ b/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
@@ -168,14 +168,14 @@ namespace osu.Game.Tests.Online
                 return new TestBeatmapModelManager(this, storage, contextFactory, rulesets, api, host);
             }
 
-            protected override BeatmapModelDownloader CreateBeatmapModelDownloader(BeatmapModelManager modelManager, IAPIProvider api, GameHost host)
+            protected override BeatmapModelDownloader CreateBeatmapModelDownloader(IBeatmapModelManager manager, IAPIProvider api, GameHost host)
             {
-                return new TestBeatmapModelDownloader(modelManager, api, host);
+                return new TestBeatmapModelDownloader(manager, api, host);
             }
 
             internal class TestBeatmapModelDownloader : BeatmapModelDownloader
             {
-                public TestBeatmapModelDownloader(BeatmapModelManager modelManager, IAPIProvider apiProvider, GameHost gameHost)
+                public TestBeatmapModelDownloader(IBeatmapModelManager modelManager, IAPIProvider apiProvider, GameHost gameHost)
                     : base(modelManager, apiProvider, gameHost)
                 {
                 }
diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index 240db22c00..14175f251b 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -54,7 +54,7 @@ namespace osu.Game.Beatmaps
             }
         }
 
-        protected virtual BeatmapModelDownloader CreateBeatmapModelDownloader(BeatmapModelManager modelManager, IAPIProvider api, GameHost host)
+        protected virtual BeatmapModelDownloader CreateBeatmapModelDownloader(IBeatmapModelManager modelManager, IAPIProvider api, GameHost host)
         {
             return new BeatmapModelDownloader(modelManager, api, host);
         }
diff --git a/osu.Game/Beatmaps/BeatmapModelDownloader.cs b/osu.Game/Beatmaps/BeatmapModelDownloader.cs
index ae482eeafd..30dc95a966 100644
--- a/osu.Game/Beatmaps/BeatmapModelDownloader.cs
+++ b/osu.Game/Beatmaps/BeatmapModelDownloader.cs
@@ -13,7 +13,7 @@ namespace osu.Game.Beatmaps
         protected override ArchiveDownloadRequest<BeatmapSetInfo> CreateDownloadRequest(BeatmapSetInfo set, bool minimiseDownloadSize) =>
             new DownloadBeatmapSetRequest(set, minimiseDownloadSize);
 
-        public BeatmapModelDownloader(BeatmapModelManager beatmapModelManager, IAPIProvider api, GameHost host = null)
+        public BeatmapModelDownloader(IBeatmapModelManager beatmapModelManager, IAPIProvider api, GameHost host = null)
             : base(beatmapModelManager, api, host)
         {
         }

From c7675be3eff7130d7862ed26cbda6f1ecf05b2b9 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 8 Oct 2021 14:20:21 +0900
Subject: [PATCH 0112/5547] Fix typo in `IModelImporter`'s xmldoc

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

diff --git a/osu.Game/Database/IModelImporter.cs b/osu.Game/Database/IModelImporter.cs
index e94af01772..8e658cb0f5 100644
--- a/osu.Game/Database/IModelImporter.cs
+++ b/osu.Game/Database/IModelImporter.cs
@@ -10,7 +10,7 @@ using osu.Game.Overlays.Notifications;
 namespace osu.Game.Database
 {
     /// <summary>
-    /// A class which handles importing of asociated models to the game store.
+    /// A class which handles importing of associated models to the game store.
     /// </summary>
     /// <typeparam name="TModel">The model type.</typeparam>
     public interface IModelImporter<TModel> : IPostNotifications

From b9460112929531743485ceaf1875fbd899b3f17d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 8 Oct 2021 15:58:22 +0900
Subject: [PATCH 0113/5547] Update tests to run inside a `GameHost` to allow
 running on update thread

---
 osu.Game.Tests/Database/RealmTest.cs | 76 +++++++++++++++++++---------
 1 file changed, 51 insertions(+), 25 deletions(-)

diff --git a/osu.Game.Tests/Database/RealmTest.cs b/osu.Game.Tests/Database/RealmTest.cs
index 576f901c1a..f5752aa606 100644
--- a/osu.Game.Tests/Database/RealmTest.cs
+++ b/osu.Game.Tests/Database/RealmTest.cs
@@ -4,7 +4,6 @@
 using System;
 using System.Runtime.CompilerServices;
 using System.Threading.Tasks;
-using Nito.AsyncEx;
 using NUnit.Framework;
 using osu.Framework.Logging;
 using osu.Framework.Platform;
@@ -28,42 +27,69 @@ namespace osu.Game.Tests.Database
 
         protected void RunTestWithRealm(Action<RealmContextFactory, Storage> testAction, [CallerMemberName] string caller = "")
         {
-            AsyncContext.Run(() =>
+            using (HeadlessGameHost host = new CleanRunHeadlessGameHost(caller))
             {
-                var testStorage = storage.GetStorageForDirectory(caller);
-
-                using (var realmFactory = new RealmContextFactory(testStorage, caller))
+                host.Run(new RealmTestGame(() =>
                 {
-                    Logger.Log($"Running test using realm file {testStorage.GetFullPath(realmFactory.Filename)}");
-                    testAction(realmFactory, testStorage);
+                    var testStorage = storage.GetStorageForDirectory(caller);
 
-                    realmFactory.Dispose();
+                    using (var realmFactory = new RealmContextFactory(testStorage, caller))
+                    {
+                        Logger.Log($"Running test using realm file {testStorage.GetFullPath(realmFactory.Filename)}");
+                        testAction(realmFactory, testStorage);
 
-                    Logger.Log($"Final database size: {getFileSize(testStorage, realmFactory)}");
-                    realmFactory.Compact();
-                    Logger.Log($"Final database size after compact: {getFileSize(testStorage, realmFactory)}");
-                }
-            });
+                        realmFactory.Dispose();
+
+                        Logger.Log($"Final database size: {getFileSize(testStorage, realmFactory)}");
+                        realmFactory.Compact();
+                        Logger.Log($"Final database size after compact: {getFileSize(testStorage, realmFactory)}");
+                    }
+                }));
+            }
         }
 
         protected void RunTestWithRealmAsync(Func<RealmContextFactory, Storage, Task> testAction, [CallerMemberName] string caller = "")
         {
-            AsyncContext.Run(async () =>
+            using (HeadlessGameHost host = new CleanRunHeadlessGameHost(caller))
             {
-                var testStorage = storage.GetStorageForDirectory(caller);
-
-                using (var realmFactory = new RealmContextFactory(testStorage, caller))
+                host.Run(new RealmTestGame(async () =>
                 {
-                    Logger.Log($"Running test using realm file {testStorage.GetFullPath(realmFactory.Filename)}");
-                    await testAction(realmFactory, testStorage);
+                    var testStorage = storage.GetStorageForDirectory(caller);
 
-                    realmFactory.Dispose();
+                    using (var realmFactory = new RealmContextFactory(testStorage, caller))
+                    {
+                        Logger.Log($"Running test using realm file {testStorage.GetFullPath(realmFactory.Filename)}");
+                        await testAction(realmFactory, testStorage);
 
-                    Logger.Log($"Final database size: {getFileSize(testStorage, realmFactory)}");
-                    realmFactory.Compact();
-                    Logger.Log($"Final database size after compact: {getFileSize(testStorage, realmFactory)}");
-                }
-            });
+                        realmFactory.Dispose();
+
+                        Logger.Log($"Final database size: {getFileSize(testStorage, realmFactory)}");
+                        realmFactory.Compact();
+                    }
+                }));
+            }
+        }
+
+        private class RealmTestGame : Framework.Game
+        {
+            public RealmTestGame(Func<Task> work)
+            {
+                // ReSharper disable once AsyncVoidLambda
+                Scheduler.Add(async () =>
+                {
+                    await work().ConfigureAwait(true);
+                    Exit();
+                });
+            }
+
+            public RealmTestGame(Action work)
+            {
+                Scheduler.Add(() =>
+                {
+                    work();
+                    Exit();
+                });
+            }
         }
 
         private static long getFileSize(Storage testStorage, RealmContextFactory realmFactory)

From f43badabf408dc65fe90dca4f0cfa158c4cf4459 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 11 Oct 2021 15:20:12 +0900
Subject: [PATCH 0114/5547] Add back update thread verification in
 `RealmContextFactory`

---
 osu.Game/Database/RealmContextFactory.cs | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Database/RealmContextFactory.cs b/osu.Game/Database/RealmContextFactory.cs
index 0ff902a8bc..c3810eb441 100644
--- a/osu.Game/Database/RealmContextFactory.cs
+++ b/osu.Game/Database/RealmContextFactory.cs
@@ -135,9 +135,8 @@ namespace osu.Game.Database
             if (IsDisposed)
                 throw new ObjectDisposedException(nameof(RealmContextFactory));
 
-            // TODO: this can be added for safety once we figure how to bypass in test
-            // if (!ThreadSafety.IsUpdateThread)
-            //     throw new InvalidOperationException($"{nameof(BlockAllOperations)} must be called from the update thread.");
+            if (!ThreadSafety.IsUpdateThread)
+                throw new InvalidOperationException($"{nameof(BlockAllOperations)} must be called from the update thread.");
 
             Logger.Log(@"Blocking realm operations.", LoggingTarget.Database);
 

From 6ca415da9f237635686504f1695b8792a719e5f8 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 11 Oct 2021 15:25:00 +0900
Subject: [PATCH 0115/5547] Add basic realm models

Only the file related ones are really required outside of tests, but
seems like as good an opportunity as ever to get the rest of the models
into the game project.
---
 osu.Game/Database/IHasRealmFiles.cs       |  18 ++++
 osu.Game/Database/INamedFile.cs           |  17 +++
 osu.Game/Models/RealmBeatmap.cs           | 122 ++++++++++++++++++++++
 osu.Game/Models/RealmBeatmapDifficulty.cs |  43 ++++++++
 osu.Game/Models/RealmBeatmapMetadata.cs   |  45 ++++++++
 osu.Game/Models/RealmBeatmapSet.cs        |  78 ++++++++++++++
 osu.Game/Models/RealmFile.cs              |  20 ++++
 osu.Game/Models/RealmNamedFileUsage.cs    |  32 ++++++
 osu.Game/Models/RealmRuleset.cs           |  63 +++++++++++
 9 files changed, 438 insertions(+)
 create mode 100644 osu.Game/Database/IHasRealmFiles.cs
 create mode 100644 osu.Game/Database/INamedFile.cs
 create mode 100644 osu.Game/Models/RealmBeatmap.cs
 create mode 100644 osu.Game/Models/RealmBeatmapDifficulty.cs
 create mode 100644 osu.Game/Models/RealmBeatmapMetadata.cs
 create mode 100644 osu.Game/Models/RealmBeatmapSet.cs
 create mode 100644 osu.Game/Models/RealmFile.cs
 create mode 100644 osu.Game/Models/RealmNamedFileUsage.cs
 create mode 100644 osu.Game/Models/RealmRuleset.cs

diff --git a/osu.Game/Database/IHasRealmFiles.cs b/osu.Game/Database/IHasRealmFiles.cs
new file mode 100644
index 0000000000..2adfe73d1e
--- /dev/null
+++ b/osu.Game/Database/IHasRealmFiles.cs
@@ -0,0 +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.Collections.Generic;
+using osu.Game.Models;
+
+namespace osu.Game.Database
+{
+    /// <summary>
+    /// A model that contains a list of files it is responsible for.
+    /// </summary>
+    public interface IHasRealmFiles
+    {
+        IList<RealmNamedFileUsage> Files { get; }
+
+        string Hash { get; set; }
+    }
+}
diff --git a/osu.Game/Database/INamedFile.cs b/osu.Game/Database/INamedFile.cs
new file mode 100644
index 0000000000..9c94aed38c
--- /dev/null
+++ b/osu.Game/Database/INamedFile.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.Models;
+
+namespace osu.Game.Database
+{
+    /// <summary>
+    /// Represent a join model which gives a filename and scope to a <see cref="File"/>.
+    /// </summary>
+    public interface INamedFile
+    {
+        public string Filename { get; set; }
+
+        public RealmFile File { get; set; }
+    }
+}
diff --git a/osu.Game/Models/RealmBeatmap.cs b/osu.Game/Models/RealmBeatmap.cs
new file mode 100644
index 0000000000..09f8dafeb6
--- /dev/null
+++ b/osu.Game/Models/RealmBeatmap.cs
@@ -0,0 +1,122 @@
+// 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;
+using Newtonsoft.Json;
+using osu.Framework.Testing;
+using osu.Game.Beatmaps;
+using osu.Game.Database;
+using osu.Game.Rulesets;
+using Realms;
+
+#nullable enable
+
+namespace osu.Game.Models
+{
+    /// <summary>
+    /// A single beatmap difficulty.
+    /// </summary>
+    [ExcludeFromDynamicCompile]
+    [Serializable]
+    [MapTo("Beatmap")]
+    public class RealmBeatmap : RealmObject, IHasGuidPrimaryKey, IBeatmapInfo
+    {
+        [PrimaryKey]
+        public Guid ID { get; set; } = Guid.NewGuid();
+
+        public string DifficultyName { get; set; } = string.Empty;
+
+        public RealmRuleset Ruleset { get; set; } = null!;
+
+        public RealmBeatmapDifficulty Difficulty { get; set; } = null!;
+
+        public RealmBeatmapMetadata Metadata { get; set; } = null!;
+
+        public RealmBeatmapSet? BeatmapSet { get; set; }
+
+        public BeatmapSetOnlineStatus Status
+        {
+            get => (BeatmapSetOnlineStatus)StatusInt;
+            set => StatusInt = (int)value;
+        }
+
+        [MapTo(nameof(Status))]
+        public int StatusInt { get; set; }
+
+        public int? OnlineID { get; set; }
+
+        public double Length { get; set; }
+
+        public double BPM { get; set; }
+
+        public string Hash { get; set; } = string.Empty;
+
+        public double StarRating { get; set; }
+
+        public string MD5Hash { get; set; } = string.Empty;
+
+        [JsonIgnore]
+        public bool Hidden { get; set; }
+
+        public RealmBeatmap(RealmRuleset ruleset, RealmBeatmapDifficulty difficulty, RealmBeatmapMetadata metadata)
+        {
+            Ruleset = ruleset;
+            Difficulty = difficulty;
+            Metadata = metadata;
+        }
+
+        [UsedImplicitly]
+        private RealmBeatmap()
+        {
+        }
+
+        #region Properties we may not want persisted (but also maybe no harm?)
+
+        public double AudioLeadIn { get; set; }
+
+        public float StackLeniency { get; set; } = 0.7f;
+
+        public bool SpecialStyle { get; set; }
+
+        public bool LetterboxInBreaks { get; set; }
+
+        public bool WidescreenStoryboard { get; set; }
+
+        public bool EpilepsyWarning { get; set; }
+
+        public bool SamplesMatchPlaybackRate { get; set; }
+
+        public double DistanceSpacing { get; set; }
+
+        public int BeatDivisor { get; set; }
+
+        public int GridSize { get; set; }
+
+        public double TimelineZoom { get; set; }
+
+        #endregion
+
+        /// <summary>
+        /// Returns a shallow-clone of this <see cref="RealmBeatmap"/>.
+        /// </summary>
+        public RealmBeatmap Clone() => (RealmBeatmap)MemberwiseClone();
+
+        public bool AudioEquals(RealmBeatmap? other) => other != null
+                                                        && BeatmapSet != null
+                                                        && other.BeatmapSet != null
+                                                        && BeatmapSet.Hash == other.BeatmapSet.Hash
+                                                        && Metadata.AudioFile == other.Metadata.AudioFile;
+
+        public bool BackgroundEquals(RealmBeatmap? other) => other != null
+                                                             && BeatmapSet != null
+                                                             && other.BeatmapSet != null
+                                                             && BeatmapSet.Hash == other.BeatmapSet.Hash
+                                                             && Metadata.BackgroundFile == other.Metadata.BackgroundFile;
+
+        IBeatmapMetadataInfo IBeatmapInfo.Metadata => Metadata;
+        IBeatmapSetInfo? IBeatmapInfo.BeatmapSet => BeatmapSet;
+        IRulesetInfo IBeatmapInfo.Ruleset => Ruleset;
+        IBeatmapDifficultyInfo IBeatmapInfo.Difficulty => Difficulty;
+    }
+}
diff --git a/osu.Game/Models/RealmBeatmapDifficulty.cs b/osu.Game/Models/RealmBeatmapDifficulty.cs
new file mode 100644
index 0000000000..44bfdda491
--- /dev/null
+++ b/osu.Game/Models/RealmBeatmapDifficulty.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 osu.Game.Beatmaps;
+using Realms;
+
+#nullable enable
+
+namespace osu.Game.Models
+{
+    [MapTo("BeatmapDifficulty")]
+    public class RealmBeatmapDifficulty : EmbeddedObject, IBeatmapDifficultyInfo
+    {
+        public float DrainRate { get; set; } = IBeatmapDifficultyInfo.DEFAULT_DIFFICULTY;
+        public float CircleSize { get; set; } = IBeatmapDifficultyInfo.DEFAULT_DIFFICULTY;
+        public float OverallDifficulty { get; set; } = IBeatmapDifficultyInfo.DEFAULT_DIFFICULTY;
+        public float ApproachRate { get; set; } = IBeatmapDifficultyInfo.DEFAULT_DIFFICULTY;
+
+        public double SliderMultiplier { get; set; } = 1;
+        public double SliderTickRate { get; set; } = 1;
+
+        /// <summary>
+        /// Returns a shallow-clone of this <see cref="RealmBeatmapDifficulty"/>.
+        /// </summary>
+        public RealmBeatmapDifficulty Clone()
+        {
+            var diff = new RealmBeatmapDifficulty();
+            CopyTo(diff);
+            return diff;
+        }
+
+        public void CopyTo(RealmBeatmapDifficulty difficulty)
+        {
+            difficulty.ApproachRate = ApproachRate;
+            difficulty.DrainRate = DrainRate;
+            difficulty.CircleSize = CircleSize;
+            difficulty.OverallDifficulty = OverallDifficulty;
+
+            difficulty.SliderMultiplier = SliderMultiplier;
+            difficulty.SliderTickRate = SliderTickRate;
+        }
+    }
+}
diff --git a/osu.Game/Models/RealmBeatmapMetadata.cs b/osu.Game/Models/RealmBeatmapMetadata.cs
new file mode 100644
index 0000000000..00dd120791
--- /dev/null
+++ b/osu.Game/Models/RealmBeatmapMetadata.cs
@@ -0,0 +1,45 @@
+// 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 osu.Framework.Testing;
+using osu.Game.Beatmaps;
+using Realms;
+
+#nullable enable
+
+namespace osu.Game.Models
+{
+    [ExcludeFromDynamicCompile]
+    [Serializable]
+    [MapTo("BeatmapMetadata")]
+    public class RealmBeatmapMetadata : RealmObject, IBeatmapMetadataInfo
+    {
+        public string Title { get; set; } = string.Empty;
+
+        [JsonProperty("title_unicode")]
+        public string TitleUnicode { get; set; } = string.Empty;
+
+        public string Artist { get; set; } = string.Empty;
+
+        [JsonProperty("artist_unicode")]
+        public string ArtistUnicode { get; set; } = string.Empty;
+
+        public string Author { get; set; } = string.Empty; // eventually should be linked to a persisted User. = string.Empty;
+
+        public string Source { get; set; } = string.Empty;
+
+        [JsonProperty(@"tags")]
+        public string Tags { get; set; } = string.Empty;
+
+        /// <summary>
+        /// The time in milliseconds to begin playing the track for preview purposes.
+        /// If -1, the track should begin playing at 40% of its length.
+        /// </summary>
+        public int PreviewTime { get; set; }
+
+        public string AudioFile { get; set; } = string.Empty;
+        public string BackgroundFile { get; set; } = string.Empty;
+    }
+}
diff --git a/osu.Game/Models/RealmBeatmapSet.cs b/osu.Game/Models/RealmBeatmapSet.cs
new file mode 100644
index 0000000000..314ca4494b
--- /dev/null
+++ b/osu.Game/Models/RealmBeatmapSet.cs
@@ -0,0 +1,78 @@
+// 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.Testing;
+using osu.Game.Beatmaps;
+using osu.Game.Database;
+using Realms;
+
+#nullable enable
+
+namespace osu.Game.Models
+{
+    [ExcludeFromDynamicCompile]
+    [MapTo("BeatmapSet")]
+    public class RealmBeatmapSet : RealmObject, IHasGuidPrimaryKey, IHasRealmFiles, ISoftDelete, IEquatable<RealmBeatmapSet>, IBeatmapSetInfo
+    {
+        [PrimaryKey]
+        public Guid ID { get; set; } = Guid.NewGuid();
+
+        public int? OnlineID { get; set; }
+
+        public DateTimeOffset DateAdded { get; set; }
+
+        public IBeatmapMetadataInfo? Metadata => Beatmaps.FirstOrDefault()?.Metadata;
+
+        public IList<RealmBeatmap> Beatmaps { get; } = null!;
+
+        public IList<RealmNamedFileUsage> Files { get; } = null!;
+
+        public bool DeletePending { get; set; }
+
+        public string Hash { get; set; } = string.Empty;
+
+        /// <summary>
+        /// Whether deleting this beatmap set should be prohibited (due to it being a system requirement to be present).
+        /// </summary>
+        public bool Protected { get; set; }
+
+        public double MaxStarDifficulty => Beatmaps.Max(b => b.StarRating);
+
+        public double MaxLength => Beatmaps.Max(b => b.Length);
+
+        public double MaxBPM => Beatmaps.Max(b => b.BPM);
+
+        /// <summary>
+        /// Returns the storage path for the file in this beatmapset with the given filename, if any exists, otherwise null.
+        /// The path returned is relative to the user file storage.
+        /// </summary>
+        /// <param name="filename">The name of the file to get the storage path of.</param>
+        public string? GetPathForFile(string filename) => Files.SingleOrDefault(f => string.Equals(f.Filename, filename, StringComparison.OrdinalIgnoreCase))?.File.StoragePath;
+
+        public override string ToString() => Metadata?.ToString() ?? base.ToString();
+
+        public bool Equals(RealmBeatmapSet? other)
+        {
+            if (other == null)
+                return false;
+
+            if (IsManaged && other.IsManaged)
+                return ID == other.ID;
+
+            if (OnlineID.HasValue && other.OnlineID.HasValue)
+                return OnlineID == other.OnlineID;
+
+            if (!string.IsNullOrEmpty(Hash) && !string.IsNullOrEmpty(other.Hash))
+                return Hash == other.Hash;
+
+            return ReferenceEquals(this, other);
+        }
+
+        IEnumerable<IBeatmapInfo> IBeatmapSetInfo.Beatmaps => Beatmaps;
+
+        IEnumerable<INamedFileUsage> IBeatmapSetInfo.Files => Files;
+    }
+}
diff --git a/osu.Game/Models/RealmFile.cs b/osu.Game/Models/RealmFile.cs
new file mode 100644
index 0000000000..6836d79d2d
--- /dev/null
+++ b/osu.Game/Models/RealmFile.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.IO;
+using osu.Game.IO;
+using Realms;
+
+#nullable enable
+
+namespace osu.Game.Models
+{
+    [MapTo("File")]
+    public class RealmFile : RealmObject, IFileInfo
+    {
+        [PrimaryKey]
+        public string Hash { get; set; } = string.Empty;
+
+        public string StoragePath => Path.Combine(Hash.Remove(1), Hash.Remove(2), Hash);
+    }
+}
diff --git a/osu.Game/Models/RealmNamedFileUsage.cs b/osu.Game/Models/RealmNamedFileUsage.cs
new file mode 100644
index 0000000000..59b446112d
--- /dev/null
+++ b/osu.Game/Models/RealmNamedFileUsage.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 JetBrains.Annotations;
+using osu.Game.Database;
+using osu.Game.IO;
+using Realms;
+
+#nullable enable
+
+namespace osu.Game.Models
+{
+    public class RealmNamedFileUsage : EmbeddedObject, INamedFile, INamedFileUsage
+    {
+        public RealmFile File { get; set; } = null!;
+
+        public string Filename { get; set; } = null!;
+
+        public RealmNamedFileUsage(RealmFile file, string filename)
+        {
+            File = file;
+            Filename = filename;
+        }
+
+        [UsedImplicitly]
+        private RealmNamedFileUsage()
+        {
+        }
+
+        IFileInfo INamedFileUsage.File => File;
+    }
+}
diff --git a/osu.Game/Models/RealmRuleset.cs b/osu.Game/Models/RealmRuleset.cs
new file mode 100644
index 0000000000..0dcd701ed2
--- /dev/null
+++ b/osu.Game/Models/RealmRuleset.cs
@@ -0,0 +1,63 @@
+// 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;
+using osu.Framework.Testing;
+using osu.Game.Rulesets;
+using Realms;
+
+#nullable enable
+
+namespace osu.Game.Models
+{
+    [ExcludeFromDynamicCompile]
+    [MapTo("Ruleset")]
+    public class RealmRuleset : RealmObject, IEquatable<RealmRuleset>, IRulesetInfo
+    {
+        [PrimaryKey]
+        public string ShortName { get; set; } = string.Empty;
+
+        public int? OnlineID { get; set; }
+
+        public string Name { get; set; } = string.Empty;
+
+        public string InstantiationInfo { get; set; } = string.Empty;
+
+        public RealmRuleset(string shortName, string name, string instantiationInfo, int? onlineID = null)
+        {
+            ShortName = shortName;
+            Name = name;
+            InstantiationInfo = instantiationInfo;
+            OnlineID = onlineID;
+        }
+
+        [UsedImplicitly]
+        private RealmRuleset()
+        {
+        }
+
+        public RealmRuleset(int? onlineID, string name, string shortName, bool available)
+        {
+            OnlineID = onlineID;
+            Name = name;
+            ShortName = shortName;
+            Available = available;
+        }
+
+        public bool Available { get; set; }
+
+        public bool Equals(RealmRuleset? other) => other != null && OnlineID == other.OnlineID && Available == other.Available && Name == other.Name && InstantiationInfo == other.InstantiationInfo;
+
+        public override string ToString() => Name;
+
+        public RealmRuleset Clone() => new RealmRuleset
+        {
+            OnlineID = OnlineID,
+            Name = Name,
+            ShortName = ShortName,
+            InstantiationInfo = InstantiationInfo,
+            Available = Available
+        };
+    }
+}

From 03bf88ae813ad2b4026489d44fc8f9a6490936ba Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 11 Oct 2021 15:26:16 +0900
Subject: [PATCH 0116/5547] Add realm `FileStore` and test coverage

---
 osu.Game.Tests/Database/FileStoreTests.cs | 114 ++++++++++++++++++++++
 osu.Game.Tests/Database/RealmTest.cs      |  42 ++++++++
 osu.Game/Stores/RealmFileStore.cs         | 113 +++++++++++++++++++++
 3 files changed, 269 insertions(+)
 create mode 100644 osu.Game.Tests/Database/FileStoreTests.cs
 create mode 100644 osu.Game/Stores/RealmFileStore.cs

diff --git a/osu.Game.Tests/Database/FileStoreTests.cs b/osu.Game.Tests/Database/FileStoreTests.cs
new file mode 100644
index 0000000000..861de5303d
--- /dev/null
+++ b/osu.Game.Tests/Database/FileStoreTests.cs
@@ -0,0 +1,114 @@
+// 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 System.IO;
+using System.Linq;
+using NUnit.Framework;
+using osu.Framework.Logging;
+using osu.Game.Models;
+using osu.Game.Stores;
+
+#nullable enable
+
+namespace osu.Game.Tests.Database
+{
+    public class FileStoreTests : RealmTest
+    {
+        [Test]
+        public void TestImportFile()
+        {
+            RunTestWithRealm((realmFactory, storage) =>
+            {
+                var realm = realmFactory.Context;
+                var files = new RealmFileStore(realmFactory, storage);
+
+                var testData = new MemoryStream(new byte[] { 0, 1, 2, 3 });
+
+                realm.Write(() => files.Add(testData, realm));
+
+                Assert.True(files.Storage.Exists("0/05/054edec1d0211f624fed0cbca9d4f9400b0e491c43742af2c5b0abebf0c990d8"));
+                Assert.True(files.Storage.Exists(realm.All<RealmFile>().First().StoragePath));
+            });
+        }
+
+        [Test]
+        public void TestImportSameFileTwice()
+        {
+            RunTestWithRealm((realmFactory, storage) =>
+            {
+                var realm = realmFactory.Context;
+                var files = new RealmFileStore(realmFactory, storage);
+
+                var testData = new MemoryStream(new byte[] { 0, 1, 2, 3 });
+
+                realm.Write(() => files.Add(testData, realm));
+                realm.Write(() => files.Add(testData, realm));
+
+                Assert.AreEqual(1, realm.All<RealmFile>().Count());
+            });
+        }
+
+        [Test]
+        public void TestDontPurgeReferenced()
+        {
+            RunTestWithRealm((realmFactory, storage) =>
+            {
+                var realm = realmFactory.Context;
+                var files = new RealmFileStore(realmFactory, storage);
+
+                var file = realm.Write(() => files.Add(new MemoryStream(new byte[] { 0, 1, 2, 3 }), realm));
+
+                var timer = new Stopwatch();
+                timer.Start();
+
+                realm.Write(() =>
+                {
+                    // attach the file to an arbitrary beatmap
+                    var beatmapSet = CreateBeatmapSet(CreateRuleset());
+
+                    beatmapSet.Files.Add(new RealmNamedFileUsage(file, "arbitrary.resource"));
+
+                    realm.Add(beatmapSet);
+                });
+
+                Logger.Log($"Import complete at {timer.ElapsedMilliseconds}");
+
+                string path = file.StoragePath;
+
+                Assert.True(realm.All<RealmFile>().Any());
+                Assert.True(files.Storage.Exists(path));
+
+                files.Cleanup();
+                Logger.Log($"Cleanup complete at {timer.ElapsedMilliseconds}");
+
+                Assert.True(realm.All<RealmFile>().Any());
+                Assert.True(file.IsValid);
+                Assert.True(files.Storage.Exists(path));
+            });
+        }
+
+        [Test]
+        public void TestPurgeUnreferenced()
+        {
+            RunTestWithRealm((realmFactory, storage) =>
+            {
+                var realm = realmFactory.Context;
+                var files = new RealmFileStore(realmFactory, storage);
+
+                var file = realm.Write(() => files.Add(new MemoryStream(new byte[] { 0, 1, 2, 3 }), realm));
+
+                string path = file.StoragePath;
+
+                Assert.True(realm.All<RealmFile>().Any());
+                Assert.True(files.Storage.Exists(path));
+
+                files.Cleanup();
+
+                Assert.False(realm.All<RealmFile>().Any());
+                Assert.False(file.IsValid);
+                Assert.False(files.Storage.Exists(path));
+            });
+        }
+    }
+}
diff --git a/osu.Game.Tests/Database/RealmTest.cs b/osu.Game.Tests/Database/RealmTest.cs
index f5752aa606..04c9f2577a 100644
--- a/osu.Game.Tests/Database/RealmTest.cs
+++ b/osu.Game.Tests/Database/RealmTest.cs
@@ -5,10 +5,12 @@ using System;
 using System.Runtime.CompilerServices;
 using System.Threading.Tasks;
 using NUnit.Framework;
+using osu.Framework.Extensions;
 using osu.Framework.Logging;
 using osu.Framework.Platform;
 using osu.Framework.Testing;
 using osu.Game.Database;
+using osu.Game.Models;
 
 #nullable enable
 
@@ -70,6 +72,46 @@ namespace osu.Game.Tests.Database
             }
         }
 
+        protected static RealmBeatmapSet CreateBeatmapSet(RealmRuleset ruleset)
+        {
+            RealmFile createRealmFile() => new RealmFile { Hash = Guid.NewGuid().ToString().ComputeSHA2Hash() };
+
+            var metadata = new RealmBeatmapMetadata
+            {
+                Title = "My Love",
+                Artist = "Kuba Oms"
+            };
+
+            var beatmapSet = new RealmBeatmapSet
+            {
+                Beatmaps =
+                {
+                    new RealmBeatmap(ruleset, new RealmBeatmapDifficulty(), metadata) { DifficultyName = "Easy", },
+                    new RealmBeatmap(ruleset, new RealmBeatmapDifficulty(), metadata) { DifficultyName = "Normal", },
+                    new RealmBeatmap(ruleset, new RealmBeatmapDifficulty(), metadata) { DifficultyName = "Hard", },
+                    new RealmBeatmap(ruleset, new RealmBeatmapDifficulty(), metadata) { DifficultyName = "Insane", }
+                },
+                Files =
+                {
+                    new RealmNamedFileUsage(createRealmFile(), "test [easy].osu"),
+                    new RealmNamedFileUsage(createRealmFile(), "test [normal].osu"),
+                    new RealmNamedFileUsage(createRealmFile(), "test [hard].osu"),
+                    new RealmNamedFileUsage(createRealmFile(), "test [insane].osu"),
+                }
+            };
+
+            for (int i = 0; i < 8; i++)
+                beatmapSet.Files.Add(new RealmNamedFileUsage(createRealmFile(), $"hitsound{i}.mp3"));
+
+            foreach (var b in beatmapSet.Beatmaps)
+                b.BeatmapSet = beatmapSet;
+
+            return beatmapSet;
+        }
+
+        protected static RealmRuleset CreateRuleset() =>
+            new RealmRuleset(0, "osu!", "osu", true);
+
         private class RealmTestGame : Framework.Game
         {
             public RealmTestGame(Func<Task> work)
diff --git a/osu.Game/Stores/RealmFileStore.cs b/osu.Game/Stores/RealmFileStore.cs
new file mode 100644
index 0000000000..aac52b193c
--- /dev/null
+++ b/osu.Game/Stores/RealmFileStore.cs
@@ -0,0 +1,113 @@
+// 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.Extensions;
+using osu.Framework.IO.Stores;
+using osu.Framework.Logging;
+using osu.Framework.Platform;
+using osu.Game.Database;
+using osu.Game.Models;
+using Realms;
+
+#nullable enable
+
+namespace osu.Game.Stores
+{
+    /// <summary>
+    /// Handles the Store and retrieval of Files/FileSets to the database backing
+    /// </summary>
+    public class RealmFileStore
+    {
+        private readonly RealmContextFactory realmFactory;
+        public readonly IResourceStore<byte[]> Store;
+
+        public Storage Storage;
+
+        public RealmFileStore(RealmContextFactory realmFactory, Storage storage)
+        {
+            this.realmFactory = realmFactory;
+
+            Storage = storage.GetStorageForDirectory(@"files");
+            Store = new StorageBackedResourceStore(Storage);
+        }
+
+        /// <summary>
+        /// Add a new file to the game-wide database, copying it to permanent storage if not already present.
+        /// </summary>
+        /// <param name="data">The file data stream.</param>
+        /// <param name="realm">The realm instance to add to. Should already be in a transaction.</param>
+        /// <returns></returns>
+        public RealmFile Add(Stream data, Realm realm)
+        {
+            string hash = data.ComputeSHA2Hash();
+
+            var existing = realm.Find<RealmFile>(hash);
+
+            var file = existing ?? new RealmFile { Hash = hash };
+
+            if (!checkFileExistsAndMatchesHash(file))
+                copyToStore(file, data);
+
+            if (!file.IsManaged)
+                realm.Add(file);
+
+            return file;
+        }
+
+        private void copyToStore(RealmFile file, Stream data)
+        {
+            data.Seek(0, SeekOrigin.Begin);
+
+            using (var output = Storage.GetStream(file.StoragePath, FileAccess.Write))
+                data.CopyTo(output);
+
+            data.Seek(0, SeekOrigin.Begin);
+        }
+
+        private bool checkFileExistsAndMatchesHash(RealmFile file)
+        {
+            string path = file.StoragePath;
+
+            // we may be re-adding a file to fix missing store entries.
+            if (!Storage.Exists(path))
+                return false;
+
+            // even if the file already exists, check the existing checksum for safety.
+            using (var stream = Storage.GetStream(path))
+                return stream.ComputeSHA2Hash() == file.Hash;
+        }
+
+        public void Cleanup()
+        {
+            var realm = realmFactory.Context;
+
+            // can potentially be run asynchronously, although we will need to consider operation order for disk deletion vs realm removal.
+            using (var transaction = realm.BeginWrite())
+            {
+                // TODO: consider using a realm native query to avoid iterating all files (https://github.com/realm/realm-dotnet/issues/2659#issuecomment-927823707)
+                var files = realm.All<RealmFile>().ToList();
+
+                foreach (var file in files)
+                {
+                    if (file.BacklinksCount > 0)
+                        continue;
+
+                    try
+                    {
+                        Storage.Delete(file.StoragePath);
+                        realm.Remove(file);
+                    }
+                    catch (Exception e)
+                    {
+                        Logger.Error(e, $@"Could not delete databased file {file.Hash}");
+                    }
+                }
+
+                transaction.Commit();
+            }
+        }
+    }
+}

From b01d82b3fd8e05548a1eee87cc33c7b5920649df Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 30 Sep 2021 23:46:16 +0900
Subject: [PATCH 0117/5547] Add `RealmLive` implementation

---
 osu.Game.Tests/Database/RealmLiveTests.cs  | 199 +++++++++++++++++++++
 osu.Game/Database/RealmLive.cs             | 111 ++++++++++++
 osu.Game/Database/RealmObjectExtensions.cs |  13 ++
 3 files changed, 323 insertions(+)
 create mode 100644 osu.Game.Tests/Database/RealmLiveTests.cs
 create mode 100644 osu.Game/Database/RealmLive.cs

diff --git a/osu.Game.Tests/Database/RealmLiveTests.cs b/osu.Game.Tests/Database/RealmLiveTests.cs
new file mode 100644
index 0000000000..d6ea24e848
--- /dev/null
+++ b/osu.Game.Tests/Database/RealmLiveTests.cs
@@ -0,0 +1,199 @@
+// 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.Linq;
+using System.Threading.Tasks;
+using NUnit.Framework;
+using osu.Game.Database;
+using osu.Game.Models;
+using Realms;
+
+#nullable enable
+
+namespace osu.Game.Tests.Database
+{
+    public class RealmLiveTests : RealmTest
+    {
+        [Test]
+        public void TestValueAccessWithOpenContext()
+        {
+            RunTestWithRealm((realmFactory, _) =>
+            {
+                RealmLive<RealmBeatmap>? liveBeatmap = null;
+                Task.Factory.StartNew(() =>
+                {
+                    using (var threadContext = realmFactory.CreateContext())
+                    {
+                        var beatmap = threadContext.Write(r => r.Add(new RealmBeatmap(CreateRuleset(), new RealmBeatmapDifficulty(), new RealmBeatmapMetadata())));
+
+                        liveBeatmap = beatmap.ToLive();
+                    }
+                }, TaskCreationOptions.LongRunning | TaskCreationOptions.HideScheduler).Wait();
+
+                Debug.Assert(liveBeatmap != null);
+
+                Task.Factory.StartNew(() =>
+                {
+                    Assert.DoesNotThrow(() =>
+                    {
+                        using (realmFactory.CreateContext())
+                        {
+                            var resolved = liveBeatmap.Value;
+
+                            Assert.IsTrue(resolved.Realm.IsClosed);
+                            Assert.IsTrue(resolved.IsValid);
+
+                            // can access properties without a crash.
+                            Assert.IsFalse(resolved.Hidden);
+                        }
+                    });
+                }, TaskCreationOptions.LongRunning | TaskCreationOptions.HideScheduler).Wait();
+            });
+        }
+
+        [Test]
+        public void TestScopedReadWithoutContext()
+        {
+            RunTestWithRealm((realmFactory, _) =>
+            {
+                RealmLive<RealmBeatmap>? liveBeatmap = null;
+                Task.Factory.StartNew(() =>
+                {
+                    using (var threadContext = realmFactory.CreateContext())
+                    {
+                        var beatmap = threadContext.Write(r => r.Add(new RealmBeatmap(CreateRuleset(), new RealmBeatmapDifficulty(), new RealmBeatmapMetadata())));
+
+                        liveBeatmap = beatmap.ToLive();
+                    }
+                }, TaskCreationOptions.LongRunning | TaskCreationOptions.HideScheduler).Wait();
+
+                Debug.Assert(liveBeatmap != null);
+
+                Task.Factory.StartNew(() =>
+                {
+                    liveBeatmap.PerformRead(beatmap =>
+                    {
+                        Assert.IsTrue(beatmap.IsValid);
+                        Assert.IsFalse(beatmap.Hidden);
+                    });
+                }, TaskCreationOptions.LongRunning | TaskCreationOptions.HideScheduler).Wait();
+            });
+        }
+
+        [Test]
+        public void TestScopedWriteWithoutContext()
+        {
+            RunTestWithRealm((realmFactory, _) =>
+            {
+                RealmLive<RealmBeatmap>? liveBeatmap = null;
+                Task.Factory.StartNew(() =>
+                {
+                    using (var threadContext = realmFactory.CreateContext())
+                    {
+                        var beatmap = threadContext.Write(r => r.Add(new RealmBeatmap(CreateRuleset(), new RealmBeatmapDifficulty(), new RealmBeatmapMetadata())));
+
+                        liveBeatmap = beatmap.ToLive();
+                    }
+                }, TaskCreationOptions.LongRunning | TaskCreationOptions.HideScheduler).Wait();
+
+                Debug.Assert(liveBeatmap != null);
+
+                Task.Factory.StartNew(() =>
+                {
+                    liveBeatmap.PerformWrite(beatmap => { beatmap.Hidden = true; });
+                    liveBeatmap.PerformRead(beatmap => { Assert.IsTrue(beatmap.Hidden); });
+                }, TaskCreationOptions.LongRunning | TaskCreationOptions.HideScheduler).Wait();
+            });
+        }
+
+        [Test]
+        public void TestValueAccessWithoutOpenContextFails()
+        {
+            RunTestWithRealm((realmFactory, _) =>
+            {
+                RealmLive<RealmBeatmap>? liveBeatmap = null;
+                Task.Factory.StartNew(() =>
+                {
+                    using (var threadContext = realmFactory.CreateContext())
+                    {
+                        var beatmap = threadContext.Write(r => r.Add(new RealmBeatmap(CreateRuleset(), new RealmBeatmapDifficulty(), new RealmBeatmapMetadata())));
+
+                        liveBeatmap = beatmap.ToLive();
+                    }
+                }, TaskCreationOptions.LongRunning | TaskCreationOptions.HideScheduler).Wait();
+
+                Debug.Assert(liveBeatmap != null);
+
+                Task.Factory.StartNew(() =>
+                {
+                    Assert.Throws<InvalidOperationException>(() =>
+                    {
+                        var unused = liveBeatmap.Value;
+                    });
+                }, TaskCreationOptions.LongRunning | TaskCreationOptions.HideScheduler).Wait();
+            });
+        }
+
+        [Test]
+        public void TestLiveAssumptions()
+        {
+            RunTestWithRealm((realmFactory, _) =>
+            {
+                int changesTriggered = 0;
+
+                using (var updateThreadContext = realmFactory.CreateContext())
+                {
+                    updateThreadContext.All<RealmBeatmap>().SubscribeForNotifications(gotChange);
+                    RealmLive<RealmBeatmap>? liveBeatmap = null;
+
+                    Task.Factory.StartNew(() =>
+                    {
+                        using (var threadContext = realmFactory.CreateContext())
+                        {
+                            var ruleset = CreateRuleset();
+                            var beatmap = threadContext.Write(r => r.Add(new RealmBeatmap(ruleset, new RealmBeatmapDifficulty(), new RealmBeatmapMetadata())));
+
+                            // add a second beatmap to ensure that a full refresh occurs below.
+                            // not just a refresh from the resolved Live.
+                            threadContext.Write(r => r.Add(new RealmBeatmap(ruleset, new RealmBeatmapDifficulty(), new RealmBeatmapMetadata())));
+
+                            liveBeatmap = beatmap.ToLive();
+                        }
+                    }, TaskCreationOptions.LongRunning | TaskCreationOptions.HideScheduler).Wait();
+
+                    Debug.Assert(liveBeatmap != null);
+
+                    // not yet seen by main context
+                    Assert.AreEqual(0, updateThreadContext.All<RealmBeatmap>().Count());
+                    Assert.AreEqual(0, changesTriggered);
+
+                    var resolved = liveBeatmap.Value;
+
+                    // retrieval causes an implicit refresh. even changes that aren't related to the retrieval are fired at this point.
+                    Assert.AreEqual(2, updateThreadContext.All<RealmBeatmap>().Count());
+                    Assert.AreEqual(1, changesTriggered);
+
+                    // even though the realm that this instance was resolved for was closed, it's still valid.
+                    Assert.IsTrue(resolved.Realm.IsClosed);
+                    Assert.IsTrue(resolved.IsValid);
+
+                    // can access properties without a crash.
+                    Assert.IsFalse(resolved.Hidden);
+
+                    updateThreadContext.Write(r =>
+                    {
+                        // can use with the main context.
+                        r.Remove(resolved);
+                    });
+                }
+
+                void gotChange(IRealmCollection<RealmBeatmap> sender, ChangeSet changes, Exception error)
+                {
+                    changesTriggered++;
+                }
+            });
+        }
+    }
+}
diff --git a/osu.Game/Database/RealmLive.cs b/osu.Game/Database/RealmLive.cs
new file mode 100644
index 0000000000..71fb44f617
--- /dev/null
+++ b/osu.Game/Database/RealmLive.cs
@@ -0,0 +1,111 @@
+// 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.Threading;
+using Realms;
+
+#nullable enable
+
+namespace osu.Game.Database
+{
+    /// <summary>
+    /// Provides a method of working with realm objects over longer application lifetimes.
+    /// </summary>
+    /// <typeparam name="T">The underlying object type.</typeparam>
+    public class RealmLive<T> : ILive<T> where T : RealmObject, IHasGuidPrimaryKey
+    {
+        public Guid ID { get; }
+
+        private readonly SynchronizationContext? fetchedContext;
+        private readonly int fetchedThreadId;
+
+        /// <summary>
+        /// The original live data used to create this instance.
+        /// </summary>
+        private readonly T data;
+
+        /// <summary>
+        /// Construct a new instance of live realm data.
+        /// </summary>
+        /// <param name="data">The realm data.</param>
+        public RealmLive(T data)
+        {
+            this.data = data;
+
+            fetchedContext = SynchronizationContext.Current;
+            fetchedThreadId = Thread.CurrentThread.ManagedThreadId;
+
+            ID = data.ID;
+        }
+
+        /// <summary>
+        /// Perform a read operation on this live object.
+        /// </summary>
+        /// <param name="perform">The action to perform.</param>
+        public void PerformRead(Action<T> perform)
+        {
+            if (originalDataValid)
+            {
+                perform(data);
+                return;
+            }
+
+            using (var realm = Realm.GetInstance(data.Realm.Config))
+                perform(realm.Find<T>(ID));
+        }
+
+        /// <summary>
+        /// Perform a read operation on this live object.
+        /// </summary>
+        /// <param name="perform">The action to perform.</param>
+        public TReturn PerformRead<TReturn>(Func<T, TReturn> perform)
+        {
+            if (typeof(RealmObjectBase).IsAssignableFrom(typeof(TReturn)))
+                throw new InvalidOperationException($"Realm live objects should not exit the scope of {nameof(PerformRead)}.");
+
+            if (originalDataValid)
+                return perform(data);
+
+            using (var realm = Realm.GetInstance(data.Realm.Config))
+                return perform(realm.Find<T>(ID));
+        }
+
+        /// <summary>
+        /// Perform a write operation on this live object.
+        /// </summary>
+        /// <param name="perform">The action to perform.</param>
+        public void PerformWrite(Action<T> perform) =>
+            PerformRead(t =>
+            {
+                var transaction = t.Realm.BeginWrite();
+                perform(t);
+                transaction.Commit();
+            });
+
+        public T Value
+        {
+            get
+            {
+                if (originalDataValid)
+                    return data;
+
+                T retrieved;
+
+                using (var realm = Realm.GetInstance(data.Realm.Config))
+                    retrieved = realm.Find<T>(ID);
+
+                if (!retrieved.IsValid)
+                    throw new InvalidOperationException("Attempted to access value without an open context");
+
+                return retrieved;
+            }
+        }
+
+        private bool originalDataValid => isCorrectThread && data.IsValid && !data.Realm.IsClosed;
+
+        // this matches realm's internal thread validation (see https://github.com/realm/realm-dotnet/blob/903b4d0b304f887e37e2d905384fb572a6496e70/Realm/Realm/Native/SynchronizationContextScheduler.cs#L72)
+        private bool isCorrectThread
+            => (fetchedContext != null && SynchronizationContext.Current == fetchedContext) || fetchedThreadId == Thread.CurrentThread.ManagedThreadId;
+    }
+}
diff --git a/osu.Game/Database/RealmObjectExtensions.cs b/osu.Game/Database/RealmObjectExtensions.cs
index c5aa1399a3..18a926fa8c 100644
--- a/osu.Game/Database/RealmObjectExtensions.cs
+++ b/osu.Game/Database/RealmObjectExtensions.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 AutoMapper;
 using osu.Game.Input.Bindings;
 using Realms;
@@ -47,5 +48,17 @@ namespace osu.Game.Database
 
             return mapper.Map<T>(item);
         }
+
+        public static List<RealmLive<T>> ToLive<T>(this IEnumerable<T> realmList)
+            where T : RealmObject, IHasGuidPrimaryKey
+        {
+            return realmList.Select(l => new RealmLive<T>(l)).ToList();
+        }
+
+        public static RealmLive<T> ToLive<T>(this T realmObject)
+            where T : RealmObject, IHasGuidPrimaryKey
+        {
+            return new RealmLive<T>(realmObject);
+        }
     }
 }

From 81a0fbfc40d2a6afca48fb64141eecabf5aab011 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 1 Oct 2021 14:30:27 +0900
Subject: [PATCH 0118/5547] Add `Live<>` casting test

---
 osu.Game.Tests/Database/RealmLiveTests.cs | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/osu.Game.Tests/Database/RealmLiveTests.cs b/osu.Game.Tests/Database/RealmLiveTests.cs
index d6ea24e848..33aa1afb89 100644
--- a/osu.Game.Tests/Database/RealmLiveTests.cs
+++ b/osu.Game.Tests/Database/RealmLiveTests.cs
@@ -6,6 +6,7 @@ using System.Diagnostics;
 using System.Linq;
 using System.Threading.Tasks;
 using NUnit.Framework;
+using osu.Game.Beatmaps;
 using osu.Game.Database;
 using osu.Game.Models;
 using Realms;
@@ -16,6 +17,19 @@ namespace osu.Game.Tests.Database
 {
     public class RealmLiveTests : RealmTest
     {
+        [Test]
+        public void TestLiveCastability()
+        {
+            RunTestWithRealm((realmFactory, _) =>
+            {
+                RealmLive<RealmBeatmap> beatmap = realmFactory.CreateContext().Write(r => r.Add(new RealmBeatmap(CreateRuleset(), new RealmBeatmapDifficulty(), new RealmBeatmapMetadata()))).ToLive();
+
+                ILive<IBeatmapInfo> iBeatmap = beatmap;
+
+                Assert.AreEqual(0, iBeatmap.Value.Length);
+            });
+        }
+
         [Test]
         public void TestValueAccessWithOpenContext()
         {

From 0daa836ecc1e04332f83acc64741e07476a96762 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 11 Oct 2021 15:45:06 +0900
Subject: [PATCH 0119/5547] Add realm `RulesetStore`

Not yet used in game.
---
 osu.Game.Tests/Database/RulesetStoreTests.cs |  54 ++++
 osu.Game/Stores/RealmRulesetStore.cs         | 257 +++++++++++++++++++
 2 files changed, 311 insertions(+)
 create mode 100644 osu.Game.Tests/Database/RulesetStoreTests.cs
 create mode 100644 osu.Game/Stores/RealmRulesetStore.cs

diff --git a/osu.Game.Tests/Database/RulesetStoreTests.cs b/osu.Game.Tests/Database/RulesetStoreTests.cs
new file mode 100644
index 0000000000..f4e0838be1
--- /dev/null
+++ b/osu.Game.Tests/Database/RulesetStoreTests.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 System.Linq;
+using NUnit.Framework;
+using osu.Game.Models;
+using osu.Game.Stores;
+
+namespace osu.Game.Tests.Database
+{
+    public class RulesetStoreTests : RealmTest
+    {
+        [Test]
+        public void TestCreateStore()
+        {
+            RunTestWithRealm((realmFactory, storage) =>
+            {
+                var rulesets = new RealmRulesetStore(realmFactory, storage);
+
+                Assert.AreEqual(4, rulesets.AvailableRulesets.Count());
+                Assert.AreEqual(4, realmFactory.Context.All<RealmRuleset>().Count());
+            });
+        }
+
+        [Test]
+        public void TestCreateStoreTwiceDoesntAddRulesetsAgain()
+        {
+            RunTestWithRealm((realmFactory, storage) =>
+            {
+                var rulesets = new RealmRulesetStore(realmFactory, storage);
+                var rulesets2 = new RealmRulesetStore(realmFactory, storage);
+
+                Assert.AreEqual(4, rulesets.AvailableRulesets.Count());
+                Assert.AreEqual(4, rulesets2.AvailableRulesets.Count());
+
+                Assert.AreEqual(rulesets.AvailableRulesets.First(), rulesets2.AvailableRulesets.First());
+                Assert.AreEqual(4, realmFactory.Context.All<RealmRuleset>().Count());
+            });
+        }
+
+        [Test]
+        public void TestRetrievedRulesetsAreDetached()
+        {
+            RunTestWithRealm((realmFactory, storage) =>
+            {
+                var rulesets = new RealmRulesetStore(realmFactory, storage);
+
+                Assert.IsTrue((rulesets.AvailableRulesets.First() as RealmRuleset)?.IsManaged == false);
+                Assert.IsTrue((rulesets.GetRuleset(0) as RealmRuleset)?.IsManaged == false);
+                Assert.IsTrue((rulesets.GetRuleset("mania") as RealmRuleset)?.IsManaged == false);
+            });
+        }
+    }
+}
diff --git a/osu.Game/Stores/RealmRulesetStore.cs b/osu.Game/Stores/RealmRulesetStore.cs
new file mode 100644
index 0000000000..63e5344ef3
--- /dev/null
+++ b/osu.Game/Stores/RealmRulesetStore.cs
@@ -0,0 +1,257 @@
+// 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 System.Reflection;
+using osu.Framework;
+using osu.Framework.Logging;
+using osu.Framework.Platform;
+using osu.Game.Database;
+using osu.Game.Models;
+using osu.Game.Rulesets;
+
+#nullable enable
+
+namespace osu.Game.Stores
+{
+    public class RealmRulesetStore : IDisposable
+    {
+        private readonly RealmContextFactory realmFactory;
+
+        private const string ruleset_library_prefix = "osu.Game.Rulesets";
+
+        private readonly Dictionary<Assembly, Type> loadedAssemblies = new Dictionary<Assembly, Type>();
+
+        /// <summary>
+        /// All available rulesets.
+        /// </summary>
+        public IEnumerable<IRulesetInfo> AvailableRulesets => availableRulesets;
+
+        private readonly List<IRulesetInfo> availableRulesets = new List<IRulesetInfo>();
+
+        public RealmRulesetStore(RealmContextFactory realmFactory, Storage? storage = null)
+        {
+            this.realmFactory = realmFactory;
+
+            // On android in release configuration assemblies are loaded from the apk directly into memory.
+            // We cannot read assemblies from cwd, so should check loaded assemblies instead.
+            loadFromAppDomain();
+
+            // This null check prevents Android from attempting to load the rulesets from disk,
+            // as the underlying path "AppContext.BaseDirectory", despite being non-nullable, it returns null on android.
+            // See https://github.com/xamarin/xamarin-android/issues/3489.
+            if (RuntimeInfo.StartupDirectory != null)
+                loadFromDisk();
+
+            // the event handler contains code for resolving dependency on the game assembly for rulesets located outside the base game directory.
+            // It needs to be attached to the assembly lookup event before the actual call to loadUserRulesets() else rulesets located out of the base game directory will fail
+            // to load as unable to locate the game core assembly.
+            AppDomain.CurrentDomain.AssemblyResolve += resolveRulesetDependencyAssembly;
+
+            var rulesetStorage = storage?.GetStorageForDirectory("rulesets");
+            if (rulesetStorage != null)
+                loadUserRulesets(rulesetStorage);
+
+            addMissingRulesets();
+        }
+
+        /// <summary>
+        /// Retrieve a ruleset using a known ID.
+        /// </summary>
+        /// <param name="id">The ruleset's internal ID.</param>
+        /// <returns>A ruleset, if available, else null.</returns>
+        public IRulesetInfo? GetRuleset(int id) => AvailableRulesets.FirstOrDefault(r => r.OnlineID == id);
+
+        /// <summary>
+        /// Retrieve a ruleset using a known short name.
+        /// </summary>
+        /// <param name="shortName">The ruleset's short name.</param>
+        /// <returns>A ruleset, if available, else null.</returns>
+        public IRulesetInfo? GetRuleset(string shortName) => AvailableRulesets.FirstOrDefault(r => r.ShortName == shortName);
+
+        private Assembly? resolveRulesetDependencyAssembly(object? sender, ResolveEventArgs args)
+        {
+            var asm = new AssemblyName(args.Name);
+
+            // the requesting assembly may be located out of the executable's base directory, thus requiring manual resolving of its dependencies.
+            // this attempts resolving the ruleset dependencies on game core and framework assemblies by returning assemblies with the same assembly name
+            // already loaded in the AppDomain.
+            var domainAssembly = AppDomain.CurrentDomain.GetAssemblies()
+                                          // Given name is always going to be equally-or-more qualified than the assembly name.
+                                          .Where(a =>
+                                          {
+                                              string? name = a.GetName().Name;
+                                              if (name == null)
+                                                  return false;
+
+                                              return args.Name.Contains(name, StringComparison.Ordinal);
+                                          })
+                                          // Pick the greatest assembly version.
+                                          .OrderByDescending(a => a.GetName().Version)
+                                          .FirstOrDefault();
+
+            if (domainAssembly != null)
+                return domainAssembly;
+
+            return loadedAssemblies.Keys.FirstOrDefault(a => a.FullName == asm.FullName);
+        }
+
+        private void addMissingRulesets()
+        {
+            realmFactory.Context.Write(realm =>
+            {
+                var rulesets = realm.All<RealmRuleset>();
+
+                List<Ruleset> instances = loadedAssemblies.Values.Select(r => Activator.CreateInstance(r) as Ruleset).OfType<Ruleset>().ToList();
+
+                // add all legacy rulesets first to ensure they have exclusive choice of primary key.
+                foreach (var r in instances.Where(r => r is ILegacyRuleset))
+                {
+                    if (realm.All<RealmRuleset>().FirstOrDefault(rr => rr.OnlineID == r.RulesetInfo.ID) == null)
+                        realm.Add(new RealmRuleset(r.RulesetInfo.ShortName, r.RulesetInfo.Name, r.RulesetInfo.InstantiationInfo, r.RulesetInfo.ID));
+                }
+
+                // add any other rulesets which have assemblies present but are not yet in the database.
+                foreach (var r in instances.Where(r => !(r is ILegacyRuleset)))
+                {
+                    if (rulesets.FirstOrDefault(ri => ri.InstantiationInfo.Equals(r.RulesetInfo.InstantiationInfo, StringComparison.Ordinal)) == null)
+                    {
+                        var existingSameShortName = rulesets.FirstOrDefault(ri => ri.ShortName == r.RulesetInfo.ShortName);
+
+                        if (existingSameShortName != null)
+                        {
+                            // even if a matching InstantiationInfo was not found, there may be an existing ruleset with the same ShortName.
+                            // this generally means the user or ruleset provider has renamed their dll but the underlying ruleset is *likely* the same one.
+                            // in such cases, update the instantiation info of the existing entry to point to the new one.
+                            existingSameShortName.InstantiationInfo = r.RulesetInfo.InstantiationInfo;
+                        }
+                        else
+                            realm.Add(new RealmRuleset(r.RulesetInfo.ShortName, r.RulesetInfo.Name, r.RulesetInfo.InstantiationInfo, r.RulesetInfo.ID));
+                    }
+                }
+
+                List<RealmRuleset> detachedRulesets = new List<RealmRuleset>();
+
+                // perform a consistency check and detach final rulesets from realm for cross-thread runtime usage.
+                foreach (var r in rulesets)
+                {
+                    try
+                    {
+                        var type = Type.GetType(r.InstantiationInfo);
+
+                        if (type == null)
+                            continue;
+
+                        var rInstance = (Activator.CreateInstance(type) as Ruleset)?.RulesetInfo;
+
+                        if (rInstance == null)
+                            continue;
+
+                        r.Name = rInstance.Name;
+                        r.ShortName = rInstance.ShortName;
+                        r.InstantiationInfo = rInstance.InstantiationInfo;
+                        r.Available = true;
+
+                        detachedRulesets.Add(r.Clone());
+                    }
+                    catch
+                    {
+                        r.Available = false;
+                    }
+                }
+
+                availableRulesets.AddRange(detachedRulesets);
+            });
+        }
+
+        private void loadFromAppDomain()
+        {
+            foreach (var ruleset in AppDomain.CurrentDomain.GetAssemblies())
+            {
+                string? rulesetName = ruleset.GetName().Name;
+
+                if (rulesetName == null)
+                    continue;
+
+                if (!rulesetName.StartsWith(ruleset_library_prefix, StringComparison.InvariantCultureIgnoreCase) || rulesetName.Contains("Tests"))
+                    continue;
+
+                addRuleset(ruleset);
+            }
+        }
+
+        private void loadUserRulesets(Storage rulesetStorage)
+        {
+            var rulesets = rulesetStorage.GetFiles(".", $"{ruleset_library_prefix}.*.dll");
+
+            foreach (var ruleset in rulesets.Where(f => !f.Contains("Tests")))
+                loadRulesetFromFile(rulesetStorage.GetFullPath(ruleset));
+        }
+
+        private void loadFromDisk()
+        {
+            try
+            {
+                var files = Directory.GetFiles(RuntimeInfo.StartupDirectory, $"{ruleset_library_prefix}.*.dll");
+
+                foreach (string file in files.Where(f => !Path.GetFileName(f).Contains("Tests")))
+                    loadRulesetFromFile(file);
+            }
+            catch (Exception e)
+            {
+                Logger.Error(e, $"Could not load rulesets from directory {RuntimeInfo.StartupDirectory}");
+            }
+        }
+
+        private void loadRulesetFromFile(string file)
+        {
+            var filename = Path.GetFileNameWithoutExtension(file);
+
+            if (loadedAssemblies.Values.Any(t => Path.GetFileNameWithoutExtension(t.Assembly.Location) == filename))
+                return;
+
+            try
+            {
+                addRuleset(Assembly.LoadFrom(file));
+            }
+            catch (Exception e)
+            {
+                Logger.Error(e, $"Failed to load ruleset {filename}");
+            }
+        }
+
+        private void addRuleset(Assembly assembly)
+        {
+            if (loadedAssemblies.ContainsKey(assembly))
+                return;
+
+            // the same assembly may be loaded twice in the same AppDomain (currently a thing in certain Rider versions https://youtrack.jetbrains.com/issue/RIDER-48799).
+            // as a failsafe, also compare by FullName.
+            if (loadedAssemblies.Any(a => a.Key.FullName == assembly.FullName))
+                return;
+
+            try
+            {
+                loadedAssemblies[assembly] = assembly.GetTypes().First(t => t.IsPublic && t.IsSubclassOf(typeof(Ruleset)));
+            }
+            catch (Exception e)
+            {
+                Logger.Error(e, $"Failed to add ruleset {assembly}");
+            }
+        }
+
+        public void Dispose()
+        {
+            Dispose(true);
+            GC.SuppressFinalize(this);
+        }
+
+        protected virtual void Dispose(bool disposing)
+        {
+            AppDomain.CurrentDomain.AssemblyResolve -= resolveRulesetDependencyAssembly;
+        }
+    }
+}

From 43aacb383170dcd854561c890fa8c7d6c6f5e1f7 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 11 Oct 2021 16:11:15 +0900
Subject: [PATCH 0120/5547] Fix two different skins displaying at the same time
 when rapidly switching

---
 osu.Game/Skinning/SkinnableTargetContainer.cs | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Skinning/SkinnableTargetContainer.cs b/osu.Game/Skinning/SkinnableTargetContainer.cs
index e7125bb034..20c2fcc075 100644
--- a/osu.Game/Skinning/SkinnableTargetContainer.cs
+++ b/osu.Game/Skinning/SkinnableTargetContainer.cs
@@ -3,6 +3,7 @@
 
 using System;
 using System.Linq;
+using System.Threading;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 
@@ -22,6 +23,8 @@ namespace osu.Game.Skinning
 
         public bool ComponentsLoaded { get; private set; }
 
+        private CancellationTokenSource cancellationSource;
+
         public SkinnableTargetContainer(SkinnableTarget target)
         {
             Target = target;
@@ -38,6 +41,9 @@ namespace osu.Game.Skinning
 
             content = CurrentSkin.GetDrawableComponent(new SkinnableTargetComponent(Target)) as SkinnableTargetComponentsContainer;
 
+            cancellationSource?.Cancel();
+            cancellationSource = null;
+
             if (content != null)
             {
                 LoadComponentAsync(content, wrapper =>
@@ -45,7 +51,7 @@ namespace osu.Game.Skinning
                     AddInternal(wrapper);
                     components.AddRange(wrapper.Children.OfType<ISkinnableDrawable>());
                     ComponentsLoaded = true;
-                });
+                }, (cancellationSource = new CancellationTokenSource()).Token);
             }
             else
                 ComponentsLoaded = true;

From bae404f742cf02cd7d1c9f72d2925f73454b1613 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 11 Oct 2021 16:17:15 +0900
Subject: [PATCH 0121/5547] Update framework

---
 osu.Android.props        | 2 +-
 osu.Game/osu.Game.csproj | 2 +-
 osu.iOS.props            | 4 ++--
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Android.props b/osu.Android.props
index 5a0e7479fa..fefc2f6438 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -52,7 +52,7 @@
   </ItemGroup>
   <ItemGroup>
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1004.0" />
-    <PackageReference Include="ppy.osu.Framework.Android" Version="2021.1004.0" />
+    <PackageReference Include="ppy.osu.Framework.Android" Version="2021.1011.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
     <!-- Realm needs to be directly referenced in all Xamarin projects, as it will not pull in its transitive dependencies otherwise. -->
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 4877ddf725..ff382f5227 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="10.6.0" />
-    <PackageReference Include="ppy.osu.Framework" Version="2021.1004.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2021.1011.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1004.0" />
     <PackageReference Include="Sentry" Version="3.9.4" />
     <PackageReference Include="SharpCompress" Version="0.29.0" />
diff --git a/osu.iOS.props b/osu.iOS.props
index edce9d27fe..fff0cbf418 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -70,7 +70,7 @@
     <Reference Include="System.Net.Http" />
   </ItemGroup>
   <ItemGroup Label="Package References">
-    <PackageReference Include="ppy.osu.Framework.iOS" Version="2021.1004.0" />
+    <PackageReference Include="ppy.osu.Framework.iOS" Version="2021.1011.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1004.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net5.0 / net6.0) -->
@@ -93,7 +93,7 @@
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="2.2.6" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.Core" Version="2.2.6" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
-    <PackageReference Include="ppy.osu.Framework" Version="2021.1004.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2021.1011.0" />
     <PackageReference Include="SharpCompress" Version="0.28.3" />
     <PackageReference Include="NUnit" Version="3.13.2" />
     <PackageReference Include="SharpRaven" Version="2.4.0" />

From b4092549c03f9a2d3076899518e26bb460e013d2 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 11 Oct 2021 16:35:36 +0900
Subject: [PATCH 0122/5547] Update framework

---
 osu.Android.props        | 2 +-
 osu.Game/osu.Game.csproj | 2 +-
 osu.iOS.props            | 4 ++--
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Android.props b/osu.Android.props
index 5a0e7479fa..fefc2f6438 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -52,7 +52,7 @@
   </ItemGroup>
   <ItemGroup>
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1004.0" />
-    <PackageReference Include="ppy.osu.Framework.Android" Version="2021.1004.0" />
+    <PackageReference Include="ppy.osu.Framework.Android" Version="2021.1011.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
     <!-- Realm needs to be directly referenced in all Xamarin projects, as it will not pull in its transitive dependencies otherwise. -->
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 4877ddf725..ff382f5227 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="10.6.0" />
-    <PackageReference Include="ppy.osu.Framework" Version="2021.1004.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2021.1011.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1004.0" />
     <PackageReference Include="Sentry" Version="3.9.4" />
     <PackageReference Include="SharpCompress" Version="0.29.0" />
diff --git a/osu.iOS.props b/osu.iOS.props
index edce9d27fe..fff0cbf418 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -70,7 +70,7 @@
     <Reference Include="System.Net.Http" />
   </ItemGroup>
   <ItemGroup Label="Package References">
-    <PackageReference Include="ppy.osu.Framework.iOS" Version="2021.1004.0" />
+    <PackageReference Include="ppy.osu.Framework.iOS" Version="2021.1011.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1004.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net5.0 / net6.0) -->
@@ -93,7 +93,7 @@
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="2.2.6" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.Core" Version="2.2.6" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
-    <PackageReference Include="ppy.osu.Framework" Version="2021.1004.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2021.1011.0" />
     <PackageReference Include="SharpCompress" Version="0.28.3" />
     <PackageReference Include="NUnit" Version="3.13.2" />
     <PackageReference Include="SharpRaven" Version="2.4.0" />

From 484a95229e64383a94a12851a5814047465a1b47 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 11 Oct 2021 16:36:04 +0900
Subject: [PATCH 0123/5547] Update toast implementations temporarily to
 expedite getting tests back in line

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

diff --git a/osu.Game/Overlays/OSD/TrackedSettingToast.cs b/osu.Game/Overlays/OSD/TrackedSettingToast.cs
index 51214fe460..198aa1438a 100644
--- a/osu.Game/Overlays/OSD/TrackedSettingToast.cs
+++ b/osu.Game/Overlays/OSD/TrackedSettingToast.cs
@@ -29,7 +29,7 @@ namespace osu.Game.Overlays.OSD
         private Sample sampleChange;
 
         public TrackedSettingToast(SettingDescription description)
-            : base(description.Name, description.Value, description.Shortcut)
+            : base(description.Name.ToString(), description.Value.ToString(), description.Shortcut.ToString())
         {
             FillFlowContainer<OptionLight> optionLights;
 

From 4fc84e71cdec64ce95d9c7157863fd9d3302d842 Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Mon, 11 Oct 2021 01:02:26 -0700
Subject: [PATCH 0124/5547] Localise more toast related strings

---
 osu.Game/Configuration/OsuConfigManager.cs    |  3 +-
 osu.Game/Localisation/ToastStrings.cs         | 39 +++++++++++++++++++
 osu.Game/OsuGame.cs                           |  2 +-
 .../Overlays/Music/MusicKeyBindingHandler.cs  |  9 +++--
 osu.Game/Overlays/OSD/Toast.cs                |  3 +-
 5 files changed, 49 insertions(+), 7 deletions(-)
 create mode 100644 osu.Game/Localisation/ToastStrings.cs

diff --git a/osu.Game/Configuration/OsuConfigManager.cs b/osu.Game/Configuration/OsuConfigManager.cs
index 9aa6372c66..b763d39c3b 100644
--- a/osu.Game/Configuration/OsuConfigManager.cs
+++ b/osu.Game/Configuration/OsuConfigManager.cs
@@ -7,6 +7,7 @@ using osu.Framework.Configuration;
 using osu.Framework.Configuration.Tracking;
 using osu.Framework.Extensions;
 using osu.Framework.Extensions.LocalisationExtensions;
+using osu.Framework.Localisation;
 using osu.Framework.Platform;
 using osu.Framework.Testing;
 using osu.Game.Input;
@@ -201,7 +202,7 @@ namespace osu.Game.Configuration
 
         public Func<int, string> LookupSkinName { private get; set; }
 
-        public Func<GlobalAction, string> LookupKeyBindings { get; set; }
+        public Func<GlobalAction, LocalisableString> LookupKeyBindings { get; set; }
     }
 
     // IMPORTANT: These are used in user configuration files.
diff --git a/osu.Game/Localisation/ToastStrings.cs b/osu.Game/Localisation/ToastStrings.cs
new file mode 100644
index 0000000000..52e75425bf
--- /dev/null
+++ b/osu.Game/Localisation/ToastStrings.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 ToastStrings
+    {
+        private const string prefix = @"osu.Game.Resources.Localisation.Toast";
+
+        /// <summary>
+        /// "no key bound"
+        /// </summary>
+        public static LocalisableString NoKeyBound => new TranslatableString(getKey(@"no_key_bound"), @"no key bound");
+
+        /// <summary>
+        /// "Music Playback"
+        /// </summary>
+        public static LocalisableString MusicPlayback => new TranslatableString(getKey(@"music_playback"), @"Music Playback");
+
+        /// <summary>
+        /// "Pause track"
+        /// </summary>
+        public static LocalisableString PauseTrack => new TranslatableString(getKey(@"pause_track"), @"Pause track");
+
+        /// <summary>
+        /// "Play track"
+        /// </summary>
+        public static LocalisableString PlayTrack => new TranslatableString(getKey(@"play_track"), @"Play track");
+
+        /// <summary>
+        /// "Restart track"
+        /// </summary>
+        public static LocalisableString RestartTrack => new TranslatableString(getKey(@"restart_track"), @"Restart track");
+
+        private static string getKey(string key) => $@"{prefix}:{key}";
+    }
+}
diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index 8a018f17d9..4bf122ace1 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -638,7 +638,7 @@ namespace osu.Game
                 var combinations = KeyBindingStore.GetReadableKeyCombinationsFor(l);
 
                 if (combinations.Count == 0)
-                    return "none";
+                    return ToastStrings.NoKeyBound;
 
                 return string.Join(" or ", combinations);
             };
diff --git a/osu.Game/Overlays/Music/MusicKeyBindingHandler.cs b/osu.Game/Overlays/Music/MusicKeyBindingHandler.cs
index 6fb7fb6591..18ec69e106 100644
--- a/osu.Game/Overlays/Music/MusicKeyBindingHandler.cs
+++ b/osu.Game/Overlays/Music/MusicKeyBindingHandler.cs
@@ -3,6 +3,7 @@
 
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
+using osu.Framework.Extensions.LocalisationExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Input.Bindings;
 using osu.Framework.Input.Events;
@@ -41,7 +42,7 @@ namespace osu.Game.Overlays.Music
                     bool wasPlaying = musicController.IsPlaying;
 
                     if (musicController.TogglePause())
-                        onScreenDisplay?.Display(new MusicActionToast(wasPlaying ? "Pause track" : "Play track", e.Action));
+                        onScreenDisplay?.Display(new MusicActionToast(wasPlaying ? ToastStrings.PauseTrack : ToastStrings.PlayTrack, e.Action));
                     return true;
 
                 case GlobalAction.MusicNext:
@@ -55,7 +56,7 @@ namespace osu.Game.Overlays.Music
                         switch (res)
                         {
                             case PreviousTrackResult.Restart:
-                                onScreenDisplay?.Display(new MusicActionToast("Restart track", e.Action));
+                                onScreenDisplay?.Display(new MusicActionToast(ToastStrings.RestartTrack, e.Action));
                                 break;
 
                             case PreviousTrackResult.Previous:
@@ -79,7 +80,7 @@ namespace osu.Game.Overlays.Music
             private readonly GlobalAction action;
 
             public MusicActionToast(LocalisableString value, GlobalAction action)
-                : base("Music Playback", value, string.Empty)
+                : base(ToastStrings.MusicPlayback, value, string.Empty)
             {
                 this.action = action;
             }
@@ -87,7 +88,7 @@ namespace osu.Game.Overlays.Music
             [BackgroundDependencyLoader]
             private void load(OsuConfigManager config)
             {
-                ShortcutText.Text = config.LookupKeyBindings(action).ToUpperInvariant();
+                ShortcutText.Text = config.LookupKeyBindings(action).ToUpper();
             }
         }
     }
diff --git a/osu.Game/Overlays/OSD/Toast.cs b/osu.Game/Overlays/OSD/Toast.cs
index 1289943123..12e30d8de2 100644
--- a/osu.Game/Overlays/OSD/Toast.cs
+++ b/osu.Game/Overlays/OSD/Toast.cs
@@ -10,6 +10,7 @@ using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
 using osuTK;
 using osuTK.Graphics;
+using osu.Game.Localisation;
 
 namespace osu.Game.Overlays.OSD
 {
@@ -81,7 +82,7 @@ namespace osu.Game.Overlays.OSD
                     Alpha = 0.3f,
                     Margin = new MarginPadding { Bottom = 15, Horizontal = 10 },
                     Font = OsuFont.GetFont(size: 12, weight: FontWeight.Bold),
-                    Text = string.IsNullOrEmpty(shortcut.ToString()) ? (LocalisableString)"NO KEY BOUND" : shortcut.ToUpper()
+                    Text = string.IsNullOrEmpty(shortcut.ToString()) ? ToastStrings.NoKeyBound.ToUpper() : shortcut.ToUpper()
                 },
             };
         }

From e0557e849ba823273f20c13fc75e7051dc305ee1 Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Mon, 11 Oct 2021 01:11:41 -0700
Subject: [PATCH 0125/5547] Join combinations with "/" instead

---
 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 4bf122ace1..a3b4d90d20 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -640,7 +640,7 @@ namespace osu.Game
                 if (combinations.Count == 0)
                     return ToastStrings.NoKeyBound;
 
-                return string.Join(" or ", combinations);
+                return string.Join(" / ", combinations);
             };
 
             Container logoContainer;

From 22e90076fb5e2c91ef55fa49d3c059ac69253c63 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 11 Oct 2021 18:05:45 +0900
Subject: [PATCH 0126/5547] Add temporary logging

---
 osu.Game/Audio/Effects/AudioFilter.cs | 13 +++++++++++--
 1 file changed, 11 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Audio/Effects/AudioFilter.cs b/osu.Game/Audio/Effects/AudioFilter.cs
index ee48bdd7d9..7a51d7be8f 100644
--- a/osu.Game/Audio/Effects/AudioFilter.cs
+++ b/osu.Game/Audio/Effects/AudioFilter.cs
@@ -1,11 +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 System.Diagnostics;
 using ManagedBass.Fx;
 using osu.Framework.Audio.Mixing;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
+using osu.Framework.Logging;
 
 namespace osu.Game.Audio.Effects
 {
@@ -130,8 +132,15 @@ namespace osu.Game.Audio.Effects
         {
             base.Dispose(isDisposing);
 
-            if (mixer.Effects.Contains(filter))
-                detachFilter();
+            try
+            {
+                if (mixer.Effects.Contains(filter))
+                    detachFilter();
+            }
+            catch (Exception e)
+            {
+                Logger.Log($"Exception in audio filter disposal: {e}");
+            }
         }
     }
 }

From 6aa054b5fa4dd5cad6a945e2fdc57c1786a7f3df Mon Sep 17 00:00:00 2001
From: Naxesss <30292137+Naxesss@users.noreply.github.com>
Date: Mon, 11 Oct 2021 13:53:23 +0200
Subject: [PATCH 0127/5547] Change to non-BASS error template

---
 osu.Game/Rulesets/Edit/Checks/CheckAudioInVideo.cs | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Rulesets/Edit/Checks/CheckAudioInVideo.cs b/osu.Game/Rulesets/Edit/Checks/CheckAudioInVideo.cs
index 467adcdfb6..5ac92f5bc3 100644
--- a/osu.Game/Rulesets/Edit/Checks/CheckAudioInVideo.cs
+++ b/osu.Game/Rulesets/Edit/Checks/CheckAudioInVideo.cs
@@ -17,8 +17,8 @@ namespace osu.Game.Rulesets.Edit.Checks
         public IEnumerable<IssueTemplate> PossibleTemplates => new IssueTemplate[]
         {
             new IssueTemplateHasAudioTrack(this),
-            new IssueTemplateBadFormat(this),
-            new IssueTemplateMissingFile(this)
+            new IssueTemplateMissingFile(this),
+            new IssueTemplateFileError(this)
         };
 
         public IEnumerable<Issue> Run(BeatmapVerifierContext context)
@@ -64,14 +64,14 @@ namespace osu.Game.Rulesets.Edit.Checks
             public Issue Create(string filename) => new Issue(this, filename);
         }
 
-        public class IssueTemplateBadFormat : IssueTemplate
+        public class IssueTemplateFileError : IssueTemplate
         {
-            public IssueTemplateBadFormat(ICheck check)
-                : base(check, IssueType.Error, "Could not check whether \"{0}\" has an audio track (code \"{1}\").")
+            public IssueTemplateFileError(ICheck check)
+                : base(check, IssueType.Error, "Could not check whether \"{0}\" has an audio track ({1}).")
             {
             }
 
-            public Issue Create(string filename) => new Issue(this, filename, Bass.LastError);
+            public Issue Create(string filename, string errorReason) => new Issue(this, filename, errorReason);
         }
 
         public class IssueTemplateMissingFile : IssueTemplate

From f0cd18a7210701235d115287ca6089b95ac06449 Mon Sep 17 00:00:00 2001
From: Naxesss <30292137+Naxesss@users.noreply.github.com>
Date: Mon, 11 Oct 2021 13:55:50 +0200
Subject: [PATCH 0128/5547] Only check each video file once

---
 .../Rulesets/Edit/Checks/CheckAudioInVideo.cs | 43 +++++++++++--------
 1 file changed, 25 insertions(+), 18 deletions(-)

diff --git a/osu.Game/Rulesets/Edit/Checks/CheckAudioInVideo.cs b/osu.Game/Rulesets/Edit/Checks/CheckAudioInVideo.cs
index 5ac92f5bc3..57a3af6a1c 100644
--- a/osu.Game/Rulesets/Edit/Checks/CheckAudioInVideo.cs
+++ b/osu.Game/Rulesets/Edit/Checks/CheckAudioInVideo.cs
@@ -24,6 +24,7 @@ namespace osu.Game.Rulesets.Edit.Checks
         public IEnumerable<Issue> Run(BeatmapVerifierContext context)
         {
             var beatmapSet = context.Beatmap.BeatmapInfo.BeatmapSet;
+            var videoPaths = new List<string>();
 
             foreach (var layer in context.WorkingBeatmap.Storyboard.Layers)
             {
@@ -32,26 +33,32 @@ namespace osu.Game.Rulesets.Edit.Checks
                     if (!(element is StoryboardVideo video))
                         continue;
 
-                    string filename = video.Path;
-                    string storagePath = beatmapSet.GetPathForFile(filename);
-
-                    if (storagePath == null)
-                    {
-                        // There's an element in the storyboard that requires this resource, so it being missing is worth warning about.
-                        yield return new IssueTemplateMissingFile(this).Create(filename);
-
-                        continue;
-                    }
-
-                    Stream data = context.WorkingBeatmap.GetStream(storagePath);
-                    var fileCallbacks = new FileCallbacks(new DataStreamFileProcedures(data));
-                    int decodeStream = Bass.CreateStream(StreamSystem.NoBuffer, BassFlags.Decode, fileCallbacks.Callbacks, fileCallbacks.Handle);
-                    if (decodeStream == 0)
-                        continue;
-
-                    yield return new IssueTemplateHasAudioTrack(this).Create(filename);
+                    // Ensures we don't check the same video file multiple times in case of multiple elements using it.
+                    if (!videoPaths.Contains(video.Path))
+                        videoPaths.Add(video.Path);
                 }
             }
+
+            foreach (var filename in videoPaths)
+            {
+                string storagePath = beatmapSet.GetPathForFile(filename);
+
+                if (storagePath == null)
+                {
+                    // There's an element in the storyboard that requires this resource, so it being missing is worth warning about.
+                    yield return new IssueTemplateMissingFile(this).Create(filename);
+
+                    continue;
+                }
+
+                Stream data = context.WorkingBeatmap.GetStream(storagePath);
+                var fileCallbacks = new FileCallbacks(new DataStreamFileProcedures(data));
+                int decodeStream = Bass.CreateStream(StreamSystem.NoBuffer, BassFlags.Decode, fileCallbacks.Callbacks, fileCallbacks.Handle);
+                if (decodeStream == 0)
+                    continue;
+
+                yield return new IssueTemplateHasAudioTrack(this).Create(filename);
+            }
         }
 
         public class IssueTemplateHasAudioTrack : IssueTemplate

From 8f093b9a11d5ec78a135b701e771cff4800a907d Mon Sep 17 00:00:00 2001
From: Naxesss <30292137+Naxesss@users.noreply.github.com>
Date: Mon, 11 Oct 2021 13:56:26 +0200
Subject: [PATCH 0129/5547] Use TagLib instead of ManagedBass

---
 .../FileAbstraction/StreamFileAbstraction.cs  | 26 ++++++++++++++++++
 .../Rulesets/Edit/Checks/CheckAudioInVideo.cs | 27 +++++++++++++++----
 osu.Game/osu.Game.csproj                      |  1 +
 3 files changed, 49 insertions(+), 5 deletions(-)
 create mode 100644 osu.Game/IO/FileAbstraction/StreamFileAbstraction.cs

diff --git a/osu.Game/IO/FileAbstraction/StreamFileAbstraction.cs b/osu.Game/IO/FileAbstraction/StreamFileAbstraction.cs
new file mode 100644
index 0000000000..602239aac5
--- /dev/null
+++ b/osu.Game/IO/FileAbstraction/StreamFileAbstraction.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.IO;
+
+namespace osu.Game.IO.FileAbstraction
+{
+    public class StreamFileAbstraction : TagLib.File.IFileAbstraction
+    {
+        public StreamFileAbstraction(string filename, Stream fileStream)
+        {
+            ReadStream = fileStream;
+            Name = filename;
+        }
+
+        public string Name { get; }
+
+        public Stream ReadStream { get; }
+        public Stream WriteStream => ReadStream;
+
+        public void CloseStream(Stream aStream)
+        {
+            aStream.Position = 0;
+        }
+    }
+}
diff --git a/osu.Game/Rulesets/Edit/Checks/CheckAudioInVideo.cs b/osu.Game/Rulesets/Edit/Checks/CheckAudioInVideo.cs
index 57a3af6a1c..af87e52c62 100644
--- a/osu.Game/Rulesets/Edit/Checks/CheckAudioInVideo.cs
+++ b/osu.Game/Rulesets/Edit/Checks/CheckAudioInVideo.cs
@@ -3,8 +3,7 @@
 
 using System.Collections.Generic;
 using System.IO;
-using ManagedBass;
-using osu.Framework.Audio.Callbacks;
+using osu.Game.IO.FileAbstraction;
 using osu.Game.Rulesets.Edit.Checks.Components;
 using osu.Game.Storyboards;
 
@@ -52,9 +51,27 @@ namespace osu.Game.Rulesets.Edit.Checks
                 }
 
                 Stream data = context.WorkingBeatmap.GetStream(storagePath);
-                var fileCallbacks = new FileCallbacks(new DataStreamFileProcedures(data));
-                int decodeStream = Bass.CreateStream(StreamSystem.NoBuffer, BassFlags.Decode, fileCallbacks.Callbacks, fileCallbacks.Handle);
-                if (decodeStream == 0)
+                StreamFileAbstraction fileAbstraction = new StreamFileAbstraction(filename, data);
+
+                // We use TagLib here for platform invariance; BASS cannot detect audio presence on Linux.
+                TagLib.File tagFile = null;
+                string errorReason = null;
+
+                try
+                {
+                    tagFile = TagLib.File.Create(fileAbstraction);
+                }
+                catch (TagLib.CorruptFileException) { errorReason = "Corrupt file"; }
+                catch (TagLib.UnsupportedFormatException) { errorReason = "Unsupported format"; }
+
+                if (errorReason != null)
+                {
+                    yield return new IssueTemplateFileError(this).Create(filename, errorReason);
+
+                    continue;
+                }
+
+                if (tagFile.Properties.AudioChannels == 0)
                     continue;
 
                 yield return new IssueTemplateHasAudioTrack(this).Create(filename);
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 357aa89329..d80d2ade82 100644
--- a/osu.Game/osu.Game.csproj
+++ b/osu.Game/osu.Game.csproj
@@ -42,5 +42,6 @@
     <PackageReference Include="SharpCompress" Version="0.28.3" />
     <PackageReference Include="NUnit" Version="3.13.2" />
     <PackageReference Include="System.ComponentModel.Annotations" Version="5.0.0" />
+    <PackageReference Include="TagLibSharp" Version="2.2.0" />
   </ItemGroup>
 </Project>

From b1ad3161dd33119d57cf42715aae1f74a1157be9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 11 Oct 2021 21:25:02 +0200
Subject: [PATCH 0130/5547] Add failing test case for frame stable clock
 direction flip scenario

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

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneFrameStabilityContainer.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneFrameStabilityContainer.cs
index 5eb71e92c2..881e3f097c 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneFrameStabilityContainer.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneFrameStabilityContainer.cs
@@ -103,6 +103,30 @@ namespace osu.Game.Tests.Visual.Gameplay
             checkFrameCount(0);
         }
 
+        [Test]
+        public void TestSeekToSameTimePreservesRate()
+        {
+            AddStep("set manual clock rate", () => manualClock.Rate = 1);
+            seekManualTo(5000);
+            createStabilityContainer();
+            checkRate(1);
+
+            seekManualTo(10000);
+            checkRate(1);
+
+            seekManualTo(10000);
+            checkRate(1);
+
+            seekManualTo(5000);
+            checkRate(-1);
+
+            seekManualTo(5000);
+            checkRate(-1);
+
+            seekManualTo(10000);
+            checkRate(1);
+        }
+
         private const int max_frames_catchup = 50;
 
         private void createStabilityContainer(double gameplayStartTime = double.MinValue) => AddStep("create container", () =>
@@ -116,6 +140,9 @@ namespace osu.Game.Tests.Visual.Gameplay
         private void checkFrameCount(int frames) =>
             AddAssert($"elapsed frames is {frames}", () => consumer.ElapsedFrames == frames);
 
+        private void checkRate(double rate) =>
+            AddAssert($"clock rate is {rate}", () => consumer.Clock.Rate == rate);
+
         public class ClockConsumingChild : CompositeDrawable
         {
             private readonly OsuSpriteText text;

From 56eae703fed67c5694004bf4d33d24b3ccb8dbad Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 11 Oct 2021 21:39:48 +0200
Subject: [PATCH 0131/5547] Avoid changing frame stable clock direction if time
 hasn't changed between frames

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

diff --git a/osu.Game/Rulesets/UI/FrameStabilityContainer.cs b/osu.Game/Rulesets/UI/FrameStabilityContainer.cs
index e9865f6c8b..c0b339a231 100644
--- a/osu.Game/Rulesets/UI/FrameStabilityContainer.cs
+++ b/osu.Game/Rulesets/UI/FrameStabilityContainer.cs
@@ -55,7 +55,10 @@ namespace osu.Game.Rulesets.UI
         /// <summary>
         /// The current direction of playback to be exposed to frame stable children.
         /// </summary>
-        private int direction;
+        /// <remarks>
+        /// Initially it is presumed that playback will proceed in the forward direction.
+        /// </remarks>
+        private int direction = 1;
 
         [BackgroundDependencyLoader(true)]
         private void load(GameplayClock clock, ISamplePlaybackDisabler sampleDisabler)
@@ -139,7 +142,9 @@ namespace osu.Game.Rulesets.UI
                     state = PlaybackState.NotValid;
             }
 
-            if (state == PlaybackState.Valid)
+            // 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)
                 direction = proposedTime >= manualClock.CurrentTime ? 1 : -1;
 
             double timeBehind = Math.Abs(proposedTime - parentGameplayClock.CurrentTime);

From ff382259ca2048be6399eacc31b79df491e96dee Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 11 Oct 2021 23:10:56 +0200
Subject: [PATCH 0132/5547] Use rounded buttons in tablet rotation preset
 settings

---
 .../Settings/TestSceneTabletSettings.cs       |  4 +
 .../Sections/Input/RotationPresetButtons.cs   | 74 ++++++++++++-------
 2 files changed, 52 insertions(+), 26 deletions(-)

diff --git a/osu.Game.Tests/Visual/Settings/TestSceneTabletSettings.cs b/osu.Game.Tests/Visual/Settings/TestSceneTabletSettings.cs
index 997eac709d..dc5b0e0d77 100644
--- a/osu.Game.Tests/Visual/Settings/TestSceneTabletSettings.cs
+++ b/osu.Game.Tests/Visual/Settings/TestSceneTabletSettings.cs
@@ -3,6 +3,7 @@
 
 using System.Linq;
 using NUnit.Framework;
+using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Input.Handlers.Tablet;
@@ -21,6 +22,9 @@ namespace osu.Game.Tests.Visual.Settings
         private TestTabletHandler tabletHandler;
         private TabletSettings settings;
 
+        [Cached]
+        private OverlayColourProvider colourProvider = new OverlayColourProvider(OverlayColourScheme.Purple);
+
         [SetUpSteps]
         public void SetUpSteps()
         {
diff --git a/osu.Game/Overlays/Settings/Sections/Input/RotationPresetButtons.cs b/osu.Game/Overlays/Settings/Sections/Input/RotationPresetButtons.cs
index 26610628d5..3ef5ce8941 100644
--- a/osu.Game/Overlays/Settings/Sections/Input/RotationPresetButtons.cs
+++ b/osu.Game/Overlays/Settings/Sections/Input/RotationPresetButtons.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.Bindables;
@@ -8,16 +9,24 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Input.Handlers.Tablet;
 using osu.Game.Graphics;
-using osu.Game.Graphics.UserInterface;
+using osu.Game.Graphics.UserInterfaceV2;
 
 namespace osu.Game.Overlays.Settings.Sections.Input
 {
-    internal class RotationPresetButtons : FillFlowContainer
+    internal class RotationPresetButtons : CompositeDrawable
     {
+        public new MarginPadding Padding
+        {
+            get => base.Padding;
+            set => base.Padding = value;
+        }
+
         private readonly ITabletHandler tabletHandler;
 
         private Bindable<float> rotation;
+        private readonly RotationButton[] rotationPresets = new RotationButton[preset_count];
 
+        private const int preset_count = 4;
         private const int height = 50;
 
         public RotationPresetButtons(ITabletHandler tabletHandler)
@@ -27,18 +36,39 @@ namespace osu.Game.Overlays.Settings.Sections.Input
             RelativeSizeAxes = Axes.X;
             Height = height;
 
-            for (int i = 0; i < 360; i += 90)
+            IEnumerable<Dimension> createColumns(int count)
             {
-                var presetRotation = i;
-
-                Add(new RotationButton(i)
+                for (int i = 0; i < count; ++i)
                 {
-                    RelativeSizeAxes = Axes.X,
-                    Height = height,
-                    Width = 0.25f,
-                    Text = $@"{presetRotation}º",
-                    Action = () => tabletHandler.Rotation.Value = presetRotation,
-                });
+                    if (i > 0)
+                        yield return new Dimension(GridSizeMode.Absolute, 10);
+
+                    yield return new Dimension();
+                }
+            }
+
+            GridContainer grid;
+
+            InternalChild = grid = new GridContainer
+            {
+                RelativeSizeAxes = Axes.Both,
+                ColumnDimensions = createColumns(preset_count).ToArray()
+            };
+
+            grid.Content = new[] { new Drawable[preset_count * 2 - 1] };
+
+            for (int i = 0; i < preset_count; i++)
+            {
+                var rotationValue = i * 90;
+
+                var rotationPreset = new RotationButton(rotationValue)
+                {
+                    RelativeSizeAxes = Axes.Both,
+                    Height = 1,
+                    Text = $@"{rotationValue}º",
+                    Action = () => tabletHandler.Rotation.Value = rotationValue,
+                };
+                grid.Content[0][2 * i] = rotationPresets[i] = rotationPreset;
             }
         }
 
@@ -49,16 +79,19 @@ namespace osu.Game.Overlays.Settings.Sections.Input
             rotation = tabletHandler.Rotation.GetBoundCopy();
             rotation.BindValueChanged(val =>
             {
-                foreach (var b in Children.OfType<RotationButton>())
+                foreach (var b in rotationPresets)
                     b.IsSelected = b.Preset == val.NewValue;
             }, true);
         }
 
-        public class RotationButton : TriangleButton
+        public class RotationButton : RoundedButton
         {
             [Resolved]
             private OsuColour colours { get; set; }
 
+            [Resolved]
+            private OverlayColourProvider colourProvider { get; set; }
+
             public readonly int Preset;
 
             public RotationButton(int preset)
@@ -91,18 +124,7 @@ namespace osu.Game.Overlays.Settings.Sections.Input
 
             private void updateColour()
             {
-                if (isSelected)
-                {
-                    BackgroundColour = colours.BlueDark;
-                    Triangles.ColourDark = colours.BlueDarker;
-                    Triangles.ColourLight = colours.Blue;
-                }
-                else
-                {
-                    BackgroundColour = colours.Gray4;
-                    Triangles.ColourDark = colours.Gray5;
-                    Triangles.ColourLight = colours.Gray6;
-                }
+                BackgroundColour = isSelected ? colours.Blue3 : colourProvider.Background3;
             }
         }
     }

From ce69dd35884cc2db5fc86c8927ab58393a43891a Mon Sep 17 00:00:00 2001
From: Naxesss <30292137+Naxesss@users.noreply.github.com>
Date: Mon, 11 Oct 2021 23:57:23 +0200
Subject: [PATCH 0133/5547] Use `Prescan` flag for audio length check

---
 osu.Game/Rulesets/Edit/Checks/CheckTooShortAudioFiles.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Rulesets/Edit/Checks/CheckTooShortAudioFiles.cs b/osu.Game/Rulesets/Edit/Checks/CheckTooShortAudioFiles.cs
index ad9601c964..5c0969d29f 100644
--- a/osu.Game/Rulesets/Edit/Checks/CheckTooShortAudioFiles.cs
+++ b/osu.Game/Rulesets/Edit/Checks/CheckTooShortAudioFiles.cs
@@ -36,7 +36,7 @@ namespace osu.Game.Rulesets.Edit.Checks
                     continue;
 
                 var fileCallbacks = new FileCallbacks(new DataStreamFileProcedures(data));
-                int decodeStream = Bass.CreateStream(StreamSystem.NoBuffer, BassFlags.Decode, fileCallbacks.Callbacks, fileCallbacks.Handle);
+                int decodeStream = Bass.CreateStream(StreamSystem.NoBuffer, BassFlags.Decode | BassFlags.Prescan, fileCallbacks.Callbacks, fileCallbacks.Handle);
 
                 if (decodeStream == 0)
                 {

From 01d77fb741f2c7aa9661c5421b76efaefb4cca1b Mon Sep 17 00:00:00 2001
From: Naxesss <30292137+Naxesss@users.noreply.github.com>
Date: Mon, 11 Oct 2021 23:58:06 +0200
Subject: [PATCH 0134/5547] Remove redundant `Bass.Init` call in test setup

---
 osu.Game.Tests/Editing/Checks/CheckAudioInVideoTest.cs | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/osu.Game.Tests/Editing/Checks/CheckAudioInVideoTest.cs b/osu.Game.Tests/Editing/Checks/CheckAudioInVideoTest.cs
index 2dcd37123d..04baf7d854 100644
--- a/osu.Game.Tests/Editing/Checks/CheckAudioInVideoTest.cs
+++ b/osu.Game.Tests/Editing/Checks/CheckAudioInVideoTest.cs
@@ -4,7 +4,6 @@
 using System.Collections.Generic;
 using System.IO;
 using System.Linq;
-using ManagedBass;
 using Moq;
 using NUnit.Framework;
 using osu.Game.Beatmaps;
@@ -14,7 +13,6 @@ using osu.Game.Rulesets.Objects;
 using osu.Game.Storyboards;
 using osu.Game.Tests.Beatmaps;
 using osu.Game.Tests.Resources;
-using osuTK.Audio;
 using FileInfo = osu.Game.IO.FileInfo;
 
 namespace osu.Game.Tests.Editing.Checks
@@ -46,10 +44,6 @@ namespace osu.Game.Tests.Editing.Checks
                     }
                 }
             };
-
-            // 0 = No output device. This still allows decoding.
-            if (!Bass.Init(0) && Bass.LastError != Errors.Already)
-                throw new AudioException("Could not initialize Bass.");
         }
 
         [Test]

From 47b4d0314596c0bfc85f51ccbf5934c8d39c6a34 Mon Sep 17 00:00:00 2001
From: Naxesss <30292137+Naxesss@users.noreply.github.com>
Date: Tue, 12 Oct 2021 00:13:38 +0200
Subject: [PATCH 0135/5547] Dispose of `Stream`s when used

---
 osu.Game.Tests/Editing/Checks/CheckAudioInVideoTest.cs    | 2 +-
 .../Editing/Checks/CheckTooShortAudioFilesTest.cs         | 2 +-
 osu.Game/Rulesets/Edit/Checks/CheckAudioInVideo.cs        | 8 ++++++--
 osu.Game/Rulesets/Edit/Checks/CheckTooShortAudioFiles.cs  | 2 +-
 osu.Game/Rulesets/Edit/Checks/CheckZeroByteFiles.cs       | 2 +-
 5 files changed, 10 insertions(+), 6 deletions(-)

diff --git a/osu.Game.Tests/Editing/Checks/CheckAudioInVideoTest.cs b/osu.Game.Tests/Editing/Checks/CheckAudioInVideoTest.cs
index 04baf7d854..eb35fa1d0f 100644
--- a/osu.Game.Tests/Editing/Checks/CheckAudioInVideoTest.cs
+++ b/osu.Game.Tests/Editing/Checks/CheckAudioInVideoTest.cs
@@ -83,7 +83,7 @@ namespace osu.Game.Tests.Editing.Checks
 
         private BeatmapVerifierContext getContext(string resourceName, bool allowMissing = false)
         {
-            Stream resourceStream = string.IsNullOrEmpty(resourceName) ? null : TestResources.OpenResource(resourceName);
+            using Stream resourceStream = string.IsNullOrEmpty(resourceName) ? null : TestResources.OpenResource(resourceName);
             if (!allowMissing && resourceStream == null)
                 throw new FileNotFoundException($"The requested test resource \"{resourceName}\" does not exist.");
 
diff --git a/osu.Game.Tests/Editing/Checks/CheckTooShortAudioFilesTest.cs b/osu.Game.Tests/Editing/Checks/CheckTooShortAudioFilesTest.cs
index e978af5e49..e95665156f 100644
--- a/osu.Game.Tests/Editing/Checks/CheckTooShortAudioFilesTest.cs
+++ b/osu.Game.Tests/Editing/Checks/CheckTooShortAudioFilesTest.cs
@@ -104,7 +104,7 @@ namespace osu.Game.Tests.Editing.Checks
 
         private BeatmapVerifierContext getContext(string resourceName, bool allowMissing = false)
         {
-            Stream resourceStream = string.IsNullOrEmpty(resourceName) ? null : TestResources.OpenResource(resourceName);
+            using Stream resourceStream = string.IsNullOrEmpty(resourceName) ? null : TestResources.OpenResource(resourceName);
             if (!allowMissing && resourceStream == null)
                 throw new FileNotFoundException($"The requested test resource \"{resourceName}\" does not exist.");
 
diff --git a/osu.Game/Rulesets/Edit/Checks/CheckAudioInVideo.cs b/osu.Game/Rulesets/Edit/Checks/CheckAudioInVideo.cs
index af87e52c62..fd742ba384 100644
--- a/osu.Game/Rulesets/Edit/Checks/CheckAudioInVideo.cs
+++ b/osu.Game/Rulesets/Edit/Checks/CheckAudioInVideo.cs
@@ -50,8 +50,12 @@ namespace osu.Game.Rulesets.Edit.Checks
                     continue;
                 }
 
-                Stream data = context.WorkingBeatmap.GetStream(storagePath);
-                StreamFileAbstraction fileAbstraction = new StreamFileAbstraction(filename, data);
+                StreamFileAbstraction fileAbstraction;
+
+                using (Stream data = context.WorkingBeatmap.GetStream(storagePath))
+                {
+                    fileAbstraction = new StreamFileAbstraction(filename, data);
+                }
 
                 // We use TagLib here for platform invariance; BASS cannot detect audio presence on Linux.
                 TagLib.File tagFile = null;
diff --git a/osu.Game/Rulesets/Edit/Checks/CheckTooShortAudioFiles.cs b/osu.Game/Rulesets/Edit/Checks/CheckTooShortAudioFiles.cs
index 5c0969d29f..c3faf6edc1 100644
--- a/osu.Game/Rulesets/Edit/Checks/CheckTooShortAudioFiles.cs
+++ b/osu.Game/Rulesets/Edit/Checks/CheckTooShortAudioFiles.cs
@@ -31,7 +31,7 @@ namespace osu.Game.Rulesets.Edit.Checks
 
             foreach (var file in beatmapSet.Files)
             {
-                Stream data = context.WorkingBeatmap.GetStream(file.FileInfo.StoragePath);
+                using Stream data = context.WorkingBeatmap.GetStream(file.FileInfo.StoragePath);
                 if (data == null)
                     continue;
 
diff --git a/osu.Game/Rulesets/Edit/Checks/CheckZeroByteFiles.cs b/osu.Game/Rulesets/Edit/Checks/CheckZeroByteFiles.cs
index 932d216d94..406ec013d7 100644
--- a/osu.Game/Rulesets/Edit/Checks/CheckZeroByteFiles.cs
+++ b/osu.Game/Rulesets/Edit/Checks/CheckZeroByteFiles.cs
@@ -22,7 +22,7 @@ namespace osu.Game.Rulesets.Edit.Checks
 
             foreach (var file in beatmapSet.Files)
             {
-                Stream data = context.WorkingBeatmap.GetStream(file.FileInfo.StoragePath);
+                using Stream data = context.WorkingBeatmap.GetStream(file.FileInfo.StoragePath);
                 if (data?.Length == 0)
                     yield return new IssueTemplateZeroBytes(this).Create(file.Filename);
             }

From d4779f06cf1c2d8eae68d7d63583a3e34c629567 Mon Sep 17 00:00:00 2001
From: Naxesss <30292137+Naxesss@users.noreply.github.com>
Date: Tue, 12 Oct 2021 00:30:00 +0200
Subject: [PATCH 0136/5547] Rework `CloseStream`

---
 osu.Game/IO/FileAbstraction/StreamFileAbstraction.cs | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/osu.Game/IO/FileAbstraction/StreamFileAbstraction.cs b/osu.Game/IO/FileAbstraction/StreamFileAbstraction.cs
index 602239aac5..f5709b5158 100644
--- a/osu.Game/IO/FileAbstraction/StreamFileAbstraction.cs
+++ b/osu.Game/IO/FileAbstraction/StreamFileAbstraction.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.IO;
 
 namespace osu.Game.IO.FileAbstraction
@@ -18,9 +19,12 @@ namespace osu.Game.IO.FileAbstraction
         public Stream ReadStream { get; }
         public Stream WriteStream => ReadStream;
 
-        public void CloseStream(Stream aStream)
+        public void CloseStream(Stream stream)
         {
-            aStream.Position = 0;
+            if (stream == null)
+                throw new ArgumentNullException(nameof(stream));
+
+            stream.Close();
         }
     }
 }

From bb9cbd3e66ecc3306ea6e2ca9d6e39bc51b9135e Mon Sep 17 00:00:00 2001
From: Naxesss <30292137+Naxesss@users.noreply.github.com>
Date: Tue, 12 Oct 2021 00:35:58 +0200
Subject: [PATCH 0137/5547] Undo disposal of `Stream` for use in mocking

Because the Stream object is accessed when the mocked object calls `GetStream`, we cannot close it here.

The resource should be released upon teardown anyway.
---
 osu.Game.Tests/Editing/Checks/CheckAudioInVideoTest.cs       | 2 +-
 osu.Game.Tests/Editing/Checks/CheckTooShortAudioFilesTest.cs | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Editing/Checks/CheckAudioInVideoTest.cs b/osu.Game.Tests/Editing/Checks/CheckAudioInVideoTest.cs
index eb35fa1d0f..04baf7d854 100644
--- a/osu.Game.Tests/Editing/Checks/CheckAudioInVideoTest.cs
+++ b/osu.Game.Tests/Editing/Checks/CheckAudioInVideoTest.cs
@@ -83,7 +83,7 @@ namespace osu.Game.Tests.Editing.Checks
 
         private BeatmapVerifierContext getContext(string resourceName, bool allowMissing = false)
         {
-            using Stream resourceStream = string.IsNullOrEmpty(resourceName) ? null : TestResources.OpenResource(resourceName);
+            Stream resourceStream = string.IsNullOrEmpty(resourceName) ? null : TestResources.OpenResource(resourceName);
             if (!allowMissing && resourceStream == null)
                 throw new FileNotFoundException($"The requested test resource \"{resourceName}\" does not exist.");
 
diff --git a/osu.Game.Tests/Editing/Checks/CheckTooShortAudioFilesTest.cs b/osu.Game.Tests/Editing/Checks/CheckTooShortAudioFilesTest.cs
index e95665156f..e978af5e49 100644
--- a/osu.Game.Tests/Editing/Checks/CheckTooShortAudioFilesTest.cs
+++ b/osu.Game.Tests/Editing/Checks/CheckTooShortAudioFilesTest.cs
@@ -104,7 +104,7 @@ namespace osu.Game.Tests.Editing.Checks
 
         private BeatmapVerifierContext getContext(string resourceName, bool allowMissing = false)
         {
-            using Stream resourceStream = string.IsNullOrEmpty(resourceName) ? null : TestResources.OpenResource(resourceName);
+            Stream resourceStream = string.IsNullOrEmpty(resourceName) ? null : TestResources.OpenResource(resourceName);
             if (!allowMissing && resourceStream == null)
                 throw new FileNotFoundException($"The requested test resource \"{resourceName}\" does not exist.");
 

From f2f97602f289ae1695f93a5fd97e2e8e74ad215f Mon Sep 17 00:00:00 2001
From: Naxesss <30292137+Naxesss@users.noreply.github.com>
Date: Tue, 12 Oct 2021 00:40:39 +0200
Subject: [PATCH 0138/5547] Dispose of video resource later

We need the Stream to stay open here because `StreamFileAbstraction` uses it later in the block.
---
 osu.Game/Rulesets/Edit/Checks/CheckAudioInVideo.cs | 8 ++------
 1 file changed, 2 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Rulesets/Edit/Checks/CheckAudioInVideo.cs b/osu.Game/Rulesets/Edit/Checks/CheckAudioInVideo.cs
index fd742ba384..2baa633399 100644
--- a/osu.Game/Rulesets/Edit/Checks/CheckAudioInVideo.cs
+++ b/osu.Game/Rulesets/Edit/Checks/CheckAudioInVideo.cs
@@ -50,12 +50,8 @@ namespace osu.Game.Rulesets.Edit.Checks
                     continue;
                 }
 
-                StreamFileAbstraction fileAbstraction;
-
-                using (Stream data = context.WorkingBeatmap.GetStream(storagePath))
-                {
-                    fileAbstraction = new StreamFileAbstraction(filename, data);
-                }
+                using Stream data = context.WorkingBeatmap.GetStream(storagePath);
+                var fileAbstraction = new StreamFileAbstraction(filename, data);
 
                 // We use TagLib here for platform invariance; BASS cannot detect audio presence on Linux.
                 TagLib.File tagFile = null;

From 82f7f99f37a5cb7dfdd37b2e6a98bb9b85b548b7 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 12 Oct 2021 10:46:26 +0900
Subject: [PATCH 0139/5547] Refactor to use scoped `using` (and also correctly
 dispose TagLib portion)

---
 .../Rulesets/Edit/Checks/CheckAudioInVideo.cs | 37 ++++++++--------
 .../Edit/Checks/CheckTooShortAudioFiles.cs    | 42 ++++++++++---------
 .../Edit/Checks/CheckZeroByteFiles.cs         |  8 ++--
 3 files changed, 46 insertions(+), 41 deletions(-)

diff --git a/osu.Game/Rulesets/Edit/Checks/CheckAudioInVideo.cs b/osu.Game/Rulesets/Edit/Checks/CheckAudioInVideo.cs
index 2baa633399..ac2542beb0 100644
--- a/osu.Game/Rulesets/Edit/Checks/CheckAudioInVideo.cs
+++ b/osu.Game/Rulesets/Edit/Checks/CheckAudioInVideo.cs
@@ -6,6 +6,8 @@ using System.IO;
 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
 {
@@ -50,31 +52,30 @@ namespace osu.Game.Rulesets.Edit.Checks
                     continue;
                 }
 
-                using Stream data = context.WorkingBeatmap.GetStream(storagePath);
-                var fileAbstraction = new StreamFileAbstraction(filename, data);
-
-                // We use TagLib here for platform invariance; BASS cannot detect audio presence on Linux.
-                TagLib.File tagFile = null;
-                string errorReason = null;
+                Issue issue;
 
                 try
                 {
-                    tagFile = TagLib.File.Create(fileAbstraction);
-                }
-                catch (TagLib.CorruptFileException) { errorReason = "Corrupt file"; }
-                catch (TagLib.UnsupportedFormatException) { errorReason = "Unsupported format"; }
+                    // We use TagLib here for platform invariance; BASS cannot detect audio presence on Linux.
+                    using (Stream data = context.WorkingBeatmap.GetStream(storagePath))
+                    using (File tagFile = File.Create(new StreamFileAbstraction(filename, data)))
+                    {
+                        if (tagFile.Properties.AudioChannels == 0)
+                            continue;
+                    }
 
-                if (errorReason != null)
+                    issue = new IssueTemplateHasAudioTrack(this).Create(filename);
+                }
+                catch (CorruptFileException)
                 {
-                    yield return new IssueTemplateFileError(this).Create(filename, errorReason);
-
-                    continue;
+                    issue = new IssueTemplateFileError(this).Create(filename, "Corrupt file");
+                }
+                catch (UnsupportedFormatException)
+                {
+                    issue = new IssueTemplateFileError(this).Create(filename, "Unsupported format");
                 }
 
-                if (tagFile.Properties.AudioChannels == 0)
-                    continue;
-
-                yield return new IssueTemplateHasAudioTrack(this).Create(filename);
+                yield return issue;
             }
         }
 
diff --git a/osu.Game/Rulesets/Edit/Checks/CheckTooShortAudioFiles.cs b/osu.Game/Rulesets/Edit/Checks/CheckTooShortAudioFiles.cs
index c3faf6edc1..57f7c60916 100644
--- a/osu.Game/Rulesets/Edit/Checks/CheckTooShortAudioFiles.cs
+++ b/osu.Game/Rulesets/Edit/Checks/CheckTooShortAudioFiles.cs
@@ -31,29 +31,31 @@ namespace osu.Game.Rulesets.Edit.Checks
 
             foreach (var file in beatmapSet.Files)
             {
-                using Stream data = context.WorkingBeatmap.GetStream(file.FileInfo.StoragePath);
-                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 (decodeStream == 0)
+                using (Stream data = context.WorkingBeatmap.GetStream(file.FileInfo.StoragePath))
                 {
-                    // 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 (hasAudioExtension(file.Filename) && probablyHasAudioData(data))
-                        yield return new IssueTemplateBadFormat(this).Create(file.Filename);
+                    if (data == null)
+                        continue;
 
-                    continue;
+                    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 (hasAudioExtension(file.Filename) && probablyHasAudioData(data))
+                            yield return new IssueTemplateBadFormat(this).Create(file.Filename);
+
+                        continue;
+                    }
+
+                    long length = Bass.ChannelGetLength(decodeStream);
+                    double ms = Bass.ChannelBytes2Seconds(decodeStream, length) * 1000;
+
+                    // Extremely short audio files do not play on some soundcards, resulting in nothing being heard in-game for some users.
+                    if (ms > 0 && ms < ms_threshold)
+                        yield return new IssueTemplateTooShort(this).Create(file.Filename, ms);
                 }
-
-                long length = Bass.ChannelGetLength(decodeStream);
-                double ms = Bass.ChannelBytes2Seconds(decodeStream, length) * 1000;
-
-                // Extremely short audio files do not play on some soundcards, resulting in nothing being heard in-game for some users.
-                if (ms > 0 && ms < ms_threshold)
-                    yield return new IssueTemplateTooShort(this).Create(file.Filename, ms);
             }
         }
 
diff --git a/osu.Game/Rulesets/Edit/Checks/CheckZeroByteFiles.cs b/osu.Game/Rulesets/Edit/Checks/CheckZeroByteFiles.cs
index 406ec013d7..3a994fabfa 100644
--- a/osu.Game/Rulesets/Edit/Checks/CheckZeroByteFiles.cs
+++ b/osu.Game/Rulesets/Edit/Checks/CheckZeroByteFiles.cs
@@ -22,9 +22,11 @@ namespace osu.Game.Rulesets.Edit.Checks
 
             foreach (var file in beatmapSet.Files)
             {
-                using Stream data = context.WorkingBeatmap.GetStream(file.FileInfo.StoragePath);
-                if (data?.Length == 0)
-                    yield return new IssueTemplateZeroBytes(this).Create(file.Filename);
+                using (Stream data = context.WorkingBeatmap.GetStream(file.FileInfo.StoragePath))
+                {
+                    if (data?.Length == 0)
+                        yield return new IssueTemplateZeroBytes(this).Create(file.Filename);
+                }
             }
         }
 

From 7f95400f466beafe6fa94c002cfd6ed8dc3f4f94 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 12 Oct 2021 10:57:54 +0900
Subject: [PATCH 0140/5547] Add proper stream disposal to tests

---
 .../Editing/Checks/CheckAudioInVideoTest.cs   | 29 +++++++------
 .../Checks/CheckTooShortAudioFilesTest.cs     | 41 ++++++++++++-------
 2 files changed, 42 insertions(+), 28 deletions(-)

diff --git a/osu.Game.Tests/Editing/Checks/CheckAudioInVideoTest.cs b/osu.Game.Tests/Editing/Checks/CheckAudioInVideoTest.cs
index 04baf7d854..f3a4f10210 100644
--- a/osu.Game.Tests/Editing/Checks/CheckAudioInVideoTest.cs
+++ b/osu.Game.Tests/Editing/Checks/CheckAudioInVideoTest.cs
@@ -49,25 +49,32 @@ namespace osu.Game.Tests.Editing.Checks
         [Test]
         public void TestRegularVideoFile()
         {
-            Assert.IsEmpty(check.Run(getContext("Videos/test-video.mp4")));
+            using (var resourceStream = TestResources.OpenResource("Videos/test-video.mp4"))
+                Assert.IsEmpty(check.Run(getContext(resourceStream)));
         }
 
         [Test]
         public void TestVideoFileWithAudio()
         {
-            var issues = check.Run(getContext("Videos/test-video-with-audio.mp4")).ToList();
+            using (var resourceStream = TestResources.OpenResource("Videos/test-video-with-audio.mp4"))
+            {
+                var issues = check.Run(getContext(resourceStream)).ToList();
 
-            Assert.That(issues, Has.Count.EqualTo(1));
-            Assert.That(issues.Single().Template is CheckAudioInVideo.IssueTemplateHasAudioTrack);
+                Assert.That(issues, Has.Count.EqualTo(1));
+                Assert.That(issues.Single().Template is CheckAudioInVideo.IssueTemplateHasAudioTrack);
+            }
         }
 
         [Test]
         public void TestVideoFileWithTrackButNoAudio()
         {
-            var issues = check.Run(getContext("Videos/test-video-with-track-but-no-audio.mp4")).ToList();
+            using (var resourceStream = TestResources.OpenResource("Videos/test-video-with-track-but-no-audio.mp4"))
+            {
+                var issues = check.Run(getContext(resourceStream)).ToList();
 
-            Assert.That(issues, Has.Count.EqualTo(1));
-            Assert.That(issues.Single().Template is CheckAudioInVideo.IssueTemplateHasAudioTrack);
+                Assert.That(issues, Has.Count.EqualTo(1));
+                Assert.That(issues.Single().Template is CheckAudioInVideo.IssueTemplateHasAudioTrack);
+            }
         }
 
         [Test]
@@ -75,18 +82,14 @@ namespace osu.Game.Tests.Editing.Checks
         {
             beatmap.BeatmapInfo.BeatmapSet.Files.Clear();
 
-            var issues = check.Run(getContext("Videos/missing.mp4", allowMissing: true)).ToList();
+            var issues = check.Run(getContext(null)).ToList();
 
             Assert.That(issues, Has.Count.EqualTo(1));
             Assert.That(issues.Single().Template is CheckAudioInVideo.IssueTemplateMissingFile);
         }
 
-        private BeatmapVerifierContext getContext(string resourceName, bool allowMissing = false)
+        private BeatmapVerifierContext getContext(Stream resourceStream)
         {
-            Stream resourceStream = string.IsNullOrEmpty(resourceName) ? null : TestResources.OpenResource(resourceName);
-            if (!allowMissing && resourceStream == null)
-                throw new FileNotFoundException($"The requested test resource \"{resourceName}\" does not exist.");
-
             var storyboard = new Storyboard();
             var layer = storyboard.GetLayer("Video");
             layer.Add(new StoryboardVideo("abc123.mp4", 0));
diff --git a/osu.Game.Tests/Editing/Checks/CheckTooShortAudioFilesTest.cs b/osu.Game.Tests/Editing/Checks/CheckTooShortAudioFilesTest.cs
index e978af5e49..9b090591bc 100644
--- a/osu.Game.Tests/Editing/Checks/CheckTooShortAudioFilesTest.cs
+++ b/osu.Game.Tests/Editing/Checks/CheckTooShortAudioFilesTest.cs
@@ -68,46 +68,57 @@ namespace osu.Game.Tests.Editing.Checks
         [Test]
         public void TestRegularAudioFile()
         {
-            Assert.IsEmpty(check.Run(getContext("Samples/test-sample.mp3")));
+            using (var resourceStream = TestResources.OpenResource("Samples/test-sample.mp3"))
+            {
+                Assert.IsEmpty(check.Run(getContext(resourceStream)));
+            }
         }
 
         [Test]
         public void TestBlankAudioFile()
         {
-            // This is a 0 ms duration audio file, commonly used to silence sliderslides/ticks, and so should be fine.
-            Assert.IsEmpty(check.Run(getContext("Samples/blank.wav")));
+            using (var resourceStream = TestResources.OpenResource("Samples/blank.wav"))
+            {
+                // This is a 0 ms duration audio file, commonly used to silence sliderslides/ticks, and so should be fine.
+                Assert.IsEmpty(check.Run(getContext(resourceStream)));
+            }
         }
 
         [Test]
         public void TestTooShortAudioFile()
         {
-            var issues = check.Run(getContext("Samples/test-sample-cut.mp3")).ToList();
+            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 CheckTooShortAudioFiles.IssueTemplateTooShort);
+                Assert.That(issues, Has.Count.EqualTo(1));
+                Assert.That(issues.Single().Template is CheckTooShortAudioFiles.IssueTemplateTooShort);
+            }
         }
 
         [Test]
         public void TestMissingAudioFile()
         {
-            Assert.IsEmpty(check.Run(getContext("Samples/missing.mp3", allowMissing: true)));
+            using (var resourceStream = TestResources.OpenResource("Samples/missing.mp3"))
+            {
+                Assert.IsEmpty(check.Run(getContext(resourceStream, allowMissing: true)));
+            }
         }
 
         [Test]
         public void TestCorruptAudioFile()
         {
-            var issues = check.Run(getContext("Samples/corrupt.wav")).ToList();
+            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);
+                Assert.That(issues, Has.Count.EqualTo(1));
+                Assert.That(issues.Single().Template is CheckTooShortAudioFiles.IssueTemplateBadFormat);
+            }
         }
 
-        private BeatmapVerifierContext getContext(string resourceName, bool allowMissing = false)
+        private BeatmapVerifierContext getContext(Stream resourceStream, bool allowMissing = false)
         {
-            Stream resourceStream = string.IsNullOrEmpty(resourceName) ? null : TestResources.OpenResource(resourceName);
-            if (!allowMissing && resourceStream == null)
-                throw new FileNotFoundException($"The requested test resource \"{resourceName}\" does not exist.");
-
             var mockWorkingBeatmap = new Mock<TestWorkingBeatmap>(beatmap, null, null);
             mockWorkingBeatmap.Setup(w => w.GetStream(It.IsAny<string>())).Returns(resourceStream);
 

From 1550a3b470d44c93e809c9cf68d45bee7eac5e87 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 12 Oct 2021 11:11:55 +0900
Subject: [PATCH 0141/5547] Rethrow exception after logging to make tracking on
 CI easier

---
 osu.Game/Audio/Effects/AudioFilter.cs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Game/Audio/Effects/AudioFilter.cs b/osu.Game/Audio/Effects/AudioFilter.cs
index 7a51d7be8f..5eaa87af8d 100644
--- a/osu.Game/Audio/Effects/AudioFilter.cs
+++ b/osu.Game/Audio/Effects/AudioFilter.cs
@@ -140,6 +140,7 @@ namespace osu.Game.Audio.Effects
             catch (Exception e)
             {
                 Logger.Log($"Exception in audio filter disposal: {e}");
+                throw;
             }
         }
     }

From df83f0db08d3d66765febfe17ed4af84cb504f70 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 12 Oct 2021 11:28:11 +0900
Subject: [PATCH 0142/5547] Fix cross-thread list manipulation in
 `SkinProvidingContainer`

---
 osu.Game/Skinning/SkinProvidingContainer.cs | 27 ++++++++-------------
 1 file changed, 10 insertions(+), 17 deletions(-)

diff --git a/osu.Game/Skinning/SkinProvidingContainer.cs b/osu.Game/Skinning/SkinProvidingContainer.cs
index ada6e4b788..d2c3a6e837 100644
--- a/osu.Game/Skinning/SkinProvidingContainer.cs
+++ b/osu.Game/Skinning/SkinProvidingContainer.cs
@@ -3,6 +3,7 @@
 
 using System;
 using System.Collections.Generic;
+using System.Linq;
 using JetBrains.Annotations;
 using osu.Framework.Allocation;
 using osu.Framework.Audio.Sample;
@@ -43,7 +44,7 @@ namespace osu.Game.Skinning
         /// <summary>
         /// A dictionary mapping each <see cref="ISkin"/> source to a wrapper which handles lookup allowances.
         /// </summary>
-        private readonly List<(ISkin skin, DisableableSkinSource wrapped)> skinSources = new List<(ISkin, DisableableSkinSource)>();
+        private (ISkin skin, DisableableSkinSource wrapped)[] skinSources = Array.Empty<(ISkin skin, DisableableSkinSource wrapped)>();
 
         /// <summary>
         /// Constructs a new <see cref="SkinProvidingContainer"/> initialised with a single skin source.
@@ -173,32 +174,24 @@ namespace osu.Game.Skinning
         /// <param name="skin">The skin to add.</param>
         protected void AddSource(ISkin skin)
         {
-            skinSources.Add((skin, new DisableableSkinSource(skin, this)));
+            skinSources = skinSources.Append((skin, new DisableableSkinSource(skin, this))).ToArray();
 
             if (skin is ISkinSource source)
                 source.SourceChanged += TriggerSourceChanged;
         }
 
-        /// <summary>
-        /// Remove a skin from this provider.
-        /// </summary>
-        /// <param name="skin">The skin to remove.</param>
-        protected void RemoveSource(ISkin skin)
-        {
-            if (skinSources.RemoveAll(s => s.skin == skin) == 0)
-                return;
-
-            if (skin is ISkinSource source)
-                source.SourceChanged -= TriggerSourceChanged;
-        }
-
         /// <summary>
         /// Clears all skin sources.
         /// </summary>
         protected void ResetSources()
         {
-            foreach (var i in skinSources.ToArray())
-                RemoveSource(i.skin);
+            foreach (var skin in skinSources)
+            {
+                if (skin.skin is ISkinSource source)
+                    source.SourceChanged -= TriggerSourceChanged;
+            }
+
+            skinSources = Array.Empty<(ISkin skin, DisableableSkinSource wrapped)>();
         }
 
         /// <summary>

From e0c54e3207811a14f90c94ac6e13fd0eea00cac4 Mon Sep 17 00:00:00 2001
From: Gagah Pangeran Rosfatiputra <git@gagahpangeran.com>
Date: Tue, 12 Oct 2021 09:37:11 +0700
Subject: [PATCH 0143/5547] add `OpenChangelog` link action

---
 osu.Game/Online/Chat/MessageFormatter.cs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Game/Online/Chat/MessageFormatter.cs b/osu.Game/Online/Chat/MessageFormatter.cs
index 0e4ea694aa..cfffac7741 100644
--- a/osu.Game/Online/Chat/MessageFormatter.cs
+++ b/osu.Game/Online/Chat/MessageFormatter.cs
@@ -324,6 +324,7 @@ namespace osu.Game.Online.Chat
         SearchBeatmapSet,
         OpenWiki,
         Custom,
+        OpenChangelog,
     }
 
     public class Link : IComparable<Link>

From 39a3482458b586787e0612503f55a77463a57d7f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 12 Oct 2021 11:55:04 +0900
Subject: [PATCH 0144/5547] Replace Add/Reset methods with single `Set` method

---
 .../Skins/TestSceneSkinProvidingContainer.cs  |  4 +--
 .../Skinning/RulesetSkinProvidingContainer.cs |  5 +---
 osu.Game/Skinning/SkinProvidingContainer.cs   | 29 ++++++++-----------
 3 files changed, 14 insertions(+), 24 deletions(-)

diff --git a/osu.Game.Tests/Skins/TestSceneSkinProvidingContainer.cs b/osu.Game.Tests/Skins/TestSceneSkinProvidingContainer.cs
index ab47067411..2247f685e2 100644
--- a/osu.Game.Tests/Skins/TestSceneSkinProvidingContainer.cs
+++ b/osu.Game.Tests/Skins/TestSceneSkinProvidingContainer.cs
@@ -6,7 +6,6 @@ using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Audio.Sample;
 using osu.Framework.Bindables;
-using osu.Framework.Extensions.IEnumerableExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.OpenGL.Textures;
 using osu.Framework.Graphics.Textures;
@@ -67,8 +66,7 @@ namespace osu.Game.Tests.Skins
 
             protected override void OnSourceChanged()
             {
-                ResetSources();
-                sources.ForEach(AddSource);
+                SetSources(sources);
             }
         }
 
diff --git a/osu.Game/Skinning/RulesetSkinProvidingContainer.cs b/osu.Game/Skinning/RulesetSkinProvidingContainer.cs
index f5a7788359..e63af0dfbd 100644
--- a/osu.Game/Skinning/RulesetSkinProvidingContainer.cs
+++ b/osu.Game/Skinning/RulesetSkinProvidingContainer.cs
@@ -60,8 +60,6 @@ namespace osu.Game.Skinning
 
         protected override void OnSourceChanged()
         {
-            ResetSources();
-
             // Populate a local list first so we can adjust the returned order as we go.
             var sources = new List<ISkin>();
 
@@ -91,8 +89,7 @@ namespace osu.Game.Skinning
             else
                 sources.Add(rulesetResourcesSkin);
 
-            foreach (var skin in sources)
-                AddSource(skin);
+            SetSources(sources);
         }
 
         protected ISkin GetLegacyRulesetTransformedSkin(ISkin legacySkin)
diff --git a/osu.Game/Skinning/SkinProvidingContainer.cs b/osu.Game/Skinning/SkinProvidingContainer.cs
index d2c3a6e837..b769332e37 100644
--- a/osu.Game/Skinning/SkinProvidingContainer.cs
+++ b/osu.Game/Skinning/SkinProvidingContainer.cs
@@ -53,7 +53,7 @@ namespace osu.Game.Skinning
             : this()
         {
             if (skin != null)
-                AddSource(skin);
+                SetSources(new[] { skin });
         }
 
         /// <summary>
@@ -169,21 +169,10 @@ namespace osu.Game.Skinning
         }
 
         /// <summary>
-        /// Add a new skin to this provider. Will be added to the end of the lookup order precedence.
+        /// Replace the sources used for lookups in this container.
         /// </summary>
-        /// <param name="skin">The skin to add.</param>
-        protected void AddSource(ISkin skin)
-        {
-            skinSources = skinSources.Append((skin, new DisableableSkinSource(skin, this))).ToArray();
-
-            if (skin is ISkinSource source)
-                source.SourceChanged += TriggerSourceChanged;
-        }
-
-        /// <summary>
-        /// Clears all skin sources.
-        /// </summary>
-        protected void ResetSources()
+        /// <param name="sources">The new sources.</param>
+        protected void SetSources(IEnumerable<ISkin> sources)
         {
             foreach (var skin in skinSources)
             {
@@ -191,11 +180,17 @@ namespace osu.Game.Skinning
                     source.SourceChanged -= TriggerSourceChanged;
             }
 
-            skinSources = Array.Empty<(ISkin skin, DisableableSkinSource wrapped)>();
+            skinSources = sources.Select(skin => (skin, new DisableableSkinSource(skin, this))).ToArray();
+
+            foreach (var skin in skinSources)
+            {
+                if (skin.skin is ISkinSource source)
+                    source.SourceChanged += TriggerSourceChanged;
+            }
         }
 
         /// <summary>
-        /// Invoked when any source has changed (either <see cref="ParentSource"/> or a source registered via <see cref="AddSource"/>).
+        /// Invoked when any source has changed (either <see cref="ParentSource"/> or sources replaced via <see cref="SetSources"/>).
         /// This is also invoked once initially during <see cref="CreateChildDependencies"/> to ensure sources are ready for children consumption.
         /// </summary>
         protected virtual void OnSourceChanged() { }

From 7fcb01bdf162beb4a53270cd90a7a6927dec2de1 Mon Sep 17 00:00:00 2001
From: Gagah Pangeran Rosfatiputra <git@gagahpangeran.com>
Date: Tue, 12 Oct 2021 09:37:42 +0700
Subject: [PATCH 0145/5547] add changelog links test

---
 osu.Game.Tests/Chat/MessageFormatterTests.cs | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/osu.Game.Tests/Chat/MessageFormatterTests.cs b/osu.Game.Tests/Chat/MessageFormatterTests.cs
index 2c2c4dc24e..af87fc17ad 100644
--- a/osu.Game.Tests/Chat/MessageFormatterTests.cs
+++ b/osu.Game.Tests/Chat/MessageFormatterTests.cs
@@ -509,5 +509,17 @@ namespace osu.Game.Tests.Chat
             Assert.AreEqual(LinkAction.External, result.Action);
             Assert.AreEqual("/relative", result.Argument);
         }
+
+        [TestCase("https://dev.ppy.sh/home/changelog", "")]
+        [TestCase("https://dev.ppy.sh/home/changelog/lazer/2021.1012", "lazer/2021.1012")]
+        public void TestChangelogLinks(string link, string expectedArg)
+        {
+            MessageFormatter.WebsiteRootUrl = "dev.ppy.sh";
+
+            LinkDetails result = MessageFormatter.GetLinkDetails(link);
+
+            Assert.AreEqual(LinkAction.OpenChangelog, result.Action);
+            Assert.AreEqual(expectedArg, result.Argument);
+        }
     }
 }

From 47c7701e47be09d20f9c86475715477a9bc5b333 Mon Sep 17 00:00:00 2001
From: Gagah Pangeran Rosfatiputra <git@gagahpangeran.com>
Date: Tue, 12 Oct 2021 09:40:45 +0700
Subject: [PATCH 0146/5547] handle changelog link in message formatter

---
 osu.Game/Online/Chat/MessageFormatter.cs | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/osu.Game/Online/Chat/MessageFormatter.cs b/osu.Game/Online/Chat/MessageFormatter.cs
index cfffac7741..201ba6239b 100644
--- a/osu.Game/Online/Chat/MessageFormatter.cs
+++ b/osu.Game/Online/Chat/MessageFormatter.cs
@@ -177,6 +177,24 @@ namespace osu.Game.Online.Chat
 
                             case "wiki":
                                 return new LinkDetails(LinkAction.OpenWiki, string.Join('/', args.Skip(3)));
+
+                            case "home":
+                                if (mainArg != "changelog")
+                                    // handle link other than changelog as external for now
+                                    return new LinkDetails(LinkAction.External, url);
+
+                                switch (args.Length)
+                                {
+                                    case 4:
+                                        // https://osu.ppy.sh/home/changelog
+                                        return new LinkDetails(LinkAction.OpenChangelog, string.Empty);
+
+                                    case 6:
+                                        // https://osu.ppy.sh/home/changelog/lazer/2021.1006
+                                        return new LinkDetails(LinkAction.OpenChangelog, $"{args[4]}/{args[5]}");
+                                }
+
+                                break;
                         }
                     }
 

From 80722c7dc79d33ca948ccbf0aae91de4c919f472 Mon Sep 17 00:00:00 2001
From: Gagah Pangeran Rosfatiputra <git@gagahpangeran.com>
Date: Tue, 12 Oct 2021 09:41:59 +0700
Subject: [PATCH 0147/5547] change `changelogOverlay` to field in `OsuGame`

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

diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index 8a018f17d9..d233afe3aa 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -90,6 +90,8 @@ namespace osu.Game
 
         private WikiOverlay wikiOverlay;
 
+        private ChangelogOverlay changelogOverlay;
+
         private SkinEditorOverlay skinEditor;
 
         private Container overlayContent;
@@ -769,7 +771,7 @@ namespace osu.Game
             loadComponentSingleFile(chatOverlay = new ChatOverlay(), overlayContent.Add, true);
             loadComponentSingleFile(new MessageNotifier(), AddInternal, true);
             loadComponentSingleFile(Settings = new SettingsOverlay(), leftFloatingOverlayContent.Add, true);
-            var changelogOverlay = loadComponentSingleFile(new ChangelogOverlay(), overlayContent.Add, true);
+            loadComponentSingleFile(changelogOverlay = new ChangelogOverlay(), overlayContent.Add, true);
             loadComponentSingleFile(userProfile = new UserProfileOverlay(), overlayContent.Add, true);
             loadComponentSingleFile(beatmapSetOverlay = new BeatmapSetOverlay(), overlayContent.Add, true);
             loadComponentSingleFile(wikiOverlay = new WikiOverlay(), overlayContent.Add, true);

From 6c84cf66589128096b9701b337eabc5d18520ac4 Mon Sep 17 00:00:00 2001
From: Gagah Pangeran Rosfatiputra <git@gagahpangeran.com>
Date: Tue, 12 Oct 2021 09:42:29 +0700
Subject: [PATCH 0148/5547] add `ShowChangelogListing` and `ShowChangelogBuild`

---
 osu.Game/OsuGame.cs | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index d233afe3aa..9ce049e1a1 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -403,6 +403,18 @@ namespace osu.Game
         /// <param name="path">The wiki page to show</param>
         public void ShowWiki(string path) => waitForReady(() => wikiOverlay, _ => wikiOverlay.ShowPage(path));
 
+        /// <summary>
+        /// Show changelog listing overlay
+        /// </summary>
+        public void ShowChangelogListing() => waitForReady(() => changelogOverlay, _ => changelogOverlay.ShowListing());
+
+        /// <summary>
+        /// Show changelog's build as an overlay
+        /// </summary>
+        /// <param name="updateStream">The update stream name</param>
+        /// <param name="version">The build version of the update stream</param>
+        public void ShowChangelogBuild(string updateStream, string version) => waitForReady(() => changelogOverlay, _ => changelogOverlay.ShowBuild(updateStream, version));
+
         /// <summary>
         /// Present a beatmap at song select immediately.
         /// The user should have already requested this interactively.

From 81246a110cc47d56875dc54134e2071eac22cb6b Mon Sep 17 00:00:00 2001
From: Gagah Pangeran Rosfatiputra <git@gagahpangeran.com>
Date: Tue, 12 Oct 2021 09:43:32 +0700
Subject: [PATCH 0149/5547] add `OpenChangelog` in `OsuGame.HandleLink`

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

diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index 9ce049e1a1..7895715045 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -338,6 +338,17 @@ namespace osu.Game
                     ShowWiki(link.Argument);
                     break;
 
+                case LinkAction.OpenChangelog:
+                    if (string.IsNullOrEmpty(link.Argument))
+                        ShowChangelogListing();
+                    else
+                    {
+                        var changelogArgs = link.Argument.Split("/");
+                        ShowChangelogBuild(changelogArgs[0], changelogArgs[1]);
+                    }
+
+                    break;
+
                 default:
                     throw new NotImplementedException($"This {nameof(LinkAction)} ({link.Action.ToString()}) is missing an associated action.");
             }

From 077dcf5cd99d98be377356250c2cbdf1f8f1bbe3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 12 Oct 2021 12:50:28 +0900
Subject: [PATCH 0150/5547] Add missing documentation for `SourceChanged`

---
 osu.Game/Skinning/ISkinSource.cs | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/osu.Game/Skinning/ISkinSource.cs b/osu.Game/Skinning/ISkinSource.cs
index ba3e2bf6ad..a5ed0fc990 100644
--- a/osu.Game/Skinning/ISkinSource.cs
+++ b/osu.Game/Skinning/ISkinSource.cs
@@ -12,6 +12,9 @@ namespace osu.Game.Skinning
     /// </summary>
     public interface ISkinSource : ISkin
     {
+        /// <summary>
+        /// Fired whenever a source change occurs, signalling that consumers should re-query as required.
+        /// </summary>
         event Action SourceChanged;
 
         /// <summary>

From a849e7343edd8cbf01e58fab98fd63c3c9e6b560 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 12 Oct 2021 13:04:18 +0900
Subject: [PATCH 0151/5547] Add lock to ensure no threading shenanigans

---
 osu.Game/Skinning/SkinProvidingContainer.cs | 23 +++++++++++++--------
 1 file changed, 14 insertions(+), 9 deletions(-)

diff --git a/osu.Game/Skinning/SkinProvidingContainer.cs b/osu.Game/Skinning/SkinProvidingContainer.cs
index b769332e37..fd80992000 100644
--- a/osu.Game/Skinning/SkinProvidingContainer.cs
+++ b/osu.Game/Skinning/SkinProvidingContainer.cs
@@ -41,6 +41,8 @@ namespace osu.Game.Skinning
 
         protected virtual bool AllowColourLookup => true;
 
+        private readonly object sourceSetLock = new object();
+
         /// <summary>
         /// A dictionary mapping each <see cref="ISkin"/> source to a wrapper which handles lookup allowances.
         /// </summary>
@@ -174,18 +176,21 @@ namespace osu.Game.Skinning
         /// <param name="sources">The new sources.</param>
         protected void SetSources(IEnumerable<ISkin> sources)
         {
-            foreach (var skin in skinSources)
+            lock (sourceSetLock)
             {
-                if (skin.skin is ISkinSource source)
-                    source.SourceChanged -= TriggerSourceChanged;
-            }
+                foreach (var skin in skinSources)
+                {
+                    if (skin.skin is ISkinSource source)
+                        source.SourceChanged -= TriggerSourceChanged;
+                }
 
-            skinSources = sources.Select(skin => (skin, new DisableableSkinSource(skin, this))).ToArray();
+                skinSources = sources.Select(skin => (skin, new DisableableSkinSource(skin, this))).ToArray();
 
-            foreach (var skin in skinSources)
-            {
-                if (skin.skin is ISkinSource source)
-                    source.SourceChanged += TriggerSourceChanged;
+                foreach (var skin in skinSources)
+                {
+                    if (skin.skin is ISkinSource source)
+                        source.SourceChanged += TriggerSourceChanged;
+                }
             }
         }
 

From d7cbacc5a066947d6500313dcd296df43364a2e0 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 12 Oct 2021 13:04:48 +0900
Subject: [PATCH 0152/5547] Rename `OnSourceChanged` and expand on xmldoc to
 mention that it doesn't fire `SourceChanged`

---
 osu.Game.Tests/Skins/TestSceneSkinProvidingContainer.cs | 2 +-
 osu.Game/Skinning/RulesetSkinProvidingContainer.cs      | 2 +-
 osu.Game/Skinning/SkinProvidingContainer.cs             | 9 ++++++---
 3 files changed, 8 insertions(+), 5 deletions(-)

diff --git a/osu.Game.Tests/Skins/TestSceneSkinProvidingContainer.cs b/osu.Game.Tests/Skins/TestSceneSkinProvidingContainer.cs
index 2247f685e2..ffb3d41d18 100644
--- a/osu.Game.Tests/Skins/TestSceneSkinProvidingContainer.cs
+++ b/osu.Game.Tests/Skins/TestSceneSkinProvidingContainer.cs
@@ -64,7 +64,7 @@ namespace osu.Game.Tests.Skins
 
             public new void TriggerSourceChanged() => base.TriggerSourceChanged();
 
-            protected override void OnSourceChanged()
+            protected override void RefreshSources()
             {
                 SetSources(sources);
             }
diff --git a/osu.Game/Skinning/RulesetSkinProvidingContainer.cs b/osu.Game/Skinning/RulesetSkinProvidingContainer.cs
index e63af0dfbd..b884794739 100644
--- a/osu.Game/Skinning/RulesetSkinProvidingContainer.cs
+++ b/osu.Game/Skinning/RulesetSkinProvidingContainer.cs
@@ -58,7 +58,7 @@ namespace osu.Game.Skinning
             return base.CreateChildDependencies(parent);
         }
 
-        protected override void OnSourceChanged()
+        protected override void RefreshSources()
         {
             // Populate a local list first so we can adjust the returned order as we go.
             var sources = new List<ISkin>();
diff --git a/osu.Game/Skinning/SkinProvidingContainer.cs b/osu.Game/Skinning/SkinProvidingContainer.cs
index fd80992000..c8e4c2c7b6 100644
--- a/osu.Game/Skinning/SkinProvidingContainer.cs
+++ b/osu.Game/Skinning/SkinProvidingContainer.cs
@@ -173,6 +173,9 @@ namespace osu.Game.Skinning
         /// <summary>
         /// Replace the sources used for lookups in this container.
         /// </summary>
+        /// <remarks>
+        /// This does not implicitly fire a <see cref="SourceChanged"/> event. Consider calling <see cref="TriggerSourceChanged"/> if required.
+        /// </remarks>
         /// <param name="sources">The new sources.</param>
         protected void SetSources(IEnumerable<ISkin> sources)
         {
@@ -195,15 +198,15 @@ namespace osu.Game.Skinning
         }
 
         /// <summary>
-        /// Invoked when any source has changed (either <see cref="ParentSource"/> or sources replaced via <see cref="SetSources"/>).
+        /// Invoked after any consumed source change, before the external <see cref="SourceChanged"/> event is fired.
         /// This is also invoked once initially during <see cref="CreateChildDependencies"/> to ensure sources are ready for children consumption.
         /// </summary>
-        protected virtual void OnSourceChanged() { }
+        protected virtual void RefreshSources() { }
 
         protected void TriggerSourceChanged()
         {
             // Expose to implementations, giving them a chance to react before notifying external consumers.
-            OnSourceChanged();
+            RefreshSources();
 
             SourceChanged?.Invoke();
         }

From e982f485c7bd5df017892b7d8dafeaa1f4d49a5e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 12 Oct 2021 13:17:48 +0900
Subject: [PATCH 0153/5547] Remove drop shadow from `RoundedButton`

As per @arflyte's spec, this should not have been there in the first
place.
---
 osu.Game/Graphics/UserInterfaceV2/RoundedButton.cs | 10 ----------
 1 file changed, 10 deletions(-)

diff --git a/osu.Game/Graphics/UserInterfaceV2/RoundedButton.cs b/osu.Game/Graphics/UserInterfaceV2/RoundedButton.cs
index 5cbbc40405..27e28f1e03 100644
--- a/osu.Game/Graphics/UserInterfaceV2/RoundedButton.cs
+++ b/osu.Game/Graphics/UserInterfaceV2/RoundedButton.cs
@@ -5,9 +5,7 @@ using System.Collections.Generic;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
-using osu.Framework.Graphics.Effects;
 using osu.Game.Graphics.UserInterface;
-using osuTK;
 
 namespace osu.Game.Graphics.UserInterfaceV2
 {
@@ -29,14 +27,6 @@ namespace osu.Game.Graphics.UserInterfaceV2
         private void load(OsuColour colours)
         {
             BackgroundColour = colours.Blue3;
-
-            Content.EdgeEffect = new EdgeEffectParameters
-            {
-                Type = EdgeEffectType.Shadow,
-                Offset = new Vector2(0, 2),
-                Radius = 4,
-                Colour = Colour4.Black.Opacity(0.15f)
-            };
         }
 
         protected override void LoadComplete()

From a986870a998762f635e27b149e9b04d66d18dd6e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 12 Oct 2021 13:41:35 +0900
Subject: [PATCH 0154/5547] Reorder sections to be more in line with how often
 they are adjusted

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

diff --git a/osu.Game/Overlays/SettingsOverlay.cs b/osu.Game/Overlays/SettingsOverlay.cs
index 55e8aee266..af91677adb 100644
--- a/osu.Game/Overlays/SettingsOverlay.cs
+++ b/osu.Game/Overlays/SettingsOverlay.cs
@@ -24,12 +24,12 @@ namespace osu.Game.Overlays
         protected override IEnumerable<SettingsSection> CreateSections() => new SettingsSection[]
         {
             new GeneralSection(),
-            new GraphicsSection(),
-            new AudioSection(),
+            new SkinSection(),
             new InputSection(createSubPanel(new KeyBindingPanel())),
             new UserInterfaceSection(),
             new GameplaySection(),
-            new SkinSection(),
+            new AudioSection(),
+            new GraphicsSection(),
             new OnlineSection(),
             new MaintenanceSection(),
             new DebugSection(),

From 1d3d67c5f1ba160698380077061698122a8c2d4b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 12 Oct 2021 13:56:10 +0900
Subject: [PATCH 0155/5547] Move gameplay cursor settings to gameplay section

---
 .../Settings/Sections/Gameplay/GeneralSettings.cs     | 11 +++++++++++
 osu.Game/Overlays/Settings/Sections/SkinSection.cs    | 11 -----------
 2 files changed, 11 insertions(+), 11 deletions(-)

diff --git a/osu.Game/Overlays/Settings/Sections/Gameplay/GeneralSettings.cs b/osu.Game/Overlays/Settings/Sections/Gameplay/GeneralSettings.cs
index 3a0265e453..44b2a28d28 100644
--- a/osu.Game/Overlays/Settings/Sections/Gameplay/GeneralSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Gameplay/GeneralSettings.cs
@@ -81,6 +81,17 @@ namespace osu.Game.Overlays.Settings.Sections.Gameplay
                     Current = config.GetBindable<ScoringMode>(OsuSetting.ScoreDisplayMode),
                     Keywords = new[] { "scoring" }
                 },
+                new SettingsSlider<float, SizeSlider>
+                {
+                    LabelText = SkinSettingsStrings.GameplayCursorSize,
+                    Current = config.GetBindable<float>(OsuSetting.GameplayCursorSize),
+                    KeyboardStep = 0.01f
+                },
+                new SettingsCheckbox
+                {
+                    LabelText = SkinSettingsStrings.AutoCursorSize,
+                    Current = config.GetBindable<bool>(OsuSetting.AutoCursorSize)
+                },
             };
 
             if (RuntimeInfo.OS == RuntimeInfo.Platform.Windows)
diff --git a/osu.Game/Overlays/Settings/Sections/SkinSection.cs b/osu.Game/Overlays/Settings/Sections/SkinSection.cs
index d18099eb0a..929936acb4 100644
--- a/osu.Game/Overlays/Settings/Sections/SkinSection.cs
+++ b/osu.Game/Overlays/Settings/Sections/SkinSection.cs
@@ -71,17 +71,6 @@ namespace osu.Game.Overlays.Settings.Sections
                     Action = () => skinEditor?.Toggle(),
                 },
                 new ExportSkinButton(),
-                new SettingsSlider<float, SizeSlider>
-                {
-                    LabelText = SkinSettingsStrings.GameplayCursorSize,
-                    Current = config.GetBindable<float>(OsuSetting.GameplayCursorSize),
-                    KeyboardStep = 0.01f
-                },
-                new SettingsCheckbox
-                {
-                    LabelText = SkinSettingsStrings.AutoCursorSize,
-                    Current = config.GetBindable<bool>(OsuSetting.AutoCursorSize)
-                },
                 new SettingsCheckbox
                 {
                     LabelText = SkinSettingsStrings.BeatmapSkins,

From 8285f065c20a09ec3db33862f5d7f5270a2ac2f7 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 12 Oct 2021 14:26:57 +0900
Subject: [PATCH 0156/5547] Reorganise gameplay settings into more sections

---
 .../Localisation/GameplaySettingsStrings.cs   |  25 ++++
 .../Sections/Gameplay/AudioSettings.cs        |  34 ++++++
 .../Sections/Gameplay/BackgroundSettings.cs   |  48 ++++++++
 .../Sections/Gameplay/BeatmapSettings.cs      |  39 +++++++
 .../Sections/Gameplay/GeneralSettings.cs      | 107 ------------------
 .../Settings/Sections/Gameplay/HUDSettings.cs |  52 +++++++++
 .../Sections/Gameplay/InputSettings.cs        |  45 ++++++++
 .../Settings/Sections/GameplaySection.cs      |   6 +-
 .../Overlays/Settings/Sections/SkinSection.cs |  15 ---
 9 files changed, 248 insertions(+), 123 deletions(-)
 create mode 100644 osu.Game/Overlays/Settings/Sections/Gameplay/AudioSettings.cs
 create mode 100644 osu.Game/Overlays/Settings/Sections/Gameplay/BackgroundSettings.cs
 create mode 100644 osu.Game/Overlays/Settings/Sections/Gameplay/BeatmapSettings.cs
 delete mode 100644 osu.Game/Overlays/Settings/Sections/Gameplay/GeneralSettings.cs
 create mode 100644 osu.Game/Overlays/Settings/Sections/Gameplay/HUDSettings.cs
 create mode 100644 osu.Game/Overlays/Settings/Sections/Gameplay/InputSettings.cs

diff --git a/osu.Game/Localisation/GameplaySettingsStrings.cs b/osu.Game/Localisation/GameplaySettingsStrings.cs
index 6d6381b429..fa92187650 100644
--- a/osu.Game/Localisation/GameplaySettingsStrings.cs
+++ b/osu.Game/Localisation/GameplaySettingsStrings.cs
@@ -14,11 +14,36 @@ namespace osu.Game.Localisation
         /// </summary>
         public static LocalisableString GameplaySectionHeader => new TranslatableString(getKey(@"gameplay_section_header"), @"Gameplay");
 
+        /// <summary>
+        /// "Beatmap"
+        /// </summary>
+        public static LocalisableString BeatmapHeader => new TranslatableString(getKey(@"beatmap_header"), @"Beatmap");
+
         /// <summary>
         /// "General"
         /// </summary>
         public static LocalisableString GeneralHeader => new TranslatableString(getKey(@"general_header"), @"General");
 
+        /// <summary>
+        /// "Audio"
+        /// </summary>
+        public static LocalisableString AudioHeader => new TranslatableString(getKey(@"audio"), @"Audio");
+
+        /// <summary>
+        /// "HUD"
+        /// </summary>
+        public static LocalisableString HUDHeader => new TranslatableString(getKey(@"h_u_d"), @"HUD");
+
+        /// <summary>
+        /// "Input"
+        /// </summary>
+        public static LocalisableString InputHeader => new TranslatableString(getKey(@"input"), @"Input");
+
+        /// <summary>
+        /// "Background"
+        /// </summary>
+        public static LocalisableString BackgroundHeader => new TranslatableString(getKey(@"background"), @"Background");
+
         /// <summary>
         /// "Background dim"
         /// </summary>
diff --git a/osu.Game/Overlays/Settings/Sections/Gameplay/AudioSettings.cs b/osu.Game/Overlays/Settings/Sections/Gameplay/AudioSettings.cs
new file mode 100644
index 0000000000..dba64d695a
--- /dev/null
+++ b/osu.Game/Overlays/Settings/Sections/Gameplay/AudioSettings.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 osu.Framework.Allocation;
+using osu.Framework.Graphics;
+using osu.Framework.Localisation;
+using osu.Game.Configuration;
+using osu.Game.Localisation;
+
+namespace osu.Game.Overlays.Settings.Sections.Gameplay
+{
+    public class AudioSettings : SettingsSubsection
+    {
+        protected override LocalisableString Header => GameplaySettingsStrings.AudioHeader;
+
+        [BackgroundDependencyLoader]
+        private void load(OsuConfigManager config)
+        {
+            Children = new Drawable[]
+            {
+                new SettingsCheckbox
+                {
+                    LabelText = GameplaySettingsStrings.PositionalHitsounds,
+                    Current = config.GetBindable<bool>(OsuSetting.PositionalHitSounds)
+                },
+                new SettingsCheckbox
+                {
+                    LabelText = GameplaySettingsStrings.AlwaysPlayFirstComboBreak,
+                    Current = config.GetBindable<bool>(OsuSetting.AlwaysPlayFirstComboBreak)
+                },
+            };
+        }
+    }
+}
diff --git a/osu.Game/Overlays/Settings/Sections/Gameplay/BackgroundSettings.cs b/osu.Game/Overlays/Settings/Sections/Gameplay/BackgroundSettings.cs
new file mode 100644
index 0000000000..94e0c5e494
--- /dev/null
+++ b/osu.Game/Overlays/Settings/Sections/Gameplay/BackgroundSettings.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.Allocation;
+using osu.Framework.Graphics;
+using osu.Framework.Localisation;
+using osu.Game.Configuration;
+using osu.Game.Localisation;
+
+namespace osu.Game.Overlays.Settings.Sections.Gameplay
+{
+    public class BackgroundSettings : SettingsSubsection
+    {
+        protected override LocalisableString Header => GameplaySettingsStrings.BackgroundHeader;
+
+        [BackgroundDependencyLoader]
+        private void load(OsuConfigManager config)
+        {
+            Children = new Drawable[]
+            {
+                new SettingsSlider<double>
+                {
+                    LabelText = GameplaySettingsStrings.BackgroundDim,
+                    Current = config.GetBindable<double>(OsuSetting.DimLevel),
+                    KeyboardStep = 0.01f,
+                    DisplayAsPercentage = true
+                },
+                new SettingsSlider<double>
+                {
+                    LabelText = GameplaySettingsStrings.BackgroundBlur,
+                    Current = config.GetBindable<double>(OsuSetting.BlurLevel),
+                    KeyboardStep = 0.01f,
+                    DisplayAsPercentage = true
+                },
+                new SettingsCheckbox
+                {
+                    LabelText = GameplaySettingsStrings.LightenDuringBreaks,
+                    Current = config.GetBindable<bool>(OsuSetting.LightenDuringBreaks)
+                },
+                new SettingsCheckbox
+                {
+                    LabelText = GameplaySettingsStrings.FadePlayfieldWhenHealthLow,
+                    Current = config.GetBindable<bool>(OsuSetting.FadePlayfieldWhenHealthLow),
+                },
+            };
+        }
+    }
+}
diff --git a/osu.Game/Overlays/Settings/Sections/Gameplay/BeatmapSettings.cs b/osu.Game/Overlays/Settings/Sections/Gameplay/BeatmapSettings.cs
new file mode 100644
index 0000000000..a5d1fc5fc3
--- /dev/null
+++ b/osu.Game/Overlays/Settings/Sections/Gameplay/BeatmapSettings.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.Allocation;
+using osu.Framework.Graphics;
+using osu.Framework.Localisation;
+using osu.Game.Configuration;
+using osu.Game.Localisation;
+
+namespace osu.Game.Overlays.Settings.Sections.Gameplay
+{
+    public class BeatmapSettings : SettingsSubsection
+    {
+        protected override LocalisableString Header => GameplaySettingsStrings.BeatmapHeader;
+
+        [BackgroundDependencyLoader]
+        private void load(OsuConfigManager config)
+        {
+            Children = new Drawable[]
+            {
+                new SettingsCheckbox
+                {
+                    LabelText = SkinSettingsStrings.BeatmapSkins,
+                    Current = config.GetBindable<bool>(OsuSetting.BeatmapSkins)
+                },
+                new SettingsCheckbox
+                {
+                    LabelText = SkinSettingsStrings.BeatmapColours,
+                    Current = config.GetBindable<bool>(OsuSetting.BeatmapColours)
+                },
+                new SettingsCheckbox
+                {
+                    LabelText = SkinSettingsStrings.BeatmapHitsounds,
+                    Current = config.GetBindable<bool>(OsuSetting.BeatmapHitsounds)
+                },
+            };
+        }
+    }
+}
diff --git a/osu.Game/Overlays/Settings/Sections/Gameplay/GeneralSettings.cs b/osu.Game/Overlays/Settings/Sections/Gameplay/GeneralSettings.cs
deleted file mode 100644
index 44b2a28d28..0000000000
--- a/osu.Game/Overlays/Settings/Sections/Gameplay/GeneralSettings.cs
+++ /dev/null
@@ -1,107 +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;
-using osu.Framework.Allocation;
-using osu.Framework.Graphics;
-using osu.Framework.Localisation;
-using osu.Game.Configuration;
-using osu.Game.Localisation;
-using osu.Game.Rulesets.Scoring;
-
-namespace osu.Game.Overlays.Settings.Sections.Gameplay
-{
-    public class GeneralSettings : SettingsSubsection
-    {
-        protected override LocalisableString Header => GameplaySettingsStrings.GeneralHeader;
-
-        [BackgroundDependencyLoader]
-        private void load(OsuConfigManager config)
-        {
-            Children = new Drawable[]
-            {
-                new SettingsSlider<double>
-                {
-                    LabelText = GameplaySettingsStrings.BackgroundDim,
-                    Current = config.GetBindable<double>(OsuSetting.DimLevel),
-                    KeyboardStep = 0.01f,
-                    DisplayAsPercentage = true
-                },
-                new SettingsSlider<double>
-                {
-                    LabelText = GameplaySettingsStrings.BackgroundBlur,
-                    Current = config.GetBindable<double>(OsuSetting.BlurLevel),
-                    KeyboardStep = 0.01f,
-                    DisplayAsPercentage = true
-                },
-                new SettingsCheckbox
-                {
-                    LabelText = GameplaySettingsStrings.LightenDuringBreaks,
-                    Current = config.GetBindable<bool>(OsuSetting.LightenDuringBreaks)
-                },
-                new SettingsEnumDropdown<HUDVisibilityMode>
-                {
-                    LabelText = GameplaySettingsStrings.HUDVisibilityMode,
-                    Current = config.GetBindable<HUDVisibilityMode>(OsuSetting.HUDVisibilityMode)
-                },
-                new SettingsCheckbox
-                {
-                    LabelText = GameplaySettingsStrings.ShowDifficultyGraph,
-                    Current = config.GetBindable<bool>(OsuSetting.ShowProgressGraph)
-                },
-                new SettingsCheckbox
-                {
-                    LabelText = GameplaySettingsStrings.ShowHealthDisplayWhenCantFail,
-                    Current = config.GetBindable<bool>(OsuSetting.ShowHealthDisplayWhenCantFail),
-                    Keywords = new[] { "hp", "bar" }
-                },
-                new SettingsCheckbox
-                {
-                    LabelText = GameplaySettingsStrings.FadePlayfieldWhenHealthLow,
-                    Current = config.GetBindable<bool>(OsuSetting.FadePlayfieldWhenHealthLow),
-                },
-                new SettingsCheckbox
-                {
-                    LabelText = GameplaySettingsStrings.AlwaysShowKeyOverlay,
-                    Current = config.GetBindable<bool>(OsuSetting.KeyOverlay)
-                },
-                new SettingsCheckbox
-                {
-                    LabelText = GameplaySettingsStrings.PositionalHitsounds,
-                    Current = config.GetBindable<bool>(OsuSetting.PositionalHitSounds)
-                },
-                new SettingsCheckbox
-                {
-                    LabelText = GameplaySettingsStrings.AlwaysPlayFirstComboBreak,
-                    Current = config.GetBindable<bool>(OsuSetting.AlwaysPlayFirstComboBreak)
-                },
-                new SettingsEnumDropdown<ScoringMode>
-                {
-                    LabelText = GameplaySettingsStrings.ScoreDisplayMode,
-                    Current = config.GetBindable<ScoringMode>(OsuSetting.ScoreDisplayMode),
-                    Keywords = new[] { "scoring" }
-                },
-                new SettingsSlider<float, SizeSlider>
-                {
-                    LabelText = SkinSettingsStrings.GameplayCursorSize,
-                    Current = config.GetBindable<float>(OsuSetting.GameplayCursorSize),
-                    KeyboardStep = 0.01f
-                },
-                new SettingsCheckbox
-                {
-                    LabelText = SkinSettingsStrings.AutoCursorSize,
-                    Current = config.GetBindable<bool>(OsuSetting.AutoCursorSize)
-                },
-            };
-
-            if (RuntimeInfo.OS == RuntimeInfo.Platform.Windows)
-            {
-                Add(new SettingsCheckbox
-                {
-                    LabelText = GameplaySettingsStrings.DisableWinKey,
-                    Current = config.GetBindable<bool>(OsuSetting.GameplayDisableWinKey)
-                });
-            }
-        }
-    }
-}
diff --git a/osu.Game/Overlays/Settings/Sections/Gameplay/HUDSettings.cs b/osu.Game/Overlays/Settings/Sections/Gameplay/HUDSettings.cs
new file mode 100644
index 0000000000..2ffd19a020
--- /dev/null
+++ b/osu.Game/Overlays/Settings/Sections/Gameplay/HUDSettings.cs
@@ -0,0 +1,52 @@
+// 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.Localisation;
+using osu.Game.Configuration;
+using osu.Game.Localisation;
+using osu.Game.Rulesets.Scoring;
+
+namespace osu.Game.Overlays.Settings.Sections.Gameplay
+{
+    public class HUDSettings : SettingsSubsection
+    {
+        protected override LocalisableString Header => GameplaySettingsStrings.HUDHeader;
+
+        [BackgroundDependencyLoader]
+        private void load(OsuConfigManager config)
+        {
+            Children = new Drawable[]
+            {
+                new SettingsEnumDropdown<HUDVisibilityMode>
+                {
+                    LabelText = GameplaySettingsStrings.HUDVisibilityMode,
+                    Current = config.GetBindable<HUDVisibilityMode>(OsuSetting.HUDVisibilityMode)
+                },
+                new SettingsEnumDropdown<ScoringMode>
+                {
+                    LabelText = GameplaySettingsStrings.ScoreDisplayMode,
+                    Current = config.GetBindable<ScoringMode>(OsuSetting.ScoreDisplayMode),
+                    Keywords = new[] { "scoring" }
+                },
+                new SettingsCheckbox
+                {
+                    LabelText = GameplaySettingsStrings.ShowDifficultyGraph,
+                    Current = config.GetBindable<bool>(OsuSetting.ShowProgressGraph)
+                },
+                new SettingsCheckbox
+                {
+                    LabelText = GameplaySettingsStrings.ShowHealthDisplayWhenCantFail,
+                    Current = config.GetBindable<bool>(OsuSetting.ShowHealthDisplayWhenCantFail),
+                    Keywords = new[] { "hp", "bar" }
+                },
+                new SettingsCheckbox
+                {
+                    LabelText = GameplaySettingsStrings.AlwaysShowKeyOverlay,
+                    Current = config.GetBindable<bool>(OsuSetting.KeyOverlay)
+                },
+            };
+        }
+    }
+}
diff --git a/osu.Game/Overlays/Settings/Sections/Gameplay/InputSettings.cs b/osu.Game/Overlays/Settings/Sections/Gameplay/InputSettings.cs
new file mode 100644
index 0000000000..962572ca6e
--- /dev/null
+++ b/osu.Game/Overlays/Settings/Sections/Gameplay/InputSettings.cs
@@ -0,0 +1,45 @@
+// 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.Allocation;
+using osu.Framework.Graphics;
+using osu.Framework.Localisation;
+using osu.Game.Configuration;
+using osu.Game.Localisation;
+
+namespace osu.Game.Overlays.Settings.Sections.Gameplay
+{
+    public class InputSettings : SettingsSubsection
+    {
+        protected override LocalisableString Header => GameplaySettingsStrings.InputHeader;
+
+        [BackgroundDependencyLoader]
+        private void load(OsuConfigManager config)
+        {
+            Children = new Drawable[]
+            {
+                new SettingsSlider<float, SizeSlider>
+                {
+                    LabelText = SkinSettingsStrings.GameplayCursorSize,
+                    Current = config.GetBindable<float>(OsuSetting.GameplayCursorSize),
+                    KeyboardStep = 0.01f
+                },
+                new SettingsCheckbox
+                {
+                    LabelText = SkinSettingsStrings.AutoCursorSize,
+                    Current = config.GetBindable<bool>(OsuSetting.AutoCursorSize)
+                },
+            };
+
+            if (RuntimeInfo.OS == RuntimeInfo.Platform.Windows)
+            {
+                Add(new SettingsCheckbox
+                {
+                    LabelText = GameplaySettingsStrings.DisableWinKey,
+                    Current = config.GetBindable<bool>(OsuSetting.GameplayDisableWinKey)
+                });
+            }
+        }
+    }
+}
diff --git a/osu.Game/Overlays/Settings/Sections/GameplaySection.cs b/osu.Game/Overlays/Settings/Sections/GameplaySection.cs
index 42d9d48d73..c4da641574 100644
--- a/osu.Game/Overlays/Settings/Sections/GameplaySection.cs
+++ b/osu.Game/Overlays/Settings/Sections/GameplaySection.cs
@@ -27,7 +27,11 @@ namespace osu.Game.Overlays.Settings.Sections
         {
             Children = new Drawable[]
             {
-                new GeneralSettings(),
+                new AudioSettings(),
+                new BeatmapSettings(),
+                new BackgroundSettings(),
+                new HUDSettings(),
+                new InputSettings(),
                 new ModsSettings(),
             };
         }
diff --git a/osu.Game/Overlays/Settings/Sections/SkinSection.cs b/osu.Game/Overlays/Settings/Sections/SkinSection.cs
index 929936acb4..dc652e20a4 100644
--- a/osu.Game/Overlays/Settings/Sections/SkinSection.cs
+++ b/osu.Game/Overlays/Settings/Sections/SkinSection.cs
@@ -71,21 +71,6 @@ namespace osu.Game.Overlays.Settings.Sections
                     Action = () => skinEditor?.Toggle(),
                 },
                 new ExportSkinButton(),
-                new SettingsCheckbox
-                {
-                    LabelText = SkinSettingsStrings.BeatmapSkins,
-                    Current = config.GetBindable<bool>(OsuSetting.BeatmapSkins)
-                },
-                new SettingsCheckbox
-                {
-                    LabelText = SkinSettingsStrings.BeatmapColours,
-                    Current = config.GetBindable<bool>(OsuSetting.BeatmapColours)
-                },
-                new SettingsCheckbox
-                {
-                    LabelText = SkinSettingsStrings.BeatmapHitsounds,
-                    Current = config.GetBindable<bool>(OsuSetting.BeatmapHitsounds)
-                },
             };
 
             managerUpdated = skins.ItemUpdated.GetBoundCopy();

From c4347de57ef3d9e84f6cf20058a2d8c6f4b5e2a7 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 12 Oct 2021 14:31:08 +0900
Subject: [PATCH 0157/5547] Move ruleset settings to own section

---
 .../Localisation/RulesetSettingsStrings.cs    | 19 ++++++++
 .../Settings/Sections/GameplaySection.cs      | 26 +----------
 .../Settings/Sections/RulesetSection.cs       | 44 +++++++++++++++++++
 osu.Game/Overlays/SettingsOverlay.cs          |  1 +
 4 files changed, 65 insertions(+), 25 deletions(-)
 create mode 100644 osu.Game/Localisation/RulesetSettingsStrings.cs
 create mode 100644 osu.Game/Overlays/Settings/Sections/RulesetSection.cs

diff --git a/osu.Game/Localisation/RulesetSettingsStrings.cs b/osu.Game/Localisation/RulesetSettingsStrings.cs
new file mode 100644
index 0000000000..a356c9e20b
--- /dev/null
+++ b/osu.Game/Localisation/RulesetSettingsStrings.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 RulesetSettingsStrings
+    {
+        private const string prefix = @"osu.Game.Resources.Localisation.RulesetSettings";
+
+        /// <summary>
+        /// "Rulesets"
+        /// </summary>
+        public static LocalisableString Rulesets => new TranslatableString(getKey(@"rulesets"), @"Rulesets");
+
+        private static string getKey(string key) => $@"{prefix}:{key}";
+    }
+}
diff --git a/osu.Game/Overlays/Settings/Sections/GameplaySection.cs b/osu.Game/Overlays/Settings/Sections/GameplaySection.cs
index c4da641574..995df190bd 100644
--- a/osu.Game/Overlays/Settings/Sections/GameplaySection.cs
+++ b/osu.Game/Overlays/Settings/Sections/GameplaySection.cs
@@ -1,16 +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.Game.Overlays.Settings.Sections.Gameplay;
-using osu.Game.Rulesets;
-using System.Linq;
 using osu.Framework.Graphics.Sprites;
-using osu.Framework.Logging;
 using osu.Framework.Localisation;
 using osu.Game.Localisation;
+using osu.Game.Overlays.Settings.Sections.Gameplay;
 
 namespace osu.Game.Overlays.Settings.Sections
 {
@@ -35,24 +30,5 @@ namespace osu.Game.Overlays.Settings.Sections
                 new ModsSettings(),
             };
         }
-
-        [BackgroundDependencyLoader]
-        private void load(RulesetStore rulesets)
-        {
-            foreach (Ruleset ruleset in rulesets.AvailableRulesets.Select(info => info.CreateInstance()))
-            {
-                try
-                {
-                    SettingsSubsection section = ruleset.CreateSettings();
-
-                    if (section != null)
-                        Add(section);
-                }
-                catch (Exception e)
-                {
-                    Logger.Error(e, "Failed to load ruleset settings");
-                }
-            }
-        }
     }
 }
diff --git a/osu.Game/Overlays/Settings/Sections/RulesetSection.cs b/osu.Game/Overlays/Settings/Sections/RulesetSection.cs
new file mode 100644
index 0000000000..f9d15fc821
--- /dev/null
+++ b/osu.Game/Overlays/Settings/Sections/RulesetSection.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 System;
+using System.Linq;
+using osu.Framework.Allocation;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Sprites;
+using osu.Framework.Localisation;
+using osu.Framework.Logging;
+using osu.Game.Rulesets;
+using osu.Game.Localisation;
+
+namespace osu.Game.Overlays.Settings.Sections
+{
+    public class RulesetSection : SettingsSection
+    {
+        public override LocalisableString Header => RulesetSettingsStrings.Rulesets;
+
+        public override Drawable CreateIcon() => new SpriteIcon
+        {
+            Icon = FontAwesome.Regular.Square
+        };
+
+        [BackgroundDependencyLoader]
+        private void load(RulesetStore rulesets)
+        {
+            foreach (Ruleset ruleset in rulesets.AvailableRulesets.Select(info => info.CreateInstance()))
+            {
+                try
+                {
+                    SettingsSubsection section = ruleset.CreateSettings();
+
+                    if (section != null)
+                        Add(section);
+                }
+                catch (Exception e)
+                {
+                    Logger.Error(e, "Failed to load ruleset settings");
+                }
+            }
+        }
+    }
+}
diff --git a/osu.Game/Overlays/SettingsOverlay.cs b/osu.Game/Overlays/SettingsOverlay.cs
index af91677adb..c84cba8189 100644
--- a/osu.Game/Overlays/SettingsOverlay.cs
+++ b/osu.Game/Overlays/SettingsOverlay.cs
@@ -28,6 +28,7 @@ namespace osu.Game.Overlays
             new InputSection(createSubPanel(new KeyBindingPanel())),
             new UserInterfaceSection(),
             new GameplaySection(),
+            new RulesetSection(),
             new AudioSection(),
             new GraphicsSection(),
             new OnlineSection(),

From 5ca1d1d12ce6591f4e7f1d8a00e8672a01401d42 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 12 Oct 2021 14:34:00 +0900
Subject: [PATCH 0158/5547] Reorder graphics settings and move gameplay related
 pieces out

---
 .../Localisation/GraphicsSettingsStrings.cs   |  5 +++
 .../Sections/Gameplay/BeatmapSettings.cs      |  5 +++
 .../Sections/Gameplay/GeneralSettings.cs      | 36 +++++++++++++++++++
 .../Settings/Sections/Gameplay/HUDSettings.cs |  7 ----
 .../Settings/Sections/GameplaySection.cs      |  1 +
 ...etailSettings.cs => ScreenshotSettings.cs} | 14 ++------
 .../Settings/Sections/GraphicsSection.cs      |  4 +--
 7 files changed, 51 insertions(+), 21 deletions(-)
 create mode 100644 osu.Game/Overlays/Settings/Sections/Gameplay/GeneralSettings.cs
 rename osu.Game/Overlays/Settings/Sections/Graphics/{DetailSettings.cs => ScreenshotSettings.cs} (67%)

diff --git a/osu.Game/Localisation/GraphicsSettingsStrings.cs b/osu.Game/Localisation/GraphicsSettingsStrings.cs
index 0e384f983f..f85cc0f2ae 100644
--- a/osu.Game/Localisation/GraphicsSettingsStrings.cs
+++ b/osu.Game/Localisation/GraphicsSettingsStrings.cs
@@ -104,6 +104,11 @@ namespace osu.Game.Localisation
         /// </summary>
         public static LocalisableString HitLighting => new TranslatableString(getKey(@"hit_lighting"), @"Hit lighting");
 
+        /// <summary>
+        /// "Screenshots"
+        /// </summary>
+        public static LocalisableString Screenshots => new TranslatableString(getKey(@"screenshots"), @"Screenshots");
+
         /// <summary>
         /// "Screenshot format"
         /// </summary>
diff --git a/osu.Game/Overlays/Settings/Sections/Gameplay/BeatmapSettings.cs b/osu.Game/Overlays/Settings/Sections/Gameplay/BeatmapSettings.cs
index a5d1fc5fc3..aaa60ce81b 100644
--- a/osu.Game/Overlays/Settings/Sections/Gameplay/BeatmapSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Gameplay/BeatmapSettings.cs
@@ -33,6 +33,11 @@ namespace osu.Game.Overlays.Settings.Sections.Gameplay
                     LabelText = SkinSettingsStrings.BeatmapHitsounds,
                     Current = config.GetBindable<bool>(OsuSetting.BeatmapHitsounds)
                 },
+                new SettingsCheckbox
+                {
+                    LabelText = GraphicsSettingsStrings.StoryboardVideo,
+                    Current = config.GetBindable<bool>(OsuSetting.ShowStoryboard)
+                },
             };
         }
     }
diff --git a/osu.Game/Overlays/Settings/Sections/Gameplay/GeneralSettings.cs b/osu.Game/Overlays/Settings/Sections/Gameplay/GeneralSettings.cs
new file mode 100644
index 0000000000..d4e4fd571d
--- /dev/null
+++ b/osu.Game/Overlays/Settings/Sections/Gameplay/GeneralSettings.cs
@@ -0,0 +1,36 @@
+// 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.Localisation;
+using osu.Game.Configuration;
+using osu.Game.Localisation;
+using osu.Game.Rulesets.Scoring;
+
+namespace osu.Game.Overlays.Settings.Sections.Gameplay
+{
+    public class GeneralSettings : SettingsSubsection
+    {
+        protected override LocalisableString Header => GameplaySettingsStrings.GeneralHeader;
+
+        [BackgroundDependencyLoader]
+        private void load(OsuConfigManager config)
+        {
+            Children = new Drawable[]
+            {
+                new SettingsEnumDropdown<ScoringMode>
+                {
+                    LabelText = GameplaySettingsStrings.ScoreDisplayMode,
+                    Current = config.GetBindable<ScoringMode>(OsuSetting.ScoreDisplayMode),
+                    Keywords = new[] { "scoring" }
+                },
+                new SettingsCheckbox
+                {
+                    LabelText = GraphicsSettingsStrings.HitLighting,
+                    Current = config.GetBindable<bool>(OsuSetting.HitLighting)
+                },
+            };
+        }
+    }
+}
diff --git a/osu.Game/Overlays/Settings/Sections/Gameplay/HUDSettings.cs b/osu.Game/Overlays/Settings/Sections/Gameplay/HUDSettings.cs
index 2ffd19a020..e1b452e322 100644
--- a/osu.Game/Overlays/Settings/Sections/Gameplay/HUDSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Gameplay/HUDSettings.cs
@@ -6,7 +6,6 @@ using osu.Framework.Graphics;
 using osu.Framework.Localisation;
 using osu.Game.Configuration;
 using osu.Game.Localisation;
-using osu.Game.Rulesets.Scoring;
 
 namespace osu.Game.Overlays.Settings.Sections.Gameplay
 {
@@ -24,12 +23,6 @@ namespace osu.Game.Overlays.Settings.Sections.Gameplay
                     LabelText = GameplaySettingsStrings.HUDVisibilityMode,
                     Current = config.GetBindable<HUDVisibilityMode>(OsuSetting.HUDVisibilityMode)
                 },
-                new SettingsEnumDropdown<ScoringMode>
-                {
-                    LabelText = GameplaySettingsStrings.ScoreDisplayMode,
-                    Current = config.GetBindable<ScoringMode>(OsuSetting.ScoreDisplayMode),
-                    Keywords = new[] { "scoring" }
-                },
                 new SettingsCheckbox
                 {
                     LabelText = GameplaySettingsStrings.ShowDifficultyGraph,
diff --git a/osu.Game/Overlays/Settings/Sections/GameplaySection.cs b/osu.Game/Overlays/Settings/Sections/GameplaySection.cs
index 995df190bd..dd4e561451 100644
--- a/osu.Game/Overlays/Settings/Sections/GameplaySection.cs
+++ b/osu.Game/Overlays/Settings/Sections/GameplaySection.cs
@@ -22,6 +22,7 @@ namespace osu.Game.Overlays.Settings.Sections
         {
             Children = new Drawable[]
             {
+                new GeneralSettings(),
                 new AudioSettings(),
                 new BeatmapSettings(),
                 new BackgroundSettings(),
diff --git a/osu.Game/Overlays/Settings/Sections/Graphics/DetailSettings.cs b/osu.Game/Overlays/Settings/Sections/Graphics/ScreenshotSettings.cs
similarity index 67%
rename from osu.Game/Overlays/Settings/Sections/Graphics/DetailSettings.cs
rename to osu.Game/Overlays/Settings/Sections/Graphics/ScreenshotSettings.cs
index 20b1d8d801..dbb9ddc1c1 100644
--- a/osu.Game/Overlays/Settings/Sections/Graphics/DetailSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Graphics/ScreenshotSettings.cs
@@ -9,25 +9,15 @@ using osu.Game.Localisation;
 
 namespace osu.Game.Overlays.Settings.Sections.Graphics
 {
-    public class DetailSettings : SettingsSubsection
+    public class ScreenshotSettings : SettingsSubsection
     {
-        protected override LocalisableString Header => GraphicsSettingsStrings.DetailSettingsHeader;
+        protected override LocalisableString Header => GraphicsSettingsStrings.Screenshots;
 
         [BackgroundDependencyLoader]
         private void load(OsuConfigManager config)
         {
             Children = new Drawable[]
             {
-                new SettingsCheckbox
-                {
-                    LabelText = GraphicsSettingsStrings.StoryboardVideo,
-                    Current = config.GetBindable<bool>(OsuSetting.ShowStoryboard)
-                },
-                new SettingsCheckbox
-                {
-                    LabelText = GraphicsSettingsStrings.HitLighting,
-                    Current = config.GetBindable<bool>(OsuSetting.HitLighting)
-                },
                 new SettingsEnumDropdown<ScreenshotFormat>
                 {
                     LabelText = GraphicsSettingsStrings.ScreenshotFormat,
diff --git a/osu.Game/Overlays/Settings/Sections/GraphicsSection.cs b/osu.Game/Overlays/Settings/Sections/GraphicsSection.cs
index fd0718f9f2..591848506a 100644
--- a/osu.Game/Overlays/Settings/Sections/GraphicsSection.cs
+++ b/osu.Game/Overlays/Settings/Sections/GraphicsSection.cs
@@ -22,9 +22,9 @@ namespace osu.Game.Overlays.Settings.Sections
         {
             Children = new Drawable[]
             {
-                new RendererSettings(),
                 new LayoutSettings(),
-                new DetailSettings(),
+                new RendererSettings(),
+                new ScreenshotSettings(),
             };
         }
     }

From 59202d27c799d3f98a71543a726344c03fd801e3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 12 Oct 2021 14:42:22 +0900
Subject: [PATCH 0159/5547] Add some missing labels

---
 osu.Game/Configuration/RandomSelectAlgorithm.cs              | 2 +-
 osu.Game/Localisation/AudioSettingsStrings.cs                | 5 +++++
 osu.Game/Localisation/SkinSettingsStrings.cs                 | 5 +++++
 .../Overlays/Settings/Sections/Audio/AudioDevicesSettings.cs | 1 +
 osu.Game/Overlays/Settings/Sections/SkinSection.cs           | 5 ++++-
 5 files changed, 16 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Configuration/RandomSelectAlgorithm.cs b/osu.Game/Configuration/RandomSelectAlgorithm.cs
index 8d0c87374f..b22f2ae485 100644
--- a/osu.Game/Configuration/RandomSelectAlgorithm.cs
+++ b/osu.Game/Configuration/RandomSelectAlgorithm.cs
@@ -10,7 +10,7 @@ namespace osu.Game.Configuration
         [Description("Never repeat")]
         RandomPermutation,
 
-        [Description("Random")]
+        [Description("True Random")]
         Random
     }
 }
diff --git a/osu.Game/Localisation/AudioSettingsStrings.cs b/osu.Game/Localisation/AudioSettingsStrings.cs
index aa6eabd7d1..008781c2e5 100644
--- a/osu.Game/Localisation/AudioSettingsStrings.cs
+++ b/osu.Game/Localisation/AudioSettingsStrings.cs
@@ -24,6 +24,11 @@ namespace osu.Game.Localisation
         /// </summary>
         public static LocalisableString VolumeHeader => new TranslatableString(getKey(@"volume_header"), @"Volume");
 
+        /// <summary>
+        /// "Output device"
+        /// </summary>
+        public static LocalisableString OutputDevice => new TranslatableString(getKey(@"output_device"), @"Output device");
+
         /// <summary>
         /// "Master"
         /// </summary>
diff --git a/osu.Game/Localisation/SkinSettingsStrings.cs b/osu.Game/Localisation/SkinSettingsStrings.cs
index f22b4d6bf5..8b74b94d59 100644
--- a/osu.Game/Localisation/SkinSettingsStrings.cs
+++ b/osu.Game/Localisation/SkinSettingsStrings.cs
@@ -14,6 +14,11 @@ namespace osu.Game.Localisation
         /// </summary>
         public static LocalisableString SkinSectionHeader => new TranslatableString(getKey(@"skin_section_header"), @"Skin");
 
+        /// <summary>
+        /// "Current skin"
+        /// </summary>
+        public static LocalisableString CurrentSkin => new TranslatableString(getKey(@"current_skin"), @"Current skin");
+
         /// <summary>
         /// "Skin layout editor"
         /// </summary>
diff --git a/osu.Game/Overlays/Settings/Sections/Audio/AudioDevicesSettings.cs b/osu.Game/Overlays/Settings/Sections/Audio/AudioDevicesSettings.cs
index d697b45424..0c54ae2763 100644
--- a/osu.Game/Overlays/Settings/Sections/Audio/AudioDevicesSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Audio/AudioDevicesSettings.cs
@@ -28,6 +28,7 @@ namespace osu.Game.Overlays.Settings.Sections.Audio
             {
                 dropdown = new AudioDeviceSettingsDropdown
                 {
+                    LabelText = AudioSettingsStrings.OutputDevice,
                     Keywords = new[] { "speaker", "headphone", "output" }
                 }
             };
diff --git a/osu.Game/Overlays/Settings/Sections/SkinSection.cs b/osu.Game/Overlays/Settings/Sections/SkinSection.cs
index dc652e20a4..00198235c5 100644
--- a/osu.Game/Overlays/Settings/Sections/SkinSection.cs
+++ b/osu.Game/Overlays/Settings/Sections/SkinSection.cs
@@ -64,7 +64,10 @@ namespace osu.Game.Overlays.Settings.Sections
         {
             Children = new Drawable[]
             {
-                skinDropdown = new SkinSettingsDropdown(),
+                skinDropdown = new SkinSettingsDropdown
+                {
+                    LabelText = SkinSettingsStrings.CurrentSkin
+                },
                 new SettingsButton
                 {
                     Text = SkinSettingsStrings.SkinLayoutEditor,

From 24b87cf6552c16f9a49f0d0611d0b037e381ea79 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 12 Oct 2021 14:53:19 +0900
Subject: [PATCH 0160/5547] Change some icons to be more descriptive (still
 placeholder)

---
 osu.Game/Overlays/Settings/Sections/GameplaySection.cs | 2 +-
 osu.Game/Overlays/Settings/Sections/RulesetSection.cs  | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Overlays/Settings/Sections/GameplaySection.cs b/osu.Game/Overlays/Settings/Sections/GameplaySection.cs
index dd4e561451..120e2d908c 100644
--- a/osu.Game/Overlays/Settings/Sections/GameplaySection.cs
+++ b/osu.Game/Overlays/Settings/Sections/GameplaySection.cs
@@ -15,7 +15,7 @@ namespace osu.Game.Overlays.Settings.Sections
 
         public override Drawable CreateIcon() => new SpriteIcon
         {
-            Icon = FontAwesome.Regular.Circle
+            Icon = FontAwesome.Regular.DotCircle
         };
 
         public GameplaySection()
diff --git a/osu.Game/Overlays/Settings/Sections/RulesetSection.cs b/osu.Game/Overlays/Settings/Sections/RulesetSection.cs
index f9d15fc821..b9339d5299 100644
--- a/osu.Game/Overlays/Settings/Sections/RulesetSection.cs
+++ b/osu.Game/Overlays/Settings/Sections/RulesetSection.cs
@@ -19,7 +19,7 @@ namespace osu.Game.Overlays.Settings.Sections
 
         public override Drawable CreateIcon() => new SpriteIcon
         {
-            Icon = FontAwesome.Regular.Square
+            Icon = FontAwesome.Solid.Chess
         };
 
         [BackgroundDependencyLoader]

From 129416835f2e7d78d7cbf5b120c7d9708de953f9 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 12 Oct 2021 15:40:12 +0900
Subject: [PATCH 0161/5547] Remove stray `string.Empty` specification
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/Models/RealmBeatmapMetadata.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Models/RealmBeatmapMetadata.cs b/osu.Game/Models/RealmBeatmapMetadata.cs
index 00dd120791..6ea7170d0f 100644
--- a/osu.Game/Models/RealmBeatmapMetadata.cs
+++ b/osu.Game/Models/RealmBeatmapMetadata.cs
@@ -26,7 +26,7 @@ namespace osu.Game.Models
         [JsonProperty("artist_unicode")]
         public string ArtistUnicode { get; set; } = string.Empty;
 
-        public string Author { get; set; } = string.Empty; // eventually should be linked to a persisted User. = string.Empty;
+        public string Author { get; set; } = string.Empty; // eventually should be linked to a persisted User.
 
         public string Source { get; set; } = string.Empty;
 

From ce128476ae59d1011bf17fac4699ddfcb8f8a59f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 12 Oct 2021 15:46:32 +0900
Subject: [PATCH 0162/5547] Remove public setter of `RealmFileStore.Storage`

---
 osu.Game/Stores/RealmFileStore.cs | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Stores/RealmFileStore.cs b/osu.Game/Stores/RealmFileStore.cs
index aac52b193c..5082b2c65b 100644
--- a/osu.Game/Stores/RealmFileStore.cs
+++ b/osu.Game/Stores/RealmFileStore.cs
@@ -17,14 +17,15 @@ using Realms;
 namespace osu.Game.Stores
 {
     /// <summary>
-    /// Handles the Store and retrieval of Files/FileSets to the database backing
+    /// Handles the storing of files to the file system (and database) backing.
     /// </summary>
     public class RealmFileStore
     {
         private readonly RealmContextFactory realmFactory;
+
         public readonly IResourceStore<byte[]> Store;
 
-        public Storage Storage;
+        public readonly Storage Storage;
 
         public RealmFileStore(RealmContextFactory realmFactory, Storage storage)
         {

From 0df9ab3eec5d6a3d039d3a0cac5ff62e297dd62f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 12 Oct 2021 16:04:09 +0900
Subject: [PATCH 0163/5547] Fix migration blocking code running on the wrong
 thread

---
 osu.Game/OsuGameBase.cs | 22 ++++++++++++++++++++--
 1 file changed, 20 insertions(+), 2 deletions(-)

diff --git a/osu.Game/OsuGameBase.cs b/osu.Game/OsuGameBase.cs
index 7f4fe8a943..09eb482d16 100644
--- a/osu.Game/OsuGameBase.cs
+++ b/osu.Game/OsuGameBase.cs
@@ -6,6 +6,7 @@ using System.Collections.Generic;
 using System.IO;
 using System.Linq;
 using System.Reflection;
+using System.Threading;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
 using osu.Framework.Bindables;
@@ -410,11 +411,28 @@ namespace osu.Game
         {
             Logger.Log($@"Migrating osu! data from ""{Storage.GetFullPath(string.Empty)}"" to ""{path}""...");
 
-            using (realmFactory.BlockAllOperations())
+            IDisposable realmBlocker = null;
+
+            try
             {
-                contextFactory.FlushConnections();
+                ManualResetEventSlim readyToRun = new ManualResetEventSlim();
+
+                Scheduler.Add(() =>
+                {
+                    realmBlocker = realmFactory.BlockAllOperations();
+                    contextFactory.FlushConnections();
+
+                    readyToRun.Set();
+                }, false);
+
+                readyToRun.Wait();
+
                 (Storage as OsuStorage)?.Migrate(Host.GetStorage(path));
             }
+            finally
+            {
+                realmBlocker?.Dispose();
+            }
 
             Logger.Log(@"Migration complete!");
         }

From 76c64751de3007a21f6092359c60e4dbae4f0aaa Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 12 Oct 2021 16:18:12 +0900
Subject: [PATCH 0164/5547] Remove `RealmBeatmap.Clone` for the time being
 (incorrectly implemented)

---
 osu.Game/Models/RealmBeatmap.cs | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/osu.Game/Models/RealmBeatmap.cs b/osu.Game/Models/RealmBeatmap.cs
index 09f8dafeb6..5049c1384d 100644
--- a/osu.Game/Models/RealmBeatmap.cs
+++ b/osu.Game/Models/RealmBeatmap.cs
@@ -97,11 +97,6 @@ namespace osu.Game.Models
 
         #endregion
 
-        /// <summary>
-        /// Returns a shallow-clone of this <see cref="RealmBeatmap"/>.
-        /// </summary>
-        public RealmBeatmap Clone() => (RealmBeatmap)MemberwiseClone();
-
         public bool AudioEquals(RealmBeatmap? other) => other != null
                                                         && BeatmapSet != null
                                                         && other.BeatmapSet != null

From c66e50ac55147889526c3bfcc4109c9ba8eca339 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 12 Oct 2021 16:19:58 +0900
Subject: [PATCH 0165/5547] Remove temporary logging

---
 osu.Game/Audio/Effects/AudioFilter.cs | 12 ++----------
 1 file changed, 2 insertions(+), 10 deletions(-)

diff --git a/osu.Game/Audio/Effects/AudioFilter.cs b/osu.Game/Audio/Effects/AudioFilter.cs
index 5eaa87af8d..268c31aa4c 100644
--- a/osu.Game/Audio/Effects/AudioFilter.cs
+++ b/osu.Game/Audio/Effects/AudioFilter.cs
@@ -132,16 +132,8 @@ namespace osu.Game.Audio.Effects
         {
             base.Dispose(isDisposing);
 
-            try
-            {
-                if (mixer.Effects.Contains(filter))
-                    detachFilter();
-            }
-            catch (Exception e)
-            {
-                Logger.Log($"Exception in audio filter disposal: {e}");
-                throw;
-            }
+            if (mixer.Effects.Contains(filter))
+                detachFilter();
         }
     }
 }

From 6fec821a17d24b0462e42ebba7d64eaa5fd520a0 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 12 Oct 2021 16:20:13 +0900
Subject: [PATCH 0166/5547] Update framework

---
 osu.Android.props        | 2 +-
 osu.Game/osu.Game.csproj | 2 +-
 osu.iOS.props            | 4 ++--
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Android.props b/osu.Android.props
index fefc2f6438..956093b2ac 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -52,7 +52,7 @@
   </ItemGroup>
   <ItemGroup>
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1004.0" />
-    <PackageReference Include="ppy.osu.Framework.Android" Version="2021.1011.0" />
+    <PackageReference Include="ppy.osu.Framework.Android" Version="2021.1012.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
     <!-- Realm needs to be directly referenced in all Xamarin projects, as it will not pull in its transitive dependencies otherwise. -->
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index ff382f5227..184c9d3f63 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="10.6.0" />
-    <PackageReference Include="ppy.osu.Framework" Version="2021.1011.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2021.1012.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1004.0" />
     <PackageReference Include="Sentry" Version="3.9.4" />
     <PackageReference Include="SharpCompress" Version="0.29.0" />
diff --git a/osu.iOS.props b/osu.iOS.props
index fff0cbf418..38b920420b 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -70,7 +70,7 @@
     <Reference Include="System.Net.Http" />
   </ItemGroup>
   <ItemGroup Label="Package References">
-    <PackageReference Include="ppy.osu.Framework.iOS" Version="2021.1011.0" />
+    <PackageReference Include="ppy.osu.Framework.iOS" Version="2021.1012.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1004.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net5.0 / net6.0) -->
@@ -93,7 +93,7 @@
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="2.2.6" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.Core" Version="2.2.6" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
-    <PackageReference Include="ppy.osu.Framework" Version="2021.1011.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2021.1012.0" />
     <PackageReference Include="SharpCompress" Version="0.28.3" />
     <PackageReference Include="NUnit" Version="3.13.2" />
     <PackageReference Include="SharpRaven" Version="2.4.0" />

From 55bd7d25126f0441a1367188e80e7f17d606f200 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 9 Oct 2021 16:12:08 +0200
Subject: [PATCH 0167/5547] Add failing coverage for saving difficulty params
 from editor

---
 osu.Game.Tests/Visual/Editing/TestSceneEditorSaving.cs | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneEditorSaving.cs b/osu.Game.Tests/Visual/Editing/TestSceneEditorSaving.cs
index 2258a209e2..7540a0c69a 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneEditorSaving.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneEditorSaving.cs
@@ -32,6 +32,8 @@ namespace osu.Game.Tests.Visual.Editing
 
             AddUntilStep("wait for editor load", () => editor != null);
 
+            AddStep("Set overall difficulty", () => editorBeatmap.Difficulty.OverallDifficulty = 7);
+
             AddStep("Add timing point", () => editorBeatmap.ControlPointInfo.Add(0, new TimingControlPoint()));
 
             AddStep("Enter compose mode", () => InputManager.Key(Key.F1));
@@ -57,6 +59,7 @@ namespace osu.Game.Tests.Visual.Editing
 
             AddUntilStep("Wait for editor load", () => editor != null);
             AddAssert("Beatmap contains single hitcircle", () => editorBeatmap.HitObjects.Count == 1);
+            AddAssert("Beatmap has correct overall difficulty", () => editorBeatmap.Difficulty.OverallDifficulty == 7);
         }
     }
 }

From b79cf0b58b3e5c3a136e912ab4b68dab2e3eec9a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 9 Oct 2021 15:00:47 +0200
Subject: [PATCH 0168/5547] Add failing coverage for conversion not altering
 original beatmap

---
 osu.Game/Tests/Beatmaps/BeatmapConversionTest.cs | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/osu.Game/Tests/Beatmaps/BeatmapConversionTest.cs b/osu.Game/Tests/Beatmaps/BeatmapConversionTest.cs
index 64f1ee4a7a..6d63525011 100644
--- a/osu.Game/Tests/Beatmaps/BeatmapConversionTest.cs
+++ b/osu.Game/Tests/Beatmaps/BeatmapConversionTest.cs
@@ -14,6 +14,7 @@ using osu.Framework.Graphics.Textures;
 using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.Formats;
 using osu.Game.IO;
+using osu.Game.IO.Serialization;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Objects;
@@ -109,6 +110,8 @@ namespace osu.Game.Tests.Beatmaps
         {
             var beatmap = GetBeatmap(name);
 
+            string beforeConversion = beatmap.Serialize();
+
             var converterResult = new Dictionary<HitObject, IEnumerable<HitObject>>();
 
             var working = new ConversionWorkingBeatmap(beatmap)
@@ -122,6 +125,10 @@ namespace osu.Game.Tests.Beatmaps
 
             working.GetPlayableBeatmap(CreateRuleset().RulesetInfo, mods);
 
+            string afterConversion = beatmap.Serialize();
+
+            Assert.AreEqual(beforeConversion, afterConversion, "Conversion altered original beatmap");
+
             return new ConvertResult
             {
                 Mappings = converterResult.Select(r =>

From 1373cc02d7293a1d9884de1c791cad513d57bb4e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 12 Oct 2021 16:42:09 +0900
Subject: [PATCH 0169/5547] Shallow clone `BeatmapInfo` during conversion
 process to avoid overwriting fields

---
 osu.Game/Beatmaps/BeatmapConverter.cs | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Beatmaps/BeatmapConverter.cs b/osu.Game/Beatmaps/BeatmapConverter.cs
index f3434c5153..627e54c803 100644
--- a/osu.Game/Beatmaps/BeatmapConverter.cs
+++ b/osu.Game/Beatmaps/BeatmapConverter.cs
@@ -40,7 +40,13 @@ namespace osu.Game.Beatmaps
         public IBeatmap Convert(CancellationToken cancellationToken = default)
         {
             // We always operate on a clone of the original beatmap, to not modify it game-wide
-            return ConvertBeatmap(Beatmap.Clone(), cancellationToken);
+            var original = Beatmap.Clone();
+
+            // Shallow clone isn't enough to ensure we don't mutate beatmap info unexpectedly.
+            // Can potentially be removed after `Beatmap.Difficulty` doesn't save back to `Beatmap.BeatmapInfo`.
+            original.BeatmapInfo = original.BeatmapInfo.Clone();
+
+            return ConvertBeatmap(original, cancellationToken);
         }
 
         /// <summary>

From d1b0dd1f6b72112aa10c18f9106b6b08a14b8d48 Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Tue, 12 Oct 2021 17:13:36 +0900
Subject: [PATCH 0170/5547] Fix GameHosts being run on TPL threads

---
 osu.Game.Tests/ImportTest.cs                              | 2 +-
 osu.Game.Tournament.Tests/NonVisual/TournamentHostTest.cs | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/ImportTest.cs b/osu.Game.Tests/ImportTest.cs
index e888f51e98..dbeb453d4d 100644
--- a/osu.Game.Tests/ImportTest.cs
+++ b/osu.Game.Tests/ImportTest.cs
@@ -17,7 +17,7 @@ namespace osu.Game.Tests
         protected virtual TestOsuGameBase LoadOsuIntoHost(GameHost host, bool withBeatmap = false)
         {
             var osu = new TestOsuGameBase(withBeatmap);
-            Task.Run(() => host.Run(osu))
+            Task.Factory.StartNew(() => host.Run(osu), TaskCreationOptions.LongRunning)
                 .ContinueWith(t => Assert.Fail($"Host threw exception {t.Exception}"), TaskContinuationOptions.OnlyOnFaulted);
 
             waitForOrAssert(() => osu.IsLoaded, @"osu! failed to start in a reasonable amount of time");
diff --git a/osu.Game.Tournament.Tests/NonVisual/TournamentHostTest.cs b/osu.Game.Tournament.Tests/NonVisual/TournamentHostTest.cs
index b14684200f..319a768e65 100644
--- a/osu.Game.Tournament.Tests/NonVisual/TournamentHostTest.cs
+++ b/osu.Game.Tournament.Tests/NonVisual/TournamentHostTest.cs
@@ -14,7 +14,7 @@ namespace osu.Game.Tournament.Tests.NonVisual
         public static TournamentGameBase LoadTournament(GameHost host, TournamentGameBase tournament = null)
         {
             tournament ??= new TournamentGameBase();
-            Task.Run(() => host.Run(tournament))
+            Task.Factory.StartNew(() => host.Run(tournament), TaskCreationOptions.LongRunning)
                 .ContinueWith(t => Assert.Fail($"Host threw exception {t.Exception}"), TaskContinuationOptions.OnlyOnFaulted);
             WaitForOrAssert(() => tournament.IsLoaded, @"osu! failed to start in a reasonable amount of time");
             return tournament;

From e6cd0a837173ecfe18c79e7c4045b44fd5591b87 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 12 Oct 2021 17:17:40 +0900
Subject: [PATCH 0171/5547] Remove unused using statements

---
 osu.Game/Audio/Effects/AudioFilter.cs | 2 --
 1 file changed, 2 deletions(-)

diff --git a/osu.Game/Audio/Effects/AudioFilter.cs b/osu.Game/Audio/Effects/AudioFilter.cs
index 268c31aa4c..ee48bdd7d9 100644
--- a/osu.Game/Audio/Effects/AudioFilter.cs
+++ b/osu.Game/Audio/Effects/AudioFilter.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 System.Diagnostics;
 using ManagedBass.Fx;
 using osu.Framework.Audio.Mixing;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
-using osu.Framework.Logging;
 
 namespace osu.Game.Audio.Effects
 {

From 79ac64a0885620f9755fb5cc82cb226c34cb21c5 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 12 Oct 2021 19:40:35 +0900
Subject: [PATCH 0172/5547] Split out editor save steps to try and catch test
 failure

---
 osu.Game.Tests/Visual/Editing/TestSceneEditorSaving.cs | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneEditorSaving.cs b/osu.Game.Tests/Visual/Editing/TestSceneEditorSaving.cs
index 2258a209e2..f4e704b22b 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneEditorSaving.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneEditorSaving.cs
@@ -41,11 +41,11 @@ namespace osu.Game.Tests.Visual.Editing
             AddStep("Move to playfield", () => InputManager.MoveMouseTo(Game.ScreenSpaceDrawQuad.Centre));
             AddStep("Place single hitcircle", () => InputManager.Click(MouseButton.Left));
 
-            AddStep("Save and exit", () =>
-            {
-                InputManager.Keys(PlatformAction.Save);
-                InputManager.Key(Key.Escape);
-            });
+            AddAssert("Beatmap contains single hitcircle", () => editorBeatmap.HitObjects.Count == 1);
+
+            AddStep("Save", () => InputManager.Keys(PlatformAction.Save));
+
+            AddStep("Exit", () => InputManager.Key(Key.Escape));
 
             AddUntilStep("Wait for main menu", () => Game.ScreenStack.CurrentScreen is MainMenu);
 

From 91c286b1ade4e8ff9941f972dd5718f9544b0ceb Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Tue, 12 Oct 2021 22:07:57 +0900
Subject: [PATCH 0173/5547] Fix intermittent TestScenePlaySongSelect test
 failures

---
 .../Visual/SongSelect/TestScenePlaySongSelect.cs   | 14 ++++++++------
 1 file changed, 8 insertions(+), 6 deletions(-)

diff --git a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
index 067f1cabb4..4811fc979e 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
@@ -142,6 +142,8 @@ namespace osu.Game.Tests.Visual.SongSelect
 
             AddStep("store selected beatmap", () => selected = Beatmap.Value);
 
+            AddUntilStep("wait for beatmaps to load", () => songSelect.Carousel.ChildrenOfType<DrawableCarouselBeatmap>().Any());
+
             AddStep("select next and enter", () =>
             {
                 InputManager.MoveMouseTo(songSelect.Carousel.ChildrenOfType<DrawableCarouselBeatmap>()
@@ -599,10 +601,10 @@ namespace osu.Game.Tests.Visual.SongSelect
             });
 
             FilterableDifficultyIcon difficultyIcon = null;
-            AddStep("Find an icon", () =>
+            AddUntilStep("Find an icon", () =>
             {
-                difficultyIcon = set.ChildrenOfType<FilterableDifficultyIcon>()
-                                    .First(icon => getDifficultyIconIndex(set, icon) != getCurrentBeatmapIndex());
+                return (difficultyIcon = set.ChildrenOfType<FilterableDifficultyIcon>()
+                                            .FirstOrDefault(icon => getDifficultyIconIndex(set, icon) != getCurrentBeatmapIndex())) != null;
             });
 
             AddStep("Click on a difficulty", () =>
@@ -765,10 +767,10 @@ namespace osu.Game.Tests.Visual.SongSelect
             });
 
             FilterableGroupedDifficultyIcon groupIcon = null;
-            AddStep("Find group icon for different ruleset", () =>
+            AddUntilStep("Find group icon for different ruleset", () =>
             {
-                groupIcon = set.ChildrenOfType<FilterableGroupedDifficultyIcon>()
-                               .First(icon => icon.Items.First().BeatmapInfo.Ruleset.ID == 3);
+                return (groupIcon = set.ChildrenOfType<FilterableGroupedDifficultyIcon>()
+                                       .FirstOrDefault(icon => icon.Items.First().BeatmapInfo.Ruleset.ID == 3)) != null;
             });
 
             AddAssert("Check ruleset is osu!", () => Ruleset.Value.ID == 0);

From 8dcfc3dd7e2608ef1bc715a546dab144e1d9fab3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 12 Oct 2021 18:31:20 +0200
Subject: [PATCH 0174/5547] Replace no-op seeks with wait steps

---
 .../Visual/Gameplay/TestSceneFrameStabilityContainer.cs     | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneFrameStabilityContainer.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneFrameStabilityContainer.cs
index 881e3f097c..ae0decaee1 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneFrameStabilityContainer.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneFrameStabilityContainer.cs
@@ -104,7 +104,7 @@ namespace osu.Game.Tests.Visual.Gameplay
         }
 
         [Test]
-        public void TestSeekToSameTimePreservesRate()
+        public void TestRatePreservedWhenTimeNotProgressing()
         {
             AddStep("set manual clock rate", () => manualClock.Rate = 1);
             seekManualTo(5000);
@@ -114,13 +114,13 @@ namespace osu.Game.Tests.Visual.Gameplay
             seekManualTo(10000);
             checkRate(1);
 
-            seekManualTo(10000);
+            AddWaitStep("wait some", 3);
             checkRate(1);
 
             seekManualTo(5000);
             checkRate(-1);
 
-            seekManualTo(5000);
+            AddWaitStep("wait some", 3);
             checkRate(-1);
 
             seekManualTo(10000);

From 5ddb7f74e225fd55195f354ede1af88a7a9c5953 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 3 Oct 2021 18:11:22 +0200
Subject: [PATCH 0175/5547] Adjust default dropdown dimensions & spacings

---
 osu.Game/Graphics/UserInterface/OsuDropdown.cs | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Graphics/UserInterface/OsuDropdown.cs b/osu.Game/Graphics/UserInterface/OsuDropdown.cs
index fe88e6f78a..d7d43f9fba 100644
--- a/osu.Game/Graphics/UserInterface/OsuDropdown.cs
+++ b/osu.Game/Graphics/UserInterface/OsuDropdown.cs
@@ -20,7 +20,7 @@ namespace osu.Game.Graphics.UserInterface
 {
     public class OsuDropdown<T> : Dropdown<T>, IHasAccentColour
     {
-        private const float corner_radius = 4;
+        private const float corner_radius = 5;
 
         private Color4 accentColour;
 
@@ -267,7 +267,7 @@ namespace osu.Game.Graphics.UserInterface
 
             public OsuDropdownHeader()
             {
-                Foreground.Padding = new MarginPadding(4);
+                Foreground.Padding = new MarginPadding(10);
 
                 AutoSizeAxes = Axes.None;
                 Margin = new MarginPadding { Bottom = 4 };
@@ -303,8 +303,7 @@ namespace osu.Game.Graphics.UserInterface
                                 Icon = FontAwesome.Solid.ChevronDown,
                                 Anchor = Anchor.CentreRight,
                                 Origin = Anchor.CentreRight,
-                                Margin = new MarginPadding { Horizontal = 5 },
-                                Size = new Vector2(12),
+                                Size = new Vector2(16),
                             },
                         }
                     }

From 1fba932e84582055397ca668deae298b52f14602 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 10 Oct 2021 19:23:30 +0200
Subject: [PATCH 0176/5547] Adjust settings dropdown spacings

---
 osu.Game/Overlays/Settings/SettingsDropdown.cs     | 7 ++++++-
 osu.Game/Overlays/Settings/SettingsEnumDropdown.cs | 1 -
 2 files changed, 6 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Overlays/Settings/SettingsDropdown.cs b/osu.Game/Overlays/Settings/SettingsDropdown.cs
index 1175ddaab8..a281d03ee7 100644
--- a/osu.Game/Overlays/Settings/SettingsDropdown.cs
+++ b/osu.Game/Overlays/Settings/SettingsDropdown.cs
@@ -6,6 +6,7 @@ using System.Linq;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Game.Graphics.UserInterface;
+using osuTK;
 
 namespace osu.Game.Overlays.Settings
 {
@@ -27,6 +28,11 @@ namespace osu.Game.Overlays.Settings
 
         public override IEnumerable<string> FilterTerms => base.FilterTerms.Concat(Control.Items.Select(i => i.ToString()));
 
+        public SettingsDropdown()
+        {
+            FlowContent.Spacing = new Vector2(0, 10);
+        }
+
         protected sealed override Drawable CreateControl() => CreateDropdown();
 
         protected virtual OsuDropdown<T> CreateDropdown() => new DropdownControl();
@@ -35,7 +41,6 @@ namespace osu.Game.Overlays.Settings
         {
             public DropdownControl()
             {
-                Margin = new MarginPadding { Top = 5 };
                 RelativeSizeAxes = Axes.X;
             }
 
diff --git a/osu.Game/Overlays/Settings/SettingsEnumDropdown.cs b/osu.Game/Overlays/Settings/SettingsEnumDropdown.cs
index 9987a0c607..199ba14b48 100644
--- a/osu.Game/Overlays/Settings/SettingsEnumDropdown.cs
+++ b/osu.Game/Overlays/Settings/SettingsEnumDropdown.cs
@@ -16,7 +16,6 @@ namespace osu.Game.Overlays.Settings
         {
             public DropdownControl()
             {
-                Margin = new MarginPadding { Top = 5 };
                 RelativeSizeAxes = Axes.X;
             }
 

From a2f3a7cba80834ee7330816e5b0575fb47d3e558 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 12 Oct 2021 21:58:43 +0200
Subject: [PATCH 0177/5547] Add "themed" dropdown variant and use in settings
 sidebar

---
 .../UserInterfaceV2/ThemedDropdown.cs         | 45 +++++++++++++++++++
 .../UserInterfaceV2/ThemedEnumDropdown.cs     | 16 +++++++
 .../Overlays/Settings/SettingsDropdown.cs     |  3 +-
 .../Overlays/Settings/SettingsEnumDropdown.cs |  3 +-
 4 files changed, 65 insertions(+), 2 deletions(-)
 create mode 100644 osu.Game/Graphics/UserInterfaceV2/ThemedDropdown.cs
 create mode 100644 osu.Game/Graphics/UserInterfaceV2/ThemedEnumDropdown.cs

diff --git a/osu.Game/Graphics/UserInterfaceV2/ThemedDropdown.cs b/osu.Game/Graphics/UserInterfaceV2/ThemedDropdown.cs
new file mode 100644
index 0000000000..299b6ee313
--- /dev/null
+++ b/osu.Game/Graphics/UserInterfaceV2/ThemedDropdown.cs
@@ -0,0 +1,45 @@
+// 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.UserInterface;
+using osu.Game.Graphics.UserInterface;
+using osu.Game.Overlays;
+
+namespace osu.Game.Graphics.UserInterfaceV2
+{
+    /// <summary>
+    /// A variant of <see cref="OsuDropdown{T}"/> that uses the nearest <see cref="OverlayColourProvider"/> for theming purposes.
+    /// </summary>
+    public class ThemedDropdown<T> : OsuDropdown<T>
+    {
+        [BackgroundDependencyLoader]
+        private void load(OverlayColourProvider colourProvider)
+        {
+            AccentColour = colourProvider.Light4;
+        }
+
+        protected override DropdownHeader CreateHeader() => new ThemedDropdownHeader();
+
+        protected override DropdownMenu CreateMenu() => new ThemedDropdownMenu();
+
+        protected class ThemedDropdownMenu : OsuDropdownMenu
+        {
+            [BackgroundDependencyLoader]
+            private void load(OverlayColourProvider colourProvider)
+            {
+                BackgroundColour = colourProvider.Background5;
+            }
+        }
+
+        protected class ThemedDropdownHeader : OsuDropdownHeader
+        {
+            [BackgroundDependencyLoader]
+            private void load(OverlayColourProvider colourProvider)
+            {
+                BackgroundColour = colourProvider.Background5;
+                BackgroundColourHover = colourProvider.Light4;
+            }
+        }
+    }
+}
diff --git a/osu.Game/Graphics/UserInterfaceV2/ThemedEnumDropdown.cs b/osu.Game/Graphics/UserInterfaceV2/ThemedEnumDropdown.cs
new file mode 100644
index 0000000000..5210c03bb9
--- /dev/null
+++ b/osu.Game/Graphics/UserInterfaceV2/ThemedEnumDropdown.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;
+
+namespace osu.Game.Graphics.UserInterfaceV2
+{
+    public class ThemedEnumDropdown<T> : ThemedDropdown<T>
+        where T : struct, Enum
+    {
+        public ThemedEnumDropdown()
+        {
+            Items = (T[])Enum.GetValues(typeof(T));
+        }
+    }
+}
diff --git a/osu.Game/Overlays/Settings/SettingsDropdown.cs b/osu.Game/Overlays/Settings/SettingsDropdown.cs
index a281d03ee7..c48a4f5ccc 100644
--- a/osu.Game/Overlays/Settings/SettingsDropdown.cs
+++ b/osu.Game/Overlays/Settings/SettingsDropdown.cs
@@ -6,6 +6,7 @@ using System.Linq;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Game.Graphics.UserInterface;
+using osu.Game.Graphics.UserInterfaceV2;
 using osuTK;
 
 namespace osu.Game.Overlays.Settings
@@ -37,7 +38,7 @@ namespace osu.Game.Overlays.Settings
 
         protected virtual OsuDropdown<T> CreateDropdown() => new DropdownControl();
 
-        protected class DropdownControl : OsuDropdown<T>
+        protected class DropdownControl : ThemedDropdown<T>
         {
             public DropdownControl()
             {
diff --git a/osu.Game/Overlays/Settings/SettingsEnumDropdown.cs b/osu.Game/Overlays/Settings/SettingsEnumDropdown.cs
index 199ba14b48..b901e8d719 100644
--- a/osu.Game/Overlays/Settings/SettingsEnumDropdown.cs
+++ b/osu.Game/Overlays/Settings/SettingsEnumDropdown.cs
@@ -4,6 +4,7 @@
 using System;
 using osu.Framework.Graphics;
 using osu.Game.Graphics.UserInterface;
+using osu.Game.Graphics.UserInterfaceV2;
 
 namespace osu.Game.Overlays.Settings
 {
@@ -12,7 +13,7 @@ namespace osu.Game.Overlays.Settings
     {
         protected override OsuDropdown<T> CreateDropdown() => new DropdownControl();
 
-        protected new class DropdownControl : OsuEnumDropdown<T>
+        protected new class DropdownControl : ThemedEnumDropdown<T>
         {
             public DropdownControl()
             {

From 7139c832b0b6bd583238e6b4545e4bc9c9403f2d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 12 Oct 2021 22:20:07 +0200
Subject: [PATCH 0178/5547] Add support for changing scrollbar accent colour &
 use in themed dropdown

---
 .../Graphics/Containers/OsuScrollContainer.cs | 67 ++++++++++++++++---
 .../UserInterfaceV2/ThemedDropdown.cs         |  1 +
 2 files changed, 59 insertions(+), 9 deletions(-)

diff --git a/osu.Game/Graphics/Containers/OsuScrollContainer.cs b/osu.Game/Graphics/Containers/OsuScrollContainer.cs
index aaad72f65c..f78f9deac1 100644
--- a/osu.Game/Graphics/Containers/OsuScrollContainer.cs
+++ b/osu.Game/Graphics/Containers/OsuScrollContainer.cs
@@ -24,11 +24,26 @@ namespace osu.Game.Graphics.Containers
         }
     }
 
-    public class OsuScrollContainer<T> : ScrollContainer<T> where T : Drawable
+    public class OsuScrollContainer<T> : ScrollContainer<T>, IHasAccentColour
+        where T : Drawable
     {
         public const float SCROLL_BAR_HEIGHT = 10;
         public const float SCROLL_BAR_PADDING = 3;
 
+        private Color4 accentColour;
+
+        public Color4 AccentColour
+        {
+            get => accentColour;
+            set
+            {
+                accentColour = value;
+
+                if (Scrollbar is IHasAccentColour accentedScrollbar)
+                    accentedScrollbar.AccentColour = value;
+            }
+        }
+
         /// <summary>
         /// Allows controlling the scroll bar from any position in the container using the right mouse button.
         /// Uses the value of <see cref="DistanceDecayOnRightMouseScrollbar"/> to smoothly scroll to the dragged location.
@@ -109,11 +124,27 @@ namespace osu.Game.Graphics.Containers
 
         protected override ScrollbarContainer CreateScrollbar(Direction direction) => new OsuScrollbar(direction);
 
-        protected class OsuScrollbar : ScrollbarContainer
+        protected class OsuScrollbar : ScrollbarContainer, IHasAccentColour
         {
+            private Color4 accentColour;
+
+            public Color4 AccentColour
+            {
+                get => accentColour;
+                set
+                {
+                    accentColour = value;
+
+                    if (IsLoaded)
+                        updateMouseDownState();
+                }
+            }
+
             private Color4 hoverColour;
             private Color4 defaultColour;
-            private Color4 highlightColour;
+
+            private bool mouseDown;
+            private const int fade_duration = 100;
 
             private readonly Box box;
 
@@ -146,7 +177,15 @@ namespace osu.Game.Graphics.Containers
             {
                 Colour = defaultColour = colours.Gray8;
                 hoverColour = colours.GrayF;
-                highlightColour = colours.Green;
+                AccentColour = colours.Green;
+            }
+
+            protected override void LoadComplete()
+            {
+                base.LoadComplete();
+
+                updateHoverState();
+                updateMouseDownState();
             }
 
             public override void ResizeTo(float val, int duration = 0, Easing easing = Easing.None)
@@ -160,21 +199,24 @@ namespace osu.Game.Graphics.Containers
 
             protected override bool OnHover(HoverEvent e)
             {
-                this.FadeColour(hoverColour, 100);
+                updateHoverState(fade_duration);
                 return true;
             }
 
             protected override void OnHoverLost(HoverLostEvent e)
             {
-                this.FadeColour(defaultColour, 100);
+                updateHoverState(fade_duration);
             }
 
+            private void updateHoverState(double duration = 0) => this.FadeColour(IsHovered ? hoverColour : defaultColour, duration);
+
             protected override bool OnMouseDown(MouseDownEvent e)
             {
                 if (!base.OnMouseDown(e)) return false;
 
-                // note that we are changing the colour of the box here as to not interfere with the hover effect.
-                box.FadeColour(highlightColour, 100);
+                mouseDown = true;
+                updateMouseDownState(fade_duration);
+
                 return true;
             }
 
@@ -182,10 +224,17 @@ namespace osu.Game.Graphics.Containers
             {
                 if (e.Button != MouseButton.Left) return;
 
-                box.FadeColour(Color4.White, 100);
+                mouseDown = false;
+                updateMouseDownState(fade_duration);
 
                 base.OnMouseUp(e);
             }
+
+            private void updateMouseDownState(double duration = 0)
+            {
+                // note that we are changing the colour of the box here as to not interfere with the hover effect.
+                box.FadeColour(mouseDown ? AccentColour : Color4.White, duration);
+            }
         }
     }
 }
diff --git a/osu.Game/Graphics/UserInterfaceV2/ThemedDropdown.cs b/osu.Game/Graphics/UserInterfaceV2/ThemedDropdown.cs
index 299b6ee313..40f190ee65 100644
--- a/osu.Game/Graphics/UserInterfaceV2/ThemedDropdown.cs
+++ b/osu.Game/Graphics/UserInterfaceV2/ThemedDropdown.cs
@@ -29,6 +29,7 @@ namespace osu.Game.Graphics.UserInterfaceV2
             private void load(OverlayColourProvider colourProvider)
             {
                 BackgroundColour = colourProvider.Background5;
+                ((IHasAccentColour)ContentContainer).AccentColour = colourProvider.Highlight1;
             }
         }
 

From 7c5bd2db7ba7f3731f2c499c315af0ef860cb6aa Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 12 Oct 2021 23:09:41 +0200
Subject: [PATCH 0179/5547] Allow using `ThemedDropdown` even if
 `OverlayColourProvider` not available

This is to accommodate `SettingsDropdown` usages without an available
`OverlayColourProvider`, such as mod settings controls and tournament
client usages.
---
 .../UserInterfaceV2/ThemedDropdown.cs         | 22 +++++++++++++------
 1 file changed, 15 insertions(+), 7 deletions(-)

diff --git a/osu.Game/Graphics/UserInterfaceV2/ThemedDropdown.cs b/osu.Game/Graphics/UserInterfaceV2/ThemedDropdown.cs
index 40f190ee65..ec96c23034 100644
--- a/osu.Game/Graphics/UserInterfaceV2/ThemedDropdown.cs
+++ b/osu.Game/Graphics/UserInterfaceV2/ThemedDropdown.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.
 
+#nullable enable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics.UserInterface;
 using osu.Game.Graphics.UserInterface;
@@ -9,13 +11,15 @@ using osu.Game.Overlays;
 namespace osu.Game.Graphics.UserInterfaceV2
 {
     /// <summary>
-    /// A variant of <see cref="OsuDropdown{T}"/> that uses the nearest <see cref="OverlayColourProvider"/> for theming purposes.
+    /// A variant of <see cref="OsuDropdown{T}"/> that uses the nearest <see cref="OverlayColourProvider"/> for theming purposes, if one is available.
     /// </summary>
     public class ThemedDropdown<T> : OsuDropdown<T>
     {
-        [BackgroundDependencyLoader]
-        private void load(OverlayColourProvider colourProvider)
+        [BackgroundDependencyLoader(true)]
+        private void load(OverlayColourProvider? colourProvider)
         {
+            if (colourProvider == null) return;
+
             AccentColour = colourProvider.Light4;
         }
 
@@ -25,9 +29,11 @@ namespace osu.Game.Graphics.UserInterfaceV2
 
         protected class ThemedDropdownMenu : OsuDropdownMenu
         {
-            [BackgroundDependencyLoader]
-            private void load(OverlayColourProvider colourProvider)
+            [BackgroundDependencyLoader(true)]
+            private void load(OverlayColourProvider? colourProvider)
             {
+                if (colourProvider == null) return;
+
                 BackgroundColour = colourProvider.Background5;
                 ((IHasAccentColour)ContentContainer).AccentColour = colourProvider.Highlight1;
             }
@@ -35,9 +41,11 @@ namespace osu.Game.Graphics.UserInterfaceV2
 
         protected class ThemedDropdownHeader : OsuDropdownHeader
         {
-            [BackgroundDependencyLoader]
-            private void load(OverlayColourProvider colourProvider)
+            [BackgroundDependencyLoader(true)]
+            private void load(OverlayColourProvider? colourProvider)
             {
+                if (colourProvider == null) return;
+
                 BackgroundColour = colourProvider.Background5;
                 BackgroundColourHover = colourProvider.Light4;
             }

From 94de24075e52d154ca042a8bf9116f5f434d8e23 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 13 Oct 2021 12:18:56 +0900
Subject: [PATCH 0180/5547] Ensure startup imports trigger notifications

---
 osu.Game/OsuGame.cs | 20 +++++++++++++-------
 1 file changed, 13 insertions(+), 7 deletions(-)

diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index 7895715045..020cdebab6 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -211,13 +211,6 @@ namespace osu.Game
         [BackgroundDependencyLoader]
         private void load()
         {
-            if (args?.Length > 0)
-            {
-                var paths = args.Where(a => !a.StartsWith('-')).ToArray();
-                if (paths.Length > 0)
-                    Task.Run(() => Import(paths));
-            }
-
             dependencies.CacheAs(this);
 
             dependencies.Cache(SentryLogger);
@@ -867,6 +860,19 @@ namespace osu.Game
             {
                 if (mode.NewValue != OverlayActivation.All) CloseAllOverlays();
             };
+
+            // Importantly, this should be run after binding PostNotification to the import handlers so they can present the import after game startup.
+            handleStartupImport();
+        }
+
+        private void handleStartupImport()
+        {
+            if (args?.Length > 0)
+            {
+                var paths = args.Where(a => !a.StartsWith('-')).ToArray();
+                if (paths.Length > 0)
+                    Task.Run(() => Import(paths));
+            }
         }
 
         private void showOverlayAboveOthers(OverlayContainer overlay, OverlayContainer[] otherOverlays)

From f69a56a26ac5debb0e365332e9f623fedb5fa937 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 13 Oct 2021 12:19:10 +0900
Subject: [PATCH 0181/5547] Add test coverage of startup import sequence

---
 .../Navigation/TestSceneStartupImport.cs      | 31 +++++++++++++++++++
 osu.Game/Database/ArchiveModelManager.cs      |  4 +--
 .../Database/ImportProgressNotification.cs    | 15 +++++++++
 osu.Game/Tests/Visual/OsuGameTestScene.cs     |  7 +++--
 4 files changed, 53 insertions(+), 4 deletions(-)
 create mode 100644 osu.Game.Tests/Visual/Navigation/TestSceneStartupImport.cs
 create mode 100644 osu.Game/Database/ImportProgressNotification.cs

diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneStartupImport.cs b/osu.Game.Tests/Visual/Navigation/TestSceneStartupImport.cs
new file mode 100644
index 0000000000..cb7c334656
--- /dev/null
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneStartupImport.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 System.Linq;
+using NUnit.Framework;
+using osu.Framework.Testing;
+using osu.Game.Database;
+using osu.Game.Tests.Resources;
+
+namespace osu.Game.Tests.Visual.Navigation
+{
+    public class TestSceneStartupImport : OsuGameTestScene
+    {
+        private string importFilename;
+
+        protected override TestOsuGame CreateTestGame() => new TestOsuGame(LocalStorage, API, new[] { importFilename });
+
+        public override void SetUpSteps()
+        {
+            AddStep("Prepare import beatmap", () => importFilename = TestResources.GetTestBeatmapForImport());
+
+            base.SetUpSteps();
+        }
+
+        [Test]
+        public void TestImportCreatedNotification()
+        {
+            AddUntilStep("Import notification was presented", () => Game.Notifications.ChildrenOfType<ImportProgressNotification>().Count() == 1);
+        }
+    }
+}
diff --git a/osu.Game/Database/ArchiveModelManager.cs b/osu.Game/Database/ArchiveModelManager.cs
index ee1a7e2900..c235fc7728 100644
--- a/osu.Game/Database/ArchiveModelManager.cs
+++ b/osu.Game/Database/ArchiveModelManager.cs
@@ -116,7 +116,7 @@ namespace osu.Game.Database
         /// <param name="paths">One or more archive locations on disk.</param>
         public Task Import(params string[] paths)
         {
-            var notification = new ProgressNotification { State = ProgressNotificationState.Active };
+            var notification = new ImportProgressNotification();
 
             PostNotification?.Invoke(notification);
 
@@ -125,7 +125,7 @@ namespace osu.Game.Database
 
         public Task Import(params ImportTask[] tasks)
         {
-            var notification = new ProgressNotification { State = ProgressNotificationState.Active };
+            var notification = new ImportProgressNotification();
 
             PostNotification?.Invoke(notification);
 
diff --git a/osu.Game/Database/ImportProgressNotification.cs b/osu.Game/Database/ImportProgressNotification.cs
new file mode 100644
index 0000000000..aaee3e117f
--- /dev/null
+++ b/osu.Game/Database/ImportProgressNotification.cs
@@ -0,0 +1,15 @@
+// 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.Overlays.Notifications;
+
+namespace osu.Game.Database
+{
+    public class ImportProgressNotification : ProgressNotification
+    {
+        public ImportProgressNotification()
+        {
+            State = ProgressNotificationState.Active;
+        }
+    }
+}
diff --git a/osu.Game/Tests/Visual/OsuGameTestScene.cs b/osu.Game/Tests/Visual/OsuGameTestScene.cs
index 77db697cb6..6a11bd3fea 100644
--- a/osu.Game/Tests/Visual/OsuGameTestScene.cs
+++ b/osu.Game/Tests/Visual/OsuGameTestScene.cs
@@ -78,9 +78,11 @@ namespace osu.Game.Tests.Visual
 
         protected void CreateGame()
         {
-            AddGame(Game = new TestOsuGame(LocalStorage, API));
+            AddGame(Game = CreateTestGame());
         }
 
+        protected virtual TestOsuGame CreateTestGame() => new TestOsuGame(LocalStorage, API);
+
         protected void PushAndConfirm(Func<Screen> newScreen)
         {
             Screen screen = null;
@@ -135,7 +137,8 @@ namespace osu.Game.Tests.Visual
 
             public new void PerformFromScreen(Action<IScreen> action, IEnumerable<Type> validScreens = null) => base.PerformFromScreen(action, validScreens);
 
-            public TestOsuGame(Storage storage, IAPIProvider api)
+            public TestOsuGame(Storage storage, IAPIProvider api, string[] args = null)
+                : base(args)
             {
                 Storage = storage;
                 API = api;

From cf10239e70408533a0138f9afb5a45ee4e615e99 Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Wed, 13 Oct 2021 12:51:41 +0900
Subject: [PATCH 0182/5547] Add a few nullabilities and DCC excludes

---
 osu.Game/Database/IHasRealmFiles.cs       | 2 ++
 osu.Game/Database/INamedFile.cs           | 8 +++++---
 osu.Game/Models/RealmBeatmapDifficulty.cs | 2 ++
 osu.Game/Models/RealmFile.cs              | 2 ++
 osu.Game/Models/RealmNamedFileUsage.cs    | 2 ++
 osu.Game/Stores/RealmFileStore.cs         | 2 ++
 6 files changed, 15 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Database/IHasRealmFiles.cs b/osu.Game/Database/IHasRealmFiles.cs
index 2adfe73d1e..024d9f2a89 100644
--- a/osu.Game/Database/IHasRealmFiles.cs
+++ b/osu.Game/Database/IHasRealmFiles.cs
@@ -4,6 +4,8 @@
 using System.Collections.Generic;
 using osu.Game.Models;
 
+#nullable enable
+
 namespace osu.Game.Database
 {
     /// <summary>
diff --git a/osu.Game/Database/INamedFile.cs b/osu.Game/Database/INamedFile.cs
index 9c94aed38c..2bd45d4e42 100644
--- a/osu.Game/Database/INamedFile.cs
+++ b/osu.Game/Database/INamedFile.cs
@@ -3,15 +3,17 @@
 
 using osu.Game.Models;
 
+#nullable enable
+
 namespace osu.Game.Database
 {
     /// <summary>
-    /// Represent a join model which gives a filename and scope to a <see cref="File"/>.
+    /// Represents a join model which gives a filename and scope to a <see cref="File"/>.
     /// </summary>
     public interface INamedFile
     {
-        public string Filename { get; set; }
+        string Filename { get; set; }
 
-        public RealmFile File { get; set; }
+        RealmFile File { get; set; }
     }
 }
diff --git a/osu.Game/Models/RealmBeatmapDifficulty.cs b/osu.Game/Models/RealmBeatmapDifficulty.cs
index 44bfdda491..3c1dad69e4 100644
--- a/osu.Game/Models/RealmBeatmapDifficulty.cs
+++ b/osu.Game/Models/RealmBeatmapDifficulty.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.Testing;
 using osu.Game.Beatmaps;
 using Realms;
 
@@ -8,6 +9,7 @@ using Realms;
 
 namespace osu.Game.Models
 {
+    [ExcludeFromDynamicCompile]
     [MapTo("BeatmapDifficulty")]
     public class RealmBeatmapDifficulty : EmbeddedObject, IBeatmapDifficultyInfo
     {
diff --git a/osu.Game/Models/RealmFile.cs b/osu.Game/Models/RealmFile.cs
index 6836d79d2d..2715f4be45 100644
--- a/osu.Game/Models/RealmFile.cs
+++ b/osu.Game/Models/RealmFile.cs
@@ -2,6 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System.IO;
+using osu.Framework.Testing;
 using osu.Game.IO;
 using Realms;
 
@@ -9,6 +10,7 @@ using Realms;
 
 namespace osu.Game.Models
 {
+    [ExcludeFromDynamicCompile]
     [MapTo("File")]
     public class RealmFile : RealmObject, IFileInfo
     {
diff --git a/osu.Game/Models/RealmNamedFileUsage.cs b/osu.Game/Models/RealmNamedFileUsage.cs
index 59b446112d..ba12d51d0b 100644
--- a/osu.Game/Models/RealmNamedFileUsage.cs
+++ b/osu.Game/Models/RealmNamedFileUsage.cs
@@ -2,6 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using JetBrains.Annotations;
+using osu.Framework.Testing;
 using osu.Game.Database;
 using osu.Game.IO;
 using Realms;
@@ -10,6 +11,7 @@ using Realms;
 
 namespace osu.Game.Models
 {
+    [ExcludeFromDynamicCompile]
     public class RealmNamedFileUsage : EmbeddedObject, INamedFile, INamedFileUsage
     {
         public RealmFile File { get; set; } = null!;
diff --git a/osu.Game/Stores/RealmFileStore.cs b/osu.Game/Stores/RealmFileStore.cs
index 5082b2c65b..f7b7471634 100644
--- a/osu.Game/Stores/RealmFileStore.cs
+++ b/osu.Game/Stores/RealmFileStore.cs
@@ -8,6 +8,7 @@ using osu.Framework.Extensions;
 using osu.Framework.IO.Stores;
 using osu.Framework.Logging;
 using osu.Framework.Platform;
+using osu.Framework.Testing;
 using osu.Game.Database;
 using osu.Game.Models;
 using Realms;
@@ -19,6 +20,7 @@ namespace osu.Game.Stores
     /// <summary>
     /// Handles the storing of files to the file system (and database) backing.
     /// </summary>
+    [ExcludeFromDynamicCompile]
     public class RealmFileStore
     {
         private readonly RealmContextFactory realmFactory;

From b37096f44062fbff4b4dd9e23708af55ffb4f249 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 13 Oct 2021 13:25:30 +0900
Subject: [PATCH 0183/5547] Avoid using bindable for `AudioFilter` cutoff

It doesn't play nicely with screen exiting, as it is automatically
unbound during the exit process. Easiest to just avoid using this for
now.
---
 .../Visual/Audio/TestSceneAudioFilter.cs      | 27 +++++++---
 osu.Game/Audio/Effects/AudioFilter.cs         | 51 ++++++++++---------
 .../Audio/Effects/ITransformableFilter.cs     |  7 ++-
 3 files changed, 50 insertions(+), 35 deletions(-)

diff --git a/osu.Game.Tests/Visual/Audio/TestSceneAudioFilter.cs b/osu.Game.Tests/Visual/Audio/TestSceneAudioFilter.cs
index 211543a881..851e0eb2a1 100644
--- a/osu.Game.Tests/Visual/Audio/TestSceneAudioFilter.cs
+++ b/osu.Game.Tests/Visual/Audio/TestSceneAudioFilter.cs
@@ -34,6 +34,9 @@ namespace osu.Game.Tests.Visual.Audio
             beatmap = new WaveformTestBeatmap(audio);
             track = beatmap.LoadTrack();
 
+            OsuSliderBar<int> lowPassCutoff;
+            OsuSliderBar<int> highPassCutoff;
+
             Add(new FillFlowContainer
             {
                 Children = new Drawable[]
@@ -43,33 +46,41 @@ namespace osu.Game.Tests.Visual.Audio
                     lowpassText = new OsuSpriteText
                     {
                         Padding = new MarginPadding(20),
-                        Text = $"Low Pass: {lowpassFilter.Cutoff.Value}hz",
+                        Text = $"Low Pass: {lowpassFilter.Cutoff}hz",
                         Font = new FontUsage(size: 40)
                     },
-                    new OsuSliderBar<int>
+                    lowPassCutoff = new OsuSliderBar<int>
                     {
                         Width = 500,
                         Height = 50,
                         Padding = new MarginPadding(20),
-                        Current = { BindTarget = lowpassFilter.Cutoff }
                     },
                     highpassText = new OsuSpriteText
                     {
                         Padding = new MarginPadding(20),
-                        Text = $"High Pass: {highpassFilter.Cutoff.Value}hz",
+                        Text = $"High Pass: {highpassFilter.Cutoff}hz",
                         Font = new FontUsage(size: 40)
                     },
-                    new OsuSliderBar<int>
+                    highPassCutoff = new OsuSliderBar<int>
                     {
                         Width = 500,
                         Height = 50,
                         Padding = new MarginPadding(20),
-                        Current = { BindTarget = highpassFilter.Cutoff }
                     }
                 }
             });
-            lowpassFilter.Cutoff.ValueChanged += e => lowpassText.Text = $"Low Pass: {e.NewValue}hz";
-            highpassFilter.Cutoff.ValueChanged += e => highpassText.Text = $"High Pass: {e.NewValue}hz";
+
+            lowPassCutoff.Current.ValueChanged += e =>
+            {
+                lowpassText.Text = $"Low Pass: {e.NewValue}hz";
+                lowpassFilter.Cutoff = e.NewValue;
+            };
+
+            highPassCutoff.Current.ValueChanged += e =>
+            {
+                highpassText.Text = $"High Pass: {e.NewValue}hz";
+                highpassFilter.Cutoff = e.NewValue;
+            };
         }
 
         [SetUpSteps]
diff --git a/osu.Game/Audio/Effects/AudioFilter.cs b/osu.Game/Audio/Effects/AudioFilter.cs
index ee48bdd7d9..0152254945 100644
--- a/osu.Game/Audio/Effects/AudioFilter.cs
+++ b/osu.Game/Audio/Effects/AudioFilter.cs
@@ -4,7 +4,6 @@
 using System.Diagnostics;
 using ManagedBass.Fx;
 using osu.Framework.Audio.Mixing;
-using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 
 namespace osu.Game.Audio.Effects
@@ -21,10 +20,25 @@ namespace osu.Game.Audio.Effects
         private readonly BQFParameters filter;
         private readonly BQFType type;
 
+        private int cutoff;
+
         /// <summary>
-        /// The current cutoff of this filter.
+        /// The cutoff frequency of this filter.
         /// </summary>
-        public BindableNumber<int> Cutoff { get; }
+        public int Cutoff
+        {
+            get => cutoff;
+            set
+            {
+                if (value == cutoff)
+                    return;
+
+                int oldValue = cutoff;
+                cutoff = value;
+
+                updateFilter(oldValue, cutoff);
+            }
+        }
 
         /// <summary>
         /// A Component that implements a BASS FX BiQuad Filter Effect.
@@ -36,33 +50,25 @@ namespace osu.Game.Audio.Effects
             this.mixer = mixer;
             this.type = type;
 
-            int initialCutoff;
-
             switch (type)
             {
                 case BQFType.HighPass:
-                    initialCutoff = 1;
+                    cutoff = 1;
                     break;
 
                 case BQFType.LowPass:
-                    initialCutoff = MAX_LOWPASS_CUTOFF;
+                    cutoff = MAX_LOWPASS_CUTOFF;
                     break;
 
                 default:
-                    initialCutoff = 500; // A default that should ensure audio remains audible for other filters.
+                    cutoff = 500; // A default that should ensure audio remains audible for other filters.
                     break;
             }
 
-            Cutoff = new BindableNumber<int>(initialCutoff)
-            {
-                MinValue = 1,
-                MaxValue = MAX_LOWPASS_CUTOFF
-            };
-
             filter = new BQFParameters
             {
                 lFilter = type,
-                fCenter = initialCutoff,
+                fCenter = cutoff,
                 fBandwidth = 0,
                 fQ = 0.7f // This allows fCenter to go up to 22049hz (nyquist - 1hz) without overflowing and causing weird filter behaviour (see: https://www.un4seen.com/forum/?topic=19542.0)
             };
@@ -70,8 +76,6 @@ namespace osu.Game.Audio.Effects
             // Don't start attached if this is low-pass or high-pass filter (as they have special auto-attach/detach logic)
             if (type != BQFType.LowPass && type != BQFType.HighPass)
                 attachFilter();
-
-            Cutoff.ValueChanged += updateFilter;
         }
 
         private void attachFilter()
@@ -86,40 +90,41 @@ namespace osu.Game.Audio.Effects
             mixer.Effects.Remove(filter);
         }
 
-        private void updateFilter(ValueChangedEvent<int> cutoff)
+        private void updateFilter(int oldValue, int newValue)
         {
             // Workaround for weird behaviour when rapidly setting fCenter of a low-pass filter to nyquist - 1hz.
             if (type == BQFType.LowPass)
             {
-                if (cutoff.NewValue >= MAX_LOWPASS_CUTOFF)
+                if (newValue >= MAX_LOWPASS_CUTOFF)
                 {
                     detachFilter();
                     return;
                 }
 
-                if (cutoff.OldValue >= MAX_LOWPASS_CUTOFF && cutoff.NewValue < MAX_LOWPASS_CUTOFF)
+                if (oldValue >= MAX_LOWPASS_CUTOFF)
                     attachFilter();
             }
 
             // Workaround for weird behaviour when rapidly setting fCenter of a high-pass filter to 1hz.
             if (type == BQFType.HighPass)
             {
-                if (cutoff.NewValue <= 1)
+                if (newValue <= 1)
                 {
                     detachFilter();
                     return;
                 }
 
-                if (cutoff.OldValue <= 1 && cutoff.NewValue > 1)
+                if (oldValue <= 1)
                     attachFilter();
             }
 
             var filterIndex = mixer.Effects.IndexOf(filter);
+
             if (filterIndex < 0) return;
 
             if (mixer.Effects[filterIndex] is BQFParameters existingFilter)
             {
-                existingFilter.fCenter = cutoff.NewValue;
+                existingFilter.fCenter = newValue;
 
                 // required to update effect with new parameters.
                 mixer.Effects[filterIndex] = existingFilter;
diff --git a/osu.Game/Audio/Effects/ITransformableFilter.cs b/osu.Game/Audio/Effects/ITransformableFilter.cs
index e4de4cf8ff..fb6a924f68 100644
--- a/osu.Game/Audio/Effects/ITransformableFilter.cs
+++ b/osu.Game/Audio/Effects/ITransformableFilter.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.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Transforms;
 
@@ -12,7 +11,7 @@ namespace osu.Game.Audio.Effects
         /// <summary>
         /// The filter cutoff.
         /// </summary>
-        BindableNumber<int> Cutoff { get; }
+        int Cutoff { get; set; }
     }
 
     public static class FilterableAudioComponentExtensions
@@ -40,7 +39,7 @@ namespace osu.Game.Audio.Effects
         public static TransformSequence<T> CutoffTo<T, TEasing>(this T component, int newCutoff, double duration, TEasing easing)
             where T : class, ITransformableFilter, IDrawable
             where TEasing : IEasingFunction
-            => component.TransformBindableTo(component.Cutoff, newCutoff, duration, easing);
+            => component.TransformTo(nameof(component.Cutoff), newCutoff, duration, easing);
 
         /// <summary>
         /// Smoothly adjusts filter cutoff over time.
@@ -49,6 +48,6 @@ namespace osu.Game.Audio.Effects
         public static TransformSequence<T> CutoffTo<T, TEasing>(this TransformSequence<T> sequence, int newCutoff, double duration, TEasing easing)
             where T : class, ITransformableFilter, IDrawable
             where TEasing : IEasingFunction
-            => sequence.Append(o => o.TransformBindableTo(o.Cutoff, newCutoff, duration, easing));
+            => sequence.Append(o => o.TransformTo(nameof(o.Cutoff), newCutoff, duration, easing));
     }
 }

From ae4dcbd8297b2803ca1df71c33722118a4a99134 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 13 Oct 2021 13:26:20 +0900
Subject: [PATCH 0184/5547] Improve `PlayerLoader` audio and visual transitions

---
 osu.Game/Screens/Play/PlayerLoader.cs | 71 ++++++++++++++++-----------
 1 file changed, 41 insertions(+), 30 deletions(-)

diff --git a/osu.Game/Screens/Play/PlayerLoader.cs b/osu.Game/Screens/Play/PlayerLoader.cs
index 94a61a4ef3..cf5bff57cf 100644
--- a/osu.Game/Screens/Play/PlayerLoader.cs
+++ b/osu.Game/Screens/Play/PlayerLoader.cs
@@ -35,6 +35,8 @@ namespace osu.Game.Screens.Play
     {
         protected const float BACKGROUND_BLUR = 15;
 
+        private const double content_out_duration = 300;
+
         public override bool HideOverlaysOnEnter => hideOverlays;
 
         public override bool DisallowExternalBeatmapRulesetChanges => true;
@@ -135,36 +137,39 @@ namespace osu.Game.Screens.Play
             muteWarningShownOnce = sessionStatics.GetBindable<bool>(Static.MutedAudioNotificationShownOnce);
             batteryWarningShownOnce = sessionStatics.GetBindable<bool>(Static.LowBatteryNotificationShownOnce);
 
-            InternalChild = (content = new LogoTrackingContainer
+            InternalChildren = new Drawable[]
             {
-                Anchor = Anchor.Centre,
-                Origin = Anchor.Centre,
-                RelativeSizeAxes = Axes.Both,
-            }).WithChildren(new Drawable[]
-            {
-                MetadataInfo = new BeatmapMetadataDisplay(Beatmap.Value, Mods, content.LogoFacade)
+                (content = new LogoTrackingContainer
                 {
-                    Alpha = 0,
                     Anchor = Anchor.Centre,
                     Origin = Anchor.Centre,
-                },
-                PlayerSettings = new FillFlowContainer<PlayerSettingsGroup>
+                    RelativeSizeAxes = Axes.Both,
+                }).WithChildren(new Drawable[]
                 {
-                    Anchor = Anchor.TopRight,
-                    Origin = Anchor.TopRight,
-                    AutoSizeAxes = Axes.Both,
-                    Direction = FillDirection.Vertical,
-                    Spacing = new Vector2(0, 20),
-                    Margin = new MarginPadding(25),
-                    Children = new PlayerSettingsGroup[]
+                    MetadataInfo = new BeatmapMetadataDisplay(Beatmap.Value, Mods, content.LogoFacade)
                     {
-                        VisualSettings = new VisualSettings(),
-                        new InputSettings()
-                    }
-                },
-                idleTracker = new IdleTracker(750),
+                        Alpha = 0,
+                        Anchor = Anchor.Centre,
+                        Origin = Anchor.Centre,
+                    },
+                    PlayerSettings = new FillFlowContainer<PlayerSettingsGroup>
+                    {
+                        Anchor = Anchor.TopRight,
+                        Origin = Anchor.TopRight,
+                        AutoSizeAxes = Axes.Both,
+                        Direction = FillDirection.Vertical,
+                        Spacing = new Vector2(0, 20),
+                        Margin = new MarginPadding(25),
+                        Children = new PlayerSettingsGroup[]
+                        {
+                            VisualSettings = new VisualSettings(),
+                            new InputSettings()
+                        }
+                    },
+                    idleTracker = new IdleTracker(750),
+                }),
                 lowPassFilter = new AudioFilter(audio.TrackMixer)
-            });
+            };
 
             if (Beatmap.Value.BeatmapInfo.EpilepsyWarning)
             {
@@ -195,7 +200,6 @@ namespace osu.Game.Screens.Play
                     epilepsyWarning.DimmableBackground = b;
             });
 
-            lowPassFilter.CutoffTo(500, 100, Easing.OutCubic);
             Beatmap.Value.Track.AddAdjustment(AdjustableProperty.Volume, volumeAdjustment);
 
             content.ScaleTo(0.7f);
@@ -240,15 +244,15 @@ namespace osu.Game.Screens.Play
         public override bool OnExiting(IScreen next)
         {
             cancelLoad();
+            contentOut();
 
-            content.ScaleTo(0.7f, 150, Easing.InQuint);
-            this.FadeOut(150);
+            // Ensure the screen doesn't expire until all the outwards fade operations have completed.
+            this.Delay(content_out_duration).FadeOut();
 
             ApplyToBackground(b => b.IgnoreUserSettings.Value = true);
 
             BackgroundBrightnessReduction = false;
             Beatmap.Value.Track.RemoveAdjustment(AdjustableProperty.Volume, volumeAdjustment);
-            lowPassFilter.CutoffTo(AudioFilter.MAX_LOWPASS_CUTOFF, 100, Easing.InCubic);
 
             return base.OnExiting(next);
         }
@@ -344,6 +348,7 @@ namespace osu.Game.Screens.Play
 
             content.FadeInFromZero(400);
             content.ScaleTo(1, 650, Easing.OutQuint).Then().Schedule(prepareNewPlayer);
+            lowPassFilter.CutoffTo(1000, 650, Easing.OutQuint);
 
             ApplyToBackground(b => b?.FadeColour(Color4.White, 800, Easing.OutQuint));
         }
@@ -353,8 +358,9 @@ namespace osu.Game.Screens.Play
             // Ensure the logo is no longer tracking before we scale the content
             content.StopTracking();
 
-            content.ScaleTo(0.7f, 300, Easing.InQuint);
-            content.FadeOut(250);
+            content.ScaleTo(0.7f, content_out_duration * 2, Easing.OutQuint);
+            content.FadeOut(content_out_duration, Easing.OutQuint);
+            lowPassFilter.CutoffTo(AudioFilter.MAX_LOWPASS_CUTOFF, content_out_duration);
         }
 
         private void pushWhenLoaded()
@@ -381,7 +387,7 @@ namespace osu.Game.Screens.Play
 
                 contentOut();
 
-                TransformSequence<PlayerLoader> pushSequence = this.Delay(250);
+                TransformSequence<PlayerLoader> pushSequence = this.Delay(content_out_duration);
 
                 // 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).
@@ -400,6 +406,11 @@ namespace osu.Game.Screens.Play
                         })
                         .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);
+                }
 
                 pushSequence.Schedule(() =>
                 {

From 26a1e40d2471a9d4e7e44ea0f98b1b1fbc6231c5 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 13 Oct 2021 13:47:49 +0900
Subject: [PATCH 0185/5547] Fix storyboard outro during fail test not being
 lenient enough

---
 .../Visual/Gameplay/TestSceneStoryboardWithOutro.cs         | 6 +++++-
 osu.Game/Screens/Play/FailAnimation.cs                      | 2 +-
 2 files changed, 6 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboardWithOutro.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboardWithOutro.cs
index 3ed274690e..48a97d54f7 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboardWithOutro.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboardWithOutro.cs
@@ -90,8 +90,12 @@ namespace osu.Game.Tests.Visual.Gameplay
             CreateTest(() =>
             {
                 AddStep("fail on first judgement", () => currentFailConditions = (_, __) => true);
-                AddStep("set storyboard duration to 1.3s", () => currentStoryboardDuration = 1300);
+
+                // Fail occurs at 164ms with the provided beatmap.
+                // Fail animation runs for 2.5s realtime but the gameplay time change is *variable* due to the frequency transform being applied, so we need a bit of lenience.
+                AddStep("set storyboard duration to 0.6s", () => currentStoryboardDuration = 600);
             });
+
             AddUntilStep("wait for fail", () => Player.HasFailed);
             AddUntilStep("storyboard ends", () => Player.GameplayClockContainer.GameplayClock.CurrentTime >= currentStoryboardDuration);
             AddUntilStep("wait for fail overlay", () => Player.FailOverlay.State.Value == Visibility.Visible);
diff --git a/osu.Game/Screens/Play/FailAnimation.cs b/osu.Game/Screens/Play/FailAnimation.cs
index e250791b72..ea158c5789 100644
--- a/osu.Game/Screens/Play/FailAnimation.cs
+++ b/osu.Game/Screens/Play/FailAnimation.cs
@@ -22,7 +22,7 @@ namespace osu.Game.Screens.Play
 {
     /// <summary>
     /// Manage the animation to be applied when a player fails.
-    /// Single file; automatically disposed after use.
+    /// Single use and automatically disposed after use.
     /// </summary>
     public class FailAnimation : CompositeDrawable
     {

From 02689a1b60269c6fe3952cfb35231d2e7ffd4f03 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 13 Oct 2021 14:34:31 +0900
Subject: [PATCH 0186/5547] Use actual `BeatmapInfo` rather than
 `PlayableBeatmap.BeatmapInfo` for editor writes

---
 .../Visual/Editing/TestSceneEditorSaving.cs          |  2 ++
 osu.Game/Beatmaps/BeatmapModelManager.cs             |  8 +++++++-
 osu.Game/Screens/Edit/Editor.cs                      |  6 +++---
 osu.Game/Screens/Edit/EditorBeatmap.cs               | 12 ++++++++----
 4 files changed, 20 insertions(+), 8 deletions(-)

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneEditorSaving.cs b/osu.Game.Tests/Visual/Editing/TestSceneEditorSaving.cs
index f0aa3e2350..49f7bdf997 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneEditorSaving.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneEditorSaving.cs
@@ -33,6 +33,7 @@ namespace osu.Game.Tests.Visual.Editing
             AddUntilStep("wait for editor load", () => editor != null);
 
             AddStep("Set overall difficulty", () => editorBeatmap.Difficulty.OverallDifficulty = 7);
+            AddStep("Set difficulty name", () => editorBeatmap.BeatmapInfo.Version = "diffname");
 
             AddStep("Add timing point", () => editorBeatmap.ControlPointInfo.Add(0, new TimingControlPoint()));
 
@@ -60,6 +61,7 @@ namespace osu.Game.Tests.Visual.Editing
             AddUntilStep("Wait for editor load", () => editor != null);
             AddAssert("Beatmap contains single hitcircle", () => editorBeatmap.HitObjects.Count == 1);
             AddAssert("Beatmap has correct overall difficulty", () => editorBeatmap.Difficulty.OverallDifficulty == 7);
+            AddAssert("Beatmap has correct difficulty name", () => editorBeatmap.BeatmapInfo.Version == "diffname");
         }
     }
 }
diff --git a/osu.Game/Beatmaps/BeatmapModelManager.cs b/osu.Game/Beatmaps/BeatmapModelManager.cs
index 9c0fc5ef8a..76019a15ae 100644
--- a/osu.Game/Beatmaps/BeatmapModelManager.cs
+++ b/osu.Game/Beatmaps/BeatmapModelManager.cs
@@ -192,6 +192,13 @@ namespace osu.Game.Beatmaps
         {
             var setInfo = beatmapInfo.BeatmapSet;
 
+            // Difficulty settings must be copied first due to the clone in `Beatmap<>.BeatmapInfo_Set`.
+            // This should hopefully be temporary, assuming said clone is eventually removed.
+            beatmapInfo.BaseDifficulty.CopyFrom(beatmapContent.Difficulty);
+
+            // All changes to metadata are made in the provided beatmapInfo, so this should be copied to the `IBeatmap` before encoding.
+            beatmapContent.BeatmapInfo = beatmapInfo;
+
             using (var stream = new MemoryStream())
             {
                 using (var sw = new StreamWriter(stream, Encoding.UTF8, 1024, true))
@@ -202,7 +209,6 @@ namespace osu.Game.Beatmaps
                 using (ContextFactory.GetForWrite())
                 {
                     beatmapInfo = setInfo.Beatmaps.Single(b => b.ID == beatmapInfo.ID);
-                    beatmapInfo.BaseDifficulty.CopyFrom(beatmapContent.Difficulty);
 
                     var metadata = beatmapInfo.Metadata ?? setInfo.Metadata;
 
diff --git a/osu.Game/Screens/Edit/Editor.cs b/osu.Game/Screens/Edit/Editor.cs
index 1170658abb..88bed109fe 100644
--- a/osu.Game/Screens/Edit/Editor.cs
+++ b/osu.Game/Screens/Edit/Editor.cs
@@ -162,7 +162,7 @@ namespace osu.Game.Screens.Edit
             // todo: remove caching of this and consume via editorBeatmap?
             dependencies.Cache(beatDivisor);
 
-            AddInternal(editorBeatmap = new EditorBeatmap(playableBeatmap, loadableBeatmap.GetSkin()));
+            AddInternal(editorBeatmap = new EditorBeatmap(playableBeatmap, loadableBeatmap.GetSkin(), loadableBeatmap.BeatmapInfo));
             dependencies.CacheAs(editorBeatmap);
             changeHandler = new EditorChangeHandler(editorBeatmap);
             dependencies.CacheAs<IEditorChangeHandler>(changeHandler);
@@ -333,10 +333,10 @@ namespace osu.Game.Screens.Edit
             isNewBeatmap = false;
 
             // apply any set-level metadata changes.
-            beatmapManager.Update(playableBeatmap.BeatmapInfo.BeatmapSet);
+            beatmapManager.Update(editorBeatmap.BeatmapInfo.BeatmapSet);
 
             // save the loaded beatmap's data stream.
-            beatmapManager.Save(playableBeatmap.BeatmapInfo, editorBeatmap, editorBeatmap.BeatmapSkin);
+            beatmapManager.Save(editorBeatmap.BeatmapInfo, editorBeatmap.PlayableBeatmap, editorBeatmap.BeatmapSkin);
 
             updateLastSavedHash();
         }
diff --git a/osu.Game/Screens/Edit/EditorBeatmap.cs b/osu.Game/Screens/Edit/EditorBeatmap.cs
index 64eb6225fa..c96c17326d 100644
--- a/osu.Game/Screens/Edit/EditorBeatmap.cs
+++ b/osu.Game/Screens/Edit/EditorBeatmap.cs
@@ -44,6 +44,7 @@ namespace osu.Game.Screens.Edit
         /// </summary>
         public readonly Bindable<HitObject> PlacementObject = new Bindable<HitObject>();
 
+        private readonly BeatmapInfo beatmapInfo;
         public readonly IBeatmap PlayableBeatmap;
 
         /// <summary>
@@ -66,9 +67,12 @@ namespace osu.Game.Screens.Edit
 
         private readonly Dictionary<HitObject, Bindable<double>> startTimeBindables = new Dictionary<HitObject, Bindable<double>>();
 
-        public EditorBeatmap(IBeatmap playableBeatmap, ISkin beatmapSkin = null)
+        public EditorBeatmap(IBeatmap playableBeatmap, ISkin beatmapSkin = null, BeatmapInfo beatmapInfo = null)
         {
             PlayableBeatmap = playableBeatmap;
+
+            this.beatmapInfo = beatmapInfo ?? playableBeatmap.BeatmapInfo;
+
             if (beatmapSkin is Skin skin)
                 BeatmapSkin = new EditorBeatmapSkin(skin);
 
@@ -80,11 +84,11 @@ namespace osu.Game.Screens.Edit
 
         public BeatmapInfo BeatmapInfo
         {
-            get => PlayableBeatmap.BeatmapInfo;
-            set => PlayableBeatmap.BeatmapInfo = value;
+            get => beatmapInfo;
+            set => throw new InvalidOperationException();
         }
 
-        public BeatmapMetadata Metadata => PlayableBeatmap.Metadata;
+        public BeatmapMetadata Metadata => beatmapInfo.Metadata;
 
         public BeatmapDifficulty Difficulty
         {

From 29dfe33465aa61ba7b7866b4e136b7b11ce0fe84 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 13 Oct 2021 15:13:35 +0900
Subject: [PATCH 0187/5547] Rewrite `AudioFilter` to be easier to follow (and
 fix tests)

---
 .../Visual/Audio/TestSceneAudioFilter.cs      |  83 ++++++++----
 osu.Game/Audio/Effects/AudioFilter.cs         | 123 +++++++++---------
 2 files changed, 119 insertions(+), 87 deletions(-)

diff --git a/osu.Game.Tests/Visual/Audio/TestSceneAudioFilter.cs b/osu.Game.Tests/Visual/Audio/TestSceneAudioFilter.cs
index 851e0eb2a1..0107632f6e 100644
--- a/osu.Game.Tests/Visual/Audio/TestSceneAudioFilter.cs
+++ b/osu.Game.Tests/Visual/Audio/TestSceneAudioFilter.cs
@@ -6,6 +6,7 @@ using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
 using osu.Framework.Audio.Track;
+using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Sprites;
@@ -18,84 +19,112 @@ namespace osu.Game.Tests.Visual.Audio
 {
     public class TestSceneAudioFilter : OsuTestScene
     {
-        private OsuSpriteText lowpassText;
-        private AudioFilter lowpassFilter;
+        private OsuSpriteText lowPassText;
+        private AudioFilter lowPassFilter;
 
-        private OsuSpriteText highpassText;
-        private AudioFilter highpassFilter;
+        private OsuSpriteText highPassText;
+        private AudioFilter highPassFilter;
 
         private Track track;
 
         private WaveformTestBeatmap beatmap;
 
+        private OsuSliderBar<int> lowPassSlider;
+        private OsuSliderBar<int> highPassSlider;
+
         [BackgroundDependencyLoader]
         private void load(AudioManager audio)
         {
             beatmap = new WaveformTestBeatmap(audio);
             track = beatmap.LoadTrack();
 
-            OsuSliderBar<int> lowPassCutoff;
-            OsuSliderBar<int> highPassCutoff;
-
             Add(new FillFlowContainer
             {
                 Children = new Drawable[]
                 {
-                    lowpassFilter = new AudioFilter(audio.TrackMixer),
-                    highpassFilter = new AudioFilter(audio.TrackMixer, BQFType.HighPass),
-                    lowpassText = new OsuSpriteText
+                    lowPassFilter = new AudioFilter(audio.TrackMixer),
+                    highPassFilter = new AudioFilter(audio.TrackMixer, BQFType.HighPass),
+                    lowPassText = new OsuSpriteText
                     {
                         Padding = new MarginPadding(20),
-                        Text = $"Low Pass: {lowpassFilter.Cutoff}hz",
+                        Text = $"Low Pass: {lowPassFilter.Cutoff}hz",
                         Font = new FontUsage(size: 40)
                     },
-                    lowPassCutoff = new OsuSliderBar<int>
+                    lowPassSlider = new OsuSliderBar<int>
                     {
                         Width = 500,
                         Height = 50,
                         Padding = new MarginPadding(20),
+                        Current = new BindableInt
+                        {
+                            MinValue = 0,
+                            MaxValue = AudioFilter.MAX_LOWPASS_CUTOFF,
+                        }
                     },
-                    highpassText = new OsuSpriteText
+                    highPassText = new OsuSpriteText
                     {
                         Padding = new MarginPadding(20),
-                        Text = $"High Pass: {highpassFilter.Cutoff}hz",
+                        Text = $"High Pass: {highPassFilter.Cutoff}hz",
                         Font = new FontUsage(size: 40)
                     },
-                    highPassCutoff = new OsuSliderBar<int>
+                    highPassSlider = new OsuSliderBar<int>
                     {
                         Width = 500,
                         Height = 50,
                         Padding = new MarginPadding(20),
+                        Current = new BindableInt
+                        {
+                            MinValue = 0,
+                            MaxValue = AudioFilter.MAX_LOWPASS_CUTOFF,
+                        }
                     }
                 }
             });
 
-            lowPassCutoff.Current.ValueChanged += e =>
+            lowPassSlider.Current.ValueChanged += e =>
             {
-                lowpassText.Text = $"Low Pass: {e.NewValue}hz";
-                lowpassFilter.Cutoff = e.NewValue;
+                lowPassText.Text = $"Low Pass: {e.NewValue}hz";
+                lowPassFilter.Cutoff = e.NewValue;
             };
 
-            highPassCutoff.Current.ValueChanged += e =>
+            highPassSlider.Current.ValueChanged += e =>
             {
-                highpassText.Text = $"High Pass: {e.NewValue}hz";
-                highpassFilter.Cutoff = e.NewValue;
+                highPassText.Text = $"High Pass: {e.NewValue}hz";
+                highPassFilter.Cutoff = e.NewValue;
             };
         }
 
+        #region Overrides of Drawable
+
+        protected override void Update()
+        {
+            base.Update();
+            highPassSlider.Current.Value = highPassFilter.Cutoff;
+            lowPassSlider.Current.Value = lowPassFilter.Cutoff;
+        }
+
+        #endregion
+
         [SetUpSteps]
         public void SetUpSteps()
         {
             AddStep("Play Track", () => track.Start());
+
+            AddStep("Reset filters", () =>
+            {
+                lowPassFilter.Cutoff = AudioFilter.MAX_LOWPASS_CUTOFF;
+                highPassFilter.Cutoff = 0;
+            });
+
             waitTrackPlay();
         }
 
         [Test]
-        public void TestLowPass()
+        public void TestLowPassSweep()
         {
             AddStep("Filter Sweep", () =>
             {
-                lowpassFilter.CutoffTo(AudioFilter.MAX_LOWPASS_CUTOFF).Then()
+                lowPassFilter.CutoffTo(AudioFilter.MAX_LOWPASS_CUTOFF).Then()
                              .CutoffTo(0, 2000, Easing.OutCubic);
             });
 
@@ -103,7 +132,7 @@ namespace osu.Game.Tests.Visual.Audio
 
             AddStep("Filter Sweep (reverse)", () =>
             {
-                lowpassFilter.CutoffTo(0).Then()
+                lowPassFilter.CutoffTo(0).Then()
                              .CutoffTo(AudioFilter.MAX_LOWPASS_CUTOFF, 2000, Easing.InCubic);
             });
 
@@ -112,11 +141,11 @@ namespace osu.Game.Tests.Visual.Audio
         }
 
         [Test]
-        public void TestHighPass()
+        public void TestHighPassSweep()
         {
             AddStep("Filter Sweep", () =>
             {
-                highpassFilter.CutoffTo(0).Then()
+                highPassFilter.CutoffTo(0).Then()
                               .CutoffTo(AudioFilter.MAX_LOWPASS_CUTOFF, 2000, Easing.InCubic);
             });
 
@@ -124,7 +153,7 @@ namespace osu.Game.Tests.Visual.Audio
 
             AddStep("Filter Sweep (reverse)", () =>
             {
-                highpassFilter.CutoffTo(AudioFilter.MAX_LOWPASS_CUTOFF).Then()
+                highPassFilter.CutoffTo(AudioFilter.MAX_LOWPASS_CUTOFF).Then()
                               .CutoffTo(0, 2000, Easing.OutCubic);
             });
 
diff --git a/osu.Game/Audio/Effects/AudioFilter.cs b/osu.Game/Audio/Effects/AudioFilter.cs
index 0152254945..d2a39e9db7 100644
--- a/osu.Game/Audio/Effects/AudioFilter.cs
+++ b/osu.Game/Audio/Effects/AudioFilter.cs
@@ -20,6 +20,8 @@ namespace osu.Game.Audio.Effects
         private readonly BQFParameters filter;
         private readonly BQFType type;
 
+        private bool isAttached;
+
         private int cutoff;
 
         /// <summary>
@@ -33,10 +35,8 @@ namespace osu.Game.Audio.Effects
                 if (value == cutoff)
                     return;
 
-                int oldValue = cutoff;
                 cutoff = value;
-
-                updateFilter(oldValue, cutoff);
+                updateFilter(cutoff);
             }
         }
 
@@ -50,73 +50,58 @@ namespace osu.Game.Audio.Effects
             this.mixer = mixer;
             this.type = type;
 
-            switch (type)
-            {
-                case BQFType.HighPass:
-                    cutoff = 1;
-                    break;
-
-                case BQFType.LowPass:
-                    cutoff = MAX_LOWPASS_CUTOFF;
-                    break;
-
-                default:
-                    cutoff = 500; // A default that should ensure audio remains audible for other filters.
-                    break;
-            }
-
             filter = new BQFParameters
             {
                 lFilter = type,
-                fCenter = cutoff,
                 fBandwidth = 0,
-                fQ = 0.7f // This allows fCenter to go up to 22049hz (nyquist - 1hz) without overflowing and causing weird filter behaviour (see: https://www.un4seen.com/forum/?topic=19542.0)
+                // This allows fCenter to go up to 22049hz (nyquist - 1hz) without overflowing and causing weird filter behaviour (see: https://www.un4seen.com/forum/?topic=19542.0)
+                fQ = 0.7f
             };
 
-            // Don't start attached if this is low-pass or high-pass filter (as they have special auto-attach/detach logic)
-            if (type != BQFType.LowPass && type != BQFType.HighPass)
-                attachFilter();
+            Cutoff = getInitialCutoff(type);
         }
 
-        private void attachFilter()
+        private int getInitialCutoff(BQFType type)
         {
-            Debug.Assert(!mixer.Effects.Contains(filter));
-            mixer.Effects.Add(filter);
-        }
-
-        private void detachFilter()
-        {
-            Debug.Assert(mixer.Effects.Contains(filter));
-            mixer.Effects.Remove(filter);
-        }
-
-        private void updateFilter(int oldValue, int newValue)
-        {
-            // Workaround for weird behaviour when rapidly setting fCenter of a low-pass filter to nyquist - 1hz.
-            if (type == BQFType.LowPass)
+            switch (type)
             {
-                if (newValue >= MAX_LOWPASS_CUTOFF)
-                {
-                    detachFilter();
-                    return;
-                }
+                case BQFType.HighPass:
+                    return 1;
 
-                if (oldValue >= MAX_LOWPASS_CUTOFF)
-                    attachFilter();
+                case BQFType.LowPass:
+                    return MAX_LOWPASS_CUTOFF;
+
+                default:
+                    return 500; // A default that should ensure audio remains audible for other filters.
+            }
+        }
+
+        private void updateFilter(int newValue)
+        {
+            switch (type)
+            {
+                case BQFType.LowPass:
+                    // Workaround for weird behaviour when rapidly setting fCenter of a low-pass filter to nyquist - 1hz.
+                    if (newValue >= MAX_LOWPASS_CUTOFF)
+                    {
+                        ensureDetached();
+                        return;
+                    }
+
+                    break;
+
+                // Workaround for weird behaviour when rapidly setting fCenter of a high-pass filter to 1hz.
+                case BQFType.HighPass:
+                    if (newValue <= 1)
+                    {
+                        ensureDetached();
+                        return;
+                    }
+
+                    break;
             }
 
-            // Workaround for weird behaviour when rapidly setting fCenter of a high-pass filter to 1hz.
-            if (type == BQFType.HighPass)
-            {
-                if (newValue <= 1)
-                {
-                    detachFilter();
-                    return;
-                }
-
-                if (oldValue <= 1)
-                    attachFilter();
-            }
+            ensureAttached();
 
             var filterIndex = mixer.Effects.IndexOf(filter);
 
@@ -131,12 +116,30 @@ namespace osu.Game.Audio.Effects
             }
         }
 
+        private void ensureAttached()
+        {
+            if (isAttached)
+                return;
+
+            Debug.Assert(!mixer.Effects.Contains(filter));
+            mixer.Effects.Add(filter);
+            isAttached = true;
+        }
+
+        private void ensureDetached()
+        {
+            if (!isAttached)
+                return;
+
+            Debug.Assert(mixer.Effects.Contains(filter));
+            mixer.Effects.Remove(filter);
+            isAttached = false;
+        }
+
         protected override void Dispose(bool isDisposing)
         {
             base.Dispose(isDisposing);
-
-            if (mixer.Effects.Contains(filter))
-                detachFilter();
+            ensureDetached();
         }
     }
 }

From e36c484060edeb764626b49a23b4ed45cf73ae11 Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Wed, 13 Oct 2021 15:30:58 +0900
Subject: [PATCH 0188/5547] Ensure rewinding before the spinner's start time

---
 .../TestSceneSpinnerRotation.cs               | 29 ++++++-------------
 1 file changed, 9 insertions(+), 20 deletions(-)

diff --git a/osu.Game.Rulesets.Osu.Tests/TestSceneSpinnerRotation.cs b/osu.Game.Rulesets.Osu.Tests/TestSceneSpinnerRotation.cs
index 9da583a073..52ab39cfbd 100644
--- a/osu.Game.Rulesets.Osu.Tests/TestSceneSpinnerRotation.cs
+++ b/osu.Game.Rulesets.Osu.Tests/TestSceneSpinnerRotation.cs
@@ -30,6 +30,9 @@ namespace osu.Game.Rulesets.Osu.Tests
 {
     public class TestSceneSpinnerRotation : TestSceneOsuPlayer
     {
+        private const double spinner_start_time = 100;
+        private const double spinner_duration = 6000;
+
         [Resolved]
         private AudioManager audioManager { get; set; }
 
@@ -77,7 +80,7 @@ namespace osu.Game.Rulesets.Osu.Tests
             double finalTrackerRotation = 0, trackerRotationTolerance = 0;
             double finalSpinnerSymbolRotation = 0, spinnerSymbolRotationTolerance = 0;
 
-            addSeekStep(5000);
+            addSeekStep(spinner_start_time + 5000);
             AddStep("retrieve disc rotation", () =>
             {
                 finalTrackerRotation = drawableSpinner.RotationTracker.Rotation;
@@ -90,7 +93,7 @@ namespace osu.Game.Rulesets.Osu.Tests
             });
             AddStep("retrieve cumulative disc rotation", () => finalCumulativeTrackerRotation = drawableSpinner.Result.RateAdjustedRotation);
 
-            addSeekStep(2500);
+            addSeekStep(spinner_start_time + 2500);
             AddAssert("disc rotation rewound",
                 // we want to make sure that the rotation at time 2500 is in the same direction as at time 5000, but about half-way in.
                 // due to the exponential damping applied we're allowing a larger margin of error of about 10%
@@ -102,7 +105,7 @@ namespace osu.Game.Rulesets.Osu.Tests
                 // cumulative rotation is not damped, so we're treating it as the "ground truth" and allowing a comparatively smaller margin of error.
                 () => Precision.AlmostEquals(drawableSpinner.Result.RateAdjustedRotation, finalCumulativeTrackerRotation / 2, 100));
 
-            addSeekStep(5000);
+            addSeekStep(spinner_start_time + 5000);
             AddAssert("is disc rotation almost same",
                 () => Precision.AlmostEquals(drawableSpinner.RotationTracker.Rotation, finalTrackerRotation, trackerRotationTolerance));
             AddAssert("is symbol rotation almost same",
@@ -140,7 +143,7 @@ namespace osu.Game.Rulesets.Osu.Tests
         [Test]
         public void TestSpinnerNormalBonusRewinding()
         {
-            addSeekStep(1000);
+            addSeekStep(spinner_start_time + 1000);
 
             AddAssert("player score matching expected bonus score", () =>
             {
@@ -201,24 +204,9 @@ namespace osu.Game.Rulesets.Osu.Tests
             AddAssert("spm almost same", () => Precision.AlmostEquals(expectedSpm, drawableSpinner.SpinsPerMinute.Value, 2.0));
         }
 
-        private Replay applyRateAdjustment(Replay scoreReplay, double rate) => new Replay
-        {
-            Frames = scoreReplay
-                     .Frames
-                     .Cast<OsuReplayFrame>()
-                     .Select(replayFrame =>
-                     {
-                         var adjustedTime = replayFrame.Time * rate;
-                         return new OsuReplayFrame(adjustedTime, replayFrame.Position, replayFrame.Actions.ToArray());
-                     })
-                     .Cast<ReplayFrame>()
-                     .ToList()
-        };
-
         private void addSeekStep(double time)
         {
             AddStep($"seek to {time}", () => Player.GameplayClockContainer.Seek(time));
-
             AddUntilStep("wait for seek to finish", () => Precision.AlmostEquals(time, Player.DrawableRuleset.FrameStableClock.CurrentTime, 100));
         }
 
@@ -241,7 +229,8 @@ namespace osu.Game.Rulesets.Osu.Tests
                 new Spinner
                 {
                     Position = new Vector2(256, 192),
-                    EndTime = 6000,
+                    StartTime = spinner_start_time,
+                    Duration = spinner_duration
                 },
             }
         };

From db5099de3ad38a6a986f4870ed30e4e97df51bfa Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 13 Oct 2021 15:45:01 +0900
Subject: [PATCH 0189/5547] Add missing licence header

---
 osu.Game.Tests/Database/GeneralUsageTests.cs | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/osu.Game.Tests/Database/GeneralUsageTests.cs b/osu.Game.Tests/Database/GeneralUsageTests.cs
index 245981cd9b..3e8b6091fd 100644
--- a/osu.Game.Tests/Database/GeneralUsageTests.cs
+++ b/osu.Game.Tests/Database/GeneralUsageTests.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;
 using System.Threading;
 using System.Threading.Tasks;

From 93d7cdc509c8ec384c85e82228345ca778d429f7 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 13 Oct 2021 15:50:05 +0900
Subject: [PATCH 0190/5547] Don't check whether the source realm was closed or
 not

Based on what we now know, this is not required, as long as there is
another realm context open on the same thread.
---
 osu.Game/Database/RealmLive.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Database/RealmLive.cs b/osu.Game/Database/RealmLive.cs
index 71fb44f617..abb69644d6 100644
--- a/osu.Game/Database/RealmLive.cs
+++ b/osu.Game/Database/RealmLive.cs
@@ -102,7 +102,7 @@ namespace osu.Game.Database
             }
         }
 
-        private bool originalDataValid => isCorrectThread && data.IsValid && !data.Realm.IsClosed;
+        private bool originalDataValid => isCorrectThread && data.IsValid;
 
         // this matches realm's internal thread validation (see https://github.com/realm/realm-dotnet/blob/903b4d0b304f887e37e2d905384fb572a6496e70/Realm/Realm/Native/SynchronizationContextScheduler.cs#L72)
         private bool isCorrectThread

From 5e934cdd2bdb4badf923c90fd8d66c0340f2f8a4 Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Wed, 13 Oct 2021 17:42:55 +0900
Subject: [PATCH 0191/5547] Make CFS error and fail the job

---
 .github/workflows/ci.yml | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 29cbdd2d37..128ae8f409 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -79,9 +79,12 @@ jobs:
         run: |
           # TODO: Add ignore filters and GitHub Workflow Command Reporting in CFS. That way we don't have to do this workaround.
           # FIXME: Suppress warnings from templates project
-          dotnet codefilesanity | while read -r line; do
-            echo "::warning::$line"
-          done
+          exit_code=0
+          while read -r line; do
+              echo "::error::$line"
+              exit_code=1
+          done <<< $(dotnet codefilesanity)
+          exit $exit_code
 
       # Temporarily disabled due to test failures, but it won't work anyway until the tool is upgraded.
       # - name: .NET Format (Dry Run)

From e12249f1270a22cf5811a8bb7a9ee44f2c0250db Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Wed, 13 Oct 2021 17:56:33 +0900
Subject: [PATCH 0192/5547] Exclude empty lines

---
 .github/workflows/ci.yml | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 128ae8f409..0da1f9636b 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -81,8 +81,10 @@ jobs:
           # FIXME: Suppress warnings from templates project
           exit_code=0
           while read -r line; do
+            if [[ ! -z "$line" ]]; then
               echo "::error::$line"
               exit_code=1
+            fi
           done <<< $(dotnet codefilesanity)
           exit $exit_code
 

From 6d1b9be7fd4d5a482ac04dd9f01e0fe051bde2ff Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Wed, 13 Oct 2021 17:56:56 +0900
Subject: [PATCH 0193/5547] Test CFS failure

---
 osu.Game/OsuGame.cs | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index 020cdebab6..1c277a3bd7 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -1,6 +1,3 @@
-// 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;

From 08bbdc70fc96a26832911db0a133c46ca289d2cf Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Wed, 13 Oct 2021 17:57:09 +0900
Subject: [PATCH 0194/5547] Revert "Test CFS failure"

This reverts commit 6d1b9be7fd4d5a482ac04dd9f01e0fe051bde2ff.
---
 osu.Game/OsuGame.cs | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index 1c277a3bd7..020cdebab6 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.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;
 using System.Collections.Generic;
 using System.Diagnostics;

From 2af1e6acc7bb0ffedda8fad659a215eed64ca3be Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 13 Oct 2021 18:02:22 +0900
Subject: [PATCH 0195/5547] Update framework

---
 osu.Android.props        | 2 +-
 osu.Game/osu.Game.csproj | 2 +-
 osu.iOS.props            | 4 ++--
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Android.props b/osu.Android.props
index 956093b2ac..db62667fc2 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -52,7 +52,7 @@
   </ItemGroup>
   <ItemGroup>
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1004.0" />
-    <PackageReference Include="ppy.osu.Framework.Android" Version="2021.1012.0" />
+    <PackageReference Include="ppy.osu.Framework.Android" Version="2021.1013.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
     <!-- Realm needs to be directly referenced in all Xamarin projects, as it will not pull in its transitive dependencies otherwise. -->
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 184c9d3f63..c6121ddd5f 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="10.6.0" />
-    <PackageReference Include="ppy.osu.Framework" Version="2021.1012.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2021.1013.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1004.0" />
     <PackageReference Include="Sentry" Version="3.9.4" />
     <PackageReference Include="SharpCompress" Version="0.29.0" />
diff --git a/osu.iOS.props b/osu.iOS.props
index 38b920420b..110de79285 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -70,7 +70,7 @@
     <Reference Include="System.Net.Http" />
   </ItemGroup>
   <ItemGroup Label="Package References">
-    <PackageReference Include="ppy.osu.Framework.iOS" Version="2021.1012.0" />
+    <PackageReference Include="ppy.osu.Framework.iOS" Version="2021.1013.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1004.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net5.0 / net6.0) -->
@@ -93,7 +93,7 @@
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="2.2.6" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.Core" Version="2.2.6" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
-    <PackageReference Include="ppy.osu.Framework" Version="2021.1012.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2021.1013.0" />
     <PackageReference Include="SharpCompress" Version="0.28.3" />
     <PackageReference Include="NUnit" Version="3.13.2" />
     <PackageReference Include="SharpRaven" Version="2.4.0" />

From ceec81d54d8727986415a308686369453420b7ca Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Wed, 13 Oct 2021 20:26:54 +0900
Subject: [PATCH 0196/5547] Fix another spinner test failure

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

diff --git a/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModAutoplay.cs b/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModAutoplay.cs
index 0ba775e5c7..37f1a846ad 100644
--- a/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModAutoplay.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModAutoplay.cs
@@ -45,8 +45,8 @@ namespace osu.Game.Rulesets.Osu.Tests.Mods
                     {
                         new Spinner
                         {
-                            Duration = 2000,
-                            Position = OsuPlayfield.BASE_SIZE / 2
+                            Duration = 6000,
+                            Position = OsuPlayfield.BASE_SIZE / 2,
                         }
                     }
                 },

From fdf714271117211dc4ed3897c307c2466203ad90 Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Wed, 13 Oct 2021 21:24:54 +0900
Subject: [PATCH 0197/5547] Remove Room.Position

---
 osu.Game/Online/Rooms/Room.cs                             | 8 --------
 osu.Game/Screens/OnlinePlay/Components/RoomManager.cs     | 2 --
 .../OnlinePlay/Lounge/Components/RoomsContainer.cs        | 2 +-
 3 files changed, 1 insertion(+), 11 deletions(-)

diff --git a/osu.Game/Online/Rooms/Room.cs b/osu.Game/Online/Rooms/Room.cs
index 5f71b4be4a..39fc7f1da8 100644
--- a/osu.Game/Online/Rooms/Room.cs
+++ b/osu.Game/Online/Rooms/Room.cs
@@ -130,12 +130,6 @@ namespace osu.Game.Online.Rooms
             set => MaxAttempts.Value = value;
         }
 
-        /// <summary>
-        /// The position of this <see cref="Room"/> in the list. This is not read from or written to the API.
-        /// </summary>
-        [JsonIgnore]
-        public readonly Bindable<long> Position = new Bindable<long>(-1); // Todo: This does not need to exist.
-
         public Room()
         {
             Password.BindValueChanged(p => HasPassword.Value = !string.IsNullOrEmpty(p.NewValue));
@@ -192,8 +186,6 @@ namespace osu.Game.Online.Rooms
                 RecentParticipants.Clear();
                 RecentParticipants.AddRange(other.RecentParticipants);
             }
-
-            Position.Value = other.Position.Value;
         }
 
         public void RemoveExpiredPlaylistItems()
diff --git a/osu.Game/Screens/OnlinePlay/Components/RoomManager.cs b/osu.Game/Screens/OnlinePlay/Components/RoomManager.cs
index 381849189d..97377278a6 100644
--- a/osu.Game/Screens/OnlinePlay/Components/RoomManager.cs
+++ b/osu.Game/Screens/OnlinePlay/Components/RoomManager.cs
@@ -116,8 +116,6 @@ namespace osu.Game.Screens.OnlinePlay.Components
             if (ignoredRooms.Contains(room.RoomID.Value.Value))
                 return;
 
-            room.Position.Value = -room.RoomID.Value.Value;
-
             try
             {
                 foreach (var pi in room.Playlist)
diff --git a/osu.Game/Screens/OnlinePlay/Lounge/Components/RoomsContainer.cs b/osu.Game/Screens/OnlinePlay/Lounge/Components/RoomsContainer.cs
index 907b7e308a..85efdcef1a 100644
--- a/osu.Game/Screens/OnlinePlay/Lounge/Components/RoomsContainer.cs
+++ b/osu.Game/Screens/OnlinePlay/Lounge/Components/RoomsContainer.cs
@@ -129,7 +129,7 @@ namespace osu.Game.Screens.OnlinePlay.Lounge.Components
         private void updateSorting()
         {
             foreach (var room in roomFlow)
-                roomFlow.SetLayoutPosition(room, room.Room.Position.Value);
+                roomFlow.SetLayoutPosition(room, -(room.Room.RoomID.Value ?? 0));
         }
 
         protected override bool OnClick(ClickEvent e)

From 47b6fb05f7cf0064f3cf900a048d142e4d4287da Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 14 Oct 2021 00:12:38 +0900
Subject: [PATCH 0198/5547] Add missing github sponsors funding spec

---
 .github/FUNDING.yml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.github/FUNDING.yml b/.github/FUNDING.yml
index 0c6b80e97e..fc61573416 100644
--- a/.github/FUNDING.yml
+++ b/.github/FUNDING.yml
@@ -1 +1,2 @@
+github: ppy
 custom: https://osu.ppy.sh/home/support

From 200149c9d7203084a08d77303b8091a3634aea8d Mon Sep 17 00:00:00 2001
From: Xexxar <xexxar.xexxar@gmail.com>
Date: Wed, 13 Oct 2021 15:41:24 +0000
Subject: [PATCH 0199/5547] updated to newly refactored aim

---
 .../Preprocessing/OsuDifficultyHitObject.cs   | 33 +++++--
 .../Difficulty/Skills/Aim.cs                  | 98 ++++++++-----------
 osu.Game.Rulesets.Osu/Objects/Slider.cs       |  6 ++
 3 files changed, 73 insertions(+), 64 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
index b9ba6364af..89ba73ba51 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
@@ -22,11 +22,11 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
         public double JumpDistance { get; private set; }
 
         /// <summary>
-        /// Normalized Vector from the end position of the previous <see cref="OsuDifficultyHitObject"/> to the start position of this <see cref="OsuDifficultyHitObject"/>.
+        /// Minimum distance from the end position of the previous <see cref="OsuDifficultyHitObject"/> to the start position of this <see cref="OsuDifficultyHitObject"/>.
         /// </summary>
-        public Vector2 JumpVector { get; private set; }
+        public double MovementDistance { get; private set; }
 
-        /// <summary>
+        /// <summary>JumpTravel
         /// Normalized distance between the start and end position of the previous <see cref="OsuDifficultyHitObject"/>.
         /// </summary>
         public double TravelDistance { get; private set; }
@@ -37,6 +37,16 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
         /// </summary>
         public double? Angle { get; private set; }
 
+        /// <summary>
+        /// Milliseconds elapsed since the end time of the Previous <see cref="OsuDifficultyHitObject"/>, with a minimum of 25ms.
+        /// </summary>
+        public double MovementTime { get; private set; }
+
+        /// <summary>
+        /// Milliseconds elapsed since from the start time of the Previous <see cref="OsuDifficultyHitObject"/> to the end time of the same Previous <see cref="OsuDifficultyHitObject"/>, with a minimum of 25ms.
+        /// </summary>
+        public double TravelTime { get; private set; }
+
         /// <summary>
         /// Milliseconds elapsed since the start time of the previous <see cref="OsuDifficultyHitObject"/>, with a minimum of 25ms.
         /// </summary>
@@ -51,13 +61,13 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
             this.lastLastObject = (OsuHitObject)lastLastObject;
             this.lastObject = (OsuHitObject)lastObject;
 
-            setDistances();
-
             // Capped to 25ms to prevent difficulty calculation breaking from simulatenous objects.
             StrainTime = Math.Max(DeltaTime, 25);
+
+            setDistances(clockRate);
         }
 
-        private void setDistances()
+        private void setDistances(double clockRate)
         {
             // We will scale distances by this factor, so we can assume a uniform CircleSize among beatmaps.
             float scalingFactor = normalized_radius / (float)BaseObject.Radius;
@@ -72,6 +82,9 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
             {
                 computeSliderCursorPosition(lastSlider);
                 TravelDistance = lastSlider.LazyTravelDistance * scalingFactor;
+                TravelTime = Math.Max(lastSlider.LazyTravelTime / clockRate, 0);
+                MovementTime = Math.Max(StrainTime - TravelTime, 0);
+                MovementDistance = Math.Max(0, Vector2.Subtract(lastSlider.TailCircle.StackedPosition, BaseObject.StackedPosition).Length - 0) * scalingFactor;
             }
 
             Vector2 lastCursorPosition = getEndCursorPosition(lastObject);
@@ -79,8 +92,8 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
             // Don't need to jump to reach spinners
             if (!(BaseObject is Spinner))
             {
-                JumpVector = (BaseObject.StackedPosition * scalingFactor - lastCursorPosition * scalingFactor);
-                JumpDistance = JumpVector.Length;
+                JumpDistance = (BaseObject.StackedPosition * scalingFactor - lastCursorPosition * scalingFactor).Length;
+                MovementDistance = Math.Min(JumpDistance, MovementDistance);
             }
 
             if (lastLastObject != null)
@@ -104,7 +117,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
 
             slider.LazyEndPosition = slider.StackedPosition;
 
-            float approxFollowCircleRadius = (float)(slider.Radius * 3);
+            float approxFollowCircleRadius = (float)(slider.Radius * 2.4);
             var computeVertex = new Action<double>(t =>
             {
                 double progress = (t - slider.StartTime) / slider.SpanDuration;
@@ -117,6 +130,8 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
                 var diff = slider.StackedPosition + slider.Path.PositionAt(progress) - slider.LazyEndPosition.Value;
                 float dist = diff.Length;
 
+                slider.LazyTravelTime = t - slider.StartTime;
+
                 if (dist > approxFollowCircleRadius)
                 {
                     // The cursor would be outside the follow circle, we need to move it
diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
index 0101dcaee2..e162b25f10 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
@@ -7,7 +7,6 @@ using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Osu.Difficulty.Preprocessing;
 using osu.Game.Rulesets.Osu.Objects;
 using osu.Framework.Utils;
-using osuTK;
 
 namespace osu.Game.Rulesets.Osu.Difficulty.Skills
 {
@@ -23,13 +22,12 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
 
         protected override int HistoryLength => 2;
 
-        private const double wide_angle_multiplier = 1.0;
-        private const double acute_angle_multiplier = 1.0;
-        private const double rhythm_variance_multiplier = 1.0;
+        private const double wide_angle_multiplier = 1.5;
+        private const double acute_angle_multiplier = 2.0;
 
         private double currentStrain = 1;
 
-        private double skillMultiplier => 26.25;
+        private double skillMultiplier => 23.25;
         private double strainDecayBase => 0.15;
 
         private double strainValueOf(DifficultyHitObject current)
@@ -41,75 +39,65 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
             var osuPrevObj = (OsuDifficultyHitObject)Previous[0];
             var osuLastObj = (OsuDifficultyHitObject)Previous[1];
 
-            var currVector = Vector2.Divide(osuCurrObj.JumpVector, (float)osuCurrObj.StrainTime);
-            var prevVector = Vector2.Divide(osuPrevObj.JumpVector, (float)osuPrevObj.StrainTime);
+            double currVelocity = osuCurrObj.JumpDistance / osuCurrObj.StrainTime; // Start iwth the base distance / time
 
-            // Start with regular velocity.
-            double aimStrain = currVector.Length;
-
-            if (Precision.AlmostEquals(osuCurrObj.StrainTime, osuPrevObj.StrainTime, 10)) // Rhythms are the same.
+            if (osuPrevObj.BaseObject is Slider) // If object is a slider
             {
-                if (osuCurrObj.Angle != null)
+                double movementVelocity = osuCurrObj.MovementDistance / osuCurrObj.MovementTime; // calculate the movement velocity from slider end to next note
+                double travelVelocity = osuCurrObj.TravelDistance / osuCurrObj.TravelTime; // calculate the slider velocity from slider head to lazy end.
+
+                currVelocity = Math.Max(currVelocity, movementVelocity + travelVelocity); // take the larger total combined velocity.
+            }
+
+            double prevVelocity = osuPrevObj.JumpDistance / osuPrevObj.StrainTime; // do the same for the previous velocity.
+
+            if (osuLastObj.BaseObject is Slider)
+            {
+                double movementVelocity = osuPrevObj.MovementDistance / osuPrevObj.MovementTime;
+                double travelVelocity = osuPrevObj.TravelDistance / osuPrevObj.TravelTime;
+
+                prevVelocity = Math.Max(prevVelocity, movementVelocity + travelVelocity);
+            }
+
+            double angleBonus = 0;
+
+            double aimStrain = currVelocity; // Start strain with regular velocity.
+
+            if (Precision.AlmostEquals(osuCurrObj.StrainTime, osuPrevObj.StrainTime, 10)) // If rhythms are the same.
+            {
+                if (osuCurrObj.Angle != null && osuPrevObj.Angle != null)
                 {
-                    double angle = osuCurrObj.Angle.Value;
+                    double currAngle = osuCurrObj.Angle.Value;
+                    double prevAngle = osuPrevObj.Angle.Value;
 
                     // Rewarding angles, take the smaller velocity as base.
-                    double angleBonus = Math.Min(currVector.Length, prevVector.Length);
+                    angleBonus = Math.Min(currVelocity, prevVelocity);
 
-                    double wideAngleBonus = calcWideAngleBonus(angle);
-                    double acuteAngleBonus = calcAcuteAngleBonus(angle);
+                    double wideAngleBonus = calcWideAngleBonus(currAngle);
+                    double acuteAngleBonus = calcAcuteAngleBonus(currAngle);
 
-                    if (osuCurrObj.StrainTime > 100)
+                    if (osuCurrObj.StrainTime > 100) // Only buff deltaTime exceeding 300 bpm 1/2.
                         acuteAngleBonus = 0;
                     else
-                    {
-                        acuteAngleBonus *= Math.Min(2, Math.Pow((100 - osuCurrObj.StrainTime) / 15, 1.5));
-                        wideAngleBonus *= Math.Pow(osuCurrObj.StrainTime / 100, 6);
-                    }
+                        acuteAngleBonus *= calcAcuteAngleBonus(prevAngle) // Multiply by previous angle, we don't want to buff unless this is a wiggle type pattern.
+                                            * Math.Min(angleBonus, 125 / osuCurrObj.StrainTime) // The maximum velocity we buff is equal to 125 / strainTime
+                                            * Math.Pow(Math.Sin(Math.PI / 2 * Math.Min(1, (100 - osuCurrObj.StrainTime) / 25)), 2) // scale buff from 150 bpm 1/4 to 200 bpm 1/4
+                                            * Math.Pow(Math.Sin(Math.PI / 2 * (Math.Min(100, osuCurrObj.JumpDistance) - 50) / 50), 2); // Buff distance exceeding 50 (radius) up to 100 (diameter).
 
-                    if (acuteAngleBonus > wideAngleBonus)
-                        angleBonus = Math.Min(angleBonus, 150 / osuCurrObj.StrainTime) * Math.Min(1, Math.Pow(Math.Min(osuCurrObj.JumpDistance, osuPrevObj.JumpDistance) / 150, 2));
+                    wideAngleBonus *= angleBonus * (1 - Math.Pow(calcWideAngleBonus(prevAngle), 3)); // Penalize wide angles if they're repeated, reducing the penalty as the prevAngle gets more acute.
 
-                    angleBonus *= Math.Max(acuteAngleBonus * acute_angle_multiplier, wideAngleBonus * wide_angle_multiplier);
-
-                    // add in angle velocity.
-                    aimStrain += angleBonus;
+                    angleBonus = acuteAngleBonus * acute_angle_multiplier + wideAngleBonus * wide_angle_multiplier; // add the anglebuffs together.
                 }
             }
-            else // There is a rhythm change
-            {
-                // Rewarding rhythm, take the smaller velocity as base.
-                double rhythmBonus = Math.Min(currVector.Length, prevVector.Length);
 
-                if (osuCurrObj.StrainTime + 10 < osuPrevObj.StrainTime && osuPrevObj.StrainTime > osuLastObj.StrainTime + 10)
-                    // Don't want to reward for a rhythm change back to back (unless its a double, which is why this only checks for fast -> slow -> fast).
-                    rhythmBonus = 0;
-
-                aimStrain += rhythmBonus * rhythm_variance_multiplier; // add in rhythm velocity.
-            }
+            aimStrain += angleBonus; // Add in angle bonus.
 
             return aimStrain;
         }
 
-        private double calcWideAngleBonus(double angle)
-        {
-            if (angle < Math.PI / 3)
-                return 0;
-            if (angle < 2 * Math.PI / 3)
-                return Math.Pow(Math.Sin(1.5 * (angle - Math.PI / 3)), 2);
+        private double calcWideAngleBonus(double angle) => Math.Pow(Math.Sin(3.0 / 4 * (Math.Min(5.0 / 6 * Math.PI, Math.Max(Math.PI / 6, angle)) - Math.PI / 6)), 2);
 
-            return 0.25 + 0.75 * Math.Pow(Math.Sin(1.5 * (Math.PI - angle)), 2);
-        }
-
-        private double calcAcuteAngleBonus(double angle)
-        {
-            if (angle < Math.PI / 3)
-                return 0.5 + 0.5 * Math.Pow(Math.Sin(1.5 * angle), 2);
-            if (angle < 2 * Math.PI / 3)
-                return Math.Pow(Math.Sin(1.5 * (2 * Math.PI / 3 - angle)), 2);
-
-            return 0;
-        }
+        private double calcAcuteAngleBonus(double angle) => 1 - calcWideAngleBonus(angle);
 
         private double applyDiminishingExp(double val) => Math.Pow(val, 0.99);
 
diff --git a/osu.Game.Rulesets.Osu/Objects/Slider.cs b/osu.Game.Rulesets.Osu/Objects/Slider.cs
index 1d2666f46b..1d494c2917 100644
--- a/osu.Game.Rulesets.Osu/Objects/Slider.cs
+++ b/osu.Game.Rulesets.Osu/Objects/Slider.cs
@@ -79,6 +79,12 @@ namespace osu.Game.Rulesets.Osu.Objects
         /// </summary>
         internal float LazyTravelDistance;
 
+        /// <summary>
+        /// The time taken by the cursor upon completion of this <see cref="Slider"/> if it was hit
+        /// with as few movements as possible. This is set and used by difficulty calculation.
+        /// </summary>
+        internal double LazyTravelTime;
+
         public List<IList<HitSampleInfo>> NodeSamples { get; set; } = new List<IList<HitSampleInfo>>();
 
         [JsonIgnore]

From 0f248d55107e574876d139b2d030f98575f62704 Mon Sep 17 00:00:00 2001
From: Xexxar <xexxar.xexxar@gmail.com>
Date: Wed, 13 Oct 2021 15:45:42 +0000
Subject: [PATCH 0200/5547] removed the merge conflict markers

---
 .../OsuDifficultyCalculatorTest.cs                     | 10 ----------
 1 file changed, 10 deletions(-)

diff --git a/osu.Game.Rulesets.Osu.Tests/OsuDifficultyCalculatorTest.cs b/osu.Game.Rulesets.Osu.Tests/OsuDifficultyCalculatorTest.cs
index 1096e9a777..15675e74d1 100644
--- a/osu.Game.Rulesets.Osu.Tests/OsuDifficultyCalculatorTest.cs
+++ b/osu.Game.Rulesets.Osu.Tests/OsuDifficultyCalculatorTest.cs
@@ -15,15 +15,6 @@ namespace osu.Game.Rulesets.Osu.Tests
     {
         protected override string ResourceAssembly => "osu.Game.Rulesets.Osu";
 
-<<<<<<< HEAD
-        [TestCase(6.4766744062777439d, "diffcalc-test")]
-        [TestCase(0.63190213974653298d, "zero-length-sliders")]
-        public void Test(double expected, string name)
-            => base.Test(expected, name);
-
-        [TestCase(8.9926029916156764d, "diffcalc-test")]
-        [TestCase(0.78116445583636385d, "zero-length-sliders")]
-=======
         [TestCase(6.5867229481955389d, "diffcalc-test")]
         [TestCase(1.0416315570967911d, "zero-length-sliders")]
         public void Test(double expected, string name)
@@ -31,7 +22,6 @@ namespace osu.Game.Rulesets.Osu.Tests
 
         [TestCase(8.2730989071947896d, "diffcalc-test")]
         [TestCase(1.2726413186221039d, "zero-length-sliders")]
->>>>>>> ppy/master
         public void TestClockRateAdjusted(double expected, string name)
             => Test(expected, name, new OsuModDoubleTime());
 

From 0292fe1c834ebf68f22f85832a776b6740030865 Mon Sep 17 00:00:00 2001
From: Xexxar <xexxar.xexxar@gmail.com>
Date: Wed, 13 Oct 2021 16:04:39 +0000
Subject: [PATCH 0201/5547] removed residual code leftover

---
 .../Difficulty/Preprocessing/OsuDifficultyHitObject.cs          | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
index 89ba73ba51..c2a4dc741f 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
@@ -84,7 +84,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
                 TravelDistance = lastSlider.LazyTravelDistance * scalingFactor;
                 TravelTime = Math.Max(lastSlider.LazyTravelTime / clockRate, 0);
                 MovementTime = Math.Max(StrainTime - TravelTime, 0);
-                MovementDistance = Math.Max(0, Vector2.Subtract(lastSlider.TailCircle.StackedPosition, BaseObject.StackedPosition).Length - 0) * scalingFactor;
+                MovementDistance = Vector2.Subtract(lastSlider.TailCircle.StackedPosition, BaseObject.StackedPosition).Length * scalingFactor;
             }
 
             Vector2 lastCursorPosition = getEndCursorPosition(lastObject);

From cde4b0b17c198aa4e31ae574f34679413a974885 Mon Sep 17 00:00:00 2001
From: Xexxar <xexxar.xexxar@gmail.com>
Date: Wed, 13 Oct 2021 16:25:16 +0000
Subject: [PATCH 0202/5547] forgot to add double delcaration, remember to test

---
 osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
index 90b2f63034..37b5863ba7 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
@@ -61,6 +61,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
             }
 
             double angleBonus = 0;
+            double sliderBonus = 0;
 
             double aimStrain = currVelocity; // Start strain with regular velocity.
 

From 4edf559408e2cfe48bcc805d61cf914d032bf839 Mon Sep 17 00:00:00 2001
From: Xexxar <xexxar.xexxar@gmail.com>
Date: Wed, 13 Oct 2021 16:45:58 +0000
Subject: [PATCH 0203/5547] adjusted constant to 1.5 from 2.0 for acute

---
 osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
index e162b25f10..3d27e13bc1 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
@@ -23,7 +23,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
         protected override int HistoryLength => 2;
 
         private const double wide_angle_multiplier = 1.5;
-        private const double acute_angle_multiplier = 2.0;
+        private const double acute_angle_multiplier = 1.5;
 
         private double currentStrain = 1;
 

From 205d95e8c62ce26cf6c6ebe63c01edb7e9b9b9f9 Mon Sep 17 00:00:00 2001
From: StanR <hi@stanr.info>
Date: Wed, 13 Oct 2021 20:04:34 +0300
Subject: [PATCH 0204/5547] Approximate amount of effective misses using combo

---
 .../Difficulty/OsuDifficultyAttributes.cs     |  1 +
 .../Difficulty/OsuDifficultyCalculator.cs     |  2 +
 .../Difficulty/OsuPerformanceCalculator.cs    | 38 ++++++++++++++-----
 3 files changed, 32 insertions(+), 9 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyAttributes.cs b/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyAttributes.cs
index bd4c0f2ad5..a08fe3b7c5 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyAttributes.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyAttributes.cs
@@ -14,6 +14,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty
         public double OverallDifficulty { get; set; }
         public double DrainRate { get; set; }
         public int HitCircleCount { get; set; }
+        public int SliderCount { get; set; }
         public int SpinnerCount { get; set; }
     }
 }
diff --git a/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs b/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs
index 790aa0eb7d..b0a764dc4d 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs
@@ -64,6 +64,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty
             maxCombo += beatmap.HitObjects.OfType<Slider>().Sum(s => s.NestedHitObjects.Count - 1);
 
             int hitCirclesCount = beatmap.HitObjects.Count(h => h is HitCircle);
+            int sliderCount = beatmap.HitObjects.Count(h => h is Slider);
             int spinnerCount = beatmap.HitObjects.Count(h => h is Spinner);
 
             return new OsuDifficultyAttributes
@@ -78,6 +79,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty
                 DrainRate = drainRate,
                 MaxCombo = maxCombo,
                 HitCircleCount = hitCirclesCount,
+                SliderCount = sliderCount,
                 SpinnerCount = spinnerCount,
                 Skills = skills
             };
diff --git a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
index 4e4dbc02a1..d0b5e877b5 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
@@ -25,6 +25,8 @@ namespace osu.Game.Rulesets.Osu.Difficulty
         private int countMeh;
         private int countMiss;
 
+        private int effectiveMissCount;
+
         public OsuPerformanceCalculator(Ruleset ruleset, DifficultyAttributes attributes, ScoreInfo score)
             : base(ruleset, attributes, score)
         {
@@ -39,19 +41,20 @@ namespace osu.Game.Rulesets.Osu.Difficulty
             countOk = Score.Statistics.GetValueOrDefault(HitResult.Ok);
             countMeh = Score.Statistics.GetValueOrDefault(HitResult.Meh);
             countMiss = Score.Statistics.GetValueOrDefault(HitResult.Miss);
+            effectiveMissCount = calculateEffectiveMissCount();
 
             double multiplier = 1.12; // This is being adjusted to keep the final pp value scaled around what it used to be when changing things.
 
             // Custom multipliers for NoFail and SpunOut.
             if (mods.Any(m => m is OsuModNoFail))
-                multiplier *= Math.Max(0.90, 1.0 - 0.02 * countMiss);
+                multiplier *= Math.Max(0.90, 1.0 - 0.02 * effectiveMissCount);
 
             if (mods.Any(m => m is OsuModSpunOut))
                 multiplier *= 1.0 - Math.Pow((double)Attributes.SpinnerCount / totalHits, 0.85);
 
             if (mods.Any(h => h is OsuModRelax))
             {
-                countMiss += countOk + countMeh;
+                effectiveMissCount += countOk + countMeh;
                 multiplier *= 0.6;
             }
 
@@ -97,8 +100,8 @@ namespace osu.Game.Rulesets.Osu.Difficulty
             aimValue *= lengthBonus;
 
             // Penalize misses by assessing # of misses relative to the total # of objects. Default a 3% reduction for any # of misses.
-            if (countMiss > 0)
-                aimValue *= 0.97 * Math.Pow(1 - Math.Pow((double)countMiss / totalHits, 0.775), countMiss);
+            if (effectiveMissCount > 0)
+                aimValue *= 0.97 * Math.Pow(1 - Math.Pow((double)effectiveMissCount / totalHits, 0.775), effectiveMissCount);
 
             // Combo scaling.
             if (Attributes.MaxCombo > 0)
@@ -115,7 +118,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty
             double approachRateBonus = 1.0 + (0.03 + 0.37 * approachRateTotalHitsFactor) * approachRateFactor;
 
             if (mods.Any(m => m is OsuModBlinds))
-                aimValue *= 1.3 + (totalHits * (0.0016 / (1 + 2 * countMiss)) * Math.Pow(accuracy, 16)) * (1 - 0.003 * Attributes.DrainRate * Attributes.DrainRate);
+                aimValue *= 1.3 + (totalHits * (0.0016 / (1 + 2 * effectiveMissCount)) * Math.Pow(accuracy, 16)) * (1 - 0.003 * Attributes.DrainRate * Attributes.DrainRate);
             else if (mods.Any(h => h is OsuModHidden))
             {
                 // We want to give more reward for lower AR when it comes to aim and HD. This nerfs high AR and buffs lower AR.
@@ -142,8 +145,8 @@ namespace osu.Game.Rulesets.Osu.Difficulty
             speedValue *= lengthBonus;
 
             // Penalize misses by assessing # of misses relative to the total # of objects. Default a 3% reduction for any # of misses.
-            if (countMiss > 0)
-                speedValue *= 0.97 * Math.Pow(1 - Math.Pow((double)countMiss / totalHits, 0.775), Math.Pow(countMiss, .875));
+            if (effectiveMissCount > 0)
+                speedValue *= 0.97 * Math.Pow(1 - Math.Pow((double)effectiveMissCount / totalHits, 0.775), Math.Pow(effectiveMissCount, .875));
 
             // Combo scaling.
             if (Attributes.MaxCombo > 0)
@@ -231,8 +234,8 @@ namespace osu.Game.Rulesets.Osu.Difficulty
                 flashlightValue *= 1.3;
 
             // Penalize misses by assessing # of misses relative to the total # of objects. Default a 3% reduction for any # of misses.
-            if (countMiss > 0)
-                flashlightValue *= 0.97 * Math.Pow(1 - Math.Pow((double)countMiss / totalHits, 0.775), Math.Pow(countMiss, .875));
+            if (effectiveMissCount > 0)
+                flashlightValue *= 0.97 * Math.Pow(1 - Math.Pow((double)effectiveMissCount / totalHits, 0.775), Math.Pow(effectiveMissCount, .875));
 
             // Combo scaling.
             if (Attributes.MaxCombo > 0)
@@ -250,6 +253,23 @@ namespace osu.Game.Rulesets.Osu.Difficulty
             return flashlightValue;
         }
 
+        private int calculateEffectiveMissCount()
+        {
+            // guess the number of misses + slider breaks from combo
+            double comboBasedMissCount = 0.0;
+
+            if (Attributes.SliderCount > 0)
+            {
+                double fullComboThreshold = Attributes.MaxCombo - 0.1 * Attributes.SliderCount;
+                if (scoreMaxCombo < fullComboThreshold)
+                    comboBasedMissCount = fullComboThreshold / scoreMaxCombo;
+                else
+                    comboBasedMissCount = Math.Pow((Attributes.MaxCombo - scoreMaxCombo) / (0.1 * Attributes.SliderCount), 3);
+            }
+
+            return Math.Max(countMiss, (int)Math.Floor(comboBasedMissCount));
+        }
+
         private int totalHits => countGreat + countOk + countMeh + countMiss;
         private int totalSuccessfulHits => countGreat + countOk + countMeh;
     }

From d205483a36fcb6f4b77f524163d6f19263ec3b27 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 13 Oct 2021 21:57:34 +0200
Subject: [PATCH 0205/5547] Revert `ThemedDropdown`-related changes

---
 .../Graphics/Containers/OsuScrollContainer.cs | 67 +++----------------
 .../UserInterfaceV2/ThemedDropdown.cs         | 54 ---------------
 .../UserInterfaceV2/ThemedEnumDropdown.cs     | 16 -----
 .../Overlays/Settings/SettingsDropdown.cs     |  3 +-
 .../Overlays/Settings/SettingsEnumDropdown.cs |  3 +-
 5 files changed, 11 insertions(+), 132 deletions(-)
 delete mode 100644 osu.Game/Graphics/UserInterfaceV2/ThemedDropdown.cs
 delete mode 100644 osu.Game/Graphics/UserInterfaceV2/ThemedEnumDropdown.cs

diff --git a/osu.Game/Graphics/Containers/OsuScrollContainer.cs b/osu.Game/Graphics/Containers/OsuScrollContainer.cs
index f78f9deac1..aaad72f65c 100644
--- a/osu.Game/Graphics/Containers/OsuScrollContainer.cs
+++ b/osu.Game/Graphics/Containers/OsuScrollContainer.cs
@@ -24,26 +24,11 @@ namespace osu.Game.Graphics.Containers
         }
     }
 
-    public class OsuScrollContainer<T> : ScrollContainer<T>, IHasAccentColour
-        where T : Drawable
+    public class OsuScrollContainer<T> : ScrollContainer<T> where T : Drawable
     {
         public const float SCROLL_BAR_HEIGHT = 10;
         public const float SCROLL_BAR_PADDING = 3;
 
-        private Color4 accentColour;
-
-        public Color4 AccentColour
-        {
-            get => accentColour;
-            set
-            {
-                accentColour = value;
-
-                if (Scrollbar is IHasAccentColour accentedScrollbar)
-                    accentedScrollbar.AccentColour = value;
-            }
-        }
-
         /// <summary>
         /// Allows controlling the scroll bar from any position in the container using the right mouse button.
         /// Uses the value of <see cref="DistanceDecayOnRightMouseScrollbar"/> to smoothly scroll to the dragged location.
@@ -124,27 +109,11 @@ namespace osu.Game.Graphics.Containers
 
         protected override ScrollbarContainer CreateScrollbar(Direction direction) => new OsuScrollbar(direction);
 
-        protected class OsuScrollbar : ScrollbarContainer, IHasAccentColour
+        protected class OsuScrollbar : ScrollbarContainer
         {
-            private Color4 accentColour;
-
-            public Color4 AccentColour
-            {
-                get => accentColour;
-                set
-                {
-                    accentColour = value;
-
-                    if (IsLoaded)
-                        updateMouseDownState();
-                }
-            }
-
             private Color4 hoverColour;
             private Color4 defaultColour;
-
-            private bool mouseDown;
-            private const int fade_duration = 100;
+            private Color4 highlightColour;
 
             private readonly Box box;
 
@@ -177,15 +146,7 @@ namespace osu.Game.Graphics.Containers
             {
                 Colour = defaultColour = colours.Gray8;
                 hoverColour = colours.GrayF;
-                AccentColour = colours.Green;
-            }
-
-            protected override void LoadComplete()
-            {
-                base.LoadComplete();
-
-                updateHoverState();
-                updateMouseDownState();
+                highlightColour = colours.Green;
             }
 
             public override void ResizeTo(float val, int duration = 0, Easing easing = Easing.None)
@@ -199,24 +160,21 @@ namespace osu.Game.Graphics.Containers
 
             protected override bool OnHover(HoverEvent e)
             {
-                updateHoverState(fade_duration);
+                this.FadeColour(hoverColour, 100);
                 return true;
             }
 
             protected override void OnHoverLost(HoverLostEvent e)
             {
-                updateHoverState(fade_duration);
+                this.FadeColour(defaultColour, 100);
             }
 
-            private void updateHoverState(double duration = 0) => this.FadeColour(IsHovered ? hoverColour : defaultColour, duration);
-
             protected override bool OnMouseDown(MouseDownEvent e)
             {
                 if (!base.OnMouseDown(e)) return false;
 
-                mouseDown = true;
-                updateMouseDownState(fade_duration);
-
+                // note that we are changing the colour of the box here as to not interfere with the hover effect.
+                box.FadeColour(highlightColour, 100);
                 return true;
             }
 
@@ -224,17 +182,10 @@ namespace osu.Game.Graphics.Containers
             {
                 if (e.Button != MouseButton.Left) return;
 
-                mouseDown = false;
-                updateMouseDownState(fade_duration);
+                box.FadeColour(Color4.White, 100);
 
                 base.OnMouseUp(e);
             }
-
-            private void updateMouseDownState(double duration = 0)
-            {
-                // note that we are changing the colour of the box here as to not interfere with the hover effect.
-                box.FadeColour(mouseDown ? AccentColour : Color4.White, duration);
-            }
         }
     }
 }
diff --git a/osu.Game/Graphics/UserInterfaceV2/ThemedDropdown.cs b/osu.Game/Graphics/UserInterfaceV2/ThemedDropdown.cs
deleted file mode 100644
index ec96c23034..0000000000
--- a/osu.Game/Graphics/UserInterfaceV2/ThemedDropdown.cs
+++ /dev/null
@@ -1,54 +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 enable
-
-using osu.Framework.Allocation;
-using osu.Framework.Graphics.UserInterface;
-using osu.Game.Graphics.UserInterface;
-using osu.Game.Overlays;
-
-namespace osu.Game.Graphics.UserInterfaceV2
-{
-    /// <summary>
-    /// A variant of <see cref="OsuDropdown{T}"/> that uses the nearest <see cref="OverlayColourProvider"/> for theming purposes, if one is available.
-    /// </summary>
-    public class ThemedDropdown<T> : OsuDropdown<T>
-    {
-        [BackgroundDependencyLoader(true)]
-        private void load(OverlayColourProvider? colourProvider)
-        {
-            if (colourProvider == null) return;
-
-            AccentColour = colourProvider.Light4;
-        }
-
-        protected override DropdownHeader CreateHeader() => new ThemedDropdownHeader();
-
-        protected override DropdownMenu CreateMenu() => new ThemedDropdownMenu();
-
-        protected class ThemedDropdownMenu : OsuDropdownMenu
-        {
-            [BackgroundDependencyLoader(true)]
-            private void load(OverlayColourProvider? colourProvider)
-            {
-                if (colourProvider == null) return;
-
-                BackgroundColour = colourProvider.Background5;
-                ((IHasAccentColour)ContentContainer).AccentColour = colourProvider.Highlight1;
-            }
-        }
-
-        protected class ThemedDropdownHeader : OsuDropdownHeader
-        {
-            [BackgroundDependencyLoader(true)]
-            private void load(OverlayColourProvider? colourProvider)
-            {
-                if (colourProvider == null) return;
-
-                BackgroundColour = colourProvider.Background5;
-                BackgroundColourHover = colourProvider.Light4;
-            }
-        }
-    }
-}
diff --git a/osu.Game/Graphics/UserInterfaceV2/ThemedEnumDropdown.cs b/osu.Game/Graphics/UserInterfaceV2/ThemedEnumDropdown.cs
deleted file mode 100644
index 5210c03bb9..0000000000
--- a/osu.Game/Graphics/UserInterfaceV2/ThemedEnumDropdown.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.Graphics.UserInterfaceV2
-{
-    public class ThemedEnumDropdown<T> : ThemedDropdown<T>
-        where T : struct, Enum
-    {
-        public ThemedEnumDropdown()
-        {
-            Items = (T[])Enum.GetValues(typeof(T));
-        }
-    }
-}
diff --git a/osu.Game/Overlays/Settings/SettingsDropdown.cs b/osu.Game/Overlays/Settings/SettingsDropdown.cs
index c48a4f5ccc..a281d03ee7 100644
--- a/osu.Game/Overlays/Settings/SettingsDropdown.cs
+++ b/osu.Game/Overlays/Settings/SettingsDropdown.cs
@@ -6,7 +6,6 @@ using System.Linq;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Game.Graphics.UserInterface;
-using osu.Game.Graphics.UserInterfaceV2;
 using osuTK;
 
 namespace osu.Game.Overlays.Settings
@@ -38,7 +37,7 @@ namespace osu.Game.Overlays.Settings
 
         protected virtual OsuDropdown<T> CreateDropdown() => new DropdownControl();
 
-        protected class DropdownControl : ThemedDropdown<T>
+        protected class DropdownControl : OsuDropdown<T>
         {
             public DropdownControl()
             {
diff --git a/osu.Game/Overlays/Settings/SettingsEnumDropdown.cs b/osu.Game/Overlays/Settings/SettingsEnumDropdown.cs
index b901e8d719..199ba14b48 100644
--- a/osu.Game/Overlays/Settings/SettingsEnumDropdown.cs
+++ b/osu.Game/Overlays/Settings/SettingsEnumDropdown.cs
@@ -4,7 +4,6 @@
 using System;
 using osu.Framework.Graphics;
 using osu.Game.Graphics.UserInterface;
-using osu.Game.Graphics.UserInterfaceV2;
 
 namespace osu.Game.Overlays.Settings
 {
@@ -13,7 +12,7 @@ namespace osu.Game.Overlays.Settings
     {
         protected override OsuDropdown<T> CreateDropdown() => new DropdownControl();
 
-        protected new class DropdownControl : ThemedEnumDropdown<T>
+        protected new class DropdownControl : OsuEnumDropdown<T>
         {
             public DropdownControl()
             {

From d4e3460912a4784ca2fd56be630d32384a0fd8b3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 13 Oct 2021 22:03:08 +0200
Subject: [PATCH 0206/5547] Always use `OverlayColourProvider` in dropdowns if
 available

---
 .../Graphics/UserInterface/OsuDropdown.cs     | 28 +++++++++++--------
 1 file changed, 16 insertions(+), 12 deletions(-)

diff --git a/osu.Game/Graphics/UserInterface/OsuDropdown.cs b/osu.Game/Graphics/UserInterface/OsuDropdown.cs
index d7d43f9fba..2e4fd78e09 100644
--- a/osu.Game/Graphics/UserInterface/OsuDropdown.cs
+++ b/osu.Game/Graphics/UserInterface/OsuDropdown.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.
 
+#nullable enable
+
 using System.Linq;
 using osuTK.Graphics;
 using osu.Framework.Allocation;
@@ -14,6 +16,7 @@ using osu.Framework.Graphics.UserInterface;
 using osu.Framework.Localisation;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
+using osu.Game.Overlays;
 using osuTK;
 
 namespace osu.Game.Graphics.UserInterface
@@ -34,11 +37,11 @@ namespace osu.Game.Graphics.UserInterface
             }
         }
 
-        [BackgroundDependencyLoader]
-        private void load(OsuColour colours)
+        [BackgroundDependencyLoader(true)]
+        private void load(OverlayColourProvider? colourProvider, OsuColour colours)
         {
             if (accentColour == default)
-                accentColour = colours.PinkDarker;
+                accentColour = colourProvider?.Light4 ?? colours.PinkDarker;
             updateAccentColour();
         }
 
@@ -59,14 +62,13 @@ namespace osu.Game.Graphics.UserInterface
         {
             public override bool HandleNonPositionalInput => State == MenuState.Open;
 
-            private Sample sampleOpen;
-            private Sample sampleClose;
+            private Sample? sampleOpen;
+            private Sample? sampleClose;
 
             // todo: this uses the same styling as OsuMenu. hopefully we can just use OsuMenu in the future with some refactoring
             public OsuDropdownMenu()
             {
                 CornerRadius = corner_radius;
-                BackgroundColour = Color4.Black.Opacity(0.5f);
 
                 MaskingContainer.CornerRadius = corner_radius;
                 Alpha = 0;
@@ -75,9 +77,11 @@ namespace osu.Game.Graphics.UserInterface
                 ItemsContainer.Padding = new MarginPadding(5);
             }
 
-            [BackgroundDependencyLoader]
-            private void load(AudioManager audio)
+            [BackgroundDependencyLoader(true)]
+            private void load(OverlayColourProvider? colourProvider, AudioManager audio)
             {
+                BackgroundColour = colourProvider?.Background5 ?? Color4.Black.Opacity(0.5f);
+
                 sampleOpen = audio.Samples.Get(@"UI/dropdown-open");
                 sampleClose = audio.Samples.Get(@"UI/dropdown-close");
             }
@@ -312,11 +316,11 @@ namespace osu.Game.Graphics.UserInterface
                 AddInternal(new HoverClickSounds());
             }
 
-            [BackgroundDependencyLoader]
-            private void load(OsuColour colours)
+            [BackgroundDependencyLoader(true)]
+            private void load(OverlayColourProvider? colourProvider, OsuColour colours)
             {
-                BackgroundColour = Color4.Black.Opacity(0.5f);
-                BackgroundColourHover = colours.PinkDarker;
+                BackgroundColour = colourProvider?.Background5 ?? Color4.Black.Opacity(0.5f);
+                BackgroundColourHover = colourProvider?.Light4 ?? colours.PinkDarker;
             }
         }
     }

From 7e7b7477551f521055b2c79cd4dd8b16d44f4877 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 13 Oct 2021 22:05:46 +0200
Subject: [PATCH 0207/5547] Always use `OverlayColourProvider` in scroll
 containers if available

---
 osu.Game/Graphics/Containers/OsuScrollContainer.cs | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Graphics/Containers/OsuScrollContainer.cs b/osu.Game/Graphics/Containers/OsuScrollContainer.cs
index aaad72f65c..017ea6ec32 100644
--- a/osu.Game/Graphics/Containers/OsuScrollContainer.cs
+++ b/osu.Game/Graphics/Containers/OsuScrollContainer.cs
@@ -1,11 +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.
 
+#nullable enable
+
 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.Game.Overlays;
 using osuTK;
 using osuTK.Graphics;
 using osuTK.Input;
@@ -141,12 +144,12 @@ namespace osu.Game.Graphics.Containers
                 Child = box = new Box { RelativeSizeAxes = Axes.Both };
             }
 
-            [BackgroundDependencyLoader]
-            private void load(OsuColour colours)
+            [BackgroundDependencyLoader(true)]
+            private void load(OverlayColourProvider? colourProvider, OsuColour colours)
             {
                 Colour = defaultColour = colours.Gray8;
                 hoverColour = colours.GrayF;
-                highlightColour = colours.Green;
+                highlightColour = colourProvider?.Highlight1 ?? colours.Green;
             }
 
             public override void ResizeTo(float val, int duration = 0, Easing easing = Easing.None)

From a6c2848460c633aa75ee3973dc6f1b316caac351 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 13 Oct 2021 22:08:23 +0200
Subject: [PATCH 0208/5547] Fix hovered dropdown item chevron not using
 `OverlayColourProvider`

---
 osu.Game/Graphics/UserInterface/OsuDropdown.cs | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Graphics/UserInterface/OsuDropdown.cs b/osu.Game/Graphics/UserInterface/OsuDropdown.cs
index 2e4fd78e09..337d5585ea 100644
--- a/osu.Game/Graphics/UserInterface/OsuDropdown.cs
+++ b/osu.Game/Graphics/UserInterface/OsuDropdown.cs
@@ -223,7 +223,6 @@ namespace osu.Game.Graphics.UserInterface
                             {
                                 AlwaysPresent = true,
                                 Icon = FontAwesome.Solid.ChevronRight,
-                                Colour = Color4.Black,
                                 Alpha = 0.5f,
                                 Size = new Vector2(8),
                                 Margin = new MarginPadding { Left = 3, Right = 3 },
@@ -237,6 +236,12 @@ namespace osu.Game.Graphics.UserInterface
                             },
                         };
                     }
+
+                    [BackgroundDependencyLoader(true)]
+                    private void load(OverlayColourProvider? colourProvider)
+                    {
+                        Chevron.Colour = colourProvider?.Background5 ?? Color4.Black;
+                    }
                 }
             }
 

From d06715943541c621e02f7b3b81b16d8008373bbf Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 13 Oct 2021 22:32:54 +0200
Subject: [PATCH 0209/5547] Recolour elements of editor setup screen to match
 dropdown theming

---
 .../Graphics/UserInterfaceV2/LabelledDrawable.cs     | 12 ++++++++----
 osu.Game/Graphics/UserInterfaceV2/SwitchButton.cs    | 11 +++++++----
 osu.Game/Screens/Edit/EditorRoundedScreen.cs         |  2 +-
 3 files changed, 16 insertions(+), 9 deletions(-)

diff --git a/osu.Game/Graphics/UserInterfaceV2/LabelledDrawable.cs b/osu.Game/Graphics/UserInterfaceV2/LabelledDrawable.cs
index 5a697623c9..d5f76733cf 100644
--- a/osu.Game/Graphics/UserInterfaceV2/LabelledDrawable.cs
+++ b/osu.Game/Graphics/UserInterfaceV2/LabelledDrawable.cs
@@ -1,12 +1,15 @@
 // 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 enable
+
 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.Game.Graphics.Containers;
+using osu.Game.Overlays;
 using osuTK;
 
 namespace osu.Game.Graphics.UserInterfaceV2
@@ -44,6 +47,7 @@ namespace osu.Game.Graphics.UserInterfaceV2
         /// </summary>
         protected readonly T Component;
 
+        private readonly Box background;
         private readonly GridContainer grid;
         private readonly OsuTextFlowContainer labelText;
         private readonly OsuTextFlowContainer descriptionText;
@@ -62,10 +66,9 @@ namespace osu.Game.Graphics.UserInterfaceV2
 
             InternalChildren = new Drawable[]
             {
-                new Box
+                background = new Box
                 {
                     RelativeSizeAxes = Axes.Both,
-                    Colour = Color4Extensions.FromHex("1c2125"),
                 },
                 new FillFlowContainer
                 {
@@ -146,9 +149,10 @@ namespace osu.Game.Graphics.UserInterfaceV2
             }
         }
 
-        [BackgroundDependencyLoader]
-        private void load(OsuColour osuColour)
+        [BackgroundDependencyLoader(true)]
+        private void load(OverlayColourProvider? colourProvider, OsuColour osuColour)
         {
+            background.Colour = colourProvider?.Background4 ?? Color4Extensions.FromHex(@"1c2125");
             descriptionText.Colour = osuColour.Yellow;
         }
 
diff --git a/osu.Game/Graphics/UserInterfaceV2/SwitchButton.cs b/osu.Game/Graphics/UserInterfaceV2/SwitchButton.cs
index a7fd25b554..deb2e6baf6 100644
--- a/osu.Game/Graphics/UserInterfaceV2/SwitchButton.cs
+++ b/osu.Game/Graphics/UserInterfaceV2/SwitchButton.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.
 
+#nullable enable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Extensions.Color4Extensions;
@@ -10,6 +12,7 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Graphics.UserInterface;
 using osu.Framework.Input.Events;
+using osu.Game.Overlays;
 using osuTK;
 using osuTK.Graphics;
 
@@ -66,11 +69,11 @@ namespace osu.Game.Graphics.UserInterfaceV2
             };
         }
 
-        [BackgroundDependencyLoader]
-        private void load(OsuColour colours)
+        [BackgroundDependencyLoader(true)]
+        private void load(OverlayColourProvider? colourProvider, OsuColour colours)
         {
-            enabledColour = colours.BlueDark;
-            disabledColour = colours.Gray3;
+            enabledColour = colourProvider?.Highlight1 ?? colours.BlueDark;
+            disabledColour = colourProvider?.Background3 ?? colours.Gray3;
 
             switchContainer.Colour = enabledColour;
             fill.Colour = disabledColour;
diff --git a/osu.Game/Screens/Edit/EditorRoundedScreen.cs b/osu.Game/Screens/Edit/EditorRoundedScreen.cs
index b271a145f5..508663224d 100644
--- a/osu.Game/Screens/Edit/EditorRoundedScreen.cs
+++ b/osu.Game/Screens/Edit/EditorRoundedScreen.cs
@@ -41,7 +41,7 @@ namespace osu.Game.Screens.Edit
                     {
                         new Box
                         {
-                            Colour = ColourProvider.Dark4,
+                            Colour = ColourProvider.Background3,
                             RelativeSizeAxes = Axes.Both,
                         },
                         roundedContent = new Container

From f3647eb94ed8d7837d9f155c2e8597f3fcf8d4e5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 13 Oct 2021 22:50:19 +0200
Subject: [PATCH 0210/5547] Recolour room settings screens to match dropdown
 theming

---
 .../Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs   | 7 +++----
 .../OnlinePlay/Playlists/PlaylistsRoomSettingsOverlay.cs   | 7 +++----
 2 files changed, 6 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs
index 80a5daa7c8..0edf5dde6d 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs
@@ -7,7 +7,6 @@ using JetBrains.Annotations;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Extensions;
-using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Extensions.ExceptionExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
@@ -99,14 +98,14 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
             }
 
             [BackgroundDependencyLoader]
-            private void load(OsuColour colours)
+            private void load(OverlayColourProvider colourProvider, OsuColour colours)
             {
                 InternalChildren = new Drawable[]
                 {
                     new Box
                     {
                         RelativeSizeAxes = Axes.Both,
-                        Colour = Color4Extensions.FromHex(@"28242d"),
+                        Colour = colourProvider.Background4
                     },
                     new GridContainer
                     {
@@ -249,7 +248,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
                                         new Box
                                         {
                                             RelativeSizeAxes = Axes.Both,
-                                            Colour = Color4Extensions.FromHex(@"28242d").Darken(0.5f).Opacity(1f),
+                                            Colour = colourProvider.Background5
                                         },
                                         new FillFlowContainer
                                         {
diff --git a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSettingsOverlay.cs b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSettingsOverlay.cs
index 7384c60888..9e000aa712 100644
--- a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSettingsOverlay.cs
+++ b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSettingsOverlay.cs
@@ -5,7 +5,6 @@ using System;
 using System.Collections.Specialized;
 using Humanizer;
 using osu.Framework.Allocation;
-using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
@@ -77,14 +76,14 @@ namespace osu.Game.Screens.OnlinePlay.Playlists
             }
 
             [BackgroundDependencyLoader]
-            private void load(OsuColour colours)
+            private void load(OverlayColourProvider colourProvider, OsuColour colours)
             {
                 InternalChildren = new Drawable[]
                 {
                     new Box
                     {
                         RelativeSizeAxes = Axes.Both,
-                        Colour = Color4Extensions.FromHex(@"28242d"),
+                        Colour = colourProvider.Background4
                     },
                     new GridContainer
                     {
@@ -256,7 +255,7 @@ namespace osu.Game.Screens.OnlinePlay.Playlists
                                         new Box
                                         {
                                             RelativeSizeAxes = Axes.Both,
-                                            Colour = Color4Extensions.FromHex(@"28242d").Darken(0.5f).Opacity(1f),
+                                            Colour = colourProvider.Background5
                                         },
                                         new FillFlowContainer
                                         {

From d8450a7375f0fba0c00ee3fa8779a8c4993d16fe Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 13 Oct 2021 22:57:37 +0200
Subject: [PATCH 0211/5547] Recolour "slim dropdown" in online lounge screens

---
 .../UserInterface/SlimEnumDropdown.cs         | 20 -------------------
 1 file changed, 20 deletions(-)

diff --git a/osu.Game/Graphics/UserInterface/SlimEnumDropdown.cs b/osu.Game/Graphics/UserInterface/SlimEnumDropdown.cs
index 965734792c..c01ee1a059 100644
--- a/osu.Game/Graphics/UserInterface/SlimEnumDropdown.cs
+++ b/osu.Game/Graphics/UserInterface/SlimEnumDropdown.cs
@@ -2,11 +2,8 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
-using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.UserInterface;
-using osuTK;
-using osuTK.Graphics;
 
 namespace osu.Game.Graphics.UserInterface
 {
@@ -15,30 +12,13 @@ namespace osu.Game.Graphics.UserInterface
     {
         protected override DropdownHeader CreateHeader() => new SlimDropdownHeader();
 
-        protected override DropdownMenu CreateMenu() => new SlimMenu();
-
         private class SlimDropdownHeader : OsuDropdownHeader
         {
             public SlimDropdownHeader()
             {
                 Height = 25;
-                Icon.Size = new Vector2(16);
                 Foreground.Padding = new MarginPadding { Top = 4, Bottom = 4, Left = 8, Right = 4 };
             }
-
-            protected override void LoadComplete()
-            {
-                base.LoadComplete();
-                BackgroundColour = Color4.Black.Opacity(0.25f);
-            }
-        }
-
-        private class SlimMenu : OsuDropdownMenu
-        {
-            public SlimMenu()
-            {
-                BackgroundColour = Color4.Black.Opacity(0.7f);
-            }
         }
     }
 }

From b6c5797394233d78aa332d48034959dec4e0ba3b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 14 Oct 2021 12:55:02 +0900
Subject: [PATCH 0212/5547] Fix `AudioFilter` test not stopping track on forced
 exit

---
 osu.Game.Tests/Visual/Audio/TestSceneAudioFilter.cs | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/osu.Game.Tests/Visual/Audio/TestSceneAudioFilter.cs b/osu.Game.Tests/Visual/Audio/TestSceneAudioFilter.cs
index 0107632f6e..99be72e958 100644
--- a/osu.Game.Tests/Visual/Audio/TestSceneAudioFilter.cs
+++ b/osu.Game.Tests/Visual/Audio/TestSceneAudioFilter.cs
@@ -163,5 +163,11 @@ namespace osu.Game.Tests.Visual.Audio
         }
 
         private void waitTrackPlay() => AddWaitStep("Let track play", 10);
+
+        protected override void Dispose(bool isDisposing)
+        {
+            base.Dispose(isDisposing);
+            track?.Dispose();
+        }
     }
 }

From b1fc87013073fc732222153c1a79006d5f3d1615 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 14 Oct 2021 13:34:08 +0900
Subject: [PATCH 0213/5547] Adjust item selection and chevron animation
 slightly

---
 .../Graphics/UserInterface/OsuDropdown.cs     | 58 ++++++++++++++++---
 1 file changed, 49 insertions(+), 9 deletions(-)

diff --git a/osu.Game/Graphics/UserInterface/OsuDropdown.cs b/osu.Game/Graphics/UserInterface/OsuDropdown.cs
index 337d5585ea..5831d9ab1f 100644
--- a/osu.Game/Graphics/UserInterface/OsuDropdown.cs
+++ b/osu.Game/Graphics/UserInterface/OsuDropdown.cs
@@ -4,7 +4,6 @@
 #nullable enable
 
 using System.Linq;
-using osuTK.Graphics;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
 using osu.Framework.Audio.Sample;
@@ -18,6 +17,7 @@ using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Overlays;
 using osuTK;
+using osuTK.Graphics;
 
 namespace osu.Game.Graphics.UserInterface
 {
@@ -163,6 +163,8 @@ namespace osu.Game.Graphics.UserInterface
                 {
                     BackgroundColourHover = accentColour ?? nonAccentHoverColour;
                     BackgroundColourSelected = accentColour ?? nonAccentSelectedColour;
+                    BackgroundColour = BackgroundColourHover.Opacity(0);
+
                     UpdateBackgroundColour();
                     UpdateForegroundColour();
                 }
@@ -182,8 +184,6 @@ namespace osu.Game.Graphics.UserInterface
                 [BackgroundDependencyLoader]
                 private void load(OsuColour colours)
                 {
-                    BackgroundColour = Color4.Transparent;
-
                     nonAccentHoverColour = colours.PinkDarker;
                     nonAccentSelectedColour = Color4.Black.Opacity(0.5f);
                     updateColours();
@@ -191,16 +191,29 @@ namespace osu.Game.Graphics.UserInterface
                     AddInternal(new HoverSounds());
                 }
 
+                protected override void UpdateBackgroundColour()
+                {
+                    if (!IsPreSelected && !IsSelected)
+                    {
+                        Background.FadeOut(600, Easing.OutQuint);
+                        return;
+                    }
+
+                    Background.FadeIn(100, Easing.OutQuint);
+                    Background.FadeColour(IsPreSelected ? BackgroundColourHover : BackgroundColourSelected, 100, Easing.OutQuint);
+                }
+
                 protected override void UpdateForegroundColour()
                 {
                     base.UpdateForegroundColour();
 
-                    if (Foreground.Children.FirstOrDefault() is Content content) content.Chevron.Alpha = IsHovered ? 1 : 0;
+                    if (Foreground.Children.FirstOrDefault() is Content content)
+                        content.Hovering = IsHovered;
                 }
 
                 protected override Drawable CreateContent() => new Content();
 
-                protected new class Content : FillFlowContainer, IHasText
+                protected new class Content : CompositeDrawable, IHasText
                 {
                     public LocalisableString Text
                     {
@@ -211,26 +224,28 @@ namespace osu.Game.Graphics.UserInterface
                     public readonly OsuSpriteText Label;
                     public readonly SpriteIcon Chevron;
 
+                    private const float chevron_offset = -3;
+
                     public Content()
                     {
                         RelativeSizeAxes = Axes.X;
                         AutoSizeAxes = Axes.Y;
-                        Direction = FillDirection.Horizontal;
 
-                        Children = new Drawable[]
+                        InternalChildren = new Drawable[]
                         {
                             Chevron = new SpriteIcon
                             {
-                                AlwaysPresent = true,
                                 Icon = FontAwesome.Solid.ChevronRight,
-                                Alpha = 0.5f,
                                 Size = new Vector2(8),
+                                Alpha = 0,
+                                X = chevron_offset,
                                 Margin = new MarginPadding { Left = 3, Right = 3 },
                                 Origin = Anchor.CentreLeft,
                                 Anchor = Anchor.CentreLeft,
                             },
                             Label = new OsuSpriteText
                             {
+                                X = 15,
                                 Origin = Anchor.CentreLeft,
                                 Anchor = Anchor.CentreLeft,
                             },
@@ -242,6 +257,31 @@ namespace osu.Game.Graphics.UserInterface
                     {
                         Chevron.Colour = colourProvider?.Background5 ?? Color4.Black;
                     }
+
+                    private bool hovering;
+
+                    public bool Hovering
+                    {
+                        get => hovering;
+                        set
+                        {
+                            if (value == hovering)
+                                return;
+
+                            hovering = value;
+
+                            if (hovering)
+                            {
+                                Chevron.FadeIn(400, Easing.OutQuint);
+                                Chevron.MoveToX(0, 400, Easing.OutQuint);
+                            }
+                            else
+                            {
+                                Chevron.FadeOut(200);
+                                Chevron.MoveToX(chevron_offset, 200, Easing.In);
+                            }
+                        }
+                    }
                 }
             }
 

From 09536cd7339b9f2ebb2bf55b2ac12d3e6e9ba088 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 14 Oct 2021 13:58:36 +0900
Subject: [PATCH 0214/5547] Add logging of `WorkingBeatmapCache.Invalidate`
 calls

---
 osu.Game/Beatmaps/WorkingBeatmapCache.cs | 5 +++++
 osu.Game/Screens/Edit/Editor.cs          | 3 +++
 2 files changed, 8 insertions(+)

diff --git a/osu.Game/Beatmaps/WorkingBeatmapCache.cs b/osu.Game/Beatmaps/WorkingBeatmapCache.cs
index ad3e890b3a..cf83345e2a 100644
--- a/osu.Game/Beatmaps/WorkingBeatmapCache.cs
+++ b/osu.Game/Beatmaps/WorkingBeatmapCache.cs
@@ -66,8 +66,12 @@ namespace osu.Game.Beatmaps
             lock (workingCache)
             {
                 var working = workingCache.FirstOrDefault(w => w.BeatmapInfo?.ID == info.ID);
+
                 if (working != null)
+                {
+                    Logger.Log($"Invalidating working beatmap cache for {info}");
                     workingCache.Remove(working);
+                }
             }
         }
 
@@ -86,6 +90,7 @@ namespace osu.Game.Beatmaps
             lock (workingCache)
             {
                 var working = workingCache.FirstOrDefault(w => w.BeatmapInfo?.ID == beatmapInfo.ID);
+
                 if (working != null)
                     return working;
 
diff --git a/osu.Game/Screens/Edit/Editor.cs b/osu.Game/Screens/Edit/Editor.cs
index 88bed109fe..512226413b 100644
--- a/osu.Game/Screens/Edit/Editor.cs
+++ b/osu.Game/Screens/Edit/Editor.cs
@@ -523,7 +523,10 @@ namespace osu.Game.Screens.Edit
             var refetchedBeatmap = beatmapManager.GetWorkingBeatmap(Beatmap.Value.BeatmapInfo);
 
             if (!(refetchedBeatmap is DummyWorkingBeatmap))
+            {
+                Logger.Log("Editor providing re-fetched beatmap post edit session");
                 Beatmap.Value = refetchedBeatmap;
+            }
 
             return base.OnExiting(next);
         }

From e0babe4b792d2e041b8c224ca854ffd4dcc28242 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 14 Oct 2021 14:07:43 +0900
Subject: [PATCH 0215/5547] Add global logging of `WorkingBeatmap` changes

---
 osu.Game/OsuGame.cs                   | 1 +
 osu.Game/Screens/Select/SongSelect.cs | 2 +-
 2 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index 020cdebab6..5960451c9c 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -554,6 +554,7 @@ namespace osu.Game
         {
             beatmap.OldValue?.CancelAsyncLoad();
             beatmap.NewValue?.BeginAsyncLoad();
+            Logger.Log($"Game-wide working beatmap updated to {beatmap.NewValue}");
         }
 
         private void modsChanged(ValueChangedEvent<IReadOnlyList<Mod>> mods)
diff --git a/osu.Game/Screens/Select/SongSelect.cs b/osu.Game/Screens/Select/SongSelect.cs
index 6cafcb9d16..a2dea355ac 100644
--- a/osu.Game/Screens/Select/SongSelect.cs
+++ b/osu.Game/Screens/Select/SongSelect.cs
@@ -410,7 +410,7 @@ namespace osu.Game.Screens.Select
         {
             if (e.NewValue is DummyWorkingBeatmap || !this.IsCurrentScreen()) return;
 
-            Logger.Log($"working beatmap updated to {e.NewValue}");
+            Logger.Log($"Song select working beatmap updated to {e.NewValue}");
 
             if (!Carousel.SelectBeatmap(e.NewValue.BeatmapInfo, false))
             {

From 3964e5c448d9140e7d086f84eb4343701d28709f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 14 Oct 2021 14:11:12 +0900
Subject: [PATCH 0216/5547] Fix test failure due to retyped class

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

diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneFilterControl.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneFilterControl.cs
index a5b90e6655..0ae4e0c5dc 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneFilterControl.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneFilterControl.cs
@@ -205,7 +205,7 @@ namespace osu.Game.Tests.Visual.SongSelect
         private void assertCollectionDropdownContains(string collectionName, bool shouldContain = true) =>
             AddAssert($"collection dropdown {(shouldContain ? "contains" : "does not contain")} '{collectionName}'",
                 // A bit of a roundabout way of going about this, see: https://github.com/ppy/osu-framework/issues/3871 + https://github.com/ppy/osu-framework/issues/3872
-                () => shouldContain == (getCollectionDropdownItems().Any(i => i.ChildrenOfType<FillFlowContainer>().OfType<IHasText>().First().Text == collectionName)));
+                () => shouldContain == (getCollectionDropdownItems().Any(i => i.ChildrenOfType<CompositeDrawable>().OfType<IHasText>().First().Text == collectionName)));
 
         private IconButton getAddOrRemoveButton(int index)
             => getCollectionDropdownItems().ElementAt(index).ChildrenOfType<IconButton>().Single();

From ccc8012fd49615c1f0f01d49779e47799cfc06a8 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 14 Oct 2021 14:16:39 +0900
Subject: [PATCH 0217/5547] Mark non-localisable strings

---
 osu.Game/Stores/RealmRulesetStore.cs | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Stores/RealmRulesetStore.cs b/osu.Game/Stores/RealmRulesetStore.cs
index 63e5344ef3..ec395bf774 100644
--- a/osu.Game/Stores/RealmRulesetStore.cs
+++ b/osu.Game/Stores/RealmRulesetStore.cs
@@ -21,7 +21,7 @@ namespace osu.Game.Stores
     {
         private readonly RealmContextFactory realmFactory;
 
-        private const string ruleset_library_prefix = "osu.Game.Rulesets";
+        private const string ruleset_library_prefix = @"osu.Game.Rulesets";
 
         private readonly Dictionary<Assembly, Type> loadedAssemblies = new Dictionary<Assembly, Type>();
 
@@ -51,7 +51,7 @@ namespace osu.Game.Stores
             // to load as unable to locate the game core assembly.
             AppDomain.CurrentDomain.AssemblyResolve += resolveRulesetDependencyAssembly;
 
-            var rulesetStorage = storage?.GetStorageForDirectory("rulesets");
+            var rulesetStorage = storage?.GetStorageForDirectory(@"rulesets");
             if (rulesetStorage != null)
                 loadUserRulesets(rulesetStorage);
 
@@ -176,7 +176,7 @@ namespace osu.Game.Stores
                 if (rulesetName == null)
                     continue;
 
-                if (!rulesetName.StartsWith(ruleset_library_prefix, StringComparison.InvariantCultureIgnoreCase) || rulesetName.Contains("Tests"))
+                if (!rulesetName.StartsWith(ruleset_library_prefix, StringComparison.InvariantCultureIgnoreCase) || rulesetName.Contains(@"Tests"))
                     continue;
 
                 addRuleset(ruleset);
@@ -185,9 +185,9 @@ namespace osu.Game.Stores
 
         private void loadUserRulesets(Storage rulesetStorage)
         {
-            var rulesets = rulesetStorage.GetFiles(".", $"{ruleset_library_prefix}.*.dll");
+            var rulesets = rulesetStorage.GetFiles(@".", @$"{ruleset_library_prefix}.*.dll");
 
-            foreach (var ruleset in rulesets.Where(f => !f.Contains("Tests")))
+            foreach (var ruleset in rulesets.Where(f => !f.Contains(@"Tests")))
                 loadRulesetFromFile(rulesetStorage.GetFullPath(ruleset));
         }
 
@@ -195,7 +195,7 @@ namespace osu.Game.Stores
         {
             try
             {
-                var files = Directory.GetFiles(RuntimeInfo.StartupDirectory, $"{ruleset_library_prefix}.*.dll");
+                var files = Directory.GetFiles(RuntimeInfo.StartupDirectory, @$"{ruleset_library_prefix}.*.dll");
 
                 foreach (string file in files.Where(f => !Path.GetFileName(f).Contains("Tests")))
                     loadRulesetFromFile(file);

From 364fa068b31a6118f67d3ba632641ac32ff688e9 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 14 Oct 2021 14:20:34 +0900
Subject: [PATCH 0218/5547] Add non-null check to appease inspection

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

diff --git a/osu.Game/Stores/RealmRulesetStore.cs b/osu.Game/Stores/RealmRulesetStore.cs
index ec395bf774..fb512692d6 100644
--- a/osu.Game/Stores/RealmRulesetStore.cs
+++ b/osu.Game/Stores/RealmRulesetStore.cs
@@ -105,7 +105,11 @@ namespace osu.Game.Stores
             {
                 var rulesets = realm.All<RealmRuleset>();
 
-                List<Ruleset> instances = loadedAssemblies.Values.Select(r => Activator.CreateInstance(r) as Ruleset).OfType<Ruleset>().ToList();
+                List<Ruleset> instances = loadedAssemblies.Values
+                                                          .Select(r => Activator.CreateInstance(r) as Ruleset)
+                                                          .Where(r => r != null)
+                                                          .Cast<Ruleset>()
+                                                          .ToList();
 
                 // add all legacy rulesets first to ensure they have exclusive choice of primary key.
                 foreach (var r in instances.Where(r => r is ILegacyRuleset))

From 4ed794e4349553733ba67fcded77906d9e28de92 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 14 Oct 2021 14:24:36 +0900
Subject: [PATCH 0219/5547] Throw and log instead of silently failing on
 type/instance creation failure

---
 osu.Game/Stores/RealmRulesetStore.cs | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Stores/RealmRulesetStore.cs b/osu.Game/Stores/RealmRulesetStore.cs
index fb512692d6..51f059caad 100644
--- a/osu.Game/Stores/RealmRulesetStore.cs
+++ b/osu.Game/Stores/RealmRulesetStore.cs
@@ -147,12 +147,12 @@ namespace osu.Game.Stores
                         var type = Type.GetType(r.InstantiationInfo);
 
                         if (type == null)
-                            continue;
+                            throw new InvalidOperationException(@"Type resolution failure.");
 
                         var rInstance = (Activator.CreateInstance(type) as Ruleset)?.RulesetInfo;
 
                         if (rInstance == null)
-                            continue;
+                            throw new InvalidOperationException(@"Instantiation failure.");
 
                         r.Name = rInstance.Name;
                         r.ShortName = rInstance.ShortName;
@@ -161,9 +161,10 @@ namespace osu.Game.Stores
 
                         detachedRulesets.Add(r.Clone());
                     }
-                    catch
+                    catch (Exception ex)
                     {
                         r.Available = false;
+                        Logger.Log($"Could not load ruleset {r}: {ex.Message}");
                     }
                 }
 

From 2e0a2a28ab1809efdb6da5182dacd5c4e7c20120 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 14 Oct 2021 14:40:20 +0900
Subject: [PATCH 0220/5547] Check mutations at each point in the process (and
 also check artist/title)

---
 .../Visual/Editing/TestSceneEditorSaving.cs   | 22 +++++++++++++++----
 1 file changed, 18 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneEditorSaving.cs b/osu.Game.Tests/Visual/Editing/TestSceneEditorSaving.cs
index 49f7bdf997..1404aa1103 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneEditorSaving.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneEditorSaving.cs
@@ -30,10 +30,15 @@ namespace osu.Game.Tests.Visual.Editing
 
             PushAndConfirm(() => new EditorLoader());
 
-            AddUntilStep("wait for editor load", () => editor != null);
+            AddUntilStep("wait for editor load", () => editor?.IsLoaded == true);
 
             AddStep("Set overall difficulty", () => editorBeatmap.Difficulty.OverallDifficulty = 7);
-            AddStep("Set difficulty name", () => editorBeatmap.BeatmapInfo.Version = "diffname");
+            AddStep("Set artist and title", () =>
+            {
+                editorBeatmap.BeatmapInfo.Metadata.Artist = "artist";
+                editorBeatmap.BeatmapInfo.Metadata.Title = "title";
+            });
+            AddStep("Set difficulty name", () => editorBeatmap.BeatmapInfo.Version = "difficulty");
 
             AddStep("Add timing point", () => editorBeatmap.ControlPointInfo.Add(0, new TimingControlPoint()));
 
@@ -44,10 +49,12 @@ namespace osu.Game.Tests.Visual.Editing
             AddStep("Move to playfield", () => InputManager.MoveMouseTo(Game.ScreenSpaceDrawQuad.Centre));
             AddStep("Place single hitcircle", () => InputManager.Click(MouseButton.Left));
 
-            AddAssert("Beatmap contains single hitcircle", () => editorBeatmap.HitObjects.Count == 1);
+            checkMutations();
 
             AddStep("Save", () => InputManager.Keys(PlatformAction.Save));
 
+            checkMutations();
+
             AddStep("Exit", () => InputManager.Key(Key.Escape));
 
             AddUntilStep("Wait for main menu", () => Game.ScreenStack.CurrentScreen is MainMenu);
@@ -59,9 +66,16 @@ namespace osu.Game.Tests.Visual.Editing
             AddStep("Enter editor", () => InputManager.Key(Key.Number5));
 
             AddUntilStep("Wait for editor load", () => editor != null);
+
+            checkMutations();
+        }
+
+        private void checkMutations()
+        {
             AddAssert("Beatmap contains single hitcircle", () => editorBeatmap.HitObjects.Count == 1);
             AddAssert("Beatmap has correct overall difficulty", () => editorBeatmap.Difficulty.OverallDifficulty == 7);
-            AddAssert("Beatmap has correct difficulty name", () => editorBeatmap.BeatmapInfo.Version == "diffname");
+            AddAssert("Beatmap has correct metadata", () => editorBeatmap.BeatmapInfo.Metadata.Artist == "artist" && editorBeatmap.BeatmapInfo.Metadata.Title == "title");
+            AddAssert("Beatmap has correct difficulty name", () => editorBeatmap.BeatmapInfo.Version == "difficulty");
         }
     }
 }

From 060bb1afbd129db70c5f2132bb781c725fd69105 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 14 Oct 2021 15:39:08 +0900
Subject: [PATCH 0221/5547] Add locking around async beatmap (task) retrieval

---
 osu.Game/Beatmaps/WorkingBeatmap.cs | 26 +++++++++++++++++---------
 1 file changed, 17 insertions(+), 9 deletions(-)

diff --git a/osu.Game/Beatmaps/WorkingBeatmap.cs b/osu.Game/Beatmaps/WorkingBeatmap.cs
index 18adecb7aa..177678789d 100644
--- a/osu.Game/Beatmaps/WorkingBeatmap.cs
+++ b/osu.Game/Beatmaps/WorkingBeatmap.cs
@@ -205,19 +205,27 @@ namespace osu.Game.Beatmaps
             return new CancellationTokenSource(timeout ?? TimeSpan.FromSeconds(10));
         }
 
-        private Task<IBeatmap> loadBeatmapAsync() => beatmapLoadTask ??= Task.Factory.StartNew(() =>
+        private readonly object beatmapFetchLock = new object();
+
+        private Task<IBeatmap> loadBeatmapAsync()
         {
-            // Todo: Handle cancellation during beatmap parsing
-            var b = GetBeatmap() ?? new Beatmap();
+            lock (beatmapFetchLock)
+            {
+                return beatmapLoadTask ??= Task.Factory.StartNew(() =>
+                {
+                    // Todo: Handle cancellation during beatmap parsing
+                    var b = GetBeatmap() ?? new Beatmap();
 
-            // The original beatmap version needs to be preserved as the database doesn't contain it
-            BeatmapInfo.BeatmapVersion = b.BeatmapInfo.BeatmapVersion;
+                    // The original beatmap version needs to be preserved as the database doesn't contain it
+                    BeatmapInfo.BeatmapVersion = b.BeatmapInfo.BeatmapVersion;
 
-            // Use the database-backed info for more up-to-date values (beatmap id, ranked status, etc)
-            b.BeatmapInfo = BeatmapInfo;
+                    // Use the database-backed info for more up-to-date values (beatmap id, ranked status, etc)
+                    b.BeatmapInfo = BeatmapInfo;
 
-            return b;
-        }, loadCancellation.Token, TaskCreationOptions.LongRunning, TaskScheduler.Default);
+                    return b;
+                }, loadCancellation.Token, TaskCreationOptions.LongRunning, TaskScheduler.Default);
+            }
+        }
 
         public override string ToString() => BeatmapInfo.ToString();
 

From 119e9ad83e8faa76ef3bb38bb4a16577502c290f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 14 Oct 2021 15:58:42 +0900
Subject: [PATCH 0222/5547] Fix multiplayer gameplay flow test scene failures
 due to button not being ready

---
 .../Visual/Multiplayer/TestSceneMultiplayer.cs     | 14 +++++++++++---
 1 file changed, 11 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
index 0b70703870..d40f808f06 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
@@ -564,11 +564,17 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 }
             });
 
-            AddRepeatStep("click spectate button", () =>
+            AddUntilStep("wait for ready button clickable", () => readyButton.ChildrenOfType<OsuButton>().Single().Enabled.Value);
+
+            AddStep("click ready button", () =>
             {
-                InputManager.MoveMouseTo(this.ChildrenOfType<MultiplayerReadyButton>().Single());
+                InputManager.MoveMouseTo(readyButton);
                 InputManager.Click(MouseButton.Left);
-            }, 2);
+            });
+
+            AddUntilStep("wait for start match available", () => readyButton.ChildrenOfType<OsuButton>().Single().Text.ToString().Contains("Start match"));
+
+            AddStep("click start button", () => InputManager.Click(MouseButton.Left));
 
             AddUntilStep("wait for player", () => Stack.CurrentScreen is Player);
 
@@ -582,6 +588,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddUntilStep("wait for results", () => Stack.CurrentScreen is ResultsScreen);
         }
 
+        private MultiplayerReadyButton readyButton => this.ChildrenOfType<MultiplayerReadyButton>().Single();
+
         private void createRoom(Func<Room> room)
         {
             AddUntilStep("wait for lounge", () => multiplayerScreen.ChildrenOfType<LoungeSubScreen>().SingleOrDefault()?.IsLoaded == true);

From 8a4c0c0ac82094868e396e997ed6d45fce2b9e1d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 14 Oct 2021 16:22:43 +0900
Subject: [PATCH 0223/5547] Lock one more case of usage

---
 osu.Game/Beatmaps/WorkingBeatmap.cs | 11 +++++++----
 1 file changed, 7 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Beatmaps/WorkingBeatmap.cs b/osu.Game/Beatmaps/WorkingBeatmap.cs
index 177678789d..d2c0f7de0f 100644
--- a/osu.Game/Beatmaps/WorkingBeatmap.cs
+++ b/osu.Game/Beatmaps/WorkingBeatmap.cs
@@ -189,11 +189,14 @@ namespace osu.Game.Beatmaps
         /// </summary>
         public void CancelAsyncLoad()
         {
-            loadCancellation?.Cancel();
-            loadCancellation = new CancellationTokenSource();
+            lock (beatmapFetchLock)
+            {
+                loadCancellation?.Cancel();
+                loadCancellation = new CancellationTokenSource();
 
-            if (beatmapLoadTask?.IsCompleted != true)
-                beatmapLoadTask = null;
+                if (beatmapLoadTask?.IsCompleted != true)
+                    beatmapLoadTask = null;
+            }
         }
 
         private CancellationTokenSource createCancellationTokenSource(TimeSpan? timeout)

From 2784ba1423fa69bdaaa84989c459595c0ae1c7f4 Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Thu, 14 Oct 2021 16:34:23 +0900
Subject: [PATCH 0224/5547] Add queueing modes

---
 osu.Game/Online/Multiplayer/QueueingModes.cs | 11 +++++++++++
 1 file changed, 11 insertions(+)
 create mode 100644 osu.Game/Online/Multiplayer/QueueingModes.cs

diff --git a/osu.Game/Online/Multiplayer/QueueingModes.cs b/osu.Game/Online/Multiplayer/QueueingModes.cs
new file mode 100644
index 0000000000..684768fa57
--- /dev/null
+++ b/osu.Game/Online/Multiplayer/QueueingModes.cs
@@ -0,0 +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.
+
+namespace osu.Game.Online.Multiplayer
+{
+    public enum QueueingModes
+    {
+        Host,
+        Karaoke,
+    }
+}

From 1212b08672d29b844d17eddf83fbf4bba135b243 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 14 Oct 2021 16:45:34 +0900
Subject: [PATCH 0225/5547] Fix gameplay audio ramping down in frequency a
 second time at the end of the fail sequence

---
 osu.Game/Screens/Play/FailAnimation.cs | 1 -
 1 file changed, 1 deletion(-)

diff --git a/osu.Game/Screens/Play/FailAnimation.cs b/osu.Game/Screens/Play/FailAnimation.cs
index ea158c5789..e37f42e5f0 100644
--- a/osu.Game/Screens/Play/FailAnimation.cs
+++ b/osu.Game/Screens/Play/FailAnimation.cs
@@ -71,7 +71,6 @@ namespace osu.Game.Screens.Play
             this.TransformBindableTo(trackFreq, 0, duration).OnComplete(_ =>
             {
                 OnComplete?.Invoke();
-                Expire();
             });
 
             failLowPassFilter.CutoffTo(300, duration, Easing.OutCubic);

From 0fd5fa17c0f67430a90fede2d93dcc0d9ac3f37e Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Thu, 14 Oct 2021 16:50:38 +0900
Subject: [PATCH 0226/5547] Add more thorough check

---
 osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
index d40f808f06..2bb77395ef 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
@@ -564,7 +564,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 }
             });
 
-            AddUntilStep("wait for ready button clickable", () => readyButton.ChildrenOfType<OsuButton>().Single().Enabled.Value);
+            AddUntilStep("wait for ready button to be enabled", () => readyButton.ChildrenOfType<OsuButton>().Single().Enabled.Value);
 
             AddStep("click ready button", () =>
             {
@@ -572,7 +572,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 InputManager.Click(MouseButton.Left);
             });
 
-            AddUntilStep("wait for start match available", () => readyButton.ChildrenOfType<OsuButton>().Single().Text.ToString().Contains("Start match"));
+            AddUntilStep("wait for player to be ready", () => client.Room?.Users[0].State == MultiplayerUserState.Ready);
+            AddUntilStep("wait for ready button to be enabled", () => readyButton.ChildrenOfType<OsuButton>().Single().Enabled.Value);
 
             AddStep("click start button", () => InputManager.Click(MouseButton.Left));
 

From 0d86dab80a4791b0882c3a79ddd462121ad146ab Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 14 Oct 2021 17:37:08 +0900
Subject: [PATCH 0227/5547] Fix multiplayer components updating when not alive

Should close https://github.com/ppy/osu/issues/15092.

- [ ] Depends on https://github.com/ppy/osu-framework/pull/4826.
---
 .../Multiplayer/MultiplayerRoomComposite.cs   | 22 +++++++++++--------
 1 file changed, 13 insertions(+), 9 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerRoomComposite.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerRoomComposite.cs
index 0f256160eb..a380ddef25 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerRoomComposite.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerRoomComposite.cs
@@ -19,15 +19,19 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
         {
             base.LoadComplete();
 
-            Client.RoomUpdated += OnRoomUpdated;
-
-            Client.UserLeft += UserLeft;
-            Client.UserKicked += UserKicked;
-            Client.UserJoined += UserJoined;
+            Client.RoomUpdated += invokeOnRoomUpdated;
+            Client.UserLeft += invokeUserLeft;
+            Client.UserKicked += invokeUserKicked;
+            Client.UserJoined += invokeUserJoined;
 
             OnRoomUpdated();
         }
 
+        private void invokeOnRoomUpdated() => Scheduler.AddOnce(OnRoomUpdated);
+        private void invokeUserJoined(MultiplayerRoomUser user) => Scheduler.AddOnce(UserJoined, user);
+        private void invokeUserKicked(MultiplayerRoomUser user) => Scheduler.AddOnce(UserKicked, user);
+        private void invokeUserLeft(MultiplayerRoomUser user) => Scheduler.AddOnce(UserLeft, user);
+
         /// <summary>
         /// Invoked when a user has joined the room.
         /// </summary>
@@ -63,10 +67,10 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
         {
             if (Client != null)
             {
-                Client.UserLeft -= UserLeft;
-                Client.UserKicked -= UserKicked;
-                Client.UserJoined -= UserJoined;
-                Client.RoomUpdated -= OnRoomUpdated;
+                Client.RoomUpdated -= invokeOnRoomUpdated;
+                Client.UserLeft -= invokeUserLeft;
+                Client.UserKicked -= invokeUserKicked;
+                Client.UserJoined -= invokeUserJoined;
             }
 
             base.Dispose(isDisposing);

From 06249c4ab2b3362f0f9d9c360cdd3bd5a6410be7 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 14 Oct 2021 17:52:19 +0900
Subject: [PATCH 0228/5547] Fix incorrect usages of `Scheduler.AddOnce`

---
 .../TestSceneGameplayCursor.cs                       |  8 +++++---
 .../Overlays/Notifications/ProgressNotification.cs   |  4 +++-
 .../Screens/OnlinePlay/Components/RoomManager.cs     |  7 ++++++-
 .../Multiplayer/MultiplayerLoungeSubScreen.cs        | 12 +++++++-----
 4 files changed, 21 insertions(+), 10 deletions(-)

diff --git a/osu.Game.Rulesets.Osu.Tests/TestSceneGameplayCursor.cs b/osu.Game.Rulesets.Osu.Tests/TestSceneGameplayCursor.cs
index f09aad8b49..1f01ba601b 100644
--- a/osu.Game.Rulesets.Osu.Tests/TestSceneGameplayCursor.cs
+++ b/osu.Game.Rulesets.Osu.Tests/TestSceneGameplayCursor.cs
@@ -60,7 +60,7 @@ namespace osu.Game.Rulesets.Osu.Tests
             {
                 config.SetValue(OsuSetting.AutoCursorSize, true);
                 gameplayState.Beatmap.Difficulty.CircleSize = val;
-                Scheduler.AddOnce(() => loadContent(false));
+                Scheduler.AddOnce(loadContent);
             });
 
             AddStep("test cursor container", () => loadContent(false));
@@ -78,7 +78,7 @@ namespace osu.Game.Rulesets.Osu.Tests
             AddStep($"adjust cs to {circleSize}", () => gameplayState.Beatmap.Difficulty.CircleSize = circleSize);
             AddStep("turn on autosizing", () => config.SetValue(OsuSetting.AutoCursorSize, true));
 
-            AddStep("load content", () => loadContent());
+            AddStep("load content", loadContent);
 
             AddUntilStep("cursor size correct", () => lastContainer.ActiveCursor.Scale.X == OsuCursorContainer.GetScaleForCircleSize(circleSize) * userScale);
 
@@ -98,7 +98,9 @@ namespace osu.Game.Rulesets.Osu.Tests
             AddStep("load content", () => loadContent(false, () => new SkinProvidingContainer(new TopLeftCursorSkin())));
         }
 
-        private void loadContent(bool automated = true, Func<SkinProvidingContainer> skinProvider = null)
+        private void loadContent() => loadContent(false);
+
+        private void loadContent(bool automated, Func<SkinProvidingContainer> skinProvider = null)
         {
             SetContents(_ =>
             {
diff --git a/osu.Game/Overlays/Notifications/ProgressNotification.cs b/osu.Game/Overlays/Notifications/ProgressNotification.cs
index 3105ecd742..f8cd31f193 100644
--- a/osu.Game/Overlays/Notifications/ProgressNotification.cs
+++ b/osu.Game/Overlays/Notifications/ProgressNotification.cs
@@ -31,10 +31,12 @@ namespace osu.Game.Overlays.Notifications
             set
             {
                 progress = value;
-                Scheduler.AddOnce(() => progressBar.Progress = progress);
+                Scheduler.AddOnce(updateProgress, progress);
             }
         }
 
+        private void updateProgress(float progress) => progressBar.Progress = progress;
+
         protected override void LoadComplete()
         {
             base.LoadComplete();
diff --git a/osu.Game/Screens/OnlinePlay/Components/RoomManager.cs b/osu.Game/Screens/OnlinePlay/Components/RoomManager.cs
index 97377278a6..abda9e897b 100644
--- a/osu.Game/Screens/OnlinePlay/Components/RoomManager.cs
+++ b/osu.Game/Screens/OnlinePlay/Components/RoomManager.cs
@@ -150,6 +150,11 @@ namespace osu.Game.Screens.OnlinePlay.Components
             notifyRoomsUpdated();
         }
 
-        private void notifyRoomsUpdated() => Scheduler.AddOnce(() => RoomsUpdated?.Invoke());
+        private void notifyRoomsUpdated()
+        {
+            Scheduler.AddOnce(invokeRoomsUpdated);
+
+            void invokeRoomsUpdated() => RoomsUpdated?.Invoke();
+        }
     }
 }
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerLoungeSubScreen.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerLoungeSubScreen.cs
index 6c3dfe7382..cf1066df10 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerLoungeSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerLoungeSubScreen.cs
@@ -79,11 +79,13 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
             private void load()
             {
                 isConnected.BindTo(client.IsConnected);
-                isConnected.BindValueChanged(c => Scheduler.AddOnce(() =>
-                {
-                    if (isConnected.Value && IsLoaded)
-                        PollImmediately();
-                }), true);
+                isConnected.BindValueChanged(c => Scheduler.AddOnce(poll), true);
+            }
+
+            private void poll()
+            {
+                if (isConnected.Value && IsLoaded)
+                    PollImmediately();
             }
 
             protected override Task Poll()

From a31f5ca326a72a63ee0b45ecc765af8c4e78344c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 14 Oct 2021 20:13:55 +0900
Subject: [PATCH 0229/5547] Update framework

---
 osu.Android.props        | 2 +-
 osu.Game/osu.Game.csproj | 2 +-
 osu.iOS.props            | 4 ++--
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Android.props b/osu.Android.props
index db62667fc2..f2052b2563 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -52,7 +52,7 @@
   </ItemGroup>
   <ItemGroup>
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1004.0" />
-    <PackageReference Include="ppy.osu.Framework.Android" Version="2021.1013.0" />
+    <PackageReference Include="ppy.osu.Framework.Android" Version="2021.1014.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
     <!-- Realm needs to be directly referenced in all Xamarin projects, as it will not pull in its transitive dependencies otherwise. -->
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 9ee6f4cf52..af7e9f80c4 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="10.6.0" />
-    <PackageReference Include="ppy.osu.Framework" Version="2021.1013.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2021.1014.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1004.0" />
     <PackageReference Include="Sentry" Version="3.9.4" />
     <PackageReference Include="SharpCompress" Version="0.29.0" />
diff --git a/osu.iOS.props b/osu.iOS.props
index 110de79285..b3bce3f0ea 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -70,7 +70,7 @@
     <Reference Include="System.Net.Http" />
   </ItemGroup>
   <ItemGroup Label="Package References">
-    <PackageReference Include="ppy.osu.Framework.iOS" Version="2021.1013.0" />
+    <PackageReference Include="ppy.osu.Framework.iOS" Version="2021.1014.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1004.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net5.0 / net6.0) -->
@@ -93,7 +93,7 @@
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="2.2.6" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.Core" Version="2.2.6" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
-    <PackageReference Include="ppy.osu.Framework" Version="2021.1013.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2021.1014.0" />
     <PackageReference Include="SharpCompress" Version="0.28.3" />
     <PackageReference Include="NUnit" Version="3.13.2" />
     <PackageReference Include="SharpRaven" Version="2.4.0" />

From ad0732484ff19e8854af7663d4631d950c15eae2 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 14 Oct 2021 22:12:38 +0900
Subject: [PATCH 0230/5547] Just wait for metadata section to be loaded

---
 osu.Game.Tests/Visual/Editing/TestSceneEditorSaving.cs | 3 +++
 osu.Game/Screens/Edit/Setup/MetadataSection.cs         | 2 +-
 2 files changed, 4 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneEditorSaving.cs b/osu.Game.Tests/Visual/Editing/TestSceneEditorSaving.cs
index 1404aa1103..49136e6019 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneEditorSaving.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneEditorSaving.cs
@@ -8,6 +8,7 @@ using osu.Framework.Testing;
 using osu.Game.Beatmaps.ControlPoints;
 using osu.Game.Rulesets.Edit;
 using osu.Game.Screens.Edit;
+using osu.Game.Screens.Edit.Setup;
 using osu.Game.Screens.Menu;
 using osu.Game.Screens.Select;
 using osuTK.Input;
@@ -32,6 +33,8 @@ namespace osu.Game.Tests.Visual.Editing
 
             AddUntilStep("wait for editor load", () => editor?.IsLoaded == true);
 
+            AddUntilStep("wait for metadata screen load", () => editor.ChildrenOfType<MetadataSection>().FirstOrDefault()?.IsLoaded == true);
+
             AddStep("Set overall difficulty", () => editorBeatmap.Difficulty.OverallDifficulty = 7);
             AddStep("Set artist and title", () =>
             {
diff --git a/osu.Game/Screens/Edit/Setup/MetadataSection.cs b/osu.Game/Screens/Edit/Setup/MetadataSection.cs
index 9e93b0b038..5bb40c09a5 100644
--- a/osu.Game/Screens/Edit/Setup/MetadataSection.cs
+++ b/osu.Game/Screens/Edit/Setup/MetadataSection.cs
@@ -10,7 +10,7 @@ using osu.Game.Graphics.UserInterfaceV2;
 
 namespace osu.Game.Screens.Edit.Setup
 {
-    internal class MetadataSection : SetupSection
+    public class MetadataSection : SetupSection
     {
         protected LabelledTextBox ArtistTextBox;
         protected LabelledTextBox RomanisedArtistTextBox;

From e6ee360511e85c82158aa9e1019fa5f1ebbd361e Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Fri, 15 Oct 2021 00:10:39 +0900
Subject: [PATCH 0231/5547] Fix intermittent multiplayer tests

---
 .../Online/Multiplayer/MultiplayerClient.cs   | 27 ++++++++++---------
 .../Multiplayer/TestMultiplayerClient.cs      | 13 +++++++--
 2 files changed, 26 insertions(+), 14 deletions(-)

diff --git a/osu.Game/Online/Multiplayer/MultiplayerClient.cs b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
index 75bbaec0ef..49a4526133 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
@@ -359,22 +359,25 @@ namespace osu.Game.Online.Multiplayer
             if (Room == null)
                 return;
 
-            await PopulateUser(user).ConfigureAwait(false);
-
-            Scheduler.Add(() =>
+            await Task.Run(async () =>
             {
-                if (Room == null)
-                    return;
+                await PopulateUser(user).ConfigureAwait(false);
 
-                // for sanity, ensure that there can be no duplicate users in the room user list.
-                if (Room.Users.Any(existing => existing.UserID == user.UserID))
-                    return;
+                Scheduler.Add(() =>
+                {
+                    if (Room == null)
+                        return;
 
-                Room.Users.Add(user);
+                    // for sanity, ensure that there can be no duplicate users in the room user list.
+                    if (Room.Users.Any(existing => existing.UserID == user.UserID))
+                        return;
 
-                UserJoined?.Invoke(user);
-                RoomUpdated?.Invoke();
-            }, false);
+                    Room.Users.Add(user);
+
+                    UserJoined?.Invoke(user);
+                    RoomUpdated?.Invoke();
+                });
+            }).ConfigureAwait(false);
         }
 
         Task IMultiplayerClient.UserLeft(MultiplayerRoomUser user) =>
diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
index 2c0ca0b872..9aa36f8dbd 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
@@ -53,7 +53,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
         public MultiplayerRoomUser AddUser(User user, bool markAsPlaying = false)
         {
             var roomUser = new MultiplayerRoomUser(user.Id) { User = user };
-            ((IMultiplayerClient)this).UserJoined(roomUser);
+
+            addUser(roomUser);
 
             if (markAsPlaying)
                 PlayingUserIds.Add(user.Id);
@@ -61,7 +62,15 @@ namespace osu.Game.Tests.Visual.Multiplayer
             return roomUser;
         }
 
-        public void AddNullUser() => ((IMultiplayerClient)this).UserJoined(new MultiplayerRoomUser(TestUserLookupCache.NULL_USER_ID));
+        public void AddNullUser() => addUser(new MultiplayerRoomUser(TestUserLookupCache.NULL_USER_ID));
+
+        private void addUser(MultiplayerRoomUser user)
+        {
+            ((IMultiplayerClient)this).UserJoined(user).Wait();
+
+            // We want the user to be immediately available for testing, so force a scheduler update.
+            Scheduler.Update();
+        }
 
         public void RemoveUser(User user)
         {

From eed8fa8d6959845d81553aa5d78e1844f4ea18d0 Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Fri, 15 Oct 2021 00:20:45 +0900
Subject: [PATCH 0232/5547] Expand comment a bit

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

diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
index 9aa36f8dbd..5e4e5942d9 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
@@ -68,7 +68,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             ((IMultiplayerClient)this).UserJoined(user).Wait();
 
-            // We want the user to be immediately available for testing, so force a scheduler update.
+            // We want the user to be immediately available for testing, so force a scheduler update to run the update-bound continuation.
             Scheduler.Update();
         }
 

From 4e315b14b89f8a96ce7e812c9908b3898671a896 Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Fri, 15 Oct 2021 00:25:59 +0900
Subject: [PATCH 0233/5547] List only failed suites/tests

---
 .github/workflows/report-nunit.yml | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/.github/workflows/report-nunit.yml b/.github/workflows/report-nunit.yml
index e0ccd50989..358cbda17a 100644
--- a/.github/workflows/report-nunit.yml
+++ b/.github/workflows/report-nunit.yml
@@ -30,3 +30,5 @@ jobs:
           name: Test Results (${{matrix.os.prettyname}}, ${{matrix.threadingMode}})
           path: "*.trx"
           reporter: dotnet-trx
+          list-suites: 'failed'
+          list-tests: 'failed'

From 6b1534f5a6e3658d802b19744e5f59c6feae1eb3 Mon Sep 17 00:00:00 2001
From: Jason Won <jasonwon628@gmail.com>
Date: Thu, 14 Oct 2021 18:30:55 -0400
Subject: [PATCH 0234/5547] Add "ghost" mod for osu

---
 osu.Game.Rulesets.Osu/Mods/OsuModGhost.cs | 67 +++++++++++++++++++++++
 osu.Game.Rulesets.Osu/OsuRuleset.cs       |  1 +
 2 files changed, 68 insertions(+)
 create mode 100644 osu.Game.Rulesets.Osu/Mods/OsuModGhost.cs

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModGhost.cs b/osu.Game.Rulesets.Osu/Mods/OsuModGhost.cs
new file mode 100644
index 0000000000..d371686d10
--- /dev/null
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModGhost.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.Game.Rulesets.UI;
+using osu.Game.Rulesets.Mods;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Sprites;
+using osu.Framework.Bindables;
+using osu.Framework.Localisation;
+using osu.Game.Graphics.UserInterface;
+using osu.Game.Configuration;
+using osu.Game.Overlays.Settings;
+using osu.Game.Rulesets.Scoring;
+using osu.Game.Scoring;
+
+namespace osu.Game.Rulesets.Osu.Mods
+{
+    public class OsuModGhost : Mod, IUpdatableByPlayfield, IApplicableToScoreProcessor
+    {
+        public override string Name => "Ghost";
+        public override string Acronym => "G";
+        public override ModType Type => ModType.Fun;
+        public override IconUsage? Icon => FontAwesome.Solid.Ghost;
+        public override string Description => "Where's the cursor?";
+        public override double ScoreMultiplier => 1;
+        
+        private readonly BindableNumber<float> ghostAlpha = new BindableFloat(0);
+        private BindableNumber<int> currentCombo;
+
+        [SettingSource(
+            "Hidden at combo",
+            "The combo count at which the cursor becomes completely hidden",
+            SettingControlType = typeof(SettingsSlider<int, HiddenComboSlider>)
+        )]
+        public BindableInt HiddenComboCount { get; } = new BindableInt
+        {
+            Default = 10,
+            Value = 10,
+            MinValue = 0,
+            MaxValue = 50,
+        };
+
+        public ScoreRank AdjustRank(ScoreRank rank, double accuracy) => rank;
+        public void ApplyToScoreProcessor(ScoreProcessor scoreProcessor)
+        {
+            currentCombo = scoreProcessor.Combo.GetBoundCopy();
+            currentCombo.BindValueChanged(combo =>
+            {
+                float dimFactor = HiddenComboCount.Value == 0 ? 1 : (float)combo.NewValue / HiddenComboCount.Value;
+
+                scoreProcessor.TransformBindableTo(ghostAlpha, 1-dimFactor, 100, Easing.OutQuint);
+            }, true);
+        }
+
+
+        public virtual void Update(Playfield playfield)
+        {
+            playfield.Cursor.Alpha = ghostAlpha.Value;
+        }
+        
+    }
+
+    public class HiddenComboSlider : OsuSliderBar<int>
+    {
+        public override LocalisableString TooltipText => Current.Value == 0 ? "always hidden" : base.TooltipText;
+    }
+}
diff --git a/osu.Game.Rulesets.Osu/OsuRuleset.cs b/osu.Game.Rulesets.Osu/OsuRuleset.cs
index f4a93a571d..947ecaae82 100644
--- a/osu.Game.Rulesets.Osu/OsuRuleset.cs
+++ b/osu.Game.Rulesets.Osu/OsuRuleset.cs
@@ -192,6 +192,7 @@ namespace osu.Game.Rulesets.Osu
                         new OsuModBarrelRoll(),
                         new OsuModApproachDifferent(),
                         new OsuModMuted(),
+                        new OsuModGhost(),
                     };
 
                 case ModType.System:

From a10a7e790300b250b2e1235958d76a4160c9640d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 3 Oct 2021 18:44:23 +0200
Subject: [PATCH 0235/5547] Refresh nub/slider appearance and use overlay
 theming

---
 osu.Game/Graphics/UserInterface/Nub.cs        | 24 +++---
 .../Graphics/UserInterface/OsuSliderBar.cs    | 86 ++++++++++++-------
 2 files changed, 68 insertions(+), 42 deletions(-)

diff --git a/osu.Game/Graphics/UserInterface/Nub.cs b/osu.Game/Graphics/UserInterface/Nub.cs
index 6807d007bb..7f504fcae3 100644
--- a/osu.Game/Graphics/UserInterface/Nub.cs
+++ b/osu.Game/Graphics/UserInterface/Nub.cs
@@ -2,6 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
+using JetBrains.Annotations;
 using osuTK;
 using osuTK.Graphics;
 using osu.Framework.Allocation;
@@ -12,13 +13,16 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Effects;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Graphics.UserInterface;
+using osu.Game.Overlays;
 
 namespace osu.Game.Graphics.UserInterface
 {
     public class Nub : CircularContainer, IHasCurrentValue<bool>, IHasAccentColour
     {
-        public const float COLLAPSED_SIZE = 20;
-        public const float EXPANDED_SIZE = 40;
+        public const float HEIGHT = 15;
+
+        public const float COLLAPSED_SIZE = 30;
+        public const float EXPANDED_SIZE = 50;
 
         private const float border_width = 3;
 
@@ -29,7 +33,7 @@ namespace osu.Game.Graphics.UserInterface
         {
             Box fill;
 
-            Size = new Vector2(COLLAPSED_SIZE, 12);
+            Size = new Vector2(COLLAPSED_SIZE, HEIGHT);
 
             BorderColour = Color4.White;
             BorderThickness = border_width;
@@ -53,12 +57,12 @@ namespace osu.Game.Graphics.UserInterface
             };
         }
 
-        [BackgroundDependencyLoader]
-        private void load(OsuColour colours)
+        [BackgroundDependencyLoader(true)]
+        private void load([CanBeNull] OverlayColourProvider colourProvider, OsuColour colours)
         {
-            AccentColour = colours.Pink;
-            GlowingAccentColour = colours.PinkLighter;
-            GlowColour = colours.PinkDarker;
+            AccentColour = colourProvider?.Highlight1 ?? colours.Pink;
+            GlowingAccentColour = colourProvider?.Highlight1.Lighten(0.2f) ?? colours.PinkLighter;
+            GlowColour = colourProvider?.Dark3 ?? colours.PinkDarker;
 
             EdgeEffect = new EdgeEffectParameters
             {
@@ -96,9 +100,9 @@ namespace osu.Game.Graphics.UserInterface
             set
             {
                 if (value)
-                    this.ResizeTo(new Vector2(EXPANDED_SIZE, 12), animate_in_duration, Easing.OutQuint);
+                    this.ResizeTo(new Vector2(EXPANDED_SIZE, HEIGHT), animate_in_duration, Easing.OutQuint);
                 else
-                    this.ResizeTo(new Vector2(COLLAPSED_SIZE, 12), animate_out_duration, Easing.OutQuint);
+                    this.ResizeTo(new Vector2(COLLAPSED_SIZE, HEIGHT), animate_out_duration, Easing.OutQuint);
             }
         }
 
diff --git a/osu.Game/Graphics/UserInterface/OsuSliderBar.cs b/osu.Game/Graphics/UserInterface/OsuSliderBar.cs
index f85f9327fa..9f98206967 100644
--- a/osu.Game/Graphics/UserInterface/OsuSliderBar.cs
+++ b/osu.Game/Graphics/UserInterface/OsuSliderBar.cs
@@ -3,11 +3,13 @@
 
 using System;
 using System.Globalization;
+using JetBrains.Annotations;
 using osuTK;
 using osuTK.Graphics;
 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.Containers;
 using osu.Framework.Graphics.UserInterface;
@@ -16,6 +18,7 @@ using osu.Framework.Graphics.Shapes;
 using osu.Framework.Input.Events;
 using osu.Framework.Localisation;
 using osu.Framework.Utils;
+using osu.Game.Overlays;
 
 namespace osu.Game.Graphics.UserInterface
 {
@@ -52,34 +55,63 @@ namespace osu.Game.Graphics.UserInterface
             {
                 accentColour = value;
                 leftBox.Colour = value;
+            }
+        }
+
+        private Colour4 backgroundColour;
+
+        public Color4 BackgroundColour
+        {
+            get => backgroundColour;
+            set
+            {
+                backgroundColour = value;
                 rightBox.Colour = value;
             }
         }
 
         public OsuSliderBar()
         {
-            Height = 12;
-            RangePadding = 20;
+            Height = Nub.HEIGHT;
+            RangePadding = Nub.EXPANDED_SIZE / 2;
             Children = new Drawable[]
             {
-                leftBox = new Box
+                new Container
                 {
-                    Height = 2,
-                    EdgeSmoothness = new Vector2(0, 0.5f),
-                    Position = new Vector2(2, 0),
-                    RelativeSizeAxes = Axes.None,
+                    RelativeSizeAxes = Axes.X,
+                    AutoSizeAxes = Axes.Y,
                     Anchor = Anchor.CentreLeft,
                     Origin = Anchor.CentreLeft,
-                },
-                rightBox = new Box
-                {
-                    Height = 2,
-                    EdgeSmoothness = new Vector2(0, 0.5f),
-                    Position = new Vector2(-2, 0),
-                    RelativeSizeAxes = Axes.None,
-                    Anchor = Anchor.CentreRight,
-                    Origin = Anchor.CentreRight,
-                    Alpha = 0.5f,
+                    Padding = new MarginPadding { Horizontal = 2 },
+                    Child = new CircularContainer
+                    {
+                        RelativeSizeAxes = Axes.X,
+                        AutoSizeAxes = Axes.Y,
+                        Anchor = Anchor.CentreLeft,
+                        Origin = Anchor.CentreLeft,
+                        Masking = true,
+                        CornerRadius = 5f,
+                        Children = new Drawable[]
+                        {
+                            leftBox = new Box
+                            {
+                                Height = 5,
+                                EdgeSmoothness = new Vector2(0, 0.5f),
+                                RelativeSizeAxes = Axes.None,
+                                Anchor = Anchor.CentreLeft,
+                                Origin = Anchor.CentreLeft,
+                            },
+                            rightBox = new Box
+                            {
+                                Height = 5,
+                                EdgeSmoothness = new Vector2(0, 0.5f),
+                                RelativeSizeAxes = Axes.None,
+                                Anchor = Anchor.CentreRight,
+                                Origin = Anchor.CentreRight,
+                                Alpha = 0.5f,
+                            },
+                        },
+                    },
                 },
                 nubContainer = new Container
                 {
@@ -89,6 +121,7 @@ namespace osu.Game.Graphics.UserInterface
                         Origin = Anchor.TopCentre,
                         RelativePositionAxes = Axes.X,
                         Expanded = true,
+                        Current = { Value = true }
                     },
                 },
                 new HoverClickSounds()
@@ -97,11 +130,12 @@ namespace osu.Game.Graphics.UserInterface
             Current.DisabledChanged += disabled => { Alpha = disabled ? 0.3f : 1; };
         }
 
-        [BackgroundDependencyLoader]
-        private void load(AudioManager audio, OsuColour colours)
+        [BackgroundDependencyLoader(true)]
+        private void load(AudioManager audio, [CanBeNull] OverlayColourProvider colourProvider, OsuColour colours)
         {
             sample = audio.Samples.Get(@"UI/notch-tick");
-            AccentColour = colours.Pink;
+            AccentColour = colourProvider?.Highlight1 ?? colours.Pink;
+            BackgroundColour = colourProvider?.Background5 ?? colours.Pink.Opacity(0.5f);
         }
 
         protected override void Update()
@@ -129,18 +163,6 @@ namespace osu.Game.Graphics.UserInterface
             base.OnHoverLost(e);
         }
 
-        protected override bool OnMouseDown(MouseDownEvent e)
-        {
-            Nub.Current.Value = true;
-            return base.OnMouseDown(e);
-        }
-
-        protected override void OnMouseUp(MouseUpEvent e)
-        {
-            Nub.Current.Value = false;
-            base.OnMouseUp(e);
-        }
-
         protected override void OnUserChange(T value)
         {
             base.OnUserChange(value);

From ed2f9dd4432fb1dbe17b6524f69fe3780c3b0919 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 10 Oct 2021 19:54:38 +0200
Subject: [PATCH 0236/5547] Adjust settings slider spacings

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

diff --git a/osu.Game/Overlays/Settings/SettingsSlider.cs b/osu.Game/Overlays/Settings/SettingsSlider.cs
index 9fc3379b94..bb9c0dd4d7 100644
--- a/osu.Game/Overlays/Settings/SettingsSlider.cs
+++ b/osu.Game/Overlays/Settings/SettingsSlider.cs
@@ -19,7 +19,7 @@ namespace osu.Game.Overlays.Settings
     {
         protected override Drawable CreateControl() => new TSlider
         {
-            Margin = new MarginPadding { Top = 5, Bottom = 5 },
+            Margin = new MarginPadding { Vertical = 10 },
             RelativeSizeAxes = Axes.X
         };
 

From 23b50a054beaa41a03c09cb1c6223f85156dafb4 Mon Sep 17 00:00:00 2001
From: Jason Won <jasonwon628@gmail.com>
Date: Thu, 14 Oct 2021 20:50:47 -0400
Subject: [PATCH 0237/5547] address comments

---
 osu.Game.Rulesets.Osu/Mods/OsuModGhost.cs | 36 ++++++++++++++---------
 1 file changed, 22 insertions(+), 14 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModGhost.cs b/osu.Game.Rulesets.Osu/Mods/OsuModGhost.cs
index d371686d10..7cb9fadf03 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModGhost.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModGhost.cs
@@ -3,10 +3,10 @@
 
 using osu.Game.Rulesets.UI;
 using osu.Game.Rulesets.Mods;
-using osu.Framework.Graphics;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Bindables;
 using osu.Framework.Localisation;
+using osu.Framework.Utils;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Configuration;
 using osu.Game.Overlays.Settings;
@@ -17,14 +17,18 @@ namespace osu.Game.Rulesets.Osu.Mods
 {
     public class OsuModGhost : Mod, IUpdatableByPlayfield, IApplicableToScoreProcessor
     {
+        public const float CURSOR_ALPHA_TRANSITION_DURATION = 100;
         public override string Name => "Ghost";
-        public override string Acronym => "G";
+        public override string Acronym => "GS";
         public override ModType Type => ModType.Fun;
         public override IconUsage? Icon => FontAwesome.Solid.Ghost;
         public override string Description => "Where's the cursor?";
         public override double ScoreMultiplier => 1;
-        
-        private readonly BindableNumber<float> ghostAlpha = new BindableFloat(0);
+        private double transitionProgress = 0;
+        private float currentCursorAlpha = 1;
+        private float startCursorAlpha = 1;
+        private float targetCursorAlpha = 0;
+
         private BindableNumber<int> currentCombo;
 
         [SettingSource(
@@ -43,21 +47,25 @@ namespace osu.Game.Rulesets.Osu.Mods
         public ScoreRank AdjustRank(ScoreRank rank, double accuracy) => rank;
         public void ApplyToScoreProcessor(ScoreProcessor scoreProcessor)
         {
-            currentCombo = scoreProcessor.Combo.GetBoundCopy();
-            currentCombo.BindValueChanged(combo =>
-            {
-                float dimFactor = HiddenComboCount.Value == 0 ? 1 : (float)combo.NewValue / HiddenComboCount.Value;
-
-                scoreProcessor.TransformBindableTo(ghostAlpha, 1-dimFactor, 100, Easing.OutQuint);
-            }, true);
+            if (HiddenComboCount.Value != 0) {
+                currentCombo = scoreProcessor.Combo.GetBoundCopy();
+                currentCombo.BindValueChanged(combo =>
+                {
+                    targetCursorAlpha = 1 - (float)combo.NewValue / HiddenComboCount.Value;
+                    startCursorAlpha = currentCursorAlpha;
+                    transitionProgress = 0;
+                }, true);
+            }
         }
 
-
         public virtual void Update(Playfield playfield)
         {
-            playfield.Cursor.Alpha = ghostAlpha.Value;
+            if (transitionProgress < CURSOR_ALPHA_TRANSITION_DURATION) {
+                transitionProgress += playfield.Time.Elapsed;
+                currentCursorAlpha = (float)Interpolation.Lerp(startCursorAlpha, targetCursorAlpha, transitionProgress/CURSOR_ALPHA_TRANSITION_DURATION);
+                playfield.Cursor.Alpha = currentCursorAlpha;
+            }
         }
-        
     }
 
     public class HiddenComboSlider : OsuSliderBar<int>

From 02d29097a23300b19d6b8174285a00fd845176a1 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 15 Oct 2021 11:14:03 +0900
Subject: [PATCH 0238/5547] Switch away from metadata screen before making any
 changes in test logic

---
 osu.Game.Tests/Visual/Editing/TestSceneEditorSaving.cs | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneEditorSaving.cs b/osu.Game.Tests/Visual/Editing/TestSceneEditorSaving.cs
index 49136e6019..ab2bc4649a 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneEditorSaving.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneEditorSaving.cs
@@ -35,6 +35,11 @@ namespace osu.Game.Tests.Visual.Editing
 
             AddUntilStep("wait for metadata screen load", () => editor.ChildrenOfType<MetadataSection>().FirstOrDefault()?.IsLoaded == true);
 
+            // We intentionally switch away from the metadata screen, else there is a feedback loop with the textbox handling which causes metadata changes below to get overwritten.
+
+            AddStep("Enter compose mode", () => InputManager.Key(Key.F1));
+            AddUntilStep("Wait for compose mode load", () => editor.ChildrenOfType<HitObjectComposer>().FirstOrDefault()?.IsLoaded == true);
+
             AddStep("Set overall difficulty", () => editorBeatmap.Difficulty.OverallDifficulty = 7);
             AddStep("Set artist and title", () =>
             {
@@ -45,9 +50,6 @@ namespace osu.Game.Tests.Visual.Editing
 
             AddStep("Add timing point", () => editorBeatmap.ControlPointInfo.Add(0, new TimingControlPoint()));
 
-            AddStep("Enter compose mode", () => InputManager.Key(Key.F1));
-            AddUntilStep("Wait for compose mode load", () => editor.ChildrenOfType<HitObjectComposer>().FirstOrDefault()?.IsLoaded == true);
-
             AddStep("Change to placement mode", () => InputManager.Key(Key.Number2));
             AddStep("Move to playfield", () => InputManager.MoveMouseTo(Game.ScreenSpaceDrawQuad.Centre));
             AddStep("Place single hitcircle", () => InputManager.Click(MouseButton.Left));

From b15137ecdc1eb29f4e4e56c844e3f7e5646bd31d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 15 Oct 2021 11:48:08 +0900
Subject: [PATCH 0239/5547] Add test coverage of slider bars with colour
 provider applied

---
 .../TestSceneLabelledSliderBar.cs             | 60 +++++++++++++++----
 1 file changed, 49 insertions(+), 11 deletions(-)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneLabelledSliderBar.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneLabelledSliderBar.cs
index 393420e700..1b7f65f9a0 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneLabelledSliderBar.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneLabelledSliderBar.cs
@@ -1,11 +1,15 @@
 // 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.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Graphics.UserInterfaceV2;
+using osu.Game.Overlays;
 
 namespace osu.Game.Tests.Visual.UserInterface
 {
@@ -19,28 +23,62 @@ namespace osu.Game.Tests.Visual.UserInterface
         {
             AddStep("create component", () =>
             {
-                LabelledSliderBar<double> component;
+                FillFlowContainer flow;
 
-                Child = new Container
+                Child = flow = new FillFlowContainer
                 {
                     Anchor = Anchor.Centre,
                     Origin = Anchor.Centre,
                     Width = 500,
                     AutoSizeAxes = Axes.Y,
-                    Child = component = new LabelledSliderBar<double>
+                    Direction = FillDirection.Vertical,
+                    Children = new Drawable[]
                     {
-                        Current = new BindableDouble(5)
+                        new LabelledSliderBar<double>
                         {
-                            MinValue = 0,
-                            MaxValue = 10,
-                            Precision = 1,
-                        }
-                    }
+                            Current = new BindableDouble(5)
+                            {
+                                MinValue = 0,
+                                MaxValue = 10,
+                                Precision = 1,
+                            },
+                            Label = "a sample component",
+                            Description = hasDescription ? "this text describes the component" : string.Empty,
+                        },
+                    },
                 };
 
-                component.Label = "a sample component";
-                component.Description = hasDescription ? "this text describes the component" : string.Empty;
+                foreach (var colour in Enum.GetValues(typeof(OverlayColourScheme)).OfType<OverlayColourScheme>())
+                {
+                    flow.Add(new OverlayColourContainer(colour)
+                    {
+                        RelativeSizeAxes = Axes.X,
+                        AutoSizeAxes = Axes.Y,
+                        Child = new LabelledSliderBar<double>
+                        {
+                            Current = new BindableDouble(5)
+                            {
+                                MinValue = 0,
+                                MaxValue = 10,
+                                Precision = 1,
+                            },
+                            Label = "a sample component",
+                            Description = hasDescription ? "this text describes the component" : string.Empty,
+                        }
+                    });
+                }
             });
         }
+
+        private class OverlayColourContainer : Container
+        {
+            [Cached]
+            private OverlayColourProvider colourProvider;
+
+            public OverlayColourContainer(OverlayColourScheme scheme)
+            {
+                colourProvider = new OverlayColourProvider(scheme);
+            }
+        }
     }
 }

From be3b88a5c3ca733f636b1f090cc1589172f67da3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 15 Oct 2021 11:48:19 +0900
Subject: [PATCH 0240/5547] Adjust glow to look good

---
 osu.Game/Graphics/UserInterface/Nub.cs | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Graphics/UserInterface/Nub.cs b/osu.Game/Graphics/UserInterface/Nub.cs
index 7f504fcae3..93da312e64 100644
--- a/osu.Game/Graphics/UserInterface/Nub.cs
+++ b/osu.Game/Graphics/UserInterface/Nub.cs
@@ -26,7 +26,7 @@ namespace osu.Game.Graphics.UserInterface
 
         private const float border_width = 3;
 
-        private const double animate_in_duration = 150;
+        private const double animate_in_duration = 200;
         private const double animate_out_duration = 500;
 
         public Nub()
@@ -62,14 +62,14 @@ namespace osu.Game.Graphics.UserInterface
         {
             AccentColour = colourProvider?.Highlight1 ?? colours.Pink;
             GlowingAccentColour = colourProvider?.Highlight1.Lighten(0.2f) ?? colours.PinkLighter;
-            GlowColour = colourProvider?.Dark3 ?? colours.PinkDarker;
+            GlowColour = colourProvider?.Light4 ?? colours.PinkDarker;
 
             EdgeEffect = new EdgeEffectParameters
             {
                 Colour = GlowColour.Opacity(0),
                 Type = EdgeEffectType.Glow,
                 Radius = 10,
-                Roundness = 8,
+                Roundness = 10,
             };
         }
 
@@ -85,7 +85,7 @@ namespace osu.Game.Graphics.UserInterface
                 if (value)
                 {
                     this.FadeColour(GlowingAccentColour, animate_in_duration, Easing.OutQuint);
-                    FadeEdgeEffectTo(1, animate_in_duration, Easing.OutQuint);
+                    FadeEdgeEffectTo(0.6f, animate_in_duration, Easing.OutQuint);
                 }
                 else
                 {

From 35d776078c3e8124f36e93fcdc8af64ea8287668 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 15 Oct 2021 11:51:08 +0900
Subject: [PATCH 0241/5547] Ensure sliderbar nub stays glowing while dragging
 an adjustment

---
 osu.Game/Graphics/UserInterface/OsuSliderBar.cs | 15 +++++++++++++--
 1 file changed, 13 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Graphics/UserInterface/OsuSliderBar.cs b/osu.Game/Graphics/UserInterface/OsuSliderBar.cs
index 9f98206967..d49e2610c8 100644
--- a/osu.Game/Graphics/UserInterface/OsuSliderBar.cs
+++ b/osu.Game/Graphics/UserInterface/OsuSliderBar.cs
@@ -153,16 +153,27 @@ namespace osu.Game.Graphics.UserInterface
 
         protected override bool OnHover(HoverEvent e)
         {
-            Nub.Glowing = true;
+            updateGlow();
             return base.OnHover(e);
         }
 
         protected override void OnHoverLost(HoverLostEvent e)
         {
-            Nub.Glowing = false;
+            updateGlow();
             base.OnHoverLost(e);
         }
 
+        protected override void OnDragEnd(DragEndEvent e)
+        {
+            updateGlow();
+            base.OnDragEnd(e);
+        }
+
+        private void updateGlow()
+        {
+            Nub.Glowing = IsHovered || IsDragged;
+        }
+
         protected override void OnUserChange(T value)
         {
             base.OnUserChange(value);

From ec5c967e71343396224e9769ef21126b91d581fa Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 15 Oct 2021 11:54:07 +0900
Subject: [PATCH 0242/5547] Add test coverage of `SettingsCheckbox`

---
 .../TestSceneSettingsCheckbox.cs              | 68 +++++++++++++++++++
 1 file changed, 68 insertions(+)
 create mode 100644 osu.Game.Tests/Visual/UserInterface/TestSceneSettingsCheckbox.cs

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneSettingsCheckbox.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneSettingsCheckbox.cs
new file mode 100644
index 0000000000..fb04c5bad0
--- /dev/null
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneSettingsCheckbox.cs
@@ -0,0 +1,68 @@
+// 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.Allocation;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
+using osu.Game.Overlays;
+using osu.Game.Overlays.Settings;
+using osuTK;
+
+namespace osu.Game.Tests.Visual.UserInterface
+{
+    public class TestSceneSettingsCheckbox : OsuTestScene
+    {
+        [TestCase]
+        public void TestCheckbox()
+        {
+            AddStep("create component", () =>
+            {
+                FillFlowContainer flow;
+
+                Child = flow = new FillFlowContainer
+                {
+                    Anchor = Anchor.Centre,
+                    Origin = Anchor.Centre,
+                    Width = 500,
+                    AutoSizeAxes = Axes.Y,
+                    Spacing = new Vector2(5),
+                    Direction = FillDirection.Vertical,
+                    Children = new Drawable[]
+                    {
+                        new SettingsCheckbox
+                        {
+                            LabelText = "a sample component",
+                        },
+                    },
+                };
+
+                foreach (var colour1 in Enum.GetValues(typeof(OverlayColourScheme)).OfType<OverlayColourScheme>())
+                {
+                    flow.Add(new OverlayColourContainer(colour1)
+                    {
+                        RelativeSizeAxes = Axes.X,
+                        AutoSizeAxes = Axes.Y,
+                        Child = new SettingsCheckbox
+                        {
+                            LabelText = "a sample component",
+                        }
+                    });
+                }
+            });
+        }
+
+        private class OverlayColourContainer : Container
+        {
+            [Cached]
+            private OverlayColourProvider colourProvider;
+
+            public OverlayColourContainer(OverlayColourScheme scheme)
+            {
+                colourProvider = new OverlayColourProvider(scheme);
+            }
+        }
+    }
+}

From e1ac5fbed901ad3a03cb1c91b7fc0025b2fd6037 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 15 Oct 2021 12:13:42 +0900
Subject: [PATCH 0243/5547] Remove externally exposed `Expanded` state and
 change behaviour and visuals surrounding it

---
 osu.Game/Graphics/UserInterface/Nub.cs        | 87 ++++++++++---------
 .../Graphics/UserInterface/OsuCheckbox.cs     |  7 --
 .../Graphics/UserInterface/OsuSliderBar.cs    |  1 -
 3 files changed, 48 insertions(+), 47 deletions(-)

diff --git a/osu.Game/Graphics/UserInterface/Nub.cs b/osu.Game/Graphics/UserInterface/Nub.cs
index 93da312e64..3b39c7cf7f 100644
--- a/osu.Game/Graphics/UserInterface/Nub.cs
+++ b/osu.Game/Graphics/UserInterface/Nub.cs
@@ -17,11 +17,10 @@ using osu.Game.Overlays;
 
 namespace osu.Game.Graphics.UserInterface
 {
-    public class Nub : CircularContainer, IHasCurrentValue<bool>, IHasAccentColour
+    public class Nub : CompositeDrawable, IHasCurrentValue<bool>, IHasAccentColour
     {
         public const float HEIGHT = 15;
 
-        public const float COLLAPSED_SIZE = 30;
         public const float EXPANDED_SIZE = 50;
 
         private const float border_width = 3;
@@ -29,32 +28,34 @@ namespace osu.Game.Graphics.UserInterface
         private const double animate_in_duration = 200;
         private const double animate_out_duration = 500;
 
+        private readonly Box fill;
+        private readonly Container main;
+
         public Nub()
         {
-            Box fill;
+            Size = new Vector2(EXPANDED_SIZE, HEIGHT);
 
-            Size = new Vector2(COLLAPSED_SIZE, HEIGHT);
-
-            BorderColour = Color4.White;
-            BorderThickness = border_width;
-
-            Masking = true;
-
-            Children = new[]
+            InternalChildren = new[]
             {
-                fill = new Box
+                main = new CircularContainer
                 {
+                    BorderColour = Color4.White,
+                    BorderThickness = border_width,
+                    Masking = true,
                     RelativeSizeAxes = Axes.Both,
-                    Alpha = 0,
-                    AlwaysPresent = true,
+                    Anchor = Anchor.TopCentre,
+                    Origin = Anchor.TopCentre,
+                    Children = new Drawable[]
+                    {
+                        fill = new Box
+                        {
+                            RelativeSizeAxes = Axes.Both,
+                            Alpha = 0,
+                            AlwaysPresent = true,
+                        },
+                    }
                 },
             };
-
-            Current.ValueChanged += filled =>
-            {
-                fill.FadeTo(filled.NewValue ? 1 : 0, 200, Easing.OutQuint);
-                this.TransformTo(nameof(BorderThickness), filled.NewValue ? 8.5f : border_width, 200, Easing.OutQuint);
-            };
         }
 
         [BackgroundDependencyLoader(true)]
@@ -64,7 +65,7 @@ namespace osu.Game.Graphics.UserInterface
             GlowingAccentColour = colourProvider?.Highlight1.Lighten(0.2f) ?? colours.PinkLighter;
             GlowColour = colourProvider?.Light4 ?? colours.PinkDarker;
 
-            EdgeEffect = new EdgeEffectParameters
+            main.EdgeEffect = new EdgeEffectParameters
             {
                 Colour = GlowColour.Opacity(0),
                 Type = EdgeEffectType.Glow,
@@ -73,6 +74,13 @@ namespace osu.Game.Graphics.UserInterface
             };
         }
 
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            Current.BindValueChanged(onCurrentValueChanged, true);
+        }
+
         private bool glowing;
 
         public bool Glowing
@@ -84,28 +92,17 @@ namespace osu.Game.Graphics.UserInterface
 
                 if (value)
                 {
-                    this.FadeColour(GlowingAccentColour, animate_in_duration, Easing.OutQuint);
-                    FadeEdgeEffectTo(0.6f, animate_in_duration, Easing.OutQuint);
+                    main.FadeColour(GlowingAccentColour, animate_in_duration, Easing.OutQuint);
+                    main.FadeEdgeEffectTo(0.6f, animate_in_duration, Easing.OutQuint);
                 }
                 else
                 {
-                    FadeEdgeEffectTo(0, animate_out_duration);
-                    this.FadeColour(AccentColour, animate_out_duration);
+                    main.FadeEdgeEffectTo(0, animate_out_duration);
+                    main.FadeColour(AccentColour, animate_out_duration);
                 }
             }
         }
 
-        public bool Expanded
-        {
-            set
-            {
-                if (value)
-                    this.ResizeTo(new Vector2(EXPANDED_SIZE, HEIGHT), animate_in_duration, Easing.OutQuint);
-                else
-                    this.ResizeTo(new Vector2(COLLAPSED_SIZE, HEIGHT), animate_out_duration, Easing.OutQuint);
-            }
-        }
-
         private readonly Bindable<bool> current = new Bindable<bool>();
 
         public Bindable<bool> Current
@@ -130,7 +127,7 @@ namespace osu.Game.Graphics.UserInterface
             {
                 accentColour = value;
                 if (!Glowing)
-                    Colour = value;
+                    main.Colour = value;
             }
         }
 
@@ -143,7 +140,7 @@ namespace osu.Game.Graphics.UserInterface
             {
                 glowingAccentColour = value;
                 if (Glowing)
-                    Colour = value;
+                    main.Colour = value;
             }
         }
 
@@ -158,8 +155,20 @@ namespace osu.Game.Graphics.UserInterface
 
                 var effect = EdgeEffect;
                 effect.Colour = Glowing ? value : value.Opacity(0);
-                EdgeEffect = effect;
+                main.EdgeEffect = effect;
             }
         }
+
+        private void onCurrentValueChanged(ValueChangedEvent<bool> filled)
+        {
+            fill.FadeTo(filled.NewValue ? 1 : 0, 200, Easing.OutQuint);
+
+            if (filled.NewValue)
+                main.ResizeWidthTo(1, animate_in_duration, Easing.OutElasticHalf);
+            else
+                main.ResizeWidthTo(0.9f, animate_out_duration, Easing.OutElastic);
+
+            main.TransformTo(nameof(BorderThickness), filled.NewValue ? 8.5f : border_width, 200, Easing.OutQuint);
+        }
     }
 }
diff --git a/osu.Game/Graphics/UserInterface/OsuCheckbox.cs b/osu.Game/Graphics/UserInterface/OsuCheckbox.cs
index 5f2d884cd7..e8f80dec57 100644
--- a/osu.Game/Graphics/UserInterface/OsuCheckbox.cs
+++ b/osu.Game/Graphics/UserInterface/OsuCheckbox.cs
@@ -9,16 +9,11 @@ using osu.Framework.Graphics.Sprites;
 using osu.Framework.Graphics.UserInterface;
 using osu.Framework.Input.Events;
 using osu.Game.Graphics.Containers;
-using osuTK.Graphics;
 
 namespace osu.Game.Graphics.UserInterface
 {
     public class OsuCheckbox : Checkbox
     {
-        public Color4 CheckedColor { get; set; } = Color4.Cyan;
-        public Color4 UncheckedColor { get; set; } = Color4.White;
-        public int FadeDuration { get; set; }
-
         /// <summary>
         /// Whether to play sounds when the state changes as a result of user interaction.
         /// </summary>
@@ -104,14 +99,12 @@ namespace osu.Game.Graphics.UserInterface
         protected override bool OnHover(HoverEvent e)
         {
             Nub.Glowing = true;
-            Nub.Expanded = true;
             return base.OnHover(e);
         }
 
         protected override void OnHoverLost(HoverLostEvent e)
         {
             Nub.Glowing = false;
-            Nub.Expanded = false;
             base.OnHoverLost(e);
         }
 
diff --git a/osu.Game/Graphics/UserInterface/OsuSliderBar.cs b/osu.Game/Graphics/UserInterface/OsuSliderBar.cs
index d49e2610c8..6963f7335e 100644
--- a/osu.Game/Graphics/UserInterface/OsuSliderBar.cs
+++ b/osu.Game/Graphics/UserInterface/OsuSliderBar.cs
@@ -120,7 +120,6 @@ namespace osu.Game.Graphics.UserInterface
                     {
                         Origin = Anchor.TopCentre,
                         RelativePositionAxes = Axes.X,
-                        Expanded = true,
                         Current = { Value = true }
                     },
                 },

From 2dfc42dd53ed48e187a94c2c0fcd34c867948566 Mon Sep 17 00:00:00 2001
From: Jason Won <jasonwon628@gmail.com>
Date: Thu, 14 Oct 2021 23:34:43 -0400
Subject: [PATCH 0244/5547] revert interpolation changes + fix cursor trail

---
 osu.Game.Rulesets.Osu/Mods/OsuModGhost.cs | 24 +++++++++--------------
 1 file changed, 9 insertions(+), 15 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModGhost.cs b/osu.Game.Rulesets.Osu/Mods/OsuModGhost.cs
index 7cb9fadf03..cc8491876b 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModGhost.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModGhost.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.Game.Rulesets.UI;
 using osu.Game.Rulesets.Mods;
+using osu.Framework.Graphics;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Bindables;
 using osu.Framework.Localisation;
-using osu.Framework.Utils;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Configuration;
 using osu.Game.Overlays.Settings;
@@ -24,11 +25,7 @@ namespace osu.Game.Rulesets.Osu.Mods
         public override IconUsage? Icon => FontAwesome.Solid.Ghost;
         public override string Description => "Where's the cursor?";
         public override double ScoreMultiplier => 1;
-        private double transitionProgress = 0;
-        private float currentCursorAlpha = 1;
-        private float startCursorAlpha = 1;
-        private float targetCursorAlpha = 0;
-
+        private readonly BindableFloat cursorAlpha = new BindableFloat();
         private BindableNumber<int> currentCombo;
 
         [SettingSource(
@@ -45,26 +42,23 @@ namespace osu.Game.Rulesets.Osu.Mods
         };
 
         public ScoreRank AdjustRank(ScoreRank rank, double accuracy) => rank;
+
         public void ApplyToScoreProcessor(ScoreProcessor scoreProcessor)
         {
-            if (HiddenComboCount.Value != 0) {
+            if (HiddenComboCount.Value != 0)
+            {
                 currentCombo = scoreProcessor.Combo.GetBoundCopy();
                 currentCombo.BindValueChanged(combo =>
                 {
-                    targetCursorAlpha = 1 - (float)combo.NewValue / HiddenComboCount.Value;
-                    startCursorAlpha = currentCursorAlpha;
-                    transitionProgress = 0;
+                    float targetCursorAlpha = (float)Math.Max(1e-3, 1 - (float)combo.NewValue / HiddenComboCount.Value);
+                    scoreProcessor.TransformBindableTo(cursorAlpha, targetCursorAlpha, CURSOR_ALPHA_TRANSITION_DURATION, Easing.OutQuint);
                 }, true);
             }
         }
 
         public virtual void Update(Playfield playfield)
         {
-            if (transitionProgress < CURSOR_ALPHA_TRANSITION_DURATION) {
-                transitionProgress += playfield.Time.Elapsed;
-                currentCursorAlpha = (float)Interpolation.Lerp(startCursorAlpha, targetCursorAlpha, transitionProgress/CURSOR_ALPHA_TRANSITION_DURATION);
-                playfield.Cursor.Alpha = currentCursorAlpha;
-            }
+            playfield.Cursor.Alpha = cursorAlpha.Value;
         }
     }
 

From f73e505ee66d24117c6c37c1e19d01e117ac0669 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 15 Oct 2021 12:35:19 +0900
Subject: [PATCH 0245/5547] Further adjustments to glow to be less bright on
 settings overlay

---
 osu.Game/Graphics/UserInterface/Nub.cs             | 14 +++++++-------
 .../Screens/Play/PlayerSettings/PlayerCheckbox.cs  |  2 +-
 .../Screens/Play/PlayerSettings/PlayerSliderBar.cs |  2 +-
 3 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/osu.Game/Graphics/UserInterface/Nub.cs b/osu.Game/Graphics/UserInterface/Nub.cs
index 3b39c7cf7f..8f0fed580f 100644
--- a/osu.Game/Graphics/UserInterface/Nub.cs
+++ b/osu.Game/Graphics/UserInterface/Nub.cs
@@ -63,14 +63,14 @@ namespace osu.Game.Graphics.UserInterface
         {
             AccentColour = colourProvider?.Highlight1 ?? colours.Pink;
             GlowingAccentColour = colourProvider?.Highlight1.Lighten(0.2f) ?? colours.PinkLighter;
-            GlowColour = colourProvider?.Light4 ?? colours.PinkDarker;
+            GlowColour = colourProvider?.Highlight1 ?? colours.PinkLighter;
 
             main.EdgeEffect = new EdgeEffectParameters
             {
                 Colour = GlowColour.Opacity(0),
                 Type = EdgeEffectType.Glow,
-                Radius = 10,
-                Roundness = 10,
+                Radius = 8,
+                Roundness = 5,
             };
         }
 
@@ -93,12 +93,12 @@ namespace osu.Game.Graphics.UserInterface
                 if (value)
                 {
                     main.FadeColour(GlowingAccentColour, animate_in_duration, Easing.OutQuint);
-                    main.FadeEdgeEffectTo(0.6f, animate_in_duration, Easing.OutQuint);
+                    main.FadeEdgeEffectTo(0.2f, animate_in_duration, Easing.OutQuint);
                 }
                 else
                 {
-                    main.FadeEdgeEffectTo(0, animate_out_duration);
-                    main.FadeColour(AccentColour, animate_out_duration);
+                    main.FadeEdgeEffectTo(0, animate_out_duration, Easing.OutQuint);
+                    main.FadeColour(AccentColour, animate_out_duration, Easing.OutQuint);
                 }
             }
         }
@@ -153,7 +153,7 @@ namespace osu.Game.Graphics.UserInterface
             {
                 glowColour = value;
 
-                var effect = EdgeEffect;
+                var effect = main.EdgeEffect;
                 effect.Colour = Glowing ? value : value.Opacity(0);
                 main.EdgeEffect = effect;
             }
diff --git a/osu.Game/Screens/Play/PlayerSettings/PlayerCheckbox.cs b/osu.Game/Screens/Play/PlayerSettings/PlayerCheckbox.cs
index 8a4acacb24..26887327cd 100644
--- a/osu.Game/Screens/Play/PlayerSettings/PlayerCheckbox.cs
+++ b/osu.Game/Screens/Play/PlayerSettings/PlayerCheckbox.cs
@@ -14,7 +14,7 @@ namespace osu.Game.Screens.Play.PlayerSettings
         {
             Nub.AccentColour = colours.Yellow;
             Nub.GlowingAccentColour = colours.YellowLighter;
-            Nub.GlowColour = colours.YellowDarker;
+            Nub.GlowColour = colours.YellowDark;
         }
     }
 }
diff --git a/osu.Game/Screens/Play/PlayerSettings/PlayerSliderBar.cs b/osu.Game/Screens/Play/PlayerSettings/PlayerSliderBar.cs
index c8e281195a..216e46d429 100644
--- a/osu.Game/Screens/Play/PlayerSettings/PlayerSliderBar.cs
+++ b/osu.Game/Screens/Play/PlayerSettings/PlayerSliderBar.cs
@@ -29,7 +29,7 @@ namespace osu.Game.Screens.Play.PlayerSettings
                 AccentColour = colours.Yellow;
                 Nub.AccentColour = colours.Yellow;
                 Nub.GlowingAccentColour = colours.YellowLighter;
-                Nub.GlowColour = colours.YellowDarker;
+                Nub.GlowColour = colours.YellowDark;
             }
         }
     }

From 7ab028576ed581073f338eb1abaa11c58620a2cb Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 15 Oct 2021 12:54:19 +0900
Subject: [PATCH 0246/5547] Change `RoundedButton` to source from overlay
 colour provider

---
 osu.Game/Graphics/UserInterfaceV2/RoundedButton.cs | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Graphics/UserInterfaceV2/RoundedButton.cs b/osu.Game/Graphics/UserInterfaceV2/RoundedButton.cs
index 27e28f1e03..23ebc6e98d 100644
--- a/osu.Game/Graphics/UserInterfaceV2/RoundedButton.cs
+++ b/osu.Game/Graphics/UserInterfaceV2/RoundedButton.cs
@@ -2,10 +2,12 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System.Collections.Generic;
+using JetBrains.Annotations;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Graphics.UserInterface;
+using osu.Game.Overlays;
 
 namespace osu.Game.Graphics.UserInterfaceV2
 {
@@ -23,10 +25,10 @@ namespace osu.Game.Graphics.UserInterfaceV2
             }
         }
 
-        [BackgroundDependencyLoader]
-        private void load(OsuColour colours)
+        [BackgroundDependencyLoader(true)]
+        private void load([CanBeNull] OverlayColourProvider overlayColourProvider, OsuColour colours)
         {
-            BackgroundColour = colours.Blue3;
+            BackgroundColour = overlayColourProvider?.Highlight1 ?? colours.Blue3;
         }
 
         protected override void LoadComplete()

From 538d980072aa746519f8e98121f2b2e72d8e75d4 Mon Sep 17 00:00:00 2001
From: Jason Won <jasonwon628@gmail.com>
Date: Fri, 15 Oct 2021 00:22:57 -0400
Subject: [PATCH 0247/5547] Rename Mod

---
 .../Mods/{OsuModGhost.cs => OsuModNoScope.cs}             | 8 ++++----
 osu.Game.Rulesets.Osu/OsuRuleset.cs                       | 2 +-
 2 files changed, 5 insertions(+), 5 deletions(-)
 rename osu.Game.Rulesets.Osu/Mods/{OsuModGhost.cs => OsuModNoScope.cs} (90%)

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModGhost.cs b/osu.Game.Rulesets.Osu/Mods/OsuModNoScope.cs
similarity index 90%
rename from osu.Game.Rulesets.Osu/Mods/OsuModGhost.cs
rename to osu.Game.Rulesets.Osu/Mods/OsuModNoScope.cs
index cc8491876b..56c807eacd 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModGhost.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModNoScope.cs
@@ -16,13 +16,13 @@ using osu.Game.Scoring;
 
 namespace osu.Game.Rulesets.Osu.Mods
 {
-    public class OsuModGhost : Mod, IUpdatableByPlayfield, IApplicableToScoreProcessor
+    public class OsuModNoScope : Mod, IUpdatableByPlayfield, IApplicableToScoreProcessor
     {
         public const float CURSOR_ALPHA_TRANSITION_DURATION = 100;
-        public override string Name => "Ghost";
-        public override string Acronym => "GS";
+        public override string Name => "No Scope";
+        public override string Acronym => "NS";
         public override ModType Type => ModType.Fun;
-        public override IconUsage? Icon => FontAwesome.Solid.Ghost;
+        public override IconUsage? Icon => FontAwesome.Solid.EyeSlash;
         public override string Description => "Where's the cursor?";
         public override double ScoreMultiplier => 1;
         private readonly BindableFloat cursorAlpha = new BindableFloat();
diff --git a/osu.Game.Rulesets.Osu/OsuRuleset.cs b/osu.Game.Rulesets.Osu/OsuRuleset.cs
index 947ecaae82..ee4712c3b8 100644
--- a/osu.Game.Rulesets.Osu/OsuRuleset.cs
+++ b/osu.Game.Rulesets.Osu/OsuRuleset.cs
@@ -192,7 +192,7 @@ namespace osu.Game.Rulesets.Osu
                         new OsuModBarrelRoll(),
                         new OsuModApproachDifferent(),
                         new OsuModMuted(),
-                        new OsuModGhost(),
+                        new OsuModNoScope(),
                     };
 
                 case ModType.System:

From c9d8645341ac3f68d2696427b62cd4c8fd1fe63e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 15 Oct 2021 13:26:31 +0900
Subject: [PATCH 0248/5547] Fix startup import test waiting on potentially
 incorrect notification type

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

diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneStartupImport.cs b/osu.Game.Tests/Visual/Navigation/TestSceneStartupImport.cs
index cb7c334656..bd723eeed6 100644
--- a/osu.Game.Tests/Visual/Navigation/TestSceneStartupImport.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneStartupImport.cs
@@ -4,7 +4,7 @@
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Testing;
-using osu.Game.Database;
+using osu.Game.Overlays.Notifications;
 using osu.Game.Tests.Resources;
 
 namespace osu.Game.Tests.Visual.Navigation
@@ -25,7 +25,7 @@ namespace osu.Game.Tests.Visual.Navigation
         [Test]
         public void TestImportCreatedNotification()
         {
-            AddUntilStep("Import notification was presented", () => Game.Notifications.ChildrenOfType<ImportProgressNotification>().Count() == 1);
+            AddUntilStep("Import notification was presented", () => Game.Notifications.ChildrenOfType<ProgressCompletionNotification>().Count() == 1);
         }
     }
 }

From 80dfd11c90a635e18eaa8513700ad412f13acda5 Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Fri, 15 Oct 2021 13:27:54 +0900
Subject: [PATCH 0249/5547] Remove unnecessary extra task

Further testing shows continuations also run before the .Wait() returns.
---
 .../Online/Multiplayer/MultiplayerClient.cs   | 27 +++++++++----------
 1 file changed, 12 insertions(+), 15 deletions(-)

diff --git a/osu.Game/Online/Multiplayer/MultiplayerClient.cs b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
index 49a4526133..28505f6b0e 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
@@ -359,25 +359,22 @@ namespace osu.Game.Online.Multiplayer
             if (Room == null)
                 return;
 
-            await Task.Run(async () =>
+            await PopulateUser(user).ConfigureAwait(false);
+
+            Scheduler.Add(() =>
             {
-                await PopulateUser(user).ConfigureAwait(false);
+                if (Room == null)
+                    return;
 
-                Scheduler.Add(() =>
-                {
-                    if (Room == null)
-                        return;
+                // for sanity, ensure that there can be no duplicate users in the room user list.
+                if (Room.Users.Any(existing => existing.UserID == user.UserID))
+                    return;
 
-                    // for sanity, ensure that there can be no duplicate users in the room user list.
-                    if (Room.Users.Any(existing => existing.UserID == user.UserID))
-                        return;
+                Room.Users.Add(user);
 
-                    Room.Users.Add(user);
-
-                    UserJoined?.Invoke(user);
-                    RoomUpdated?.Invoke();
-                });
-            }).ConfigureAwait(false);
+                UserJoined?.Invoke(user);
+                RoomUpdated?.Invoke();
+            });
         }
 
         Task IMultiplayerClient.UserLeft(MultiplayerRoomUser user) =>

From e47ccbd08aa707d02b7b532bdbc5c0d99f366902 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 15 Oct 2021 13:50:25 +0900
Subject: [PATCH 0250/5547] Fix realm transactional overhead when rapidly
 changing `RulesetConfigManager` values

---
 .../Configuration/RulesetConfigManager.cs     | 24 +++++++++++++++++--
 1 file changed, 22 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Rulesets/Configuration/RulesetConfigManager.cs b/osu.Game/Rulesets/Configuration/RulesetConfigManager.cs
index a0ec8e3e0e..901efc3155 100644
--- a/osu.Game/Rulesets/Configuration/RulesetConfigManager.cs
+++ b/osu.Game/Rulesets/Configuration/RulesetConfigManager.cs
@@ -47,9 +47,28 @@ namespace osu.Game.Rulesets.Configuration
             }
         }
 
+        private readonly HashSet<TLookup> pendingWrites = new HashSet<TLookup>();
+
         protected override bool PerformSave()
         {
-            // do nothing, realm saves immediately
+            TLookup[] changed;
+
+            lock (pendingWrites)
+            {
+                changed = pendingWrites.ToArray();
+                pendingWrites.Clear();
+            }
+
+            realmFactory?.CreateContext().Write(realm =>
+            {
+                foreach (var c in changed)
+                {
+                    var setting = realm.All<RealmRulesetSetting>().First(s => s.RulesetID == rulesetId && s.Variant == variant && s.Key == c.ToString());
+
+                    setting.Value = ConfigStore[c].ToString();
+                }
+            });
+
             return true;
         }
 
@@ -80,7 +99,8 @@ namespace osu.Game.Rulesets.Configuration
 
             bindable.ValueChanged += b =>
             {
-                realmFactory?.Context.Write(() => setting.Value = b.NewValue.ToString());
+                lock (pendingWrites)
+                    pendingWrites.Add(lookup);
             };
         }
     }

From 818fac6ac8effd7f273c634fb1dd021550b7b4ff Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 15 Oct 2021 13:58:14 +0900
Subject: [PATCH 0251/5547] Make realm a non-drawable component to better order
 disposal

Until now, the `RealmContextFactory` would be disposed as part of the
drawable hierarchy. This is too early, as it may be being used by higher
level components (like `ConfigManager`s, see #15115) that perform final
operations after the drawables have been disposed.

Seems to make sense moving this out of the drawable hierarchy and in
line with how we were doing things with EF.
---
 osu.Game/Database/RealmContextFactory.cs | 24 +++++++++++++-----------
 osu.Game/OsuGameBase.cs                  |  3 +--
 2 files changed, 14 insertions(+), 13 deletions(-)

diff --git a/osu.Game/Database/RealmContextFactory.cs b/osu.Game/Database/RealmContextFactory.cs
index c3810eb441..82d51e365e 100644
--- a/osu.Game/Database/RealmContextFactory.cs
+++ b/osu.Game/Database/RealmContextFactory.cs
@@ -5,7 +5,6 @@ using System;
 using System.Threading;
 using osu.Framework.Allocation;
 using osu.Framework.Development;
-using osu.Framework.Graphics;
 using osu.Framework.Logging;
 using osu.Framework.Platform;
 using osu.Framework.Statistics;
@@ -18,7 +17,7 @@ namespace osu.Game.Database
     /// <summary>
     /// A factory which provides both the main (update thread bound) realm context and creates contexts for async usage.
     /// </summary>
-    public class RealmContextFactory : Component, IRealmFactory
+    public class RealmContextFactory : IDisposable, IRealmFactory
     {
         private readonly Storage storage;
 
@@ -79,10 +78,11 @@ namespace osu.Game.Database
         /// <returns></returns>
         public bool Compact() => Realm.Compact(getConfiguration());
 
-        protected override void Update()
+        /// <summary>
+        /// Perform a blocking refresh on the main realm context.
+        /// </summary>
+        public void Refresh()
         {
-            base.Update();
-
             lock (contextLock)
             {
                 if (context?.Refresh() == true)
@@ -92,7 +92,7 @@ namespace osu.Game.Database
 
         public Realm CreateContext()
         {
-            if (IsDisposed)
+            if (isDisposed)
                 throw new ObjectDisposedException(nameof(RealmContextFactory));
 
             try
@@ -132,7 +132,7 @@ namespace osu.Game.Database
         /// <returns>An <see cref="IDisposable"/> which should be disposed to end the blocking section.</returns>
         public IDisposable BlockAllOperations()
         {
-            if (IsDisposed)
+            if (isDisposed)
                 throw new ObjectDisposedException(nameof(RealmContextFactory));
 
             if (!ThreadSafety.IsUpdateThread)
@@ -176,21 +176,23 @@ namespace osu.Game.Database
             });
         }
 
-        protected override void Dispose(bool isDisposing)
+        private bool isDisposed;
+
+        public void Dispose()
         {
             lock (contextLock)
             {
                 context?.Dispose();
             }
 
-            if (!IsDisposed)
+            if (!isDisposed)
             {
                 // intentionally block context creation indefinitely. this ensures that nothing can start consuming a new context after disposal.
                 contextCreationLock.Wait();
                 contextCreationLock.Dispose();
-            }
 
-            base.Dispose(isDisposing);
+                isDisposed = true;
+            }
         }
     }
 }
diff --git a/osu.Game/OsuGameBase.cs b/osu.Game/OsuGameBase.cs
index 09eb482d16..f6ec22a536 100644
--- a/osu.Game/OsuGameBase.cs
+++ b/osu.Game/OsuGameBase.cs
@@ -187,8 +187,6 @@ namespace osu.Game
 
             dependencies.Cache(realmFactory = new RealmContextFactory(Storage, "client"));
 
-            AddInternal(realmFactory);
-
             dependencies.CacheAs(Storage);
 
             var largeStore = new LargeTextureStore(Host.CreateTextureLoaderStore(new NamespacedResourceStore<byte[]>(Resources, @"Textures")));
@@ -529,6 +527,7 @@ namespace osu.Game
             LocalConfig?.Dispose();
 
             contextFactory?.FlushConnections();
+            realmFactory?.Dispose();
         }
     }
 }

From e018a6d6a5a968e3d9a148996b6c2f59377f9433 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 15 Oct 2021 14:08:25 +0900
Subject: [PATCH 0252/5547] Attempt bumping `inspectcode` to fix remaining
 inspection

---
 .config/dotnet-tools.json            | 2 +-
 osu.Game/Stores/RealmRulesetStore.cs | 5 ++---
 2 files changed, 3 insertions(+), 4 deletions(-)

diff --git a/.config/dotnet-tools.json b/.config/dotnet-tools.json
index 007e4341b8..03b6308f97 100644
--- a/.config/dotnet-tools.json
+++ b/.config/dotnet-tools.json
@@ -9,7 +9,7 @@
       ]
     },
     "jetbrains.resharper.globaltools": {
-      "version": "2020.3.2",
+      "version": "2021.2.2",
       "commands": [
         "jb"
       ]
diff --git a/osu.Game/Stores/RealmRulesetStore.cs b/osu.Game/Stores/RealmRulesetStore.cs
index 51f059caad..1b298f9d49 100644
--- a/osu.Game/Stores/RealmRulesetStore.cs
+++ b/osu.Game/Stores/RealmRulesetStore.cs
@@ -106,9 +106,8 @@ namespace osu.Game.Stores
                 var rulesets = realm.All<RealmRuleset>();
 
                 List<Ruleset> instances = loadedAssemblies.Values
-                                                          .Select(r => Activator.CreateInstance(r) as Ruleset)
-                                                          .Where(r => r != null)
-                                                          .Cast<Ruleset>()
+                                                          .Select(Activator.CreateInstance)
+                                                          .OfType<Ruleset>()
                                                           .ToList();
 
                 // add all legacy rulesets first to ensure they have exclusive choice of primary key.

From 6a80a417bdc7f8520bcc76577d93629ec8a2991e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 15 Oct 2021 14:25:50 +0900
Subject: [PATCH 0253/5547] Use `Interpolation.Lerp` instead of transforms

Better handles cases where the combo may be changing faster than the
transition length.
---
 osu.Game.Rulesets.Osu/Mods/OsuModNoScope.cs | 27 +++++++++++++--------
 1 file changed, 17 insertions(+), 10 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModNoScope.cs b/osu.Game.Rulesets.Osu/Mods/OsuModNoScope.cs
index 56c807eacd..09870f2758 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModNoScope.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModNoScope.cs
@@ -8,6 +8,7 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Bindables;
 using osu.Framework.Localisation;
+using osu.Framework.Utils;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Configuration;
 using osu.Game.Overlays.Settings;
@@ -19,15 +20,18 @@ namespace osu.Game.Rulesets.Osu.Mods
     public class OsuModNoScope : Mod, IUpdatableByPlayfield, IApplicableToScoreProcessor
     {
         public const float CURSOR_ALPHA_TRANSITION_DURATION = 100;
+
         public override string Name => "No Scope";
         public override string Acronym => "NS";
         public override ModType Type => ModType.Fun;
         public override IconUsage? Icon => FontAwesome.Solid.EyeSlash;
         public override string Description => "Where's the cursor?";
         public override double ScoreMultiplier => 1;
-        private readonly BindableFloat cursorAlpha = new BindableFloat();
+
         private BindableNumber<int> currentCombo;
 
+        private float targetAlpha;
+
         [SettingSource(
             "Hidden at combo",
             "The combo count at which the cursor becomes completely hidden",
@@ -43,22 +47,25 @@ namespace osu.Game.Rulesets.Osu.Mods
 
         public ScoreRank AdjustRank(ScoreRank rank, double accuracy) => rank;
 
+        /// <summary>
+        /// Slightly higher than the cutoff for <see cref="Drawable.IsPresent"/>.
+        /// </summary>
+        private const float min_alpha = 0.0002f;
+
         public void ApplyToScoreProcessor(ScoreProcessor scoreProcessor)
         {
-            if (HiddenComboCount.Value != 0)
+            if (HiddenComboCount.Value == 0) return;
+
+            currentCombo = scoreProcessor.Combo.GetBoundCopy();
+            currentCombo.BindValueChanged(combo =>
             {
-                currentCombo = scoreProcessor.Combo.GetBoundCopy();
-                currentCombo.BindValueChanged(combo =>
-                {
-                    float targetCursorAlpha = (float)Math.Max(1e-3, 1 - (float)combo.NewValue / HiddenComboCount.Value);
-                    scoreProcessor.TransformBindableTo(cursorAlpha, targetCursorAlpha, CURSOR_ALPHA_TRANSITION_DURATION, Easing.OutQuint);
-                }, true);
-            }
+                targetAlpha = Math.Max(min_alpha, 1 - (float)combo.NewValue / HiddenComboCount.Value);
+            }, true);
         }
 
         public virtual void Update(Playfield playfield)
         {
-            playfield.Cursor.Alpha = cursorAlpha.Value;
+            playfield.Cursor.Alpha = (float)Interpolation.Lerp(playfield.Cursor.Alpha, targetAlpha, Math.Clamp(playfield.Time.Elapsed / CURSOR_ALPHA_TRANSITION_DURATION, 0, 1));
         }
     }
 

From 3a7eb7dd25f8e2da74684ec3395d79f5a917e92f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 15 Oct 2021 14:27:20 +0900
Subject: [PATCH 0254/5547] Make const private

---
 osu.Game.Rulesets.Osu/Mods/OsuModNoScope.cs | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModNoScope.cs b/osu.Game.Rulesets.Osu/Mods/OsuModNoScope.cs
index 09870f2758..c48cbd9992 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModNoScope.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModNoScope.cs
@@ -19,7 +19,12 @@ namespace osu.Game.Rulesets.Osu.Mods
 {
     public class OsuModNoScope : Mod, IUpdatableByPlayfield, IApplicableToScoreProcessor
     {
-        public const float CURSOR_ALPHA_TRANSITION_DURATION = 100;
+        /// <summary>
+        /// Slightly higher than the cutoff for <see cref="Drawable.IsPresent"/>.
+        /// </summary>
+        private const float min_alpha = 0.0002f;
+
+        private const float transition_duration = 100;
 
         public override string Name => "No Scope";
         public override string Acronym => "NS";
@@ -47,11 +52,6 @@ namespace osu.Game.Rulesets.Osu.Mods
 
         public ScoreRank AdjustRank(ScoreRank rank, double accuracy) => rank;
 
-        /// <summary>
-        /// Slightly higher than the cutoff for <see cref="Drawable.IsPresent"/>.
-        /// </summary>
-        private const float min_alpha = 0.0002f;
-
         public void ApplyToScoreProcessor(ScoreProcessor scoreProcessor)
         {
             if (HiddenComboCount.Value == 0) return;
@@ -65,7 +65,7 @@ namespace osu.Game.Rulesets.Osu.Mods
 
         public virtual void Update(Playfield playfield)
         {
-            playfield.Cursor.Alpha = (float)Interpolation.Lerp(playfield.Cursor.Alpha, targetAlpha, Math.Clamp(playfield.Time.Elapsed / CURSOR_ALPHA_TRANSITION_DURATION, 0, 1));
+            playfield.Cursor.Alpha = (float)Interpolation.Lerp(playfield.Cursor.Alpha, targetAlpha, Math.Clamp(playfield.Time.Elapsed / transition_duration, 0, 1));
         }
     }
 

From a51f036fa3c08080f10e8b733a831f1013950626 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 15 Oct 2021 14:31:44 +0900
Subject: [PATCH 0255/5547] Disable re-building project via `inspectcode`

---
 .github/workflows/ci.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 29cbdd2d37..ceb6c49bae 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -88,7 +88,7 @@ jobs:
       #   run: dotnet format --dry-run --check
 
       - name: InspectCode
-        run: dotnet jb inspectcode $(pwd)/osu.Desktop.slnf --output=$(pwd)/inspectcodereport.xml --cachesDir=$(pwd)/inspectcode --verbosity=WARN
+        run: dotnet jb inspectcode $(pwd)/osu.Desktop.slnf --no-build --output=$(pwd)/inspectcodereport.xml --cachesDir=$(pwd)/inspectcode --verbosity=WARN
 
       - name: NVika
         run: dotnet nvika parsereport "${{github.workspace}}/inspectcodereport.xml" --treatwarningsaserrors

From a90f40e83170638352228baa53d82dae6b62896b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 15 Oct 2021 16:00:09 +0900
Subject: [PATCH 0256/5547] Update one missed instance of `PresentImport`

---
 osu.Game/Beatmaps/BeatmapManager.cs | 16 ++++++++++------
 osu.Game/OsuGame.cs                 |  2 +-
 2 files changed, 11 insertions(+), 7 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index 14175f251b..dd9626d8ed 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -29,7 +29,7 @@ namespace osu.Game.Beatmaps
     /// Handles general operations related to global beatmap management.
     /// </summary>
     [ExcludeFromDynamicCompile]
-    public class BeatmapManager : IModelDownloader<BeatmapSetInfo>, IModelManager<BeatmapSetInfo>, IModelFileManager<BeatmapSetInfo, BeatmapSetFileInfo>, ICanAcceptFiles, IWorkingBeatmapCache, IDisposable
+    public class BeatmapManager : IModelDownloader<BeatmapSetInfo>, IModelManager<BeatmapSetInfo>, IModelFileManager<BeatmapSetInfo, BeatmapSetFileInfo>, ICanAcceptFiles, IWorkingBeatmapCache, IDisposable, IPostImports<BeatmapSetInfo>
     {
         private readonly BeatmapModelManager beatmapModelManager;
         private readonly BeatmapModelDownloader beatmapModelDownloader;
@@ -176,11 +176,6 @@ namespace osu.Game.Beatmaps
             }
         }
 
-        /// <summary>
-        /// Fired when the user requests to view the resulting import.
-        /// </summary>
-        public Action<IEnumerable<ILive<BeatmapSetInfo>>> PresentImport { set => beatmapModelManager.PostImport = value; }
-
         /// <summary>
         /// Delete a beatmap difficulty.
         /// </summary>
@@ -338,5 +333,14 @@ namespace osu.Game.Beatmaps
         }
 
         #endregion
+
+        #region Implementation of IPostImports<out BeatmapSetInfo>
+
+        public Action<IEnumerable<ILive<BeatmapSetInfo>>> PostImport
+        {
+            set => beatmapModelManager.PostImport = value;
+        }
+
+        #endregion
     }
 }
diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index 020cdebab6..6d2131d85b 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -642,7 +642,7 @@ namespace osu.Game
             SkinManager.PostNotification = n => Notifications.Post(n);
 
             BeatmapManager.PostNotification = n => Notifications.Post(n);
-            BeatmapManager.PresentImport = items => PresentBeatmap(items.First().Value);
+            BeatmapManager.PostImport = items => PresentBeatmap(items.First().Value);
 
             ScoreManager.PostNotification = n => Notifications.Post(n);
             ScoreManager.PostImport = items => PresentScore(items.First().Value);

From 6554f84a9f91e3cdfa202b4b755775492440c93d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 15 Oct 2021 16:14:56 +0900
Subject: [PATCH 0257/5547] Revert "Disable re-building project via
 `inspectcode`"

This reverts commit a51f036fa3c08080f10e8b733a831f1013950626.
---
 .github/workflows/ci.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index ceb6c49bae..29cbdd2d37 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -88,7 +88,7 @@ jobs:
       #   run: dotnet format --dry-run --check
 
       - name: InspectCode
-        run: dotnet jb inspectcode $(pwd)/osu.Desktop.slnf --no-build --output=$(pwd)/inspectcodereport.xml --cachesDir=$(pwd)/inspectcode --verbosity=WARN
+        run: dotnet jb inspectcode $(pwd)/osu.Desktop.slnf --output=$(pwd)/inspectcodereport.xml --cachesDir=$(pwd)/inspectcode --verbosity=WARN
 
       - name: NVika
         run: dotnet nvika parsereport "${{github.workspace}}/inspectcodereport.xml" --treatwarningsaserrors

From efaed4cba4aa1e43083e51ce804c0398ae94ecae Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 15 Oct 2021 16:14:57 +0900
Subject: [PATCH 0258/5547] Revert "Attempt bumping `inspectcode` to fix
 remaining inspection"

This reverts commit e018a6d6a5a968e3d9a148996b6c2f59377f9433.
---
 .config/dotnet-tools.json            | 2 +-
 osu.Game/Stores/RealmRulesetStore.cs | 5 +++--
 2 files changed, 4 insertions(+), 3 deletions(-)

diff --git a/.config/dotnet-tools.json b/.config/dotnet-tools.json
index 03b6308f97..007e4341b8 100644
--- a/.config/dotnet-tools.json
+++ b/.config/dotnet-tools.json
@@ -9,7 +9,7 @@
       ]
     },
     "jetbrains.resharper.globaltools": {
-      "version": "2021.2.2",
+      "version": "2020.3.2",
       "commands": [
         "jb"
       ]
diff --git a/osu.Game/Stores/RealmRulesetStore.cs b/osu.Game/Stores/RealmRulesetStore.cs
index 1b298f9d49..51f059caad 100644
--- a/osu.Game/Stores/RealmRulesetStore.cs
+++ b/osu.Game/Stores/RealmRulesetStore.cs
@@ -106,8 +106,9 @@ namespace osu.Game.Stores
                 var rulesets = realm.All<RealmRuleset>();
 
                 List<Ruleset> instances = loadedAssemblies.Values
-                                                          .Select(Activator.CreateInstance)
-                                                          .OfType<Ruleset>()
+                                                          .Select(r => Activator.CreateInstance(r) as Ruleset)
+                                                          .Where(r => r != null)
+                                                          .Cast<Ruleset>()
                                                           .ToList();
 
                 // add all legacy rulesets first to ensure they have exclusive choice of primary key.

From 2eb1170c0cc30a8ad488acc99c466ae347d3c14f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 15 Oct 2021 16:15:34 +0900
Subject: [PATCH 0259/5547] Use `AsNonNull` instead

---
 osu.Game/Stores/RealmRulesetStore.cs | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Stores/RealmRulesetStore.cs b/osu.Game/Stores/RealmRulesetStore.cs
index 51f059caad..27eb5d797f 100644
--- a/osu.Game/Stores/RealmRulesetStore.cs
+++ b/osu.Game/Stores/RealmRulesetStore.cs
@@ -7,6 +7,7 @@ using System.IO;
 using System.Linq;
 using System.Reflection;
 using osu.Framework;
+using osu.Framework.Extensions.ObjectExtensions;
 using osu.Framework.Logging;
 using osu.Framework.Platform;
 using osu.Game.Database;
@@ -108,7 +109,7 @@ namespace osu.Game.Stores
                 List<Ruleset> instances = loadedAssemblies.Values
                                                           .Select(r => Activator.CreateInstance(r) as Ruleset)
                                                           .Where(r => r != null)
-                                                          .Cast<Ruleset>()
+                                                          .Select(r => r.AsNonNull())
                                                           .ToList();
 
                 // add all legacy rulesets first to ensure they have exclusive choice of primary key.

From fdb734ac91a3625e7df28abf1ba060af0fd1e070 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 15 Oct 2021 16:24:40 +0900
Subject: [PATCH 0260/5547] Also add spec directly to `IModelImporter`

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

diff --git a/osu.Game/Database/IModelImporter.cs b/osu.Game/Database/IModelImporter.cs
index 8e658cb0f5..479f33c3b4 100644
--- a/osu.Game/Database/IModelImporter.cs
+++ b/osu.Game/Database/IModelImporter.cs
@@ -13,7 +13,7 @@ namespace osu.Game.Database
     /// A class which handles importing of associated models to the game store.
     /// </summary>
     /// <typeparam name="TModel">The model type.</typeparam>
-    public interface IModelImporter<TModel> : IPostNotifications
+    public interface IModelImporter<TModel> : IPostNotifications, IPostImports<TModel>
         where TModel : class
     {
         /// <summary>

From e9c3d09e0e0bef2139125e0ec2ab0e0baa78abb7 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 15 Oct 2021 16:27:16 +0900
Subject: [PATCH 0261/5547] Remove redundant specs

---
 osu.Game/Beatmaps/BeatmapManager.cs      | 2 +-
 osu.Game/Database/ArchiveModelManager.cs | 2 +-
 osu.Game/Scoring/ScoreManager.cs         | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index dd9626d8ed..562cbfabf0 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -29,7 +29,7 @@ namespace osu.Game.Beatmaps
     /// Handles general operations related to global beatmap management.
     /// </summary>
     [ExcludeFromDynamicCompile]
-    public class BeatmapManager : IModelDownloader<BeatmapSetInfo>, IModelManager<BeatmapSetInfo>, IModelFileManager<BeatmapSetInfo, BeatmapSetFileInfo>, ICanAcceptFiles, IWorkingBeatmapCache, IDisposable, IPostImports<BeatmapSetInfo>
+    public class BeatmapManager : IModelDownloader<BeatmapSetInfo>, IModelManager<BeatmapSetInfo>, IModelFileManager<BeatmapSetInfo, BeatmapSetFileInfo>, ICanAcceptFiles, IWorkingBeatmapCache, IDisposable
     {
         private readonly BeatmapModelManager beatmapModelManager;
         private readonly BeatmapModelDownloader beatmapModelDownloader;
diff --git a/osu.Game/Database/ArchiveModelManager.cs b/osu.Game/Database/ArchiveModelManager.cs
index c235fc7728..84e33e3f36 100644
--- a/osu.Game/Database/ArchiveModelManager.cs
+++ b/osu.Game/Database/ArchiveModelManager.cs
@@ -30,7 +30,7 @@ namespace osu.Game.Database
     /// </summary>
     /// <typeparam name="TModel">The model type.</typeparam>
     /// <typeparam name="TFileModel">The associated file join type.</typeparam>
-    public abstract class ArchiveModelManager<TModel, TFileModel> : ICanAcceptFiles, IModelManager<TModel>, IModelFileManager<TModel, TFileModel>, IPostImports<TModel>
+    public abstract class ArchiveModelManager<TModel, TFileModel> : ICanAcceptFiles, IModelManager<TModel>, IModelFileManager<TModel, TFileModel>
         where TModel : class, IHasFiles<TFileModel>, IHasPrimaryKey, ISoftDelete
         where TFileModel : class, INamedFileInfo, new()
     {
diff --git a/osu.Game/Scoring/ScoreManager.cs b/osu.Game/Scoring/ScoreManager.cs
index cf22a8fda4..8494cdcd22 100644
--- a/osu.Game/Scoring/ScoreManager.cs
+++ b/osu.Game/Scoring/ScoreManager.cs
@@ -25,7 +25,7 @@ using osu.Game.Rulesets.Scoring;
 
 namespace osu.Game.Scoring
 {
-    public class ScoreManager : IModelManager<ScoreInfo>, IModelFileManager<ScoreInfo, ScoreFileInfo>, IModelDownloader<ScoreInfo>, ICanAcceptFiles, IPostImports<ScoreInfo>
+    public class ScoreManager : IModelManager<ScoreInfo>, IModelFileManager<ScoreInfo, ScoreFileInfo>, IModelDownloader<ScoreInfo>, ICanAcceptFiles
     {
         private readonly Scheduler scheduler;
         private readonly Func<BeatmapDifficultyCache> difficulties;

From 8fb9aec730e71a8931ae8996bf478bd9ac512a23 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 15 Oct 2021 16:39:53 +0900
Subject: [PATCH 0262/5547] Fix threaded realm usage not disposing context fast
 enough

---
 .../Configuration/RulesetConfigManager.cs     | 22 ++++++++++++-------
 1 file changed, 14 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Rulesets/Configuration/RulesetConfigManager.cs b/osu.Game/Rulesets/Configuration/RulesetConfigManager.cs
index 901efc3155..eec71a3623 100644
--- a/osu.Game/Rulesets/Configuration/RulesetConfigManager.cs
+++ b/osu.Game/Rulesets/Configuration/RulesetConfigManager.cs
@@ -59,15 +59,21 @@ namespace osu.Game.Rulesets.Configuration
                 pendingWrites.Clear();
             }
 
-            realmFactory?.CreateContext().Write(realm =>
-            {
-                foreach (var c in changed)
-                {
-                    var setting = realm.All<RealmRulesetSetting>().First(s => s.RulesetID == rulesetId && s.Variant == variant && s.Key == c.ToString());
+            if (realmFactory == null)
+                return true;
 
-                    setting.Value = ConfigStore[c].ToString();
-                }
-            });
+            using (var context = realmFactory.CreateContext())
+            {
+                context.Write(realm =>
+                {
+                    foreach (var c in changed)
+                    {
+                        var setting = realm.All<RealmRulesetSetting>().First(s => s.RulesetID == rulesetId && s.Variant == variant && s.Key == c.ToString());
+
+                        setting.Value = ConfigStore[c].ToString();
+                    }
+                });
+            }
 
             return true;
         }

From d95a62fa563ae10ef8453bff223f88dd5418616a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 30 Sep 2021 23:45:09 +0900
Subject: [PATCH 0263/5547] Add models and stores for beatmap manager
 requirements

---
 osu.Game/Database/RealmContextFactory.cs |  23 +
 osu.Game/Stores/ArchiveModelImporter.cs  | 557 +++++++++++++++++++++++
 osu.Game/Stores/BeatmapImporter.cs       | 336 ++++++++++++++
 3 files changed, 916 insertions(+)
 create mode 100644 osu.Game/Stores/ArchiveModelImporter.cs
 create mode 100644 osu.Game/Stores/BeatmapImporter.cs

diff --git a/osu.Game/Database/RealmContextFactory.cs b/osu.Game/Database/RealmContextFactory.cs
index 82d51e365e..933454f860 100644
--- a/osu.Game/Database/RealmContextFactory.cs
+++ b/osu.Game/Database/RealmContextFactory.cs
@@ -2,12 +2,14 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
+using System.Linq;
 using System.Threading;
 using osu.Framework.Allocation;
 using osu.Framework.Development;
 using osu.Framework.Logging;
 using osu.Framework.Platform;
 using osu.Framework.Statistics;
+using osu.Game.Models;
 using Realms;
 
 #nullable enable
@@ -70,6 +72,27 @@ namespace osu.Game.Database
 
             if (!Filename.EndsWith(realm_extension, StringComparison.Ordinal))
                 Filename += realm_extension;
+
+            cleanupPendingDeletions();
+        }
+
+        private void cleanupPendingDeletions()
+        {
+            using (var realm = CreateContext())
+            using (var transaction = realm.BeginWrite())
+            {
+                var pendingDeleteSets = realm.All<RealmBeatmapSet>().Where(s => s.DeletePending);
+
+                foreach (var s in pendingDeleteSets)
+                {
+                    foreach (var b in s.Beatmaps)
+                        realm.Remove(b);
+
+                    realm.Remove(s);
+                }
+
+                transaction.Commit();
+            }
         }
 
         /// <summary>
diff --git a/osu.Game/Stores/ArchiveModelImporter.cs b/osu.Game/Stores/ArchiveModelImporter.cs
new file mode 100644
index 0000000000..c165dbecd8
--- /dev/null
+++ b/osu.Game/Stores/ArchiveModelImporter.cs
@@ -0,0 +1,557 @@
+// 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 System.Threading;
+using System.Threading.Tasks;
+using Humanizer;
+using NuGet.Packaging;
+using osu.Framework.Extensions;
+using osu.Framework.Extensions.IEnumerableExtensions;
+using osu.Framework.Logging;
+using osu.Framework.Platform;
+using osu.Framework.Threading;
+using osu.Game.Database;
+using osu.Game.IO.Archives;
+using osu.Game.Models;
+using osu.Game.Overlays.Notifications;
+using Realms;
+
+#nullable enable
+
+namespace osu.Game.Stores
+{
+    /// <summary>
+    /// Encapsulates a model store class to give it import functionality.
+    /// Adds cross-functionality with <see cref="RealmFileStore"/> to give access to the central file store for the provided model.
+    /// </summary>
+    /// <typeparam name="TModel">The model type.</typeparam>
+    public abstract class ArchiveModelImporter<TModel> : IModelImporter<TModel>
+        where TModel : RealmObject, IHasRealmFiles, IHasGuidPrimaryKey, ISoftDelete
+    {
+        private const int import_queue_request_concurrency = 1;
+
+        /// <summary>
+        /// The size of a batch import operation before considering it a lower priority operation.
+        /// </summary>
+        private const int low_priority_import_batch_size = 1;
+
+        /// <summary>
+        /// A singleton scheduler shared by all <see cref="ArchiveModelImporter{TModel}"/>.
+        /// </summary>
+        /// <remarks>
+        /// This scheduler generally performs IO and CPU intensive work so concurrency is limited harshly.
+        /// It is mainly being used as a queue mechanism for large imports.
+        /// </remarks>
+        private static readonly ThreadedTaskScheduler import_scheduler = new ThreadedTaskScheduler(import_queue_request_concurrency, nameof(ArchiveModelImporter<TModel>));
+
+        /// <summary>
+        /// A second scheduler for lower priority imports.
+        /// For simplicity, these will just run in parallel with normal priority imports, but a future refactor would see this implemented via a custom scheduler/queue.
+        /// See https://gist.github.com/peppy/f0e118a14751fc832ca30dd48ba3876b for an incomplete version of this.
+        /// </summary>
+        private static readonly ThreadedTaskScheduler import_scheduler_low_priority = new ThreadedTaskScheduler(import_queue_request_concurrency, nameof(ArchiveModelImporter<TModel>));
+
+        public virtual IEnumerable<string> HandledExtensions => new[] { @".zip" };
+
+        protected readonly RealmFileStore Files;
+
+        protected readonly RealmContextFactory ContextFactory;
+
+        /// <summary>
+        /// Fired when the user requests to view the resulting import.
+        /// </summary>
+        public Action<IEnumerable<ILive<TModel>>>? PresentImport;
+
+        /// <summary>
+        /// Set an endpoint for notifications to be posted to.
+        /// </summary>
+        public Action<Notification>? PostNotification { protected get; set; }
+
+        protected ArchiveModelImporter(Storage storage, RealmContextFactory contextFactory)
+        {
+            ContextFactory = contextFactory;
+
+            Files = new RealmFileStore(contextFactory, storage);
+        }
+
+        /// <summary>
+        /// Import one or more <typeparamref name="TModel"/> items from filesystem <paramref name="paths"/>.
+        /// </summary>
+        /// <remarks>
+        /// This will be treated as a low priority import if more than one path is specified; use <see cref="Import(ImportTask[])"/> to always import at standard priority.
+        /// This will post notifications tracking progress.
+        /// </remarks>
+        /// <param name="paths">One or more archive locations on disk.</param>
+        public Task Import(params string[] paths)
+        {
+            var notification = new ProgressNotification { State = ProgressNotificationState.Active };
+
+            PostNotification?.Invoke(notification);
+
+            return Import(notification, paths.Select(p => new ImportTask(p)).ToArray());
+        }
+
+        public Task Import(params ImportTask[] tasks)
+        {
+            var notification = new ProgressNotification { State = ProgressNotificationState.Active };
+
+            PostNotification?.Invoke(notification);
+
+            return Import(notification, tasks);
+        }
+
+        public async Task<IEnumerable<ILive<TModel>>> Import(ProgressNotification notification, params ImportTask[] tasks)
+        {
+            if (tasks.Length == 0)
+            {
+                notification.CompletionText = $"No {HumanisedModelName}s were found to import!";
+                notification.State = ProgressNotificationState.Completed;
+                return Enumerable.Empty<RealmLive<TModel>>();
+            }
+
+            notification.Progress = 0;
+            notification.Text = $"{HumanisedModelName.Humanize(LetterCasing.Title)} import is initialising...";
+
+            int current = 0;
+
+            var imported = new List<ILive<TModel>>();
+
+            bool isLowPriorityImport = tasks.Length > low_priority_import_batch_size;
+
+            try
+            {
+                await Task.WhenAll(tasks.Select(async task =>
+                {
+                    notification.CancellationToken.ThrowIfCancellationRequested();
+
+                    try
+                    {
+                        var model = await Import(task, isLowPriorityImport, notification.CancellationToken).ConfigureAwait(false);
+
+                        lock (imported)
+                        {
+                            if (model != null)
+                                imported.Add(model);
+                            current++;
+
+                            notification.Text = $"Imported {current} of {tasks.Length} {HumanisedModelName}s";
+                            notification.Progress = (float)current / tasks.Length;
+                        }
+                    }
+                    catch (TaskCanceledException)
+                    {
+                        throw;
+                    }
+                    catch (Exception e)
+                    {
+                        Logger.Error(e, $@"Could not import ({task})", LoggingTarget.Database);
+                    }
+                })).ConfigureAwait(false);
+            }
+            catch (OperationCanceledException)
+            {
+                if (imported.Count == 0)
+                {
+                    notification.State = ProgressNotificationState.Cancelled;
+                    return imported;
+                }
+            }
+
+            if (imported.Count == 0)
+            {
+                notification.Text = $"{HumanisedModelName.Humanize(LetterCasing.Title)} import failed!";
+                notification.State = ProgressNotificationState.Cancelled;
+            }
+            else
+            {
+                notification.CompletionText = imported.Count == 1
+                    ? $"Imported {imported.First()}!"
+                    : $"Imported {imported.Count} {HumanisedModelName}s!";
+
+                if (imported.Count > 0 && PresentImport != null)
+                {
+                    notification.CompletionText += " Click to view.";
+                    notification.CompletionClickAction = () =>
+                    {
+                        PresentImport?.Invoke(imported);
+                        return true;
+                    };
+                }
+
+                notification.State = ProgressNotificationState.Completed;
+            }
+
+            return imported;
+        }
+
+        /// <summary>
+        /// Import one <typeparamref name="TModel"/> from the filesystem and delete the file on success.
+        /// Note that this bypasses the UI flow and should only be used for special cases or testing.
+        /// </summary>
+        /// <param name="task">The <see cref="ImportTask"/> containing data about the <typeparamref name="TModel"/> to import.</param>
+        /// <param name="lowPriority">Whether this is a low priority import.</param>
+        /// <param name="cancellationToken">An optional cancellation token.</param>
+        /// <returns>The imported model, if successful.</returns>
+        public async Task<ILive<TModel>?> Import(ImportTask task, bool lowPriority = false, CancellationToken cancellationToken = default)
+        {
+            cancellationToken.ThrowIfCancellationRequested();
+
+            ILive<TModel>? import;
+            using (ArchiveReader reader = task.GetReader())
+                import = await Import(reader, lowPriority, cancellationToken).ConfigureAwait(false);
+
+            // We may or may not want to delete the file depending on where it is stored.
+            //  e.g. reconstructing/repairing database with items from default storage.
+            // Also, not always a single file, i.e. for LegacyFilesystemReader
+            // TODO: Add a check to prevent files from storage to be deleted.
+            try
+            {
+                if (import != null && File.Exists(task.Path) && ShouldDeleteArchive(task.Path))
+                    File.Delete(task.Path);
+            }
+            catch (Exception e)
+            {
+                Logger.Error(e, $@"Could not delete original file after import ({task})");
+            }
+
+            return import;
+        }
+
+        /// <summary>
+        /// Silently import an item from an <see cref="ArchiveReader"/>.
+        /// </summary>
+        /// <param name="archive">The archive to be imported.</param>
+        /// <param name="lowPriority">Whether this is a low priority import.</param>
+        /// <param name="cancellationToken">An optional cancellation token.</param>
+        public async Task<ILive<TModel>?> Import(ArchiveReader archive, bool lowPriority = false, CancellationToken cancellationToken = default)
+        {
+            cancellationToken.ThrowIfCancellationRequested();
+
+            TModel? model = null;
+
+            try
+            {
+                model = CreateModel(archive);
+
+                if (model == null)
+                    return null;
+            }
+            catch (TaskCanceledException)
+            {
+                throw;
+            }
+            catch (Exception e)
+            {
+                LogForModel(model, @$"Model creation of {archive.Name} failed.", e);
+                return null;
+            }
+
+            var scheduledImport = Task.Factory.StartNew(async () => await Import(model, archive, lowPriority, cancellationToken).ConfigureAwait(false),
+                cancellationToken, TaskCreationOptions.HideScheduler, lowPriority ? import_scheduler_low_priority : import_scheduler).Unwrap();
+
+            return await scheduledImport.ConfigureAwait(true);
+        }
+
+        /// <summary>
+        /// Any file extensions which should be included in hash creation.
+        /// Generally should include all file types which determine the file's uniqueness.
+        /// Large files should be avoided if possible.
+        /// </summary>
+        /// <remarks>
+        /// This is only used by the default hash implementation. If <see cref="ComputeHash"/> is overridden, it will not be used.
+        /// </remarks>
+        protected abstract string[] HashableFileTypes { get; }
+
+        internal static void LogForModel(TModel? model, string message, Exception? e = null)
+        {
+            string trimmedHash;
+            if (model == null || !model.IsValid || string.IsNullOrEmpty(model.Hash))
+                trimmedHash = "?????";
+            else
+                trimmedHash = model.Hash.Substring(0, 5);
+
+            string prefix = $"[{trimmedHash}]";
+
+            if (e != null)
+                Logger.Error(e, $"{prefix} {message}", LoggingTarget.Database);
+            else
+                Logger.Log($"{prefix} {message}", LoggingTarget.Database);
+        }
+
+        /// <summary>
+        /// Whether the implementation overrides <see cref="ComputeHash"/> with a custom implementation.
+        /// Custom hash implementations must bypass the early exit in the import flow (see <see cref="computeHashFast"/> usage).
+        /// </summary>
+        protected virtual bool HasCustomHashFunction => false;
+
+        /// <summary>
+        /// Create a SHA-2 hash from the provided archive based on file content of all files matching <see cref="HashableFileTypes"/>.
+        /// </summary>
+        /// <remarks>
+        ///  In the case of no matching files, a hash will be generated from the passed archive's <see cref="ArchiveReader.Name"/>.
+        /// </remarks>
+        protected virtual string ComputeHash(TModel item, ArchiveReader? reader = null)
+        {
+            if (reader != null)
+                // fast hashing for cases where the item's files may not be populated.
+                return computeHashFast(reader);
+
+            // for now, concatenate all hashable files in the set to create a unique hash.
+            MemoryStream hashable = new MemoryStream();
+
+            foreach (RealmNamedFileUsage file in item.Files.Where(f => HashableFileTypes.Any(ext => f.Filename.EndsWith(ext, StringComparison.OrdinalIgnoreCase))).OrderBy(f => f.Filename))
+            {
+                using (Stream s = Files.Store.GetStream(file.File.StoragePath))
+                    s.CopyTo(hashable);
+            }
+
+            if (hashable.Length > 0)
+                return hashable.ComputeSHA2Hash();
+
+            return item.Hash;
+        }
+
+        /// <summary>
+        /// Silently import an item from a <typeparamref name="TModel"/>.
+        /// </summary>
+        /// <param name="item">The model to be imported.</param>
+        /// <param name="archive">An optional archive to use for model population.</param>
+        /// <param name="lowPriority">Whether this is a low priority import.</param>
+        /// <param name="cancellationToken">An optional cancellation token.</param>
+        public virtual async Task<ILive<TModel>?> Import(TModel item, ArchiveReader? archive = null, bool lowPriority = false, CancellationToken cancellationToken = default)
+        {
+            using (var realm = ContextFactory.CreateContext())
+            {
+                cancellationToken.ThrowIfCancellationRequested();
+
+                bool checkedExisting = false;
+                TModel? existing = null;
+
+                if (archive != null && !HasCustomHashFunction)
+                {
+                    // this is a fast bail condition to improve large import performance.
+                    item.Hash = computeHashFast(archive);
+
+                    checkedExisting = true;
+                    existing = CheckForExisting(item, realm);
+
+                    if (existing != null)
+                    {
+                        // bare minimum comparisons
+                        //
+                        // note that this should really be checking filesizes on disk (of existing files) for some degree of sanity.
+                        // or alternatively doing a faster hash check. either of these require database changes and reprocessing of existing files.
+                        if (CanSkipImport(existing, item) &&
+                            getFilenames(existing.Files).SequenceEqual(getShortenedFilenames(archive).Select(p => p.shortened).OrderBy(f => f)))
+                        {
+                            LogForModel(item, @$"Found existing (optimised) {HumanisedModelName} for {item} (ID {existing.ID}) – skipping import.");
+
+                            using (var transaction = realm.BeginWrite())
+                            {
+                                existing.DeletePending = false;
+                                transaction.Commit();
+                            }
+
+                            return existing.ToLive();
+                        }
+
+                        LogForModel(item, @"Found existing (optimised) but failed pre-check.");
+                    }
+                }
+
+                try
+                {
+                    LogForModel(item, @"Beginning import...");
+
+                    // TODO: do we want to make the transaction this local? not 100% sure, will need further investigation.
+                    using (var transaction = realm.BeginWrite())
+                    {
+                        if (archive != null)
+                            // TODO: look into rollback of file additions (or delayed commit).
+                            item.Files.AddRange(createFileInfos(archive, Files, realm));
+
+                        item.Hash = ComputeHash(item, archive);
+
+                        // TODO: we may want to run this outside of the transaction.
+                        await Populate(item, archive, realm, cancellationToken).ConfigureAwait(false);
+
+                        if (!checkedExisting)
+                            existing = CheckForExisting(item, realm);
+
+                        if (existing != null)
+                        {
+                            if (CanReuseExisting(existing, item))
+                            {
+                                LogForModel(item, @$"Found existing {HumanisedModelName} for {item} (ID {existing.ID}) – skipping import.");
+                                existing.DeletePending = false;
+
+                                return existing.ToLive();
+                            }
+
+                            LogForModel(item, @"Found existing but failed re-use check.");
+
+                            existing.DeletePending = true;
+
+                            // todo: actually delete? i don't think this is required...
+                            // ModelStore.PurgeDeletable(s => s.ID == existing.ID);
+                        }
+
+                        PreImport(item, realm);
+
+                        // import to store
+                        realm.Add(item);
+
+                        transaction.Commit();
+                    }
+
+                    LogForModel(item, @"Import successfully completed!");
+                }
+                catch (Exception e)
+                {
+                    if (!(e is TaskCanceledException))
+                        LogForModel(item, @"Database import or population failed and has been rolled back.", e);
+
+                    throw;
+                }
+
+                return item.ToLive();
+            }
+        }
+
+        private string computeHashFast(ArchiveReader reader)
+        {
+            MemoryStream hashable = new MemoryStream();
+
+            foreach (var file in reader.Filenames.Where(f => HashableFileTypes.Any(ext => f.EndsWith(ext, StringComparison.OrdinalIgnoreCase))).OrderBy(f => f))
+            {
+                using (Stream s = reader.GetStream(file))
+                    s.CopyTo(hashable);
+            }
+
+            if (hashable.Length > 0)
+                return hashable.ComputeSHA2Hash();
+
+            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>();
+
+            // import files to manager
+            foreach (var filenames in getShortenedFilenames(reader))
+            {
+                using (Stream s = reader.GetStream(filenames.original))
+                {
+                    var item = new RealmNamedFileUsage(files.Add(s, realm), filenames.shortened);
+                    fileInfos.Add(item);
+                }
+            }
+
+            return fileInfos;
+        }
+
+        private IEnumerable<(string original, string shortened)> getShortenedFilenames(ArchiveReader reader)
+        {
+            string prefix = reader.Filenames.GetCommonPrefix();
+            if (!(prefix.EndsWith('/') || prefix.EndsWith('\\')))
+                prefix = string.Empty;
+
+            // import files to manager
+            foreach (string file in reader.Filenames)
+                yield return (file, file.Substring(prefix.Length).ToStandardisedPath());
+        }
+
+        /// <summary>
+        /// Create a barebones model from the provided archive.
+        /// Actual expensive population should be done in <see cref="Populate"/>; this should just prepare for duplicate checking.
+        /// </summary>
+        /// <param name="archive">The archive to create the model for.</param>
+        /// <returns>A model populated with minimal information. Returning a null will abort importing silently.</returns>
+        protected abstract TModel? CreateModel(ArchiveReader archive);
+
+        /// <summary>
+        /// Populate the provided model completely from the given archive.
+        /// After this method, the model should be in a state ready to commit to a store.
+        /// </summary>
+        /// <param name="model">The model to populate.</param>
+        /// <param name="archive">The archive to use as a reference for population. May be null.</param>
+        /// <param name="realm">The current realm context.</param>
+        /// <param name="cancellationToken">An optional cancellation token.</param>
+        protected abstract Task Populate(TModel model, ArchiveReader? archive, Realm realm, CancellationToken cancellationToken = default);
+
+        /// <summary>
+        /// Perform any final actions before the import to database executes.
+        /// </summary>
+        /// <param name="model">The model prepared for import.</param>
+        /// <param name="realm">The current realm context.</param>
+        protected virtual void PreImport(TModel model, Realm realm)
+        {
+        }
+
+        /// <summary>
+        /// Check whether an existing model already exists for a new import item.
+        /// </summary>
+        /// <param name="model">The new model proposed for import.</param>
+        /// <param name="realm">The current realm context.</param>
+        /// <returns>An existing model which matches the criteria to skip importing, else null.</returns>
+        protected TModel? CheckForExisting(TModel model, Realm realm) => string.IsNullOrEmpty(model.Hash) ? null : realm.All<TModel>().FirstOrDefault(b => b.Hash == model.Hash);
+
+        /// <summary>
+        /// Whether import can be skipped after finding an existing import early in the process.
+        /// Only valid when <see cref="ComputeHash"/> is not overridden.
+        /// </summary>
+        /// <param name="existing">The existing model.</param>
+        /// <param name="import">The newly imported model.</param>
+        /// <returns>Whether to skip this import completely.</returns>
+        protected virtual bool CanSkipImport(TModel existing, TModel import) => true;
+
+        /// <summary>
+        /// After an existing <typeparamref name="TModel"/> is found during an import process, the default behaviour is to use/restore the existing
+        /// item and skip the import. This method allows changing that behaviour.
+        /// </summary>
+        /// <param name="existing">The existing model.</param>
+        /// <param name="import">The newly imported model.</param>
+        /// <returns>Whether the existing model should be restored and used. Returning false will delete the existing and force a re-import.</returns>
+        protected virtual bool CanReuseExisting(TModel existing, TModel import) =>
+            // for the best or worst, we copy and import files of a new import before checking whether
+            // it is a duplicate. so to check if anything has changed, we can just compare all File IDs.
+            getIDs(existing.Files).SequenceEqual(getIDs(import.Files)) &&
+            getFilenames(existing.Files).SequenceEqual(getFilenames(import.Files));
+
+        /// <summary>
+        /// Whether this specified path should be removed after successful import.
+        /// </summary>
+        /// <param name="path">The path for consideration. May be a file or a directory.</param>
+        /// <returns>Whether to perform deletion.</returns>
+        protected virtual bool ShouldDeleteArchive(string path) => false;
+
+        private IEnumerable<string> getIDs(IEnumerable<INamedFile> files)
+        {
+            foreach (var f in files.OrderBy(f => f.Filename))
+                yield return f.File.Hash;
+        }
+
+        private IEnumerable<string> getFilenames(IEnumerable<INamedFile> files)
+        {
+            foreach (var f in files.OrderBy(f => f.Filename))
+                yield return f.Filename;
+        }
+
+        public virtual string HumanisedModelName => $"{typeof(TModel).Name.Replace(@"Info", "").ToLower()}";
+
+        private string getValidFilename(string filename)
+        {
+            foreach (char c in Path.GetInvalidFileNameChars())
+                filename = filename.Replace(c, '_');
+            return filename;
+        }
+    }
+}
diff --git a/osu.Game/Stores/BeatmapImporter.cs b/osu.Game/Stores/BeatmapImporter.cs
new file mode 100644
index 0000000000..95d2c4fe7b
--- /dev/null
+++ b/osu.Game/Stores/BeatmapImporter.cs
@@ -0,0 +1,336 @@
+// 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 System.Threading;
+using System.Threading.Tasks;
+using NuGet.Packaging;
+using osu.Framework.Audio.Track;
+using osu.Framework.Extensions;
+using osu.Framework.Extensions.IEnumerableExtensions;
+using osu.Framework.Graphics.Textures;
+using osu.Framework.Logging;
+using osu.Framework.Platform;
+using osu.Framework.Testing;
+using osu.Game.Beatmaps;
+using osu.Game.Beatmaps.Formats;
+using osu.Game.Database;
+using osu.Game.IO;
+using osu.Game.IO.Archives;
+using osu.Game.Models;
+using osu.Game.Rulesets;
+using osu.Game.Rulesets.Objects;
+using osu.Game.Skinning;
+using Realms;
+
+#nullable enable
+
+namespace osu.Game.Stores
+{
+    /// <summary>
+    /// Handles the storage and retrieval of Beatmaps/WorkingBeatmaps.
+    /// </summary>
+    [ExcludeFromDynamicCompile]
+    public class BeatmapImporter : ArchiveModelImporter<RealmBeatmapSet>, IDisposable
+    {
+        public override IEnumerable<string> HandledExtensions => new[] { ".osz" };
+
+        protected override string[] HashableFileTypes => new[] { ".osu" };
+
+        // protected override string ImportFromStablePath => ".";
+        //
+        // protected override Storage PrepareStableStorage(StableStorage stableStorage) => stableStorage.GetSongStorage();
+        //
+        // protected override bool ShouldDeleteArchive(string path) => Path.GetExtension(path)?.ToLowerInvariant() == ".osz";
+        //
+        // protected override bool CheckLocalAvailability(RealmBeatmapSet model, System.Linq.IQueryable<RealmBeatmapSet> items)
+        //     => base.CheckLocalAvailability(model, items) || (model.OnlineID != null && items.Any(b => b.OnlineID == model.OnlineID));
+
+        private readonly dynamic? onlineLookupQueue = null; // todo: BeatmapOnlineLookupQueue is private
+
+        public BeatmapImporter(RealmContextFactory contextFactory, Storage storage, bool performOnlineLookups = false)
+            : base(storage, contextFactory)
+        {
+            if (performOnlineLookups)
+            {
+                // onlineLookupQueue = new BeatmapOnlineLookupQueue(api, storage);
+            }
+        }
+
+        protected override bool ShouldDeleteArchive(string path) => Path.GetExtension(path).ToLowerInvariant() == ".osz";
+
+        protected override async Task Populate(RealmBeatmapSet beatmapSet, ArchiveReader? archive, Realm realm, CancellationToken cancellationToken = default)
+        {
+            if (archive != null)
+                beatmapSet.Beatmaps.AddRange(createBeatmapDifficulties(beatmapSet.Files, realm));
+
+            foreach (RealmBeatmap b in beatmapSet.Beatmaps)
+                b.BeatmapSet = beatmapSet;
+
+            validateOnlineIds(beatmapSet, realm);
+
+            bool hadOnlineBeatmapIDs = beatmapSet.Beatmaps.Any(b => b.OnlineID > 0);
+
+            if (onlineLookupQueue != null)
+                await onlineLookupQueue.UpdateAsync(beatmapSet, cancellationToken).ConfigureAwait(false);
+
+            // ensure at least one beatmap was able to retrieve or keep an online ID, else drop the set ID.
+            if (hadOnlineBeatmapIDs && !beatmapSet.Beatmaps.Any(b => b.OnlineID > 0))
+            {
+                if (beatmapSet.OnlineID != null)
+                {
+                    beatmapSet.OnlineID = null;
+                    LogForModel(beatmapSet, "Disassociating beatmap set ID due to loss of all beatmap IDs");
+                }
+            }
+        }
+
+        protected override void PreImport(RealmBeatmapSet beatmapSet, Realm realm)
+        {
+            // if (beatmapSet.Beatmaps.Any(b => b.Difficulty == null))
+            //     throw new InvalidOperationException($"Cannot import {nameof(IBeatmapInfo)} with null {nameof(IBeatmapInfo.Difficulty)}.");
+
+            // check if a set already exists with the same online id, delete if it does.
+            if (beatmapSet.OnlineID != null)
+            {
+                var existingOnlineId = realm.All<RealmBeatmapSet>().FirstOrDefault(b => b.OnlineID == beatmapSet.OnlineID);
+
+                if (existingOnlineId != null)
+                {
+                    existingOnlineId.DeletePending = true;
+
+                    // in order to avoid a unique key constraint, immediately remove the online ID from the previous set.
+                    existingOnlineId.OnlineID = null;
+                    foreach (var b in existingOnlineId.Beatmaps)
+                        b.OnlineID = null;
+
+                    LogForModel(beatmapSet, $"Found existing beatmap set with same OnlineID ({beatmapSet.OnlineID}). It has been deleted.");
+                }
+            }
+        }
+
+        private void validateOnlineIds(RealmBeatmapSet beatmapSet, Realm realm)
+        {
+            var beatmapIds = beatmapSet.Beatmaps.Where(b => b.OnlineID.HasValue).Select(b => b.OnlineID).ToList();
+
+            // ensure all IDs are unique
+            if (beatmapIds.GroupBy(b => b).Any(g => g.Count() > 1))
+            {
+                LogForModel(beatmapSet, "Found non-unique IDs, resetting...");
+                resetIds();
+                return;
+            }
+
+            // find any existing beatmaps in the database that have matching online ids
+            List<RealmBeatmap> existingBeatmaps = new List<RealmBeatmap>();
+
+            foreach (var id in beatmapIds)
+                existingBeatmaps.AddRange(realm.All<RealmBeatmap>().Where(b => b.OnlineID == id));
+
+            if (existingBeatmaps.Any())
+            {
+                // reset the import ids (to force a re-fetch) *unless* they match the candidate CheckForExisting set.
+                // we can ignore the case where the new ids are contained by the CheckForExisting set as it will either be used (import skipped) or deleted.
+
+                var existing = CheckForExisting(beatmapSet, realm);
+
+                if (existing == null || existingBeatmaps.Any(b => !existing.Beatmaps.Contains(b)))
+                {
+                    LogForModel(beatmapSet, "Found existing import with online IDs already, resetting...");
+                    resetIds();
+                }
+            }
+
+            void resetIds() => beatmapSet.Beatmaps.ForEach(b => b.OnlineID = null);
+        }
+
+        protected override bool CanSkipImport(RealmBeatmapSet existing, RealmBeatmapSet import)
+        {
+            if (!base.CanSkipImport(existing, import))
+                return false;
+
+            return existing.Beatmaps.Any(b => b.OnlineID != null);
+        }
+
+        protected override bool CanReuseExisting(RealmBeatmapSet existing, RealmBeatmapSet import)
+        {
+            if (!base.CanReuseExisting(existing, import))
+                return false;
+
+            var existingIds = existing.Beatmaps.Select(b => b.OnlineID).OrderBy(i => i);
+            var importIds = import.Beatmaps.Select(b => b.OnlineID).OrderBy(i => i);
+
+            // force re-import if we are not in a sane state.
+            return existing.OnlineID == import.OnlineID && existingIds.SequenceEqual(importIds);
+        }
+
+        public override string HumanisedModelName => "beatmap";
+
+        protected override RealmBeatmapSet? CreateModel(ArchiveReader reader)
+        {
+            // let's make sure there are actually .osu files to import.
+            string? mapName = reader.Filenames.FirstOrDefault(f => f.EndsWith(".osu", StringComparison.OrdinalIgnoreCase));
+
+            if (string.IsNullOrEmpty(mapName))
+            {
+                Logger.Log($"No beatmap files found in the beatmap archive ({reader.Name}).", LoggingTarget.Database);
+                return null;
+            }
+
+            Beatmap beatmap;
+            using (var stream = new LineBufferedReader(reader.GetStream(mapName)))
+                beatmap = Decoder.GetDecoder<Beatmap>(stream).Decode(stream);
+
+            return new RealmBeatmapSet
+            {
+                OnlineID = beatmap.BeatmapInfo.BeatmapSet?.OnlineBeatmapSetID,
+                // Metadata = beatmap.Metadata,
+                DateAdded = DateTimeOffset.UtcNow
+            };
+        }
+
+        /// <summary>
+        /// Create all required <see cref="RealmBeatmap"/>s for the provided archive.
+        /// </summary>
+        private List<RealmBeatmap> createBeatmapDifficulties(IList<RealmNamedFileUsage> files, Realm realm)
+        {
+            var beatmaps = new List<RealmBeatmap>();
+
+            foreach (var file in files.Where(f => f.Filename.EndsWith(".osu", StringComparison.OrdinalIgnoreCase)))
+            {
+                using (var raw = Files.Store.GetStream(file.File.StoragePath))
+                using (var ms = new MemoryStream()) // we need a memory stream so we can seek
+                using (var sr = new LineBufferedReader(ms))
+                {
+                    raw.CopyTo(ms);
+                    ms.Position = 0;
+
+                    var decoder = Decoder.GetDecoder<Beatmap>(sr);
+                    IBeatmap beatmap = decoder.Decode(sr);
+
+                    string hash = ms.ComputeSHA2Hash();
+
+                    if (beatmaps.Any(b => b.Hash == hash))
+                        continue;
+
+                    var beatmapInfo = beatmap.BeatmapInfo;
+
+                    var ruleset = realm.All<RealmRuleset>().FirstOrDefault(r => r.OnlineID == beatmapInfo.RulesetID);
+                    var rulesetInstance = (ruleset as IRulesetInfo)?.CreateInstance();
+
+                    if (ruleset == null || rulesetInstance == null)
+                    {
+                        Logger.Log($"Skipping import due to missing local ruleset {beatmapInfo.RulesetID}.", LoggingTarget.Database);
+                        continue;
+                    }
+
+                    beatmapInfo.Path = file.Filename;
+                    beatmapInfo.Hash = hash;
+                    beatmapInfo.MD5Hash = ms.ComputeMD5Hash();
+
+                    // TODO: this should be done in a better place once we actually need to dynamically update it.
+                    beatmap.BeatmapInfo.Ruleset = rulesetInstance.RulesetInfo;
+                    beatmap.BeatmapInfo.StarDifficulty = rulesetInstance.CreateDifficultyCalculator(new DummyConversionBeatmap(beatmap)).Calculate().StarRating;
+                    beatmap.BeatmapInfo.Length = calculateLength(beatmap);
+                    beatmap.BeatmapInfo.BPM = 60000 / beatmap.GetMostCommonBeatLength();
+
+                    var difficulty = new RealmBeatmapDifficulty
+                    {
+                        DrainRate = beatmapInfo.BaseDifficulty.DrainRate,
+                        CircleSize = beatmapInfo.BaseDifficulty.CircleSize,
+                        OverallDifficulty = beatmapInfo.BaseDifficulty.OverallDifficulty,
+                        ApproachRate = beatmapInfo.BaseDifficulty.ApproachRate,
+                        SliderMultiplier = beatmapInfo.BaseDifficulty.SliderMultiplier,
+                        SliderTickRate = beatmapInfo.BaseDifficulty.SliderTickRate,
+                    };
+
+                    var metadata = new RealmBeatmapMetadata
+                    {
+                        Title = beatmap.Metadata.Title,
+                        TitleUnicode = beatmap.Metadata.TitleUnicode,
+                        Artist = beatmap.Metadata.Artist,
+                        ArtistUnicode = beatmap.Metadata.ArtistUnicode,
+                        Author = beatmap.Metadata.AuthorString,
+                        Source = beatmap.Metadata.Source,
+                        Tags = beatmap.Metadata.Tags,
+                        PreviewTime = beatmap.Metadata.PreviewTime,
+                        AudioFile = beatmap.Metadata.AudioFile,
+                        BackgroundFile = beatmap.Metadata.BackgroundFile,
+                    };
+
+                    var realmBeatmap = new RealmBeatmap(ruleset, difficulty, metadata)
+                    {
+                        DifficultyName = beatmapInfo.Version,
+                        OnlineID = beatmapInfo.OnlineBeatmapID,
+                        Length = beatmapInfo.Length,
+                        BPM = beatmapInfo.BPM,
+                        Hash = beatmapInfo.Hash,
+                        StarRating = beatmapInfo.StarDifficulty,
+                        MD5Hash = beatmapInfo.MD5Hash,
+                        Hidden = beatmapInfo.Hidden,
+                        AudioLeadIn = beatmapInfo.AudioLeadIn,
+                        StackLeniency = beatmapInfo.StackLeniency,
+                        SpecialStyle = beatmapInfo.SpecialStyle,
+                        LetterboxInBreaks = beatmapInfo.LetterboxInBreaks,
+                        WidescreenStoryboard = beatmapInfo.WidescreenStoryboard,
+                        EpilepsyWarning = beatmapInfo.EpilepsyWarning,
+                        SamplesMatchPlaybackRate = beatmapInfo.SamplesMatchPlaybackRate,
+                        DistanceSpacing = beatmapInfo.DistanceSpacing,
+                        BeatDivisor = beatmapInfo.BeatDivisor,
+                        GridSize = beatmapInfo.GridSize,
+                        TimelineZoom = beatmapInfo.TimelineZoom,
+                    };
+
+                    // TODO: IBeatmap.BeatmapInfo needs to be updated to the new interface.
+                    // beatmaps.Add(beatmap.BeatmapInfo);
+
+                    beatmaps.Add(realmBeatmap);
+                }
+            }
+
+            return beatmaps;
+        }
+
+        public void Dispose()
+        {
+            onlineLookupQueue?.Dispose();
+        }
+
+        private double calculateLength(IBeatmap b)
+        {
+            if (!b.HitObjects.Any())
+                return 0;
+
+            var lastObject = b.HitObjects.Last();
+
+            //TODO: this isn't always correct (consider mania where a non-last object may last for longer than the last in the list).
+            double endTime = lastObject.GetEndTime();
+            double startTime = b.HitObjects.First().StartTime;
+
+            return endTime - startTime;
+        }
+
+        /// <summary>
+        /// A dummy WorkingBeatmap for the purpose of retrieving a beatmap for star difficulty calculation.
+        /// </summary>
+        private class DummyConversionBeatmap : WorkingBeatmap
+        {
+            private readonly IBeatmap beatmap;
+
+            public DummyConversionBeatmap(IBeatmap beatmap)
+                : base(beatmap.BeatmapInfo, null)
+            {
+                this.beatmap = beatmap;
+            }
+
+            protected override IBeatmap GetBeatmap() => beatmap;
+            protected override Texture? GetBackground() => null;
+            protected override Track? GetBeatmapTrack() => null;
+            protected internal override ISkin? GetSkin() => null;
+            public override Stream? GetStream(string storagePath) => null;
+        }
+    }
+}

From 8d6d7fcdbe48ee3f06686fbaa0ae402f360a926f Mon Sep 17 00:00:00 2001
From: Jamie Taylor <me@nekodex.net>
Date: Fri, 15 Oct 2021 17:00:47 +0900
Subject: [PATCH 0264/5547] Add high-pass filter to gameplay fail sequence

---
 osu.Game/Screens/Play/FailAnimation.cs | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/Play/FailAnimation.cs b/osu.Game/Screens/Play/FailAnimation.cs
index e37f42e5f0..8c1f11718d 100644
--- a/osu.Game/Screens/Play/FailAnimation.cs
+++ b/osu.Game/Screens/Play/FailAnimation.cs
@@ -6,6 +6,7 @@ using osu.Framework.Bindables;
 using osu.Game.Rulesets.UI;
 using System;
 using System.Collections.Generic;
+using ManagedBass.Fx;
 using osu.Framework.Allocation;
 using osu.Framework.Audio.Sample;
 using osu.Framework.Audio.Track;
@@ -35,6 +36,7 @@ namespace osu.Game.Screens.Play
         private Track track;
 
         private AudioFilter failLowPassFilter;
+        private AudioFilter failHighPassFilter;
 
         private const float duration = 2500;
 
@@ -52,6 +54,7 @@ namespace osu.Game.Screens.Play
             failSample = audio.Samples.Get(@"Gameplay/failsound");
 
             AddInternal(failLowPassFilter = new AudioFilter(audio.TrackMixer));
+            AddInternal(failHighPassFilter = new AudioFilter(audio.TrackMixer, BQFType.HighPass));
         }
 
         private bool started;
@@ -66,14 +69,14 @@ namespace osu.Game.Screens.Play
 
             started = true;
 
-            failSample.Play();
-
             this.TransformBindableTo(trackFreq, 0, duration).OnComplete(_ =>
             {
                 OnComplete?.Invoke();
             });
 
+            failHighPassFilter.CutoffTo(300);
             failLowPassFilter.CutoffTo(300, duration, Easing.OutCubic);
+            failSample.Play();
 
             track.AddAdjustment(AdjustableProperty.Frequency, trackFreq);
 

From 49969ac32850f44cc3c1b1ec903939ebfb0cb18c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 1 Oct 2021 00:05:14 +0900
Subject: [PATCH 0265/5547] Add beatmap import and file store tests

---
 .../Database/BeatmapImporterTests.cs          | 820 ++++++++++++++++++
 osu.Game/Database/IPostImports.cs             |   4 +-
 osu.Game/Stores/ArchiveModelImporter.cs       |   6 +-
 3 files changed, 826 insertions(+), 4 deletions(-)
 create mode 100644 osu.Game.Tests/Database/BeatmapImporterTests.cs

diff --git a/osu.Game.Tests/Database/BeatmapImporterTests.cs b/osu.Game.Tests/Database/BeatmapImporterTests.cs
new file mode 100644
index 0000000000..beab9b311b
--- /dev/null
+++ b/osu.Game.Tests/Database/BeatmapImporterTests.cs
@@ -0,0 +1,820 @@
+// 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.IO;
+using System.Linq;
+using System.Threading;
+using System.Threading.Tasks;
+using NUnit.Framework;
+using osu.Framework.Extensions;
+using osu.Framework.Extensions.ObjectExtensions;
+using osu.Framework.Logging;
+using osu.Game.Beatmaps;
+using osu.Game.Database;
+using osu.Game.IO.Archives;
+using osu.Game.Models;
+using osu.Game.Stores;
+using osu.Game.Tests.Resources;
+using Realms;
+using SharpCompress.Archives;
+using SharpCompress.Archives.Zip;
+using SharpCompress.Common;
+using SharpCompress.Writers.Zip;
+
+#nullable enable
+
+namespace osu.Game.Tests.Database
+{
+    [TestFixture]
+    public class BeatmapImporterTests : RealmTest
+    {
+        [Test]
+        public void TestImportBeatmapThenCleanup()
+        {
+            RunTestWithRealmAsync(async (realmFactory, storage) =>
+            {
+                using (var importer = new BeatmapImporter(realmFactory, storage))
+                using (new RealmRulesetStore(realmFactory, storage))
+                {
+                    ILive<RealmBeatmapSet>? imported;
+
+                    using (var reader = new ZipArchiveReader(TestResources.GetTestBeatmapStream()))
+                        imported = await importer.Import(reader);
+
+                    Assert.AreEqual(1, realmFactory.Context.All<RealmBeatmapSet>().Count());
+
+                    Assert.NotNull(imported);
+                    Debug.Assert(imported != null);
+
+                    imported.PerformWrite(s => s.DeletePending = true);
+
+                    Assert.AreEqual(1, realmFactory.Context.All<RealmBeatmapSet>().Count(s => s.DeletePending));
+                }
+            });
+
+            Logger.Log("Running with no work to purge pending deletions");
+
+            RunTestWithRealm((realmFactory, _) => { Assert.AreEqual(0, realmFactory.Context.All<RealmBeatmapSet>().Count()); });
+        }
+
+        [Test]
+        public void TestImportWhenClosed()
+        {
+            RunTestWithRealmAsync(async (realmFactory, storage) =>
+            {
+                using var importer = new BeatmapImporter(realmFactory, storage);
+                using var store = new RealmRulesetStore(realmFactory, storage);
+
+                await LoadOszIntoStore(importer, realmFactory.Context);
+            });
+        }
+
+        [Test]
+        public void TestImportThenDelete()
+        {
+            RunTestWithRealmAsync(async (realmFactory, storage) =>
+            {
+                using var importer = new BeatmapImporter(realmFactory, storage);
+                using var store = new RealmRulesetStore(realmFactory, storage);
+
+                var imported = await LoadOszIntoStore(importer, realmFactory.Context);
+
+                deleteBeatmapSet(imported, realmFactory.Context);
+            });
+        }
+
+        [Test]
+        public void TestImportThenDeleteFromStream()
+        {
+            RunTestWithRealmAsync(async (realmFactory, storage) =>
+            {
+                using var importer = new BeatmapImporter(realmFactory, storage);
+                using var store = new RealmRulesetStore(realmFactory, storage);
+
+                var tempPath = TestResources.GetTestBeatmapForImport();
+
+                ILive<RealmBeatmapSet>? importedSet;
+
+                using (var stream = File.OpenRead(tempPath))
+                {
+                    importedSet = await importer.Import(new ImportTask(stream, Path.GetFileName(tempPath)));
+                    ensureLoaded(realmFactory.Context);
+                }
+
+                Assert.NotNull(importedSet);
+                Debug.Assert(importedSet != null);
+
+                Assert.IsTrue(File.Exists(tempPath), "Stream source file somehow went missing");
+                File.Delete(tempPath);
+
+                var imported = realmFactory.Context.All<RealmBeatmapSet>().First(beatmapSet => beatmapSet.ID == importedSet.ID);
+
+                deleteBeatmapSet(imported, realmFactory.Context);
+            });
+        }
+
+        [Test]
+        public void TestImportThenImport()
+        {
+            RunTestWithRealmAsync(async (realmFactory, storage) =>
+            {
+                using var importer = new BeatmapImporter(realmFactory, storage);
+                using var store = new RealmRulesetStore(realmFactory, storage);
+
+                var imported = await LoadOszIntoStore(importer, realmFactory.Context);
+                var importedSecondTime = await LoadOszIntoStore(importer, realmFactory.Context);
+
+                // check the newly "imported" beatmap is actually just the restored previous import. since it matches hash.
+                Assert.IsTrue(imported.ID == importedSecondTime.ID);
+                Assert.IsTrue(imported.Beatmaps.First().ID == importedSecondTime.Beatmaps.First().ID);
+
+                checkBeatmapSetCount(realmFactory.Context, 1);
+                checkSingleReferencedFileCount(realmFactory.Context, 18);
+            });
+        }
+
+        [Test]
+        public void TestImportThenImportWithReZip()
+        {
+            RunTestWithRealmAsync(async (realmFactory, storage) =>
+            {
+                using var importer = new BeatmapImporter(realmFactory, storage);
+                using var store = new RealmRulesetStore(realmFactory, storage);
+
+                var temp = TestResources.GetTestBeatmapForImport();
+
+                string extractedFolder = $"{temp}_extracted";
+                Directory.CreateDirectory(extractedFolder);
+
+                try
+                {
+                    var imported = await LoadOszIntoStore(importer, realmFactory.Context);
+
+                    string hashBefore = hashFile(temp);
+
+                    using (var zip = ZipArchive.Open(temp))
+                        zip.WriteToDirectory(extractedFolder);
+
+                    using (var zip = ZipArchive.Create())
+                    {
+                        zip.AddAllFromDirectory(extractedFolder);
+                        zip.SaveTo(temp, new ZipWriterOptions(CompressionType.Deflate));
+                    }
+
+                    // zip files differ because different compression or encoder.
+                    Assert.AreNotEqual(hashBefore, hashFile(temp));
+
+                    var importedSecondTime = await importer.Import(new ImportTask(temp));
+
+                    ensureLoaded(realmFactory.Context);
+
+                    Assert.NotNull(importedSecondTime);
+                    Debug.Assert(importedSecondTime != null);
+
+                    // but contents doesn't, so existing should still be used.
+                    Assert.IsTrue(imported.ID == importedSecondTime.ID);
+                    Assert.IsTrue(imported.Beatmaps.First().ID == importedSecondTime.PerformRead(s => s.Beatmaps.First().ID));
+                }
+                finally
+                {
+                    Directory.Delete(extractedFolder, true);
+                }
+            });
+        }
+
+        [Test]
+        public void TestImportThenImportWithChangedHashedFile()
+        {
+            RunTestWithRealmAsync(async (realmFactory, storage) =>
+            {
+                using var importer = new BeatmapImporter(realmFactory, storage);
+                using var store = new RealmRulesetStore(realmFactory, storage);
+
+                var temp = TestResources.GetTestBeatmapForImport();
+
+                string extractedFolder = $"{temp}_extracted";
+                Directory.CreateDirectory(extractedFolder);
+
+                try
+                {
+                    var imported = await LoadOszIntoStore(importer, realmFactory.Context);
+
+                    await createScoreForBeatmap(realmFactory.Context, imported.Beatmaps.First());
+
+                    using (var zip = ZipArchive.Open(temp))
+                        zip.WriteToDirectory(extractedFolder);
+
+                    // arbitrary write to hashed file
+                    // this triggers the special BeatmapManager.PreImport deletion/replacement flow.
+                    using (var sw = new FileInfo(Directory.GetFiles(extractedFolder, "*.osu").First()).AppendText())
+                        await sw.WriteLineAsync("// changed");
+
+                    using (var zip = ZipArchive.Create())
+                    {
+                        zip.AddAllFromDirectory(extractedFolder);
+                        zip.SaveTo(temp, new ZipWriterOptions(CompressionType.Deflate));
+                    }
+
+                    var importedSecondTime = await importer.Import(new ImportTask(temp));
+
+                    ensureLoaded(realmFactory.Context);
+
+                    // check the newly "imported" beatmap is not the original.
+                    Assert.NotNull(importedSecondTime);
+                    Debug.Assert(importedSecondTime != null);
+
+                    Assert.IsTrue(imported.ID != importedSecondTime.ID);
+                    Assert.IsTrue(imported.Beatmaps.First().ID != importedSecondTime.PerformRead(s => s.Beatmaps.First().ID));
+                }
+                finally
+                {
+                    Directory.Delete(extractedFolder, true);
+                }
+            });
+        }
+
+        [Test]
+        [Ignore("intentionally broken by import optimisations")]
+        public void TestImportThenImportWithChangedFile()
+        {
+            RunTestWithRealmAsync(async (realmFactory, storage) =>
+            {
+                using var importer = new BeatmapImporter(realmFactory, storage);
+                using var store = new RealmRulesetStore(realmFactory, storage);
+
+                var temp = TestResources.GetTestBeatmapForImport();
+
+                string extractedFolder = $"{temp}_extracted";
+                Directory.CreateDirectory(extractedFolder);
+
+                try
+                {
+                    var imported = await LoadOszIntoStore(importer, realmFactory.Context);
+
+                    using (var zip = ZipArchive.Open(temp))
+                        zip.WriteToDirectory(extractedFolder);
+
+                    // arbitrary write to non-hashed file
+                    using (var sw = new FileInfo(Directory.GetFiles(extractedFolder, "*.mp3").First()).AppendText())
+                        await sw.WriteLineAsync("text");
+
+                    using (var zip = ZipArchive.Create())
+                    {
+                        zip.AddAllFromDirectory(extractedFolder);
+                        zip.SaveTo(temp, new ZipWriterOptions(CompressionType.Deflate));
+                    }
+
+                    var importedSecondTime = await importer.Import(new ImportTask(temp));
+
+                    ensureLoaded(realmFactory.Context);
+
+                    Assert.NotNull(importedSecondTime);
+                    Debug.Assert(importedSecondTime != null);
+
+                    // check the newly "imported" beatmap is not the original.
+                    Assert.IsTrue(imported.ID != importedSecondTime.ID);
+                    Assert.IsTrue(imported.Beatmaps.First().ID != importedSecondTime.PerformRead(s => s.Beatmaps.First().ID));
+                }
+                finally
+                {
+                    Directory.Delete(extractedFolder, true);
+                }
+            });
+        }
+
+        [Test]
+        public void TestImportThenImportWithDifferentFilename()
+        {
+            RunTestWithRealmAsync(async (realmFactory, storage) =>
+            {
+                using var importer = new BeatmapImporter(realmFactory, storage);
+                using var store = new RealmRulesetStore(realmFactory, storage);
+
+                var temp = TestResources.GetTestBeatmapForImport();
+
+                string extractedFolder = $"{temp}_extracted";
+                Directory.CreateDirectory(extractedFolder);
+
+                try
+                {
+                    var imported = await LoadOszIntoStore(importer, realmFactory.Context);
+
+                    using (var zip = ZipArchive.Open(temp))
+                        zip.WriteToDirectory(extractedFolder);
+
+                    // change filename
+                    var firstFile = new FileInfo(Directory.GetFiles(extractedFolder).First());
+                    firstFile.MoveTo(Path.Combine(firstFile.DirectoryName.AsNonNull(), $"{firstFile.Name}-changed{firstFile.Extension}"));
+
+                    using (var zip = ZipArchive.Create())
+                    {
+                        zip.AddAllFromDirectory(extractedFolder);
+                        zip.SaveTo(temp, new ZipWriterOptions(CompressionType.Deflate));
+                    }
+
+                    var importedSecondTime = await importer.Import(new ImportTask(temp));
+
+                    ensureLoaded(realmFactory.Context);
+
+                    Assert.NotNull(importedSecondTime);
+                    Debug.Assert(importedSecondTime != null);
+
+                    // check the newly "imported" beatmap is not the original.
+                    Assert.IsTrue(imported.ID != importedSecondTime.ID);
+                    Assert.IsTrue(imported.Beatmaps.First().ID != importedSecondTime.PerformRead(s => s.Beatmaps.First().ID));
+                }
+                finally
+                {
+                    Directory.Delete(extractedFolder, true);
+                }
+            });
+        }
+
+        [Test]
+        [Ignore("intentionally broken by import optimisations")]
+        public void TestImportCorruptThenImport()
+        {
+            RunTestWithRealmAsync(async (realmFactory, storage) =>
+            {
+                using var importer = new BeatmapImporter(realmFactory, storage);
+                using var store = new RealmRulesetStore(realmFactory, storage);
+
+                var imported = await LoadOszIntoStore(importer, realmFactory.Context);
+
+                var firstFile = imported.Files.First();
+
+                long originalLength;
+                using (var stream = storage.GetStream(firstFile.File.StoragePath))
+                    originalLength = stream.Length;
+
+                using (var stream = storage.GetStream(firstFile.File.StoragePath, FileAccess.Write, FileMode.Create))
+                    stream.WriteByte(0);
+
+                var importedSecondTime = await LoadOszIntoStore(importer, realmFactory.Context);
+
+                using (var stream = storage.GetStream(firstFile.File.StoragePath))
+                    Assert.AreEqual(stream.Length, originalLength, "Corruption was not fixed on second import");
+
+                // check the newly "imported" beatmap is actually just the restored previous import. since it matches hash.
+                Assert.IsTrue(imported.ID == importedSecondTime.ID);
+                Assert.IsTrue(imported.Beatmaps.First().ID == importedSecondTime.Beatmaps.First().ID);
+
+                checkBeatmapSetCount(realmFactory.Context, 1);
+                checkSingleReferencedFileCount(realmFactory.Context, 18);
+            });
+        }
+
+        [Test]
+        public void TestRollbackOnFailure()
+        {
+            RunTestWithRealmAsync(async (realmFactory, storage) =>
+            {
+                int loggedExceptionCount = 0;
+
+                Logger.NewEntry += l =>
+                {
+                    if (l.Target == LoggingTarget.Database && l.Exception != null)
+                        Interlocked.Increment(ref loggedExceptionCount);
+                };
+
+                using var importer = new BeatmapImporter(realmFactory, storage);
+                using var store = new RealmRulesetStore(realmFactory, storage);
+
+                var imported = await LoadOszIntoStore(importer, realmFactory.Context);
+
+                realmFactory.Context.Write(() => imported.Hash += "-changed");
+
+                checkBeatmapSetCount(realmFactory.Context, 1);
+                checkBeatmapCount(realmFactory.Context, 12);
+                checkSingleReferencedFileCount(realmFactory.Context, 18);
+
+                var brokenTempFilename = TestResources.GetTestBeatmapForImport();
+
+                MemoryStream brokenOsu = new MemoryStream();
+                MemoryStream brokenOsz = new MemoryStream(await File.ReadAllBytesAsync(brokenTempFilename));
+
+                File.Delete(brokenTempFilename);
+
+                using (var outStream = File.Open(brokenTempFilename, FileMode.CreateNew))
+                using (var zip = ZipArchive.Open(brokenOsz))
+                {
+                    zip.AddEntry("broken.osu", brokenOsu, false);
+                    zip.SaveTo(outStream, CompressionType.Deflate);
+                }
+
+                // this will trigger purging of the existing beatmap (online set id match) but should rollback due to broken osu.
+                try
+                {
+                    await importer.Import(new ImportTask(brokenTempFilename));
+                }
+                catch
+                {
+                }
+
+                checkBeatmapSetCount(realmFactory.Context, 1);
+                checkBeatmapCount(realmFactory.Context, 12);
+
+                checkSingleReferencedFileCount(realmFactory.Context, 18);
+
+                Assert.AreEqual(1, loggedExceptionCount);
+
+                File.Delete(brokenTempFilename);
+            });
+        }
+
+        [Test]
+        public void TestImportThenDeleteThenImport()
+        {
+            RunTestWithRealmAsync(async (realmFactory, storage) =>
+            {
+                using var importer = new BeatmapImporter(realmFactory, storage);
+                using var store = new RealmRulesetStore(realmFactory, storage);
+
+                var imported = await LoadOszIntoStore(importer, realmFactory.Context);
+
+                deleteBeatmapSet(imported, realmFactory.Context);
+
+                var importedSecondTime = await LoadOszIntoStore(importer, realmFactory.Context);
+
+                // check the newly "imported" beatmap is actually just the restored previous import. since it matches hash.
+                Assert.IsTrue(imported.ID == importedSecondTime.ID);
+                Assert.IsTrue(imported.Beatmaps.First().ID == importedSecondTime.Beatmaps.First().ID);
+            });
+        }
+
+        [Test]
+        public void TestImportThenDeleteThenImportWithOnlineIDsMissing()
+        {
+            RunTestWithRealmAsync(async (realmFactory, storage) =>
+            {
+                using var importer = new BeatmapImporter(realmFactory, storage);
+                using var store = new RealmRulesetStore(realmFactory, storage);
+
+                var imported = await LoadOszIntoStore(importer, realmFactory.Context);
+
+                realmFactory.Context.Write(() =>
+                {
+                    foreach (var b in imported.Beatmaps)
+                        b.OnlineID = null;
+                });
+
+                deleteBeatmapSet(imported, realmFactory.Context);
+
+                var importedSecondTime = await LoadOszIntoStore(importer, realmFactory.Context);
+
+                // check the newly "imported" beatmap has been reimported due to mismatch (even though hashes matched)
+                Assert.IsTrue(imported.ID != importedSecondTime.ID);
+                Assert.IsTrue(imported.Beatmaps.First().ID != importedSecondTime.Beatmaps.First().ID);
+            });
+        }
+
+        [Test]
+        public void TestImportWithDuplicateBeatmapIDs()
+        {
+            RunTestWithRealmAsync(async (realmFactory, storage) =>
+            {
+                using var importer = new BeatmapImporter(realmFactory, storage);
+                using var store = new RealmRulesetStore(realmFactory, storage);
+
+                var metadata = new RealmBeatmapMetadata
+                {
+                    Artist = "SomeArtist",
+                    Author = "SomeAuthor"
+                };
+
+                var ruleset = realmFactory.Context.All<RealmRuleset>().First();
+
+                var toImport = new RealmBeatmapSet
+                {
+                    OnlineID = 1,
+                    Beatmaps =
+                    {
+                        new RealmBeatmap(ruleset, new RealmBeatmapDifficulty(), metadata)
+                        {
+                            OnlineID = 2,
+                        },
+                        new RealmBeatmap(ruleset, new RealmBeatmapDifficulty(), metadata)
+                        {
+                            OnlineID = 2,
+                            Status = BeatmapSetOnlineStatus.Loved,
+                        }
+                    }
+                };
+
+                var imported = await importer.Import(toImport);
+
+                Assert.NotNull(imported);
+                Debug.Assert(imported != null);
+
+                Assert.AreEqual(null, imported.PerformRead(s => s.Beatmaps[0].OnlineID));
+                Assert.AreEqual(null, imported.PerformRead(s => s.Beatmaps[1].OnlineID));
+            });
+        }
+
+        [Test]
+        public void TestImportWhenFileOpen()
+        {
+            RunTestWithRealmAsync(async (realmFactory, storage) =>
+            {
+                using var importer = new BeatmapImporter(realmFactory, storage);
+                using var store = new RealmRulesetStore(realmFactory, storage);
+
+                var temp = TestResources.GetTestBeatmapForImport();
+                using (File.OpenRead(temp))
+                    await importer.Import(temp);
+                ensureLoaded(realmFactory.Context);
+                File.Delete(temp);
+                Assert.IsFalse(File.Exists(temp), "We likely held a read lock on the file when we shouldn't");
+            });
+        }
+
+        [Test]
+        public void TestImportWithDuplicateHashes()
+        {
+            RunTestWithRealmAsync(async (realmFactory, storage) =>
+            {
+                using var importer = new BeatmapImporter(realmFactory, storage);
+                using var store = new RealmRulesetStore(realmFactory, storage);
+
+                var temp = TestResources.GetTestBeatmapForImport();
+
+                string extractedFolder = $"{temp}_extracted";
+                Directory.CreateDirectory(extractedFolder);
+
+                try
+                {
+                    using (var zip = ZipArchive.Open(temp))
+                        zip.WriteToDirectory(extractedFolder);
+
+                    using (var zip = ZipArchive.Create())
+                    {
+                        zip.AddAllFromDirectory(extractedFolder);
+                        zip.AddEntry("duplicate.osu", Directory.GetFiles(extractedFolder, "*.osu").First());
+                        zip.SaveTo(temp, new ZipWriterOptions(CompressionType.Deflate));
+                    }
+
+                    await importer.Import(temp);
+
+                    ensureLoaded(realmFactory.Context);
+                }
+                finally
+                {
+                    Directory.Delete(extractedFolder, true);
+                }
+            });
+        }
+
+        [Test]
+        public void TestImportNestedStructure()
+        {
+            RunTestWithRealmAsync(async (realmFactory, storage) =>
+            {
+                using var importer = new BeatmapImporter(realmFactory, storage);
+                using var store = new RealmRulesetStore(realmFactory, storage);
+
+                var temp = TestResources.GetTestBeatmapForImport();
+
+                string extractedFolder = $"{temp}_extracted";
+                string subfolder = Path.Combine(extractedFolder, "subfolder");
+
+                Directory.CreateDirectory(subfolder);
+
+                try
+                {
+                    using (var zip = ZipArchive.Open(temp))
+                        zip.WriteToDirectory(subfolder);
+
+                    using (var zip = ZipArchive.Create())
+                    {
+                        zip.AddAllFromDirectory(extractedFolder);
+                        zip.SaveTo(temp, new ZipWriterOptions(CompressionType.Deflate));
+                    }
+
+                    var imported = await importer.Import(new ImportTask(temp));
+
+                    Assert.NotNull(imported);
+                    Debug.Assert(imported != null);
+
+                    ensureLoaded(realmFactory.Context);
+
+                    Assert.IsFalse(imported.PerformRead(s => s.Files.Any(f => f.Filename.Contains("subfolder"))), "Files contain common subfolder");
+                }
+                finally
+                {
+                    Directory.Delete(extractedFolder, true);
+                }
+            });
+        }
+
+        [Test]
+        public void TestImportWithIgnoredDirectoryInArchive()
+        {
+            RunTestWithRealmAsync(async (realmFactory, storage) =>
+            {
+                using var importer = new BeatmapImporter(realmFactory, storage);
+                using var store = new RealmRulesetStore(realmFactory, storage);
+
+                var temp = TestResources.GetTestBeatmapForImport();
+
+                string extractedFolder = $"{temp}_extracted";
+                string dataFolder = Path.Combine(extractedFolder, "actual_data");
+                string resourceForkFolder = Path.Combine(extractedFolder, "__MACOSX");
+                string resourceForkFilePath = Path.Combine(resourceForkFolder, ".extracted");
+
+                Directory.CreateDirectory(dataFolder);
+                Directory.CreateDirectory(resourceForkFolder);
+
+                using (var resourceForkFile = File.CreateText(resourceForkFilePath))
+                {
+                    await resourceForkFile.WriteLineAsync("adding content so that it's not empty");
+                }
+
+                try
+                {
+                    using (var zip = ZipArchive.Open(temp))
+                        zip.WriteToDirectory(dataFolder);
+
+                    using (var zip = ZipArchive.Create())
+                    {
+                        zip.AddAllFromDirectory(extractedFolder);
+                        zip.SaveTo(temp, new ZipWriterOptions(CompressionType.Deflate));
+                    }
+
+                    var imported = await importer.Import(new ImportTask(temp));
+
+                    Assert.NotNull(imported);
+                    Debug.Assert(imported != null);
+
+                    ensureLoaded(realmFactory.Context);
+
+                    Assert.IsFalse(imported.PerformRead(s => s.Files.Any(f => f.Filename.Contains("__MACOSX"))), "Files contain resource fork folder, which should be ignored");
+                    Assert.IsFalse(imported.PerformRead(s => s.Files.Any(f => f.Filename.Contains("actual_data"))), "Files contain common subfolder");
+                }
+                finally
+                {
+                    Directory.Delete(extractedFolder, true);
+                }
+            });
+        }
+
+        [Test]
+        public void TestUpdateBeatmapInfo()
+        {
+            RunTestWithRealmAsync(async (realmFactory, storage) =>
+            {
+                using var importer = new BeatmapImporter(realmFactory, storage);
+                using var store = new RealmRulesetStore(realmFactory, storage);
+
+                var temp = TestResources.GetTestBeatmapForImport();
+                await importer.Import(temp);
+
+                // Update via the beatmap, not the beatmap info, to ensure correct linking
+                RealmBeatmapSet setToUpdate = realmFactory.Context.All<RealmBeatmapSet>().First();
+
+                var beatmapToUpdate = setToUpdate.Beatmaps.First();
+
+                realmFactory.Context.Write(() => beatmapToUpdate.DifficultyName = "updated");
+
+                RealmBeatmap updatedInfo = realmFactory.Context.All<RealmBeatmap>().First(b => b.ID == beatmapToUpdate.ID);
+                Assert.That(updatedInfo.DifficultyName, Is.EqualTo("updated"));
+            });
+        }
+
+        public static async Task<RealmBeatmapSet?> LoadQuickOszIntoOsu(BeatmapImporter importer, Realm realm)
+        {
+            var temp = TestResources.GetQuickTestBeatmapForImport();
+
+            var importedSet = await importer.Import(new ImportTask(temp));
+
+            Assert.NotNull(importedSet);
+
+            ensureLoaded(realm);
+
+            waitForOrAssert(() => !File.Exists(temp), "Temporary file still exists after standard import", 5000);
+
+            return realm.All<RealmBeatmapSet>().FirstOrDefault(beatmapSet => beatmapSet.ID == importedSet!.ID);
+        }
+
+        public static async Task<RealmBeatmapSet> LoadOszIntoStore(BeatmapImporter importer, Realm realm, string? path = null, bool virtualTrack = false)
+        {
+            var temp = path ?? TestResources.GetTestBeatmapForImport(virtualTrack);
+
+            var importedSet = await importer.Import(new ImportTask(temp));
+
+            Assert.NotNull(importedSet);
+            Debug.Assert(importedSet != null);
+
+            ensureLoaded(realm);
+
+            waitForOrAssert(() => !File.Exists(temp), "Temporary file still exists after standard import", 5000);
+
+            return realm.All<RealmBeatmapSet>().First(beatmapSet => beatmapSet.ID == importedSet.ID);
+        }
+
+        private void deleteBeatmapSet(RealmBeatmapSet imported, Realm realm)
+        {
+            realm.Write(() => imported.DeletePending = true);
+
+            checkBeatmapSetCount(realm, 0);
+            checkBeatmapSetCount(realm, 1, true);
+
+            Assert.IsTrue(realm.All<RealmBeatmapSet>().First(_ => true).DeletePending);
+        }
+
+        private static Task createScoreForBeatmap(Realm realm, RealmBeatmap beatmap)
+        {
+            // TODO: reimplement when we have score support in realm.
+            // return ImportScoreTest.LoadScoreIntoOsu(osu, new ScoreInfo
+            // {
+            //     OnlineScoreID = 2,
+            //     Beatmap = beatmap,
+            //     BeatmapInfoID = beatmap.ID
+            // }, new ImportScoreTest.TestArchiveReader());
+
+            return Task.CompletedTask;
+        }
+
+        private static void checkBeatmapSetCount(Realm realm, int expected, bool includeDeletePending = false)
+        {
+            Assert.AreEqual(expected, includeDeletePending
+                ? realm.All<RealmBeatmapSet>().Count()
+                : realm.All<RealmBeatmapSet>().Count(s => !s.DeletePending));
+        }
+
+        private static string hashFile(string filename)
+        {
+            using (var s = File.OpenRead(filename))
+                return s.ComputeMD5Hash();
+        }
+
+        private static void checkBeatmapCount(Realm realm, int expected)
+        {
+            Assert.AreEqual(expected, realm.All<RealmBeatmap>().Where(_ => true).ToList().Count);
+        }
+
+        private static void checkSingleReferencedFileCount(Realm realm, int expected)
+        {
+            int singleReferencedCount = 0;
+
+            foreach (var f in realm.All<RealmFile>())
+            {
+                if (f.BacklinksCount == 1)
+                    singleReferencedCount++;
+            }
+
+            Assert.AreEqual(expected, singleReferencedCount);
+        }
+
+        private static void ensureLoaded(Realm realm, int timeout = 60000)
+        {
+            IQueryable<RealmBeatmapSet>? resultSets = null;
+
+            waitForOrAssert(() => (resultSets = realm.All<RealmBeatmapSet>().Where(s => s.OnlineID == 241526)).Any(),
+                @"BeatmapSet did not import to the database in allocated time.", timeout);
+
+            // ensure we were stored to beatmap database backing...
+            Assert.IsTrue(resultSets?.Count() == 1, $@"Incorrect result count found ({resultSets?.Count()} but should be 1).");
+
+            IEnumerable<RealmBeatmapSet> queryBeatmapSets() => realm.All<RealmBeatmapSet>().Where(s => !s.DeletePending && s.OnlineID == 241526);
+
+            var set = queryBeatmapSets().First();
+
+            // ReSharper disable once PossibleUnintendedReferenceComparison
+            IEnumerable<RealmBeatmap> queryBeatmaps() => realm.All<RealmBeatmap>().Where(s => s.BeatmapSet != null && s.BeatmapSet == set);
+
+            waitForOrAssert(() => queryBeatmaps().Count() == 12, @"Beatmaps did not import to the database in allocated time", timeout);
+            waitForOrAssert(() => queryBeatmapSets().Count() == 1, @"BeatmapSet did not import to the database in allocated time", timeout);
+
+            int countBeatmapSetBeatmaps = 0;
+            int countBeatmaps = 0;
+
+            waitForOrAssert(() =>
+                    (countBeatmapSetBeatmaps = queryBeatmapSets().First().Beatmaps.Count) ==
+                    (countBeatmaps = queryBeatmaps().Count()),
+                $@"Incorrect database beatmap count post-import ({countBeatmaps} but should be {countBeatmapSetBeatmaps}).", timeout);
+
+            foreach (RealmBeatmap b in set.Beatmaps)
+                Assert.IsTrue(set.Beatmaps.Any(c => c.OnlineID == b.OnlineID));
+            Assert.IsTrue(set.Beatmaps.Count > 0);
+        }
+
+        private static void waitForOrAssert(Func<bool> result, string failureMessage, int timeout = 60000)
+        {
+            const int sleep = 200;
+
+            while (timeout > 0)
+            {
+                Thread.Sleep(sleep);
+                timeout -= sleep;
+
+                if (result())
+                    return;
+            }
+
+            Assert.Fail(failureMessage);
+        }
+    }
+}
diff --git a/osu.Game/Database/IPostImports.cs b/osu.Game/Database/IPostImports.cs
index f09285089a..b3b83f23ef 100644
--- a/osu.Game/Database/IPostImports.cs
+++ b/osu.Game/Database/IPostImports.cs
@@ -4,6 +4,8 @@
 using System;
 using System.Collections.Generic;
 
+#nullable enable
+
 namespace osu.Game.Database
 {
     public interface IPostImports<out TModel>
@@ -12,6 +14,6 @@ namespace osu.Game.Database
         /// <summary>
         /// Fired when the user requests to view the resulting import.
         /// </summary>
-        public Action<IEnumerable<ILive<TModel>>> PostImport { set; }
+        public Action<IEnumerable<ILive<TModel>>>? PostImport { set; }
     }
 }
diff --git a/osu.Game/Stores/ArchiveModelImporter.cs b/osu.Game/Stores/ArchiveModelImporter.cs
index c165dbecd8..640a031e42 100644
--- a/osu.Game/Stores/ArchiveModelImporter.cs
+++ b/osu.Game/Stores/ArchiveModelImporter.cs
@@ -64,7 +64,7 @@ namespace osu.Game.Stores
         /// <summary>
         /// Fired when the user requests to view the resulting import.
         /// </summary>
-        public Action<IEnumerable<ILive<TModel>>>? PresentImport;
+        public Action<IEnumerable<ILive<TModel>>>? PostImport { get; set; }
 
         /// <summary>
         /// Set an endpoint for notifications to be posted to.
@@ -172,12 +172,12 @@ namespace osu.Game.Stores
                     ? $"Imported {imported.First()}!"
                     : $"Imported {imported.Count} {HumanisedModelName}s!";
 
-                if (imported.Count > 0 && PresentImport != null)
+                if (imported.Count > 0 && PostImport != null)
                 {
                     notification.CompletionText += " Click to view.";
                     notification.CompletionClickAction = () =>
                     {
-                        PresentImport?.Invoke(imported);
+                        PostImport?.Invoke(imported);
                         return true;
                     };
                 }

From cd64faa4f91da349c23f861f4bf9d89964764950 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 11 Oct 2021 14:33:47 +0900
Subject: [PATCH 0266/5547] Tidy up importer difficulty creation code

---
 osu.Game/Stores/BeatmapImporter.cs | 133 ++++++++++++++---------------
 1 file changed, 66 insertions(+), 67 deletions(-)

diff --git a/osu.Game/Stores/BeatmapImporter.cs b/osu.Game/Stores/BeatmapImporter.cs
index 95d2c4fe7b..2b8615f072 100644
--- a/osu.Game/Stores/BeatmapImporter.cs
+++ b/osu.Game/Stores/BeatmapImporter.cs
@@ -201,102 +201,96 @@ namespace osu.Game.Stores
 
             foreach (var file in files.Where(f => f.Filename.EndsWith(".osu", StringComparison.OrdinalIgnoreCase)))
             {
-                using (var raw = Files.Store.GetStream(file.File.StoragePath))
-                using (var ms = new MemoryStream()) // we need a memory stream so we can seek
-                using (var sr = new LineBufferedReader(ms))
+                using (var memoryStream = new MemoryStream(Files.Store.Get(file.File.StoragePath))) // we need a memory stream so we can seek
                 {
-                    raw.CopyTo(ms);
-                    ms.Position = 0;
+                    IBeatmap decoded;
+                    using (var lineReader = new LineBufferedReader(memoryStream, true))
+                        decoded = Decoder.GetDecoder<Beatmap>(lineReader).Decode(lineReader);
 
-                    var decoder = Decoder.GetDecoder<Beatmap>(sr);
-                    IBeatmap beatmap = decoder.Decode(sr);
-
-                    string hash = ms.ComputeSHA2Hash();
+                    string hash = memoryStream.ComputeSHA2Hash();
 
                     if (beatmaps.Any(b => b.Hash == hash))
-                        continue;
-
-                    var beatmapInfo = beatmap.BeatmapInfo;
-
-                    var ruleset = realm.All<RealmRuleset>().FirstOrDefault(r => r.OnlineID == beatmapInfo.RulesetID);
-                    var rulesetInstance = (ruleset as IRulesetInfo)?.CreateInstance();
-
-                    if (ruleset == null || rulesetInstance == null)
                     {
-                        Logger.Log($"Skipping import due to missing local ruleset {beatmapInfo.RulesetID}.", LoggingTarget.Database);
+                        Logger.Log($"Skipping import of {file.Filename} due to duplicate file content.", LoggingTarget.Database);
                         continue;
                     }
 
-                    beatmapInfo.Path = file.Filename;
-                    beatmapInfo.Hash = hash;
-                    beatmapInfo.MD5Hash = ms.ComputeMD5Hash();
+                    var decodedInfo = decoded.BeatmapInfo;
+                    var decodedDifficulty = decodedInfo.BaseDifficulty;
 
-                    // TODO: this should be done in a better place once we actually need to dynamically update it.
-                    beatmap.BeatmapInfo.Ruleset = rulesetInstance.RulesetInfo;
-                    beatmap.BeatmapInfo.StarDifficulty = rulesetInstance.CreateDifficultyCalculator(new DummyConversionBeatmap(beatmap)).Calculate().StarRating;
-                    beatmap.BeatmapInfo.Length = calculateLength(beatmap);
-                    beatmap.BeatmapInfo.BPM = 60000 / beatmap.GetMostCommonBeatLength();
+                    var ruleset = realm.All<RealmRuleset>().FirstOrDefault(r => r.OnlineID == decodedInfo.RulesetID);
+
+                    if (ruleset?.Available != true)
+                    {
+                        Logger.Log($"Skipping import of {file.Filename} due to missing local ruleset {decodedInfo.RulesetID}.", LoggingTarget.Database);
+                        continue;
+                    }
 
                     var difficulty = new RealmBeatmapDifficulty
                     {
-                        DrainRate = beatmapInfo.BaseDifficulty.DrainRate,
-                        CircleSize = beatmapInfo.BaseDifficulty.CircleSize,
-                        OverallDifficulty = beatmapInfo.BaseDifficulty.OverallDifficulty,
-                        ApproachRate = beatmapInfo.BaseDifficulty.ApproachRate,
-                        SliderMultiplier = beatmapInfo.BaseDifficulty.SliderMultiplier,
-                        SliderTickRate = beatmapInfo.BaseDifficulty.SliderTickRate,
+                        DrainRate = decodedDifficulty.DrainRate,
+                        CircleSize = decodedDifficulty.CircleSize,
+                        OverallDifficulty = decodedDifficulty.OverallDifficulty,
+                        ApproachRate = decodedDifficulty.ApproachRate,
+                        SliderMultiplier = decodedDifficulty.SliderMultiplier,
+                        SliderTickRate = decodedDifficulty.SliderTickRate,
                     };
 
                     var metadata = new RealmBeatmapMetadata
                     {
-                        Title = beatmap.Metadata.Title,
-                        TitleUnicode = beatmap.Metadata.TitleUnicode,
-                        Artist = beatmap.Metadata.Artist,
-                        ArtistUnicode = beatmap.Metadata.ArtistUnicode,
-                        Author = beatmap.Metadata.AuthorString,
-                        Source = beatmap.Metadata.Source,
-                        Tags = beatmap.Metadata.Tags,
-                        PreviewTime = beatmap.Metadata.PreviewTime,
-                        AudioFile = beatmap.Metadata.AudioFile,
-                        BackgroundFile = beatmap.Metadata.BackgroundFile,
+                        Title = decoded.Metadata.Title,
+                        TitleUnicode = decoded.Metadata.TitleUnicode,
+                        Artist = decoded.Metadata.Artist,
+                        ArtistUnicode = decoded.Metadata.ArtistUnicode,
+                        Author = decoded.Metadata.AuthorString,
+                        Source = decoded.Metadata.Source,
+                        Tags = decoded.Metadata.Tags,
+                        PreviewTime = decoded.Metadata.PreviewTime,
+                        AudioFile = decoded.Metadata.AudioFile,
+                        BackgroundFile = decoded.Metadata.BackgroundFile,
                     };
 
-                    var realmBeatmap = new RealmBeatmap(ruleset, difficulty, metadata)
+                    var beatmap = new RealmBeatmap(ruleset, difficulty, metadata)
                     {
-                        DifficultyName = beatmapInfo.Version,
-                        OnlineID = beatmapInfo.OnlineBeatmapID,
-                        Length = beatmapInfo.Length,
-                        BPM = beatmapInfo.BPM,
-                        Hash = beatmapInfo.Hash,
-                        StarRating = beatmapInfo.StarDifficulty,
-                        MD5Hash = beatmapInfo.MD5Hash,
-                        Hidden = beatmapInfo.Hidden,
-                        AudioLeadIn = beatmapInfo.AudioLeadIn,
-                        StackLeniency = beatmapInfo.StackLeniency,
-                        SpecialStyle = beatmapInfo.SpecialStyle,
-                        LetterboxInBreaks = beatmapInfo.LetterboxInBreaks,
-                        WidescreenStoryboard = beatmapInfo.WidescreenStoryboard,
-                        EpilepsyWarning = beatmapInfo.EpilepsyWarning,
-                        SamplesMatchPlaybackRate = beatmapInfo.SamplesMatchPlaybackRate,
-                        DistanceSpacing = beatmapInfo.DistanceSpacing,
-                        BeatDivisor = beatmapInfo.BeatDivisor,
-                        GridSize = beatmapInfo.GridSize,
-                        TimelineZoom = beatmapInfo.TimelineZoom,
+                        Hash = hash,
+                        DifficultyName = decodedInfo.Version,
+                        OnlineID = decodedInfo.OnlineBeatmapID,
+                        AudioLeadIn = decodedInfo.AudioLeadIn,
+                        StackLeniency = decodedInfo.StackLeniency,
+                        SpecialStyle = decodedInfo.SpecialStyle,
+                        LetterboxInBreaks = decodedInfo.LetterboxInBreaks,
+                        WidescreenStoryboard = decodedInfo.WidescreenStoryboard,
+                        EpilepsyWarning = decodedInfo.EpilepsyWarning,
+                        SamplesMatchPlaybackRate = decodedInfo.SamplesMatchPlaybackRate,
+                        DistanceSpacing = decodedInfo.DistanceSpacing,
+                        BeatDivisor = decodedInfo.BeatDivisor,
+                        GridSize = decodedInfo.GridSize,
+                        TimelineZoom = decodedInfo.TimelineZoom,
+                        MD5Hash = memoryStream.ComputeMD5Hash(),
                     };
 
-                    // TODO: IBeatmap.BeatmapInfo needs to be updated to the new interface.
-                    // beatmaps.Add(beatmap.BeatmapInfo);
+                    updateBeatmapStatistics(beatmap, decoded);
 
-                    beatmaps.Add(realmBeatmap);
+                    beatmaps.Add(beatmap);
                 }
             }
 
             return beatmaps;
         }
 
-        public void Dispose()
+        private void updateBeatmapStatistics(RealmBeatmap beatmap, IBeatmap decoded)
         {
-            onlineLookupQueue?.Dispose();
+            var rulesetInstance = ((IRulesetInfo)beatmap.Ruleset).CreateInstance();
+
+            if (rulesetInstance == null)
+                return;
+
+            decoded.BeatmapInfo.Ruleset = rulesetInstance.RulesetInfo;
+
+            // TODO: this should be done in a better place once we actually need to dynamically update it.
+            beatmap.StarRating = rulesetInstance.CreateDifficultyCalculator(new DummyConversionBeatmap(decoded)).Calculate().StarRating;
+            beatmap.Length = calculateLength(decoded);
+            beatmap.BPM = 60000 / decoded.GetMostCommonBeatLength();
         }
 
         private double calculateLength(IBeatmap b)
@@ -313,6 +307,11 @@ namespace osu.Game.Stores
             return endTime - startTime;
         }
 
+        public void Dispose()
+        {
+            onlineLookupQueue?.Dispose();
+        }
+
         /// <summary>
         /// A dummy WorkingBeatmap for the purpose of retrieving a beatmap for star difficulty calculation.
         /// </summary>

From 0e1f144bf4519463f6fcc968009c032c7eee02dc Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 15 Oct 2021 17:08:43 +0900
Subject: [PATCH 0267/5547] Rename `ArchiveModelImporter` with `Realm` prefix
 to avoid confusion

---
 osu.Game/Stores/BeatmapImporter.cs                     |  2 +-
 ...veModelImporter.cs => RealmArchiveModelImporter.cs} | 10 +++++-----
 2 files changed, 6 insertions(+), 6 deletions(-)
 rename osu.Game/Stores/{ArchiveModelImporter.cs => RealmArchiveModelImporter.cs} (98%)

diff --git a/osu.Game/Stores/BeatmapImporter.cs b/osu.Game/Stores/BeatmapImporter.cs
index 2b8615f072..33276bff2f 100644
--- a/osu.Game/Stores/BeatmapImporter.cs
+++ b/osu.Game/Stores/BeatmapImporter.cs
@@ -34,7 +34,7 @@ namespace osu.Game.Stores
     /// Handles the storage and retrieval of Beatmaps/WorkingBeatmaps.
     /// </summary>
     [ExcludeFromDynamicCompile]
-    public class BeatmapImporter : ArchiveModelImporter<RealmBeatmapSet>, IDisposable
+    public class BeatmapImporter : RealmArchiveModelImporter<RealmBeatmapSet>, IDisposable
     {
         public override IEnumerable<string> HandledExtensions => new[] { ".osz" };
 
diff --git a/osu.Game/Stores/ArchiveModelImporter.cs b/osu.Game/Stores/RealmArchiveModelImporter.cs
similarity index 98%
rename from osu.Game/Stores/ArchiveModelImporter.cs
rename to osu.Game/Stores/RealmArchiveModelImporter.cs
index 640a031e42..cc61896ea5 100644
--- a/osu.Game/Stores/ArchiveModelImporter.cs
+++ b/osu.Game/Stores/RealmArchiveModelImporter.cs
@@ -29,7 +29,7 @@ namespace osu.Game.Stores
     /// Adds cross-functionality with <see cref="RealmFileStore"/> to give access to the central file store for the provided model.
     /// </summary>
     /// <typeparam name="TModel">The model type.</typeparam>
-    public abstract class ArchiveModelImporter<TModel> : IModelImporter<TModel>
+    public abstract class RealmArchiveModelImporter<TModel> : IModelImporter<TModel>
         where TModel : RealmObject, IHasRealmFiles, IHasGuidPrimaryKey, ISoftDelete
     {
         private const int import_queue_request_concurrency = 1;
@@ -40,20 +40,20 @@ namespace osu.Game.Stores
         private const int low_priority_import_batch_size = 1;
 
         /// <summary>
-        /// A singleton scheduler shared by all <see cref="ArchiveModelImporter{TModel}"/>.
+        /// A singleton scheduler shared by all <see cref="RealmArchiveModelImporter{TModel}"/>.
         /// </summary>
         /// <remarks>
         /// This scheduler generally performs IO and CPU intensive work so concurrency is limited harshly.
         /// It is mainly being used as a queue mechanism for large imports.
         /// </remarks>
-        private static readonly ThreadedTaskScheduler import_scheduler = new ThreadedTaskScheduler(import_queue_request_concurrency, nameof(ArchiveModelImporter<TModel>));
+        private static readonly ThreadedTaskScheduler import_scheduler = new ThreadedTaskScheduler(import_queue_request_concurrency, nameof(RealmArchiveModelImporter<TModel>));
 
         /// <summary>
         /// A second scheduler for lower priority imports.
         /// For simplicity, these will just run in parallel with normal priority imports, but a future refactor would see this implemented via a custom scheduler/queue.
         /// See https://gist.github.com/peppy/f0e118a14751fc832ca30dd48ba3876b for an incomplete version of this.
         /// </summary>
-        private static readonly ThreadedTaskScheduler import_scheduler_low_priority = new ThreadedTaskScheduler(import_queue_request_concurrency, nameof(ArchiveModelImporter<TModel>));
+        private static readonly ThreadedTaskScheduler import_scheduler_low_priority = new ThreadedTaskScheduler(import_queue_request_concurrency, nameof(RealmArchiveModelImporter<TModel>));
 
         public virtual IEnumerable<string> HandledExtensions => new[] { @".zip" };
 
@@ -71,7 +71,7 @@ namespace osu.Game.Stores
         /// </summary>
         public Action<Notification>? PostNotification { protected get; set; }
 
-        protected ArchiveModelImporter(Storage storage, RealmContextFactory contextFactory)
+        protected RealmArchiveModelImporter(Storage storage, RealmContextFactory contextFactory)
         {
             ContextFactory = contextFactory;
 

From ae33b7b87f00112247449fcd4a2e7b44f9962b81 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 15 Oct 2021 18:27:01 +0900
Subject: [PATCH 0268/5547] Update resources

---
 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 f2052b2563..f552aff2f2 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -51,7 +51,7 @@
     <Reference Include="Java.Interop" />
   </ItemGroup>
   <ItemGroup>
-    <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1004.0" />
+    <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1015.0" />
     <PackageReference Include="ppy.osu.Framework.Android" Version="2021.1014.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index af7e9f80c4..32d6eeab29 100644
--- a/osu.Game/osu.Game.csproj
+++ b/osu.Game/osu.Game.csproj
@@ -37,7 +37,7 @@
     </PackageReference>
     <PackageReference Include="Realm" Version="10.6.0" />
     <PackageReference Include="ppy.osu.Framework" Version="2021.1014.0" />
-    <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1004.0" />
+    <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1015.0" />
     <PackageReference Include="Sentry" Version="3.9.4" />
     <PackageReference Include="SharpCompress" Version="0.29.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
diff --git a/osu.iOS.props b/osu.iOS.props
index b3bce3f0ea..92abab036a 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -71,7 +71,7 @@
   </ItemGroup>
   <ItemGroup Label="Package References">
     <PackageReference Include="ppy.osu.Framework.iOS" Version="2021.1014.0" />
-    <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1004.0" />
+    <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1015.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net5.0 / net6.0) -->
   <PropertyGroup>

From 66f3370a190b1ea8a0d647fb7007abcd96b4b75b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 15 Oct 2021 19:14:59 +0900
Subject: [PATCH 0269/5547] Add new fail animation to better match new sound
 effects

---
 osu.Game/Screens/Play/FailAnimation.cs |  46 +++++++++--
 osu.Game/Screens/Play/Player.cs        | 102 +++++++++++++------------
 2 files changed, 95 insertions(+), 53 deletions(-)

diff --git a/osu.Game/Screens/Play/FailAnimation.cs b/osu.Game/Screens/Play/FailAnimation.cs
index 8c1f11718d..d4fc289991 100644
--- a/osu.Game/Screens/Play/FailAnimation.cs
+++ b/osu.Game/Screens/Play/FailAnimation.cs
@@ -12,6 +12,7 @@ using osu.Framework.Audio.Sample;
 using osu.Framework.Audio.Track;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.Shapes;
 using osu.Framework.Utils;
 using osu.Game.Audio.Effects;
 using osu.Game.Beatmaps;
@@ -25,14 +26,15 @@ namespace osu.Game.Screens.Play
     /// Manage the animation to be applied when a player fails.
     /// Single use and automatically disposed after use.
     /// </summary>
-    public class FailAnimation : CompositeDrawable
+    public class FailAnimation : Container
     {
         public Action OnComplete;
 
         private readonly DrawableRuleset drawableRuleset;
-
         private readonly BindableDouble trackFreq = new BindableDouble(1);
 
+        private Box failFlash;
+
         private Track track;
 
         private AudioFilter failLowPassFilter;
@@ -42,9 +44,18 @@ namespace osu.Game.Screens.Play
 
         private Sample failSample;
 
+        protected override Container<Drawable> Content { get; } = new Container
+        {
+            Anchor = Anchor.Centre,
+            Origin = Anchor.Centre,
+            RelativeSizeAxes = Axes.Both,
+        };
+
         public FailAnimation(DrawableRuleset drawableRuleset)
         {
             this.drawableRuleset = drawableRuleset;
+
+            RelativeSizeAxes = Axes.Both;
         }
 
         [BackgroundDependencyLoader]
@@ -53,8 +64,20 @@ namespace osu.Game.Screens.Play
             track = beatmap.Value.Track;
             failSample = audio.Samples.Get(@"Gameplay/failsound");
 
-            AddInternal(failLowPassFilter = new AudioFilter(audio.TrackMixer));
-            AddInternal(failHighPassFilter = new AudioFilter(audio.TrackMixer, BQFType.HighPass));
+            AddRangeInternal(new Drawable[]
+            {
+                failLowPassFilter = new AudioFilter(audio.TrackMixer),
+                failHighPassFilter = new AudioFilter(audio.TrackMixer, BQFType.HighPass),
+                Content,
+                failFlash = new Box
+                {
+                    Colour = Color4.Red,
+                    RelativeSizeAxes = Axes.Both,
+                    Blending = BlendingParameters.Additive,
+                    Depth = float.MinValue,
+                    Alpha = 0
+                },
+            });
         }
 
         private bool started;
@@ -81,8 +104,21 @@ namespace osu.Game.Screens.Play
             track.AddAdjustment(AdjustableProperty.Frequency, trackFreq);
 
             applyToPlayfield(drawableRuleset.Playfield);
-            drawableRuleset.Playfield.HitObjectContainer.FlashColour(Color4.Red, 500);
             drawableRuleset.Playfield.HitObjectContainer.FadeOut(duration / 2);
+
+            failFlash.FadeOutFromOne(1000);
+
+            Content.Masking = true;
+
+            Content.Add(new Box
+            {
+                Colour = Color4.Black,
+                RelativeSizeAxes = Axes.Both,
+                Depth = float.MaxValue
+            });
+
+            Content.ScaleTo(0.85f, duration, Easing.OutQuint);
+            Content.RotateTo(1, duration, Easing.OutQuint);
         }
 
         protected override void Update()
diff --git a/osu.Game/Screens/Play/Player.cs b/osu.Game/Screens/Play/Player.cs
index 444bea049b..9199e8c247 100644
--- a/osu.Game/Screens/Play/Player.cs
+++ b/osu.Game/Screens/Play/Player.cs
@@ -339,54 +339,8 @@ namespace osu.Game.Screens.Play
             var container = new Container
             {
                 RelativeSizeAxes = Axes.Both,
-                Children = new[]
+                Children = new Drawable[]
                 {
-                    DimmableStoryboard.OverlayLayerContainer.CreateProxy(),
-                    BreakOverlay = new BreakOverlay(working.Beatmap.BeatmapInfo.LetterboxInBreaks, ScoreProcessor)
-                    {
-                        Clock = DrawableRuleset.FrameStableClock,
-                        ProcessCustomClock = false,
-                        Breaks = working.Beatmap.Breaks
-                    },
-                    // display the cursor above some HUD elements.
-                    DrawableRuleset.Cursor?.CreateProxy() ?? new Container(),
-                    DrawableRuleset.ResumeOverlay?.CreateProxy() ?? new Container(),
-                    HUDOverlay = new HUDOverlay(DrawableRuleset, GameplayState.Mods)
-                    {
-                        HoldToQuit =
-                        {
-                            Action = () => PerformExit(true),
-                            IsPaused = { BindTarget = GameplayClockContainer.IsPaused }
-                        },
-                        KeyCounter =
-                        {
-                            AlwaysVisible = { BindTarget = DrawableRuleset.HasReplayLoaded },
-                            IsCounting = false
-                        },
-                        Anchor = Anchor.Centre,
-                        Origin = Anchor.Centre
-                    },
-                    skipIntroOverlay = new SkipOverlay(DrawableRuleset.GameplayStartTime)
-                    {
-                        RequestSkip = performUserRequestedSkip
-                    },
-                    skipOutroOverlay = new SkipOverlay(Beatmap.Value.Storyboard.LatestEventTime ?? 0)
-                    {
-                        RequestSkip = () => progressToResults(false),
-                        Alpha = 0
-                    },
-                    FailOverlay = new FailOverlay
-                    {
-                        OnRetry = Restart,
-                        OnQuit = () => PerformExit(true),
-                    },
-                    PauseOverlay = new PauseOverlay
-                    {
-                        OnResume = Resume,
-                        Retries = RestartCount,
-                        OnRetry = Restart,
-                        OnQuit = () => PerformExit(true),
-                    },
                     new HotkeyExitOverlay
                     {
                         Action = () =>
@@ -397,7 +351,59 @@ namespace osu.Game.Screens.Play
                             PerformExit(false);
                         },
                     },
-                    failAnimation = new FailAnimation(DrawableRuleset) { OnComplete = onFailComplete, },
+                    failAnimation = new FailAnimation(DrawableRuleset)
+                    {
+                        OnComplete = onFailComplete,
+                        Children = new[]
+                        {
+                            DimmableStoryboard.OverlayLayerContainer.CreateProxy(),
+                            BreakOverlay = new BreakOverlay(working.Beatmap.BeatmapInfo.LetterboxInBreaks, ScoreProcessor)
+                            {
+                                Clock = DrawableRuleset.FrameStableClock,
+                                ProcessCustomClock = false,
+                                Breaks = working.Beatmap.Breaks
+                            },
+                            // display the cursor above some HUD elements.
+                            DrawableRuleset.Cursor?.CreateProxy() ?? new Container(),
+                            DrawableRuleset.ResumeOverlay?.CreateProxy() ?? new Container(),
+                            HUDOverlay = new HUDOverlay(DrawableRuleset, GameplayState.Mods)
+                            {
+                                HoldToQuit =
+                                {
+                                    Action = () => PerformExit(true),
+                                    IsPaused = { BindTarget = GameplayClockContainer.IsPaused }
+                                },
+                                KeyCounter =
+                                {
+                                    AlwaysVisible = { BindTarget = DrawableRuleset.HasReplayLoaded },
+                                    IsCounting = false
+                                },
+                                Anchor = Anchor.Centre,
+                                Origin = Anchor.Centre
+                            },
+                            skipIntroOverlay = new SkipOverlay(DrawableRuleset.GameplayStartTime)
+                            {
+                                RequestSkip = performUserRequestedSkip
+                            },
+                            skipOutroOverlay = new SkipOverlay(Beatmap.Value.Storyboard.LatestEventTime ?? 0)
+                            {
+                                RequestSkip = () => progressToResults(false),
+                                Alpha = 0
+                            },
+                            PauseOverlay = new PauseOverlay
+                            {
+                                OnResume = Resume,
+                                Retries = RestartCount,
+                                OnRetry = Restart,
+                                OnQuit = () => PerformExit(true),
+                            },
+                        }
+                    },
+                    FailOverlay = new FailOverlay
+                    {
+                        OnRetry = Restart,
+                        OnQuit = () => PerformExit(true),
+                    }
                 }
             };
 

From b08743342b6f6a8681d76e9d12b8867dc537d715 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 15 Oct 2021 19:35:08 +0900
Subject: [PATCH 0270/5547] Fix incorrect nesting

---
 osu.Game/Screens/Play/Player.cs | 121 ++++++++++++++++----------------
 1 file changed, 62 insertions(+), 59 deletions(-)

diff --git a/osu.Game/Screens/Play/Player.cs b/osu.Game/Screens/Play/Player.cs
index 9199e8c247..b4bd658a83 100644
--- a/osu.Game/Screens/Play/Player.cs
+++ b/osu.Game/Screens/Play/Player.cs
@@ -230,17 +230,32 @@ namespace osu.Game.Screens.Play
             // this is intentionally done in two stages to ensure things are in a loaded state before exposing the ruleset to skin sources.
             GameplayClockContainer.Add(rulesetSkinProvider);
 
-            rulesetSkinProvider.AddRange(new[]
+            rulesetSkinProvider.AddRange(new Drawable[]
             {
-                // underlay and gameplay should have access to the skinning sources.
-                createUnderlayComponents(),
-                createGameplayComponents(Beatmap.Value, playableBeatmap)
+                failAnimationLayer = new FailAnimation(DrawableRuleset)
+                {
+                    OnComplete = onFailComplete,
+                    Children = new[]
+                    {
+                        // underlay and gameplay should have access to the skinning sources.
+                        createUnderlayComponents(),
+                        createGameplayComponents(Beatmap.Value, playableBeatmap)
+                    }
+                },
+                FailOverlay = new FailOverlay
+                {
+                    OnRetry = Restart,
+                    OnQuit = () => PerformExit(true),
+                }
             });
 
             // add the overlay components as a separate step as they proxy some elements from the above underlay/gameplay components.
             // also give the overlays the ruleset skin provider to allow rulesets to potentially override HUD elements (used to disable combo counters etc.)
             // we may want to limit this in the future to disallow rulesets from outright replacing elements the user expects to be there.
-            rulesetSkinProvider.Add(createOverlayComponents(Beatmap.Value));
+            failAnimationLayer.AddRange(new[]
+            {
+                createOverlayComponents(Beatmap.Value),
+            });
 
             if (!DrawableRuleset.AllowGameplayOverlays)
             {
@@ -339,7 +354,7 @@ namespace osu.Game.Screens.Play
             var container = new Container
             {
                 RelativeSizeAxes = Axes.Both,
-                Children = new Drawable[]
+                Children = new[]
                 {
                     new HotkeyExitOverlay
                     {
@@ -351,60 +366,48 @@ namespace osu.Game.Screens.Play
                             PerformExit(false);
                         },
                     },
-                    failAnimation = new FailAnimation(DrawableRuleset)
+                    DimmableStoryboard.OverlayLayerContainer.CreateProxy(),
+                    BreakOverlay = new BreakOverlay(working.Beatmap.BeatmapInfo.LetterboxInBreaks, ScoreProcessor)
                     {
-                        OnComplete = onFailComplete,
-                        Children = new[]
-                        {
-                            DimmableStoryboard.OverlayLayerContainer.CreateProxy(),
-                            BreakOverlay = new BreakOverlay(working.Beatmap.BeatmapInfo.LetterboxInBreaks, ScoreProcessor)
-                            {
-                                Clock = DrawableRuleset.FrameStableClock,
-                                ProcessCustomClock = false,
-                                Breaks = working.Beatmap.Breaks
-                            },
-                            // display the cursor above some HUD elements.
-                            DrawableRuleset.Cursor?.CreateProxy() ?? new Container(),
-                            DrawableRuleset.ResumeOverlay?.CreateProxy() ?? new Container(),
-                            HUDOverlay = new HUDOverlay(DrawableRuleset, GameplayState.Mods)
-                            {
-                                HoldToQuit =
-                                {
-                                    Action = () => PerformExit(true),
-                                    IsPaused = { BindTarget = GameplayClockContainer.IsPaused }
-                                },
-                                KeyCounter =
-                                {
-                                    AlwaysVisible = { BindTarget = DrawableRuleset.HasReplayLoaded },
-                                    IsCounting = false
-                                },
-                                Anchor = Anchor.Centre,
-                                Origin = Anchor.Centre
-                            },
-                            skipIntroOverlay = new SkipOverlay(DrawableRuleset.GameplayStartTime)
-                            {
-                                RequestSkip = performUserRequestedSkip
-                            },
-                            skipOutroOverlay = new SkipOverlay(Beatmap.Value.Storyboard.LatestEventTime ?? 0)
-                            {
-                                RequestSkip = () => progressToResults(false),
-                                Alpha = 0
-                            },
-                            PauseOverlay = new PauseOverlay
-                            {
-                                OnResume = Resume,
-                                Retries = RestartCount,
-                                OnRetry = Restart,
-                                OnQuit = () => PerformExit(true),
-                            },
-                        }
+                        Clock = DrawableRuleset.FrameStableClock,
+                        ProcessCustomClock = false,
+                        Breaks = working.Beatmap.Breaks
                     },
-                    FailOverlay = new FailOverlay
+                    // display the cursor above some HUD elements.
+                    DrawableRuleset.Cursor?.CreateProxy() ?? new Container(),
+                    DrawableRuleset.ResumeOverlay?.CreateProxy() ?? new Container(),
+                    HUDOverlay = new HUDOverlay(DrawableRuleset, GameplayState.Mods)
                     {
+                        HoldToQuit =
+                        {
+                            Action = () => PerformExit(true),
+                            IsPaused = { BindTarget = GameplayClockContainer.IsPaused }
+                        },
+                        KeyCounter =
+                        {
+                            AlwaysVisible = { BindTarget = DrawableRuleset.HasReplayLoaded },
+                            IsCounting = false
+                        },
+                        Anchor = Anchor.Centre,
+                        Origin = Anchor.Centre
+                    },
+                    skipIntroOverlay = new SkipOverlay(DrawableRuleset.GameplayStartTime)
+                    {
+                        RequestSkip = performUserRequestedSkip
+                    },
+                    skipOutroOverlay = new SkipOverlay(Beatmap.Value.Storyboard.LatestEventTime ?? 0)
+                    {
+                        RequestSkip = () => progressToResults(false),
+                        Alpha = 0
+                    },
+                    PauseOverlay = new PauseOverlay
+                    {
+                        OnResume = Resume,
+                        Retries = RestartCount,
                         OnRetry = Restart,
                         OnQuit = () => PerformExit(true),
-                    }
-                }
+                    },
+                },
             };
 
             if (!Configuration.AllowSkipping || !DrawableRuleset.AllowGameplayOverlays)
@@ -547,7 +550,7 @@ namespace osu.Game.Screens.Play
                 // if the fail animation is currently in progress, accelerate it (it will show the pause dialog on completion).
                 if (ValidForResume && HasFailed)
                 {
-                    failAnimation.FinishTransforms(true);
+                    failAnimationLayer.FinishTransforms(true);
                     return;
                 }
 
@@ -772,7 +775,7 @@ namespace osu.Game.Screens.Play
 
         protected FailOverlay FailOverlay { get; private set; }
 
-        private FailAnimation failAnimation;
+        private FailAnimation failAnimationLayer;
 
         private bool onFail()
         {
@@ -788,7 +791,7 @@ namespace osu.Game.Screens.Play
             if (PauseOverlay.State.Value == Visibility.Visible)
                 PauseOverlay.Hide();
 
-            failAnimation.Start();
+            failAnimationLayer.Start();
 
             if (GameplayState.Mods.OfType<IApplicableFailOverride>().Any(m => m.RestartOnFail))
                 Restart();
@@ -962,7 +965,7 @@ namespace osu.Game.Screens.Play
         public override bool OnExiting(IScreen next)
         {
             screenSuspension?.RemoveAndDisposeImmediately();
-            failAnimation?.RemoveAndDisposeImmediately();
+            failAnimationLayer?.RemoveAndDisposeImmediately();
 
             // if arriving here and the results screen preparation task hasn't run, it's safe to say the user has not completed the beatmap.
             if (prepareScoreForDisplayTask == null)

From b9fd1f52dfe392fd0f4fbf0ce535a0790d2849cc Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 15 Oct 2021 19:37:22 +0900
Subject: [PATCH 0271/5547] Tweak animation slightly

---
 osu.Game/Screens/Play/FailAnimation.cs | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/Play/FailAnimation.cs b/osu.Game/Screens/Play/FailAnimation.cs
index d4fc289991..1e2e020824 100644
--- a/osu.Game/Screens/Play/FailAnimation.cs
+++ b/osu.Game/Screens/Play/FailAnimation.cs
@@ -117,8 +117,9 @@ namespace osu.Game.Screens.Play
                 Depth = float.MaxValue
             });
 
-            Content.ScaleTo(0.85f, duration, Easing.OutQuint);
-            Content.RotateTo(1, duration, Easing.OutQuint);
+            Content.ScaleTo(0.85f, duration, Easing.OutQuart);
+            Content.RotateTo(1, duration, Easing.OutQuart);
+            Content.FadeColour(Color4.Gray, duration);
         }
 
         protected override void Update()

From 3909fd8caa26d0f1ba784508923f71db2a36d6ef Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 15 Oct 2021 19:43:57 +0900
Subject: [PATCH 0272/5547] Fix wonkiness when dragging slider end at high
 input refresh rates

---
 .../Components/Timeline/TimelineHitObjectBlueprint.cs      | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineHitObjectBlueprint.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineHitObjectBlueprint.cs
index a1b2878719..e44a30ad02 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineHitObjectBlueprint.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineHitObjectBlueprint.cs
@@ -389,7 +389,12 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
                                 if (hitObject.DifficultyControlPoint == DifficultyControlPoint.DEFAULT)
                                     hitObject.DifficultyControlPoint = new DifficultyControlPoint();
 
-                                hitObject.DifficultyControlPoint.SliderVelocity *= (repeatHitObject.Duration / proposedDuration);
+                                var newVelocity = hitObject.DifficultyControlPoint.SliderVelocity * (repeatHitObject.Duration / proposedDuration);
+
+                                if (Precision.AlmostEquals(newVelocity, hitObject.DifficultyControlPoint.SliderVelocity))
+                                    return;
+
+                                hitObject.DifficultyControlPoint.SliderVelocity = newVelocity;
                                 beatmap.Update(hitObject);
                             }
                             else

From c47497923ab6e98d4b9bd27cd30d5a52de430086 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 15 Oct 2021 19:52:29 +0900
Subject: [PATCH 0273/5547] Schedule drag events for now

---
 .../Timeline/TimelineHitObjectBlueprint.cs    | 87 ++++++++++---------
 1 file changed, 48 insertions(+), 39 deletions(-)

diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineHitObjectBlueprint.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineHitObjectBlueprint.cs
index e44a30ad02..e2458d45c9 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineHitObjectBlueprint.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineHitObjectBlueprint.cs
@@ -13,6 +13,7 @@ using osu.Framework.Graphics.Effects;
 using osu.Framework.Graphics.Primitives;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Input.Events;
+using osu.Framework.Threading;
 using osu.Framework.Utils;
 using osu.Game.Beatmaps.ControlPoints;
 using osu.Game.Graphics;
@@ -371,58 +372,66 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
                 return true;
             }
 
+            private ScheduledDelegate dragOperation;
+
             protected override void OnDrag(DragEvent e)
             {
                 base.OnDrag(e);
 
-                OnDragHandled?.Invoke(e);
-
-                if (timeline.SnapScreenSpacePositionToValidTime(e.ScreenSpaceMousePosition).Time is double time)
+                // schedule is temporary to ensure we don't process multiple times on a single update frame. we need to find a better method of doing this.
+                // without it, a hitobject's endtime may not always be in a valid state (ie. sliders, which needs to recompute their path).
+                dragOperation?.Cancel();
+                dragOperation = Scheduler.Add(() =>
                 {
-                    switch (hitObject)
+                    OnDragHandled?.Invoke(e);
+
+                    if (timeline.SnapScreenSpacePositionToValidTime(e.ScreenSpaceMousePosition).Time is double time)
                     {
-                        case IHasRepeats repeatHitObject:
-                            double proposedDuration = time - hitObject.StartTime;
+                        switch (hitObject)
+                        {
+                            case IHasRepeats repeatHitObject:
+                                double proposedDuration = time - hitObject.StartTime;
 
-                            if (e.CurrentState.Keyboard.ShiftPressed)
-                            {
-                                if (hitObject.DifficultyControlPoint == DifficultyControlPoint.DEFAULT)
-                                    hitObject.DifficultyControlPoint = new DifficultyControlPoint();
+                                if (e.CurrentState.Keyboard.ShiftPressed)
+                                {
+                                    if (hitObject.DifficultyControlPoint == DifficultyControlPoint.DEFAULT)
+                                        hitObject.DifficultyControlPoint = new DifficultyControlPoint();
 
-                                var newVelocity = hitObject.DifficultyControlPoint.SliderVelocity * (repeatHitObject.Duration / proposedDuration);
+                                    var newVelocity = hitObject.DifficultyControlPoint.SliderVelocity * (repeatHitObject.Duration / proposedDuration);
 
-                                if (Precision.AlmostEquals(newVelocity, hitObject.DifficultyControlPoint.SliderVelocity))
+                                    if (Precision.AlmostEquals(newVelocity, hitObject.DifficultyControlPoint.SliderVelocity))
+                                        return;
+
+                                    hitObject.DifficultyControlPoint.SliderVelocity = newVelocity;
+                                    beatmap.Update(hitObject);
+                                }
+                                else
+                                {
+                                    // find the number of repeats which can fit in the requested time.
+                                    var lengthOfOneRepeat = repeatHitObject.Duration / (repeatHitObject.RepeatCount + 1);
+                                    var proposedCount = Math.Max(0, (int)Math.Round(proposedDuration / lengthOfOneRepeat) - 1);
+
+                                    if (proposedCount == repeatHitObject.RepeatCount)
+                                        return;
+
+                                    repeatHitObject.RepeatCount = proposedCount;
+                                    beatmap.Update(hitObject);
+                                }
+
+                                break;
+
+                            case IHasDuration endTimeHitObject:
+                                var snappedTime = Math.Max(hitObject.StartTime, beatSnapProvider.SnapTime(time));
+
+                                if (endTimeHitObject.EndTime == snappedTime || Precision.AlmostEquals(snappedTime, hitObject.StartTime, beatmap.GetBeatLengthAtTime(snappedTime)))
                                     return;
 
-                                hitObject.DifficultyControlPoint.SliderVelocity = newVelocity;
+                                endTimeHitObject.Duration = snappedTime - hitObject.StartTime;
                                 beatmap.Update(hitObject);
-                            }
-                            else
-                            {
-                                // find the number of repeats which can fit in the requested time.
-                                var lengthOfOneRepeat = repeatHitObject.Duration / (repeatHitObject.RepeatCount + 1);
-                                var proposedCount = Math.Max(0, (int)Math.Round(proposedDuration / lengthOfOneRepeat) - 1);
-
-                                if (proposedCount == repeatHitObject.RepeatCount)
-                                    return;
-
-                                repeatHitObject.RepeatCount = proposedCount;
-                                beatmap.Update(hitObject);
-                            }
-
-                            break;
-
-                        case IHasDuration endTimeHitObject:
-                            var snappedTime = Math.Max(hitObject.StartTime, beatSnapProvider.SnapTime(time));
-
-                            if (endTimeHitObject.EndTime == snappedTime || Precision.AlmostEquals(snappedTime, hitObject.StartTime, beatmap.GetBeatLengthAtTime(snappedTime)))
-                                return;
-
-                            endTimeHitObject.Duration = snappedTime - hitObject.StartTime;
-                            beatmap.Update(hitObject);
-                            break;
+                                break;
+                        }
                     }
-                }
+                });
             }
 
             protected override void OnDragEnd(DragEndEvent e)

From 6f89e30f5677586057953520ca184d82a8f1552f Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Thu, 14 Oct 2021 23:24:01 +0900
Subject: [PATCH 0274/5547] Add QueueingMode to MultiplayerRoomSettings

---
 osu.Game/Online/Multiplayer/MultiplayerRoomSettings.cs | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Online/Multiplayer/MultiplayerRoomSettings.cs b/osu.Game/Online/Multiplayer/MultiplayerRoomSettings.cs
index 001cf2aa93..596f50d54b 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerRoomSettings.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerRoomSettings.cs
@@ -43,6 +43,9 @@ namespace osu.Game.Online.Multiplayer
         [Key(8)]
         public MatchType MatchType { get; set; } = MatchType.HeadToHead;
 
+        [Key(9)]
+        public QueueingModes QueueingMode { get; set; } = QueueingModes.Host;
+
         public bool Equals(MultiplayerRoomSettings other)
             => BeatmapID == other.BeatmapID
                && BeatmapChecksum == other.BeatmapChecksum
@@ -52,7 +55,8 @@ namespace osu.Game.Online.Multiplayer
                && Password.Equals(other.Password, StringComparison.Ordinal)
                && Name.Equals(other.Name, StringComparison.Ordinal)
                && PlaylistItemId == other.PlaylistItemId
-               && MatchType == other.MatchType;
+               && MatchType == other.MatchType
+               && QueueingMode == other.QueueingMode;
 
         public override string ToString() => $"Name:{Name}"
                                              + $" Beatmap:{BeatmapID} ({BeatmapChecksum})"
@@ -61,6 +65,7 @@ namespace osu.Game.Online.Multiplayer
                                              + $" Password:{(string.IsNullOrEmpty(Password) ? "no" : "yes")}"
                                              + $" Ruleset:{RulesetID}"
                                              + $" Type:{MatchType}"
-                                             + $" Item:{PlaylistItemId}";
+                                             + $" Item:{PlaylistItemId}"
+                                             + $" Queue:{QueueingMode}";
     }
 }

From 6cc81840418c0f463194c0474c555e2a0d09e3cb Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Fri, 15 Oct 2021 20:17:43 +0900
Subject: [PATCH 0275/5547] Make test scene create room immediately

---
 .../TestSceneMultiplayerMatchSubScreen.cs           | 13 +++++++------
 1 file changed, 7 insertions(+), 6 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs
index 21364fe154..9cf9cb7e06 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs
@@ -62,19 +62,20 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [Test]
         public void TestCreatedRoom()
         {
-            AddStep("set playlist", () =>
+            AddStep("create room", () =>
             {
                 SelectedRoom.Value.Playlist.Add(new PlaylistItem
                 {
                     Beatmap = { Value = new TestBeatmap(new OsuRuleset().RulesetInfo).BeatmapInfo },
                     Ruleset = { Value = new OsuRuleset().RulesetInfo },
                 });
-            });
 
-            AddStep("click create button", () =>
-            {
-                InputManager.MoveMouseTo(this.ChildrenOfType<MultiplayerMatchSettingsOverlay.CreateOrUpdateButton>().Single());
-                InputManager.Click(MouseButton.Left);
+                // Needs to run after components update with the playlist item.
+                Schedule(() =>
+                {
+                    InputManager.MoveMouseTo(this.ChildrenOfType<MultiplayerMatchSettingsOverlay.CreateOrUpdateButton>().Single());
+                    InputManager.Click(MouseButton.Left);
+                });
             });
 
             AddUntilStep("wait for join", () => Client.Room != null);

From a70d7e4febeb0fb1fbab3e25544d580871d60bb4 Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Fri, 15 Oct 2021 20:18:25 +0900
Subject: [PATCH 0276/5547] Remove unnecessary extra GridContainer

---
 .../Multiplayer/MultiplayerMatchSubScreen.cs  | 174 +++++++++---------
 1 file changed, 82 insertions(+), 92 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
index 544eac4127..6302a6532e 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
@@ -80,116 +80,106 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
             }, true);
         }
 
-        protected override Drawable CreateMainContent() => new GridContainer
+        protected override Drawable CreateMainContent() => new Container
         {
             RelativeSizeAxes = Axes.Both,
-            Content = new[]
+            Padding = new MarginPadding { Horizontal = 5, Vertical = 10 },
+            Child = new GridContainer
             {
-                new Drawable[]
+                RelativeSizeAxes = Axes.Both,
+                ColumnDimensions = new[]
                 {
-                    new Container
+                    new Dimension(GridSizeMode.Relative, size: 0.5f, maxSize: 400),
+                    new Dimension(),
+                    new Dimension(GridSizeMode.Relative, size: 0.5f, maxSize: 600),
+                },
+                Content = new[]
+                {
+                    new Drawable[]
                     {
-                        RelativeSizeAxes = Axes.Both,
-                        Padding = new MarginPadding { Horizontal = 5, Vertical = 10 },
-                        Child = new GridContainer
+                        // Main left column
+                        new GridContainer
                         {
                             RelativeSizeAxes = Axes.Both,
-                            ColumnDimensions = new[]
+                            RowDimensions = new[]
                             {
-                                new Dimension(GridSizeMode.Relative, size: 0.5f, maxSize: 400),
-                                new Dimension(),
-                                new Dimension(GridSizeMode.Relative, size: 0.5f, maxSize: 600),
+                                new Dimension(GridSizeMode.AutoSize)
                             },
                             Content = new[]
                             {
+                                new Drawable[] { new ParticipantsListHeader() },
                                 new Drawable[]
                                 {
-                                    // Main left column
-                                    new GridContainer
+                                    new ParticipantsList
                                     {
-                                        RelativeSizeAxes = Axes.Both,
-                                        RowDimensions = new[]
-                                        {
-                                            new Dimension(GridSizeMode.AutoSize)
-                                        },
-                                        Content = new[]
-                                        {
-                                            new Drawable[] { new ParticipantsListHeader() },
-                                            new Drawable[]
-                                            {
-                                                new ParticipantsList
-                                                {
-                                                    RelativeSizeAxes = Axes.Both
-                                                },
-                                            }
-                                        }
-                                    },
-                                    // Spacer
-                                    null,
-                                    // Main right column
-                                    new GridContainer
-                                    {
-                                        RelativeSizeAxes = Axes.Both,
-                                        Content = new[]
-                                        {
-                                            new Drawable[] { new OverlinedHeader("Beatmap") },
-                                            new Drawable[] { new BeatmapSelectionControl { RelativeSizeAxes = Axes.X } },
-                                            new[]
-                                            {
-                                                UserModsSection = new FillFlowContainer
-                                                {
-                                                    RelativeSizeAxes = Axes.X,
-                                                    AutoSizeAxes = Axes.Y,
-                                                    Margin = new MarginPadding { Top = 10 },
-                                                    Alpha = 0,
-                                                    Children = new Drawable[]
-                                                    {
-                                                        new OverlinedHeader("Extra mods"),
-                                                        new FillFlowContainer
-                                                        {
-                                                            AutoSizeAxes = Axes.Both,
-                                                            Direction = FillDirection.Horizontal,
-                                                            Spacing = new Vector2(10, 0),
-                                                            Children = new Drawable[]
-                                                            {
-                                                                new UserModSelectButton
-                                                                {
-                                                                    Anchor = Anchor.CentreLeft,
-                                                                    Origin = Anchor.CentreLeft,
-                                                                    Width = 90,
-                                                                    Text = "Select",
-                                                                    Action = ShowUserModSelect,
-                                                                },
-                                                                new ModDisplay
-                                                                {
-                                                                    Anchor = Anchor.CentreLeft,
-                                                                    Origin = Anchor.CentreLeft,
-                                                                    Current = UserMods,
-                                                                    Scale = new Vector2(0.8f),
-                                                                },
-                                                            }
-                                                        },
-                                                    }
-                                                },
-                                            },
-                                            new Drawable[] { new OverlinedHeader("Chat") { Margin = new MarginPadding { Vertical = 5 }, }, },
-                                            new Drawable[] { new MatchChatDisplay(Room) { RelativeSizeAxes = Axes.Both } }
-                                        },
-                                        RowDimensions = new[]
-                                        {
-                                            new Dimension(GridSizeMode.AutoSize),
-                                            new Dimension(GridSizeMode.AutoSize),
-                                            new Dimension(GridSizeMode.AutoSize),
-                                            new Dimension(GridSizeMode.AutoSize),
-                                            new Dimension(),
-                                        }
+                                        RelativeSizeAxes = Axes.Both
                                     },
                                 }
                             }
-                        }
+                        },
+                        // Spacer
+                        null,
+                        // Main right column
+                        new GridContainer
+                        {
+                            RelativeSizeAxes = Axes.Both,
+                            Content = new[]
+                            {
+                                new Drawable[] { new OverlinedHeader("Beatmap") },
+                                new Drawable[] { new BeatmapSelectionControl { RelativeSizeAxes = Axes.X } },
+                                new[]
+                                {
+                                    UserModsSection = new FillFlowContainer
+                                    {
+                                        RelativeSizeAxes = Axes.X,
+                                        AutoSizeAxes = Axes.Y,
+                                        Margin = new MarginPadding { Top = 10 },
+                                        Alpha = 0,
+                                        Children = new Drawable[]
+                                        {
+                                            new OverlinedHeader("Extra mods"),
+                                            new FillFlowContainer
+                                            {
+                                                AutoSizeAxes = Axes.Both,
+                                                Direction = FillDirection.Horizontal,
+                                                Spacing = new Vector2(10, 0),
+                                                Children = new Drawable[]
+                                                {
+                                                    new UserModSelectButton
+                                                    {
+                                                        Anchor = Anchor.CentreLeft,
+                                                        Origin = Anchor.CentreLeft,
+                                                        Width = 90,
+                                                        Text = "Select",
+                                                        Action = ShowUserModSelect,
+                                                    },
+                                                    new ModDisplay
+                                                    {
+                                                        Anchor = Anchor.CentreLeft,
+                                                        Origin = Anchor.CentreLeft,
+                                                        Current = UserMods,
+                                                        Scale = new Vector2(0.8f),
+                                                    },
+                                                }
+                                            },
+                                        }
+                                    },
+                                },
+                                new Drawable[] { new OverlinedHeader("Chat") { Margin = new MarginPadding { Vertical = 5 }, }, },
+                                new Drawable[] { new MatchChatDisplay(Room) { RelativeSizeAxes = Axes.Both } }
+                            },
+                            RowDimensions = new[]
+                            {
+                                new Dimension(GridSizeMode.AutoSize),
+                                new Dimension(GridSizeMode.AutoSize),
+                                new Dimension(GridSizeMode.AutoSize),
+                                new Dimension(GridSizeMode.AutoSize),
+                                new Dimension(),
+                            }
+                        },
                     }
-                },
-            },
+                }
+            }
         };
 
         protected override Drawable CreateFooter() => new MultiplayerMatchFooter

From 2fd101ad50eee95a5331caf0be6fdcbe1057efd4 Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Fri, 15 Oct 2021 20:25:32 +0900
Subject: [PATCH 0277/5547] Reorder elements to follow designs

---
 .../Multiplayer/MultiplayerMatchSubScreen.cs  | 27 ++++++++++++++-----
 1 file changed, 21 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
index 6302a6532e..33df9fe2fa 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
@@ -89,15 +89,17 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
                 RelativeSizeAxes = Axes.Both,
                 ColumnDimensions = new[]
                 {
-                    new Dimension(GridSizeMode.Relative, size: 0.5f, maxSize: 400),
                     new Dimension(),
-                    new Dimension(GridSizeMode.Relative, size: 0.5f, maxSize: 600),
+                    new Dimension(GridSizeMode.Absolute, 10),
+                    new Dimension(),
+                    new Dimension(GridSizeMode.Absolute, 10),
+                    new Dimension(),
                 },
                 Content = new[]
                 {
                     new Drawable[]
                     {
-                        // Main left column
+                        // Participants column
                         new GridContainer
                         {
                             RelativeSizeAxes = Axes.Both,
@@ -119,7 +121,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
                         },
                         // Spacer
                         null,
-                        // Main right column
+                        // Beatmap column
                         new GridContainer
                         {
                             RelativeSizeAxes = Axes.Both,
@@ -165,14 +167,27 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
                                         }
                                     },
                                 },
-                                new Drawable[] { new OverlinedHeader("Chat") { Margin = new MarginPadding { Vertical = 5 }, }, },
-                                new Drawable[] { new MatchChatDisplay(Room) { RelativeSizeAxes = Axes.Both } }
                             },
                             RowDimensions = new[]
                             {
                                 new Dimension(GridSizeMode.AutoSize),
                                 new Dimension(GridSizeMode.AutoSize),
                                 new Dimension(GridSizeMode.AutoSize),
+                            }
+                        },
+                        // Spacer
+                        null,
+                        // Main right column
+                        new GridContainer
+                        {
+                            RelativeSizeAxes = Axes.Both,
+                            Content = new[]
+                            {
+                                new Drawable[] { new OverlinedHeader("Chat") },
+                                new Drawable[] { new MatchChatDisplay(Room) { RelativeSizeAxes = Axes.Both } }
+                            },
+                            RowDimensions = new[]
+                            {
                                 new Dimension(GridSizeMode.AutoSize),
                                 new Dimension(),
                             }

From 6f947cacbd61b57a4e63db452bd06dbb52563dee Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 15 Oct 2021 21:22:38 +0900
Subject: [PATCH 0278/5547] Fix test failures

---
 osu.Game/Screens/Play/FailAnimation.cs | 22 +++++++++++++++++++---
 osu.Game/Screens/Play/Player.cs        |  2 +-
 2 files changed, 20 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Screens/Play/FailAnimation.cs b/osu.Game/Screens/Play/FailAnimation.cs
index 1e2e020824..30524ba32f 100644
--- a/osu.Game/Screens/Play/FailAnimation.cs
+++ b/osu.Game/Screens/Play/FailAnimation.cs
@@ -33,6 +33,8 @@ namespace osu.Game.Screens.Play
         private readonly DrawableRuleset drawableRuleset;
         private readonly BindableDouble trackFreq = new BindableDouble(1);
 
+        private Container filters;
+
         private Box failFlash;
 
         private Track track;
@@ -66,8 +68,14 @@ namespace osu.Game.Screens.Play
 
             AddRangeInternal(new Drawable[]
             {
-                failLowPassFilter = new AudioFilter(audio.TrackMixer),
-                failHighPassFilter = new AudioFilter(audio.TrackMixer, BQFType.HighPass),
+                filters = new Container
+                {
+                    Children = new Drawable[]
+                    {
+                        failLowPassFilter = new AudioFilter(audio.TrackMixer),
+                        failHighPassFilter = new AudioFilter(audio.TrackMixer, BQFType.HighPass),
+                    },
+                },
                 Content,
                 failFlash = new Box
                 {
@@ -122,6 +130,14 @@ namespace osu.Game.Screens.Play
             Content.FadeColour(Color4.Gray, duration);
         }
 
+        public void RemoveFilters()
+        {
+            RemoveInternal(filters);
+            filters.Dispose();
+
+            track?.RemoveAdjustment(AdjustableProperty.Frequency, trackFreq);
+        }
+
         protected override void Update()
         {
             base.Update();
@@ -172,7 +188,7 @@ namespace osu.Game.Screens.Play
         protected override void Dispose(bool isDisposing)
         {
             base.Dispose(isDisposing);
-            track?.RemoveAdjustment(AdjustableProperty.Frequency, trackFreq);
+            RemoveFilters();
         }
     }
 }
diff --git a/osu.Game/Screens/Play/Player.cs b/osu.Game/Screens/Play/Player.cs
index b4bd658a83..93815b7064 100644
--- a/osu.Game/Screens/Play/Player.cs
+++ b/osu.Game/Screens/Play/Player.cs
@@ -965,7 +965,7 @@ namespace osu.Game.Screens.Play
         public override bool OnExiting(IScreen next)
         {
             screenSuspension?.RemoveAndDisposeImmediately();
-            failAnimationLayer?.RemoveAndDisposeImmediately();
+            failAnimationLayer?.RemoveFilters();
 
             // if arriving here and the results screen preparation task hasn't run, it's safe to say the user has not completed the beatmap.
             if (prepareScoreForDisplayTask == null)

From 91754450b2b2edaf995e0ecfdbe49f9fdeaaea8c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 15 Oct 2021 21:27:44 +0900
Subject: [PATCH 0279/5547] Remove dispose method completely

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

diff --git a/osu.Game/Screens/Play/FailAnimation.cs b/osu.Game/Screens/Play/FailAnimation.cs
index 30524ba32f..2a1c4599d5 100644
--- a/osu.Game/Screens/Play/FailAnimation.cs
+++ b/osu.Game/Screens/Play/FailAnimation.cs
@@ -184,11 +184,5 @@ namespace osu.Game.Screens.Play
                 obj.MoveTo(originalPosition + new Vector2(0, 400), duration);
             }
         }
-
-        protected override void Dispose(bool isDisposing)
-        {
-            base.Dispose(isDisposing);
-            RemoveFilters();
-        }
     }
 }

From c8d99e68a59a9f08f5daa423ba004bb072897b98 Mon Sep 17 00:00:00 2001
From: StanR <hi@stanr.info>
Date: Fri, 15 Oct 2021 16:51:05 +0300
Subject: [PATCH 0280/5547] Remove calculation for scores with combo above
 threshold, avoid division by zero

---
 osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
index d0b5e877b5..3895389f61 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
@@ -262,9 +262,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty
             {
                 double fullComboThreshold = Attributes.MaxCombo - 0.1 * Attributes.SliderCount;
                 if (scoreMaxCombo < fullComboThreshold)
-                    comboBasedMissCount = fullComboThreshold / scoreMaxCombo;
-                else
-                    comboBasedMissCount = Math.Pow((Attributes.MaxCombo - scoreMaxCombo) / (0.1 * Attributes.SliderCount), 3);
+                    comboBasedMissCount = fullComboThreshold / Math.Max(1.0, scoreMaxCombo);
             }
 
             return Math.Max(countMiss, (int)Math.Floor(comboBasedMissCount));

From 7a5a61289692eedca02cb9c7229c38dac6446425 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 16 Oct 2021 02:29:45 +0900
Subject: [PATCH 0281/5547] Move retry and exit hotkey overlays to same depth /
 container

---
 osu.Game/Screens/Play/Player.cs | 55 ++++++++++++++++-----------------
 1 file changed, 26 insertions(+), 29 deletions(-)

diff --git a/osu.Game/Screens/Play/Player.cs b/osu.Game/Screens/Play/Player.cs
index 93815b7064..5398a955b3 100644
--- a/osu.Game/Screens/Play/Player.cs
+++ b/osu.Game/Screens/Play/Player.cs
@@ -246,16 +246,37 @@ namespace osu.Game.Screens.Play
                 {
                     OnRetry = Restart,
                     OnQuit = () => PerformExit(true),
-                }
+                },
+                new HotkeyExitOverlay
+                {
+                    Action = () =>
+                    {
+                        if (!this.IsCurrentScreen()) return;
+
+                        fadeOut(true);
+                        PerformExit(false);
+                    },
+                },
             });
 
+            if (Configuration.AllowRestart)
+            {
+                rulesetSkinProvider.Add(new HotkeyRetryOverlay
+                {
+                    Action = () =>
+                    {
+                        if (!this.IsCurrentScreen()) return;
+
+                        fadeOut(true);
+                        Restart();
+                    },
+                });
+            }
+
             // add the overlay components as a separate step as they proxy some elements from the above underlay/gameplay components.
             // also give the overlays the ruleset skin provider to allow rulesets to potentially override HUD elements (used to disable combo counters etc.)
             // we may want to limit this in the future to disallow rulesets from outright replacing elements the user expects to be there.
-            failAnimationLayer.AddRange(new[]
-            {
-                createOverlayComponents(Beatmap.Value),
-            });
+            failAnimationLayer.Add(createOverlayComponents(Beatmap.Value));
 
             if (!DrawableRuleset.AllowGameplayOverlays)
             {
@@ -356,16 +377,6 @@ namespace osu.Game.Screens.Play
                 RelativeSizeAxes = Axes.Both,
                 Children = new[]
                 {
-                    new HotkeyExitOverlay
-                    {
-                        Action = () =>
-                        {
-                            if (!this.IsCurrentScreen()) return;
-
-                            fadeOut(true);
-                            PerformExit(false);
-                        },
-                    },
                     DimmableStoryboard.OverlayLayerContainer.CreateProxy(),
                     BreakOverlay = new BreakOverlay(working.Beatmap.BeatmapInfo.LetterboxInBreaks, ScoreProcessor)
                     {
@@ -419,20 +430,6 @@ namespace osu.Game.Screens.Play
             if (GameplayClockContainer is MasterGameplayClockContainer master)
                 HUDOverlay.PlayerSettingsOverlay.PlaybackSettings.UserPlaybackRate.BindTarget = master.UserPlaybackRate;
 
-            if (Configuration.AllowRestart)
-            {
-                container.Add(new HotkeyRetryOverlay
-                {
-                    Action = () =>
-                    {
-                        if (!this.IsCurrentScreen()) return;
-
-                        fadeOut(true);
-                        Restart();
-                    },
-                });
-            }
-
             return container;
         }
 

From 29ec498f6c69f779ee55d78c08299109ead9283c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 16 Oct 2021 13:34:24 +0200
Subject: [PATCH 0282/5547] Add failing test case for player sending wrong
 ruleset ID to spectator server

---
 .../Visual/Gameplay/TestSceneSpectatorHost.cs | 51 +++++++++++++++++++
 1 file changed, 51 insertions(+)
 create mode 100644 osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorHost.cs

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorHost.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorHost.cs
new file mode 100644
index 0000000000..89fea1f92d
--- /dev/null
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorHost.cs
@@ -0,0 +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 NUnit.Framework;
+using osu.Framework.Allocation;
+using osu.Game.Online.API;
+using osu.Game.Online.Spectator;
+using osu.Game.Rulesets;
+using osu.Game.Rulesets.Mania;
+using osu.Game.Tests.Visual.Spectator;
+using osu.Game.Users;
+
+namespace osu.Game.Tests.Visual.Gameplay
+{
+    public class TestSceneSpectatorHost : PlayerTestScene
+    {
+        protected override Ruleset CreatePlayerRuleset() => new ManiaRuleset();
+
+        [Cached(typeof(SpectatorClient))]
+        private TestSpectatorClient spectatorClient { get; } = new TestSpectatorClient();
+
+        private DummyAPIAccess dummyAPIAccess => (DummyAPIAccess)API;
+        private const int dummy_user_id = 42;
+
+        public override void SetUpSteps()
+        {
+            AddStep("set dummy user", () => dummyAPIAccess.LocalUser.Value = new User
+            {
+                Id = dummy_user_id,
+                Username = "DummyUser"
+            });
+            AddStep("add test spectator client", () => Add(spectatorClient));
+            AddStep("add watching user", () => spectatorClient.WatchUser(dummy_user_id));
+            base.SetUpSteps();
+        }
+
+        [Test]
+        public void TestClientSendsCorrectRuleset()
+        {
+            AddUntilStep("spectator client sending frames", () => spectatorClient.PlayingUserStates.ContainsKey(dummy_user_id));
+            AddAssert("spectator client sent correct ruleset", () => spectatorClient.PlayingUserStates[dummy_user_id].RulesetID == Ruleset.Value.ID);
+        }
+
+        public override void TearDownSteps()
+        {
+            base.TearDownSteps();
+            AddStep("stop watching user", () => spectatorClient.StopWatchingUser(dummy_user_id));
+            AddStep("remove test spectator client", () => Remove(spectatorClient));
+        }
+    }
+}

From e57d6e930eb3246da0279278e9bbf085103c191d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 16 Oct 2021 13:48:49 +0200
Subject: [PATCH 0283/5547] Source spectator state sent to server from gameplay
 state

---
 osu.Game/Online/Spectator/SpectatorClient.cs | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Online/Spectator/SpectatorClient.cs b/osu.Game/Online/Spectator/SpectatorClient.cs
index b597b2f214..94bb11a7bc 100644
--- a/osu.Game/Online/Spectator/SpectatorClient.cs
+++ b/osu.Game/Online/Spectator/SpectatorClient.cs
@@ -144,9 +144,9 @@ namespace osu.Game.Online.Spectator
             IsPlaying = true;
 
             // transfer state at point of beginning play
-            currentState.BeatmapID = score.ScoreInfo.BeatmapInfo.OnlineBeatmapID;
-            currentState.RulesetID = score.ScoreInfo.RulesetID;
-            currentState.Mods = score.ScoreInfo.Mods.Select(m => new APIMod(m)).ToArray();
+            currentState.BeatmapID = state.Beatmap.BeatmapInfo.OnlineBeatmapID;
+            currentState.RulesetID = state.Ruleset.RulesetInfo.ID;
+            currentState.Mods = state.Mods.Select(m => new APIMod(m)).ToArray();
 
             currentBeatmap = state.Beatmap;
             currentScore = score;

From ccaac977947174af7d8de690f90f5977b230242d Mon Sep 17 00:00:00 2001
From: StanR <hi@stanr.info>
Date: Sat, 16 Oct 2021 14:50:15 +0300
Subject: [PATCH 0284/5547] Clamp comboBasedMissCount

---
 osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
index 3895389f61..4bca87204a 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
@@ -265,6 +265,9 @@ namespace osu.Game.Rulesets.Osu.Difficulty
                     comboBasedMissCount = fullComboThreshold / Math.Max(1.0, scoreMaxCombo);
             }
 
+            // we're clamping misscount because since its derived from combo it can be higher than total hits and that breaks some calculations
+            comboBasedMissCount = Math.Min(comboBasedMissCount, totalHits);
+
             return Math.Max(countMiss, (int)Math.Floor(comboBasedMissCount));
         }
 

From b34086a792c9865f990cb289655efeb2930710fa Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 16 Oct 2021 16:03:13 +0200
Subject: [PATCH 0285/5547] Add failing test case for incorrect `RulesetID`
 population in submission flow

---
 .../TestScenePlayerScoreSubmission.cs         | 74 ++++++++++++++++++-
 1 file changed, 73 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestScenePlayerScoreSubmission.cs b/osu.Game.Tests/Visual/Gameplay/TestScenePlayerScoreSubmission.cs
index 5ff2e9c439..d7edb33c42 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestScenePlayerScoreSubmission.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestScenePlayerScoreSubmission.cs
@@ -3,6 +3,7 @@
 
 using System;
 using System.Linq;
+using System.Threading.Tasks;
 using NUnit.Framework;
 using osu.Framework.Screens;
 using osu.Game.Beatmaps;
@@ -10,10 +11,13 @@ using osu.Game.Online.API;
 using osu.Game.Online.Rooms;
 using osu.Game.Online.Solo;
 using osu.Game.Rulesets;
+using osu.Game.Rulesets.Mania;
 using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Osu.Judgements;
 using osu.Game.Rulesets.Scoring;
+using osu.Game.Rulesets.Taiko;
+using osu.Game.Scoring;
 using osu.Game.Screens.Ranking;
 using osu.Game.Tests.Beatmaps;
 
@@ -32,7 +36,7 @@ namespace osu.Game.Tests.Visual.Gameplay
 
         protected override bool HasCustomSteps => true;
 
-        protected override TestPlayer CreatePlayer(Ruleset ruleset) => new TestPlayer(false);
+        protected override TestPlayer CreatePlayer(Ruleset ruleset) => new NonImportingPlayer(false);
 
         protected override Ruleset CreatePlayerRuleset() => createCustomRuleset?.Invoke() ?? new OsuRuleset();
 
@@ -86,6 +90,46 @@ namespace osu.Game.Tests.Visual.Gameplay
             AddAssert("ensure passing submission", () => Player.SubmittedScore?.ScoreInfo.Passed == true);
         }
 
+        [Test]
+        public void TestSubmissionForDifferentRuleset()
+        {
+            prepareTokenResponse(true);
+
+            createPlayerTest(createRuleset: () => new TaikoRuleset());
+
+            AddUntilStep("wait for token request", () => Player.TokenCreationRequested);
+
+            AddUntilStep("wait for track to start running", () => Beatmap.Value.Track.IsRunning);
+
+            addFakeHit();
+
+            AddStep("seek to completion", () => Player.GameplayClockContainer.Seek(Player.DrawableRuleset.Objects.Last().GetEndTime()));
+
+            AddUntilStep("results displayed", () => Player.GetChildScreen() is ResultsScreen);
+            AddAssert("ensure passing submission", () => Player.SubmittedScore?.ScoreInfo.Passed == true);
+            AddAssert("submitted score has correct ruleset ID", () => Player.SubmittedScore?.ScoreInfo.RulesetID == new TaikoRuleset().RulesetInfo.ID);
+        }
+
+        [Test]
+        public void TestSubmissionForConvertedBeatmap()
+        {
+            prepareTokenResponse(true);
+
+            createPlayerTest(createRuleset: () => new ManiaRuleset(), createBeatmap: _ => createTestBeatmap(new OsuRuleset().RulesetInfo));
+
+            AddUntilStep("wait for token request", () => Player.TokenCreationRequested);
+
+            AddUntilStep("wait for track to start running", () => Beatmap.Value.Track.IsRunning);
+
+            addFakeHit();
+
+            AddStep("seek to completion", () => Player.GameplayClockContainer.Seek(Player.DrawableRuleset.Objects.Last().GetEndTime()));
+
+            AddUntilStep("results displayed", () => Player.GetChildScreen() is ResultsScreen);
+            AddAssert("ensure passing submission", () => Player.SubmittedScore?.ScoreInfo.Passed == true);
+            AddAssert("submitted score has correct ruleset ID", () => Player.SubmittedScore?.ScoreInfo.RulesetID == new ManiaRuleset().RulesetInfo.ID);
+        }
+
         [Test]
         public void TestNoSubmissionOnExitWithNoToken()
         {
@@ -242,5 +286,33 @@ namespace osu.Game.Tests.Visual.Gameplay
                 });
             });
         }
+
+        private class NonImportingPlayer : TestPlayer
+        {
+            public NonImportingPlayer(bool allowPause = true, bool showResults = true, bool pauseOnFocusLost = false)
+                : base(allowPause, showResults, pauseOnFocusLost)
+            {
+            }
+
+            protected override Task ImportScore(Score score)
+            {
+                // It was discovered that Score members could sometimes be half-populated.
+                // In particular, the RulesetID property could be set to 0 even on non-osu! maps.
+                // We want to test that the state of that property is consistent in this test.
+                // EF makes this impossible.
+                //
+                // First off, because of the EF navigational property-explicit foreign key field duality,
+                // it can happen that - for example - the Ruleset navigational property is correctly initialised to mania,
+                // but the RulesetID foreign key property is not initialised and remains 0.
+                // EF silently bypasses this by prioritising the Ruleset navigational property over the RulesetID foreign key one.
+                //
+                // Additionally, adding an entity to an EF DbSet CAUSES SIDE EFFECTS with regard to the foreign key property.
+                // In the above instance, if a ScoreInfo with Ruleset = {mania} and RulesetID = 0 is attached to an EF context,
+                // RulesetID WILL BE SILENTLY SET TO THE CORRECT VALUE of 3.
+                //
+                // For the above reasons, importing is disabled in this test.
+                return Task.CompletedTask;
+            }
+        }
     }
 }

From 874decb3cdbd6bde57b0616addcc67e44542b734 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 16 Oct 2021 16:06:20 +0200
Subject: [PATCH 0286/5547] Replace spectator-local fix for wrong ruleset ID
 with player-global consistency check

---
 osu.Game/Online/Spectator/SpectatorClient.cs | 6 +++---
 osu.Game/Screens/Play/Player.cs              | 4 ++++
 2 files changed, 7 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Online/Spectator/SpectatorClient.cs b/osu.Game/Online/Spectator/SpectatorClient.cs
index 94bb11a7bc..b597b2f214 100644
--- a/osu.Game/Online/Spectator/SpectatorClient.cs
+++ b/osu.Game/Online/Spectator/SpectatorClient.cs
@@ -144,9 +144,9 @@ namespace osu.Game.Online.Spectator
             IsPlaying = true;
 
             // transfer state at point of beginning play
-            currentState.BeatmapID = state.Beatmap.BeatmapInfo.OnlineBeatmapID;
-            currentState.RulesetID = state.Ruleset.RulesetInfo.ID;
-            currentState.Mods = state.Mods.Select(m => new APIMod(m)).ToArray();
+            currentState.BeatmapID = score.ScoreInfo.BeatmapInfo.OnlineBeatmapID;
+            currentState.RulesetID = score.ScoreInfo.RulesetID;
+            currentState.Mods = score.ScoreInfo.Mods.Select(m => new APIMod(m)).ToArray();
 
             currentBeatmap = state.Beatmap;
             currentScore = score;
diff --git a/osu.Game/Screens/Play/Player.cs b/osu.Game/Screens/Play/Player.cs
index 5398a955b3..c8b946b7f1 100644
--- a/osu.Game/Screens/Play/Player.cs
+++ b/osu.Game/Screens/Play/Player.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.Linq;
 using System.Threading.Tasks;
@@ -217,9 +218,12 @@ namespace osu.Game.Screens.Play
 
             Score = CreateScore(playableBeatmap);
 
+            Debug.Assert(ruleset.RulesetInfo.ID != null);
+
             // ensure the score is in a consistent state with the current player.
             Score.ScoreInfo.BeatmapInfo = Beatmap.Value.BeatmapInfo;
             Score.ScoreInfo.Ruleset = ruleset.RulesetInfo;
+            Score.ScoreInfo.RulesetID = ruleset.RulesetInfo.ID.Value;
             Score.ScoreInfo.Mods = gameplayMods;
 
             dependencies.CacheAs(GameplayState = new GameplayState(playableBeatmap, ruleset, gameplayMods, Score));

From 14d405786ee50ac4a641717dec83a5a11e092b2c Mon Sep 17 00:00:00 2001
From: Xexxar <xexxar.xexxar@gmail.com>
Date: Sun, 17 Oct 2021 03:56:53 +0000
Subject: [PATCH 0287/5547] resolved nans and added stacked slider fix

---
 .../Preprocessing/OsuDifficultyHitObject.cs         | 13 ++++++++-----
 1 file changed, 8 insertions(+), 5 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
index 5aa249a616..d86358fb57 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
@@ -82,19 +82,22 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
                 scalingFactor *= 1 + smallCircleBonus;
             }
 
+            double sliderAbuseIndex = 1;
+
             if (lastObject is Slider lastSlider)
             {
                 computeSliderCursorPosition(lastSlider);
-                TravelDistance = lastSlider.LazyTravelDistance * scalingFactor;
-                TravelTime = Math.Max(lastSlider.LazyTravelTime / clockRate, 0);
-                MovementTime = Math.Max(StrainTime - TravelTime, 0);
+                sliderAbuseIndex = Math.Clamp(Vector2.Subtract(lastSlider.StackedPosition * scalingFactor, BaseObject.StackedPosition * scalingFactor).Length - 100, 0, 25) / 25;
+                TravelDistance = lastSlider.LazyTravelDistance * scalingFactor * sliderAbuseIndex;
+                TravelTime = Math.Max(lastSlider.LazyTravelTime / clockRate, 25);
+                MovementTime = Math.Max(StrainTime - TravelTime, 25);
                 MovementDistance = Vector2.Subtract(lastSlider.TailCircle.StackedPosition, BaseObject.StackedPosition).Length * scalingFactor;
             }
 
             Vector2 lastCursorPosition = getEndCursorPosition(lastObject);
 
-            JumpDistance = (BaseObject.StackedPosition * scalingFactor - lastCursorPosition * scalingFactor).Length;
-            MovementDistance = Math.Min(JumpDistance, MovementDistance);
+            JumpDistance = (BaseObject.StackedPosition * scalingFactor - lastCursorPosition * scalingFactor).Length * sliderAbuseIndex;
+            MovementDistance = Math.Min(JumpDistance, MovementDistance) * sliderAbuseIndex;
 
             if (lastLastObject != null && !(lastLastObject is Spinner))
             {

From 25f172fae8ba1c06771948afa0a9d0f73807a8a0 Mon Sep 17 00:00:00 2001
From: Susko3 <16479013+Susko3@users.noreply.github.com>
Date: Sun, 17 Oct 2021 12:17:38 +0200
Subject: [PATCH 0288/5547] Update usages of OpenInNativeExplorer to use
 ShowFileInNativeExplorer

Also updates WrappedStorage to override ShowFileInNativeExplorer.
---
 osu.Game/Database/ArchiveModelManager.cs | 6 ++++--
 osu.Game/Graphics/ScreenshotManager.cs   | 2 +-
 osu.Game/IO/WrappedStorage.cs            | 2 ++
 osu.Game/OsuGame.cs                      | 4 +++-
 4 files changed, 10 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Database/ArchiveModelManager.cs b/osu.Game/Database/ArchiveModelManager.cs
index 84e33e3f36..0c6b229413 100644
--- a/osu.Game/Database/ArchiveModelManager.cs
+++ b/osu.Game/Database/ArchiveModelManager.cs
@@ -462,10 +462,12 @@ namespace osu.Game.Database
             if (retrievedItem == null)
                 throw new ArgumentException(@"Specified model could not be found", nameof(item));
 
-            using (var outputStream = exportStorage.GetStream($"{getValidFilename(item.ToString())}{HandledExtensions.First()}", FileAccess.Write, FileMode.Create))
+            var filename = $"{getValidFilename(item.ToString())}{HandledExtensions.First()}";
+
+            using (var outputStream = exportStorage.GetStream(filename, FileAccess.Write, FileMode.Create))
                 ExportModelTo(retrievedItem, outputStream);
 
-            exportStorage.OpenInNativeExplorer();
+            exportStorage.ShowFileInNativeExplorer(filename);
         }
 
         /// <summary>
diff --git a/osu.Game/Graphics/ScreenshotManager.cs b/osu.Game/Graphics/ScreenshotManager.cs
index 9cd403f409..27e6e2bb1c 100644
--- a/osu.Game/Graphics/ScreenshotManager.cs
+++ b/osu.Game/Graphics/ScreenshotManager.cs
@@ -135,7 +135,7 @@ namespace osu.Game.Graphics
                     Text = $"{fileName} saved!",
                     Activated = () =>
                     {
-                        storage.OpenInNativeExplorer();
+                        storage.ShowFileInNativeExplorer(fileName);
                         return true;
                     }
                 });
diff --git a/osu.Game/IO/WrappedStorage.cs b/osu.Game/IO/WrappedStorage.cs
index b9ccc907d9..1e2d53d6fb 100644
--- a/osu.Game/IO/WrappedStorage.cs
+++ b/osu.Game/IO/WrappedStorage.cs
@@ -72,6 +72,8 @@ namespace osu.Game.IO
 
         public override void OpenPathInNativeExplorer(string path) => UnderlyingStorage.OpenPathInNativeExplorer(MutatePath(path));
 
+        public override void ShowFileInNativeExplorer(string filename) => UnderlyingStorage.ShowFileInNativeExplorer(MutatePath(filename));
+
         public override Storage GetStorageForDirectory(string path)
         {
             if (string.IsNullOrEmpty(path))
diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index 820597488b..a36c1e18e0 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -913,13 +913,15 @@ namespace osu.Game
                 }
                 else if (recentLogCount == short_term_display_limit)
                 {
+                    var logFile = $@"{entry.Target.ToString().ToLowerInvariant()}.log";
+
                     Schedule(() => Notifications.Post(new SimpleNotification
                     {
                         Icon = FontAwesome.Solid.EllipsisH,
                         Text = "Subsequent messages have been logged. Click to view log files.",
                         Activated = () =>
                         {
-                            Storage.GetStorageForDirectory("logs").OpenInNativeExplorer();
+                            Storage.GetStorageForDirectory(@"logs").ShowFileInNativeExplorer(logFile);
                             return true;
                         }
                     }));

From 3529f34c98b09399448a8aa6f1459e1460275361 Mon Sep 17 00:00:00 2001
From: 5ln <xnafumie@gmail.com>
Date: Mon, 18 Oct 2021 01:58:38 +0800
Subject: [PATCH 0289/5547] Multi: Hide mods when spectating or Beatmap isn't
 Locally Available.

Signed-off-by: 5ln <xnafumie@gmail.com>
---
 .../TestSceneMultiplayerParticipantsList.cs   | 62 +++++++++++++++++++
 .../Participants/ParticipantPanel.cs          |  6 ++
 2 files changed, 68 insertions(+)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerParticipantsList.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerParticipantsList.cs
index c4ebc13245..d1980b03c7 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerParticipantsList.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerParticipantsList.cs
@@ -275,6 +275,68 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 var state = i;
                 AddStep($"set state: {state}", () => Client.ChangeUserState(0, state));
             }
+
+            AddStep("set state: downloading", () => Client.ChangeUserBeatmapAvailability(0, BeatmapAvailability.Downloading(0)));
+
+            AddStep("set state: locally available", () => Client.ChangeUserBeatmapAvailability(0, BeatmapAvailability.LocallyAvailable()));
+        }
+
+        [Test]
+        public void TestModOverlap()
+        {
+            AddStep("add dummy mods", () =>
+            {
+                Client.ChangeUserMods(new Mod[]
+                {
+                    new OsuModNoFail(),
+                    new OsuModDoubleTime()
+                });
+            });
+
+            AddStep("add user with mods", () =>
+            {
+                Client.AddUser(new User
+                {
+                    Id = 0,
+                    Username = "Baka",
+                    RulesetsStatistics = new Dictionary<string, UserStatistics>
+                    {
+                        {
+                            Ruleset.Value.ShortName,
+                            new UserStatistics { GlobalRank = RNG.Next(1, 100000), }
+                        }
+                    },
+                    CoverUrl = @"https://osu.ppy.sh/images/headers/profile-covers/c3.jpg",
+                });
+                Client.ChangeUserMods(0, new Mod[]
+                {
+                    new OsuModHardRock(),
+                    new OsuModDoubleTime()
+                });
+            });
+
+            AddStep("set 0 ready", () => Client.ChangeState(MultiplayerUserState.Ready));
+
+            AddStep("set 1 spectate", () => Client.ChangeUserState(0, MultiplayerUserState.Spectating));
+
+            // Have to set back to idle due to status priority.
+            AddStep("set 0 no map, 1 ready", () =>
+            {
+                Client.ChangeState(MultiplayerUserState.Idle);
+                Client.ChangeBeatmapAvailability(BeatmapAvailability.NotDownloaded());
+                Client.ChangeUserState(0, MultiplayerUserState.Ready);
+            });
+
+            AddStep("set 0 downloading", () => Client.ChangeBeatmapAvailability(BeatmapAvailability.Downloading(0)));
+
+            AddStep("set 0 spectate", () => Client.ChangeUserState(0, MultiplayerUserState.Spectating));
+
+            AddStep("make both default", () =>
+            {
+                Client.ChangeBeatmapAvailability(BeatmapAvailability.LocallyAvailable());
+                Client.ChangeUserState(0, MultiplayerUserState.Idle);
+                Client.ChangeState(MultiplayerUserState.Idle);
+            });
         }
 
         private void createNewParticipantsList()
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantPanel.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantPanel.cs
index 6f8c735b6e..79e305b765 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantPanel.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantPanel.cs
@@ -15,6 +15,7 @@ using osu.Framework.Graphics.UserInterface;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.UserInterface;
+using osu.Game.Online;
 using osu.Game.Online.API;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Rulesets;
@@ -190,6 +191,11 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Participants
 
             userStateDisplay.UpdateStatus(User.State, User.BeatmapAvailability);
 
+            if ((User.BeatmapAvailability.State == DownloadState.LocallyAvailable) && (User.State != MultiplayerUserState.Spectating))
+                userModsDisplay.FadeIn(fade_time);
+            else
+                userModsDisplay.FadeOut(fade_time);
+
             if (Client.IsHost && !User.Equals(Client.LocalUser))
                 kickButton.FadeIn(fade_time);
             else

From 818f35c35f00724e30f4dbbd51fc58a98386627d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 15 Oct 2021 21:44:56 +0200
Subject: [PATCH 0290/5547] Restyle default value indicator

---
 .../TestSceneRestoreDefaultValueButton.cs     | 53 +++++++++++++++
 osu.Game/Graphics/OsuColour.cs                |  7 ++
 .../Overlays/RestoreDefaultValueButton.cs     | 66 ++++++++++---------
 3 files changed, 96 insertions(+), 30 deletions(-)
 create mode 100644 osu.Game.Tests/Visual/Settings/TestSceneRestoreDefaultValueButton.cs

diff --git a/osu.Game.Tests/Visual/Settings/TestSceneRestoreDefaultValueButton.cs b/osu.Game.Tests/Visual/Settings/TestSceneRestoreDefaultValueButton.cs
new file mode 100644
index 0000000000..0716907315
--- /dev/null
+++ b/osu.Game.Tests/Visual/Settings/TestSceneRestoreDefaultValueButton.cs
@@ -0,0 +1,53 @@
+// 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.Bindables;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.Shapes;
+using osu.Game.Graphics;
+using osu.Game.Overlays;
+using osuTK;
+
+namespace osu.Game.Tests.Visual.Settings
+{
+    public class TestSceneRestoreDefaultValueButton : OsuTestScene
+    {
+        [Resolved]
+        private OsuColour colours { get; set; }
+
+        [Test]
+        public void TestBasic()
+        {
+            RestoreDefaultValueButton<bool> restoreDefaultValueButton = null;
+
+            AddStep("create button", () => Child = new Container
+            {
+                RelativeSizeAxes = Axes.Both,
+                Children = new Drawable[]
+                {
+                    new Box
+                    {
+                        RelativeSizeAxes = Axes.Both,
+                        Colour = colours.GreySeafoam
+                    },
+                    restoreDefaultValueButton = new RestoreDefaultValueButton<bool>
+                    {
+                        Anchor = Anchor.Centre,
+                        Origin = Anchor.Centre,
+                        Current = new BindableBool(),
+                    }
+                }
+            });
+            AddSliderStep("set scale", 1, 4, 1, scale =>
+            {
+                if (restoreDefaultValueButton != null)
+                    restoreDefaultValueButton.Scale = new Vector2(scale);
+            });
+            AddToggleStep("toggle default state", state => restoreDefaultValueButton.Current.Value = state);
+            AddToggleStep("toggle disabled state", state => restoreDefaultValueButton.Current.Disabled = state);
+        }
+    }
+}
diff --git a/osu.Game/Graphics/OsuColour.cs b/osu.Game/Graphics/OsuColour.cs
index af2bb26871..40d163635a 100644
--- a/osu.Game/Graphics/OsuColour.cs
+++ b/osu.Game/Graphics/OsuColour.cs
@@ -235,11 +235,18 @@ namespace osu.Game.Graphics
         /// </summary>
         public readonly Color4 Blue3 = Color4Extensions.FromHex(@"3399cc");
 
+        public readonly Color4 Lime0 = Color4Extensions.FromHex(@"ccff99");
+
         /// <summary>
         /// Equivalent to <see cref="OverlayColourProvider.Lime"/>'s <see cref="OverlayColourProvider.Colour1"/>.
         /// </summary>
         public readonly Color4 Lime1 = Color4Extensions.FromHex(@"b2ff66");
 
+        /// <summary>
+        /// Equivalent to <see cref="OverlayColourProvider.Lime"/>'s <see cref="OverlayColourProvider.Colour3"/>.
+        /// </summary>
+        public readonly Color4 Lime3 = Color4Extensions.FromHex(@"7fcc33");
+
         /// <summary>
         /// Equivalent to <see cref="OverlayColourProvider.Orange"/>'s <see cref="OverlayColourProvider.Colour1"/>.
         /// </summary>
diff --git a/osu.Game/Overlays/RestoreDefaultValueButton.cs b/osu.Game/Overlays/RestoreDefaultValueButton.cs
index 87a294cc10..de600e8172 100644
--- a/osu.Game/Overlays/RestoreDefaultValueButton.cs
+++ b/osu.Game/Overlays/RestoreDefaultValueButton.cs
@@ -3,10 +3,8 @@
 
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
-using osuTK.Graphics;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
-using osu.Framework.Graphics.Colour;
 using osu.Framework.Graphics.Cursor;
 using osu.Framework.Graphics.Effects;
 using osu.Framework.Graphics.UserInterface;
@@ -14,6 +12,7 @@ using osu.Framework.Input.Events;
 using osu.Framework.Localisation;
 using osu.Game.Graphics;
 using osu.Game.Graphics.UserInterface;
+using osuTK;
 
 namespace osu.Game.Overlays
 {
@@ -45,30 +44,21 @@ namespace osu.Game.Overlays
             }
         }
 
-        private bool hovering;
+        [Resolved]
+        private OsuColour colours { get; set; }
 
-        public RestoreDefaultValueButton()
-        {
-            Height = 1;
-
-            RelativeSizeAxes = Axes.Y;
-            Width = SettingsPanel.CONTENT_MARGINS;
-        }
+        private const float size = 4;
 
         [BackgroundDependencyLoader]
         private void load(OsuColour colour)
         {
-            BackgroundColour = colour.Yellow;
-            Content.Width = 0.33f;
-            Content.CornerRadius = 3;
-            Content.EdgeEffect = new EdgeEffectParameters
-            {
-                Colour = BackgroundColour.Opacity(0.1f),
-                Type = EdgeEffectType.Glow,
-                Radius = 2,
-            };
+            BackgroundColour = colour.Lime1;
+            Size = new Vector2(3 * size);
+
+            Content.RelativeSizeAxes = Axes.None;
+            Content.Size = new Vector2(size);
+            Content.CornerRadius = size / 2;
 
-            Padding = new MarginPadding { Vertical = 1.5f };
             Alpha = 0f;
 
             Action += () =>
@@ -81,39 +71,55 @@ namespace osu.Game.Overlays
         protected override void LoadComplete()
         {
             base.LoadComplete();
-
-            // avoid unnecessary transforms on first display.
-            Alpha = currentAlpha;
-            Background.Colour = currentColour;
+            updateState();
+            FinishTransforms(true);
         }
 
         public LocalisableString TooltipText => "revert to default";
 
         protected override bool OnHover(HoverEvent e)
         {
-            hovering = true;
             UpdateState();
             return false;
         }
 
         protected override void OnHoverLost(HoverLostEvent e)
         {
-            hovering = false;
             UpdateState();
         }
 
         public void UpdateState() => Scheduler.AddOnce(updateState);
 
-        private float currentAlpha => current.IsDefault ? 0f : hovering && !current.Disabled ? 1f : 0.65f;
-        private ColourInfo currentColour => current.Disabled ? Color4.Gray : BackgroundColour;
+        private const double fade_duration = 200;
 
         private void updateState()
         {
             if (current == null)
                 return;
 
-            this.FadeTo(currentAlpha, 200, Easing.OutQuint);
-            Background.FadeColour(currentColour, 200, Easing.OutQuint);
+            Enabled.Value = !Current.Disabled;
+
+            if (!Current.Disabled)
+            {
+                this.FadeTo(Current.IsDefault ? 0 : 1, fade_duration, Easing.OutQuint);
+                Background.FadeColour(IsHovered ? colours.Lime0 : colours.Lime1, fade_duration, Easing.OutQuint);
+                Content.TweenEdgeEffectTo(new EdgeEffectParameters
+                {
+                    Colour = (IsHovered ? colours.Lime1 : colours.Lime3).Opacity(0.4f),
+                    Radius = IsHovered ? 8 : 4,
+                    Type = EdgeEffectType.Glow
+                }, fade_duration, Easing.OutQuint);
+            }
+            else
+            {
+                Background.FadeColour(colours.Lime3, fade_duration, Easing.OutQuint);
+                Content.TweenEdgeEffectTo(new EdgeEffectParameters
+                {
+                    Colour = colours.Lime3.Opacity(0.4f).Opacity(0.1f),
+                    Radius = 2,
+                    Type = EdgeEffectType.Glow
+                }, fade_duration, Easing.OutQuint);
+            }
         }
     }
 }

From f422ebb281edd47e30968ba8ec7d38ca390fe382 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 15 Oct 2021 22:44:28 +0200
Subject: [PATCH 0291/5547] Adjust `SettingsItem` to accommodate new default
 value indicator

---
 .../Visual/Settings/TestSceneSettingsItem.cs  | 45 ++++++++++++--
 .../Overlays/Settings/SettingsDropdown.cs     |  6 --
 osu.Game/Overlays/Settings/SettingsItem.cs    | 61 +++++++++++++++----
 osu.Game/Overlays/Settings/SettingsSlider.cs  |  1 -
 4 files changed, 90 insertions(+), 23 deletions(-)

diff --git a/osu.Game.Tests/Visual/Settings/TestSceneSettingsItem.cs b/osu.Game.Tests/Visual/Settings/TestSceneSettingsItem.cs
index d9cce69ee3..9c3940af4c 100644
--- a/osu.Game.Tests/Visual/Settings/TestSceneSettingsItem.cs
+++ b/osu.Game.Tests/Visual/Settings/TestSceneSettingsItem.cs
@@ -4,6 +4,7 @@
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Bindables;
+using osu.Framework.Graphics.Containers;
 using osu.Framework.Testing;
 using osu.Game.Overlays.Settings;
 using osu.Game.Overlays;
@@ -29,9 +30,10 @@ namespace osu.Game.Tests.Visual.Settings
                         Value = "test"
                     }
                 };
-
-                restoreDefaultValueButton = textBox.ChildrenOfType<RestoreDefaultValueButton<string>>().Single();
             });
+            AddUntilStep("wait for loaded", () => textBox.IsLoaded);
+            AddStep("retrieve restore default button", () => restoreDefaultValueButton = textBox.ChildrenOfType<RestoreDefaultValueButton<string>>().Single());
+
             AddAssert("restore button hidden", () => restoreDefaultValueButton.Alpha == 0);
 
             AddStep("change value from default", () => textBox.Current.Value = "non-default");
@@ -41,6 +43,41 @@ namespace osu.Game.Tests.Visual.Settings
             AddUntilStep("restore button hidden", () => restoreDefaultValueButton.Alpha == 0);
         }
 
+        [Test]
+        public void TestSetAndClearLabelText()
+        {
+            SettingsTextBox textBox = null;
+            GridContainer settingsItemGrid = null;
+            RestoreDefaultValueButton<string> restoreDefaultValueButton = null;
+
+            AddStep("create settings item", () =>
+            {
+                Child = textBox = new SettingsTextBox
+                {
+                    Current = new Bindable<string>
+                    {
+                        Default = "test",
+                        Value = "test"
+                    }
+                };
+            });
+            AddUntilStep("wait for loaded", () => textBox.IsLoaded);
+            AddStep("retrieve components", () =>
+            {
+                settingsItemGrid = textBox.ChildrenOfType<GridContainer>().Single();
+                restoreDefaultValueButton = textBox.ChildrenOfType<RestoreDefaultValueButton<string>>().Single();
+            });
+
+            AddStep("set non-default value", () => restoreDefaultValueButton.Current.Value = "non-default");
+            AddAssert("default value button next to control", () => settingsItemGrid.Content[1][0] == restoreDefaultValueButton);
+
+            AddStep("set label", () => textBox.LabelText = "label text");
+            AddAssert("default value button next to label", () => settingsItemGrid.Content[0][0] == restoreDefaultValueButton);
+
+            AddStep("clear label", () => textBox.LabelText = default);
+            AddAssert("default value button next to control", () => settingsItemGrid.Content[1][0] == restoreDefaultValueButton);
+        }
+
         /// <summary>
         /// Ensures that the reset to default button uses the correct implementation of IsDefault to determine whether it should be shown or not.
         /// Values have been chosen so that after being set, Value != Default (but they are close enough that the difference is negligible compared to Precision).
@@ -64,9 +101,9 @@ namespace osu.Game.Tests.Visual.Settings
                         Precision = 0.1f,
                     }
                 };
-
-                restoreDefaultValueButton = sliderBar.ChildrenOfType<RestoreDefaultValueButton<float>>().Single();
             });
+            AddUntilStep("wait for loaded", () => sliderBar.IsLoaded);
+            AddStep("retrieve restore default button", () => restoreDefaultValueButton = sliderBar.ChildrenOfType<RestoreDefaultValueButton<float>>().Single());
 
             AddAssert("restore button hidden", () => restoreDefaultValueButton.Alpha == 0);
 
diff --git a/osu.Game/Overlays/Settings/SettingsDropdown.cs b/osu.Game/Overlays/Settings/SettingsDropdown.cs
index a281d03ee7..1e90222d28 100644
--- a/osu.Game/Overlays/Settings/SettingsDropdown.cs
+++ b/osu.Game/Overlays/Settings/SettingsDropdown.cs
@@ -6,7 +6,6 @@ using System.Linq;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Game.Graphics.UserInterface;
-using osuTK;
 
 namespace osu.Game.Overlays.Settings
 {
@@ -28,11 +27,6 @@ namespace osu.Game.Overlays.Settings
 
         public override IEnumerable<string> FilterTerms => base.FilterTerms.Concat(Control.Items.Select(i => i.ToString()));
 
-        public SettingsDropdown()
-        {
-            FlowContent.Spacing = new Vector2(0, 10);
-        }
-
         protected sealed override Drawable CreateControl() => CreateDropdown();
 
         protected virtual OsuDropdown<T> CreateDropdown() => new DropdownControl();
diff --git a/osu.Game/Overlays/Settings/SettingsItem.cs b/osu.Game/Overlays/Settings/SettingsItem.cs
index 5282217013..7895f6386b 100644
--- a/osu.Game/Overlays/Settings/SettingsItem.cs
+++ b/osu.Game/Overlays/Settings/SettingsItem.cs
@@ -3,6 +3,7 @@
 
 using System;
 using System.Collections.Generic;
+using JetBrains.Annotations;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
@@ -14,6 +15,7 @@ using osu.Framework.Localisation;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.Containers;
+using osuTK;
 
 namespace osu.Game.Overlays.Settings
 {
@@ -30,6 +32,10 @@ namespace osu.Game.Overlays.Settings
         protected readonly FillFlowContainer FlowContent;
 
         private SpriteText labelText;
+        private readonly GridContainer gridContainer;
+
+        [CanBeNull]
+        private RestoreDefaultValueButton<T> defaultValueButton;
 
         private OsuTextFlowContainer warningText;
 
@@ -48,12 +54,13 @@ namespace osu.Game.Overlays.Settings
                 if (labelText == null)
                 {
                     // construct lazily for cases where the label is not needed (may be provided by the Control).
-                    FlowContent.Insert(-1, labelText = new OsuSpriteText());
+                    gridContainer.Content[0][1] = labelText = new OsuSpriteText();
 
                     updateDisabled();
                 }
 
                 labelText.Text = value;
+                updateLayout();
             }
         }
 
@@ -106,18 +113,33 @@ namespace osu.Game.Overlays.Settings
             AutoSizeAxes = Axes.Y;
             Padding = new MarginPadding { Right = SettingsPanel.CONTENT_MARGINS };
 
-            InternalChildren = new Drawable[]
+            FlowContent = new FillFlowContainer
             {
-                FlowContent = new FillFlowContainer
+                RelativeSizeAxes = Axes.X,
+                AutoSizeAxes = Axes.Y,
+                Spacing = new Vector2(0, 10),
+                Child = Control = CreateControl(),
+            };
+
+            InternalChild = gridContainer = new GridContainer
+            {
+                RelativeSizeAxes = Axes.X,
+                AutoSizeAxes = Axes.Y,
+                RowDimensions = new[]
                 {
-                    RelativeSizeAxes = Axes.X,
-                    AutoSizeAxes = Axes.Y,
-                    Padding = new MarginPadding { Left = SettingsPanel.CONTENT_MARGINS },
-                    Children = new[]
-                    {
-                        Control = CreateControl(),
-                    },
+                    new Dimension(GridSizeMode.AutoSize),
+                    new Dimension(GridSizeMode.AutoSize)
                 },
+                ColumnDimensions = new[]
+                {
+                    new Dimension(GridSizeMode.Absolute, SettingsPanel.CONTENT_MARGINS),
+                    new Dimension()
+                },
+                Content = new[]
+                {
+                    new Drawable[2],
+                    new Drawable[] { null, FlowContent }
+                }
             };
 
             // IMPORTANT: all bindable logic is in constructor intentionally to support "CreateSettingsControls" being used in a context it is
@@ -135,13 +157,28 @@ namespace osu.Game.Overlays.Settings
             // intentionally done before LoadComplete to avoid overhead.
             if (ShowsDefaultIndicator)
             {
-                AddInternal(new RestoreDefaultValueButton<T>
+                defaultValueButton = new RestoreDefaultValueButton<T>
                 {
                     Current = controlWithCurrent.Current,
-                });
+                    Anchor = Anchor.Centre,
+                    Origin = Anchor.Centre
+                };
+                updateLayout();
             }
         }
 
+        private void updateLayout()
+        {
+            bool hasLabel = !string.IsNullOrEmpty(labelText?.Text.ToString());
+
+            gridContainer.Content[0][0] = null;
+            gridContainer.Content[1][0] = null;
+
+            gridContainer.Content[hasLabel ? 0 : 1][0] = defaultValueButton;
+
+            FlowContent.Margin = new MarginPadding { Top = hasLabel ? 10 : 0 };
+        }
+
         private void updateDisabled()
         {
             if (labelText != null)
diff --git a/osu.Game/Overlays/Settings/SettingsSlider.cs b/osu.Game/Overlays/Settings/SettingsSlider.cs
index bb9c0dd4d7..b95b0af11c 100644
--- a/osu.Game/Overlays/Settings/SettingsSlider.cs
+++ b/osu.Game/Overlays/Settings/SettingsSlider.cs
@@ -19,7 +19,6 @@ namespace osu.Game.Overlays.Settings
     {
         protected override Drawable CreateControl() => new TSlider
         {
-            Margin = new MarginPadding { Vertical = 10 },
             RelativeSizeAxes = Axes.X
         };
 

From 552fc1dc8af353a6a9fdc61cf8a732789f8cc6bd Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 15 Oct 2021 23:15:28 +0200
Subject: [PATCH 0292/5547] Adjust key binding rows to accommodate new default
 value indicator

---
 .../Settings/Sections/Input/KeyBindingRow.cs  | 110 ++++++++++--------
 1 file changed, 64 insertions(+), 46 deletions(-)

diff --git a/osu.Game/Overlays/Settings/Sections/Input/KeyBindingRow.cs b/osu.Game/Overlays/Settings/Sections/Input/KeyBindingRow.cs
index da789db79a..c2667fbdac 100644
--- a/osu.Game/Overlays/Settings/Sections/Input/KeyBindingRow.cs
+++ b/osu.Game/Overlays/Settings/Sections/Input/KeyBindingRow.cs
@@ -82,64 +82,82 @@ namespace osu.Game.Overlays.Settings.Sections.Input
         {
             RelativeSizeAxes = Axes.X;
             AutoSizeAxes = Axes.Y;
-            Padding = new MarginPadding { Horizontal = SettingsPanel.CONTENT_MARGINS };
 
-            InternalChildren = new Drawable[]
+            InternalChild = new GridContainer
             {
-                new RestoreDefaultValueButton<bool>
+                RelativeSizeAxes = Axes.X,
+                AutoSizeAxes = Axes.Y,
+                ColumnDimensions = new[]
                 {
-                    Current = isDefault,
-                    Action = RestoreDefaults,
-                    Origin = Anchor.TopRight,
+                    new Dimension(GridSizeMode.Absolute, SettingsPanel.CONTENT_MARGINS),
+                    new Dimension(),
+                    new Dimension(GridSizeMode.Absolute, SettingsPanel.CONTENT_MARGINS),
                 },
-                content = new Container
+                RowDimensions = new[]
                 {
-                    RelativeSizeAxes = Axes.X,
-                    AutoSizeAxes = Axes.Y,
-                    Masking = true,
-                    CornerRadius = padding,
-                    EdgeEffect = new EdgeEffectParameters
+                    new Dimension(GridSizeMode.AutoSize)
+                },
+                Content = new[]
+                {
+                    new Drawable[]
                     {
-                        Radius = 2,
-                        Colour = colourProvider.Highlight1.Opacity(0),
-                        Type = EdgeEffectType.Shadow,
-                        Hollow = true,
-                    },
-                    Children = new Drawable[]
-                    {
-                        new Box
+                        new RestoreDefaultValueButton<bool>
                         {
-                            RelativeSizeAxes = Axes.Both,
-                            Colour = colourProvider.Background5,
+                            Current = isDefault,
+                            Action = RestoreDefaults,
+                            Anchor = Anchor.Centre,
+                            Origin = Anchor.Centre
                         },
-                        text = new OsuSpriteText
+                        content = new Container
                         {
-                            Text = action.GetLocalisableDescription(),
-                            Margin = new MarginPadding(1.5f * padding),
-                        },
-                        buttons = new FillFlowContainer<KeyButton>
-                        {
-                            AutoSizeAxes = Axes.Both,
-                            Anchor = Anchor.TopRight,
-                            Origin = Anchor.TopRight
-                        },
-                        cancelAndClearButtons = new FillFlowContainer
-                        {
-                            AutoSizeAxes = Axes.Both,
-                            Padding = new MarginPadding(padding) { Top = height + padding * 2 },
-                            Anchor = Anchor.TopRight,
-                            Origin = Anchor.TopRight,
-                            Alpha = 0,
-                            Spacing = new Vector2(5),
+                            RelativeSizeAxes = Axes.X,
+                            AutoSizeAxes = Axes.Y,
+                            Masking = true,
+                            CornerRadius = padding,
+                            EdgeEffect = new EdgeEffectParameters
+                            {
+                                Radius = 2,
+                                Colour = colourProvider.Highlight1.Opacity(0),
+                                Type = EdgeEffectType.Shadow,
+                                Hollow = true,
+                            },
                             Children = new Drawable[]
                             {
-                                new CancelButton { Action = finalise },
-                                new ClearButton { Action = clear },
-                            },
-                        }
+                                new Box
+                                {
+                                    RelativeSizeAxes = Axes.Both,
+                                    Colour = colourProvider.Background5,
+                                },
+                                text = new OsuSpriteText
+                                {
+                                    Text = action.GetLocalisableDescription(),
+                                    Margin = new MarginPadding(1.5f * padding),
+                                },
+                                buttons = new FillFlowContainer<KeyButton>
+                                {
+                                    AutoSizeAxes = Axes.Both,
+                                    Anchor = Anchor.TopRight,
+                                    Origin = Anchor.TopRight
+                                },
+                                cancelAndClearButtons = new FillFlowContainer
+                                {
+                                    AutoSizeAxes = Axes.Both,
+                                    Padding = new MarginPadding(padding) { Top = height + padding * 2 },
+                                    Anchor = Anchor.TopRight,
+                                    Origin = Anchor.TopRight,
+                                    Alpha = 0,
+                                    Spacing = new Vector2(5),
+                                    Children = new Drawable[]
+                                    {
+                                        new CancelButton { Action = finalise },
+                                        new ClearButton { Action = clear },
+                                    },
+                                }
+                            }
+                        },
+                        new HoverClickSounds()
                     }
-                },
-                new HoverClickSounds()
+                }
             };
 
             foreach (var b in bindings)

From 2a41e8bd1fd2d5b87922f167e02302d090b4fcf4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 15 Oct 2021 23:24:53 +0200
Subject: [PATCH 0293/5547] Remove unneeded extra padding from settings number
 box

---
 osu.Game/Overlays/Settings/SettingsNumberBox.cs | 1 -
 1 file changed, 1 deletion(-)

diff --git a/osu.Game/Overlays/Settings/SettingsNumberBox.cs b/osu.Game/Overlays/Settings/SettingsNumberBox.cs
index d36aa2bfc2..aca7a210b3 100644
--- a/osu.Game/Overlays/Settings/SettingsNumberBox.cs
+++ b/osu.Game/Overlays/Settings/SettingsNumberBox.cs
@@ -13,7 +13,6 @@ namespace osu.Game.Overlays.Settings
         protected override Drawable CreateControl() => new NumberControl
         {
             RelativeSizeAxes = Axes.X,
-            Margin = new MarginPadding { Top = 5 }
         };
 
         private sealed class NumberControl : CompositeDrawable, IHasCurrentValue<int?>

From 0d992a04930c65ab24902b82d959e15bef15bfc3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 18 Oct 2021 13:30:24 +0900
Subject: [PATCH 0294/5547] Add failing test showing epilepsy warning is not
 fading on early exit

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

diff --git a/osu.Game.Tests/Visual/Gameplay/TestScenePlayerLoader.cs b/osu.Game.Tests/Visual/Gameplay/TestScenePlayerLoader.cs
index aee15a145c..ba0ee5ac6e 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestScenePlayerLoader.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestScenePlayerLoader.cs
@@ -291,7 +291,7 @@ namespace osu.Game.Tests.Visual.Gameplay
 
             AddUntilStep("wait for current", () => loader.IsCurrentScreen());
 
-            AddAssert($"epilepsy warning {(warning ? "present" : "absent")}", () => this.ChildrenOfType<EpilepsyWarning>().Any() == warning);
+            AddAssert($"epilepsy warning {(warning ? "present" : "absent")}", () => (getWarning() != null) == warning);
 
             if (warning)
             {
@@ -335,12 +335,17 @@ namespace osu.Game.Tests.Visual.Gameplay
 
             AddUntilStep("wait for current", () => loader.IsCurrentScreen());
 
-            AddUntilStep("wait for epilepsy warning", () => loader.ChildrenOfType<EpilepsyWarning>().Single().Alpha > 0);
+            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);
         }
 
+        private EpilepsyWarning getWarning() => loader.ChildrenOfType<EpilepsyWarning>().SingleOrDefault();
+
         private class TestPlayerLoader : PlayerLoader
         {
             public new VisualSettings VisualSettings => base.VisualSettings;

From 59dc04017eac9c55a6e1982fabcca255035e2fcb Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 18 Oct 2021 13:30:37 +0900
Subject: [PATCH 0295/5547] Fix epilepsy warning not being faded out on an
 early exit from `PlayerLoader`

---
 osu.Game/Screens/Play/PlayerLoader.cs | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/osu.Game/Screens/Play/PlayerLoader.cs b/osu.Game/Screens/Play/PlayerLoader.cs
index cf5bff57cf..d852ac2940 100644
--- a/osu.Game/Screens/Play/PlayerLoader.cs
+++ b/osu.Game/Screens/Play/PlayerLoader.cs
@@ -246,6 +246,9 @@ 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();
 

From 50bde0fe381c6c1d4f160845935e05ea1d2a8c24 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 18 Oct 2021 13:53:27 +0900
Subject: [PATCH 0296/5547] Refactor test to better keep existing toggle values

I also changed the type of the button to `float` because it was mentally
hard to parse a default button that is tracking a `bool` state. Probably
not what we want for a test like this.
---
 .../TestSceneRestoreDefaultValueButton.cs     | 20 ++++++++++++++-----
 1 file changed, 15 insertions(+), 5 deletions(-)

diff --git a/osu.Game.Tests/Visual/Settings/TestSceneRestoreDefaultValueButton.cs b/osu.Game.Tests/Visual/Settings/TestSceneRestoreDefaultValueButton.cs
index 0716907315..3eb7a77600 100644
--- a/osu.Game.Tests/Visual/Settings/TestSceneRestoreDefaultValueButton.cs
+++ b/osu.Game.Tests/Visual/Settings/TestSceneRestoreDefaultValueButton.cs
@@ -18,10 +18,18 @@ namespace osu.Game.Tests.Visual.Settings
         [Resolved]
         private OsuColour colours { get; set; }
 
+        private float scale = 1;
+
+        private readonly Bindable<float> current = new Bindable<float>
+        {
+            Default = default,
+            Value = 1,
+        };
+
         [Test]
         public void TestBasic()
         {
-            RestoreDefaultValueButton<bool> restoreDefaultValueButton = null;
+            RestoreDefaultValueButton<float> restoreDefaultValueButton = null;
 
             AddStep("create button", () => Child = new Container
             {
@@ -33,21 +41,23 @@ namespace osu.Game.Tests.Visual.Settings
                         RelativeSizeAxes = Axes.Both,
                         Colour = colours.GreySeafoam
                     },
-                    restoreDefaultValueButton = new RestoreDefaultValueButton<bool>
+                    restoreDefaultValueButton = new RestoreDefaultValueButton<float>
                     {
                         Anchor = Anchor.Centre,
                         Origin = Anchor.Centre,
-                        Current = new BindableBool(),
+                        Scale = new Vector2(scale),
+                        Current = current,
                     }
                 }
             });
             AddSliderStep("set scale", 1, 4, 1, scale =>
             {
+                this.scale = scale;
                 if (restoreDefaultValueButton != null)
                     restoreDefaultValueButton.Scale = new Vector2(scale);
             });
-            AddToggleStep("toggle default state", state => restoreDefaultValueButton.Current.Value = state);
-            AddToggleStep("toggle disabled state", state => restoreDefaultValueButton.Current.Disabled = state);
+            AddToggleStep("toggle default state", state => current.Value = state ? default : 1);
+            AddToggleStep("toggle disabled state", state => current.Disabled = state);
         }
     }
 }

From d37913a8b44fecbba70ba4f3e3e2ed614dee3482 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 18 Oct 2021 13:59:25 +0900
Subject: [PATCH 0297/5547] Disable null check pattern type check syntax
 inspections

---
 osu.sln.DotSettings | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.sln.DotSettings b/osu.sln.DotSettings
index e42b30e944..3af986543e 100644
--- a/osu.sln.DotSettings
+++ b/osu.sln.DotSettings
@@ -73,6 +73,7 @@
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=ConvertToLocalFunction/@EntryIndexedValue">HINT</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=ConvertToStaticClass/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=ConvertToUsingDeclaration/@EntryIndexedValue">HINT</s:String>
+	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=ConvertTypeCheckPatternToNullCheck/@EntryIndexedValue">DO_NOT_SHOW</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=DoubleNegationOperator/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=EmptyGeneralCatchClause/@EntryIndexedValue">DO_NOT_SHOW</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=EnforceDoWhileStatementBraces/@EntryIndexedValue">WARNING</s:String>

From 6d6eed61aa3bbe5fa9eed81e69e2e71f79e760ad Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 18 Oct 2021 14:00:35 +0900
Subject: [PATCH 0298/5547] Fix new indentation inspections

---
 osu.Game/Online/API/OAuth.cs | 24 ++++++++++++------------
 1 file changed, 12 insertions(+), 12 deletions(-)

diff --git a/osu.Game/Online/API/OAuth.cs b/osu.Game/Online/API/OAuth.cs
index d79fc58d1c..0dbc3b02db 100644
--- a/osu.Game/Online/API/OAuth.cs
+++ b/osu.Game/Online/API/OAuth.cs
@@ -40,12 +40,12 @@ namespace osu.Game.Online.API
             if (string.IsNullOrEmpty(password)) throw new ArgumentException("Missing password.");
 
             using (var req = new AccessTokenRequestPassword(username, password)
-            {
-                Url = $@"{endpoint}/oauth/token",
-                Method = HttpMethod.Post,
-                ClientId = clientId,
-                ClientSecret = clientSecret
-            })
+                {
+                    Url = $@"{endpoint}/oauth/token",
+                    Method = HttpMethod.Post,
+                    ClientId = clientId,
+                    ClientSecret = clientSecret
+                })
             {
                 try
                 {
@@ -80,12 +80,12 @@ namespace osu.Game.Online.API
             try
             {
                 using (var req = new AccessTokenRequestRefresh(refresh)
-                {
-                    Url = $@"{endpoint}/oauth/token",
-                    Method = HttpMethod.Post,
-                    ClientId = clientId,
-                    ClientSecret = clientSecret
-                })
+                    {
+                        Url = $@"{endpoint}/oauth/token",
+                        Method = HttpMethod.Post,
+                        ClientId = clientId,
+                        ClientSecret = clientSecret
+                    })
                 {
                     req.Perform();
 

From 762949f49fce8aa15fee93053dc766b0a6c1f58a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 18 Oct 2021 14:20:38 +0900
Subject: [PATCH 0299/5547] Don't flash screen red on fail if the user has
 disabled red tinting

---
 .../Visual/Gameplay/TestSceneAllRulesetPlayers.cs     |  9 +++++----
 .../Visual/Gameplay/TestSceneFailAnimation.cs         | 10 ++++++++++
 osu.Game/Screens/Play/FailAnimation.cs                | 11 ++++++++---
 3 files changed, 23 insertions(+), 7 deletions(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneAllRulesetPlayers.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneAllRulesetPlayers.cs
index 00b5c38e20..c5ab3974a4 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneAllRulesetPlayers.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneAllRulesetPlayers.cs
@@ -20,14 +20,15 @@ namespace osu.Game.Tests.Visual.Gameplay
     /// </summary>
     public abstract class TestSceneAllRulesetPlayers : RateAdjustedBeatmapTestScene
     {
-        protected Player Player;
+        protected Player Player { get; private set; }
+
+        protected OsuConfigManager Config { get; private set; }
 
         [BackgroundDependencyLoader]
         private void load(RulesetStore rulesets)
         {
-            OsuConfigManager manager;
-            Dependencies.Cache(manager = new OsuConfigManager(LocalStorage));
-            manager.GetBindable<double>(OsuSetting.DimLevel).Value = 1.0;
+            Dependencies.Cache(Config = new OsuConfigManager(LocalStorage));
+            Config.GetBindable<double>(OsuSetting.DimLevel).Value = 1.0;
         }
 
         [Test]
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneFailAnimation.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneFailAnimation.cs
index 85aaf20a19..36fc6812bd 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneFailAnimation.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneFailAnimation.cs
@@ -2,7 +2,9 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
+using NUnit.Framework;
 using osu.Framework.Graphics.Containers;
+using osu.Game.Configuration;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Screens.Play;
@@ -17,6 +19,14 @@ namespace osu.Game.Tests.Visual.Gameplay
             return new FailPlayer();
         }
 
+        [Test]
+        public void TestOsuWithoutRedTint()
+        {
+            AddStep("Disable red tint", () => Config.SetValue(OsuSetting.FadePlayfieldWhenHealthLow, false));
+            TestOsu();
+            AddStep("Enable red tint", () => Config.SetValue(OsuSetting.FadePlayfieldWhenHealthLow, true));
+        }
+
         protected override void AddCheckSteps()
         {
             AddUntilStep("wait for fail", () => Player.HasFailed);
diff --git a/osu.Game/Screens/Play/FailAnimation.cs b/osu.Game/Screens/Play/FailAnimation.cs
index 2a1c4599d5..242d997dd7 100644
--- a/osu.Game/Screens/Play/FailAnimation.cs
+++ b/osu.Game/Screens/Play/FailAnimation.cs
@@ -16,6 +16,7 @@ using osu.Framework.Graphics.Shapes;
 using osu.Framework.Utils;
 using osu.Game.Audio.Effects;
 using osu.Game.Beatmaps;
+using osu.Game.Configuration;
 using osu.Game.Rulesets.Objects.Drawables;
 using osuTK;
 using osuTK.Graphics;
@@ -35,7 +36,7 @@ namespace osu.Game.Screens.Play
 
         private Container filters;
 
-        private Box failFlash;
+        private Box redFlashLayer;
 
         private Track track;
 
@@ -46,6 +47,9 @@ namespace osu.Game.Screens.Play
 
         private Sample failSample;
 
+        [Resolved]
+        private OsuConfigManager config { get; set; }
+
         protected override Container<Drawable> Content { get; } = new Container
         {
             Anchor = Anchor.Centre,
@@ -77,7 +81,7 @@ namespace osu.Game.Screens.Play
                     },
                 },
                 Content,
-                failFlash = new Box
+                redFlashLayer = new Box
                 {
                     Colour = Color4.Red,
                     RelativeSizeAxes = Axes.Both,
@@ -114,7 +118,8 @@ namespace osu.Game.Screens.Play
             applyToPlayfield(drawableRuleset.Playfield);
             drawableRuleset.Playfield.HitObjectContainer.FadeOut(duration / 2);
 
-            failFlash.FadeOutFromOne(1000);
+            if (config.Get<bool>(OsuSetting.FadePlayfieldWhenHealthLow))
+                redFlashLayer.FadeOutFromOne(1000);
 
             Content.Masking = true;
 

From 3c4c9ab7a7e6c2c480245e08671990298ed9dc5a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 18 Oct 2021 14:25:51 +0900
Subject: [PATCH 0300/5547] Move `ICanAcceptFiles` specification to
 `IModelImporter<TModel>`

---
 osu.Game/Database/ArchiveModelManager.cs |  2 +-
 osu.Game/Database/IModelImporter.cs      | 14 +-------------
 2 files changed, 2 insertions(+), 14 deletions(-)

diff --git a/osu.Game/Database/ArchiveModelManager.cs b/osu.Game/Database/ArchiveModelManager.cs
index 84e33e3f36..9c777d324b 100644
--- a/osu.Game/Database/ArchiveModelManager.cs
+++ b/osu.Game/Database/ArchiveModelManager.cs
@@ -30,7 +30,7 @@ namespace osu.Game.Database
     /// </summary>
     /// <typeparam name="TModel">The model type.</typeparam>
     /// <typeparam name="TFileModel">The associated file join type.</typeparam>
-    public abstract class ArchiveModelManager<TModel, TFileModel> : ICanAcceptFiles, IModelManager<TModel>, IModelFileManager<TModel, TFileModel>
+    public abstract class ArchiveModelManager<TModel, TFileModel> : IModelManager<TModel>, IModelFileManager<TModel, TFileModel>
         where TModel : class, IHasFiles<TFileModel>, IHasPrimaryKey, ISoftDelete
         where TFileModel : class, INamedFileInfo, new()
     {
diff --git a/osu.Game/Database/IModelImporter.cs b/osu.Game/Database/IModelImporter.cs
index 479f33c3b4..5d0a044578 100644
--- a/osu.Game/Database/IModelImporter.cs
+++ b/osu.Game/Database/IModelImporter.cs
@@ -13,21 +13,9 @@ namespace osu.Game.Database
     /// A class which handles importing of associated models to the game store.
     /// </summary>
     /// <typeparam name="TModel">The model type.</typeparam>
-    public interface IModelImporter<TModel> : IPostNotifications, IPostImports<TModel>
+    public interface IModelImporter<TModel> : IPostNotifications, IPostImports<TModel>, ICanAcceptFiles
         where TModel : class
     {
-        /// <summary>
-        /// Import one or more <typeparamref name="TModel"/> items from filesystem <paramref name="paths"/>.
-        /// </summary>
-        /// <remarks>
-        /// This will be treated as a low priority import if more than one path is specified; use <see cref="ArchiveModelManager{TModel,TFileModel}.Import(osu.Game.Database.ImportTask[])"/> to always import at standard priority.
-        /// This will post notifications tracking progress.
-        /// </remarks>
-        /// <param name="paths">One or more archive locations on disk.</param>
-        Task Import(params string[] paths);
-
-        Task Import(params ImportTask[] tasks);
-
         Task<IEnumerable<ILive<TModel>>> Import(ProgressNotification notification, params ImportTask[] tasks);
 
         /// <summary>

From ad112cbbc52b1d6a9495e0c93548326481b02d30 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 18 Oct 2021 14:28:29 +0900
Subject: [PATCH 0301/5547] Fix intendation in a way it doesn't regress with
 older `inspectcode`

---
 osu.Game/Online/API/OAuth.cs | 42 ++++++++++++++++++++----------------
 1 file changed, 23 insertions(+), 19 deletions(-)

diff --git a/osu.Game/Online/API/OAuth.cs b/osu.Game/Online/API/OAuth.cs
index 0dbc3b02db..1feb3076d1 100644
--- a/osu.Game/Online/API/OAuth.cs
+++ b/osu.Game/Online/API/OAuth.cs
@@ -39,17 +39,19 @@ namespace osu.Game.Online.API
             if (string.IsNullOrEmpty(username)) throw new ArgumentException("Missing username.");
             if (string.IsNullOrEmpty(password)) throw new ArgumentException("Missing password.");
 
-            using (var req = new AccessTokenRequestPassword(username, password)
-                {
-                    Url = $@"{endpoint}/oauth/token",
-                    Method = HttpMethod.Post,
-                    ClientId = clientId,
-                    ClientSecret = clientSecret
-                })
+            var accessTokenRequest = new AccessTokenRequestPassword(username, password)
+            {
+                Url = $@"{endpoint}/oauth/token",
+                Method = HttpMethod.Post,
+                ClientId = clientId,
+                ClientSecret = clientSecret
+            };
+
+            using (accessTokenRequest)
             {
                 try
                 {
-                    req.Perform();
+                    accessTokenRequest.Perform();
                 }
                 catch (Exception ex)
                 {
@@ -60,7 +62,7 @@ namespace osu.Game.Online.API
                     try
                     {
                         // attempt to decode a displayable error string.
-                        var error = JsonConvert.DeserializeObject<OAuthError>(req.GetResponseString() ?? string.Empty);
+                        var error = JsonConvert.DeserializeObject<OAuthError>(accessTokenRequest.GetResponseString() ?? string.Empty);
                         if (error != null)
                             throwableException = new APIException(error.UserDisplayableError, ex);
                     }
@@ -71,7 +73,7 @@ namespace osu.Game.Online.API
                     throw throwableException;
                 }
 
-                Token.Value = req.ResponseObject;
+                Token.Value = accessTokenRequest.ResponseObject;
             }
         }
 
@@ -79,17 +81,19 @@ namespace osu.Game.Online.API
         {
             try
             {
-                using (var req = new AccessTokenRequestRefresh(refresh)
-                    {
-                        Url = $@"{endpoint}/oauth/token",
-                        Method = HttpMethod.Post,
-                        ClientId = clientId,
-                        ClientSecret = clientSecret
-                    })
+                var refreshRequest = new AccessTokenRequestRefresh(refresh)
                 {
-                    req.Perform();
+                    Url = $@"{endpoint}/oauth/token",
+                    Method = HttpMethod.Post,
+                    ClientId = clientId,
+                    ClientSecret = clientSecret
+                };
 
-                    Token.Value = req.ResponseObject;
+                using (refreshRequest)
+                {
+                    refreshRequest.Perform();
+
+                    Token.Value = refreshRequest.ResponseObject;
                     return true;
                 }
             }

From 75bfa705cf3949c0e933ef3b4ba189de339b62b4 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 18 Oct 2021 14:32:38 +0900
Subject: [PATCH 0302/5547] Remove unused method for now

---
 osu.Game/Stores/RealmArchiveModelImporter.cs | 7 -------
 1 file changed, 7 deletions(-)

diff --git a/osu.Game/Stores/RealmArchiveModelImporter.cs b/osu.Game/Stores/RealmArchiveModelImporter.cs
index cc61896ea5..ec454d25fa 100644
--- a/osu.Game/Stores/RealmArchiveModelImporter.cs
+++ b/osu.Game/Stores/RealmArchiveModelImporter.cs
@@ -546,12 +546,5 @@ namespace osu.Game.Stores
         }
 
         public virtual string HumanisedModelName => $"{typeof(TModel).Name.Replace(@"Info", "").ToLower()}";
-
-        private string getValidFilename(string filename)
-        {
-            foreach (char c in Path.GetInvalidFileNameChars())
-                filename = filename.Replace(c, '_');
-            return filename;
-        }
     }
 }

From 264fa703f2877c52f90f5ffd6ac89225712bd3ba Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 18 Oct 2021 14:43:48 +0900
Subject: [PATCH 0303/5547] Remove some forgotten temporary code from
 `BeatmapImporter`

And make the online queue not `dynamic`, at very least.
---
 osu.Game/Stores/BeatmapImporter.cs | 27 ++++++++++-----------------
 1 file changed, 10 insertions(+), 17 deletions(-)

diff --git a/osu.Game/Stores/BeatmapImporter.cs b/osu.Game/Stores/BeatmapImporter.cs
index 33276bff2f..721f507b3d 100644
--- a/osu.Game/Stores/BeatmapImporter.cs
+++ b/osu.Game/Stores/BeatmapImporter.cs
@@ -40,29 +40,20 @@ namespace osu.Game.Stores
 
         protected override string[] HashableFileTypes => new[] { ".osu" };
 
-        // protected override string ImportFromStablePath => ".";
-        //
-        // protected override Storage PrepareStableStorage(StableStorage stableStorage) => stableStorage.GetSongStorage();
-        //
-        // protected override bool ShouldDeleteArchive(string path) => Path.GetExtension(path)?.ToLowerInvariant() == ".osz";
-        //
         // protected override bool CheckLocalAvailability(RealmBeatmapSet model, System.Linq.IQueryable<RealmBeatmapSet> items)
         //     => base.CheckLocalAvailability(model, items) || (model.OnlineID != null && items.Any(b => b.OnlineID == model.OnlineID));
 
-        private readonly dynamic? onlineLookupQueue = null; // todo: BeatmapOnlineLookupQueue is private
+        private readonly BeatmapOnlineLookupQueue? onlineLookupQueue;
 
-        public BeatmapImporter(RealmContextFactory contextFactory, Storage storage, bool performOnlineLookups = false)
+        public BeatmapImporter(RealmContextFactory contextFactory, Storage storage, BeatmapOnlineLookupQueue? onlineLookupQueue = null)
             : base(storage, contextFactory)
         {
-            if (performOnlineLookups)
-            {
-                // onlineLookupQueue = new BeatmapOnlineLookupQueue(api, storage);
-            }
+            this.onlineLookupQueue = onlineLookupQueue;
         }
 
         protected override bool ShouldDeleteArchive(string path) => Path.GetExtension(path).ToLowerInvariant() == ".osz";
 
-        protected override async Task Populate(RealmBeatmapSet beatmapSet, ArchiveReader? archive, Realm realm, CancellationToken cancellationToken = default)
+        protected override Task Populate(RealmBeatmapSet beatmapSet, ArchiveReader? archive, Realm realm, CancellationToken cancellationToken = default)
         {
             if (archive != null)
                 beatmapSet.Beatmaps.AddRange(createBeatmapDifficulties(beatmapSet.Files, realm));
@@ -75,7 +66,10 @@ namespace osu.Game.Stores
             bool hadOnlineBeatmapIDs = beatmapSet.Beatmaps.Any(b => b.OnlineID > 0);
 
             if (onlineLookupQueue != null)
-                await onlineLookupQueue.UpdateAsync(beatmapSet, cancellationToken).ConfigureAwait(false);
+            {
+                // TODO: this required `BeatmapOnlineLookupQueue` to somehow support new types.
+                // await onlineLookupQueue.UpdateAsync(beatmapSet, cancellationToken).ConfigureAwait(false);
+            }
 
             // ensure at least one beatmap was able to retrieve or keep an online ID, else drop the set ID.
             if (hadOnlineBeatmapIDs && !beatmapSet.Beatmaps.Any(b => b.OnlineID > 0))
@@ -86,13 +80,12 @@ namespace osu.Game.Stores
                     LogForModel(beatmapSet, "Disassociating beatmap set ID due to loss of all beatmap IDs");
                 }
             }
+
+            return Task.CompletedTask;
         }
 
         protected override void PreImport(RealmBeatmapSet beatmapSet, Realm realm)
         {
-            // if (beatmapSet.Beatmaps.Any(b => b.Difficulty == null))
-            //     throw new InvalidOperationException($"Cannot import {nameof(IBeatmapInfo)} with null {nameof(IBeatmapInfo.Difficulty)}.");
-
             // check if a set already exists with the same online id, delete if it does.
             if (beatmapSet.OnlineID != null)
             {

From b2f9f8b8da65273df1d74ac64b7ed71913e67350 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 18 Oct 2021 15:06:09 +0900
Subject: [PATCH 0304/5547] Update logic surrounding removal of previous
 `OnlineID`s when running a new import

---
 osu.Game.Tests/Database/BeatmapImporterTests.cs |  2 +-
 osu.Game/Stores/BeatmapImporter.cs              | 13 ++++++++-----
 2 files changed, 9 insertions(+), 6 deletions(-)

diff --git a/osu.Game.Tests/Database/BeatmapImporterTests.cs b/osu.Game.Tests/Database/BeatmapImporterTests.cs
index beab9b311b..e2a0e5a79f 100644
--- a/osu.Game.Tests/Database/BeatmapImporterTests.cs
+++ b/osu.Game.Tests/Database/BeatmapImporterTests.cs
@@ -772,7 +772,7 @@ namespace osu.Game.Tests.Database
         {
             IQueryable<RealmBeatmapSet>? resultSets = null;
 
-            waitForOrAssert(() => (resultSets = realm.All<RealmBeatmapSet>().Where(s => s.OnlineID == 241526)).Any(),
+            waitForOrAssert(() => (resultSets = realm.All<RealmBeatmapSet>().Where(s => !s.DeletePending && s.OnlineID == 241526)).Any(),
                 @"BeatmapSet did not import to the database in allocated time.", timeout);
 
             // ensure we were stored to beatmap database backing...
diff --git a/osu.Game/Stores/BeatmapImporter.cs b/osu.Game/Stores/BeatmapImporter.cs
index 721f507b3d..5f058872d3 100644
--- a/osu.Game/Stores/BeatmapImporter.cs
+++ b/osu.Game/Stores/BeatmapImporter.cs
@@ -86,21 +86,24 @@ namespace osu.Game.Stores
 
         protected override void PreImport(RealmBeatmapSet beatmapSet, Realm realm)
         {
-            // check if a set already exists with the same online id, delete if it does.
+            // We are about to import a new beatmap. Before doing so, ensure that no other set shares the online IDs used by the new one.
+            // Note that this means if the previous beatmap is restored by the user, it will no longer be linked to its online IDs.
+            // If this is ever an issue, we can consider marking as pending delete but not resetting the IDs (but care will be required for
+            // beatmaps, which don't have their own `DeletePending` state).
+
             if (beatmapSet.OnlineID != null)
             {
-                var existingOnlineId = realm.All<RealmBeatmapSet>().FirstOrDefault(b => b.OnlineID == beatmapSet.OnlineID);
+                var existingOnlineId = realm.All<RealmBeatmapSet>().SingleOrDefault(b => b.OnlineID == beatmapSet.OnlineID);
 
                 if (existingOnlineId != null)
                 {
                     existingOnlineId.DeletePending = true;
-
-                    // in order to avoid a unique key constraint, immediately remove the online ID from the previous set.
                     existingOnlineId.OnlineID = null;
+
                     foreach (var b in existingOnlineId.Beatmaps)
                         b.OnlineID = null;
 
-                    LogForModel(beatmapSet, $"Found existing beatmap set with same OnlineID ({beatmapSet.OnlineID}). It has been deleted.");
+                    LogForModel(beatmapSet, $"Found existing beatmap set with same OnlineID ({beatmapSet.OnlineID}). It will be deleted.");
                 }
             }
         }

From 2c5ba1d8e2d444795c8f1a986a2a039d18d4c8f6 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 18 Oct 2021 15:35:51 +0900
Subject: [PATCH 0305/5547] Change `OnlineID` to non-nullable to allow for
 indexing in Realm

---
 osu.Game/Beatmaps/BeatmapInfo.cs         |  2 +-
 osu.Game/Beatmaps/BeatmapSetInfo.cs      |  2 +-
 osu.Game/Database/IHasOnlineID.cs        |  4 +--
 osu.Game/Database/RealmContextFactory.cs | 34 +++++++++++++++++++++++-
 osu.Game/Models/RealmBeatmap.cs          |  3 ++-
 osu.Game/Models/RealmBeatmapSet.cs       |  5 ++--
 osu.Game/Models/RealmRuleset.cs          |  7 ++---
 osu.Game/Rulesets/RulesetInfo.cs         |  2 +-
 8 files changed, 47 insertions(+), 12 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapInfo.cs b/osu.Game/Beatmaps/BeatmapInfo.cs
index ac5b5d7a8a..3bcc00f5de 100644
--- a/osu.Game/Beatmaps/BeatmapInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapInfo.cs
@@ -178,7 +178,7 @@ namespace osu.Game.Beatmaps
 
         #region Implementation of IHasOnlineID
 
-        public int? OnlineID => OnlineBeatmapID;
+        public int OnlineID => OnlineBeatmapID ?? -1;
 
         #endregion
 
diff --git a/osu.Game/Beatmaps/BeatmapSetInfo.cs b/osu.Game/Beatmaps/BeatmapSetInfo.cs
index 8b01831b3c..e8c77e792f 100644
--- a/osu.Game/Beatmaps/BeatmapSetInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapSetInfo.cs
@@ -91,7 +91,7 @@ namespace osu.Game.Beatmaps
 
         #region Implementation of IHasOnlineID
 
-        public int? OnlineID => OnlineBeatmapSetID;
+        public int OnlineID => OnlineBeatmapSetID ?? -1;
 
         #endregion
 
diff --git a/osu.Game/Database/IHasOnlineID.cs b/osu.Game/Database/IHasOnlineID.cs
index c55c461d2d..529c68a8f8 100644
--- a/osu.Game/Database/IHasOnlineID.cs
+++ b/osu.Game/Database/IHasOnlineID.cs
@@ -8,8 +8,8 @@ namespace osu.Game.Database
     public interface IHasOnlineID
     {
         /// <summary>
-        /// The server-side ID representing this instance, if one exists.
+        /// The server-side ID representing this instance, if one exists. -1 denotes a missing ID.
         /// </summary>
-        int? OnlineID { get; }
+        int OnlineID { get; }
     }
 }
diff --git a/osu.Game/Database/RealmContextFactory.cs b/osu.Game/Database/RealmContextFactory.cs
index 82d51e365e..7403550b1e 100644
--- a/osu.Game/Database/RealmContextFactory.cs
+++ b/osu.Game/Database/RealmContextFactory.cs
@@ -2,12 +2,14 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
+using System.Linq;
 using System.Threading;
 using osu.Framework.Allocation;
 using osu.Framework.Development;
 using osu.Framework.Logging;
 using osu.Framework.Platform;
 using osu.Framework.Statistics;
+using osu.Game.Models;
 using Realms;
 
 #nullable enable
@@ -26,7 +28,12 @@ namespace osu.Game.Database
         /// </summary>
         public readonly string Filename;
 
-        private const int schema_version = 6;
+        /// <summary>
+        /// Version history:
+        /// 6  First tracked version (~20211018)
+        /// 7  Changed OnlineID fields to non-nullable to add indexing support (20211018)
+        /// </summary>
+        private const int schema_version = 7;
 
         /// <summary>
         /// Lock object which is held during <see cref="BlockAllOperations"/> sections, blocking context creation during blocking periods.
@@ -120,6 +127,31 @@ namespace osu.Game.Database
 
         private void onMigration(Migration migration, ulong lastSchemaVersion)
         {
+            if (lastSchemaVersion < 7)
+            {
+                convertOnlineIDs<RealmBeatmap>();
+                convertOnlineIDs<RealmBeatmapSet>();
+                convertOnlineIDs<RealmRuleset>();
+
+                void convertOnlineIDs<T>() where T : RealmObject
+                {
+                    var className = typeof(T).Name.Replace(@"Realm", string.Empty);
+
+                    var oldItems = migration.OldRealm.DynamicApi.All(className);
+                    var newItems = migration.NewRealm.DynamicApi.All(className);
+
+                    int itemCount = newItems.Count();
+
+                    for (int i = 0; i < itemCount; i++)
+                    {
+                        var oldItem = oldItems.ElementAt(i);
+                        var newItem = newItems.ElementAt(i);
+
+                        long? nullableOnlineID = oldItem.OnlineID;
+                        newItem.OnlineID = (int)(nullableOnlineID ?? -1);
+                    }
+                }
+            }
         }
 
         /// <summary>
diff --git a/osu.Game/Models/RealmBeatmap.cs b/osu.Game/Models/RealmBeatmap.cs
index 5049c1384d..9311425cb7 100644
--- a/osu.Game/Models/RealmBeatmap.cs
+++ b/osu.Game/Models/RealmBeatmap.cs
@@ -44,7 +44,8 @@ namespace osu.Game.Models
         [MapTo(nameof(Status))]
         public int StatusInt { get; set; }
 
-        public int? OnlineID { get; set; }
+        [Indexed]
+        public int OnlineID { get; set; } = -1;
 
         public double Length { get; set; }
 
diff --git a/osu.Game/Models/RealmBeatmapSet.cs b/osu.Game/Models/RealmBeatmapSet.cs
index 314ca4494b..d6e56fd61c 100644
--- a/osu.Game/Models/RealmBeatmapSet.cs
+++ b/osu.Game/Models/RealmBeatmapSet.cs
@@ -20,7 +20,8 @@ namespace osu.Game.Models
         [PrimaryKey]
         public Guid ID { get; set; } = Guid.NewGuid();
 
-        public int? OnlineID { get; set; }
+        [Indexed]
+        public int OnlineID { get; set; } = -1;
 
         public DateTimeOffset DateAdded { get; set; }
 
@@ -62,7 +63,7 @@ namespace osu.Game.Models
             if (IsManaged && other.IsManaged)
                 return ID == other.ID;
 
-            if (OnlineID.HasValue && other.OnlineID.HasValue)
+            if (OnlineID >= 0 && other.OnlineID >= 0)
                 return OnlineID == other.OnlineID;
 
             if (!string.IsNullOrEmpty(Hash) && !string.IsNullOrEmpty(other.Hash))
diff --git a/osu.Game/Models/RealmRuleset.cs b/osu.Game/Models/RealmRuleset.cs
index 0dcd701ed2..5d70324713 100644
--- a/osu.Game/Models/RealmRuleset.cs
+++ b/osu.Game/Models/RealmRuleset.cs
@@ -18,7 +18,8 @@ namespace osu.Game.Models
         [PrimaryKey]
         public string ShortName { get; set; } = string.Empty;
 
-        public int? OnlineID { get; set; }
+        [Indexed]
+        public int OnlineID { get; set; } = -1;
 
         public string Name { get; set; } = string.Empty;
 
@@ -29,7 +30,7 @@ namespace osu.Game.Models
             ShortName = shortName;
             Name = name;
             InstantiationInfo = instantiationInfo;
-            OnlineID = onlineID;
+            OnlineID = onlineID ?? -1;
         }
 
         [UsedImplicitly]
@@ -39,7 +40,7 @@ namespace osu.Game.Models
 
         public RealmRuleset(int? onlineID, string name, string shortName, bool available)
         {
-            OnlineID = onlineID;
+            OnlineID = onlineID ?? -1;
             Name = name;
             ShortName = shortName;
             Available = available;
diff --git a/osu.Game/Rulesets/RulesetInfo.cs b/osu.Game/Rulesets/RulesetInfo.cs
index ca6a083a58..8cd3fa8c63 100644
--- a/osu.Game/Rulesets/RulesetInfo.cs
+++ b/osu.Game/Rulesets/RulesetInfo.cs
@@ -57,7 +57,7 @@ namespace osu.Game.Rulesets
 
         #region Implementation of IHasOnlineID
 
-        public int? OnlineID => ID;
+        public int OnlineID => ID ?? -1;
 
         #endregion
     }

From 88a575462cc73e74055450d2a59450bcb653ca3a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 18 Oct 2021 16:11:55 +0900
Subject: [PATCH 0306/5547] Work around weird null inspection

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

diff --git a/osu.Game/Database/RealmContextFactory.cs b/osu.Game/Database/RealmContextFactory.cs
index 7403550b1e..078709ad2d 100644
--- a/osu.Game/Database/RealmContextFactory.cs
+++ b/osu.Game/Database/RealmContextFactory.cs
@@ -147,7 +147,7 @@ namespace osu.Game.Database
                         var oldItem = oldItems.ElementAt(i);
                         var newItem = newItems.ElementAt(i);
 
-                        long? nullableOnlineID = oldItem.OnlineID;
+                        long? nullableOnlineID = oldItem?.OnlineID;
                         newItem.OnlineID = (int)(nullableOnlineID ?? -1);
                     }
                 }

From b3219bb592168188bbe357ab943729714812aaad Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 18 Oct 2021 16:10:37 +0900
Subject: [PATCH 0307/5547] Update usages of `OnlineID`

---
 .../Database/BeatmapImporterTests.cs          |  6 ++---
 osu.Game/Beatmaps/BeatmapManager.cs           |  2 +-
 osu.Game/Scoring/ScoreManager.cs              |  2 +-
 osu.Game/Stores/BeatmapImporter.cs            | 22 +++++++++----------
 4 files changed, 16 insertions(+), 16 deletions(-)

diff --git a/osu.Game.Tests/Database/BeatmapImporterTests.cs b/osu.Game.Tests/Database/BeatmapImporterTests.cs
index e2a0e5a79f..4cdcf507b6 100644
--- a/osu.Game.Tests/Database/BeatmapImporterTests.cs
+++ b/osu.Game.Tests/Database/BeatmapImporterTests.cs
@@ -458,7 +458,7 @@ namespace osu.Game.Tests.Database
                 realmFactory.Context.Write(() =>
                 {
                     foreach (var b in imported.Beatmaps)
-                        b.OnlineID = null;
+                        b.OnlineID = -1;
                 });
 
                 deleteBeatmapSet(imported, realmFactory.Context);
@@ -509,8 +509,8 @@ namespace osu.Game.Tests.Database
                 Assert.NotNull(imported);
                 Debug.Assert(imported != null);
 
-                Assert.AreEqual(null, imported.PerformRead(s => s.Beatmaps[0].OnlineID));
-                Assert.AreEqual(null, imported.PerformRead(s => s.Beatmaps[1].OnlineID));
+                Assert.AreEqual(-1, imported.PerformRead(s => s.Beatmaps[0].OnlineID));
+                Assert.AreEqual(-1, imported.PerformRead(s => s.Beatmaps[1].OnlineID));
             });
         }
 
diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index 562cbfabf0..0509a9db47 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -29,7 +29,7 @@ namespace osu.Game.Beatmaps
     /// Handles general operations related to global beatmap management.
     /// </summary>
     [ExcludeFromDynamicCompile]
-    public class BeatmapManager : IModelDownloader<BeatmapSetInfo>, IModelManager<BeatmapSetInfo>, IModelFileManager<BeatmapSetInfo, BeatmapSetFileInfo>, ICanAcceptFiles, IWorkingBeatmapCache, IDisposable
+    public class BeatmapManager : IModelDownloader<BeatmapSetInfo>, IModelManager<BeatmapSetInfo>, IModelFileManager<BeatmapSetInfo, BeatmapSetFileInfo>, IWorkingBeatmapCache, IDisposable
     {
         private readonly BeatmapModelManager beatmapModelManager;
         private readonly BeatmapModelDownloader beatmapModelDownloader;
diff --git a/osu.Game/Scoring/ScoreManager.cs b/osu.Game/Scoring/ScoreManager.cs
index 8494cdcd22..a9791fba7e 100644
--- a/osu.Game/Scoring/ScoreManager.cs
+++ b/osu.Game/Scoring/ScoreManager.cs
@@ -25,7 +25,7 @@ using osu.Game.Rulesets.Scoring;
 
 namespace osu.Game.Scoring
 {
-    public class ScoreManager : IModelManager<ScoreInfo>, IModelFileManager<ScoreInfo, ScoreFileInfo>, IModelDownloader<ScoreInfo>, ICanAcceptFiles
+    public class ScoreManager : IModelManager<ScoreInfo>, IModelFileManager<ScoreInfo, ScoreFileInfo>, IModelDownloader<ScoreInfo>
     {
         private readonly Scheduler scheduler;
         private readonly Func<BeatmapDifficultyCache> difficulties;
diff --git a/osu.Game/Stores/BeatmapImporter.cs b/osu.Game/Stores/BeatmapImporter.cs
index 5f058872d3..4ff09e6cc5 100644
--- a/osu.Game/Stores/BeatmapImporter.cs
+++ b/osu.Game/Stores/BeatmapImporter.cs
@@ -41,7 +41,7 @@ namespace osu.Game.Stores
         protected override string[] HashableFileTypes => new[] { ".osu" };
 
         // protected override bool CheckLocalAvailability(RealmBeatmapSet model, System.Linq.IQueryable<RealmBeatmapSet> items)
-        //     => base.CheckLocalAvailability(model, items) || (model.OnlineID != null && items.Any(b => b.OnlineID == model.OnlineID));
+        //     => base.CheckLocalAvailability(model, items) || (model.OnlineID > -1));
 
         private readonly BeatmapOnlineLookupQueue? onlineLookupQueue;
 
@@ -74,9 +74,9 @@ namespace osu.Game.Stores
             // ensure at least one beatmap was able to retrieve or keep an online ID, else drop the set ID.
             if (hadOnlineBeatmapIDs && !beatmapSet.Beatmaps.Any(b => b.OnlineID > 0))
             {
-                if (beatmapSet.OnlineID != null)
+                if (beatmapSet.OnlineID > -1)
                 {
-                    beatmapSet.OnlineID = null;
+                    beatmapSet.OnlineID = -1;
                     LogForModel(beatmapSet, "Disassociating beatmap set ID due to loss of all beatmap IDs");
                 }
             }
@@ -91,17 +91,17 @@ namespace osu.Game.Stores
             // If this is ever an issue, we can consider marking as pending delete but not resetting the IDs (but care will be required for
             // beatmaps, which don't have their own `DeletePending` state).
 
-            if (beatmapSet.OnlineID != null)
+            if (beatmapSet.OnlineID > -1)
             {
                 var existingOnlineId = realm.All<RealmBeatmapSet>().SingleOrDefault(b => b.OnlineID == beatmapSet.OnlineID);
 
                 if (existingOnlineId != null)
                 {
                     existingOnlineId.DeletePending = true;
-                    existingOnlineId.OnlineID = null;
+                    existingOnlineId.OnlineID = -1;
 
                     foreach (var b in existingOnlineId.Beatmaps)
-                        b.OnlineID = null;
+                        b.OnlineID = -1;
 
                     LogForModel(beatmapSet, $"Found existing beatmap set with same OnlineID ({beatmapSet.OnlineID}). It will be deleted.");
                 }
@@ -110,7 +110,7 @@ namespace osu.Game.Stores
 
         private void validateOnlineIds(RealmBeatmapSet beatmapSet, Realm realm)
         {
-            var beatmapIds = beatmapSet.Beatmaps.Where(b => b.OnlineID.HasValue).Select(b => b.OnlineID).ToList();
+            var beatmapIds = beatmapSet.Beatmaps.Where(b => b.OnlineID > -1).Select(b => b.OnlineID).ToList();
 
             // ensure all IDs are unique
             if (beatmapIds.GroupBy(b => b).Any(g => g.Count() > 1))
@@ -140,7 +140,7 @@ namespace osu.Game.Stores
                 }
             }
 
-            void resetIds() => beatmapSet.Beatmaps.ForEach(b => b.OnlineID = null);
+            void resetIds() => beatmapSet.Beatmaps.ForEach(b => b.OnlineID = -1);
         }
 
         protected override bool CanSkipImport(RealmBeatmapSet existing, RealmBeatmapSet import)
@@ -148,7 +148,7 @@ namespace osu.Game.Stores
             if (!base.CanSkipImport(existing, import))
                 return false;
 
-            return existing.Beatmaps.Any(b => b.OnlineID != null);
+            return existing.Beatmaps.Any(b => b.OnlineID > -1);
         }
 
         protected override bool CanReuseExisting(RealmBeatmapSet existing, RealmBeatmapSet import)
@@ -182,7 +182,7 @@ namespace osu.Game.Stores
 
             return new RealmBeatmapSet
             {
-                OnlineID = beatmap.BeatmapInfo.BeatmapSet?.OnlineBeatmapSetID,
+                OnlineID = beatmap.BeatmapInfo.BeatmapSet?.OnlineBeatmapSetID ?? -1,
                 // Metadata = beatmap.Metadata,
                 DateAdded = DateTimeOffset.UtcNow
             };
@@ -250,7 +250,7 @@ namespace osu.Game.Stores
                     {
                         Hash = hash,
                         DifficultyName = decodedInfo.Version,
-                        OnlineID = decodedInfo.OnlineBeatmapID,
+                        OnlineID = decodedInfo.OnlineBeatmapID ?? -1,
                         AudioLeadIn = decodedInfo.AudioLeadIn,
                         StackLeniency = decodedInfo.StackLeniency,
                         SpecialStyle = decodedInfo.SpecialStyle,

From 830f49bca693c1d6c774dd4237cdba58bb337081 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 18 Oct 2021 19:43:48 +0200
Subject: [PATCH 0308/5547] Remove doubled-up opacity specification

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

diff --git a/osu.Game/Overlays/RestoreDefaultValueButton.cs b/osu.Game/Overlays/RestoreDefaultValueButton.cs
index de600e8172..afc4146199 100644
--- a/osu.Game/Overlays/RestoreDefaultValueButton.cs
+++ b/osu.Game/Overlays/RestoreDefaultValueButton.cs
@@ -115,7 +115,7 @@ namespace osu.Game.Overlays
                 Background.FadeColour(colours.Lime3, fade_duration, Easing.OutQuint);
                 Content.TweenEdgeEffectTo(new EdgeEffectParameters
                 {
-                    Colour = colours.Lime3.Opacity(0.4f).Opacity(0.1f),
+                    Colour = colours.Lime3.Opacity(0.1f),
                     Radius = 2,
                     Type = EdgeEffectType.Glow
                 }, fade_duration, Easing.OutQuint);

From 6c3637a62a993d4cbcfe41eee99cd28f89c99929 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 18 Oct 2021 20:36:47 +0200
Subject: [PATCH 0309/5547] Remove grid usage in `KeyBindingRow`

---
 .../Settings/Sections/Input/KeyBindingRow.cs  | 47 +++++++++----------
 1 file changed, 22 insertions(+), 25 deletions(-)

diff --git a/osu.Game/Overlays/Settings/Sections/Input/KeyBindingRow.cs b/osu.Game/Overlays/Settings/Sections/Input/KeyBindingRow.cs
index c2667fbdac..f44f02d0ed 100644
--- a/osu.Game/Overlays/Settings/Sections/Input/KeyBindingRow.cs
+++ b/osu.Game/Overlays/Settings/Sections/Input/KeyBindingRow.cs
@@ -82,32 +82,29 @@ namespace osu.Game.Overlays.Settings.Sections.Input
         {
             RelativeSizeAxes = Axes.X;
             AutoSizeAxes = Axes.Y;
+            Padding = new MarginPadding { Right = SettingsPanel.CONTENT_MARGINS };
 
-            InternalChild = new GridContainer
+            InternalChildren = new Drawable[]
             {
-                RelativeSizeAxes = Axes.X,
-                AutoSizeAxes = Axes.Y,
-                ColumnDimensions = new[]
+                new Container
                 {
-                    new Dimension(GridSizeMode.Absolute, SettingsPanel.CONTENT_MARGINS),
-                    new Dimension(),
-                    new Dimension(GridSizeMode.Absolute, SettingsPanel.CONTENT_MARGINS),
-                },
-                RowDimensions = new[]
-                {
-                    new Dimension(GridSizeMode.AutoSize)
-                },
-                Content = new[]
-                {
-                    new Drawable[]
+                    RelativeSizeAxes = Axes.Y,
+                    Width = SettingsPanel.CONTENT_MARGINS,
+                    Child = new RestoreDefaultValueButton<bool>
+                    {
+                        Current = isDefault,
+                        Action = RestoreDefaults,
+                        Anchor = Anchor.Centre,
+                        Origin = Anchor.Centre,
+                    }
+                },
+                new Container
+                {
+                    RelativeSizeAxes = Axes.X,
+                    AutoSizeAxes = Axes.Y,
+                    Padding = new MarginPadding { Left = SettingsPanel.CONTENT_MARGINS },
+                    Children = new Drawable[]
                     {
-                        new RestoreDefaultValueButton<bool>
-                        {
-                            Current = isDefault,
-                            Action = RestoreDefaults,
-                            Anchor = Anchor.Centre,
-                            Origin = Anchor.Centre
-                        },
                         content = new Container
                         {
                             RelativeSizeAxes = Axes.X,
@@ -154,10 +151,10 @@ namespace osu.Game.Overlays.Settings.Sections.Input
                                     },
                                 }
                             }
-                        },
-                        new HoverClickSounds()
+                        }
                     }
-                }
+                },
+                new HoverClickSounds()
             };
 
             foreach (var b in bindings)

From 88a1b31fae9538a0e38ffc3aef9e9167e90a3120 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 18 Oct 2021 21:01:43 +0200
Subject: [PATCH 0310/5547] Remove grid usage in `SettingsItem`

---
 .../Visual/Settings/TestSceneSettingsItem.cs  | 21 +++++---
 osu.Game/Overlays/Settings/SettingsItem.cs    | 54 ++++++-------------
 osu.Game/Overlays/Settings/SettingsTextBox.cs |  1 -
 3 files changed, 32 insertions(+), 44 deletions(-)

diff --git a/osu.Game.Tests/Visual/Settings/TestSceneSettingsItem.cs b/osu.Game.Tests/Visual/Settings/TestSceneSettingsItem.cs
index 9c3940af4c..83265e13ad 100644
--- a/osu.Game.Tests/Visual/Settings/TestSceneSettingsItem.cs
+++ b/osu.Game.Tests/Visual/Settings/TestSceneSettingsItem.cs
@@ -4,8 +4,10 @@
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Bindables;
-using osu.Framework.Graphics.Containers;
 using osu.Framework.Testing;
+using osu.Framework.Utils;
+using osu.Game.Graphics.Sprites;
+using osu.Game.Graphics.UserInterface;
 using osu.Game.Overlays.Settings;
 using osu.Game.Overlays;
 
@@ -47,8 +49,8 @@ namespace osu.Game.Tests.Visual.Settings
         public void TestSetAndClearLabelText()
         {
             SettingsTextBox textBox = null;
-            GridContainer settingsItemGrid = null;
             RestoreDefaultValueButton<string> restoreDefaultValueButton = null;
+            OsuTextBox control = null;
 
             AddStep("create settings item", () =>
             {
@@ -64,18 +66,25 @@ namespace osu.Game.Tests.Visual.Settings
             AddUntilStep("wait for loaded", () => textBox.IsLoaded);
             AddStep("retrieve components", () =>
             {
-                settingsItemGrid = textBox.ChildrenOfType<GridContainer>().Single();
                 restoreDefaultValueButton = textBox.ChildrenOfType<RestoreDefaultValueButton<string>>().Single();
+                control = textBox.ChildrenOfType<OsuTextBox>().Single();
             });
 
             AddStep("set non-default value", () => restoreDefaultValueButton.Current.Value = "non-default");
-            AddAssert("default value button next to control", () => settingsItemGrid.Content[1][0] == restoreDefaultValueButton);
+            AddAssert("default value button centre aligned to control size", () => Precision.AlmostEquals(restoreDefaultValueButton.Parent.DrawHeight, control.DrawHeight, 1));
 
             AddStep("set label", () => textBox.LabelText = "label text");
-            AddAssert("default value button next to label", () => settingsItemGrid.Content[0][0] == restoreDefaultValueButton);
+            AddAssert("default value button centre aligned to label size", () =>
+            {
+                var label = textBox.ChildrenOfType<OsuSpriteText>().Single(spriteText => spriteText.Text == "label text");
+                return Precision.AlmostEquals(restoreDefaultValueButton.Parent.DrawHeight, label.DrawHeight, 1);
+            });
 
             AddStep("clear label", () => textBox.LabelText = default);
-            AddAssert("default value button next to control", () => settingsItemGrid.Content[1][0] == restoreDefaultValueButton);
+            AddAssert("default value button centre aligned to control size", () => Precision.AlmostEquals(restoreDefaultValueButton.Parent.DrawHeight, control.DrawHeight, 1));
+
+            AddStep("set warning text", () => textBox.WarningText = "This is some very important warning text! Hopefully it doesn't break the alignment of the default value indicator...");
+            AddAssert("default value button centre aligned to control size", () => Precision.AlmostEquals(restoreDefaultValueButton.Parent.DrawHeight, control.DrawHeight, 1));
         }
 
         /// <summary>
diff --git a/osu.Game/Overlays/Settings/SettingsItem.cs b/osu.Game/Overlays/Settings/SettingsItem.cs
index 7895f6386b..91998f07d8 100644
--- a/osu.Game/Overlays/Settings/SettingsItem.cs
+++ b/osu.Game/Overlays/Settings/SettingsItem.cs
@@ -3,7 +3,6 @@
 
 using System;
 using System.Collections.Generic;
-using JetBrains.Annotations;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
@@ -32,14 +31,11 @@ namespace osu.Game.Overlays.Settings
         protected readonly FillFlowContainer FlowContent;
 
         private SpriteText labelText;
-        private readonly GridContainer gridContainer;
-
-        [CanBeNull]
-        private RestoreDefaultValueButton<T> defaultValueButton;
 
         private OsuTextFlowContainer warningText;
 
         public bool ShowsDefaultIndicator = true;
+        private readonly Container defaultValueIndicatorContainer;
 
         public LocalisableString TooltipText { get; set; }
 
@@ -54,7 +50,7 @@ namespace osu.Game.Overlays.Settings
                 if (labelText == null)
                 {
                     // construct lazily for cases where the label is not needed (may be provided by the Control).
-                    gridContainer.Content[0][1] = labelText = new OsuSpriteText();
+                    FlowContent.Insert(-1, labelText = new OsuSpriteText());
 
                     updateDisabled();
                 }
@@ -113,32 +109,19 @@ namespace osu.Game.Overlays.Settings
             AutoSizeAxes = Axes.Y;
             Padding = new MarginPadding { Right = SettingsPanel.CONTENT_MARGINS };
 
-            FlowContent = new FillFlowContainer
+            InternalChildren = new Drawable[]
             {
-                RelativeSizeAxes = Axes.X,
-                AutoSizeAxes = Axes.Y,
-                Spacing = new Vector2(0, 10),
-                Child = Control = CreateControl(),
-            };
-
-            InternalChild = gridContainer = new GridContainer
-            {
-                RelativeSizeAxes = Axes.X,
-                AutoSizeAxes = Axes.Y,
-                RowDimensions = new[]
+                defaultValueIndicatorContainer = new Container
                 {
-                    new Dimension(GridSizeMode.AutoSize),
-                    new Dimension(GridSizeMode.AutoSize)
+                    Width = SettingsPanel.CONTENT_MARGINS,
                 },
-                ColumnDimensions = new[]
+                FlowContent = new FillFlowContainer
                 {
-                    new Dimension(GridSizeMode.Absolute, SettingsPanel.CONTENT_MARGINS),
-                    new Dimension()
-                },
-                Content = new[]
-                {
-                    new Drawable[2],
-                    new Drawable[] { null, FlowContent }
+                    RelativeSizeAxes = Axes.X,
+                    AutoSizeAxes = Axes.Y,
+                    Padding = new MarginPadding { Left = SettingsPanel.CONTENT_MARGINS },
+                    Spacing = new Vector2(0, 10),
+                    Child = Control = CreateControl(),
                 }
             };
 
@@ -157,26 +140,23 @@ namespace osu.Game.Overlays.Settings
             // intentionally done before LoadComplete to avoid overhead.
             if (ShowsDefaultIndicator)
             {
-                defaultValueButton = new RestoreDefaultValueButton<T>
+                defaultValueIndicatorContainer.Add(new RestoreDefaultValueButton<T>
                 {
                     Current = controlWithCurrent.Current,
                     Anchor = Anchor.Centre,
                     Origin = Anchor.Centre
-                };
+                });
                 updateLayout();
             }
         }
 
         private void updateLayout()
         {
-            bool hasLabel = !string.IsNullOrEmpty(labelText?.Text.ToString());
+            bool hasLabel = labelText != null && !string.IsNullOrEmpty(labelText.Text.ToString());
 
-            gridContainer.Content[0][0] = null;
-            gridContainer.Content[1][0] = null;
-
-            gridContainer.Content[hasLabel ? 0 : 1][0] = defaultValueButton;
-
-            FlowContent.Margin = new MarginPadding { Top = hasLabel ? 10 : 0 };
+            // if the settings item is providing a label, the default value indicator should be centred vertically to the left of the label.
+            // otherwise, it should be centred vertically to the left of the main control of the settings item.
+            defaultValueIndicatorContainer.Height = hasLabel ? labelText.DrawHeight : Control.DrawHeight;
         }
 
         private void updateDisabled()
diff --git a/osu.Game/Overlays/Settings/SettingsTextBox.cs b/osu.Game/Overlays/Settings/SettingsTextBox.cs
index 68562802cf..a724003183 100644
--- a/osu.Game/Overlays/Settings/SettingsTextBox.cs
+++ b/osu.Game/Overlays/Settings/SettingsTextBox.cs
@@ -11,7 +11,6 @@ namespace osu.Game.Overlays.Settings
     {
         protected override Drawable CreateControl() => new OutlinedTextBox
         {
-            Margin = new MarginPadding { Top = 5 },
             RelativeSizeAxes = Axes.X,
             CommitOnFocusLost = true
         };

From 6d9d85685f73cadaf2619c43af3ff33da6e0a2cd Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 18 Oct 2021 23:30:38 +0200
Subject: [PATCH 0311/5547] Fix settings item having zero height

---
 osu.Game/Overlays/Settings/SettingsItem.cs            | 11 ++++++++---
 .../Screens/Play/PlayerSettings/PlayerSliderBar.cs    |  1 -
 2 files changed, 8 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Overlays/Settings/SettingsItem.cs b/osu.Game/Overlays/Settings/SettingsItem.cs
index 91998f07d8..b593dea576 100644
--- a/osu.Game/Overlays/Settings/SettingsItem.cs
+++ b/osu.Game/Overlays/Settings/SettingsItem.cs
@@ -115,13 +115,18 @@ namespace osu.Game.Overlays.Settings
                 {
                     Width = SettingsPanel.CONTENT_MARGINS,
                 },
-                FlowContent = new FillFlowContainer
+                new Container
                 {
                     RelativeSizeAxes = Axes.X,
                     AutoSizeAxes = Axes.Y,
                     Padding = new MarginPadding { Left = SettingsPanel.CONTENT_MARGINS },
-                    Spacing = new Vector2(0, 10),
-                    Child = Control = CreateControl(),
+                    Child = FlowContent = new FillFlowContainer
+                    {
+                        RelativeSizeAxes = Axes.X,
+                        AutoSizeAxes = Axes.Y,
+                        Spacing = new Vector2(0, 10),
+                        Child = Control = CreateControl(),
+                    }
                 }
             };
 
diff --git a/osu.Game/Screens/Play/PlayerSettings/PlayerSliderBar.cs b/osu.Game/Screens/Play/PlayerSettings/PlayerSliderBar.cs
index 216e46d429..9903a74043 100644
--- a/osu.Game/Screens/Play/PlayerSettings/PlayerSliderBar.cs
+++ b/osu.Game/Screens/Play/PlayerSettings/PlayerSliderBar.cs
@@ -17,7 +17,6 @@ namespace osu.Game.Screens.Play.PlayerSettings
 
         protected override Drawable CreateControl() => new Sliderbar
         {
-            Margin = new MarginPadding { Top = 5, Bottom = 5 },
             RelativeSizeAxes = Axes.X
         };
 

From 8db2fc439d53823fdb0bc67760aaaaa236574e5f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 18 Oct 2021 23:45:06 +0200
Subject: [PATCH 0312/5547] Change ruleset ID assert in player to null-check

---
 osu.Game/Screens/Play/Player.cs | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Screens/Play/Player.cs b/osu.Game/Screens/Play/Player.cs
index c8b946b7f1..1381493fdf 100644
--- a/osu.Game/Screens/Play/Player.cs
+++ b/osu.Game/Screens/Play/Player.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.Linq;
 using System.Threading.Tasks;
@@ -218,12 +217,11 @@ namespace osu.Game.Screens.Play
 
             Score = CreateScore(playableBeatmap);
 
-            Debug.Assert(ruleset.RulesetInfo.ID != null);
-
             // ensure the score is in a consistent state with the current player.
             Score.ScoreInfo.BeatmapInfo = Beatmap.Value.BeatmapInfo;
             Score.ScoreInfo.Ruleset = ruleset.RulesetInfo;
-            Score.ScoreInfo.RulesetID = ruleset.RulesetInfo.ID.Value;
+            if (ruleset.RulesetInfo.ID != null)
+                Score.ScoreInfo.RulesetID = ruleset.RulesetInfo.ID.Value;
             Score.ScoreInfo.Mods = gameplayMods;
 
             dependencies.CacheAs(GameplayState = new GameplayState(playableBeatmap, ruleset, gameplayMods, Score));

From 95ed9a431ce5b138727dac484674ec9ae6d05f6b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 19 Oct 2021 00:06:07 +0200
Subject: [PATCH 0313/5547] Add test coverage for no submission for ruleset
 with null ID

---
 .../Visual/Gameplay/TestScenePlayerScoreSubmission.cs      | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestScenePlayerScoreSubmission.cs b/osu.Game.Tests/Visual/Gameplay/TestScenePlayerScoreSubmission.cs
index d7edb33c42..bf864f844c 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestScenePlayerScoreSubmission.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestScenePlayerScoreSubmission.cs
@@ -227,12 +227,13 @@ namespace osu.Game.Tests.Visual.Gameplay
             AddAssert("ensure no submission", () => Player.SubmittedScore == null);
         }
 
-        [Test]
-        public void TestNoSubmissionOnCustomRuleset()
+        [TestCase(null)]
+        [TestCase(10)]
+        public void TestNoSubmissionOnCustomRuleset(int? rulesetId)
         {
             prepareTokenResponse(true);
 
-            createPlayerTest(false, createRuleset: () => new OsuRuleset { RulesetInfo = { ID = 10 } });
+            createPlayerTest(false, createRuleset: () => new OsuRuleset { RulesetInfo = { ID = rulesetId } });
 
             AddUntilStep("wait for token request", () => Player.TokenCreationRequested);
 

From ff2eae45974d39ce26e75617bd976e224aa719f1 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 19 Oct 2021 11:37:46 +0900
Subject: [PATCH 0314/5547] Rename confusing variable

---
 osu.Game/Beatmaps/BeatmapModelManager.cs | 10 +++++-----
 osu.Game/Stores/BeatmapImporter.cs       | 10 +++++-----
 2 files changed, 10 insertions(+), 10 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapModelManager.cs b/osu.Game/Beatmaps/BeatmapModelManager.cs
index 76019a15ae..16cf6193f9 100644
--- a/osu.Game/Beatmaps/BeatmapModelManager.cs
+++ b/osu.Game/Beatmaps/BeatmapModelManager.cs
@@ -123,15 +123,15 @@ namespace osu.Game.Beatmaps
             // check if a set already exists with the same online id, delete if it does.
             if (beatmapSet.OnlineBeatmapSetID != null)
             {
-                var existingOnlineId = beatmaps.ConsumableItems.FirstOrDefault(b => b.OnlineBeatmapSetID == beatmapSet.OnlineBeatmapSetID);
+                var existingSetWithSameOnlineID = beatmaps.ConsumableItems.FirstOrDefault(b => b.OnlineBeatmapSetID == beatmapSet.OnlineBeatmapSetID);
 
-                if (existingOnlineId != null)
+                if (existingSetWithSameOnlineID != null)
                 {
-                    Delete(existingOnlineId);
+                    Delete(existingSetWithSameOnlineID);
 
                     // in order to avoid a unique key constraint, immediately remove the online ID from the previous set.
-                    existingOnlineId.OnlineBeatmapSetID = null;
-                    foreach (var b in existingOnlineId.Beatmaps)
+                    existingSetWithSameOnlineID.OnlineBeatmapSetID = null;
+                    foreach (var b in existingSetWithSameOnlineID.Beatmaps)
                         b.OnlineBeatmapID = null;
 
                     LogForModel(beatmapSet, $"Found existing beatmap set with same OnlineBeatmapSetID ({beatmapSet.OnlineBeatmapSetID}). It has been deleted.");
diff --git a/osu.Game/Stores/BeatmapImporter.cs b/osu.Game/Stores/BeatmapImporter.cs
index 4ff09e6cc5..dc43fda09a 100644
--- a/osu.Game/Stores/BeatmapImporter.cs
+++ b/osu.Game/Stores/BeatmapImporter.cs
@@ -93,14 +93,14 @@ namespace osu.Game.Stores
 
             if (beatmapSet.OnlineID > -1)
             {
-                var existingOnlineId = realm.All<RealmBeatmapSet>().SingleOrDefault(b => b.OnlineID == beatmapSet.OnlineID);
+                var existingSetWithSameOnlineID = realm.All<RealmBeatmapSet>().SingleOrDefault(b => b.OnlineID == beatmapSet.OnlineID);
 
-                if (existingOnlineId != null)
+                if (existingSetWithSameOnlineID != null)
                 {
-                    existingOnlineId.DeletePending = true;
-                    existingOnlineId.OnlineID = -1;
+                    existingSetWithSameOnlineID.DeletePending = true;
+                    existingSetWithSameOnlineID.OnlineID = -1;
 
-                    foreach (var b in existingOnlineId.Beatmaps)
+                    foreach (var b in existingSetWithSameOnlineID.Beatmaps)
                         b.OnlineID = -1;
 
                     LogForModel(beatmapSet, $"Found existing beatmap set with same OnlineID ({beatmapSet.OnlineID}). It will be deleted.");

From e7b280fc81899fa60d9f0fc7ef169beb1db5d0d7 Mon Sep 17 00:00:00 2001
From: sh0ckR6 <sh0ck.04@outlook.com>
Date: Mon, 18 Oct 2021 23:12:33 -0400
Subject: [PATCH 0315/5547] Comment out RankDisplay

Commented out as it may be revisited at a later time.
Also currently unused.
---
 osu.Game/Screens/Play/Break/BreakInfo.cs | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/Play/Break/BreakInfo.cs b/osu.Game/Screens/Play/Break/BreakInfo.cs
index 6e129b20ea..6349ebd9a7 100644
--- a/osu.Game/Screens/Play/Break/BreakInfo.cs
+++ b/osu.Game/Screens/Play/Break/BreakInfo.cs
@@ -13,7 +13,9 @@ namespace osu.Game.Screens.Play.Break
     public class BreakInfo : Container
     {
         public PercentageBreakInfoLine AccuracyDisplay;
-        public BreakInfoLine<int> RankDisplay;
+
+        // Currently unused but may be revisited in a future design update (see https://github.com/ppy/osu/discussions/15185)
+        // public BreakInfoLine<int> RankDisplay;
         public BreakInfoLine<ScoreRank> GradeDisplay;
 
         public BreakInfo()
@@ -41,7 +43,9 @@ namespace osu.Game.Screens.Play.Break
                         Children = new Drawable[]
                         {
                             AccuracyDisplay = new PercentageBreakInfoLine("Accuracy"),
-                            RankDisplay = new BreakInfoLine<int>("Rank"),
+
+                            // See https://github.com/ppy/osu/discussions/15185
+                            // RankDisplay = new BreakInfoLine<int>("Rank"),
                             GradeDisplay = new BreakInfoLine<ScoreRank>("Grade"),
                         },
                     }

From d3ab45084d52566d5a06e1d57c4864e028105ed1 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 19 Oct 2021 14:19:58 +0900
Subject: [PATCH 0316/5547] Fix realm migration potentially failing from older
 releases

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

diff --git a/osu.Game/Database/RealmContextFactory.cs b/osu.Game/Database/RealmContextFactory.cs
index 078709ad2d..b5c44927ca 100644
--- a/osu.Game/Database/RealmContextFactory.cs
+++ b/osu.Game/Database/RealmContextFactory.cs
@@ -137,6 +137,11 @@ namespace osu.Game.Database
                 {
                     var className = typeof(T).Name.Replace(@"Realm", string.Empty);
 
+                    // version was not bumped when the beatmap/ruleset models were added
+                    // therefore we must manually check for their presence to avoid throwing on the `DynamicApi` calls.
+                    if (!migration.OldRealm.Schema.TryFindObjectSchema(className, out _))
+                        return;
+
                     var oldItems = migration.OldRealm.DynamicApi.All(className);
                     var newItems = migration.NewRealm.DynamicApi.All(className);
 

From f7ec135b9b0a1bf357a3b508fea8b746a52a8c97 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 19 Oct 2021 14:39:21 +0900
Subject: [PATCH 0317/5547] Fix `TestSceneLoungeRoomsContainer` crashing on
 selecting a room with a password

---
 .../Multiplayer/TestSceneLoungeRoomsContainer.cs      | 11 +++++++++--
 1 file changed, 9 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneLoungeRoomsContainer.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneLoungeRoomsContainer.cs
index 99b530c2a2..1bdf3c2750 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneLoungeRoomsContainer.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneLoungeRoomsContainer.cs
@@ -5,6 +5,7 @@ using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.Cursor;
 using osu.Framework.Testing;
 using osu.Game.Online.Rooms;
 using osu.Game.Rulesets.Catch;
@@ -25,12 +26,18 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [SetUp]
         public new void Setup() => Schedule(() =>
         {
-            Child = container = new RoomsContainer
+            Child = new PopoverContainer
             {
+                RelativeSizeAxes = Axes.X,
+                AutoSizeAxes = Axes.Y,
                 Anchor = Anchor.Centre,
                 Origin = Anchor.Centre,
                 Width = 0.5f,
-                SelectedRoom = { BindTarget = SelectedRoom }
+
+                Child = container = new RoomsContainer
+                {
+                    SelectedRoom = { BindTarget = SelectedRoom }
+                }
             };
         });
 

From d35fe5493a6638f14795ef033f09dbef7afd1234 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 19 Oct 2021 14:50:19 +0900
Subject: [PATCH 0318/5547] Change default value of
 `DrawableLoungeRoom.matchingFilter` so they display by default

---
 osu.Game/Screens/OnlinePlay/Lounge/DrawableLoungeRoom.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Screens/OnlinePlay/Lounge/DrawableLoungeRoom.cs b/osu.Game/Screens/OnlinePlay/Lounge/DrawableLoungeRoom.cs
index fe7c7cc364..e787191d5d 100644
--- a/osu.Game/Screens/OnlinePlay/Lounge/DrawableLoungeRoom.cs
+++ b/osu.Game/Screens/OnlinePlay/Lounge/DrawableLoungeRoom.cs
@@ -103,7 +103,7 @@ namespace osu.Game.Screens.OnlinePlay.Lounge
 
         public IEnumerable<string> FilterTerms => new[] { Room.Name.Value };
 
-        private bool matchingFilter;
+        private bool matchingFilter = true;
 
         public bool MatchingFilter
         {

From 473459d1910b1a164b2784f74531b7beb09d264f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 19 Oct 2021 15:04:14 +0900
Subject: [PATCH 0319/5547] Add layout duration to `PasswordEntryPopover` to
 make error text look a bit smoother

---
 osu.Game/Screens/OnlinePlay/Lounge/DrawableLoungeRoom.cs | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/osu.Game/Screens/OnlinePlay/Lounge/DrawableLoungeRoom.cs b/osu.Game/Screens/OnlinePlay/Lounge/DrawableLoungeRoom.cs
index e787191d5d..79515bf352 100644
--- a/osu.Game/Screens/OnlinePlay/Lounge/DrawableLoungeRoom.cs
+++ b/osu.Game/Screens/OnlinePlay/Lounge/DrawableLoungeRoom.cs
@@ -200,6 +200,8 @@ namespace osu.Game.Screens.OnlinePlay.Lounge
                     Spacing = new Vector2(5),
                     AutoSizeAxes = Axes.Both,
                     Direction = FillDirection.Vertical,
+                    LayoutDuration = 500,
+                    LayoutEasing = Easing.OutQuint,
                     Children = new Drawable[]
                     {
                         new FillFlowContainer

From 8944b1dd78cd5daa4b48eb706ae7f1ca2cadd0e3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 19 Oct 2021 15:04:32 +0900
Subject: [PATCH 0320/5547] Add basic test coverage of `DrawableLoungeRoom`

---
 .../TestSceneDrawableLoungeRoom.cs            | 72 +++++++++++++++++++
 .../OnlinePlay/Lounge/LoungeSubScreen.cs      |  2 +-
 2 files changed, 73 insertions(+), 1 deletion(-)
 create mode 100644 osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableLoungeRoom.cs

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableLoungeRoom.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableLoungeRoom.cs
new file mode 100644
index 0000000000..91c65d14a7
--- /dev/null
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableLoungeRoom.cs
@@ -0,0 +1,72 @@
+// 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.Threading;
+using System.Threading.Tasks;
+using Moq;
+using NUnit.Framework;
+using osu.Framework.Allocation;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Cursor;
+using osu.Framework.Testing;
+using osu.Game.Online.Rooms;
+using osu.Game.Overlays;
+using osu.Game.Screens.OnlinePlay.Lounge;
+
+namespace osu.Game.Tests.Visual.Multiplayer
+{
+    public class TestSceneDrawableLoungeRoom : OsuTestScene
+    {
+        private readonly Room room = new Room
+        {
+            HasPassword = { Value = true }
+        };
+
+        [Cached]
+        protected readonly OverlayColourProvider ColourProvider = new OverlayColourProvider(OverlayColourScheme.Pink);
+
+        [BackgroundDependencyLoader]
+        private void load()
+        {
+            var mockLounge = new Mock<LoungeSubScreen>();
+            mockLounge
+                .Setup(l => l.Join(It.IsAny<Room>(), It.IsAny<string>(), It.IsAny<Action<Room>>(), It.IsAny<Action<string>>()))
+                .Callback<Room, string, Action<Room>, Action<string>>((a, b, c, d) =>
+                {
+                    Task.Run(() =>
+                    {
+                        Thread.Sleep(500);
+                        Schedule(() => d?.Invoke("Incorrect password"));
+                    });
+                });
+
+            Dependencies.CacheAs(mockLounge.Object);
+        }
+
+        [SetUpSteps]
+        public void SetUpSteps()
+        {
+            AddStep("create drawable", () =>
+            {
+                Child = new PopoverContainer
+                {
+                    RelativeSizeAxes = Axes.Both,
+                    Children = new Drawable[]
+                    {
+                        new DrawableLoungeRoom(room)
+                        {
+                            Anchor = Anchor.Centre,
+                            Origin = Anchor.Centre,
+                        }
+                    }
+                };
+            });
+        }
+
+        [Test]
+        public void TestFocus()
+        {
+        }
+    }
+}
diff --git a/osu.Game/Screens/OnlinePlay/Lounge/LoungeSubScreen.cs b/osu.Game/Screens/OnlinePlay/Lounge/LoungeSubScreen.cs
index 08bdd0487a..f9183ec74a 100644
--- a/osu.Game/Screens/OnlinePlay/Lounge/LoungeSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Lounge/LoungeSubScreen.cs
@@ -290,7 +290,7 @@ namespace osu.Game.Screens.OnlinePlay.Lounge
             popoverContainer.HidePopover();
         }
 
-        public void Join(Room room, string password, Action<Room> onSuccess = null, Action<string> onFailure = null) => Schedule(() =>
+        public virtual void Join(Room room, string password, Action<Room> onSuccess = null, Action<string> onFailure = null) => Schedule(() =>
         {
             if (joiningRoomOperation != null)
                 return;

From 32cbf6e54be7f8cdccc0b78eec7a4f3a175e1b61 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 19 Oct 2021 15:20:30 +0900
Subject: [PATCH 0321/5547] Add test coverage ensuring password popover keeps
 focus

---
 .../TestSceneDrawableLoungeRoom.cs            | 103 +++++++++++++++++-
 1 file changed, 99 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableLoungeRoom.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableLoungeRoom.cs
index 91c65d14a7..6d969b6a83 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableLoungeRoom.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableLoungeRoom.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 Moq;
@@ -10,13 +11,15 @@ using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Cursor;
 using osu.Framework.Testing;
+using osu.Game.Graphics.UserInterface;
 using osu.Game.Online.Rooms;
 using osu.Game.Overlays;
 using osu.Game.Screens.OnlinePlay.Lounge;
+using osuTK.Input;
 
 namespace osu.Game.Tests.Visual.Multiplayer
 {
-    public class TestSceneDrawableLoungeRoom : OsuTestScene
+    public class TestSceneDrawableLoungeRoom : OsuManualInputManagerTestScene
     {
         private readonly Room room = new Room
         {
@@ -26,6 +29,11 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [Cached]
         protected readonly OverlayColourProvider ColourProvider = new OverlayColourProvider(OverlayColourScheme.Pink);
 
+        private DrawableLoungeRoom drawableRoom;
+        private SearchTextBox searchTextBox;
+
+        private readonly ManualResetEventSlim allowResponseCallback = new ManualResetEventSlim();
+
         [BackgroundDependencyLoader]
         private void load()
         {
@@ -36,7 +44,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 {
                     Task.Run(() =>
                     {
-                        Thread.Sleep(500);
+                        allowResponseCallback.Wait();
+                        allowResponseCallback.Reset();
                         Schedule(() => d?.Invoke("Incorrect password"));
                     });
                 });
@@ -54,7 +63,16 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     RelativeSizeAxes = Axes.Both,
                     Children = new Drawable[]
                     {
-                        new DrawableLoungeRoom(room)
+                        searchTextBox = new SearchTextBox()
+                        {
+                            HoldFocus = true,
+                            Anchor = Anchor.TopCentre,
+                            Origin = Anchor.TopCentre,
+                            Margin = new MarginPadding(50),
+                            Width = 500,
+                            Depth = float.MaxValue
+                        },
+                        drawableRoom = new DrawableLoungeRoom(room)
                         {
                             Anchor = Anchor.Centre,
                             Origin = Anchor.Centre,
@@ -65,8 +83,85 @@ namespace osu.Game.Tests.Visual.Multiplayer
         }
 
         [Test]
-        public void TestFocus()
+        public void TestFocusViaKeyboardCommit()
         {
+            DrawableLoungeRoom.PasswordEntryPopover popover = null;
+
+            AddAssert("search textbox has focus", () => checkFocus(searchTextBox));
+            AddStep("click room twice", () =>
+            {
+                InputManager.MoveMouseTo(drawableRoom);
+                InputManager.Click(MouseButton.Left);
+                InputManager.Click(MouseButton.Left);
+            });
+            AddUntilStep("wait for popover", () => (popover = InputManager.ChildrenOfType<DrawableLoungeRoom.PasswordEntryPopover>().SingleOrDefault()) != null);
+
+            AddAssert("textbox has focus", () => checkFocus(popover.ChildrenOfType<OsuPasswordTextBox>().Single()));
+
+            AddStep("enter password", () => popover.ChildrenOfType<OsuPasswordTextBox>().Single().Text = "password");
+            AddStep("commit via enter", () => InputManager.Key(Key.Enter));
+
+            AddAssert("popover has focus", () => checkFocus(popover));
+
+            AddStep("attempt another enter", () => InputManager.Key(Key.Enter));
+
+            AddAssert("popover still has focus", () => checkFocus(popover));
+
+            AddStep("unblock response", () => allowResponseCallback.Set());
+
+            AddUntilStep("wait for textbox refocus", () => checkFocus(popover.ChildrenOfType<OsuPasswordTextBox>().Single()));
+
+            AddStep("press escape", () => InputManager.Key(Key.Escape));
+            AddStep("press escape", () => InputManager.Key(Key.Escape));
+
+            AddUntilStep("search textbox has focus", () => checkFocus(searchTextBox));
         }
+
+        [Test]
+        public void TestFocusViaMouseCommit()
+        {
+            DrawableLoungeRoom.PasswordEntryPopover popover = null;
+
+            AddAssert("search textbox has focus", () => checkFocus(searchTextBox));
+            AddStep("click room twice", () =>
+            {
+                InputManager.MoveMouseTo(drawableRoom);
+                InputManager.Click(MouseButton.Left);
+                InputManager.Click(MouseButton.Left);
+            });
+            AddUntilStep("wait for popover", () => (popover = InputManager.ChildrenOfType<DrawableLoungeRoom.PasswordEntryPopover>().SingleOrDefault()) != null);
+
+            AddAssert("textbox has focus", () => checkFocus(popover.ChildrenOfType<OsuPasswordTextBox>().Single()));
+
+            AddStep("enter password", () => popover.ChildrenOfType<OsuPasswordTextBox>().Single().Text = "password");
+
+            AddStep("commit via click button", () =>
+            {
+                var button = popover.ChildrenOfType<OsuButton>().Single();
+                InputManager.MoveMouseTo(button);
+                InputManager.Click(MouseButton.Left);
+            });
+
+            AddAssert("popover has focus", () => checkFocus(popover));
+
+            AddStep("attempt another click", () => InputManager.Click(MouseButton.Left));
+
+            AddAssert("popover still has focus", () => checkFocus(popover));
+
+            AddStep("unblock response", () => allowResponseCallback.Set());
+
+            AddUntilStep("wait for textbox refocus", () => checkFocus(popover.ChildrenOfType<OsuPasswordTextBox>().Single()));
+
+            AddStep("click away", () =>
+            {
+                InputManager.MoveMouseTo(searchTextBox);
+                InputManager.Click(MouseButton.Left);
+            });
+
+            AddUntilStep("search textbox has focus", () => checkFocus(searchTextBox));
+        }
+
+        private bool checkFocus(Drawable expected) =>
+            InputManager.FocusedDrawable == expected;
     }
 }

From a589964dc7f50743536b020efe5006900d7f396d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 19 Oct 2021 15:27:51 +0900
Subject: [PATCH 0322/5547] Centralise join logic

---
 .../OnlinePlay/Lounge/DrawableLoungeRoom.cs   | 24 ++++++++++++-------
 1 file changed, 15 insertions(+), 9 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Lounge/DrawableLoungeRoom.cs b/osu.Game/Screens/OnlinePlay/Lounge/DrawableLoungeRoom.cs
index 79515bf352..64bd61b960 100644
--- a/osu.Game/Screens/OnlinePlay/Lounge/DrawableLoungeRoom.cs
+++ b/osu.Game/Screens/OnlinePlay/Lounge/DrawableLoungeRoom.cs
@@ -232,7 +232,21 @@ namespace osu.Game.Screens.OnlinePlay.Lounge
 
                 sampleJoinFail = audio.Samples.Get(@"UI/password-fail");
 
-                joinButton.Action = () => lounge?.Join(room, passwordTextbox.Text, null, joinFailed);
+                joinButton.Action = performJoin;
+            }
+
+            protected override void LoadComplete()
+            {
+                base.LoadComplete();
+
+                Schedule(() => GetContainingInputManager().ChangeFocus(passwordTextbox));
+                passwordTextbox.OnCommit += (_, __) => performJoin();
+            }
+
+            private void performJoin()
+            {
+                lounge?.Join(room, passwordTextbox.Text, null, joinFailed);
+                GetContainingInputManager().TriggerFocusContention(passwordTextbox);
             }
 
             private void joinFailed(string error)
@@ -252,14 +266,6 @@ namespace osu.Game.Screens.OnlinePlay.Lounge
 
                 sampleJoinFail?.Play();
             }
-
-            protected override void LoadComplete()
-            {
-                base.LoadComplete();
-
-                Schedule(() => GetContainingInputManager().ChangeFocus(passwordTextbox));
-                passwordTextbox.OnCommit += (_, __) => lounge?.Join(room, passwordTextbox.Text, null, joinFailed);
-            }
         }
     }
 }

From da524261c076ca844d1f28e611de97d7ffd16c03 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 19 Oct 2021 15:36:15 +0900
Subject: [PATCH 0323/5547] Fix focus potentially being transferred too far up
 when password is being verified

---
 osu.Game/Screens/OnlinePlay/Lounge/DrawableLoungeRoom.cs | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/osu.Game/Screens/OnlinePlay/Lounge/DrawableLoungeRoom.cs b/osu.Game/Screens/OnlinePlay/Lounge/DrawableLoungeRoom.cs
index 64bd61b960..2a68b1d9b3 100644
--- a/osu.Game/Screens/OnlinePlay/Lounge/DrawableLoungeRoom.cs
+++ b/osu.Game/Screens/OnlinePlay/Lounge/DrawableLoungeRoom.cs
@@ -181,6 +181,10 @@ namespace osu.Game.Screens.OnlinePlay.Lounge
             [Resolved(canBeNull: true)]
             private LoungeSubScreen lounge { get; set; }
 
+            public override bool HandleNonPositionalInput => true;
+
+            protected override bool BlockNonPositionalInput => true;
+
             public PasswordEntryPopover(Room room)
             {
                 this.room = room;

From 480dc571025924d4b4bf5fadb776d8654eb3abbc Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 19 Oct 2021 15:54:10 +0900
Subject: [PATCH 0324/5547] Schedule `joinFailed` callback for added safety

---
 osu.Game/Screens/OnlinePlay/Lounge/DrawableLoungeRoom.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Lounge/DrawableLoungeRoom.cs b/osu.Game/Screens/OnlinePlay/Lounge/DrawableLoungeRoom.cs
index 2a68b1d9b3..72574b729a 100644
--- a/osu.Game/Screens/OnlinePlay/Lounge/DrawableLoungeRoom.cs
+++ b/osu.Game/Screens/OnlinePlay/Lounge/DrawableLoungeRoom.cs
@@ -253,7 +253,7 @@ namespace osu.Game.Screens.OnlinePlay.Lounge
                 GetContainingInputManager().TriggerFocusContention(passwordTextbox);
             }
 
-            private void joinFailed(string error)
+            private void joinFailed(string error) => Schedule(() =>
             {
                 passwordTextbox.Text = string.Empty;
 
@@ -269,7 +269,7 @@ namespace osu.Game.Screens.OnlinePlay.Lounge
                 Body.Shake();
 
                 sampleJoinFail?.Play();
-            }
+            });
         }
     }
 }

From 192cfe871705306d6c73dc77a3e9a01f02cf906f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 19 Oct 2021 16:42:07 +0900
Subject: [PATCH 0325/5547] Replace unnecessary `ToString` call
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/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 b763d39c3b..cba24eb8e6 100644
--- a/osu.Game/Configuration/OsuConfigManager.cs
+++ b/osu.Game/Configuration/OsuConfigManager.cs
@@ -196,7 +196,7 @@ namespace osu.Game.Configuration
                     string skinName = LookupSkinName(m) ?? string.Empty;
                     return new SettingDescription(skinName, SkinSettingsStrings.SkinSectionHeader, skinName, $"{GlobalActionKeyBindingStrings.RandomSkin}: {LookupKeyBindings(GlobalAction.RandomSkin)}");
                 }),
-                new TrackedSetting<float>(OsuSetting.UIScale, m => new SettingDescription(m, GraphicsSettingsStrings.UIScaling, $"{m.ToString("N2")}x")), // TODO: implement lookup for framework platform key bindings
+                new TrackedSetting<float>(OsuSetting.UIScale, m => new SettingDescription(m, GraphicsSettingsStrings.UIScaling, $"{m:N2}x")), // TODO: implement lookup for framework platform key bindings
             };
         }
 

From 61670a70b6df88bcc8cf9f1d85d8025dc9506d97 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 19 Oct 2021 17:00:51 +0900
Subject: [PATCH 0326/5547] Tidy up tracked settings code syntax and fix
 remaining issue

---
 .../ManiaRulesetConfigManager.cs              |  7 ++-
 osu.Game/Configuration/OsuConfigManager.cs    | 45 ++++++++++++++++---
 2 files changed, 44 insertions(+), 8 deletions(-)

diff --git a/osu.Game.Rulesets.Mania/Configuration/ManiaRulesetConfigManager.cs b/osu.Game.Rulesets.Mania/Configuration/ManiaRulesetConfigManager.cs
index ac8168dfc9..44a501f748 100644
--- a/osu.Game.Rulesets.Mania/Configuration/ManiaRulesetConfigManager.cs
+++ b/osu.Game.Rulesets.Mania/Configuration/ManiaRulesetConfigManager.cs
@@ -28,7 +28,12 @@ namespace osu.Game.Rulesets.Mania.Configuration
         public override TrackedSettings CreateTrackedSettings() => new TrackedSettings
         {
             new TrackedSetting<double>(ManiaRulesetSetting.ScrollTime,
-                v => new SettingDescription(v, "Scroll Speed", $"{(int)Math.Round(DrawableManiaRuleset.MAX_TIME_RANGE / v)} ({v}ms)"))
+                v => new SettingDescription(
+                    rawValue: v,
+                    name: "Scroll Speed",
+                    value: $"{(int)Math.Round(DrawableManiaRuleset.MAX_TIME_RANGE / v)} ({v}ms)"
+                )
+            )
         };
     }
 
diff --git a/osu.Game/Configuration/OsuConfigManager.cs b/osu.Game/Configuration/OsuConfigManager.cs
index cba24eb8e6..0790c62499 100644
--- a/osu.Game/Configuration/OsuConfigManager.cs
+++ b/osu.Game/Configuration/OsuConfigManager.cs
@@ -188,15 +188,46 @@ namespace osu.Game.Configuration
 
             return new TrackedSettings
             {
-                new TrackedSetting<bool>(OsuSetting.MouseDisableButtons, v => new SettingDescription(!v, GlobalActionKeyBindingStrings.ToggleGameplayMouseButtons, v ? CommonStrings.Disabled.ToLower() : CommonStrings.Enabled.ToLower(), LookupKeyBindings(GlobalAction.ToggleGameplayMouseButtons))),
-                new TrackedSetting<HUDVisibilityMode>(OsuSetting.HUDVisibilityMode, m => new SettingDescription(m, GameplaySettingsStrings.HUDVisibilityMode, m.GetLocalisableDescription(), $"{GlobalActionKeyBindingStrings.ToggleInGameInterface}: {LookupKeyBindings(GlobalAction.ToggleInGameInterface)} {GlobalActionKeyBindingStrings.HoldForHUD}: {LookupKeyBindings(GlobalAction.HoldForHUD)}")),
-                new TrackedSetting<ScalingMode>(OsuSetting.Scaling, m => new SettingDescription(m, GraphicsSettingsStrings.ScreenScaling, m.GetLocalisableDescription())),
-                new TrackedSetting<int>(OsuSetting.Skin, m =>
+                new TrackedSetting<bool>(OsuSetting.MouseDisableButtons, disabledState => new SettingDescription(
+                    rawValue: !disabledState,
+                    name: GlobalActionKeyBindingStrings.ToggleGameplayMouseButtons,
+                    value: disabledState ? CommonStrings.Disabled.ToLower() : CommonStrings.Enabled.ToLower(),
+                    shortcut: LookupKeyBindings(GlobalAction.ToggleGameplayMouseButtons))
+                ),
+                new TrackedSetting<HUDVisibilityMode>(OsuSetting.HUDVisibilityMode, mode => new SettingDescription(
+                    rawValue: mode,
+                    name: GameplaySettingsStrings.HUDVisibilityMode,
+                    value: mode.GetLocalisableDescription(),
+                    shortcut: new TranslatableString(@"_", @"{0}: {1} {2}: {3}",
+                        GlobalActionKeyBindingStrings.ToggleInGameInterface,
+                        LookupKeyBindings(GlobalAction.ToggleInGameInterface),
+                        GlobalActionKeyBindingStrings.HoldForHUD,
+                        LookupKeyBindings(GlobalAction.HoldForHUD)))
+                ),
+                new TrackedSetting<ScalingMode>(OsuSetting.Scaling, scalingMode => new SettingDescription(
+                        rawValue: scalingMode,
+                        name: GraphicsSettingsStrings.ScreenScaling,
+                        value: scalingMode.GetLocalisableDescription()
+                    )
+                ),
+                new TrackedSetting<int>(OsuSetting.Skin, skin =>
                 {
-                    string skinName = LookupSkinName(m) ?? string.Empty;
-                    return new SettingDescription(skinName, SkinSettingsStrings.SkinSectionHeader, skinName, $"{GlobalActionKeyBindingStrings.RandomSkin}: {LookupKeyBindings(GlobalAction.RandomSkin)}");
+                    string skinName = LookupSkinName(skin) ?? string.Empty;
+
+                    return new SettingDescription(
+                        rawValue: skinName,
+                        name: SkinSettingsStrings.SkinSectionHeader,
+                        value: skinName,
+                        shortcut: $"{GlobalActionKeyBindingStrings.RandomSkin}: {LookupKeyBindings(GlobalAction.RandomSkin)}"
+                    );
                 }),
-                new TrackedSetting<float>(OsuSetting.UIScale, m => new SettingDescription(m, GraphicsSettingsStrings.UIScaling, $"{m:N2}x")), // TODO: implement lookup for framework platform key bindings
+                new TrackedSetting<float>(OsuSetting.UIScale, scale => new SettingDescription(
+                        rawValue: scale,
+                        name: GraphicsSettingsStrings.UIScaling,
+                        value: $"{scale:N2}x"
+                        // TODO: implement lookup for framework platform key bindings
+                    )
+                ),
             };
         }
 

From 8672b3325a776726a8533d6b134aae83182ef5d3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 19 Oct 2021 17:22:50 +0900
Subject: [PATCH 0327/5547] Fix a couple more weird variable names

---
 .../Configuration/ManiaRulesetConfigManager.cs              | 6 +++---
 osu.Game/Configuration/OsuConfigManager.cs                  | 6 +++---
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/osu.Game.Rulesets.Mania/Configuration/ManiaRulesetConfigManager.cs b/osu.Game.Rulesets.Mania/Configuration/ManiaRulesetConfigManager.cs
index 44a501f748..8e09a01469 100644
--- a/osu.Game.Rulesets.Mania/Configuration/ManiaRulesetConfigManager.cs
+++ b/osu.Game.Rulesets.Mania/Configuration/ManiaRulesetConfigManager.cs
@@ -28,10 +28,10 @@ namespace osu.Game.Rulesets.Mania.Configuration
         public override TrackedSettings CreateTrackedSettings() => new TrackedSettings
         {
             new TrackedSetting<double>(ManiaRulesetSetting.ScrollTime,
-                v => new SettingDescription(
-                    rawValue: v,
+                scrollTime => new SettingDescription(
+                    rawValue: scrollTime,
                     name: "Scroll Speed",
-                    value: $"{(int)Math.Round(DrawableManiaRuleset.MAX_TIME_RANGE / v)} ({v}ms)"
+                    value: $"{(int)Math.Round(DrawableManiaRuleset.MAX_TIME_RANGE / scrollTime)} ({scrollTime}ms)"
                 )
             )
         };
diff --git a/osu.Game/Configuration/OsuConfigManager.cs b/osu.Game/Configuration/OsuConfigManager.cs
index 0790c62499..acb4a9ca02 100644
--- a/osu.Game/Configuration/OsuConfigManager.cs
+++ b/osu.Game/Configuration/OsuConfigManager.cs
@@ -194,10 +194,10 @@ namespace osu.Game.Configuration
                     value: disabledState ? CommonStrings.Disabled.ToLower() : CommonStrings.Enabled.ToLower(),
                     shortcut: LookupKeyBindings(GlobalAction.ToggleGameplayMouseButtons))
                 ),
-                new TrackedSetting<HUDVisibilityMode>(OsuSetting.HUDVisibilityMode, mode => new SettingDescription(
-                    rawValue: mode,
+                new TrackedSetting<HUDVisibilityMode>(OsuSetting.HUDVisibilityMode, visibilityMode => new SettingDescription(
+                    rawValue: visibilityMode,
                     name: GameplaySettingsStrings.HUDVisibilityMode,
-                    value: mode.GetLocalisableDescription(),
+                    value: visibilityMode.GetLocalisableDescription(),
                     shortcut: new TranslatableString(@"_", @"{0}: {1} {2}: {3}",
                         GlobalActionKeyBindingStrings.ToggleInGameInterface,
                         LookupKeyBindings(GlobalAction.ToggleInGameInterface),

From 6c18d46443e178e9519380edb55e43b9c847b6a2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 16 Oct 2021 18:12:02 +0200
Subject: [PATCH 0328/5547] Add test scene for demonstrating `OsuDropdown`
 appearance

---
 .../UserInterface/TestSceneOsuDropdown.cs     | 20 ++++++
 .../UserInterface/ThemeComparisonTestScene.cs | 69 +++++++++++++++++++
 2 files changed, 89 insertions(+)
 create mode 100644 osu.Game.Tests/Visual/UserInterface/TestSceneOsuDropdown.cs
 create mode 100644 osu.Game.Tests/Visual/UserInterface/ThemeComparisonTestScene.cs

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneOsuDropdown.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneOsuDropdown.cs
new file mode 100644
index 0000000000..9e77fcf675
--- /dev/null
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneOsuDropdown.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.Game.Beatmaps;
+using osu.Game.Graphics.UserInterface;
+
+namespace osu.Game.Tests.Visual.UserInterface
+{
+    public class TestSceneOsuDropdown : ThemeComparisonTestScene
+    {
+        protected override Drawable CreateContent() =>
+            new OsuEnumDropdown<BeatmapSetOnlineStatus>
+            {
+                Anchor = Anchor.Centre,
+                Origin = Anchor.Centre,
+                Width = 150
+            };
+    }
+}
diff --git a/osu.Game.Tests/Visual/UserInterface/ThemeComparisonTestScene.cs b/osu.Game.Tests/Visual/UserInterface/ThemeComparisonTestScene.cs
new file mode 100644
index 0000000000..f8b9e8223b
--- /dev/null
+++ b/osu.Game.Tests/Visual/UserInterface/ThemeComparisonTestScene.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;
+using System.Linq;
+using NUnit.Framework;
+using osu.Framework.Allocation;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Shapes;
+using osu.Game.Graphics;
+using osu.Game.Overlays;
+
+namespace osu.Game.Tests.Visual.UserInterface
+{
+    public abstract class ThemeComparisonTestScene : OsuGridTestScene
+    {
+        protected ThemeComparisonTestScene()
+            : base(1, 2)
+        {
+        }
+
+        [BackgroundDependencyLoader]
+        private void load(OsuColour colours)
+        {
+            Cell(0, 0).AddRange(new[]
+            {
+                new Box
+                {
+                    RelativeSizeAxes = Axes.Both,
+                    Colour = colours.GreySeafoam
+                },
+                CreateContent()
+            });
+        }
+
+        private void createThemedContent(OverlayColourScheme colourScheme)
+        {
+            var colourProvider = new OverlayColourProvider(colourScheme);
+
+            Cell(0, 1).Clear();
+            Cell(0, 1).Add(new DependencyProvidingContainer
+            {
+                RelativeSizeAxes = Axes.Both,
+                CachedDependencies = new (Type, object)[]
+                {
+                    (typeof(OverlayColourProvider), colourProvider)
+                },
+                Children = new[]
+                {
+                    new Box
+                    {
+                        RelativeSizeAxes = Axes.Both,
+                        Colour = colourProvider.Background4
+                    },
+                    CreateContent()
+                }
+            });
+        }
+
+        protected abstract Drawable CreateContent();
+
+        [Test]
+        public void TestAllColourSchemes()
+        {
+            foreach (var scheme in Enum.GetValues(typeof(OverlayColourScheme)).Cast<OverlayColourScheme>())
+                AddStep($"set {scheme} scheme", () => createThemedContent(scheme));
+        }
+    }
+}

From ef03787fe09ad6707675e4793a05b6135bb11079 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 16 Oct 2021 18:33:17 +0200
Subject: [PATCH 0329/5547] Split dropdown accent colour into hover and
 selection colours

---
 .../Collections/CollectionFilterDropdown.cs   |   6 +-
 .../Graphics/UserInterface/OsuDropdown.cs     | 113 +++++++-----------
 .../Graphics/UserInterface/OsuTabDropdown.cs  |  35 +++++-
 osu.Game/Overlays/Login/UserDropdown.cs       |   8 +-
 osu.Game/Overlays/Music/CollectionDropdown.cs |   8 +-
 .../Overlays/Rankings/SpotlightSelector.cs    |  11 +-
 6 files changed, 90 insertions(+), 91 deletions(-)

diff --git a/osu.Game/Collections/CollectionFilterDropdown.cs b/osu.Game/Collections/CollectionFilterDropdown.cs
index 1eceb56e33..7067f82fd3 100644
--- a/osu.Game/Collections/CollectionFilterDropdown.cs
+++ b/osu.Game/Collections/CollectionFilterDropdown.cs
@@ -181,7 +181,11 @@ namespace osu.Game.Collections
                 MaxHeight = 200;
             }
 
-            protected override DrawableDropdownMenuItem CreateDrawableDropdownMenuItem(MenuItem item) => new CollectionDropdownMenuItem(item);
+            protected override DrawableDropdownMenuItem CreateDrawableDropdownMenuItem(MenuItem item) => new CollectionDropdownMenuItem(item)
+            {
+                BackgroundColourHover = HoverColour,
+                BackgroundColourSelected = SelectionColour
+            };
         }
 
         protected class CollectionDropdownMenuItem : OsuDropdownMenu.DrawableOsuDropdownMenuItem
diff --git a/osu.Game/Graphics/UserInterface/OsuDropdown.cs b/osu.Game/Graphics/UserInterface/OsuDropdown.cs
index 5831d9ab1f..021f36d4fd 100644
--- a/osu.Game/Graphics/UserInterface/OsuDropdown.cs
+++ b/osu.Game/Graphics/UserInterface/OsuDropdown.cs
@@ -21,44 +21,17 @@ using osuTK.Graphics;
 
 namespace osu.Game.Graphics.UserInterface
 {
-    public class OsuDropdown<T> : Dropdown<T>, IHasAccentColour
+    public class OsuDropdown<T> : Dropdown<T>
     {
         private const float corner_radius = 5;
 
-        private Color4 accentColour;
-
-        public Color4 AccentColour
-        {
-            get => accentColour;
-            set
-            {
-                accentColour = value;
-                updateAccentColour();
-            }
-        }
-
-        [BackgroundDependencyLoader(true)]
-        private void load(OverlayColourProvider? colourProvider, OsuColour colours)
-        {
-            if (accentColour == default)
-                accentColour = colourProvider?.Light4 ?? colours.PinkDarker;
-            updateAccentColour();
-        }
-
-        private void updateAccentColour()
-        {
-            if (Header is IHasAccentColour header) header.AccentColour = accentColour;
-
-            if (Menu is IHasAccentColour menu) menu.AccentColour = accentColour;
-        }
-
         protected override DropdownHeader CreateHeader() => new OsuDropdownHeader();
 
         protected override DropdownMenu CreateMenu() => new OsuDropdownMenu();
 
         #region OsuDropdownMenu
 
-        protected class OsuDropdownMenu : DropdownMenu, IHasAccentColour
+        protected class OsuDropdownMenu : DropdownMenu
         {
             public override bool HandleNonPositionalInput => State == MenuState.Open;
 
@@ -78,9 +51,11 @@ namespace osu.Game.Graphics.UserInterface
             }
 
             [BackgroundDependencyLoader(true)]
-            private void load(OverlayColourProvider? colourProvider, AudioManager audio)
+            private void load(OverlayColourProvider? colourProvider, OsuColour colours, AudioManager audio)
             {
                 BackgroundColour = colourProvider?.Background5 ?? Color4.Black.Opacity(0.5f);
+                HoverColour = colourProvider?.Highlight1 ?? colours.PinkDarker;
+                SelectionColour = colourProvider?.Light4 ?? colours.PinkDarker.Opacity(0.5f);
 
                 sampleOpen = audio.Samples.Get(@"UI/dropdown-open");
                 sampleClose = audio.Samples.Get(@"UI/dropdown-close");
@@ -121,57 +96,77 @@ namespace osu.Game.Graphics.UserInterface
                 }
             }
 
-            private Color4 accentColour;
+            private Color4 hoverColour;
 
-            public Color4 AccentColour
+            public Color4 HoverColour
             {
-                get => accentColour;
+                get => hoverColour;
                 set
                 {
-                    accentColour = value;
-                    foreach (var c in Children.OfType<IHasAccentColour>())
-                        c.AccentColour = value;
+                    hoverColour = value;
+                    foreach (var c in Children.OfType<DrawableOsuDropdownMenuItem>())
+                        c.BackgroundColourHover = value;
+                }
+            }
+
+            private Color4 selectionColour;
+
+            public Color4 SelectionColour
+            {
+                get => selectionColour;
+                set
+                {
+                    selectionColour = value;
+                    foreach (var c in Children.OfType<DrawableOsuDropdownMenuItem>())
+                        c.BackgroundColourSelected = value;
                 }
             }
 
             protected override Menu CreateSubMenu() => new OsuMenu(Direction.Vertical);
 
-            protected override DrawableDropdownMenuItem CreateDrawableDropdownMenuItem(MenuItem item) => new DrawableOsuDropdownMenuItem(item) { AccentColour = accentColour };
+            protected override DrawableDropdownMenuItem CreateDrawableDropdownMenuItem(MenuItem item) => new DrawableOsuDropdownMenuItem(item)
+            {
+                BackgroundColourHover = HoverColour,
+                BackgroundColourSelected = SelectionColour
+            };
 
             protected override ScrollContainer<Drawable> CreateScrollContainer(Direction direction) => new OsuScrollContainer(direction);
 
             #region DrawableOsuDropdownMenuItem
 
-            public class DrawableOsuDropdownMenuItem : DrawableDropdownMenuItem, IHasAccentColour
+            public class DrawableOsuDropdownMenuItem : DrawableDropdownMenuItem
             {
                 // IsHovered is used
                 public override bool HandlePositionalInput => true;
 
-                private Color4? accentColour;
-
-                public Color4 AccentColour
+                public new Color4 BackgroundColourHover
                 {
-                    get => accentColour ?? nonAccentSelectedColour;
+                    get => base.BackgroundColourHover;
                     set
                     {
-                        accentColour = value;
+                        base.BackgroundColourHover = value;
+                        updateColours();
+                    }
+                }
+
+                public new Color4 BackgroundColourSelected
+                {
+                    get => base.BackgroundColourSelected;
+                    set
+                    {
+                        base.BackgroundColourSelected = value;
                         updateColours();
                     }
                 }
 
                 private void updateColours()
                 {
-                    BackgroundColourHover = accentColour ?? nonAccentHoverColour;
-                    BackgroundColourSelected = accentColour ?? nonAccentSelectedColour;
                     BackgroundColour = BackgroundColourHover.Opacity(0);
 
                     UpdateBackgroundColour();
                     UpdateForegroundColour();
                 }
 
-                private Color4 nonAccentHoverColour;
-                private Color4 nonAccentSelectedColour;
-
                 public DrawableOsuDropdownMenuItem(MenuItem item)
                     : base(item)
                 {
@@ -182,12 +177,8 @@ namespace osu.Game.Graphics.UserInterface
                 }
 
                 [BackgroundDependencyLoader]
-                private void load(OsuColour colours)
+                private void load()
                 {
-                    nonAccentHoverColour = colours.PinkDarker;
-                    nonAccentSelectedColour = Color4.Black.Opacity(0.5f);
-                    updateColours();
-
                     AddInternal(new HoverSounds());
                 }
 
@@ -290,7 +281,7 @@ namespace osu.Game.Graphics.UserInterface
 
         #endregion
 
-        public class OsuDropdownHeader : DropdownHeader, IHasAccentColour
+        public class OsuDropdownHeader : DropdownHeader
         {
             protected readonly SpriteText Text;
 
@@ -302,18 +293,6 @@ namespace osu.Game.Graphics.UserInterface
 
             protected readonly SpriteIcon Icon;
 
-            private Color4 accentColour;
-
-            public virtual Color4 AccentColour
-            {
-                get => accentColour;
-                set
-                {
-                    accentColour = value;
-                    BackgroundColourHover = accentColour;
-                }
-            }
-
             public OsuDropdownHeader()
             {
                 Foreground.Padding = new MarginPadding(10);
@@ -365,7 +344,7 @@ namespace osu.Game.Graphics.UserInterface
             private void load(OverlayColourProvider? colourProvider, OsuColour colours)
             {
                 BackgroundColour = colourProvider?.Background5 ?? Color4.Black.Opacity(0.5f);
-                BackgroundColourHover = colourProvider?.Light4 ?? colours.PinkDarker;
+                BackgroundColourHover = colourProvider?.Highlight1 ?? colours.PinkDarker;
             }
         }
     }
diff --git a/osu.Game/Graphics/UserInterface/OsuTabDropdown.cs b/osu.Game/Graphics/UserInterface/OsuTabDropdown.cs
index 24b9ca8d90..7f21f69065 100644
--- a/osu.Game/Graphics/UserInterface/OsuTabDropdown.cs
+++ b/osu.Game/Graphics/UserInterface/OsuTabDropdown.cs
@@ -11,8 +11,28 @@ using osu.Framework.Input.Events;
 
 namespace osu.Game.Graphics.UserInterface
 {
-    public class OsuTabDropdown<T> : OsuDropdown<T>
+    public class OsuTabDropdown<T> : OsuDropdown<T>, IHasAccentColour
     {
+        private Color4 accentColour;
+
+        public Color4 AccentColour
+        {
+            get => accentColour;
+            set
+            {
+                accentColour = value;
+
+                if (Menu is OsuDropdownMenu dropdownMenu)
+                {
+                    dropdownMenu.HoverColour = value;
+                    dropdownMenu.SelectionColour = value.Opacity(0.5f);
+                }
+
+                if (Header is OsuTabDropdownHeader tabDropdownHeader)
+                    tabDropdownHeader.AccentColour = value;
+            }
+        }
+
         public OsuTabDropdown()
         {
             RelativeSizeAxes = Axes.X;
@@ -37,7 +57,7 @@ namespace osu.Game.Graphics.UserInterface
                 MaxHeight = 400;
             }
 
-            protected override DrawableDropdownMenuItem CreateDrawableDropdownMenuItem(MenuItem item) => new DrawableOsuTabDropdownMenuItem(item) { AccentColour = AccentColour };
+            protected override DrawableDropdownMenuItem CreateDrawableDropdownMenuItem(MenuItem item) => new DrawableOsuTabDropdownMenuItem(item);
 
             private class DrawableOsuTabDropdownMenuItem : DrawableOsuDropdownMenuItem
             {
@@ -49,14 +69,17 @@ namespace osu.Game.Graphics.UserInterface
             }
         }
 
-        protected class OsuTabDropdownHeader : OsuDropdownHeader
+        protected class OsuTabDropdownHeader : OsuDropdownHeader, IHasAccentColour
         {
-            public override Color4 AccentColour
+            private Color4 accentColour;
+
+            public Color4 AccentColour
             {
-                get => base.AccentColour;
+                get => accentColour;
                 set
                 {
-                    base.AccentColour = value;
+                    accentColour = value;
+                    BackgroundColourHover = value;
                     Foreground.Colour = value;
                 }
             }
diff --git a/osu.Game/Overlays/Login/UserDropdown.cs b/osu.Game/Overlays/Login/UserDropdown.cs
index ac4e7f8eda..d7c47351ec 100644
--- a/osu.Game/Overlays/Login/UserDropdown.cs
+++ b/osu.Game/Overlays/Login/UserDropdown.cs
@@ -29,12 +29,6 @@ namespace osu.Game.Overlays.Login
             }
         }
 
-        [BackgroundDependencyLoader]
-        private void load(OsuColour colours)
-        {
-            AccentColour = colours.Gray5;
-        }
-
         protected class UserDropdownMenu : OsuDropdownMenu
         {
             public UserDropdownMenu()
@@ -56,6 +50,7 @@ namespace osu.Game.Overlays.Login
             private void load(OsuColour colours)
             {
                 BackgroundColour = colours.Gray3;
+                HoverColour = SelectionColour = colours.Gray5;
             }
 
             protected override DrawableDropdownMenuItem CreateDrawableDropdownMenuItem(MenuItem item) => new DrawableUserDropdownMenuItem(item);
@@ -118,6 +113,7 @@ namespace osu.Game.Overlays.Login
             private void load(OsuColour colours)
             {
                 BackgroundColour = colours.Gray3;
+                BackgroundColourHover = colours.Gray5;
             }
         }
     }
diff --git a/osu.Game/Overlays/Music/CollectionDropdown.cs b/osu.Game/Overlays/Music/CollectionDropdown.cs
index ed0ebf696b..d4686dee10 100644
--- a/osu.Game/Overlays/Music/CollectionDropdown.cs
+++ b/osu.Game/Overlays/Music/CollectionDropdown.cs
@@ -19,12 +19,6 @@ namespace osu.Game.Overlays.Music
     {
         protected override bool ShowManageCollectionsItem => false;
 
-        [BackgroundDependencyLoader]
-        private void load(OsuColour colours)
-        {
-            AccentColour = colours.Gray6;
-        }
-
         protected override CollectionDropdownHeader CreateCollectionHeader() => new CollectionsHeader();
 
         protected override CollectionDropdownMenu CreateCollectionMenu() => new CollectionsMenu();
@@ -41,6 +35,7 @@ namespace osu.Game.Overlays.Music
             private void load(OsuColour colours)
             {
                 BackgroundColour = colours.Gray4;
+                HoverColour = SelectionColour = colours.Gray6;
             }
         }
 
@@ -50,6 +45,7 @@ namespace osu.Game.Overlays.Music
             private void load(OsuColour colours)
             {
                 BackgroundColour = colours.Gray4;
+                BackgroundColourHover = colours.Gray6;
             }
 
             public CollectionsHeader()
diff --git a/osu.Game/Overlays/Rankings/SpotlightSelector.cs b/osu.Game/Overlays/Rankings/SpotlightSelector.cs
index 0f071883ca..dfa45cc543 100644
--- a/osu.Game/Overlays/Rankings/SpotlightSelector.cs
+++ b/osu.Game/Overlays/Rankings/SpotlightSelector.cs
@@ -175,18 +175,18 @@ namespace osu.Game.Overlays.Rankings
 
         private class SpotlightsDropdown : OsuDropdown<APISpotlight>
         {
-            private DropdownMenu menu;
+            private OsuDropdownMenu menu;
 
-            protected override DropdownMenu CreateMenu() => menu = base.CreateMenu().With(m => m.MaxHeight = 400);
+            protected override DropdownMenu CreateMenu() => menu = (OsuDropdownMenu)base.CreateMenu().With(m => m.MaxHeight = 400);
 
             protected override DropdownHeader CreateHeader() => new SpotlightsDropdownHeader();
 
             [BackgroundDependencyLoader]
             private void load(OverlayColourProvider colourProvider)
             {
-                // osu-web adds a 0.6 opacity container on top of the 0.5 base one when hovering, 0.8 on a single container here matches the resulting colour
-                AccentColour = colourProvider.Background6.Opacity(0.8f);
                 menu.BackgroundColour = colourProvider.Background5;
+                menu.HoverColour = colourProvider.Background4;
+                menu.SelectionColour = colourProvider.Background3;
                 Padding = new MarginPadding { Vertical = 20 };
             }
 
@@ -205,7 +205,8 @@ namespace osu.Game.Overlays.Rankings
                 private void load(OverlayColourProvider colourProvider)
                 {
                     BackgroundColour = colourProvider.Background6.Opacity(0.5f);
-                    BackgroundColourHover = colourProvider.Background5;
+                    // osu-web adds a 0.6 opacity container on top of the 0.5 base one when hovering, 0.8 on a single container here matches the resulting colour
+                    BackgroundColourHover = colourProvider.Background6.Opacity(0.8f);
                 }
             }
         }

From 61127a389c19e348e3d341e98abd945cdff59538 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 17 Oct 2021 13:31:49 +0200
Subject: [PATCH 0330/5547] Fix tab dropdown receiving accent colour too early

---
 .../Graphics/UserInterface/OsuTabDropdown.cs  | 39 +++++++++++++------
 1 file changed, 28 insertions(+), 11 deletions(-)

diff --git a/osu.Game/Graphics/UserInterface/OsuTabDropdown.cs b/osu.Game/Graphics/UserInterface/OsuTabDropdown.cs
index 7f21f69065..fd1bbcd1e3 100644
--- a/osu.Game/Graphics/UserInterface/OsuTabDropdown.cs
+++ b/osu.Game/Graphics/UserInterface/OsuTabDropdown.cs
@@ -22,22 +22,34 @@ namespace osu.Game.Graphics.UserInterface
             {
                 accentColour = value;
 
-                if (Menu is OsuDropdownMenu dropdownMenu)
-                {
-                    dropdownMenu.HoverColour = value;
-                    dropdownMenu.SelectionColour = value.Opacity(0.5f);
-                }
-
-                if (Header is OsuTabDropdownHeader tabDropdownHeader)
-                    tabDropdownHeader.AccentColour = value;
+                if (IsLoaded)
+                    propagateAccentColour();
             }
         }
 
+        private void propagateAccentColour()
+        {
+            if (Menu is OsuDropdownMenu dropdownMenu)
+            {
+                dropdownMenu.HoverColour = accentColour;
+                dropdownMenu.SelectionColour = accentColour.Opacity(0.5f);
+            }
+
+            if (Header is OsuTabDropdownHeader tabDropdownHeader)
+                tabDropdownHeader.AccentColour = accentColour;
+        }
+
         public OsuTabDropdown()
         {
             RelativeSizeAxes = Axes.X;
         }
 
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+            propagateAccentColour();
+        }
+
         protected override DropdownMenu CreateMenu() => new OsuTabDropdownMenu();
 
         protected override DropdownHeader CreateHeader() => new OsuTabDropdownHeader
@@ -80,7 +92,7 @@ namespace osu.Game.Graphics.UserInterface
                 {
                     accentColour = value;
                     BackgroundColourHover = value;
-                    Foreground.Colour = value;
+                    updateColour();
                 }
             }
 
@@ -116,15 +128,20 @@ namespace osu.Game.Graphics.UserInterface
 
             protected override bool OnHover(HoverEvent e)
             {
-                Foreground.Colour = BackgroundColour;
+                updateColour();
                 return base.OnHover(e);
             }
 
             protected override void OnHoverLost(HoverLostEvent e)
             {
-                Foreground.Colour = BackgroundColourHover;
+                updateColour();
                 base.OnHoverLost(e);
             }
+
+            private void updateColour()
+            {
+                Foreground.Colour = IsHovered ? BackgroundColour : BackgroundColourHover;
+            }
         }
     }
 }

From 80da15369757716ce3ed7c7c82a96b4491447e28 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 19 Oct 2021 22:47:18 +0200
Subject: [PATCH 0331/5547] Recolour a few other existing dropdowns with same
 hover & selection colours

---
 osu.Game/Overlays/Login/UserDropdown.cs       | 3 ++-
 osu.Game/Overlays/Music/CollectionDropdown.cs | 3 ++-
 2 files changed, 4 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Overlays/Login/UserDropdown.cs b/osu.Game/Overlays/Login/UserDropdown.cs
index d7c47351ec..5c3a41aec9 100644
--- a/osu.Game/Overlays/Login/UserDropdown.cs
+++ b/osu.Game/Overlays/Login/UserDropdown.cs
@@ -50,7 +50,8 @@ namespace osu.Game.Overlays.Login
             private void load(OsuColour colours)
             {
                 BackgroundColour = colours.Gray3;
-                HoverColour = SelectionColour = colours.Gray5;
+                SelectionColour = colours.Gray4;
+                HoverColour = colours.Gray5;
             }
 
             protected override DrawableDropdownMenuItem CreateDrawableDropdownMenuItem(MenuItem item) => new DrawableUserDropdownMenuItem(item);
diff --git a/osu.Game/Overlays/Music/CollectionDropdown.cs b/osu.Game/Overlays/Music/CollectionDropdown.cs
index d4686dee10..658eebe67b 100644
--- a/osu.Game/Overlays/Music/CollectionDropdown.cs
+++ b/osu.Game/Overlays/Music/CollectionDropdown.cs
@@ -35,7 +35,8 @@ namespace osu.Game.Overlays.Music
             private void load(OsuColour colours)
             {
                 BackgroundColour = colours.Gray4;
-                HoverColour = SelectionColour = colours.Gray6;
+                SelectionColour = colours.Gray5;
+                HoverColour = colours.Gray6;
             }
         }
 

From f29eb08d93cc2982585752f7522dbab126778e43 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 19 Oct 2021 22:55:49 +0200
Subject: [PATCH 0332/5547] Improve contrast in default
 `OverlayColourProvider`-themed appearance

---
 osu.Game/Graphics/UserInterface/OsuDropdown.cs | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Graphics/UserInterface/OsuDropdown.cs b/osu.Game/Graphics/UserInterface/OsuDropdown.cs
index 021f36d4fd..b1d4691938 100644
--- a/osu.Game/Graphics/UserInterface/OsuDropdown.cs
+++ b/osu.Game/Graphics/UserInterface/OsuDropdown.cs
@@ -54,8 +54,8 @@ namespace osu.Game.Graphics.UserInterface
             private void load(OverlayColourProvider? colourProvider, OsuColour colours, AudioManager audio)
             {
                 BackgroundColour = colourProvider?.Background5 ?? Color4.Black.Opacity(0.5f);
-                HoverColour = colourProvider?.Highlight1 ?? colours.PinkDarker;
-                SelectionColour = colourProvider?.Light4 ?? colours.PinkDarker.Opacity(0.5f);
+                HoverColour = colourProvider?.Light4 ?? colours.PinkDarker;
+                SelectionColour = colourProvider?.Background3 ?? colours.PinkDarker.Opacity(0.5f);
 
                 sampleOpen = audio.Samples.Get(@"UI/dropdown-open");
                 sampleClose = audio.Samples.Get(@"UI/dropdown-close");
@@ -344,7 +344,7 @@ namespace osu.Game.Graphics.UserInterface
             private void load(OverlayColourProvider? colourProvider, OsuColour colours)
             {
                 BackgroundColour = colourProvider?.Background5 ?? Color4.Black.Opacity(0.5f);
-                BackgroundColourHover = colourProvider?.Highlight1 ?? colours.PinkDarker;
+                BackgroundColourHover = colourProvider?.Light4 ?? colours.PinkDarker;
             }
         }
     }

From 37841ca3aa001a1df9eeecc6447865d4fe78d16a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 20 Oct 2021 10:41:34 +0900
Subject: [PATCH 0333/5547] Remove incorrect `ToString` calls causing
 localisation to not actually apply

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

diff --git a/osu.Game/Overlays/OSD/TrackedSettingToast.cs b/osu.Game/Overlays/OSD/TrackedSettingToast.cs
index 198aa1438a..51214fe460 100644
--- a/osu.Game/Overlays/OSD/TrackedSettingToast.cs
+++ b/osu.Game/Overlays/OSD/TrackedSettingToast.cs
@@ -29,7 +29,7 @@ namespace osu.Game.Overlays.OSD
         private Sample sampleChange;
 
         public TrackedSettingToast(SettingDescription description)
-            : base(description.Name.ToString(), description.Value.ToString(), description.Shortcut.ToString())
+            : base(description.Name, description.Value, description.Shortcut)
         {
             FillFlowContainer<OptionLight> optionLights;
 

From 4b2eb7736c7aecebeab7f28c2bdc76d9228e384d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 20 Oct 2021 12:52:38 +0900
Subject: [PATCH 0334/5547] Move helper method to bottom of file

---
 .../Graphics/UserInterface/OsuTabDropdown.cs  | 24 +++++++++----------
 1 file changed, 12 insertions(+), 12 deletions(-)

diff --git a/osu.Game/Graphics/UserInterface/OsuTabDropdown.cs b/osu.Game/Graphics/UserInterface/OsuTabDropdown.cs
index fd1bbcd1e3..68ffc6bf4e 100644
--- a/osu.Game/Graphics/UserInterface/OsuTabDropdown.cs
+++ b/osu.Game/Graphics/UserInterface/OsuTabDropdown.cs
@@ -27,18 +27,6 @@ namespace osu.Game.Graphics.UserInterface
             }
         }
 
-        private void propagateAccentColour()
-        {
-            if (Menu is OsuDropdownMenu dropdownMenu)
-            {
-                dropdownMenu.HoverColour = accentColour;
-                dropdownMenu.SelectionColour = accentColour.Opacity(0.5f);
-            }
-
-            if (Header is OsuTabDropdownHeader tabDropdownHeader)
-                tabDropdownHeader.AccentColour = accentColour;
-        }
-
         public OsuTabDropdown()
         {
             RelativeSizeAxes = Axes.X;
@@ -58,6 +46,18 @@ namespace osu.Game.Graphics.UserInterface
             Origin = Anchor.TopRight
         };
 
+        private void propagateAccentColour()
+        {
+            if (Menu is OsuDropdownMenu dropdownMenu)
+            {
+                dropdownMenu.HoverColour = accentColour;
+                dropdownMenu.SelectionColour = accentColour.Opacity(0.5f);
+            }
+
+            if (Header is OsuTabDropdownHeader tabDropdownHeader)
+                tabDropdownHeader.AccentColour = accentColour;
+        }
+
         private class OsuTabDropdownMenu : OsuDropdownMenu
         {
             public OsuTabDropdownMenu()

From ea9c070e597e39d5c3c6bed5c849782e1e8cbd95 Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Wed, 20 Oct 2021 14:51:59 +0900
Subject: [PATCH 0335/5547] Add setting for queue mode

---
 .../Online/Multiplayer/MultiplayerRoomSettings.cs   |  6 +++---
 .../Multiplayer/{QueueingModes.cs => QueueModes.cs} |  6 ++++--
 osu.Game/Online/Rooms/Room.cs                       | 13 +++++++++++++
 .../Match/MultiplayerMatchSettingsOverlay.cs        |  8 ++++++++
 4 files changed, 28 insertions(+), 5 deletions(-)
 rename osu.Game/Online/Multiplayer/{QueueingModes.cs => QueueModes.cs} (64%)

diff --git a/osu.Game/Online/Multiplayer/MultiplayerRoomSettings.cs b/osu.Game/Online/Multiplayer/MultiplayerRoomSettings.cs
index 596f50d54b..d244e69a6b 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerRoomSettings.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerRoomSettings.cs
@@ -44,7 +44,7 @@ namespace osu.Game.Online.Multiplayer
         public MatchType MatchType { get; set; } = MatchType.HeadToHead;
 
         [Key(9)]
-        public QueueingModes QueueingMode { get; set; } = QueueingModes.Host;
+        public QueueModes QueueMode { get; set; } = QueueModes.HostPick;
 
         public bool Equals(MultiplayerRoomSettings other)
             => BeatmapID == other.BeatmapID
@@ -56,7 +56,7 @@ namespace osu.Game.Online.Multiplayer
                && Name.Equals(other.Name, StringComparison.Ordinal)
                && PlaylistItemId == other.PlaylistItemId
                && MatchType == other.MatchType
-               && QueueingMode == other.QueueingMode;
+               && QueueMode == other.QueueMode;
 
         public override string ToString() => $"Name:{Name}"
                                              + $" Beatmap:{BeatmapID} ({BeatmapChecksum})"
@@ -66,6 +66,6 @@ namespace osu.Game.Online.Multiplayer
                                              + $" Ruleset:{RulesetID}"
                                              + $" Type:{MatchType}"
                                              + $" Item:{PlaylistItemId}"
-                                             + $" Queue:{QueueingMode}";
+                                             + $" Queue:{QueueMode}";
     }
 }
diff --git a/osu.Game/Online/Multiplayer/QueueingModes.cs b/osu.Game/Online/Multiplayer/QueueModes.cs
similarity index 64%
rename from osu.Game/Online/Multiplayer/QueueingModes.cs
rename to osu.Game/Online/Multiplayer/QueueModes.cs
index 684768fa57..501c87c1cf 100644
--- a/osu.Game/Online/Multiplayer/QueueingModes.cs
+++ b/osu.Game/Online/Multiplayer/QueueModes.cs
@@ -3,9 +3,11 @@
 
 namespace osu.Game.Online.Multiplayer
 {
-    public enum QueueingModes
+    public enum QueueModes
     {
-        Host,
+        // used for osu-web deserialization so names shouldn't be changed.
+
+        HostPick,
         Karaoke,
     }
 }
diff --git a/osu.Game/Online/Rooms/Room.cs b/osu.Game/Online/Rooms/Room.cs
index 39fc7f1da8..fe410208cc 100644
--- a/osu.Game/Online/Rooms/Room.cs
+++ b/osu.Game/Online/Rooms/Room.cs
@@ -7,6 +7,7 @@ using Newtonsoft.Json;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Game.IO.Serialization.Converters;
+using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Rooms.RoomStatuses;
 using osu.Game.Users;
 using osu.Game.Utils;
@@ -73,6 +74,18 @@ namespace osu.Game.Online.Rooms
             set => Type.Value = value;
         }
 
+        [Cached]
+        [JsonIgnore]
+        public readonly Bindable<QueueModes> QueueMode = new Bindable<QueueModes>();
+
+        [JsonConverter(typeof(SnakeCaseStringEnumConverter))]
+        [JsonProperty("queue_mode")]
+        private QueueModes queueMode
+        {
+            get => QueueMode.Value;
+            set => QueueMode.Value = value;
+        }
+
         [Cached]
         [JsonIgnore]
         public readonly Bindable<int?> MaxParticipants = new Bindable<int?>();
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs
index 0edf5dde6d..9049d315fb 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs
@@ -59,6 +59,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
             public OsuTextBox NameField, MaxParticipantsField;
             public RoomAvailabilityPicker AvailabilityPicker;
             public MatchTypePicker TypePicker;
+            public OsuEnumDropdown<QueueModes> QueueModeDropdown;
             public OsuTextBox PasswordTextBox;
             public TriangleButton ApplyButton;
 
@@ -190,6 +191,13 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
                                                                         },
                                                                     },
                                                                 },
+                                                                new Section("Beatmap queueing mode")
+                                                                {
+                                                                    Child = QueueModeDropdown = new OsuEnumDropdown<QueueModes>
+                                                                    {
+                                                                        RelativeSizeAxes = Axes.X
+                                                                    }
+                                                                }
                                                             },
                                                         },
                                                         new SectionContainer

From a06f624a4a20f43aebfd50c46a6d705af121116d Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Wed, 20 Oct 2021 15:03:15 +0900
Subject: [PATCH 0336/5547] Fix possible exception with "invalid" key

Triggered by toggling Shift+Tab during gameplay.
---
 osu.Game/Localisation/ResourceManagerLocalisationStore.cs | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/osu.Game/Localisation/ResourceManagerLocalisationStore.cs b/osu.Game/Localisation/ResourceManagerLocalisationStore.cs
index a35ce7a9c8..6a4e38fb38 100644
--- a/osu.Game/Localisation/ResourceManagerLocalisationStore.cs
+++ b/osu.Game/Localisation/ResourceManagerLocalisationStore.cs
@@ -29,6 +29,9 @@ namespace osu.Game.Localisation
         {
             var split = lookup.Split(':');
 
+            if (split.Length < 2)
+                return null;
+
             string ns = split[0];
             string key = split[1];
 

From c8cdc38efd8419bf12c0a48ea8c41fbb93f7bfdd Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Wed, 20 Oct 2021 15:20:30 +0900
Subject: [PATCH 0337/5547] Always compare OnlineIds by >0

---
 osu.Game/Models/RealmBeatmapSet.cs | 2 +-
 osu.Game/Stores/BeatmapImporter.cs | 8 ++++----
 2 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Models/RealmBeatmapSet.cs b/osu.Game/Models/RealmBeatmapSet.cs
index d6e56fd61c..6735510422 100644
--- a/osu.Game/Models/RealmBeatmapSet.cs
+++ b/osu.Game/Models/RealmBeatmapSet.cs
@@ -63,7 +63,7 @@ namespace osu.Game.Models
             if (IsManaged && other.IsManaged)
                 return ID == other.ID;
 
-            if (OnlineID >= 0 && other.OnlineID >= 0)
+            if (OnlineID > 0 && other.OnlineID > 0)
                 return OnlineID == other.OnlineID;
 
             if (!string.IsNullOrEmpty(Hash) && !string.IsNullOrEmpty(other.Hash))
diff --git a/osu.Game/Stores/BeatmapImporter.cs b/osu.Game/Stores/BeatmapImporter.cs
index dc43fda09a..254127cc7e 100644
--- a/osu.Game/Stores/BeatmapImporter.cs
+++ b/osu.Game/Stores/BeatmapImporter.cs
@@ -74,7 +74,7 @@ namespace osu.Game.Stores
             // ensure at least one beatmap was able to retrieve or keep an online ID, else drop the set ID.
             if (hadOnlineBeatmapIDs && !beatmapSet.Beatmaps.Any(b => b.OnlineID > 0))
             {
-                if (beatmapSet.OnlineID > -1)
+                if (beatmapSet.OnlineID > 0)
                 {
                     beatmapSet.OnlineID = -1;
                     LogForModel(beatmapSet, "Disassociating beatmap set ID due to loss of all beatmap IDs");
@@ -91,7 +91,7 @@ namespace osu.Game.Stores
             // If this is ever an issue, we can consider marking as pending delete but not resetting the IDs (but care will be required for
             // beatmaps, which don't have their own `DeletePending` state).
 
-            if (beatmapSet.OnlineID > -1)
+            if (beatmapSet.OnlineID > 0)
             {
                 var existingSetWithSameOnlineID = realm.All<RealmBeatmapSet>().SingleOrDefault(b => b.OnlineID == beatmapSet.OnlineID);
 
@@ -110,7 +110,7 @@ namespace osu.Game.Stores
 
         private void validateOnlineIds(RealmBeatmapSet beatmapSet, Realm realm)
         {
-            var beatmapIds = beatmapSet.Beatmaps.Where(b => b.OnlineID > -1).Select(b => b.OnlineID).ToList();
+            var beatmapIds = beatmapSet.Beatmaps.Where(b => b.OnlineID > 0).Select(b => b.OnlineID).ToList();
 
             // ensure all IDs are unique
             if (beatmapIds.GroupBy(b => b).Any(g => g.Count() > 1))
@@ -148,7 +148,7 @@ namespace osu.Game.Stores
             if (!base.CanSkipImport(existing, import))
                 return false;
 
-            return existing.Beatmaps.Any(b => b.OnlineID > -1);
+            return existing.Beatmaps.Any(b => b.OnlineID > 0);
         }
 
         protected override bool CanReuseExisting(RealmBeatmapSet existing, RealmBeatmapSet import)

From da750a74fc91d26ba39205201a33ac1d6b5b49fb Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 20 Oct 2021 15:24:27 +0900
Subject: [PATCH 0338/5547] Add xmldoc mention of valid `OnlineID` values

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

diff --git a/osu.Game/Database/IHasOnlineID.cs b/osu.Game/Database/IHasOnlineID.cs
index 529c68a8f8..6e2be7e1f9 100644
--- a/osu.Game/Database/IHasOnlineID.cs
+++ b/osu.Game/Database/IHasOnlineID.cs
@@ -8,8 +8,12 @@ namespace osu.Game.Database
     public interface IHasOnlineID
     {
         /// <summary>
-        /// The server-side ID representing this instance, if one exists. -1 denotes a missing ID.
+        /// The server-side ID representing this instance, if one exists. Any value 0 or less denotes a missing ID.
         /// </summary>
+        /// <remarks>
+        /// Generally we use -1 when specifying "missing" in code, but values of 0 are also considered missing as the online source
+        /// is generally a MySQL autoincrement value, which can never be 0.
+        /// </remarks>
         int OnlineID { get; }
     }
 }

From 6f38e6166d136bbe46ce8501e6f796402ae33911 Mon Sep 17 00:00:00 2001
From: Andrei Zavatski <megaman9919@gmail.com>
Date: Wed, 20 Oct 2021 10:32:00 +0300
Subject: [PATCH 0339/5547] Fix and improve
 TestSceneUserProfilePreviousUsernames

---
 .../TestSceneUserProfilePreviousUsernames.cs  | 81 +++++++++++++------
 1 file changed, 56 insertions(+), 25 deletions(-)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneUserProfilePreviousUsernames.cs b/osu.Game.Tests/Visual/Online/TestSceneUserProfilePreviousUsernames.cs
index 1e9d62f379..83254b616c 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneUserProfilePreviousUsernames.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneUserProfilePreviousUsernames.cs
@@ -20,44 +20,75 @@ namespace osu.Game.Tests.Visual.Online
         private IAPIProvider api { get; set; }
 
         private readonly Bindable<User> user = new Bindable<User>();
+        private GetUserRequest request;
+        private PreviousUsernames container;
 
-        public TestSceneUserProfilePreviousUsernames()
+        [SetUp]
+        public void SetUp()
         {
-            Child = new PreviousUsernames
+            request?.Cancel();
+
+            Child = container = new PreviousUsernames
             {
                 Anchor = Anchor.Centre,
                 Origin = Anchor.Centre,
                 User = { BindTarget = user },
             };
-
-            User[] users =
-            {
-                new User { PreviousUsernames = new[] { "username1" } },
-                new User { PreviousUsernames = new[] { "longusername", "longerusername" } },
-                new User { PreviousUsernames = new[] { "test", "angelsim", "verylongusername" } },
-                new User { PreviousUsernames = new[] { "ihavenoidea", "howcani", "makethistext", "anylonger" } },
-                new User { PreviousUsernames = Array.Empty<string>() },
-                null
-            };
-
-            AddStep("single username", () => user.Value = users[0]);
-            AddStep("two usernames", () => user.Value = users[1]);
-            AddStep("three usernames", () => user.Value = users[2]);
-            AddStep("four usernames", () => user.Value = users[3]);
-            AddStep("no username", () => user.Value = users[4]);
-            AddStep("null user", () => user.Value = users[5]);
         }
 
-        protected override void LoadComplete()
+        [Test]
+        public void TestOffline()
         {
-            base.LoadComplete();
+            AddAssert("Is Hidden", () => container?.Alpha == 0);
 
-            AddStep("online user (Angelsim)", () =>
+            AddStep("1 username", () => user.Value = users[0]);
+            AddUntilStep("Is visible", () => container?.Alpha == 1);
+
+            AddStep("2 usernames", () => user.Value = users[1]);
+            AddUntilStep("Is visible", () => container?.Alpha == 1);
+
+            AddStep("3 usernames", () => user.Value = users[2]);
+            AddUntilStep("Is visible", () => container?.Alpha == 1);
+
+            AddStep("4 usernames", () => user.Value = users[3]);
+            AddUntilStep("Is visible", () => container?.Alpha == 1);
+
+            AddStep("No username", () => user.Value = users[4]);
+            AddUntilStep("Is hidden", () => container?.Alpha == 0);
+
+            AddStep("Null user", () => user.Value = users[5]);
+            AddUntilStep("Is hidden", () => container?.Alpha == 0);
+        }
+
+        [Test]
+        public void TestOnline()
+        {
+            AddAssert("Is Hidden", () => container?.Alpha == 0);
+
+            AddStep("Create request", () =>
             {
-                var request = new GetUserRequest(1777162);
-                request.Success += user => this.user.Value = user;
-                api.Queue(request);
+                request = new GetUserRequest(1777162);
+                request.Success += u => user.Value = u;
+                api?.Queue(request);
             });
+
+            AddUntilStep("Is visible", () => container?.Alpha == 1);
+        }
+
+        private static readonly User[] users =
+        {
+            new User { Id = 1, PreviousUsernames = new[] { "username1" } },
+            new User { Id = 2, PreviousUsernames = new[] { "longusername", "longerusername" } },
+            new User { Id = 3, PreviousUsernames = new[] { "test", "angelsim", "verylongusername" } },
+            new User { Id = 4, PreviousUsernames = new[] { "ihavenoidea", "howcani", "makethistext", "anylonger" } },
+            new User { Id = 5, PreviousUsernames = Array.Empty<string>() },
+            null
+        };
+
+        protected override void Dispose(bool isDisposing)
+        {
+            request?.Cancel();
+            base.Dispose(isDisposing);
         }
     }
 }

From faabc75a3ec41f01a5a9030fbf4c6ef989d8797b Mon Sep 17 00:00:00 2001
From: Andrei Zavatski <megaman9919@gmail.com>
Date: Wed, 20 Oct 2021 10:54:08 +0300
Subject: [PATCH 0340/5547] Fix failing test

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

diff --git a/osu.Game.Tests/Visual/Online/TestSceneUserProfilePreviousUsernames.cs b/osu.Game.Tests/Visual/Online/TestSceneUserProfilePreviousUsernames.cs
index 83254b616c..303f66d893 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneUserProfilePreviousUsernames.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneUserProfilePreviousUsernames.cs
@@ -4,7 +4,6 @@
 using System;
 using NUnit.Framework;
 using osu.Framework.Allocation;
-using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests;
@@ -19,12 +18,11 @@ namespace osu.Game.Tests.Visual.Online
         [Resolved]
         private IAPIProvider api { get; set; }
 
-        private readonly Bindable<User> user = new Bindable<User>();
         private GetUserRequest request;
         private PreviousUsernames container;
 
         [SetUp]
-        public void SetUp()
+        public void SetUp() => Schedule(() =>
         {
             request?.Cancel();
 
@@ -32,31 +30,30 @@ namespace osu.Game.Tests.Visual.Online
             {
                 Anchor = Anchor.Centre,
                 Origin = Anchor.Centre,
-                User = { BindTarget = user },
             };
-        }
+        });
 
         [Test]
         public void TestOffline()
         {
             AddAssert("Is Hidden", () => container?.Alpha == 0);
 
-            AddStep("1 username", () => user.Value = users[0]);
+            AddStep("1 username", () => container.User.Value = users[0]);
             AddUntilStep("Is visible", () => container?.Alpha == 1);
 
-            AddStep("2 usernames", () => user.Value = users[1]);
+            AddStep("2 usernames", () => container.User.Value = users[1]);
             AddUntilStep("Is visible", () => container?.Alpha == 1);
 
-            AddStep("3 usernames", () => user.Value = users[2]);
+            AddStep("3 usernames", () => container.User.Value = users[2]);
             AddUntilStep("Is visible", () => container?.Alpha == 1);
 
-            AddStep("4 usernames", () => user.Value = users[3]);
+            AddStep("4 usernames", () => container.User.Value = users[3]);
             AddUntilStep("Is visible", () => container?.Alpha == 1);
 
-            AddStep("No username", () => user.Value = users[4]);
+            AddStep("No username", () => container.User.Value = users[4]);
             AddUntilStep("Is hidden", () => container?.Alpha == 0);
 
-            AddStep("Null user", () => user.Value = users[5]);
+            AddStep("Null user", () => container.User.Value = users[5]);
             AddUntilStep("Is hidden", () => container?.Alpha == 0);
         }
 
@@ -68,7 +65,7 @@ namespace osu.Game.Tests.Visual.Online
             AddStep("Create request", () =>
             {
                 request = new GetUserRequest(1777162);
-                request.Success += u => user.Value = u;
+                request.Success += u => container.User.Value = u;
                 api?.Queue(request);
             });
 

From 0f8d270442b34d4155f13991e0e42adc5e41edfe Mon Sep 17 00:00:00 2001
From: Andrei Zavatski <megaman9919@gmail.com>
Date: Wed, 20 Oct 2021 11:27:24 +0300
Subject: [PATCH 0341/5547] Remove online part since it doesn't really check
 anything

---
 .../TestSceneUserProfilePreviousUsernames.cs  | 46 ++++---------------
 1 file changed, 8 insertions(+), 38 deletions(-)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneUserProfilePreviousUsernames.cs b/osu.Game.Tests/Visual/Online/TestSceneUserProfilePreviousUsernames.cs
index 303f66d893..b5d2d15392 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneUserProfilePreviousUsernames.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneUserProfilePreviousUsernames.cs
@@ -3,10 +3,7 @@
 
 using System;
 using NUnit.Framework;
-using osu.Framework.Allocation;
 using osu.Framework.Graphics;
-using osu.Game.Online.API;
-using osu.Game.Online.API.Requests;
 using osu.Game.Overlays.Profile.Header.Components;
 using osu.Game.Users;
 
@@ -15,17 +12,11 @@ namespace osu.Game.Tests.Visual.Online
     [TestFixture]
     public class TestSceneUserProfilePreviousUsernames : OsuTestScene
     {
-        [Resolved]
-        private IAPIProvider api { get; set; }
-
-        private GetUserRequest request;
         private PreviousUsernames container;
 
         [SetUp]
         public void SetUp() => Schedule(() =>
         {
-            request?.Cancel();
-
             Child = container = new PreviousUsernames
             {
                 Anchor = Anchor.Centre,
@@ -34,42 +25,27 @@ namespace osu.Game.Tests.Visual.Online
         });
 
         [Test]
-        public void TestOffline()
+        public void TestVisibility()
         {
-            AddAssert("Is Hidden", () => container?.Alpha == 0);
+            AddAssert("Is Hidden", () => container.Alpha == 0);
 
             AddStep("1 username", () => container.User.Value = users[0]);
-            AddUntilStep("Is visible", () => container?.Alpha == 1);
+            AddUntilStep("Is visible", () => container.Alpha == 1);
 
             AddStep("2 usernames", () => container.User.Value = users[1]);
-            AddUntilStep("Is visible", () => container?.Alpha == 1);
+            AddUntilStep("Is visible", () => container.Alpha == 1);
 
             AddStep("3 usernames", () => container.User.Value = users[2]);
-            AddUntilStep("Is visible", () => container?.Alpha == 1);
+            AddUntilStep("Is visible", () => container.Alpha == 1);
 
             AddStep("4 usernames", () => container.User.Value = users[3]);
-            AddUntilStep("Is visible", () => container?.Alpha == 1);
+            AddUntilStep("Is visible", () => container.Alpha == 1);
 
             AddStep("No username", () => container.User.Value = users[4]);
-            AddUntilStep("Is hidden", () => container?.Alpha == 0);
+            AddUntilStep("Is hidden", () => container.Alpha == 0);
 
             AddStep("Null user", () => container.User.Value = users[5]);
-            AddUntilStep("Is hidden", () => container?.Alpha == 0);
-        }
-
-        [Test]
-        public void TestOnline()
-        {
-            AddAssert("Is Hidden", () => container?.Alpha == 0);
-
-            AddStep("Create request", () =>
-            {
-                request = new GetUserRequest(1777162);
-                request.Success += u => container.User.Value = u;
-                api?.Queue(request);
-            });
-
-            AddUntilStep("Is visible", () => container?.Alpha == 1);
+            AddUntilStep("Is hidden", () => container.Alpha == 0);
         }
 
         private static readonly User[] users =
@@ -81,11 +57,5 @@ namespace osu.Game.Tests.Visual.Online
             new User { Id = 5, PreviousUsernames = Array.Empty<string>() },
             null
         };
-
-        protected override void Dispose(bool isDisposing)
-        {
-            request?.Cancel();
-            base.Dispose(isDisposing);
-        }
     }
 }

From 789c715f136254e68cdccce5d986bbfd9a05e1d6 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 20 Oct 2021 15:22:47 +0900
Subject: [PATCH 0342/5547] Add `skin.ini` write support to allow for more
 correct hashing

---
 osu.Game.Tests/Skins/IO/ImportSkinTest.cs |  33 +++++-
 osu.Game/Database/ArchiveModelManager.cs  |  43 +++++--
 osu.Game/Skinning/SkinManager.cs          | 132 +++++++++++++++++-----
 3 files changed, 162 insertions(+), 46 deletions(-)

diff --git a/osu.Game.Tests/Skins/IO/ImportSkinTest.cs b/osu.Game.Tests/Skins/IO/ImportSkinTest.cs
index b2600bb887..67c94413ca 100644
--- a/osu.Game.Tests/Skins/IO/ImportSkinTest.cs
+++ b/osu.Game.Tests/Skins/IO/ImportSkinTest.cs
@@ -38,7 +38,32 @@ namespace osu.Game.Tests.Skins.IO
         }
 
         [Test]
-        public async Task TestImportTwiceWithSameMetadata()
+        public async Task TestImportTwiceWithSameMetadataAndFilename()
+        {
+            using (HeadlessGameHost host = new CleanRunHeadlessGameHost(nameof(ImportSkinTest)))
+            {
+                try
+                {
+                    var osu = LoadOsuIntoHost(host);
+
+                    var imported = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOsk("test skin", "skinner"), "skin.osk"));
+                    var imported2 = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOsk("test skin", "skinner"), "skin.osk"));
+
+                    Assert.That(imported2.ID, Is.EqualTo(imported.ID));
+                    Assert.That(osu.Dependencies.Get<SkinManager>().GetAllUserSkins(true).Count, Is.EqualTo(1));
+
+                    // the first should be overwritten by the second import.
+                    Assert.That(imported.Files.First().FileInfoID, Is.EqualTo(imported2.Files.First().FileInfoID));
+                }
+                finally
+                {
+                    host.Exit();
+                }
+            }
+        }
+
+        [Test]
+        public async Task TestImportTwiceWithSameMetadataButDifferentFilename()
         {
             using (HeadlessGameHost host = new CleanRunHeadlessGameHost(nameof(ImportSkinTest)))
             {
@@ -50,10 +75,10 @@ namespace osu.Game.Tests.Skins.IO
                     var imported2 = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOsk("test skin", "skinner"), "skin2.osk"));
 
                     Assert.That(imported2.ID, Is.Not.EqualTo(imported.ID));
-                    Assert.That(osu.Dependencies.Get<SkinManager>().GetAllUserSkins(true).Count, Is.EqualTo(1));
+                    Assert.That(osu.Dependencies.Get<SkinManager>().GetAllUserSkins(true).Count, Is.EqualTo(2));
 
-                    // the first should be overwritten by the second import.
-                    Assert.That(osu.Dependencies.Get<SkinManager>().GetAllUserSkins(true).First().Files.First().FileInfoID, Is.EqualTo(imported2.Files.First().FileInfoID));
+                    // skin.ini will be rewritten and therefore not match.
+                    Assert.That(imported.Files.First().FileInfoID, Is.Not.EqualTo(imported2.Files.First().FileInfoID));
                 }
                 finally
                 {
diff --git a/osu.Game/Database/ArchiveModelManager.cs b/osu.Game/Database/ArchiveModelManager.cs
index 9c777d324b..e52e5bdfe7 100644
--- a/osu.Game/Database/ArchiveModelManager.cs
+++ b/osu.Game/Database/ArchiveModelManager.cs
@@ -507,18 +507,26 @@ namespace osu.Game.Database
         /// <param name="file">The existing file to be deleted.</param>
         public void DeleteFile(TModel model, TFileModel file)
         {
-            using (var usage = ContextFactory.GetForWrite())
+            if (model.ID > 0)
             {
-                // Dereference the existing file info, since the file model will be removed.
-                if (file.FileInfo != null)
+                using (var usage = ContextFactory.GetForWrite())
                 {
-                    Files.Dereference(file.FileInfo);
+                    // Dereference the existing file info, since the file model will be removed.
+                    if (file.FileInfo != null)
+                    {
+                        Files.Dereference(file.FileInfo);
 
-                    // This shouldn't be required, but here for safety in case the provided TModel is not being change tracked
-                    // Definitely can be removed once we rework the database backend.
-                    usage.Context.Set<TFileModel>().Remove(file);
+                        // This shouldn't be required, but here for safety in case the provided TModel is not being change tracked
+                        // Definitely can be removed once we rework the database backend.
+                        usage.Context.Set<TFileModel>().Remove(file);
+                    }
+
+                    model.Files.Remove(file);
                 }
-
+            }
+            else
+            {
+                Files.Dereference(file.FileInfo);
                 model.Files.Remove(file);
             }
         }
@@ -531,15 +539,28 @@ namespace osu.Game.Database
         /// <param name="filename">The filename for the new file.</param>
         public void AddFile(TModel model, Stream contents, string filename)
         {
-            using (ContextFactory.GetForWrite())
+            if (model.ID > 0)
             {
+                using (ContextFactory.GetForWrite())
+                {
+                    model.Files.Add(new TFileModel
+                    {
+                        Filename = filename,
+                        FileInfo = Files.Add(contents)
+                    });
+
+                    Update(model);
+                }
+            }
+            else
+            {
+                // This function may be called during the import process.
+                // Should not exist like this once we have switched to realm.
                 model.Files.Add(new TFileModel
                 {
                     Filename = filename,
                     FileInfo = Files.Add(contents)
                 });
-
-                Update(model);
             }
         }
 
diff --git a/osu.Game/Skinning/SkinManager.cs b/osu.Game/Skinning/SkinManager.cs
index 3842acab74..724ca3bc62 100644
--- a/osu.Game/Skinning/SkinManager.cs
+++ b/osu.Game/Skinning/SkinManager.cs
@@ -14,7 +14,6 @@ using Newtonsoft.Json;
 using osu.Framework.Audio;
 using osu.Framework.Audio.Sample;
 using osu.Framework.Bindables;
-using osu.Framework.Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.OpenGL.Textures;
 using osu.Framework.Graphics.Textures;
@@ -138,52 +137,123 @@ namespace osu.Game.Skinning
         {
             var instance = GetSkin(item);
 
-            // in the case the skin has a skin.ini file, we are going to create a hash based on that.
-            // we don't want to do this in the case we don't have a skin.ini, as it would match only on the filename portion,
-            // causing potentially unique skin imports to be considered as a duplicate.
-            if (!string.IsNullOrEmpty(instance.Configuration.SkinInfo.Name))
-            {
-                // we need to populate early to create a hash based off skin.ini contents
-                populateMetadata(item, instance, reader?.Name);
+            // This function can be run on fresh import or save. The logic here ensures a skin.ini file is in a good state for both operations.
 
-                return item.ToString().ComputeSHA2Hash();
+            // LegacySkin will parse the skin.ini and populate `Skin.Configuration` during construction above.
+            bool hasSkinIni = string.IsNullOrEmpty(instance.Configuration.SkinInfo.Name);
+
+            if (hasSkinIni)
+            {
+                item.Name = instance.Configuration.SkinInfo.Name;
+                item.Creator = instance.Configuration.SkinInfo.Creator;
             }
 
+            item.Creator ??= unknown_creator_string;
+
+            bool isImport = reader != null;
+
+            if (isImport)
+            {
+                // For imports, we want to use the archive or folder name as part of the metadata, in addition to any existing skin.ini metadata.
+                // In an ideal world, skin.ini would be the only source of metadata, but a lot of skin creators and users don't update it when making modifications.
+                // In both of these cases, the expectation from the user is that the filename or folder name is displayed somewhere to identify the skin.
+
+                string archiveName = item.Name.Replace(".osk", "", StringComparison.OrdinalIgnoreCase);
+
+                if (archiveName != item.Name)
+                    item.Name = $"{item.Name} [{archiveName}]";
+            }
+
+            // By this point, the metadata in SkinInfo will be correct.
+            // Regardless of whether this is an import or not, let's write the skin.ini if non-existing or non-matching.
+            // This is (weirdly) done inside ComputeHash to avoid adding a new method to handle this case. After switching to realm it can be moved into another place.
+            if (instance.Configuration.SkinInfo.Name != item.Name)
+                updateSkinIniMetadata(item, hasSkinIni);
+
             return base.ComputeHash(item, reader);
         }
 
+        private void updateSkinIniMetadata(SkinInfo item, bool hasSkinIni)
+        {
+            string nameLine = $"Name: {item.Name}";
+            string authorLine = $"Author: {item.Name}";
+
+            if (hasSkinIni)
+            {
+                List<string> outputLines = new List<string>();
+
+                bool addedName = false;
+                bool addedAuthor = false;
+
+                var existingFile = item.Files.First(f => f.Filename == "skin.ini");
+
+                using (var stream = Files.Storage.GetStream(existingFile.FileInfo.StoragePath))
+                using (var sr = new StreamReader(stream))
+                {
+                    string line;
+
+                    while ((line = sr.ReadLine()) != null)
+                    {
+                        if (line.StartsWith("Name:", StringComparison.Ordinal))
+                        {
+                            outputLines.Add(nameLine);
+                            addedName = true;
+                        }
+                        else if (line.StartsWith("Author:", StringComparison.Ordinal))
+                        {
+                            outputLines.Add(authorLine);
+                            addedAuthor = true;
+                        }
+                        else
+                            outputLines.Add(line);
+                    }
+                }
+
+                if (!addedName || !addedAuthor)
+                {
+                    outputLines.AddRange(new[]
+                    {
+                        "[General]",
+                        nameLine,
+                        authorLine,
+                    });
+                }
+
+                using (Stream stream = new MemoryStream())
+                using (var sw = new StreamWriter(stream, Encoding.UTF8, 1024, true))
+                {
+                    foreach (string line in outputLines)
+                        sw.WriteLine(line);
+
+                    ReplaceFile(item, existingFile, stream);
+                }
+            }
+            else
+            {
+                using (Stream stream = new MemoryStream())
+                using (var sw = new StreamWriter(stream, Encoding.UTF8, 1024, true))
+                {
+                    sw.WriteLine("[General]");
+                    sw.WriteLine(nameLine);
+                    sw.WriteLine(authorLine);
+
+                    AddFile(item, stream, "skin.ini");
+                }
+            }
+        }
+
         protected override Task Populate(SkinInfo model, ArchiveReader archive, CancellationToken cancellationToken = default)
         {
             var instance = GetSkin(model);
 
             model.InstantiationInfo ??= instance.GetType().GetInvariantInstantiationInfo();
 
-            populateMetadata(model, instance, archive?.Name);
+            model.Name = instance.Configuration.SkinInfo.Name;
+            model.Creator = instance.Configuration.SkinInfo.Creator;
 
             return Task.CompletedTask;
         }
 
-        private void populateMetadata(SkinInfo item, Skin instance, string archiveName)
-        {
-            if (!string.IsNullOrEmpty(instance.Configuration.SkinInfo.Name))
-            {
-                item.Name = instance.Configuration.SkinInfo.Name;
-                item.Creator = instance.Configuration.SkinInfo.Creator;
-            }
-            else
-            {
-                item.Name = item.Name.Replace(".osk", "", StringComparison.OrdinalIgnoreCase);
-                item.Creator ??= unknown_creator_string;
-            }
-
-            // generally when importing from a folder, the ".osk" extension will not be present.
-            // if we ever need a more reliable method of determining this, the type of `ArchiveReader` can be checked.
-            bool isArchiveImport = archiveName?.Contains(".osk", StringComparison.OrdinalIgnoreCase) == true;
-
-            if (archiveName != null && !isArchiveImport && archiveName != item.Name)
-                item.Name = $"{item.Name} [{archiveName}]";
-        }
-
         /// <summary>
         /// Retrieve a <see cref="Skin"/> instance for the provided <see cref="SkinInfo"/>
         /// </summary>

From fa542f254778747c2dfb8e8c0d17fe5f2e995de9 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 20 Oct 2021 14:05:32 +0900
Subject: [PATCH 0343/5547] Include `json` files in skin hashing

This covers the new layout storage we are doing.
---
 osu.Game/Skinning/SkinManager.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Skinning/SkinManager.cs b/osu.Game/Skinning/SkinManager.cs
index 724ca3bc62..9c7ea28cc4 100644
--- a/osu.Game/Skinning/SkinManager.cs
+++ b/osu.Game/Skinning/SkinManager.cs
@@ -50,7 +50,7 @@ namespace osu.Game.Skinning
 
         public override IEnumerable<string> HandledExtensions => new[] { ".osk" };
 
-        protected override string[] HashableFileTypes => new[] { ".ini" };
+        protected override string[] HashableFileTypes => new[] { ".ini", ".json" };
 
         protected override string ImportFromStablePath => "Skins";
 
@@ -140,7 +140,7 @@ namespace osu.Game.Skinning
             // This function can be run on fresh import or save. The logic here ensures a skin.ini file is in a good state for both operations.
 
             // LegacySkin will parse the skin.ini and populate `Skin.Configuration` during construction above.
-            bool hasSkinIni = string.IsNullOrEmpty(instance.Configuration.SkinInfo.Name);
+            bool hasSkinIni = !string.IsNullOrEmpty(instance.Configuration.SkinInfo.Name);
 
             if (hasSkinIni)
             {

From 439e90fce3d3c804fceb80e928af0ed2f87836bb Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 20 Oct 2021 15:51:14 +0900
Subject: [PATCH 0344/5547] Disallow archive imports with no hashable files

---
 osu.Game/Database/ArchiveModelManager.cs | 18 +++++++++++-------
 1 file changed, 11 insertions(+), 7 deletions(-)

diff --git a/osu.Game/Database/ArchiveModelManager.cs b/osu.Game/Database/ArchiveModelManager.cs
index e52e5bdfe7..5b07bfe9a5 100644
--- a/osu.Game/Database/ArchiveModelManager.cs
+++ b/osu.Game/Database/ArchiveModelManager.cs
@@ -317,14 +317,18 @@ namespace osu.Game.Database
         /// </remarks>
         protected virtual string ComputeHash(TModel item, ArchiveReader reader = null)
         {
-            if (reader != null)
-                // fast hashing for cases where the item's files may not be populated.
-                return computeHashFast(reader);
+            var hashableFiles = item.Files
+                                    .Where(f => HashableFileTypes.Any(ext => f.Filename.EndsWith(ext, StringComparison.OrdinalIgnoreCase)))
+                                    .OrderBy(f => f.Filename)
+                                    .ToArray();
+
+            if (hashableFiles.Length == 0)
+                throw new InvalidOperationException("Attempted to hash an archive with no files");
 
             // for now, concatenate all hashable files in the set to create a unique hash.
             MemoryStream hashable = new MemoryStream();
 
-            foreach (TFileModel file in item.Files.Where(f => HashableFileTypes.Any(ext => f.Filename.EndsWith(ext, StringComparison.OrdinalIgnoreCase))).OrderBy(f => f.Filename))
+            foreach (TFileModel file in hashableFiles)
             {
                 using (Stream s = Files.Store.GetStream(file.FileInfo.StoragePath))
                     s.CopyTo(hashable);
@@ -700,10 +704,10 @@ namespace osu.Game.Database
                     s.CopyTo(hashable);
             }
 
-            if (hashable.Length > 0)
-                return hashable.ComputeSHA2Hash();
+            if (hashable.Length == 0)
+                throw new InvalidOperationException("Attempted to hash an archive with no files");
 
-            return reader.Name.ComputeSHA2Hash();
+            return hashable.ComputeSHA2Hash();
         }
 
         /// <summary>

From 19f30177eacb10e733216d3534ec997b1dc9a5a8 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 20 Oct 2021 16:48:32 +0900
Subject: [PATCH 0345/5547] Rewrite tests completely

---
 osu.Game.Tests/Skins/IO/ImportSkinTest.cs | 249 ++++++++++------------
 1 file changed, 108 insertions(+), 141 deletions(-)

diff --git a/osu.Game.Tests/Skins/IO/ImportSkinTest.cs b/osu.Game.Tests/Skins/IO/ImportSkinTest.cs
index 67c94413ca..8449b0bbd3 100644
--- a/osu.Game.Tests/Skins/IO/ImportSkinTest.cs
+++ b/osu.Game.Tests/Skins/IO/ImportSkinTest.cs
@@ -4,6 +4,7 @@
 using System;
 using System.IO;
 using System.Linq;
+using System.Runtime.CompilerServices;
 using System.Threading.Tasks;
 using NUnit.Framework;
 using osu.Framework.Allocation;
@@ -16,180 +17,130 @@ namespace osu.Game.Tests.Skins.IO
 {
     public class ImportSkinTest : ImportTest
     {
-        [Test]
-        public async Task TestBasicImport()
-        {
-            using (HeadlessGameHost host = new CleanRunHeadlessGameHost(nameof(ImportSkinTest)))
-            {
-                try
-                {
-                    var osu = LoadOsuIntoHost(host);
-
-                    var imported = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOsk("test skin", "skinner"), "skin.osk"));
-
-                    Assert.That(imported.Name, Is.EqualTo("test skin"));
-                    Assert.That(imported.Creator, Is.EqualTo("skinner"));
-                }
-                finally
-                {
-                    host.Exit();
-                }
-            }
-        }
+        #region Testing filename metadata inclusion
 
         [Test]
-        public async Task TestImportTwiceWithSameMetadataAndFilename()
+        public Task TestSingleImportDifferentFilename() => runSkinTest(async osu =>
         {
-            using (HeadlessGameHost host = new CleanRunHeadlessGameHost(nameof(ImportSkinTest)))
-            {
-                try
-                {
-                    var osu = LoadOsuIntoHost(host);
+            var imported = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOsk("test skin", "skinner"), "skin.osk"));
 
-                    var imported = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOsk("test skin", "skinner"), "skin.osk"));
-                    var imported2 = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOsk("test skin", "skinner"), "skin.osk"));
-
-                    Assert.That(imported2.ID, Is.EqualTo(imported.ID));
-                    Assert.That(osu.Dependencies.Get<SkinManager>().GetAllUserSkins(true).Count, Is.EqualTo(1));
-
-                    // the first should be overwritten by the second import.
-                    Assert.That(imported.Files.First().FileInfoID, Is.EqualTo(imported2.Files.First().FileInfoID));
-                }
-                finally
-                {
-                    host.Exit();
-                }
-            }
-        }
+            // When the import filename doesn't match, it should be appended (and update the skin.ini).
+            Assert.That(imported.Name, Is.EqualTo("test skin [skin]"));
+            Assert.That(imported.Creator, Is.EqualTo("skinner"));
+        });
 
         [Test]
-        public async Task TestImportTwiceWithSameMetadataButDifferentFilename()
+        public Task TestSingleImportMatchingFilename() => runSkinTest(async osu =>
         {
-            using (HeadlessGameHost host = new CleanRunHeadlessGameHost(nameof(ImportSkinTest)))
-            {
-                try
-                {
-                    var osu = LoadOsuIntoHost(host);
+            var imported = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOsk("test skin", "skinner"), "test skin.osk"));
 
-                    var imported = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOsk("test skin", "skinner"), "skin.osk"));
-                    var imported2 = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOsk("test skin", "skinner"), "skin2.osk"));
+            // When the import filename matches it shouldn't be appended.
+            Assert.That(imported.Name, Is.EqualTo("test skin"));
+            Assert.That(imported.Creator, Is.EqualTo("skinner"));
+        });
 
-                    Assert.That(imported2.ID, Is.Not.EqualTo(imported.ID));
-                    Assert.That(osu.Dependencies.Get<SkinManager>().GetAllUserSkins(true).Count, Is.EqualTo(2));
+        #endregion
 
-                    // skin.ini will be rewritten and therefore not match.
-                    Assert.That(imported.Files.First().FileInfoID, Is.Not.EqualTo(imported2.Files.First().FileInfoID));
-                }
-                finally
-                {
-                    host.Exit();
-                }
-            }
-        }
+        #region Cases where imports should match existing
 
         [Test]
-        public async Task TestImportTwiceWithNoMetadata()
+        public Task TestImportTwiceWithSameMetadataAndFilename() => runSkinTest(async osu =>
         {
-            using (HeadlessGameHost host = new CleanRunHeadlessGameHost(nameof(ImportSkinTest)))
-            {
-                try
-                {
-                    var osu = LoadOsuIntoHost(host);
+            var imported = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOsk("test skin", "skinner"), "skin.osk"));
+            var imported2 = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOsk("test skin", "skinner"), "skin.osk"));
 
-                    // if a user downloads two skins that do have skin.ini files but don't have any creator metadata in the skin.ini, they should both import separately just for safety.
-                    var imported = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOsk(string.Empty, string.Empty), "download.osk"));
-                    var imported2 = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOsk(string.Empty, string.Empty), "download.osk"));
-
-                    Assert.That(imported2.ID, Is.Not.EqualTo(imported.ID));
-                    Assert.That(osu.Dependencies.Get<SkinManager>().GetAllUserSkins(true).Count, Is.EqualTo(2));
-
-                    Assert.That(osu.Dependencies.Get<SkinManager>().GetAllUserSkins(true).First().Files.First().FileInfoID, Is.EqualTo(imported.Files.First().FileInfoID));
-                    Assert.That(osu.Dependencies.Get<SkinManager>().GetAllUserSkins(true).Last().Files.First().FileInfoID, Is.EqualTo(imported2.Files.First().FileInfoID));
-                }
-                finally
-                {
-                    host.Exit();
-                }
-            }
-        }
+            assertImportedOnce(imported, imported2);
+        });
 
         [Test]
-        public async Task TestImportTwiceWithDifferentMetadata()
+        public Task TestImportTwiceWithNoMetadataSameDownloadFilename() => runSkinTest(async osu =>
         {
-            using (HeadlessGameHost host = new CleanRunHeadlessGameHost(nameof(ImportSkinTest)))
-            {
-                try
-                {
-                    var osu = LoadOsuIntoHost(host);
+            // if a user downloads two skins that do have skin.ini files but don't have any creator metadata in the skin.ini, they should both import separately just for safety.
+            var imported = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOsk(string.Empty, string.Empty), "download.osk"));
+            var imported2 = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOsk(string.Empty, string.Empty), "download.osk"));
 
-                    var imported = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOsk("test skin v2", "skinner"), "skin.osk"));
-                    var imported2 = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOsk("test skin v2.1", "skinner"), "skin2.osk"));
-
-                    Assert.That(imported2.ID, Is.Not.EqualTo(imported.ID));
-                    Assert.That(osu.Dependencies.Get<SkinManager>().GetAllUserSkins(true).Count, Is.EqualTo(2));
-
-                    Assert.That(osu.Dependencies.Get<SkinManager>().GetAllUserSkins(true).First().Files.First().FileInfoID, Is.EqualTo(imported.Files.First().FileInfoID));
-                    Assert.That(osu.Dependencies.Get<SkinManager>().GetAllUserSkins(true).Last().Files.First().FileInfoID, Is.EqualTo(imported2.Files.First().FileInfoID));
-                }
-                finally
-                {
-                    host.Exit();
-                }
-            }
-        }
+            assertImportedOnce(imported, imported2);
+        });
 
         [Test]
-        public async Task TestImportUpperCasedOskArchive()
+        public Task TestImportUpperCasedOskArchive() => runSkinTest(async osu =>
         {
-            using (HeadlessGameHost host = new CleanRunHeadlessGameHost(nameof(ImportSkinTest)))
-            {
-                try
-                {
-                    var osu = LoadOsuIntoHost(host);
+            var imported = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOsk("name 1", "author 1"), "name 1.OsK"));
+            assertCorrectMetadata(imported, "name 1", "author 1");
 
-                    var imported = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOsk("name 1", "author 1"), "skin1.OsK"));
+            var imported2 = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOsk("name 1", "author 1"), "name 1.oSK"));
 
-                    Assert.That(imported.Name, Is.EqualTo("name 1"));
-                    Assert.That(imported.Creator, Is.EqualTo("author 1"));
+            assertImportedOnce(imported, imported2);
+        });
 
-                    var imported2 = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOsk("name 1", "author 1"), "skin1.oSK"));
+        #endregion
 
-                    Assert.That(imported2.Hash, Is.EqualTo(imported.Hash));
-                }
-                finally
-                {
-                    host.Exit();
-                }
-            }
-        }
+        #region Cases where imports should be uniquely imported
 
         [Test]
-        public async Task TestSameMetadataNameDifferentFolderName()
+        public Task TestImportTwiceWithSameMetadataButDifferentFilename() => runSkinTest(async osu =>
         {
-            using (HeadlessGameHost host = new CleanRunHeadlessGameHost(nameof(ImportSkinTest)))
-            {
-                try
-                {
-                    var osu = LoadOsuIntoHost(host);
+            var imported = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOsk("test skin", "skinner"), "skin.osk"));
+            var imported2 = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOsk("test skin", "skinner"), "skin2.osk"));
 
-                    var imported = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOsk("name 1", "author 1", false), "my custom skin 1"));
-                    Assert.That(imported.Name, Is.EqualTo("name 1 [my custom skin 1]"));
-                    Assert.That(imported.Creator, Is.EqualTo("author 1"));
+            assertImportedBoth(imported, imported2);
+        });
 
-                    var imported2 = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOsk("name 1", "author 1", false), "my custom skin 2"));
-                    Assert.That(imported2.Name, Is.EqualTo("name 1 [my custom skin 2]"));
-                    Assert.That(imported2.Creator, Is.EqualTo("author 1"));
+        [Test]
+        public Task TestImportTwiceWithNoMetadataDifferentDownloadFilename() => runSkinTest(async osu =>
+        {
+            // if a user downloads two skins that do have skin.ini files but don't have any creator metadata in the skin.ini, they should both import separately just for safety.
+            var imported = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOsk(string.Empty, string.Empty), "download.osk"));
+            var imported2 = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOsk(string.Empty, string.Empty), "download2.osk"));
 
-                    Assert.That(imported2.Hash, Is.Not.EqualTo(imported.Hash));
-                }
-                finally
-                {
-                    host.Exit();
-                }
-            }
+            assertImportedBoth(imported, imported2);
+        });
+
+        [Test]
+        public Task TestImportTwiceWithSameFilenameDifferentMetadata() => runSkinTest(async osu =>
+        {
+            var imported = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOsk("test skin v2", "skinner"), "skin.osk"));
+            var imported2 = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOsk("test skin v2.1", "skinner"), "skin.osk"));
+
+            assertImportedBoth(imported, imported2);
+            assertCorrectMetadata(imported, "test skin v2 [skin]", "skinner");
+            assertCorrectMetadata(imported2, "test skin v2.1 [skin]", "skinner");
+        });
+
+        [Test]
+        public Task TestSameMetadataNameDifferentFolderName() => runSkinTest(async osu =>
+        {
+            var imported = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOsk("name 1", "author 1"), "my custom skin 1"));
+            var imported2 = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOsk("name 1", "author 1"), "my custom skin 2"));
+
+            assertImportedBoth(imported, imported2);
+            assertCorrectMetadata(imported, "name 1 [my custom skin 2]", "author 1");
+            assertCorrectMetadata(imported, "name 1 [my custom skin 2]", "author 1");
+        });
+
+        #endregion
+
+        private void assertCorrectMetadata(SkinInfo imported, string name, string creator)
+        {
+            Assert.That(imported.Name, Is.EqualTo(name));
+            Assert.That(imported.Creator, Is.EqualTo(creator));
         }
 
-        private MemoryStream createOsk(string name, string author, bool makeUnique = true)
+        private void assertImportedBoth(SkinInfo imported, SkinInfo imported2)
+        {
+            Assert.That(imported2.ID, Is.Not.EqualTo(imported.ID));
+            Assert.That(imported2.Hash, Is.Not.EqualTo(imported.Hash));
+            Assert.That(imported2.Files.Select(f => f.FileInfoID), Is.Not.EquivalentTo(imported.Files.Select(f => f.FileInfoID)));
+        }
+
+        private void assertImportedOnce(SkinInfo imported, SkinInfo imported2)
+        {
+            Assert.That(imported2.ID, Is.EqualTo(imported.ID));
+            Assert.That(imported2.Hash, Is.EqualTo(imported.Hash));
+            Assert.That(imported2.Files.Select(f => f.FileInfoID), Is.EquivalentTo(imported.Files.Select(f => f.FileInfoID)));
+        }
+
+        private MemoryStream createOsk(string name, string author, bool makeUnique = false)
         {
             var zipStream = new MemoryStream();
             using var zip = ZipArchive.Create();
@@ -218,6 +169,22 @@ namespace osu.Game.Tests.Skins.IO
             return stream;
         }
 
+        private async Task runSkinTest(Func<OsuGameBase, Task> action, [CallerMemberName] string callingMethodName = @"")
+        {
+            using (HeadlessGameHost host = new CleanRunHeadlessGameHost(callingMethodName))
+            {
+                try
+                {
+                    var osu = LoadOsuIntoHost(host);
+                    await action(osu);
+                }
+                finally
+                {
+                    host.Exit();
+                }
+            }
+        }
+
         private async Task<SkinInfo> loadSkinIntoOsu(OsuGameBase osu, ArchiveReader archive = null)
         {
             var skinManager = osu.Dependencies.Get<SkinManager>();

From 0b8edb081278561854bb16808b7c88e175f9094d Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Wed, 20 Oct 2021 17:50:02 +0900
Subject: [PATCH 0346/5547] Add english descriptions

---
 osu.Game/Online/Multiplayer/QueueModes.cs | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/osu.Game/Online/Multiplayer/QueueModes.cs b/osu.Game/Online/Multiplayer/QueueModes.cs
index 501c87c1cf..2a650c61dc 100644
--- a/osu.Game/Online/Multiplayer/QueueModes.cs
+++ b/osu.Game/Online/Multiplayer/QueueModes.cs
@@ -1,13 +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.ComponentModel;
+
 namespace osu.Game.Online.Multiplayer
 {
     public enum QueueModes
     {
         // used for osu-web deserialization so names shouldn't be changed.
 
+        [Description("Host pick")]
         HostPick,
+
+        [Description("Karaoke")]
         Karaoke,
     }
 }

From bc57190fb41b0db23483f76aba0c5d58fceabcf9 Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Wed, 20 Oct 2021 17:52:05 +0900
Subject: [PATCH 0347/5547] Make dropdown not move the selection control

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

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs
index 9049d315fb..a36034a026 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs
@@ -193,9 +193,14 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
                                                                 },
                                                                 new Section("Beatmap queueing mode")
                                                                 {
-                                                                    Child = QueueModeDropdown = new OsuEnumDropdown<QueueModes>
+                                                                    Child = new Container
                                                                     {
-                                                                        RelativeSizeAxes = Axes.X
+                                                                        RelativeSizeAxes = Axes.X,
+                                                                        Height = 40,
+                                                                        Child = QueueModeDropdown = new OsuEnumDropdown<QueueModes>
+                                                                        {
+                                                                            RelativeSizeAxes = Axes.X
+                                                                        }
                                                                     }
                                                                 }
                                                             },
@@ -235,7 +240,8 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
                                                     Anchor = Anchor.TopCentre,
                                                     Origin = Anchor.TopCentre,
                                                     RelativeSizeAxes = Axes.X,
-                                                    Width = 0.5f
+                                                    Width = 0.5f,
+                                                    Depth = float.MaxValue
                                                 }
                                             }
                                         }

From 0e446105fbb6c9bc9cd0c906d8ffd0a2161c524a Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Wed, 20 Oct 2021 17:52:51 +0900
Subject: [PATCH 0348/5547] Rename to "picking mode" as simpler english

---
 .../Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs        | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs
index a36034a026..fa9e2834c1 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs
@@ -191,7 +191,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
                                                                         },
                                                                     },
                                                                 },
-                                                                new Section("Beatmap queueing mode")
+                                                                new Section("Picking mode")
                                                                 {
                                                                     Child = new Container
                                                                     {

From a95c754fd3d0e867d7910fe3f2a746a10261329b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 20 Oct 2021 16:49:58 +0900
Subject: [PATCH 0349/5547] Fix multiple issues and make metadata fallback
 process more logical

---
 osu.Game/Skinning/SkinManager.cs | 49 +++++++++++++++-----------------
 1 file changed, 23 insertions(+), 26 deletions(-)

diff --git a/osu.Game/Skinning/SkinManager.cs b/osu.Game/Skinning/SkinManager.cs
index 9c7ea28cc4..452c081a41 100644
--- a/osu.Game/Skinning/SkinManager.cs
+++ b/osu.Game/Skinning/SkinManager.cs
@@ -140,26 +140,19 @@ namespace osu.Game.Skinning
             // This function can be run on fresh import or save. The logic here ensures a skin.ini file is in a good state for both operations.
 
             // LegacySkin will parse the skin.ini and populate `Skin.Configuration` during construction above.
-            bool hasSkinIni = !string.IsNullOrEmpty(instance.Configuration.SkinInfo.Name);
-
-            if (hasSkinIni)
-            {
-                item.Name = instance.Configuration.SkinInfo.Name;
-                item.Creator = instance.Configuration.SkinInfo.Creator;
-            }
-
-            item.Creator ??= unknown_creator_string;
+            string skinIniSourcedName = instance.Configuration.SkinInfo.Name;
+            string archiveName = item.Name.Replace(".osk", "", StringComparison.OrdinalIgnoreCase);
 
             bool isImport = reader != null;
 
             if (isImport)
             {
+                item.Name = !string.IsNullOrEmpty(skinIniSourcedName) ? skinIniSourcedName : archiveName;
+                item.Creator = instance.Configuration.SkinInfo.Creator ?? unknown_creator_string;
+
                 // For imports, we want to use the archive or folder name as part of the metadata, in addition to any existing skin.ini metadata.
                 // In an ideal world, skin.ini would be the only source of metadata, but a lot of skin creators and users don't update it when making modifications.
                 // In both of these cases, the expectation from the user is that the filename or folder name is displayed somewhere to identify the skin.
-
-                string archiveName = item.Name.Replace(".osk", "", StringComparison.OrdinalIgnoreCase);
-
                 if (archiveName != item.Name)
                     item.Name = $"{item.Name} [{archiveName}]";
             }
@@ -167,26 +160,26 @@ namespace osu.Game.Skinning
             // By this point, the metadata in SkinInfo will be correct.
             // Regardless of whether this is an import or not, let's write the skin.ini if non-existing or non-matching.
             // This is (weirdly) done inside ComputeHash to avoid adding a new method to handle this case. After switching to realm it can be moved into another place.
-            if (instance.Configuration.SkinInfo.Name != item.Name)
-                updateSkinIniMetadata(item, hasSkinIni);
+            if (skinIniSourcedName != item.Name)
+                updateSkinIniMetadata(item);
 
             return base.ComputeHash(item, reader);
         }
 
-        private void updateSkinIniMetadata(SkinInfo item, bool hasSkinIni)
+        private void updateSkinIniMetadata(SkinInfo item)
         {
             string nameLine = $"Name: {item.Name}";
-            string authorLine = $"Author: {item.Name}";
+            string authorLine = $"Author: {item.Creator}";
 
-            if (hasSkinIni)
+            var existingFile = item.Files.SingleOrDefault(f => f.Filename == "skin.ini");
+
+            if (existingFile != null)
             {
                 List<string> outputLines = new List<string>();
 
                 bool addedName = false;
                 bool addedAuthor = false;
 
-                var existingFile = item.Files.First(f => f.Filename == "skin.ini");
-
                 using (var stream = Files.Storage.GetStream(existingFile.FileInfo.StoragePath))
                 using (var sr = new StreamReader(stream))
                 {
@@ -220,10 +213,12 @@ namespace osu.Game.Skinning
                 }
 
                 using (Stream stream = new MemoryStream())
-                using (var sw = new StreamWriter(stream, Encoding.UTF8, 1024, true))
                 {
-                    foreach (string line in outputLines)
-                        sw.WriteLine(line);
+                    using (var sw = new StreamWriter(stream, Encoding.UTF8, 1024, true))
+                    {
+                        foreach (string line in outputLines)
+                            sw.WriteLine(line);
+                    }
 
                     ReplaceFile(item, existingFile, stream);
                 }
@@ -231,11 +226,13 @@ namespace osu.Game.Skinning
             else
             {
                 using (Stream stream = new MemoryStream())
-                using (var sw = new StreamWriter(stream, Encoding.UTF8, 1024, true))
                 {
-                    sw.WriteLine("[General]");
-                    sw.WriteLine(nameLine);
-                    sw.WriteLine(authorLine);
+                    using (var sw = new StreamWriter(stream, Encoding.UTF8, 1024, true))
+                    {
+                        sw.WriteLine("[General]");
+                        sw.WriteLine(nameLine);
+                        sw.WriteLine(authorLine);
+                    }
 
                     AddFile(item, stream, "skin.ini");
                 }

From 602303e9470225f1a57f647fb648331a1150a10e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 20 Oct 2021 17:03:30 +0900
Subject: [PATCH 0350/5547] Add test coverage for `skin.ini` contents

---
 osu.Game.Tests/Skins/IO/ImportSkinTest.cs | 103 ++++++++++++++++------
 osu.Game/Skinning/SkinManager.cs          |   4 +
 2 files changed, 80 insertions(+), 27 deletions(-)

diff --git a/osu.Game.Tests/Skins/IO/ImportSkinTest.cs b/osu.Game.Tests/Skins/IO/ImportSkinTest.cs
index 8449b0bbd3..67c5be0c2a 100644
--- a/osu.Game.Tests/Skins/IO/ImportSkinTest.cs
+++ b/osu.Game.Tests/Skins/IO/ImportSkinTest.cs
@@ -9,6 +9,7 @@ using System.Threading.Tasks;
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Platform;
+using osu.Game.IO;
 using osu.Game.IO.Archives;
 using osu.Game.Skinning;
 using SharpCompress.Archives.Zip;
@@ -22,21 +23,36 @@ namespace osu.Game.Tests.Skins.IO
         [Test]
         public Task TestSingleImportDifferentFilename() => runSkinTest(async osu =>
         {
-            var imported = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOsk("test skin", "skinner"), "skin.osk"));
+            var imported = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOskWithIni("test skin", "skinner"), "skin.osk"));
 
             // When the import filename doesn't match, it should be appended (and update the skin.ini).
-            Assert.That(imported.Name, Is.EqualTo("test skin [skin]"));
-            Assert.That(imported.Creator, Is.EqualTo("skinner"));
+            assertCorrectMetadata(imported, "test skin [skin]", "skinner", osu);
         });
 
         [Test]
         public Task TestSingleImportMatchingFilename() => runSkinTest(async osu =>
         {
-            var imported = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOsk("test skin", "skinner"), "test skin.osk"));
+            var imported = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOskWithIni("test skin", "skinner"), "test skin.osk"));
 
             // When the import filename matches it shouldn't be appended.
-            Assert.That(imported.Name, Is.EqualTo("test skin"));
-            Assert.That(imported.Creator, Is.EqualTo("skinner"));
+            assertCorrectMetadata(imported, "test skin", "skinner", osu);
+        });
+
+        [Test]
+        public Task TestSingleImportNoIniFile() => runSkinTest(async osu =>
+        {
+            var imported = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOskWithNonIniFile(), "test skin.osk"));
+
+            // When the import filename matches it shouldn't be appended.
+            assertCorrectMetadata(imported, "test skin", "Unknown", osu);
+        });
+
+        [Test]
+        public Task TestEmptyImportFails() => runSkinTest(osu =>
+        {
+            Assert.ThrowsAsync<InvalidOperationException>(() => loadSkinIntoOsu(osu, new ZipArchiveReader(createEmptyOsk(), "test skin.osk")));
+
+            return Task.CompletedTask;
         });
 
         #endregion
@@ -46,8 +62,8 @@ namespace osu.Game.Tests.Skins.IO
         [Test]
         public Task TestImportTwiceWithSameMetadataAndFilename() => runSkinTest(async osu =>
         {
-            var imported = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOsk("test skin", "skinner"), "skin.osk"));
-            var imported2 = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOsk("test skin", "skinner"), "skin.osk"));
+            var imported = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOskWithIni("test skin", "skinner"), "skin.osk"));
+            var imported2 = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOskWithIni("test skin", "skinner"), "skin.osk"));
 
             assertImportedOnce(imported, imported2);
         });
@@ -56,8 +72,8 @@ namespace osu.Game.Tests.Skins.IO
         public Task TestImportTwiceWithNoMetadataSameDownloadFilename() => runSkinTest(async osu =>
         {
             // if a user downloads two skins that do have skin.ini files but don't have any creator metadata in the skin.ini, they should both import separately just for safety.
-            var imported = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOsk(string.Empty, string.Empty), "download.osk"));
-            var imported2 = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOsk(string.Empty, string.Empty), "download.osk"));
+            var imported = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOskWithIni(string.Empty, string.Empty), "download.osk"));
+            var imported2 = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOskWithIni(string.Empty, string.Empty), "download.osk"));
 
             assertImportedOnce(imported, imported2);
         });
@@ -65,14 +81,24 @@ namespace osu.Game.Tests.Skins.IO
         [Test]
         public Task TestImportUpperCasedOskArchive() => runSkinTest(async osu =>
         {
-            var imported = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOsk("name 1", "author 1"), "name 1.OsK"));
-            assertCorrectMetadata(imported, "name 1", "author 1");
+            var imported = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOskWithIni("name 1", "author 1"), "name 1.OsK"));
+            assertCorrectMetadata(imported, "name 1", "author 1", osu);
 
-            var imported2 = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOsk("name 1", "author 1"), "name 1.oSK"));
+            var imported2 = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOskWithIni("name 1", "author 1"), "name 1.oSK"));
 
             assertImportedOnce(imported, imported2);
         });
 
+        [Test]
+        public Task TestSameMetadataNameSameFolderName() => runSkinTest(async osu =>
+        {
+            var imported = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOskWithIni("name 1", "author 1"), "my custom skin 1"));
+            var imported2 = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOskWithIni("name 1", "author 1"), "my custom skin 1"));
+
+            assertImportedOnce(imported, imported2);
+            assertCorrectMetadata(imported, "name 1 [my custom skin 1]", "author 1", osu);
+        });
+
         #endregion
 
         #region Cases where imports should be uniquely imported
@@ -80,8 +106,8 @@ namespace osu.Game.Tests.Skins.IO
         [Test]
         public Task TestImportTwiceWithSameMetadataButDifferentFilename() => runSkinTest(async osu =>
         {
-            var imported = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOsk("test skin", "skinner"), "skin.osk"));
-            var imported2 = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOsk("test skin", "skinner"), "skin2.osk"));
+            var imported = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOskWithIni("test skin", "skinner"), "skin.osk"));
+            var imported2 = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOskWithIni("test skin", "skinner"), "skin2.osk"));
 
             assertImportedBoth(imported, imported2);
         });
@@ -90,8 +116,8 @@ namespace osu.Game.Tests.Skins.IO
         public Task TestImportTwiceWithNoMetadataDifferentDownloadFilename() => runSkinTest(async osu =>
         {
             // if a user downloads two skins that do have skin.ini files but don't have any creator metadata in the skin.ini, they should both import separately just for safety.
-            var imported = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOsk(string.Empty, string.Empty), "download.osk"));
-            var imported2 = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOsk(string.Empty, string.Empty), "download2.osk"));
+            var imported = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOskWithIni(string.Empty, string.Empty), "download.osk"));
+            var imported2 = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOskWithIni(string.Empty, string.Empty), "download2.osk"));
 
             assertImportedBoth(imported, imported2);
         });
@@ -99,31 +125,37 @@ namespace osu.Game.Tests.Skins.IO
         [Test]
         public Task TestImportTwiceWithSameFilenameDifferentMetadata() => runSkinTest(async osu =>
         {
-            var imported = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOsk("test skin v2", "skinner"), "skin.osk"));
-            var imported2 = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOsk("test skin v2.1", "skinner"), "skin.osk"));
+            var imported = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOskWithIni("test skin v2", "skinner"), "skin.osk"));
+            var imported2 = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOskWithIni("test skin v2.1", "skinner"), "skin.osk"));
 
             assertImportedBoth(imported, imported2);
-            assertCorrectMetadata(imported, "test skin v2 [skin]", "skinner");
-            assertCorrectMetadata(imported2, "test skin v2.1 [skin]", "skinner");
+            assertCorrectMetadata(imported, "test skin v2 [skin]", "skinner", osu);
+            assertCorrectMetadata(imported2, "test skin v2.1 [skin]", "skinner", osu);
         });
 
         [Test]
         public Task TestSameMetadataNameDifferentFolderName() => runSkinTest(async osu =>
         {
-            var imported = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOsk("name 1", "author 1"), "my custom skin 1"));
-            var imported2 = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOsk("name 1", "author 1"), "my custom skin 2"));
+            var imported = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOskWithIni("name 1", "author 1"), "my custom skin 1"));
+            var imported2 = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOskWithIni("name 1", "author 1"), "my custom skin 2"));
 
             assertImportedBoth(imported, imported2);
-            assertCorrectMetadata(imported, "name 1 [my custom skin 2]", "author 1");
-            assertCorrectMetadata(imported, "name 1 [my custom skin 2]", "author 1");
+            assertCorrectMetadata(imported, "name 1 [my custom skin 1]", "author 1", osu);
+            assertCorrectMetadata(imported2, "name 1 [my custom skin 2]", "author 1", osu);
         });
 
         #endregion
 
-        private void assertCorrectMetadata(SkinInfo imported, string name, string creator)
+        private void assertCorrectMetadata(SkinInfo imported, string name, string creator, OsuGameBase osu)
         {
             Assert.That(imported.Name, Is.EqualTo(name));
             Assert.That(imported.Creator, Is.EqualTo(creator));
+
+            // for extra safety let's reconstruct the skin, reading from the skin.ini.
+            var instance = imported.CreateInstance((IStorageResourceProvider)osu.Dependencies.Get(typeof(SkinManager)));
+
+            Assert.That(instance.Configuration.SkinInfo.Name, Is.EqualTo(name));
+            Assert.That(instance.Configuration.SkinInfo.Creator, Is.EqualTo(creator));
         }
 
         private void assertImportedBoth(SkinInfo imported, SkinInfo imported2)
@@ -140,7 +172,24 @@ namespace osu.Game.Tests.Skins.IO
             Assert.That(imported2.Files.Select(f => f.FileInfoID), Is.EquivalentTo(imported.Files.Select(f => f.FileInfoID)));
         }
 
-        private MemoryStream createOsk(string name, string author, bool makeUnique = false)
+        private MemoryStream createEmptyOsk()
+        {
+            var zipStream = new MemoryStream();
+            using var zip = ZipArchive.Create();
+            zip.SaveTo(zipStream);
+            return zipStream;
+        }
+
+        private MemoryStream createOskWithNonIniFile()
+        {
+            var zipStream = new MemoryStream();
+            using var zip = ZipArchive.Create();
+            zip.AddEntry("hitcircle.png", new MemoryStream(new byte[] { 0, 1, 2, 3 }));
+            zip.SaveTo(zipStream);
+            return zipStream;
+        }
+
+        private MemoryStream createOskWithIni(string name, string author, bool makeUnique = false)
         {
             var zipStream = new MemoryStream();
             using var zip = ZipArchive.Create();
diff --git a/osu.Game/Skinning/SkinManager.cs b/osu.Game/Skinning/SkinManager.cs
index 452c081a41..213c92c103 100644
--- a/osu.Game/Skinning/SkinManager.cs
+++ b/osu.Game/Skinning/SkinManager.cs
@@ -135,6 +135,10 @@ namespace osu.Game.Skinning
 
         protected override string ComputeHash(SkinInfo item, ArchiveReader reader = null)
         {
+            // we will be adding a hashable file below, but this is only useful if there are any other files in the skin.
+            if (item.Files.Count == 0)
+                throw new InvalidOperationException("Attempted to hash an archive with no files");
+
             var instance = GetSkin(item);
 
             // This function can be run on fresh import or save. The logic here ensures a skin.ini file is in a good state for both operations.

From 5f53dd80213c50eccb324c668109429584f94ec6 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 20 Oct 2021 17:12:44 +0900
Subject: [PATCH 0351/5547] Rename test variable for legibility

---
 osu.Game.Tests/Skins/IO/ImportSkinTest.cs | 98 +++++++++++------------
 1 file changed, 49 insertions(+), 49 deletions(-)

diff --git a/osu.Game.Tests/Skins/IO/ImportSkinTest.cs b/osu.Game.Tests/Skins/IO/ImportSkinTest.cs
index 67c5be0c2a..21e4948972 100644
--- a/osu.Game.Tests/Skins/IO/ImportSkinTest.cs
+++ b/osu.Game.Tests/Skins/IO/ImportSkinTest.cs
@@ -23,28 +23,28 @@ namespace osu.Game.Tests.Skins.IO
         [Test]
         public Task TestSingleImportDifferentFilename() => runSkinTest(async osu =>
         {
-            var imported = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOskWithIni("test skin", "skinner"), "skin.osk"));
+            var import1 = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOskWithIni("test skin", "skinner"), "skin.osk"));
 
             // When the import filename doesn't match, it should be appended (and update the skin.ini).
-            assertCorrectMetadata(imported, "test skin [skin]", "skinner", osu);
+            assertCorrectMetadata(import1, "test skin [skin]", "skinner", osu);
         });
 
         [Test]
         public Task TestSingleImportMatchingFilename() => runSkinTest(async osu =>
         {
-            var imported = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOskWithIni("test skin", "skinner"), "test skin.osk"));
+            var import1 = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOskWithIni("test skin", "skinner"), "test skin.osk"));
 
             // When the import filename matches it shouldn't be appended.
-            assertCorrectMetadata(imported, "test skin", "skinner", osu);
+            assertCorrectMetadata(import1, "test skin", "skinner", osu);
         });
 
         [Test]
         public Task TestSingleImportNoIniFile() => runSkinTest(async osu =>
         {
-            var imported = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOskWithNonIniFile(), "test skin.osk"));
+            var import1 = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOskWithNonIniFile(), "test skin.osk"));
 
             // When the import filename matches it shouldn't be appended.
-            assertCorrectMetadata(imported, "test skin", "Unknown", osu);
+            assertCorrectMetadata(import1, "test skin", "Unknown", osu);
         });
 
         [Test]
@@ -62,114 +62,114 @@ namespace osu.Game.Tests.Skins.IO
         [Test]
         public Task TestImportTwiceWithSameMetadataAndFilename() => runSkinTest(async osu =>
         {
-            var imported = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOskWithIni("test skin", "skinner"), "skin.osk"));
-            var imported2 = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOskWithIni("test skin", "skinner"), "skin.osk"));
+            var import1 = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOskWithIni("test skin", "skinner"), "skin.osk"));
+            var import2 = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOskWithIni("test skin", "skinner"), "skin.osk"));
 
-            assertImportedOnce(imported, imported2);
+            assertImportedOnce(import1, import2);
         });
 
         [Test]
         public Task TestImportTwiceWithNoMetadataSameDownloadFilename() => runSkinTest(async osu =>
         {
             // if a user downloads two skins that do have skin.ini files but don't have any creator metadata in the skin.ini, they should both import separately just for safety.
-            var imported = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOskWithIni(string.Empty, string.Empty), "download.osk"));
-            var imported2 = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOskWithIni(string.Empty, string.Empty), "download.osk"));
+            var import1 = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOskWithIni(string.Empty, string.Empty), "download.osk"));
+            var import2 = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOskWithIni(string.Empty, string.Empty), "download.osk"));
 
-            assertImportedOnce(imported, imported2);
+            assertImportedOnce(import1, import2);
         });
 
         [Test]
         public Task TestImportUpperCasedOskArchive() => runSkinTest(async osu =>
         {
-            var imported = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOskWithIni("name 1", "author 1"), "name 1.OsK"));
-            assertCorrectMetadata(imported, "name 1", "author 1", osu);
+            var import1 = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOskWithIni("name 1", "author 1"), "name 1.OsK"));
+            assertCorrectMetadata(import1, "name 1", "author 1", osu);
 
-            var imported2 = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOskWithIni("name 1", "author 1"), "name 1.oSK"));
+            var import2 = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOskWithIni("name 1", "author 1"), "name 1.oSK"));
 
-            assertImportedOnce(imported, imported2);
+            assertImportedOnce(import1, import2);
         });
 
         [Test]
         public Task TestSameMetadataNameSameFolderName() => runSkinTest(async osu =>
         {
-            var imported = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOskWithIni("name 1", "author 1"), "my custom skin 1"));
-            var imported2 = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOskWithIni("name 1", "author 1"), "my custom skin 1"));
+            var import1 = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOskWithIni("name 1", "author 1"), "my custom skin 1"));
+            var import2 = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOskWithIni("name 1", "author 1"), "my custom skin 1"));
 
-            assertImportedOnce(imported, imported2);
-            assertCorrectMetadata(imported, "name 1 [my custom skin 1]", "author 1", osu);
+            assertImportedOnce(import1, import2);
+            assertCorrectMetadata(import1, "name 1 [my custom skin 1]", "author 1", osu);
         });
 
         #endregion
 
-        #region Cases where imports should be uniquely imported
+        #region Cases where imports should be uniquely import1
 
         [Test]
         public Task TestImportTwiceWithSameMetadataButDifferentFilename() => runSkinTest(async osu =>
         {
-            var imported = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOskWithIni("test skin", "skinner"), "skin.osk"));
-            var imported2 = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOskWithIni("test skin", "skinner"), "skin2.osk"));
+            var import1 = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOskWithIni("test skin", "skinner"), "skin.osk"));
+            var import2 = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOskWithIni("test skin", "skinner"), "skin2.osk"));
 
-            assertImportedBoth(imported, imported2);
+            assertImportedBoth(import1, import2);
         });
 
         [Test]
         public Task TestImportTwiceWithNoMetadataDifferentDownloadFilename() => runSkinTest(async osu =>
         {
             // if a user downloads two skins that do have skin.ini files but don't have any creator metadata in the skin.ini, they should both import separately just for safety.
-            var imported = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOskWithIni(string.Empty, string.Empty), "download.osk"));
-            var imported2 = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOskWithIni(string.Empty, string.Empty), "download2.osk"));
+            var import1 = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOskWithIni(string.Empty, string.Empty), "download.osk"));
+            var import2 = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOskWithIni(string.Empty, string.Empty), "download2.osk"));
 
-            assertImportedBoth(imported, imported2);
+            assertImportedBoth(import1, import2);
         });
 
         [Test]
         public Task TestImportTwiceWithSameFilenameDifferentMetadata() => runSkinTest(async osu =>
         {
-            var imported = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOskWithIni("test skin v2", "skinner"), "skin.osk"));
-            var imported2 = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOskWithIni("test skin v2.1", "skinner"), "skin.osk"));
+            var import1 = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOskWithIni("test skin v2", "skinner"), "skin.osk"));
+            var import2 = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOskWithIni("test skin v2.1", "skinner"), "skin.osk"));
 
-            assertImportedBoth(imported, imported2);
-            assertCorrectMetadata(imported, "test skin v2 [skin]", "skinner", osu);
-            assertCorrectMetadata(imported2, "test skin v2.1 [skin]", "skinner", osu);
+            assertImportedBoth(import1, import2);
+            assertCorrectMetadata(import1, "test skin v2 [skin]", "skinner", osu);
+            assertCorrectMetadata(import2, "test skin v2.1 [skin]", "skinner", osu);
         });
 
         [Test]
         public Task TestSameMetadataNameDifferentFolderName() => runSkinTest(async osu =>
         {
-            var imported = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOskWithIni("name 1", "author 1"), "my custom skin 1"));
-            var imported2 = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOskWithIni("name 1", "author 1"), "my custom skin 2"));
+            var import1 = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOskWithIni("name 1", "author 1"), "my custom skin 1"));
+            var import2 = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOskWithIni("name 1", "author 1"), "my custom skin 2"));
 
-            assertImportedBoth(imported, imported2);
-            assertCorrectMetadata(imported, "name 1 [my custom skin 1]", "author 1", osu);
-            assertCorrectMetadata(imported2, "name 1 [my custom skin 2]", "author 1", osu);
+            assertImportedBoth(import1, import2);
+            assertCorrectMetadata(import1, "name 1 [my custom skin 1]", "author 1", osu);
+            assertCorrectMetadata(import2, "name 1 [my custom skin 2]", "author 1", osu);
         });
 
         #endregion
 
-        private void assertCorrectMetadata(SkinInfo imported, string name, string creator, OsuGameBase osu)
+        private void assertCorrectMetadata(SkinInfo import1, string name, string creator, OsuGameBase osu)
         {
-            Assert.That(imported.Name, Is.EqualTo(name));
-            Assert.That(imported.Creator, Is.EqualTo(creator));
+            Assert.That(import1.Name, Is.EqualTo(name));
+            Assert.That(import1.Creator, Is.EqualTo(creator));
 
             // for extra safety let's reconstruct the skin, reading from the skin.ini.
-            var instance = imported.CreateInstance((IStorageResourceProvider)osu.Dependencies.Get(typeof(SkinManager)));
+            var instance = import1.CreateInstance((IStorageResourceProvider)osu.Dependencies.Get(typeof(SkinManager)));
 
             Assert.That(instance.Configuration.SkinInfo.Name, Is.EqualTo(name));
             Assert.That(instance.Configuration.SkinInfo.Creator, Is.EqualTo(creator));
         }
 
-        private void assertImportedBoth(SkinInfo imported, SkinInfo imported2)
+        private void assertImportedBoth(SkinInfo import1, SkinInfo import2)
         {
-            Assert.That(imported2.ID, Is.Not.EqualTo(imported.ID));
-            Assert.That(imported2.Hash, Is.Not.EqualTo(imported.Hash));
-            Assert.That(imported2.Files.Select(f => f.FileInfoID), Is.Not.EquivalentTo(imported.Files.Select(f => f.FileInfoID)));
+            Assert.That(import2.ID, Is.Not.EqualTo(import1.ID));
+            Assert.That(import2.Hash, Is.Not.EqualTo(import1.Hash));
+            Assert.That(import2.Files.Select(f => f.FileInfoID), Is.Not.EquivalentTo(import1.Files.Select(f => f.FileInfoID)));
         }
 
-        private void assertImportedOnce(SkinInfo imported, SkinInfo imported2)
+        private void assertImportedOnce(SkinInfo import1, SkinInfo import2)
         {
-            Assert.That(imported2.ID, Is.EqualTo(imported.ID));
-            Assert.That(imported2.Hash, Is.EqualTo(imported.Hash));
-            Assert.That(imported2.Files.Select(f => f.FileInfoID), Is.EquivalentTo(imported.Files.Select(f => f.FileInfoID)));
+            Assert.That(import2.ID, Is.EqualTo(import1.ID));
+            Assert.That(import2.Hash, Is.EqualTo(import1.Hash));
+            Assert.That(import2.Files.Select(f => f.FileInfoID), Is.EquivalentTo(import1.Files.Select(f => f.FileInfoID)));
         }
 
         private MemoryStream createEmptyOsk()

From 9e6e41d7c06c09e671c3274ef7f56a75cfd09f1e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 20 Oct 2021 17:33:36 +0900
Subject: [PATCH 0352/5547] Add migration to reset and repopulate existing skin
 hashes

---
 osu.Game/Database/ArchiveModelManager.cs      | 11 +++++----
 .../20211020081609_ResetSkinHashes.cs         | 23 +++++++++++++++++++
 osu.Game/Skinning/SkinManager.cs              | 22 ++++++++++++++++++
 3 files changed, 52 insertions(+), 4 deletions(-)
 create mode 100644 osu.Game/Migrations/20211020081609_ResetSkinHashes.cs

diff --git a/osu.Game/Database/ArchiveModelManager.cs b/osu.Game/Database/ArchiveModelManager.cs
index 5b07bfe9a5..63a5da79a7 100644
--- a/osu.Game/Database/ArchiveModelManager.cs
+++ b/osu.Game/Database/ArchiveModelManager.cs
@@ -32,7 +32,7 @@ namespace osu.Game.Database
     /// <typeparam name="TFileModel">The associated file join type.</typeparam>
     public abstract class ArchiveModelManager<TModel, TFileModel> : IModelManager<TModel>, IModelFileManager<TModel, TFileModel>
         where TModel : class, IHasFiles<TFileModel>, IHasPrimaryKey, ISoftDelete
-        where TFileModel : class, INamedFileInfo, new()
+        where TFileModel : class, INamedFileInfo, IHasPrimaryKey, new()
     {
         private const int import_queue_request_concurrency = 1;
 
@@ -520,9 +520,12 @@ namespace osu.Game.Database
                     {
                         Files.Dereference(file.FileInfo);
 
-                        // This shouldn't be required, but here for safety in case the provided TModel is not being change tracked
-                        // Definitely can be removed once we rework the database backend.
-                        usage.Context.Set<TFileModel>().Remove(file);
+                        if (file.ID > 0)
+                        {
+                            // This shouldn't be required, but here for safety in case the provided TModel is not being change tracked
+                            // Definitely can be removed once we rework the database backend.
+                            usage.Context.Set<TFileModel>().Remove(file);
+                        }
                     }
 
                     model.Files.Remove(file);
diff --git a/osu.Game/Migrations/20211020081609_ResetSkinHashes.cs b/osu.Game/Migrations/20211020081609_ResetSkinHashes.cs
new file mode 100644
index 0000000000..6d53c019ec
--- /dev/null
+++ b/osu.Game/Migrations/20211020081609_ResetSkinHashes.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 Microsoft.EntityFrameworkCore.Infrastructure;
+using Microsoft.EntityFrameworkCore.Migrations;
+using osu.Game.Database;
+
+namespace osu.Game.Migrations
+{
+    [DbContext(typeof(OsuDbContext))]
+    [Migration("20211020081609_ResetSkinHashes")]
+    public partial class ResetSkinHashes : Migration
+    {
+        protected override void Up(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.Sql($"UPDATE SkinInfo SET Hash = null");
+        }
+
+        protected override void Down(MigrationBuilder migrationBuilder)
+        {
+        }
+    }
+}
diff --git a/osu.Game/Skinning/SkinManager.cs b/osu.Game/Skinning/SkinManager.cs
index 213c92c103..0b611bfe8f 100644
--- a/osu.Game/Skinning/SkinManager.cs
+++ b/osu.Game/Skinning/SkinManager.cs
@@ -18,6 +18,7 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.OpenGL.Textures;
 using osu.Framework.Graphics.Textures;
 using osu.Framework.IO.Stores;
+using osu.Framework.Logging;
 using osu.Framework.Platform;
 using osu.Framework.Testing;
 using osu.Framework.Utils;
@@ -84,6 +85,27 @@ namespace osu.Game.Skinning
 
                 SourceChanged?.Invoke();
             };
+
+            // can be removed 20220420.
+            populateMissingHashes();
+        }
+
+        private void populateMissingHashes()
+        {
+            var skinsWithoutHashes = ModelStore.ConsumableItems.Where(i => i.Hash == null).ToArray();
+
+            foreach (SkinInfo skin in skinsWithoutHashes)
+            {
+                try
+                {
+                    Update(skin);
+                }
+                catch (Exception e)
+                {
+                    Delete(skin);
+                    Logger.Error(e, $"Existing skin {skin} has been deleted during hash recomputation due to being invalid");
+                }
+            }
         }
 
         protected override bool ShouldDeleteArchive(string path) => Path.GetExtension(path)?.ToLowerInvariant() == ".osk";

From 68c01fc20442312cd09a27c29194c2fb3774be35 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 20 Oct 2021 17:34:09 +0900
Subject: [PATCH 0353/5547] Fix infinite loop on default skin (it can't have a
 `skin.ini`)

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

diff --git a/osu.Game/Skinning/SkinManager.cs b/osu.Game/Skinning/SkinManager.cs
index 0b611bfe8f..afa411a15b 100644
--- a/osu.Game/Skinning/SkinManager.cs
+++ b/osu.Game/Skinning/SkinManager.cs
@@ -186,7 +186,7 @@ namespace osu.Game.Skinning
             // By this point, the metadata in SkinInfo will be correct.
             // Regardless of whether this is an import or not, let's write the skin.ini if non-existing or non-matching.
             // This is (weirdly) done inside ComputeHash to avoid adding a new method to handle this case. After switching to realm it can be moved into another place.
-            if (skinIniSourcedName != item.Name)
+            if (instance is LegacySkin && skinIniSourcedName != item.Name)
                 updateSkinIniMetadata(item);
 
             return base.ComputeHash(item, reader);

From fd01a226db28023a06b578d37b1f3bdd7962b23a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 20 Oct 2021 18:11:33 +0900
Subject: [PATCH 0354/5547] Remove redundant parenthesis
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>
---
 .../Visual/Multiplayer/TestSceneDrawableLoungeRoom.cs           | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableLoungeRoom.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableLoungeRoom.cs
index 6d969b6a83..ea895a23d2 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableLoungeRoom.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableLoungeRoom.cs
@@ -63,7 +63,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     RelativeSizeAxes = Axes.Both,
                     Children = new Drawable[]
                     {
-                        searchTextBox = new SearchTextBox()
+                        searchTextBox = new SearchTextBox
                         {
                             HoldFocus = true,
                             Anchor = Anchor.TopCentre,

From 599867a3b172206e0bd321513d634149d119511c Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Wed, 20 Oct 2021 20:25:06 +0900
Subject: [PATCH 0355/5547] Add implementation to settings overlay

---
 .../Online/Multiplayer/MultiplayerClient.cs   |  5 ++++-
 .../Match/MultiplayerMatchSettingsOverlay.cs  | 20 ++++++++++++-------
 2 files changed, 17 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Online/Multiplayer/MultiplayerClient.cs b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
index 28505f6b0e..7701e217c6 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
@@ -212,7 +212,9 @@ namespace osu.Game.Online.Multiplayer
         /// <param name="password">The new password, if any.</param>
         /// <param name="matchType">The type of the match, if any.</param>
         /// <param name="item">The new room playlist item, if any.</param>
-        public Task ChangeSettings(Optional<string> name = default, Optional<string> password = default, Optional<MatchType> matchType = default, Optional<PlaylistItem> item = default)
+        /// <param name="queueMode">The new queue mode, if any.</param>
+        public Task ChangeSettings(Optional<string> name = default, Optional<string> password = default, Optional<MatchType> matchType = default, Optional<PlaylistItem> item = default,
+                                   Optional<QueueModes> queueMode = default)
         {
             if (Room == null)
                 throw new InvalidOperationException("Must be joined to a match to change settings.");
@@ -239,6 +241,7 @@ namespace osu.Game.Online.Multiplayer
                 BeatmapChecksum = item.GetOr(existingPlaylistItem).Beatmap.Value.MD5Hash,
                 RulesetID = item.GetOr(existingPlaylistItem).RulesetID,
                 MatchType = matchType.GetOr(Room.Settings.MatchType),
+                QueueMode = queueMode.GetOr(Room.Settings.QueueMode),
                 RequiredMods = item.HasValue ? item.Value.AsNonNull().RequiredMods.Select(m => new APIMod(m)).ToList() : Room.Settings.RequiredMods,
                 AllowedMods = item.HasValue ? item.Value.AsNonNull().AllowedMods.Select(m => new APIMod(m)).ToList() : Room.Settings.AllowedMods,
             });
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs
index fa9e2834c1..33c033486e 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs
@@ -339,13 +339,18 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
                 // Otherwise, update the room directly in preparation for it to be submitted to the API on match creation.
                 if (client.Room != null)
                 {
-                    client.ChangeSettings(name: NameField.Text, password: PasswordTextBox.Text, matchType: TypePicker.Current.Value).ContinueWith(t => Schedule(() =>
-                    {
-                        if (t.IsCompletedSuccessfully)
-                            onSuccess(room);
-                        else
-                            onError(t.Exception?.AsSingular().Message ?? "Error changing settings.");
-                    }));
+                    client.ChangeSettings(
+                              name: NameField.Text,
+                              password: PasswordTextBox.Text,
+                              matchType: TypePicker.Current.Value,
+                              queueMode: QueueModeDropdown.Current.Value)
+                          .ContinueWith(t => Schedule(() =>
+                          {
+                              if (t.IsCompletedSuccessfully)
+                                  onSuccess(room);
+                              else
+                                  onError(t.Exception?.AsSingular().Message ?? "Error changing settings.");
+                          }));
                 }
                 else
                 {
@@ -353,6 +358,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
                     room.Availability.Value = AvailabilityPicker.Current.Value;
                     room.Type.Value = TypePicker.Current.Value;
                     room.Password.Value = PasswordTextBox.Current.Value;
+                    room.QueueMode.Value = QueueModeDropdown.Current.Value;
 
                     if (int.TryParse(MaxParticipantsField.Text, out int max))
                         room.MaxParticipants.Value = max;

From 67090fc59845b17a41bba2f2555e11db0c0498bf Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Wed, 20 Oct 2021 20:52:16 +0900
Subject: [PATCH 0356/5547] Re-namespace enum

---
 osu.Game/Online/Multiplayer/MultiplayerClient.cs                | 1 +
 osu.Game/Online/Multiplayer/MultiplayerRoomSettings.cs          | 1 +
 osu.Game/Online/Multiplayer/{ => Queueing}/QueueModes.cs        | 2 +-
 osu.Game/Online/Rooms/Room.cs                                   | 2 +-
 .../Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs        | 1 +
 5 files changed, 5 insertions(+), 2 deletions(-)
 rename osu.Game/Online/Multiplayer/{ => Queueing}/QueueModes.cs (89%)

diff --git a/osu.Game/Online/Multiplayer/MultiplayerClient.cs b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
index 7701e217c6..31fa7b1e0d 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
@@ -17,6 +17,7 @@ using osu.Framework.Logging;
 using osu.Game.Beatmaps;
 using osu.Game.Database;
 using osu.Game.Online.API;
+using osu.Game.Online.Multiplayer.Queueing;
 using osu.Game.Online.Rooms;
 using osu.Game.Online.Rooms.RoomStatuses;
 using osu.Game.Rulesets;
diff --git a/osu.Game/Online/Multiplayer/MultiplayerRoomSettings.cs b/osu.Game/Online/Multiplayer/MultiplayerRoomSettings.cs
index d244e69a6b..af8ee96693 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerRoomSettings.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerRoomSettings.cs
@@ -8,6 +8,7 @@ using System.Collections.Generic;
 using System.Linq;
 using MessagePack;
 using osu.Game.Online.API;
+using osu.Game.Online.Multiplayer.Queueing;
 using osu.Game.Online.Rooms;
 
 namespace osu.Game.Online.Multiplayer
diff --git a/osu.Game/Online/Multiplayer/QueueModes.cs b/osu.Game/Online/Multiplayer/Queueing/QueueModes.cs
similarity index 89%
rename from osu.Game/Online/Multiplayer/QueueModes.cs
rename to osu.Game/Online/Multiplayer/Queueing/QueueModes.cs
index 2a650c61dc..cb1e765891 100644
--- a/osu.Game/Online/Multiplayer/QueueModes.cs
+++ b/osu.Game/Online/Multiplayer/Queueing/QueueModes.cs
@@ -3,7 +3,7 @@
 
 using System.ComponentModel;
 
-namespace osu.Game.Online.Multiplayer
+namespace osu.Game.Online.Multiplayer.Queueing
 {
     public enum QueueModes
     {
diff --git a/osu.Game/Online/Rooms/Room.cs b/osu.Game/Online/Rooms/Room.cs
index fe410208cc..875cdeeb8c 100644
--- a/osu.Game/Online/Rooms/Room.cs
+++ b/osu.Game/Online/Rooms/Room.cs
@@ -7,7 +7,7 @@ using Newtonsoft.Json;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Game.IO.Serialization.Converters;
-using osu.Game.Online.Multiplayer;
+using osu.Game.Online.Multiplayer.Queueing;
 using osu.Game.Online.Rooms.RoomStatuses;
 using osu.Game.Users;
 using osu.Game.Utils;
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs
index 33c033486e..4231aeae87 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs
@@ -17,6 +17,7 @@ using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Online.Multiplayer;
+using osu.Game.Online.Multiplayer.Queueing;
 using osu.Game.Online.Rooms;
 using osu.Game.Overlays;
 using osu.Game.Rulesets;

From 691e414acb514133fc23eeb727f67ffe74fa2b21 Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Wed, 20 Oct 2021 21:08:58 +0900
Subject: [PATCH 0357/5547] Add request to add a new playlist item

---
 .../Online/Multiplayer/MatchUserRequest.cs    |  2 ++
 .../Online/Multiplayer/MultiplayerClient.cs   | 24 +--------------
 .../Queueing/AddPlaylistItemRequest.cs        | 30 +++++++++++++++++++
 .../Online/SignalRUnionWorkaroundResolver.cs  |  2 ++
 .../Multiplayer/MultiplayerMatchSongSelect.cs | 12 +++++++-
 5 files changed, 46 insertions(+), 24 deletions(-)
 create mode 100644 osu.Game/Online/Multiplayer/Queueing/AddPlaylistItemRequest.cs

diff --git a/osu.Game/Online/Multiplayer/MatchUserRequest.cs b/osu.Game/Online/Multiplayer/MatchUserRequest.cs
index 8c6809e7f3..96e2bb3c15 100644
--- a/osu.Game/Online/Multiplayer/MatchUserRequest.cs
+++ b/osu.Game/Online/Multiplayer/MatchUserRequest.cs
@@ -4,6 +4,7 @@
 using System;
 using MessagePack;
 using osu.Game.Online.Multiplayer.MatchTypes.TeamVersus;
+using osu.Game.Online.Multiplayer.Queueing;
 
 namespace osu.Game.Online.Multiplayer
 {
@@ -13,6 +14,7 @@ namespace osu.Game.Online.Multiplayer
     [Serializable]
     [MessagePackObject]
     [Union(0, typeof(ChangeTeamRequest))] // IMPORTANT: Add rules to SignalRUnionWorkaroundResolver for new derived types.
+    [Union(1, typeof(AddPlaylistItemRequest))]
     public abstract class MatchUserRequest
     {
     }
diff --git a/osu.Game/Online/Multiplayer/MultiplayerClient.cs b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
index 31fa7b1e0d..eb581ad3fd 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
@@ -11,7 +11,6 @@ using System.Threading;
 using System.Threading.Tasks;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
-using osu.Framework.Extensions.ObjectExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Logging;
 using osu.Game.Beatmaps;
@@ -212,39 +211,18 @@ namespace osu.Game.Online.Multiplayer
         /// <param name="name">The new room name, if any.</param>
         /// <param name="password">The new password, if any.</param>
         /// <param name="matchType">The type of the match, if any.</param>
-        /// <param name="item">The new room playlist item, if any.</param>
         /// <param name="queueMode">The new queue mode, if any.</param>
-        public Task ChangeSettings(Optional<string> name = default, Optional<string> password = default, Optional<MatchType> matchType = default, Optional<PlaylistItem> item = default,
-                                   Optional<QueueModes> queueMode = default)
+        public Task ChangeSettings(Optional<string> name = default, Optional<string> password = default, Optional<MatchType> matchType = default, Optional<QueueModes> queueMode = default)
         {
             if (Room == null)
                 throw new InvalidOperationException("Must be joined to a match to change settings.");
 
-            // A dummy playlist item filled with the current room settings (except mods).
-            var existingPlaylistItem = new PlaylistItem
-            {
-                Beatmap =
-                {
-                    Value = new BeatmapInfo
-                    {
-                        OnlineBeatmapID = Room.Settings.BeatmapID,
-                        MD5Hash = Room.Settings.BeatmapChecksum
-                    }
-                },
-                RulesetID = Room.Settings.RulesetID
-            };
-
             return ChangeSettings(new MultiplayerRoomSettings
             {
                 Name = name.GetOr(Room.Settings.Name),
                 Password = password.GetOr(Room.Settings.Password),
-                BeatmapID = item.GetOr(existingPlaylistItem).BeatmapID,
-                BeatmapChecksum = item.GetOr(existingPlaylistItem).Beatmap.Value.MD5Hash,
-                RulesetID = item.GetOr(existingPlaylistItem).RulesetID,
                 MatchType = matchType.GetOr(Room.Settings.MatchType),
                 QueueMode = queueMode.GetOr(Room.Settings.QueueMode),
-                RequiredMods = item.HasValue ? item.Value.AsNonNull().RequiredMods.Select(m => new APIMod(m)).ToList() : Room.Settings.RequiredMods,
-                AllowedMods = item.HasValue ? item.Value.AsNonNull().AllowedMods.Select(m => new APIMod(m)).ToList() : Room.Settings.AllowedMods,
             });
         }
 
diff --git a/osu.Game/Online/Multiplayer/Queueing/AddPlaylistItemRequest.cs b/osu.Game/Online/Multiplayer/Queueing/AddPlaylistItemRequest.cs
new file mode 100644
index 0000000000..427461e733
--- /dev/null
+++ b/osu.Game/Online/Multiplayer/Queueing/AddPlaylistItemRequest.cs
@@ -0,0 +1,30 @@
+// 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 enable
+
+using System.Collections.Generic;
+using System.Linq;
+using MessagePack;
+using osu.Game.Online.API;
+
+namespace osu.Game.Online.Multiplayer.Queueing
+{
+    public class AddPlaylistItemRequest : MatchUserRequest
+    {
+        [Key(0)]
+        public int BeatmapID { get; set; }
+
+        [Key(1)]
+        public int RulesetID { get; set; }
+
+        [Key(2)]
+        public string BeatmapChecksum { get; set; } = string.Empty;
+
+        [Key(3)]
+        public IEnumerable<APIMod> RequiredMods { get; set; } = Enumerable.Empty<APIMod>();
+
+        [Key(4)]
+        public IEnumerable<APIMod> AllowedMods { get; set; } = Enumerable.Empty<APIMod>();
+    }
+}
diff --git a/osu.Game/Online/SignalRUnionWorkaroundResolver.cs b/osu.Game/Online/SignalRUnionWorkaroundResolver.cs
index e44da044cc..ff4505c450 100644
--- a/osu.Game/Online/SignalRUnionWorkaroundResolver.cs
+++ b/osu.Game/Online/SignalRUnionWorkaroundResolver.cs
@@ -8,6 +8,7 @@ using MessagePack.Formatters;
 using MessagePack.Resolvers;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Multiplayer.MatchTypes.TeamVersus;
+using osu.Game.Online.Multiplayer.Queueing;
 
 namespace osu.Game.Online
 {
@@ -25,6 +26,7 @@ namespace osu.Game.Online
             { typeof(TeamVersusUserState), new TypeRedirectingFormatter<TeamVersusUserState, MatchUserState>() },
             { typeof(TeamVersusRoomState), new TypeRedirectingFormatter<TeamVersusRoomState, MatchRoomState>() },
             { typeof(ChangeTeamRequest), new TypeRedirectingFormatter<ChangeTeamRequest, MatchUserRequest>() },
+            { typeof(AddPlaylistItemRequest), new TypeRedirectingFormatter<AddPlaylistItemRequest, MatchUserRequest>() },
 
             // These should not be required. The fallback should work. But something is weird with the way caching is done.
             // For future adventurers, I would not advise looking into this further. It's likely not worth the effort.
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs
index ad4bb90551..31ee09bdcd 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs
@@ -1,12 +1,15 @@
 // 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.Logging;
 using osu.Framework.Screens;
 using osu.Game.Beatmaps;
 using osu.Game.Graphics.UserInterface;
+using osu.Game.Online.API;
 using osu.Game.Online.Multiplayer;
+using osu.Game.Online.Multiplayer.Queueing;
 using osu.Game.Online.Rooms;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Mods;
@@ -54,7 +57,14 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
             {
                 loadingLayer.Show();
 
-                client.ChangeSettings(item: item).ContinueWith(t =>
+                client.SendMatchRequest(new AddPlaylistItemRequest
+                {
+                    BeatmapID = item.BeatmapID,
+                    RulesetID = item.RulesetID,
+                    BeatmapChecksum = item.Beatmap.Value.MD5Hash,
+                    RequiredMods = item.RequiredMods.Select(m => new APIMod(m)).ToArray(),
+                    AllowedMods = item.AllowedMods.Select(m => new APIMod(m)).ToArray()
+                }).ContinueWith(t =>
                 {
                     Schedule(() =>
                     {

From a7f3beabe3561d371e248025f62532f0541e7cd7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 17 Oct 2021 12:36:21 +0200
Subject: [PATCH 0358/5547] Modify `OsuTextBox` test scene to test against
 colour provider

---
 .../UserInterface/TestSceneOsuTextBox.cs      | 93 ++++++++-----------
 .../UserInterface/ThemeComparisonTestScene.cs |  4 +-
 2 files changed, 42 insertions(+), 55 deletions(-)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneOsuTextBox.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneOsuTextBox.cs
index 756928d3ec..fc1866cdf3 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneOsuTextBox.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneOsuTextBox.cs
@@ -1,80 +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 System.Collections.Generic;
+using System.Linq;
 using NUnit.Framework;
+using osu.Framework.Extensions.IEnumerableExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
-using osu.Framework.Graphics.Shapes;
+using osu.Framework.Testing;
 using osu.Game.Graphics.UserInterface;
+using osu.Game.Overlays;
 using osuTK;
-using osuTK.Graphics;
 
 namespace osu.Game.Tests.Visual.UserInterface
 {
-    public class TestSceneOsuTextBox : OsuTestScene
+    public class TestSceneOsuTextBox : ThemeComparisonTestScene
     {
-        private readonly OsuNumberBox numberBox;
+        private IEnumerable<OsuNumberBox> numberBoxes => this.ChildrenOfType<OsuNumberBox>();
 
-        public TestSceneOsuTextBox()
+        protected override Drawable CreateContent() => new FillFlowContainer
         {
-            Child = new Container
+            RelativeSizeAxes = Axes.X,
+            AutoSizeAxes = Axes.Y,
+            Direction = FillDirection.Vertical,
+            Padding = new MarginPadding(50f),
+            Spacing = new Vector2(0f, 50f),
+            Children = new[]
             {
-                Masking = true,
-                CornerRadius = 10f,
-                AutoSizeAxes = Axes.Both,
-                Padding = new MarginPadding(15f),
-                Children = new Drawable[]
+                new OsuTextBox
                 {
-                    new Box
-                    {
-                        RelativeSizeAxes = Axes.Both,
-                        Colour = Color4.DarkSlateGray,
-                        Alpha = 0.75f,
-                    },
-                    new FillFlowContainer
-                    {
-                        AutoSizeAxes = Axes.Both,
-                        Direction = FillDirection.Vertical,
-                        Padding = new MarginPadding(50f),
-                        Spacing = new Vector2(0f, 50f),
-                        Children = new[]
-                        {
-                            new OsuTextBox
-                            {
-                                Width = 500f,
-                                PlaceholderText = "Normal textbox",
-                            },
-                            new OsuPasswordTextBox
-                            {
-                                Width = 500f,
-                                PlaceholderText = "Password textbox",
-                            },
-                            numberBox = new OsuNumberBox
-                            {
-                                Width = 500f,
-                                PlaceholderText = "Number textbox"
-                            }
-                        }
-                    }
+                    RelativeSizeAxes = Axes.X,
+                    PlaceholderText = "Normal textbox",
+                },
+                new OsuPasswordTextBox
+                {
+                    RelativeSizeAxes = Axes.X,
+                    PlaceholderText = "Password textbox",
+                },
+                new OsuNumberBox
+                {
+                    RelativeSizeAxes = Axes.X,
+                    PlaceholderText = "Number textbox"
                 }
-            };
-        }
+            }
+        };
 
         [Test]
         public void TestNumberBox()
         {
-            clearTextbox(numberBox);
-            AddStep("enter numbers", () => numberBox.Text = "987654321");
-            expectedValue(numberBox, "987654321");
+            AddStep("create themed content", () => CreateThemedContent(OverlayColourScheme.Red));
 
-            clearTextbox(numberBox);
-            AddStep("enter text + single number", () => numberBox.Text = "1 hello 2 world 3");
-            expectedValue(numberBox, "123");
+            clearTextboxes(numberBoxes);
+            AddStep("enter numbers", () => numberBoxes.ForEach(numberBox => numberBox.Text = "987654321"));
+            expectedValue(numberBoxes, "987654321");
 
-            clearTextbox(numberBox);
+            clearTextboxes(numberBoxes);
+            AddStep("enter text + single number", () => numberBoxes.ForEach(numberBox => numberBox.Text = "1 hello 2 world 3"));
+            expectedValue(numberBoxes, "123");
+
+            clearTextboxes(numberBoxes);
         }
 
-        private void clearTextbox(OsuTextBox textBox) => AddStep("clear textbox", () => textBox.Text = null);
-        private void expectedValue(OsuTextBox textBox, string value) => AddAssert("expected textbox value", () => textBox.Text == value);
+        private void clearTextboxes(IEnumerable<OsuTextBox> textBoxes) => AddStep("clear textbox", () => textBoxes.ForEach(textBox => textBox.Text = null));
+        private void expectedValue(IEnumerable<OsuTextBox> textBoxes, string value) => AddAssert("expected textbox value", () => textBoxes.All(textbox => textbox.Text == value));
     }
 }
diff --git a/osu.Game.Tests/Visual/UserInterface/ThemeComparisonTestScene.cs b/osu.Game.Tests/Visual/UserInterface/ThemeComparisonTestScene.cs
index f8b9e8223b..db1c90f287 100644
--- a/osu.Game.Tests/Visual/UserInterface/ThemeComparisonTestScene.cs
+++ b/osu.Game.Tests/Visual/UserInterface/ThemeComparisonTestScene.cs
@@ -33,7 +33,7 @@ namespace osu.Game.Tests.Visual.UserInterface
             });
         }
 
-        private void createThemedContent(OverlayColourScheme colourScheme)
+        protected void CreateThemedContent(OverlayColourScheme colourScheme)
         {
             var colourProvider = new OverlayColourProvider(colourScheme);
 
@@ -63,7 +63,7 @@ namespace osu.Game.Tests.Visual.UserInterface
         public void TestAllColourSchemes()
         {
             foreach (var scheme in Enum.GetValues(typeof(OverlayColourScheme)).Cast<OverlayColourScheme>())
-                AddStep($"set {scheme} scheme", () => createThemedContent(scheme));
+                AddStep($"set {scheme} scheme", () => CreateThemedContent(scheme));
         }
     }
 }

From addcef4f5d9e6abca6776149a391401a350f71e9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 17 Oct 2021 12:51:51 +0200
Subject: [PATCH 0359/5547] Recolour text box using `OverlayColourProvider`

---
 osu.Game/Graphics/UserInterface/OsuTextBox.cs | 28 +++++++++++--------
 1 file changed, 16 insertions(+), 12 deletions(-)

diff --git a/osu.Game/Graphics/UserInterface/OsuTextBox.cs b/osu.Game/Graphics/UserInterface/OsuTextBox.cs
index 75af9efc38..b8f8518bb4 100644
--- a/osu.Game/Graphics/UserInterface/OsuTextBox.cs
+++ b/osu.Game/Graphics/UserInterface/OsuTextBox.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.
 
+#nullable enable
+
 using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
@@ -17,18 +19,13 @@ using osu.Framework.Input.Events;
 using osu.Framework.Utils;
 using osu.Game.Beatmaps.ControlPoints;
 using osu.Game.Graphics.Containers;
+using osu.Game.Overlays;
 using osuTK;
 
 namespace osu.Game.Graphics.UserInterface
 {
     public class OsuTextBox : BasicTextBox
     {
-        private readonly Sample[] textAddedSamples = new Sample[4];
-        private Sample capsTextAddedSample;
-        private Sample textRemovedSample;
-        private Sample textCommittedSample;
-        private Sample caretMovedSample;
-
         /// <summary>
         /// Whether to allow playing a different samples based on the type of character.
         /// If set to false, the same sample will be used for all characters.
@@ -42,10 +39,15 @@ namespace osu.Game.Graphics.UserInterface
         protected override SpriteText CreatePlaceholder() => new OsuSpriteText
         {
             Font = OsuFont.GetFont(italics: true),
-            Colour = new Color4(180, 180, 180, 255),
             Margin = new MarginPadding { Left = 2 },
         };
 
+        private readonly Sample?[] textAddedSamples = new Sample[4];
+        private Sample? capsTextAddedSample;
+        private Sample? textRemovedSample;
+        private Sample? textCommittedSample;
+        private Sample? caretMovedSample;
+
         public OsuTextBox()
         {
             Height = 40;
@@ -56,12 +58,14 @@ namespace osu.Game.Graphics.UserInterface
             Current.DisabledChanged += disabled => { Alpha = disabled ? 0.3f : 1; };
         }
 
-        [BackgroundDependencyLoader]
-        private void load(OsuColour colour, AudioManager audio)
+        [BackgroundDependencyLoader(true)]
+        private void load(OverlayColourProvider? colourProvider, OsuColour colour, AudioManager audio)
         {
-            BackgroundUnfocused = Color4.Black.Opacity(0.5f);
-            BackgroundFocused = OsuColour.Gray(0.3f).Opacity(0.8f);
-            BackgroundCommit = BorderColour = colour.Yellow;
+            BackgroundUnfocused = colourProvider?.Background5 ?? Color4.Black.Opacity(0.5f);
+            BackgroundFocused = colourProvider?.Background3 ?? OsuColour.Gray(0.3f).Opacity(0.8f);
+            BackgroundCommit = BorderColour = colourProvider?.Highlight1 ?? colour.Yellow;
+
+            Placeholder.Colour = colourProvider?.Foreground1 ?? new Color4(180, 180, 180, 255);
 
             for (int i = 0; i < textAddedSamples.Length; i++)
                 textAddedSamples[i] = audio.Samples.Get($@"Keyboard/key-press-{1 + i}");

From 1ec881ce1d9306c4d3b326b1d44e81a64206a490 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 17 Oct 2021 12:58:37 +0200
Subject: [PATCH 0360/5547] Recolour focused text box variant

---
 osu.Game/Graphics/UserInterface/FocusedTextBox.cs | 13 ++++++++-----
 1 file changed, 8 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Graphics/UserInterface/FocusedTextBox.cs b/osu.Game/Graphics/UserInterface/FocusedTextBox.cs
index ceea9620c8..88608bf43c 100644
--- a/osu.Game/Graphics/UserInterface/FocusedTextBox.cs
+++ b/osu.Game/Graphics/UserInterface/FocusedTextBox.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.
 
+#nullable enable
+
 using osuTK.Graphics;
 using osu.Framework.Allocation;
 using osu.Framework.Input.Events;
@@ -8,6 +10,7 @@ using osu.Framework.Platform;
 using osu.Game.Input.Bindings;
 using osuTK.Input;
 using osu.Framework.Input.Bindings;
+using osu.Game.Overlays;
 
 namespace osu.Game.Graphics.UserInterface
 {
@@ -42,13 +45,13 @@ namespace osu.Game.Graphics.UserInterface
         }
 
         [Resolved]
-        private GameHost host { get; set; }
+        private GameHost? host { get; set; }
 
-        [BackgroundDependencyLoader]
-        private void load()
+        [BackgroundDependencyLoader(true)]
+        private void load(OverlayColourProvider? colourProvider)
         {
-            BackgroundUnfocused = new Color4(10, 10, 10, 255);
-            BackgroundFocused = new Color4(10, 10, 10, 255);
+            BackgroundUnfocused = colourProvider?.Background5 ?? new Color4(10, 10, 10, 255);
+            BackgroundFocused = colourProvider?.Background5 ?? new Color4(10, 10, 10, 255);
         }
 
         // We may not be focused yet, but we need to handle keyboard input to be able to request focus

From 9ad9465020eee89a421f80d9a5ce2027548a65ed Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 17 Oct 2021 13:10:23 +0200
Subject: [PATCH 0361/5547] Remove online-screen-local textbox recolours

---
 .../OnlinePlay/Lounge/LoungeSubScreen.cs      | 13 +---------
 .../Match/Components/RoomSettingsOverlay.cs   | 26 -------------------
 .../Match/MultiplayerMatchSettingsOverlay.cs  |  6 ++---
 .../Playlists/PlaylistsRoomSettingsOverlay.cs |  8 +++---
 4 files changed, 8 insertions(+), 45 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Lounge/LoungeSubScreen.cs b/osu.Game/Screens/OnlinePlay/Lounge/LoungeSubScreen.cs
index 08bdd0487a..62012906a7 100644
--- a/osu.Game/Screens/OnlinePlay/Lounge/LoungeSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Lounge/LoungeSubScreen.cs
@@ -17,7 +17,6 @@ using osu.Framework.Input.Events;
 using osu.Framework.Logging;
 using osu.Framework.Screens;
 using osu.Framework.Threading;
-using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Input;
@@ -126,7 +125,7 @@ namespace osu.Game.Screens.OnlinePlay.Lounge
                         {
                             RelativeSizeAxes = Axes.X,
                             Height = Header.HEIGHT,
-                            Child = searchTextBox = new LoungeSearchTextBox
+                            Child = searchTextBox = new SearchTextBox
                             {
                                 Anchor = Anchor.CentreRight,
                                 Origin = Anchor.CentreRight,
@@ -362,15 +361,5 @@ namespace osu.Game.Screens.OnlinePlay.Lounge
         protected abstract RoomSubScreen CreateRoomSubScreen(Room room);
 
         protected abstract ListingPollingComponent CreatePollingComponent();
-
-        private class LoungeSearchTextBox : SearchTextBox
-        {
-            [BackgroundDependencyLoader]
-            private void load()
-            {
-                BackgroundUnfocused = OsuColour.Gray(0.06f);
-                BackgroundFocused = OsuColour.Gray(0.12f);
-            }
-        }
     }
 }
diff --git a/osu.Game/Screens/OnlinePlay/Match/Components/RoomSettingsOverlay.cs b/osu.Game/Screens/OnlinePlay/Match/Components/RoomSettingsOverlay.cs
index a6cdde14f6..6d14b95aec 100644
--- a/osu.Game/Screens/OnlinePlay/Match/Components/RoomSettingsOverlay.cs
+++ b/osu.Game/Screens/OnlinePlay/Match/Components/RoomSettingsOverlay.cs
@@ -12,7 +12,6 @@ using osu.Game.Graphics.UserInterface;
 using osu.Game.Input.Bindings;
 using osu.Game.Online.Rooms;
 using osuTK;
-using osuTK.Graphics;
 
 namespace osu.Game.Screens.OnlinePlay.Match.Components
 {
@@ -91,31 +90,6 @@ namespace osu.Game.Screens.OnlinePlay.Match.Components
         {
         }
 
-        protected class SettingsTextBox : OsuTextBox
-        {
-            [BackgroundDependencyLoader]
-            private void load()
-            {
-                BackgroundUnfocused = Color4.Black;
-                BackgroundFocused = Color4.Black;
-            }
-        }
-
-        protected class SettingsNumberTextBox : SettingsTextBox
-        {
-            protected override bool CanAddCharacter(char character) => char.IsNumber(character);
-        }
-
-        protected class SettingsPasswordTextBox : OsuPasswordTextBox
-        {
-            [BackgroundDependencyLoader]
-            private void load()
-            {
-                BackgroundUnfocused = Color4.Black;
-                BackgroundFocused = Color4.Black;
-            }
-        }
-
         protected class SectionContainer : FillFlowContainer<Section>
         {
             public SectionContainer()
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs
index 0edf5dde6d..5bc76a10bc 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs
@@ -153,7 +153,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
                                                             {
                                                                 new Section("Room name")
                                                                 {
-                                                                    Child = NameField = new SettingsTextBox
+                                                                    Child = NameField = new OsuTextBox
                                                                     {
                                                                         RelativeSizeAxes = Axes.X,
                                                                         TabbableContentContainer = this,
@@ -202,7 +202,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
                                                                 new Section("Max participants")
                                                                 {
                                                                     Alpha = disabled_alpha,
-                                                                    Child = MaxParticipantsField = new SettingsNumberTextBox
+                                                                    Child = MaxParticipantsField = new OsuNumberBox
                                                                     {
                                                                         RelativeSizeAxes = Axes.X,
                                                                         TabbableContentContainer = this,
@@ -211,7 +211,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
                                                                 },
                                                                 new Section("Password (optional)")
                                                                 {
-                                                                    Child = PasswordTextBox = new SettingsPasswordTextBox
+                                                                    Child = PasswordTextBox = new OsuPasswordTextBox
                                                                     {
                                                                         RelativeSizeAxes = Axes.X,
                                                                         TabbableContentContainer = this,
diff --git a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSettingsOverlay.cs b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSettingsOverlay.cs
index 9e000aa712..c2bd7730e9 100644
--- a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSettingsOverlay.cs
+++ b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSettingsOverlay.cs
@@ -121,7 +121,7 @@ namespace osu.Game.Screens.OnlinePlay.Playlists
                                                     {
                                                         new Section("Room name")
                                                         {
-                                                            Child = NameField = new SettingsTextBox
+                                                            Child = NameField = new OsuTextBox
                                                             {
                                                                 RelativeSizeAxes = Axes.X,
                                                                 TabbableContentContainer = this,
@@ -150,7 +150,7 @@ namespace osu.Game.Screens.OnlinePlay.Playlists
                                                         },
                                                         new Section("Allowed attempts (across all playlist items)")
                                                         {
-                                                            Child = MaxAttemptsField = new SettingsNumberTextBox
+                                                            Child = MaxAttemptsField = new OsuNumberBox
                                                             {
                                                                 RelativeSizeAxes = Axes.X,
                                                                 TabbableContentContainer = this,
@@ -168,7 +168,7 @@ namespace osu.Game.Screens.OnlinePlay.Playlists
                                                         new Section("Max participants")
                                                         {
                                                             Alpha = disabled_alpha,
-                                                            Child = MaxParticipantsField = new SettingsNumberTextBox
+                                                            Child = MaxParticipantsField = new OsuNumberBox
                                                             {
                                                                 RelativeSizeAxes = Axes.X,
                                                                 TabbableContentContainer = this,
@@ -178,7 +178,7 @@ namespace osu.Game.Screens.OnlinePlay.Playlists
                                                         new Section("Password (optional)")
                                                         {
                                                             Alpha = disabled_alpha,
-                                                            Child = new SettingsPasswordTextBox
+                                                            Child = new OsuPasswordTextBox
                                                             {
                                                                 RelativeSizeAxes = Axes.X,
                                                                 TabbableContentContainer = this,

From 7bc8f5cd5cf4628626c76e65c81484b3609556a9 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 21 Oct 2021 12:59:40 +0900
Subject: [PATCH 0362/5547] Change selection colour to also match the colour
 provider scheme

---
 osu.Game/Graphics/UserInterface/OsuTextBox.cs | 14 +++++++++++---
 1 file changed, 11 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Graphics/UserInterface/OsuTextBox.cs b/osu.Game/Graphics/UserInterface/OsuTextBox.cs
index b8f8518bb4..96319b9fdd 100644
--- a/osu.Game/Graphics/UserInterface/OsuTextBox.cs
+++ b/osu.Game/Graphics/UserInterface/OsuTextBox.cs
@@ -48,6 +48,8 @@ namespace osu.Game.Graphics.UserInterface
         private Sample? textCommittedSample;
         private Sample? caretMovedSample;
 
+        private OsuCaret? caret;
+
         public OsuTextBox()
         {
             Height = 40;
@@ -62,8 +64,12 @@ namespace osu.Game.Graphics.UserInterface
         private void load(OverlayColourProvider? colourProvider, OsuColour colour, AudioManager audio)
         {
             BackgroundUnfocused = colourProvider?.Background5 ?? Color4.Black.Opacity(0.5f);
-            BackgroundFocused = colourProvider?.Background3 ?? OsuColour.Gray(0.3f).Opacity(0.8f);
+            BackgroundFocused = colourProvider?.Background4 ?? OsuColour.Gray(0.3f).Opacity(0.8f);
             BackgroundCommit = BorderColour = colourProvider?.Highlight1 ?? colour.Yellow;
+            selectionColour = colourProvider?.Background1 ?? new Color4(249, 90, 255, 255);
+
+            if (caret != null)
+                caret.SelectionColour = selectionColour;
 
             Placeholder.Colour = colourProvider?.Foreground1 ?? new Color4(180, 180, 180, 255);
 
@@ -76,7 +82,9 @@ namespace osu.Game.Graphics.UserInterface
             caretMovedSample = audio.Samples.Get(@"Keyboard/key-movement");
         }
 
-        protected override Color4 SelectionColour => new Color4(249, 90, 255, 255);
+        private Color4 selectionColour;
+
+        protected override Color4 SelectionColour => selectionColour;
 
         protected override void OnUserTextAdded(string added)
         {
@@ -128,7 +136,7 @@ namespace osu.Game.Graphics.UserInterface
             Child = new OsuSpriteText { Text = c.ToString(), Font = OsuFont.GetFont(size: CalculatedTextSize) },
         };
 
-        protected override Caret CreateCaret() => new OsuCaret
+        protected override Caret CreateCaret() => caret = new OsuCaret
         {
             CaretWidth = CaretWidth,
             SelectionColour = SelectionColour,

From 59b7210efaaf976301deefc9fdbd3c2d756f675f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 21 Oct 2021 13:35:26 +0900
Subject: [PATCH 0363/5547] Revert disallowing imports with no files

While it is logical that we want this, from a testing perspective this is a bit of a nightmare to fix. Let's revisit at a later point in time.
---
 osu.Game.Tests/Skins/IO/ImportSkinTest.cs |  7 ++--
 osu.Game/Database/ArchiveModelManager.cs  | 40 ++++++++++++++---------
 osu.Game/Skinning/SkinManager.cs          |  4 ---
 3 files changed, 28 insertions(+), 23 deletions(-)

diff --git a/osu.Game.Tests/Skins/IO/ImportSkinTest.cs b/osu.Game.Tests/Skins/IO/ImportSkinTest.cs
index 21e4948972..20bf42345f 100644
--- a/osu.Game.Tests/Skins/IO/ImportSkinTest.cs
+++ b/osu.Game.Tests/Skins/IO/ImportSkinTest.cs
@@ -48,11 +48,12 @@ namespace osu.Game.Tests.Skins.IO
         });
 
         [Test]
-        public Task TestEmptyImportFails() => runSkinTest(osu =>
+        public Task TestEmptyImportImportsWithFilename() => runSkinTest(async osu =>
         {
-            Assert.ThrowsAsync<InvalidOperationException>(() => loadSkinIntoOsu(osu, new ZipArchiveReader(createEmptyOsk(), "test skin.osk")));
+            var import1 = await loadSkinIntoOsu(osu, new ZipArchiveReader(createEmptyOsk(), "test skin.osk"));
 
-            return Task.CompletedTask;
+            // When the import filename matches it shouldn't be appended.
+            assertCorrectMetadata(import1, "test skin", "Unknown", osu);
         });
 
         #endregion
diff --git a/osu.Game/Database/ArchiveModelManager.cs b/osu.Game/Database/ArchiveModelManager.cs
index 63a5da79a7..0bc4c40459 100644
--- a/osu.Game/Database/ArchiveModelManager.cs
+++ b/osu.Game/Database/ArchiveModelManager.cs
@@ -322,22 +322,22 @@ namespace osu.Game.Database
                                     .OrderBy(f => f.Filename)
                                     .ToArray();
 
-            if (hashableFiles.Length == 0)
-                throw new InvalidOperationException("Attempted to hash an archive with no files");
-
-            // for now, concatenate all hashable files in the set to create a unique hash.
-            MemoryStream hashable = new MemoryStream();
-
-            foreach (TFileModel file in hashableFiles)
+            if (hashableFiles.Length > 0)
             {
-                using (Stream s = Files.Store.GetStream(file.FileInfo.StoragePath))
-                    s.CopyTo(hashable);
+                // for now, concatenate all hashable files in the set to create a unique hash.
+                MemoryStream hashable = new MemoryStream();
+
+                foreach (TFileModel file in hashableFiles)
+                {
+                    using (Stream s = Files.Store.GetStream(file.FileInfo.StoragePath))
+                        s.CopyTo(hashable);
+                }
+
+                if (hashable.Length > 0)
+                    return hashable.ComputeSHA2Hash();
             }
 
-            if (hashable.Length > 0)
-                return hashable.ComputeSHA2Hash();
-
-            return item.Hash;
+            return generateFallbackHash();
         }
 
         /// <summary>
@@ -707,10 +707,10 @@ namespace osu.Game.Database
                     s.CopyTo(hashable);
             }
 
-            if (hashable.Length == 0)
-                throw new InvalidOperationException("Attempted to hash an archive with no files");
+            if (hashable.Length > 0)
+                return hashable.ComputeSHA2Hash();
 
-            return hashable.ComputeSHA2Hash();
+            return generateFallbackHash();
         }
 
         /// <summary>
@@ -923,6 +923,14 @@ namespace osu.Game.Database
 
         #endregion
 
+        private static string generateFallbackHash()
+        {
+            // if a hash could no be generated from file content, presume a unique / new import.
+            // therefore, let's use a guaranteed unique hash.
+            // this doesn't follow the SHA2 hashing schema intentionally, so such entries on the data store can be identified.
+            return Guid.NewGuid().ToString();
+        }
+
         private string getValidFilename(string filename)
         {
             foreach (char c in Path.GetInvalidFileNameChars())
diff --git a/osu.Game/Skinning/SkinManager.cs b/osu.Game/Skinning/SkinManager.cs
index afa411a15b..304e48e854 100644
--- a/osu.Game/Skinning/SkinManager.cs
+++ b/osu.Game/Skinning/SkinManager.cs
@@ -157,10 +157,6 @@ namespace osu.Game.Skinning
 
         protected override string ComputeHash(SkinInfo item, ArchiveReader reader = null)
         {
-            // we will be adding a hashable file below, but this is only useful if there are any other files in the skin.
-            if (item.Files.Count == 0)
-                throw new InvalidOperationException("Attempted to hash an archive with no files");
-
             var instance = GetSkin(item);
 
             // This function can be run on fresh import or save. The logic here ensures a skin.ini file is in a good state for both operations.

From a5088cac27c2d6955165efd45a86b68ed7952128 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 21 Oct 2021 13:36:04 +0900
Subject: [PATCH 0364/5547] Fix default metadata propagation when no files are
 present

---
 osu.Game/Skinning/SkinInfo.cs    | 6 +++---
 osu.Game/Skinning/SkinManager.cs | 5 +++--
 2 files changed, 6 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Skinning/SkinInfo.cs b/osu.Game/Skinning/SkinInfo.cs
index 2bf8668ec6..3b34e23d57 100644
--- a/osu.Game/Skinning/SkinInfo.cs
+++ b/osu.Game/Skinning/SkinInfo.cs
@@ -18,12 +18,12 @@ namespace osu.Game.Skinning
 
         public int ID { get; set; }
 
-        public string Name { get; set; }
+        public string Name { get; set; } = string.Empty;
+
+        public string Creator { get; set; } = string.Empty;
 
         public string Hash { get; set; }
 
-        public string Creator { get; set; }
-
         public string InstantiationInfo { get; set; }
 
         public virtual Skin CreateInstance(IStorageResourceProvider resources)
diff --git a/osu.Game/Skinning/SkinManager.cs b/osu.Game/Skinning/SkinManager.cs
index 304e48e854..fffdf19976 100644
--- a/osu.Game/Skinning/SkinManager.cs
+++ b/osu.Game/Skinning/SkinManager.cs
@@ -149,7 +149,7 @@ namespace osu.Game.Skinning
             CurrentSkinInfo.Value = ModelStore.ConsumableItems.Single(i => i.ID == chosen.ID);
         }
 
-        protected override SkinInfo CreateModel(ArchiveReader archive) => new SkinInfo { Name = archive.Name };
+        protected override SkinInfo CreateModel(ArchiveReader archive) => new SkinInfo { Name = archive.Name ?? "No name" };
 
         private const string unknown_creator_string = "Unknown";
 
@@ -163,6 +163,7 @@ namespace osu.Game.Skinning
 
             // LegacySkin will parse the skin.ini and populate `Skin.Configuration` during construction above.
             string skinIniSourcedName = instance.Configuration.SkinInfo.Name;
+            string skinIniSourcedCreator = instance.Configuration.SkinInfo.Creator;
             string archiveName = item.Name.Replace(".osk", "", StringComparison.OrdinalIgnoreCase);
 
             bool isImport = reader != null;
@@ -170,7 +171,7 @@ namespace osu.Game.Skinning
             if (isImport)
             {
                 item.Name = !string.IsNullOrEmpty(skinIniSourcedName) ? skinIniSourcedName : archiveName;
-                item.Creator = instance.Configuration.SkinInfo.Creator ?? unknown_creator_string;
+                item.Creator = !string.IsNullOrEmpty(skinIniSourcedCreator) ? skinIniSourcedCreator : unknown_creator_string;
 
                 // For imports, we want to use the archive or folder name as part of the metadata, in addition to any existing skin.ini metadata.
                 // In an ideal world, skin.ini would be the only source of metadata, but a lot of skin creators and users don't update it when making modifications.

From a5c155bc87354095b864bb5296b451b6e2ce8faa Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 21 Oct 2021 16:43:46 +0900
Subject: [PATCH 0365/5547] Remove `APIPlaylistBeatmap` subclass

---
 .../API/Requests/Responses/APIBeatmap.cs      |  4 ++++
 osu.Game/Online/Rooms/APIPlaylistBeatmap.cs   | 23 -------------------
 osu.Game/Online/Rooms/PlaylistItem.cs         |  3 ++-
 3 files changed, 6 insertions(+), 24 deletions(-)
 delete mode 100644 osu.Game/Online/Rooms/APIPlaylistBeatmap.cs

diff --git a/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs b/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs
index c2a68c8ca1..ea4265e641 100644
--- a/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs
@@ -19,6 +19,9 @@ namespace osu.Game.Online.API.Requests.Responses
         [JsonProperty(@"status")]
         public BeatmapSetOnlineStatus Status { get; set; }
 
+        [JsonProperty("checksum")]
+        public string Checksum { get; set; }
+
         [JsonProperty(@"beatmapset")]
         public APIBeatmapSet BeatmapSet { get; set; }
 
@@ -78,6 +81,7 @@ namespace osu.Game.Online.API.Requests.Responses
                 // this is actually an incorrect mapping (Length is calculated as drain length in lazer's import process, see BeatmapManager.calculateLength).
                 Length = TimeSpan.FromSeconds(length).TotalMilliseconds,
                 Status = Status,
+                MD5Hash = Checksum,
                 BeatmapSet = set,
                 Metrics = metrics,
                 MaxCombo = maxCombo,
diff --git a/osu.Game/Online/Rooms/APIPlaylistBeatmap.cs b/osu.Game/Online/Rooms/APIPlaylistBeatmap.cs
deleted file mode 100644
index 00623282d3..0000000000
--- a/osu.Game/Online/Rooms/APIPlaylistBeatmap.cs
+++ /dev/null
@@ -1,23 +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 Newtonsoft.Json;
-using osu.Game.Beatmaps;
-using osu.Game.Online.API.Requests.Responses;
-using osu.Game.Rulesets;
-
-namespace osu.Game.Online.Rooms
-{
-    public class APIPlaylistBeatmap : APIBeatmap
-    {
-        [JsonProperty("checksum")]
-        public string Checksum { get; set; }
-
-        public override BeatmapInfo ToBeatmapInfo(RulesetStore rulesets)
-        {
-            var b = base.ToBeatmapInfo(rulesets);
-            b.MD5Hash = Checksum;
-            return b;
-        }
-    }
-}
diff --git a/osu.Game/Online/Rooms/PlaylistItem.cs b/osu.Game/Online/Rooms/PlaylistItem.cs
index 48f1347fa1..7fcce1514d 100644
--- a/osu.Game/Online/Rooms/PlaylistItem.cs
+++ b/osu.Game/Online/Rooms/PlaylistItem.cs
@@ -7,6 +7,7 @@ using Newtonsoft.Json;
 using osu.Framework.Bindables;
 using osu.Game.Beatmaps;
 using osu.Game.Online.API;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Mods;
 
@@ -42,7 +43,7 @@ namespace osu.Game.Online.Rooms
         public readonly BindableList<Mod> RequiredMods = new BindableList<Mod>();
 
         [JsonProperty("beatmap")]
-        private APIPlaylistBeatmap apiBeatmap { get; set; }
+        private APIBeatmap apiBeatmap { get; set; }
 
         private APIMod[] allowedModsBacking;
 

From 0706ad70fb6f36ba9dcad45b2c9da451c6f22a6a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 20 Oct 2021 18:43:48 +0900
Subject: [PATCH 0366/5547] Move `BeatmapSetOnlineInfo` to an interface type

---
 .../Online/TestSceneBeatmapAvailability.cs    |   9 +-
 .../Online/TestSceneBeatmapSetOverlay.cs      |   9 +-
 .../TestSceneBeatmapSetOverlayDetails.cs      |   3 +-
 .../Online/TestSceneDirectDownloadButton.cs   |   3 +-
 .../Visual/Online/TestSceneDirectPanel.cs     |   5 +-
 .../TestSceneBeatmapListingSearchControl.cs   |   5 +-
 .../TestSceneDashboardBeatmapListing.cs       |   9 +-
 .../TestSceneUpdateableBeatmapSetCover.cs     |   7 +-
 .../Components/TournamentBeatmapPanel.cs      |  19 ++-
 .../Screens/MapPool/MapPoolScreen.cs          |   6 +-
 osu.Game/Beatmaps/BeatmapInfoExtensions.cs    |  11 +-
 osu.Game/Beatmaps/BeatmapSetInfo.cs           | 144 +++++++++++++++++-
 osu.Game/Beatmaps/BeatmapSetOnlineInfo.cs     |   2 +-
 .../Beatmaps/Drawables/BeatmapSetCover.cs     |  10 +-
 .../Drawables/UpdateableBeatmapSetCover.cs    |   6 +-
 .../API/Requests/Responses/APIBeatmapSet.cs   |  55 +++----
 .../OnlinePlayBeatmapAvailabilityTracker.cs   |   6 +-
 .../OnlinePlay/Components/BeatmapTitle.cs     |   2 +-
 osu.Game/Tests/Beatmaps/TestBeatmap.cs        |   3 +-
 19 files changed, 222 insertions(+), 92 deletions(-)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneBeatmapAvailability.cs b/osu.Game.Tests/Visual/Online/TestSceneBeatmapAvailability.cs
index fe94165777..6f9744ca73 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneBeatmapAvailability.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneBeatmapAvailability.cs
@@ -3,6 +3,7 @@
 
 using NUnit.Framework;
 using osu.Game.Beatmaps;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays.BeatmapSet;
 
 namespace osu.Game.Tests.Visual.Online
@@ -22,7 +23,7 @@ namespace osu.Game.Tests.Visual.Online
         {
             AddStep("set undownloadable beatmapset with link", () => container.BeatmapSet = new BeatmapSetInfo
             {
-                OnlineInfo = new BeatmapSetOnlineInfo
+                OnlineInfo = new APIBeatmapSet
                 {
                     Availability = new BeatmapSetOnlineAvailability
                     {
@@ -40,7 +41,7 @@ namespace osu.Game.Tests.Visual.Online
         {
             AddStep("set undownloadable beatmapset without link", () => container.BeatmapSet = new BeatmapSetInfo
             {
-                OnlineInfo = new BeatmapSetOnlineInfo
+                OnlineInfo = new APIBeatmapSet
                 {
                     Availability = new BeatmapSetOnlineAvailability
                     {
@@ -57,7 +58,7 @@ namespace osu.Game.Tests.Visual.Online
         {
             AddStep("set parts-removed beatmapset with link", () => container.BeatmapSet = new BeatmapSetInfo
             {
-                OnlineInfo = new BeatmapSetOnlineInfo
+                OnlineInfo = new APIBeatmapSet
                 {
                     Availability = new BeatmapSetOnlineAvailability
                     {
@@ -75,7 +76,7 @@ namespace osu.Game.Tests.Visual.Online
         {
             AddStep("set normal beatmapset", () => container.BeatmapSet = new BeatmapSetInfo
             {
-                OnlineInfo = new BeatmapSetOnlineInfo
+                OnlineInfo = new APIBeatmapSet
                 {
                     Availability = new BeatmapSetOnlineAvailability
                     {
diff --git a/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlay.cs b/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlay.cs
index 453e26ef96..ef89a86e79 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlay.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlay.cs
@@ -11,6 +11,7 @@ using osu.Game.Users;
 using System;
 using System.Collections.Generic;
 using System.Linq;
+using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Tests.Visual.Online
 {
@@ -63,7 +64,7 @@ namespace osu.Game.Tests.Visual.Online
                             Id = 3,
                         },
                     },
-                    OnlineInfo = new BeatmapSetOnlineInfo
+                    OnlineInfo = new APIBeatmapSet
                     {
                         Preview = @"https://b.ppy.sh/preview/12345.mp3",
                         PlayCount = 123,
@@ -134,7 +135,7 @@ namespace osu.Game.Tests.Visual.Online
                             Id = 3,
                         },
                     },
-                    OnlineInfo = new BeatmapSetOnlineInfo
+                    OnlineInfo = new APIBeatmapSet
                     {
                         Availability = new BeatmapSetOnlineAvailability
                         {
@@ -224,7 +225,7 @@ namespace osu.Game.Tests.Visual.Online
                             Id = 3,
                         }
                     },
-                    OnlineInfo = new BeatmapSetOnlineInfo
+                    OnlineInfo = new APIBeatmapSet
                     {
                         Covers = new BeatmapSetOnlineCovers(),
                     },
@@ -309,7 +310,7 @@ namespace osu.Game.Tests.Visual.Online
                         Id = 3,
                     },
                 },
-                OnlineInfo = new BeatmapSetOnlineInfo
+                OnlineInfo = new APIBeatmapSet
                 {
                     Preview = @"https://b.ppy.sh/preview/123.mp3",
                     HasVideo = true,
diff --git a/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlayDetails.cs b/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlayDetails.cs
index f7099b0615..c15c9f44e4 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlayDetails.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlayDetails.cs
@@ -8,6 +8,7 @@ using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Utils;
 using osu.Game.Beatmaps;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays;
 using osu.Game.Overlays.BeatmapSet;
 using osu.Game.Screens.Select.Details;
@@ -57,7 +58,7 @@ namespace osu.Game.Tests.Visual.Online
                         },
                     }
                 },
-                OnlineInfo = new BeatmapSetOnlineInfo
+                OnlineInfo = new APIBeatmapSet
                 {
                     Status = BeatmapSetOnlineStatus.Ranked
                 }
diff --git a/osu.Game.Tests/Visual/Online/TestSceneDirectDownloadButton.cs b/osu.Game.Tests/Visual/Online/TestSceneDirectDownloadButton.cs
index 3fc894da0d..bb7fcc2fce 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneDirectDownloadButton.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneDirectDownloadButton.cs
@@ -7,6 +7,7 @@ using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Game.Beatmaps;
 using osu.Game.Online;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays.BeatmapListing.Panels;
 using osu.Game.Rulesets.Osu;
 using osu.Game.Tests.Resources;
@@ -74,7 +75,7 @@ namespace osu.Game.Tests.Visual.Online
             {
                 ID = 1,
                 OnlineBeatmapSetID = 241526,
-                OnlineInfo = new BeatmapSetOnlineInfo
+                OnlineInfo = new APIBeatmapSet
                 {
                     Availability = new BeatmapSetOnlineAvailability
                     {
diff --git a/osu.Game.Tests/Visual/Online/TestSceneDirectPanel.cs b/osu.Game.Tests/Visual/Online/TestSceneDirectPanel.cs
index 722010ace2..6caca2a67c 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneDirectPanel.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneDirectPanel.cs
@@ -7,6 +7,7 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Audio;
 using osu.Game.Beatmaps;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays.BeatmapListing.Panels;
 using osu.Game.Rulesets;
 using osu.Game.Users;
@@ -31,7 +32,7 @@ namespace osu.Game.Tests.Visual.Online
                     Id = 3,
                 },
             },
-            OnlineInfo = new BeatmapSetOnlineInfo
+            OnlineInfo = new APIBeatmapSet
             {
                 Availability = new BeatmapSetOnlineAvailability
                 {
@@ -86,7 +87,7 @@ namespace osu.Game.Tests.Visual.Online
                         Id = 3,
                     }
                 },
-                OnlineInfo = new BeatmapSetOnlineInfo
+                OnlineInfo = new APIBeatmapSet
                 {
                     HasVideo = true,
                     HasStoryboard = true,
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneBeatmapListingSearchControl.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneBeatmapListingSearchControl.cs
index 008d91f649..a9fe7ed7d8 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneBeatmapListingSearchControl.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneBeatmapListingSearchControl.cs
@@ -10,6 +10,7 @@ using osu.Framework.Graphics.Containers;
 using osu.Game.Beatmaps;
 using osu.Game.Configuration;
 using osu.Game.Graphics.Sprites;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays;
 using osu.Game.Overlays.BeatmapListing;
 using osuTK;
@@ -111,7 +112,7 @@ namespace osu.Game.Tests.Visual.UserInterface
 
         private static readonly BeatmapSetInfo beatmap_set = new BeatmapSetInfo
         {
-            OnlineInfo = new BeatmapSetOnlineInfo
+            OnlineInfo = new APIBeatmapSet
             {
                 Covers = new BeatmapSetOnlineCovers
                 {
@@ -122,7 +123,7 @@ namespace osu.Game.Tests.Visual.UserInterface
 
         private static readonly BeatmapSetInfo no_cover_beatmap_set = new BeatmapSetInfo
         {
-            OnlineInfo = new BeatmapSetOnlineInfo
+            OnlineInfo = new APIBeatmapSet
             {
                 Covers = new BeatmapSetOnlineCovers
                 {
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneDashboardBeatmapListing.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneDashboardBeatmapListing.cs
index c51204eaba..6727c7560b 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneDashboardBeatmapListing.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneDashboardBeatmapListing.cs
@@ -11,6 +11,7 @@ using osu.Game.Users;
 using System;
 using osu.Framework.Graphics.Shapes;
 using System.Collections.Generic;
+using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Tests.Visual.UserInterface
 {
@@ -69,7 +70,7 @@ namespace osu.Game.Tests.Visual.UserInterface
                         Id = 100
                     }
                 },
-                OnlineInfo = new BeatmapSetOnlineInfo
+                OnlineInfo = new APIBeatmapSet
                 {
                     Covers = new BeatmapSetOnlineCovers
                     {
@@ -90,7 +91,7 @@ namespace osu.Game.Tests.Visual.UserInterface
                         Id = 100
                     }
                 },
-                OnlineInfo = new BeatmapSetOnlineInfo
+                OnlineInfo = new APIBeatmapSet
                 {
                     Covers = new BeatmapSetOnlineCovers
                     {
@@ -115,7 +116,7 @@ namespace osu.Game.Tests.Visual.UserInterface
                         Id = 100
                     }
                 },
-                OnlineInfo = new BeatmapSetOnlineInfo
+                OnlineInfo = new APIBeatmapSet
                 {
                     Covers = new BeatmapSetOnlineCovers
                     {
@@ -136,7 +137,7 @@ namespace osu.Game.Tests.Visual.UserInterface
                         Id = 100
                     }
                 },
-                OnlineInfo = new BeatmapSetOnlineInfo
+                OnlineInfo = new APIBeatmapSet
                 {
                     Covers = new BeatmapSetOnlineCovers
                     {
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneUpdateableBeatmapSetCover.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneUpdateableBeatmapSetCover.cs
index 4fef93e291..01e628075c 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneUpdateableBeatmapSetCover.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneUpdateableBeatmapSetCover.cs
@@ -13,6 +13,7 @@ using osu.Framework.Testing;
 using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.Drawables;
 using osu.Game.Graphics.Containers;
+using osu.Game.Online.API.Requests.Responses;
 using osuTK;
 
 namespace osu.Game.Tests.Visual.UserInterface
@@ -133,7 +134,7 @@ namespace osu.Game.Tests.Visual.UserInterface
 
         private static BeatmapSetInfo createBeatmapWithCover(string coverUrl) => new BeatmapSetInfo
         {
-            OnlineInfo = new BeatmapSetOnlineInfo
+            OnlineInfo = new APIBeatmapSet
             {
                 Covers = new BeatmapSetOnlineCovers { Cover = coverUrl }
             }
@@ -148,7 +149,7 @@ namespace osu.Game.Tests.Visual.UserInterface
                 this.loadDelay = loadDelay;
             }
 
-            protected override Drawable CreateDrawable(BeatmapSetInfo model)
+            protected override Drawable CreateDrawable(IBeatmapSetOnlineInfo model)
             {
                 if (model == null)
                     return null;
@@ -167,7 +168,7 @@ namespace osu.Game.Tests.Visual.UserInterface
         {
             private readonly int loadDelay;
 
-            public TestBeatmapSetCover(BeatmapSetInfo set, int loadDelay)
+            public TestBeatmapSetCover(IBeatmapSetOnlineInfo set, int loadDelay)
                 : base(set)
             {
                 this.loadDelay = loadDelay;
diff --git a/osu.Game.Tournament/Components/TournamentBeatmapPanel.cs b/osu.Game.Tournament/Components/TournamentBeatmapPanel.cs
index 0e5a66e7fe..a31430495d 100644
--- a/osu.Game.Tournament/Components/TournamentBeatmapPanel.cs
+++ b/osu.Game.Tournament/Components/TournamentBeatmapPanel.cs
@@ -10,7 +10,6 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Graphics.Textures;
-using osu.Framework.Localisation;
 using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.Drawables;
 using osu.Game.Graphics;
@@ -21,7 +20,8 @@ namespace osu.Game.Tournament.Components
 {
     public class TournamentBeatmapPanel : CompositeDrawable
     {
-        public readonly BeatmapInfo BeatmapInfo;
+        public readonly IBeatmapInfo BeatmapInfo;
+
         private readonly string mod;
 
         private const float horizontal_padding = 10;
@@ -32,12 +32,13 @@ namespace osu.Game.Tournament.Components
         private readonly Bindable<TournamentMatch> currentMatch = new Bindable<TournamentMatch>();
         private Box flash;
 
-        public TournamentBeatmapPanel(BeatmapInfo beatmapInfo, string mod = null)
+        public TournamentBeatmapPanel(IBeatmapInfo beatmapInfo, string mod = null)
         {
             if (beatmapInfo == null) throw new ArgumentNullException(nameof(beatmapInfo));
 
             BeatmapInfo = beatmapInfo;
             this.mod = mod;
+
             Width = 400;
             Height = HEIGHT;
         }
@@ -61,7 +62,7 @@ namespace osu.Game.Tournament.Components
                 {
                     RelativeSizeAxes = Axes.Both,
                     Colour = OsuColour.Gray(0.5f),
-                    BeatmapSet = BeatmapInfo.BeatmapSet,
+                    BeatmapSet = BeatmapInfo.BeatmapSet as IBeatmapSetOnlineInfo,
                 },
                 new FillFlowContainer
                 {
@@ -74,9 +75,7 @@ namespace osu.Game.Tournament.Components
                     {
                         new TournamentSpriteText
                         {
-                            Text = new RomanisableString(
-                                $"{BeatmapInfo.Metadata.ArtistUnicode ?? BeatmapInfo.Metadata.Artist} - {BeatmapInfo.Metadata.TitleUnicode ?? BeatmapInfo.Metadata.Title}",
-                                $"{BeatmapInfo.Metadata.Artist} - {BeatmapInfo.Metadata.Title}"),
+                            Text = BeatmapInfo.GetDisplayTitleRomanisable(false),
                             Font = OsuFont.Torus.With(weight: FontWeight.Bold),
                         },
                         new FillFlowContainer
@@ -93,7 +92,7 @@ namespace osu.Game.Tournament.Components
                                 },
                                 new TournamentSpriteText
                                 {
-                                    Text = BeatmapInfo.Metadata.AuthorString,
+                                    Text = BeatmapInfo.Metadata?.Author,
                                     Padding = new MarginPadding { Right = 20 },
                                     Font = OsuFont.Torus.With(weight: FontWeight.Bold, size: 14)
                                 },
@@ -105,7 +104,7 @@ namespace osu.Game.Tournament.Components
                                 },
                                 new TournamentSpriteText
                                 {
-                                    Text = BeatmapInfo.Version,
+                                    Text = BeatmapInfo.DifficultyName,
                                     Font = OsuFont.Torus.With(weight: FontWeight.Bold, size: 14)
                                 },
                             }
@@ -149,7 +148,7 @@ namespace osu.Game.Tournament.Components
 
         private void updateState()
         {
-            var found = currentMatch.Value.PicksBans.FirstOrDefault(p => p.BeatmapID == BeatmapInfo.OnlineBeatmapID);
+            var found = currentMatch.Value.PicksBans.FirstOrDefault(p => p.BeatmapID == BeatmapInfo.OnlineID);
 
             bool doFlash = found != choice;
             choice = found;
diff --git a/osu.Game.Tournament/Screens/MapPool/MapPoolScreen.cs b/osu.Game.Tournament/Screens/MapPool/MapPoolScreen.cs
index 1e3c550323..5f6546c303 100644
--- a/osu.Game.Tournament/Screens/MapPool/MapPoolScreen.cs
+++ b/osu.Game.Tournament/Screens/MapPool/MapPoolScreen.cs
@@ -147,11 +147,11 @@ namespace osu.Game.Tournament.Screens.MapPool
 
             if (map != null)
             {
-                if (e.Button == MouseButton.Left && map.BeatmapInfo.OnlineBeatmapID != null)
-                    addForBeatmap(map.BeatmapInfo.OnlineBeatmapID.Value);
+                if (e.Button == MouseButton.Left && map.BeatmapInfo.OnlineID > 0)
+                    addForBeatmap(map.BeatmapInfo.OnlineID);
                 else
                 {
-                    var existing = CurrentMatch.Value.PicksBans.FirstOrDefault(p => p.BeatmapID == map.BeatmapInfo.OnlineBeatmapID);
+                    var existing = CurrentMatch.Value.PicksBans.FirstOrDefault(p => p.BeatmapID == map.BeatmapInfo.OnlineID);
 
                     if (existing != null)
                     {
diff --git a/osu.Game/Beatmaps/BeatmapInfoExtensions.cs b/osu.Game/Beatmaps/BeatmapInfoExtensions.cs
index eba19ac1a1..836302c424 100644
--- a/osu.Game/Beatmaps/BeatmapInfoExtensions.cs
+++ b/osu.Game/Beatmaps/BeatmapInfoExtensions.cs
@@ -16,12 +16,17 @@ namespace osu.Game.Beatmaps
         /// <summary>
         /// A user-presentable display title representing this beatmap, with localisation handling for potentially romanisable fields.
         /// </summary>
-        public static RomanisableString GetDisplayTitleRomanisable(this IBeatmapInfo beatmapInfo)
+        public static RomanisableString GetDisplayTitleRomanisable(this IBeatmapInfo beatmapInfo, bool includeDifficultyName = true)
         {
             var metadata = getClosestMetadata(beatmapInfo).GetDisplayTitleRomanisable();
-            var versionString = getVersionString(beatmapInfo);
 
-            return new RomanisableString($"{metadata.GetPreferred(true)} {versionString}".Trim(), $"{metadata.GetPreferred(false)} {versionString}".Trim());
+            if (includeDifficultyName)
+            {
+                var versionString = getVersionString(beatmapInfo);
+                return new RomanisableString($"{metadata.GetPreferred(true)} {versionString}".Trim(), $"{metadata.GetPreferred(false)} {versionString}".Trim());
+            }
+
+            return new RomanisableString($"{metadata.GetPreferred(true)}".Trim(), $"{metadata.GetPreferred(false)}".Trim());
         }
 
         public static string[] GetSearchableTerms(this IBeatmapInfo beatmapInfo) => new[]
diff --git a/osu.Game/Beatmaps/BeatmapSetInfo.cs b/osu.Game/Beatmaps/BeatmapSetInfo.cs
index e8c77e792f..c3e2399d53 100644
--- a/osu.Game/Beatmaps/BeatmapSetInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapSetInfo.cs
@@ -6,13 +6,15 @@ using System.Collections.Generic;
 using System.ComponentModel.DataAnnotations.Schema;
 using System.Linq;
 using JetBrains.Annotations;
+using Newtonsoft.Json;
 using osu.Framework.Testing;
 using osu.Game.Database;
+using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Beatmaps
 {
     [ExcludeFromDynamicCompile]
-    public class BeatmapSetInfo : IHasPrimaryKey, IHasFiles<BeatmapSetFileInfo>, ISoftDelete, IEquatable<BeatmapSetInfo>, IBeatmapSetInfo
+    public class BeatmapSetInfo : IHasPrimaryKey, IHasFiles<BeatmapSetFileInfo>, ISoftDelete, IEquatable<BeatmapSetInfo>, IBeatmapSetInfo, IBeatmapSetOnlineInfo
     {
         public int ID { get; set; }
 
@@ -26,8 +28,6 @@ namespace osu.Game.Beatmaps
 
         public DateTimeOffset DateAdded { get; set; }
 
-        public BeatmapSetOnlineStatus Status { get; set; } = BeatmapSetOnlineStatus.None;
-
         public BeatmapMetadata Metadata { get; set; }
 
         public List<BeatmapInfo> Beatmaps { get; set; }
@@ -36,7 +36,7 @@ namespace osu.Game.Beatmaps
         public List<BeatmapSetFileInfo> Files { get; set; } = new List<BeatmapSetFileInfo>();
 
         [NotMapped]
-        public BeatmapSetOnlineInfo OnlineInfo { get; set; }
+        public APIBeatmapSet OnlineInfo { get; set; }
 
         [NotMapped]
         public BeatmapSetMetrics Metrics { get; set; }
@@ -102,5 +102,141 @@ namespace osu.Game.Beatmaps
         IEnumerable<INamedFileUsage> IBeatmapSetInfo.Files => Files;
 
         #endregion
+
+        #region Delegation for IBeatmapSetOnlineInfo
+
+        [NotMapped]
+        [JsonIgnore]
+        public DateTimeOffset Submitted
+        {
+            get => OnlineInfo.Submitted;
+            set => OnlineInfo.Submitted = value;
+        }
+
+        [NotMapped]
+        [JsonIgnore]
+        public DateTimeOffset? Ranked
+        {
+            get => OnlineInfo.Ranked;
+            set => OnlineInfo.Ranked = value;
+        }
+
+        [NotMapped]
+        [JsonIgnore]
+        public DateTimeOffset? LastUpdated
+        {
+            get => OnlineInfo.LastUpdated;
+            set => OnlineInfo.LastUpdated = value;
+        }
+
+        [NotMapped]
+        [JsonIgnore]
+        public BeatmapSetOnlineStatus Status { get; set; } = BeatmapSetOnlineStatus.None;
+
+        [NotMapped]
+        [JsonIgnore]
+        public bool HasExplicitContent
+        {
+            get => OnlineInfo.HasExplicitContent;
+            set => OnlineInfo.HasExplicitContent = value;
+        }
+
+        [NotMapped]
+        [JsonIgnore]
+        public bool HasVideo
+        {
+            get => OnlineInfo.HasVideo;
+            set => OnlineInfo.HasVideo = value;
+        }
+
+        [NotMapped]
+        [JsonIgnore]
+        public bool HasStoryboard
+        {
+            get => OnlineInfo.HasStoryboard;
+            set => OnlineInfo.HasStoryboard = value;
+        }
+
+        [NotMapped]
+        [JsonIgnore]
+        public BeatmapSetOnlineCovers Covers
+        {
+            get => OnlineInfo.Covers;
+            set => OnlineInfo.Covers = value;
+        }
+
+        [NotMapped]
+        [JsonIgnore]
+        public string Preview
+        {
+            get => OnlineInfo.Preview;
+            set => OnlineInfo.Preview = value;
+        }
+
+        [NotMapped]
+        [JsonIgnore]
+        public double BPM
+        {
+            get => OnlineInfo.BPM;
+            set => OnlineInfo.BPM = value;
+        }
+
+        [NotMapped]
+        [JsonIgnore]
+        public int PlayCount
+        {
+            get => OnlineInfo.PlayCount;
+            set => OnlineInfo.PlayCount = value;
+        }
+
+        [NotMapped]
+        [JsonIgnore]
+        public int FavouriteCount
+        {
+            get => OnlineInfo.FavouriteCount;
+            set => OnlineInfo.FavouriteCount = value;
+        }
+
+        [NotMapped]
+        [JsonIgnore]
+        public bool HasFavourited
+        {
+            get => OnlineInfo.HasFavourited;
+            set => OnlineInfo.HasFavourited = value;
+        }
+
+        [NotMapped]
+        [JsonIgnore]
+        public BeatmapSetOnlineAvailability Availability
+        {
+            get => OnlineInfo.Availability;
+            set => OnlineInfo.Availability = value;
+        }
+
+        [NotMapped]
+        [JsonIgnore]
+        public BeatmapSetOnlineGenre Genre
+        {
+            get => OnlineInfo.Genre;
+            set => OnlineInfo.Genre = value;
+        }
+
+        [NotMapped]
+        [JsonIgnore]
+        public BeatmapSetOnlineLanguage Language
+        {
+            get => OnlineInfo.Language;
+            set => OnlineInfo.Language = value;
+        }
+
+        [NotMapped]
+        [JsonIgnore]
+        public int? TrackId
+        {
+            get => OnlineInfo.TrackId;
+            set => OnlineInfo.TrackId = value;
+        }
+
+        #endregion
     }
 }
diff --git a/osu.Game/Beatmaps/BeatmapSetOnlineInfo.cs b/osu.Game/Beatmaps/BeatmapSetOnlineInfo.cs
index 3658dbab83..e51729f273 100644
--- a/osu.Game/Beatmaps/BeatmapSetOnlineInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapSetOnlineInfo.cs
@@ -9,7 +9,7 @@ namespace osu.Game.Beatmaps
     /// <summary>
     /// Beatmap set info retrieved for previewing locally without having the set downloaded.
     /// </summary>
-    public class BeatmapSetOnlineInfo
+    public interface IBeatmapSetOnlineInfo
     {
         /// <summary>
         /// The date this beatmap set was submitted to the online listing.
diff --git a/osu.Game/Beatmaps/Drawables/BeatmapSetCover.cs b/osu.Game/Beatmaps/Drawables/BeatmapSetCover.cs
index 5245bc319d..50c08ee2a3 100644
--- a/osu.Game/Beatmaps/Drawables/BeatmapSetCover.cs
+++ b/osu.Game/Beatmaps/Drawables/BeatmapSetCover.cs
@@ -11,10 +11,10 @@ namespace osu.Game.Beatmaps.Drawables
     [LongRunningLoad]
     public class BeatmapSetCover : Sprite
     {
-        private readonly BeatmapSetInfo set;
+        private readonly IBeatmapSetOnlineInfo set;
         private readonly BeatmapSetCoverType type;
 
-        public BeatmapSetCover(BeatmapSetInfo set, BeatmapSetCoverType type = BeatmapSetCoverType.Cover)
+        public BeatmapSetCover(IBeatmapSetOnlineInfo set, BeatmapSetCoverType type = BeatmapSetCoverType.Cover)
         {
             if (set == null)
                 throw new ArgumentNullException(nameof(set));
@@ -31,15 +31,15 @@ namespace osu.Game.Beatmaps.Drawables
             switch (type)
             {
                 case BeatmapSetCoverType.Cover:
-                    resource = set.OnlineInfo.Covers.Cover;
+                    resource = set.Covers.Cover;
                     break;
 
                 case BeatmapSetCoverType.Card:
-                    resource = set.OnlineInfo.Covers.Card;
+                    resource = set.Covers.Card;
                     break;
 
                 case BeatmapSetCoverType.List:
-                    resource = set.OnlineInfo.Covers.List;
+                    resource = set.Covers.List;
                     break;
             }
 
diff --git a/osu.Game/Beatmaps/Drawables/UpdateableBeatmapSetCover.cs b/osu.Game/Beatmaps/Drawables/UpdateableBeatmapSetCover.cs
index 7248c9213c..8bfe98c26b 100644
--- a/osu.Game/Beatmaps/Drawables/UpdateableBeatmapSetCover.cs
+++ b/osu.Game/Beatmaps/Drawables/UpdateableBeatmapSetCover.cs
@@ -9,11 +9,11 @@ using osu.Game.Graphics;
 
 namespace osu.Game.Beatmaps.Drawables
 {
-    public class UpdateableBeatmapSetCover : ModelBackedDrawable<BeatmapSetInfo>
+    public class UpdateableBeatmapSetCover : ModelBackedDrawable<IBeatmapSetOnlineInfo>
     {
         private readonly BeatmapSetCoverType coverType;
 
-        public BeatmapSetInfo BeatmapSet
+        public IBeatmapSetOnlineInfo BeatmapSet
         {
             get => Model;
             set => Model = value;
@@ -43,7 +43,7 @@ namespace osu.Game.Beatmaps.Drawables
         protected override DelayedLoadWrapper CreateDelayedLoadWrapper(Func<Drawable> createContentFunc, double timeBeforeLoad)
             => new DelayedLoadUnloadWrapper(createContentFunc, timeBeforeLoad);
 
-        protected override Drawable CreateDrawable(BeatmapSetInfo model)
+        protected override Drawable CreateDrawable(IBeatmapSetOnlineInfo model)
         {
             if (model == null)
                 return null;
diff --git a/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs b/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs
index 35963792d0..25d69c2797 100644
--- a/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs
@@ -10,10 +10,10 @@ using osu.Game.Rulesets;
 
 namespace osu.Game.Online.API.Requests.Responses
 {
-    public class APIBeatmapSet : BeatmapMetadata // todo: this is a bit wrong...
+    public class APIBeatmapSet : BeatmapMetadata, IBeatmapSetOnlineInfo
     {
         [JsonProperty(@"covers")]
-        private BeatmapSetOnlineCovers covers { get; set; }
+        public BeatmapSetOnlineCovers Covers { get; set; }
 
         private int? onlineBeatmapSetID;
 
@@ -28,43 +28,43 @@ namespace osu.Game.Online.API.Requests.Responses
         public BeatmapSetOnlineStatus Status { get; set; }
 
         [JsonProperty(@"preview_url")]
-        private string preview { get; set; }
+        public string Preview { get; set; }
 
         [JsonProperty(@"has_favourited")]
-        private bool hasFavourited { get; set; }
+        public bool HasFavourited { get; set; }
 
         [JsonProperty(@"play_count")]
-        private int playCount { get; set; }
+        public int PlayCount { get; set; }
 
         [JsonProperty(@"favourite_count")]
-        private int favouriteCount { get; set; }
+        public int FavouriteCount { get; set; }
 
         [JsonProperty(@"bpm")]
-        private double bpm { get; set; }
+        public double BPM { get; set; }
 
         [JsonProperty(@"nsfw")]
-        private bool hasExplicitContent { get; set; }
+        public bool HasExplicitContent { get; set; }
 
         [JsonProperty(@"video")]
-        private bool hasVideo { get; set; }
+        public bool HasVideo { get; set; }
 
         [JsonProperty(@"storyboard")]
-        private bool hasStoryboard { get; set; }
+        public bool HasStoryboard { get; set; }
 
         [JsonProperty(@"submitted_date")]
-        private DateTimeOffset submitted { get; set; }
+        public DateTimeOffset Submitted { get; set; }
 
         [JsonProperty(@"ranked_date")]
-        private DateTimeOffset? ranked { get; set; }
+        public DateTimeOffset? Ranked { get; set; }
 
         [JsonProperty(@"last_updated")]
-        private DateTimeOffset lastUpdated { get; set; }
+        public DateTimeOffset? LastUpdated { get; set; }
 
         [JsonProperty(@"ratings")]
         private int[] ratings { get; set; }
 
         [JsonProperty(@"track_id")]
-        private int? trackId { get; set; }
+        public int? TrackId { get; set; }
 
         [JsonProperty(@"user_id")]
         private int creatorId
@@ -73,13 +73,13 @@ namespace osu.Game.Online.API.Requests.Responses
         }
 
         [JsonProperty(@"availability")]
-        private BeatmapSetOnlineAvailability availability { get; set; }
+        public BeatmapSetOnlineAvailability Availability { get; set; }
 
         [JsonProperty(@"genre")]
-        private BeatmapSetOnlineGenre genre { get; set; }
+        public BeatmapSetOnlineGenre Genre { get; set; }
 
         [JsonProperty(@"language")]
-        private BeatmapSetOnlineLanguage language { get; set; }
+        public BeatmapSetOnlineLanguage Language { get; set; }
 
         [JsonProperty(@"beatmaps")]
         private IEnumerable<APIBeatmap> beatmaps { get; set; }
@@ -92,26 +92,7 @@ namespace osu.Game.Online.API.Requests.Responses
                 Metadata = this,
                 Status = Status,
                 Metrics = ratings == null ? null : new BeatmapSetMetrics { Ratings = ratings },
-                OnlineInfo = new BeatmapSetOnlineInfo
-                {
-                    Covers = covers,
-                    Preview = preview,
-                    PlayCount = playCount,
-                    FavouriteCount = favouriteCount,
-                    BPM = bpm,
-                    Status = Status,
-                    HasExplicitContent = hasExplicitContent,
-                    HasVideo = hasVideo,
-                    HasStoryboard = hasStoryboard,
-                    Submitted = submitted,
-                    Ranked = ranked,
-                    LastUpdated = lastUpdated,
-                    Availability = availability,
-                    HasFavourited = hasFavourited,
-                    Genre = genre,
-                    Language = language,
-                    TrackId = trackId
-                },
+                OnlineInfo = this
             };
 
             beatmapSet.Beatmaps = beatmaps?.Select(b =>
diff --git a/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs b/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs
index 86879ba245..52aa115083 100644
--- a/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs
+++ b/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs
@@ -59,7 +59,7 @@ namespace osu.Game.Online.Rooms
 
         protected override bool VerifyDatabasedModel(BeatmapSetInfo databasedSet)
         {
-            int? beatmapId = SelectedItem.Value?.Beatmap.Value.OnlineBeatmapID;
+            int beatmapId = SelectedItem.Value?.Beatmap.Value.OnlineID ?? -1;
             string checksum = SelectedItem.Value?.Beatmap.Value.MD5Hash;
 
             var matchingBeatmap = databasedSet.Beatmaps.FirstOrDefault(b => b.OnlineBeatmapID == beatmapId && b.MD5Hash == checksum);
@@ -75,10 +75,10 @@ namespace osu.Game.Online.Rooms
 
         protected override bool IsModelAvailableLocally()
         {
-            int? beatmapId = SelectedItem.Value.Beatmap.Value.OnlineBeatmapID;
+            int onlineId = SelectedItem.Value.Beatmap.Value.OnlineID;
             string checksum = SelectedItem.Value.Beatmap.Value.MD5Hash;
 
-            var beatmap = Manager.QueryBeatmap(b => b.OnlineBeatmapID == beatmapId && b.MD5Hash == checksum);
+            var beatmap = Manager.QueryBeatmap(b => b.OnlineBeatmapID == onlineId && b.MD5Hash == checksum);
             return beatmap?.BeatmapSet.DeletePending == false;
         }
 
diff --git a/osu.Game/Screens/OnlinePlay/Components/BeatmapTitle.cs b/osu.Game/Screens/OnlinePlay/Components/BeatmapTitle.cs
index e5a5e35897..2901758332 100644
--- a/osu.Game/Screens/OnlinePlay/Components/BeatmapTitle.cs
+++ b/osu.Game/Screens/OnlinePlay/Components/BeatmapTitle.cs
@@ -86,7 +86,7 @@ namespace osu.Game.Screens.OnlinePlay.Components
                         Text = new RomanisableString(beatmap.Value.Metadata.TitleUnicode, beatmap.Value.Metadata.Title),
                         Font = OsuFont.GetFont(size: TextSize),
                     }
-                }, LinkAction.OpenBeatmap, beatmap.Value.OnlineBeatmapID.ToString(), "Open beatmap");
+                }, LinkAction.OpenBeatmap, beatmap.Value.OnlineID.ToString(), "Open beatmap");
             }
         }
     }
diff --git a/osu.Game/Tests/Beatmaps/TestBeatmap.cs b/osu.Game/Tests/Beatmaps/TestBeatmap.cs
index 2717146c99..d8e72d31a7 100644
--- a/osu.Game/Tests/Beatmaps/TestBeatmap.cs
+++ b/osu.Game/Tests/Beatmaps/TestBeatmap.cs
@@ -8,6 +8,7 @@ using System.Text;
 using osu.Framework.Extensions;
 using osu.Game.Beatmaps;
 using osu.Game.IO;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets;
 using Decoder = osu.Game.Beatmaps.Formats.Decoder;
 
@@ -32,7 +33,7 @@ namespace osu.Game.Tests.Beatmaps
             BeatmapInfo.BeatmapSet.Beatmaps = new List<BeatmapInfo> { BeatmapInfo };
             BeatmapInfo.Length = 75000;
             BeatmapInfo.OnlineInfo = new BeatmapOnlineInfo();
-            BeatmapInfo.BeatmapSet.OnlineInfo = new BeatmapSetOnlineInfo
+            BeatmapInfo.BeatmapSet.OnlineInfo = new APIBeatmapSet
             {
                 Status = BeatmapSetOnlineStatus.Ranked,
                 Covers = new BeatmapSetOnlineCovers

From 32d01f022ff618dd17365d7f810e103613339d58 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 21 Oct 2021 16:53:50 +0900
Subject: [PATCH 0367/5547] Rename usages which rely on online backing

---
 .../TestSceneUpdateableBeatmapSetCover.cs     | 36 +++++++++----------
 .../Components/TournamentBeatmapPanel.cs      |  2 +-
 ...apSetCover.cs => OnlineBeatmapSetCover.cs} |  4 +--
 .../UpdateableBeatmapBackgroundSprite.cs      |  2 +-
 ....cs => UpdateableOnlineBeatmapSetCover.cs} |  6 ++--
 .../BeatmapListingSearchControl.cs            |  4 +--
 .../BeatmapListing/Panels/BeatmapPanel.cs     |  2 +-
 .../BeatmapSet/BeatmapSetHeaderContent.cs     |  4 +--
 .../Dashboard/Home/DashboardBeatmapPanel.cs   |  2 +-
 .../Historical/DrawableMostPlayedBeatmap.cs   |  2 +-
 10 files changed, 32 insertions(+), 32 deletions(-)
 rename osu.Game/Beatmaps/Drawables/{BeatmapSetCover.cs => OnlineBeatmapSetCover.cs} (89%)
 rename osu.Game/Beatmaps/Drawables/{UpdateableBeatmapSetCover.cs => UpdateableOnlineBeatmapSetCover.cs} (85%)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneUpdateableBeatmapSetCover.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneUpdateableBeatmapSetCover.cs
index 01e628075c..3ac3002713 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneUpdateableBeatmapSetCover.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneUpdateableBeatmapSetCover.cs
@@ -23,21 +23,21 @@ namespace osu.Game.Tests.Visual.UserInterface
         [Test]
         public void TestLocal([Values] BeatmapSetCoverType coverType)
         {
-            AddStep("setup cover", () => Child = new UpdateableBeatmapSetCover(coverType)
+            AddStep("setup cover", () => Child = new UpdateableOnlineBeatmapSetCover(coverType)
             {
                 BeatmapSet = CreateBeatmap(Ruleset.Value).BeatmapInfo.BeatmapSet,
                 RelativeSizeAxes = Axes.Both,
                 Masking = true,
             });
 
-            AddUntilStep("wait for load", () => this.ChildrenOfType<BeatmapSetCover>().SingleOrDefault()?.IsLoaded ?? false);
+            AddUntilStep("wait for load", () => this.ChildrenOfType<OnlineBeatmapSetCover>().SingleOrDefault()?.IsLoaded ?? false);
         }
 
         [Test]
         public void TestUnloadAndReload()
         {
             OsuScrollContainer scroll = null;
-            List<UpdateableBeatmapSetCover> covers = new List<UpdateableBeatmapSetCover>();
+            List<UpdateableOnlineBeatmapSetCover> covers = new List<UpdateableOnlineBeatmapSetCover>();
 
             AddStep("setup covers", () =>
             {
@@ -66,7 +66,7 @@ namespace osu.Game.Tests.Visual.UserInterface
                 {
                     var coverType = coverTypes[i % coverTypes.Count];
 
-                    var cover = new UpdateableBeatmapSetCover(coverType)
+                    var cover = new UpdateableOnlineBeatmapSetCover(coverType)
                     {
                         BeatmapSet = setInfo,
                         Height = 100,
@@ -85,7 +85,7 @@ namespace osu.Game.Tests.Visual.UserInterface
                 }
             });
 
-            var loadedCovers = covers.Where(c => c.ChildrenOfType<BeatmapSetCover>().SingleOrDefault()?.IsLoaded ?? false);
+            var loadedCovers = covers.Where(c => c.ChildrenOfType<OnlineBeatmapSetCover>().SingleOrDefault()?.IsLoaded ?? false);
 
             AddUntilStep("some loaded", () => loadedCovers.Any());
             AddStep("scroll to end", () => scroll.ScrollToEnd());
@@ -95,9 +95,9 @@ namespace osu.Game.Tests.Visual.UserInterface
         [Test]
         public void TestSetNullBeatmapWhileLoading()
         {
-            TestUpdateableBeatmapSetCover updateableCover = null;
+            TestUpdateableOnlineBeatmapSetCover updateableCover = null;
 
-            AddStep("setup cover", () => Child = updateableCover = new TestUpdateableBeatmapSetCover
+            AddStep("setup cover", () => Child = updateableCover = new TestUpdateableOnlineBeatmapSetCover
             {
                 BeatmapSet = CreateBeatmap(Ruleset.Value).BeatmapInfo.BeatmapSet,
                 RelativeSizeAxes = Axes.Both,
@@ -112,10 +112,10 @@ namespace osu.Game.Tests.Visual.UserInterface
         [Test]
         public void TestCoverChangeOnNewBeatmap()
         {
-            TestUpdateableBeatmapSetCover updateableCover = null;
-            BeatmapSetCover initialCover = null;
+            TestUpdateableOnlineBeatmapSetCover updateableCover = null;
+            OnlineBeatmapSetCover initialCover = null;
 
-            AddStep("setup cover", () => Child = updateableCover = new TestUpdateableBeatmapSetCover(0)
+            AddStep("setup cover", () => Child = updateableCover = new TestUpdateableOnlineBeatmapSetCover(0)
             {
                 BeatmapSet = createBeatmapWithCover("https://assets.ppy.sh/beatmaps/1189904/covers/cover.jpg"),
                 RelativeSizeAxes = Axes.Both,
@@ -123,13 +123,13 @@ namespace osu.Game.Tests.Visual.UserInterface
                 Alpha = 0.4f
             });
 
-            AddUntilStep("cover loaded", () => updateableCover.ChildrenOfType<BeatmapSetCover>().Any());
-            AddStep("store initial cover", () => initialCover = updateableCover.ChildrenOfType<BeatmapSetCover>().Single());
+            AddUntilStep("cover loaded", () => updateableCover.ChildrenOfType<OnlineBeatmapSetCover>().Any());
+            AddStep("store initial cover", () => initialCover = updateableCover.ChildrenOfType<OnlineBeatmapSetCover>().Single());
             AddUntilStep("wait for fade complete", () => initialCover.Alpha == 1);
 
             AddStep("switch beatmap",
                 () => updateableCover.BeatmapSet = createBeatmapWithCover("https://assets.ppy.sh/beatmaps/1079428/covers/cover.jpg"));
-            AddUntilStep("new cover loaded", () => updateableCover.ChildrenOfType<BeatmapSetCover>().Except(new[] { initialCover }).Any());
+            AddUntilStep("new cover loaded", () => updateableCover.ChildrenOfType<OnlineBeatmapSetCover>().Except(new[] { initialCover }).Any());
         }
 
         private static BeatmapSetInfo createBeatmapWithCover(string coverUrl) => new BeatmapSetInfo
@@ -140,11 +140,11 @@ namespace osu.Game.Tests.Visual.UserInterface
             }
         };
 
-        private class TestUpdateableBeatmapSetCover : UpdateableBeatmapSetCover
+        private class TestUpdateableOnlineBeatmapSetCover : UpdateableOnlineBeatmapSetCover
         {
             private readonly int loadDelay;
 
-            public TestUpdateableBeatmapSetCover(int loadDelay = 10000)
+            public TestUpdateableOnlineBeatmapSetCover(int loadDelay = 10000)
             {
                 this.loadDelay = loadDelay;
             }
@@ -154,7 +154,7 @@ namespace osu.Game.Tests.Visual.UserInterface
                 if (model == null)
                     return null;
 
-                return new TestBeatmapSetCover(model, loadDelay)
+                return new TestOnlineBeatmapSetCover(model, loadDelay)
                 {
                     Anchor = Anchor.Centre,
                     Origin = Anchor.Centre,
@@ -164,11 +164,11 @@ namespace osu.Game.Tests.Visual.UserInterface
             }
         }
 
-        private class TestBeatmapSetCover : BeatmapSetCover
+        private class TestOnlineBeatmapSetCover : OnlineBeatmapSetCover
         {
             private readonly int loadDelay;
 
-            public TestBeatmapSetCover(IBeatmapSetOnlineInfo set, int loadDelay)
+            public TestOnlineBeatmapSetCover(IBeatmapSetOnlineInfo set, int loadDelay)
                 : base(set)
             {
                 this.loadDelay = loadDelay;
diff --git a/osu.Game.Tournament/Components/TournamentBeatmapPanel.cs b/osu.Game.Tournament/Components/TournamentBeatmapPanel.cs
index a31430495d..be29566e07 100644
--- a/osu.Game.Tournament/Components/TournamentBeatmapPanel.cs
+++ b/osu.Game.Tournament/Components/TournamentBeatmapPanel.cs
@@ -58,7 +58,7 @@ namespace osu.Game.Tournament.Components
                     RelativeSizeAxes = Axes.Both,
                     Colour = Color4.Black,
                 },
-                new UpdateableBeatmapSetCover
+                new UpdateableOnlineBeatmapSetCover
                 {
                     RelativeSizeAxes = Axes.Both,
                     Colour = OsuColour.Gray(0.5f),
diff --git a/osu.Game/Beatmaps/Drawables/BeatmapSetCover.cs b/osu.Game/Beatmaps/Drawables/OnlineBeatmapSetCover.cs
similarity index 89%
rename from osu.Game/Beatmaps/Drawables/BeatmapSetCover.cs
rename to osu.Game/Beatmaps/Drawables/OnlineBeatmapSetCover.cs
index 50c08ee2a3..0b19c27022 100644
--- a/osu.Game/Beatmaps/Drawables/BeatmapSetCover.cs
+++ b/osu.Game/Beatmaps/Drawables/OnlineBeatmapSetCover.cs
@@ -9,12 +9,12 @@ using osu.Framework.Graphics.Textures;
 namespace osu.Game.Beatmaps.Drawables
 {
     [LongRunningLoad]
-    public class BeatmapSetCover : Sprite
+    public class OnlineBeatmapSetCover : Sprite
     {
         private readonly IBeatmapSetOnlineInfo set;
         private readonly BeatmapSetCoverType type;
 
-        public BeatmapSetCover(IBeatmapSetOnlineInfo set, BeatmapSetCoverType type = BeatmapSetCoverType.Cover)
+        public OnlineBeatmapSetCover(IBeatmapSetOnlineInfo set, BeatmapSetCoverType type = BeatmapSetCoverType.Cover)
         {
             if (set == null)
                 throw new ArgumentNullException(nameof(set));
diff --git a/osu.Game/Beatmaps/Drawables/UpdateableBeatmapBackgroundSprite.cs b/osu.Game/Beatmaps/Drawables/UpdateableBeatmapBackgroundSprite.cs
index 3206f7b3ab..8943ad350e 100644
--- a/osu.Game/Beatmaps/Drawables/UpdateableBeatmapBackgroundSprite.cs
+++ b/osu.Game/Beatmaps/Drawables/UpdateableBeatmapBackgroundSprite.cs
@@ -54,7 +54,7 @@ namespace osu.Game.Beatmaps.Drawables
         {
             // prefer online cover where available.
             if (model?.BeatmapSet?.OnlineInfo != null)
-                return new BeatmapSetCover(model.BeatmapSet, beatmapSetCoverType);
+                return new OnlineBeatmapSetCover(model.BeatmapSet, beatmapSetCoverType);
 
             return model?.ID > 0
                 ? new BeatmapBackgroundSprite(beatmaps.GetWorkingBeatmap(model))
diff --git a/osu.Game/Beatmaps/Drawables/UpdateableBeatmapSetCover.cs b/osu.Game/Beatmaps/Drawables/UpdateableOnlineBeatmapSetCover.cs
similarity index 85%
rename from osu.Game/Beatmaps/Drawables/UpdateableBeatmapSetCover.cs
rename to osu.Game/Beatmaps/Drawables/UpdateableOnlineBeatmapSetCover.cs
index 8bfe98c26b..73f87beb58 100644
--- a/osu.Game/Beatmaps/Drawables/UpdateableBeatmapSetCover.cs
+++ b/osu.Game/Beatmaps/Drawables/UpdateableOnlineBeatmapSetCover.cs
@@ -9,7 +9,7 @@ using osu.Game.Graphics;
 
 namespace osu.Game.Beatmaps.Drawables
 {
-    public class UpdateableBeatmapSetCover : ModelBackedDrawable<IBeatmapSetOnlineInfo>
+    public class UpdateableOnlineBeatmapSetCover : ModelBackedDrawable<IBeatmapSetOnlineInfo>
     {
         private readonly BeatmapSetCoverType coverType;
 
@@ -25,7 +25,7 @@ namespace osu.Game.Beatmaps.Drawables
             set => base.Masking = value;
         }
 
-        public UpdateableBeatmapSetCover(BeatmapSetCoverType coverType = BeatmapSetCoverType.Cover)
+        public UpdateableOnlineBeatmapSetCover(BeatmapSetCoverType coverType = BeatmapSetCoverType.Cover)
         {
             this.coverType = coverType;
 
@@ -48,7 +48,7 @@ namespace osu.Game.Beatmaps.Drawables
             if (model == null)
                 return null;
 
-            return new BeatmapSetCover(model, coverType)
+            return new OnlineBeatmapSetCover(model, coverType)
             {
                 RelativeSizeAxes = Axes.Both,
                 Anchor = Anchor.Centre,
diff --git a/osu.Game/Overlays/BeatmapListing/BeatmapListingSearchControl.cs b/osu.Game/Overlays/BeatmapListing/BeatmapListingSearchControl.cs
index bbde03aa10..da2dcfebdf 100644
--- a/osu.Game/Overlays/BeatmapListing/BeatmapListingSearchControl.cs
+++ b/osu.Game/Overlays/BeatmapListing/BeatmapListingSearchControl.cs
@@ -76,7 +76,7 @@ namespace osu.Game.Overlays.BeatmapListing
         private readonly BeatmapSearchFilterRow<SearchExplicit> explicitContentFilter;
 
         private readonly Box background;
-        private readonly UpdateableBeatmapSetCover beatmapCover;
+        private readonly UpdateableOnlineBeatmapSetCover beatmapCover;
 
         public BeatmapListingSearchControl()
         {
@@ -196,7 +196,7 @@ namespace osu.Game.Overlays.BeatmapListing
             }
         }
 
-        private class TopSearchBeatmapSetCover : UpdateableBeatmapSetCover
+        private class TopSearchBeatmapSetCover : UpdateableOnlineBeatmapSetCover
         {
             protected override bool TransformImmediately => true;
         }
diff --git a/osu.Game/Overlays/BeatmapListing/Panels/BeatmapPanel.cs b/osu.Game/Overlays/BeatmapListing/Panels/BeatmapPanel.cs
index 9ff39ce1dd..779f3860f2 100644
--- a/osu.Game/Overlays/BeatmapListing/Panels/BeatmapPanel.cs
+++ b/osu.Game/Overlays/BeatmapListing/Panels/BeatmapPanel.cs
@@ -160,7 +160,7 @@ namespace osu.Game.Overlays.BeatmapListing.Panels
             return icons;
         }
 
-        protected Drawable CreateBackground() => new UpdateableBeatmapSetCover
+        protected Drawable CreateBackground() => new UpdateableOnlineBeatmapSetCover
         {
             RelativeSizeAxes = Axes.Both,
             BeatmapSet = SetInfo,
diff --git a/osu.Game/Overlays/BeatmapSet/BeatmapSetHeaderContent.cs b/osu.Game/Overlays/BeatmapSet/BeatmapSetHeaderContent.cs
index dcf06ac7fb..fc2f90807e 100644
--- a/osu.Game/Overlays/BeatmapSet/BeatmapSetHeaderContent.cs
+++ b/osu.Game/Overlays/BeatmapSet/BeatmapSetHeaderContent.cs
@@ -32,7 +32,7 @@ namespace osu.Game.Overlays.BeatmapSet
         public readonly Details Details;
         public readonly BeatmapPicker Picker;
 
-        private readonly UpdateableBeatmapSetCover cover;
+        private readonly UpdateableOnlineBeatmapSetCover cover;
         private readonly Box coverGradient;
         private readonly OsuSpriteText title, artist;
         private readonly AuthorInfo author;
@@ -68,7 +68,7 @@ namespace osu.Game.Overlays.BeatmapSet
                         RelativeSizeAxes = Axes.Both,
                         Children = new Drawable[]
                         {
-                            cover = new UpdateableBeatmapSetCover
+                            cover = new UpdateableOnlineBeatmapSetCover
                             {
                                 RelativeSizeAxes = Axes.Both,
                                 Masking = true,
diff --git a/osu.Game/Overlays/Dashboard/Home/DashboardBeatmapPanel.cs b/osu.Game/Overlays/Dashboard/Home/DashboardBeatmapPanel.cs
index 3badea155d..edc737d8fe 100644
--- a/osu.Game/Overlays/Dashboard/Home/DashboardBeatmapPanel.cs
+++ b/osu.Game/Overlays/Dashboard/Home/DashboardBeatmapPanel.cs
@@ -77,7 +77,7 @@ namespace osu.Game.Overlays.Dashboard.Home
                                     RelativeSizeAxes = Axes.Both,
                                     Masking = true,
                                     CornerRadius = 6,
-                                    Child = new UpdateableBeatmapSetCover
+                                    Child = new UpdateableOnlineBeatmapSetCover
                                     {
                                         RelativeSizeAxes = Axes.Both,
                                         Anchor = Anchor.Centre,
diff --git a/osu.Game/Overlays/Profile/Sections/Historical/DrawableMostPlayedBeatmap.cs b/osu.Game/Overlays/Profile/Sections/Historical/DrawableMostPlayedBeatmap.cs
index 2c6fa76ca4..32201e36a9 100644
--- a/osu.Game/Overlays/Profile/Sections/Historical/DrawableMostPlayedBeatmap.cs
+++ b/osu.Game/Overlays/Profile/Sections/Historical/DrawableMostPlayedBeatmap.cs
@@ -42,7 +42,7 @@ namespace osu.Game.Overlays.Profile.Sections.Historical
         {
             AddRangeInternal(new Drawable[]
             {
-                new UpdateableBeatmapSetCover(BeatmapSetCoverType.List)
+                new UpdateableOnlineBeatmapSetCover(BeatmapSetCoverType.List)
                 {
                     RelativeSizeAxes = Axes.Y,
                     Width = cover_width,

From b73bd54ab2bbd47ed105d418182da780f6b333d2 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 21 Oct 2021 16:54:32 +0900
Subject: [PATCH 0368/5547] Split out individual pieces into own files

---
 .../Beatmaps/BeatmapSetOnlineAvailability.cs  | 16 +++++++
 osu.Game/Beatmaps/BeatmapSetOnlineCovers.cs   | 25 +++++++++++
 osu.Game/Beatmaps/BeatmapSetOnlineGenre.cs    | 11 +++++
 osu.Game/Beatmaps/BeatmapSetOnlineLanguage.cs | 11 +++++
 ...OnlineInfo.cs => IBeatmapSetOnlineInfo.cs} | 45 +------------------
 5 files changed, 64 insertions(+), 44 deletions(-)
 create mode 100644 osu.Game/Beatmaps/BeatmapSetOnlineAvailability.cs
 create mode 100644 osu.Game/Beatmaps/BeatmapSetOnlineCovers.cs
 create mode 100644 osu.Game/Beatmaps/BeatmapSetOnlineGenre.cs
 create mode 100644 osu.Game/Beatmaps/BeatmapSetOnlineLanguage.cs
 rename osu.Game/Beatmaps/{BeatmapSetOnlineInfo.cs => IBeatmapSetOnlineInfo.cs} (72%)

diff --git a/osu.Game/Beatmaps/BeatmapSetOnlineAvailability.cs b/osu.Game/Beatmaps/BeatmapSetOnlineAvailability.cs
new file mode 100644
index 0000000000..8c67aa2404
--- /dev/null
+++ b/osu.Game/Beatmaps/BeatmapSetOnlineAvailability.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 Newtonsoft.Json;
+
+namespace osu.Game.Beatmaps
+{
+    public class BeatmapSetOnlineAvailability
+    {
+        [JsonProperty(@"download_disabled")]
+        public bool DownloadDisabled { get; set; }
+
+        [JsonProperty(@"more_information")]
+        public string ExternalLink { get; set; }
+    }
+}
diff --git a/osu.Game/Beatmaps/BeatmapSetOnlineCovers.cs b/osu.Game/Beatmaps/BeatmapSetOnlineCovers.cs
new file mode 100644
index 0000000000..8d6e85391d
--- /dev/null
+++ b/osu.Game/Beatmaps/BeatmapSetOnlineCovers.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 Newtonsoft.Json;
+
+namespace osu.Game.Beatmaps
+{
+    public class BeatmapSetOnlineCovers
+    {
+        public string CoverLowRes { get; set; }
+
+        [JsonProperty(@"cover@2x")]
+        public string Cover { get; set; }
+
+        public string CardLowRes { get; set; }
+
+        [JsonProperty(@"card@2x")]
+        public string Card { get; set; }
+
+        public string ListLowRes { get; set; }
+
+        [JsonProperty(@"list@2x")]
+        public string List { get; set; }
+    }
+}
diff --git a/osu.Game/Beatmaps/BeatmapSetOnlineGenre.cs b/osu.Game/Beatmaps/BeatmapSetOnlineGenre.cs
new file mode 100644
index 0000000000..65d6dfe5d9
--- /dev/null
+++ b/osu.Game/Beatmaps/BeatmapSetOnlineGenre.cs
@@ -0,0 +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.
+
+namespace osu.Game.Beatmaps
+{
+    public class BeatmapSetOnlineGenre
+    {
+        public int Id { get; set; }
+        public string Name { get; set; }
+    }
+}
diff --git a/osu.Game/Beatmaps/BeatmapSetOnlineLanguage.cs b/osu.Game/Beatmaps/BeatmapSetOnlineLanguage.cs
new file mode 100644
index 0000000000..057325f319
--- /dev/null
+++ b/osu.Game/Beatmaps/BeatmapSetOnlineLanguage.cs
@@ -0,0 +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.
+
+namespace osu.Game.Beatmaps
+{
+    public class BeatmapSetOnlineLanguage
+    {
+        public int Id { get; set; }
+        public string Name { get; set; }
+    }
+}
diff --git a/osu.Game/Beatmaps/BeatmapSetOnlineInfo.cs b/osu.Game/Beatmaps/IBeatmapSetOnlineInfo.cs
similarity index 72%
rename from osu.Game/Beatmaps/BeatmapSetOnlineInfo.cs
rename to osu.Game/Beatmaps/IBeatmapSetOnlineInfo.cs
index e51729f273..7f1ba41fb6 100644
--- a/osu.Game/Beatmaps/BeatmapSetOnlineInfo.cs
+++ b/osu.Game/Beatmaps/IBeatmapSetOnlineInfo.cs
@@ -1,8 +1,4 @@
-// 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.Beatmaps
 {
@@ -97,43 +93,4 @@ namespace osu.Game.Beatmaps
         /// </summary>
         public int? TrackId { get; set; }
     }
-
-    public class BeatmapSetOnlineGenre
-    {
-        public int Id { get; set; }
-        public string Name { get; set; }
-    }
-
-    public class BeatmapSetOnlineLanguage
-    {
-        public int Id { get; set; }
-        public string Name { get; set; }
-    }
-
-    public class BeatmapSetOnlineCovers
-    {
-        public string CoverLowRes { get; set; }
-
-        [JsonProperty(@"cover@2x")]
-        public string Cover { get; set; }
-
-        public string CardLowRes { get; set; }
-
-        [JsonProperty(@"card@2x")]
-        public string Card { get; set; }
-
-        public string ListLowRes { get; set; }
-
-        [JsonProperty(@"list@2x")]
-        public string List { get; set; }
-    }
-
-    public class BeatmapSetOnlineAvailability
-    {
-        [JsonProperty(@"download_disabled")]
-        public bool DownloadDisabled { get; set; }
-
-        [JsonProperty(@"more_information")]
-        public string ExternalLink { get; set; }
-    }
-}
+}
\ No newline at end of file

From ff674ca91378f70705b3e0ab38f2f027a4cdf225 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 21 Oct 2021 17:00:14 +0900
Subject: [PATCH 0369/5547] Remove unnecessary access modifiers from interface

---
 osu.Game/Beatmaps/IBeatmapSetOnlineInfo.cs | 36 +++++++++++-----------
 1 file changed, 18 insertions(+), 18 deletions(-)

diff --git a/osu.Game/Beatmaps/IBeatmapSetOnlineInfo.cs b/osu.Game/Beatmaps/IBeatmapSetOnlineInfo.cs
index 7f1ba41fb6..86859a0dc3 100644
--- a/osu.Game/Beatmaps/IBeatmapSetOnlineInfo.cs
+++ b/osu.Game/Beatmaps/IBeatmapSetOnlineInfo.cs
@@ -10,87 +10,87 @@ namespace osu.Game.Beatmaps
         /// <summary>
         /// The date this beatmap set was submitted to the online listing.
         /// </summary>
-        public DateTimeOffset Submitted { get; set; }
+        DateTimeOffset Submitted { get; set; }
 
         /// <summary>
         /// The date this beatmap set was ranked.
         /// </summary>
-        public DateTimeOffset? Ranked { get; set; }
+        DateTimeOffset? Ranked { get; set; }
 
         /// <summary>
         /// The date this beatmap set was last updated.
         /// </summary>
-        public DateTimeOffset? LastUpdated { get; set; }
+        DateTimeOffset? LastUpdated { get; set; }
 
         /// <summary>
         /// The status of this beatmap set.
         /// </summary>
-        public BeatmapSetOnlineStatus Status { get; set; }
+        BeatmapSetOnlineStatus Status { get; set; }
 
         /// <summary>
         /// Whether or not this beatmap set has explicit content.
         /// </summary>
-        public bool HasExplicitContent { get; set; }
+        bool HasExplicitContent { get; set; }
 
         /// <summary>
         /// Whether or not this beatmap set has a background video.
         /// </summary>
-        public bool HasVideo { get; set; }
+        bool HasVideo { get; set; }
 
         /// <summary>
         /// Whether or not this beatmap set has a storyboard.
         /// </summary>
-        public bool HasStoryboard { get; set; }
+        bool HasStoryboard { get; set; }
 
         /// <summary>
         /// The different sizes of cover art for this beatmap set.
         /// </summary>
-        public BeatmapSetOnlineCovers Covers { get; set; }
+        BeatmapSetOnlineCovers Covers { get; set; }
 
         /// <summary>
         /// A small sample clip of this beatmap set's song.
         /// </summary>
-        public string Preview { get; set; }
+        string Preview { get; set; }
 
         /// <summary>
         /// The beats per minute of this beatmap set's song.
         /// </summary>
-        public double BPM { get; set; }
+        double BPM { get; set; }
 
         /// <summary>
         /// The amount of plays this beatmap set has.
         /// </summary>
-        public int PlayCount { get; set; }
+        int PlayCount { get; set; }
 
         /// <summary>
         /// The amount of people who have favourited this beatmap set.
         /// </summary>
-        public int FavouriteCount { get; set; }
+        int FavouriteCount { get; set; }
 
         /// <summary>
         /// Whether this beatmap set has been favourited by the current user.
         /// </summary>
-        public bool HasFavourited { get; set; }
+        bool HasFavourited { get; set; }
 
         /// <summary>
         /// The availability of this beatmap set.
         /// </summary>
-        public BeatmapSetOnlineAvailability Availability { get; set; }
+        BeatmapSetOnlineAvailability Availability { get; set; }
 
         /// <summary>
         /// The song genre of this beatmap set.
         /// </summary>
-        public BeatmapSetOnlineGenre Genre { get; set; }
+        BeatmapSetOnlineGenre Genre { get; set; }
 
         /// <summary>
         /// The song language of this beatmap set.
         /// </summary>
-        public BeatmapSetOnlineLanguage Language { get; set; }
+        BeatmapSetOnlineLanguage Language { get; set; }
 
         /// <summary>
         /// The track ID of this beatmap set.
         /// Non-null only if the track is linked to a featured artist track entry.
         /// </summary>
-        public int? TrackId { get; set; }
+        int? TrackId { get; set; }
     }
-}
\ No newline at end of file
+}

From f41cf822b062cf7936d48d701ff65e4f99c10633 Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Thu, 21 Oct 2021 17:02:11 +0900
Subject: [PATCH 0370/5547] Rename request

---
 osu.Game/Online/Multiplayer/MatchUserRequest.cs                 | 2 +-
 ...{AddPlaylistItemRequest.cs => EnqueuePlaylistItemRequest.cs} | 2 +-
 osu.Game/Online/SignalRUnionWorkaroundResolver.cs               | 2 +-
 .../OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs        | 2 +-
 4 files changed, 4 insertions(+), 4 deletions(-)
 rename osu.Game/Online/Multiplayer/Queueing/{AddPlaylistItemRequest.cs => EnqueuePlaylistItemRequest.cs} (92%)

diff --git a/osu.Game/Online/Multiplayer/MatchUserRequest.cs b/osu.Game/Online/Multiplayer/MatchUserRequest.cs
index 96e2bb3c15..1656823b05 100644
--- a/osu.Game/Online/Multiplayer/MatchUserRequest.cs
+++ b/osu.Game/Online/Multiplayer/MatchUserRequest.cs
@@ -14,7 +14,7 @@ namespace osu.Game.Online.Multiplayer
     [Serializable]
     [MessagePackObject]
     [Union(0, typeof(ChangeTeamRequest))] // IMPORTANT: Add rules to SignalRUnionWorkaroundResolver for new derived types.
-    [Union(1, typeof(AddPlaylistItemRequest))]
+    [Union(1, typeof(EnqueuePlaylistItemRequest))]
     public abstract class MatchUserRequest
     {
     }
diff --git a/osu.Game/Online/Multiplayer/Queueing/AddPlaylistItemRequest.cs b/osu.Game/Online/Multiplayer/Queueing/EnqueuePlaylistItemRequest.cs
similarity index 92%
rename from osu.Game/Online/Multiplayer/Queueing/AddPlaylistItemRequest.cs
rename to osu.Game/Online/Multiplayer/Queueing/EnqueuePlaylistItemRequest.cs
index 427461e733..4c66311f68 100644
--- a/osu.Game/Online/Multiplayer/Queueing/AddPlaylistItemRequest.cs
+++ b/osu.Game/Online/Multiplayer/Queueing/EnqueuePlaylistItemRequest.cs
@@ -10,7 +10,7 @@ using osu.Game.Online.API;
 
 namespace osu.Game.Online.Multiplayer.Queueing
 {
-    public class AddPlaylistItemRequest : MatchUserRequest
+    public class EnqueuePlaylistItemRequest : MatchUserRequest
     {
         [Key(0)]
         public int BeatmapID { get; set; }
diff --git a/osu.Game/Online/SignalRUnionWorkaroundResolver.cs b/osu.Game/Online/SignalRUnionWorkaroundResolver.cs
index ff4505c450..ab393eadfe 100644
--- a/osu.Game/Online/SignalRUnionWorkaroundResolver.cs
+++ b/osu.Game/Online/SignalRUnionWorkaroundResolver.cs
@@ -26,7 +26,7 @@ namespace osu.Game.Online
             { typeof(TeamVersusUserState), new TypeRedirectingFormatter<TeamVersusUserState, MatchUserState>() },
             { typeof(TeamVersusRoomState), new TypeRedirectingFormatter<TeamVersusRoomState, MatchRoomState>() },
             { typeof(ChangeTeamRequest), new TypeRedirectingFormatter<ChangeTeamRequest, MatchUserRequest>() },
-            { typeof(AddPlaylistItemRequest), new TypeRedirectingFormatter<AddPlaylistItemRequest, MatchUserRequest>() },
+            { typeof(EnqueuePlaylistItemRequest), new TypeRedirectingFormatter<EnqueuePlaylistItemRequest, MatchUserRequest>() },
 
             // These should not be required. The fallback should work. But something is weird with the way caching is done.
             // For future adventurers, I would not advise looking into this further. It's likely not worth the effort.
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs
index 31ee09bdcd..eb5252b3e0 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs
@@ -57,7 +57,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
             {
                 loadingLayer.Show();
 
-                client.SendMatchRequest(new AddPlaylistItemRequest
+                client.SendMatchRequest(new EnqueuePlaylistItemRequest
                 {
                     BeatmapID = item.BeatmapID,
                     RulesetID = item.RulesetID,

From 0335ed6f276946b9ec9194e32f66b35ce7586d1f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 21 Oct 2021 17:14:29 +0900
Subject: [PATCH 0371/5547] Add missing licence header

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

diff --git a/osu.Game/Beatmaps/IBeatmapSetOnlineInfo.cs b/osu.Game/Beatmaps/IBeatmapSetOnlineInfo.cs
index 86859a0dc3..f365a59c1b 100644
--- a/osu.Game/Beatmaps/IBeatmapSetOnlineInfo.cs
+++ b/osu.Game/Beatmaps/IBeatmapSetOnlineInfo.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;
 
 namespace osu.Game.Beatmaps

From 69e7810dad46f6529fd2753479b5a39fe318fc60 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 21 Oct 2021 18:53:49 +0900
Subject: [PATCH 0372/5547] Enable `nullable` and switch classes to structs

---
 osu.Game/Beatmaps/BeatmapSetOnlineAvailability.cs         | 2 +-
 osu.Game/Beatmaps/BeatmapSetOnlineGenre.cs                | 2 +-
 osu.Game/Beatmaps/BeatmapSetOnlineLanguage.cs             | 2 +-
 osu.Game/Beatmaps/IBeatmapSetOnlineInfo.cs                | 4 +++-
 .../BeatmapListing/Panels/BeatmapPanelDownloadButton.cs   | 2 +-
 osu.Game/Overlays/BeatmapSet/BeatmapAvailability.cs       | 4 ++--
 osu.Game/Overlays/BeatmapSet/BeatmapSetHeaderContent.cs   | 2 +-
 osu.Game/Overlays/BeatmapSet/Info.cs                      | 4 ++--
 .../Sections/Beatmaps/PaginatedBeatmapContainer.cs        | 8 ++++----
 .../OnlinePlay/Components/PlaylistItemBackground.cs       | 2 +-
 10 files changed, 17 insertions(+), 15 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapSetOnlineAvailability.cs b/osu.Game/Beatmaps/BeatmapSetOnlineAvailability.cs
index 8c67aa2404..14a63f3279 100644
--- a/osu.Game/Beatmaps/BeatmapSetOnlineAvailability.cs
+++ b/osu.Game/Beatmaps/BeatmapSetOnlineAvailability.cs
@@ -5,7 +5,7 @@ using Newtonsoft.Json;
 
 namespace osu.Game.Beatmaps
 {
-    public class BeatmapSetOnlineAvailability
+    public struct BeatmapSetOnlineAvailability
     {
         [JsonProperty(@"download_disabled")]
         public bool DownloadDisabled { get; set; }
diff --git a/osu.Game/Beatmaps/BeatmapSetOnlineGenre.cs b/osu.Game/Beatmaps/BeatmapSetOnlineGenre.cs
index 65d6dfe5d9..e727e2c37f 100644
--- a/osu.Game/Beatmaps/BeatmapSetOnlineGenre.cs
+++ b/osu.Game/Beatmaps/BeatmapSetOnlineGenre.cs
@@ -3,7 +3,7 @@
 
 namespace osu.Game.Beatmaps
 {
-    public class BeatmapSetOnlineGenre
+    public struct BeatmapSetOnlineGenre
     {
         public int Id { get; set; }
         public string Name { get; set; }
diff --git a/osu.Game/Beatmaps/BeatmapSetOnlineLanguage.cs b/osu.Game/Beatmaps/BeatmapSetOnlineLanguage.cs
index 057325f319..658e5a4005 100644
--- a/osu.Game/Beatmaps/BeatmapSetOnlineLanguage.cs
+++ b/osu.Game/Beatmaps/BeatmapSetOnlineLanguage.cs
@@ -3,7 +3,7 @@
 
 namespace osu.Game.Beatmaps
 {
-    public class BeatmapSetOnlineLanguage
+    public struct BeatmapSetOnlineLanguage
     {
         public int Id { get; set; }
         public string Name { get; set; }
diff --git a/osu.Game/Beatmaps/IBeatmapSetOnlineInfo.cs b/osu.Game/Beatmaps/IBeatmapSetOnlineInfo.cs
index f365a59c1b..1cd363f7b6 100644
--- a/osu.Game/Beatmaps/IBeatmapSetOnlineInfo.cs
+++ b/osu.Game/Beatmaps/IBeatmapSetOnlineInfo.cs
@@ -3,6 +3,8 @@
 
 using System;
 
+#nullable enable
+
 namespace osu.Game.Beatmaps
 {
     /// <summary>
@@ -48,7 +50,7 @@ namespace osu.Game.Beatmaps
         /// <summary>
         /// The different sizes of cover art for this beatmap set.
         /// </summary>
-        BeatmapSetOnlineCovers Covers { get; set; }
+        BeatmapSetOnlineCovers? Covers { get; set; }
 
         /// <summary>
         /// A small sample clip of this beatmap set's song.
diff --git a/osu.Game/Overlays/BeatmapListing/Panels/BeatmapPanelDownloadButton.cs b/osu.Game/Overlays/BeatmapListing/Panels/BeatmapPanelDownloadButton.cs
index 47b477ef9a..a8c4334ffb 100644
--- a/osu.Game/Overlays/BeatmapListing/Panels/BeatmapPanelDownloadButton.cs
+++ b/osu.Game/Overlays/BeatmapListing/Panels/BeatmapPanelDownloadButton.cs
@@ -92,7 +92,7 @@ namespace osu.Game.Overlays.BeatmapListing.Panels
                         break;
 
                     default:
-                        if (BeatmapSet.Value?.OnlineInfo?.Availability?.DownloadDisabled ?? false)
+                        if (BeatmapSet.Value?.OnlineInfo?.Availability.DownloadDisabled ?? false)
                         {
                             button.Enabled.Value = false;
                             button.TooltipText = "this beatmap is currently not available for download.";
diff --git a/osu.Game/Overlays/BeatmapSet/BeatmapAvailability.cs b/osu.Game/Overlays/BeatmapSet/BeatmapAvailability.cs
index 896c646552..f005a37eaa 100644
--- a/osu.Game/Overlays/BeatmapSet/BeatmapAvailability.cs
+++ b/osu.Game/Overlays/BeatmapSet/BeatmapAvailability.cs
@@ -16,8 +16,8 @@ namespace osu.Game.Overlays.BeatmapSet
     {
         private BeatmapSetInfo beatmapSet;
 
-        private bool downloadDisabled => BeatmapSet?.OnlineInfo.Availability?.DownloadDisabled ?? false;
-        private bool hasExternalLink => !string.IsNullOrEmpty(BeatmapSet?.OnlineInfo.Availability?.ExternalLink);
+        private bool downloadDisabled => BeatmapSet?.OnlineInfo.Availability.DownloadDisabled ?? false;
+        private bool hasExternalLink => !string.IsNullOrEmpty(BeatmapSet?.OnlineInfo.Availability.ExternalLink);
 
         private readonly LinkFlowContainer textContainer;
 
diff --git a/osu.Game/Overlays/BeatmapSet/BeatmapSetHeaderContent.cs b/osu.Game/Overlays/BeatmapSet/BeatmapSetHeaderContent.cs
index fc2f90807e..c1029923f7 100644
--- a/osu.Game/Overlays/BeatmapSet/BeatmapSetHeaderContent.cs
+++ b/osu.Game/Overlays/BeatmapSet/BeatmapSetHeaderContent.cs
@@ -266,7 +266,7 @@ namespace osu.Game.Overlays.BeatmapSet
         {
             if (BeatmapSet.Value == null) return;
 
-            if ((BeatmapSet.Value.OnlineInfo.Availability?.DownloadDisabled ?? false) && State.Value != DownloadState.LocallyAvailable)
+            if (BeatmapSet.Value.OnlineInfo.Availability.DownloadDisabled && State.Value != DownloadState.LocallyAvailable)
             {
                 downloadButtonsContainer.Clear();
                 return;
diff --git a/osu.Game/Overlays/BeatmapSet/Info.cs b/osu.Game/Overlays/BeatmapSet/Info.cs
index 61c660cbaa..8bc5c6d27e 100644
--- a/osu.Game/Overlays/BeatmapSet/Info.cs
+++ b/osu.Game/Overlays/BeatmapSet/Info.cs
@@ -117,8 +117,8 @@ namespace osu.Game.Overlays.BeatmapSet
             {
                 source.Text = b.NewValue?.Metadata.Source ?? string.Empty;
                 tags.Text = b.NewValue?.Metadata.Tags ?? string.Empty;
-                genre.Text = b.NewValue?.OnlineInfo?.Genre?.Name ?? string.Empty;
-                language.Text = b.NewValue?.OnlineInfo?.Language?.Name ?? string.Empty;
+                genre.Text = b.NewValue?.OnlineInfo?.Genre.Name ?? string.Empty;
+                language.Text = b.NewValue?.OnlineInfo?.Language.Name ?? string.Empty;
                 var setHasLeaderboard = b.NewValue?.OnlineInfo?.Status > 0;
                 successRate.Alpha = setHasLeaderboard ? 1 : 0;
                 notRankedPlaceholder.Alpha = setHasLeaderboard ? 0 : 1;
diff --git a/osu.Game/Overlays/Profile/Sections/Beatmaps/PaginatedBeatmapContainer.cs b/osu.Game/Overlays/Profile/Sections/Beatmaps/PaginatedBeatmapContainer.cs
index 8657e356c9..c1e56facd9 100644
--- a/osu.Game/Overlays/Profile/Sections/Beatmaps/PaginatedBeatmapContainer.cs
+++ b/osu.Game/Overlays/Profile/Sections/Beatmaps/PaginatedBeatmapContainer.cs
@@ -60,12 +60,12 @@ namespace osu.Game.Overlays.Profile.Sections.Beatmaps
         protected override APIRequest<List<APIBeatmapSet>> CreateRequest() =>
             new GetUserBeatmapsRequest(User.Value.Id, type, VisiblePages++, ItemsPerPage);
 
-        protected override Drawable CreateDrawableItem(APIBeatmapSet model) => !model.OnlineBeatmapSetID.HasValue
-            ? null
-            : new GridBeatmapPanel(model.ToBeatmapSet(Rulesets))
+        protected override Drawable CreateDrawableItem(APIBeatmapSet model) => model.OnlineID > 0
+            ? new GridBeatmapPanel(model.ToBeatmapSet(Rulesets))
             {
                 Anchor = Anchor.TopCentre,
                 Origin = Anchor.TopCentre,
-            };
+            }
+            : null;
     }
 }
diff --git a/osu.Game/Screens/OnlinePlay/Components/PlaylistItemBackground.cs b/osu.Game/Screens/OnlinePlay/Components/PlaylistItemBackground.cs
index 90ad6e0f6e..c2ceef292c 100644
--- a/osu.Game/Screens/OnlinePlay/Components/PlaylistItemBackground.cs
+++ b/osu.Game/Screens/OnlinePlay/Components/PlaylistItemBackground.cs
@@ -26,7 +26,7 @@ namespace osu.Game.Screens.OnlinePlay.Components
             Texture? texture = null;
 
             // prefer online cover where available.
-            if (BeatmapInfo?.BeatmapSet?.OnlineInfo?.Covers.Cover != null)
+            if (BeatmapInfo?.BeatmapSet?.OnlineInfo?.Covers?.Cover != null)
                 texture = textures.Get(BeatmapInfo.BeatmapSet.OnlineInfo.Covers.Cover);
 
             Sprite.Texture = texture ?? beatmaps.DefaultBeatmap.Background;

From 40a176e86e6ef829c43a25b4343850966374b5e6 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 21 Oct 2021 18:54:21 +0900
Subject: [PATCH 0373/5547] `APIBeatmapSet` implements `IBeatmapSetInfo`

---
 .../API/Requests/Responses/APIBeatmapSet.cs   | 41 ++++++++++++-------
 1 file changed, 26 insertions(+), 15 deletions(-)

diff --git a/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs b/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs
index 25d69c2797..c445a69126 100644
--- a/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs
@@ -6,29 +6,26 @@ using System.Collections.Generic;
 using System.Linq;
 using Newtonsoft.Json;
 using osu.Game.Beatmaps;
+using osu.Game.Database;
 using osu.Game.Rulesets;
 
+#nullable enable
+
 namespace osu.Game.Online.API.Requests.Responses
 {
-    public class APIBeatmapSet : BeatmapMetadata, IBeatmapSetOnlineInfo
+    public class APIBeatmapSet : BeatmapMetadata, IBeatmapSetOnlineInfo, IBeatmapSetInfo
     {
         [JsonProperty(@"covers")]
-        public BeatmapSetOnlineCovers Covers { get; set; }
-
-        private int? onlineBeatmapSetID;
+        public BeatmapSetOnlineCovers? Covers { get; set; }
 
         [JsonProperty(@"id")]
-        public int? OnlineBeatmapSetID
-        {
-            get => onlineBeatmapSetID;
-            set => onlineBeatmapSetID = value > 0 ? value : null;
-        }
+        public int OnlineID { get; set; }
 
         [JsonProperty(@"status")]
         public BeatmapSetOnlineStatus Status { get; set; }
 
         [JsonProperty(@"preview_url")]
-        public string Preview { get; set; }
+        public string Preview { get; set; } = string.Empty;
 
         [JsonProperty(@"has_favourited")]
         public bool HasFavourited { get; set; }
@@ -61,7 +58,7 @@ namespace osu.Game.Online.API.Requests.Responses
         public DateTimeOffset? LastUpdated { get; set; }
 
         [JsonProperty(@"ratings")]
-        private int[] ratings { get; set; }
+        private int[] ratings { get; set; } = Array.Empty<int>();
 
         [JsonProperty(@"track_id")]
         public int? TrackId { get; set; }
@@ -82,20 +79,20 @@ namespace osu.Game.Online.API.Requests.Responses
         public BeatmapSetOnlineLanguage Language { get; set; }
 
         [JsonProperty(@"beatmaps")]
-        private IEnumerable<APIBeatmap> beatmaps { get; set; }
+        private IEnumerable<APIBeatmap> beatmaps { get; set; } = Array.Empty<APIBeatmap>();
 
         public virtual BeatmapSetInfo ToBeatmapSet(RulesetStore rulesets)
         {
             var beatmapSet = new BeatmapSetInfo
             {
-                OnlineBeatmapSetID = OnlineBeatmapSetID,
+                OnlineBeatmapSetID = OnlineID,
                 Metadata = this,
                 Status = Status,
-                Metrics = ratings == null ? null : new BeatmapSetMetrics { Ratings = ratings },
+                Metrics = new BeatmapSetMetrics { Ratings = ratings },
                 OnlineInfo = this
             };
 
-            beatmapSet.Beatmaps = beatmaps?.Select(b =>
+            beatmapSet.Beatmaps = beatmaps.Select(b =>
             {
                 var beatmap = b.ToBeatmapInfo(rulesets);
                 beatmap.BeatmapSet = beatmapSet;
@@ -105,5 +102,19 @@ namespace osu.Game.Online.API.Requests.Responses
 
             return beatmapSet;
         }
+
+        #region Implementation of IBeatmapSetInfo
+
+        IEnumerable<IBeatmapInfo> IBeatmapSetInfo.Beatmaps => beatmaps;
+
+        IBeatmapMetadataInfo IBeatmapSetInfo.Metadata => this;
+
+        DateTimeOffset IBeatmapSetInfo.DateAdded => throw new NotImplementedException();
+        IEnumerable<INamedFileUsage> IBeatmapSetInfo.Files => throw new NotImplementedException();
+        double IBeatmapSetInfo.MaxStarDifficulty => throw new NotImplementedException();
+        double IBeatmapSetInfo.MaxLength => throw new NotImplementedException();
+        double IBeatmapSetInfo.MaxBPM => throw new NotImplementedException();
+
+        #endregion
     }
 }

From 0fe0b5dc0999965f2a01e41aae0e703e5edf917b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 21 Oct 2021 19:14:31 +0900
Subject: [PATCH 0374/5547] `APIBeatmap` implements `IBeatmapInfo`

---
 osu.Game/Beatmaps/BeatmapOnlineLookupQueue.cs |  6 +--
 .../API/Requests/Responses/APIBeatmap.cs      | 53 ++++++++++++++-----
 2 files changed, 42 insertions(+), 17 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapOnlineLookupQueue.cs b/osu.Game/Beatmaps/BeatmapOnlineLookupQueue.cs
index 1fe120557d..b05ad9a1dd 100644
--- a/osu.Game/Beatmaps/BeatmapOnlineLookupQueue.cs
+++ b/osu.Game/Beatmaps/BeatmapOnlineLookupQueue.cs
@@ -83,9 +83,9 @@ namespace osu.Game.Beatmaps
                 if (res != null)
                 {
                     beatmapInfo.Status = res.Status;
-                    beatmapInfo.BeatmapSet.Status = res.BeatmapSet.Status;
+                    beatmapInfo.BeatmapSet.Status = res.BeatmapSet?.Status ?? BeatmapSetOnlineStatus.None;
                     beatmapInfo.BeatmapSet.OnlineBeatmapSetID = res.OnlineBeatmapSetID;
-                    beatmapInfo.OnlineBeatmapID = res.OnlineBeatmapID;
+                    beatmapInfo.OnlineBeatmapID = res.OnlineID;
 
                     if (beatmapInfo.Metadata != null)
                         beatmapInfo.Metadata.AuthorID = res.AuthorID;
@@ -93,7 +93,7 @@ namespace osu.Game.Beatmaps
                     if (beatmapInfo.BeatmapSet.Metadata != null)
                         beatmapInfo.BeatmapSet.Metadata.AuthorID = res.AuthorID;
 
-                    logForModel(set, $"Online retrieval mapped {beatmapInfo} to {res.OnlineBeatmapSetID} / {res.OnlineBeatmapID}.");
+                    logForModel(set, $"Online retrieval mapped {beatmapInfo} to {res.OnlineBeatmapSetID} / {res.OnlineID}.");
                 }
             }
             catch (Exception e)
diff --git a/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs b/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs
index ea4265e641..42e519223b 100644
--- a/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs
@@ -6,12 +6,14 @@ using Newtonsoft.Json;
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets;
 
+#nullable enable
+
 namespace osu.Game.Online.API.Requests.Responses
 {
-    public class APIBeatmap : BeatmapMetadata
+    public class APIBeatmap : BeatmapMetadata, IBeatmapInfo
     {
         [JsonProperty(@"id")]
-        public int OnlineBeatmapID { get; set; }
+        public int OnlineID { get; set; }
 
         [JsonProperty(@"beatmapset_id")]
         public int OnlineBeatmapSetID { get; set; }
@@ -20,10 +22,10 @@ namespace osu.Game.Online.API.Requests.Responses
         public BeatmapSetOnlineStatus Status { get; set; }
 
         [JsonProperty("checksum")]
-        public string Checksum { get; set; }
+        public string Checksum { get; set; } = string.Empty;
 
         [JsonProperty(@"beatmapset")]
-        public APIBeatmapSet BeatmapSet { get; set; }
+        public APIBeatmapSet? BeatmapSet { get; set; }
 
         [JsonProperty(@"playcount")]
         private int playCount { get; set; }
@@ -32,10 +34,10 @@ namespace osu.Game.Online.API.Requests.Responses
         private int passCount { get; set; }
 
         [JsonProperty(@"mode_int")]
-        private int ruleset { get; set; }
+        public int RulesetID { get; set; }
 
         [JsonProperty(@"difficulty_rating")]
-        private double starDifficulty { get; set; }
+        public double StarRating { get; set; }
 
         [JsonProperty(@"drain")]
         private float drainRate { get; set; }
@@ -50,7 +52,7 @@ namespace osu.Game.Online.API.Requests.Responses
         private float overallDifficulty { get; set; }
 
         [JsonProperty(@"total_length")]
-        private double length { get; set; }
+        public double Length { get; set; }
 
         [JsonProperty(@"count_circles")]
         private int circleCount { get; set; }
@@ -59,10 +61,10 @@ namespace osu.Game.Online.API.Requests.Responses
         private int sliderCount { get; set; }
 
         [JsonProperty(@"version")]
-        private string version { get; set; }
+        public string DifficultyName { get; set; } = string.Empty;
 
         [JsonProperty(@"failtimes")]
-        private BeatmapMetrics metrics { get; set; }
+        private BeatmapMetrics? metrics { get; set; }
 
         [JsonProperty(@"max_combo")]
         private int? maxCombo { get; set; }
@@ -74,12 +76,12 @@ namespace osu.Game.Online.API.Requests.Responses
             return new BeatmapInfo
             {
                 Metadata = set?.Metadata ?? this,
-                Ruleset = rulesets.GetRuleset(ruleset),
-                StarDifficulty = starDifficulty,
-                OnlineBeatmapID = OnlineBeatmapID,
-                Version = version,
+                Ruleset = rulesets.GetRuleset(RulesetID),
+                StarDifficulty = StarRating,
+                OnlineBeatmapID = OnlineID,
+                Version = DifficultyName,
                 // this is actually an incorrect mapping (Length is calculated as drain length in lazer's import process, see BeatmapManager.calculateLength).
-                Length = TimeSpan.FromSeconds(length).TotalMilliseconds,
+                Length = TimeSpan.FromSeconds(Length).TotalMilliseconds,
                 Status = Status,
                 MD5Hash = Checksum,
                 BeatmapSet = set,
@@ -101,5 +103,28 @@ namespace osu.Game.Online.API.Requests.Responses
                 },
             };
         }
+
+        #region Implementation of IBeatmapInfo
+
+        public IBeatmapMetadataInfo Metadata => this;
+
+        public IBeatmapDifficultyInfo Difficulty => new BeatmapDifficulty
+        {
+            DrainRate = drainRate,
+            CircleSize = circleSize,
+            ApproachRate = approachRate,
+            OverallDifficulty = overallDifficulty,
+        };
+
+        IBeatmapSetInfo? IBeatmapInfo.BeatmapSet => BeatmapSet;
+
+        public string MD5Hash => Checksum;
+
+        public IRulesetInfo Ruleset => new RulesetInfo { ID = RulesetID };
+
+        public double BPM => throw new NotImplementedException();
+        public string Hash => throw new NotImplementedException();
+
+        #endregion
     }
 }

From c580ec865f5c40fcf3548767350ef686bf30f1ae Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 21 Oct 2021 19:34:01 +0900
Subject: [PATCH 0375/5547] `APIBeatmapSet.Covers` is never null

---
 osu.Game/Beatmaps/BeatmapSetOnlineCovers.cs                     | 2 +-
 osu.Game/Beatmaps/IBeatmapSetOnlineInfo.cs                      | 2 +-
 osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs         | 2 +-
 .../Screens/OnlinePlay/Components/OnlinePlayBackgroundScreen.cs | 2 +-
 .../Screens/OnlinePlay/Components/PlaylistItemBackground.cs     | 2 +-
 5 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapSetOnlineCovers.cs b/osu.Game/Beatmaps/BeatmapSetOnlineCovers.cs
index 8d6e85391d..aad31befa8 100644
--- a/osu.Game/Beatmaps/BeatmapSetOnlineCovers.cs
+++ b/osu.Game/Beatmaps/BeatmapSetOnlineCovers.cs
@@ -5,7 +5,7 @@ using Newtonsoft.Json;
 
 namespace osu.Game.Beatmaps
 {
-    public class BeatmapSetOnlineCovers
+    public struct BeatmapSetOnlineCovers
     {
         public string CoverLowRes { get; set; }
 
diff --git a/osu.Game/Beatmaps/IBeatmapSetOnlineInfo.cs b/osu.Game/Beatmaps/IBeatmapSetOnlineInfo.cs
index 1cd363f7b6..b9800bc2e6 100644
--- a/osu.Game/Beatmaps/IBeatmapSetOnlineInfo.cs
+++ b/osu.Game/Beatmaps/IBeatmapSetOnlineInfo.cs
@@ -50,7 +50,7 @@ namespace osu.Game.Beatmaps
         /// <summary>
         /// The different sizes of cover art for this beatmap set.
         /// </summary>
-        BeatmapSetOnlineCovers? Covers { get; set; }
+        BeatmapSetOnlineCovers Covers { get; set; }
 
         /// <summary>
         /// A small sample clip of this beatmap set's song.
diff --git a/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs b/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs
index c445a69126..47f880cf54 100644
--- a/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs
@@ -16,7 +16,7 @@ namespace osu.Game.Online.API.Requests.Responses
     public class APIBeatmapSet : BeatmapMetadata, IBeatmapSetOnlineInfo, IBeatmapSetInfo
     {
         [JsonProperty(@"covers")]
-        public BeatmapSetOnlineCovers? Covers { get; set; }
+        public BeatmapSetOnlineCovers Covers { get; set; }
 
         [JsonProperty(@"id")]
         public int OnlineID { get; set; }
diff --git a/osu.Game/Screens/OnlinePlay/Components/OnlinePlayBackgroundScreen.cs b/osu.Game/Screens/OnlinePlay/Components/OnlinePlayBackgroundScreen.cs
index 6ce5f6a6db..8b6077b9f2 100644
--- a/osu.Game/Screens/OnlinePlay/Components/OnlinePlayBackgroundScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Components/OnlinePlayBackgroundScreen.cs
@@ -61,7 +61,7 @@ namespace osu.Game.Screens.OnlinePlay.Components
             {
                 var beatmap = playlistItem?.Beatmap.Value;
 
-                if (background?.BeatmapInfo?.BeatmapSet?.OnlineInfo?.Covers?.Cover == beatmap?.BeatmapSet?.OnlineInfo?.Covers?.Cover)
+                if (background?.BeatmapInfo?.BeatmapSet?.OnlineInfo?.Covers.Cover == beatmap?.BeatmapSet?.OnlineInfo?.Covers.Cover)
                     return;
 
                 cancellationSource?.Cancel();
diff --git a/osu.Game/Screens/OnlinePlay/Components/PlaylistItemBackground.cs b/osu.Game/Screens/OnlinePlay/Components/PlaylistItemBackground.cs
index c2ceef292c..90ad6e0f6e 100644
--- a/osu.Game/Screens/OnlinePlay/Components/PlaylistItemBackground.cs
+++ b/osu.Game/Screens/OnlinePlay/Components/PlaylistItemBackground.cs
@@ -26,7 +26,7 @@ namespace osu.Game.Screens.OnlinePlay.Components
             Texture? texture = null;
 
             // prefer online cover where available.
-            if (BeatmapInfo?.BeatmapSet?.OnlineInfo?.Covers?.Cover != null)
+            if (BeatmapInfo?.BeatmapSet?.OnlineInfo?.Covers.Cover != null)
                 texture = textures.Get(BeatmapInfo.BeatmapSet.OnlineInfo.Covers.Cover);
 
             Sprite.Texture = texture ?? beatmaps.DefaultBeatmap.Background;

From 6dd54a417fbb12ee0ae1fa376e1abdeca39e8103 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 21 Oct 2021 21:32:07 +0900
Subject: [PATCH 0376/5547] Remove `BeatmapMetadata` base class from
 `APIBeatmapSet`

---
 .../API/Requests/Responses/APIBeatmapSet.cs   | 62 +++++++++++++++++--
 1 file changed, 57 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs b/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs
index 47f880cf54..24d0e09649 100644
--- a/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs
@@ -8,12 +8,13 @@ using Newtonsoft.Json;
 using osu.Game.Beatmaps;
 using osu.Game.Database;
 using osu.Game.Rulesets;
+using osu.Game.Users;
 
 #nullable enable
 
 namespace osu.Game.Online.API.Requests.Responses
 {
-    public class APIBeatmapSet : BeatmapMetadata, IBeatmapSetOnlineInfo, IBeatmapSetInfo
+    public class APIBeatmapSet : IBeatmapSetOnlineInfo, IBeatmapSetInfo
     {
         [JsonProperty(@"covers")]
         public BeatmapSetOnlineCovers Covers { get; set; }
@@ -63,10 +64,44 @@ namespace osu.Game.Online.API.Requests.Responses
         [JsonProperty(@"track_id")]
         public int? TrackId { get; set; }
 
+        public string Title { get; set; } = string.Empty;
+
+        [JsonProperty("title_unicode")]
+        public string TitleUnicode { get; set; } = string.Empty;
+
+        public string Artist { get; set; } = string.Empty;
+
+        [JsonProperty("artist_unicode")]
+        public string ArtistUnicode { get; set; } = string.Empty;
+
+        public User? Author = new User();
+
+        /// <summary>
+        /// Helper property to deserialize a username to <see cref="User"/>.
+        /// </summary>
         [JsonProperty(@"user_id")]
-        private int creatorId
+        public int AuthorID
         {
-            set => Author.Id = value;
+            get => Author?.Id ?? 1;
+            set
+            {
+                Author ??= new User();
+                Author.Id = value;
+            }
+        }
+
+        /// <summary>
+        /// Helper property to deserialize a username to <see cref="User"/>.
+        /// </summary>
+        [JsonProperty(@"creator")]
+        public string AuthorString
+        {
+            get => Author?.Username ?? string.Empty;
+            set
+            {
+                Author ??= new User();
+                Author.Username = value;
+            }
         }
 
         [JsonProperty(@"availability")]
@@ -78,6 +113,11 @@ namespace osu.Game.Online.API.Requests.Responses
         [JsonProperty(@"language")]
         public BeatmapSetOnlineLanguage Language { get; set; }
 
+        public string Source { get; set; } = string.Empty;
+
+        [JsonProperty(@"tags")]
+        public string Tags { get; set; } = string.Empty;
+
         [JsonProperty(@"beatmaps")]
         private IEnumerable<APIBeatmap> beatmaps { get; set; } = Array.Empty<APIBeatmap>();
 
@@ -86,7 +126,7 @@ namespace osu.Game.Online.API.Requests.Responses
             var beatmapSet = new BeatmapSetInfo
             {
                 OnlineBeatmapSetID = OnlineID,
-                Metadata = this,
+                Metadata = metadata,
                 Status = Status,
                 Metrics = new BeatmapSetMetrics { Ratings = ratings },
                 OnlineInfo = this
@@ -103,11 +143,23 @@ namespace osu.Game.Online.API.Requests.Responses
             return beatmapSet;
         }
 
+        private BeatmapMetadata metadata => new BeatmapMetadata
+        {
+            Title = Title,
+            TitleUnicode = TitleUnicode,
+            Artist = Artist,
+            ArtistUnicode = ArtistUnicode,
+            AuthorID = AuthorID,
+            Author = Author,
+            Source = Source,
+            Tags = Tags,
+        };
+
         #region Implementation of IBeatmapSetInfo
 
         IEnumerable<IBeatmapInfo> IBeatmapSetInfo.Beatmaps => beatmaps;
 
-        IBeatmapMetadataInfo IBeatmapSetInfo.Metadata => this;
+        IBeatmapMetadataInfo IBeatmapSetInfo.Metadata => metadata;
 
         DateTimeOffset IBeatmapSetInfo.DateAdded => throw new NotImplementedException();
         IEnumerable<INamedFileUsage> IBeatmapSetInfo.Files => throw new NotImplementedException();

From fb7cf3548119221d6e9af4e1778f9b2a96f195e6 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 21 Oct 2021 21:48:14 +0900
Subject: [PATCH 0377/5547] Remove `BeatmapMetadata` base class from
 `APIBeatmap`

---
 osu.Game/Online/API/Requests/Responses/APIBeatmap.cs | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs b/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs
index 42e519223b..49124a404d 100644
--- a/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs
@@ -10,7 +10,7 @@ using osu.Game.Rulesets;
 
 namespace osu.Game.Online.API.Requests.Responses
 {
-    public class APIBeatmap : BeatmapMetadata, IBeatmapInfo
+    public class APIBeatmap : IBeatmapInfo
     {
         [JsonProperty(@"id")]
         public int OnlineID { get; set; }
@@ -24,6 +24,9 @@ namespace osu.Game.Online.API.Requests.Responses
         [JsonProperty("checksum")]
         public string Checksum { get; set; } = string.Empty;
 
+        [JsonProperty(@"user_id")]
+        public int AuthorID { get; set; }
+
         [JsonProperty(@"beatmapset")]
         public APIBeatmapSet? BeatmapSet { get; set; }
 
@@ -75,7 +78,7 @@ namespace osu.Game.Online.API.Requests.Responses
 
             return new BeatmapInfo
             {
-                Metadata = set?.Metadata ?? this,
+                Metadata = set?.Metadata ?? new BeatmapMetadata(),
                 Ruleset = rulesets.GetRuleset(RulesetID),
                 StarDifficulty = StarRating,
                 OnlineBeatmapID = OnlineID,
@@ -106,7 +109,7 @@ namespace osu.Game.Online.API.Requests.Responses
 
         #region Implementation of IBeatmapInfo
 
-        public IBeatmapMetadataInfo Metadata => this;
+        public IBeatmapMetadataInfo Metadata => new BeatmapMetadata();
 
         public IBeatmapDifficultyInfo Difficulty => new BeatmapDifficulty
         {

From cb605f91568272a5e0b30b18980661e4795d8d72 Mon Sep 17 00:00:00 2001
From: Xexxar <xexxar.xexxar@gmail.com>
Date: Thu, 21 Oct 2021 16:00:57 +0000
Subject: [PATCH 0378/5547] removed ppCalc changes and sliderabuseChecks

---
 .../Difficulty/OsuPerformanceCalculator.cs    | 77 ++++---------------
 .../Preprocessing/OsuDifficultyHitObject.cs   | 24 +++---
 .../Difficulty/Skills/Aim.cs                  |  2 +-
 3 files changed, 27 insertions(+), 76 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
index f97f4899de..bf4d92652c 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
@@ -25,8 +25,6 @@ namespace osu.Game.Rulesets.Osu.Difficulty
         private int countMeh;
         private int countMiss;
 
-        private int effectiveMissCount;
-
         public OsuPerformanceCalculator(Ruleset ruleset, DifficultyAttributes attributes, ScoreInfo score)
             : base(ruleset, attributes, score)
         {
@@ -41,23 +39,16 @@ namespace osu.Game.Rulesets.Osu.Difficulty
             countOk = Score.Statistics.GetValueOrDefault(HitResult.Ok);
             countMeh = Score.Statistics.GetValueOrDefault(HitResult.Meh);
             countMiss = Score.Statistics.GetValueOrDefault(HitResult.Miss);
-            effectiveMissCount = calculateEffectiveMissCount();
-
-            double multiplier = 1.12; // This is being adjusted to keep the final pp value scaled around what it used to be when changing things.
 
             // Custom multipliers for NoFail and SpunOut.
+            double multiplier = 1.12; // This is being adjusted to keep the final pp value scaled around what it used to be when changing things.
+
             if (mods.Any(m => m is OsuModNoFail))
-                multiplier *= Math.Max(0.90, 1.0 - 0.02 * effectiveMissCount);
+                multiplier *= Math.Max(0.90, 1.0 - 0.02 * countMiss);
 
             if (mods.Any(m => m is OsuModSpunOut))
                 multiplier *= 1.0 - Math.Pow((double)Attributes.SpinnerCount / totalHits, 0.85);
 
-            if (mods.Any(h => h is OsuModRelax))
-            {
-                effectiveMissCount += countOk + countMeh;
-                multiplier *= 0.6;
-            }
-
             double aimValue = computeAimValue();
             double speedValue = computeSpeedValue();
             double accuracyValue = computeAccuracyValue();
@@ -100,8 +91,8 @@ namespace osu.Game.Rulesets.Osu.Difficulty
             aimValue *= lengthBonus;
 
             // Penalize misses by assessing # of misses relative to the total # of objects. Default a 3% reduction for any # of misses.
-            if (effectiveMissCount > 0)
-                aimValue *= 0.97 * Math.Pow(1 - Math.Pow((double)effectiveMissCount / totalHits, 0.775), effectiveMissCount);
+            if (countMiss > 0)
+                aimValue *= 0.97 * Math.Pow(1 - Math.Pow((double)countMiss / totalHits, 0.775), countMiss);
 
             // Combo scaling.
             if (Attributes.MaxCombo > 0)
@@ -117,18 +108,14 @@ namespace osu.Game.Rulesets.Osu.Difficulty
 
             double approachRateBonus = 1.0 + (0.03 + 0.37 * approachRateTotalHitsFactor) * approachRateFactor;
 
-            if (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 (mods.Any(h => h is OsuModHidden))
-            {
-                // We want to give more reward for lower AR when it comes to aim and HD. This nerfs high AR and buffs lower AR.
+            // We want to give more reward for lower AR when it comes to aim and HD. This nerfs high AR and buffs lower AR.
+            if (mods.Any(h => h is OsuModHidden))
                 aimValue *= 1.0 + 0.04 * (12.0 - Attributes.ApproachRate);
-            }
 
             aimValue *= approachRateBonus;
 
-            // Scale the aim value with accuracy
-            aimValue *= accuracy;
+            // Scale the aim value with accuracy _slightly_.
+            aimValue *= 0.5 + accuracy / 2.0;
             // It is important to also consider accuracy difficulty when doing that.
             aimValue *= 0.98 + Math.Pow(Attributes.OverallDifficulty, 2) / 2500;
 
@@ -145,8 +132,8 @@ namespace osu.Game.Rulesets.Osu.Difficulty
             speedValue *= lengthBonus;
 
             // Penalize misses by assessing # of misses relative to the total # of objects. Default a 3% reduction for any # of misses.
-            if (effectiveMissCount > 0)
-                speedValue *= 0.97 * Math.Pow(1 - Math.Pow((double)effectiveMissCount / totalHits, 0.775), Math.Pow(effectiveMissCount, .875));
+            if (countMiss > 0)
+                speedValue *= 0.97 * Math.Pow(1 - Math.Pow((double)countMiss / totalHits, 0.775), Math.Pow(countMiss, .875));
 
             // Combo scaling.
             if (Attributes.MaxCombo > 0)
@@ -160,20 +147,11 @@ namespace osu.Game.Rulesets.Osu.Difficulty
 
             speedValue *= 1.0 + (0.03 + 0.37 * approachRateTotalHitsFactor) * approachRateFactor;
 
-            if (mods.Any(m => m is OsuModBlinds))
-            {
-                // Increasing the speed value by object count for Blinds isn't ideal, so the minimum buff is given.
-                speedValue *= 1.12;
-            }
-            else if (mods.Any(m => m is OsuModHidden))
-            {
-                // We want to give more reward for lower AR when it comes to aim and HD. This nerfs high AR and buffs lower AR.
+            if (mods.Any(m => m is OsuModHidden))
                 speedValue *= 1.0 + 0.04 * (12.0 - Attributes.ApproachRate);
-            }
 
             // Scale the speed value with accuracy and OD.
             speedValue *= (0.95 + Math.Pow(Attributes.OverallDifficulty, 2) / 750) * Math.Pow(accuracy, (14.5 - Math.Max(Attributes.OverallDifficulty, 8)) / 2);
-
             // Scale the speed value with # of 50s to punish doubletapping.
             speedValue *= Math.Pow(0.98, countMeh < totalHits / 500.0 ? 0 : countMeh - totalHits / 500.0);
 
@@ -182,9 +160,6 @@ namespace osu.Game.Rulesets.Osu.Difficulty
 
         private double computeAccuracyValue()
         {
-            if (mods.Any(h => h is OsuModRelax))
-                return 0.0;
-
             // This percentage only considers HitCircles of any value - in this part of the calculation we focus on hitting the timing hit window.
             double betterAccuracyPercentage;
             int amountHitObjectsWithAccuracy = Attributes.HitCircleCount;
@@ -205,12 +180,8 @@ namespace osu.Game.Rulesets.Osu.Difficulty
             // Bonus for many hitcircles - it's harder to keep good accuracy up for longer.
             accuracyValue *= Math.Min(1.15, Math.Pow(amountHitObjectsWithAccuracy / 1000.0, 0.3));
 
-            // Increasing the accuracy value by object count for Blinds isn't ideal, so the minimum buff is given.
-            if (mods.Any(m => m is OsuModBlinds))
-                accuracyValue *= 1.14;
-            else if (mods.Any(m => m is OsuModHidden))
+            if (mods.Any(m => m is OsuModHidden))
                 accuracyValue *= 1.08;
-
             if (mods.Any(m => m is OsuModFlashlight))
                 accuracyValue *= 1.02;
 
@@ -234,8 +205,8 @@ namespace osu.Game.Rulesets.Osu.Difficulty
                 flashlightValue *= 1.3;
 
             // Penalize misses by assessing # of misses relative to the total # of objects. Default a 3% reduction for any # of misses.
-            if (effectiveMissCount > 0)
-                flashlightValue *= 0.97 * Math.Pow(1 - Math.Pow((double)effectiveMissCount / totalHits, 0.775), Math.Pow(effectiveMissCount, .875));
+            if (countMiss > 0)
+                flashlightValue *= 0.97 * Math.Pow(1 - Math.Pow((double)countMiss / totalHits, 0.775), Math.Pow(countMiss, .875));
 
             // Combo scaling.
             if (Attributes.MaxCombo > 0)
@@ -253,24 +224,6 @@ namespace osu.Game.Rulesets.Osu.Difficulty
             return flashlightValue;
         }
 
-        private int calculateEffectiveMissCount()
-        {
-            // guess the number of misses + slider breaks from combo
-            double comboBasedMissCount = 0.0;
-
-            if (Attributes.SliderCount > 0)
-            {
-                double fullComboThreshold = Attributes.MaxCombo - 0.1 * Attributes.SliderCount;
-                if (scoreMaxCombo < fullComboThreshold)
-                    comboBasedMissCount = fullComboThreshold / Math.Max(1.0, scoreMaxCombo);
-            }
-
-            // we're clamping misscount because since its derived from combo it can be higher than total hits and that breaks some calculations
-            comboBasedMissCount = Math.Min(comboBasedMissCount, totalHits);
-
-            return Math.Max(countMiss, (int)Math.Floor(comboBasedMissCount));
-        }
-
         private int totalHits => countGreat + countOk + countMeh + countMiss;
         private int totalSuccessfulHits => countGreat + countOk + countMeh;
     }
diff --git a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
index d86358fb57..5d85c4338c 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
@@ -13,6 +13,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
     public class OsuDifficultyHitObject : DifficultyHitObject
     {
         private const int normalized_radius = 50; // Change radius to 50 to make 100 the diameter. Easier for mental maths.
+        private const int min_delta_time = 25;
 
         protected new OsuHitObject BaseObject => (OsuHitObject)base.BaseObject;
 
@@ -26,7 +27,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
         /// </summary>
         public double MovementDistance { get; private set; }
 
-        /// <summary>JumpTravel
+        /// <summary>
         /// Normalized distance between the start and end position of the previous <see cref="OsuDifficultyHitObject"/>.
         /// </summary>
         public double TravelDistance { get; private set; }
@@ -62,7 +63,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
             this.lastObject = (OsuHitObject)lastObject;
 
             // Capped to 25ms to prevent difficulty calculation breaking from simulatenous objects.
-            StrainTime = Math.Max(DeltaTime, 25);
+            StrainTime = Math.Max(DeltaTime, min_delta_time);
 
             setDistances(clockRate);
         }
@@ -82,22 +83,19 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
                 scalingFactor *= 1 + smallCircleBonus;
             }
 
-            double sliderAbuseIndex = 1;
-
             if (lastObject is Slider lastSlider)
             {
                 computeSliderCursorPosition(lastSlider);
-                sliderAbuseIndex = Math.Clamp(Vector2.Subtract(lastSlider.StackedPosition * scalingFactor, BaseObject.StackedPosition * scalingFactor).Length - 100, 0, 25) / 25;
-                TravelDistance = lastSlider.LazyTravelDistance * scalingFactor * sliderAbuseIndex;
-                TravelTime = Math.Max(lastSlider.LazyTravelTime / clockRate, 25);
-                MovementTime = Math.Max(StrainTime - TravelTime, 25);
+                TravelDistance = lastSlider.LazyTravelDistance * scalingFactor;
+                TravelTime = Math.Max(lastSlider.LazyTravelTime / clockRate, min_delta_time);
+                MovementTime = Math.Max(StrainTime - TravelTime, min_delta_time);
                 MovementDistance = Vector2.Subtract(lastSlider.TailCircle.StackedPosition, BaseObject.StackedPosition).Length * scalingFactor;
             }
 
             Vector2 lastCursorPosition = getEndCursorPosition(lastObject);
 
-            JumpDistance = (BaseObject.StackedPosition * scalingFactor - lastCursorPosition * scalingFactor).Length * sliderAbuseIndex;
-            MovementDistance = Math.Min(JumpDistance, MovementDistance) * sliderAbuseIndex;
+            JumpDistance = (BaseObject.StackedPosition * scalingFactor - lastCursorPosition * scalingFactor).Length;
+            MovementDistance = Math.Min(JumpDistance, MovementDistance);
 
             if (lastLastObject != null && !(lastLastObject is Spinner))
             {
@@ -120,7 +118,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
 
             slider.LazyEndPosition = slider.StackedPosition;
 
-            float approxFollowCircleRadius = (float)(slider.Radius * 2.4);
+            float followCircleRadius = (float)(slider.Radius * 2.4);
             var computeVertex = new Action<double>(t =>
             {
                 double progress = (t - slider.StartTime) / slider.SpanDuration;
@@ -135,11 +133,11 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
 
                 slider.LazyTravelTime = t - slider.StartTime;
 
-                if (dist > approxFollowCircleRadius)
+                if (dist > followCircleRadius)
                 {
                     // The cursor would be outside the follow circle, we need to move it
                     diff.Normalize(); // Obtain direction of diff
-                    dist -= approxFollowCircleRadius;
+                    dist -= followCircleRadius;
                     slider.LazyEndPosition += diff * dist;
                     slider.LazyTravelDistance += dist;
                 }
diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
index 3d27e13bc1..966e7eb221 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
@@ -39,7 +39,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
             var osuPrevObj = (OsuDifficultyHitObject)Previous[0];
             var osuLastObj = (OsuDifficultyHitObject)Previous[1];
 
-            double currVelocity = osuCurrObj.JumpDistance / osuCurrObj.StrainTime; // Start iwth the base distance / time
+            double currVelocity = osuCurrObj.JumpDistance / osuCurrObj.StrainTime; // Start with the base distance / time
 
             if (osuPrevObj.BaseObject is Slider) // If object is a slider
             {

From 4fe007aa2e5ba37840c8ca2499ea53f1b7176f0e Mon Sep 17 00:00:00 2001
From: Xexxar <xexxar.xexxar@gmail.com>
Date: Thu, 21 Oct 2021 16:08:35 +0000
Subject: [PATCH 0379/5547] new slider travel dist algorithm

---
 .../Preprocessing/OsuDifficultyHitObject.cs   | 28 ++++++++++++++++++-
 .../Difficulty/Skills/Aim.cs                  |  4 +--
 2 files changed, 29 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
index 5d85c4338c..459821401a 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
@@ -86,10 +86,36 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
             if (lastObject is Slider lastSlider)
             {
                 computeSliderCursorPosition(lastSlider);
-                TravelDistance = lastSlider.LazyTravelDistance * scalingFactor;
+                TravelDistance = 0;
                 TravelTime = Math.Max(lastSlider.LazyTravelTime / clockRate, min_delta_time);
                 MovementTime = Math.Max(StrainTime - TravelTime, min_delta_time);
                 MovementDistance = Vector2.Subtract(lastSlider.TailCircle.StackedPosition, BaseObject.StackedPosition).Length * scalingFactor;
+
+                int repeatCount = 0;
+
+                for (int i = 1; i < lastSlider.NestedHitObjects.Count; i++)
+                {
+                    if ((OsuHitObject)lastSlider.NestedHitObjects[i] is SliderRepeat)
+                        repeatCount++;
+
+                    Vector2 currSlider = Vector2.Subtract(((OsuHitObject)lastSlider.NestedHitObjects[i]).StackedPosition, ((OsuHitObject)lastSlider.NestedHitObjects[i - 1]).StackedPosition);
+
+                    if ((OsuHitObject)lastSlider.NestedHitObjects[i] is SliderRepeat && (OsuHitObject)lastSlider.NestedHitObjects[i - 1] is SliderRepeat)
+                        TravelDistance += Math.Max(0, currSlider.Length * scalingFactor - 240);
+                    else if ((OsuHitObject)lastSlider.NestedHitObjects[i] is SliderEndCircle || (OsuHitObject)lastSlider.NestedHitObjects[i] is SliderRepeat)
+                        TravelDistance += Math.Max(0, currSlider.Length * scalingFactor - 100);
+                    else
+                        TravelDistance += Vector2.Subtract(((OsuHitObject)lastSlider.NestedHitObjects[i]).StackedPosition, ((OsuHitObject)lastSlider.NestedHitObjects[i - 1]).StackedPosition).Length * scalingFactor;
+
+                    if ((OsuHitObject)lastSlider.NestedHitObjects[i] is SliderTick && i != lastSlider.NestedHitObjects.Count - 1) // For some unknown reason to me sliders can have a tick as the last object
+                    {
+                        Vector2 nextSlider = Vector2.Subtract(((OsuHitObject)lastSlider.NestedHitObjects[i + 1]).StackedPosition, ((OsuHitObject)lastSlider.NestedHitObjects[i]).StackedPosition);
+                        TravelDistance += 2 * Vector2.Subtract(nextSlider, currSlider).Length * scalingFactor;
+                    }
+                }
+
+                TravelDistance *= Math.Sqrt(1 + repeatCount);
+                TravelDistance *= Math.Max(0, Math.Min(TravelTime, lastSlider.SpanDuration - 50)) / lastSlider.SpanDuration;
             }
 
             Vector2 lastCursorPosition = getEndCursorPosition(lastObject);
diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
index 33d443c6ca..fbfd800a9d 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
@@ -24,7 +24,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
 
         private const double wide_angle_multiplier = 1.5;
         private const double acute_angle_multiplier = 1.5;
-        private const double slider_multiplier = 2.75;
+        private const double slider_multiplier = 1.75;
 
         private double currentStrain = 1;
 
@@ -92,7 +92,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
                 }
             }
 
-            if (osuCurrObj.TravelDistance != 0)
+            if (osuCurrObj.TravelTime != 0)
             {
                 sliderBonus = osuCurrObj.TravelDistance / osuCurrObj.TravelTime; // add some slider rewards
             }

From 276b4afdb0590c3daf1fc9bd5d4b31aa2e9a1046 Mon Sep 17 00:00:00 2001
From: Xexxar <xexxar.xexxar@gmail.com>
Date: Thu, 21 Oct 2021 16:14:31 +0000
Subject: [PATCH 0380/5547] removed unnecessary test code

---
 .../Difficulty/Preprocessing/OsuDifficultyHitObject.cs     | 7 ++-----
 1 file changed, 2 insertions(+), 5 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
index 459821401a..bf5bfa3cbf 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
@@ -100,21 +100,18 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
 
                     Vector2 currSlider = Vector2.Subtract(((OsuHitObject)lastSlider.NestedHitObjects[i]).StackedPosition, ((OsuHitObject)lastSlider.NestedHitObjects[i - 1]).StackedPosition);
 
-                    if ((OsuHitObject)lastSlider.NestedHitObjects[i] is SliderRepeat && (OsuHitObject)lastSlider.NestedHitObjects[i - 1] is SliderRepeat)
-                        TravelDistance += Math.Max(0, currSlider.Length * scalingFactor - 240);
-                    else if ((OsuHitObject)lastSlider.NestedHitObjects[i] is SliderEndCircle || (OsuHitObject)lastSlider.NestedHitObjects[i] is SliderRepeat)
+                    if ((OsuHitObject)lastSlider.NestedHitObjects[i] is SliderEndCircle || (OsuHitObject)lastSlider.NestedHitObjects[i] is SliderRepeat)
                         TravelDistance += Math.Max(0, currSlider.Length * scalingFactor - 100);
                     else
                         TravelDistance += Vector2.Subtract(((OsuHitObject)lastSlider.NestedHitObjects[i]).StackedPosition, ((OsuHitObject)lastSlider.NestedHitObjects[i - 1]).StackedPosition).Length * scalingFactor;
 
-                    if ((OsuHitObject)lastSlider.NestedHitObjects[i] is SliderTick && i != lastSlider.NestedHitObjects.Count - 1) // For some unknown reason to me sliders can have a tick as the last object
+                    if ((OsuHitObject)lastSlider.NestedHitObjects[i] is SliderTick && i != lastSlider.NestedHitObjects.Count - 1) // Check for tick && not last object is necessary for 2007 bugged sliders.
                     {
                         Vector2 nextSlider = Vector2.Subtract(((OsuHitObject)lastSlider.NestedHitObjects[i + 1]).StackedPosition, ((OsuHitObject)lastSlider.NestedHitObjects[i]).StackedPosition);
                         TravelDistance += 2 * Vector2.Subtract(nextSlider, currSlider).Length * scalingFactor;
                     }
                 }
 
-                TravelDistance *= Math.Sqrt(1 + repeatCount);
                 TravelDistance *= Math.Max(0, Math.Min(TravelTime, lastSlider.SpanDuration - 50)) / lastSlider.SpanDuration;
             }
 

From dba0ee0b1de84cf64cd7e495da1708004a5faa59 Mon Sep 17 00:00:00 2001
From: Xexxar <xexxar.xexxar@gmail.com>
Date: Thu, 21 Oct 2021 17:18:24 +0000
Subject: [PATCH 0381/5547] added ppcalc changes to build

---
 .../Difficulty/OsuPerformanceCalculator.cs    | 20 +++++++------------
 1 file changed, 7 insertions(+), 13 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
index bf4d92652c..b1c3574f79 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
@@ -100,22 +100,18 @@ namespace osu.Game.Rulesets.Osu.Difficulty
 
             double approachRateFactor = 0.0;
             if (Attributes.ApproachRate > 10.33)
-                approachRateFactor = Attributes.ApproachRate - 10.33;
+                approachRateFactor = 0.3 * (Attributes.ApproachRate - 10.33);
             else if (Attributes.ApproachRate < 8.0)
-                approachRateFactor = 0.025 * (8.0 - Attributes.ApproachRate);
+                approachRateFactor = 0.1 * (8.0 - Attributes.ApproachRate);
 
-            double approachRateTotalHitsFactor = 1.0 / (1.0 + Math.Exp(-(0.007 * (totalHits - 400))));
-
-            double approachRateBonus = 1.0 + (0.03 + 0.37 * approachRateTotalHitsFactor) * approachRateFactor;
+            aimValue *= 1.0 + approachRateFactor;
 
             // We want to give more reward for lower AR when it comes to aim and HD. This nerfs high AR and buffs lower AR.
             if (mods.Any(h => h is OsuModHidden))
                 aimValue *= 1.0 + 0.04 * (12.0 - Attributes.ApproachRate);
 
-            aimValue *= approachRateBonus;
-
-            // Scale the aim value with accuracy _slightly_.
-            aimValue *= 0.5 + accuracy / 2.0;
+            // Scale the aim value with accuracy
+            aimValue *= accuracy;
             // It is important to also consider accuracy difficulty when doing that.
             aimValue *= 0.98 + Math.Pow(Attributes.OverallDifficulty, 2) / 2500;
 
@@ -141,11 +137,9 @@ namespace osu.Game.Rulesets.Osu.Difficulty
 
             double approachRateFactor = 0.0;
             if (Attributes.ApproachRate > 10.33)
-                approachRateFactor = Attributes.ApproachRate - 10.33;
+                approachRateFactor = 0.3 * (Attributes.ApproachRate - 10.33);
 
-            double approachRateTotalHitsFactor = 1.0 / (1.0 + Math.Exp(-(0.007 * (totalHits - 400))));
-
-            speedValue *= 1.0 + (0.03 + 0.37 * approachRateTotalHitsFactor) * approachRateFactor;
+            speedValue *= 1.0 + approachRateFactor;
 
             if (mods.Any(m => m is OsuModHidden))
                 speedValue *= 1.0 + 0.04 * (12.0 - Attributes.ApproachRate);

From a23330c49b15623946a760f4ed8c38e0c0437264 Mon Sep 17 00:00:00 2001
From: Xexxar <xexxar.xexxar@gmail.com>
Date: Thu, 21 Oct 2021 17:21:03 +0000
Subject: [PATCH 0382/5547] removed comment

---
 osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs | 6 +-----
 1 file changed, 1 insertion(+), 5 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
index 7eabc29a99..2f9940f6f3 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
@@ -20,8 +20,6 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
         {
         }
 
-private int count = 1;
-
         protected override int HistoryLength => 2;
 
         private const double wide_angle_multiplier = 1.5;
@@ -36,11 +34,9 @@ private int count = 1;
 
         private double strainValueOf(DifficultyHitObject current)
         {
-            if (current.BaseObject is Spinner || Previous.Count <= 1 || Previous[0].BaseObject is Spinner)
+            if (current.BaseObject is Spinner || Previous.Count <= 1)
                 return 0;
 
-            count++;
-
             var osuCurrObj = (OsuDifficultyHitObject)current;
             var osuPrevObj = (OsuDifficultyHitObject)Previous[0];
             var osuLastObj = (OsuDifficultyHitObject)Previous[1];

From d6aa2fe6e48e5804bca01c9be29debdaadd884fb Mon Sep 17 00:00:00 2001
From: Xexxar <xexxar.xexxar@gmail.com>
Date: Thu, 21 Oct 2021 17:21:34 +0000
Subject: [PATCH 0383/5547] identified case with spinner where / 0 could
 theoretically be possible

---
 osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
index 966e7eb221..94f02c2d9f 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
@@ -32,7 +32,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
 
         private double strainValueOf(DifficultyHitObject current)
         {
-            if (current.BaseObject is Spinner || Previous.Count <= 1)
+            if (current.BaseObject is Spinner || Previous.Count <= 1 || Previous[0].BaseObject is Spinner)
                 return 0;
 
             var osuCurrObj = (OsuDifficultyHitObject)current;

From 2f8972b529c58398dc0ac14b0f552c9e65aba126 Mon Sep 17 00:00:00 2001
From: Xexxar <xexxar.xexxar@gmail.com>
Date: Thu, 21 Oct 2021 18:37:06 +0000
Subject: [PATCH 0384/5547] reverted overwritten file

---
 .../Difficulty/OsuPerformanceCalculator.cs    | 71 +++++++++++++++----
 1 file changed, 59 insertions(+), 12 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
index bf4d92652c..4bca87204a 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
@@ -25,6 +25,8 @@ namespace osu.Game.Rulesets.Osu.Difficulty
         private int countMeh;
         private int countMiss;
 
+        private int effectiveMissCount;
+
         public OsuPerformanceCalculator(Ruleset ruleset, DifficultyAttributes attributes, ScoreInfo score)
             : base(ruleset, attributes, score)
         {
@@ -39,16 +41,23 @@ namespace osu.Game.Rulesets.Osu.Difficulty
             countOk = Score.Statistics.GetValueOrDefault(HitResult.Ok);
             countMeh = Score.Statistics.GetValueOrDefault(HitResult.Meh);
             countMiss = Score.Statistics.GetValueOrDefault(HitResult.Miss);
+            effectiveMissCount = calculateEffectiveMissCount();
 
-            // Custom multipliers for NoFail and SpunOut.
             double multiplier = 1.12; // This is being adjusted to keep the final pp value scaled around what it used to be when changing things.
 
+            // Custom multipliers for NoFail and SpunOut.
             if (mods.Any(m => m is OsuModNoFail))
-                multiplier *= Math.Max(0.90, 1.0 - 0.02 * countMiss);
+                multiplier *= Math.Max(0.90, 1.0 - 0.02 * effectiveMissCount);
 
             if (mods.Any(m => m is OsuModSpunOut))
                 multiplier *= 1.0 - Math.Pow((double)Attributes.SpinnerCount / totalHits, 0.85);
 
+            if (mods.Any(h => h is OsuModRelax))
+            {
+                effectiveMissCount += countOk + countMeh;
+                multiplier *= 0.6;
+            }
+
             double aimValue = computeAimValue();
             double speedValue = computeSpeedValue();
             double accuracyValue = computeAccuracyValue();
@@ -91,8 +100,8 @@ namespace osu.Game.Rulesets.Osu.Difficulty
             aimValue *= lengthBonus;
 
             // Penalize misses by assessing # of misses relative to the total # of objects. Default a 3% reduction for any # of misses.
-            if (countMiss > 0)
-                aimValue *= 0.97 * Math.Pow(1 - Math.Pow((double)countMiss / totalHits, 0.775), countMiss);
+            if (effectiveMissCount > 0)
+                aimValue *= 0.97 * Math.Pow(1 - Math.Pow((double)effectiveMissCount / totalHits, 0.775), effectiveMissCount);
 
             // Combo scaling.
             if (Attributes.MaxCombo > 0)
@@ -108,9 +117,13 @@ namespace osu.Game.Rulesets.Osu.Difficulty
 
             double approachRateBonus = 1.0 + (0.03 + 0.37 * approachRateTotalHitsFactor) * approachRateFactor;
 
-            // We want to give more reward for lower AR when it comes to aim and HD. This nerfs high AR and buffs lower AR.
-            if (mods.Any(h => h is OsuModHidden))
+            if (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 (mods.Any(h => h is OsuModHidden))
+            {
+                // 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);
+            }
 
             aimValue *= approachRateBonus;
 
@@ -132,8 +145,8 @@ namespace osu.Game.Rulesets.Osu.Difficulty
             speedValue *= lengthBonus;
 
             // Penalize misses by assessing # of misses relative to the total # of objects. Default a 3% reduction for any # of misses.
-            if (countMiss > 0)
-                speedValue *= 0.97 * Math.Pow(1 - Math.Pow((double)countMiss / totalHits, 0.775), Math.Pow(countMiss, .875));
+            if (effectiveMissCount > 0)
+                speedValue *= 0.97 * Math.Pow(1 - Math.Pow((double)effectiveMissCount / totalHits, 0.775), Math.Pow(effectiveMissCount, .875));
 
             // Combo scaling.
             if (Attributes.MaxCombo > 0)
@@ -147,11 +160,20 @@ namespace osu.Game.Rulesets.Osu.Difficulty
 
             speedValue *= 1.0 + (0.03 + 0.37 * approachRateTotalHitsFactor) * approachRateFactor;
 
-            if (mods.Any(m => m is OsuModHidden))
+            if (mods.Any(m => m is OsuModBlinds))
+            {
+                // Increasing the speed value by object count for Blinds isn't ideal, so the minimum buff is given.
+                speedValue *= 1.12;
+            }
+            else if (mods.Any(m => m is OsuModHidden))
+            {
+                // 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);
+            }
 
             // Scale the speed value with accuracy and OD.
             speedValue *= (0.95 + Math.Pow(Attributes.OverallDifficulty, 2) / 750) * Math.Pow(accuracy, (14.5 - Math.Max(Attributes.OverallDifficulty, 8)) / 2);
+
             // Scale the speed value with # of 50s to punish doubletapping.
             speedValue *= Math.Pow(0.98, countMeh < totalHits / 500.0 ? 0 : countMeh - totalHits / 500.0);
 
@@ -160,6 +182,9 @@ namespace osu.Game.Rulesets.Osu.Difficulty
 
         private double computeAccuracyValue()
         {
+            if (mods.Any(h => h is OsuModRelax))
+                return 0.0;
+
             // This percentage only considers HitCircles of any value - in this part of the calculation we focus on hitting the timing hit window.
             double betterAccuracyPercentage;
             int amountHitObjectsWithAccuracy = Attributes.HitCircleCount;
@@ -180,8 +205,12 @@ namespace osu.Game.Rulesets.Osu.Difficulty
             // Bonus for many hitcircles - it's harder to keep good accuracy up for longer.
             accuracyValue *= Math.Min(1.15, Math.Pow(amountHitObjectsWithAccuracy / 1000.0, 0.3));
 
-            if (mods.Any(m => m is OsuModHidden))
+            // Increasing the accuracy value by object count for Blinds isn't ideal, so the minimum buff is given.
+            if (mods.Any(m => m is OsuModBlinds))
+                accuracyValue *= 1.14;
+            else if (mods.Any(m => m is OsuModHidden))
                 accuracyValue *= 1.08;
+
             if (mods.Any(m => m is OsuModFlashlight))
                 accuracyValue *= 1.02;
 
@@ -205,8 +234,8 @@ namespace osu.Game.Rulesets.Osu.Difficulty
                 flashlightValue *= 1.3;
 
             // Penalize misses by assessing # of misses relative to the total # of objects. Default a 3% reduction for any # of misses.
-            if (countMiss > 0)
-                flashlightValue *= 0.97 * Math.Pow(1 - Math.Pow((double)countMiss / totalHits, 0.775), Math.Pow(countMiss, .875));
+            if (effectiveMissCount > 0)
+                flashlightValue *= 0.97 * Math.Pow(1 - Math.Pow((double)effectiveMissCount / totalHits, 0.775), Math.Pow(effectiveMissCount, .875));
 
             // Combo scaling.
             if (Attributes.MaxCombo > 0)
@@ -224,6 +253,24 @@ namespace osu.Game.Rulesets.Osu.Difficulty
             return flashlightValue;
         }
 
+        private int calculateEffectiveMissCount()
+        {
+            // guess the number of misses + slider breaks from combo
+            double comboBasedMissCount = 0.0;
+
+            if (Attributes.SliderCount > 0)
+            {
+                double fullComboThreshold = Attributes.MaxCombo - 0.1 * Attributes.SliderCount;
+                if (scoreMaxCombo < fullComboThreshold)
+                    comboBasedMissCount = fullComboThreshold / Math.Max(1.0, scoreMaxCombo);
+            }
+
+            // we're clamping misscount because since its derived from combo it can be higher than total hits and that breaks some calculations
+            comboBasedMissCount = Math.Min(comboBasedMissCount, totalHits);
+
+            return Math.Max(countMiss, (int)Math.Floor(comboBasedMissCount));
+        }
+
         private int totalHits => countGreat + countOk + countMeh + countMiss;
         private int totalSuccessfulHits => countGreat + countOk + countMeh;
     }

From e3a0e4749e19a9cc1e1ec8e2d118659156cf87d1 Mon Sep 17 00:00:00 2001
From: Xexxar <xexxar.xexxar@gmail.com>
Date: Thu, 21 Oct 2021 19:28:06 +0000
Subject: [PATCH 0385/5547] removed excess acute anglebuff and buffed sliders
 to comp

---
 .../Difficulty/Preprocessing/OsuDifficultyHitObject.cs          | 2 +-
 osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs                  | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
index bf5bfa3cbf..e230a6fa6b 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
@@ -108,7 +108,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
                     if ((OsuHitObject)lastSlider.NestedHitObjects[i] is SliderTick && i != lastSlider.NestedHitObjects.Count - 1) // Check for tick && not last object is necessary for 2007 bugged sliders.
                     {
                         Vector2 nextSlider = Vector2.Subtract(((OsuHitObject)lastSlider.NestedHitObjects[i + 1]).StackedPosition, ((OsuHitObject)lastSlider.NestedHitObjects[i]).StackedPosition);
-                        TravelDistance += 2 * Vector2.Subtract(nextSlider, currSlider).Length * scalingFactor;
+                        TravelDistance += Vector2.Subtract(nextSlider, currSlider).Length * scalingFactor;
                     }
                 }
 
diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
index bb75be6fe0..3c4baa2231 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
@@ -24,7 +24,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
 
         private const double wide_angle_multiplier = 1.5;
         private const double acute_angle_multiplier = 1.5;
-        private const double slider_multiplier = 1.75;
+        private const double slider_multiplier = 2.5;
 
         private double currentStrain = 1;
 

From ec06e532120af823c6133f805d663ea080e2b3c2 Mon Sep 17 00:00:00 2001
From: Xexxar <xexxar.xexxar@gmail.com>
Date: Thu, 21 Oct 2021 19:58:02 +0000
Subject: [PATCH 0386/5547] further rebalancing of sliders

---
 .../Difficulty/Preprocessing/OsuDifficultyHitObject.cs          | 2 +-
 osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs                  | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
index e230a6fa6b..1feaa47dc5 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
@@ -108,7 +108,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
                     if ((OsuHitObject)lastSlider.NestedHitObjects[i] is SliderTick && i != lastSlider.NestedHitObjects.Count - 1) // Check for tick && not last object is necessary for 2007 bugged sliders.
                     {
                         Vector2 nextSlider = Vector2.Subtract(((OsuHitObject)lastSlider.NestedHitObjects[i + 1]).StackedPosition, ((OsuHitObject)lastSlider.NestedHitObjects[i]).StackedPosition);
-                        TravelDistance += Vector2.Subtract(nextSlider, currSlider).Length * scalingFactor;
+                        TravelDistance += 3 * Math.Max(0, Vector2.Subtract(nextSlider, currSlider).Length - Math.Max(nextSlider.Length, currSlider.Length)) * scalingFactor;
                     }
                 }
 
diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
index 3c4baa2231..5d2cf590ae 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
@@ -24,7 +24,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
 
         private const double wide_angle_multiplier = 1.5;
         private const double acute_angle_multiplier = 1.5;
-        private const double slider_multiplier = 2.5;
+        private const double slider_multiplier = 2.0;
 
         private double currentStrain = 1;
 

From 85f28a843affab2ce1e258008ea2d49d0f858f28 Mon Sep 17 00:00:00 2001
From: Xexxar <xexxar.xexxar@gmail.com>
Date: Thu, 21 Oct 2021 21:30:00 +0000
Subject: [PATCH 0387/5547] adjusted sliders further

---
 .../Difficulty/Preprocessing/OsuDifficultyHitObject.cs    | 8 +++++---
 osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs            | 2 +-
 2 files changed, 6 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
index 1feaa47dc5..05098b0199 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
@@ -88,7 +88,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
                 computeSliderCursorPosition(lastSlider);
                 TravelDistance = 0;
                 TravelTime = Math.Max(lastSlider.LazyTravelTime / clockRate, min_delta_time);
-                MovementTime = Math.Max(StrainTime - TravelTime, min_delta_time);
+                MovementTime = Math.Max(StrainTime - lastSlider.LazyTravelTime / clockRate, min_delta_time);
                 MovementDistance = Vector2.Subtract(lastSlider.TailCircle.StackedPosition, BaseObject.StackedPosition).Length * scalingFactor;
 
                 int repeatCount = 0;
@@ -112,13 +112,15 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
                     }
                 }
 
-                TravelDistance *= Math.Max(0, Math.Min(TravelTime, lastSlider.SpanDuration - 50)) / lastSlider.SpanDuration;
+                TravelDistance *= Math.Pow(1 + repeatCount, 1.0 / 3.0);
+
+                TravelDistance *= Math.Max(0, lastSlider.SpanDuration - 37.5) / lastSlider.SpanDuration;
             }
 
             Vector2 lastCursorPosition = getEndCursorPosition(lastObject);
 
             JumpDistance = (BaseObject.StackedPosition * scalingFactor - lastCursorPosition * scalingFactor).Length;
-            MovementDistance = Math.Min(JumpDistance, MovementDistance);
+            MovementDistance = Math.Max(0, Math.Min(JumpDistance, MovementDistance) - 50);
 
             if (lastLastObject != null && !(lastLastObject is Spinner))
             {
diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
index 5d2cf590ae..bb75be6fe0 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
@@ -24,7 +24,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
 
         private const double wide_angle_multiplier = 1.5;
         private const double acute_angle_multiplier = 1.5;
-        private const double slider_multiplier = 2.0;
+        private const double slider_multiplier = 1.75;
 
         private double currentStrain = 1;
 

From 08971ff8f27e1489354f8ee596f89ce186bd6565 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 22 Oct 2021 11:03:28 +0900
Subject: [PATCH 0388/5547] Fix typo in region spedc
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.Tests/Skins/IO/ImportSkinTest.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Skins/IO/ImportSkinTest.cs b/osu.Game.Tests/Skins/IO/ImportSkinTest.cs
index 20bf42345f..b62fb8bd87 100644
--- a/osu.Game.Tests/Skins/IO/ImportSkinTest.cs
+++ b/osu.Game.Tests/Skins/IO/ImportSkinTest.cs
@@ -102,7 +102,7 @@ namespace osu.Game.Tests.Skins.IO
 
         #endregion
 
-        #region Cases where imports should be uniquely import1
+        #region Cases where imports should be uniquely imported
 
         [Test]
         public Task TestImportTwiceWithSameMetadataButDifferentFilename() => runSkinTest(async osu =>

From a1c9b56083f1b7360343de2e3b74a357c7592417 Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Fri, 22 Oct 2021 12:39:48 +0900
Subject: [PATCH 0389/5547] Rename modes

---
 .../Online/Multiplayer/MultiplayerRoomSettings.cs     |  2 +-
 osu.Game/Online/Multiplayer/Queueing/QueueModes.cs    | 11 +++++++----
 2 files changed, 8 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Online/Multiplayer/MultiplayerRoomSettings.cs b/osu.Game/Online/Multiplayer/MultiplayerRoomSettings.cs
index af8ee96693..91042d3a08 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerRoomSettings.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerRoomSettings.cs
@@ -45,7 +45,7 @@ namespace osu.Game.Online.Multiplayer
         public MatchType MatchType { get; set; } = MatchType.HeadToHead;
 
         [Key(9)]
-        public QueueModes QueueMode { get; set; } = QueueModes.HostPick;
+        public QueueModes QueueMode { get; set; } = QueueModes.HostOnly;
 
         public bool Equals(MultiplayerRoomSettings other)
             => BeatmapID == other.BeatmapID
diff --git a/osu.Game/Online/Multiplayer/Queueing/QueueModes.cs b/osu.Game/Online/Multiplayer/Queueing/QueueModes.cs
index cb1e765891..0ead8d2f06 100644
--- a/osu.Game/Online/Multiplayer/Queueing/QueueModes.cs
+++ b/osu.Game/Online/Multiplayer/Queueing/QueueModes.cs
@@ -9,10 +9,13 @@ namespace osu.Game.Online.Multiplayer.Queueing
     {
         // used for osu-web deserialization so names shouldn't be changed.
 
-        [Description("Host pick")]
-        HostPick,
+        [Description("Host only")]
+        HostOnly,
 
-        [Description("Karaoke")]
-        Karaoke,
+        [Description("Free-for-all")]
+        FreeForAll,
+
+        [Description("Fair rotate")]
+        FairRotate
     }
 }

From e5b73f25cd40cadf90884fb8f2dc160d6a764ad8 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 22 Oct 2021 12:56:05 +0900
Subject: [PATCH 0390/5547] Ensure newly created `skin.ini` files are set to
 latest version

---
 osu.Game/Skinning/SkinManager.cs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Game/Skinning/SkinManager.cs b/osu.Game/Skinning/SkinManager.cs
index fffdf19976..16ed25eeb1 100644
--- a/osu.Game/Skinning/SkinManager.cs
+++ b/osu.Game/Skinning/SkinManager.cs
@@ -255,6 +255,7 @@ namespace osu.Game.Skinning
                         sw.WriteLine("[General]");
                         sw.WriteLine(nameLine);
                         sw.WriteLine(authorLine);
+                        sw.WriteLine("Version: latest");
                     }
 
                     AddFile(item, stream, "skin.ini");

From 9cdc1ba59219ecd31df04c235def14567f4fbee4 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 22 Oct 2021 13:43:45 +0900
Subject: [PATCH 0391/5547] Fix default legacy skin not being able to read from
 stored `skin.ini`

---
 osu.Game/Skinning/DefaultLegacySkin.cs |  9 +++++-
 osu.Game/Skinning/LegacySkin.cs        | 39 ++++++++++++++++----------
 2 files changed, 32 insertions(+), 16 deletions(-)

diff --git a/osu.Game/Skinning/DefaultLegacySkin.cs b/osu.Game/Skinning/DefaultLegacySkin.cs
index 16ac17546d..cd6dbd9ddd 100644
--- a/osu.Game/Skinning/DefaultLegacySkin.cs
+++ b/osu.Game/Skinning/DefaultLegacySkin.cs
@@ -19,7 +19,14 @@ namespace osu.Game.Skinning
 
         [UsedImplicitly(ImplicitUseKindFlags.InstantiatedWithFixedConstructorSignature)]
         public DefaultLegacySkin(SkinInfo skin, IStorageResourceProvider resources)
-            : base(skin, new NamespacedResourceStore<byte[]>(resources.Resources, "Skins/Legacy"), resources, string.Empty)
+            : base(
+                skin,
+                new NamespacedResourceStore<byte[]>(resources.Resources, "Skins/Legacy"),
+                resources,
+                // A default legacy skin may still have a skin.ini if it is modified by the user.
+                // We must specify the stream directly as we are redirecting storage to the osu-resources location for other files.
+                new LegacySkinResourceStore<SkinFileInfo>(skin, resources.Files).GetStream("skin.ini")
+            )
         {
             Configuration.CustomColours["SliderBall"] = new Color4(2, 170, 255, 255);
             Configuration.CustomComboColours = new List<Color4>
diff --git a/osu.Game/Skinning/LegacySkin.cs b/osu.Game/Skinning/LegacySkin.cs
index b09620411b..5ab3ef84db 100644
--- a/osu.Game/Skinning/LegacySkin.cs
+++ b/osu.Game/Skinning/LegacySkin.cs
@@ -69,28 +69,37 @@ namespace osu.Game.Skinning
         /// <param name="resources">Access to raw game resources.</param>
         /// <param name="configurationFilename">The user-facing filename of the configuration file to be parsed. Can accept an .osu or skin.ini file.</param>
         protected LegacySkin(SkinInfo skin, [CanBeNull] IResourceStore<byte[]> storage, [CanBeNull] IStorageResourceProvider resources, string configurationFilename)
+            : this(skin, storage, resources, storage?.GetStream(configurationFilename))
+        {
+        }
+
+        /// <summary>
+        /// Construct a new legacy skin instance.
+        /// </summary>
+        /// <param name="skin">The model for this skin.</param>
+        /// <param name="storage">A storage for looking up files within this skin using user-facing filenames.</param>
+        /// <param name="resources">Access to raw game resources.</param>
+        /// <param name="configurationStream">An optional stream containing the contents of a skin.ini file.</param>
+        protected LegacySkin(SkinInfo skin, [CanBeNull] IResourceStore<byte[]> storage, [CanBeNull] IStorageResourceProvider resources, [CanBeNull] Stream configurationStream)
             : base(skin, resources)
         {
-            using (var stream = storage?.GetStream(configurationFilename))
+            if (configurationStream != null)
             {
-                if (stream != null)
+                using (LineBufferedReader reader = new LineBufferedReader(configurationStream, true))
+                    Configuration = new LegacySkinDecoder().Decode(reader);
+
+                configurationStream.Seek(0, SeekOrigin.Begin);
+
+                using (LineBufferedReader reader = new LineBufferedReader(configurationStream))
                 {
-                    using (LineBufferedReader reader = new LineBufferedReader(stream, true))
-                        Configuration = new LegacySkinDecoder().Decode(reader);
+                    var maniaList = new LegacyManiaSkinDecoder().Decode(reader);
 
-                    stream.Seek(0, SeekOrigin.Begin);
-
-                    using (LineBufferedReader reader = new LineBufferedReader(stream))
-                    {
-                        var maniaList = new LegacyManiaSkinDecoder().Decode(reader);
-
-                        foreach (var config in maniaList)
-                            maniaConfigurations[config.Keys] = config;
-                    }
+                    foreach (var config in maniaList)
+                        maniaConfigurations[config.Keys] = config;
                 }
-                else
-                    Configuration = new LegacySkinConfiguration();
             }
+            else
+                Configuration = new LegacySkinConfiguration();
 
             if (storage != null)
             {

From 82d0a6515fbe39536dd86122aede7caec25badd8 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 22 Oct 2021 14:08:12 +0900
Subject: [PATCH 0392/5547] Fix incorrect conditional for checking whether
 import (would fail for default skin)

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

diff --git a/osu.Game/Skinning/SkinManager.cs b/osu.Game/Skinning/SkinManager.cs
index 16ed25eeb1..707afade09 100644
--- a/osu.Game/Skinning/SkinManager.cs
+++ b/osu.Game/Skinning/SkinManager.cs
@@ -166,7 +166,7 @@ namespace osu.Game.Skinning
             string skinIniSourcedCreator = instance.Configuration.SkinInfo.Creator;
             string archiveName = item.Name.Replace(".osk", "", StringComparison.OrdinalIgnoreCase);
 
-            bool isImport = reader != null;
+            bool isImport = item.ID == 0;
 
             if (isImport)
             {

From 93482414d6d69fff3e02a0083afb1fb55244db23 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 22 Oct 2021 14:41:59 +0900
Subject: [PATCH 0393/5547] Remove `SkinConfiguration` subclasses and allow
 configuration parsing for all skin types

---
 .../Legacy/CatchLegacySkinTransformer.cs      |  2 +-
 .../Skinning/Legacy/LegacyStageBackground.cs  |  2 +-
 .../Legacy/ManiaLegacySkinTransformer.cs      |  2 +-
 .../Skinning/Legacy/LegacyMainCirclePiece.cs  |  3 +-
 .../Skinning/Legacy/LegacyInputDrum.cs        |  2 +-
 .../Gameplay/TestSceneHitObjectSamples.cs     |  2 +-
 osu.Game.Tests/Skins/LegacySkinDecoderTest.cs |  2 +-
 .../Skins/TestSceneSkinConfigurationLookup.cs |  8 +--
 .../Objects/Legacy/ConvertHitObjectParser.cs  |  2 +-
 osu.Game/Skinning/DefaultSkin.cs              |  1 -
 osu.Game/Skinning/DefaultSkinConfiguration.cs | 12 ----
 osu.Game/Skinning/LegacyBeatmapSkin.cs        |  2 +-
 osu.Game/Skinning/LegacySkin.cs               | 55 ++++++++-----------
 osu.Game/Skinning/LegacySkinConfiguration.cs  | 28 ----------
 osu.Game/Skinning/LegacySkinDecoder.cs        |  8 +--
 osu.Game/Skinning/LegacySkinExtensions.cs     |  2 +-
 osu.Game/Skinning/LegacySkinTransformer.cs    |  2 +-
 osu.Game/Skinning/Skin.cs                     | 31 ++++++++++-
 osu.Game/Skinning/SkinConfiguration.cs        | 20 +++++++
 osu.Game/Skinning/SkinManager.cs              |  2 +-
 20 files changed, 92 insertions(+), 96 deletions(-)
 delete mode 100644 osu.Game/Skinning/DefaultSkinConfiguration.cs
 delete mode 100644 osu.Game/Skinning/LegacySkinConfiguration.cs

diff --git a/osu.Game.Rulesets.Catch/Skinning/Legacy/CatchLegacySkinTransformer.cs b/osu.Game.Rulesets.Catch/Skinning/Legacy/CatchLegacySkinTransformer.cs
index 10fc4e78b2..335d78388b 100644
--- a/osu.Game.Rulesets.Catch/Skinning/Legacy/CatchLegacySkinTransformer.cs
+++ b/osu.Game.Rulesets.Catch/Skinning/Legacy/CatchLegacySkinTransformer.cs
@@ -66,7 +66,7 @@ namespace osu.Game.Rulesets.Catch.Skinning.Legacy
                         return null;
 
                     case CatchSkinComponents.Catcher:
-                        var version = GetConfig<LegacySkinConfiguration.LegacySetting, decimal>(LegacySkinConfiguration.LegacySetting.Version)?.Value ?? 1;
+                        var version = GetConfig<SkinConfiguration.LegacySetting, decimal>(SkinConfiguration.LegacySetting.Version)?.Value ?? 1;
 
                         if (version < 2.3m)
                         {
diff --git a/osu.Game.Rulesets.Mania/Skinning/Legacy/LegacyStageBackground.cs b/osu.Game.Rulesets.Mania/Skinning/Legacy/LegacyStageBackground.cs
index fec3e9493e..952fc7ddd6 100644
--- a/osu.Game.Rulesets.Mania/Skinning/Legacy/LegacyStageBackground.cs
+++ b/osu.Game.Rulesets.Mania/Skinning/Legacy/LegacyStageBackground.cs
@@ -98,7 +98,7 @@ namespace osu.Game.Rulesets.Mania.Skinning.Legacy
                 float rightLineWidth = skin.GetManiaSkinConfig<float>(LegacyManiaSkinConfigurationLookups.RightLineWidth, columnIndex)?.Value ?? 1;
 
                 bool hasLeftLine = leftLineWidth > 0;
-                bool hasRightLine = rightLineWidth > 0 && skin.GetConfig<LegacySkinConfiguration.LegacySetting, decimal>(LegacySkinConfiguration.LegacySetting.Version)?.Value >= 2.4m
+                bool hasRightLine = rightLineWidth > 0 && skin.GetConfig<SkinConfiguration.LegacySetting, decimal>(SkinConfiguration.LegacySetting.Version)?.Value >= 2.4m
                                     || isLastColumn;
 
                 Color4 lineColour = skin.GetManiaSkinConfig<Color4>(LegacyManiaSkinConfigurationLookups.ColumnLineColour, columnIndex)?.Value ?? Color4.White;
diff --git a/osu.Game.Rulesets.Mania/Skinning/Legacy/ManiaLegacySkinTransformer.cs b/osu.Game.Rulesets.Mania/Skinning/Legacy/ManiaLegacySkinTransformer.cs
index 814a737034..0de9a098bc 100644
--- a/osu.Game.Rulesets.Mania/Skinning/Legacy/ManiaLegacySkinTransformer.cs
+++ b/osu.Game.Rulesets.Mania/Skinning/Legacy/ManiaLegacySkinTransformer.cs
@@ -63,7 +63,7 @@ namespace osu.Game.Rulesets.Mania.Skinning.Legacy
         {
             this.beatmap = (ManiaBeatmap)beatmap;
 
-            isLegacySkin = new Lazy<bool>(() => GetConfig<LegacySkinConfiguration.LegacySetting, decimal>(LegacySkinConfiguration.LegacySetting.Version) != null);
+            isLegacySkin = new Lazy<bool>(() => GetConfig<SkinConfiguration.LegacySetting, decimal>(SkinConfiguration.LegacySetting.Version) != null);
             hasKeyTexture = new Lazy<bool>(() =>
             {
                 var keyImage = this.GetManiaSkinConfig<string>(LegacyManiaSkinConfigurationLookups.KeyImage, 0)?.Value ?? "mania-key1";
diff --git a/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyMainCirclePiece.cs b/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyMainCirclePiece.cs
index d1c9b1bf92..0e0f4f4291 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyMainCirclePiece.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyMainCirclePiece.cs
@@ -14,7 +14,6 @@ using osu.Game.Rulesets.Osu.Objects.Drawables;
 using osu.Game.Skinning;
 using osuTK;
 using osuTK.Graphics;
-using static osu.Game.Skinning.LegacySkinConfiguration;
 
 namespace osu.Game.Rulesets.Osu.Skinning.Legacy
 {
@@ -158,7 +157,7 @@ namespace osu.Game.Rulesets.Osu.Skinning.Legacy
 
                         if (hasNumber)
                         {
-                            var legacyVersion = skin.GetConfig<LegacySetting, decimal>(LegacySetting.Version)?.Value;
+                            var legacyVersion = skin.GetConfig<SkinConfiguration.LegacySetting, decimal>(SkinConfiguration.LegacySetting.Version)?.Value;
 
                             if (legacyVersion >= 2.0m)
                                 // legacy skins of version 2.0 and newer only apply very short fade out to the number piece.
diff --git a/osu.Game.Rulesets.Taiko/Skinning/Legacy/LegacyInputDrum.cs b/osu.Game.Rulesets.Taiko/Skinning/Legacy/LegacyInputDrum.cs
index 86be40dea8..43c5c07f80 100644
--- a/osu.Game.Rulesets.Taiko/Skinning/Legacy/LegacyInputDrum.cs
+++ b/osu.Game.Rulesets.Taiko/Skinning/Legacy/LegacyInputDrum.cs
@@ -69,7 +69,7 @@ namespace osu.Game.Rulesets.Taiko.Skinning.Legacy
             // because the right half is flipped, we need to position using width - position to get the true "topleft" origin position
             float negativeScaleAdjust = content.Width / ratio;
 
-            if (skin.GetConfig<LegacySkinConfiguration.LegacySetting, decimal>(LegacySkinConfiguration.LegacySetting.Version)?.Value >= 2.1m)
+            if (skin.GetConfig<SkinConfiguration.LegacySetting, decimal>(SkinConfiguration.LegacySetting.Version)?.Value >= 2.1m)
             {
                 left.Centre.Position = new Vector2(0, taiko_bar_y) * ratio;
                 right.Centre.Position = new Vector2(negativeScaleAdjust - 56, taiko_bar_y) * ratio;
diff --git a/osu.Game.Tests/Gameplay/TestSceneHitObjectSamples.cs b/osu.Game.Tests/Gameplay/TestSceneHitObjectSamples.cs
index fc420e22a1..153d5b8e36 100644
--- a/osu.Game.Tests/Gameplay/TestSceneHitObjectSamples.cs
+++ b/osu.Game.Tests/Gameplay/TestSceneHitObjectSamples.cs
@@ -7,7 +7,7 @@ using osu.Game.Rulesets;
 using osu.Game.Rulesets.Osu;
 using osu.Game.Tests.Beatmaps;
 using osu.Game.Tests.Resources;
-using static osu.Game.Skinning.LegacySkinConfiguration;
+using static osu.Game.Skinning.SkinConfiguration;
 
 namespace osu.Game.Tests.Gameplay
 {
diff --git a/osu.Game.Tests/Skins/LegacySkinDecoderTest.cs b/osu.Game.Tests/Skins/LegacySkinDecoderTest.cs
index dcb866c99f..cfc140ce39 100644
--- a/osu.Game.Tests/Skins/LegacySkinDecoderTest.cs
+++ b/osu.Game.Tests/Skins/LegacySkinDecoderTest.cs
@@ -106,7 +106,7 @@ namespace osu.Game.Tests.Skins
             var decoder = new LegacySkinDecoder();
             using (var resStream = TestResources.OpenResource("skin-latest.ini"))
             using (var stream = new LineBufferedReader(resStream))
-                Assert.AreEqual(LegacySkinConfiguration.LATEST_VERSION, decoder.Decode(stream).LegacyVersion);
+                Assert.AreEqual(SkinConfiguration.LATEST_VERSION, decoder.Decode(stream).LegacyVersion);
         }
 
         [Test]
diff --git a/osu.Game.Tests/Skins/TestSceneSkinConfigurationLookup.cs b/osu.Game.Tests/Skins/TestSceneSkinConfigurationLookup.cs
index aadabec100..870d6d8f57 100644
--- a/osu.Game.Tests/Skins/TestSceneSkinConfigurationLookup.cs
+++ b/osu.Game.Tests/Skins/TestSceneSkinConfigurationLookup.cs
@@ -151,7 +151,7 @@ namespace osu.Game.Tests.Skins
         {
             AddStep("Set user skin version 2.3", () => userSource.Configuration.LegacyVersion = 2.3m);
             AddStep("Set beatmap skin version null", () => beatmapSource.Configuration.LegacyVersion = null);
-            AddAssert("Check legacy version lookup", () => requester.GetConfig<LegacySkinConfiguration.LegacySetting, decimal>(LegacySkinConfiguration.LegacySetting.Version)?.Value == 2.3m);
+            AddAssert("Check legacy version lookup", () => requester.GetConfig<SkinConfiguration.LegacySetting, decimal>(SkinConfiguration.LegacySetting.Version)?.Value == 2.3m);
         }
 
         [Test]
@@ -160,7 +160,7 @@ namespace osu.Game.Tests.Skins
             // completely ignoring beatmap versions for simplicity.
             AddStep("Set user skin version 2.3", () => userSource.Configuration.LegacyVersion = 2.3m);
             AddStep("Set beatmap skin version null", () => beatmapSource.Configuration.LegacyVersion = 1.7m);
-            AddAssert("Check legacy version lookup", () => requester.GetConfig<LegacySkinConfiguration.LegacySetting, decimal>(LegacySkinConfiguration.LegacySetting.Version)?.Value == 2.3m);
+            AddAssert("Check legacy version lookup", () => requester.GetConfig<SkinConfiguration.LegacySetting, decimal>(SkinConfiguration.LegacySetting.Version)?.Value == 2.3m);
         }
 
         [Test]
@@ -169,14 +169,14 @@ namespace osu.Game.Tests.Skins
             AddStep("Set user skin version 2.3", () => userSource.Configuration.LegacyVersion = null);
             AddStep("Set beatmap skin version null", () => beatmapSource.Configuration.LegacyVersion = null);
             AddAssert("Check legacy version lookup",
-                () => requester.GetConfig<LegacySkinConfiguration.LegacySetting, decimal>(LegacySkinConfiguration.LegacySetting.Version)?.Value == LegacySkinConfiguration.LATEST_VERSION);
+                () => requester.GetConfig<SkinConfiguration.LegacySetting, decimal>(SkinConfiguration.LegacySetting.Version)?.Value == SkinConfiguration.LATEST_VERSION);
         }
 
         [Test]
         public void TestIniWithNoVersionFallsBackTo1()
         {
             AddStep("Parse skin with no version", () => userSource.Configuration = new LegacySkinDecoder().Decode(new LineBufferedReader(new MemoryStream())));
-            AddAssert("Check legacy version lookup", () => requester.GetConfig<LegacySkinConfiguration.LegacySetting, decimal>(LegacySkinConfiguration.LegacySetting.Version)?.Value == 1.0m);
+            AddAssert("Check legacy version lookup", () => requester.GetConfig<SkinConfiguration.LegacySetting, decimal>(SkinConfiguration.LegacySetting.Version)?.Value == 1.0m);
         }
 
         public enum LookupType
diff --git a/osu.Game/Rulesets/Objects/Legacy/ConvertHitObjectParser.cs b/osu.Game/Rulesets/Objects/Legacy/ConvertHitObjectParser.cs
index 0942a7264d..d902918e83 100644
--- a/osu.Game/Rulesets/Objects/Legacy/ConvertHitObjectParser.cs
+++ b/osu.Game/Rulesets/Objects/Legacy/ConvertHitObjectParser.cs
@@ -481,7 +481,7 @@ namespace osu.Game.Rulesets.Objects.Legacy
             /// </summary>
             /// <remarks>
             /// Layered hit samples are automatically added in all modes (except osu!mania), but can be disabled
-            /// using the <see cref="LegacySkinConfiguration.LegacySetting.LayeredHitSounds"/> skin config option.
+            /// using the <see cref="SkinConfiguration.LegacySetting.LayeredHitSounds"/> skin config option.
             /// </remarks>
             public readonly bool IsLayered;
 
diff --git a/osu.Game/Skinning/DefaultSkin.cs b/osu.Game/Skinning/DefaultSkin.cs
index 8e03bddb4d..d972ce3af6 100644
--- a/osu.Game/Skinning/DefaultSkin.cs
+++ b/osu.Game/Skinning/DefaultSkin.cs
@@ -35,7 +35,6 @@ namespace osu.Game.Skinning
             : base(skin, resources)
         {
             this.resources = resources;
-            Configuration = new DefaultSkinConfiguration();
         }
 
         public override Texture GetTexture(string componentName, WrapMode wrapModeS, WrapMode wrapModeT) => null;
diff --git a/osu.Game/Skinning/DefaultSkinConfiguration.cs b/osu.Game/Skinning/DefaultSkinConfiguration.cs
deleted file mode 100644
index 5842ee82ee..0000000000
--- a/osu.Game/Skinning/DefaultSkinConfiguration.cs
+++ /dev/null
@@ -1,12 +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.Skinning
-{
-    /// <summary>
-    /// A skin configuration pre-populated with sane defaults.
-    /// </summary>
-    public class DefaultSkinConfiguration : SkinConfiguration
-    {
-    }
-}
diff --git a/osu.Game/Skinning/LegacyBeatmapSkin.cs b/osu.Game/Skinning/LegacyBeatmapSkin.cs
index 2093182dcc..8720a55076 100644
--- a/osu.Game/Skinning/LegacyBeatmapSkin.cs
+++ b/osu.Game/Skinning/LegacyBeatmapSkin.cs
@@ -50,7 +50,7 @@ namespace osu.Game.Skinning
         {
             switch (lookup)
             {
-                case LegacySkinConfiguration.LegacySetting s when s == LegacySkinConfiguration.LegacySetting.Version:
+                case SkinConfiguration.LegacySetting s when s == SkinConfiguration.LegacySetting.Version:
                     // For lookup simplicity, ignore beatmap-level versioning completely.
 
                     // If it is decided that we need this due to beatmaps somehow using it, the default (1.0 specified in LegacySkinDecoder.CreateTemplateObject)
diff --git a/osu.Game/Skinning/LegacySkin.cs b/osu.Game/Skinning/LegacySkin.cs
index 5ab3ef84db..6facb6fafd 100644
--- a/osu.Game/Skinning/LegacySkin.cs
+++ b/osu.Game/Skinning/LegacySkin.cs
@@ -47,12 +47,6 @@ namespace osu.Game.Skinning
         /// </summary>
         protected virtual bool UseCustomSampleBanks => false;
 
-        public new LegacySkinConfiguration Configuration
-        {
-            get => base.Configuration as LegacySkinConfiguration;
-            set => base.Configuration = value;
-        }
-
         private readonly Dictionary<int, LegacyManiaSkinConfiguration> maniaConfigurations = new Dictionary<int, LegacyManiaSkinConfiguration>();
 
         [UsedImplicitly(ImplicitUseKindFlags.InstantiatedWithFixedConstructorSignature)]
@@ -81,26 +75,8 @@ namespace osu.Game.Skinning
         /// <param name="resources">Access to raw game resources.</param>
         /// <param name="configurationStream">An optional stream containing the contents of a skin.ini file.</param>
         protected LegacySkin(SkinInfo skin, [CanBeNull] IResourceStore<byte[]> storage, [CanBeNull] IStorageResourceProvider resources, [CanBeNull] Stream configurationStream)
-            : base(skin, resources)
+            : base(skin, resources, configurationStream)
         {
-            if (configurationStream != null)
-            {
-                using (LineBufferedReader reader = new LineBufferedReader(configurationStream, true))
-                    Configuration = new LegacySkinDecoder().Decode(reader);
-
-                configurationStream.Seek(0, SeekOrigin.Begin);
-
-                using (LineBufferedReader reader = new LineBufferedReader(configurationStream))
-                {
-                    var maniaList = new LegacyManiaSkinDecoder().Decode(reader);
-
-                    foreach (var config in maniaList)
-                        maniaConfigurations[config.Keys] = config;
-                }
-            }
-            else
-                Configuration = new LegacySkinConfiguration();
-
             if (storage != null)
             {
                 var samples = resources?.AudioManager?.GetSampleStore(storage);
@@ -119,6 +95,21 @@ namespace osu.Game.Skinning
                 true) != null);
         }
 
+        protected override void ParseConfigurationStream(Stream stream)
+        {
+            base.ParseConfigurationStream(stream);
+
+            stream.Seek(0, SeekOrigin.Begin);
+
+            using (LineBufferedReader reader = new LineBufferedReader(stream))
+            {
+                var maniaList = new LegacyManiaSkinDecoder().Decode(reader);
+
+                foreach (var config in maniaList)
+                    maniaConfigurations[config.Keys] = config;
+            }
+        }
+
         public override IBindable<TValue> GetConfig<TLookup, TValue>(TLookup lookup)
         {
             switch (lookup)
@@ -155,7 +146,7 @@ namespace osu.Game.Skinning
 
                     break;
 
-                case LegacySkinConfiguration.LegacySetting legacy:
+                case SkinConfiguration.LegacySetting legacy:
                     return legacySettingLookup<TValue>(legacy);
 
                 default:
@@ -198,7 +189,7 @@ namespace osu.Game.Skinning
                 case LegacyManiaSkinConfigurationLookups.ExplosionScale:
                     Debug.Assert(maniaLookup.TargetColumn != null);
 
-                    if (GetConfig<LegacySkinConfiguration.LegacySetting, decimal>(LegacySkinConfiguration.LegacySetting.Version)?.Value < 2.5m)
+                    if (GetConfig<SkinConfiguration.LegacySetting, decimal>(SkinConfiguration.LegacySetting.Version)?.Value < 2.5m)
                         return SkinUtils.As<TValue>(new Bindable<float>(1));
 
                     if (existing.ExplosionWidth[maniaLookup.TargetColumn.Value] != 0)
@@ -245,7 +236,7 @@ namespace osu.Game.Skinning
                 case LegacyManiaSkinConfigurationLookups.HoldNoteLightScale:
                     Debug.Assert(maniaLookup.TargetColumn != null);
 
-                    if (GetConfig<LegacySkinConfiguration.LegacySetting, decimal>(LegacySkinConfiguration.LegacySetting.Version)?.Value < 2.5m)
+                    if (GetConfig<SkinConfiguration.LegacySetting, decimal>(SkinConfiguration.LegacySetting.Version)?.Value < 2.5m)
                         return SkinUtils.As<TValue>(new Bindable<float>(1));
 
                     if (existing.HoldNoteLightWidth[maniaLookup.TargetColumn.Value] != 0)
@@ -318,15 +309,15 @@ namespace osu.Game.Skinning
             => source.ImageLookups.TryGetValue(lookup, out var image) ? new Bindable<string>(image) : null;
 
         [CanBeNull]
-        private IBindable<TValue> legacySettingLookup<TValue>(LegacySkinConfiguration.LegacySetting legacySetting)
+        private IBindable<TValue> legacySettingLookup<TValue>(SkinConfiguration.LegacySetting legacySetting)
         {
             switch (legacySetting)
             {
-                case LegacySkinConfiguration.LegacySetting.Version:
-                    return SkinUtils.As<TValue>(new Bindable<decimal>(Configuration.LegacyVersion ?? LegacySkinConfiguration.LATEST_VERSION));
+                case SkinConfiguration.LegacySetting.Version:
+                    return SkinUtils.As<TValue>(new Bindable<decimal>(Configuration.LegacyVersion ?? SkinConfiguration.LATEST_VERSION));
 
                 default:
-                    return genericLookup<LegacySkinConfiguration.LegacySetting, TValue>(legacySetting);
+                    return genericLookup<SkinConfiguration.LegacySetting, TValue>(legacySetting);
             }
         }
 
diff --git a/osu.Game/Skinning/LegacySkinConfiguration.cs b/osu.Game/Skinning/LegacySkinConfiguration.cs
deleted file mode 100644
index 20d1da8aaa..0000000000
--- a/osu.Game/Skinning/LegacySkinConfiguration.cs
+++ /dev/null
@@ -1,28 +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.Skinning
-{
-    public class LegacySkinConfiguration : SkinConfiguration
-    {
-        public const decimal LATEST_VERSION = 2.7m;
-
-        /// <summary>
-        /// Legacy version of this skin.
-        /// </summary>
-        public decimal? LegacyVersion { get; internal set; }
-
-        public enum LegacySetting
-        {
-            Version,
-            ComboPrefix,
-            ComboOverlap,
-            ScorePrefix,
-            ScoreOverlap,
-            HitCirclePrefix,
-            HitCircleOverlap,
-            AnimationFramerate,
-            LayeredHitSounds
-        }
-    }
-}
diff --git a/osu.Game/Skinning/LegacySkinDecoder.cs b/osu.Game/Skinning/LegacySkinDecoder.cs
index 2700f84815..dd8a9dedb2 100644
--- a/osu.Game/Skinning/LegacySkinDecoder.cs
+++ b/osu.Game/Skinning/LegacySkinDecoder.cs
@@ -6,14 +6,14 @@ using osu.Game.Beatmaps.Formats;
 
 namespace osu.Game.Skinning
 {
-    public class LegacySkinDecoder : LegacyDecoder<LegacySkinConfiguration>
+    public class LegacySkinDecoder : LegacyDecoder<SkinConfiguration>
     {
         public LegacySkinDecoder()
             : base(1)
         {
         }
 
-        protected override void ParseLine(LegacySkinConfiguration skin, Section section, string line)
+        protected override void ParseLine(SkinConfiguration skin, Section section, string line)
         {
             if (section != Section.Colours)
             {
@@ -34,7 +34,7 @@ namespace osu.Game.Skinning
 
                             case @"Version":
                                 if (pair.Value == "latest")
-                                    skin.LegacyVersion = LegacySkinConfiguration.LATEST_VERSION;
+                                    skin.LegacyVersion = SkinConfiguration.LATEST_VERSION;
                                 else if (decimal.TryParse(pair.Value, NumberStyles.AllowDecimalPoint, CultureInfo.InvariantCulture, out var version))
                                     skin.LegacyVersion = version;
 
@@ -57,7 +57,7 @@ namespace osu.Game.Skinning
             base.ParseLine(skin, section, line);
         }
 
-        protected override LegacySkinConfiguration CreateTemplateObject()
+        protected override SkinConfiguration CreateTemplateObject()
         {
             var config = base.CreateTemplateObject();
             config.LegacyVersion = 1.0m;
diff --git a/osu.Game/Skinning/LegacySkinExtensions.cs b/osu.Game/Skinning/LegacySkinExtensions.cs
index fd1f905868..479afabb00 100644
--- a/osu.Game/Skinning/LegacySkinExtensions.cs
+++ b/osu.Game/Skinning/LegacySkinExtensions.cs
@@ -12,7 +12,7 @@ using osu.Framework.Graphics.Animations;
 using osu.Framework.Graphics.OpenGL.Textures;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Graphics.Textures;
-using static osu.Game.Skinning.LegacySkinConfiguration;
+using static osu.Game.Skinning.SkinConfiguration;
 
 namespace osu.Game.Skinning
 {
diff --git a/osu.Game/Skinning/LegacySkinTransformer.cs b/osu.Game/Skinning/LegacySkinTransformer.cs
index 92b7a04dee..97084f34e0 100644
--- a/osu.Game/Skinning/LegacySkinTransformer.cs
+++ b/osu.Game/Skinning/LegacySkinTransformer.cs
@@ -10,7 +10,7 @@ using osu.Framework.Graphics.OpenGL.Textures;
 using osu.Framework.Graphics.Textures;
 using osu.Game.Audio;
 using osu.Game.Rulesets.Objects.Legacy;
-using static osu.Game.Skinning.LegacySkinConfiguration;
+using static osu.Game.Skinning.SkinConfiguration;
 
 namespace osu.Game.Skinning
 {
diff --git a/osu.Game/Skinning/Skin.cs b/osu.Game/Skinning/Skin.cs
index 92441f40da..d5f41f01a4 100644
--- a/osu.Game/Skinning/Skin.cs
+++ b/osu.Game/Skinning/Skin.cs
@@ -3,8 +3,10 @@
 
 using System;
 using System.Collections.Generic;
+using System.IO;
 using System.Linq;
 using System.Text;
+using JetBrains.Annotations;
 using Newtonsoft.Json;
 using osu.Framework.Audio.Sample;
 using osu.Framework.Bindables;
@@ -21,8 +23,9 @@ namespace osu.Game.Skinning
     public abstract class Skin : IDisposable, ISkin
     {
         public readonly SkinInfo SkinInfo;
+        private readonly IStorageResourceProvider resources;
 
-        public SkinConfiguration Configuration { get; protected set; }
+        public SkinConfiguration Configuration { get; set; }
 
         public IDictionary<SkinnableTarget, SkinnableInfo[]> DrawableComponentInfo => drawableComponentInfo;
 
@@ -36,9 +39,17 @@ namespace osu.Game.Skinning
 
         public abstract IBindable<TValue> GetConfig<TLookup, TValue>(TLookup lookup);
 
-        protected Skin(SkinInfo skin, IStorageResourceProvider resources)
+        protected Skin(SkinInfo skin, IStorageResourceProvider resources, [CanBeNull] Stream configurationStream = null)
         {
             SkinInfo = skin;
+            this.resources = resources;
+
+            configurationStream ??= getConfigurationStream();
+
+            if (configurationStream != null)
+                ParseConfigurationStream(configurationStream);
+            else
+                Configuration = new SkinConfiguration();
 
             // we may want to move this to some kind of async operation in the future.
             foreach (SkinnableTarget skinnableTarget in Enum.GetValues(typeof(SkinnableTarget)))
@@ -73,6 +84,22 @@ namespace osu.Game.Skinning
             }
         }
 
+        protected virtual void ParseConfigurationStream(Stream stream)
+        {
+            using (LineBufferedReader reader = new LineBufferedReader(stream, true))
+                Configuration = new LegacySkinDecoder().Decode(reader);
+        }
+
+        private Stream getConfigurationStream()
+        {
+            var path = SkinInfo.Files.SingleOrDefault(f => f.Filename == "skin.ini")?.FileInfo.StoragePath;
+
+            if (string.IsNullOrEmpty(path))
+                return null;
+
+            return resources?.Files.GetStream(path);
+        }
+
         /// <summary>
         /// Remove all stored customisations for the provided target.
         /// </summary>
diff --git a/osu.Game/Skinning/SkinConfiguration.cs b/osu.Game/Skinning/SkinConfiguration.cs
index a18144246f..f71f6811e8 100644
--- a/osu.Game/Skinning/SkinConfiguration.cs
+++ b/osu.Game/Skinning/SkinConfiguration.cs
@@ -14,11 +14,31 @@ namespace osu.Game.Skinning
     {
         public readonly SkinInfo SkinInfo = new SkinInfo();
 
+        public const decimal LATEST_VERSION = 2.7m;
+
         /// <summary>
         /// Whether to allow <see cref="DefaultComboColours"/> as a fallback list for when no combo colours are provided.
         /// </summary>
         internal bool AllowDefaultComboColoursFallback = true;
 
+        /// <summary>
+        /// Legacy version of this skin.
+        /// </summary>
+        public decimal? LegacyVersion { get; internal set; }
+
+        public enum LegacySetting
+        {
+            Version,
+            ComboPrefix,
+            ComboOverlap,
+            ScorePrefix,
+            ScoreOverlap,
+            HitCirclePrefix,
+            HitCircleOverlap,
+            AnimationFramerate,
+            LayeredHitSounds
+        }
+
         public static List<Color4> DefaultComboColours { get; } = new List<Color4>
         {
             new Color4(255, 192, 0, 255),
diff --git a/osu.Game/Skinning/SkinManager.cs b/osu.Game/Skinning/SkinManager.cs
index 707afade09..177dbaf28f 100644
--- a/osu.Game/Skinning/SkinManager.cs
+++ b/osu.Game/Skinning/SkinManager.cs
@@ -183,7 +183,7 @@ namespace osu.Game.Skinning
             // By this point, the metadata in SkinInfo will be correct.
             // Regardless of whether this is an import or not, let's write the skin.ini if non-existing or non-matching.
             // This is (weirdly) done inside ComputeHash to avoid adding a new method to handle this case. After switching to realm it can be moved into another place.
-            if (instance is LegacySkin && skinIniSourcedName != item.Name)
+            if (skinIniSourcedName != item.Name)
                 updateSkinIniMetadata(item);
 
             return base.ComputeHash(item, reader);

From eef9949a0a928f3d10df97375119ccc1fbdbbf90 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 22 Oct 2021 14:48:20 +0900
Subject: [PATCH 0394/5547] Remove unnecessary branching around EF logic

---
 osu.Game/Database/ArchiveModelManager.cs | 48 +++++++-----------------
 1 file changed, 14 insertions(+), 34 deletions(-)

diff --git a/osu.Game/Database/ArchiveModelManager.cs b/osu.Game/Database/ArchiveModelManager.cs
index 0bc4c40459..ad5bc6d420 100644
--- a/osu.Game/Database/ArchiveModelManager.cs
+++ b/osu.Game/Database/ArchiveModelManager.cs
@@ -511,29 +511,21 @@ namespace osu.Game.Database
         /// <param name="file">The existing file to be deleted.</param>
         public void DeleteFile(TModel model, TFileModel file)
         {
-            if (model.ID > 0)
+            using (var usage = ContextFactory.GetForWrite())
             {
-                using (var usage = ContextFactory.GetForWrite())
+                // Dereference the existing file info, since the file model will be removed.
+                if (file.FileInfo != null)
                 {
-                    // Dereference the existing file info, since the file model will be removed.
-                    if (file.FileInfo != null)
+                    Files.Dereference(file.FileInfo);
+
+                    if (file.ID > 0)
                     {
-                        Files.Dereference(file.FileInfo);
-
-                        if (file.ID > 0)
-                        {
-                            // This shouldn't be required, but here for safety in case the provided TModel is not being change tracked
-                            // Definitely can be removed once we rework the database backend.
-                            usage.Context.Set<TFileModel>().Remove(file);
-                        }
+                        // This shouldn't be required, but here for safety in case the provided TModel is not being change tracked
+                        // Definitely can be removed once we rework the database backend.
+                        usage.Context.Set<TFileModel>().Remove(file);
                     }
-
-                    model.Files.Remove(file);
                 }
-            }
-            else
-            {
-                Files.Dereference(file.FileInfo);
+
                 model.Files.Remove(file);
             }
         }
@@ -546,29 +538,17 @@ namespace osu.Game.Database
         /// <param name="filename">The filename for the new file.</param>
         public void AddFile(TModel model, Stream contents, string filename)
         {
-            if (model.ID > 0)
+            using (ContextFactory.GetForWrite())
             {
-                using (ContextFactory.GetForWrite())
-                {
-                    model.Files.Add(new TFileModel
-                    {
-                        Filename = filename,
-                        FileInfo = Files.Add(contents)
-                    });
-
-                    Update(model);
-                }
-            }
-            else
-            {
-                // This function may be called during the import process.
-                // Should not exist like this once we have switched to realm.
                 model.Files.Add(new TFileModel
                 {
                     Filename = filename,
                     FileInfo = Files.Add(contents)
                 });
             }
+
+            if (model.ID > 0)
+                Update(model);
         }
 
         /// <summary>

From de33b2f45a67d3fd6e503c5886375d7086ba838c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 22 Oct 2021 15:00:31 +0900
Subject: [PATCH 0395/5547] Return set metadata if available before falling
 back to empty object

---
 osu.Game/Online/API/Requests/Responses/APIBeatmap.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs b/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs
index 49124a404d..7335a1c18d 100644
--- a/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs
@@ -109,7 +109,7 @@ namespace osu.Game.Online.API.Requests.Responses
 
         #region Implementation of IBeatmapInfo
 
-        public IBeatmapMetadataInfo Metadata => new BeatmapMetadata();
+        public IBeatmapMetadataInfo Metadata => (BeatmapSet as IBeatmapSetInfo)?.Metadata ?? new BeatmapMetadata();
 
         public IBeatmapDifficultyInfo Difficulty => new BeatmapDifficulty
         {

From ea473428e84f7adf43f1727eb15281df25b01901 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 22 Oct 2021 15:54:40 +0900
Subject: [PATCH 0396/5547] Fix incorrect length mapping in `APIBeatmap`

---
 osu.Game/Online/API/Requests/Responses/APIBeatmap.cs | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs b/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs
index 42e519223b..6ab1630604 100644
--- a/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs
@@ -51,8 +51,10 @@ namespace osu.Game.Online.API.Requests.Responses
         [JsonProperty(@"accuracy")]
         private float overallDifficulty { get; set; }
 
+        public double Length => lengthInSeconds * 1000;
+
         [JsonProperty(@"total_length")]
-        public double Length { get; set; }
+        private double lengthInSeconds { get; set; }
 
         [JsonProperty(@"count_circles")]
         private int circleCount { get; set; }

From db87e42d4784cf63389f86289827769ee3ea570a Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Fri, 22 Oct 2021 16:48:28 +0900
Subject: [PATCH 0397/5547] Remove beatmap/ruleset/etc from
 MultiplayerRoomSettings

---
 .../Online/Multiplayer/IMultiplayerClient.cs  |  12 ++
 .../Multiplayer/IMultiplayerRoomServer.cs     |  12 ++
 .../Online/Multiplayer/MatchUserRequest.cs    |   2 -
 .../Online/Multiplayer/MultiplayerClient.cs   | 116 +++++++++---------
 .../Multiplayer/MultiplayerRoomSettings.cs    |  37 +-----
 .../Multiplayer/OnlineMultiplayerClient.cs    |  18 +++
 .../APIPlaylistItem.cs}                       |  27 +++-
 .../Online/SignalRUnionWorkaroundResolver.cs  |   2 -
 .../Multiplayer/MultiplayerMatchSongSelect.cs |   4 +-
 .../Participants/ParticipantPanel.cs          |   3 +-
 .../Multiplayer/TestMultiplayerClient.cs      |  55 ++++++++-
 11 files changed, 180 insertions(+), 108 deletions(-)
 rename osu.Game/Online/{Multiplayer/Queueing/EnqueuePlaylistItemRequest.cs => Rooms/APIPlaylistItem.cs} (54%)

diff --git a/osu.Game/Online/Multiplayer/IMultiplayerClient.cs b/osu.Game/Online/Multiplayer/IMultiplayerClient.cs
index 8f16d22c4c..3eafb31510 100644
--- a/osu.Game/Online/Multiplayer/IMultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/IMultiplayerClient.cs
@@ -106,5 +106,17 @@ namespace osu.Game.Online.Multiplayer
         /// Signals that the match has ended, all players have finished and results are ready to be displayed.
         /// </summary>
         Task ResultsReady();
+
+        /// <summary>
+        /// Signals that an item has been added to the playlist.
+        /// </summary>
+        /// <param name="item">The added item.</param>
+        Task PlaylistItemAdded(APIPlaylistItem item);
+
+        /// <summary>
+        /// Signals that an item has been removed from the playlist.
+        /// </summary>
+        /// <param name="item">The removed item.</param>
+        Task PlaylistItemRemoved(APIPlaylistItem item);
     }
 }
diff --git a/osu.Game/Online/Multiplayer/IMultiplayerRoomServer.cs b/osu.Game/Online/Multiplayer/IMultiplayerRoomServer.cs
index da637c229f..1f2e45b482 100644
--- a/osu.Game/Online/Multiplayer/IMultiplayerRoomServer.cs
+++ b/osu.Game/Online/Multiplayer/IMultiplayerRoomServer.cs
@@ -76,5 +76,17 @@ namespace osu.Game.Online.Multiplayer
         /// <exception cref="NotJoinedRoomException">If the user is not in a room.</exception>
         /// <exception cref="InvalidStateException">If an attempt to start the game occurs when the game's (or users') state disallows it.</exception>
         Task StartMatch();
+
+        /// <summary>
+        /// Adds an item to the playlist.
+        /// </summary>
+        /// <param name="item">The item to add.</param>
+        Task AddPlaylistItem(APIPlaylistItem item);
+
+        /// <summary>
+        /// Removes an item from the playlist.
+        /// </summary>
+        /// <param name="item">The item to remove.</param>
+        Task RemovePlaylistItem(APIPlaylistItem item);
     }
 }
diff --git a/osu.Game/Online/Multiplayer/MatchUserRequest.cs b/osu.Game/Online/Multiplayer/MatchUserRequest.cs
index 1656823b05..8c6809e7f3 100644
--- a/osu.Game/Online/Multiplayer/MatchUserRequest.cs
+++ b/osu.Game/Online/Multiplayer/MatchUserRequest.cs
@@ -4,7 +4,6 @@
 using System;
 using MessagePack;
 using osu.Game.Online.Multiplayer.MatchTypes.TeamVersus;
-using osu.Game.Online.Multiplayer.Queueing;
 
 namespace osu.Game.Online.Multiplayer
 {
@@ -14,7 +13,6 @@ namespace osu.Game.Online.Multiplayer
     [Serializable]
     [MessagePackObject]
     [Union(0, typeof(ChangeTeamRequest))] // IMPORTANT: Add rules to SignalRUnionWorkaroundResolver for new derived types.
-    [Union(1, typeof(EnqueuePlaylistItemRequest))]
     public abstract class MatchUserRequest
     {
     }
diff --git a/osu.Game/Online/Multiplayer/MultiplayerClient.cs b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
index eb581ad3fd..72ac13c2f2 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
@@ -301,6 +301,10 @@ namespace osu.Game.Online.Multiplayer
 
         public abstract Task StartMatch();
 
+        public abstract Task AddPlaylistItem(APIPlaylistItem item);
+
+        public abstract Task RemovePlaylistItem(APIPlaylistItem item);
+
         Task IMultiplayerClient.RoomStateChanged(MultiplayerRoomState state)
         {
             if (Room == null)
@@ -416,11 +420,7 @@ namespace osu.Game.Online.Multiplayer
             return Task.CompletedTask;
         }
 
-        Task IMultiplayerClient.SettingsChanged(MultiplayerRoomSettings newSettings)
-        {
-            updateLocalRoomSettings(newSettings);
-            return Task.CompletedTask;
-        }
+        Task IMultiplayerClient.SettingsChanged(MultiplayerRoomSettings newSettings) => updateLocalRoomSettings(newSettings);
 
         Task IMultiplayerClient.UserStateChanged(int userId, MultiplayerUserState state)
         {
@@ -572,6 +572,59 @@ namespace osu.Game.Online.Multiplayer
             return Task.CompletedTask;
         }
 
+        public async Task PlaylistItemAdded(APIPlaylistItem item)
+        {
+            if (Room == null)
+                return;
+
+            var set = await GetOnlineBeatmapSet(item.BeatmapID).ConfigureAwait(false);
+
+            var beatmap = set.Beatmaps.Single(b => b.OnlineBeatmapID == item.BeatmapID);
+            beatmap.MD5Hash = item.BeatmapChecksum;
+
+            var ruleset = Rulesets.GetRuleset(item.RulesetID);
+
+            await scheduleAsync(() =>
+            {
+                if (Room == null)
+                    return;
+
+                Debug.Assert(APIRoom != null);
+
+                var playlistItem = new PlaylistItem
+                {
+                    ID = item.ID,
+                    Beatmap = { Value = beatmap },
+                    Ruleset = { Value = ruleset },
+                };
+
+                var rulesetInstance = ruleset.CreateInstance();
+
+                playlistItem.RequiredMods.AddRange(item.RequiredMods.Select(m => m.ToMod(rulesetInstance)));
+                playlistItem.AllowedMods.AddRange(item.AllowedMods.Select(m => m.ToMod(rulesetInstance)));
+
+                APIRoom.Playlist.Add(playlistItem);
+                RoomUpdated?.Invoke();
+            }).ConfigureAwait(false);
+        }
+
+        public Task PlaylistItemRemoved(APIPlaylistItem item)
+        {
+            if (Room == null)
+                return Task.CompletedTask;
+
+            return scheduleAsync(() =>
+            {
+                if (Room == null)
+                    return;
+
+                Debug.Assert(APIRoom != null);
+
+                APIRoom.Playlist.RemoveAll(i => i.ID == item.ID);
+                RoomUpdated?.Invoke();
+            });
+        }
+
         /// <summary>
         /// Populates the <see cref="User"/> for a given <see cref="MultiplayerRoomUser"/>.
         /// </summary>
@@ -597,62 +650,11 @@ namespace osu.Game.Online.Multiplayer
             Room.Settings = settings;
             APIRoom.Name.Value = Room.Settings.Name;
             APIRoom.Password.Value = Room.Settings.Password;
-
-            // The current item update is delayed until an online beatmap lookup (below) succeeds.
-            // In-order for the client to not display an outdated beatmap, the current item is forcefully cleared here.
-            CurrentMatchPlayingItem.Value = null;
-
             RoomUpdated?.Invoke();
 
-            GetOnlineBeatmapSet(settings.BeatmapID, cancellationToken).ContinueWith(set => Schedule(() =>
-            {
-                if (cancellationToken.IsCancellationRequested)
-                    return;
-
-                updatePlaylist(settings, set.Result);
-            }), TaskContinuationOptions.OnlyOnRanToCompletion);
+            CurrentMatchPlayingItem.Value = APIRoom.Playlist.SingleOrDefault(p => p.ID == settings.PlaylistItemId);
         }, cancellationToken);
 
-        private void updatePlaylist(MultiplayerRoomSettings settings, BeatmapSetInfo beatmapSet)
-        {
-            if (Room == null || !Room.Settings.Equals(settings))
-                return;
-
-            Debug.Assert(APIRoom != null);
-
-            var beatmap = beatmapSet.Beatmaps.Single(b => b.OnlineBeatmapID == settings.BeatmapID);
-            beatmap.MD5Hash = settings.BeatmapChecksum;
-
-            var ruleset = Rulesets.GetRuleset(settings.RulesetID).CreateInstance();
-            var mods = settings.RequiredMods.Select(m => m.ToMod(ruleset));
-            var allowedMods = settings.AllowedMods.Select(m => m.ToMod(ruleset));
-
-            // Try to retrieve the existing playlist item from the API room.
-            var playlistItem = APIRoom.Playlist.FirstOrDefault(i => i.ID == settings.PlaylistItemId);
-
-            if (playlistItem != null)
-                updateItem(playlistItem);
-            else
-            {
-                // An existing playlist item does not exist, so append a new one.
-                updateItem(playlistItem = new PlaylistItem());
-                APIRoom.Playlist.Add(playlistItem);
-            }
-
-            CurrentMatchPlayingItem.Value = playlistItem;
-
-            void updateItem(PlaylistItem item)
-            {
-                item.ID = settings.PlaylistItemId;
-                item.Beatmap.Value = beatmap;
-                item.Ruleset.Value = ruleset.RulesetInfo;
-                item.RequiredMods.Clear();
-                item.RequiredMods.AddRange(mods);
-                item.AllowedMods.Clear();
-                item.AllowedMods.AddRange(allowedMods);
-            }
-        }
-
         /// <summary>
         /// Retrieves a <see cref="BeatmapSetInfo"/> from an online source.
         /// </summary>
diff --git a/osu.Game/Online/Multiplayer/MultiplayerRoomSettings.cs b/osu.Game/Online/Multiplayer/MultiplayerRoomSettings.cs
index 91042d3a08..70e884dcce 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerRoomSettings.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerRoomSettings.cs
@@ -4,10 +4,7 @@
 #nullable enable
 
 using System;
-using System.Collections.Generic;
-using System.Linq;
 using MessagePack;
-using osu.Game.Online.API;
 using osu.Game.Online.Multiplayer.Queueing;
 using osu.Game.Online.Rooms;
 
@@ -18,53 +15,29 @@ namespace osu.Game.Online.Multiplayer
     public class MultiplayerRoomSettings : IEquatable<MultiplayerRoomSettings>
     {
         [Key(0)]
-        public int BeatmapID { get; set; }
-
-        [Key(1)]
-        public int RulesetID { get; set; }
-
-        [Key(2)]
-        public string BeatmapChecksum { get; set; } = string.Empty;
-
-        [Key(3)]
         public string Name { get; set; } = "Unnamed room";
 
-        [Key(4)]
-        public IEnumerable<APIMod> RequiredMods { get; set; } = Enumerable.Empty<APIMod>();
-
-        [Key(5)]
-        public IEnumerable<APIMod> AllowedMods { get; set; } = Enumerable.Empty<APIMod>();
-
-        [Key(6)]
+        [Key(1)]
         public long PlaylistItemId { get; set; }
 
-        [Key(7)]
+        [Key(2)]
         public string Password { get; set; } = string.Empty;
 
-        [Key(8)]
+        [Key(3)]
         public MatchType MatchType { get; set; } = MatchType.HeadToHead;
 
-        [Key(9)]
+        [Key(4)]
         public QueueModes QueueMode { get; set; } = QueueModes.HostOnly;
 
         public bool Equals(MultiplayerRoomSettings other)
-            => BeatmapID == other.BeatmapID
-               && BeatmapChecksum == other.BeatmapChecksum
-               && RequiredMods.SequenceEqual(other.RequiredMods)
-               && AllowedMods.SequenceEqual(other.AllowedMods)
-               && RulesetID == other.RulesetID
-               && Password.Equals(other.Password, StringComparison.Ordinal)
+            => Password.Equals(other.Password, StringComparison.Ordinal)
                && Name.Equals(other.Name, StringComparison.Ordinal)
                && PlaylistItemId == other.PlaylistItemId
                && MatchType == other.MatchType
                && QueueMode == other.QueueMode;
 
         public override string ToString() => $"Name:{Name}"
-                                             + $" Beatmap:{BeatmapID} ({BeatmapChecksum})"
-                                             + $" RequiredMods:{string.Join(',', RequiredMods)}"
-                                             + $" AllowedMods:{string.Join(',', AllowedMods)}"
                                              + $" Password:{(string.IsNullOrEmpty(Password) ? "no" : "yes")}"
-                                             + $" Ruleset:{RulesetID}"
                                              + $" Type:{MatchType}"
                                              + $" Item:{PlaylistItemId}"
                                              + $" Queue:{QueueMode}";
diff --git a/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs b/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs
index 965674c2f2..fd57b42000 100644
--- a/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs
@@ -62,6 +62,8 @@ namespace osu.Game.Online.Multiplayer
                     connection.On<MatchRoomState>(nameof(IMultiplayerClient.MatchRoomStateChanged), ((IMultiplayerClient)this).MatchRoomStateChanged);
                     connection.On<int, MatchUserState>(nameof(IMultiplayerClient.MatchUserStateChanged), ((IMultiplayerClient)this).MatchUserStateChanged);
                     connection.On<MatchServerEvent>(nameof(IMultiplayerClient.MatchEvent), ((IMultiplayerClient)this).MatchEvent);
+                    connection.On<APIPlaylistItem>(nameof(IMultiplayerClient.PlaylistItemAdded), ((IMultiplayerClient)this).PlaylistItemAdded);
+                    connection.On<APIPlaylistItem>(nameof(IMultiplayerClient.PlaylistItemRemoved), ((IMultiplayerClient)this).PlaylistItemRemoved);
                 };
 
                 IsConnected.BindTo(connector.IsConnected);
@@ -148,6 +150,22 @@ namespace osu.Game.Online.Multiplayer
             return connection.InvokeAsync(nameof(IMultiplayerServer.StartMatch));
         }
 
+        public override Task AddPlaylistItem(APIPlaylistItem item)
+        {
+            if (!IsConnected.Value)
+                return Task.CompletedTask;
+
+            return connection.InvokeAsync(nameof(IMultiplayerServer.AddPlaylistItem), item);
+        }
+
+        public override Task RemovePlaylistItem(APIPlaylistItem item)
+        {
+            if (!IsConnected.Value)
+                return Task.CompletedTask;
+
+            return connection.InvokeAsync(nameof(IMultiplayerServer.RemovePlaylistItem), item);
+        }
+
         protected override Task<BeatmapSetInfo> GetOnlineBeatmapSet(int beatmapId, CancellationToken cancellationToken = default)
         {
             var tcs = new TaskCompletionSource<BeatmapSetInfo>();
diff --git a/osu.Game/Online/Multiplayer/Queueing/EnqueuePlaylistItemRequest.cs b/osu.Game/Online/Rooms/APIPlaylistItem.cs
similarity index 54%
rename from osu.Game/Online/Multiplayer/Queueing/EnqueuePlaylistItemRequest.cs
rename to osu.Game/Online/Rooms/APIPlaylistItem.cs
index 4c66311f68..121d661c65 100644
--- a/osu.Game/Online/Multiplayer/Queueing/EnqueuePlaylistItemRequest.cs
+++ b/osu.Game/Online/Rooms/APIPlaylistItem.cs
@@ -8,23 +8,40 @@ using System.Linq;
 using MessagePack;
 using osu.Game.Online.API;
 
-namespace osu.Game.Online.Multiplayer.Queueing
+namespace osu.Game.Online.Rooms
 {
-    public class EnqueuePlaylistItemRequest : MatchUserRequest
+    public class APIPlaylistItem
     {
         [Key(0)]
-        public int BeatmapID { get; set; }
+        public long ID { get; set; }
 
         [Key(1)]
-        public int RulesetID { get; set; }
+        public int BeatmapID { get; set; }
 
         [Key(2)]
         public string BeatmapChecksum { get; set; } = string.Empty;
 
         [Key(3)]
-        public IEnumerable<APIMod> RequiredMods { get; set; } = Enumerable.Empty<APIMod>();
+        public int RulesetID { get; set; }
 
         [Key(4)]
+        public IEnumerable<APIMod> RequiredMods { get; set; } = Enumerable.Empty<APIMod>();
+
+        [Key(5)]
         public IEnumerable<APIMod> AllowedMods { get; set; } = Enumerable.Empty<APIMod>();
+
+        public APIPlaylistItem()
+        {
+        }
+
+        public APIPlaylistItem(PlaylistItem item)
+        {
+            ID = item.ID;
+            BeatmapID = item.BeatmapID;
+            BeatmapChecksum = item.Beatmap.Value?.MD5Hash ?? string.Empty;
+            RulesetID = item.RulesetID;
+            RequiredMods = item.RequiredMods.Select(m => new APIMod(m)).ToArray();
+            AllowedMods = item.AllowedMods.Select(m => new APIMod(m)).ToArray();
+        }
     }
 }
diff --git a/osu.Game/Online/SignalRUnionWorkaroundResolver.cs b/osu.Game/Online/SignalRUnionWorkaroundResolver.cs
index ab393eadfe..e44da044cc 100644
--- a/osu.Game/Online/SignalRUnionWorkaroundResolver.cs
+++ b/osu.Game/Online/SignalRUnionWorkaroundResolver.cs
@@ -8,7 +8,6 @@ using MessagePack.Formatters;
 using MessagePack.Resolvers;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Multiplayer.MatchTypes.TeamVersus;
-using osu.Game.Online.Multiplayer.Queueing;
 
 namespace osu.Game.Online
 {
@@ -26,7 +25,6 @@ namespace osu.Game.Online
             { typeof(TeamVersusUserState), new TypeRedirectingFormatter<TeamVersusUserState, MatchUserState>() },
             { typeof(TeamVersusRoomState), new TypeRedirectingFormatter<TeamVersusRoomState, MatchRoomState>() },
             { typeof(ChangeTeamRequest), new TypeRedirectingFormatter<ChangeTeamRequest, MatchUserRequest>() },
-            { typeof(EnqueuePlaylistItemRequest), new TypeRedirectingFormatter<EnqueuePlaylistItemRequest, MatchUserRequest>() },
 
             // These should not be required. The fallback should work. But something is weird with the way caching is done.
             // For future adventurers, I would not advise looking into this further. It's likely not worth the effort.
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs
index eb5252b3e0..df1e0c1fc2 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs
@@ -9,7 +9,6 @@ using osu.Game.Beatmaps;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Online.API;
 using osu.Game.Online.Multiplayer;
-using osu.Game.Online.Multiplayer.Queueing;
 using osu.Game.Online.Rooms;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Mods;
@@ -57,11 +56,10 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
             {
                 loadingLayer.Show();
 
-                client.SendMatchRequest(new EnqueuePlaylistItemRequest
+                client.AddPlaylistItem(new APIPlaylistItem
                 {
                     BeatmapID = item.BeatmapID,
                     RulesetID = item.RulesetID,
-                    BeatmapChecksum = item.Beatmap.Value.MD5Hash,
                     RequiredMods = item.RequiredMods.Select(m => new APIMod(m)).ToArray(),
                     AllowedMods = item.AllowedMods.Select(m => new APIMod(m)).ToArray()
                 }).ContinueWith(t =>
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantPanel.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantPanel.cs
index 79e305b765..96213f1444 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantPanel.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantPanel.cs
@@ -184,7 +184,8 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Participants
 
             const double fade_time = 50;
 
-            var ruleset = rulesets.GetRuleset(Room.Settings.RulesetID).CreateInstance();
+            // Todo: FIX THIS
+            var ruleset = rulesets.GetRuleset(0).CreateInstance();
 
             var currentModeRank = User.User?.RulesetsStatistics?.GetValueOrDefault(ruleset.ShortName)?.GlobalRank;
             userRankText.Text = currentModeRank != null ? $"#{currentModeRank.Value:N0}" : string.Empty;
diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
index 5e4e5942d9..7606f6c456 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
@@ -15,6 +15,7 @@ using osu.Game.Beatmaps;
 using osu.Game.Online.API;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Multiplayer.MatchTypes.TeamVersus;
+using osu.Game.Online.Multiplayer.Queueing;
 using osu.Game.Online.Rooms;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Users;
@@ -41,6 +42,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
         private readonly TestRequestHandlingMultiplayerRoomManager roomManager;
 
+        private long lastPlaylistItemId;
+
         public TestMultiplayerClient(TestRequestHandlingMultiplayerRoomManager roomManager)
         {
             this.roomManager = roomManager;
@@ -141,6 +144,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
             if (password != apiRoom.Password.Value)
                 throw new InvalidOperationException("Invalid password.");
 
+            lastPlaylistItemId = apiRoom.Playlist.Last().ID;
+
             var localUser = new MultiplayerRoomUser(api.LocalUser.Value.Id)
             {
                 User = api.LocalUser.Value
@@ -152,12 +157,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 {
                     Name = apiRoom.Name.Value,
                     MatchType = apiRoom.Type.Value,
-                    BeatmapID = apiRoom.Playlist.Last().BeatmapID,
-                    RulesetID = apiRoom.Playlist.Last().RulesetID,
-                    BeatmapChecksum = apiRoom.Playlist.Last().Beatmap.Value.MD5Hash,
-                    RequiredMods = apiRoom.Playlist.Last().RequiredMods.Select(m => new APIMod(m)).ToArray(),
-                    AllowedMods = apiRoom.Playlist.Last().AllowedMods.Select(m => new APIMod(m)).ToArray(),
-                    PlaylistItemId = apiRoom.Playlist.Last().ID,
+                    PlaylistItemId = lastPlaylistItemId,
                     // ReSharper disable once ConstantNullCoalescingCondition Incorrect inspection due to lack of nullable in Room.cs.
                     Password = password ?? string.Empty,
                 },
@@ -265,6 +265,49 @@ namespace osu.Game.Tests.Visual.Multiplayer
             return ((IMultiplayerClient)this).LoadRequested();
         }
 
+        public override async Task AddPlaylistItem(APIPlaylistItem item)
+        {
+            Debug.Assert(Room != null);
+            Debug.Assert(APIRoom != null);
+
+            item.ID = lastPlaylistItemId + 1;
+
+            switch (Room.Settings.QueueMode)
+            {
+                case QueueModes.HostOnly:
+                    if (Room.Host?.UserID != LocalUser?.UserID)
+                        throw new InvalidOperationException("Local user is not the room host.");
+
+                    await RemovePlaylistItem(new APIPlaylistItem(APIRoom.Playlist.Single(i => i.ID == lastPlaylistItemId))).ConfigureAwait(false);
+                    await ((IMultiplayerClient)this).PlaylistItemAdded(item).ConfigureAwait(false);
+
+                    Room.Settings.PlaylistItemId = item.ID;
+                    await ChangeSettings(Room.Settings).ConfigureAwait(false);
+                    break;
+
+                case QueueModes.FreeForAll:
+                    await ((IMultiplayerClient)this).PlaylistItemAdded(item).ConfigureAwait(false);
+                    // Todo: Advance if the added item is the last non-expired one.
+                    break;
+
+                case QueueModes.FairRotate:
+                    // Todo: Not implemented.
+                    throw new NotImplementedException();
+            }
+
+            lastPlaylistItemId = item.ID;
+        }
+
+        public override Task RemovePlaylistItem(APIPlaylistItem item)
+        {
+            Debug.Assert(Room != null);
+
+            if (Room.Host?.UserID != LocalUser?.UserID)
+                throw new InvalidOperationException("Local user is not the room host.");
+
+            return ((IMultiplayerClient)this).PlaylistItemRemoved(item);
+        }
+
         protected override Task<BeatmapSetInfo> GetOnlineBeatmapSet(int beatmapId, CancellationToken cancellationToken = default)
         {
             Debug.Assert(Room != null);

From 91cc77407d3ee9e2c03b108217fc90bc5aa2ae26 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 22 Oct 2021 17:02:02 +0900
Subject: [PATCH 0398/5547] Fix low-pass filter continuing to take effect after
 fail animation has already ended

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

diff --git a/osu.Game/Screens/Play/FailAnimation.cs b/osu.Game/Screens/Play/FailAnimation.cs
index 242d997dd7..edfb8186bb 100644
--- a/osu.Game/Screens/Play/FailAnimation.cs
+++ b/osu.Game/Screens/Play/FailAnimation.cs
@@ -106,6 +106,7 @@ namespace osu.Game.Screens.Play
 
             this.TransformBindableTo(trackFreq, 0, duration).OnComplete(_ =>
             {
+                RemoveFilters();
                 OnComplete?.Invoke();
             });
 
@@ -137,6 +138,9 @@ namespace osu.Game.Screens.Play
 
         public void RemoveFilters()
         {
+            if (filters.Parent == null)
+                return;
+
             RemoveInternal(filters);
             filters.Dispose();
 

From cc1d759290552e87cd3452f82290c68718aa5141 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 22 Oct 2021 17:48:09 +0900
Subject: [PATCH 0399/5547] Remove unnecessary setters from
 `IBeatmapSetOnlineInfo` interface

---
 osu.Game/Beatmaps/BeatmapSetInfo.cs        | 96 ++++------------------
 osu.Game/Beatmaps/IBeatmapSetOnlineInfo.cs | 34 ++++----
 2 files changed, 33 insertions(+), 97 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapSetInfo.cs b/osu.Game/Beatmaps/BeatmapSetInfo.cs
index c3e2399d53..79cd8253f7 100644
--- a/osu.Game/Beatmaps/BeatmapSetInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapSetInfo.cs
@@ -107,27 +107,15 @@ namespace osu.Game.Beatmaps
 
         [NotMapped]
         [JsonIgnore]
-        public DateTimeOffset Submitted
-        {
-            get => OnlineInfo.Submitted;
-            set => OnlineInfo.Submitted = value;
-        }
+        public DateTimeOffset Submitted => OnlineInfo.Submitted;
 
         [NotMapped]
         [JsonIgnore]
-        public DateTimeOffset? Ranked
-        {
-            get => OnlineInfo.Ranked;
-            set => OnlineInfo.Ranked = value;
-        }
+        public DateTimeOffset? Ranked => OnlineInfo.Ranked;
 
         [NotMapped]
         [JsonIgnore]
-        public DateTimeOffset? LastUpdated
-        {
-            get => OnlineInfo.LastUpdated;
-            set => OnlineInfo.LastUpdated = value;
-        }
+        public DateTimeOffset? LastUpdated => OnlineInfo.LastUpdated;
 
         [NotMapped]
         [JsonIgnore]
@@ -135,107 +123,55 @@ namespace osu.Game.Beatmaps
 
         [NotMapped]
         [JsonIgnore]
-        public bool HasExplicitContent
-        {
-            get => OnlineInfo.HasExplicitContent;
-            set => OnlineInfo.HasExplicitContent = value;
-        }
+        public bool HasExplicitContent => OnlineInfo.HasExplicitContent;
 
         [NotMapped]
         [JsonIgnore]
-        public bool HasVideo
-        {
-            get => OnlineInfo.HasVideo;
-            set => OnlineInfo.HasVideo = value;
-        }
+        public bool HasVideo => OnlineInfo.HasVideo;
 
         [NotMapped]
         [JsonIgnore]
-        public bool HasStoryboard
-        {
-            get => OnlineInfo.HasStoryboard;
-            set => OnlineInfo.HasStoryboard = value;
-        }
+        public bool HasStoryboard => OnlineInfo.HasStoryboard;
 
         [NotMapped]
         [JsonIgnore]
-        public BeatmapSetOnlineCovers Covers
-        {
-            get => OnlineInfo.Covers;
-            set => OnlineInfo.Covers = value;
-        }
+        public BeatmapSetOnlineCovers Covers => OnlineInfo.Covers;
 
         [NotMapped]
         [JsonIgnore]
-        public string Preview
-        {
-            get => OnlineInfo.Preview;
-            set => OnlineInfo.Preview = value;
-        }
+        public string Preview => OnlineInfo.Preview;
 
         [NotMapped]
         [JsonIgnore]
-        public double BPM
-        {
-            get => OnlineInfo.BPM;
-            set => OnlineInfo.BPM = value;
-        }
+        public double BPM => OnlineInfo.BPM;
 
         [NotMapped]
         [JsonIgnore]
-        public int PlayCount
-        {
-            get => OnlineInfo.PlayCount;
-            set => OnlineInfo.PlayCount = value;
-        }
+        public int PlayCount => OnlineInfo.PlayCount;
 
         [NotMapped]
         [JsonIgnore]
-        public int FavouriteCount
-        {
-            get => OnlineInfo.FavouriteCount;
-            set => OnlineInfo.FavouriteCount = value;
-        }
+        public int FavouriteCount => OnlineInfo.FavouriteCount;
 
         [NotMapped]
         [JsonIgnore]
-        public bool HasFavourited
-        {
-            get => OnlineInfo.HasFavourited;
-            set => OnlineInfo.HasFavourited = value;
-        }
+        public bool HasFavourited => OnlineInfo.HasFavourited;
 
         [NotMapped]
         [JsonIgnore]
-        public BeatmapSetOnlineAvailability Availability
-        {
-            get => OnlineInfo.Availability;
-            set => OnlineInfo.Availability = value;
-        }
+        public BeatmapSetOnlineAvailability Availability => OnlineInfo.Availability;
 
         [NotMapped]
         [JsonIgnore]
-        public BeatmapSetOnlineGenre Genre
-        {
-            get => OnlineInfo.Genre;
-            set => OnlineInfo.Genre = value;
-        }
+        public BeatmapSetOnlineGenre Genre => OnlineInfo.Genre;
 
         [NotMapped]
         [JsonIgnore]
-        public BeatmapSetOnlineLanguage Language
-        {
-            get => OnlineInfo.Language;
-            set => OnlineInfo.Language = value;
-        }
+        public BeatmapSetOnlineLanguage Language => OnlineInfo.Language;
 
         [NotMapped]
         [JsonIgnore]
-        public int? TrackId
-        {
-            get => OnlineInfo.TrackId;
-            set => OnlineInfo.TrackId = value;
-        }
+        public int? TrackId => OnlineInfo?.TrackId;
 
         #endregion
     }
diff --git a/osu.Game/Beatmaps/IBeatmapSetOnlineInfo.cs b/osu.Game/Beatmaps/IBeatmapSetOnlineInfo.cs
index b9800bc2e6..1d2bb46bde 100644
--- a/osu.Game/Beatmaps/IBeatmapSetOnlineInfo.cs
+++ b/osu.Game/Beatmaps/IBeatmapSetOnlineInfo.cs
@@ -15,87 +15,87 @@ namespace osu.Game.Beatmaps
         /// <summary>
         /// The date this beatmap set was submitted to the online listing.
         /// </summary>
-        DateTimeOffset Submitted { get; set; }
+        DateTimeOffset Submitted { get; }
 
         /// <summary>
         /// The date this beatmap set was ranked.
         /// </summary>
-        DateTimeOffset? Ranked { get; set; }
+        DateTimeOffset? Ranked { get; }
 
         /// <summary>
         /// The date this beatmap set was last updated.
         /// </summary>
-        DateTimeOffset? LastUpdated { get; set; }
+        DateTimeOffset? LastUpdated { get; }
 
         /// <summary>
         /// The status of this beatmap set.
         /// </summary>
-        BeatmapSetOnlineStatus Status { get; set; }
+        BeatmapSetOnlineStatus Status { get; }
 
         /// <summary>
         /// Whether or not this beatmap set has explicit content.
         /// </summary>
-        bool HasExplicitContent { get; set; }
+        bool HasExplicitContent { get; }
 
         /// <summary>
         /// Whether or not this beatmap set has a background video.
         /// </summary>
-        bool HasVideo { get; set; }
+        bool HasVideo { get; }
 
         /// <summary>
         /// Whether or not this beatmap set has a storyboard.
         /// </summary>
-        bool HasStoryboard { get; set; }
+        bool HasStoryboard { get; }
 
         /// <summary>
         /// The different sizes of cover art for this beatmap set.
         /// </summary>
-        BeatmapSetOnlineCovers Covers { get; set; }
+        BeatmapSetOnlineCovers Covers { get; }
 
         /// <summary>
         /// A small sample clip of this beatmap set's song.
         /// </summary>
-        string Preview { get; set; }
+        string Preview { get; }
 
         /// <summary>
         /// The beats per minute of this beatmap set's song.
         /// </summary>
-        double BPM { get; set; }
+        double BPM { get; }
 
         /// <summary>
         /// The amount of plays this beatmap set has.
         /// </summary>
-        int PlayCount { get; set; }
+        int PlayCount { get; }
 
         /// <summary>
         /// The amount of people who have favourited this beatmap set.
         /// </summary>
-        int FavouriteCount { get; set; }
+        int FavouriteCount { get; }
 
         /// <summary>
         /// Whether this beatmap set has been favourited by the current user.
         /// </summary>
-        bool HasFavourited { get; set; }
+        bool HasFavourited { get; }
 
         /// <summary>
         /// The availability of this beatmap set.
         /// </summary>
-        BeatmapSetOnlineAvailability Availability { get; set; }
+        BeatmapSetOnlineAvailability Availability { get; }
 
         /// <summary>
         /// The song genre of this beatmap set.
         /// </summary>
-        BeatmapSetOnlineGenre Genre { get; set; }
+        BeatmapSetOnlineGenre Genre { get; }
 
         /// <summary>
         /// The song language of this beatmap set.
         /// </summary>
-        BeatmapSetOnlineLanguage Language { get; set; }
+        BeatmapSetOnlineLanguage Language { get; }
 
         /// <summary>
         /// The track ID of this beatmap set.
         /// Non-null only if the track is linked to a featured artist track entry.
         /// </summary>
-        int? TrackId { get; set; }
+        int? TrackId { get; }
     }
 }

From 90477e3788fdeccc88e5181ce7f2851cbebca609 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 22 Oct 2021 19:12:37 +0900
Subject: [PATCH 0400/5547] Remove unused `BeatmapTypeInfo` class

Helps reduce the scope of upcoming changes.
---
 .../OnlinePlay/Components/BeatmapTypeInfo.cs  | 72 -------------------
 1 file changed, 72 deletions(-)
 delete mode 100644 osu.Game/Screens/OnlinePlay/Components/BeatmapTypeInfo.cs

diff --git a/osu.Game/Screens/OnlinePlay/Components/BeatmapTypeInfo.cs b/osu.Game/Screens/OnlinePlay/Components/BeatmapTypeInfo.cs
deleted file mode 100644
index 3aa13458a4..0000000000
--- a/osu.Game/Screens/OnlinePlay/Components/BeatmapTypeInfo.cs
+++ /dev/null
@@ -1,72 +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.Linq;
-using osu.Framework.Allocation;
-using osu.Framework.Graphics;
-using osu.Framework.Graphics.Containers;
-using osu.Game.Graphics;
-using osu.Game.Graphics.Containers;
-using osuTK;
-
-namespace osu.Game.Screens.OnlinePlay.Components
-{
-    public class BeatmapTypeInfo : OnlinePlayComposite
-    {
-        private LinkFlowContainer beatmapAuthor;
-
-        public BeatmapTypeInfo()
-        {
-            AutoSizeAxes = Axes.Both;
-        }
-
-        [BackgroundDependencyLoader]
-        private void load()
-        {
-            InternalChild = new FillFlowContainer
-            {
-                AutoSizeAxes = Axes.Both,
-                Direction = FillDirection.Horizontal,
-                LayoutDuration = 100,
-                Spacing = new Vector2(5, 0),
-                Children = new Drawable[]
-                {
-                    new ModeTypeInfo(),
-                    new Container
-                    {
-                        AutoSizeAxes = Axes.X,
-                        Height = 30,
-                        Margin = new MarginPadding { Left = 5 },
-                        Children = new Drawable[]
-                        {
-                            new BeatmapTitle(),
-                            beatmapAuthor = new LinkFlowContainer(s => s.Font = s.Font.With(size: 14))
-                            {
-                                Anchor = Anchor.BottomLeft,
-                                Origin = Anchor.BottomLeft,
-                                AutoSizeAxes = Axes.Both
-                            },
-                        },
-                    },
-                }
-            };
-
-            Playlist.CollectionChanged += (_, __) => updateInfo();
-
-            updateInfo();
-        }
-
-        private void updateInfo()
-        {
-            beatmapAuthor.Clear();
-
-            var beatmap = Playlist.FirstOrDefault()?.Beatmap;
-
-            if (beatmap != null)
-            {
-                beatmapAuthor.AddText("mapped by ", s => s.Colour = OsuColour.Gray(0.8f));
-                beatmapAuthor.AddUserLink(beatmap.Value.Metadata.Author);
-            }
-        }
-    }
-}

From 95ab82fb5808f93ec5841556e9c516fb728d2572 Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Fri, 22 Oct 2021 19:41:36 +0900
Subject: [PATCH 0401/5547] Remove BeatmapSelectionControl and inline at usage
 sites

---
 .../OnlinePlay/DrawableRoomPlaylistItem.cs    |  4 +-
 .../Match/BeatmapSelectionControl.cs          | 87 -------------------
 .../Match/MultiplayerMatchSettingsOverlay.cs  | 40 +++++++--
 .../Multiplayer/MultiplayerMatchSubScreen.cs  | 54 +++++++++++-
 4 files changed, 89 insertions(+), 96 deletions(-)
 delete mode 100644 osu.Game/Screens/OnlinePlay/Multiplayer/Match/BeatmapSelectionControl.cs

diff --git a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
index 585b024623..9fee739048 100644
--- a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
+++ b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
@@ -34,6 +34,8 @@ namespace osu.Game.Screens.OnlinePlay
 {
     public class DrawableRoomPlaylistItem : OsuRearrangeableListItem<PlaylistItem>
     {
+        public const float HEIGHT = 50;
+
         public Action<PlaylistItem> RequestDeletion;
 
         public readonly Bindable<PlaylistItem> SelectedItem = new Bindable<PlaylistItem>();
@@ -135,7 +137,7 @@ namespace osu.Game.Screens.OnlinePlay
             return maskingContainer = new Container
             {
                 RelativeSizeAxes = Axes.X,
-                Height = 50,
+                Height = HEIGHT,
                 Masking = true,
                 CornerRadius = 10,
                 Children = new Drawable[]
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/BeatmapSelectionControl.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/BeatmapSelectionControl.cs
deleted file mode 100644
index 35f30edf65..0000000000
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/BeatmapSelectionControl.cs
+++ /dev/null
@@ -1,87 +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.Graphics;
-using osu.Framework.Graphics.Containers;
-using osu.Framework.Graphics.UserInterface;
-using osu.Framework.Screens;
-using osu.Game.Online.API;
-using osu.Game.Screens.OnlinePlay.Match.Components;
-using osuTK;
-
-namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
-{
-    public class BeatmapSelectionControl : OnlinePlayComposite
-    {
-        [Resolved]
-        private MultiplayerMatchSubScreen matchSubScreen { get; set; }
-
-        [Resolved]
-        private IAPIProvider api { get; set; }
-
-        private Container beatmapPanelContainer;
-        private Button selectButton;
-
-        public BeatmapSelectionControl()
-        {
-            AutoSizeAxes = Axes.Y;
-        }
-
-        [BackgroundDependencyLoader]
-        private void load()
-        {
-            InternalChild = new FillFlowContainer
-            {
-                RelativeSizeAxes = Axes.X,
-                AutoSizeAxes = Axes.Y,
-                Direction = FillDirection.Vertical,
-                Spacing = new Vector2(5),
-                Children = new Drawable[]
-                {
-                    beatmapPanelContainer = new Container
-                    {
-                        RelativeSizeAxes = Axes.X,
-                        AutoSizeAxes = Axes.Y
-                    },
-                    selectButton = new PurpleTriangleButton
-                    {
-                        RelativeSizeAxes = Axes.X,
-                        Height = 40,
-                        Text = "Select beatmap",
-                        Action = () =>
-                        {
-                            if (matchSubScreen.IsCurrentScreen())
-                                matchSubScreen.Push(new MultiplayerMatchSongSelect(matchSubScreen.Room));
-                        },
-                        Alpha = 0
-                    }
-                }
-            };
-        }
-
-        protected override void LoadComplete()
-        {
-            base.LoadComplete();
-
-            SelectedItem.BindValueChanged(_ => updateBeatmap(), true);
-            Host.BindValueChanged(host =>
-            {
-                if (RoomID.Value == null || host.NewValue?.Equals(api.LocalUser.Value) == true)
-                    selectButton.Show();
-                else
-                    selectButton.Hide();
-            }, true);
-        }
-
-        public void BeginSelection() => selectButton.TriggerClick();
-
-        private void updateBeatmap()
-        {
-            if (SelectedItem.Value == null)
-                beatmapPanelContainer.Clear();
-            else
-                beatmapPanelContainer.Child = new DrawableRoomPlaylistItem(SelectedItem.Value, false, false);
-        }
-    }
-}
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs
index 4231aeae87..b5079fd2f2 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs
@@ -11,6 +11,7 @@ using osu.Framework.Extensions.ExceptionExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
+using osu.Framework.Screens;
 using osu.Game.Beatmaps;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
@@ -68,9 +69,15 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
 
             private OsuSpriteText typeLabel;
             private LoadingLayer loadingLayer;
-            private BeatmapSelectionControl initialBeatmapControl;
 
-            public void SelectBeatmap() => initialBeatmapControl.BeginSelection();
+            public void SelectBeatmap()
+            {
+                if (matchSubScreen.IsCurrentScreen())
+                    matchSubScreen.Push(new MultiplayerMatchSongSelect(matchSubScreen.Room));
+            }
+
+            [Resolved]
+            private MultiplayerMatchSubScreen matchSubScreen { get; set; }
 
             [Resolved]
             private IRoomManager manager { get; set; }
@@ -94,6 +101,8 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
 
             private readonly Room room;
 
+            private Drawable playlistContainer;
+
             public MatchSettings(Room room)
             {
                 this.room = room;
@@ -137,7 +146,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
                                             AutoSizeAxes = Axes.Y,
                                             Direction = FillDirection.Vertical,
                                             Spacing = new Vector2(0, 10),
-                                            Children = new Drawable[]
+                                            Children = new[]
                                             {
                                                 new Container
                                                 {
@@ -236,13 +245,32 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
                                                         }
                                                     },
                                                 },
-                                                initialBeatmapControl = new BeatmapSelectionControl
+                                                playlistContainer = new FillFlowContainer
                                                 {
                                                     Anchor = Anchor.TopCentre,
                                                     Origin = Anchor.TopCentre,
                                                     RelativeSizeAxes = Axes.X,
+                                                    AutoSizeAxes = Axes.Y,
                                                     Width = 0.5f,
-                                                    Depth = float.MaxValue
+                                                    Depth = float.MaxValue,
+                                                    Spacing = new Vector2(5),
+                                                    Children = new Drawable[]
+                                                    {
+                                                        new DrawableRoomPlaylist(false, false)
+                                                        {
+                                                            RelativeSizeAxes = Axes.X,
+                                                            Height = DrawableRoomPlaylistItem.HEIGHT,
+                                                            Items = { BindTarget = Playlist },
+                                                            SelectedItem = { BindTarget = SelectedItem }
+                                                        },
+                                                        new PurpleTriangleButton
+                                                        {
+                                                            RelativeSizeAxes = Axes.X,
+                                                            Height = 40,
+                                                            Text = "Select beatmap",
+                                                            Action = SelectBeatmap
+                                                        }
+                                                    }
                                                 }
                                             }
                                         }
@@ -306,7 +334,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
                 Availability.BindValueChanged(availability => AvailabilityPicker.Current.Value = availability.NewValue, true);
                 Type.BindValueChanged(type => TypePicker.Current.Value = type.NewValue, true);
                 MaxParticipants.BindValueChanged(count => MaxParticipantsField.Text = count.NewValue?.ToString(), true);
-                RoomID.BindValueChanged(roomId => initialBeatmapControl.Alpha = roomId.NewValue == null ? 1 : 0, true);
+                RoomID.BindValueChanged(roomId => playlistContainer.Alpha = roomId.NewValue == null ? 1 : 0, true);
                 Password.BindValueChanged(password => PasswordTextBox.Text = password.NewValue ?? string.Empty, true);
 
                 operationInProgress.BindTo(ongoingOperationTracker.InProgress);
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
index 33df9fe2fa..ba6d3f354a 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
@@ -14,8 +14,10 @@ using osu.Framework.Screens;
 using osu.Framework.Threading;
 using osu.Game.Beatmaps;
 using osu.Game.Configuration;
+using osu.Game.Graphics.UserInterface;
 using osu.Game.Online;
 using osu.Game.Online.Multiplayer;
+using osu.Game.Online.Multiplayer.Queueing;
 using osu.Game.Online.Rooms;
 using osu.Game.Overlays;
 using osu.Game.Overlays.Dialog;
@@ -53,6 +55,8 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
         [CanBeNull]
         private IDisposable readyClickOperation;
 
+        private OsuButton addOrEditPlaylistButton;
+
         public MultiplayerMatchSubScreen(Room room)
             : base(room)
         {
@@ -128,7 +132,35 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
                             Content = new[]
                             {
                                 new Drawable[] { new OverlinedHeader("Beatmap") },
-                                new Drawable[] { new BeatmapSelectionControl { RelativeSizeAxes = Axes.X } },
+                                new Drawable[]
+                                {
+                                    new FillFlowContainer
+                                    {
+                                        RelativeSizeAxes = Axes.Both,
+                                        Direction = FillDirection.Vertical,
+                                        Spacing = new Vector2(5),
+                                        Children = new Drawable[]
+                                        {
+                                            addOrEditPlaylistButton = new PurpleTriangleButton
+                                            {
+                                                RelativeSizeAxes = Axes.X,
+                                                Height = 40,
+                                                Action = () =>
+                                                {
+                                                    if (this.IsCurrentScreen())
+                                                        this.Push(new MultiplayerMatchSongSelect(Room));
+                                                },
+                                                Alpha = 0
+                                            },
+                                            new DrawableRoomPlaylist(false, false)
+                                            {
+                                                RelativeSizeAxes = Axes.Both,
+                                                Items = { BindTarget = Room.Playlist },
+                                                SelectedItem = { BindTarget = SelectedItem }
+                                            },
+                                        }
+                                    }
+                                },
                                 new[]
                                 {
                                     UserModsSection = new FillFlowContainer
@@ -171,7 +203,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
                             RowDimensions = new[]
                             {
                                 new Dimension(GridSizeMode.AutoSize),
-                                new Dimension(GridSizeMode.AutoSize),
+                                new Dimension(),
                                 new Dimension(GridSizeMode.AutoSize),
                             }
                         },
@@ -354,6 +386,24 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
                 return;
             }
 
+            switch (client.Room.Settings.QueueMode)
+            {
+                case QueueModes.HostOnly:
+                    addOrEditPlaylistButton.Text = "Edit beatmap";
+                    addOrEditPlaylistButton.Alpha = client.Room.Host?.User?.Equals(client.LocalUser?.User) == true ? 1 : 0;
+                    break;
+
+                case QueueModes.FreeForAll:
+                case QueueModes.FairRotate:
+                    addOrEditPlaylistButton.Text = "Add beatmap";
+                    addOrEditPlaylistButton.Alpha = 1;
+                    break;
+
+                default:
+                    addOrEditPlaylistButton.Alpha = 0;
+                    break;
+            }
+
             Scheduler.AddOnce(UpdateMods);
         }
 

From 4e6a02bde9ad6537a3a63060af98839cff726e29 Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Fri, 22 Oct 2021 20:14:04 +0900
Subject: [PATCH 0402/5547] Fix missing QueueMode copies

---
 osu.Game/Online/Rooms/Room.cs                              | 1 +
 osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs | 4 ++--
 2 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Online/Rooms/Room.cs b/osu.Game/Online/Rooms/Room.cs
index 875cdeeb8c..c5f7e240ec 100644
--- a/osu.Game/Online/Rooms/Room.cs
+++ b/osu.Game/Online/Rooms/Room.cs
@@ -182,6 +182,7 @@ namespace osu.Game.Online.Rooms
             ParticipantCount.Value = other.ParticipantCount.Value;
             EndDate.Value = other.EndDate.Value;
             UserScore.Value = other.UserScore.Value;
+            QueueMode.Value = other.QueueMode.Value;
 
             if (EndDate.Value != null && DateTimeOffset.Now >= EndDate.Value)
                 Status.Value = new RoomStatusEnded();
diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
index 7606f6c456..45c3f28eab 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
@@ -158,8 +158,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     Name = apiRoom.Name.Value,
                     MatchType = apiRoom.Type.Value,
                     PlaylistItemId = lastPlaylistItemId,
-                    // ReSharper disable once ConstantNullCoalescingCondition Incorrect inspection due to lack of nullable in Room.cs.
-                    Password = password ?? string.Empty,
+                    Password = password,
+                    QueueMode = apiRoom.QueueMode.Value
                 },
                 Users = { localUser },
                 Host = localUser

From ec02e16c8196f08f5b7c63ca1cedd94a40de629c Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Fri, 22 Oct 2021 20:53:45 +0900
Subject: [PATCH 0403/5547] Add playlist item change event

---
 .../Online/Multiplayer/IMultiplayerClient.cs  |  6 ++
 .../Online/Multiplayer/MultiplayerClient.cs   | 62 +++++++++++++------
 2 files changed, 50 insertions(+), 18 deletions(-)

diff --git a/osu.Game/Online/Multiplayer/IMultiplayerClient.cs b/osu.Game/Online/Multiplayer/IMultiplayerClient.cs
index 3eafb31510..81979c146c 100644
--- a/osu.Game/Online/Multiplayer/IMultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/IMultiplayerClient.cs
@@ -118,5 +118,11 @@ namespace osu.Game.Online.Multiplayer
         /// </summary>
         /// <param name="item">The removed item.</param>
         Task PlaylistItemRemoved(APIPlaylistItem item);
+
+        /// <summary>
+        /// Signals that an item has been changed in the playlist.
+        /// </summary>
+        /// <param name="item">The changed item.</param>
+        Task PlaylistItemChanged(APIPlaylistItem item);
     }
 }
diff --git a/osu.Game/Online/Multiplayer/MultiplayerClient.cs b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
index 72ac13c2f2..1b321421e3 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
@@ -577,12 +577,7 @@ namespace osu.Game.Online.Multiplayer
             if (Room == null)
                 return;
 
-            var set = await GetOnlineBeatmapSet(item.BeatmapID).ConfigureAwait(false);
-
-            var beatmap = set.Beatmaps.Single(b => b.OnlineBeatmapID == item.BeatmapID);
-            beatmap.MD5Hash = item.BeatmapChecksum;
-
-            var ruleset = Rulesets.GetRuleset(item.RulesetID);
+            var playlistItem = await createPlaylistItem(item).ConfigureAwait(false);
 
             await scheduleAsync(() =>
             {
@@ -591,18 +586,6 @@ namespace osu.Game.Online.Multiplayer
 
                 Debug.Assert(APIRoom != null);
 
-                var playlistItem = new PlaylistItem
-                {
-                    ID = item.ID,
-                    Beatmap = { Value = beatmap },
-                    Ruleset = { Value = ruleset },
-                };
-
-                var rulesetInstance = ruleset.CreateInstance();
-
-                playlistItem.RequiredMods.AddRange(item.RequiredMods.Select(m => m.ToMod(rulesetInstance)));
-                playlistItem.AllowedMods.AddRange(item.AllowedMods.Select(m => m.ToMod(rulesetInstance)));
-
                 APIRoom.Playlist.Add(playlistItem);
                 RoomUpdated?.Invoke();
             }).ConfigureAwait(false);
@@ -625,6 +608,26 @@ namespace osu.Game.Online.Multiplayer
             });
         }
 
+        public async Task PlaylistItemChanged(APIPlaylistItem item)
+        {
+            if (Room == null)
+                return;
+
+            var playlistItem = await createPlaylistItem(item).ConfigureAwait(false);
+
+            await scheduleAsync(() =>
+            {
+                if (Room == null)
+                    return;
+
+                Debug.Assert(APIRoom != null);
+
+                int index = APIRoom.Playlist.Where(p => p.ID == item.ID).Select((_, i) => i).Single();
+                APIRoom.Playlist.RemoveAt(index);
+                APIRoom.Playlist.Insert(index, playlistItem);
+            }).ConfigureAwait(false);
+        }
+
         /// <summary>
         /// Populates the <see cref="User"/> for a given <see cref="MultiplayerRoomUser"/>.
         /// </summary>
@@ -663,6 +666,29 @@ namespace osu.Game.Online.Multiplayer
         /// <returns>The <see cref="BeatmapSetInfo"/> retrieval task.</returns>
         protected abstract Task<BeatmapSetInfo> GetOnlineBeatmapSet(int beatmapId, CancellationToken cancellationToken = default);
 
+        private async Task<PlaylistItem> createPlaylistItem(APIPlaylistItem item)
+        {
+            var set = await GetOnlineBeatmapSet(item.BeatmapID).ConfigureAwait(false);
+
+            var beatmap = set.Beatmaps.Single(b => b.OnlineBeatmapID == item.BeatmapID);
+            beatmap.MD5Hash = item.BeatmapChecksum;
+
+            var ruleset = Rulesets.GetRuleset(item.RulesetID);
+            var rulesetInstance = ruleset.CreateInstance();
+
+            var playlistItem = new PlaylistItem
+            {
+                ID = item.ID,
+                Beatmap = { Value = beatmap },
+                Ruleset = { Value = ruleset },
+            };
+
+            playlistItem.RequiredMods.AddRange(item.RequiredMods.Select(m => m.ToMod(rulesetInstance)));
+            playlistItem.AllowedMods.AddRange(item.AllowedMods.Select(m => m.ToMod(rulesetInstance)));
+
+            return playlistItem;
+        }
+
         /// <summary>
         /// For the provided user ID, update whether the user is included in <see cref="CurrentMatchPlayingUserIds"/>.
         /// </summary>

From d7a98097a127294e740f57455a079ba92caf4364 Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Fri, 22 Oct 2021 21:04:52 +0900
Subject: [PATCH 0404/5547] Make DrawableRoomPlaylist handle expired items

---
 .../TestSceneDrawableRoomPlaylist.cs          | 47 ++++++++++++++++++-
 .../OnlinePlay/DrawableRoomPlaylistItem.cs    |  3 ++
 2 files changed, 49 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
index 93bdbb79f4..470c5bed59 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
@@ -241,6 +241,50 @@ namespace osu.Game.Tests.Visual.Multiplayer
             createPlaylist(beatmap);
         }
 
+        [Test]
+        public void TestExpiredItems()
+        {
+            AddStep("create playlist", () =>
+            {
+                Child = playlist = new TestPlaylist(false, false)
+                {
+                    Anchor = Anchor.Centre,
+                    Origin = Anchor.Centre,
+                    Size = new Vector2(500, 300),
+                    Items =
+                    {
+                        new PlaylistItem
+                        {
+                            ID = 0,
+                            Beatmap = { Value = new TestBeatmap(new OsuRuleset().RulesetInfo).BeatmapInfo },
+                            Ruleset = { Value = new OsuRuleset().RulesetInfo },
+                            Expired = true,
+                            RequiredMods =
+                            {
+                                new OsuModHardRock(),
+                                new OsuModDoubleTime(),
+                                new OsuModAutoplay()
+                            }
+                        },
+                        new PlaylistItem
+                        {
+                            ID = 1,
+                            Beatmap = { Value = new TestBeatmap(new OsuRuleset().RulesetInfo).BeatmapInfo },
+                            Ruleset = { Value = new OsuRuleset().RulesetInfo },
+                            RequiredMods =
+                            {
+                                new OsuModHardRock(),
+                                new OsuModDoubleTime(),
+                                new OsuModAutoplay()
+                            }
+                        }
+                    }
+                };
+            });
+
+            AddUntilStep("wait for items to load", () => playlist.ItemMap.Values.All(i => i.IsLoaded));
+        }
+
         private void moveToItem(int index, Vector2? offset = null)
             => AddStep($"move mouse to item {index}", () => InputManager.MoveMouseTo(playlist.ChildrenOfType<DifficultyIcon>().ElementAt(index), offset));
 
@@ -261,7 +305,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 () => (playlist.ChildrenOfType<OsuRearrangeableListItem<PlaylistItem>.PlaylistItemHandle>().ElementAt(index).Alpha > 0) == visible);
 
         private void assertDeleteButtonVisibility(int index, bool visible)
-            => AddAssert($"delete button {index} {(visible ? "is" : "is not")} visible", () => (playlist.ChildrenOfType<DrawableRoomPlaylistItem.PlaylistRemoveButton>().ElementAt(2 + index * 2).Alpha > 0) == visible);
+            => AddAssert($"delete button {index} {(visible ? "is" : "is not")} visible",
+                () => (playlist.ChildrenOfType<DrawableRoomPlaylistItem.PlaylistRemoveButton>().ElementAt(2 + index * 2).Alpha > 0) == visible);
 
         private void createPlaylist(bool allowEdit, bool allowSelection)
         {
diff --git a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
index 9fee739048..2ee096eb8e 100644
--- a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
+++ b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
@@ -72,6 +72,9 @@ namespace osu.Game.Screens.OnlinePlay
             requiredMods.BindTo(item.RequiredMods);
 
             ShowDragHandle.Value = allowEdit;
+
+            if (item.Expired)
+                Colour = OsuColour.Gray(0.5f);
         }
 
         [BackgroundDependencyLoader]

From 1b4be61ed16e0a4224072c33c0b23d7686189288 Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Fri, 22 Oct 2021 21:16:10 +0900
Subject: [PATCH 0405/5547] Fix finished-play state not handled correctly

---
 .../Visual/Multiplayer/TestMultiplayerClient.cs      | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
index 45c3f28eab..3450cc0fc9 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
@@ -96,31 +96,31 @@ namespace osu.Game.Tests.Visual.Multiplayer
         public void ChangeUserState(int userId, MultiplayerUserState newState)
         {
             Debug.Assert(Room != null);
-
             ((IMultiplayerClient)this).UserStateChanged(userId, newState);
 
             Schedule(() =>
             {
-                switch (newState)
+                switch (Room.State)
                 {
-                    case MultiplayerUserState.Loaded:
+                    case MultiplayerRoomState.WaitingForLoad:
                         if (Room.Users.All(u => u.State != MultiplayerUserState.WaitingForLoad))
                         {
-                            ChangeRoomState(MultiplayerRoomState.Playing);
                             foreach (var u in Room.Users.Where(u => u.State == MultiplayerUserState.Loaded))
                                 ChangeUserState(u.UserID, MultiplayerUserState.Playing);
 
                             ((IMultiplayerClient)this).MatchStarted();
+
+                            ChangeRoomState(MultiplayerRoomState.Playing);
                         }
 
                         break;
 
-                    case MultiplayerUserState.FinishedPlay:
+                    case MultiplayerRoomState.Playing:
                         if (Room.Users.All(u => u.State != MultiplayerUserState.Playing))
                         {
-                            ChangeRoomState(MultiplayerRoomState.Open);
                             foreach (var u in Room.Users.Where(u => u.State == MultiplayerUserState.FinishedPlay))
                                 ChangeUserState(u.UserID, MultiplayerUserState.Results);
+                            ChangeRoomState(MultiplayerRoomState.Open);
 
                             ((IMultiplayerClient)this).ResultsReady();
                         }

From 6775151c30a38dfa5a304d471bb92a0504a589eb Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Fri, 22 Oct 2021 21:25:49 +0900
Subject: [PATCH 0406/5547] Add Expired bool to APIPlaylistItem

---
 osu.Game/Online/Multiplayer/MultiplayerClient.cs | 1 +
 osu.Game/Online/Rooms/APIPlaylistItem.cs         | 4 ++++
 2 files changed, 5 insertions(+)

diff --git a/osu.Game/Online/Multiplayer/MultiplayerClient.cs b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
index 1b321421e3..10dd0e9b0e 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
@@ -681,6 +681,7 @@ namespace osu.Game.Online.Multiplayer
                 ID = item.ID,
                 Beatmap = { Value = beatmap },
                 Ruleset = { Value = ruleset },
+                Expired = item.Expired
             };
 
             playlistItem.RequiredMods.AddRange(item.RequiredMods.Select(m => m.ToMod(rulesetInstance)));
diff --git a/osu.Game/Online/Rooms/APIPlaylistItem.cs b/osu.Game/Online/Rooms/APIPlaylistItem.cs
index 121d661c65..a9156f35ce 100644
--- a/osu.Game/Online/Rooms/APIPlaylistItem.cs
+++ b/osu.Game/Online/Rooms/APIPlaylistItem.cs
@@ -30,6 +30,9 @@ namespace osu.Game.Online.Rooms
         [Key(5)]
         public IEnumerable<APIMod> AllowedMods { get; set; } = Enumerable.Empty<APIMod>();
 
+        [Key(6)]
+        public bool Expired { get; set; }
+
         public APIPlaylistItem()
         {
         }
@@ -42,6 +45,7 @@ namespace osu.Game.Online.Rooms
             RulesetID = item.RulesetID;
             RequiredMods = item.RequiredMods.Select(m => new APIMod(m)).ToArray();
             AllowedMods = item.AllowedMods.Select(m => new APIMod(m)).ToArray();
+            Expired = item.Expired;
         }
     }
 }

From c701579c693f345d6ea3046d79264949c9f2d57a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 22 Oct 2021 21:25:13 +0900
Subject: [PATCH 0407/5547] Refactor `BeatmapMetadataContainer` and usages to
 use interface types

---
 .../Responses/APIUserMostPlayedBeatmap.cs     | 22 +++----
 .../Sections/BeatmapMetadataContainer.cs      | 11 ++--
 .../Historical/DrawableMostPlayedBeatmap.cs   | 61 ++++++++++++-------
 .../PaginatedMostPlayedBeatmapContainer.cs    |  4 +-
 .../Sections/Ranks/DrawableProfileScore.cs    | 49 +++++++++------
 5 files changed, 86 insertions(+), 61 deletions(-)

diff --git a/osu.Game/Online/API/Requests/Responses/APIUserMostPlayedBeatmap.cs b/osu.Game/Online/API/Requests/Responses/APIUserMostPlayedBeatmap.cs
index 10f7ca6fe2..19c581bf95 100644
--- a/osu.Game/Online/API/Requests/Responses/APIUserMostPlayedBeatmap.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIUserMostPlayedBeatmap.cs
@@ -2,8 +2,6 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using Newtonsoft.Json;
-using osu.Game.Beatmaps;
-using osu.Game.Rulesets;
 
 namespace osu.Game.Online.API.Requests.Responses
 {
@@ -16,17 +14,19 @@ namespace osu.Game.Online.API.Requests.Responses
         public int PlayCount { get; set; }
 
         [JsonProperty("beatmap")]
-        private BeatmapInfo beatmapInfo { get; set; }
+        private APIBeatmap beatmap { get; set; }
 
-        [JsonProperty]
-        private APIBeatmapSet beatmapSet { get; set; }
-
-        public BeatmapInfo GetBeatmapInfo(RulesetStore rulesets)
+        public APIBeatmap BeatmapInfo
         {
-            BeatmapSetInfo setInfo = beatmapSet.ToBeatmapSet(rulesets);
-            beatmapInfo.BeatmapSet = setInfo;
-            beatmapInfo.Metadata = setInfo.Metadata;
-            return beatmapInfo;
+            get
+            {
+                // old osu-web code doesn't nest set.
+                beatmap.BeatmapSet = BeatmapSet;
+                return beatmap;
+            }
         }
+
+        [JsonProperty("beatmapset")]
+        public APIBeatmapSet BeatmapSet { get; set; }
     }
 }
diff --git a/osu.Game/Overlays/Profile/Sections/BeatmapMetadataContainer.cs b/osu.Game/Overlays/Profile/Sections/BeatmapMetadataContainer.cs
index 7812a81f30..94ef5e5d86 100644
--- a/osu.Game/Overlays/Profile/Sections/BeatmapMetadataContainer.cs
+++ b/osu.Game/Overlays/Profile/Sections/BeatmapMetadataContainer.cs
@@ -15,9 +15,9 @@ namespace osu.Game.Overlays.Profile.Sections
     /// </summary>
     public abstract class BeatmapMetadataContainer : OsuHoverContainer
     {
-        private readonly BeatmapInfo beatmapInfo;
+        private readonly IBeatmapInfo beatmapInfo;
 
-        protected BeatmapMetadataContainer(BeatmapInfo beatmapInfo)
+        protected BeatmapMetadataContainer(IBeatmapInfo beatmapInfo)
             : base(HoverSampleSet.Submit)
         {
             this.beatmapInfo = beatmapInfo;
@@ -30,10 +30,7 @@ namespace osu.Game.Overlays.Profile.Sections
         {
             Action = () =>
             {
-                if (beatmapInfo.OnlineBeatmapID != null)
-                    beatmapSetOverlay?.FetchAndShowBeatmap(beatmapInfo.OnlineBeatmapID.Value);
-                else if (beatmapInfo.BeatmapSet?.OnlineBeatmapSetID != null)
-                    beatmapSetOverlay?.FetchAndShowBeatmapSet(beatmapInfo.BeatmapSet.OnlineBeatmapSetID.Value);
+                beatmapSetOverlay?.FetchAndShowBeatmap(beatmapInfo.OnlineID);
             };
 
             Child = new FillFlowContainer
@@ -43,6 +40,6 @@ namespace osu.Game.Overlays.Profile.Sections
             };
         }
 
-        protected abstract Drawable[] CreateText(BeatmapInfo beatmapInfo);
+        protected abstract Drawable[] CreateText(IBeatmapInfo beatmapInfo);
     }
 }
diff --git a/osu.Game/Overlays/Profile/Sections/Historical/DrawableMostPlayedBeatmap.cs b/osu.Game/Overlays/Profile/Sections/Historical/DrawableMostPlayedBeatmap.cs
index 32201e36a9..c4c8bfb84f 100644
--- a/osu.Game/Overlays/Profile/Sections/Historical/DrawableMostPlayedBeatmap.cs
+++ b/osu.Game/Overlays/Profile/Sections/Historical/DrawableMostPlayedBeatmap.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.Diagnostics;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
@@ -13,6 +14,7 @@ using osu.Game.Graphics.Sprites;
 using osuTK;
 using osu.Framework.Graphics.Cursor;
 using osu.Framework.Localisation;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Resources.Localisation.Web;
 
 namespace osu.Game.Overlays.Profile.Sections.Historical
@@ -22,13 +24,11 @@ namespace osu.Game.Overlays.Profile.Sections.Historical
         private const int cover_width = 100;
         private const int corner_radius = 6;
 
-        private readonly BeatmapInfo beatmapInfo;
-        private readonly int playCount;
+        private readonly APIUserMostPlayedBeatmap mostPlayed;
 
-        public DrawableMostPlayedBeatmap(BeatmapInfo beatmapInfo, int playCount)
+        public DrawableMostPlayedBeatmap(APIUserMostPlayedBeatmap mostPlayed)
         {
-            this.beatmapInfo = beatmapInfo;
-            this.playCount = playCount;
+            this.mostPlayed = mostPlayed;
 
             RelativeSizeAxes = Axes.X;
             Height = 50;
@@ -46,7 +46,7 @@ namespace osu.Game.Overlays.Profile.Sections.Historical
                 {
                     RelativeSizeAxes = Axes.Y,
                     Width = cover_width,
-                    BeatmapSet = beatmapInfo.BeatmapSet,
+                    BeatmapSet = mostPlayed.BeatmapSet,
                 },
                 new Container
                 {
@@ -77,7 +77,7 @@ namespace osu.Game.Overlays.Profile.Sections.Historical
                                                 Direction = FillDirection.Vertical,
                                                 Children = new Drawable[]
                                                 {
-                                                    new MostPlayedBeatmapMetadataContainer(beatmapInfo),
+                                                    new MostPlayedBeatmapMetadataContainer(mostPlayed.BeatmapInfo),
                                                     new LinkFlowContainer(t =>
                                                     {
                                                         t.Font = OsuFont.GetFont(size: 12, weight: FontWeight.Regular);
@@ -89,11 +89,11 @@ namespace osu.Game.Overlays.Profile.Sections.Historical
                                                     }.With(d =>
                                                     {
                                                         d.AddText("mapped by ");
-                                                        d.AddUserLink(beatmapInfo.Metadata.Author);
+                                                        d.AddUserLink(mostPlayed.BeatmapSet.Author);
                                                     }),
                                                 }
                                             },
-                                            new PlayCountText(playCount)
+                                            new PlayCountText(mostPlayed.PlayCount)
                                             {
                                                 Anchor = Anchor.CentreRight,
                                                 Origin = Anchor.CentreRight
@@ -120,26 +120,41 @@ namespace osu.Game.Overlays.Profile.Sections.Historical
 
         private class MostPlayedBeatmapMetadataContainer : BeatmapMetadataContainer
         {
-            public MostPlayedBeatmapMetadataContainer(BeatmapInfo beatmapInfo)
+            public MostPlayedBeatmapMetadataContainer(IBeatmapInfo beatmapInfo)
                 : base(beatmapInfo)
             {
             }
 
-            protected override Drawable[] CreateText(BeatmapInfo beatmapInfo) => new Drawable[]
+            protected override Drawable[] CreateText(IBeatmapInfo beatmapInfo)
             {
-                new OsuSpriteText
+                var metadata = beatmapInfo.Metadata;
+
+                Debug.Assert(metadata != null);
+
+                return new Drawable[]
                 {
-                    Text = new RomanisableString(
-                        $"{beatmapInfo.Metadata.TitleUnicode ?? beatmapInfo.Metadata.Title} [{beatmapInfo.Version}] ",
-                        $"{beatmapInfo.Metadata.Title ?? beatmapInfo.Metadata.TitleUnicode} [{beatmapInfo.Version}] "),
-                    Font = OsuFont.GetFont(weight: FontWeight.Bold)
-                },
-                new OsuSpriteText
-                {
-                    Text = "by " + new RomanisableString(beatmapInfo.Metadata.ArtistUnicode, beatmapInfo.Metadata.Artist),
-                    Font = OsuFont.GetFont(weight: FontWeight.Regular)
-                },
-            };
+                    new OsuSpriteText
+                    {
+                        Text = new RomanisableString(metadata.TitleUnicode, metadata.Title),
+                        Font = OsuFont.GetFont(weight: FontWeight.Bold)
+                    },
+                    new OsuSpriteText
+                    {
+                        Text = $" [{beatmapInfo.DifficultyName}]",
+                        Font = OsuFont.GetFont(weight: FontWeight.Bold)
+                    },
+                    new OsuSpriteText
+                    {
+                        Text = " by ",
+                        Font = OsuFont.GetFont(weight: FontWeight.Regular)
+                    },
+                    new OsuSpriteText
+                    {
+                        Text = new RomanisableString(metadata.ArtistUnicode, metadata.Artist),
+                        Font = OsuFont.GetFont(weight: FontWeight.Regular)
+                    },
+                };
+            }
         }
 
         private class PlayCountText : CompositeDrawable, IHasTooltip
diff --git a/osu.Game/Overlays/Profile/Sections/Historical/PaginatedMostPlayedBeatmapContainer.cs b/osu.Game/Overlays/Profile/Sections/Historical/PaginatedMostPlayedBeatmapContainer.cs
index d0979526da..428d04f985 100644
--- a/osu.Game/Overlays/Profile/Sections/Historical/PaginatedMostPlayedBeatmapContainer.cs
+++ b/osu.Game/Overlays/Profile/Sections/Historical/PaginatedMostPlayedBeatmapContainer.cs
@@ -33,7 +33,7 @@ namespace osu.Game.Overlays.Profile.Sections.Historical
         protected override APIRequest<List<APIUserMostPlayedBeatmap>> CreateRequest() =>
             new GetUserMostPlayedBeatmapsRequest(User.Value.Id, VisiblePages++, ItemsPerPage);
 
-        protected override Drawable CreateDrawableItem(APIUserMostPlayedBeatmap model) =>
-            new DrawableMostPlayedBeatmap(model.GetBeatmapInfo(Rulesets), model.PlayCount);
+        protected override Drawable CreateDrawableItem(APIUserMostPlayedBeatmap mostPlayed) =>
+            new DrawableMostPlayedBeatmap(mostPlayed);
     }
 }
diff --git a/osu.Game/Overlays/Profile/Sections/Ranks/DrawableProfileScore.cs b/osu.Game/Overlays/Profile/Sections/Ranks/DrawableProfileScore.cs
index 3561e9700e..7bfa2ee51e 100644
--- a/osu.Game/Overlays/Profile/Sections/Ranks/DrawableProfileScore.cs
+++ b/osu.Game/Overlays/Profile/Sections/Ranks/DrawableProfileScore.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.Diagnostics;
 using System.Linq;
 using JetBrains.Annotations;
 using osu.Framework.Allocation;
@@ -245,30 +246,42 @@ namespace osu.Game.Overlays.Profile.Sections.Ranks
 
         private class ScoreBeatmapMetadataContainer : BeatmapMetadataContainer
         {
-            public ScoreBeatmapMetadataContainer(BeatmapInfo beatmapInfo)
+            public ScoreBeatmapMetadataContainer(IBeatmapInfo beatmapInfo)
                 : base(beatmapInfo)
             {
             }
 
-            protected override Drawable[] CreateText(BeatmapInfo beatmapInfo) => new Drawable[]
+            protected override Drawable[] CreateText(IBeatmapInfo beatmapInfo)
             {
-                new OsuSpriteText
+                var metadata = beatmapInfo.Metadata;
+
+                Debug.Assert(metadata != null);
+
+                return new Drawable[]
                 {
-                    Anchor = Anchor.BottomLeft,
-                    Origin = Anchor.BottomLeft,
-                    Text = new RomanisableString(
-                        $"{beatmapInfo.Metadata.TitleUnicode ?? beatmapInfo.Metadata.Title} ",
-                        $"{beatmapInfo.Metadata.Title ?? beatmapInfo.Metadata.TitleUnicode} "),
-                    Font = OsuFont.GetFont(size: 14, weight: FontWeight.SemiBold, italics: true)
-                },
-                new OsuSpriteText
-                {
-                    Anchor = Anchor.BottomLeft,
-                    Origin = Anchor.BottomLeft,
-                    Text = "by " + new RomanisableString(beatmapInfo.Metadata.ArtistUnicode, beatmapInfo.Metadata.Artist),
-                    Font = OsuFont.GetFont(size: 12, italics: true)
-                },
-            };
+                    new OsuSpriteText
+                    {
+                        Anchor = Anchor.BottomLeft,
+                        Origin = Anchor.BottomLeft,
+                        Text = new RomanisableString(metadata.TitleUnicode, metadata.Title),
+                        Font = OsuFont.GetFont(size: 14, weight: FontWeight.SemiBold, italics: true)
+                    },
+                    new OsuSpriteText
+                    {
+                        Anchor = Anchor.BottomLeft,
+                        Origin = Anchor.BottomLeft,
+                        Text = " by ",
+                        Font = OsuFont.GetFont(size: 12, italics: true)
+                    },
+                    new OsuSpriteText
+                    {
+                        Anchor = Anchor.BottomLeft,
+                        Origin = Anchor.BottomLeft,
+                        Text = new RomanisableString(metadata.ArtistUnicode, metadata.Artist),
+                        Font = OsuFont.GetFont(size: 12, italics: true)
+                    },
+                };
+            }
         }
     }
 }

From 76eff7f6b1fcbf742b69505027892c0862821e02 Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Fri, 22 Oct 2021 21:57:29 +0900
Subject: [PATCH 0408/5547] Fix incorrect indexing

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

diff --git a/osu.Game/Online/Multiplayer/MultiplayerClient.cs b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
index 10dd0e9b0e..6b1042df2d 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
@@ -622,7 +622,7 @@ namespace osu.Game.Online.Multiplayer
 
                 Debug.Assert(APIRoom != null);
 
-                int index = APIRoom.Playlist.Where(p => p.ID == item.ID).Select((_, i) => i).Single();
+                int index = APIRoom.Playlist.Select((i, index) => (i, index)).Single(kvp => kvp.i.ID == item.ID).index;
                 APIRoom.Playlist.RemoveAt(index);
                 APIRoom.Playlist.Insert(index, playlistItem);
             }).ConfigureAwait(false);

From a4397ee68ca3be618f663efafa195154da3cd647 Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Fri, 22 Oct 2021 22:07:41 +0900
Subject: [PATCH 0409/5547] Add playlist continuation flow

---
 .../Multiplayer/TestMultiplayerClient.cs      | 116 +++++++++++++-----
 1 file changed, 88 insertions(+), 28 deletions(-)

diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
index 3450cc0fc9..717f55d377 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
@@ -42,8 +42,6 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
         private readonly TestRequestHandlingMultiplayerRoomManager roomManager;
 
-        private long lastPlaylistItemId;
-
         public TestMultiplayerClient(TestRequestHandlingMultiplayerRoomManager roomManager)
         {
             this.roomManager = roomManager;
@@ -123,6 +121,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
                             ChangeRoomState(MultiplayerRoomState.Open);
 
                             ((IMultiplayerClient)this).ResultsReady();
+
+                            finishPlaylistItem().ContinueWith(_ => advanceToNextPlaylistItem());
                         }
 
                         break;
@@ -144,8 +144,6 @@ namespace osu.Game.Tests.Visual.Multiplayer
             if (password != apiRoom.Password.Value)
                 throw new InvalidOperationException("Invalid password.");
 
-            lastPlaylistItemId = apiRoom.Playlist.Last().ID;
-
             var localUser = new MultiplayerRoomUser(api.LocalUser.Value.Id)
             {
                 User = api.LocalUser.Value
@@ -157,7 +155,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 {
                     Name = apiRoom.Name.Value,
                     MatchType = apiRoom.Type.Value,
-                    PlaylistItemId = lastPlaylistItemId,
+                    PlaylistItemId = apiRoom.Playlist.Single().ID,
                     Password = password,
                     QueueMode = apiRoom.QueueMode.Value
                 },
@@ -193,6 +191,24 @@ namespace osu.Game.Tests.Visual.Multiplayer
         public override async Task ChangeSettings(MultiplayerRoomSettings settings)
         {
             Debug.Assert(Room != null);
+            Debug.Assert(APIRoom != null);
+
+            switch (Room.Settings.QueueMode, settings.QueueMode)
+            {
+                case (QueueModes.HostOnly, QueueModes.HostOnly):
+                    break;
+
+                // Host-only is incompatible with other queueing modes, so expire all non-expired items.
+                case (QueueModes.HostOnly, _):
+                case (_, QueueModes.HostOnly):
+                    foreach (var playlistItem in APIRoom.Playlist.Where(i => !i.Expired).ToArray())
+                    {
+                        playlistItem.Expired = true;
+                        await ((IMultiplayerClient)this).PlaylistItemChanged(new APIPlaylistItem(playlistItem)).ConfigureAwait(false);
+                    }
+
+                    break;
+            }
 
             await ((IMultiplayerClient)this).SettingsChanged(settings).ConfigureAwait(false);
 
@@ -270,32 +286,16 @@ namespace osu.Game.Tests.Visual.Multiplayer
             Debug.Assert(Room != null);
             Debug.Assert(APIRoom != null);
 
-            item.ID = lastPlaylistItemId + 1;
-
-            switch (Room.Settings.QueueMode)
+            if (Room.Settings.QueueMode == QueueModes.HostOnly && APIRoom.Playlist.Count > 0)
             {
-                case QueueModes.HostOnly:
-                    if (Room.Host?.UserID != LocalUser?.UserID)
-                        throw new InvalidOperationException("Local user is not the room host.");
+                if (Room.Host?.UserID != LocalUser?.UserID)
+                    throw new InvalidOperationException("Local user is not the room host.");
 
-                    await RemovePlaylistItem(new APIPlaylistItem(APIRoom.Playlist.Single(i => i.ID == lastPlaylistItemId))).ConfigureAwait(false);
-                    await ((IMultiplayerClient)this).PlaylistItemAdded(item).ConfigureAwait(false);
-
-                    Room.Settings.PlaylistItemId = item.ID;
-                    await ChangeSettings(Room.Settings).ConfigureAwait(false);
-                    break;
-
-                case QueueModes.FreeForAll:
-                    await ((IMultiplayerClient)this).PlaylistItemAdded(item).ConfigureAwait(false);
-                    // Todo: Advance if the added item is the last non-expired one.
-                    break;
-
-                case QueueModes.FairRotate:
-                    // Todo: Not implemented.
-                    throw new NotImplementedException();
+                item.ID = APIRoom.Playlist.Last().ID;
+                await ((IMultiplayerClient)this).PlaylistItemChanged(item).ConfigureAwait(false);
             }
-
-            lastPlaylistItemId = item.ID;
+            else
+                await addPlaylistItem(item).ConfigureAwait(false);
         }
 
         public override Task RemovePlaylistItem(APIPlaylistItem item)
@@ -343,5 +343,65 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     break;
             }
         }
+
+        private async Task addPlaylistItem(APIPlaylistItem newItem)
+        {
+            Debug.Assert(Room != null);
+            Debug.Assert(APIRoom != null);
+
+            newItem.ID = (APIRoom.Playlist.LastOrDefault()?.ID ?? 0) + 1;
+            await ((IMultiplayerClient)this).PlaylistItemAdded(newItem).ConfigureAwait(false);
+
+            // A more valid selection can occur as a result of adding a new playlist item (e.g. if all previous items were expired).
+            await advanceToNextPlaylistItem().ConfigureAwait(false);
+        }
+
+        private async Task finishPlaylistItem()
+        {
+            Debug.Assert(Room != null);
+            Debug.Assert(APIRoom != null);
+
+            var currentItem = APIRoom.Playlist.Single(i => i.ID == Room.Settings.PlaylistItemId);
+
+            // Expire the current playlist item.
+            await ((IMultiplayerClient)this).PlaylistItemChanged(new APIPlaylistItem(currentItem) { Expired = true }).ConfigureAwait(false);
+
+            // In host-only mode, a duplicate playlist item will be used for the next round.
+            if (Room.Settings.QueueMode == QueueModes.HostOnly)
+                await addPlaylistItem(new APIPlaylistItem(currentItem)).ConfigureAwait(false);
+        }
+
+        private async Task advanceToNextPlaylistItem()
+        {
+            Debug.Assert(Room != null);
+            Debug.Assert(APIRoom != null);
+
+            long nextId = 0;
+
+            switch (Room.Settings.QueueMode)
+            {
+                case QueueModes.HostOnly:
+                    // Pick the single non-expired playlist item.
+                    nextId = APIRoom.Playlist.SingleOrDefault(i => !i.Expired)?.ID ?? 0;
+                    break;
+
+                case QueueModes.FairRotate:
+                    // Group playlist items by (user_id -> count_expired), and select the first available playlist item from a user that has available beatmaps where count_expired is the lowest.
+                    throw new NotImplementedException();
+
+                case QueueModes.FreeForAll:
+                    // Pick the first available non-expired playlist item, or default to the last.
+                    nextId = APIRoom.Playlist.FirstOrDefault(i => !i.Expired)?.ID
+                             ?? APIRoom.Playlist.LastOrDefault()?.ID
+                             ?? 0;
+                    break;
+            }
+
+            if (nextId != Room.Settings.PlaylistItemId)
+            {
+                Room.Settings.PlaylistItemId = nextId;
+                await ChangeSettings(Room.Settings).ConfigureAwait(false);
+            }
+        }
     }
 }

From 04b0529a7fb112432b5b69b86322bc6bde100f7e Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Fri, 22 Oct 2021 22:17:26 +0900
Subject: [PATCH 0410/5547] Fix list overflowing subscreen background

---
 .../Multiplayer/MultiplayerMatchSubScreen.cs  | 45 +++++++++----------
 1 file changed, 21 insertions(+), 24 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
index ba6d3f354a..6ac8ee1ee0 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
@@ -134,32 +134,27 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
                                 new Drawable[] { new OverlinedHeader("Beatmap") },
                                 new Drawable[]
                                 {
-                                    new FillFlowContainer
+                                    addOrEditPlaylistButton = new PurpleTriangleButton
+                                    {
+                                        RelativeSizeAxes = Axes.X,
+                                        Height = 40,
+                                        Action = () =>
+                                        {
+                                            if (this.IsCurrentScreen())
+                                                this.Push(new MultiplayerMatchSongSelect(Room));
+                                        },
+                                        Alpha = 0
+                                    },
+                                },
+                                null,
+                                new Drawable[]
+                                {
+                                    new DrawableRoomPlaylist(false, false)
                                     {
                                         RelativeSizeAxes = Axes.Both,
-                                        Direction = FillDirection.Vertical,
-                                        Spacing = new Vector2(5),
-                                        Children = new Drawable[]
-                                        {
-                                            addOrEditPlaylistButton = new PurpleTriangleButton
-                                            {
-                                                RelativeSizeAxes = Axes.X,
-                                                Height = 40,
-                                                Action = () =>
-                                                {
-                                                    if (this.IsCurrentScreen())
-                                                        this.Push(new MultiplayerMatchSongSelect(Room));
-                                                },
-                                                Alpha = 0
-                                            },
-                                            new DrawableRoomPlaylist(false, false)
-                                            {
-                                                RelativeSizeAxes = Axes.Both,
-                                                Items = { BindTarget = Room.Playlist },
-                                                SelectedItem = { BindTarget = SelectedItem }
-                                            },
-                                        }
-                                    }
+                                        Items = { BindTarget = Room.Playlist },
+                                        SelectedItem = { BindTarget = SelectedItem }
+                                    },
                                 },
                                 new[]
                                 {
@@ -203,6 +198,8 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
                             RowDimensions = new[]
                             {
                                 new Dimension(GridSizeMode.AutoSize),
+                                new Dimension(GridSizeMode.AutoSize),
+                                new Dimension(GridSizeMode.Absolute, 5),
                                 new Dimension(),
                                 new Dimension(GridSizeMode.AutoSize),
                             }

From 7d910ebb572a6a421ed32a41759085d3f2c2ba3f Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Fri, 22 Oct 2021 22:37:01 +0900
Subject: [PATCH 0411/5547] Add SignalR binding for PlaylistItemChanged

---
 osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs b/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs
index fd57b42000..f69464e37e 100644
--- a/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs
@@ -64,6 +64,7 @@ namespace osu.Game.Online.Multiplayer
                     connection.On<MatchServerEvent>(nameof(IMultiplayerClient.MatchEvent), ((IMultiplayerClient)this).MatchEvent);
                     connection.On<APIPlaylistItem>(nameof(IMultiplayerClient.PlaylistItemAdded), ((IMultiplayerClient)this).PlaylistItemAdded);
                     connection.On<APIPlaylistItem>(nameof(IMultiplayerClient.PlaylistItemRemoved), ((IMultiplayerClient)this).PlaylistItemRemoved);
+                    connection.On<APIPlaylistItem>(nameof(IMultiplayerClient.PlaylistItemChanged), ((IMultiplayerClient)this).PlaylistItemChanged);
                 };
 
                 IsConnected.BindTo(connector.IsConnected);

From 62197fec3a72ea1ab1e1168eda92a336a372a2db Mon Sep 17 00:00:00 2001
From: Xexxar <xexxar.xexxar@gmail.com>
Date: Fri, 22 Oct 2021 17:17:19 +0000
Subject: [PATCH 0412/5547] updated sliders for rebalance again

---
 .../Preprocessing/OsuDifficultyHitObject.cs   | 28 ++++++++-----------
 .../Difficulty/Skills/Aim.cs                  |  4 +--
 2 files changed, 14 insertions(+), 18 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
index 05098b0199..3139f6eb26 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
@@ -91,36 +91,32 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
                 MovementTime = Math.Max(StrainTime - lastSlider.LazyTravelTime / clockRate, min_delta_time);
                 MovementDistance = Vector2.Subtract(lastSlider.TailCircle.StackedPosition, BaseObject.StackedPosition).Length * scalingFactor;
 
-                int repeatCount = 0;
-
                 for (int i = 1; i < lastSlider.NestedHitObjects.Count; i++)
                 {
-                    if ((OsuHitObject)lastSlider.NestedHitObjects[i] is SliderRepeat)
-                        repeatCount++;
-
                     Vector2 currSlider = Vector2.Subtract(((OsuHitObject)lastSlider.NestedHitObjects[i]).StackedPosition, ((OsuHitObject)lastSlider.NestedHitObjects[i - 1]).StackedPosition);
 
-                    if ((OsuHitObject)lastSlider.NestedHitObjects[i] is SliderEndCircle || (OsuHitObject)lastSlider.NestedHitObjects[i] is SliderRepeat)
-                        TravelDistance += Math.Max(0, currSlider.Length * scalingFactor - 100);
+                    if ((OsuHitObject)lastSlider.NestedHitObjects[i] is SliderRepeat)
+                        TravelDistance += Math.Max(0, currSlider.Length * scalingFactor - 100); // remove 100 distance to avoid buffing overlapping followcircles.
+                    else if ((OsuHitObject)lastSlider.NestedHitObjects[i] is SliderEndCircle)
+                    {
+                        Vector2 possSlider = Vector2.Subtract((Vector2)lastSlider.LazyEndPosition, ((OsuHitObject)lastSlider.NestedHitObjects[i - 1]).StackedPosition);
+                        TravelDistance += Math.Min(possSlider.Length, currSlider.Length) * scalingFactor; // Take the least distance from slider end vs lazy end.
+                    }
                     else
                         TravelDistance += Vector2.Subtract(((OsuHitObject)lastSlider.NestedHitObjects[i]).StackedPosition, ((OsuHitObject)lastSlider.NestedHitObjects[i - 1]).StackedPosition).Length * scalingFactor;
 
                     if ((OsuHitObject)lastSlider.NestedHitObjects[i] is SliderTick && i != lastSlider.NestedHitObjects.Count - 1) // Check for tick && not last object is necessary for 2007 bugged sliders.
                     {
                         Vector2 nextSlider = Vector2.Subtract(((OsuHitObject)lastSlider.NestedHitObjects[i + 1]).StackedPosition, ((OsuHitObject)lastSlider.NestedHitObjects[i]).StackedPosition);
-                        TravelDistance += 3 * Math.Max(0, Vector2.Subtract(nextSlider, currSlider).Length - Math.Max(nextSlider.Length, currSlider.Length)) * scalingFactor;
+                        TravelDistance += Math.Max(0, Vector2.Subtract(nextSlider, currSlider).Length - Math.Max(nextSlider.Length, currSlider.Length)) * scalingFactor; // bonus for ticks where angles are less than 120 degrees.
                     }
                 }
-
-                TravelDistance *= Math.Pow(1 + repeatCount, 1.0 / 3.0);
-
-                TravelDistance *= Math.Max(0, lastSlider.SpanDuration - 37.5) / lastSlider.SpanDuration;
             }
 
             Vector2 lastCursorPosition = getEndCursorPosition(lastObject);
 
             JumpDistance = (BaseObject.StackedPosition * scalingFactor - lastCursorPosition * scalingFactor).Length;
-            MovementDistance = Math.Max(0, Math.Min(JumpDistance, MovementDistance) - 50);
+            MovementDistance = Math.Max(0, Math.Min(JumpDistance - 50, MovementDistance - 120)); // radius for jumpdistance is within 50 of maximum possible sliderLeniency, 120 for movement distance.
 
             if (lastLastObject != null && !(lastLastObject is Spinner))
             {
@@ -143,7 +139,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
 
             slider.LazyEndPosition = slider.StackedPosition;
 
-            float followCircleRadius = (float)(slider.Radius * 2.4);
+            float approxFollowCircleRadius = (float)(slider.Radius * 1.4); // using 1.4 to better follow the real movement of a cursor.
             var computeVertex = new Action<double>(t =>
             {
                 double progress = (t - slider.StartTime) / slider.SpanDuration;
@@ -158,11 +154,11 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
 
                 slider.LazyTravelTime = t - slider.StartTime;
 
-                if (dist > followCircleRadius)
+                if (dist > approxFollowCircleRadius)
                 {
                     // The cursor would be outside the follow circle, we need to move it
                     diff.Normalize(); // Obtain direction of diff
-                    dist -= followCircleRadius;
+                    dist -= approxFollowCircleRadius;
                     slider.LazyEndPosition += diff * dist;
                     slider.LazyTravelDistance += dist;
                 }
diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
index bb75be6fe0..1914f3700d 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
@@ -40,7 +40,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
             var osuPrevObj = (OsuDifficultyHitObject)Previous[0];
             var osuLastObj = (OsuDifficultyHitObject)Previous[1];
 
-            double currVelocity = osuCurrObj.JumpDistance / osuCurrObj.StrainTime; // Start with the base distance / time
+            double currVelocity = (osuCurrObj.JumpDistance + osuCurrObj.TravelDistance) / osuCurrObj.StrainTime; // Start with the base distance / time
 
             if (osuPrevObj.BaseObject is Slider) // If object is a slider
             {
@@ -50,7 +50,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
                 currVelocity = Math.Max(currVelocity, movementVelocity + travelVelocity); // take the larger total combined velocity.
             }
 
-            double prevVelocity = osuPrevObj.JumpDistance / osuPrevObj.StrainTime; // do the same for the previous velocity.
+            double prevVelocity = (osuPrevObj.JumpDistance + osuPrevObj.TravelDistance) / osuPrevObj.StrainTime; // do the same for the previous velocity.
 
             if (osuLastObj.BaseObject is Slider)
             {

From b9748399c49528cd6da68df92c96415abdf33d43 Mon Sep 17 00:00:00 2001
From: Xexxar <xexxar.xexxar@gmail.com>
Date: Fri, 22 Oct 2021 17:18:34 +0000
Subject: [PATCH 0413/5547] added velocity adjustment for sliders

---
 osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
index f71d33758d..369756458f 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
@@ -96,6 +96,9 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
 
             if (Math.Max(prevVelocity, currVelocity) != 0)
             {
+                prevVelocity = (osuPrevObj.JumpDistance + osuPrevObj.TravelDistance) / osuPrevObj.StrainTime; // We want to use the average velocity when awarding differences, not necessarily combined.
+                currVelocity = (osuCurrObj.JumpDistance + osuCurrObj.TravelDistance) / osuCurrObj.StrainTime;
+
                 velChangeBonus = Math.Max(Math.Abs(prevVelocity - currVelocity) // reward for % distance slowed down compared to previous, paying attention to not award overlap
                                           * Math.Pow(Math.Sin(Math.PI / 2 * Math.Min(1, osuCurrObj.JumpDistance / 100)), 2) // do not award overlap
                                           * Math.Pow(Math.Sin(Math.PI / 2 * Math.Abs(prevVelocity - currVelocity) / Math.Max(prevVelocity, currVelocity)), 2), // scale with ratio of difference compared to max

From b6e7d898f1a1640d5c062b61b5fd058efc524470 Mon Sep 17 00:00:00 2001
From: Xexxar <xexxar.xexxar@gmail.com>
Date: Fri, 22 Oct 2021 17:21:34 +0000
Subject: [PATCH 0414/5547] constant didnt update during last merge

---
 osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
index 369756458f..664af291fb 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
@@ -24,7 +24,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
 
         private const double wide_angle_multiplier = 1.5;
         private const double acute_angle_multiplier = 1.5;
-        private const double slider_multiplier = 1.75;
+        private const double slider_multiplier = 1.5;
         private const double vel_change_multiplier = 0.75;
 
         private double currentStrain = 1;

From 9fcb3d9dd1ca32f87fd2d4404fa5bdacf3d1e4aa Mon Sep 17 00:00:00 2001
From: Jason Won <jasonwon628@gmail.com>
Date: Fri, 22 Oct 2021 17:10:53 -0400
Subject: [PATCH 0415/5547] NoScopeMod: show cursor during breaks + spinners

---
 osu.Game.Rulesets.Osu/Mods/OsuModNoScope.cs | 31 +++++++++++++++++----
 1 file changed, 25 insertions(+), 6 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModNoScope.cs b/osu.Game.Rulesets.Osu/Mods/OsuModNoScope.cs
index c48cbd9992..026bb6c1cb 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModNoScope.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModNoScope.cs
@@ -2,22 +2,27 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
-using osu.Game.Rulesets.UI;
-using osu.Game.Rulesets.Mods;
+using System.Linq;
+using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Sprites;
-using osu.Framework.Bindables;
 using osu.Framework.Localisation;
 using osu.Framework.Utils;
-using osu.Game.Graphics.UserInterface;
+using osu.Game.Beatmaps;
 using osu.Game.Configuration;
+using osu.Game.Graphics.UserInterface;
 using osu.Game.Overlays.Settings;
+using osu.Game.Rulesets.Mods;
+using osu.Game.Rulesets.Osu.Objects;
+using osu.Game.Rulesets.UI;
 using osu.Game.Rulesets.Scoring;
 using osu.Game.Scoring;
+using osu.Game.Screens.Play;
+using osu.Game.Utils;
 
 namespace osu.Game.Rulesets.Osu.Mods
 {
-    public class OsuModNoScope : Mod, IUpdatableByPlayfield, IApplicableToScoreProcessor
+    public class OsuModNoScope : Mod, IUpdatableByPlayfield, IApplicableToScoreProcessor, IApplicableToPlayer, IApplicableToBeatmap
     {
         /// <summary>
         /// Slightly higher than the cutoff for <see cref="Drawable.IsPresent"/>.
@@ -34,6 +39,8 @@ namespace osu.Game.Rulesets.Osu.Mods
         public override double ScoreMultiplier => 1;
 
         private BindableNumber<int> currentCombo;
+        private IBindable<bool> isBreakTime;
+        private PeriodTracker spinnerPeriods;
 
         private float targetAlpha;
 
@@ -52,6 +59,16 @@ namespace osu.Game.Rulesets.Osu.Mods
 
         public ScoreRank AdjustRank(ScoreRank rank, double accuracy) => rank;
 
+        public void ApplyToPlayer(Player player)
+        {
+            isBreakTime = player.IsBreakTime.GetBoundCopy();
+        }
+
+        public void ApplyToBeatmap(IBeatmap beatmap)
+        {
+            spinnerPeriods = new PeriodTracker(beatmap.HitObjects.OfType<Spinner>().Select(b => new Period(b.StartTime - transition_duration, b.EndTime)));
+        }
+
         public void ApplyToScoreProcessor(ScoreProcessor scoreProcessor)
         {
             if (HiddenComboCount.Value == 0) return;
@@ -65,7 +82,9 @@ namespace osu.Game.Rulesets.Osu.Mods
 
         public virtual void Update(Playfield playfield)
         {
-            playfield.Cursor.Alpha = (float)Interpolation.Lerp(playfield.Cursor.Alpha, targetAlpha, Math.Clamp(playfield.Time.Elapsed / transition_duration, 0, 1));
+            var overrideAlpha = isBreakTime.Value || spinnerPeriods.IsInAny(playfield.Clock.CurrentTime);
+            var targetOverriddenAlpha = overrideAlpha ? 1 : targetAlpha;
+            playfield.Cursor.Alpha = (float)Interpolation.Lerp(playfield.Cursor.Alpha, targetOverriddenAlpha, Math.Clamp(playfield.Time.Elapsed / transition_duration, 0, 1));
         }
     }
 

From 1ae6621c85bd8cb24aed197b114bffab272cf0e0 Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Fri, 22 Oct 2021 15:45:48 -0700
Subject: [PATCH 0416/5547] Fix a missed toast shortcut string not localising
 correctly

---
 osu.Game/Configuration/OsuConfigManager.cs | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Configuration/OsuConfigManager.cs b/osu.Game/Configuration/OsuConfigManager.cs
index acb4a9ca02..6d37f68473 100644
--- a/osu.Game/Configuration/OsuConfigManager.cs
+++ b/osu.Game/Configuration/OsuConfigManager.cs
@@ -218,7 +218,9 @@ namespace osu.Game.Configuration
                         rawValue: skinName,
                         name: SkinSettingsStrings.SkinSectionHeader,
                         value: skinName,
-                        shortcut: $"{GlobalActionKeyBindingStrings.RandomSkin}: {LookupKeyBindings(GlobalAction.RandomSkin)}"
+                        shortcut: new TranslatableString(@"_", @"{0}: {1}",
+                            GlobalActionKeyBindingStrings.RandomSkin,
+                            LookupKeyBindings(GlobalAction.RandomSkin))
                     );
                 }),
                 new TrackedSetting<float>(OsuSetting.UIScale, scale => new SettingDescription(

From 4440b9ca11b6c5e8add43c24a4546d0b8256bd01 Mon Sep 17 00:00:00 2001
From: goodtrailer <aldenwu0@gmail.com>
Date: Sat, 23 Oct 2021 01:59:07 -0700
Subject: [PATCH 0417/5547] Change IHasRepeats.NodeSamples to IList from List

---
 osu.Game.Rulesets.Catch/Objects/JuiceStream.cs                 | 2 +-
 .../ManiaBeatmapSampleConversionTest.cs                        | 2 +-
 .../Beatmaps/Patterns/Legacy/DistanceObjectPatternGenerator.cs | 2 +-
 osu.Game.Rulesets.Mania/Objects/HoldNote.cs                    | 2 +-
 osu.Game.Rulesets.Osu/Objects/Slider.cs                        | 2 +-
 osu.Game.Rulesets.Taiko/Beatmaps/TaikoBeatmapConverter.cs      | 2 +-
 .../Rulesets/Objects/Legacy/Catch/ConvertHitObjectParser.cs    | 2 +-
 osu.Game/Rulesets/Objects/Legacy/ConvertHitObjectParser.cs     | 2 +-
 osu.Game/Rulesets/Objects/Legacy/ConvertSlider.cs              | 2 +-
 .../Rulesets/Objects/Legacy/Mania/ConvertHitObjectParser.cs    | 3 ++-
 osu.Game/Rulesets/Objects/Legacy/Osu/ConvertHitObjectParser.cs | 2 +-
 .../Rulesets/Objects/Legacy/Taiko/ConvertHitObjectParser.cs    | 2 +-
 osu.Game/Rulesets/Objects/Types/IHasRepeats.cs                 | 2 +-
 13 files changed, 14 insertions(+), 13 deletions(-)

diff --git a/osu.Game.Rulesets.Catch/Objects/JuiceStream.cs b/osu.Game.Rulesets.Catch/Objects/JuiceStream.cs
index 6d5a960f06..282afb6343 100644
--- a/osu.Game.Rulesets.Catch/Objects/JuiceStream.cs
+++ b/osu.Game.Rulesets.Catch/Objects/JuiceStream.cs
@@ -145,7 +145,7 @@ namespace osu.Game.Rulesets.Catch.Objects
 
         public double Distance => Path.Distance;
 
-        public List<IList<HitSampleInfo>> NodeSamples { get; set; } = new List<IList<HitSampleInfo>>();
+        public IList<IList<HitSampleInfo>> NodeSamples { get; set; } = new List<IList<HitSampleInfo>>();
 
         public double? LegacyLastTickOffset { get; set; }
     }
diff --git a/osu.Game.Rulesets.Mania.Tests/ManiaBeatmapSampleConversionTest.cs b/osu.Game.Rulesets.Mania.Tests/ManiaBeatmapSampleConversionTest.cs
index c8feb4ae24..9c690f360a 100644
--- a/osu.Game.Rulesets.Mania.Tests/ManiaBeatmapSampleConversionTest.cs
+++ b/osu.Game.Rulesets.Mania.Tests/ManiaBeatmapSampleConversionTest.cs
@@ -38,7 +38,7 @@ namespace osu.Game.Rulesets.Mania.Tests
         private IList<string> getSampleNames(IList<HitSampleInfo> hitSampleInfo)
             => hitSampleInfo.Select(sample => sample.LookupNames.First()).ToList();
 
-        private IList<IList<string>> getNodeSampleNames(List<IList<HitSampleInfo>> hitSampleInfo)
+        private IList<IList<string>> getNodeSampleNames(IList<IList<HitSampleInfo>> hitSampleInfo)
             => hitSampleInfo?.Select(getSampleNames)
                             .ToList();
 
diff --git a/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Legacy/DistanceObjectPatternGenerator.cs b/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Legacy/DistanceObjectPatternGenerator.cs
index 1ed045f7e0..8f18521063 100644
--- a/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Legacy/DistanceObjectPatternGenerator.cs
+++ b/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Legacy/DistanceObjectPatternGenerator.cs
@@ -488,7 +488,7 @@ namespace osu.Game.Rulesets.Mania.Beatmaps.Patterns.Legacy
         /// Retrieves the list of node samples that occur at time greater than or equal to <paramref name="time"/>.
         /// </summary>
         /// <param name="time">The time to retrieve node samples at.</param>
-        private List<IList<HitSampleInfo>> nodeSamplesAt(int time)
+        private IList<IList<HitSampleInfo>> nodeSamplesAt(int time)
         {
             if (!(HitObject is IHasPathWithRepeats curveData))
                 return null;
diff --git a/osu.Game.Rulesets.Mania/Objects/HoldNote.cs b/osu.Game.Rulesets.Mania/Objects/HoldNote.cs
index c1937af7e4..db0d3e2c5a 100644
--- a/osu.Game.Rulesets.Mania/Objects/HoldNote.cs
+++ b/osu.Game.Rulesets.Mania/Objects/HoldNote.cs
@@ -67,7 +67,7 @@ namespace osu.Game.Rulesets.Mania.Objects
             }
         }
 
-        public List<IList<HitSampleInfo>> NodeSamples { get; set; }
+        public IList<IList<HitSampleInfo>> NodeSamples { get; set; }
 
         /// <summary>
         /// The head note of the hold.
diff --git a/osu.Game.Rulesets.Osu/Objects/Slider.cs b/osu.Game.Rulesets.Osu/Objects/Slider.cs
index 07d03ee1eb..a0c503a0b0 100644
--- a/osu.Game.Rulesets.Osu/Objects/Slider.cs
+++ b/osu.Game.Rulesets.Osu/Objects/Slider.cs
@@ -79,7 +79,7 @@ namespace osu.Game.Rulesets.Osu.Objects
         /// </summary>
         internal float LazyTravelDistance;
 
-        public List<IList<HitSampleInfo>> NodeSamples { get; set; } = new List<IList<HitSampleInfo>>();
+        public IList<IList<HitSampleInfo>> NodeSamples { get; set; } = new List<IList<HitSampleInfo>>();
 
         [JsonIgnore]
         public IList<HitSampleInfo> TailSamples { get; private set; }
diff --git a/osu.Game.Rulesets.Taiko/Beatmaps/TaikoBeatmapConverter.cs b/osu.Game.Rulesets.Taiko/Beatmaps/TaikoBeatmapConverter.cs
index 32aad6c36a..0c5719f29c 100644
--- a/osu.Game.Rulesets.Taiko/Beatmaps/TaikoBeatmapConverter.cs
+++ b/osu.Game.Rulesets.Taiko/Beatmaps/TaikoBeatmapConverter.cs
@@ -81,7 +81,7 @@ namespace osu.Game.Rulesets.Taiko.Beatmaps
                 {
                     if (shouldConvertSliderToHits(obj, beatmap, distanceData, out var taikoDuration, out var tickSpacing))
                     {
-                        List<IList<HitSampleInfo>> allSamples = obj is IHasPathWithRepeats curveData ? curveData.NodeSamples : new List<IList<HitSampleInfo>>(new[] { samples });
+                        IList<IList<HitSampleInfo>> allSamples = obj is IHasPathWithRepeats curveData ? curveData.NodeSamples : new List<IList<HitSampleInfo>>(new[] { samples });
 
                         int i = 0;
 
diff --git a/osu.Game/Rulesets/Objects/Legacy/Catch/ConvertHitObjectParser.cs b/osu.Game/Rulesets/Objects/Legacy/Catch/ConvertHitObjectParser.cs
index c29179f749..2beb6bdbf2 100644
--- a/osu.Game/Rulesets/Objects/Legacy/Catch/ConvertHitObjectParser.cs
+++ b/osu.Game/Rulesets/Objects/Legacy/Catch/ConvertHitObjectParser.cs
@@ -37,7 +37,7 @@ namespace osu.Game.Rulesets.Objects.Legacy.Catch
         }
 
         protected override HitObject CreateSlider(Vector2 position, bool newCombo, int comboOffset, PathControlPoint[] controlPoints, double? length, int repeatCount,
-                                                  List<IList<HitSampleInfo>> nodeSamples)
+                                                  IList<IList<HitSampleInfo>> nodeSamples)
         {
             newCombo |= forceNewCombo;
             comboOffset += extraComboOffset;
diff --git a/osu.Game/Rulesets/Objects/Legacy/ConvertHitObjectParser.cs b/osu.Game/Rulesets/Objects/Legacy/ConvertHitObjectParser.cs
index 0942a7264d..24022b8588 100644
--- a/osu.Game/Rulesets/Objects/Legacy/ConvertHitObjectParser.cs
+++ b/osu.Game/Rulesets/Objects/Legacy/ConvertHitObjectParser.cs
@@ -408,7 +408,7 @@ namespace osu.Game.Rulesets.Objects.Legacy
         /// <param name="nodeSamples">The samples to be played when the slider nodes are hit. This includes the head and tail of the slider.</param>
         /// <returns>The hit object.</returns>
         protected abstract HitObject CreateSlider(Vector2 position, bool newCombo, int comboOffset, PathControlPoint[] controlPoints, double? length, int repeatCount,
-                                                  List<IList<HitSampleInfo>> nodeSamples);
+                                                  IList<IList<HitSampleInfo>> nodeSamples);
 
         /// <summary>
         /// Creates a legacy Spinner-type hit object.
diff --git a/osu.Game/Rulesets/Objects/Legacy/ConvertSlider.cs b/osu.Game/Rulesets/Objects/Legacy/ConvertSlider.cs
index ad191f7ff5..9ff92fcc75 100644
--- a/osu.Game/Rulesets/Objects/Legacy/ConvertSlider.cs
+++ b/osu.Game/Rulesets/Objects/Legacy/ConvertSlider.cs
@@ -24,7 +24,7 @@ namespace osu.Game.Rulesets.Objects.Legacy
 
         public double Distance => Path.Distance;
 
-        public List<IList<HitSampleInfo>> NodeSamples { get; set; }
+        public IList<IList<HitSampleInfo>> NodeSamples { get; set; }
         public int RepeatCount { get; set; }
 
         [JsonIgnore]
diff --git a/osu.Game/Rulesets/Objects/Legacy/Mania/ConvertHitObjectParser.cs b/osu.Game/Rulesets/Objects/Legacy/Mania/ConvertHitObjectParser.cs
index bc64518f40..0eb6caf8ee 100644
--- a/osu.Game/Rulesets/Objects/Legacy/Mania/ConvertHitObjectParser.cs
+++ b/osu.Game/Rulesets/Objects/Legacy/Mania/ConvertHitObjectParser.cs
@@ -4,6 +4,7 @@
 using osuTK;
 using osu.Game.Audio;
 using System.Collections.Generic;
+using osu.Framework.Bindables;
 
 namespace osu.Game.Rulesets.Objects.Legacy.Mania
 {
@@ -26,7 +27,7 @@ namespace osu.Game.Rulesets.Objects.Legacy.Mania
         }
 
         protected override HitObject CreateSlider(Vector2 position, bool newCombo, int comboOffset, PathControlPoint[] controlPoints, double? length, int repeatCount,
-                                                  List<IList<HitSampleInfo>> nodeSamples)
+                                                  IList<IList<HitSampleInfo>> nodeSamples)
         {
             return new ConvertSlider
             {
diff --git a/osu.Game/Rulesets/Objects/Legacy/Osu/ConvertHitObjectParser.cs b/osu.Game/Rulesets/Objects/Legacy/Osu/ConvertHitObjectParser.cs
index 75ecab0b8f..cb98721be5 100644
--- a/osu.Game/Rulesets/Objects/Legacy/Osu/ConvertHitObjectParser.cs
+++ b/osu.Game/Rulesets/Objects/Legacy/Osu/ConvertHitObjectParser.cs
@@ -37,7 +37,7 @@ namespace osu.Game.Rulesets.Objects.Legacy.Osu
         }
 
         protected override HitObject CreateSlider(Vector2 position, bool newCombo, int comboOffset, PathControlPoint[] controlPoints, double? length, int repeatCount,
-                                                  List<IList<HitSampleInfo>> nodeSamples)
+                                                  IList<IList<HitSampleInfo>> nodeSamples)
         {
             newCombo |= forceNewCombo;
             comboOffset += extraComboOffset;
diff --git a/osu.Game/Rulesets/Objects/Legacy/Taiko/ConvertHitObjectParser.cs b/osu.Game/Rulesets/Objects/Legacy/Taiko/ConvertHitObjectParser.cs
index 13e3e84c6a..1eafc4e68b 100644
--- a/osu.Game/Rulesets/Objects/Legacy/Taiko/ConvertHitObjectParser.cs
+++ b/osu.Game/Rulesets/Objects/Legacy/Taiko/ConvertHitObjectParser.cs
@@ -23,7 +23,7 @@ namespace osu.Game.Rulesets.Objects.Legacy.Taiko
         }
 
         protected override HitObject CreateSlider(Vector2 position, bool newCombo, int comboOffset, PathControlPoint[] controlPoints, double? length, int repeatCount,
-                                                  List<IList<HitSampleInfo>> nodeSamples)
+                                                  IList<IList<HitSampleInfo>> nodeSamples)
         {
             return new ConvertSlider
             {
diff --git a/osu.Game/Rulesets/Objects/Types/IHasRepeats.cs b/osu.Game/Rulesets/Objects/Types/IHasRepeats.cs
index 674e2aee88..2a4215b960 100644
--- a/osu.Game/Rulesets/Objects/Types/IHasRepeats.cs
+++ b/osu.Game/Rulesets/Objects/Types/IHasRepeats.cs
@@ -25,7 +25,7 @@ namespace osu.Game.Rulesets.Objects.Types
         /// n-1: The last repeat.<br />
         /// n: The last node.
         /// </summary>
-        List<IList<HitSampleInfo>> NodeSamples { get; }
+        IList<IList<HitSampleInfo>> NodeSamples { get; }
     }
 
     public static class HasRepeatsExtensions

From 0affe7b79d338e808f001476af5b2ae5cee89293 Mon Sep 17 00:00:00 2001
From: goodtrailer <aldenwu0@gmail.com>
Date: Sat, 23 Oct 2021 02:25:20 -0700
Subject: [PATCH 0418/5547] Remove unnecessary using

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

diff --git a/osu.Game/Rulesets/Objects/Legacy/Mania/ConvertHitObjectParser.cs b/osu.Game/Rulesets/Objects/Legacy/Mania/ConvertHitObjectParser.cs
index 0eb6caf8ee..386eb8d3ee 100644
--- a/osu.Game/Rulesets/Objects/Legacy/Mania/ConvertHitObjectParser.cs
+++ b/osu.Game/Rulesets/Objects/Legacy/Mania/ConvertHitObjectParser.cs
@@ -4,7 +4,6 @@
 using osuTK;
 using osu.Game.Audio;
 using System.Collections.Generic;
-using osu.Framework.Bindables;
 
 namespace osu.Game.Rulesets.Objects.Legacy.Mania
 {

From 051cc2cd92972c20027e4ef4dd4973f23cc7ac69 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 24 Oct 2021 12:47:17 +0200
Subject: [PATCH 0419/5547] Update reference to configuration population
 process in comment

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

diff --git a/osu.Game/Skinning/SkinManager.cs b/osu.Game/Skinning/SkinManager.cs
index 177dbaf28f..860d09e011 100644
--- a/osu.Game/Skinning/SkinManager.cs
+++ b/osu.Game/Skinning/SkinManager.cs
@@ -161,7 +161,7 @@ namespace osu.Game.Skinning
 
             // This function can be run on fresh import or save. The logic here ensures a skin.ini file is in a good state for both operations.
 
-            // LegacySkin will parse the skin.ini and populate `Skin.Configuration` during construction above.
+            // `Skin` will parse the skin.ini and populate `Skin.Configuration` during construction above.
             string skinIniSourcedName = instance.Configuration.SkinInfo.Name;
             string skinIniSourcedCreator = instance.Configuration.SkinInfo.Creator;
             string archiveName = item.Name.Replace(".osk", "", StringComparison.OrdinalIgnoreCase);

From 51c5d0aec7e1fc33606f6b74c3d4c524f8d3fd33 Mon Sep 17 00:00:00 2001
From: Susko3 <16479013+Susko3@users.noreply.github.com>
Date: Sun, 24 Oct 2021 12:59:19 +0200
Subject: [PATCH 0420/5547] Update to be in line with framework changes

---
 osu.Game/Database/ArchiveModelManager.cs                      | 2 +-
 osu.Game/Graphics/ScreenshotManager.cs                        | 2 +-
 osu.Game/IO/WrappedStorage.cs                                 | 4 ++--
 osu.Game/OsuGame.cs                                           | 2 +-
 osu.Game/Overlays/Settings/Sections/General/UpdateSettings.cs | 2 +-
 5 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Database/ArchiveModelManager.cs b/osu.Game/Database/ArchiveModelManager.cs
index cc25f84ecb..a0ca23eaec 100644
--- a/osu.Game/Database/ArchiveModelManager.cs
+++ b/osu.Game/Database/ArchiveModelManager.cs
@@ -467,7 +467,7 @@ namespace osu.Game.Database
             using (var outputStream = exportStorage.GetStream(filename, FileAccess.Write, FileMode.Create))
                 ExportModelTo(retrievedItem, outputStream);
 
-            exportStorage.ShowFileInNativeExplorer(filename);
+            exportStorage.PresentFileExternally(filename);
         }
 
         /// <summary>
diff --git a/osu.Game/Graphics/ScreenshotManager.cs b/osu.Game/Graphics/ScreenshotManager.cs
index 27e6e2bb1c..c21986f6c4 100644
--- a/osu.Game/Graphics/ScreenshotManager.cs
+++ b/osu.Game/Graphics/ScreenshotManager.cs
@@ -135,7 +135,7 @@ namespace osu.Game.Graphics
                     Text = $"{fileName} saved!",
                     Activated = () =>
                     {
-                        storage.ShowFileInNativeExplorer(fileName);
+                        storage.PresentFileExternally(fileName);
                         return true;
                     }
                 });
diff --git a/osu.Game/IO/WrappedStorage.cs b/osu.Game/IO/WrappedStorage.cs
index 1e2d53d6fb..aadc4e760b 100644
--- a/osu.Game/IO/WrappedStorage.cs
+++ b/osu.Game/IO/WrappedStorage.cs
@@ -70,9 +70,9 @@ namespace osu.Game.IO
         public override Stream GetStream(string path, FileAccess access = FileAccess.Read, FileMode mode = FileMode.OpenOrCreate) =>
             UnderlyingStorage.GetStream(MutatePath(path), access, mode);
 
-        public override void OpenPathInNativeExplorer(string path) => UnderlyingStorage.OpenPathInNativeExplorer(MutatePath(path));
+        public override void OpenFileExternally(string filename) => UnderlyingStorage.OpenFileExternally(MutatePath(filename));
 
-        public override void ShowFileInNativeExplorer(string filename) => UnderlyingStorage.ShowFileInNativeExplorer(MutatePath(filename));
+        public override void PresentFileExternally(string filename) => UnderlyingStorage.PresentFileExternally(MutatePath(filename));
 
         public override Storage GetStorageForDirectory(string path)
         {
diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index 4b001f03ad..985451fd6f 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -921,7 +921,7 @@ namespace osu.Game
                         Text = "Subsequent messages have been logged. Click to view log files.",
                         Activated = () =>
                         {
-                            Storage.GetStorageForDirectory(@"logs").ShowFileInNativeExplorer(logFile);
+                            Storage.GetStorageForDirectory(@"logs").PresentFileExternally(logFile);
                             return true;
                         }
                     }));
diff --git a/osu.Game/Overlays/Settings/Sections/General/UpdateSettings.cs b/osu.Game/Overlays/Settings/Sections/General/UpdateSettings.cs
index aa37748653..6bcb5ef715 100644
--- a/osu.Game/Overlays/Settings/Sections/General/UpdateSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/General/UpdateSettings.cs
@@ -67,7 +67,7 @@ namespace osu.Game.Overlays.Settings.Sections.General
                 Add(new SettingsButton
                 {
                     Text = GeneralSettingsStrings.OpenOsuFolder,
-                    Action = storage.OpenInNativeExplorer,
+                    Action = storage.PresentExternally,
                 });
 
                 Add(new SettingsButton

From 5303cae0444064e8696a8db979273ca6730155ee Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 24 Oct 2021 23:43:37 +0900
Subject: [PATCH 0421/5547] Add mention of stream close logic

---
 osu.Game/Skinning/Skin.cs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Game/Skinning/Skin.cs b/osu.Game/Skinning/Skin.cs
index d5f41f01a4..823a5d5133 100644
--- a/osu.Game/Skinning/Skin.cs
+++ b/osu.Game/Skinning/Skin.cs
@@ -47,6 +47,7 @@ namespace osu.Game.Skinning
             configurationStream ??= getConfigurationStream();
 
             if (configurationStream != null)
+                // stream will be closed after use by LineBufferedReader.
                 ParseConfigurationStream(configurationStream);
             else
                 Configuration = new SkinConfiguration();

From 26cf5370c35bf977388eaf651503d783746bb34b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 24 Oct 2021 23:48:46 +0900
Subject: [PATCH 0422/5547] Remove unused `reader` parameter

---
 osu.Game/Database/ArchiveModelManager.cs | 4 ++--
 osu.Game/Skinning/SkinManager.cs         | 4 ++--
 osu.Game/Tests/Visual/EditorTestScene.cs | 3 +--
 3 files changed, 5 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Database/ArchiveModelManager.cs b/osu.Game/Database/ArchiveModelManager.cs
index ad5bc6d420..00e1f03b92 100644
--- a/osu.Game/Database/ArchiveModelManager.cs
+++ b/osu.Game/Database/ArchiveModelManager.cs
@@ -315,7 +315,7 @@ namespace osu.Game.Database
         /// <remarks>
         ///  In the case of no matching files, a hash will be generated from the passed archive's <see cref="ArchiveReader.Name"/>.
         /// </remarks>
-        protected virtual string ComputeHash(TModel item, ArchiveReader reader = null)
+        protected virtual string ComputeHash(TModel item)
         {
             var hashableFiles = item.Files
                                     .Where(f => HashableFileTypes.Any(ext => f.Filename.EndsWith(ext, StringComparison.OrdinalIgnoreCase)))
@@ -397,7 +397,7 @@ namespace osu.Game.Database
                 LogForModel(item, @"Beginning import...");
 
                 item.Files = archive != null ? createFileInfos(archive, Files) : new List<TFileModel>();
-                item.Hash = ComputeHash(item, archive);
+                item.Hash = ComputeHash(item);
 
                 await Populate(item, archive, cancellationToken).ConfigureAwait(false);
 
diff --git a/osu.Game/Skinning/SkinManager.cs b/osu.Game/Skinning/SkinManager.cs
index 860d09e011..2187d2d875 100644
--- a/osu.Game/Skinning/SkinManager.cs
+++ b/osu.Game/Skinning/SkinManager.cs
@@ -155,7 +155,7 @@ namespace osu.Game.Skinning
 
         protected override bool HasCustomHashFunction => true;
 
-        protected override string ComputeHash(SkinInfo item, ArchiveReader reader = null)
+        protected override string ComputeHash(SkinInfo item)
         {
             var instance = GetSkin(item);
 
@@ -186,7 +186,7 @@ namespace osu.Game.Skinning
             if (skinIniSourcedName != item.Name)
                 updateSkinIniMetadata(item);
 
-            return base.ComputeHash(item, reader);
+            return base.ComputeHash(item);
         }
 
         private void updateSkinIniMetadata(SkinInfo item)
diff --git a/osu.Game/Tests/Visual/EditorTestScene.cs b/osu.Game/Tests/Visual/EditorTestScene.cs
index 798b0d01ee..4b02306d33 100644
--- a/osu.Game/Tests/Visual/EditorTestScene.cs
+++ b/osu.Game/Tests/Visual/EditorTestScene.cs
@@ -10,7 +10,6 @@ using osu.Framework.Platform;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
 using osu.Game.Database;
-using osu.Game.IO.Archives;
 using osu.Game.Online.API;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Edit;
@@ -154,7 +153,7 @@ namespace osu.Game.Tests.Visual
                 {
                 }
 
-                protected override string ComputeHash(BeatmapSetInfo item, ArchiveReader reader = null)
+                protected override string ComputeHash(BeatmapSetInfo item)
                     => string.Empty;
             }
 

From 99d01f2162bf35fd0c523e2760f257a8fd24a33b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 24 Oct 2021 23:51:49 +0900
Subject: [PATCH 0423/5547] Fix a couple of new layout inspections introduces
 in Rider 2021.3 EAP5

---
 osu.Game.Rulesets.Osu/Objects/Slider.cs            | 5 +++--
 osu.Game.Tests/Beatmaps/IO/OszArchiveReaderTest.cs | 3 +--
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Objects/Slider.cs b/osu.Game.Rulesets.Osu/Objects/Slider.cs
index 07d03ee1eb..ba817d2e40 100644
--- a/osu.Game.Rulesets.Osu/Objects/Slider.cs
+++ b/osu.Game.Rulesets.Osu/Objects/Slider.cs
@@ -151,8 +151,9 @@ namespace osu.Game.Rulesets.Osu.Objects
         {
             base.CreateNestedHitObjects(cancellationToken);
 
-            foreach (var e in
-                SliderEventGenerator.Generate(StartTime, SpanDuration, Velocity, TickDistance, Path.Distance, this.SpanCount(), LegacyLastTickOffset, cancellationToken))
+            var sliderEvents = SliderEventGenerator.Generate(StartTime, SpanDuration, Velocity, TickDistance, Path.Distance, this.SpanCount(), LegacyLastTickOffset, cancellationToken);
+
+            foreach (var e in sliderEvents)
             {
                 switch (e.Type)
                 {
diff --git a/osu.Game.Tests/Beatmaps/IO/OszArchiveReaderTest.cs b/osu.Game.Tests/Beatmaps/IO/OszArchiveReaderTest.cs
index 022b2c1a59..2c1e39c2cf 100644
--- a/osu.Game.Tests/Beatmaps/IO/OszArchiveReaderTest.cs
+++ b/osu.Game.Tests/Beatmaps/IO/OszArchiveReaderTest.cs
@@ -77,8 +77,7 @@ namespace osu.Game.Tests.Beatmaps.IO
             {
                 var reader = new ZipArchiveReader(osz);
 
-                using (var stream = new StreamReader(
-                    reader.GetStream("Soleily - Renatus (Deif) [Platter].osu")))
+                using (var stream = new StreamReader(reader.GetStream("Soleily - Renatus (Deif) [Platter].osu")))
                 {
                     Assert.AreEqual("osu file format v13", stream.ReadLine()?.Trim());
                 }

From 5f2c5770d47a9a62d951e311896e490d26210beb Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 24 Oct 2021 17:25:53 +0200
Subject: [PATCH 0424/5547] Add build-only CI jobs for mobile platforms

---
 .github/workflows/ci.yml | 42 ++++++++++++++++++++++++++++++++++++++++
 1 file changed, 42 insertions(+)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 0da1f9636b..2a3b2fd978 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -50,6 +50,48 @@ jobs:
           name: osu-test-results-${{matrix.os.prettyname}}-${{matrix.threadingMode}}
           path: ${{github.workspace}}/TestResults/TestResults-${{matrix.os.prettyname}}-${{matrix.threadingMode}}.trx
 
+  build-only-android:
+    name: Build only (Android)
+    runs-on: windows-latest
+    timeout-minutes: 60
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v2
+
+      - name: Install .NET 5.0.x
+        uses: actions/setup-dotnet@v1
+        with:
+          dotnet-version: "5.0.x"
+
+      - name: Setup MSBuild
+        uses: microsoft/setup-msbuild@v1
+
+      - name: Build
+        run: msbuild osu.Android.slnf /restore /p:Configuration=Debug
+
+  build-only-ios:
+    # While this workflow technically *can* run, it fails as iOS builds are blocked by multiple issues.
+    # See https://github.com/ppy/osu-framework/issues/4677 for the details.
+    # The job can be unblocked once those issues are resolved and game deployments can happen again.
+    if: false
+    name: Build only (iOS)
+    runs-on: macos-latest
+    timeout-minutes: 60
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v2
+
+      - name: Install .NET 5.0.x
+        uses: actions/setup-dotnet@v1
+        with:
+          dotnet-version: "5.0.x"
+
+      # Contrary to seemingly any other msbuild, msbuild running on macOS/Mono
+      # cannot accept .sln(f) files as arguments.
+      # Build just the main game for now.
+      - name: Build
+        run: msbuild osu.iOS/osu.iOS.csproj /restore /p:Configuration=Debug
+
   inspect-code:
     name: Code Quality
     runs-on: ubuntu-latest

From 00732822c34a9dcd4ae7716f9b8141a90e1307a7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 24 Oct 2021 17:41:55 +0200
Subject: [PATCH 0425/5547] Replace insufficiently specific exception type

Resolves compilation failures for the newly-added Android build-only CI
job caused by inspection CA2201 ("Exception type System.Exception is not
sufficiently specific").
---
 osu.Game.Tests/Visual/Online/TestSceneChatOverlay.cs | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneChatOverlay.cs b/osu.Game.Tests/Visual/Online/TestSceneChatOverlay.cs
index 9562b41363..ab4e1b4457 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneChatOverlay.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneChatOverlay.cs
@@ -4,6 +4,7 @@
 using System;
 using System.Collections.Generic;
 using System.Linq;
+using System.Net;
 using JetBrains.Annotations;
 using NUnit.Framework;
 using osu.Framework.Allocation;
@@ -105,7 +106,7 @@ namespace osu.Game.Tests.Visual.Online
                             }
                             else
                             {
-                                getUser.TriggerFailure(new Exception());
+                                getUser.TriggerFailure(new WebException());
                             }
 
                             return true;

From 207ccc4756474cea1a57b056f5404593433089d2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 17 Oct 2021 14:15:36 +0200
Subject: [PATCH 0426/5547] Add test scene for beatmapset online status pill
 display

---
 .../TestSceneBeatmapSetOnlineStatusPill.cs    | 32 +++++++++++++++++++
 1 file changed, 32 insertions(+)
 create mode 100644 osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapSetOnlineStatusPill.cs

diff --git a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapSetOnlineStatusPill.cs b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapSetOnlineStatusPill.cs
new file mode 100644
index 0000000000..7bbf3c629b
--- /dev/null
+++ b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapSetOnlineStatusPill.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;
+using System.Linq;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
+using osu.Game.Beatmaps;
+using osu.Game.Beatmaps.Drawables;
+using osu.Game.Tests.Visual.UserInterface;
+using osuTK;
+
+namespace osu.Game.Tests.Visual.Beatmaps
+{
+    public class TestSceneBeatmapSetOnlineStatusPill : ThemeComparisonTestScene
+    {
+        protected override Drawable CreateContent() => new FillFlowContainer
+        {
+            AutoSizeAxes = Axes.Both,
+            Anchor = Anchor.Centre,
+            Origin = Anchor.Centre,
+            Direction = FillDirection.Vertical,
+            Spacing = new Vector2(0, 10),
+            ChildrenEnumerable = Enum.GetValues(typeof(BeatmapSetOnlineStatus)).Cast<BeatmapSetOnlineStatus>().Select(status => new BeatmapSetOnlineStatusPill
+            {
+                Anchor = Anchor.Centre,
+                Origin = Anchor.Centre,
+                Status = status
+            })
+        };
+    }
+}

From 5ab3337a105a104074e1b019ea93bae329021402 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 17 Oct 2021 14:42:04 +0200
Subject: [PATCH 0427/5547] Update beatmap set status pill appearance

---
 .../Drawables/BeatmapSetOnlineStatusPill.cs   | 46 ++++++++++++++-----
 osu.Game/Graphics/OsuColour.cs                | 36 +++++++++++++++
 .../BeatmapSet/BeatmapSetHeaderContent.cs     |  1 -
 3 files changed, 71 insertions(+), 12 deletions(-)

diff --git a/osu.Game/Beatmaps/Drawables/BeatmapSetOnlineStatusPill.cs b/osu.Game/Beatmaps/Drawables/BeatmapSetOnlineStatusPill.cs
index ffc010b3a3..bc8af90069 100644
--- a/osu.Game/Beatmaps/Drawables/BeatmapSetOnlineStatusPill.cs
+++ b/osu.Game/Beatmaps/Drawables/BeatmapSetOnlineStatusPill.cs
@@ -1,6 +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 enable
+
+using osu.Framework.Allocation;
 using osu.Framework.Extensions;
 using osu.Framework.Extensions.LocalisationExtensions;
 using osu.Framework.Graphics;
@@ -8,15 +11,13 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
+using osu.Game.Overlays;
 using osuTK.Graphics;
 
 namespace osu.Game.Beatmaps.Drawables
 {
     public class BeatmapSetOnlineStatusPill : CircularContainer
     {
-        private readonly OsuSpriteText statusText;
-        private readonly Box background;
-
         private BeatmapSetOnlineStatus status;
 
         public BeatmapSetOnlineStatus Status
@@ -29,8 +30,8 @@ namespace osu.Game.Beatmaps.Drawables
 
                 status = value;
 
-                Alpha = value == BeatmapSetOnlineStatus.None ? 0 : 1;
-                statusText.Text = value.GetLocalisableDescription().ToUpper();
+                if (IsLoaded)
+                    updateState();
             }
         }
 
@@ -46,11 +47,14 @@ namespace osu.Game.Beatmaps.Drawables
             set => statusText.Padding = value;
         }
 
-        public Color4 BackgroundColour
-        {
-            get => background.Colour;
-            set => background.Colour = value;
-        }
+        private readonly OsuSpriteText statusText;
+        private readonly Box background;
+
+        [Resolved]
+        private OsuColour colours { get; set; } = null!;
+
+        [Resolved(CanBeNull = true)]
+        private OverlayColourProvider? colourProvider { get; set; }
 
         public BeatmapSetOnlineStatusPill()
         {
@@ -63,7 +67,6 @@ namespace osu.Game.Beatmaps.Drawables
                 {
                     RelativeSizeAxes = Axes.Both,
                     Colour = Color4.Black,
-                    Alpha = 0.5f,
                 },
                 statusText = new OsuSpriteText
                 {
@@ -74,6 +77,27 @@ namespace osu.Game.Beatmaps.Drawables
             };
 
             Status = BeatmapSetOnlineStatus.None;
+            TextPadding = new MarginPadding { Horizontal = 5, Bottom = 1 };
+        }
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+            updateState();
+        }
+
+        private void updateState()
+        {
+            Alpha = Status == BeatmapSetOnlineStatus.None ? 0 : 1;
+
+            statusText.Text = Status.GetLocalisableDescription().ToUpper();
+
+            if (colourProvider != null)
+                statusText.Colour = status == BeatmapSetOnlineStatus.Graveyard ? colourProvider.Background1 : colourProvider.Background3;
+            else
+                statusText.Colour = status == BeatmapSetOnlineStatus.Graveyard ? colours.GreySeafoamLight : Color4.Black;
+
+            background.Colour = OsuColour.ForBeatmapSetOnlineStatus(Status) ?? colourProvider?.Light1 ?? colours.GreySeafoamLighter;
         }
     }
 }
diff --git a/osu.Game/Graphics/OsuColour.cs b/osu.Game/Graphics/OsuColour.cs
index 40d163635a..3aa4dbf1d8 100644
--- a/osu.Game/Graphics/OsuColour.cs
+++ b/osu.Game/Graphics/OsuColour.cs
@@ -118,6 +118,42 @@ namespace osu.Game.Graphics
             }
         }
 
+        /// <summary>
+        /// Retrieves a colour for the given <see cref="BeatmapSetOnlineStatus"/>.
+        /// A <see langword="null"/> value indicates that a "background" shade from the local <see cref="OverlayColourProvider"/>
+        /// (or another fallback colour) should be used.
+        /// </summary>
+        /// <remarks>
+        /// Sourced from web: https://github.com/ppy/osu-web/blob/007eebb1916ed5cb6a7866d82d8011b1060a945e/resources/assets/less/layout.less#L36-L50
+        /// </remarks>
+        public static Color4? ForBeatmapSetOnlineStatus(BeatmapSetOnlineStatus status)
+        {
+            switch (status)
+            {
+                case BeatmapSetOnlineStatus.Ranked:
+                case BeatmapSetOnlineStatus.Approved:
+                    return Color4Extensions.FromHex(@"b3ff66");
+
+                case BeatmapSetOnlineStatus.Loved:
+                    return Color4Extensions.FromHex(@"ff66ab");
+
+                case BeatmapSetOnlineStatus.Qualified:
+                    return Color4Extensions.FromHex(@"66ccff");
+
+                case BeatmapSetOnlineStatus.Pending:
+                    return Color4Extensions.FromHex(@"ffd966");
+
+                case BeatmapSetOnlineStatus.WIP:
+                    return Color4Extensions.FromHex(@"ff9966");
+
+                case BeatmapSetOnlineStatus.Graveyard:
+                    return Color4.Black;
+
+                default:
+                    return null;
+            }
+        }
+
         /// <summary>
         /// Returns a foreground text colour that is supposed to contrast well with
         /// the supplied <paramref name="backgroundColour"/>.
diff --git a/osu.Game/Overlays/BeatmapSet/BeatmapSetHeaderContent.cs b/osu.Game/Overlays/BeatmapSet/BeatmapSetHeaderContent.cs
index c1029923f7..df88b06879 100644
--- a/osu.Game/Overlays/BeatmapSet/BeatmapSetHeaderContent.cs
+++ b/osu.Game/Overlays/BeatmapSet/BeatmapSetHeaderContent.cs
@@ -220,7 +220,6 @@ namespace osu.Game.Overlays.BeatmapSet
         private void load(OverlayColourProvider colourProvider)
         {
             coverGradient.Colour = ColourInfo.GradientVertical(colourProvider.Background6.Opacity(0.3f), colourProvider.Background6.Opacity(0.8f));
-            onlineStatusPill.BackgroundColour = colourProvider.Background6;
 
             State.BindValueChanged(_ => updateDownloadButtons());
 

From feedd53a53d86945fe0460b73abd135f16474e5a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 17 Oct 2021 14:55:52 +0200
Subject: [PATCH 0428/5547] Add support for setting fixed size of status pill

---
 .../TestSceneBeatmapSetOnlineStatusPill.cs    | 16 ++++++++++++
 .../Drawables/BeatmapSetOnlineStatusPill.cs   | 25 +++++++++++++++++++
 2 files changed, 41 insertions(+)

diff --git a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapSetOnlineStatusPill.cs b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapSetOnlineStatusPill.cs
index 7bbf3c629b..2d61385269 100644
--- a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapSetOnlineStatusPill.cs
+++ b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapSetOnlineStatusPill.cs
@@ -2,11 +2,16 @@
 // 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.Extensions.IEnumerableExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
+using osu.Framework.Testing;
 using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.Drawables;
+using osu.Game.Overlays;
 using osu.Game.Tests.Visual.UserInterface;
 using osuTK;
 
@@ -28,5 +33,16 @@ namespace osu.Game.Tests.Visual.Beatmaps
                 Status = status
             })
         };
+
+        private IEnumerable<BeatmapSetOnlineStatusPill> statusPills => this.ChildrenOfType<BeatmapSetOnlineStatusPill>();
+
+        [Test]
+        public void TestFixedWidth()
+        {
+            AddStep("create themed content", () => CreateThemedContent(OverlayColourScheme.Red));
+
+            AddStep("set fixed width", () => statusPills.ForEach(pill => pill.FixedWidth = 90));
+            AddStep("unset fixed width", () => statusPills.ForEach(pill => pill.FixedWidth = null));
+        }
     }
 }
diff --git a/osu.Game/Beatmaps/Drawables/BeatmapSetOnlineStatusPill.cs b/osu.Game/Beatmaps/Drawables/BeatmapSetOnlineStatusPill.cs
index bc8af90069..848bab6394 100644
--- a/osu.Game/Beatmaps/Drawables/BeatmapSetOnlineStatusPill.cs
+++ b/osu.Game/Beatmaps/Drawables/BeatmapSetOnlineStatusPill.cs
@@ -47,6 +47,31 @@ namespace osu.Game.Beatmaps.Drawables
             set => statusText.Padding = value;
         }
 
+        private float? fixedWidth;
+
+        /// <summary>
+        /// When set to a non-<see langword="null"/> value, the pill will be forcibly sized to the given width.
+        /// When set to a <see langword="null"/> value, the pill will autosize to its contents.
+        /// </summary>
+        public float? FixedWidth
+        {
+            get => fixedWidth;
+            set
+            {
+                fixedWidth = value;
+
+                if (fixedWidth == null)
+                {
+                    AutoSizeAxes = Axes.Both;
+                }
+                else
+                {
+                    AutoSizeAxes = Axes.Y;
+                    Width = fixedWidth.Value;
+                }
+            }
+        }
+
         private readonly OsuSpriteText statusText;
         private readonly Box background;
 

From b8308b971545ba7589b66aa74fed01acc80febc9 Mon Sep 17 00:00:00 2001
From: Roxie is Flux3on <28934062+Flux3on@users.noreply.github.com>
Date: Sun, 24 Oct 2021 15:28:38 -0700
Subject: [PATCH 0429/5547] Corrected spinner judgement positions. For some
 reason, spinner judgements would stack from the top left in an awkward
 fashion. This patch ensures that the judgement location will always be in the
 centre of the screen.

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

diff --git a/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableOsuJudgement.cs b/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableOsuJudgement.cs
index e4df41a4fe..4762285b37 100644
--- a/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableOsuJudgement.cs
+++ b/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableOsuJudgement.cs
@@ -39,7 +39,13 @@ namespace osu.Game.Rulesets.Osu.Objects.Drawables
 
             if (JudgedObject?.HitObject is OsuHitObject osuObject)
             {
-                Position = osuObject.StackedEndPosition;
+                if (JudgedObject?.HitObject is Spinner)
+                {
+                    Position = osuObject.Position;
+                } else
+                {
+                    Position = osuObject.StackedEndPosition;
+                }
                 Scale = new Vector2(osuObject.Scale);
             }
         }

From 386910ca2ed4998c4a2c3b56b0e9078bce636b44 Mon Sep 17 00:00:00 2001
From: Roxie is Flux3on <28934062+Flux3on@users.noreply.github.com>
Date: Sun, 24 Oct 2021 15:29:47 -0700
Subject: [PATCH 0430/5547] Cut amount of code down for the spinner judgement
 fix

---
 .../Objects/Drawables/DrawableOsuJudgement.cs                | 5 +----
 1 file changed, 1 insertion(+), 4 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableOsuJudgement.cs b/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableOsuJudgement.cs
index 4762285b37..79b8320136 100644
--- a/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableOsuJudgement.cs
+++ b/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableOsuJudgement.cs
@@ -40,12 +40,9 @@ namespace osu.Game.Rulesets.Osu.Objects.Drawables
             if (JudgedObject?.HitObject is OsuHitObject osuObject)
             {
                 if (JudgedObject?.HitObject is Spinner)
-                {
                     Position = osuObject.Position;
-                } else
-                {
+                else
                     Position = osuObject.StackedEndPosition;
-                }
                 Scale = new Vector2(osuObject.Scale);
             }
         }

From 9f62d1d98c71d763d68ef3837c5e0052a4a68a41 Mon Sep 17 00:00:00 2001
From: Jason Won <jasonwon628@gmail.com>
Date: Sun, 24 Oct 2021 11:41:35 -0400
Subject: [PATCH 0431/5547] add tests for NoScope

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

diff --git a/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModNoScope.cs b/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModNoScope.cs
new file mode 100644
index 0000000000..0d0fefe0ff
--- /dev/null
+++ b/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModNoScope.cs
@@ -0,0 +1,150 @@
+// 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.Framework.Utils;
+using osu.Framework.Testing;
+using osu.Game.Beatmaps;
+using osu.Game.Beatmaps.Timing;
+using osu.Game.Rulesets.Objects;
+using osu.Game.Rulesets.Osu.Mods;
+using osu.Game.Rulesets.Osu.Objects;
+using osu.Game.Rulesets.Osu.Objects.Drawables;
+using osuTK;
+
+namespace osu.Game.Rulesets.Osu.Tests.Mods
+{
+    public class TestSceneOsuModNoScope : OsuModTestScene
+    {
+        [Test]
+        public void TestVisibleDuringBreak()
+        {
+            CreateModTest(new ModTestData
+            {
+                Mod = new OsuModNoScope
+                {
+                    HiddenComboCount = { Value = 0 },
+                },
+                Autoplay = true,
+                PassCondition = () => true,
+                Beatmap = new Beatmap
+                {
+                    HitObjects = new List<HitObject>
+                    {
+                        new HitCircle
+                        {
+                            Position = new Vector2(300, 192),
+                            StartTime = 1000,
+                        },
+                        new HitCircle
+                        {
+                            Position = new Vector2(300, 192),
+                            StartTime = 5000,
+                        }
+                    },
+                    Breaks = new List<BreakPeriod>
+                    {
+                        new BreakPeriod(2000, 4000),
+                    }
+                }
+            });
+
+            AddUntilStep("wait for cursor to hide", () => cursorAlphaAlmostEquals(0));
+            AddUntilStep("wait for start of break", isBreak);
+            AddUntilStep("wait for cursor to show", () => cursorAlphaAlmostEquals(1));
+            AddUntilStep("wait for end of break", () => !isBreak());
+            AddUntilStep("wait for cursor to hide", () => cursorAlphaAlmostEquals(0));
+        }
+
+        [Test]
+        public void TestVisibleDuringSpinner()
+        {
+            CreateModTest(new ModTestData
+            {
+                Mod = new OsuModNoScope
+                {
+                    HiddenComboCount = { Value = 0 },
+                },
+                Autoplay = true,
+                PassCondition = () => true,
+                Beatmap = new Beatmap
+                {
+                    HitObjects = new List<HitObject>
+                    {
+                        new HitCircle
+                        {
+                            Position = new Vector2(300, 192),
+                            StartTime = 1000,
+                        },
+                        new Spinner
+                        {
+                            Position = new Vector2(256, 192),
+                            StartTime = 2000,
+                            Duration = 2000,
+                        },
+                        new HitCircle
+                        {
+                            Position = new Vector2(300, 192),
+                            StartTime = 5000,
+                        }
+                    }
+                }
+            });
+
+            AddUntilStep("wait for cursor to hide", () => cursorAlphaAlmostEquals(0));
+            AddUntilStep("wait for start of spinner", isSpinning);
+            AddUntilStep("wait for cursor to show", () => cursorAlphaAlmostEquals(1));
+            AddUntilStep("wait for end of spinner", () => !isSpinning());
+            AddUntilStep("wait for cursor to hide", () => cursorAlphaAlmostEquals(0));
+        }
+
+        [Test]
+        public void TestVisibleAfterComboBreak()
+        {
+            CreateModTest(new ModTestData
+            {
+                Mod = new OsuModNoScope
+                {
+                    HiddenComboCount = { Value = 2 },
+                },
+                Autoplay = true,
+                PassCondition = () => true,
+                Beatmap = new Beatmap
+                {
+                    HitObjects = new List<HitObject>
+                    {
+                        new HitCircle
+                        {
+                            Position = new Vector2(100, 192),
+                            StartTime = 1000,
+                        },
+                        new HitCircle
+                        {
+                            Position = new Vector2(150, 192),
+                            StartTime = 3000,
+                        },
+                        new HitCircle
+                        {
+                            Position = new Vector2(200, 192),
+                            StartTime = 5000,
+                        },
+                    }
+                }
+            });
+
+            AddAssert("cursor must start visible", () => cursorAlphaAlmostEquals(1));
+            AddUntilStep("wait for combo", () => Player.ScoreProcessor.Combo.Value >= 2);
+            AddAssert("cursor must dim after combo", () => !cursorAlphaAlmostEquals(1));
+            AddStep("break combo", () => Player.ScoreProcessor.Combo.Set(0));
+            AddUntilStep("wait for cursor to show", () => cursorAlphaAlmostEquals(1));
+        }
+
+        private bool isSpinning() => Player.ChildrenOfType<DrawableSpinner>().SingleOrDefault()?.Progress > 0;
+
+        private bool isBreak() => Player.IsBreakTime.Value;
+
+        private bool cursorAlphaAlmostEquals(float alpha) => Precision.AlmostEquals(Player.DrawableRuleset.Cursor.Alpha, alpha);
+    }
+}

From 861cd4852a41ad12de76604860e2c88ee2e06089 Mon Sep 17 00:00:00 2001
From: Roxie is Flux3on <28934062+Flux3on@users.noreply.github.com>
Date: Sun, 24 Oct 2021 18:14:37 -0700
Subject: [PATCH 0432/5547] Made StackedEndPosition virtual Done to allow
 overriding in the other object classes.

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

diff --git a/osu.Game.Rulesets.Osu/Objects/OsuHitObject.cs b/osu.Game.Rulesets.Osu/Objects/OsuHitObject.cs
index 7c45b2bc07..a9b4027ea7 100644
--- a/osu.Game.Rulesets.Osu/Objects/OsuHitObject.cs
+++ b/osu.Game.Rulesets.Osu/Objects/OsuHitObject.cs
@@ -49,7 +49,7 @@ namespace osu.Game.Rulesets.Osu.Objects
 
         public virtual Vector2 EndPosition => Position;
 
-        public Vector2 StackedEndPosition => EndPosition + StackOffset;
+        public virtual Vector2 StackedEndPosition => EndPosition + StackOffset;
 
         public readonly Bindable<int> StackHeightBindable = new Bindable<int>();
 

From a8e3d0baccdbda1da28a4821dc89c620565ba8e9 Mon Sep 17 00:00:00 2001
From: Roxie is Flux3on <28934062+Flux3on@users.noreply.github.com>
Date: Sun, 24 Oct 2021 18:15:40 -0700
Subject: [PATCH 0433/5547] Added an override for StackedEndPosition This
 ensures the spinner's hit judgement will always be centre instead of in the
 top left corner.

---
 osu.Game.Rulesets.Osu/Objects/Spinner.cs | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/osu.Game.Rulesets.Osu/Objects/Spinner.cs b/osu.Game.Rulesets.Osu/Objects/Spinner.cs
index f85dc0d391..efaea88674 100644
--- a/osu.Game.Rulesets.Osu/Objects/Spinner.cs
+++ b/osu.Game.Rulesets.Osu/Objects/Spinner.cs
@@ -8,6 +8,7 @@ using osu.Game.Rulesets.Judgements;
 using osu.Game.Rulesets.Objects.Types;
 using osu.Game.Rulesets.Osu.Judgements;
 using osu.Game.Rulesets.Scoring;
+using osuTK;
 
 namespace osu.Game.Rulesets.Osu.Objects
 {
@@ -31,6 +32,8 @@ namespace osu.Game.Rulesets.Osu.Objects
         /// </summary>
         public int MaximumBonusSpins { get; protected set; } = 1;
 
+        public override Vector2 StackedEndPosition => EndPosition;
+
         protected override void ApplyDefaultsToSelf(ControlPointInfo controlPointInfo, IBeatmapDifficultyInfo difficulty)
         {
             base.ApplyDefaultsToSelf(controlPointInfo, difficulty);

From 0c57453f4d5adb7d374775879e2b38a47c61306c Mon Sep 17 00:00:00 2001
From: Roxie is Flux3on <28934062+Flux3on@users.noreply.github.com>
Date: Sun, 24 Oct 2021 18:16:14 -0700
Subject: [PATCH 0434/5547] Reverted special case code changes As requested by
 @frenzibyte

---
 .../Objects/Drawables/DrawableOsuJudgement.cs                | 5 +----
 1 file changed, 1 insertion(+), 4 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableOsuJudgement.cs b/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableOsuJudgement.cs
index 79b8320136..e4df41a4fe 100644
--- a/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableOsuJudgement.cs
+++ b/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableOsuJudgement.cs
@@ -39,10 +39,7 @@ namespace osu.Game.Rulesets.Osu.Objects.Drawables
 
             if (JudgedObject?.HitObject is OsuHitObject osuObject)
             {
-                if (JudgedObject?.HitObject is Spinner)
-                    Position = osuObject.Position;
-                else
-                    Position = osuObject.StackedEndPosition;
+                Position = osuObject.StackedEndPosition;
                 Scale = new Vector2(osuObject.Scale);
             }
         }

From 27d4201dae129e8ad27ed8522b29b500e40d5ccd Mon Sep 17 00:00:00 2001
From: Roxie Wattz <roxie.wattz@gmail.com>
Date: Sun, 24 Oct 2021 19:42:37 -0700
Subject: [PATCH 0435/5547] Added a spinner spam test Shoutout to Echo for
 making Wizards in Winter x3

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

diff --git a/osu.Game.Rulesets.Osu.Tests/TestSceneSpinnerSpam.cs b/osu.Game.Rulesets.Osu.Tests/TestSceneSpinnerSpam.cs
new file mode 100644
index 0000000000..26729979f9
--- /dev/null
+++ b/osu.Game.Rulesets.Osu.Tests/TestSceneSpinnerSpam.cs
@@ -0,0 +1,35 @@
+// 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.Game.Beatmaps;
+using osu.Game.Rulesets.Osu.Objects;
+using osuTK;
+
+namespace osu.Game.Rulesets.Osu.Tests
+{
+    [TestFixture]
+    public class TestSceneSpinnerSpam : TestSceneOsuPlayer
+    {
+        protected override IBeatmap CreateBeatmap(RulesetInfo ruleset)
+        {
+            var beatmap = new Beatmap
+            {
+                BeatmapInfo = new BeatmapInfo
+                {
+                    BaseDifficulty = new BeatmapDifficulty { OverallDifficulty = 10 },
+                    Ruleset = ruleset
+                }
+            };
+
+            for (int i = 0; i < 512; i++)
+            {
+                if (i % 32 < 20)
+                    beatmap.HitObjects.Add(new Spinner { Position = new Vector2(256, 192), StartTime = i * 200, EndTime = (i * 200) + 100 });
+            }
+
+            return beatmap;
+        }
+    }
+}

From 78edc7554e65898cefa200c744abf2b45b631825 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 25 Oct 2021 12:05:34 +0900
Subject: [PATCH 0436/5547] Fix `BeatmapSetInfo`'s `Status` value being marked
 as non-databased

---
 osu.Game/Beatmaps/BeatmapSetInfo.cs | 1 -
 1 file changed, 1 deletion(-)

diff --git a/osu.Game/Beatmaps/BeatmapSetInfo.cs b/osu.Game/Beatmaps/BeatmapSetInfo.cs
index 79cd8253f7..0c032e1482 100644
--- a/osu.Game/Beatmaps/BeatmapSetInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapSetInfo.cs
@@ -117,7 +117,6 @@ namespace osu.Game.Beatmaps
         [JsonIgnore]
         public DateTimeOffset? LastUpdated => OnlineInfo.LastUpdated;
 
-        [NotMapped]
         [JsonIgnore]
         public BeatmapSetOnlineStatus Status { get; set; } = BeatmapSetOnlineStatus.None;
 

From 6b9e8dbd2e4ab90c57c1bb16bd20d22d6c56e81a Mon Sep 17 00:00:00 2001
From: Roxie Wattz <roxie.wattz@gmail.com>
Date: Sun, 24 Oct 2021 21:34:40 -0700
Subject: [PATCH 0437/5547] Added the ouendan 2 style hidden Added as an option
 for nostalgia nerds like me

---
 osu.Game.Rulesets.Osu/Mods/OsuModHidden.cs | 24 ++++++++++++++++------
 1 file changed, 18 insertions(+), 6 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModHidden.cs b/osu.Game.Rulesets.Osu/Mods/OsuModHidden.cs
index 9c7784a00a..59d6769e2c 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModHidden.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModHidden.cs
@@ -5,6 +5,8 @@ using System;
 using System.Diagnostics;
 using System.Linq;
 using osu.Framework.Graphics;
+using osu.Framework.Bindables;
+using osu.Game.Configuration;
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Objects;
@@ -13,10 +15,14 @@ using osu.Game.Rulesets.Osu.Objects.Drawables;
 using osu.Game.Rulesets.Osu.Objects;
 using osu.Game.Rulesets.Osu.Skinning;
 
+
 namespace osu.Game.Rulesets.Osu.Mods
 {
     public class OsuModHidden : ModHidden, IHidesApproachCircles
     {
+        [SettingSource("Don't fade out hit circles", "This makes the hidden mod only remove approach circles.")]
+        public Bindable<bool> NoHitCircles { get; } = new BindableBool(false);
+
         public override string Description => @"Play with no approach circles and fading circles/sliders.";
         public override double ScoreMultiplier => 1.06;
 
@@ -65,14 +71,16 @@ namespace osu.Game.Rulesets.Osu.Mods
             {
                 case DrawableSliderTail _:
                     using (drawableObject.BeginAbsoluteSequence(fadeStartTime))
-                        drawableObject.FadeOut(fadeDuration);
+                        if (!NoHitCircles.Value)
+                            drawableObject.FadeOut(fadeDuration);
 
                     break;
 
                 case DrawableSliderRepeat sliderRepeat:
                     using (drawableObject.BeginAbsoluteSequence(fadeStartTime))
                         // only apply to circle piece – reverse arrow is not affected by hidden.
-                        sliderRepeat.CirclePiece.FadeOut(fadeDuration);
+                        if (!NoHitCircles.Value)
+                            sliderRepeat.CirclePiece.FadeOut(fadeDuration);
 
                     break;
 
@@ -82,7 +90,8 @@ namespace osu.Game.Rulesets.Osu.Mods
                     if (increaseVisibility)
                     {
                         // only fade the circle piece (not the approach circle) for the increased visibility object.
-                        fadeTarget = circle.CirclePiece;
+                        if (!NoHitCircles.Value)
+                            fadeTarget = circle.CirclePiece;
                     }
                     else
                     {
@@ -92,18 +101,21 @@ namespace osu.Game.Rulesets.Osu.Mods
                     }
 
                     using (drawableObject.BeginAbsoluteSequence(fadeStartTime))
-                        fadeTarget.FadeOut(fadeDuration);
+                        if (!NoHitCircles.Value)
+                            fadeTarget.FadeOut(fadeDuration);
                     break;
 
                 case DrawableSlider slider:
                     using (slider.BeginAbsoluteSequence(fadeStartTime))
-                        slider.Body.FadeOut(fadeDuration, Easing.Out);
+                        if (!NoHitCircles.Value)
+                            slider.Body.FadeOut(fadeDuration, Easing.Out);
 
                     break;
 
                 case DrawableSliderTick sliderTick:
                     using (sliderTick.BeginAbsoluteSequence(fadeStartTime))
-                        sliderTick.FadeOut(fadeDuration);
+                        if (!NoHitCircles.Value)
+                            sliderTick.FadeOut(fadeDuration);
 
                     break;
 

From d1b720af167141c44566ceb1ce24b5eed04677fb Mon Sep 17 00:00:00 2001
From: Roxie Wattz <roxie.wattz@gmail.com>
Date: Sun, 24 Oct 2021 21:51:12 -0700
Subject: [PATCH 0438/5547] Add Ouendan 2 reference

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

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModHidden.cs b/osu.Game.Rulesets.Osu/Mods/OsuModHidden.cs
index 59d6769e2c..a57b22451d 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModHidden.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModHidden.cs
@@ -20,7 +20,7 @@ namespace osu.Game.Rulesets.Osu.Mods
 {
     public class OsuModHidden : ModHidden, IHidesApproachCircles
     {
-        [SettingSource("Don't fade out hit circles", "This makes the hidden mod only remove approach circles.")]
+        [SettingSource("Don't fade out hit circles", "This makes the hidden mod only remove approach circles, similar to Ouendan 2's Easy difficulties.")]
         public Bindable<bool> NoHitCircles { get; } = new BindableBool(false);
 
         public override string Description => @"Play with no approach circles and fading circles/sliders.";

From 03896fd2ebf219489deb289942c6f0c99e568304 Mon Sep 17 00:00:00 2001
From: Roxie Wattz <roxie.wattz@gmail.com>
Date: Sun, 24 Oct 2021 22:17:55 -0700
Subject: [PATCH 0439/5547] Added test for Ouendan 2 style Hidden mod

---
 .../Mods/TestSceneOsuModHidden.cs             | 36 +++++++++++++++++++
 1 file changed, 36 insertions(+)

diff --git a/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModHidden.cs b/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModHidden.cs
index ed9da36b05..f25df90737 100644
--- a/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModHidden.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModHidden.cs
@@ -117,6 +117,42 @@ namespace osu.Game.Rulesets.Osu.Tests.Mods
             PassCondition = checkSomeHit
         });
 
+        [Test]
+        public void OuendanTwoHidden() => CreateModTest(new ModTestData
+        {
+            Mod = new OsuModHidden { NoHitCircles = { Value = true } },
+            Autoplay = true,
+            Beatmap = new Beatmap
+            {
+                HitObjects = new List<HitObject>
+                {
+                    new HitCircle
+                    {
+                        StartTime = 1000,
+                        Position = new Vector2(206,142)
+                    },
+                    new HitCircle
+                    {
+                        StartTime = 2000,
+                        Position = new Vector2(306,142)
+                    },
+                    new Slider
+                    {
+                        StartTime = 3000,
+                        Position = new Vector2(156,242),
+                        Path = new SliderPath(PathType.Linear, new[] { Vector2.Zero, new Vector2(200,0), })
+                    },
+                    new Spinner
+                    {
+                        Position = new Vector2(256,192),
+                        StartTime = 7000,
+                        EndTime = 9000
+                    }
+                }
+            },
+            PassCondition = checkSomeHit
+        });
+
         private bool checkSomeHit() => Player.ScoreProcessor.JudgedHits >= 4;
 
         private bool objectWithIncreasedVisibilityHasIndex(int index)

From 19312435d0b53de9e2619aedc75beef9005b5b8e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 25 Oct 2021 13:47:12 +0900
Subject: [PATCH 0440/5547] Add ability to make test `APIBeatmaps` from test
 scenes

Allow tests to create a sample `APIBeatmapSet`

One step towards removing calls to `ToBeatmap` / `ToBeatmapSet`.
---
 .../Online/TestSceneBeatmapListingOverlay.cs  | 26 +++-------
 .../API/Requests/Responses/APIBeatmapSet.cs   |  6 +--
 osu.Game/Tests/Visual/OsuTestScene.cs         | 51 +++++++++++++++++++
 3 files changed, 60 insertions(+), 23 deletions(-)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneBeatmapListingOverlay.cs b/osu.Game.Tests/Visual/Online/TestSceneBeatmapListingOverlay.cs
index 963809ebe1..7042f1e4fe 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneBeatmapListingOverlay.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneBeatmapListingOverlay.cs
@@ -7,14 +7,12 @@ using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Testing;
-using osu.Game.Beatmaps;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays;
 using osu.Game.Overlays.BeatmapListing;
-using osu.Game.Rulesets;
 using osu.Game.Scoring;
 using osu.Game.Users;
 using osuTK.Input;
@@ -92,7 +90,7 @@ namespace osu.Game.Tests.Visual.Online
         {
             AddAssert("is visible", () => overlay.State.Value == Visibility.Visible);
 
-            AddStep("show many results", () => fetchFor(Enumerable.Repeat(CreateBeatmap(Ruleset.Value).BeatmapInfo.BeatmapSet, 100).ToArray()));
+            AddStep("show many results", () => fetchFor(Enumerable.Repeat(CreateAPIBeatmapSet(Ruleset.Value), 10).ToArray()));
 
             AddUntilStep("placeholder hidden", () => !overlay.ChildrenOfType<BeatmapListingOverlay.NotFoundDrawable>().Any(d => d.IsPresent));
 
@@ -114,7 +112,7 @@ namespace osu.Game.Tests.Visual.Online
             AddStep("fetch for 0 beatmaps", () => fetchFor());
             AddUntilStep("placeholder shown", () => overlay.ChildrenOfType<BeatmapListingOverlay.NotFoundDrawable>().SingleOrDefault()?.IsPresent == true);
 
-            AddStep("fetch for 1 beatmap", () => fetchFor(CreateBeatmap(Ruleset.Value).BeatmapInfo.BeatmapSet));
+            AddStep("fetch for 1 beatmap", () => fetchFor(CreateAPIBeatmapSet(Ruleset.Value)));
             AddUntilStep("placeholder hidden", () => !overlay.ChildrenOfType<BeatmapListingOverlay.NotFoundDrawable>().Any(d => d.IsPresent));
 
             AddStep("fetch for 0 beatmaps", () => fetchFor());
@@ -188,7 +186,7 @@ namespace osu.Game.Tests.Visual.Online
         [Test]
         public void TestUserWithoutSupporterUsesSupporterOnlyFiltersWithResults()
         {
-            AddStep("fetch for 1 beatmap", () => fetchFor(CreateBeatmap(Ruleset.Value).BeatmapInfo.BeatmapSet));
+            AddStep("fetch for 1 beatmap", () => fetchFor(CreateAPIBeatmapSet(Ruleset.Value)));
             AddStep("set dummy as non-supporter", () => ((DummyAPIAccess)API).LocalUser.Value.IsSupporter = false);
 
             // only Rank Achieved filter
@@ -218,7 +216,7 @@ namespace osu.Game.Tests.Visual.Online
         [Test]
         public void TestUserWithSupporterUsesSupporterOnlyFiltersWithResults()
         {
-            AddStep("fetch for 1 beatmap", () => fetchFor(CreateBeatmap(Ruleset.Value).BeatmapInfo.BeatmapSet));
+            AddStep("fetch for 1 beatmap", () => fetchFor(CreateAPIBeatmapSet(Ruleset.Value)));
             AddStep("set dummy as supporter", () => ((DummyAPIAccess)API).LocalUser.Value.IsSupporter = true);
 
             // only Rank Achieved filter
@@ -247,10 +245,10 @@ namespace osu.Game.Tests.Visual.Online
 
         private static int searchCount;
 
-        private void fetchFor(params BeatmapSetInfo[] beatmaps)
+        private void fetchFor(params APIBeatmapSet[] beatmaps)
         {
             setsForResponse.Clear();
-            setsForResponse.AddRange(beatmaps.Select(b => new TestAPIBeatmapSet(b)));
+            setsForResponse.AddRange(beatmaps);
 
             // trigger arbitrary change for fetching.
             searchControl.Query.Value = $"search {searchCount++}";
@@ -286,17 +284,5 @@ namespace osu.Game.Tests.Visual.Online
                 !overlay.ChildrenOfType<BeatmapListingOverlay.SupporterRequiredDrawable>().Any(d => d.IsPresent)
                 && !overlay.ChildrenOfType<BeatmapListingOverlay.NotFoundDrawable>().Any(d => d.IsPresent));
         }
-
-        private class TestAPIBeatmapSet : APIBeatmapSet
-        {
-            private readonly BeatmapSetInfo beatmapSet;
-
-            public TestAPIBeatmapSet(BeatmapSetInfo beatmapSet)
-            {
-                this.beatmapSet = beatmapSet;
-            }
-
-            public override BeatmapSetInfo ToBeatmapSet(RulesetStore rulesets) => beatmapSet;
-        }
     }
 }
diff --git a/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs b/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs
index 24d0e09649..7fbdd47394 100644
--- a/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs
@@ -119,7 +119,7 @@ namespace osu.Game.Online.API.Requests.Responses
         public string Tags { get; set; } = string.Empty;
 
         [JsonProperty(@"beatmaps")]
-        private IEnumerable<APIBeatmap> beatmaps { get; set; } = Array.Empty<APIBeatmap>();
+        public IEnumerable<APIBeatmap> Beatmaps { get; set; } = Array.Empty<APIBeatmap>();
 
         public virtual BeatmapSetInfo ToBeatmapSet(RulesetStore rulesets)
         {
@@ -132,7 +132,7 @@ namespace osu.Game.Online.API.Requests.Responses
                 OnlineInfo = this
             };
 
-            beatmapSet.Beatmaps = beatmaps.Select(b =>
+            beatmapSet.Beatmaps = Beatmaps.Select(b =>
             {
                 var beatmap = b.ToBeatmapInfo(rulesets);
                 beatmap.BeatmapSet = beatmapSet;
@@ -157,7 +157,7 @@ namespace osu.Game.Online.API.Requests.Responses
 
         #region Implementation of IBeatmapSetInfo
 
-        IEnumerable<IBeatmapInfo> IBeatmapSetInfo.Beatmaps => beatmaps;
+        IEnumerable<IBeatmapInfo> IBeatmapSetInfo.Beatmaps => Beatmaps;
 
         IBeatmapMetadataInfo IBeatmapSetInfo.Metadata => metadata;
 
diff --git a/osu.Game/Tests/Visual/OsuTestScene.cs b/osu.Game/Tests/Visual/OsuTestScene.cs
index 03434961ea..90e85f7716 100644
--- a/osu.Game/Tests/Visual/OsuTestScene.cs
+++ b/osu.Game/Tests/Visual/OsuTestScene.cs
@@ -20,6 +20,7 @@ using osu.Framework.Timing;
 using osu.Game.Beatmaps;
 using osu.Game.Database;
 using osu.Game.Online.API;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Mods;
@@ -174,6 +175,56 @@ namespace osu.Game.Tests.Visual
 
         protected virtual IBeatmap CreateBeatmap(RulesetInfo ruleset) => new TestBeatmap(ruleset);
 
+        protected APIBeatmapSet CreateAPIBeatmapSet(RulesetInfo ruleset)
+        {
+            var beatmap = CreateBeatmap(ruleset).BeatmapInfo;
+
+            return new APIBeatmapSet
+            {
+                Covers = beatmap.BeatmapSet.Covers,
+                OnlineID = beatmap.BeatmapSet.OnlineID,
+                Status = beatmap.BeatmapSet.Status,
+                Preview = beatmap.BeatmapSet.Preview,
+                HasFavourited = beatmap.BeatmapSet.HasFavourited,
+                PlayCount = beatmap.BeatmapSet.PlayCount,
+                FavouriteCount = beatmap.BeatmapSet.FavouriteCount,
+                BPM = beatmap.BeatmapSet.BPM,
+                HasExplicitContent = beatmap.BeatmapSet.HasExplicitContent,
+                HasVideo = beatmap.BeatmapSet.HasVideo,
+                HasStoryboard = beatmap.BeatmapSet.HasStoryboard,
+                Submitted = beatmap.BeatmapSet.Submitted,
+                Ranked = beatmap.BeatmapSet.Ranked,
+                LastUpdated = beatmap.BeatmapSet.LastUpdated,
+                TrackId = beatmap.BeatmapSet.TrackId,
+                Title = beatmap.BeatmapSet.Metadata.Title,
+                TitleUnicode = beatmap.BeatmapSet.Metadata.TitleUnicode,
+                Artist = beatmap.BeatmapSet.Metadata.Artist,
+                ArtistUnicode = beatmap.BeatmapSet.Metadata.ArtistUnicode,
+                Author = beatmap.BeatmapSet.Metadata.Author,
+                AuthorID = beatmap.BeatmapSet.Metadata.AuthorID,
+                AuthorString = beatmap.BeatmapSet.Metadata.AuthorString,
+                Availability = beatmap.BeatmapSet.Availability,
+                Genre = beatmap.BeatmapSet.Genre,
+                Language = beatmap.BeatmapSet.Language,
+                Source = beatmap.BeatmapSet.Metadata.Source,
+                Tags = beatmap.BeatmapSet.Metadata.Tags,
+                Beatmaps = new[]
+                {
+                    new APIBeatmap
+                    {
+                        OnlineID = beatmap.OnlineID,
+                        OnlineBeatmapSetID = beatmap.BeatmapSet.OnlineID,
+                        Status = beatmap.Status,
+                        Checksum = beatmap.MD5Hash,
+                        AuthorID = beatmap.Metadata.AuthorID,
+                        RulesetID = beatmap.RulesetID,
+                        StarRating = beatmap.StarDifficulty,
+                        DifficultyName = beatmap.Version,
+                    }
+                }
+            };
+        }
+
         protected WorkingBeatmap CreateWorkingBeatmap(RulesetInfo ruleset) =>
             CreateWorkingBeatmap(CreateBeatmap(ruleset));
 

From 94175bfb4a5b675b840ccce8fa1fcf3928e0baf9 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 25 Oct 2021 14:25:01 +0900
Subject: [PATCH 0441/5547] Update `PreviewTrackManager` to use
 `IBeatmapSetInfo`

---
 .../Components/TestScenePreviewTrackManager.cs     |  4 ++--
 osu.Game/Audio/PreviewTrackManager.cs              | 14 +++++++-------
 2 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/osu.Game.Tests/Visual/Components/TestScenePreviewTrackManager.cs b/osu.Game.Tests/Visual/Components/TestScenePreviewTrackManager.cs
index 9a999a4931..89e20043fb 100644
--- a/osu.Game.Tests/Visual/Components/TestScenePreviewTrackManager.cs
+++ b/osu.Game.Tests/Visual/Components/TestScenePreviewTrackManager.cs
@@ -224,7 +224,7 @@ namespace osu.Game.Tests.Visual.Components
 
             public new PreviewTrack CurrentTrack => base.CurrentTrack;
 
-            protected override TrackManagerPreviewTrack CreatePreviewTrack(BeatmapSetInfo beatmapSetInfo, ITrackStore trackStore) => new TestPreviewTrack(beatmapSetInfo, trackStore);
+            protected override TrackManagerPreviewTrack CreatePreviewTrack(IBeatmapSetInfo beatmapSetInfo, ITrackStore trackStore) => new TestPreviewTrack(beatmapSetInfo, trackStore);
 
             public override bool UpdateSubTree()
             {
@@ -240,7 +240,7 @@ namespace osu.Game.Tests.Visual.Components
 
                 public new Track Track => base.Track;
 
-                public TestPreviewTrack(BeatmapSetInfo beatmapSetInfo, ITrackStore trackManager)
+                public TestPreviewTrack(IBeatmapSetInfo beatmapSetInfo, ITrackStore trackManager)
                     : base(beatmapSetInfo, trackManager)
                 {
                     this.trackManager = trackManager;
diff --git a/osu.Game/Audio/PreviewTrackManager.cs b/osu.Game/Audio/PreviewTrackManager.cs
index 1de9e1561f..26787c362b 100644
--- a/osu.Game/Audio/PreviewTrackManager.cs
+++ b/osu.Game/Audio/PreviewTrackManager.cs
@@ -43,11 +43,11 @@ namespace osu.Game.Audio
         }
 
         /// <summary>
-        /// Retrieves a <see cref="PreviewTrack"/> for a <see cref="BeatmapSetInfo"/>.
+        /// Retrieves a <see cref="PreviewTrack"/> for a <see cref="IBeatmapSetInfo"/>.
         /// </summary>
-        /// <param name="beatmapSetInfo">The <see cref="BeatmapSetInfo"/> to retrieve the preview track for.</param>
+        /// <param name="beatmapSetInfo">The <see cref="IBeatmapSetInfo"/> to retrieve the preview track for.</param>
         /// <returns>The playable <see cref="PreviewTrack"/>.</returns>
-        public PreviewTrack Get(BeatmapSetInfo beatmapSetInfo)
+        public PreviewTrack Get(IBeatmapSetInfo beatmapSetInfo)
         {
             var track = CreatePreviewTrack(beatmapSetInfo, trackStore);
 
@@ -91,7 +91,7 @@ namespace osu.Game.Audio
         /// <summary>
         /// Creates the <see cref="TrackManagerPreviewTrack"/>.
         /// </summary>
-        protected virtual TrackManagerPreviewTrack CreatePreviewTrack(BeatmapSetInfo beatmapSetInfo, ITrackStore trackStore) =>
+        protected virtual TrackManagerPreviewTrack CreatePreviewTrack(IBeatmapSetInfo beatmapSetInfo, ITrackStore trackStore) =>
             new TrackManagerPreviewTrack(beatmapSetInfo, trackStore);
 
         public class TrackManagerPreviewTrack : PreviewTrack
@@ -99,10 +99,10 @@ namespace osu.Game.Audio
             [Resolved(canBeNull: true)]
             public IPreviewTrackOwner Owner { get; private set; }
 
-            private readonly BeatmapSetInfo beatmapSetInfo;
+            private readonly IBeatmapSetInfo beatmapSetInfo;
             private readonly ITrackStore trackManager;
 
-            public TrackManagerPreviewTrack(BeatmapSetInfo beatmapSetInfo, ITrackStore trackManager)
+            public TrackManagerPreviewTrack(IBeatmapSetInfo beatmapSetInfo, ITrackStore trackManager)
             {
                 this.beatmapSetInfo = beatmapSetInfo;
                 this.trackManager = trackManager;
@@ -114,7 +114,7 @@ namespace osu.Game.Audio
                 Logger.Log($"A {nameof(PreviewTrack)} was created without a containing {nameof(IPreviewTrackOwner)}. An owner should be added for correct behaviour.");
             }
 
-            protected override Track GetTrack() => trackManager.Get($"https://b.ppy.sh/preview/{beatmapSetInfo?.OnlineBeatmapSetID}.mp3");
+            protected override Track GetTrack() => trackManager.Get($"https://b.ppy.sh/preview/{beatmapSetInfo?.OnlineID}.mp3");
         }
 
         private class PreviewTrackStore : AudioCollectionManager<AdjustableAudioComponent>, ITrackStore

From cb36a23cdc639f57568cc2fca8dcaad47efa8b20 Mon Sep 17 00:00:00 2001
From: Roxie Wattz <flux3on@gmail.com>
Date: Sun, 24 Oct 2021 22:52:10 -0700
Subject: [PATCH 0442/5547] Update osu.Game.Rulesets.Osu/Mods/OsuModHidden.cs

Suggested by peppy. Changes name and description of setting

Co-authored-by: Dean Herbert <pe@ppy.sh>
---
 osu.Game.Rulesets.Osu/Mods/OsuModHidden.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModHidden.cs b/osu.Game.Rulesets.Osu/Mods/OsuModHidden.cs
index a57b22451d..59ac6746a0 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModHidden.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModHidden.cs
@@ -20,7 +20,7 @@ namespace osu.Game.Rulesets.Osu.Mods
 {
     public class OsuModHidden : ModHidden, IHidesApproachCircles
     {
-        [SettingSource("Don't fade out hit circles", "This makes the hidden mod only remove approach circles, similar to Ouendan 2's Easy difficulties.")]
+        [SettingSource("Only fade approach circles", "The main object body will not fade when enabled.")]
         public Bindable<bool> NoHitCircles { get; } = new BindableBool(false);
 
         public override string Description => @"Play with no approach circles and fading circles/sliders.";

From 045dd94a6effae7aa1e0c13aaf30b42333d7d62b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 25 Oct 2021 14:44:49 +0900
Subject: [PATCH 0443/5547] Move online metrics out of `BeatmapSetInfo` model

---
 .../Online/TestSceneBeatmapSetOverlay.cs      |  8 ++--
 .../TestSceneBeatmapSetOverlayDetails.cs      |  6 +--
 .../SongSelect/TestSceneBeatmapDetails.cs     | 16 ++++++--
 osu.Game/Beatmaps/BeatmapInfo.cs              |  2 +-
 osu.Game/Beatmaps/BeatmapSetInfo.cs           |  7 ++--
 osu.Game/Beatmaps/BeatmapSetMetrics.cs        | 17 --------
 osu.Game/Beatmaps/IBeatmapOnlineInfo.cs       | 17 ++++++++
 osu.Game/Beatmaps/IBeatmapSetOnlineInfo.cs    |  5 +++
 .../API/Requests/Responses/APIBeatmap.cs      | 10 ++---
 .../API/Requests/Responses/APIBeatmapSet.cs   |  5 +--
 osu.Game/Overlays/BeatmapSet/Details.cs       |  2 +-
 osu.Game/Screens/Select/BeatmapDetails.cs     | 39 +++++++++----------
 .../Screens/Select/Details/UserRatings.cs     | 25 ++++++------
 13 files changed, 86 insertions(+), 73 deletions(-)
 delete mode 100644 osu.Game/Beatmaps/BeatmapSetMetrics.cs
 create mode 100644 osu.Game/Beatmaps/IBeatmapOnlineInfo.cs

diff --git a/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlay.cs b/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlay.cs
index ef89a86e79..da033e324c 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlay.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlay.cs
@@ -73,10 +73,10 @@ namespace osu.Game.Tests.Visual.Online
                         Ranked = DateTime.Now,
                         BPM = 111,
                         HasVideo = true,
+                        Ratings = Enumerable.Range(0, 11).ToArray(),
                         HasStoryboard = true,
                         Covers = new BeatmapSetOnlineCovers(),
                     },
-                    Metrics = new BeatmapSetMetrics { Ratings = Enumerable.Range(0, 11).ToArray() },
                     Beatmaps = new List<BeatmapInfo>
                     {
                         new BeatmapInfo
@@ -153,8 +153,8 @@ namespace osu.Game.Tests.Visual.Online
                         Covers = new BeatmapSetOnlineCovers(),
                         Language = new BeatmapSetOnlineLanguage { Id = 3, Name = "English" },
                         Genre = new BeatmapSetOnlineGenre { Id = 4, Name = "Rock" },
+                        Ratings = Enumerable.Range(0, 11).ToArray(),
                     },
-                    Metrics = new BeatmapSetMetrics { Ratings = Enumerable.Range(0, 11).ToArray() },
                     Beatmaps = new List<BeatmapInfo>
                     {
                         new BeatmapInfo
@@ -228,8 +228,8 @@ namespace osu.Game.Tests.Visual.Online
                     OnlineInfo = new APIBeatmapSet
                     {
                         Covers = new BeatmapSetOnlineCovers(),
+                        Ratings = Enumerable.Range(0, 11).ToArray(),
                     },
-                    Metrics = new BeatmapSetMetrics { Ratings = Enumerable.Range(0, 11).ToArray() },
                     Beatmaps = beatmaps
                 });
             });
@@ -316,8 +316,8 @@ namespace osu.Game.Tests.Visual.Online
                     HasVideo = true,
                     HasStoryboard = true,
                     Covers = new BeatmapSetOnlineCovers(),
+                    Ratings = Enumerable.Range(0, 11).ToArray(),
                 },
-                Metrics = new BeatmapSetMetrics { Ratings = Enumerable.Range(0, 11).ToArray() },
                 Beatmaps = beatmaps,
             };
         }
diff --git a/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlayDetails.cs b/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlayDetails.cs
index c15c9f44e4..f16d5aaa23 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlayDetails.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlayDetails.cs
@@ -39,14 +39,13 @@ namespace osu.Game.Tests.Visual.Online
             var secondSet = createSet();
 
             AddStep("set first set", () => details.BeatmapSet = firstSet);
-            AddAssert("ratings set", () => details.Ratings.Metrics == firstSet.Metrics);
+            AddAssert("ratings set", () => details.Ratings.Ratings == firstSet.Ratings);
 
             AddStep("set second set", () => details.BeatmapSet = secondSet);
-            AddAssert("ratings set", () => details.Ratings.Metrics == secondSet.Metrics);
+            AddAssert("ratings set", () => details.Ratings.Ratings == secondSet.Ratings);
 
             static BeatmapSetInfo createSet() => new BeatmapSetInfo
             {
-                Metrics = new BeatmapSetMetrics { Ratings = Enumerable.Range(0, 11).Select(_ => RNG.Next(10)).ToArray() },
                 Beatmaps = new List<BeatmapInfo>
                 {
                     new BeatmapInfo
@@ -60,6 +59,7 @@ namespace osu.Game.Tests.Visual.Online
                 },
                 OnlineInfo = new APIBeatmapSet
                 {
+                    Ratings = Enumerable.Range(0, 11).Select(_ => RNG.Next(10)).ToArray(),
                     Status = BeatmapSetOnlineStatus.Ranked
                 }
             };
diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapDetails.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapDetails.cs
index d5b4fb9a80..6b508878bf 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapDetails.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapDetails.cs
@@ -6,6 +6,7 @@ using NUnit.Framework;
 using osu.Framework.Graphics;
 using osu.Game.Beatmaps;
 using osu.Game.Online.API;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Screens.Select;
 
 namespace osu.Game.Tests.Visual.SongSelect
@@ -34,7 +35,10 @@ namespace osu.Game.Tests.Visual.SongSelect
             {
                 BeatmapSet = new BeatmapSetInfo
                 {
-                    Metrics = new BeatmapSetMetrics { Ratings = Enumerable.Range(0, 11).ToArray() }
+                    OnlineInfo = new APIBeatmapSet
+                    {
+                        Ratings = Enumerable.Range(0, 11).ToArray(),
+                    }
                 },
                 Version = "All Metrics",
                 Metadata = new BeatmapMetadata
@@ -65,7 +69,10 @@ namespace osu.Game.Tests.Visual.SongSelect
             {
                 BeatmapSet = new BeatmapSetInfo
                 {
-                    Metrics = new BeatmapSetMetrics { Ratings = Enumerable.Range(0, 11).ToArray() }
+                    OnlineInfo = new APIBeatmapSet
+                    {
+                        Ratings = Enumerable.Range(0, 11).ToArray(),
+                    }
                 },
                 Version = "All Metrics",
                 Metadata = new BeatmapMetadata
@@ -95,7 +102,10 @@ namespace osu.Game.Tests.Visual.SongSelect
             {
                 BeatmapSet = new BeatmapSetInfo
                 {
-                    Metrics = new BeatmapSetMetrics { Ratings = Enumerable.Range(0, 11).ToArray() }
+                    OnlineInfo = new APIBeatmapSet
+                    {
+                        Ratings = Enumerable.Range(0, 11).ToArray(),
+                    }
                 },
                 Version = "Only Ratings",
                 Metadata = new BeatmapMetadata
diff --git a/osu.Game/Beatmaps/BeatmapInfo.cs b/osu.Game/Beatmaps/BeatmapInfo.cs
index 3bcc00f5de..6da50657a6 100644
--- a/osu.Game/Beatmaps/BeatmapInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapInfo.cs
@@ -16,7 +16,7 @@ namespace osu.Game.Beatmaps
 {
     [ExcludeFromDynamicCompile]
     [Serializable]
-    public class BeatmapInfo : IEquatable<BeatmapInfo>, IHasPrimaryKey, IBeatmapInfo
+    public class BeatmapInfo : IEquatable<BeatmapInfo>, IHasPrimaryKey, IBeatmapInfo, IBeatmapOnlineInfo
     {
         public int ID { get; set; }
 
diff --git a/osu.Game/Beatmaps/BeatmapSetInfo.cs b/osu.Game/Beatmaps/BeatmapSetInfo.cs
index 0c032e1482..ae32ad000e 100644
--- a/osu.Game/Beatmaps/BeatmapSetInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapSetInfo.cs
@@ -38,9 +38,6 @@ namespace osu.Game.Beatmaps
         [NotMapped]
         public APIBeatmapSet OnlineInfo { get; set; }
 
-        [NotMapped]
-        public BeatmapSetMetrics Metrics { get; set; }
-
         /// <summary>
         /// The maximum star difficulty of all beatmaps in this set.
         /// </summary>
@@ -172,6 +169,10 @@ namespace osu.Game.Beatmaps
         [JsonIgnore]
         public int? TrackId => OnlineInfo?.TrackId;
 
+        [NotMapped]
+        [JsonIgnore]
+        public int[] Ratings => OnlineInfo?.Ratings;
+
         #endregion
     }
 }
diff --git a/osu.Game/Beatmaps/BeatmapSetMetrics.cs b/osu.Game/Beatmaps/BeatmapSetMetrics.cs
deleted file mode 100644
index 51c5de19a6..0000000000
--- a/osu.Game/Beatmaps/BeatmapSetMetrics.cs
+++ /dev/null
@@ -1,17 +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.Beatmaps
-{
-    public class BeatmapSetMetrics
-    {
-        /// <summary>
-        /// Total vote counts of user ratings on a scale of 0..10 where 0 is unused (probably will be fixed at API?).
-        /// </summary>
-        [JsonProperty("ratings")]
-        public int[] Ratings { get; set; } = Array.Empty<int>();
-    }
-}
diff --git a/osu.Game/Beatmaps/IBeatmapOnlineInfo.cs b/osu.Game/Beatmaps/IBeatmapOnlineInfo.cs
new file mode 100644
index 0000000000..4898e45c56
--- /dev/null
+++ b/osu.Game/Beatmaps/IBeatmapOnlineInfo.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.
+
+#nullable enable
+
+namespace osu.Game.Beatmaps
+{
+    /// <summary>
+    /// Beatmap info retrieved for previewing locally.
+    /// </summary>
+    public interface IBeatmapOnlineInfo
+    {
+        int? MaxCombo { get; }
+
+        BeatmapMetrics? Metrics { get; }
+    }
+}
diff --git a/osu.Game/Beatmaps/IBeatmapSetOnlineInfo.cs b/osu.Game/Beatmaps/IBeatmapSetOnlineInfo.cs
index 1d2bb46bde..6def6ec21d 100644
--- a/osu.Game/Beatmaps/IBeatmapSetOnlineInfo.cs
+++ b/osu.Game/Beatmaps/IBeatmapSetOnlineInfo.cs
@@ -97,5 +97,10 @@ namespace osu.Game.Beatmaps
         /// Non-null only if the track is linked to a featured artist track entry.
         /// </summary>
         int? TrackId { get; }
+
+        /// <summary>
+        /// Total vote counts of user ratings on a scale of 0..10 where 0 is unused (probably will be fixed at API?).
+        /// </summary>
+        int[]? Ratings { get; }
     }
 }
diff --git a/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs b/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs
index 6e43ac5504..6a05811bba 100644
--- a/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs
@@ -10,7 +10,7 @@ using osu.Game.Rulesets;
 
 namespace osu.Game.Online.API.Requests.Responses
 {
-    public class APIBeatmap : IBeatmapInfo
+    public class APIBeatmap : IBeatmapInfo, IBeatmapOnlineInfo
     {
         [JsonProperty(@"id")]
         public int OnlineID { get; set; }
@@ -69,10 +69,10 @@ namespace osu.Game.Online.API.Requests.Responses
         public string DifficultyName { get; set; } = string.Empty;
 
         [JsonProperty(@"failtimes")]
-        private BeatmapMetrics? metrics { get; set; }
+        public BeatmapMetrics? Metrics { get; set; }
 
         [JsonProperty(@"max_combo")]
-        private int? maxCombo { get; set; }
+        public int? MaxCombo { get; set; }
 
         public virtual BeatmapInfo ToBeatmapInfo(RulesetStore rulesets)
         {
@@ -90,8 +90,8 @@ namespace osu.Game.Online.API.Requests.Responses
                 Status = Status,
                 MD5Hash = Checksum,
                 BeatmapSet = set,
-                Metrics = metrics,
-                MaxCombo = maxCombo,
+                Metrics = Metrics,
+                MaxCombo = MaxCombo,
                 BaseDifficulty = new BeatmapDifficulty
                 {
                     DrainRate = drainRate,
diff --git a/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs b/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs
index 24d0e09649..17b1e9d3fe 100644
--- a/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs
@@ -58,8 +58,8 @@ namespace osu.Game.Online.API.Requests.Responses
         [JsonProperty(@"last_updated")]
         public DateTimeOffset? LastUpdated { get; set; }
 
-        [JsonProperty(@"ratings")]
-        private int[] ratings { get; set; } = Array.Empty<int>();
+        [JsonProperty("ratings")]
+        public int[] Ratings { get; set; } = Array.Empty<int>();
 
         [JsonProperty(@"track_id")]
         public int? TrackId { get; set; }
@@ -128,7 +128,6 @@ namespace osu.Game.Online.API.Requests.Responses
                 OnlineBeatmapSetID = OnlineID,
                 Metadata = metadata,
                 Status = Status,
-                Metrics = new BeatmapSetMetrics { Ratings = ratings },
                 OnlineInfo = this
             };
 
diff --git a/osu.Game/Overlays/BeatmapSet/Details.cs b/osu.Game/Overlays/BeatmapSet/Details.cs
index 92361ae4f8..d6720e5f35 100644
--- a/osu.Game/Overlays/BeatmapSet/Details.cs
+++ b/osu.Game/Overlays/BeatmapSet/Details.cs
@@ -52,7 +52,7 @@ namespace osu.Game.Overlays.BeatmapSet
 
         private void updateDisplay()
         {
-            Ratings.Metrics = BeatmapSet?.Metrics;
+            Ratings.Ratings = BeatmapSet?.Ratings;
             ratingBox.Alpha = BeatmapSet?.OnlineInfo?.Status > 0 ? 1 : 0;
         }
 
diff --git a/osu.Game/Screens/Select/BeatmapDetails.cs b/osu.Game/Screens/Select/BeatmapDetails.cs
index 6ace92370c..8dbe438ab5 100644
--- a/osu.Game/Screens/Select/BeatmapDetails.cs
+++ b/osu.Game/Screens/Select/BeatmapDetails.cs
@@ -29,7 +29,7 @@ namespace osu.Game.Screens.Select
         private const float transition_duration = 250;
 
         private readonly AdvancedStats advanced;
-        private readonly UserRatings ratings;
+        private readonly UserRatings ratingsDisplay;
         private readonly MetadataSection description, source, tags;
         private readonly Container failRetryContainer;
         private readonly FailRetryGraph failRetryGraph;
@@ -43,6 +43,9 @@ namespace osu.Game.Screens.Select
 
         private BeatmapInfo beatmapInfo;
 
+        private BeatmapMetrics metrics;
+        private int[] ratings;
+
         public BeatmapInfo BeatmapInfo
         {
             get => beatmapInfo;
@@ -52,6 +55,9 @@ namespace osu.Game.Screens.Select
 
                 beatmapInfo = value;
 
+                metrics = beatmapInfo?.Metrics;
+                ratings = beatmapInfo?.BeatmapSet.Ratings;
+
                 Scheduler.AddOnce(updateStatistics);
             }
         }
@@ -110,7 +116,7 @@ namespace osu.Game.Screens.Select
                                                         RelativeSizeAxes = Axes.X,
                                                         Height = 134,
                                                         Padding = new MarginPadding { Horizontal = spacing, Top = spacing },
-                                                        Child = ratings = new UserRatings
+                                                        Child = ratingsDisplay = new UserRatings
                                                         {
                                                             RelativeSizeAxes = Axes.Both,
                                                         },
@@ -176,7 +182,7 @@ namespace osu.Game.Screens.Select
             tags.Text = BeatmapInfo?.Metadata?.Tags;
 
             // metrics may have been previously fetched
-            if (BeatmapInfo?.BeatmapSet?.Metrics != null && BeatmapInfo?.Metrics != null)
+            if (ratings != null && metrics != null)
             {
                 updateMetrics();
                 return;
@@ -201,14 +207,8 @@ namespace osu.Game.Screens.Select
                         // the beatmap has been changed since we started the lookup.
                         return;
 
-                    var b = res.ToBeatmapInfo(rulesets);
-
-                    if (requestedBeatmap.BeatmapSet == null)
-                        requestedBeatmap.BeatmapSet = b.BeatmapSet;
-                    else
-                        requestedBeatmap.BeatmapSet.Metrics = b.BeatmapSet.Metrics;
-
-                    requestedBeatmap.Metrics = b.Metrics;
+                    ratings = res.BeatmapSet?.Ratings;
+                    metrics = res.Metrics;
 
                     updateMetrics();
                 });
@@ -232,24 +232,23 @@ namespace osu.Game.Screens.Select
 
         private void updateMetrics()
         {
-            var hasRatings = beatmapInfo?.BeatmapSet?.Metrics?.Ratings?.Any() ?? false;
-            var hasRetriesFails = (beatmapInfo?.Metrics?.Retries?.Any() ?? false) || (beatmapInfo?.Metrics?.Fails?.Any() ?? false);
+            var hasMetrics = (metrics?.Retries?.Any() ?? false) || (metrics?.Fails?.Any() ?? false);
 
-            if (hasRatings)
+            if (ratings?.Any() ?? false)
             {
-                ratings.Metrics = beatmapInfo.BeatmapSet.Metrics;
-                ratings.FadeIn(transition_duration);
+                ratingsDisplay.Ratings = ratings;
+                ratingsDisplay.FadeIn(transition_duration);
             }
             else
             {
                 // loading or just has no data server-side.
-                ratings.Metrics = new BeatmapSetMetrics { Ratings = new int[10] };
-                ratings.FadeTo(0.25f, transition_duration);
+                ratingsDisplay.Ratings = new int[10];
+                ratingsDisplay.FadeTo(0.25f, transition_duration);
             }
 
-            if (hasRetriesFails)
+            if (hasMetrics)
             {
-                failRetryGraph.Metrics = beatmapInfo.Metrics;
+                failRetryGraph.Metrics = metrics;
                 failRetryContainer.FadeIn(transition_duration);
             }
             else
diff --git a/osu.Game/Screens/Select/Details/UserRatings.cs b/osu.Game/Screens/Select/Details/UserRatings.cs
index eabc476db9..aa316d6e40 100644
--- a/osu.Game/Screens/Select/Details/UserRatings.cs
+++ b/osu.Game/Screens/Select/Details/UserRatings.cs
@@ -1,15 +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.Linq;
 using osu.Framework.Allocation;
+using osu.Framework.Extensions.LocalisationExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.UserInterface;
-using System.Linq;
-using osu.Framework.Extensions.LocalisationExtensions;
-using osu.Game.Beatmaps;
 using osu.Game.Resources.Localisation.Web;
 
 namespace osu.Game.Screens.Select.Details
@@ -22,20 +21,20 @@ namespace osu.Game.Screens.Select.Details
         private readonly Container graphContainer;
         private readonly BarGraph graph;
 
-        private BeatmapSetMetrics metrics;
+        private int[] ratings;
 
-        public BeatmapSetMetrics Metrics
+        public int[] Ratings
         {
-            get => metrics;
+            get => ratings;
             set
             {
-                if (value == metrics) return;
+                if (value == ratings) return;
 
-                metrics = value;
+                ratings = value;
 
                 const int rating_range = 10;
 
-                if (metrics == null)
+                if (ratings == null)
                 {
                     negativeRatings.Text = 0.ToLocalisableString(@"N0");
                     positiveRatings.Text = 0.ToLocalisableString(@"N0");
@@ -44,15 +43,15 @@ namespace osu.Game.Screens.Select.Details
                 }
                 else
                 {
-                    var ratings = Metrics.Ratings.Skip(1).Take(rating_range); // adjust for API returning weird empty data at 0.
+                    var usableRange = Ratings.Skip(1).Take(rating_range); // adjust for API returning weird empty data at 0.
 
-                    var negativeCount = ratings.Take(rating_range / 2).Sum();
-                    var totalCount = ratings.Sum();
+                    var negativeCount = usableRange.Take(rating_range / 2).Sum();
+                    var totalCount = usableRange.Sum();
 
                     negativeRatings.Text = negativeCount.ToLocalisableString(@"N0");
                     positiveRatings.Text = (totalCount - negativeCount).ToLocalisableString(@"N0");
                     ratingsBar.Length = totalCount == 0 ? 0 : (float)negativeCount / totalCount;
-                    graph.Values = ratings.Take(rating_range).Select(r => (float)r);
+                    graph.Values = usableRange.Take(rating_range).Select(r => (float)r);
                 }
             }
         }

From 60df0151c024bdc47bf1b4b111d521bda184bf5c Mon Sep 17 00:00:00 2001
From: ekrctb <ekrctb@gmail.com>
Date: Wed, 7 Jul 2021 20:24:05 +0900
Subject: [PATCH 0444/5547] Add very basic distance snap grid for catch editor

---
 .../Editor/TestSceneCatchDistanceSnapGrid.cs  |  91 +++++++++++++++
 .../Edit/CatchDistanceSnapGrid.cs             | 107 ++++++++++++++++++
 2 files changed, 198 insertions(+)
 create mode 100644 osu.Game.Rulesets.Catch.Tests/Editor/TestSceneCatchDistanceSnapGrid.cs
 create mode 100644 osu.Game.Rulesets.Catch/Edit/CatchDistanceSnapGrid.cs

diff --git a/osu.Game.Rulesets.Catch.Tests/Editor/TestSceneCatchDistanceSnapGrid.cs b/osu.Game.Rulesets.Catch.Tests/Editor/TestSceneCatchDistanceSnapGrid.cs
new file mode 100644
index 0000000000..2be0b7e9b2
--- /dev/null
+++ b/osu.Game.Rulesets.Catch.Tests/Editor/TestSceneCatchDistanceSnapGrid.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.
+
+using osu.Framework.Allocation;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
+using osu.Framework.Input.Events;
+using osu.Framework.Timing;
+using osu.Game.Beatmaps;
+using osu.Game.Rulesets.Catch.Edit;
+using osu.Game.Rulesets.Catch.Edit.Blueprints.Components;
+using osu.Game.Rulesets.Catch.Objects;
+using osu.Game.Rulesets.Catch.UI;
+using osu.Game.Rulesets.UI;
+using osu.Game.Rulesets.UI.Scrolling;
+using osu.Game.Tests.Visual;
+using osuTK;
+
+namespace osu.Game.Rulesets.Catch.Tests.Editor
+{
+    public class TestSceneCatchDistanceSnapGrid : OsuManualInputManagerTestScene
+    {
+        private readonly ManualClock manualClock = new ManualClock();
+
+        [Cached(typeof(Playfield))]
+        private readonly CatchPlayfield playfield;
+
+        private ScrollingHitObjectContainer hitObjectContainer => playfield.HitObjectContainer;
+
+        private readonly CatchDistanceSnapGrid distanceGrid;
+
+        private readonly FruitOutline fruitOutline;
+
+        private readonly Fruit fruit = new Fruit();
+
+        public TestSceneCatchDistanceSnapGrid()
+        {
+            Child = new Container
+            {
+                Anchor = Anchor.Centre,
+                Origin = Anchor.Centre,
+                RelativeSizeAxes = Axes.Y,
+                Width = 500,
+
+                Children = new Drawable[]
+                {
+                    new ScrollingTestContainer(ScrollingDirection.Down)
+                    {
+                        RelativeSizeAxes = Axes.Both,
+                        Child = playfield = new CatchPlayfield(new BeatmapDifficulty())
+                        {
+                            RelativeSizeAxes = Axes.Both,
+                            Clock = new FramedClock(manualClock)
+                        }
+                    },
+                    distanceGrid = new CatchDistanceSnapGrid(new double[] { 0, -1, 1 }),
+                    fruitOutline = new FruitOutline()
+                },
+            };
+        }
+
+        protected override void Update()
+        {
+            base.Update();
+
+            distanceGrid.StartTime = 100;
+            distanceGrid.StartX = 250;
+
+            Vector2 screenSpacePosition = InputManager.CurrentState.Mouse.Position;
+
+            var result = distanceGrid.GetSnappedPosition(screenSpacePosition);
+
+            if (result != null)
+            {
+                fruit.OriginalX = hitObjectContainer.ToLocalSpace(result.ScreenSpacePosition).X;
+
+                if (result.Time != null)
+                    fruit.StartTime = result.Time.Value;
+            }
+
+            fruitOutline.Position = CatchHitObjectUtils.GetStartPosition(hitObjectContainer, fruit);
+            fruitOutline.UpdateFrom(fruit);
+        }
+
+        protected override bool OnScroll(ScrollEvent e)
+        {
+            manualClock.CurrentTime -= e.ScrollDelta.Y * 50;
+            return true;
+        }
+    }
+}
diff --git a/osu.Game.Rulesets.Catch/Edit/CatchDistanceSnapGrid.cs b/osu.Game.Rulesets.Catch/Edit/CatchDistanceSnapGrid.cs
new file mode 100644
index 0000000000..5808b332b0
--- /dev/null
+++ b/osu.Game.Rulesets.Catch/Edit/CatchDistanceSnapGrid.cs
@@ -0,0 +1,107 @@
+// 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 JetBrains.Annotations;
+using osu.Framework.Allocation;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.Lines;
+using osu.Framework.Graphics.Primitives;
+using osu.Game.Rulesets.Edit;
+using osu.Game.Rulesets.UI;
+using osu.Game.Rulesets.UI.Scrolling;
+using osuTK;
+
+namespace osu.Game.Rulesets.Catch.Edit
+{
+    public class CatchDistanceSnapGrid : CompositeDrawable
+    {
+        public double StartTime { get; set; }
+
+        public float StartX { get; set; }
+
+        private readonly double[] velocities;
+
+        private readonly List<Path> verticalPaths = new List<Path>();
+
+        private readonly List<List<Vector2>> verticalLineVertices = new List<List<Vector2>>();
+
+        [Resolved]
+        private Playfield playfield { get; set; }
+
+        private ScrollingHitObjectContainer hitObjectContainer => (ScrollingHitObjectContainer)playfield.HitObjectContainer;
+
+        public CatchDistanceSnapGrid(double[] velocities)
+        {
+            RelativeSizeAxes = Axes.Both;
+            Anchor = Anchor.BottomLeft;
+
+            this.velocities = velocities;
+
+            for (int i = 0; i < velocities.Length; i++)
+            {
+                verticalPaths.Add(new SmoothPath
+                {
+                    PathRadius = 2,
+                    Alpha = 0.5f,
+                });
+
+                verticalLineVertices.Add(new List<Vector2> { Vector2.Zero, Vector2.Zero });
+            }
+
+            AddRangeInternal(verticalPaths);
+        }
+
+        protected override void Update()
+        {
+            base.Update();
+
+            float startY = hitObjectContainer.PositionAtTime(StartTime);
+
+            for (int i = 0; i < velocities.Length; i++)
+            {
+                double velocity = velocities[i];
+
+                // The line ends at the top of the screen.
+                double endTime = hitObjectContainer.TimeAtPosition(-hitObjectContainer.DrawHeight, hitObjectContainer.Time.Current);
+
+                float x = (float)((endTime - StartTime) * velocity);
+                float y = hitObjectContainer.PositionAtTime(endTime, StartTime);
+
+                List<Vector2> lineVertices = verticalLineVertices[i];
+                lineVertices[0] = new Vector2(StartX, startY);
+                lineVertices[1] = lineVertices[0] + new Vector2(x, y);
+
+                var verticalPath = verticalPaths[i];
+                verticalPath.Vertices = verticalLineVertices[i];
+                verticalPath.OriginPosition = verticalPath.PositionInBoundingBox(Vector2.Zero);
+            }
+        }
+
+        [CanBeNull]
+        public SnapResult GetSnappedPosition(Vector2 screenSpacePosition)
+        {
+            double time = hitObjectContainer.TimeAtScreenSpacePosition(screenSpacePosition);
+
+            return enumerateSnappingCandidates(time)
+                   .OrderBy(pos => Vector2.DistanceSquared(screenSpacePosition, pos.ScreenSpacePosition))
+                   .FirstOrDefault();
+        }
+
+        private IEnumerable<SnapResult> enumerateSnappingCandidates(double time)
+        {
+            float y = hitObjectContainer.PositionAtTime(time);
+
+            foreach (double velocity in velocities)
+            {
+                float x = (float)(StartX + (time - StartTime) * velocity);
+                Vector2 screenSpacePosition = hitObjectContainer.ToScreenSpace(new Vector2(x, y + hitObjectContainer.DrawHeight));
+                yield return new SnapResult(screenSpacePosition, time);
+            }
+        }
+
+        protected override bool ComputeIsMaskedAway(RectangleF maskingBounds) => false;
+    }
+}

From 20baae90945da9ad276e2277d5497172e7276baf Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 25 Oct 2021 15:12:11 +0900
Subject: [PATCH 0445/5547] Move online metrics out of `BeatmapInfo` model

---
 .../Online/TestSceneBeatmapSetOverlay.cs      | 48 ++++++++++---------
 .../TestSceneBeatmapSetOverlayDetails.cs      | 11 +++--
 .../TestSceneBeatmapSetOverlaySuccessRate.cs  | 29 +++++++----
 .../SongSelect/TestSceneBeatmapDetails.cs     | 33 ++++++++-----
 osu.Game/Beatmaps/BeatmapInfo.cs              | 24 ++++++++--
 osu.Game/Beatmaps/BeatmapOnlineInfo.cs        | 31 ------------
 osu.Game/Beatmaps/IBeatmapOnlineInfo.cs       | 23 +++++++++
 .../API/Requests/Responses/APIBeatmap.cs      | 17 ++-----
 osu.Game/Screens/Select/BeatmapDetails.cs     |  4 +-
 osu.Game/Tests/Beatmaps/TestBeatmap.cs        |  2 +-
 10 files changed, 124 insertions(+), 98 deletions(-)
 delete mode 100644 osu.Game/Beatmaps/BeatmapOnlineInfo.cs

diff --git a/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlay.cs b/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlay.cs
index da033e324c..3b0c2f5a7a 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlay.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlay.cs
@@ -92,17 +92,17 @@ namespace osu.Game.Tests.Visual.Online
                                 OverallDifficulty = 4.5f,
                                 ApproachRate = 6,
                             },
-                            OnlineInfo = new BeatmapOnlineInfo
+                            OnlineInfo = new APIBeatmap
                             {
                                 CircleCount = 111,
                                 SliderCount = 12,
                                 PlayCount = 222,
                                 PassCount = 21,
-                            },
-                            Metrics = new BeatmapMetrics
-                            {
-                                Fails = Enumerable.Range(1, 100).Select(i => i % 12 - 6).ToArray(),
-                                Retries = Enumerable.Range(-2, 100).Select(i => i % 12 - 6).ToArray(),
+                                Metrics = new BeatmapMetrics
+                                {
+                                    Fails = Enumerable.Range(1, 100).Select(i => i % 12 - 6).ToArray(),
+                                    Retries = Enumerable.Range(-2, 100).Select(i => i % 12 - 6).ToArray(),
+                                },
                             },
                         },
                     },
@@ -170,17 +170,17 @@ namespace osu.Game.Tests.Visual.Online
                                 OverallDifficulty = 7,
                                 ApproachRate = 6,
                             },
-                            OnlineInfo = new BeatmapOnlineInfo
+                            OnlineInfo = new APIBeatmap
                             {
                                 CircleCount = 123,
                                 SliderCount = 45,
                                 PlayCount = 567,
                                 PassCount = 89,
-                            },
-                            Metrics = new BeatmapMetrics
-                            {
-                                Fails = Enumerable.Range(1, 100).Select(i => i % 12 - 6).ToArray(),
-                                Retries = Enumerable.Range(-2, 100).Select(i => i % 12 - 6).ToArray(),
+                                Metrics = new BeatmapMetrics
+                                {
+                                    Fails = Enumerable.Range(1, 100).Select(i => i % 12 - 6).ToArray(),
+                                    Retries = Enumerable.Range(-2, 100).Select(i => i % 12 - 6).ToArray(),
+                                },
                             },
                         },
                     },
@@ -204,12 +204,14 @@ namespace osu.Game.Tests.Visual.Online
                         Version = ruleset.Name,
                         Ruleset = ruleset,
                         BaseDifficulty = new BeatmapDifficulty(),
-                        OnlineInfo = new BeatmapOnlineInfo(),
-                        Metrics = new BeatmapMetrics
+                        OnlineInfo = new APIBeatmap
                         {
-                            Fails = Enumerable.Range(1, 100).Select(i => i % 12 - 6).ToArray(),
-                            Retries = Enumerable.Range(-2, 100).Select(i => i % 12 - 6).ToArray(),
-                        },
+                            Metrics = new BeatmapMetrics
+                            {
+                                Fails = Enumerable.Range(1, 100).Select(i => i % 12 - 6).ToArray(),
+                                Retries = Enumerable.Range(-2, 100).Select(i => i % 12 - 6).ToArray(),
+                            },
+                        }
                     });
                 }
 
@@ -288,12 +290,14 @@ namespace osu.Game.Tests.Visual.Online
                     {
                         OverallDifficulty = 3.5f,
                     },
-                    OnlineInfo = new BeatmapOnlineInfo(),
-                    Metrics = new BeatmapMetrics
+                    OnlineInfo = new APIBeatmap
                     {
-                        Fails = Enumerable.Range(1, 100).Select(j => j % 12 - 6).ToArray(),
-                        Retries = Enumerable.Range(-2, 100).Select(j => j % 12 - 6).ToArray(),
-                    },
+                        Metrics = new BeatmapMetrics
+                        {
+                            Fails = Enumerable.Range(1, 100).Select(j => j % 12 - 6).ToArray(),
+                            Retries = Enumerable.Range(-2, 100).Select(j => j % 12 - 6).ToArray(),
+                        },
+                    }
                 });
             }
 
diff --git a/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlayDetails.cs b/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlayDetails.cs
index f16d5aaa23..078e50e0d9 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlayDetails.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlayDetails.cs
@@ -50,11 +50,14 @@ namespace osu.Game.Tests.Visual.Online
                 {
                     new BeatmapInfo
                     {
-                        Metrics = new BeatmapMetrics
+                        OnlineInfo = new APIBeatmap
                         {
-                            Fails = Enumerable.Range(1, 100).Select(_ => RNG.Next(10)).ToArray(),
-                            Retries = Enumerable.Range(-2, 100).Select(_ => RNG.Next(10)).ToArray(),
-                        },
+                            Metrics = new BeatmapMetrics
+                            {
+                                Fails = Enumerable.Range(1, 100).Select(_ => RNG.Next(10)).ToArray(),
+                                Retries = Enumerable.Range(-2, 100).Select(_ => RNG.Next(10)).ToArray(),
+                            },
+                        }
                     }
                 },
                 OnlineInfo = new APIBeatmapSet
diff --git a/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlaySuccessRate.cs b/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlaySuccessRate.cs
index fe8e33f783..84d0b9f868 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlaySuccessRate.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlaySuccessRate.cs
@@ -11,6 +11,7 @@ using osu.Framework.Testing;
 using osu.Framework.Utils;
 using osu.Game.Beatmaps;
 using osu.Game.Graphics.UserInterface;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays;
 using osu.Game.Overlays.BeatmapSet;
 using osu.Game.Screens.Select.Details;
@@ -66,10 +67,13 @@ namespace osu.Game.Tests.Visual.Online
 
             static BeatmapInfo createBeatmap() => new BeatmapInfo
             {
-                Metrics = new BeatmapMetrics
+                OnlineInfo = new APIBeatmap
                 {
-                    Fails = Enumerable.Range(1, 100).Select(_ => RNG.Next(10)).ToArray(),
-                    Retries = Enumerable.Range(-2, 100).Select(_ => RNG.Next(10)).ToArray(),
+                    Metrics = new BeatmapMetrics
+                    {
+                        Fails = Enumerable.Range(1, 100).Select(_ => RNG.Next(10)).ToArray(),
+                        Retries = Enumerable.Range(-2, 100).Select(_ => RNG.Next(10)).ToArray(),
+                    }
                 }
             };
         }
@@ -79,13 +83,16 @@ namespace osu.Game.Tests.Visual.Online
         {
             AddStep("set beatmap", () => successRate.BeatmapInfo = new BeatmapInfo
             {
-                Metrics = new BeatmapMetrics
+                OnlineInfo = new APIBeatmap
                 {
-                    Fails = Enumerable.Range(1, 100).ToArray(),
+                    Metrics = new BeatmapMetrics
+                    {
+                        Fails = Enumerable.Range(1, 100).ToArray(),
+                    }
                 }
             });
-            AddAssert("graph max values correct",
-                () => successRate.ChildrenOfType<BarGraph>().All(graph => graph.MaxValue == 100));
+
+            AddAssert("graph max values correct", () => successRate.ChildrenOfType<BarGraph>().All(graph => graph.MaxValue == 100));
         }
 
         [Test]
@@ -93,11 +100,13 @@ namespace osu.Game.Tests.Visual.Online
         {
             AddStep("set beatmap", () => successRate.BeatmapInfo = new BeatmapInfo
             {
-                Metrics = new BeatmapMetrics()
+                OnlineInfo = new APIBeatmap
+                {
+                    Metrics = new BeatmapMetrics(),
+                }
             });
 
-            AddAssert("graph max values correct",
-                () => successRate.ChildrenOfType<BarGraph>().All(graph => graph.MaxValue == 0));
+            AddAssert("graph max values correct", () => successRate.ChildrenOfType<BarGraph>().All(graph => graph.MaxValue == 0));
         }
 
         private class GraphExposingSuccessRate : SuccessRate
diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapDetails.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapDetails.cs
index 6b508878bf..4bdb8539ba 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapDetails.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapDetails.cs
@@ -54,11 +54,14 @@ namespace osu.Game.Tests.Visual.SongSelect
                     ApproachRate = 3.5f,
                 },
                 StarDifficulty = 5.3f,
-                Metrics = new BeatmapMetrics
+                OnlineInfo = new APIBeatmap
                 {
-                    Fails = Enumerable.Range(1, 100).Select(i => i % 12 - 6).ToArray(),
-                    Retries = Enumerable.Range(-2, 100).Select(i => i % 12 - 6).ToArray(),
-                },
+                    Metrics = new BeatmapMetrics
+                    {
+                        Fails = Enumerable.Range(1, 100).Select(i => i % 12 - 6).ToArray(),
+                        Retries = Enumerable.Range(-2, 100).Select(i => i % 12 - 6).ToArray(),
+                    },
+                }
             });
         }
 
@@ -87,11 +90,14 @@ namespace osu.Game.Tests.Visual.SongSelect
                     ApproachRate = 3.5f,
                 },
                 StarDifficulty = 5.3f,
-                Metrics = new BeatmapMetrics
+                OnlineInfo = new APIBeatmap
                 {
-                    Fails = Enumerable.Range(1, 100).Select(i => i % 12 - 6).ToArray(),
-                    Retries = Enumerable.Range(-2, 100).Select(i => i % 12 - 6).ToArray(),
-                },
+                    Metrics = new BeatmapMetrics
+                    {
+                        Fails = Enumerable.Range(1, 100).Select(i => i % 12 - 6).ToArray(),
+                        Retries = Enumerable.Range(-2, 100).Select(i => i % 12 - 6).ToArray(),
+                    },
+                }
             });
         }
 
@@ -143,11 +149,14 @@ namespace osu.Game.Tests.Visual.SongSelect
                     ApproachRate = 7,
                 },
                 StarDifficulty = 2.91f,
-                Metrics = new BeatmapMetrics
+                OnlineInfo = new APIBeatmap
                 {
-                    Fails = Enumerable.Range(1, 100).Select(i => i % 12 - 6).ToArray(),
-                    Retries = Enumerable.Range(-2, 100).Select(i => i % 12 - 6).ToArray(),
-                },
+                    Metrics = new BeatmapMetrics
+                    {
+                        Fails = Enumerable.Range(1, 100).Select(i => i % 12 - 6).ToArray(),
+                        Retries = Enumerable.Range(-2, 100).Select(i => i % 12 - 6).ToArray(),
+                    },
+                }
             });
         }
 
diff --git a/osu.Game/Beatmaps/BeatmapInfo.cs b/osu.Game/Beatmaps/BeatmapInfo.cs
index 6da50657a6..fb599853c7 100644
--- a/osu.Game/Beatmaps/BeatmapInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapInfo.cs
@@ -47,10 +47,7 @@ namespace osu.Game.Beatmaps
         public BeatmapDifficulty BaseDifficulty { get; set; }
 
         [NotMapped]
-        public BeatmapMetrics Metrics { get; set; }
-
-        [NotMapped]
-        public BeatmapOnlineInfo OnlineInfo { get; set; }
+        public IBeatmapOnlineInfo OnlineInfo { get; set; }
 
         [NotMapped]
         public int? MaxCombo { get; set; }
@@ -192,5 +189,24 @@ namespace osu.Game.Beatmaps
         double IBeatmapInfo.StarRating => StarDifficulty;
 
         #endregion
+
+        #region Implementation of IBeatmapOnlineInfo
+
+        [JsonIgnore]
+        public int CircleCount => OnlineInfo.CircleCount;
+
+        [JsonIgnore]
+        public int SliderCount => OnlineInfo.SliderCount;
+
+        [JsonIgnore]
+        public int PlayCount => OnlineInfo.PlayCount;
+
+        [JsonIgnore]
+        public int PassCount => OnlineInfo.PassCount;
+
+        [JsonIgnore]
+        public BeatmapMetrics Metrics => OnlineInfo.Metrics;
+
+        #endregion
     }
 }
diff --git a/osu.Game/Beatmaps/BeatmapOnlineInfo.cs b/osu.Game/Beatmaps/BeatmapOnlineInfo.cs
deleted file mode 100644
index bfeacd9bfc..0000000000
--- a/osu.Game/Beatmaps/BeatmapOnlineInfo.cs
+++ /dev/null
@@ -1,31 +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.Beatmaps
-{
-    /// <summary>
-    /// Beatmap info retrieved for previewing locally without having the beatmap downloaded.
-    /// </summary>
-    public class BeatmapOnlineInfo
-    {
-        /// <summary>
-        /// The amount of circles in this beatmap.
-        /// </summary>
-        public int CircleCount { get; set; }
-
-        /// <summary>
-        /// The amount of sliders in this beatmap.
-        /// </summary>
-        public int SliderCount { get; set; }
-
-        /// <summary>
-        /// The amount of plays this beatmap has.
-        /// </summary>
-        public int PlayCount { get; set; }
-
-        /// <summary>
-        /// The amount of passes this beatmap has.
-        /// </summary>
-        public int PassCount { get; set; }
-    }
-}
diff --git a/osu.Game/Beatmaps/IBeatmapOnlineInfo.cs b/osu.Game/Beatmaps/IBeatmapOnlineInfo.cs
index 4898e45c56..9f8e739759 100644
--- a/osu.Game/Beatmaps/IBeatmapOnlineInfo.cs
+++ b/osu.Game/Beatmaps/IBeatmapOnlineInfo.cs
@@ -10,8 +10,31 @@ namespace osu.Game.Beatmaps
     /// </summary>
     public interface IBeatmapOnlineInfo
     {
+        /// <summary>
+        /// The max combo of this beatmap.
+        /// </summary>
         int? MaxCombo { get; }
 
+        /// <summary>
+        /// The amount of circles in this beatmap.
+        /// </summary>
+        public int CircleCount { get; }
+
+        /// <summary>
+        /// The amount of sliders in this beatmap.
+        /// </summary>
+        public int SliderCount { get; }
+
+        /// <summary>
+        /// The amount of plays this beatmap has.
+        /// </summary>
+        public int PlayCount { get; }
+
+        /// <summary>
+        /// The amount of passes this beatmap has.
+        /// </summary>
+        public int PassCount { get; }
+
         BeatmapMetrics? Metrics { get; }
     }
 }
diff --git a/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs b/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs
index 6a05811bba..f0f97cc11c 100644
--- a/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs
@@ -31,10 +31,10 @@ namespace osu.Game.Online.API.Requests.Responses
         public APIBeatmapSet? BeatmapSet { get; set; }
 
         [JsonProperty(@"playcount")]
-        private int playCount { get; set; }
+        public int PlayCount { get; set; }
 
         [JsonProperty(@"passcount")]
-        private int passCount { get; set; }
+        public int PassCount { get; set; }
 
         [JsonProperty(@"mode_int")]
         public int RulesetID { get; set; }
@@ -60,10 +60,10 @@ namespace osu.Game.Online.API.Requests.Responses
         private double lengthInSeconds { get; set; }
 
         [JsonProperty(@"count_circles")]
-        private int circleCount { get; set; }
+        public int CircleCount { get; set; }
 
         [JsonProperty(@"count_sliders")]
-        private int sliderCount { get; set; }
+        public int SliderCount { get; set; }
 
         [JsonProperty(@"version")]
         public string DifficultyName { get; set; } = string.Empty;
@@ -90,7 +90,6 @@ namespace osu.Game.Online.API.Requests.Responses
                 Status = Status,
                 MD5Hash = Checksum,
                 BeatmapSet = set,
-                Metrics = Metrics,
                 MaxCombo = MaxCombo,
                 BaseDifficulty = new BeatmapDifficulty
                 {
@@ -99,13 +98,7 @@ namespace osu.Game.Online.API.Requests.Responses
                     ApproachRate = approachRate,
                     OverallDifficulty = overallDifficulty,
                 },
-                OnlineInfo = new BeatmapOnlineInfo
-                {
-                    PlayCount = playCount,
-                    PassCount = passCount,
-                    CircleCount = circleCount,
-                    SliderCount = sliderCount,
-                },
+                OnlineInfo = this,
             };
         }
 
diff --git a/osu.Game/Screens/Select/BeatmapDetails.cs b/osu.Game/Screens/Select/BeatmapDetails.cs
index 8dbe438ab5..9fab36229f 100644
--- a/osu.Game/Screens/Select/BeatmapDetails.cs
+++ b/osu.Game/Screens/Select/BeatmapDetails.cs
@@ -55,8 +55,8 @@ namespace osu.Game.Screens.Select
 
                 beatmapInfo = value;
 
-                metrics = beatmapInfo?.Metrics;
-                ratings = beatmapInfo?.BeatmapSet.Ratings;
+                metrics = beatmapInfo?.OnlineInfo?.Metrics;
+                ratings = beatmapInfo?.BeatmapSet?.Ratings;
 
                 Scheduler.AddOnce(updateStatistics);
             }
diff --git a/osu.Game/Tests/Beatmaps/TestBeatmap.cs b/osu.Game/Tests/Beatmaps/TestBeatmap.cs
index d8e72d31a7..15b72ce6e3 100644
--- a/osu.Game/Tests/Beatmaps/TestBeatmap.cs
+++ b/osu.Game/Tests/Beatmaps/TestBeatmap.cs
@@ -32,7 +32,7 @@ namespace osu.Game.Tests.Beatmaps
             BeatmapInfo.BeatmapSet.Metadata = BeatmapInfo.Metadata;
             BeatmapInfo.BeatmapSet.Beatmaps = new List<BeatmapInfo> { BeatmapInfo };
             BeatmapInfo.Length = 75000;
-            BeatmapInfo.OnlineInfo = new BeatmapOnlineInfo();
+            BeatmapInfo.OnlineInfo = new APIBeatmap();
             BeatmapInfo.BeatmapSet.OnlineInfo = new APIBeatmapSet
             {
                 Status = BeatmapSetOnlineStatus.Ranked,

From 4969ab0599a9f60158a40fe51798cf9420e4b9da Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 25 Oct 2021 15:12:21 +0900
Subject: [PATCH 0446/5547] Add forgotten `JsonIgnore` rules on interface types

Just to avoid them getting serialised as part of the "new" .osu
serialisation format.
---
 osu.Game/Beatmaps/BeatmapInfo.cs | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/osu.Game/Beatmaps/BeatmapInfo.cs b/osu.Game/Beatmaps/BeatmapInfo.cs
index fb599853c7..7be58e6472 100644
--- a/osu.Game/Beatmaps/BeatmapInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapInfo.cs
@@ -181,11 +181,22 @@ namespace osu.Game.Beatmaps
 
         #region Implementation of IBeatmapInfo
 
+        [JsonIgnore]
         string IBeatmapInfo.DifficultyName => Version;
+
+        [JsonIgnore]
         IBeatmapMetadataInfo IBeatmapInfo.Metadata => Metadata;
+
+        [JsonIgnore]
         IBeatmapDifficultyInfo IBeatmapInfo.Difficulty => BaseDifficulty;
+
+        [JsonIgnore]
         IBeatmapSetInfo IBeatmapInfo.BeatmapSet => BeatmapSet;
+
+        [JsonIgnore]
         IRulesetInfo IBeatmapInfo.Ruleset => Ruleset;
+
+        [JsonIgnore]
         double IBeatmapInfo.StarRating => StarDifficulty;
 
         #endregion

From 2c308f3008c9c08e5ec94029965a4a601a6701f6 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 25 Oct 2021 15:34:41 +0900
Subject: [PATCH 0447/5547] Rename `BeatmapMetrics` to `APIFailTimes`

---
 .../Visual/Online/TestSceneBeatmapSetOverlay.cs   |  8 ++++----
 .../Online/TestSceneBeatmapSetOverlayDetails.cs   |  2 +-
 .../TestSceneBeatmapSetOverlaySuccessRate.cs      | 10 +++++-----
 .../Visual/SongSelect/TestSceneBeatmapDetails.cs  |  6 +++---
 .../{BeatmapMetrics.cs => APIFailTimes.cs}        |  2 +-
 osu.Game/Beatmaps/BeatmapInfo.cs                  |  2 +-
 osu.Game/Beatmaps/IBeatmapOnlineInfo.cs           |  2 +-
 .../Online/API/Requests/Responses/APIBeatmap.cs   |  2 +-
 osu.Game/Overlays/BeatmapSet/SuccessRate.cs       |  2 +-
 osu.Game/Screens/Select/BeatmapDetails.cs         | 15 ++++++++-------
 osu.Game/Screens/Select/Details/FailRetryGraph.cs | 14 +++++++-------
 11 files changed, 33 insertions(+), 32 deletions(-)
 rename osu.Game/Beatmaps/{BeatmapMetrics.cs => APIFailTimes.cs} (96%)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlay.cs b/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlay.cs
index 3b0c2f5a7a..7f9b56e873 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlay.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlay.cs
@@ -98,7 +98,7 @@ namespace osu.Game.Tests.Visual.Online
                                 SliderCount = 12,
                                 PlayCount = 222,
                                 PassCount = 21,
-                                Metrics = new BeatmapMetrics
+                                FailTimes = new APIFailTimes
                                 {
                                     Fails = Enumerable.Range(1, 100).Select(i => i % 12 - 6).ToArray(),
                                     Retries = Enumerable.Range(-2, 100).Select(i => i % 12 - 6).ToArray(),
@@ -176,7 +176,7 @@ namespace osu.Game.Tests.Visual.Online
                                 SliderCount = 45,
                                 PlayCount = 567,
                                 PassCount = 89,
-                                Metrics = new BeatmapMetrics
+                                FailTimes = new APIFailTimes
                                 {
                                     Fails = Enumerable.Range(1, 100).Select(i => i % 12 - 6).ToArray(),
                                     Retries = Enumerable.Range(-2, 100).Select(i => i % 12 - 6).ToArray(),
@@ -206,7 +206,7 @@ namespace osu.Game.Tests.Visual.Online
                         BaseDifficulty = new BeatmapDifficulty(),
                         OnlineInfo = new APIBeatmap
                         {
-                            Metrics = new BeatmapMetrics
+                            FailTimes = new APIFailTimes
                             {
                                 Fails = Enumerable.Range(1, 100).Select(i => i % 12 - 6).ToArray(),
                                 Retries = Enumerable.Range(-2, 100).Select(i => i % 12 - 6).ToArray(),
@@ -292,7 +292,7 @@ namespace osu.Game.Tests.Visual.Online
                     },
                     OnlineInfo = new APIBeatmap
                     {
-                        Metrics = new BeatmapMetrics
+                        FailTimes = new APIFailTimes
                         {
                             Fails = Enumerable.Range(1, 100).Select(j => j % 12 - 6).ToArray(),
                             Retries = Enumerable.Range(-2, 100).Select(j => j % 12 - 6).ToArray(),
diff --git a/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlayDetails.cs b/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlayDetails.cs
index 078e50e0d9..d14f9f47d1 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlayDetails.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlayDetails.cs
@@ -52,7 +52,7 @@ namespace osu.Game.Tests.Visual.Online
                     {
                         OnlineInfo = new APIBeatmap
                         {
-                            Metrics = new BeatmapMetrics
+                            FailTimes = new APIFailTimes
                             {
                                 Fails = Enumerable.Range(1, 100).Select(_ => RNG.Next(10)).ToArray(),
                                 Retries = Enumerable.Range(-2, 100).Select(_ => RNG.Next(10)).ToArray(),
diff --git a/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlaySuccessRate.cs b/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlaySuccessRate.cs
index 84d0b9f868..b3b67fcbca 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlaySuccessRate.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlaySuccessRate.cs
@@ -60,16 +60,16 @@ namespace osu.Game.Tests.Visual.Online
             var secondBeatmap = createBeatmap();
 
             AddStep("set first set", () => successRate.BeatmapInfo = firstBeatmap);
-            AddAssert("ratings set", () => successRate.Graph.Metrics == firstBeatmap.Metrics);
+            AddAssert("ratings set", () => successRate.Graph.FailTimes == firstBeatmap.FailTimes);
 
             AddStep("set second set", () => successRate.BeatmapInfo = secondBeatmap);
-            AddAssert("ratings set", () => successRate.Graph.Metrics == secondBeatmap.Metrics);
+            AddAssert("ratings set", () => successRate.Graph.FailTimes == secondBeatmap.FailTimes);
 
             static BeatmapInfo createBeatmap() => new BeatmapInfo
             {
                 OnlineInfo = new APIBeatmap
                 {
-                    Metrics = new BeatmapMetrics
+                    FailTimes = new APIFailTimes
                     {
                         Fails = Enumerable.Range(1, 100).Select(_ => RNG.Next(10)).ToArray(),
                         Retries = Enumerable.Range(-2, 100).Select(_ => RNG.Next(10)).ToArray(),
@@ -85,7 +85,7 @@ namespace osu.Game.Tests.Visual.Online
             {
                 OnlineInfo = new APIBeatmap
                 {
-                    Metrics = new BeatmapMetrics
+                    FailTimes = new APIFailTimes
                     {
                         Fails = Enumerable.Range(1, 100).ToArray(),
                     }
@@ -102,7 +102,7 @@ namespace osu.Game.Tests.Visual.Online
             {
                 OnlineInfo = new APIBeatmap
                 {
-                    Metrics = new BeatmapMetrics(),
+                    FailTimes = new APIFailTimes(),
                 }
             });
 
diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapDetails.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapDetails.cs
index 4bdb8539ba..1125e16d91 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapDetails.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapDetails.cs
@@ -56,7 +56,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                 StarDifficulty = 5.3f,
                 OnlineInfo = new APIBeatmap
                 {
-                    Metrics = new BeatmapMetrics
+                    FailTimes = new APIFailTimes
                     {
                         Fails = Enumerable.Range(1, 100).Select(i => i % 12 - 6).ToArray(),
                         Retries = Enumerable.Range(-2, 100).Select(i => i % 12 - 6).ToArray(),
@@ -92,7 +92,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                 StarDifficulty = 5.3f,
                 OnlineInfo = new APIBeatmap
                 {
-                    Metrics = new BeatmapMetrics
+                    FailTimes = new APIFailTimes
                     {
                         Fails = Enumerable.Range(1, 100).Select(i => i % 12 - 6).ToArray(),
                         Retries = Enumerable.Range(-2, 100).Select(i => i % 12 - 6).ToArray(),
@@ -151,7 +151,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                 StarDifficulty = 2.91f,
                 OnlineInfo = new APIBeatmap
                 {
-                    Metrics = new BeatmapMetrics
+                    FailTimes = new APIFailTimes
                     {
                         Fails = Enumerable.Range(1, 100).Select(i => i % 12 - 6).ToArray(),
                         Retries = Enumerable.Range(-2, 100).Select(i => i % 12 - 6).ToArray(),
diff --git a/osu.Game/Beatmaps/BeatmapMetrics.cs b/osu.Game/Beatmaps/APIFailTimes.cs
similarity index 96%
rename from osu.Game/Beatmaps/BeatmapMetrics.cs
rename to osu.Game/Beatmaps/APIFailTimes.cs
index b164aa6b30..7218906b38 100644
--- a/osu.Game/Beatmaps/BeatmapMetrics.cs
+++ b/osu.Game/Beatmaps/APIFailTimes.cs
@@ -9,7 +9,7 @@ namespace osu.Game.Beatmaps
     /// <summary>
     /// Beatmap metrics based on accumulated online data from community plays.
     /// </summary>
-    public class BeatmapMetrics
+    public class APIFailTimes
     {
         /// <summary>
         /// Points of failure on a relative time scale (usually 0..100).
diff --git a/osu.Game/Beatmaps/BeatmapInfo.cs b/osu.Game/Beatmaps/BeatmapInfo.cs
index 7be58e6472..571809db36 100644
--- a/osu.Game/Beatmaps/BeatmapInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapInfo.cs
@@ -216,7 +216,7 @@ namespace osu.Game.Beatmaps
         public int PassCount => OnlineInfo.PassCount;
 
         [JsonIgnore]
-        public BeatmapMetrics Metrics => OnlineInfo.Metrics;
+        public APIFailTimes FailTimes => OnlineInfo.FailTimes;
 
         #endregion
     }
diff --git a/osu.Game/Beatmaps/IBeatmapOnlineInfo.cs b/osu.Game/Beatmaps/IBeatmapOnlineInfo.cs
index 9f8e739759..385646eeaa 100644
--- a/osu.Game/Beatmaps/IBeatmapOnlineInfo.cs
+++ b/osu.Game/Beatmaps/IBeatmapOnlineInfo.cs
@@ -35,6 +35,6 @@ namespace osu.Game.Beatmaps
         /// </summary>
         public int PassCount { get; }
 
-        BeatmapMetrics? Metrics { get; }
+        APIFailTimes? FailTimes { get; }
     }
 }
diff --git a/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs b/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs
index f0f97cc11c..de86f0f875 100644
--- a/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs
@@ -69,7 +69,7 @@ namespace osu.Game.Online.API.Requests.Responses
         public string DifficultyName { get; set; } = string.Empty;
 
         [JsonProperty(@"failtimes")]
-        public BeatmapMetrics? Metrics { get; set; }
+        public APIFailTimes? FailTimes { get; set; }
 
         [JsonProperty(@"max_combo")]
         public int? MaxCombo { get; set; }
diff --git a/osu.Game/Overlays/BeatmapSet/SuccessRate.cs b/osu.Game/Overlays/BeatmapSet/SuccessRate.cs
index 4a9b8244a5..604c4e1949 100644
--- a/osu.Game/Overlays/BeatmapSet/SuccessRate.cs
+++ b/osu.Game/Overlays/BeatmapSet/SuccessRate.cs
@@ -48,7 +48,7 @@ namespace osu.Game.Overlays.BeatmapSet
             successRate.Length = rate;
             percentContainer.ResizeWidthTo(successRate.Length, 250, Easing.InOutCubic);
 
-            Graph.Metrics = beatmapInfo?.Metrics;
+            Graph.FailTimes = beatmapInfo?.FailTimes;
         }
 
         public SuccessRate()
diff --git a/osu.Game/Screens/Select/BeatmapDetails.cs b/osu.Game/Screens/Select/BeatmapDetails.cs
index 9fab36229f..16455940bf 100644
--- a/osu.Game/Screens/Select/BeatmapDetails.cs
+++ b/osu.Game/Screens/Select/BeatmapDetails.cs
@@ -43,7 +43,8 @@ namespace osu.Game.Screens.Select
 
         private BeatmapInfo beatmapInfo;
 
-        private BeatmapMetrics metrics;
+        private APIFailTimes failTimes;
+
         private int[] ratings;
 
         public BeatmapInfo BeatmapInfo
@@ -55,7 +56,7 @@ namespace osu.Game.Screens.Select
 
                 beatmapInfo = value;
 
-                metrics = beatmapInfo?.OnlineInfo?.Metrics;
+                failTimes = beatmapInfo?.OnlineInfo?.FailTimes;
                 ratings = beatmapInfo?.BeatmapSet?.Ratings;
 
                 Scheduler.AddOnce(updateStatistics);
@@ -182,7 +183,7 @@ namespace osu.Game.Screens.Select
             tags.Text = BeatmapInfo?.Metadata?.Tags;
 
             // metrics may have been previously fetched
-            if (ratings != null && metrics != null)
+            if (ratings != null && failTimes != null)
             {
                 updateMetrics();
                 return;
@@ -208,7 +209,7 @@ namespace osu.Game.Screens.Select
                         return;
 
                     ratings = res.BeatmapSet?.Ratings;
-                    metrics = res.Metrics;
+                    failTimes = res.FailTimes;
 
                     updateMetrics();
                 });
@@ -232,7 +233,7 @@ namespace osu.Game.Screens.Select
 
         private void updateMetrics()
         {
-            var hasMetrics = (metrics?.Retries?.Any() ?? false) || (metrics?.Fails?.Any() ?? false);
+            var hasMetrics = (failTimes?.Retries?.Any() ?? false) || (failTimes?.Fails?.Any() ?? false);
 
             if (ratings?.Any() ?? false)
             {
@@ -248,12 +249,12 @@ namespace osu.Game.Screens.Select
 
             if (hasMetrics)
             {
-                failRetryGraph.Metrics = metrics;
+                failRetryGraph.FailTimes = failTimes;
                 failRetryContainer.FadeIn(transition_duration);
             }
             else
             {
-                failRetryGraph.Metrics = new BeatmapMetrics
+                failRetryGraph.FailTimes = new APIFailTimes
                 {
                     Fails = new int[100],
                     Retries = new int[100],
diff --git a/osu.Game/Screens/Select/Details/FailRetryGraph.cs b/osu.Game/Screens/Select/Details/FailRetryGraph.cs
index 7cc80acfd3..ecaf02cb30 100644
--- a/osu.Game/Screens/Select/Details/FailRetryGraph.cs
+++ b/osu.Game/Screens/Select/Details/FailRetryGraph.cs
@@ -16,19 +16,19 @@ namespace osu.Game.Screens.Select.Details
     {
         private readonly BarGraph retryGraph, failGraph;
 
-        private BeatmapMetrics metrics;
+        private APIFailTimes failTimes;
 
-        public BeatmapMetrics Metrics
+        public APIFailTimes FailTimes
         {
-            get => metrics;
+            get => failTimes;
             set
             {
-                if (value == metrics) return;
+                if (value == failTimes) return;
 
-                metrics = value;
+                failTimes = value;
 
-                var retries = Metrics?.Retries ?? Array.Empty<int>();
-                var fails = Metrics?.Fails ?? Array.Empty<int>();
+                var retries = FailTimes?.Retries ?? Array.Empty<int>();
+                var fails = FailTimes?.Fails ?? Array.Empty<int>();
                 var retriesAndFails = sumRetriesAndFails(retries, fails);
 
                 float maxValue = retriesAndFails.Any() ? retriesAndFails.Max() : 0;

From 67ef1c40e64ca935a5f4b9ee666b72cb15da9182 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 25 Oct 2021 15:59:40 +0900
Subject: [PATCH 0448/5547] Allow API beatmap requests using interface type

---
 osu.Game/Online/API/Requests/GetBeatmapRequest.cs | 12 +++++++++---
 1 file changed, 9 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Online/API/Requests/GetBeatmapRequest.cs b/osu.Game/Online/API/Requests/GetBeatmapRequest.cs
index 901f7365b8..aa0d51641e 100644
--- a/osu.Game/Online/API/Requests/GetBeatmapRequest.cs
+++ b/osu.Game/Online/API/Requests/GetBeatmapRequest.cs
@@ -4,17 +4,23 @@
 using osu.Game.Beatmaps;
 using osu.Game.Online.API.Requests.Responses;
 
+#nullable enable
+
 namespace osu.Game.Online.API.Requests
 {
     public class GetBeatmapRequest : APIRequest<APIBeatmap>
     {
-        private readonly BeatmapInfo beatmapInfo;
+        private readonly IBeatmapInfo beatmapInfo;
 
-        public GetBeatmapRequest(BeatmapInfo beatmapInfo)
+        private readonly string filename;
+
+        public GetBeatmapRequest(IBeatmapInfo beatmapInfo)
         {
             this.beatmapInfo = beatmapInfo;
+
+            filename = (beatmapInfo as BeatmapInfo)?.Path ?? string.Empty;
         }
 
-        protected override string Target => $@"beatmaps/lookup?id={beatmapInfo.OnlineBeatmapID}&checksum={beatmapInfo.MD5Hash}&filename={System.Uri.EscapeUriString(beatmapInfo.Path ?? string.Empty)}";
+        protected override string Target => $@"beatmaps/lookup?id={beatmapInfo.OnlineID}&checksum={beatmapInfo.MD5Hash}&filename={System.Uri.EscapeUriString(filename)}";
     }
 }

From 7a92c7ab7e0c2c888845f0a16dbf8189ecc50ea2 Mon Sep 17 00:00:00 2001
From: Roxie Wattz <roxie.wattz@gmail.com>
Date: Mon, 25 Oct 2021 00:25:32 -0700
Subject: [PATCH 0449/5547] Move condition to separate switch statement No clue
 if this is how peppy wanted me to do it but it still works

---
 .../Mods/TestSceneOsuModHidden.cs             |   2 +-
 osu.Game.Rulesets.Osu/Mods/OsuModHidden.cs    | 107 +++++++++++-------
 2 files changed, 65 insertions(+), 44 deletions(-)

diff --git a/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModHidden.cs b/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModHidden.cs
index f25df90737..1fd601cec5 100644
--- a/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModHidden.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModHidden.cs
@@ -120,7 +120,7 @@ namespace osu.Game.Rulesets.Osu.Tests.Mods
         [Test]
         public void OuendanTwoHidden() => CreateModTest(new ModTestData
         {
-            Mod = new OsuModHidden { NoHitCircles = { Value = true } },
+            Mod = new OsuModHidden { OnlyFadeApproachCircles = { Value = true } },
             Autoplay = true,
             Beatmap = new Beatmap
             {
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModHidden.cs b/osu.Game.Rulesets.Osu/Mods/OsuModHidden.cs
index 59ac6746a0..12e2035e80 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModHidden.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModHidden.cs
@@ -21,7 +21,7 @@ namespace osu.Game.Rulesets.Osu.Mods
     public class OsuModHidden : ModHidden, IHidesApproachCircles
     {
         [SettingSource("Only fade approach circles", "The main object body will not fade when enabled.")]
-        public Bindable<bool> NoHitCircles { get; } = new BindableBool(false);
+        public Bindable<bool> OnlyFadeApproachCircles { get; } = new BindableBool(false);
 
         public override string Description => @"Play with no approach circles and fading circles/sliders.";
         public override double ScoreMultiplier => 1.06;
@@ -67,69 +67,90 @@ namespace osu.Game.Rulesets.Osu.Mods
 
             (double fadeStartTime, double fadeDuration) = getFadeOutParameters(drawableOsuObject);
 
-            switch (drawableObject)
+            if (!OnlyFadeApproachCircles.Value)
             {
-                case DrawableSliderTail _:
-                    using (drawableObject.BeginAbsoluteSequence(fadeStartTime))
-                        if (!NoHitCircles.Value)
+                switch (drawableObject)
+                {
+                    case DrawableSliderTail _:
+                        using (drawableObject.BeginAbsoluteSequence(fadeStartTime))
                             drawableObject.FadeOut(fadeDuration);
 
-                    break;
+                        break;
 
-                case DrawableSliderRepeat sliderRepeat:
-                    using (drawableObject.BeginAbsoluteSequence(fadeStartTime))
-                        // only apply to circle piece – reverse arrow is not affected by hidden.
-                        if (!NoHitCircles.Value)
+                    case DrawableSliderRepeat sliderRepeat:
+                        using (drawableObject.BeginAbsoluteSequence(fadeStartTime))
+                            // only apply to circle piece – reverse arrow is not affected by hidden.
                             sliderRepeat.CirclePiece.FadeOut(fadeDuration);
 
-                    break;
+                        break;
 
-                case DrawableHitCircle circle:
-                    Drawable fadeTarget = circle;
+                    case DrawableHitCircle circle:
+                        Drawable fadeTarget = circle;
 
-                    if (increaseVisibility)
-                    {
-                        // only fade the circle piece (not the approach circle) for the increased visibility object.
-                        if (!NoHitCircles.Value)
+                        if (increaseVisibility)
+                        {
+                            // only fade the circle piece (not the approach circle) for the increased visibility object.
                             fadeTarget = circle.CirclePiece;
-                    }
-                    else
-                    {
-                        // we don't want to see the approach circle
-                        using (circle.BeginAbsoluteSequence(hitObject.StartTime - hitObject.TimePreempt))
-                            circle.ApproachCircle.Hide();
-                    }
+                        }
+                        else
+                        {
+                            // we don't want to see the approach circle
+                            using (circle.BeginAbsoluteSequence(hitObject.StartTime - hitObject.TimePreempt))
+                                circle.ApproachCircle.Hide();
+                        }
 
-                    using (drawableObject.BeginAbsoluteSequence(fadeStartTime))
-                        if (!NoHitCircles.Value)
+                        using (drawableObject.BeginAbsoluteSequence(fadeStartTime))
                             fadeTarget.FadeOut(fadeDuration);
-                    break;
+                        break;
 
-                case DrawableSlider slider:
-                    using (slider.BeginAbsoluteSequence(fadeStartTime))
-                        if (!NoHitCircles.Value)
+                    case DrawableSlider slider:
+                        using (slider.BeginAbsoluteSequence(fadeStartTime))
                             slider.Body.FadeOut(fadeDuration, Easing.Out);
 
-                    break;
+                        break;
 
-                case DrawableSliderTick sliderTick:
-                    using (sliderTick.BeginAbsoluteSequence(fadeStartTime))
-                        if (!NoHitCircles.Value)
+                    case DrawableSliderTick sliderTick:
+                        using (sliderTick.BeginAbsoluteSequence(fadeStartTime))
                             sliderTick.FadeOut(fadeDuration);
 
-                    break;
+                        break;
 
-                case DrawableSpinner spinner:
-                    // hide elements we don't care about.
-                    // todo: hide background
+                    case DrawableSpinner spinner:
+                        // hide elements we don't care about.
+                        // todo: hide background
 
-                    spinner.Body.OnSkinChanged += () => hideSpinnerApproachCircle(spinner);
-                    hideSpinnerApproachCircle(spinner);
+                        spinner.Body.OnSkinChanged += () => hideSpinnerApproachCircle(spinner);
+                        hideSpinnerApproachCircle(spinner);
 
-                    using (spinner.BeginAbsoluteSequence(fadeStartTime))
-                        spinner.FadeOut(fadeDuration);
+                        using (spinner.BeginAbsoluteSequence(fadeStartTime))
+                            spinner.FadeOut(fadeDuration);
 
-                    break;
+                        break;
+                }
+            } else
+            {
+                switch(drawableObject)
+                {
+                    case DrawableHitCircle circle:
+                        if (!increaseVisibility)
+                        {
+                            // we don't want to see the approach circle
+                            using (circle.BeginAbsoluteSequence(hitObject.StartTime - hitObject.TimePreempt))
+                                circle.ApproachCircle.Hide();
+                        }
+                        break;
+
+                    case DrawableSpinner spinner:
+                        // hide elements we don't care about.
+                        // todo: hide background
+
+                        spinner.Body.OnSkinChanged += () => hideSpinnerApproachCircle(spinner);
+                        hideSpinnerApproachCircle(spinner);
+                        break;
+
+                    default:
+                        break;
+                }
             }
         }
 

From 6d1cd0a3a14d28b237c827cf8ba62ca5c2658824 Mon Sep 17 00:00:00 2001
From: ekrctb <ekrctb@gmail.com>
Date: Mon, 25 Oct 2021 16:37:44 +0900
Subject: [PATCH 0450/5547] Add distance snapping to catch editor

---
 .../Edit/CatchHitObjectComposer.cs            | 116 +++++++++++++++++-
 1 file changed, 115 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Catch/Edit/CatchHitObjectComposer.cs b/osu.Game.Rulesets.Catch/Edit/CatchHitObjectComposer.cs
index 050c2f625d..9b779d3370 100644
--- a/osu.Game.Rulesets.Catch/Edit/CatchHitObjectComposer.cs
+++ b/osu.Game.Rulesets.Catch/Edit/CatchHitObjectComposer.cs
@@ -2,14 +2,23 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System.Collections.Generic;
+using System.Linq;
+using JetBrains.Annotations;
 using osu.Framework.Allocation;
+using osu.Framework.Bindables;
 using osu.Framework.Graphics;
+using osu.Framework.Graphics.Sprites;
+using osu.Framework.Input;
 using osu.Game.Beatmaps;
+using osu.Game.Graphics.UserInterface;
 using osu.Game.Rulesets.Catch.Objects;
+using osu.Game.Rulesets.Catch.UI;
 using osu.Game.Rulesets.Edit;
 using osu.Game.Rulesets.Edit.Tools;
 using osu.Game.Rulesets.Mods;
+using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.UI;
+using osu.Game.Screens.Edit.Components.TernaryButtons;
 using osu.Game.Screens.Edit.Compose.Components;
 using osuTK;
 
@@ -17,6 +26,14 @@ namespace osu.Game.Rulesets.Catch.Edit
 {
     public class CatchHitObjectComposer : HitObjectComposer<CatchHitObject>
     {
+        private const float distance_snap_radius = 50;
+
+        private CatchDistanceSnapGrid distanceSnapGrid;
+
+        private readonly Bindable<TernaryState> distanceSnapToggle = new Bindable<TernaryState>();
+
+        private InputManager inputManager;
+
         public CatchHitObjectComposer(CatchRuleset ruleset)
             : base(ruleset)
         {
@@ -30,6 +47,27 @@ namespace osu.Game.Rulesets.Catch.Edit
                 RelativeSizeAxes = Axes.Both,
                 PlayfieldBorderStyle = { Value = PlayfieldBorderStyle.Corners }
             });
+
+            LayerBelowRuleset.Add(distanceSnapGrid = new CatchDistanceSnapGrid(new[]
+            {
+                0.0,
+                Catcher.BASE_SPEED, -Catcher.BASE_SPEED,
+                Catcher.BASE_SPEED / 2, -Catcher.BASE_SPEED / 2,
+            }));
+        }
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            inputManager = GetContainingInputManager();
+        }
+
+        protected override void Update()
+        {
+            base.Update();
+
+            updateDistanceSnapGrid();
         }
 
         protected override DrawableRuleset<CatchHitObject> CreateDrawableRuleset(Ruleset ruleset, IBeatmap beatmap, IReadOnlyList<Mod> mods = null) =>
@@ -42,14 +80,90 @@ namespace osu.Game.Rulesets.Catch.Edit
             new BananaShowerCompositionTool()
         };
 
+        protected override IEnumerable<TernaryButton> CreateTernaryButtons() => base.CreateTernaryButtons().Concat(new[]
+        {
+            new TernaryButton(distanceSnapToggle, "Distance Snap", () => new SpriteIcon { Icon = FontAwesome.Solid.Ruler })
+        });
+
         public override SnapResult SnapScreenSpacePositionToValidTime(Vector2 screenSpacePosition)
         {
             var result = base.SnapScreenSpacePositionToValidTime(screenSpacePosition);
-            // TODO: implement position snap
             result.ScreenSpacePosition.X = screenSpacePosition.X;
+
+            if (distanceSnapGrid.IsPresent && distanceSnapGrid.GetSnappedPosition(result.ScreenSpacePosition) is SnapResult snapResult &&
+                Vector2.Distance(snapResult.ScreenSpacePosition, result.ScreenSpacePosition) < distance_snap_radius)
+            {
+                result = snapResult;
+            }
+
             return result;
         }
 
         protected override ComposeBlueprintContainer CreateBlueprintContainer() => new CatchBlueprintContainer(this);
+
+        [CanBeNull]
+        private PalpableCatchHitObject getPreviousHitObject(double time)
+        {
+            var hitObject = EditorBeatmap.HitObjects.OfType<CatchHitObject>().LastOrDefault(h => h.GetEndTime() < time && !(h is BananaShower));
+
+            switch (hitObject)
+            {
+                case Fruit fruit:
+                    return fruit;
+
+                case JuiceStream juiceStream:
+                    return juiceStream.NestedHitObjects.OfType<PalpableCatchHitObject>().LastOrDefault(h => !(h is TinyDroplet));
+
+                default:
+                    return null;
+            }
+        }
+
+        [CanBeNull]
+        private PalpableCatchHitObject getDistanceSnapGridSourceHitObject()
+        {
+            switch (BlueprintContainer.CurrentTool)
+            {
+                case SelectTool _:
+                    if (EditorBeatmap.SelectedHitObjects.Count == 0)
+                        return null;
+
+                    double minTime = EditorBeatmap.SelectedHitObjects.Min(hitObject => hitObject.StartTime);
+                    return getPreviousHitObject(minTime);
+
+                case FruitCompositionTool _:
+                case JuiceStreamCompositionTool _:
+                    if (!CursorInPlacementArea)
+                        return null;
+
+                    if (EditorBeatmap.PlacementObject.Value is JuiceStream)
+                    {
+                        // Juice stream path is not subject to snapping.
+                        return null;
+                    }
+
+                    double timeAtCursor = ((CatchPlayfield)Playfield).TimeAtScreenSpacePosition(inputManager.CurrentState.Mouse.Position);
+                    return getPreviousHitObject(timeAtCursor);
+
+                default:
+                    return null;
+            }
+        }
+
+        private void updateDistanceSnapGrid()
+        {
+            var sourceHitObject = getDistanceSnapGridSourceHitObject();
+
+            if (distanceSnapToggle.Value != TernaryState.True || sourceHitObject == null)
+            {
+                distanceSnapGrid.Hide();
+            }
+            else
+            {
+                distanceSnapGrid.Show();
+                distanceSnapGrid.StartTime = sourceHitObject.GetEndTime();
+                distanceSnapGrid.StartX = sourceHitObject.EffectiveX;
+            }
+        }
     }
 }

From 7c99193ada60807bab91c9b27e0eb37e3f01c174 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 25 Oct 2021 16:45:46 +0900
Subject: [PATCH 0451/5547] Add tournament `LadderInfo` serialisation tests

---
 .../NonVisual/LadderInfoSerialisationTest.cs  | 65 +++++++++++++++++++
 .../TournamentTestScene.cs                    | 12 +++-
 osu.Game.Tournament/TournamentSceneManager.cs |  2 +-
 3 files changed, 77 insertions(+), 2 deletions(-)
 create mode 100644 osu.Game.Tournament.Tests/NonVisual/LadderInfoSerialisationTest.cs

diff --git a/osu.Game.Tournament.Tests/NonVisual/LadderInfoSerialisationTest.cs b/osu.Game.Tournament.Tests/NonVisual/LadderInfoSerialisationTest.cs
new file mode 100644
index 0000000000..13cbcd3caf
--- /dev/null
+++ b/osu.Game.Tournament.Tests/NonVisual/LadderInfoSerialisationTest.cs
@@ -0,0 +1,65 @@
+// 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;
+using NUnit.Framework;
+using osu.Game.Tournament.Models;
+
+namespace osu.Game.Tournament.Tests.NonVisual
+{
+    [TestFixture]
+    public class LadderInfoSerialisationTest
+    {
+        [Test]
+        public void TestDeserialise()
+        {
+            var ladder = createSampleLadder();
+            string serialised = JsonConvert.SerializeObject(ladder);
+
+            JsonConvert.DeserializeObject<LadderInfo>(serialised, new JsonPointConverter());
+        }
+
+        [Test]
+        public void TestSerialise()
+        {
+            var ladder = createSampleLadder();
+            JsonConvert.SerializeObject(ladder);
+        }
+
+        private static LadderInfo createSampleLadder()
+        {
+            var match = TournamentTestScene.CreateSampleMatch();
+
+            return new LadderInfo
+            {
+                PlayersPerTeam = { Value = 4 },
+                Teams =
+                {
+                    match.Team1.Value,
+                    match.Team2.Value,
+                },
+                Rounds =
+                {
+                    new TournamentRound
+                    {
+                        Beatmaps =
+                        {
+                            new RoundBeatmap { BeatmapInfo = TournamentTestScene.CreateSampleBeatmapInfo() },
+                            new RoundBeatmap { BeatmapInfo = TournamentTestScene.CreateSampleBeatmapInfo() },
+                        }
+                    }
+                },
+
+                Matches =
+                {
+                    match,
+                },
+                Progressions =
+                {
+                    new TournamentProgression(1, 2),
+                    new TournamentProgression(1, 3, true),
+                }
+            };
+        }
+    }
+}
diff --git a/osu.Game.Tournament.Tests/TournamentTestScene.cs b/osu.Game.Tournament.Tests/TournamentTestScene.cs
index 93e1e018a5..3ea58e9867 100644
--- a/osu.Game.Tournament.Tests/TournamentTestScene.cs
+++ b/osu.Game.Tournament.Tests/TournamentTestScene.cs
@@ -8,6 +8,7 @@ using osu.Framework.Platform;
 using osu.Framework.Testing;
 using osu.Framework.Utils;
 using osu.Game.Beatmaps;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets;
 using osu.Game.Tests.Visual;
 using osu.Game.Tournament.IO;
@@ -152,7 +153,16 @@ namespace osu.Game.Tournament.Tests
         };
 
         public static BeatmapInfo CreateSampleBeatmapInfo() =>
-            new BeatmapInfo { Metadata = new BeatmapMetadata { Title = "Test Title", Artist = "Test Artist", ID = RNG.Next(0, 1000000) } };
+            new BeatmapInfo
+            {
+                Metadata = new BeatmapMetadata
+                {
+                    Title = "Test Title",
+                    Artist = "Test Artist",
+                    ID = RNG.Next(0, 1000000)
+                },
+                OnlineInfo = new BeatmapOnlineInfo(),
+            };
 
         protected override ITestSceneTestRunner CreateRunner() => new TournamentTestSceneTestRunner();
 
diff --git a/osu.Game.Tournament/TournamentSceneManager.cs b/osu.Game.Tournament/TournamentSceneManager.cs
index ced1a8ec72..914d1163ad 100644
--- a/osu.Game.Tournament/TournamentSceneManager.cs
+++ b/osu.Game.Tournament/TournamentSceneManager.cs
@@ -237,7 +237,7 @@ namespace osu.Game.Tournament
             {
                 Type = type;
                 BackgroundColour = OsuColour.Gray(0.2f);
-                Action = () => RequestSelection(type);
+                Action = () => RequestSelection?.Invoke(type);
 
                 RelativeSizeAxes = Axes.X;
             }

From 7111f58bfee77791652f4059b5e2032ea08a4bf9 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 25 Oct 2021 16:46:07 +0900
Subject: [PATCH 0452/5547] Fix tournament client silently failing on error
 during parsing

---
 osu.Game.Tournament/TournamentGame.cs     | 136 ++++++++++++----------
 osu.Game.Tournament/TournamentGameBase.cs | 122 ++++++++++---------
 2 files changed, 142 insertions(+), 116 deletions(-)

diff --git a/osu.Game.Tournament/TournamentGame.cs b/osu.Game.Tournament/TournamentGame.cs
index 7a43fee013..f3927bb852 100644
--- a/osu.Game.Tournament/TournamentGame.cs
+++ b/osu.Game.Tournament/TournamentGame.cs
@@ -12,6 +12,7 @@ using osu.Framework.Graphics.Colour;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Input.Handlers.Mouse;
+using osu.Framework.Logging;
 using osu.Framework.Platform;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Cursor;
@@ -60,72 +61,89 @@ namespace osu.Game.Tournament
 
             loadingSpinner.Show();
 
-            BracketLoadTask.ContinueWith(_ => LoadComponentsAsync(new[]
+            BracketLoadTask.ContinueWith(t =>
             {
-                new Container
+                if (t.IsFaulted)
                 {
-                    CornerRadius = 10,
-                    Depth = float.MinValue,
-                    Position = new Vector2(5),
-                    Masking = true,
-                    AutoSizeAxes = Axes.Both,
-                    Anchor = Anchor.BottomRight,
-                    Origin = Anchor.BottomRight,
-                    Children = new Drawable[]
+                    Schedule(() =>
                     {
-                        new Box
-                        {
-                            Colour = OsuColour.Gray(0.2f),
-                            RelativeSizeAxes = Axes.Both,
-                        },
-                        new TourneyButton
-                        {
-                            Text = "Save Changes",
-                            Width = 140,
-                            Height = 50,
-                            Padding = new MarginPadding
-                            {
-                                Top = 10,
-                                Left = 10,
-                            },
-                            Margin = new MarginPadding
-                            {
-                                Right = 10,
-                                Bottom = 10,
-                            },
-                            Action = SaveChanges,
-                        },
-                    }
-                },
-                heightWarning = new WarningBox("Please make the window wider")
-                {
-                    Anchor = Anchor.BottomCentre,
-                    Origin = Anchor.BottomCentre,
-                    Margin = new MarginPadding(20),
-                },
-                new OsuContextMenuContainer
-                {
-                    RelativeSizeAxes = Axes.Both,
-                    Child = new TournamentSceneManager()
+                        loadingSpinner.Hide();
+                        loadingSpinner.Expire();
+
+                        Logger.Error(t.Exception, "Couldn't load bracket with error");
+                        Add(new WarningBox("Your bracket.json file could not be parsed. Please check runtime.log for more details."));
+                    });
+
+                    return;
                 }
-            }, drawables =>
-            {
-                loadingSpinner.Hide();
-                loadingSpinner.Expire();
 
-                AddRange(drawables);
-
-                windowSize.BindValueChanged(size => ScheduleAfterChildren(() =>
+                LoadComponentsAsync(new[]
                 {
-                    var minWidth = (int)(size.NewValue.Height / 768f * TournamentSceneManager.REQUIRED_WIDTH) - 1;
-                    heightWarning.Alpha = size.NewValue.Width < minWidth ? 1 : 0;
-                }), true);
-
-                windowMode.BindValueChanged(mode => ScheduleAfterChildren(() =>
+                    new Container
+                    {
+                        CornerRadius = 10,
+                        Depth = float.MinValue,
+                        Position = new Vector2(5),
+                        Masking = true,
+                        AutoSizeAxes = Axes.Both,
+                        Anchor = Anchor.BottomRight,
+                        Origin = Anchor.BottomRight,
+                        Children = new Drawable[]
+                        {
+                            new Box
+                            {
+                                Colour = OsuColour.Gray(0.2f),
+                                RelativeSizeAxes = Axes.Both,
+                            },
+                            new TourneyButton
+                            {
+                                Text = "Save Changes",
+                                Width = 140,
+                                Height = 50,
+                                Padding = new MarginPadding
+                                {
+                                    Top = 10,
+                                    Left = 10,
+                                },
+                                Margin = new MarginPadding
+                                {
+                                    Right = 10,
+                                    Bottom = 10,
+                                },
+                                Action = SaveChanges,
+                            },
+                        }
+                    },
+                    heightWarning = new WarningBox("Please make the window wider")
+                    {
+                        Anchor = Anchor.BottomCentre,
+                        Origin = Anchor.BottomCentre,
+                        Margin = new MarginPadding(20),
+                    },
+                    new OsuContextMenuContainer
+                    {
+                        RelativeSizeAxes = Axes.Both,
+                        Child = new TournamentSceneManager()
+                    }
+                }, drawables =>
                 {
-                    windowMode.Value = WindowMode.Windowed;
-                }), true);
-            }));
+                    loadingSpinner.Hide();
+                    loadingSpinner.Expire();
+
+                    AddRange(drawables);
+
+                    windowSize.BindValueChanged(size => ScheduleAfterChildren(() =>
+                    {
+                        var minWidth = (int)(size.NewValue.Height / 768f * TournamentSceneManager.REQUIRED_WIDTH) - 1;
+                        heightWarning.Alpha = size.NewValue.Width < minWidth ? 1 : 0;
+                    }), true);
+
+                    windowMode.BindValueChanged(mode => ScheduleAfterChildren(() =>
+                    {
+                        windowMode.Value = WindowMode.Windowed;
+                    }), true);
+                });
+            });
         }
     }
 }
diff --git a/osu.Game.Tournament/TournamentGameBase.cs b/osu.Game.Tournament/TournamentGameBase.cs
index bdf7269c83..a6b0fa5cfc 100644
--- a/osu.Game.Tournament/TournamentGameBase.cs
+++ b/osu.Game.Tournament/TournamentGameBase.cs
@@ -58,75 +58,83 @@ namespace osu.Game.Tournament
 
         private void readBracket()
         {
-            if (storage.Exists(bracket_filename))
+            try
             {
-                using (Stream stream = storage.GetStream(bracket_filename, FileAccess.Read, FileMode.Open))
-                using (var sr = new StreamReader(stream))
-                    ladder = JsonConvert.DeserializeObject<LadderInfo>(sr.ReadToEnd(), new JsonPointConverter());
-            }
-
-            ladder ??= new LadderInfo();
-
-            ladder.Ruleset.Value = RulesetStore.GetRuleset(ladder.Ruleset.Value?.ShortName)
-                                   ?? RulesetStore.AvailableRulesets.First();
-
-            bool addedInfo = false;
-
-            // assign teams
-            foreach (var match in ladder.Matches)
-            {
-                match.Team1.Value = ladder.Teams.FirstOrDefault(t => t.Acronym.Value == match.Team1Acronym);
-                match.Team2.Value = ladder.Teams.FirstOrDefault(t => t.Acronym.Value == match.Team2Acronym);
-
-                foreach (var conditional in match.ConditionalMatches)
+                if (storage.Exists(bracket_filename))
                 {
-                    conditional.Team1.Value = ladder.Teams.FirstOrDefault(t => t.Acronym.Value == conditional.Team1Acronym);
-                    conditional.Team2.Value = ladder.Teams.FirstOrDefault(t => t.Acronym.Value == conditional.Team2Acronym);
-                    conditional.Round.Value = match.Round.Value;
+                    using (Stream stream = storage.GetStream(bracket_filename, FileAccess.Read, FileMode.Open))
+                    using (var sr = new StreamReader(stream))
+                        ladder = JsonConvert.DeserializeObject<LadderInfo>(sr.ReadToEnd(), new JsonPointConverter());
                 }
-            }
 
-            // assign progressions
-            foreach (var pair in ladder.Progressions)
-            {
-                var src = ladder.Matches.FirstOrDefault(p => p.ID == pair.SourceID);
-                var dest = ladder.Matches.FirstOrDefault(p => p.ID == pair.TargetID);
+                ladder ??= new LadderInfo();
 
-                if (src == null)
-                    continue;
+                ladder.Ruleset.Value = RulesetStore.GetRuleset(ladder.Ruleset.Value?.ShortName)
+                                       ?? RulesetStore.AvailableRulesets.First();
 
-                if (dest != null)
+                bool addedInfo = false;
+
+                // assign teams
+                foreach (var match in ladder.Matches)
                 {
-                    if (pair.Losers)
-                        src.LosersProgression.Value = dest;
-                    else
-                        src.Progression.Value = dest;
-                }
-            }
+                    match.Team1.Value = ladder.Teams.FirstOrDefault(t => t.Acronym.Value == match.Team1Acronym);
+                    match.Team2.Value = ladder.Teams.FirstOrDefault(t => t.Acronym.Value == match.Team2Acronym);
 
-            // link matches to rounds
-            foreach (var round in ladder.Rounds)
-            {
-                foreach (var id in round.Matches)
-                {
-                    var found = ladder.Matches.FirstOrDefault(p => p.ID == id);
-
-                    if (found != null)
+                    foreach (var conditional in match.ConditionalMatches)
                     {
-                        found.Round.Value = round;
-                        if (round.StartDate.Value > found.Date.Value)
-                            found.Date.Value = round.StartDate.Value;
+                        conditional.Team1.Value = ladder.Teams.FirstOrDefault(t => t.Acronym.Value == conditional.Team1Acronym);
+                        conditional.Team2.Value = ladder.Teams.FirstOrDefault(t => t.Acronym.Value == conditional.Team2Acronym);
+                        conditional.Round.Value = match.Round.Value;
                     }
                 }
+
+                // assign progressions
+                foreach (var pair in ladder.Progressions)
+                {
+                    var src = ladder.Matches.FirstOrDefault(p => p.ID == pair.SourceID);
+                    var dest = ladder.Matches.FirstOrDefault(p => p.ID == pair.TargetID);
+
+                    if (src == null)
+                        continue;
+
+                    if (dest != null)
+                    {
+                        if (pair.Losers)
+                            src.LosersProgression.Value = dest;
+                        else
+                            src.Progression.Value = dest;
+                    }
+                }
+
+                // link matches to rounds
+                foreach (var round in ladder.Rounds)
+                {
+                    foreach (var id in round.Matches)
+                    {
+                        var found = ladder.Matches.FirstOrDefault(p => p.ID == id);
+
+                        if (found != null)
+                        {
+                            found.Round.Value = round;
+                            if (round.StartDate.Value > found.Date.Value)
+                                found.Date.Value = round.StartDate.Value;
+                        }
+                    }
+                }
+
+                addedInfo |= addPlayers();
+                addedInfo |= addBeatmaps();
+
+                if (addedInfo)
+                    SaveChanges();
+
+                ladder.CurrentMatch.Value = ladder.Matches.FirstOrDefault(p => p.Current.Value);
+            }
+            catch (Exception e)
+            {
+                taskCompletionSource.SetException(e);
+                return;
             }
-
-            addedInfo |= addPlayers();
-            addedInfo |= addBeatmaps();
-
-            if (addedInfo)
-                SaveChanges();
-
-            ladder.CurrentMatch.Value = ladder.Matches.FirstOrDefault(p => p.Current.Value);
 
             Schedule(() =>
             {

From 6adb0f068b340672aa7218c1129a6bd466037acd Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 25 Oct 2021 16:44:52 +0900
Subject: [PATCH 0453/5547] Fix multiple issues with json serialisation of
 online info (causing tournament failures)

---
 osu.Game.Tournament.Tests/TournamentTestScene.cs     | 2 +-
 osu.Game/Beatmaps/BeatmapInfo.cs                     | 3 ++-
 osu.Game/Online/API/Requests/Responses/APIBeatmap.cs | 4 +++-
 3 files changed, 6 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Tournament.Tests/TournamentTestScene.cs b/osu.Game.Tournament.Tests/TournamentTestScene.cs
index 3ea58e9867..ce9fd91ff1 100644
--- a/osu.Game.Tournament.Tests/TournamentTestScene.cs
+++ b/osu.Game.Tournament.Tests/TournamentTestScene.cs
@@ -161,7 +161,7 @@ namespace osu.Game.Tournament.Tests
                     Artist = "Test Artist",
                     ID = RNG.Next(0, 1000000)
                 },
-                OnlineInfo = new BeatmapOnlineInfo(),
+                OnlineInfo = new APIBeatmap(),
             };
 
         protected override ITestSceneTestRunner CreateRunner() => new TournamentTestSceneTestRunner();
diff --git a/osu.Game/Beatmaps/BeatmapInfo.cs b/osu.Game/Beatmaps/BeatmapInfo.cs
index 571809db36..9069ea4404 100644
--- a/osu.Game/Beatmaps/BeatmapInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapInfo.cs
@@ -9,6 +9,7 @@ using System.Linq;
 using Newtonsoft.Json;
 using osu.Framework.Testing;
 using osu.Game.Database;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets;
 using osu.Game.Scoring;
 
@@ -47,7 +48,7 @@ namespace osu.Game.Beatmaps
         public BeatmapDifficulty BaseDifficulty { get; set; }
 
         [NotMapped]
-        public IBeatmapOnlineInfo OnlineInfo { get; set; }
+        public APIBeatmap OnlineInfo { get; set; }
 
         [NotMapped]
         public int? MaxCombo { get; set; }
diff --git a/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs b/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs
index de86f0f875..a677844d66 100644
--- a/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs
@@ -74,6 +74,8 @@ namespace osu.Game.Online.API.Requests.Responses
         [JsonProperty(@"max_combo")]
         public int? MaxCombo { get; set; }
 
+        public double BPM { get; set; }
+
         public virtual BeatmapInfo ToBeatmapInfo(RulesetStore rulesets)
         {
             var set = BeatmapSet?.ToBeatmapSet(rulesets);
@@ -120,7 +122,7 @@ namespace osu.Game.Online.API.Requests.Responses
 
         public IRulesetInfo Ruleset => new RulesetInfo { ID = RulesetID };
 
-        public double BPM => throw new NotImplementedException();
+        [JsonIgnore]
         public string Hash => throw new NotImplementedException();
 
         #endregion

From b65d199f6ab7e54695b9a1b459c988a53b55d2de Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 25 Oct 2021 17:01:47 +0900
Subject: [PATCH 0454/5547] Fix incorrect length when calling
 `APIBeatmap.ToBeatmapInfo`

---
 osu.Game/Online/API/Requests/Responses/APIBeatmap.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs b/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs
index 6e43ac5504..fee3e56859 100644
--- a/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs
@@ -54,7 +54,7 @@ namespace osu.Game.Online.API.Requests.Responses
         [JsonProperty(@"accuracy")]
         private float overallDifficulty { get; set; }
 
-        public double Length => lengthInSeconds * 1000;
+        public double Length => TimeSpan.FromSeconds(lengthInSeconds).TotalMilliseconds;
 
         [JsonProperty(@"total_length")]
         private double lengthInSeconds { get; set; }
@@ -86,7 +86,7 @@ namespace osu.Game.Online.API.Requests.Responses
                 OnlineBeatmapID = OnlineID,
                 Version = DifficultyName,
                 // this is actually an incorrect mapping (Length is calculated as drain length in lazer's import process, see BeatmapManager.calculateLength).
-                Length = TimeSpan.FromSeconds(Length).TotalMilliseconds,
+                Length = Length,
                 Status = Status,
                 MD5Hash = Checksum,
                 BeatmapSet = set,

From 3f91e74e576a9a18594a7b2830ee5c35c57a20c6 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 25 Oct 2021 19:26:52 +0200
Subject: [PATCH 0455/5547] Remove unused using directive

---
 osu.Game.Tournament.Tests/TournamentTestScene.cs | 1 -
 1 file changed, 1 deletion(-)

diff --git a/osu.Game.Tournament.Tests/TournamentTestScene.cs b/osu.Game.Tournament.Tests/TournamentTestScene.cs
index 3ea58e9867..bd079eb8de 100644
--- a/osu.Game.Tournament.Tests/TournamentTestScene.cs
+++ b/osu.Game.Tournament.Tests/TournamentTestScene.cs
@@ -8,7 +8,6 @@ using osu.Framework.Platform;
 using osu.Framework.Testing;
 using osu.Framework.Utils;
 using osu.Game.Beatmaps;
-using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets;
 using osu.Game.Tests.Visual;
 using osu.Game.Tournament.IO;

From 6802e9ec109c34309529a10b950038e54cc62015 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 25 Oct 2021 20:20:40 +0200
Subject: [PATCH 0456/5547] Remove `FixedWidth` and add `AutoSizeAxes` specs to
 all usages

---
 .../TestSceneBeatmapSetOnlineStatusPill.cs    |  9 +++++--
 .../Drawables/BeatmapSetOnlineStatusPill.cs   | 26 -------------------
 .../BeatmapListing/Panels/GridBeatmapPanel.cs |  1 +
 .../BeatmapListing/Panels/ListBeatmapPanel.cs |  1 +
 .../BeatmapSet/BeatmapSetHeaderContent.cs     |  1 +
 osu.Game/Screens/Select/BeatmapInfoWedge.cs   |  1 +
 .../Select/Carousel/SetPanelContent.cs        |  1 +
 7 files changed, 12 insertions(+), 28 deletions(-)

diff --git a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapSetOnlineStatusPill.cs b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapSetOnlineStatusPill.cs
index 2d61385269..c48b63ac89 100644
--- a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapSetOnlineStatusPill.cs
+++ b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapSetOnlineStatusPill.cs
@@ -28,6 +28,7 @@ namespace osu.Game.Tests.Visual.Beatmaps
             Spacing = new Vector2(0, 10),
             ChildrenEnumerable = Enum.GetValues(typeof(BeatmapSetOnlineStatus)).Cast<BeatmapSetOnlineStatus>().Select(status => new BeatmapSetOnlineStatusPill
             {
+                AutoSizeAxes = Axes.Both,
                 Anchor = Anchor.Centre,
                 Origin = Anchor.Centre,
                 Status = status
@@ -41,8 +42,12 @@ namespace osu.Game.Tests.Visual.Beatmaps
         {
             AddStep("create themed content", () => CreateThemedContent(OverlayColourScheme.Red));
 
-            AddStep("set fixed width", () => statusPills.ForEach(pill => pill.FixedWidth = 90));
-            AddStep("unset fixed width", () => statusPills.ForEach(pill => pill.FixedWidth = null));
+            AddStep("set fixed width", () => statusPills.ForEach(pill =>
+            {
+                pill.AutoSizeAxes = Axes.Y;
+                pill.Width = 90;
+            }));
+            AddStep("unset fixed width", () => statusPills.ForEach(pill => pill.AutoSizeAxes = Axes.Both));
         }
     }
 }
diff --git a/osu.Game/Beatmaps/Drawables/BeatmapSetOnlineStatusPill.cs b/osu.Game/Beatmaps/Drawables/BeatmapSetOnlineStatusPill.cs
index 848bab6394..ec098f4ca2 100644
--- a/osu.Game/Beatmaps/Drawables/BeatmapSetOnlineStatusPill.cs
+++ b/osu.Game/Beatmaps/Drawables/BeatmapSetOnlineStatusPill.cs
@@ -47,31 +47,6 @@ namespace osu.Game.Beatmaps.Drawables
             set => statusText.Padding = value;
         }
 
-        private float? fixedWidth;
-
-        /// <summary>
-        /// When set to a non-<see langword="null"/> value, the pill will be forcibly sized to the given width.
-        /// When set to a <see langword="null"/> value, the pill will autosize to its contents.
-        /// </summary>
-        public float? FixedWidth
-        {
-            get => fixedWidth;
-            set
-            {
-                fixedWidth = value;
-
-                if (fixedWidth == null)
-                {
-                    AutoSizeAxes = Axes.Both;
-                }
-                else
-                {
-                    AutoSizeAxes = Axes.Y;
-                    Width = fixedWidth.Value;
-                }
-            }
-        }
-
         private readonly OsuSpriteText statusText;
         private readonly Box background;
 
@@ -83,7 +58,6 @@ namespace osu.Game.Beatmaps.Drawables
 
         public BeatmapSetOnlineStatusPill()
         {
-            AutoSizeAxes = Axes.Both;
             Masking = true;
 
             Children = new Drawable[]
diff --git a/osu.Game/Overlays/BeatmapListing/Panels/GridBeatmapPanel.cs b/osu.Game/Overlays/BeatmapListing/Panels/GridBeatmapPanel.cs
index c078127353..4a0fa59c31 100644
--- a/osu.Game/Overlays/BeatmapListing/Panels/GridBeatmapPanel.cs
+++ b/osu.Game/Overlays/BeatmapListing/Panels/GridBeatmapPanel.cs
@@ -243,6 +243,7 @@ namespace osu.Game.Overlays.BeatmapListing.Panels
 
             statusContainer.Add(new BeatmapSetOnlineStatusPill
             {
+                AutoSizeAxes = Axes.Both,
                 TextSize = 12,
                 TextPadding = new MarginPadding { Horizontal = 10, Vertical = 5 },
                 Status = SetInfo.OnlineInfo?.Status ?? BeatmapSetOnlineStatus.None,
diff --git a/osu.Game/Overlays/BeatmapListing/Panels/ListBeatmapPanel.cs b/osu.Game/Overlays/BeatmapListing/Panels/ListBeatmapPanel.cs
index 5011749c5f..63d651f9de 100644
--- a/osu.Game/Overlays/BeatmapListing/Panels/ListBeatmapPanel.cs
+++ b/osu.Game/Overlays/BeatmapListing/Panels/ListBeatmapPanel.cs
@@ -257,6 +257,7 @@ namespace osu.Game.Overlays.BeatmapListing.Panels
 
             statusContainer.Add(new BeatmapSetOnlineStatusPill
             {
+                AutoSizeAxes = Axes.Both,
                 TextSize = 12,
                 TextPadding = new MarginPadding { Horizontal = 10, Vertical = 4 },
                 Status = SetInfo.OnlineInfo?.Status ?? BeatmapSetOnlineStatus.None,
diff --git a/osu.Game/Overlays/BeatmapSet/BeatmapSetHeaderContent.cs b/osu.Game/Overlays/BeatmapSet/BeatmapSetHeaderContent.cs
index df88b06879..6f85846720 100644
--- a/osu.Game/Overlays/BeatmapSet/BeatmapSetHeaderContent.cs
+++ b/osu.Game/Overlays/BeatmapSet/BeatmapSetHeaderContent.cs
@@ -198,6 +198,7 @@ namespace osu.Game.Overlays.BeatmapSet
                         {
                             onlineStatusPill = new BeatmapSetOnlineStatusPill
                             {
+                                AutoSizeAxes = Axes.Both,
                                 Anchor = Anchor.TopRight,
                                 Origin = Anchor.TopRight,
                                 TextSize = 14,
diff --git a/osu.Game/Screens/Select/BeatmapInfoWedge.cs b/osu.Game/Screens/Select/BeatmapInfoWedge.cs
index ac191a38f2..2de72beaad 100644
--- a/osu.Game/Screens/Select/BeatmapInfoWedge.cs
+++ b/osu.Game/Screens/Select/BeatmapInfoWedge.cs
@@ -257,6 +257,7 @@ namespace osu.Game.Screens.Select
                             },
                             StatusPill = new BeatmapSetOnlineStatusPill
                             {
+                                AutoSizeAxes = Axes.Both,
                                 Anchor = Anchor.TopRight,
                                 Origin = Anchor.TopRight,
                                 Shear = -wedged_container_shear,
diff --git a/osu.Game/Screens/Select/Carousel/SetPanelContent.cs b/osu.Game/Screens/Select/Carousel/SetPanelContent.cs
index 9fb640ba1a..f2054677b0 100644
--- a/osu.Game/Screens/Select/Carousel/SetPanelContent.cs
+++ b/osu.Game/Screens/Select/Carousel/SetPanelContent.cs
@@ -60,6 +60,7 @@ namespace osu.Game.Screens.Select.Carousel
                         {
                             new BeatmapSetOnlineStatusPill
                             {
+                                AutoSizeAxes = Axes.Both,
                                 Origin = Anchor.CentreLeft,
                                 Anchor = Anchor.CentreLeft,
                                 Margin = new MarginPadding { Right = 5 },

From 0fb2307420e8a8affa2c36e9da722f1884c9881b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 25 Oct 2021 21:00:05 +0200
Subject: [PATCH 0457/5547] Add back using directive

Was removed for being unneeded in a prerequisite PR but then ended up
leading to compilation failures in the dependent PR.
---
 osu.Game.Tournament.Tests/TournamentTestScene.cs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Game.Tournament.Tests/TournamentTestScene.cs b/osu.Game.Tournament.Tests/TournamentTestScene.cs
index e941c9e2bd..ce9fd91ff1 100644
--- a/osu.Game.Tournament.Tests/TournamentTestScene.cs
+++ b/osu.Game.Tournament.Tests/TournamentTestScene.cs
@@ -8,6 +8,7 @@ using osu.Framework.Platform;
 using osu.Framework.Testing;
 using osu.Framework.Utils;
 using osu.Game.Beatmaps;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets;
 using osu.Game.Tests.Visual;
 using osu.Game.Tournament.IO;

From c9a2c6c031e4be032e9b9ecfdf0f9e5faf3be63b Mon Sep 17 00:00:00 2001
From: Roxie Wattz <roxie.wattz@gmail.com>
Date: Mon, 25 Oct 2021 14:09:22 -0700
Subject: [PATCH 0458/5547] Reworking the Ouendan 2 Hidden code AGAIN Not
 finished. Will be finished in a later commit.

---
 osu.Game.Rulesets.Osu/Mods/OsuModHidden.cs | 117 ++++++++-------------
 1 file changed, 45 insertions(+), 72 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModHidden.cs b/osu.Game.Rulesets.Osu/Mods/OsuModHidden.cs
index 12e2035e80..e93120b321 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModHidden.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModHidden.cs
@@ -50,15 +50,15 @@ namespace osu.Game.Rulesets.Osu.Mods
 
         protected override void ApplyIncreasedVisibilityState(DrawableHitObject hitObject, ArmedState state)
         {
-            applyState(hitObject, true);
+            applyHiddenState(hitObject, true, OnlyFadeApproachCircles.Value);
         }
 
         protected override void ApplyNormalVisibilityState(DrawableHitObject hitObject, ArmedState state)
         {
-            applyState(hitObject, false);
+            applyHiddenState(hitObject, false, OnlyFadeApproachCircles.Value);
         }
 
-        private void applyState(DrawableHitObject drawableObject, bool increaseVisibility)
+        private void applyHiddenState(DrawableHitObject drawableObject, bool hideApproachCircle, bool hideCirclePiece)
         {
             if (!(drawableObject is DrawableOsuHitObject drawableOsuObject))
                 return;
@@ -67,90 +67,63 @@ namespace osu.Game.Rulesets.Osu.Mods
 
             (double fadeStartTime, double fadeDuration) = getFadeOutParameters(drawableOsuObject);
 
-            if (!OnlyFadeApproachCircles.Value)
+            switch (drawableObject)
             {
-                switch (drawableObject)
-                {
-                    case DrawableSliderTail _:
-                        using (drawableObject.BeginAbsoluteSequence(fadeStartTime))
-                            drawableObject.FadeOut(fadeDuration);
+                case DrawableSliderTail _:
+                    using (drawableObject.BeginAbsoluteSequence(fadeStartTime))
+                        drawableObject.FadeOut(fadeDuration);
 
-                        break;
+                    break;
 
-                    case DrawableSliderRepeat sliderRepeat:
-                        using (drawableObject.BeginAbsoluteSequence(fadeStartTime))
-                            // only apply to circle piece – reverse arrow is not affected by hidden.
-                            sliderRepeat.CirclePiece.FadeOut(fadeDuration);
+                case DrawableSliderRepeat sliderRepeat:
+                    using (drawableObject.BeginAbsoluteSequence(fadeStartTime))
+                        // only apply to circle piece – reverse arrow is not affected by hidden.
+                        sliderRepeat.CirclePiece.FadeOut(fadeDuration);
 
-                        break;
+                    break;
 
-                    case DrawableHitCircle circle:
-                        Drawable fadeTarget = circle;
+                case DrawableHitCircle circle:
+                    Drawable fadeTarget = circle;
 
-                        if (increaseVisibility)
-                        {
-                            // only fade the circle piece (not the approach circle) for the increased visibility object.
-                            fadeTarget = circle.CirclePiece;
-                        }
-                        else
-                        {
-                            // we don't want to see the approach circle
-                            using (circle.BeginAbsoluteSequence(hitObject.StartTime - hitObject.TimePreempt))
-                                circle.ApproachCircle.Hide();
-                        }
+                    if (hideApproachCircle)
+                    {
+                        // only fade the circle piece (not the approach circle) for the increased visibility object.
+                        fadeTarget = circle.CirclePiece;
+                    }
+                    else
+                    {
+                        // we don't want to see the approach circle
+                        using (circle.BeginAbsoluteSequence(hitObject.StartTime - hitObject.TimePreempt))
+                            circle.ApproachCircle.Hide();
+                    }
 
-                        using (drawableObject.BeginAbsoluteSequence(fadeStartTime))
-                            fadeTarget.FadeOut(fadeDuration);
-                        break;
+                    using (drawableObject.BeginAbsoluteSequence(fadeStartTime))
+                        fadeTarget.FadeOut(fadeDuration);
+                    break;
 
-                    case DrawableSlider slider:
-                        using (slider.BeginAbsoluteSequence(fadeStartTime))
-                            slider.Body.FadeOut(fadeDuration, Easing.Out);
+                case DrawableSlider slider:
+                    using (slider.BeginAbsoluteSequence(fadeStartTime))
+                        slider.Body.FadeOut(fadeDuration, Easing.Out);
 
-                        break;
+                    break;
 
-                    case DrawableSliderTick sliderTick:
-                        using (sliderTick.BeginAbsoluteSequence(fadeStartTime))
-                            sliderTick.FadeOut(fadeDuration);
+                case DrawableSliderTick sliderTick:
+                    using (sliderTick.BeginAbsoluteSequence(fadeStartTime))
+                        sliderTick.FadeOut(fadeDuration);
 
-                        break;
+                    break;
 
-                    case DrawableSpinner spinner:
-                        // hide elements we don't care about.
-                        // todo: hide background
+                case DrawableSpinner spinner:
+                    // hide elements we don't care about.
+                    // todo: hide background
 
-                        spinner.Body.OnSkinChanged += () => hideSpinnerApproachCircle(spinner);
-                        hideSpinnerApproachCircle(spinner);
+                    spinner.Body.OnSkinChanged += () => hideSpinnerApproachCircle(spinner);
+                    hideSpinnerApproachCircle(spinner);
 
-                        using (spinner.BeginAbsoluteSequence(fadeStartTime))
-                            spinner.FadeOut(fadeDuration);
+                    using (spinner.BeginAbsoluteSequence(fadeStartTime))
+                        spinner.FadeOut(fadeDuration);
 
-                        break;
-                }
-            } else
-            {
-                switch(drawableObject)
-                {
-                    case DrawableHitCircle circle:
-                        if (!increaseVisibility)
-                        {
-                            // we don't want to see the approach circle
-                            using (circle.BeginAbsoluteSequence(hitObject.StartTime - hitObject.TimePreempt))
-                                circle.ApproachCircle.Hide();
-                        }
-                        break;
-
-                    case DrawableSpinner spinner:
-                        // hide elements we don't care about.
-                        // todo: hide background
-
-                        spinner.Body.OnSkinChanged += () => hideSpinnerApproachCircle(spinner);
-                        hideSpinnerApproachCircle(spinner);
-                        break;
-
-                    default:
-                        break;
-                }
+                    break;
             }
         }
 

From 3687f830e8d12f49ad33b49fb7d2792408bcf7b2 Mon Sep 17 00:00:00 2001
From: Roxie Wattz <roxie.wattz@gmail.com>
Date: Mon, 25 Oct 2021 16:57:07 -0700
Subject: [PATCH 0459/5547] Rename my test scene As requested by bdach

---
 .../{TestSceneSpinnerSpam.cs => TestSceneNoSpinnerStacking.cs}  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
 rename osu.Game.Rulesets.Osu.Tests/{TestSceneSpinnerSpam.cs => TestSceneNoSpinnerStacking.cs} (93%)

diff --git a/osu.Game.Rulesets.Osu.Tests/TestSceneSpinnerSpam.cs b/osu.Game.Rulesets.Osu.Tests/TestSceneNoSpinnerStacking.cs
similarity index 93%
rename from osu.Game.Rulesets.Osu.Tests/TestSceneSpinnerSpam.cs
rename to osu.Game.Rulesets.Osu.Tests/TestSceneNoSpinnerStacking.cs
index 26729979f9..52597385bb 100644
--- a/osu.Game.Rulesets.Osu.Tests/TestSceneSpinnerSpam.cs
+++ b/osu.Game.Rulesets.Osu.Tests/TestSceneNoSpinnerStacking.cs
@@ -10,7 +10,7 @@ using osuTK;
 namespace osu.Game.Rulesets.Osu.Tests
 {
     [TestFixture]
-    public class TestSceneSpinnerSpam : TestSceneOsuPlayer
+    public class TestSceneNoSpinnerStacking : TestSceneOsuPlayer
     {
         protected override IBeatmap CreateBeatmap(RulesetInfo ruleset)
         {

From cf7fbf4b635e5803ddf55036fb705ae5c9420fcf Mon Sep 17 00:00:00 2001
From: Roxie Wattz <roxie.wattz@gmail.com>
Date: Mon, 25 Oct 2021 17:15:43 -0700
Subject: [PATCH 0460/5547] updated bdach's suggestion

---
 osu.Game.Rulesets.Osu/Objects/OsuHitObject.cs | 4 ++--
 osu.Game.Rulesets.Osu/Objects/Spinner.cs      | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Objects/OsuHitObject.cs b/osu.Game.Rulesets.Osu/Objects/OsuHitObject.cs
index a9b4027ea7..8b7de9e109 100644
--- a/osu.Game.Rulesets.Osu/Objects/OsuHitObject.cs
+++ b/osu.Game.Rulesets.Osu/Objects/OsuHitObject.cs
@@ -49,7 +49,7 @@ namespace osu.Game.Rulesets.Osu.Objects
 
         public virtual Vector2 EndPosition => Position;
 
-        public virtual Vector2 StackedEndPosition => EndPosition + StackOffset;
+        public Vector2 StackedEndPosition => EndPosition + StackOffset;
 
         public readonly Bindable<int> StackHeightBindable = new Bindable<int>();
 
@@ -59,7 +59,7 @@ namespace osu.Game.Rulesets.Osu.Objects
             set => StackHeightBindable.Value = value;
         }
 
-        public Vector2 StackOffset => new Vector2(StackHeight * Scale * -6.4f);
+        public virtual Vector2 StackOffset => new Vector2(StackHeight * Scale * -6.4f);
 
         public double Radius => OBJECT_RADIUS * Scale;
 
diff --git a/osu.Game.Rulesets.Osu/Objects/Spinner.cs b/osu.Game.Rulesets.Osu/Objects/Spinner.cs
index efaea88674..0ad8e4ea68 100644
--- a/osu.Game.Rulesets.Osu/Objects/Spinner.cs
+++ b/osu.Game.Rulesets.Osu/Objects/Spinner.cs
@@ -32,7 +32,7 @@ namespace osu.Game.Rulesets.Osu.Objects
         /// </summary>
         public int MaximumBonusSpins { get; protected set; } = 1;
 
-        public override Vector2 StackedEndPosition => EndPosition;
+        public override Vector2 StackOffset => Vector2.Zero;
 
         protected override void ApplyDefaultsToSelf(ControlPointInfo controlPointInfo, IBeatmapDifficultyInfo difficulty)
         {

From 2c92f1a0b70ab1ef912d148fd08ae53a3cfc4b34 Mon Sep 17 00:00:00 2001
From: ekrctb <ekrctb@gmail.com>
Date: Tue, 26 Oct 2021 10:41:17 +0900
Subject: [PATCH 0461/5547] Use array for fixed-size list

---
 osu.Game.Rulesets.Catch/Edit/CatchDistanceSnapGrid.cs | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Rulesets.Catch/Edit/CatchDistanceSnapGrid.cs b/osu.Game.Rulesets.Catch/Edit/CatchDistanceSnapGrid.cs
index 5808b332b0..1b9705e8dc 100644
--- a/osu.Game.Rulesets.Catch/Edit/CatchDistanceSnapGrid.cs
+++ b/osu.Game.Rulesets.Catch/Edit/CatchDistanceSnapGrid.cs
@@ -26,7 +26,7 @@ namespace osu.Game.Rulesets.Catch.Edit
 
         private readonly List<Path> verticalPaths = new List<Path>();
 
-        private readonly List<List<Vector2>> verticalLineVertices = new List<List<Vector2>>();
+        private readonly List<Vector2[]> verticalLineVertices = new List<Vector2[]>();
 
         [Resolved]
         private Playfield playfield { get; set; }
@@ -48,7 +48,7 @@ namespace osu.Game.Rulesets.Catch.Edit
                     Alpha = 0.5f,
                 });
 
-                verticalLineVertices.Add(new List<Vector2> { Vector2.Zero, Vector2.Zero });
+                verticalLineVertices.Add(new[] { Vector2.Zero, Vector2.Zero });
             }
 
             AddRangeInternal(verticalPaths);
@@ -70,7 +70,7 @@ namespace osu.Game.Rulesets.Catch.Edit
                 float x = (float)((endTime - StartTime) * velocity);
                 float y = hitObjectContainer.PositionAtTime(endTime, StartTime);
 
-                List<Vector2> lineVertices = verticalLineVertices[i];
+                Vector2[] lineVertices = verticalLineVertices[i];
                 lineVertices[0] = new Vector2(StartX, startY);
                 lineVertices[1] = lineVertices[0] + new Vector2(x, y);
 

From 865be5a10b1405c185e80a9c32ca7bb2ee57bc23 Mon Sep 17 00:00:00 2001
From: ekrctb <ekrctb@gmail.com>
Date: Tue, 26 Oct 2021 11:00:44 +0900
Subject: [PATCH 0462/5547] Fix distance snap grid rendering inverted when out
 of bounds

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

diff --git a/osu.Game.Rulesets.Catch/Edit/CatchDistanceSnapGrid.cs b/osu.Game.Rulesets.Catch/Edit/CatchDistanceSnapGrid.cs
index 1b9705e8dc..db7b910f96 100644
--- a/osu.Game.Rulesets.Catch/Edit/CatchDistanceSnapGrid.cs
+++ b/osu.Game.Rulesets.Catch/Edit/CatchDistanceSnapGrid.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 JetBrains.Annotations;
@@ -63,9 +64,11 @@ namespace osu.Game.Rulesets.Catch.Edit
             for (int i = 0; i < velocities.Length; i++)
             {
                 double velocity = velocities[i];
+                var verticalPath = verticalPaths[i];
 
                 // The line ends at the top of the screen.
-                double endTime = hitObjectContainer.TimeAtPosition(-hitObjectContainer.DrawHeight, hitObjectContainer.Time.Current);
+                double topScreenTime = hitObjectContainer.TimeAtPosition(-hitObjectContainer.DrawHeight, hitObjectContainer.Time.Current);
+                double endTime = Math.Max(StartTime, topScreenTime);
 
                 float x = (float)((endTime - StartTime) * velocity);
                 float y = hitObjectContainer.PositionAtTime(endTime, StartTime);
@@ -74,7 +77,6 @@ namespace osu.Game.Rulesets.Catch.Edit
                 lineVertices[0] = new Vector2(StartX, startY);
                 lineVertices[1] = lineVertices[0] + new Vector2(x, y);
 
-                var verticalPath = verticalPaths[i];
                 verticalPath.Vertices = verticalLineVertices[i];
                 verticalPath.OriginPosition = verticalPath.PositionInBoundingBox(Vector2.Zero);
             }

From 9f49a1df8beba494a89dd432ee19959ed04a0aae Mon Sep 17 00:00:00 2001
From: ekrctb <ekrctb@gmail.com>
Date: Tue, 26 Oct 2021 11:00:55 +0900
Subject: [PATCH 0463/5547] Handle the case of cursor below the start time of
 distance snap

---
 osu.Game.Rulesets.Catch/Edit/CatchDistanceSnapGrid.cs | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/osu.Game.Rulesets.Catch/Edit/CatchDistanceSnapGrid.cs b/osu.Game.Rulesets.Catch/Edit/CatchDistanceSnapGrid.cs
index db7b910f96..667cb4a9b5 100644
--- a/osu.Game.Rulesets.Catch/Edit/CatchDistanceSnapGrid.cs
+++ b/osu.Game.Rulesets.Catch/Edit/CatchDistanceSnapGrid.cs
@@ -87,6 +87,16 @@ namespace osu.Game.Rulesets.Catch.Edit
         {
             double time = hitObjectContainer.TimeAtScreenSpacePosition(screenSpacePosition);
 
+            // If the cursor is below the distance snap grid, snap to the origin.
+            // Not returning `null` to retain the continuous snapping behavior when the cursor is slightly below the origin.
+            // This behavior is not currently visible in the editor because editor chooses the snap start time based on the mouse position.
+            if (time <= StartTime)
+            {
+                float y = hitObjectContainer.PositionAtTime(StartTime);
+                Vector2 originPosition = hitObjectContainer.ToScreenSpace(new Vector2(StartX, y));
+                return new SnapResult(originPosition, StartTime);
+            }
+
             return enumerateSnappingCandidates(time)
                    .OrderBy(pos => Vector2.DistanceSquared(screenSpacePosition, pos.ScreenSpacePosition))
                    .FirstOrDefault();

From 068217557e686660854a78bcafbf024b3301b5f6 Mon Sep 17 00:00:00 2001
From: ekrctb <ekrctb@gmail.com>
Date: Tue, 26 Oct 2021 11:12:10 +0900
Subject: [PATCH 0464/5547] Add doc comment on catch distance snap grid

---
 osu.Game.Rulesets.Catch/Edit/CatchDistanceSnapGrid.cs | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/osu.Game.Rulesets.Catch/Edit/CatchDistanceSnapGrid.cs b/osu.Game.Rulesets.Catch/Edit/CatchDistanceSnapGrid.cs
index 667cb4a9b5..d999115d81 100644
--- a/osu.Game.Rulesets.Catch/Edit/CatchDistanceSnapGrid.cs
+++ b/osu.Game.Rulesets.Catch/Edit/CatchDistanceSnapGrid.cs
@@ -17,6 +17,10 @@ using osuTK;
 
 namespace osu.Game.Rulesets.Catch.Edit
 {
+    /// <summary>
+    /// The guide lines used in the osu!catch editor to compose patterns that can be caught with constant speed.
+    /// Currently, only forward placement (an object is snapped based on the previous object, not the opposite) is supported.
+    /// </summary>
     public class CatchDistanceSnapGrid : CompositeDrawable
     {
         public double StartTime { get; set; }

From b7a719de716f611443fed8f67e9c92a4a2fddc4c Mon Sep 17 00:00:00 2001
From: ekrctb <ekrctb@gmail.com>
Date: Tue, 26 Oct 2021 11:14:12 +0900
Subject: [PATCH 0465/5547] Rename method

---
 osu.Game.Rulesets.Catch/Edit/CatchHitObjectComposer.cs | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Rulesets.Catch/Edit/CatchHitObjectComposer.cs b/osu.Game.Rulesets.Catch/Edit/CatchHitObjectComposer.cs
index 9b779d3370..9c67e4600b 100644
--- a/osu.Game.Rulesets.Catch/Edit/CatchHitObjectComposer.cs
+++ b/osu.Game.Rulesets.Catch/Edit/CatchHitObjectComposer.cs
@@ -102,7 +102,7 @@ namespace osu.Game.Rulesets.Catch.Edit
         protected override ComposeBlueprintContainer CreateBlueprintContainer() => new CatchBlueprintContainer(this);
 
         [CanBeNull]
-        private PalpableCatchHitObject getPreviousHitObject(double time)
+        private PalpableCatchHitObject getLastSnappableHitObject(double time)
         {
             var hitObject = EditorBeatmap.HitObjects.OfType<CatchHitObject>().LastOrDefault(h => h.GetEndTime() < time && !(h is BananaShower));
 
@@ -129,7 +129,7 @@ namespace osu.Game.Rulesets.Catch.Edit
                         return null;
 
                     double minTime = EditorBeatmap.SelectedHitObjects.Min(hitObject => hitObject.StartTime);
-                    return getPreviousHitObject(minTime);
+                    return getLastSnappableHitObject(minTime);
 
                 case FruitCompositionTool _:
                 case JuiceStreamCompositionTool _:
@@ -143,7 +143,7 @@ namespace osu.Game.Rulesets.Catch.Edit
                     }
 
                     double timeAtCursor = ((CatchPlayfield)Playfield).TimeAtScreenSpacePosition(inputManager.CurrentState.Mouse.Position);
-                    return getPreviousHitObject(timeAtCursor);
+                    return getLastSnappableHitObject(timeAtCursor);
 
                 default:
                     return null;

From c5d765029ce2383f5d0fe22977acd617a981dcb3 Mon Sep 17 00:00:00 2001
From: ekrctb <ekrctb@gmail.com>
Date: Tue, 26 Oct 2021 11:17:04 +0900
Subject: [PATCH 0466/5547] Don't compute source object for distance snap grid
 when it is not enabled

---
 .../Edit/CatchHitObjectComposer.cs            | 19 ++++++++++++-------
 1 file changed, 12 insertions(+), 7 deletions(-)

diff --git a/osu.Game.Rulesets.Catch/Edit/CatchHitObjectComposer.cs b/osu.Game.Rulesets.Catch/Edit/CatchHitObjectComposer.cs
index 9c67e4600b..67055fb5e0 100644
--- a/osu.Game.Rulesets.Catch/Edit/CatchHitObjectComposer.cs
+++ b/osu.Game.Rulesets.Catch/Edit/CatchHitObjectComposer.cs
@@ -152,18 +152,23 @@ namespace osu.Game.Rulesets.Catch.Edit
 
         private void updateDistanceSnapGrid()
         {
-            var sourceHitObject = getDistanceSnapGridSourceHitObject();
-
-            if (distanceSnapToggle.Value != TernaryState.True || sourceHitObject == null)
+            if (distanceSnapToggle.Value != TernaryState.True)
             {
                 distanceSnapGrid.Hide();
+                return;
             }
-            else
+
+            var sourceHitObject = getDistanceSnapGridSourceHitObject();
+
+            if (sourceHitObject == null)
             {
-                distanceSnapGrid.Show();
-                distanceSnapGrid.StartTime = sourceHitObject.GetEndTime();
-                distanceSnapGrid.StartX = sourceHitObject.EffectiveX;
+                distanceSnapGrid.Hide();
+                return;
             }
+
+            distanceSnapGrid.Show();
+            distanceSnapGrid.StartTime = sourceHitObject.GetEndTime();
+            distanceSnapGrid.StartX = sourceHitObject.EffectiveX;
         }
     }
 }

From e7b19cb72489a32ac725ddbdfc25cfa2539056c9 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 26 Oct 2021 11:30:26 +0900
Subject: [PATCH 0467/5547] Rename test and fix incorrect layout

---
 .../Mods/TestSceneOsuModHidden.cs                    | 12 ++++++------
 osu.Game.Rulesets.Osu/Mods/OsuModHidden.cs           |  1 -
 2 files changed, 6 insertions(+), 7 deletions(-)

diff --git a/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModHidden.cs b/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModHidden.cs
index 1fd601cec5..71b575abe2 100644
--- a/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModHidden.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModHidden.cs
@@ -118,7 +118,7 @@ namespace osu.Game.Rulesets.Osu.Tests.Mods
         });
 
         [Test]
-        public void OuendanTwoHidden() => CreateModTest(new ModTestData
+        public void TestApproachCirclesOnly() => CreateModTest(new ModTestData
         {
             Mod = new OsuModHidden { OnlyFadeApproachCircles = { Value = true } },
             Autoplay = true,
@@ -129,22 +129,22 @@ namespace osu.Game.Rulesets.Osu.Tests.Mods
                     new HitCircle
                     {
                         StartTime = 1000,
-                        Position = new Vector2(206,142)
+                        Position = new Vector2(206, 142)
                     },
                     new HitCircle
                     {
                         StartTime = 2000,
-                        Position = new Vector2(306,142)
+                        Position = new Vector2(306, 142)
                     },
                     new Slider
                     {
                         StartTime = 3000,
-                        Position = new Vector2(156,242),
-                        Path = new SliderPath(PathType.Linear, new[] { Vector2.Zero, new Vector2(200,0), })
+                        Position = new Vector2(156, 242),
+                        Path = new SliderPath(PathType.Linear, new[] { Vector2.Zero, new Vector2(200, 0), })
                     },
                     new Spinner
                     {
-                        Position = new Vector2(256,192),
+                        Position = new Vector2(256, 192),
                         StartTime = 7000,
                         EndTime = 9000
                     }
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModHidden.cs b/osu.Game.Rulesets.Osu/Mods/OsuModHidden.cs
index e93120b321..ed329f02b3 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModHidden.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModHidden.cs
@@ -15,7 +15,6 @@ using osu.Game.Rulesets.Osu.Objects.Drawables;
 using osu.Game.Rulesets.Osu.Objects;
 using osu.Game.Rulesets.Osu.Skinning;
 
-
 namespace osu.Game.Rulesets.Osu.Mods
 {
     public class OsuModHidden : ModHidden, IHidesApproachCircles

From 0757044b1571bc5f9f2bec360296814f85a0f408 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 26 Oct 2021 11:42:15 +0900
Subject: [PATCH 0468/5547] Refactor logic to work

---
 osu.Game.Rulesets.Osu/Mods/OsuModHidden.cs | 27 ++++++++++++++--------
 1 file changed, 17 insertions(+), 10 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModHidden.cs b/osu.Game.Rulesets.Osu/Mods/OsuModHidden.cs
index ed329f02b3..c4444bf4f8 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModHidden.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModHidden.cs
@@ -49,15 +49,15 @@ namespace osu.Game.Rulesets.Osu.Mods
 
         protected override void ApplyIncreasedVisibilityState(DrawableHitObject hitObject, ArmedState state)
         {
-            applyHiddenState(hitObject, true, OnlyFadeApproachCircles.Value);
+            applyHiddenState(hitObject, true);
         }
 
         protected override void ApplyNormalVisibilityState(DrawableHitObject hitObject, ArmedState state)
         {
-            applyHiddenState(hitObject, false, OnlyFadeApproachCircles.Value);
+            applyHiddenState(hitObject, false);
         }
 
-        private void applyHiddenState(DrawableHitObject drawableObject, bool hideApproachCircle, bool hideCirclePiece)
+        private void applyHiddenState(DrawableHitObject drawableObject, bool increaseVisibility)
         {
             if (!(drawableObject is DrawableOsuHitObject drawableOsuObject))
                 return;
@@ -66,6 +66,19 @@ namespace osu.Game.Rulesets.Osu.Mods
 
             (double fadeStartTime, double fadeDuration) = getFadeOutParameters(drawableOsuObject);
 
+            // process approach circle hiding first (to allow for early return below).
+            if (!increaseVisibility)
+            {
+                if (drawableObject is DrawableHitCircle circle)
+                {
+                    using (circle.BeginAbsoluteSequence(hitObject.StartTime - hitObject.TimePreempt))
+                        circle.ApproachCircle.Hide();
+                }
+            }
+
+            if (OnlyFadeApproachCircles.Value)
+                return;
+
             switch (drawableObject)
             {
                 case DrawableSliderTail _:
@@ -84,17 +97,11 @@ namespace osu.Game.Rulesets.Osu.Mods
                 case DrawableHitCircle circle:
                     Drawable fadeTarget = circle;
 
-                    if (hideApproachCircle)
+                    if (increaseVisibility)
                     {
                         // only fade the circle piece (not the approach circle) for the increased visibility object.
                         fadeTarget = circle.CirclePiece;
                     }
-                    else
-                    {
-                        // we don't want to see the approach circle
-                        using (circle.BeginAbsoluteSequence(hitObject.StartTime - hitObject.TimePreempt))
-                            circle.ApproachCircle.Hide();
-                    }
 
                     using (drawableObject.BeginAbsoluteSequence(fadeStartTime))
                         fadeTarget.FadeOut(fadeDuration);

From 5d1170aaf4879459d027e03d15b33c4a3bf28b6f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 26 Oct 2021 11:57:51 +0900
Subject: [PATCH 0469/5547] Remove unnecessary null check

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

diff --git a/osu.Game/Audio/PreviewTrackManager.cs b/osu.Game/Audio/PreviewTrackManager.cs
index 26787c362b..ca63add31d 100644
--- a/osu.Game/Audio/PreviewTrackManager.cs
+++ b/osu.Game/Audio/PreviewTrackManager.cs
@@ -114,7 +114,7 @@ namespace osu.Game.Audio
                 Logger.Log($"A {nameof(PreviewTrack)} was created without a containing {nameof(IPreviewTrackOwner)}. An owner should be added for correct behaviour.");
             }
 
-            protected override Track GetTrack() => trackManager.Get($"https://b.ppy.sh/preview/{beatmapSetInfo?.OnlineID}.mp3");
+            protected override Track GetTrack() => trackManager.Get($"https://b.ppy.sh/preview/{beatmapSetInfo.OnlineID}.mp3");
         }
 
         private class PreviewTrackStore : AudioCollectionManager<AdjustableAudioComponent>, ITrackStore

From d7ac94038a1d01e5240e0340cf15bb6890f8a6a1 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 26 Oct 2021 12:04:18 +0900
Subject: [PATCH 0470/5547] Update `GetBeatmapRequest` to use `AddParameter`

---
 osu.Game/Online/API/Requests/GetBeatmapRequest.cs | 14 +++++++++++++-
 1 file changed, 13 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Online/API/Requests/GetBeatmapRequest.cs b/osu.Game/Online/API/Requests/GetBeatmapRequest.cs
index aa0d51641e..6cd45a41df 100644
--- a/osu.Game/Online/API/Requests/GetBeatmapRequest.cs
+++ b/osu.Game/Online/API/Requests/GetBeatmapRequest.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.IO.Network;
 using osu.Game.Beatmaps;
 using osu.Game.Online.API.Requests.Responses;
 
@@ -21,6 +22,17 @@ namespace osu.Game.Online.API.Requests
             filename = (beatmapInfo as BeatmapInfo)?.Path ?? string.Empty;
         }
 
-        protected override string Target => $@"beatmaps/lookup?id={beatmapInfo.OnlineID}&checksum={beatmapInfo.MD5Hash}&filename={System.Uri.EscapeUriString(filename)}";
+        protected override WebRequest CreateWebRequest()
+        {
+            var request = base.CreateWebRequest();
+
+            request.AddParameter(@"id", beatmapInfo.OnlineID.ToString());
+            request.AddParameter(@"checksum", beatmapInfo.MD5Hash);
+            request.AddParameter(@"filename", filename);
+
+            return request;
+        }
+
+        protected override string Target => @"beatmaps/lookup";
     }
 }

From 8b85c78b0defe810b34a324f5a0c6b85bb35e18f Mon Sep 17 00:00:00 2001
From: Roxie Wattz <roxie.wattz@gmail.com>
Date: Mon, 25 Oct 2021 20:16:45 -0700
Subject: [PATCH 0471/5547] Add processing of Spinner approach circles

---
 osu.Game.Rulesets.Osu/Mods/OsuModHidden.cs | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModHidden.cs b/osu.Game.Rulesets.Osu/Mods/OsuModHidden.cs
index c4444bf4f8..e5cc08c886 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModHidden.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModHidden.cs
@@ -74,6 +74,11 @@ namespace osu.Game.Rulesets.Osu.Mods
                     using (circle.BeginAbsoluteSequence(hitObject.StartTime - hitObject.TimePreempt))
                         circle.ApproachCircle.Hide();
                 }
+                else if (drawableObject is DrawableSpinner spinner)
+                {
+                    spinner.Body.OnSkinChanged += () => hideSpinnerApproachCircle(spinner);
+                    hideSpinnerApproachCircle(spinner);
+                }
             }
 
             if (OnlyFadeApproachCircles.Value)
@@ -123,9 +128,6 @@ namespace osu.Game.Rulesets.Osu.Mods
                     // hide elements we don't care about.
                     // todo: hide background
 
-                    spinner.Body.OnSkinChanged += () => hideSpinnerApproachCircle(spinner);
-                    hideSpinnerApproachCircle(spinner);
-
                     using (spinner.BeginAbsoluteSequence(fadeStartTime))
                         spinner.FadeOut(fadeDuration);
 

From a582976851306ea1f567768381b70df8e26fc9e3 Mon Sep 17 00:00:00 2001
From: Jason Won <jasonwon628@gmail.com>
Date: Tue, 26 Oct 2021 00:05:46 -0400
Subject: [PATCH 0472/5547] reversing slider maintains shape

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

diff --git a/osu.Game/Rulesets/Objects/SliderPathExtensions.cs b/osu.Game/Rulesets/Objects/SliderPathExtensions.cs
index 663746bfca..052fc7c775 100644
--- a/osu.Game/Rulesets/Objects/SliderPathExtensions.cs
+++ b/osu.Game/Rulesets/Objects/SliderPathExtensions.cs
@@ -19,7 +19,7 @@ namespace osu.Game.Rulesets.Objects
         public static void Reverse(this SliderPath sliderPath, out Vector2 positionalOffset)
         {
             var points = sliderPath.ControlPoints.ToArray();
-            positionalOffset = points.Last().Position;
+            positionalOffset = sliderPath.PositionAt(1);
 
             sliderPath.ControlPoints.Clear();
 
@@ -32,7 +32,10 @@ namespace osu.Game.Rulesets.Objects
 
                 // propagate types forwards to last null type
                 if (i == points.Length - 1)
+                {
                     p.Type = lastType;
+                    p.Position = Vector2.Zero;
+                }
                 else if (p.Type != null)
                     (p.Type, lastType) = (lastType, p.Type);
 

From 6c38028d068e796fbeeda82587c22d9a7da4c6c2 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 26 Oct 2021 13:55:02 +0900
Subject: [PATCH 0473/5547] Fix gameplay chat display not losing focus on
 escape key press

Closes #15293.
---
 .../Multiplayer/TestSceneGameplayChatDisplay.cs      | 12 ++++++++++++
 .../OnlinePlay/Multiplayer/GameplayChatDisplay.cs    | 10 ++++++++++
 2 files changed, 22 insertions(+)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneGameplayChatDisplay.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneGameplayChatDisplay.cs
index a3a1cacb0d..512d206a06 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneGameplayChatDisplay.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneGameplayChatDisplay.cs
@@ -92,6 +92,18 @@ namespace osu.Game.Tests.Visual.Multiplayer
             assertChatFocused(true);
         }
 
+        [Test]
+        public void TestFocusLostOnBackKey()
+        {
+            setLocalUserPlaying(true);
+
+            assertChatFocused(false);
+            AddStep("press tab", () => InputManager.Key(Key.Tab));
+            assertChatFocused(true);
+            AddStep("press escape", () => InputManager.Key(Key.Escape));
+            assertChatFocused(false);
+        }
+
         [Test]
         public void TestFocusOnTabKeyWhenNotExpanded()
         {
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/GameplayChatDisplay.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/GameplayChatDisplay.cs
index af0c50a848..ff24035d0e 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/GameplayChatDisplay.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/GameplayChatDisplay.cs
@@ -10,6 +10,7 @@ using osu.Game.Input.Bindings;
 using osu.Game.Online.Rooms;
 using osu.Game.Screens.OnlinePlay.Match.Components;
 using osu.Game.Screens.Play;
+using osuTK.Input;
 
 namespace osu.Game.Screens.OnlinePlay.Multiplayer
 {
@@ -75,6 +76,15 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
         {
             switch (e.Action)
             {
+                case GlobalAction.Back:
+                    if (Textbox.HasFocus)
+                    {
+                        Schedule(() => Textbox.KillFocus());
+                        return true;
+                    }
+
+                    break;
+
                 case GlobalAction.ToggleChatFocus:
                     if (Textbox.HasFocus)
                     {

From 26fb9af0218fadff0bfebfa2985525db253cb236 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 26 Oct 2021 13:58:07 +0900
Subject: [PATCH 0474/5547] Update framework

---
 osu.Android.props        | 2 +-
 osu.Game/osu.Game.csproj | 2 +-
 osu.iOS.props            | 4 ++--
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Android.props b/osu.Android.props
index f552aff2f2..9e0d31e7e5 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -52,7 +52,7 @@
   </ItemGroup>
   <ItemGroup>
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1015.0" />
-    <PackageReference Include="ppy.osu.Framework.Android" Version="2021.1014.0" />
+    <PackageReference Include="ppy.osu.Framework.Android" Version="2021.1026.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
     <!-- Realm needs to be directly referenced in all Xamarin projects, as it will not pull in its transitive dependencies otherwise. -->
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 32d6eeab29..a9555b555e 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="10.6.0" />
-    <PackageReference Include="ppy.osu.Framework" Version="2021.1014.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2021.1026.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1015.0" />
     <PackageReference Include="Sentry" Version="3.9.4" />
     <PackageReference Include="SharpCompress" Version="0.29.0" />
diff --git a/osu.iOS.props b/osu.iOS.props
index 92abab036a..1669573c26 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -70,7 +70,7 @@
     <Reference Include="System.Net.Http" />
   </ItemGroup>
   <ItemGroup Label="Package References">
-    <PackageReference Include="ppy.osu.Framework.iOS" Version="2021.1014.0" />
+    <PackageReference Include="ppy.osu.Framework.iOS" Version="2021.1026.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1015.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net5.0 / net6.0) -->
@@ -93,7 +93,7 @@
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="2.2.6" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.Core" Version="2.2.6" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
-    <PackageReference Include="ppy.osu.Framework" Version="2021.1014.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2021.1026.0" />
     <PackageReference Include="SharpCompress" Version="0.28.3" />
     <PackageReference Include="NUnit" Version="3.13.2" />
     <PackageReference Include="SharpRaven" Version="2.4.0" />

From 370775af68ec8cdab445182c2b8d457c1f932eef Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 26 Oct 2021 14:05:07 +0900
Subject: [PATCH 0475/5547] Fix some surrounding code formatting

---
 osu.Game/Database/ArchiveModelManager.cs |  6 ++---
 osu.Game/Graphics/ScreenshotManager.cs   | 34 +++++++++++++-----------
 2 files changed, 21 insertions(+), 19 deletions(-)

diff --git a/osu.Game/Database/ArchiveModelManager.cs b/osu.Game/Database/ArchiveModelManager.cs
index a0ca23eaec..f3ed2d735b 100644
--- a/osu.Game/Database/ArchiveModelManager.cs
+++ b/osu.Game/Database/ArchiveModelManager.cs
@@ -462,10 +462,10 @@ namespace osu.Game.Database
             if (retrievedItem == null)
                 throw new ArgumentException(@"Specified model could not be found", nameof(item));
 
-            var filename = $"{getValidFilename(item.ToString())}{HandledExtensions.First()}";
+            string filename = $"{getValidFilename(item.ToString())}{HandledExtensions.First()}";
 
-            using (var outputStream = exportStorage.GetStream(filename, FileAccess.Write, FileMode.Create))
-                ExportModelTo(retrievedItem, outputStream);
+            using (var stream = exportStorage.GetStream(filename, FileAccess.Write, FileMode.Create))
+                ExportModelTo(retrievedItem, stream);
 
             exportStorage.PresentFileExternally(filename);
         }
diff --git a/osu.Game/Graphics/ScreenshotManager.cs b/osu.Game/Graphics/ScreenshotManager.cs
index c21986f6c4..e652f07239 100644
--- a/osu.Game/Graphics/ScreenshotManager.cs
+++ b/osu.Game/Graphics/ScreenshotManager.cs
@@ -109,40 +109,42 @@ namespace osu.Game.Graphics
                 if (Interlocked.Decrement(ref screenShotTasks) == 0 && cursorVisibility.Value == false)
                     cursorVisibility.Value = true;
 
-                var fileName = getFileName();
-                if (fileName == null) return;
+                string filename = getFilename();
 
-                var stream = storage.GetStream(fileName, FileAccess.Write);
+                if (filename == null) return;
 
-                switch (screenshotFormat.Value)
+                using (var stream = storage.GetStream(filename, FileAccess.Write))
                 {
-                    case ScreenshotFormat.Png:
-                        await image.SaveAsPngAsync(stream).ConfigureAwait(false);
-                        break;
+                    switch (screenshotFormat.Value)
+                    {
+                        case ScreenshotFormat.Png:
+                            await image.SaveAsPngAsync(stream).ConfigureAwait(false);
+                            break;
 
-                    case ScreenshotFormat.Jpg:
-                        const int jpeg_quality = 92;
+                        case ScreenshotFormat.Jpg:
+                            const int jpeg_quality = 92;
 
-                        await image.SaveAsJpegAsync(stream, new JpegEncoder { Quality = jpeg_quality }).ConfigureAwait(false);
-                        break;
+                            await image.SaveAsJpegAsync(stream, new JpegEncoder { Quality = jpeg_quality }).ConfigureAwait(false);
+                            break;
 
-                    default:
-                        throw new InvalidOperationException($"Unknown enum member {nameof(ScreenshotFormat)} {screenshotFormat.Value}.");
+                        default:
+                            throw new InvalidOperationException($"Unknown enum member {nameof(ScreenshotFormat)} {screenshotFormat.Value}.");
+                    }
                 }
 
                 notificationOverlay.Post(new SimpleNotification
                 {
-                    Text = $"{fileName} saved!",
+                    Text = $"{filename} saved!",
                     Activated = () =>
                     {
-                        storage.PresentFileExternally(fileName);
+                        storage.PresentFileExternally(filename);
                         return true;
                     }
                 });
             }
         });
 
-        private string getFileName()
+        private string getFilename()
         {
             var dt = DateTime.Now;
             var fileExt = screenshotFormat.ToString().ToLowerInvariant();

From de7a908be29e2dfb6dbddc3837f894467e07233d Mon Sep 17 00:00:00 2001
From: ekrctb <ekrctb@gmail.com>
Date: Tue, 26 Oct 2021 14:51:52 +0900
Subject: [PATCH 0476/5547] Cut distance snap lines at playfield border in
 catch editor

---
 .../Edit/CatchDistanceSnapGrid.cs             | 36 ++++++++++++++-----
 1 file changed, 27 insertions(+), 9 deletions(-)

diff --git a/osu.Game.Rulesets.Catch/Edit/CatchDistanceSnapGrid.cs b/osu.Game.Rulesets.Catch/Edit/CatchDistanceSnapGrid.cs
index d999115d81..137ac1fc59 100644
--- a/osu.Game.Rulesets.Catch/Edit/CatchDistanceSnapGrid.cs
+++ b/osu.Game.Rulesets.Catch/Edit/CatchDistanceSnapGrid.cs
@@ -10,6 +10,7 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Lines;
 using osu.Framework.Graphics.Primitives;
+using osu.Game.Rulesets.Catch.UI;
 using osu.Game.Rulesets.Edit;
 using osu.Game.Rulesets.UI;
 using osu.Game.Rulesets.UI.Scrolling;
@@ -27,6 +28,8 @@ namespace osu.Game.Rulesets.Catch.Edit
 
         public float StartX { get; set; }
 
+        private const double max_vertical_line_length_in_time = CatchPlayfield.WIDTH / Catcher.BASE_SPEED * 2;
+
         private readonly double[] velocities;
 
         private readonly List<Path> verticalPaths = new List<Path>();
@@ -63,27 +66,42 @@ namespace osu.Game.Rulesets.Catch.Edit
         {
             base.Update();
 
-            float startY = hitObjectContainer.PositionAtTime(StartTime);
+            double currentTime = hitObjectContainer.Time.Current;
 
             for (int i = 0; i < velocities.Length; i++)
             {
                 double velocity = velocities[i];
-                var verticalPath = verticalPaths[i];
 
-                // The line ends at the top of the screen.
-                double topScreenTime = hitObjectContainer.TimeAtPosition(-hitObjectContainer.DrawHeight, hitObjectContainer.Time.Current);
-                double endTime = Math.Max(StartTime, topScreenTime);
+                // The line ends at the top of the playfield.
+                double endTime = hitObjectContainer.TimeAtPosition(-hitObjectContainer.DrawHeight, currentTime);
 
-                float x = (float)((endTime - StartTime) * velocity);
-                float y = hitObjectContainer.PositionAtTime(endTime, StartTime);
+                // Non-vertical lines are cut at the sides of the playfield.
+                // Vertical lines are cut at some reasonable length.
+                if (velocity > 0)
+                    endTime = Math.Min(endTime, StartTime + (CatchPlayfield.WIDTH - StartX) / velocity);
+                else if (velocity < 0)
+                    endTime = Math.Min(endTime, StartTime + StartX / -velocity);
+                else
+                    endTime = Math.Min(endTime, StartTime + max_vertical_line_length_in_time);
 
                 Vector2[] lineVertices = verticalLineVertices[i];
-                lineVertices[0] = new Vector2(StartX, startY);
-                lineVertices[1] = lineVertices[0] + new Vector2(x, y);
+                lineVertices[0] = calculatePosition(velocity, StartTime);
+                lineVertices[1] = calculatePosition(velocity, endTime);
 
+                var verticalPath = verticalPaths[i];
                 verticalPath.Vertices = verticalLineVertices[i];
                 verticalPath.OriginPosition = verticalPath.PositionInBoundingBox(Vector2.Zero);
             }
+
+            Vector2 calculatePosition(double velocity, double time)
+            {
+                // Don't draw inverted lines.
+                time = Math.Max(time, StartTime);
+
+                float x = StartX + (float)((time - StartTime) * velocity);
+                float y = hitObjectContainer.PositionAtTime(time, currentTime);
+                return new Vector2(x, y);
+            }
         }
 
         [CanBeNull]

From 81fee02c2bc90553093304cfc938abd883faad45 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 26 Oct 2021 15:46:15 +0900
Subject: [PATCH 0477/5547] Fix slider paths being extended even when the last
 two points are equal

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

diff --git a/osu.Game/Rulesets/Objects/SliderPath.cs b/osu.Game/Rulesets/Objects/SliderPath.cs
index 9cc215589b..0dec0655b9 100644
--- a/osu.Game/Rulesets/Objects/SliderPath.cs
+++ b/osu.Game/Rulesets/Objects/SliderPath.cs
@@ -280,6 +280,13 @@ namespace osu.Game.Rulesets.Objects
 
             if (ExpectedDistance.Value is double expectedDistance && calculatedLength != expectedDistance)
             {
+                // In osu-stable, if the last two control points of a slider are equal, extension is not performed.
+                if (ControlPoints.Count >= 2 && ControlPoints[^1].Position == ControlPoints[^2].Position && expectedDistance > calculatedLength)
+                {
+                    cumulativeLength.Add(calculatedLength);
+                    return;
+                }
+
                 // The last length is always incorrect
                 cumulativeLength.RemoveAt(cumulativeLength.Count - 1);
 

From b259192a8aac895db3f2f1b2c1f6c21ca3ebb485 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 26 Oct 2021 16:06:02 +0900
Subject: [PATCH 0478/5547] Add failing test coverage showing hitobject local
 control points are defaults

---
 osu.Game.Tests/Visual/Editing/TestSceneEditorSaving.cs | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneEditorSaving.cs b/osu.Game.Tests/Visual/Editing/TestSceneEditorSaving.cs
index ab2bc4649a..af3d9beb69 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneEditorSaving.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneEditorSaving.cs
@@ -56,6 +56,11 @@ namespace osu.Game.Tests.Visual.Editing
 
             checkMutations();
 
+            // After placement these must be non-default as defaults are read-only.
+            AddAssert("Placed object has non-default control points", () =>
+                editorBeatmap.HitObjects[0].SampleControlPoint != SampleControlPoint.DEFAULT &&
+                editorBeatmap.HitObjects[0].DifficultyControlPoint != DifficultyControlPoint.DEFAULT);
+
             AddStep("Save", () => InputManager.Keys(PlatformAction.Save));
 
             checkMutations();

From dae7cdc4c50efeaec5d2fab48d10e25360f7f669 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 26 Oct 2021 15:59:48 +0900
Subject: [PATCH 0479/5547] Ensure `HitObject`-local control points are
 non-default after `ApplyDefaults`

We will probably want to make this whole flow more efficient in the
future, but this should suffice for now.
---
 osu.Game/Rulesets/Objects/HitObject.cs | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/osu.Game/Rulesets/Objects/HitObject.cs b/osu.Game/Rulesets/Objects/HitObject.cs
index 035ebe10cb..a80b3d0fa5 100644
--- a/osu.Game/Rulesets/Objects/HitObject.cs
+++ b/osu.Game/Rulesets/Objects/HitObject.cs
@@ -119,6 +119,8 @@ namespace osu.Game.Rulesets.Objects
                 DifficultyControlPoint = (DifficultyControlPoint)legacyInfo.DifficultyPointAt(StartTime).DeepClone();
                 DifficultyControlPoint.Time = StartTime;
             }
+            else if (DifficultyControlPoint == DifficultyControlPoint.DEFAULT)
+                DifficultyControlPoint = new DifficultyControlPoint();
 
             ApplyDefaultsToSelf(controlPointInfo, difficulty);
 
@@ -128,6 +130,8 @@ namespace osu.Game.Rulesets.Objects
                 SampleControlPoint = (SampleControlPoint)legacyInfo.SamplePointAt(this.GetEndTime() + control_point_leniency).DeepClone();
                 SampleControlPoint.Time = this.GetEndTime() + control_point_leniency;
             }
+            else if (SampleControlPoint == SampleControlPoint.DEFAULT)
+                SampleControlPoint = new SampleControlPoint();
 
             nestedHitObjects.Clear();
 

From ea55ba7ba9f4526129e37c484773d7a64c8568eb Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 26 Oct 2021 16:08:21 +0900
Subject: [PATCH 0480/5547] Remove unused using statement

---
 osu.Game/Screens/OnlinePlay/Multiplayer/GameplayChatDisplay.cs | 1 -
 1 file changed, 1 deletion(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/GameplayChatDisplay.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/GameplayChatDisplay.cs
index ff24035d0e..0e73f65f8b 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/GameplayChatDisplay.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/GameplayChatDisplay.cs
@@ -10,7 +10,6 @@ using osu.Game.Input.Bindings;
 using osu.Game.Online.Rooms;
 using osu.Game.Screens.OnlinePlay.Match.Components;
 using osu.Game.Screens.Play;
-using osuTK.Input;
 
 namespace osu.Game.Screens.OnlinePlay.Multiplayer
 {

From e92def0ba28ef701f576d83e1cf8cd32ee34319f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 26 Oct 2021 17:19:29 +0900
Subject: [PATCH 0481/5547] Fix `LegacyBeatmapEncoder` using incorrect path
 length value

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

diff --git a/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs b/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs
index 1dc270ee63..7cd4244cd0 100644
--- a/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs
+++ b/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs
@@ -460,7 +460,7 @@ namespace osu.Game.Beatmaps.Formats
             var curveData = pathData as IHasPathWithRepeats;
 
             writer.Write(FormattableString.Invariant($"{(curveData?.RepeatCount ?? 0) + 1},"));
-            writer.Write(FormattableString.Invariant($"{pathData.Path.Distance},"));
+            writer.Write(FormattableString.Invariant($"{pathData.Path.ExpectedDistance.Value ?? pathData.Path.Distance},"));
 
             if (curveData != null)
             {

From aa0762ebe20a1153dfdbadc50f517ac5642ac995 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 26 Oct 2021 17:35:03 +0900
Subject: [PATCH 0482/5547] Add test coverage for failing slider case

---
 .../Formats/LegacyBeatmapDecoderTest.cs       | 17 +++++++++++++++++
 .../duplicate-last-position-slider.osu        | 19 +++++++++++++++++++
 2 files changed, 36 insertions(+)
 create mode 100644 osu.Game.Tests/Resources/duplicate-last-position-slider.osu

diff --git a/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs b/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs
index cb12d03620..d37e09aa29 100644
--- a/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs
+++ b/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs
@@ -775,5 +775,22 @@ namespace osu.Game.Tests.Beatmaps.Formats
                 Assert.That(seventh.ControlPoints[4].Type == null);
             }
         }
+
+        [Test]
+        public void TestSliderLengthExtensionEdgeCase()
+        {
+            var decoder = new LegacyBeatmapDecoder { ApplyOffsets = false };
+
+            using (var resStream = TestResources.OpenResource("duplicate-last-position-slider.osu"))
+            using (var stream = new LineBufferedReader(resStream))
+            {
+                var decoded = decoder.Decode(stream);
+
+                var path = ((IHasPath)decoded.HitObjects[0]).Path;
+
+                Assert.That(path.ExpectedDistance.Value, Is.EqualTo(2));
+                Assert.That(path.Distance, Is.EqualTo(1));
+            }
+        }
     }
 }
diff --git a/osu.Game.Tests/Resources/duplicate-last-position-slider.osu b/osu.Game.Tests/Resources/duplicate-last-position-slider.osu
new file mode 100644
index 0000000000..782dd4263e
--- /dev/null
+++ b/osu.Game.Tests/Resources/duplicate-last-position-slider.osu
@@ -0,0 +1,19 @@
+osu file format v14
+
+[Difficulty]
+HPDrainRate:7
+CircleSize:10
+OverallDifficulty:9
+ApproachRate:10
+SliderMultiplier:0.4
+SliderTickRate:1
+
+[TimingPoints]
+382,923.076923076923,3,2,1,75,1,0
+382,-1000,3,2,1,75,0,0
+
+[HitObjects]
+
+// Importantly, the last position is specified twice.
+// In this case, osu-stable doesn't extend the slider length even when the "expected" length is higher than the actual.
+261,171,25305,6,0,B|262:171|262:171|262:171,1,2,8|0,0:0|0:0,0:0:0:0:

From 708d40931b8009d3c036df32ad0487ab43abc6f1 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 26 Oct 2021 16:36:54 +0900
Subject: [PATCH 0483/5547] Add back remaining attempt display on playlist room
 screen

---
 .../Playlists/PlaylistsRoomSubScreen.cs         | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSubScreen.cs b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSubScreen.cs
index d5e423a438..5f2e444165 100644
--- a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSubScreen.cs
@@ -153,6 +153,22 @@ namespace osu.Game.Screens.OnlinePlay.Playlists
                                 },
                             },
                             new Drawable[]
+                            {
+                                new FillFlowContainer
+                                {
+                                    RelativeSizeAxes = Axes.X,
+                                    AutoSizeAxes = Axes.Y,
+                                    Alpha = Room.MaxAttempts.Value != null ? 1 : 0,
+                                    Margin = new MarginPadding { Bottom = 10 },
+                                    Direction = FillDirection.Vertical,
+                                    Children = new Drawable[]
+                                    {
+                                        new OverlinedHeader("Progress"),
+                                        new RoomLocalUserInfo(),
+                                    }
+                                },
+                            },
+                            new Drawable[]
                             {
                                 new OverlinedHeader("Leaderboard")
                             },
@@ -162,6 +178,7 @@ namespace osu.Game.Screens.OnlinePlay.Playlists
                         },
                         RowDimensions = new[]
                         {
+                            new Dimension(GridSizeMode.AutoSize),
                             new Dimension(GridSizeMode.AutoSize),
                             new Dimension(GridSizeMode.AutoSize),
                             new Dimension(),

From bffd9162ba15055260021053a2bcfc5b23f13fd2 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 26 Oct 2021 16:40:45 +0900
Subject: [PATCH 0484/5547] Tint attempt count red when no attempts remain

---
 osu.Game/Screens/OnlinePlay/Components/RoomLocalUserInfo.cs | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/osu.Game/Screens/OnlinePlay/Components/RoomLocalUserInfo.cs b/osu.Game/Screens/OnlinePlay/Components/RoomLocalUserInfo.cs
index 1fcf7f2277..3bad6cb183 100644
--- a/osu.Game/Screens/OnlinePlay/Components/RoomLocalUserInfo.cs
+++ b/osu.Game/Screens/OnlinePlay/Components/RoomLocalUserInfo.cs
@@ -14,6 +14,9 @@ namespace osu.Game.Screens.OnlinePlay.Components
     {
         private OsuSpriteText attemptDisplay;
 
+        [Resolved]
+        private OsuColour colours { get; set; }
+
         public RoomLocalUserInfo()
         {
             AutoSizeAxes = Axes.Both;
@@ -54,6 +57,9 @@ namespace osu.Game.Screens.OnlinePlay.Components
                 {
                     int remaining = MaxAttempts.Value.Value - UserScore.Value.PlaylistItemAttempts.Sum(a => a.Attempts);
                     attemptDisplay.Text += $" ({remaining} remaining)";
+
+                    if (remaining == 0)
+                        attemptDisplay.Colour = colours.RedLight;
                 }
             }
             else

From 1c578f285accf3f17168708ba5c6aa1fd402f6ec Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 26 Oct 2021 16:54:55 +0900
Subject: [PATCH 0485/5547] Disable playlist start button when attempts have
 been exhausted

---
 .../Playlists/PlaylistsReadyButton.cs         | 23 ++++++++++++++++++-
 1 file changed, 22 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsReadyButton.cs b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsReadyButton.cs
index 9ac1fe1722..ea85a8bcc1 100644
--- a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsReadyButton.cs
+++ b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsReadyButton.cs
@@ -32,11 +32,32 @@ namespace osu.Game.Screens.OnlinePlay.Playlists
             Triangles.ColourLight = colours.GreenLight;
         }
 
+        private bool hasRemainingAttempts = true;
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            userScore.BindValueChanged(aggregate =>
+            {
+                if (maxAttempts.Value == null)
+                    return;
+
+                int remaining = maxAttempts.Value.Value - aggregate.NewValue.PlaylistItemAttempts.Sum(a => a.Attempts);
+
+                hasRemainingAttempts = remaining > 0;
+            });
+        }
+
         protected override void Update()
         {
             base.Update();
 
-            Enabled.Value = endDate.Value != null && DateTimeOffset.UtcNow.AddSeconds(30).AddMilliseconds(gameBeatmap.Value.Track.Length) < endDate.Value;
+            Enabled.Value = hasRemainingAttempts && enoughTimeLeft;
         }
+
+        private bool enoughTimeLeft =>
+            // This should probably consider the length of the currently selected item, rather than a constant 30 seconds.
+            endDate.Value != null && DateTimeOffset.UtcNow.AddSeconds(30).AddMilliseconds(gameBeatmap.Value.Track.Length) < endDate.Value;
     }
 }

From 42d8d4fd380bcdc2fdd4a7b96178b7f4a551386f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 26 Oct 2021 16:55:24 +0900
Subject: [PATCH 0486/5547] Add tooltips to start button to explain why it's
 not clickable

---
 .../OnlinePlay/Components/ReadyButton.cs      | 18 +++++++++++--
 .../Playlists/PlaylistsReadyButton.cs         | 25 +++++++++++++++++++
 2 files changed, 41 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Components/ReadyButton.cs b/osu.Game/Screens/OnlinePlay/Components/ReadyButton.cs
index 8f85608b29..5a4a0a0fba 100644
--- a/osu.Game/Screens/OnlinePlay/Components/ReadyButton.cs
+++ b/osu.Game/Screens/OnlinePlay/Components/ReadyButton.cs
@@ -3,13 +3,15 @@
 
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
+using osu.Framework.Graphics.Cursor;
+using osu.Framework.Localisation;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Online;
 using osu.Game.Online.Rooms;
 
 namespace osu.Game.Screens.OnlinePlay.Components
 {
-    public abstract class ReadyButton : TriangleButton
+    public abstract class ReadyButton : TriangleButton, IHasTooltip
     {
         public new readonly BindableBool Enabled = new BindableBool();
 
@@ -24,6 +26,18 @@ namespace osu.Game.Screens.OnlinePlay.Components
             Enabled.BindValueChanged(_ => updateState(), true);
         }
 
-        private void updateState() => base.Enabled.Value = availability.Value.State == DownloadState.LocallyAvailable && Enabled.Value;
+        private void updateState() =>
+            base.Enabled.Value = availability.Value.State == DownloadState.LocallyAvailable && Enabled.Value;
+
+        public virtual LocalisableString TooltipText
+        {
+            get
+            {
+                if (Enabled.Value)
+                    return string.Empty;
+
+                return "Beatmap not downloaded";
+            }
+        }
     }
 }
diff --git a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsReadyButton.cs b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsReadyButton.cs
index ea85a8bcc1..24f112ef0c 100644
--- a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsReadyButton.cs
+++ b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsReadyButton.cs
@@ -2,8 +2,10 @@
 // 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.Localisation;
 using osu.Game.Beatmaps;
 using osu.Game.Graphics;
 using osu.Game.Online.Rooms;
@@ -16,6 +18,12 @@ namespace osu.Game.Screens.OnlinePlay.Playlists
         [Resolved(typeof(Room), nameof(Room.EndDate))]
         private Bindable<DateTimeOffset?> endDate { get; set; }
 
+        [Resolved(typeof(Room), nameof(Room.MaxAttempts))]
+        private Bindable<int?> maxAttempts { get; set; }
+
+        [Resolved(typeof(Room), nameof(Room.UserScore))]
+        private Bindable<PlaylistAggregateScore> userScore { get; set; }
+
         [Resolved]
         private IBindable<WorkingBeatmap> gameBeatmap { get; set; }
 
@@ -56,6 +64,23 @@ namespace osu.Game.Screens.OnlinePlay.Playlists
             Enabled.Value = hasRemainingAttempts && enoughTimeLeft;
         }
 
+        public override LocalisableString TooltipText
+        {
+            get
+            {
+                if (Enabled.Value)
+                    return string.Empty;
+
+                if (!enoughTimeLeft)
+                    return "No time left!";
+
+                if (!hasRemainingAttempts)
+                    return "Attempts exhausted!";
+
+                return base.TooltipText;
+            }
+        }
+
         private bool enoughTimeLeft =>
             // This should probably consider the length of the currently selected item, rather than a constant 30 seconds.
             endDate.Value != null && DateTimeOffset.UtcNow.AddSeconds(30).AddMilliseconds(gameBeatmap.Value.Track.Length) < endDate.Value;

From c15bfb2cf44d569062961a7ed59aee738b7684bc Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 26 Oct 2021 18:13:28 +0900
Subject: [PATCH 0487/5547] Handle bindable changes to fix new playlist
 creation not showing correct details

---
 .../OnlinePlay/Playlists/PlaylistsRoomSubScreen.cs        | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSubScreen.cs b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSubScreen.cs
index 5f2e444165..6d2a426e70 100644
--- a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSubScreen.cs
@@ -37,6 +37,8 @@ namespace osu.Game.Screens.OnlinePlay.Playlists
         private MatchLeaderboard leaderboard;
         private SelectionPollingComponent selectionPollingComponent;
 
+        private FillFlowContainer progressSection;
+
         public PlaylistsRoomSubScreen(Room room)
             : base(room, false) // Editing is temporarily not allowed.
         {
@@ -67,6 +69,8 @@ namespace osu.Game.Screens.OnlinePlay.Playlists
                     Schedule(() => SelectedItem.Value = Room.Playlist.FirstOrDefault());
                 }
             }, true);
+
+            Room.MaxAttempts.BindValueChanged(attempts => progressSection.Alpha = Room.MaxAttempts.Value != null ? 1 : 0, true);
         }
 
         protected override Drawable CreateMainContent() => new GridContainer
@@ -154,11 +158,11 @@ namespace osu.Game.Screens.OnlinePlay.Playlists
                             },
                             new Drawable[]
                             {
-                                new FillFlowContainer
+                                progressSection = new FillFlowContainer
                                 {
                                     RelativeSizeAxes = Axes.X,
                                     AutoSizeAxes = Axes.Y,
-                                    Alpha = Room.MaxAttempts.Value != null ? 1 : 0,
+                                    Alpha = 0,
                                     Margin = new MarginPadding { Bottom = 10 },
                                     Direction = FillDirection.Vertical,
                                     Children = new Drawable[]

From 1147c6cbfc60584536237a15459b101c248a3e3c Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Tue, 26 Oct 2021 19:56:54 +0900
Subject: [PATCH 0488/5547] Remove unnecessary default value

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

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModHidden.cs b/osu.Game.Rulesets.Osu/Mods/OsuModHidden.cs
index e5cc08c886..e162f805a1 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModHidden.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModHidden.cs
@@ -20,7 +20,7 @@ namespace osu.Game.Rulesets.Osu.Mods
     public class OsuModHidden : ModHidden, IHidesApproachCircles
     {
         [SettingSource("Only fade approach circles", "The main object body will not fade when enabled.")]
-        public Bindable<bool> OnlyFadeApproachCircles { get; } = new BindableBool(false);
+        public Bindable<bool> OnlyFadeApproachCircles { get; } = new BindableBool();
 
         public override string Description => @"Play with no approach circles and fading circles/sliders.";
         public override double ScoreMultiplier => 1.06;

From e5050b90a56a08bffbacb951d91cd83a4a30fba0 Mon Sep 17 00:00:00 2001
From: ekrctb <ekrctb@gmail.com>
Date: Tue, 26 Oct 2021 20:09:48 +0900
Subject: [PATCH 0489/5547] Don't assume catcher dash speed is 2x the walk
 speed

---
 .../Beatmaps/CatchBeatmapProcessor.cs             |  2 +-
 .../Edit/CatchHitObjectComposer.cs                |  4 ++--
 .../Replays/CatchAutoGenerator.cs                 | 11 ++++-------
 osu.Game.Rulesets.Catch/UI/Catcher.cs             | 15 ++++++++++-----
 4 files changed, 17 insertions(+), 15 deletions(-)

diff --git a/osu.Game.Rulesets.Catch/Beatmaps/CatchBeatmapProcessor.cs b/osu.Game.Rulesets.Catch/Beatmaps/CatchBeatmapProcessor.cs
index 87cc2c45e8..346a09cac8 100644
--- a/osu.Game.Rulesets.Catch/Beatmaps/CatchBeatmapProcessor.cs
+++ b/osu.Game.Rulesets.Catch/Beatmaps/CatchBeatmapProcessor.cs
@@ -233,7 +233,7 @@ namespace osu.Game.Rulesets.Catch.Beatmaps
                 int thisDirection = nextObject.EffectiveX > currentObject.EffectiveX ? 1 : -1;
                 double timeToNext = nextObject.StartTime - currentObject.StartTime - 1000f / 60f / 4; // 1/4th of a frame of grace time, taken from osu-stable
                 double distanceToNext = Math.Abs(nextObject.EffectiveX - currentObject.EffectiveX) - (lastDirection == thisDirection ? lastExcess : halfCatcherWidth);
-                float distanceToHyper = (float)(timeToNext * Catcher.BASE_SPEED - distanceToNext);
+                float distanceToHyper = (float)(timeToNext * Catcher.BASE_DASH_SPEED - distanceToNext);
 
                 if (distanceToHyper < 0)
                 {
diff --git a/osu.Game.Rulesets.Catch/Edit/CatchHitObjectComposer.cs b/osu.Game.Rulesets.Catch/Edit/CatchHitObjectComposer.cs
index 67055fb5e0..164f465438 100644
--- a/osu.Game.Rulesets.Catch/Edit/CatchHitObjectComposer.cs
+++ b/osu.Game.Rulesets.Catch/Edit/CatchHitObjectComposer.cs
@@ -51,8 +51,8 @@ namespace osu.Game.Rulesets.Catch.Edit
             LayerBelowRuleset.Add(distanceSnapGrid = new CatchDistanceSnapGrid(new[]
             {
                 0.0,
-                Catcher.BASE_SPEED, -Catcher.BASE_SPEED,
-                Catcher.BASE_SPEED / 2, -Catcher.BASE_SPEED / 2,
+                Catcher.BASE_DASH_SPEED, -Catcher.BASE_DASH_SPEED,
+                Catcher.BASE_WALK_SPEED, -Catcher.BASE_WALK_SPEED,
             }));
         }
 
diff --git a/osu.Game.Rulesets.Catch/Replays/CatchAutoGenerator.cs b/osu.Game.Rulesets.Catch/Replays/CatchAutoGenerator.cs
index 2fc05701db..7c84cb24f3 100644
--- a/osu.Game.Rulesets.Catch/Replays/CatchAutoGenerator.cs
+++ b/osu.Game.Rulesets.Catch/Replays/CatchAutoGenerator.cs
@@ -26,9 +26,6 @@ namespace osu.Game.Rulesets.Catch.Replays
             if (Beatmap.HitObjects.Count == 0)
                 return;
 
-            // todo: add support for HT DT
-            const double dash_speed = Catcher.BASE_SPEED;
-            const double movement_speed = dash_speed / 2;
             float lastPosition = CatchPlayfield.CENTER_X;
             double lastTime = 0;
 
@@ -47,8 +44,8 @@ namespace osu.Game.Rulesets.Catch.Replays
                 // The case where positionChange > 0 and timeAvailable == 0 results in PositiveInfinity which provides expected beheaviour.
                 double speedRequired = positionChange == 0 ? 0 : positionChange / timeAvailable;
 
-                bool dashRequired = speedRequired > movement_speed;
-                bool impossibleJump = speedRequired > movement_speed * 2;
+                bool dashRequired = speedRequired > Catcher.BASE_WALK_SPEED;
+                bool impossibleJump = speedRequired > Catcher.BASE_DASH_SPEED;
 
                 // todo: get correct catcher size, based on difficulty CS.
                 const float catcher_width_half = Catcher.BASE_SIZE * 0.3f * 0.5f;
@@ -73,7 +70,7 @@ namespace osu.Game.Rulesets.Catch.Replays
                 else if (dashRequired)
                 {
                     // we do a movement in two parts - the dash part then the normal part...
-                    double timeAtNormalSpeed = positionChange / movement_speed;
+                    double timeAtNormalSpeed = positionChange / Catcher.BASE_WALK_SPEED;
                     double timeWeNeedToSave = timeAtNormalSpeed - timeAvailable;
                     double timeAtDashSpeed = timeWeNeedToSave / 2;
 
@@ -86,7 +83,7 @@ namespace osu.Game.Rulesets.Catch.Replays
                 }
                 else
                 {
-                    double timeBefore = positionChange / movement_speed;
+                    double timeBefore = positionChange / Catcher.BASE_WALK_SPEED;
 
                     addFrame(h.StartTime - timeBefore, lastPosition);
                     addFrame(h.StartTime, h.EffectiveX);
diff --git a/osu.Game.Rulesets.Catch/UI/Catcher.cs b/osu.Game.Rulesets.Catch/UI/Catcher.cs
index 3745099010..a70dbcf25e 100644
--- a/osu.Game.Rulesets.Catch/UI/Catcher.cs
+++ b/osu.Game.Rulesets.Catch/UI/Catcher.cs
@@ -57,14 +57,19 @@ namespace osu.Game.Rulesets.Catch.UI
         public bool CatchFruitOnPlate { get; set; } = true;
 
         /// <summary>
-        /// The relative space to cover in 1 millisecond. based on 1 game pixel per millisecond as in osu-stable.
+        /// The speed of the catcher when the catcher is dashing.
         /// </summary>
-        public const double BASE_SPEED = 1.0;
+        public const double BASE_DASH_SPEED = 1.0;
 
         /// <summary>
-        /// The current speed of the catcher.
+        /// The speed of the catcher when the catcher is not dashing.
         /// </summary>
-        public double Speed => (Dashing ? 1 : 0.5) * BASE_SPEED * hyperDashModifier;
+        public const double BASE_WALK_SPEED = 0.5;
+
+        /// <summary>
+        /// The current speed of the catcher with the hyper-dash modifier applied.
+        /// </summary>
+        public double Speed => (Dashing ? BASE_DASH_SPEED : BASE_WALK_SPEED) * hyperDashModifier;
 
         /// <summary>
         /// The amount by which caught fruit should be scaled down to fit on the plate.
@@ -230,7 +235,7 @@ namespace osu.Game.Rulesets.Catch.UI
                 double positionDifference = target.EffectiveX - X;
                 var velocity = positionDifference / Math.Max(1.0, timeDifference - 1000.0 / 60.0);
 
-                SetHyperDashState(Math.Abs(velocity), target.EffectiveX);
+                SetHyperDashState(Math.Abs(velocity) / BASE_DASH_SPEED, target.EffectiveX);
             }
             else
                 SetHyperDashState();

From 393d118eef783c14f5534710bdc7fbf99c971c76 Mon Sep 17 00:00:00 2001
From: ekrctb <ekrctb@gmail.com>
Date: Tue, 26 Oct 2021 20:20:43 +0900
Subject: [PATCH 0490/5547] Fix compilation failure overlooked in merge

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

diff --git a/osu.Game.Rulesets.Catch/Edit/CatchDistanceSnapGrid.cs b/osu.Game.Rulesets.Catch/Edit/CatchDistanceSnapGrid.cs
index 137ac1fc59..9a78c7ff86 100644
--- a/osu.Game.Rulesets.Catch/Edit/CatchDistanceSnapGrid.cs
+++ b/osu.Game.Rulesets.Catch/Edit/CatchDistanceSnapGrid.cs
@@ -28,7 +28,7 @@ namespace osu.Game.Rulesets.Catch.Edit
 
         public float StartX { get; set; }
 
-        private const double max_vertical_line_length_in_time = CatchPlayfield.WIDTH / Catcher.BASE_SPEED * 2;
+        private const double max_vertical_line_length_in_time = CatchPlayfield.WIDTH / Catcher.BASE_WALK_SPEED;
 
         private readonly double[] velocities;
 

From 411586bac36ae84807ab3f8076b280c5a0b8dcbc Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 26 Oct 2021 22:12:56 +0900
Subject: [PATCH 0491/5547] Update resources

---
 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 9e0d31e7e5..552675d706 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -51,7 +51,7 @@
     <Reference Include="Java.Interop" />
   </ItemGroup>
   <ItemGroup>
-    <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1015.0" />
+    <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1026.0" />
     <PackageReference Include="ppy.osu.Framework.Android" Version="2021.1026.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index a9555b555e..8ba6e41d53 100644
--- a/osu.Game/osu.Game.csproj
+++ b/osu.Game/osu.Game.csproj
@@ -37,7 +37,7 @@
     </PackageReference>
     <PackageReference Include="Realm" Version="10.6.0" />
     <PackageReference Include="ppy.osu.Framework" Version="2021.1026.0" />
-    <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1015.0" />
+    <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1026.0" />
     <PackageReference Include="Sentry" Version="3.9.4" />
     <PackageReference Include="SharpCompress" Version="0.29.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
diff --git a/osu.iOS.props b/osu.iOS.props
index 1669573c26..e55dbb3bfe 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -71,7 +71,7 @@
   </ItemGroup>
   <ItemGroup Label="Package References">
     <PackageReference Include="ppy.osu.Framework.iOS" Version="2021.1026.0" />
-    <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1015.0" />
+    <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1026.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net5.0 / net6.0) -->
   <PropertyGroup>

From 670fcea68d07b2f89ae2a70414ba6d960fca1228 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 26 Oct 2021 18:56:34 +0200
Subject: [PATCH 0492/5547] Rename some variables

---
 osu.Game.Rulesets.Osu/Mods/OsuModNoScope.cs | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModNoScope.cs b/osu.Game.Rulesets.Osu/Mods/OsuModNoScope.cs
index 026bb6c1cb..10de06a550 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModNoScope.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModNoScope.cs
@@ -42,7 +42,7 @@ namespace osu.Game.Rulesets.Osu.Mods
         private IBindable<bool> isBreakTime;
         private PeriodTracker spinnerPeriods;
 
-        private float targetAlpha;
+        private float comboBasedAlpha;
 
         [SettingSource(
             "Hidden at combo",
@@ -76,15 +76,15 @@ namespace osu.Game.Rulesets.Osu.Mods
             currentCombo = scoreProcessor.Combo.GetBoundCopy();
             currentCombo.BindValueChanged(combo =>
             {
-                targetAlpha = Math.Max(min_alpha, 1 - (float)combo.NewValue / HiddenComboCount.Value);
+                comboBasedAlpha = Math.Max(min_alpha, 1 - (float)combo.NewValue / HiddenComboCount.Value);
             }, true);
         }
 
         public virtual void Update(Playfield playfield)
         {
-            var overrideAlpha = isBreakTime.Value || spinnerPeriods.IsInAny(playfield.Clock.CurrentTime);
-            var targetOverriddenAlpha = overrideAlpha ? 1 : targetAlpha;
-            playfield.Cursor.Alpha = (float)Interpolation.Lerp(playfield.Cursor.Alpha, targetOverriddenAlpha, Math.Clamp(playfield.Time.Elapsed / transition_duration, 0, 1));
+            var shouldAlwaysShowCursor = isBreakTime.Value || spinnerPeriods.IsInAny(playfield.Clock.CurrentTime);
+            var targetAlpha = shouldAlwaysShowCursor ? 1 : comboBasedAlpha;
+            playfield.Cursor.Alpha = (float)Interpolation.Lerp(playfield.Cursor.Alpha, targetAlpha, Math.Clamp(playfield.Time.Elapsed / transition_duration, 0, 1));
         }
     }
 

From f64fa65fd5c2297f9f0d0355c189feaffb3ec3bb Mon Sep 17 00:00:00 2001
From: Jason Won <jasonwon628@gmail.com>
Date: Tue, 26 Oct 2021 14:52:15 -0400
Subject: [PATCH 0493/5547] right click on unselected object shows context menu

---
 .../Editing/TestSceneComposerSelection.cs     | 24 +++++++++++++++++++
 .../Compose/Components/BlueprintContainer.cs  | 12 +++++++---
 2 files changed, 33 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneComposerSelection.cs b/osu.Game.Tests/Visual/Editing/TestSceneComposerSelection.cs
index a2a7b72283..36663591f2 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneComposerSelection.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneComposerSelection.cs
@@ -42,6 +42,30 @@ namespace osu.Game.Tests.Visual.Editing
             });
         }
 
+        [Test]
+        public void TestSelectAndShowContextMenu()
+        {
+            var addedObject = new HitCircle { StartTime = 100, Position = new Vector2(100, 100) };
+            AddStep("add hitobject", () => EditorBeatmap.Add(addedObject));
+
+            moveMouseToObject(() => addedObject);
+            AddStep("right click", () => InputManager.Click(MouseButton.Right));
+
+            AddAssert("hitobject selected", () => EditorBeatmap.SelectedHitObjects.Single() == addedObject);
+
+            AddStep("delete from context menu", () =>
+            {
+                var pos = blueprintContainer.SelectionBlueprints
+                                            .First(s => s.Item == addedObject)
+                                            .ChildrenOfType<HitCirclePiece>()
+                                            .First();
+
+                InputManager.MoveMouseTo(pos, new Vector2(50, 120));
+                InputManager.Click(MouseButton.Left);
+            });
+            AddAssert("no hitobjects in beatmap", () => EditorBeatmap.HitObjects.Count == 0);
+        }
+
         [Test]
         public void TestNudgeSelection()
         {
diff --git a/osu.Game/Screens/Edit/Compose/Components/BlueprintContainer.cs b/osu.Game/Screens/Edit/Compose/Components/BlueprintContainer.cs
index 75d4d13f94..0de99831f2 100644
--- a/osu.Game/Screens/Edit/Compose/Components/BlueprintContainer.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/BlueprintContainer.cs
@@ -108,11 +108,17 @@ namespace osu.Game.Screens.Edit.Compose.Components
         protected override bool OnMouseDown(MouseDownEvent e)
         {
             bool selectionPerformed = performMouseDownActions(e);
-
-            // even if a selection didn't occur, a drag event may still move the selection.
             bool movementPossible = prepareSelectionMovement();
 
-            return selectionPerformed || (e.Button == MouseButton.Left && movementPossible);
+            // check if selection has occurred
+            if (selectionPerformed)
+            {
+                // propagate right click to show context menu on selection
+                return e.Button != MouseButton.Right;
+            }
+
+            // even if a selection didn't occur, a drag event may still move the selection.
+            return e.Button == MouseButton.Left && movementPossible;
         }
 
         protected SelectionBlueprint<T> ClickedBlueprint { get; private set; }

From 4efa1f23bb7c0ce836d0d59b8748cc4b8583d962 Mon Sep 17 00:00:00 2001
From: Jason Won <jasonwon628@gmail.com>
Date: Tue, 26 Oct 2021 15:29:50 -0400
Subject: [PATCH 0494/5547] fix context menu test

---
 .../Editing/TestSceneComposerSelection.cs     | 19 +++++++------------
 1 file changed, 7 insertions(+), 12 deletions(-)

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneComposerSelection.cs b/osu.Game.Tests/Visual/Editing/TestSceneComposerSelection.cs
index 36663591f2..9aae595808 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneComposerSelection.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneComposerSelection.cs
@@ -5,7 +5,10 @@ using System;
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Testing;
+using osu.Framework.Graphics.Cursor;
+using osu.Framework.Graphics.UserInterface;
 using osu.Game.Beatmaps;
+using osu.Game.Graphics.UserInterface;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Osu;
@@ -29,6 +32,9 @@ namespace osu.Game.Tests.Visual.Editing
         private ComposeBlueprintContainer blueprintContainer
             => Editor.ChildrenOfType<ComposeBlueprintContainer>().First();
 
+        private ContextMenuContainer contextMenuContainer
+            => Editor.ChildrenOfType<ContextMenuContainer>().First();
+
         private void moveMouseToObject(Func<HitObject> targetFunc)
         {
             AddStep("move mouse to object", () =>
@@ -52,18 +58,7 @@ namespace osu.Game.Tests.Visual.Editing
             AddStep("right click", () => InputManager.Click(MouseButton.Right));
 
             AddAssert("hitobject selected", () => EditorBeatmap.SelectedHitObjects.Single() == addedObject);
-
-            AddStep("delete from context menu", () =>
-            {
-                var pos = blueprintContainer.SelectionBlueprints
-                                            .First(s => s.Item == addedObject)
-                                            .ChildrenOfType<HitCirclePiece>()
-                                            .First();
-
-                InputManager.MoveMouseTo(pos, new Vector2(50, 120));
-                InputManager.Click(MouseButton.Left);
-            });
-            AddAssert("no hitobjects in beatmap", () => EditorBeatmap.HitObjects.Count == 0);
+            AddAssert("context menu is visible", () => contextMenuContainer.ChildrenOfType<OsuContextMenu>().Single().State == MenuState.Open);
         }
 
         [Test]

From c633e2e9521b9c9ae86defae674a0d65b16efabd Mon Sep 17 00:00:00 2001
From: Jason Won <jasonwon628@gmail.com>
Date: Tue, 26 Oct 2021 16:24:53 -0400
Subject: [PATCH 0495/5547] only propagate unmodified right click

---
 .../Visual/Editing/TestSceneComposerSelection.cs           | 4 ++--
 .../Screens/Edit/Compose/Components/BlueprintContainer.cs  | 7 +++++--
 2 files changed, 7 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneComposerSelection.cs b/osu.Game.Tests/Visual/Editing/TestSceneComposerSelection.cs
index 9aae595808..dddd9f07ab 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneComposerSelection.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneComposerSelection.cs
@@ -57,8 +57,8 @@ namespace osu.Game.Tests.Visual.Editing
             moveMouseToObject(() => addedObject);
             AddStep("right click", () => InputManager.Click(MouseButton.Right));
 
-            AddAssert("hitobject selected", () => EditorBeatmap.SelectedHitObjects.Single() == addedObject);
-            AddAssert("context menu is visible", () => contextMenuContainer.ChildrenOfType<OsuContextMenu>().Single().State == MenuState.Open);
+            AddUntilStep("hitobject selected", () => EditorBeatmap.SelectedHitObjects.Single() == addedObject);
+            AddUntilStep("context menu is visible", () => contextMenuContainer.ChildrenOfType<OsuContextMenu>().Single().State == MenuState.Open);
         }
 
         [Test]
diff --git a/osu.Game/Screens/Edit/Compose/Components/BlueprintContainer.cs b/osu.Game/Screens/Edit/Compose/Components/BlueprintContainer.cs
index 0de99831f2..7391c1a642 100644
--- a/osu.Game/Screens/Edit/Compose/Components/BlueprintContainer.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/BlueprintContainer.cs
@@ -113,8 +113,11 @@ namespace osu.Game.Screens.Edit.Compose.Components
             // check if selection has occurred
             if (selectionPerformed)
             {
-                // propagate right click to show context menu on selection
-                return e.Button != MouseButton.Right;
+                // only unmodified right click should show context menu
+                var shouldShowContextMenu = e.Button == MouseButton.Right && !e.ShiftPressed && !e.AltPressed && !e.SuperPressed;
+
+                // stop propagation if not showing context menu
+                return !shouldShowContextMenu;
             }
 
             // even if a selection didn't occur, a drag event may still move the selection.

From 1a77e98537b30269e32472edd3aa504034a541eb Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 17 Oct 2021 15:52:40 +0200
Subject: [PATCH 0496/5547] Implement difficulty spectrum display

---
 .../TestSceneDifficultySpectrumDisplay.cs     |  84 +++++++++++++
 .../Drawables/DifficultySpectrumDisplay.cs    | 114 ++++++++++++++++++
 2 files changed, 198 insertions(+)
 create mode 100644 osu.Game.Tests/Visual/Beatmaps/TestSceneDifficultySpectrumDisplay.cs
 create mode 100644 osu.Game/Beatmaps/Drawables/DifficultySpectrumDisplay.cs

diff --git a/osu.Game.Tests/Visual/Beatmaps/TestSceneDifficultySpectrumDisplay.cs b/osu.Game.Tests/Visual/Beatmaps/TestSceneDifficultySpectrumDisplay.cs
new file mode 100644
index 0000000000..8925c68ef4
--- /dev/null
+++ b/osu.Game.Tests/Visual/Beatmaps/TestSceneDifficultySpectrumDisplay.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 System.Linq;
+using NUnit.Framework;
+using osu.Framework.Graphics;
+using osu.Game.Beatmaps;
+using osu.Game.Beatmaps.Drawables;
+using osu.Game.Online.API.Requests.Responses;
+using osuTK;
+
+namespace osu.Game.Tests.Visual.Beatmaps
+{
+    public class TestSceneDifficultySpectrumDisplay : OsuTestScene
+    {
+        private static APIBeatmapSet createBeatmapSetWith(params (int rulesetId, double stars)[] difficulties) => new APIBeatmapSet
+        {
+            Beatmaps = difficulties.Select(difficulty => new APIBeatmap
+            {
+                RulesetID = difficulty.rulesetId,
+                StarRating = difficulty.stars
+            }).ToList()
+        };
+
+        [Test]
+        public void TestSingleRuleset()
+        {
+            var beatmapSet = createBeatmapSetWith(
+                (rulesetId: 0, stars: 2.0),
+                (rulesetId: 0, stars: 3.2),
+                (rulesetId: 0, stars: 5.6));
+
+            createDisplay(beatmapSet);
+        }
+
+        [Test]
+        public void TestMultipleRulesets()
+        {
+            var beatmapSet = createBeatmapSetWith(
+                (rulesetId: 0, stars: 2.0),
+                (rulesetId: 3, stars: 2.3),
+                (rulesetId: 0, stars: 3.2),
+                (rulesetId: 1, stars: 4.3),
+                (rulesetId: 0, stars: 5.6));
+
+            createDisplay(beatmapSet);
+        }
+
+        [Test]
+        public void TestUnknownRuleset()
+        {
+            var beatmapSet = createBeatmapSetWith(
+                (rulesetId: 0, stars: 2.0),
+                (rulesetId: 3, stars: 2.3),
+                (rulesetId: 0, stars: 3.2),
+                (rulesetId: 1, stars: 4.3),
+                (rulesetId: 0, stars: 5.6),
+                (rulesetId: 15, stars: 7.8));
+
+            createDisplay(beatmapSet);
+        }
+
+        [Test]
+        public void TestMaximumUncollapsed()
+        {
+            var beatmapSet = createBeatmapSetWith(Enumerable.Range(0, 12).Select(i => (rulesetId: i % 4, stars: 2.5 + i * 0.25)).ToArray());
+            createDisplay(beatmapSet);
+        }
+
+        [Test]
+        public void TestMinimumCollapsed()
+        {
+            var beatmapSet = createBeatmapSetWith(Enumerable.Range(0, 13).Select(i => (rulesetId: i % 4, stars: 2.5 + i * 0.25)).ToArray());
+            createDisplay(beatmapSet);
+        }
+
+        private void createDisplay(IBeatmapSetInfo beatmapSetInfo) => AddStep("create spectrum display", () => Child = new DifficultySpectrumDisplay(beatmapSetInfo)
+        {
+            Anchor = Anchor.Centre,
+            Origin = Anchor.Centre,
+            Scale = new Vector2(3)
+        });
+    }
+}
diff --git a/osu.Game/Beatmaps/Drawables/DifficultySpectrumDisplay.cs b/osu.Game/Beatmaps/Drawables/DifficultySpectrumDisplay.cs
new file mode 100644
index 0000000000..a773f6b12c
--- /dev/null
+++ b/osu.Game/Beatmaps/Drawables/DifficultySpectrumDisplay.cs
@@ -0,0 +1,114 @@
+// 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.LocalisationExtensions;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.Shapes;
+using osu.Framework.Graphics.Sprites;
+using osu.Game.Graphics;
+using osu.Game.Graphics.Sprites;
+using osu.Game.Rulesets;
+using osuTK;
+
+namespace osu.Game.Beatmaps.Drawables
+{
+    public class DifficultySpectrumDisplay : CompositeDrawable
+    {
+        public DifficultySpectrumDisplay(IBeatmapSetInfo beatmapSet)
+        {
+            AutoSizeAxes = Axes.Both;
+
+            FillFlowContainer<RulesetDifficultyGroup> flow;
+
+            InternalChild = flow = new FillFlowContainer<RulesetDifficultyGroup>
+            {
+                AutoSizeAxes = Axes.Both,
+                Spacing = new Vector2(10, 0),
+                Direction = FillDirection.Horizontal,
+            };
+
+            // matching web: https://github.com/ppy/osu-web/blob/d06d8c5e735eb1f48799b1654b528e9a7afb0a35/resources/assets/lib/beatmapset-panel.tsx#L127
+            bool collapsed = beatmapSet.Beatmaps.Count() > 12;
+
+            foreach (var rulesetGrouping in beatmapSet.Beatmaps.GroupBy(beatmap => beatmap.Ruleset.OnlineID))
+            {
+                flow.Add(new RulesetDifficultyGroup(rulesetGrouping.Key, rulesetGrouping, collapsed));
+            }
+        }
+
+        private class RulesetDifficultyGroup : FillFlowContainer
+        {
+            private readonly int rulesetId;
+            private readonly IEnumerable<IBeatmapInfo> beatmapInfos;
+            private readonly bool collapsed;
+
+            public RulesetDifficultyGroup(int rulesetId, IEnumerable<IBeatmapInfo> beatmapInfos, bool collapsed)
+            {
+                this.rulesetId = rulesetId;
+                this.beatmapInfos = beatmapInfos;
+                this.collapsed = collapsed;
+            }
+
+            [BackgroundDependencyLoader]
+            private void load(RulesetStore rulesets)
+            {
+                AutoSizeAxes = Axes.Both;
+                Spacing = new Vector2(1, 0);
+                Direction = FillDirection.Horizontal;
+
+                var icon = rulesets.GetRuleset(rulesetId)?.CreateInstance()?.CreateIcon() ?? new SpriteIcon { Icon = FontAwesome.Regular.QuestionCircle };
+                Add(icon.With(i =>
+                {
+                    i.Size = new Vector2(14);
+                    i.Anchor = i.Origin = Anchor.Centre;
+                }));
+
+                if (!collapsed)
+                {
+                    foreach (var beatmapInfo in beatmapInfos.OrderBy(bi => bi.StarRating))
+                        Add(new DifficultyDot(beatmapInfo.StarRating));
+                }
+                else
+                {
+                    Add(new OsuSpriteText
+                    {
+                        Text = beatmapInfos.Count().ToLocalisableString(@"N0"),
+                        Font = OsuFont.Default.With(size: 12),
+                        Anchor = Anchor.Centre,
+                        Origin = Anchor.Centre,
+                        Padding = new MarginPadding { Bottom = 1 }
+                    });
+                }
+            }
+        }
+
+        private class DifficultyDot : CircularContainer
+        {
+            private readonly double starDifficulty;
+
+            public DifficultyDot(double starDifficulty)
+            {
+                this.starDifficulty = starDifficulty;
+            }
+
+            [BackgroundDependencyLoader]
+            private void load(OsuColour colours)
+            {
+                Width = 4;
+                Height = 8;
+                Anchor = Origin = Anchor.Centre;
+                Masking = true;
+
+                Child = new Box
+                {
+                    RelativeSizeAxes = Axes.Both,
+                    Colour = colours.ForStarDifficulty(starDifficulty)
+                };
+            }
+        }
+    }
+}

From 3de994449df8831228ff1b0ed096b948732baf04 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 17 Oct 2021 16:05:55 +0200
Subject: [PATCH 0497/5547] Add support for changing dimensions of difficulty
 spectrum display

---
 .../TestSceneDifficultySpectrumDisplay.cs     | 28 ++++++++-
 .../Drawables/DifficultySpectrumDisplay.cs    | 63 +++++++++++++++++--
 2 files changed, 86 insertions(+), 5 deletions(-)

diff --git a/osu.Game.Tests/Visual/Beatmaps/TestSceneDifficultySpectrumDisplay.cs b/osu.Game.Tests/Visual/Beatmaps/TestSceneDifficultySpectrumDisplay.cs
index 8925c68ef4..1f38b05879 100644
--- a/osu.Game.Tests/Visual/Beatmaps/TestSceneDifficultySpectrumDisplay.cs
+++ b/osu.Game.Tests/Visual/Beatmaps/TestSceneDifficultySpectrumDisplay.cs
@@ -13,6 +13,8 @@ namespace osu.Game.Tests.Visual.Beatmaps
 {
     public class TestSceneDifficultySpectrumDisplay : OsuTestScene
     {
+        private DifficultySpectrumDisplay display;
+
         private static APIBeatmapSet createBeatmapSetWith(params (int rulesetId, double stars)[] difficulties) => new APIBeatmapSet
         {
             Beatmaps = difficulties.Select(difficulty => new APIBeatmap
@@ -74,7 +76,31 @@ namespace osu.Game.Tests.Visual.Beatmaps
             createDisplay(beatmapSet);
         }
 
-        private void createDisplay(IBeatmapSetInfo beatmapSetInfo) => AddStep("create spectrum display", () => Child = new DifficultySpectrumDisplay(beatmapSetInfo)
+        [Test]
+        public void TestAdjustableDotSize()
+        {
+            var beatmapSet = createBeatmapSetWith(
+                (rulesetId: 0, stars: 2.0),
+                (rulesetId: 3, stars: 2.3),
+                (rulesetId: 0, stars: 3.2),
+                (rulesetId: 1, stars: 4.3),
+                (rulesetId: 0, stars: 5.6));
+
+            createDisplay(beatmapSet);
+
+            AddStep("change dot dimensions", () =>
+            {
+                display.DotSize = new Vector2(8, 12);
+                display.DotSpacing = 2;
+            });
+            AddStep("change dot dimensions back", () =>
+            {
+                display.DotSize = new Vector2(4, 8);
+                display.DotSpacing = 1;
+            });
+        }
+
+        private void createDisplay(IBeatmapSetInfo beatmapSetInfo) => AddStep("create spectrum display", () => Child = display = new DifficultySpectrumDisplay(beatmapSetInfo)
         {
             Anchor = Anchor.Centre,
             Origin = Anchor.Centre,
diff --git a/osu.Game/Beatmaps/Drawables/DifficultySpectrumDisplay.cs b/osu.Game/Beatmaps/Drawables/DifficultySpectrumDisplay.cs
index a773f6b12c..1feaa88350 100644
--- a/osu.Game/Beatmaps/Drawables/DifficultySpectrumDisplay.cs
+++ b/osu.Game/Beatmaps/Drawables/DifficultySpectrumDisplay.cs
@@ -18,12 +18,40 @@ namespace osu.Game.Beatmaps.Drawables
 {
     public class DifficultySpectrumDisplay : CompositeDrawable
     {
+        private Vector2 dotSize = new Vector2(4, 8);
+
+        public Vector2 DotSize
+        {
+            get => dotSize;
+            set
+            {
+                dotSize = value;
+
+                if (IsLoaded)
+                    updateDotDimensions();
+            }
+        }
+
+        private float dotSpacing = 1;
+
+        public float DotSpacing
+        {
+            get => dotSpacing;
+            set
+            {
+                dotSpacing = value;
+
+                if (IsLoaded)
+                    updateDotDimensions();
+            }
+        }
+
+        private readonly FillFlowContainer<RulesetDifficultyGroup> flow;
+
         public DifficultySpectrumDisplay(IBeatmapSetInfo beatmapSet)
         {
             AutoSizeAxes = Axes.Both;
 
-            FillFlowContainer<RulesetDifficultyGroup> flow;
-
             InternalChild = flow = new FillFlowContainer<RulesetDifficultyGroup>
             {
                 AutoSizeAxes = Axes.Both,
@@ -40,6 +68,21 @@ namespace osu.Game.Beatmaps.Drawables
             }
         }
 
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+            updateDotDimensions();
+        }
+
+        private void updateDotDimensions()
+        {
+            foreach (var group in flow)
+            {
+                group.DotSize = DotSize;
+                group.DotSpacing = DotSpacing;
+            }
+        }
+
         private class RulesetDifficultyGroup : FillFlowContainer
         {
             private readonly int rulesetId;
@@ -53,6 +96,20 @@ namespace osu.Game.Beatmaps.Drawables
                 this.collapsed = collapsed;
             }
 
+            public Vector2 DotSize
+            {
+                set
+                {
+                    foreach (var dot in Children.OfType<DifficultyDot>())
+                        dot.Size = value;
+                }
+            }
+
+            public float DotSpacing
+            {
+                set => Spacing = new Vector2(value, 0);
+            }
+
             [BackgroundDependencyLoader]
             private void load(RulesetStore rulesets)
             {
@@ -98,8 +155,6 @@ namespace osu.Game.Beatmaps.Drawables
             [BackgroundDependencyLoader]
             private void load(OsuColour colours)
             {
-                Width = 4;
-                Height = 8;
                 Anchor = Origin = Anchor.Centre;
                 Masking = true;
 

From d80a73b63da0c275e0818c3de814db8f5ce38388 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 27 Oct 2021 12:53:02 +0900
Subject: [PATCH 0498/5547] Use explicit primitive types

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

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModNoScope.cs b/osu.Game.Rulesets.Osu/Mods/OsuModNoScope.cs
index 10de06a550..501c0a55bd 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModNoScope.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModNoScope.cs
@@ -82,8 +82,8 @@ namespace osu.Game.Rulesets.Osu.Mods
 
         public virtual void Update(Playfield playfield)
         {
-            var shouldAlwaysShowCursor = isBreakTime.Value || spinnerPeriods.IsInAny(playfield.Clock.CurrentTime);
-            var targetAlpha = shouldAlwaysShowCursor ? 1 : comboBasedAlpha;
+            bool shouldAlwaysShowCursor = isBreakTime.Value || spinnerPeriods.IsInAny(playfield.Clock.CurrentTime);
+            float targetAlpha = shouldAlwaysShowCursor ? 1 : comboBasedAlpha;
             playfield.Cursor.Alpha = (float)Interpolation.Lerp(playfield.Cursor.Alpha, targetAlpha, Math.Clamp(playfield.Time.Elapsed / transition_duration, 0, 1));
         }
     }

From 1d7e97625aa14927701eb3487721fe0c68d26778 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 27 Oct 2021 12:57:43 +0900
Subject: [PATCH 0499/5547] Update `var` usage inspections to disallow for
 built-in types

---
 .editorconfig       | 2 +-
 osu.sln.DotSettings | 5 ++++-
 2 files changed, 5 insertions(+), 2 deletions(-)

diff --git a/.editorconfig b/.editorconfig
index 3c4997c88d..be5652954b 100644
--- a/.editorconfig
+++ b/.editorconfig
@@ -113,7 +113,7 @@ dotnet_style_qualification_for_event = false:warning
 dotnet_style_predefined_type_for_locals_parameters_members = true:warning
 dotnet_style_predefined_type_for_member_access = true:warning
 csharp_style_var_when_type_is_apparent = true:none
-csharp_style_var_for_built_in_types = true:none
+csharp_style_var_for_built_in_types = false:warning
 csharp_style_var_elsewhere = true:silent
 
 #Style - modifiers
diff --git a/osu.sln.DotSettings b/osu.sln.DotSettings
index 3af986543e..f35bdfce66 100644
--- a/osu.sln.DotSettings
+++ b/osu.sln.DotSettings
@@ -207,7 +207,7 @@
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=StringLiteralTypo/@EntryIndexedValue">HINT</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=StringStartsWithIsCultureSpecific/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=StructCanBeMadeReadOnly/@EntryIndexedValue">WARNING</s:String>
-	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=SuggestVarOrType_005FBuiltInTypes/@EntryIndexedValue">DO_NOT_SHOW</s:String>
+	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=SuggestVarOrType_005FBuiltInTypes/@EntryIndexedValue">SUGGESTION</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=SuggestVarOrType_005FSimpleTypes/@EntryIndexedValue">DO_NOT_SHOW</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=SwitchStatementMissingSomeCases/@EntryIndexedValue">DO_NOT_SHOW</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=TabsAndSpacesMismatch/@EntryIndexedValue">WARNING</s:String>
@@ -301,6 +301,9 @@
 	<s:Boolean x:Key="/Default/CodeStyle/CodeFormatting/CSharpFormat/WRAP_BEFORE_BINARY_OPSIGN/@EntryValue">True</s:Boolean>
 	<s:Int64 x:Key="/Default/CodeStyle/CodeFormatting/CSharpFormat/WRAP_LIMIT/@EntryValue">200</s:Int64>
 	<s:String x:Key="/Default/CodeStyle/CodeFormatting/CSharpFormat/WRAP_OBJECT_AND_COLLECTION_INITIALIZER_STYLE/@EntryValue">CHOP_IF_LONG</s:String>
+	<s:String x:Key="/Default/CodeStyle/CSharpVarKeywordUsage/ForBuiltInTypes/@EntryValue">UseExplicitType</s:String>
+	<s:String x:Key="/Default/CodeStyle/CSharpVarKeywordUsage/ForOtherTypes/@EntryValue">UseVarWhenEvident</s:String>
+	<s:String x:Key="/Default/CodeStyle/CSharpVarKeywordUsage/ForSimpleTypes/@EntryValue">UseVarWhenEvident</s:String>
 	<s:Boolean x:Key="/Default/CodeStyle/EncapsulateField/MakeFieldPrivate/@EntryValue">False</s:Boolean>
 	<s:Boolean x:Key="/Default/CodeStyle/EncapsulateField/UseAutoProperty/@EntryValue">False</s:Boolean>
 	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/Abbreviations/=AABB/@EntryIndexedValue">AABB</s:String>

From 6944151486e677bfd11f2390163aca9161defbbf Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 27 Oct 2021 13:04:41 +0900
Subject: [PATCH 0500/5547] Apply batch fixing of built-in types using `var`

---
 osu.Desktop/OsuGameDesktop.cs                 |   4 +-
 osu.Desktop/Program.cs                        |  12 +--
 .../TestSceneJuiceStreamSelectionBlueprint.cs |   2 +-
 .../TestSceneCatcher.cs                       |   4 +-
 .../TestSceneDrawableHitObjects.cs            |   2 +-
 .../Preprocessing/CatchDifficultyHitObject.cs |   2 +-
 .../Mods/CatchModHidden.cs                    |   4 +-
 .../Replays/CatchFramedReplayInputHandler.cs  |   2 +-
 .../Legacy/CatchLegacySkinTransformer.cs      |   2 +-
 osu.Game.Rulesets.Catch/UI/Catcher.cs         |   6 +-
 .../ManiaPlacementBlueprintTestScene.cs       |   2 +-
 .../ManiaBeatmapConversionTest.cs             |   2 +-
 .../ManiaColumnTypeTest.cs                    |   2 +-
 .../Beatmaps/ManiaBeatmapConverter.cs         |   6 +-
 .../Legacy/DistanceObjectPatternGenerator.cs  |   2 +-
 .../Legacy/HitObjectPatternGenerator.cs       |   2 +-
 .../Difficulty/Skills/Strain.cs               |   4 +-
 osu.Game.Rulesets.Mania/ManiaRuleset.cs       |   2 +-
 .../MathUtils/LegacySortHelper.cs             |   2 +-
 .../Mods/ManiaModMirror.cs                    |   2 +-
 .../Mods/ManiaModRandom.cs                    |   2 +-
 .../Objects/Drawables/DrawableHoldNoteTick.cs |   2 +-
 .../Replays/ManiaAutoGenerator.cs             |   2 +-
 .../Legacy/ManiaLegacySkinTransformer.cs      |   2 +-
 .../TestSceneHitCircleArea.cs                 |   2 +-
 .../TestSceneSpinnerRotation.cs               |   2 +-
 .../Preprocessing/OsuDifficultyHitObject.cs   |   2 +-
 .../Difficulty/Skills/Aim.cs                  |   2 +-
 .../Components/PathControlPointPiece.cs       |   4 +-
 .../Edit/Checks/CheckLowDiffOverlaps.cs       |   8 +-
 .../Edit/Checks/CheckTimeDistanceEquality.cs  |   8 +-
 .../Edit/OsuRectangularPositionSnapGrid.cs    |   2 +-
 osu.Game.Rulesets.Osu/Mods/OsuModBlinds.cs    |   2 +-
 osu.Game.Rulesets.Osu/Mods/OsuModHidden.cs    |   8 +-
 osu.Game.Rulesets.Osu/Mods/OsuModRandom.cs    |   8 +-
 osu.Game.Rulesets.Osu/Mods/OsuModSpunOut.cs   |   2 +-
 osu.Game.Rulesets.Osu/Mods/OsuModTarget.cs    |  28 ++---
 .../Connections/FollowPointConnection.cs      |   2 +-
 .../Connections/FollowPointLifetimeEntry.cs   |   2 +-
 .../Connections/FollowPointRenderer.cs        |   2 +-
 .../Skinning/Default/SnakingSliderBody.cs     |   8 +-
 .../Default/SpinnerRotationTracker.cs         |   4 +-
 .../Skinning/Legacy/LegacyMainCirclePiece.cs  |   2 +-
 .../Skinning/Legacy/LegacyOldStyleSpinner.cs  |   2 +-
 .../Statistics/AccuracyHeatmap.cs             |   2 +-
 .../Utils/OsuHitObjectGenerationUtils.cs      |  10 +-
 .../TestSceneSampleOutput.cs                  |   2 +-
 .../Beatmaps/TaikoBeatmapConverter.cs         |   2 +-
 .../Objects/Drawables/DrawableHit.cs          |   4 +-
 .../Objects/Drawables/DrawableSwell.cs        |   6 +-
 .../Legacy/TaikoLegacySkinTransformer.cs      |   6 +-
 .../UI/DrumRollHitContainer.cs                |   2 +-
 .../UI/TaikoMascotAnimation.cs                |   2 +-
 .../Beatmaps/Formats/LegacyDecoderTest.cs     |   2 +-
 .../Beatmaps/IO/ImportBeatmapTest.cs          |  30 +++---
 .../Beatmaps/IO/LineBufferedReaderTest.cs     |   2 +-
 .../Beatmaps/IO/OszArchiveReaderTest.cs       |   4 +-
 .../Database/BeatmapImporterTests.cs          |  26 ++---
 .../NonVisual/BarLineGeneratorTest.cs         |   2 +-
 .../NonVisual/CustomDataDirectoryTest.cs      |   6 +-
 .../NonVisual/FramedReplayInputHandlerTest.cs |   2 +-
 .../NonVisual/LimitedCapacityQueueTest.cs     |   6 +-
 .../StatefulMultiplayerClientTest.cs          |   2 +-
 osu.Game.Tests/NonVisual/ReverseQueueTest.cs  |   6 +-
 ...TestMultiplayerMessagePackSerialization.cs |   8 +-
 osu.Game.Tests/Resources/TestResources.cs     |   4 +-
 .../Editing/TestSceneBeatDivisorControl.cs    |   2 +-
 .../Editing/TestSceneEditorBeatmapCreation.cs |   2 +-
 .../Gameplay/TestSceneGameplayMenuOverlay.cs  |   2 +-
 .../TestSceneMultiSpectatorLeaderboard.cs     |   4 +-
 .../TestSceneMultiSpectatorScreen.cs          |   4 +-
 .../Multiplayer/TestSceneMultiplayer.cs       |   2 +-
 ...TestSceneMultiplayerGameplayLeaderboard.cs |   6 +-
 ...ceneMultiplayerGameplayLeaderboardTeams.cs |   2 +-
 .../TestSceneMultiplayerParticipantsList.cs   |   2 +-
 .../Visual/Online/TestSceneChatOverlay.cs     |   4 +-
 .../Visual/Online/TestSceneRankGraph.cs       |   8 +-
 .../Online/TestSceneStandAloneChatDisplay.cs  |   2 +-
 .../Visual/Online/TestSceneWikiHeader.cs      |   2 +-
 .../Visual/Online/TestSceneWikiSidebar.cs     |   4 +-
 .../TestSceneBreadcrumbControlHeader.cs       |   8 +-
 .../TestSceneFooterButtonMods.cs              |   4 +-
 .../Visual/UserInterface/TestSceneOsuIcon.cs  |   2 +-
 osu.Game.Tournament/Components/SongBar.cs     |  10 +-
 osu.Game.Tournament/IPC/FileBasedIPC.cs       |  14 +--
 osu.Game.Tournament/JsonPointConverter.cs     |   2 +-
 osu.Game.Tournament/Models/TournamentTeam.cs  |   8 +-
 .../Components/TournamentMatchScoreDisplay.cs |   2 +-
 .../Components/DrawableTournamentMatch.cs     |   6 +-
 .../Screens/Ladder/LadderDragContainer.cs     |   2 +-
 .../Screens/Setup/ResolutionSelector.cs       |   2 +-
 .../Screens/Setup/StablePathSelectScreen.cs   |   4 +-
 osu.Game.Tournament/TournamentGame.cs         |   2 +-
 osu.Game.Tournament/TournamentGameBase.cs     |   2 +-
 osu.Game/Audio/Effects/AudioFilter.cs         |   2 +-
 osu.Game/Beatmaps/Beatmap.cs                  |   2 +-
 osu.Game/Beatmaps/BeatmapInfoExtensions.cs    |   2 +-
 .../Beatmaps/BeatmapMetadataInfoExtensions.cs |   4 +-
 .../ControlPoints/ControlPointInfo.cs         |   4 +-
 osu.Game/Beatmaps/DifficultyRecommender.cs    |   4 +-
 .../Beatmaps/Formats/LegacyBeatmapEncoder.cs  |   2 +-
 osu.Game/Beatmaps/Formats/LegacyDecoder.cs    |   4 +-
 .../Formats/LegacyStoryboardDecoder.cs        | 102 +++++++++---------
 osu.Game/Beatmaps/Formats/Parsing.cs          |   6 +-
 osu.Game/Beatmaps/MetadataUtils.cs            |   2 +-
 osu.Game/Beatmaps/WorkingBeatmapCache.cs      |   2 +-
 osu.Game/Collections/CollectionManager.cs     |   8 +-
 osu.Game/Configuration/OsuConfigManager.cs    |   4 +-
 osu.Game/Database/ArchiveModelManager.cs      |   2 +-
 osu.Game/Database/DatabaseBackedStore.cs      |   2 +-
 osu.Game/Database/RealmContextFactory.cs      |   6 +-
 osu.Game/Database/StableImportManager.cs      |   2 +-
 osu.Game/Database/UserLookupCache.cs          |   2 +-
 osu.Game/Graphics/Backgrounds/Triangles.cs    |   2 +-
 .../Containers/ConstrainedIconContainer.cs    |   2 +-
 .../Containers/LogoTrackingContainer.cs       |   2 +-
 .../Graphics/Containers/SectionsContainer.cs  |   4 +-
 .../SelectionCycleFillFlowContainer.cs        |   2 +-
 osu.Game/Graphics/Cursor/MenuCursor.cs        |   2 +-
 osu.Game/Graphics/ErrorTextFlowContainer.cs   |   2 +-
 osu.Game/Graphics/ParticleExplosion.cs        |   4 +-
 osu.Game/Graphics/ParticleSpewer.cs           |  14 +--
 osu.Game/Graphics/ScreenshotManager.cs        |   6 +-
 .../UserInterface/BreadcrumbControl.cs        |   4 +-
 .../Graphics/UserInterface/OsuSliderBar.cs    |   4 +-
 .../Graphics/UserInterface/StarCounter.cs     |   4 +-
 .../Graphics/UserInterface/TwoLayerButton.cs  |   2 +-
 osu.Game/IO/LineBufferedReader.cs             |   4 +-
 .../Converters/TypedListConverter.cs          |   4 +-
 osu.Game/IO/StableStorage.cs                  |   4 +-
 osu.Game/IO/WrappedStorage.cs                 |   2 +-
 .../Bindings/DatabasedKeyBindingContainer.cs  |   2 +-
 osu.Game/Input/RealmKeyBindingStore.cs        |   2 +-
 .../ResourceManagerLocalisationStore.cs       |   2 +-
 osu.Game/Online/API/APIDownloadRequest.cs     |   2 +-
 osu.Game/Online/Chat/Channel.cs               |   4 +-
 osu.Game/Online/Chat/ChannelManager.cs        |   4 +-
 osu.Game/Online/Chat/MessageFormatter.cs      |  22 ++--
 osu.Game/Online/Chat/NowPlayingCommand.cs     |   2 +-
 osu.Game/Online/Chat/StandAloneChatDisplay.cs |   2 +-
 osu.Game/Online/Leaderboards/Leaderboard.cs   |   8 +-
 .../Rooms/IndexPlaylistScoresRequest.cs       |   2 +-
 osu.Game/Online/Spectator/SpectatorClient.cs  |   2 +-
 osu.Game/OsuGame.cs                           |  10 +-
 .../BeatmapSet/BeatmapRulesetTabItem.cs       |   2 +-
 osu.Game/Overlays/BeatmapSet/Info.cs          |   2 +-
 .../Scores/ScoreTableRowBackground.cs         |   2 +-
 osu.Game/Overlays/BeatmapSet/SuccessRate.cs   |   2 +-
 osu.Game/Overlays/ChatOverlay.cs              |   2 +-
 .../Comments/CommentMarkdownContainer.cs      |   2 +-
 osu.Game/Overlays/Comments/DrawableComment.cs |   4 +-
 osu.Game/Overlays/Comments/VotePill.cs        |   2 +-
 .../Dashboard/CurrentlyPlayingDisplay.cs      |   4 +-
 .../Friends/FriendOnlineStreamControl.cs      |   4 +-
 osu.Game/Overlays/HoldToConfirmOverlay.cs     |   2 +-
 osu.Game/Overlays/Mods/ModSection.cs          |   4 +-
 osu.Game/Overlays/MusicController.cs          |   6 +-
 osu.Game/Overlays/News/Sidebar/NewsSidebar.cs |   4 +-
 osu.Game/Overlays/News/Sidebar/YearsPanel.cs  |   4 +-
 .../Header/Components/PreviousUsernames.cs    |   2 +-
 .../Profile/Header/Components/RankGraph.cs    |   2 +-
 .../Profile/Header/MedalHeaderContainer.cs    |   2 +-
 .../Sections/Historical/ProfileLineChart.cs   |  18 ++--
 .../Sections/Audio/AudioDevicesSettings.cs    |   2 +-
 .../Sections/Input/KeyBindingsSubsection.cs   |   2 +-
 .../Settings/Sections/Input/MouseSettings.cs  |   4 +-
 .../Sections/Input/RotationPresetButtons.cs   |   2 +-
 .../Sections/Input/RulesetBindingsSection.cs  |   2 +-
 .../Overlays/Settings/Sections/SkinSection.cs |   2 +-
 .../Overlays/Settings/SettingsNumberBox.cs    |   2 +-
 osu.Game/Overlays/TabControlOverlayHeader.cs  |   2 +-
 osu.Game/Overlays/Toolbar/ToolbarButton.cs    |   2 +-
 osu.Game/Overlays/Volume/VolumeMeter.cs       |   2 +-
 .../Wiki/Markdown/WikiNoticeContainer.cs      |   2 +-
 osu.Game/Overlays/Wiki/WikiMainPage.cs        |   4 +-
 osu.Game/Overlays/WikiOverlay.cs              |   2 +-
 .../Difficulty/DifficultyCalculator.cs        |   4 +-
 .../Rulesets/Edit/Checks/CheckAudioInVideo.cs |   2 +-
 .../Rulesets/Edit/Checks/CheckAudioQuality.cs |   2 +-
 .../Edit/Checks/CheckBackgroundQuality.cs     |   2 +-
 .../Rulesets/Edit/Checks/CheckFewHitsounds.cs |   6 +-
 .../Rulesets/Edit/Checks/CheckFilePresence.cs |   4 +-
 osu.Game/Rulesets/Edit/HitObjectComposer.cs   |   4 +-
 osu.Game/Rulesets/Mods/ModBarrelRoll.cs       |   4 +-
 osu.Game/Rulesets/Objects/BarLineGenerator.cs |   2 +-
 .../Objects/Drawables/DrawableHitObject.cs    |   2 +-
 .../Objects/Legacy/ConvertHitObjectParser.cs  |   2 +-
 .../Rulesets/Objects/SliderEventGenerator.cs  |  16 +--
 .../Rulesets/Objects/SliderPathExtensions.cs  |   2 +-
 osu.Game/Rulesets/RulesetInfo.cs              |   2 +-
 osu.Game/Rulesets/RulesetStore.cs             |   6 +-
 osu.Game/Rulesets/Scoring/HitWindows.cs       |   2 +-
 .../Algorithms/ConstantScrollAlgorithm.cs     |   2 +-
 .../Algorithms/SequentialScrollAlgorithm.cs   |   4 +-
 osu.Game/Scoring/Legacy/LegacyScoreDecoder.cs |  16 +--
 osu.Game/Scoring/Legacy/LegacyScoreEncoder.cs |   2 +-
 .../Scoring/Legacy/ScoreInfoExtensions.cs     |   2 +-
 osu.Game/Scoring/LegacyDatabasedScore.cs      |   2 +-
 osu.Game/Scoring/ScoreManager.cs              |   2 +-
 osu.Game/Screens/Edit/BindableBeatDivisor.cs  |   2 +-
 .../Compose/Components/BeatDivisorControl.cs  |   4 +-
 .../Compose/Components/BlueprintContainer.cs  |   6 +-
 .../Compose/Components/DistanceSnapGrid.cs    |   4 +-
 .../Components/EditorSelectionHandler.cs      |   4 +-
 .../Timeline/TimelineBlueprintContainer.cs    |   2 +-
 .../Timeline/TimelineHitObjectBlueprint.cs    |   8 +-
 .../Timeline/TimelineTickDisplay.cs           |   6 +-
 osu.Game/Screens/Edit/Editor.cs               |   2 +-
 osu.Game/Screens/Edit/EditorBeatmap.cs        |   4 +-
 osu.Game/Screens/Edit/EditorChangeHandler.cs  |   2 +-
 .../Edit/LegacyEditorBeatmapPatcher.cs        |   2 +-
 osu.Game/Screens/Edit/Timing/GroupSection.cs  |   2 +-
 osu.Game/Screens/Menu/IntroScreen.cs          |   2 +-
 osu.Game/Screens/Menu/OsuLogo.cs              |   4 +-
 .../Components/OnlinePlayBackgroundScreen.cs  |   2 +-
 .../Participants/ParticipantPanel.cs          |   2 +-
 .../Spectate/MultiSpectatorScreen.cs          |  10 +-
 osu.Game/Screens/Play/Break/BreakInfoLine.cs  |   2 +-
 osu.Game/Screens/Play/BreakTracker.cs         |   2 +-
 osu.Game/Screens/Play/HUD/FailingLayer.cs     |   2 +-
 .../HUD/HitErrorMeters/BarHitErrorMeter.cs    |   6 +-
 .../Screens/Play/HUD/MatchScoreDisplay.cs     |   2 +-
 .../HUD/MultiplayerGameplayLeaderboard.cs     |   2 +-
 osu.Game/Screens/Play/SongProgressGraph.cs    |   8 +-
 osu.Game/Screens/Play/SongProgressInfo.cs     |   2 +-
 osu.Game/Screens/Play/SquareGraph.cs          |   2 +-
 osu.Game/Screens/Play/SubmittingPlayer.cs     |   2 +-
 .../Expanded/ExpandedPanelMiddleContent.cs    |   4 +-
 osu.Game/Screens/Ranking/ResultsScreen.cs     |   2 +-
 .../Ranking/Statistics/UnstableRate.cs        |   8 +-
 osu.Game/Screens/Select/BeatmapDetails.cs     |   2 +-
 .../Select/Carousel/CarouselBeatmap.cs        |   6 +-
 .../Select/Carousel/CarouselBeatmapSet.cs     |   4 +-
 .../Carousel/DrawableCarouselBeatmapSet.cs    |   2 +-
 .../Screens/Select/Details/FailRetryGraph.cs  |   8 +-
 .../Screens/Select/Details/UserRatings.cs     |   4 +-
 osu.Game/Screens/Select/FilterControl.cs      |   2 +-
 osu.Game/Screens/Select/FilterQueryParser.cs  |   8 +-
 osu.Game/Screens/Spectate/SpectatorScreen.cs  |  14 +--
 osu.Game/Skinning/DefaultSkin.cs              |   2 +-
 .../Skinning/Editor/SkinBlueprintContainer.cs |   2 +-
 osu.Game/Skinning/LegacyManiaSkinDecoder.cs   |   2 +-
 osu.Game/Skinning/LegacySkin.cs               |  10 +-
 osu.Game/Skinning/LegacySkinDecoder.cs        |   2 +-
 osu.Game/Skinning/LegacySkinResourceStore.cs  |   4 +-
 osu.Game/Skinning/LegacySpriteText.cs         |   2 +-
 osu.Game/Skinning/ResourceStoreBackedSkin.cs  |   2 +-
 osu.Game/Skinning/Skin.cs                     |   2 +-
 osu.Game/Stores/BeatmapImporter.cs            |   2 +-
 osu.Game/Stores/RealmArchiveModelImporter.cs  |   2 +-
 osu.Game/Stores/RealmRulesetStore.cs          |   6 +-
 osu.Game/Storyboards/CommandLoop.cs           |   4 +-
 osu.Game/Storyboards/CommandTimeline.cs       |   2 +-
 osu.Game/Storyboards/CommandTimelineGroup.cs  |   2 +-
 .../Drawables/DrawableStoryboardVideo.cs      |   2 +-
 osu.Game/Storyboards/Storyboard.cs            |   4 +-
 .../Tests/Beatmaps/BeatmapConversionTest.cs   |   4 +-
 .../Beatmaps/DifficultyCalculatorTest.cs      |   2 +-
 .../Visual/DependencyProvidingContainer.cs    |   2 +-
 osu.Game/Tests/Visual/SkinnableTestScene.cs   |   4 +-
 osu.Game/Updater/SimpleUpdateManager.cs       |   2 +-
 osu.Game/Updater/UpdateManager.cs             |   4 +-
 osu.Game/Utils/StatelessRNG.cs                |   2 +-
 263 files changed, 572 insertions(+), 572 deletions(-)

diff --git a/osu.Desktop/OsuGameDesktop.cs b/osu.Desktop/OsuGameDesktop.cs
index 4de1e84fbf..19e1252a4d 100644
--- a/osu.Desktop/OsuGameDesktop.cs
+++ b/osu.Desktop/OsuGameDesktop.cs
@@ -156,7 +156,7 @@ namespace osu.Desktop
         {
             lock (importableFiles)
             {
-                var firstExtension = Path.GetExtension(filePaths.First());
+                string firstExtension = Path.GetExtension(filePaths.First());
 
                 if (filePaths.Any(f => Path.GetExtension(f) != firstExtension)) return;
 
@@ -177,7 +177,7 @@ namespace osu.Desktop
             {
                 Logger.Log($"Handling batch import of {importableFiles.Count} files");
 
-                var paths = importableFiles.ToArray();
+                string[] paths = importableFiles.ToArray();
                 importableFiles.Clear();
 
                 Task.Factory.StartNew(() => Import(paths), TaskCreationOptions.LongRunning);
diff --git a/osu.Desktop/Program.cs b/osu.Desktop/Program.cs
index 8ccd23b418..898f7d5105 100644
--- a/osu.Desktop/Program.cs
+++ b/osu.Desktop/Program.cs
@@ -22,17 +22,17 @@ namespace osu.Desktop
         public static int Main(string[] args)
         {
             // Back up the cwd before DesktopGameHost changes it
-            var cwd = Environment.CurrentDirectory;
+            string cwd = Environment.CurrentDirectory;
 
             string gameName = base_game_name;
             bool tournamentClient = false;
 
-            foreach (var arg in args)
+            foreach (string arg in args)
             {
-                var split = arg.Split('=');
+                string[] split = arg.Split('=');
 
-                var key = split[0];
-                var val = split.Length > 1 ? split[1] : string.Empty;
+                string key = split[0];
+                string val = split.Length > 1 ? split[1] : string.Empty;
 
                 switch (key)
                 {
@@ -62,7 +62,7 @@ namespace osu.Desktop
                     {
                         var importer = new ArchiveImportIPCChannel(host);
 
-                        foreach (var file in args)
+                        foreach (string file in args)
                         {
                             Console.WriteLine(@"Importing {0}", file);
                             if (!importer.ImportAsync(Path.GetFullPath(file, cwd)).Wait(3000))
diff --git a/osu.Game.Rulesets.Catch.Tests/Editor/TestSceneJuiceStreamSelectionBlueprint.cs b/osu.Game.Rulesets.Catch.Tests/Editor/TestSceneJuiceStreamSelectionBlueprint.cs
index 155d033dd0..fb77fb1efd 100644
--- a/osu.Game.Rulesets.Catch.Tests/Editor/TestSceneJuiceStreamSelectionBlueprint.cs
+++ b/osu.Game.Rulesets.Catch.Tests/Editor/TestSceneJuiceStreamSelectionBlueprint.cs
@@ -49,7 +49,7 @@ namespace osu.Game.Rulesets.Catch.Tests.Editor
 
             AddAssert("correct outline count", () =>
             {
-                var expected = hitObject.NestedHitObjects.Count(h => !(h is TinyDroplet));
+                int expected = hitObject.NestedHitObjects.Count(h => !(h is TinyDroplet));
                 return this.ChildrenOfType<FruitOutline>().Count() == expected;
             });
             AddAssert("correct vertex piece count", () =>
diff --git a/osu.Game.Rulesets.Catch.Tests/TestSceneCatcher.cs b/osu.Game.Rulesets.Catch.Tests/TestSceneCatcher.cs
index f291bfed13..29a7b03ad3 100644
--- a/osu.Game.Rulesets.Catch.Tests/TestSceneCatcher.cs
+++ b/osu.Game.Rulesets.Catch.Tests/TestSceneCatcher.cs
@@ -103,7 +103,7 @@ namespace osu.Game.Rulesets.Catch.Tests
         [Test]
         public void TestCatcherCatchWidth()
         {
-            var halfWidth = Catcher.CalculateCatchWidth(new BeatmapDifficulty { CircleSize = 0 }) / 2;
+            float halfWidth = Catcher.CalculateCatchWidth(new BeatmapDifficulty { CircleSize = 0 }) / 2;
             AddStep("catch fruit", () =>
             {
                 attemptCatch(new Fruit { X = -halfWidth + 1 });
@@ -237,7 +237,7 @@ namespace osu.Game.Rulesets.Catch.Tests
 
         private void attemptCatch(Func<CatchHitObject> hitObject, int count)
         {
-            for (var i = 0; i < count; i++)
+            for (int i = 0; i < count; i++)
                 attemptCatch(hitObject(), out _, out _);
         }
 
diff --git a/osu.Game.Rulesets.Catch.Tests/TestSceneDrawableHitObjects.cs b/osu.Game.Rulesets.Catch.Tests/TestSceneDrawableHitObjects.cs
index e7c7dc3c98..3c61eb19e5 100644
--- a/osu.Game.Rulesets.Catch.Tests/TestSceneDrawableHitObjects.cs
+++ b/osu.Game.Rulesets.Catch.Tests/TestSceneDrawableHitObjects.cs
@@ -118,7 +118,7 @@ namespace osu.Game.Rulesets.Catch.Tests
 
         private void spawnJuiceStream(bool hit = false)
         {
-            var xCoords = getXCoords(hit);
+            float xCoords = getXCoords(hit);
 
             var juice = new JuiceStream
             {
diff --git a/osu.Game.Rulesets.Catch/Difficulty/Preprocessing/CatchDifficultyHitObject.cs b/osu.Game.Rulesets.Catch/Difficulty/Preprocessing/CatchDifficultyHitObject.cs
index e19098c580..b22ec93b43 100644
--- a/osu.Game.Rulesets.Catch/Difficulty/Preprocessing/CatchDifficultyHitObject.cs
+++ b/osu.Game.Rulesets.Catch/Difficulty/Preprocessing/CatchDifficultyHitObject.cs
@@ -28,7 +28,7 @@ namespace osu.Game.Rulesets.Catch.Difficulty.Preprocessing
             : base(hitObject, lastObject, clockRate)
         {
             // We will scale everything by this factor, so we can assume a uniform CircleSize among beatmaps.
-            var scalingFactor = normalized_hitobject_radius / halfCatcherWidth;
+            float scalingFactor = normalized_hitobject_radius / halfCatcherWidth;
 
             NormalizedPosition = BaseObject.EffectiveX * scalingFactor;
             LastNormalizedPosition = LastObject.EffectiveX * scalingFactor;
diff --git a/osu.Game.Rulesets.Catch/Mods/CatchModHidden.cs b/osu.Game.Rulesets.Catch/Mods/CatchModHidden.cs
index d48edbcd74..4b6f79df88 100644
--- a/osu.Game.Rulesets.Catch/Mods/CatchModHidden.cs
+++ b/osu.Game.Rulesets.Catch/Mods/CatchModHidden.cs
@@ -52,8 +52,8 @@ namespace osu.Game.Rulesets.Catch.Mods
         {
             var hitObject = drawable.HitObject;
 
-            var offset = hitObject.TimePreempt * fade_out_offset_multiplier;
-            var duration = offset - hitObject.TimePreempt * fade_out_duration_multiplier;
+            double offset = hitObject.TimePreempt * fade_out_offset_multiplier;
+            double duration = offset - hitObject.TimePreempt * fade_out_duration_multiplier;
 
             using (drawable.BeginAbsoluteSequence(hitObject.StartTime - offset))
                 drawable.FadeOut(duration);
diff --git a/osu.Game.Rulesets.Catch/Replays/CatchFramedReplayInputHandler.cs b/osu.Game.Rulesets.Catch/Replays/CatchFramedReplayInputHandler.cs
index 137328b1c3..bd742ce6a6 100644
--- a/osu.Game.Rulesets.Catch/Replays/CatchFramedReplayInputHandler.cs
+++ b/osu.Game.Rulesets.Catch/Replays/CatchFramedReplayInputHandler.cs
@@ -21,7 +21,7 @@ namespace osu.Game.Rulesets.Catch.Replays
 
         public override void CollectPendingInputs(List<IInput> inputs)
         {
-            var position = Interpolation.ValueAt(CurrentTime, StartFrame.Position, EndFrame.Position, StartFrame.Time, EndFrame.Time);
+            float position = Interpolation.ValueAt(CurrentTime, StartFrame.Position, EndFrame.Position, StartFrame.Time, EndFrame.Time);
 
             inputs.Add(new CatchReplayState
             {
diff --git a/osu.Game.Rulesets.Catch/Skinning/Legacy/CatchLegacySkinTransformer.cs b/osu.Game.Rulesets.Catch/Skinning/Legacy/CatchLegacySkinTransformer.cs
index 10fc4e78b2..7177a18cc3 100644
--- a/osu.Game.Rulesets.Catch/Skinning/Legacy/CatchLegacySkinTransformer.cs
+++ b/osu.Game.Rulesets.Catch/Skinning/Legacy/CatchLegacySkinTransformer.cs
@@ -66,7 +66,7 @@ namespace osu.Game.Rulesets.Catch.Skinning.Legacy
                         return null;
 
                     case CatchSkinComponents.Catcher:
-                        var version = GetConfig<LegacySkinConfiguration.LegacySetting, decimal>(LegacySkinConfiguration.LegacySetting.Version)?.Value ?? 1;
+                        decimal version = GetConfig<LegacySkinConfiguration.LegacySetting, decimal>(LegacySkinConfiguration.LegacySetting.Version)?.Value ?? 1;
 
                         if (version < 2.3m)
                         {
diff --git a/osu.Game.Rulesets.Catch/UI/Catcher.cs b/osu.Game.Rulesets.Catch/UI/Catcher.cs
index 3745099010..1061bd2fc9 100644
--- a/osu.Game.Rulesets.Catch/UI/Catcher.cs
+++ b/osu.Game.Rulesets.Catch/UI/Catcher.cs
@@ -226,9 +226,9 @@ namespace osu.Game.Rulesets.Catch.UI
             if (result.IsHit && hitObject.HyperDash)
             {
                 var target = hitObject.HyperDashTarget;
-                var timeDifference = target.StartTime - hitObject.StartTime;
+                double timeDifference = target.StartTime - hitObject.StartTime;
                 double positionDifference = target.EffectiveX - X;
-                var velocity = positionDifference / Math.Max(1.0, timeDifference - 1000.0 / 60.0);
+                double velocity = positionDifference / Math.Max(1.0, timeDifference - 1000.0 / 60.0);
 
                 SetHyperDashState(Math.Abs(velocity), target.EffectiveX);
             }
@@ -266,7 +266,7 @@ namespace osu.Game.Rulesets.Catch.UI
         /// <param name="targetPosition">When this catcher crosses this position, this catcher ends hyper-dashing.</param>
         public void SetHyperDashState(double modifier = 1, float targetPosition = -1)
         {
-            var wasHyperDashing = HyperDashing;
+            bool wasHyperDashing = HyperDashing;
 
             if (modifier <= 1 || X == targetPosition)
             {
diff --git a/osu.Game.Rulesets.Mania.Tests/Editor/ManiaPlacementBlueprintTestScene.cs b/osu.Game.Rulesets.Mania.Tests/Editor/ManiaPlacementBlueprintTestScene.cs
index ece523e84c..94f385bbf1 100644
--- a/osu.Game.Rulesets.Mania.Tests/Editor/ManiaPlacementBlueprintTestScene.cs
+++ b/osu.Game.Rulesets.Mania.Tests/Editor/ManiaPlacementBlueprintTestScene.cs
@@ -43,7 +43,7 @@ namespace osu.Game.Rulesets.Mania.Tests.Editor
 
         protected override SnapResult SnapForBlueprint(PlacementBlueprint blueprint)
         {
-            var time = column.TimeAtScreenSpacePosition(InputManager.CurrentState.Mouse.Position);
+            double time = column.TimeAtScreenSpacePosition(InputManager.CurrentState.Mouse.Position);
             var pos = column.ScreenSpacePositionAtTime(time);
 
             return new SnapResult(pos, time, column);
diff --git a/osu.Game.Rulesets.Mania.Tests/ManiaBeatmapConversionTest.cs b/osu.Game.Rulesets.Mania.Tests/ManiaBeatmapConversionTest.cs
index 3d4bc4748b..948f088b4e 100644
--- a/osu.Game.Rulesets.Mania.Tests/ManiaBeatmapConversionTest.cs
+++ b/osu.Game.Rulesets.Mania.Tests/ManiaBeatmapConversionTest.cs
@@ -111,7 +111,7 @@ namespace osu.Game.Rulesets.Mania.Tests
 
         public int CompareTo(ConvertValue other)
         {
-            var result = StartTime.CompareTo(other.StartTime);
+            int result = StartTime.CompareTo(other.StartTime);
 
             if (result != 0)
                 return result;
diff --git a/osu.Game.Rulesets.Mania.Tests/ManiaColumnTypeTest.cs b/osu.Game.Rulesets.Mania.Tests/ManiaColumnTypeTest.cs
index 40a6e1fdae..66fe6d8cc5 100644
--- a/osu.Game.Rulesets.Mania.Tests/ManiaColumnTypeTest.cs
+++ b/osu.Game.Rulesets.Mania.Tests/ManiaColumnTypeTest.cs
@@ -43,7 +43,7 @@ namespace osu.Game.Rulesets.Mania.Tests
 
         private IEnumerable<ColumnType> getResults(StageDefinition definition)
         {
-            for (var i = 0; i < definition.Columns; i++)
+            for (int i = 0; i < definition.Columns; i++)
                 yield return definition.GetTypeOfColumn(i);
         }
     }
diff --git a/osu.Game.Rulesets.Mania/Beatmaps/ManiaBeatmapConverter.cs b/osu.Game.Rulesets.Mania/Beatmaps/ManiaBeatmapConverter.cs
index ebfbaccd31..9d0aaec2ba 100644
--- a/osu.Game.Rulesets.Mania/Beatmaps/ManiaBeatmapConverter.cs
+++ b/osu.Game.Rulesets.Mania/Beatmaps/ManiaBeatmapConverter.cs
@@ -42,8 +42,8 @@ namespace osu.Game.Rulesets.Mania.Beatmaps
         {
             IsForCurrentRuleset = beatmap.BeatmapInfo.Ruleset.Equals(ruleset.RulesetInfo);
 
-            var roundedCircleSize = Math.Round(beatmap.Difficulty.CircleSize);
-            var roundedOverallDifficulty = Math.Round(beatmap.Difficulty.OverallDifficulty);
+            double roundedCircleSize = Math.Round(beatmap.Difficulty.CircleSize);
+            double roundedOverallDifficulty = Math.Round(beatmap.Difficulty.OverallDifficulty);
 
             if (IsForCurrentRuleset)
             {
@@ -73,7 +73,7 @@ namespace osu.Game.Rulesets.Mania.Beatmaps
 
         public static int GetColumnCountForNonConvert(BeatmapInfo beatmapInfo)
         {
-            var roundedCircleSize = Math.Round(beatmapInfo.BaseDifficulty.CircleSize);
+            double roundedCircleSize = Math.Round(beatmapInfo.BaseDifficulty.CircleSize);
             return (int)Math.Max(1, roundedCircleSize);
         }
 
diff --git a/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Legacy/DistanceObjectPatternGenerator.cs b/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Legacy/DistanceObjectPatternGenerator.cs
index 1ed045f7e0..77538cc2ac 100644
--- a/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Legacy/DistanceObjectPatternGenerator.cs
+++ b/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Legacy/DistanceObjectPatternGenerator.cs
@@ -493,7 +493,7 @@ namespace osu.Game.Rulesets.Mania.Beatmaps.Patterns.Legacy
             if (!(HitObject is IHasPathWithRepeats curveData))
                 return null;
 
-            var index = SegmentDuration == 0 ? 0 : (time - StartTime) / SegmentDuration;
+            int index = SegmentDuration == 0 ? 0 : (time - StartTime) / SegmentDuration;
 
             // avoid slicing the list & creating copies, if at all possible.
             return index == 0 ? curveData.NodeSamples : curveData.NodeSamples.Skip(index).ToList();
diff --git a/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Legacy/HitObjectPatternGenerator.cs b/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Legacy/HitObjectPatternGenerator.cs
index 54c37e9742..53b059b4e2 100644
--- a/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Legacy/HitObjectPatternGenerator.cs
+++ b/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Legacy/HitObjectPatternGenerator.cs
@@ -302,7 +302,7 @@ namespace osu.Game.Rulesets.Mania.Beatmaps.Patterns.Legacy
 
             var pattern = new Pattern();
 
-            int noteCount = getRandomNoteCountMirrored(centreProbability, p2, p3, out var addToCentre);
+            int noteCount = getRandomNoteCountMirrored(centreProbability, p2, p3, out bool addToCentre);
 
             int columnLimit = (TotalColumns % 2 == 0 ? TotalColumns : TotalColumns - 1) / 2;
             int nextColumn = GetRandomColumn(upperBound: columnLimit);
diff --git a/osu.Game.Rulesets.Mania/Difficulty/Skills/Strain.cs b/osu.Game.Rulesets.Mania/Difficulty/Skills/Strain.cs
index 01d930d585..ab6bd78ece 100644
--- a/osu.Game.Rulesets.Mania/Difficulty/Skills/Strain.cs
+++ b/osu.Game.Rulesets.Mania/Difficulty/Skills/Strain.cs
@@ -35,8 +35,8 @@ namespace osu.Game.Rulesets.Mania.Difficulty.Skills
         protected override double StrainValueOf(DifficultyHitObject current)
         {
             var maniaCurrent = (ManiaDifficultyHitObject)current;
-            var endTime = maniaCurrent.EndTime;
-            var column = maniaCurrent.BaseObject.Column;
+            double endTime = maniaCurrent.EndTime;
+            int column = maniaCurrent.BaseObject.Column;
 
             double holdFactor = 1.0; // Factor to all additional strains in case something else is held
             double holdAddition = 0; // Addition to the current note in case it's a hold and has to be released awkwardly
diff --git a/osu.Game.Rulesets.Mania/ManiaRuleset.cs b/osu.Game.Rulesets.Mania/ManiaRuleset.cs
index 1f79dae280..a9b16c61d4 100644
--- a/osu.Game.Rulesets.Mania/ManiaRuleset.cs
+++ b/osu.Game.Rulesets.Mania/ManiaRuleset.cs
@@ -316,7 +316,7 @@ namespace osu.Game.Rulesets.Mania
 
                 case PlayfieldType.Dual:
                 {
-                    var keys = getDualStageKeyCount(variant);
+                    int keys = getDualStageKeyCount(variant);
                     return $"{keys}K + {keys}K";
                 }
             }
diff --git a/osu.Game.Rulesets.Mania/MathUtils/LegacySortHelper.cs b/osu.Game.Rulesets.Mania/MathUtils/LegacySortHelper.cs
index 0f4829028f..a0e2958bae 100644
--- a/osu.Game.Rulesets.Mania/MathUtils/LegacySortHelper.cs
+++ b/osu.Game.Rulesets.Mania/MathUtils/LegacySortHelper.cs
@@ -122,7 +122,7 @@ namespace osu.Game.Rulesets.Mania.MathUtils
 
             while (i <= n / 2)
             {
-                var child = 2 * i;
+                int child = 2 * i;
 
                 if (child < n && comparer.Compare(keys[lo + child - 1], keys[lo + child]) < 0)
                 {
diff --git a/osu.Game.Rulesets.Mania/Mods/ManiaModMirror.cs b/osu.Game.Rulesets.Mania/Mods/ManiaModMirror.cs
index f01884c97f..9c3744ea98 100644
--- a/osu.Game.Rulesets.Mania/Mods/ManiaModMirror.cs
+++ b/osu.Game.Rulesets.Mania/Mods/ManiaModMirror.cs
@@ -16,7 +16,7 @@ namespace osu.Game.Rulesets.Mania.Mods
 
         public void ApplyToBeatmap(IBeatmap beatmap)
         {
-            var availableColumns = ((ManiaBeatmap)beatmap).TotalColumns;
+            int availableColumns = ((ManiaBeatmap)beatmap).TotalColumns;
 
             beatmap.HitObjects.OfType<ManiaHitObject>().ForEach(h => h.Column = availableColumns - 1 - h.Column);
         }
diff --git a/osu.Game.Rulesets.Mania/Mods/ManiaModRandom.cs b/osu.Game.Rulesets.Mania/Mods/ManiaModRandom.cs
index 6f2d4fe91e..f5d1a34d73 100644
--- a/osu.Game.Rulesets.Mania/Mods/ManiaModRandom.cs
+++ b/osu.Game.Rulesets.Mania/Mods/ManiaModRandom.cs
@@ -21,7 +21,7 @@ namespace osu.Game.Rulesets.Mania.Mods
             Seed.Value ??= RNG.Next();
             var rng = new Random((int)Seed.Value);
 
-            var availableColumns = ((ManiaBeatmap)beatmap).TotalColumns;
+            int availableColumns = ((ManiaBeatmap)beatmap).TotalColumns;
             var shuffledColumns = Enumerable.Range(0, availableColumns).OrderBy(item => rng.Next()).ToList();
 
             beatmap.HitObjects.OfType<ManiaHitObject>().ForEach(h => h.Column = shuffledColumns[h.Column]);
diff --git a/osu.Game.Rulesets.Mania/Objects/Drawables/DrawableHoldNoteTick.cs b/osu.Game.Rulesets.Mania/Objects/Drawables/DrawableHoldNoteTick.cs
index f040dad135..cffa79322e 100644
--- a/osu.Game.Rulesets.Mania/Objects/Drawables/DrawableHoldNoteTick.cs
+++ b/osu.Game.Rulesets.Mania/Objects/Drawables/DrawableHoldNoteTick.cs
@@ -97,7 +97,7 @@ namespace osu.Game.Rulesets.Mania.Objects.Drawables
             if (Time.Current < HitObject.StartTime)
                 return;
 
-            var startTime = holdStartTime?.Invoke();
+            double? startTime = holdStartTime?.Invoke();
 
             if (startTime == null || startTime > HitObject.StartTime)
                 ApplyResult(r => r.Type = r.Judgement.MinResult);
diff --git a/osu.Game.Rulesets.Mania/Replays/ManiaAutoGenerator.cs b/osu.Game.Rulesets.Mania/Replays/ManiaAutoGenerator.cs
index 517b708691..efe144ac03 100644
--- a/osu.Game.Rulesets.Mania/Replays/ManiaAutoGenerator.cs
+++ b/osu.Game.Rulesets.Mania/Replays/ManiaAutoGenerator.cs
@@ -75,7 +75,7 @@ namespace osu.Game.Rulesets.Mania.Replays
             {
                 var currentObject = Beatmap.HitObjects[i];
                 var nextObjectInColumn = GetNextObject(i); // Get the next object that requires pressing the same button
-                var releaseTime = calculateReleaseTime(currentObject, nextObjectInColumn);
+                double releaseTime = calculateReleaseTime(currentObject, nextObjectInColumn);
 
                 yield return new HitPoint { Time = currentObject.StartTime, Column = currentObject.Column };
 
diff --git a/osu.Game.Rulesets.Mania/Skinning/Legacy/ManiaLegacySkinTransformer.cs b/osu.Game.Rulesets.Mania/Skinning/Legacy/ManiaLegacySkinTransformer.cs
index 814a737034..cc3b3f348f 100644
--- a/osu.Game.Rulesets.Mania/Skinning/Legacy/ManiaLegacySkinTransformer.cs
+++ b/osu.Game.Rulesets.Mania/Skinning/Legacy/ManiaLegacySkinTransformer.cs
@@ -66,7 +66,7 @@ namespace osu.Game.Rulesets.Mania.Skinning.Legacy
             isLegacySkin = new Lazy<bool>(() => GetConfig<LegacySkinConfiguration.LegacySetting, decimal>(LegacySkinConfiguration.LegacySetting.Version) != null);
             hasKeyTexture = new Lazy<bool>(() =>
             {
-                var keyImage = this.GetManiaSkinConfig<string>(LegacyManiaSkinConfigurationLookups.KeyImage, 0)?.Value ?? "mania-key1";
+                string keyImage = this.GetManiaSkinConfig<string>(LegacyManiaSkinConfigurationLookups.KeyImage, 0)?.Value ?? "mania-key1";
                 return this.GetAnimation(keyImage, true, true) != null;
             });
         }
diff --git a/osu.Game.Rulesets.Osu.Tests/TestSceneHitCircleArea.cs b/osu.Game.Rulesets.Osu.Tests/TestSceneHitCircleArea.cs
index 575523b168..07bbd6379a 100644
--- a/osu.Game.Rulesets.Osu.Tests/TestSceneHitCircleArea.cs
+++ b/osu.Game.Rulesets.Osu.Tests/TestSceneHitCircleArea.cs
@@ -97,7 +97,7 @@ namespace osu.Game.Rulesets.Osu.Tests
 
         private void scheduleHit() => AddStep("schedule action", () =>
         {
-            var delay = hitCircle.StartTime - hitCircle.HitWindows.WindowFor(HitResult.Great) - Time.Current;
+            double delay = hitCircle.StartTime - hitCircle.HitWindows.WindowFor(HitResult.Great) - Time.Current;
             Scheduler.AddDelayed(() => hitAreaReceptor.OnPressed(new KeyBindingPressEvent<OsuAction>(GetContainingInputManager().CurrentState, OsuAction.LeftButton)), delay);
         });
     }
diff --git a/osu.Game.Rulesets.Osu.Tests/TestSceneSpinnerRotation.cs b/osu.Game.Rulesets.Osu.Tests/TestSceneSpinnerRotation.cs
index 52ab39cfbd..de795241bf 100644
--- a/osu.Game.Rulesets.Osu.Tests/TestSceneSpinnerRotation.cs
+++ b/osu.Game.Rulesets.Osu.Tests/TestSceneSpinnerRotation.cs
@@ -148,7 +148,7 @@ namespace osu.Game.Rulesets.Osu.Tests
             AddAssert("player score matching expected bonus score", () =>
             {
                 // multipled by 2 to nullify the score multiplier. (autoplay mod selected)
-                var totalScore = ((ScoreExposedPlayer)Player).ScoreProcessor.TotalScore.Value * 2;
+                double totalScore = ((ScoreExposedPlayer)Player).ScoreProcessor.TotalScore.Value * 2;
                 return totalScore == (int)(drawableSpinner.Result.RateAdjustedRotation / 360) * new SpinnerTick().CreateJudgement().MaxNumericResult;
             });
 
diff --git a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
index 5e5993aefe..49ac6a7af3 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
@@ -123,7 +123,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
 
             // Skip the head circle
             var scoringTimes = slider.NestedHitObjects.Skip(1).Select(t => t.StartTime);
-            foreach (var time in scoringTimes)
+            foreach (double time in scoringTimes)
                 computeVertex(time);
         }
 
diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
index d8f4aa1229..64ca567a15 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
@@ -44,7 +44,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
                 {
                     const double scale = 90;
 
-                    var angleBonus = Math.Sqrt(
+                    double angleBonus = Math.Sqrt(
                         Math.Max(osuPrevious.JumpDistance - scale, 0)
                         * Math.Pow(Math.Sin(osuCurrent.Angle.Value - angle_bonus_begin), 2)
                         * Math.Max(osuCurrent.JumpDistance - scale, 0));
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 2cc95e1891..b3e0566a98 100644
--- a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointPiece.cs
+++ b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointPiece.cs
@@ -184,7 +184,7 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders.Components
         {
             Vector2[] oldControlPoints = slider.Path.ControlPoints.Select(cp => cp.Position).ToArray();
             var oldPosition = slider.Position;
-            var oldStartTime = slider.StartTime;
+            double oldStartTime = slider.StartTime;
 
             if (ControlPoint == slider.Path.ControlPoints[0])
             {
@@ -205,7 +205,7 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders.Components
 
             if (!slider.Path.HasValidLength)
             {
-                for (var i = 0; i < slider.Path.ControlPoints.Count; i++)
+                for (int i = 0; i < slider.Path.ControlPoints.Count; i++)
                     slider.Path.ControlPoints[i].Position = oldControlPoints[i];
 
                 slider.Position = oldPosition;
diff --git a/osu.Game.Rulesets.Osu/Edit/Checks/CheckLowDiffOverlaps.cs b/osu.Game.Rulesets.Osu/Edit/Checks/CheckLowDiffOverlaps.cs
index 1dd859b5b8..084a3e5ea1 100644
--- a/osu.Game.Rulesets.Osu/Edit/Checks/CheckLowDiffOverlaps.cs
+++ b/osu.Game.Rulesets.Osu/Edit/Checks/CheckLowDiffOverlaps.cs
@@ -47,14 +47,14 @@ namespace osu.Game.Rulesets.Osu.Edit.Checks
                 if (!(hitObjects[i + 1] is OsuHitObject nextHitObject) || nextHitObject is Spinner)
                     continue;
 
-                var deltaTime = nextHitObject.StartTime - hitObject.GetEndTime();
+                double deltaTime = nextHitObject.StartTime - hitObject.GetEndTime();
                 if (deltaTime >= hitObject.TimeFadeIn + hitObject.TimePreempt)
                     // The objects are not visible at the same time (without mods), hence skipping.
                     continue;
 
-                var distanceSq = (hitObject.StackedEndPosition - nextHitObject.StackedPosition).LengthSquared;
-                var diameter = (hitObject.Radius - overlap_leniency) * 2;
-                var diameterSq = diameter * diameter;
+                float distanceSq = (hitObject.StackedEndPosition - nextHitObject.StackedPosition).LengthSquared;
+                double diameter = (hitObject.Radius - overlap_leniency) * 2;
+                double diameterSq = diameter * diameter;
 
                 bool areOverlapping = distanceSq < diameterSq;
 
diff --git a/osu.Game.Rulesets.Osu/Edit/Checks/CheckTimeDistanceEquality.cs b/osu.Game.Rulesets.Osu/Edit/Checks/CheckTimeDistanceEquality.cs
index 6420d9558e..585bd35bd9 100644
--- a/osu.Game.Rulesets.Osu/Edit/Checks/CheckTimeDistanceEquality.cs
+++ b/osu.Game.Rulesets.Osu/Edit/Checks/CheckTimeDistanceEquality.cs
@@ -88,21 +88,21 @@ namespace osu.Game.Rulesets.Osu.Edit.Checks
                 if (!(hitObjects[i + 1] is OsuHitObject nextHitObject) || nextHitObject is Spinner)
                     continue;
 
-                var deltaTime = nextHitObject.StartTime - hitObject.GetEndTime();
+                double deltaTime = nextHitObject.StartTime - hitObject.GetEndTime();
 
                 // Ignore objects that are far enough apart in time to not be considered the same pattern.
                 if (deltaTime > pattern_lifetime)
                     continue;
 
                 // Relying on FastInvSqrt is probably good enough here. We'll be taking the difference between distances later, hence square not being sufficient.
-                var distance = (hitObject.StackedEndPosition - nextHitObject.StackedPosition).LengthFast;
+                float distance = (hitObject.StackedEndPosition - nextHitObject.StackedPosition).LengthFast;
 
                 // Ignore stacks and half-stacks, as these are close enough to where they can't be confused for being time-distanced.
                 if (distance < stack_leniency)
                     continue;
 
                 var observedTimeDistance = new ObservedTimeDistance(nextHitObject.StartTime, deltaTime, distance);
-                var expectedDistance = getExpectedDistance(prevObservedTimeDistances, observedTimeDistance);
+                double expectedDistance = getExpectedDistance(prevObservedTimeDistances, observedTimeDistance);
 
                 if (expectedDistance == 0)
                 {
@@ -125,7 +125,7 @@ namespace osu.Game.Rulesets.Osu.Edit.Checks
 
         private double getExpectedDistance(IEnumerable<ObservedTimeDistance> prevObservedTimeDistances, ObservedTimeDistance observedTimeDistance)
         {
-            var observations = prevObservedTimeDistances.Count();
+            int observations = prevObservedTimeDistances.Count();
 
             int count = 0;
             double sum = 0;
diff --git a/osu.Game.Rulesets.Osu/Edit/OsuRectangularPositionSnapGrid.cs b/osu.Game.Rulesets.Osu/Edit/OsuRectangularPositionSnapGrid.cs
index b8ff92bd37..d1c81b51bc 100644
--- a/osu.Game.Rulesets.Osu/Edit/OsuRectangularPositionSnapGrid.cs
+++ b/osu.Game.Rulesets.Osu/Edit/OsuRectangularPositionSnapGrid.cs
@@ -30,7 +30,7 @@ namespace osu.Game.Rulesets.Osu.Edit
         [BackgroundDependencyLoader]
         private void load()
         {
-            var gridSizeIndex = Array.IndexOf(grid_sizes, editorBeatmap.BeatmapInfo.GridSize);
+            int gridSizeIndex = Array.IndexOf(grid_sizes, editorBeatmap.BeatmapInfo.GridSize);
             if (gridSizeIndex >= 0)
                 currentGridSizeIndex = gridSizeIndex;
             updateSpacing();
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModBlinds.cs b/osu.Game.Rulesets.Osu/Mods/OsuModBlinds.cs
index 3102db270e..ad4c5dfd5d 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModBlinds.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModBlinds.cs
@@ -170,7 +170,7 @@ namespace osu.Game.Rulesets.Osu.Mods
                 base.LoadComplete();
 
                 var firstObj = beatmap.HitObjects[0];
-                var startDelay = firstObj.StartTime - firstObj.TimePreempt;
+                double startDelay = firstObj.StartTime - firstObj.TimePreempt;
 
                 using (BeginAbsoluteSequence(startDelay + break_close_late))
                     leaveBreak();
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModHidden.cs b/osu.Game.Rulesets.Osu/Mods/OsuModHidden.cs
index e162f805a1..d602fe67ee 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModHidden.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModHidden.cs
@@ -155,11 +155,11 @@ namespace osu.Game.Rulesets.Osu.Mods
 
             static (double fadeStartTime, double fadeDuration) getParameters(OsuHitObject hitObject)
             {
-                var fadeOutStartTime = hitObject.StartTime - hitObject.TimePreempt + hitObject.TimeFadeIn;
-                var fadeOutDuration = hitObject.TimePreempt * fade_out_duration_multiplier;
+                double fadeOutStartTime = hitObject.StartTime - hitObject.TimePreempt + hitObject.TimeFadeIn;
+                double fadeOutDuration = hitObject.TimePreempt * fade_out_duration_multiplier;
 
                 // new duration from completed fade in to end (before fading out)
-                var longFadeDuration = hitObject.GetEndTime() - fadeOutStartTime;
+                double longFadeDuration = hitObject.GetEndTime() - fadeOutStartTime;
 
                 switch (hitObject)
                 {
@@ -167,7 +167,7 @@ namespace osu.Game.Rulesets.Osu.Mods
                         return (fadeOutStartTime, longFadeDuration);
 
                     case SliderTick _:
-                        var tickFadeOutDuration = Math.Min(hitObject.TimePreempt - DrawableSliderTick.ANIM_DURATION, 1000);
+                        double tickFadeOutDuration = Math.Min(hitObject.TimePreempt - DrawableSliderTick.ANIM_DURATION, 1000);
                         return (hitObject.StartTime - tickFadeOutDuration, tickFadeOutDuration);
 
                     case Spinner _:
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModRandom.cs b/osu.Game.Rulesets.Osu/Mods/OsuModRandom.cs
index 1a2e5d92b4..9b9ebcad04 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModRandom.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModRandom.cs
@@ -124,7 +124,7 @@ namespace osu.Game.Rulesets.Osu.Mods
             // to allow jumps and prevent too sharp turns during streams.
 
             // Allow maximum jump angle when jump distance is more than half of playfield diagonal length
-            var randomAngleRad = rateOfChangeMultiplier * 2 * Math.PI * Math.Min(1f, distanceToPrev / (playfield_diagonal * 0.5f));
+            double randomAngleRad = rateOfChangeMultiplier * 2 * Math.PI * Math.Min(1f, distanceToPrev / (playfield_diagonal * 0.5f));
 
             current.AngleRad = (float)randomAngleRad + previous.AngleRad;
             if (current.AngleRad < 0)
@@ -171,11 +171,11 @@ namespace osu.Game.Rulesets.Osu.Mods
 
             // Clamp slider position to the placement area
             // If the slider is larger than the playfield, force it to stay at the original position
-            var newX = possibleMovementBounds.Width < 0
+            float newX = possibleMovementBounds.Width < 0
                 ? objectInfo.PositionOriginal.X
                 : Math.Clamp(previousPosition.X, possibleMovementBounds.Left, possibleMovementBounds.Right);
 
-            var newY = possibleMovementBounds.Height < 0
+            float newY = possibleMovementBounds.Height < 0
                 ? objectInfo.PositionOriginal.Y
                 : Math.Clamp(previousPosition.Y, possibleMovementBounds.Top, possibleMovementBounds.Bottom);
 
@@ -235,7 +235,7 @@ namespace osu.Game.Rulesets.Osu.Mods
             }
 
             // Take the circle radius into account.
-            var radius = (float)slider.Radius;
+            float radius = (float)slider.Radius;
 
             minX -= radius;
             minY -= radius;
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModSpunOut.cs b/osu.Game.Rulesets.Osu/Mods/OsuModSpunOut.cs
index c7f4811701..31474e8fbb 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModSpunOut.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModSpunOut.cs
@@ -44,7 +44,7 @@ namespace osu.Game.Rulesets.Osu.Mods
             // because the spinner is under the gameplay clock, it is affected by rate adjustments on the track;
             // for that reason using ElapsedFrameTime directly leads to fewer SPM with Half Time and more SPM with Double Time.
             // for spinners we want the real (wall clock) elapsed time; to achieve that, unapply the clock rate locally here.
-            var rateIndependentElapsedTime = spinner.Clock.ElapsedFrameTime / spinner.Clock.Rate;
+            double rateIndependentElapsedTime = spinner.Clock.ElapsedFrameTime / spinner.Clock.Rate;
             spinner.RotationTracker.AddRotation(MathUtils.RadiansToDegrees((float)rateIndependentElapsedTime * 0.03f));
         }
     }
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModTarget.cs b/osu.Game.Rulesets.Osu/Mods/OsuModTarget.cs
index bf70a63ab5..5285380097 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModTarget.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModTarget.cs
@@ -193,8 +193,8 @@ namespace osu.Game.Rulesets.Osu.Mods
 
         private IEnumerable<double> generateBeats(IBeatmap beatmap)
         {
-            var startTime = originalHitObjects.First().StartTime;
-            var endTime = originalHitObjects.Last().GetEndTime();
+            double startTime = originalHitObjects.First().StartTime;
+            double endTime = originalHitObjects.Last().GetEndTime();
 
             var beats = beatmap.ControlPointInfo.TimingPoints
                                // Ignore timing points after endTime
@@ -208,9 +208,9 @@ namespace osu.Game.Rulesets.Osu.Mods
                                .ToList();
 
             // Remove beats that are too close to the next one (e.g. due to timing point changes)
-            for (var i = beats.Count - 2; i >= 0; i--)
+            for (int i = beats.Count - 2; i >= 0; i--)
             {
-                var beat = beats[i];
+                double beat = beats[i];
 
                 if (!definitelyBigger(beats[i + 1] - beat, beatmap.ControlPointInfo.TimingPointAt(beat).BeatLength / 2))
                     beats.RemoveAt(i);
@@ -250,13 +250,13 @@ namespace osu.Game.Rulesets.Osu.Mods
             // Other kinds of combo info are also added in the process
             var combos = hitObjects.GroupBy(x => x.ComboIndex).ToList();
 
-            for (var i = 0; i < combos.Count; i++)
+            for (int i = 0; i < combos.Count; i++)
             {
                 var group = combos[i].ToList();
                 group.First().NewCombo = true;
                 group.Last().LastInCombo = true;
 
-                for (var j = 0; j < group.Count; j++)
+                for (int j = 0; j < group.Count; j++)
                 {
                     var x = group[j];
                     x.ComboIndex = i;
@@ -273,17 +273,17 @@ namespace osu.Game.Rulesets.Osu.Mods
 
             const float two_pi = MathF.PI * 2;
 
-            var direction = two_pi * nextSingle();
-            var maxComboIndex = hitObjects.Last().ComboIndex;
+            float direction = two_pi * nextSingle();
+            int maxComboIndex = hitObjects.Last().ComboIndex;
 
-            for (var i = 0; i < hitObjects.Count; i++)
+            for (int i = 0; i < hitObjects.Count; i++)
             {
                 var obj = hitObjects[i];
                 var lastPos = i == 0
                     ? Vector2.Divide(OsuPlayfield.BASE_SIZE, 2)
                     : hitObjects[i - 1].Position;
 
-                var distance = maxComboIndex == 0
+                float distance = maxComboIndex == 0
                     ? (float)obj.Radius
                     : mapRange(obj.ComboIndex, 0, maxComboIndex, (float)obj.Radius, max_base_distance);
                 if (obj.NewCombo) distance *= 1.5f;
@@ -292,7 +292,7 @@ namespace osu.Game.Rulesets.Osu.Mods
 
                 // Attempt to place the circle at a place that does not overlap with previous ones
 
-                var tryCount = 0;
+                int tryCount = 0;
 
                 // for checking overlap
                 var precedingObjects = hitObjects.SkipLast(hitObjects.Count - i).TakeLast(overlap_check_count).ToList();
@@ -363,7 +363,7 @@ namespace osu.Game.Rulesets.Osu.Mods
         {
             var beats = new List<double>();
             int i = 0;
-            var currentTime = timingPoint.Time;
+            double currentTime = timingPoint.Time;
 
             while (!definitelyBigger(currentTime, mapEndTime) && controlPointInfo.TimingPointAt(currentTime) == timingPoint)
             {
@@ -377,7 +377,7 @@ namespace osu.Game.Rulesets.Osu.Mods
 
         private OsuHitObject getClosestHitObject(List<OsuHitObject> hitObjects, double time)
         {
-            var precedingIndex = hitObjects.FindLastIndex(h => h.StartTime < time);
+            int precedingIndex = hitObjects.FindLastIndex(h => h.StartTime < time);
 
             if (precedingIndex == hitObjects.Count - 1) return hitObjects[precedingIndex];
 
@@ -457,7 +457,7 @@ namespace osu.Game.Rulesets.Osu.Mods
         private void clampToPlayfield(OsuHitObject obj)
         {
             var position = obj.Position;
-            var radius = (float)obj.Radius;
+            float radius = (float)obj.Radius;
 
             if (position.Y < radius)
                 position.Y = radius;
diff --git a/osu.Game.Rulesets.Osu/Objects/Drawables/Connections/FollowPointConnection.cs b/osu.Game.Rulesets.Osu/Objects/Drawables/Connections/FollowPointConnection.cs
index 001ea6c4ad..e88d09e6d9 100644
--- a/osu.Game.Rulesets.Osu/Objects/Drawables/Connections/FollowPointConnection.cs
+++ b/osu.Game.Rulesets.Osu/Objects/Drawables/Connections/FollowPointConnection.cs
@@ -67,7 +67,7 @@ namespace osu.Game.Rulesets.Osu.Objects.Drawables.Connections
                 Vector2 pointStartPosition = startPosition + (fraction - 0.1f) * distanceVector;
                 Vector2 pointEndPosition = startPosition + fraction * distanceVector;
 
-                GetFadeTimes(start, end, (float)d / distance, out var fadeInTime, out var fadeOutTime);
+                GetFadeTimes(start, end, (float)d / distance, out double fadeInTime, out double fadeOutTime);
 
                 FollowPoint fp;
 
diff --git a/osu.Game.Rulesets.Osu/Objects/Drawables/Connections/FollowPointLifetimeEntry.cs b/osu.Game.Rulesets.Osu/Objects/Drawables/Connections/FollowPointLifetimeEntry.cs
index 30ff6b8984..ad656d2085 100644
--- a/osu.Game.Rulesets.Osu/Objects/Drawables/Connections/FollowPointLifetimeEntry.cs
+++ b/osu.Game.Rulesets.Osu/Objects/Drawables/Connections/FollowPointLifetimeEntry.cs
@@ -93,7 +93,7 @@ namespace osu.Game.Rulesets.Osu.Objects.Drawables.Connections
 
             // The lifetime start will match the fade-in time of the first follow point.
             float fraction = (int)(FollowPointConnection.SPACING * 1.5) / distanceVector.Length;
-            FollowPointConnection.GetFadeTimes(Start, End, fraction, out var fadeInTime, out _);
+            FollowPointConnection.GetFadeTimes(Start, End, fraction, out double fadeInTime, out _);
 
             LifetimeStart = fadeInTime;
             LifetimeEnd = double.MaxValue; // This will be set by the connection.
diff --git a/osu.Game.Rulesets.Osu/Objects/Drawables/Connections/FollowPointRenderer.cs b/osu.Game.Rulesets.Osu/Objects/Drawables/Connections/FollowPointRenderer.cs
index 21e6619444..011e9fa85d 100644
--- a/osu.Game.Rulesets.Osu/Objects/Drawables/Connections/FollowPointRenderer.cs
+++ b/osu.Game.Rulesets.Osu/Objects/Drawables/Connections/FollowPointRenderer.cs
@@ -56,7 +56,7 @@ namespace osu.Game.Rulesets.Osu.Objects.Drawables.Connections
         {
             var newEntry = new FollowPointLifetimeEntry(hitObject);
 
-            var index = lifetimeEntries.AddInPlace(newEntry, Comparer<FollowPointLifetimeEntry>.Create((e1, e2) =>
+            int index = lifetimeEntries.AddInPlace(newEntry, Comparer<FollowPointLifetimeEntry>.Create((e1, e2) =>
             {
                 int comp = e1.Start.StartTime.CompareTo(e2.Start.StartTime);
 
diff --git a/osu.Game.Rulesets.Osu/Skinning/Default/SnakingSliderBody.cs b/osu.Game.Rulesets.Osu/Skinning/Default/SnakingSliderBody.cs
index 7b7a89d5e2..42d3840158 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Default/SnakingSliderBody.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Default/SnakingSliderBody.cs
@@ -70,8 +70,8 @@ namespace osu.Game.Rulesets.Osu.Skinning.Default
 
             Slider slider = drawableSlider.HitObject;
 
-            var span = slider.SpanAt(completionProgress);
-            var spanProgress = slider.ProgressAt(completionProgress);
+            int span = slider.SpanAt(completionProgress);
+            double spanProgress = slider.ProgressAt(completionProgress);
 
             double start = 0;
             double end = SnakingIn.Value ? Math.Clamp((Time.Current - (slider.StartTime - slider.TimePreempt)) / (slider.TimePreempt / 3), 0, 1) : 1;
@@ -110,8 +110,8 @@ namespace osu.Game.Rulesets.Osu.Skinning.Default
             snakedPosition = Path.PositionInBoundingBox(Vector2.Zero);
             snakedPathOffset = Path.PositionInBoundingBox(Path.Vertices[0]);
 
-            var lastSnakedStart = SnakedStart ?? 0;
-            var lastSnakedEnd = SnakedEnd ?? 0;
+            double lastSnakedStart = SnakedStart ?? 0;
+            double lastSnakedEnd = SnakedEnd ?? 0;
 
             SnakedStart = null;
             SnakedEnd = null;
diff --git a/osu.Game.Rulesets.Osu/Skinning/Default/SpinnerRotationTracker.cs b/osu.Game.Rulesets.Osu/Skinning/Default/SpinnerRotationTracker.cs
index 9393a589eb..4313e99b13 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Default/SpinnerRotationTracker.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Default/SpinnerRotationTracker.cs
@@ -62,9 +62,9 @@ namespace osu.Game.Rulesets.Osu.Skinning.Default
         protected override void Update()
         {
             base.Update();
-            var thisAngle = -MathUtils.RadiansToDegrees(MathF.Atan2(mousePosition.X - DrawSize.X / 2, mousePosition.Y - DrawSize.Y / 2));
+            float thisAngle = -MathUtils.RadiansToDegrees(MathF.Atan2(mousePosition.X - DrawSize.X / 2, mousePosition.Y - DrawSize.Y / 2));
 
-            var delta = thisAngle - lastAngle;
+            float delta = thisAngle - lastAngle;
 
             if (Tracking)
                 AddRotation(delta);
diff --git a/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyMainCirclePiece.cs b/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyMainCirclePiece.cs
index d1c9b1bf92..f4422a4806 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyMainCirclePiece.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyMainCirclePiece.cs
@@ -158,7 +158,7 @@ namespace osu.Game.Rulesets.Osu.Skinning.Legacy
 
                         if (hasNumber)
                         {
-                            var legacyVersion = skin.GetConfig<LegacySetting, decimal>(LegacySetting.Version)?.Value;
+                            decimal? legacyVersion = skin.GetConfig<LegacySetting, decimal>(LegacySetting.Version)?.Value;
 
                             if (legacyVersion >= 2.0m)
                                 // legacy skins of version 2.0 and newer only apply very short fade out to the number piece.
diff --git a/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyOldStyleSpinner.cs b/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyOldStyleSpinner.cs
index e3e8f3ce88..ea122d47bb 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyOldStyleSpinner.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyOldStyleSpinner.cs
@@ -103,7 +103,7 @@ namespace osu.Game.Rulesets.Osu.Skinning.Legacy
 
             // careful: need to call this exactly once for all calculations in a frame
             // as the function has a random factor in it
-            var metreHeight = getMetreHeight(DrawableSpinner.Progress);
+            float metreHeight = getMetreHeight(DrawableSpinner.Progress);
 
             // hack to make the metre blink up from below than down from above.
             // move down the container to be able to apply masking for the metre,
diff --git a/osu.Game.Rulesets.Osu/Statistics/AccuracyHeatmap.cs b/osu.Game.Rulesets.Osu/Statistics/AccuracyHeatmap.cs
index 24a660e69e..3c2077b3c8 100644
--- a/osu.Game.Rulesets.Osu/Statistics/AccuracyHeatmap.cs
+++ b/osu.Game.Rulesets.Osu/Statistics/AccuracyHeatmap.cs
@@ -216,7 +216,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.
-            var rotatedAngle = finalAngle - MathUtils.DegreesToRadians(rotation);
+            double rotatedAngle = finalAngle - MathUtils.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.Rulesets.Osu/Utils/OsuHitObjectGenerationUtils.cs b/osu.Game.Rulesets.Osu/Utils/OsuHitObjectGenerationUtils.cs
index bfd6ac3ad3..97a4b14a62 100644
--- a/osu.Game.Rulesets.Osu/Utils/OsuHitObjectGenerationUtils.cs
+++ b/osu.Game.Rulesets.Osu/Utils/OsuHitObjectGenerationUtils.cs
@@ -40,7 +40,7 @@ namespace osu.Game.Rulesets.Osu.Utils
         /// <returns>The new position of the hit object, relative to the previous one.</returns>
         public static Vector2 RotateAwayFromEdge(Vector2 prevObjectPos, Vector2 posRelativeToPrev, float rotationRatio = 0.5f)
         {
-            var relativeRotationDistance = 0f;
+            float relativeRotationDistance = 0f;
 
             if (prevObjectPos.X < playfield_middle.X)
             {
@@ -88,16 +88,16 @@ namespace osu.Game.Rulesets.Osu.Utils
         /// <returns>The rotated vector.</returns>
         public static Vector2 RotateVectorTowardsVector(Vector2 initial, Vector2 destination, float rotationRatio)
         {
-            var initialAngleRad = MathF.Atan2(initial.Y, initial.X);
-            var destAngleRad = MathF.Atan2(destination.Y, destination.X);
+            float initialAngleRad = MathF.Atan2(initial.Y, initial.X);
+            float destAngleRad = MathF.Atan2(destination.Y, destination.X);
 
-            var diff = destAngleRad - initialAngleRad;
+            float diff = destAngleRad - initialAngleRad;
 
             while (diff < -MathF.PI) diff += 2 * MathF.PI;
 
             while (diff > MathF.PI) diff -= 2 * MathF.PI;
 
-            var finalAngleRad = initialAngleRad + rotationRatio * diff;
+            float finalAngleRad = initialAngleRad + rotationRatio * diff;
 
             return new Vector2(
                 initial.Length * MathF.Cos(finalAngleRad),
diff --git a/osu.Game.Rulesets.Taiko.Tests/TestSceneSampleOutput.cs b/osu.Game.Rulesets.Taiko.Tests/TestSceneSampleOutput.cs
index 296468d98d..97c8d9eeb5 100644
--- a/osu.Game.Rulesets.Taiko.Tests/TestSceneSampleOutput.cs
+++ b/osu.Game.Rulesets.Taiko.Tests/TestSceneSampleOutput.cs
@@ -20,7 +20,7 @@ namespace osu.Game.Rulesets.Taiko.Tests
         {
             base.SetUpSteps();
 
-            var expectedSampleNames = new[]
+            string[] expectedSampleNames = new[]
             {
                 string.Empty,
                 string.Empty,
diff --git a/osu.Game.Rulesets.Taiko/Beatmaps/TaikoBeatmapConverter.cs b/osu.Game.Rulesets.Taiko/Beatmaps/TaikoBeatmapConverter.cs
index 32aad6c36a..5c5b3f9daa 100644
--- a/osu.Game.Rulesets.Taiko/Beatmaps/TaikoBeatmapConverter.cs
+++ b/osu.Game.Rulesets.Taiko/Beatmaps/TaikoBeatmapConverter.cs
@@ -79,7 +79,7 @@ namespace osu.Game.Rulesets.Taiko.Beatmaps
             {
                 case IHasDistance distanceData:
                 {
-                    if (shouldConvertSliderToHits(obj, beatmap, distanceData, out var taikoDuration, out var tickSpacing))
+                    if (shouldConvertSliderToHits(obj, beatmap, distanceData, out int taikoDuration, out double tickSpacing))
                     {
                         List<IList<HitSampleInfo>> allSamples = obj is IHasPathWithRepeats curveData ? curveData.NodeSamples : new List<IList<HitSampleInfo>>(new[] { samples });
 
diff --git a/osu.Game.Rulesets.Taiko/Objects/Drawables/DrawableHit.cs b/osu.Game.Rulesets.Taiko/Objects/Drawables/DrawableHit.cs
index 97adc5f197..863672b3fa 100644
--- a/osu.Game.Rulesets.Taiko/Objects/Drawables/DrawableHit.cs
+++ b/osu.Game.Rulesets.Taiko/Objects/Drawables/DrawableHit.cs
@@ -109,7 +109,7 @@ namespace osu.Game.Rulesets.Taiko.Objects.Drawables
 
                 var corrected = samples.ToList();
 
-                for (var i = 0; i < corrected.Count; i++)
+                for (int i = 0; i < corrected.Count; i++)
                 {
                     var s = corrected[i];
 
@@ -156,7 +156,7 @@ namespace osu.Game.Rulesets.Taiko.Objects.Drawables
             validActionPressed = HitActions.Contains(e.Action);
 
             // Only count this as handled if the new judgement is a hit
-            var result = UpdateResult(true);
+            bool result = UpdateResult(true);
             if (IsHit)
                 HitAction = e.Action;
 
diff --git a/osu.Game.Rulesets.Taiko/Objects/Drawables/DrawableSwell.cs b/osu.Game.Rulesets.Taiko/Objects/Drawables/DrawableSwell.cs
index 2d19296d06..77243218ce 100644
--- a/osu.Game.Rulesets.Taiko/Objects/Drawables/DrawableSwell.cs
+++ b/osu.Game.Rulesets.Taiko/Objects/Drawables/DrawableSwell.cs
@@ -185,9 +185,9 @@ namespace osu.Game.Rulesets.Taiko.Objects.Drawables
 
                 nextTick?.TriggerResult(true);
 
-                var numHits = ticks.Count(r => r.IsHit);
+                int numHits = ticks.Count(r => r.IsHit);
 
-                var completion = (float)numHits / HitObject.RequiredHits;
+                float completion = (float)numHits / HitObject.RequiredHits;
 
                 expandingRing
                     .FadeTo(expandingRing.Alpha + Math.Clamp(completion / 16, 0.1f, 0.6f), 50)
@@ -273,7 +273,7 @@ namespace osu.Game.Rulesets.Taiko.Objects.Drawables
             if (Time.Current < HitObject.StartTime)
                 return false;
 
-            var isCentre = e.Action == TaikoAction.LeftCentre || e.Action == TaikoAction.RightCentre;
+            bool isCentre = e.Action == TaikoAction.LeftCentre || e.Action == TaikoAction.RightCentre;
 
             // Ensure alternating centre and rim hits
             if (lastWasCentre == isCentre)
diff --git a/osu.Game.Rulesets.Taiko/Skinning/Legacy/TaikoLegacySkinTransformer.cs b/osu.Game.Rulesets.Taiko/Skinning/Legacy/TaikoLegacySkinTransformer.cs
index a3ecbbc436..bbc8f0abea 100644
--- a/osu.Game.Rulesets.Taiko/Skinning/Legacy/TaikoLegacySkinTransformer.cs
+++ b/osu.Game.Rulesets.Taiko/Skinning/Legacy/TaikoLegacySkinTransformer.cs
@@ -91,7 +91,7 @@ namespace osu.Game.Rulesets.Taiko.Skinning.Legacy
 
                     case TaikoSkinComponents.TaikoExplosionOk:
                     case TaikoSkinComponents.TaikoExplosionGreat:
-                        var hitName = getHitName(taikoComponent.Component);
+                        string hitName = getHitName(taikoComponent.Component);
                         var hitSprite = this.GetAnimation(hitName, true, false);
 
                         if (hitSprite != null)
@@ -162,10 +162,10 @@ namespace osu.Game.Rulesets.Taiko.Skinning.Legacy
             {
                 get
                 {
-                    foreach (var name in base.LookupNames)
+                    foreach (string name in base.LookupNames)
                         yield return name.Insert(name.LastIndexOf('/') + 1, "taiko-");
 
-                    foreach (var name in base.LookupNames)
+                    foreach (string name in base.LookupNames)
                         yield return name;
                 }
             }
diff --git a/osu.Game.Rulesets.Taiko/UI/DrumRollHitContainer.cs b/osu.Game.Rulesets.Taiko/UI/DrumRollHitContainer.cs
index 263454c78a..ae37840825 100644
--- a/osu.Game.Rulesets.Taiko/UI/DrumRollHitContainer.cs
+++ b/osu.Game.Rulesets.Taiko/UI/DrumRollHitContainer.cs
@@ -18,7 +18,7 @@ namespace osu.Game.Rulesets.Taiko.UI
             base.Update();
 
             // Remove any auxiliary hit notes that were spawned during a drum roll but subsequently rewound.
-            for (var i = AliveInternalChildren.Count - 1; i >= 0; i--)
+            for (int i = AliveInternalChildren.Count - 1; i >= 0; i--)
             {
                 var flyingHit = (DrawableFlyingHit)AliveInternalChildren[i];
                 if (Time.Current <= flyingHit.HitObject.StartTime)
diff --git a/osu.Game.Rulesets.Taiko/UI/TaikoMascotAnimation.cs b/osu.Game.Rulesets.Taiko/UI/TaikoMascotAnimation.cs
index 3706acbe23..c496c05236 100644
--- a/osu.Game.Rulesets.Taiko/UI/TaikoMascotAnimation.cs
+++ b/osu.Game.Rulesets.Taiko/UI/TaikoMascotAnimation.cs
@@ -122,7 +122,7 @@ namespace osu.Game.Rulesets.Taiko.UI
 
                 if (skin == null) return;
 
-                foreach (var frameIndex in clear_animation_sequence)
+                foreach (int frameIndex in clear_animation_sequence)
                 {
                     var texture = getAnimationFrame(skin, TaikoMascotAnimationState.Clear, frameIndex);
 
diff --git a/osu.Game.Tests/Beatmaps/Formats/LegacyDecoderTest.cs b/osu.Game.Tests/Beatmaps/Formats/LegacyDecoderTest.cs
index 335a6aeeb0..4334c4d7a2 100644
--- a/osu.Game.Tests/Beatmaps/Formats/LegacyDecoderTest.cs
+++ b/osu.Game.Tests/Beatmaps/Formats/LegacyDecoderTest.cs
@@ -40,7 +40,7 @@ namespace osu.Game.Tests.Beatmaps.Formats
 
             protected override bool ShouldSkipLine(string line)
             {
-                var result = base.ShouldSkipLine(line);
+                bool result = base.ShouldSkipLine(line);
 
                 if (!result)
                     ParsedLines.Add(line);
diff --git a/osu.Game.Tests/Beatmaps/IO/ImportBeatmapTest.cs b/osu.Game.Tests/Beatmaps/IO/ImportBeatmapTest.cs
index 4cc71717ff..935194db58 100644
--- a/osu.Game.Tests/Beatmaps/IO/ImportBeatmapTest.cs
+++ b/osu.Game.Tests/Beatmaps/IO/ImportBeatmapTest.cs
@@ -82,7 +82,7 @@ namespace osu.Game.Tests.Beatmaps.IO
                 {
                     var osu = LoadOsuIntoHost(host);
 
-                    var tempPath = TestResources.GetTestBeatmapForImport();
+                    string tempPath = TestResources.GetTestBeatmapForImport();
 
                     var manager = osu.Dependencies.Get<BeatmapManager>();
 
@@ -144,7 +144,7 @@ namespace osu.Game.Tests.Beatmaps.IO
                 {
                     var osu = LoadOsuIntoHost(host);
 
-                    var temp = TestResources.GetTestBeatmapForImport();
+                    string temp = TestResources.GetTestBeatmapForImport();
 
                     string extractedFolder = $"{temp}_extracted";
                     Directory.CreateDirectory(extractedFolder);
@@ -196,7 +196,7 @@ namespace osu.Game.Tests.Beatmaps.IO
                 {
                     var osu = LoadOsuIntoHost(host);
 
-                    var temp = TestResources.GetTestBeatmapForImport();
+                    string temp = TestResources.GetTestBeatmapForImport();
 
                     string extractedFolder = $"{temp}_extracted";
                     Directory.CreateDirectory(extractedFolder);
@@ -251,7 +251,7 @@ namespace osu.Game.Tests.Beatmaps.IO
                 {
                     var osu = LoadOsuIntoHost(host);
 
-                    var temp = TestResources.GetTestBeatmapForImport();
+                    string temp = TestResources.GetTestBeatmapForImport();
 
                     string extractedFolder = $"{temp}_extracted";
                     Directory.CreateDirectory(extractedFolder);
@@ -302,7 +302,7 @@ namespace osu.Game.Tests.Beatmaps.IO
                 {
                     var osu = LoadOsuIntoHost(host);
 
-                    var temp = TestResources.GetTestBeatmapForImport();
+                    string temp = TestResources.GetTestBeatmapForImport();
 
                     string extractedFolder = $"{temp}_extracted";
                     Directory.CreateDirectory(extractedFolder);
@@ -424,7 +424,7 @@ namespace osu.Game.Tests.Beatmaps.IO
                     checkBeatmapCount(osu, 12);
                     checkSingleReferencedFileCount(osu, 18);
 
-                    var brokenTempFilename = TestResources.GetTestBeatmapForImport();
+                    string brokenTempFilename = TestResources.GetTestBeatmapForImport();
 
                     MemoryStream brokenOsu = new MemoryStream();
                     MemoryStream brokenOsz = new MemoryStream(await File.ReadAllBytesAsync(brokenTempFilename));
@@ -594,7 +594,7 @@ namespace osu.Game.Tests.Beatmaps.IO
 
                     var osu = LoadOsuIntoHost(host);
 
-                    var temp = TestResources.GetTestBeatmapForImport();
+                    string temp = TestResources.GetTestBeatmapForImport();
 
                     var importer = new ArchiveImportIPCChannel(client);
                     if (!importer.ImportAsync(temp).Wait(10000))
@@ -619,7 +619,7 @@ namespace osu.Game.Tests.Beatmaps.IO
                 try
                 {
                     var osu = LoadOsuIntoHost(host);
-                    var temp = TestResources.GetTestBeatmapForImport();
+                    string temp = TestResources.GetTestBeatmapForImport();
                     using (File.OpenRead(temp))
                         await osu.Dependencies.Get<BeatmapManager>().Import(temp);
                     ensureLoaded(osu);
@@ -642,7 +642,7 @@ namespace osu.Game.Tests.Beatmaps.IO
                 {
                     var osu = LoadOsuIntoHost(host);
 
-                    var temp = TestResources.GetTestBeatmapForImport();
+                    string temp = TestResources.GetTestBeatmapForImport();
 
                     string extractedFolder = $"{temp}_extracted";
                     Directory.CreateDirectory(extractedFolder);
@@ -684,7 +684,7 @@ namespace osu.Game.Tests.Beatmaps.IO
                 {
                     var osu = LoadOsuIntoHost(host);
 
-                    var temp = TestResources.GetTestBeatmapForImport();
+                    string temp = TestResources.GetTestBeatmapForImport();
 
                     string extractedFolder = $"{temp}_extracted";
                     string subfolder = Path.Combine(extractedFolder, "subfolder");
@@ -729,7 +729,7 @@ namespace osu.Game.Tests.Beatmaps.IO
                 {
                     var osu = LoadOsuIntoHost(host);
 
-                    var temp = TestResources.GetTestBeatmapForImport();
+                    string temp = TestResources.GetTestBeatmapForImport();
 
                     string extractedFolder = $"{temp}_extracted";
                     string dataFolder = Path.Combine(extractedFolder, "actual_data");
@@ -784,7 +784,7 @@ namespace osu.Game.Tests.Beatmaps.IO
                     var osu = LoadOsuIntoHost(host);
                     var manager = osu.Dependencies.Get<BeatmapManager>();
 
-                    var temp = TestResources.GetTestBeatmapForImport();
+                    string temp = TestResources.GetTestBeatmapForImport();
                     await osu.Dependencies.Get<BeatmapManager>().Import(temp);
 
                     // Update via the beatmap, not the beatmap info, to ensure correct linking
@@ -814,7 +814,7 @@ namespace osu.Game.Tests.Beatmaps.IO
                     var osu = LoadOsuIntoHost(host);
                     var manager = osu.Dependencies.Get<BeatmapManager>();
 
-                    var temp = TestResources.GetTestBeatmapForImport();
+                    string temp = TestResources.GetTestBeatmapForImport();
                     await osu.Dependencies.Get<BeatmapManager>().Import(temp);
 
                     BeatmapSetInfo setToUpdate = manager.GetAllUsableBeatmapSets()[0];
@@ -905,7 +905,7 @@ namespace osu.Game.Tests.Beatmaps.IO
 
         public static async Task<BeatmapSetInfo> LoadQuickOszIntoOsu(OsuGameBase osu)
         {
-            var temp = TestResources.GetQuickTestBeatmapForImport();
+            string temp = TestResources.GetQuickTestBeatmapForImport();
 
             var manager = osu.Dependencies.Get<BeatmapManager>();
 
@@ -920,7 +920,7 @@ namespace osu.Game.Tests.Beatmaps.IO
 
         public static async Task<BeatmapSetInfo> LoadOszIntoOsu(OsuGameBase osu, string path = null, bool virtualTrack = false)
         {
-            var temp = path ?? TestResources.GetTestBeatmapForImport(virtualTrack);
+            string temp = path ?? TestResources.GetTestBeatmapForImport(virtualTrack);
 
             var manager = osu.Dependencies.Get<BeatmapManager>();
 
diff --git a/osu.Game.Tests/Beatmaps/IO/LineBufferedReaderTest.cs b/osu.Game.Tests/Beatmaps/IO/LineBufferedReaderTest.cs
index 25517ad615..5e37f01c81 100644
--- a/osu.Game.Tests/Beatmaps/IO/LineBufferedReaderTest.cs
+++ b/osu.Game.Tests/Beatmaps/IO/LineBufferedReaderTest.cs
@@ -114,7 +114,7 @@ namespace osu.Game.Tests.Beatmaps.IO
                 Assert.AreEqual("this line is gone", bufferedReader.ReadLine());
                 Assert.AreEqual("this one shouldn't be", bufferedReader.PeekLine());
 
-                var endingLines = bufferedReader.ReadToEnd().Split(new[] { '\r', '\n' }, StringSplitOptions.RemoveEmptyEntries);
+                string[] endingLines = bufferedReader.ReadToEnd().Split(new[] { '\r', '\n' }, StringSplitOptions.RemoveEmptyEntries);
                 Assert.AreEqual(3, endingLines.Length);
                 Assert.AreEqual("this one shouldn't be", endingLines[0]);
                 Assert.AreEqual("these ones", endingLines[1]);
diff --git a/osu.Game.Tests/Beatmaps/IO/OszArchiveReaderTest.cs b/osu.Game.Tests/Beatmaps/IO/OszArchiveReaderTest.cs
index 2c1e39c2cf..d11da5e2a3 100644
--- a/osu.Game.Tests/Beatmaps/IO/OszArchiveReaderTest.cs
+++ b/osu.Game.Tests/Beatmaps/IO/OszArchiveReaderTest.cs
@@ -36,8 +36,8 @@ namespace osu.Game.Tests.Beatmaps.IO
                     "Soleily - Renatus (MMzz) [Muzukashii].osu",
                     "Soleily - Renatus (MMzz) [Oni].osu"
                 };
-                var maps = reader.Filenames.ToArray();
-                foreach (var map in expected)
+                string[] maps = reader.Filenames.ToArray();
+                foreach (string map in expected)
                     Assert.Contains(map, maps);
             }
         }
diff --git a/osu.Game.Tests/Database/BeatmapImporterTests.cs b/osu.Game.Tests/Database/BeatmapImporterTests.cs
index 4cdcf507b6..a21f935f6b 100644
--- a/osu.Game.Tests/Database/BeatmapImporterTests.cs
+++ b/osu.Game.Tests/Database/BeatmapImporterTests.cs
@@ -94,7 +94,7 @@ namespace osu.Game.Tests.Database
                 using var importer = new BeatmapImporter(realmFactory, storage);
                 using var store = new RealmRulesetStore(realmFactory, storage);
 
-                var tempPath = TestResources.GetTestBeatmapForImport();
+                string? tempPath = TestResources.GetTestBeatmapForImport();
 
                 ILive<RealmBeatmapSet>? importedSet;
 
@@ -144,7 +144,7 @@ namespace osu.Game.Tests.Database
                 using var importer = new BeatmapImporter(realmFactory, storage);
                 using var store = new RealmRulesetStore(realmFactory, storage);
 
-                var temp = TestResources.GetTestBeatmapForImport();
+                string? temp = TestResources.GetTestBeatmapForImport();
 
                 string extractedFolder = $"{temp}_extracted";
                 Directory.CreateDirectory(extractedFolder);
@@ -193,7 +193,7 @@ namespace osu.Game.Tests.Database
                 using var importer = new BeatmapImporter(realmFactory, storage);
                 using var store = new RealmRulesetStore(realmFactory, storage);
 
-                var temp = TestResources.GetTestBeatmapForImport();
+                string? temp = TestResources.GetTestBeatmapForImport();
 
                 string extractedFolder = $"{temp}_extracted";
                 Directory.CreateDirectory(extractedFolder);
@@ -245,7 +245,7 @@ namespace osu.Game.Tests.Database
                 using var importer = new BeatmapImporter(realmFactory, storage);
                 using var store = new RealmRulesetStore(realmFactory, storage);
 
-                var temp = TestResources.GetTestBeatmapForImport();
+                string? temp = TestResources.GetTestBeatmapForImport();
 
                 string extractedFolder = $"{temp}_extracted";
                 Directory.CreateDirectory(extractedFolder);
@@ -293,7 +293,7 @@ namespace osu.Game.Tests.Database
                 using var importer = new BeatmapImporter(realmFactory, storage);
                 using var store = new RealmRulesetStore(realmFactory, storage);
 
-                var temp = TestResources.GetTestBeatmapForImport();
+                string? temp = TestResources.GetTestBeatmapForImport();
 
                 string extractedFolder = $"{temp}_extracted";
                 Directory.CreateDirectory(extractedFolder);
@@ -391,7 +391,7 @@ namespace osu.Game.Tests.Database
                 checkBeatmapCount(realmFactory.Context, 12);
                 checkSingleReferencedFileCount(realmFactory.Context, 18);
 
-                var brokenTempFilename = TestResources.GetTestBeatmapForImport();
+                string? brokenTempFilename = TestResources.GetTestBeatmapForImport();
 
                 MemoryStream brokenOsu = new MemoryStream();
                 MemoryStream brokenOsz = new MemoryStream(await File.ReadAllBytesAsync(brokenTempFilename));
@@ -522,7 +522,7 @@ namespace osu.Game.Tests.Database
                 using var importer = new BeatmapImporter(realmFactory, storage);
                 using var store = new RealmRulesetStore(realmFactory, storage);
 
-                var temp = TestResources.GetTestBeatmapForImport();
+                string? temp = TestResources.GetTestBeatmapForImport();
                 using (File.OpenRead(temp))
                     await importer.Import(temp);
                 ensureLoaded(realmFactory.Context);
@@ -539,7 +539,7 @@ namespace osu.Game.Tests.Database
                 using var importer = new BeatmapImporter(realmFactory, storage);
                 using var store = new RealmRulesetStore(realmFactory, storage);
 
-                var temp = TestResources.GetTestBeatmapForImport();
+                string? temp = TestResources.GetTestBeatmapForImport();
 
                 string extractedFolder = $"{temp}_extracted";
                 Directory.CreateDirectory(extractedFolder);
@@ -575,7 +575,7 @@ namespace osu.Game.Tests.Database
                 using var importer = new BeatmapImporter(realmFactory, storage);
                 using var store = new RealmRulesetStore(realmFactory, storage);
 
-                var temp = TestResources.GetTestBeatmapForImport();
+                string? temp = TestResources.GetTestBeatmapForImport();
 
                 string extractedFolder = $"{temp}_extracted";
                 string subfolder = Path.Combine(extractedFolder, "subfolder");
@@ -617,7 +617,7 @@ namespace osu.Game.Tests.Database
                 using var importer = new BeatmapImporter(realmFactory, storage);
                 using var store = new RealmRulesetStore(realmFactory, storage);
 
-                var temp = TestResources.GetTestBeatmapForImport();
+                string? temp = TestResources.GetTestBeatmapForImport();
 
                 string extractedFolder = $"{temp}_extracted";
                 string dataFolder = Path.Combine(extractedFolder, "actual_data");
@@ -668,7 +668,7 @@ namespace osu.Game.Tests.Database
                 using var importer = new BeatmapImporter(realmFactory, storage);
                 using var store = new RealmRulesetStore(realmFactory, storage);
 
-                var temp = TestResources.GetTestBeatmapForImport();
+                string? temp = TestResources.GetTestBeatmapForImport();
                 await importer.Import(temp);
 
                 // Update via the beatmap, not the beatmap info, to ensure correct linking
@@ -685,7 +685,7 @@ namespace osu.Game.Tests.Database
 
         public static async Task<RealmBeatmapSet?> LoadQuickOszIntoOsu(BeatmapImporter importer, Realm realm)
         {
-            var temp = TestResources.GetQuickTestBeatmapForImport();
+            string? temp = TestResources.GetQuickTestBeatmapForImport();
 
             var importedSet = await importer.Import(new ImportTask(temp));
 
@@ -700,7 +700,7 @@ namespace osu.Game.Tests.Database
 
         public static async Task<RealmBeatmapSet> LoadOszIntoStore(BeatmapImporter importer, Realm realm, string? path = null, bool virtualTrack = false)
         {
-            var temp = path ?? TestResources.GetTestBeatmapForImport(virtualTrack);
+            string? temp = path ?? TestResources.GetTestBeatmapForImport(virtualTrack);
 
             var importedSet = await importer.Import(new ImportTask(temp));
 
diff --git a/osu.Game.Tests/NonVisual/BarLineGeneratorTest.cs b/osu.Game.Tests/NonVisual/BarLineGeneratorTest.cs
index e663e1128e..834c05fd08 100644
--- a/osu.Game.Tests/NonVisual/BarLineGeneratorTest.cs
+++ b/osu.Game.Tests/NonVisual/BarLineGeneratorTest.cs
@@ -49,7 +49,7 @@ namespace osu.Game.Tests.NonVisual
             for (int i = 0; i * beat_length_denominator < barLines.Count; i++)
             {
                 var barLine = barLines[i * beat_length_denominator];
-                var expectedTime = beat_length_numerator * (int)signature * i;
+                int expectedTime = beat_length_numerator * (int)signature * i;
 
                 // every seventh bar's start time should be at least greater than the whole number we expect.
                 // It cannot be less, as that can affect overlapping scroll algorithms
diff --git a/osu.Game.Tests/NonVisual/CustomDataDirectoryTest.cs b/osu.Game.Tests/NonVisual/CustomDataDirectoryTest.cs
index 5e14af5c27..8a063b3c6e 100644
--- a/osu.Game.Tests/NonVisual/CustomDataDirectoryTest.cs
+++ b/osu.Game.Tests/NonVisual/CustomDataDirectoryTest.cs
@@ -87,7 +87,7 @@ namespace osu.Game.Tests.NonVisual
                     File.WriteAllText(actualTestFile, "test");
 
                     var rulesetStorage = storage.GetStorageForDirectory("rulesets");
-                    var lookupPath = rulesetStorage.GetFiles(".").Single();
+                    string lookupPath = rulesetStorage.GetFiles(".").Single();
 
                     Assert.That(lookupPath, Is.EqualTo("test"));
                 }
@@ -140,7 +140,7 @@ namespace osu.Game.Tests.NonVisual
 
                     Assert.That(osuStorage, Is.Not.Null);
 
-                    foreach (var file in osuStorage.IgnoreFiles)
+                    foreach (string file in osuStorage.IgnoreFiles)
                     {
                         // avoid touching realm files which may be a pipe and break everything.
                         // this is also done locally inside OsuStorage via the IgnoreFiles list.
@@ -149,7 +149,7 @@ namespace osu.Game.Tests.NonVisual
                         Assert.That(storage.Exists(file), Is.False);
                     }
 
-                    foreach (var dir in osuStorage.IgnoreDirectories)
+                    foreach (string dir in osuStorage.IgnoreDirectories)
                     {
                         Assert.That(Directory.Exists(Path.Combine(originalDirectory, dir)));
                         Assert.That(storage.ExistsDirectory(dir), Is.False);
diff --git a/osu.Game.Tests/NonVisual/FramedReplayInputHandlerTest.cs b/osu.Game.Tests/NonVisual/FramedReplayInputHandlerTest.cs
index 407dec936b..99d394b454 100644
--- a/osu.Game.Tests/NonVisual/FramedReplayInputHandlerTest.cs
+++ b/osu.Game.Tests/NonVisual/FramedReplayInputHandlerTest.cs
@@ -347,7 +347,7 @@ namespace osu.Game.Tests.NonVisual
         {
             for (int i = 0; i < 1000; i++)
             {
-                var time = handler.SetFrameFromTime(destination);
+                double? time = handler.SetFrameFromTime(destination);
                 if (time == null || time == destination)
                     return;
             }
diff --git a/osu.Game.Tests/NonVisual/LimitedCapacityQueueTest.cs b/osu.Game.Tests/NonVisual/LimitedCapacityQueueTest.cs
index a04415bc7f..e1eaf213d6 100644
--- a/osu.Game.Tests/NonVisual/LimitedCapacityQueueTest.cs
+++ b/osu.Game.Tests/NonVisual/LimitedCapacityQueueTest.cs
@@ -30,7 +30,7 @@ namespace osu.Game.Tests.NonVisual
             Assert.Throws<InvalidOperationException>(() => _ = queue.Dequeue());
 
             int count = 0;
-            foreach (var _ in queue)
+            foreach (int _ in queue)
                 count++;
 
             Assert.AreEqual(0, count);
@@ -50,7 +50,7 @@ namespace osu.Game.Tests.NonVisual
                 Assert.AreEqual(i, queue[i]);
 
             int j = 0;
-            foreach (var item in queue)
+            foreach (int item in queue)
                 Assert.AreEqual(j++, item);
 
             for (int i = queue.Count; i < queue.Count + capacity; i++)
@@ -71,7 +71,7 @@ namespace osu.Game.Tests.NonVisual
                 Assert.AreEqual(count - capacity + i, queue[i]);
 
             int j = count - capacity;
-            foreach (var item in queue)
+            foreach (int item in queue)
                 Assert.AreEqual(j++, item);
 
             for (int i = queue.Count; i < queue.Count + capacity; i++)
diff --git a/osu.Game.Tests/NonVisual/Multiplayer/StatefulMultiplayerClientTest.cs b/osu.Game.Tests/NonVisual/Multiplayer/StatefulMultiplayerClientTest.cs
index 07ec86b0e7..8e2259bce8 100644
--- a/osu.Game.Tests/NonVisual/Multiplayer/StatefulMultiplayerClientTest.cs
+++ b/osu.Game.Tests/NonVisual/Multiplayer/StatefulMultiplayerClientTest.cs
@@ -84,7 +84,7 @@ namespace osu.Game.Tests.NonVisual.Multiplayer
             {
                 for (int i = 0; i < userCount; ++i)
                 {
-                    var userId = Client.Room?.Users[i].UserID ?? throw new AssertionException("Room cannot be null!");
+                    int userId = Client.Room?.Users[i].UserID ?? throw new AssertionException("Room cannot be null!");
                     Client.ChangeUserState(userId, state);
                 }
             });
diff --git a/osu.Game.Tests/NonVisual/ReverseQueueTest.cs b/osu.Game.Tests/NonVisual/ReverseQueueTest.cs
index 93cd9403ce..808c8d14f0 100644
--- a/osu.Game.Tests/NonVisual/ReverseQueueTest.cs
+++ b/osu.Game.Tests/NonVisual/ReverseQueueTest.cs
@@ -29,7 +29,7 @@ namespace osu.Game.Tests.NonVisual
             });
 
             int count = 0;
-            foreach (var unused in queue)
+            foreach (char unused in queue)
                 count++;
 
             Assert.AreEqual(0, count);
@@ -72,7 +72,7 @@ namespace osu.Game.Tests.NonVisual
 
             // Assert correct item return and no longer in queue after dequeueing
             Assert.AreEqual('a', queue[5]);
-            var dequeuedItem = queue.Dequeue();
+            char dequeuedItem = queue.Dequeue();
 
             Assert.AreEqual('a', dequeuedItem);
             Assert.AreEqual(5, queue.Count);
@@ -133,7 +133,7 @@ namespace osu.Game.Tests.NonVisual
             int expectedValueIndex = 0;
 
             // Assert items are enumerated in correct order
-            foreach (var item in queue)
+            foreach (char item in queue)
             {
                 Assert.AreEqual(expectedValues[expectedValueIndex], item);
                 expectedValueIndex++;
diff --git a/osu.Game.Tests/Online/TestMultiplayerMessagePackSerialization.cs b/osu.Game.Tests/Online/TestMultiplayerMessagePackSerialization.cs
index 5491774e26..1027b722d1 100644
--- a/osu.Game.Tests/Online/TestMultiplayerMessagePackSerialization.cs
+++ b/osu.Game.Tests/Online/TestMultiplayerMessagePackSerialization.cs
@@ -20,7 +20,7 @@ namespace osu.Game.Tests.Online
                 MatchState = new TeamVersusRoomState()
             };
 
-            var serialized = MessagePackSerializer.Serialize(room);
+            byte[] serialized = MessagePackSerializer.Serialize(room);
 
             var deserialized = MessagePackSerializer.Deserialize<MultiplayerRoom>(serialized);
 
@@ -32,7 +32,7 @@ namespace osu.Game.Tests.Online
         {
             var state = new TeamVersusUserState();
 
-            var serialized = MessagePackSerializer.Serialize(typeof(MatchUserState), state);
+            byte[] serialized = MessagePackSerializer.Serialize(typeof(MatchUserState), state);
             var deserialized = MessagePackSerializer.Deserialize<MatchUserState>(serialized);
 
             Assert.IsTrue(deserialized is TeamVersusUserState);
@@ -44,7 +44,7 @@ namespace osu.Game.Tests.Online
             var state = new TeamVersusUserState();
 
             // SignalR serialises using the actual type, rather than a base specification.
-            var serialized = MessagePackSerializer.Serialize(typeof(TeamVersusUserState), state);
+            byte[] serialized = MessagePackSerializer.Serialize(typeof(TeamVersusUserState), state);
 
             // works with explicit type specified.
             MessagePackSerializer.Deserialize<TeamVersusUserState>(serialized);
@@ -59,7 +59,7 @@ namespace osu.Game.Tests.Online
             var state = new TeamVersusUserState();
 
             // SignalR serialises using the actual type, rather than a base specification.
-            var serialized = MessagePackSerializer.Serialize(typeof(TeamVersusUserState), state, SignalRUnionWorkaroundResolver.OPTIONS);
+            byte[] serialized = MessagePackSerializer.Serialize(typeof(TeamVersusUserState), state, SignalRUnionWorkaroundResolver.OPTIONS);
 
             // works with explicit type specified.
             MessagePackSerializer.Deserialize<TeamVersusUserState>(serialized);
diff --git a/osu.Game.Tests/Resources/TestResources.cs b/osu.Game.Tests/Resources/TestResources.cs
index 839366d98e..dff9478852 100644
--- a/osu.Game.Tests/Resources/TestResources.cs
+++ b/osu.Game.Tests/Resources/TestResources.cs
@@ -29,7 +29,7 @@ namespace osu.Game.Tests.Resources
         /// <returns>A path to a copy of a beatmap archive (osz). Should be deleted after use.</returns>
         public static string GetQuickTestBeatmapForImport()
         {
-            var tempPath = getTempFilename();
+            string tempPath = getTempFilename();
             using (var stream = OpenResource("Archives/241526 Soleily - Renatus_virtual_quick.osz"))
             using (var newFile = File.Create(tempPath))
                 stream.CopyTo(newFile);
@@ -45,7 +45,7 @@ namespace osu.Game.Tests.Resources
         /// <returns>A path to a copy of a beatmap archive (osz). Should be deleted after use.</returns>
         public static string GetTestBeatmapForImport(bool virtualTrack = false)
         {
-            var tempPath = getTempFilename();
+            string tempPath = getTempFilename();
 
             using (var stream = GetTestBeatmapStream(virtualTrack))
             using (var newFile = File.Create(tempPath))
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneBeatDivisorControl.cs b/osu.Game.Tests/Visual/Editing/TestSceneBeatDivisorControl.cs
index 6cf5e6a987..ed7bb9e301 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneBeatDivisorControl.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneBeatDivisorControl.cs
@@ -72,7 +72,7 @@ namespace osu.Game.Tests.Visual.Editing
 
         private Vector2 getPositionForDivisor(int divisor)
         {
-            var relativePosition = (float)Math.Clamp(divisor, 0, 16) / 16;
+            float relativePosition = (float)Math.Clamp(divisor, 0, 16) / 16;
             var sliderDrawQuad = tickSliderBar.ScreenSpaceDrawQuad;
             return new Vector2(
                 sliderDrawQuad.TopLeft.X + sliderDrawQuad.Width * relativePosition,
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneEditorBeatmapCreation.cs b/osu.Game.Tests/Visual/Editing/TestSceneEditorBeatmapCreation.cs
index 440d66ff9f..92c8131568 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneEditorBeatmapCreation.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneEditorBeatmapCreation.cs
@@ -76,7 +76,7 @@ namespace osu.Game.Tests.Visual.Editing
             {
                 var setup = Editor.ChildrenOfType<SetupScreen>().First();
 
-                var temp = TestResources.GetTestBeatmapForImport();
+                string temp = TestResources.GetTestBeatmapForImport();
 
                 string extractedFolder = $"{temp}_extracted";
                 Directory.CreateDirectory(extractedFolder);
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneGameplayMenuOverlay.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneGameplayMenuOverlay.cs
index 477ac70501..abd43e7427 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneGameplayMenuOverlay.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneGameplayMenuOverlay.cs
@@ -57,7 +57,7 @@ namespace osu.Game.Tests.Visual.Gameplay
         {
             showOverlay();
 
-            var retryCount = 0;
+            int retryCount = 0;
 
             AddRepeatStep("Add retry", () =>
             {
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorLeaderboard.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorLeaderboard.cs
index ade24b8740..bd5320354e 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorLeaderboard.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorLeaderboard.cs
@@ -32,7 +32,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     { PLAYER_2_ID, new ManualClock() }
                 };
 
-                foreach (var (userId, _) in clocks)
+                foreach ((int userId, var _) in clocks)
                 {
                     SpectatorClient.StartPlay(userId, 0);
                     OnlinePlayDependencies.Client.AddUser(new User { Id = userId });
@@ -53,7 +53,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             AddStep("add clock sources", () =>
             {
-                foreach (var (userId, clock) in clocks)
+                foreach ((int userId, var clock) in clocks)
                     leaderboard.AddClock(userId, clock);
             });
         }
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs
index bfcb55ce33..8d878b993c 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs
@@ -289,7 +289,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [Test]
         public void TestSpectatingDuringGameplay()
         {
-            var players = new[] { PLAYER_1_ID, PLAYER_2_ID };
+            int[] players = new[] { PLAYER_1_ID, PLAYER_2_ID };
 
             start(players);
             sendFrames(players, 300);
@@ -326,7 +326,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             for (int count = 3; count >= 0; count--)
             {
-                var id = PLAYER_1_ID + count;
+                int id = PLAYER_1_ID + count;
 
                 end(id);
                 AddUntilStep($"{id} area grayed", () => getInstance(id).Colour != Color4.White);
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
index 2bb77395ef..f4a72dd7e7 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
@@ -582,7 +582,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             // Gameplay runs in real-time, so we need to incrementally check if gameplay has finished in order to not time out.
             for (double i = 1000; i < TestResources.QUICK_BEATMAP_LENGTH; i += 1000)
             {
-                var time = i;
+                double time = i;
                 AddUntilStep($"wait for time > {i}", () => this.ChildrenOfType<GameplayClockContainer>().SingleOrDefault()?.GameplayClock.CurrentTime > time);
             }
 
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs
index 3317ddc767..eff107faee 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs
@@ -55,7 +55,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 var playableBeatmap = Beatmap.Value.GetPlayableBeatmap(Ruleset.Value);
                 var multiplayerUsers = new List<MultiplayerRoomUser>();
 
-                foreach (var user in users)
+                foreach (int user in users)
                 {
                     SpectatorClient.StartPlay(user, Beatmap.Value.BeatmapInfo.OnlineBeatmapID ?? 0);
                     multiplayerUsers.Add(OnlinePlayDependencies.Client.AddUser(new User { Id = user }, true));
@@ -89,7 +89,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [Test]
         public void TestUserQuit()
         {
-            foreach (var user in users)
+            foreach (int user in users)
                 AddStep($"mark user {user} quit", () => Client.RemoveUser(LookupCache.GetUserAsync(user).Result.AsNonNull()));
         }
 
@@ -114,7 +114,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             public void RandomlyUpdateState()
             {
-                foreach (var userId in PlayingUsers)
+                foreach (int userId in PlayingUsers)
                 {
                     if (RNG.NextBool())
                         continue;
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboardTeams.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboardTeams.cs
index dfaf2f1dc3..32114fa500 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboardTeams.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboardTeams.cs
@@ -59,7 +59,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 var playableBeatmap = Beatmap.Value.GetPlayableBeatmap(Ruleset.Value);
                 var multiplayerUsers = new List<MultiplayerRoomUser>();
 
-                foreach (var user in users)
+                foreach (int user in users)
                 {
                     SpectatorClient.StartPlay(user, Beatmap.Value.BeatmapInfo.OnlineBeatmapID ?? 0);
                     var roomUser = OnlinePlayDependencies.Client.AddUser(new User { Id = user }, true);
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerParticipantsList.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerParticipantsList.cs
index d1980b03c7..e50b150f94 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerParticipantsList.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerParticipantsList.cs
@@ -112,7 +112,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             AddRepeatStep("increment progress", () =>
             {
-                var progress = this.ChildrenOfType<ParticipantPanel>().Single().User.BeatmapAvailability.DownloadProgress ?? 0;
+                float progress = this.ChildrenOfType<ParticipantPanel>().Single().User.BeatmapAvailability.DownloadProgress ?? 0;
                 Client.ChangeBeatmapAvailability(BeatmapAvailability.Downloading(progress + RNG.NextSingle(0.1f)));
             }, 25);
 
diff --git a/osu.Game.Tests/Visual/Online/TestSceneChatOverlay.cs b/osu.Game.Tests/Visual/Online/TestSceneChatOverlay.cs
index ab4e1b4457..99c3b398ab 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneChatOverlay.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneChatOverlay.cs
@@ -190,8 +190,8 @@ namespace osu.Game.Tests.Visual.Online
 
             for (int zeroBasedIndex = 0; zeroBasedIndex < 10; ++zeroBasedIndex)
             {
-                var oneBasedIndex = zeroBasedIndex + 1;
-                var targetNumberKey = oneBasedIndex % 10;
+                int oneBasedIndex = zeroBasedIndex + 1;
+                int targetNumberKey = oneBasedIndex % 10;
                 var targetChannel = channels[zeroBasedIndex];
                 AddStep($"Press Alt+{targetNumberKey}", () => pressChannelHotkey(targetNumberKey));
                 AddAssert($"Channel #{oneBasedIndex} is selected", () => currentChannel == targetChannel);
diff --git a/osu.Game.Tests/Visual/Online/TestSceneRankGraph.cs b/osu.Game.Tests/Visual/Online/TestSceneRankGraph.cs
index 5bf9e31309..f577140e17 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneRankGraph.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneRankGraph.cs
@@ -24,10 +24,10 @@ namespace osu.Game.Tests.Visual.Online
         {
             RankGraph graph;
 
-            var data = new int[89];
-            var dataWithZeros = new int[89];
-            var smallData = new int[89];
-            var edgyData = new int[89];
+            int[] data = new int[89];
+            int[] dataWithZeros = new int[89];
+            int[] smallData = new int[89];
+            int[] edgyData = new int[89];
 
             for (int i = 0; i < 89; i++)
                 data[i] = dataWithZeros[i] = (i + 1) * 1000;
diff --git a/osu.Game.Tests/Visual/Online/TestSceneStandAloneChatDisplay.cs b/osu.Game.Tests/Visual/Online/TestSceneStandAloneChatDisplay.cs
index 165fff99dd..b3b8d75c46 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneStandAloneChatDisplay.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneStandAloneChatDisplay.cs
@@ -171,7 +171,7 @@ namespace osu.Game.Tests.Visual.Online
             {
                 var indices = chatDisplay.FillFlow.OfType<DrawableChannel.DaySeparator>().Select(ds => chatDisplay.FillFlow.IndexOf(ds));
 
-                foreach (var i in indices)
+                foreach (int i in indices)
                 {
                     if (i < chatDisplay.FillFlow.Count && chatDisplay.FillFlow[i + 1] is DrawableChannel.DaySeparator)
                         return false;
diff --git a/osu.Game.Tests/Visual/Online/TestSceneWikiHeader.cs b/osu.Game.Tests/Visual/Online/TestSceneWikiHeader.cs
index 08e61d19f4..27e989df76 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneWikiHeader.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneWikiHeader.cs
@@ -75,7 +75,7 @@ namespace osu.Game.Tests.Visual.Online
 
         private bool checkBreadcrumb()
         {
-            var result = header.TabControlItems.Contains(wikiPageData.Value.Title);
+            bool result = header.TabControlItems.Contains(wikiPageData.Value.Title);
 
             if (wikiPageData.Value.Subtitle != null)
                 result = header.TabControlItems.Contains(wikiPageData.Value.Subtitle) && result;
diff --git a/osu.Game.Tests/Visual/Online/TestSceneWikiSidebar.cs b/osu.Game.Tests/Visual/Online/TestSceneWikiSidebar.cs
index b4f1997bb0..862b3667b1 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneWikiSidebar.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneWikiSidebar.cs
@@ -36,7 +36,7 @@ namespace osu.Game.Tests.Visual.Online
         {
             AddStep("Add TOC", () =>
             {
-                for (var i = 0; i < 10; i++)
+                for (int i = 0; i < 10; i++)
                     addTitle($"This is a very long title {i + 1}");
             });
         }
@@ -46,7 +46,7 @@ namespace osu.Game.Tests.Visual.Online
         {
             AddStep("Add TOC", () =>
             {
-                for (var i = 0; i < 10; i++)
+                for (int i = 0; i < 10; i++)
                     addTitle($"This is a very long title {i + 1}", i % 4 != 0);
             });
         }
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneBreadcrumbControlHeader.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneBreadcrumbControlHeader.cs
index 90c3e142df..7bc75f1c44 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneBreadcrumbControlHeader.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneBreadcrumbControlHeader.cs
@@ -31,18 +31,18 @@ namespace osu.Game.Tests.Visual.UserInterface
         [Test]
         public void TestAddAndRemoveItem()
         {
-            foreach (var item in items.Skip(1))
+            foreach (string item in items.Skip(1))
                 AddStep($"Add {item} item", () => header.AddItem(item));
 
-            foreach (var item in items.Reverse().SkipLast(3))
+            foreach (string item in items.Reverse().SkipLast(3))
                 AddStep($"Remove {item} item", () => header.RemoveItem(item));
 
             AddStep("Clear items", () => header.ClearItems());
 
-            foreach (var item in items)
+            foreach (string item in items)
                 AddStep($"Add {item} item", () => header.AddItem(item));
 
-            foreach (var item in items)
+            foreach (string item in items)
                 AddStep($"Remove {item} item", () => header.RemoveItem(item));
         }
 
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneFooterButtonMods.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneFooterButtonMods.cs
index 8d1572769f..0631059d1a 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneFooterButtonMods.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneFooterButtonMods.cs
@@ -73,8 +73,8 @@ namespace osu.Game.Tests.Visual.UserInterface
 
         private bool assertModsMultiplier(IEnumerable<Mod> mods)
         {
-            var multiplier = mods.Aggregate(1.0, (current, mod) => current * mod.ScoreMultiplier);
-            var expectedValue = multiplier.Equals(1.0) ? string.Empty : $"{multiplier:N2}x";
+            double multiplier = mods.Aggregate(1.0, (current, mod) => current * mod.ScoreMultiplier);
+            string expectedValue = multiplier.Equals(1.0) ? string.Empty : $"{multiplier:N2}x";
 
             return expectedValue == footerButtonMods.MultiplierText.Current.Value;
         }
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneOsuIcon.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneOsuIcon.cs
index 096bccae9e..0bc4ac12d6 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneOsuIcon.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneOsuIcon.cs
@@ -48,7 +48,7 @@ namespace osu.Game.Tests.Visual.UserInterface
 
             foreach (var p in typeof(OsuIcon).GetProperties(BindingFlags.Public | BindingFlags.Static))
             {
-                var propValue = p.GetValue(null);
+                object propValue = p.GetValue(null);
                 Debug.Assert(propValue != null);
 
                 flow.Add(new Icon($"{nameof(OsuIcon)}.{p.Name}", (IconUsage)propValue));
diff --git a/osu.Game.Tournament/Components/SongBar.cs b/osu.Game.Tournament/Components/SongBar.cs
index 13888699ef..60be7dec91 100644
--- a/osu.Game.Tournament/Components/SongBar.cs
+++ b/osu.Game.Tournament/Components/SongBar.cs
@@ -101,12 +101,12 @@ namespace osu.Game.Tournament.Components
                 return;
             }
 
-            var bpm = beatmapInfo.BeatmapSet.OnlineInfo.BPM;
-            var length = beatmapInfo.Length;
+            double bpm = beatmapInfo.BeatmapSet.OnlineInfo.BPM;
+            double length = beatmapInfo.Length;
             string hardRockExtra = "";
             string srExtra = "";
 
-            var ar = beatmapInfo.BaseDifficulty.ApproachRate;
+            float ar = beatmapInfo.BaseDifficulty.ApproachRate;
 
             if ((mods & LegacyMods.HardRock) > 0)
             {
@@ -252,9 +252,9 @@ namespace osu.Game.Tournament.Components
                     s.Font = OsuFont.Torus.With(weight: bold ? FontWeight.Bold : FontWeight.Regular, size: 15);
                 }
 
-                for (var i = 0; i < tuples.Length; i++)
+                for (int i = 0; i < tuples.Length; i++)
                 {
-                    var (heading, content) = tuples[i];
+                    (string heading, string content) = tuples[i];
 
                     if (i > 0)
                     {
diff --git a/osu.Game.Tournament/IPC/FileBasedIPC.cs b/osu.Game.Tournament/IPC/FileBasedIPC.cs
index 7010a30eb7..6dde265bd6 100644
--- a/osu.Game.Tournament/IPC/FileBasedIPC.cs
+++ b/osu.Game.Tournament/IPC/FileBasedIPC.cs
@@ -46,7 +46,7 @@ namespace osu.Game.Tournament.IPC
         [BackgroundDependencyLoader]
         private void load()
         {
-            var stablePath = stableInfo.StablePath ?? findStablePath();
+            string stablePath = stableInfo.StablePath ?? findStablePath();
             initialiseIPCStorage(stablePath);
         }
 
@@ -78,8 +78,8 @@ namespace osu.Game.Tournament.IPC
                             using (var stream = IPCStorage.GetStream(file_ipc_filename))
                             using (var sr = new StreamReader(stream))
                             {
-                                var beatmapId = int.Parse(sr.ReadLine().AsNonNull());
-                                var mods = int.Parse(sr.ReadLine().AsNonNull());
+                                int beatmapId = int.Parse(sr.ReadLine().AsNonNull());
+                                int mods = int.Parse(sr.ReadLine().AsNonNull());
 
                                 if (lastBeatmapId != beatmapId)
                                 {
@@ -187,10 +187,10 @@ namespace osu.Game.Tournament.IPC
         [CanBeNull]
         private string findStablePath()
         {
-            var stableInstallPath = findFromEnvVar() ??
-                                    findFromRegistry() ??
-                                    findFromLocalAppData() ??
-                                    findFromDotFolder();
+            string stableInstallPath = findFromEnvVar() ??
+                                       findFromRegistry() ??
+                                       findFromLocalAppData() ??
+                                       findFromDotFolder();
 
             Logger.Log($"Stable path for tourney usage: {stableInstallPath}");
             return stableInstallPath;
diff --git a/osu.Game.Tournament/JsonPointConverter.cs b/osu.Game.Tournament/JsonPointConverter.cs
index 9c82f8ac06..32bbe2dc18 100644
--- a/osu.Game.Tournament/JsonPointConverter.cs
+++ b/osu.Game.Tournament/JsonPointConverter.cs
@@ -40,7 +40,7 @@ namespace osu.Game.Tournament
 
                 if (reader.TokenType == JsonToken.PropertyName)
                 {
-                    var name = reader.Value?.ToString();
+                    string name = reader.Value?.ToString();
                     int? val = reader.ReadAsInt32();
 
                     if (val == null)
diff --git a/osu.Game.Tournament/Models/TournamentTeam.cs b/osu.Game.Tournament/Models/TournamentTeam.cs
index 7074ae413c..d895e4b538 100644
--- a/osu.Game.Tournament/Models/TournamentTeam.cs
+++ b/osu.Game.Tournament/Models/TournamentTeam.cs
@@ -36,10 +36,10 @@ namespace osu.Game.Tournament.Models
         {
             get
             {
-                var ranks = Players.Select(p => p.Statistics?.GlobalRank)
-                                   .Where(i => i.HasValue)
-                                   .Select(i => i.Value)
-                                   .ToArray();
+                int[] ranks = Players.Select(p => p.Statistics?.GlobalRank)
+                                     .Where(i => i.HasValue)
+                                     .Select(i => i.Value)
+                                     .ToArray();
 
                 if (ranks.Length == 0)
                     return 0;
diff --git a/osu.Game.Tournament/Screens/Gameplay/Components/TournamentMatchScoreDisplay.cs b/osu.Game.Tournament/Screens/Gameplay/Components/TournamentMatchScoreDisplay.cs
index 77101e4023..813bed86ae 100644
--- a/osu.Game.Tournament/Screens/Gameplay/Components/TournamentMatchScoreDisplay.cs
+++ b/osu.Game.Tournament/Screens/Gameplay/Components/TournamentMatchScoreDisplay.cs
@@ -114,7 +114,7 @@ namespace osu.Game.Tournament.Screens.Gameplay.Components
             var winningBar = score1.Value > score2.Value ? score1Bar : score2Bar;
             var losingBar = score1.Value <= score2.Value ? score1Bar : score2Bar;
 
-            var diff = Math.Max(score1.Value, score2.Value) - Math.Min(score1.Value, score2.Value);
+            int diff = Math.Max(score1.Value, score2.Value) - Math.Min(score1.Value, score2.Value);
 
             losingBar.ResizeWidthTo(0, 400, Easing.OutQuint);
             winningBar.ResizeWidthTo(Math.Min(0.4f, MathF.Pow(diff / 1500000f, 0.5f) / 2), 400, Easing.OutQuint);
diff --git a/osu.Game.Tournament/Screens/Ladder/Components/DrawableTournamentMatch.cs b/osu.Game.Tournament/Screens/Ladder/Components/DrawableTournamentMatch.cs
index 6937c69dbf..3e950310cf 100644
--- a/osu.Game.Tournament/Screens/Ladder/Components/DrawableTournamentMatch.cs
+++ b/osu.Game.Tournament/Screens/Ladder/Components/DrawableTournamentMatch.cs
@@ -208,7 +208,7 @@ namespace osu.Game.Tournament.Screens.Ladder.Components
         {
             if (Match.Round.Value == null) return;
 
-            var instaWinAmount = Match.Round.Value.BestOf.Value / 2;
+            int instaWinAmount = Match.Round.Value.BestOf.Value / 2;
 
             Match.Completed.Value = Match.Round.Value.BestOf.Value > 0
                                     && (Match.Team1Score.Value + Match.Team2Score.Value >= Match.Round.Value.BestOf.Value || Match.Team1Score.Value > instaWinAmount || Match.Team2Score.Value > instaWinAmount);
@@ -243,8 +243,8 @@ namespace osu.Game.Tournament.Screens.Ladder.Components
             {
                 foreach (var conditional in Match.ConditionalMatches)
                 {
-                    var team1Match = conditional.Acronyms.Contains(Match.Team1Acronym);
-                    var team2Match = conditional.Acronyms.Contains(Match.Team2Acronym);
+                    bool team1Match = conditional.Acronyms.Contains(Match.Team1Acronym);
+                    bool team2Match = conditional.Acronyms.Contains(Match.Team2Acronym);
 
                     if (team1Match && team2Match)
                         Match.Date.Value = conditional.Date.Value;
diff --git a/osu.Game.Tournament/Screens/Ladder/LadderDragContainer.cs b/osu.Game.Tournament/Screens/Ladder/LadderDragContainer.cs
index fa03518c47..f98bfd087d 100644
--- a/osu.Game.Tournament/Screens/Ladder/LadderDragContainer.cs
+++ b/osu.Game.Tournament/Screens/Ladder/LadderDragContainer.cs
@@ -34,7 +34,7 @@ namespace osu.Game.Tournament.Screens.Ladder
 
         protected override bool OnScroll(ScrollEvent e)
         {
-            var newScale = Math.Clamp(scale + e.ScrollDelta.Y / 15 * scale, min_scale, max_scale);
+            float newScale = Math.Clamp(scale + e.ScrollDelta.Y / 15 * scale, min_scale, max_scale);
 
             this.MoveTo(target -= e.MousePosition * (newScale - scale), 2000, Easing.OutQuint);
             this.ScaleTo(scale = newScale, 2000, Easing.OutQuint);
diff --git a/osu.Game.Tournament/Screens/Setup/ResolutionSelector.cs b/osu.Game.Tournament/Screens/Setup/ResolutionSelector.cs
index 4b518ea7c7..e53110651b 100644
--- a/osu.Game.Tournament/Screens/Setup/ResolutionSelector.cs
+++ b/osu.Game.Tournament/Screens/Setup/ResolutionSelector.cs
@@ -31,7 +31,7 @@ namespace osu.Game.Tournament.Screens.Setup
                     return;
 
                 // box contains text
-                if (!int.TryParse(numberBox.Text, out var number))
+                if (!int.TryParse(numberBox.Text, out int number))
                 {
                     // at this point, the only reason we can arrive here is if the input number was too big to parse into an int
                     // so clamp to max allowed value
diff --git a/osu.Game.Tournament/Screens/Setup/StablePathSelectScreen.cs b/osu.Game.Tournament/Screens/Setup/StablePathSelectScreen.cs
index 3752d9d3be..8e9b32231f 100644
--- a/osu.Game.Tournament/Screens/Setup/StablePathSelectScreen.cs
+++ b/osu.Game.Tournament/Screens/Setup/StablePathSelectScreen.cs
@@ -37,7 +37,7 @@ namespace osu.Game.Tournament.Screens.Setup
         private void load(Storage storage, OsuColour colours)
         {
             var initialStorage = (ipc as FileBasedIPC)?.IPCStorage ?? storage;
-            var initialPath = new DirectoryInfo(initialStorage.GetFullPath(string.Empty)).Parent?.FullName;
+            string initialPath = new DirectoryInfo(initialStorage.GetFullPath(string.Empty)).Parent?.FullName;
 
             AddRangeInternal(new Drawable[]
             {
@@ -129,7 +129,7 @@ namespace osu.Game.Tournament.Screens.Setup
 
         protected virtual void ChangePath()
         {
-            var target = directorySelector.CurrentPath.Value.FullName;
+            string target = directorySelector.CurrentPath.Value.FullName;
             var fileBasedIpc = ipc as FileBasedIPC;
             Logger.Log($"Changing Stable CE location to {target}");
 
diff --git a/osu.Game.Tournament/TournamentGame.cs b/osu.Game.Tournament/TournamentGame.cs
index f3927bb852..f03f815b83 100644
--- a/osu.Game.Tournament/TournamentGame.cs
+++ b/osu.Game.Tournament/TournamentGame.cs
@@ -134,7 +134,7 @@ namespace osu.Game.Tournament
 
                     windowSize.BindValueChanged(size => ScheduleAfterChildren(() =>
                     {
-                        var minWidth = (int)(size.NewValue.Height / 768f * TournamentSceneManager.REQUIRED_WIDTH) - 1;
+                        int minWidth = (int)(size.NewValue.Height / 768f * TournamentSceneManager.REQUIRED_WIDTH) - 1;
                         heightWarning.Alpha = size.NewValue.Width < minWidth ? 1 : 0;
                     }), true);
 
diff --git a/osu.Game.Tournament/TournamentGameBase.cs b/osu.Game.Tournament/TournamentGameBase.cs
index a6b0fa5cfc..978be720df 100644
--- a/osu.Game.Tournament/TournamentGameBase.cs
+++ b/osu.Game.Tournament/TournamentGameBase.cs
@@ -109,7 +109,7 @@ namespace osu.Game.Tournament
                 // link matches to rounds
                 foreach (var round in ladder.Rounds)
                 {
-                    foreach (var id in round.Matches)
+                    foreach (int id in round.Matches)
                     {
                         var found = ladder.Matches.FirstOrDefault(p => p.ID == id);
 
diff --git a/osu.Game/Audio/Effects/AudioFilter.cs b/osu.Game/Audio/Effects/AudioFilter.cs
index d2a39e9db7..9446967173 100644
--- a/osu.Game/Audio/Effects/AudioFilter.cs
+++ b/osu.Game/Audio/Effects/AudioFilter.cs
@@ -103,7 +103,7 @@ namespace osu.Game.Audio.Effects
 
             ensureAttached();
 
-            var filterIndex = mixer.Effects.IndexOf(filter);
+            int filterIndex = mixer.Effects.IndexOf(filter);
 
             if (filterIndex < 0) return;
 
diff --git a/osu.Game/Beatmaps/Beatmap.cs b/osu.Game/Beatmaps/Beatmap.cs
index b2211e26cf..98087994b7 100644
--- a/osu.Game/Beatmaps/Beatmap.cs
+++ b/osu.Game/Beatmaps/Beatmap.cs
@@ -93,7 +93,7 @@ namespace osu.Game.Beatmaps
                                     if (t.Time > lastTime)
                                         return (beatLength: t.BeatLength, 0);
 
-                                    var nextTime = i == ControlPointInfo.TimingPoints.Count - 1 ? lastTime : ControlPointInfo.TimingPoints[i + 1].Time;
+                                    double nextTime = i == ControlPointInfo.TimingPoints.Count - 1 ? lastTime : ControlPointInfo.TimingPoints[i + 1].Time;
                                     return (beatLength: t.BeatLength, duration: nextTime - t.Time);
                                 })
                                 // Aggregate durations into a set of (beatLength, duration) tuples for each beat length
diff --git a/osu.Game/Beatmaps/BeatmapInfoExtensions.cs b/osu.Game/Beatmaps/BeatmapInfoExtensions.cs
index 836302c424..c35370d572 100644
--- a/osu.Game/Beatmaps/BeatmapInfoExtensions.cs
+++ b/osu.Game/Beatmaps/BeatmapInfoExtensions.cs
@@ -22,7 +22,7 @@ namespace osu.Game.Beatmaps
 
             if (includeDifficultyName)
             {
-                var versionString = getVersionString(beatmapInfo);
+                string versionString = getVersionString(beatmapInfo);
                 return new RomanisableString($"{metadata.GetPreferred(true)} {versionString}".Trim(), $"{metadata.GetPreferred(false)} {versionString}".Trim());
             }
 
diff --git a/osu.Game/Beatmaps/BeatmapMetadataInfoExtensions.cs b/osu.Game/Beatmaps/BeatmapMetadataInfoExtensions.cs
index ee946eeeec..732b76e967 100644
--- a/osu.Game/Beatmaps/BeatmapMetadataInfoExtensions.cs
+++ b/osu.Game/Beatmaps/BeatmapMetadataInfoExtensions.cs
@@ -37,8 +37,8 @@ namespace osu.Game.Beatmaps
         public static RomanisableString GetDisplayTitleRomanisable(this IBeatmapMetadataInfo metadataInfo)
         {
             string author = string.IsNullOrEmpty(metadataInfo.Author) ? string.Empty : $"({metadataInfo.Author})";
-            var artistUnicode = string.IsNullOrEmpty(metadataInfo.ArtistUnicode) ? metadataInfo.Artist : metadataInfo.ArtistUnicode;
-            var titleUnicode = string.IsNullOrEmpty(metadataInfo.TitleUnicode) ? metadataInfo.Title : metadataInfo.TitleUnicode;
+            string artistUnicode = string.IsNullOrEmpty(metadataInfo.ArtistUnicode) ? metadataInfo.Artist : metadataInfo.ArtistUnicode;
+            string titleUnicode = string.IsNullOrEmpty(metadataInfo.TitleUnicode) ? metadataInfo.Title : metadataInfo.TitleUnicode;
 
             return new RomanisableString($"{artistUnicode} - {titleUnicode} {author}".Trim(), $"{metadataInfo.Artist} - {metadataInfo.Title} {author}".Trim());
         }
diff --git a/osu.Game/Beatmaps/ControlPoints/ControlPointInfo.cs b/osu.Game/Beatmaps/ControlPoints/ControlPointInfo.cs
index 9d738ecbfb..246d1f8af5 100644
--- a/osu.Game/Beatmaps/ControlPoints/ControlPointInfo.cs
+++ b/osu.Game/Beatmaps/ControlPoints/ControlPointInfo.cs
@@ -180,8 +180,8 @@ namespace osu.Game.Beatmaps.ControlPoints
 
         private static double getClosestSnappedTime(TimingControlPoint timingPoint, double time, int beatDivisor)
         {
-            var beatLength = timingPoint.BeatLength / beatDivisor;
-            var beatLengths = (int)Math.Round((time - timingPoint.Time) / beatLength, MidpointRounding.AwayFromZero);
+            double beatLength = timingPoint.BeatLength / beatDivisor;
+            int beatLengths = (int)Math.Round((time - timingPoint.Time) / beatLength, MidpointRounding.AwayFromZero);
 
             return timingPoint.Time + beatLengths * beatLength;
         }
diff --git a/osu.Game/Beatmaps/DifficultyRecommender.cs b/osu.Game/Beatmaps/DifficultyRecommender.cs
index b1b1e58ab7..86f5e0dabf 100644
--- a/osu.Game/Beatmaps/DifficultyRecommender.cs
+++ b/osu.Game/Beatmaps/DifficultyRecommender.cs
@@ -59,12 +59,12 @@ namespace osu.Game.Beatmaps
         {
             foreach (var r in orderedRulesets)
             {
-                if (!recommendedDifficultyMapping.TryGetValue(r, out var recommendation))
+                if (!recommendedDifficultyMapping.TryGetValue(r, out double recommendation))
                     continue;
 
                 BeatmapInfo beatmapInfo = beatmaps.Where(b => b.Ruleset.Equals(r)).OrderBy(b =>
                 {
-                    var difference = b.StarDifficulty - recommendation;
+                    double difference = b.StarDifficulty - recommendation;
                     return difference >= 0 ? difference * 2 : difference * -1; // prefer easier over harder
                 }).FirstOrDefault();
 
diff --git a/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs b/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs
index 7cd4244cd0..89541a0845 100644
--- a/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs
+++ b/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs
@@ -295,7 +295,7 @@ namespace osu.Game.Beatmaps.Formats
 
             writer.WriteLine("[Colours]");
 
-            for (var i = 0; i < colours.Count; i++)
+            for (int i = 0; i < colours.Count; i++)
             {
                 var comboColour = colours[i];
 
diff --git a/osu.Game/Beatmaps/Formats/LegacyDecoder.cs b/osu.Game/Beatmaps/Formats/LegacyDecoder.cs
index cf6c827af5..56525ddb14 100644
--- a/osu.Game/Beatmaps/Formats/LegacyDecoder.cs
+++ b/osu.Game/Beatmaps/Formats/LegacyDecoder.cs
@@ -89,7 +89,7 @@ namespace osu.Game.Beatmaps.Formats
 
         protected string StripComments(string line)
         {
-            var index = line.AsSpan().IndexOf("//".AsSpan());
+            int index = line.AsSpan().IndexOf("//".AsSpan());
             if (index > 0)
                 return line.Substring(0, index);
 
@@ -135,7 +135,7 @@ namespace osu.Game.Beatmaps.Formats
 
         protected KeyValuePair<string, string> SplitKeyVal(string line, char separator = ':')
         {
-            var split = line.Split(separator, 2);
+            string[] split = line.Split(separator, 2);
 
             return new KeyValuePair<string, string>
             (
diff --git a/osu.Game/Beatmaps/Formats/LegacyStoryboardDecoder.cs b/osu.Game/Beatmaps/Formats/LegacyStoryboardDecoder.cs
index 0f15e28c00..90a96e2ac8 100644
--- a/osu.Game/Beatmaps/Formats/LegacyStoryboardDecoder.cs
+++ b/osu.Game/Beatmaps/Formats/LegacyStoryboardDecoder.cs
@@ -77,7 +77,7 @@ namespace osu.Game.Beatmaps.Formats
 
         private void handleEvents(string line)
         {
-            var depth = 0;
+            int depth = 0;
 
             foreach (char c in line)
             {
@@ -104,8 +104,8 @@ namespace osu.Game.Beatmaps.Formats
                 {
                     case LegacyEventType.Video:
                     {
-                        var offset = Parsing.ParseInt(split[1]);
-                        var path = CleanFilename(split[2]);
+                        int offset = Parsing.ParseInt(split[1]);
+                        string path = CleanFilename(split[2]);
 
                         storyboard.GetLayer("Video").Add(new StoryboardVideo(path, offset));
                         break;
@@ -113,11 +113,11 @@ namespace osu.Game.Beatmaps.Formats
 
                     case LegacyEventType.Sprite:
                     {
-                        var layer = parseLayer(split[1]);
+                        string layer = parseLayer(split[1]);
                         var origin = parseOrigin(split[2]);
-                        var path = CleanFilename(split[3]);
-                        var x = Parsing.ParseFloat(split[4], Parsing.MAX_COORDINATE_VALUE);
-                        var y = Parsing.ParseFloat(split[5], Parsing.MAX_COORDINATE_VALUE);
+                        string path = CleanFilename(split[3]);
+                        float x = Parsing.ParseFloat(split[4], Parsing.MAX_COORDINATE_VALUE);
+                        float y = Parsing.ParseFloat(split[5], Parsing.MAX_COORDINATE_VALUE);
                         storyboardSprite = new StoryboardSprite(path, origin, new Vector2(x, y));
                         storyboard.GetLayer(layer).Add(storyboardSprite);
                         break;
@@ -125,13 +125,13 @@ namespace osu.Game.Beatmaps.Formats
 
                     case LegacyEventType.Animation:
                     {
-                        var layer = parseLayer(split[1]);
+                        string layer = parseLayer(split[1]);
                         var origin = parseOrigin(split[2]);
-                        var path = CleanFilename(split[3]);
-                        var x = Parsing.ParseFloat(split[4], Parsing.MAX_COORDINATE_VALUE);
-                        var y = Parsing.ParseFloat(split[5], Parsing.MAX_COORDINATE_VALUE);
-                        var frameCount = Parsing.ParseInt(split[6]);
-                        var frameDelay = Parsing.ParseDouble(split[7]);
+                        string path = CleanFilename(split[3]);
+                        float x = Parsing.ParseFloat(split[4], Parsing.MAX_COORDINATE_VALUE);
+                        float y = Parsing.ParseFloat(split[5], Parsing.MAX_COORDINATE_VALUE);
+                        int frameCount = Parsing.ParseInt(split[6]);
+                        double frameDelay = Parsing.ParseDouble(split[7]);
 
                         if (FormatVersion < 6)
                             // this is random as hell but taken straight from osu-stable.
@@ -145,10 +145,10 @@ namespace osu.Game.Beatmaps.Formats
 
                     case LegacyEventType.Sample:
                     {
-                        var time = Parsing.ParseDouble(split[1]);
-                        var layer = parseLayer(split[2]);
-                        var path = CleanFilename(split[3]);
-                        var volume = split.Length > 4 ? Parsing.ParseFloat(split[4]) : 100;
+                        double time = Parsing.ParseDouble(split[1]);
+                        string layer = parseLayer(split[2]);
+                        string path = CleanFilename(split[3]);
+                        float volume = split.Length > 4 ? Parsing.ParseFloat(split[4]) : 100;
                         storyboard.GetLayer(layer).Add(new StoryboardSampleInfo(path, time, (int)volume));
                         break;
                     }
@@ -159,24 +159,24 @@ namespace osu.Game.Beatmaps.Formats
                 if (depth < 2)
                     timelineGroup = storyboardSprite?.TimelineGroup;
 
-                var commandType = split[0];
+                string commandType = split[0];
 
                 switch (commandType)
                 {
                     case "T":
                     {
-                        var triggerName = split[1];
-                        var startTime = split.Length > 2 ? Parsing.ParseDouble(split[2]) : double.MinValue;
-                        var endTime = split.Length > 3 ? Parsing.ParseDouble(split[3]) : double.MaxValue;
-                        var groupNumber = split.Length > 4 ? Parsing.ParseInt(split[4]) : 0;
+                        string triggerName = split[1];
+                        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);
                         break;
                     }
 
                     case "L":
                     {
-                        var startTime = Parsing.ParseDouble(split[1]);
-                        var repeatCount = Parsing.ParseInt(split[2]);
+                        double startTime = Parsing.ParseDouble(split[1]);
+                        int repeatCount = Parsing.ParseInt(split[2]);
                         timelineGroup = storyboardSprite?.AddLoop(startTime, Math.Max(0, repeatCount - 1));
                         break;
                     }
@@ -187,51 +187,51 @@ namespace osu.Game.Beatmaps.Formats
                             split[3] = split[2];
 
                         var easing = (Easing)Parsing.ParseInt(split[1]);
-                        var startTime = Parsing.ParseDouble(split[2]);
-                        var endTime = Parsing.ParseDouble(split[3]);
+                        double startTime = Parsing.ParseDouble(split[2]);
+                        double endTime = Parsing.ParseDouble(split[3]);
 
                         switch (commandType)
                         {
                             case "F":
                             {
-                                var startValue = Parsing.ParseFloat(split[4]);
-                                var endValue = split.Length > 5 ? Parsing.ParseFloat(split[5]) : startValue;
+                                float startValue = Parsing.ParseFloat(split[4]);
+                                float endValue = split.Length > 5 ? Parsing.ParseFloat(split[5]) : startValue;
                                 timelineGroup?.Alpha.Add(easing, startTime, endTime, startValue, endValue);
                                 break;
                             }
 
                             case "S":
                             {
-                                var startValue = Parsing.ParseFloat(split[4]);
-                                var endValue = split.Length > 5 ? Parsing.ParseFloat(split[5]) : startValue;
+                                float startValue = Parsing.ParseFloat(split[4]);
+                                float endValue = split.Length > 5 ? Parsing.ParseFloat(split[5]) : startValue;
                                 timelineGroup?.Scale.Add(easing, startTime, endTime, startValue, endValue);
                                 break;
                             }
 
                             case "V":
                             {
-                                var startX = Parsing.ParseFloat(split[4]);
-                                var startY = Parsing.ParseFloat(split[5]);
-                                var endX = split.Length > 6 ? Parsing.ParseFloat(split[6]) : startX;
-                                var endY = split.Length > 7 ? Parsing.ParseFloat(split[7]) : startY;
+                                float startX = Parsing.ParseFloat(split[4]);
+                                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));
                                 break;
                             }
 
                             case "R":
                             {
-                                var startValue = Parsing.ParseFloat(split[4]);
-                                var endValue = split.Length > 5 ? Parsing.ParseFloat(split[5]) : startValue;
+                                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));
                                 break;
                             }
 
                             case "M":
                             {
-                                var startX = Parsing.ParseFloat(split[4]);
-                                var startY = Parsing.ParseFloat(split[5]);
-                                var endX = split.Length > 6 ? Parsing.ParseFloat(split[6]) : startX;
-                                var endY = split.Length > 7 ? Parsing.ParseFloat(split[7]) : startY;
+                                float startX = Parsing.ParseFloat(split[4]);
+                                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);
                                 break;
@@ -239,28 +239,28 @@ namespace osu.Game.Beatmaps.Formats
 
                             case "MX":
                             {
-                                var startValue = Parsing.ParseFloat(split[4]);
-                                var endValue = split.Length > 5 ? Parsing.ParseFloat(split[5]) : startValue;
+                                float startValue = Parsing.ParseFloat(split[4]);
+                                float endValue = split.Length > 5 ? Parsing.ParseFloat(split[5]) : startValue;
                                 timelineGroup?.X.Add(easing, startTime, endTime, startValue, endValue);
                                 break;
                             }
 
                             case "MY":
                             {
-                                var startValue = Parsing.ParseFloat(split[4]);
-                                var endValue = split.Length > 5 ? Parsing.ParseFloat(split[5]) : startValue;
+                                float startValue = Parsing.ParseFloat(split[4]);
+                                float endValue = split.Length > 5 ? Parsing.ParseFloat(split[5]) : startValue;
                                 timelineGroup?.Y.Add(easing, startTime, endTime, startValue, endValue);
                                 break;
                             }
 
                             case "C":
                             {
-                                var startRed = Parsing.ParseFloat(split[4]);
-                                var startGreen = Parsing.ParseFloat(split[5]);
-                                var startBlue = Parsing.ParseFloat(split[6]);
-                                var endRed = split.Length > 7 ? Parsing.ParseFloat(split[7]) : startRed;
-                                var endGreen = split.Length > 8 ? Parsing.ParseFloat(split[8]) : startGreen;
-                                var endBlue = split.Length > 9 ? Parsing.ParseFloat(split[9]) : startBlue;
+                                float startRed = Parsing.ParseFloat(split[4]);
+                                float startGreen = Parsing.ParseFloat(split[5]);
+                                float startBlue = Parsing.ParseFloat(split[6]);
+                                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,
                                     new Color4(startRed / 255f, startGreen / 255f, startBlue / 255f, 1),
                                     new Color4(endRed / 255f, endGreen / 255f, endBlue / 255f, 1));
@@ -269,7 +269,7 @@ namespace osu.Game.Beatmaps.Formats
 
                             case "P":
                             {
-                                var type = split[4];
+                                string type = split[4];
 
                                 switch (type)
                                 {
diff --git a/osu.Game/Beatmaps/Formats/Parsing.cs b/osu.Game/Beatmaps/Formats/Parsing.cs
index c4795a6931..4d512fdeed 100644
--- a/osu.Game/Beatmaps/Formats/Parsing.cs
+++ b/osu.Game/Beatmaps/Formats/Parsing.cs
@@ -17,7 +17,7 @@ namespace osu.Game.Beatmaps.Formats
 
         public static float ParseFloat(string input, float parseLimit = (float)MAX_PARSE_VALUE)
         {
-            var output = float.Parse(input, CultureInfo.InvariantCulture);
+            float output = float.Parse(input, CultureInfo.InvariantCulture);
 
             if (output < -parseLimit) throw new OverflowException("Value is too low");
             if (output > parseLimit) throw new OverflowException("Value is too high");
@@ -29,7 +29,7 @@ namespace osu.Game.Beatmaps.Formats
 
         public static double ParseDouble(string input, double parseLimit = MAX_PARSE_VALUE)
         {
-            var output = double.Parse(input, CultureInfo.InvariantCulture);
+            double output = double.Parse(input, CultureInfo.InvariantCulture);
 
             if (output < -parseLimit) throw new OverflowException("Value is too low");
             if (output > parseLimit) throw new OverflowException("Value is too high");
@@ -41,7 +41,7 @@ namespace osu.Game.Beatmaps.Formats
 
         public static int ParseInt(string input, int parseLimit = (int)MAX_PARSE_VALUE)
         {
-            var output = int.Parse(input, CultureInfo.InvariantCulture);
+            int output = int.Parse(input, CultureInfo.InvariantCulture);
 
             if (output < -parseLimit) throw new OverflowException("Value is too low");
             if (output > parseLimit) throw new OverflowException("Value is too high");
diff --git a/osu.Game/Beatmaps/MetadataUtils.cs b/osu.Game/Beatmaps/MetadataUtils.cs
index 56f5e3fe35..b27c59b4de 100644
--- a/osu.Game/Beatmaps/MetadataUtils.cs
+++ b/osu.Game/Beatmaps/MetadataUtils.cs
@@ -35,7 +35,7 @@ namespace osu.Game.Beatmaps
 
             var stringBuilder = new StringBuilder(str.Length);
 
-            foreach (var c in str)
+            foreach (char c in str)
             {
                 if (IsRomanised(c))
                     stringBuilder.Append(c);
diff --git a/osu.Game/Beatmaps/WorkingBeatmapCache.cs b/osu.Game/Beatmaps/WorkingBeatmapCache.cs
index cf83345e2a..65f84984c2 100644
--- a/osu.Game/Beatmaps/WorkingBeatmapCache.cs
+++ b/osu.Game/Beatmaps/WorkingBeatmapCache.cs
@@ -206,7 +206,7 @@ namespace osu.Game.Beatmaps
                     {
                         var decoder = Decoder.GetDecoder<Storyboard>(stream);
 
-                        var storyboardFilename = BeatmapSetInfo?.Files.FirstOrDefault(f => f.Filename.EndsWith(".osb", StringComparison.OrdinalIgnoreCase))?.Filename;
+                        string storyboardFilename = BeatmapSetInfo?.Files.FirstOrDefault(f => f.Filename.EndsWith(".osb", StringComparison.OrdinalIgnoreCase))?.Filename;
 
                         // todo: support loading from both set-wide storyboard *and* beatmap specific.
                         if (string.IsNullOrEmpty(storyboardFilename))
diff --git a/osu.Game/Collections/CollectionManager.cs b/osu.Game/Collections/CollectionManager.cs
index 6f9d9cd8a8..9ff92032b7 100644
--- a/osu.Game/Collections/CollectionManager.cs
+++ b/osu.Game/Collections/CollectionManager.cs
@@ -250,7 +250,7 @@ namespace osu.Game.Collections
         /// </summary>
         private void backgroundSave()
         {
-            var current = Interlocked.Increment(ref lastSave);
+            int current = Interlocked.Increment(ref lastSave);
             Task.Delay(100).ContinueWith(task =>
             {
                 if (current != lastSave)
@@ -270,7 +270,7 @@ namespace osu.Game.Collections
                 // This is NOT thread-safe!!
                 try
                 {
-                    var tempPath = Path.GetTempFileName();
+                    string tempPath = Path.GetTempFileName();
 
                     using (var ms = new MemoryStream())
                     {
@@ -296,8 +296,8 @@ namespace osu.Game.Collections
                         using (var fs = File.OpenWrite(tempPath))
                             ms.WriteTo(fs);
 
-                        var databasePath = storage.GetFullPath(database_name);
-                        var databaseBackupPath = storage.GetFullPath(database_backup_name);
+                        string databasePath = storage.GetFullPath(database_name);
+                        string databaseBackupPath = storage.GetFullPath(database_backup_name);
 
                         // Back up the existing database, clearing any existing backup.
                         if (File.Exists(databaseBackupPath))
diff --git a/osu.Game/Configuration/OsuConfigManager.cs b/osu.Game/Configuration/OsuConfigManager.cs
index 6d37f68473..1beef89b51 100644
--- a/osu.Game/Configuration/OsuConfigManager.cs
+++ b/osu.Game/Configuration/OsuConfigManager.cs
@@ -160,12 +160,12 @@ namespace osu.Game.Configuration
         public void Migrate()
         {
             // arrives as 2020.123.0
-            var rawVersion = Get<string>(OsuSetting.Version);
+            string rawVersion = Get<string>(OsuSetting.Version);
 
             if (rawVersion.Length < 6)
                 return;
 
-            var pieces = rawVersion.Split('.');
+            string[] pieces = rawVersion.Split('.');
 
             // on a fresh install or when coming from a non-release build, execution will end here.
             // we don't want to run migrations in such cases.
diff --git a/osu.Game/Database/ArchiveModelManager.cs b/osu.Game/Database/ArchiveModelManager.cs
index f3ed2d735b..c180edbed2 100644
--- a/osu.Game/Database/ArchiveModelManager.cs
+++ b/osu.Game/Database/ArchiveModelManager.cs
@@ -675,7 +675,7 @@ namespace osu.Game.Database
         {
             MemoryStream hashable = new MemoryStream();
 
-            foreach (var file in reader.Filenames.Where(f => HashableFileTypes.Any(ext => f.EndsWith(ext, StringComparison.OrdinalIgnoreCase))).OrderBy(f => f))
+            foreach (string file in reader.Filenames.Where(f => HashableFileTypes.Any(ext => f.EndsWith(ext, StringComparison.OrdinalIgnoreCase))).OrderBy(f => f))
             {
                 using (Stream s = reader.GetStream(file))
                     s.CopyTo(hashable);
diff --git a/osu.Game/Database/DatabaseBackedStore.cs b/osu.Game/Database/DatabaseBackedStore.cs
index e6b6a0ac2f..a11efba54b 100644
--- a/osu.Game/Database/DatabaseBackedStore.cs
+++ b/osu.Game/Database/DatabaseBackedStore.cs
@@ -27,7 +27,7 @@ namespace osu.Game.Database
 
                 if (context.Entry(obj).State != EntityState.Detached) return;
 
-                var id = obj.ID;
+                int id = obj.ID;
                 var foundObject = lookupSource?.SingleOrDefault(t => t.ID == id) ?? context.Find<T>(id);
                 if (foundObject != null)
                     obj = foundObject;
diff --git a/osu.Game/Database/RealmContextFactory.cs b/osu.Game/Database/RealmContextFactory.cs
index 3d0bb34dc1..ffb1c96261 100644
--- a/osu.Game/Database/RealmContextFactory.cs
+++ b/osu.Game/Database/RealmContextFactory.cs
@@ -156,7 +156,7 @@ namespace osu.Game.Database
 
                 void convertOnlineIDs<T>() where T : RealmObject
                 {
-                    var className = typeof(T).Name.Replace(@"Realm", string.Empty);
+                    string? className = typeof(T).Name.Replace(@"Realm", string.Empty);
 
                     // version was not bumped when the beatmap/ruleset models were added
                     // therefore we must manually check for their presence to avoid throwing on the `DynamicApi` calls.
@@ -170,8 +170,8 @@ namespace osu.Game.Database
 
                     for (int i = 0; i < itemCount; i++)
                     {
-                        var oldItem = oldItems.ElementAt(i);
-                        var newItem = newItems.ElementAt(i);
+                        dynamic? oldItem = oldItems.ElementAt(i);
+                        dynamic? newItem = newItems.ElementAt(i);
 
                         long? nullableOnlineID = oldItem?.OnlineID;
                         newItem.OnlineID = (int)(nullableOnlineID ?? -1);
diff --git a/osu.Game/Database/StableImportManager.cs b/osu.Game/Database/StableImportManager.cs
index 63a6db35c0..fe8c14c085 100644
--- a/osu.Game/Database/StableImportManager.cs
+++ b/osu.Game/Database/StableImportManager.cs
@@ -78,7 +78,7 @@ namespace osu.Game.Database
 
             var taskCompletionSource = new TaskCompletionSource<string>(TaskCreationOptions.RunContinuationsAsynchronously);
             Schedule(() => dialogOverlay.Push(new StableDirectoryLocationDialog(taskCompletionSource)));
-            var stablePath = await taskCompletionSource.Task.ConfigureAwait(false);
+            string stablePath = await taskCompletionSource.Task.ConfigureAwait(false);
 
             return cachedStorage = new StableStorage(stablePath, desktopGameHost);
         }
diff --git a/osu.Game/Database/UserLookupCache.cs b/osu.Game/Database/UserLookupCache.cs
index ff81637efb..3626f5e83a 100644
--- a/osu.Game/Database/UserLookupCache.cs
+++ b/osu.Game/Database/UserLookupCache.cs
@@ -37,7 +37,7 @@ namespace osu.Game.Database
         {
             var userLookupTasks = new List<Task<User>>();
 
-            foreach (var u in userIds)
+            foreach (int u in userIds)
             {
                 userLookupTasks.Add(GetUserAsync(u, token).ContinueWith(task =>
                 {
diff --git a/osu.Game/Graphics/Backgrounds/Triangles.cs b/osu.Game/Graphics/Backgrounds/Triangles.cs
index ab8763e576..450c93f37c 100644
--- a/osu.Game/Graphics/Backgrounds/Triangles.cs
+++ b/osu.Game/Graphics/Backgrounds/Triangles.cs
@@ -214,7 +214,7 @@ namespace osu.Game.Graphics.Backgrounds
             float u1 = 1 - nextRandom(); //uniform(0,1] random floats
             float u2 = 1 - nextRandom();
             float randStdNormal = (float)(Math.Sqrt(-2.0 * Math.Log(u1)) * Math.Sin(2.0 * Math.PI * u2)); // random normal(0,1)
-            var scale = Math.Max(triangleScale * (mean + std_dev * randStdNormal), 0.1f); // random normal(mean,stdDev^2)
+            float scale = Math.Max(triangleScale * (mean + std_dev * randStdNormal), 0.1f); // random normal(mean,stdDev^2)
 
             return new TriangleParticle { Scale = scale };
         }
diff --git a/osu.Game/Graphics/Containers/ConstrainedIconContainer.cs b/osu.Game/Graphics/Containers/ConstrainedIconContainer.cs
index 9d3f342a70..9e1af1944c 100644
--- a/osu.Game/Graphics/Containers/ConstrainedIconContainer.cs
+++ b/osu.Game/Graphics/Containers/ConstrainedIconContainer.cs
@@ -43,7 +43,7 @@ namespace osu.Game.Graphics.Containers
                 // - If we were to use RelativeSize/FillMode, we'd need to set the Icon's RelativeSizeAxes directly.
                 //   We can't do this because we would need access to AutoSizeAxes to set it to none.
                 //   Other issues come up along the way too, so it's not a good solution.
-                var fitScale = Math.Min(DrawSize.X / InternalChild.DrawSize.X, DrawSize.Y / InternalChild.DrawSize.Y);
+                float fitScale = Math.Min(DrawSize.X / InternalChild.DrawSize.X, DrawSize.Y / InternalChild.DrawSize.Y);
                 InternalChild.Scale = new Vector2(fitScale);
                 InternalChild.Anchor = Anchor.Centre;
                 InternalChild.Origin = Anchor.Centre;
diff --git a/osu.Game/Graphics/Containers/LogoTrackingContainer.cs b/osu.Game/Graphics/Containers/LogoTrackingContainer.cs
index dadd7d5240..f89f3a5e76 100644
--- a/osu.Game/Graphics/Containers/LogoTrackingContainer.cs
+++ b/osu.Game/Graphics/Containers/LogoTrackingContainer.cs
@@ -109,7 +109,7 @@ namespace osu.Game.Graphics.Containers
                 {
                     double elapsedDuration = (double)(Time.Current - startTime);
 
-                    var amount = (float)Interpolation.ApplyEasing(easing, Math.Min(elapsedDuration / duration, 1));
+                    float amount = (float)Interpolation.ApplyEasing(easing, Math.Min(elapsedDuration / duration, 1));
 
                     // Interpolate the position of the logo, where amount 0 is where the logo was when it first began interpolating, and amount 1 is the target location.
                     Logo.Position = Vector2.Lerp(startPosition.Value, localPos, amount);
diff --git a/osu.Game/Graphics/Containers/SectionsContainer.cs b/osu.Game/Graphics/Containers/SectionsContainer.cs
index 76492cab55..540ca85809 100644
--- a/osu.Game/Graphics/Containers/SectionsContainer.cs
+++ b/osu.Game/Graphics/Containers/SectionsContainer.cs
@@ -182,7 +182,7 @@ namespace osu.Game.Graphics.Containers
 
         protected override bool OnInvalidate(Invalidation invalidation, InvalidationSource source)
         {
-            var result = base.OnInvalidate(invalidation, source);
+            bool result = base.OnInvalidate(invalidation, source);
 
             if (source == InvalidationSource.Child && (invalidation & Invalidation.DrawSize) != 0)
             {
@@ -240,7 +240,7 @@ namespace osu.Game.Graphics.Containers
                 headerBackgroundContainer.Height = expandableHeaderSize + fixedHeaderSize;
                 headerBackgroundContainer.Y = ExpandableHeader?.Y ?? 0;
 
-                var smallestSectionHeight = Children.Count > 0 ? Children.Min(d => d.Height) : 0;
+                float smallestSectionHeight = Children.Count > 0 ? Children.Min(d => d.Height) : 0;
 
                 // scroll offset is our fixed header height if we have it plus 10% of content height
                 // plus 5% to fix floating point errors and to not have a section instantly unselect when scrolling upwards
diff --git a/osu.Game/Graphics/Containers/SelectionCycleFillFlowContainer.cs b/osu.Game/Graphics/Containers/SelectionCycleFillFlowContainer.cs
index 90b2d20e4d..4ddaa09be6 100644
--- a/osu.Game/Graphics/Containers/SelectionCycleFillFlowContainer.cs
+++ b/osu.Game/Graphics/Containers/SelectionCycleFillFlowContainer.cs
@@ -40,7 +40,7 @@ namespace osu.Game.Graphics.Containers
 
         public void Select(T item)
         {
-            var newIndex = IndexOf(item);
+            int newIndex = IndexOf(item);
 
             if (newIndex < 0)
                 setSelected(null);
diff --git a/osu.Game/Graphics/Cursor/MenuCursor.cs b/osu.Game/Graphics/Cursor/MenuCursor.cs
index fd8f016860..3fa90e2330 100644
--- a/osu.Game/Graphics/Cursor/MenuCursor.cs
+++ b/osu.Game/Graphics/Cursor/MenuCursor.cs
@@ -44,7 +44,7 @@ namespace osu.Game.Graphics.Cursor
             if (dragRotationState != DragRotationState.NotDragging)
             {
                 var position = e.MousePosition;
-                var distance = Vector2Extensions.Distance(position, positionMouseDown);
+                float distance = Vector2Extensions.Distance(position, positionMouseDown);
 
                 // don't start rotating until we're moved a minimum distance away from the mouse down location,
                 // else it can have an annoying effect.
diff --git a/osu.Game/Graphics/ErrorTextFlowContainer.cs b/osu.Game/Graphics/ErrorTextFlowContainer.cs
index f17a2a2c3d..486382bf33 100644
--- a/osu.Game/Graphics/ErrorTextFlowContainer.cs
+++ b/osu.Game/Graphics/ErrorTextFlowContainer.cs
@@ -28,7 +28,7 @@ namespace osu.Game.Graphics
 
             if (errors == null) return;
 
-            foreach (var error in errors)
+            foreach (string error in errors)
                 errorDrawables.AddRange(AddParagraph(error, cp => cp.Colour = Color4.Red));
         }
     }
diff --git a/osu.Game/Graphics/ParticleExplosion.cs b/osu.Game/Graphics/ParticleExplosion.cs
index 094cc87bbe..ec1077eb81 100644
--- a/osu.Game/Graphics/ParticleExplosion.cs
+++ b/osu.Game/Graphics/ParticleExplosion.cs
@@ -89,7 +89,7 @@ namespace osu.Game.Graphics
 
             protected override void Blit(Action<TexturedVertex2D> vertexAction)
             {
-                var time = currentTime - startTime;
+                double time = currentTime - startTime;
 
                 foreach (var p in parts)
                 {
@@ -136,7 +136,7 @@ namespace osu.Game.Graphics
 
             public Vector2 PositionAtTime(double time)
             {
-                var travelledDistance = distance * progressAtTime(time);
+                float travelledDistance = distance * progressAtTime(time);
                 return new Vector2(0.5f) + travelledDistance * new Vector2(MathF.Sin(direction), MathF.Cos(direction));
             }
 
diff --git a/osu.Game/Graphics/ParticleSpewer.cs b/osu.Game/Graphics/ParticleSpewer.cs
index 54a2b1e890..4fc6c4527f 100644
--- a/osu.Game/Graphics/ParticleSpewer.cs
+++ b/osu.Game/Graphics/ParticleSpewer.cs
@@ -109,18 +109,18 @@ namespace osu.Game.Graphics
             {
                 foreach (var p in particles)
                 {
-                    var timeSinceStart = currentTime - p.StartTime;
+                    float timeSinceStart = currentTime - p.StartTime;
 
                     // ignore particles from the future.
                     // these can appear when seeking in replays.
                     if (timeSinceStart < 0) continue;
 
-                    var alpha = p.AlphaAtTime(timeSinceStart);
+                    float alpha = p.AlphaAtTime(timeSinceStart);
                     if (alpha <= 0) continue;
 
                     var pos = p.PositionAtTime(timeSinceStart, gravity, maxDuration);
-                    var scale = p.ScaleAtTime(timeSinceStart);
-                    var angle = p.AngleAtTime(timeSinceStart);
+                    float scale = p.ScaleAtTime(timeSinceStart);
+                    float angle = p.AngleAtTime(timeSinceStart);
 
                     var rect = createDrawRect(pos, scale);
 
@@ -139,8 +139,8 @@ namespace osu.Game.Graphics
 
             private RectangleF createDrawRect(Vector2 position, float scale)
             {
-                var width = Texture.DisplayWidth * scale;
-                var height = Texture.DisplayHeight * scale;
+                float width = Texture.DisplayWidth * scale;
+                float height = Texture.DisplayHeight * scale;
 
                 if (relativePositionAxes.HasFlagFast(Axes.X))
                     position.X *= sourceSize.X;
@@ -188,7 +188,7 @@ namespace osu.Game.Graphics
 
             public Vector2 PositionAtTime(float timeSinceStart, float gravity, float maxDuration)
             {
-                var progress = progressAtTime(timeSinceStart);
+                float progress = progressAtTime(timeSinceStart);
                 var currentGravity = new Vector2(0, gravity * Duration / maxDuration * progress);
 
                 return StartPosition + (Velocity + currentGravity) * timeSinceStart / maxDuration;
diff --git a/osu.Game/Graphics/ScreenshotManager.cs b/osu.Game/Graphics/ScreenshotManager.cs
index e652f07239..1f7f93b3c3 100644
--- a/osu.Game/Graphics/ScreenshotManager.cs
+++ b/osu.Game/Graphics/ScreenshotManager.cs
@@ -147,15 +147,15 @@ namespace osu.Game.Graphics
         private string getFilename()
         {
             var dt = DateTime.Now;
-            var fileExt = screenshotFormat.ToString().ToLowerInvariant();
+            string fileExt = screenshotFormat.ToString().ToLowerInvariant();
 
-            var withoutIndex = $"osu_{dt:yyyy-MM-dd_HH-mm-ss}.{fileExt}";
+            string withoutIndex = $"osu_{dt:yyyy-MM-dd_HH-mm-ss}.{fileExt}";
             if (!storage.Exists(withoutIndex))
                 return withoutIndex;
 
             for (ulong i = 1; i < ulong.MaxValue; i++)
             {
-                var indexedName = $"osu_{dt:yyyy-MM-dd_HH-mm-ss}-{i}.{fileExt}";
+                string indexedName = $"osu_{dt:yyyy-MM-dd_HH-mm-ss}-{i}.{fileExt}";
                 if (!storage.Exists(indexedName))
                     return indexedName;
             }
diff --git a/osu.Game/Graphics/UserInterface/BreadcrumbControl.cs b/osu.Game/Graphics/UserInterface/BreadcrumbControl.cs
index fb5ff4aad3..d06c227d4b 100644
--- a/osu.Game/Graphics/UserInterface/BreadcrumbControl.cs
+++ b/osu.Game/Graphics/UserInterface/BreadcrumbControl.cs
@@ -33,8 +33,8 @@ namespace osu.Game.Graphics.UserInterface
             {
                 foreach (var t in TabContainer.Children.OfType<BreadcrumbTabItem>())
                 {
-                    var tIndex = TabContainer.IndexOf(t);
-                    var tabIndex = TabContainer.IndexOf(TabMap[index.NewValue]);
+                    int tIndex = TabContainer.IndexOf(t);
+                    int tabIndex = TabContainer.IndexOf(TabMap[index.NewValue]);
 
                     t.State = tIndex > tabIndex ? Visibility.Hidden : Visibility.Visible;
                     t.Chevron.FadeTo(tIndex >= tabIndex ? 0f : 1f, 500, Easing.OutQuint);
diff --git a/osu.Game/Graphics/UserInterface/OsuSliderBar.cs b/osu.Game/Graphics/UserInterface/OsuSliderBar.cs
index 6963f7335e..d4310dc901 100644
--- a/osu.Game/Graphics/UserInterface/OsuSliderBar.cs
+++ b/osu.Game/Graphics/UserInterface/OsuSliderBar.cs
@@ -216,10 +216,10 @@ namespace osu.Game.Graphics.UserInterface
                 }
                 else
                 {
-                    var decimalPrecision = normalise(CurrentNumber.Precision.ToDecimal(NumberFormatInfo.InvariantInfo), 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())
-                    var significantDigits = findPrecision(decimalPrecision);
+                    int significantDigits = findPrecision(decimalPrecision);
 
                     TooltipText = floatValue.ToString($"N{significantDigits}");
                 }
diff --git a/osu.Game/Graphics/UserInterface/StarCounter.cs b/osu.Game/Graphics/UserInterface/StarCounter.cs
index 32b788b5dc..b66f371801 100644
--- a/osu.Game/Graphics/UserInterface/StarCounter.cs
+++ b/osu.Game/Graphics/UserInterface/StarCounter.cs
@@ -89,7 +89,7 @@ namespace osu.Game.Graphics.UserInterface
 
         public void ReplayAnimation()
         {
-            var t = current;
+            float t = current;
             ResetCount();
             Current = t;
         }
@@ -105,7 +105,7 @@ namespace osu.Game.Graphics.UserInterface
 
         private void animate(float newValue)
         {
-            for (var i = 0; i < stars.Children.Count; i++)
+            for (int i = 0; i < stars.Children.Count; i++)
             {
                 var star = stars.Children[i];
 
diff --git a/osu.Game/Graphics/UserInterface/TwoLayerButton.cs b/osu.Game/Graphics/UserInterface/TwoLayerButton.cs
index 969309bc79..1f5d29571d 100644
--- a/osu.Game/Graphics/UserInterface/TwoLayerButton.cs
+++ b/osu.Game/Graphics/UserInterface/TwoLayerButton.cs
@@ -236,7 +236,7 @@ namespace osu.Game.Graphics.UserInterface
             {
                 base.OnNewBeat(beatIndex, timingPoint, effectPoint, amplitudes);
 
-                var beatLength = timingPoint.BeatLength;
+                double beatLength = timingPoint.BeatLength;
 
                 float amplitudeAdjust = Math.Min(1, 0.4f + amplitudes.Maximum);
 
diff --git a/osu.Game/IO/LineBufferedReader.cs b/osu.Game/IO/LineBufferedReader.cs
index 018321dc9a..a6b8c9492a 100644
--- a/osu.Game/IO/LineBufferedReader.cs
+++ b/osu.Game/IO/LineBufferedReader.cs
@@ -32,7 +32,7 @@ namespace osu.Game.IO
             if (lineBuffer.Count > 0)
                 return lineBuffer.Peek();
 
-            var line = streamReader.ReadLine();
+            string line = streamReader.ReadLine();
             if (line != null)
                 lineBuffer.Enqueue(line);
             return line;
@@ -50,7 +50,7 @@ namespace osu.Game.IO
         /// </summary>
         public string ReadToEnd()
         {
-            var remainingText = streamReader.ReadToEnd();
+            string remainingText = streamReader.ReadToEnd();
             if (lineBuffer.Count == 0)
                 return remainingText;
 
diff --git a/osu.Game/IO/Serialization/Converters/TypedListConverter.cs b/osu.Game/IO/Serialization/Converters/TypedListConverter.cs
index 174fbf9983..715c83b07e 100644
--- a/osu.Game/IO/Serialization/Converters/TypedListConverter.cs
+++ b/osu.Game/IO/Serialization/Converters/TypedListConverter.cs
@@ -60,7 +60,7 @@ namespace osu.Game.IO.Serialization.Converters
                 if (tok["$type"] == null)
                     throw new JsonException("Expected $type token.");
 
-                var typeName = lookupTable[(int)tok["$type"]];
+                string typeName = lookupTable[(int)tok["$type"]];
                 var instance = (T)Activator.CreateInstance(Type.GetType(typeName).AsNonNull());
                 serializer.Populate(itemReader, instance);
 
@@ -80,7 +80,7 @@ namespace osu.Game.IO.Serialization.Converters
                 var type = item.GetType();
                 var assemblyName = type.Assembly.GetName();
 
-                var typeString = $"{type.FullName}, {assemblyName.Name}";
+                string typeString = $"{type.FullName}, {assemblyName.Name}";
                 if (requiresTypeVersion)
                     typeString += $", {assemblyName.Version}";
 
diff --git a/osu.Game/IO/StableStorage.cs b/osu.Game/IO/StableStorage.cs
index d4b0d300ff..f5a8c4dc9e 100644
--- a/osu.Game/IO/StableStorage.cs
+++ b/osu.Game/IO/StableStorage.cs
@@ -34,7 +34,7 @@ namespace osu.Game.IO
 
         private string locateSongsDirectory()
         {
-            var configFile = GetFiles(".", $"osu!.{Environment.UserName}.cfg").SingleOrDefault();
+            string configFile = GetFiles(".", $"osu!.{Environment.UserName}.cfg").SingleOrDefault();
 
             if (configFile != null)
             {
@@ -47,7 +47,7 @@ namespace osu.Game.IO
                     {
                         if (!line.StartsWith("BeatmapDirectory", StringComparison.OrdinalIgnoreCase)) continue;
 
-                        var customDirectory = line.Split('=').LastOrDefault()?.Trim();
+                        string customDirectory = line.Split('=').LastOrDefault()?.Trim();
                         if (customDirectory != null && Path.IsPathFullyQualified(customDirectory))
                             return customDirectory;
 
diff --git a/osu.Game/IO/WrappedStorage.cs b/osu.Game/IO/WrappedStorage.cs
index aadc4e760b..6f0f898de3 100644
--- a/osu.Game/IO/WrappedStorage.cs
+++ b/osu.Game/IO/WrappedStorage.cs
@@ -60,7 +60,7 @@ namespace osu.Game.IO
         {
             string localRoot = GetFullPath(string.Empty);
 
-            foreach (var path in paths)
+            foreach (string path in paths)
                 yield return Path.GetRelativePath(localRoot, UnderlyingStorage.GetFullPath(path));
         }
 
diff --git a/osu.Game/Input/Bindings/DatabasedKeyBindingContainer.cs b/osu.Game/Input/Bindings/DatabasedKeyBindingContainer.cs
index 10376c1866..5dced23614 100644
--- a/osu.Game/Input/Bindings/DatabasedKeyBindingContainer.cs
+++ b/osu.Game/Input/Bindings/DatabasedKeyBindingContainer.cs
@@ -52,7 +52,7 @@ namespace osu.Game.Input.Bindings
         {
             if (ruleset == null || ruleset.ID.HasValue)
             {
-                var rulesetId = ruleset?.ID;
+                int? rulesetId = ruleset?.ID;
 
                 realmKeyBindings = realmFactory.Context.All<RealmKeyBinding>()
                                                .Where(b => b.RulesetID == rulesetId && b.Variant == variant);
diff --git a/osu.Game/Input/RealmKeyBindingStore.cs b/osu.Game/Input/RealmKeyBindingStore.cs
index 5fa3ccdeb9..c65e36e478 100644
--- a/osu.Game/Input/RealmKeyBindingStore.cs
+++ b/osu.Game/Input/RealmKeyBindingStore.cs
@@ -65,7 +65,7 @@ namespace osu.Game.Input
                 foreach (var ruleset in rulesets)
                 {
                     var instance = ruleset.CreateInstance();
-                    foreach (var variant in instance.AvailableVariants)
+                    foreach (int variant in instance.AvailableVariants)
                         insertDefaults(realm, existingBindings, instance.GetDefaultKeyBindings(variant), ruleset.ID, variant);
                 }
 
diff --git a/osu.Game/Localisation/ResourceManagerLocalisationStore.cs b/osu.Game/Localisation/ResourceManagerLocalisationStore.cs
index 6a4e38fb38..82dc0ad110 100644
--- a/osu.Game/Localisation/ResourceManagerLocalisationStore.cs
+++ b/osu.Game/Localisation/ResourceManagerLocalisationStore.cs
@@ -27,7 +27,7 @@ namespace osu.Game.Localisation
 
         public string Get(string lookup)
         {
-            var split = lookup.Split(':');
+            string[] split = lookup.Split(':');
 
             if (split.Length < 2)
                 return null;
diff --git a/osu.Game/Online/API/APIDownloadRequest.cs b/osu.Game/Online/API/APIDownloadRequest.cs
index 63bb3e2287..11753e05ba 100644
--- a/osu.Game/Online/API/APIDownloadRequest.cs
+++ b/osu.Game/Online/API/APIDownloadRequest.cs
@@ -23,7 +23,7 @@ namespace osu.Game.Online.API
 
         protected override WebRequest CreateWebRequest()
         {
-            var file = Path.GetTempFileName();
+            string file = Path.GetTempFileName();
 
             File.Move(file, filename = Path.ChangeExtension(file, FileExtension));
 
diff --git a/osu.Game/Online/Chat/Channel.cs b/osu.Game/Online/Chat/Channel.cs
index 187a3e5dfc..9b463a6348 100644
--- a/osu.Game/Online/Chat/Channel.cs
+++ b/osu.Game/Online/Chat/Channel.cs
@@ -26,7 +26,7 @@ namespace osu.Game.Online.Chat
         {
             set
             {
-                foreach (var id in value)
+                foreach (int id in value)
                     Users.Add(new User { Id = id });
             }
         }
@@ -131,7 +131,7 @@ namespace osu.Game.Online.Chat
 
             Messages.AddRange(messages);
 
-            var maxMessageId = messages.Max(m => m.Id);
+            long? maxMessageId = messages.Max(m => m.Id);
             if (maxMessageId > LastMessageId)
                 LastMessageId = maxMessageId;
 
diff --git a/osu.Game/Online/Chat/ChannelManager.cs b/osu.Game/Online/Chat/ChannelManager.cs
index 47d5955fb0..52c9387185 100644
--- a/osu.Game/Online/Chat/ChannelManager.cs
+++ b/osu.Game/Online/Chat/ChannelManager.cs
@@ -218,7 +218,7 @@ namespace osu.Game.Online.Chat
             if (target == null)
                 return;
 
-            var parameters = text.Split(' ', 2);
+            string[] parameters = text.Split(' ', 2);
             string command = parameters[0];
             string content = parameters.Length == 2 ? parameters[1] : string.Empty;
 
@@ -306,7 +306,7 @@ namespace osu.Game.Online.Chat
         {
             var req = new ListChannelsRequest();
 
-            var joinDefaults = JoinedChannels.Count == 0;
+            bool joinDefaults = JoinedChannels.Count == 0;
 
             req.Success += channels =>
             {
diff --git a/osu.Game/Online/Chat/MessageFormatter.cs b/osu.Game/Online/Chat/MessageFormatter.cs
index 201ba6239b..5a90638dcd 100644
--- a/osu.Game/Online/Chat/MessageFormatter.cs
+++ b/osu.Game/Online/Chat/MessageFormatter.cs
@@ -70,14 +70,14 @@ namespace osu.Game.Online.Chat
 
             foreach (Match m in regex.Matches(result.Text, startIndex))
             {
-                var index = m.Index - captureOffset;
+                int index = m.Index - captureOffset;
 
-                var displayText = string.Format(display,
+                string? displayText = string.Format(display,
                     m.Groups[0],
                     m.Groups["text"].Value,
                     m.Groups["url"].Value).Trim();
 
-                var linkText = string.Format(link,
+                string linkText = string.Format(link,
                     m.Groups[0],
                     m.Groups["text"].Value,
                     m.Groups["url"].Value).Trim();
@@ -109,9 +109,9 @@ namespace osu.Game.Online.Chat
         {
             foreach (Match m in regex.Matches(result.Text, startIndex))
             {
-                var index = m.Index;
-                var linkText = m.Groups["link"].Value;
-                var indexLength = linkText.Length;
+                int index = m.Index;
+                string? linkText = m.Groups["link"].Value;
+                int indexLength = linkText.Length;
 
                 var details = GetLinkDetails(linkText);
                 var link = new Link(linkText, index, indexLength, details.Action, details.Argument);
@@ -126,7 +126,7 @@ namespace osu.Game.Online.Chat
 
         public static LinkDetails GetLinkDetails(string url)
         {
-            var args = url.Split('/', StringSplitOptions.RemoveEmptyEntries);
+            string[]? args = url.Split('/', StringSplitOptions.RemoveEmptyEntries);
             args[0] = args[0].TrimEnd(':');
 
             switch (args[0])
@@ -136,7 +136,7 @@ namespace osu.Game.Online.Chat
                     // length > 3 since all these links need another argument to work
                     if (args.Length > 3 && args[1].EndsWith(websiteRootUrl, StringComparison.OrdinalIgnoreCase))
                     {
-                        var mainArg = args[3];
+                        string? mainArg = args[3];
 
                         switch (args[2])
                         {
@@ -145,7 +145,7 @@ namespace osu.Game.Online.Chat
                             case "beatmaps":
                             {
                                 string trimmed = mainArg.Split('?').First();
-                                if (int.TryParse(trimmed, out var id))
+                                if (int.TryParse(trimmed, out int id))
                                     return new LinkDetails(LinkAction.OpenBeatmap, id.ToString());
 
                                 break;
@@ -159,7 +159,7 @@ namespace osu.Game.Online.Chat
                                     // handle discussion links externally for now
                                     return new LinkDetails(LinkAction.External, url);
 
-                                if (args.Length > 4 && int.TryParse(args[4], out var id))
+                                if (args.Length > 4 && int.TryParse(args[4], out int id))
                                     // https://osu.ppy.sh/beatmapsets/1154158#osu/2768184
                                     return new LinkDetails(LinkAction.OpenBeatmap, id.ToString());
 
@@ -273,7 +273,7 @@ namespace osu.Game.Online.Chat
             // handle channels
             handleMatches(channel_regex, "{0}", "osu://chan/{0}", result, startIndex, LinkAction.OpenChannel);
 
-            var empty = "";
+            string empty = "";
             while (space-- > 0)
                 empty += "\0";
 
diff --git a/osu.Game/Online/Chat/NowPlayingCommand.cs b/osu.Game/Online/Chat/NowPlayingCommand.cs
index 89eb00a45a..adb3d88df6 100644
--- a/osu.Game/Online/Chat/NowPlayingCommand.cs
+++ b/osu.Game/Online/Chat/NowPlayingCommand.cs
@@ -57,7 +57,7 @@ namespace osu.Game.Online.Chat
                     break;
             }
 
-            var beatmapString = beatmapInfo.OnlineBeatmapID.HasValue ? $"[{api.WebsiteRootUrl}/b/{beatmapInfo.OnlineBeatmapID} {beatmapInfo}]" : beatmapInfo.ToString();
+            string beatmapString = beatmapInfo.OnlineBeatmapID.HasValue ? $"[{api.WebsiteRootUrl}/b/{beatmapInfo.OnlineBeatmapID} {beatmapInfo}]" : beatmapInfo.ToString();
 
             channelManager.PostMessage($"is {verb} {beatmapString}", true, target);
             Expire();
diff --git a/osu.Game/Online/Chat/StandAloneChatDisplay.cs b/osu.Game/Online/Chat/StandAloneChatDisplay.cs
index 6ed2055e65..ede76235b1 100644
--- a/osu.Game/Online/Chat/StandAloneChatDisplay.cs
+++ b/osu.Game/Online/Chat/StandAloneChatDisplay.cs
@@ -85,7 +85,7 @@ namespace osu.Game.Online.Chat
 
         private void postMessage(TextBox sender, bool newtext)
         {
-            var text = Textbox.Text.Trim();
+            string text = Textbox.Text.Trim();
 
             if (string.IsNullOrWhiteSpace(text))
                 return;
diff --git a/osu.Game/Online/Leaderboards/Leaderboard.cs b/osu.Game/Online/Leaderboards/Leaderboard.cs
index e3ac9f603d..515cc6fd73 100644
--- a/osu.Game/Online/Leaderboards/Leaderboard.cs
+++ b/osu.Game/Online/Leaderboards/Leaderboard.cs
@@ -350,8 +350,8 @@ namespace osu.Game.Online.Leaderboards
         {
             base.UpdateAfterChildren();
 
-            var fadeBottom = scrollContainer.Current + scrollContainer.DrawHeight;
-            var fadeTop = scrollContainer.Current + LeaderboardScore.HEIGHT;
+            float fadeBottom = scrollContainer.Current + scrollContainer.DrawHeight;
+            float fadeTop = scrollContainer.Current + LeaderboardScore.HEIGHT;
 
             if (!scrollContainer.IsScrolledToEnd())
                 fadeBottom -= LeaderboardScore.HEIGHT;
@@ -361,8 +361,8 @@ namespace osu.Game.Online.Leaderboards
 
             foreach (var c in scrollFlow.Children)
             {
-                var topY = c.ToSpaceOfOtherDrawable(Vector2.Zero, scrollFlow).Y;
-                var bottomY = topY + LeaderboardScore.HEIGHT;
+                float topY = c.ToSpaceOfOtherDrawable(Vector2.Zero, scrollFlow).Y;
+                float bottomY = topY + LeaderboardScore.HEIGHT;
 
                 bool requireTopFade = FadeTop && topY <= fadeTop;
                 bool requireBottomFade = FadeBottom && bottomY >= fadeBottom;
diff --git a/osu.Game/Online/Rooms/IndexPlaylistScoresRequest.cs b/osu.Game/Online/Rooms/IndexPlaylistScoresRequest.cs
index abce2093e3..bd9f254e1a 100644
--- a/osu.Game/Online/Rooms/IndexPlaylistScoresRequest.cs
+++ b/osu.Game/Online/Rooms/IndexPlaylistScoresRequest.cs
@@ -47,7 +47,7 @@ namespace osu.Game.Online.Rooms
 
                 req.AddCursor(Cursor);
 
-                foreach (var (key, value) in IndexParams.Properties)
+                foreach ((string key, var value) in IndexParams.Properties)
                     req.AddParameter(key, value.ToString());
             }
 
diff --git a/osu.Game/Online/Spectator/SpectatorClient.cs b/osu.Game/Online/Spectator/SpectatorClient.cs
index b597b2f214..f9366674d8 100644
--- a/osu.Game/Online/Spectator/SpectatorClient.cs
+++ b/osu.Game/Online/Spectator/SpectatorClient.cs
@@ -80,7 +80,7 @@ namespace osu.Game.Online.Spectator
                     watchingUsers.Clear();
 
                     // resubscribe to watched users.
-                    foreach (var userId in users)
+                    foreach (int userId in users)
                         WatchUser(userId);
 
                     // re-send state in case it wasn't received
diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index 985451fd6f..304904e776 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -336,7 +336,7 @@ namespace osu.Game
                         ShowChangelogListing();
                     else
                     {
-                        var changelogArgs = link.Argument.Split("/");
+                        string[] changelogArgs = link.Argument.Split("/");
                         ShowChangelogBuild(changelogArgs[0], changelogArgs[1]);
                     }
 
@@ -622,7 +622,7 @@ namespace osu.Game
 
             foreach (var language in Enum.GetValues(typeof(Language)).OfType<Language>())
             {
-                var cultureCode = language.ToCultureCode();
+                string cultureCode = language.ToCultureCode();
 
                 try
                 {
@@ -870,7 +870,7 @@ namespace osu.Game
         {
             if (args?.Length > 0)
             {
-                var paths = args.Where(a => !a.StartsWith('-')).ToArray();
+                string[] paths = args.Where(a => !a.StartsWith('-')).ToArray();
                 if (paths.Length > 0)
                     Task.Run(() => Import(paths));
             }
@@ -913,7 +913,7 @@ namespace osu.Game
                 }
                 else if (recentLogCount == short_term_display_limit)
                 {
-                    var logFile = $@"{entry.Target.ToString().ToLowerInvariant()}.log";
+                    string logFile = $@"{entry.Target.ToString().ToLowerInvariant()}.log";
 
                     Schedule(() => Notifications.Post(new SimpleNotification
                     {
@@ -1059,7 +1059,7 @@ namespace osu.Game
             ScreenOffsetContainer.Padding = new MarginPadding { Top = toolbarOffset };
             overlayOffsetContainer.Padding = new MarginPadding { Top = toolbarOffset };
 
-            var horizontalOffset = 0f;
+            float horizontalOffset = 0f;
 
             // Content.ToLocalSpace() is used instead of this.ToLocalSpace() to correctly calculate the offset with scaling modes active.
             // Content is a child of a scaling container with ScalingMode.Everything set, while the game itself is never scaled.
diff --git a/osu.Game/Overlays/BeatmapSet/BeatmapRulesetTabItem.cs b/osu.Game/Overlays/BeatmapSet/BeatmapRulesetTabItem.cs
index cb258edced..79c95d6646 100644
--- a/osu.Game/Overlays/BeatmapSet/BeatmapRulesetTabItem.cs
+++ b/osu.Game/Overlays/BeatmapSet/BeatmapRulesetTabItem.cs
@@ -64,7 +64,7 @@ namespace osu.Game.Overlays.BeatmapSet
 
             BeatmapSet.BindValueChanged(setInfo =>
             {
-                var beatmapsCount = setInfo.NewValue?.Beatmaps.Count(b => b.Ruleset.Equals(Value)) ?? 0;
+                int beatmapsCount = setInfo.NewValue?.Beatmaps.Count(b => b.Ruleset.Equals(Value)) ?? 0;
 
                 count.Text = beatmapsCount.ToString();
                 countContainer.FadeTo(beatmapsCount > 0 ? 1 : 0);
diff --git a/osu.Game/Overlays/BeatmapSet/Info.cs b/osu.Game/Overlays/BeatmapSet/Info.cs
index 8bc5c6d27e..970e9bbf42 100644
--- a/osu.Game/Overlays/BeatmapSet/Info.cs
+++ b/osu.Game/Overlays/BeatmapSet/Info.cs
@@ -119,7 +119,7 @@ namespace osu.Game.Overlays.BeatmapSet
                 tags.Text = b.NewValue?.Metadata.Tags ?? string.Empty;
                 genre.Text = b.NewValue?.OnlineInfo?.Genre.Name ?? string.Empty;
                 language.Text = b.NewValue?.OnlineInfo?.Language.Name ?? string.Empty;
-                var setHasLeaderboard = b.NewValue?.OnlineInfo?.Status > 0;
+                bool setHasLeaderboard = b.NewValue?.OnlineInfo?.Status > 0;
                 successRate.Alpha = setHasLeaderboard ? 1 : 0;
                 notRankedPlaceholder.Alpha = setHasLeaderboard ? 0 : 1;
                 Height = setHasLeaderboard ? 270 : base_height;
diff --git a/osu.Game/Overlays/BeatmapSet/Scores/ScoreTableRowBackground.cs b/osu.Game/Overlays/BeatmapSet/Scores/ScoreTableRowBackground.cs
index d84e1eff8c..b6079b36ab 100644
--- a/osu.Game/Overlays/BeatmapSet/Scores/ScoreTableRowBackground.cs
+++ b/osu.Game/Overlays/BeatmapSet/Scores/ScoreTableRowBackground.cs
@@ -50,7 +50,7 @@ namespace osu.Game.Overlays.BeatmapSet.Scores
         [BackgroundDependencyLoader]
         private void load(OsuColour colours, OverlayColourProvider colourProvider, IAPIProvider api)
         {
-            var isOwnScore = api.LocalUser.Value.Id == score.UserID;
+            bool isOwnScore = api.LocalUser.Value.Id == score.UserID;
 
             if (isOwnScore)
                 background.Colour = colours.GreenDarker;
diff --git a/osu.Game/Overlays/BeatmapSet/SuccessRate.cs b/osu.Game/Overlays/BeatmapSet/SuccessRate.cs
index 604c4e1949..40a3c9fe8b 100644
--- a/osu.Game/Overlays/BeatmapSet/SuccessRate.cs
+++ b/osu.Game/Overlays/BeatmapSet/SuccessRate.cs
@@ -43,7 +43,7 @@ namespace osu.Game.Overlays.BeatmapSet
             int passCount = beatmapInfo?.OnlineInfo?.PassCount ?? 0;
             int playCount = beatmapInfo?.OnlineInfo?.PlayCount ?? 0;
 
-            var rate = playCount != 0 ? (float)passCount / playCount : 0;
+            float rate = playCount != 0 ? (float)passCount / playCount : 0;
             successPercent.Text = rate.ToLocalisableString(@"0.#%");
             successRate.Length = rate;
             percentContainer.ResizeWidthTo(successRate.Length, 250, Easing.InOutCubic);
diff --git a/osu.Game/Overlays/ChatOverlay.cs b/osu.Game/Overlays/ChatOverlay.cs
index 4b27335c7c..cc3ce63bf7 100644
--- a/osu.Game/Overlays/ChatOverlay.cs
+++ b/osu.Game/Overlays/ChatOverlay.cs
@@ -479,7 +479,7 @@ namespace osu.Game.Overlays
 
         private void postMessage(TextBox textbox, bool newText)
         {
-            var text = textbox.Text.Trim();
+            string text = textbox.Text.Trim();
 
             if (string.IsNullOrWhiteSpace(text))
                 return;
diff --git a/osu.Game/Overlays/Comments/CommentMarkdownContainer.cs b/osu.Game/Overlays/Comments/CommentMarkdownContainer.cs
index aeab292b0d..3971a61363 100644
--- a/osu.Game/Overlays/Comments/CommentMarkdownContainer.cs
+++ b/osu.Game/Overlays/Comments/CommentMarkdownContainer.cs
@@ -29,7 +29,7 @@ namespace osu.Game.Overlays.Comments
 
             protected override float GetFontSizeByLevel(int level)
             {
-                var defaultFontSize = base.GetFontSizeByLevel(6);
+                float defaultFontSize = base.GetFontSizeByLevel(6);
 
                 switch (level)
                 {
diff --git a/osu.Game/Overlays/Comments/DrawableComment.cs b/osu.Game/Overlays/Comments/DrawableComment.cs
index a44f3a7643..43f4177bd0 100644
--- a/osu.Game/Overlays/Comments/DrawableComment.cs
+++ b/osu.Game/Overlays/Comments/DrawableComment.cs
@@ -362,8 +362,8 @@ namespace osu.Game.Overlays.Comments
 
         private void updateButtonsState()
         {
-            var loadedReplesCount = loadedReplies.Count;
-            var hasUnloadedReplies = loadedReplesCount != Comment.RepliesCount;
+            int loadedReplesCount = loadedReplies.Count;
+            bool hasUnloadedReplies = loadedReplesCount != Comment.RepliesCount;
 
             loadRepliesButton.FadeTo(hasUnloadedReplies && loadedReplesCount == 0 ? 1 : 0);
             showMoreButton.FadeTo(hasUnloadedReplies && loadedReplesCount > 0 ? 1 : 0);
diff --git a/osu.Game/Overlays/Comments/VotePill.cs b/osu.Game/Overlays/Comments/VotePill.cs
index cf3c470f96..093cdce66e 100644
--- a/osu.Game/Overlays/Comments/VotePill.cs
+++ b/osu.Game/Overlays/Comments/VotePill.cs
@@ -67,7 +67,7 @@ namespace osu.Game.Overlays.Comments
             AccentColour = borderContainer.BorderColour = sideNumber.Colour = colours.GreenLight;
             hoverLayer.Colour = Color4.Black.Opacity(0.5f);
 
-            var ownComment = api.LocalUser.Value.Id == comment.UserId;
+            bool ownComment = api.LocalUser.Value.Id == comment.UserId;
 
             if (!ownComment)
                 Action = onAction;
diff --git a/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs b/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs
index 3051ca7dbe..454dd500fe 100644
--- a/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs
+++ b/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs
@@ -61,7 +61,7 @@ namespace osu.Game.Overlays.Dashboard
             switch (e.Action)
             {
                 case NotifyCollectionChangedAction.Add:
-                    foreach (var id in e.NewItems.OfType<int>().ToArray())
+                    foreach (int id in e.NewItems.OfType<int>().ToArray())
                     {
                         users.GetUserAsync(id).ContinueWith(u =>
                         {
@@ -81,7 +81,7 @@ namespace osu.Game.Overlays.Dashboard
                     break;
 
                 case NotifyCollectionChangedAction.Remove:
-                    foreach (var u in e.OldItems.OfType<int>())
+                    foreach (int u in e.OldItems.OfType<int>())
                         userFlow.FirstOrDefault(card => card.User.Id == u)?.Expire();
                     break;
 
diff --git a/osu.Game/Overlays/Dashboard/Friends/FriendOnlineStreamControl.cs b/osu.Game/Overlays/Dashboard/Friends/FriendOnlineStreamControl.cs
index 28546ceab8..d7f66e35b5 100644
--- a/osu.Game/Overlays/Dashboard/Friends/FriendOnlineStreamControl.cs
+++ b/osu.Game/Overlays/Dashboard/Friends/FriendOnlineStreamControl.cs
@@ -15,8 +15,8 @@ namespace osu.Game.Overlays.Dashboard.Friends
         {
             Clear();
 
-            var userCount = users.Count;
-            var onlineUsersCount = users.Count(user => user.IsOnline);
+            int userCount = users.Count;
+            int onlineUsersCount = users.Count(user => user.IsOnline);
 
             AddItem(new FriendStream(OnlineStatus.All, userCount));
             AddItem(new FriendStream(OnlineStatus.Online, onlineUsersCount));
diff --git a/osu.Game/Overlays/HoldToConfirmOverlay.cs b/osu.Game/Overlays/HoldToConfirmOverlay.cs
index 0542f66b5b..cb6275bd7c 100644
--- a/osu.Game/Overlays/HoldToConfirmOverlay.cs
+++ b/osu.Game/Overlays/HoldToConfirmOverlay.cs
@@ -49,7 +49,7 @@ namespace osu.Game.Overlays
 
             Progress.ValueChanged += p =>
             {
-                var target = p.NewValue * finalFillAlpha;
+                double target = p.NewValue * finalFillAlpha;
 
                 audioVolume.Value = 1 - target;
                 overlay.Alpha = (float)target;
diff --git a/osu.Game/Overlays/Mods/ModSection.cs b/osu.Game/Overlays/Mods/ModSection.cs
index faad23a4e1..5bf8cddd0c 100644
--- a/osu.Game/Overlays/Mods/ModSection.cs
+++ b/osu.Game/Overlays/Mods/ModSection.cs
@@ -96,7 +96,7 @@ namespace osu.Game.Overlays.Mods
 
             if (ToggleKeys != null)
             {
-                var index = Array.IndexOf(ToggleKeys, e.Key);
+                int index = Array.IndexOf(ToggleKeys, e.Key);
                 if (index > -1 && index < Buttons.Count)
                     Buttons[index].SelectNext(e.ShiftPressed ? -1 : 1);
             }
@@ -196,7 +196,7 @@ namespace osu.Game.Overlays.Mods
         {
             foreach (var mod in newSelectedMods)
             {
-                var index = Array.FindIndex(button.Mods, m1 => mod.GetType() == m1.GetType());
+                int index = Array.FindIndex(button.Mods, m1 => mod.GetType() == m1.GetType());
                 if (index < 0)
                     continue;
 
diff --git a/osu.Game/Overlays/MusicController.cs b/osu.Game/Overlays/MusicController.cs
index 8fd50c3df2..97c7aaeaeb 100644
--- a/osu.Game/Overlays/MusicController.cs
+++ b/osu.Game/Overlays/MusicController.cs
@@ -238,7 +238,7 @@ namespace osu.Game.Overlays
             if (beatmap.Disabled)
                 return PreviousTrackResult.None;
 
-            var currentTrackPosition = CurrentTrack.CurrentTime;
+            double currentTrackPosition = CurrentTrack.CurrentTime;
 
             if (currentTrackPosition >= restart_cutoff_point)
             {
@@ -329,8 +329,8 @@ namespace osu.Game.Overlays
                 else
                 {
                     // figure out the best direction based on order in playlist.
-                    var last = BeatmapSets.TakeWhile(b => b.ID != current.BeatmapSetInfo?.ID).Count();
-                    var next = newWorking == null ? -1 : BeatmapSets.TakeWhile(b => b.ID != newWorking.BeatmapSetInfo?.ID).Count();
+                    int last = BeatmapSets.TakeWhile(b => b.ID != current.BeatmapSetInfo?.ID).Count();
+                    int next = newWorking == null ? -1 : BeatmapSets.TakeWhile(b => b.ID != newWorking.BeatmapSetInfo?.ID).Count();
 
                     direction = last > next ? TrackChangeDirection.Prev : TrackChangeDirection.Next;
                 }
diff --git a/osu.Game/Overlays/News/Sidebar/NewsSidebar.cs b/osu.Game/Overlays/News/Sidebar/NewsSidebar.cs
index 35cd6eb03b..fe965385d8 100644
--- a/osu.Game/Overlays/News/Sidebar/NewsSidebar.cs
+++ b/osu.Game/Overlays/News/Sidebar/NewsSidebar.cs
@@ -61,11 +61,11 @@ namespace osu.Game.Overlays.News.Sidebar
             var keys = lookup.Select(kvp => kvp.Key);
             var sortedKeys = keys.OrderByDescending(k => k).ToList();
 
-            var year = metadata.NewValue.CurrentYear;
+            int year = metadata.NewValue.CurrentYear;
 
             for (int i = 0; i < sortedKeys.Count; i++)
             {
-                var month = sortedKeys[i];
+                int month = sortedKeys[i];
                 var posts = lookup[month];
 
                 monthsFlow.Add(new MonthSection(month, year, posts)
diff --git a/osu.Game/Overlays/News/Sidebar/YearsPanel.cs b/osu.Game/Overlays/News/Sidebar/YearsPanel.cs
index b07c9924b9..58c0f6ac82 100644
--- a/osu.Game/Overlays/News/Sidebar/YearsPanel.cs
+++ b/osu.Game/Overlays/News/Sidebar/YearsPanel.cs
@@ -69,9 +69,9 @@ namespace osu.Game.Overlays.News.Sidebar
                 return;
             }
 
-            var currentYear = metadata.Value.CurrentYear;
+            int currentYear = metadata.Value.CurrentYear;
 
-            foreach (var y in metadata.Value.Years)
+            foreach (int y in metadata.Value.Years)
                 yearsFlow.Add(new YearButton(y, y == currentYear));
 
             Show();
diff --git a/osu.Game/Overlays/Profile/Header/Components/PreviousUsernames.cs b/osu.Game/Overlays/Profile/Header/Components/PreviousUsernames.cs
index 14eeb4e5f0..b1076ba39b 100644
--- a/osu.Game/Overlays/Profile/Header/Components/PreviousUsernames.cs
+++ b/osu.Game/Overlays/Profile/Header/Components/PreviousUsernames.cs
@@ -111,7 +111,7 @@ namespace osu.Game.Overlays.Profile.Header.Components
         {
             text.Text = string.Empty;
 
-            var usernames = user.NewValue?.PreviousUsernames;
+            string[] usernames = user.NewValue?.PreviousUsernames;
 
             if (usernames?.Any() ?? false)
             {
diff --git a/osu.Game/Overlays/Profile/Header/Components/RankGraph.cs b/osu.Game/Overlays/Profile/Header/Components/RankGraph.cs
index ca5f26e375..d6e515d8a1 100644
--- a/osu.Game/Overlays/Profile/Header/Components/RankGraph.cs
+++ b/osu.Game/Overlays/Profile/Header/Components/RankGraph.cs
@@ -62,7 +62,7 @@ namespace osu.Game.Overlays.Profile.Header.Components
 
         protected override UserGraphTooltipContent GetTooltipContent(int index, int rank)
         {
-            var days = ranked_days - index + 1;
+            int days = ranked_days - index + 1;
 
             return new UserGraphTooltipContent(
                 UsersStrings.ShowRankGlobalSimple,
diff --git a/osu.Game/Overlays/Profile/Header/MedalHeaderContainer.cs b/osu.Game/Overlays/Profile/Header/MedalHeaderContainer.cs
index e7df4eb5eb..f6419db540 100644
--- a/osu.Game/Overlays/Profile/Header/MedalHeaderContainer.cs
+++ b/osu.Game/Overlays/Profile/Header/MedalHeaderContainer.cs
@@ -72,7 +72,7 @@ namespace osu.Game.Overlays.Profile.Header
             {
                 Show();
 
-                for (var index = 0; index < badges.Length; index++)
+                for (int index = 0; index < badges.Length; index++)
                 {
                     int displayIndex = index;
                     LoadComponentAsync(new DrawableBadge(badges[index]), asyncBadge =>
diff --git a/osu.Game/Overlays/Profile/Sections/Historical/ProfileLineChart.cs b/osu.Game/Overlays/Profile/Sections/Historical/ProfileLineChart.cs
index a75235359a..d402438376 100644
--- a/osu.Game/Overlays/Profile/Sections/Historical/ProfileLineChart.cs
+++ b/osu.Game/Overlays/Profile/Sections/Historical/ProfileLineChart.cs
@@ -116,10 +116,10 @@ namespace osu.Game.Overlays.Profile.Sections.Historical
             rowTicksContainer.Clear();
             rowLinesContainer.Clear();
 
-            var min = values.Select(v => v.Count).Min();
-            var max = values.Select(v => v.Count).Max();
+            long min = values.Select(v => v.Count).Min();
+            long max = values.Select(v => v.Count).Max();
 
-            var tickInterval = getTickInterval(max - min, 6);
+            long tickInterval = getTickInterval(max - min, 6);
 
             for (long currentTick = 0; currentTick <= max; currentTick += tickInterval)
             {
@@ -145,7 +145,7 @@ namespace osu.Game.Overlays.Profile.Sections.Historical
             columnTicksContainer.Clear();
             columnLinesContainer.Clear();
 
-            var totalMonths = values.Length;
+            int totalMonths = values.Length;
 
             int monthsPerTick = 1;
 
@@ -158,7 +158,7 @@ namespace osu.Game.Overlays.Profile.Sections.Historical
 
             for (int i = 0; i < totalMonths; i += monthsPerTick)
             {
-                var x = (float)i / (totalMonths - 1);
+                float x = (float)i / (totalMonths - 1);
                 addColumnTick(x, values[i].Date);
             }
         }
@@ -215,15 +215,15 @@ namespace osu.Game.Overlays.Profile.Sections.Historical
         {
             // this interval is what would be achieved if the interval was divided perfectly evenly into maxTicksCount ticks.
             // can contain ugly fractional parts.
-            var exactTickInterval = (float)range / (maxTicksCount - 1);
+            float exactTickInterval = (float)range / (maxTicksCount - 1);
 
             // the ideal ticks start with a 1, 2 or 5, and are multipliers of powers of 10.
             // first off, use log10 to calculate the number of digits in the "exact" interval.
-            var numberOfDigits = Math.Floor(Math.Log10(exactTickInterval));
-            var tickBase = Math.Pow(10, numberOfDigits);
+            double numberOfDigits = Math.Floor(Math.Log10(exactTickInterval));
+            double tickBase = Math.Pow(10, numberOfDigits);
 
             // then see how the exact tick relates to the power of 10.
-            var exactTickMultiplier = exactTickInterval / tickBase;
+            double exactTickMultiplier = exactTickInterval / tickBase;
 
             double tickMultiplier;
 
diff --git a/osu.Game/Overlays/Settings/Sections/Audio/AudioDevicesSettings.cs b/osu.Game/Overlays/Settings/Sections/Audio/AudioDevicesSettings.cs
index 0c54ae2763..858d555f06 100644
--- a/osu.Game/Overlays/Settings/Sections/Audio/AudioDevicesSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Audio/AudioDevicesSettings.cs
@@ -47,7 +47,7 @@ namespace osu.Game.Overlays.Settings.Sections.Audio
             var deviceItems = new List<string> { string.Empty };
             deviceItems.AddRange(audio.AudioDeviceNames);
 
-            var preferredDeviceName = audio.AudioDevice.Value;
+            string preferredDeviceName = audio.AudioDevice.Value;
             if (deviceItems.All(kv => kv != preferredDeviceName))
                 deviceItems.Add(preferredDeviceName);
 
diff --git a/osu.Game/Overlays/Settings/Sections/Input/KeyBindingsSubsection.cs b/osu.Game/Overlays/Settings/Sections/Input/KeyBindingsSubsection.cs
index 2051af6f3c..be0830a7c2 100644
--- a/osu.Game/Overlays/Settings/Sections/Input/KeyBindingsSubsection.cs
+++ b/osu.Game/Overlays/Settings/Sections/Input/KeyBindingsSubsection.cs
@@ -32,7 +32,7 @@ namespace osu.Game.Overlays.Settings.Sections.Input
         [BackgroundDependencyLoader]
         private void load(RealmContextFactory realmFactory)
         {
-            var rulesetId = Ruleset?.ID;
+            int? rulesetId = Ruleset?.ID;
 
             List<RealmKeyBinding> bindings;
 
diff --git a/osu.Game/Overlays/Settings/Sections/Input/MouseSettings.cs b/osu.Game/Overlays/Settings/Sections/Input/MouseSettings.cs
index a4da17c5cd..0334167759 100644
--- a/osu.Game/Overlays/Settings/Sections/Input/MouseSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Input/MouseSettings.cs
@@ -86,7 +86,7 @@ namespace osu.Game.Overlays.Settings.Sections.Input
 
             handlerSensitivity.BindValueChanged(val =>
             {
-                var disabled = localSensitivity.Disabled;
+                bool disabled = localSensitivity.Disabled;
 
                 localSensitivity.Disabled = false;
                 localSensitivity.Value = val.NewValue;
@@ -97,7 +97,7 @@ namespace osu.Game.Overlays.Settings.Sections.Input
 
             windowMode.BindValueChanged(mode =>
             {
-                var isFullscreen = mode.NewValue == WindowMode.Fullscreen;
+                bool isFullscreen = mode.NewValue == WindowMode.Fullscreen;
 
                 if (isFullscreen)
                 {
diff --git a/osu.Game/Overlays/Settings/Sections/Input/RotationPresetButtons.cs b/osu.Game/Overlays/Settings/Sections/Input/RotationPresetButtons.cs
index 3ef5ce8941..dbdf600002 100644
--- a/osu.Game/Overlays/Settings/Sections/Input/RotationPresetButtons.cs
+++ b/osu.Game/Overlays/Settings/Sections/Input/RotationPresetButtons.cs
@@ -59,7 +59,7 @@ namespace osu.Game.Overlays.Settings.Sections.Input
 
             for (int i = 0; i < preset_count; i++)
             {
-                var rotationValue = i * 90;
+                int rotationValue = i * 90;
 
                 var rotationPreset = new RotationButton(rotationValue)
                 {
diff --git a/osu.Game/Overlays/Settings/Sections/Input/RulesetBindingsSection.cs b/osu.Game/Overlays/Settings/Sections/Input/RulesetBindingsSection.cs
index 5246051a4a..48cbe1b59e 100644
--- a/osu.Game/Overlays/Settings/Sections/Input/RulesetBindingsSection.cs
+++ b/osu.Game/Overlays/Settings/Sections/Input/RulesetBindingsSection.cs
@@ -26,7 +26,7 @@ namespace osu.Game.Overlays.Settings.Sections.Input
 
             var r = ruleset.CreateInstance();
 
-            foreach (var variant in r.AvailableVariants)
+            foreach (int variant in r.AvailableVariants)
                 Add(new VariantBindingsSubsection(ruleset, variant));
         }
     }
diff --git a/osu.Game/Overlays/Settings/Sections/SkinSection.cs b/osu.Game/Overlays/Settings/Sections/SkinSection.cs
index 00198235c5..cf5d70ba91 100644
--- a/osu.Game/Overlays/Settings/Sections/SkinSection.cs
+++ b/osu.Game/Overlays/Settings/Sections/SkinSection.cs
@@ -45,7 +45,7 @@ namespace osu.Game.Overlays.Settings.Sections
         {
             get
             {
-                var index = skinItems.FindIndex(s => s.ID > 0);
+                int index = skinItems.FindIndex(s => s.ID > 0);
                 if (index < 0)
                     index = skinItems.Count;
 
diff --git a/osu.Game/Overlays/Settings/SettingsNumberBox.cs b/osu.Game/Overlays/Settings/SettingsNumberBox.cs
index aca7a210b3..545f1050b2 100644
--- a/osu.Game/Overlays/Settings/SettingsNumberBox.cs
+++ b/osu.Game/Overlays/Settings/SettingsNumberBox.cs
@@ -46,7 +46,7 @@ namespace osu.Game.Overlays.Settings
                 {
                     int? value = null;
 
-                    if (int.TryParse(e.NewValue, out var intVal))
+                    if (int.TryParse(e.NewValue, out int intVal))
                         value = intVal;
 
                     current.Value = value;
diff --git a/osu.Game/Overlays/TabControlOverlayHeader.cs b/osu.Game/Overlays/TabControlOverlayHeader.cs
index e6f7e250a7..1b0bd658d9 100644
--- a/osu.Game/Overlays/TabControlOverlayHeader.cs
+++ b/osu.Game/Overlays/TabControlOverlayHeader.cs
@@ -111,7 +111,7 @@ namespace osu.Game.Overlays
                     else
                     {
                         var localisableDescription = enumValue.GetLocalisableDescription();
-                        var nonLocalisableDescription = enumValue.GetDescription();
+                        string nonLocalisableDescription = enumValue.GetDescription();
 
                         // If localisable == non-localisable, then we must have a basic string, so .ToLower() is used.
                         Text.Text = localisableDescription.Equals(nonLocalisableDescription)
diff --git a/osu.Game/Overlays/Toolbar/ToolbarButton.cs b/osu.Game/Overlays/Toolbar/ToolbarButton.cs
index dd554200ca..ab37b3b355 100644
--- a/osu.Game/Overlays/Toolbar/ToolbarButton.cs
+++ b/osu.Game/Overlays/Toolbar/ToolbarButton.cs
@@ -207,7 +207,7 @@ namespace osu.Game.Overlays.Toolbar
 
             if (realmKeyBinding != null)
             {
-                var keyBindingString = realmKeyBinding.KeyCombination.ReadableString();
+                string keyBindingString = realmKeyBinding.KeyCombination.ReadableString();
 
                 if (!string.IsNullOrEmpty(keyBindingString))
                     keyBindingTooltip.Text = $" ({keyBindingString})";
diff --git a/osu.Game/Overlays/Volume/VolumeMeter.cs b/osu.Game/Overlays/Volume/VolumeMeter.cs
index ff28b45ebb..e2afd46c18 100644
--- a/osu.Game/Overlays/Volume/VolumeMeter.cs
+++ b/osu.Game/Overlays/Volume/VolumeMeter.cs
@@ -325,7 +325,7 @@ namespace osu.Game.Overlays.Volume
             delta *= accelerationModifier;
             accelerationModifier = Math.Min(max_acceleration, accelerationModifier * acceleration_multiplier);
 
-            var precision = Bindable.Precision;
+            double precision = Bindable.Precision;
 
             if (isPrecise)
             {
diff --git a/osu.Game/Overlays/Wiki/Markdown/WikiNoticeContainer.cs b/osu.Game/Overlays/Wiki/Markdown/WikiNoticeContainer.cs
index 421806eea8..a22c18b0a4 100644
--- a/osu.Game/Overlays/Wiki/Markdown/WikiNoticeContainer.cs
+++ b/osu.Game/Overlays/Wiki/Markdown/WikiNoticeContainer.cs
@@ -22,7 +22,7 @@ namespace osu.Game.Overlays.Wiki.Markdown
             AutoSizeAxes = Axes.Y;
             Direction = FillDirection.Vertical;
 
-            foreach (var line in yamlFrontMatterBlock.Lines)
+            foreach (object line in yamlFrontMatterBlock.Lines)
             {
                 switch (line.ToString())
                 {
diff --git a/osu.Game/Overlays/Wiki/WikiMainPage.cs b/osu.Game/Overlays/Wiki/WikiMainPage.cs
index c9ee2cbfd5..9416ec77f1 100644
--- a/osu.Game/Overlays/Wiki/WikiMainPage.cs
+++ b/osu.Game/Overlays/Wiki/WikiMainPage.cs
@@ -72,11 +72,11 @@ namespace osu.Game.Overlays.Wiki
 
             Debug.Assert(panelsNode.Length > 1);
 
-            var i = 0;
+            int i = 0;
 
             while (i < panelsNode.Length)
             {
-                var isFullWidth = panelsNode[i].HasClass("wiki-main-page-panel--full");
+                bool isFullWidth = panelsNode[i].HasClass("wiki-main-page-panel--full");
 
                 if (isFullWidth)
                 {
diff --git a/osu.Game/Overlays/WikiOverlay.cs b/osu.Game/Overlays/WikiOverlay.cs
index bde73b6180..44713d637d 100644
--- a/osu.Game/Overlays/WikiOverlay.cs
+++ b/osu.Game/Overlays/WikiOverlay.cs
@@ -140,7 +140,7 @@ namespace osu.Game.Overlays
 
         private void showParentPage()
         {
-            var parentPath = string.Join("/", path.Value.Split('/').SkipLast(1));
+            string parentPath = string.Join("/", path.Value.Split('/').SkipLast(1));
             ShowPage(parentPath);
         }
 
diff --git a/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs b/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs
index 200bbf3f92..eab81186d5 100644
--- a/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs
+++ b/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs
@@ -158,7 +158,7 @@ namespace osu.Game.Rulesets.Difficulty
                 // Apply the rest of the remaining mods recursively.
                 for (int i = 0; i < remainingMods.Length; i++)
                 {
-                    var (nextSet, nextCount) = flatten(remainingMods.Span[i]);
+                    (var nextSet, int nextCount) = flatten(remainingMods.Span[i]);
 
                     // Check if any mods in the next set are incompatible with any of the current set.
                     if (currentSet.SelectMany(m => m.IncompatibleMods).Any(c => nextSet.Any(c.IsInstanceOfType)))
@@ -185,7 +185,7 @@ namespace osu.Game.Rulesets.Difficulty
 
                 foreach (var nested in multi.Mods)
                 {
-                    var (nestedSet, nestedCount) = flatten(nested);
+                    (var nestedSet, int nestedCount) = flatten(nested);
                     set = set.Concat(nestedSet);
                     count += nestedCount;
                 }
diff --git a/osu.Game/Rulesets/Edit/Checks/CheckAudioInVideo.cs b/osu.Game/Rulesets/Edit/Checks/CheckAudioInVideo.cs
index ac2542beb0..255671c807 100644
--- a/osu.Game/Rulesets/Edit/Checks/CheckAudioInVideo.cs
+++ b/osu.Game/Rulesets/Edit/Checks/CheckAudioInVideo.cs
@@ -40,7 +40,7 @@ namespace osu.Game.Rulesets.Edit.Checks
                 }
             }
 
-            foreach (var filename in videoPaths)
+            foreach (string filename in videoPaths)
             {
                 string storagePath = beatmapSet.GetPathForFile(filename);
 
diff --git a/osu.Game/Rulesets/Edit/Checks/CheckAudioQuality.cs b/osu.Game/Rulesets/Edit/Checks/CheckAudioQuality.cs
index 70d11883b7..08e0312b64 100644
--- a/osu.Game/Rulesets/Edit/Checks/CheckAudioQuality.cs
+++ b/osu.Game/Rulesets/Edit/Checks/CheckAudioQuality.cs
@@ -27,7 +27,7 @@ namespace osu.Game.Rulesets.Edit.Checks
 
         public IEnumerable<Issue> Run(BeatmapVerifierContext context)
         {
-            var audioFile = context.Beatmap.Metadata?.AudioFile;
+            string audioFile = context.Beatmap.Metadata?.AudioFile;
             if (audioFile == null)
                 yield break;
 
diff --git a/osu.Game/Rulesets/Edit/Checks/CheckBackgroundQuality.cs b/osu.Game/Rulesets/Edit/Checks/CheckBackgroundQuality.cs
index 085c558eaf..8fa79e2ee8 100644
--- a/osu.Game/Rulesets/Edit/Checks/CheckBackgroundQuality.cs
+++ b/osu.Game/Rulesets/Edit/Checks/CheckBackgroundQuality.cs
@@ -31,7 +31,7 @@ namespace osu.Game.Rulesets.Edit.Checks
 
         public IEnumerable<Issue> Run(BeatmapVerifierContext context)
         {
-            var backgroundFile = context.Beatmap.Metadata?.BackgroundFile;
+            string backgroundFile = context.Beatmap.Metadata?.BackgroundFile;
             if (backgroundFile == null)
                 yield break;
 
diff --git a/osu.Game/Rulesets/Edit/Checks/CheckFewHitsounds.cs b/osu.Game/Rulesets/Edit/Checks/CheckFewHitsounds.cs
index 5185ba6c99..3358e81d5f 100644
--- a/osu.Game/Rulesets/Edit/Checks/CheckFewHitsounds.cs
+++ b/osu.Game/Rulesets/Edit/Checks/CheckFewHitsounds.cs
@@ -67,7 +67,7 @@ namespace osu.Game.Rulesets.Edit.Checks
             }
 
             var hitObjectsByEndTime = hitObjectsIncludingNested.OrderBy(o => o.GetEndTime()).ToList();
-            var hitObjectCount = hitObjectsByEndTime.Count;
+            int hitObjectCount = hitObjectsByEndTime.Count;
 
             for (int i = 0; i < hitObjectCount; ++i)
             {
@@ -86,7 +86,7 @@ namespace osu.Game.Rulesets.Edit.Checks
 
         private IEnumerable<Issue> applyHitsoundUpdate(HitObject hitObject, bool isLastObject = false)
         {
-            var time = hitObject.GetEndTime();
+            double time = hitObject.GetEndTime();
             bool hasHitsound = hitObject.Samples.Any(isHitsound);
             bool couldHaveHitsound = hitObject.Samples.Any(isHitnormal);
 
@@ -94,7 +94,7 @@ namespace osu.Game.Rulesets.Edit.Checks
             // If there are no hitsounds we let the "No hitsounds" template take precedence.
             if (hasHitsound || (isLastObject && mapHasHitsounds))
             {
-                var timeWithoutHitsounds = time - lastHitsoundTime;
+                double timeWithoutHitsounds = time - lastHitsoundTime;
 
                 if (timeWithoutHitsounds > problem_threshold_time && objectsWithoutHitsounds > problem_threshold_objects)
                     yield return new IssueTemplateLongPeriodProblem(this).Create(lastHitsoundTime, timeWithoutHitsounds);
diff --git a/osu.Game/Rulesets/Edit/Checks/CheckFilePresence.cs b/osu.Game/Rulesets/Edit/Checks/CheckFilePresence.cs
index 36a0bf8c5d..abedee143a 100644
--- a/osu.Game/Rulesets/Edit/Checks/CheckFilePresence.cs
+++ b/osu.Game/Rulesets/Edit/Checks/CheckFilePresence.cs
@@ -23,7 +23,7 @@ namespace osu.Game.Rulesets.Edit.Checks
 
         public IEnumerable<Issue> Run(BeatmapVerifierContext context)
         {
-            var filename = GetFilename(context.Beatmap);
+            string filename = GetFilename(context.Beatmap);
 
             if (filename == null)
             {
@@ -33,7 +33,7 @@ namespace osu.Game.Rulesets.Edit.Checks
             }
 
             // If the file is set, also make sure it still exists.
-            var storagePath = context.Beatmap.BeatmapInfo.BeatmapSet.GetPathForFile(filename);
+            string storagePath = context.Beatmap.BeatmapInfo.BeatmapSet.GetPathForFile(filename);
             if (storagePath != null)
                 yield break;
 
diff --git a/osu.Game/Rulesets/Edit/HitObjectComposer.cs b/osu.Game/Rulesets/Edit/HitObjectComposer.cs
index 91cc80e930..8bad9aa11f 100644
--- a/osu.Game/Rulesets/Edit/HitObjectComposer.cs
+++ b/osu.Game/Rulesets/Edit/HitObjectComposer.cs
@@ -223,7 +223,7 @@ namespace osu.Game.Rulesets.Edit
             if (e.ControlPressed || e.AltPressed || e.SuperPressed)
                 return false;
 
-            if (checkLeftToggleFromKey(e.Key, out var leftIndex))
+            if (checkLeftToggleFromKey(e.Key, out int leftIndex))
             {
                 var item = toolboxCollection.Items.ElementAtOrDefault(leftIndex);
 
@@ -235,7 +235,7 @@ namespace osu.Game.Rulesets.Edit
                 }
             }
 
-            if (checkRightToggleFromKey(e.Key, out var rightIndex))
+            if (checkRightToggleFromKey(e.Key, out int rightIndex))
             {
                 var item = togglesCollection.ElementAtOrDefault(rightIndex);
 
diff --git a/osu.Game/Rulesets/Mods/ModBarrelRoll.cs b/osu.Game/Rulesets/Mods/ModBarrelRoll.cs
index 872daadd46..4acbcf3e74 100644
--- a/osu.Game/Rulesets/Mods/ModBarrelRoll.cs
+++ b/osu.Game/Rulesets/Mods/ModBarrelRoll.cs
@@ -49,8 +49,8 @@ namespace osu.Game.Rulesets.Mods
             // scale the playfield to allow all hitobjects to stay within the visible region.
 
             var playfieldSize = drawableRuleset.Playfield.DrawSize;
-            var minSide = MathF.Min(playfieldSize.X, playfieldSize.Y);
-            var maxSide = MathF.Max(playfieldSize.X, playfieldSize.Y);
+            float minSide = MathF.Min(playfieldSize.X, playfieldSize.Y);
+            float maxSide = MathF.Max(playfieldSize.X, playfieldSize.Y);
             drawableRuleset.Playfield.Scale = new Vector2(minSide / maxSide);
         }
     }
diff --git a/osu.Game/Rulesets/Objects/BarLineGenerator.cs b/osu.Game/Rulesets/Objects/BarLineGenerator.cs
index 9556b52735..e78aa5a5a0 100644
--- a/osu.Game/Rulesets/Objects/BarLineGenerator.cs
+++ b/osu.Game/Rulesets/Objects/BarLineGenerator.cs
@@ -47,7 +47,7 @@ namespace osu.Game.Rulesets.Objects
 
                 for (double t = currentTimingPoint.Time; Precision.DefinitelyBigger(endTime, t); t += barLength, currentBeat++)
                 {
-                    var roundedTime = Math.Round(t, MidpointRounding.AwayFromZero);
+                    double roundedTime = Math.Round(t, MidpointRounding.AwayFromZero);
 
                     // in the case of some bar lengths, rounding errors can cause t to be slightly less than
                     // the expected whole number value due to floating point inaccuracies.
diff --git a/osu.Game/Rulesets/Objects/Drawables/DrawableHitObject.cs b/osu.Game/Rulesets/Objects/Drawables/DrawableHitObject.cs
index 29d8a475ef..01817147ae 100644
--- a/osu.Game/Rulesets/Objects/Drawables/DrawableHitObject.cs
+++ b/osu.Game/Rulesets/Objects/Drawables/DrawableHitObject.cs
@@ -568,7 +568,7 @@ namespace osu.Game.Rulesets.Objects.Drawables
 
             if (Result != null && Result.HasResult)
             {
-                var endTime = HitObject.GetEndTime();
+                double endTime = HitObject.GetEndTime();
 
                 if (Result.TimeOffset + endTime > Time.Current)
                 {
diff --git a/osu.Game/Rulesets/Objects/Legacy/ConvertHitObjectParser.cs b/osu.Game/Rulesets/Objects/Legacy/ConvertHitObjectParser.cs
index 0942a7264d..b341d2ddab 100644
--- a/osu.Game/Rulesets/Objects/Legacy/ConvertHitObjectParser.cs
+++ b/osu.Game/Rulesets/Objects/Legacy/ConvertHitObjectParser.cs
@@ -130,7 +130,7 @@ namespace osu.Game.Rulesets.Objects.Legacy
                         if (i >= adds.Length)
                             break;
 
-                        int.TryParse(adds[i], out var sound);
+                        int.TryParse(adds[i], out int sound);
                         nodeSoundTypes[i] = (LegacyHitSoundType)sound;
                     }
                 }
diff --git a/osu.Game/Rulesets/Objects/SliderEventGenerator.cs b/osu.Game/Rulesets/Objects/SliderEventGenerator.cs
index ba38c7f77d..bae5a5e8d9 100644
--- a/osu.Game/Rulesets/Objects/SliderEventGenerator.cs
+++ b/osu.Game/Rulesets/Objects/SliderEventGenerator.cs
@@ -18,10 +18,10 @@ namespace osu.Game.Rulesets.Objects
             // This exists for edge cases such as /b/1573664 where the beatmap has been edited by the user, and should never be reached in normal usage.
             const double max_length = 100000;
 
-            var length = Math.Min(max_length, totalDistance);
+            double length = Math.Min(max_length, totalDistance);
             tickDistance = Math.Clamp(tickDistance, 0, length);
 
-            var minDistanceFromEnd = velocity * 10;
+            double minDistanceFromEnd = velocity * 10;
 
             yield return new SliderEventDescriptor
             {
@@ -34,10 +34,10 @@ namespace osu.Game.Rulesets.Objects
 
             if (tickDistance != 0)
             {
-                for (var span = 0; span < spanCount; span++)
+                for (int span = 0; span < spanCount; span++)
                 {
-                    var spanStartTime = startTime + span * spanDuration;
-                    var reversed = span % 2 == 1;
+                    double spanStartTime = startTime + span * spanDuration;
+                    bool reversed = span % 2 == 1;
 
                     var ticks = generateTicks(span, spanStartTime, spanDuration, reversed, length, tickDistance, minDistanceFromEnd, cancellationToken);
 
@@ -115,7 +115,7 @@ namespace osu.Game.Rulesets.Objects
         private static IEnumerable<SliderEventDescriptor> generateTicks(int spanIndex, double spanStartTime, double spanDuration, bool reversed, double length, double tickDistance,
                                                                         double minDistanceFromEnd, CancellationToken cancellationToken = default)
         {
-            for (var d = tickDistance; d <= length; d += tickDistance)
+            for (double d = tickDistance; d <= length; d += tickDistance)
             {
                 cancellationToken.ThrowIfCancellationRequested();
 
@@ -123,8 +123,8 @@ namespace osu.Game.Rulesets.Objects
                     break;
 
                 // Always generate ticks from the start of the path rather than the span to ensure that ticks in repeat spans are positioned identically to those in non-repeat spans
-                var pathProgress = d / length;
-                var timeProgress = reversed ? 1 - pathProgress : pathProgress;
+                double pathProgress = d / length;
+                double timeProgress = reversed ? 1 - pathProgress : pathProgress;
 
                 yield return new SliderEventDescriptor
                 {
diff --git a/osu.Game/Rulesets/Objects/SliderPathExtensions.cs b/osu.Game/Rulesets/Objects/SliderPathExtensions.cs
index 052fc7c775..1308fff7ae 100644
--- a/osu.Game/Rulesets/Objects/SliderPathExtensions.cs
+++ b/osu.Game/Rulesets/Objects/SliderPathExtensions.cs
@@ -25,7 +25,7 @@ namespace osu.Game.Rulesets.Objects
 
             PathType? lastType = null;
 
-            for (var i = 0; i < points.Length; i++)
+            for (int i = 0; i < points.Length; i++)
             {
                 var p = points[i];
                 p.Position -= positionalOffset;
diff --git a/osu.Game/Rulesets/RulesetInfo.cs b/osu.Game/Rulesets/RulesetInfo.cs
index 8cd3fa8c63..8083041a3b 100644
--- a/osu.Game/Rulesets/RulesetInfo.cs
+++ b/osu.Game/Rulesets/RulesetInfo.cs
@@ -45,7 +45,7 @@ namespace osu.Game.Rulesets
         {
             unchecked
             {
-                var hashCode = ID.HasValue ? ID.GetHashCode() : 0;
+                int hashCode = ID.HasValue ? ID.GetHashCode() : 0;
                 hashCode = (hashCode * 397) ^ (InstantiationInfo != null ? InstantiationInfo.GetHashCode() : 0);
                 hashCode = (hashCode * 397) ^ (Name != null ? Name.GetHashCode() : 0);
                 hashCode = (hashCode * 397) ^ Available.GetHashCode();
diff --git a/osu.Game/Rulesets/RulesetStore.cs b/osu.Game/Rulesets/RulesetStore.cs
index a9e04a02b5..391bf2c07d 100644
--- a/osu.Game/Rulesets/RulesetStore.cs
+++ b/osu.Game/Rulesets/RulesetStore.cs
@@ -168,7 +168,7 @@ namespace osu.Game.Rulesets
 
             var rulesets = rulesetStorage.GetFiles(".", $"{ruleset_library_prefix}.*.dll");
 
-            foreach (var ruleset in rulesets.Where(f => !f.Contains("Tests")))
+            foreach (string ruleset in rulesets.Where(f => !f.Contains("Tests")))
                 loadRulesetFromFile(rulesetStorage.GetFullPath(ruleset));
         }
 
@@ -176,7 +176,7 @@ namespace osu.Game.Rulesets
         {
             try
             {
-                var files = Directory.GetFiles(RuntimeInfo.StartupDirectory, $"{ruleset_library_prefix}.*.dll");
+                string[] files = Directory.GetFiles(RuntimeInfo.StartupDirectory, $"{ruleset_library_prefix}.*.dll");
 
                 foreach (string file in files.Where(f => !Path.GetFileName(f).Contains("Tests")))
                     loadRulesetFromFile(file);
@@ -189,7 +189,7 @@ namespace osu.Game.Rulesets
 
         private void loadRulesetFromFile(string file)
         {
-            var filename = Path.GetFileNameWithoutExtension(file);
+            string filename = Path.GetFileNameWithoutExtension(file);
 
             if (loadedAssemblies.Values.Any(t => Path.GetFileNameWithoutExtension(t.Assembly.Location) == filename))
                 return;
diff --git a/osu.Game/Rulesets/Scoring/HitWindows.cs b/osu.Game/Rulesets/Scoring/HitWindows.cs
index 3ffd1eb66b..2d008b58ba 100644
--- a/osu.Game/Rulesets/Scoring/HitWindows.cs
+++ b/osu.Game/Rulesets/Scoring/HitWindows.cs
@@ -86,7 +86,7 @@ namespace osu.Game.Rulesets.Scoring
         {
             foreach (var range in GetRanges())
             {
-                var value = IBeatmapDifficultyInfo.DifficultyRange(difficulty, (range.Min, range.Average, range.Max));
+                double value = IBeatmapDifficultyInfo.DifficultyRange(difficulty, (range.Min, range.Average, range.Max));
 
                 switch (range.Result)
                 {
diff --git a/osu.Game/Rulesets/UI/Scrolling/Algorithms/ConstantScrollAlgorithm.cs b/osu.Game/Rulesets/UI/Scrolling/Algorithms/ConstantScrollAlgorithm.cs
index 0d4283e319..ab6e07f424 100644
--- a/osu.Game/Rulesets/UI/Scrolling/Algorithms/ConstantScrollAlgorithm.cs
+++ b/osu.Game/Rulesets/UI/Scrolling/Algorithms/ConstantScrollAlgorithm.cs
@@ -7,7 +7,7 @@ namespace osu.Game.Rulesets.UI.Scrolling.Algorithms
     {
         public double GetDisplayStartTime(double originTime, float offset, double timeRange, float scrollLength)
         {
-            var adjustedTime = TimeAt(-offset, originTime, timeRange, scrollLength);
+            double adjustedTime = TimeAt(-offset, originTime, timeRange, scrollLength);
             return adjustedTime - timeRange;
         }
 
diff --git a/osu.Game/Rulesets/UI/Scrolling/Algorithms/SequentialScrollAlgorithm.cs b/osu.Game/Rulesets/UI/Scrolling/Algorithms/SequentialScrollAlgorithm.cs
index a1f68d7201..45d3b3bcd4 100644
--- a/osu.Game/Rulesets/UI/Scrolling/Algorithms/SequentialScrollAlgorithm.cs
+++ b/osu.Game/Rulesets/UI/Scrolling/Algorithms/SequentialScrollAlgorithm.cs
@@ -32,7 +32,7 @@ namespace osu.Game.Rulesets.UI.Scrolling.Algorithms
 
         public float GetLength(double startTime, double endTime, double timeRange, float scrollLength)
         {
-            var objectLength = relativePositionAt(endTime, timeRange) - relativePositionAt(startTime, timeRange);
+            double objectLength = relativePositionAt(endTime, timeRange) - relativePositionAt(startTime, timeRange);
             return (float)(objectLength * scrollLength);
         }
 
@@ -90,7 +90,7 @@ namespace osu.Game.Rulesets.UI.Scrolling.Algorithms
         {
             generatePositionMappings(timeRange);
 
-            var mappingIndex = positionMappings.BinarySearch(search, comparer ?? Comparer<PositionMapping>.Default);
+            int mappingIndex = positionMappings.BinarySearch(search, comparer ?? Comparer<PositionMapping>.Default);
 
             if (mappingIndex < 0)
             {
diff --git a/osu.Game/Scoring/Legacy/LegacyScoreDecoder.cs b/osu.Game/Scoring/Legacy/LegacyScoreDecoder.cs
index a1658b4cf3..379718195c 100644
--- a/osu.Game/Scoring/Legacy/LegacyScoreDecoder.cs
+++ b/osu.Game/Scoring/Legacy/LegacyScoreDecoder.cs
@@ -39,7 +39,7 @@ namespace osu.Game.Scoring.Legacy
 
                 score.ScoreInfo = scoreInfo;
 
-                var version = sr.ReadInt32();
+                int version = sr.ReadInt32();
 
                 workingBeatmap = GetBeatmap(sr.ReadString());
                 if (workingBeatmap is DummyWorkingBeatmap)
@@ -77,7 +77,7 @@ namespace osu.Game.Scoring.Legacy
 
                 scoreInfo.Date = sr.ReadDateTime();
 
-                var compressedReplay = sr.ReadByteArray();
+                byte[] compressedReplay = sr.ReadByteArray();
 
                 if (version >= 20140721)
                     scoreInfo.OnlineScoreID = sr.ReadInt64();
@@ -228,11 +228,11 @@ namespace osu.Game.Scoring.Legacy
             float lastTime = 0;
             ReplayFrame currentFrame = null;
 
-            var frames = reader.ReadToEnd().Split(',');
+            string[] frames = reader.ReadToEnd().Split(',');
 
-            for (var i = 0; i < frames.Length; i++)
+            for (int i = 0; i < frames.Length; i++)
             {
-                var split = frames[i].Split('|');
+                string[] split = frames[i].Split('|');
 
                 if (split.Length < 4)
                     continue;
@@ -243,9 +243,9 @@ namespace osu.Game.Scoring.Legacy
                     continue;
                 }
 
-                var diff = Parsing.ParseFloat(split[0]);
-                var mouseX = Parsing.ParseFloat(split[1], Parsing.MAX_COORDINATE_VALUE);
-                var mouseY = Parsing.ParseFloat(split[2], Parsing.MAX_COORDINATE_VALUE);
+                float diff = Parsing.ParseFloat(split[0]);
+                float mouseX = Parsing.ParseFloat(split[1], Parsing.MAX_COORDINATE_VALUE);
+                float mouseY = Parsing.ParseFloat(split[2], Parsing.MAX_COORDINATE_VALUE);
 
                 lastTime += diff;
 
diff --git a/osu.Game/Scoring/Legacy/LegacyScoreEncoder.cs b/osu.Game/Scoring/Legacy/LegacyScoreEncoder.cs
index 58e4192f77..5769406948 100644
--- a/osu.Game/Scoring/Legacy/LegacyScoreEncoder.cs
+++ b/osu.Game/Scoring/Legacy/LegacyScoreEncoder.cs
@@ -72,7 +72,7 @@ namespace osu.Game.Scoring.Legacy
 
         private byte[] createReplayData()
         {
-            var content = new ASCIIEncoding().GetBytes(replayStringContent);
+            byte[] content = new ASCIIEncoding().GetBytes(replayStringContent);
 
             using (var outStream = new MemoryStream())
             {
diff --git a/osu.Game/Scoring/Legacy/ScoreInfoExtensions.cs b/osu.Game/Scoring/Legacy/ScoreInfoExtensions.cs
index b58f65800d..fc27261225 100644
--- a/osu.Game/Scoring/Legacy/ScoreInfoExtensions.cs
+++ b/osu.Game/Scoring/Legacy/ScoreInfoExtensions.cs
@@ -130,7 +130,7 @@ namespace osu.Game.Scoring.Legacy
 
         private static int? getCount(ScoreInfo scoreInfo, HitResult result)
         {
-            if (scoreInfo.Statistics.TryGetValue(result, out var existing))
+            if (scoreInfo.Statistics.TryGetValue(result, out int existing))
                 return existing;
 
             return null;
diff --git a/osu.Game/Scoring/LegacyDatabasedScore.cs b/osu.Game/Scoring/LegacyDatabasedScore.cs
index 8908775472..81892f65d0 100644
--- a/osu.Game/Scoring/LegacyDatabasedScore.cs
+++ b/osu.Game/Scoring/LegacyDatabasedScore.cs
@@ -16,7 +16,7 @@ namespace osu.Game.Scoring
         {
             ScoreInfo = score;
 
-            var replayFilename = score.Files.FirstOrDefault(f => f.Filename.EndsWith(".osr", StringComparison.InvariantCultureIgnoreCase))?.FileInfo.StoragePath;
+            string replayFilename = score.Files.FirstOrDefault(f => f.Filename.EndsWith(".osr", StringComparison.InvariantCultureIgnoreCase))?.FileInfo.StoragePath;
 
             if (replayFilename == null)
                 return;
diff --git a/osu.Game/Scoring/ScoreManager.cs b/osu.Game/Scoring/ScoreManager.cs
index a9791fba7e..253591eb56 100644
--- a/osu.Game/Scoring/ScoreManager.cs
+++ b/osu.Game/Scoring/ScoreManager.cs
@@ -72,7 +72,7 @@ namespace osu.Game.Scoring
                 }
             }
 
-            var totalScores = await Task.WhenAll(scores.Select(s => GetTotalScoreAsync(s, cancellationToken: cancellationToken))).ConfigureAwait(false);
+            long[] totalScores = await Task.WhenAll(scores.Select(s => GetTotalScoreAsync(s, cancellationToken: cancellationToken))).ConfigureAwait(false);
 
             return scores.Select((score, index) => (score, totalScore: totalScores[index]))
                          .OrderByDescending(g => g.totalScore)
diff --git a/osu.Game/Screens/Edit/BindableBeatDivisor.cs b/osu.Game/Screens/Edit/BindableBeatDivisor.cs
index dfe2992a7c..1a350d7261 100644
--- a/osu.Game/Screens/Edit/BindableBeatDivisor.cs
+++ b/osu.Game/Screens/Edit/BindableBeatDivisor.cs
@@ -92,7 +92,7 @@ namespace osu.Game.Screens.Edit
         {
             int beat = index % beatDivisor;
 
-            foreach (var divisor in BindableBeatDivisor.VALID_DIVISORS)
+            foreach (int divisor in BindableBeatDivisor.VALID_DIVISORS)
             {
                 if ((beat * divisor) % beatDivisor == 0)
                     return divisor;
diff --git a/osu.Game/Screens/Edit/Compose/Components/BeatDivisorControl.cs b/osu.Game/Screens/Edit/Compose/Components/BeatDivisorControl.cs
index 2dec3fd22e..de63b265d2 100644
--- a/osu.Game/Screens/Edit/Compose/Components/BeatDivisorControl.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/BeatDivisorControl.cs
@@ -205,7 +205,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
             [BackgroundDependencyLoader]
             private void load()
             {
-                foreach (var t in availableDivisors)
+                foreach (int t in availableDivisors)
                 {
                     AddInternal(new Tick
                     {
@@ -287,7 +287,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
             private void handleMouseInput(Vector2 screenSpaceMousePosition)
             {
                 // copied from SliderBar so we can do custom spacing logic.
-                var xPosition = (ToLocalSpace(screenSpaceMousePosition).X - RangePadding) / UsableWidth;
+                float xPosition = (ToLocalSpace(screenSpaceMousePosition).X - RangePadding) / UsableWidth;
 
                 CurrentNumber.Value = availableDivisors.OrderBy(d => Math.Abs(getMappedPosition(d) - xPosition)).First();
                 OnUserChange(Current.Value);
diff --git a/osu.Game/Screens/Edit/Compose/Components/BlueprintContainer.cs b/osu.Game/Screens/Edit/Compose/Components/BlueprintContainer.cs
index 75d4d13f94..d7d4642a39 100644
--- a/osu.Game/Screens/Edit/Compose/Components/BlueprintContainer.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/BlueprintContainer.cs
@@ -58,13 +58,13 @@ namespace osu.Game.Screens.Edit.Compose.Components
                 switch (args.Action)
                 {
                     case NotifyCollectionChangedAction.Add:
-                        foreach (var o in args.NewItems)
+                        foreach (object o in args.NewItems)
                             SelectionBlueprints.FirstOrDefault(b => b.Item == o)?.Select();
 
                         break;
 
                     case NotifyCollectionChangedAction.Remove:
-                        foreach (var o in args.OldItems)
+                        foreach (object o in args.OldItems)
                             SelectionBlueprints.FirstOrDefault(b => b.Item == o)?.Deselect();
 
                         break;
@@ -468,7 +468,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
             if (snapProvider != null)
             {
                 // check for positional snap for every object in selection (for things like object-object snapping)
-                for (var i = 0; i < movementBlueprintOriginalPositions.Length; i++)
+                for (int i = 0; i < movementBlueprintOriginalPositions.Length; i++)
                 {
                     Vector2 originalPosition = movementBlueprintOriginalPositions[i];
                     var testPosition = originalPosition + distanceTravelled;
diff --git a/osu.Game/Screens/Edit/Compose/Components/DistanceSnapGrid.cs b/osu.Game/Screens/Edit/Compose/Components/DistanceSnapGrid.cs
index 9d43e3258a..05bf405f3c 100644
--- a/osu.Game/Screens/Edit/Compose/Components/DistanceSnapGrid.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/DistanceSnapGrid.cs
@@ -132,8 +132,8 @@ namespace osu.Game.Screens.Edit.Compose.Components
         protected ColourInfo GetColourForIndexFromPlacement(int placementIndex)
         {
             var timingPoint = beatmap.ControlPointInfo.TimingPointAt(StartTime);
-            var beatLength = timingPoint.BeatLength / beatDivisor.Value;
-            var beatIndex = (int)Math.Round((StartTime - timingPoint.Time) / beatLength);
+            double beatLength = timingPoint.BeatLength / beatDivisor.Value;
+            int beatIndex = (int)Math.Round((StartTime - timingPoint.Time) / beatLength);
 
             var colour = BindableBeatDivisor.GetColourFor(BindableBeatDivisor.GetDivisorForBeatIndex(beatIndex + placementIndex + 1, beatDivisor.Value), Colours);
 
diff --git a/osu.Game/Screens/Edit/Compose/Components/EditorSelectionHandler.cs b/osu.Game/Screens/Edit/Compose/Components/EditorSelectionHandler.cs
index 246d4aa8d7..5f6e8de557 100644
--- a/osu.Game/Screens/Edit/Compose/Components/EditorSelectionHandler.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/EditorSelectionHandler.cs
@@ -55,7 +55,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
         /// </summary>
         private void createStateBindables()
         {
-            foreach (var sampleName in HitSampleInfo.AllAdditions)
+            foreach (string sampleName in HitSampleInfo.AllAdditions)
             {
                 var bindable = new Bindable<TernaryState>
                 {
@@ -102,7 +102,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
         {
             SelectionNewComboState.Value = GetStateFromSelection(SelectedItems.OfType<IHasComboInformation>(), h => h.NewCombo);
 
-            foreach (var (sampleName, bindable) in SelectionSampleStates)
+            foreach ((string sampleName, var bindable) in SelectionSampleStates)
             {
                 bindable.Value = GetStateFromSelection(SelectedItems, h => h.Samples.Any(s => s.Name == sampleName));
             }
diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineBlueprintContainer.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineBlueprintContainer.cs
index 73c38ba23f..a9e9ef5001 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineBlueprintContainer.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineBlueprintContainer.cs
@@ -176,7 +176,7 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
             if (timeline != null)
             {
                 var timelineQuad = timeline.ScreenSpaceDrawQuad;
-                var mouseX = e.ScreenSpaceMousePosition.X;
+                float mouseX = e.ScreenSpaceMousePosition.X;
 
                 // scroll if in a drag and dragging outside visible extents
                 if (mouseX > timelineQuad.TopRight.X)
diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineHitObjectBlueprint.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineHitObjectBlueprint.cs
index e2458d45c9..80aa6972b1 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineHitObjectBlueprint.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineHitObjectBlueprint.cs
@@ -397,7 +397,7 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
                                     if (hitObject.DifficultyControlPoint == DifficultyControlPoint.DEFAULT)
                                         hitObject.DifficultyControlPoint = new DifficultyControlPoint();
 
-                                    var newVelocity = hitObject.DifficultyControlPoint.SliderVelocity * (repeatHitObject.Duration / proposedDuration);
+                                    double newVelocity = hitObject.DifficultyControlPoint.SliderVelocity * (repeatHitObject.Duration / proposedDuration);
 
                                     if (Precision.AlmostEquals(newVelocity, hitObject.DifficultyControlPoint.SliderVelocity))
                                         return;
@@ -408,8 +408,8 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
                                 else
                                 {
                                     // find the number of repeats which can fit in the requested time.
-                                    var lengthOfOneRepeat = repeatHitObject.Duration / (repeatHitObject.RepeatCount + 1);
-                                    var proposedCount = Math.Max(0, (int)Math.Round(proposedDuration / lengthOfOneRepeat) - 1);
+                                    double lengthOfOneRepeat = repeatHitObject.Duration / (repeatHitObject.RepeatCount + 1);
+                                    int proposedCount = Math.Max(0, (int)Math.Round(proposedDuration / lengthOfOneRepeat) - 1);
 
                                     if (proposedCount == repeatHitObject.RepeatCount)
                                         return;
@@ -421,7 +421,7 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
                                 break;
 
                             case IHasDuration endTimeHitObject:
-                                var snappedTime = Math.Max(hitObject.StartTime, beatSnapProvider.SnapTime(time));
+                                double snappedTime = Math.Max(hitObject.StartTime, beatSnapProvider.SnapTime(time));
 
                                 if (endTimeHitObject.EndTime == snappedTime || Precision.AlmostEquals(snappedTime, hitObject.StartTime, beatmap.GetBeatLengthAtTime(snappedTime)))
                                     return;
diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineTickDisplay.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineTickDisplay.cs
index 3aaf0451c8..1415014e59 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineTickDisplay.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineTickDisplay.cs
@@ -104,10 +104,10 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
             nextMinTick = null;
             nextMaxTick = null;
 
-            for (var i = 0; i < beatmap.ControlPointInfo.TimingPoints.Count; i++)
+            for (int i = 0; i < beatmap.ControlPointInfo.TimingPoints.Count; i++)
             {
                 var point = beatmap.ControlPointInfo.TimingPoints[i];
-                var until = i + 1 < beatmap.ControlPointInfo.TimingPoints.Count ? beatmap.ControlPointInfo.TimingPoints[i + 1].Time : working.Value.Track.Length;
+                double until = i + 1 < beatmap.ControlPointInfo.TimingPoints.Count ? beatmap.ControlPointInfo.TimingPoints[i + 1].Time : working.Value.Track.Length;
 
                 int beat = 0;
 
@@ -127,7 +127,7 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
 
                         int indexInBar = beat % ((int)point.TimeSignature * beatDivisor.Value);
 
-                        var divisor = BindableBeatDivisor.GetDivisorForBeatIndex(beat, beatDivisor.Value);
+                        int divisor = BindableBeatDivisor.GetDivisorForBeatIndex(beat, beatDivisor.Value);
                         var colour = BindableBeatDivisor.GetColourFor(divisor, colours);
 
                         // even though "bar lines" take up the full vertical space, we render them in two pieces because it allows for less anchor/origin churn.
diff --git a/osu.Game/Screens/Edit/Editor.cs b/osu.Game/Screens/Edit/Editor.cs
index 512226413b..81b2847443 100644
--- a/osu.Game/Screens/Edit/Editor.cs
+++ b/osu.Game/Screens/Edit/Editor.cs
@@ -301,7 +301,7 @@ namespace osu.Game.Screens.Edit
 
             editorBeatmap.SelectedHitObjects.BindCollectionChanged((_, __) =>
             {
-                var hasObjects = editorBeatmap.SelectedHitObjects.Count > 0;
+                bool hasObjects = editorBeatmap.SelectedHitObjects.Count > 0;
 
                 cutMenuItem.Action.Disabled = !hasObjects;
                 copyMenuItem.Action.Disabled = !hasObjects;
diff --git a/osu.Game/Screens/Edit/EditorBeatmap.cs b/osu.Game/Screens/Edit/EditorBeatmap.cs
index 2e84ef437a..98fad09192 100644
--- a/osu.Game/Screens/Edit/EditorBeatmap.cs
+++ b/osu.Game/Screens/Edit/EditorBeatmap.cs
@@ -183,7 +183,7 @@ namespace osu.Game.Screens.Edit
         public void Add(HitObject hitObject)
         {
             // Preserve existing sorting order in the beatmap
-            var insertionIndex = findInsertionIndex(PlayableBeatmap.HitObjects, hitObject.StartTime);
+            int insertionIndex = findInsertionIndex(PlayableBeatmap.HitObjects, hitObject.StartTime);
             Insert(insertionIndex + 1, hitObject);
         }
 
@@ -332,7 +332,7 @@ namespace osu.Game.Screens.Edit
                 // For now we'll remove and re-add the hitobject. This is not optimal and can be improved if required.
                 mutableHitObjects.Remove(hitObject);
 
-                var insertionIndex = findInsertionIndex(PlayableBeatmap.HitObjects, hitObject.StartTime);
+                int insertionIndex = findInsertionIndex(PlayableBeatmap.HitObjects, hitObject.StartTime);
                 mutableHitObjects.Insert(insertionIndex + 1, hitObject);
 
                 Update(hitObject);
diff --git a/osu.Game/Screens/Edit/EditorChangeHandler.cs b/osu.Game/Screens/Edit/EditorChangeHandler.cs
index 2dcb416a03..333c518d3a 100644
--- a/osu.Game/Screens/Edit/EditorChangeHandler.cs
+++ b/osu.Game/Screens/Edit/EditorChangeHandler.cs
@@ -73,7 +73,7 @@ namespace osu.Game.Screens.Edit
                 using (var sw = new StreamWriter(stream, Encoding.UTF8, 1024, true))
                     new LegacyBeatmapEncoder(editorBeatmap, editorBeatmap.BeatmapSkin).Encode(sw);
 
-                var newState = stream.ToArray();
+                byte[] newState = stream.ToArray();
 
                 // if the previous state is binary equal we don't need to push a new one, unless this is the initial state.
                 if (savedStates.Count > 0 && newState.SequenceEqual(savedStates[currentState])) return;
diff --git a/osu.Game/Screens/Edit/LegacyEditorBeatmapPatcher.cs b/osu.Game/Screens/Edit/LegacyEditorBeatmapPatcher.cs
index d26856365e..3ed2a7efe2 100644
--- a/osu.Game/Screens/Edit/LegacyEditorBeatmapPatcher.cs
+++ b/osu.Game/Screens/Edit/LegacyEditorBeatmapPatcher.cs
@@ -82,7 +82,7 @@ namespace osu.Game.Screens.Edit
             if (toAdd.Count > 0)
             {
                 IBeatmap newBeatmap = readBeatmap(newState);
-                foreach (var i in toAdd)
+                foreach (int i in toAdd)
                     editorBeatmap.Insert(i, newBeatmap.HitObjects[i]);
             }
 
diff --git a/osu.Game/Screens/Edit/Timing/GroupSection.cs b/osu.Game/Screens/Edit/Timing/GroupSection.cs
index 2e2c380d4a..03059ff6e1 100644
--- a/osu.Game/Screens/Edit/Timing/GroupSection.cs
+++ b/osu.Game/Screens/Edit/Timing/GroupSection.cs
@@ -68,7 +68,7 @@ namespace osu.Game.Screens.Edit.Timing
                 if (!isNew)
                     return;
 
-                if (double.TryParse(sender.Text, out var newTime))
+                if (double.TryParse(sender.Text, out double newTime))
                 {
                     changeSelectedGroupTime(newTime);
                 }
diff --git a/osu.Game/Screens/Menu/IntroScreen.cs b/osu.Game/Screens/Menu/IntroScreen.cs
index 32fb9f1d6d..eb8d3dfea6 100644
--- a/osu.Game/Screens/Menu/IntroScreen.cs
+++ b/osu.Game/Screens/Menu/IntroScreen.cs
@@ -211,7 +211,7 @@ namespace osu.Game.Screens.Menu
             else
             {
                 const int quick_appear = 350;
-                var initialMovementTime = logo.Alpha > 0.2f ? quick_appear : 0;
+                int initialMovementTime = logo.Alpha > 0.2f ? quick_appear : 0;
 
                 logo.MoveTo(new Vector2(0.5f), initialMovementTime, Easing.OutQuint);
 
diff --git a/osu.Game/Screens/Menu/OsuLogo.cs b/osu.Game/Screens/Menu/OsuLogo.cs
index a9376325cd..f9388097ac 100644
--- a/osu.Game/Screens/Menu/OsuLogo.cs
+++ b/osu.Game/Screens/Menu/OsuLogo.cs
@@ -272,7 +272,7 @@ namespace osu.Game.Screens.Menu
 
             lastBeatIndex = beatIndex;
 
-            var beatLength = timingPoint.BeatLength;
+            double beatLength = timingPoint.BeatLength;
 
             float amplitudeAdjust = Math.Min(1, 0.4f + amplitudes.Maximum);
 
@@ -337,7 +337,7 @@ namespace osu.Game.Screens.Menu
 
             if (musicController.CurrentTrack.IsRunning)
             {
-                var maxAmplitude = lastBeatIndex >= 0 ? musicController.CurrentTrack.CurrentAmplitudes.Maximum : 0;
+                float maxAmplitude = lastBeatIndex >= 0 ? musicController.CurrentTrack.CurrentAmplitudes.Maximum : 0;
                 logoAmplitudeContainer.Scale = new Vector2((float)Interpolation.Damp(logoAmplitudeContainer.Scale.X, 1 - Math.Max(0, maxAmplitude - scale_adjust_cutoff) * 0.04f, 0.9f, Time.Elapsed));
 
                 if (maxAmplitude > velocity_adjust_cutoff)
diff --git a/osu.Game/Screens/OnlinePlay/Components/OnlinePlayBackgroundScreen.cs b/osu.Game/Screens/OnlinePlay/Components/OnlinePlayBackgroundScreen.cs
index 8b6077b9f2..e2088c77d5 100644
--- a/osu.Game/Screens/OnlinePlay/Components/OnlinePlayBackgroundScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Components/OnlinePlayBackgroundScreen.cs
@@ -95,7 +95,7 @@ namespace osu.Game.Screens.OnlinePlay.Components
 
         public override bool OnExiting(IScreen next)
         {
-            var result = base.OnExiting(next);
+            bool result = base.OnExiting(next);
             this.MoveToX(0);
             return result;
         }
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantPanel.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantPanel.cs
index 79e305b765..e77b5d7b8c 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantPanel.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantPanel.cs
@@ -186,7 +186,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Participants
 
             var ruleset = rulesets.GetRuleset(Room.Settings.RulesetID).CreateInstance();
 
-            var currentModeRank = User.User?.RulesetsStatistics?.GetValueOrDefault(ruleset.ShortName)?.GlobalRank;
+            int? currentModeRank = User.User?.RulesetsStatistics?.GetValueOrDefault(ruleset.ShortName)?.GlobalRank;
             userRankText.Text = currentModeRank != null ? $"#{currentModeRank.Value:N0}" : string.Empty;
 
             userStateDisplay.UpdateStatus(User.State, User.BeatmapAvailability);
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorScreen.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorScreen.cs
index 7bf8ce0e1a..57d0d2c198 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorScreen.cs
@@ -180,11 +180,11 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Spectate
         {
             // Seek the master clock to the gameplay time.
             // This is chosen as the first available frame in the players' replays, which matches the seek by each individual SpectatorPlayer.
-            var startTime = instances.Where(i => i.Score != null)
-                                     .SelectMany(i => i.Score.Replay.Frames)
-                                     .Select(f => f.Time)
-                                     .DefaultIfEmpty(0)
-                                     .Min();
+            double startTime = instances.Where(i => i.Score != null)
+                                        .SelectMany(i => i.Score.Replay.Frames)
+                                        .Select(f => f.Time)
+                                        .DefaultIfEmpty(0)
+                                        .Min();
 
             masterClockContainer.Seek(startTime);
             masterClockContainer.Start();
diff --git a/osu.Game/Screens/Play/Break/BreakInfoLine.cs b/osu.Game/Screens/Play/Break/BreakInfoLine.cs
index 0bc79d6e77..87f514ffd5 100644
--- a/osu.Game/Screens/Play/Break/BreakInfoLine.cs
+++ b/osu.Game/Screens/Play/Break/BreakInfoLine.cs
@@ -56,7 +56,7 @@ namespace osu.Game.Screens.Play.Break
 
         private void currentValueChanged(ValueChangedEvent<T> e)
         {
-            var newText = prefix + Format(e.NewValue);
+            string newText = prefix + Format(e.NewValue);
 
             if (valueText.Text == newText)
                 return;
diff --git a/osu.Game/Screens/Play/BreakTracker.cs b/osu.Game/Screens/Play/BreakTracker.cs
index 2f3673e91f..8441b7657e 100644
--- a/osu.Game/Screens/Play/BreakTracker.cs
+++ b/osu.Game/Screens/Play/BreakTracker.cs
@@ -51,7 +51,7 @@ namespace osu.Game.Screens.Play
 
         private void updateBreakTime()
         {
-            var time = Clock.CurrentTime;
+            double time = Clock.CurrentTime;
 
             isBreakTime.Value = breaks?.IsInAny(time) == true
                                 || time < gameplayStartTime
diff --git a/osu.Game/Screens/Play/HUD/FailingLayer.cs b/osu.Game/Screens/Play/HUD/FailingLayer.cs
index 424ee55766..ceb81f6b8d 100644
--- a/osu.Game/Screens/Play/HUD/FailingLayer.cs
+++ b/osu.Game/Screens/Play/HUD/FailingLayer.cs
@@ -90,7 +90,7 @@ namespace osu.Game.Screens.Play.HUD
         private void updateState()
         {
             // Don't display ever if the ruleset is not using a draining health display.
-            var showLayer = HealthProcessor is DrainingHealthProcessor && fadePlayfieldWhenHealthLow.Value && ShowHealth.Value;
+            bool showLayer = HealthProcessor is DrainingHealthProcessor && fadePlayfieldWhenHealthLow.Value && ShowHealth.Value;
             this.FadeTo(showLayer ? 1 : 0, fade_time, Easing.OutQuint);
         }
 
diff --git a/osu.Game/Screens/Play/HUD/HitErrorMeters/BarHitErrorMeter.cs b/osu.Game/Screens/Play/HUD/HitErrorMeters/BarHitErrorMeter.cs
index fb49dedce7..a8141c57da 100644
--- a/osu.Game/Screens/Play/HUD/HitErrorMeters/BarHitErrorMeter.cs
+++ b/osu.Game/Screens/Play/HUD/HitErrorMeters/BarHitErrorMeter.cs
@@ -157,11 +157,11 @@ namespace osu.Game.Screens.Play.HUD.HitErrorMeters
             // max to avoid div-by-zero.
             maxHitWindow = Math.Max(1, windows.First().length);
 
-            for (var i = 0; i < windows.Length; i++)
+            for (int i = 0; i < windows.Length; i++)
             {
-                var (result, length) = windows[i];
+                (var result, double length) = windows[i];
 
-                var hitWindow = (float)(length / maxHitWindow);
+                float hitWindow = (float)(length / maxHitWindow);
 
                 colourBarsEarly.Add(createColourBar(result, hitWindow, i == 0));
                 colourBarsLate.Add(createColourBar(result, hitWindow, i == 0));
diff --git a/osu.Game/Screens/Play/HUD/MatchScoreDisplay.cs b/osu.Game/Screens/Play/HUD/MatchScoreDisplay.cs
index b1c07512dd..88cf9529bf 100644
--- a/osu.Game/Screens/Play/HUD/MatchScoreDisplay.cs
+++ b/osu.Game/Screens/Play/HUD/MatchScoreDisplay.cs
@@ -133,7 +133,7 @@ namespace osu.Game.Screens.Play.HUD
             var winningBar = Team1Score.Value > Team2Score.Value ? score1Bar : score2Bar;
             var losingBar = Team1Score.Value <= Team2Score.Value ? score1Bar : score2Bar;
 
-            var diff = Math.Max(Team1Score.Value, Team2Score.Value) - Math.Min(Team1Score.Value, Team2Score.Value);
+            int diff = Math.Max(Team1Score.Value, Team2Score.Value) - Math.Min(Team1Score.Value, Team2Score.Value);
 
             losingBar.ResizeWidthTo(0, 400, Easing.OutQuint);
             winningBar.ResizeWidthTo(Math.Min(0.4f, MathF.Pow(diff / 1500000f, 0.5f) / 2), 400, Easing.OutQuint);
diff --git a/osu.Game/Screens/Play/HUD/MultiplayerGameplayLeaderboard.cs b/osu.Game/Screens/Play/HUD/MultiplayerGameplayLeaderboard.cs
index 19cb6aeb50..7caf90f610 100644
--- a/osu.Game/Screens/Play/HUD/MultiplayerGameplayLeaderboard.cs
+++ b/osu.Game/Screens/Play/HUD/MultiplayerGameplayLeaderboard.cs
@@ -148,7 +148,7 @@ namespace osu.Game.Screens.Play.HUD
             switch (e.Action)
             {
                 case NotifyCollectionChangedAction.Remove:
-                    foreach (var userId in e.OldItems.OfType<int>())
+                    foreach (int userId in e.OldItems.OfType<int>())
                     {
                         spectatorClient.StopWatchingUser(userId);
 
diff --git a/osu.Game/Screens/Play/SongProgressGraph.cs b/osu.Game/Screens/Play/SongProgressGraph.cs
index 78eb456bb5..f96de149ba 100644
--- a/osu.Game/Screens/Play/SongProgressGraph.cs
+++ b/osu.Game/Screens/Play/SongProgressGraph.cs
@@ -24,17 +24,17 @@ namespace osu.Game.Screens.Play
                 if (!objects.Any())
                     return;
 
-                var firstHit = objects.First().StartTime;
-                var lastHit = objects.Max(o => o.GetEndTime());
+                double firstHit = objects.First().StartTime;
+                double lastHit = objects.Max(o => o.GetEndTime());
 
                 if (lastHit == 0)
                     lastHit = objects.Last().StartTime;
 
-                var interval = (lastHit - firstHit + 1) / granularity;
+                double interval = (lastHit - firstHit + 1) / granularity;
 
                 foreach (var h in objects)
                 {
-                    var endTime = h.GetEndTime();
+                    double endTime = h.GetEndTime();
 
                     Debug.Assert(endTime >= h.StartTime);
 
diff --git a/osu.Game/Screens/Play/SongProgressInfo.cs b/osu.Game/Screens/Play/SongProgressInfo.cs
index 7441c335d2..7a458cdde0 100644
--- a/osu.Game/Screens/Play/SongProgressInfo.cs
+++ b/osu.Game/Screens/Play/SongProgressInfo.cs
@@ -82,7 +82,7 @@ namespace osu.Game.Screens.Play
         {
             base.Update();
 
-            var time = gameplayClock?.CurrentTime ?? Time.Current;
+            double time = gameplayClock?.CurrentTime ?? Time.Current;
 
             double songCurrentTime = time - startTime;
             int currentPercent = Math.Max(0, Math.Min(100, (int)(songCurrentTime / songLength * 100)));
diff --git a/osu.Game/Screens/Play/SquareGraph.cs b/osu.Game/Screens/Play/SquareGraph.cs
index 36ce131411..67abcb66e6 100644
--- a/osu.Game/Screens/Play/SquareGraph.cs
+++ b/osu.Game/Screens/Play/SquareGraph.cs
@@ -165,7 +165,7 @@ namespace osu.Game.Screens.Play
                 return;
             }
 
-            var max = values.Max();
+            int max = values.Max();
 
             float step = values.Length / (float)ColumnCount;
 
diff --git a/osu.Game/Screens/Play/SubmittingPlayer.cs b/osu.Game/Screens/Play/SubmittingPlayer.cs
index 5faa384d03..76411c8c6b 100644
--- a/osu.Game/Screens/Play/SubmittingPlayer.cs
+++ b/osu.Game/Screens/Play/SubmittingPlayer.cs
@@ -116,7 +116,7 @@ namespace osu.Game.Screens.Play
 
         public override bool OnExiting(IScreen next)
         {
-            var exiting = base.OnExiting(next);
+            bool exiting = base.OnExiting(next);
 
             submitScore(Score.DeepClone());
 
diff --git a/osu.Game/Screens/Ranking/Expanded/ExpandedPanelMiddleContent.cs b/osu.Game/Screens/Ranking/Expanded/ExpandedPanelMiddleContent.cs
index 262d1e8293..c27d5227b5 100644
--- a/osu.Game/Screens/Ranking/Expanded/ExpandedPanelMiddleContent.cs
+++ b/osu.Game/Screens/Ranking/Expanded/ExpandedPanelMiddleContent.cs
@@ -62,12 +62,12 @@ namespace osu.Game.Screens.Ranking.Expanded
         {
             var beatmap = score.BeatmapInfo;
             var metadata = beatmap.BeatmapSet?.Metadata ?? beatmap.Metadata;
-            var creator = metadata.Author?.Username;
+            string creator = metadata.Author?.Username;
 
             var topStatistics = new List<StatisticDisplay>
             {
                 new AccuracyStatistic(score.Accuracy),
-                new ComboStatistic(score.MaxCombo, !score.Statistics.TryGetValue(HitResult.Miss, out var missCount) || missCount == 0),
+                new ComboStatistic(score.MaxCombo, !score.Statistics.TryGetValue(HitResult.Miss, out int missCount) || missCount == 0),
                 new PerformanceStatistic(score),
             };
 
diff --git a/osu.Game/Screens/Ranking/ResultsScreen.cs b/osu.Game/Screens/Ranking/ResultsScreen.cs
index af60296344..dacc4f5f9e 100644
--- a/osu.Game/Screens/Ranking/ResultsScreen.cs
+++ b/osu.Game/Screens/Ranking/ResultsScreen.cs
@@ -287,7 +287,7 @@ namespace osu.Game.Screens.Ranking
                 detachedPanelContainer.Add(expandedPanel);
 
                 // Move into its original location in the local container first, then to the final location.
-                var origLocation = detachedPanelContainer.ToLocalSpace(screenSpacePos).X;
+                float origLocation = detachedPanelContainer.ToLocalSpace(screenSpacePos).X;
                 expandedPanel.MoveToX(origLocation)
                              .Then()
                              .MoveToX(StatisticsPanel.SIDE_PADDING, 150, Easing.OutQuint);
diff --git a/osu.Game/Screens/Ranking/Statistics/UnstableRate.cs b/osu.Game/Screens/Ranking/Statistics/UnstableRate.cs
index 055db143d1..cd2b292547 100644
--- a/osu.Game/Screens/Ranking/Statistics/UnstableRate.cs
+++ b/osu.Game/Screens/Ranking/Statistics/UnstableRate.cs
@@ -20,8 +20,8 @@ namespace osu.Game.Screens.Ranking.Statistics
         public UnstableRate(IEnumerable<HitEvent> hitEvents)
             : base("Unstable Rate")
         {
-            var timeOffsets = hitEvents.Where(e => !(e.HitObject.HitWindows is HitWindows.EmptyHitWindows) && e.Result.IsHit())
-                                       .Select(ev => ev.TimeOffset).ToArray();
+            double[] timeOffsets = hitEvents.Where(e => !(e.HitObject.HitWindows is HitWindows.EmptyHitWindows) && e.Result.IsHit())
+                                            .Select(ev => ev.TimeOffset).ToArray();
             Value = 10 * standardDeviation(timeOffsets);
         }
 
@@ -30,8 +30,8 @@ namespace osu.Game.Screens.Ranking.Statistics
             if (timeOffsets.Length == 0)
                 return double.NaN;
 
-            var mean = timeOffsets.Average();
-            var squares = timeOffsets.Select(offset => Math.Pow(offset - mean, 2)).Sum();
+            double mean = timeOffsets.Average();
+            double squares = timeOffsets.Select(offset => Math.Pow(offset - mean, 2)).Sum();
             return Math.Sqrt(squares / timeOffsets.Length);
         }
 
diff --git a/osu.Game/Screens/Select/BeatmapDetails.cs b/osu.Game/Screens/Select/BeatmapDetails.cs
index 16455940bf..dfbaa9c6a5 100644
--- a/osu.Game/Screens/Select/BeatmapDetails.cs
+++ b/osu.Game/Screens/Select/BeatmapDetails.cs
@@ -233,7 +233,7 @@ namespace osu.Game.Screens.Select
 
         private void updateMetrics()
         {
-            var hasMetrics = (failTimes?.Retries?.Any() ?? false) || (failTimes?.Fails?.Any() ?? false);
+            bool hasMetrics = (failTimes?.Retries?.Any() ?? false) || (failTimes?.Fails?.Any() ?? false);
 
             if (ratings?.Any() ?? false)
             {
diff --git a/osu.Game/Screens/Select/Carousel/CarouselBeatmap.cs b/osu.Game/Screens/Select/Carousel/CarouselBeatmap.cs
index d8c5aa760e..9e057808a7 100644
--- a/osu.Game/Screens/Select/Carousel/CarouselBeatmap.cs
+++ b/osu.Game/Screens/Select/Carousel/CarouselBeatmap.cs
@@ -57,9 +57,9 @@ namespace osu.Game.Screens.Select.Carousel
 
             if (match)
             {
-                var terms = BeatmapInfo.GetSearchableTerms();
+                string[] terms = BeatmapInfo.GetSearchableTerms();
 
-                foreach (var criteriaTerm in criteria.SearchTerms)
+                foreach (string criteriaTerm in criteria.SearchTerms)
                     match &= terms.Any(term => term.Contains(criteriaTerm, StringComparison.InvariantCultureIgnoreCase));
 
                 // if a match wasn't found via text matching of terms, do a second catch-all check matching against online IDs.
@@ -89,7 +89,7 @@ namespace osu.Game.Screens.Select.Carousel
             {
                 default:
                 case SortMode.Difficulty:
-                    var ruleset = BeatmapInfo.RulesetID.CompareTo(otherBeatmap.BeatmapInfo.RulesetID);
+                    int ruleset = BeatmapInfo.RulesetID.CompareTo(otherBeatmap.BeatmapInfo.RulesetID);
                     if (ruleset != 0) return ruleset;
 
                     return BeatmapInfo.StarDifficulty.CompareTo(otherBeatmap.BeatmapInfo.StarDifficulty);
diff --git a/osu.Game/Screens/Select/Carousel/CarouselBeatmapSet.cs b/osu.Game/Screens/Select/Carousel/CarouselBeatmapSet.cs
index 0d7882bf17..e465f423bc 100644
--- a/osu.Game/Screens/Select/Carousel/CarouselBeatmapSet.cs
+++ b/osu.Game/Screens/Select/Carousel/CarouselBeatmapSet.cs
@@ -95,8 +95,8 @@ namespace osu.Game.Screens.Select.Carousel
 
         private int compareUsingAggregateMax(CarouselBeatmapSet other, Func<BeatmapInfo, double> func)
         {
-            var ourBeatmaps = ValidBeatmaps.Any();
-            var otherBeatmaps = other.ValidBeatmaps.Any();
+            bool ourBeatmaps = ValidBeatmaps.Any();
+            bool otherBeatmaps = other.ValidBeatmaps.Any();
 
             if (!ourBeatmaps && !otherBeatmaps) return 0;
             if (!ourBeatmaps) return -1;
diff --git a/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmapSet.cs b/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmapSet.cs
index 9773bd5ce9..173b804d90 100644
--- a/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmapSet.cs
+++ b/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmapSet.cs
@@ -241,7 +241,7 @@ namespace osu.Game.Screens.Select.Carousel
 
             TernaryState state;
 
-            var countExisting = beatmapSet.Beatmaps.Count(b => collection.Beatmaps.Contains(b));
+            int countExisting = beatmapSet.Beatmaps.Count(b => collection.Beatmaps.Contains(b));
 
             if (countExisting == beatmapSet.Beatmaps.Count)
                 state = TernaryState.True;
diff --git a/osu.Game/Screens/Select/Details/FailRetryGraph.cs b/osu.Game/Screens/Select/Details/FailRetryGraph.cs
index ecaf02cb30..312c55b242 100644
--- a/osu.Game/Screens/Select/Details/FailRetryGraph.cs
+++ b/osu.Game/Screens/Select/Details/FailRetryGraph.cs
@@ -27,9 +27,9 @@ namespace osu.Game.Screens.Select.Details
 
                 failTimes = value;
 
-                var retries = FailTimes?.Retries ?? Array.Empty<int>();
-                var fails = FailTimes?.Fails ?? Array.Empty<int>();
-                var retriesAndFails = sumRetriesAndFails(retries, fails);
+                int[] retries = FailTimes?.Retries ?? Array.Empty<int>();
+                int[] fails = FailTimes?.Fails ?? Array.Empty<int>();
+                int[] retriesAndFails = sumRetriesAndFails(retries, fails);
 
                 float maxValue = retriesAndFails.Any() ? retriesAndFails.Max() : 0;
                 failGraph.MaxValue = maxValue;
@@ -42,7 +42,7 @@ namespace osu.Game.Screens.Select.Details
 
         private int[] sumRetriesAndFails(int[] retries, int[] fails)
         {
-            var result = new int[Math.Max(retries.Length, fails.Length)];
+            int[] result = new int[Math.Max(retries.Length, fails.Length)];
 
             for (int i = 0; i < retries.Length; ++i)
                 result[i] = retries[i];
diff --git a/osu.Game/Screens/Select/Details/UserRatings.cs b/osu.Game/Screens/Select/Details/UserRatings.cs
index aa316d6e40..c2be3528fc 100644
--- a/osu.Game/Screens/Select/Details/UserRatings.cs
+++ b/osu.Game/Screens/Select/Details/UserRatings.cs
@@ -45,8 +45,8 @@ namespace osu.Game.Screens.Select.Details
                 {
                     var usableRange = Ratings.Skip(1).Take(rating_range); // adjust for API returning weird empty data at 0.
 
-                    var negativeCount = usableRange.Take(rating_range / 2).Sum();
-                    var totalCount = usableRange.Sum();
+                    int negativeCount = usableRange.Take(rating_range / 2).Sum();
+                    int totalCount = usableRange.Sum();
 
                     negativeRatings.Text = negativeCount.ToLocalisableString(@"N0");
                     positiveRatings.Text = (totalCount - negativeCount).ToLocalisableString(@"N0");
diff --git a/osu.Game/Screens/Select/FilterControl.cs b/osu.Game/Screens/Select/FilterControl.cs
index 298b6e49bd..e95bd7f653 100644
--- a/osu.Game/Screens/Select/FilterControl.cs
+++ b/osu.Game/Screens/Select/FilterControl.cs
@@ -39,7 +39,7 @@ namespace osu.Game.Screens.Select
         {
             Debug.Assert(ruleset.Value.ID != null);
 
-            var query = searchTextBox.Text;
+            string query = searchTextBox.Text;
 
             var criteria = new FilterCriteria
             {
diff --git a/osu.Game/Screens/Select/FilterQueryParser.cs b/osu.Game/Screens/Select/FilterQueryParser.cs
index a882148392..94df8addb3 100644
--- a/osu.Game/Screens/Select/FilterQueryParser.cs
+++ b/osu.Game/Screens/Select/FilterQueryParser.cs
@@ -22,9 +22,9 @@ namespace osu.Game.Screens.Select
         {
             foreach (Match match in query_syntax_regex.Matches(query))
             {
-                var key = match.Groups["key"].Value.ToLower();
+                string key = match.Groups["key"].Value.ToLower();
                 var op = parseOperator(match.Groups["op"].Value);
-                var value = match.Groups["value"].Value;
+                string value = match.Groups["value"].Value;
 
                 if (tryParseKeywordCriteria(criteria, key, value, op))
                     query = query.Replace(match.ToString(), "");
@@ -310,10 +310,10 @@ namespace osu.Game.Screens.Select
 
         private static bool tryUpdateLengthRange(FilterCriteria criteria, Operator op, string val)
         {
-            if (!tryParseDoubleWithPoint(val.TrimEnd('m', 's', 'h'), out var length))
+            if (!tryParseDoubleWithPoint(val.TrimEnd('m', 's', 'h'), out double length))
                 return false;
 
-            var scale = getLengthScale(val);
+            int scale = getLengthScale(val);
             return tryUpdateCriteriaRange(ref criteria.Length, op, length * scale, scale / 2.0);
         }
     }
diff --git a/osu.Game/Screens/Spectate/SpectatorScreen.cs b/osu.Game/Screens/Spectate/SpectatorScreen.cs
index 7861d4cb72..c8df01dae6 100644
--- a/osu.Game/Screens/Spectate/SpectatorScreen.cs
+++ b/osu.Game/Screens/Spectate/SpectatorScreen.cs
@@ -76,7 +76,7 @@ namespace osu.Game.Screens.Spectate
                 managerUpdated = beatmaps.ItemUpdated.GetBoundCopy();
                 managerUpdated.BindValueChanged(beatmapUpdated);
 
-                foreach (var (id, _) in userMap)
+                foreach ((int id, var _) in userMap)
                     spectatorClient.WatchUser(id);
             }));
         }
@@ -86,7 +86,7 @@ namespace osu.Game.Screens.Spectate
             if (!e.NewValue.TryGetTarget(out var beatmapSet))
                 return;
 
-            foreach (var (userId, _) in userMap)
+            foreach ((int userId, var _) in userMap)
             {
                 if (!playingUserStates.TryGetValue(userId, out var userState))
                     continue;
@@ -101,20 +101,20 @@ namespace osu.Game.Screens.Spectate
             switch (e.Action)
             {
                 case NotifyDictionaryChangedAction.Add:
-                    foreach (var (userId, state) in e.NewItems.AsNonNull())
+                    foreach ((int userId, var state) in e.NewItems.AsNonNull())
                         onUserStateAdded(userId, state);
                     break;
 
                 case NotifyDictionaryChangedAction.Remove:
-                    foreach (var (userId, _) in e.OldItems.AsNonNull())
+                    foreach ((int userId, var _) in e.OldItems.AsNonNull())
                         onUserStateRemoved(userId);
                     break;
 
                 case NotifyDictionaryChangedAction.Replace:
-                    foreach (var (userId, _) in e.OldItems.AsNonNull())
+                    foreach ((int userId, var _) in e.OldItems.AsNonNull())
                         onUserStateRemoved(userId);
 
-                    foreach (var (userId, state) in e.NewItems.AsNonNull())
+                    foreach ((int userId, var state) in e.NewItems.AsNonNull())
                         onUserStateAdded(userId, state);
                     break;
             }
@@ -219,7 +219,7 @@ namespace osu.Game.Screens.Spectate
 
             if (spectatorClient != null)
             {
-                foreach (var (userId, _) in userMap)
+                foreach ((int userId, var _) in userMap)
                     spectatorClient.StopWatchingUser(userId);
             }
 
diff --git a/osu.Game/Skinning/DefaultSkin.cs b/osu.Game/Skinning/DefaultSkin.cs
index 8e03bddb4d..495f476417 100644
--- a/osu.Game/Skinning/DefaultSkin.cs
+++ b/osu.Game/Skinning/DefaultSkin.cs
@@ -42,7 +42,7 @@ namespace osu.Game.Skinning
 
         public override ISample GetSample(ISampleInfo sampleInfo)
         {
-            foreach (var lookup in sampleInfo.LookupNames)
+            foreach (string lookup in sampleInfo.LookupNames)
             {
                 var sample = resources.AudioManager.Samples.Get(lookup);
                 if (sample != null)
diff --git a/osu.Game/Skinning/Editor/SkinBlueprintContainer.cs b/osu.Game/Skinning/Editor/SkinBlueprintContainer.cs
index c0cc2ab40e..d67bfb89ab 100644
--- a/osu.Game/Skinning/Editor/SkinBlueprintContainer.cs
+++ b/osu.Game/Skinning/Editor/SkinBlueprintContainer.cs
@@ -41,7 +41,7 @@ namespace osu.Game.Skinning.Editor
 
             if (targetContainers.Length == 0)
             {
-                var targetScreen = target.ChildrenOfType<Screen>().LastOrDefault()?.GetType().Name ?? "this screen";
+                string targetScreen = target.ChildrenOfType<Screen>().LastOrDefault()?.GetType().Name ?? "this screen";
 
                 AddInternal(new ScreenWhiteBox.UnderConstructionMessage(targetScreen, "doesn't support skin customisation just yet."));
                 return;
diff --git a/osu.Game/Skinning/LegacyManiaSkinDecoder.cs b/osu.Game/Skinning/LegacyManiaSkinDecoder.cs
index 5308640bdd..7214c847a7 100644
--- a/osu.Game/Skinning/LegacyManiaSkinDecoder.cs
+++ b/osu.Game/Skinning/LegacyManiaSkinDecoder.cs
@@ -66,7 +66,7 @@ namespace osu.Game.Skinning
         {
             Debug.Assert(currentConfig != null);
 
-            foreach (var line in pendingLines)
+            foreach (string line in pendingLines)
             {
                 var pair = SplitKeyVal(line);
 
diff --git a/osu.Game/Skinning/LegacySkin.cs b/osu.Game/Skinning/LegacySkin.cs
index b09620411b..ad40f2c775 100644
--- a/osu.Game/Skinning/LegacySkin.cs
+++ b/osu.Game/Skinning/LegacySkin.cs
@@ -306,7 +306,7 @@ namespace osu.Game.Skinning
             => source.CustomColours.TryGetValue(lookup, out var col) ? new Bindable<Color4>(col) : null;
 
         private IBindable<string> getManiaImage(LegacyManiaSkinConfiguration source, string lookup)
-            => source.ImageLookups.TryGetValue(lookup, out var image) ? new Bindable<string>(image) : null;
+            => source.ImageLookups.TryGetValue(lookup, out string image) ? new Bindable<string>(image) : null;
 
         [CanBeNull]
         private IBindable<TValue> legacySettingLookup<TValue>(LegacySkinConfiguration.LegacySetting legacySetting)
@@ -326,7 +326,7 @@ namespace osu.Game.Skinning
         {
             try
             {
-                if (Configuration.ConfigDictionary.TryGetValue(lookup.ToString(), out var val))
+                if (Configuration.ConfigDictionary.TryGetValue(lookup.ToString(), out string val))
                 {
                     // special case for handling skins which use 1 or 0 to signify a boolean state.
                     if (typeof(TValue) == typeof(bool))
@@ -472,7 +472,7 @@ namespace osu.Game.Skinning
 
         public override Texture GetTexture(string componentName, WrapMode wrapModeS, WrapMode wrapModeT)
         {
-            foreach (var name in getFallbackNames(componentName))
+            foreach (string name in getFallbackNames(componentName))
             {
                 float ratio = 2;
                 var texture = Textures?.Get($"{name}@2x", wrapModeS, wrapModeT);
@@ -504,7 +504,7 @@ namespace osu.Game.Skinning
                 lookupNames = sampleInfo.LookupNames.SelectMany(getFallbackNames);
             }
 
-            foreach (var lookup in lookupNames)
+            foreach (string lookup in lookupNames)
             {
                 var sample = Samples?.Get(lookup);
 
@@ -529,7 +529,7 @@ namespace osu.Game.Skinning
                 lookupNames = lookupNames.Where(name => !name.EndsWith(hitSample.Suffix, StringComparison.Ordinal));
             }
 
-            foreach (var l in lookupNames)
+            foreach (string l in lookupNames)
                 yield return l;
 
             // also for compatibility, try falling back to non-bank samples (so-called "universal" samples) as the last resort.
diff --git a/osu.Game/Skinning/LegacySkinDecoder.cs b/osu.Game/Skinning/LegacySkinDecoder.cs
index 2700f84815..a4ce3d83ce 100644
--- a/osu.Game/Skinning/LegacySkinDecoder.cs
+++ b/osu.Game/Skinning/LegacySkinDecoder.cs
@@ -35,7 +35,7 @@ namespace osu.Game.Skinning
                             case @"Version":
                                 if (pair.Value == "latest")
                                     skin.LegacyVersion = LegacySkinConfiguration.LATEST_VERSION;
-                                else if (decimal.TryParse(pair.Value, NumberStyles.AllowDecimalPoint, CultureInfo.InvariantCulture, out var version))
+                                else if (decimal.TryParse(pair.Value, NumberStyles.AllowDecimalPoint, CultureInfo.InvariantCulture, out decimal version))
                                     skin.LegacyVersion = version;
 
                                 return;
diff --git a/osu.Game/Skinning/LegacySkinResourceStore.cs b/osu.Game/Skinning/LegacySkinResourceStore.cs
index 05d0dee05f..fb06bb54d0 100644
--- a/osu.Game/Skinning/LegacySkinResourceStore.cs
+++ b/osu.Game/Skinning/LegacySkinResourceStore.cs
@@ -26,9 +26,9 @@ namespace osu.Game.Skinning
             if (source.Files == null)
                 yield break;
 
-            foreach (var filename in base.GetFilenames(name))
+            foreach (string filename in base.GetFilenames(name))
             {
-                var path = getPathForFile(filename.ToStandardisedPath());
+                string path = getPathForFile(filename.ToStandardisedPath());
                 if (path != null)
                     yield return path;
             }
diff --git a/osu.Game/Skinning/LegacySpriteText.cs b/osu.Game/Skinning/LegacySpriteText.cs
index 8fc6cbde7d..94383834fc 100644
--- a/osu.Game/Skinning/LegacySpriteText.cs
+++ b/osu.Game/Skinning/LegacySpriteText.cs
@@ -49,7 +49,7 @@ namespace osu.Game.Skinning
 
             public ITexturedCharacterGlyph Get(string fontName, char character)
             {
-                var lookup = getLookupName(character);
+                string lookup = getLookupName(character);
 
                 var texture = skin.GetTexture($"{fontName}-{lookup}");
 
diff --git a/osu.Game/Skinning/ResourceStoreBackedSkin.cs b/osu.Game/Skinning/ResourceStoreBackedSkin.cs
index f041b82cf4..4787b5a4e9 100644
--- a/osu.Game/Skinning/ResourceStoreBackedSkin.cs
+++ b/osu.Game/Skinning/ResourceStoreBackedSkin.cs
@@ -36,7 +36,7 @@ namespace osu.Game.Skinning
 
         public ISample? GetSample(ISampleInfo sampleInfo)
         {
-            foreach (var lookup in sampleInfo.LookupNames)
+            foreach (string? lookup in sampleInfo.LookupNames)
             {
                 ISample? sample = samples.Get(lookup);
                 if (sample != null)
diff --git a/osu.Game/Skinning/Skin.cs b/osu.Game/Skinning/Skin.cs
index 92441f40da..f0413ff310 100644
--- a/osu.Game/Skinning/Skin.cs
+++ b/osu.Game/Skinning/Skin.cs
@@ -51,7 +51,7 @@ namespace osu.Game.Skinning
                 if (fileInfo == null)
                     continue;
 
-                var bytes = resources?.Files.Get(fileInfo.FileInfo.StoragePath);
+                byte[] bytes = resources?.Files.Get(fileInfo.FileInfo.StoragePath);
 
                 if (bytes == null)
                     continue;
diff --git a/osu.Game/Stores/BeatmapImporter.cs b/osu.Game/Stores/BeatmapImporter.cs
index 254127cc7e..787b1ddd60 100644
--- a/osu.Game/Stores/BeatmapImporter.cs
+++ b/osu.Game/Stores/BeatmapImporter.cs
@@ -123,7 +123,7 @@ namespace osu.Game.Stores
             // find any existing beatmaps in the database that have matching online ids
             List<RealmBeatmap> existingBeatmaps = new List<RealmBeatmap>();
 
-            foreach (var id in beatmapIds)
+            foreach (int id in beatmapIds)
                 existingBeatmaps.AddRange(realm.All<RealmBeatmap>().Where(b => b.OnlineID == id));
 
             if (existingBeatmaps.Any())
diff --git a/osu.Game/Stores/RealmArchiveModelImporter.cs b/osu.Game/Stores/RealmArchiveModelImporter.cs
index ec454d25fa..3398cc114d 100644
--- a/osu.Game/Stores/RealmArchiveModelImporter.cs
+++ b/osu.Game/Stores/RealmArchiveModelImporter.cs
@@ -426,7 +426,7 @@ namespace osu.Game.Stores
         {
             MemoryStream hashable = new MemoryStream();
 
-            foreach (var file in reader.Filenames.Where(f => HashableFileTypes.Any(ext => f.EndsWith(ext, StringComparison.OrdinalIgnoreCase))).OrderBy(f => f))
+            foreach (string? file in reader.Filenames.Where(f => HashableFileTypes.Any(ext => f.EndsWith(ext, StringComparison.OrdinalIgnoreCase))).OrderBy(f => f))
             {
                 using (Stream s = reader.GetStream(file))
                     s.CopyTo(hashable);
diff --git a/osu.Game/Stores/RealmRulesetStore.cs b/osu.Game/Stores/RealmRulesetStore.cs
index 27eb5d797f..eea9acea05 100644
--- a/osu.Game/Stores/RealmRulesetStore.cs
+++ b/osu.Game/Stores/RealmRulesetStore.cs
@@ -193,7 +193,7 @@ namespace osu.Game.Stores
         {
             var rulesets = rulesetStorage.GetFiles(@".", @$"{ruleset_library_prefix}.*.dll");
 
-            foreach (var ruleset in rulesets.Where(f => !f.Contains(@"Tests")))
+            foreach (string? ruleset in rulesets.Where(f => !f.Contains(@"Tests")))
                 loadRulesetFromFile(rulesetStorage.GetFullPath(ruleset));
         }
 
@@ -201,7 +201,7 @@ namespace osu.Game.Stores
         {
             try
             {
-                var files = Directory.GetFiles(RuntimeInfo.StartupDirectory, @$"{ruleset_library_prefix}.*.dll");
+                string[]? files = Directory.GetFiles(RuntimeInfo.StartupDirectory, @$"{ruleset_library_prefix}.*.dll");
 
                 foreach (string file in files.Where(f => !Path.GetFileName(f).Contains("Tests")))
                     loadRulesetFromFile(file);
@@ -214,7 +214,7 @@ namespace osu.Game.Stores
 
         private void loadRulesetFromFile(string file)
         {
-            var filename = Path.GetFileNameWithoutExtension(file);
+            string? filename = Path.GetFileNameWithoutExtension(file);
 
             if (loadedAssemblies.Values.Any(t => Path.GetFileNameWithoutExtension(t.Assembly.Location) == filename))
                 return;
diff --git a/osu.Game/Storyboards/CommandLoop.cs b/osu.Game/Storyboards/CommandLoop.cs
index 66db965803..0713cb8670 100644
--- a/osu.Game/Storyboards/CommandLoop.cs
+++ b/osu.Game/Storyboards/CommandLoop.cs
@@ -33,9 +33,9 @@ namespace osu.Game.Storyboards
 
         public override IEnumerable<CommandTimeline<T>.TypedCommand> GetCommands<T>(CommandTimelineSelector<T> timelineSelector, double offset = 0)
         {
-            for (var loop = 0; loop < TotalIterations; loop++)
+            for (int loop = 0; loop < TotalIterations; loop++)
             {
-                var loopOffset = LoopStartTime + loop * CommandsDuration;
+                double loopOffset = LoopStartTime + loop * CommandsDuration;
                 foreach (var command in base.GetCommands(timelineSelector, offset + loopOffset))
                     yield return command;
             }
diff --git a/osu.Game/Storyboards/CommandTimeline.cs b/osu.Game/Storyboards/CommandTimeline.cs
index c71806352d..8ded3ee975 100644
--- a/osu.Game/Storyboards/CommandTimeline.cs
+++ b/osu.Game/Storyboards/CommandTimeline.cs
@@ -57,7 +57,7 @@ namespace osu.Game.Storyboards
 
             public int CompareTo(ICommand other)
             {
-                var result = StartTime.CompareTo(other.StartTime);
+                int result = StartTime.CompareTo(other.StartTime);
                 if (result != 0) return result;
 
                 return EndTime.CompareTo(other.EndTime);
diff --git a/osu.Game/Storyboards/CommandTimelineGroup.cs b/osu.Game/Storyboards/CommandTimelineGroup.cs
index c478b91c22..e7de135ce8 100644
--- a/osu.Game/Storyboards/CommandTimelineGroup.cs
+++ b/osu.Game/Storyboards/CommandTimelineGroup.cs
@@ -65,7 +65,7 @@ namespace osu.Game.Storyboards
             {
                 // if the first alpha command starts at zero it should be given priority over anything else.
                 // this is due to it creating a state where the target is not present before that time, causing any other events to not be visible.
-                var earliestDisplay = EarliestDisplayedTime;
+                double? earliestDisplay = EarliestDisplayedTime;
                 if (earliestDisplay != null)
                     return earliestDisplay.Value;
 
diff --git a/osu.Game/Storyboards/Drawables/DrawableStoryboardVideo.cs b/osu.Game/Storyboards/Drawables/DrawableStoryboardVideo.cs
index d746ff5ae5..d21616955a 100644
--- a/osu.Game/Storyboards/Drawables/DrawableStoryboardVideo.cs
+++ b/osu.Game/Storyboards/Drawables/DrawableStoryboardVideo.cs
@@ -29,7 +29,7 @@ namespace osu.Game.Storyboards.Drawables
         [BackgroundDependencyLoader(true)]
         private void load(IBindable<WorkingBeatmap> beatmap, TextureStore textureStore)
         {
-            var path = beatmap.Value.BeatmapSetInfo?.Files.Find(f => f.Filename.Equals(Video.Path, StringComparison.OrdinalIgnoreCase))?.FileInfo.StoragePath;
+            string path = beatmap.Value.BeatmapSetInfo?.Files.Find(f => f.Filename.Equals(Video.Path, StringComparison.OrdinalIgnoreCase))?.FileInfo.StoragePath;
 
             if (path == null)
                 return;
diff --git a/osu.Game/Storyboards/Storyboard.cs b/osu.Game/Storyboards/Storyboard.cs
index 38e0e4e38c..a25bf24491 100644
--- a/osu.Game/Storyboards/Storyboard.cs
+++ b/osu.Game/Storyboards/Storyboard.cs
@@ -77,7 +77,7 @@ namespace osu.Game.Storyboards
         {
             get
             {
-                var backgroundPath = BeatmapInfo.BeatmapSet?.Metadata?.BackgroundFile?.ToLowerInvariant();
+                string backgroundPath = BeatmapInfo.BeatmapSet?.Metadata?.BackgroundFile?.ToLowerInvariant();
                 if (backgroundPath == null)
                     return false;
 
@@ -91,7 +91,7 @@ namespace osu.Game.Storyboards
         public Drawable CreateSpriteFromResourcePath(string path, TextureStore textureStore)
         {
             Drawable drawable = null;
-            var storyboardPath = BeatmapInfo.BeatmapSet?.Files.Find(f => f.Filename.Equals(path, StringComparison.OrdinalIgnoreCase))?.FileInfo.StoragePath;
+            string storyboardPath = BeatmapInfo.BeatmapSet?.Files.Find(f => f.Filename.Equals(path, StringComparison.OrdinalIgnoreCase))?.FileInfo.StoragePath;
 
             if (storyboardPath != null)
                 drawable = new Sprite { Texture = textureStore.Get(storyboardPath) };
diff --git a/osu.Game/Tests/Beatmaps/BeatmapConversionTest.cs b/osu.Game/Tests/Beatmaps/BeatmapConversionTest.cs
index 6d63525011..651874e4de 100644
--- a/osu.Game/Tests/Beatmaps/BeatmapConversionTest.cs
+++ b/osu.Game/Tests/Beatmaps/BeatmapConversionTest.cs
@@ -150,7 +150,7 @@ namespace osu.Game.Tests.Beatmaps
             using (var resStream = openResource($"{resource_namespace}.{name}{expected_conversion_suffix}.json"))
             using (var reader = new StreamReader(resStream))
             {
-                var contents = reader.ReadToEnd();
+                string contents = reader.ReadToEnd();
                 return JsonConvert.DeserializeObject<ConvertResult>(contents);
             }
         }
@@ -173,7 +173,7 @@ namespace osu.Game.Tests.Beatmaps
 
         private Stream openResource(string name)
         {
-            var localPath = Path.GetDirectoryName(Uri.UnescapeDataString(new UriBuilder(Assembly.GetExecutingAssembly().CodeBase).Path)).AsNonNull();
+            string localPath = Path.GetDirectoryName(Uri.UnescapeDataString(new UriBuilder(Assembly.GetExecutingAssembly().CodeBase).Path)).AsNonNull();
             return Assembly.LoadFrom(Path.Combine(localPath, $"{ResourceAssembly}.dll")).GetManifestResourceStream($@"{ResourceAssembly}.Resources.{name}");
         }
 
diff --git a/osu.Game/Tests/Beatmaps/DifficultyCalculatorTest.cs b/osu.Game/Tests/Beatmaps/DifficultyCalculatorTest.cs
index fdb3e1d465..e5b641b606 100644
--- a/osu.Game/Tests/Beatmaps/DifficultyCalculatorTest.cs
+++ b/osu.Game/Tests/Beatmaps/DifficultyCalculatorTest.cs
@@ -49,7 +49,7 @@ namespace osu.Game.Tests.Beatmaps
 
         private Stream openResource(string name)
         {
-            var localPath = Path.GetDirectoryName(Uri.UnescapeDataString(new UriBuilder(Assembly.GetExecutingAssembly().CodeBase).Path)).AsNonNull();
+            string localPath = Path.GetDirectoryName(Uri.UnescapeDataString(new UriBuilder(Assembly.GetExecutingAssembly().CodeBase).Path)).AsNonNull();
             return Assembly.LoadFrom(Path.Combine(localPath, $"{ResourceAssembly}.dll")).GetManifestResourceStream($@"{ResourceAssembly}.Resources.{name}");
         }
 
diff --git a/osu.Game/Tests/Visual/DependencyProvidingContainer.cs b/osu.Game/Tests/Visual/DependencyProvidingContainer.cs
index c799cad61a..d1290fc5ac 100644
--- a/osu.Game/Tests/Visual/DependencyProvidingContainer.cs
+++ b/osu.Game/Tests/Visual/DependencyProvidingContainer.cs
@@ -25,7 +25,7 @@ namespace osu.Game.Tests.Visual
         {
             var dependencyContainer = new DependencyContainer(base.CreateChildDependencies(parent));
 
-            foreach (var (type, value) in CachedDependencies)
+            foreach ((var type, object value) in CachedDependencies)
                 dependencyContainer.CacheAs(type, value);
 
             return dependencyContainer;
diff --git a/osu.Game/Tests/Visual/SkinnableTestScene.cs b/osu.Game/Tests/Visual/SkinnableTestScene.cs
index ef44d0df24..000e7194bc 100644
--- a/osu.Game/Tests/Visual/SkinnableTestScene.cs
+++ b/osu.Game/Tests/Visual/SkinnableTestScene.cs
@@ -127,7 +127,7 @@ namespace osu.Game.Tests.Visual
 
             void updateSizing()
             {
-                var autoSize = created.RelativeSizeAxes == Axes.None;
+                bool autoSize = created.RelativeSizeAxes == Axes.None;
 
                 foreach (var c in new[] { mainProvider, childContainer, skinProvider })
                 {
@@ -202,7 +202,7 @@ namespace osu.Game.Tests.Visual
                 {
                     var match = Regex.Match(componentName, "-([0-9]*)");
 
-                    if (match.Length > 0 && int.TryParse(match.Groups[1].Value, out var number) && number < 60)
+                    if (match.Length > 0 && int.TryParse(match.Groups[1].Value, out int number) && number < 60)
                         return base.GetTexture(componentName.Replace($"-{number}", $"-{number % 2}"), wrapModeS, wrapModeT);
                 }
 
diff --git a/osu.Game/Updater/SimpleUpdateManager.cs b/osu.Game/Updater/SimpleUpdateManager.cs
index e0409e34df..5e466cc57f 100644
--- a/osu.Game/Updater/SimpleUpdateManager.cs
+++ b/osu.Game/Updater/SimpleUpdateManager.cs
@@ -45,7 +45,7 @@ namespace osu.Game.Updater
                 // avoid any discrepancies due to build suffixes for now.
                 // eventually we will want to support release streams and consider these.
                 version = version.Split('-').First();
-                var latestTagName = latest.TagName.Split('-').First();
+                string latestTagName = latest.TagName.Split('-').First();
 
                 if (latestTagName != version)
                 {
diff --git a/osu.Game/Updater/UpdateManager.cs b/osu.Game/Updater/UpdateManager.cs
index 98ce2cb46c..28b828804c 100644
--- a/osu.Game/Updater/UpdateManager.cs
+++ b/osu.Game/Updater/UpdateManager.cs
@@ -39,9 +39,9 @@ namespace osu.Game.Updater
 
             Schedule(() => Task.Run(CheckForUpdateAsync));
 
-            var version = game.Version;
+            string version = game.Version;
 
-            var lastVersion = config.Get<string>(OsuSetting.Version);
+            string lastVersion = config.Get<string>(OsuSetting.Version);
 
             if (game.IsDeployedBuild && version != lastVersion)
             {
diff --git a/osu.Game/Utils/StatelessRNG.cs b/osu.Game/Utils/StatelessRNG.cs
index cd169229e3..3db632fc42 100644
--- a/osu.Game/Utils/StatelessRNG.cs
+++ b/osu.Game/Utils/StatelessRNG.cs
@@ -37,7 +37,7 @@ namespace osu.Game.Utils
         {
             unchecked
             {
-                var combined = ((ulong)(uint)series << 32) | (uint)seed;
+                ulong combined = ((ulong)(uint)series << 32) | (uint)seed;
                 // The xor operation is to not map (0, 0) to 0.
                 return mix(combined ^ 0x12345678);
             }

From 95837990f3a185abc9acf50f170ea387cdd8adcf Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 27 Oct 2021 13:09:30 +0900
Subject: [PATCH 0501/5547] Apply some second-pass inspections that appeared
 after previous changes

---
 .../MathUtils/LegacySortHelper.cs                | 16 +++-------------
 .../TestSceneSampleOutput.cs                     |  3 ++-
 .../Multiplayer/TestSceneMultiSpectatorScreen.cs |  2 +-
 osu.Game/Database/RealmContextFactory.cs         |  2 +-
 osu.Game/Online/Chat/MessageFormatter.cs         |  2 +-
 osu.Game/Stores/RealmRulesetStore.cs             |  2 +-
 6 files changed, 9 insertions(+), 18 deletions(-)

diff --git a/osu.Game.Rulesets.Mania/MathUtils/LegacySortHelper.cs b/osu.Game.Rulesets.Mania/MathUtils/LegacySortHelper.cs
index a0e2958bae..5c595323c3 100644
--- a/osu.Game.Rulesets.Mania/MathUtils/LegacySortHelper.cs
+++ b/osu.Game.Rulesets.Mania/MathUtils/LegacySortHelper.cs
@@ -62,9 +62,7 @@ namespace osu.Game.Rulesets.Mania.MathUtils
 
                     if (i < j)
                     {
-                        T key = keys[i];
-                        keys[i] = keys[j];
-                        keys[j] = key;
+                        (keys[i], keys[j]) = (keys[j], keys[i]);
                     }
 
                     i++;
@@ -142,11 +140,7 @@ namespace osu.Game.Rulesets.Mania.MathUtils
         private static void swap(T[] a, int i, int j)
         {
             if (i != j)
-            {
-                T t = a[i];
-                a[i] = a[j];
-                a[j] = t;
-            }
+                (a[i], a[j]) = (a[j], a[i]);
         }
 
         private static void swapIfGreater(T[] keys, IComparer<T> comparer, int a, int b)
@@ -154,11 +148,7 @@ namespace osu.Game.Rulesets.Mania.MathUtils
             if (a != b)
             {
                 if (comparer.Compare(keys[a], keys[b]) > 0)
-                {
-                    T key = keys[a];
-                    keys[a] = keys[b];
-                    keys[b] = key;
-                }
+                    (keys[a], keys[b]) = (keys[b], keys[a]);
             }
         }
     }
diff --git a/osu.Game.Rulesets.Taiko.Tests/TestSceneSampleOutput.cs b/osu.Game.Rulesets.Taiko.Tests/TestSceneSampleOutput.cs
index 97c8d9eeb5..e5c9358c26 100644
--- a/osu.Game.Rulesets.Taiko.Tests/TestSceneSampleOutput.cs
+++ b/osu.Game.Rulesets.Taiko.Tests/TestSceneSampleOutput.cs
@@ -20,7 +20,7 @@ namespace osu.Game.Rulesets.Taiko.Tests
         {
             base.SetUpSteps();
 
-            string[] expectedSampleNames = new[]
+            string[] expectedSampleNames =
             {
                 string.Empty,
                 string.Empty,
@@ -31,6 +31,7 @@ namespace osu.Game.Rulesets.Taiko.Tests
                 HitSampleInfo.HIT_WHISTLE,
                 HitSampleInfo.HIT_WHISTLE,
             };
+
             var actualSampleNames = new List<string>();
 
             // due to pooling we can't access all samples right away due to object re-use,
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs
index 8d878b993c..7ff8c82145 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs
@@ -289,7 +289,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [Test]
         public void TestSpectatingDuringGameplay()
         {
-            int[] players = new[] { PLAYER_1_ID, PLAYER_2_ID };
+            int[] players = { PLAYER_1_ID, PLAYER_2_ID };
 
             start(players);
             sendFrames(players, 300);
diff --git a/osu.Game/Database/RealmContextFactory.cs b/osu.Game/Database/RealmContextFactory.cs
index ffb1c96261..013a2e9d64 100644
--- a/osu.Game/Database/RealmContextFactory.cs
+++ b/osu.Game/Database/RealmContextFactory.cs
@@ -156,7 +156,7 @@ namespace osu.Game.Database
 
                 void convertOnlineIDs<T>() where T : RealmObject
                 {
-                    string? className = typeof(T).Name.Replace(@"Realm", string.Empty);
+                    string className = typeof(T).Name.Replace(@"Realm", string.Empty);
 
                     // version was not bumped when the beatmap/ruleset models were added
                     // therefore we must manually check for their presence to avoid throwing on the `DynamicApi` calls.
diff --git a/osu.Game/Online/Chat/MessageFormatter.cs b/osu.Game/Online/Chat/MessageFormatter.cs
index 5a90638dcd..5e0f66443b 100644
--- a/osu.Game/Online/Chat/MessageFormatter.cs
+++ b/osu.Game/Online/Chat/MessageFormatter.cs
@@ -136,7 +136,7 @@ namespace osu.Game.Online.Chat
                     // length > 3 since all these links need another argument to work
                     if (args.Length > 3 && args[1].EndsWith(websiteRootUrl, StringComparison.OrdinalIgnoreCase))
                     {
-                        string? mainArg = args[3];
+                        string mainArg = args[3];
 
                         switch (args[2])
                         {
diff --git a/osu.Game/Stores/RealmRulesetStore.cs b/osu.Game/Stores/RealmRulesetStore.cs
index eea9acea05..e9c04f652d 100644
--- a/osu.Game/Stores/RealmRulesetStore.cs
+++ b/osu.Game/Stores/RealmRulesetStore.cs
@@ -201,7 +201,7 @@ namespace osu.Game.Stores
         {
             try
             {
-                string[]? files = Directory.GetFiles(RuntimeInfo.StartupDirectory, @$"{ruleset_library_prefix}.*.dll");
+                string[] files = Directory.GetFiles(RuntimeInfo.StartupDirectory, @$"{ruleset_library_prefix}.*.dll");
 
                 foreach (string file in files.Where(f => !Path.GetFileName(f).Contains("Tests")))
                     loadRulesetFromFile(file);

From 2bc242001217920324cbddb9bc462e005a2632f0 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 27 Oct 2021 13:54:20 +0900
Subject: [PATCH 0502/5547] Rename test scene

It's not testing the sub-screen. It's testing creating playlists.
---
 ...nePlaylistsRoomSubScreen.cs => TestScenePlaylistCreation.cs} | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
 rename osu.Game.Tests/Visual/Playlists/{TestScenePlaylistsRoomSubScreen.cs => TestScenePlaylistCreation.cs} (98%)

diff --git a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomSubScreen.cs b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistCreation.cs
similarity index 98%
rename from osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomSubScreen.cs
rename to osu.Game.Tests/Visual/Playlists/TestScenePlaylistCreation.cs
index deb9a22184..300a164644 100644
--- a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomSubScreen.cs
+++ b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistCreation.cs
@@ -22,7 +22,7 @@ using osuTK.Input;
 
 namespace osu.Game.Tests.Visual.Playlists
 {
-    public class TestScenePlaylistsRoomSubScreen : OnlinePlayTestScene
+    public class TestScenePlaylistCreation : OnlinePlayTestScene
     {
         private BeatmapManager manager;
         private RulesetStore rulesets;

From c4a253cc75d5ece03ff3d44eb582c198877319f5 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 27 Oct 2021 13:55:14 +0900
Subject: [PATCH 0503/5547] Replace local instantiation of `TestBeatmap` with
 helper method

---
 .../Visual/Playlists/TestScenePlaylistCreation.cs   | 13 ++++++-------
 1 file changed, 6 insertions(+), 7 deletions(-)

diff --git a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistCreation.cs b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistCreation.cs
index 300a164644..a0b51610ec 100644
--- a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistCreation.cs
+++ b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistCreation.cs
@@ -16,7 +16,6 @@ using osu.Game.Rulesets;
 using osu.Game.Rulesets.Osu;
 using osu.Game.Screens.OnlinePlay.Playlists;
 using osu.Game.Screens.Play;
-using osu.Game.Tests.Beatmaps;
 using osu.Game.Tests.Visual.OnlinePlay;
 using osuTK.Input;
 
@@ -40,7 +39,7 @@ namespace osu.Game.Tests.Visual.Playlists
         public void SetupSteps()
         {
             AddStep("set room", () => SelectedRoom.Value = new Room());
-            AddStep("ensure has beatmap", () => manager.Import(new TestBeatmap(new OsuRuleset().RulesetInfo).BeatmapInfo.BeatmapSet).Wait());
+            AddStep("ensure has beatmap", () => manager.Import(CreateBeatmap(new OsuRuleset().RulesetInfo).BeatmapInfo.BeatmapSet).Wait());
             AddStep("load match", () => LoadScreen(match = new TestPlaylistsRoomSubScreen(SelectedRoom.Value)));
             AddUntilStep("wait for load", () => match.IsCurrentScreen());
         }
@@ -57,7 +56,7 @@ namespace osu.Game.Tests.Visual.Playlists
                 SelectedRoom.Value.EndDate.Value = DateTimeOffset.Now.AddMinutes(5);
                 SelectedRoom.Value.Playlist.Add(new PlaylistItem
                 {
-                    Beatmap = { Value = new TestBeatmap(new OsuRuleset().RulesetInfo).BeatmapInfo },
+                    Beatmap = { Value = CreateBeatmap(new OsuRuleset().RulesetInfo).BeatmapInfo },
                     Ruleset = { Value = new OsuRuleset().RulesetInfo }
                 });
             });
@@ -75,7 +74,7 @@ namespace osu.Game.Tests.Visual.Playlists
                 SelectedRoom.Value.Host.Value = API.LocalUser.Value;
                 SelectedRoom.Value.Playlist.Add(new PlaylistItem
                 {
-                    Beatmap = { Value = new TestBeatmap(new OsuRuleset().RulesetInfo).BeatmapInfo },
+                    Beatmap = { Value = CreateBeatmap(new OsuRuleset().RulesetInfo).BeatmapInfo },
                     Ruleset = { Value = new OsuRuleset().RulesetInfo }
                 });
             });
@@ -94,13 +93,13 @@ namespace osu.Game.Tests.Visual.Playlists
         public void TestBeatmapUpdatedOnReImport()
         {
             BeatmapSetInfo importedSet = null;
-            TestBeatmap beatmap = null;
+            IBeatmap beatmap = null;
 
             // this step is required to make sure the further imports actually get online IDs.
             // all the playlist logic relies on online ID matching.
             AddStep("remove all matching online IDs", () =>
             {
-                beatmap = new TestBeatmap(new OsuRuleset().RulesetInfo);
+                beatmap = CreateBeatmap(new OsuRuleset().RulesetInfo);
 
                 var existing = manager.QueryBeatmapSets(s => s.OnlineBeatmapSetID == beatmap.BeatmapInfo.BeatmapSet.OnlineBeatmapSetID).ToList();
 
@@ -139,7 +138,7 @@ namespace osu.Game.Tests.Visual.Playlists
 
             AddAssert("match has altered beatmap", () => match.Beatmap.Value.Beatmap.Difficulty.CircleSize == 1);
 
-            AddStep("re-import original beatmap", () => manager.Import(new TestBeatmap(new OsuRuleset().RulesetInfo).BeatmapInfo.BeatmapSet).Wait());
+            AddStep("re-import original beatmap", () => manager.Import(CreateBeatmap(new OsuRuleset().RulesetInfo).BeatmapInfo.BeatmapSet).Wait());
 
             AddAssert("match has original beatmap", () => match.Beatmap.Value.Beatmap.Difficulty.CircleSize != 1);
         }

From 84bb3a962b9def275ce92d29cb386b16913308a0 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 27 Oct 2021 14:11:07 +0900
Subject: [PATCH 0504/5547] Centralise room "creation"

---
 .../Playlists/TestScenePlaylistCreation.cs    | 46 +++++++++++++------
 1 file changed, 31 insertions(+), 15 deletions(-)

diff --git a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistCreation.cs b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistCreation.cs
index a0b51610ec..9ee0fb4db5 100644
--- a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistCreation.cs
+++ b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistCreation.cs
@@ -47,18 +47,20 @@ namespace osu.Game.Tests.Visual.Playlists
         [Test]
         public void TestLoadSimpleMatch()
         {
-            AddStep("set room properties", () =>
+            setupRoom(room =>
             {
-                SelectedRoom.Value.RoomID.Value = 1;
-                SelectedRoom.Value.Name.Value = "my awesome room";
-                SelectedRoom.Value.Host.Value = API.LocalUser.Value;
-                SelectedRoom.Value.RecentParticipants.Add(SelectedRoom.Value.Host.Value);
-                SelectedRoom.Value.EndDate.Value = DateTimeOffset.Now.AddMinutes(5);
-                SelectedRoom.Value.Playlist.Add(new PlaylistItem
+                room.RoomID.Value = 1; // forces room creation.
+                room.Name.Value = "my awesome room";
+                room.Host.Value = API.LocalUser.Value;
+                room.RecentParticipants.Add(room.Host.Value);
+                room.EndDate.Value = DateTimeOffset.Now.AddMinutes(5);
+                room.Playlist.Add(new PlaylistItem
                 {
                     Beatmap = { Value = CreateBeatmap(new OsuRuleset().RulesetInfo).BeatmapInfo },
                     Ruleset = { Value = new OsuRuleset().RulesetInfo }
                 });
+
+                OnlinePlayDependencies.RoomManager.CreateRoom(SelectedRoom.Value);
             });
 
             AddStep("start match", () => match.ChildrenOfType<PlaylistsReadyButton>().First().TriggerClick());
@@ -68,15 +70,17 @@ namespace osu.Game.Tests.Visual.Playlists
         [Test]
         public void TestPlaylistItemSelectedOnCreate()
         {
-            AddStep("set room properties", () =>
+            setupRoom(room =>
             {
-                SelectedRoom.Value.Name.Value = "my awesome room";
-                SelectedRoom.Value.Host.Value = API.LocalUser.Value;
-                SelectedRoom.Value.Playlist.Add(new PlaylistItem
+                room.Name.Value = "my awesome room";
+                room.Host.Value = API.LocalUser.Value;
+                room.Playlist.Add(new PlaylistItem
                 {
                     Beatmap = { Value = CreateBeatmap(new OsuRuleset().RulesetInfo).BeatmapInfo },
                     Ruleset = { Value = new OsuRuleset().RulesetInfo }
                 });
+
+                OnlinePlayDependencies.RoomManager.CreateRoom(SelectedRoom.Value);
             });
 
             AddStep("move mouse to create button", () =>
@@ -119,11 +123,11 @@ namespace osu.Game.Tests.Visual.Playlists
                 importedSet = manager.Import(beatmap.BeatmapInfo.BeatmapSet).Result.Value;
             });
 
-            AddStep("load room", () =>
+            setupRoom(room =>
             {
-                SelectedRoom.Value.Name.Value = "my awesome room";
-                SelectedRoom.Value.Host.Value = API.LocalUser.Value;
-                SelectedRoom.Value.Playlist.Add(new PlaylistItem
+                room.Name.Value = "my awesome room";
+                room.Host.Value = API.LocalUser.Value;
+                room.Playlist.Add(new PlaylistItem
                 {
                     Beatmap = { Value = importedSet.Beatmaps[0] },
                     Ruleset = { Value = new OsuRuleset().RulesetInfo }
@@ -143,6 +147,18 @@ namespace osu.Game.Tests.Visual.Playlists
             AddAssert("match has original beatmap", () => match.Beatmap.Value.Beatmap.Difficulty.CircleSize != 1);
         }
 
+        private void setupRoom(Action<Room> room)
+        {
+            AddStep("setup room", () =>
+            {
+                room(SelectedRoom.Value);
+
+                // if this isn't done the test will crash when a poll kicks in.
+                // probably not correct, but works for now.
+                OnlinePlayDependencies.RoomManager.CreateRoom(SelectedRoom.Value);
+            });
+        }
+
         private class TestPlaylistsRoomSubScreen : PlaylistsRoomSubScreen
         {
             public new Bindable<PlaylistItem> SelectedItem => base.SelectedItem;

From 58237f6fee5b63e2d955389efe47377297f1c898 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 27 Oct 2021 14:26:37 +0900
Subject: [PATCH 0505/5547] Fix weird import flows

---
 .../Playlists/TestScenePlaylistCreation.cs    | 43 +++++++++----------
 1 file changed, 21 insertions(+), 22 deletions(-)

diff --git a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistCreation.cs b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistCreation.cs
index 9ee0fb4db5..c4e6f41f27 100644
--- a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistCreation.cs
+++ b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistCreation.cs
@@ -11,6 +11,7 @@ using osu.Framework.Platform;
 using osu.Framework.Screens;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
+using osu.Game.Database;
 using osu.Game.Online.Rooms;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Osu;
@@ -28,6 +29,8 @@ namespace osu.Game.Tests.Visual.Playlists
 
         private TestPlaylistsRoomSubScreen match;
 
+        private ILive<BeatmapSetInfo> importedBeatmap;
+
         [BackgroundDependencyLoader]
         private void load(GameHost host, AudioManager audio)
         {
@@ -39,7 +42,9 @@ namespace osu.Game.Tests.Visual.Playlists
         public void SetupSteps()
         {
             AddStep("set room", () => SelectedRoom.Value = new Room());
-            AddStep("ensure has beatmap", () => manager.Import(CreateBeatmap(new OsuRuleset().RulesetInfo).BeatmapInfo.BeatmapSet).Wait());
+
+            importBeatmap();
+
             AddStep("load match", () => LoadScreen(match = new TestPlaylistsRoomSubScreen(SelectedRoom.Value)));
             AddUntilStep("wait for load", () => match.IsCurrentScreen());
         }
@@ -47,7 +52,7 @@ namespace osu.Game.Tests.Visual.Playlists
         [Test]
         public void TestLoadSimpleMatch()
         {
-            setupRoom(room =>
+            setupAndCreateRoom(room =>
             {
                 room.RoomID.Value = 1; // forces room creation.
                 room.Name.Value = "my awesome room";
@@ -56,11 +61,9 @@ namespace osu.Game.Tests.Visual.Playlists
                 room.EndDate.Value = DateTimeOffset.Now.AddMinutes(5);
                 room.Playlist.Add(new PlaylistItem
                 {
-                    Beatmap = { Value = CreateBeatmap(new OsuRuleset().RulesetInfo).BeatmapInfo },
+                    Beatmap = { Value = importedBeatmap.Value.Beatmaps.First() },
                     Ruleset = { Value = new OsuRuleset().RulesetInfo }
                 });
-
-                OnlinePlayDependencies.RoomManager.CreateRoom(SelectedRoom.Value);
             });
 
             AddStep("start match", () => match.ChildrenOfType<PlaylistsReadyButton>().First().TriggerClick());
@@ -70,17 +73,15 @@ namespace osu.Game.Tests.Visual.Playlists
         [Test]
         public void TestPlaylistItemSelectedOnCreate()
         {
-            setupRoom(room =>
+            setupAndCreateRoom(room =>
             {
                 room.Name.Value = "my awesome room";
                 room.Host.Value = API.LocalUser.Value;
                 room.Playlist.Add(new PlaylistItem
                 {
-                    Beatmap = { Value = CreateBeatmap(new OsuRuleset().RulesetInfo).BeatmapInfo },
+                    Beatmap = { Value = importedBeatmap.Value.Beatmaps.First() },
                     Ruleset = { Value = new OsuRuleset().RulesetInfo }
                 });
-
-                OnlinePlayDependencies.RoomManager.CreateRoom(SelectedRoom.Value);
             });
 
             AddStep("move mouse to create button", () =>
@@ -97,15 +98,12 @@ namespace osu.Game.Tests.Visual.Playlists
         public void TestBeatmapUpdatedOnReImport()
         {
             BeatmapSetInfo importedSet = null;
-            IBeatmap beatmap = null;
 
             // this step is required to make sure the further imports actually get online IDs.
             // all the playlist logic relies on online ID matching.
             AddStep("remove all matching online IDs", () =>
             {
-                beatmap = CreateBeatmap(new OsuRuleset().RulesetInfo);
-
-                var existing = manager.QueryBeatmapSets(s => s.OnlineBeatmapSetID == beatmap.BeatmapInfo.BeatmapSet.OnlineBeatmapSetID).ToList();
+                var existing = manager.QueryBeatmapSets(s => s.OnlineBeatmapSetID == importedBeatmap.Value.OnlineBeatmapSetID).ToList();
 
                 foreach (var s in existing)
                 {
@@ -118,12 +116,14 @@ namespace osu.Game.Tests.Visual.Playlists
 
             AddStep("import altered beatmap", () =>
             {
+                IBeatmap beatmap = CreateBeatmap(new OsuRuleset().RulesetInfo);
+
                 beatmap.BeatmapInfo.BaseDifficulty.CircleSize = 1;
 
                 importedSet = manager.Import(beatmap.BeatmapInfo.BeatmapSet).Result.Value;
             });
 
-            setupRoom(room =>
+            setupAndCreateRoom(room =>
             {
                 room.Name.Value = "my awesome room";
                 room.Host.Value = API.LocalUser.Value;
@@ -134,20 +134,14 @@ namespace osu.Game.Tests.Visual.Playlists
                 });
             });
 
-            AddStep("create room", () =>
-            {
-                InputManager.MoveMouseTo(match.ChildrenOfType<PlaylistsRoomSettingsOverlay.CreateRoomButton>().Single());
-                InputManager.Click(MouseButton.Left);
-            });
-
             AddAssert("match has altered beatmap", () => match.Beatmap.Value.Beatmap.Difficulty.CircleSize == 1);
 
-            AddStep("re-import original beatmap", () => manager.Import(CreateBeatmap(new OsuRuleset().RulesetInfo).BeatmapInfo.BeatmapSet).Wait());
+            importBeatmap();
 
             AddAssert("match has original beatmap", () => match.Beatmap.Value.Beatmap.Difficulty.CircleSize != 1);
         }
 
-        private void setupRoom(Action<Room> room)
+        private void setupAndCreateRoom(Action<Room> room)
         {
             AddStep("setup room", () =>
             {
@@ -159,6 +153,11 @@ namespace osu.Game.Tests.Visual.Playlists
             });
         }
 
+        private void importBeatmap()
+        {
+            AddStep("import beatmap", () => importedBeatmap = manager.Import(CreateBeatmap(new OsuRuleset().RulesetInfo).BeatmapInfo.BeatmapSet).Result);
+        }
+
         private class TestPlaylistsRoomSubScreen : PlaylistsRoomSubScreen
         {
             public new Bindable<PlaylistItem> SelectedItem => base.SelectedItem;

From 85b21174dd26cb55bc7598bf3d903bf6fd54d297 Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Wed, 27 Oct 2021 14:49:50 +0900
Subject: [PATCH 0506/5547] Fix online play test request handling

---
 .../Visual/OnlinePlay/OnlinePlayTestScene.cs  | 20 +++++++++++++++++--
 .../TestRequestHandlingRoomManager.cs         | 10 ----------
 2 files changed, 18 insertions(+), 12 deletions(-)

diff --git a/osu.Game/Tests/Visual/OnlinePlay/OnlinePlayTestScene.cs b/osu.Game/Tests/Visual/OnlinePlay/OnlinePlayTestScene.cs
index 8716646074..d782160ee5 100644
--- a/osu.Game/Tests/Visual/OnlinePlay/OnlinePlayTestScene.cs
+++ b/osu.Game/Tests/Visual/OnlinePlay/OnlinePlayTestScene.cs
@@ -7,6 +7,7 @@ using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
+using osu.Game.Online.API;
 using osu.Game.Online.Rooms;
 using osu.Game.Screens.OnlinePlay;
 
@@ -27,11 +28,15 @@ namespace osu.Game.Tests.Visual.OnlinePlay
         /// </summary>
         protected OnlinePlayTestSceneDependencies OnlinePlayDependencies => dependencies?.OnlinePlayDependencies;
 
-        private DelegatedDependencyContainer dependencies;
-
         protected override Container<Drawable> Content => content;
+
+        [Resolved]
+        private OsuGameBase game { get; set; }
+
         private readonly Container content;
         private readonly Container drawableDependenciesContainer;
+        private DelegatedDependencyContainer dependencies;
+        private TestRoomRequestsHandler requestsHandler;
 
         protected OnlinePlayTestScene()
         {
@@ -57,6 +62,17 @@ namespace osu.Game.Tests.Visual.OnlinePlay
             drawableDependenciesContainer.AddRange(OnlinePlayDependencies.DrawableComponents);
         });
 
+        public override void SetUpSteps()
+        {
+            base.SetUpSteps();
+
+            AddStep("setup API", () =>
+            {
+                requestsHandler = new TestRoomRequestsHandler();
+                ((DummyAPIAccess)API).HandleRequest = request => requestsHandler.HandleRequest(request, API.LocalUser.Value, game);
+            });
+        }
+
         /// <summary>
         /// Creates the room dependencies. Called every <see cref="Setup"/>.
         /// </summary>
diff --git a/osu.Game/Tests/Visual/OnlinePlay/TestRequestHandlingRoomManager.cs b/osu.Game/Tests/Visual/OnlinePlay/TestRequestHandlingRoomManager.cs
index d88fd68b20..ef0ceafd02 100644
--- a/osu.Game/Tests/Visual/OnlinePlay/TestRequestHandlingRoomManager.cs
+++ b/osu.Game/Tests/Visual/OnlinePlay/TestRequestHandlingRoomManager.cs
@@ -2,9 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
-using osu.Framework.Allocation;
 using osu.Game.Beatmaps;
-using osu.Game.Online.API;
 using osu.Game.Online.Rooms;
 using osu.Game.Rulesets;
 using osu.Game.Screens.OnlinePlay.Components;
@@ -21,14 +19,6 @@ namespace osu.Game.Tests.Visual.OnlinePlay
 
         private int currentRoomId;
 
-        private readonly TestRoomRequestsHandler handler = new TestRoomRequestsHandler();
-
-        [BackgroundDependencyLoader]
-        private void load(IAPIProvider api, OsuGameBase game)
-        {
-            ((DummyAPIAccess)api).HandleRequest = request => handler.HandleRequest(request, api.LocalUser.Value, game);
-        }
-
         public override void JoinRoom(Room room, string password = null, Action<Room> onSuccess = null, Action<string> onError = null)
         {
             JoinRoomRequested?.Invoke(room, password);

From 676070946c38f1bfa79ce77b902a747f332c5bc6 Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Wed, 27 Oct 2021 15:25:26 +0900
Subject: [PATCH 0507/5547] Fix missed base.SetUpSteps()

---
 .../Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs      | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs
index eff107faee..10633f4a4f 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs
@@ -43,6 +43,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [SetUpSteps]
         public override void SetUpSteps()
         {
+            base.SetUpSteps();
+
             AddStep("set local user", () => ((DummyAPIAccess)API).LocalUser.Value = LookupCache.GetUserAsync(1).Result);
 
             AddStep("create leaderboard", () =>

From f2683639242e18f474749df7cdaaf2182337bc9f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 27 Oct 2021 15:20:01 +0900
Subject: [PATCH 0508/5547] Update `UpdateableBeatmapBackgroundSprite` to
 accept `IBeatmapInfo`

---
 .../UpdateableBeatmapBackgroundSprite.cs      | 19 ++++++++++---------
 .../OnlinePlay/DrawableRoomPlaylistItem.cs    |  9 +++++++--
 2 files changed, 17 insertions(+), 11 deletions(-)

diff --git a/osu.Game/Beatmaps/Drawables/UpdateableBeatmapBackgroundSprite.cs b/osu.Game/Beatmaps/Drawables/UpdateableBeatmapBackgroundSprite.cs
index 8943ad350e..636c568bd0 100644
--- a/osu.Game/Beatmaps/Drawables/UpdateableBeatmapBackgroundSprite.cs
+++ b/osu.Game/Beatmaps/Drawables/UpdateableBeatmapBackgroundSprite.cs
@@ -12,9 +12,9 @@ namespace osu.Game.Beatmaps.Drawables
     /// <summary>
     /// Display a beatmap background from a local source, but fallback to online source if not available.
     /// </summary>
-    public class UpdateableBeatmapBackgroundSprite : ModelBackedDrawable<BeatmapInfo>
+    public class UpdateableBeatmapBackgroundSprite : ModelBackedDrawable<IBeatmapInfo>
     {
-        public readonly Bindable<BeatmapInfo> Beatmap = new Bindable<BeatmapInfo>();
+        public readonly Bindable<IBeatmapInfo> Beatmap = new Bindable<IBeatmapInfo>();
 
         protected override double LoadDelay => 500;
 
@@ -39,7 +39,7 @@ namespace osu.Game.Beatmaps.Drawables
 
         protected override double TransformDuration => 400;
 
-        protected override Drawable CreateDrawable(BeatmapInfo model)
+        protected override Drawable CreateDrawable(IBeatmapInfo model)
         {
             var drawable = getDrawableForModel(model);
             drawable.RelativeSizeAxes = Axes.Both;
@@ -50,15 +50,16 @@ namespace osu.Game.Beatmaps.Drawables
             return drawable;
         }
 
-        private Drawable getDrawableForModel(BeatmapInfo model)
+        private Drawable getDrawableForModel(IBeatmapInfo model)
         {
             // prefer online cover where available.
-            if (model?.BeatmapSet?.OnlineInfo != null)
-                return new OnlineBeatmapSetCover(model.BeatmapSet, beatmapSetCoverType);
+            if (model?.BeatmapSet is IBeatmapSetOnlineInfo online)
+                return new OnlineBeatmapSetCover(online, beatmapSetCoverType);
 
-            return model?.ID > 0
-                ? new BeatmapBackgroundSprite(beatmaps.GetWorkingBeatmap(model))
-                : new BeatmapBackgroundSprite(beatmaps.DefaultBeatmap);
+            if (model is BeatmapInfo localModel)
+                return new BeatmapBackgroundSprite(beatmaps.GetWorkingBeatmap(localModel));
+
+            return new BeatmapBackgroundSprite(beatmaps.DefaultBeatmap);
         }
     }
 }
diff --git a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
index 585b024623..264d49849c 100644
--- a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
+++ b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
@@ -333,13 +333,14 @@ namespace osu.Game.Screens.OnlinePlay
 
             public PanelBackground()
             {
+                UpdateableBeatmapBackgroundSprite backgroundSprite;
+
                 InternalChildren = new Drawable[]
                 {
-                    new UpdateableBeatmapBackgroundSprite
+                    backgroundSprite = new UpdateableBeatmapBackgroundSprite
                     {
                         RelativeSizeAxes = Axes.Both,
                         FillMode = FillMode.Fill,
-                        Beatmap = { BindTarget = Beatmap }
                     },
                     new FillFlowContainer
                     {
@@ -374,6 +375,10 @@ namespace osu.Game.Screens.OnlinePlay
                         }
                     }
                 };
+
+                // manual binding required as playlists don't expose IBeatmapInfo currently.
+                // may be removed in the future if this changes.
+                Beatmap.BindValueChanged(beatmap => backgroundSprite.Beatmap.Value = beatmap.NewValue);
             }
         }
     }

From d19580cf6023e336b26c354c64edc63c7326a8a6 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 25 Oct 2021 13:47:12 +0900
Subject: [PATCH 0509/5547] Fix incorrectly changed difficulty count in
 recently updated test

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

diff --git a/osu.Game.Tests/Visual/Online/TestSceneBeatmapListingOverlay.cs b/osu.Game.Tests/Visual/Online/TestSceneBeatmapListingOverlay.cs
index 7042f1e4fe..c7a065fdd7 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneBeatmapListingOverlay.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneBeatmapListingOverlay.cs
@@ -90,7 +90,7 @@ namespace osu.Game.Tests.Visual.Online
         {
             AddAssert("is visible", () => overlay.State.Value == Visibility.Visible);
 
-            AddStep("show many results", () => fetchFor(Enumerable.Repeat(CreateAPIBeatmapSet(Ruleset.Value), 10).ToArray()));
+            AddStep("show many results", () => fetchFor(Enumerable.Repeat(CreateAPIBeatmapSet(Ruleset.Value), 100).ToArray()));
 
             AddUntilStep("placeholder hidden", () => !overlay.ChildrenOfType<BeatmapListingOverlay.NotFoundDrawable>().Any(d => d.IsPresent));
 

From 40d963fc8a115631bab1c7f0d1ba3ced61a0b456 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 26 Oct 2021 12:44:14 +0900
Subject: [PATCH 0510/5547] Allow setting of `APIBeatmap.Length` (and don't
 serialise twice)

---
 osu.Game/Online/API/Requests/Responses/APIBeatmap.cs | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs b/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs
index 0945ad30b4..e65dca752b 100644
--- a/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs
@@ -54,10 +54,15 @@ namespace osu.Game.Online.API.Requests.Responses
         [JsonProperty(@"accuracy")]
         private float overallDifficulty { get; set; }
 
-        public double Length => TimeSpan.FromSeconds(lengthInSeconds).TotalMilliseconds;
+        [JsonIgnore]
+        public double Length { get; set; }
 
         [JsonProperty(@"total_length")]
-        private double lengthInSeconds { get; set; }
+        private double lengthInSeconds
+        {
+            get => TimeSpan.FromMilliseconds(Length).TotalSeconds;
+            set => Length = TimeSpan.FromSeconds(value).TotalMilliseconds;
+        }
 
         [JsonProperty(@"count_circles")]
         public int CircleCount { get; set; }

From db6343c44caf3d3f46ba9acfd3dc05c9e913dd17 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 27 Oct 2021 17:09:51 +0900
Subject: [PATCH 0511/5547] Correctly redirect `BPM` from API to interface

---
 osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs b/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs
index 83f04fb5f2..d8efa20b39 100644
--- a/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs
@@ -164,7 +164,7 @@ namespace osu.Game.Online.API.Requests.Responses
         IEnumerable<INamedFileUsage> IBeatmapSetInfo.Files => throw new NotImplementedException();
         double IBeatmapSetInfo.MaxStarDifficulty => throw new NotImplementedException();
         double IBeatmapSetInfo.MaxLength => throw new NotImplementedException();
-        double IBeatmapSetInfo.MaxBPM => throw new NotImplementedException();
+        double IBeatmapSetInfo.MaxBPM => BPM;
 
         #endregion
     }

From 31306163003dc0ea62e9165a9987b9196af1407d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 27 Oct 2021 17:22:23 +0900
Subject: [PATCH 0512/5547] Update tournament components to use `APIBeatmap`
 directly

---
 .../TestSceneTournamentBeatmapPanel.cs        |  6 ++---
 .../TestSceneTournamentModDisplay.cs          | 13 +++++------
 .../NonVisual/LadderInfoSerialisationTest.cs  |  4 ++--
 .../Screens/TestSceneMapPoolScreen.cs         |  2 +-
 .../TournamentTestScene.cs                    | 22 +++++++++----------
 osu.Game.Tournament/Components/SongBar.cs     | 22 +++++++++----------
 .../Components/TournamentBeatmapPanel.cs      |  7 +++---
 osu.Game.Tournament/IPC/FileBasedIPC.cs       |  6 ++---
 osu.Game.Tournament/IPC/MatchIPCInfo.cs       |  4 ++--
 osu.Game.Tournament/Models/RoundBeatmap.cs    |  4 ++--
 osu.Game.Tournament/Models/SeedingBeatmap.cs  |  4 ++--
 .../Screens/BeatmapInfoScreen.cs              |  4 ++--
 .../Screens/Editors/RoundEditorScreen.cs      |  6 ++---
 .../Screens/Editors/SeedingEditorScreen.cs    |  6 ++---
 .../Screens/MapPool/MapPoolScreen.cs          | 10 ++++-----
 osu.Game.Tournament/TournamentGameBase.cs     |  4 ++--
 16 files changed, 59 insertions(+), 65 deletions(-)

diff --git a/osu.Game.Tournament.Tests/Components/TestSceneTournamentBeatmapPanel.cs b/osu.Game.Tournament.Tests/Components/TestSceneTournamentBeatmapPanel.cs
index f9c553cb3f..8139387a96 100644
--- a/osu.Game.Tournament.Tests/Components/TestSceneTournamentBeatmapPanel.cs
+++ b/osu.Game.Tournament.Tests/Components/TestSceneTournamentBeatmapPanel.cs
@@ -3,7 +3,6 @@
 
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
-using osu.Game.Beatmaps;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests;
 using osu.Game.Online.API.Requests.Responses;
@@ -23,14 +22,13 @@ namespace osu.Game.Tournament.Tests.Components
         [BackgroundDependencyLoader]
         private void load()
         {
-            var req = new GetBeatmapRequest(new BeatmapInfo { OnlineBeatmapID = 1091460 });
+            var req = new GetBeatmapRequest(new APIBeatmap { OnlineID = 1091460 });
             req.Success += success;
             api.Queue(req);
         }
 
-        private void success(APIBeatmap apiBeatmap)
+        private void success(APIBeatmap beatmap)
         {
-            var beatmap = apiBeatmap.ToBeatmapInfo(rulesets);
             Add(new TournamentBeatmapPanel(beatmap)
             {
                 Anchor = Anchor.Centre,
diff --git a/osu.Game.Tournament.Tests/Components/TestSceneTournamentModDisplay.cs b/osu.Game.Tournament.Tests/Components/TestSceneTournamentModDisplay.cs
index 27eb55a9fb..3c22bdca03 100644
--- a/osu.Game.Tournament.Tests/Components/TestSceneTournamentModDisplay.cs
+++ b/osu.Game.Tournament.Tests/Components/TestSceneTournamentModDisplay.cs
@@ -4,12 +4,12 @@
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
-using osu.Game.Beatmaps;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets;
 using osu.Game.Tournament.Components;
+using osuTK;
 
 namespace osu.Game.Tournament.Tests.Components
 {
@@ -23,12 +23,10 @@ namespace osu.Game.Tournament.Tests.Components
 
         private FillFlowContainer<TournamentBeatmapPanel> fillFlow;
 
-        private BeatmapInfo beatmapInfo;
-
         [BackgroundDependencyLoader]
         private void load()
         {
-            var req = new GetBeatmapRequest(new BeatmapInfo { OnlineBeatmapID = 490154 });
+            var req = new GetBeatmapRequest(new APIBeatmap { OnlineID = 490154 });
             req.Success += success;
             api.Queue(req);
 
@@ -38,18 +36,17 @@ namespace osu.Game.Tournament.Tests.Components
                 Anchor = Anchor.Centre,
                 Origin = Anchor.Centre,
                 Direction = FillDirection.Full,
-                Spacing = new osuTK.Vector2(10)
+                Spacing = new Vector2(10)
             });
         }
 
-        private void success(APIBeatmap apiBeatmap)
+        private void success(APIBeatmap beatmap)
         {
-            beatmapInfo = apiBeatmap.ToBeatmapInfo(rulesets);
             var mods = rulesets.GetRuleset(Ladder.Ruleset.Value.ID ?? 0).CreateInstance().AllMods;
 
             foreach (var mod in mods)
             {
-                fillFlow.Add(new TournamentBeatmapPanel(beatmapInfo, mod.Acronym)
+                fillFlow.Add(new TournamentBeatmapPanel(beatmap, mod.Acronym)
                 {
                     Anchor = Anchor.Centre,
                     Origin = Anchor.Centre
diff --git a/osu.Game.Tournament.Tests/NonVisual/LadderInfoSerialisationTest.cs b/osu.Game.Tournament.Tests/NonVisual/LadderInfoSerialisationTest.cs
index 13cbcd3caf..2071512f60 100644
--- a/osu.Game.Tournament.Tests/NonVisual/LadderInfoSerialisationTest.cs
+++ b/osu.Game.Tournament.Tests/NonVisual/LadderInfoSerialisationTest.cs
@@ -44,8 +44,8 @@ namespace osu.Game.Tournament.Tests.NonVisual
                     {
                         Beatmaps =
                         {
-                            new RoundBeatmap { BeatmapInfo = TournamentTestScene.CreateSampleBeatmapInfo() },
-                            new RoundBeatmap { BeatmapInfo = TournamentTestScene.CreateSampleBeatmapInfo() },
+                            new RoundBeatmap { BeatmapInfo = TournamentTestScene.CreateSampleBeatmap() },
+                            new RoundBeatmap { BeatmapInfo = TournamentTestScene.CreateSampleBeatmap() },
                         }
                     }
                 },
diff --git a/osu.Game.Tournament.Tests/Screens/TestSceneMapPoolScreen.cs b/osu.Game.Tournament.Tests/Screens/TestSceneMapPoolScreen.cs
index f4032fdd54..41fbf44179 100644
--- a/osu.Game.Tournament.Tests/Screens/TestSceneMapPoolScreen.cs
+++ b/osu.Game.Tournament.Tests/Screens/TestSceneMapPoolScreen.cs
@@ -132,7 +132,7 @@ namespace osu.Game.Tournament.Tests.Screens
         {
             Ladder.CurrentMatch.Value.Round.Value.Beatmaps.Add(new RoundBeatmap
             {
-                BeatmapInfo = CreateSampleBeatmapInfo(),
+                BeatmapInfo = CreateSampleBeatmap(),
                 Mods = mods
             });
         }
diff --git a/osu.Game.Tournament.Tests/TournamentTestScene.cs b/osu.Game.Tournament.Tests/TournamentTestScene.cs
index ce9fd91ff1..4f057286b6 100644
--- a/osu.Game.Tournament.Tests/TournamentTestScene.cs
+++ b/osu.Game.Tournament.Tests/TournamentTestScene.cs
@@ -7,7 +7,6 @@ using osu.Framework.Allocation;
 using osu.Framework.Platform;
 using osu.Framework.Testing;
 using osu.Framework.Utils;
-using osu.Game.Beatmaps;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets;
 using osu.Game.Tests.Visual;
@@ -74,19 +73,19 @@ namespace osu.Game.Tournament.Tests
                             {
                                 new SeedingBeatmap
                                 {
-                                    BeatmapInfo = CreateSampleBeatmapInfo(),
+                                    BeatmapInfo = CreateSampleBeatmap(),
                                     Score = 12345672,
                                     Seed = { Value = 24 },
                                 },
                                 new SeedingBeatmap
                                 {
-                                    BeatmapInfo = CreateSampleBeatmapInfo(),
+                                    BeatmapInfo = CreateSampleBeatmap(),
                                     Score = 1234567,
                                     Seed = { Value = 12 },
                                 },
                                 new SeedingBeatmap
                                 {
-                                    BeatmapInfo = CreateSampleBeatmapInfo(),
+                                    BeatmapInfo = CreateSampleBeatmap(),
                                     Score = 1234567,
                                     Seed = { Value = 16 },
                                 }
@@ -100,19 +99,19 @@ namespace osu.Game.Tournament.Tests
                             {
                                 new SeedingBeatmap
                                 {
-                                    BeatmapInfo = CreateSampleBeatmapInfo(),
+                                    BeatmapInfo = CreateSampleBeatmap(),
                                     Score = 234567,
                                     Seed = { Value = 3 },
                                 },
                                 new SeedingBeatmap
                                 {
-                                    BeatmapInfo = CreateSampleBeatmapInfo(),
+                                    BeatmapInfo = CreateSampleBeatmap(),
                                     Score = 234567,
                                     Seed = { Value = 6 },
                                 },
                                 new SeedingBeatmap
                                 {
-                                    BeatmapInfo = CreateSampleBeatmapInfo(),
+                                    BeatmapInfo = CreateSampleBeatmap(),
                                     Score = 234567,
                                     Seed = { Value = 12 },
                                 }
@@ -152,16 +151,15 @@ namespace osu.Game.Tournament.Tests
             }
         };
 
-        public static BeatmapInfo CreateSampleBeatmapInfo() =>
-            new BeatmapInfo
+        public static APIBeatmap CreateSampleBeatmap() =>
+            new APIBeatmap
             {
-                Metadata = new BeatmapMetadata
+                BeatmapSet = new APIBeatmapSet
                 {
                     Title = "Test Title",
                     Artist = "Test Artist",
-                    ID = RNG.Next(0, 1000000)
                 },
-                OnlineInfo = new APIBeatmap(),
+                OnlineID = RNG.Next(0, 1000000),
             };
 
         protected override ITestSceneTestRunner CreateRunner() => new TournamentTestSceneTestRunner();
diff --git a/osu.Game.Tournament/Components/SongBar.cs b/osu.Game.Tournament/Components/SongBar.cs
index 60be7dec91..bdcb6f8ded 100644
--- a/osu.Game.Tournament/Components/SongBar.cs
+++ b/osu.Game.Tournament/Components/SongBar.cs
@@ -12,6 +12,7 @@ using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.Legacy;
 using osu.Game.Extensions;
 using osu.Game.Graphics;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets;
 using osu.Game.Screens.Menu;
 using osuTK;
@@ -21,16 +22,15 @@ namespace osu.Game.Tournament.Components
 {
     public class SongBar : CompositeDrawable
     {
-        private BeatmapInfo beatmapInfo;
+        private APIBeatmap beatmapInfo;
 
         public const float HEIGHT = 145 / 2f;
 
         [Resolved]
         private IBindable<RulesetInfo> ruleset { get; set; }
 
-        public BeatmapInfo BeatmapInfo
+        public APIBeatmap BeatmapInfo
         {
-            get => beatmapInfo;
             set
             {
                 if (beatmapInfo == value)
@@ -101,12 +101,12 @@ namespace osu.Game.Tournament.Components
                 return;
             }
 
-            double bpm = beatmapInfo.BeatmapSet.OnlineInfo.BPM;
+            double bpm = beatmapInfo.BPM; // TODO: check this works.
             double length = beatmapInfo.Length;
             string hardRockExtra = "";
             string srExtra = "";
 
-            float ar = beatmapInfo.BaseDifficulty.ApproachRate;
+            float ar = beatmapInfo.Difficulty.ApproachRate;
 
             if ((mods & LegacyMods.HardRock) > 0)
             {
@@ -132,9 +132,9 @@ namespace osu.Game.Tournament.Components
                 default:
                     stats = new (string heading, string content)[]
                     {
-                        ("CS", $"{beatmapInfo.BaseDifficulty.CircleSize:0.#}{hardRockExtra}"),
+                        ("CS", $"{beatmapInfo.Difficulty.CircleSize:0.#}{hardRockExtra}"),
                         ("AR", $"{ar:0.#}{hardRockExtra}"),
-                        ("OD", $"{beatmapInfo.BaseDifficulty.OverallDifficulty:0.#}{hardRockExtra}"),
+                        ("OD", $"{beatmapInfo.Difficulty.OverallDifficulty:0.#}{hardRockExtra}"),
                     };
                     break;
 
@@ -142,15 +142,15 @@ namespace osu.Game.Tournament.Components
                 case 3:
                     stats = new (string heading, string content)[]
                     {
-                        ("OD", $"{beatmapInfo.BaseDifficulty.OverallDifficulty:0.#}{hardRockExtra}"),
-                        ("HP", $"{beatmapInfo.BaseDifficulty.DrainRate:0.#}{hardRockExtra}")
+                        ("OD", $"{beatmapInfo.Difficulty.OverallDifficulty:0.#}{hardRockExtra}"),
+                        ("HP", $"{beatmapInfo.Difficulty.DrainRate:0.#}{hardRockExtra}")
                     };
                     break;
 
                 case 2:
                     stats = new (string heading, string content)[]
                     {
-                        ("CS", $"{beatmapInfo.BaseDifficulty.CircleSize:0.#}{hardRockExtra}"),
+                        ("CS", $"{beatmapInfo.Difficulty.CircleSize:0.#}{hardRockExtra}"),
                         ("AR", $"{ar:0.#}"),
                     };
                     break;
@@ -186,7 +186,7 @@ namespace osu.Game.Tournament.Components
                                         Children = new Drawable[]
                                         {
                                             new DiffPiece(stats),
-                                            new DiffPiece(("Star Rating", $"{beatmapInfo.StarDifficulty:0.#}{srExtra}"))
+                                            new DiffPiece(("Star Rating", $"{beatmapInfo.StarRating:0.#}{srExtra}"))
                                         }
                                     },
                                     new FillFlowContainer
diff --git a/osu.Game.Tournament/Components/TournamentBeatmapPanel.cs b/osu.Game.Tournament/Components/TournamentBeatmapPanel.cs
index be29566e07..39fc1d0c0a 100644
--- a/osu.Game.Tournament/Components/TournamentBeatmapPanel.cs
+++ b/osu.Game.Tournament/Components/TournamentBeatmapPanel.cs
@@ -13,6 +13,7 @@ using osu.Framework.Graphics.Textures;
 using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.Drawables;
 using osu.Game.Graphics;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Tournament.Models;
 using osuTK.Graphics;
 
@@ -20,7 +21,7 @@ namespace osu.Game.Tournament.Components
 {
     public class TournamentBeatmapPanel : CompositeDrawable
     {
-        public readonly IBeatmapInfo BeatmapInfo;
+        public readonly APIBeatmap BeatmapInfo;
 
         private readonly string mod;
 
@@ -32,7 +33,7 @@ namespace osu.Game.Tournament.Components
         private readonly Bindable<TournamentMatch> currentMatch = new Bindable<TournamentMatch>();
         private Box flash;
 
-        public TournamentBeatmapPanel(IBeatmapInfo beatmapInfo, string mod = null)
+        public TournamentBeatmapPanel(APIBeatmap beatmapInfo, string mod = null)
         {
             if (beatmapInfo == null) throw new ArgumentNullException(nameof(beatmapInfo));
 
@@ -62,7 +63,7 @@ namespace osu.Game.Tournament.Components
                 {
                     RelativeSizeAxes = Axes.Both,
                     Colour = OsuColour.Gray(0.5f),
-                    BeatmapSet = BeatmapInfo.BeatmapSet as IBeatmapSetOnlineInfo,
+                    BeatmapSet = BeatmapInfo.BeatmapSet,
                 },
                 new FillFlowContainer
                 {
diff --git a/osu.Game.Tournament/IPC/FileBasedIPC.cs b/osu.Game.Tournament/IPC/FileBasedIPC.cs
index 6dde265bd6..15aa9dd588 100644
--- a/osu.Game.Tournament/IPC/FileBasedIPC.cs
+++ b/osu.Game.Tournament/IPC/FileBasedIPC.cs
@@ -11,10 +11,10 @@ using osu.Framework.Extensions.ObjectExtensions;
 using osu.Framework.Logging;
 using osu.Framework.Platform;
 using osu.Framework.Threading;
-using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.Legacy;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets;
 using osu.Game.Tournament.Models;
 
@@ -93,8 +93,8 @@ namespace osu.Game.Tournament.IPC
                                         Beatmap.Value = existing.BeatmapInfo;
                                     else
                                     {
-                                        beatmapLookupRequest = new GetBeatmapRequest(new BeatmapInfo { OnlineBeatmapID = beatmapId });
-                                        beatmapLookupRequest.Success += b => Beatmap.Value = b.ToBeatmapInfo(Rulesets);
+                                        beatmapLookupRequest = new GetBeatmapRequest(new APIBeatmap { OnlineID = beatmapId });
+                                        beatmapLookupRequest.Success += b => Beatmap.Value = b;
                                         API.Queue(beatmapLookupRequest);
                                     }
                                 }
diff --git a/osu.Game.Tournament/IPC/MatchIPCInfo.cs b/osu.Game.Tournament/IPC/MatchIPCInfo.cs
index 701258c6c7..fa7079b824 100644
--- a/osu.Game.Tournament/IPC/MatchIPCInfo.cs
+++ b/osu.Game.Tournament/IPC/MatchIPCInfo.cs
@@ -3,14 +3,14 @@
 
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
-using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.Legacy;
+using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Tournament.IPC
 {
     public class MatchIPCInfo : Component
     {
-        public Bindable<BeatmapInfo> Beatmap { get; } = new Bindable<BeatmapInfo>();
+        public Bindable<APIBeatmap> Beatmap { get; } = new Bindable<APIBeatmap>();
         public Bindable<LegacyMods> Mods { get; } = new Bindable<LegacyMods>();
         public Bindable<TourneyState> State { get; } = new Bindable<TourneyState>();
         public Bindable<string> ChatChannel { get; } = new Bindable<string>();
diff --git a/osu.Game.Tournament/Models/RoundBeatmap.cs b/osu.Game.Tournament/Models/RoundBeatmap.cs
index 5d43d0ca66..8f1968236e 100644
--- a/osu.Game.Tournament/Models/RoundBeatmap.cs
+++ b/osu.Game.Tournament/Models/RoundBeatmap.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 osu.Game.Beatmaps;
+using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Tournament.Models
 {
@@ -10,6 +10,6 @@ namespace osu.Game.Tournament.Models
         public int ID;
         public string Mods;
 
-        public BeatmapInfo BeatmapInfo;
+        public APIBeatmap BeatmapInfo;
     }
 }
diff --git a/osu.Game.Tournament/Models/SeedingBeatmap.cs b/osu.Game.Tournament/Models/SeedingBeatmap.cs
index 2cd6fa7188..37a8a92546 100644
--- a/osu.Game.Tournament/Models/SeedingBeatmap.cs
+++ b/osu.Game.Tournament/Models/SeedingBeatmap.cs
@@ -2,7 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using osu.Framework.Bindables;
-using osu.Game.Beatmaps;
+using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Tournament.Models
 {
@@ -10,7 +10,7 @@ namespace osu.Game.Tournament.Models
     {
         public int ID;
 
-        public BeatmapInfo BeatmapInfo;
+        public APIBeatmap BeatmapInfo;
 
         public long Score;
 
diff --git a/osu.Game.Tournament/Screens/BeatmapInfoScreen.cs b/osu.Game.Tournament/Screens/BeatmapInfoScreen.cs
index b94b164116..50324d9c83 100644
--- a/osu.Game.Tournament/Screens/BeatmapInfoScreen.cs
+++ b/osu.Game.Tournament/Screens/BeatmapInfoScreen.cs
@@ -4,8 +4,8 @@
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
-using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.Legacy;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Tournament.Components;
 using osu.Game.Tournament.IPC;
 
@@ -37,7 +37,7 @@ namespace osu.Game.Tournament.Screens
             SongBar.Mods = mods.NewValue;
         }
 
-        private void beatmapChanged(ValueChangedEvent<BeatmapInfo> beatmap)
+        private void beatmapChanged(ValueChangedEvent<APIBeatmap> beatmap)
         {
             SongBar.FadeInFromZero(300, Easing.OutQuint);
             SongBar.BeatmapInfo = beatmap.NewValue;
diff --git a/osu.Game.Tournament/Screens/Editors/RoundEditorScreen.cs b/osu.Game.Tournament/Screens/Editors/RoundEditorScreen.cs
index 1d8c4e7476..2f77209d57 100644
--- a/osu.Game.Tournament/Screens/Editors/RoundEditorScreen.cs
+++ b/osu.Game.Tournament/Screens/Editors/RoundEditorScreen.cs
@@ -7,10 +7,10 @@ using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
-using osu.Game.Beatmaps;
 using osu.Game.Graphics;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays.Settings;
 using osu.Game.Rulesets;
 using osu.Game.Tournament.Components;
@@ -234,11 +234,11 @@ namespace osu.Game.Tournament.Screens.Editors
                                 return;
                             }
 
-                            var req = new GetBeatmapRequest(new BeatmapInfo { OnlineBeatmapID = Model.ID });
+                            var req = new GetBeatmapRequest(new APIBeatmap { OnlineID = Model.ID });
 
                             req.Success += res =>
                             {
-                                Model.BeatmapInfo = res.ToBeatmapInfo(rulesets);
+                                Model.BeatmapInfo = res;
                                 updatePanel();
                             };
 
diff --git a/osu.Game.Tournament/Screens/Editors/SeedingEditorScreen.cs b/osu.Game.Tournament/Screens/Editors/SeedingEditorScreen.cs
index d5b55823a5..c17939e040 100644
--- a/osu.Game.Tournament/Screens/Editors/SeedingEditorScreen.cs
+++ b/osu.Game.Tournament/Screens/Editors/SeedingEditorScreen.cs
@@ -7,10 +7,10 @@ using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
-using osu.Game.Beatmaps;
 using osu.Game.Graphics;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays.Settings;
 using osu.Game.Rulesets;
 using osu.Game.Tournament.Components;
@@ -242,11 +242,11 @@ namespace osu.Game.Tournament.Screens.Editors
                                 return;
                             }
 
-                            var req = new GetBeatmapRequest(new BeatmapInfo { OnlineBeatmapID = Model.ID });
+                            var req = new GetBeatmapRequest(new APIBeatmap { OnlineID = Model.ID });
 
                             req.Success += res =>
                             {
-                                Model.BeatmapInfo = res.ToBeatmapInfo(rulesets);
+                                Model.BeatmapInfo = res;
                                 updatePanel();
                             };
 
diff --git a/osu.Game.Tournament/Screens/MapPool/MapPoolScreen.cs b/osu.Game.Tournament/Screens/MapPool/MapPoolScreen.cs
index 5f6546c303..a2432d7b5e 100644
--- a/osu.Game.Tournament/Screens/MapPool/MapPoolScreen.cs
+++ b/osu.Game.Tournament/Screens/MapPool/MapPoolScreen.cs
@@ -8,8 +8,8 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Input.Events;
 using osu.Framework.Threading;
-using osu.Game.Beatmaps;
 using osu.Game.Graphics.UserInterface;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Tournament.Components;
 using osu.Game.Tournament.IPC;
 using osu.Game.Tournament.Models;
@@ -105,14 +105,14 @@ namespace osu.Game.Tournament.Screens.MapPool
             ipc.Beatmap.BindValueChanged(beatmapChanged);
         }
 
-        private void beatmapChanged(ValueChangedEvent<BeatmapInfo> beatmap)
+        private void beatmapChanged(ValueChangedEvent<APIBeatmap> beatmap)
         {
             if (CurrentMatch.Value == null || CurrentMatch.Value.PicksBans.Count(p => p.Type == ChoiceType.Ban) < 2)
                 return;
 
             // if bans have already been placed, beatmap changes result in a selection being made autoamtically
-            if (beatmap.NewValue.OnlineBeatmapID != null)
-                addForBeatmap(beatmap.NewValue.OnlineBeatmapID.Value);
+            if (beatmap.NewValue.OnlineID > 0)
+                addForBeatmap(beatmap.NewValue.OnlineID);
         }
 
         private void setMode(TeamColour colour, ChoiceType choiceType)
@@ -179,7 +179,7 @@ namespace osu.Game.Tournament.Screens.MapPool
             if (CurrentMatch.Value == null)
                 return;
 
-            if (CurrentMatch.Value.Round.Value.Beatmaps.All(b => b.BeatmapInfo.OnlineBeatmapID != beatmapId))
+            if (CurrentMatch.Value.Round.Value.Beatmaps.All(b => b.BeatmapInfo.OnlineID != beatmapId))
                 // don't attempt to add if the beatmap isn't in our pool
                 return;
 
diff --git a/osu.Game.Tournament/TournamentGameBase.cs b/osu.Game.Tournament/TournamentGameBase.cs
index 978be720df..5f7c75f9a7 100644
--- a/osu.Game.Tournament/TournamentGameBase.cs
+++ b/osu.Game.Tournament/TournamentGameBase.cs
@@ -190,7 +190,7 @@ namespace osu.Game.Tournament
                     {
                         var req = new GetBeatmapRequest(new BeatmapInfo { OnlineBeatmapID = b.ID });
                         API.Perform(req);
-                        b.BeatmapInfo = req.Response?.ToBeatmapInfo(RulesetStore);
+                        b.BeatmapInfo = req.Response;
 
                         addedInfo = true;
                     }
@@ -211,7 +211,7 @@ namespace osu.Game.Tournament
                         {
                             var req = new GetBeatmapRequest(new BeatmapInfo { OnlineBeatmapID = b.ID });
                             req.Perform(API);
-                            b.BeatmapInfo = req.Response?.ToBeatmapInfo(RulesetStore);
+                            b.BeatmapInfo = req.Response;
 
                             addedInfo = true;
                         }

From 35168948fe871b2e32813e50a72119f36fd5f2a8 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 27 Oct 2021 17:45:46 +0900
Subject: [PATCH 0513/5547] Fix `PopulateUser` not populating immediately when
 `immediate` is specified (due to scheduling)

---
 osu.Game.Tournament/TournamentGameBase.cs | 37 +++++++++++++++--------
 1 file changed, 24 insertions(+), 13 deletions(-)

diff --git a/osu.Game.Tournament/TournamentGameBase.cs b/osu.Game.Tournament/TournamentGameBase.cs
index 5f7c75f9a7..fd31c325b4 100644
--- a/osu.Game.Tournament/TournamentGameBase.cs
+++ b/osu.Game.Tournament/TournamentGameBase.cs
@@ -226,8 +226,30 @@ namespace osu.Game.Tournament
         {
             var req = new GetUserRequest(user.Id, Ruleset.Value);
 
-            req.Success += res =>
+            if (immediate)
             {
+                API.Perform(req);
+                populate();
+            }
+            else
+            {
+                req.Success += res => { populate(); };
+                req.Failure += _ =>
+                {
+                    user.Id = 1;
+                    failure?.Invoke();
+                };
+
+                API.Queue(req);
+            }
+
+            void populate()
+            {
+                var res = req.Response;
+
+                if (res == null)
+                    return;
+
                 user.Id = res.Id;
 
                 user.Username = res.Username;
@@ -236,18 +258,7 @@ namespace osu.Game.Tournament
                 user.Cover = res.Cover;
 
                 success?.Invoke();
-            };
-
-            req.Failure += _ =>
-            {
-                user.Id = 1;
-                failure?.Invoke();
-            };
-
-            if (immediate)
-                API.Perform(req);
-            else
-                API.Queue(req);
+            }
         }
 
         protected override void LoadComplete()

From 5448b94039b024884fec0a3efbfbab32cdc11217 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 27 Oct 2021 18:20:10 +0900
Subject: [PATCH 0514/5547] Change repopulation rules to cover the fact that
 the serisalisation model has changed

This also adds a progress display to show how repopulation is going. It
can take a while on a large bracket.
---
 osu.Game.Tournament/TournamentGameBase.cs | 125 +++++++++++++---------
 1 file changed, 72 insertions(+), 53 deletions(-)

diff --git a/osu.Game.Tournament/TournamentGameBase.cs b/osu.Game.Tournament/TournamentGameBase.cs
index fd31c325b4..5748315418 100644
--- a/osu.Game.Tournament/TournamentGameBase.cs
+++ b/osu.Game.Tournament/TournamentGameBase.cs
@@ -7,12 +7,14 @@ using System.Linq;
 using System.Threading.Tasks;
 using Newtonsoft.Json;
 using osu.Framework.Allocation;
+using osu.Framework.Graphics;
 using osu.Framework.Graphics.Textures;
 using osu.Framework.Input;
 using osu.Framework.IO.Stores;
 using osu.Framework.Platform;
-using osu.Game.Beatmaps;
+using osu.Game.Graphics;
 using osu.Game.Online.API.Requests;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Tournament.IO;
 using osu.Game.Tournament.IPC;
 using osu.Game.Tournament.Models;
@@ -39,9 +41,18 @@ namespace osu.Game.Tournament
             return dependencies = new DependencyContainer(base.CreateChildDependencies(parent));
         }
 
+        private TournamentSpriteText initialisationText;
+
         [BackgroundDependencyLoader]
         private void load(Storage baseStorage)
         {
+            AddInternal(initialisationText = new TournamentSpriteText
+            {
+                Anchor = Anchor.Centre,
+                Origin = Anchor.Centre,
+                Font = OsuFont.Torus.With(size: 32),
+            });
+
             Resources.AddStore(new DllResourceStore(typeof(TournamentGameBase).Assembly));
 
             dependencies.CacheAs<Storage>(storage = new TournamentStorage(baseStorage));
@@ -123,7 +134,8 @@ namespace osu.Game.Tournament
                 }
 
                 addedInfo |= addPlayers();
-                addedInfo |= addBeatmaps();
+                addedInfo |= addRoundBeatmaps();
+                addedInfo |= addSeedingBeatmaps();
 
                 if (addedInfo)
                     SaveChanges();
@@ -145,6 +157,8 @@ namespace osu.Game.Tournament
                 Add(ipc);
 
                 taskCompletionSource.SetResult(true);
+
+                initialisationText.Expire();
             });
         }
 
@@ -153,75 +167,80 @@ namespace osu.Game.Tournament
         /// </summary>
         private bool addPlayers()
         {
-            bool addedInfo = false;
+            var playersRequiringPopulation = ladder.Teams
+                                                   .SelectMany(t => t.Players)
+                                                   .Where(p => string.IsNullOrEmpty(p.Username)
+                                                               || p.Statistics?.GlobalRank == null
+                                                               || p.Statistics?.CountryRank == null).ToList();
 
-            foreach (var t in ladder.Teams)
+            if (playersRequiringPopulation.Count == 0)
+                return false;
+
+            for (int i = 0; i < playersRequiringPopulation.Count; i++)
             {
-                foreach (var p in t.Players)
-                {
-                    if (string.IsNullOrEmpty(p.Username)
-                        || p.Statistics?.GlobalRank == null
-                        || p.Statistics?.CountryRank == null)
-                    {
-                        PopulateUser(p, immediate: true);
-                        addedInfo = true;
-                    }
-                }
+                var p = playersRequiringPopulation[i];
+                PopulateUser(p, immediate: true);
+                updateLoadProgressMessage($"Populating user stats ({i} / {playersRequiringPopulation.Count})");
             }
 
-            return addedInfo;
+            return true;
         }
 
         /// <summary>
         /// Add missing beatmap info based on beatmap IDs
         /// </summary>
-        private bool addBeatmaps()
+        private bool addRoundBeatmaps()
         {
-            bool addedInfo = false;
+            var beatmapsRequiringPopulation = ladder.Rounds
+                                                    .SelectMany(r => r.Beatmaps)
+                                                    .Where(b => string.IsNullOrEmpty(b.BeatmapInfo?.BeatmapSet?.Title) && b.ID > 0).ToList();
 
-            foreach (var r in ladder.Rounds)
+            if (beatmapsRequiringPopulation.Count == 0)
+                return false;
+
+            for (int i = 0; i < beatmapsRequiringPopulation.Count; i++)
             {
-                foreach (var b in r.Beatmaps.ToList())
-                {
-                    if (b.BeatmapInfo != null)
-                        continue;
+                var b = beatmapsRequiringPopulation[i];
 
-                    if (b.ID > 0)
-                    {
-                        var req = new GetBeatmapRequest(new BeatmapInfo { OnlineBeatmapID = b.ID });
-                        API.Perform(req);
-                        b.BeatmapInfo = req.Response;
+                var req = new GetBeatmapRequest(new APIBeatmap { OnlineID = b.ID });
+                API.Perform(req);
+                b.BeatmapInfo = req.Response ?? new APIBeatmap();
 
-                        addedInfo = true;
-                    }
-
-                    if (b.BeatmapInfo == null)
-                        // if online population couldn't be performed, ensure we don't leave a null value behind
-                        r.Beatmaps.Remove(b);
-                }
+                updateLoadProgressMessage($"Populating round beatmaps ({i} / {beatmapsRequiringPopulation.Count})");
             }
 
-            foreach (var t in ladder.Teams)
-            {
-                foreach (var s in t.SeedingResults)
-                {
-                    foreach (var b in s.Beatmaps)
-                    {
-                        if (b.BeatmapInfo == null && b.ID > 0)
-                        {
-                            var req = new GetBeatmapRequest(new BeatmapInfo { OnlineBeatmapID = b.ID });
-                            req.Perform(API);
-                            b.BeatmapInfo = req.Response;
-
-                            addedInfo = true;
-                        }
-                    }
-                }
-            }
-
-            return addedInfo;
+            return true;
         }
 
+        /// <summary>
+        /// Add missing beatmap info based on beatmap IDs
+        /// </summary>
+        private bool addSeedingBeatmaps()
+        {
+            var beatmapsRequiringPopulation = ladder.Teams
+                                                    .SelectMany(r => r.SeedingResults)
+                                                    .SelectMany(r => r.Beatmaps)
+                                                    .Where(b => string.IsNullOrEmpty(b.BeatmapInfo?.BeatmapSet?.Title) && b.ID > 0).ToList();
+
+            if (beatmapsRequiringPopulation.Count == 0)
+                return false;
+
+            for (int i = 0; i < beatmapsRequiringPopulation.Count; i++)
+            {
+                var b = beatmapsRequiringPopulation[i];
+
+                var req = new GetBeatmapRequest(new APIBeatmap { OnlineID = b.ID });
+                API.Perform(req);
+                b.BeatmapInfo = req.Response ?? new APIBeatmap();
+
+                updateLoadProgressMessage($"Populating seeding beatmaps ({i} / {beatmapsRequiringPopulation.Count})");
+            }
+
+            return true;
+        }
+
+        private void updateLoadProgressMessage(string s) => Schedule(() => initialisationText.Text = s);
+
         public void PopulateUser(User user, Action success = null, Action failure = null, bool immediate = false)
         {
             var req = new GetUserRequest(user.Id, Ruleset.Value);

From f1499641f3d12789dfaf185b4aa2ad29352052e8 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 27 Oct 2021 18:25:23 +0900
Subject: [PATCH 0515/5547] Rename all usages of `APIBeatmap` to `beatmap` in
 tournament namespace

---
 .../NonVisual/LadderInfoSerialisationTest.cs  |  4 +--
 .../Screens/TestSceneMapPoolScreen.cs         |  2 +-
 .../TournamentTestScene.cs                    | 12 ++++----
 osu.Game.Tournament/Components/SongBar.cs     | 30 +++++++++----------
 .../Components/TournamentBeatmapPanel.cs      | 18 +++++------
 osu.Game.Tournament/IPC/FileBasedIPC.cs       |  4 +--
 osu.Game.Tournament/Models/RoundBeatmap.cs    |  4 ++-
 osu.Game.Tournament/Models/SeedingBeatmap.cs  |  4 ++-
 .../Screens/BeatmapInfoScreen.cs              |  2 +-
 .../Screens/Editors/RoundEditorScreen.cs      | 12 ++++----
 .../Screens/Editors/SeedingEditorScreen.cs    | 12 ++++----
 .../Screens/MapPool/MapPoolScreen.cs          | 10 +++----
 .../Screens/TeamIntro/SeedingScreen.cs        |  4 +--
 osu.Game.Tournament/TournamentGameBase.cs     |  8 ++---
 14 files changed, 65 insertions(+), 61 deletions(-)

diff --git a/osu.Game.Tournament.Tests/NonVisual/LadderInfoSerialisationTest.cs b/osu.Game.Tournament.Tests/NonVisual/LadderInfoSerialisationTest.cs
index 2071512f60..8bdf909af3 100644
--- a/osu.Game.Tournament.Tests/NonVisual/LadderInfoSerialisationTest.cs
+++ b/osu.Game.Tournament.Tests/NonVisual/LadderInfoSerialisationTest.cs
@@ -44,8 +44,8 @@ namespace osu.Game.Tournament.Tests.NonVisual
                     {
                         Beatmaps =
                         {
-                            new RoundBeatmap { BeatmapInfo = TournamentTestScene.CreateSampleBeatmap() },
-                            new RoundBeatmap { BeatmapInfo = TournamentTestScene.CreateSampleBeatmap() },
+                            new RoundBeatmap { Beatmap = TournamentTestScene.CreateSampleBeatmap() },
+                            new RoundBeatmap { Beatmap = TournamentTestScene.CreateSampleBeatmap() },
                         }
                     }
                 },
diff --git a/osu.Game.Tournament.Tests/Screens/TestSceneMapPoolScreen.cs b/osu.Game.Tournament.Tests/Screens/TestSceneMapPoolScreen.cs
index 41fbf44179..f732c5582b 100644
--- a/osu.Game.Tournament.Tests/Screens/TestSceneMapPoolScreen.cs
+++ b/osu.Game.Tournament.Tests/Screens/TestSceneMapPoolScreen.cs
@@ -132,7 +132,7 @@ namespace osu.Game.Tournament.Tests.Screens
         {
             Ladder.CurrentMatch.Value.Round.Value.Beatmaps.Add(new RoundBeatmap
             {
-                BeatmapInfo = CreateSampleBeatmap(),
+                Beatmap = CreateSampleBeatmap(),
                 Mods = mods
             });
         }
diff --git a/osu.Game.Tournament.Tests/TournamentTestScene.cs b/osu.Game.Tournament.Tests/TournamentTestScene.cs
index 4f057286b6..81741a43a9 100644
--- a/osu.Game.Tournament.Tests/TournamentTestScene.cs
+++ b/osu.Game.Tournament.Tests/TournamentTestScene.cs
@@ -73,19 +73,19 @@ namespace osu.Game.Tournament.Tests
                             {
                                 new SeedingBeatmap
                                 {
-                                    BeatmapInfo = CreateSampleBeatmap(),
+                                    Beatmap = CreateSampleBeatmap(),
                                     Score = 12345672,
                                     Seed = { Value = 24 },
                                 },
                                 new SeedingBeatmap
                                 {
-                                    BeatmapInfo = CreateSampleBeatmap(),
+                                    Beatmap = CreateSampleBeatmap(),
                                     Score = 1234567,
                                     Seed = { Value = 12 },
                                 },
                                 new SeedingBeatmap
                                 {
-                                    BeatmapInfo = CreateSampleBeatmap(),
+                                    Beatmap = CreateSampleBeatmap(),
                                     Score = 1234567,
                                     Seed = { Value = 16 },
                                 }
@@ -99,19 +99,19 @@ namespace osu.Game.Tournament.Tests
                             {
                                 new SeedingBeatmap
                                 {
-                                    BeatmapInfo = CreateSampleBeatmap(),
+                                    Beatmap = CreateSampleBeatmap(),
                                     Score = 234567,
                                     Seed = { Value = 3 },
                                 },
                                 new SeedingBeatmap
                                 {
-                                    BeatmapInfo = CreateSampleBeatmap(),
+                                    Beatmap = CreateSampleBeatmap(),
                                     Score = 234567,
                                     Seed = { Value = 6 },
                                 },
                                 new SeedingBeatmap
                                 {
-                                    BeatmapInfo = CreateSampleBeatmap(),
+                                    Beatmap = CreateSampleBeatmap(),
                                     Score = 234567,
                                     Seed = { Value = 12 },
                                 }
diff --git a/osu.Game.Tournament/Components/SongBar.cs b/osu.Game.Tournament/Components/SongBar.cs
index bdcb6f8ded..9af73a2abb 100644
--- a/osu.Game.Tournament/Components/SongBar.cs
+++ b/osu.Game.Tournament/Components/SongBar.cs
@@ -22,21 +22,21 @@ namespace osu.Game.Tournament.Components
 {
     public class SongBar : CompositeDrawable
     {
-        private APIBeatmap beatmapInfo;
+        private APIBeatmap beatmap;
 
         public const float HEIGHT = 145 / 2f;
 
         [Resolved]
         private IBindable<RulesetInfo> ruleset { get; set; }
 
-        public APIBeatmap BeatmapInfo
+        public APIBeatmap Beatmap
         {
             set
             {
-                if (beatmapInfo == value)
+                if (beatmap == value)
                     return;
 
-                beatmapInfo = value;
+                beatmap = value;
                 update();
             }
         }
@@ -95,18 +95,18 @@ namespace osu.Game.Tournament.Components
 
         private void update()
         {
-            if (beatmapInfo == null)
+            if (beatmap == null)
             {
                 flow.Clear();
                 return;
             }
 
-            double bpm = beatmapInfo.BPM; // TODO: check this works.
-            double length = beatmapInfo.Length;
+            double bpm = beatmap.BPM; // TODO: check this works.
+            double length = beatmap.Length;
             string hardRockExtra = "";
             string srExtra = "";
 
-            float ar = beatmapInfo.Difficulty.ApproachRate;
+            float ar = beatmap.Difficulty.ApproachRate;
 
             if ((mods & LegacyMods.HardRock) > 0)
             {
@@ -132,9 +132,9 @@ namespace osu.Game.Tournament.Components
                 default:
                     stats = new (string heading, string content)[]
                     {
-                        ("CS", $"{beatmapInfo.Difficulty.CircleSize:0.#}{hardRockExtra}"),
+                        ("CS", $"{beatmap.Difficulty.CircleSize:0.#}{hardRockExtra}"),
                         ("AR", $"{ar:0.#}{hardRockExtra}"),
-                        ("OD", $"{beatmapInfo.Difficulty.OverallDifficulty:0.#}{hardRockExtra}"),
+                        ("OD", $"{beatmap.Difficulty.OverallDifficulty:0.#}{hardRockExtra}"),
                     };
                     break;
 
@@ -142,15 +142,15 @@ namespace osu.Game.Tournament.Components
                 case 3:
                     stats = new (string heading, string content)[]
                     {
-                        ("OD", $"{beatmapInfo.Difficulty.OverallDifficulty:0.#}{hardRockExtra}"),
-                        ("HP", $"{beatmapInfo.Difficulty.DrainRate:0.#}{hardRockExtra}")
+                        ("OD", $"{beatmap.Difficulty.OverallDifficulty:0.#}{hardRockExtra}"),
+                        ("HP", $"{beatmap.Difficulty.DrainRate:0.#}{hardRockExtra}")
                     };
                     break;
 
                 case 2:
                     stats = new (string heading, string content)[]
                     {
-                        ("CS", $"{beatmapInfo.Difficulty.CircleSize:0.#}{hardRockExtra}"),
+                        ("CS", $"{beatmap.Difficulty.CircleSize:0.#}{hardRockExtra}"),
                         ("AR", $"{ar:0.#}"),
                     };
                     break;
@@ -186,7 +186,7 @@ namespace osu.Game.Tournament.Components
                                         Children = new Drawable[]
                                         {
                                             new DiffPiece(stats),
-                                            new DiffPiece(("Star Rating", $"{beatmapInfo.StarRating:0.#}{srExtra}"))
+                                            new DiffPiece(("Star Rating", $"{beatmap.StarRating:0.#}{srExtra}"))
                                         }
                                     },
                                     new FillFlowContainer
@@ -229,7 +229,7 @@ namespace osu.Game.Tournament.Components
                         }
                     }
                 },
-                new TournamentBeatmapPanel(beatmapInfo)
+                new TournamentBeatmapPanel(beatmap)
                 {
                     RelativeSizeAxes = Axes.X,
                     Width = 0.5f,
diff --git a/osu.Game.Tournament/Components/TournamentBeatmapPanel.cs b/osu.Game.Tournament/Components/TournamentBeatmapPanel.cs
index 39fc1d0c0a..328b9278d5 100644
--- a/osu.Game.Tournament/Components/TournamentBeatmapPanel.cs
+++ b/osu.Game.Tournament/Components/TournamentBeatmapPanel.cs
@@ -21,7 +21,7 @@ namespace osu.Game.Tournament.Components
 {
     public class TournamentBeatmapPanel : CompositeDrawable
     {
-        public readonly APIBeatmap BeatmapInfo;
+        public readonly APIBeatmap Beatmap;
 
         private readonly string mod;
 
@@ -33,11 +33,11 @@ namespace osu.Game.Tournament.Components
         private readonly Bindable<TournamentMatch> currentMatch = new Bindable<TournamentMatch>();
         private Box flash;
 
-        public TournamentBeatmapPanel(APIBeatmap beatmapInfo, string mod = null)
+        public TournamentBeatmapPanel(APIBeatmap beatmap, string mod = null)
         {
-            if (beatmapInfo == null) throw new ArgumentNullException(nameof(beatmapInfo));
+            if (beatmap == null) throw new ArgumentNullException(nameof(beatmap));
 
-            BeatmapInfo = beatmapInfo;
+            Beatmap = beatmap;
             this.mod = mod;
 
             Width = 400;
@@ -63,7 +63,7 @@ namespace osu.Game.Tournament.Components
                 {
                     RelativeSizeAxes = Axes.Both,
                     Colour = OsuColour.Gray(0.5f),
-                    BeatmapSet = BeatmapInfo.BeatmapSet,
+                    BeatmapSet = Beatmap.BeatmapSet,
                 },
                 new FillFlowContainer
                 {
@@ -76,7 +76,7 @@ namespace osu.Game.Tournament.Components
                     {
                         new TournamentSpriteText
                         {
-                            Text = BeatmapInfo.GetDisplayTitleRomanisable(false),
+                            Text = Beatmap.GetDisplayTitleRomanisable(false),
                             Font = OsuFont.Torus.With(weight: FontWeight.Bold),
                         },
                         new FillFlowContainer
@@ -93,7 +93,7 @@ namespace osu.Game.Tournament.Components
                                 },
                                 new TournamentSpriteText
                                 {
-                                    Text = BeatmapInfo.Metadata?.Author,
+                                    Text = Beatmap.Metadata?.Author,
                                     Padding = new MarginPadding { Right = 20 },
                                     Font = OsuFont.Torus.With(weight: FontWeight.Bold, size: 14)
                                 },
@@ -105,7 +105,7 @@ namespace osu.Game.Tournament.Components
                                 },
                                 new TournamentSpriteText
                                 {
-                                    Text = BeatmapInfo.DifficultyName,
+                                    Text = Beatmap.DifficultyName,
                                     Font = OsuFont.Torus.With(weight: FontWeight.Bold, size: 14)
                                 },
                             }
@@ -149,7 +149,7 @@ namespace osu.Game.Tournament.Components
 
         private void updateState()
         {
-            var found = currentMatch.Value.PicksBans.FirstOrDefault(p => p.BeatmapID == BeatmapInfo.OnlineID);
+            var found = currentMatch.Value.PicksBans.FirstOrDefault(p => p.BeatmapID == Beatmap.OnlineID);
 
             bool doFlash = found != choice;
             choice = found;
diff --git a/osu.Game.Tournament/IPC/FileBasedIPC.cs b/osu.Game.Tournament/IPC/FileBasedIPC.cs
index 15aa9dd588..a57f9fd691 100644
--- a/osu.Game.Tournament/IPC/FileBasedIPC.cs
+++ b/osu.Game.Tournament/IPC/FileBasedIPC.cs
@@ -87,10 +87,10 @@ namespace osu.Game.Tournament.IPC
 
                                     lastBeatmapId = beatmapId;
 
-                                    var existing = ladder.CurrentMatch.Value?.Round.Value?.Beatmaps.FirstOrDefault(b => b.ID == beatmapId && b.BeatmapInfo != null);
+                                    var existing = ladder.CurrentMatch.Value?.Round.Value?.Beatmaps.FirstOrDefault(b => b.ID == beatmapId && b.Beatmap != null);
 
                                     if (existing != null)
-                                        Beatmap.Value = existing.BeatmapInfo;
+                                        Beatmap.Value = existing.Beatmap;
                                     else
                                     {
                                         beatmapLookupRequest = new GetBeatmapRequest(new APIBeatmap { OnlineID = beatmapId });
diff --git a/osu.Game.Tournament/Models/RoundBeatmap.cs b/osu.Game.Tournament/Models/RoundBeatmap.cs
index 8f1968236e..2fd79546f1 100644
--- a/osu.Game.Tournament/Models/RoundBeatmap.cs
+++ b/osu.Game.Tournament/Models/RoundBeatmap.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 Newtonsoft.Json;
 using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Tournament.Models
@@ -10,6 +11,7 @@ namespace osu.Game.Tournament.Models
         public int ID;
         public string Mods;
 
-        public APIBeatmap BeatmapInfo;
+        [JsonProperty("BeatmapInfo")]
+        public APIBeatmap Beatmap;
     }
 }
diff --git a/osu.Game.Tournament/Models/SeedingBeatmap.cs b/osu.Game.Tournament/Models/SeedingBeatmap.cs
index 37a8a92546..26f3016ac8 100644
--- a/osu.Game.Tournament/Models/SeedingBeatmap.cs
+++ b/osu.Game.Tournament/Models/SeedingBeatmap.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 Newtonsoft.Json;
 using osu.Framework.Bindables;
 using osu.Game.Online.API.Requests.Responses;
 
@@ -10,7 +11,8 @@ namespace osu.Game.Tournament.Models
     {
         public int ID;
 
-        public APIBeatmap BeatmapInfo;
+        [JsonProperty("BeatmapInfo")]
+        public APIBeatmap Beatmap;
 
         public long Score;
 
diff --git a/osu.Game.Tournament/Screens/BeatmapInfoScreen.cs b/osu.Game.Tournament/Screens/BeatmapInfoScreen.cs
index 50324d9c83..77b816d24c 100644
--- a/osu.Game.Tournament/Screens/BeatmapInfoScreen.cs
+++ b/osu.Game.Tournament/Screens/BeatmapInfoScreen.cs
@@ -40,7 +40,7 @@ namespace osu.Game.Tournament.Screens
         private void beatmapChanged(ValueChangedEvent<APIBeatmap> beatmap)
         {
             SongBar.FadeInFromZero(300, Easing.OutQuint);
-            SongBar.BeatmapInfo = beatmap.NewValue;
+            SongBar.Beatmap = beatmap.NewValue;
         }
     }
 }
diff --git a/osu.Game.Tournament/Screens/Editors/RoundEditorScreen.cs b/osu.Game.Tournament/Screens/Editors/RoundEditorScreen.cs
index 2f77209d57..f6bc607447 100644
--- a/osu.Game.Tournament/Screens/Editors/RoundEditorScreen.cs
+++ b/osu.Game.Tournament/Screens/Editors/RoundEditorScreen.cs
@@ -226,9 +226,9 @@ namespace osu.Game.Tournament.Screens.Editors
                             Model.ID = id.NewValue ?? 0;
 
                             if (id.NewValue != id.OldValue)
-                                Model.BeatmapInfo = null;
+                                Model.Beatmap = null;
 
-                            if (Model.BeatmapInfo != null)
+                            if (Model.Beatmap != null)
                             {
                                 updatePanel();
                                 return;
@@ -238,13 +238,13 @@ namespace osu.Game.Tournament.Screens.Editors
 
                             req.Success += res =>
                             {
-                                Model.BeatmapInfo = res;
+                                Model.Beatmap = res;
                                 updatePanel();
                             };
 
                             req.Failure += _ =>
                             {
-                                Model.BeatmapInfo = null;
+                                Model.Beatmap = null;
                                 updatePanel();
                             };
 
@@ -259,9 +259,9 @@ namespace osu.Game.Tournament.Screens.Editors
                     {
                         drawableContainer.Clear();
 
-                        if (Model.BeatmapInfo != null)
+                        if (Model.Beatmap != null)
                         {
-                            drawableContainer.Child = new TournamentBeatmapPanel(Model.BeatmapInfo, Model.Mods)
+                            drawableContainer.Child = new TournamentBeatmapPanel(Model.Beatmap, Model.Mods)
                             {
                                 Anchor = Anchor.CentreLeft,
                                 Origin = Anchor.CentreLeft,
diff --git a/osu.Game.Tournament/Screens/Editors/SeedingEditorScreen.cs b/osu.Game.Tournament/Screens/Editors/SeedingEditorScreen.cs
index c17939e040..9abf1d3adb 100644
--- a/osu.Game.Tournament/Screens/Editors/SeedingEditorScreen.cs
+++ b/osu.Game.Tournament/Screens/Editors/SeedingEditorScreen.cs
@@ -234,9 +234,9 @@ namespace osu.Game.Tournament.Screens.Editors
                             Model.ID = id.NewValue ?? 0;
 
                             if (id.NewValue != id.OldValue)
-                                Model.BeatmapInfo = null;
+                                Model.Beatmap = null;
 
-                            if (Model.BeatmapInfo != null)
+                            if (Model.Beatmap != null)
                             {
                                 updatePanel();
                                 return;
@@ -246,13 +246,13 @@ namespace osu.Game.Tournament.Screens.Editors
 
                             req.Success += res =>
                             {
-                                Model.BeatmapInfo = res;
+                                Model.Beatmap = res;
                                 updatePanel();
                             };
 
                             req.Failure += _ =>
                             {
-                                Model.BeatmapInfo = null;
+                                Model.Beatmap = null;
                                 updatePanel();
                             };
 
@@ -267,9 +267,9 @@ namespace osu.Game.Tournament.Screens.Editors
                     {
                         drawableContainer.Clear();
 
-                        if (Model.BeatmapInfo != null)
+                        if (Model.Beatmap != null)
                         {
-                            drawableContainer.Child = new TournamentBeatmapPanel(Model.BeatmapInfo, result.Mod.Value)
+                            drawableContainer.Child = new TournamentBeatmapPanel(Model.Beatmap, result.Mod.Value)
                             {
                                 Anchor = Anchor.CentreLeft,
                                 Origin = Anchor.CentreLeft,
diff --git a/osu.Game.Tournament/Screens/MapPool/MapPoolScreen.cs b/osu.Game.Tournament/Screens/MapPool/MapPoolScreen.cs
index a2432d7b5e..3ae007f955 100644
--- a/osu.Game.Tournament/Screens/MapPool/MapPoolScreen.cs
+++ b/osu.Game.Tournament/Screens/MapPool/MapPoolScreen.cs
@@ -147,11 +147,11 @@ namespace osu.Game.Tournament.Screens.MapPool
 
             if (map != null)
             {
-                if (e.Button == MouseButton.Left && map.BeatmapInfo.OnlineID > 0)
-                    addForBeatmap(map.BeatmapInfo.OnlineID);
+                if (e.Button == MouseButton.Left && map.Beatmap.OnlineID > 0)
+                    addForBeatmap(map.Beatmap.OnlineID);
                 else
                 {
-                    var existing = CurrentMatch.Value.PicksBans.FirstOrDefault(p => p.BeatmapID == map.BeatmapInfo.OnlineID);
+                    var existing = CurrentMatch.Value.PicksBans.FirstOrDefault(p => p.BeatmapID == map.Beatmap.OnlineID);
 
                     if (existing != null)
                     {
@@ -179,7 +179,7 @@ namespace osu.Game.Tournament.Screens.MapPool
             if (CurrentMatch.Value == null)
                 return;
 
-            if (CurrentMatch.Value.Round.Value.Beatmaps.All(b => b.BeatmapInfo.OnlineID != beatmapId))
+            if (CurrentMatch.Value.Round.Value.Beatmaps.All(b => b.Beatmap.OnlineID != beatmapId))
                 // don't attempt to add if the beatmap isn't in our pool
                 return;
 
@@ -245,7 +245,7 @@ namespace osu.Game.Tournament.Screens.MapPool
                         flowCount = 1;
                     }
 
-                    currentFlow.Add(new TournamentBeatmapPanel(b.BeatmapInfo, b.Mods)
+                    currentFlow.Add(new TournamentBeatmapPanel(b.Beatmap, b.Mods)
                     {
                         Anchor = Anchor.TopCentre,
                         Origin = Anchor.TopCentre,
diff --git a/osu.Game.Tournament/Screens/TeamIntro/SeedingScreen.cs b/osu.Game.Tournament/Screens/TeamIntro/SeedingScreen.cs
index 3a0bd232b0..d34a8583b9 100644
--- a/osu.Game.Tournament/Screens/TeamIntro/SeedingScreen.cs
+++ b/osu.Game.Tournament/Screens/TeamIntro/SeedingScreen.cs
@@ -141,9 +141,9 @@ namespace osu.Game.Tournament.Screens.TeamIntro
                             Spacing = new Vector2(5),
                             Children = new Drawable[]
                             {
-                                new TournamentSpriteText { Text = beatmap.BeatmapInfo.Metadata.Title, Colour = TournamentGame.TEXT_COLOUR, },
+                                new TournamentSpriteText { Text = beatmap.Beatmap.Metadata.Title, Colour = TournamentGame.TEXT_COLOUR, },
                                 new TournamentSpriteText { Text = "by", Colour = TournamentGame.TEXT_COLOUR, Font = OsuFont.Torus.With(weight: FontWeight.Regular) },
-                                new TournamentSpriteText { Text = beatmap.BeatmapInfo.Metadata.Artist, Colour = TournamentGame.TEXT_COLOUR, Font = OsuFont.Torus.With(weight: FontWeight.Regular) },
+                                new TournamentSpriteText { Text = beatmap.Beatmap.Metadata.Artist, Colour = TournamentGame.TEXT_COLOUR, Font = OsuFont.Torus.With(weight: FontWeight.Regular) },
                             }
                         },
                         new FillFlowContainer
diff --git a/osu.Game.Tournament/TournamentGameBase.cs b/osu.Game.Tournament/TournamentGameBase.cs
index 5748315418..4551192583 100644
--- a/osu.Game.Tournament/TournamentGameBase.cs
+++ b/osu.Game.Tournament/TournamentGameBase.cs
@@ -193,7 +193,7 @@ namespace osu.Game.Tournament
         {
             var beatmapsRequiringPopulation = ladder.Rounds
                                                     .SelectMany(r => r.Beatmaps)
-                                                    .Where(b => string.IsNullOrEmpty(b.BeatmapInfo?.BeatmapSet?.Title) && b.ID > 0).ToList();
+                                                    .Where(b => string.IsNullOrEmpty(b.Beatmap?.BeatmapSet?.Title) && b.ID > 0).ToList();
 
             if (beatmapsRequiringPopulation.Count == 0)
                 return false;
@@ -204,7 +204,7 @@ namespace osu.Game.Tournament
 
                 var req = new GetBeatmapRequest(new APIBeatmap { OnlineID = b.ID });
                 API.Perform(req);
-                b.BeatmapInfo = req.Response ?? new APIBeatmap();
+                b.Beatmap = req.Response ?? new APIBeatmap();
 
                 updateLoadProgressMessage($"Populating round beatmaps ({i} / {beatmapsRequiringPopulation.Count})");
             }
@@ -220,7 +220,7 @@ namespace osu.Game.Tournament
             var beatmapsRequiringPopulation = ladder.Teams
                                                     .SelectMany(r => r.SeedingResults)
                                                     .SelectMany(r => r.Beatmaps)
-                                                    .Where(b => string.IsNullOrEmpty(b.BeatmapInfo?.BeatmapSet?.Title) && b.ID > 0).ToList();
+                                                    .Where(b => string.IsNullOrEmpty(b.Beatmap?.BeatmapSet?.Title) && b.ID > 0).ToList();
 
             if (beatmapsRequiringPopulation.Count == 0)
                 return false;
@@ -231,7 +231,7 @@ namespace osu.Game.Tournament
 
                 var req = new GetBeatmapRequest(new APIBeatmap { OnlineID = b.ID });
                 API.Perform(req);
-                b.BeatmapInfo = req.Response ?? new APIBeatmap();
+                b.Beatmap = req.Response ?? new APIBeatmap();
 
                 updateLoadProgressMessage($"Populating seeding beatmaps ({i} / {beatmapsRequiringPopulation.Count})");
             }

From f3dba49aae9794e22336c18020c16f8c1d3b0b0d Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Wed, 27 Oct 2021 16:10:22 +0900
Subject: [PATCH 0516/5547] Rename room managers

---
 .../TestSceneLoungeRoomsContainer.cs           |  2 +-
 .../Visual/Multiplayer/TestSceneMultiplayer.cs |  7 ++++---
 .../TestSceneMultiplayerLoungeSubScreen.cs     |  2 +-
 .../Visual/Multiplayer/TestSceneTeamVersus.cs  |  4 ++--
 .../Navigation/TestSceneScreenNavigation.cs    |  4 ++--
 .../TestScenePlaylistsLoungeSubScreen.cs       |  2 +-
 .../IMultiplayerTestSceneDependencies.cs       |  2 +-
 .../Visual/Multiplayer/MultiplayerTestScene.cs | 12 +++++-------
 .../MultiplayerTestSceneDependencies.cs        |  4 ++--
 .../Multiplayer/TestMultiplayerClient.cs       |  4 ++--
 ...anager.cs => TestMultiplayerRoomManager.cs} | 18 ++++++------------
 .../Visual/OnlinePlay/OnlinePlayTestScene.cs   |  8 +-------
 .../OnlinePlayTestSceneDependencies.cs         |  5 ++++-
 ...ndlingRoomManager.cs => TestRoomManager.cs} |  2 +-
 14 files changed, 33 insertions(+), 43 deletions(-)
 rename osu.Game/Tests/Visual/Multiplayer/{TestRequestHandlingMultiplayerRoomManager.cs => TestMultiplayerRoomManager.cs} (56%)
 rename osu.Game/Tests/Visual/OnlinePlay/{TestRequestHandlingRoomManager.cs => TestRoomManager.cs} (97%)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneLoungeRoomsContainer.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneLoungeRoomsContainer.cs
index 1bdf3c2750..c3d5f7ec23 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneLoungeRoomsContainer.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneLoungeRoomsContainer.cs
@@ -19,7 +19,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 {
     public class TestSceneLoungeRoomsContainer : OnlinePlayTestScene
     {
-        protected new TestRequestHandlingRoomManager RoomManager => (TestRequestHandlingRoomManager)base.RoomManager;
+        protected new TestRoomManager RoomManager => (TestRoomManager)base.RoomManager;
 
         private RoomsContainer container;
 
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
index f4a72dd7e7..bb4603da69 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
@@ -4,6 +4,7 @@
 using System;
 using System.Diagnostics;
 using System.Linq;
+using Microsoft.VisualStudio.TestPlatform.CommunicationUtilities;
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
@@ -48,7 +49,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         private TestMultiplayer multiplayerScreen;
         private TestMultiplayerClient client;
 
-        private TestRequestHandlingMultiplayerRoomManager roomManager => multiplayerScreen.RoomManager;
+        private TestMultiplayerRoomManager roomManager => multiplayerScreen.RoomManager;
 
         [Cached(typeof(UserLookupCache))]
         private UserLookupCache lookupCache = new TestUserLookupCache();
@@ -624,9 +625,9 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
         private class TestMultiplayer : Screens.OnlinePlay.Multiplayer.Multiplayer
         {
-            public new TestRequestHandlingMultiplayerRoomManager RoomManager { get; private set; }
+            public new TestMultiplayerRoomManager RoomManager { get; private set; }
 
-            protected override RoomManager CreateRoomManager() => RoomManager = new TestRequestHandlingMultiplayerRoomManager();
+            protected override RoomManager CreateRoomManager() => RoomManager = new TestMultiplayerRoomManager();
         }
     }
 }
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerLoungeSubScreen.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerLoungeSubScreen.cs
index b7da31a2b5..de3df754a2 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerLoungeSubScreen.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerLoungeSubScreen.cs
@@ -18,7 +18,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 {
     public class TestSceneMultiplayerLoungeSubScreen : OnlinePlayTestScene
     {
-        protected new TestRequestHandlingRoomManager RoomManager => (TestRequestHandlingRoomManager)base.RoomManager;
+        protected new TestRoomManager RoomManager => (TestRoomManager)base.RoomManager;
 
         private LoungeSubScreen loungeScreen;
 
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs
index 80217a7726..7b34150610 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs
@@ -184,9 +184,9 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
         private class TestMultiplayer : Screens.OnlinePlay.Multiplayer.Multiplayer
         {
-            public new TestRequestHandlingMultiplayerRoomManager RoomManager { get; private set; }
+            public new TestMultiplayerRoomManager RoomManager { get; private set; }
 
-            protected override RoomManager CreateRoomManager() => RoomManager = new TestRequestHandlingMultiplayerRoomManager();
+            protected override RoomManager CreateRoomManager() => RoomManager = new TestMultiplayerRoomManager();
         }
     }
 }
diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs b/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
index ce437e7299..87223a3eca 100644
--- a/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
@@ -461,10 +461,10 @@ namespace osu.Game.Tests.Visual.Navigation
 
             public TestMultiplayer()
             {
-                Client = new TestMultiplayerClient((TestRequestHandlingMultiplayerRoomManager)RoomManager);
+                Client = new TestMultiplayerClient((TestMultiplayerRoomManager)RoomManager);
             }
 
-            protected override RoomManager CreateRoomManager() => new TestRequestHandlingMultiplayerRoomManager();
+            protected override RoomManager CreateRoomManager() => new TestMultiplayerRoomManager();
         }
     }
 }
diff --git a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsLoungeSubScreen.cs b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsLoungeSubScreen.cs
index 5c248163d7..9ba0da1911 100644
--- a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsLoungeSubScreen.cs
+++ b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsLoungeSubScreen.cs
@@ -17,7 +17,7 @@ namespace osu.Game.Tests.Visual.Playlists
 {
     public class TestScenePlaylistsLoungeSubScreen : OnlinePlayTestScene
     {
-        protected new TestRequestHandlingRoomManager RoomManager => (TestRequestHandlingRoomManager)base.RoomManager;
+        protected new TestRoomManager RoomManager => (TestRoomManager)base.RoomManager;
 
         private TestLoungeSubScreen loungeScreen;
 
diff --git a/osu.Game/Tests/Visual/Multiplayer/IMultiplayerTestSceneDependencies.cs b/osu.Game/Tests/Visual/Multiplayer/IMultiplayerTestSceneDependencies.cs
index 3362ebbbd6..204c189591 100644
--- a/osu.Game/Tests/Visual/Multiplayer/IMultiplayerTestSceneDependencies.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/IMultiplayerTestSceneDependencies.cs
@@ -22,7 +22,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         /// <summary>
         /// The cached <see cref="IRoomManager"/>.
         /// </summary>
-        new TestRequestHandlingMultiplayerRoomManager RoomManager { get; }
+        new TestMultiplayerRoomManager RoomManager { get; }
 
         /// <summary>
         /// The cached <see cref="UserLookupCache"/>.
diff --git a/osu.Game/Tests/Visual/Multiplayer/MultiplayerTestScene.cs b/osu.Game/Tests/Visual/Multiplayer/MultiplayerTestScene.cs
index f259784170..c628541825 100644
--- a/osu.Game/Tests/Visual/Multiplayer/MultiplayerTestScene.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/MultiplayerTestScene.cs
@@ -18,7 +18,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         public const int PLAYER_2_ID = 56;
 
         public TestMultiplayerClient Client => OnlinePlayDependencies.Client;
-        public new TestRequestHandlingMultiplayerRoomManager RoomManager => OnlinePlayDependencies.RoomManager;
+        public new TestMultiplayerRoomManager RoomManager => OnlinePlayDependencies.RoomManager;
         public TestUserLookupCache LookupCache => OnlinePlayDependencies?.LookupCache;
         public TestSpectatorClient SpectatorClient => OnlinePlayDependencies?.SpectatorClient;
 
@@ -35,12 +35,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         public new void Setup() => Schedule(() =>
         {
             if (joinRoom)
-            {
-                var room = CreateRoom();
-
-                RoomManager.CreateRoom(room);
-                SelectedRoom.Value = room;
-            }
+                SelectedRoom.Value = CreateRoom();
         });
 
         protected virtual Room CreateRoom()
@@ -64,7 +59,10 @@ namespace osu.Game.Tests.Visual.Multiplayer
             base.SetUpSteps();
 
             if (joinRoom)
+            {
+                AddStep("join room", () => RoomManager.CreateRoom(SelectedRoom.Value));
                 AddUntilStep("wait for room join", () => Client.Room != null);
+            }
         }
 
         protected override OnlinePlayTestSceneDependencies CreateOnlinePlayDependencies() => new MultiplayerTestSceneDependencies();
diff --git a/osu.Game/Tests/Visual/Multiplayer/MultiplayerTestSceneDependencies.cs b/osu.Game/Tests/Visual/Multiplayer/MultiplayerTestSceneDependencies.cs
index 2e13fb6a56..a2b0b066a7 100644
--- a/osu.Game/Tests/Visual/Multiplayer/MultiplayerTestSceneDependencies.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/MultiplayerTestSceneDependencies.cs
@@ -18,7 +18,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         public TestMultiplayerClient Client { get; }
         public TestUserLookupCache LookupCache { get; }
         public TestSpectatorClient SpectatorClient { get; }
-        public new TestRequestHandlingMultiplayerRoomManager RoomManager => (TestRequestHandlingMultiplayerRoomManager)base.RoomManager;
+        public new TestMultiplayerRoomManager RoomManager => (TestMultiplayerRoomManager)base.RoomManager;
 
         public MultiplayerTestSceneDependencies()
         {
@@ -31,7 +31,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             CacheAs<SpectatorClient>(SpectatorClient);
         }
 
-        protected override IRoomManager CreateRoomManager() => new TestRequestHandlingMultiplayerRoomManager();
+        protected override IRoomManager CreateRoomManager() => new TestMultiplayerRoomManager();
 
         protected virtual TestSpectatorClient CreateSpectatorClient() => new TestSpectatorClient();
     }
diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
index 5e4e5942d9..cd0f070d73 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
@@ -39,9 +39,9 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [Resolved]
         private BeatmapManager beatmaps { get; set; } = null!;
 
-        private readonly TestRequestHandlingMultiplayerRoomManager roomManager;
+        private readonly TestMultiplayerRoomManager roomManager;
 
-        public TestMultiplayerClient(TestRequestHandlingMultiplayerRoomManager roomManager)
+        public TestMultiplayerClient(TestMultiplayerRoomManager roomManager)
         {
             this.roomManager = roomManager;
         }
diff --git a/osu.Game/Tests/Visual/Multiplayer/TestRequestHandlingMultiplayerRoomManager.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerRoomManager.cs
similarity index 56%
rename from osu.Game/Tests/Visual/Multiplayer/TestRequestHandlingMultiplayerRoomManager.cs
rename to osu.Game/Tests/Visual/Multiplayer/TestMultiplayerRoomManager.cs
index 5de518990a..fef2a0a16d 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestRequestHandlingMultiplayerRoomManager.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerRoomManager.cs
@@ -3,7 +3,6 @@
 
 using System.Collections.Generic;
 using osu.Framework.Allocation;
-using osu.Game.Online.API;
 using osu.Game.Online.Rooms;
 using osu.Game.Screens.OnlinePlay.Components;
 using osu.Game.Screens.OnlinePlay.Multiplayer;
@@ -12,25 +11,20 @@ using osu.Game.Tests.Visual.OnlinePlay;
 namespace osu.Game.Tests.Visual.Multiplayer
 {
     /// <summary>
-    /// A <see cref="RoomManager"/> for use in multiplayer test scenes, backed by a <see cref="TestRoomRequestsHandler"/>.
+    /// A <see cref="RoomManager"/> for use in multiplayer test scenes.
     /// Should generally not be used by itself outside of a <see cref="MultiplayerTestScene"/>.
     /// </summary>
-    public class TestRequestHandlingMultiplayerRoomManager : MultiplayerRoomManager
+    public class TestMultiplayerRoomManager : MultiplayerRoomManager
     {
-        public IReadOnlyList<Room> ServerSideRooms => handler.ServerSideRooms;
+        [Resolved]
+        private TestRoomRequestsHandler requestsHandler { get; set; }
 
-        private readonly TestRoomRequestsHandler handler = new TestRoomRequestsHandler();
-
-        [BackgroundDependencyLoader]
-        private void load(IAPIProvider api, OsuGameBase game)
-        {
-            ((DummyAPIAccess)api).HandleRequest = request => handler.HandleRequest(request, api.LocalUser.Value, game);
-        }
+        public IReadOnlyList<Room> ServerSideRooms => requestsHandler.ServerSideRooms;
 
         /// <summary>
         /// Adds a room to a local "server-side" list that's returned when a <see cref="GetRoomsRequest"/> is fired.
         /// </summary>
         /// <param name="room">The room.</param>
-        public void AddServerSideRoom(Room room) => handler.AddServerSideRoom(room);
+        public void AddServerSideRoom(Room room) => requestsHandler.AddServerSideRoom(room);
     }
 }
diff --git a/osu.Game/Tests/Visual/OnlinePlay/OnlinePlayTestScene.cs b/osu.Game/Tests/Visual/OnlinePlay/OnlinePlayTestScene.cs
index d782160ee5..4771ace1c4 100644
--- a/osu.Game/Tests/Visual/OnlinePlay/OnlinePlayTestScene.cs
+++ b/osu.Game/Tests/Visual/OnlinePlay/OnlinePlayTestScene.cs
@@ -36,7 +36,6 @@ namespace osu.Game.Tests.Visual.OnlinePlay
         private readonly Container content;
         private readonly Container drawableDependenciesContainer;
         private DelegatedDependencyContainer dependencies;
-        private TestRoomRequestsHandler requestsHandler;
 
         protected OnlinePlayTestScene()
         {
@@ -65,12 +64,7 @@ namespace osu.Game.Tests.Visual.OnlinePlay
         public override void SetUpSteps()
         {
             base.SetUpSteps();
-
-            AddStep("setup API", () =>
-            {
-                requestsHandler = new TestRoomRequestsHandler();
-                ((DummyAPIAccess)API).HandleRequest = request => requestsHandler.HandleRequest(request, API.LocalUser.Value, game);
-            });
+            AddStep("setup API", () => ((DummyAPIAccess)API).HandleRequest = request => OnlinePlayDependencies.RequestsHandler.HandleRequest(request, API.LocalUser.Value, game));
         }
 
         /// <summary>
diff --git a/osu.Game/Tests/Visual/OnlinePlay/OnlinePlayTestSceneDependencies.cs b/osu.Game/Tests/Visual/OnlinePlay/OnlinePlayTestSceneDependencies.cs
index defc971eef..9e5264fb12 100644
--- a/osu.Game/Tests/Visual/OnlinePlay/OnlinePlayTestSceneDependencies.cs
+++ b/osu.Game/Tests/Visual/OnlinePlay/OnlinePlayTestSceneDependencies.cs
@@ -21,6 +21,7 @@ namespace osu.Game.Tests.Visual.OnlinePlay
         public IRoomManager RoomManager { get; }
         public OngoingOperationTracker OngoingOperationTracker { get; }
         public OnlinePlayBeatmapAvailabilityTracker AvailabilityTracker { get; }
+        public TestRoomRequestsHandler RequestsHandler { get; }
 
         /// <summary>
         /// All cached dependencies which are also <see cref="Drawable"/> components.
@@ -36,9 +37,11 @@ namespace osu.Game.Tests.Visual.OnlinePlay
             RoomManager = CreateRoomManager();
             OngoingOperationTracker = new OngoingOperationTracker();
             AvailabilityTracker = new OnlinePlayBeatmapAvailabilityTracker();
+            RequestsHandler = new TestRoomRequestsHandler();
 
             dependencies = new DependencyContainer(new CachedModelDependencyContainer<Room>(null) { Model = { BindTarget = SelectedRoom } });
 
+            CacheAs(RequestsHandler);
             CacheAs(SelectedRoom);
             CacheAs(RoomManager);
             CacheAs(OngoingOperationTracker);
@@ -71,6 +74,6 @@ namespace osu.Game.Tests.Visual.OnlinePlay
                 drawableComponents.Add(drawable);
         }
 
-        protected virtual IRoomManager CreateRoomManager() => new TestRequestHandlingRoomManager();
+        protected virtual IRoomManager CreateRoomManager() => new TestRoomManager();
     }
 }
diff --git a/osu.Game/Tests/Visual/OnlinePlay/TestRequestHandlingRoomManager.cs b/osu.Game/Tests/Visual/OnlinePlay/TestRoomManager.cs
similarity index 97%
rename from osu.Game/Tests/Visual/OnlinePlay/TestRequestHandlingRoomManager.cs
rename to osu.Game/Tests/Visual/OnlinePlay/TestRoomManager.cs
index ef0ceafd02..5fe3dc8406 100644
--- a/osu.Game/Tests/Visual/OnlinePlay/TestRequestHandlingRoomManager.cs
+++ b/osu.Game/Tests/Visual/OnlinePlay/TestRoomManager.cs
@@ -13,7 +13,7 @@ namespace osu.Game.Tests.Visual.OnlinePlay
     /// <summary>
     /// A very simple <see cref="RoomManager"/> for use in online play test scenes.
     /// </summary>
-    public class TestRequestHandlingRoomManager : RoomManager
+    public class TestRoomManager : RoomManager
     {
         public Action<Room, string> JoinRoomRequested;
 

From 48f280440c696925653ed36a6794e83f404cf637 Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Wed, 27 Oct 2021 19:36:43 +0900
Subject: [PATCH 0517/5547] Fix incorrect clearing of room

---
 .../Visual/Multiplayer/TestSceneMultiplayerMatchFooter.cs      | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchFooter.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchFooter.cs
index 44a8d7b439..6536ef2ca1 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchFooter.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchFooter.cs
@@ -4,7 +4,6 @@
 using NUnit.Framework;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
-using osu.Game.Online.Rooms;
 using osu.Game.Screens.OnlinePlay.Multiplayer.Match;
 
 namespace osu.Game.Tests.Visual.Multiplayer
@@ -14,8 +13,6 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [SetUp]
         public new void Setup() => Schedule(() =>
         {
-            SelectedRoom.Value = new Room();
-
             Child = new Container
             {
                 Anchor = Anchor.Centre,

From a87d8d0359af262408e097c6e3da406436be2cc8 Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Wed, 27 Oct 2021 20:47:39 +0900
Subject: [PATCH 0518/5547] Fix dependency missing in a few TestScenes

Hopefully these are rather temporary cases until a better solution is
found for these dependency-loading screens.
---
 .../Visual/Multiplayer/TestSceneMultiplayer.cs        | 11 +++++++++++
 .../Visual/Multiplayer/TestSceneTeamVersus.cs         | 11 +++++++++++
 2 files changed, 22 insertions(+)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
index bb4603da69..a106f3ea95 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
@@ -18,6 +18,7 @@ using osu.Framework.Utils;
 using osu.Game.Beatmaps;
 using osu.Game.Database;
 using osu.Game.Graphics.UserInterface;
+using osu.Game.Online.API;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Rooms;
 using osu.Game.Overlays.Mods;
@@ -34,6 +35,7 @@ using osu.Game.Screens.OnlinePlay.Multiplayer.Match;
 using osu.Game.Screens.Play;
 using osu.Game.Screens.Ranking;
 using osu.Game.Tests.Resources;
+using osu.Game.Tests.Visual.OnlinePlay;
 using osu.Game.Users;
 using osuTK.Input;
 
@@ -617,10 +619,19 @@ namespace osu.Game.Tests.Visual.Multiplayer
             [Cached(typeof(MultiplayerClient))]
             public readonly TestMultiplayerClient Client;
 
+            [Cached]
+            public readonly TestRoomRequestsHandler RequestsHandler = new TestRoomRequestsHandler();
+
             public DependenciesScreen(TestMultiplayerClient client)
             {
                 Client = client;
             }
+
+            [BackgroundDependencyLoader]
+            private void load(IAPIProvider api, OsuGameBase game)
+            {
+                ((DummyAPIAccess)api).HandleRequest = request => RequestsHandler.HandleRequest(request, api.LocalUser.Value, game);
+            }
         }
 
         private class TestMultiplayer : Screens.OnlinePlay.Multiplayer.Multiplayer
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs
index 7b34150610..9bb19d4286 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs
@@ -11,6 +11,7 @@ using osu.Framework.Platform;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
 using osu.Game.Database;
+using osu.Game.Online.API;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Multiplayer.MatchTypes.TeamVersus;
 using osu.Game.Online.Rooms;
@@ -23,6 +24,7 @@ using osu.Game.Screens.OnlinePlay.Multiplayer;
 using osu.Game.Screens.OnlinePlay.Multiplayer.Match;
 using osu.Game.Screens.OnlinePlay.Multiplayer.Participants;
 using osu.Game.Tests.Resources;
+using osu.Game.Tests.Visual.OnlinePlay;
 using osuTK.Input;
 
 namespace osu.Game.Tests.Visual.Multiplayer
@@ -176,10 +178,19 @@ namespace osu.Game.Tests.Visual.Multiplayer
             [Cached(typeof(MultiplayerClient))]
             public readonly TestMultiplayerClient Client;
 
+            [Cached]
+            public readonly TestRoomRequestsHandler RequestsHandler = new TestRoomRequestsHandler();
+
             public DependenciesScreen(TestMultiplayerClient client)
             {
                 Client = client;
             }
+
+            [BackgroundDependencyLoader]
+            private void load(IAPIProvider api, OsuGameBase game)
+            {
+                ((DummyAPIAccess)api).HandleRequest = request => RequestsHandler.HandleRequest(request, api.LocalUser.Value, game);
+            }
         }
 
         private class TestMultiplayer : Screens.OnlinePlay.Multiplayer.Multiplayer

From 72bb72a559dda6edfb923a1d89fcc8a83e9a9621 Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Wed, 27 Oct 2021 20:56:03 +0900
Subject: [PATCH 0519/5547] Fix a case of missed base.SetUpSteps()

---
 .../TestSceneMultiplayerGameplayLeaderboardTeams.cs           | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboardTeams.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboardTeams.cs
index 32114fa500..3d48ddc7ca 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboardTeams.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboardTeams.cs
@@ -5,7 +5,6 @@ using System.Collections.Generic;
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Graphics;
-using osu.Framework.Testing;
 using osu.Framework.Utils;
 using osu.Game.Online.API;
 using osu.Game.Online.Multiplayer;
@@ -44,9 +43,10 @@ namespace osu.Game.Tests.Visual.Multiplayer
             return room;
         }
 
-        [SetUpSteps]
         public override void SetUpSteps()
         {
+            base.SetUpSteps();
+
             AddStep("set local user", () => ((DummyAPIAccess)API).LocalUser.Value = LookupCache.GetUserAsync(1).Result);
 
             AddStep("create leaderboard", () =>

From 9015ac6ba8d9fd25ceb23321c9a0e9d3dc551221 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 27 Oct 2021 19:52:41 +0900
Subject: [PATCH 0520/5547] Implement new version of download tracker

---
 osu.Game/Database/ModelDownloader.cs      |   4 +-
 osu.Game/Online/BeatmapDownloadTracker.cs | 172 ++++++++++++++++++++++
 osu.Game/Online/DownloadTracker.cs        |  39 +++++
 osu.Game/Online/ScoreDownloadTracker.cs   | 172 ++++++++++++++++++++++
 osu.Game/Scoring/ScoreInfo.cs             |   2 +-
 5 files changed, 386 insertions(+), 3 deletions(-)
 create mode 100644 osu.Game/Online/BeatmapDownloadTracker.cs
 create mode 100644 osu.Game/Online/DownloadTracker.cs
 create mode 100644 osu.Game/Online/ScoreDownloadTracker.cs

diff --git a/osu.Game/Database/ModelDownloader.cs b/osu.Game/Database/ModelDownloader.cs
index e613b39b6b..b9677c1b2b 100644
--- a/osu.Game/Database/ModelDownloader.cs
+++ b/osu.Game/Database/ModelDownloader.cs
@@ -15,7 +15,7 @@ using osu.Game.Overlays.Notifications;
 namespace osu.Game.Database
 {
     public abstract class ModelDownloader<TModel> : IModelDownloader<TModel>
-        where TModel : class, IHasPrimaryKey, ISoftDelete, IEquatable<TModel>
+        where TModel : class, IHasPrimaryKey, ISoftDelete, IEquatable<TModel>, IHasOnlineID
     {
         public Action<Notification> PostNotification { protected get; set; }
 
@@ -107,7 +107,7 @@ namespace osu.Game.Database
             }
         }
 
-        public ArchiveDownloadRequest<TModel> GetExistingDownload(TModel model) => currentDownloads.Find(r => r.Model.Equals(model));
+        public ArchiveDownloadRequest<TModel> GetExistingDownload(TModel model) => currentDownloads.Find(r => r.Model.OnlineID == model.OnlineID);
 
         private bool canDownload(TModel model) => GetExistingDownload(model) == null && api != null;
 
diff --git a/osu.Game/Online/BeatmapDownloadTracker.cs b/osu.Game/Online/BeatmapDownloadTracker.cs
new file mode 100644
index 0000000000..969cb9af36
--- /dev/null
+++ b/osu.Game/Online/BeatmapDownloadTracker.cs
@@ -0,0 +1,172 @@
+// 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.Bindables;
+using osu.Game.Beatmaps;
+using osu.Game.Online.API;
+
+#nullable enable
+
+namespace osu.Game.Online
+{
+    public class BeatmapDownloadTracker : DownloadTracker<IBeatmapSetInfo>
+    {
+        [Resolved(CanBeNull = true)]
+        protected BeatmapManager? Manager { get; private set; }
+
+        private ArchiveDownloadRequest<BeatmapSetInfo>? attachedRequest;
+
+        public BeatmapDownloadTracker(IBeatmapSetInfo trackedItem)
+            : base(trackedItem)
+        {
+        }
+
+        private IBindable<WeakReference<BeatmapSetInfo>>? managerUpdated;
+        private IBindable<WeakReference<BeatmapSetInfo>>? managerRemoved;
+        private IBindable<WeakReference<ArchiveDownloadRequest<BeatmapSetInfo>>>? managerDownloadBegan;
+        private IBindable<WeakReference<ArchiveDownloadRequest<BeatmapSetInfo>>>? managerDownloadFailed;
+
+        [BackgroundDependencyLoader(true)]
+        private void load()
+        {
+            // Used to interact with manager classes that don't support interface types. Will eventually be replaced.
+            var beatmapSetInfo = new BeatmapSetInfo { OnlineBeatmapSetID = TrackedItem.OnlineID };
+
+            if ((TrackedItem as BeatmapSetInfo)?.ID > 0 || Manager?.IsAvailableLocally(beatmapSetInfo) == true)
+                UpdateState(DownloadState.LocallyAvailable);
+            else if (Manager != null)
+                attachDownload(Manager.GetExistingDownload(beatmapSetInfo));
+
+            if (Manager != null)
+            {
+                managerDownloadBegan = Manager.DownloadBegan.GetBoundCopy();
+                managerDownloadBegan.BindValueChanged(downloadBegan);
+                managerDownloadFailed = Manager.DownloadFailed.GetBoundCopy();
+                managerDownloadFailed.BindValueChanged(downloadFailed);
+                managerUpdated = Manager.ItemUpdated.GetBoundCopy();
+                managerUpdated.BindValueChanged(itemUpdated);
+                managerRemoved = Manager.ItemRemoved.GetBoundCopy();
+                managerRemoved.BindValueChanged(itemRemoved);
+            }
+        }
+
+        /// <summary>
+        /// Checks that a database model matches the one expected to be downloaded.
+        /// </summary>
+        /// <example>
+        /// For online play, this could be used to check that the databased model matches the online beatmap.
+        /// </example>
+        /// <param name="databasedModel">The model in database.</param>
+        protected virtual bool VerifyDatabasedModel(BeatmapSetInfo databasedModel) => true; // TODO: do we still need this?
+
+        private void downloadBegan(ValueChangedEvent<WeakReference<ArchiveDownloadRequest<BeatmapSetInfo>>> weakRequest)
+        {
+            if (weakRequest.NewValue.TryGetTarget(out var request))
+            {
+                Schedule(() =>
+                {
+                    if (checkEquality(request.Model, TrackedItem))
+                        attachDownload(request);
+                });
+            }
+        }
+
+        private void downloadFailed(ValueChangedEvent<WeakReference<ArchiveDownloadRequest<BeatmapSetInfo>>> weakRequest)
+        {
+            if (weakRequest.NewValue.TryGetTarget(out var request))
+            {
+                Schedule(() =>
+                {
+                    if (checkEquality(request.Model, TrackedItem))
+                        attachDownload(null);
+                });
+            }
+        }
+
+        private void attachDownload(ArchiveDownloadRequest<BeatmapSetInfo>? request)
+        {
+            if (attachedRequest != null)
+            {
+                attachedRequest.Failure -= onRequestFailure;
+                attachedRequest.DownloadProgressed -= onRequestProgress;
+                attachedRequest.Success -= onRequestSuccess;
+            }
+
+            attachedRequest = request;
+
+            if (attachedRequest != null)
+            {
+                if (attachedRequest.Progress == 1)
+                {
+                    UpdateProgress(1);
+                    UpdateState(DownloadState.Importing);
+                }
+                else
+                {
+                    UpdateProgress(attachedRequest.Progress);
+                    UpdateState(DownloadState.Downloading);
+
+                    attachedRequest.Failure += onRequestFailure;
+                    attachedRequest.DownloadProgressed += onRequestProgress;
+                    attachedRequest.Success += onRequestSuccess;
+                }
+            }
+            else
+            {
+                UpdateState(DownloadState.NotDownloaded);
+            }
+        }
+
+        private void onRequestSuccess(string _) => Schedule(() => UpdateState(DownloadState.Importing));
+
+        private void onRequestProgress(float progress) => Schedule(() => UpdateProgress(progress));
+
+        private void onRequestFailure(Exception e) => Schedule(() => attachDownload(null));
+
+        private void itemUpdated(ValueChangedEvent<WeakReference<BeatmapSetInfo>> weakItem)
+        {
+            if (weakItem.NewValue.TryGetTarget(out var item))
+            {
+                Schedule(() =>
+                {
+                    if (!checkEquality(item, TrackedItem))
+                        return;
+
+                    if (!VerifyDatabasedModel(item))
+                    {
+                        UpdateState(DownloadState.NotDownloaded);
+                        return;
+                    }
+
+                    UpdateState(DownloadState.LocallyAvailable);
+                });
+            }
+        }
+
+        private void itemRemoved(ValueChangedEvent<WeakReference<BeatmapSetInfo>> weakItem)
+        {
+            if (weakItem.NewValue.TryGetTarget(out var item))
+            {
+                Schedule(() =>
+                {
+                    if (checkEquality(item, TrackedItem))
+                        UpdateState(DownloadState.NotDownloaded);
+                });
+            }
+        }
+
+        private bool checkEquality(IBeatmapSetInfo x, IBeatmapSetInfo y) => x.OnlineID == y.OnlineID;
+
+        #region Disposal
+
+        protected override void Dispose(bool isDisposing)
+        {
+            base.Dispose(isDisposing);
+            attachDownload(null);
+        }
+
+        #endregion
+    }
+}
diff --git a/osu.Game/Online/DownloadTracker.cs b/osu.Game/Online/DownloadTracker.cs
new file mode 100644
index 0000000000..357c64b6a3
--- /dev/null
+++ b/osu.Game/Online/DownloadTracker.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.Bindables;
+using osu.Framework.Graphics;
+
+#nullable enable
+
+namespace osu.Game.Online
+{
+    public abstract class DownloadTracker<T> : Component
+        where T : class
+    {
+        public readonly T TrackedItem;
+
+        /// <summary>
+        /// Holds the current download state of the download - whether is has already been downloaded, is in progress, or is not downloaded.
+        /// </summary>
+        public IBindable<DownloadState> State => state;
+
+        private readonly Bindable<DownloadState> state = new Bindable<DownloadState>();
+
+        /// <summary>
+        /// The progress of an active download.
+        /// </summary>
+        public IBindableNumber<double> Progress => progress;
+
+        private readonly BindableNumber<double> progress = new BindableNumber<double> { MinValue = 0, MaxValue = 1 };
+
+        protected DownloadTracker(T trackedItem)
+        {
+            TrackedItem = trackedItem;
+        }
+
+        protected void UpdateState(DownloadState newState) => state.Value = newState;
+
+        protected void UpdateProgress(double newProgress) => progress.Value = newProgress;
+    }
+}
diff --git a/osu.Game/Online/ScoreDownloadTracker.cs b/osu.Game/Online/ScoreDownloadTracker.cs
new file mode 100644
index 0000000000..47cbabbee8
--- /dev/null
+++ b/osu.Game/Online/ScoreDownloadTracker.cs
@@ -0,0 +1,172 @@
+// 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.Bindables;
+using osu.Game.Online.API;
+using osu.Game.Scoring;
+
+#nullable enable
+
+namespace osu.Game.Online
+{
+    public class ScoreDownloadTracker : DownloadTracker<ScoreInfo>
+    {
+        [Resolved(CanBeNull = true)]
+        protected ScoreManager? Manager { get; private set; }
+
+        private ArchiveDownloadRequest<ScoreInfo>? attachedRequest;
+
+        public ScoreDownloadTracker(ScoreInfo trackedItem)
+            : base(trackedItem)
+        {
+        }
+
+        private IBindable<WeakReference<ScoreInfo>>? managerUpdated;
+        private IBindable<WeakReference<ScoreInfo>>? managerRemoved;
+        private IBindable<WeakReference<ArchiveDownloadRequest<ScoreInfo>>>? managerDownloadBegan;
+        private IBindable<WeakReference<ArchiveDownloadRequest<ScoreInfo>>>? managerDownloadFailed;
+
+        [BackgroundDependencyLoader(true)]
+        private void load()
+        {
+            // Used to interact with manager classes that don't support interface types. Will eventually be replaced.
+            var beatmapSetInfo = new ScoreInfo { OnlineScoreID = TrackedItem.OnlineScoreID };
+
+            if (TrackedItem.ID > 0 || Manager?.IsAvailableLocally(beatmapSetInfo) == true)
+                UpdateState(DownloadState.LocallyAvailable);
+            else if (Manager != null)
+                attachDownload(Manager.GetExistingDownload(beatmapSetInfo));
+
+            if (Manager != null)
+            {
+                managerDownloadBegan = Manager.DownloadBegan.GetBoundCopy();
+                managerDownloadBegan.BindValueChanged(downloadBegan);
+                managerDownloadFailed = Manager.DownloadFailed.GetBoundCopy();
+                managerDownloadFailed.BindValueChanged(downloadFailed);
+                managerUpdated = Manager.ItemUpdated.GetBoundCopy();
+                managerUpdated.BindValueChanged(itemUpdated);
+                managerRemoved = Manager.ItemRemoved.GetBoundCopy();
+                managerRemoved.BindValueChanged(itemRemoved);
+            }
+        }
+
+        /// <summary>
+        /// Checks that a database model matches the one expected to be downloaded.
+        /// </summary>
+        /// <example>
+        /// For online play, this could be used to check that the databased model matches the online beatmap.
+        /// </example>
+        /// <param name="databasedModel">The model in database.</param>
+        protected virtual bool VerifyDatabasedModel(ScoreInfo databasedModel) => true; // TODO: do we still need this?
+
+        private void downloadBegan(ValueChangedEvent<WeakReference<ArchiveDownloadRequest<ScoreInfo>>> weakRequest)
+        {
+            if (weakRequest.NewValue.TryGetTarget(out var request))
+            {
+                Schedule(() =>
+                {
+                    if (checkEquality(request.Model, TrackedItem))
+                        attachDownload(request);
+                });
+            }
+        }
+
+        private void downloadFailed(ValueChangedEvent<WeakReference<ArchiveDownloadRequest<ScoreInfo>>> weakRequest)
+        {
+            if (weakRequest.NewValue.TryGetTarget(out var request))
+            {
+                Schedule(() =>
+                {
+                    if (checkEquality(request.Model, TrackedItem))
+                        attachDownload(null);
+                });
+            }
+        }
+
+        private void attachDownload(ArchiveDownloadRequest<ScoreInfo>? request)
+        {
+            if (attachedRequest != null)
+            {
+                attachedRequest.Failure -= onRequestFailure;
+                attachedRequest.DownloadProgressed -= onRequestProgress;
+                attachedRequest.Success -= onRequestSuccess;
+            }
+
+            attachedRequest = request;
+
+            if (attachedRequest != null)
+            {
+                if (attachedRequest.Progress == 1)
+                {
+                    UpdateProgress(1);
+                    UpdateState(DownloadState.Importing);
+                }
+                else
+                {
+                    UpdateProgress(attachedRequest.Progress);
+                    UpdateState(DownloadState.Downloading);
+
+                    attachedRequest.Failure += onRequestFailure;
+                    attachedRequest.DownloadProgressed += onRequestProgress;
+                    attachedRequest.Success += onRequestSuccess;
+                }
+            }
+            else
+            {
+                UpdateState(DownloadState.NotDownloaded);
+            }
+        }
+
+        private void onRequestSuccess(string _) => Schedule(() => UpdateState(DownloadState.Importing));
+
+        private void onRequestProgress(float progress) => Schedule(() => UpdateProgress(progress));
+
+        private void onRequestFailure(Exception e) => Schedule(() => attachDownload(null));
+
+        private void itemUpdated(ValueChangedEvent<WeakReference<ScoreInfo>> weakItem)
+        {
+            if (weakItem.NewValue.TryGetTarget(out var item))
+            {
+                Schedule(() =>
+                {
+                    if (!checkEquality(item, TrackedItem))
+                        return;
+
+                    if (!VerifyDatabasedModel(item))
+                    {
+                        UpdateState(DownloadState.NotDownloaded);
+                        return;
+                    }
+
+                    UpdateState(DownloadState.LocallyAvailable);
+                });
+            }
+        }
+
+        private void itemRemoved(ValueChangedEvent<WeakReference<ScoreInfo>> weakItem)
+        {
+            if (weakItem.NewValue.TryGetTarget(out var item))
+            {
+                Schedule(() =>
+                {
+                    if (checkEquality(item, TrackedItem))
+                        UpdateState(DownloadState.NotDownloaded);
+                });
+            }
+        }
+
+        private bool checkEquality(ScoreInfo x, ScoreInfo y) => x.OnlineScoreID == y.OnlineScoreID;
+
+        #region Disposal
+
+        protected override void Dispose(bool isDisposing)
+        {
+            base.Dispose(isDisposing);
+            attachDownload(null);
+        }
+
+        #endregion
+    }
+}
diff --git a/osu.Game/Scoring/ScoreInfo.cs b/osu.Game/Scoring/ScoreInfo.cs
index 5cf22f7945..1bc04cd21e 100644
--- a/osu.Game/Scoring/ScoreInfo.cs
+++ b/osu.Game/Scoring/ScoreInfo.cs
@@ -19,7 +19,7 @@ using osu.Game.Utils;
 
 namespace osu.Game.Scoring
 {
-    public class ScoreInfo : IHasFiles<ScoreFileInfo>, IHasPrimaryKey, ISoftDelete, IEquatable<ScoreInfo>, IDeepCloneable<ScoreInfo>
+    public class ScoreInfo : IHasFiles<ScoreFileInfo>, IHasPrimaryKey, ISoftDelete, IEquatable<ScoreInfo>, IDeepCloneable<ScoreInfo>, IHasOnlineID
     {
         public int ID { get; set; }
 

From 617e6febb6bb81c61fbf126089a836edf7860817 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 27 Oct 2021 20:02:51 +0900
Subject: [PATCH 0521/5547] Refactor `ModelDownloader` to allow for different
 `OnlineID matching`

---
 osu.Game/Beatmaps/BeatmapModelDownloader.cs |  3 +++
 osu.Game/Database/ModelDownloader.cs        | 12 ++++++------
 osu.Game/Scoring/ScoreInfo.cs               |  2 +-
 osu.Game/Scoring/ScoreModelDownloader.cs    |  3 +++
 4 files changed, 13 insertions(+), 7 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapModelDownloader.cs b/osu.Game/Beatmaps/BeatmapModelDownloader.cs
index 30dc95a966..001726e741 100644
--- a/osu.Game/Beatmaps/BeatmapModelDownloader.cs
+++ b/osu.Game/Beatmaps/BeatmapModelDownloader.cs
@@ -13,6 +13,9 @@ namespace osu.Game.Beatmaps
         protected override ArchiveDownloadRequest<BeatmapSetInfo> CreateDownloadRequest(BeatmapSetInfo set, bool minimiseDownloadSize) =>
             new DownloadBeatmapSetRequest(set, minimiseDownloadSize);
 
+        public override ArchiveDownloadRequest<BeatmapSetInfo> GetExistingDownload(BeatmapSetInfo model)
+            => CurrentDownloads.Find(r => r.Model.OnlineID == model.OnlineID);
+
         public BeatmapModelDownloader(IBeatmapModelManager beatmapModelManager, IAPIProvider api, GameHost host = null)
             : base(beatmapModelManager, api, host)
         {
diff --git a/osu.Game/Database/ModelDownloader.cs b/osu.Game/Database/ModelDownloader.cs
index b9677c1b2b..12bf5e9ce7 100644
--- a/osu.Game/Database/ModelDownloader.cs
+++ b/osu.Game/Database/ModelDownloader.cs
@@ -15,7 +15,7 @@ using osu.Game.Overlays.Notifications;
 namespace osu.Game.Database
 {
     public abstract class ModelDownloader<TModel> : IModelDownloader<TModel>
-        where TModel : class, IHasPrimaryKey, ISoftDelete, IEquatable<TModel>, IHasOnlineID
+        where TModel : class, IHasPrimaryKey, ISoftDelete, IEquatable<TModel>
     {
         public Action<Notification> PostNotification { protected get; set; }
 
@@ -30,7 +30,7 @@ namespace osu.Game.Database
         private readonly IModelManager<TModel> modelManager;
         private readonly IAPIProvider api;
 
-        private readonly List<ArchiveDownloadRequest<TModel>> currentDownloads = new List<ArchiveDownloadRequest<TModel>>();
+        protected readonly List<ArchiveDownloadRequest<TModel>> CurrentDownloads = new List<ArchiveDownloadRequest<TModel>>();
 
         protected ModelDownloader(IModelManager<TModel> modelManager, IAPIProvider api, IIpcHost importHost = null)
         {
@@ -74,7 +74,7 @@ namespace osu.Game.Database
                     if (!imported.Any())
                         downloadFailed.Value = new WeakReference<ArchiveDownloadRequest<TModel>>(request);
 
-                    currentDownloads.Remove(request);
+                    CurrentDownloads.Remove(request);
                 }, TaskCreationOptions.LongRunning);
             };
 
@@ -86,7 +86,7 @@ namespace osu.Game.Database
                 return true;
             };
 
-            currentDownloads.Add(request);
+            CurrentDownloads.Add(request);
             PostNotification?.Invoke(notification);
 
             api.PerformAsync(request);
@@ -96,7 +96,7 @@ namespace osu.Game.Database
 
             void triggerFailure(Exception error)
             {
-                currentDownloads.Remove(request);
+                CurrentDownloads.Remove(request);
 
                 downloadFailed.Value = new WeakReference<ArchiveDownloadRequest<TModel>>(request);
 
@@ -107,7 +107,7 @@ namespace osu.Game.Database
             }
         }
 
-        public ArchiveDownloadRequest<TModel> GetExistingDownload(TModel model) => currentDownloads.Find(r => r.Model.OnlineID == model.OnlineID);
+        public abstract ArchiveDownloadRequest<TModel> GetExistingDownload(TModel model);
 
         private bool canDownload(TModel model) => GetExistingDownload(model) == null && api != null;
 
diff --git a/osu.Game/Scoring/ScoreInfo.cs b/osu.Game/Scoring/ScoreInfo.cs
index 1bc04cd21e..5cf22f7945 100644
--- a/osu.Game/Scoring/ScoreInfo.cs
+++ b/osu.Game/Scoring/ScoreInfo.cs
@@ -19,7 +19,7 @@ using osu.Game.Utils;
 
 namespace osu.Game.Scoring
 {
-    public class ScoreInfo : IHasFiles<ScoreFileInfo>, IHasPrimaryKey, ISoftDelete, IEquatable<ScoreInfo>, IDeepCloneable<ScoreInfo>, IHasOnlineID
+    public class ScoreInfo : IHasFiles<ScoreFileInfo>, IHasPrimaryKey, ISoftDelete, IEquatable<ScoreInfo>, IDeepCloneable<ScoreInfo>
     {
         public int ID { get; set; }
 
diff --git a/osu.Game/Scoring/ScoreModelDownloader.cs b/osu.Game/Scoring/ScoreModelDownloader.cs
index b3c1e2928a..52355585a9 100644
--- a/osu.Game/Scoring/ScoreModelDownloader.cs
+++ b/osu.Game/Scoring/ScoreModelDownloader.cs
@@ -16,5 +16,8 @@ namespace osu.Game.Scoring
         }
 
         protected override ArchiveDownloadRequest<ScoreInfo> CreateDownloadRequest(ScoreInfo score, bool minimiseDownload) => new DownloadReplayRequest(score);
+
+        public override ArchiveDownloadRequest<ScoreInfo> GetExistingDownload(ScoreInfo model)
+            => CurrentDownloads.Find(r => r.Model.OnlineScoreID == model.OnlineScoreID);
     }
 }

From 692db9a9ec2f424153e0374923247edeee0eb98e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 27 Oct 2021 20:21:00 +0900
Subject: [PATCH 0522/5547] Remove unnecessary verification flow from score
 download tracking

---
 osu.Game/Online/BeatmapDownloadTracker.cs | 15 ---------------
 osu.Game/Online/ScoreDownloadTracker.cs   | 17 +----------------
 2 files changed, 1 insertion(+), 31 deletions(-)

diff --git a/osu.Game/Online/BeatmapDownloadTracker.cs b/osu.Game/Online/BeatmapDownloadTracker.cs
index 969cb9af36..6df74efe9c 100644
--- a/osu.Game/Online/BeatmapDownloadTracker.cs
+++ b/osu.Game/Online/BeatmapDownloadTracker.cs
@@ -52,15 +52,6 @@ namespace osu.Game.Online
             }
         }
 
-        /// <summary>
-        /// Checks that a database model matches the one expected to be downloaded.
-        /// </summary>
-        /// <example>
-        /// For online play, this could be used to check that the databased model matches the online beatmap.
-        /// </example>
-        /// <param name="databasedModel">The model in database.</param>
-        protected virtual bool VerifyDatabasedModel(BeatmapSetInfo databasedModel) => true; // TODO: do we still need this?
-
         private void downloadBegan(ValueChangedEvent<WeakReference<ArchiveDownloadRequest<BeatmapSetInfo>>> weakRequest)
         {
             if (weakRequest.NewValue.TryGetTarget(out var request))
@@ -134,12 +125,6 @@ namespace osu.Game.Online
                     if (!checkEquality(item, TrackedItem))
                         return;
 
-                    if (!VerifyDatabasedModel(item))
-                    {
-                        UpdateState(DownloadState.NotDownloaded);
-                        return;
-                    }
-
                     UpdateState(DownloadState.LocallyAvailable);
                 });
             }
diff --git a/osu.Game/Online/ScoreDownloadTracker.cs b/osu.Game/Online/ScoreDownloadTracker.cs
index 47cbabbee8..7a714a7a0e 100644
--- a/osu.Game/Online/ScoreDownloadTracker.cs
+++ b/osu.Game/Online/ScoreDownloadTracker.cs
@@ -52,15 +52,6 @@ namespace osu.Game.Online
             }
         }
 
-        /// <summary>
-        /// Checks that a database model matches the one expected to be downloaded.
-        /// </summary>
-        /// <example>
-        /// For online play, this could be used to check that the databased model matches the online beatmap.
-        /// </example>
-        /// <param name="databasedModel">The model in database.</param>
-        protected virtual bool VerifyDatabasedModel(ScoreInfo databasedModel) => true; // TODO: do we still need this?
-
         private void downloadBegan(ValueChangedEvent<WeakReference<ArchiveDownloadRequest<ScoreInfo>>> weakRequest)
         {
             if (weakRequest.NewValue.TryGetTarget(out var request))
@@ -134,13 +125,7 @@ namespace osu.Game.Online
                     if (!checkEquality(item, TrackedItem))
                         return;
 
-                    if (!VerifyDatabasedModel(item))
-                    {
-                        UpdateState(DownloadState.NotDownloaded);
-                        return;
-                    }
-
-                    UpdateState(DownloadState.LocallyAvailable);
+                    UpdateState(DownloadState.NotDownloaded);
                 });
             }
         }

From 6339064dbd152ac4ebf121e8911037b32c9756b9 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 27 Oct 2021 20:07:00 +0900
Subject: [PATCH 0523/5547] Remove old versions of `DownloadTrackingComposite`

---
 osu.Game/Online/DownloadTrackingComposite.cs  | 196 ------------------
 .../BeatmapDownloadTrackingComposite.cs       |  19 --
 2 files changed, 215 deletions(-)
 delete mode 100644 osu.Game/Online/DownloadTrackingComposite.cs
 delete mode 100644 osu.Game/Overlays/BeatmapDownloadTrackingComposite.cs

diff --git a/osu.Game/Online/DownloadTrackingComposite.cs b/osu.Game/Online/DownloadTrackingComposite.cs
deleted file mode 100644
index 2a96051427..0000000000
--- a/osu.Game/Online/DownloadTrackingComposite.cs
+++ /dev/null
@@ -1,196 +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 JetBrains.Annotations;
-using osu.Framework.Allocation;
-using osu.Framework.Bindables;
-using osu.Framework.Graphics.Containers;
-using osu.Game.Database;
-using osu.Game.Online.API;
-
-namespace osu.Game.Online
-{
-    /// <summary>
-    /// A component which tracks a <typeparamref name="TModel"/> through potential download/import/deletion.
-    /// </summary>
-    public abstract class DownloadTrackingComposite<TModel, TModelManager> : CompositeDrawable
-        where TModel : class, IEquatable<TModel>
-        where TModelManager : class, IModelDownloader<TModel>, IModelManager<TModel>
-    {
-        protected readonly Bindable<TModel> Model = new Bindable<TModel>();
-
-        [Resolved(CanBeNull = true)]
-        protected TModelManager Manager { get; private set; }
-
-        /// <summary>
-        /// Holds the current download state of the <typeparamref name="TModel"/>, whether is has already been downloaded, is in progress, or is not downloaded.
-        /// </summary>
-        protected readonly Bindable<DownloadState> State = new Bindable<DownloadState>();
-
-        protected readonly BindableNumber<double> Progress = new BindableNumber<double> { MinValue = 0, MaxValue = 1 };
-
-        protected DownloadTrackingComposite(TModel model = null)
-        {
-            Model.Value = model;
-        }
-
-        private IBindable<WeakReference<TModel>> managerUpdated;
-        private IBindable<WeakReference<TModel>> managerRemoved;
-        private IBindable<WeakReference<ArchiveDownloadRequest<TModel>>> managerDownloadBegan;
-        private IBindable<WeakReference<ArchiveDownloadRequest<TModel>>> managerDownloadFailed;
-
-        [BackgroundDependencyLoader(true)]
-        private void load()
-        {
-            Model.BindValueChanged(modelInfo =>
-            {
-                if (modelInfo.NewValue == null)
-                    attachDownload(null);
-                else if (IsModelAvailableLocally())
-                    State.Value = DownloadState.LocallyAvailable;
-                else
-                    attachDownload(Manager?.GetExistingDownload(modelInfo.NewValue));
-            }, true);
-
-            if (Manager == null)
-                return;
-
-            managerDownloadBegan = Manager.DownloadBegan.GetBoundCopy();
-            managerDownloadBegan.BindValueChanged(downloadBegan);
-            managerDownloadFailed = Manager.DownloadFailed.GetBoundCopy();
-            managerDownloadFailed.BindValueChanged(downloadFailed);
-            managerUpdated = Manager.ItemUpdated.GetBoundCopy();
-            managerUpdated.BindValueChanged(itemUpdated);
-            managerRemoved = Manager.ItemRemoved.GetBoundCopy();
-            managerRemoved.BindValueChanged(itemRemoved);
-        }
-
-        /// <summary>
-        /// Checks that a database model matches the one expected to be downloaded.
-        /// </summary>
-        /// <example>
-        /// For online play, this could be used to check that the databased model matches the online beatmap.
-        /// </example>
-        /// <param name="databasedModel">The model in database.</param>
-        protected virtual bool VerifyDatabasedModel([NotNull] TModel databasedModel) => true;
-
-        /// <summary>
-        /// Whether the given model is available in the database.
-        /// By default, this calls <see cref="IModelManager{TModel}.IsAvailableLocally"/>,
-        /// but can be overriden to add additional checks for verifying the model in database.
-        /// </summary>
-        protected virtual bool IsModelAvailableLocally() => Manager?.IsAvailableLocally(Model.Value) == true;
-
-        private void downloadBegan(ValueChangedEvent<WeakReference<ArchiveDownloadRequest<TModel>>> weakRequest)
-        {
-            if (weakRequest.NewValue.TryGetTarget(out var request))
-            {
-                Schedule(() =>
-                {
-                    if (request.Model.Equals(Model.Value))
-                        attachDownload(request);
-                });
-            }
-        }
-
-        private void downloadFailed(ValueChangedEvent<WeakReference<ArchiveDownloadRequest<TModel>>> weakRequest)
-        {
-            if (weakRequest.NewValue.TryGetTarget(out var request))
-            {
-                Schedule(() =>
-                {
-                    if (request.Model.Equals(Model.Value))
-                        attachDownload(null);
-                });
-            }
-        }
-
-        private ArchiveDownloadRequest<TModel> attachedRequest;
-
-        private void attachDownload(ArchiveDownloadRequest<TModel> request)
-        {
-            if (attachedRequest != null)
-            {
-                attachedRequest.Failure -= onRequestFailure;
-                attachedRequest.DownloadProgressed -= onRequestProgress;
-                attachedRequest.Success -= onRequestSuccess;
-            }
-
-            attachedRequest = request;
-
-            if (attachedRequest != null)
-            {
-                if (attachedRequest.Progress == 1)
-                {
-                    Progress.Value = 1;
-                    State.Value = DownloadState.Importing;
-                }
-                else
-                {
-                    Progress.Value = attachedRequest.Progress;
-                    State.Value = DownloadState.Downloading;
-
-                    attachedRequest.Failure += onRequestFailure;
-                    attachedRequest.DownloadProgressed += onRequestProgress;
-                    attachedRequest.Success += onRequestSuccess;
-                }
-            }
-            else
-            {
-                State.Value = DownloadState.NotDownloaded;
-            }
-        }
-
-        private void onRequestSuccess(string _) => Schedule(() => State.Value = DownloadState.Importing);
-
-        private void onRequestProgress(float progress) => Schedule(() => Progress.Value = progress);
-
-        private void onRequestFailure(Exception e) => Schedule(() => attachDownload(null));
-
-        private void itemUpdated(ValueChangedEvent<WeakReference<TModel>> weakItem)
-        {
-            if (weakItem.NewValue.TryGetTarget(out var item))
-            {
-                Schedule(() =>
-                {
-                    if (!item.Equals(Model.Value))
-                        return;
-
-                    if (!VerifyDatabasedModel(item))
-                    {
-                        State.Value = DownloadState.NotDownloaded;
-                        return;
-                    }
-
-                    State.Value = DownloadState.LocallyAvailable;
-                });
-            }
-        }
-
-        private void itemRemoved(ValueChangedEvent<WeakReference<TModel>> weakItem)
-        {
-            if (weakItem.NewValue.TryGetTarget(out var item))
-            {
-                Schedule(() =>
-                {
-                    if (item.Equals(Model.Value))
-                        State.Value = DownloadState.NotDownloaded;
-                });
-            }
-        }
-
-        #region Disposal
-
-        protected override void Dispose(bool isDisposing)
-        {
-            base.Dispose(isDisposing);
-
-            State.UnbindAll();
-
-            attachDownload(null);
-        }
-
-        #endregion
-    }
-}
diff --git a/osu.Game/Overlays/BeatmapDownloadTrackingComposite.cs b/osu.Game/Overlays/BeatmapDownloadTrackingComposite.cs
deleted file mode 100644
index f6b5b181c3..0000000000
--- a/osu.Game/Overlays/BeatmapDownloadTrackingComposite.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.Bindables;
-using osu.Game.Beatmaps;
-using osu.Game.Online;
-
-namespace osu.Game.Overlays
-{
-    public abstract class BeatmapDownloadTrackingComposite : DownloadTrackingComposite<BeatmapSetInfo, BeatmapManager>
-    {
-        public Bindable<BeatmapSetInfo> BeatmapSet => Model;
-
-        protected BeatmapDownloadTrackingComposite(BeatmapSetInfo set = null)
-            : base(set)
-        {
-        }
-    }
-}

From dd06c617b149f2459b209640808b6a88d9bee440 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 27 Oct 2021 20:19:34 +0900
Subject: [PATCH 0524/5547] Update `OnlinePlayBeatmapAvailabilityTracker` in
 line with new download tracker

The structure here has changed a bit - rather than deriving from the
donwload tracker I moved the additional logic into the callbacks. I
think this feels better?
---
 .../OnlinePlayBeatmapAvailabilityTracker.cs   | 93 ++++++++++---------
 1 file changed, 48 insertions(+), 45 deletions(-)

diff --git a/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs b/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs
index 52aa115083..6dd1204555 100644
--- a/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs
+++ b/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs
@@ -2,8 +2,9 @@
 // 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.Graphics.Containers;
 using osu.Framework.Logging;
 using osu.Framework.Threading;
 using osu.Game.Beatmaps;
@@ -16,10 +17,13 @@ namespace osu.Game.Online.Rooms
     /// This differs from a regular download tracking composite as this accounts for the
     /// databased beatmap set's checksum, to disallow from playing with an altered version of the beatmap.
     /// </summary>
-    public class OnlinePlayBeatmapAvailabilityTracker : DownloadTrackingComposite<BeatmapSetInfo, BeatmapManager>
+    public class OnlinePlayBeatmapAvailabilityTracker : CompositeDrawable
     {
         public readonly IBindable<PlaylistItem> SelectedItem = new Bindable<PlaylistItem>();
 
+        [Resolved]
+        private BeatmapManager beatmapManager { get; set; }
+
         /// <summary>
         /// The availability state of the currently selected playlist item.
         /// </summary>
@@ -29,6 +33,8 @@ namespace osu.Game.Online.Rooms
 
         private ScheduledDelegate progressUpdate;
 
+        private BeatmapDownloadTracker downloadTracker;
+
         protected override void LoadComplete()
         {
             base.LoadComplete();
@@ -40,58 +46,39 @@ namespace osu.Game.Online.Rooms
                 if (item.NewValue == null)
                     return;
 
-                Model.Value = item.NewValue.Beatmap.Value.BeatmapSet;
+                downloadTracker?.Expire();
+                downloadTracker = new BeatmapDownloadTracker(item.NewValue.Beatmap.Value.BeatmapSet);
+
+                downloadTracker.Progress.BindValueChanged(_ =>
+                {
+                    if (downloadTracker.State.Value != DownloadState.Downloading)
+                        return;
+
+                    // incoming progress changes are going to be at a very high rate.
+                    // we don't want to flood the network with this, so rate limit how often we send progress updates.
+                    if (progressUpdate?.Completed != false)
+                        progressUpdate = Scheduler.AddDelayed(updateAvailability, progressUpdate == null ? 0 : 500);
+                });
+
+                downloadTracker.State.BindValueChanged(_ => updateAvailability(), true);
+
+                AddInternal(downloadTracker);
             }, true);
-
-            Progress.BindValueChanged(_ =>
-            {
-                if (State.Value != DownloadState.Downloading)
-                    return;
-
-                // incoming progress changes are going to be at a very high rate.
-                // we don't want to flood the network with this, so rate limit how often we send progress updates.
-                if (progressUpdate?.Completed != false)
-                    progressUpdate = Scheduler.AddDelayed(updateAvailability, progressUpdate == null ? 0 : 500);
-            });
-
-            State.BindValueChanged(_ => updateAvailability(), true);
-        }
-
-        protected override bool VerifyDatabasedModel(BeatmapSetInfo databasedSet)
-        {
-            int beatmapId = SelectedItem.Value?.Beatmap.Value.OnlineID ?? -1;
-            string checksum = SelectedItem.Value?.Beatmap.Value.MD5Hash;
-
-            var matchingBeatmap = databasedSet.Beatmaps.FirstOrDefault(b => b.OnlineBeatmapID == beatmapId && b.MD5Hash == checksum);
-
-            if (matchingBeatmap == null)
-            {
-                Logger.Log("The imported beatmap set does not match the online version.", LoggingTarget.Runtime, LogLevel.Important);
-                return false;
-            }
-
-            return true;
-        }
-
-        protected override bool IsModelAvailableLocally()
-        {
-            int onlineId = SelectedItem.Value.Beatmap.Value.OnlineID;
-            string checksum = SelectedItem.Value.Beatmap.Value.MD5Hash;
-
-            var beatmap = Manager.QueryBeatmap(b => b.OnlineBeatmapID == onlineId && b.MD5Hash == checksum);
-            return beatmap?.BeatmapSet.DeletePending == false;
         }
 
         private void updateAvailability()
         {
-            switch (State.Value)
+            if (downloadTracker == null)
+                return;
+
+            switch (downloadTracker.State.Value)
             {
                 case DownloadState.NotDownloaded:
                     availability.Value = BeatmapAvailability.NotDownloaded();
                     break;
 
                 case DownloadState.Downloading:
-                    availability.Value = BeatmapAvailability.Downloading((float)Progress.Value);
+                    availability.Value = BeatmapAvailability.Downloading((float)downloadTracker.Progress.Value);
                     break;
 
                 case DownloadState.Importing:
@@ -99,12 +86,28 @@ namespace osu.Game.Online.Rooms
                     break;
 
                 case DownloadState.LocallyAvailable:
-                    availability.Value = BeatmapAvailability.LocallyAvailable();
+                    bool hashMatches = checkHashValidity();
+
+                    availability.Value = hashMatches ? BeatmapAvailability.LocallyAvailable() : BeatmapAvailability.NotDownloaded();
+
+                    // only display a message to the user if a download seems to have just completed.
+                    if (!hashMatches && downloadTracker.Progress.Value == 1)
+                        Logger.Log("The imported beatmap set does not match the online version.", LoggingTarget.Runtime, LogLevel.Important);
+
                     break;
 
                 default:
-                    throw new ArgumentOutOfRangeException(nameof(State));
+                    throw new ArgumentOutOfRangeException();
             }
         }
+
+        private bool checkHashValidity()
+        {
+            int onlineId = SelectedItem.Value.Beatmap.Value.OnlineID;
+            string checksum = SelectedItem.Value.Beatmap.Value.MD5Hash;
+
+            var beatmap = beatmapManager.QueryBeatmap(b => b.OnlineBeatmapID == onlineId && b.MD5Hash == checksum);
+            return beatmap?.BeatmapSet.DeletePending == false;
+        }
     }
 }

From f014ceaead3556b47c8e0ea510cb3382206455a8 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 27 Oct 2021 20:49:15 +0900
Subject: [PATCH 0525/5547] Update remaining usages of download tracking

---
 .../Online/TestSceneDirectDownloadButton.cs   |  3 +-
 .../Panels/BeatmapPanelDownloadButton.cs      | 36 +++++++++++++------
 .../Panels/DownloadProgressBar.cs             | 18 +++++++---
 .../BeatmapSet/BeatmapSetHeaderContent.cs     | 19 +++++++---
 .../Buttons/HeaderDownloadButton.cs           | 33 ++++++++++-------
 .../OnlinePlay/DrawableRoomPlaylistItem.cs    |  2 +-
 .../Screens/Ranking/ReplayDownloadButton.cs   | 35 ++++++++++++------
 7 files changed, 100 insertions(+), 46 deletions(-)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneDirectDownloadButton.cs b/osu.Game.Tests/Visual/Online/TestSceneDirectDownloadButton.cs
index bb7fcc2fce..879e35057b 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneDirectDownloadButton.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneDirectDownloadButton.cs
@@ -5,6 +5,7 @@ using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
+using osu.Framework.Testing;
 using osu.Game.Beatmaps;
 using osu.Game.Online;
 using osu.Game.Online.API.Requests.Responses;
@@ -144,7 +145,7 @@ namespace osu.Game.Tests.Visual.Online
         {
             public new bool DownloadEnabled => base.DownloadEnabled;
 
-            public DownloadState DownloadState => State.Value;
+            public DownloadState DownloadState => this.ChildrenOfType<BeatmapDownloadTracker>().First().State.Value;
 
             public TestDownloadButton(BeatmapSetInfo beatmapSet)
                 : base(beatmapSet)
diff --git a/osu.Game/Overlays/BeatmapListing/Panels/BeatmapPanelDownloadButton.cs b/osu.Game/Overlays/BeatmapListing/Panels/BeatmapPanelDownloadButton.cs
index a8c4334ffb..5c6472cd1b 100644
--- a/osu.Game/Overlays/BeatmapListing/Panels/BeatmapPanelDownloadButton.cs
+++ b/osu.Game/Overlays/BeatmapListing/Panels/BeatmapPanelDownloadButton.cs
@@ -5,6 +5,7 @@ using System;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
 using osu.Game.Beatmaps;
 using osu.Game.Configuration;
 using osu.Game.Graphics.Containers;
@@ -13,7 +14,7 @@ using osu.Game.Online;
 
 namespace osu.Game.Overlays.BeatmapListing.Panels
 {
-    public class BeatmapPanelDownloadButton : BeatmapDownloadTrackingComposite
+    public class BeatmapPanelDownloadButton : CompositeDrawable
     {
         protected bool DownloadEnabled => button.Enabled.Value;
 
@@ -26,16 +27,29 @@ namespace osu.Game.Overlays.BeatmapListing.Panels
         private readonly DownloadButton button;
         private Bindable<bool> noVideoSetting;
 
+        protected readonly BeatmapDownloadTracker DownloadTracker;
+
+        protected readonly Bindable<DownloadState> State = new Bindable<DownloadState>();
+
+        private readonly BeatmapSetInfo beatmapSet;
+
         public BeatmapPanelDownloadButton(BeatmapSetInfo beatmapSet)
-            : base(beatmapSet)
         {
-            InternalChild = shakeContainer = new ShakeContainer
+            this.beatmapSet = beatmapSet;
+            InternalChildren = new Drawable[]
             {
-                RelativeSizeAxes = Axes.Both,
-                Child = button = new DownloadButton
+                shakeContainer = new ShakeContainer
                 {
                     RelativeSizeAxes = Axes.Both,
+                    Child = button = new DownloadButton
+                    {
+                        RelativeSizeAxes = Axes.Both,
+                    },
                 },
+                DownloadTracker = new BeatmapDownloadTracker(beatmapSet)
+                {
+                    State = { BindTarget = State }
+                }
             };
 
             button.Add(new DownloadProgressBar(beatmapSet)
@@ -50,7 +64,7 @@ namespace osu.Game.Overlays.BeatmapListing.Panels
         {
             base.LoadComplete();
 
-            button.State.BindTo(State);
+            ((IBindable<DownloadState>)button.State).BindTo(DownloadTracker.State);
             FinishTransforms(true);
         }
 
@@ -61,7 +75,7 @@ namespace osu.Game.Overlays.BeatmapListing.Panels
 
             button.Action = () =>
             {
-                switch (State.Value)
+                switch (DownloadTracker.State.Value)
                 {
                     case DownloadState.Downloading:
                     case DownloadState.Importing:
@@ -73,16 +87,16 @@ namespace osu.Game.Overlays.BeatmapListing.Panels
                         if (SelectedBeatmap.Value != null)
                             findPredicate = b => b.OnlineBeatmapID == SelectedBeatmap.Value.OnlineBeatmapID;
 
-                        game?.PresentBeatmap(BeatmapSet.Value, findPredicate);
+                        game?.PresentBeatmap(beatmapSet, findPredicate);
                         break;
 
                     default:
-                        beatmaps.Download(BeatmapSet.Value, noVideoSetting.Value);
+                        beatmaps.Download(beatmapSet, noVideoSetting.Value);
                         break;
                 }
             };
 
-            State.BindValueChanged(state =>
+            DownloadTracker.State.BindValueChanged(state =>
             {
                 switch (state.NewValue)
                 {
@@ -92,7 +106,7 @@ namespace osu.Game.Overlays.BeatmapListing.Panels
                         break;
 
                     default:
-                        if (BeatmapSet.Value?.OnlineInfo?.Availability.DownloadDisabled ?? false)
+                        if (beatmapSet.OnlineInfo?.Availability.DownloadDisabled ?? false)
                         {
                             button.Enabled.Value = false;
                             button.TooltipText = "this beatmap is currently not available for download.";
diff --git a/osu.Game/Overlays/BeatmapListing/Panels/DownloadProgressBar.cs b/osu.Game/Overlays/BeatmapListing/Panels/DownloadProgressBar.cs
index ca94078401..24f929f55e 100644
--- a/osu.Game/Overlays/BeatmapListing/Panels/DownloadProgressBar.cs
+++ b/osu.Game/Overlays/BeatmapListing/Panels/DownloadProgressBar.cs
@@ -4,6 +4,7 @@
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
 using osu.Game.Beatmaps;
 using osu.Game.Graphics;
 using osu.Game.Graphics.UserInterface;
@@ -12,13 +13,22 @@ using osuTK.Graphics;
 
 namespace osu.Game.Overlays.BeatmapListing.Panels
 {
-    public class DownloadProgressBar : BeatmapDownloadTrackingComposite
+    public class DownloadProgressBar : CompositeDrawable
     {
         private readonly ProgressBar progressBar;
+        private readonly BeatmapDownloadTracker downloadTracker;
 
         public DownloadProgressBar(BeatmapSetInfo beatmapSet)
-            : base(beatmapSet)
         {
+            InternalChildren = new Drawable[]
+            {
+                progressBar = new ProgressBar(false)
+                {
+                    Height = 0,
+                    Alpha = 0,
+                },
+                downloadTracker = new BeatmapDownloadTracker(beatmapSet),
+            };
             AddInternal(progressBar = new ProgressBar(false)
             {
                 Height = 0,
@@ -34,9 +44,9 @@ namespace osu.Game.Overlays.BeatmapListing.Panels
         {
             progressBar.FillColour = colours.Blue;
             progressBar.BackgroundColour = Color4.Black.Opacity(0.7f);
-            progressBar.Current = Progress;
+            progressBar.Current.BindTarget = downloadTracker.Progress;
 
-            State.BindValueChanged(state =>
+            downloadTracker.State.BindValueChanged(state =>
             {
                 switch (state.NewValue)
                 {
diff --git a/osu.Game/Overlays/BeatmapSet/BeatmapSetHeaderContent.cs b/osu.Game/Overlays/BeatmapSet/BeatmapSetHeaderContent.cs
index 6f85846720..e0a09ed520 100644
--- a/osu.Game/Overlays/BeatmapSet/BeatmapSetHeaderContent.cs
+++ b/osu.Game/Overlays/BeatmapSet/BeatmapSetHeaderContent.cs
@@ -3,12 +3,14 @@
 
 using System.Linq;
 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.Shapes;
 using osu.Framework.Localisation;
+using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.Drawables;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
@@ -21,8 +23,10 @@ using osuTK;
 
 namespace osu.Game.Overlays.BeatmapSet
 {
-    public class BeatmapSetHeaderContent : BeatmapDownloadTrackingComposite
+    public class BeatmapSetHeaderContent : CompositeDrawable
     {
+        public readonly Bindable<BeatmapSetInfo> BeatmapSet = new Bindable<BeatmapSetInfo>();
+
         private const float transition_duration = 200;
         private const float buttons_height = 45;
         private const float buttons_spacing = 5;
@@ -45,6 +49,8 @@ namespace osu.Game.Overlays.BeatmapSet
         private readonly FillFlowContainer fadeContent;
         private readonly LoadingSpinner loading;
 
+        private BeatmapDownloadTracker downloadTracker;
+
         [Resolved]
         private IAPIProvider api { get; set; }
 
@@ -222,13 +228,13 @@ namespace osu.Game.Overlays.BeatmapSet
         {
             coverGradient.Colour = ColourInfo.GradientVertical(colourProvider.Background6.Opacity(0.3f), colourProvider.Background6.Opacity(0.8f));
 
-            State.BindValueChanged(_ => updateDownloadButtons());
-
             BeatmapSet.BindValueChanged(setInfo =>
             {
                 Picker.BeatmapSet = rulesetSelector.BeatmapSet = author.BeatmapSet = beatmapAvailability.BeatmapSet = Details.BeatmapSet = setInfo.NewValue;
                 cover.BeatmapSet = setInfo.NewValue;
 
+                downloadTracker?.Expire();
+
                 if (setInfo.NewValue == null)
                 {
                     onlineStatusPill.FadeTo(0.5f, 500, Easing.OutQuint);
@@ -241,6 +247,9 @@ namespace osu.Game.Overlays.BeatmapSet
                 }
                 else
                 {
+                    downloadTracker = new BeatmapDownloadTracker(setInfo.NewValue);
+                    downloadTracker.State.BindValueChanged(_ => updateDownloadButtons());
+
                     fadeContent.FadeIn(500, Easing.OutQuint);
 
                     loading.Hide();
@@ -266,13 +275,13 @@ namespace osu.Game.Overlays.BeatmapSet
         {
             if (BeatmapSet.Value == null) return;
 
-            if (BeatmapSet.Value.OnlineInfo.Availability.DownloadDisabled && State.Value != DownloadState.LocallyAvailable)
+            if (BeatmapSet.Value.OnlineInfo.Availability.DownloadDisabled && downloadTracker.State.Value != DownloadState.LocallyAvailable)
             {
                 downloadButtonsContainer.Clear();
                 return;
             }
 
-            switch (State.Value)
+            switch (downloadTracker.State.Value)
             {
                 case DownloadState.LocallyAvailable:
                     // temporary for UX until new design is implemented.
diff --git a/osu.Game/Overlays/BeatmapSet/Buttons/HeaderDownloadButton.cs b/osu.Game/Overlays/BeatmapSet/Buttons/HeaderDownloadButton.cs
index e7a55079ec..88d0778ae4 100644
--- a/osu.Game/Overlays/BeatmapSet/Buttons/HeaderDownloadButton.cs
+++ b/osu.Game/Overlays/BeatmapSet/Buttons/HeaderDownloadButton.cs
@@ -22,7 +22,7 @@ using osuTK.Graphics;
 
 namespace osu.Game.Overlays.BeatmapSet.Buttons
 {
-    public class HeaderDownloadButton : BeatmapDownloadTrackingComposite, IHasTooltip
+    public class HeaderDownloadButton : CompositeDrawable, IHasTooltip
     {
         private const int text_size = 12;
 
@@ -35,9 +35,12 @@ namespace osu.Game.Overlays.BeatmapSet.Buttons
         private ShakeContainer shakeContainer;
         private HeaderButton button;
 
+        private BeatmapDownloadTracker downloadTracker;
+        private readonly BeatmapSetInfo beatmapSet;
+
         public HeaderDownloadButton(BeatmapSetInfo beatmapSet, bool noVideo = false)
-            : base(beatmapSet)
         {
+            this.beatmapSet = beatmapSet;
             this.noVideo = noVideo;
 
             Width = 120;
@@ -49,13 +52,17 @@ namespace osu.Game.Overlays.BeatmapSet.Buttons
         {
             FillFlowContainer textSprites;
 
-            AddInternal(shakeContainer = new ShakeContainer
+            InternalChildren = new Drawable[]
             {
-                RelativeSizeAxes = Axes.Both,
-                Masking = true,
-                CornerRadius = 5,
-                Child = button = new HeaderButton { RelativeSizeAxes = Axes.Both },
-            });
+                shakeContainer = new ShakeContainer
+                {
+                    RelativeSizeAxes = Axes.Both,
+                    Masking = true,
+                    CornerRadius = 5,
+                    Child = button = new HeaderButton { RelativeSizeAxes = Axes.Both },
+                },
+                downloadTracker = new BeatmapDownloadTracker(beatmapSet),
+            };
 
             button.AddRange(new Drawable[]
             {
@@ -83,7 +90,7 @@ namespace osu.Game.Overlays.BeatmapSet.Buttons
                         },
                     }
                 },
-                new DownloadProgressBar(BeatmapSet.Value)
+                new DownloadProgressBar(beatmapSet)
                 {
                     Anchor = Anchor.BottomLeft,
                     Origin = Anchor.BottomLeft,
@@ -92,20 +99,20 @@ namespace osu.Game.Overlays.BeatmapSet.Buttons
 
             button.Action = () =>
             {
-                if (State.Value != DownloadState.NotDownloaded)
+                if (downloadTracker.State.Value != DownloadState.NotDownloaded)
                 {
                     shakeContainer.Shake();
                     return;
                 }
 
-                beatmaps.Download(BeatmapSet.Value, noVideo);
+                beatmaps.Download(beatmapSet, noVideo);
             };
 
             localUser.BindTo(api.LocalUser);
             localUser.BindValueChanged(userChanged, true);
             button.Enabled.BindValueChanged(enabledChanged, true);
 
-            State.BindValueChanged(state =>
+            downloadTracker.State.BindValueChanged(state =>
             {
                 switch (state.NewValue)
                 {
@@ -161,7 +168,7 @@ namespace osu.Game.Overlays.BeatmapSet.Buttons
 
         private LocalisableString getVideoSuffixText()
         {
-            if (!BeatmapSet.Value.OnlineInfo.HasVideo)
+            if (!beatmapSet.OnlineInfo.HasVideo)
                 return string.Empty;
 
             return noVideo ? BeatmapsetsStrings.ShowDetailsDownloadNoVideo : BeatmapsetsStrings.ShowDetailsDownloadVideo;
diff --git a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
index 585b024623..16dd7b498b 100644
--- a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
+++ b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
@@ -302,7 +302,7 @@ namespace osu.Game.Screens.OnlinePlay
             {
                 base.LoadComplete();
 
-                State.BindValueChanged(stateChanged, true);
+                DownloadTracker.State.BindValueChanged(stateChanged, true);
                 FinishTransforms(true);
             }
 
diff --git a/osu.Game/Screens/Ranking/ReplayDownloadButton.cs b/osu.Game/Screens/Ranking/ReplayDownloadButton.cs
index e644eb671a..f7325d2eb4 100644
--- a/osu.Game/Screens/Ranking/ReplayDownloadButton.cs
+++ b/osu.Game/Screens/Ranking/ReplayDownloadButton.cs
@@ -4,6 +4,7 @@
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Online;
@@ -12,13 +13,17 @@ using osuTK;
 
 namespace osu.Game.Screens.Ranking
 {
-    public class ReplayDownloadButton : DownloadTrackingComposite<ScoreInfo, ScoreManager>
+    public class ReplayDownloadButton : CompositeDrawable
     {
-        public Bindable<ScoreInfo> Score => Model;
+        public readonly Bindable<ScoreInfo> Score = new Bindable<ScoreInfo>();
+
+        protected readonly Bindable<DownloadState> State = new Bindable<DownloadState>();
 
         private DownloadButton button;
         private ShakeContainer shakeContainer;
 
+        private ScoreDownloadTracker downloadTracker;
+
         private ReplayAvailability replayAvailability
         {
             get
@@ -26,7 +31,7 @@ namespace osu.Game.Screens.Ranking
                 if (State.Value == DownloadState.LocallyAvailable)
                     return ReplayAvailability.Local;
 
-                if (!string.IsNullOrEmpty(Model.Value?.Hash))
+                if (!string.IsNullOrEmpty(Score.Value?.Hash))
                     return ReplayAvailability.Online;
 
                 return ReplayAvailability.NotAvailable;
@@ -34,8 +39,8 @@ namespace osu.Game.Screens.Ranking
         }
 
         public ReplayDownloadButton(ScoreInfo score)
-            : base(score)
         {
+            Score.Value = score;
             Size = new Vector2(50, 30);
         }
 
@@ -56,11 +61,11 @@ namespace osu.Game.Screens.Ranking
                 switch (State.Value)
                 {
                     case DownloadState.LocallyAvailable:
-                        game?.PresentScore(Model.Value, ScorePresentType.Gameplay);
+                        game?.PresentScore(Score.Value, ScorePresentType.Gameplay);
                         break;
 
                     case DownloadState.NotDownloaded:
-                        scores.Download(Model.Value, false);
+                        scores.Download(Score.Value, false);
                         break;
 
                     case DownloadState.Importing:
@@ -70,17 +75,25 @@ namespace osu.Game.Screens.Ranking
                 }
             };
 
-            State.BindValueChanged(state =>
+            Score.BindValueChanged(score =>
             {
-                button.State.Value = state.NewValue;
+                downloadTracker?.Expire();
 
+                if (score.NewValue != null)
+                {
+                    AddInternal(downloadTracker = new ScoreDownloadTracker(score.NewValue)
+                    {
+                        State = { BindTarget = State }
+                    });
+                }
+
+                button.Enabled.Value = replayAvailability != ReplayAvailability.NotAvailable;
                 updateTooltip();
             }, true);
 
-            Model.BindValueChanged(_ =>
+            State.BindValueChanged(state =>
             {
-                button.Enabled.Value = replayAvailability != ReplayAvailability.NotAvailable;
-
+                button.State.Value = state.NewValue;
                 updateTooltip();
             }, true);
         }

From 746d6a4c166f274e456b36a7e7f40fcd25ae39f4 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 27 Oct 2021 21:26:26 +0900
Subject: [PATCH 0526/5547] Fix some oversights and test failures

---
 .../Online/TestSceneDirectDownloadButton.cs    |  3 +--
 osu.Game/Online/BeatmapDownloadTracker.cs      |  8 +++-----
 .../OnlinePlayBeatmapAvailabilityTracker.cs    | 12 +++++++-----
 .../Panels/BeatmapPanelDownloadButton.cs       | 18 +++++++++---------
 .../BeatmapSet/BeatmapSetHeaderContent.cs      |  2 +-
 .../OnlinePlay/DrawableRoomPlaylistItem.cs     |  7 +++----
 .../Screens/OnlinePlay/Match/RoomSubScreen.cs  |  2 --
 .../Multiplayer/MultiplayerMatchSubScreen.cs   |  4 ++--
 .../Screens/Ranking/ReplayDownloadButton.cs    |  2 +-
 9 files changed, 27 insertions(+), 31 deletions(-)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneDirectDownloadButton.cs b/osu.Game.Tests/Visual/Online/TestSceneDirectDownloadButton.cs
index 879e35057b..bb7fcc2fce 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneDirectDownloadButton.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneDirectDownloadButton.cs
@@ -5,7 +5,6 @@ using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
-using osu.Framework.Testing;
 using osu.Game.Beatmaps;
 using osu.Game.Online;
 using osu.Game.Online.API.Requests.Responses;
@@ -145,7 +144,7 @@ namespace osu.Game.Tests.Visual.Online
         {
             public new bool DownloadEnabled => base.DownloadEnabled;
 
-            public DownloadState DownloadState => this.ChildrenOfType<BeatmapDownloadTracker>().First().State.Value;
+            public DownloadState DownloadState => State.Value;
 
             public TestDownloadButton(BeatmapSetInfo beatmapSet)
                 : base(beatmapSet)
diff --git a/osu.Game/Online/BeatmapDownloadTracker.cs b/osu.Game/Online/BeatmapDownloadTracker.cs
index 6df74efe9c..181968c02f 100644
--- a/osu.Game/Online/BeatmapDownloadTracker.cs
+++ b/osu.Game/Online/BeatmapDownloadTracker.cs
@@ -34,7 +34,7 @@ namespace osu.Game.Online
             // Used to interact with manager classes that don't support interface types. Will eventually be replaced.
             var beatmapSetInfo = new BeatmapSetInfo { OnlineBeatmapSetID = TrackedItem.OnlineID };
 
-            if ((TrackedItem as BeatmapSetInfo)?.ID > 0 || Manager?.IsAvailableLocally(beatmapSetInfo) == true)
+            if (Manager?.IsAvailableLocally(beatmapSetInfo) == true)
                 UpdateState(DownloadState.LocallyAvailable);
             else if (Manager != null)
                 attachDownload(Manager.GetExistingDownload(beatmapSetInfo));
@@ -122,10 +122,8 @@ namespace osu.Game.Online
             {
                 Schedule(() =>
                 {
-                    if (!checkEquality(item, TrackedItem))
-                        return;
-
-                    UpdateState(DownloadState.LocallyAvailable);
+                    if (checkEquality(item, TrackedItem))
+                        UpdateState(DownloadState.LocallyAvailable);
                 });
             }
         }
diff --git a/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs b/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs
index 6dd1204555..5e09f42aa8 100644
--- a/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs
+++ b/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs
@@ -4,6 +4,7 @@
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
+using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Logging;
 using osu.Framework.Threading;
@@ -17,10 +18,12 @@ namespace osu.Game.Online.Rooms
     /// This differs from a regular download tracking composite as this accounts for the
     /// databased beatmap set's checksum, to disallow from playing with an altered version of the beatmap.
     /// </summary>
-    public class OnlinePlayBeatmapAvailabilityTracker : CompositeDrawable
+    public sealed class OnlinePlayBeatmapAvailabilityTracker : CompositeDrawable
     {
         public readonly IBindable<PlaylistItem> SelectedItem = new Bindable<PlaylistItem>();
 
+        protected override bool RequiresChildrenUpdate => true;
+
         [Resolved]
         private BeatmapManager beatmapManager { get; set; }
 
@@ -46,9 +49,10 @@ namespace osu.Game.Online.Rooms
                 if (item.NewValue == null)
                     return;
 
-                downloadTracker?.Expire();
-                downloadTracker = new BeatmapDownloadTracker(item.NewValue.Beatmap.Value.BeatmapSet);
+                downloadTracker?.RemoveAndDisposeImmediately();
 
+                downloadTracker = new BeatmapDownloadTracker(item.NewValue.Beatmap.Value.BeatmapSet);
+                downloadTracker.State.BindValueChanged(_ => updateAvailability());
                 downloadTracker.Progress.BindValueChanged(_ =>
                 {
                     if (downloadTracker.State.Value != DownloadState.Downloading)
@@ -60,8 +64,6 @@ namespace osu.Game.Online.Rooms
                         progressUpdate = Scheduler.AddDelayed(updateAvailability, progressUpdate == null ? 0 : 500);
                 });
 
-                downloadTracker.State.BindValueChanged(_ => updateAvailability(), true);
-
                 AddInternal(downloadTracker);
             }, true);
         }
diff --git a/osu.Game/Overlays/BeatmapListing/Panels/BeatmapPanelDownloadButton.cs b/osu.Game/Overlays/BeatmapListing/Panels/BeatmapPanelDownloadButton.cs
index 5c6472cd1b..dd12e8e467 100644
--- a/osu.Game/Overlays/BeatmapListing/Panels/BeatmapPanelDownloadButton.cs
+++ b/osu.Game/Overlays/BeatmapListing/Panels/BeatmapPanelDownloadButton.cs
@@ -36,6 +36,7 @@ namespace osu.Game.Overlays.BeatmapListing.Panels
         public BeatmapPanelDownloadButton(BeatmapSetInfo beatmapSet)
         {
             this.beatmapSet = beatmapSet;
+
             InternalChildren = new Drawable[]
             {
                 shakeContainer = new ShakeContainer
@@ -44,6 +45,7 @@ namespace osu.Game.Overlays.BeatmapListing.Panels
                     Child = button = new DownloadButton
                     {
                         RelativeSizeAxes = Axes.Both,
+                        State = { BindTarget = State }
                     },
                 },
                 DownloadTracker = new BeatmapDownloadTracker(beatmapSet)
@@ -60,14 +62,6 @@ namespace osu.Game.Overlays.BeatmapListing.Panels
             });
         }
 
-        protected override void LoadComplete()
-        {
-            base.LoadComplete();
-
-            ((IBindable<DownloadState>)button.State).BindTo(DownloadTracker.State);
-            FinishTransforms(true);
-        }
-
         [BackgroundDependencyLoader(true)]
         private void load(OsuGame game, BeatmapManager beatmaps, OsuConfigManager osuConfig)
         {
@@ -96,7 +90,7 @@ namespace osu.Game.Overlays.BeatmapListing.Panels
                 }
             };
 
-            DownloadTracker.State.BindValueChanged(state =>
+            State.BindValueChanged(state =>
             {
                 switch (state.NewValue)
                 {
@@ -116,5 +110,11 @@ namespace osu.Game.Overlays.BeatmapListing.Panels
                 }
             }, true);
         }
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+            FinishTransforms(true);
+        }
     }
 }
diff --git a/osu.Game/Overlays/BeatmapSet/BeatmapSetHeaderContent.cs b/osu.Game/Overlays/BeatmapSet/BeatmapSetHeaderContent.cs
index e0a09ed520..624d07fb0f 100644
--- a/osu.Game/Overlays/BeatmapSet/BeatmapSetHeaderContent.cs
+++ b/osu.Game/Overlays/BeatmapSet/BeatmapSetHeaderContent.cs
@@ -233,7 +233,7 @@ namespace osu.Game.Overlays.BeatmapSet
                 Picker.BeatmapSet = rulesetSelector.BeatmapSet = author.BeatmapSet = beatmapAvailability.BeatmapSet = Details.BeatmapSet = setInfo.NewValue;
                 cover.BeatmapSet = setInfo.NewValue;
 
-                downloadTracker?.Expire();
+                downloadTracker?.RemoveAndDisposeImmediately();
 
                 if (setInfo.NewValue == null)
                 {
diff --git a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
index 16dd7b498b..5639265617 100644
--- a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
+++ b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
@@ -289,7 +289,8 @@ namespace osu.Game.Screens.OnlinePlay
             [Resolved]
             private BeatmapManager beatmapManager { get; set; }
 
-            public override bool IsPresent => base.IsPresent || Scheduler.HasPendingTasks;
+            // required for download tracking, as this button hides itself. can probably be removed with a bit of consideration.
+            public override bool IsPresent => true;
 
             public PlaylistDownloadButton(PlaylistItem playlistItem)
                 : base(playlistItem.Beatmap.Value.BeatmapSet)
@@ -300,10 +301,8 @@ namespace osu.Game.Screens.OnlinePlay
 
             protected override void LoadComplete()
             {
+                State.BindValueChanged(stateChanged, true);
                 base.LoadComplete();
-
-                DownloadTracker.State.BindValueChanged(stateChanged, true);
-                FinishTransforms(true);
             }
 
             private void stateChanged(ValueChangedEvent<DownloadState> state)
diff --git a/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs b/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
index bcb793062b..270d12ec97 100644
--- a/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
@@ -67,8 +67,6 @@ namespace osu.Game.Screens.OnlinePlay.Match
         [Cached]
         protected OnlinePlayBeatmapAvailabilityTracker BeatmapAvailabilityTracker { get; private set; }
 
-        protected IBindable<BeatmapAvailability> BeatmapAvailability => BeatmapAvailabilityTracker.Availability;
-
         public readonly Room Room;
         private readonly bool allowEdit;
 
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
index 544eac4127..0af41c977b 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
@@ -66,7 +66,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
 
             SelectedItem.BindTo(client.CurrentMatchPlayingItem);
 
-            BeatmapAvailability.BindValueChanged(updateBeatmapAvailability, true);
+            BeatmapAvailabilityTracker.Availability.BindValueChanged(updateBeatmapAvailability, true);
             UserMods.BindValueChanged(onUserModsChanged);
 
             client.LoadRequested += onLoadRequested;
@@ -362,7 +362,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
 
         private void onLoadRequested()
         {
-            if (BeatmapAvailability.Value.State != DownloadState.LocallyAvailable)
+            if (BeatmapAvailabilityTracker.Availability.Value.State != DownloadState.LocallyAvailable)
                 return;
 
             // In the case of spectating, IMultiplayerClient.LoadRequested can be fired while the game is still spectating a previous session.
diff --git a/osu.Game/Screens/Ranking/ReplayDownloadButton.cs b/osu.Game/Screens/Ranking/ReplayDownloadButton.cs
index f7325d2eb4..66b3c973f5 100644
--- a/osu.Game/Screens/Ranking/ReplayDownloadButton.cs
+++ b/osu.Game/Screens/Ranking/ReplayDownloadButton.cs
@@ -77,7 +77,7 @@ namespace osu.Game.Screens.Ranking
 
             Score.BindValueChanged(score =>
             {
-                downloadTracker?.Expire();
+                downloadTracker?.RemoveAndDisposeImmediately();
 
                 if (score.NewValue != null)
                 {

From 347f41f367c67e2e7c2d79f76e1bdcc66ea907f3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 27 Oct 2021 23:54:02 +0900
Subject: [PATCH 0527/5547] Change test to allow for potentially single-frame
 delayed events firing

---
 .../Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs b/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
index 558b874234..5e7ce3abf5 100644
--- a/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
+++ b/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
@@ -128,7 +128,7 @@ namespace osu.Game.Tests.Online
 
         private void addAvailabilityCheckStep(string description, Func<BeatmapAvailability> expected)
         {
-            AddAssert(description, () => availabilityTracker.Availability.Value.Equals(expected.Invoke()));
+            AddUntilStep(description, () => availabilityTracker.Availability.Value.Equals(expected.Invoke()));
         }
 
         private static BeatmapInfo getTestBeatmapInfo(string archiveFile)

From 7245baba691b96dd2c86c9abdebb2b3b7139c61d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 28 Oct 2021 00:13:25 +0900
Subject: [PATCH 0528/5547] Remove `IBeatmapSetOnlineInfo` implementation from
 `BeatmapSetInfo` to avoid null cases

---
 .../TestSceneUpdateableBeatmapSetCover.cs            | 12 ++++++------
 .../Components/TournamentBeatmapPanel.cs             |  2 +-
 osu.Game/Beatmaps/BeatmapSetInfo.cs                  |  2 +-
 .../Drawables/UpdateableBeatmapBackgroundSprite.cs   |  5 +++++
 .../Drawables/UpdateableOnlineBeatmapSetCover.cs     |  2 +-
 .../BeatmapListing/BeatmapListingSearchControl.cs    |  2 +-
 .../Overlays/BeatmapListing/Panels/BeatmapPanel.cs   |  2 +-
 .../Overlays/BeatmapSet/BeatmapSetHeaderContent.cs   |  2 +-
 .../Overlays/Dashboard/Home/DashboardBeatmapPanel.cs |  2 +-
 .../Sections/Historical/DrawableMostPlayedBeatmap.cs |  2 +-
 10 files changed, 19 insertions(+), 14 deletions(-)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneUpdateableBeatmapSetCover.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneUpdateableBeatmapSetCover.cs
index 3ac3002713..f67f6258cc 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneUpdateableBeatmapSetCover.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneUpdateableBeatmapSetCover.cs
@@ -25,7 +25,7 @@ namespace osu.Game.Tests.Visual.UserInterface
         {
             AddStep("setup cover", () => Child = new UpdateableOnlineBeatmapSetCover(coverType)
             {
-                BeatmapSet = CreateBeatmap(Ruleset.Value).BeatmapInfo.BeatmapSet,
+                OnlineInfo = CreateBeatmap(Ruleset.Value).BeatmapInfo.BeatmapSet.OnlineInfo,
                 RelativeSizeAxes = Axes.Both,
                 Masking = true,
             });
@@ -68,7 +68,7 @@ namespace osu.Game.Tests.Visual.UserInterface
 
                     var cover = new UpdateableOnlineBeatmapSetCover(coverType)
                     {
-                        BeatmapSet = setInfo,
+                        OnlineInfo = setInfo.OnlineInfo,
                         Height = 100,
                         Masking = true,
                     };
@@ -99,12 +99,12 @@ namespace osu.Game.Tests.Visual.UserInterface
 
             AddStep("setup cover", () => Child = updateableCover = new TestUpdateableOnlineBeatmapSetCover
             {
-                BeatmapSet = CreateBeatmap(Ruleset.Value).BeatmapInfo.BeatmapSet,
+                OnlineInfo = CreateBeatmap(Ruleset.Value).BeatmapInfo.BeatmapSet.OnlineInfo,
                 RelativeSizeAxes = Axes.Both,
                 Masking = true,
             });
 
-            AddStep("change model", () => updateableCover.BeatmapSet = null);
+            AddStep("change model", () => updateableCover.OnlineInfo = null);
             AddWaitStep("wait some", 5);
             AddAssert("no cover added", () => !updateableCover.ChildrenOfType<DelayedLoadUnloadWrapper>().Any());
         }
@@ -117,7 +117,7 @@ namespace osu.Game.Tests.Visual.UserInterface
 
             AddStep("setup cover", () => Child = updateableCover = new TestUpdateableOnlineBeatmapSetCover(0)
             {
-                BeatmapSet = createBeatmapWithCover("https://assets.ppy.sh/beatmaps/1189904/covers/cover.jpg"),
+                OnlineInfo = createBeatmapWithCover("https://assets.ppy.sh/beatmaps/1189904/covers/cover.jpg").OnlineInfo,
                 RelativeSizeAxes = Axes.Both,
                 Masking = true,
                 Alpha = 0.4f
@@ -128,7 +128,7 @@ namespace osu.Game.Tests.Visual.UserInterface
             AddUntilStep("wait for fade complete", () => initialCover.Alpha == 1);
 
             AddStep("switch beatmap",
-                () => updateableCover.BeatmapSet = createBeatmapWithCover("https://assets.ppy.sh/beatmaps/1079428/covers/cover.jpg"));
+                () => updateableCover.OnlineInfo = createBeatmapWithCover("https://assets.ppy.sh/beatmaps/1079428/covers/cover.jpg").OnlineInfo);
             AddUntilStep("new cover loaded", () => updateableCover.ChildrenOfType<OnlineBeatmapSetCover>().Except(new[] { initialCover }).Any());
         }
 
diff --git a/osu.Game.Tournament/Components/TournamentBeatmapPanel.cs b/osu.Game.Tournament/Components/TournamentBeatmapPanel.cs
index be29566e07..70544f3a3f 100644
--- a/osu.Game.Tournament/Components/TournamentBeatmapPanel.cs
+++ b/osu.Game.Tournament/Components/TournamentBeatmapPanel.cs
@@ -62,7 +62,7 @@ namespace osu.Game.Tournament.Components
                 {
                     RelativeSizeAxes = Axes.Both,
                     Colour = OsuColour.Gray(0.5f),
-                    BeatmapSet = BeatmapInfo.BeatmapSet as IBeatmapSetOnlineInfo,
+                    OnlineInfo = BeatmapInfo.BeatmapSet as IBeatmapSetOnlineInfo,
                 },
                 new FillFlowContainer
                 {
diff --git a/osu.Game/Beatmaps/BeatmapSetInfo.cs b/osu.Game/Beatmaps/BeatmapSetInfo.cs
index ae32ad000e..6ed617898f 100644
--- a/osu.Game/Beatmaps/BeatmapSetInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapSetInfo.cs
@@ -14,7 +14,7 @@ using osu.Game.Online.API.Requests.Responses;
 namespace osu.Game.Beatmaps
 {
     [ExcludeFromDynamicCompile]
-    public class BeatmapSetInfo : IHasPrimaryKey, IHasFiles<BeatmapSetFileInfo>, ISoftDelete, IEquatable<BeatmapSetInfo>, IBeatmapSetInfo, IBeatmapSetOnlineInfo
+    public class BeatmapSetInfo : IHasPrimaryKey, IHasFiles<BeatmapSetFileInfo>, ISoftDelete, IEquatable<BeatmapSetInfo>, IBeatmapSetInfo
     {
         public int ID { get; set; }
 
diff --git a/osu.Game/Beatmaps/Drawables/UpdateableBeatmapBackgroundSprite.cs b/osu.Game/Beatmaps/Drawables/UpdateableBeatmapBackgroundSprite.cs
index 636c568bd0..4100fe9586 100644
--- a/osu.Game/Beatmaps/Drawables/UpdateableBeatmapBackgroundSprite.cs
+++ b/osu.Game/Beatmaps/Drawables/UpdateableBeatmapBackgroundSprite.cs
@@ -57,7 +57,12 @@ namespace osu.Game.Beatmaps.Drawables
                 return new OnlineBeatmapSetCover(online, beatmapSetCoverType);
 
             if (model is BeatmapInfo localModel)
+            {
+                if (localModel.BeatmapSet?.OnlineInfo != null)
+                    return new OnlineBeatmapSetCover(localModel.BeatmapSet.OnlineInfo, beatmapSetCoverType);
+
                 return new BeatmapBackgroundSprite(beatmaps.GetWorkingBeatmap(localModel));
+            }
 
             return new BeatmapBackgroundSprite(beatmaps.DefaultBeatmap);
         }
diff --git a/osu.Game/Beatmaps/Drawables/UpdateableOnlineBeatmapSetCover.cs b/osu.Game/Beatmaps/Drawables/UpdateableOnlineBeatmapSetCover.cs
index 73f87beb58..4a6a1b888e 100644
--- a/osu.Game/Beatmaps/Drawables/UpdateableOnlineBeatmapSetCover.cs
+++ b/osu.Game/Beatmaps/Drawables/UpdateableOnlineBeatmapSetCover.cs
@@ -13,7 +13,7 @@ namespace osu.Game.Beatmaps.Drawables
     {
         private readonly BeatmapSetCoverType coverType;
 
-        public IBeatmapSetOnlineInfo BeatmapSet
+        public IBeatmapSetOnlineInfo OnlineInfo
         {
             get => Model;
             set => Model = value;
diff --git a/osu.Game/Overlays/BeatmapListing/BeatmapListingSearchControl.cs b/osu.Game/Overlays/BeatmapListing/BeatmapListingSearchControl.cs
index da2dcfebdf..776a8e73b0 100644
--- a/osu.Game/Overlays/BeatmapListing/BeatmapListingSearchControl.cs
+++ b/osu.Game/Overlays/BeatmapListing/BeatmapListingSearchControl.cs
@@ -59,7 +59,7 @@ namespace osu.Game.Overlays.BeatmapListing
                     return;
                 }
 
-                beatmapCover.BeatmapSet = value;
+                beatmapCover.OnlineInfo = value.OnlineInfo;
                 beatmapCover.FadeTo(0.1f, 200, Easing.OutQuint);
             }
         }
diff --git a/osu.Game/Overlays/BeatmapListing/Panels/BeatmapPanel.cs b/osu.Game/Overlays/BeatmapListing/Panels/BeatmapPanel.cs
index 779f3860f2..c7fa98f159 100644
--- a/osu.Game/Overlays/BeatmapListing/Panels/BeatmapPanel.cs
+++ b/osu.Game/Overlays/BeatmapListing/Panels/BeatmapPanel.cs
@@ -163,7 +163,7 @@ namespace osu.Game.Overlays.BeatmapListing.Panels
         protected Drawable CreateBackground() => new UpdateableOnlineBeatmapSetCover
         {
             RelativeSizeAxes = Axes.Both,
-            BeatmapSet = SetInfo,
+            OnlineInfo = SetInfo.OnlineInfo,
         };
 
         public class Statistic : FillFlowContainer
diff --git a/osu.Game/Overlays/BeatmapSet/BeatmapSetHeaderContent.cs b/osu.Game/Overlays/BeatmapSet/BeatmapSetHeaderContent.cs
index 6f85846720..4c94e95383 100644
--- a/osu.Game/Overlays/BeatmapSet/BeatmapSetHeaderContent.cs
+++ b/osu.Game/Overlays/BeatmapSet/BeatmapSetHeaderContent.cs
@@ -227,7 +227,7 @@ namespace osu.Game.Overlays.BeatmapSet
             BeatmapSet.BindValueChanged(setInfo =>
             {
                 Picker.BeatmapSet = rulesetSelector.BeatmapSet = author.BeatmapSet = beatmapAvailability.BeatmapSet = Details.BeatmapSet = setInfo.NewValue;
-                cover.BeatmapSet = setInfo.NewValue;
+                cover.OnlineInfo = setInfo.NewValue?.OnlineInfo;
 
                 if (setInfo.NewValue == null)
                 {
diff --git a/osu.Game/Overlays/Dashboard/Home/DashboardBeatmapPanel.cs b/osu.Game/Overlays/Dashboard/Home/DashboardBeatmapPanel.cs
index edc737d8fe..50186def37 100644
--- a/osu.Game/Overlays/Dashboard/Home/DashboardBeatmapPanel.cs
+++ b/osu.Game/Overlays/Dashboard/Home/DashboardBeatmapPanel.cs
@@ -82,7 +82,7 @@ namespace osu.Game.Overlays.Dashboard.Home
                                         RelativeSizeAxes = Axes.Both,
                                         Anchor = Anchor.Centre,
                                         Origin = Anchor.Centre,
-                                        BeatmapSet = SetInfo
+                                        OnlineInfo = SetInfo.OnlineInfo
                                     }
                                 },
                                 new Container
diff --git a/osu.Game/Overlays/Profile/Sections/Historical/DrawableMostPlayedBeatmap.cs b/osu.Game/Overlays/Profile/Sections/Historical/DrawableMostPlayedBeatmap.cs
index c4c8bfb84f..ac4299ae49 100644
--- a/osu.Game/Overlays/Profile/Sections/Historical/DrawableMostPlayedBeatmap.cs
+++ b/osu.Game/Overlays/Profile/Sections/Historical/DrawableMostPlayedBeatmap.cs
@@ -46,7 +46,7 @@ namespace osu.Game.Overlays.Profile.Sections.Historical
                 {
                     RelativeSizeAxes = Axes.Y,
                     Width = cover_width,
-                    BeatmapSet = mostPlayed.BeatmapSet,
+                    OnlineInfo = mostPlayed.BeatmapSet,
                 },
                 new Container
                 {

From 290f583ae0d19aa35549d00e101598d96de7500a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 28 Oct 2021 00:59:48 +0900
Subject: [PATCH 0529/5547] Fix incorrect initial state

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

diff --git a/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs b/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs
index 5e09f42aa8..87348fbd1c 100644
--- a/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs
+++ b/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs
@@ -32,7 +32,7 @@ namespace osu.Game.Online.Rooms
         /// </summary>
         public IBindable<BeatmapAvailability> Availability => availability;
 
-        private readonly Bindable<BeatmapAvailability> availability = new Bindable<BeatmapAvailability>(BeatmapAvailability.LocallyAvailable());
+        private readonly Bindable<BeatmapAvailability> availability = new Bindable<BeatmapAvailability>(BeatmapAvailability.NotDownloaded());
 
         private ScheduledDelegate progressUpdate;
 

From ddf87316dfcdf775e4f8baa972b95413f1fdd5f2 Mon Sep 17 00:00:00 2001
From: Xexxar <xexxar.xexxar@gmail.com>
Date: Wed, 27 Oct 2021 16:30:17 +0000
Subject: [PATCH 0530/5547] updated to add nerf for repeated acute angles

---
 osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
index 94f02c2d9f..7ccb5158db 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
@@ -23,7 +23,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
         protected override int HistoryLength => 2;
 
         private const double wide_angle_multiplier = 1.5;
-        private const double acute_angle_multiplier = 1.5;
+        private const double acute_angle_multiplier = 2.0;
 
         private double currentStrain = 1;
 
@@ -69,6 +69,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
                 {
                     double currAngle = osuCurrObj.Angle.Value;
                     double prevAngle = osuPrevObj.Angle.Value;
+                    double lastAngle = osuLastObj.Angle.Value;
 
                     // Rewarding angles, take the smaller velocity as base.
                     angleBonus = Math.Min(currVelocity, prevVelocity);
@@ -84,7 +85,8 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
                                             * Math.Pow(Math.Sin(Math.PI / 2 * Math.Min(1, (100 - osuCurrObj.StrainTime) / 25)), 2) // scale buff from 150 bpm 1/4 to 200 bpm 1/4
                                             * Math.Pow(Math.Sin(Math.PI / 2 * (Math.Min(100, osuCurrObj.JumpDistance) - 50) / 50), 2); // Buff distance exceeding 50 (radius) up to 100 (diameter).
 
-                    wideAngleBonus *= angleBonus * (1 - Math.Pow(calcWideAngleBonus(prevAngle), 3)); // Penalize wide angles if they're repeated, reducing the penalty as the prevAngle gets more acute.
+                    wideAngleBonus *= angleBonus * (1 - Math.Min(wideAngleBonus, Math.Pow(calcWideAngleBonus(prevAngle), 3))); // Penalize wide angles if they're repeated, reducing the penalty as the prevAngle gets more acute.
+                    acuteAngleBonus *= 0.5 + 0.5 * (1 - Math.Min(acuteAngleBonus, Math.Pow(calcAcuteAngleBonus(lastAngle), 3))); // Penalize acute angles if they're repeated, reducing the penalty as the lastAngle gets more obtuse.
 
                     angleBonus = acuteAngleBonus * acute_angle_multiplier + wideAngleBonus * wide_angle_multiplier; // add the anglebuffs together.
                 }

From 7eb7d1258969ee34173a230f8cf1cb2df6784de6 Mon Sep 17 00:00:00 2001
From: Xexxar <xexxar.xexxar@gmail.com>
Date: Wed, 27 Oct 2021 18:08:30 +0000
Subject: [PATCH 0531/5547] updated sliders to handle increased tick rates
 better

---
 .../Preprocessing/OsuDifficultyHitObject.cs   | 31 +++++++++++++------
 .../Difficulty/Skills/Aim.cs                  |  4 +--
 2 files changed, 24 insertions(+), 11 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
index 3139f6eb26..8722b85839 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
@@ -91,26 +91,39 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
                 MovementTime = Math.Max(StrainTime - lastSlider.LazyTravelTime / clockRate, min_delta_time);
                 MovementDistance = Vector2.Subtract(lastSlider.TailCircle.StackedPosition, BaseObject.StackedPosition).Length * scalingFactor;
 
+                int repeatCount = 0;
+
                 for (int i = 1; i < lastSlider.NestedHitObjects.Count; i++)
                 {
                     Vector2 currSlider = Vector2.Subtract(((OsuHitObject)lastSlider.NestedHitObjects[i]).StackedPosition, ((OsuHitObject)lastSlider.NestedHitObjects[i - 1]).StackedPosition);
 
-                    if ((OsuHitObject)lastSlider.NestedHitObjects[i] is SliderRepeat)
-                        TravelDistance += Math.Max(0, currSlider.Length * scalingFactor - 100); // remove 100 distance to avoid buffing overlapping followcircles.
+                    if ((OsuHitObject)lastSlider.NestedHitObjects[i] is SliderRepeat && (OsuHitObject)lastSlider.NestedHitObjects[i - 1] is SliderRepeat)
+                    {
+                        repeatCount++;
+                        TravelDistance += Math.Max(0, currSlider.Length * scalingFactor - 240); // remove 240 distance to avoid buffing overlapping followcircles.
+                    }
+                    else if ((OsuHitObject)lastSlider.NestedHitObjects[i] is SliderRepeat)
+                    {
+                        repeatCount++;
+                        TravelDistance += Math.Max(0, currSlider.Length * scalingFactor - 120); // remove 120 distance to avoid buffing overlapping followcircles.
+                    }
                     else if ((OsuHitObject)lastSlider.NestedHitObjects[i] is SliderEndCircle)
                     {
                         Vector2 possSlider = Vector2.Subtract((Vector2)lastSlider.LazyEndPosition, ((OsuHitObject)lastSlider.NestedHitObjects[i - 1]).StackedPosition);
                         TravelDistance += Math.Min(possSlider.Length, currSlider.Length) * scalingFactor; // Take the least distance from slider end vs lazy end.
                     }
                     else
-                        TravelDistance += Vector2.Subtract(((OsuHitObject)lastSlider.NestedHitObjects[i]).StackedPosition, ((OsuHitObject)lastSlider.NestedHitObjects[i - 1]).StackedPosition).Length * scalingFactor;
-
-                    if ((OsuHitObject)lastSlider.NestedHitObjects[i] is SliderTick && i != lastSlider.NestedHitObjects.Count - 1) // Check for tick && not last object is necessary for 2007 bugged sliders.
-                    {
-                        Vector2 nextSlider = Vector2.Subtract(((OsuHitObject)lastSlider.NestedHitObjects[i + 1]).StackedPosition, ((OsuHitObject)lastSlider.NestedHitObjects[i]).StackedPosition);
-                        TravelDistance += Math.Max(0, Vector2.Subtract(nextSlider, currSlider).Length - Math.Max(nextSlider.Length, currSlider.Length)) * scalingFactor; // bonus for ticks where angles are less than 120 degrees.
-                    }
+                        TravelDistance += Math.Max(0, currSlider.Length * scalingFactor - 100); // remove 100 distance to avoid buffing overlapping ticks, mostly needed to prevent buffing slow sliders with high tick rate.
                 }
+
+                if (repeatCount == 0)
+                {
+                    TravelDistance = Math.Max(TravelDistance, scalingFactor * // idea here is to prevent ticks from dropping difficulty of slider by removing distance in calculation.
+                                              Math.Min(Vector2.Subtract(((OsuHitObject)lastSlider.NestedHitObjects[lastSlider.NestedHitObjects.Count - 1]).StackedPosition, ((OsuHitObject)lastSlider.NestedHitObjects[0]).StackedPosition).Length,
+                                                       Vector2.Subtract((Vector2)lastSlider.LazyEndPosition, ((OsuHitObject)lastSlider.NestedHitObjects[0]).StackedPosition).Length));
+                }
+                else
+                    TravelDistance *= Math.Pow(1 + repeatCount / 2.0, 1.0 / 2.0); // Bonus for repeat sliders until a better per nested object strain system can be achieved.
             }
 
             Vector2 lastCursorPosition = getEndCursorPosition(lastObject);
diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
index ecf1b16804..eec330587d 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
@@ -24,7 +24,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
 
         private const double wide_angle_multiplier = 1.5;
         private const double acute_angle_multiplier = 2.0;
-        private const double slider_multiplier = 1.75;
+        private const double slider_multiplier = 1.5;
 
         private double currentStrain = 1;
 
@@ -67,7 +67,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
 
             if (Precision.AlmostEquals(osuCurrObj.StrainTime, osuPrevObj.StrainTime, 10)) // If rhythms are the same.
             {
-                if (osuCurrObj.Angle != null && osuPrevObj.Angle != null)
+                if (osuCurrObj.Angle != null && osuPrevObj.Angle != null && osuLastObj.Angle != null)
                 {
                     double currAngle = osuCurrObj.Angle.Value;
                     double prevAngle = osuPrevObj.Angle.Value;

From cd04ca12400e641b08c3e06f99832dd39c3c21d8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 27 Oct 2021 20:35:19 +0200
Subject: [PATCH 0532/5547] Remove unused using statement

---
 osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs | 1 -
 1 file changed, 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
index a106f3ea95..ebb348c3a2 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
@@ -4,7 +4,6 @@
 using System;
 using System.Diagnostics;
 using System.Linq;
-using Microsoft.VisualStudio.TestPlatform.CommunicationUtilities;
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;

From 798349243fabb373d290303d618809ab779607da Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 27 Oct 2021 20:38:52 +0200
Subject: [PATCH 0533/5547] Cache test request handler in screen navigation
 test

---
 .../Visual/Navigation/TestSceneScreenNavigation.cs   | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs b/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
index 87223a3eca..1df0680b69 100644
--- a/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
@@ -9,6 +9,7 @@ using osu.Framework.Screens;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
 using osu.Game.Graphics.UserInterface;
+using osu.Game.Online.API;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Overlays;
 using osu.Game.Overlays.Mods;
@@ -24,6 +25,7 @@ using osu.Game.Screens.Select;
 using osu.Game.Screens.Select.Options;
 using osu.Game.Tests.Beatmaps.IO;
 using osu.Game.Tests.Visual.Multiplayer;
+using osu.Game.Tests.Visual.OnlinePlay;
 using osuTK;
 using osuTK.Input;
 
@@ -459,9 +461,19 @@ namespace osu.Game.Tests.Visual.Navigation
             [Cached(typeof(MultiplayerClient))]
             public readonly TestMultiplayerClient Client;
 
+            [Cached]
+            public readonly TestRoomRequestsHandler RequestsHandler;
+
             public TestMultiplayer()
             {
                 Client = new TestMultiplayerClient((TestMultiplayerRoomManager)RoomManager);
+                RequestsHandler = new TestRoomRequestsHandler();
+            }
+
+            [BackgroundDependencyLoader]
+            private void load(IAPIProvider api, OsuGameBase game)
+            {
+                ((DummyAPIAccess)api).HandleRequest = request => RequestsHandler.HandleRequest(request, api.LocalUser.Value, game);
             }
 
             protected override RoomManager CreateRoomManager() => new TestMultiplayerRoomManager();

From 65a7b6776e72000e8784c60216d207f5a5c774e2 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 28 Oct 2021 05:50:22 +0900
Subject: [PATCH 0534/5547] Add note regarding `OnlineInfo` being temporary

---
 osu.Game/Beatmaps/BeatmapSetInfo.cs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Game/Beatmaps/BeatmapSetInfo.cs b/osu.Game/Beatmaps/BeatmapSetInfo.cs
index 6ed617898f..79cc8b70fb 100644
--- a/osu.Game/Beatmaps/BeatmapSetInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapSetInfo.cs
@@ -35,6 +35,7 @@ namespace osu.Game.Beatmaps
         [NotNull]
         public List<BeatmapSetFileInfo> Files { get; set; } = new List<BeatmapSetFileInfo>();
 
+        // This field is temporary and only used by `APIBeatmapSet.ToBeatmapSet` (soon to be removed) and tests (to be updated to provide APIBeatmapSet instead).
         [NotMapped]
         public APIBeatmapSet OnlineInfo { get; set; }
 

From 3905ecd18b37abc9b988359f0891742d7fed6ca4 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 28 Oct 2021 13:09:03 +0900
Subject: [PATCH 0535/5547] Use retrieval of bindable and tidy up code slightly

---
 osu.Game/OsuGame.cs | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index 25ce62b787..f9e080a93c 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -158,6 +158,8 @@ namespace osu.Game
 
         private Bindable<int> configRuleset;
 
+        private Bindable<float> uiScale;
+
         private Bindable<int> configSkin;
 
         private readonly string[] args;
@@ -219,6 +221,7 @@ namespace osu.Game
 
             // bind config int to database RulesetInfo
             configRuleset = LocalConfig.GetBindable<int>(OsuSetting.Ruleset);
+            uiScale = LocalConfig.GetBindable<float>(OsuSetting.UIScale);
 
             var preferredRuleset = RulesetStore.GetRuleset(configRuleset.Value);
 
@@ -1022,26 +1025,23 @@ namespace osu.Game
 
         public override bool OnPressed(KeyBindingPressEvent<PlatformAction> e)
         {
+            const float adjustment_increment = 0.05f;
+
             switch (e.Action)
             {
                 case PlatformAction.ZoomIn:
-                    adjustUIScaling(1);
+                    uiScale.Value += adjustment_increment;
                     return true;
 
                 case PlatformAction.ZoomOut:
-                    adjustUIScaling(-1);
+                    uiScale.Value -= adjustment_increment;
                     return true;
 
                 case PlatformAction.ZoomDefault:
-                    LocalConfig.GetBindable<float>(OsuSetting.UIScale).SetDefault();
+                    uiScale.SetDefault();
                     return true;
             }
 
-            void adjustUIScaling(int amount)
-            {
-                LocalConfig.SetValue(OsuSetting.UIScale, LocalConfig.Get<float>(OsuSetting.UIScale) + (0.05f * amount));
-            }
-
             return base.OnPressed(e);
         }
 

From 1213c5553a64944df87eeae67e2b2a20a6dcc02c Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Thu, 28 Oct 2021 13:16:50 +0900
Subject: [PATCH 0536/5547] Remove forgotten attribute

---
 .../Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs      | 2 --
 1 file changed, 2 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs
index 10633f4a4f..832998d5d3 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs
@@ -8,7 +8,6 @@ using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.ObjectExtensions;
 using osu.Framework.Graphics;
-using osu.Framework.Testing;
 using osu.Framework.Utils;
 using osu.Game.Configuration;
 using osu.Game.Online.API;
@@ -40,7 +39,6 @@ namespace osu.Game.Tests.Visual.Multiplayer
             Dependencies.Cache(config = new OsuConfigManager(LocalStorage));
         }
 
-        [SetUpSteps]
         public override void SetUpSteps()
         {
             base.SetUpSteps();

From 0e293471c2b7ee4fb49b6baa4b19697291c67a59 Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Thu, 28 Oct 2021 14:29:49 +0900
Subject: [PATCH 0537/5547] Clean up multiplayer-screen tests by removing
 intermediate screen

---
 .../Multiplayer/TestSceneMultiplayer.cs       | 78 ++++-------------
 .../Visual/Multiplayer/TestSceneTeamVersus.cs | 66 ++-------------
 .../Navigation/TestSceneScreenNavigation.cs   | 36 +-------
 .../Visual/TestMultiplayerScreenStack.cs      | 84 +++++++++++++++++++
 .../MultiplayerTestSceneDependencies.cs       |  2 +-
 .../Multiplayer/TestMultiplayerRoomManager.cs |  9 +-
 .../OnlinePlayTestSceneDependencies.cs        |  4 +-
 7 files changed, 119 insertions(+), 160 deletions(-)
 create mode 100644 osu.Game.Tests/Visual/TestMultiplayerScreenStack.cs

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
index ebb348c3a2..11caf9f498 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
@@ -17,15 +17,12 @@ using osu.Framework.Utils;
 using osu.Game.Beatmaps;
 using osu.Game.Database;
 using osu.Game.Graphics.UserInterface;
-using osu.Game.Online.API;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Rooms;
 using osu.Game.Overlays.Mods;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Osu.Mods;
-using osu.Game.Screens;
-using osu.Game.Screens.OnlinePlay.Components;
 using osu.Game.Screens.OnlinePlay.Lounge;
 using osu.Game.Screens.OnlinePlay.Lounge.Components;
 using osu.Game.Screens.OnlinePlay.Match;
@@ -33,8 +30,8 @@ using osu.Game.Screens.OnlinePlay.Multiplayer;
 using osu.Game.Screens.OnlinePlay.Multiplayer.Match;
 using osu.Game.Screens.Play;
 using osu.Game.Screens.Ranking;
+using osu.Game.Screens.Spectate;
 using osu.Game.Tests.Resources;
-using osu.Game.Tests.Visual.OnlinePlay;
 using osu.Game.Users;
 using osuTK.Input;
 
@@ -46,11 +43,10 @@ namespace osu.Game.Tests.Visual.Multiplayer
         private RulesetStore rulesets;
         private BeatmapSetInfo importedSet;
 
-        private DependenciesScreen dependenciesScreen;
-        private TestMultiplayer multiplayerScreen;
-        private TestMultiplayerClient client;
+        private TestMultiplayerScreenStack multiplayerScreenStack;
 
-        private TestMultiplayerRoomManager roomManager => multiplayerScreen.RoomManager;
+        private TestMultiplayerClient client => multiplayerScreenStack.Client;
+        private TestMultiplayerRoomManager roomManager => multiplayerScreenStack.RoomManager;
 
         [Cached(typeof(UserLookupCache))]
         private UserLookupCache lookupCache = new TestUserLookupCache();
@@ -72,22 +68,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 importedSet = beatmaps.GetAllUsableBeatmapSetsEnumerable(IncludedDetails.All).First();
             });
 
-            AddStep("create multiplayer screen", () => multiplayerScreen = new TestMultiplayer());
-
-            AddStep("load dependencies", () =>
-            {
-                client = new TestMultiplayerClient(roomManager);
-
-                // The screen gets suspended so it stops receiving updates.
-                Child = client;
-
-                LoadScreen(dependenciesScreen = new DependenciesScreen(client));
-            });
-
-            AddUntilStep("wait for dependencies to load", () => dependenciesScreen.IsLoaded);
-
-            AddStep("load multiplayer", () => LoadScreen(multiplayerScreen));
-            AddUntilStep("wait for multiplayer to load", () => multiplayerScreen.IsLoaded);
+            AddStep("load multiplayer", () => LoadScreen(multiplayerScreenStack = new TestMultiplayerScreenStack()));
+            AddUntilStep("wait for multiplayer to load", () => multiplayerScreenStack.IsLoaded);
             AddUntilStep("wait for lounge to load", () => this.ChildrenOfType<MultiplayerLoungeSubScreen>().FirstOrDefault()?.IsLoaded == true);
         }
 
@@ -443,7 +425,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             AddStep("start match externally", () => client.StartMatch());
 
-            AddAssert("play not started", () => multiplayerScreen.IsCurrentScreen());
+            AddAssert("play not started", () => multiplayerScreenStack.IsCurrentScreen());
         }
 
         [Test]
@@ -487,7 +469,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 importedSet = beatmaps.GetAllUsableBeatmapSetsEnumerable(IncludedDetails.All).First();
             });
 
-            AddUntilStep("play started", () => !multiplayerScreen.IsCurrentScreen());
+            AddUntilStep("play started", () => multiplayerScreenStack.CurrentScreen is SpectatorScreen);
         }
 
         [Test]
@@ -529,16 +511,16 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             AddStep("open mod overlay", () => this.ChildrenOfType<RoomSubScreen.UserModSelectButton>().Single().TriggerClick());
 
-            AddStep("invoke on back button", () => multiplayerScreen.OnBackButton());
+            AddStep("invoke on back button", () => multiplayerScreenStack.OnBackButton());
 
             AddAssert("mod overlay is hidden", () => this.ChildrenOfType<UserModSelectOverlay>().Single().State.Value == Visibility.Hidden);
 
             AddAssert("dialog overlay is hidden", () => DialogOverlay.State.Value == Visibility.Hidden);
 
-            testLeave("back button", () => multiplayerScreen.OnBackButton());
+            testLeave("back button", () => multiplayerScreenStack.OnBackButton());
 
             // mimics home button and OS window close
-            testLeave("forced exit", () => multiplayerScreen.Exit());
+            testLeave("forced exit", () => multiplayerScreenStack.Exit());
 
             void testLeave(string actionName, Action action)
             {
@@ -579,7 +561,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             AddStep("click start button", () => InputManager.Click(MouseButton.Left));
 
-            AddUntilStep("wait for player", () => Stack.CurrentScreen is Player);
+            AddUntilStep("wait for player", () => multiplayerScreenStack.CurrentScreen is Player);
 
             // Gameplay runs in real-time, so we need to incrementally check if gameplay has finished in order to not time out.
             for (double i = 1000; i < TestResources.QUICK_BEATMAP_LENGTH; i += 1000)
@@ -588,15 +570,15 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 AddUntilStep($"wait for time > {i}", () => this.ChildrenOfType<GameplayClockContainer>().SingleOrDefault()?.GameplayClock.CurrentTime > time);
             }
 
-            AddUntilStep("wait for results", () => Stack.CurrentScreen is ResultsScreen);
+            AddUntilStep("wait for results", () => multiplayerScreenStack.CurrentScreen is ResultsScreen);
         }
 
         private MultiplayerReadyButton readyButton => this.ChildrenOfType<MultiplayerReadyButton>().Single();
 
         private void createRoom(Func<Room> room)
         {
-            AddUntilStep("wait for lounge", () => multiplayerScreen.ChildrenOfType<LoungeSubScreen>().SingleOrDefault()?.IsLoaded == true);
-            AddStep("open room", () => multiplayerScreen.ChildrenOfType<LoungeSubScreen>().Single().Open(room()));
+            AddUntilStep("wait for lounge", () => multiplayerScreenStack.ChildrenOfType<LoungeSubScreen>().SingleOrDefault()?.IsLoaded == true);
+            AddStep("open room", () => multiplayerScreenStack.ChildrenOfType<LoungeSubScreen>().Single().Open(room()));
 
             AddUntilStep("wait for room open", () => this.ChildrenOfType<MultiplayerMatchSubScreen>().FirstOrDefault()?.IsLoaded == true);
             AddWaitStep("wait for transition", 2);
@@ -609,35 +591,5 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             AddUntilStep("wait for join", () => client.Room != null);
         }
-
-        /// <summary>
-        /// Used for the sole purpose of adding <see cref="TestMultiplayerClient"/> as a resolvable dependency.
-        /// </summary>
-        private class DependenciesScreen : OsuScreen
-        {
-            [Cached(typeof(MultiplayerClient))]
-            public readonly TestMultiplayerClient Client;
-
-            [Cached]
-            public readonly TestRoomRequestsHandler RequestsHandler = new TestRoomRequestsHandler();
-
-            public DependenciesScreen(TestMultiplayerClient client)
-            {
-                Client = client;
-            }
-
-            [BackgroundDependencyLoader]
-            private void load(IAPIProvider api, OsuGameBase game)
-            {
-                ((DummyAPIAccess)api).HandleRequest = request => RequestsHandler.HandleRequest(request, api.LocalUser.Value, game);
-            }
-        }
-
-        private class TestMultiplayer : Screens.OnlinePlay.Multiplayer.Multiplayer
-        {
-            public new TestMultiplayerRoomManager RoomManager { get; private set; }
-
-            protected override RoomManager CreateRoomManager() => RoomManager = new TestMultiplayerRoomManager();
-        }
     }
 }
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs
index 9bb19d4286..ad92886bab 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs
@@ -6,25 +6,19 @@ using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
-using osu.Framework.Graphics;
 using osu.Framework.Platform;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
 using osu.Game.Database;
-using osu.Game.Online.API;
-using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Multiplayer.MatchTypes.TeamVersus;
 using osu.Game.Online.Rooms;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Osu;
-using osu.Game.Screens;
-using osu.Game.Screens.OnlinePlay.Components;
 using osu.Game.Screens.OnlinePlay.Lounge;
 using osu.Game.Screens.OnlinePlay.Multiplayer;
 using osu.Game.Screens.OnlinePlay.Multiplayer.Match;
 using osu.Game.Screens.OnlinePlay.Multiplayer.Participants;
 using osu.Game.Tests.Resources;
-using osu.Game.Tests.Visual.OnlinePlay;
 using osuTK.Input;
 
 namespace osu.Game.Tests.Visual.Multiplayer
@@ -35,9 +29,9 @@ namespace osu.Game.Tests.Visual.Multiplayer
         private RulesetStore rulesets;
         private BeatmapSetInfo importedSet;
 
-        private DependenciesScreen dependenciesScreen;
-        private TestMultiplayer multiplayerScreen;
-        private TestMultiplayerClient client;
+        private TestMultiplayerScreenStack multiplayerScreenStack;
+
+        private TestMultiplayerClient client => multiplayerScreenStack.Client;
 
         [Cached(typeof(UserLookupCache))]
         private UserLookupCache lookupCache = new TestUserLookupCache();
@@ -59,24 +53,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 importedSet = beatmaps.GetAllUsableBeatmapSetsEnumerable(IncludedDetails.All).First();
             });
 
-            AddStep("create multiplayer screen", () => multiplayerScreen = new TestMultiplayer());
-
-            AddStep("load dependencies", () =>
-            {
-                client = new TestMultiplayerClient(multiplayerScreen.RoomManager);
-
-                // The screen gets suspended so it stops receiving updates.
-                Child = client;
-
-                LoadScreen(dependenciesScreen = new DependenciesScreen(client));
-            });
-
-            AddUntilStep("wait for dependencies screen", () => Stack.CurrentScreen is DependenciesScreen);
-            AddUntilStep("wait for dependencies to start load", () => dependenciesScreen.LoadState > LoadState.NotLoaded);
-            AddUntilStep("wait for dependencies to load", () => dependenciesScreen.IsLoaded);
-
-            AddStep("load multiplayer", () => LoadScreen(multiplayerScreen));
-            AddUntilStep("wait for multiplayer to load", () => multiplayerScreen.IsLoaded);
+            AddStep("load multiplayer", () => LoadScreen(multiplayerScreenStack = new TestMultiplayerScreenStack()));
+            AddUntilStep("wait for multiplayer to load", () => multiplayerScreenStack.IsLoaded);
             AddUntilStep("wait for lounge to load", () => this.ChildrenOfType<MultiplayerLoungeSubScreen>().FirstOrDefault()?.IsLoaded == true);
         }
 
@@ -122,7 +100,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             AddStep("press button", () =>
             {
-                InputManager.MoveMouseTo(multiplayerScreen.ChildrenOfType<TeamDisplay>().First());
+                InputManager.MoveMouseTo(multiplayerScreenStack.ChildrenOfType<TeamDisplay>().First());
                 InputManager.Click(MouseButton.Left);
             });
             AddAssert("user on team 1", () => (client.Room?.Users.FirstOrDefault()?.MatchState as TeamVersusUserState)?.TeamID == 1);
@@ -156,7 +134,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
         private void createRoom(Func<Room> room)
         {
-            AddStep("open room", () => multiplayerScreen.ChildrenOfType<LoungeSubScreen>().Single().Open(room()));
+            AddStep("open room", () => multiplayerScreenStack.ChildrenOfType<LoungeSubScreen>().Single().Open(room()));
 
             AddUntilStep("wait for room open", () => this.ChildrenOfType<MultiplayerMatchSubScreen>().FirstOrDefault()?.IsLoaded == true);
             AddWaitStep("wait for transition", 2);
@@ -169,35 +147,5 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             AddUntilStep("wait for join", () => client.Room != null);
         }
-
-        /// <summary>
-        /// Used for the sole purpose of adding <see cref="TestMultiplayerClient"/> as a resolvable dependency.
-        /// </summary>
-        private class DependenciesScreen : OsuScreen
-        {
-            [Cached(typeof(MultiplayerClient))]
-            public readonly TestMultiplayerClient Client;
-
-            [Cached]
-            public readonly TestRoomRequestsHandler RequestsHandler = new TestRoomRequestsHandler();
-
-            public DependenciesScreen(TestMultiplayerClient client)
-            {
-                Client = client;
-            }
-
-            [BackgroundDependencyLoader]
-            private void load(IAPIProvider api, OsuGameBase game)
-            {
-                ((DummyAPIAccess)api).HandleRequest = request => RequestsHandler.HandleRequest(request, api.LocalUser.Value, game);
-            }
-        }
-
-        private class TestMultiplayer : Screens.OnlinePlay.Multiplayer.Multiplayer
-        {
-            public new TestMultiplayerRoomManager RoomManager { get; private set; }
-
-            protected override RoomManager CreateRoomManager() => RoomManager = new TestMultiplayerRoomManager();
-        }
     }
 }
diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs b/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
index 1df0680b69..5d4594c415 100644
--- a/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
@@ -9,23 +9,18 @@ using osu.Framework.Screens;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
 using osu.Game.Graphics.UserInterface;
-using osu.Game.Online.API;
-using osu.Game.Online.Multiplayer;
 using osu.Game.Overlays;
 using osu.Game.Overlays.Mods;
 using osu.Game.Overlays.Toolbar;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Osu.Mods;
 using osu.Game.Screens.Menu;
-using osu.Game.Screens.OnlinePlay.Components;
 using osu.Game.Screens.OnlinePlay.Lounge;
 using osu.Game.Screens.Play;
 using osu.Game.Screens.Ranking;
 using osu.Game.Screens.Select;
 using osu.Game.Screens.Select.Options;
 using osu.Game.Tests.Beatmaps.IO;
-using osu.Game.Tests.Visual.Multiplayer;
-using osu.Game.Tests.Visual.OnlinePlay;
 using osuTK;
 using osuTK.Input;
 
@@ -335,12 +330,12 @@ namespace osu.Game.Tests.Visual.Navigation
         [Test]
         public void TestPushMatchSubScreenAndPressBackButtonImmediately()
         {
-            TestMultiplayer multiplayer = null;
+            TestMultiplayerScreenStack multiplayerScreenStack = null;
 
-            PushAndConfirm(() => multiplayer = new TestMultiplayer());
+            PushAndConfirm(() => multiplayerScreenStack = new TestMultiplayerScreenStack());
 
-            AddUntilStep("wait for lounge", () => multiplayer.ChildrenOfType<LoungeSubScreen>().SingleOrDefault()?.IsLoaded == true);
-            AddStep("open room", () => multiplayer.ChildrenOfType<LoungeSubScreen>().Single().Open());
+            AddUntilStep("wait for lounge", () => multiplayerScreenStack.ChildrenOfType<LoungeSubScreen>().SingleOrDefault()?.IsLoaded == true);
+            AddStep("open room", () => multiplayerScreenStack.ChildrenOfType<LoungeSubScreen>().Single().Open());
             AddStep("press back button", () => Game.ChildrenOfType<BackButton>().First().Action());
             AddWaitStep("wait two frames", 2);
         }
@@ -455,28 +450,5 @@ namespace osu.Game.Tests.Visual.Navigation
 
             protected override bool DisplayStableImportPrompt => false;
         }
-
-        private class TestMultiplayer : Screens.OnlinePlay.Multiplayer.Multiplayer
-        {
-            [Cached(typeof(MultiplayerClient))]
-            public readonly TestMultiplayerClient Client;
-
-            [Cached]
-            public readonly TestRoomRequestsHandler RequestsHandler;
-
-            public TestMultiplayer()
-            {
-                Client = new TestMultiplayerClient((TestMultiplayerRoomManager)RoomManager);
-                RequestsHandler = new TestRoomRequestsHandler();
-            }
-
-            [BackgroundDependencyLoader]
-            private void load(IAPIProvider api, OsuGameBase game)
-            {
-                ((DummyAPIAccess)api).HandleRequest = request => RequestsHandler.HandleRequest(request, api.LocalUser.Value, game);
-            }
-
-            protected override RoomManager CreateRoomManager() => new TestMultiplayerRoomManager();
-        }
     }
 }
diff --git a/osu.Game.Tests/Visual/TestMultiplayerScreenStack.cs b/osu.Game.Tests/Visual/TestMultiplayerScreenStack.cs
new file mode 100644
index 0000000000..6b3657df44
--- /dev/null
+++ b/osu.Game.Tests/Visual/TestMultiplayerScreenStack.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 System.Threading;
+using osu.Framework.Allocation;
+using osu.Framework.Graphics;
+using osu.Framework.Screens;
+using osu.Game.Online.API;
+using osu.Game.Online.Multiplayer;
+using osu.Game.Screens;
+using osu.Game.Screens.OnlinePlay.Components;
+using osu.Game.Tests.Visual.Multiplayer;
+using osu.Game.Tests.Visual.OnlinePlay;
+
+namespace osu.Game.Tests.Visual
+{
+    /// <summary>
+    /// An <see cref="OsuScreen"/> loadable into <see cref="ScreenTestScene"/>s via <see cref="ScreenTestScene.LoadScreen"/>,
+    /// which provides dependencies for and loads an isolated <see cref="Screens.OnlinePlay.Multiplayer.Multiplayer"/> screen.
+    /// <p>
+    /// This screen:
+    /// <list type="bullet">
+    /// <item>Provides a <see cref="TestMultiplayerClient"/> to be resolved as a dependency in the <see cref="Screens.OnlinePlay.Multiplayer.Multiplayer"/> screen,
+    /// which is typically a part of <see cref="OsuGameBase"/>.</item>
+    /// <item>Rebinds the <see cref="DummyAPIAccess"/> to handle requests via a <see cref="TestRoomRequestsHandler"/>.</item>
+    /// <item>Provides a <see cref="TestMultiplayerRoomManager"/> for the <see cref="Screens.OnlinePlay.Multiplayer.Multiplayer"/> screen.</item>
+    /// </list>
+    /// </p>
+    /// </summary>
+    public class TestMultiplayerScreenStack : OsuScreen
+    {
+        public Screens.OnlinePlay.Multiplayer.Multiplayer MultiplayerScreen => multiplayerScreen;
+
+        public TestMultiplayerRoomManager RoomManager => multiplayerScreen.RoomManager;
+
+        public IScreen CurrentScreen => screenStack.CurrentScreen;
+
+        public new bool IsLoaded => base.IsLoaded && MultiplayerScreen.IsLoaded;
+
+        [Cached(typeof(MultiplayerClient))]
+        public readonly TestMultiplayerClient Client;
+
+        private readonly OsuScreenStack screenStack;
+        private readonly TestMultiplayer multiplayerScreen;
+
+        public TestMultiplayerScreenStack()
+        {
+            multiplayerScreen = new TestMultiplayer();
+
+            InternalChildren = new Drawable[]
+            {
+                Client = new TestMultiplayerClient(RoomManager),
+                screenStack = new OsuScreenStack { RelativeSizeAxes = Axes.Both }
+            };
+
+            screenStack.Push(multiplayerScreen);
+        }
+
+        [BackgroundDependencyLoader]
+        private void load(IAPIProvider api, OsuGameBase game)
+        {
+            ((DummyAPIAccess)api).HandleRequest = request => multiplayerScreen.RequestsHandler.HandleRequest(request, api.LocalUser.Value, game);
+        }
+
+        public override bool OnBackButton() => multiplayerScreen.OnBackButton();
+
+        public override bool OnExiting(IScreen next)
+        {
+            if (screenStack.CurrentScreen == null)
+                return base.OnExiting(next);
+
+            screenStack.Exit();
+            return true;
+        }
+
+        private class TestMultiplayer : Screens.OnlinePlay.Multiplayer.Multiplayer
+        {
+            public new TestMultiplayerRoomManager RoomManager { get; private set; }
+            public TestRoomRequestsHandler RequestsHandler { get; private set; }
+
+            protected override RoomManager CreateRoomManager() => RoomManager = new TestMultiplayerRoomManager(RequestsHandler = new TestRoomRequestsHandler());
+        }
+    }
+}
diff --git a/osu.Game/Tests/Visual/Multiplayer/MultiplayerTestSceneDependencies.cs b/osu.Game/Tests/Visual/Multiplayer/MultiplayerTestSceneDependencies.cs
index a2b0b066a7..ed349a7103 100644
--- a/osu.Game/Tests/Visual/Multiplayer/MultiplayerTestSceneDependencies.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/MultiplayerTestSceneDependencies.cs
@@ -31,7 +31,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             CacheAs<SpectatorClient>(SpectatorClient);
         }
 
-        protected override IRoomManager CreateRoomManager() => new TestMultiplayerRoomManager();
+        protected override IRoomManager CreateRoomManager() => new TestMultiplayerRoomManager(RequestsHandler);
 
         protected virtual TestSpectatorClient CreateSpectatorClient() => new TestSpectatorClient();
     }
diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerRoomManager.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerRoomManager.cs
index fef2a0a16d..4129d190be 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerRoomManager.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerRoomManager.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.Game.Online.Rooms;
 using osu.Game.Screens.OnlinePlay.Components;
 using osu.Game.Screens.OnlinePlay.Multiplayer;
@@ -16,8 +15,12 @@ namespace osu.Game.Tests.Visual.Multiplayer
     /// </summary>
     public class TestMultiplayerRoomManager : MultiplayerRoomManager
     {
-        [Resolved]
-        private TestRoomRequestsHandler requestsHandler { get; set; }
+        private readonly TestRoomRequestsHandler requestsHandler;
+
+        public TestMultiplayerRoomManager(TestRoomRequestsHandler requestsHandler)
+        {
+            this.requestsHandler = requestsHandler;
+        }
 
         public IReadOnlyList<Room> ServerSideRooms => requestsHandler.ServerSideRooms;
 
diff --git a/osu.Game/Tests/Visual/OnlinePlay/OnlinePlayTestSceneDependencies.cs b/osu.Game/Tests/Visual/OnlinePlay/OnlinePlayTestSceneDependencies.cs
index 9e5264fb12..24c4ff79d4 100644
--- a/osu.Game/Tests/Visual/OnlinePlay/OnlinePlayTestSceneDependencies.cs
+++ b/osu.Game/Tests/Visual/OnlinePlay/OnlinePlayTestSceneDependencies.cs
@@ -34,10 +34,10 @@ namespace osu.Game.Tests.Visual.OnlinePlay
         public OnlinePlayTestSceneDependencies()
         {
             SelectedRoom = new Bindable<Room>();
-            RoomManager = CreateRoomManager();
+            RequestsHandler = new TestRoomRequestsHandler();
             OngoingOperationTracker = new OngoingOperationTracker();
             AvailabilityTracker = new OnlinePlayBeatmapAvailabilityTracker();
-            RequestsHandler = new TestRoomRequestsHandler();
+            RoomManager = CreateRoomManager();
 
             dependencies = new DependencyContainer(new CachedModelDependencyContainer<Room>(null) { Model = { BindTarget = SelectedRoom } });
 

From 8bc414e7254781de0271389be14e73e19497f0fc Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Thu, 28 Oct 2021 14:34:27 +0900
Subject: [PATCH 0538/5547] Upgrade nvika to 1.0.3

---
 .config/dotnet-tools.json | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.config/dotnet-tools.json b/.config/dotnet-tools.json
index 007e4341b8..1b06aa4d17 100644
--- a/.config/dotnet-tools.json
+++ b/.config/dotnet-tools.json
@@ -15,7 +15,7 @@
       ]
     },
     "smoogipoo.nvika": {
-      "version": "1.0.1",
+      "version": "1.0.3",
       "commands": [
         "nvika"
       ]
@@ -33,4 +33,4 @@
       ]
     }
   }
-}
+}
\ No newline at end of file

From f3d208fecf32d42cb78d77417cc1123916a8d21b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 28 Oct 2021 14:48:36 +0900
Subject: [PATCH 0539/5547] Remove TODO (tested to work correctly)

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

diff --git a/osu.Game.Tournament/Components/SongBar.cs b/osu.Game.Tournament/Components/SongBar.cs
index 9af73a2abb..a74b88c592 100644
--- a/osu.Game.Tournament/Components/SongBar.cs
+++ b/osu.Game.Tournament/Components/SongBar.cs
@@ -101,7 +101,7 @@ namespace osu.Game.Tournament.Components
                 return;
             }
 
-            double bpm = beatmap.BPM; // TODO: check this works.
+            double bpm = beatmap.BPM;
             double length = beatmap.Length;
             string hardRockExtra = "";
             string srExtra = "";

From ef26b0ba8aba42209ddbae7c2de2ef8cd6f2334e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 28 Oct 2021 15:00:30 +0900
Subject: [PATCH 0540/5547] Fix serlialisation failure during ladder saving
 causing all existing file content to be deleted

---
 osu.Game.Tournament/TournamentGameBase.cs | 18 ++++++++++--------
 1 file changed, 10 insertions(+), 8 deletions(-)

diff --git a/osu.Game.Tournament/TournamentGameBase.cs b/osu.Game.Tournament/TournamentGameBase.cs
index 978be720df..22cc07ad8d 100644
--- a/osu.Game.Tournament/TournamentGameBase.cs
+++ b/osu.Game.Tournament/TournamentGameBase.cs
@@ -269,17 +269,19 @@ namespace osu.Game.Tournament
                                             ladder.Matches.Where(p => p.LosersProgression.Value != null).Select(p => new TournamentProgression(p.ID, p.LosersProgression.Value.ID, true)))
                                         .ToList();
 
+            string serialisedLadder = JsonConvert.SerializeObject(ladder,
+                new JsonSerializerSettings
+                {
+                    Formatting = Formatting.Indented,
+                    NullValueHandling = NullValueHandling.Ignore,
+                    DefaultValueHandling = DefaultValueHandling.Ignore,
+                    Converters = new JsonConverter[] { new JsonPointConverter() }
+                });
+
             using (var stream = storage.GetStream(bracket_filename, FileAccess.Write, FileMode.Create))
             using (var sw = new StreamWriter(stream))
             {
-                sw.Write(JsonConvert.SerializeObject(ladder,
-                    new JsonSerializerSettings
-                    {
-                        Formatting = Formatting.Indented,
-                        NullValueHandling = NullValueHandling.Ignore,
-                        DefaultValueHandling = DefaultValueHandling.Ignore,
-                        Converters = new JsonConverter[] { new JsonPointConverter() }
-                    }));
+                sw.Write(serialisedLadder);
             }
         }
 

From a6669a3892744152b7c4628303325263e45499e1 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 28 Oct 2021 15:04:09 +0900
Subject: [PATCH 0541/5547] Add mention of why the serialisation happens
 outside stream usage

---
 osu.Game.Tournament/TournamentGameBase.cs | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/osu.Game.Tournament/TournamentGameBase.cs b/osu.Game.Tournament/TournamentGameBase.cs
index 22cc07ad8d..0e8646d15c 100644
--- a/osu.Game.Tournament/TournamentGameBase.cs
+++ b/osu.Game.Tournament/TournamentGameBase.cs
@@ -269,6 +269,7 @@ namespace osu.Game.Tournament
                                             ladder.Matches.Where(p => p.LosersProgression.Value != null).Select(p => new TournamentProgression(p.ID, p.LosersProgression.Value.ID, true)))
                                         .ToList();
 
+            // Serialise before opening stream for writing, so if there's a failure it will leave the file in the previous state.
             string serialisedLadder = JsonConvert.SerializeObject(ladder,
                 new JsonSerializerSettings
                 {
@@ -280,9 +281,7 @@ namespace osu.Game.Tournament
 
             using (var stream = storage.GetStream(bracket_filename, FileAccess.Write, FileMode.Create))
             using (var sw = new StreamWriter(stream))
-            {
                 sw.Write(serialisedLadder);
-            }
         }
 
         protected override UserInputManager CreateUserInputManager() => new TournamentInputManager();

From 56e3a42abebff9d036810f08d71025de2547edf1 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 28 Oct 2021 15:14:29 +0900
Subject: [PATCH 0542/5547] Remove unused using statement

---
 osu.Game.Tests/Visual/TestMultiplayerScreenStack.cs | 1 -
 1 file changed, 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/TestMultiplayerScreenStack.cs b/osu.Game.Tests/Visual/TestMultiplayerScreenStack.cs
index 6b3657df44..7f1171db1f 100644
--- a/osu.Game.Tests/Visual/TestMultiplayerScreenStack.cs
+++ b/osu.Game.Tests/Visual/TestMultiplayerScreenStack.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.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Screens;

From 313f78cbfbe1638dfd2827560c584282850e9e8f Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Thu, 28 Oct 2021 15:24:44 +0900
Subject: [PATCH 0543/5547] Fix non-null inspection

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

diff --git a/osu.Game.Tournament/Components/TournamentBeatmapPanel.cs b/osu.Game.Tournament/Components/TournamentBeatmapPanel.cs
index 328b9278d5..b81a45c1d7 100644
--- a/osu.Game.Tournament/Components/TournamentBeatmapPanel.cs
+++ b/osu.Game.Tournament/Components/TournamentBeatmapPanel.cs
@@ -93,7 +93,7 @@ namespace osu.Game.Tournament.Components
                                 },
                                 new TournamentSpriteText
                                 {
-                                    Text = Beatmap.Metadata?.Author,
+                                    Text = Beatmap.Metadata.Author,
                                     Padding = new MarginPadding { Right = 20 },
                                     Font = OsuFont.Torus.With(weight: FontWeight.Bold, size: 14)
                                 },

From b0b27a47d5ba5bd2240cb0ff0175ebce04f00cec Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Thu, 28 Oct 2021 15:28:16 +0900
Subject: [PATCH 0544/5547] Rename test scene

---
 ...enePlaylistCreation.cs => TestScenePlaylistsRoomCreation.cs} | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
 rename osu.Game.Tests/Visual/Playlists/{TestScenePlaylistCreation.cs => TestScenePlaylistsRoomCreation.cs} (98%)

diff --git a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistCreation.cs b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs
similarity index 98%
rename from osu.Game.Tests/Visual/Playlists/TestScenePlaylistCreation.cs
rename to osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs
index c4e6f41f27..1f43d254b6 100644
--- a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistCreation.cs
+++ b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs
@@ -22,7 +22,7 @@ using osuTK.Input;
 
 namespace osu.Game.Tests.Visual.Playlists
 {
-    public class TestScenePlaylistCreation : OnlinePlayTestScene
+    public class TestScenePlaylistsRoomCreation : OnlinePlayTestScene
     {
         private BeatmapManager manager;
         private RulesetStore rulesets;

From e2c08fb2e5443e40667253bbe7aee6db93ca4153 Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Thu, 28 Oct 2021 15:41:59 +0900
Subject: [PATCH 0545/5547] Create room by clicking button

---
 .../TestScenePlaylistsRoomCreation.cs         | 19 +++++--------------
 1 file changed, 5 insertions(+), 14 deletions(-)

diff --git a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs
index 1f43d254b6..21ab5c761c 100644
--- a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs
+++ b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs
@@ -54,7 +54,6 @@ namespace osu.Game.Tests.Visual.Playlists
         {
             setupAndCreateRoom(room =>
             {
-                room.RoomID.Value = 1; // forces room creation.
                 room.Name.Value = "my awesome room";
                 room.Host.Value = API.LocalUser.Value;
                 room.RecentParticipants.Add(room.Host.Value);
@@ -84,13 +83,6 @@ namespace osu.Game.Tests.Visual.Playlists
                 });
             });
 
-            AddStep("move mouse to create button", () =>
-            {
-                InputManager.MoveMouseTo(this.ChildrenOfType<PlaylistsRoomSettingsOverlay.CreateRoomButton>().Single());
-            });
-
-            AddStep("click", () => InputManager.Click(MouseButton.Left));
-
             AddAssert("first playlist item selected", () => match.SelectedItem.Value == SelectedRoom.Value.Playlist[0]);
         }
 
@@ -143,13 +135,12 @@ namespace osu.Game.Tests.Visual.Playlists
 
         private void setupAndCreateRoom(Action<Room> room)
         {
-            AddStep("setup room", () =>
-            {
-                room(SelectedRoom.Value);
+            AddStep("setup room", () => room(SelectedRoom.Value));
 
-                // if this isn't done the test will crash when a poll kicks in.
-                // probably not correct, but works for now.
-                OnlinePlayDependencies.RoomManager.CreateRoom(SelectedRoom.Value);
+            AddStep("click create button", () =>
+            {
+                InputManager.MoveMouseTo(this.ChildrenOfType<PlaylistsRoomSettingsOverlay.CreateRoomButton>().Single());
+                InputManager.Click(MouseButton.Left);
             });
         }
 

From dce19cf7e47bfaa66619523a8ed9e871c0fe49f8 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 28 Oct 2021 15:42:06 +0900
Subject: [PATCH 0546/5547] Add visual test for `SettingsNumberBox` usage in
 settings source context

---
 osu.Game.Tests/Visual/Settings/TestSceneSettingsSource.cs | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/osu.Game.Tests/Visual/Settings/TestSceneSettingsSource.cs b/osu.Game.Tests/Visual/Settings/TestSceneSettingsSource.cs
index d530e1f796..fc81d9792e 100644
--- a/osu.Game.Tests/Visual/Settings/TestSceneSettingsSource.cs
+++ b/osu.Game.Tests/Visual/Settings/TestSceneSettingsSource.cs
@@ -6,6 +6,7 @@ using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Configuration;
+using osu.Game.Overlays.Settings;
 using osuTK;
 
 namespace osu.Game.Tests.Visual.Settings
@@ -58,6 +59,13 @@ namespace osu.Game.Tests.Visual.Settings
                 Default = string.Empty,
                 Value = "Sample text"
             };
+
+            [SettingSource("Sample number textbox", "Textbox number entry", SettingControlType = typeof(SettingsNumberBox))]
+            public Bindable<int?> IntTextboxBindable { get; } = new Bindable<int?>
+            {
+                Default = null,
+                Value = null
+            };
         }
 
         private enum TestEnum

From 1e1f8c472adc57f9612b41d8cdcba47b55e2efa6 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 28 Oct 2021 16:34:12 +0900
Subject: [PATCH 0547/5547] Add icons to various progress notification states

---
 .../TestSceneNotificationOverlay.cs           | 40 +++++++++++++-
 .../Notifications/ProgressNotification.cs     | 54 +++++++++++++++++--
 2 files changed, 88 insertions(+), 6 deletions(-)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneNotificationOverlay.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneNotificationOverlay.cs
index d0f6f3fe47..a2aa0499d2 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneNotificationOverlay.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneNotificationOverlay.cs
@@ -41,6 +41,44 @@ namespace osu.Game.Tests.Visual.UserInterface
             notificationOverlay.UnreadCount.ValueChanged += count => { displayedCount.Text = $"displayed count: {count.NewValue}"; };
         });
 
+        [Test]
+        public void TestCompleteProgress()
+        {
+            ProgressNotification notification = null;
+            AddStep("add progress notification", () =>
+            {
+                notification = new ProgressNotification
+                {
+                    Text = @"Uploading to BSS...",
+                    CompletionText = "Uploaded to BSS!",
+                };
+                notificationOverlay.Post(notification);
+                progressingNotifications.Add(notification);
+            });
+
+            AddUntilStep("wait completion", () => notification.State == ProgressNotificationState.Completed);
+        }
+
+        [Test]
+        public void TestCancelProgress()
+        {
+            ProgressNotification notification = null;
+            AddStep("add progress notification", () =>
+            {
+                notification = new ProgressNotification
+                {
+                    Text = @"Uploading to BSS...",
+                    CompletionText = "Uploaded to BSS!",
+                };
+                notificationOverlay.Post(notification);
+                progressingNotifications.Add(notification);
+            });
+
+            AddWaitStep("wait 3", 3);
+
+            AddStep("cancel notification", () => notification.State = ProgressNotificationState.Cancelled);
+        }
+
         [Test]
         public void TestBasicFlow()
         {
@@ -138,7 +176,7 @@ namespace osu.Game.Tests.Visual.UserInterface
             foreach (var n in progressingNotifications.FindAll(n => n.State == ProgressNotificationState.Active))
             {
                 if (n.Progress < 1)
-                    n.Progress += (float)(Time.Elapsed / 400) * RNG.NextSingle();
+                    n.Progress += (float)(Time.Elapsed / 2000);
                 else
                     n.State = ProgressNotificationState.Completed;
             }
diff --git a/osu.Game/Overlays/Notifications/ProgressNotification.cs b/osu.Game/Overlays/Notifications/ProgressNotification.cs
index f8cd31f193..b27e15dd2c 100644
--- a/osu.Game/Overlays/Notifications/ProgressNotification.cs
+++ b/osu.Game/Overlays/Notifications/ProgressNotification.cs
@@ -4,11 +4,15 @@
 using System;
 using System.Threading;
 using osu.Framework.Allocation;
+using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
+using osu.Framework.Graphics.Colour;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
+using osu.Framework.Graphics.Sprites;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
+using osu.Game.Graphics.UserInterface;
 using osuTK;
 using osuTK.Graphics;
 
@@ -16,6 +20,8 @@ namespace osu.Game.Overlays.Notifications
 {
     public class ProgressNotification : Notification, IHasCompletionTarget
     {
+        private const float loading_spinner_size = 22;
+
         public string Text
         {
             set => Schedule(() => textDrawable.Text = value);
@@ -65,29 +71,53 @@ namespace osu.Game.Overlays.Notifications
 
         private void updateState()
         {
+            const double colour_fade_duration = 200;
+
             switch (state)
             {
                 case ProgressNotificationState.Queued:
                     Light.Colour = colourQueued;
                     Light.Pulsate = false;
                     progressBar.Active = false;
+
+                    iconBackground.FadeColour(ColourInfo.GradientVertical(colourQueued, colourQueued.Lighten(0.5f)), colour_fade_duration);
+                    loadingSpinner.Show();
                     break;
 
                 case ProgressNotificationState.Active:
                     Light.Colour = colourActive;
                     Light.Pulsate = true;
                     progressBar.Active = true;
+
+                    iconBackground.FadeColour(ColourInfo.GradientVertical(colourActive, colourActive.Lighten(0.5f)), colour_fade_duration);
+                    loadingSpinner.Show();
                     break;
 
                 case ProgressNotificationState.Cancelled:
                     cancellationTokenSource.Cancel();
 
+                    iconBackground.FadeColour(ColourInfo.GradientVertical(Color4.Gray, Color4.Gray.Lighten(0.5f)), colour_fade_duration);
+                    loadingSpinner.Hide();
+
+                    var icon = new SpriteIcon
+                    {
+                        Icon = FontAwesome.Solid.Ban,
+                        Anchor = Anchor.Centre,
+                        Origin = Anchor.Centre,
+                        Size = new Vector2(loading_spinner_size),
+                    };
+
+                    IconContent.Add(icon);
+
+                    icon.FadeInFromZero(200, Easing.OutQuint);
+
                     Light.Colour = colourCancelled;
                     Light.Pulsate = false;
                     progressBar.Active = false;
                     break;
 
                 case ProgressNotificationState.Completed:
+                    loadingSpinner.Hide();
                     NotificationContent.MoveToY(-DrawSize.Y / 2, 200, Easing.OutQuint);
                     this.FadeOut(200).Finally(d => Completed());
                     break;
@@ -115,15 +145,13 @@ namespace osu.Game.Overlays.Notifications
         private Color4 colourActive;
         private Color4 colourCancelled;
 
+        private Box iconBackground;
+        private LoadingSpinner loadingSpinner;
+
         private readonly TextFlowContainer textDrawable;
 
         public ProgressNotification()
         {
-            IconContent.Add(new Box
-            {
-                RelativeSizeAxes = Axes.Both,
-            });
-
             Content.Add(textDrawable = new OsuTextFlowContainer
             {
                 Colour = OsuColour.Gray(128),
@@ -138,6 +166,9 @@ namespace osu.Game.Overlays.Notifications
                 RelativeSizeAxes = Axes.X,
             });
 
+            // make some extra space for the progress bar.
+            IconContent.Margin = new MarginPadding { Bottom = 5 };
+
             State = ProgressNotificationState.Queued;
 
             // don't close on click by default.
@@ -150,6 +181,19 @@ namespace osu.Game.Overlays.Notifications
             colourQueued = colours.YellowDark;
             colourActive = colours.Blue;
             colourCancelled = colours.Red;
+
+            IconContent.AddRange(new Drawable[]
+            {
+                iconBackground = new Box
+                {
+                    RelativeSizeAxes = Axes.Both,
+                    Colour = Color4.White,
+                },
+                loadingSpinner = new LoadingSpinner
+                {
+                    Size = new Vector2(loading_spinner_size),
+                }
+            });
         }
 
         public override void Close()

From bacaa9d20152c77c978abf1e593165e1ade84120 Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Thu, 28 Oct 2021 16:48:17 +0900
Subject: [PATCH 0548/5547] Fix playlists test crash

---
 osu.Game/Tests/Visual/OnlinePlay/OnlinePlayTestScene.cs | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Tests/Visual/OnlinePlay/OnlinePlayTestScene.cs b/osu.Game/Tests/Visual/OnlinePlay/OnlinePlayTestScene.cs
index 4771ace1c4..430aae72f8 100644
--- a/osu.Game/Tests/Visual/OnlinePlay/OnlinePlayTestScene.cs
+++ b/osu.Game/Tests/Visual/OnlinePlay/OnlinePlayTestScene.cs
@@ -64,7 +64,12 @@ namespace osu.Game.Tests.Visual.OnlinePlay
         public override void SetUpSteps()
         {
             base.SetUpSteps();
-            AddStep("setup API", () => ((DummyAPIAccess)API).HandleRequest = request => OnlinePlayDependencies.RequestsHandler.HandleRequest(request, API.LocalUser.Value, game));
+
+            AddStep("setup API", () =>
+            {
+                var handler = OnlinePlayDependencies.RequestsHandler;
+                ((DummyAPIAccess)API).HandleRequest = request => handler.HandleRequest(request, API.LocalUser.Value, game);
+            });
         }
 
         /// <summary>

From b096bf6cd1c8857964e7c884c88665646ea0441f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 28 Oct 2021 16:56:29 +0900
Subject: [PATCH 0549/5547] Ensure all test beatmaps have unique OnlineIDs to
 avoid import conflicts

The order of operation of imports means that the already-imported
instances are considered most correct (they have usually been populated
using an online source, although that is skipped in tests), so on two
consecutive test imports in a test scene, the second will lose its
online IDs completely.

This aims to ensure that all test beatmaps will have online IDs, which
is the general expected behaviour.
---
 .../Visual/Playlists/TestScenePlaylistsRoomCreation.cs      | 5 +----
 osu.Game/Tests/Beatmaps/TestBeatmap.cs                      | 6 ++++++
 2 files changed, 7 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs
index 21ab5c761c..e9825f25d5 100644
--- a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs
+++ b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs
@@ -144,10 +144,7 @@ namespace osu.Game.Tests.Visual.Playlists
             });
         }
 
-        private void importBeatmap()
-        {
-            AddStep("import beatmap", () => importedBeatmap = manager.Import(CreateBeatmap(new OsuRuleset().RulesetInfo).BeatmapInfo.BeatmapSet).Result);
-        }
+        private void importBeatmap() => AddStep("import beatmap", () => importedBeatmap = manager.Import(CreateBeatmap(new OsuRuleset().RulesetInfo).BeatmapInfo.BeatmapSet).Result);
 
         private class TestPlaylistsRoomSubScreen : PlaylistsRoomSubScreen
         {
diff --git a/osu.Game/Tests/Beatmaps/TestBeatmap.cs b/osu.Game/Tests/Beatmaps/TestBeatmap.cs
index 15b72ce6e3..caf83973c4 100644
--- a/osu.Game/Tests/Beatmaps/TestBeatmap.cs
+++ b/osu.Game/Tests/Beatmaps/TestBeatmap.cs
@@ -5,6 +5,7 @@ using System;
 using System.Collections.Generic;
 using System.IO;
 using System.Text;
+using System.Threading;
 using osu.Framework.Extensions;
 using osu.Game.Beatmaps;
 using osu.Game.IO;
@@ -16,6 +17,9 @@ namespace osu.Game.Tests.Beatmaps
 {
     public class TestBeatmap : Beatmap
     {
+        private static int onlineSetID;
+        private static int onlineBeatmapID;
+
         public TestBeatmap(RulesetInfo ruleset, bool withHitObjects = true)
         {
             var baseBeatmap = CreateBeatmap();
@@ -31,8 +35,10 @@ namespace osu.Game.Tests.Beatmaps
             BeatmapInfo.RulesetID = ruleset.ID ?? 0;
             BeatmapInfo.BeatmapSet.Metadata = BeatmapInfo.Metadata;
             BeatmapInfo.BeatmapSet.Beatmaps = new List<BeatmapInfo> { BeatmapInfo };
+            BeatmapInfo.BeatmapSet.OnlineBeatmapSetID = Interlocked.Increment(ref onlineSetID);
             BeatmapInfo.Length = 75000;
             BeatmapInfo.OnlineInfo = new APIBeatmap();
+            BeatmapInfo.OnlineBeatmapID = Interlocked.Increment(ref onlineBeatmapID);
             BeatmapInfo.BeatmapSet.OnlineInfo = new APIBeatmapSet
             {
                 Status = BeatmapSetOnlineStatus.Ranked,

From 8076e22e70b7e498a1a9fdc1351ca1e71fbf05ef Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 28 Oct 2021 17:10:04 +0900
Subject: [PATCH 0550/5547] Replace weird import handling

---
 .../TestSceneDrawableRoomPlaylist.cs          |  8 +++++---
 .../TestScenePlaylistsRoomCreation.cs         | 19 ++++---------------
 2 files changed, 9 insertions(+), 18 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
index 93bdbb79f4..f44b0c9716 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
@@ -38,8 +38,6 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             Dependencies.Cache(rulesets = new RulesetStore(ContextFactory));
             Dependencies.Cache(manager = new BeatmapManager(LocalStorage, ContextFactory, rulesets, null, audio, Resources, host, Beatmap.Default));
-
-            manager.Import(new TestBeatmap(new OsuRuleset().RulesetInfo).BeatmapInfo.BeatmapSet).Wait();
         }
 
         [Test]
@@ -204,7 +202,11 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [Test]
         public void TestDownloadButtonHiddenWhenBeatmapExists()
         {
-            createPlaylist(new TestBeatmap(new OsuRuleset().RulesetInfo).BeatmapInfo);
+            var beatmap = new TestBeatmap(new OsuRuleset().RulesetInfo).BeatmapInfo;
+
+            AddStep("import beatmap", () => manager.Import(beatmap.BeatmapSet).Wait());
+
+            createPlaylist(beatmap);
 
             assertDownloadButtonVisible(false);
 
diff --git a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs
index e9825f25d5..cec86fa97e 100644
--- a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs
+++ b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs
@@ -91,27 +91,16 @@ namespace osu.Game.Tests.Visual.Playlists
         {
             BeatmapSetInfo importedSet = null;
 
-            // this step is required to make sure the further imports actually get online IDs.
-            // all the playlist logic relies on online ID matching.
-            AddStep("remove all matching online IDs", () =>
-            {
-                var existing = manager.QueryBeatmapSets(s => s.OnlineBeatmapSetID == importedBeatmap.Value.OnlineBeatmapSetID).ToList();
-
-                foreach (var s in existing)
-                {
-                    s.OnlineBeatmapSetID = null;
-                    foreach (var b in s.Beatmaps)
-                        b.OnlineBeatmapID = null;
-                    manager.Update(s);
-                }
-            });
-
             AddStep("import altered beatmap", () =>
             {
                 IBeatmap beatmap = CreateBeatmap(new OsuRuleset().RulesetInfo);
 
                 beatmap.BeatmapInfo.BaseDifficulty.CircleSize = 1;
 
+                // intentionally increment online IDs to clash with import below.
+                beatmap.BeatmapInfo.OnlineBeatmapID++;
+                beatmap.BeatmapInfo.BeatmapSet.OnlineBeatmapSetID++;
+
                 importedSet = manager.Import(beatmap.BeatmapInfo.BeatmapSet).Result.Value;
             });
 

From c0848486d69474513975c640052aaff464ca3b38 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 28 Oct 2021 17:10:12 +0900
Subject: [PATCH 0551/5547] Add missing test coverage for attempt count display

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

diff --git a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs
index cec86fa97e..3f7409c5ba 100644
--- a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs
+++ b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs
@@ -15,6 +15,7 @@ using osu.Game.Database;
 using osu.Game.Online.Rooms;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Osu;
+using osu.Game.Screens.OnlinePlay.Components;
 using osu.Game.Screens.OnlinePlay.Playlists;
 using osu.Game.Screens.Play;
 using osu.Game.Tests.Visual.OnlinePlay;
@@ -65,10 +66,33 @@ namespace osu.Game.Tests.Visual.Playlists
                 });
             });
 
+            AddUntilStep("Progress details are hidden", () => match.ChildrenOfType<RoomLocalUserInfo>().FirstOrDefault()?.Parent.Alpha == 0);
+
             AddStep("start match", () => match.ChildrenOfType<PlaylistsReadyButton>().First().TriggerClick());
             AddUntilStep("player loader loaded", () => Stack.CurrentScreen is PlayerLoader);
         }
 
+        [Test]
+        public void TestAttemptLimitedMatch()
+        {
+            setupAndCreateRoom(room =>
+            {
+                room.RoomID.Value = 1; // forces room creation.
+                room.Name.Value = "my awesome room";
+                room.MaxAttempts.Value = 5;
+                room.Host.Value = API.LocalUser.Value;
+                room.RecentParticipants.Add(room.Host.Value);
+                room.EndDate.Value = DateTimeOffset.Now.AddMinutes(5);
+                room.Playlist.Add(new PlaylistItem
+                {
+                    Beatmap = { Value = importedBeatmap.Value.Beatmaps.First() },
+                    Ruleset = { Value = new OsuRuleset().RulesetInfo }
+                });
+            });
+
+            AddUntilStep("Progress details are visible", () => match.ChildrenOfType<RoomLocalUserInfo>().FirstOrDefault()?.Parent.Alpha == 1);
+        }
+
         [Test]
         public void TestPlaylistItemSelectedOnCreate()
         {

From c96b07c62528a7f44c6f7537f67692ee2b65d486 Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Thu, 28 Oct 2021 18:24:02 +0900
Subject: [PATCH 0552/5547] Remove unnecessary/wrong code

---
 .../Visual/Playlists/TestScenePlaylistsRoomCreation.cs           | 1 -
 1 file changed, 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs
index 3f7409c5ba..cda7e95a46 100644
--- a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs
+++ b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs
@@ -77,7 +77,6 @@ namespace osu.Game.Tests.Visual.Playlists
         {
             setupAndCreateRoom(room =>
             {
-                room.RoomID.Value = 1; // forces room creation.
                 room.Name.Value = "my awesome room";
                 room.MaxAttempts.Value = 5;
                 room.Host.Value = API.LocalUser.Value;

From 219880d719c8a34d7cd87f86ceb4ab4b01a160a7 Mon Sep 17 00:00:00 2001
From: Xexxar <xexxar.xexxar@gmail.com>
Date: Thu, 28 Oct 2021 14:45:45 +0000
Subject: [PATCH 0553/5547] add in stanrs review

---
 osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
index 7ccb5158db..f706646cdf 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
@@ -63,9 +63,9 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
 
             double aimStrain = currVelocity; // Start strain with regular velocity.
 
-            if (Precision.AlmostEquals(osuCurrObj.StrainTime, osuPrevObj.StrainTime, 10)) // If rhythms are the same.
+            if (Math.Max(osuCurrObj.StrainTime, osuPrevObj.StrainTime) < 1.25 * Math.Min(osuCurrObj.StrainTime, osuPrevObj.StrainTime)) // If rhythms are the same.
             {
-                if (osuCurrObj.Angle != null && osuPrevObj.Angle != null)
+                if (osuCurrObj.Angle != null && osuPrevObj.Angle != null && osuLastObj.Angle != null)
                 {
                     double currAngle = osuCurrObj.Angle.Value;
                     double prevAngle = osuPrevObj.Angle.Value;
@@ -83,7 +83,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
                         acuteAngleBonus *= calcAcuteAngleBonus(prevAngle) // Multiply by previous angle, we don't want to buff unless this is a wiggle type pattern.
                                             * Math.Min(angleBonus, 125 / osuCurrObj.StrainTime) // The maximum velocity we buff is equal to 125 / strainTime
                                             * Math.Pow(Math.Sin(Math.PI / 2 * Math.Min(1, (100 - osuCurrObj.StrainTime) / 25)), 2) // scale buff from 150 bpm 1/4 to 200 bpm 1/4
-                                            * Math.Pow(Math.Sin(Math.PI / 2 * (Math.Min(100, osuCurrObj.JumpDistance) - 50) / 50), 2); // Buff distance exceeding 50 (radius) up to 100 (diameter).
+                                            * Math.Pow(Math.Sin(Math.PI / 2 * (Math.Clamp(osuCurrObj.JumpDistance, 50, 100) - 50) / 50), 2); // Buff distance exceeding 50 (radius) up to 100 (diameter).
 
                     wideAngleBonus *= angleBonus * (1 - Math.Min(wideAngleBonus, Math.Pow(calcWideAngleBonus(prevAngle), 3))); // Penalize wide angles if they're repeated, reducing the penalty as the prevAngle gets more acute.
                     acuteAngleBonus *= 0.5 + 0.5 * (1 - Math.Min(acuteAngleBonus, Math.Pow(calcAcuteAngleBonus(lastAngle), 3))); // Penalize acute angles if they're repeated, reducing the penalty as the lastAngle gets more obtuse.

From ce29d6fd81b9aef105bca0befc77a16ab3fab1e2 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 29 Oct 2021 11:13:06 +0900
Subject: [PATCH 0554/5547] Change scroll speed adjust defaults to F3/F4

Not the most obvious keys, but does match stable expectations so let's
go with it for now.

Rationale for not using +/- is that local audio offset was bound to
those, and people will expect it to be when we get to implementing
eventually.

Also, adjust the scroll speed is a pretty rare thing to do since it's
been constant across beatmaps for years now.
---
 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 9fd7caadd0..22446634c1 100644
--- a/osu.Game/Input/Bindings/GlobalActionContainer.cs
+++ b/osu.Game/Input/Bindings/GlobalActionContainer.cs
@@ -84,8 +84,8 @@ namespace osu.Game.Input.Bindings
             new KeyBinding(InputKey.ExtraMouseButton2, GlobalAction.SkipCutscene),
             new KeyBinding(InputKey.Tilde, GlobalAction.QuickRetry),
             new KeyBinding(new[] { InputKey.Control, InputKey.Tilde }, GlobalAction.QuickExit),
-            new KeyBinding(new[] { InputKey.Control, InputKey.Plus }, GlobalAction.IncreaseScrollSpeed),
-            new KeyBinding(new[] { InputKey.Control, InputKey.Minus }, GlobalAction.DecreaseScrollSpeed),
+            new KeyBinding(new[] { InputKey.F3 }, GlobalAction.DecreaseScrollSpeed),
+            new KeyBinding(new[] { InputKey.F4 }, GlobalAction.IncreaseScrollSpeed),
             new KeyBinding(new[] { InputKey.Shift, InputKey.Tab }, GlobalAction.ToggleInGameInterface),
             new KeyBinding(InputKey.MouseMiddle, GlobalAction.PauseGameplay),
             new KeyBinding(InputKey.Space, GlobalAction.TogglePauseReplay),

From 8d21f0b04b430e9c0943213a64b59cdc71ea3e2e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 29 Oct 2021 11:14:22 +0900
Subject: [PATCH 0555/5547] Add migration to reset conflicting scroll speed key
 bindings

---
 osu.Game/Database/RealmContextFactory.cs | 20 +++++++++++++++++++-
 1 file changed, 19 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Database/RealmContextFactory.cs b/osu.Game/Database/RealmContextFactory.cs
index 013a2e9d64..40b67beed5 100644
--- a/osu.Game/Database/RealmContextFactory.cs
+++ b/osu.Game/Database/RealmContextFactory.cs
@@ -6,9 +6,11 @@ using System.Linq;
 using System.Threading;
 using osu.Framework.Allocation;
 using osu.Framework.Development;
+using osu.Framework.Input.Bindings;
 using osu.Framework.Logging;
 using osu.Framework.Platform;
 using osu.Framework.Statistics;
+using osu.Game.Input.Bindings;
 using osu.Game.Models;
 using Realms;
 
@@ -32,8 +34,9 @@ namespace osu.Game.Database
         /// Version history:
         /// 6  First tracked version (~20211018)
         /// 7  Changed OnlineID fields to non-nullable to add indexing support (20211018)
+        /// 8  Rebind scroll adjust keys to not have control modifier (20211029)
         /// </summary>
-        private const int schema_version = 7;
+        private const int schema_version = 8;
 
         /// <summary>
         /// Lock object which is held during <see cref="BlockAllOperations"/> sections, blocking context creation during blocking periods.
@@ -148,6 +151,21 @@ namespace osu.Game.Database
 
         private void onMigration(Migration migration, ulong lastSchemaVersion)
         {
+            if (lastSchemaVersion < 8)
+            {
+                // Ctrl -/+ now adjusts UI scale so let's clear any bindings which overlap these combinations.
+                // New defaults will be populated by the key store afterwards.
+                var keyBindings = migration.NewRealm.All<RealmKeyBinding>();
+
+                var increaseSpeedBinding = keyBindings.FirstOrDefault(k => k.ActionInt == (int)GlobalAction.IncreaseScrollSpeed);
+                if (increaseSpeedBinding != null && increaseSpeedBinding.KeyCombination.Keys.SequenceEqual(new[] { InputKey.Control, InputKey.Plus }))
+                    migration.NewRealm.Remove(increaseSpeedBinding);
+
+                var descreaseSpeedBinding = keyBindings.FirstOrDefault(k => k.ActionInt == (int)GlobalAction.DecreaseScrollSpeed);
+                if (descreaseSpeedBinding != null && descreaseSpeedBinding.KeyCombination.Keys.SequenceEqual(new[] { InputKey.Control, InputKey.Minus }))
+                    migration.NewRealm.Remove(descreaseSpeedBinding);
+            }
+
             if (lastSchemaVersion < 7)
             {
                 convertOnlineIDs<RealmBeatmap>();

From 3838fe5c6adc2d84964e9aebb934edbed40dd02b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 29 Oct 2021 11:39:15 +0900
Subject: [PATCH 0556/5547] Fix typo in variable name

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

diff --git a/osu.Game/Database/RealmContextFactory.cs b/osu.Game/Database/RealmContextFactory.cs
index 40b67beed5..85f7dd6b89 100644
--- a/osu.Game/Database/RealmContextFactory.cs
+++ b/osu.Game/Database/RealmContextFactory.cs
@@ -161,9 +161,9 @@ namespace osu.Game.Database
                 if (increaseSpeedBinding != null && increaseSpeedBinding.KeyCombination.Keys.SequenceEqual(new[] { InputKey.Control, InputKey.Plus }))
                     migration.NewRealm.Remove(increaseSpeedBinding);
 
-                var descreaseSpeedBinding = keyBindings.FirstOrDefault(k => k.ActionInt == (int)GlobalAction.DecreaseScrollSpeed);
-                if (descreaseSpeedBinding != null && descreaseSpeedBinding.KeyCombination.Keys.SequenceEqual(new[] { InputKey.Control, InputKey.Minus }))
-                    migration.NewRealm.Remove(descreaseSpeedBinding);
+                var decreaseSpeedBinding = keyBindings.FirstOrDefault(k => k.ActionInt == (int)GlobalAction.DecreaseScrollSpeed);
+                if (decreaseSpeedBinding != null && decreaseSpeedBinding.KeyCombination.Keys.SequenceEqual(new[] { InputKey.Control, InputKey.Minus }))
+                    migration.NewRealm.Remove(decreaseSpeedBinding);
             }
 
             if (lastSchemaVersion < 7)

From 34d471522018be48cd9f0e0e4e9e947467c647b4 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 29 Oct 2021 11:48:36 +0900
Subject: [PATCH 0557/5547] Allow for `long` online IDs and implement in
 `ScoreInfo`

---
 osu.Game/Beatmaps/IBeatmapInfo.cs    | 2 +-
 osu.Game/Beatmaps/IBeatmapSetInfo.cs | 2 +-
 osu.Game/Database/IHasOnlineID.cs    | 4 ++--
 osu.Game/Rulesets/IRulesetInfo.cs    | 2 +-
 osu.Game/Scoring/ScoreInfo.cs        | 4 +++-
 5 files changed, 8 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Beatmaps/IBeatmapInfo.cs b/osu.Game/Beatmaps/IBeatmapInfo.cs
index 3d51c5d4b6..d206cfaaed 100644
--- a/osu.Game/Beatmaps/IBeatmapInfo.cs
+++ b/osu.Game/Beatmaps/IBeatmapInfo.cs
@@ -11,7 +11,7 @@ namespace osu.Game.Beatmaps
     /// <summary>
     /// A single beatmap difficulty.
     /// </summary>
-    public interface IBeatmapInfo : IHasOnlineID
+    public interface IBeatmapInfo : IHasOnlineID<int>
     {
         /// <summary>
         /// The user-specified name given to this beatmap.
diff --git a/osu.Game/Beatmaps/IBeatmapSetInfo.cs b/osu.Game/Beatmaps/IBeatmapSetInfo.cs
index 0cfb0c4242..20c46d9063 100644
--- a/osu.Game/Beatmaps/IBeatmapSetInfo.cs
+++ b/osu.Game/Beatmaps/IBeatmapSetInfo.cs
@@ -12,7 +12,7 @@ namespace osu.Game.Beatmaps
     /// <summary>
     /// A representation of a collection of beatmap difficulties, generally packaged as an ".osz" archive.
     /// </summary>
-    public interface IBeatmapSetInfo : IHasOnlineID
+    public interface IBeatmapSetInfo : IHasOnlineID<int>
     {
         /// <summary>
         /// The date when this beatmap was imported.
diff --git a/osu.Game/Database/IHasOnlineID.cs b/osu.Game/Database/IHasOnlineID.cs
index 6e2be7e1f9..36ae4035c4 100644
--- a/osu.Game/Database/IHasOnlineID.cs
+++ b/osu.Game/Database/IHasOnlineID.cs
@@ -5,7 +5,7 @@
 
 namespace osu.Game.Database
 {
-    public interface IHasOnlineID
+    public interface IHasOnlineID<out T>
     {
         /// <summary>
         /// The server-side ID representing this instance, if one exists. Any value 0 or less denotes a missing ID.
@@ -14,6 +14,6 @@ namespace osu.Game.Database
         /// Generally we use -1 when specifying "missing" in code, but values of 0 are also considered missing as the online source
         /// is generally a MySQL autoincrement value, which can never be 0.
         /// </remarks>
-        int OnlineID { get; }
+        T OnlineID { get; }
     }
 }
diff --git a/osu.Game/Rulesets/IRulesetInfo.cs b/osu.Game/Rulesets/IRulesetInfo.cs
index 779433dc81..c3bc6c1995 100644
--- a/osu.Game/Rulesets/IRulesetInfo.cs
+++ b/osu.Game/Rulesets/IRulesetInfo.cs
@@ -11,7 +11,7 @@ namespace osu.Game.Rulesets
     /// <summary>
     /// A representation of a ruleset's metadata.
     /// </summary>
-    public interface IRulesetInfo : IHasOnlineID
+    public interface IRulesetInfo : IHasOnlineID<int>
     {
         /// <summary>
         /// The user-exposed name of this ruleset.
diff --git a/osu.Game/Scoring/ScoreInfo.cs b/osu.Game/Scoring/ScoreInfo.cs
index 5cf22f7945..8eaec0a477 100644
--- a/osu.Game/Scoring/ScoreInfo.cs
+++ b/osu.Game/Scoring/ScoreInfo.cs
@@ -19,7 +19,7 @@ using osu.Game.Utils;
 
 namespace osu.Game.Scoring
 {
-    public class ScoreInfo : IHasFiles<ScoreFileInfo>, IHasPrimaryKey, ISoftDelete, IEquatable<ScoreInfo>, IDeepCloneable<ScoreInfo>
+    public class ScoreInfo : IHasFiles<ScoreFileInfo>, IHasPrimaryKey, ISoftDelete, IEquatable<ScoreInfo>, IDeepCloneable<ScoreInfo>, IHasOnlineID<long>
     {
         public int ID { get; set; }
 
@@ -271,5 +271,7 @@ namespace osu.Game.Scoring
 
             return ReferenceEquals(this, other);
         }
+
+        public long OnlineID => OnlineScoreID ?? -1;
     }
 }

From 748003b016ce84bf4d0f13f98a70ed494cbb8915 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 29 Oct 2021 11:54:19 +0900
Subject: [PATCH 0558/5547] Simplify `Manager` null check to a single pre-check

---
 osu.Game/Online/BeatmapDownloadTracker.cs | 26 +++++++++++------------
 1 file changed, 13 insertions(+), 13 deletions(-)

diff --git a/osu.Game/Online/BeatmapDownloadTracker.cs b/osu.Game/Online/BeatmapDownloadTracker.cs
index 181968c02f..4a7d0b660a 100644
--- a/osu.Game/Online/BeatmapDownloadTracker.cs
+++ b/osu.Game/Online/BeatmapDownloadTracker.cs
@@ -31,25 +31,25 @@ namespace osu.Game.Online
         [BackgroundDependencyLoader(true)]
         private void load()
         {
+            if (Manager == null)
+                return;
+
             // Used to interact with manager classes that don't support interface types. Will eventually be replaced.
             var beatmapSetInfo = new BeatmapSetInfo { OnlineBeatmapSetID = TrackedItem.OnlineID };
 
-            if (Manager?.IsAvailableLocally(beatmapSetInfo) == true)
+            if (Manager.IsAvailableLocally(beatmapSetInfo))
                 UpdateState(DownloadState.LocallyAvailable);
-            else if (Manager != null)
+            else
                 attachDownload(Manager.GetExistingDownload(beatmapSetInfo));
 
-            if (Manager != null)
-            {
-                managerDownloadBegan = Manager.DownloadBegan.GetBoundCopy();
-                managerDownloadBegan.BindValueChanged(downloadBegan);
-                managerDownloadFailed = Manager.DownloadFailed.GetBoundCopy();
-                managerDownloadFailed.BindValueChanged(downloadFailed);
-                managerUpdated = Manager.ItemUpdated.GetBoundCopy();
-                managerUpdated.BindValueChanged(itemUpdated);
-                managerRemoved = Manager.ItemRemoved.GetBoundCopy();
-                managerRemoved.BindValueChanged(itemRemoved);
-            }
+            managerDownloadBegan = Manager.DownloadBegan.GetBoundCopy();
+            managerDownloadBegan.BindValueChanged(downloadBegan);
+            managerDownloadFailed = Manager.DownloadFailed.GetBoundCopy();
+            managerDownloadFailed.BindValueChanged(downloadFailed);
+            managerUpdated = Manager.ItemUpdated.GetBoundCopy();
+            managerUpdated.BindValueChanged(itemUpdated);
+            managerRemoved = Manager.ItemRemoved.GetBoundCopy();
+            managerRemoved.BindValueChanged(itemRemoved);
         }
 
         private void downloadBegan(ValueChangedEvent<WeakReference<ArchiveDownloadRequest<BeatmapSetInfo>>> weakRequest)

From 75a088d4f4f8082986a418c901e7def8b7eae859 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 29 Oct 2021 11:54:42 +0900
Subject: [PATCH 0559/5547] Fix variable name mismatch

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

diff --git a/osu.Game/Online/ScoreDownloadTracker.cs b/osu.Game/Online/ScoreDownloadTracker.cs
index 7a714a7a0e..ac700fc587 100644
--- a/osu.Game/Online/ScoreDownloadTracker.cs
+++ b/osu.Game/Online/ScoreDownloadTracker.cs
@@ -32,12 +32,12 @@ namespace osu.Game.Online
         private void load()
         {
             // Used to interact with manager classes that don't support interface types. Will eventually be replaced.
-            var beatmapSetInfo = new ScoreInfo { OnlineScoreID = TrackedItem.OnlineScoreID };
+            var scoreInfo = new ScoreInfo { OnlineScoreID = TrackedItem.OnlineScoreID };
 
-            if (TrackedItem.ID > 0 || Manager?.IsAvailableLocally(beatmapSetInfo) == true)
+            if (TrackedItem.ID > 0 || Manager?.IsAvailableLocally(scoreInfo) == true)
                 UpdateState(DownloadState.LocallyAvailable);
             else if (Manager != null)
-                attachDownload(Manager.GetExistingDownload(beatmapSetInfo));
+                attachDownload(Manager.GetExistingDownload(scoreInfo));
 
             if (Manager != null)
             {

From dc44734db20e25c4a39b52faa4df0ff62740ee21 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 29 Oct 2021 11:56:17 +0900
Subject: [PATCH 0560/5547] Simplify null check in `ScoreDownloadTracker` and
 remove unnecessary ID check

---
 osu.Game/Online/ScoreDownloadTracker.cs | 26 ++++++++++++-------------
 1 file changed, 13 insertions(+), 13 deletions(-)

diff --git a/osu.Game/Online/ScoreDownloadTracker.cs b/osu.Game/Online/ScoreDownloadTracker.cs
index ac700fc587..8222a5382c 100644
--- a/osu.Game/Online/ScoreDownloadTracker.cs
+++ b/osu.Game/Online/ScoreDownloadTracker.cs
@@ -31,25 +31,25 @@ namespace osu.Game.Online
         [BackgroundDependencyLoader(true)]
         private void load()
         {
+            if (Manager == null)
+                return;
+
             // Used to interact with manager classes that don't support interface types. Will eventually be replaced.
             var scoreInfo = new ScoreInfo { OnlineScoreID = TrackedItem.OnlineScoreID };
 
-            if (TrackedItem.ID > 0 || Manager?.IsAvailableLocally(scoreInfo) == true)
+            if (Manager.IsAvailableLocally(scoreInfo))
                 UpdateState(DownloadState.LocallyAvailable);
-            else if (Manager != null)
+            else
                 attachDownload(Manager.GetExistingDownload(scoreInfo));
 
-            if (Manager != null)
-            {
-                managerDownloadBegan = Manager.DownloadBegan.GetBoundCopy();
-                managerDownloadBegan.BindValueChanged(downloadBegan);
-                managerDownloadFailed = Manager.DownloadFailed.GetBoundCopy();
-                managerDownloadFailed.BindValueChanged(downloadFailed);
-                managerUpdated = Manager.ItemUpdated.GetBoundCopy();
-                managerUpdated.BindValueChanged(itemUpdated);
-                managerRemoved = Manager.ItemRemoved.GetBoundCopy();
-                managerRemoved.BindValueChanged(itemRemoved);
-            }
+            managerDownloadBegan = Manager.DownloadBegan.GetBoundCopy();
+            managerDownloadBegan.BindValueChanged(downloadBegan);
+            managerDownloadFailed = Manager.DownloadFailed.GetBoundCopy();
+            managerDownloadFailed.BindValueChanged(downloadFailed);
+            managerUpdated = Manager.ItemUpdated.GetBoundCopy();
+            managerUpdated.BindValueChanged(itemUpdated);
+            managerRemoved = Manager.ItemRemoved.GetBoundCopy();
+            managerRemoved.BindValueChanged(itemRemoved);
         }
 
         private void downloadBegan(ValueChangedEvent<WeakReference<ArchiveDownloadRequest<ScoreInfo>>> weakRequest)

From f3811edb0b83377ceee067571f4d553bb8bb5b1a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 29 Oct 2021 11:57:54 +0900
Subject: [PATCH 0561/5547] Add inline comment explaining usage of
 `RequiresChildrenUpdate` override

---
 osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs b/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs
index 87348fbd1c..88793c7cfc 100644
--- a/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs
+++ b/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs
@@ -22,6 +22,7 @@ namespace osu.Game.Online.Rooms
     {
         public readonly IBindable<PlaylistItem> SelectedItem = new Bindable<PlaylistItem>();
 
+        // Required to allow child components to update. Can potentially be replaced with a `CompositeComponent` class if or when we make one.
         protected override bool RequiresChildrenUpdate => true;
 
         [Resolved]

From b252b176d45770bbf9e8e1fbd089fa37408b5a51 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 29 Oct 2021 11:59:07 +0900
Subject: [PATCH 0562/5547] Seal implementation and add comment about
 `LoadComplete` execution order

---
 osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
index 1a59f36c11..c946bf12fd 100644
--- a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
+++ b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
@@ -282,7 +282,7 @@ namespace osu.Game.Screens.OnlinePlay
             return true;
         }
 
-        private class PlaylistDownloadButton : BeatmapPanelDownloadButton
+        private sealed class PlaylistDownloadButton : BeatmapPanelDownloadButton
         {
             private readonly PlaylistItem playlistItem;
 
@@ -302,6 +302,8 @@ namespace osu.Game.Screens.OnlinePlay
             protected override void LoadComplete()
             {
                 State.BindValueChanged(stateChanged, true);
+
+                // base implementation calls FinishTransforms, so should be run after the above state update.
                 base.LoadComplete();
             }
 

From 414d920ca25caf0f06e619a0c810414212d8b5a9 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 29 Oct 2021 12:02:10 +0900
Subject: [PATCH 0563/5547] Revert to previous exposure of
 `RoomSubScreen.BeatmapAvailability`

---
 osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs        | 8 +++++---
 .../OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs   | 4 ++--
 2 files changed, 7 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs b/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
index 270d12ec97..2015a050bb 100644
--- a/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
@@ -65,7 +65,9 @@ namespace osu.Game.Screens.OnlinePlay.Match
         private IBindable<WeakReference<BeatmapSetInfo>> managerUpdated;
 
         [Cached]
-        protected OnlinePlayBeatmapAvailabilityTracker BeatmapAvailabilityTracker { get; private set; }
+        private OnlinePlayBeatmapAvailabilityTracker beatmapAvailabilityTracker { get; set; }
+
+        protected IBindable<BeatmapAvailability> BeatmapAvailability => beatmapAvailabilityTracker.Availability;
 
         public readonly Room Room;
         private readonly bool allowEdit;
@@ -86,7 +88,7 @@ namespace osu.Game.Screens.OnlinePlay.Match
 
             Padding = new MarginPadding { Top = Header.HEIGHT };
 
-            BeatmapAvailabilityTracker = new OnlinePlayBeatmapAvailabilityTracker
+            beatmapAvailabilityTracker = new OnlinePlayBeatmapAvailabilityTracker
             {
                 SelectedItem = { BindTarget = SelectedItem }
             };
@@ -101,7 +103,7 @@ namespace osu.Game.Screens.OnlinePlay.Match
 
             InternalChildren = new Drawable[]
             {
-                BeatmapAvailabilityTracker,
+                beatmapAvailabilityTracker,
                 new GridContainer
                 {
                     RelativeSizeAxes = Axes.Both,
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
index 0af41c977b..544eac4127 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
@@ -66,7 +66,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
 
             SelectedItem.BindTo(client.CurrentMatchPlayingItem);
 
-            BeatmapAvailabilityTracker.Availability.BindValueChanged(updateBeatmapAvailability, true);
+            BeatmapAvailability.BindValueChanged(updateBeatmapAvailability, true);
             UserMods.BindValueChanged(onUserModsChanged);
 
             client.LoadRequested += onLoadRequested;
@@ -362,7 +362,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
 
         private void onLoadRequested()
         {
-            if (BeatmapAvailabilityTracker.Availability.Value.State != DownloadState.LocallyAvailable)
+            if (BeatmapAvailability.Value.State != DownloadState.LocallyAvailable)
                 return;
 
             // In the case of spectating, IMultiplayerClient.LoadRequested can be fired while the game is still spectating a previous session.

From 0a56e22fa0da644e69c3a692960928b7dd9cc5e3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 29 Oct 2021 12:14:14 +0900
Subject: [PATCH 0564/5547] Remove unused using statement

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

diff --git a/osu.Game.Rulesets.Osu.Tests/TestSceneNoSpinnerStacking.cs b/osu.Game.Rulesets.Osu.Tests/TestSceneNoSpinnerStacking.cs
index 52597385bb..ef05bcd320 100644
--- a/osu.Game.Rulesets.Osu.Tests/TestSceneNoSpinnerStacking.cs
+++ b/osu.Game.Rulesets.Osu.Tests/TestSceneNoSpinnerStacking.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 NUnit.Framework;
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Osu.Objects;

From 6f863ca204cd9488a4e9a141ce8feadbbabef26d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 1 Aug 2021 17:12:04 +0200
Subject: [PATCH 0565/5547] Adjust game-side text flow containers to part-based
 model

---
 .../Graphics/Containers/LinkFlowContainer.cs  | 50 ++++++++++++++-----
 .../Containers/OsuTextFlowContainer.cs        |  6 +--
 osu.Game/Graphics/ErrorTextFlowContainer.cs   |  9 ++--
 osu.Game/Online/Chat/DrawableLinkCompiler.cs  |  7 +++
 .../Overlays/AccountCreation/ScreenEntry.cs   |  5 +-
 .../Changelog/ChangelogSupporterPromo.cs      |  7 ++-
 osu.Game/Overlays/Music/PlaylistItem.cs       | 16 +++---
 osu.Game/Screens/Menu/Disclaimer.cs           | 10 ++--
 8 files changed, 73 insertions(+), 37 deletions(-)

diff --git a/osu.Game/Graphics/Containers/LinkFlowContainer.cs b/osu.Game/Graphics/Containers/LinkFlowContainer.cs
index 21c1d70d45..7569200c53 100644
--- a/osu.Game/Graphics/Containers/LinkFlowContainer.cs
+++ b/osu.Game/Graphics/Containers/LinkFlowContainer.cs
@@ -9,6 +9,7 @@ using osu.Framework.Graphics.Sprites;
 using System.Collections.Generic;
 using osu.Framework.Extensions.IEnumerableExtensions;
 using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
 using osu.Framework.Localisation;
 using osu.Framework.Platform;
 using osu.Game.Graphics.Sprites;
@@ -71,26 +72,20 @@ namespace osu.Game.Graphics.Containers
             var spriteText = new OsuSpriteText { Text = text };
 
             AddText(spriteText, creationParameters);
-            createLink(spriteText.Yield(), new LinkDetails(action, argument), tooltipText);
+            createLink(new TextPartManual(spriteText.Yield()), new LinkDetails(action, argument), tooltipText);
         }
 
         public void AddLink(IEnumerable<SpriteText> text, LinkAction action, string linkArgument, string tooltipText = null)
         {
-            foreach (var t in text)
-                AddArbitraryDrawable(t);
-
-            createLink(text, new LinkDetails(action, linkArgument), tooltipText);
+            createLink(new TextPartManual(text), new LinkDetails(action, linkArgument), tooltipText);
         }
 
         public void AddUserLink(User user, Action<SpriteText> creationParameters = null)
             => createLink(AddText(user.Username, creationParameters), new LinkDetails(LinkAction.OpenUserProfile, user.Id.ToString()), "view profile");
 
-        private void createLink(IEnumerable<Drawable> drawables, LinkDetails link, string tooltipText, Action action = null)
+        private void createLink(ITextPart textPart, LinkDetails link, LocalisableString tooltipText, Action action = null)
         {
-            var linkCompiler = CreateLinkCompiler(drawables.OfType<SpriteText>());
-            linkCompiler.RelativeSizeAxes = Axes.Both;
-            linkCompiler.TooltipText = tooltipText;
-            linkCompiler.Action = () =>
+            Action onClickAction = () =>
             {
                 if (action != null)
                     action();
@@ -101,10 +96,41 @@ namespace osu.Game.Graphics.Containers
                     host.OpenUrlExternally(link.Argument);
             };
 
-            AddInternal(linkCompiler);
+            AddPart(new TextLink(textPart, tooltipText, onClickAction));
         }
 
-        protected virtual DrawableLinkCompiler CreateLinkCompiler(IEnumerable<SpriteText> parts) => new DrawableLinkCompiler(parts);
+        private class TextLink : TextPart
+        {
+            private readonly ITextPart innerPart;
+            private readonly LocalisableString tooltipText;
+            private readonly Action action;
+
+            public TextLink(ITextPart innerPart, LocalisableString tooltipText, Action action)
+            {
+                this.innerPart = innerPart;
+                this.tooltipText = tooltipText;
+                this.action = action;
+            }
+
+            protected override IEnumerable<Drawable> CreateDrawablesFor(TextFlowContainer textFlowContainer)
+            {
+                var linkFlowContainer = (LinkFlowContainer)textFlowContainer;
+
+                innerPart.RecreateDrawablesFor(linkFlowContainer);
+                var drawables = innerPart.Drawables.ToList();
+
+                drawables.Add(linkFlowContainer.CreateLinkCompiler(innerPart).With(c =>
+                {
+                    c.RelativeSizeAxes = Axes.Both;
+                    c.TooltipText = tooltipText;
+                    c.Action = action;
+                }));
+
+                return drawables;
+            }
+        }
+
+        protected virtual DrawableLinkCompiler CreateLinkCompiler(ITextPart textPart) => new DrawableLinkCompiler(textPart);
 
         // We want the compilers to always be visible no matter where they are, so RelativeSizeAxes is used.
         // However due to https://github.com/ppy/osu-framework/issues/2073, it's possible for the compilers to be relative size in the flow's auto-size axes - an unsupported operation.
diff --git a/osu.Game/Graphics/Containers/OsuTextFlowContainer.cs b/osu.Game/Graphics/Containers/OsuTextFlowContainer.cs
index 6a87a4b8b9..b8237832a3 100644
--- a/osu.Game/Graphics/Containers/OsuTextFlowContainer.cs
+++ b/osu.Game/Graphics/Containers/OsuTextFlowContainer.cs
@@ -2,7 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
-using System.Collections.Generic;
+using osu.Framework.Extensions.IEnumerableExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Sprites;
@@ -19,8 +19,8 @@ namespace osu.Game.Graphics.Containers
 
         protected override SpriteText CreateSpriteText() => new OsuSpriteText();
 
-        public void AddArbitraryDrawable(Drawable drawable) => AddInternal(drawable);
+        public ITextPart AddArbitraryDrawable(Drawable drawable) => AddPart(new TextPartManual(drawable.Yield()));
 
-        public IEnumerable<Drawable> AddIcon(IconUsage icon, Action<SpriteText> creationParameters = null) => AddText(icon.Icon.ToString(), creationParameters);
+        public ITextPart AddIcon(IconUsage icon, Action<SpriteText> creationParameters = null) => AddText(icon.Icon.ToString(), creationParameters);
     }
 }
diff --git a/osu.Game/Graphics/ErrorTextFlowContainer.cs b/osu.Game/Graphics/ErrorTextFlowContainer.cs
index 486382bf33..dafc363973 100644
--- a/osu.Game/Graphics/ErrorTextFlowContainer.cs
+++ b/osu.Game/Graphics/ErrorTextFlowContainer.cs
@@ -2,7 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System.Collections.Generic;
-using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
 using osu.Game.Graphics.Containers;
 using osuTK.Graphics;
 
@@ -10,7 +10,7 @@ namespace osu.Game.Graphics
 {
     public class ErrorTextFlowContainer : OsuTextFlowContainer
     {
-        private readonly List<Drawable> errorDrawables = new List<Drawable>();
+        private readonly List<ITextPart> errorTextParts = new List<ITextPart>();
 
         public ErrorTextFlowContainer()
             : base(cp => cp.Font = cp.Font.With(size: 12))
@@ -19,7 +19,8 @@ namespace osu.Game.Graphics
 
         public void ClearErrors()
         {
-            errorDrawables.ForEach(d => d.Expire());
+            foreach (var textPart in errorTextParts)
+                RemovePart(textPart);
         }
 
         public void AddErrors(string[] errors)
@@ -29,7 +30,7 @@ namespace osu.Game.Graphics
             if (errors == null) return;
 
             foreach (string error in errors)
-                errorDrawables.AddRange(AddParagraph(error, cp => cp.Colour = Color4.Red));
+                errorTextParts.Add(AddParagraph(error, cp => cp.Colour = Color4.Red));
         }
     }
 }
diff --git a/osu.Game/Online/Chat/DrawableLinkCompiler.cs b/osu.Game/Online/Chat/DrawableLinkCompiler.cs
index 4df60eba69..8356b36667 100644
--- a/osu.Game/Online/Chat/DrawableLinkCompiler.cs
+++ b/osu.Game/Online/Chat/DrawableLinkCompiler.cs
@@ -5,6 +5,8 @@ using System.Collections.Generic;
 using System.Linq;
 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.Graphics.UserInterface;
@@ -30,6 +32,11 @@ namespace osu.Game.Online.Chat
 
         protected override HoverSounds CreateHoverSounds(HoverSampleSet sampleSet) => new LinkHoverSounds(sampleSet, Parts);
 
+        public DrawableLinkCompiler(ITextPart part)
+            : this(part.Drawables.OfType<SpriteText>())
+        {
+        }
+
         public DrawableLinkCompiler(IEnumerable<Drawable> parts)
             : base(HoverSampleSet.Submit)
         {
diff --git a/osu.Game/Overlays/AccountCreation/ScreenEntry.cs b/osu.Game/Overlays/AccountCreation/ScreenEntry.cs
index bcb3d4b635..8ee3b1cb2e 100644
--- a/osu.Game/Overlays/AccountCreation/ScreenEntry.cs
+++ b/osu.Game/Overlays/AccountCreation/ScreenEntry.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.Tasks;
 using osu.Framework.Allocation;
@@ -37,7 +36,7 @@ namespace osu.Game.Overlays.AccountCreation
         private IAPIProvider api { get; set; }
 
         private ShakeContainer registerShake;
-        private IEnumerable<Drawable> characterCheckText;
+        private ITextPart characterCheckText;
 
         private OsuTextBox[] textboxes;
         private LoadingLayer loadingLayer;
@@ -136,7 +135,7 @@ namespace osu.Game.Overlays.AccountCreation
             characterCheckText = passwordDescription.AddText("8 characters long");
             passwordDescription.AddText(". Choose something long but also something you will remember, like a line from your favourite song.");
 
-            passwordTextBox.Current.ValueChanged += password => { characterCheckText.ForEach(s => s.Colour = password.NewValue.Length == 0 ? Color4.White : Interpolation.ValueAt(password.NewValue.Length, Color4.OrangeRed, Color4.YellowGreen, 0, 8, Easing.In)); };
+            passwordTextBox.Current.ValueChanged += password => { characterCheckText.Drawables.ForEach(s => s.Colour = password.NewValue.Length == 0 ? Color4.White : Interpolation.ValueAt(password.NewValue.Length, Color4.OrangeRed, Color4.YellowGreen, 0, 8, Easing.In)); };
         }
 
         public override void OnEntering(IScreen last)
diff --git a/osu.Game/Overlays/Changelog/ChangelogSupporterPromo.cs b/osu.Game/Overlays/Changelog/ChangelogSupporterPromo.cs
index 1b0a62dc4a..5cc598ae70 100644
--- a/osu.Game/Overlays/Changelog/ChangelogSupporterPromo.cs
+++ b/osu.Game/Overlays/Changelog/ChangelogSupporterPromo.cs
@@ -2,7 +2,6 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
-using System.Collections.Generic;
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
@@ -166,12 +165,12 @@ namespace osu.Game.Overlays.Changelog
             {
             }
 
-            protected override DrawableLinkCompiler CreateLinkCompiler(IEnumerable<SpriteText> parts) => new SupporterPromoLinkCompiler(parts);
+            protected override DrawableLinkCompiler CreateLinkCompiler(ITextPart textPart) => new SupporterPromoLinkCompiler(textPart);
 
             private class SupporterPromoLinkCompiler : DrawableLinkCompiler
             {
-                public SupporterPromoLinkCompiler(IEnumerable<Drawable> parts)
-                    : base(parts)
+                public SupporterPromoLinkCompiler(ITextPart part)
+                    : base(part)
                 {
                 }
 
diff --git a/osu.Game/Overlays/Music/PlaylistItem.cs b/osu.Game/Overlays/Music/PlaylistItem.cs
index ef25de77c6..eea2a9dc7e 100644
--- a/osu.Game/Overlays/Music/PlaylistItem.cs
+++ b/osu.Game/Overlays/Music/PlaylistItem.cs
@@ -3,12 +3,10 @@
 
 using System;
 using System.Collections.Generic;
-using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
-using osu.Framework.Graphics.Sprites;
 using osu.Framework.Input.Events;
 using osu.Framework.Localisation;
 using osu.Game.Beatmaps;
@@ -25,7 +23,7 @@ namespace osu.Game.Overlays.Music
         public Action<BeatmapSetInfo> RequestSelection;
 
         private TextFlowContainer text;
-        private IEnumerable<Drawable> titleSprites;
+        private ITextPart titlePart;
 
         private ILocalisedBindableString title;
         private ILocalisedBindableString artist;
@@ -63,11 +61,16 @@ namespace osu.Game.Overlays.Music
                 if (set.OldValue?.Equals(Model) != true && set.NewValue?.Equals(Model) != true)
                     return;
 
-                foreach (Drawable s in titleSprites)
-                    s.FadeColour(set.NewValue.Equals(Model) ? selectedColour : Color4.White, FADE_DURATION);
+                updateSelectionState(false);
             }, true);
         }
 
+        private void updateSelectionState(bool instant)
+        {
+            foreach (Drawable s in titlePart.Drawables)
+                s.FadeColour(SelectedSet.Value?.Equals(Model) == true ? selectedColour : Color4.White, instant ? 0 : FADE_DURATION);
+        }
+
         protected override Drawable CreateContent() => text = new OsuTextFlowContainer
         {
             RelativeSizeAxes = Axes.X,
@@ -79,7 +82,8 @@ namespace osu.Game.Overlays.Music
             text.Clear();
 
             // space after the title to put a space between the title and artist
-            titleSprites = text.AddText(title.Value + @"  ", sprite => sprite.Font = OsuFont.GetFont(weight: FontWeight.Regular)).OfType<SpriteText>();
+            titlePart = text.AddText(title.Value + @"  ", sprite => sprite.Font = OsuFont.GetFont(weight: FontWeight.Regular));
+            updateSelectionState(true);
 
             text.AddText(artist.Value, sprite =>
             {
diff --git a/osu.Game/Screens/Menu/Disclaimer.cs b/osu.Game/Screens/Menu/Disclaimer.cs
index 7f34e1e395..b8abc131fd 100644
--- a/osu.Game/Screens/Menu/Disclaimer.cs
+++ b/osu.Game/Screens/Menu/Disclaimer.cs
@@ -37,7 +37,7 @@ namespace osu.Game.Screens.Menu
         private readonly Bindable<User> currentUser = new Bindable<User>();
         private FillFlowContainer fill;
 
-        private readonly List<Drawable> expendableText = new List<Drawable>();
+        private readonly List<ITextPart> expendableText = new List<ITextPart>();
 
         public Disclaimer(OsuScreen nextScreen = null)
         {
@@ -97,7 +97,7 @@ namespace osu.Game.Screens.Menu
 
             textFlow.AddText("this is osu!", t => t.Font = t.Font.With(Typeface.Torus, 30, FontWeight.Regular));
 
-            expendableText.AddRange(textFlow.AddText("lazer", t =>
+            expendableText.Add(textFlow.AddText("lazer", t =>
             {
                 t.Font = t.Font.With(Typeface.Torus, 30, FontWeight.Regular);
                 t.Colour = colours.PinkLight;
@@ -114,7 +114,7 @@ namespace osu.Game.Screens.Menu
                 t.Font = t.Font.With(Typeface.Torus, 20, FontWeight.SemiBold);
                 t.Colour = colours.Pink;
             });
-            expendableText.AddRange(textFlow.AddText(" coming to osu!", formatRegular));
+            expendableText.Add(textFlow.AddText(" coming to osu!", formatRegular));
             textFlow.AddText(".", formatRegular);
 
             textFlow.NewParagraph();
@@ -152,7 +152,7 @@ namespace osu.Game.Screens.Menu
                     t.Font = t.Font.With(size: 20);
                     t.Origin = Anchor.Centre;
                     t.Colour = colours.Pink;
-                }).First();
+                }).Drawables.First();
 
                 if (IsLoaded)
                     animateHeart();
@@ -193,7 +193,7 @@ namespace osu.Game.Screens.Menu
                 using (BeginDelayedSequence(520 + 160))
                 {
                     fill.MoveToOffset(new Vector2(0, 15), 160, Easing.OutQuart);
-                    Schedule(() => expendableText.ForEach(t =>
+                    Schedule(() => expendableText.SelectMany(t => t.Drawables).ForEach(t =>
                     {
                         t.FadeOut(100);
                         t.ScaleTo(new Vector2(0, 1), 100, Easing.OutQuart);

From 61f0339c1d43bac24a1b1addf9d66859fba62401 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 7 Aug 2021 20:52:12 +0200
Subject: [PATCH 0566/5547] Avoid double-adding chunks in link flow container

---
 osu.Game/Graphics/Containers/LinkFlowContainer.cs | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Graphics/Containers/LinkFlowContainer.cs b/osu.Game/Graphics/Containers/LinkFlowContainer.cs
index 7569200c53..0b43c16ebe 100644
--- a/osu.Game/Graphics/Containers/LinkFlowContainer.cs
+++ b/osu.Game/Graphics/Containers/LinkFlowContainer.cs
@@ -59,19 +59,20 @@ namespace osu.Game.Graphics.Containers
         }
 
         public void AddLink(string text, string url, Action<SpriteText> creationParameters = null) =>
-            createLink(AddText(text, creationParameters), new LinkDetails(LinkAction.External, url), url);
+            createLink(CreateChunkFor(text, true, CreateSpriteText, creationParameters), new LinkDetails(LinkAction.External, url), url);
 
         public void AddLink(string text, Action action, string tooltipText = null, Action<SpriteText> creationParameters = null)
-            => createLink(AddText(text, creationParameters), new LinkDetails(LinkAction.Custom, string.Empty), tooltipText, action);
+            => createLink(CreateChunkFor(text, true, CreateSpriteText, creationParameters), new LinkDetails(LinkAction.Custom, string.Empty), tooltipText, action);
 
         public void AddLink(string text, LinkAction action, string argument, string tooltipText = null, Action<SpriteText> creationParameters = null)
-            => createLink(AddText(text, creationParameters), new LinkDetails(action, argument), tooltipText);
+            => createLink(CreateChunkFor(text, true, CreateSpriteText, creationParameters), new LinkDetails(action, argument), tooltipText);
 
         public void AddLink(LocalisableString text, LinkAction action, string argument, string tooltipText = null, Action<SpriteText> creationParameters = null)
         {
             var spriteText = new OsuSpriteText { Text = text };
 
             AddText(spriteText, creationParameters);
+            RemoveInternal(spriteText); // TODO: temporary, will go away when TextParts support localisation properly.
             createLink(new TextPartManual(spriteText.Yield()), new LinkDetails(action, argument), tooltipText);
         }
 
@@ -81,7 +82,7 @@ namespace osu.Game.Graphics.Containers
         }
 
         public void AddUserLink(User user, Action<SpriteText> creationParameters = null)
-            => createLink(AddText(user.Username, creationParameters), new LinkDetails(LinkAction.OpenUserProfile, user.Id.ToString()), "view profile");
+            => createLink(CreateChunkFor(user.Username, true, CreateSpriteText, creationParameters), new LinkDetails(LinkAction.OpenUserProfile, user.Id.ToString()), "view profile");
 
         private void createLink(ITextPart textPart, LinkDetails link, LocalisableString tooltipText, Action action = null)
         {

From 817369903a71151096671b2017c7b54afe5802c0 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 28 Oct 2021 17:48:56 +0900
Subject: [PATCH 0567/5547] Rename API score classes

---
 .../Gameplay/TestSceneReplayDownloadButton.cs |  2 +-
 .../Visual/Online/TestSceneScoresContainer.cs | 30 +++++++++----------
 .../Online/API/Requests/GetScoresRequest.cs   |  6 ++--
 .../API/Requests/GetUserScoresRequest.cs      |  2 +-
 ...{APILegacyScoreInfo.cs => APIScoreInfo.cs} |  2 +-
 ...egacyScores.cs => APIScoreWithPosition.cs} | 16 ++--------
 .../Requests/Responses/APIScoresCollection.cs | 17 +++++++++++
 .../BeatmapSet/Scores/ScoresContainer.cs      |  2 +-
 .../Sections/Ranks/PaginatedScoreContainer.cs |  8 ++---
 9 files changed, 46 insertions(+), 39 deletions(-)
 rename osu.Game/Online/API/Requests/Responses/{APILegacyScoreInfo.cs => APIScoreInfo.cs} (99%)
 rename osu.Game/Online/API/Requests/Responses/{APILegacyScores.cs => APIScoreWithPosition.cs} (55%)
 create mode 100644 osu.Game/Online/API/Requests/Responses/APIScoresCollection.cs

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneReplayDownloadButton.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneReplayDownloadButton.cs
index 5e2374cbcb..20dec46101 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneReplayDownloadButton.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneReplayDownloadButton.cs
@@ -132,7 +132,7 @@ namespace osu.Game.Tests.Visual.Gameplay
 
         private ScoreInfo getScoreInfo(bool replayAvailable)
         {
-            return new APILegacyScoreInfo
+            return new APIScoreInfo
             {
                 OnlineScoreID = 2553163309,
                 OnlineRulesetID = 0,
diff --git a/osu.Game.Tests/Visual/Online/TestSceneScoresContainer.cs b/osu.Game.Tests/Visual/Online/TestSceneScoresContainer.cs
index 0cb8cc22ec..991be33917 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneScoresContainer.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneScoresContainer.cs
@@ -43,11 +43,11 @@ namespace osu.Game.Tests.Visual.Online
                 }
             };
 
-            var allScores = new APILegacyScores
+            var allScores = new APIScoresCollection
             {
-                Scores = new List<APILegacyScoreInfo>
+                Scores = new List<APIScoreInfo>
                 {
-                    new APILegacyScoreInfo
+                    new APIScoreInfo
                     {
                         User = new User
                         {
@@ -72,7 +72,7 @@ namespace osu.Game.Tests.Visual.Online
                         TotalScore = 1234567890,
                         Accuracy = 1,
                     },
-                    new APILegacyScoreInfo
+                    new APIScoreInfo
                     {
                         User = new User
                         {
@@ -96,7 +96,7 @@ namespace osu.Game.Tests.Visual.Online
                         TotalScore = 1234789,
                         Accuracy = 0.9997,
                     },
-                    new APILegacyScoreInfo
+                    new APIScoreInfo
                     {
                         User = new User
                         {
@@ -119,7 +119,7 @@ namespace osu.Game.Tests.Visual.Online
                         TotalScore = 12345678,
                         Accuracy = 0.9854,
                     },
-                    new APILegacyScoreInfo
+                    new APIScoreInfo
                     {
                         User = new User
                         {
@@ -141,7 +141,7 @@ namespace osu.Game.Tests.Visual.Online
                         TotalScore = 1234567,
                         Accuracy = 0.8765,
                     },
-                    new APILegacyScoreInfo
+                    new APIScoreInfo
                     {
                         User = new User
                         {
@@ -162,9 +162,9 @@ namespace osu.Game.Tests.Visual.Online
                 }
             };
 
-            var myBestScore = new APILegacyUserTopScoreInfo
+            var myBestScore = new APIScoreWithPosition
             {
-                Score = new APILegacyScoreInfo
+                Score = new APIScoreInfo
                 {
                     User = new User
                     {
@@ -185,9 +185,9 @@ namespace osu.Game.Tests.Visual.Online
                 Position = 1337,
             };
 
-            var myBestScoreWithNullPosition = new APILegacyUserTopScoreInfo
+            var myBestScoreWithNullPosition = new APIScoreWithPosition
             {
-                Score = new APILegacyScoreInfo
+                Score = new APIScoreInfo
                 {
                     User = new User
                     {
@@ -208,11 +208,11 @@ namespace osu.Game.Tests.Visual.Online
                 Position = null,
             };
 
-            var oneScore = new APILegacyScores
+            var oneScore = new APIScoresCollection
             {
-                Scores = new List<APILegacyScoreInfo>
+                Scores = new List<APIScoreInfo>
                 {
-                    new APILegacyScoreInfo
+                    new APIScoreInfo
                     {
                         User = new User
                         {
@@ -273,7 +273,7 @@ namespace osu.Game.Tests.Visual.Online
 
         private class TestScoresContainer : ScoresContainer
         {
-            public new APILegacyScores Scores
+            public new APIScoresCollection Scores
             {
                 set => base.Scores = value;
             }
diff --git a/osu.Game/Online/API/Requests/GetScoresRequest.cs b/osu.Game/Online/API/Requests/GetScoresRequest.cs
index f3bf690ed5..11b0cdddd8 100644
--- a/osu.Game/Online/API/Requests/GetScoresRequest.cs
+++ b/osu.Game/Online/API/Requests/GetScoresRequest.cs
@@ -13,7 +13,7 @@ using System.Diagnostics;
 
 namespace osu.Game.Online.API.Requests
 {
-    public class GetScoresRequest : APIRequest<APILegacyScores>
+    public class GetScoresRequest : APIRequest<APIScoresCollection>
     {
         private readonly BeatmapInfo beatmapInfo;
         private readonly BeatmapLeaderboardScope scope;
@@ -36,11 +36,11 @@ namespace osu.Game.Online.API.Requests
             Success += onSuccess;
         }
 
-        private void onSuccess(APILegacyScores r)
+        private void onSuccess(APIScoresCollection r)
         {
             Debug.Assert(ruleset.ID != null, "ruleset.ID != null");
 
-            foreach (APILegacyScoreInfo score in r.Scores)
+            foreach (APIScoreInfo score in r.Scores)
             {
                 score.BeatmapInfo = beatmapInfo;
                 score.OnlineRulesetID = ruleset.ID.Value;
diff --git a/osu.Game/Online/API/Requests/GetUserScoresRequest.cs b/osu.Game/Online/API/Requests/GetUserScoresRequest.cs
index 7b4d66e7b2..e13ac8e539 100644
--- a/osu.Game/Online/API/Requests/GetUserScoresRequest.cs
+++ b/osu.Game/Online/API/Requests/GetUserScoresRequest.cs
@@ -8,7 +8,7 @@ using osu.Game.Rulesets;
 
 namespace osu.Game.Online.API.Requests
 {
-    public class GetUserScoresRequest : PaginatedAPIRequest<List<APILegacyScoreInfo>>
+    public class GetUserScoresRequest : PaginatedAPIRequest<List<APIScoreInfo>>
     {
         private readonly long userId;
         private readonly ScoreType type;
diff --git a/osu.Game/Online/API/Requests/Responses/APILegacyScoreInfo.cs b/osu.Game/Online/API/Requests/Responses/APIScoreInfo.cs
similarity index 99%
rename from osu.Game/Online/API/Requests/Responses/APILegacyScoreInfo.cs
rename to osu.Game/Online/API/Requests/Responses/APIScoreInfo.cs
index aaf2dccc82..c977d27a68 100644
--- a/osu.Game/Online/API/Requests/Responses/APILegacyScoreInfo.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIScoreInfo.cs
@@ -15,7 +15,7 @@ using osu.Game.Users;
 
 namespace osu.Game.Online.API.Requests.Responses
 {
-    public class APILegacyScoreInfo
+    public class APIScoreInfo
     {
         public ScoreInfo CreateScoreInfo(RulesetStore rulesets)
         {
diff --git a/osu.Game/Online/API/Requests/Responses/APILegacyScores.cs b/osu.Game/Online/API/Requests/Responses/APIScoreWithPosition.cs
similarity index 55%
rename from osu.Game/Online/API/Requests/Responses/APILegacyScores.cs
rename to osu.Game/Online/API/Requests/Responses/APIScoreWithPosition.cs
index 009639c1dc..9c97ad4f05 100644
--- a/osu.Game/Online/API/Requests/Responses/APILegacyScores.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIScoreWithPosition.cs
@@ -1,29 +1,19 @@
-// 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;
 using Newtonsoft.Json;
 using osu.Game.Rulesets;
 using osu.Game.Scoring;
 
 namespace osu.Game.Online.API.Requests.Responses
 {
-    public class APILegacyScores
-    {
-        [JsonProperty(@"scores")]
-        public List<APILegacyScoreInfo> Scores;
-
-        [JsonProperty(@"userScore")]
-        public APILegacyUserTopScoreInfo UserScore;
-    }
-
-    public class APILegacyUserTopScoreInfo
+    public class APIScoreWithPosition
     {
         [JsonProperty(@"position")]
         public int? Position;
 
         [JsonProperty(@"score")]
-        public APILegacyScoreInfo Score;
+        public APIScoreInfo Score;
 
         public ScoreInfo CreateScoreInfo(RulesetStore rulesets)
         {
diff --git a/osu.Game/Online/API/Requests/Responses/APIScoresCollection.cs b/osu.Game/Online/API/Requests/Responses/APIScoresCollection.cs
new file mode 100644
index 0000000000..5304664bf8
--- /dev/null
+++ b/osu.Game/Online/API/Requests/Responses/APIScoresCollection.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 System.Collections.Generic;
+using Newtonsoft.Json;
+
+namespace osu.Game.Online.API.Requests.Responses
+{
+    public class APIScoresCollection
+    {
+        [JsonProperty(@"scores")]
+        public List<APIScoreInfo> Scores;
+
+        [JsonProperty(@"userScore")]
+        public APIScoreWithPosition UserScore;
+    }
+}
diff --git a/osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.cs b/osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.cs
index 82657afc86..3a3566aad9 100644
--- a/osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.cs
+++ b/osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.cs
@@ -52,7 +52,7 @@ namespace osu.Game.Overlays.BeatmapSet.Scores
 
         private CancellationTokenSource loadCancellationSource;
 
-        protected APILegacyScores Scores
+        protected APIScoresCollection Scores
         {
             set => Schedule(() =>
             {
diff --git a/osu.Game/Overlays/Profile/Sections/Ranks/PaginatedScoreContainer.cs b/osu.Game/Overlays/Profile/Sections/Ranks/PaginatedScoreContainer.cs
index 7c04b331c2..1fb6100a28 100644
--- a/osu.Game/Overlays/Profile/Sections/Ranks/PaginatedScoreContainer.cs
+++ b/osu.Game/Overlays/Profile/Sections/Ranks/PaginatedScoreContainer.cs
@@ -15,7 +15,7 @@ using osu.Framework.Localisation;
 
 namespace osu.Game.Overlays.Profile.Sections.Ranks
 {
-    public class PaginatedScoreContainer : PaginatedProfileSubsection<APILegacyScoreInfo>
+    public class PaginatedScoreContainer : PaginatedProfileSubsection<APIScoreInfo>
     {
         private readonly ScoreType type;
 
@@ -51,7 +51,7 @@ namespace osu.Game.Overlays.Profile.Sections.Ranks
             }
         }
 
-        protected override void OnItemsReceived(List<APILegacyScoreInfo> items)
+        protected override void OnItemsReceived(List<APIScoreInfo> items)
         {
             if (VisiblePages == 0)
                 drawableItemIndex = 0;
@@ -59,12 +59,12 @@ namespace osu.Game.Overlays.Profile.Sections.Ranks
             base.OnItemsReceived(items);
         }
 
-        protected override APIRequest<List<APILegacyScoreInfo>> CreateRequest() =>
+        protected override APIRequest<List<APIScoreInfo>> CreateRequest() =>
             new GetUserScoresRequest(User.Value.Id, type, VisiblePages++, ItemsPerPage);
 
         private int drawableItemIndex;
 
-        protected override Drawable CreateDrawableItem(APILegacyScoreInfo model)
+        protected override Drawable CreateDrawableItem(APIScoreInfo model)
         {
             switch (type)
             {

From 49b5de64befad30c60a1d2fae2adc760e8d8fbab Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 28 Oct 2021 17:57:17 +0900
Subject: [PATCH 0568/5547] Extract interface

---
 osu.Game/Scoring/IScoreInfo.cs | 42 ++++++++++++++++++++++++++++++++++
 osu.Game/Scoring/ScoreInfo.cs  |  4 ++--
 2 files changed, 44 insertions(+), 2 deletions(-)
 create mode 100644 osu.Game/Scoring/IScoreInfo.cs

diff --git a/osu.Game/Scoring/IScoreInfo.cs b/osu.Game/Scoring/IScoreInfo.cs
new file mode 100644
index 0000000000..c783a77203
--- /dev/null
+++ b/osu.Game/Scoring/IScoreInfo.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 System.Collections.Generic;
+using osu.Game.Beatmaps;
+using osu.Game.Database;
+using osu.Game.Users;
+
+namespace osu.Game.Scoring
+{
+    public interface IScoreInfo : IHasOnlineID<long>
+    {
+        int TotalScore { get; set; }
+
+        int MaxCombo { get; set; }
+
+        User User { get; set; }
+
+        long OnlineScoreID { get; set; }
+
+        bool Replay { get; set; }
+
+        DateTimeOffset Date { get; set; }
+
+        BeatmapInfo BeatmapInfo { get; set; }
+
+        double Accuracy { get; set; }
+
+        double? PP { get; set; }
+
+        BeatmapMetadata Metadata { get; set; }
+
+        Dictionary<string, int> Statistics { get; set; }
+
+        int OnlineRulesetID { get; set; }
+
+        string[] Mods { get; set; }
+
+        public ScoreRank Rank { get; set; }
+    }
+}
diff --git a/osu.Game/Scoring/ScoreInfo.cs b/osu.Game/Scoring/ScoreInfo.cs
index 8eaec0a477..0afec89450 100644
--- a/osu.Game/Scoring/ScoreInfo.cs
+++ b/osu.Game/Scoring/ScoreInfo.cs
@@ -19,7 +19,7 @@ using osu.Game.Utils;
 
 namespace osu.Game.Scoring
 {
-    public class ScoreInfo : IHasFiles<ScoreFileInfo>, IHasPrimaryKey, ISoftDelete, IEquatable<ScoreInfo>, IDeepCloneable<ScoreInfo>, IHasOnlineID<long>
+    public class ScoreInfo : IScoreInfo, IHasFiles<ScoreFileInfo>, IHasPrimaryKey, ISoftDelete, IEquatable<ScoreInfo>, IDeepCloneable<ScoreInfo>
     {
         public int ID { get; set; }
 
@@ -54,7 +54,7 @@ namespace osu.Game.Scoring
         public bool Passed { get; set; } = true;
 
         [JsonIgnore]
-        public virtual RulesetInfo Ruleset { get; set; }
+        public RulesetInfo Ruleset { get; set; }
 
         private APIMod[] localAPIMods;
         private Mod[] mods;

From 1944c255a78575a0e075642f66e1ca3655fd2d80 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 28 Oct 2021 18:23:52 +0900
Subject: [PATCH 0569/5547] Implement score interfaces

---
 .../Gameplay/TestSceneReplayDownloadButton.cs |   2 +-
 .../Online/API/Requests/GetScoresRequest.cs   |  10 +-
 .../API/Requests/Responses/APIScoreInfo.cs    | 113 ++++++++++--------
 .../Responses/APIScoreWithPosition.cs         |   1 +
 osu.Game/Scoring/IScoreInfo.cs                |  31 +++--
 osu.Game/Scoring/ScoreInfo.cs                 |   7 +-
 osu.Game/Screens/Ranking/SoloResultsScreen.cs |   2 +-
 7 files changed, 95 insertions(+), 71 deletions(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneReplayDownloadButton.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneReplayDownloadButton.cs
index 20dec46101..b84ac6c2f1 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneReplayDownloadButton.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneReplayDownloadButton.cs
@@ -134,7 +134,7 @@ namespace osu.Game.Tests.Visual.Gameplay
         {
             return new APIScoreInfo
             {
-                OnlineScoreID = 2553163309,
+                OnlineID = 2553163309,
                 OnlineRulesetID = 0,
                 Replay = replayAvailable,
                 User = new User
diff --git a/osu.Game/Online/API/Requests/GetScoresRequest.cs b/osu.Game/Online/API/Requests/GetScoresRequest.cs
index 11b0cdddd8..9037869c77 100644
--- a/osu.Game/Online/API/Requests/GetScoresRequest.cs
+++ b/osu.Game/Online/API/Requests/GetScoresRequest.cs
@@ -38,20 +38,20 @@ namespace osu.Game.Online.API.Requests
 
         private void onSuccess(APIScoresCollection r)
         {
-            Debug.Assert(ruleset.ID != null, "ruleset.ID != null");
+            Debug.Assert(ruleset.OnlineID >= 0);
 
             foreach (APIScoreInfo score in r.Scores)
             {
-                score.BeatmapInfo = beatmapInfo;
-                score.OnlineRulesetID = ruleset.ID.Value;
+                score.Beatmap = beatmapInfo;
+                score.OnlineRulesetID = ruleset.OnlineID;
             }
 
             var userScore = r.UserScore;
 
             if (userScore != null)
             {
-                userScore.Score.BeatmapInfo = beatmapInfo;
-                userScore.Score.OnlineRulesetID = ruleset.ID.Value;
+                userScore.Score.Beatmap = beatmapInfo;
+                userScore.Score.OnlineRulesetID = ruleset.OnlineID;
             }
         }
 
diff --git a/osu.Game/Online/API/Requests/Responses/APIScoreInfo.cs b/osu.Game/Online/API/Requests/Responses/APIScoreInfo.cs
index c977d27a68..568c6bea7f 100644
--- a/osu.Game/Online/API/Requests/Responses/APIScoreInfo.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIScoreInfo.cs
@@ -9,14 +9,71 @@ using Newtonsoft.Json.Converters;
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Mods;
+using osu.Game.Rulesets.Scoring;
 using osu.Game.Scoring;
 using osu.Game.Scoring.Legacy;
 using osu.Game.Users;
 
 namespace osu.Game.Online.API.Requests.Responses
 {
-    public class APIScoreInfo
+    public class APIScoreInfo : IScoreInfo
     {
+        [JsonProperty(@"score")]
+        public long TotalScore { get; set; }
+
+        [JsonProperty(@"max_combo")]
+        public int MaxCombo { get; set; }
+
+        [JsonProperty(@"user")]
+        public User User { get; set; }
+
+        public bool HasReplay { get; set; }
+
+        [JsonProperty(@"id")]
+        public long OnlineID { get; set; }
+
+        [JsonProperty(@"replay")]
+        public bool Replay { get; set; }
+
+        [JsonProperty(@"created_at")]
+        public DateTimeOffset Date { get; set; }
+
+        [JsonProperty(@"beatmap")]
+        public IBeatmapInfo Beatmap { get; set; }
+
+        [JsonProperty("accuracy")]
+        public double Accuracy { get; set; }
+
+        [JsonProperty(@"pp")]
+        public double? PP { get; set; }
+
+        [JsonProperty(@"beatmapset")]
+        public APIBeatmapSet BeatmapSet
+        {
+            set
+            {
+                // in the deserialisation case we need to ferry this data across.
+                if (Beatmap is APIBeatmap apiBeatmap)
+                    apiBeatmap.BeatmapSet = value;
+            }
+        }
+
+        [JsonProperty("statistics")]
+        public Dictionary<string, int> Statistics { get; set; }
+
+        [JsonProperty(@"mode_int")]
+        public int OnlineRulesetID { get; set; }
+
+        [JsonProperty(@"mods")]
+        public string[] Mods { get; set; }
+
+        [JsonProperty("rank")]
+        [JsonConverter(typeof(StringEnumConverter))]
+        public ScoreRank Rank { get; set; }
+
+        IBeatmapInfo IScoreInfo.Beatmap => Beatmap;
+
+        // TODO: nuke
         public ScoreInfo CreateScoreInfo(RulesetStore rulesets)
         {
             var ruleset = rulesets.GetRuleset(OnlineRulesetID);
@@ -34,10 +91,10 @@ namespace osu.Game.Online.API.Requests.Responses
                 MaxCombo = MaxCombo,
                 User = User,
                 Accuracy = Accuracy,
-                OnlineScoreID = OnlineScoreID,
+                OnlineScoreID = OnlineID,
                 Date = Date,
                 PP = PP,
-                BeatmapInfo = BeatmapInfo,
+                BeatmapInfo = Beatmap.ToBeatmapInfo(rulesets),
                 RulesetID = OnlineRulesetID,
                 Hash = Replay ? "online" : string.Empty, // todo: temporary?
                 Rank = Rank,
@@ -81,57 +138,19 @@ namespace osu.Game.Online.API.Requests.Responses
             return scoreInfo;
         }
 
-        [JsonProperty(@"score")]
-        public int TotalScore { get; set; }
-
-        [JsonProperty(@"max_combo")]
-        public int MaxCombo { get; set; }
-
-        [JsonProperty(@"user")]
-        public User User { get; set; }
-
-        [JsonProperty(@"id")]
-        public long OnlineScoreID { get; set; }
-
-        [JsonProperty(@"replay")]
-        public bool Replay { get; set; }
-
-        [JsonProperty(@"created_at")]
-        public DateTimeOffset Date { get; set; }
-
-        [JsonProperty(@"beatmap")]
-        public BeatmapInfo BeatmapInfo { get; set; }
-
-        [JsonProperty("accuracy")]
-        public double Accuracy { get; set; }
-
-        [JsonProperty(@"pp")]
-        public double? PP { get; set; }
-
         [JsonProperty(@"beatmapset")]
-        public BeatmapMetadata Metadata
+        public APIBeatmapSet Metadata
         {
             set
             {
-                // extract the set ID to its correct place.
-                BeatmapInfo.BeatmapSet = new BeatmapSetInfo { OnlineBeatmapSetID = value.ID };
-                value.ID = 0;
-
-                BeatmapInfo.Metadata = value;
+                // in the deserialisation case we need to ferry this data across.
+                if (Beatmap is APIBeatmap apiBeatmap)
+                    apiBeatmap.BeatmapSet = value;
             }
         }
 
-        [JsonProperty(@"statistics")]
-        public Dictionary<string, int> Statistics { get; set; }
+        public IRulesetInfo Ruleset => new RulesetInfo { ID = OnlineRulesetID };
 
-        [JsonProperty(@"mode_int")]
-        public int OnlineRulesetID { get; set; }
-
-        [JsonProperty(@"mods")]
-        public string[] Mods { get; set; }
-
-        [JsonProperty("rank")]
-        [JsonConverter(typeof(StringEnumConverter))]
-        public ScoreRank Rank { get; set; }
+        Dictionary<HitResult, int> IScoreInfo.Statistics => new Dictionary<HitResult, int>(); // TODO: implement... maybe. hitresults have weird mappings per ruleset it would seem.
     }
 }
diff --git a/osu.Game/Online/API/Requests/Responses/APIScoreWithPosition.cs b/osu.Game/Online/API/Requests/Responses/APIScoreWithPosition.cs
index 9c97ad4f05..89bb416393 100644
--- a/osu.Game/Online/API/Requests/Responses/APIScoreWithPosition.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIScoreWithPosition.cs
@@ -16,6 +16,7 @@ namespace osu.Game.Online.API.Requests.Responses
         public APIScoreInfo Score;
 
         public ScoreInfo CreateScoreInfo(RulesetStore rulesets)
+
         {
             var score = Score.CreateScoreInfo(rulesets);
             score.Position = Position;
diff --git a/osu.Game/Scoring/IScoreInfo.cs b/osu.Game/Scoring/IScoreInfo.cs
index c783a77203..b230babf3c 100644
--- a/osu.Game/Scoring/IScoreInfo.cs
+++ b/osu.Game/Scoring/IScoreInfo.cs
@@ -5,38 +5,37 @@ using System;
 using System.Collections.Generic;
 using osu.Game.Beatmaps;
 using osu.Game.Database;
+using osu.Game.Rulesets;
+using osu.Game.Rulesets.Scoring;
 using osu.Game.Users;
 
 namespace osu.Game.Scoring
 {
     public interface IScoreInfo : IHasOnlineID<long>
     {
-        int TotalScore { get; set; }
+        User User { get; }
 
-        int MaxCombo { get; set; }
+        long TotalScore { get; }
 
-        User User { get; set; }
+        int MaxCombo { get; }
 
-        long OnlineScoreID { get; set; }
+        double Accuracy { get; }
 
-        bool Replay { get; set; }
+        bool HasReplay { get; }
 
-        DateTimeOffset Date { get; set; }
+        DateTimeOffset Date { get; }
 
-        BeatmapInfo BeatmapInfo { get; set; }
+        double? PP { get; }
 
-        double Accuracy { get; set; }
+        IBeatmapInfo Beatmap { get; }
 
-        double? PP { get; set; }
+        Dictionary<HitResult, int> Statistics { get; }
 
-        BeatmapMetadata Metadata { get; set; }
+        IRulesetInfo Ruleset { get; }
 
-        Dictionary<string, int> Statistics { get; set; }
+        public ScoreRank Rank { get; }
 
-        int OnlineRulesetID { get; set; }
-
-        string[] Mods { get; set; }
-
-        public ScoreRank Rank { get; set; }
+        // Mods is currently missing from this interface as the `IMod` class has properties which can't be fulfilled by `APIMod`,
+        // but also doesn't expose `Settings`. We can consider how to implement this in the future if required.
     }
 }
diff --git a/osu.Game/Scoring/ScoreInfo.cs b/osu.Game/Scoring/ScoreInfo.cs
index 0afec89450..3b09669926 100644
--- a/osu.Game/Scoring/ScoreInfo.cs
+++ b/osu.Game/Scoring/ScoreInfo.cs
@@ -57,6 +57,7 @@ namespace osu.Game.Scoring
         public RulesetInfo Ruleset { get; set; }
 
         private APIMod[] localAPIMods;
+
         private Mod[] mods;
 
         [JsonIgnore]
@@ -160,7 +161,7 @@ namespace osu.Game.Scoring
         public DateTimeOffset Date { get; set; }
 
         [JsonProperty("statistics")]
-        public Dictionary<HitResult, int> Statistics = new Dictionary<HitResult, int>();
+        public Dictionary<HitResult, int> Statistics { get; set; } = new Dictionary<HitResult, int>();
 
         [JsonIgnore]
         [Column("Statistics")]
@@ -273,5 +274,9 @@ namespace osu.Game.Scoring
         }
 
         public long OnlineID => OnlineScoreID ?? -1;
+
+        IBeatmapInfo IScoreInfo.Beatmap => BeatmapInfo;
+        IRulesetInfo IScoreInfo.Ruleset => Ruleset;
+        bool IScoreInfo.HasReplay => Files.Any();
     }
 }
diff --git a/osu.Game/Screens/Ranking/SoloResultsScreen.cs b/osu.Game/Screens/Ranking/SoloResultsScreen.cs
index 5e582a8dcb..684c7574cb 100644
--- a/osu.Game/Screens/Ranking/SoloResultsScreen.cs
+++ b/osu.Game/Screens/Ranking/SoloResultsScreen.cs
@@ -31,7 +31,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.OnlineScoreID != Score.OnlineScoreID).Select(s => s.CreateScoreInfo(rulesets)));
+            getScoreRequest.Success += r => scoresCallback?.Invoke(r.Scores.Where(s => s.OnlineID != Score.OnlineScoreID).Select(s => s.CreateScoreInfo(rulesets)));
             return getScoreRequest;
         }
 

From 746f4a49c1e00e40b877619b8da805e554fc1f19 Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Fri, 29 Oct 2021 13:56:07 +0900
Subject: [PATCH 0570/5547] Add base test scene

---
 .../QueueingModes/QueueModeTestScene.cs       | 103 ++++++++++++++++++
 .../TestSceneHostOnlyQueueingMode.cs          |  12 ++
 2 files changed, 115 insertions(+)
 create mode 100644 osu.Game.Tests/Visual/Multiplayer/QueueingModes/QueueModeTestScene.cs
 create mode 100644 osu.Game.Tests/Visual/Multiplayer/QueueingModes/TestSceneHostOnlyQueueingMode.cs

diff --git a/osu.Game.Tests/Visual/Multiplayer/QueueingModes/QueueModeTestScene.cs b/osu.Game.Tests/Visual/Multiplayer/QueueingModes/QueueModeTestScene.cs
new file mode 100644
index 0000000000..0480e3bb78
--- /dev/null
+++ b/osu.Game.Tests/Visual/Multiplayer/QueueingModes/QueueModeTestScene.cs
@@ -0,0 +1,103 @@
+// 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.Audio;
+using osu.Framework.Platform;
+using osu.Framework.Testing;
+using osu.Game.Beatmaps;
+using osu.Game.Database;
+using osu.Game.Online.Multiplayer.Queueing;
+using osu.Game.Online.Rooms;
+using osu.Game.Rulesets;
+using osu.Game.Rulesets.Osu;
+using osu.Game.Screens.OnlinePlay.Lounge;
+using osu.Game.Screens.OnlinePlay.Multiplayer;
+using osu.Game.Screens.OnlinePlay.Multiplayer.Match;
+using osuTK.Input;
+
+namespace osu.Game.Tests.Visual.Multiplayer.QueueingModes
+{
+    public abstract class QueueModeTestScene : ScreenTestScene
+    {
+        protected abstract QueueModes Mode { get; }
+
+        private BeatmapManager beatmaps;
+        private RulesetStore rulesets;
+        private ILive<BeatmapSetInfo> importedBeatmap;
+
+        private TestMultiplayerScreenStack multiplayerScreenStack;
+
+        private TestMultiplayerClient client => multiplayerScreenStack.Client;
+        private TestMultiplayerRoomManager roomManager => multiplayerScreenStack.RoomManager;
+
+        [Cached(typeof(UserLookupCache))]
+        private UserLookupCache lookupCache = new TestUserLookupCache();
+
+        [BackgroundDependencyLoader]
+        private void load(GameHost host, AudioManager audio)
+        {
+            Dependencies.Cache(rulesets = new RulesetStore(ContextFactory));
+            Dependencies.Cache(beatmaps = new BeatmapManager(LocalStorage, ContextFactory, rulesets, null, audio, Resources, host, Beatmap.Default));
+        }
+
+        public override void SetUpSteps()
+        {
+            base.SetUpSteps();
+
+            AddStep("import beatmap", () =>
+            {
+                var beatmap1 = CreateBeatmap(new OsuRuleset().RulesetInfo).BeatmapInfo;
+                beatmap1.Version = "1";
+
+                var beatmap2 = CreateBeatmap(new OsuRuleset().RulesetInfo).BeatmapInfo;
+                beatmap2.Version = "2";
+
+                // Move beatmap2 to beatmap1's set.
+                var beatmapSet = beatmap1.BeatmapSet;
+                beatmapSet.Beatmaps.Add(beatmap2);
+                beatmap2.BeatmapSet = beatmapSet;
+
+                importedBeatmap = beatmaps.Import(beatmapSet).Result;
+            });
+
+            AddStep("load multiplayer", () => LoadScreen(multiplayerScreenStack = new TestMultiplayerScreenStack()));
+            AddUntilStep("wait for multiplayer to load", () => multiplayerScreenStack.IsLoaded);
+            AddUntilStep("wait for lounge to load", () => this.ChildrenOfType<MultiplayerLoungeSubScreen>().FirstOrDefault()?.IsLoaded == true);
+
+            AddUntilStep("wait for lounge", () => multiplayerScreenStack.ChildrenOfType<LoungeSubScreen>().SingleOrDefault()?.IsLoaded == true);
+            AddStep("open room", () => multiplayerScreenStack.ChildrenOfType<LoungeSubScreen>().Single().Open(new Room
+            {
+                Name = { Value = "Test Room" },
+                QueueMode = { Value = Mode },
+                Playlist =
+                {
+                    new PlaylistItem
+                    {
+                        Beatmap = { Value = importedBeatmap.Value.Beatmaps.First() },
+                        Ruleset = { Value = new OsuRuleset().RulesetInfo }
+                    }
+                }
+            }));
+
+            AddUntilStep("wait for room open", () => this.ChildrenOfType<MultiplayerMatchSubScreen>().FirstOrDefault()?.IsLoaded == true);
+            AddWaitStep("wait for transition", 2);
+
+            AddStep("create room", () =>
+            {
+                InputManager.MoveMouseTo(this.ChildrenOfType<MultiplayerMatchSettingsOverlay.CreateOrUpdateButton>().Single());
+                InputManager.Click(MouseButton.Left);
+            });
+
+            AddUntilStep("wait for join", () => client.Room != null);
+        }
+
+        [Test]
+        public void TestCreatedWithCorrectMode()
+        {
+            AddAssert("room created with correct mode", () => client.APIRoom?.QueueMode.Value == Mode);
+        }
+    }
+}
diff --git a/osu.Game.Tests/Visual/Multiplayer/QueueingModes/TestSceneHostOnlyQueueingMode.cs b/osu.Game.Tests/Visual/Multiplayer/QueueingModes/TestSceneHostOnlyQueueingMode.cs
new file mode 100644
index 0000000000..f643377221
--- /dev/null
+++ b/osu.Game.Tests/Visual/Multiplayer/QueueingModes/TestSceneHostOnlyQueueingMode.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 osu.Game.Online.Multiplayer.Queueing;
+
+namespace osu.Game.Tests.Visual.Multiplayer.QueueingModes
+{
+    public class TestSceneHostOnlyQueueingMode : QueueModeTestScene
+    {
+        protected override QueueModes Mode => QueueModes.HostOnly;
+    }
+}

From 54073d8a1e4b6f9294590c37b54c0eb87bd89b9c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 29 Oct 2021 13:02:19 +0900
Subject: [PATCH 0571/5547] Isolate score submissions model and remove
 serialisation from `ScoreInfo`

---
 .../Online/Solo/SubmitSoloScoreRequest.cs     | 64 ++++++++++++++++++-
 osu.Game/Scoring/ScoreInfo.cs                 | 43 ++-----------
 2 files changed, 68 insertions(+), 39 deletions(-)

diff --git a/osu.Game/Online/Solo/SubmitSoloScoreRequest.cs b/osu.Game/Online/Solo/SubmitSoloScoreRequest.cs
index 85fa3eeb34..184dbc911d 100644
--- a/osu.Game/Online/Solo/SubmitSoloScoreRequest.cs
+++ b/osu.Game/Online/Solo/SubmitSoloScoreRequest.cs
@@ -1,12 +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.Collections.Generic;
 using System.Net.Http;
 using Newtonsoft.Json;
+using Newtonsoft.Json.Converters;
 using osu.Framework.IO.Network;
 using osu.Game.Online.API;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Rooms;
+using osu.Game.Rulesets.Scoring;
 using osu.Game.Scoring;
+using osu.Game.Users;
 
 namespace osu.Game.Online.Solo
 {
@@ -16,13 +21,13 @@ namespace osu.Game.Online.Solo
 
         private readonly int beatmapId;
 
-        private readonly ScoreInfo scoreInfo;
+        private readonly SubmittableScore score;
 
         public SubmitSoloScoreRequest(int beatmapId, long scoreId, ScoreInfo scoreInfo)
         {
             this.beatmapId = beatmapId;
             this.scoreId = scoreId;
-            this.scoreInfo = scoreInfo;
+            score = new SubmittableScore(scoreInfo);
         }
 
         protected override WebRequest CreateWebRequest()
@@ -32,7 +37,7 @@ namespace osu.Game.Online.Solo
             req.ContentType = "application/json";
             req.Method = HttpMethod.Put;
 
-            req.AddRaw(JsonConvert.SerializeObject(scoreInfo, new JsonSerializerSettings
+            req.AddRaw(JsonConvert.SerializeObject(score, new JsonSerializerSettings
             {
                 ReferenceLoopHandling = ReferenceLoopHandling.Ignore
             }));
@@ -42,4 +47,57 @@ namespace osu.Game.Online.Solo
 
         protected override string Target => $@"beatmaps/{beatmapId}/solo/scores/{scoreId}";
     }
+
+    /// <summary>
+    /// A class specifically for sending scores to the API during score submission.
+    /// This is used instead of <see cref="APIScoreInfo"/> due to marginally different serialisation naming requirements.
+    /// </summary>
+    public class SubmittableScore
+    {
+        [JsonProperty("rank")]
+        [JsonConverter(typeof(StringEnumConverter))]
+        public ScoreRank Rank { get; }
+
+        [JsonProperty("total_score")]
+        public long TotalScore { get; }
+
+        [JsonProperty("accuracy")]
+        public double Accuracy { get; }
+
+        [JsonProperty(@"pp")]
+        public double? PP { get; }
+
+        [JsonProperty("max_combo")]
+        public int MaxCombo { get; }
+
+        [JsonProperty("ruleset_id")]
+        public int RulesetID { get; }
+
+        [JsonProperty("passed")]
+        public bool Passed { get; }
+
+        // Used for API serialisation/deserialisation.
+        [JsonProperty("mods")]
+        public APIMod[] Mods { get; }
+
+        [JsonProperty("user")]
+        public User User { get; }
+
+        [JsonProperty("statistics")]
+        public Dictionary<HitResult, int> Statistics { get; }
+
+        public SubmittableScore(ScoreInfo score)
+        {
+            Rank = score.Rank;
+            TotalScore = score.TotalScore;
+            Accuracy = score.Accuracy;
+            PP = score.PP;
+            MaxCombo = score.MaxCombo;
+            RulesetID = score.RulesetID;
+            Passed = score.Passed;
+            Mods = score.APIMods;
+            User = score.User;
+            Statistics = score.Statistics;
+        }
+    }
 }
diff --git a/osu.Game/Scoring/ScoreInfo.cs b/osu.Game/Scoring/ScoreInfo.cs
index 3b09669926..2747cd48c0 100644
--- a/osu.Game/Scoring/ScoreInfo.cs
+++ b/osu.Game/Scoring/ScoreInfo.cs
@@ -6,7 +6,6 @@ using System.Collections.Generic;
 using System.ComponentModel.DataAnnotations.Schema;
 using System.Linq;
 using Newtonsoft.Json;
-using Newtonsoft.Json.Converters;
 using osu.Framework.Localisation;
 using osu.Game.Beatmaps;
 using osu.Game.Database;
@@ -23,44 +22,32 @@ namespace osu.Game.Scoring
     {
         public int ID { get; set; }
 
-        [JsonProperty("rank")]
-        [JsonConverter(typeof(StringEnumConverter))]
         public ScoreRank Rank { get; set; }
 
-        [JsonProperty("total_score")]
         public long TotalScore { get; set; }
 
-        [JsonProperty("accuracy")]
         [Column(TypeName = "DECIMAL(1,4)")] // TODO: This data type is wrong (should contain more precision). But at the same time, we probably don't need to be storing this in the database.
         public double Accuracy { get; set; }
 
-        [JsonIgnore]
         public LocalisableString DisplayAccuracy => Accuracy.FormatAccuracy();
 
-        [JsonProperty(@"pp")]
         public double? PP { get; set; }
 
-        [JsonProperty("max_combo")]
         public int MaxCombo { get; set; }
 
-        [JsonIgnore]
         public int Combo { get; set; } // Todo: Shouldn't exist in here
 
-        [JsonProperty("ruleset_id")]
         public int RulesetID { get; set; }
 
-        [JsonProperty("passed")]
         [NotMapped]
         public bool Passed { get; set; } = true;
 
-        [JsonIgnore]
         public RulesetInfo Ruleset { get; set; }
 
         private APIMod[] localAPIMods;
 
         private Mod[] mods;
 
-        [JsonIgnore]
         [NotMapped]
         public Mod[] Mods
         {
@@ -75,7 +62,7 @@ namespace osu.Game.Scoring
                 if (mods != null)
                     scoreMods = mods;
                 else if (localAPIMods != null)
-                    scoreMods = apiMods.Select(m => m.ToMod(rulesetInstance)).ToArray();
+                    scoreMods = APIMods.Select(m => m.ToMod(rulesetInstance)).ToArray();
 
                 return scoreMods;
             }
@@ -87,9 +74,8 @@ namespace osu.Game.Scoring
         }
 
         // Used for API serialisation/deserialisation.
-        [JsonProperty("mods")]
         [NotMapped]
-        private APIMod[] apiMods
+        public APIMod[] APIMods
         {
             get
             {
@@ -111,19 +97,16 @@ namespace osu.Game.Scoring
         }
 
         // Used for database serialisation/deserialisation.
-        [JsonIgnore]
         [Column("Mods")]
         public string ModsJson
         {
-            get => JsonConvert.SerializeObject(apiMods);
-            set => apiMods = JsonConvert.DeserializeObject<APIMod[]>(value);
+            get => JsonConvert.SerializeObject(APIMods);
+            set => APIMods = JsonConvert.DeserializeObject<APIMod[]>(value);
         }
 
         [NotMapped]
-        [JsonProperty("user")]
         public User User { get; set; }
 
-        [JsonIgnore]
         [Column("User")]
         public string UserString
         {
@@ -135,7 +118,6 @@ namespace osu.Game.Scoring
             }
         }
 
-        [JsonIgnore]
         [Column("UserID")]
         public int? UserID
         {
@@ -147,23 +129,18 @@ namespace osu.Game.Scoring
             }
         }
 
-        [JsonIgnore]
         public int BeatmapInfoID { get; set; }
 
-        [JsonIgnore]
         [Column("Beatmap")]
-        public virtual BeatmapInfo BeatmapInfo { get; set; }
+        public BeatmapInfo BeatmapInfo { get; set; }
 
-        [JsonIgnore]
         public long? OnlineScoreID { get; set; }
 
-        [JsonIgnore]
         public DateTimeOffset Date { get; set; }
 
-        [JsonProperty("statistics")]
+        [NotMapped]
         public Dictionary<HitResult, int> Statistics { get; set; } = new Dictionary<HitResult, int>();
 
-        [JsonIgnore]
         [Column("Statistics")]
         public string StatisticsJson
         {
@@ -181,29 +158,23 @@ namespace osu.Game.Scoring
         }
 
         [NotMapped]
-        [JsonIgnore]
         public List<HitEvent> HitEvents { get; set; }
 
-        [JsonIgnore]
         public List<ScoreFileInfo> Files { get; set; }
 
-        [JsonIgnore]
         public string Hash { get; set; }
 
-        [JsonIgnore]
         public bool DeletePending { get; set; }
 
         /// <summary>
         /// The position of this score, starting at 1.
         /// </summary>
         [NotMapped]
-        [JsonProperty("position")]
-        public int? Position { get; set; }
+        public int? Position { get; set; } // TODO: remove after all calls to `CreateScoreInfo` are gone.
 
         /// <summary>
         /// Whether this <see cref="ScoreInfo"/> represents a legacy (osu!stable) score.
         /// </summary>
-        [JsonIgnore]
         [NotMapped]
         public bool IsLegacyScore => Mods.OfType<ModClassic>().Any();
 

From 3f030cebf4b2e36ff4d375a2a182d87e9c12eeb7 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 29 Oct 2021 14:14:25 +0900
Subject: [PATCH 0572/5547] Remove local score copying in `GetScoresRequest` to
 allow `APIScoreInfo.Beatmap` to be `APIBeatmap`

---
 .../Online/API/Requests/GetScoresRequest.cs   | 22 ----------------
 .../API/Requests/Responses/APIScoreInfo.cs    | 25 ++++++-------------
 .../Responses/APIScoreWithPosition.cs         |  5 ++--
 .../BeatmapSet/Scores/ScoresContainer.cs      |  4 +--
 osu.Game/Screens/Ranking/SoloResultsScreen.cs |  2 +-
 .../Select/Leaderboards/BeatmapLeaderboard.cs |  4 +--
 6 files changed, 16 insertions(+), 46 deletions(-)

diff --git a/osu.Game/Online/API/Requests/GetScoresRequest.cs b/osu.Game/Online/API/Requests/GetScoresRequest.cs
index 9037869c77..790a247ccb 100644
--- a/osu.Game/Online/API/Requests/GetScoresRequest.cs
+++ b/osu.Game/Online/API/Requests/GetScoresRequest.cs
@@ -9,7 +9,6 @@ using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets.Mods;
 using System.Text;
 using System.Collections.Generic;
-using System.Diagnostics;
 
 namespace osu.Game.Online.API.Requests
 {
@@ -32,27 +31,6 @@ namespace osu.Game.Online.API.Requests
             this.scope = scope;
             this.ruleset = ruleset ?? throw new ArgumentNullException(nameof(ruleset));
             this.mods = mods ?? Array.Empty<IMod>();
-
-            Success += onSuccess;
-        }
-
-        private void onSuccess(APIScoresCollection r)
-        {
-            Debug.Assert(ruleset.OnlineID >= 0);
-
-            foreach (APIScoreInfo score in r.Scores)
-            {
-                score.Beatmap = beatmapInfo;
-                score.OnlineRulesetID = ruleset.OnlineID;
-            }
-
-            var userScore = r.UserScore;
-
-            if (userScore != null)
-            {
-                userScore.Score.Beatmap = beatmapInfo;
-                userScore.Score.OnlineRulesetID = ruleset.OnlineID;
-            }
         }
 
         protected override string Target => $@"beatmaps/{beatmapInfo.OnlineBeatmapID}/scores{createQueryParameters()}";
diff --git a/osu.Game/Online/API/Requests/Responses/APIScoreInfo.cs b/osu.Game/Online/API/Requests/Responses/APIScoreInfo.cs
index 568c6bea7f..957d5991c8 100644
--- a/osu.Game/Online/API/Requests/Responses/APIScoreInfo.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIScoreInfo.cs
@@ -39,7 +39,7 @@ namespace osu.Game.Online.API.Requests.Responses
         public DateTimeOffset Date { get; set; }
 
         [JsonProperty(@"beatmap")]
-        public IBeatmapInfo Beatmap { get; set; }
+        public APIBeatmap Beatmap { get; set; }
 
         [JsonProperty("accuracy")]
         public double Accuracy { get; set; }
@@ -71,10 +71,8 @@ namespace osu.Game.Online.API.Requests.Responses
         [JsonConverter(typeof(StringEnumConverter))]
         public ScoreRank Rank { get; set; }
 
-        IBeatmapInfo IScoreInfo.Beatmap => Beatmap;
-
-        // TODO: nuke
-        public ScoreInfo CreateScoreInfo(RulesetStore rulesets)
+        // TODO: This function will eventually be going away.
+        public ScoreInfo CreateScoreInfo(RulesetStore rulesets, BeatmapInfo beatmap = null)
         {
             var ruleset = rulesets.GetRuleset(OnlineRulesetID);
 
@@ -94,7 +92,6 @@ namespace osu.Game.Online.API.Requests.Responses
                 OnlineScoreID = OnlineID,
                 Date = Date,
                 PP = PP,
-                BeatmapInfo = Beatmap.ToBeatmapInfo(rulesets),
                 RulesetID = OnlineRulesetID,
                 Hash = Replay ? "online" : string.Empty, // todo: temporary?
                 Rank = Rank,
@@ -102,6 +99,9 @@ namespace osu.Game.Online.API.Requests.Responses
                 Mods = mods,
             };
 
+            if (beatmap != null)
+                scoreInfo.BeatmapInfo = beatmap;
+
             if (Statistics != null)
             {
                 foreach (var kvp in Statistics)
@@ -138,19 +138,10 @@ namespace osu.Game.Online.API.Requests.Responses
             return scoreInfo;
         }
 
-        [JsonProperty(@"beatmapset")]
-        public APIBeatmapSet Metadata
-        {
-            set
-            {
-                // in the deserialisation case we need to ferry this data across.
-                if (Beatmap is APIBeatmap apiBeatmap)
-                    apiBeatmap.BeatmapSet = value;
-            }
-        }
-
         public IRulesetInfo Ruleset => new RulesetInfo { ID = OnlineRulesetID };
 
+        IBeatmapInfo IScoreInfo.Beatmap => Beatmap;
+
         Dictionary<HitResult, int> IScoreInfo.Statistics => new Dictionary<HitResult, int>(); // TODO: implement... maybe. hitresults have weird mappings per ruleset it would seem.
     }
 }
diff --git a/osu.Game/Online/API/Requests/Responses/APIScoreWithPosition.cs b/osu.Game/Online/API/Requests/Responses/APIScoreWithPosition.cs
index 89bb416393..a0fc549d98 100644
--- a/osu.Game/Online/API/Requests/Responses/APIScoreWithPosition.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIScoreWithPosition.cs
@@ -2,6 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using Newtonsoft.Json;
+using osu.Game.Beatmaps;
 using osu.Game.Rulesets;
 using osu.Game.Scoring;
 
@@ -15,10 +16,10 @@ namespace osu.Game.Online.API.Requests.Responses
         [JsonProperty(@"score")]
         public APIScoreInfo Score;
 
-        public ScoreInfo CreateScoreInfo(RulesetStore rulesets)
+        public ScoreInfo CreateScoreInfo(RulesetStore rulesets, BeatmapInfo beatmap = null)
 
         {
-            var score = Score.CreateScoreInfo(rulesets);
+            var score = Score.CreateScoreInfo(rulesets, beatmap);
             score.Position = Position;
             return score;
         }
diff --git a/osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.cs b/osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.cs
index 3a3566aad9..c6eb516c7c 100644
--- a/osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.cs
+++ b/osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.cs
@@ -66,7 +66,7 @@ namespace osu.Game.Overlays.BeatmapSet.Scores
                 if (value?.Scores.Any() != true)
                     return;
 
-                scoreManager.OrderByTotalScoreAsync(value.Scores.Select(s => s.CreateScoreInfo(rulesets)).ToArray(), loadCancellationSource.Token)
+                scoreManager.OrderByTotalScoreAsync(value.Scores.Select(s => s.CreateScoreInfo(rulesets, Beatmap.Value)).ToArray(), loadCancellationSource.Token)
                             .ContinueWith(ordered => Schedule(() =>
                             {
                                 if (loadCancellationSource.IsCancellationRequested)
@@ -78,7 +78,7 @@ namespace osu.Game.Overlays.BeatmapSet.Scores
                                 scoreTable.Show();
 
                                 var userScore = value.UserScore;
-                                var userScoreInfo = userScore?.Score.CreateScoreInfo(rulesets);
+                                var userScoreInfo = userScore?.Score.CreateScoreInfo(rulesets, Beatmap.Value);
 
                                 topScoresContainer.Add(new DrawableTopScore(topScore));
 
diff --git a/osu.Game/Screens/Ranking/SoloResultsScreen.cs b/osu.Game/Screens/Ranking/SoloResultsScreen.cs
index 684c7574cb..4f4dfa4909 100644
--- a/osu.Game/Screens/Ranking/SoloResultsScreen.cs
+++ b/osu.Game/Screens/Ranking/SoloResultsScreen.cs
@@ -31,7 +31,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.OnlineID != Score.OnlineScoreID).Select(s => s.CreateScoreInfo(rulesets)));
+            getScoreRequest.Success += r => scoresCallback?.Invoke(r.Scores.Where(s => s.OnlineID != Score.OnlineScoreID).Select(s => s.CreateScoreInfo(rulesets, Beatmap.Value.BeatmapInfo)));
             return getScoreRequest;
         }
 
diff --git a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
index 07300635aa..de1ba5cf2e 100644
--- a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
+++ b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
@@ -192,14 +192,14 @@ namespace osu.Game.Screens.Select.Leaderboards
 
             req.Success += r =>
             {
-                scoreManager.OrderByTotalScoreAsync(r.Scores.Select(s => s.CreateScoreInfo(rulesets)).ToArray(), loadCancellationSource.Token)
+                scoreManager.OrderByTotalScoreAsync(r.Scores.Select(s => s.CreateScoreInfo(rulesets, BeatmapInfo)).ToArray(), loadCancellationSource.Token)
                             .ContinueWith(ordered => Schedule(() =>
                             {
                                 if (loadCancellationSource.IsCancellationRequested)
                                     return;
 
                                 scoresCallback?.Invoke(ordered.Result);
-                                TopScore = r.UserScore?.CreateScoreInfo(rulesets);
+                                TopScore = r.UserScore?.CreateScoreInfo(rulesets, BeatmapInfo);
                             }), TaskContinuationOptions.OnlyOnRanToCompletion);
             };
 

From cd7bd935f6e4c4512a42f8a256d774f50bb1fff6 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 29 Oct 2021 14:18:10 +0900
Subject: [PATCH 0573/5547] Remove `Statistics` from interface until we figure
 how to properly deserialise

---
 osu.Game/Online/API/Requests/Responses/APIScoreInfo.cs | 3 ---
 osu.Game/Scoring/IScoreInfo.cs                         | 6 ++----
 2 files changed, 2 insertions(+), 7 deletions(-)

diff --git a/osu.Game/Online/API/Requests/Responses/APIScoreInfo.cs b/osu.Game/Online/API/Requests/Responses/APIScoreInfo.cs
index 957d5991c8..b996d21ad3 100644
--- a/osu.Game/Online/API/Requests/Responses/APIScoreInfo.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIScoreInfo.cs
@@ -9,7 +9,6 @@ using Newtonsoft.Json.Converters;
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Mods;
-using osu.Game.Rulesets.Scoring;
 using osu.Game.Scoring;
 using osu.Game.Scoring.Legacy;
 using osu.Game.Users;
@@ -141,7 +140,5 @@ namespace osu.Game.Online.API.Requests.Responses
         public IRulesetInfo Ruleset => new RulesetInfo { ID = OnlineRulesetID };
 
         IBeatmapInfo IScoreInfo.Beatmap => Beatmap;
-
-        Dictionary<HitResult, int> IScoreInfo.Statistics => new Dictionary<HitResult, int>(); // TODO: implement... maybe. hitresults have weird mappings per ruleset it would seem.
     }
 }
diff --git a/osu.Game/Scoring/IScoreInfo.cs b/osu.Game/Scoring/IScoreInfo.cs
index b230babf3c..171964206d 100644
--- a/osu.Game/Scoring/IScoreInfo.cs
+++ b/osu.Game/Scoring/IScoreInfo.cs
@@ -2,11 +2,9 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
-using System.Collections.Generic;
 using osu.Game.Beatmaps;
 using osu.Game.Database;
 using osu.Game.Rulesets;
-using osu.Game.Rulesets.Scoring;
 using osu.Game.Users;
 
 namespace osu.Game.Scoring
@@ -29,13 +27,13 @@ namespace osu.Game.Scoring
 
         IBeatmapInfo Beatmap { get; }
 
-        Dictionary<HitResult, int> Statistics { get; }
-
         IRulesetInfo Ruleset { get; }
 
         public ScoreRank Rank { get; }
 
         // Mods is currently missing from this interface as the `IMod` class has properties which can't be fulfilled by `APIMod`,
         // but also doesn't expose `Settings`. We can consider how to implement this in the future if required.
+
+        // Statistics is also missing. This can be reconsidered once changes in serialisation have been completed.
     }
 }

From f68d6dbc8f3c0665468dce17ccf1f8f7ee6d4224 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 29 Oct 2021 14:32:31 +0900
Subject: [PATCH 0574/5547] Update score submission serialisation tests to use
 `SubmittableScore`

---
 .../Online/TestAPIModJsonSerialization.cs     | 23 +++---
 .../Online/Solo/SubmitSoloScoreRequest.cs     | 58 --------------
 osu.Game/Online/Solo/SubmittableScore.cs      | 75 +++++++++++++++++++
 3 files changed, 84 insertions(+), 72 deletions(-)
 create mode 100644 osu.Game/Online/Solo/SubmittableScore.cs

diff --git a/osu.Game.Tests/Online/TestAPIModJsonSerialization.cs b/osu.Game.Tests/Online/TestAPIModJsonSerialization.cs
index ad2007f202..c8848ab7d8 100644
--- a/osu.Game.Tests/Online/TestAPIModJsonSerialization.cs
+++ b/osu.Game.Tests/Online/TestAPIModJsonSerialization.cs
@@ -8,6 +8,7 @@ using osu.Framework.Bindables;
 using osu.Game.Beatmaps;
 using osu.Game.Configuration;
 using osu.Game.Online.API;
+using osu.Game.Online.Solo;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Difficulty;
 using osu.Game.Rulesets.Mods;
@@ -88,33 +89,27 @@ namespace osu.Game.Tests.Online
         }
 
         [Test]
-        public void TestDeserialiseScoreInfoWithEmptyMods()
+        public void TestDeserialiseSubmittableScoreWithEmptyMods()
         {
-            var score = new ScoreInfo { Ruleset = new OsuRuleset().RulesetInfo };
+            var score = new SubmittableScore(new ScoreInfo { Ruleset = new OsuRuleset().RulesetInfo });
 
-            var deserialised = JsonConvert.DeserializeObject<ScoreInfo>(JsonConvert.SerializeObject(score));
-
-            if (deserialised != null)
-                deserialised.Ruleset = new OsuRuleset().RulesetInfo;
+            var deserialised = JsonConvert.DeserializeObject<SubmittableScore>(JsonConvert.SerializeObject(score));
 
             Assert.That(deserialised?.Mods.Length, Is.Zero);
         }
 
         [Test]
-        public void TestDeserialiseScoreInfoWithCustomModSetting()
+        public void TestDeserialiseSubmittableScoreWithCustomModSetting()
         {
-            var score = new ScoreInfo
+            var score = new SubmittableScore(new ScoreInfo
             {
                 Ruleset = new OsuRuleset().RulesetInfo,
                 Mods = new Mod[] { new OsuModDoubleTime { SpeedChange = { Value = 2 } } }
-            };
+            });
 
-            var deserialised = JsonConvert.DeserializeObject<ScoreInfo>(JsonConvert.SerializeObject(score));
+            var deserialised = JsonConvert.DeserializeObject<SubmittableScore>(JsonConvert.SerializeObject(score));
 
-            if (deserialised != null)
-                deserialised.Ruleset = new OsuRuleset().RulesetInfo;
-
-            Assert.That(((OsuModDoubleTime)deserialised?.Mods[0])?.SpeedChange.Value, Is.EqualTo(2));
+            Assert.That((deserialised?.Mods[0])?.Settings["speed_change"], Is.EqualTo(2));
         }
 
         private class TestRuleset : Ruleset
diff --git a/osu.Game/Online/Solo/SubmitSoloScoreRequest.cs b/osu.Game/Online/Solo/SubmitSoloScoreRequest.cs
index 184dbc911d..25c2e5a61f 100644
--- a/osu.Game/Online/Solo/SubmitSoloScoreRequest.cs
+++ b/osu.Game/Online/Solo/SubmitSoloScoreRequest.cs
@@ -1,17 +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.Collections.Generic;
 using System.Net.Http;
 using Newtonsoft.Json;
-using Newtonsoft.Json.Converters;
 using osu.Framework.IO.Network;
 using osu.Game.Online.API;
-using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Rooms;
-using osu.Game.Rulesets.Scoring;
 using osu.Game.Scoring;
-using osu.Game.Users;
 
 namespace osu.Game.Online.Solo
 {
@@ -47,57 +42,4 @@ namespace osu.Game.Online.Solo
 
         protected override string Target => $@"beatmaps/{beatmapId}/solo/scores/{scoreId}";
     }
-
-    /// <summary>
-    /// A class specifically for sending scores to the API during score submission.
-    /// This is used instead of <see cref="APIScoreInfo"/> due to marginally different serialisation naming requirements.
-    /// </summary>
-    public class SubmittableScore
-    {
-        [JsonProperty("rank")]
-        [JsonConverter(typeof(StringEnumConverter))]
-        public ScoreRank Rank { get; }
-
-        [JsonProperty("total_score")]
-        public long TotalScore { get; }
-
-        [JsonProperty("accuracy")]
-        public double Accuracy { get; }
-
-        [JsonProperty(@"pp")]
-        public double? PP { get; }
-
-        [JsonProperty("max_combo")]
-        public int MaxCombo { get; }
-
-        [JsonProperty("ruleset_id")]
-        public int RulesetID { get; }
-
-        [JsonProperty("passed")]
-        public bool Passed { get; }
-
-        // Used for API serialisation/deserialisation.
-        [JsonProperty("mods")]
-        public APIMod[] Mods { get; }
-
-        [JsonProperty("user")]
-        public User User { get; }
-
-        [JsonProperty("statistics")]
-        public Dictionary<HitResult, int> Statistics { get; }
-
-        public SubmittableScore(ScoreInfo score)
-        {
-            Rank = score.Rank;
-            TotalScore = score.TotalScore;
-            Accuracy = score.Accuracy;
-            PP = score.PP;
-            MaxCombo = score.MaxCombo;
-            RulesetID = score.RulesetID;
-            Passed = score.Passed;
-            Mods = score.APIMods;
-            User = score.User;
-            Statistics = score.Statistics;
-        }
-    }
 }
diff --git a/osu.Game/Online/Solo/SubmittableScore.cs b/osu.Game/Online/Solo/SubmittableScore.cs
new file mode 100644
index 0000000000..bafb308a13
--- /dev/null
+++ b/osu.Game/Online/Solo/SubmittableScore.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 System;
+using System.Collections.Generic;
+using JetBrains.Annotations;
+using Newtonsoft.Json;
+using Newtonsoft.Json.Converters;
+using osu.Game.Online.API;
+using osu.Game.Online.API.Requests.Responses;
+using osu.Game.Rulesets.Scoring;
+using osu.Game.Scoring;
+using osu.Game.Users;
+
+namespace osu.Game.Online.Solo
+{
+    /// <summary>
+    /// A class specifically for sending scores to the API during score submission.
+    /// This is used instead of <see cref="APIScoreInfo"/> due to marginally different serialisation naming requirements.
+    /// </summary>
+    [Serializable]
+    public class SubmittableScore
+    {
+        [JsonProperty("rank")]
+        [JsonConverter(typeof(StringEnumConverter))]
+        public ScoreRank Rank { get; set; }
+
+        [JsonProperty("total_score")]
+        public long TotalScore { get; set; }
+
+        [JsonProperty("accuracy")]
+        public double Accuracy { get; set; }
+
+        [JsonProperty(@"pp")]
+        public double? PP { get; set; }
+
+        [JsonProperty("max_combo")]
+        public int MaxCombo { get; set; }
+
+        [JsonProperty("ruleset_id")]
+        public int RulesetID { get; set; }
+
+        [JsonProperty("passed")]
+        public bool Passed { get; set; }
+
+        // Used for API serialisation/deserialisation.
+        [JsonProperty("mods")]
+        public APIMod[] Mods { get; set; }
+
+        [JsonProperty("user")]
+        public User User { get; set; }
+
+        [JsonProperty("statistics")]
+        public Dictionary<HitResult, int> Statistics { get; set; }
+
+        [UsedImplicitly]
+        public SubmittableScore()
+        {
+        }
+
+        public SubmittableScore(ScoreInfo score)
+        {
+            Rank = score.Rank;
+            TotalScore = score.TotalScore;
+            Accuracy = score.Accuracy;
+            PP = score.PP;
+            MaxCombo = score.MaxCombo;
+            RulesetID = score.RulesetID;
+            Passed = score.Passed;
+            Mods = score.APIMods;
+            User = score.User;
+            Statistics = score.Statistics;
+        }
+    }
+}

From 06b6bcfd29a355b8a7ca89d2f2febafc74ca98d2 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 29 Oct 2021 14:51:06 +0900
Subject: [PATCH 0575/5547] Add xmldoc for `CreateScoreInfo` function for now

I don't actually know how temporary this one is going to be. The usages
are quite deep - ie. converting to a `ScoreInfo` to get a calculated
total score for ordering purposes.
---
 osu.Game/Online/API/Requests/Responses/APIScoreInfo.cs | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Online/API/Requests/Responses/APIScoreInfo.cs b/osu.Game/Online/API/Requests/Responses/APIScoreInfo.cs
index b996d21ad3..4abb227414 100644
--- a/osu.Game/Online/API/Requests/Responses/APIScoreInfo.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIScoreInfo.cs
@@ -70,7 +70,12 @@ namespace osu.Game.Online.API.Requests.Responses
         [JsonConverter(typeof(StringEnumConverter))]
         public ScoreRank Rank { get; set; }
 
-        // TODO: This function will eventually be going away.
+        /// <summary>
+        /// Create a <see cref="ScoreInfo"/> from an API score instance.
+        /// </summary>
+        /// <param name="rulesets">A ruleset store, used to populate a ruleset instance in the returned score.</param>
+        /// <param name="beatmap">An optional beatmap, copied into the returned score (for cases where the API does not populate the beatmap).</param>
+        /// <returns></returns>
         public ScoreInfo CreateScoreInfo(RulesetStore rulesets, BeatmapInfo beatmap = null)
         {
             var ruleset = rulesets.GetRuleset(OnlineRulesetID);

From 17a83f701a0e021f048cdf7567a316f2486591a4 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 29 Oct 2021 15:13:33 +0900
Subject: [PATCH 0576/5547] Store mods as `APIMods` for the time being

---
 .../Gameplay/TestSceneReplayDownloadButton.cs  |  2 +-
 .../API/Requests/Responses/APIScoreInfo.cs     | 18 ++++++++++--------
 2 files changed, 11 insertions(+), 9 deletions(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneReplayDownloadButton.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneReplayDownloadButton.cs
index b84ac6c2f1..2f9b03e86e 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneReplayDownloadButton.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneReplayDownloadButton.cs
@@ -135,7 +135,7 @@ namespace osu.Game.Tests.Visual.Gameplay
             return new APIScoreInfo
             {
                 OnlineID = 2553163309,
-                OnlineRulesetID = 0,
+                RulesetID = 0,
                 Replay = replayAvailable,
                 User = new User
                 {
diff --git a/osu.Game/Online/API/Requests/Responses/APIScoreInfo.cs b/osu.Game/Online/API/Requests/Responses/APIScoreInfo.cs
index 4abb227414..448156b63a 100644
--- a/osu.Game/Online/API/Requests/Responses/APIScoreInfo.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIScoreInfo.cs
@@ -61,10 +61,12 @@ namespace osu.Game.Online.API.Requests.Responses
         public Dictionary<string, int> Statistics { get; set; }
 
         [JsonProperty(@"mode_int")]
-        public int OnlineRulesetID { get; set; }
+        public int RulesetID { get; set; }
 
         [JsonProperty(@"mods")]
-        public string[] Mods { get; set; }
+        private string[] mods { set => Mods = value.Select(acronym => new APIMod { Acronym = acronym }); }
+
+        public IEnumerable<APIMod> Mods { get; set; }
 
         [JsonProperty("rank")]
         [JsonConverter(typeof(StringEnumConverter))]
@@ -78,14 +80,14 @@ namespace osu.Game.Online.API.Requests.Responses
         /// <returns></returns>
         public ScoreInfo CreateScoreInfo(RulesetStore rulesets, BeatmapInfo beatmap = null)
         {
-            var ruleset = rulesets.GetRuleset(OnlineRulesetID);
+            var ruleset = rulesets.GetRuleset(RulesetID);
 
             var rulesetInstance = ruleset.CreateInstance();
 
-            var mods = Mods != null ? Mods.Select(acronym => rulesetInstance.CreateModFromAcronym(acronym)).Where(m => m != null).ToArray() : Array.Empty<Mod>();
+            var modInstances = Mods != null ? Mods.Select(apiMod => rulesetInstance.CreateModFromAcronym(apiMod.Acronym)).Where(m => m != null).ToArray() : Array.Empty<Mod>();
 
             // all API scores provided by this class are considered to be legacy.
-            mods = mods.Append(rulesetInstance.CreateMod<ModClassic>()).ToArray();
+            modInstances = modInstances.Append(rulesetInstance.CreateMod<ModClassic>()).ToArray();
 
             var scoreInfo = new ScoreInfo
             {
@@ -96,11 +98,11 @@ namespace osu.Game.Online.API.Requests.Responses
                 OnlineScoreID = OnlineID,
                 Date = Date,
                 PP = PP,
-                RulesetID = OnlineRulesetID,
+                RulesetID = RulesetID,
                 Hash = Replay ? "online" : string.Empty, // todo: temporary?
                 Rank = Rank,
                 Ruleset = ruleset,
-                Mods = mods,
+                Mods = modInstances,
             };
 
             if (beatmap != null)
@@ -142,7 +144,7 @@ namespace osu.Game.Online.API.Requests.Responses
             return scoreInfo;
         }
 
-        public IRulesetInfo Ruleset => new RulesetInfo { ID = OnlineRulesetID };
+        public IRulesetInfo Ruleset => new RulesetInfo { ID = RulesetID };
 
         IBeatmapInfo IScoreInfo.Beatmap => Beatmap;
     }

From 31403daa2078b5023a91958d919d273b9dbef1a9 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 29 Oct 2021 15:14:52 +0900
Subject: [PATCH 0577/5547] Change `DrawableProfileScore` to use `APIScoreInfo`

---
 .../Visual/Online/TestSceneScoresContainer.cs | 29 ++++----
 .../Online/TestSceneUserProfileScores.cs      | 72 +++++++++----------
 .../Sections/Ranks/DrawableProfileScore.cs    | 18 ++---
 .../Ranks/DrawableProfileWeightedScore.cs     |  4 +-
 .../Sections/Ranks/PaginatedScoreContainer.cs |  4 +-
 5 files changed, 65 insertions(+), 62 deletions(-)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneScoresContainer.cs b/osu.Game.Tests/Visual/Online/TestSceneScoresContainer.cs
index 991be33917..23899154c4 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneScoresContainer.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneScoresContainer.cs
@@ -7,6 +7,7 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Utils;
+using osu.Game.Online.API;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays;
 using osu.Game.Overlays.BeatmapSet.Scores;
@@ -61,10 +62,10 @@ namespace osu.Game.Tests.Visual.Online
                         },
                         Mods = new[]
                         {
-                            new OsuModDoubleTime().Acronym,
-                            new OsuModHidden().Acronym,
-                            new OsuModFlashlight().Acronym,
-                            new OsuModHardRock().Acronym,
+                            new APIMod { Acronym = new OsuModDoubleTime().Acronym },
+                            new APIMod { Acronym = new OsuModHidden().Acronym },
+                            new APIMod { Acronym = new OsuModFlashlight().Acronym },
+                            new APIMod { Acronym = new OsuModHardRock().Acronym },
                         },
                         Rank = ScoreRank.XH,
                         PP = 200,
@@ -86,9 +87,9 @@ namespace osu.Game.Tests.Visual.Online
                         },
                         Mods = new[]
                         {
-                            new OsuModDoubleTime().Acronym,
-                            new OsuModHidden().Acronym,
-                            new OsuModFlashlight().Acronym,
+                            new APIMod { Acronym = new OsuModDoubleTime().Acronym },
+                            new APIMod { Acronym = new OsuModHidden().Acronym },
+                            new APIMod { Acronym = new OsuModFlashlight().Acronym },
                         },
                         Rank = ScoreRank.S,
                         PP = 190,
@@ -110,8 +111,8 @@ namespace osu.Game.Tests.Visual.Online
                         },
                         Mods = new[]
                         {
-                            new OsuModDoubleTime().Acronym,
-                            new OsuModHidden().Acronym,
+                            new APIMod { Acronym = new OsuModDoubleTime().Acronym },
+                            new APIMod { Acronym = new OsuModHidden().Acronym },
                         },
                         Rank = ScoreRank.B,
                         PP = 180,
@@ -133,7 +134,7 @@ namespace osu.Game.Tests.Visual.Online
                         },
                         Mods = new[]
                         {
-                            new OsuModDoubleTime().Acronym,
+                            new APIMod { Acronym = new OsuModDoubleTime().Acronym },
                         },
                         Rank = ScoreRank.C,
                         PP = 170,
@@ -226,10 +227,10 @@ namespace osu.Game.Tests.Visual.Online
                         },
                         Mods = new[]
                         {
-                            new OsuModDoubleTime().Acronym,
-                            new OsuModHidden().Acronym,
-                            new OsuModFlashlight().Acronym,
-                            new OsuModHardRock().Acronym,
+                            new APIMod { Acronym = new OsuModDoubleTime().Acronym },
+                            new APIMod { Acronym = new OsuModHidden().Acronym },
+                            new APIMod { Acronym = new OsuModFlashlight().Acronym },
+                            new APIMod { Acronym = new OsuModHardRock().Acronym },
                         },
                         Rank = ScoreRank.XH,
                         PP = 200,
diff --git a/osu.Game.Tests/Visual/Online/TestSceneUserProfileScores.cs b/osu.Game.Tests/Visual/Online/TestSceneUserProfileScores.cs
index 513631a221..fac350ea57 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneUserProfileScores.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneUserProfileScores.cs
@@ -2,16 +2,16 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
-using osu.Game.Overlays.Profile.Sections.Ranks;
-using osu.Framework.Graphics;
-using osu.Game.Scoring;
-using osu.Framework.Graphics.Containers;
-using osuTK;
-using osu.Game.Beatmaps;
-using osu.Game.Rulesets.Mods;
-using osu.Game.Rulesets.Osu.Mods;
-using osu.Game.Overlays;
 using osu.Framework.Allocation;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
+using osu.Game.Online.API;
+using osu.Game.Online.API.Requests.Responses;
+using osu.Game.Overlays;
+using osu.Game.Overlays.Profile.Sections.Ranks;
+using osu.Game.Rulesets.Osu.Mods;
+using osu.Game.Scoring;
+using osuTK;
 
 namespace osu.Game.Tests.Visual.Online
 {
@@ -19,79 +19,79 @@ namespace osu.Game.Tests.Visual.Online
     {
         public TestSceneUserProfileScores()
         {
-            var firstScore = new ScoreInfo
+            var firstScore = new APIScoreInfo
             {
                 PP = 1047.21,
                 Rank = ScoreRank.SH,
-                BeatmapInfo = new BeatmapInfo
+                Beatmap = new APIBeatmap
                 {
-                    Metadata = new BeatmapMetadata
+                    BeatmapSet =
                     {
                         Title = "JUSTadICE (TV Size)",
-                        Artist = "Oomori Seiko"
+                        Artist = "Oomori Seiko",
                     },
-                    Version = "Extreme"
+                    DifficultyName = "Extreme"
                 },
                 Date = DateTimeOffset.Now,
-                Mods = new Mod[]
+                Mods = new[]
                 {
-                    new OsuModHidden(),
-                    new OsuModHardRock(),
-                    new OsuModDoubleTime()
+                    new APIMod { Acronym = new OsuModHidden().Acronym },
+                    new APIMod { Acronym = new OsuModHardRock().Acronym },
+                    new APIMod { Acronym = new OsuModDoubleTime().Acronym },
                 },
                 Accuracy = 0.9813
             };
 
-            var secondScore = new ScoreInfo
+            var secondScore = new APIScoreInfo
             {
                 PP = 134.32,
                 Rank = ScoreRank.A,
-                BeatmapInfo = new BeatmapInfo
+                Beatmap = new APIBeatmap
                 {
-                    Metadata = new BeatmapMetadata
+                    BeatmapSet =
                     {
                         Title = "Triumph & Regret",
-                        Artist = "typeMARS"
+                        Artist = "typeMARS",
                     },
-                    Version = "[4K] Regret"
+                    DifficultyName = "[4K] Regret"
                 },
                 Date = DateTimeOffset.Now,
-                Mods = new Mod[]
+                Mods = new[]
                 {
-                    new OsuModHardRock(),
-                    new OsuModDoubleTime(),
+                    new APIMod { Acronym = new OsuModHardRock().Acronym },
+                    new APIMod { Acronym = new OsuModDoubleTime().Acronym },
                 },
                 Accuracy = 0.998546
             };
 
-            var thirdScore = new ScoreInfo
+            var thirdScore = new APIScoreInfo
             {
                 PP = 96.83,
                 Rank = ScoreRank.S,
-                BeatmapInfo = new BeatmapInfo
+                Beatmap = new APIBeatmap
                 {
-                    Metadata = new BeatmapMetadata
+                    BeatmapSet =
                     {
                         Title = "Idolize",
-                        Artist = "Creo"
+                        Artist = "Creo",
                     },
-                    Version = "Insane"
+                    DifficultyName = "Insane"
                 },
                 Date = DateTimeOffset.Now,
                 Accuracy = 0.9726
             };
 
-            var noPPScore = new ScoreInfo
+            var noPPScore = new APIScoreInfo
             {
                 Rank = ScoreRank.B,
-                BeatmapInfo = new BeatmapInfo
+                Beatmap = new APIBeatmap
                 {
-                    Metadata = new BeatmapMetadata
+                    BeatmapSet =
                     {
                         Title = "C18H27NO3(extend)",
-                        Artist = "Team Grimoire"
+                        Artist = "Team Grimoire",
                     },
-                    Version = "[4K] Cataclysmic Hypernova"
+                    DifficultyName = "[4K] Cataclysmic Hypernova"
                 },
                 Date = DateTimeOffset.Now,
                 Accuracy = 0.55879
diff --git a/osu.Game/Overlays/Profile/Sections/Ranks/DrawableProfileScore.cs b/osu.Game/Overlays/Profile/Sections/Ranks/DrawableProfileScore.cs
index 7bfa2ee51e..ca5534dbc2 100644
--- a/osu.Game/Overlays/Profile/Sections/Ranks/DrawableProfileScore.cs
+++ b/osu.Game/Overlays/Profile/Sections/Ranks/DrawableProfileScore.cs
@@ -12,9 +12,11 @@ using osu.Framework.Localisation;
 using osu.Game.Beatmaps;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Leaderboards;
+using osu.Game.Rulesets;
 using osu.Game.Rulesets.UI;
-using osu.Game.Scoring;
+using osu.Game.Utils;
 using osuTK;
 
 namespace osu.Game.Overlays.Profile.Sections.Ranks
@@ -26,7 +28,7 @@ namespace osu.Game.Overlays.Profile.Sections.Ranks
 
         private const float performance_background_shear = 0.45f;
 
-        protected readonly ScoreInfo Score;
+        protected readonly APIScoreInfo Score;
 
         [Resolved]
         private OsuColour colours { get; set; }
@@ -34,7 +36,7 @@ namespace osu.Game.Overlays.Profile.Sections.Ranks
         [Resolved]
         private OverlayColourProvider colourProvider { get; set; }
 
-        public DrawableProfileScore(ScoreInfo score)
+        public DrawableProfileScore(APIScoreInfo score)
         {
             Score = score;
 
@@ -43,7 +45,7 @@ namespace osu.Game.Overlays.Profile.Sections.Ranks
         }
 
         [BackgroundDependencyLoader]
-        private void load()
+        private void load(RulesetStore rulesets)
         {
             AddInternal(new ProfileItemContainer
             {
@@ -79,7 +81,7 @@ namespace osu.Game.Overlays.Profile.Sections.Ranks
                                         Spacing = new Vector2(0, 2),
                                         Children = new Drawable[]
                                         {
-                                            new ScoreBeatmapMetadataContainer(Score.BeatmapInfo),
+                                            new ScoreBeatmapMetadataContainer(Score.Beatmap),
                                             new FillFlowContainer
                                             {
                                                 AutoSizeAxes = Axes.Both,
@@ -89,7 +91,7 @@ namespace osu.Game.Overlays.Profile.Sections.Ranks
                                                 {
                                                     new OsuSpriteText
                                                     {
-                                                        Text = $"{Score.BeatmapInfo.Version}",
+                                                        Text = $"{Score.Beatmap.DifficultyName}",
                                                         Font = OsuFont.GetFont(size: 12, weight: FontWeight.Regular),
                                                         Colour = colours.Yellow
                                                     },
@@ -129,7 +131,7 @@ namespace osu.Game.Overlays.Profile.Sections.Ranks
                                         Origin = Anchor.CentreRight,
                                         Direction = FillDirection.Horizontal,
                                         Spacing = new Vector2(2),
-                                        Children = Score.Mods.Select(mod => new ModIcon(mod)
+                                        Children = Score.Mods.Select(mod => new ModIcon(rulesets.GetRuleset(Score.RulesetID).CreateInstance().CreateModFromAcronym(mod.Acronym))
                                         {
                                             Scale = new Vector2(0.35f)
                                         }).ToList(),
@@ -198,7 +200,7 @@ namespace osu.Game.Overlays.Profile.Sections.Ranks
             RelativeSizeAxes = Axes.Y,
             Child = new OsuSpriteText
             {
-                Text = Score.DisplayAccuracy,
+                Text = Score.Accuracy.FormatAccuracy(),
                 Font = OsuFont.GetFont(size: 14, weight: FontWeight.Bold, italics: true),
                 Colour = colours.Yellow,
                 Anchor = Anchor.CentreLeft,
diff --git a/osu.Game/Overlays/Profile/Sections/Ranks/DrawableProfileWeightedScore.cs b/osu.Game/Overlays/Profile/Sections/Ranks/DrawableProfileWeightedScore.cs
index f77464ecb9..e653be5cfa 100644
--- a/osu.Game/Overlays/Profile/Sections/Ranks/DrawableProfileWeightedScore.cs
+++ b/osu.Game/Overlays/Profile/Sections/Ranks/DrawableProfileWeightedScore.cs
@@ -6,8 +6,8 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Resources.Localisation.Web;
-using osu.Game.Scoring;
 using osuTK;
 
 namespace osu.Game.Overlays.Profile.Sections.Ranks
@@ -16,7 +16,7 @@ namespace osu.Game.Overlays.Profile.Sections.Ranks
     {
         private readonly double weight;
 
-        public DrawableProfileWeightedScore(ScoreInfo score, double weight)
+        public DrawableProfileWeightedScore(APIScoreInfo score, double weight)
             : base(score)
         {
             this.weight = weight;
diff --git a/osu.Game/Overlays/Profile/Sections/Ranks/PaginatedScoreContainer.cs b/osu.Game/Overlays/Profile/Sections/Ranks/PaginatedScoreContainer.cs
index 1fb6100a28..cde386bc7b 100644
--- a/osu.Game/Overlays/Profile/Sections/Ranks/PaginatedScoreContainer.cs
+++ b/osu.Game/Overlays/Profile/Sections/Ranks/PaginatedScoreContainer.cs
@@ -69,10 +69,10 @@ namespace osu.Game.Overlays.Profile.Sections.Ranks
             switch (type)
             {
                 default:
-                    return new DrawableProfileScore(model.CreateScoreInfo(Rulesets));
+                    return new DrawableProfileScore(model);
 
                 case ScoreType.Best:
-                    return new DrawableProfileWeightedScore(model.CreateScoreInfo(Rulesets), Math.Pow(0.95, drawableItemIndex++));
+                    return new DrawableProfileWeightedScore(model, Math.Pow(0.95, drawableItemIndex++));
             }
         }
     }

From 42dfb341daa7a94bb66934dfb24ab670e7ee6f46 Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Fri, 29 Oct 2021 15:44:42 +0900
Subject: [PATCH 0578/5547] Fix PlaylistItemChanged() not updating current item

---
 osu.Game/Online/Multiplayer/MultiplayerClient.cs | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/osu.Game/Online/Multiplayer/MultiplayerClient.cs b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
index 6b1042df2d..cdf6684112 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
@@ -625,6 +625,10 @@ namespace osu.Game.Online.Multiplayer
                 int index = APIRoom.Playlist.Select((i, index) => (i, index)).Single(kvp => kvp.i.ID == item.ID).index;
                 APIRoom.Playlist.RemoveAt(index);
                 APIRoom.Playlist.Insert(index, playlistItem);
+
+                // If the current item changed, update the selected playlist item.
+                if (item.ID == Room.Settings.PlaylistItemId)
+                    CurrentMatchPlayingItem.Value = APIRoom.Playlist[index];
             }).ConfigureAwait(false);
         }
 

From e667ef4eea9a21e2cbe1b0f9fbfe0ad57662d2cf Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Fri, 29 Oct 2021 15:44:48 +0900
Subject: [PATCH 0579/5547] Add basic tests

---
 .../QueueingModes/QueueModeTestScene.cs       | 60 +++++++++++++------
 .../TestSceneHostOnlyQueueingMode.cs          | 53 ++++++++++++++++
 .../Multiplayer/MultiplayerMatchSubScreen.cs  | 14 ++---
 .../Screens/OnlinePlay/OnlinePlayScreen.cs    |  2 +-
 4 files changed, 102 insertions(+), 27 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/QueueingModes/QueueModeTestScene.cs b/osu.Game.Tests/Visual/Multiplayer/QueueingModes/QueueModeTestScene.cs
index 0480e3bb78..cea90ff12d 100644
--- a/osu.Game.Tests/Visual/Multiplayer/QueueingModes/QueueModeTestScene.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/QueueingModes/QueueModeTestScene.cs
@@ -6,9 +6,11 @@ using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
 using osu.Framework.Platform;
+using osu.Framework.Screens;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
 using osu.Game.Database;
+using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Multiplayer.Queueing;
 using osu.Game.Online.Rooms;
 using osu.Game.Rulesets;
@@ -16,6 +18,8 @@ using osu.Game.Rulesets.Osu;
 using osu.Game.Screens.OnlinePlay.Lounge;
 using osu.Game.Screens.OnlinePlay.Multiplayer;
 using osu.Game.Screens.OnlinePlay.Multiplayer.Match;
+using osu.Game.Screens.Play;
+using osu.Game.Tests.Resources;
 using osuTK.Input;
 
 namespace osu.Game.Tests.Visual.Multiplayer.QueueingModes
@@ -24,14 +28,20 @@ namespace osu.Game.Tests.Visual.Multiplayer.QueueingModes
     {
         protected abstract QueueModes Mode { get; }
 
+        protected BeatmapInfo InitialBeatmap { get; private set; }
+        protected BeatmapInfo OtherBeatmap { get; private set; }
+
+        protected IScreen CurrentScreen => multiplayerScreenStack.CurrentScreen;
+        protected IScreen CurrentSubScreen => multiplayerScreenStack.MultiplayerScreen.CurrentSubScreen;
+
         private BeatmapManager beatmaps;
         private RulesetStore rulesets;
-        private ILive<BeatmapSetInfo> importedBeatmap;
+        private BeatmapSetInfo importedSet;
 
         private TestMultiplayerScreenStack multiplayerScreenStack;
 
-        private TestMultiplayerClient client => multiplayerScreenStack.Client;
-        private TestMultiplayerRoomManager roomManager => multiplayerScreenStack.RoomManager;
+        protected TestMultiplayerClient Client => multiplayerScreenStack.Client;
+        protected TestMultiplayerRoomManager RoomManager => multiplayerScreenStack.RoomManager;
 
         [Cached(typeof(UserLookupCache))]
         private UserLookupCache lookupCache = new TestUserLookupCache();
@@ -49,18 +59,10 @@ namespace osu.Game.Tests.Visual.Multiplayer.QueueingModes
 
             AddStep("import beatmap", () =>
             {
-                var beatmap1 = CreateBeatmap(new OsuRuleset().RulesetInfo).BeatmapInfo;
-                beatmap1.Version = "1";
-
-                var beatmap2 = CreateBeatmap(new OsuRuleset().RulesetInfo).BeatmapInfo;
-                beatmap2.Version = "2";
-
-                // Move beatmap2 to beatmap1's set.
-                var beatmapSet = beatmap1.BeatmapSet;
-                beatmapSet.Beatmaps.Add(beatmap2);
-                beatmap2.BeatmapSet = beatmapSet;
-
-                importedBeatmap = beatmaps.Import(beatmapSet).Result;
+                beatmaps.Import(TestResources.GetQuickTestBeatmapForImport()).Wait();
+                importedSet = beatmaps.GetAllUsableBeatmapSetsEnumerable(IncludedDetails.All).First();
+                InitialBeatmap = importedSet.Beatmaps.First(b => b.RulesetID == 0);
+                OtherBeatmap = importedSet.Beatmaps.Last(b => b.RulesetID == 0);
             });
 
             AddStep("load multiplayer", () => LoadScreen(multiplayerScreenStack = new TestMultiplayerScreenStack()));
@@ -76,8 +78,8 @@ namespace osu.Game.Tests.Visual.Multiplayer.QueueingModes
                 {
                     new PlaylistItem
                     {
-                        Beatmap = { Value = importedBeatmap.Value.Beatmaps.First() },
-                        Ruleset = { Value = new OsuRuleset().RulesetInfo }
+                        Beatmap = { Value = InitialBeatmap },
+                        Ruleset = { Value = new OsuRuleset().RulesetInfo },
                     }
                 }
             }));
@@ -91,13 +93,33 @@ namespace osu.Game.Tests.Visual.Multiplayer.QueueingModes
                 InputManager.Click(MouseButton.Left);
             });
 
-            AddUntilStep("wait for join", () => client.Room != null);
+            AddUntilStep("wait for join", () => Client.Room != null);
         }
 
         [Test]
         public void TestCreatedWithCorrectMode()
         {
-            AddAssert("room created with correct mode", () => client.APIRoom?.QueueMode.Value == Mode);
+            AddAssert("room created with correct mode", () => Client.APIRoom?.QueueMode.Value == Mode);
+        }
+
+        protected void RunGameplay()
+        {
+            AddStep("click ready button", () =>
+            {
+                InputManager.MoveMouseTo(this.ChildrenOfType<MultiplayerReadyButton>().Single());
+                InputManager.Click(MouseButton.Left);
+            });
+
+            AddUntilStep("wait for ready", () => Client.LocalUser?.State == MultiplayerUserState.Ready);
+
+            AddStep("click ready button", () =>
+            {
+                InputManager.MoveMouseTo(this.ChildrenOfType<MultiplayerReadyButton>().Single());
+                InputManager.Click(MouseButton.Left);
+            });
+
+            AddUntilStep("wait for player", () => multiplayerScreenStack.CurrentScreen is Player player && player.IsLoaded);
+            AddStep("exit player", () => multiplayerScreenStack.MultiplayerScreen.MakeCurrent());
         }
     }
 }
diff --git a/osu.Game.Tests/Visual/Multiplayer/QueueingModes/TestSceneHostOnlyQueueingMode.cs b/osu.Game.Tests/Visual/Multiplayer/QueueingModes/TestSceneHostOnlyQueueingMode.cs
index f643377221..ada04abc5a 100644
--- a/osu.Game.Tests/Visual/Multiplayer/QueueingModes/TestSceneHostOnlyQueueingMode.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/QueueingModes/TestSceneHostOnlyQueueingMode.cs
@@ -1,12 +1,65 @@
 // 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.Testing;
+using osu.Game.Beatmaps;
 using osu.Game.Online.Multiplayer.Queueing;
+using osu.Game.Screens.OnlinePlay.Multiplayer;
+using osuTK.Input;
 
 namespace osu.Game.Tests.Visual.Multiplayer.QueueingModes
 {
     public class TestSceneHostOnlyQueueingMode : QueueModeTestScene
     {
         protected override QueueModes Mode => QueueModes.HostOnly;
+
+        [Test]
+        public void TestItemStillSelectedAfterChange()
+        {
+            selectNewItem(() => OtherBeatmap);
+        }
+
+        [Test]
+        public void TestNewItemCreatedAfterGameplayFinished()
+        {
+            RunGameplay();
+
+            AddAssert("playlist contains two items", () => Client.APIRoom?.Playlist.Count == 2);
+            AddAssert("first playlist item expired", () => Client.APIRoom?.Playlist[0].Expired == true);
+            AddAssert("second playlist item not expired", () => Client.APIRoom?.Playlist[1].Expired == false);
+            AddAssert("second playlist item selected", () => Client.CurrentMatchPlayingItem.Value == Client.APIRoom?.Playlist[1]);
+        }
+
+        [Test]
+        public void TestOnlyLastItemChangedAfterGameplayFinished()
+        {
+            RunGameplay();
+
+            BeatmapInfo firstBeatmap = null;
+            AddStep("get first playlist item beatmap", () => firstBeatmap = Client.APIRoom?.Playlist[0].Beatmap.Value);
+
+            selectNewItem(() => OtherBeatmap);
+
+            AddAssert("first playlist item hasn't changed", () => Client.APIRoom?.Playlist[0].Beatmap.Value == firstBeatmap);
+            AddAssert("second playlist item changed", () => Client.APIRoom?.Playlist[1].Beatmap.Value != firstBeatmap);
+        }
+
+        private void selectNewItem(Func<BeatmapInfo> beatmap)
+        {
+            AddStep("click edit button", () =>
+            {
+                InputManager.MoveMouseTo(this.ChildrenOfType<MultiplayerMatchSubScreen>().Single().AddOrEditPlaylistButton);
+                InputManager.Click(MouseButton.Left);
+            });
+
+            AddUntilStep("wait for song select", () => CurrentSubScreen is Screens.Select.SongSelect select && select.IsLoaded);
+
+            AddStep("select other beatmap", () => ((Screens.Select.SongSelect)CurrentSubScreen).FinaliseSelection(beatmap()));
+            AddUntilStep("wait for return to match", () => CurrentSubScreen is MultiplayerMatchSubScreen);
+            AddUntilStep("selected item is new beatmap", () => Client.CurrentMatchPlayingItem.Value?.Beatmap.Value?.OnlineID == OtherBeatmap.OnlineID);
+        }
     }
 }
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
index 6ac8ee1ee0..4fcf60c0e8 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
@@ -55,7 +55,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
         [CanBeNull]
         private IDisposable readyClickOperation;
 
-        private OsuButton addOrEditPlaylistButton;
+        public OsuButton AddOrEditPlaylistButton { get; private set; }
 
         public MultiplayerMatchSubScreen(Room room)
             : base(room)
@@ -134,7 +134,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
                                 new Drawable[] { new OverlinedHeader("Beatmap") },
                                 new Drawable[]
                                 {
-                                    addOrEditPlaylistButton = new PurpleTriangleButton
+                                    AddOrEditPlaylistButton = new PurpleTriangleButton
                                     {
                                         RelativeSizeAxes = Axes.X,
                                         Height = 40,
@@ -386,18 +386,18 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
             switch (client.Room.Settings.QueueMode)
             {
                 case QueueModes.HostOnly:
-                    addOrEditPlaylistButton.Text = "Edit beatmap";
-                    addOrEditPlaylistButton.Alpha = client.Room.Host?.User?.Equals(client.LocalUser?.User) == true ? 1 : 0;
+                    AddOrEditPlaylistButton.Text = "Edit beatmap";
+                    AddOrEditPlaylistButton.Alpha = client.Room.Host?.User?.Equals(client.LocalUser?.User) == true ? 1 : 0;
                     break;
 
                 case QueueModes.FreeForAll:
                 case QueueModes.FairRotate:
-                    addOrEditPlaylistButton.Text = "Add beatmap";
-                    addOrEditPlaylistButton.Alpha = 1;
+                    AddOrEditPlaylistButton.Text = "Add beatmap";
+                    AddOrEditPlaylistButton.Alpha = 1;
                     break;
 
                 default:
-                    addOrEditPlaylistButton.Alpha = 0;
+                    AddOrEditPlaylistButton.Alpha = 0;
                     break;
             }
 
diff --git a/osu.Game/Screens/OnlinePlay/OnlinePlayScreen.cs b/osu.Game/Screens/OnlinePlay/OnlinePlayScreen.cs
index fc20b21b60..a18e4b45cf 100644
--- a/osu.Game/Screens/OnlinePlay/OnlinePlayScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/OnlinePlayScreen.cs
@@ -211,7 +211,7 @@ namespace osu.Game.Screens.OnlinePlay
                 ((IBindable<UserActivity>)Activity).BindTo(newOsuScreen.Activity);
         }
 
-        protected IScreen CurrentSubScreen => screenStack.CurrentScreen;
+        public IScreen CurrentSubScreen => screenStack.CurrentScreen;
 
         protected abstract string ScreenTitle { get; }
 

From f732c44265bf768acb2ef902e922ea59325ff7a7 Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Fri, 29 Oct 2021 16:23:10 +0900
Subject: [PATCH 0580/5547] Fix broken equality comparer

---
 osu.Game/Online/Rooms/PlaylistItem.cs | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Online/Rooms/PlaylistItem.cs b/osu.Game/Online/Rooms/PlaylistItem.cs
index 7fcce1514d..e2a47ed744 100644
--- a/osu.Game/Online/Rooms/PlaylistItem.cs
+++ b/osu.Game/Online/Rooms/PlaylistItem.cs
@@ -96,6 +96,12 @@ namespace osu.Game.Online.Rooms
         public bool ShouldSerializeID() => false;
         public bool ShouldSerializeapiBeatmap() => false;
 
-        public bool Equals(PlaylistItem other) => ID == other?.ID && BeatmapID == other.BeatmapID && RulesetID == other.RulesetID;
+        public bool Equals(PlaylistItem other)
+            => ID == other?.ID
+               && BeatmapID == other.BeatmapID
+               && RulesetID == other.RulesetID
+               && Expired == other.Expired
+               && allowedMods.SequenceEqual(other.allowedMods)
+               && requiredMods.SequenceEqual(other.requiredMods);
     }
 }

From 2408011c81882b71f49d5dda9d1ae98976d2058d Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Fri, 29 Oct 2021 16:44:39 +0900
Subject: [PATCH 0581/5547] Don't replace identical playlist items

---
 .../TestSceneHostOnlyQueueingMode.cs           | 18 +++++++++++++++---
 .../Online/Multiplayer/MultiplayerClient.cs    |  9 +++++++--
 2 files changed, 22 insertions(+), 5 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/QueueingModes/TestSceneHostOnlyQueueingMode.cs b/osu.Game.Tests/Visual/Multiplayer/QueueingModes/TestSceneHostOnlyQueueingMode.cs
index ada04abc5a..59baccf181 100644
--- a/osu.Game.Tests/Visual/Multiplayer/QueueingModes/TestSceneHostOnlyQueueingMode.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/QueueingModes/TestSceneHostOnlyQueueingMode.cs
@@ -17,9 +17,19 @@ namespace osu.Game.Tests.Visual.Multiplayer.QueueingModes
         protected override QueueModes Mode => QueueModes.HostOnly;
 
         [Test]
-        public void TestItemStillSelectedAfterChange()
+        public void TestItemStillSelectedAfterChangeToSameBeatmap()
+        {
+            selectNewItem(() => InitialBeatmap);
+
+            AddAssert("playlist item still selected", () => Client.CurrentMatchPlayingItem.Value == Client.APIRoom?.Playlist[0]);
+        }
+
+        [Test]
+        public void TestItemStillSelectedAfterChangeToOtherBeatmap()
         {
             selectNewItem(() => OtherBeatmap);
+
+            AddAssert("playlist item still selected", () => Client.CurrentMatchPlayingItem.Value == Client.APIRoom?.Playlist[0]);
         }
 
         [Test]
@@ -57,9 +67,11 @@ namespace osu.Game.Tests.Visual.Multiplayer.QueueingModes
 
             AddUntilStep("wait for song select", () => CurrentSubScreen is Screens.Select.SongSelect select && select.IsLoaded);
 
-            AddStep("select other beatmap", () => ((Screens.Select.SongSelect)CurrentSubScreen).FinaliseSelection(beatmap()));
+            BeatmapInfo otherBeatmap = null;
+            AddStep("select other beatmap", () => ((Screens.Select.SongSelect)CurrentSubScreen).FinaliseSelection(otherBeatmap = beatmap()));
+
             AddUntilStep("wait for return to match", () => CurrentSubScreen is MultiplayerMatchSubScreen);
-            AddUntilStep("selected item is new beatmap", () => Client.CurrentMatchPlayingItem.Value?.Beatmap.Value?.OnlineID == OtherBeatmap.OnlineID);
+            AddUntilStep("selected item is new beatmap", () => Client.CurrentMatchPlayingItem.Value?.Beatmap.Value?.OnlineID == otherBeatmap.OnlineID);
         }
     }
 }
diff --git a/osu.Game/Online/Multiplayer/MultiplayerClient.cs b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
index cdf6684112..d3e1a7c91a 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
@@ -623,11 +623,16 @@ namespace osu.Game.Online.Multiplayer
                 Debug.Assert(APIRoom != null);
 
                 int index = APIRoom.Playlist.Select((i, index) => (i, index)).Single(kvp => kvp.i.ID == item.ID).index;
+                var oldItem = APIRoom.Playlist[index];
+                if (oldItem.Equals(playlistItem))
+                    return;
+
+                // Replace the item.
                 APIRoom.Playlist.RemoveAt(index);
                 APIRoom.Playlist.Insert(index, playlistItem);
 
-                // If the current item changed, update the selected playlist item.
-                if (item.ID == Room.Settings.PlaylistItemId)
+                // If the currently-selected item was the one that got replaced, update the selected item to the new one.
+                if (CurrentMatchPlayingItem.Value == oldItem)
                     CurrentMatchPlayingItem.Value = APIRoom.Playlist[index];
             }).ConfigureAwait(false);
         }

From 7583435901388816aaf9cf6000977b627a429e6e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 29 Oct 2021 16:45:10 +0900
Subject: [PATCH 0582/5547] Refactor `BeatmapDifficultyCache` to work with
 `IBeatmapInfo`

---
 osu.Game/Beatmaps/BeatmapDifficultyCache.cs | 47 +++++++++++----------
 1 file changed, 25 insertions(+), 22 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapDifficultyCache.cs b/osu.Game/Beatmaps/BeatmapDifficultyCache.cs
index 3777365088..9a0cdb387d 100644
--- a/osu.Game/Beatmaps/BeatmapDifficultyCache.cs
+++ b/osu.Game/Beatmaps/BeatmapDifficultyCache.cs
@@ -88,7 +88,7 @@ namespace osu.Game.Beatmaps
         /// <param name="beatmapInfo">The <see cref="BeatmapInfo"/> to get the difficulty of.</param>
         /// <param name="cancellationToken">An optional <see cref="CancellationToken"/> which stops updating the star difficulty for the given <see cref="BeatmapInfo"/>.</param>
         /// <returns>A bindable that is updated to contain the star difficulty when it becomes available. Will be null while in an initial calculating state (but not during updates to ruleset and mods if a stale value is already propagated).</returns>
-        public IBindable<StarDifficulty?> GetBindableDifficulty([NotNull] BeatmapInfo beatmapInfo, CancellationToken cancellationToken = default)
+        public IBindable<StarDifficulty?> GetBindableDifficulty([NotNull] IBeatmapInfo beatmapInfo, CancellationToken cancellationToken = default)
         {
             var bindable = createBindable(beatmapInfo, currentRuleset.Value, currentMods.Value, cancellationToken);
 
@@ -99,42 +99,45 @@ namespace osu.Game.Beatmaps
         }
 
         /// <summary>
-        /// Retrieves a bindable containing the star difficulty of a <see cref="BeatmapInfo"/> with a given <see cref="RulesetInfo"/> and <see cref="Mod"/> combination.
+        /// Retrieves a bindable containing the star difficulty of a <see cref="IBeatmapInfo"/> with a given <see cref="RulesetInfo"/> and <see cref="Mod"/> combination.
         /// </summary>
         /// <remarks>
         /// The bindable will not update to follow the currently-selected ruleset and mods or its settings.
         /// </remarks>
-        /// <param name="beatmapInfo">The <see cref="BeatmapInfo"/> to get the difficulty of.</param>
-        /// <param name="rulesetInfo">The <see cref="RulesetInfo"/> to get the difficulty with. If <c>null</c>, the <paramref name="beatmapInfo"/>'s ruleset is used.</param>
+        /// <param name="beatmapInfo">The <see cref="IBeatmapInfo"/> to get the difficulty of.</param>
+        /// <param name="rulesetInfo">The <see cref="IRulesetInfo"/> to get the difficulty with. If <c>null</c>, the <paramref name="beatmapInfo"/>'s ruleset is used.</param>
         /// <param name="mods">The <see cref="Mod"/>s to get the difficulty with. If <c>null</c>, no mods will be assumed.</param>
-        /// <param name="cancellationToken">An optional <see cref="CancellationToken"/> which stops updating the star difficulty for the given <see cref="BeatmapInfo"/>.</param>
+        /// <param name="cancellationToken">An optional <see cref="CancellationToken"/> which stops updating the star difficulty for the given <see cref="IBeatmapInfo"/>.</param>
         /// <returns>A bindable that is updated to contain the star difficulty when it becomes available. Will be null while in an initial calculating state.</returns>
-        public IBindable<StarDifficulty?> GetBindableDifficulty([NotNull] BeatmapInfo beatmapInfo, [CanBeNull] RulesetInfo rulesetInfo, [CanBeNull] IEnumerable<Mod> mods,
+        public IBindable<StarDifficulty?> GetBindableDifficulty([NotNull] IBeatmapInfo beatmapInfo, [CanBeNull] IRulesetInfo rulesetInfo, [CanBeNull] IEnumerable<Mod> mods,
                                                                 CancellationToken cancellationToken = default)
             => createBindable(beatmapInfo, rulesetInfo, mods, cancellationToken);
 
         /// <summary>
-        /// Retrieves the difficulty of a <see cref="BeatmapInfo"/>.
+        /// Retrieves the difficulty of a <see cref="IBeatmapInfo"/>.
         /// </summary>
-        /// <param name="beatmapInfo">The <see cref="BeatmapInfo"/> to get the difficulty of.</param>
-        /// <param name="rulesetInfo">The <see cref="RulesetInfo"/> to get the difficulty with.</param>
+        /// <param name="beatmapInfo">The <see cref="IBeatmapInfo"/> to get the difficulty of.</param>
+        /// <param name="rulesetInfo">The <see cref="IRulesetInfo"/> to get the difficulty with.</param>
         /// <param name="mods">The <see cref="Mod"/>s to get the difficulty with.</param>
         /// <param name="cancellationToken">An optional <see cref="CancellationToken"/> which stops computing the star difficulty.</param>
         /// <returns>The <see cref="StarDifficulty"/>.</returns>
-        public virtual Task<StarDifficulty> GetDifficultyAsync([NotNull] BeatmapInfo beatmapInfo, [CanBeNull] RulesetInfo rulesetInfo = null,
+        public virtual Task<StarDifficulty> GetDifficultyAsync([NotNull] IBeatmapInfo beatmapInfo, [CanBeNull] IRulesetInfo rulesetInfo = null,
                                                                [CanBeNull] IEnumerable<Mod> mods = null, CancellationToken cancellationToken = default)
         {
             // In the case that the user hasn't given us a ruleset, use the beatmap's default ruleset.
             rulesetInfo ??= beatmapInfo.Ruleset;
 
+            var localBeatmapInfo = beatmapInfo as BeatmapInfo;
+            var localRulesetInfo = rulesetInfo as RulesetInfo;
+
             // Difficulty can only be computed if the beatmap and ruleset are locally available.
-            if (beatmapInfo.ID == 0 || rulesetInfo.ID == null)
+            if (localBeatmapInfo == null || localRulesetInfo == null)
             {
                 // If not, fall back to the existing star difficulty (e.g. from an online source).
-                return Task.FromResult(new StarDifficulty(beatmapInfo.StarDifficulty, beatmapInfo.MaxCombo ?? 0));
+                return Task.FromResult(new StarDifficulty(beatmapInfo.StarRating, (beatmapInfo as IBeatmapOnlineInfo)?.MaxCombo ?? 0));
             }
 
-            return GetAsync(new DifficultyCacheLookup(beatmapInfo, rulesetInfo, mods), cancellationToken);
+            return GetAsync(new DifficultyCacheLookup(localBeatmapInfo, localRulesetInfo, mods), cancellationToken);
         }
 
         protected override Task<StarDifficulty> ComputeValueAsync(DifficultyCacheLookup lookup, CancellationToken token = default)
@@ -227,12 +230,12 @@ namespace osu.Game.Beatmaps
         /// <summary>
         /// Creates a new <see cref="BindableStarDifficulty"/> and triggers an initial value update.
         /// </summary>
-        /// <param name="beatmapInfo">The <see cref="BeatmapInfo"/> that star difficulty should correspond to.</param>
-        /// <param name="initialRulesetInfo">The initial <see cref="RulesetInfo"/> to get the difficulty with.</param>
+        /// <param name="beatmapInfo">The <see cref="IBeatmapInfo"/> that star difficulty should correspond to.</param>
+        /// <param name="initialRulesetInfo">The initial <see cref="IRulesetInfo"/> to get the difficulty with.</param>
         /// <param name="initialMods">The initial <see cref="Mod"/>s to get the difficulty with.</param>
-        /// <param name="cancellationToken">An optional <see cref="CancellationToken"/> which stops updating the star difficulty for the given <see cref="BeatmapInfo"/>.</param>
+        /// <param name="cancellationToken">An optional <see cref="CancellationToken"/> which stops updating the star difficulty for the given <see cref="IBeatmapInfo"/>.</param>
         /// <returns>The <see cref="BindableStarDifficulty"/>.</returns>
-        private BindableStarDifficulty createBindable([NotNull] BeatmapInfo beatmapInfo, [CanBeNull] RulesetInfo initialRulesetInfo, [CanBeNull] IEnumerable<Mod> initialMods,
+        private BindableStarDifficulty createBindable([NotNull] IBeatmapInfo beatmapInfo, [CanBeNull] IRulesetInfo initialRulesetInfo, [CanBeNull] IEnumerable<Mod> initialMods,
                                                       CancellationToken cancellationToken)
         {
             var bindable = new BindableStarDifficulty(beatmapInfo, cancellationToken);
@@ -244,12 +247,12 @@ namespace osu.Game.Beatmaps
         /// Updates the value of a <see cref="BindableStarDifficulty"/> with a given ruleset + mods.
         /// </summary>
         /// <param name="bindable">The <see cref="BindableStarDifficulty"/> to update.</param>
-        /// <param name="rulesetInfo">The <see cref="RulesetInfo"/> to update with.</param>
+        /// <param name="rulesetInfo">The <see cref="IRulesetInfo"/> to update with.</param>
         /// <param name="mods">The <see cref="Mod"/>s to update with.</param>
         /// <param name="cancellationToken">A token that may be used to cancel this update.</param>
-        private void updateBindable([NotNull] BindableStarDifficulty bindable, [CanBeNull] RulesetInfo rulesetInfo, [CanBeNull] IEnumerable<Mod> mods, CancellationToken cancellationToken = default)
+        private void updateBindable([NotNull] BindableStarDifficulty bindable, [CanBeNull] IRulesetInfo rulesetInfo, [CanBeNull] IEnumerable<Mod> mods, CancellationToken cancellationToken = default)
         {
-            // GetDifficultyAsync will fall back to existing data from BeatmapInfo if not locally available
+            // GetDifficultyAsync will fall back to existing data from IBeatmapInfo if not locally available
             // (contrary to GetAsync)
             GetDifficultyAsync(bindable.BeatmapInfo, rulesetInfo, mods, cancellationToken)
                 .ContinueWith(t =>
@@ -343,10 +346,10 @@ namespace osu.Game.Beatmaps
 
         private class BindableStarDifficulty : Bindable<StarDifficulty?>
         {
-            public readonly BeatmapInfo BeatmapInfo;
+            public readonly IBeatmapInfo BeatmapInfo;
             public readonly CancellationToken CancellationToken;
 
-            public BindableStarDifficulty(BeatmapInfo beatmapInfo, CancellationToken cancellationToken)
+            public BindableStarDifficulty(IBeatmapInfo beatmapInfo, CancellationToken cancellationToken)
             {
                 BeatmapInfo = beatmapInfo;
                 CancellationToken = cancellationToken;

From 7c6b3cb0802917d15dc508351ccb9812eb42991d Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Fri, 29 Oct 2021 16:45:30 +0900
Subject: [PATCH 0583/5547] Rename test scene

---
 ...eneHostOnlyQueueingMode.cs => TestSceneHostOnlyQueueMode.cs} | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
 rename osu.Game.Tests/Visual/Multiplayer/QueueingModes/{TestSceneHostOnlyQueueingMode.cs => TestSceneHostOnlyQueueMode.cs} (97%)

diff --git a/osu.Game.Tests/Visual/Multiplayer/QueueingModes/TestSceneHostOnlyQueueingMode.cs b/osu.Game.Tests/Visual/Multiplayer/QueueingModes/TestSceneHostOnlyQueueMode.cs
similarity index 97%
rename from osu.Game.Tests/Visual/Multiplayer/QueueingModes/TestSceneHostOnlyQueueingMode.cs
rename to osu.Game.Tests/Visual/Multiplayer/QueueingModes/TestSceneHostOnlyQueueMode.cs
index 59baccf181..34a490e073 100644
--- a/osu.Game.Tests/Visual/Multiplayer/QueueingModes/TestSceneHostOnlyQueueingMode.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/QueueingModes/TestSceneHostOnlyQueueMode.cs
@@ -12,7 +12,7 @@ using osuTK.Input;
 
 namespace osu.Game.Tests.Visual.Multiplayer.QueueingModes
 {
-    public class TestSceneHostOnlyQueueingMode : QueueModeTestScene
+    public class TestSceneHostOnlyQueueMode : QueueModeTestScene
     {
         protected override QueueModes Mode => QueueModes.HostOnly;
 

From aff216840fcf94c98a609c3f5cc9fbd4bbdc628c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 29 Oct 2021 16:53:54 +0900
Subject: [PATCH 0584/5547] Add a note about `OnlineID` potentially being zero
 in non-autoincrement cases

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

diff --git a/osu.Game/Database/IHasOnlineID.cs b/osu.Game/Database/IHasOnlineID.cs
index 6e2be7e1f9..bb05bf75cb 100644
--- a/osu.Game/Database/IHasOnlineID.cs
+++ b/osu.Game/Database/IHasOnlineID.cs
@@ -8,7 +8,7 @@ namespace osu.Game.Database
     public interface IHasOnlineID
     {
         /// <summary>
-        /// The server-side ID representing this instance, if one exists. Any value 0 or less denotes a missing ID.
+        /// The server-side ID representing this instance, if one exists. Any value 0 or less denotes a missing ID (except in special cases where autoincrement is not used, like rulesets).
         /// </summary>
         /// <remarks>
         /// Generally we use -1 when specifying "missing" in code, but values of 0 are also considered missing as the online source

From 3598adb3449e395bc15ce29d2e895a5421c84705 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 29 Oct 2021 17:04:56 +0900
Subject: [PATCH 0585/5547] Fix test implementing old version of class

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

diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapMetadataDisplay.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapMetadataDisplay.cs
index f91d3f595b..50ae673c06 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapMetadataDisplay.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapMetadataDisplay.cs
@@ -140,7 +140,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                 }
             }
 
-            public override async Task<StarDifficulty> GetDifficultyAsync(BeatmapInfo beatmapInfo, RulesetInfo rulesetInfo = null, IEnumerable<Mod> mods = null, CancellationToken cancellationToken = default)
+            public override async Task<StarDifficulty> GetDifficultyAsync(IBeatmapInfo beatmapInfo, IRulesetInfo rulesetInfo = null, IEnumerable<Mod> mods = null, CancellationToken cancellationToken = default)
             {
                 if (blockCalculation)
                     await calculationBlocker.Task.ConfigureAwait(false);

From be0564f7326960959970c398203bac1e8ed4280f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 29 Oct 2021 17:03:50 +0900
Subject: [PATCH 0586/5547] Update `DifficultyIcon` classes to use
 `IBeatmapInfo`

---
 osu.Game/Beatmaps/Drawables/DifficultyIcon.cs | 23 +++++++++++--------
 .../Drawables/DifficultyIconTooltip.cs        |  6 ++---
 .../Drawables/GroupedDifficultyIcon.cs        |  6 ++---
 3 files changed, 19 insertions(+), 16 deletions(-)

diff --git a/osu.Game/Beatmaps/Drawables/DifficultyIcon.cs b/osu.Game/Beatmaps/Drawables/DifficultyIcon.cs
index 880d70aec2..3a55b9261f 100644
--- a/osu.Game/Beatmaps/Drawables/DifficultyIcon.cs
+++ b/osu.Game/Beatmaps/Drawables/DifficultyIcon.cs
@@ -37,10 +37,10 @@ namespace osu.Game.Beatmaps.Drawables
         }
 
         [NotNull]
-        private readonly BeatmapInfo beatmapInfo;
+        private readonly IBeatmapInfo beatmapInfo;
 
         [CanBeNull]
-        private readonly RulesetInfo ruleset;
+        private readonly IRulesetInfo ruleset;
 
         [CanBeNull]
         private readonly IReadOnlyList<Mod> mods;
@@ -60,7 +60,7 @@ namespace osu.Game.Beatmaps.Drawables
         /// <param name="ruleset">The ruleset to show the difficulty with.</param>
         /// <param name="mods">The mods to show the difficulty with.</param>
         /// <param name="shouldShowTooltip">Whether to display a tooltip when hovered.</param>
-        public DifficultyIcon([NotNull] BeatmapInfo beatmapInfo, [CanBeNull] RulesetInfo ruleset, [CanBeNull] IReadOnlyList<Mod> mods, bool shouldShowTooltip = true)
+        public DifficultyIcon([NotNull] IBeatmapInfo beatmapInfo, [CanBeNull] IRulesetInfo ruleset, [CanBeNull] IReadOnlyList<Mod> mods, bool shouldShowTooltip = true)
             : this(beatmapInfo, shouldShowTooltip)
         {
             this.ruleset = ruleset ?? beatmapInfo.Ruleset;
@@ -73,7 +73,7 @@ namespace osu.Game.Beatmaps.Drawables
         /// <param name="beatmapInfo">The beatmap to show the difficulty of.</param>
         /// <param name="shouldShowTooltip">Whether to display a tooltip when hovered.</param>
         /// <param name="performBackgroundDifficultyLookup">Whether to perform difficulty lookup (including calculation if necessary).</param>
-        public DifficultyIcon([NotNull] BeatmapInfo beatmapInfo, bool shouldShowTooltip = true, bool performBackgroundDifficultyLookup = true)
+        public DifficultyIcon([NotNull] IBeatmapInfo beatmapInfo, bool shouldShowTooltip = true, bool performBackgroundDifficultyLookup = true)
         {
             this.beatmapInfo = beatmapInfo ?? throw new ArgumentNullException(nameof(beatmapInfo));
             this.shouldShowTooltip = shouldShowTooltip;
@@ -84,6 +84,9 @@ namespace osu.Game.Beatmaps.Drawables
             InternalChild = iconContainer = new Container { Size = new Vector2(20f) };
         }
 
+        [Resolved]
+        private RulesetStore rulesets { get; set; }
+
         [BackgroundDependencyLoader]
         private void load(OsuColour colours)
         {
@@ -105,7 +108,7 @@ namespace osu.Game.Beatmaps.Drawables
                     Child = background = new Box
                     {
                         RelativeSizeAxes = Axes.Both,
-                        Colour = colours.ForStarDifficulty(beatmapInfo.StarDifficulty) // Default value that will be re-populated once difficulty calculation completes
+                        Colour = colours.ForStarDifficulty(beatmapInfo.StarRating) // Default value that will be re-populated once difficulty calculation completes
                     },
                 },
                 new ConstrainedIconContainer
@@ -114,14 +117,14 @@ namespace osu.Game.Beatmaps.Drawables
                     Origin = Anchor.Centre,
                     RelativeSizeAxes = Axes.Both,
                     // the null coalesce here is only present to make unit tests work (ruleset dlls aren't copied correctly for testing at the moment)
-                    Icon = (ruleset ?? beatmapInfo.Ruleset)?.CreateInstance()?.CreateIcon() ?? new SpriteIcon { Icon = FontAwesome.Regular.QuestionCircle }
+                    Icon = rulesets.GetRuleset((ruleset ?? beatmapInfo.Ruleset).OnlineID)?.CreateInstance()?.CreateIcon() ?? new SpriteIcon { Icon = FontAwesome.Regular.QuestionCircle }
                 },
             };
 
             if (performBackgroundDifficultyLookup)
                 iconContainer.Add(new DelayedLoadUnloadWrapper(() => new DifficultyRetriever(beatmapInfo, ruleset, mods) { StarDifficulty = { BindTarget = difficultyBindable } }, 0));
             else
-                difficultyBindable.Value = new StarDifficulty(beatmapInfo.StarDifficulty, 0);
+                difficultyBindable.Value = new StarDifficulty(beatmapInfo.StarRating, 0);
 
             difficultyBindable.BindValueChanged(difficulty => background.Colour = colours.ForStarDifficulty(difficulty.NewValue.Stars));
         }
@@ -134,8 +137,8 @@ namespace osu.Game.Beatmaps.Drawables
         {
             public readonly Bindable<StarDifficulty> StarDifficulty = new Bindable<StarDifficulty>();
 
-            private readonly BeatmapInfo beatmapInfo;
-            private readonly RulesetInfo ruleset;
+            private readonly IBeatmapInfo beatmapInfo;
+            private readonly IRulesetInfo ruleset;
             private readonly IReadOnlyList<Mod> mods;
 
             private CancellationTokenSource difficultyCancellation;
@@ -143,7 +146,7 @@ namespace osu.Game.Beatmaps.Drawables
             [Resolved]
             private BeatmapDifficultyCache difficultyCache { get; set; }
 
-            public DifficultyRetriever(BeatmapInfo beatmapInfo, RulesetInfo ruleset, IReadOnlyList<Mod> mods)
+            public DifficultyRetriever(IBeatmapInfo beatmapInfo, IRulesetInfo ruleset, IReadOnlyList<Mod> mods)
             {
                 this.beatmapInfo = beatmapInfo;
                 this.ruleset = ruleset;
diff --git a/osu.Game/Beatmaps/Drawables/DifficultyIconTooltip.cs b/osu.Game/Beatmaps/Drawables/DifficultyIconTooltip.cs
index d4c9f83a0a..ec4bcbd65f 100644
--- a/osu.Game/Beatmaps/Drawables/DifficultyIconTooltip.cs
+++ b/osu.Game/Beatmaps/Drawables/DifficultyIconTooltip.cs
@@ -89,7 +89,7 @@ namespace osu.Game.Beatmaps.Drawables
 
         public void SetContent(DifficultyIconTooltipContent content)
         {
-            difficultyName.Text = content.BeatmapInfo.Version;
+            difficultyName.Text = content.BeatmapInfo.DifficultyName;
 
             starDifficulty.UnbindAll();
             starDifficulty.BindTo(content.Difficulty);
@@ -109,10 +109,10 @@ namespace osu.Game.Beatmaps.Drawables
 
     internal class DifficultyIconTooltipContent
     {
-        public readonly BeatmapInfo BeatmapInfo;
+        public readonly IBeatmapInfo BeatmapInfo;
         public readonly IBindable<StarDifficulty> Difficulty;
 
-        public DifficultyIconTooltipContent(BeatmapInfo beatmapInfo, IBindable<StarDifficulty> difficulty)
+        public DifficultyIconTooltipContent(IBeatmapInfo beatmapInfo, IBindable<StarDifficulty> difficulty)
         {
             BeatmapInfo = beatmapInfo;
             Difficulty = difficulty;
diff --git a/osu.Game/Beatmaps/Drawables/GroupedDifficultyIcon.cs b/osu.Game/Beatmaps/Drawables/GroupedDifficultyIcon.cs
index fcee4c2f1a..799a02579e 100644
--- a/osu.Game/Beatmaps/Drawables/GroupedDifficultyIcon.cs
+++ b/osu.Game/Beatmaps/Drawables/GroupedDifficultyIcon.cs
@@ -19,8 +19,8 @@ namespace osu.Game.Beatmaps.Drawables
     /// </remarks>
     public class GroupedDifficultyIcon : DifficultyIcon
     {
-        public GroupedDifficultyIcon(List<BeatmapInfo> beatmaps, RulesetInfo ruleset, Color4 counterColour)
-            : base(beatmaps.OrderBy(b => b.StarDifficulty).Last(), ruleset, null, false)
+        public GroupedDifficultyIcon(IEnumerable<IBeatmapInfo> beatmaps, IRulesetInfo ruleset, Color4 counterColour)
+            : base(beatmaps.OrderBy(b => b.StarRating).Last(), ruleset, null, false)
         {
             AddInternal(new OsuSpriteText
             {
@@ -29,7 +29,7 @@ namespace osu.Game.Beatmaps.Drawables
                 Padding = new MarginPadding { Left = Size.X },
                 Margin = new MarginPadding { Left = 2, Right = 5 },
                 Font = OsuFont.GetFont(size: 14, weight: FontWeight.SemiBold),
-                Text = beatmaps.Count.ToString(),
+                Text = beatmaps.Count().ToString(),
                 Colour = counterColour,
             });
         }

From b5834044e0d405ec4acbfa9629271d4dc77fa729 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 29 Oct 2021 17:40:02 +0900
Subject: [PATCH 0587/5547] Update `GetScoreRequest` to support requests with
 interface types

---
 osu.Game/Online/API/Requests/GetScoresRequest.cs | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Online/API/Requests/GetScoresRequest.cs b/osu.Game/Online/API/Requests/GetScoresRequest.cs
index 790a247ccb..8e447390e6 100644
--- a/osu.Game/Online/API/Requests/GetScoresRequest.cs
+++ b/osu.Game/Online/API/Requests/GetScoresRequest.cs
@@ -14,15 +14,15 @@ namespace osu.Game.Online.API.Requests
 {
     public class GetScoresRequest : APIRequest<APIScoresCollection>
     {
-        private readonly BeatmapInfo beatmapInfo;
+        private readonly IBeatmapInfo beatmapInfo;
         private readonly BeatmapLeaderboardScope scope;
-        private readonly RulesetInfo ruleset;
+        private readonly IRulesetInfo ruleset;
         private readonly IEnumerable<IMod> mods;
 
-        public GetScoresRequest(BeatmapInfo beatmapInfo, RulesetInfo ruleset, BeatmapLeaderboardScope scope = BeatmapLeaderboardScope.Global, IEnumerable<IMod> mods = null)
+        public GetScoresRequest(IBeatmapInfo beatmapInfo, IRulesetInfo ruleset, BeatmapLeaderboardScope scope = BeatmapLeaderboardScope.Global, IEnumerable<IMod> mods = null)
         {
-            if (!beatmapInfo.OnlineBeatmapID.HasValue)
-                throw new InvalidOperationException($"Cannot lookup a beatmap's scores without having a populated {nameof(BeatmapInfo.OnlineBeatmapID)}.");
+            if (beatmapInfo.OnlineID <= 0)
+                throw new InvalidOperationException($"Cannot lookup a beatmap's scores without having a populated {nameof(IBeatmapInfo.OnlineID)}.");
 
             if (scope == BeatmapLeaderboardScope.Local)
                 throw new InvalidOperationException("Should not attempt to request online scores for a local scoped leaderboard");
@@ -33,7 +33,7 @@ namespace osu.Game.Online.API.Requests
             this.mods = mods ?? Array.Empty<IMod>();
         }
 
-        protected override string Target => $@"beatmaps/{beatmapInfo.OnlineBeatmapID}/scores{createQueryParameters()}";
+        protected override string Target => $@"beatmaps/{beatmapInfo.OnlineID}/scores{createQueryParameters()}";
 
         private string createQueryParameters()
         {

From 90503f72cae121f8856cd428eed3ccb0d09a446a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 29 Oct 2021 17:40:12 +0900
Subject: [PATCH 0588/5547] Update `PresentBeatmap` to support interface types

---
 osu.Game/OsuGame.cs | 12 ++++++++----
 1 file changed, 8 insertions(+), 4 deletions(-)

diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index f9e080a93c..a7ed7fedf5 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -436,11 +436,15 @@ namespace osu.Game
         /// <item>first beatmap from any ruleset.</item>
         /// </list>
         /// </remarks>
-        public void PresentBeatmap(BeatmapSetInfo beatmap, Predicate<BeatmapInfo> difficultyCriteria = null)
+        public void PresentBeatmap(IBeatmapSetInfo beatmap, Predicate<BeatmapInfo> difficultyCriteria = null)
         {
-            var databasedSet = beatmap.OnlineBeatmapSetID != null
-                ? BeatmapManager.QueryBeatmapSet(s => s.OnlineBeatmapSetID == beatmap.OnlineBeatmapSetID)
-                : BeatmapManager.QueryBeatmapSet(s => s.Hash == beatmap.Hash);
+            BeatmapSetInfo databasedSet = null;
+
+            if (beatmap.OnlineID > 0)
+                databasedSet = BeatmapManager.QueryBeatmapSet(s => s.OnlineBeatmapSetID == beatmap.OnlineID);
+
+            if (beatmap is BeatmapSetInfo localBeatmap)
+                databasedSet ??= BeatmapManager.QueryBeatmapSet(s => s.Hash == localBeatmap.Hash);
 
             if (databasedSet == null)
             {

From 7db8bdfb7c01db278088b8aa45c963eef6fad5ca Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 29 Oct 2021 18:16:53 +0900
Subject: [PATCH 0589/5547] Fix fallback logic not considering case where
 ruleset is not available

Occurs only in tests.
---
 osu.Game/Beatmaps/Drawables/DifficultyIcon.cs | 12 +++++++++++-
 1 file changed, 11 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Beatmaps/Drawables/DifficultyIcon.cs b/osu.Game/Beatmaps/Drawables/DifficultyIcon.cs
index 3a55b9261f..6d1984db5b 100644
--- a/osu.Game/Beatmaps/Drawables/DifficultyIcon.cs
+++ b/osu.Game/Beatmaps/Drawables/DifficultyIcon.cs
@@ -117,7 +117,7 @@ namespace osu.Game.Beatmaps.Drawables
                     Origin = Anchor.Centre,
                     RelativeSizeAxes = Axes.Both,
                     // the null coalesce here is only present to make unit tests work (ruleset dlls aren't copied correctly for testing at the moment)
-                    Icon = rulesets.GetRuleset((ruleset ?? beatmapInfo.Ruleset).OnlineID)?.CreateInstance()?.CreateIcon() ?? new SpriteIcon { Icon = FontAwesome.Regular.QuestionCircle }
+                    Icon = getRulesetIcon()
                 },
             };
 
@@ -129,6 +129,16 @@ namespace osu.Game.Beatmaps.Drawables
             difficultyBindable.BindValueChanged(difficulty => background.Colour = colours.ForStarDifficulty(difficulty.NewValue.Stars));
         }
 
+        private Drawable getRulesetIcon()
+        {
+            int? onlineID = (ruleset ?? beatmapInfo.Ruleset)?.OnlineID;
+
+            if (onlineID >= 0 && rulesets.GetRuleset(onlineID.Value)?.CreateInstance() is Ruleset rulesetInstance)
+                return rulesetInstance.CreateIcon();
+
+            return new SpriteIcon { Icon = FontAwesome.Regular.QuestionCircle };
+        }
+
         ITooltip<DifficultyIconTooltipContent> IHasCustomTooltip<DifficultyIconTooltipContent>.GetCustomTooltip() => new DifficultyIconTooltip();
 
         DifficultyIconTooltipContent IHasCustomTooltip<DifficultyIconTooltipContent>.TooltipContent => shouldShowTooltip ? new DifficultyIconTooltipContent(beatmapInfo, difficultyBindable) : null;

From 07e3ced315fe457eb97e32879c0c061541e201f4 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 29 Oct 2021 18:22:23 +0900
Subject: [PATCH 0590/5547] Fix test scene and remove "impossible" nullable
 coalesce

---
 osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs | 2 ++
 osu.Game/Beatmaps/Drawables/DifficultyIcon.cs                | 2 +-
 2 files changed, 3 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs
index 66f15670f5..1eda3be039 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs
@@ -15,6 +15,7 @@ using osu.Framework.Utils;
 using osu.Game.Beatmaps;
 using osu.Game.Configuration;
 using osu.Game.Rulesets;
+using osu.Game.Rulesets.Osu;
 using osu.Game.Screens.Select;
 using osu.Game.Screens.Select.Carousel;
 using osu.Game.Screens.Select.Filter;
@@ -868,6 +869,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                     OnlineBeatmapID = id++ * 10,
                     Version = version,
                     StarDifficulty = diff,
+                    Ruleset = new OsuRuleset().RulesetInfo,
                     BaseDifficulty = new BeatmapDifficulty
                     {
                         OverallDifficulty = diff,
diff --git a/osu.Game/Beatmaps/Drawables/DifficultyIcon.cs b/osu.Game/Beatmaps/Drawables/DifficultyIcon.cs
index 6d1984db5b..64412675bb 100644
--- a/osu.Game/Beatmaps/Drawables/DifficultyIcon.cs
+++ b/osu.Game/Beatmaps/Drawables/DifficultyIcon.cs
@@ -131,7 +131,7 @@ namespace osu.Game.Beatmaps.Drawables
 
         private Drawable getRulesetIcon()
         {
-            int? onlineID = (ruleset ?? beatmapInfo.Ruleset)?.OnlineID;
+            int? onlineID = (ruleset ?? beatmapInfo.Ruleset).OnlineID;
 
             if (onlineID >= 0 && rulesets.GetRuleset(onlineID.Value)?.CreateInstance() is Ruleset rulesetInstance)
                 return rulesetInstance.CreateIcon();

From 04acc7601c2a96906fb6e462391df4502ee61015 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 29 Oct 2021 18:35:15 +0900
Subject: [PATCH 0591/5547] Fix one more missed case

---
 osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs
index 1eda3be039..7a38d213d9 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs
@@ -685,6 +685,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                     set.Beatmaps.Add(new BeatmapInfo
                     {
                         Version = $"Stars: {i}",
+                        Ruleset = new OsuRuleset().RulesetInfo,
                         StarDifficulty = i,
                     });
                 }

From b8ee7e05f497aedc1b4eeabd40ef856eddd25a46 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 29 Oct 2021 17:49:31 +0900
Subject: [PATCH 0592/5547] Expose more pieces of `APIBeatmap` for testing
 purposes

---
 .../Online/API/Requests/Responses/APIBeatmap.cs  | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs b/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs
index e65dca752b..061e034648 100644
--- a/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs
@@ -43,16 +43,16 @@ namespace osu.Game.Online.API.Requests.Responses
         public double StarRating { get; set; }
 
         [JsonProperty(@"drain")]
-        private float drainRate { get; set; }
+        public float DrainRate { get; set; }
 
         [JsonProperty(@"cs")]
-        private float circleSize { get; set; }
+        public float CircleSize { get; set; }
 
         [JsonProperty(@"ar")]
-        private float approachRate { get; set; }
+        public float ApproachRate { get; set; }
 
         [JsonProperty(@"accuracy")]
-        private float overallDifficulty { get; set; }
+        public float OverallDifficulty { get; set; }
 
         [JsonIgnore]
         public double Length { get; set; }
@@ -115,10 +115,10 @@ namespace osu.Game.Online.API.Requests.Responses
 
         public IBeatmapDifficultyInfo Difficulty => new BeatmapDifficulty
         {
-            DrainRate = drainRate,
-            CircleSize = circleSize,
-            ApproachRate = approachRate,
-            OverallDifficulty = overallDifficulty,
+            DrainRate = DrainRate,
+            CircleSize = CircleSize,
+            ApproachRate = ApproachRate,
+            OverallDifficulty = OverallDifficulty,
         };
 
         IBeatmapSetInfo? IBeatmapInfo.BeatmapSet => BeatmapSet;

From a16c8f1ebc97255d9dc51030155e22d37beb67e5 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 29 Oct 2021 17:58:46 +0900
Subject: [PATCH 0593/5547] Update all beatmap overlay views to use
 `APIBeatmap`/`APIBeatmapSet`

---
 .../Online/TestSceneBeatmapAvailability.cs    |  40 +--
 .../Online/TestSceneBeatmapRulesetSelector.cs |  22 +-
 .../Online/TestSceneBeatmapSetOverlay.cs      | 268 ++++++------------
 .../TestSceneBeatmapSetOverlayDetails.cs      |  24 +-
 .../TestSceneBeatmapSetOverlaySuccessRate.cs  |  31 +-
 .../Online/TestSceneDirectDownloadButton.cs   |  66 +++--
 .../Visual/Online/TestSceneDirectPanel.cs     | 160 +++++------
 .../Visual/Online/TestSceneFavouriteButton.cs |   8 +-
 .../Online/TestSceneLeaderboardModSelector.cs |   3 +-
 .../SongSelect/TestSceneAdvancedStats.cs      |   4 +-
 .../TestSceneBeatmapListingSearchControl.cs   |  18 +-
 ...tSceneUpdateableBeatmapBackgroundSprite.cs |   5 +-
 .../API/Requests/Responses/APIBeatmap.cs      |   8 +-
 .../BeatmapListingFilterControl.cs            |   8 +-
 .../BeatmapListingSearchControl.cs            |   8 +-
 .../BeatmapListing/Panels/BeatmapPanel.cs     |  19 +-
 .../Panels/BeatmapPanelDownloadButton.cs      |  13 +-
 .../Panels/DownloadProgressBar.cs             |   2 +-
 .../BeatmapListing/Panels/GridBeatmapPanel.cs |  28 +-
 .../BeatmapListing/Panels/ListBeatmapPanel.cs |  28 +-
 .../BeatmapListing/Panels/PlayButton.cs       |   8 +-
 osu.Game/Overlays/BeatmapListingOverlay.cs    |   4 +-
 osu.Game/Overlays/BeatmapSet/AuthorInfo.cs    |  22 +-
 osu.Game/Overlays/BeatmapSet/BasicStats.cs    |  17 +-
 .../BeatmapSet/BeatmapAvailability.cs         |  12 +-
 osu.Game/Overlays/BeatmapSet/BeatmapPicker.cs |  58 ++--
 .../BeatmapSet/BeatmapRulesetSelector.cs      |   6 +-
 .../BeatmapSet/BeatmapRulesetTabItem.cs       |   8 +-
 .../Overlays/BeatmapSet/BeatmapSetHeader.cs   |   4 +-
 .../BeatmapSet/BeatmapSetHeaderContent.cs     |  22 +-
 .../BeatmapSet/Buttons/FavouriteButton.cs     |  12 +-
 .../Buttons/HeaderDownloadButton.cs           |  15 +-
 .../BeatmapSet/Buttons/PreviewButton.cs       |   4 +-
 osu.Game/Overlays/BeatmapSet/Details.cs       |  11 +-
 osu.Game/Overlays/BeatmapSet/Info.cs          |  20 +-
 .../BeatmapSet/LeaderboardModSelector.cs      |  10 +-
 .../BeatmapSet/Scores/ScoresContainer.cs      |  30 +-
 osu.Game/Overlays/BeatmapSet/SuccessRate.cs   |  18 +-
 osu.Game/Overlays/BeatmapSetOverlay.cs        |  18 +-
 .../Beatmaps/PaginatedBeatmapContainer.cs     |   2 +-
 .../Historical/DrawableMostPlayedBeatmap.cs   |   4 +-
 .../Overlays/Rankings/SpotlightsLayout.cs     |   2 +-
 osu.Game/Screens/Play/SoloSpectator.cs        |   2 +-
 osu.Game/Screens/Select/BeatmapDetails.cs     |   4 +-
 .../Screens/Select/Details/AdvancedStats.cs   |   8 +-
 45 files changed, 471 insertions(+), 613 deletions(-)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneBeatmapAvailability.cs b/osu.Game.Tests/Visual/Online/TestSceneBeatmapAvailability.cs
index 6f9744ca73..176e0592ef 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneBeatmapAvailability.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneBeatmapAvailability.cs
@@ -21,15 +21,12 @@ namespace osu.Game.Tests.Visual.Online
         [Test]
         public void TestUndownloadableWithLink()
         {
-            AddStep("set undownloadable beatmapset with link", () => container.BeatmapSet = new BeatmapSetInfo
+            AddStep("set undownloadable beatmapset with link", () => container.BeatmapSet = new APIBeatmapSet
             {
-                OnlineInfo = new APIBeatmapSet
+                Availability = new BeatmapSetOnlineAvailability
                 {
-                    Availability = new BeatmapSetOnlineAvailability
-                    {
-                        DownloadDisabled = true,
-                        ExternalLink = @"https://osu.ppy.sh",
-                    },
+                    DownloadDisabled = true,
+                    ExternalLink = @"https://osu.ppy.sh",
                 },
             });
 
@@ -39,14 +36,11 @@ namespace osu.Game.Tests.Visual.Online
         [Test]
         public void TestUndownloadableNoLink()
         {
-            AddStep("set undownloadable beatmapset without link", () => container.BeatmapSet = new BeatmapSetInfo
+            AddStep("set undownloadable beatmapset without link", () => container.BeatmapSet = new APIBeatmapSet
             {
-                OnlineInfo = new APIBeatmapSet
+                Availability = new BeatmapSetOnlineAvailability
                 {
-                    Availability = new BeatmapSetOnlineAvailability
-                    {
-                        DownloadDisabled = true,
-                    },
+                    DownloadDisabled = true,
                 },
             });
 
@@ -56,15 +50,12 @@ namespace osu.Game.Tests.Visual.Online
         [Test]
         public void TestPartsRemovedWithLink()
         {
-            AddStep("set parts-removed beatmapset with link", () => container.BeatmapSet = new BeatmapSetInfo
+            AddStep("set parts-removed beatmapset with link", () => container.BeatmapSet = new APIBeatmapSet
             {
-                OnlineInfo = new APIBeatmapSet
+                Availability = new BeatmapSetOnlineAvailability
                 {
-                    Availability = new BeatmapSetOnlineAvailability
-                    {
-                        DownloadDisabled = false,
-                        ExternalLink = @"https://osu.ppy.sh",
-                    },
+                    DownloadDisabled = false,
+                    ExternalLink = @"https://osu.ppy.sh",
                 },
             });
 
@@ -74,14 +65,11 @@ namespace osu.Game.Tests.Visual.Online
         [Test]
         public void TestNormal()
         {
-            AddStep("set normal beatmapset", () => container.BeatmapSet = new BeatmapSetInfo
+            AddStep("set normal beatmapset", () => container.BeatmapSet = new APIBeatmapSet
             {
-                OnlineInfo = new APIBeatmapSet
+                Availability = new BeatmapSetOnlineAvailability
                 {
-                    Availability = new BeatmapSetOnlineAvailability
-                    {
-                        DownloadDisabled = false,
-                    },
+                    DownloadDisabled = false,
                 },
             });
 
diff --git a/osu.Game.Tests/Visual/Online/TestSceneBeatmapRulesetSelector.cs b/osu.Game.Tests/Visual/Online/TestSceneBeatmapRulesetSelector.cs
index eb34187cd6..b880633559 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneBeatmapRulesetSelector.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneBeatmapRulesetSelector.cs
@@ -1,15 +1,15 @@
 // 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.Framework.Allocation;
 using osu.Framework.Graphics.UserInterface;
-using osu.Game.Beatmaps;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays;
 using osu.Game.Overlays.BeatmapSet;
 using osu.Game.Rulesets;
-using System.Collections.Generic;
-using System.Linq;
 
 namespace osu.Game.Tests.Visual.Online
 {
@@ -35,9 +35,9 @@ namespace osu.Game.Tests.Visual.Online
 
             AddStep("load multiple rulesets beatmapset", () =>
             {
-                selector.BeatmapSet = new BeatmapSetInfo
+                selector.BeatmapSet = new APIBeatmapSet
                 {
-                    Beatmaps = enabledRulesets.Select(r => new BeatmapInfo { Ruleset = r }).ToList()
+                    Beatmaps = enabledRulesets.Select(r => new APIBeatmap { RulesetID = r.OnlineID }).ToList()
                 };
             });
 
@@ -53,13 +53,13 @@ namespace osu.Game.Tests.Visual.Online
 
             AddStep("load single ruleset beatmapset", () =>
             {
-                selector.BeatmapSet = new BeatmapSetInfo
+                selector.BeatmapSet = new APIBeatmapSet
                 {
-                    Beatmaps = new List<BeatmapInfo>
+                    Beatmaps = new List<APIBeatmap>
                     {
-                        new BeatmapInfo
+                        new APIBeatmap
                         {
-                            Ruleset = enabledRuleset
+                            RulesetID = enabledRuleset.OnlineID
                         }
                     }
                 };
@@ -71,9 +71,9 @@ namespace osu.Game.Tests.Visual.Online
         [Test]
         public void TestEmptyBeatmapSet()
         {
-            AddStep("load empty beatmapset", () => selector.BeatmapSet = new BeatmapSetInfo
+            AddStep("load empty beatmapset", () => selector.BeatmapSet = new APIBeatmapSet
             {
-                Beatmaps = new List<BeatmapInfo>()
+                Beatmaps = new List<APIBeatmap>()
             });
 
             AddAssert("no ruleset selected", () => selector.SelectedTab == null);
diff --git a/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlay.cs b/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlay.cs
index 7f9b56e873..bae9af1897 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlay.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlay.cs
@@ -49,60 +49,48 @@ namespace osu.Game.Tests.Visual.Online
         {
             AddStep(@"show first", () =>
             {
-                overlay.ShowBeatmapSet(new BeatmapSetInfo
+                overlay.ShowBeatmapSet(new APIBeatmapSet
                 {
-                    OnlineBeatmapSetID = 1235,
-                    Metadata = new BeatmapMetadata
+                    OnlineID = 1235,
+                    Title = @"an awesome beatmap",
+                    Artist = @"naru narusegawa",
+                    Source = @"hinata sou",
+                    Tags = @"test tag tag more tag",
+                    Author = new User
                     {
-                        Title = @"an awesome beatmap",
-                        Artist = @"naru narusegawa",
-                        Source = @"hinata sou",
-                        Tags = @"test tag tag more tag",
-                        Author = new User
-                        {
-                            Username = @"BanchoBot",
-                            Id = 3,
-                        },
+                        Username = @"BanchoBot",
+                        Id = 3,
                     },
-                    OnlineInfo = new APIBeatmapSet
+                    Preview = @"https://b.ppy.sh/preview/12345.mp3",
+                    PlayCount = 123,
+                    FavouriteCount = 456,
+                    Submitted = DateTime.Now,
+                    Ranked = DateTime.Now,
+                    BPM = 111,
+                    HasVideo = true,
+                    Ratings = Enumerable.Range(0, 11).ToArray(),
+                    HasStoryboard = true,
+                    Covers = new BeatmapSetOnlineCovers(),
+                    Beatmaps = new List<APIBeatmap>
                     {
-                        Preview = @"https://b.ppy.sh/preview/12345.mp3",
-                        PlayCount = 123,
-                        FavouriteCount = 456,
-                        Submitted = DateTime.Now,
-                        Ranked = DateTime.Now,
-                        BPM = 111,
-                        HasVideo = true,
-                        Ratings = Enumerable.Range(0, 11).ToArray(),
-                        HasStoryboard = true,
-                        Covers = new BeatmapSetOnlineCovers(),
-                    },
-                    Beatmaps = new List<BeatmapInfo>
-                    {
-                        new BeatmapInfo
+                        new APIBeatmap
                         {
-                            StarDifficulty = 9.99,
-                            Version = @"TEST",
+                            StarRating = 9.99,
+                            DifficultyName = @"TEST",
                             Length = 456000,
-                            Ruleset = rulesets.GetRuleset(3),
-                            BaseDifficulty = new BeatmapDifficulty
+                            RulesetID = 3,
+                            CircleSize = 1,
+                            DrainRate = 2.3f,
+                            OverallDifficulty = 4.5f,
+                            ApproachRate = 6,
+                            CircleCount = 111,
+                            SliderCount = 12,
+                            PlayCount = 222,
+                            PassCount = 21,
+                            FailTimes = new APIFailTimes
                             {
-                                CircleSize = 1,
-                                DrainRate = 2.3f,
-                                OverallDifficulty = 4.5f,
-                                ApproachRate = 6,
-                            },
-                            OnlineInfo = new APIBeatmap
-                            {
-                                CircleCount = 111,
-                                SliderCount = 12,
-                                PlayCount = 222,
-                                PassCount = 21,
-                                FailTimes = new APIFailTimes
-                                {
-                                    Fails = Enumerable.Range(1, 100).Select(i => i % 12 - 6).ToArray(),
-                                    Retries = Enumerable.Range(-2, 100).Select(i => i % 12 - 6).ToArray(),
-                                },
+                                Fails = Enumerable.Range(1, 100).Select(i => i % 12 - 6).ToArray(),
+                                Retries = Enumerable.Range(-2, 100).Select(i => i % 12 - 6).ToArray(),
                             },
                         },
                     },
@@ -120,71 +108,15 @@ namespace osu.Game.Tests.Visual.Online
         {
             AddStep(@"show undownloadable", () =>
             {
-                overlay.ShowBeatmapSet(new BeatmapSetInfo
+                var set = getBeatmapSet();
+
+                set.Availability = new BeatmapSetOnlineAvailability
                 {
-                    OnlineBeatmapSetID = 1234,
-                    Metadata = new BeatmapMetadata
-                    {
-                        Title = @"undownloadable beatmap",
-                        Artist = @"no one",
-                        Source = @"some source",
-                        Tags = @"another test tag tag more test tags",
-                        Author = new User
-                        {
-                            Username = @"BanchoBot",
-                            Id = 3,
-                        },
-                    },
-                    OnlineInfo = new APIBeatmapSet
-                    {
-                        Availability = new BeatmapSetOnlineAvailability
-                        {
-                            DownloadDisabled = true,
-                            ExternalLink = "https://osu.ppy.sh",
-                        },
-                        Preview = @"https://b.ppy.sh/preview/1234.mp3",
-                        PlayCount = 123,
-                        FavouriteCount = 456,
-                        Submitted = DateTime.Now,
-                        Ranked = DateTime.Now,
-                        BPM = 111,
-                        HasVideo = true,
-                        HasStoryboard = true,
-                        Covers = new BeatmapSetOnlineCovers(),
-                        Language = new BeatmapSetOnlineLanguage { Id = 3, Name = "English" },
-                        Genre = new BeatmapSetOnlineGenre { Id = 4, Name = "Rock" },
-                        Ratings = Enumerable.Range(0, 11).ToArray(),
-                    },
-                    Beatmaps = new List<BeatmapInfo>
-                    {
-                        new BeatmapInfo
-                        {
-                            StarDifficulty = 5.67,
-                            Version = @"ANOTHER TEST",
-                            Length = 123000,
-                            Ruleset = rulesets.GetRuleset(1),
-                            BaseDifficulty = new BeatmapDifficulty
-                            {
-                                CircleSize = 9,
-                                DrainRate = 8,
-                                OverallDifficulty = 7,
-                                ApproachRate = 6,
-                            },
-                            OnlineInfo = new APIBeatmap
-                            {
-                                CircleCount = 123,
-                                SliderCount = 45,
-                                PlayCount = 567,
-                                PassCount = 89,
-                                FailTimes = new APIFailTimes
-                                {
-                                    Fails = Enumerable.Range(1, 100).Select(i => i % 12 - 6).ToArray(),
-                                    Retries = Enumerable.Range(-2, 100).Select(i => i % 12 - 6).ToArray(),
-                                },
-                            },
-                        },
-                    },
-                });
+                    DownloadDisabled = true,
+                    ExternalLink = "https://osu.ppy.sh",
+                };
+
+                overlay.ShowBeatmapSet(set);
             });
 
             downloadAssert(false);
@@ -195,48 +127,30 @@ namespace osu.Game.Tests.Visual.Online
         {
             AddStep("show multiple rulesets beatmap", () =>
             {
-                var beatmaps = new List<BeatmapInfo>();
+                var beatmaps = new List<APIBeatmap>();
 
                 foreach (var ruleset in rulesets.AvailableRulesets.Skip(1))
                 {
-                    beatmaps.Add(new BeatmapInfo
+                    beatmaps.Add(new APIBeatmap
                     {
-                        Version = ruleset.Name,
-                        Ruleset = ruleset,
-                        BaseDifficulty = new BeatmapDifficulty(),
-                        OnlineInfo = new APIBeatmap
+                        DifficultyName = ruleset.Name,
+                        RulesetID = ruleset.OnlineID,
+                        FailTimes = new APIFailTimes
                         {
-                            FailTimes = new APIFailTimes
-                            {
-                                Fails = Enumerable.Range(1, 100).Select(i => i % 12 - 6).ToArray(),
-                                Retries = Enumerable.Range(-2, 100).Select(i => i % 12 - 6).ToArray(),
-                            },
-                        }
+                            Fails = Enumerable.Range(1, 100).Select(i => i % 12 - 6).ToArray(),
+                            Retries = Enumerable.Range(-2, 100).Select(i => i % 12 - 6).ToArray(),
+                        },
                     });
                 }
 
-                overlay.ShowBeatmapSet(new BeatmapSetInfo
-                {
-                    Metadata = new BeatmapMetadata
-                    {
-                        Title = @"multiple rulesets beatmap",
-                        Artist = @"none",
-                        Author = new User
-                        {
-                            Username = "BanchoBot",
-                            Id = 3,
-                        }
-                    },
-                    OnlineInfo = new APIBeatmapSet
-                    {
-                        Covers = new BeatmapSetOnlineCovers(),
-                        Ratings = Enumerable.Range(0, 11).ToArray(),
-                    },
-                    Beatmaps = beatmaps
-                });
+                var set = getBeatmapSet();
+
+                set.Beatmaps = beatmaps;
+
+                overlay.ShowBeatmapSet(set);
             });
 
-            AddAssert("shown beatmaps of current ruleset", () => overlay.Header.HeaderContent.Picker.Difficulties.All(b => b.BeatmapInfo.Ruleset.Equals(overlay.Header.RulesetSelector.Current.Value)));
+            AddAssert("shown beatmaps of current ruleset", () => overlay.Header.HeaderContent.Picker.Difficulties.All(b => b.Beatmap.Ruleset.OnlineID == overlay.Header.RulesetSelector.Current.Value.OnlineID));
             AddAssert("left-most beatmap selected", () => overlay.Header.HeaderContent.Picker.Difficulties.First().State == BeatmapPicker.DifficultySelectorState.Selected);
         }
 
@@ -246,7 +160,7 @@ namespace osu.Game.Tests.Visual.Online
             AddStep("show explicit map", () =>
             {
                 var beatmapSet = getBeatmapSet();
-                beatmapSet.OnlineInfo.HasExplicitContent = true;
+                beatmapSet.HasExplicitContent = true;
                 overlay.ShowBeatmapSet(beatmapSet);
             });
         }
@@ -257,7 +171,7 @@ namespace osu.Game.Tests.Visual.Online
             AddStep("show featured map", () =>
             {
                 var beatmapSet = getBeatmapSet();
-                beatmapSet.OnlineInfo.TrackId = 1;
+                beatmapSet.TrackId = 1;
                 overlay.ShowBeatmapSet(beatmapSet);
             });
         }
@@ -274,63 +188,41 @@ namespace osu.Game.Tests.Visual.Online
             AddStep(@"show without reload", overlay.Show);
         }
 
-        private BeatmapSetInfo createManyDifficultiesBeatmapSet()
+        private APIBeatmapSet createManyDifficultiesBeatmapSet()
         {
-            var beatmaps = new List<BeatmapInfo>();
+            var set = getBeatmapSet();
+
+            var beatmaps = new List<APIBeatmap>();
 
             for (int i = 1; i < 41; i++)
             {
-                beatmaps.Add(new BeatmapInfo
+                beatmaps.Add(new APIBeatmap
                 {
-                    OnlineBeatmapID = i * 10,
-                    Version = $"Test #{i}",
-                    Ruleset = Ruleset.Value,
-                    StarDifficulty = 2 + i * 0.1,
-                    BaseDifficulty = new BeatmapDifficulty
+                    OnlineID = i * 10,
+                    DifficultyName = $"Test #{i}",
+                    RulesetID = Ruleset.Value.ID ?? -1,
+                    StarRating = 2 + i * 0.1,
+                    OverallDifficulty = 3.5f,
+                    FailTimes = new APIFailTimes
                     {
-                        OverallDifficulty = 3.5f,
+                        Fails = Enumerable.Range(1, 100).Select(j => j % 12 - 6).ToArray(),
+                        Retries = Enumerable.Range(-2, 100).Select(j => j % 12 - 6).ToArray(),
                     },
-                    OnlineInfo = new APIBeatmap
-                    {
-                        FailTimes = new APIFailTimes
-                        {
-                            Fails = Enumerable.Range(1, 100).Select(j => j % 12 - 6).ToArray(),
-                            Retries = Enumerable.Range(-2, 100).Select(j => j % 12 - 6).ToArray(),
-                        },
-                    }
                 });
             }
 
-            return new BeatmapSetInfo
-            {
-                OnlineBeatmapSetID = 123,
-                Metadata = new BeatmapMetadata
-                {
-                    Title = @"many difficulties beatmap",
-                    Artist = @"none",
-                    Author = new User
-                    {
-                        Username = @"BanchoBot",
-                        Id = 3,
-                    },
-                },
-                OnlineInfo = new APIBeatmapSet
-                {
-                    Preview = @"https://b.ppy.sh/preview/123.mp3",
-                    HasVideo = true,
-                    HasStoryboard = true,
-                    Covers = new BeatmapSetOnlineCovers(),
-                    Ratings = Enumerable.Range(0, 11).ToArray(),
-                },
-                Beatmaps = beatmaps,
-            };
+            set.Beatmaps = beatmaps;
+
+            return set;
         }
 
-        private BeatmapSetInfo getBeatmapSet()
+        private APIBeatmapSet getBeatmapSet()
         {
-            var beatmapSet = CreateBeatmap(Ruleset.Value).BeatmapInfo.BeatmapSet;
+            var beatmapSet = CreateAPIBeatmapSet(Ruleset.Value);
+
             // Make sure the overlay is reloaded (see `BeatmapSetInfo.Equals`).
-            beatmapSet.OnlineBeatmapSetID = nextBeatmapSetId++;
+            beatmapSet.OnlineID = nextBeatmapSetId++;
+
             return beatmapSet;
         }
 
diff --git a/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlayDetails.cs b/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlayDetails.cs
index d14f9f47d1..491a2d5d90 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlayDetails.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlayDetails.cs
@@ -44,27 +44,21 @@ namespace osu.Game.Tests.Visual.Online
             AddStep("set second set", () => details.BeatmapSet = secondSet);
             AddAssert("ratings set", () => details.Ratings.Ratings == secondSet.Ratings);
 
-            static BeatmapSetInfo createSet() => new BeatmapSetInfo
+            static APIBeatmapSet createSet() => new APIBeatmapSet
             {
-                Beatmaps = new List<BeatmapInfo>
+                Beatmaps = new List<APIBeatmap>
                 {
-                    new BeatmapInfo
+                    new APIBeatmap
                     {
-                        OnlineInfo = new APIBeatmap
+                        FailTimes = new APIFailTimes
                         {
-                            FailTimes = new APIFailTimes
-                            {
-                                Fails = Enumerable.Range(1, 100).Select(_ => RNG.Next(10)).ToArray(),
-                                Retries = Enumerable.Range(-2, 100).Select(_ => RNG.Next(10)).ToArray(),
-                            },
-                        }
+                            Fails = Enumerable.Range(1, 100).Select(_ => RNG.Next(10)).ToArray(),
+                            Retries = Enumerable.Range(-2, 100).Select(_ => RNG.Next(10)).ToArray(),
+                        },
                     }
                 },
-                OnlineInfo = new APIBeatmapSet
-                {
-                    Ratings = Enumerable.Range(0, 11).Select(_ => RNG.Next(10)).ToArray(),
-                    Status = BeatmapSetOnlineStatus.Ranked
-                }
+                Ratings = Enumerable.Range(0, 11).Select(_ => RNG.Next(10)).ToArray(),
+                Status = BeatmapSetOnlineStatus.Ranked
             };
         }
 
diff --git a/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlaySuccessRate.cs b/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlaySuccessRate.cs
index b3b67fcbca..be3fc7aff9 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlaySuccessRate.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlaySuccessRate.cs
@@ -59,21 +59,18 @@ namespace osu.Game.Tests.Visual.Online
             var firstBeatmap = createBeatmap();
             var secondBeatmap = createBeatmap();
 
-            AddStep("set first set", () => successRate.BeatmapInfo = firstBeatmap);
+            AddStep("set first set", () => successRate.Beatmap = firstBeatmap);
             AddAssert("ratings set", () => successRate.Graph.FailTimes == firstBeatmap.FailTimes);
 
-            AddStep("set second set", () => successRate.BeatmapInfo = secondBeatmap);
+            AddStep("set second set", () => successRate.Beatmap = secondBeatmap);
             AddAssert("ratings set", () => successRate.Graph.FailTimes == secondBeatmap.FailTimes);
 
-            static BeatmapInfo createBeatmap() => new BeatmapInfo
+            static APIBeatmap createBeatmap() => new APIBeatmap
             {
-                OnlineInfo = new APIBeatmap
+                FailTimes = new APIFailTimes
                 {
-                    FailTimes = new APIFailTimes
-                    {
-                        Fails = Enumerable.Range(1, 100).Select(_ => RNG.Next(10)).ToArray(),
-                        Retries = Enumerable.Range(-2, 100).Select(_ => RNG.Next(10)).ToArray(),
-                    }
+                    Fails = Enumerable.Range(1, 100).Select(_ => RNG.Next(10)).ToArray(),
+                    Retries = Enumerable.Range(-2, 100).Select(_ => RNG.Next(10)).ToArray(),
                 }
             };
         }
@@ -81,14 +78,11 @@ namespace osu.Game.Tests.Visual.Online
         [Test]
         public void TestOnlyFailMetrics()
         {
-            AddStep("set beatmap", () => successRate.BeatmapInfo = new BeatmapInfo
+            AddStep("set beatmap", () => successRate.Beatmap = new APIBeatmap
             {
-                OnlineInfo = new APIBeatmap
+                FailTimes = new APIFailTimes
                 {
-                    FailTimes = new APIFailTimes
-                    {
-                        Fails = Enumerable.Range(1, 100).ToArray(),
-                    }
+                    Fails = Enumerable.Range(1, 100).ToArray(),
                 }
             });
 
@@ -98,12 +92,9 @@ namespace osu.Game.Tests.Visual.Online
         [Test]
         public void TestEmptyMetrics()
         {
-            AddStep("set beatmap", () => successRate.BeatmapInfo = new BeatmapInfo
+            AddStep("set beatmap", () => successRate.Beatmap = new APIBeatmap
             {
-                OnlineInfo = new APIBeatmap
-                {
-                    FailTimes = new APIFailTimes(),
-                }
+                FailTimes = new APIFailTimes()
             });
 
             AddAssert("graph max values correct", () => successRate.ChildrenOfType<BarGraph>().All(graph => graph.MaxValue == 0));
diff --git a/osu.Game.Tests/Visual/Online/TestSceneDirectDownloadButton.cs b/osu.Game.Tests/Visual/Online/TestSceneDirectDownloadButton.cs
index bb7fcc2fce..f0cf88840a 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneDirectDownloadButton.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneDirectDownloadButton.cs
@@ -69,24 +69,7 @@ namespace osu.Game.Tests.Visual.Online
             AddAssert($"button {(enabled ? "enabled" : "disabled")}", () => downloadButton.DownloadEnabled == enabled);
         }
 
-        private BeatmapSetInfo createSoleily()
-        {
-            return new BeatmapSetInfo
-            {
-                ID = 1,
-                OnlineBeatmapSetID = 241526,
-                OnlineInfo = new APIBeatmapSet
-                {
-                    Availability = new BeatmapSetOnlineAvailability
-                    {
-                        DownloadDisabled = false,
-                        ExternalLink = string.Empty,
-                    },
-                },
-            };
-        }
-
-        private void createButtonWithBeatmap(BeatmapSetInfo beatmap)
+        private void createButtonWithBeatmap(IBeatmapSetInfo beatmap)
         {
             AddStep("create button", () =>
             {
@@ -112,32 +95,47 @@ namespace osu.Game.Tests.Visual.Online
             });
         }
 
-        private BeatmapSetInfo getDownloadableBeatmapSet()
+        private IBeatmapSetInfo createSoleily()
         {
-            var normal = CreateWorkingBeatmap(new OsuRuleset().RulesetInfo).BeatmapSetInfo;
-            normal.OnlineInfo.HasVideo = true;
-            normal.OnlineInfo.HasStoryboard = true;
-
-            return normal;
+            return new APIBeatmapSet
+            {
+                OnlineID = 241526,
+                Availability = new BeatmapSetOnlineAvailability
+                {
+                    DownloadDisabled = false,
+                    ExternalLink = string.Empty,
+                },
+            };
         }
 
-        private BeatmapSetInfo getUndownloadableBeatmapSet()
+        private IBeatmapSetInfo getDownloadableBeatmapSet()
         {
-            var beatmap = CreateWorkingBeatmap(new OsuRuleset().RulesetInfo).BeatmapSetInfo;
-            beatmap.Metadata.Artist = "test";
-            beatmap.Metadata.Title = "undownloadable";
-            beatmap.Metadata.AuthorString = "test";
+            var apiBeatmapSet = CreateWorkingBeatmap(new OsuRuleset().RulesetInfo).BeatmapSetInfo.OnlineInfo;
 
-            beatmap.OnlineInfo.HasVideo = true;
-            beatmap.OnlineInfo.HasStoryboard = true;
+            apiBeatmapSet.HasVideo = true;
+            apiBeatmapSet.HasStoryboard = true;
 
-            beatmap.OnlineInfo.Availability = new BeatmapSetOnlineAvailability
+            return apiBeatmapSet;
+        }
+
+        private IBeatmapSetInfo getUndownloadableBeatmapSet()
+        {
+            var apiBeatmapSet = CreateWorkingBeatmap(new OsuRuleset().RulesetInfo).BeatmapSetInfo.OnlineInfo;
+
+            apiBeatmapSet.Artist = "test";
+            apiBeatmapSet.Title = "undownloadable";
+            apiBeatmapSet.AuthorString = "test";
+
+            apiBeatmapSet.HasVideo = true;
+            apiBeatmapSet.HasStoryboard = true;
+
+            apiBeatmapSet.Availability = new BeatmapSetOnlineAvailability
             {
                 DownloadDisabled = true,
                 ExternalLink = "http://osu.ppy.sh",
             };
 
-            return beatmap;
+            return apiBeatmapSet;
         }
 
         private class TestDownloadButton : BeatmapPanelDownloadButton
@@ -146,7 +144,7 @@ namespace osu.Game.Tests.Visual.Online
 
             public DownloadState DownloadState => State.Value;
 
-            public TestDownloadButton(BeatmapSetInfo beatmapSet)
+            public TestDownloadButton(IBeatmapSetInfo beatmapSet)
                 : base(beatmapSet)
             {
             }
diff --git a/osu.Game.Tests/Visual/Online/TestSceneDirectPanel.cs b/osu.Game.Tests/Visual/Online/TestSceneDirectPanel.cs
index 6caca2a67c..9a3d998966 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneDirectPanel.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneDirectPanel.cs
@@ -18,104 +18,25 @@ namespace osu.Game.Tests.Visual.Online
     [Cached(typeof(IPreviewTrackOwner))]
     public class TestSceneDirectPanel : OsuTestScene, IPreviewTrackOwner
     {
-        private BeatmapSetInfo getUndownloadableBeatmapSet() => new BeatmapSetInfo
-        {
-            OnlineBeatmapSetID = 123,
-            Metadata = new BeatmapMetadata
-            {
-                Title = "undownloadable beatmap",
-                Artist = "test",
-                Source = "more tests",
-                Author = new User
-                {
-                    Username = "BanchoBot",
-                    Id = 3,
-                },
-            },
-            OnlineInfo = new APIBeatmapSet
-            {
-                Availability = new BeatmapSetOnlineAvailability
-                {
-                    DownloadDisabled = true,
-                },
-                Preview = @"https://b.ppy.sh/preview/12345.mp3",
-                PlayCount = 123,
-                FavouriteCount = 456,
-                BPM = 111,
-                HasVideo = true,
-                HasStoryboard = true,
-                Covers = new BeatmapSetOnlineCovers(),
-            },
-            Beatmaps = new List<BeatmapInfo>
-            {
-                new BeatmapInfo
-                {
-                    Ruleset = Ruleset.Value,
-                    Version = "Test",
-                    StarDifficulty = 6.42,
-                }
-            }
-        };
-
-        private BeatmapSetInfo getManyDifficultiesBeatmapSet(RulesetStore rulesets)
-        {
-            var beatmaps = new List<BeatmapInfo>();
-
-            for (int i = 0; i < 100; i++)
-            {
-                beatmaps.Add(new BeatmapInfo
-                {
-                    Ruleset = rulesets.GetRuleset(i % 4),
-                    StarDifficulty = 2 + i % 4 * 2,
-                    BaseDifficulty = new BeatmapDifficulty
-                    {
-                        OverallDifficulty = 3.5f,
-                    }
-                });
-            }
-
-            return new BeatmapSetInfo
-            {
-                OnlineBeatmapSetID = 1,
-                Metadata = new BeatmapMetadata
-                {
-                    Title = "many difficulties beatmap",
-                    Artist = "test",
-                    Author = new User
-                    {
-                        Username = "BanchoBot",
-                        Id = 3,
-                    }
-                },
-                OnlineInfo = new APIBeatmapSet
-                {
-                    HasVideo = true,
-                    HasStoryboard = true,
-                    Covers = new BeatmapSetOnlineCovers(),
-                },
-                Beatmaps = beatmaps,
-            };
-        }
-
         [BackgroundDependencyLoader]
         private void load(RulesetStore rulesets)
         {
             var normal = getBeatmapSet();
-            normal.OnlineInfo.HasVideo = true;
-            normal.OnlineInfo.HasStoryboard = true;
+            normal.HasVideo = true;
+            normal.HasStoryboard = true;
 
             var undownloadable = getUndownloadableBeatmapSet();
-            var manyDifficulties = getManyDifficultiesBeatmapSet(rulesets);
+            var manyDifficulties = getManyDifficultiesBeatmapSet();
 
             var explicitMap = getBeatmapSet();
-            explicitMap.OnlineInfo.HasExplicitContent = true;
+            explicitMap.HasExplicitContent = true;
 
             var featuredMap = getBeatmapSet();
-            featuredMap.OnlineInfo.TrackId = 1;
+            featuredMap.TrackId = 1;
 
             var explicitFeaturedMap = getBeatmapSet();
-            explicitFeaturedMap.OnlineInfo.HasExplicitContent = true;
-            explicitFeaturedMap.OnlineInfo.TrackId = 2;
+            explicitFeaturedMap.HasExplicitContent = true;
+            explicitFeaturedMap.TrackId = 2;
 
             Child = new BasicScrollContainer
             {
@@ -145,7 +66,72 @@ namespace osu.Game.Tests.Visual.Online
                 },
             };
 
-            BeatmapSetInfo getBeatmapSet() => CreateBeatmap(Ruleset.Value).BeatmapInfo.BeatmapSet;
+            APIBeatmapSet getBeatmapSet() => CreateAPIBeatmapSet(Ruleset.Value);
+
+            APIBeatmapSet getUndownloadableBeatmapSet() => new APIBeatmapSet
+            {
+                OnlineID = 123,
+                Title = "undownloadable beatmap",
+                Artist = "test",
+                Source = "more tests",
+                Author = new User
+                {
+                    Username = "BanchoBot",
+                    Id = 3,
+                },
+                Availability = new BeatmapSetOnlineAvailability
+                {
+                    DownloadDisabled = true,
+                },
+                Preview = @"https://b.ppy.sh/preview/12345.mp3",
+                PlayCount = 123,
+                FavouriteCount = 456,
+                BPM = 111,
+                HasVideo = true,
+                HasStoryboard = true,
+                Covers = new BeatmapSetOnlineCovers(),
+                Beatmaps = new List<APIBeatmap>
+                {
+                    new APIBeatmap
+                    {
+                        RulesetID = Ruleset.Value.ID ?? 0,
+                        DifficultyName = "Test",
+                        StarRating = 6.42,
+                    }
+                }
+            };
+
+            APIBeatmapSet getManyDifficultiesBeatmapSet()
+            {
+                var beatmaps = new List<APIBeatmap>();
+
+                for (int i = 0; i < 100; i++)
+                {
+                    beatmaps.Add(new APIBeatmap
+                    {
+                        RulesetID = i % 4,
+                        StarRating = 2 + i % 4 * 2,
+                        OverallDifficulty = 3.5f,
+                    });
+                }
+
+                return new APIBeatmapSet
+                {
+                    OnlineID = 1,
+                    Title = "undownloadable beatmap",
+                    Artist = "test",
+                    Source = "more tests",
+                    Author = new User
+                    {
+                        Username = "BanchoBot",
+                        Id = 3,
+                    },
+                    HasVideo = true,
+                    HasStoryboard = true,
+                    Covers = new BeatmapSetOnlineCovers(),
+                    Beatmaps = beatmaps,
+                };
+            }
         }
     }
 }
diff --git a/osu.Game.Tests/Visual/Online/TestSceneFavouriteButton.cs b/osu.Game.Tests/Visual/Online/TestSceneFavouriteButton.cs
index 8e2ee4e28d..87458da578 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneFavouriteButton.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneFavouriteButton.cs
@@ -4,7 +4,7 @@
 using NUnit.Framework;
 using osu.Framework.Graphics;
 using osu.Framework.Testing;
-using osu.Game.Beatmaps;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays.BeatmapSet.Buttons;
 using osuTK;
 
@@ -29,7 +29,7 @@ namespace osu.Game.Tests.Visual.Online
         [Test]
         public void TestLoggedOutIn()
         {
-            AddStep("set valid beatmap", () => favourite.BeatmapSet.Value = new BeatmapSetInfo { OnlineBeatmapSetID = 88 });
+            AddStep("set valid beatmap", () => favourite.BeatmapSet.Value = new APIBeatmapSet { OnlineID = 88 });
             AddStep("log out", () => API.Logout());
             checkEnabled(false);
             AddStep("log in", () => API.Login("test", "test"));
@@ -40,9 +40,9 @@ namespace osu.Game.Tests.Visual.Online
         public void TestBeatmapChange()
         {
             AddStep("log in", () => API.Login("test", "test"));
-            AddStep("set valid beatmap", () => favourite.BeatmapSet.Value = new BeatmapSetInfo { OnlineBeatmapSetID = 88 });
+            AddStep("set valid beatmap", () => favourite.BeatmapSet.Value = new APIBeatmapSet { OnlineID = 88 });
             checkEnabled(true);
-            AddStep("set invalid beatmap", () => favourite.BeatmapSet.Value = new BeatmapSetInfo());
+            AddStep("set invalid beatmap", () => favourite.BeatmapSet.Value = new APIBeatmapSet());
             checkEnabled(false);
         }
 
diff --git a/osu.Game.Tests/Visual/Online/TestSceneLeaderboardModSelector.cs b/osu.Game.Tests/Visual/Online/TestSceneLeaderboardModSelector.cs
index fc438ce6dd..aa442ded02 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneLeaderboardModSelector.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneLeaderboardModSelector.cs
@@ -26,7 +26,8 @@ namespace osu.Game.Tests.Visual.Online
         {
             LeaderboardModSelector modSelector;
             FillFlowContainer<SpriteText> selectedMods;
-            var ruleset = new Bindable<RulesetInfo>();
+
+            var ruleset = new Bindable<IRulesetInfo>();
 
             Add(selectedMods = new FillFlowContainer<SpriteText>
             {
diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneAdvancedStats.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneAdvancedStats.cs
index 4538e36c5e..6a2b577fd3 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneAdvancedStats.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneAdvancedStats.cs
@@ -124,7 +124,7 @@ namespace osu.Game.Tests.Visual.SongSelect
             {
                 var ruleset = advancedStats.BeatmapInfo.Ruleset.CreateInstance();
                 var difficultyAdjustMod = ruleset.CreateMod<ModDifficultyAdjust>();
-                difficultyAdjustMod.ReadFromDifficulty(advancedStats.BeatmapInfo.BaseDifficulty);
+                difficultyAdjustMod.ReadFromDifficulty(advancedStats.BeatmapInfo.Difficulty);
                 SelectedMods.Value = new[] { difficultyAdjustMod };
             });
 
@@ -143,7 +143,7 @@ namespace osu.Game.Tests.Visual.SongSelect
             {
                 var ruleset = advancedStats.BeatmapInfo.Ruleset.CreateInstance();
                 var difficultyAdjustMod = ruleset.CreateMod<OsuModDifficultyAdjust>();
-                var originalDifficulty = advancedStats.BeatmapInfo.BaseDifficulty;
+                var originalDifficulty = advancedStats.BeatmapInfo.Difficulty;
 
                 difficultyAdjustMod.ReadFromDifficulty(originalDifficulty);
                 difficultyAdjustMod.DrainRate.Value = originalDifficulty.DrainRate - 0.5f;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneBeatmapListingSearchControl.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneBeatmapListingSearchControl.cs
index a9fe7ed7d8..f17de75f5c 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneBeatmapListingSearchControl.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneBeatmapListingSearchControl.cs
@@ -110,25 +110,19 @@ namespace osu.Game.Tests.Visual.UserInterface
             base.Dispose(isDisposing);
         }
 
-        private static readonly BeatmapSetInfo beatmap_set = new BeatmapSetInfo
+        private static readonly APIBeatmapSet beatmap_set = new APIBeatmapSet
         {
-            OnlineInfo = new APIBeatmapSet
+            Covers = new BeatmapSetOnlineCovers
             {
-                Covers = new BeatmapSetOnlineCovers
-                {
-                    Cover = "https://assets.ppy.sh/beatmaps/1094296/covers/cover@2x.jpg?1581416305"
-                }
+                Cover = "https://assets.ppy.sh/beatmaps/1094296/covers/cover@2x.jpg?1581416305"
             }
         };
 
-        private static readonly BeatmapSetInfo no_cover_beatmap_set = new BeatmapSetInfo
+        private static readonly APIBeatmapSet no_cover_beatmap_set = new APIBeatmapSet
         {
-            OnlineInfo = new APIBeatmapSet
+            Covers = new BeatmapSetOnlineCovers
             {
-                Covers = new BeatmapSetOnlineCovers
-                {
-                    Cover = string.Empty
-                }
+                Cover = string.Empty
             }
         };
     }
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneUpdateableBeatmapBackgroundSprite.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneUpdateableBeatmapBackgroundSprite.cs
index 74cd675a05..d30f1e8889 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneUpdateableBeatmapBackgroundSprite.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneUpdateableBeatmapBackgroundSprite.cs
@@ -12,6 +12,7 @@ using osu.Game.Beatmaps.Drawables;
 using osu.Game.Graphics.Containers;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets;
 using osu.Game.Tests.Beatmaps.IO;
 using osuTK;
@@ -24,7 +25,6 @@ namespace osu.Game.Tests.Visual.UserInterface
 
         private BeatmapSetInfo testBeatmap;
         private IAPIProvider api;
-        private RulesetStore rulesets;
 
         [Resolved]
         private BeatmapManager beatmaps { get; set; }
@@ -33,7 +33,6 @@ namespace osu.Game.Tests.Visual.UserInterface
         private void load(OsuGameBase osu, IAPIProvider api, RulesetStore rulesets)
         {
             this.api = api;
-            this.rulesets = rulesets;
 
             testBeatmap = ImportBeatmapTest.LoadOszIntoOsu(osu).Result;
         }
@@ -81,7 +80,7 @@ namespace osu.Game.Tests.Visual.UserInterface
                     Child = background = new TestUpdateableBeatmapBackgroundSprite
                     {
                         RelativeSizeAxes = Axes.Both,
-                        Beatmap = { Value = new BeatmapInfo { BeatmapSet = req.Response?.ToBeatmapSet(rulesets) } }
+                        Beatmap = { Value = new APIBeatmap { BeatmapSet = req.Response } }
                     };
                 });
 
diff --git a/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs b/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs
index 061e034648..653b011f73 100644
--- a/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs
@@ -100,10 +100,10 @@ namespace osu.Game.Online.API.Requests.Responses
                 MaxCombo = MaxCombo,
                 BaseDifficulty = new BeatmapDifficulty
                 {
-                    DrainRate = drainRate,
-                    CircleSize = circleSize,
-                    ApproachRate = approachRate,
-                    OverallDifficulty = overallDifficulty,
+                    DrainRate = DrainRate,
+                    CircleSize = CircleSize,
+                    ApproachRate = ApproachRate,
+                    OverallDifficulty = OverallDifficulty,
                 },
                 OnlineInfo = this,
             };
diff --git a/osu.Game/Overlays/BeatmapListing/BeatmapListingFilterControl.cs b/osu.Game/Overlays/BeatmapListing/BeatmapListingFilterControl.cs
index 03d36ff5df..fa57191ef3 100644
--- a/osu.Game/Overlays/BeatmapListing/BeatmapListingFilterControl.cs
+++ b/osu.Game/Overlays/BeatmapListing/BeatmapListingFilterControl.cs
@@ -12,9 +12,9 @@ using osu.Framework.Graphics.Effects;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Localisation;
 using osu.Framework.Threading;
-using osu.Game.Beatmaps;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets;
 using osu.Game.Resources.Localisation.Web;
 using osuTK;
@@ -206,7 +206,7 @@ namespace osu.Game.Overlays.BeatmapListing
 
             getSetsRequest.Success += response =>
             {
-                var sets = response.BeatmapSets.Select(responseJson => responseJson.ToBeatmapSet(rulesets)).ToList();
+                var sets = response.BeatmapSets.ToList();
 
                 // If the previous request returned a null cursor, the API is indicating we can't paginate further (maybe there are no more beatmaps left).
                 if (sets.Count == 0 || response.Cursor == null)
@@ -289,7 +289,7 @@ namespace osu.Game.Overlays.BeatmapListing
             /// Contains the beatmap sets returned from API.
             /// Valid for read if and only if <see cref="Type"/> is <see cref="SearchResultType.ResultsReturned"/>.
             /// </summary>
-            public List<BeatmapSetInfo> Results { get; private set; }
+            public List<APIBeatmapSet> Results { get; private set; }
 
             /// <summary>
             /// Contains the names of supporter-only filters requested by the user.
@@ -297,7 +297,7 @@ namespace osu.Game.Overlays.BeatmapListing
             /// </summary>
             public List<LocalisableString> SupporterOnlyFiltersUsed { get; private set; }
 
-            public static SearchResult ResultsReturned(List<BeatmapSetInfo> results) => new SearchResult
+            public static SearchResult ResultsReturned(List<APIBeatmapSet> results) => new SearchResult
             {
                 Type = SearchResultType.ResultsReturned,
                 Results = results
diff --git a/osu.Game/Overlays/BeatmapListing/BeatmapListingSearchControl.cs b/osu.Game/Overlays/BeatmapListing/BeatmapListingSearchControl.cs
index 776a8e73b0..2474515802 100644
--- a/osu.Game/Overlays/BeatmapListing/BeatmapListingSearchControl.cs
+++ b/osu.Game/Overlays/BeatmapListing/BeatmapListingSearchControl.cs
@@ -8,12 +8,12 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Input.Events;
-using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.Drawables;
 using osu.Game.Configuration;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Input.Bindings;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Resources.Localisation.Web;
 using osu.Game.Rulesets;
 using osu.Game.Scoring;
@@ -49,17 +49,17 @@ namespace osu.Game.Overlays.BeatmapListing
 
         public Bindable<SearchExplicit> ExplicitContent => explicitContentFilter.Current;
 
-        public BeatmapSetInfo BeatmapSet
+        public APIBeatmapSet BeatmapSet
         {
             set
             {
-                if (value == null || string.IsNullOrEmpty(value.OnlineInfo.Covers.Cover))
+                if (value == null || string.IsNullOrEmpty(value.Covers.Cover))
                 {
                     beatmapCover.FadeOut(600, Easing.OutQuint);
                     return;
                 }
 
-                beatmapCover.OnlineInfo = value.OnlineInfo;
+                beatmapCover.OnlineInfo = value;
                 beatmapCover.FadeTo(0.1f, 200, Easing.OutQuint);
             }
         }
diff --git a/osu.Game/Overlays/BeatmapListing/Panels/BeatmapPanel.cs b/osu.Game/Overlays/BeatmapListing/Panels/BeatmapPanel.cs
index c7fa98f159..2fd05f6742 100644
--- a/osu.Game/Overlays/BeatmapListing/Panels/BeatmapPanel.cs
+++ b/osu.Game/Overlays/BeatmapListing/Panels/BeatmapPanel.cs
@@ -23,6 +23,7 @@ using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.UserInterface;
+using osu.Game.Online.API.Requests.Responses;
 using osuTK;
 using osuTK.Graphics;
 
@@ -30,7 +31,7 @@ namespace osu.Game.Overlays.BeatmapListing.Panels
 {
     public abstract class BeatmapPanel : OsuClickableContainer, IHasContextMenu
     {
-        public readonly BeatmapSetInfo SetInfo;
+        public readonly APIBeatmapSet SetInfo;
 
         private const double hover_transition_time = 400;
         private const int maximum_difficulty_icons = 10;
@@ -49,10 +50,10 @@ namespace osu.Game.Overlays.BeatmapListing.Panels
 
         protected Action ViewBeatmap;
 
-        protected BeatmapPanel(BeatmapSetInfo setInfo)
+        protected BeatmapPanel(APIBeatmapSet setInfo)
             : base(HoverSampleSet.Submit)
         {
-            Debug.Assert(setInfo.OnlineBeatmapSetID != null);
+            Debug.Assert(setInfo.OnlineID > 0);
 
             SetInfo = setInfo;
         }
@@ -95,8 +96,8 @@ namespace osu.Game.Overlays.BeatmapListing.Panels
 
             Action = ViewBeatmap = () =>
             {
-                Debug.Assert(SetInfo.OnlineBeatmapSetID != null);
-                beatmapSetOverlay?.FetchAndShowBeatmapSet(SetInfo.OnlineBeatmapSetID.Value);
+                Debug.Assert(SetInfo.OnlineID > 0);
+                beatmapSetOverlay?.FetchAndShowBeatmapSet(SetInfo.OnlineID);
             };
         }
 
@@ -146,14 +147,14 @@ namespace osu.Game.Overlays.BeatmapListing.Panels
         {
             var icons = new List<DifficultyIcon>();
 
-            if (SetInfo.Beatmaps.Count > maximum_difficulty_icons)
+            if (SetInfo.Beatmaps.Count() > maximum_difficulty_icons)
             {
                 foreach (var ruleset in SetInfo.Beatmaps.Select(b => b.Ruleset).Distinct())
-                    icons.Add(new GroupedDifficultyIcon(SetInfo.Beatmaps.FindAll(b => b.Ruleset.Equals(ruleset)), ruleset, this is ListBeatmapPanel ? Color4.White : colours.Gray5));
+                    icons.Add(new GroupedDifficultyIcon(SetInfo.Beatmaps.Where(b => b.RulesetID == ruleset.OnlineID).ToList(), ruleset, this is ListBeatmapPanel ? Color4.White : colours.Gray5));
             }
             else
             {
-                foreach (var b in SetInfo.Beatmaps.OrderBy(beatmap => beatmap.Ruleset.ID).ThenBy(beatmap => beatmap.StarDifficulty))
+                foreach (var b in SetInfo.Beatmaps.OrderBy(beatmap => beatmap.RulesetID).ThenBy(beatmap => beatmap.StarRating))
                     icons.Add(new DifficultyIcon(b));
             }
 
@@ -163,7 +164,7 @@ namespace osu.Game.Overlays.BeatmapListing.Panels
         protected Drawable CreateBackground() => new UpdateableOnlineBeatmapSetCover
         {
             RelativeSizeAxes = Axes.Both,
-            OnlineInfo = SetInfo.OnlineInfo,
+            OnlineInfo = SetInfo,
         };
 
         public class Statistic : FillFlowContainer
diff --git a/osu.Game/Overlays/BeatmapListing/Panels/BeatmapPanelDownloadButton.cs b/osu.Game/Overlays/BeatmapListing/Panels/BeatmapPanelDownloadButton.cs
index dd12e8e467..d7c2837f4d 100644
--- a/osu.Game/Overlays/BeatmapListing/Panels/BeatmapPanelDownloadButton.cs
+++ b/osu.Game/Overlays/BeatmapListing/Panels/BeatmapPanelDownloadButton.cs
@@ -11,6 +11,7 @@ using osu.Game.Configuration;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Online;
+using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Overlays.BeatmapListing.Panels
 {
@@ -21,7 +22,7 @@ namespace osu.Game.Overlays.BeatmapListing.Panels
         /// <summary>
         /// Currently selected beatmap. Used to present the correct difficulty after completing a download.
         /// </summary>
-        public readonly IBindable<BeatmapInfo> SelectedBeatmap = new Bindable<BeatmapInfo>();
+        public readonly IBindable<APIBeatmap> SelectedBeatmap = new Bindable<APIBeatmap>();
 
         private readonly ShakeContainer shakeContainer;
         private readonly DownloadButton button;
@@ -31,9 +32,9 @@ namespace osu.Game.Overlays.BeatmapListing.Panels
 
         protected readonly Bindable<DownloadState> State = new Bindable<DownloadState>();
 
-        private readonly BeatmapSetInfo beatmapSet;
+        private readonly IBeatmapSetInfo beatmapSet;
 
-        public BeatmapPanelDownloadButton(BeatmapSetInfo beatmapSet)
+        public BeatmapPanelDownloadButton(IBeatmapSetInfo beatmapSet)
         {
             this.beatmapSet = beatmapSet;
 
@@ -79,13 +80,13 @@ namespace osu.Game.Overlays.BeatmapListing.Panels
                     case DownloadState.LocallyAvailable:
                         Predicate<BeatmapInfo> findPredicate = null;
                         if (SelectedBeatmap.Value != null)
-                            findPredicate = b => b.OnlineBeatmapID == SelectedBeatmap.Value.OnlineBeatmapID;
+                            findPredicate = b => b.OnlineBeatmapID == SelectedBeatmap.Value.OnlineID;
 
                         game?.PresentBeatmap(beatmapSet, findPredicate);
                         break;
 
                     default:
-                        beatmaps.Download(beatmapSet, noVideoSetting.Value);
+                        beatmaps.Download(new BeatmapSetInfo { OnlineBeatmapSetID = beatmapSet.OnlineID }, noVideoSetting.Value);
                         break;
                 }
             };
@@ -100,7 +101,7 @@ namespace osu.Game.Overlays.BeatmapListing.Panels
                         break;
 
                     default:
-                        if (beatmapSet.OnlineInfo?.Availability.DownloadDisabled ?? false)
+                        if ((beatmapSet as IBeatmapSetOnlineInfo)?.Availability.DownloadDisabled == true)
                         {
                             button.Enabled.Value = false;
                             button.TooltipText = "this beatmap is currently not available for download.";
diff --git a/osu.Game/Overlays/BeatmapListing/Panels/DownloadProgressBar.cs b/osu.Game/Overlays/BeatmapListing/Panels/DownloadProgressBar.cs
index 24f929f55e..93eaf775e0 100644
--- a/osu.Game/Overlays/BeatmapListing/Panels/DownloadProgressBar.cs
+++ b/osu.Game/Overlays/BeatmapListing/Panels/DownloadProgressBar.cs
@@ -18,7 +18,7 @@ namespace osu.Game.Overlays.BeatmapListing.Panels
         private readonly ProgressBar progressBar;
         private readonly BeatmapDownloadTracker downloadTracker;
 
-        public DownloadProgressBar(BeatmapSetInfo beatmapSet)
+        public DownloadProgressBar(IBeatmapSetInfo beatmapSet)
         {
             InternalChildren = new Drawable[]
             {
diff --git a/osu.Game/Overlays/BeatmapListing/Panels/GridBeatmapPanel.cs b/osu.Game/Overlays/BeatmapListing/Panels/GridBeatmapPanel.cs
index 4a0fa59c31..770e5af7bd 100644
--- a/osu.Game/Overlays/BeatmapListing/Panels/GridBeatmapPanel.cs
+++ b/osu.Game/Overlays/BeatmapListing/Panels/GridBeatmapPanel.cs
@@ -9,11 +9,11 @@ using osu.Framework.Graphics.Shapes;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Input.Events;
 using osu.Framework.Localisation;
-using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.Drawables;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays.BeatmapSet;
 using osuTK;
 using osuTK.Graphics;
@@ -32,7 +32,7 @@ namespace osu.Game.Overlays.BeatmapListing.Panels
         protected override PlayButton PlayButton => playButton;
         protected override Box PreviewBar => progressBar;
 
-        public GridBeatmapPanel(BeatmapSetInfo beatmap)
+        public GridBeatmapPanel(APIBeatmapSet beatmap)
             : base(beatmap)
         {
             Width = 380;
@@ -84,7 +84,7 @@ namespace osu.Game.Overlays.BeatmapListing.Panels
                                     {
                                         new OsuSpriteText
                                         {
-                                            Text = new RomanisableString(SetInfo.Metadata.TitleUnicode, SetInfo.Metadata.Title),
+                                            Text = new RomanisableString(SetInfo.TitleUnicode, SetInfo.Title),
                                             Font = OsuFont.GetFont(size: 18, weight: FontWeight.Bold, italics: true)
                                         },
                                     }
@@ -97,7 +97,7 @@ namespace osu.Game.Overlays.BeatmapListing.Panels
                                     {
                                         new OsuSpriteText
                                         {
-                                            Text = new RomanisableString(SetInfo.Metadata.ArtistUnicode, SetInfo.Metadata.Artist),
+                                            Text = new RomanisableString(SetInfo.ArtistUnicode, SetInfo.Artist),
                                             Font = OsuFont.GetFont(weight: FontWeight.Bold, italics: true)
                                         }
                                     }
@@ -145,7 +145,7 @@ namespace osu.Game.Overlays.BeatmapListing.Panels
                                         {
                                             d.AutoSizeAxes = Axes.Both;
                                             d.AddText("mapped by ", t => t.Colour = colours.Gray5);
-                                            d.AddUserLink(SetInfo.Metadata.Author);
+                                            d.AddUserLink(SetInfo.Author);
                                         }),
                                         new Container
                                         {
@@ -155,11 +155,11 @@ namespace osu.Game.Overlays.BeatmapListing.Panels
                                             {
                                                 new OsuSpriteText
                                                 {
-                                                    Text = SetInfo.Metadata.Source,
+                                                    Text = SetInfo.Source,
                                                     Font = OsuFont.GetFont(size: 14),
                                                     Shadow = false,
                                                     Colour = colours.Gray5,
-                                                    Alpha = string.IsNullOrEmpty(SetInfo.Metadata.Source) ? 0f : 1f,
+                                                    Alpha = string.IsNullOrEmpty(SetInfo.Source) ? 0f : 1f,
                                                 },
                                             },
                                         },
@@ -193,8 +193,8 @@ namespace osu.Game.Overlays.BeatmapListing.Panels
                     Margin = new MarginPadding { Top = vertical_padding, Right = vertical_padding },
                     Children = new[]
                     {
-                        new Statistic(FontAwesome.Solid.PlayCircle, SetInfo.OnlineInfo?.PlayCount ?? 0),
-                        new Statistic(FontAwesome.Solid.Heart, SetInfo.OnlineInfo?.FavouriteCount ?? 0),
+                        new Statistic(FontAwesome.Solid.PlayCircle, SetInfo.PlayCount),
+                        new Statistic(FontAwesome.Solid.Heart, SetInfo.FavouriteCount),
                     },
                 },
                 statusContainer = new FillFlowContainer
@@ -211,7 +211,7 @@ namespace osu.Game.Overlays.BeatmapListing.Panels
                 },
             });
 
-            if (SetInfo.OnlineInfo?.HasExplicitContent ?? false)
+            if (SetInfo.HasExplicitContent)
             {
                 titleContainer.Add(new ExplicitContentBeatmapPill
                 {
@@ -221,7 +221,7 @@ namespace osu.Game.Overlays.BeatmapListing.Panels
                 });
             }
 
-            if (SetInfo.OnlineInfo?.TrackId != null)
+            if (SetInfo.TrackId != null)
             {
                 artistContainer.Add(new FeaturedArtistBeatmapPill
                 {
@@ -231,12 +231,12 @@ namespace osu.Game.Overlays.BeatmapListing.Panels
                 });
             }
 
-            if (SetInfo.OnlineInfo?.HasVideo ?? false)
+            if (SetInfo.HasVideo)
             {
                 statusContainer.Add(new IconPill(FontAwesome.Solid.Film));
             }
 
-            if (SetInfo.OnlineInfo?.HasStoryboard ?? false)
+            if (SetInfo.HasStoryboard)
             {
                 statusContainer.Add(new IconPill(FontAwesome.Solid.Image));
             }
@@ -246,7 +246,7 @@ namespace osu.Game.Overlays.BeatmapListing.Panels
                 AutoSizeAxes = Axes.Both,
                 TextSize = 12,
                 TextPadding = new MarginPadding { Horizontal = 10, Vertical = 5 },
-                Status = SetInfo.OnlineInfo?.Status ?? BeatmapSetOnlineStatus.None,
+                Status = SetInfo.Status,
             });
 
             PreviewPlaying.ValueChanged += _ => updateStatusContainer();
diff --git a/osu.Game/Overlays/BeatmapListing/Panels/ListBeatmapPanel.cs b/osu.Game/Overlays/BeatmapListing/Panels/ListBeatmapPanel.cs
index 63d651f9de..dcd676724a 100644
--- a/osu.Game/Overlays/BeatmapListing/Panels/ListBeatmapPanel.cs
+++ b/osu.Game/Overlays/BeatmapListing/Panels/ListBeatmapPanel.cs
@@ -9,11 +9,11 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Localisation;
-using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.Drawables;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays.BeatmapSet;
 using osuTK;
 using osuTK.Graphics;
@@ -37,7 +37,7 @@ namespace osu.Game.Overlays.BeatmapListing.Panels
         protected override PlayButton PlayButton => playButton;
         protected override Box PreviewBar => progressBar;
 
-        public ListBeatmapPanel(BeatmapSetInfo beatmap)
+        public ListBeatmapPanel(APIBeatmapSet beatmap)
             : base(beatmap)
         {
             RelativeSizeAxes = Axes.X;
@@ -107,7 +107,7 @@ namespace osu.Game.Overlays.BeatmapListing.Panels
                                                             {
                                                                 new OsuSpriteText
                                                                 {
-                                                                    Text = new RomanisableString(SetInfo.Metadata.TitleUnicode, SetInfo.Metadata.Title),
+                                                                    Text = new RomanisableString(SetInfo.TitleUnicode, SetInfo.Title),
                                                                     Font = OsuFont.GetFont(size: 18, weight: FontWeight.Bold, italics: true)
                                                                 },
                                                             }
@@ -120,7 +120,7 @@ namespace osu.Game.Overlays.BeatmapListing.Panels
                                                             {
                                                                 new OsuSpriteText
                                                                 {
-                                                                    Text = new RomanisableString(SetInfo.Metadata.ArtistUnicode, SetInfo.Metadata.Artist),
+                                                                    Text = new RomanisableString(SetInfo.ArtistUnicode, SetInfo.Artist),
                                                                     Font = OsuFont.GetFont(weight: FontWeight.Bold, italics: true)
                                                                 },
                                                             },
@@ -182,8 +182,8 @@ namespace osu.Game.Overlays.BeatmapListing.Panels
                                     Direction = FillDirection.Vertical,
                                     Children = new Drawable[]
                                     {
-                                        new Statistic(FontAwesome.Solid.PlayCircle, SetInfo.OnlineInfo?.PlayCount ?? 0),
-                                        new Statistic(FontAwesome.Solid.Heart, SetInfo.OnlineInfo?.FavouriteCount ?? 0),
+                                        new Statistic(FontAwesome.Solid.PlayCircle, SetInfo.PlayCount),
+                                        new Statistic(FontAwesome.Solid.Heart, SetInfo.FavouriteCount),
                                         new LinkFlowContainer(s =>
                                         {
                                             s.Shadow = false;
@@ -197,15 +197,15 @@ namespace osu.Game.Overlays.BeatmapListing.Panels
                                         {
                                             d.AutoSizeAxes = Axes.Both;
                                             d.AddText("mapped by ");
-                                            d.AddUserLink(SetInfo.Metadata.Author);
+                                            d.AddUserLink(SetInfo.Author);
                                         }),
                                         new OsuSpriteText
                                         {
-                                            Text = SetInfo.Metadata.Source,
+                                            Text = SetInfo.Source,
                                             Anchor = Anchor.TopRight,
                                             Origin = Anchor.TopRight,
                                             Font = OsuFont.GetFont(size: 14),
-                                            Alpha = string.IsNullOrEmpty(SetInfo.Metadata.Source) ? 0f : 1f,
+                                            Alpha = string.IsNullOrEmpty(SetInfo.Source) ? 0f : 1f,
                                         },
                                     },
                                 },
@@ -225,7 +225,7 @@ namespace osu.Game.Overlays.BeatmapListing.Panels
                 },
             });
 
-            if (SetInfo.OnlineInfo?.HasExplicitContent ?? false)
+            if (SetInfo.HasExplicitContent)
             {
                 titleContainer.Add(new ExplicitContentBeatmapPill
                 {
@@ -235,7 +235,7 @@ namespace osu.Game.Overlays.BeatmapListing.Panels
                 });
             }
 
-            if (SetInfo.OnlineInfo?.TrackId != null)
+            if (SetInfo.TrackId != null)
             {
                 artistContainer.Add(new FeaturedArtistBeatmapPill
                 {
@@ -245,12 +245,12 @@ namespace osu.Game.Overlays.BeatmapListing.Panels
                 });
             }
 
-            if (SetInfo.OnlineInfo?.HasVideo ?? false)
+            if (SetInfo.HasVideo)
             {
                 statusContainer.Add(new IconPill(FontAwesome.Solid.Film) { IconSize = new Vector2(20) });
             }
 
-            if (SetInfo.OnlineInfo?.HasStoryboard ?? false)
+            if (SetInfo.HasStoryboard)
             {
                 statusContainer.Add(new IconPill(FontAwesome.Solid.Image) { IconSize = new Vector2(20) });
             }
@@ -260,7 +260,7 @@ namespace osu.Game.Overlays.BeatmapListing.Panels
                 AutoSizeAxes = Axes.Both,
                 TextSize = 12,
                 TextPadding = new MarginPadding { Horizontal = 10, Vertical = 4 },
-                Status = SetInfo.OnlineInfo?.Status ?? BeatmapSetOnlineStatus.None,
+                Status = SetInfo.Status,
             });
         }
     }
diff --git a/osu.Game/Overlays/BeatmapListing/Panels/PlayButton.cs b/osu.Game/Overlays/BeatmapListing/Panels/PlayButton.cs
index 3aa9aa5ca5..c352fe0223 100644
--- a/osu.Game/Overlays/BeatmapListing/Panels/PlayButton.cs
+++ b/osu.Game/Overlays/BeatmapListing/Panels/PlayButton.cs
@@ -8,9 +8,9 @@ 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;
 using osuTK;
 using osuTK.Graphics;
 
@@ -24,9 +24,9 @@ namespace osu.Game.Overlays.BeatmapListing.Panels
 
         public PreviewTrack Preview { get; private set; }
 
-        private BeatmapSetInfo beatmapSet;
+        private APIBeatmapSet beatmapSet;
 
-        public BeatmapSetInfo BeatmapSet
+        public APIBeatmapSet BeatmapSet
         {
             get => beatmapSet;
             set
@@ -66,7 +66,7 @@ namespace osu.Game.Overlays.BeatmapListing.Panels
             }
         }
 
-        public PlayButton(BeatmapSetInfo setInfo = null)
+        public PlayButton(APIBeatmapSet setInfo = null)
         {
             BeatmapSet = setInfo;
             AddRange(new Drawable[]
diff --git a/osu.Game/Overlays/BeatmapListingOverlay.cs b/osu.Game/Overlays/BeatmapListingOverlay.cs
index 935a89b99b..e08af52a72 100644
--- a/osu.Game/Overlays/BeatmapListingOverlay.cs
+++ b/osu.Game/Overlays/BeatmapListingOverlay.cs
@@ -15,10 +15,10 @@ using osu.Framework.Graphics.Sprites;
 using osu.Framework.Graphics.Textures;
 using osu.Framework.Input.Events;
 using osu.Game.Audio;
-using osu.Game.Beatmaps;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.Containers;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays.BeatmapListing;
 using osu.Game.Overlays.BeatmapListing.Panels;
 using osu.Game.Resources.Localisation.Web;
@@ -136,7 +136,7 @@ namespace osu.Game.Overlays
                 return;
             }
 
-            var newPanels = searchResult.Results.Select<BeatmapSetInfo, BeatmapPanel>(b => new GridBeatmapPanel(b)
+            var newPanels = searchResult.Results.Select<APIBeatmapSet, BeatmapPanel>(b => new GridBeatmapPanel(b)
             {
                 Anchor = Anchor.TopCentre,
                 Origin = Anchor.TopCentre,
diff --git a/osu.Game/Overlays/BeatmapSet/AuthorInfo.cs b/osu.Game/Overlays/BeatmapSet/AuthorInfo.cs
index 265d9bf125..c90e2e2085 100644
--- a/osu.Game/Overlays/BeatmapSet/AuthorInfo.cs
+++ b/osu.Game/Overlays/BeatmapSet/AuthorInfo.cs
@@ -6,7 +6,6 @@ using osu.Framework.Allocation;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
-using osu.Game.Beatmaps;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Users.Drawables;
 using osuTK;
@@ -16,6 +15,7 @@ using osu.Framework.Graphics.Sprites;
 using osu.Game.Graphics;
 using osu.Game.Users;
 using osu.Game.Graphics.Containers;
+using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Overlays.BeatmapSet
 {
@@ -26,9 +26,9 @@ namespace osu.Game.Overlays.BeatmapSet
         private UpdateableAvatar avatar;
         private FillFlowContainer fields;
 
-        private BeatmapSetInfo beatmapSet;
+        private APIBeatmapSet beatmapSet;
 
-        public BeatmapSetInfo BeatmapSet
+        public APIBeatmapSet BeatmapSet
         {
             get => beatmapSet;
             set
@@ -78,30 +78,28 @@ namespace osu.Game.Overlays.BeatmapSet
 
         private void updateDisplay()
         {
-            avatar.User = BeatmapSet?.Metadata.Author;
+            avatar.User = BeatmapSet?.Author;
 
             fields.Clear();
             if (BeatmapSet == null)
                 return;
 
-            var online = BeatmapSet.OnlineInfo;
-
             fields.Children = new Drawable[]
             {
-                new Field("mapped by", BeatmapSet.Metadata.Author, OsuFont.GetFont(weight: FontWeight.Regular, italics: true)),
-                new Field("submitted", online.Submitted, OsuFont.GetFont(weight: FontWeight.Bold))
+                new Field("mapped by", BeatmapSet.Author, OsuFont.GetFont(weight: FontWeight.Regular, italics: true)),
+                new Field("submitted", BeatmapSet.Submitted, OsuFont.GetFont(weight: FontWeight.Bold))
                 {
                     Margin = new MarginPadding { Top = 5 },
                 },
             };
 
-            if (online.Ranked.HasValue)
+            if (BeatmapSet.Ranked.HasValue)
             {
-                fields.Add(new Field(online.Status.ToString().ToLowerInvariant(), online.Ranked.Value, OsuFont.GetFont(weight: FontWeight.Bold)));
+                fields.Add(new Field(BeatmapSet.Status.ToString().ToLowerInvariant(), BeatmapSet.Ranked.Value, OsuFont.GetFont(weight: FontWeight.Bold)));
             }
-            else if (online.LastUpdated.HasValue)
+            else if (BeatmapSet.LastUpdated.HasValue)
             {
-                fields.Add(new Field("last updated", online.LastUpdated.Value, OsuFont.GetFont(weight: FontWeight.Bold)));
+                fields.Add(new Field("last updated", BeatmapSet.LastUpdated.Value, OsuFont.GetFont(weight: FontWeight.Bold)));
             }
         }
 
diff --git a/osu.Game/Overlays/BeatmapSet/BasicStats.cs b/osu.Game/Overlays/BeatmapSet/BasicStats.cs
index 683f4f0c49..8f848edf24 100644
--- a/osu.Game/Overlays/BeatmapSet/BasicStats.cs
+++ b/osu.Game/Overlays/BeatmapSet/BasicStats.cs
@@ -14,6 +14,7 @@ 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;
 
@@ -23,9 +24,9 @@ namespace osu.Game.Overlays.BeatmapSet
     {
         private readonly Statistic length, bpm, circleCount, sliderCount;
 
-        private BeatmapSetInfo beatmapSet;
+        private APIBeatmapSet beatmapSet;
 
-        public BeatmapSetInfo BeatmapSet
+        public APIBeatmapSet BeatmapSet
         {
             get => beatmapSet;
             set
@@ -38,9 +39,9 @@ namespace osu.Game.Overlays.BeatmapSet
             }
         }
 
-        private BeatmapInfo beatmapInfo;
+        private IBeatmapInfo beatmapInfo;
 
-        public BeatmapInfo BeatmapInfo
+        public IBeatmapInfo BeatmapInfo
         {
             get => beatmapInfo;
             set
@@ -55,7 +56,7 @@ namespace osu.Game.Overlays.BeatmapSet
 
         private void updateDisplay()
         {
-            bpm.Value = BeatmapSet?.OnlineInfo?.BPM.ToLocalisableString(@"0.##") ?? (LocalisableString)"-";
+            bpm.Value = BeatmapSet?.BPM.ToLocalisableString(@"0.##") ?? (LocalisableString)"-";
 
             if (beatmapInfo == null)
             {
@@ -68,8 +69,10 @@ namespace osu.Game.Overlays.BeatmapSet
                 length.TooltipText = BeatmapsetsStrings.ShowStatsTotalLength(TimeSpan.FromMilliseconds(beatmapInfo.Length).ToFormattedDuration());
                 length.Value = TimeSpan.FromMilliseconds(beatmapInfo.Length).ToFormattedDuration();
 
-                circleCount.Value = beatmapInfo.OnlineInfo.CircleCount.ToLocalisableString(@"N0");
-                sliderCount.Value = beatmapInfo.OnlineInfo.SliderCount.ToLocalisableString(@"N0");
+                var onlineInfo = beatmapInfo as IBeatmapOnlineInfo;
+
+                circleCount.Value = (onlineInfo?.CircleCount ?? 0).ToLocalisableString(@"N0");
+                sliderCount.Value = (onlineInfo?.SliderCount ?? 0).ToLocalisableString(@"N0");
             }
         }
 
diff --git a/osu.Game/Overlays/BeatmapSet/BeatmapAvailability.cs b/osu.Game/Overlays/BeatmapSet/BeatmapAvailability.cs
index f005a37eaa..dc46452dcb 100644
--- a/osu.Game/Overlays/BeatmapSet/BeatmapAvailability.cs
+++ b/osu.Game/Overlays/BeatmapSet/BeatmapAvailability.cs
@@ -5,19 +5,19 @@ using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
-using osu.Game.Beatmaps;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
+using osu.Game.Online.API.Requests.Responses;
 using osuTK.Graphics;
 
 namespace osu.Game.Overlays.BeatmapSet
 {
     public class BeatmapAvailability : Container
     {
-        private BeatmapSetInfo beatmapSet;
+        private APIBeatmapSet beatmapSet;
 
-        private bool downloadDisabled => BeatmapSet?.OnlineInfo.Availability.DownloadDisabled ?? false;
-        private bool hasExternalLink => !string.IsNullOrEmpty(BeatmapSet?.OnlineInfo.Availability.ExternalLink);
+        private bool downloadDisabled => BeatmapSet?.Availability.DownloadDisabled ?? false;
+        private bool hasExternalLink => !string.IsNullOrEmpty(BeatmapSet?.Availability.ExternalLink);
 
         private readonly LinkFlowContainer textContainer;
 
@@ -44,7 +44,7 @@ namespace osu.Game.Overlays.BeatmapSet
             };
         }
 
-        public BeatmapSetInfo BeatmapSet
+        public APIBeatmapSet BeatmapSet
         {
             get => beatmapSet;
 
@@ -76,7 +76,7 @@ namespace osu.Game.Overlays.BeatmapSet
             {
                 textContainer.NewParagraph();
                 textContainer.NewParagraph();
-                textContainer.AddLink("Check here for more information.", BeatmapSet.OnlineInfo.Availability.ExternalLink, creationParameters: t => t.Font = OsuFont.GetFont(size: 10));
+                textContainer.AddLink("Check here for more information.", BeatmapSet.Availability.ExternalLink, creationParameters: t => t.Font = OsuFont.GetFont(size: 10));
             }
         }
     }
diff --git a/osu.Game/Overlays/BeatmapSet/BeatmapPicker.cs b/osu.Game/Overlays/BeatmapSet/BeatmapPicker.cs
index 3df275c6d3..c43ac74714 100644
--- a/osu.Game/Overlays/BeatmapSet/BeatmapPicker.cs
+++ b/osu.Game/Overlays/BeatmapSet/BeatmapPicker.cs
@@ -17,6 +17,7 @@ using osu.Game.Beatmaps.Drawables;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Resources.Localisation.Web;
 using osu.Game.Rulesets;
 using osuTK;
@@ -34,10 +35,10 @@ namespace osu.Game.Overlays.BeatmapSet
 
         public readonly DifficultiesContainer Difficulties;
 
-        public readonly Bindable<BeatmapInfo> Beatmap = new Bindable<BeatmapInfo>();
-        private BeatmapSetInfo beatmapSet;
+        public readonly Bindable<APIBeatmap> Beatmap = new Bindable<APIBeatmap>();
+        private APIBeatmapSet beatmapSet;
 
-        public BeatmapSetInfo BeatmapSet
+        public APIBeatmapSet BeatmapSet
         {
             get => beatmapSet;
             set
@@ -164,35 +165,38 @@ namespace osu.Game.Overlays.BeatmapSet
 
             if (BeatmapSet != null)
             {
-                Difficulties.ChildrenEnumerable = BeatmapSet.Beatmaps.Where(b => b.Ruleset.Equals(ruleset.Value)).OrderBy(b => b.StarDifficulty).Select(b => new DifficultySelectorButton(b)
-                {
-                    State = DifficultySelectorState.NotSelected,
-                    OnHovered = beatmap =>
-                    {
-                        showBeatmap(beatmap);
-                        starRating.Text = beatmap.StarDifficulty.ToLocalisableString(@"0.##");
-                        starRatingContainer.FadeIn(100);
-                    },
-                    OnClicked = beatmap => { Beatmap.Value = beatmap; },
-                });
+                Difficulties.ChildrenEnumerable = BeatmapSet.Beatmaps
+                                                            .Where(b => b.Ruleset?.OnlineID == ruleset.Value?.OnlineID)
+                                                            .OrderBy(b => b.StarRating)
+                                                            .Select(b => new DifficultySelectorButton(b)
+                                                            {
+                                                                State = DifficultySelectorState.NotSelected,
+                                                                OnHovered = beatmap =>
+                                                                {
+                                                                    showBeatmap(beatmap);
+                                                                    starRating.Text = beatmap.StarRating.ToLocalisableString(@"0.##");
+                                                                    starRatingContainer.FadeIn(100);
+                                                                },
+                                                                OnClicked = beatmap => { Beatmap.Value = beatmap; },
+                                                            });
             }
 
             starRatingContainer.FadeOut(100);
-            Beatmap.Value = Difficulties.FirstOrDefault()?.BeatmapInfo;
-            plays.Value = BeatmapSet?.OnlineInfo.PlayCount ?? 0;
-            favourites.Value = BeatmapSet?.OnlineInfo.FavouriteCount ?? 0;
+            Beatmap.Value = Difficulties.FirstOrDefault()?.Beatmap;
+            plays.Value = BeatmapSet?.PlayCount ?? 0;
+            favourites.Value = BeatmapSet?.FavouriteCount ?? 0;
 
             updateDifficultyButtons();
         }
 
-        private void showBeatmap(BeatmapInfo beatmapInfo)
+        private void showBeatmap(IBeatmapInfo beatmapInfo)
         {
-            version.Text = beatmapInfo?.Version;
+            version.Text = beatmapInfo?.DifficultyName;
         }
 
         private void updateDifficultyButtons()
         {
-            Difficulties.Children.ToList().ForEach(diff => diff.State = diff.BeatmapInfo == Beatmap.Value ? DifficultySelectorState.Selected : DifficultySelectorState.NotSelected);
+            Difficulties.Children.ToList().ForEach(diff => diff.State = diff.Beatmap == Beatmap.Value ? DifficultySelectorState.Selected : DifficultySelectorState.NotSelected);
         }
 
         public class DifficultiesContainer : FillFlowContainer<DifficultySelectorButton>
@@ -216,10 +220,10 @@ namespace osu.Game.Overlays.BeatmapSet
             private readonly Box backgroundBox;
             private readonly DifficultyIcon icon;
 
-            public readonly BeatmapInfo BeatmapInfo;
+            public readonly APIBeatmap Beatmap;
 
-            public Action<BeatmapInfo> OnHovered;
-            public Action<BeatmapInfo> OnClicked;
+            public Action<APIBeatmap> OnHovered;
+            public Action<APIBeatmap> OnClicked;
             public event Action<DifficultySelectorState> StateChanged;
 
             private DifficultySelectorState state;
@@ -241,9 +245,9 @@ namespace osu.Game.Overlays.BeatmapSet
                 }
             }
 
-            public DifficultySelectorButton(BeatmapInfo beatmapInfo)
+            public DifficultySelectorButton(APIBeatmap beatmapInfo)
             {
-                BeatmapInfo = beatmapInfo;
+                Beatmap = beatmapInfo;
                 Size = new Vector2(size);
                 Margin = new MarginPadding { Horizontal = tile_spacing / 2 };
 
@@ -273,7 +277,7 @@ namespace osu.Game.Overlays.BeatmapSet
             protected override bool OnHover(HoverEvent e)
             {
                 fadeIn();
-                OnHovered?.Invoke(BeatmapInfo);
+                OnHovered?.Invoke(Beatmap);
                 return base.OnHover(e);
             }
 
@@ -286,7 +290,7 @@ namespace osu.Game.Overlays.BeatmapSet
 
             protected override bool OnClick(ClickEvent e)
             {
-                OnClicked?.Invoke(BeatmapInfo);
+                OnClicked?.Invoke(Beatmap);
                 return base.OnClick(e);
             }
 
diff --git a/osu.Game/Overlays/BeatmapSet/BeatmapRulesetSelector.cs b/osu.Game/Overlays/BeatmapSet/BeatmapRulesetSelector.cs
index 005d21726b..6564ca3d41 100644
--- a/osu.Game/Overlays/BeatmapSet/BeatmapRulesetSelector.cs
+++ b/osu.Game/Overlays/BeatmapSet/BeatmapRulesetSelector.cs
@@ -3,17 +3,17 @@
 
 using osu.Framework.Bindables;
 using osu.Framework.Graphics.UserInterface;
-using osu.Game.Beatmaps;
 using osu.Game.Rulesets;
 using System.Linq;
+using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Overlays.BeatmapSet
 {
     public class BeatmapRulesetSelector : OverlayRulesetSelector
     {
-        private readonly Bindable<BeatmapSetInfo> beatmapSet = new Bindable<BeatmapSetInfo>();
+        private readonly Bindable<APIBeatmapSet> beatmapSet = new Bindable<APIBeatmapSet>();
 
-        public BeatmapSetInfo BeatmapSet
+        public APIBeatmapSet BeatmapSet
         {
             get => beatmapSet.Value;
             set
diff --git a/osu.Game/Overlays/BeatmapSet/BeatmapRulesetTabItem.cs b/osu.Game/Overlays/BeatmapSet/BeatmapRulesetTabItem.cs
index 79c95d6646..b3b3d1980b 100644
--- a/osu.Game/Overlays/BeatmapSet/BeatmapRulesetTabItem.cs
+++ b/osu.Game/Overlays/BeatmapSet/BeatmapRulesetTabItem.cs
@@ -1,22 +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 System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
-using osu.Game.Beatmaps;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets;
-using System.Linq;
 
 namespace osu.Game.Overlays.BeatmapSet
 {
     public class BeatmapRulesetTabItem : OverlayRulesetTabItem
     {
-        public readonly Bindable<BeatmapSetInfo> BeatmapSet = new Bindable<BeatmapSetInfo>();
+        public readonly Bindable<APIBeatmapSet> BeatmapSet = new Bindable<APIBeatmapSet>();
 
         [Resolved]
         private OverlayColourProvider colourProvider { get; set; }
@@ -64,7 +64,7 @@ namespace osu.Game.Overlays.BeatmapSet
 
             BeatmapSet.BindValueChanged(setInfo =>
             {
-                int beatmapsCount = setInfo.NewValue?.Beatmaps.Count(b => b.Ruleset.Equals(Value)) ?? 0;
+                int beatmapsCount = setInfo.NewValue?.Beatmaps.Count(b => b.Ruleset.OnlineID == Value.OnlineID) ?? 0;
 
                 count.Text = beatmapsCount.ToString();
                 countContainer.FadeTo(beatmapsCount > 0 ? 1 : 0);
diff --git a/osu.Game/Overlays/BeatmapSet/BeatmapSetHeader.cs b/osu.Game/Overlays/BeatmapSet/BeatmapSetHeader.cs
index 4a0c0e9f75..102cddfa92 100644
--- a/osu.Game/Overlays/BeatmapSet/BeatmapSetHeader.cs
+++ b/osu.Game/Overlays/BeatmapSet/BeatmapSetHeader.cs
@@ -6,7 +6,7 @@ using osu.Framework.Bindables;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Effects;
-using osu.Game.Beatmaps;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Resources.Localisation.Web;
 using osu.Game.Rulesets;
 using osuTK;
@@ -16,7 +16,7 @@ namespace osu.Game.Overlays.BeatmapSet
 {
     public class BeatmapSetHeader : OverlayHeader
     {
-        public readonly Bindable<BeatmapSetInfo> BeatmapSet = new Bindable<BeatmapSetInfo>();
+        public readonly Bindable<APIBeatmapSet> BeatmapSet = new Bindable<APIBeatmapSet>();
 
         public BeatmapSetHeaderContent HeaderContent { get; private set; }
 
diff --git a/osu.Game/Overlays/BeatmapSet/BeatmapSetHeaderContent.cs b/osu.Game/Overlays/BeatmapSet/BeatmapSetHeaderContent.cs
index 97cd17313e..f94fee7a8b 100644
--- a/osu.Game/Overlays/BeatmapSet/BeatmapSetHeaderContent.cs
+++ b/osu.Game/Overlays/BeatmapSet/BeatmapSetHeaderContent.cs
@@ -10,13 +10,13 @@ using osu.Framework.Graphics.Colour;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Localisation;
-using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.Drawables;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Online;
 using osu.Game.Online.API;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays.BeatmapListing.Panels;
 using osu.Game.Overlays.BeatmapSet.Buttons;
 using osuTK;
@@ -25,7 +25,7 @@ namespace osu.Game.Overlays.BeatmapSet
 {
     public class BeatmapSetHeaderContent : CompositeDrawable
     {
-        public readonly Bindable<BeatmapSetInfo> BeatmapSet = new Bindable<BeatmapSetInfo>();
+        public readonly Bindable<APIBeatmapSet> BeatmapSet = new Bindable<APIBeatmapSet>();
 
         private const float transition_duration = 200;
         private const float buttons_height = 45;
@@ -219,7 +219,7 @@ namespace osu.Game.Overlays.BeatmapSet
             Picker.Beatmap.ValueChanged += b =>
             {
                 Details.BeatmapInfo = b.NewValue;
-                externalLink.Link = $@"{api.WebsiteRootUrl}/beatmapsets/{BeatmapSet.Value?.OnlineBeatmapSetID}#{b.NewValue?.Ruleset.ShortName}/{b.NewValue?.OnlineBeatmapID}";
+                externalLink.Link = $@"{api.WebsiteRootUrl}/beatmapsets/{BeatmapSet.Value?.OnlineID}#{b.NewValue?.Ruleset.ShortName}/{b.NewValue?.OnlineID}";
             };
         }
 
@@ -231,7 +231,7 @@ namespace osu.Game.Overlays.BeatmapSet
             BeatmapSet.BindValueChanged(setInfo =>
             {
                 Picker.BeatmapSet = rulesetSelector.BeatmapSet = author.BeatmapSet = beatmapAvailability.BeatmapSet = Details.BeatmapSet = setInfo.NewValue;
-                cover.OnlineInfo = setInfo.NewValue?.OnlineInfo;
+                cover.OnlineInfo = setInfo.NewValue;
 
                 downloadTracker?.RemoveAndDisposeImmediately();
 
@@ -254,14 +254,14 @@ namespace osu.Game.Overlays.BeatmapSet
 
                     loading.Hide();
 
-                    title.Text = new RomanisableString(setInfo.NewValue.Metadata.TitleUnicode, setInfo.NewValue.Metadata.Title);
-                    artist.Text = new RomanisableString(setInfo.NewValue.Metadata.ArtistUnicode, setInfo.NewValue.Metadata.Artist);
+                    title.Text = new RomanisableString(setInfo.NewValue.TitleUnicode, setInfo.NewValue.Title);
+                    artist.Text = new RomanisableString(setInfo.NewValue.ArtistUnicode, setInfo.NewValue.Artist);
 
-                    explicitContentPill.Alpha = setInfo.NewValue.OnlineInfo.HasExplicitContent ? 1 : 0;
-                    featuredArtistPill.Alpha = setInfo.NewValue.OnlineInfo.TrackId != null ? 1 : 0;
+                    explicitContentPill.Alpha = setInfo.NewValue.HasExplicitContent ? 1 : 0;
+                    featuredArtistPill.Alpha = setInfo.NewValue.TrackId != null ? 1 : 0;
 
                     onlineStatusPill.FadeIn(500, Easing.OutQuint);
-                    onlineStatusPill.Status = setInfo.NewValue.OnlineInfo.Status;
+                    onlineStatusPill.Status = setInfo.NewValue.Status;
 
                     downloadButtonsContainer.FadeIn(transition_duration);
                     favouriteButton.FadeIn(transition_duration);
@@ -275,7 +275,7 @@ namespace osu.Game.Overlays.BeatmapSet
         {
             if (BeatmapSet.Value == null) return;
 
-            if (BeatmapSet.Value.OnlineInfo.Availability.DownloadDisabled && downloadTracker.State.Value != DownloadState.LocallyAvailable)
+            if (BeatmapSet.Value.Availability.DownloadDisabled && downloadTracker.State.Value != DownloadState.LocallyAvailable)
             {
                 downloadButtonsContainer.Clear();
                 return;
@@ -301,7 +301,7 @@ namespace osu.Game.Overlays.BeatmapSet
 
                 default:
                     downloadButtonsContainer.Child = new HeaderDownloadButton(BeatmapSet.Value);
-                    if (BeatmapSet.Value.OnlineInfo.HasVideo)
+                    if (BeatmapSet.Value.HasVideo)
                         downloadButtonsContainer.Add(new HeaderDownloadButton(BeatmapSet.Value, true));
                     break;
             }
diff --git a/osu.Game/Overlays/BeatmapSet/Buttons/FavouriteButton.cs b/osu.Game/Overlays/BeatmapSet/Buttons/FavouriteButton.cs
index 43dd1438f1..d4873f241c 100644
--- a/osu.Game/Overlays/BeatmapSet/Buttons/FavouriteButton.cs
+++ b/osu.Game/Overlays/BeatmapSet/Buttons/FavouriteButton.cs
@@ -8,10 +8,10 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Cursor;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Localisation;
-using osu.Game.Beatmaps;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays.Notifications;
 using osu.Game.Resources.Localisation.Web;
 using osu.Game.Users;
@@ -21,7 +21,7 @@ namespace osu.Game.Overlays.BeatmapSet.Buttons
 {
     public class FavouriteButton : HeaderButton, IHasTooltip
     {
-        public readonly Bindable<BeatmapSetInfo> BeatmapSet = new Bindable<BeatmapSetInfo>();
+        public readonly Bindable<APIBeatmapSet> BeatmapSet = new Bindable<APIBeatmapSet>();
 
         private readonly BindableBool favourited = new BindableBool();
 
@@ -61,13 +61,13 @@ namespace osu.Game.Overlays.BeatmapSet.Buttons
             Action = () =>
             {
                 // guaranteed by disabled state above.
-                Debug.Assert(BeatmapSet.Value.OnlineBeatmapSetID != null);
+                Debug.Assert(BeatmapSet.Value.OnlineID > 0);
 
                 loading.Show();
 
                 request?.Cancel();
 
-                request = new PostBeatmapFavouriteRequest(BeatmapSet.Value.OnlineBeatmapSetID.Value, favourited.Value ? BeatmapFavouriteAction.UnFavourite : BeatmapFavouriteAction.Favourite);
+                request = new PostBeatmapFavouriteRequest(BeatmapSet.Value.OnlineID, favourited.Value ? BeatmapFavouriteAction.UnFavourite : BeatmapFavouriteAction.Favourite);
 
                 request.Success += () =>
                 {
@@ -98,11 +98,11 @@ namespace osu.Game.Overlays.BeatmapSet.Buttons
             BeatmapSet.BindValueChanged(setInfo =>
             {
                 updateEnabled();
-                favourited.Value = setInfo.NewValue?.OnlineInfo?.HasFavourited ?? false;
+                favourited.Value = setInfo.NewValue?.HasFavourited ?? false;
             }, true);
         }
 
-        private void updateEnabled() => Enabled.Value = !(localUser.Value is GuestUser) && BeatmapSet.Value?.OnlineBeatmapSetID > 0;
+        private void updateEnabled() => Enabled.Value = !(localUser.Value is GuestUser) && BeatmapSet.Value?.OnlineID > 0;
 
         protected override void UpdateAfterChildren()
         {
diff --git a/osu.Game/Overlays/BeatmapSet/Buttons/HeaderDownloadButton.cs b/osu.Game/Overlays/BeatmapSet/Buttons/HeaderDownloadButton.cs
index 88d0778ae4..6862864c55 100644
--- a/osu.Game/Overlays/BeatmapSet/Buttons/HeaderDownloadButton.cs
+++ b/osu.Game/Overlays/BeatmapSet/Buttons/HeaderDownloadButton.cs
@@ -14,11 +14,13 @@ using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Online;
 using osu.Game.Online.API;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays.BeatmapListing.Panels;
 using osu.Game.Resources.Localisation.Web;
 using osu.Game.Users;
 using osuTK;
 using osuTK.Graphics;
+using CommonStrings = osu.Game.Localisation.CommonStrings;
 
 namespace osu.Game.Overlays.BeatmapSet.Buttons
 {
@@ -36,9 +38,10 @@ namespace osu.Game.Overlays.BeatmapSet.Buttons
         private HeaderButton button;
 
         private BeatmapDownloadTracker downloadTracker;
-        private readonly BeatmapSetInfo beatmapSet;
 
-        public HeaderDownloadButton(BeatmapSetInfo beatmapSet, bool noVideo = false)
+        private readonly APIBeatmapSet beatmapSet;
+
+        public HeaderDownloadButton(APIBeatmapSet beatmapSet, bool noVideo = false)
         {
             this.beatmapSet = beatmapSet;
             this.noVideo = noVideo;
@@ -105,7 +108,7 @@ namespace osu.Game.Overlays.BeatmapSet.Buttons
                     return;
                 }
 
-                beatmaps.Download(beatmapSet, noVideo);
+                beatmaps.Download(new BeatmapSetInfo { OnlineBeatmapSetID = beatmapSet.OnlineID }, noVideo);
             };
 
             localUser.BindTo(api.LocalUser);
@@ -121,7 +124,7 @@ namespace osu.Game.Overlays.BeatmapSet.Buttons
                         {
                             new OsuSpriteText
                             {
-                                Text = Localisation.CommonStrings.Downloading,
+                                Text = CommonStrings.Downloading,
                                 Font = OsuFont.GetFont(size: text_size, weight: FontWeight.Bold)
                             },
                         };
@@ -132,7 +135,7 @@ namespace osu.Game.Overlays.BeatmapSet.Buttons
                         {
                             new OsuSpriteText
                             {
-                                Text = Localisation.CommonStrings.Importing,
+                                Text = CommonStrings.Importing,
                                 Font = OsuFont.GetFont(size: text_size, weight: FontWeight.Bold)
                             },
                         };
@@ -168,7 +171,7 @@ namespace osu.Game.Overlays.BeatmapSet.Buttons
 
         private LocalisableString getVideoSuffixText()
         {
-            if (!beatmapSet.OnlineInfo.HasVideo)
+            if (!beatmapSet.HasVideo)
                 return string.Empty;
 
             return noVideo ? BeatmapsetsStrings.ShowDetailsDownloadNoVideo : BeatmapsetsStrings.ShowDetailsDownloadVideo;
diff --git a/osu.Game/Overlays/BeatmapSet/Buttons/PreviewButton.cs b/osu.Game/Overlays/BeatmapSet/Buttons/PreviewButton.cs
index 5b3c142a66..6bcdb7bdc5 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 osu.Game.Overlays.BeatmapListing.Panels;
 using osuTK;
 
@@ -25,7 +25,7 @@ namespace osu.Game.Overlays.BeatmapSet.Buttons
 
         public IBindable<bool> Playing => playButton.Playing;
 
-        public BeatmapSetInfo BeatmapSet
+        public APIBeatmapSet BeatmapSet
         {
             get => playButton.BeatmapSet;
             set => playButton.BeatmapSet = value;
diff --git a/osu.Game/Overlays/BeatmapSet/Details.cs b/osu.Game/Overlays/BeatmapSet/Details.cs
index d6720e5f35..dfc8d5e680 100644
--- a/osu.Game/Overlays/BeatmapSet/Details.cs
+++ b/osu.Game/Overlays/BeatmapSet/Details.cs
@@ -6,6 +6,7 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 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.Screens.Select.Details;
 using osuTK;
@@ -21,9 +22,9 @@ namespace osu.Game.Overlays.BeatmapSet
         private readonly AdvancedStats advanced;
         private readonly DetailBox ratingBox;
 
-        private BeatmapSetInfo beatmapSet;
+        private APIBeatmapSet beatmapSet;
 
-        public BeatmapSetInfo BeatmapSet
+        public APIBeatmapSet BeatmapSet
         {
             get => beatmapSet;
             set
@@ -37,9 +38,9 @@ namespace osu.Game.Overlays.BeatmapSet
             }
         }
 
-        private BeatmapInfo beatmapInfo;
+        private IBeatmapInfo beatmapInfo;
 
-        public BeatmapInfo BeatmapInfo
+        public IBeatmapInfo BeatmapInfo
         {
             get => beatmapInfo;
             set
@@ -53,7 +54,7 @@ namespace osu.Game.Overlays.BeatmapSet
         private void updateDisplay()
         {
             Ratings.Ratings = BeatmapSet?.Ratings;
-            ratingBox.Alpha = BeatmapSet?.OnlineInfo?.Status > 0 ? 1 : 0;
+            ratingBox.Alpha = BeatmapSet?.Status > 0 ? 1 : 0;
         }
 
         public Details()
diff --git a/osu.Game/Overlays/BeatmapSet/Info.cs b/osu.Game/Overlays/BeatmapSet/Info.cs
index 970e9bbf42..3ef52d718d 100644
--- a/osu.Game/Overlays/BeatmapSet/Info.cs
+++ b/osu.Game/Overlays/BeatmapSet/Info.cs
@@ -6,9 +6,9 @@ using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
-using osu.Game.Beatmaps;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
+using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Overlays.BeatmapSet
 {
@@ -22,12 +22,12 @@ namespace osu.Game.Overlays.BeatmapSet
         private readonly Box background;
         private readonly SuccessRate successRate;
 
-        public readonly Bindable<BeatmapSetInfo> BeatmapSet = new Bindable<BeatmapSetInfo>();
+        public readonly Bindable<APIBeatmapSet> BeatmapSet = new Bindable<APIBeatmapSet>();
 
-        public BeatmapInfo BeatmapInfo
+        public APIBeatmap BeatmapInfo
         {
-            get => successRate.BeatmapInfo;
-            set => successRate.BeatmapInfo = value;
+            get => successRate.Beatmap;
+            set => successRate.Beatmap = value;
         }
 
         public Info()
@@ -115,11 +115,11 @@ namespace osu.Game.Overlays.BeatmapSet
 
             BeatmapSet.ValueChanged += b =>
             {
-                source.Text = b.NewValue?.Metadata.Source ?? string.Empty;
-                tags.Text = b.NewValue?.Metadata.Tags ?? string.Empty;
-                genre.Text = b.NewValue?.OnlineInfo?.Genre.Name ?? string.Empty;
-                language.Text = b.NewValue?.OnlineInfo?.Language.Name ?? string.Empty;
-                bool setHasLeaderboard = b.NewValue?.OnlineInfo?.Status > 0;
+                source.Text = b.NewValue?.Source ?? string.Empty;
+                tags.Text = b.NewValue?.Tags ?? string.Empty;
+                genre.Text = b.NewValue?.Genre.Name ?? string.Empty;
+                language.Text = b.NewValue?.Language.Name ?? string.Empty;
+                bool setHasLeaderboard = b.NewValue?.Status > 0;
                 successRate.Alpha = setHasLeaderboard ? 1 : 0;
                 notRankedPlaceholder.Alpha = setHasLeaderboard ? 0 : 1;
                 Height = setHasLeaderboard ? 270 : base_height;
diff --git a/osu.Game/Overlays/BeatmapSet/LeaderboardModSelector.cs b/osu.Game/Overlays/BeatmapSet/LeaderboardModSelector.cs
index 6349f115cb..a9723c9c62 100644
--- a/osu.Game/Overlays/BeatmapSet/LeaderboardModSelector.cs
+++ b/osu.Game/Overlays/BeatmapSet/LeaderboardModSelector.cs
@@ -13,6 +13,7 @@ using osu.Game.Graphics.UserInterface;
 using osuTK.Graphics;
 using System;
 using System.Linq;
+using osu.Framework.Allocation;
 using osu.Framework.Extensions.IEnumerableExtensions;
 
 namespace osu.Game.Overlays.BeatmapSet
@@ -20,7 +21,7 @@ namespace osu.Game.Overlays.BeatmapSet
     public class LeaderboardModSelector : CompositeDrawable
     {
         public readonly BindableList<IMod> SelectedMods = new BindableList<IMod>();
-        public readonly Bindable<RulesetInfo> Ruleset = new Bindable<RulesetInfo>();
+        public readonly Bindable<IRulesetInfo> Ruleset = new Bindable<IRulesetInfo>();
 
         private readonly FillFlowContainer<ModButton> modsContainer;
 
@@ -45,7 +46,10 @@ namespace osu.Game.Overlays.BeatmapSet
             Ruleset.BindValueChanged(onRulesetChanged, true);
         }
 
-        private void onRulesetChanged(ValueChangedEvent<RulesetInfo> ruleset)
+        [Resolved]
+        private RulesetStore rulesets { get; set; }
+
+        private void onRulesetChanged(ValueChangedEvent<IRulesetInfo> ruleset)
         {
             SelectedMods.Clear();
             modsContainer.Clear();
@@ -54,7 +58,7 @@ namespace osu.Game.Overlays.BeatmapSet
                 return;
 
             modsContainer.Add(new ModButton(new ModNoMod()));
-            modsContainer.AddRange(ruleset.NewValue.CreateInstance().AllMods.Where(m => m.UserPlayable).Select(m => new ModButton(m)));
+            modsContainer.AddRange(rulesets.GetRuleset(ruleset.NewValue.OnlineID).CreateInstance().AllMods.Where(m => m.UserPlayable).Select(m => new ModButton(m)));
 
             modsContainer.ForEach(button =>
             {
diff --git a/osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.cs b/osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.cs
index c6eb516c7c..4a00c8b4a0 100644
--- a/osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.cs
+++ b/osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.cs
@@ -1,24 +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.Allocation;
-using osu.Framework.Graphics;
-using osu.Framework.Graphics.Containers;
-using osu.Framework.Graphics.Shapes;
-using osuTK;
 using System.Linq;
 using System.Threading;
 using System.Threading.Tasks;
-using osu.Game.Online.API.Requests.Responses;
+using osu.Framework.Allocation;
+using osu.Framework.Bindables;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.Shapes;
 using osu.Game.Beatmaps;
+using osu.Game.Graphics.UserInterface;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests;
-using osu.Framework.Bindables;
-using osu.Game.Graphics.UserInterface;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets;
 using osu.Game.Scoring;
 using osu.Game.Screens.Select.Leaderboards;
 using osu.Game.Users;
+using osuTK;
 
 namespace osu.Game.Overlays.BeatmapSet.Scores
 {
@@ -26,8 +26,8 @@ namespace osu.Game.Overlays.BeatmapSet.Scores
     {
         private const int spacing = 15;
 
-        public readonly Bindable<BeatmapInfo> Beatmap = new Bindable<BeatmapInfo>();
-        private readonly Bindable<RulesetInfo> ruleset = new Bindable<RulesetInfo>();
+        public readonly Bindable<APIBeatmap> Beatmap = new Bindable<APIBeatmap>();
+        private readonly Bindable<IRulesetInfo> ruleset = new Bindable<IRulesetInfo>();
         private readonly Bindable<BeatmapLeaderboardScope> scope = new Bindable<BeatmapLeaderboardScope>(BeatmapLeaderboardScope.Global);
         private readonly IBindable<User> user = new Bindable<User>();
 
@@ -66,7 +66,7 @@ namespace osu.Game.Overlays.BeatmapSet.Scores
                 if (value?.Scores.Any() != true)
                     return;
 
-                scoreManager.OrderByTotalScoreAsync(value.Scores.Select(s => s.CreateScoreInfo(rulesets, Beatmap.Value)).ToArray(), loadCancellationSource.Token)
+                scoreManager.OrderByTotalScoreAsync(value.Scores.Select(s => s.CreateScoreInfo(rulesets, Beatmap.Value.ToBeatmapInfo(rulesets))).ToArray(), loadCancellationSource.Token)
                             .ContinueWith(ordered => Schedule(() =>
                             {
                                 if (loadCancellationSource.IsCancellationRequested)
@@ -78,7 +78,7 @@ namespace osu.Game.Overlays.BeatmapSet.Scores
                                 scoreTable.Show();
 
                                 var userScore = value.UserScore;
-                                var userScoreInfo = userScore?.Score.CreateScoreInfo(rulesets, Beatmap.Value);
+                                var userScoreInfo = userScore?.Score.CreateScoreInfo(rulesets, Beatmap.Value.ToBeatmapInfo(rulesets));
 
                                 topScoresContainer.Add(new DrawableTopScore(topScore));
 
@@ -200,11 +200,11 @@ namespace osu.Game.Overlays.BeatmapSet.Scores
             user.BindValueChanged(onUserChanged, true);
         }
 
-        private void onBeatmapChanged(ValueChangedEvent<BeatmapInfo> beatmap)
+        private void onBeatmapChanged(ValueChangedEvent<APIBeatmap> beatmap)
         {
             var beatmapRuleset = beatmap.NewValue?.Ruleset;
 
-            if (ruleset.Value?.Equals(beatmapRuleset) ?? false)
+            if (ruleset.Value?.OnlineID == beatmapRuleset?.OnlineID)
             {
                 modSelector.DeselectAll();
                 ruleset.TriggerChange();
@@ -232,7 +232,7 @@ namespace osu.Game.Overlays.BeatmapSet.Scores
 
             noScoresPlaceholder.Hide();
 
-            if (Beatmap.Value?.OnlineBeatmapID.HasValue != true || Beatmap.Value.Status <= BeatmapSetOnlineStatus.Pending)
+            if (Beatmap.Value == null || Beatmap.Value.OnlineID <= 0 || (Beatmap.Value?.BeatmapSet as IBeatmapSetOnlineInfo)?.Status <= BeatmapSetOnlineStatus.Pending)
             {
                 Scores = null;
                 Hide();
diff --git a/osu.Game/Overlays/BeatmapSet/SuccessRate.cs b/osu.Game/Overlays/BeatmapSet/SuccessRate.cs
index 40a3c9fe8b..e08f099226 100644
--- a/osu.Game/Overlays/BeatmapSet/SuccessRate.cs
+++ b/osu.Game/Overlays/BeatmapSet/SuccessRate.cs
@@ -5,10 +5,10 @@ using osu.Framework.Allocation;
 using osu.Framework.Extensions.LocalisationExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
-using osu.Game.Beatmaps;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.UserInterface;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Resources.Localisation.Web;
 using osu.Game.Screens.Select.Details;
 
@@ -23,16 +23,16 @@ namespace osu.Game.Overlays.BeatmapSet
         private readonly Bar successRate;
         private readonly Container percentContainer;
 
-        private BeatmapInfo beatmapInfo;
+        private APIBeatmap beatmap;
 
-        public BeatmapInfo BeatmapInfo
+        public APIBeatmap Beatmap
         {
-            get => beatmapInfo;
+            get => beatmap;
             set
             {
-                if (value == beatmapInfo) return;
+                if (value == beatmap) return;
 
-                beatmapInfo = value;
+                beatmap = value;
 
                 updateDisplay();
             }
@@ -40,15 +40,15 @@ namespace osu.Game.Overlays.BeatmapSet
 
         private void updateDisplay()
         {
-            int passCount = beatmapInfo?.OnlineInfo?.PassCount ?? 0;
-            int playCount = beatmapInfo?.OnlineInfo?.PlayCount ?? 0;
+            int passCount = beatmap?.PassCount ?? 0;
+            int playCount = beatmap?.PlayCount ?? 0;
 
             float rate = playCount != 0 ? (float)passCount / playCount : 0;
             successPercent.Text = rate.ToLocalisableString(@"0.#%");
             successRate.Length = rate;
             percentContainer.ResizeWidthTo(successRate.Length, 250, Easing.InOutCubic);
 
-            Graph.FailTimes = beatmapInfo?.FailTimes;
+            Graph.FailTimes = beatmap?.FailTimes;
         }
 
         public SuccessRate()
diff --git a/osu.Game/Overlays/BeatmapSetOverlay.cs b/osu.Game/Overlays/BeatmapSetOverlay.cs
index f987b57d6e..fa5a7c66d0 100644
--- a/osu.Game/Overlays/BeatmapSetOverlay.cs
+++ b/osu.Game/Overlays/BeatmapSetOverlay.cs
@@ -7,8 +7,8 @@ using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Input.Events;
-using osu.Game.Beatmaps;
 using osu.Game.Online.API.Requests;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays.BeatmapSet;
 using osu.Game.Overlays.BeatmapSet.Scores;
 using osu.Game.Overlays.Comments;
@@ -27,7 +27,7 @@ namespace osu.Game.Overlays
         [Resolved]
         private RulesetStore rulesets { get; set; }
 
-        private readonly Bindable<BeatmapSetInfo> beatmapSet = new Bindable<BeatmapSetInfo>();
+        private readonly Bindable<APIBeatmapSet> beatmapSet = new Bindable<APIBeatmapSet>();
 
         // receive input outside our bounds so we can trigger a close event on ourselves.
         public override bool ReceivePositionalInputAt(Vector2 screenSpacePos) => true;
@@ -89,8 +89,8 @@ namespace osu.Game.Overlays
             var req = new GetBeatmapSetRequest(beatmapId, BeatmapSetLookupType.BeatmapId);
             req.Success += res =>
             {
-                beatmapSet.Value = res.ToBeatmapSet(rulesets);
-                Header.HeaderContent.Picker.Beatmap.Value = Header.BeatmapSet.Value.Beatmaps.First(b => b.OnlineBeatmapID == beatmapId);
+                beatmapSet.Value = res;
+                Header.HeaderContent.Picker.Beatmap.Value = Header.BeatmapSet.Value.Beatmaps.First(b => b.OnlineID == beatmapId);
             };
             API.Queue(req);
 
@@ -102,7 +102,7 @@ namespace osu.Game.Overlays
             beatmapSet.Value = null;
 
             var req = new GetBeatmapSetRequest(beatmapSetId);
-            req.Success += res => beatmapSet.Value = res.ToBeatmapSet(rulesets);
+            req.Success += res => beatmapSet.Value = res;
             API.Queue(req);
 
             Show();
@@ -112,7 +112,7 @@ namespace osu.Game.Overlays
         /// Show an already fully-populated beatmap set.
         /// </summary>
         /// <param name="set">The set to show.</param>
-        public void ShowBeatmapSet(BeatmapSetInfo set)
+        public void ShowBeatmapSet(APIBeatmapSet set)
         {
             beatmapSet.Value = set;
             Show();
@@ -120,7 +120,7 @@ namespace osu.Game.Overlays
 
         private class CommentsSection : BeatmapSetLayoutSection
         {
-            public readonly Bindable<BeatmapSetInfo> BeatmapSet = new Bindable<BeatmapSetInfo>();
+            public readonly Bindable<APIBeatmapSet> BeatmapSet = new Bindable<APIBeatmapSet>();
 
             public CommentsSection()
             {
@@ -130,10 +130,10 @@ namespace osu.Game.Overlays
 
                 BeatmapSet.BindValueChanged(beatmapSet =>
                 {
-                    if (beatmapSet.NewValue?.OnlineBeatmapSetID is int onlineBeatmapSetID)
+                    if (beatmapSet.NewValue?.OnlineID > 0)
                     {
                         Show();
-                        comments.ShowComments(CommentableType.Beatmapset, onlineBeatmapSetID);
+                        comments.ShowComments(CommentableType.Beatmapset, beatmapSet.NewValue.OnlineID);
                     }
                     else
                     {
diff --git a/osu.Game/Overlays/Profile/Sections/Beatmaps/PaginatedBeatmapContainer.cs b/osu.Game/Overlays/Profile/Sections/Beatmaps/PaginatedBeatmapContainer.cs
index c1e56facd9..fffa20dc11 100644
--- a/osu.Game/Overlays/Profile/Sections/Beatmaps/PaginatedBeatmapContainer.cs
+++ b/osu.Game/Overlays/Profile/Sections/Beatmaps/PaginatedBeatmapContainer.cs
@@ -61,7 +61,7 @@ namespace osu.Game.Overlays.Profile.Sections.Beatmaps
             new GetUserBeatmapsRequest(User.Value.Id, type, VisiblePages++, ItemsPerPage);
 
         protected override Drawable CreateDrawableItem(APIBeatmapSet model) => model.OnlineID > 0
-            ? new GridBeatmapPanel(model.ToBeatmapSet(Rulesets))
+            ? new GridBeatmapPanel(model)
             {
                 Anchor = Anchor.TopCentre,
                 Origin = Anchor.TopCentre,
diff --git a/osu.Game/Overlays/Profile/Sections/Historical/DrawableMostPlayedBeatmap.cs b/osu.Game/Overlays/Profile/Sections/Historical/DrawableMostPlayedBeatmap.cs
index ac4299ae49..3ed4bd9e50 100644
--- a/osu.Game/Overlays/Profile/Sections/Historical/DrawableMostPlayedBeatmap.cs
+++ b/osu.Game/Overlays/Profile/Sections/Historical/DrawableMostPlayedBeatmap.cs
@@ -5,15 +5,15 @@ using System.Diagnostics;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.Cursor;
 using osu.Framework.Graphics.Sprites;
+using osu.Framework.Localisation;
 using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.Drawables;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
 using osuTK;
-using osu.Framework.Graphics.Cursor;
-using osu.Framework.Localisation;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Resources.Localisation.Web;
 
diff --git a/osu.Game/Overlays/Rankings/SpotlightsLayout.cs b/osu.Game/Overlays/Rankings/SpotlightsLayout.cs
index b16e0a4908..b95b0a1afc 100644
--- a/osu.Game/Overlays/Rankings/SpotlightsLayout.cs
+++ b/osu.Game/Overlays/Rankings/SpotlightsLayout.cs
@@ -143,7 +143,7 @@ namespace osu.Game.Overlays.Rankings
                     AutoSizeAxes = Axes.Y,
                     RelativeSizeAxes = Axes.X,
                     Spacing = new Vector2(10),
-                    Children = response.BeatmapSets.Select(b => new GridBeatmapPanel(b.ToBeatmapSet(rulesets))
+                    Children = response.BeatmapSets.Select(b => new GridBeatmapPanel(b)
                     {
                         Anchor = Anchor.TopCentre,
                         Origin = Anchor.TopCentre,
diff --git a/osu.Game/Screens/Play/SoloSpectator.cs b/osu.Game/Screens/Play/SoloSpectator.cs
index 9d4dad8bdc..83ea660092 100644
--- a/osu.Game/Screens/Play/SoloSpectator.cs
+++ b/osu.Game/Screens/Play/SoloSpectator.cs
@@ -223,7 +223,7 @@ namespace osu.Game.Screens.Play
             onlineBeatmapRequest.Success += res => Schedule(() =>
             {
                 onlineBeatmap = res.ToBeatmapSet(rulesets);
-                beatmapPanelContainer.Child = new GridBeatmapPanel(onlineBeatmap);
+                beatmapPanelContainer.Child = new GridBeatmapPanel(res);
                 checkForAutomaticDownload();
             });
 
diff --git a/osu.Game/Screens/Select/BeatmapDetails.cs b/osu.Game/Screens/Select/BeatmapDetails.cs
index dfbaa9c6a5..ece16a8e57 100644
--- a/osu.Game/Screens/Select/BeatmapDetails.cs
+++ b/osu.Game/Screens/Select/BeatmapDetails.cs
@@ -57,7 +57,7 @@ namespace osu.Game.Screens.Select
                 beatmapInfo = value;
 
                 failTimes = beatmapInfo?.OnlineInfo?.FailTimes;
-                ratings = beatmapInfo?.BeatmapSet?.Ratings;
+                ratings = beatmapInfo?.BeatmapSet?.OnlineInfo?.Ratings;
 
                 Scheduler.AddOnce(updateStatistics);
             }
@@ -182,7 +182,7 @@ namespace osu.Game.Screens.Select
             source.Text = BeatmapInfo?.Metadata?.Source;
             tags.Text = BeatmapInfo?.Metadata?.Tags;
 
-            // metrics may have been previously fetched
+            // failTimes may have been previously fetched
             if (ratings != null && failTimes != null)
             {
                 updateMetrics();
diff --git a/osu.Game/Screens/Select/Details/AdvancedStats.cs b/osu.Game/Screens/Select/Details/AdvancedStats.cs
index 562ebad9fe..e129e75ec2 100644
--- a/osu.Game/Screens/Select/Details/AdvancedStats.cs
+++ b/osu.Game/Screens/Select/Details/AdvancedStats.cs
@@ -38,9 +38,9 @@ namespace osu.Game.Screens.Select.Details
         protected readonly StatisticRow FirstValue, HpDrain, Accuracy, ApproachRate;
         private readonly StatisticRow starDifficulty;
 
-        private BeatmapInfo beatmapInfo;
+        private IBeatmapInfo beatmapInfo;
 
-        public BeatmapInfo BeatmapInfo
+        public IBeatmapInfo BeatmapInfo
         {
             get => beatmapInfo;
             set
@@ -106,7 +106,7 @@ namespace osu.Game.Screens.Select.Details
 
         private void updateStatistics()
         {
-            IBeatmapDifficultyInfo baseDifficulty = BeatmapInfo?.BaseDifficulty;
+            IBeatmapDifficultyInfo baseDifficulty = BeatmapInfo?.Difficulty;
             BeatmapDifficulty adjustedDifficulty = null;
 
             if (baseDifficulty != null && mods.Value.Any(m => m is IApplicableToDifficulty))
@@ -117,7 +117,7 @@ namespace osu.Game.Screens.Select.Details
                     mod.ApplyToDifficulty(adjustedDifficulty);
             }
 
-            switch (BeatmapInfo?.Ruleset?.ID ?? 0)
+            switch (BeatmapInfo?.Ruleset.OnlineID)
             {
                 case 3:
                     // Account for mania differences locally for now

From 1fd05ab78aa7b09c63c8040e19fd92420ad02fc6 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 29 Oct 2021 18:56:13 +0900
Subject: [PATCH 0594/5547] Update framework

---
 osu.Android.props        | 2 +-
 osu.Game/osu.Game.csproj | 2 +-
 osu.iOS.props            | 4 ++--
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Android.props b/osu.Android.props
index 552675d706..dec994bcb2 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -52,7 +52,7 @@
   </ItemGroup>
   <ItemGroup>
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1026.0" />
-    <PackageReference Include="ppy.osu.Framework.Android" Version="2021.1026.0" />
+    <PackageReference Include="ppy.osu.Framework.Android" Version="2021.1029.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
     <!-- Realm needs to be directly referenced in all Xamarin projects, as it will not pull in its transitive dependencies otherwise. -->
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 8ba6e41d53..8052ab5254 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="10.6.0" />
-    <PackageReference Include="ppy.osu.Framework" Version="2021.1026.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2021.1029.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1026.0" />
     <PackageReference Include="Sentry" Version="3.9.4" />
     <PackageReference Include="SharpCompress" Version="0.29.0" />
diff --git a/osu.iOS.props b/osu.iOS.props
index e55dbb3bfe..d152cb7066 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -70,7 +70,7 @@
     <Reference Include="System.Net.Http" />
   </ItemGroup>
   <ItemGroup Label="Package References">
-    <PackageReference Include="ppy.osu.Framework.iOS" Version="2021.1026.0" />
+    <PackageReference Include="ppy.osu.Framework.iOS" Version="2021.1029.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1026.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net5.0 / net6.0) -->
@@ -93,7 +93,7 @@
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="2.2.6" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.Core" Version="2.2.6" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
-    <PackageReference Include="ppy.osu.Framework" Version="2021.1026.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2021.1029.0" />
     <PackageReference Include="SharpCompress" Version="0.28.3" />
     <PackageReference Include="NUnit" Version="3.13.2" />
     <PackageReference Include="SharpRaven" Version="2.4.0" />

From 22c2f48e4dd7468f2abf91702110a612c0cabe94 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 29 Oct 2021 19:05:30 +0900
Subject: [PATCH 0595/5547] Fix more null rulesets

---
 osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapDetails.cs | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapDetails.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapDetails.cs
index 1125e16d91..88acba756c 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapDetails.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapDetails.cs
@@ -7,6 +7,7 @@ using osu.Framework.Graphics;
 using osu.Game.Beatmaps;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests.Responses;
+using osu.Game.Rulesets.Osu;
 using osu.Game.Screens.Select;
 
 namespace osu.Game.Tests.Visual.SongSelect
@@ -54,6 +55,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                     ApproachRate = 3.5f,
                 },
                 StarDifficulty = 5.3f,
+                Ruleset = new OsuRuleset().RulesetInfo,
                 OnlineInfo = new APIBeatmap
                 {
                     FailTimes = new APIFailTimes
@@ -90,6 +92,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                     ApproachRate = 3.5f,
                 },
                 StarDifficulty = 5.3f,
+                Ruleset = new OsuRuleset().RulesetInfo,
                 OnlineInfo = new APIBeatmap
                 {
                     FailTimes = new APIFailTimes
@@ -119,6 +122,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                     Source = "osu!",
                     Tags = "this beatmap has ratings metrics but not retries or fails",
                 },
+                Ruleset = new OsuRuleset().RulesetInfo,
                 BaseDifficulty = new BeatmapDifficulty
                 {
                     CircleSize = 6,
@@ -148,6 +152,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                     OverallDifficulty = 6,
                     ApproachRate = 7,
                 },
+                Ruleset = new OsuRuleset().RulesetInfo,
                 StarDifficulty = 2.91f,
                 OnlineInfo = new APIBeatmap
                 {
@@ -171,6 +176,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                     Source = "osu!",
                     Tags = "this beatmap has no metrics",
                 },
+                Ruleset = new OsuRuleset().RulesetInfo,
                 BaseDifficulty = new BeatmapDifficulty
                 {
                     CircleSize = 5,

From bb9769aa178f52b75551cc0276e12dbd918c33bb Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 29 Oct 2021 20:12:12 +0900
Subject: [PATCH 0596/5547] Fix null ruleset in another place

---
 osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapDetails.cs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapDetails.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapDetails.cs
index 88acba756c..9856b28b00 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapDetails.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapDetails.cs
@@ -200,6 +200,7 @@ namespace osu.Game.Tests.Visual.SongSelect
             AddStep("online ratings/retries/fails", () => details.BeatmapInfo = new BeatmapInfo
             {
                 OnlineBeatmapID = 162,
+                Ruleset = new OsuRuleset().RulesetInfo
             });
             AddStep("set online", () => api.SetState(APIState.Online));
             AddStep("set offline", () => api.SetState(APIState.Offline));

From 4d988340eb02121e4f4645b480d657bbafbbfe4b Mon Sep 17 00:00:00 2001
From: Opelkuh <25430283+Opelkuh@users.noreply.github.com>
Date: Sat, 30 Oct 2021 01:02:53 +0200
Subject: [PATCH 0597/5547] Add hardware acceleration toggle

---
 .../Localisation/GraphicsSettingsStrings.cs   | 10 +++++
 .../Sections/Graphics/VideoSettings.cs        | 43 +++++++++++++++++++
 .../Settings/Sections/GraphicsSection.cs      |  1 +
 3 files changed, 54 insertions(+)
 create mode 100644 osu.Game/Overlays/Settings/Sections/Graphics/VideoSettings.cs

diff --git a/osu.Game/Localisation/GraphicsSettingsStrings.cs b/osu.Game/Localisation/GraphicsSettingsStrings.cs
index f85cc0f2ae..996a1350eb 100644
--- a/osu.Game/Localisation/GraphicsSettingsStrings.cs
+++ b/osu.Game/Localisation/GraphicsSettingsStrings.cs
@@ -119,6 +119,16 @@ namespace osu.Game.Localisation
         /// </summary>
         public static LocalisableString ShowCursorInScreenshots => new TranslatableString(getKey(@"show_cursor_in_screenshots"), @"Show menu cursor in screenshots");
 
+        /// <summary>
+        /// "Video"
+        /// </summary>
+        public static LocalisableString VideoHeader => new TranslatableString(getKey(@"video_header"), @"Video");
+
+        /// <summary>
+        /// "Use hardware acceleration"
+        /// </summary>
+        public static LocalisableString UseHardwareAcceleration => new TranslatableString(getKey(@"use_hardware_acceleration"), @"Use hardware acceleration");
+
         private static string getKey(string key) => $"{prefix}:{key}";
     }
 }
diff --git a/osu.Game/Overlays/Settings/Sections/Graphics/VideoSettings.cs b/osu.Game/Overlays/Settings/Sections/Graphics/VideoSettings.cs
new file mode 100644
index 0000000000..921eab63ed
--- /dev/null
+++ b/osu.Game/Overlays/Settings/Sections/Graphics/VideoSettings.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 osu.Framework.Allocation;
+using osu.Framework.Bindables;
+using osu.Framework.Configuration;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Video;
+using osu.Framework.Localisation;
+using osu.Game.Localisation;
+
+namespace osu.Game.Overlays.Settings.Sections.Graphics
+{
+    public class VideoSettings : SettingsSubsection
+    {
+        protected override LocalisableString Header => GraphicsSettingsStrings.VideoHeader;
+
+        private Bindable<HardwareVideoDecoder> hardwareVideoDecoder;
+        private SettingsCheckbox hwAccelCheckbox;
+
+        [BackgroundDependencyLoader]
+        private void load(FrameworkConfigManager config)
+        {
+            hardwareVideoDecoder = config.GetBindable<HardwareVideoDecoder>(FrameworkSetting.HardwareVideoDecoder);
+
+            Children = new Drawable[]
+            {
+                hwAccelCheckbox = new SettingsCheckbox
+                {
+                    LabelText = GraphicsSettingsStrings.UseHardwareAcceleration,
+                },
+            };
+
+            hwAccelCheckbox.Current.Default = hardwareVideoDecoder.Default != HardwareVideoDecoder.None;
+            hwAccelCheckbox.Current.Value = hardwareVideoDecoder.Value != HardwareVideoDecoder.None;
+
+            hwAccelCheckbox.Current.BindValueChanged(val =>
+            {
+                hardwareVideoDecoder.Value = val.NewValue ? HardwareVideoDecoder.Any : HardwareVideoDecoder.None;
+            });
+        }
+    }
+}
diff --git a/osu.Game/Overlays/Settings/Sections/GraphicsSection.cs b/osu.Game/Overlays/Settings/Sections/GraphicsSection.cs
index 591848506a..c792098c6d 100644
--- a/osu.Game/Overlays/Settings/Sections/GraphicsSection.cs
+++ b/osu.Game/Overlays/Settings/Sections/GraphicsSection.cs
@@ -25,6 +25,7 @@ namespace osu.Game.Overlays.Settings.Sections
                 new LayoutSettings(),
                 new RendererSettings(),
                 new ScreenshotSettings(),
+                new VideoSettings(),
             };
         }
     }

From e9473db77c61ce3e7b15f7f770634c5665b50d2d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 30 Oct 2021 20:37:55 +0900
Subject: [PATCH 0598/5547] Reorder to have video settings next to renderer

Co-authored-by: Salman Ahmed <frenzibyte@gmail.com>
---
 osu.Game/Overlays/Settings/Sections/GraphicsSection.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/Settings/Sections/GraphicsSection.cs b/osu.Game/Overlays/Settings/Sections/GraphicsSection.cs
index c792098c6d..8cd3b841c2 100644
--- a/osu.Game/Overlays/Settings/Sections/GraphicsSection.cs
+++ b/osu.Game/Overlays/Settings/Sections/GraphicsSection.cs
@@ -24,8 +24,8 @@ namespace osu.Game.Overlays.Settings.Sections
             {
                 new LayoutSettings(),
                 new RendererSettings(),
-                new ScreenshotSettings(),
                 new VideoSettings(),
+                new ScreenshotSettings(),
             };
         }
     }

From 6e4f7af8d36dbf59d396fec4d1ccdcbed9a0ea45 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 30 Oct 2021 14:15:20 +0200
Subject: [PATCH 0599/5547] Mark `IHasOnlineID` implementation with region

---
 osu.Game/Scoring/ScoreInfo.cs | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/osu.Game/Scoring/ScoreInfo.cs b/osu.Game/Scoring/ScoreInfo.cs
index 8eaec0a477..ed3b27dd22 100644
--- a/osu.Game/Scoring/ScoreInfo.cs
+++ b/osu.Game/Scoring/ScoreInfo.cs
@@ -272,6 +272,10 @@ namespace osu.Game.Scoring
             return ReferenceEquals(this, other);
         }
 
+        #region Implementation of IHasOnlineID
+
         public long OnlineID => OnlineScoreID ?? -1;
+
+        #endregion
     }
 }

From e9ba1ea1989b3dd03a4703a069df2ff9939b0714 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 30 Oct 2021 15:08:45 +0200
Subject: [PATCH 0600/5547] Mark `IScoreInfo` implementation with region

---
 osu.Game/Scoring/ScoreInfo.cs | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/osu.Game/Scoring/ScoreInfo.cs b/osu.Game/Scoring/ScoreInfo.cs
index 0efce4686c..36608e2a74 100644
--- a/osu.Game/Scoring/ScoreInfo.cs
+++ b/osu.Game/Scoring/ScoreInfo.cs
@@ -250,8 +250,12 @@ namespace osu.Game.Scoring
 
         #endregion
 
+        #region Implementation of IScoreInfo
+
         IBeatmapInfo IScoreInfo.Beatmap => BeatmapInfo;
         IRulesetInfo IScoreInfo.Ruleset => Ruleset;
         bool IScoreInfo.HasReplay => Files.Any();
+
+        #endregion
     }
 }

From b63a90966ba260c5122203c4b06299d2af40aa52 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 31 Oct 2021 23:49:26 +0900
Subject: [PATCH 0601/5547] Remove misplaced access modifier in interface
 specification
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/Scoring/IScoreInfo.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Scoring/IScoreInfo.cs b/osu.Game/Scoring/IScoreInfo.cs
index 171964206d..77579f23d9 100644
--- a/osu.Game/Scoring/IScoreInfo.cs
+++ b/osu.Game/Scoring/IScoreInfo.cs
@@ -29,7 +29,7 @@ namespace osu.Game.Scoring
 
         IRulesetInfo Ruleset { get; }
 
-        public ScoreRank Rank { get; }
+        ScoreRank Rank { get; }
 
         // Mods is currently missing from this interface as the `IMod` class has properties which can't be fulfilled by `APIMod`,
         // but also doesn't expose `Settings`. We can consider how to implement this in the future if required.

From 914e5c0f9d22485ace4e69a42d44e3d020f6d26d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 31 Oct 2021 18:58:17 +0100
Subject: [PATCH 0602/5547] Fix star rating not updating for some mods on
 details tab in song select

`AdvancedStats` was locally assuming that the only changes in mods that
are relevant to it are if the mods are `IApplicableToDifficulty`. This
is not true, as other mods (such as `IApplicableToRate` mods, or more
recently, Flashlight) can also affect star difficulty, which is shown on
one of the bars in `AdvancedStats`.
---
 osu.Game/Screens/Select/Details/AdvancedStats.cs | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/osu.Game/Screens/Select/Details/AdvancedStats.cs b/osu.Game/Screens/Select/Details/AdvancedStats.cs
index 562ebad9fe..25ca6ee264 100644
--- a/osu.Game/Screens/Select/Details/AdvancedStats.cs
+++ b/osu.Game/Screens/Select/Details/AdvancedStats.cs
@@ -94,9 +94,6 @@ namespace osu.Game.Screens.Select.Details
             modSettingChangeTracker = new ModSettingChangeTracker(mods.NewValue);
             modSettingChangeTracker.SettingChanged += m =>
             {
-                if (!(m is IApplicableToDifficulty))
-                    return;
-
                 debouncedStatisticsUpdate?.Cancel();
                 debouncedStatisticsUpdate = Scheduler.AddDelayed(updateStatistics, 100);
             };

From 02e69626e3eb8ffe01c0037421710dbbd2a6e37a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 1 Nov 2021 13:06:26 +0900
Subject: [PATCH 0603/5547] Reduce fail animation tint slightly

---
 osu.Game/Screens/Play/FailAnimation.cs | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Play/FailAnimation.cs b/osu.Game/Screens/Play/FailAnimation.cs
index edfb8186bb..f3676baf80 100644
--- a/osu.Game/Screens/Play/FailAnimation.cs
+++ b/osu.Game/Screens/Play/FailAnimation.cs
@@ -10,6 +10,7 @@ using ManagedBass.Fx;
 using osu.Framework.Allocation;
 using osu.Framework.Audio.Sample;
 using osu.Framework.Audio.Track;
+using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
@@ -83,7 +84,7 @@ namespace osu.Game.Screens.Play
                 Content,
                 redFlashLayer = new Box
                 {
-                    Colour = Color4.Red,
+                    Colour = Color4.Red.Opacity(0.6f),
                     RelativeSizeAxes = Axes.Both,
                     Blending = BlendingParameters.Additive,
                     Depth = float.MinValue,

From 269a8df0ecff144c4052c3640767aa98632e2e07 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 1 Nov 2021 13:20:37 +0900
Subject: [PATCH 0604/5547] Fix `HasReplay` not being corrrectly implemented by
 `APIScoreInfo`

---
 .../Visual/Gameplay/TestSceneReplayDownloadButton.cs        | 2 +-
 osu.Game/Online/API/Requests/Responses/APIScoreInfo.cs      | 6 ++----
 2 files changed, 3 insertions(+), 5 deletions(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneReplayDownloadButton.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneReplayDownloadButton.cs
index b84ac6c2f1..288da71ba3 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneReplayDownloadButton.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneReplayDownloadButton.cs
@@ -136,7 +136,7 @@ namespace osu.Game.Tests.Visual.Gameplay
             {
                 OnlineID = 2553163309,
                 OnlineRulesetID = 0,
-                Replay = replayAvailable,
+                HasReplay = replayAvailable,
                 User = new User
                 {
                     Id = 39828,
diff --git a/osu.Game/Online/API/Requests/Responses/APIScoreInfo.cs b/osu.Game/Online/API/Requests/Responses/APIScoreInfo.cs
index 4abb227414..1057819c6d 100644
--- a/osu.Game/Online/API/Requests/Responses/APIScoreInfo.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIScoreInfo.cs
@@ -26,13 +26,11 @@ namespace osu.Game.Online.API.Requests.Responses
         [JsonProperty(@"user")]
         public User User { get; set; }
 
-        public bool HasReplay { get; set; }
-
         [JsonProperty(@"id")]
         public long OnlineID { get; set; }
 
         [JsonProperty(@"replay")]
-        public bool Replay { get; set; }
+        public bool HasReplay { get; set; }
 
         [JsonProperty(@"created_at")]
         public DateTimeOffset Date { get; set; }
@@ -97,7 +95,7 @@ namespace osu.Game.Online.API.Requests.Responses
                 Date = Date,
                 PP = PP,
                 RulesetID = OnlineRulesetID,
-                Hash = Replay ? "online" : string.Empty, // todo: temporary?
+                Hash = HasReplay ? "online" : string.Empty, // todo: temporary?
                 Rank = Rank,
                 Ruleset = ruleset,
                 Mods = mods,

From 708b57348dfb2c1ef369c8a260875a10c7e11cb8 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 1 Nov 2021 13:22:16 +0900
Subject: [PATCH 0605/5547] Change loose api ordering requirement to throw
 instead

---
 osu.Game/Online/API/Requests/Responses/APIScoreInfo.cs | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Online/API/Requests/Responses/APIScoreInfo.cs b/osu.Game/Online/API/Requests/Responses/APIScoreInfo.cs
index 1057819c6d..3d82f91fb5 100644
--- a/osu.Game/Online/API/Requests/Responses/APIScoreInfo.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIScoreInfo.cs
@@ -50,8 +50,11 @@ namespace osu.Game.Online.API.Requests.Responses
             set
             {
                 // in the deserialisation case we need to ferry this data across.
-                if (Beatmap is APIBeatmap apiBeatmap)
-                    apiBeatmap.BeatmapSet = value;
+                // the order of properties returned by the API guarantees that the beatmap is populated by this point.
+                if (!(Beatmap is APIBeatmap apiBeatmap))
+                    throw new InvalidOperationException("Beatmap set metadata arrived before beatmap metadata in response");
+
+                apiBeatmap.BeatmapSet = value;
             }
         }
 

From 5bfb16efe25986088f7686b681391ae9faec09ef Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 1 Nov 2021 13:55:34 +0900
Subject: [PATCH 0606/5547] Ignore case when searching for existing `skin.ini`

---
 osu.Game/Skinning/Skin.cs        | 2 +-
 osu.Game/Skinning/SkinManager.cs | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Skinning/Skin.cs b/osu.Game/Skinning/Skin.cs
index a5639c3301..f8f9c1172d 100644
--- a/osu.Game/Skinning/Skin.cs
+++ b/osu.Game/Skinning/Skin.cs
@@ -93,7 +93,7 @@ namespace osu.Game.Skinning
 
         private Stream getConfigurationStream()
         {
-            string path = SkinInfo.Files.SingleOrDefault(f => f.Filename == "skin.ini")?.FileInfo.StoragePath;
+            string path = SkinInfo.Files.SingleOrDefault(f => f.Filename.Equals(@"skin.ini", StringComparison.OrdinalIgnoreCase))?.FileInfo.StoragePath;
 
             if (string.IsNullOrEmpty(path))
                 return null;
diff --git a/osu.Game/Skinning/SkinManager.cs b/osu.Game/Skinning/SkinManager.cs
index 2187d2d875..a537e8d5c3 100644
--- a/osu.Game/Skinning/SkinManager.cs
+++ b/osu.Game/Skinning/SkinManager.cs
@@ -194,7 +194,7 @@ namespace osu.Game.Skinning
             string nameLine = $"Name: {item.Name}";
             string authorLine = $"Author: {item.Creator}";
 
-            var existingFile = item.Files.SingleOrDefault(f => f.Filename == "skin.ini");
+            var existingFile = item.Files.SingleOrDefault(f => f.Filename.Equals(@"skin.ini", StringComparison.OrdinalIgnoreCase));
 
             if (existingFile != null)
             {

From 32817a4c66dda765de5774222e730af71686cf2f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 1 Nov 2021 13:55:45 +0900
Subject: [PATCH 0607/5547] Add test coverage of failure from incorrect case in
 `skin.ini` filename

---
 osu.Game.Tests/Skins/IO/ImportSkinTest.cs | 13 +++++++++++--
 1 file changed, 11 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Skins/IO/ImportSkinTest.cs b/osu.Game.Tests/Skins/IO/ImportSkinTest.cs
index b62fb8bd87..a5f588be45 100644
--- a/osu.Game.Tests/Skins/IO/ImportSkinTest.cs
+++ b/osu.Game.Tests/Skins/IO/ImportSkinTest.cs
@@ -29,6 +29,15 @@ namespace osu.Game.Tests.Skins.IO
             assertCorrectMetadata(import1, "test skin [skin]", "skinner", osu);
         });
 
+        [Test]
+        public Task TestSingleImportWeirdIniFileCase() => runSkinTest(async osu =>
+        {
+            var import1 = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOskWithIni("test skin", "skinner", iniFilename: "Skin.InI"), "skin.osk"));
+
+            // When the import filename doesn't match, it should be appended (and update the skin.ini).
+            assertCorrectMetadata(import1, "test skin [skin]", "skinner", osu);
+        });
+
         [Test]
         public Task TestSingleImportMatchingFilename() => runSkinTest(async osu =>
         {
@@ -190,11 +199,11 @@ namespace osu.Game.Tests.Skins.IO
             return zipStream;
         }
 
-        private MemoryStream createOskWithIni(string name, string author, bool makeUnique = false)
+        private MemoryStream createOskWithIni(string name, string author, bool makeUnique = false, string iniFilename = "skin.ini")
         {
             var zipStream = new MemoryStream();
             using var zip = ZipArchive.Create();
-            zip.AddEntry("skin.ini", generateSkinIni(name, author, makeUnique));
+            zip.AddEntry(iniFilename, generateSkinIni(name, author, makeUnique));
             zip.SaveTo(zipStream);
             return zipStream;
         }

From 6b250955d7ad884d66403b8e956b3327f640fb59 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 1 Nov 2021 14:09:17 +0900
Subject: [PATCH 0608/5547] Add missing verbatim string markers

---
 osu.Game.Tests/Skins/IO/ImportSkinTest.cs |  2 +-
 osu.Game/Skinning/SkinManager.cs          | 30 +++++++++++------------
 2 files changed, 16 insertions(+), 16 deletions(-)

diff --git a/osu.Game.Tests/Skins/IO/ImportSkinTest.cs b/osu.Game.Tests/Skins/IO/ImportSkinTest.cs
index a5f588be45..c75714032e 100644
--- a/osu.Game.Tests/Skins/IO/ImportSkinTest.cs
+++ b/osu.Game.Tests/Skins/IO/ImportSkinTest.cs
@@ -199,7 +199,7 @@ namespace osu.Game.Tests.Skins.IO
             return zipStream;
         }
 
-        private MemoryStream createOskWithIni(string name, string author, bool makeUnique = false, string iniFilename = "skin.ini")
+        private MemoryStream createOskWithIni(string name, string author, bool makeUnique = false, string iniFilename = @"skin.ini")
         {
             var zipStream = new MemoryStream();
             using var zip = ZipArchive.Create();
diff --git a/osu.Game/Skinning/SkinManager.cs b/osu.Game/Skinning/SkinManager.cs
index a537e8d5c3..76d36ae7d9 100644
--- a/osu.Game/Skinning/SkinManager.cs
+++ b/osu.Game/Skinning/SkinManager.cs
@@ -108,7 +108,7 @@ namespace osu.Game.Skinning
             }
         }
 
-        protected override bool ShouldDeleteArchive(string path) => Path.GetExtension(path)?.ToLowerInvariant() == ".osk";
+        protected override bool ShouldDeleteArchive(string path) => Path.GetExtension(path)?.ToLowerInvariant() == @".osk";
 
         /// <summary>
         /// Returns a list of all usable <see cref="SkinInfo"/>s. Includes the special default skin plus all skins from <see cref="GetAllUserSkins"/>.
@@ -149,9 +149,9 @@ namespace osu.Game.Skinning
             CurrentSkinInfo.Value = ModelStore.ConsumableItems.Single(i => i.ID == chosen.ID);
         }
 
-        protected override SkinInfo CreateModel(ArchiveReader archive) => new SkinInfo { Name = archive.Name ?? "No name" };
+        protected override SkinInfo CreateModel(ArchiveReader archive) => new SkinInfo { Name = archive.Name ?? @"No name" };
 
-        private const string unknown_creator_string = "Unknown";
+        private const string unknown_creator_string = @"Unknown";
 
         protected override bool HasCustomHashFunction => true;
 
@@ -164,7 +164,7 @@ namespace osu.Game.Skinning
             // `Skin` will parse the skin.ini and populate `Skin.Configuration` during construction above.
             string skinIniSourcedName = instance.Configuration.SkinInfo.Name;
             string skinIniSourcedCreator = instance.Configuration.SkinInfo.Creator;
-            string archiveName = item.Name.Replace(".osk", "", StringComparison.OrdinalIgnoreCase);
+            string archiveName = item.Name.Replace(@".osk", string.Empty, StringComparison.OrdinalIgnoreCase);
 
             bool isImport = item.ID == 0;
 
@@ -177,7 +177,7 @@ namespace osu.Game.Skinning
                 // In an ideal world, skin.ini would be the only source of metadata, but a lot of skin creators and users don't update it when making modifications.
                 // In both of these cases, the expectation from the user is that the filename or folder name is displayed somewhere to identify the skin.
                 if (archiveName != item.Name)
-                    item.Name = $"{item.Name} [{archiveName}]";
+                    item.Name = @$"{item.Name} [{archiveName}]";
             }
 
             // By this point, the metadata in SkinInfo will be correct.
@@ -191,8 +191,8 @@ namespace osu.Game.Skinning
 
         private void updateSkinIniMetadata(SkinInfo item)
         {
-            string nameLine = $"Name: {item.Name}";
-            string authorLine = $"Author: {item.Creator}";
+            string nameLine = @$"Name: {item.Name}";
+            string authorLine = @$"Author: {item.Creator}";
 
             var existingFile = item.Files.SingleOrDefault(f => f.Filename.Equals(@"skin.ini", StringComparison.OrdinalIgnoreCase));
 
@@ -210,12 +210,12 @@ namespace osu.Game.Skinning
 
                     while ((line = sr.ReadLine()) != null)
                     {
-                        if (line.StartsWith("Name:", StringComparison.Ordinal))
+                        if (line.StartsWith(@"Name:", StringComparison.Ordinal))
                         {
                             outputLines.Add(nameLine);
                             addedName = true;
                         }
-                        else if (line.StartsWith("Author:", StringComparison.Ordinal))
+                        else if (line.StartsWith(@"Author:", StringComparison.Ordinal))
                         {
                             outputLines.Add(authorLine);
                             addedAuthor = true;
@@ -229,7 +229,7 @@ namespace osu.Game.Skinning
                 {
                     outputLines.AddRange(new[]
                     {
-                        "[General]",
+                        @"[General]",
                         nameLine,
                         authorLine,
                     });
@@ -252,13 +252,13 @@ namespace osu.Game.Skinning
                 {
                     using (var sw = new StreamWriter(stream, Encoding.UTF8, 1024, true))
                     {
-                        sw.WriteLine("[General]");
+                        sw.WriteLine(@"[General]");
                         sw.WriteLine(nameLine);
                         sw.WriteLine(authorLine);
-                        sw.WriteLine("Version: latest");
+                        sw.WriteLine(@"Version: latest");
                     }
 
-                    AddFile(item, stream, "skin.ini");
+                    AddFile(item, stream, @"skin.ini");
                 }
             }
         }
@@ -295,7 +295,7 @@ namespace osu.Game.Skinning
             // if the user is attempting to save one of the default skin implementations, create a copy first.
             CurrentSkinInfo.Value = Import(new SkinInfo
             {
-                Name = skin.SkinInfo.Name + " (modified)",
+                Name = skin.SkinInfo.Name + @" (modified)",
                 Creator = skin.SkinInfo.Creator,
                 InstantiationInfo = skin.SkinInfo.InstantiationInfo,
             }).Result.Value;
@@ -312,7 +312,7 @@ namespace osu.Game.Skinning
 
                 using (var streamContent = new MemoryStream(Encoding.UTF8.GetBytes(json)))
                 {
-                    string filename = $"{drawableInfo.Key}.json";
+                    string filename = @$"{drawableInfo.Key}.json";
 
                     var oldFile = skin.SkinInfo.Files.FirstOrDefault(f => f.Filename == filename);
 

From 10a9266956104120a6b17e36d26f142671a6fc09 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 1 Nov 2021 14:33:24 +0900
Subject: [PATCH 0609/5547] Fix beatmap creator showing twice in tournament map
 pool panels

---
 osu.Game.Tournament/Components/TournamentBeatmapPanel.cs | 2 +-
 osu.Game/Beatmaps/BeatmapInfoExtensions.cs               | 4 ++--
 osu.Game/Beatmaps/BeatmapMetadataInfoExtensions.cs       | 4 ++--
 3 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/osu.Game.Tournament/Components/TournamentBeatmapPanel.cs b/osu.Game.Tournament/Components/TournamentBeatmapPanel.cs
index ed107c3a83..f3550f7465 100644
--- a/osu.Game.Tournament/Components/TournamentBeatmapPanel.cs
+++ b/osu.Game.Tournament/Components/TournamentBeatmapPanel.cs
@@ -76,7 +76,7 @@ namespace osu.Game.Tournament.Components
                     {
                         new TournamentSpriteText
                         {
-                            Text = Beatmap.GetDisplayTitleRomanisable(false),
+                            Text = Beatmap.GetDisplayTitleRomanisable(false, false),
                             Font = OsuFont.Torus.With(weight: FontWeight.Bold),
                         },
                         new FillFlowContainer
diff --git a/osu.Game/Beatmaps/BeatmapInfoExtensions.cs b/osu.Game/Beatmaps/BeatmapInfoExtensions.cs
index c35370d572..2d69015933 100644
--- a/osu.Game/Beatmaps/BeatmapInfoExtensions.cs
+++ b/osu.Game/Beatmaps/BeatmapInfoExtensions.cs
@@ -16,9 +16,9 @@ namespace osu.Game.Beatmaps
         /// <summary>
         /// A user-presentable display title representing this beatmap, with localisation handling for potentially romanisable fields.
         /// </summary>
-        public static RomanisableString GetDisplayTitleRomanisable(this IBeatmapInfo beatmapInfo, bool includeDifficultyName = true)
+        public static RomanisableString GetDisplayTitleRomanisable(this IBeatmapInfo beatmapInfo, bool includeDifficultyName = true, bool includeCreator = true)
         {
-            var metadata = getClosestMetadata(beatmapInfo).GetDisplayTitleRomanisable();
+            var metadata = getClosestMetadata(beatmapInfo).GetDisplayTitleRomanisable(includeCreator);
 
             if (includeDifficultyName)
             {
diff --git a/osu.Game/Beatmaps/BeatmapMetadataInfoExtensions.cs b/osu.Game/Beatmaps/BeatmapMetadataInfoExtensions.cs
index 732b76e967..fcaad17059 100644
--- a/osu.Game/Beatmaps/BeatmapMetadataInfoExtensions.cs
+++ b/osu.Game/Beatmaps/BeatmapMetadataInfoExtensions.cs
@@ -34,9 +34,9 @@ namespace osu.Game.Beatmaps
         /// <summary>
         /// A user-presentable display title representing this beatmap, with localisation handling for potentially romanisable fields.
         /// </summary>
-        public static RomanisableString GetDisplayTitleRomanisable(this IBeatmapMetadataInfo metadataInfo)
+        public static RomanisableString GetDisplayTitleRomanisable(this IBeatmapMetadataInfo metadataInfo, bool includeCreator = true)
         {
-            string author = string.IsNullOrEmpty(metadataInfo.Author) ? string.Empty : $"({metadataInfo.Author})";
+            string author = !includeCreator || string.IsNullOrEmpty(metadataInfo.Author) ? string.Empty : $"({metadataInfo.Author})";
             string artistUnicode = string.IsNullOrEmpty(metadataInfo.ArtistUnicode) ? metadataInfo.Artist : metadataInfo.ArtistUnicode;
             string titleUnicode = string.IsNullOrEmpty(metadataInfo.TitleUnicode) ? metadataInfo.Title : metadataInfo.TitleUnicode;
 

From 21e0074d3bf2f23476012ff1a83568cf1148a9fd Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 1 Nov 2021 14:43:32 +0900
Subject: [PATCH 0610/5547] Add missing `AddInternal` call for
 `BeatmapSetHeaderContent`'s download tracker

---
 osu.Game/Overlays/BeatmapSet/BeatmapSetHeaderContent.cs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Game/Overlays/BeatmapSet/BeatmapSetHeaderContent.cs b/osu.Game/Overlays/BeatmapSet/BeatmapSetHeaderContent.cs
index 97cd17313e..1bfa7d1c47 100644
--- a/osu.Game/Overlays/BeatmapSet/BeatmapSetHeaderContent.cs
+++ b/osu.Game/Overlays/BeatmapSet/BeatmapSetHeaderContent.cs
@@ -249,6 +249,7 @@ namespace osu.Game.Overlays.BeatmapSet
                 {
                     downloadTracker = new BeatmapDownloadTracker(setInfo.NewValue);
                     downloadTracker.State.BindValueChanged(_ => updateDownloadButtons());
+                    AddInternal(downloadTracker);
 
                     fadeContent.FadeIn(500, Easing.OutQuint);
 

From 123b10f647d379195d4a702c56209fa7eae9a3e2 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 1 Nov 2021 15:10:32 +0900
Subject: [PATCH 0611/5547] Fix playlist item download button being clickable
 when it shouldn't

---
 .../OnlinePlay/DrawableRoomPlaylistItem.cs      | 17 +++++++++++------
 1 file changed, 11 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
index c946bf12fd..69ab7225ac 100644
--- a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
+++ b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
@@ -248,10 +248,7 @@ namespace osu.Game.Screens.OnlinePlay
         protected virtual IEnumerable<Drawable> CreateButtons() =>
             new Drawable[]
             {
-                new PlaylistDownloadButton(Item)
-                {
-                    Size = new Vector2(50, 30)
-                },
+                new PlaylistDownloadButton(Item),
                 new PlaylistRemoveButton
                 {
                     Size = new Vector2(30, 30),
@@ -292,10 +289,14 @@ namespace osu.Game.Screens.OnlinePlay
             // required for download tracking, as this button hides itself. can probably be removed with a bit of consideration.
             public override bool IsPresent => true;
 
+            private const float width = 50;
+
             public PlaylistDownloadButton(PlaylistItem playlistItem)
                 : base(playlistItem.Beatmap.Value.BeatmapSet)
             {
                 this.playlistItem = playlistItem;
+
+                Size = new Vector2(width, 30);
                 Alpha = 0;
             }
 
@@ -316,12 +317,16 @@ namespace osu.Game.Screens.OnlinePlay
                         if (beatmapManager.QueryBeatmap(b => b.MD5Hash == playlistItem.Beatmap.Value.MD5Hash) == null)
                             State.Value = DownloadState.NotDownloaded;
                         else
-                            this.FadeTo(0, 500);
+                        {
+                            this.FadeTo(0, 500)
+                                .ResizeWidthTo(0, 500, Easing.OutQuint);
+                        }
 
                         break;
 
                     default:
-                        this.FadeTo(1, 500);
+                        this.ResizeWidthTo(width, 500, Easing.OutQuint)
+                            .FadeTo(1, 500);
                         break;
                 }
             }

From 227963047a681aea23ccadb0307065ab6be0e6b7 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 1 Nov 2021 15:15:41 +0900
Subject: [PATCH 0612/5547] Fix hash validity check function returning
 incorrect results after soft deleting a beatmap

The soft-deleted one would potentially match before the newly imported
copy, resulting in a false-positive hash mismatch.
---
 osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs b/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs
index 88793c7cfc..6cd735af23 100644
--- a/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs
+++ b/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs
@@ -109,8 +109,7 @@ namespace osu.Game.Online.Rooms
             int onlineId = SelectedItem.Value.Beatmap.Value.OnlineID;
             string checksum = SelectedItem.Value.Beatmap.Value.MD5Hash;
 
-            var beatmap = beatmapManager.QueryBeatmap(b => b.OnlineBeatmapID == onlineId && b.MD5Hash == checksum);
-            return beatmap?.BeatmapSet.DeletePending == false;
+            return beatmapManager.QueryBeatmap(b => b.OnlineBeatmapID == onlineId && b.MD5Hash == checksum && !b.BeatmapSet.DeletePending) != null;
         }
     }
 }

From 94dce3f92acf5ff156afd7cefe0b3ad609e8f2ed Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Mon, 1 Nov 2021 15:43:19 +0900
Subject: [PATCH 0613/5547] Remove whitespace

---
 osu.Game/Online/API/Requests/Responses/APIScoreWithPosition.cs | 1 -
 1 file changed, 1 deletion(-)

diff --git a/osu.Game/Online/API/Requests/Responses/APIScoreWithPosition.cs b/osu.Game/Online/API/Requests/Responses/APIScoreWithPosition.cs
index a0fc549d98..48b7134901 100644
--- a/osu.Game/Online/API/Requests/Responses/APIScoreWithPosition.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIScoreWithPosition.cs
@@ -17,7 +17,6 @@ namespace osu.Game.Online.API.Requests.Responses
         public APIScoreInfo Score;
 
         public ScoreInfo CreateScoreInfo(RulesetStore rulesets, BeatmapInfo beatmap = null)
-
         {
             var score = Score.CreateScoreInfo(rulesets, beatmap);
             score.Position = Position;

From 722e0d50bb9c2602c82c81b182c9dca4e51373ee Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 1 Nov 2021 15:54:39 +0900
Subject: [PATCH 0614/5547] Fix `BeatmapInfo` not being correctly populated in
 `CreateScoreInfo` call

---
 osu.Game/Online/API/Requests/Responses/APIScoreInfo.cs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Game/Online/API/Requests/Responses/APIScoreInfo.cs b/osu.Game/Online/API/Requests/Responses/APIScoreInfo.cs
index 3d82f91fb5..1b66a1dcc3 100644
--- a/osu.Game/Online/API/Requests/Responses/APIScoreInfo.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIScoreInfo.cs
@@ -92,6 +92,7 @@ namespace osu.Game.Online.API.Requests.Responses
             {
                 TotalScore = TotalScore,
                 MaxCombo = MaxCombo,
+                BeatmapInfo = Beatmap.ToBeatmapInfo(rulesets),
                 User = User,
                 Accuracy = Accuracy,
                 OnlineScoreID = OnlineID,

From 63c9512ab11a722ffe0849d4de279797ae011c94 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 1 Nov 2021 16:02:00 +0900
Subject: [PATCH 0615/5547] Update dashboard components to use `APIBeatmapSet`

---
 .../TestSceneDashboardBeatmapListing.cs       | 108 +++++++-----------
 .../Dashboard/Home/DashboardBeatmapListing.cs |   8 +-
 .../Dashboard/Home/DashboardBeatmapPanel.cs   |  20 ++--
 .../Home/DashboardNewBeatmapPanel.cs          |   8 +-
 .../Home/DashboardPopularBeatmapPanel.cs      |   8 +-
 .../Dashboard/Home/DrawableBeatmapList.cs     |  12 +-
 .../Dashboard/Home/DrawableNewBeatmapList.cs  |   8 +-
 .../Home/DrawablePopularBeatmapList.cs        |   8 +-
 8 files changed, 78 insertions(+), 102 deletions(-)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneDashboardBeatmapListing.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneDashboardBeatmapListing.cs
index 6727c7560b..06c64a566e 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneDashboardBeatmapListing.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneDashboardBeatmapListing.cs
@@ -56,95 +56,71 @@ namespace osu.Game.Tests.Visual.UserInterface
             AddStep("Set width to 300", () => content.ResizeWidthTo(300, 500));
         }
 
-        private static readonly List<BeatmapSetInfo> new_beatmaps = new List<BeatmapSetInfo>
+        private static readonly List<APIBeatmapSet> new_beatmaps = new List<APIBeatmapSet>
         {
-            new BeatmapSetInfo
+            new APIBeatmapSet
             {
-                Metadata = new BeatmapMetadata
+                Title = "Very Long Title (TV size) [TATOE]",
+                Artist = "This artist has a really long name how is this possible",
+                Author = new User
                 {
-                    Title = "Very Long Title (TV size) [TATOE]",
-                    Artist = "This artist has a really long name how is this possible",
-                    Author = new User
-                    {
-                        Username = "author",
-                        Id = 100
-                    }
+                    Username = "author",
+                    Id = 100
                 },
-                OnlineInfo = new APIBeatmapSet
+                Covers = new BeatmapSetOnlineCovers
                 {
-                    Covers = new BeatmapSetOnlineCovers
-                    {
-                        Cover = "https://assets.ppy.sh/beatmaps/1189904/covers/cover.jpg?1595456608",
-                    },
-                    Ranked = DateTimeOffset.Now
-                }
+                    Cover = "https://assets.ppy.sh/beatmaps/1189904/covers/cover.jpg?1595456608",
+                },
+                Ranked = DateTimeOffset.Now
             },
-            new BeatmapSetInfo
+            new APIBeatmapSet
             {
-                Metadata = new BeatmapMetadata
+                Title = "Very Long Title (TV size) [TATOE]",
+                Artist = "This artist has a really long name how is this possible",
+                Author = new User
                 {
-                    Title = "Very Long Title (TV size) [TATOE]",
-                    Artist = "This artist has a really long name how is this possible",
-                    Author = new User
-                    {
-                        Username = "author",
-                        Id = 100
-                    }
+                    Username = "author",
+                    Id = 100
                 },
-                OnlineInfo = new APIBeatmapSet
+                Covers = new BeatmapSetOnlineCovers
                 {
-                    Covers = new BeatmapSetOnlineCovers
-                    {
-                        Cover = "https://assets.ppy.sh/beatmaps/1189904/covers/cover.jpg?1595456608",
-                    },
-                    Ranked = DateTimeOffset.MinValue
-                }
+                    Cover = "https://assets.ppy.sh/beatmaps/1189904/covers/cover.jpg?1595456608",
+                },
+                Ranked = DateTimeOffset.Now
             }
         };
 
-        private static readonly List<BeatmapSetInfo> popular_beatmaps = new List<BeatmapSetInfo>
+        private static readonly List<APIBeatmapSet> popular_beatmaps = new List<APIBeatmapSet>
         {
-            new BeatmapSetInfo
+            new APIBeatmapSet
             {
-                Metadata = new BeatmapMetadata
+                Title = "Very Long Title (TV size) [TATOE]",
+                Artist = "This artist has a really long name how is this possible",
+                Author = new User
                 {
-                    Title = "Title",
-                    Artist = "Artist",
-                    Author = new User
-                    {
-                        Username = "author",
-                        Id = 100
-                    }
+                    Username = "author",
+                    Id = 100
                 },
-                OnlineInfo = new APIBeatmapSet
+                Covers = new BeatmapSetOnlineCovers
                 {
-                    Covers = new BeatmapSetOnlineCovers
-                    {
-                        Cover = "https://assets.ppy.sh/beatmaps/1079428/covers/cover.jpg?1595295586",
-                    },
-                    FavouriteCount = 100
-                }
+                    Cover = "https://assets.ppy.sh/beatmaps/1189904/covers/cover.jpg?1595456608",
+                },
+                Ranked = DateTimeOffset.Now
             },
-            new BeatmapSetInfo
+            new APIBeatmapSet
             {
-                Metadata = new BeatmapMetadata
+                Title = "Very Long Title (TV size) [TATOE]",
+                Artist = "This artist has a really long name how is this possible",
+                Author = new User
                 {
-                    Title = "Title 2",
-                    Artist = "Artist 2",
-                    Author = new User
-                    {
-                        Username = "someone",
-                        Id = 100
-                    }
+                    Username = "author",
+                    Id = 100
                 },
-                OnlineInfo = new APIBeatmapSet
+                Covers = new BeatmapSetOnlineCovers
                 {
-                    Covers = new BeatmapSetOnlineCovers
-                    {
-                        Cover = "https://assets.ppy.sh/beatmaps/1079428/covers/cover.jpg?1595295586",
-                    },
-                    FavouriteCount = 10
-                }
+                    Cover = "https://assets.ppy.sh/beatmaps/1189904/covers/cover.jpg?1595456608",
+                },
+                Ranked = DateTimeOffset.Now
             }
         };
     }
diff --git a/osu.Game/Overlays/Dashboard/Home/DashboardBeatmapListing.cs b/osu.Game/Overlays/Dashboard/Home/DashboardBeatmapListing.cs
index 4d96825353..c781aa0cfb 100644
--- a/osu.Game/Overlays/Dashboard/Home/DashboardBeatmapListing.cs
+++ b/osu.Game/Overlays/Dashboard/Home/DashboardBeatmapListing.cs
@@ -5,17 +5,17 @@ using System.Collections.Generic;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
-using osu.Game.Beatmaps;
+using osu.Game.Online.API.Requests.Responses;
 using osuTK;
 
 namespace osu.Game.Overlays.Dashboard.Home
 {
     public class DashboardBeatmapListing : CompositeDrawable
     {
-        private readonly List<BeatmapSetInfo> newBeatmaps;
-        private readonly List<BeatmapSetInfo> popularBeatmaps;
+        private readonly List<APIBeatmapSet> newBeatmaps;
+        private readonly List<APIBeatmapSet> popularBeatmaps;
 
-        public DashboardBeatmapListing(List<BeatmapSetInfo> newBeatmaps, List<BeatmapSetInfo> popularBeatmaps)
+        public DashboardBeatmapListing(List<APIBeatmapSet> newBeatmaps, List<APIBeatmapSet> popularBeatmaps)
         {
             this.newBeatmaps = newBeatmaps;
             this.popularBeatmaps = popularBeatmaps;
diff --git a/osu.Game/Overlays/Dashboard/Home/DashboardBeatmapPanel.cs b/osu.Game/Overlays/Dashboard/Home/DashboardBeatmapPanel.cs
index 50186def37..9276e6ce80 100644
--- a/osu.Game/Overlays/Dashboard/Home/DashboardBeatmapPanel.cs
+++ b/osu.Game/Overlays/Dashboard/Home/DashboardBeatmapPanel.cs
@@ -7,11 +7,11 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Input.Events;
-using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.Drawables;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
+using osu.Game.Online.API.Requests.Responses;
 using osuTK;
 
 namespace osu.Game.Overlays.Dashboard.Home
@@ -24,14 +24,14 @@ namespace osu.Game.Overlays.Dashboard.Home
         [Resolved(canBeNull: true)]
         private BeatmapSetOverlay beatmapOverlay { get; set; }
 
-        protected readonly BeatmapSetInfo SetInfo;
+        protected readonly APIBeatmapSet BeatmapSet;
 
         private Box hoverBackground;
         private SpriteIcon chevron;
 
-        protected DashboardBeatmapPanel(BeatmapSetInfo setInfo)
+        protected DashboardBeatmapPanel(APIBeatmapSet beatmapSet)
         {
-            SetInfo = setInfo;
+            BeatmapSet = beatmapSet;
         }
 
         [BackgroundDependencyLoader]
@@ -82,7 +82,7 @@ namespace osu.Game.Overlays.Dashboard.Home
                                         RelativeSizeAxes = Axes.Both,
                                         Anchor = Anchor.Centre,
                                         Origin = Anchor.Centre,
-                                        OnlineInfo = SetInfo.OnlineInfo
+                                        OnlineInfo = BeatmapSet
                                     }
                                 },
                                 new Container
@@ -103,14 +103,14 @@ namespace osu.Game.Overlays.Dashboard.Home
                                                 RelativeSizeAxes = Axes.X,
                                                 Truncate = true,
                                                 Font = OsuFont.GetFont(weight: FontWeight.Regular),
-                                                Text = SetInfo.Metadata.Title
+                                                Text = BeatmapSet.Title
                                             },
                                             new OsuSpriteText
                                             {
                                                 RelativeSizeAxes = Axes.X,
                                                 Truncate = true,
                                                 Font = OsuFont.GetFont(size: 12, weight: FontWeight.Regular),
-                                                Text = SetInfo.Metadata.Artist
+                                                Text = BeatmapSet.Artist
                                             },
                                             new LinkFlowContainer(f => f.Font = OsuFont.GetFont(size: 10, weight: FontWeight.Regular))
                                             {
@@ -121,7 +121,7 @@ namespace osu.Game.Overlays.Dashboard.Home
                                             }.With(c =>
                                             {
                                                 c.AddText("by");
-                                                c.AddUserLink(SetInfo.Metadata.Author);
+                                                c.AddUserLink(BeatmapSet.Author);
                                                 c.AddArbitraryDrawable(CreateInfo());
                                             })
                                         }
@@ -143,8 +143,8 @@ namespace osu.Game.Overlays.Dashboard.Home
 
             Action = () =>
             {
-                if (SetInfo.OnlineBeatmapSetID.HasValue)
-                    beatmapOverlay?.FetchAndShowBeatmapSet(SetInfo.OnlineBeatmapSetID.Value);
+                if (BeatmapSet.OnlineID > 0)
+                    beatmapOverlay?.FetchAndShowBeatmapSet(BeatmapSet.OnlineID);
             };
         }
 
diff --git a/osu.Game/Overlays/Dashboard/Home/DashboardNewBeatmapPanel.cs b/osu.Game/Overlays/Dashboard/Home/DashboardNewBeatmapPanel.cs
index b212eaf20a..249b355be3 100644
--- a/osu.Game/Overlays/Dashboard/Home/DashboardNewBeatmapPanel.cs
+++ b/osu.Game/Overlays/Dashboard/Home/DashboardNewBeatmapPanel.cs
@@ -3,19 +3,19 @@
 
 using System;
 using osu.Framework.Graphics;
-using osu.Game.Beatmaps;
 using osu.Game.Graphics;
+using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Overlays.Dashboard.Home
 {
     public class DashboardNewBeatmapPanel : DashboardBeatmapPanel
     {
-        public DashboardNewBeatmapPanel(BeatmapSetInfo setInfo)
-            : base(setInfo)
+        public DashboardNewBeatmapPanel(APIBeatmapSet beatmapSet)
+            : base(beatmapSet)
         {
         }
 
-        protected override Drawable CreateInfo() => new DrawableDate(SetInfo.OnlineInfo.Ranked ?? DateTimeOffset.Now, 10, false)
+        protected override Drawable CreateInfo() => new DrawableDate(BeatmapSet.Ranked ?? DateTimeOffset.Now, 10, false)
         {
             Colour = ColourProvider.Foreground1
         };
diff --git a/osu.Game/Overlays/Dashboard/Home/DashboardPopularBeatmapPanel.cs b/osu.Game/Overlays/Dashboard/Home/DashboardPopularBeatmapPanel.cs
index e9066c0657..4e50cce890 100644
--- a/osu.Game/Overlays/Dashboard/Home/DashboardPopularBeatmapPanel.cs
+++ b/osu.Game/Overlays/Dashboard/Home/DashboardPopularBeatmapPanel.cs
@@ -4,17 +4,17 @@
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Sprites;
-using osu.Game.Beatmaps;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
+using osu.Game.Online.API.Requests.Responses;
 using osuTK;
 
 namespace osu.Game.Overlays.Dashboard.Home
 {
     public class DashboardPopularBeatmapPanel : DashboardBeatmapPanel
     {
-        public DashboardPopularBeatmapPanel(BeatmapSetInfo setInfo)
-            : base(setInfo)
+        public DashboardPopularBeatmapPanel(APIBeatmapSet beatmapSet)
+            : base(beatmapSet)
         {
         }
 
@@ -34,7 +34,7 @@ namespace osu.Game.Overlays.Dashboard.Home
                 new OsuSpriteText
                 {
                     Font = OsuFont.GetFont(size: 10, weight: FontWeight.Regular),
-                    Text = SetInfo.OnlineInfo.FavouriteCount.ToString()
+                    Text = BeatmapSet.FavouriteCount.ToString()
                 }
             }
         };
diff --git a/osu.Game/Overlays/Dashboard/Home/DrawableBeatmapList.cs b/osu.Game/Overlays/Dashboard/Home/DrawableBeatmapList.cs
index f6535b7db3..c73cc828e2 100644
--- a/osu.Game/Overlays/Dashboard/Home/DrawableBeatmapList.cs
+++ b/osu.Game/Overlays/Dashboard/Home/DrawableBeatmapList.cs
@@ -6,20 +6,20 @@ using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
-using osu.Game.Beatmaps;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
+using osu.Game.Online.API.Requests.Responses;
 using osuTK;
 
 namespace osu.Game.Overlays.Dashboard.Home
 {
     public abstract class DrawableBeatmapList : CompositeDrawable
     {
-        private readonly List<BeatmapSetInfo> beatmaps;
+        private readonly List<APIBeatmapSet> beatmapSets;
 
-        protected DrawableBeatmapList(List<BeatmapSetInfo> beatmaps)
+        protected DrawableBeatmapList(List<APIBeatmapSet> beatmapSets)
         {
-            this.beatmaps = beatmaps;
+            this.beatmapSets = beatmapSets;
         }
 
         [BackgroundDependencyLoader]
@@ -46,11 +46,11 @@ namespace osu.Game.Overlays.Dashboard.Home
                 }
             };
 
-            flow.AddRange(beatmaps.Select(CreateBeatmapPanel));
+            flow.AddRange(beatmapSets.Select(CreateBeatmapPanel));
         }
 
         protected abstract string Title { get; }
 
-        protected abstract DashboardBeatmapPanel CreateBeatmapPanel(BeatmapSetInfo setInfo);
+        protected abstract DashboardBeatmapPanel CreateBeatmapPanel(APIBeatmapSet beatmapSet);
     }
 }
diff --git a/osu.Game/Overlays/Dashboard/Home/DrawableNewBeatmapList.cs b/osu.Game/Overlays/Dashboard/Home/DrawableNewBeatmapList.cs
index 75e8ca336d..714e07a7ed 100644
--- a/osu.Game/Overlays/Dashboard/Home/DrawableNewBeatmapList.cs
+++ b/osu.Game/Overlays/Dashboard/Home/DrawableNewBeatmapList.cs
@@ -2,18 +2,18 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System.Collections.Generic;
-using osu.Game.Beatmaps;
+using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Overlays.Dashboard.Home
 {
     public class DrawableNewBeatmapList : DrawableBeatmapList
     {
-        public DrawableNewBeatmapList(List<BeatmapSetInfo> beatmaps)
-            : base(beatmaps)
+        public DrawableNewBeatmapList(List<APIBeatmapSet> beatmapSets)
+            : base(beatmapSets)
         {
         }
 
-        protected override DashboardBeatmapPanel CreateBeatmapPanel(BeatmapSetInfo setInfo) => new DashboardNewBeatmapPanel(setInfo);
+        protected override DashboardBeatmapPanel CreateBeatmapPanel(APIBeatmapSet beatmapSet) => new DashboardNewBeatmapPanel(beatmapSet);
 
         protected override string Title => "New Ranked Beatmaps";
     }
diff --git a/osu.Game/Overlays/Dashboard/Home/DrawablePopularBeatmapList.cs b/osu.Game/Overlays/Dashboard/Home/DrawablePopularBeatmapList.cs
index 90bd00008c..48b100b04e 100644
--- a/osu.Game/Overlays/Dashboard/Home/DrawablePopularBeatmapList.cs
+++ b/osu.Game/Overlays/Dashboard/Home/DrawablePopularBeatmapList.cs
@@ -2,18 +2,18 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System.Collections.Generic;
-using osu.Game.Beatmaps;
+using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Overlays.Dashboard.Home
 {
     public class DrawablePopularBeatmapList : DrawableBeatmapList
     {
-        public DrawablePopularBeatmapList(List<BeatmapSetInfo> beatmaps)
-            : base(beatmaps)
+        public DrawablePopularBeatmapList(List<APIBeatmapSet> beatmapSets)
+            : base(beatmapSets)
         {
         }
 
-        protected override DashboardBeatmapPanel CreateBeatmapPanel(BeatmapSetInfo setInfo) => new DashboardPopularBeatmapPanel(setInfo);
+        protected override DashboardBeatmapPanel CreateBeatmapPanel(APIBeatmapSet beatmapSet) => new DashboardPopularBeatmapPanel(beatmapSet);
 
         protected override string Title => "Popular Beatmaps";
     }

From 90a0a5e0b7383488796634e64b7099cd60689f9a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 1 Nov 2021 17:12:15 +0900
Subject: [PATCH 0616/5547] Fix attempting to set properties of null
 `BeatmapSet`s in tests

---
 .../Visual/Online/TestSceneUserProfileScores.cs           | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneUserProfileScores.cs b/osu.Game.Tests/Visual/Online/TestSceneUserProfileScores.cs
index fac350ea57..9c2cc13416 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneUserProfileScores.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneUserProfileScores.cs
@@ -25,7 +25,7 @@ namespace osu.Game.Tests.Visual.Online
                 Rank = ScoreRank.SH,
                 Beatmap = new APIBeatmap
                 {
-                    BeatmapSet =
+                    BeatmapSet = new APIBeatmapSet
                     {
                         Title = "JUSTadICE (TV Size)",
                         Artist = "Oomori Seiko",
@@ -48,7 +48,7 @@ namespace osu.Game.Tests.Visual.Online
                 Rank = ScoreRank.A,
                 Beatmap = new APIBeatmap
                 {
-                    BeatmapSet =
+                    BeatmapSet = new APIBeatmapSet
                     {
                         Title = "Triumph & Regret",
                         Artist = "typeMARS",
@@ -70,7 +70,7 @@ namespace osu.Game.Tests.Visual.Online
                 Rank = ScoreRank.S,
                 Beatmap = new APIBeatmap
                 {
-                    BeatmapSet =
+                    BeatmapSet = new APIBeatmapSet
                     {
                         Title = "Idolize",
                         Artist = "Creo",
@@ -86,7 +86,7 @@ namespace osu.Game.Tests.Visual.Online
                 Rank = ScoreRank.B,
                 Beatmap = new APIBeatmap
                 {
-                    BeatmapSet =
+                    BeatmapSet = new APIBeatmapSet
                     {
                         Title = "C18H27NO3(extend)",
                         Artist = "Team Grimoire",

From cd4681496a9ac088d037a9f4a9932d8a20e205a3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 1 Nov 2021 09:35:02 +0100
Subject: [PATCH 0617/5547] Fix incorrect state transition in score download
 tracker

---
 osu.Game/Online/ScoreDownloadTracker.cs | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Online/ScoreDownloadTracker.cs b/osu.Game/Online/ScoreDownloadTracker.cs
index 8222a5382c..675dbf608c 100644
--- a/osu.Game/Online/ScoreDownloadTracker.cs
+++ b/osu.Game/Online/ScoreDownloadTracker.cs
@@ -122,10 +122,8 @@ namespace osu.Game.Online
             {
                 Schedule(() =>
                 {
-                    if (!checkEquality(item, TrackedItem))
-                        return;
-
-                    UpdateState(DownloadState.NotDownloaded);
+                    if (checkEquality(item, TrackedItem))
+                        UpdateState(DownloadState.LocallyAvailable);
                 });
             }
         }

From 6a44cf3ff1181311d6acffd769793838505a3f6a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 1 Nov 2021 09:14:02 +0100
Subject: [PATCH 0618/5547] Add missing beatmap spec in test scene

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

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneReplayDownloadButton.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneReplayDownloadButton.cs
index 288da71ba3..311c3ddc03 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneReplayDownloadButton.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneReplayDownloadButton.cs
@@ -13,6 +13,7 @@ using osu.Framework.Bindables;
 using osu.Framework.Testing;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Rulesets;
+using osu.Game.Rulesets.Osu;
 using osu.Game.Screens.Ranking;
 using osuTK.Input;
 
@@ -136,6 +137,7 @@ namespace osu.Game.Tests.Visual.Gameplay
             {
                 OnlineID = 2553163309,
                 OnlineRulesetID = 0,
+                Beatmap = CreateAPIBeatmapSet(new OsuRuleset().RulesetInfo).Beatmaps.First(),
                 HasReplay = replayAvailable,
                 User = new User
                 {

From 3db199292fa63d6f105329d2057bc659a492ebac Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Mon, 1 Nov 2021 18:52:57 +0900
Subject: [PATCH 0619/5547] Fix queue mode not passed from room to settings
 overlay

---
 .../QueueingModes/TestSceneFreeForAllQueueMode.cs    | 12 ++++++++++++
 .../Match/MultiplayerMatchSettingsOverlay.cs         |  1 +
 osu.Game/Screens/OnlinePlay/OnlinePlayComposite.cs   |  4 ++++
 3 files changed, 17 insertions(+)
 create mode 100644 osu.Game.Tests/Visual/Multiplayer/QueueingModes/TestSceneFreeForAllQueueMode.cs

diff --git a/osu.Game.Tests/Visual/Multiplayer/QueueingModes/TestSceneFreeForAllQueueMode.cs b/osu.Game.Tests/Visual/Multiplayer/QueueingModes/TestSceneFreeForAllQueueMode.cs
new file mode 100644
index 0000000000..7b03517355
--- /dev/null
+++ b/osu.Game.Tests/Visual/Multiplayer/QueueingModes/TestSceneFreeForAllQueueMode.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 osu.Game.Online.Multiplayer.Queueing;
+
+namespace osu.Game.Tests.Visual.Multiplayer.QueueingModes
+{
+    public class TestSceneFreeForAllQueueMode : QueueModeTestScene
+    {
+        protected override QueueModes Mode => QueueModes.FreeForAll;
+    }
+}
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs
index ab3cbffe2c..3d95960bef 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs
@@ -336,6 +336,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
                 MaxParticipants.BindValueChanged(count => MaxParticipantsField.Text = count.NewValue?.ToString(), true);
                 RoomID.BindValueChanged(roomId => playlistContainer.Alpha = roomId.NewValue == null ? 1 : 0, true);
                 Password.BindValueChanged(password => PasswordTextBox.Text = password.NewValue ?? string.Empty, true);
+                QueueMode.BindValueChanged(mode => QueueModeDropdown.Current.Value = mode.NewValue, true);
 
                 operationInProgress.BindTo(ongoingOperationTracker.InProgress);
                 operationInProgress.BindValueChanged(v =>
diff --git a/osu.Game/Screens/OnlinePlay/OnlinePlayComposite.cs b/osu.Game/Screens/OnlinePlay/OnlinePlayComposite.cs
index aa971864ef..40410538d6 100644
--- a/osu.Game/Screens/OnlinePlay/OnlinePlayComposite.cs
+++ b/osu.Game/Screens/OnlinePlay/OnlinePlayComposite.cs
@@ -6,6 +6,7 @@ using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics.Containers;
+using osu.Game.Online.Multiplayer.Queueing;
 using osu.Game.Online.Rooms;
 using osu.Game.Screens.OnlinePlay.Match;
 using osu.Game.Users;
@@ -65,6 +66,9 @@ namespace osu.Game.Screens.OnlinePlay
         [Resolved(typeof(Room))]
         protected Bindable<TimeSpan?> Duration { get; private set; }
 
+        [Resolved(typeof(Room), nameof(Room.QueueMode))]
+        protected Bindable<QueueModes> QueueMode { get; private set; }
+
         [Resolved(CanBeNull = true)]
         private IBindable<PlaylistItem> subScreenSelectedItem { get; set; }
 

From 1564048d8d77a91e16f81fef6ebb18e06634c069 Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Mon, 1 Nov 2021 18:55:42 +0900
Subject: [PATCH 0620/5547] Add one more test

---
 .../Multiplayer/QueueingModes/TestSceneHostOnlyQueueMode.cs | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/osu.Game.Tests/Visual/Multiplayer/QueueingModes/TestSceneHostOnlyQueueMode.cs b/osu.Game.Tests/Visual/Multiplayer/QueueingModes/TestSceneHostOnlyQueueMode.cs
index 34a490e073..c71a36f1a4 100644
--- a/osu.Game.Tests/Visual/Multiplayer/QueueingModes/TestSceneHostOnlyQueueMode.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/QueueingModes/TestSceneHostOnlyQueueMode.cs
@@ -16,6 +16,12 @@ namespace osu.Game.Tests.Visual.Multiplayer.QueueingModes
     {
         protected override QueueModes Mode => QueueModes.HostOnly;
 
+        [Test]
+        public void TestFirstItemSelectedByDefault()
+        {
+            AddAssert("first item selected", () => Client.CurrentMatchPlayingItem.Value == Client.APIRoom?.Playlist[0]);
+        }
+
         [Test]
         public void TestItemStillSelectedAfterChangeToSameBeatmap()
         {

From 887fa54988717d3550039f5c1a51a692fd3a2197 Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Mon, 1 Nov 2021 19:25:47 +0900
Subject: [PATCH 0621/5547] Add FFA queueing mode tests

---
 .../QueueingModes/QueueModeTestScene.cs       |  2 +
 .../TestSceneFreeForAllQueueMode.cs           | 82 +++++++++++++++++++
 2 files changed, 84 insertions(+)

diff --git a/osu.Game.Tests/Visual/Multiplayer/QueueingModes/QueueModeTestScene.cs b/osu.Game.Tests/Visual/Multiplayer/QueueingModes/QueueModeTestScene.cs
index cea90ff12d..82ad9f3afe 100644
--- a/osu.Game.Tests/Visual/Multiplayer/QueueingModes/QueueModeTestScene.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/QueueingModes/QueueModeTestScene.cs
@@ -104,6 +104,8 @@ namespace osu.Game.Tests.Visual.Multiplayer.QueueingModes
 
         protected void RunGameplay()
         {
+            AddUntilStep("wait for idle", () => Client.LocalUser?.State == MultiplayerUserState.Idle);
+
             AddStep("click ready button", () =>
             {
                 InputManager.MoveMouseTo(this.ChildrenOfType<MultiplayerReadyButton>().Single());
diff --git a/osu.Game.Tests/Visual/Multiplayer/QueueingModes/TestSceneFreeForAllQueueMode.cs b/osu.Game.Tests/Visual/Multiplayer/QueueingModes/TestSceneFreeForAllQueueMode.cs
index 7b03517355..906e528ac5 100644
--- a/osu.Game.Tests/Visual/Multiplayer/QueueingModes/TestSceneFreeForAllQueueMode.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/QueueingModes/TestSceneFreeForAllQueueMode.cs
@@ -1,12 +1,94 @@
 // 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.Testing;
+using osu.Game.Beatmaps;
 using osu.Game.Online.Multiplayer.Queueing;
+using osu.Game.Screens.OnlinePlay.Multiplayer;
+using osuTK.Input;
 
 namespace osu.Game.Tests.Visual.Multiplayer.QueueingModes
 {
     public class TestSceneFreeForAllQueueMode : QueueModeTestScene
     {
         protected override QueueModes Mode => QueueModes.FreeForAll;
+
+        [Test]
+        public void TestFirstItemSelectedByDefault()
+        {
+            AddAssert("first item selected", () => Client.CurrentMatchPlayingItem.Value == Client.APIRoom?.Playlist[0]);
+        }
+
+        [Test]
+        public void TestItemAddedToTheEndOfQueue()
+        {
+            addItem(() => OtherBeatmap);
+            AddAssert("playlist has 2 items", () => Client.APIRoom?.Playlist.Count == 2);
+            AddAssert("last playlist item is different", () => Client.APIRoom?.Playlist[1].Beatmap.Value.OnlineID == OtherBeatmap.OnlineID);
+
+            addItem(() => InitialBeatmap);
+            AddAssert("playlist has 3 items", () => Client.APIRoom?.Playlist.Count == 3);
+            AddAssert("last playlist item is different", () => Client.APIRoom?.Playlist[2].Beatmap.Value.OnlineID == InitialBeatmap.OnlineID);
+
+            AddAssert("first item still selected", () => Client.CurrentMatchPlayingItem.Value == Client.APIRoom?.Playlist[0]);
+        }
+
+        [Test]
+        public void TestSingleItemExpiredAfterGameplay()
+        {
+            RunGameplay();
+
+            AddAssert("playlist has only one item", () => Client.APIRoom?.Playlist.Count == 1);
+            AddAssert("playlist item is expired", () => Client.APIRoom?.Playlist[0].Expired == true);
+            AddAssert("last item selected", () => Client.CurrentMatchPlayingItem.Value == Client.APIRoom?.Playlist[0]);
+        }
+
+        [Test]
+        public void TestNextItemSelectedAfterGameplayFinish()
+        {
+            addItem(() => OtherBeatmap);
+            addItem(() => InitialBeatmap);
+
+            RunGameplay();
+
+            AddAssert("first item expired", () => Client.APIRoom?.Playlist[0].Expired == true);
+            AddAssert("next item selected", () => Client.CurrentMatchPlayingItem.Value == Client.APIRoom?.Playlist[1]);
+
+            RunGameplay();
+
+            AddAssert("second item expired", () => Client.APIRoom?.Playlist[1].Expired == true);
+            AddAssert("next item selected", () => Client.CurrentMatchPlayingItem.Value == Client.APIRoom?.Playlist[2]);
+        }
+
+        [Test]
+        public void TestItemsClearedWhenSwitchToHostOnlyMode()
+        {
+            addItem(() => OtherBeatmap);
+            addItem(() => InitialBeatmap);
+
+            // Move to the "other" beatmap.
+            RunGameplay();
+
+            AddStep("change queue mode", () => Client.ChangeSettings(queueMode: QueueModes.HostOnly));
+            AddAssert("playlist has 1 item", () => Client.APIRoom?.Playlist.Count == 1);
+            AddAssert("playlist item is the same as last selected", () => Client.APIRoom?.Playlist[0].Beatmap.Value.OnlineID == OtherBeatmap.OnlineID);
+            AddAssert("playlist item is not expired", () => Client.APIRoom?.Playlist[0].Expired == false);
+        }
+
+        private void addItem(Func<BeatmapInfo> beatmap)
+        {
+            AddStep("click edit button", () =>
+            {
+                InputManager.MoveMouseTo(this.ChildrenOfType<MultiplayerMatchSubScreen>().Single().AddOrEditPlaylistButton);
+                InputManager.Click(MouseButton.Left);
+            });
+
+            AddUntilStep("wait for song select", () => CurrentSubScreen is Screens.Select.SongSelect select && select.IsLoaded);
+            AddStep("select other beatmap", () => ((Screens.Select.SongSelect)CurrentSubScreen).FinaliseSelection(beatmap()));
+            AddUntilStep("wait for return to match", () => CurrentSubScreen is MultiplayerMatchSubScreen);
+        }
     }
 }

From 793c384ecd29dd07f4c334329fdaf7860cd76879 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 1 Nov 2021 12:02:37 +0100
Subject: [PATCH 0622/5547] Remove unnecessary null-conditional access

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

diff --git a/osu.Game/Overlays/BeatmapSet/BeatmapPicker.cs b/osu.Game/Overlays/BeatmapSet/BeatmapPicker.cs
index c43ac74714..b152375062 100644
--- a/osu.Game/Overlays/BeatmapSet/BeatmapPicker.cs
+++ b/osu.Game/Overlays/BeatmapSet/BeatmapPicker.cs
@@ -166,7 +166,7 @@ namespace osu.Game.Overlays.BeatmapSet
             if (BeatmapSet != null)
             {
                 Difficulties.ChildrenEnumerable = BeatmapSet.Beatmaps
-                                                            .Where(b => b.Ruleset?.OnlineID == ruleset.Value?.OnlineID)
+                                                            .Where(b => b.Ruleset.OnlineID == ruleset.Value?.OnlineID)
                                                             .OrderBy(b => b.StarRating)
                                                             .Select(b => new DifficultySelectorButton(b)
                                                             {

From 0d65493b5689c72480623957754492101680fa41 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 1 Nov 2021 12:12:21 +0100
Subject: [PATCH 0623/5547] Mark test usages of `Ruleset.CreateInstance()` as
 returning non-null

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

diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneAdvancedStats.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneAdvancedStats.cs
index 6a2b577fd3..07e68ef509 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneAdvancedStats.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneAdvancedStats.cs
@@ -5,6 +5,7 @@ using System;
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
+using osu.Framework.Extensions.ObjectExtensions;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
@@ -88,7 +89,7 @@ namespace osu.Game.Tests.Visual.SongSelect
 
             AddStep("select EZ mod", () =>
             {
-                var ruleset = advancedStats.BeatmapInfo.Ruleset.CreateInstance();
+                var ruleset = advancedStats.BeatmapInfo.Ruleset.CreateInstance().AsNonNull();
                 SelectedMods.Value = new[] { ruleset.CreateMod<ModEasy>() };
             });
 
@@ -105,7 +106,7 @@ namespace osu.Game.Tests.Visual.SongSelect
 
             AddStep("select HR mod", () =>
             {
-                var ruleset = advancedStats.BeatmapInfo.Ruleset.CreateInstance();
+                var ruleset = advancedStats.BeatmapInfo.Ruleset.CreateInstance().AsNonNull();
                 SelectedMods.Value = new[] { ruleset.CreateMod<ModHardRock>() };
             });
 
@@ -122,7 +123,7 @@ namespace osu.Game.Tests.Visual.SongSelect
 
             AddStep("select unchanged Difficulty Adjust mod", () =>
             {
-                var ruleset = advancedStats.BeatmapInfo.Ruleset.CreateInstance();
+                var ruleset = advancedStats.BeatmapInfo.Ruleset.CreateInstance().AsNonNull();
                 var difficultyAdjustMod = ruleset.CreateMod<ModDifficultyAdjust>();
                 difficultyAdjustMod.ReadFromDifficulty(advancedStats.BeatmapInfo.Difficulty);
                 SelectedMods.Value = new[] { difficultyAdjustMod };
@@ -141,7 +142,7 @@ namespace osu.Game.Tests.Visual.SongSelect
 
             AddStep("select changed Difficulty Adjust mod", () =>
             {
-                var ruleset = advancedStats.BeatmapInfo.Ruleset.CreateInstance();
+                var ruleset = advancedStats.BeatmapInfo.Ruleset.CreateInstance().AsNonNull();
                 var difficultyAdjustMod = ruleset.CreateMod<OsuModDifficultyAdjust>();
                 var originalDifficulty = advancedStats.BeatmapInfo.Difficulty;
 

From 3a5aed118224ccd57a559026e798774bcbd78dec Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 1 Nov 2021 22:58:55 +0900
Subject: [PATCH 0624/5547] Ensure `APIScoreInfo.Mods` is non-null

---
 osu.Game/Online/API/Requests/Responses/APIScoreInfo.cs | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Online/API/Requests/Responses/APIScoreInfo.cs b/osu.Game/Online/API/Requests/Responses/APIScoreInfo.cs
index 2b7183512d..2e41723f34 100644
--- a/osu.Game/Online/API/Requests/Responses/APIScoreInfo.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIScoreInfo.cs
@@ -4,6 +4,7 @@
 using System;
 using System.Collections.Generic;
 using System.Linq;
+using JetBrains.Annotations;
 using Newtonsoft.Json;
 using Newtonsoft.Json.Converters;
 using osu.Game.Beatmaps;
@@ -67,7 +68,8 @@ namespace osu.Game.Online.API.Requests.Responses
         [JsonProperty(@"mods")]
         private string[] mods { set => Mods = value.Select(acronym => new APIMod { Acronym = acronym }); }
 
-        public IEnumerable<APIMod> Mods { get; set; }
+        [NotNull]
+        public IEnumerable<APIMod> Mods { get; set; } = Array.Empty<APIMod>();
 
         [JsonProperty("rank")]
         [JsonConverter(typeof(StringEnumConverter))]
@@ -85,7 +87,7 @@ namespace osu.Game.Online.API.Requests.Responses
 
             var rulesetInstance = ruleset.CreateInstance();
 
-            var modInstances = Mods != null ? Mods.Select(apiMod => rulesetInstance.CreateModFromAcronym(apiMod.Acronym)).Where(m => m != null).ToArray() : Array.Empty<Mod>();
+            var modInstances = Mods.Select(apiMod => rulesetInstance.CreateModFromAcronym(apiMod.Acronym)).Where(m => m != null).ToArray();
 
             // all API scores provided by this class are considered to be legacy.
             modInstances = modInstances.Append(rulesetInstance.CreateMod<ModClassic>()).ToArray();

From 7747fd5810dfcd53fc0ab02913bd277bea5355e0 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 1 Nov 2021 17:01:54 +0000
Subject: [PATCH 0625/5547] Bump Microsoft.NET.Test.Sdk from 16.11.0 to 17.0.0

Bumps [Microsoft.NET.Test.Sdk](https://github.com/microsoft/vstest) from 16.11.0 to 17.0.0.
- [Release notes](https://github.com/microsoft/vstest/releases)
- [Commits](https://github.com/microsoft/vstest/compare/v16.11.0...v17.0.0)

---
updated-dependencies:
- dependency-name: Microsoft.NET.Test.Sdk
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
---
 .../osu.Game.Rulesets.EmptyFreeform.Tests.csproj                | 2 +-
 .../osu.Game.Rulesets.Pippidon.Tests.csproj                     | 2 +-
 .../osu.Game.Rulesets.EmptyScrolling.Tests.csproj               | 2 +-
 .../osu.Game.Rulesets.Pippidon.Tests.csproj                     | 2 +-
 .../osu.Game.Rulesets.Catch.Tests.csproj                        | 2 +-
 .../osu.Game.Rulesets.Mania.Tests.csproj                        | 2 +-
 osu.Game.Rulesets.Osu.Tests/osu.Game.Rulesets.Osu.Tests.csproj  | 2 +-
 .../osu.Game.Rulesets.Taiko.Tests.csproj                        | 2 +-
 osu.Game.Tests/osu.Game.Tests.csproj                            | 2 +-
 osu.Game.Tournament.Tests/osu.Game.Tournament.Tests.csproj      | 2 +-
 10 files changed, 10 insertions(+), 10 deletions(-)

diff --git a/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform.Tests/osu.Game.Rulesets.EmptyFreeform.Tests.csproj b/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform.Tests/osu.Game.Rulesets.EmptyFreeform.Tests.csproj
index e28053d0ca..e9b92be0c3 100644
--- a/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform.Tests/osu.Game.Rulesets.EmptyFreeform.Tests.csproj
+++ b/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform.Tests/osu.Game.Rulesets.EmptyFreeform.Tests.csproj
@@ -10,7 +10,7 @@
     </PropertyGroup>
   <ItemGroup Label="Package References">
     <PackageReference Include="Appveyor.TestLogger" Version="2.0.0" />
-    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="16.11.0" />
+    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.0.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
     <PackageReference Include="NUnit3TestAdapter" Version="4.0.0" />
     <PackageReference Update="Microsoft.EntityFrameworkCore.Sqlite" Version="2.1.4" />
diff --git a/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon.Tests/osu.Game.Rulesets.Pippidon.Tests.csproj b/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon.Tests/osu.Game.Rulesets.Pippidon.Tests.csproj
index 027bd0b7e2..e145dd7b69 100644
--- a/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon.Tests/osu.Game.Rulesets.Pippidon.Tests.csproj
+++ b/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon.Tests/osu.Game.Rulesets.Pippidon.Tests.csproj
@@ -10,7 +10,7 @@
   </PropertyGroup>
   <ItemGroup Label="Package References">
     <PackageReference Include="Appveyor.TestLogger" Version="2.0.0" />
-    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="16.11.0" />
+    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.0.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
     <PackageReference Include="NUnit3TestAdapter" Version="4.0.0" />
     <PackageReference Update="Microsoft.EntityFrameworkCore.Sqlite" Version="2.1.4" />
diff --git a/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling.Tests/osu.Game.Rulesets.EmptyScrolling.Tests.csproj b/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling.Tests/osu.Game.Rulesets.EmptyScrolling.Tests.csproj
index e2c715d385..a301432a6c 100644
--- a/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling.Tests/osu.Game.Rulesets.EmptyScrolling.Tests.csproj
+++ b/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling.Tests/osu.Game.Rulesets.EmptyScrolling.Tests.csproj
@@ -10,7 +10,7 @@
   </PropertyGroup>
   <ItemGroup Label="Package References">
     <PackageReference Include="Appveyor.TestLogger" Version="2.0.0" />
-    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="16.11.0" />
+    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.0.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
     <PackageReference Include="NUnit3TestAdapter" Version="4.0.0" />
     <PackageReference Update="Microsoft.EntityFrameworkCore.Sqlite" Version="2.1.4" />
diff --git a/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon.Tests/osu.Game.Rulesets.Pippidon.Tests.csproj b/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon.Tests/osu.Game.Rulesets.Pippidon.Tests.csproj
index 027bd0b7e2..e145dd7b69 100644
--- a/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon.Tests/osu.Game.Rulesets.Pippidon.Tests.csproj
+++ b/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon.Tests/osu.Game.Rulesets.Pippidon.Tests.csproj
@@ -10,7 +10,7 @@
   </PropertyGroup>
   <ItemGroup Label="Package References">
     <PackageReference Include="Appveyor.TestLogger" Version="2.0.0" />
-    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="16.11.0" />
+    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.0.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
     <PackageReference Include="NUnit3TestAdapter" Version="4.0.0" />
     <PackageReference Update="Microsoft.EntityFrameworkCore.Sqlite" Version="2.1.4" />
diff --git a/osu.Game.Rulesets.Catch.Tests/osu.Game.Rulesets.Catch.Tests.csproj b/osu.Game.Rulesets.Catch.Tests/osu.Game.Rulesets.Catch.Tests.csproj
index 6457ec92da..4c8b9b2b08 100644
--- a/osu.Game.Rulesets.Catch.Tests/osu.Game.Rulesets.Catch.Tests.csproj
+++ b/osu.Game.Rulesets.Catch.Tests/osu.Game.Rulesets.Catch.Tests.csproj
@@ -2,7 +2,7 @@
   <Import Project="..\osu.TestProject.props" />
   <ItemGroup Label="Package References">
     <PackageReference Include="Appveyor.TestLogger" Version="2.0.0" />
-    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="16.11.0" />
+    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.0.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
     <PackageReference Include="NUnit3TestAdapter" Version="4.0.0" />
     <PackageReference Update="Microsoft.EntityFrameworkCore.Sqlite" Version="2.1.4" />
diff --git a/osu.Game.Rulesets.Mania.Tests/osu.Game.Rulesets.Mania.Tests.csproj b/osu.Game.Rulesets.Mania.Tests/osu.Game.Rulesets.Mania.Tests.csproj
index 674a22df98..fad39ef9d6 100644
--- a/osu.Game.Rulesets.Mania.Tests/osu.Game.Rulesets.Mania.Tests.csproj
+++ b/osu.Game.Rulesets.Mania.Tests/osu.Game.Rulesets.Mania.Tests.csproj
@@ -2,7 +2,7 @@
   <Import Project="..\osu.TestProject.props" />
   <ItemGroup Label="Package References">
     <PackageReference Include="Appveyor.TestLogger" Version="2.0.0" />
-    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="16.11.0" />
+    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.0.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
     <PackageReference Include="NUnit3TestAdapter" Version="4.0.0" />
     <PackageReference Update="Microsoft.EntityFrameworkCore.Sqlite" Version="2.1.4" />
diff --git a/osu.Game.Rulesets.Osu.Tests/osu.Game.Rulesets.Osu.Tests.csproj b/osu.Game.Rulesets.Osu.Tests/osu.Game.Rulesets.Osu.Tests.csproj
index f5f1159542..66f4ad3d3f 100644
--- a/osu.Game.Rulesets.Osu.Tests/osu.Game.Rulesets.Osu.Tests.csproj
+++ b/osu.Game.Rulesets.Osu.Tests/osu.Game.Rulesets.Osu.Tests.csproj
@@ -2,7 +2,7 @@
   <Import Project="..\osu.TestProject.props" />
   <ItemGroup Label="Package References">
     <PackageReference Include="Appveyor.TestLogger" Version="2.0.0" />
-    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="16.11.0" />
+    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.0.0" />
     <PackageReference Include="Moq" Version="4.16.1" />
     <PackageReference Include="NUnit" Version="3.13.2" />
     <PackageReference Include="NUnit3TestAdapter" Version="4.0.0" />
diff --git a/osu.Game.Rulesets.Taiko.Tests/osu.Game.Rulesets.Taiko.Tests.csproj b/osu.Game.Rulesets.Taiko.Tests/osu.Game.Rulesets.Taiko.Tests.csproj
index b9b295767e..568e35c221 100644
--- a/osu.Game.Rulesets.Taiko.Tests/osu.Game.Rulesets.Taiko.Tests.csproj
+++ b/osu.Game.Rulesets.Taiko.Tests/osu.Game.Rulesets.Taiko.Tests.csproj
@@ -2,7 +2,7 @@
   <Import Project="..\osu.TestProject.props" />
   <ItemGroup Label="Package References">
     <PackageReference Include="Appveyor.TestLogger" Version="2.0.0" />
-    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="16.11.0" />
+    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.0.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
     <PackageReference Include="NUnit3TestAdapter" Version="4.0.0" />
     <PackageReference Update="Microsoft.EntityFrameworkCore.Sqlite" Version="2.1.4" />
diff --git a/osu.Game.Tests/osu.Game.Tests.csproj b/osu.Game.Tests/osu.Game.Tests.csproj
index cd56cb51ae..57815d9273 100644
--- a/osu.Game.Tests/osu.Game.Tests.csproj
+++ b/osu.Game.Tests/osu.Game.Tests.csproj
@@ -3,7 +3,7 @@
   <ItemGroup Label="Package References">
     <PackageReference Include="Appveyor.TestLogger" Version="2.0.0" />
     <PackageReference Include="DeepEqual" Version="2.0.0" />
-    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="16.11.0" />
+    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.0.0" />
     <PackageReference Include="Nito.AsyncEx" Version="5.1.2" />
     <PackageReference Include="NUnit" Version="3.13.2" />
     <PackageReference Include="NUnit3TestAdapter" Version="4.0.0" />
diff --git a/osu.Game.Tournament.Tests/osu.Game.Tournament.Tests.csproj b/osu.Game.Tournament.Tests/osu.Game.Tournament.Tests.csproj
index 2673c9ec9f..c0f94d49c7 100644
--- a/osu.Game.Tournament.Tests/osu.Game.Tournament.Tests.csproj
+++ b/osu.Game.Tournament.Tests/osu.Game.Tournament.Tests.csproj
@@ -5,7 +5,7 @@
   </PropertyGroup>
   <ItemGroup Label="Package References">
     <PackageReference Include="Appveyor.TestLogger" Version="2.0.0" />
-    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="16.11.0" />
+    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.0.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
     <PackageReference Include="NUnit3TestAdapter" Version="4.0.0" />
   </ItemGroup>

From f893556b80025d5dfbf24ca5eff94886af549cb6 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 1 Nov 2021 17:02:00 +0000
Subject: [PATCH 0626/5547] Bump
 Microsoft.AspNetCore.SignalR.Protocols.NewtonsoftJson

Bumps [Microsoft.AspNetCore.SignalR.Protocols.NewtonsoftJson](https://github.com/dotnet/aspnetcore) from 5.0.10 to 5.0.11.
- [Release notes](https://github.com/dotnet/aspnetcore/releases)
- [Commits](https://github.com/dotnet/aspnetcore/compare/v5.0.10...v5.0.11)

---
updated-dependencies:
- dependency-name: Microsoft.AspNetCore.SignalR.Protocols.NewtonsoftJson
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
---
 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 8052ab5254..ea85ca5faa 100644
--- a/osu.Game/osu.Game.csproj
+++ b/osu.Game/osu.Game.csproj
@@ -25,7 +25,7 @@
     <PackageReference Include="MessagePack" Version="2.3.85" />
     <PackageReference Include="Microsoft.AspNetCore.SignalR.Client" Version="5.0.10" />
     <PackageReference Include="Microsoft.AspNetCore.SignalR.Protocols.MessagePack" Version="5.0.10" />
-    <PackageReference Include="Microsoft.AspNetCore.SignalR.Protocols.NewtonsoftJson" Version="5.0.10" />
+    <PackageReference Include="Microsoft.AspNetCore.SignalR.Protocols.NewtonsoftJson" Version="5.0.11" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="2.2.6" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.Core" Version="2.2.6" />
     <PackageReference Include="Microsoft.Extensions.Configuration.Abstractions" Version="5.0.0" />

From f8f4b9d3d328bd197709627471f889222754b2bc Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 1 Nov 2021 17:02:04 +0000
Subject: [PATCH 0627/5547] Bump SharpCompress from 0.29.0 to 0.30.0

Bumps [SharpCompress](https://github.com/adamhathcock/sharpcompress) from 0.29.0 to 0.30.0.
- [Release notes](https://github.com/adamhathcock/sharpcompress/releases)
- [Commits](https://github.com/adamhathcock/sharpcompress/compare/0.29...0.30)

---
updated-dependencies:
- dependency-name: SharpCompress
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
---
 osu.Game/osu.Game.csproj | 2 +-
 osu.iOS.props            | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 8052ab5254..49c00d3679 100644
--- a/osu.Game/osu.Game.csproj
+++ b/osu.Game/osu.Game.csproj
@@ -39,7 +39,7 @@
     <PackageReference Include="ppy.osu.Framework" Version="2021.1029.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1026.0" />
     <PackageReference Include="Sentry" Version="3.9.4" />
-    <PackageReference Include="SharpCompress" Version="0.29.0" />
+    <PackageReference Include="SharpCompress" Version="0.30.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
     <PackageReference Include="System.ComponentModel.Annotations" Version="5.0.0" />
     <PackageReference Include="TagLibSharp" Version="2.2.0" />
diff --git a/osu.iOS.props b/osu.iOS.props
index d152cb7066..0baf067a63 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -94,7 +94,7 @@
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.Core" Version="2.2.6" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
     <PackageReference Include="ppy.osu.Framework" Version="2021.1029.0" />
-    <PackageReference Include="SharpCompress" Version="0.28.3" />
+    <PackageReference Include="SharpCompress" Version="0.30.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
     <PackageReference Include="SharpRaven" Version="2.4.0" />
     <PackageReference Include="System.ComponentModel.Annotations" Version="5.0.0" />

From f215439b4f13899ec2938d9f43e489208e6ab4c5 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 1 Nov 2021 17:02:10 +0000
Subject: [PATCH 0628/5547] Bump
 Microsoft.AspNetCore.SignalR.Protocols.MessagePack

Bumps [Microsoft.AspNetCore.SignalR.Protocols.MessagePack](https://github.com/dotnet/aspnetcore) from 5.0.10 to 5.0.11.
- [Release notes](https://github.com/dotnet/aspnetcore/releases)
- [Commits](https://github.com/dotnet/aspnetcore/compare/v5.0.10...v5.0.11)

---
updated-dependencies:
- dependency-name: Microsoft.AspNetCore.SignalR.Protocols.MessagePack
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
---
 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 8052ab5254..4bfcc9ed09 100644
--- a/osu.Game/osu.Game.csproj
+++ b/osu.Game/osu.Game.csproj
@@ -24,7 +24,7 @@
     <PackageReference Include="Humanizer" Version="2.11.10" />
     <PackageReference Include="MessagePack" Version="2.3.85" />
     <PackageReference Include="Microsoft.AspNetCore.SignalR.Client" Version="5.0.10" />
-    <PackageReference Include="Microsoft.AspNetCore.SignalR.Protocols.MessagePack" Version="5.0.10" />
+    <PackageReference Include="Microsoft.AspNetCore.SignalR.Protocols.MessagePack" Version="5.0.11" />
     <PackageReference Include="Microsoft.AspNetCore.SignalR.Protocols.NewtonsoftJson" Version="5.0.10" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="2.2.6" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.Core" Version="2.2.6" />

From e0a940be1de453997f2ff8a60c40ea79a3049791 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 1 Nov 2021 17:02:14 +0000
Subject: [PATCH 0629/5547] Bump Sentry from 3.9.4 to 3.10.0

Bumps [Sentry](https://github.com/getsentry/sentry-dotnet) from 3.9.4 to 3.10.0.
- [Release notes](https://github.com/getsentry/sentry-dotnet/releases)
- [Changelog](https://github.com/getsentry/sentry-dotnet/blob/main/CHANGELOG.md)
- [Commits](https://github.com/getsentry/sentry-dotnet/compare/3.9.4...3.10.0)

---
updated-dependencies:
- dependency-name: Sentry
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
---
 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 8052ab5254..b6100e4c73 100644
--- a/osu.Game/osu.Game.csproj
+++ b/osu.Game/osu.Game.csproj
@@ -38,7 +38,7 @@
     <PackageReference Include="Realm" Version="10.6.0" />
     <PackageReference Include="ppy.osu.Framework" Version="2021.1029.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1026.0" />
-    <PackageReference Include="Sentry" Version="3.9.4" />
+    <PackageReference Include="Sentry" Version="3.10.0" />
     <PackageReference Include="SharpCompress" Version="0.29.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
     <PackageReference Include="System.ComponentModel.Annotations" Version="5.0.0" />

From 3b7379b777345bad676d4d477d1ffa111f607edb Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 1 Nov 2021 17:02:20 +0000
Subject: [PATCH 0630/5547] Bump Microsoft.AspNetCore.SignalR.Client from
 5.0.10 to 5.0.11

Bumps [Microsoft.AspNetCore.SignalR.Client](https://github.com/dotnet/aspnetcore) from 5.0.10 to 5.0.11.
- [Release notes](https://github.com/dotnet/aspnetcore/releases)
- [Commits](https://github.com/dotnet/aspnetcore/compare/v5.0.10...v5.0.11)

---
updated-dependencies:
- dependency-name: Microsoft.AspNetCore.SignalR.Client
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
---
 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 8052ab5254..650498bc5f 100644
--- a/osu.Game/osu.Game.csproj
+++ b/osu.Game/osu.Game.csproj
@@ -23,7 +23,7 @@
     <PackageReference Include="HtmlAgilityPack" Version="1.11.37" />
     <PackageReference Include="Humanizer" Version="2.11.10" />
     <PackageReference Include="MessagePack" Version="2.3.85" />
-    <PackageReference Include="Microsoft.AspNetCore.SignalR.Client" Version="5.0.10" />
+    <PackageReference Include="Microsoft.AspNetCore.SignalR.Client" Version="5.0.11" />
     <PackageReference Include="Microsoft.AspNetCore.SignalR.Protocols.MessagePack" Version="5.0.10" />
     <PackageReference Include="Microsoft.AspNetCore.SignalR.Protocols.NewtonsoftJson" Version="5.0.10" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="2.2.6" />

From 6e17f92f5583a4713683b0d3308bb6066d40aba1 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 1 Nov 2021 17:02:23 +0000
Subject: [PATCH 0631/5547] Bump Microsoft.CodeAnalysis.BannedApiAnalyzers from
 3.3.2 to 3.3.3

Bumps [Microsoft.CodeAnalysis.BannedApiAnalyzers](https://github.com/dotnet/roslyn-analyzers) from 3.3.2 to 3.3.3.
- [Release notes](https://github.com/dotnet/roslyn-analyzers/releases)
- [Changelog](https://github.com/dotnet/roslyn-analyzers/blob/main/PostReleaseActivities.md)
- [Commits](https://github.com/dotnet/roslyn-analyzers/commits)

---
updated-dependencies:
- dependency-name: Microsoft.CodeAnalysis.BannedApiAnalyzers
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
---
 Directory.Build.props | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Directory.Build.props b/Directory.Build.props
index 53ad973e47..894ea25c8b 100644
--- a/Directory.Build.props
+++ b/Directory.Build.props
@@ -16,7 +16,7 @@
     <EmbeddedResource Include="Resources\**\*.*" />
   </ItemGroup>
   <ItemGroup Label="Code Analysis">
-    <PackageReference Include="Microsoft.CodeAnalysis.BannedApiAnalyzers" Version="3.3.2" PrivateAssets="All" />
+    <PackageReference Include="Microsoft.CodeAnalysis.BannedApiAnalyzers" Version="3.3.3" PrivateAssets="All" />
     <AdditionalFiles Include="$(MSBuildThisFileDirectory)CodeAnalysis\BannedSymbols.txt" />
     <PackageReference Include="Microsoft.CodeAnalysis.NetAnalyzers" Version="5.0.3" PrivateAssets="All" />
   </ItemGroup>

From d82564aab66aee6d9c97138d1805f9a1a878396b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 17 Oct 2021 17:00:54 +0200
Subject: [PATCH 0632/5547] Add test scene for beatmap cards

---
 .../Visual/Beatmaps/TestSceneBeatmapCard.cs   | 162 ++++++++++++++++++
 1 file changed, 162 insertions(+)
 create mode 100644 osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs

diff --git a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs
new file mode 100644
index 0000000000..d267ad929d
--- /dev/null
+++ b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs
@@ -0,0 +1,162 @@
+// 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.Graphics;
+using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.Shapes;
+using osu.Game.Beatmaps;
+using osu.Game.Online.API.Requests.Responses;
+using osu.Game.Overlays;
+using osu.Game.Users;
+using osuTK;
+
+namespace osu.Game.Tests.Visual.Beatmaps
+{
+    public class TestSceneBeatmapCard : OsuTestScene
+    {
+        private IBeatmapSetInfo[] testCases;
+
+        #region Test case generation
+
+        [BackgroundDependencyLoader]
+        private void load()
+        {
+            var normal = CreateAPIBeatmapSet(Ruleset.Value);
+            normal.HasVideo = true;
+            normal.HasStoryboard = true;
+
+            var undownloadable = getUndownloadableBeatmapSet();
+            var manyDifficulties = getManyDifficultiesBeatmapSet();
+
+            var explicitMap = CreateAPIBeatmapSet(Ruleset.Value);
+            explicitMap.HasExplicitContent = true;
+
+            var featuredMap = CreateAPIBeatmapSet(Ruleset.Value);
+            featuredMap.TrackId = 1;
+
+            var explicitFeaturedMap = CreateAPIBeatmapSet(Ruleset.Value);
+            explicitFeaturedMap.HasExplicitContent = true;
+            explicitFeaturedMap.TrackId = 2;
+
+            testCases = new IBeatmapSetInfo[]
+            {
+                normal,
+                undownloadable,
+                manyDifficulties,
+                explicitMap,
+                featuredMap,
+                explicitFeaturedMap
+            };
+        }
+
+        private APIBeatmapSet getUndownloadableBeatmapSet() => new APIBeatmapSet
+        {
+            OnlineID = 123,
+            Title = "undownloadable beatmap",
+            Artist = "test",
+            Source = "more tests",
+            Author = new User
+            {
+                Username = "BanchoBot",
+                Id = 3,
+            },
+            Availability = new BeatmapSetOnlineAvailability
+            {
+                DownloadDisabled = true,
+            },
+            Preview = @"https://b.ppy.sh/preview/12345.mp3",
+            PlayCount = 123,
+            FavouriteCount = 456,
+            BPM = 111,
+            HasVideo = true,
+            HasStoryboard = true,
+            Covers = new BeatmapSetOnlineCovers(),
+            Beatmaps = new List<APIBeatmap>
+            {
+                new APIBeatmap
+                {
+                    RulesetID = Ruleset.Value.OnlineID,
+                    DifficultyName = "Test",
+                    StarRating = 6.42,
+                }
+            }
+        };
+
+        private static APIBeatmapSet getManyDifficultiesBeatmapSet()
+        {
+            var beatmaps = new List<APIBeatmap>();
+
+            for (int i = 0; i < 100; i++)
+            {
+                beatmaps.Add(new APIBeatmap
+                {
+                    RulesetID = i % 4,
+                    StarRating = 2 + i % 4 * 2,
+                });
+            }
+
+            return new APIBeatmapSet
+            {
+                OnlineID = 1,
+                Title = "many difficulties beatmap",
+                Artist = "test",
+                Author = new User
+                {
+                    Username = "BanchoBot",
+                    Id = 3,
+                },
+                HasVideo = true,
+                HasStoryboard = true,
+                Covers = new BeatmapSetOnlineCovers(),
+                Beatmaps = beatmaps,
+            };
+        }
+
+        #endregion
+
+        private Drawable createContent(OverlayColourScheme colourScheme, Func<IBeatmapSetInfo, Drawable> creationFunc)
+        {
+            var colourProvider = new OverlayColourProvider(colourScheme);
+
+            return new DependencyProvidingContainer
+            {
+                RelativeSizeAxes = Axes.Both,
+                CachedDependencies = new (Type, object)[]
+                {
+                    (typeof(OverlayColourProvider), colourProvider)
+                },
+                Children = new Drawable[]
+                {
+                    new Box
+                    {
+                        RelativeSizeAxes = Axes.Both,
+                        Colour = colourProvider.Background5
+                    },
+                    new BasicScrollContainer
+                    {
+                        RelativeSizeAxes = Axes.Both,
+                        Child = new FillFlowContainer
+                        {
+                            RelativeSizeAxes = Axes.X,
+                            AutoSizeAxes = Axes.Y,
+                            Direction = FillDirection.Full,
+                            Padding = new MarginPadding(10),
+                            Spacing = new Vector2(10),
+                            ChildrenEnumerable = testCases.Select(creationFunc)
+                        }
+                    }
+                }
+            };
+        }
+
+        private void createTestCase(Func<IBeatmapSetInfo, Drawable> creationFunc)
+        {
+            foreach (var scheme in Enum.GetValues(typeof(OverlayColourScheme)).Cast<OverlayColourScheme>())
+                AddStep($"set {scheme} scheme", () => Child = createContent(scheme, creationFunc));
+        }
+    }
+}

From 5962f16b1ca71d99f264a8755f4484bc117fd14d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 17 Oct 2021 18:24:17 +0200
Subject: [PATCH 0633/5547] Implement basic card appearance

---
 .../Visual/Beatmaps/TestSceneBeatmapCard.cs   |  35 ++-
 .../Beatmaps/Drawables/Cards/BeatmapCard.cs   | 248 ++++++++++++++++++
 2 files changed, 275 insertions(+), 8 deletions(-)
 create mode 100644 osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs

diff --git a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs
index d267ad929d..d1b21547dc 100644
--- a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs
+++ b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs
@@ -4,11 +4,13 @@
 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.Framework.Graphics.Shapes;
 using osu.Game.Beatmaps;
+using osu.Game.Beatmaps.Drawables.Cards;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays;
 using osu.Game.Users;
@@ -18,7 +20,7 @@ namespace osu.Game.Tests.Visual.Beatmaps
 {
     public class TestSceneBeatmapCard : OsuTestScene
     {
-        private IBeatmapSetInfo[] testCases;
+        private APIBeatmapSet[] testCases;
 
         #region Test case generation
 
@@ -30,7 +32,13 @@ namespace osu.Game.Tests.Visual.Beatmaps
             normal.HasStoryboard = true;
 
             var undownloadable = getUndownloadableBeatmapSet();
-            var manyDifficulties = getManyDifficultiesBeatmapSet();
+
+            var someDifficulties = getManyDifficultiesBeatmapSet(11);
+            someDifficulties.Title = someDifficulties.TitleUnicode = "some difficulties";
+            someDifficulties.Status = BeatmapSetOnlineStatus.Qualified;
+
+            var manyDifficulties = getManyDifficultiesBeatmapSet(100);
+            manyDifficulties.Status = BeatmapSetOnlineStatus.Pending;
 
             var explicitMap = CreateAPIBeatmapSet(Ruleset.Value);
             explicitMap.HasExplicitContent = true;
@@ -42,14 +50,22 @@ namespace osu.Game.Tests.Visual.Beatmaps
             explicitFeaturedMap.HasExplicitContent = true;
             explicitFeaturedMap.TrackId = 2;
 
-            testCases = new IBeatmapSetInfo[]
+            var longName = CreateAPIBeatmapSet(Ruleset.Value);
+            longName.Title = longName.TitleUnicode = "this track has an incredibly and implausibly long title";
+            longName.Artist = longName.ArtistUnicode = "and this artist! who would have thunk it. it's really such a long name.";
+            longName.HasExplicitContent = true;
+            longName.TrackId = 444;
+
+            testCases = new[]
             {
                 normal,
                 undownloadable,
+                someDifficulties,
                 manyDifficulties,
                 explicitMap,
                 featuredMap,
-                explicitFeaturedMap
+                explicitFeaturedMap,
+                longName
             };
         }
 
@@ -86,11 +102,11 @@ namespace osu.Game.Tests.Visual.Beatmaps
             }
         };
 
-        private static APIBeatmapSet getManyDifficultiesBeatmapSet()
+        private static APIBeatmapSet getManyDifficultiesBeatmapSet(int count)
         {
             var beatmaps = new List<APIBeatmap>();
 
-            for (int i = 0; i < 100; i++)
+            for (int i = 0; i < count; i++)
             {
                 beatmaps.Add(new APIBeatmap
                 {
@@ -118,7 +134,7 @@ namespace osu.Game.Tests.Visual.Beatmaps
 
         #endregion
 
-        private Drawable createContent(OverlayColourScheme colourScheme, Func<IBeatmapSetInfo, Drawable> creationFunc)
+        private Drawable createContent(OverlayColourScheme colourScheme, Func<APIBeatmapSet, Drawable> creationFunc)
         {
             var colourProvider = new OverlayColourProvider(colourScheme);
 
@@ -153,10 +169,13 @@ namespace osu.Game.Tests.Visual.Beatmaps
             };
         }
 
-        private void createTestCase(Func<IBeatmapSetInfo, Drawable> creationFunc)
+        private void createTestCase(Func<APIBeatmapSet, Drawable> creationFunc)
         {
             foreach (var scheme in Enum.GetValues(typeof(OverlayColourScheme)).Cast<OverlayColourScheme>())
                 AddStep($"set {scheme} scheme", () => Child = createContent(scheme, creationFunc));
         }
+
+        [Test]
+        public void TestNormal() => createTestCase(beatmapSetInfo => new BeatmapCard(beatmapSetInfo));
     }
 }
diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
new file mode 100644
index 0000000000..38098899b0
--- /dev/null
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
@@ -0,0 +1,248 @@
+// 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.Extensions.Color4Extensions;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Colour;
+using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.Shapes;
+using osu.Framework.Graphics.Sprites;
+using osu.Framework.Localisation;
+using osu.Game.Graphics;
+using osu.Game.Graphics.Containers;
+using osu.Game.Graphics.Sprites;
+using osu.Game.Graphics.UserInterface;
+using osu.Game.Online.API.Requests.Responses;
+using osu.Game.Overlays;
+using osu.Game.Overlays.BeatmapSet;
+using osuTK;
+using osu.Game.Overlays.BeatmapListing.Panels;
+using osu.Game.Resources.Localisation.Web;
+
+namespace osu.Game.Beatmaps.Drawables.Cards
+{
+    public class BeatmapCard : OsuClickableContainer
+    {
+        private const float width = 408;
+        private const float height = 100;
+        private const float corner_radius = 10;
+
+        private readonly APIBeatmapSet beatmapSet;
+        private FillFlowContainer iconArea;
+        private GridContainer titleContainer;
+        private GridContainer artistContainer;
+
+        [Resolved]
+        private OverlayColourProvider colourProvider { get; set; }
+
+        public BeatmapCard(APIBeatmapSet beatmapSet)
+            : base(HoverSampleSet.Submit)
+        {
+            this.beatmapSet = beatmapSet;
+        }
+
+        [BackgroundDependencyLoader]
+        private void load()
+        {
+            Width = width;
+            Height = height;
+            CornerRadius = corner_radius;
+            Masking = true;
+
+            InternalChildren = new Drawable[]
+            {
+                new Box
+                {
+                    RelativeSizeAxes = Axes.Both,
+                    Colour = colourProvider.Background3
+                },
+                new Container
+                {
+                    Name = @"Left (icon) area",
+                    Size = new Vector2(height),
+                    Children = new Drawable[]
+                    {
+                        new UpdateableOnlineBeatmapSetCover(BeatmapSetCoverType.List)
+                        {
+                            RelativeSizeAxes = Axes.Both,
+                            OnlineInfo = beatmapSet
+                        },
+                        iconArea = new FillFlowContainer
+                        {
+                            Margin = new MarginPadding(5),
+                            AutoSizeAxes = Axes.Both,
+                            Direction = FillDirection.Horizontal,
+                            Spacing = new Vector2(1)
+                        }
+                    }
+                },
+                new Container
+                {
+                    Name = @"Main content",
+                    X = height - corner_radius,
+                    Width = width - height,
+                    Height = height,
+                    CornerRadius = corner_radius,
+                    Masking = true,
+                    Children = new Drawable[]
+                    {
+                        new UpdateableOnlineBeatmapSetCover
+                        {
+                            RelativeSizeAxes = Axes.Both,
+                            OnlineInfo = beatmapSet,
+                        },
+                        new Box
+                        {
+                            RelativeSizeAxes = Axes.Both,
+                            Colour = ColourInfo.GradientHorizontal(colourProvider.Background2, colourProvider.Background2.Opacity(0.8f)),
+                        },
+                        new FillFlowContainer
+                        {
+                            RelativeSizeAxes = Axes.Both,
+                            Padding = new MarginPadding
+                            {
+                                Horizontal = 10,
+                                Vertical = 4
+                            },
+                            Direction = FillDirection.Vertical,
+                            Children = new Drawable[]
+                            {
+                                titleContainer = new GridContainer
+                                {
+                                    RelativeSizeAxes = Axes.X,
+                                    AutoSizeAxes = Axes.Y,
+                                    ColumnDimensions = new[]
+                                    {
+                                        new Dimension(),
+                                        new Dimension(GridSizeMode.AutoSize)
+                                    },
+                                    RowDimensions = new[]
+                                    {
+                                        new Dimension(GridSizeMode.AutoSize)
+                                    },
+                                    Content = new[]
+                                    {
+                                        new[]
+                                        {
+                                            new OsuSpriteText
+                                            {
+                                                Text = new RomanisableString(beatmapSet.TitleUnicode, beatmapSet.Title),
+                                                Font = OsuFont.Default.With(size: 22.5f, weight: FontWeight.SemiBold),
+                                                RelativeSizeAxes = Axes.X,
+                                                Truncate = true
+                                            },
+                                            Empty()
+                                        }
+                                    }
+                                },
+                                artistContainer = new GridContainer
+                                {
+                                    RelativeSizeAxes = Axes.X,
+                                    AutoSizeAxes = Axes.Y,
+                                    ColumnDimensions = new[]
+                                    {
+                                        new Dimension(),
+                                        new Dimension(GridSizeMode.AutoSize)
+                                    },
+                                    RowDimensions = new[]
+                                    {
+                                        new Dimension(GridSizeMode.AutoSize)
+                                    },
+                                    Content = new[]
+                                    {
+                                        new[]
+                                        {
+                                            new OsuSpriteText
+                                            {
+                                                Text = createArtistText(),
+                                                Font = OsuFont.Default.With(size: 17.5f, weight: FontWeight.SemiBold),
+                                                RelativeSizeAxes = Axes.X,
+                                                Truncate = true
+                                            },
+                                            Empty()
+                                        },
+                                    }
+                                },
+                                new LinkFlowContainer(s =>
+                                {
+                                    s.Shadow = false;
+                                    s.Font = OsuFont.GetFont(size: 14, weight: FontWeight.SemiBold);
+                                }).With(d =>
+                                {
+                                    d.AutoSizeAxes = Axes.Both;
+                                    d.Margin = new MarginPadding { Top = 2 };
+                                    d.AddText("mapped by ", t => t.Colour = colourProvider.Content2);
+                                    d.AddUserLink(beatmapSet.Author);
+                                }),
+                            }
+                        },
+                        new FillFlowContainer
+                        {
+                            Name = @"Bottom content",
+                            RelativeSizeAxes = Axes.X,
+                            AutoSizeAxes = Axes.Y,
+                            Direction = FillDirection.Horizontal,
+                            Padding = new MarginPadding
+                            {
+                                Horizontal = 10,
+                                Vertical = 4
+                            },
+                            Spacing = new Vector2(4, 0),
+                            Anchor = Anchor.BottomLeft,
+                            Origin = Anchor.BottomLeft,
+                            Children = new Drawable[]
+                            {
+                                new BeatmapSetOnlineStatusPill
+                                {
+                                    AutoSizeAxes = Axes.Both,
+                                    Status = beatmapSet.Status,
+                                    Anchor = Anchor.CentreLeft,
+                                    Origin = Anchor.CentreLeft
+                                },
+                                new DifficultySpectrumDisplay(beatmapSet)
+                                {
+                                    Anchor = Anchor.CentreLeft,
+                                    Origin = Anchor.CentreLeft,
+                                    DotSize = new Vector2(6, 12)
+                                }
+                            }
+                        }
+                    }
+                }
+            };
+
+            if (beatmapSet.HasVideo)
+                iconArea.Add(new IconPill(FontAwesome.Solid.Film));
+
+            if (beatmapSet.HasStoryboard)
+                iconArea.Add(new IconPill(FontAwesome.Solid.Image));
+
+            if (beatmapSet.HasExplicitContent)
+            {
+                titleContainer.Content[0][1] = new ExplicitContentBeatmapPill
+                {
+                    Anchor = Anchor.BottomRight,
+                    Origin = Anchor.BottomRight,
+                    Margin = new MarginPadding { Left = 5 }
+                };
+            }
+
+            if (beatmapSet.TrackId != null)
+            {
+                artistContainer.Content[0][1] = new FeaturedArtistBeatmapPill
+                {
+                    Anchor = Anchor.BottomRight,
+                    Origin = Anchor.BottomRight,
+                    Margin = new MarginPadding { Left = 5 }
+                };
+            }
+        }
+
+        private LocalisableString createArtistText()
+        {
+            var romanisableArtist = new RomanisableString(beatmapSet.ArtistUnicode, beatmapSet.Artist);
+            return BeatmapsetsStrings.ShowDetailsByArtist(romanisableArtist);
+        }
+    }
+}

From a59f2d7b835804cb0d66aeacd0a9e8a5031bdcf8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 17 Oct 2021 18:59:31 +0200
Subject: [PATCH 0634/5547] Implement basic hover card state

---
 .../Beatmaps/Drawables/Cards/BeatmapCard.cs   | 52 +++++++++++++++++--
 1 file changed, 47 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
index 38098899b0..516ffa5628 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
@@ -8,6 +8,7 @@ using osu.Framework.Graphics.Colour;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Graphics.Sprites;
+using osu.Framework.Input.Events;
 using osu.Framework.Localisation;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
@@ -19,6 +20,7 @@ using osu.Game.Overlays.BeatmapSet;
 using osuTK;
 using osu.Game.Overlays.BeatmapListing.Panels;
 using osu.Game.Resources.Localisation.Web;
+using osuTK.Graphics;
 
 namespace osu.Game.Beatmaps.Drawables.Cards
 {
@@ -28,8 +30,16 @@ namespace osu.Game.Beatmaps.Drawables.Cards
         private const float height = 100;
         private const float corner_radius = 10;
 
+        private const float transition_duration = 400;
+
         private readonly APIBeatmapSet beatmapSet;
+
+        private UpdateableOnlineBeatmapSetCover leftCover;
         private FillFlowContainer iconArea;
+
+        private Container mainContent;
+        private Box foregroundGradient;
+
         private GridContainer titleContainer;
         private GridContainer artistContainer;
 
@@ -63,7 +73,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                     Size = new Vector2(height),
                     Children = new Drawable[]
                     {
-                        new UpdateableOnlineBeatmapSetCover(BeatmapSetCoverType.List)
+                        leftCover = new UpdateableOnlineBeatmapSetCover(BeatmapSetCoverType.List)
                         {
                             RelativeSizeAxes = Axes.Both,
                             OnlineInfo = beatmapSet
@@ -77,11 +87,10 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                         }
                     }
                 },
-                new Container
+                mainContent = new Container
                 {
                     Name = @"Main content",
                     X = height - corner_radius,
-                    Width = width - height,
                     Height = height,
                     CornerRadius = corner_radius,
                     Masking = true,
@@ -92,10 +101,9 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                             RelativeSizeAxes = Axes.Both,
                             OnlineInfo = beatmapSet,
                         },
-                        new Box
+                        foregroundGradient = new Box
                         {
                             RelativeSizeAxes = Axes.Both,
-                            Colour = ColourInfo.GradientHorizontal(colourProvider.Background2, colourProvider.Background2.Opacity(0.8f)),
                         },
                         new FillFlowContainer
                         {
@@ -239,10 +247,44 @@ namespace osu.Game.Beatmaps.Drawables.Cards
             }
         }
 
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+            updateState();
+            FinishTransforms(true);
+        }
+
         private LocalisableString createArtistText()
         {
             var romanisableArtist = new RomanisableString(beatmapSet.ArtistUnicode, beatmapSet.Artist);
             return BeatmapsetsStrings.ShowDetailsByArtist(romanisableArtist);
         }
+
+        protected override bool OnHover(HoverEvent e)
+        {
+            updateState();
+            return base.OnHover(e);
+        }
+
+        protected override void OnHoverLost(HoverLostEvent e)
+        {
+            updateState();
+            base.OnHoverLost(e);
+        }
+
+        private void updateState()
+        {
+            float targetWidth = width - height;
+            if (IsHovered)
+                targetWidth -= 20;
+
+            mainContent.ResizeWidthTo(targetWidth, transition_duration, Easing.OutQuint);
+
+            var foregroundColour = IsHovered ? colourProvider.Background4 : colourProvider.Background2;
+            var foregroundGradientColour = ColourInfo.GradientHorizontal(foregroundColour, foregroundColour.Opacity(0.8f));
+            foregroundGradient.FadeColour(foregroundGradientColour, transition_duration, Easing.OutQuint);
+
+            leftCover.FadeColour(IsHovered ? OsuColour.Gray(0.2f) : Color4.White, transition_duration, Easing.OutQuint);
+        }
     }
 }

From f671ee28c542b7fbddc558dcf69590b79a85bc09 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 22 Oct 2021 22:03:37 +0200
Subject: [PATCH 0635/5547] Use buffered container to eliminate gaps near
 foreground border

---
 .../Beatmaps/Drawables/Cards/BeatmapCard.cs   |  25 ++--
 .../Cards/BeatmapCardContentBackground.cs     | 125 ++++++++++++++++++
 2 files changed, 133 insertions(+), 17 deletions(-)
 create mode 100644 osu.Game/Beatmaps/Drawables/Cards/BeatmapCardContentBackground.cs

diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
index 516ffa5628..b1fe381410 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
@@ -2,9 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using osu.Framework.Allocation;
-using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
-using osu.Framework.Graphics.Colour;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Graphics.Sprites;
@@ -26,19 +24,19 @@ namespace osu.Game.Beatmaps.Drawables.Cards
 {
     public class BeatmapCard : OsuClickableContainer
     {
+        public const float TRANSITION_DURATION = 400;
+
         private const float width = 408;
         private const float height = 100;
         private const float corner_radius = 10;
 
-        private const float transition_duration = 400;
-
         private readonly APIBeatmapSet beatmapSet;
 
         private UpdateableOnlineBeatmapSetCover leftCover;
         private FillFlowContainer iconArea;
 
         private Container mainContent;
-        private Box foregroundGradient;
+        private BeatmapCardContentBackground mainContentBackground;
 
         private GridContainer titleContainer;
         private GridContainer artistContainer;
@@ -96,14 +94,10 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                     Masking = true,
                     Children = new Drawable[]
                     {
-                        new UpdateableOnlineBeatmapSetCover
-                        {
-                            RelativeSizeAxes = Axes.Both,
-                            OnlineInfo = beatmapSet,
-                        },
-                        foregroundGradient = new Box
+                        mainContentBackground = new BeatmapCardContentBackground
                         {
                             RelativeSizeAxes = Axes.Both,
+                            BeatmapSet = beatmapSet,
                         },
                         new FillFlowContainer
                         {
@@ -278,13 +272,10 @@ namespace osu.Game.Beatmaps.Drawables.Cards
             if (IsHovered)
                 targetWidth -= 20;
 
-            mainContent.ResizeWidthTo(targetWidth, transition_duration, Easing.OutQuint);
+            mainContent.ResizeWidthTo(targetWidth, TRANSITION_DURATION, Easing.OutQuint);
+            mainContentBackground.Dimmed.Value = IsHovered;
 
-            var foregroundColour = IsHovered ? colourProvider.Background4 : colourProvider.Background2;
-            var foregroundGradientColour = ColourInfo.GradientHorizontal(foregroundColour, foregroundColour.Opacity(0.8f));
-            foregroundGradient.FadeColour(foregroundGradientColour, transition_duration, Easing.OutQuint);
-
-            leftCover.FadeColour(IsHovered ? OsuColour.Gray(0.2f) : Color4.White, transition_duration, Easing.OutQuint);
+            leftCover.FadeColour(IsHovered ? OsuColour.Gray(0.2f) : Color4.White, TRANSITION_DURATION, Easing.OutQuint);
         }
     }
 }
diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardContentBackground.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardContentBackground.cs
new file mode 100644
index 0000000000..88c9d771ac
--- /dev/null
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardContentBackground.cs
@@ -0,0 +1,125 @@
+// 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 enable
+
+using System;
+using osu.Framework.Allocation;
+using osu.Framework.Bindables;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Colour;
+using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.Shapes;
+using osu.Game.Overlays;
+
+namespace osu.Game.Beatmaps.Drawables.Cards
+{
+    public class BeatmapCardContentBackground : ModelBackedDrawable<IBeatmapSetOnlineInfo>
+    {
+        public IBeatmapSetOnlineInfo BeatmapSet
+        {
+            get => Model;
+            set => Model = value;
+        }
+
+        public new bool Masking
+        {
+            get => base.Masking;
+            set => base.Masking = value;
+        }
+
+        public BindableBool Dimmed { get; private set; } = new BindableBool();
+
+        protected override double LoadDelay => 500;
+
+        protected override double TransformDuration => 400;
+
+        [BackgroundDependencyLoader]
+        private void load(OverlayColourProvider colourProvider)
+        {
+            InternalChild = new Box
+            {
+                RelativeSizeAxes = Axes.Both,
+                Colour = colourProvider.Background2
+            };
+        }
+
+        protected override DelayedLoadWrapper CreateDelayedLoadWrapper(Func<Drawable> createContentFunc, double timeBeforeLoad)
+            => new DelayedLoadUnloadWrapper(createContentFunc, timeBeforeLoad);
+
+        protected override Drawable? CreateDrawable(IBeatmapSetOnlineInfo? model)
+        {
+            if (model == null)
+                return null;
+
+            return new BufferedBackground(model)
+            {
+                RelativeSizeAxes = Axes.Both,
+                Dimmed = { BindTarget = Dimmed }
+            };
+        }
+
+        private class BufferedBackground : BufferedContainer
+        {
+            public BindableBool Dimmed { get; } = new BindableBool();
+
+            private readonly IBeatmapSetOnlineInfo onlineInfo;
+
+            private readonly Box background;
+            private OnlineBeatmapSetCover? cover;
+
+            [Resolved]
+            private OverlayColourProvider colourProvider { get; set; } = null!;
+
+            public BufferedBackground(IBeatmapSetOnlineInfo onlineInfo)
+            {
+                this.onlineInfo = onlineInfo;
+
+                RelativeSizeAxes = Axes.Both;
+                InternalChild = background = new Box
+                {
+                    RelativeSizeAxes = Axes.Both,
+                };
+            }
+
+            [BackgroundDependencyLoader]
+            private void load()
+            {
+                background.Colour = colourProvider.Background2;
+
+                LoadComponentAsync(new OnlineBeatmapSetCover(onlineInfo)
+                {
+                    RelativeSizeAxes = Axes.Both,
+                    Anchor = Anchor.Centre,
+                    Origin = Anchor.Centre,
+                    FillMode = FillMode.Fill
+                }, loaded =>
+                {
+                    cover = loaded;
+                    cover.Colour = Colour4.Transparent;
+                    AddInternal(cover);
+                    FinishTransforms(true);
+                    updateState();
+                });
+            }
+
+            protected override void LoadComplete()
+            {
+                base.LoadComplete();
+                Dimmed.BindValueChanged(_ => updateState(), true);
+                FinishTransforms(true);
+            }
+
+            private void updateState()
+            {
+                if (cover == null)
+                    return;
+
+                background.FadeColour(Dimmed.Value ? colourProvider.Background4 : colourProvider.Background2, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
+
+                var gradient = ColourInfo.GradientHorizontal(Colour4.White.Opacity(0), Colour4.White.Opacity(0.2f));
+                cover.FadeColour(gradient, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
+            }
+        }
+    }
+}

From badbbace101ae4fe19bbd6d96e85345e2756a434 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Tue, 2 Nov 2021 04:51:54 +0300
Subject: [PATCH 0636/5547] Add android intent filter for osu! replays

---
 osu.Android/OsuGameActivity.cs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Android/OsuGameActivity.cs b/osu.Android/OsuGameActivity.cs
index 0bcbfc4baf..fec96c9165 100644
--- a/osu.Android/OsuGameActivity.cs
+++ b/osu.Android/OsuGameActivity.cs
@@ -20,6 +20,7 @@ namespace osu.Android
     [Activity(Theme = "@android:style/Theme.NoTitleBar", MainLauncher = true, ScreenOrientation = ScreenOrientation.FullUser, SupportsPictureInPicture = false, ConfigurationChanges = ConfigChanges.Orientation | ConfigChanges.ScreenSize, HardwareAccelerated = false, LaunchMode = LaunchMode.SingleInstance, Exported = true)]
     [IntentFilter(new[] { Intent.ActionView }, Categories = new[] { Intent.CategoryDefault }, DataScheme = "content", DataPathPattern = ".*\\\\.osz", DataHost = "*", DataMimeType = "*/*")]
     [IntentFilter(new[] { Intent.ActionView }, Categories = new[] { Intent.CategoryDefault }, DataScheme = "content", DataPathPattern = ".*\\\\.osk", DataHost = "*", DataMimeType = "*/*")]
+    [IntentFilter(new[] { Intent.ActionView }, Categories = new[] { Intent.CategoryDefault }, DataScheme = "content", DataPathPattern = ".*\\\\.osr", DataHost = "*", DataMimeType = "*/*")]
     [IntentFilter(new[] { Intent.ActionView }, Categories = new[] { Intent.CategoryDefault }, DataScheme = "content", DataMimeType = "application/x-osu-beatmap-archive")]
     [IntentFilter(new[] { Intent.ActionView }, Categories = new[] { Intent.CategoryDefault }, DataScheme = "content", DataMimeType = "application/x-osu-skin-archive")]
     [IntentFilter(new[] { Intent.ActionView }, Categories = new[] { Intent.CategoryDefault }, DataScheme = "content", DataMimeType = "application/x-osu-replay")]

From ab28948744f0114e5053d3b0321f0e37990db7c1 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 2 Nov 2021 13:17:21 +0900
Subject: [PATCH 0637/5547] Default legacy decoder to `General` section, rather
 than none

This is mainly to reach parity with how stable handles such cases for
skins specifically. It was brought to our attention after finding a skin
with a malformed `\[General]` tag which did not break further parsing of
the file on stable, but did on lazer.

Note that stable defaults to an "unknown" section for beatmaps, but
functionally I can't think of a regression case from changing this to a
"general" default.
---
 osu.Game/Beatmaps/Formats/LegacyDecoder.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Beatmaps/Formats/LegacyDecoder.cs b/osu.Game/Beatmaps/Formats/LegacyDecoder.cs
index 56525ddb14..f17366a1b3 100644
--- a/osu.Game/Beatmaps/Formats/LegacyDecoder.cs
+++ b/osu.Game/Beatmaps/Formats/LegacyDecoder.cs
@@ -27,7 +27,7 @@ namespace osu.Game.Beatmaps.Formats
 
         protected override void ParseStreamInto(LineBufferedReader stream, T output)
         {
-            Section section = Section.None;
+            Section section = Section.General;
 
             string line;
 

From 15c770e155c8396c4a4b2413be3acc1362471193 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 2 Nov 2021 14:01:41 +0900
Subject: [PATCH 0638/5547] Remove no longer used `Section.None`

---
 osu.Game/Beatmaps/Formats/LegacyDecoder.cs | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/osu.Game/Beatmaps/Formats/LegacyDecoder.cs b/osu.Game/Beatmaps/Formats/LegacyDecoder.cs
index f17366a1b3..0276abc3ff 100644
--- a/osu.Game/Beatmaps/Formats/LegacyDecoder.cs
+++ b/osu.Game/Beatmaps/Formats/LegacyDecoder.cs
@@ -47,10 +47,7 @@ namespace osu.Game.Beatmaps.Formats
                 if (line.StartsWith('[') && line.EndsWith(']'))
                 {
                     if (!Enum.TryParse(line[1..^1], out section))
-                    {
                         Logger.Log($"Unknown section \"{line}\" in \"{output}\"");
-                        section = Section.None;
-                    }
 
                     OnBeginNewSection(section);
                     continue;
@@ -148,7 +145,6 @@ namespace osu.Game.Beatmaps.Formats
 
         protected enum Section
         {
-            None,
             General,
             Editor,
             Metadata,

From d4be6fc79761a984f812221a754e29c2afb97651 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 2 Nov 2021 14:04:25 +0900
Subject: [PATCH 0639/5547] Add test coverage of skin with missing section
 header

---
 osu.Game.Tests/Skins/IO/ImportSkinTest.cs | 19 +++++++++++++++----
 1 file changed, 15 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Tests/Skins/IO/ImportSkinTest.cs b/osu.Game.Tests/Skins/IO/ImportSkinTest.cs
index c75714032e..ecc9c92025 100644
--- a/osu.Game.Tests/Skins/IO/ImportSkinTest.cs
+++ b/osu.Game.Tests/Skins/IO/ImportSkinTest.cs
@@ -38,6 +38,15 @@ namespace osu.Game.Tests.Skins.IO
             assertCorrectMetadata(import1, "test skin [skin]", "skinner", osu);
         });
 
+        [Test]
+        public Task TestSingleImportMissingSectionHeader() => runSkinTest(async osu =>
+        {
+            var import1 = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOskWithIni("test skin", "skinner", includeSectionHeader: false), "skin.osk"));
+
+            // When the import filename doesn't match, it should be appended (and update the skin.ini).
+            assertCorrectMetadata(import1, "test skin [skin]", "skinner", osu);
+        });
+
         [Test]
         public Task TestSingleImportMatchingFilename() => runSkinTest(async osu =>
         {
@@ -199,21 +208,23 @@ namespace osu.Game.Tests.Skins.IO
             return zipStream;
         }
 
-        private MemoryStream createOskWithIni(string name, string author, bool makeUnique = false, string iniFilename = @"skin.ini")
+        private MemoryStream createOskWithIni(string name, string author, bool makeUnique = false, string iniFilename = @"skin.ini", bool includeSectionHeader = true)
         {
             var zipStream = new MemoryStream();
             using var zip = ZipArchive.Create();
-            zip.AddEntry(iniFilename, generateSkinIni(name, author, makeUnique));
+            zip.AddEntry(iniFilename, generateSkinIni(name, author, makeUnique, includeSectionHeader));
             zip.SaveTo(zipStream);
             return zipStream;
         }
 
-        private MemoryStream generateSkinIni(string name, string author, bool makeUnique = true)
+        private MemoryStream generateSkinIni(string name, string author, bool makeUnique = true, bool includeSectionHeader = true)
         {
             var stream = new MemoryStream();
             var writer = new StreamWriter(stream);
 
-            writer.WriteLine("[General]");
+            if (includeSectionHeader)
+                writer.WriteLine("[General]");
+
             writer.WriteLine($"Name: {name}");
             writer.WriteLine($"Author: {author}");
 

From 2e66ab453de7e8de39b721f62033badc5ba3a1a4 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 2 Nov 2021 13:11:29 +0900
Subject: [PATCH 0640/5547] Always write automated changes to skin metadata at
 the end of the file

Apart from being cleaner (and allowing removal at the point of export,
if that is ever requires), this also gives us a better guarantee that
the metadata is going to take effect.

By writing the `[General]` section ourselves, we avoid any issues that
may be present from a user constructing the file (incorrectly)
themselves, such as multiple `Title:` entries or a malformed `[General]`
marker.

The main goal is to ensure that the name is updated to what we expect it
to be.
---
 osu.Game/Skinning/SkinManager.cs | 52 +++++++++++---------------------
 1 file changed, 17 insertions(+), 35 deletions(-)

diff --git a/osu.Game/Skinning/SkinManager.cs b/osu.Game/Skinning/SkinManager.cs
index 76d36ae7d9..8891fe3a06 100644
--- a/osu.Game/Skinning/SkinManager.cs
+++ b/osu.Game/Skinning/SkinManager.cs
@@ -198,48 +198,30 @@ namespace osu.Game.Skinning
 
             if (existingFile != null)
             {
-                List<string> outputLines = new List<string>();
+                List<string> additionalLines = new List<string>();
 
-                bool addedName = false;
-                bool addedAuthor = false;
-
-                using (var stream = Files.Storage.GetStream(existingFile.FileInfo.StoragePath))
-                using (var sr = new StreamReader(stream))
+                additionalLines.AddRange(new[]
                 {
-                    string line;
-
-                    while ((line = sr.ReadLine()) != null)
-                    {
-                        if (line.StartsWith(@"Name:", StringComparison.Ordinal))
-                        {
-                            outputLines.Add(nameLine);
-                            addedName = true;
-                        }
-                        else if (line.StartsWith(@"Author:", StringComparison.Ordinal))
-                        {
-                            outputLines.Add(authorLine);
-                            addedAuthor = true;
-                        }
-                        else
-                            outputLines.Add(line);
-                    }
-                }
-
-                if (!addedName || !addedAuthor)
-                {
-                    outputLines.AddRange(new[]
-                    {
-                        @"[General]",
-                        nameLine,
-                        authorLine,
-                    });
-                }
+                    @"",
+                    @"// The following content was automatically added by osu! during import, based on filename / folder metadata.",
+                    @"[General]",
+                    nameLine,
+                    authorLine,
+                });
 
                 using (Stream stream = new MemoryStream())
                 {
                     using (var sw = new StreamWriter(stream, Encoding.UTF8, 1024, true))
                     {
-                        foreach (string line in outputLines)
+                        using (var existingStream = Files.Storage.GetStream(existingFile.FileInfo.StoragePath))
+                        using (var sr = new StreamReader(existingStream))
+                        {
+                            string line;
+                            while ((line = sr.ReadLine()) != null)
+                                sw.WriteLine(line);
+                        }
+
+                        foreach (string line in additionalLines)
                             sw.WriteLine(line);
                     }
 

From 5d784b2ef84cbb0aed379b0255ae6246d8dc13fe Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 2 Nov 2021 13:57:07 +0900
Subject: [PATCH 0641/5547] Perform a consistency check by decoding the newly
 written `skin.ini` during `ComputeHash`

As this has regressed twice now, let's play it safe and bail rather than
stack overflowing. Note that as all the underlying issues that could
trigger this have been fixed, no additional tests have been added. To
test, comment out `SkinManager.cs` line 228-229 to cause a failure. The
new logic will kick in and show a log output message, but all tests will
still (correctly) pass.
---
 osu.Game/Skinning/SkinManager.cs | 78 ++++++++++++++++++++------------
 1 file changed, 50 insertions(+), 28 deletions(-)

diff --git a/osu.Game/Skinning/SkinManager.cs b/osu.Game/Skinning/SkinManager.cs
index 8891fe3a06..35f4cbd3d0 100644
--- a/osu.Game/Skinning/SkinManager.cs
+++ b/osu.Game/Skinning/SkinManager.cs
@@ -194,50 +194,61 @@ namespace osu.Game.Skinning
             string nameLine = @$"Name: {item.Name}";
             string authorLine = @$"Author: {item.Creator}";
 
+            var newLines = new[]
+            {
+                @"// The following content was automatically added by osu! during import, based on filename / folder metadata.",
+                @"[General]",
+                nameLine,
+                authorLine,
+            };
+
             var existingFile = item.Files.SingleOrDefault(f => f.Filename.Equals(@"skin.ini", StringComparison.OrdinalIgnoreCase));
 
-            if (existingFile != null)
+            if (existingFile == null)
             {
-                List<string> additionalLines = new List<string>();
+                // In the case a skin doesn't have a skin.ini yet, let's create one.
+                writeNewSkinIni();
+                return;
+            }
 
-                additionalLines.AddRange(new[]
+            using (Stream stream = new MemoryStream())
+            {
+                using (var sw = new StreamWriter(stream, Encoding.UTF8, 1024, true))
                 {
-                    @"",
-                    @"// The following content was automatically added by osu! during import, based on filename / folder metadata.",
-                    @"[General]",
-                    nameLine,
-                    authorLine,
-                });
-
-                using (Stream stream = new MemoryStream())
-                {
-                    using (var sw = new StreamWriter(stream, Encoding.UTF8, 1024, true))
+                    using (var existingStream = Files.Storage.GetStream(existingFile.FileInfo.StoragePath))
+                    using (var sr = new StreamReader(existingStream))
                     {
-                        using (var existingStream = Files.Storage.GetStream(existingFile.FileInfo.StoragePath))
-                        using (var sr = new StreamReader(existingStream))
-                        {
-                            string line;
-                            while ((line = sr.ReadLine()) != null)
-                                sw.WriteLine(line);
-                        }
-
-                        foreach (string line in additionalLines)
+                        string line;
+                        while ((line = sr.ReadLine()) != null)
                             sw.WriteLine(line);
                     }
 
-                    ReplaceFile(item, existingFile, stream);
+                    sw.WriteLine();
+
+                    foreach (string line in newLines)
+                        sw.WriteLine(line);
+                }
+
+                ReplaceFile(item, existingFile, stream);
+
+                // can be removed 20220502.
+                if (!ensureIniWasUpdated(item))
+                {
+                    Logger.Log($"Skin {item}'s skin.ini had issues and has been removed. Please report this and provide the problematic skin.", LoggingTarget.Database, LogLevel.Important);
+
+                    DeleteFile(item, item.Files.SingleOrDefault(f => f.Filename.Equals(@"skin.ini", StringComparison.OrdinalIgnoreCase)));
+                    writeNewSkinIni();
                 }
             }
-            else
+
+            void writeNewSkinIni()
             {
                 using (Stream stream = new MemoryStream())
                 {
                     using (var sw = new StreamWriter(stream, Encoding.UTF8, 1024, true))
                     {
-                        sw.WriteLine(@"[General]");
-                        sw.WriteLine(nameLine);
-                        sw.WriteLine(authorLine);
-                        sw.WriteLine(@"Version: latest");
+                        foreach (string line in newLines)
+                            sw.WriteLine(line);
                     }
 
                     AddFile(item, stream, @"skin.ini");
@@ -245,6 +256,17 @@ namespace osu.Game.Skinning
             }
         }
 
+        private bool ensureIniWasUpdated(SkinInfo item)
+        {
+            // This is a final consistency check to ensure that hash computation doesn't enter an infinite loop.
+            // With other changes to the surrounding code this should never be hit, but until we are 101% sure that there
+            // are no other cases let's avoid a hard startup crash by bailing and alerting.
+
+            var instance = GetSkin(item);
+
+            return instance.Configuration.SkinInfo.Name == item.Name;
+        }
+
         protected override Task Populate(SkinInfo model, ArchiveReader archive, CancellationToken cancellationToken = default)
         {
             var instance = GetSkin(model);

From 9b705460dbf60e41749837fb87371893344ef919 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 2 Nov 2021 14:53:54 +0900
Subject: [PATCH 0642/5547] Remove trailing exclamation marks from autoplay
 character names

As mentioned in
https://github.com/ppy/osu/discussions/15401#discussioncomment-1573839.
---
 osu.Game.Rulesets.Catch/Mods/CatchModAutoplay.cs | 2 +-
 osu.Game.Rulesets.Catch/Mods/CatchModCinema.cs   | 2 +-
 osu.Game.Rulesets.Mania/Mods/ManiaModAutoplay.cs | 2 +-
 osu.Game.Rulesets.Mania/Mods/ManiaModCinema.cs   | 2 +-
 4 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Rulesets.Catch/Mods/CatchModAutoplay.cs b/osu.Game.Rulesets.Catch/Mods/CatchModAutoplay.cs
index f1b51e51d0..6f3e6763bd 100644
--- a/osu.Game.Rulesets.Catch/Mods/CatchModAutoplay.cs
+++ b/osu.Game.Rulesets.Catch/Mods/CatchModAutoplay.cs
@@ -14,7 +14,7 @@ namespace osu.Game.Rulesets.Catch.Mods
     {
         public override Score CreateReplayScore(IBeatmap beatmap, IReadOnlyList<Mod> mods) => new Score
         {
-            ScoreInfo = new ScoreInfo { User = new User { Username = "osu!salad!" } },
+            ScoreInfo = new ScoreInfo { User = new User { Username = "osu!salad" } },
             Replay = new CatchAutoGenerator(beatmap).Generate(),
         };
     }
diff --git a/osu.Game.Rulesets.Catch/Mods/CatchModCinema.cs b/osu.Game.Rulesets.Catch/Mods/CatchModCinema.cs
index d53d019e90..1b7d254321 100644
--- a/osu.Game.Rulesets.Catch/Mods/CatchModCinema.cs
+++ b/osu.Game.Rulesets.Catch/Mods/CatchModCinema.cs
@@ -15,7 +15,7 @@ namespace osu.Game.Rulesets.Catch.Mods
     {
         public override Score CreateReplayScore(IBeatmap beatmap, IReadOnlyList<Mod> mods) => new Score
         {
-            ScoreInfo = new ScoreInfo { User = new User { Username = "osu!salad!" } },
+            ScoreInfo = new ScoreInfo { User = new User { Username = "osu!salad" } },
             Replay = new CatchAutoGenerator(beatmap).Generate(),
         };
     }
diff --git a/osu.Game.Rulesets.Mania/Mods/ManiaModAutoplay.cs b/osu.Game.Rulesets.Mania/Mods/ManiaModAutoplay.cs
index 6ae854e7f3..86f667466f 100644
--- a/osu.Game.Rulesets.Mania/Mods/ManiaModAutoplay.cs
+++ b/osu.Game.Rulesets.Mania/Mods/ManiaModAutoplay.cs
@@ -15,7 +15,7 @@ namespace osu.Game.Rulesets.Mania.Mods
     {
         public override Score CreateReplayScore(IBeatmap beatmap, IReadOnlyList<Mod> mods) => new Score
         {
-            ScoreInfo = new ScoreInfo { User = new User { Username = "osu!topus!" } },
+            ScoreInfo = new ScoreInfo { User = new User { Username = "osu!topus" } },
             Replay = new ManiaAutoGenerator((ManiaBeatmap)beatmap).Generate(),
         };
     }
diff --git a/osu.Game.Rulesets.Mania/Mods/ManiaModCinema.cs b/osu.Game.Rulesets.Mania/Mods/ManiaModCinema.cs
index 064c55ed8d..1c06bb389b 100644
--- a/osu.Game.Rulesets.Mania/Mods/ManiaModCinema.cs
+++ b/osu.Game.Rulesets.Mania/Mods/ManiaModCinema.cs
@@ -16,7 +16,7 @@ namespace osu.Game.Rulesets.Mania.Mods
     {
         public override Score CreateReplayScore(IBeatmap beatmap, IReadOnlyList<Mod> mods) => new Score
         {
-            ScoreInfo = new ScoreInfo { User = new User { Username = "osu!topus!" } },
+            ScoreInfo = new ScoreInfo { User = new User { Username = "osu!topus" } },
             Replay = new ManiaAutoGenerator((ManiaBeatmap)beatmap).Generate(),
         };
     }

From 1e9211c00ba15f1c1fb9a4e70f5c7143c09ed6fc Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Tue, 2 Nov 2021 15:41:25 +0900
Subject: [PATCH 0643/5547] Use explicit type

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

diff --git a/osu.Game/Skinning/SkinManager.cs b/osu.Game/Skinning/SkinManager.cs
index 35f4cbd3d0..0739026544 100644
--- a/osu.Game/Skinning/SkinManager.cs
+++ b/osu.Game/Skinning/SkinManager.cs
@@ -194,7 +194,7 @@ namespace osu.Game.Skinning
             string nameLine = @$"Name: {item.Name}";
             string authorLine = @$"Author: {item.Creator}";
 
-            var newLines = new[]
+            string[] newLines =
             {
                 @"// The following content was automatically added by osu! during import, based on filename / folder metadata.",
                 @"[General]",

From eaeee80a262abb31d9ef3664dec0b42ad2712ed0 Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Tue, 2 Nov 2021 16:53:50 +0900
Subject: [PATCH 0644/5547] Fix PP counter showing incorrect values with rate
 adjustment mods

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

diff --git a/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs b/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs
index ef289c2a20..09ca326cce 100644
--- a/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs
+++ b/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs
@@ -48,6 +48,9 @@ namespace osu.Game.Screens.Play.HUD
         [CanBeNull]
         private GameplayState gameplayState { get; set; }
 
+        [Resolved(CanBeNull = true)]
+        private GameplayClock gameplayClock { get; set; }
+
         [CanBeNull]
         private List<TimedDifficultyAttributes> timedAttributes;
 
@@ -133,10 +136,12 @@ namespace osu.Game.Screens.Play.HUD
         [CanBeNull]
         private DifficultyAttributes getAttributeAtTime(JudgementResult judgement)
         {
-            if (timedAttributes == null || timedAttributes.Count == 0)
+            if (timedAttributes == null || timedAttributes.Count == 0 || gameplayClock == null)
                 return null;
 
-            int attribIndex = timedAttributes.BinarySearch(new TimedDifficultyAttributes(judgement.HitObject.GetEndTime(), null));
+            double judgementTime = judgement.HitObject.GetEndTime() / gameplayClock.TrueGameplayRate;
+
+            int attribIndex = timedAttributes.BinarySearch(new TimedDifficultyAttributes(judgementTime, null));
             if (attribIndex < 0)
                 attribIndex = ~attribIndex - 1;
 

From e472656b3750705abcf7fdb2415cfbd726d245ef Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 2 Nov 2021 17:11:34 +0900
Subject: [PATCH 0645/5547] Add test coverage of room participants updating on
 room join

---
 osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
index 11caf9f498..38cf9d662f 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
@@ -231,6 +231,9 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     }
                 }
             });
+
+            AddAssert("Check participant count correct", () => client.APIRoom?.ParticipantCount.Value == 1);
+            AddAssert("Check participant list contains user", () => client.APIRoom?.RecentParticipants.Count(u => u.Id == API.LocalUser.Value.Id) == 1);
         }
 
         [Test]
@@ -290,6 +293,9 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             AddUntilStep("wait for room open", () => this.ChildrenOfType<MultiplayerMatchSubScreen>().FirstOrDefault()?.IsLoaded == true);
             AddUntilStep("wait for join", () => client.Room != null);
+
+            AddAssert("Check participant count correct", () => client.APIRoom?.ParticipantCount.Value == 1);
+            AddAssert("Check participant list contains user", () => client.APIRoom?.RecentParticipants.Count(u => u.Id == API.LocalUser.Value.Id) == 1);
         }
 
         [Test]

From b0bd39fc4972b46b3577d90feab9aa2a1521e201 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 2 Nov 2021 16:36:28 +0900
Subject: [PATCH 0646/5547] Fix multiplayer room participants display not
 updating as new users join/leave

Can add tests on request, but not sure the code around this area is here
to stay permanently. Should be pretty low risk.

- Closes https://github.com/ppy/osu/issues/14788.
---
 .../Online/Multiplayer/MultiplayerClient.cs    | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/osu.Game/Online/Multiplayer/MultiplayerClient.cs b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
index 28505f6b0e..bf4bb13655 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
@@ -148,6 +148,10 @@ namespace osu.Game.Online.Multiplayer
                 {
                     Room = joinedRoom;
                     APIRoom = room;
+
+                    Debug.Assert(LocalUser != null);
+                    addUserToAPIRoom(LocalUser);
+
                     foreach (var user in joinedRoom.Users)
                         updateUserPlayingState(user.UserID, user.State);
 
@@ -372,6 +376,8 @@ namespace osu.Game.Online.Multiplayer
 
                 Room.Users.Add(user);
 
+                addUserToAPIRoom(user);
+
                 UserJoined?.Invoke(user);
                 RoomUpdated?.Invoke();
             });
@@ -391,6 +397,14 @@ namespace osu.Game.Online.Multiplayer
             return handleUserLeft(user, UserKicked);
         }
 
+        private void addUserToAPIRoom(MultiplayerRoomUser user)
+        {
+            Debug.Assert(APIRoom != null);
+
+            APIRoom.RecentParticipants.Add(user.User);
+            APIRoom.ParticipantCount.Value++;
+        }
+
         private Task handleUserLeft(MultiplayerRoomUser user, Action<MultiplayerRoomUser>? callback)
         {
             if (Room == null)
@@ -404,6 +418,10 @@ namespace osu.Game.Online.Multiplayer
                 Room.Users.Remove(user);
                 PlayingUserIds.Remove(user.UserID);
 
+                Debug.Assert(APIRoom != null);
+                APIRoom.RecentParticipants.RemoveAll(u => u.Id == user.UserID);
+                APIRoom.ParticipantCount.Value--;
+
                 callback?.Invoke(user);
                 RoomUpdated?.Invoke();
             }, false);

From 1bfa1365a00c977483b523685b2478d587687c22 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 2 Nov 2021 16:51:27 +0900
Subject: [PATCH 0647/5547] Rename "null user" tests to better explain purpose

---
 .../Multiplayer/TestSceneMultiplayerParticipantsList.cs       | 4 ++--
 osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs    | 2 +-
 osu.Game/Tests/Visual/TestUserLookupCache.cs                  | 4 ++--
 3 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerParticipantsList.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerParticipantsList.cs
index e50b150f94..2549681519 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerParticipantsList.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerParticipantsList.cs
@@ -45,11 +45,11 @@ namespace osu.Game.Tests.Visual.Multiplayer
         }
 
         [Test]
-        public void TestAddNullUser()
+        public void TestAddUnresolvedUser()
         {
             AddAssert("one unique panel", () => this.ChildrenOfType<ParticipantPanel>().Select(p => p.User).Distinct().Count() == 1);
 
-            AddStep("add non-resolvable user", () => Client.AddNullUser());
+            AddStep("add non-resolvable user", () => Client.TestAddUnresolvedUser());
             AddAssert("null user added", () => Client.Room.AsNonNull().Users.Count(u => u.User == null) == 1);
 
             AddUntilStep("two unique panels", () => this.ChildrenOfType<ParticipantPanel>().Select(p => p.User).Distinct().Count() == 2);
diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
index cd0f070d73..c6634abe82 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
@@ -62,7 +62,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             return roomUser;
         }
 
-        public void AddNullUser() => addUser(new MultiplayerRoomUser(TestUserLookupCache.NULL_USER_ID));
+        public void TestAddUnresolvedUser() => addUser(new MultiplayerRoomUser(TestUserLookupCache.UNRESOLVED_USER_ID));
 
         private void addUser(MultiplayerRoomUser user)
         {
diff --git a/osu.Game/Tests/Visual/TestUserLookupCache.cs b/osu.Game/Tests/Visual/TestUserLookupCache.cs
index b73e81d0dd..fcb9c070ff 100644
--- a/osu.Game/Tests/Visual/TestUserLookupCache.cs
+++ b/osu.Game/Tests/Visual/TestUserLookupCache.cs
@@ -14,11 +14,11 @@ namespace osu.Game.Tests.Visual
         /// A special user ID which <see cref="ComputeValueAsync"/> would return a <see langword="null"/> <see cref="User"/> for.
         /// As a simulation to what a regular <see cref="UserLookupCache"/> would return in the case of failing to fetch the user.
         /// </summary>
-        public const int NULL_USER_ID = -1;
+        public const int UNRESOLVED_USER_ID = -1;
 
         protected override Task<User> ComputeValueAsync(int lookup, CancellationToken token = default)
         {
-            if (lookup == NULL_USER_ID)
+            if (lookup == UNRESOLVED_USER_ID)
                 return Task.FromResult((User)null);
 
             return Task.FromResult(new User

From 135df0e190cba4a8ef459d456911993a46d578d9 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 2 Nov 2021 16:51:42 +0900
Subject: [PATCH 0648/5547] Avoid adding null users to `RecentParticipants`

---
 osu.Game/Online/Multiplayer/MultiplayerClient.cs | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Online/Multiplayer/MultiplayerClient.cs b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
index bf4bb13655..0586e0ae60 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
@@ -401,7 +401,11 @@ namespace osu.Game.Online.Multiplayer
         {
             Debug.Assert(APIRoom != null);
 
-            APIRoom.RecentParticipants.Add(user.User);
+            APIRoom.RecentParticipants.Add(user.User ?? new User
+            {
+                Id = user.UserID,
+                Username = "[Unresolved]"
+            });
             APIRoom.ParticipantCount.Value++;
         }
 

From 0cdd2898feb831da98511e7f1189dcd6d3309a5b Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Tue, 2 Nov 2021 17:17:14 +0900
Subject: [PATCH 0649/5547] Expose non-adjusted time from CalculateTimed()

---
 osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs     | 2 +-
 .../Rulesets/Difficulty/TimedDifficultyAttributes.cs     | 7 +++++++
 osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs    | 9 ++-------
 3 files changed, 10 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs b/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs
index eab81186d5..d410fb6edf 100644
--- a/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs
+++ b/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs
@@ -77,7 +77,7 @@ namespace osu.Game.Rulesets.Difficulty
                 foreach (var skill in skills)
                     skill.ProcessInternal(hitObject);
 
-                attribs.Add(new TimedDifficultyAttributes(hitObject.EndTime, CreateDifficultyAttributes(progressiveBeatmap, playableMods, skills, clockRate)));
+                attribs.Add(new TimedDifficultyAttributes(hitObject.EndTime * clockRate, CreateDifficultyAttributes(progressiveBeatmap, playableMods, skills, clockRate)));
             }
 
             return attribs;
diff --git a/osu.Game/Rulesets/Difficulty/TimedDifficultyAttributes.cs b/osu.Game/Rulesets/Difficulty/TimedDifficultyAttributes.cs
index 973b2dacb2..28319ec6d7 100644
--- a/osu.Game/Rulesets/Difficulty/TimedDifficultyAttributes.cs
+++ b/osu.Game/Rulesets/Difficulty/TimedDifficultyAttributes.cs
@@ -11,7 +11,14 @@ namespace osu.Game.Rulesets.Difficulty
     /// </summary>
     public class TimedDifficultyAttributes : IComparable<TimedDifficultyAttributes>
     {
+        /// <summary>
+        /// The non-clock adjusted time value at which the attributes take effect.
+        /// </summary>
         public readonly double Time;
+
+        /// <summary>
+        /// The attributes.
+        /// </summary>
         public readonly DifficultyAttributes Attributes;
 
         public TimedDifficultyAttributes(double time, DifficultyAttributes attributes)
diff --git a/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs b/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs
index 09ca326cce..ef289c2a20 100644
--- a/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs
+++ b/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs
@@ -48,9 +48,6 @@ namespace osu.Game.Screens.Play.HUD
         [CanBeNull]
         private GameplayState gameplayState { get; set; }
 
-        [Resolved(CanBeNull = true)]
-        private GameplayClock gameplayClock { get; set; }
-
         [CanBeNull]
         private List<TimedDifficultyAttributes> timedAttributes;
 
@@ -136,12 +133,10 @@ namespace osu.Game.Screens.Play.HUD
         [CanBeNull]
         private DifficultyAttributes getAttributeAtTime(JudgementResult judgement)
         {
-            if (timedAttributes == null || timedAttributes.Count == 0 || gameplayClock == null)
+            if (timedAttributes == null || timedAttributes.Count == 0)
                 return null;
 
-            double judgementTime = judgement.HitObject.GetEndTime() / gameplayClock.TrueGameplayRate;
-
-            int attribIndex = timedAttributes.BinarySearch(new TimedDifficultyAttributes(judgementTime, null));
+            int attribIndex = timedAttributes.BinarySearch(new TimedDifficultyAttributes(judgement.HitObject.GetEndTime(), null));
             if (attribIndex < 0)
                 attribIndex = ~attribIndex - 1;
 

From efba7a9c4d70093a00ccb4f163c02c805b1248df Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Tue, 2 Nov 2021 17:18:02 +0900
Subject: [PATCH 0650/5547] Missed hyphen

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

diff --git a/osu.Game/Rulesets/Difficulty/TimedDifficultyAttributes.cs b/osu.Game/Rulesets/Difficulty/TimedDifficultyAttributes.cs
index 28319ec6d7..e61fa72de9 100644
--- a/osu.Game/Rulesets/Difficulty/TimedDifficultyAttributes.cs
+++ b/osu.Game/Rulesets/Difficulty/TimedDifficultyAttributes.cs
@@ -12,7 +12,7 @@ namespace osu.Game.Rulesets.Difficulty
     public class TimedDifficultyAttributes : IComparable<TimedDifficultyAttributes>
     {
         /// <summary>
-        /// The non-clock adjusted time value at which the attributes take effect.
+        /// The non-clock-adjusted time value at which the attributes take effect.
         /// </summary>
         public readonly double Time;
 

From 168a7a588b62b3f087e1d6e9785b7e8eeb2f9959 Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Tue, 2 Nov 2021 17:19:14 +0900
Subject: [PATCH 0651/5547] Add xmldoc to ctor also

---
 osu.Game/Rulesets/Difficulty/TimedDifficultyAttributes.cs | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/osu.Game/Rulesets/Difficulty/TimedDifficultyAttributes.cs b/osu.Game/Rulesets/Difficulty/TimedDifficultyAttributes.cs
index e61fa72de9..2509971389 100644
--- a/osu.Game/Rulesets/Difficulty/TimedDifficultyAttributes.cs
+++ b/osu.Game/Rulesets/Difficulty/TimedDifficultyAttributes.cs
@@ -21,6 +21,11 @@ namespace osu.Game.Rulesets.Difficulty
         /// </summary>
         public readonly DifficultyAttributes Attributes;
 
+        /// <summary>
+        /// Creates new <see cref="TimedDifficultyAttributes"/>.
+        /// </summary>
+        /// <param name="time">The non-clock-adjusted time value at which the attributes take effect.</param>
+        /// <param name="attributes">The attributes.</param>
         public TimedDifficultyAttributes(double time, DifficultyAttributes attributes)
         {
             Time = time;

From 81aaef719fc58911d3ec94fc9c5c6bd2a77480b8 Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Tue, 2 Nov 2021 17:55:00 +0900
Subject: [PATCH 0652/5547] Add xmldoc to CalculateTimed()

---
 osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs b/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs
index d410fb6edf..5b4284dc2f 100644
--- a/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs
+++ b/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs
@@ -58,6 +58,11 @@ namespace osu.Game.Rulesets.Difficulty
             return CreateDifficultyAttributes(Beatmap, playableMods, skills, clockRate);
         }
 
+        /// <summary>
+        /// Calculates the difficulty of the beatmap and returns a set of <see cref="TimedDifficultyAttributes"/> representing the difficulty at every relevant time value in the beatmap.
+        /// </summary>
+        /// <param name="mods">The mods that should be applied to the beatmap.</param>
+        /// <returns>The set of <see cref="TimedDifficultyAttributes"/>.</returns>
         public List<TimedDifficultyAttributes> CalculateTimed(params Mod[] mods)
         {
             preProcess(mods);

From 5486ca084e66e6a8bb751a153837b72e534769ae Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Tue, 2 Nov 2021 23:32:58 +0900
Subject: [PATCH 0653/5547] Resolve tests

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

diff --git a/osu.Game.Rulesets.Osu.Tests/OsuDifficultyCalculatorTest.cs b/osu.Game.Rulesets.Osu.Tests/OsuDifficultyCalculatorTest.cs
index 15675e74d1..7cd06c5225 100644
--- a/osu.Game.Rulesets.Osu.Tests/OsuDifficultyCalculatorTest.cs
+++ b/osu.Game.Rulesets.Osu.Tests/OsuDifficultyCalculatorTest.cs
@@ -15,13 +15,13 @@ namespace osu.Game.Rulesets.Osu.Tests
     {
         protected override string ResourceAssembly => "osu.Game.Rulesets.Osu";
 
-        [TestCase(6.5867229481955389d, "diffcalc-test")]
-        [TestCase(1.0416315570967911d, "zero-length-sliders")]
+        [TestCase(6.5295339534769958d, "diffcalc-test")]
+        [TestCase(1.1514260533755143d, "zero-length-sliders")]
         public void Test(double expected, string name)
             => base.Test(expected, name);
 
-        [TestCase(8.2730989071947896d, "diffcalc-test")]
-        [TestCase(1.2726413186221039d, "zero-length-sliders")]
+        [TestCase(9.047752485219954d, "diffcalc-test")]
+        [TestCase(1.3985711787077566d, "zero-length-sliders")]
         public void TestClockRateAdjusted(double expected, string name)
             => Test(expected, name, new OsuModDoubleTime());
 

From be8a1f60c03d89e66a94fec9e8d3801e2c2a0031 Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Tue, 2 Nov 2021 23:33:51 +0900
Subject: [PATCH 0654/5547] Apply styling changes

---
 osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
index f706646cdf..f1eb464a29 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
@@ -6,7 +6,6 @@ using osu.Game.Rulesets.Difficulty.Preprocessing;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Osu.Difficulty.Preprocessing;
 using osu.Game.Rulesets.Osu.Objects;
-using osu.Framework.Utils;
 
 namespace osu.Game.Rulesets.Osu.Difficulty.Skills
 {
@@ -80,10 +79,12 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
                     if (osuCurrObj.StrainTime > 100) // Only buff deltaTime exceeding 300 bpm 1/2.
                         acuteAngleBonus = 0;
                     else
+                    {
                         acuteAngleBonus *= calcAcuteAngleBonus(prevAngle) // Multiply by previous angle, we don't want to buff unless this is a wiggle type pattern.
-                                            * Math.Min(angleBonus, 125 / osuCurrObj.StrainTime) // The maximum velocity we buff is equal to 125 / strainTime
-                                            * Math.Pow(Math.Sin(Math.PI / 2 * Math.Min(1, (100 - osuCurrObj.StrainTime) / 25)), 2) // scale buff from 150 bpm 1/4 to 200 bpm 1/4
-                                            * Math.Pow(Math.Sin(Math.PI / 2 * (Math.Clamp(osuCurrObj.JumpDistance, 50, 100) - 50) / 50), 2); // Buff distance exceeding 50 (radius) up to 100 (diameter).
+                                           * Math.Min(angleBonus, 125 / osuCurrObj.StrainTime) // The maximum velocity we buff is equal to 125 / strainTime
+                                           * Math.Pow(Math.Sin(Math.PI / 2 * Math.Min(1, (100 - osuCurrObj.StrainTime) / 25)), 2) // scale buff from 150 bpm 1/4 to 200 bpm 1/4
+                                           * Math.Pow(Math.Sin(Math.PI / 2 * (Math.Clamp(osuCurrObj.JumpDistance, 50, 100) - 50) / 50), 2); // Buff distance exceeding 50 (radius) up to 100 (diameter).
+                    }
 
                     wideAngleBonus *= angleBonus * (1 - Math.Min(wideAngleBonus, Math.Pow(calcWideAngleBonus(prevAngle), 3))); // Penalize wide angles if they're repeated, reducing the penalty as the prevAngle gets more acute.
                     acuteAngleBonus *= 0.5 + 0.5 * (1 - Math.Min(acuteAngleBonus, Math.Pow(calcAcuteAngleBonus(lastAngle), 3))); // Penalize acute angles if they're repeated, reducing the penalty as the lastAngle gets more obtuse.

From 5454de7ae876fee195d2e03feab8cab88516ebdd Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Tue, 2 Nov 2021 23:47:20 +0900
Subject: [PATCH 0655/5547] Refactor xmldocs

---
 .../Difficulty/Preprocessing/OsuDifficultyHitObject.cs      | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
index e5bb80d9a5..c274d08a1b 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
@@ -39,12 +39,12 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
         public double? Angle { get; private set; }
 
         /// <summary>
-        /// Milliseconds elapsed since the end time of the Previous <see cref="OsuDifficultyHitObject"/>, with a minimum of 25ms.
+        /// Milliseconds elapsed since the end time of the previous <see cref="OsuDifficultyHitObject"/>, with a minimum of 25ms.
         /// </summary>
         public double MovementTime { get; private set; }
 
         /// <summary>
-        /// Milliseconds elapsed since from the start time of the Previous <see cref="OsuDifficultyHitObject"/> to the end time of the same Previous <see cref="OsuDifficultyHitObject"/>, with a minimum of 25ms.
+        /// Milliseconds elapsed since the start time of the previous <see cref="OsuDifficultyHitObject"/> to the end time of the same previous <see cref="OsuDifficultyHitObject"/>, with a minimum of 25ms.
         /// </summary>
         public double TravelTime { get; private set; }
 
@@ -62,7 +62,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
             this.lastLastObject = (OsuHitObject)lastLastObject;
             this.lastObject = (OsuHitObject)lastObject;
 
-            // Capped to 25ms to prevent difficulty calculation breaking from simulatenous objects.
+            // Capped to 25ms to prevent difficulty calculation breaking from simultaneous objects.
             StrainTime = Math.Max(DeltaTime, min_delta_time);
 
             setDistances(clockRate);

From 7e0629774b1421c076d60da42a10ff3ff57c6ff0 Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Tue, 2 Nov 2021 23:51:09 +0900
Subject: [PATCH 0656/5547] Rename variables for readability

In particular, "last" vs "prev" can get confusing because they mean the
same thing.
---
 .../Difficulty/Skills/Aim.cs                  | 22 +++++++++----------
 1 file changed, 11 insertions(+), 11 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
index f1eb464a29..d18d177515 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
@@ -35,12 +35,12 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
                 return 0;
 
             var osuCurrObj = (OsuDifficultyHitObject)current;
-            var osuPrevObj = (OsuDifficultyHitObject)Previous[0];
-            var osuLastObj = (OsuDifficultyHitObject)Previous[1];
+            var osuLastObj = (OsuDifficultyHitObject)Previous[0];
+            var osuLastLastObj = (OsuDifficultyHitObject)Previous[1];
 
             double currVelocity = osuCurrObj.JumpDistance / osuCurrObj.StrainTime; // Start with the base distance / time
 
-            if (osuPrevObj.BaseObject is Slider) // If object is a slider
+            if (osuLastObj.BaseObject is Slider) // If object is a slider
             {
                 double movementVelocity = osuCurrObj.MovementDistance / osuCurrObj.MovementTime; // calculate the movement velocity from slider end to next note
                 double travelVelocity = osuCurrObj.TravelDistance / osuCurrObj.TravelTime; // calculate the slider velocity from slider head to lazy end.
@@ -48,12 +48,12 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
                 currVelocity = Math.Max(currVelocity, movementVelocity + travelVelocity); // take the larger total combined velocity.
             }
 
-            double prevVelocity = osuPrevObj.JumpDistance / osuPrevObj.StrainTime; // do the same for the previous velocity.
+            double prevVelocity = osuLastObj.JumpDistance / osuLastObj.StrainTime; // do the same for the previous velocity.
 
-            if (osuLastObj.BaseObject is Slider)
+            if (osuLastLastObj.BaseObject is Slider)
             {
-                double movementVelocity = osuPrevObj.MovementDistance / osuPrevObj.MovementTime;
-                double travelVelocity = osuPrevObj.TravelDistance / osuPrevObj.TravelTime;
+                double movementVelocity = osuLastObj.MovementDistance / osuLastObj.MovementTime;
+                double travelVelocity = osuLastObj.TravelDistance / osuLastObj.TravelTime;
 
                 prevVelocity = Math.Max(prevVelocity, movementVelocity + travelVelocity);
             }
@@ -62,13 +62,13 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
 
             double aimStrain = currVelocity; // Start strain with regular velocity.
 
-            if (Math.Max(osuCurrObj.StrainTime, osuPrevObj.StrainTime) < 1.25 * Math.Min(osuCurrObj.StrainTime, osuPrevObj.StrainTime)) // If rhythms are the same.
+            if (Math.Max(osuCurrObj.StrainTime, osuLastObj.StrainTime) < 1.25 * Math.Min(osuCurrObj.StrainTime, osuLastObj.StrainTime)) // If rhythms are the same.
             {
-                if (osuCurrObj.Angle != null && osuPrevObj.Angle != null && osuLastObj.Angle != null)
+                if (osuCurrObj.Angle != null && osuLastObj.Angle != null && osuLastLastObj.Angle != null)
                 {
                     double currAngle = osuCurrObj.Angle.Value;
-                    double prevAngle = osuPrevObj.Angle.Value;
-                    double lastAngle = osuLastObj.Angle.Value;
+                    double prevAngle = osuLastObj.Angle.Value;
+                    double lastAngle = osuLastLastObj.Angle.Value;
 
                     // Rewarding angles, take the smaller velocity as base.
                     angleBonus = Math.Min(currVelocity, prevVelocity);

From 93c03b9d37a25b8c187a124c6a90152a155187ee Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Wed, 3 Nov 2021 00:04:19 +0900
Subject: [PATCH 0657/5547] Refactor documentation around velocity calculations

---
 osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs | 14 ++++++++------
 1 file changed, 8 insertions(+), 6 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
index d18d177515..ccf69e30a2 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
@@ -38,17 +38,20 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
             var osuLastObj = (OsuDifficultyHitObject)Previous[0];
             var osuLastLastObj = (OsuDifficultyHitObject)Previous[1];
 
-            double currVelocity = osuCurrObj.JumpDistance / osuCurrObj.StrainTime; // Start with the base distance / time
+            // Calculate the velocity to the current hitobject, which starts with a base distance / time assuming the last object is a hitcircle.
+            double currVelocity = osuCurrObj.JumpDistance / osuCurrObj.StrainTime;
 
-            if (osuLastObj.BaseObject is Slider) // If object is a slider
+            // But if the last object is a slider, then we extend the travel velocity through the slider into the current object.
+            if (osuLastObj.BaseObject is Slider)
             {
-                double movementVelocity = osuCurrObj.MovementDistance / osuCurrObj.MovementTime; // calculate the movement velocity from slider end to next note
-                double travelVelocity = osuCurrObj.TravelDistance / osuCurrObj.TravelTime; // calculate the slider velocity from slider head to lazy end.
+                double movementVelocity = osuCurrObj.MovementDistance / osuCurrObj.MovementTime; // calculate the movement velocity from slider end to current object
+                double travelVelocity = osuCurrObj.TravelDistance / osuCurrObj.TravelTime; // calculate the slider velocity from slider head to slider end.
 
                 currVelocity = Math.Max(currVelocity, movementVelocity + travelVelocity); // take the larger total combined velocity.
             }
 
-            double prevVelocity = osuLastObj.JumpDistance / osuLastObj.StrainTime; // do the same for the previous velocity.
+            // As above, do the same for the previous hitobject.
+            double prevVelocity = osuLastObj.JumpDistance / osuLastObj.StrainTime;
 
             if (osuLastLastObj.BaseObject is Slider)
             {
@@ -59,7 +62,6 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
             }
 
             double angleBonus = 0;
-
             double aimStrain = currVelocity; // Start strain with regular velocity.
 
             if (Math.Max(osuCurrObj.StrainTime, osuLastObj.StrainTime) < 1.25 * Math.Min(osuCurrObj.StrainTime, osuLastObj.StrainTime)) // If rhythms are the same.

From b0d9c0eca3709d22b2bae21cc89b36d1b42a2cb3 Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Wed, 3 Nov 2021 00:16:33 +0900
Subject: [PATCH 0658/5547] Refactor variables for readability in angle
 calculations

---
 osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
index ccf69e30a2..a054b46366 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
@@ -69,8 +69,8 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
                 if (osuCurrObj.Angle != null && osuLastObj.Angle != null && osuLastLastObj.Angle != null)
                 {
                     double currAngle = osuCurrObj.Angle.Value;
-                    double prevAngle = osuLastObj.Angle.Value;
-                    double lastAngle = osuLastLastObj.Angle.Value;
+                    double lastAngle = osuLastObj.Angle.Value;
+                    double lastLastAngle = osuLastLastObj.Angle.Value;
 
                     // Rewarding angles, take the smaller velocity as base.
                     angleBonus = Math.Min(currVelocity, prevVelocity);
@@ -82,16 +82,16 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
                         acuteAngleBonus = 0;
                     else
                     {
-                        acuteAngleBonus *= calcAcuteAngleBonus(prevAngle) // Multiply by previous angle, we don't want to buff unless this is a wiggle type pattern.
+                        acuteAngleBonus *= calcAcuteAngleBonus(lastAngle) // Multiply by previous angle, we don't want to buff unless this is a wiggle type pattern.
                                            * Math.Min(angleBonus, 125 / osuCurrObj.StrainTime) // The maximum velocity we buff is equal to 125 / strainTime
                                            * Math.Pow(Math.Sin(Math.PI / 2 * Math.Min(1, (100 - osuCurrObj.StrainTime) / 25)), 2) // scale buff from 150 bpm 1/4 to 200 bpm 1/4
                                            * Math.Pow(Math.Sin(Math.PI / 2 * (Math.Clamp(osuCurrObj.JumpDistance, 50, 100) - 50) / 50), 2); // Buff distance exceeding 50 (radius) up to 100 (diameter).
                     }
 
-                    wideAngleBonus *= angleBonus * (1 - Math.Min(wideAngleBonus, Math.Pow(calcWideAngleBonus(prevAngle), 3))); // Penalize wide angles if they're repeated, reducing the penalty as the prevAngle gets more acute.
-                    acuteAngleBonus *= 0.5 + 0.5 * (1 - Math.Min(acuteAngleBonus, Math.Pow(calcAcuteAngleBonus(lastAngle), 3))); // Penalize acute angles if they're repeated, reducing the penalty as the lastAngle gets more obtuse.
+                    wideAngleBonus *= angleBonus * (1 - Math.Min(wideAngleBonus, Math.Pow(calcWideAngleBonus(lastAngle), 3))); // Penalize wide angles if they're repeated, reducing the penalty as the lastAngle gets more acute.
+                    acuteAngleBonus *= 0.5 + 0.5 * (1 - Math.Min(acuteAngleBonus, Math.Pow(calcAcuteAngleBonus(lastLastAngle), 3))); // Penalize acute angles if they're repeated, reducing the penalty as the lastLastAngle gets more obtuse.
 
-                    angleBonus = acuteAngleBonus * acute_angle_multiplier + wideAngleBonus * wide_angle_multiplier; // add the anglebuffs together.
+                    angleBonus = acuteAngleBonus * acute_angle_multiplier + wideAngleBonus * wide_angle_multiplier; // add the angle buffs together.
                 }
             }
 

From 133218ecbb41f87f8d6975380ccff5805da1a010 Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Wed, 3 Nov 2021 01:04:07 +0900
Subject: [PATCH 0659/5547] Document special MovementDistance for sliders,
 ensure always has a value

---
 .../Preprocessing/OsuDifficultyHitObject.cs   | 22 ++++++++++++++-----
 1 file changed, 16 insertions(+), 6 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
index c274d08a1b..4b90285fd4 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
@@ -83,19 +83,29 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
                 scalingFactor *= 1 + smallCircleBonus;
             }
 
+            Vector2 lastCursorPosition = getEndCursorPosition(lastObject);
+            JumpDistance = (BaseObject.StackedPosition * scalingFactor - lastCursorPosition * scalingFactor).Length;
+
             if (lastObject is Slider lastSlider)
             {
                 computeSliderCursorPosition(lastSlider);
                 TravelDistance = lastSlider.LazyTravelDistance * scalingFactor;
                 TravelTime = Math.Max(lastSlider.LazyTravelTime / clockRate, min_delta_time);
                 MovementTime = Math.Max(StrainTime - TravelTime, min_delta_time);
-                MovementDistance = Vector2.Subtract(lastSlider.TailCircle.StackedPosition, BaseObject.StackedPosition).Length * scalingFactor;
+
+                // Jump distance from the slider tail to the next object, as opposed to the lazy position of JumpDistance.
+                float tailJumpDistance = Vector2.Subtract(lastSlider.TailCircle.StackedPosition, BaseObject.StackedPosition).Length * scalingFactor;
+
+                // For hitobjects which continue in the direction of the slider, the player will normally follow through the slider,
+                // such that they're not jumping from the lazy position but rather from very close to (or the end of) the slider.
+                // In such cases, a leniency is applied by also considering the jump distance from the tail of the slider, and taking the minimum jump distance.
+                MovementDistance = Math.Min(JumpDistance, tailJumpDistance);
+            }
+            else
+            {
+                MovementTime = StrainTime;
+                MovementDistance = JumpDistance;
             }
-
-            Vector2 lastCursorPosition = getEndCursorPosition(lastObject);
-
-            JumpDistance = (BaseObject.StackedPosition * scalingFactor - lastCursorPosition * scalingFactor).Length;
-            MovementDistance = Math.Min(JumpDistance, MovementDistance);
 
             if (lastLastObject != null && !(lastLastObject is Spinner))
             {

From c85a4dca281bc0ed97ef275ae2ae8c08dab5a819 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 3 Nov 2021 02:47:33 +0900
Subject: [PATCH 0660/5547] Fix crash when attempting to view global
 leaderboards

---
 osu.Game/Online/API/Requests/Responses/APIScoreInfo.cs | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Online/API/Requests/Responses/APIScoreInfo.cs b/osu.Game/Online/API/Requests/Responses/APIScoreInfo.cs
index 2e41723f34..5395fe0429 100644
--- a/osu.Game/Online/API/Requests/Responses/APIScoreInfo.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIScoreInfo.cs
@@ -37,6 +37,7 @@ namespace osu.Game.Online.API.Requests.Responses
         public DateTimeOffset Date { get; set; }
 
         [JsonProperty(@"beatmap")]
+        [CanBeNull]
         public APIBeatmap Beatmap { get; set; }
 
         [JsonProperty("accuracy")]
@@ -46,6 +47,7 @@ namespace osu.Game.Online.API.Requests.Responses
         public double? PP { get; set; }
 
         [JsonProperty(@"beatmapset")]
+        [CanBeNull]
         public APIBeatmapSet BeatmapSet
         {
             set
@@ -96,7 +98,7 @@ namespace osu.Game.Online.API.Requests.Responses
             {
                 TotalScore = TotalScore,
                 MaxCombo = MaxCombo,
-                BeatmapInfo = Beatmap.ToBeatmapInfo(rulesets),
+                BeatmapInfo = Beatmap?.ToBeatmapInfo(rulesets),
                 User = User,
                 Accuracy = Accuracy,
                 OnlineScoreID = OnlineID,

From 08b0ffad504c9836931626987a5adcbde04945cb Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 3 Nov 2021 03:12:13 +0900
Subject: [PATCH 0661/5547] Fix incorrect check for local beatmap in
 `BeatmapDifficultyCache`

This was correct in the WIP branch I have, but pulled out alone (where
usages of `ToBeatmapInfo` still exist) it was not enough.
---
 osu.Game/Beatmaps/BeatmapDifficultyCache.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Beatmaps/BeatmapDifficultyCache.cs b/osu.Game/Beatmaps/BeatmapDifficultyCache.cs
index 9a0cdb387d..035f438b89 100644
--- a/osu.Game/Beatmaps/BeatmapDifficultyCache.cs
+++ b/osu.Game/Beatmaps/BeatmapDifficultyCache.cs
@@ -131,7 +131,7 @@ namespace osu.Game.Beatmaps
             var localRulesetInfo = rulesetInfo as RulesetInfo;
 
             // Difficulty can only be computed if the beatmap and ruleset are locally available.
-            if (localBeatmapInfo == null || localRulesetInfo == null)
+            if (localBeatmapInfo == null || localBeatmapInfo.ID == 0 || localRulesetInfo == null)
             {
                 // If not, fall back to the existing star difficulty (e.g. from an online source).
                 return Task.FromResult(new StarDifficulty(beatmapInfo.StarRating, (beatmapInfo as IBeatmapOnlineInfo)?.MaxCombo ?? 0));

From 6efd3d3115d953a5dbdb8a107a0db01e185eb9e4 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 3 Nov 2021 03:07:27 +0900
Subject: [PATCH 0662/5547] Don't perform background difficulty calculation for
 multiplayer panels

There are cases these are shown in a long list. They shouldn't be
running calculations.
---
 osu.Game/Beatmaps/Drawables/DifficultyIcon.cs           | 5 +++--
 osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs | 2 +-
 2 files changed, 4 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Beatmaps/Drawables/DifficultyIcon.cs b/osu.Game/Beatmaps/Drawables/DifficultyIcon.cs
index 64412675bb..6e573cc2a0 100644
--- a/osu.Game/Beatmaps/Drawables/DifficultyIcon.cs
+++ b/osu.Game/Beatmaps/Drawables/DifficultyIcon.cs
@@ -60,8 +60,9 @@ namespace osu.Game.Beatmaps.Drawables
         /// <param name="ruleset">The ruleset to show the difficulty with.</param>
         /// <param name="mods">The mods to show the difficulty with.</param>
         /// <param name="shouldShowTooltip">Whether to display a tooltip when hovered.</param>
-        public DifficultyIcon([NotNull] IBeatmapInfo beatmapInfo, [CanBeNull] IRulesetInfo ruleset, [CanBeNull] IReadOnlyList<Mod> mods, bool shouldShowTooltip = true)
-            : this(beatmapInfo, shouldShowTooltip)
+        /// <param name="performBackgroundDifficultyLookup">Whether to perform difficulty lookup (including calculation if necessary).</param>
+        public DifficultyIcon([NotNull] IBeatmapInfo beatmapInfo, [CanBeNull] IRulesetInfo ruleset, [CanBeNull] IReadOnlyList<Mod> mods, bool shouldShowTooltip = true, bool performBackgroundDifficultyLookup = true)
+            : this(beatmapInfo, shouldShowTooltip, performBackgroundDifficultyLookup)
         {
             this.ruleset = ruleset ?? beatmapInfo.Ruleset;
             this.mods = mods ?? Array.Empty<Mod>();
diff --git a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
index 69ab7225ac..6f947bd398 100644
--- a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
+++ b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
@@ -105,7 +105,7 @@ namespace osu.Game.Screens.OnlinePlay
 
         private void refresh()
         {
-            difficultyIconContainer.Child = new DifficultyIcon(beatmap.Value, ruleset.Value, requiredMods) { Size = new Vector2(32) };
+            difficultyIconContainer.Child = new DifficultyIcon(beatmap.Value, ruleset.Value, requiredMods, performBackgroundDifficultyLookup: false) { Size = new Vector2(32) };
 
             beatmapText.Clear();
             beatmapText.AddLink(Item.Beatmap.Value.GetDisplayTitleRomanisable(), LinkAction.OpenBeatmap, Item.Beatmap.Value.OnlineBeatmapID.ToString(), null, text =>

From c028275d6cd8541c92cd09933fc303039ab3d86a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 2 Nov 2021 19:16:44 +0100
Subject: [PATCH 0663/5547] Fix multiplayer score submission not working

---
 osu.Game/Online/Rooms/SubmitRoomScoreRequest.cs | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Online/Rooms/SubmitRoomScoreRequest.cs b/osu.Game/Online/Rooms/SubmitRoomScoreRequest.cs
index 9e432fa99e..d5da6c401c 100644
--- a/osu.Game/Online/Rooms/SubmitRoomScoreRequest.cs
+++ b/osu.Game/Online/Rooms/SubmitRoomScoreRequest.cs
@@ -5,6 +5,7 @@ using System.Net.Http;
 using Newtonsoft.Json;
 using osu.Framework.IO.Network;
 using osu.Game.Online.API;
+using osu.Game.Online.Solo;
 using osu.Game.Scoring;
 
 namespace osu.Game.Online.Rooms
@@ -14,14 +15,14 @@ namespace osu.Game.Online.Rooms
         private readonly long scoreId;
         private readonly long roomId;
         private readonly long playlistItemId;
-        private readonly ScoreInfo scoreInfo;
+        private readonly SubmittableScore score;
 
         public SubmitRoomScoreRequest(long scoreId, long roomId, long playlistItemId, ScoreInfo scoreInfo)
         {
             this.scoreId = scoreId;
             this.roomId = roomId;
             this.playlistItemId = playlistItemId;
-            this.scoreInfo = scoreInfo;
+            score = new SubmittableScore(scoreInfo);
         }
 
         protected override WebRequest CreateWebRequest()
@@ -31,7 +32,7 @@ namespace osu.Game.Online.Rooms
             req.ContentType = "application/json";
             req.Method = HttpMethod.Put;
 
-            req.AddRaw(JsonConvert.SerializeObject(scoreInfo, new JsonSerializerSettings
+            req.AddRaw(JsonConvert.SerializeObject(score, new JsonSerializerSettings
             {
                 ReferenceLoopHandling = ReferenceLoopHandling.Ignore
             }));

From 392559ae3effe1ad5dc96105fad3698eb1bca562 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 3 Nov 2021 03:22:39 +0900
Subject: [PATCH 0664/5547] Fix beatmap download notifications not showing
 beatmap name correctly

---
 osu.Game/Beatmaps/BeatmapManager.cs             | 17 +++++++++++++++++
 .../Panels/BeatmapPanelDownloadButton.cs        |  2 +-
 .../BeatmapSet/Buttons/HeaderDownloadButton.cs  |  2 +-
 3 files changed, 19 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index 0509a9db47..0caee8f9cd 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -249,6 +249,23 @@ namespace osu.Game.Beatmaps
 
         public IBindable<WeakReference<ArchiveDownloadRequest<BeatmapSetInfo>>> DownloadFailed => beatmapModelDownloader.DownloadFailed;
 
+        // Temporary method until this class supports IBeatmapSetInfo or otherwise.
+        public bool Download(IBeatmapSetInfo model, bool minimiseDownloadSize = false)
+        {
+            return beatmapModelDownloader.Download(new BeatmapSetInfo
+            {
+                OnlineBeatmapSetID = model.OnlineID,
+                Metadata = new BeatmapMetadata
+                {
+                    Title = model.Metadata?.Title,
+                    Artist = model.Metadata?.Artist,
+                    TitleUnicode = model.Metadata?.TitleUnicode,
+                    ArtistUnicode = model.Metadata?.ArtistUnicode,
+                    Author = new User { Username = model.Metadata?.Author },
+                }
+            }, minimiseDownloadSize);
+        }
+
         public bool Download(BeatmapSetInfo model, bool minimiseDownloadSize = false)
         {
             return beatmapModelDownloader.Download(model, minimiseDownloadSize);
diff --git a/osu.Game/Overlays/BeatmapListing/Panels/BeatmapPanelDownloadButton.cs b/osu.Game/Overlays/BeatmapListing/Panels/BeatmapPanelDownloadButton.cs
index d7c2837f4d..5ed49cf384 100644
--- a/osu.Game/Overlays/BeatmapListing/Panels/BeatmapPanelDownloadButton.cs
+++ b/osu.Game/Overlays/BeatmapListing/Panels/BeatmapPanelDownloadButton.cs
@@ -86,7 +86,7 @@ namespace osu.Game.Overlays.BeatmapListing.Panels
                         break;
 
                     default:
-                        beatmaps.Download(new BeatmapSetInfo { OnlineBeatmapSetID = beatmapSet.OnlineID }, noVideoSetting.Value);
+                        beatmaps.Download(beatmapSet, noVideoSetting.Value);
                         break;
                 }
             };
diff --git a/osu.Game/Overlays/BeatmapSet/Buttons/HeaderDownloadButton.cs b/osu.Game/Overlays/BeatmapSet/Buttons/HeaderDownloadButton.cs
index 6862864c55..bd7723d3c0 100644
--- a/osu.Game/Overlays/BeatmapSet/Buttons/HeaderDownloadButton.cs
+++ b/osu.Game/Overlays/BeatmapSet/Buttons/HeaderDownloadButton.cs
@@ -108,7 +108,7 @@ namespace osu.Game.Overlays.BeatmapSet.Buttons
                     return;
                 }
 
-                beatmaps.Download(new BeatmapSetInfo { OnlineBeatmapSetID = beatmapSet.OnlineID }, noVideo);
+                beatmaps.Download(beatmapSet, noVideo);
             };
 
             localUser.BindTo(api.LocalUser);

From 8d0b32981f941173e8a3ca7f512a36f5c11e9efd Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 3 Nov 2021 03:30:15 +0900
Subject: [PATCH 0665/5547] Fix unauthenticated API requests no longer working

---
 osu.Game/Online/API/APIRequest.cs | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Online/API/APIRequest.cs b/osu.Game/Online/API/APIRequest.cs
index d60c9cfe65..eea448fee3 100644
--- a/osu.Game/Online/API/APIRequest.cs
+++ b/osu.Game/Online/API/APIRequest.cs
@@ -107,7 +107,8 @@ namespace osu.Game.Online.API
             WebRequest = CreateWebRequest();
             WebRequest.Failed += Fail;
             WebRequest.AllowRetryOnTimeout = false;
-            WebRequest.AddHeader("Authorization", $"Bearer {API.AccessToken}");
+            if (API.IsLoggedIn)
+                WebRequest.AddHeader("Authorization", $"Bearer {API.AccessToken}");
 
             if (isFailing) return;
 

From 51e92e1b2d71d9d02c9edc8974c842c9894f1507 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 3 Nov 2021 04:09:31 +0900
Subject: [PATCH 0666/5547] Check for null/empty instead

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

diff --git a/osu.Game/Online/API/APIRequest.cs b/osu.Game/Online/API/APIRequest.cs
index eea448fee3..69d72226ba 100644
--- a/osu.Game/Online/API/APIRequest.cs
+++ b/osu.Game/Online/API/APIRequest.cs
@@ -107,7 +107,7 @@ namespace osu.Game.Online.API
             WebRequest = CreateWebRequest();
             WebRequest.Failed += Fail;
             WebRequest.AllowRetryOnTimeout = false;
-            if (API.IsLoggedIn)
+            if (!string.IsNullOrEmpty(API.AccessToken))
                 WebRequest.AddHeader("Authorization", $"Bearer {API.AccessToken}");
 
             if (isFailing) return;

From 85037dfb700518a67a6236cc3ddf9d6a1df11f75 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 3 Nov 2021 04:32:21 +0900
Subject: [PATCH 0667/5547] Fix multiplayer potentially getting incorrect
 beatmap availability state after changing beatmaps

---
 .../Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs b/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs
index 6cd735af23..a642e283f9 100644
--- a/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs
+++ b/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs
@@ -53,7 +53,10 @@ namespace osu.Game.Online.Rooms
                 downloadTracker?.RemoveAndDisposeImmediately();
 
                 downloadTracker = new BeatmapDownloadTracker(item.NewValue.Beatmap.Value.BeatmapSet);
-                downloadTracker.State.BindValueChanged(_ => updateAvailability());
+
+                AddInternal(downloadTracker);
+
+                downloadTracker.State.BindValueChanged(_ => updateAvailability(), true);
                 downloadTracker.Progress.BindValueChanged(_ =>
                 {
                     if (downloadTracker.State.Value != DownloadState.Downloading)
@@ -63,9 +66,7 @@ namespace osu.Game.Online.Rooms
                     // we don't want to flood the network with this, so rate limit how often we send progress updates.
                     if (progressUpdate?.Completed != false)
                         progressUpdate = Scheduler.AddDelayed(updateAvailability, progressUpdate == null ? 0 : 500);
-                });
-
-                AddInternal(downloadTracker);
+                }, true);
             }, true);
         }
 

From 47914c49bacb3ea879e1045693757e7196916ac0 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 3 Nov 2021 04:54:36 +0900
Subject: [PATCH 0668/5547] Fix missed null consideration

---
 .../Overlays/Profile/Sections/Ranks/DrawableProfileScore.cs     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/Profile/Sections/Ranks/DrawableProfileScore.cs b/osu.Game/Overlays/Profile/Sections/Ranks/DrawableProfileScore.cs
index ca5534dbc2..fb464e1b41 100644
--- a/osu.Game/Overlays/Profile/Sections/Ranks/DrawableProfileScore.cs
+++ b/osu.Game/Overlays/Profile/Sections/Ranks/DrawableProfileScore.cs
@@ -91,7 +91,7 @@ namespace osu.Game.Overlays.Profile.Sections.Ranks
                                                 {
                                                     new OsuSpriteText
                                                     {
-                                                        Text = $"{Score.Beatmap.DifficultyName}",
+                                                        Text = $"{Score.Beatmap?.DifficultyName}",
                                                         Font = OsuFont.GetFont(size: 12, weight: FontWeight.Regular),
                                                         Colour = colours.Yellow
                                                     },

From 98367fc48295c136b77b7cdb0c8518c840ac228f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 1 Nov 2021 15:39:22 +0100
Subject: [PATCH 0669/5547] Update usages of `GetLocalised{-> Bindable}String`

---
 osu.Game/Overlays/Music/PlaylistItem.cs     | 4 ++--
 osu.Game/Screens/Select/BeatmapInfoWedge.cs | 4 ++--
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Overlays/Music/PlaylistItem.cs b/osu.Game/Overlays/Music/PlaylistItem.cs
index eea2a9dc7e..04f1f14b20 100644
--- a/osu.Game/Overlays/Music/PlaylistItem.cs
+++ b/osu.Game/Overlays/Music/PlaylistItem.cs
@@ -46,8 +46,8 @@ namespace osu.Game.Overlays.Music
             artistColour = colours.Gray9;
             HandleColour = colours.Gray5;
 
-            title = localisation.GetLocalisedString(new RomanisableString(Model.Metadata.TitleUnicode, Model.Metadata.Title));
-            artist = localisation.GetLocalisedString(new RomanisableString(Model.Metadata.ArtistUnicode, Model.Metadata.Artist));
+            title = localisation.GetLocalisedBindableString(new RomanisableString(Model.Metadata.TitleUnicode, Model.Metadata.Title));
+            artist = localisation.GetLocalisedBindableString(new RomanisableString(Model.Metadata.ArtistUnicode, Model.Metadata.Artist));
         }
 
         protected override void LoadComplete()
diff --git a/osu.Game/Screens/Select/BeatmapInfoWedge.cs b/osu.Game/Screens/Select/BeatmapInfoWedge.cs
index 2de72beaad..89eed14e6d 100644
--- a/osu.Game/Screens/Select/BeatmapInfoWedge.cs
+++ b/osu.Game/Screens/Select/BeatmapInfoWedge.cs
@@ -188,8 +188,8 @@ namespace osu.Game.Screens.Select
 
                 RelativeSizeAxes = Axes.Both;
 
-                titleBinding = localisation.GetLocalisedString(new RomanisableString(metadata.TitleUnicode, metadata.Title));
-                artistBinding = localisation.GetLocalisedString(new RomanisableString(metadata.ArtistUnicode, metadata.Artist));
+                titleBinding = localisation.GetLocalisedBindableString(new RomanisableString(metadata.TitleUnicode, metadata.Title));
+                artistBinding = localisation.GetLocalisedBindableString(new RomanisableString(metadata.ArtistUnicode, metadata.Artist));
 
                 const float top_height = 0.7f;
 

From b95c95527e94ccd8929bd6d28a0b367d4b10ebcd Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 30 Oct 2021 18:31:43 +0200
Subject: [PATCH 0670/5547] Accept `LocalisableString`s in `LinkFlowContainer`

---
 .../Graphics/Containers/LinkFlowContainer.cs  | 17 +++---------
 .../OnlinePlay/Components/BeatmapTitle.cs     | 27 ++++++-------------
 2 files changed, 11 insertions(+), 33 deletions(-)

diff --git a/osu.Game/Graphics/Containers/LinkFlowContainer.cs b/osu.Game/Graphics/Containers/LinkFlowContainer.cs
index 0b43c16ebe..7d1210d0e3 100644
--- a/osu.Game/Graphics/Containers/LinkFlowContainer.cs
+++ b/osu.Game/Graphics/Containers/LinkFlowContainer.cs
@@ -7,12 +7,10 @@ using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics.Sprites;
 using System.Collections.Generic;
-using osu.Framework.Extensions.IEnumerableExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Localisation;
 using osu.Framework.Platform;
-using osu.Game.Graphics.Sprites;
 using osu.Game.Users;
 
 namespace osu.Game.Graphics.Containers
@@ -58,23 +56,14 @@ namespace osu.Game.Graphics.Containers
             AddText(text.Substring(previousLinkEnd));
         }
 
-        public void AddLink(string text, string url, Action<SpriteText> creationParameters = null) =>
+        public void AddLink(LocalisableString text, string url, Action<SpriteText> creationParameters = null) =>
             createLink(CreateChunkFor(text, true, CreateSpriteText, creationParameters), new LinkDetails(LinkAction.External, url), url);
 
-        public void AddLink(string text, Action action, string tooltipText = null, Action<SpriteText> creationParameters = null)
+        public void AddLink(LocalisableString text, Action action, string tooltipText = null, Action<SpriteText> creationParameters = null)
             => createLink(CreateChunkFor(text, true, CreateSpriteText, creationParameters), new LinkDetails(LinkAction.Custom, string.Empty), tooltipText, action);
 
-        public void AddLink(string text, LinkAction action, string argument, string tooltipText = null, Action<SpriteText> creationParameters = null)
-            => createLink(CreateChunkFor(text, true, CreateSpriteText, creationParameters), new LinkDetails(action, argument), tooltipText);
-
         public void AddLink(LocalisableString text, LinkAction action, string argument, string tooltipText = null, Action<SpriteText> creationParameters = null)
-        {
-            var spriteText = new OsuSpriteText { Text = text };
-
-            AddText(spriteText, creationParameters);
-            RemoveInternal(spriteText); // TODO: temporary, will go away when TextParts support localisation properly.
-            createLink(new TextPartManual(spriteText.Yield()), new LinkDetails(action, argument), tooltipText);
-        }
+            => createLink(CreateChunkFor(text, true, CreateSpriteText, creationParameters), new LinkDetails(action, argument), tooltipText);
 
         public void AddLink(IEnumerable<SpriteText> text, LinkAction action, string linkArgument, string tooltipText = null)
         {
diff --git a/osu.Game/Screens/OnlinePlay/Components/BeatmapTitle.cs b/osu.Game/Screens/OnlinePlay/Components/BeatmapTitle.cs
index 2901758332..e948c1adae 100644
--- a/osu.Game/Screens/OnlinePlay/Components/BeatmapTitle.cs
+++ b/osu.Game/Screens/OnlinePlay/Components/BeatmapTitle.cs
@@ -7,7 +7,6 @@ using osu.Framework.Graphics;
 using osu.Framework.Localisation;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
-using osu.Game.Graphics.Sprites;
 using osu.Game.Online.Chat;
 
 namespace osu.Game.Screens.OnlinePlay.Components
@@ -69,24 +68,14 @@ namespace osu.Game.Screens.OnlinePlay.Components
             }
             else
             {
-                textFlow.AddLink(new[]
-                {
-                    new OsuSpriteText
-                    {
-                        Text = new RomanisableString(beatmap.Value.Metadata.ArtistUnicode, beatmap.Value.Metadata.Artist),
-                        Font = OsuFont.GetFont(size: TextSize),
-                    },
-                    new OsuSpriteText
-                    {
-                        Text = " - ",
-                        Font = OsuFont.GetFont(size: TextSize),
-                    },
-                    new OsuSpriteText
-                    {
-                        Text = new RomanisableString(beatmap.Value.Metadata.TitleUnicode, beatmap.Value.Metadata.Title),
-                        Font = OsuFont.GetFont(size: TextSize),
-                    }
-                }, LinkAction.OpenBeatmap, beatmap.Value.OnlineID.ToString(), "Open beatmap");
+                var metadataInfo = beatmap.Value.Metadata;
+
+                string artistUnicode = string.IsNullOrEmpty(metadataInfo.ArtistUnicode) ? metadataInfo.Artist : metadataInfo.ArtistUnicode;
+                string titleUnicode = string.IsNullOrEmpty(metadataInfo.TitleUnicode) ? metadataInfo.Title : metadataInfo.TitleUnicode;
+
+                var title = new RomanisableString($"{artistUnicode} - {titleUnicode}".Trim(), $"{metadataInfo.Artist} - {metadataInfo.Title}".Trim());
+
+                textFlow.AddLink(title, LinkAction.OpenBeatmap, beatmap.Value.OnlineID.ToString(), "Open beatmap");
             }
         }
     }

From ad98ab0a2644ae6da0a7062a6dd21995ca4c2a1a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 30 Oct 2021 18:31:55 +0200
Subject: [PATCH 0671/5547] Fix drawable room playlist item assuming single
 sprite text

---
 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 6f947bd398..675b5e4c04 100644
--- a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
+++ b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
@@ -111,7 +111,6 @@ namespace osu.Game.Screens.OnlinePlay
             beatmapText.AddLink(Item.Beatmap.Value.GetDisplayTitleRomanisable(), LinkAction.OpenBeatmap, Item.Beatmap.Value.OnlineBeatmapID.ToString(), null, text =>
             {
                 text.Truncate = true;
-                text.RelativeSizeAxes = Axes.X;
             });
 
             authorText.Clear();

From 11de9247047cf8f9ac3ee75280150bdd61627871 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 30 Oct 2021 18:50:13 +0200
Subject: [PATCH 0672/5547] Use `LocalisableString`s where possible to leverage
 localisable text flow

---
 osu.Game/Graphics/UserInterface/OsuCheckbox.cs          | 3 ++-
 osu.Game/Graphics/UserInterfaceV2/LabelledDrawable.cs   | 7 ++++---
 osu.Game/Online/Placeholders/ClickablePlaceholder.cs    | 3 ++-
 osu.Game/Online/Placeholders/MessagePlaceholder.cs      | 5 +++--
 osu.Game/Overlays/Dialog/PopupDialog.cs                 | 9 +++++----
 osu.Game/Overlays/Notifications/ProgressNotification.cs | 3 ++-
 osu.Game/Overlays/Notifications/SimpleNotification.cs   | 5 +++--
 osu.Game/Screens/Edit/Timing/SliderWithTextBoxInput.cs  | 3 ++-
 8 files changed, 23 insertions(+), 15 deletions(-)

diff --git a/osu.Game/Graphics/UserInterface/OsuCheckbox.cs b/osu.Game/Graphics/UserInterface/OsuCheckbox.cs
index e8f80dec57..da511d8212 100644
--- a/osu.Game/Graphics/UserInterface/OsuCheckbox.cs
+++ b/osu.Game/Graphics/UserInterface/OsuCheckbox.cs
@@ -8,6 +8,7 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Graphics.UserInterface;
 using osu.Framework.Input.Events;
+using osu.Framework.Localisation;
 using osu.Game.Graphics.Containers;
 
 namespace osu.Game.Graphics.UserInterface
@@ -19,7 +20,7 @@ namespace osu.Game.Graphics.UserInterface
         /// </summary>
         protected virtual bool PlaySoundsOnUserChange => true;
 
-        public string LabelText
+        public LocalisableString LabelText
         {
             set
             {
diff --git a/osu.Game/Graphics/UserInterfaceV2/LabelledDrawable.cs b/osu.Game/Graphics/UserInterfaceV2/LabelledDrawable.cs
index d5f76733cf..95884f1515 100644
--- a/osu.Game/Graphics/UserInterfaceV2/LabelledDrawable.cs
+++ b/osu.Game/Graphics/UserInterfaceV2/LabelledDrawable.cs
@@ -8,6 +8,7 @@ using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
+using osu.Framework.Localisation;
 using osu.Game.Graphics.Containers;
 using osu.Game.Overlays;
 using osuTK;
@@ -156,18 +157,18 @@ namespace osu.Game.Graphics.UserInterfaceV2
             descriptionText.Colour = osuColour.Yellow;
         }
 
-        public string Label
+        public LocalisableString Label
         {
             set => labelText.Text = value;
         }
 
-        public string Description
+        public LocalisableString Description
         {
             set
             {
                 descriptionText.Text = value;
 
-                if (!string.IsNullOrEmpty(value))
+                if (value == default)
                     descriptionText.Show();
                 else
                     descriptionText.Hide();
diff --git a/osu.Game/Online/Placeholders/ClickablePlaceholder.cs b/osu.Game/Online/Placeholders/ClickablePlaceholder.cs
index 936ad79c64..054a4a3c39 100644
--- a/osu.Game/Online/Placeholders/ClickablePlaceholder.cs
+++ b/osu.Game/Online/Placeholders/ClickablePlaceholder.cs
@@ -3,6 +3,7 @@
 
 using System;
 using osu.Framework.Graphics.Sprites;
+using osu.Framework.Localisation;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.UserInterface;
 
@@ -12,7 +13,7 @@ namespace osu.Game.Online.Placeholders
     {
         public Action Action;
 
-        public ClickablePlaceholder(string actionMessage, IconUsage icon)
+        public ClickablePlaceholder(LocalisableString actionMessage, IconUsage icon)
         {
             OsuTextFlowContainer textFlow;
 
diff --git a/osu.Game/Online/Placeholders/MessagePlaceholder.cs b/osu.Game/Online/Placeholders/MessagePlaceholder.cs
index 7342765ca4..1676ba6cf2 100644
--- a/osu.Game/Online/Placeholders/MessagePlaceholder.cs
+++ b/osu.Game/Online/Placeholders/MessagePlaceholder.cs
@@ -3,14 +3,15 @@
 
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Sprites;
+using osu.Framework.Localisation;
 
 namespace osu.Game.Online.Placeholders
 {
     public class MessagePlaceholder : Placeholder
     {
-        private readonly string message;
+        private readonly LocalisableString message;
 
-        public MessagePlaceholder(string message)
+        public MessagePlaceholder(LocalisableString message)
         {
             AddIcon(FontAwesome.Solid.ExclamationCircle, cp =>
             {
diff --git a/osu.Game/Overlays/Dialog/PopupDialog.cs b/osu.Game/Overlays/Dialog/PopupDialog.cs
index 78ef2ec795..0f953f92bb 100644
--- a/osu.Game/Overlays/Dialog/PopupDialog.cs
+++ b/osu.Game/Overlays/Dialog/PopupDialog.cs
@@ -10,6 +10,7 @@ using osu.Framework.Graphics.Effects;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Input.Events;
+using osu.Framework.Localisation;
 using osu.Game.Graphics.Backgrounds;
 using osu.Game.Graphics.Containers;
 using osuTK;
@@ -42,9 +43,9 @@ namespace osu.Game.Overlays.Dialog
             set => icon.Icon = value;
         }
 
-        private string headerText;
+        private LocalisableString headerText;
 
-        public string HeaderText
+        public LocalisableString HeaderText
         {
             get => headerText;
             set
@@ -57,9 +58,9 @@ namespace osu.Game.Overlays.Dialog
             }
         }
 
-        private string bodyText;
+        private LocalisableString bodyText;
 
-        public string BodyText
+        public LocalisableString BodyText
         {
             get => bodyText;
             set
diff --git a/osu.Game/Overlays/Notifications/ProgressNotification.cs b/osu.Game/Overlays/Notifications/ProgressNotification.cs
index b27e15dd2c..c44b88ad29 100644
--- a/osu.Game/Overlays/Notifications/ProgressNotification.cs
+++ b/osu.Game/Overlays/Notifications/ProgressNotification.cs
@@ -10,6 +10,7 @@ using osu.Framework.Graphics.Colour;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Graphics.Sprites;
+using osu.Framework.Localisation;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.UserInterface;
@@ -22,7 +23,7 @@ namespace osu.Game.Overlays.Notifications
     {
         private const float loading_spinner_size = 22;
 
-        public string Text
+        public LocalisableString Text
         {
             set => Schedule(() => textDrawable.Text = value);
         }
diff --git a/osu.Game/Overlays/Notifications/SimpleNotification.cs b/osu.Game/Overlays/Notifications/SimpleNotification.cs
index 3a3136b1ea..17ec12a4ca 100644
--- a/osu.Game/Overlays/Notifications/SimpleNotification.cs
+++ b/osu.Game/Overlays/Notifications/SimpleNotification.cs
@@ -7,6 +7,7 @@ using osu.Framework.Graphics.Colour;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Graphics.Sprites;
+using osu.Framework.Localisation;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osuTK;
@@ -15,9 +16,9 @@ namespace osu.Game.Overlays.Notifications
 {
     public class SimpleNotification : Notification
     {
-        private string text = string.Empty;
+        private LocalisableString text;
 
-        public string Text
+        public LocalisableString Text
         {
             get => text;
             set
diff --git a/osu.Game/Screens/Edit/Timing/SliderWithTextBoxInput.cs b/osu.Game/Screens/Edit/Timing/SliderWithTextBoxInput.cs
index 10a5771520..6c004a7c8b 100644
--- a/osu.Game/Screens/Edit/Timing/SliderWithTextBoxInput.cs
+++ b/osu.Game/Screens/Edit/Timing/SliderWithTextBoxInput.cs
@@ -6,6 +6,7 @@ using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.UserInterface;
+using osu.Framework.Localisation;
 using osu.Game.Graphics.UserInterfaceV2;
 using osu.Game.Overlays.Settings;
 
@@ -16,7 +17,7 @@ namespace osu.Game.Screens.Edit.Timing
     {
         private readonly SettingsSlider<T> slider;
 
-        public SliderWithTextBoxInput(string labelText)
+        public SliderWithTextBoxInput(LocalisableString labelText)
         {
             LabelledTextBox textbox;
 

From ed00cd9fc5b321694e4cf5854448647cd6728b18 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 30 Oct 2021 18:50:34 +0200
Subject: [PATCH 0673/5547] Remove simple localisable `.ToString()` calls

---
 osu.Game/Overlays/Changelog/ChangelogSupporterPromo.cs        | 2 +-
 .../Settings/Sections/Maintenance/DirectorySelectScreen.cs    | 2 +-
 osu.Game/Overlays/Settings/SettingsCheckbox.cs                | 3 +--
 osu.Game/Overlays/Settings/SettingsItem.cs                    | 4 ++--
 .../Screens/OnlinePlay/Lounge/Components/PlaylistCountPill.cs | 3 ++-
 5 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/osu.Game/Overlays/Changelog/ChangelogSupporterPromo.cs b/osu.Game/Overlays/Changelog/ChangelogSupporterPromo.cs
index 5cc598ae70..e84eee15be 100644
--- a/osu.Game/Overlays/Changelog/ChangelogSupporterPromo.cs
+++ b/osu.Game/Overlays/Changelog/ChangelogSupporterPromo.cs
@@ -101,7 +101,7 @@ namespace osu.Game.Overlays.Changelog
                                             t.Colour = colour.PinkLighter;
                                         })
                                         {
-                                            Text = ChangelogStrings.SupportText2.ToString(),
+                                            Text = ChangelogStrings.SupportText2,
                                             Margin = new MarginPadding { Top = 10 },
                                             RelativeSizeAxes = Axes.X,
                                             AutoSizeAxes = Axes.Y,
diff --git a/osu.Game/Overlays/Settings/Sections/Maintenance/DirectorySelectScreen.cs b/osu.Game/Overlays/Settings/Sections/Maintenance/DirectorySelectScreen.cs
index e509cac2f1..0814e3c824 100644
--- a/osu.Game/Overlays/Settings/Sections/Maintenance/DirectorySelectScreen.cs
+++ b/osu.Game/Overlays/Settings/Sections/Maintenance/DirectorySelectScreen.cs
@@ -83,7 +83,7 @@ namespace osu.Game.Overlays.Settings.Sections.Maintenance
                                     cp.Font = OsuFont.Default.With(size: 24);
                                 })
                                 {
-                                    Text = HeaderText.ToString(),
+                                    Text = HeaderText,
                                     TextAnchor = Anchor.TopCentre,
                                     Margin = new MarginPadding(10),
                                     RelativeSizeAxes = Axes.X,
diff --git a/osu.Game/Overlays/Settings/SettingsCheckbox.cs b/osu.Game/Overlays/Settings/SettingsCheckbox.cs
index 8b7ac80a5b..8a8fed4d30 100644
--- a/osu.Game/Overlays/Settings/SettingsCheckbox.cs
+++ b/osu.Game/Overlays/Settings/SettingsCheckbox.cs
@@ -16,8 +16,7 @@ namespace osu.Game.Overlays.Settings
         public override LocalisableString LabelText
         {
             get => labelText;
-            // checkbox doesn't properly support localisation yet.
-            set => ((OsuCheckbox)Control).LabelText = (labelText = value).ToString();
+            set => ((OsuCheckbox)Control).LabelText = labelText = value;
         }
     }
 }
diff --git a/osu.Game/Overlays/Settings/SettingsItem.cs b/osu.Game/Overlays/Settings/SettingsItem.cs
index b593dea576..e709be1343 100644
--- a/osu.Game/Overlays/Settings/SettingsItem.cs
+++ b/osu.Game/Overlays/Settings/SettingsItem.cs
@@ -68,7 +68,7 @@ namespace osu.Game.Overlays.Settings
         {
             set
             {
-                bool hasValue = !string.IsNullOrWhiteSpace(value.ToString());
+                bool hasValue = value != default;
 
                 if (warningText == null)
                 {
@@ -80,7 +80,7 @@ namespace osu.Game.Overlays.Settings
                 }
 
                 warningText.Alpha = hasValue ? 1 : 0;
-                warningText.Text = value.ToString(); // TODO: Remove ToString() call after TextFlowContainer supports localisation (see https://github.com/ppy/osu-framework/issues/4636).
+                warningText.Text = value ?? default;
             }
         }
 
diff --git a/osu.Game/Screens/OnlinePlay/Lounge/Components/PlaylistCountPill.cs b/osu.Game/Screens/OnlinePlay/Lounge/Components/PlaylistCountPill.cs
index 2fe3c7b668..ef2c2df4a6 100644
--- a/osu.Game/Screens/OnlinePlay/Lounge/Components/PlaylistCountPill.cs
+++ b/osu.Game/Screens/OnlinePlay/Lounge/Components/PlaylistCountPill.cs
@@ -4,6 +4,7 @@
 using System.Collections.Specialized;
 using Humanizer;
 using osu.Framework.Allocation;
+using osu.Framework.Extensions.LocalisationExtensions;
 using osu.Framework.Graphics;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
@@ -46,7 +47,7 @@ namespace osu.Game.Screens.OnlinePlay.Lounge.Components
         private void updateCount(object sender, NotifyCollectionChangedEventArgs e)
         {
             count.Clear();
-            count.AddText(Playlist.Count.ToString(), s => s.Font = s.Font.With(weight: FontWeight.Bold));
+            count.AddText(Playlist.Count.ToLocalisableString(), s => s.Font = s.Font.With(weight: FontWeight.Bold));
             count.AddText(" ");
             count.AddText("Beatmap".ToQuantity(Playlist.Count, ShowQuantityAs.None));
         }

From d218e7d935f057fc306d5be2d6e4aa9a19bbc122 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 30 Oct 2021 19:22:00 +0200
Subject: [PATCH 0674/5547] Remove manual romanisation handling in
 `PlaylistItem`

---
 osu.Game/Overlays/Music/PlaylistItem.cs | 33 +++++++++++--------------
 1 file changed, 15 insertions(+), 18 deletions(-)

diff --git a/osu.Game/Overlays/Music/PlaylistItem.cs b/osu.Game/Overlays/Music/PlaylistItem.cs
index 04f1f14b20..ce4e9e9698 100644
--- a/osu.Game/Overlays/Music/PlaylistItem.cs
+++ b/osu.Game/Overlays/Music/PlaylistItem.cs
@@ -25,9 +25,6 @@ namespace osu.Game.Overlays.Music
         private TextFlowContainer text;
         private ITextPart titlePart;
 
-        private ILocalisedBindableString title;
-        private ILocalisedBindableString artist;
-
         private Color4 selectedColour;
         private Color4 artistColour;
 
@@ -45,17 +42,12 @@ namespace osu.Game.Overlays.Music
             selectedColour = colours.Yellow;
             artistColour = colours.Gray9;
             HandleColour = colours.Gray5;
-
-            title = localisation.GetLocalisedBindableString(new RomanisableString(Model.Metadata.TitleUnicode, Model.Metadata.Title));
-            artist = localisation.GetLocalisedBindableString(new RomanisableString(Model.Metadata.ArtistUnicode, Model.Metadata.Artist));
         }
 
         protected override void LoadComplete()
         {
             base.LoadComplete();
 
-            artist.BindValueChanged(_ => recreateText(), true);
-
             SelectedSet.BindValueChanged(set =>
             {
                 if (set.OldValue?.Equals(Model) != true && set.NewValue?.Equals(Model) != true)
@@ -71,26 +63,31 @@ namespace osu.Game.Overlays.Music
                 s.FadeColour(SelectedSet.Value?.Equals(Model) == true ? selectedColour : Color4.White, instant ? 0 : FADE_DURATION);
         }
 
-        protected override Drawable CreateContent() => text = new OsuTextFlowContainer
+        protected override Drawable CreateContent()
         {
-            RelativeSizeAxes = Axes.X,
-            AutoSizeAxes = Axes.Y,
-        };
+            text = new OsuTextFlowContainer
+            {
+                RelativeSizeAxes = Axes.X,
+                AutoSizeAxes = Axes.Y,
+            };
 
-        private void recreateText()
-        {
-            text.Clear();
+            var title = new RomanisableString(Model.Metadata.TitleUnicode, Model.Metadata.Title);
+            var artist = new RomanisableString(Model.Metadata.ArtistUnicode, Model.Metadata.Artist);
 
-            // space after the title to put a space between the title and artist
-            titlePart = text.AddText(title.Value + @"  ", sprite => sprite.Font = OsuFont.GetFont(weight: FontWeight.Regular));
+            titlePart = text.AddText(title, sprite => sprite.Font = OsuFont.GetFont(weight: FontWeight.Regular));
             updateSelectionState(true);
+            titlePart.DrawablePartsRecreated += _ => updateSelectionState(true);
 
-            text.AddText(artist.Value, sprite =>
+            text.AddText(@"  "); // to separate the title from the artist.
+
+            text.AddText(artist, sprite =>
             {
                 sprite.Font = OsuFont.GetFont(size: 14, weight: FontWeight.Bold);
                 sprite.Colour = artistColour;
                 sprite.Padding = new MarginPadding { Top = 1 };
             });
+
+            return text;
         }
 
         protected override bool OnClick(ClickEvent e)

From e4e8390a8ac2138b571418f711792ab282804d01 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 1 Nov 2021 15:44:51 +0100
Subject: [PATCH 0675/5547] Update `ScreenEntry` colour usage to update
 correctly on language change

---
 osu.Game/Overlays/AccountCreation/ScreenEntry.cs | 12 ++++++++++--
 1 file changed, 10 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Overlays/AccountCreation/ScreenEntry.cs b/osu.Game/Overlays/AccountCreation/ScreenEntry.cs
index 8ee3b1cb2e..2ba8fc3ae2 100644
--- a/osu.Game/Overlays/AccountCreation/ScreenEntry.cs
+++ b/osu.Game/Overlays/AccountCreation/ScreenEntry.cs
@@ -5,7 +5,6 @@ using System;
 using System.Linq;
 using System.Threading.Tasks;
 using osu.Framework.Allocation;
-using osu.Framework.Extensions.IEnumerableExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Utils;
@@ -135,7 +134,16 @@ namespace osu.Game.Overlays.AccountCreation
             characterCheckText = passwordDescription.AddText("8 characters long");
             passwordDescription.AddText(". Choose something long but also something you will remember, like a line from your favourite song.");
 
-            passwordTextBox.Current.ValueChanged += password => { characterCheckText.Drawables.ForEach(s => s.Colour = password.NewValue.Length == 0 ? Color4.White : Interpolation.ValueAt(password.NewValue.Length, Color4.OrangeRed, Color4.YellowGreen, 0, 8, Easing.In)); };
+            passwordTextBox.Current.BindValueChanged(_ => updateCharacterCheckTextColour(), true);
+            characterCheckText.DrawablePartsRecreated += _ => updateCharacterCheckTextColour();
+        }
+
+        private void updateCharacterCheckTextColour()
+        {
+            string password = passwordTextBox.Text;
+
+            foreach (var d in characterCheckText.Drawables)
+                d.Colour = password.Length == 0 ? Color4.White : Interpolation.ValueAt(password.Length, Color4.OrangeRed, Color4.YellowGreen, 0, 8, Easing.In);
         }
 
         public override void OnEntering(IScreen last)

From 195a141625d38018debc744089dcdc4578cfc808 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 2 Nov 2021 22:51:25 +0100
Subject: [PATCH 0676/5547] Fix score tracker not tracking non-online scores
 correctly

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

diff --git a/osu.Game/Online/ScoreDownloadTracker.cs b/osu.Game/Online/ScoreDownloadTracker.cs
index 675dbf608c..e679071ac1 100644
--- a/osu.Game/Online/ScoreDownloadTracker.cs
+++ b/osu.Game/Online/ScoreDownloadTracker.cs
@@ -35,7 +35,11 @@ namespace osu.Game.Online
                 return;
 
             // Used to interact with manager classes that don't support interface types. Will eventually be replaced.
-            var scoreInfo = new ScoreInfo { OnlineScoreID = TrackedItem.OnlineScoreID };
+            var scoreInfo = new ScoreInfo
+            {
+                ID = TrackedItem.ID,
+                OnlineScoreID = TrackedItem.OnlineScoreID
+            };
 
             if (Manager.IsAvailableLocally(scoreInfo))
                 UpdateState(DownloadState.LocallyAvailable);

From 494d582830fac10f7bc036cbf87c8b5789471061 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 2 Nov 2021 23:19:45 +0100
Subject: [PATCH 0677/5547] Fix `PlaylistItem` attempting to read from
 `OsuColour` dependency too early

---
 osu.Game/Overlays/Music/PlaylistItem.cs | 28 ++++++++++++-------------
 1 file changed, 13 insertions(+), 15 deletions(-)

diff --git a/osu.Game/Overlays/Music/PlaylistItem.cs b/osu.Game/Overlays/Music/PlaylistItem.cs
index ce4e9e9698..04c12b8cd7 100644
--- a/osu.Game/Overlays/Music/PlaylistItem.cs
+++ b/osu.Game/Overlays/Music/PlaylistItem.cs
@@ -25,8 +25,8 @@ namespace osu.Game.Overlays.Music
         private TextFlowContainer text;
         private ITextPart titlePart;
 
-        private Color4 selectedColour;
-        private Color4 artistColour;
+        [Resolved]
+        private OsuColour colours { get; set; }
 
         public PlaylistItem(BeatmapSetInfo item)
             : base(item)
@@ -37,10 +37,8 @@ namespace osu.Game.Overlays.Music
         }
 
         [BackgroundDependencyLoader]
-        private void load(OsuColour colours, LocalisationManager localisation)
+        private void load()
         {
-            selectedColour = colours.Yellow;
-            artistColour = colours.Gray9;
             HandleColour = colours.Gray5;
         }
 
@@ -60,16 +58,18 @@ namespace osu.Game.Overlays.Music
         private void updateSelectionState(bool instant)
         {
             foreach (Drawable s in titlePart.Drawables)
-                s.FadeColour(SelectedSet.Value?.Equals(Model) == true ? selectedColour : Color4.White, instant ? 0 : FADE_DURATION);
+                s.FadeColour(SelectedSet.Value?.Equals(Model) == true ? colours.Yellow : Color4.White, instant ? 0 : FADE_DURATION);
         }
 
-        protected override Drawable CreateContent()
+        protected override Drawable CreateContent() => text = new OsuTextFlowContainer
         {
-            text = new OsuTextFlowContainer
-            {
-                RelativeSizeAxes = Axes.X,
-                AutoSizeAxes = Axes.Y,
-            };
+            RelativeSizeAxes = Axes.X,
+            AutoSizeAxes = Axes.Y,
+        };
+
+        protected override void LoadAsyncComplete()
+        {
+            base.LoadAsyncComplete();
 
             var title = new RomanisableString(Model.Metadata.TitleUnicode, Model.Metadata.Title);
             var artist = new RomanisableString(Model.Metadata.ArtistUnicode, Model.Metadata.Artist);
@@ -83,11 +83,9 @@ namespace osu.Game.Overlays.Music
             text.AddText(artist, sprite =>
             {
                 sprite.Font = OsuFont.GetFont(size: 14, weight: FontWeight.Bold);
-                sprite.Colour = artistColour;
+                sprite.Colour = colours.Gray9;
                 sprite.Padding = new MarginPadding { Top = 1 };
             });
-
-            return text;
         }
 
         protected override bool OnClick(ClickEvent e)

From 75e89f17add1e7fe3a4dccf7a1a25775c58d8329 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 3 Nov 2021 00:07:03 +0100
Subject: [PATCH 0678/5547] Rewrite `BeatmapCardContentBackground`

---
 .../Beatmaps/Drawables/Cards/BeatmapCard.cs   |   3 +-
 .../Cards/BeatmapCardContentBackground.cs     | 130 +++++-------------
 2 files changed, 39 insertions(+), 94 deletions(-)

diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
index b1fe381410..20c5359320 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
@@ -94,10 +94,9 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                     Masking = true,
                     Children = new Drawable[]
                     {
-                        mainContentBackground = new BeatmapCardContentBackground
+                        mainContentBackground = new BeatmapCardContentBackground(beatmapSet)
                         {
                             RelativeSizeAxes = Axes.Both,
-                            BeatmapSet = beatmapSet,
                         },
                         new FillFlowContainer
                         {
diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardContentBackground.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardContentBackground.cs
index 88c9d771ac..392f5d1bfa 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardContentBackground.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardContentBackground.cs
@@ -3,7 +3,6 @@
 
 #nullable enable
 
-using System;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
@@ -14,112 +13,59 @@ using osu.Game.Overlays;
 
 namespace osu.Game.Beatmaps.Drawables.Cards
 {
-    public class BeatmapCardContentBackground : ModelBackedDrawable<IBeatmapSetOnlineInfo>
+    public class BeatmapCardContentBackground : CompositeDrawable
     {
-        public IBeatmapSetOnlineInfo BeatmapSet
+        public BindableBool Dimmed { get; } = new BindableBool();
+
+        private readonly Box background;
+        private readonly DelayedLoadUnloadWrapper cover;
+
+        [Resolved]
+        private OverlayColourProvider colourProvider { get; set; } = null!;
+
+        public BeatmapCardContentBackground(IBeatmapSetOnlineInfo onlineInfo)
         {
-            get => Model;
-            set => Model = value;
+            InternalChildren = new Drawable[]
+            {
+                background = new Box
+                {
+                    RelativeSizeAxes = Axes.Both,
+                },
+                cover = new DelayedLoadUnloadWrapper(() => createCover(onlineInfo), 500, 500)
+                {
+                    RelativeSizeAxes = Axes.Both,
+                    Colour = Colour4.Transparent
+                }
+            };
         }
 
-        public new bool Masking
+        private static Drawable createCover(IBeatmapSetOnlineInfo onlineInfo) => new OnlineBeatmapSetCover(onlineInfo)
         {
-            get => base.Masking;
-            set => base.Masking = value;
-        }
-
-        public BindableBool Dimmed { get; private set; } = new BindableBool();
-
-        protected override double LoadDelay => 500;
-
-        protected override double TransformDuration => 400;
+            RelativeSizeAxes = Axes.Both,
+            Anchor = Anchor.Centre,
+            Origin = Anchor.Centre,
+            FillMode = FillMode.Fill
+        };
 
         [BackgroundDependencyLoader]
         private void load(OverlayColourProvider colourProvider)
         {
-            InternalChild = new Box
-            {
-                RelativeSizeAxes = Axes.Both,
-                Colour = colourProvider.Background2
-            };
+            background.Colour = colourProvider.Background2;
         }
 
-        protected override DelayedLoadWrapper CreateDelayedLoadWrapper(Func<Drawable> createContentFunc, double timeBeforeLoad)
-            => new DelayedLoadUnloadWrapper(createContentFunc, timeBeforeLoad);
-
-        protected override Drawable? CreateDrawable(IBeatmapSetOnlineInfo? model)
+        protected override void LoadComplete()
         {
-            if (model == null)
-                return null;
-
-            return new BufferedBackground(model)
-            {
-                RelativeSizeAxes = Axes.Both,
-                Dimmed = { BindTarget = Dimmed }
-            };
+            base.LoadComplete();
+            Dimmed.BindValueChanged(_ => updateState(), true);
+            FinishTransforms(true);
         }
 
-        private class BufferedBackground : BufferedContainer
+        private void updateState() => Schedule(() =>
         {
-            public BindableBool Dimmed { get; } = new BindableBool();
+            background.FadeColour(Dimmed.Value ? colourProvider.Background4 : colourProvider.Background2, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
 
-            private readonly IBeatmapSetOnlineInfo onlineInfo;
-
-            private readonly Box background;
-            private OnlineBeatmapSetCover? cover;
-
-            [Resolved]
-            private OverlayColourProvider colourProvider { get; set; } = null!;
-
-            public BufferedBackground(IBeatmapSetOnlineInfo onlineInfo)
-            {
-                this.onlineInfo = onlineInfo;
-
-                RelativeSizeAxes = Axes.Both;
-                InternalChild = background = new Box
-                {
-                    RelativeSizeAxes = Axes.Both,
-                };
-            }
-
-            [BackgroundDependencyLoader]
-            private void load()
-            {
-                background.Colour = colourProvider.Background2;
-
-                LoadComponentAsync(new OnlineBeatmapSetCover(onlineInfo)
-                {
-                    RelativeSizeAxes = Axes.Both,
-                    Anchor = Anchor.Centre,
-                    Origin = Anchor.Centre,
-                    FillMode = FillMode.Fill
-                }, loaded =>
-                {
-                    cover = loaded;
-                    cover.Colour = Colour4.Transparent;
-                    AddInternal(cover);
-                    FinishTransforms(true);
-                    updateState();
-                });
-            }
-
-            protected override void LoadComplete()
-            {
-                base.LoadComplete();
-                Dimmed.BindValueChanged(_ => updateState(), true);
-                FinishTransforms(true);
-            }
-
-            private void updateState()
-            {
-                if (cover == null)
-                    return;
-
-                background.FadeColour(Dimmed.Value ? colourProvider.Background4 : colourProvider.Background2, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
-
-                var gradient = ColourInfo.GradientHorizontal(Colour4.White.Opacity(0), Colour4.White.Opacity(0.2f));
-                cover.FadeColour(gradient, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
-            }
-        }
+            var gradient = ColourInfo.GradientHorizontal(Colour4.White.Opacity(0), Colour4.White.Opacity(0.2f));
+            cover.FadeColour(gradient, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
+        });
     }
 }

From 1813681fac0c0ae3407eb3cbfd2d7e04e95533b0 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 3 Nov 2021 00:10:50 +0100
Subject: [PATCH 0679/5547] Move private method below protected

---
 osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
index 20c5359320..8136ebbd70 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
@@ -247,12 +247,6 @@ namespace osu.Game.Beatmaps.Drawables.Cards
             FinishTransforms(true);
         }
 
-        private LocalisableString createArtistText()
-        {
-            var romanisableArtist = new RomanisableString(beatmapSet.ArtistUnicode, beatmapSet.Artist);
-            return BeatmapsetsStrings.ShowDetailsByArtist(romanisableArtist);
-        }
-
         protected override bool OnHover(HoverEvent e)
         {
             updateState();
@@ -265,6 +259,12 @@ namespace osu.Game.Beatmaps.Drawables.Cards
             base.OnHoverLost(e);
         }
 
+        private LocalisableString createArtistText()
+        {
+            var romanisableArtist = new RomanisableString(beatmapSet.ArtistUnicode, beatmapSet.Artist);
+            return BeatmapsetsStrings.ShowDetailsByArtist(romanisableArtist);
+        }
+
         private void updateState()
         {
             float targetWidth = width - height;

From 601b218119ff45ffe54c300b87312d747ae76864 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 3 Nov 2021 16:45:16 +0900
Subject: [PATCH 0680/5547] Add test coverage for characters which are invalid
 in zip storage

---
 .../Beatmaps/IO/ImportBeatmapTest.cs          | 36 +++++++++++++++++++
 1 file changed, 36 insertions(+)

diff --git a/osu.Game.Tests/Beatmaps/IO/ImportBeatmapTest.cs b/osu.Game.Tests/Beatmaps/IO/ImportBeatmapTest.cs
index 935194db58..d68d43c998 100644
--- a/osu.Game.Tests/Beatmaps/IO/ImportBeatmapTest.cs
+++ b/osu.Game.Tests/Beatmaps/IO/ImportBeatmapTest.cs
@@ -846,6 +846,42 @@ namespace osu.Game.Tests.Beatmaps.IO
             }
         }
 
+        // TODO: needs to be pulled across to realm implementation when this file is nuked.
+        [Test]
+        public void TestSaveRemovesInvalidCharactersFromPath()
+        {
+            // unfortunately for the time being we need to reference osu.Framework.Desktop for a game host here.
+            using (HeadlessGameHost host = new CleanRunHeadlessGameHost(nameof(ImportBeatmapTest)))
+            {
+                try
+                {
+                    var osu = LoadOsuIntoHost(host);
+
+                    var manager = osu.Dependencies.Get<BeatmapManager>();
+
+                    var working = manager.CreateNew(new OsuRuleset().RulesetInfo, User.SYSTEM_USER);
+
+                    var beatmap = working.Beatmap;
+
+                    beatmap.BeatmapInfo.Version = "difficulty";
+                    beatmap.BeatmapInfo.Metadata = new BeatmapMetadata
+                    {
+                        Artist = "Artist/With\\Slashes",
+                        Title = "Title",
+                        AuthorString = "mapper",
+                    };
+
+                    manager.Save(beatmap.BeatmapInfo, working.Beatmap);
+
+                    Assert.AreEqual("Artist_With_Slashes - Title (mapper) [difficulty].osu", beatmap.BeatmapInfo.Path);
+                }
+                finally
+                {
+                    host.Exit();
+                }
+            }
+        }
+
         [Test]
         public void TestCreateNewEmptyBeatmap()
         {

From ca438a102d9f2d006d4085317fdadcfb1c358382 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 3 Nov 2021 16:46:05 +0900
Subject: [PATCH 0681/5547] Fix beatmap paths including invalid slash/backslash
 characters

---
 osu.Game/Beatmaps/BeatmapManager.cs      |  3 ++-
 osu.Game/Beatmaps/BeatmapModelManager.cs |  3 ++-
 osu.Game/Database/ArchiveModelManager.cs | 12 +++++++++---
 3 files changed, 13 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index 0caee8f9cd..2fa8bd4990 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -114,7 +114,8 @@ namespace osu.Game.Beatmaps
         /// <param name="info">The <see cref="BeatmapInfo"/> to save the content against. The file referenced by <see cref="BeatmapInfo.Path"/> will be replaced.</param>
         /// <param name="beatmapContent">The <see cref="IBeatmap"/> content to write.</param>
         /// <param name="beatmapSkin">The beatmap <see cref="ISkin"/> content to write, null if to be omitted.</param>
-        public virtual void Save(BeatmapInfo info, IBeatmap beatmapContent, ISkin beatmapSkin = null) => beatmapModelManager.Save(info, beatmapContent, beatmapSkin);
+        public virtual void Save(BeatmapInfo info, IBeatmap beatmapContent, ISkin beatmapSkin = null) =>
+            beatmapModelManager.Save(info, beatmapContent, beatmapSkin);
 
         /// <summary>
         /// Returns a list of all usable <see cref="BeatmapSetInfo"/>s.
diff --git a/osu.Game/Beatmaps/BeatmapModelManager.cs b/osu.Game/Beatmaps/BeatmapModelManager.cs
index 16cf6193f9..f148d05aca 100644
--- a/osu.Game/Beatmaps/BeatmapModelManager.cs
+++ b/osu.Game/Beatmaps/BeatmapModelManager.cs
@@ -216,7 +216,8 @@ namespace osu.Game.Beatmaps
                     var fileInfo = setInfo.Files.SingleOrDefault(f => string.Equals(f.Filename, beatmapInfo.Path, StringComparison.OrdinalIgnoreCase)) ?? new BeatmapSetFileInfo();
 
                     // metadata may have changed; update the path with the standard format.
-                    beatmapInfo.Path = $"{metadata.Artist} - {metadata.Title} ({metadata.Author}) [{beatmapInfo.Version}].osu";
+                    beatmapInfo.Path = GetValidFilename($"{metadata.Artist} - {metadata.Title} ({metadata.Author}) [{beatmapInfo.Version}].osu");
+
                     beatmapInfo.MD5Hash = stream.ComputeMD5Hash();
 
                     // update existing or populate new file's filename.
diff --git a/osu.Game/Database/ArchiveModelManager.cs b/osu.Game/Database/ArchiveModelManager.cs
index 49c9ac5c65..4e40e52051 100644
--- a/osu.Game/Database/ArchiveModelManager.cs
+++ b/osu.Game/Database/ArchiveModelManager.cs
@@ -466,7 +466,7 @@ namespace osu.Game.Database
             if (retrievedItem == null)
                 throw new ArgumentException(@"Specified model could not be found", nameof(item));
 
-            string filename = $"{getValidFilename(item.ToString())}{HandledExtensions.First()}";
+            string filename = $"{GetValidFilename(item.ToString())}{HandledExtensions.First()}";
 
             using (var stream = exportStorage.GetStream(filename, FileAccess.Write, FileMode.Create))
                 ExportModelTo(retrievedItem, stream);
@@ -913,9 +913,15 @@ namespace osu.Game.Database
             return Guid.NewGuid().ToString();
         }
 
-        private string getValidFilename(string filename)
+        private readonly char[] invalidFilenameCharacters = Path.GetInvalidFileNameChars()
+                                                                // Backslash is added to avoid issues when exporting to zip.
+                                                                // See SharpCompress filename normalisation https://github.com/adamhathcock/sharpcompress/blob/a1e7c0068db814c9aa78d86a94ccd1c761af74bd/src/SharpCompress/Writers/Zip/ZipWriter.cs#L143.
+                                                                .Append('\\')
+                                                                .ToArray();
+
+        protected string GetValidFilename(string filename)
         {
-            foreach (char c in Path.GetInvalidFileNameChars())
+            foreach (char c in invalidFilenameCharacters)
                 filename = filename.Replace(c, '_');
             return filename;
         }

From 8d40d55d933eb45ea5a30582d38e23a6ccb3d17d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 3 Nov 2021 17:09:49 +0900
Subject: [PATCH 0682/5547] Update framework

---
 osu.Android.props        | 2 +-
 osu.Game/osu.Game.csproj | 2 +-
 osu.iOS.props            | 4 ++--
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Android.props b/osu.Android.props
index dec994bcb2..4887e3a95f 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -52,7 +52,7 @@
   </ItemGroup>
   <ItemGroup>
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1026.0" />
-    <PackageReference Include="ppy.osu.Framework.Android" Version="2021.1029.0" />
+    <PackageReference Include="ppy.osu.Framework.Android" Version="2021.1103.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
     <!-- Realm needs to be directly referenced in all Xamarin projects, as it will not pull in its transitive dependencies otherwise. -->
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index c1c3336b5c..972d64a997 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="10.6.0" />
-    <PackageReference Include="ppy.osu.Framework" Version="2021.1029.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2021.1103.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1026.0" />
     <PackageReference Include="Sentry" Version="3.10.0" />
     <PackageReference Include="SharpCompress" Version="0.30.0" />
diff --git a/osu.iOS.props b/osu.iOS.props
index 0baf067a63..f6e4f61fde 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -70,7 +70,7 @@
     <Reference Include="System.Net.Http" />
   </ItemGroup>
   <ItemGroup Label="Package References">
-    <PackageReference Include="ppy.osu.Framework.iOS" Version="2021.1029.0" />
+    <PackageReference Include="ppy.osu.Framework.iOS" Version="2021.1103.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1026.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net5.0 / net6.0) -->
@@ -93,7 +93,7 @@
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="2.2.6" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.Core" Version="2.2.6" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
-    <PackageReference Include="ppy.osu.Framework" Version="2021.1029.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2021.1103.0" />
     <PackageReference Include="SharpCompress" Version="0.30.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
     <PackageReference Include="SharpRaven" Version="2.4.0" />

From 9afca5c5b62173d8deee5811ef58de10f6abb318 Mon Sep 17 00:00:00 2001
From: Xexxar <xexxar.xexxar@gmail.com>
Date: Wed, 3 Nov 2021 15:38:23 +0000
Subject: [PATCH 0683/5547] rewrote slider algorithm to be based on leniency
 and stored current cursor positions

---
 .../Preprocessing/OsuDifficultyHitObject.cs   | 63 +++++++++++++------
 1 file changed, 43 insertions(+), 20 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
index 8722b85839..fd14f664d8 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
@@ -93,37 +93,60 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
 
                 int repeatCount = 0;
 
+                Vector2 currSliderPosition = ((OsuHitObject)lastSlider.NestedHitObjects[0]).StackedPosition;
+
                 for (int i = 1; i < lastSlider.NestedHitObjects.Count; i++)
                 {
-                    Vector2 currSlider = Vector2.Subtract(((OsuHitObject)lastSlider.NestedHitObjects[i]).StackedPosition, ((OsuHitObject)lastSlider.NestedHitObjects[i - 1]).StackedPosition);
+                    Vector2 currSlider = Vector2.Subtract(((OsuHitObject)lastSlider.NestedHitObjects[i]).StackedPosition, currSliderPosition);
+                    double currSliderLength = currSlider.Length * scalingFactor;
 
-                    if ((OsuHitObject)lastSlider.NestedHitObjects[i] is SliderRepeat && (OsuHitObject)lastSlider.NestedHitObjects[i - 1] is SliderRepeat)
+                    if ((OsuHitObject)lastSlider.NestedHitObjects[i] is SliderEndCircle && !((OsuHitObject)lastSlider.NestedHitObjects[i] is SliderRepeat))
                     {
-                        repeatCount++;
-                        TravelDistance += Math.Max(0, currSlider.Length * scalingFactor - 240); // remove 240 distance to avoid buffing overlapping followcircles.
+                        Vector2 possSlider = Vector2.Subtract((Vector2)lastSlider.LazyEndPosition, currSliderPosition);
+                        if (possSlider.Length < currSlider.Length)
+                            currSlider = possSlider; // Take the least distance from slider end vs lazy end.
+
+                        currSliderLength = currSlider.Length * scalingFactor;
+                    }
+
+                    if ((OsuHitObject)lastSlider.NestedHitObjects[i] is SliderTick)
+                    {
+                        if (currSliderLength > 120)
+                        {
+                            currSliderPosition = Vector2.Add(currSliderPosition, Vector2.Multiply(currSlider, (float)((currSliderLength - 120) / currSliderLength)));
+                            currSliderLength *= (currSliderLength - 120) / currSliderLength;
+                        }
+                        else
+                            currSliderLength = 0;
                     }
                     else if ((OsuHitObject)lastSlider.NestedHitObjects[i] is SliderRepeat)
                     {
-                        repeatCount++;
-                        TravelDistance += Math.Max(0, currSlider.Length * scalingFactor - 120); // remove 120 distance to avoid buffing overlapping followcircles.
-                    }
-                    else if ((OsuHitObject)lastSlider.NestedHitObjects[i] is SliderEndCircle)
-                    {
-                        Vector2 possSlider = Vector2.Subtract((Vector2)lastSlider.LazyEndPosition, ((OsuHitObject)lastSlider.NestedHitObjects[i - 1]).StackedPosition);
-                        TravelDistance += Math.Min(possSlider.Length, currSlider.Length) * scalingFactor; // Take the least distance from slider end vs lazy end.
+                        if (currSliderLength > 50)
+                        {
+                            currSliderPosition = Vector2.Add(currSliderPosition, Vector2.Multiply(currSlider, (float)((currSliderLength - 50) / currSliderLength)));
+                            currSliderLength *= (currSliderLength - 50) / currSliderLength;
+                        }
+                        else
+                            currSliderLength = 0;
                     }
                     else
-                        TravelDistance += Math.Max(0, currSlider.Length * scalingFactor - 100); // remove 100 distance to avoid buffing overlapping ticks, mostly needed to prevent buffing slow sliders with high tick rate.
+                    {
+                        if (currSliderLength > 0)
+                        {
+                            currSliderPosition = Vector2.Add(currSliderPosition, Vector2.Multiply(currSlider, (float)((currSliderLength - 0) / currSliderLength)));
+                            currSliderLength *= (currSliderLength - 0) / currSliderLength;
+                        }
+                        else
+                            currSliderLength = 0;
+                    }
+
+                    if ((OsuHitObject)lastSlider.NestedHitObjects[i] is SliderRepeat)
+                        repeatCount++;
+
+                    TravelDistance += currSliderLength;
                 }
 
-                if (repeatCount == 0)
-                {
-                    TravelDistance = Math.Max(TravelDistance, scalingFactor * // idea here is to prevent ticks from dropping difficulty of slider by removing distance in calculation.
-                                              Math.Min(Vector2.Subtract(((OsuHitObject)lastSlider.NestedHitObjects[lastSlider.NestedHitObjects.Count - 1]).StackedPosition, ((OsuHitObject)lastSlider.NestedHitObjects[0]).StackedPosition).Length,
-                                                       Vector2.Subtract((Vector2)lastSlider.LazyEndPosition, ((OsuHitObject)lastSlider.NestedHitObjects[0]).StackedPosition).Length));
-                }
-                else
-                    TravelDistance *= Math.Pow(1 + repeatCount / 2.0, 1.0 / 2.0); // Bonus for repeat sliders until a better per nested object strain system can be achieved.
+                TravelDistance *= Math.Pow(1 + repeatCount / 2.5, 1.0 / 2.5); // Bonus for repeat sliders until a better per nested object strain system can be achieved.
             }
 
             Vector2 lastCursorPosition = getEndCursorPosition(lastObject);

From d74e18153108cb893c027c44ea3b8373844aaf32 Mon Sep 17 00:00:00 2001
From: Xexxar <xexxar.xexxar@gmail.com>
Date: Wed, 3 Nov 2021 15:54:49 +0000
Subject: [PATCH 0684/5547] renamed prev to last

---
 osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
index 8f6a92a3a9..3bdb397909 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
@@ -102,16 +102,16 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
 
             if (Math.Max(prevVelocity, currVelocity) != 0)
             {
-                prevVelocity = (osuPrevObj.JumpDistance + osuPrevObj.TravelDistance) / osuPrevObj.StrainTime; // We want to use the average velocity when awarding differences, not necessarily combined.
+                prevVelocity = (osuLastObj.JumpDistance + osuLastObj.TravelDistance) / osuLastObj.StrainTime; // We want to use the average velocity when awarding differences, not necessarily combined.
                 currVelocity = (osuCurrObj.JumpDistance + osuCurrObj.TravelDistance) / osuCurrObj.StrainTime;
 
                 velChangeBonus = Math.Max(Math.Abs(prevVelocity - currVelocity) // reward for % distance slowed down compared to previous, paying attention to not award overlap
                                           * Math.Pow(Math.Sin(Math.PI / 2 * Math.Min(1, osuCurrObj.JumpDistance / 100)), 2) // do not award overlap
                                           * Math.Pow(Math.Sin(Math.PI / 2 * Math.Abs(prevVelocity - currVelocity) / Math.Max(prevVelocity, currVelocity)), 2), // scale with ratio of difference compared to max
-                                          Math.Min(125 / Math.Min(osuCurrObj.StrainTime, osuPrevObj.StrainTime), Math.Abs(prevVelocity - currVelocity)) // reward for % distance up to 125 / strainTime for overlaps where velocity is still changing.
+                                          Math.Min(125 / Math.Min(osuCurrObj.StrainTime, osuLastObj.StrainTime), Math.Abs(prevVelocity - currVelocity)) // reward for % distance up to 125 / strainTime for overlaps where velocity is still changing.
                                           * Math.Pow(Math.Sin(Math.PI / 2 * Math.Abs(prevVelocity - currVelocity) / Math.Max(prevVelocity, currVelocity)), 2)); // scale with ratio of difference compared to max
 
-                velChangeBonus *= Math.Pow(Math.Min(osuCurrObj.StrainTime, osuPrevObj.StrainTime) / Math.Max(osuCurrObj.StrainTime, osuPrevObj.StrainTime), 2); // penalize for rhythm changes.
+                velChangeBonus *= Math.Pow(Math.Min(osuCurrObj.StrainTime, osuLastObj.StrainTime) / Math.Max(osuCurrObj.StrainTime, osuLastObj.StrainTime), 2); // penalize for rhythm changes.
             }
 
             if (osuCurrObj.TravelTime != 0)

From 8fdffbf08f75fc8786a4753384ac3e7f01c6319b Mon Sep 17 00:00:00 2001
From: Xexxar <xexxar.xexxar@gmail.com>
Date: Wed, 3 Nov 2021 16:02:23 +0000
Subject: [PATCH 0685/5547] adjusted global multiplier to better balance values
 against inflation

---
 osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
index cab06bf27a..2394195c84 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
@@ -43,7 +43,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty
             countMiss = Score.Statistics.GetValueOrDefault(HitResult.Miss);
             effectiveMissCount = calculateEffectiveMissCount();
 
-            double multiplier = 1.12; // This is being adjusted to keep the final pp value scaled around what it used to be when changing things.
+            double multiplier = 1.08; // This is being adjusted to keep the final pp value scaled around what it used to be when changing things.
 
             // Custom multipliers for NoFail and SpunOut.
             if (mods.Any(m => m is OsuModNoFail))

From 7fc60a840ec11f232a6131756411731008765b72 Mon Sep 17 00:00:00 2001
From: Xexxar <xexxar.xexxar@gmail.com>
Date: Wed, 3 Nov 2021 16:14:45 +0000
Subject: [PATCH 0686/5547] added radial leniency to movementdistance

---
 .../Difficulty/Preprocessing/OsuDifficultyHitObject.cs        | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
index 7db14e3e77..9be61ba506 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
@@ -157,7 +157,9 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
                 // For hitobjects which continue in the direction of the slider, the player will normally follow through the slider,
                 // such that they're not jumping from the lazy position but rather from very close to (or the end of) the slider.
                 // In such cases, a leniency is applied by also considering the jump distance from the tail of the slider, and taking the minimum jump distance.
-                MovementDistance = Math.Min(JumpDistance, tailJumpDistance);
+                // Additional distance is removed based on position of jump relative to slider follow circle radius.
+                // JumpDistance is 50 since follow radius = 1.4 * radius. tailJumpDistance is 120 since the full distance of radial leniency is still possible.
+                MovementDistance = Math.Max(0, Math.Min(JumpDistance - 50, tailJumpDistance - 120));
             }
             else
             {

From 93ed97d11ef85f425f80614b5a92df5cda26a8c6 Mon Sep 17 00:00:00 2001
From: Xexxar <xexxar.xexxar@gmail.com>
Date: Wed, 3 Nov 2021 16:16:09 +0000
Subject: [PATCH 0687/5547] increased global multiplier due to adjustment to
 sliders

---
 osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
index 2394195c84..efc7cf2767 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
@@ -43,7 +43,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty
             countMiss = Score.Statistics.GetValueOrDefault(HitResult.Miss);
             effectiveMissCount = calculateEffectiveMissCount();
 
-            double multiplier = 1.08; // This is being adjusted to keep the final pp value scaled around what it used to be when changing things.
+            double multiplier = 1.1; // This is being adjusted to keep the final pp value scaled around what it used to be when changing things.
 
             // Custom multipliers for NoFail and SpunOut.
             if (mods.Any(m => m is OsuModNoFail))

From 6e33fa088f0d5dd83dddd282197b4b1c8b2a0b10 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 3 Nov 2021 17:32:18 +0100
Subject: [PATCH 0688/5547] Add test case for drawable room with too long
 beatmap name

---
 .../Multiplayer/TestSceneDrawableRoom.cs      | 30 +++++++++++++++++++
 1 file changed, 30 insertions(+)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoom.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoom.cs
index 22ff2b98ce..84a6e95883 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoom.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoom.cs
@@ -67,6 +67,36 @@ namespace osu.Game.Tests.Visual.Multiplayer
                             }
                         }),
                         createLoungeRoom(new Room
+                        {
+                            Name = { Value = "Multiplayer room" },
+                            Status = { Value = new RoomStatusOpen() },
+                            EndDate = { Value = DateTimeOffset.Now.AddDays(1) },
+                            Type = { Value = MatchType.HeadToHead },
+                            Playlist =
+                            {
+                                new PlaylistItem
+                                {
+                                    Beatmap =
+                                    {
+                                        Value = new TestBeatmap(new OsuRuleset().RulesetInfo)
+                                        {
+                                            BeatmapInfo =
+                                            {
+                                                StarDifficulty = 2.5,
+                                                Metadata =
+                                                {
+                                                    Artist = "very very very very very very very very very long artist",
+                                                    ArtistUnicode = "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",
+                                                }
+                                            }
+                                        }.BeatmapInfo,
+                                    }
+                                }
+                            }
+                        }),
+                        createLoungeRoom(new Room
                         {
                             Name = { Value = "Playlist room with multiple beatmaps" },
                             Status = { Value = new RoomStatusPlaying() },

From a32c97427d21ccf7ec04a5a9c6506c4b1dd229b4 Mon Sep 17 00:00:00 2001
From: Xexxar <xexxar.xexxar@gmail.com>
Date: Wed, 3 Nov 2021 16:36:39 +0000
Subject: [PATCH 0689/5547] set angleBonus to take max of acute and wide
 multipliers

---
 osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
index 8a18d71a47..e64cdbfa1d 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
@@ -94,7 +94,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
                     wideAngleBonus *= angleBonus * (1 - Math.Min(wideAngleBonus, Math.Pow(calcWideAngleBonus(lastAngle), 3))); // Penalize wide angles if they're repeated, reducing the penalty as the lastAngle gets more acute.
                     acuteAngleBonus *= 0.5 + 0.5 * (1 - Math.Min(acuteAngleBonus, Math.Pow(calcAcuteAngleBonus(lastLastAngle), 3))); // Penalize acute angles if they're repeated, reducing the penalty as the lastLastAngle gets more obtuse.
 
-                    angleBonus = acuteAngleBonus * acute_angle_multiplier + wideAngleBonus * wide_angle_multiplier; // add the angle buffs together.
+                    angleBonus = Math.Max(acuteAngleBonus * acute_angle_multiplier, wideAngleBonus * wide_angle_multiplier); // Take the max of the multipliers.
                 }
             }
 

From 8e0d845f212e6a3f6ec40016f692ca96772b0f61 Mon Sep 17 00:00:00 2001
From: Xexxar <xexxar.xexxar@gmail.com>
Date: Wed, 3 Nov 2021 16:39:05 +0000
Subject: [PATCH 0690/5547] added small length component to ARbuffs

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

diff --git a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
index efc7cf2767..4c1b81a692 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
@@ -113,7 +113,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty
             else if (Attributes.ApproachRate < 8.0)
                 approachRateFactor = 0.1 * (8.0 - Attributes.ApproachRate);
 
-            aimValue *= 1.0 + approachRateFactor;
+            aimValue *= 1.0 + approachRateFactor * lengthBonus; // Buff for longer maps with high AR.
 
             if (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);
@@ -152,7 +152,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty
             if (Attributes.ApproachRate > 10.33)
                 approachRateFactor = 0.3 * (Attributes.ApproachRate - 10.33);
 
-            speedValue *= 1.0 + approachRateFactor;
+            speedValue *= 1.0 + approachRateFactor * lengthBonus; // Buff for longer maps with high AR.
 
             if (mods.Any(m => m is OsuModBlinds))
             {

From 098fa181b4dab26ae9ce0d7316b0bb2e107b9364 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 3 Nov 2021 18:08:12 +0100
Subject: [PATCH 0691/5547] Fix text flow wrapping incorrectly in multiplayer
 usages

---
 osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs     | 5 ++++-
 .../Screens/OnlinePlay/Lounge/Components/DrawableRoom.cs    | 6 ++++--
 2 files changed, 8 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
index 675b5e4c04..826140944c 100644
--- a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
+++ b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
@@ -181,8 +181,11 @@ namespace osu.Game.Screens.OnlinePlay
                                     {
                                         beatmapText = new LinkFlowContainer(fontParameters)
                                         {
-                                            AutoSizeAxes = Axes.Y,
                                             RelativeSizeAxes = Axes.X,
+                                            // workaround to ensure only the first line of text shows, emulating truncation (but without ellipsis at the end).
+                                            // TODO: remove when text/link flow can support truncation with ellipsis natively.
+                                            Height = OsuFont.DEFAULT_FONT_SIZE,
+                                            Masking = true
                                         },
                                         new FillFlowContainer
                                         {
diff --git a/osu.Game/Screens/OnlinePlay/Lounge/Components/DrawableRoom.cs b/osu.Game/Screens/OnlinePlay/Lounge/Components/DrawableRoom.cs
index acd87ed864..48202652f0 100644
--- a/osu.Game/Screens/OnlinePlay/Lounge/Components/DrawableRoom.cs
+++ b/osu.Game/Screens/OnlinePlay/Lounge/Components/DrawableRoom.cs
@@ -353,7 +353,10 @@ namespace osu.Game.Screens.OnlinePlay.Lounge.Components
                             })
                             {
                                 RelativeSizeAxes = Axes.X,
-                                AutoSizeAxes = Axes.Y
+                                // workaround to ensure only the first line of text shows, emulating truncation (but without ellipsis at the end).
+                                // TODO: remove when text/link flow can support truncation with ellipsis natively.
+                                Height = 16,
+                                Masking = true
                             }
                         }
                     }
@@ -385,7 +388,6 @@ namespace osu.Game.Screens.OnlinePlay.Lounge.Components
                         creationParameters: s =>
                         {
                             s.Truncate = true;
-                            s.RelativeSizeAxes = Axes.X;
                         });
                 }
             }

From 7eb0edf0464c75a78caa07f6075f75d4c6db52af Mon Sep 17 00:00:00 2001
From: Xexxar <xexxar.xexxar@gmail.com>
Date: Wed, 3 Nov 2021 17:59:09 +0000
Subject: [PATCH 0692/5547] added stanrs requested changes

---
 .../Preprocessing/OsuDifficultyHitObject.cs   | 30 ++++++++-----------
 1 file changed, 13 insertions(+), 17 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
index 9be61ba506..46237f732f 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
@@ -100,21 +100,23 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
 
                 for (int i = 1; i < lastSlider.NestedHitObjects.Count; i++)
                 {
-                    Vector2 currSlider = Vector2.Subtract(((OsuHitObject)lastSlider.NestedHitObjects[i]).StackedPosition, currSliderPosition);
+                    var currSliderObj = (OsuHitObject)lastSlider.NestedHitObjects[i];
+
+                    Vector2 currSlider = Vector2.Subtract(currSliderObj.StackedPosition, currSliderPosition);
                     double currSliderLength = currSlider.Length * scalingFactor;
 
-                    if ((OsuHitObject)lastSlider.NestedHitObjects[i] is SliderEndCircle && !((OsuHitObject)lastSlider.NestedHitObjects[i] is SliderRepeat))
+                    if (currSliderObj is SliderEndCircle && !(currSliderObj is SliderRepeat))
                     {
-                        Vector2 possSlider = Vector2.Subtract((Vector2)lastSlider.LazyEndPosition, currSliderPosition);
-                        if (possSlider.Length < currSlider.Length)
-                            currSlider = possSlider; // Take the least distance from slider end vs lazy end.
+                        Vector2 lazySlider = Vector2.Subtract((Vector2)lastSlider.LazyEndPosition, currSliderPosition);
+                        if (lazySlider.Length < currSlider.Length)
+                            currSlider = lazySlider; // Take the least distance from slider end vs lazy end.
 
                         currSliderLength = currSlider.Length * scalingFactor;
                     }
 
-                    if ((OsuHitObject)lastSlider.NestedHitObjects[i] is SliderTick)
+                    if (currSliderObj is SliderTick)
                     {
-                        if (currSliderLength > 120)
+                        if (currSliderLength > 120) // 120 is used here as 120 = 2.4 * radius, which means that the cursor assumes the position of least movement required to reach the active tick window.
                         {
                             currSliderPosition = Vector2.Add(currSliderPosition, Vector2.Multiply(currSlider, (float)((currSliderLength - 120) / currSliderLength)));
                             currSliderLength *= (currSliderLength - 120) / currSliderLength;
@@ -122,9 +124,9 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
                         else
                             currSliderLength = 0;
                     }
-                    else if ((OsuHitObject)lastSlider.NestedHitObjects[i] is SliderRepeat)
+                    else if (currSliderObj is SliderRepeat)
                     {
-                        if (currSliderLength > 50)
+                        if (currSliderLength > 50) // 50 is used here as 50 = radius. This is a way to reward motion of back and forths sliders where we assume the player moves to atleast the rim of the hitcircle.
                         {
                             currSliderPosition = Vector2.Add(currSliderPosition, Vector2.Multiply(currSlider, (float)((currSliderLength - 50) / currSliderLength)));
                             currSliderLength *= (currSliderLength - 50) / currSliderLength;
@@ -134,16 +136,10 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
                     }
                     else
                     {
-                        if (currSliderLength > 0)
-                        {
-                            currSliderPosition = Vector2.Add(currSliderPosition, Vector2.Multiply(currSlider, (float)((currSliderLength - 0) / currSliderLength)));
-                            currSliderLength *= (currSliderLength - 0) / currSliderLength;
-                        }
-                        else
-                            currSliderLength = 0;
+                        currSliderPosition = Vector2.Add(currSliderPosition, currSlider);
                     }
 
-                    if ((OsuHitObject)lastSlider.NestedHitObjects[i] is SliderRepeat)
+                    if (currSliderObj is SliderRepeat)
                         repeatCount++;
 
                     TravelDistance += currSliderLength;

From 6c6a440f1bdd4f4f6e5574157cd82dfd2db178a9 Mon Sep 17 00:00:00 2001
From: Xexxar <xexxar.xexxar@gmail.com>
Date: Wed, 3 Nov 2021 18:09:44 +0000
Subject: [PATCH 0693/5547] applied constants to numbers

---
 .../Preprocessing/OsuDifficultyHitObject.cs     | 17 +++++++++--------
 1 file changed, 9 insertions(+), 8 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
index 46237f732f..b1de132aa7 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
@@ -14,6 +14,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
     {
         private const int normalized_radius = 50; // Change radius to 50 to make 100 the diameter. Easier for mental maths.
         private const int min_delta_time = 25;
+        private const int minimum_slider_radius = normalized_radius * 2.4;
 
         protected new OsuHitObject BaseObject => (OsuHitObject)base.BaseObject;
 
@@ -116,20 +117,20 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
 
                     if (currSliderObj is SliderTick)
                     {
-                        if (currSliderLength > 120) // 120 is used here as 120 = 2.4 * radius, which means that the cursor assumes the position of least movement required to reach the active tick window.
+                        if (currSliderLength > minimum_slider_radius) // minimum_slider_radius is used here as 120 = 2.4 * radius, which means that the cursor assumes the position of least movement required to reach the active tick window.
                         {
-                            currSliderPosition = Vector2.Add(currSliderPosition, Vector2.Multiply(currSlider, (float)((currSliderLength - 120) / currSliderLength)));
-                            currSliderLength *= (currSliderLength - 120) / currSliderLength;
+                            currSliderPosition = Vector2.Add(currSliderPosition, Vector2.Multiply(currSlider, (float)((currSliderLength - minimum_slider_radius) / currSliderLength)));
+                            currSliderLength *= (currSliderLength - minimum_slider_radius) / currSliderLength;
                         }
                         else
                             currSliderLength = 0;
                     }
                     else if (currSliderObj is SliderRepeat)
                     {
-                        if (currSliderLength > 50) // 50 is used here as 50 = radius. This is a way to reward motion of back and forths sliders where we assume the player moves to atleast the rim of the hitcircle.
+                        if (currSliderLength > normalized_radius) // normalized_radius is used here as 50 = radius. This is a way to reward motion of back and forths sliders where we assume the player moves to atleast the rim of the hitcircle.
                         {
-                            currSliderPosition = Vector2.Add(currSliderPosition, Vector2.Multiply(currSlider, (float)((currSliderLength - 50) / currSliderLength)));
-                            currSliderLength *= (currSliderLength - 50) / currSliderLength;
+                            currSliderPosition = Vector2.Add(currSliderPosition, Vector2.Multiply(currSlider, (float)((currSliderLength - normalized_radius) / currSliderLength)));
+                            currSliderLength *= (currSliderLength - normalized_radius) / currSliderLength;
                         }
                         else
                             currSliderLength = 0;
@@ -154,8 +155,8 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
                 // such that they're not jumping from the lazy position but rather from very close to (or the end of) the slider.
                 // In such cases, a leniency is applied by also considering the jump distance from the tail of the slider, and taking the minimum jump distance.
                 // Additional distance is removed based on position of jump relative to slider follow circle radius.
-                // JumpDistance is 50 since follow radius = 1.4 * radius. tailJumpDistance is 120 since the full distance of radial leniency is still possible.
-                MovementDistance = Math.Max(0, Math.Min(JumpDistance - 50, tailJumpDistance - 120));
+                // JumpDistance is normalized_radius because lazyCursorPos uses a tighter 1.4 followCircle. tailJumpDistance is minimum_slider_radius since the full distance of radial leniency is still possible.
+                MovementDistance = Math.Max(0, Math.Min(JumpDistance - normalized_radius, tailJumpDistance - 120));
             }
             else
             {

From 23dbf04764ab3ada804cdbcdb76800dbaa301775 Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Thu, 4 Nov 2021 09:17:51 +0900
Subject: [PATCH 0694/5547] Fix incorrect type

---
 .../Difficulty/Preprocessing/OsuDifficultyHitObject.cs          | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
index b1de132aa7..d8b176cc29 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
@@ -14,7 +14,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
     {
         private const int normalized_radius = 50; // Change radius to 50 to make 100 the diameter. Easier for mental maths.
         private const int min_delta_time = 25;
-        private const int minimum_slider_radius = normalized_radius * 2.4;
+        private const float minimum_slider_radius = normalized_radius * 2.4f;
 
         protected new OsuHitObject BaseObject => (OsuHitObject)base.BaseObject;
 

From d76158cbad8142d022f4a71d42f857da2c0e49aa Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Thu, 4 Nov 2021 09:20:46 +0900
Subject: [PATCH 0695/5547] Resolve inspection

---
 .../Difficulty/Preprocessing/OsuDifficultyHitObject.cs        | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
index d8b176cc29..e1b4ee51e1 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
@@ -2,6 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
+using System.Diagnostics;
 using System.Linq;
 using osu.Game.Rulesets.Difficulty.Preprocessing;
 using osu.Game.Rulesets.Objects;
@@ -108,6 +109,9 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
 
                     if (currSliderObj is SliderEndCircle && !(currSliderObj is SliderRepeat))
                     {
+                        // Calculated above/
+                        Debug.Assert(lastSlider.LazyEndPosition != null);
+
                         Vector2 lazySlider = Vector2.Subtract((Vector2)lastSlider.LazyEndPosition, currSliderPosition);
                         if (lazySlider.Length < currSlider.Length)
                             currSlider = lazySlider; // Take the least distance from slider end vs lazy end.

From 1d8e25311284f9c0bd5b96d75f9b1b107c7a4ecd Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 1 Nov 2021 16:44:39 +0900
Subject: [PATCH 0696/5547] Expose `PlaylistItem.APIBeatmap` for now

---
 osu.Game/Online/Rooms/PlaylistItem.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Online/Rooms/PlaylistItem.cs b/osu.Game/Online/Rooms/PlaylistItem.cs
index 7fcce1514d..9a6269ecb1 100644
--- a/osu.Game/Online/Rooms/PlaylistItem.cs
+++ b/osu.Game/Online/Rooms/PlaylistItem.cs
@@ -43,7 +43,7 @@ namespace osu.Game.Online.Rooms
         public readonly BindableList<Mod> RequiredMods = new BindableList<Mod>();
 
         [JsonProperty("beatmap")]
-        private APIBeatmap apiBeatmap { get; set; }
+        public APIBeatmap APIBeatmap { get; set; }
 
         private APIMod[] allowedModsBacking;
 
@@ -71,7 +71,7 @@ namespace osu.Game.Online.Rooms
 
         public void MapObjects(BeatmapManager beatmaps, RulesetStore rulesets)
         {
-            Beatmap.Value ??= apiBeatmap.ToBeatmapInfo(rulesets);
+            Beatmap.Value ??= APIBeatmap.ToBeatmapInfo(rulesets);
             Ruleset.Value ??= rulesets.GetRuleset(RulesetID);
 
             Ruleset rulesetInstance = Ruleset.Value.CreateInstance();

From 6fdeb66dc11552c46483486d57c0a508c6fe8cc0 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 1 Nov 2021 17:30:19 +0900
Subject: [PATCH 0697/5547] Use `APIBeatmap` instead of `BeatmapInfo` in
 playlist display classes where feasible

---
 .../Components/OnlinePlayBackgroundScreen.cs  |  8 +++++--
 .../Components/OnlinePlayBackgroundSprite.cs  |  2 +-
 .../Components/PlaylistItemBackground.cs      | 10 ++++-----
 .../OnlinePlay/DrawableRoomPlaylistItem.cs    | 22 ++++++++++---------
 .../OnlinePlay/Match/DrawableMatchRoom.cs     |  2 +-
 5 files changed, 25 insertions(+), 19 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Components/OnlinePlayBackgroundScreen.cs b/osu.Game/Screens/OnlinePlay/Components/OnlinePlayBackgroundScreen.cs
index e2088c77d5..3e9b19cc17 100644
--- a/osu.Game/Screens/OnlinePlay/Components/OnlinePlayBackgroundScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Components/OnlinePlayBackgroundScreen.cs
@@ -8,6 +8,7 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Colour;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Screens;
+using osu.Game.Beatmaps;
 using osu.Game.Online.Rooms;
 using osuTK;
 using osuTK.Graphics;
@@ -59,9 +60,12 @@ namespace osu.Game.Screens.OnlinePlay.Components
         {
             Schedule(() =>
             {
-                var beatmap = playlistItem?.Beatmap.Value;
+                var beatmap = playlistItem?.APIBeatmap;
 
-                if (background?.BeatmapInfo?.BeatmapSet?.OnlineInfo?.Covers.Cover == beatmap?.BeatmapSet?.OnlineInfo?.Covers.Cover)
+                string? lastCover = (background?.Beatmap?.BeatmapSet as IBeatmapSetOnlineInfo)?.Covers.Cover;
+                string? newCover = beatmap?.BeatmapSet?.Covers.Cover;
+
+                if (lastCover == newCover)
                     return;
 
                 cancellationSource?.Cancel();
diff --git a/osu.Game/Screens/OnlinePlay/Components/OnlinePlayBackgroundSprite.cs b/osu.Game/Screens/OnlinePlay/Components/OnlinePlayBackgroundSprite.cs
index e2ba0b03b0..6df80a6d0a 100644
--- a/osu.Game/Screens/OnlinePlay/Components/OnlinePlayBackgroundSprite.cs
+++ b/osu.Game/Screens/OnlinePlay/Components/OnlinePlayBackgroundSprite.cs
@@ -30,7 +30,7 @@ namespace osu.Game.Screens.OnlinePlay.Components
 
         private void updateBeatmap()
         {
-            sprite.Beatmap.Value = Playlist.FirstOrDefault()?.Beatmap.Value;
+            sprite.Beatmap.Value = Playlist.FirstOrDefault()?.APIBeatmap;
         }
 
         protected virtual UpdateableBeatmapBackgroundSprite CreateBackgroundSprite() => new UpdateableBeatmapBackgroundSprite(BeatmapSetCoverType) { RelativeSizeAxes = Axes.Both };
diff --git a/osu.Game/Screens/OnlinePlay/Components/PlaylistItemBackground.cs b/osu.Game/Screens/OnlinePlay/Components/PlaylistItemBackground.cs
index 90ad6e0f6e..bf44ca6263 100644
--- a/osu.Game/Screens/OnlinePlay/Components/PlaylistItemBackground.cs
+++ b/osu.Game/Screens/OnlinePlay/Components/PlaylistItemBackground.cs
@@ -13,11 +13,11 @@ namespace osu.Game.Screens.OnlinePlay.Components
 {
     public class PlaylistItemBackground : Background
     {
-        public readonly BeatmapInfo? BeatmapInfo;
+        public readonly IBeatmapInfo? Beatmap;
 
         public PlaylistItemBackground(PlaylistItem? playlistItem)
         {
-            BeatmapInfo = playlistItem?.Beatmap.Value;
+            Beatmap = playlistItem?.APIBeatmap;
         }
 
         [BackgroundDependencyLoader]
@@ -26,8 +26,8 @@ namespace osu.Game.Screens.OnlinePlay.Components
             Texture? texture = null;
 
             // prefer online cover where available.
-            if (BeatmapInfo?.BeatmapSet?.OnlineInfo?.Covers.Cover != null)
-                texture = textures.Get(BeatmapInfo.BeatmapSet.OnlineInfo.Covers.Cover);
+            if (Beatmap?.BeatmapSet is IBeatmapSetOnlineInfo online)
+                texture = textures.Get(online.Covers.Cover);
 
             Sprite.Texture = texture ?? beatmaps.DefaultBeatmap.Background;
         }
@@ -38,7 +38,7 @@ namespace osu.Game.Screens.OnlinePlay.Components
             if (ReferenceEquals(this, other)) return true;
 
             return other.GetType() == GetType()
-                   && ((PlaylistItemBackground)other).BeatmapInfo == BeatmapInfo;
+                   && ((PlaylistItemBackground)other).Beatmap == Beatmap;
         }
     }
 }
diff --git a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
index 826140944c..880f6d7195 100644
--- a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
+++ b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
@@ -96,6 +96,7 @@ namespace osu.Game.Screens.OnlinePlay
         }
 
         private ScheduledDelegate scheduledRefresh;
+        private PanelBackground panelBackground;
 
         private void scheduleRefresh()
         {
@@ -105,23 +106,25 @@ namespace osu.Game.Screens.OnlinePlay
 
         private void refresh()
         {
-            difficultyIconContainer.Child = new DifficultyIcon(beatmap.Value, ruleset.Value, requiredMods, performBackgroundDifficultyLookup: false) { Size = new Vector2(32) };
+            difficultyIconContainer.Child = new DifficultyIcon(Item.APIBeatmap, ruleset.Value, requiredMods, performBackgroundDifficultyLookup: false) { Size = new Vector2(32) };
+
+            panelBackground.Beatmap.Value = Item.APIBeatmap;
 
             beatmapText.Clear();
-            beatmapText.AddLink(Item.Beatmap.Value.GetDisplayTitleRomanisable(), LinkAction.OpenBeatmap, Item.Beatmap.Value.OnlineBeatmapID.ToString(), null, text =>
+            beatmapText.AddLink(Item.APIBeatmap.GetDisplayTitleRomanisable(), LinkAction.OpenBeatmap, Item.APIBeatmap.OnlineID.ToString(), null, text =>
             {
                 text.Truncate = true;
             });
 
             authorText.Clear();
 
-            if (Item.Beatmap?.Value?.Metadata?.Author != null)
+            if (Item.Beatmap.Value?.Metadata?.Author != null)
             {
                 authorText.AddText("mapped by ");
-                authorText.AddUserLink(Item.Beatmap.Value?.Metadata.Author);
+                authorText.AddUserLink(Item.APIBeatmap?.BeatmapSet?.Author);
             }
 
-            bool hasExplicitContent = Item.Beatmap.Value.BeatmapSet.OnlineInfo?.HasExplicitContent == true;
+            bool hasExplicitContent = Item.Beatmap.Value?.BeatmapSet.OnlineInfo?.HasExplicitContent == true;
             explicitContentPill.Alpha = hasExplicitContent ? 1 : 0;
 
             modDisplay.Current.Value = requiredMods.ToArray();
@@ -145,10 +148,9 @@ namespace osu.Game.Screens.OnlinePlay
                         Alpha = 0,
                         AlwaysPresent = true
                     },
-                    new PanelBackground
+                    panelBackground = new PanelBackground
                     {
                         RelativeSizeAxes = Axes.Both,
-                        Beatmap = { BindTarget = beatmap }
                     },
                     new GridContainer
                     {
@@ -294,7 +296,7 @@ namespace osu.Game.Screens.OnlinePlay
             private const float width = 50;
 
             public PlaylistDownloadButton(PlaylistItem playlistItem)
-                : base(playlistItem.Beatmap.Value.BeatmapSet)
+                : base(playlistItem.APIBeatmap.BeatmapSet)
             {
                 this.playlistItem = playlistItem;
 
@@ -316,7 +318,7 @@ namespace osu.Game.Screens.OnlinePlay
                 {
                     case DownloadState.LocallyAvailable:
                         // Perform a local query of the beatmap by beatmap checksum, and reset the state if not matching.
-                        if (beatmapManager.QueryBeatmap(b => b.MD5Hash == playlistItem.Beatmap.Value.MD5Hash) == null)
+                        if (beatmapManager.QueryBeatmap(b => b.MD5Hash == playlistItem.APIBeatmap.MD5Hash) == null)
                             State.Value = DownloadState.NotDownloaded;
                         else
                         {
@@ -337,7 +339,7 @@ namespace osu.Game.Screens.OnlinePlay
         // For now, this is the same implementation as in PanelBackground, but supports a beatmap info rather than a working beatmap
         private class PanelBackground : Container // todo: should be a buffered container (https://github.com/ppy/osu-framework/issues/3222)
         {
-            public readonly Bindable<BeatmapInfo> Beatmap = new Bindable<BeatmapInfo>();
+            public readonly Bindable<IBeatmapInfo> Beatmap = new Bindable<IBeatmapInfo>();
 
             public PanelBackground()
             {
diff --git a/osu.Game/Screens/OnlinePlay/Match/DrawableMatchRoom.cs b/osu.Game/Screens/OnlinePlay/Match/DrawableMatchRoom.cs
index e83403850f..affcf32bd6 100644
--- a/osu.Game/Screens/OnlinePlay/Match/DrawableMatchRoom.cs
+++ b/osu.Game/Screens/OnlinePlay/Match/DrawableMatchRoom.cs
@@ -62,7 +62,7 @@ namespace osu.Game.Screens.OnlinePlay.Match
             if (editButton != null)
                 host.BindValueChanged(h => editButton.Alpha = h.NewValue?.Equals(api.LocalUser.Value) == true ? 1 : 0, true);
 
-            SelectedItem.BindValueChanged(item => background.Beatmap.Value = item.NewValue?.Beatmap.Value, true);
+            SelectedItem.BindValueChanged(item => background.Beatmap.Value = item.NewValue?.APIBeatmap, true);
         }
 
         protected override Drawable CreateBackground() => background = new BackgroundSprite();

From 772b6c6dcde694476895e786fef502e237b46c77 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 4 Nov 2021 12:11:42 +0900
Subject: [PATCH 0698/5547] Enable nullable support on `BeatmapMetadata`

---
 osu.Game/Beatmaps/BeatmapMetadata.cs | 28 +++++++++++++++-------------
 1 file changed, 15 insertions(+), 13 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapMetadata.cs b/osu.Game/Beatmaps/BeatmapMetadata.cs
index 711533e118..5d3b4007ae 100644
--- a/osu.Game/Beatmaps/BeatmapMetadata.cs
+++ b/osu.Game/Beatmaps/BeatmapMetadata.cs
@@ -9,6 +9,8 @@ using osu.Framework.Testing;
 using osu.Game.Database;
 using osu.Game.Users;
 
+#nullable enable
+
 namespace osu.Game.Beatmaps
 {
     [ExcludeFromDynamicCompile]
@@ -17,21 +19,21 @@ namespace osu.Game.Beatmaps
     {
         public int ID { get; set; }
 
-        public string Title { get; set; }
+        public string Title { get; set; } = string.Empty;
 
         [JsonProperty("title_unicode")]
-        public string TitleUnicode { get; set; }
+        public string TitleUnicode { get; set; } = string.Empty;
 
-        public string Artist { get; set; }
+        public string Artist { get; set; } = string.Empty;
 
         [JsonProperty("artist_unicode")]
-        public string ArtistUnicode { get; set; }
+        public string ArtistUnicode { get; set; } = string.Empty;
 
         [JsonIgnore]
-        public List<BeatmapInfo> Beatmaps { get; set; }
+        public List<BeatmapInfo> Beatmaps { get; set; } = new List<BeatmapInfo>();
 
         [JsonIgnore]
-        public List<BeatmapSetInfo> BeatmapSets { get; set; }
+        public List<BeatmapSetInfo> BeatmapSets { get; set; } = new List<BeatmapSetInfo>();
 
         /// <summary>
         /// Helper property to deserialize a username to <see cref="User"/>.
@@ -55,7 +57,7 @@ namespace osu.Game.Beatmaps
         [Column("Author")]
         public string AuthorString
         {
-            get => Author?.Username;
+            get => Author?.Username ?? string.Empty;
             set
             {
                 Author ??= new User();
@@ -67,22 +69,22 @@ namespace osu.Game.Beatmaps
         /// The author of the beatmaps in this set.
         /// </summary>
         [JsonIgnore]
-        public User Author;
+        public User? Author;
 
-        public string Source { get; set; }
+        public string Source { get; set; } = string.Empty;
 
         [JsonProperty(@"tags")]
-        public string Tags { get; set; }
+        public string Tags { get; set; } = string.Empty;
 
         /// <summary>
         /// The time in milliseconds to begin playing the track for preview purposes.
         /// If -1, the track should begin playing at 40% of its length.
         /// </summary>
-        public int PreviewTime { get; set; }
+        public int PreviewTime { get; set; } = -1;
 
-        public string AudioFile { get; set; }
+        public string AudioFile { get; set; } = string.Empty;
 
-        public string BackgroundFile { get; set; }
+        public string BackgroundFile { get; set; } = string.Empty;
 
         public bool Equals(BeatmapMetadata other) => ((IBeatmapMetadataInfo)this).Equals(other);
 

From 3453160a8b9caa2e8fb7db835352443ebb52f849 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 4 Nov 2021 12:30:19 +0900
Subject: [PATCH 0699/5547] Change `PlaylistItem.Beatmap` to be an
 `IBeatmapInfo`

---
 .../Online/Multiplayer/MultiplayerClient.cs     | 15 +++++++++------
 .../Multiplayer/OnlineMultiplayerClient.cs      |  8 ++++----
 osu.Game/Online/Rooms/MultiplayerScore.cs       |  5 +++--
 .../OnlinePlayBeatmapAvailabilityTracker.cs     |  3 +++
 osu.Game/Online/Rooms/PlaylistItem.cs           |  6 +++---
 .../Components/StarRatingRangeDisplay.cs        |  6 +++---
 .../OnlinePlay/DrawableRoomPlaylistItem.cs      | 17 +++++++++--------
 .../Lounge/Components/DrawableRoom.cs           |  2 +-
 .../Screens/OnlinePlay/Match/RoomSubScreen.cs   |  2 +-
 .../OnlinePlay/Playlists/PlaylistsPlayer.cs     |  2 +-
 .../Playlists/PlaylistsResultsScreen.cs         |  2 +-
 osu.Game/Screens/Play/SoloSpectator.cs          | 14 +++++++++-----
 .../Visual/Multiplayer/TestMultiplayerClient.cs | 15 +++++++++++----
 13 files changed, 58 insertions(+), 39 deletions(-)

diff --git a/osu.Game/Online/Multiplayer/MultiplayerClient.cs b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
index 0586e0ae60..b80253684e 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
@@ -17,6 +17,7 @@ using osu.Framework.Logging;
 using osu.Game.Beatmaps;
 using osu.Game.Database;
 using osu.Game.Online.API;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Rooms;
 using osu.Game.Online.Rooms.RoomStatuses;
 using osu.Game.Rulesets;
@@ -653,15 +654,17 @@ namespace osu.Game.Online.Multiplayer
             }), TaskContinuationOptions.OnlyOnRanToCompletion);
         }, cancellationToken);
 
-        private void updatePlaylist(MultiplayerRoomSettings settings, BeatmapSetInfo beatmapSet)
+        private void updatePlaylist(MultiplayerRoomSettings settings, APIBeatmapSet beatmapSet)
         {
             if (Room == null || !Room.Settings.Equals(settings))
                 return;
 
             Debug.Assert(APIRoom != null);
 
-            var beatmap = beatmapSet.Beatmaps.Single(b => b.OnlineBeatmapID == settings.BeatmapID);
-            beatmap.MD5Hash = settings.BeatmapChecksum;
+            var beatmap = beatmapSet.Beatmaps.Single(b => b.OnlineID == settings.BeatmapID);
+
+            beatmap.Checksum = settings.BeatmapChecksum;
+            beatmap.BeatmapSet = beatmapSet;
 
             var ruleset = Rulesets.GetRuleset(settings.RulesetID).CreateInstance();
             var mods = settings.RequiredMods.Select(m => m.ToMod(ruleset));
@@ -694,12 +697,12 @@ namespace osu.Game.Online.Multiplayer
         }
 
         /// <summary>
-        /// Retrieves a <see cref="BeatmapSetInfo"/> from an online source.
+        /// Retrieves a <see cref="APIBeatmapSet"/> from an online source.
         /// </summary>
         /// <param name="beatmapId">The beatmap set ID.</param>
         /// <param name="cancellationToken">A token to cancel the request.</param>
-        /// <returns>The <see cref="BeatmapSetInfo"/> retrieval task.</returns>
-        protected abstract Task<BeatmapSetInfo> GetOnlineBeatmapSet(int beatmapId, CancellationToken cancellationToken = default);
+        /// <returns>The <see cref="APIBeatmapSet"/> retrieval task.</returns>
+        protected abstract Task<APIBeatmapSet> GetOnlineBeatmapSet(int beatmapId, CancellationToken cancellationToken = default);
 
         /// <summary>
         /// For the provided user ID, update whether the user is included in <see cref="CurrentMatchPlayingUserIds"/>.
diff --git a/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs b/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs
index 965674c2f2..a28abc78ca 100644
--- a/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs
@@ -9,9 +9,9 @@ using System.Threading.Tasks;
 using Microsoft.AspNetCore.SignalR.Client;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
-using osu.Game.Beatmaps;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Rooms;
 
 namespace osu.Game.Online.Multiplayer
@@ -148,9 +148,9 @@ namespace osu.Game.Online.Multiplayer
             return connection.InvokeAsync(nameof(IMultiplayerServer.StartMatch));
         }
 
-        protected override Task<BeatmapSetInfo> GetOnlineBeatmapSet(int beatmapId, CancellationToken cancellationToken = default)
+        protected override Task<APIBeatmapSet> GetOnlineBeatmapSet(int beatmapId, CancellationToken cancellationToken = default)
         {
-            var tcs = new TaskCompletionSource<BeatmapSetInfo>();
+            var tcs = new TaskCompletionSource<APIBeatmapSet>();
             var req = new GetBeatmapSetRequest(beatmapId, BeatmapSetLookupType.BeatmapId);
 
             req.Success += res =>
@@ -161,7 +161,7 @@ namespace osu.Game.Online.Multiplayer
                     return;
                 }
 
-                tcs.SetResult(res.ToBeatmapSet(Rulesets));
+                tcs.SetResult(res);
             };
 
             req.Failure += e => tcs.SetException(e);
diff --git a/osu.Game/Online/Rooms/MultiplayerScore.cs b/osu.Game/Online/Rooms/MultiplayerScore.cs
index 7ec34e70d5..375e0b6b9f 100644
--- a/osu.Game/Online/Rooms/MultiplayerScore.cs
+++ b/osu.Game/Online/Rooms/MultiplayerScore.cs
@@ -7,6 +7,7 @@ using System.Linq;
 using JetBrains.Annotations;
 using Newtonsoft.Json;
 using Newtonsoft.Json.Converters;
+using osu.Game.Beatmaps;
 using osu.Game.Online.API;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Scoring;
@@ -61,7 +62,7 @@ namespace osu.Game.Online.Rooms
         [CanBeNull]
         public MultiplayerScoresAround ScoresAround { get; set; }
 
-        public ScoreInfo CreateScoreInfo(PlaylistItem playlistItem)
+        public ScoreInfo CreateScoreInfo(PlaylistItem playlistItem, [NotNull] BeatmapInfo beatmap)
         {
             var rulesetInstance = playlistItem.Ruleset.Value.CreateInstance();
 
@@ -70,7 +71,7 @@ namespace osu.Game.Online.Rooms
                 OnlineScoreID = ID,
                 TotalScore = TotalScore,
                 MaxCombo = MaxCombo,
-                BeatmapInfo = playlistItem.Beatmap.Value,
+                BeatmapInfo = beatmap,
                 BeatmapInfoID = playlistItem.BeatmapID,
                 Ruleset = playlistItem.Ruleset.Value,
                 RulesetID = playlistItem.RulesetID,
diff --git a/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs b/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs
index a642e283f9..eb9ea608f7 100644
--- a/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs
+++ b/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.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.Bindables;
 using osu.Framework.Graphics;
@@ -52,6 +53,8 @@ namespace osu.Game.Online.Rooms
 
                 downloadTracker?.RemoveAndDisposeImmediately();
 
+                Debug.Assert(item.NewValue.Beatmap.Value.BeatmapSet != null);
+
                 downloadTracker = new BeatmapDownloadTracker(item.NewValue.Beatmap.Value.BeatmapSet);
 
                 AddInternal(downloadTracker);
diff --git a/osu.Game/Online/Rooms/PlaylistItem.cs b/osu.Game/Online/Rooms/PlaylistItem.cs
index 9a6269ecb1..13b609c9c9 100644
--- a/osu.Game/Online/Rooms/PlaylistItem.cs
+++ b/osu.Game/Online/Rooms/PlaylistItem.cs
@@ -31,7 +31,7 @@ namespace osu.Game.Online.Rooms
         public bool Expired { get; set; }
 
         [JsonIgnore]
-        public readonly Bindable<BeatmapInfo> Beatmap = new Bindable<BeatmapInfo>();
+        public readonly Bindable<IBeatmapInfo> Beatmap = new Bindable<IBeatmapInfo>();
 
         [JsonIgnore]
         public readonly Bindable<RulesetInfo> Ruleset = new Bindable<RulesetInfo>();
@@ -65,13 +65,13 @@ namespace osu.Game.Online.Rooms
 
         public PlaylistItem()
         {
-            Beatmap.BindValueChanged(beatmap => BeatmapID = beatmap.NewValue?.OnlineBeatmapID ?? 0);
+            Beatmap.BindValueChanged(beatmap => BeatmapID = beatmap.NewValue?.OnlineID ?? -1);
             Ruleset.BindValueChanged(ruleset => RulesetID = ruleset.NewValue?.ID ?? 0);
         }
 
         public void MapObjects(BeatmapManager beatmaps, RulesetStore rulesets)
         {
-            Beatmap.Value ??= APIBeatmap.ToBeatmapInfo(rulesets);
+            Beatmap.Value ??= APIBeatmap;
             Ruleset.Value ??= rulesets.GetRuleset(RulesetID);
 
             Ruleset rulesetInstance = Ruleset.Value.CreateInstance();
diff --git a/osu.Game/Screens/OnlinePlay/Components/StarRatingRangeDisplay.cs b/osu.Game/Screens/OnlinePlay/Components/StarRatingRangeDisplay.cs
index 7b14acf924..fc029543bb 100644
--- a/osu.Game/Screens/OnlinePlay/Components/StarRatingRangeDisplay.cs
+++ b/osu.Game/Screens/OnlinePlay/Components/StarRatingRangeDisplay.cs
@@ -80,10 +80,10 @@ namespace osu.Game.Screens.OnlinePlay.Components
 
         private void updateRange(object sender, NotifyCollectionChangedEventArgs e)
         {
-            var orderedDifficulties = Playlist.Select(p => p.Beatmap.Value).OrderBy(b => b.StarDifficulty).ToArray();
+            var orderedDifficulties = Playlist.Select(p => p.Beatmap.Value).OrderBy(b => b.StarRating).ToArray();
 
-            StarDifficulty minDifficulty = new StarDifficulty(orderedDifficulties.Length > 0 ? orderedDifficulties[0].StarDifficulty : 0, 0);
-            StarDifficulty maxDifficulty = new StarDifficulty(orderedDifficulties.Length > 0 ? orderedDifficulties[^1].StarDifficulty : 0, 0);
+            StarDifficulty minDifficulty = new StarDifficulty(orderedDifficulties.Length > 0 ? orderedDifficulties[0].StarRating : 0, 0);
+            StarDifficulty maxDifficulty = new StarDifficulty(orderedDifficulties.Length > 0 ? orderedDifficulties[^1].StarRating : 0, 0);
 
             minDisplay.Current.Value = minDifficulty;
             maxDisplay.Current.Value = maxDifficulty;
diff --git a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
index 880f6d7195..a7cce67fa3 100644
--- a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
+++ b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
@@ -27,6 +27,7 @@ using osu.Game.Overlays.BeatmapSet;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Screens.Play.HUD;
+using osu.Game.Users;
 using osuTK;
 using osuTK.Graphics;
 
@@ -45,7 +46,7 @@ namespace osu.Game.Screens.OnlinePlay
         private ExplicitContentBeatmapPill explicitContentPill;
         private ModDisplay modDisplay;
 
-        private readonly Bindable<BeatmapInfo> beatmap = new Bindable<BeatmapInfo>();
+        private readonly Bindable<IBeatmapInfo> beatmap = new Bindable<IBeatmapInfo>();
         private readonly Bindable<RulesetInfo> ruleset = new Bindable<RulesetInfo>();
         private readonly BindableList<Mod> requiredMods = new BindableList<Mod>();
 
@@ -106,12 +107,12 @@ namespace osu.Game.Screens.OnlinePlay
 
         private void refresh()
         {
-            difficultyIconContainer.Child = new DifficultyIcon(Item.APIBeatmap, ruleset.Value, requiredMods, performBackgroundDifficultyLookup: false) { Size = new Vector2(32) };
+            difficultyIconContainer.Child = new DifficultyIcon(Item.Beatmap.Value, ruleset.Value, requiredMods, performBackgroundDifficultyLookup: false) { Size = new Vector2(32) };
 
-            panelBackground.Beatmap.Value = Item.APIBeatmap;
+            panelBackground.Beatmap.Value = Item.Beatmap.Value;
 
             beatmapText.Clear();
-            beatmapText.AddLink(Item.APIBeatmap.GetDisplayTitleRomanisable(), LinkAction.OpenBeatmap, Item.APIBeatmap.OnlineID.ToString(), null, text =>
+            beatmapText.AddLink(Item.Beatmap.Value.GetDisplayTitleRomanisable(), LinkAction.OpenBeatmap, Item.Beatmap.Value.OnlineID.ToString(), null, text =>
             {
                 text.Truncate = true;
             });
@@ -121,10 +122,10 @@ namespace osu.Game.Screens.OnlinePlay
             if (Item.Beatmap.Value?.Metadata?.Author != null)
             {
                 authorText.AddText("mapped by ");
-                authorText.AddUserLink(Item.APIBeatmap?.BeatmapSet?.Author);
+                authorText.AddUserLink(new User { Username = Item.Beatmap.Value.Metadata.Author });
             }
 
-            bool hasExplicitContent = Item.Beatmap.Value?.BeatmapSet.OnlineInfo?.HasExplicitContent == true;
+            bool hasExplicitContent = (Item.Beatmap.Value.BeatmapSet as IBeatmapSetOnlineInfo)?.HasExplicitContent == true;
             explicitContentPill.Alpha = hasExplicitContent ? 1 : 0;
 
             modDisplay.Current.Value = requiredMods.ToArray();
@@ -296,7 +297,7 @@ namespace osu.Game.Screens.OnlinePlay
             private const float width = 50;
 
             public PlaylistDownloadButton(PlaylistItem playlistItem)
-                : base(playlistItem.APIBeatmap.BeatmapSet)
+                : base(playlistItem.Beatmap.Value.BeatmapSet)
             {
                 this.playlistItem = playlistItem;
 
@@ -318,7 +319,7 @@ namespace osu.Game.Screens.OnlinePlay
                 {
                     case DownloadState.LocallyAvailable:
                         // Perform a local query of the beatmap by beatmap checksum, and reset the state if not matching.
-                        if (beatmapManager.QueryBeatmap(b => b.MD5Hash == playlistItem.APIBeatmap.MD5Hash) == null)
+                        if (beatmapManager.QueryBeatmap(b => b.MD5Hash == playlistItem.Beatmap.Value.MD5Hash) == null)
                             State.Value = DownloadState.NotDownloaded;
                         else
                         {
diff --git a/osu.Game/Screens/OnlinePlay/Lounge/Components/DrawableRoom.cs b/osu.Game/Screens/OnlinePlay/Lounge/Components/DrawableRoom.cs
index 48202652f0..9920883078 100644
--- a/osu.Game/Screens/OnlinePlay/Lounge/Components/DrawableRoom.cs
+++ b/osu.Game/Screens/OnlinePlay/Lounge/Components/DrawableRoom.cs
@@ -384,7 +384,7 @@ namespace osu.Game.Screens.OnlinePlay.Lounge.Components
                     statusText.Text = "Currently playing ";
                     beatmapText.AddLink(item.NewValue.Beatmap.Value.GetDisplayTitleRomanisable(),
                         LinkAction.OpenBeatmap,
-                        item.NewValue.Beatmap.Value.OnlineBeatmapID.ToString(),
+                        item.NewValue.Beatmap.Value.OnlineID.ToString(),
                         creationParameters: s =>
                         {
                             s.Truncate = true;
diff --git a/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs b/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
index 2015a050bb..2cb29262e2 100644
--- a/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
@@ -369,7 +369,7 @@ namespace osu.Game.Screens.OnlinePlay.Match
             var beatmap = SelectedItem.Value?.Beatmap.Value;
 
             // Retrieve the corresponding local beatmap, since we can't directly use the playlist's beatmap info
-            var localBeatmap = beatmap == null ? null : beatmapManager.QueryBeatmap(b => b.OnlineBeatmapID == beatmap.OnlineBeatmapID);
+            var localBeatmap = beatmap == null ? null : beatmapManager.QueryBeatmap(b => b.OnlineBeatmapID == beatmap.OnlineID);
 
             Beatmap.Value = beatmapManager.GetWorkingBeatmap(localBeatmap);
         }
diff --git a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsPlayer.cs b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsPlayer.cs
index fa4a4d5112..bdb5ff9bb2 100644
--- a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsPlayer.cs
+++ b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsPlayer.cs
@@ -32,7 +32,7 @@ namespace osu.Game.Screens.OnlinePlay.Playlists
         private void load(IBindable<RulesetInfo> ruleset)
         {
             // Sanity checks to ensure that PlaylistsPlayer matches the settings for the current PlaylistItem
-            if (Beatmap.Value.BeatmapInfo.OnlineBeatmapID != PlaylistItem.Beatmap.Value.OnlineBeatmapID)
+            if (Beatmap.Value.BeatmapInfo.OnlineBeatmapID != PlaylistItem.Beatmap.Value.OnlineID)
                 throw new InvalidOperationException("Current Beatmap does not match PlaylistItem's Beatmap");
 
             if (ruleset.Value.ID != PlaylistItem.Ruleset.Value.ID)
diff --git a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsResultsScreen.cs b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsResultsScreen.cs
index 89bc659f63..34698fccab 100644
--- a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsResultsScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsResultsScreen.cs
@@ -169,7 +169,7 @@ namespace osu.Game.Screens.OnlinePlay.Playlists
         /// <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)
         {
-            var scoreInfos = scores.Select(s => s.CreateScoreInfo(playlistItem)).ToArray();
+            var scoreInfos = scores.Select(s => s.CreateScoreInfo(playlistItem, Beatmap.Value.BeatmapInfo)).ToArray();
 
             // Score panels calculate total score before displaying, which can take some time. In order to count that calculation as part of the loading spinner display duration,
             // calculate the total scores locally before invoking the success callback.
diff --git a/osu.Game/Screens/Play/SoloSpectator.cs b/osu.Game/Screens/Play/SoloSpectator.cs
index 83ea660092..6a73512f2d 100644
--- a/osu.Game/Screens/Play/SoloSpectator.cs
+++ b/osu.Game/Screens/Play/SoloSpectator.cs
@@ -18,6 +18,7 @@ using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Spectator;
 using osu.Game.Overlays.BeatmapListing.Panels;
 using osu.Game.Overlays.Settings;
@@ -50,7 +51,7 @@ namespace osu.Game.Screens.Play
         private Container beatmapPanelContainer;
         private TriangleButton watchButton;
         private SettingsCheckbox automaticDownload;
-        private BeatmapSetInfo onlineBeatmap;
+        private APIBeatmapSet onlineBeatmap;
 
         /// <summary>
         /// The player's immediate online gameplay state.
@@ -222,8 +223,8 @@ namespace osu.Game.Screens.Play
             onlineBeatmapRequest = new GetBeatmapSetRequest(state.BeatmapID.Value, BeatmapSetLookupType.BeatmapId);
             onlineBeatmapRequest.Success += res => Schedule(() =>
             {
-                onlineBeatmap = res.ToBeatmapSet(rulesets);
-                beatmapPanelContainer.Child = new GridBeatmapPanel(res);
+                onlineBeatmap = res;
+                beatmapPanelContainer.Child = new GridBeatmapPanel(onlineBeatmap);
                 checkForAutomaticDownload();
             });
 
@@ -238,10 +239,13 @@ namespace osu.Game.Screens.Play
             if (!automaticDownload.Current.Value)
                 return;
 
-            if (beatmaps.IsAvailableLocally(onlineBeatmap))
+            // Used to interact with manager classes that don't support interface types. Will eventually be replaced.
+            var beatmapSetInfo = new BeatmapSetInfo { OnlineBeatmapSetID = onlineBeatmap.OnlineID };
+
+            if (beatmaps.IsAvailableLocally(beatmapSetInfo))
                 return;
 
-            beatmaps.Download(onlineBeatmap);
+            beatmaps.Download(beatmapSetInfo);
         }
 
         public override bool OnExiting(IScreen next)
diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
index c6634abe82..c690a621eb 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
@@ -13,6 +13,7 @@ using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Game.Beatmaps;
 using osu.Game.Online.API;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Multiplayer.MatchTypes.TeamVersus;
 using osu.Game.Online.Rooms;
@@ -265,18 +266,24 @@ namespace osu.Game.Tests.Visual.Multiplayer
             return ((IMultiplayerClient)this).LoadRequested();
         }
 
-        protected override Task<BeatmapSetInfo> GetOnlineBeatmapSet(int beatmapId, CancellationToken cancellationToken = default)
+        protected override Task<APIBeatmapSet> GetOnlineBeatmapSet(int beatmapId, CancellationToken cancellationToken = default)
         {
             Debug.Assert(Room != null);
 
             var apiRoom = roomManager.ServerSideRooms.Single(r => r.RoomID.Value == Room.RoomID);
-            var set = apiRoom.Playlist.FirstOrDefault(p => p.BeatmapID == beatmapId)?.Beatmap.Value.BeatmapSet
-                      ?? beatmaps.QueryBeatmap(b => b.OnlineBeatmapID == beatmapId)?.BeatmapSet;
+            IBeatmapSetInfo? set = apiRoom.Playlist.FirstOrDefault(p => p.BeatmapID == beatmapId)?.Beatmap.Value.BeatmapSet
+                                   ?? beatmaps.QueryBeatmap(b => b.OnlineBeatmapID == beatmapId)?.BeatmapSet;
 
             if (set == null)
                 throw new InvalidOperationException("Beatmap not found.");
 
-            return Task.FromResult(set);
+            var apiSet = new APIBeatmapSet
+            {
+                OnlineID = set.OnlineID,
+                Beatmaps = set.Beatmaps.Select(b => new APIBeatmap { OnlineID = b.OnlineID })
+            };
+
+            return Task.FromResult(apiSet);
         }
 
         private async Task changeMatchType(MatchType type)

From 9aa3021bbc5f1f2ba2383cb96aef012d19ba5713 Mon Sep 17 00:00:00 2001
From: Chinmay Patil <chinmaytlc@gmail.com>
Date: Wed, 3 Nov 2021 22:22:44 -0600
Subject: [PATCH 0700/5547] Added Unstable Rate Counter as a skinable element

---
 .../Screens/Play/HUD/UnstableRateCounter.cs   | 124 ++++++++++++++++++
 osu.Game/Skinning/DefaultSkin.cs              |  14 +-
 2 files changed, 136 insertions(+), 2 deletions(-)
 create mode 100644 osu.Game/Screens/Play/HUD/UnstableRateCounter.cs

diff --git a/osu.Game/Screens/Play/HUD/UnstableRateCounter.cs b/osu.Game/Screens/Play/HUD/UnstableRateCounter.cs
new file mode 100644
index 0000000000..7109ea1995
--- /dev/null
+++ b/osu.Game/Screens/Play/HUD/UnstableRateCounter.cs
@@ -0,0 +1,124 @@
+// 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 JetBrains.Annotations;
+using osu.Framework.Allocation;
+using osu.Framework.Extensions.LocalisationExtensions;
+using osu.Framework.Graphics;
+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.Rulesets.Judgements;
+using osu.Game.Rulesets.Scoring;
+using osu.Game.Screens.Ranking.Statistics;
+using osu.Game.Skinning;
+
+namespace osu.Game.Screens.Play.HUD
+{
+    public class UnstableRateCounter : RollingCounter<double>, ISkinnableDrawable
+    {
+        public bool UsesFixedAnchor { get; set; }
+
+        protected override bool IsRollingProportional => true;
+
+        protected override double RollingDuration => 750;
+
+        private const float alpha_when_invalid = 0.3f;
+
+        [CanBeNull]
+        [Resolved(CanBeNull = true)]
+        private ScoreProcessor scoreProcessor { get; set; }
+
+        [Resolved(CanBeNull = true)]
+        [CanBeNull]
+        private GameplayState gameplayState { get; set; }
+
+        private readonly CancellationTokenSource loadCancellationSource = new CancellationTokenSource();
+
+        public UnstableRateCounter()
+        {
+            Current.Value = DisplayedCount = 0.0;
+        }
+
+        [BackgroundDependencyLoader]
+        private void load(OsuColour colours, BeatmapDifficultyCache difficultyCache)
+        {
+            Colour = colours.BlueLighter;
+        }
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            if (scoreProcessor != null)
+            {
+                scoreProcessor.NewJudgement += onJudgementChanged;
+                scoreProcessor.JudgementReverted += onJudgementChanged;
+            }
+        }
+
+        private bool isValid;
+
+        protected bool IsValid
+        {
+            set
+            {
+                if (value == isValid)
+                    return;
+
+                isValid = value;
+                DrawableCount.FadeTo(isValid ? 1 : alpha_when_invalid, 1000, Easing.OutQuint);
+            }
+        }
+
+        private void onJudgementChanged(JudgementResult judgement)
+        {
+
+            if (gameplayState == null)
+            {
+                isValid = false;
+                return;
+            }
+
+            double ur = new UnstableRate(gameplayState.Score.ScoreInfo.HitEvents).Value;
+            if (double.IsNaN(ur)) // Error handling: If the user misses the first few notes, the UR is NaN.
+            {
+                isValid = false;
+                return;
+            }
+            Current.Value = ur;
+            IsValid = true;
+        }
+
+        protected override LocalisableString FormatCount(double count)
+        {
+            return count.ToLocalisableString("0.00 UR");
+        }
+
+
+        protected override OsuSpriteText CreateSpriteText()
+            => base.CreateSpriteText().With(s => {
+                s.Font = s.Font.With(size: 12f, fixedWidth: true);
+                s.Alpha = alpha_when_invalid;
+            });
+
+
+
+        
+
+        protected override void Dispose(bool isDisposing)
+        {
+            base.Dispose(isDisposing);
+
+            if (scoreProcessor != null)
+                scoreProcessor.NewJudgement -= onJudgementChanged;
+
+            loadCancellationSource?.Cancel();
+        }
+
+
+    }
+}
diff --git a/osu.Game/Skinning/DefaultSkin.cs b/osu.Game/Skinning/DefaultSkin.cs
index c377f16f8b..e887ccb2e3 100644
--- a/osu.Game/Skinning/DefaultSkin.cs
+++ b/osu.Game/Skinning/DefaultSkin.cs
@@ -68,6 +68,7 @@ namespace osu.Game.Skinning
                                 var accuracy = container.OfType<DefaultAccuracyCounter>().FirstOrDefault();
                                 var combo = container.OfType<DefaultComboCounter>().FirstOrDefault();
                                 var ppCounter = container.OfType<PerformancePointsCounter>().FirstOrDefault();
+                                var unstableRate = container.OfType<UnstableRateCounter>().FirstOrDefault();
 
                                 if (score != null)
                                 {
@@ -84,9 +85,17 @@ namespace osu.Game.Skinning
                                     if (ppCounter != null)
                                     {
                                         ppCounter.Y = score.Position.Y + ppCounter.ScreenSpaceDeltaToParentSpace(score.ScreenSpaceDrawQuad.Size).Y - 4;
-                                        ppCounter.Origin = Anchor.TopCentre;
+                                        ppCounter.X = ppCounter.ScreenSpaceDeltaToParentSpace(score.ScreenSpaceDrawQuad.Size).X / 2 - horizontal_padding;
+                                        ppCounter.Origin = Anchor.TopRight;
                                         ppCounter.Anchor = Anchor.TopCentre;
                                     }
+                                    if (unstableRate != null)
+                                    {
+                                        unstableRate.Y = ppCounter.Position.Y;
+                                        unstableRate.X = -unstableRate.ScreenSpaceDeltaToParentSpace(score.ScreenSpaceDrawQuad.Size).X / 2 + horizontal_padding;
+                                        unstableRate.Origin = Anchor.TopLeft;
+                                        unstableRate.Anchor = Anchor.TopCentre;
+                                    }
 
                                     if (accuracy != null)
                                     {
@@ -130,7 +139,8 @@ namespace osu.Game.Skinning
                                     new SongProgress(),
                                     new BarHitErrorMeter(),
                                     new BarHitErrorMeter(),
-                                    new PerformancePointsCounter()
+                                    new PerformancePointsCounter(),
+                                    new UnstableRateCounter()
                                 }
                             };
 

From 05f1fd4bc92711d46157cfd0002cb1ba44bae9e9 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 4 Nov 2021 13:33:54 +0900
Subject: [PATCH 0701/5547] Remove unnecessary properties and parameters

---
 osu.Game/Online/Rooms/PlaylistItem.cs               |  2 +-
 .../Screens/OnlinePlay/Components/RoomManager.cs    |  2 +-
 osu.Game/Screens/Play/SoloSpectator.cs              | 13 +++++++------
 3 files changed, 9 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Online/Rooms/PlaylistItem.cs b/osu.Game/Online/Rooms/PlaylistItem.cs
index 13b609c9c9..108477987b 100644
--- a/osu.Game/Online/Rooms/PlaylistItem.cs
+++ b/osu.Game/Online/Rooms/PlaylistItem.cs
@@ -69,7 +69,7 @@ namespace osu.Game.Online.Rooms
             Ruleset.BindValueChanged(ruleset => RulesetID = ruleset.NewValue?.ID ?? 0);
         }
 
-        public void MapObjects(BeatmapManager beatmaps, RulesetStore rulesets)
+        public void MapObjects(RulesetStore rulesets)
         {
             Beatmap.Value ??= APIBeatmap;
             Ruleset.Value ??= rulesets.GetRuleset(RulesetID);
diff --git a/osu.Game/Screens/OnlinePlay/Components/RoomManager.cs b/osu.Game/Screens/OnlinePlay/Components/RoomManager.cs
index abda9e897b..ddfdab18f7 100644
--- a/osu.Game/Screens/OnlinePlay/Components/RoomManager.cs
+++ b/osu.Game/Screens/OnlinePlay/Components/RoomManager.cs
@@ -119,7 +119,7 @@ namespace osu.Game.Screens.OnlinePlay.Components
             try
             {
                 foreach (var pi in room.Playlist)
-                    pi.MapObjects(beatmaps, rulesets);
+                    pi.MapObjects(rulesets);
 
                 var existing = rooms.FirstOrDefault(e => e.RoomID.Value == room.RoomID.Value);
                 if (existing == null)
diff --git a/osu.Game/Screens/Play/SoloSpectator.cs b/osu.Game/Screens/Play/SoloSpectator.cs
index 6a73512f2d..ab324af705 100644
--- a/osu.Game/Screens/Play/SoloSpectator.cs
+++ b/osu.Game/Screens/Play/SoloSpectator.cs
@@ -51,7 +51,6 @@ namespace osu.Game.Screens.Play
         private Container beatmapPanelContainer;
         private TriangleButton watchButton;
         private SettingsCheckbox automaticDownload;
-        private APIBeatmapSet onlineBeatmap;
 
         /// <summary>
         /// The player's immediate online gameplay state.
@@ -61,6 +60,8 @@ namespace osu.Game.Screens.Play
 
         private GetBeatmapSetRequest onlineBeatmapRequest;
 
+        private APIBeatmapSet beatmapSet;
+
         public SoloSpectator([NotNull] User targetUser)
             : base(targetUser.Id)
         {
@@ -221,10 +222,10 @@ namespace osu.Game.Screens.Play
             Debug.Assert(state.BeatmapID != null);
 
             onlineBeatmapRequest = new GetBeatmapSetRequest(state.BeatmapID.Value, BeatmapSetLookupType.BeatmapId);
-            onlineBeatmapRequest.Success += res => Schedule(() =>
+            onlineBeatmapRequest.Success += beatmapSet => Schedule(() =>
             {
-                onlineBeatmap = res;
-                beatmapPanelContainer.Child = new GridBeatmapPanel(onlineBeatmap);
+                this.beatmapSet = beatmapSet;
+                beatmapPanelContainer.Child = new GridBeatmapPanel(this.beatmapSet);
                 checkForAutomaticDownload();
             });
 
@@ -233,14 +234,14 @@ namespace osu.Game.Screens.Play
 
         private void checkForAutomaticDownload()
         {
-            if (onlineBeatmap == null)
+            if (beatmapSet == null)
                 return;
 
             if (!automaticDownload.Current.Value)
                 return;
 
             // Used to interact with manager classes that don't support interface types. Will eventually be replaced.
-            var beatmapSetInfo = new BeatmapSetInfo { OnlineBeatmapSetID = onlineBeatmap.OnlineID };
+            var beatmapSetInfo = new BeatmapSetInfo { OnlineBeatmapSetID = beatmapSet.OnlineID };
 
             if (beatmaps.IsAvailableLocally(beatmapSetInfo))
                 return;

From 9f9c960fe38d16d66ae379b856ce0eb691d57b71 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 4 Nov 2021 13:36:32 +0900
Subject: [PATCH 0702/5547] Revert `PlaylistItem.APIBeatmap` to be private

---
 osu.Game/Online/Rooms/PlaylistItem.cs                         | 4 ++--
 .../OnlinePlay/Components/OnlinePlayBackgroundScreen.cs       | 4 +---
 .../OnlinePlay/Components/OnlinePlayBackgroundSprite.cs       | 2 +-
 .../Screens/OnlinePlay/Components/PlaylistItemBackground.cs   | 2 +-
 osu.Game/Screens/OnlinePlay/Match/DrawableMatchRoom.cs        | 2 +-
 5 files changed, 6 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Online/Rooms/PlaylistItem.cs b/osu.Game/Online/Rooms/PlaylistItem.cs
index 108477987b..cb550281a9 100644
--- a/osu.Game/Online/Rooms/PlaylistItem.cs
+++ b/osu.Game/Online/Rooms/PlaylistItem.cs
@@ -43,7 +43,7 @@ namespace osu.Game.Online.Rooms
         public readonly BindableList<Mod> RequiredMods = new BindableList<Mod>();
 
         [JsonProperty("beatmap")]
-        public APIBeatmap APIBeatmap { get; set; }
+        private APIBeatmap apiBeatmap { get; set; }
 
         private APIMod[] allowedModsBacking;
 
@@ -71,7 +71,7 @@ namespace osu.Game.Online.Rooms
 
         public void MapObjects(RulesetStore rulesets)
         {
-            Beatmap.Value ??= APIBeatmap;
+            Beatmap.Value ??= apiBeatmap;
             Ruleset.Value ??= rulesets.GetRuleset(RulesetID);
 
             Ruleset rulesetInstance = Ruleset.Value.CreateInstance();
diff --git a/osu.Game/Screens/OnlinePlay/Components/OnlinePlayBackgroundScreen.cs b/osu.Game/Screens/OnlinePlay/Components/OnlinePlayBackgroundScreen.cs
index 3e9b19cc17..279a8e1a14 100644
--- a/osu.Game/Screens/OnlinePlay/Components/OnlinePlayBackgroundScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Components/OnlinePlayBackgroundScreen.cs
@@ -60,10 +60,8 @@ namespace osu.Game.Screens.OnlinePlay.Components
         {
             Schedule(() =>
             {
-                var beatmap = playlistItem?.APIBeatmap;
-
                 string? lastCover = (background?.Beatmap?.BeatmapSet as IBeatmapSetOnlineInfo)?.Covers.Cover;
-                string? newCover = beatmap?.BeatmapSet?.Covers.Cover;
+                string? newCover = (background?.Beatmap?.BeatmapSet as IBeatmapSetOnlineInfo)?.Covers.Cover;
 
                 if (lastCover == newCover)
                     return;
diff --git a/osu.Game/Screens/OnlinePlay/Components/OnlinePlayBackgroundSprite.cs b/osu.Game/Screens/OnlinePlay/Components/OnlinePlayBackgroundSprite.cs
index 6df80a6d0a..e2ba0b03b0 100644
--- a/osu.Game/Screens/OnlinePlay/Components/OnlinePlayBackgroundSprite.cs
+++ b/osu.Game/Screens/OnlinePlay/Components/OnlinePlayBackgroundSprite.cs
@@ -30,7 +30,7 @@ namespace osu.Game.Screens.OnlinePlay.Components
 
         private void updateBeatmap()
         {
-            sprite.Beatmap.Value = Playlist.FirstOrDefault()?.APIBeatmap;
+            sprite.Beatmap.Value = Playlist.FirstOrDefault()?.Beatmap.Value;
         }
 
         protected virtual UpdateableBeatmapBackgroundSprite CreateBackgroundSprite() => new UpdateableBeatmapBackgroundSprite(BeatmapSetCoverType) { RelativeSizeAxes = Axes.Both };
diff --git a/osu.Game/Screens/OnlinePlay/Components/PlaylistItemBackground.cs b/osu.Game/Screens/OnlinePlay/Components/PlaylistItemBackground.cs
index bf44ca6263..f3e90aa396 100644
--- a/osu.Game/Screens/OnlinePlay/Components/PlaylistItemBackground.cs
+++ b/osu.Game/Screens/OnlinePlay/Components/PlaylistItemBackground.cs
@@ -17,7 +17,7 @@ namespace osu.Game.Screens.OnlinePlay.Components
 
         public PlaylistItemBackground(PlaylistItem? playlistItem)
         {
-            Beatmap = playlistItem?.APIBeatmap;
+            Beatmap = playlistItem?.Beatmap.Value;
         }
 
         [BackgroundDependencyLoader]
diff --git a/osu.Game/Screens/OnlinePlay/Match/DrawableMatchRoom.cs b/osu.Game/Screens/OnlinePlay/Match/DrawableMatchRoom.cs
index affcf32bd6..e83403850f 100644
--- a/osu.Game/Screens/OnlinePlay/Match/DrawableMatchRoom.cs
+++ b/osu.Game/Screens/OnlinePlay/Match/DrawableMatchRoom.cs
@@ -62,7 +62,7 @@ namespace osu.Game.Screens.OnlinePlay.Match
             if (editButton != null)
                 host.BindValueChanged(h => editButton.Alpha = h.NewValue?.Equals(api.LocalUser.Value) == true ? 1 : 0, true);
 
-            SelectedItem.BindValueChanged(item => background.Beatmap.Value = item.NewValue?.APIBeatmap, true);
+            SelectedItem.BindValueChanged(item => background.Beatmap.Value = item.NewValue?.Beatmap.Value, true);
         }
 
         protected override Drawable CreateBackground() => background = new BackgroundSprite();

From 0ab50f1cc9af44d2accd2d0bf8d720f614cb5dd4 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 4 Nov 2021 13:45:59 +0900
Subject: [PATCH 0703/5547] Add inline comment explaining why we are manually
 populating `beatmap.BeatmapSet`

---
 osu.Game/Online/Multiplayer/MultiplayerClient.cs | 12 +++++++++---
 1 file changed, 9 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Online/Multiplayer/MultiplayerClient.cs b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
index b80253684e..6c4747ea54 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
@@ -645,12 +645,19 @@ namespace osu.Game.Online.Multiplayer
 
             RoomUpdated?.Invoke();
 
-            GetOnlineBeatmapSet(settings.BeatmapID, cancellationToken).ContinueWith(set => Schedule(() =>
+            GetOnlineBeatmapSet(settings.BeatmapID, cancellationToken).ContinueWith(task => Schedule(() =>
             {
                 if (cancellationToken.IsCancellationRequested)
                     return;
 
-                updatePlaylist(settings, set.Result);
+                APIBeatmapSet beatmapSet = task.Result;
+
+                // The incoming response is deserialised without circular reference handling currently.
+                // Because we require using metadata from this instance, populate the nested beatmaps' sets manually here.
+                foreach (var b in beatmapSet.Beatmaps)
+                    b.BeatmapSet = beatmapSet;
+
+                updatePlaylist(settings, beatmapSet);
             }), TaskContinuationOptions.OnlyOnRanToCompletion);
         }, cancellationToken);
 
@@ -664,7 +671,6 @@ namespace osu.Game.Online.Multiplayer
             var beatmap = beatmapSet.Beatmaps.Single(b => b.OnlineID == settings.BeatmapID);
 
             beatmap.Checksum = settings.BeatmapChecksum;
-            beatmap.BeatmapSet = beatmapSet;
 
             var ruleset = Rulesets.GetRuleset(settings.RulesetID).CreateInstance();
             var mods = settings.RequiredMods.Select(m => m.ToMod(ruleset));

From 0df339d0b8a08a4042f50375428d3fe8d9af928a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 4 Nov 2021 13:50:04 +0900
Subject: [PATCH 0704/5547] Fix incorrect invocation of download method in
 `SoloSpectator`

---
 osu.Game/Screens/Play/SoloSpectator.cs | 7 ++-----
 1 file changed, 2 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Screens/Play/SoloSpectator.cs b/osu.Game/Screens/Play/SoloSpectator.cs
index ab324af705..250738df39 100644
--- a/osu.Game/Screens/Play/SoloSpectator.cs
+++ b/osu.Game/Screens/Play/SoloSpectator.cs
@@ -240,13 +240,10 @@ namespace osu.Game.Screens.Play
             if (!automaticDownload.Current.Value)
                 return;
 
-            // Used to interact with manager classes that don't support interface types. Will eventually be replaced.
-            var beatmapSetInfo = new BeatmapSetInfo { OnlineBeatmapSetID = beatmapSet.OnlineID };
-
-            if (beatmaps.IsAvailableLocally(beatmapSetInfo))
+            if (beatmaps.IsAvailableLocally(new BeatmapSetInfo { OnlineBeatmapSetID = beatmapSet.OnlineID }))
                 return;
 
-            beatmaps.Download(beatmapSetInfo);
+            beatmaps.Download(beatmapSet);
         }
 
         public override bool OnExiting(IScreen next)

From 67d9590a79f695b38f999dfdcc1f105238162920 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 4 Nov 2021 13:59:40 +0900
Subject: [PATCH 0705/5547] Fix new inspections

---
 osu.Game.Tests/Editing/Checks/CheckAudioQualityTest.cs |  2 +-
 osu.Game/Beatmaps/BeatmapManager.cs                    |  8 ++++----
 osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs      | 10 +++++-----
 osu.Game/Screens/Select/Carousel/CarouselBeatmapSet.cs |  2 +-
 4 files changed, 11 insertions(+), 11 deletions(-)

diff --git a/osu.Game.Tests/Editing/Checks/CheckAudioQualityTest.cs b/osu.Game.Tests/Editing/Checks/CheckAudioQualityTest.cs
index 39fbf11d51..e22dfa5f8b 100644
--- a/osu.Game.Tests/Editing/Checks/CheckAudioQualityTest.cs
+++ b/osu.Game.Tests/Editing/Checks/CheckAudioQualityTest.cs
@@ -35,7 +35,7 @@ namespace osu.Game.Tests.Editing.Checks
         public void TestMissing()
         {
             // While this is a problem, it is out of scope for this check and is caught by a different one.
-            beatmap.Metadata.AudioFile = null;
+            beatmap.Metadata.AudioFile = string.Empty;
 
             var mock = new Mock<IWorkingBeatmap>();
             mock.SetupGet(w => w.Beatmap).Returns(beatmap);
diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index 2fa8bd4990..7a9f3e0a45 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -258,10 +258,10 @@ namespace osu.Game.Beatmaps
                 OnlineBeatmapSetID = model.OnlineID,
                 Metadata = new BeatmapMetadata
                 {
-                    Title = model.Metadata?.Title,
-                    Artist = model.Metadata?.Artist,
-                    TitleUnicode = model.Metadata?.TitleUnicode,
-                    ArtistUnicode = model.Metadata?.ArtistUnicode,
+                    Title = model.Metadata?.Title ?? string.Empty,
+                    Artist = model.Metadata?.Artist ?? string.Empty,
+                    TitleUnicode = model.Metadata?.TitleUnicode ?? string.Empty,
+                    ArtistUnicode = model.Metadata?.ArtistUnicode ?? string.Empty,
                     Author = new User { Username = model.Metadata?.Author },
                 }
             }, minimiseDownloadSize);
diff --git a/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs b/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs
index 89541a0845..3ed5055b7f 100644
--- a/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs
+++ b/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs
@@ -82,7 +82,7 @@ namespace osu.Game.Beatmaps.Formats
         {
             writer.WriteLine("[General]");
 
-            if (beatmap.Metadata.AudioFile != null) writer.WriteLine(FormattableString.Invariant($"AudioFilename: {Path.GetFileName(beatmap.Metadata.AudioFile)}"));
+            if (!string.IsNullOrEmpty(beatmap.Metadata.AudioFile)) writer.WriteLine(FormattableString.Invariant($"AudioFilename: {Path.GetFileName(beatmap.Metadata.AudioFile)}"));
             writer.WriteLine(FormattableString.Invariant($"AudioLeadIn: {beatmap.BeatmapInfo.AudioLeadIn}"));
             writer.WriteLine(FormattableString.Invariant($"PreviewTime: {beatmap.Metadata.PreviewTime}"));
             writer.WriteLine(FormattableString.Invariant($"Countdown: {(int)beatmap.BeatmapInfo.Countdown}"));
@@ -126,13 +126,13 @@ namespace osu.Game.Beatmaps.Formats
             writer.WriteLine("[Metadata]");
 
             writer.WriteLine(FormattableString.Invariant($"Title: {beatmap.Metadata.Title}"));
-            if (beatmap.Metadata.TitleUnicode != null) writer.WriteLine(FormattableString.Invariant($"TitleUnicode: {beatmap.Metadata.TitleUnicode}"));
+            if (!string.IsNullOrEmpty(beatmap.Metadata.TitleUnicode)) writer.WriteLine(FormattableString.Invariant($"TitleUnicode: {beatmap.Metadata.TitleUnicode}"));
             writer.WriteLine(FormattableString.Invariant($"Artist: {beatmap.Metadata.Artist}"));
-            if (beatmap.Metadata.ArtistUnicode != null) writer.WriteLine(FormattableString.Invariant($"ArtistUnicode: {beatmap.Metadata.ArtistUnicode}"));
+            if (!string.IsNullOrEmpty(beatmap.Metadata.ArtistUnicode)) writer.WriteLine(FormattableString.Invariant($"ArtistUnicode: {beatmap.Metadata.ArtistUnicode}"));
             writer.WriteLine(FormattableString.Invariant($"Creator: {beatmap.Metadata.AuthorString}"));
             writer.WriteLine(FormattableString.Invariant($"Version: {beatmap.BeatmapInfo.Version}"));
-            if (beatmap.Metadata.Source != null) writer.WriteLine(FormattableString.Invariant($"Source: {beatmap.Metadata.Source}"));
-            if (beatmap.Metadata.Tags != null) writer.WriteLine(FormattableString.Invariant($"Tags: {beatmap.Metadata.Tags}"));
+            if (!string.IsNullOrEmpty(beatmap.Metadata.Source)) writer.WriteLine(FormattableString.Invariant($"Source: {beatmap.Metadata.Source}"));
+            if (!string.IsNullOrEmpty(beatmap.Metadata.Tags)) writer.WriteLine(FormattableString.Invariant($"Tags: {beatmap.Metadata.Tags}"));
             if (beatmap.BeatmapInfo.OnlineBeatmapID != null) writer.WriteLine(FormattableString.Invariant($"BeatmapID: {beatmap.BeatmapInfo.OnlineBeatmapID}"));
             if (beatmap.BeatmapInfo.BeatmapSet?.OnlineBeatmapSetID != null) writer.WriteLine(FormattableString.Invariant($"BeatmapSetID: {beatmap.BeatmapInfo.BeatmapSet.OnlineBeatmapSetID}"));
         }
diff --git a/osu.Game/Screens/Select/Carousel/CarouselBeatmapSet.cs b/osu.Game/Screens/Select/Carousel/CarouselBeatmapSet.cs
index e465f423bc..d41cb73a29 100644
--- a/osu.Game/Screens/Select/Carousel/CarouselBeatmapSet.cs
+++ b/osu.Game/Screens/Select/Carousel/CarouselBeatmapSet.cs
@@ -69,7 +69,7 @@ namespace osu.Game.Screens.Select.Carousel
                     return string.Compare(BeatmapSet.Metadata.Title, otherSet.BeatmapSet.Metadata.Title, StringComparison.OrdinalIgnoreCase);
 
                 case SortMode.Author:
-                    return string.Compare(BeatmapSet.Metadata.Author.Username, otherSet.BeatmapSet.Metadata.Author.Username, StringComparison.OrdinalIgnoreCase);
+                    return string.Compare(BeatmapSet.Metadata.Author?.Username, otherSet.BeatmapSet.Metadata.Author?.Username, StringComparison.OrdinalIgnoreCase);
 
                 case SortMode.Source:
                     return string.Compare(BeatmapSet.Metadata.Source, otherSet.BeatmapSet.Metadata.Source, StringComparison.OrdinalIgnoreCase);

From 41854f2e16890d34a1ece354e507119556660697 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 4 Nov 2021 14:01:01 +0900
Subject: [PATCH 0706/5547] Fix incorrect check on `AudioFile` presence

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

diff --git a/osu.Game/Beatmaps/WorkingBeatmapCache.cs b/osu.Game/Beatmaps/WorkingBeatmapCache.cs
index 65f84984c2..40ae627619 100644
--- a/osu.Game/Beatmaps/WorkingBeatmapCache.cs
+++ b/osu.Game/Beatmaps/WorkingBeatmapCache.cs
@@ -165,7 +165,7 @@ namespace osu.Game.Beatmaps
 
             protected override Track GetBeatmapTrack()
             {
-                if (Metadata?.AudioFile == null)
+                if (string.IsNullOrEmpty(Metadata?.AudioFile))
                     return null;
 
                 try
@@ -181,7 +181,7 @@ namespace osu.Game.Beatmaps
 
             protected override Waveform GetWaveform()
             {
-                if (Metadata?.AudioFile == null)
+                if (string.IsNullOrEmpty(Metadata?.AudioFile))
                     return null;
 
                 try

From 1e73b09e578cb949bfee28829aef68042216f201 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 4 Nov 2021 14:11:21 +0900
Subject: [PATCH 0707/5547] Fix another couple of cases of incorrect string
 null/empty checking

---
 osu.Game/Beatmaps/WorkingBeatmapCache.cs           | 2 +-
 osu.Game/Rulesets/Edit/Checks/CheckAudioQuality.cs | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Beatmaps/WorkingBeatmapCache.cs b/osu.Game/Beatmaps/WorkingBeatmapCache.cs
index 40ae627619..11257e3abc 100644
--- a/osu.Game/Beatmaps/WorkingBeatmapCache.cs
+++ b/osu.Game/Beatmaps/WorkingBeatmapCache.cs
@@ -149,7 +149,7 @@ namespace osu.Game.Beatmaps
 
             protected override Texture GetBackground()
             {
-                if (Metadata?.BackgroundFile == null)
+                if (string.IsNullOrEmpty(Metadata?.BackgroundFile))
                     return null;
 
                 try
diff --git a/osu.Game/Rulesets/Edit/Checks/CheckAudioQuality.cs b/osu.Game/Rulesets/Edit/Checks/CheckAudioQuality.cs
index 08e0312b64..ec2ff68aad 100644
--- a/osu.Game/Rulesets/Edit/Checks/CheckAudioQuality.cs
+++ b/osu.Game/Rulesets/Edit/Checks/CheckAudioQuality.cs
@@ -28,7 +28,7 @@ namespace osu.Game.Rulesets.Edit.Checks
         public IEnumerable<Issue> Run(BeatmapVerifierContext context)
         {
             string audioFile = context.Beatmap.Metadata?.AudioFile;
-            if (audioFile == null)
+            if (string.IsNullOrEmpty(audioFile))
                 yield break;
 
             var track = context.WorkingBeatmap.Track;

From a49366ff84328c44267c98b9b9d83d47170fb3b0 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 4 Nov 2021 14:25:30 +0900
Subject: [PATCH 0708/5547] Remove nullability from `IBeatmapInfo.Metadata`

---
 osu.Game/Beatmaps/BeatmapInfo.cs                       |  2 +-
 osu.Game/Beatmaps/BeatmapInfoExtensions.cs             | 10 +++-------
 osu.Game/Beatmaps/IBeatmapInfo.cs                      |  2 +-
 .../Screens/OnlinePlay/DrawableRoomPlaylistItem.cs     |  2 +-
 4 files changed, 6 insertions(+), 10 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapInfo.cs b/osu.Game/Beatmaps/BeatmapInfo.cs
index 9069ea4404..00a0c49298 100644
--- a/osu.Game/Beatmaps/BeatmapInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapInfo.cs
@@ -186,7 +186,7 @@ namespace osu.Game.Beatmaps
         string IBeatmapInfo.DifficultyName => Version;
 
         [JsonIgnore]
-        IBeatmapMetadataInfo IBeatmapInfo.Metadata => Metadata;
+        IBeatmapMetadataInfo IBeatmapInfo.Metadata => Metadata ?? BeatmapSet.Metadata;
 
         [JsonIgnore]
         IBeatmapDifficultyInfo IBeatmapInfo.Difficulty => BaseDifficulty;
diff --git a/osu.Game/Beatmaps/BeatmapInfoExtensions.cs b/osu.Game/Beatmaps/BeatmapInfoExtensions.cs
index 2d69015933..707b588063 100644
--- a/osu.Game/Beatmaps/BeatmapInfoExtensions.cs
+++ b/osu.Game/Beatmaps/BeatmapInfoExtensions.cs
@@ -11,14 +11,14 @@ namespace osu.Game.Beatmaps
         /// <summary>
         /// A user-presentable display title representing this beatmap.
         /// </summary>
-        public static string GetDisplayTitle(this IBeatmapInfo beatmapInfo) => $"{getClosestMetadata(beatmapInfo)} {getVersionString(beatmapInfo)}".Trim();
+        public static string GetDisplayTitle(this IBeatmapInfo beatmapInfo) => $"{beatmapInfo.Metadata} {getVersionString(beatmapInfo)}".Trim();
 
         /// <summary>
         /// A user-presentable display title representing this beatmap, with localisation handling for potentially romanisable fields.
         /// </summary>
         public static RomanisableString GetDisplayTitleRomanisable(this IBeatmapInfo beatmapInfo, bool includeDifficultyName = true, bool includeCreator = true)
         {
-            var metadata = getClosestMetadata(beatmapInfo).GetDisplayTitleRomanisable(includeCreator);
+            var metadata = beatmapInfo.Metadata.GetDisplayTitleRomanisable(includeCreator);
 
             if (includeDifficultyName)
             {
@@ -32,12 +32,8 @@ namespace osu.Game.Beatmaps
         public static string[] GetSearchableTerms(this IBeatmapInfo beatmapInfo) => new[]
         {
             beatmapInfo.DifficultyName
-        }.Concat(getClosestMetadata(beatmapInfo).GetSearchableTerms()).Where(s => !string.IsNullOrEmpty(s)).ToArray();
+        }.Concat(beatmapInfo.Metadata.GetSearchableTerms()).Where(s => !string.IsNullOrEmpty(s)).ToArray();
 
         private static string getVersionString(IBeatmapInfo beatmapInfo) => string.IsNullOrEmpty(beatmapInfo.DifficultyName) ? string.Empty : $"[{beatmapInfo.DifficultyName}]";
-
-        // temporary helper methods until we figure which metadata should be where.
-        private static IBeatmapMetadataInfo getClosestMetadata(IBeatmapInfo beatmapInfo) =>
-            beatmapInfo.Metadata ?? beatmapInfo.BeatmapSet?.Metadata ?? new BeatmapMetadata();
     }
 }
diff --git a/osu.Game/Beatmaps/IBeatmapInfo.cs b/osu.Game/Beatmaps/IBeatmapInfo.cs
index d206cfaaed..84ea6d3019 100644
--- a/osu.Game/Beatmaps/IBeatmapInfo.cs
+++ b/osu.Game/Beatmaps/IBeatmapInfo.cs
@@ -21,7 +21,7 @@ namespace osu.Game.Beatmaps
         /// <summary>
         /// The metadata representing this beatmap. May be shared between multiple beatmaps.
         /// </summary>
-        IBeatmapMetadataInfo? Metadata { get; }
+        IBeatmapMetadataInfo Metadata { get; }
 
         /// <summary>
         /// The difficulty settings for this beatmap.
diff --git a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
index a7cce67fa3..0681ac23ad 100644
--- a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
+++ b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
@@ -119,7 +119,7 @@ namespace osu.Game.Screens.OnlinePlay
 
             authorText.Clear();
 
-            if (Item.Beatmap.Value?.Metadata?.Author != null)
+            if (!string.IsNullOrEmpty(Item.Beatmap.Value?.Metadata.Author))
             {
                 authorText.AddText("mapped by ");
                 authorText.AddUserLink(new User { Username = Item.Beatmap.Value.Metadata.Author });

From d1e6d1cb987a3d825a4c3923eceeeadfc544ec3e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 4 Nov 2021 14:50:39 +0900
Subject: [PATCH 0709/5547] Update some other missed incorrect null/empty
 usages

---
 .../Editing/Checks/CheckBackgroundQualityTest.cs     |  2 +-
 .../Editing/Checks/CheckFilePresenceTest.cs          |  2 +-
 .../NonVisual/Filtering/FilterMatchingTest.cs        |  2 +-
 .../Visual/Editing/TestSceneMetadataSection.cs       | 12 ++++++------
 .../Visual/Gameplay/TestSceneReplayRecording.cs      |  4 ++--
 .../Select/Carousel/DrawableCarouselBeatmap.cs       |  2 +-
 osu.Game/Storyboards/Storyboard.cs                   |  4 ++--
 7 files changed, 14 insertions(+), 14 deletions(-)

diff --git a/osu.Game.Tests/Editing/Checks/CheckBackgroundQualityTest.cs b/osu.Game.Tests/Editing/Checks/CheckBackgroundQualityTest.cs
index 3424cfe732..2918dde2db 100644
--- a/osu.Game.Tests/Editing/Checks/CheckBackgroundQualityTest.cs
+++ b/osu.Game.Tests/Editing/Checks/CheckBackgroundQualityTest.cs
@@ -53,7 +53,7 @@ namespace osu.Game.Tests.Editing.Checks
         public void TestMissing()
         {
             // While this is a problem, it is out of scope for this check and is caught by a different one.
-            beatmap.Metadata.BackgroundFile = null;
+            beatmap.Metadata.BackgroundFile = string.Empty;
             var context = getContext(null, System.Array.Empty<byte>());
 
             Assert.That(check.Run(context), Is.Empty);
diff --git a/osu.Game.Tests/Editing/Checks/CheckFilePresenceTest.cs b/osu.Game.Tests/Editing/Checks/CheckFilePresenceTest.cs
index 39a1d76d83..70e4c76b19 100644
--- a/osu.Game.Tests/Editing/Checks/CheckFilePresenceTest.cs
+++ b/osu.Game.Tests/Editing/Checks/CheckFilePresenceTest.cs
@@ -65,7 +65,7 @@ namespace osu.Game.Tests.Editing.Checks
         [Test]
         public void TestBackgroundNotSet()
         {
-            beatmap.Metadata.BackgroundFile = null;
+            beatmap.Metadata.BackgroundFile = string.Empty;
 
             var context = new BeatmapVerifierContext(beatmap, new TestWorkingBeatmap(beatmap));
             var issues = check.Run(context).ToList();
diff --git a/osu.Game.Tests/NonVisual/Filtering/FilterMatchingTest.cs b/osu.Game.Tests/NonVisual/Filtering/FilterMatchingTest.cs
index ed86daf8b6..41939cec3f 100644
--- a/osu.Game.Tests/NonVisual/Filtering/FilterMatchingTest.cs
+++ b/osu.Game.Tests/NonVisual/Filtering/FilterMatchingTest.cs
@@ -189,7 +189,7 @@ namespace osu.Game.Tests.NonVisual.Filtering
         public void TestCriteriaMatchingArtistWithNullUnicodeName(string artistName, bool filtered)
         {
             var exampleBeatmapInfo = getExampleBeatmap();
-            exampleBeatmapInfo.Metadata.ArtistUnicode = null;
+            exampleBeatmapInfo.Metadata.ArtistUnicode = string.Empty;
 
             var criteria = new FilterCriteria
             {
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneMetadataSection.cs b/osu.Game.Tests/Visual/Editing/TestSceneMetadataSection.cs
index 19081f3281..4621436cc6 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneMetadataSection.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneMetadataSection.cs
@@ -23,10 +23,10 @@ namespace osu.Game.Tests.Visual.Editing
             AddStep("set metadata", () =>
             {
                 editorBeatmap.Metadata.Artist = "Example Artist";
-                editorBeatmap.Metadata.ArtistUnicode = null;
+                editorBeatmap.Metadata.ArtistUnicode = string.Empty;
 
                 editorBeatmap.Metadata.Title = "Example Title";
-                editorBeatmap.Metadata.TitleUnicode = null;
+                editorBeatmap.Metadata.TitleUnicode = string.Empty;
             });
 
             createSection();
@@ -44,10 +44,10 @@ namespace osu.Game.Tests.Visual.Editing
             AddStep("set metadata", () =>
             {
                 editorBeatmap.Metadata.ArtistUnicode = "＊なみりん";
-                editorBeatmap.Metadata.Artist = null;
+                editorBeatmap.Metadata.Artist = string.Empty;
 
                 editorBeatmap.Metadata.TitleUnicode = "コイシテイク・プラネット";
-                editorBeatmap.Metadata.Title = null;
+                editorBeatmap.Metadata.Title = string.Empty;
             });
 
             createSection();
@@ -86,10 +86,10 @@ namespace osu.Game.Tests.Visual.Editing
             AddStep("set metadata", () =>
             {
                 editorBeatmap.Metadata.ArtistUnicode = "＊なみりん";
-                editorBeatmap.Metadata.Artist = null;
+                editorBeatmap.Metadata.Artist = string.Empty;
 
                 editorBeatmap.Metadata.TitleUnicode = "コイシテイク・プラネット";
-                editorBeatmap.Metadata.Title = null;
+                editorBeatmap.Metadata.Title = string.Empty;
             });
 
             createSection();
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneReplayRecording.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneReplayRecording.cs
index 3545fc96e8..08578168d6 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneReplayRecording.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneReplayRecording.cs
@@ -54,7 +54,7 @@ namespace osu.Game.Tests.Visual.Gameplay
                                 ScoreInfo = { BeatmapInfo = gameplayState.Beatmap.BeatmapInfo }
                             })
                             {
-                                ScreenSpaceToGamefield = pos => recordingManager.ToLocalSpace(pos)
+                                ScreenSpaceToGamefield = pos => recordingManager?.ToLocalSpace(pos) ?? Vector2.Zero,
                             },
                             Child = new Container
                             {
@@ -84,7 +84,7 @@ namespace osu.Game.Tests.Visual.Gameplay
                         {
                             ReplayInputHandler = new TestFramedReplayInputHandler(replay)
                             {
-                                GamefieldToScreenSpace = pos => playbackManager.ToScreenSpace(pos),
+                                GamefieldToScreenSpace = pos => playbackManager?.ToScreenSpace(pos) ?? Vector2.Zero,
                             },
                             Child = new Container
                             {
diff --git a/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmap.cs b/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmap.cs
index 5940911d4a..8a5dde961f 100644
--- a/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmap.cs
+++ b/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmap.cs
@@ -142,7 +142,7 @@ namespace osu.Game.Screens.Select.Carousel
                                         },
                                         new OsuSpriteText
                                         {
-                                            Text = $"{(beatmapInfo.Metadata ?? beatmapInfo.BeatmapSet.Metadata).Author.Username}",
+                                            Text = $"{(beatmapInfo.Metadata ?? beatmapInfo.BeatmapSet.Metadata).Author?.Username ?? string.Empty}",
                                             Font = OsuFont.GetFont(italics: true),
                                             Anchor = Anchor.BottomLeft,
                                             Origin = Anchor.BottomLeft
diff --git a/osu.Game/Storyboards/Storyboard.cs b/osu.Game/Storyboards/Storyboard.cs
index a25bf24491..99123627bd 100644
--- a/osu.Game/Storyboards/Storyboard.cs
+++ b/osu.Game/Storyboards/Storyboard.cs
@@ -77,8 +77,8 @@ namespace osu.Game.Storyboards
         {
             get
             {
-                string backgroundPath = BeatmapInfo.BeatmapSet?.Metadata?.BackgroundFile?.ToLowerInvariant();
-                if (backgroundPath == null)
+                string backgroundPath = BeatmapInfo.BeatmapSet?.Metadata?.BackgroundFile.ToLowerInvariant();
+                if (string.IsNullOrEmpty(backgroundPath))
                     return false;
 
                 return GetLayer("Background").Elements.Any(e => e.Path.ToLowerInvariant() == backgroundPath);

From 09f9731d74fb021188b98190dac6bfba0b105cc4 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 4 Nov 2021 15:09:04 +0900
Subject: [PATCH 0710/5547] Add temporary disable of failing r# inspection

---
 osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs b/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs
index d37e09aa29..7a95856c36 100644
--- a/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs
+++ b/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs
@@ -673,6 +673,8 @@ namespace osu.Game.Tests.Beatmaps.Formats
                 Assert.That(first.ControlPoints[1].Position, Is.EqualTo(new Vector2(161, -244)));
                 Assert.That(first.ControlPoints[1].Type, Is.EqualTo(null));
 
+                // ReSharper disable once HeuristicUnreachableCode
+                // weird one, see https://youtrack.jetbrains.com/issue/RIDER-70159.
                 Assert.That(first.ControlPoints[2].Position, Is.EqualTo(new Vector2(376, -3)));
                 Assert.That(first.ControlPoints[2].Type, Is.EqualTo(PathType.Bezier));
                 Assert.That(first.ControlPoints[3].Position, Is.EqualTo(new Vector2(68, 15)));

From e43d91ad5d82cc338802f312411a24abe411f3bc Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 4 Nov 2021 15:18:10 +0900
Subject: [PATCH 0711/5547] Fix another case of incorrect null checking in
 editor verification processing

---
 osu.Game/Rulesets/Edit/Checks/CheckFilePresence.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Rulesets/Edit/Checks/CheckFilePresence.cs b/osu.Game/Rulesets/Edit/Checks/CheckFilePresence.cs
index abedee143a..33bcac1e75 100644
--- a/osu.Game/Rulesets/Edit/Checks/CheckFilePresence.cs
+++ b/osu.Game/Rulesets/Edit/Checks/CheckFilePresence.cs
@@ -25,7 +25,7 @@ namespace osu.Game.Rulesets.Edit.Checks
         {
             string filename = GetFilename(context.Beatmap);
 
-            if (filename == null)
+            if (string.IsNullOrEmpty(filename))
             {
                 yield return new IssueTemplateNoneSet(this).Create(TypeOfFile);
 

From 84d36cbae723e753f67deefcf48b94ad7b6807d9 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 4 Nov 2021 15:22:32 +0900
Subject: [PATCH 0712/5547] Add fallback for cases where `BeatmapSet` may be
 null

Seems to only happen in tests, but better safe than sorry.
---
 osu.Game/Beatmaps/BeatmapInfo.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Beatmaps/BeatmapInfo.cs b/osu.Game/Beatmaps/BeatmapInfo.cs
index 00a0c49298..952e205aa0 100644
--- a/osu.Game/Beatmaps/BeatmapInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapInfo.cs
@@ -186,7 +186,7 @@ namespace osu.Game.Beatmaps
         string IBeatmapInfo.DifficultyName => Version;
 
         [JsonIgnore]
-        IBeatmapMetadataInfo IBeatmapInfo.Metadata => Metadata ?? BeatmapSet.Metadata;
+        IBeatmapMetadataInfo IBeatmapInfo.Metadata => Metadata ?? BeatmapSet?.Metadata ?? new BeatmapMetadata();
 
         [JsonIgnore]
         IBeatmapDifficultyInfo IBeatmapInfo.Difficulty => BaseDifficulty;

From e3a9fbecfea26045e819fbeabb51ecb15d7ca343 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 1 Nov 2021 16:42:22 +0900
Subject: [PATCH 0713/5547] Add method to create sample `APIBeatmap` (with
 `BeatmapSet` populated)

---
 osu.Game/Tests/Visual/OsuTestScene.cs | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/osu.Game/Tests/Visual/OsuTestScene.cs b/osu.Game/Tests/Visual/OsuTestScene.cs
index 90e85f7716..090a085f71 100644
--- a/osu.Game/Tests/Visual/OsuTestScene.cs
+++ b/osu.Game/Tests/Visual/OsuTestScene.cs
@@ -175,6 +175,28 @@ namespace osu.Game.Tests.Visual
 
         protected virtual IBeatmap CreateBeatmap(RulesetInfo ruleset) => new TestBeatmap(ruleset);
 
+        /// <summary>
+        /// Returns a sample API Beatmap with BeatmapSet populated.
+        /// </summary>
+        /// <param name="ruleset">The ruleset to create the sample model using.</param>
+        protected APIBeatmap CreateAPIBeatmap(RulesetInfo ruleset)
+        {
+            var beatmapSet = CreateAPIBeatmapSet(ruleset);
+
+            // Avoid circular reference.
+            var beatmap = beatmapSet.Beatmaps.First();
+            beatmapSet.Beatmaps = Array.Empty<APIBeatmap>();
+
+            // Populate the set as that's generally what we expect from the API.
+            beatmap.BeatmapSet = beatmapSet;
+
+            return beatmap;
+        }
+
+        /// <summary>
+        /// Returns a sample API BeatmapSet with beatmaps populated.
+        /// </summary>
+        /// <param name="ruleset">The ruleset to create the sample model using.</param>
         protected APIBeatmapSet CreateAPIBeatmapSet(RulesetInfo ruleset)
         {
             var beatmap = CreateBeatmap(ruleset).BeatmapInfo;

From 66f4516eee5b871ce82954bde74dad69319286dd Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 1 Nov 2021 16:43:39 +0900
Subject: [PATCH 0714/5547] Allow creating sample API models without specifying
 a ruleset

---
 .../Multiplayer/TestSceneDrawableRoomPlaylist.cs | 16 +++++++++-------
 .../Online/TestSceneDirectDownloadButton.cs      |  5 ++---
 .../TestSceneUpdateableBeatmapSetCover.cs        |  6 +++---
 osu.Game/Tests/Visual/OsuTestScene.cs            | 12 ++++++------
 4 files changed, 20 insertions(+), 19 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
index f44b0c9716..5dfa055d7d 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
@@ -6,6 +6,7 @@ using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
+using osu.Framework.Extensions.IEnumerableExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Platform;
@@ -202,7 +203,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [Test]
         public void TestDownloadButtonHiddenWhenBeatmapExists()
         {
-            var beatmap = new TestBeatmap(new OsuRuleset().RulesetInfo).BeatmapInfo;
+            var beatmap = CreateAPIBeatmapSet();
 
             AddStep("import beatmap", () => manager.Import(beatmap.BeatmapSet).Wait());
 
@@ -223,11 +224,11 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [Test]
         public void TestDownloadButtonVisibleInitiallyWhenBeatmapDoesNotExist()
         {
-            var byOnlineId = new TestBeatmap(new OsuRuleset().RulesetInfo).BeatmapInfo;
-            byOnlineId.BeatmapSet.OnlineBeatmapSetID = 1337; // Some random ID that does not exist locally.
+            var byOnlineId = CreateAPIBeatmapSet();
+            byOnlineId.OnlineID = 1337; // Some random ID that does not exist locally.
 
-            var byChecksum = new TestBeatmap(new OsuRuleset().RulesetInfo).BeatmapInfo;
-            byChecksum.MD5Hash = "1337"; // Some random checksum that does not exist locally.
+            var byChecksum = CreateAPIBeatmapSet();
+            byChecksum.Beatmaps.ForEach(b => b.Checksum = "1337"); // Some random checksum that does not exist locally.
 
             createPlaylist(byOnlineId, byChecksum);
 
@@ -237,8 +238,9 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [Test]
         public void TestExplicitBeatmapItem()
         {
-            var beatmap = new TestBeatmap(new OsuRuleset().RulesetInfo).BeatmapInfo;
-            beatmap.BeatmapSet.OnlineInfo.HasExplicitContent = true;
+            var beatmap = CreateAPIBeatmapSet();
+
+            beatmap.HasExplicitContent = true;
 
             createPlaylist(beatmap);
         }
diff --git a/osu.Game.Tests/Visual/Online/TestSceneDirectDownloadButton.cs b/osu.Game.Tests/Visual/Online/TestSceneDirectDownloadButton.cs
index f0cf88840a..3d828077c8 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneDirectDownloadButton.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneDirectDownloadButton.cs
@@ -9,7 +9,6 @@ using osu.Game.Beatmaps;
 using osu.Game.Online;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays.BeatmapListing.Panels;
-using osu.Game.Rulesets.Osu;
 using osu.Game.Tests.Resources;
 using osuTK;
 
@@ -110,7 +109,7 @@ namespace osu.Game.Tests.Visual.Online
 
         private IBeatmapSetInfo getDownloadableBeatmapSet()
         {
-            var apiBeatmapSet = CreateWorkingBeatmap(new OsuRuleset().RulesetInfo).BeatmapSetInfo.OnlineInfo;
+            var apiBeatmapSet = CreateAPIBeatmapSet();
 
             apiBeatmapSet.HasVideo = true;
             apiBeatmapSet.HasStoryboard = true;
@@ -120,7 +119,7 @@ namespace osu.Game.Tests.Visual.Online
 
         private IBeatmapSetInfo getUndownloadableBeatmapSet()
         {
-            var apiBeatmapSet = CreateWorkingBeatmap(new OsuRuleset().RulesetInfo).BeatmapSetInfo.OnlineInfo;
+            var apiBeatmapSet = CreateAPIBeatmapSet();
 
             apiBeatmapSet.Artist = "test";
             apiBeatmapSet.Title = "undownloadable";
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneUpdateableBeatmapSetCover.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneUpdateableBeatmapSetCover.cs
index f67f6258cc..6896e7a67a 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneUpdateableBeatmapSetCover.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneUpdateableBeatmapSetCover.cs
@@ -25,7 +25,7 @@ namespace osu.Game.Tests.Visual.UserInterface
         {
             AddStep("setup cover", () => Child = new UpdateableOnlineBeatmapSetCover(coverType)
             {
-                OnlineInfo = CreateBeatmap(Ruleset.Value).BeatmapInfo.BeatmapSet.OnlineInfo,
+                OnlineInfo = CreateAPIBeatmapSet(),
                 RelativeSizeAxes = Axes.Both,
                 Masking = true,
             });
@@ -41,7 +41,7 @@ namespace osu.Game.Tests.Visual.UserInterface
 
             AddStep("setup covers", () =>
             {
-                BeatmapSetInfo setInfo = CreateBeatmap(Ruleset.Value).BeatmapInfo.BeatmapSet;
+                var beatmapSet = CreateAPIBeatmapSet();
 
                 FillFlowContainer fillFlow;
 
@@ -99,7 +99,7 @@ namespace osu.Game.Tests.Visual.UserInterface
 
             AddStep("setup cover", () => Child = updateableCover = new TestUpdateableOnlineBeatmapSetCover
             {
-                OnlineInfo = CreateBeatmap(Ruleset.Value).BeatmapInfo.BeatmapSet.OnlineInfo,
+                OnlineInfo = CreateAPIBeatmapSet(),
                 RelativeSizeAxes = Axes.Both,
                 Masking = true,
             });
diff --git a/osu.Game/Tests/Visual/OsuTestScene.cs b/osu.Game/Tests/Visual/OsuTestScene.cs
index 090a085f71..e25cbaf467 100644
--- a/osu.Game/Tests/Visual/OsuTestScene.cs
+++ b/osu.Game/Tests/Visual/OsuTestScene.cs
@@ -178,10 +178,10 @@ namespace osu.Game.Tests.Visual
         /// <summary>
         /// Returns a sample API Beatmap with BeatmapSet populated.
         /// </summary>
-        /// <param name="ruleset">The ruleset to create the sample model using.</param>
-        protected APIBeatmap CreateAPIBeatmap(RulesetInfo ruleset)
+        /// <param name="ruleset">The ruleset to create the sample model using. osu! ruleset will be used if not specified.</param>
+        protected APIBeatmap CreateAPIBeatmap(RulesetInfo ruleset = null)
         {
-            var beatmapSet = CreateAPIBeatmapSet(ruleset);
+            var beatmapSet = CreateAPIBeatmapSet(ruleset ?? Ruleset.Value);
 
             // Avoid circular reference.
             var beatmap = beatmapSet.Beatmaps.First();
@@ -196,10 +196,10 @@ namespace osu.Game.Tests.Visual
         /// <summary>
         /// Returns a sample API BeatmapSet with beatmaps populated.
         /// </summary>
-        /// <param name="ruleset">The ruleset to create the sample model using.</param>
-        protected APIBeatmapSet CreateAPIBeatmapSet(RulesetInfo ruleset)
+        /// <param name="ruleset">The ruleset to create the sample model using. osu! ruleset will be used if not specified.</param>
+        protected APIBeatmapSet CreateAPIBeatmapSet(RulesetInfo ruleset = null)
         {
-            var beatmap = CreateBeatmap(ruleset).BeatmapInfo;
+            var beatmap = CreateBeatmap(ruleset ?? Ruleset.Value).BeatmapInfo;
 
             return new APIBeatmapSet
             {

From 9c926e551446fa512b25eaf2e4f13c78491b17b2 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 1 Nov 2021 15:42:12 +0900
Subject: [PATCH 0715/5547] Remove `BeatmapSetInfo.OnlineInfo` and all usages

---
 .../NonVisual/BeatmapSetInfoEqualityTest.cs   |   4 +-
 .../TestSceneDrawableRoomPlaylist.cs          |  18 +-
 .../SongSelect/TestSceneBeatmapDetails.cs     | 157 ++++++------------
 .../TestSceneUpdateableBeatmapSetCover.cs     |  13 +-
 osu.Game/Beatmaps/BeatmapSetInfo.cs           |  83 +--------
 .../UpdateableBeatmapBackgroundSprite.cs      |   5 -
 .../API/Requests/Responses/APIBeatmapSet.cs   |   1 -
 osu.Game/Screens/Select/BeatmapDetails.cs     |  19 ++-
 osu.Game/Tests/Beatmaps/TestBeatmap.cs        |  10 --
 osu.Game/Tests/Visual/OsuTestScene.cs         |  24 +--
 10 files changed, 91 insertions(+), 243 deletions(-)

diff --git a/osu.Game.Tests/NonVisual/BeatmapSetInfoEqualityTest.cs b/osu.Game.Tests/NonVisual/BeatmapSetInfoEqualityTest.cs
index 42a3b4cf43..9ce7e0a0e0 100644
--- a/osu.Game.Tests/NonVisual/BeatmapSetInfoEqualityTest.cs
+++ b/osu.Game.Tests/NonVisual/BeatmapSetInfoEqualityTest.cs
@@ -39,8 +39,8 @@ namespace osu.Game.Tests.NonVisual
         [Test]
         public void TestCheckNullID()
         {
-            var ourInfo = new BeatmapSetInfo { Status = BeatmapSetOnlineStatus.Loved };
-            var otherInfo = new BeatmapSetInfo { Status = BeatmapSetOnlineStatus.Approved };
+            var ourInfo = new BeatmapSetInfo { Hash = "1" };
+            var otherInfo = new BeatmapSetInfo { Hash = "2" };
 
             Assert.AreNotEqual(ourInfo, otherInfo);
         }
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
index 5dfa055d7d..afd48d5191 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
@@ -2,11 +2,11 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System.Collections.Generic;
+using System.Diagnostics;
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
-using osu.Framework.Extensions.IEnumerableExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Platform;
@@ -203,7 +203,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [Test]
         public void TestDownloadButtonHiddenWhenBeatmapExists()
         {
-            var beatmap = CreateAPIBeatmapSet();
+            var beatmap = new TestBeatmap(new OsuRuleset().RulesetInfo).BeatmapInfo;
 
             AddStep("import beatmap", () => manager.Import(beatmap.BeatmapSet).Wait());
 
@@ -224,11 +224,11 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [Test]
         public void TestDownloadButtonVisibleInitiallyWhenBeatmapDoesNotExist()
         {
-            var byOnlineId = CreateAPIBeatmapSet();
+            var byOnlineId = CreateAPIBeatmap();
             byOnlineId.OnlineID = 1337; // Some random ID that does not exist locally.
 
-            var byChecksum = CreateAPIBeatmapSet();
-            byChecksum.Beatmaps.ForEach(b => b.Checksum = "1337"); // Some random checksum that does not exist locally.
+            var byChecksum = CreateAPIBeatmap();
+            byChecksum.Checksum = "1337"; // Some random checksum that does not exist locally.
 
             createPlaylist(byOnlineId, byChecksum);
 
@@ -238,9 +238,11 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [Test]
         public void TestExplicitBeatmapItem()
         {
-            var beatmap = CreateAPIBeatmapSet();
+            var beatmap = CreateAPIBeatmap();
 
-            beatmap.HasExplicitContent = true;
+            Debug.Assert(beatmap.BeatmapSet != null);
+
+            beatmap.BeatmapSet.HasExplicitContent = true;
 
             createPlaylist(beatmap);
         }
@@ -312,7 +314,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddUntilStep("wait for items to load", () => playlist.ItemMap.Values.All(i => i.IsLoaded));
         }
 
-        private void createPlaylist(params BeatmapInfo[] beatmaps)
+        private void createPlaylist(params IBeatmapInfo[] beatmaps)
         {
             AddStep("create playlist", () =>
             {
diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapDetails.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapDetails.cs
index 9856b28b00..bd15c40271 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapDetails.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapDetails.cs
@@ -7,7 +7,6 @@ using osu.Framework.Graphics;
 using osu.Game.Beatmaps;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests.Responses;
-using osu.Game.Rulesets.Osu;
 using osu.Game.Screens.Select;
 
 namespace osu.Game.Tests.Visual.SongSelect
@@ -32,159 +31,112 @@ namespace osu.Game.Tests.Visual.SongSelect
         [Test]
         public void TestAllMetrics()
         {
-            AddStep("all metrics", () => details.BeatmapInfo = new BeatmapInfo
+            AddStep("all metrics", () => details.BeatmapInfo = new APIBeatmap
             {
-                BeatmapSet = new BeatmapSetInfo
-                {
-                    OnlineInfo = new APIBeatmapSet
-                    {
-                        Ratings = Enumerable.Range(0, 11).ToArray(),
-                    }
-                },
-                Version = "All Metrics",
-                Metadata = new BeatmapMetadata
+                BeatmapSet = new APIBeatmapSet
                 {
                     Source = "osu!",
                     Tags = "this beatmap has all the metrics",
+                    Ratings = Enumerable.Range(0, 11).ToArray(),
                 },
-                BaseDifficulty = new BeatmapDifficulty
+                DifficultyName = "All Metrics",
+                CircleSize = 7,
+                DrainRate = 1,
+                OverallDifficulty = 5.7f,
+                ApproachRate = 3.5f,
+                StarRating = 5.3f,
+                FailTimes = new APIFailTimes
                 {
-                    CircleSize = 7,
-                    DrainRate = 1,
-                    OverallDifficulty = 5.7f,
-                    ApproachRate = 3.5f,
+                    Fails = Enumerable.Range(1, 100).Select(i => i % 12 - 6).ToArray(),
+                    Retries = Enumerable.Range(-2, 100).Select(i => i % 12 - 6).ToArray(),
                 },
-                StarDifficulty = 5.3f,
-                Ruleset = new OsuRuleset().RulesetInfo,
-                OnlineInfo = new APIBeatmap
-                {
-                    FailTimes = new APIFailTimes
-                    {
-                        Fails = Enumerable.Range(1, 100).Select(i => i % 12 - 6).ToArray(),
-                        Retries = Enumerable.Range(-2, 100).Select(i => i % 12 - 6).ToArray(),
-                    },
-                }
             });
         }
 
         [Test]
         public void TestAllMetricsExceptSource()
         {
-            AddStep("all except source", () => details.BeatmapInfo = new BeatmapInfo
+            AddStep("all except source", () => details.BeatmapInfo = new APIBeatmap
             {
-                BeatmapSet = new BeatmapSetInfo
-                {
-                    OnlineInfo = new APIBeatmapSet
-                    {
-                        Ratings = Enumerable.Range(0, 11).ToArray(),
-                    }
-                },
-                Version = "All Metrics",
-                Metadata = new BeatmapMetadata
+                BeatmapSet = new APIBeatmapSet
                 {
                     Tags = "this beatmap has all the metrics",
+                    Ratings = Enumerable.Range(0, 11).ToArray(),
                 },
-                BaseDifficulty = new BeatmapDifficulty
+                DifficultyName = "All Metrics",
+                CircleSize = 7,
+                DrainRate = 1,
+                OverallDifficulty = 5.7f,
+                ApproachRate = 3.5f,
+                StarRating = 5.3f,
+                FailTimes = new APIFailTimes
                 {
-                    CircleSize = 7,
-                    DrainRate = 1,
-                    OverallDifficulty = 5.7f,
-                    ApproachRate = 3.5f,
+                    Fails = Enumerable.Range(1, 100).Select(i => i % 12 - 6).ToArray(),
+                    Retries = Enumerable.Range(-2, 100).Select(i => i % 12 - 6).ToArray(),
                 },
-                StarDifficulty = 5.3f,
-                Ruleset = new OsuRuleset().RulesetInfo,
-                OnlineInfo = new APIBeatmap
-                {
-                    FailTimes = new APIFailTimes
-                    {
-                        Fails = Enumerable.Range(1, 100).Select(i => i % 12 - 6).ToArray(),
-                        Retries = Enumerable.Range(-2, 100).Select(i => i % 12 - 6).ToArray(),
-                    },
-                }
             });
         }
 
         [Test]
         public void TestOnlyRatings()
         {
-            AddStep("ratings", () => details.BeatmapInfo = new BeatmapInfo
+            AddStep("ratings", () => details.BeatmapInfo = new APIBeatmap
             {
-                BeatmapSet = new BeatmapSetInfo
-                {
-                    OnlineInfo = new APIBeatmapSet
-                    {
-                        Ratings = Enumerable.Range(0, 11).ToArray(),
-                    }
-                },
-                Version = "Only Ratings",
-                Metadata = new BeatmapMetadata
+                BeatmapSet = new APIBeatmapSet
                 {
+                    Ratings = Enumerable.Range(0, 11).ToArray(),
                     Source = "osu!",
                     Tags = "this beatmap has ratings metrics but not retries or fails",
                 },
-                Ruleset = new OsuRuleset().RulesetInfo,
-                BaseDifficulty = new BeatmapDifficulty
-                {
-                    CircleSize = 6,
-                    DrainRate = 9,
-                    OverallDifficulty = 6,
-                    ApproachRate = 6,
-                },
-                StarDifficulty = 4.8f,
+                DifficultyName = "Only Ratings",
+                CircleSize = 6,
+                DrainRate = 9,
+                OverallDifficulty = 6,
+                ApproachRate = 6,
+                StarRating = 4.8f,
             });
         }
 
         [Test]
         public void TestOnlyFailsAndRetries()
         {
-            AddStep("fails retries", () => details.BeatmapInfo = new BeatmapInfo
+            AddStep("fails retries", () => details.BeatmapInfo = new APIBeatmap
             {
-                Version = "Only Retries and Fails",
-                Metadata = new BeatmapMetadata
+                DifficultyName = "Only Retries and Fails",
+                BeatmapSet = new APIBeatmapSet
                 {
                     Source = "osu!",
                     Tags = "this beatmap has retries and fails but no ratings",
                 },
-                BaseDifficulty = new BeatmapDifficulty
+                CircleSize = 3.7f,
+                DrainRate = 6,
+                OverallDifficulty = 6,
+                ApproachRate = 7,
+                StarRating = 2.91f,
+                FailTimes = new APIFailTimes
                 {
-                    CircleSize = 3.7f,
-                    DrainRate = 6,
-                    OverallDifficulty = 6,
-                    ApproachRate = 7,
+                    Fails = Enumerable.Range(1, 100).Select(i => i % 12 - 6).ToArray(),
+                    Retries = Enumerable.Range(-2, 100).Select(i => i % 12 - 6).ToArray(),
                 },
-                Ruleset = new OsuRuleset().RulesetInfo,
-                StarDifficulty = 2.91f,
-                OnlineInfo = new APIBeatmap
-                {
-                    FailTimes = new APIFailTimes
-                    {
-                        Fails = Enumerable.Range(1, 100).Select(i => i % 12 - 6).ToArray(),
-                        Retries = Enumerable.Range(-2, 100).Select(i => i % 12 - 6).ToArray(),
-                    },
-                }
             });
         }
 
         [Test]
         public void TestNoMetrics()
         {
-            AddStep("no metrics", () => details.BeatmapInfo = new BeatmapInfo
+            AddStep("no metrics", () => details.BeatmapInfo = new APIBeatmap
             {
-                Version = "No Metrics",
-                Metadata = new BeatmapMetadata
+                DifficultyName = "No Metrics",
+                BeatmapSet = new APIBeatmapSet
                 {
                     Source = "osu!",
                     Tags = "this beatmap has no metrics",
                 },
-                Ruleset = new OsuRuleset().RulesetInfo,
-                BaseDifficulty = new BeatmapDifficulty
-                {
-                    CircleSize = 5,
-                    DrainRate = 5,
-                    OverallDifficulty = 5.5f,
-                    ApproachRate = 6.5f,
-                },
-                StarDifficulty = 1.97f,
+                CircleSize = 5,
+                DrainRate = 5,
+                OverallDifficulty = 5.5f,
+                ApproachRate = 6.5f,
+                StarRating = 1.97f,
             });
         }
 
@@ -197,10 +149,9 @@ namespace osu.Game.Tests.Visual.SongSelect
         [Test]
         public void TestOnlineMetrics()
         {
-            AddStep("online ratings/retries/fails", () => details.BeatmapInfo = new BeatmapInfo
+            AddStep("online ratings/retries/fails", () => details.BeatmapInfo = new APIBeatmap
             {
-                OnlineBeatmapID = 162,
-                Ruleset = new OsuRuleset().RulesetInfo
+                OnlineID = 162,
             });
             AddStep("set online", () => api.SetState(APIState.Online));
             AddStep("set offline", () => api.SetState(APIState.Offline));
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneUpdateableBeatmapSetCover.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneUpdateableBeatmapSetCover.cs
index 6896e7a67a..7b6774a6b2 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneUpdateableBeatmapSetCover.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneUpdateableBeatmapSetCover.cs
@@ -68,7 +68,7 @@ namespace osu.Game.Tests.Visual.UserInterface
 
                     var cover = new UpdateableOnlineBeatmapSetCover(coverType)
                     {
-                        OnlineInfo = setInfo.OnlineInfo,
+                        OnlineInfo = beatmapSet,
                         Height = 100,
                         Masking = true,
                     };
@@ -117,7 +117,7 @@ namespace osu.Game.Tests.Visual.UserInterface
 
             AddStep("setup cover", () => Child = updateableCover = new TestUpdateableOnlineBeatmapSetCover(0)
             {
-                OnlineInfo = createBeatmapWithCover("https://assets.ppy.sh/beatmaps/1189904/covers/cover.jpg").OnlineInfo,
+                OnlineInfo = createBeatmapWithCover("https://assets.ppy.sh/beatmaps/1189904/covers/cover.jpg"),
                 RelativeSizeAxes = Axes.Both,
                 Masking = true,
                 Alpha = 0.4f
@@ -128,16 +128,13 @@ namespace osu.Game.Tests.Visual.UserInterface
             AddUntilStep("wait for fade complete", () => initialCover.Alpha == 1);
 
             AddStep("switch beatmap",
-                () => updateableCover.OnlineInfo = createBeatmapWithCover("https://assets.ppy.sh/beatmaps/1079428/covers/cover.jpg").OnlineInfo);
+                () => updateableCover.OnlineInfo = createBeatmapWithCover("https://assets.ppy.sh/beatmaps/1079428/covers/cover.jpg"));
             AddUntilStep("new cover loaded", () => updateableCover.ChildrenOfType<OnlineBeatmapSetCover>().Except(new[] { initialCover }).Any());
         }
 
-        private static BeatmapSetInfo createBeatmapWithCover(string coverUrl) => new BeatmapSetInfo
+        private static APIBeatmapSet createBeatmapWithCover(string coverUrl) => new APIBeatmapSet
         {
-            OnlineInfo = new APIBeatmapSet
-            {
-                Covers = new BeatmapSetOnlineCovers { Cover = coverUrl }
-            }
+            Covers = new BeatmapSetOnlineCovers { Cover = coverUrl }
         };
 
         private class TestUpdateableOnlineBeatmapSetCover : UpdateableOnlineBeatmapSetCover
diff --git a/osu.Game/Beatmaps/BeatmapSetInfo.cs b/osu.Game/Beatmaps/BeatmapSetInfo.cs
index 79cc8b70fb..638366c580 100644
--- a/osu.Game/Beatmaps/BeatmapSetInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapSetInfo.cs
@@ -6,10 +6,8 @@ using System.Collections.Generic;
 using System.ComponentModel.DataAnnotations.Schema;
 using System.Linq;
 using JetBrains.Annotations;
-using Newtonsoft.Json;
 using osu.Framework.Testing;
 using osu.Game.Database;
-using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Beatmaps
 {
@@ -32,13 +30,11 @@ namespace osu.Game.Beatmaps
 
         public List<BeatmapInfo> Beatmaps { get; set; }
 
+        public BeatmapSetOnlineStatus Status { get; set; } = BeatmapSetOnlineStatus.None;
+
         [NotNull]
         public List<BeatmapSetFileInfo> Files { get; set; } = new List<BeatmapSetFileInfo>();
 
-        // This field is temporary and only used by `APIBeatmapSet.ToBeatmapSet` (soon to be removed) and tests (to be updated to provide APIBeatmapSet instead).
-        [NotMapped]
-        public APIBeatmapSet OnlineInfo { get; set; }
-
         /// <summary>
         /// The maximum star difficulty of all beatmaps in this set.
         /// </summary>
@@ -100,80 +96,5 @@ namespace osu.Game.Beatmaps
         IEnumerable<INamedFileUsage> IBeatmapSetInfo.Files => Files;
 
         #endregion
-
-        #region Delegation for IBeatmapSetOnlineInfo
-
-        [NotMapped]
-        [JsonIgnore]
-        public DateTimeOffset Submitted => OnlineInfo.Submitted;
-
-        [NotMapped]
-        [JsonIgnore]
-        public DateTimeOffset? Ranked => OnlineInfo.Ranked;
-
-        [NotMapped]
-        [JsonIgnore]
-        public DateTimeOffset? LastUpdated => OnlineInfo.LastUpdated;
-
-        [JsonIgnore]
-        public BeatmapSetOnlineStatus Status { get; set; } = BeatmapSetOnlineStatus.None;
-
-        [NotMapped]
-        [JsonIgnore]
-        public bool HasExplicitContent => OnlineInfo.HasExplicitContent;
-
-        [NotMapped]
-        [JsonIgnore]
-        public bool HasVideo => OnlineInfo.HasVideo;
-
-        [NotMapped]
-        [JsonIgnore]
-        public bool HasStoryboard => OnlineInfo.HasStoryboard;
-
-        [NotMapped]
-        [JsonIgnore]
-        public BeatmapSetOnlineCovers Covers => OnlineInfo.Covers;
-
-        [NotMapped]
-        [JsonIgnore]
-        public string Preview => OnlineInfo.Preview;
-
-        [NotMapped]
-        [JsonIgnore]
-        public double BPM => OnlineInfo.BPM;
-
-        [NotMapped]
-        [JsonIgnore]
-        public int PlayCount => OnlineInfo.PlayCount;
-
-        [NotMapped]
-        [JsonIgnore]
-        public int FavouriteCount => OnlineInfo.FavouriteCount;
-
-        [NotMapped]
-        [JsonIgnore]
-        public bool HasFavourited => OnlineInfo.HasFavourited;
-
-        [NotMapped]
-        [JsonIgnore]
-        public BeatmapSetOnlineAvailability Availability => OnlineInfo.Availability;
-
-        [NotMapped]
-        [JsonIgnore]
-        public BeatmapSetOnlineGenre Genre => OnlineInfo.Genre;
-
-        [NotMapped]
-        [JsonIgnore]
-        public BeatmapSetOnlineLanguage Language => OnlineInfo.Language;
-
-        [NotMapped]
-        [JsonIgnore]
-        public int? TrackId => OnlineInfo?.TrackId;
-
-        [NotMapped]
-        [JsonIgnore]
-        public int[] Ratings => OnlineInfo?.Ratings;
-
-        #endregion
     }
 }
diff --git a/osu.Game/Beatmaps/Drawables/UpdateableBeatmapBackgroundSprite.cs b/osu.Game/Beatmaps/Drawables/UpdateableBeatmapBackgroundSprite.cs
index 4100fe9586..636c568bd0 100644
--- a/osu.Game/Beatmaps/Drawables/UpdateableBeatmapBackgroundSprite.cs
+++ b/osu.Game/Beatmaps/Drawables/UpdateableBeatmapBackgroundSprite.cs
@@ -57,12 +57,7 @@ namespace osu.Game.Beatmaps.Drawables
                 return new OnlineBeatmapSetCover(online, beatmapSetCoverType);
 
             if (model is BeatmapInfo localModel)
-            {
-                if (localModel.BeatmapSet?.OnlineInfo != null)
-                    return new OnlineBeatmapSetCover(localModel.BeatmapSet.OnlineInfo, beatmapSetCoverType);
-
                 return new BeatmapBackgroundSprite(beatmaps.GetWorkingBeatmap(localModel));
-            }
 
             return new BeatmapBackgroundSprite(beatmaps.DefaultBeatmap);
         }
diff --git a/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs b/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs
index d8efa20b39..2b6c556c76 100644
--- a/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs
@@ -128,7 +128,6 @@ namespace osu.Game.Online.API.Requests.Responses
                 OnlineBeatmapSetID = OnlineID,
                 Metadata = metadata,
                 Status = Status,
-                OnlineInfo = this
             };
 
             beatmapSet.Beatmaps = Beatmaps.Select(b =>
diff --git a/osu.Game/Screens/Select/BeatmapDetails.cs b/osu.Game/Screens/Select/BeatmapDetails.cs
index ece16a8e57..6f215b9287 100644
--- a/osu.Game/Screens/Select/BeatmapDetails.cs
+++ b/osu.Game/Screens/Select/BeatmapDetails.cs
@@ -41,13 +41,13 @@ namespace osu.Game.Screens.Select
         [Resolved]
         private RulesetStore rulesets { get; set; }
 
-        private BeatmapInfo beatmapInfo;
+        private IBeatmapInfo beatmapInfo;
 
         private APIFailTimes failTimes;
 
         private int[] ratings;
 
-        public BeatmapInfo BeatmapInfo
+        public IBeatmapInfo BeatmapInfo
         {
             get => beatmapInfo;
             set
@@ -56,8 +56,11 @@ namespace osu.Game.Screens.Select
 
                 beatmapInfo = value;
 
-                failTimes = beatmapInfo?.OnlineInfo?.FailTimes;
-                ratings = beatmapInfo?.BeatmapSet?.OnlineInfo?.Ratings;
+                var onlineInfo = beatmapInfo as IBeatmapOnlineInfo;
+                var onlineSetInfo = beatmapInfo.BeatmapSet as IBeatmapSetOnlineInfo;
+
+                failTimes = onlineInfo?.FailTimes;
+                ratings = onlineSetInfo?.Ratings;
 
                 Scheduler.AddOnce(updateStatistics);
             }
@@ -178,9 +181,9 @@ namespace osu.Game.Screens.Select
         private void updateStatistics()
         {
             advanced.BeatmapInfo = BeatmapInfo;
-            description.Text = BeatmapInfo?.Version;
-            source.Text = BeatmapInfo?.Metadata?.Source;
-            tags.Text = BeatmapInfo?.Metadata?.Tags;
+            description.Text = BeatmapInfo?.DifficultyName;
+            source.Text = BeatmapInfo?.Metadata.Source;
+            tags.Text = BeatmapInfo?.Metadata.Tags;
 
             // failTimes may have been previously fetched
             if (ratings != null && failTimes != null)
@@ -190,7 +193,7 @@ namespace osu.Game.Screens.Select
             }
 
             // for now, let's early abort if an OnlineBeatmapID is not present (should have been populated at import time).
-            if (BeatmapInfo?.OnlineBeatmapID == null || api.State.Value == APIState.Offline)
+            if (BeatmapInfo == null || BeatmapInfo.OnlineID <= 0 || api.State.Value == APIState.Offline)
             {
                 updateMetrics();
                 return;
diff --git a/osu.Game/Tests/Beatmaps/TestBeatmap.cs b/osu.Game/Tests/Beatmaps/TestBeatmap.cs
index caf83973c4..b9eda5c06e 100644
--- a/osu.Game/Tests/Beatmaps/TestBeatmap.cs
+++ b/osu.Game/Tests/Beatmaps/TestBeatmap.cs
@@ -39,16 +39,6 @@ namespace osu.Game.Tests.Beatmaps
             BeatmapInfo.Length = 75000;
             BeatmapInfo.OnlineInfo = new APIBeatmap();
             BeatmapInfo.OnlineBeatmapID = Interlocked.Increment(ref onlineBeatmapID);
-            BeatmapInfo.BeatmapSet.OnlineInfo = new APIBeatmapSet
-            {
-                Status = BeatmapSetOnlineStatus.Ranked,
-                Covers = new BeatmapSetOnlineCovers
-                {
-                    Cover = "https://assets.ppy.sh/beatmaps/163112/covers/cover.jpg",
-                    Card = "https://assets.ppy.sh/beatmaps/163112/covers/card.jpg",
-                    List = "https://assets.ppy.sh/beatmaps/163112/covers/list.jpg"
-                }
-            };
         }
 
         protected virtual Beatmap CreateBeatmap() => createTestBeatmap();
diff --git a/osu.Game/Tests/Visual/OsuTestScene.cs b/osu.Game/Tests/Visual/OsuTestScene.cs
index e25cbaf467..153e2c487c 100644
--- a/osu.Game/Tests/Visual/OsuTestScene.cs
+++ b/osu.Game/Tests/Visual/OsuTestScene.cs
@@ -203,21 +203,14 @@ namespace osu.Game.Tests.Visual
 
             return new APIBeatmapSet
             {
-                Covers = beatmap.BeatmapSet.Covers,
                 OnlineID = beatmap.BeatmapSet.OnlineID,
-                Status = beatmap.BeatmapSet.Status,
-                Preview = beatmap.BeatmapSet.Preview,
-                HasFavourited = beatmap.BeatmapSet.HasFavourited,
-                PlayCount = beatmap.BeatmapSet.PlayCount,
-                FavouriteCount = beatmap.BeatmapSet.FavouriteCount,
-                BPM = beatmap.BeatmapSet.BPM,
-                HasExplicitContent = beatmap.BeatmapSet.HasExplicitContent,
-                HasVideo = beatmap.BeatmapSet.HasVideo,
-                HasStoryboard = beatmap.BeatmapSet.HasStoryboard,
-                Submitted = beatmap.BeatmapSet.Submitted,
-                Ranked = beatmap.BeatmapSet.Ranked,
-                LastUpdated = beatmap.BeatmapSet.LastUpdated,
-                TrackId = beatmap.BeatmapSet.TrackId,
+                Status = BeatmapSetOnlineStatus.Ranked,
+                Covers = new BeatmapSetOnlineCovers
+                {
+                    Cover = "https://assets.ppy.sh/beatmaps/163112/covers/cover.jpg",
+                    Card = "https://assets.ppy.sh/beatmaps/163112/covers/card.jpg",
+                    List = "https://assets.ppy.sh/beatmaps/163112/covers/list.jpg"
+                },
                 Title = beatmap.BeatmapSet.Metadata.Title,
                 TitleUnicode = beatmap.BeatmapSet.Metadata.TitleUnicode,
                 Artist = beatmap.BeatmapSet.Metadata.Artist,
@@ -225,9 +218,6 @@ namespace osu.Game.Tests.Visual
                 Author = beatmap.BeatmapSet.Metadata.Author,
                 AuthorID = beatmap.BeatmapSet.Metadata.AuthorID,
                 AuthorString = beatmap.BeatmapSet.Metadata.AuthorString,
-                Availability = beatmap.BeatmapSet.Availability,
-                Genre = beatmap.BeatmapSet.Genre,
-                Language = beatmap.BeatmapSet.Language,
                 Source = beatmap.BeatmapSet.Metadata.Source,
                 Tags = beatmap.BeatmapSet.Metadata.Tags,
                 Beatmaps = new[]

From 4b1b92cde6f0d9dfd9f116739fe2ea09094c67ff Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 1 Nov 2021 17:03:26 +0900
Subject: [PATCH 0716/5547] Stop `BeatmapInfo` from implementing
 `IBeatmapOnlineInfo` and remove all usages

---
 osu.Game/Beatmaps/BeatmapInfo.cs | 21 +--------------------
 1 file changed, 1 insertion(+), 20 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapInfo.cs b/osu.Game/Beatmaps/BeatmapInfo.cs
index 952e205aa0..01a819dead 100644
--- a/osu.Game/Beatmaps/BeatmapInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapInfo.cs
@@ -17,7 +17,7 @@ namespace osu.Game.Beatmaps
 {
     [ExcludeFromDynamicCompile]
     [Serializable]
-    public class BeatmapInfo : IEquatable<BeatmapInfo>, IHasPrimaryKey, IBeatmapInfo, IBeatmapOnlineInfo
+    public class BeatmapInfo : IEquatable<BeatmapInfo>, IHasPrimaryKey, IBeatmapInfo
     {
         public int ID { get; set; }
 
@@ -201,24 +201,5 @@ namespace osu.Game.Beatmaps
         double IBeatmapInfo.StarRating => StarDifficulty;
 
         #endregion
-
-        #region Implementation of IBeatmapOnlineInfo
-
-        [JsonIgnore]
-        public int CircleCount => OnlineInfo.CircleCount;
-
-        [JsonIgnore]
-        public int SliderCount => OnlineInfo.SliderCount;
-
-        [JsonIgnore]
-        public int PlayCount => OnlineInfo.PlayCount;
-
-        [JsonIgnore]
-        public int PassCount => OnlineInfo.PassCount;
-
-        [JsonIgnore]
-        public APIFailTimes FailTimes => OnlineInfo.FailTimes;
-
-        #endregion
     }
 }

From a5a7181915a041abb18c14e622e61f1ac4ac1d21 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 4 Nov 2021 15:35:32 +0900
Subject: [PATCH 0717/5547] Fix unintentionally broken background update logic

---
 .../OnlinePlay/Components/OnlinePlayBackgroundScreen.cs       | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Screens/OnlinePlay/Components/OnlinePlayBackgroundScreen.cs b/osu.Game/Screens/OnlinePlay/Components/OnlinePlayBackgroundScreen.cs
index 279a8e1a14..ffc5c07d4e 100644
--- a/osu.Game/Screens/OnlinePlay/Components/OnlinePlayBackgroundScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Components/OnlinePlayBackgroundScreen.cs
@@ -60,8 +60,10 @@ namespace osu.Game.Screens.OnlinePlay.Components
         {
             Schedule(() =>
             {
+                var beatmap = playlistItem?.Beatmap.Value;
+
                 string? lastCover = (background?.Beatmap?.BeatmapSet as IBeatmapSetOnlineInfo)?.Covers.Cover;
-                string? newCover = (background?.Beatmap?.BeatmapSet as IBeatmapSetOnlineInfo)?.Covers.Cover;
+                string? newCover = (beatmap?.BeatmapSet as IBeatmapSetOnlineInfo)?.Covers.Cover;
 
                 if (lastCover == newCover)
                     return;

From 09701d0af12f8ae0f05fdf7fc6e947216ed40388 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 4 Nov 2021 16:02:37 +0900
Subject: [PATCH 0718/5547] Use explicit primitive type specification

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

diff --git a/osu.Game/Screens/Edit/Compose/Components/BlueprintContainer.cs b/osu.Game/Screens/Edit/Compose/Components/BlueprintContainer.cs
index 42792bdf5b..29e3f12d03 100644
--- a/osu.Game/Screens/Edit/Compose/Components/BlueprintContainer.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/BlueprintContainer.cs
@@ -114,7 +114,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
             if (selectionPerformed)
             {
                 // only unmodified right click should show context menu
-                var shouldShowContextMenu = e.Button == MouseButton.Right && !e.ShiftPressed && !e.AltPressed && !e.SuperPressed;
+                bool shouldShowContextMenu = e.Button == MouseButton.Right && !e.ShiftPressed && !e.AltPressed && !e.SuperPressed;
 
                 // stop propagation if not showing context menu
                 return !shouldShowContextMenu;

From 0c14d8af23cd4f0b89846da362dea637ce3d8b0e Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Thu, 4 Nov 2021 16:03:15 +0900
Subject: [PATCH 0719/5547] Upgrade to nvika 1.0.4

---
 .config/dotnet-tools.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.config/dotnet-tools.json b/.config/dotnet-tools.json
index 1b06aa4d17..d64ad6ad21 100644
--- a/.config/dotnet-tools.json
+++ b/.config/dotnet-tools.json
@@ -15,7 +15,7 @@
       ]
     },
     "smoogipoo.nvika": {
-      "version": "1.0.3",
+      "version": "1.0.4",
       "commands": [
         "nvika"
       ]

From 317506d4d7a472bedba1586bb2ebbad7e089d7f6 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 4 Nov 2021 16:11:23 +0900
Subject: [PATCH 0720/5547] Fix a few more "maybe null" inspections

---
 .../Online/TestAPIModJsonSerialization.cs         | 15 +++++++++------
 osu.Game/Screens/Select/BeatmapDeleteDialog.cs    |  2 +-
 2 files changed, 10 insertions(+), 7 deletions(-)

diff --git a/osu.Game.Tests/Online/TestAPIModJsonSerialization.cs b/osu.Game.Tests/Online/TestAPIModJsonSerialization.cs
index c8848ab7d8..656e333073 100644
--- a/osu.Game.Tests/Online/TestAPIModJsonSerialization.cs
+++ b/osu.Game.Tests/Online/TestAPIModJsonSerialization.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 Newtonsoft.Json;
 using NUnit.Framework;
@@ -67,9 +68,11 @@ namespace osu.Game.Tests.Online
             var deserialised = JsonConvert.DeserializeObject<APIMod>(JsonConvert.SerializeObject(apiMod));
             var converted = (TestModTimeRamp)deserialised?.ToMod(new TestRuleset());
 
-            Assert.That(converted?.AdjustPitch.Value, Is.EqualTo(false));
-            Assert.That(converted?.InitialRate.Value, Is.EqualTo(1.25));
-            Assert.That(converted?.FinalRate.Value, Is.EqualTo(0.25));
+            Assert.That(converted, Is.Not.Null);
+
+            Assert.That(converted.AdjustPitch.Value, Is.EqualTo(false));
+            Assert.That(converted.InitialRate.Value, Is.EqualTo(1.25));
+            Assert.That(converted.FinalRate.Value, Is.EqualTo(0.25));
         }
 
         [Test]
@@ -121,11 +124,11 @@ namespace osu.Game.Tests.Online
                 new TestModDifficultyAdjust()
             };
 
-            public override DrawableRuleset CreateDrawableRulesetWith(IBeatmap beatmap, IReadOnlyList<Mod> mods = null) => throw new System.NotImplementedException();
+            public override DrawableRuleset CreateDrawableRulesetWith(IBeatmap beatmap, IReadOnlyList<Mod> mods = null) => throw new NotImplementedException();
 
-            public override IBeatmapConverter CreateBeatmapConverter(IBeatmap beatmap) => throw new System.NotImplementedException();
+            public override IBeatmapConverter CreateBeatmapConverter(IBeatmap beatmap) => throw new NotImplementedException();
 
-            public override DifficultyCalculator CreateDifficultyCalculator(WorkingBeatmap beatmap) => throw new System.NotImplementedException();
+            public override DifficultyCalculator CreateDifficultyCalculator(WorkingBeatmap beatmap) => throw new NotImplementedException();
 
             public override string Description { get; } = string.Empty;
             public override string ShortName { get; } = string.Empty;
diff --git a/osu.Game/Screens/Select/BeatmapDeleteDialog.cs b/osu.Game/Screens/Select/BeatmapDeleteDialog.cs
index 5fb72e4151..307c2352e3 100644
--- a/osu.Game/Screens/Select/BeatmapDeleteDialog.cs
+++ b/osu.Game/Screens/Select/BeatmapDeleteDialog.cs
@@ -29,7 +29,7 @@ namespace osu.Game.Screens.Select
                 new PopupDialogOkButton
                 {
                     Text = @"Yes. Totally. Delete it.",
-                    Action = () => manager.Delete(beatmap),
+                    Action = () => manager?.Delete(beatmap),
                 },
                 new PopupDialogCancelButton
                 {

From baabe99f789aea701030531d538780efc7830dd0 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 1 Nov 2021 15:38:45 +0900
Subject: [PATCH 0721/5547] Clean up `DirectDownloadButton` test scene

---
 .../Online/TestSceneDirectDownloadButton.cs   | 25 +++++--------------
 1 file changed, 6 insertions(+), 19 deletions(-)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneDirectDownloadButton.cs b/osu.Game.Tests/Visual/Online/TestSceneDirectDownloadButton.cs
index 3d828077c8..8d7e0f9f0c 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneDirectDownloadButton.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneDirectDownloadButton.cs
@@ -40,14 +40,14 @@ namespace osu.Game.Tests.Visual.Online
         {
             AddUntilStep("ensure manager loaded", () => beatmaps != null);
             ensureSoleilyRemoved();
-            createButtonWithBeatmap(createSoleily());
+            createButtonWithBeatmap(CreateAPIBeatmapSet());
             AddAssert("button state not downloaded", () => downloadButton.DownloadState == DownloadState.NotDownloaded);
             AddStep("import soleily", () => beatmaps.Import(TestResources.GetQuickTestBeatmapForImport()));
 
             AddUntilStep("wait for beatmap import", () => beatmaps.GetAllUsableBeatmapSets().Any(b => b.OnlineBeatmapSetID == 241526));
             AddAssert("button state downloaded", () => downloadButton.DownloadState == DownloadState.LocallyAvailable);
 
-            createButtonWithBeatmap(createSoleily());
+            createButtonWithBeatmap(CreateAPIBeatmapSet());
             AddAssert("button state downloaded", () => downloadButton.DownloadState == DownloadState.LocallyAvailable);
             ensureSoleilyRemoved();
             AddAssert("button state not downloaded", () => downloadButton.DownloadState == DownloadState.NotDownloaded);
@@ -68,7 +68,7 @@ namespace osu.Game.Tests.Visual.Online
             AddAssert($"button {(enabled ? "enabled" : "disabled")}", () => downloadButton.DownloadEnabled == enabled);
         }
 
-        private void createButtonWithBeatmap(IBeatmapSetInfo beatmap)
+        private void createButtonWithBeatmap(APIBeatmapSet beatmap)
         {
             AddStep("create button", () =>
             {
@@ -94,20 +94,7 @@ namespace osu.Game.Tests.Visual.Online
             });
         }
 
-        private IBeatmapSetInfo createSoleily()
-        {
-            return new APIBeatmapSet
-            {
-                OnlineID = 241526,
-                Availability = new BeatmapSetOnlineAvailability
-                {
-                    DownloadDisabled = false,
-                    ExternalLink = string.Empty,
-                },
-            };
-        }
-
-        private IBeatmapSetInfo getDownloadableBeatmapSet()
+        private APIBeatmapSet getDownloadableBeatmapSet()
         {
             var apiBeatmapSet = CreateAPIBeatmapSet();
 
@@ -117,7 +104,7 @@ namespace osu.Game.Tests.Visual.Online
             return apiBeatmapSet;
         }
 
-        private IBeatmapSetInfo getUndownloadableBeatmapSet()
+        private APIBeatmapSet getUndownloadableBeatmapSet()
         {
             var apiBeatmapSet = CreateAPIBeatmapSet();
 
@@ -143,7 +130,7 @@ namespace osu.Game.Tests.Visual.Online
 
             public DownloadState DownloadState => State.Value;
 
-            public TestDownloadButton(IBeatmapSetInfo beatmapSet)
+            public TestDownloadButton(APIBeatmapSet beatmapSet)
                 : base(beatmapSet)
             {
             }

From 8f459e6ce83dc59bd955cbff99b51019b412607e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 4 Nov 2021 16:44:05 +0900
Subject: [PATCH 0722/5547] Fix `APIBeatmapSet.Beatmaps` being `IEnumerable`,
 causing stupid issues

---
 osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs |  4 ++--
 .../Beatmaps/TestSceneDifficultySpectrumDisplay.cs     |  2 +-
 .../Visual/Online/TestSceneBeatmapRulesetSelector.cs   | 10 +++-------
 .../Visual/Online/TestSceneBeatmapSetOverlay.cs        |  6 +++---
 .../Visual/Online/TestSceneBeatmapSetOverlayDetails.cs |  3 +--
 osu.Game.Tests/Visual/Online/TestSceneDirectPanel.cs   |  4 ++--
 .../Online/API/Requests/Responses/APIBeatmapSet.cs     |  2 +-
 .../Overlays/BeatmapListing/Panels/BeatmapPanel.cs     |  2 +-
 .../Tests/Visual/Multiplayer/TestMultiplayerClient.cs  |  2 +-
 9 files changed, 15 insertions(+), 20 deletions(-)

diff --git a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs
index d1b21547dc..2aeb4ab4e2 100644
--- a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs
+++ b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs
@@ -91,7 +91,7 @@ namespace osu.Game.Tests.Visual.Beatmaps
             HasVideo = true,
             HasStoryboard = true,
             Covers = new BeatmapSetOnlineCovers(),
-            Beatmaps = new List<APIBeatmap>
+            Beatmaps = new[]
             {
                 new APIBeatmap
                 {
@@ -128,7 +128,7 @@ namespace osu.Game.Tests.Visual.Beatmaps
                 HasVideo = true,
                 HasStoryboard = true,
                 Covers = new BeatmapSetOnlineCovers(),
-                Beatmaps = beatmaps,
+                Beatmaps = beatmaps.ToArray(),
             };
         }
 
diff --git a/osu.Game.Tests/Visual/Beatmaps/TestSceneDifficultySpectrumDisplay.cs b/osu.Game.Tests/Visual/Beatmaps/TestSceneDifficultySpectrumDisplay.cs
index 1f38b05879..4063fa1252 100644
--- a/osu.Game.Tests/Visual/Beatmaps/TestSceneDifficultySpectrumDisplay.cs
+++ b/osu.Game.Tests/Visual/Beatmaps/TestSceneDifficultySpectrumDisplay.cs
@@ -21,7 +21,7 @@ namespace osu.Game.Tests.Visual.Beatmaps
             {
                 RulesetID = difficulty.rulesetId,
                 StarRating = difficulty.stars
-            }).ToList()
+            }).ToArray()
         };
 
         [Test]
diff --git a/osu.Game.Tests/Visual/Online/TestSceneBeatmapRulesetSelector.cs b/osu.Game.Tests/Visual/Online/TestSceneBeatmapRulesetSelector.cs
index b880633559..90f3eb64e4 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneBeatmapRulesetSelector.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneBeatmapRulesetSelector.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.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
@@ -37,7 +36,7 @@ namespace osu.Game.Tests.Visual.Online
             {
                 selector.BeatmapSet = new APIBeatmapSet
                 {
-                    Beatmaps = enabledRulesets.Select(r => new APIBeatmap { RulesetID = r.OnlineID }).ToList()
+                    Beatmaps = enabledRulesets.Select(r => new APIBeatmap { RulesetID = r.OnlineID }).ToArray()
                 };
             });
 
@@ -55,7 +54,7 @@ namespace osu.Game.Tests.Visual.Online
             {
                 selector.BeatmapSet = new APIBeatmapSet
                 {
-                    Beatmaps = new List<APIBeatmap>
+                    Beatmaps = new[]
                     {
                         new APIBeatmap
                         {
@@ -71,10 +70,7 @@ namespace osu.Game.Tests.Visual.Online
         [Test]
         public void TestEmptyBeatmapSet()
         {
-            AddStep("load empty beatmapset", () => selector.BeatmapSet = new APIBeatmapSet
-            {
-                Beatmaps = new List<APIBeatmap>()
-            });
+            AddStep("load empty beatmapset", () => selector.BeatmapSet = new APIBeatmapSet());
 
             AddAssert("no ruleset selected", () => selector.SelectedTab == null);
             AddAssert("all rulesets disabled", () => selector.TabContainer.TabItems.All(t => !t.Enabled.Value));
diff --git a/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlay.cs b/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlay.cs
index bae9af1897..63ce057667 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlay.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlay.cs
@@ -71,7 +71,7 @@ namespace osu.Game.Tests.Visual.Online
                     Ratings = Enumerable.Range(0, 11).ToArray(),
                     HasStoryboard = true,
                     Covers = new BeatmapSetOnlineCovers(),
-                    Beatmaps = new List<APIBeatmap>
+                    Beatmaps = new[]
                     {
                         new APIBeatmap
                         {
@@ -145,7 +145,7 @@ namespace osu.Game.Tests.Visual.Online
 
                 var set = getBeatmapSet();
 
-                set.Beatmaps = beatmaps;
+                set.Beatmaps = beatmaps.ToArray();
 
                 overlay.ShowBeatmapSet(set);
             });
@@ -211,7 +211,7 @@ namespace osu.Game.Tests.Visual.Online
                 });
             }
 
-            set.Beatmaps = beatmaps;
+            set.Beatmaps = beatmaps.ToArray();
 
             return set;
         }
diff --git a/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlayDetails.cs b/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlayDetails.cs
index 491a2d5d90..9c0c67b1d8 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlayDetails.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlayDetails.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.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
@@ -46,7 +45,7 @@ namespace osu.Game.Tests.Visual.Online
 
             static APIBeatmapSet createSet() => new APIBeatmapSet
             {
-                Beatmaps = new List<APIBeatmap>
+                Beatmaps = new[]
                 {
                     new APIBeatmap
                     {
diff --git a/osu.Game.Tests/Visual/Online/TestSceneDirectPanel.cs b/osu.Game.Tests/Visual/Online/TestSceneDirectPanel.cs
index 9a3d998966..a3c8935fa8 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneDirectPanel.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneDirectPanel.cs
@@ -90,7 +90,7 @@ namespace osu.Game.Tests.Visual.Online
                 HasVideo = true,
                 HasStoryboard = true,
                 Covers = new BeatmapSetOnlineCovers(),
-                Beatmaps = new List<APIBeatmap>
+                Beatmaps = new[]
                 {
                     new APIBeatmap
                     {
@@ -129,7 +129,7 @@ namespace osu.Game.Tests.Visual.Online
                     HasVideo = true,
                     HasStoryboard = true,
                     Covers = new BeatmapSetOnlineCovers(),
-                    Beatmaps = beatmaps,
+                    Beatmaps = beatmaps.ToArray(),
                 };
             }
         }
diff --git a/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs b/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs
index 2b6c556c76..c41271ad5c 100644
--- a/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs
@@ -119,7 +119,7 @@ namespace osu.Game.Online.API.Requests.Responses
         public string Tags { get; set; } = string.Empty;
 
         [JsonProperty(@"beatmaps")]
-        public IEnumerable<APIBeatmap> Beatmaps { get; set; } = Array.Empty<APIBeatmap>();
+        public APIBeatmap[] Beatmaps { get; set; } = Array.Empty<APIBeatmap>();
 
         public virtual BeatmapSetInfo ToBeatmapSet(RulesetStore rulesets)
         {
diff --git a/osu.Game/Overlays/BeatmapListing/Panels/BeatmapPanel.cs b/osu.Game/Overlays/BeatmapListing/Panels/BeatmapPanel.cs
index 2fd05f6742..34086c214f 100644
--- a/osu.Game/Overlays/BeatmapListing/Panels/BeatmapPanel.cs
+++ b/osu.Game/Overlays/BeatmapListing/Panels/BeatmapPanel.cs
@@ -147,7 +147,7 @@ namespace osu.Game.Overlays.BeatmapListing.Panels
         {
             var icons = new List<DifficultyIcon>();
 
-            if (SetInfo.Beatmaps.Count() > maximum_difficulty_icons)
+            if (SetInfo.Beatmaps.Length > maximum_difficulty_icons)
             {
                 foreach (var ruleset in SetInfo.Beatmaps.Select(b => b.Ruleset).Distinct())
                     icons.Add(new GroupedDifficultyIcon(SetInfo.Beatmaps.Where(b => b.RulesetID == ruleset.OnlineID).ToList(), ruleset, this is ListBeatmapPanel ? Color4.White : colours.Gray5));
diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
index c690a621eb..70d907ba15 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
@@ -280,7 +280,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             var apiSet = new APIBeatmapSet
             {
                 OnlineID = set.OnlineID,
-                Beatmaps = set.Beatmaps.Select(b => new APIBeatmap { OnlineID = b.OnlineID })
+                Beatmaps = set.Beatmaps.Select(b => new APIBeatmap { OnlineID = b.OnlineID }).ToArray(),
             };
 
             return Task.FromResult(apiSet);

From 5a078da4d9f16c510382d1134fb5a982700f5529 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 4 Nov 2021 16:44:05 +0900
Subject: [PATCH 0723/5547] Fix `APIBeatmapSet.Beatmaps` being `IEnumerable`,
 causing stupid issues

---
 osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs |  4 ++--
 .../Beatmaps/TestSceneDifficultySpectrumDisplay.cs     |  2 +-
 .../Visual/Online/TestSceneBeatmapRulesetSelector.cs   | 10 +++-------
 .../Visual/Online/TestSceneBeatmapSetOverlay.cs        |  6 +++---
 .../Visual/Online/TestSceneBeatmapSetOverlayDetails.cs |  3 +--
 osu.Game.Tests/Visual/Online/TestSceneDirectPanel.cs   |  4 ++--
 .../Online/API/Requests/Responses/APIBeatmapSet.cs     |  2 +-
 .../Overlays/BeatmapListing/Panels/BeatmapPanel.cs     |  2 +-
 .../Tests/Visual/Multiplayer/TestMultiplayerClient.cs  |  2 +-
 9 files changed, 15 insertions(+), 20 deletions(-)

diff --git a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs
index d1b21547dc..2aeb4ab4e2 100644
--- a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs
+++ b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs
@@ -91,7 +91,7 @@ namespace osu.Game.Tests.Visual.Beatmaps
             HasVideo = true,
             HasStoryboard = true,
             Covers = new BeatmapSetOnlineCovers(),
-            Beatmaps = new List<APIBeatmap>
+            Beatmaps = new[]
             {
                 new APIBeatmap
                 {
@@ -128,7 +128,7 @@ namespace osu.Game.Tests.Visual.Beatmaps
                 HasVideo = true,
                 HasStoryboard = true,
                 Covers = new BeatmapSetOnlineCovers(),
-                Beatmaps = beatmaps,
+                Beatmaps = beatmaps.ToArray(),
             };
         }
 
diff --git a/osu.Game.Tests/Visual/Beatmaps/TestSceneDifficultySpectrumDisplay.cs b/osu.Game.Tests/Visual/Beatmaps/TestSceneDifficultySpectrumDisplay.cs
index 1f38b05879..4063fa1252 100644
--- a/osu.Game.Tests/Visual/Beatmaps/TestSceneDifficultySpectrumDisplay.cs
+++ b/osu.Game.Tests/Visual/Beatmaps/TestSceneDifficultySpectrumDisplay.cs
@@ -21,7 +21,7 @@ namespace osu.Game.Tests.Visual.Beatmaps
             {
                 RulesetID = difficulty.rulesetId,
                 StarRating = difficulty.stars
-            }).ToList()
+            }).ToArray()
         };
 
         [Test]
diff --git a/osu.Game.Tests/Visual/Online/TestSceneBeatmapRulesetSelector.cs b/osu.Game.Tests/Visual/Online/TestSceneBeatmapRulesetSelector.cs
index b880633559..90f3eb64e4 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneBeatmapRulesetSelector.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneBeatmapRulesetSelector.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.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
@@ -37,7 +36,7 @@ namespace osu.Game.Tests.Visual.Online
             {
                 selector.BeatmapSet = new APIBeatmapSet
                 {
-                    Beatmaps = enabledRulesets.Select(r => new APIBeatmap { RulesetID = r.OnlineID }).ToList()
+                    Beatmaps = enabledRulesets.Select(r => new APIBeatmap { RulesetID = r.OnlineID }).ToArray()
                 };
             });
 
@@ -55,7 +54,7 @@ namespace osu.Game.Tests.Visual.Online
             {
                 selector.BeatmapSet = new APIBeatmapSet
                 {
-                    Beatmaps = new List<APIBeatmap>
+                    Beatmaps = new[]
                     {
                         new APIBeatmap
                         {
@@ -71,10 +70,7 @@ namespace osu.Game.Tests.Visual.Online
         [Test]
         public void TestEmptyBeatmapSet()
         {
-            AddStep("load empty beatmapset", () => selector.BeatmapSet = new APIBeatmapSet
-            {
-                Beatmaps = new List<APIBeatmap>()
-            });
+            AddStep("load empty beatmapset", () => selector.BeatmapSet = new APIBeatmapSet());
 
             AddAssert("no ruleset selected", () => selector.SelectedTab == null);
             AddAssert("all rulesets disabled", () => selector.TabContainer.TabItems.All(t => !t.Enabled.Value));
diff --git a/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlay.cs b/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlay.cs
index bae9af1897..63ce057667 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlay.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlay.cs
@@ -71,7 +71,7 @@ namespace osu.Game.Tests.Visual.Online
                     Ratings = Enumerable.Range(0, 11).ToArray(),
                     HasStoryboard = true,
                     Covers = new BeatmapSetOnlineCovers(),
-                    Beatmaps = new List<APIBeatmap>
+                    Beatmaps = new[]
                     {
                         new APIBeatmap
                         {
@@ -145,7 +145,7 @@ namespace osu.Game.Tests.Visual.Online
 
                 var set = getBeatmapSet();
 
-                set.Beatmaps = beatmaps;
+                set.Beatmaps = beatmaps.ToArray();
 
                 overlay.ShowBeatmapSet(set);
             });
@@ -211,7 +211,7 @@ namespace osu.Game.Tests.Visual.Online
                 });
             }
 
-            set.Beatmaps = beatmaps;
+            set.Beatmaps = beatmaps.ToArray();
 
             return set;
         }
diff --git a/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlayDetails.cs b/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlayDetails.cs
index 491a2d5d90..9c0c67b1d8 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlayDetails.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlayDetails.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.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
@@ -46,7 +45,7 @@ namespace osu.Game.Tests.Visual.Online
 
             static APIBeatmapSet createSet() => new APIBeatmapSet
             {
-                Beatmaps = new List<APIBeatmap>
+                Beatmaps = new[]
                 {
                     new APIBeatmap
                     {
diff --git a/osu.Game.Tests/Visual/Online/TestSceneDirectPanel.cs b/osu.Game.Tests/Visual/Online/TestSceneDirectPanel.cs
index 9a3d998966..a3c8935fa8 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneDirectPanel.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneDirectPanel.cs
@@ -90,7 +90,7 @@ namespace osu.Game.Tests.Visual.Online
                 HasVideo = true,
                 HasStoryboard = true,
                 Covers = new BeatmapSetOnlineCovers(),
-                Beatmaps = new List<APIBeatmap>
+                Beatmaps = new[]
                 {
                     new APIBeatmap
                     {
@@ -129,7 +129,7 @@ namespace osu.Game.Tests.Visual.Online
                     HasVideo = true,
                     HasStoryboard = true,
                     Covers = new BeatmapSetOnlineCovers(),
-                    Beatmaps = beatmaps,
+                    Beatmaps = beatmaps.ToArray(),
                 };
             }
         }
diff --git a/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs b/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs
index d8efa20b39..22cf6d25cd 100644
--- a/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs
@@ -119,7 +119,7 @@ namespace osu.Game.Online.API.Requests.Responses
         public string Tags { get; set; } = string.Empty;
 
         [JsonProperty(@"beatmaps")]
-        public IEnumerable<APIBeatmap> Beatmaps { get; set; } = Array.Empty<APIBeatmap>();
+        public APIBeatmap[] Beatmaps { get; set; } = Array.Empty<APIBeatmap>();
 
         public virtual BeatmapSetInfo ToBeatmapSet(RulesetStore rulesets)
         {
diff --git a/osu.Game/Overlays/BeatmapListing/Panels/BeatmapPanel.cs b/osu.Game/Overlays/BeatmapListing/Panels/BeatmapPanel.cs
index 2fd05f6742..34086c214f 100644
--- a/osu.Game/Overlays/BeatmapListing/Panels/BeatmapPanel.cs
+++ b/osu.Game/Overlays/BeatmapListing/Panels/BeatmapPanel.cs
@@ -147,7 +147,7 @@ namespace osu.Game.Overlays.BeatmapListing.Panels
         {
             var icons = new List<DifficultyIcon>();
 
-            if (SetInfo.Beatmaps.Count() > maximum_difficulty_icons)
+            if (SetInfo.Beatmaps.Length > maximum_difficulty_icons)
             {
                 foreach (var ruleset in SetInfo.Beatmaps.Select(b => b.Ruleset).Distinct())
                     icons.Add(new GroupedDifficultyIcon(SetInfo.Beatmaps.Where(b => b.RulesetID == ruleset.OnlineID).ToList(), ruleset, this is ListBeatmapPanel ? Color4.White : colours.Gray5));
diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
index c690a621eb..70d907ba15 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
@@ -280,7 +280,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             var apiSet = new APIBeatmapSet
             {
                 OnlineID = set.OnlineID,
-                Beatmaps = set.Beatmaps.Select(b => new APIBeatmap { OnlineID = b.OnlineID })
+                Beatmaps = set.Beatmaps.Select(b => new APIBeatmap { OnlineID = b.OnlineID }).ToArray(),
             };
 
             return Task.FromResult(apiSet);

From 77be610b26c4dc5c6d99bbc5337f6aa2c0b675a3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 4 Nov 2021 17:09:20 +0900
Subject: [PATCH 0724/5547] Revert "Clean up `DirectDownloadButton` test scene"

This reverts commit baabe99f789aea701030531d538780efc7830dd0.
---
 .../Online/TestSceneDirectDownloadButton.cs   | 25 ++++++++++++++-----
 1 file changed, 19 insertions(+), 6 deletions(-)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneDirectDownloadButton.cs b/osu.Game.Tests/Visual/Online/TestSceneDirectDownloadButton.cs
index 8d7e0f9f0c..3d828077c8 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneDirectDownloadButton.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneDirectDownloadButton.cs
@@ -40,14 +40,14 @@ namespace osu.Game.Tests.Visual.Online
         {
             AddUntilStep("ensure manager loaded", () => beatmaps != null);
             ensureSoleilyRemoved();
-            createButtonWithBeatmap(CreateAPIBeatmapSet());
+            createButtonWithBeatmap(createSoleily());
             AddAssert("button state not downloaded", () => downloadButton.DownloadState == DownloadState.NotDownloaded);
             AddStep("import soleily", () => beatmaps.Import(TestResources.GetQuickTestBeatmapForImport()));
 
             AddUntilStep("wait for beatmap import", () => beatmaps.GetAllUsableBeatmapSets().Any(b => b.OnlineBeatmapSetID == 241526));
             AddAssert("button state downloaded", () => downloadButton.DownloadState == DownloadState.LocallyAvailable);
 
-            createButtonWithBeatmap(CreateAPIBeatmapSet());
+            createButtonWithBeatmap(createSoleily());
             AddAssert("button state downloaded", () => downloadButton.DownloadState == DownloadState.LocallyAvailable);
             ensureSoleilyRemoved();
             AddAssert("button state not downloaded", () => downloadButton.DownloadState == DownloadState.NotDownloaded);
@@ -68,7 +68,7 @@ namespace osu.Game.Tests.Visual.Online
             AddAssert($"button {(enabled ? "enabled" : "disabled")}", () => downloadButton.DownloadEnabled == enabled);
         }
 
-        private void createButtonWithBeatmap(APIBeatmapSet beatmap)
+        private void createButtonWithBeatmap(IBeatmapSetInfo beatmap)
         {
             AddStep("create button", () =>
             {
@@ -94,7 +94,20 @@ namespace osu.Game.Tests.Visual.Online
             });
         }
 
-        private APIBeatmapSet getDownloadableBeatmapSet()
+        private IBeatmapSetInfo createSoleily()
+        {
+            return new APIBeatmapSet
+            {
+                OnlineID = 241526,
+                Availability = new BeatmapSetOnlineAvailability
+                {
+                    DownloadDisabled = false,
+                    ExternalLink = string.Empty,
+                },
+            };
+        }
+
+        private IBeatmapSetInfo getDownloadableBeatmapSet()
         {
             var apiBeatmapSet = CreateAPIBeatmapSet();
 
@@ -104,7 +117,7 @@ namespace osu.Game.Tests.Visual.Online
             return apiBeatmapSet;
         }
 
-        private APIBeatmapSet getUndownloadableBeatmapSet()
+        private IBeatmapSetInfo getUndownloadableBeatmapSet()
         {
             var apiBeatmapSet = CreateAPIBeatmapSet();
 
@@ -130,7 +143,7 @@ namespace osu.Game.Tests.Visual.Online
 
             public DownloadState DownloadState => State.Value;
 
-            public TestDownloadButton(APIBeatmapSet beatmapSet)
+            public TestDownloadButton(IBeatmapSetInfo beatmapSet)
                 : base(beatmapSet)
             {
             }

From 7bab48762190b888dda9bb40c2c228397c0b1ac4 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 4 Nov 2021 16:17:50 +0900
Subject: [PATCH 0725/5547] Remove usage of `ToBeatmapInfo` in
 `APIScoreInfo.CreateScoreInfo`

---
 osu.Game/Online/API/Requests/Responses/APIScoreInfo.cs | 5 +----
 1 file changed, 1 insertion(+), 4 deletions(-)

diff --git a/osu.Game/Online/API/Requests/Responses/APIScoreInfo.cs b/osu.Game/Online/API/Requests/Responses/APIScoreInfo.cs
index 5395fe0429..82f56d27fd 100644
--- a/osu.Game/Online/API/Requests/Responses/APIScoreInfo.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIScoreInfo.cs
@@ -98,7 +98,7 @@ namespace osu.Game.Online.API.Requests.Responses
             {
                 TotalScore = TotalScore,
                 MaxCombo = MaxCombo,
-                BeatmapInfo = Beatmap?.ToBeatmapInfo(rulesets),
+                BeatmapInfo = beatmap,
                 User = User,
                 Accuracy = Accuracy,
                 OnlineScoreID = OnlineID,
@@ -111,9 +111,6 @@ namespace osu.Game.Online.API.Requests.Responses
                 Mods = modInstances,
             };
 
-            if (beatmap != null)
-                scoreInfo.BeatmapInfo = beatmap;
-
             if (Statistics != null)
             {
                 foreach (var kvp in Statistics)

From 08d94f864ff7bf50fbf0c9d251fe9a99c7a19675 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 1 Nov 2021 15:43:34 +0900
Subject: [PATCH 0726/5547] Update `ScoresContainer` to not use `ToBeatmapInfo`

---
 osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.cs | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.cs b/osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.cs
index 4a00c8b4a0..3891d68d35 100644
--- a/osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.cs
+++ b/osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.cs
@@ -66,7 +66,10 @@ namespace osu.Game.Overlays.BeatmapSet.Scores
                 if (value?.Scores.Any() != true)
                     return;
 
-                scoreManager.OrderByTotalScoreAsync(value.Scores.Select(s => s.CreateScoreInfo(rulesets, Beatmap.Value.ToBeatmapInfo(rulesets))).ToArray(), loadCancellationSource.Token)
+                // TODO: temporary. should be removed once `OrderByTotalScore` can accept `IScoreInfo`.
+                var beatmapInfo = new BeatmapInfo { MaxCombo = Beatmap.Value.MaxCombo };
+
+                scoreManager.OrderByTotalScoreAsync(value.Scores.Select(s => s.CreateScoreInfo(rulesets, beatmapInfo)).ToArray(), loadCancellationSource.Token)
                             .ContinueWith(ordered => Schedule(() =>
                             {
                                 if (loadCancellationSource.IsCancellationRequested)
@@ -78,7 +81,7 @@ namespace osu.Game.Overlays.BeatmapSet.Scores
                                 scoreTable.Show();
 
                                 var userScore = value.UserScore;
-                                var userScoreInfo = userScore?.Score.CreateScoreInfo(rulesets, Beatmap.Value.ToBeatmapInfo(rulesets));
+                                var userScoreInfo = userScore?.Score.CreateScoreInfo(rulesets, beatmapInfo);
 
                                 topScoresContainer.Add(new DrawableTopScore(topScore));
 

From eb17d897a36166e39b0ec714d23901dae3479582 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 1 Nov 2021 15:37:38 +0900
Subject: [PATCH 0727/5547] Finally, remove the `To*` methods as they have no
 usages

---
 .../API/Requests/Responses/APIBeatmap.cs      | 28 -------------------
 .../API/Requests/Responses/APIBeatmapSet.cs   | 22 ---------------
 2 files changed, 50 deletions(-)

diff --git a/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs b/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs
index 653b011f73..2560502173 100644
--- a/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs
@@ -81,34 +81,6 @@ namespace osu.Game.Online.API.Requests.Responses
 
         public double BPM { get; set; }
 
-        public virtual BeatmapInfo ToBeatmapInfo(RulesetStore rulesets)
-        {
-            var set = BeatmapSet?.ToBeatmapSet(rulesets);
-
-            return new BeatmapInfo
-            {
-                Metadata = set?.Metadata ?? new BeatmapMetadata(),
-                Ruleset = rulesets.GetRuleset(RulesetID),
-                StarDifficulty = StarRating,
-                OnlineBeatmapID = OnlineID,
-                Version = DifficultyName,
-                // this is actually an incorrect mapping (Length is calculated as drain length in lazer's import process, see BeatmapManager.calculateLength).
-                Length = Length,
-                Status = Status,
-                MD5Hash = Checksum,
-                BeatmapSet = set,
-                MaxCombo = MaxCombo,
-                BaseDifficulty = new BeatmapDifficulty
-                {
-                    DrainRate = DrainRate,
-                    CircleSize = CircleSize,
-                    ApproachRate = ApproachRate,
-                    OverallDifficulty = OverallDifficulty,
-                },
-                OnlineInfo = this,
-            };
-        }
-
         #region Implementation of IBeatmapInfo
 
         public IBeatmapMetadataInfo Metadata => (BeatmapSet as IBeatmapSetInfo)?.Metadata ?? new BeatmapMetadata();
diff --git a/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs b/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs
index c41271ad5c..47536879b2 100644
--- a/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs
@@ -3,11 +3,9 @@
 
 using System;
 using System.Collections.Generic;
-using System.Linq;
 using Newtonsoft.Json;
 using osu.Game.Beatmaps;
 using osu.Game.Database;
-using osu.Game.Rulesets;
 using osu.Game.Users;
 
 #nullable enable
@@ -121,26 +119,6 @@ namespace osu.Game.Online.API.Requests.Responses
         [JsonProperty(@"beatmaps")]
         public APIBeatmap[] Beatmaps { get; set; } = Array.Empty<APIBeatmap>();
 
-        public virtual BeatmapSetInfo ToBeatmapSet(RulesetStore rulesets)
-        {
-            var beatmapSet = new BeatmapSetInfo
-            {
-                OnlineBeatmapSetID = OnlineID,
-                Metadata = metadata,
-                Status = Status,
-            };
-
-            beatmapSet.Beatmaps = Beatmaps.Select(b =>
-            {
-                var beatmap = b.ToBeatmapInfo(rulesets);
-                beatmap.BeatmapSet = beatmapSet;
-                beatmap.Metadata = beatmapSet.Metadata;
-                return beatmap;
-            }).ToList();
-
-            return beatmapSet;
-        }
-
         private BeatmapMetadata metadata => new BeatmapMetadata
         {
             Title = Title,

From b80c02b757346a99012949d9d227fb876c8f3bcd Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 4 Nov 2021 17:24:40 +0900
Subject: [PATCH 0728/5547] Fix crash on gameplay startup if beatmap has no
 background

---
 osu.Game/Storyboards/Storyboard.cs | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Storyboards/Storyboard.cs b/osu.Game/Storyboards/Storyboard.cs
index 99123627bd..9e3d3df915 100644
--- a/osu.Game/Storyboards/Storyboard.cs
+++ b/osu.Game/Storyboards/Storyboard.cs
@@ -77,10 +77,14 @@ namespace osu.Game.Storyboards
         {
             get
             {
-                string backgroundPath = BeatmapInfo.BeatmapSet?.Metadata?.BackgroundFile.ToLowerInvariant();
+                string backgroundPath = BeatmapInfo.BeatmapSet?.Metadata?.BackgroundFile;
+
                 if (string.IsNullOrEmpty(backgroundPath))
                     return false;
 
+                // Importantly, do this after the NullOrEmpty because EF may have stored the non-nullable value as null to the database, bypassing compile-time constraints.
+                backgroundPath = backgroundPath.ToLowerInvariant();
+
                 return GetLayer("Background").Elements.Any(e => e.Path.ToLowerInvariant() == backgroundPath);
             }
         }
@@ -93,7 +97,7 @@ namespace osu.Game.Storyboards
             Drawable drawable = null;
             string storyboardPath = BeatmapInfo.BeatmapSet?.Files.Find(f => f.Filename.Equals(path, StringComparison.OrdinalIgnoreCase))?.FileInfo.StoragePath;
 
-            if (storyboardPath != null)
+            if (!string.IsNullOrEmpty(storyboardPath))
                 drawable = new Sprite { Texture = textureStore.Get(storyboardPath) };
             // if the texture isn't available locally in the beatmap, some storyboards choose to source from the underlying skin lookup hierarchy.
             else if (UseSkinSprites)

From 25b0bccfd5570ccb343888a6874e1fa6324933bb Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 4 Nov 2021 17:39:32 +0900
Subject: [PATCH 0729/5547] Remove unused team class

---
 osu.Game/Users/Team.cs | 10 ----------
 osu.Game/Users/User.cs |  2 --
 2 files changed, 12 deletions(-)
 delete mode 100644 osu.Game/Users/Team.cs

diff --git a/osu.Game/Users/Team.cs b/osu.Game/Users/Team.cs
deleted file mode 100644
index b56a083fdf..0000000000
--- a/osu.Game/Users/Team.cs
+++ /dev/null
@@ -1,10 +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.Users
-{
-    public class Team
-    {
-        public string Name;
-    }
-}
diff --git a/osu.Game/Users/User.cs b/osu.Game/Users/User.cs
index 20c23153f0..4ee7d20734 100644
--- a/osu.Game/Users/User.cs
+++ b/osu.Game/Users/User.cs
@@ -33,8 +33,6 @@ namespace osu.Game.Users
 
         public readonly Bindable<UserActivity> Activity = new Bindable<UserActivity>();
 
-        //public Team Team;
-
         [JsonProperty(@"profile_colour")]
         public string Colour;
 

From df3c3a32ceb9e03082c03b74f48ba488091bda2c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 4 Nov 2021 15:35:32 +0900
Subject: [PATCH 0730/5547] Fix unintentionally broken background update logic

---
 .../OnlinePlay/Components/OnlinePlayBackgroundScreen.cs       | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Screens/OnlinePlay/Components/OnlinePlayBackgroundScreen.cs b/osu.Game/Screens/OnlinePlay/Components/OnlinePlayBackgroundScreen.cs
index 279a8e1a14..ffc5c07d4e 100644
--- a/osu.Game/Screens/OnlinePlay/Components/OnlinePlayBackgroundScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Components/OnlinePlayBackgroundScreen.cs
@@ -60,8 +60,10 @@ namespace osu.Game.Screens.OnlinePlay.Components
         {
             Schedule(() =>
             {
+                var beatmap = playlistItem?.Beatmap.Value;
+
                 string? lastCover = (background?.Beatmap?.BeatmapSet as IBeatmapSetOnlineInfo)?.Covers.Cover;
-                string? newCover = (background?.Beatmap?.BeatmapSet as IBeatmapSetOnlineInfo)?.Covers.Cover;
+                string? newCover = (beatmap?.BeatmapSet as IBeatmapSetOnlineInfo)?.Covers.Cover;
 
                 if (lastCover == newCover)
                     return;

From b9983add1518177e8281ed2ddf6e128dfd343cf9 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 4 Nov 2021 18:02:44 +0900
Subject: [PATCH 0731/5547] Rename `User` to `APIUser` and move to correct
 namespace

---
 .../Mods/EmptyFreeformModAutoplay.cs          |   4 +-
 .../Mods/PippidonModAutoplay.cs               |   4 +-
 .../Mods/EmptyScrollingModAutoplay.cs         |   4 +-
 .../Mods/PippidonModAutoplay.cs               |   4 +-
 osu.Desktop/DiscordRichPresence.cs            |   4 +-
 .../Mods/CatchModAutoplay.cs                  |   4 +-
 .../Mods/CatchModCinema.cs                    |   4 +-
 .../Mods/ManiaModAutoplay.cs                  |   4 +-
 .../Mods/ManiaModCinema.cs                    |   4 +-
 .../TestSceneMissHitWindowJudgements.cs       |   4 +-
 osu.Game.Rulesets.Osu/Mods/OsuModAutoplay.cs  |   4 +-
 osu.Game.Rulesets.Osu/Mods/OsuModCinema.cs    |   4 +-
 .../Mods/TaikoModAutoplay.cs                  |   4 +-
 .../Mods/TaikoModCinema.cs                    |   4 +-
 .../Beatmaps/IO/ImportBeatmapTest.cs          |   8 +-
 .../Beatmaps/ToStringFormattingTest.cs        |   6 +-
 .../Chat/TestSceneChannelManager.cs           |   4 +-
 .../StatefulMultiplayerClientTest.cs          |   6 +-
 .../StatefulMultiplayerClientTest.cs          |   6 +-
 osu.Game.Tests/Scores/IO/ImportScoreTest.cs   |   4 +-
 .../TestSceneBackgroundScreenDefault.cs       |   4 +-
 .../Background/TestSceneUserDimBackgrounds.cs |   4 +-
 .../Visual/Beatmaps/TestSceneBeatmapCard.cs   |   6 +-
 .../Gameplay/TestSceneGameplayLeaderboard.cs  |  28 +-
 .../Gameplay/TestSceneReplayDownloadButton.cs |   4 +-
 .../Visual/Gameplay/TestSceneSpectator.cs     |   4 +-
 .../Visual/Gameplay/TestSceneSpectatorHost.cs |   4 +-
 .../Visual/Menus/TestSceneDisclaimer.cs       |   4 +-
 .../Multiplayer/TestSceneDrawableRoom.cs      |   6 +-
 .../TestSceneDrawableRoomParticipantsList.cs  |   6 +-
 .../TestSceneDrawableRoomPlaylist.cs          |   4 +-
 .../Multiplayer/TestSceneMatchLeaderboard.cs  |   6 +-
 .../TestSceneMultiSpectatorLeaderboard.cs     |   4 +-
 .../TestSceneMultiSpectatorScreen.cs          |  12 +-
 .../Multiplayer/TestSceneMultiplayer.cs       |  12 +-
 ...TestSceneMultiplayerGameplayLeaderboard.cs |   4 +-
 ...ceneMultiplayerGameplayLeaderboardTeams.cs |   4 +-
 .../TestSceneMultiplayerMatchSubScreen.cs     |   4 +-
 .../TestSceneMultiplayerParticipantsList.cs   |  19 +-
 .../TestSceneMultiplayerReadyButton.cs        |  12 +-
 .../TestSceneMultiplayerResults.cs            |   4 +-
 .../TestSceneMultiplayerSpectateButton.cs     |   6 +-
 .../TestSceneMultiplayerTeamResults.cs        |   4 +-
 .../Multiplayer/TestSceneRankRangePill.cs     |  14 +-
 .../Online/TestSceneAccountCreationOverlay.cs |   3 +-
 .../Online/TestSceneBeatmapListingOverlay.cs  |   4 +-
 .../Online/TestSceneBeatmapSetOverlay.cs      |   4 +-
 .../Online/TestSceneChannelTabControl.cs      |   4 +-
 .../Online/TestSceneChatLineTruncation.cs     |   8 +-
 .../Visual/Online/TestSceneChatLink.cs        |   8 +-
 .../Visual/Online/TestSceneChatOverlay.cs     |   8 +-
 .../TestSceneCurrentlyPlayingDisplay.cs       |   9 +-
 .../Visual/Online/TestSceneDirectPanel.cs     |   6 +-
 .../Visual/Online/TestSceneFriendDisplay.cs   |   9 +-
 .../Online/TestSceneHistoricalSection.cs      |   6 +-
 .../Visual/Online/TestSceneMessageNotifier.cs |  10 +-
 .../TestSceneOfflineCommentsContainer.cs      |   6 +-
 .../Online/TestScenePlayHistorySubsection.cs  |  59 ++--
 .../Online/TestSceneProfileRulesetSelector.cs |  12 +-
 .../Visual/Online/TestSceneRankGraph.cs       |   9 +-
 .../Visual/Online/TestSceneScoresContainer.cs |  17 +-
 .../Online/TestSceneStandAloneChatDisplay.cs  |  10 +-
 .../Online/TestSceneUserHistoryGraph.cs       |  34 +-
 .../Visual/Online/TestSceneUserPanel.cs       |  13 +-
 .../Online/TestSceneUserProfileHeader.cs      |  13 +-
 .../Online/TestSceneUserProfileOverlay.cs     |  15 +-
 .../TestSceneUserProfilePreviousUsernames.cs  |  14 +-
 .../Visual/Online/TestSceneUserRanks.cs       |   4 +-
 .../Visual/Online/TestSceneUserRequest.cs     |   8 +-
 .../TestScenePlaylistsParticipantsList.cs     |   3 +-
 .../TestScenePlaylistsResultsScreen.cs        |   8 +-
 .../Visual/Ranking/TestSceneAccuracyCircle.cs |   4 +-
 .../TestSceneExpandedPanelMiddleContent.cs    |   8 +-
 .../SongSelect/TestSceneBeatmapLeaderboard.cs |  25 +-
 .../TestSceneBeatmapRecommendations.cs        |   5 +-
 .../SongSelect/TestScenePlaySongSelect.cs     |   6 +-
 .../TestSceneUserTopScoreContainer.cs         |   7 +-
 .../TestSceneDashboardBeatmapListing.cs       |  10 +-
 .../TestSceneDeleteLocalScore.cs              |   6 +-
 .../TestSceneFriendsOnlineStatusControl.cs    |  10 +-
 .../TestSceneDrawableTournamentTeam.cs        |  16 +-
 .../TestSceneTournamentMatchChatDisplay.cs    |  12 +-
 .../TournamentTestScene.cs                    |  21 +-
 .../Components/DrawableTeamWithPlayers.cs     |   4 +-
 osu.Game.Tournament/Models/TournamentTeam.cs  |   4 +-
 .../Screens/Editors/TeamEditorScreen.cs       |   7 +-
 osu.Game.Tournament/TournamentGameBase.cs     |   4 +-
 osu.Game/Beatmaps/BeatmapManager.cs           |   6 +-
 osu.Game/Beatmaps/BeatmapMetadata.cs          |  12 +-
 osu.Game/Database/UserLookupCache.cs          |  30 +-
 .../Graphics/Containers/LinkFlowContainer.cs  |   4 +-
 osu.Game/Online/API/APIAccess.cs              |  13 +-
 osu.Game/Online/API/APIRequest.cs             |   4 +-
 osu.Game/Online/API/DummyAPIAccess.cs         |  11 +-
 osu.Game/Online/API/IAPIProvider.cs           |   5 +-
 .../CreateNewPrivateMessageRequest.cs         |   6 +-
 .../Online/API/Requests/GetFriendsRequest.cs  |   4 +-
 .../Online/API/Requests/GetUserRequest.cs     |   4 +-
 .../Online/API/Requests/GetUsersResponse.cs   |   4 +-
 .../API/Requests/Responses/APIBeatmapSet.cs   |  11 +-
 .../API/Requests/Responses/APIPlayStyle.cs    |  22 ++
 .../API/Requests/Responses/APIScoreInfo.cs    |   3 +-
 .../Online/API/Requests/Responses/APIUser.cs  | 253 ++++++++++++++-
 .../Requests/Responses/APIUserContainer.cs    |  13 +
 .../Requests/Responses/APIUserHistoryCount.cs |  17 +
 .../Responses/APIUserScoreAggregate.cs        |   3 +-
 .../Online/API/Requests/Responses/Comment.cs  |   5 +-
 .../API/Requests/Responses/CommentBundle.cs   |   5 +-
 osu.Game/Online/Chat/Channel.cs               |   8 +-
 osu.Game/Online/Chat/ChannelManager.cs        |   4 +-
 osu.Game/Online/Chat/InfoMessage.cs           |   4 +-
 osu.Game/Online/Chat/Message.cs               |   4 +-
 osu.Game/Online/Chat/MessageNotifier.cs       |   4 +-
 .../Online/Multiplayer/MultiplayerClient.cs   |   6 +-
 .../Online/Multiplayer/MultiplayerRoomUser.cs |   4 +-
 osu.Game/Online/Rooms/MultiplayerScore.cs     |   4 +-
 osu.Game/Online/Rooms/Room.cs                 |   6 +-
 osu.Game/Online/Solo/SubmittableScore.cs      |   4 +-
 osu.Game/Overlays/BeatmapSet/AuthorInfo.cs    |   4 +-
 .../BeatmapSet/Buttons/FavouriteButton.cs     |   4 +-
 .../Buttons/HeaderDownloadButton.cs           |   6 +-
 .../BeatmapSet/Scores/ScoresContainer.cs      |   6 +-
 osu.Game/Overlays/Changelog/ChangelogEntry.cs |   4 +-
 osu.Game/Overlays/Chat/ChatLine.cs            |   8 +-
 .../Overlays/Comments/CommentsContainer.cs    |   4 +-
 .../Dashboard/CurrentlyPlayingDisplay.cs      |   7 +-
 .../Dashboard/Friends/FriendDisplay.cs        |  15 +-
 .../Friends/FriendOnlineStreamControl.cs      |   4 +-
 .../Profile/Header/BottomHeaderContainer.cs   |   6 +-
 .../Profile/Header/CentreHeaderContainer.cs   |   6 +-
 .../Header/Components/FollowersButton.cs      |   4 +-
 .../Profile/Header/Components/LevelBadge.cs   |   6 +-
 .../Header/Components/LevelProgressBar.cs     |   6 +-
 .../Components/MappingSubscribersButton.cs    |   4 +-
 .../Header/Components/MessageUserButton.cs    |   4 +-
 .../Components/OverlinedTotalPlayTime.cs      |   6 +-
 .../Header/Components/PreviousUsernames.cs    |   6 +-
 .../Components/ProfileRulesetSelector.cs      |   4 +-
 .../Profile/Header/DetailHeaderContainer.cs   |   6 +-
 .../Profile/Header/MedalHeaderContainer.cs    |   6 +-
 .../Profile/Header/TopHeaderContainer.cs      |   6 +-
 osu.Game/Overlays/Profile/ProfileHeader.cs    |   5 +-
 osu.Game/Overlays/Profile/ProfileSection.cs   |   4 +-
 .../Beatmaps/PaginatedBeatmapContainer.cs     |   6 +-
 .../Historical/ChartProfileSubsection.cs      |  15 +-
 .../PaginatedMostPlayedBeatmapContainer.cs    |   6 +-
 .../Historical/PlayHistorySubsection.cs       |   7 +-
 .../Sections/Historical/ProfileLineChart.cs   |   6 +-
 .../Sections/Historical/ReplaysSubsection.cs  |   7 +-
 .../Sections/Historical/UserHistoryGraph.cs   |   4 +-
 .../Profile/Sections/Kudosu/KudosuInfo.cs     |   6 +-
 .../Kudosu/PaginatedKudosuHistoryContainer.cs |   4 +-
 .../Sections/PaginatedProfileSubsection.cs    |   8 +-
 .../Profile/Sections/ProfileSubsection.cs     |   6 +-
 .../Sections/Ranks/PaginatedScoreContainer.cs |   6 +-
 .../PaginatedRecentActivityContainer.cs       |   4 +-
 .../UserInterface/MainMenuSettings.cs         |   4 +-
 .../Overlays/Toolbar/ToolbarUserButton.cs     |   4 +-
 osu.Game/Overlays/UserProfileOverlay.cs       |  12 +-
 osu.Game/Scoring/IScoreInfo.cs                |   4 +-
 osu.Game/Scoring/Legacy/LegacyScoreDecoder.cs |   4 +-
 osu.Game/Scoring/ScoreInfo.cs                 |   8 +-
 .../Backgrounds/BackgroundScreenDefault.cs    |   4 +-
 osu.Game/Screens/Menu/Disclaimer.cs           |   6 +-
 .../Screens/Menu/MenuLogoVisualisation.cs     |   4 +-
 osu.Game/Screens/Menu/MenuSideFlashes.cs      |   4 +-
 .../OnlinePlay/Components/ParticipantsList.cs |   4 +-
 .../OnlinePlay/DrawableRoomPlaylistItem.cs    |   4 +-
 .../DrawableRoomParticipantsList.cs           |  14 +-
 .../OnlinePlay/Match/DrawableMatchRoom.cs     |   4 +-
 .../Screens/OnlinePlay/OnlinePlayComposite.cs |   6 +-
 .../Screens/Play/HUD/GameplayLeaderboard.cs   |   6 +-
 .../Play/HUD/GameplayLeaderboardScore.cs      |   6 +-
 .../HUD/MultiplayerGameplayLeaderboard.cs     |   4 +-
 osu.Game/Screens/Play/SoloSpectator.cs        |   5 +-
 .../Expanded/ExpandedPanelTopContent.cs       |   8 +-
 osu.Game/Screens/Spectate/SpectatorScreen.cs  |   4 +-
 .../Tests/Beatmaps/HitObjectSampleTest.cs     |   4 +-
 osu.Game/Tests/TestScoreInfo.cs               |   4 +-
 .../Multiplayer/TestMultiplayerClient.cs      |   6 +-
 .../Visual/OnlinePlay/TestRoomManager.cs      |   4 +-
 .../OnlinePlay/TestRoomRequestsHandler.cs     |   4 +-
 osu.Game/Tests/Visual/TestUserLookupCache.cs  |  10 +-
 osu.Game/Users/Drawables/ClickableAvatar.cs   |   5 +-
 osu.Game/Users/Drawables/DrawableAvatar.cs    |   5 +-
 osu.Game/Users/Drawables/UpdateableAvatar.cs  |   9 +-
 osu.Game/Users/ExtendedUserPanel.cs           |   3 +-
 osu.Game/Users/IUser.cs                       |  12 +
 osu.Game/Users/User.cs                        | 292 ------------------
 osu.Game/Users/UserBrickPanel.cs              |   3 +-
 osu.Game/Users/UserCoverBackground.cs         |  11 +-
 osu.Game/Users/UserGridPanel.cs               |   3 +-
 osu.Game/Users/UserListPanel.cs               |   3 +-
 osu.Game/Users/UserPanel.cs                   |   5 +-
 osu.Game/Users/UserStatistics.cs              |   5 +-
 195 files changed, 991 insertions(+), 947 deletions(-)
 create mode 100644 osu.Game/Online/API/Requests/Responses/APIPlayStyle.cs
 create mode 100644 osu.Game/Online/API/Requests/Responses/APIUserContainer.cs
 create mode 100644 osu.Game/Online/API/Requests/Responses/APIUserHistoryCount.cs
 create mode 100644 osu.Game/Users/IUser.cs
 delete mode 100644 osu.Game/Users/User.cs

diff --git a/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform/Mods/EmptyFreeformModAutoplay.cs b/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform/Mods/EmptyFreeformModAutoplay.cs
index f705009d18..d4496a24fd 100644
--- a/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform/Mods/EmptyFreeformModAutoplay.cs
+++ b/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform/Mods/EmptyFreeformModAutoplay.cs
@@ -3,10 +3,10 @@
 
 using System.Collections.Generic;
 using osu.Game.Beatmaps;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets.EmptyFreeform.Replays;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Scoring;
-using osu.Game.Users;
 
 namespace osu.Game.Rulesets.EmptyFreeform.Mods
 {
@@ -16,7 +16,7 @@ namespace osu.Game.Rulesets.EmptyFreeform.Mods
         {
             ScoreInfo = new ScoreInfo
             {
-                User = new User { Username = "sample" },
+                User = new APIUser { Username = "sample" },
             },
             Replay = new EmptyFreeformAutoGenerator(beatmap).Generate(),
         };
diff --git a/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon/Mods/PippidonModAutoplay.cs b/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon/Mods/PippidonModAutoplay.cs
index 4565c97d1a..6e1fe42ee2 100644
--- a/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon/Mods/PippidonModAutoplay.cs
+++ b/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon/Mods/PippidonModAutoplay.cs
@@ -3,10 +3,10 @@
 
 using System.Collections.Generic;
 using osu.Game.Beatmaps;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Pippidon.Replays;
 using osu.Game.Scoring;
-using osu.Game.Users;
 
 namespace osu.Game.Rulesets.Pippidon.Mods
 {
@@ -16,7 +16,7 @@ namespace osu.Game.Rulesets.Pippidon.Mods
         {
             ScoreInfo = new ScoreInfo
             {
-                User = new User { Username = "sample" },
+                User = new APIUser { Username = "sample" },
             },
             Replay = new PippidonAutoGenerator(beatmap).Generate(),
         };
diff --git a/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling/Mods/EmptyScrollingModAutoplay.cs b/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling/Mods/EmptyScrollingModAutoplay.cs
index 431994e098..c5bacb522f 100644
--- a/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling/Mods/EmptyScrollingModAutoplay.cs
+++ b/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling/Mods/EmptyScrollingModAutoplay.cs
@@ -5,8 +5,8 @@ using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.EmptyScrolling.Replays;
 using osu.Game.Scoring;
-using osu.Game.Users;
 using System.Collections.Generic;
+using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Rulesets.EmptyScrolling.Mods
 {
@@ -16,7 +16,7 @@ namespace osu.Game.Rulesets.EmptyScrolling.Mods
         {
             ScoreInfo = new ScoreInfo
             {
-                User = new User { Username = "sample" },
+                User = new APIUser { Username = "sample" },
             },
             Replay = new EmptyScrollingAutoGenerator(beatmap).Generate(),
         };
diff --git a/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon/Mods/PippidonModAutoplay.cs b/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon/Mods/PippidonModAutoplay.cs
index 4565c97d1a..6e1fe42ee2 100644
--- a/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon/Mods/PippidonModAutoplay.cs
+++ b/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon/Mods/PippidonModAutoplay.cs
@@ -3,10 +3,10 @@
 
 using System.Collections.Generic;
 using osu.Game.Beatmaps;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Pippidon.Replays;
 using osu.Game.Scoring;
-using osu.Game.Users;
 
 namespace osu.Game.Rulesets.Pippidon.Mods
 {
@@ -16,7 +16,7 @@ namespace osu.Game.Rulesets.Pippidon.Mods
         {
             ScoreInfo = new ScoreInfo
             {
-                User = new User { Username = "sample" },
+                User = new APIUser { Username = "sample" },
             },
             Replay = new PippidonAutoGenerator(beatmap).Generate(),
         };
diff --git a/osu.Desktop/DiscordRichPresence.cs b/osu.Desktop/DiscordRichPresence.cs
index e2b40e9dc6..e1e7e6ad18 100644
--- a/osu.Desktop/DiscordRichPresence.cs
+++ b/osu.Desktop/DiscordRichPresence.cs
@@ -11,10 +11,10 @@ using osu.Framework.Graphics;
 using osu.Framework.Logging;
 using osu.Game.Configuration;
 using osu.Game.Online.API;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets;
 using osu.Game.Users;
 using LogLevel = osu.Framework.Logging.LogLevel;
-using User = osu.Game.Users.User;
 
 namespace osu.Desktop
 {
@@ -27,7 +27,7 @@ namespace osu.Desktop
         [Resolved]
         private IBindable<RulesetInfo> ruleset { get; set; }
 
-        private IBindable<User> user;
+        private IBindable<APIUser> user;
 
         private readonly IBindable<UserStatus> status = new Bindable<UserStatus>();
         private readonly IBindable<UserActivity> activity = new Bindable<UserActivity>();
diff --git a/osu.Game.Rulesets.Catch/Mods/CatchModAutoplay.cs b/osu.Game.Rulesets.Catch/Mods/CatchModAutoplay.cs
index 6f3e6763bd..11fffb31de 100644
--- a/osu.Game.Rulesets.Catch/Mods/CatchModAutoplay.cs
+++ b/osu.Game.Rulesets.Catch/Mods/CatchModAutoplay.cs
@@ -3,10 +3,10 @@
 
 using System.Collections.Generic;
 using osu.Game.Beatmaps;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets.Catch.Replays;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Scoring;
-using osu.Game.Users;
 
 namespace osu.Game.Rulesets.Catch.Mods
 {
@@ -14,7 +14,7 @@ namespace osu.Game.Rulesets.Catch.Mods
     {
         public override Score CreateReplayScore(IBeatmap beatmap, IReadOnlyList<Mod> mods) => new Score
         {
-            ScoreInfo = new ScoreInfo { User = new User { Username = "osu!salad" } },
+            ScoreInfo = new ScoreInfo { User = new APIUser { Username = "osu!salad" } },
             Replay = new CatchAutoGenerator(beatmap).Generate(),
         };
     }
diff --git a/osu.Game.Rulesets.Catch/Mods/CatchModCinema.cs b/osu.Game.Rulesets.Catch/Mods/CatchModCinema.cs
index 1b7d254321..6d2286b957 100644
--- a/osu.Game.Rulesets.Catch/Mods/CatchModCinema.cs
+++ b/osu.Game.Rulesets.Catch/Mods/CatchModCinema.cs
@@ -3,11 +3,11 @@
 
 using System.Collections.Generic;
 using osu.Game.Beatmaps;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets.Catch.Objects;
 using osu.Game.Rulesets.Catch.Replays;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Scoring;
-using osu.Game.Users;
 
 namespace osu.Game.Rulesets.Catch.Mods
 {
@@ -15,7 +15,7 @@ namespace osu.Game.Rulesets.Catch.Mods
     {
         public override Score CreateReplayScore(IBeatmap beatmap, IReadOnlyList<Mod> mods) => new Score
         {
-            ScoreInfo = new ScoreInfo { User = new User { Username = "osu!salad" } },
+            ScoreInfo = new ScoreInfo { User = new APIUser { Username = "osu!salad" } },
             Replay = new CatchAutoGenerator(beatmap).Generate(),
         };
     }
diff --git a/osu.Game.Rulesets.Mania/Mods/ManiaModAutoplay.cs b/osu.Game.Rulesets.Mania/Mods/ManiaModAutoplay.cs
index 86f667466f..1504c868d0 100644
--- a/osu.Game.Rulesets.Mania/Mods/ManiaModAutoplay.cs
+++ b/osu.Game.Rulesets.Mania/Mods/ManiaModAutoplay.cs
@@ -3,11 +3,11 @@
 
 using System.Collections.Generic;
 using osu.Game.Beatmaps;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets.Mania.Beatmaps;
 using osu.Game.Rulesets.Mania.Replays;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Scoring;
-using osu.Game.Users;
 
 namespace osu.Game.Rulesets.Mania.Mods
 {
@@ -15,7 +15,7 @@ namespace osu.Game.Rulesets.Mania.Mods
     {
         public override Score CreateReplayScore(IBeatmap beatmap, IReadOnlyList<Mod> mods) => new Score
         {
-            ScoreInfo = new ScoreInfo { User = new User { Username = "osu!topus" } },
+            ScoreInfo = new ScoreInfo { User = new APIUser { Username = "osu!topus" } },
             Replay = new ManiaAutoGenerator((ManiaBeatmap)beatmap).Generate(),
         };
     }
diff --git a/osu.Game.Rulesets.Mania/Mods/ManiaModCinema.cs b/osu.Game.Rulesets.Mania/Mods/ManiaModCinema.cs
index 1c06bb389b..4f1276946b 100644
--- a/osu.Game.Rulesets.Mania/Mods/ManiaModCinema.cs
+++ b/osu.Game.Rulesets.Mania/Mods/ManiaModCinema.cs
@@ -3,12 +3,12 @@
 
 using System.Collections.Generic;
 using osu.Game.Beatmaps;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets.Mania.Beatmaps;
 using osu.Game.Rulesets.Mania.Objects;
 using osu.Game.Rulesets.Mania.Replays;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Scoring;
-using osu.Game.Users;
 
 namespace osu.Game.Rulesets.Mania.Mods
 {
@@ -16,7 +16,7 @@ namespace osu.Game.Rulesets.Mania.Mods
     {
         public override Score CreateReplayScore(IBeatmap beatmap, IReadOnlyList<Mod> mods) => new Score
         {
-            ScoreInfo = new ScoreInfo { User = new User { Username = "osu!topus" } },
+            ScoreInfo = new ScoreInfo { User = new APIUser { Username = "osu!topus" } },
             Replay = new ManiaAutoGenerator((ManiaBeatmap)beatmap).Generate(),
         };
     }
diff --git a/osu.Game.Rulesets.Osu.Tests/TestSceneMissHitWindowJudgements.cs b/osu.Game.Rulesets.Osu.Tests/TestSceneMissHitWindowJudgements.cs
index a5629119b6..840d871b7b 100644
--- a/osu.Game.Rulesets.Osu.Tests/TestSceneMissHitWindowJudgements.cs
+++ b/osu.Game.Rulesets.Osu.Tests/TestSceneMissHitWindowJudgements.cs
@@ -4,6 +4,7 @@
 using System.Collections.Generic;
 using NUnit.Framework;
 using osu.Game.Beatmaps;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Replays;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Osu.Beatmaps;
@@ -14,7 +15,6 @@ using osu.Game.Rulesets.Osu.Scoring;
 using osu.Game.Rulesets.Scoring;
 using osu.Game.Scoring;
 using osu.Game.Tests.Visual;
-using osu.Game.Users;
 using osuTK;
 
 namespace osu.Game.Rulesets.Osu.Tests
@@ -69,7 +69,7 @@ namespace osu.Game.Rulesets.Osu.Tests
         {
             public override Score CreateReplayScore(IBeatmap beatmap, IReadOnlyList<Mod> mods) => new Score
             {
-                ScoreInfo = new ScoreInfo { User = new User { Username = "Autoplay" } },
+                ScoreInfo = new ScoreInfo { User = new APIUser { Username = "Autoplay" } },
                 Replay = new MissingAutoGenerator(beatmap, mods).Generate()
             };
         }
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModAutoplay.cs b/osu.Game.Rulesets.Osu/Mods/OsuModAutoplay.cs
index 652da7123e..106edfb623 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModAutoplay.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModAutoplay.cs
@@ -5,10 +5,10 @@ using System;
 using System.Collections.Generic;
 using System.Linq;
 using osu.Game.Beatmaps;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Osu.Replays;
 using osu.Game.Scoring;
-using osu.Game.Users;
 
 namespace osu.Game.Rulesets.Osu.Mods
 {
@@ -18,7 +18,7 @@ namespace osu.Game.Rulesets.Osu.Mods
 
         public override Score CreateReplayScore(IBeatmap beatmap, IReadOnlyList<Mod> mods) => new Score
         {
-            ScoreInfo = new ScoreInfo { User = new User { Username = "Autoplay" } },
+            ScoreInfo = new ScoreInfo { User = new APIUser { Username = "Autoplay" } },
             Replay = new OsuAutoGenerator(beatmap, mods).Generate()
         };
     }
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModCinema.cs b/osu.Game.Rulesets.Osu/Mods/OsuModCinema.cs
index df06988b70..f478790134 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModCinema.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModCinema.cs
@@ -5,11 +5,11 @@ using System;
 using System.Collections.Generic;
 using System.Linq;
 using osu.Game.Beatmaps;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Osu.Objects;
 using osu.Game.Rulesets.Osu.Replays;
 using osu.Game.Scoring;
-using osu.Game.Users;
 
 namespace osu.Game.Rulesets.Osu.Mods
 {
@@ -19,7 +19,7 @@ namespace osu.Game.Rulesets.Osu.Mods
 
         public override Score CreateReplayScore(IBeatmap beatmap, IReadOnlyList<Mod> mods) => new Score
         {
-            ScoreInfo = new ScoreInfo { User = new User { Username = "Autoplay" } },
+            ScoreInfo = new ScoreInfo { User = new APIUser { Username = "Autoplay" } },
             Replay = new OsuAutoGenerator(beatmap, mods).Generate()
         };
     }
diff --git a/osu.Game.Rulesets.Taiko/Mods/TaikoModAutoplay.cs b/osu.Game.Rulesets.Taiko/Mods/TaikoModAutoplay.cs
index 31d9abf8b2..5832ae3dc1 100644
--- a/osu.Game.Rulesets.Taiko/Mods/TaikoModAutoplay.cs
+++ b/osu.Game.Rulesets.Taiko/Mods/TaikoModAutoplay.cs
@@ -3,10 +3,10 @@
 
 using System.Collections.Generic;
 using osu.Game.Beatmaps;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Taiko.Replays;
 using osu.Game.Scoring;
-using osu.Game.Users;
 
 namespace osu.Game.Rulesets.Taiko.Mods
 {
@@ -14,7 +14,7 @@ namespace osu.Game.Rulesets.Taiko.Mods
     {
         public override Score CreateReplayScore(IBeatmap beatmap, IReadOnlyList<Mod> mods) => new Score
         {
-            ScoreInfo = new ScoreInfo { User = new User { Username = "mekkadosu!" } },
+            ScoreInfo = new ScoreInfo { User = new APIUser { Username = "mekkadosu!" } },
             Replay = new TaikoAutoGenerator(beatmap).Generate(),
         };
     }
diff --git a/osu.Game.Rulesets.Taiko/Mods/TaikoModCinema.cs b/osu.Game.Rulesets.Taiko/Mods/TaikoModCinema.cs
index 00f0c8e321..f76e04a069 100644
--- a/osu.Game.Rulesets.Taiko/Mods/TaikoModCinema.cs
+++ b/osu.Game.Rulesets.Taiko/Mods/TaikoModCinema.cs
@@ -3,11 +3,11 @@
 
 using System.Collections.Generic;
 using osu.Game.Beatmaps;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Taiko.Objects;
 using osu.Game.Rulesets.Taiko.Replays;
 using osu.Game.Scoring;
-using osu.Game.Users;
 
 namespace osu.Game.Rulesets.Taiko.Mods
 {
@@ -15,7 +15,7 @@ namespace osu.Game.Rulesets.Taiko.Mods
     {
         public override Score CreateReplayScore(IBeatmap beatmap, IReadOnlyList<Mod> mods) => new Score
         {
-            ScoreInfo = new ScoreInfo { User = new User { Username = "mekkadosu!" } },
+            ScoreInfo = new ScoreInfo { User = new APIUser { Username = "mekkadosu!" } },
             Replay = new TaikoAutoGenerator(beatmap).Generate(),
         };
     }
diff --git a/osu.Game.Tests/Beatmaps/IO/ImportBeatmapTest.cs b/osu.Game.Tests/Beatmaps/IO/ImportBeatmapTest.cs
index d68d43c998..5e8d741356 100644
--- a/osu.Game.Tests/Beatmaps/IO/ImportBeatmapTest.cs
+++ b/osu.Game.Tests/Beatmaps/IO/ImportBeatmapTest.cs
@@ -17,12 +17,12 @@ using osu.Framework.Logging;
 using osu.Game.Beatmaps;
 using osu.Game.Database;
 using osu.Game.IO;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Osu.Objects;
 using osu.Game.Scoring;
 using osu.Game.Tests.Resources;
 using osu.Game.Tests.Scores.IO;
-using osu.Game.Users;
 using SharpCompress.Archives;
 using SharpCompress.Archives.Zip;
 using SharpCompress.Common;
@@ -859,7 +859,7 @@ namespace osu.Game.Tests.Beatmaps.IO
 
                     var manager = osu.Dependencies.Get<BeatmapManager>();
 
-                    var working = manager.CreateNew(new OsuRuleset().RulesetInfo, User.SYSTEM_USER);
+                    var working = manager.CreateNew(new OsuRuleset().RulesetInfo, APIUser.SYSTEM_USER);
 
                     var beatmap = working.Beatmap;
 
@@ -892,7 +892,7 @@ namespace osu.Game.Tests.Beatmaps.IO
                     var osu = LoadOsuIntoHost(host);
                     var manager = osu.Dependencies.Get<BeatmapManager>();
 
-                    var working = manager.CreateNew(new OsuRuleset().RulesetInfo, User.SYSTEM_USER);
+                    var working = manager.CreateNew(new OsuRuleset().RulesetInfo, APIUser.SYSTEM_USER);
 
                     manager.Save(working.BeatmapInfo, working.Beatmap);
 
@@ -919,7 +919,7 @@ namespace osu.Game.Tests.Beatmaps.IO
                     var osu = LoadOsuIntoHost(host);
                     var manager = osu.Dependencies.Get<BeatmapManager>();
 
-                    var working = manager.CreateNew(new OsuRuleset().RulesetInfo, User.SYSTEM_USER);
+                    var working = manager.CreateNew(new OsuRuleset().RulesetInfo, APIUser.SYSTEM_USER);
 
                     ((Beatmap)working.Beatmap).HitObjects.Add(new HitCircle { StartTime = 5000 });
 
diff --git a/osu.Game.Tests/Beatmaps/ToStringFormattingTest.cs b/osu.Game.Tests/Beatmaps/ToStringFormattingTest.cs
index c477bbd9cf..da7f32a2d3 100644
--- a/osu.Game.Tests/Beatmaps/ToStringFormattingTest.cs
+++ b/osu.Game.Tests/Beatmaps/ToStringFormattingTest.cs
@@ -3,7 +3,7 @@
 
 using NUnit.Framework;
 using osu.Game.Beatmaps;
-using osu.Game.Users;
+using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Tests.Beatmaps
 {
@@ -34,7 +34,7 @@ namespace osu.Game.Tests.Beatmaps
                 {
                     Artist = "artist",
                     Title = "title",
-                    Author = new User { Username = "creator" }
+                    Author = new APIUser { Username = "creator" }
                 }
             };
 
@@ -50,7 +50,7 @@ namespace osu.Game.Tests.Beatmaps
                 {
                     Artist = "artist",
                     Title = "title",
-                    Author = new User { Username = "creator" }
+                    Author = new APIUser { Username = "creator" }
                 },
                 Version = "difficulty"
             };
diff --git a/osu.Game.Tests/Chat/TestSceneChannelManager.cs b/osu.Game.Tests/Chat/TestSceneChannelManager.cs
index 5e22101e5c..eaacc623c9 100644
--- a/osu.Game.Tests/Chat/TestSceneChannelManager.cs
+++ b/osu.Game.Tests/Chat/TestSceneChannelManager.cs
@@ -9,9 +9,9 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Testing;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Chat;
 using osu.Game.Tests.Visual;
-using osu.Game.Users;
 
 namespace osu.Game.Tests.Chat
 {
@@ -133,7 +133,7 @@ namespace osu.Game.Tests.Chat
             }
         }
 
-        private Channel createChannel(int id, ChannelType type) => new Channel(new User())
+        private Channel createChannel(int id, ChannelType type) => new Channel(new APIUser())
         {
             Id = id,
             Name = $"Channel {id}",
diff --git a/osu.Game.Tests/NonVisual/Multiplayer/StatefulMultiplayerClientTest.cs b/osu.Game.Tests/NonVisual/Multiplayer/StatefulMultiplayerClientTest.cs
index 8e2259bce8..abe5664737 100644
--- a/osu.Game.Tests/NonVisual/Multiplayer/StatefulMultiplayerClientTest.cs
+++ b/osu.Game.Tests/NonVisual/Multiplayer/StatefulMultiplayerClientTest.cs
@@ -6,10 +6,10 @@ using Humanizer;
 using NUnit.Framework;
 using osu.Framework.Extensions.ObjectExtensions;
 using osu.Framework.Testing;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Rooms;
 using osu.Game.Tests.Visual.Multiplayer;
-using osu.Game.Users;
 
 namespace osu.Game.Tests.NonVisual.Multiplayer
 {
@@ -21,7 +21,7 @@ namespace osu.Game.Tests.NonVisual.Multiplayer
         {
             int id = 2000;
 
-            AddRepeatStep("add some users", () => Client.AddUser(new User { Id = id++ }), 5);
+            AddRepeatStep("add some users", () => Client.AddUser(new APIUser { Id = id++ }), 5);
             checkPlayingUserCount(0);
 
             AddAssert("playlist item is available", () => Client.CurrentMatchPlayingItem.Value != null);
@@ -64,7 +64,7 @@ namespace osu.Game.Tests.NonVisual.Multiplayer
                     room.State = MultiplayerRoomState.Playing;
                     room.Users.Add(new MultiplayerRoomUser(PLAYER_1_ID)
                     {
-                        User = new User { Id = PLAYER_1_ID },
+                        User = new APIUser { Id = PLAYER_1_ID },
                         State = MultiplayerUserState.Playing
                     });
                 };
diff --git a/osu.Game.Tests/OnlinePlay/StatefulMultiplayerClientTest.cs b/osu.Game.Tests/OnlinePlay/StatefulMultiplayerClientTest.cs
index 82ce588c6f..5a621ecf84 100644
--- a/osu.Game.Tests/OnlinePlay/StatefulMultiplayerClientTest.cs
+++ b/osu.Game.Tests/OnlinePlay/StatefulMultiplayerClientTest.cs
@@ -3,8 +3,8 @@
 
 using NUnit.Framework;
 using osu.Framework.Testing;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Tests.Visual.Multiplayer;
-using osu.Game.Users;
 
 namespace osu.Game.Tests.OnlinePlay
 {
@@ -14,7 +14,7 @@ namespace osu.Game.Tests.OnlinePlay
         [Test]
         public void TestUserAddedOnJoin()
         {
-            var user = new User { Id = 33 };
+            var user = new APIUser { Id = 33 };
 
             AddRepeatStep("add user multiple times", () => Client.AddUser(user), 3);
             AddAssert("room has 2 users", () => Client.Room?.Users.Count == 2);
@@ -23,7 +23,7 @@ namespace osu.Game.Tests.OnlinePlay
         [Test]
         public void TestUserRemovedOnLeave()
         {
-            var user = new User { Id = 44 };
+            var user = new APIUser { Id = 44 };
 
             AddStep("add user", () => Client.AddUser(user));
             AddAssert("room has 2 users", () => Client.Room?.Users.Count == 2);
diff --git a/osu.Game.Tests/Scores/IO/ImportScoreTest.cs b/osu.Game.Tests/Scores/IO/ImportScoreTest.cs
index 2cd02329b7..be7803734e 100644
--- a/osu.Game.Tests/Scores/IO/ImportScoreTest.cs
+++ b/osu.Game.Tests/Scores/IO/ImportScoreTest.cs
@@ -11,12 +11,12 @@ using osu.Framework.Allocation;
 using osu.Framework.Platform;
 using osu.Game.Beatmaps;
 using osu.Game.IO.Archives;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Osu.Mods;
 using osu.Game.Rulesets.Scoring;
 using osu.Game.Scoring;
-using osu.Game.Users;
 
 namespace osu.Game.Tests.Scores.IO
 {
@@ -38,7 +38,7 @@ namespace osu.Game.Tests.Scores.IO
                         Accuracy = 0.8,
                         MaxCombo = 500,
                         Combo = 250,
-                        User = new User { Username = "Test user" },
+                        User = new APIUser { Username = "Test user" },
                         Date = DateTimeOffset.Now,
                         OnlineScoreID = 12345,
                     };
diff --git a/osu.Game.Tests/Visual/Background/TestSceneBackgroundScreenDefault.cs b/osu.Game.Tests/Visual/Background/TestSceneBackgroundScreenDefault.cs
index f7d42a2ee6..ec16578b71 100644
--- a/osu.Game.Tests/Visual/Background/TestSceneBackgroundScreenDefault.cs
+++ b/osu.Game.Tests/Visual/Background/TestSceneBackgroundScreenDefault.cs
@@ -10,10 +10,10 @@ using osu.Framework.Testing;
 using osu.Game.Configuration;
 using osu.Game.Graphics.Backgrounds;
 using osu.Game.Online.API;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Screens;
 using osu.Game.Screens.Backgrounds;
 using osu.Game.Skinning;
-using osu.Game.Users;
 
 namespace osu.Game.Tests.Visual.Background
 {
@@ -113,7 +113,7 @@ namespace osu.Game.Tests.Visual.Background
             AddStep($"set background mode to {source}", () => config.SetValue(OsuSetting.MenuBackgroundSource, source));
 
         private void setSupporter(bool isSupporter) =>
-            AddStep($"set supporter {isSupporter}", () => ((DummyAPIAccess)API).LocalUser.Value = new User
+            AddStep($"set supporter {isSupporter}", () => ((DummyAPIAccess)API).LocalUser.Value = new APIUser
             {
                 IsSupporter = isSupporter,
                 Id = API.LocalUser.Value.Id + 1,
diff --git a/osu.Game.Tests/Visual/Background/TestSceneUserDimBackgrounds.cs b/osu.Game.Tests/Visual/Background/TestSceneUserDimBackgrounds.cs
index 693c66ccb0..69ea1dc520 100644
--- a/osu.Game.Tests/Visual/Background/TestSceneUserDimBackgrounds.cs
+++ b/osu.Game.Tests/Visual/Background/TestSceneUserDimBackgrounds.cs
@@ -18,6 +18,7 @@ using osu.Game.Configuration;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Osu.Mods;
 using osu.Game.Scoring;
@@ -29,7 +30,6 @@ using osu.Game.Screens.Ranking;
 using osu.Game.Screens.Select;
 using osu.Game.Tests.Beatmaps;
 using osu.Game.Tests.Resources;
-using osu.Game.Users;
 using osuTK;
 using osuTK.Graphics;
 
@@ -231,7 +231,7 @@ namespace osu.Game.Tests.Visual.Background
 
             AddStep("Transition to Results", () => player.Push(results = new FadeAccessibleResults(new ScoreInfo
             {
-                User = new User { Username = "osu!" },
+                User = new APIUser { Username = "osu!" },
                 BeatmapInfo = new TestBeatmap(Ruleset.Value).BeatmapInfo,
                 Ruleset = Ruleset.Value,
             })));
diff --git a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs
index 2aeb4ab4e2..2f2594d5ed 100644
--- a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs
+++ b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs
@@ -13,8 +13,8 @@ using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.Drawables.Cards;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays;
-using osu.Game.Users;
 using osuTK;
+using APIUser = osu.Game.Online.API.Requests.Responses.APIUser;
 
 namespace osu.Game.Tests.Visual.Beatmaps
 {
@@ -75,7 +75,7 @@ namespace osu.Game.Tests.Visual.Beatmaps
             Title = "undownloadable beatmap",
             Artist = "test",
             Source = "more tests",
-            Author = new User
+            Author = new APIUser
             {
                 Username = "BanchoBot",
                 Id = 3,
@@ -120,7 +120,7 @@ namespace osu.Game.Tests.Visual.Beatmaps
                 OnlineID = 1,
                 Title = "many difficulties beatmap",
                 Artist = "test",
-                Author = new User
+                Author = new APIUser
                 {
                     Username = "BanchoBot",
                     Id = 3,
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneGameplayLeaderboard.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneGameplayLeaderboard.cs
index 0441c5641e..74212de210 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneGameplayLeaderboard.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneGameplayLeaderboard.cs
@@ -7,8 +7,8 @@ using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Testing;
 using osu.Framework.Utils;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Screens.Play.HUD;
-using osu.Game.Users;
 using osuTK;
 
 namespace osu.Game.Tests.Visual.Gameplay
@@ -39,7 +39,7 @@ namespace osu.Game.Tests.Visual.Gameplay
                 playerScore.Value = 1222333;
             });
 
-            AddStep("add local player", () => createLeaderboardScore(playerScore, new User { Username = "You", Id = 3 }, true));
+            AddStep("add local player", () => createLeaderboardScore(playerScore, new APIUser { Username = "You", Id = 3 }, true));
             AddStep("toggle expanded", () => leaderboard.Expanded.Value = !leaderboard.Expanded.Value);
             AddSliderStep("set player score", 50, 5000000, 1222333, v => playerScore.Value = v);
         }
@@ -50,8 +50,8 @@ namespace osu.Game.Tests.Visual.Gameplay
             var player2Score = new BindableDouble(1234567);
             var player3Score = new BindableDouble(1111111);
 
-            AddStep("add player 2", () => createLeaderboardScore(player2Score, new User { Username = "Player 2" }));
-            AddStep("add player 3", () => createLeaderboardScore(player3Score, new User { Username = "Player 3" }));
+            AddStep("add player 2", () => createLeaderboardScore(player2Score, new APIUser { Username = "Player 2" }));
+            AddStep("add player 3", () => createLeaderboardScore(player3Score, new APIUser { Username = "Player 3" }));
 
             AddUntilStep("is player 2 position #1", () => leaderboard.CheckPositionByUsername("Player 2", 1));
             AddUntilStep("is player position #2", () => leaderboard.CheckPositionByUsername("You", 2));
@@ -72,38 +72,38 @@ namespace osu.Game.Tests.Visual.Gameplay
         public void TestRandomScores()
         {
             int playerNumber = 1;
-            AddRepeatStep("add player with random score", () => createRandomScore(new User { Username = $"Player {playerNumber++}" }), 10);
+            AddRepeatStep("add player with random score", () => createRandomScore(new APIUser { Username = $"Player {playerNumber++}" }), 10);
         }
 
         [Test]
         public void TestExistingUsers()
         {
-            AddStep("add peppy", () => createRandomScore(new User { Username = "peppy", Id = 2 }));
-            AddStep("add smoogipoo", () => createRandomScore(new User { Username = "smoogipoo", Id = 1040328 }));
-            AddStep("add flyte", () => createRandomScore(new User { Username = "flyte", Id = 3103765 }));
-            AddStep("add frenzibyte", () => createRandomScore(new User { Username = "frenzibyte", Id = 14210502 }));
+            AddStep("add peppy", () => createRandomScore(new APIUser { Username = "peppy", Id = 2 }));
+            AddStep("add smoogipoo", () => createRandomScore(new APIUser { Username = "smoogipoo", Id = 1040328 }));
+            AddStep("add flyte", () => createRandomScore(new APIUser { Username = "flyte", Id = 3103765 }));
+            AddStep("add frenzibyte", () => createRandomScore(new APIUser { Username = "frenzibyte", Id = 14210502 }));
         }
 
         [Test]
         public void TestMaxHeight()
         {
             int playerNumber = 1;
-            AddRepeatStep("add 3 other players", () => createRandomScore(new User { Username = $"Player {playerNumber++}" }), 3);
+            AddRepeatStep("add 3 other players", () => createRandomScore(new APIUser { Username = $"Player {playerNumber++}" }), 3);
             checkHeight(4);
 
-            AddRepeatStep("add 4 other players", () => createRandomScore(new User { Username = $"Player {playerNumber++}" }), 4);
+            AddRepeatStep("add 4 other players", () => createRandomScore(new APIUser { Username = $"Player {playerNumber++}" }), 4);
             checkHeight(8);
 
-            AddRepeatStep("add 4 other players", () => createRandomScore(new User { Username = $"Player {playerNumber++}" }), 4);
+            AddRepeatStep("add 4 other players", () => createRandomScore(new APIUser { Username = $"Player {playerNumber++}" }), 4);
             checkHeight(8);
 
             void checkHeight(int panelCount)
                 => AddAssert($"leaderboard height is {panelCount} panels high", () => leaderboard.DrawHeight == (GameplayLeaderboardScore.PANEL_HEIGHT + leaderboard.Spacing) * panelCount);
         }
 
-        private void createRandomScore(User user) => createLeaderboardScore(new BindableDouble(RNG.Next(0, 5_000_000)), user);
+        private void createRandomScore(APIUser user) => createLeaderboardScore(new BindableDouble(RNG.Next(0, 5_000_000)), user);
 
-        private void createLeaderboardScore(BindableDouble score, User user, bool isTracked = false)
+        private void createLeaderboardScore(BindableDouble score, APIUser user, bool isTracked = false)
         {
             var leaderboardScore = leaderboard.Add(user, isTracked);
             leaderboardScore.TotalScore.BindTo(score);
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneReplayDownloadButton.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneReplayDownloadButton.cs
index 64d9addc77..c4a99eeb6c 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneReplayDownloadButton.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneReplayDownloadButton.cs
@@ -7,7 +7,6 @@ using osu.Framework.Graphics;
 using osu.Game.Online;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Scoring;
-using osu.Game.Users;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Testing;
@@ -16,6 +15,7 @@ using osu.Game.Rulesets;
 using osu.Game.Rulesets.Osu;
 using osu.Game.Screens.Ranking;
 using osuTK.Input;
+using APIUser = osu.Game.Online.API.Requests.Responses.APIUser;
 
 namespace osu.Game.Tests.Visual.Gameplay
 {
@@ -139,7 +139,7 @@ namespace osu.Game.Tests.Visual.Gameplay
                 RulesetID = 0,
                 Beatmap = CreateAPIBeatmapSet(new OsuRuleset().RulesetInfo).Beatmaps.First(),
                 HasReplay = replayAvailable,
-                User = new User
+                User = new APIUser
                 {
                     Id = 39828,
                     Username = @"WubWoofWolf",
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs
index 21c5d89aca..20e859dd2b 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs
@@ -9,6 +9,7 @@ using osu.Framework.Screens;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
 using osu.Game.Database;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Spectator;
 using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Osu.Replays;
@@ -18,13 +19,12 @@ using osu.Game.Screens.Play;
 using osu.Game.Tests.Beatmaps.IO;
 using osu.Game.Tests.Visual.Multiplayer;
 using osu.Game.Tests.Visual.Spectator;
-using osu.Game.Users;
 
 namespace osu.Game.Tests.Visual.Gameplay
 {
     public class TestSceneSpectator : ScreenTestScene
     {
-        private readonly User streamingUser = new User { Id = MultiplayerTestScene.PLAYER_1_ID, Username = "Test user" };
+        private readonly APIUser streamingUser = new APIUser { Id = MultiplayerTestScene.PLAYER_1_ID, Username = "Test user" };
 
         [Cached(typeof(UserLookupCache))]
         private UserLookupCache lookupCache = new TestUserLookupCache();
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorHost.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorHost.cs
index 89fea1f92d..2a82c65c7c 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorHost.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorHost.cs
@@ -4,11 +4,11 @@
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Game.Online.API;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Spectator;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Mania;
 using osu.Game.Tests.Visual.Spectator;
-using osu.Game.Users;
 
 namespace osu.Game.Tests.Visual.Gameplay
 {
@@ -24,7 +24,7 @@ namespace osu.Game.Tests.Visual.Gameplay
 
         public override void SetUpSteps()
         {
-            AddStep("set dummy user", () => dummyAPIAccess.LocalUser.Value = new User
+            AddStep("set dummy user", () => dummyAPIAccess.LocalUser.Value = new APIUser
             {
                 Id = dummy_user_id,
                 Username = "DummyUser"
diff --git a/osu.Game.Tests/Visual/Menus/TestSceneDisclaimer.cs b/osu.Game.Tests/Visual/Menus/TestSceneDisclaimer.cs
index 9cbdee3632..db5891bd4e 100644
--- a/osu.Game.Tests/Visual/Menus/TestSceneDisclaimer.cs
+++ b/osu.Game.Tests/Visual/Menus/TestSceneDisclaimer.cs
@@ -3,8 +3,8 @@
 
 using osu.Framework.Allocation;
 using osu.Game.Online.API;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Screens.Menu;
-using osu.Game.Users;
 
 namespace osu.Game.Tests.Visual.Menus
 {
@@ -17,7 +17,7 @@ namespace osu.Game.Tests.Visual.Menus
 
             AddStep("toggle support", () =>
             {
-                ((DummyAPIAccess)API).LocalUser.Value = new User
+                ((DummyAPIAccess)API).LocalUser.Value = new APIUser
                 {
                     Username = API.LocalUser.Value.Username,
                     Id = API.LocalUser.Value.Id + 1,
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoom.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoom.cs
index 84a6e95883..721862c177 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoom.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoom.cs
@@ -10,6 +10,7 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Testing;
 using osu.Framework.Utils;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Rooms;
 using osu.Game.Online.Rooms.RoomStatuses;
 using osu.Game.Overlays;
@@ -17,7 +18,6 @@ using osu.Game.Rulesets.Osu;
 using osu.Game.Screens.OnlinePlay.Lounge;
 using osu.Game.Screens.OnlinePlay.Lounge.Components;
 using osu.Game.Tests.Beatmaps;
-using osu.Game.Users;
 using osuTK;
 
 namespace osu.Game.Tests.Visual.Multiplayer
@@ -174,11 +174,11 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
         private DrawableRoom createLoungeRoom(Room room)
         {
-            room.Host.Value ??= new User { Username = "peppy", Id = 2 };
+            room.Host.Value ??= new APIUser { Username = "peppy", Id = 2 };
 
             if (room.RecentParticipants.Count == 0)
             {
-                room.RecentParticipants.AddRange(Enumerable.Range(0, 20).Select(i => new User
+                room.RecentParticipants.AddRange(Enumerable.Range(0, 20).Select(i => new APIUser
                 {
                     Id = i,
                     Username = $"User {i}"
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomParticipantsList.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomParticipantsList.cs
index 982dfc5cd9..60f47a01a9 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomParticipantsList.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomParticipantsList.cs
@@ -5,10 +5,10 @@ using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Graphics;
 using osu.Framework.Testing;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Rooms;
 using osu.Game.Screens.OnlinePlay.Lounge.Components;
 using osu.Game.Tests.Visual.OnlinePlay;
-using osu.Game.Users;
 using osu.Game.Users.Drawables;
 
 namespace osu.Game.Tests.Visual.Multiplayer
@@ -25,7 +25,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 Name = { Value = "test room" },
                 Host =
                 {
-                    Value = new User
+                    Value = new APIUser
                     {
                         Id = 2,
                         Username = "peppy",
@@ -137,7 +137,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
         private void addUser(int id)
         {
-            SelectedRoom.Value.RecentParticipants.Add(new User
+            SelectedRoom.Value.RecentParticipants.Add(new APIUser
             {
                 Id = id,
                 Username = $"User {id}"
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
index afd48d5191..8ac0a2cbe5 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
@@ -14,6 +14,7 @@ using osu.Framework.Testing;
 using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.Drawables;
 using osu.Game.Graphics.Containers;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Rooms;
 using osu.Game.Overlays.BeatmapListing.Panels;
 using osu.Game.Rulesets;
@@ -21,7 +22,6 @@ using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Osu.Mods;
 using osu.Game.Screens.OnlinePlay;
 using osu.Game.Tests.Beatmaps;
-using osu.Game.Users;
 using osuTK;
 using osuTK.Input;
 
@@ -294,7 +294,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                                     Metadata = new BeatmapMetadata
                                     {
                                         Artist = "Artist",
-                                        Author = new User { Username = "Creator name here" },
+                                        Author = new APIUser { Username = "Creator name here" },
                                         Title = "Long title used to check background colour",
                                     },
                                     BeatmapSet = new BeatmapSetInfo()
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchLeaderboard.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchLeaderboard.cs
index a7a5f3af39..955710bd50 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchLeaderboard.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchLeaderboard.cs
@@ -10,8 +10,8 @@ using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Rooms;
 using osu.Game.Screens.OnlinePlay.Match.Components;
 using osu.Game.Tests.Visual.OnlinePlay;
-using osu.Game.Users;
 using osuTK;
+using APIUser = osu.Game.Online.API.Requests.Responses.APIUser;
 
 namespace osu.Game.Tests.Visual.Multiplayer
 {
@@ -32,7 +32,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                                 new APIUserScoreAggregate
                                 {
                                     UserID = 2,
-                                    User = new User { Id = 2, Username = "peppy" },
+                                    User = new APIUser { Id = 2, Username = "peppy" },
                                     TotalScore = 995533,
                                     RoomID = 3,
                                     CompletedBeatmaps = 1,
@@ -42,7 +42,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                                 new APIUserScoreAggregate
                                 {
                                     UserID = 1040328,
-                                    User = new User { Id = 1040328, Username = "smoogipoo" },
+                                    User = new APIUser { Id = 1040328, Username = "smoogipoo" },
                                     TotalScore = 981100,
                                     RoomID = 3,
                                     CompletedBeatmaps = 1,
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorLeaderboard.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorLeaderboard.cs
index bd5320354e..a61e505970 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorLeaderboard.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorLeaderboard.cs
@@ -6,11 +6,11 @@ using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Testing;
 using osu.Framework.Timing;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Rulesets.Osu.Scoring;
 using osu.Game.Screens.OnlinePlay.Multiplayer.Spectate;
 using osu.Game.Screens.Play.HUD;
-using osu.Game.Users;
 
 namespace osu.Game.Tests.Visual.Multiplayer
 {
@@ -35,7 +35,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 foreach ((int userId, var _) in clocks)
                 {
                     SpectatorClient.StartPlay(userId, 0);
-                    OnlinePlayDependencies.Client.AddUser(new User { Id = userId });
+                    OnlinePlayDependencies.Client.AddUser(new APIUser { Id = userId });
                 }
             });
 
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs
index 7ff8c82145..fdd01446b9 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs
@@ -11,6 +11,7 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
 using osu.Game.Configuration;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Multiplayer.MatchTypes.TeamVersus;
 using osu.Game.Rulesets.UI;
@@ -19,7 +20,6 @@ using osu.Game.Screens.Play;
 using osu.Game.Screens.Play.HUD;
 using osu.Game.Screens.Play.PlayerSettings;
 using osu.Game.Tests.Beatmaps.IO;
-using osu.Game.Users;
 using osuTK.Graphics;
 
 namespace osu.Game.Tests.Visual.Multiplayer
@@ -59,8 +59,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             AddStep("start players silently", () =>
             {
-                OnlinePlayDependencies.Client.AddUser(new User { Id = PLAYER_1_ID }, true);
-                OnlinePlayDependencies.Client.AddUser(new User { Id = PLAYER_2_ID }, true);
+                OnlinePlayDependencies.Client.AddUser(new APIUser { Id = PLAYER_1_ID }, true);
+                OnlinePlayDependencies.Client.AddUser(new APIUser { Id = PLAYER_2_ID }, true);
 
                 playingUsers.Add(new MultiplayerRoomUser(PLAYER_1_ID));
                 playingUsers.Add(new MultiplayerRoomUser(PLAYER_2_ID));
@@ -120,13 +120,13 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             AddStep("start players", () =>
             {
-                var player1 = OnlinePlayDependencies.Client.AddUser(new User { Id = PLAYER_1_ID }, true);
+                var player1 = OnlinePlayDependencies.Client.AddUser(new APIUser { Id = PLAYER_1_ID }, true);
                 player1.MatchState = new TeamVersusUserState
                 {
                     TeamID = 0,
                 };
 
-                var player2 = OnlinePlayDependencies.Client.AddUser(new User { Id = PLAYER_2_ID }, true);
+                var player2 = OnlinePlayDependencies.Client.AddUser(new APIUser { Id = PLAYER_2_ID }, true);
                 player2.MatchState = new TeamVersusUserState
                 {
                     TeamID = 1,
@@ -367,7 +367,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 {
                     var user = new MultiplayerRoomUser(id)
                     {
-                        User = new User { Id = id },
+                        User = new APIUser { Id = id },
                     };
 
                     OnlinePlayDependencies.Client.AddUser(user.User, true);
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
index 38cf9d662f..e831d5b564 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
@@ -17,6 +17,7 @@ using osu.Framework.Utils;
 using osu.Game.Beatmaps;
 using osu.Game.Database;
 using osu.Game.Graphics.UserInterface;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Rooms;
 using osu.Game.Overlays.Mods;
@@ -32,7 +33,6 @@ using osu.Game.Screens.Play;
 using osu.Game.Screens.Ranking;
 using osu.Game.Screens.Spectate;
 using osu.Game.Tests.Resources;
-using osu.Game.Users;
 using osuTK.Input;
 
 namespace osu.Game.Tests.Visual.Multiplayer
@@ -129,12 +129,12 @@ namespace osu.Game.Tests.Visual.Multiplayer
         private void addRandomPlayer()
         {
             int randomUser = RNG.Next(200000, 500000);
-            client.AddUser(new User { Id = randomUser, Username = $"user {randomUser}" });
+            client.AddUser(new APIUser { Id = randomUser, Username = $"user {randomUser}" });
         }
 
         private void removeLastUser()
         {
-            User lastUser = client.Room?.Users.Last().User;
+            APIUser lastUser = client.Room?.Users.Last().User;
 
             if (lastUser == null || lastUser == client.LocalUser?.User)
                 return;
@@ -144,7 +144,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
         private void kickLastUser()
         {
-            User lastUser = client.Room?.Users.Last().User;
+            APIUser lastUser = client.Room?.Users.Last().User;
 
             if (lastUser == null || lastUser == client.LocalUser?.User)
                 return;
@@ -414,7 +414,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             AddStep("join other user (ready, host)", () =>
             {
-                client.AddUser(new User { Id = MultiplayerTestScene.PLAYER_1_ID, Username = "Other" });
+                client.AddUser(new APIUser { Id = MultiplayerTestScene.PLAYER_1_ID, Username = "Other" });
                 client.TransferHost(MultiplayerTestScene.PLAYER_1_ID);
                 client.ChangeUserState(MultiplayerTestScene.PLAYER_1_ID, MultiplayerUserState.Ready);
             });
@@ -454,7 +454,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             AddStep("join other user (ready, host)", () =>
             {
-                client.AddUser(new User { Id = MultiplayerTestScene.PLAYER_1_ID, Username = "Other" });
+                client.AddUser(new APIUser { Id = MultiplayerTestScene.PLAYER_1_ID, Username = "Other" });
                 client.TransferHost(MultiplayerTestScene.PLAYER_1_ID);
                 client.ChangeUserState(MultiplayerTestScene.PLAYER_1_ID, MultiplayerUserState.Ready);
             });
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs
index 832998d5d3..902629765f 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs
@@ -11,6 +11,7 @@ using osu.Framework.Graphics;
 using osu.Framework.Utils;
 using osu.Game.Configuration;
 using osu.Game.Online.API;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Spectator;
 using osu.Game.Replays.Legacy;
@@ -20,7 +21,6 @@ using osu.Game.Scoring;
 using osu.Game.Screens.Play.HUD;
 using osu.Game.Tests.Visual.OnlinePlay;
 using osu.Game.Tests.Visual.Spectator;
-using osu.Game.Users;
 
 namespace osu.Game.Tests.Visual.Multiplayer
 {
@@ -58,7 +58,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 foreach (int user in users)
                 {
                     SpectatorClient.StartPlay(user, Beatmap.Value.BeatmapInfo.OnlineBeatmapID ?? 0);
-                    multiplayerUsers.Add(OnlinePlayDependencies.Client.AddUser(new User { Id = user }, true));
+                    multiplayerUsers.Add(OnlinePlayDependencies.Client.AddUser(new APIUser { Id = user }, true));
                 }
 
                 Children = new Drawable[]
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboardTeams.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboardTeams.cs
index 3d48ddc7ca..af4e696fce 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboardTeams.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboardTeams.cs
@@ -7,6 +7,7 @@ using NUnit.Framework;
 using osu.Framework.Graphics;
 using osu.Framework.Utils;
 using osu.Game.Online.API;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Multiplayer.MatchTypes.TeamVersus;
 using osu.Game.Online.Rooms;
@@ -15,7 +16,6 @@ using osu.Game.Screens.OnlinePlay.Multiplayer;
 using osu.Game.Screens.Play.HUD;
 using osu.Game.Tests.Visual.OnlinePlay;
 using osu.Game.Tests.Visual.Spectator;
-using osu.Game.Users;
 
 namespace osu.Game.Tests.Visual.Multiplayer
 {
@@ -62,7 +62,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 foreach (int user in users)
                 {
                     SpectatorClient.StartPlay(user, Beatmap.Value.BeatmapInfo.OnlineBeatmapID ?? 0);
-                    var roomUser = OnlinePlayDependencies.Client.AddUser(new User { Id = user }, true);
+                    var roomUser = OnlinePlayDependencies.Client.AddUser(new APIUser { Id = user }, true);
 
                     roomUser.MatchState = new TeamVersusUserState
                     {
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs
index 21364fe154..bb5735a3b5 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs
@@ -9,6 +9,7 @@ using osu.Framework.Platform;
 using osu.Framework.Screens;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Rooms;
 using osu.Game.Rulesets;
@@ -18,7 +19,6 @@ using osu.Game.Screens.OnlinePlay.Multiplayer;
 using osu.Game.Screens.OnlinePlay.Multiplayer.Match;
 using osu.Game.Tests.Beatmaps;
 using osu.Game.Tests.Resources;
-using osu.Game.Users;
 using osuTK.Input;
 
 namespace osu.Game.Tests.Visual.Multiplayer
@@ -119,7 +119,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             AddStep("join other user (ready)", () =>
             {
-                Client.AddUser(new User { Id = PLAYER_1_ID });
+                Client.AddUser(new APIUser { Id = PLAYER_1_ID });
                 Client.ChangeUserState(PLAYER_1_ID, MultiplayerUserState.Ready);
             });
 
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerParticipantsList.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerParticipantsList.cs
index 2549681519..671b85164b 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerParticipantsList.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerParticipantsList.cs
@@ -11,6 +11,7 @@ using osu.Framework.Testing;
 using osu.Framework.Utils;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Online;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Rooms;
 using osu.Game.Rulesets.Mods;
@@ -34,7 +35,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             AddAssert("one unique panel", () => this.ChildrenOfType<ParticipantPanel>().Select(p => p.User).Distinct().Count() == 1);
 
-            AddStep("add user", () => Client.AddUser(new User
+            AddStep("add user", () => Client.AddUser(new APIUser
             {
                 Id = 3,
                 Username = "Second",
@@ -63,11 +64,11 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [Test]
         public void TestRemoveUser()
         {
-            User secondUser = null;
+            APIUser secondUser = null;
 
             AddStep("add a user", () =>
             {
-                Client.AddUser(secondUser = new User
+                Client.AddUser(secondUser = new APIUser
                 {
                     Id = 3,
                     Username = "Second",
@@ -146,7 +147,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [Test]
         public void TestCrownChangesStateWhenHostTransferred()
         {
-            AddStep("add user", () => Client.AddUser(new User
+            AddStep("add user", () => Client.AddUser(new APIUser
             {
                 Id = 3,
                 Username = "Second",
@@ -165,7 +166,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [Test]
         public void TestKickButtonOnlyPresentWhenHost()
         {
-            AddStep("add user", () => Client.AddUser(new User
+            AddStep("add user", () => Client.AddUser(new APIUser
             {
                 Id = 3,
                 Username = "Second",
@@ -186,7 +187,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [Test]
         public void TestKickButtonKicks()
         {
-            AddStep("add user", () => Client.AddUser(new User
+            AddStep("add user", () => Client.AddUser(new APIUser
             {
                 Id = 3,
                 Username = "Second",
@@ -205,7 +206,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             {
                 for (int i = 0; i < 20; i++)
                 {
-                    Client.AddUser(new User
+                    Client.AddUser(new APIUser
                     {
                         Id = i,
                         Username = $"User {i}",
@@ -249,7 +250,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             AddStep("add user", () =>
             {
-                Client.AddUser(new User
+                Client.AddUser(new APIUser
                 {
                     Id = 0,
                     Username = "User 0",
@@ -295,7 +296,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             AddStep("add user with mods", () =>
             {
-                Client.AddUser(new User
+                Client.AddUser(new APIUser
                 {
                     Id = 0,
                     Username = "Baka",
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs
index 820b403a10..e9612bf55c 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs
@@ -14,12 +14,12 @@ using osu.Framework.Testing;
 using osu.Framework.Utils;
 using osu.Game.Beatmaps;
 using osu.Game.Graphics.UserInterface;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Rooms;
 using osu.Game.Rulesets;
 using osu.Game.Screens.OnlinePlay.Multiplayer.Match;
 using osu.Game.Tests.Resources;
-using osu.Game.Users;
 using osuTK;
 using osuTK.Input;
 
@@ -108,7 +108,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             AddStep("add second user as host", () =>
             {
-                Client.AddUser(new User { Id = 2, Username = "Another user" });
+                Client.AddUser(new APIUser { Id = 2, Username = "Another user" });
                 Client.TransferHost(2);
             });
 
@@ -128,7 +128,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 Client.TransferHost(Client.Room?.Users[0].UserID ?? 0);
 
                 if (!allReady)
-                    Client.AddUser(new User { Id = 2, Username = "Another user" });
+                    Client.AddUser(new APIUser { Id = 2, Username = "Another user" });
             });
 
             addClickButtonStep();
@@ -142,7 +142,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             AddStep("add host", () =>
             {
-                Client.AddUser(new User { Id = 2, Username = "Another user" });
+                Client.AddUser(new APIUser { Id = 2, Username = "Another user" });
                 Client.TransferHost(2);
             });
 
@@ -158,7 +158,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddStep("setup", () =>
             {
                 Client.TransferHost(Client.Room?.Users[0].UserID ?? 0);
-                Client.AddUser(new User { Id = 2, Username = "Another user" });
+                Client.AddUser(new APIUser { Id = 2, Username = "Another user" });
             });
 
             addClickButtonStep();
@@ -177,7 +177,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             {
                 Client.TransferHost(Client.Room?.Users[0].UserID ?? 0);
                 for (int i = 0; i < users; i++)
-                    Client.AddUser(new User { Id = i, Username = "Another user" });
+                    Client.AddUser(new APIUser { Id = i, Username = "Another user" });
             });
 
             if (!isHost)
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerResults.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerResults.cs
index 5032cdaec7..c0b21c4421 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerResults.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerResults.cs
@@ -3,11 +3,11 @@
 
 using System;
 using NUnit.Framework;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Rooms;
 using osu.Game.Rulesets.Osu;
 using osu.Game.Scoring;
 using osu.Game.Screens.OnlinePlay.Multiplayer;
-using osu.Game.Users;
 
 namespace osu.Game.Tests.Visual.Multiplayer
 {
@@ -31,7 +31,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     MaxCombo = 500,
                     Combo = 250,
                     BeatmapInfo = beatmapInfo,
-                    User = new User { Username = "Test user" },
+                    User = new APIUser { Username = "Test user" },
                     Date = DateTimeOffset.Now,
                     OnlineScoreID = 12345,
                     Ruleset = rulesetInfo,
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerSpectateButton.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerSpectateButton.cs
index 3d08d5da9e..76c8de93c7 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerSpectateButton.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerSpectateButton.cs
@@ -14,12 +14,12 @@ using osu.Framework.Platform;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
 using osu.Game.Graphics.UserInterface;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Rooms;
 using osu.Game.Rulesets;
 using osu.Game.Screens.OnlinePlay.Multiplayer.Match;
 using osu.Game.Tests.Resources;
-using osu.Game.Users;
 using osuTK;
 using osuTK.Input;
 
@@ -145,7 +145,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [Test]
         public void TestReadyButtonEnabledWhenHostAndUsersReady()
         {
-            AddStep("add user", () => Client.AddUser(new User { Id = PLAYER_1_ID }));
+            AddStep("add user", () => Client.AddUser(new APIUser { Id = PLAYER_1_ID }));
             AddStep("set user ready", () => Client.ChangeUserState(PLAYER_1_ID, MultiplayerUserState.Ready));
 
             addClickSpectateButtonStep();
@@ -157,7 +157,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             AddStep("add user and transfer host", () =>
             {
-                Client.AddUser(new User { Id = PLAYER_1_ID });
+                Client.AddUser(new APIUser { Id = PLAYER_1_ID });
                 Client.TransferHost(PLAYER_1_ID);
             });
 
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerTeamResults.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerTeamResults.cs
index 99d5fd46e9..d391c39c89 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerTeamResults.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerTeamResults.cs
@@ -5,11 +5,11 @@ using System;
 using System.Collections.Generic;
 using NUnit.Framework;
 using osu.Framework.Bindables;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Rooms;
 using osu.Game.Rulesets.Osu;
 using osu.Game.Scoring;
 using osu.Game.Screens.OnlinePlay.Multiplayer;
-using osu.Game.Users;
 
 namespace osu.Game.Tests.Visual.Multiplayer
 {
@@ -35,7 +35,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     MaxCombo = 500,
                     Combo = 250,
                     BeatmapInfo = beatmapInfo,
-                    User = new User { Username = "Test user" },
+                    User = new APIUser { Username = "Test user" },
                     Date = DateTimeOffset.Now,
                     OnlineScoreID = 12345,
                     Ruleset = rulesetInfo,
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneRankRangePill.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneRankRangePill.cs
index 9e03743e8d..823ac07cf7 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneRankRangePill.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneRankRangePill.cs
@@ -3,8 +3,8 @@
 
 using NUnit.Framework;
 using osu.Framework.Graphics;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Screens.OnlinePlay.Lounge.Components;
-using osu.Game.Users;
 
 namespace osu.Game.Tests.Visual.Multiplayer
 {
@@ -25,7 +25,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             AddStep("add user", () =>
             {
-                Client.AddUser(new User
+                Client.AddUser(new APIUser
                 {
                     Id = 2,
                     Statistics = { GlobalRank = 1234 }
@@ -41,19 +41,19 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             AddStep("add users", () =>
             {
-                Client.AddUser(new User
+                Client.AddUser(new APIUser
                 {
                     Id = 2,
                     Statistics = { GlobalRank = 1234 }
                 });
 
-                Client.AddUser(new User
+                Client.AddUser(new APIUser
                 {
                     Id = 3,
                     Statistics = { GlobalRank = 3333 }
                 });
 
-                Client.AddUser(new User
+                Client.AddUser(new APIUser
                 {
                     Id = 4,
                     Statistics = { GlobalRank = 4321 }
@@ -75,13 +75,13 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             AddStep("add users", () =>
             {
-                Client.AddUser(new User
+                Client.AddUser(new APIUser
                 {
                     Id = 2,
                     Statistics = { GlobalRank = min }
                 });
 
-                Client.AddUser(new User
+                Client.AddUser(new APIUser
                 {
                     Id = 3,
                     Statistics = { GlobalRank = max }
diff --git a/osu.Game.Tests/Visual/Online/TestSceneAccountCreationOverlay.cs b/osu.Game.Tests/Visual/Online/TestSceneAccountCreationOverlay.cs
index 06cc613c17..8f0da8d182 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneAccountCreationOverlay.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneAccountCreationOverlay.cs
@@ -8,6 +8,7 @@ using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Testing;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays;
 using osu.Game.Overlays.AccountCreation;
 using osu.Game.Overlays.Settings;
@@ -20,7 +21,7 @@ namespace osu.Game.Tests.Visual.Online
         private readonly Container userPanelArea;
         private readonly AccountCreationOverlay accountCreation;
 
-        private IBindable<User> localUser;
+        private IBindable<APIUser> localUser;
 
         public TestSceneAccountCreationOverlay()
         {
diff --git a/osu.Game.Tests/Visual/Online/TestSceneBeatmapListingOverlay.cs b/osu.Game.Tests/Visual/Online/TestSceneBeatmapListingOverlay.cs
index c7a065fdd7..cbb6dce4d6 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneBeatmapListingOverlay.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneBeatmapListingOverlay.cs
@@ -14,8 +14,8 @@ using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays;
 using osu.Game.Overlays.BeatmapListing;
 using osu.Game.Scoring;
-using osu.Game.Users;
 using osuTK.Input;
+using APIUser = osu.Game.Online.API.Requests.Responses.APIUser;
 
 namespace osu.Game.Tests.Visual.Online
 {
@@ -53,7 +53,7 @@ namespace osu.Game.Tests.Visual.Online
                 };
 
                 // non-supporter user
-                api.LocalUser.Value = new User
+                api.LocalUser.Value = new APIUser
                 {
                     Username = "TestBot",
                     Id = API.LocalUser.Value.Id + 1,
diff --git a/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlay.cs b/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlay.cs
index 63ce057667..86863c0b5d 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlay.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlay.cs
@@ -7,11 +7,11 @@ using osu.Game.Beatmaps;
 using osu.Game.Overlays;
 using osu.Game.Overlays.BeatmapSet;
 using osu.Game.Rulesets;
-using osu.Game.Users;
 using System;
 using System.Collections.Generic;
 using System.Linq;
 using osu.Game.Online.API.Requests.Responses;
+using APIUser = osu.Game.Online.API.Requests.Responses.APIUser;
 
 namespace osu.Game.Tests.Visual.Online
 {
@@ -56,7 +56,7 @@ namespace osu.Game.Tests.Visual.Online
                     Artist = @"naru narusegawa",
                     Source = @"hinata sou",
                     Tags = @"test tag tag more tag",
-                    Author = new User
+                    Author = new APIUser
                     {
                         Username = @"BanchoBot",
                         Id = 3,
diff --git a/osu.Game.Tests/Visual/Online/TestSceneChannelTabControl.cs b/osu.Game.Tests/Visual/Online/TestSceneChannelTabControl.cs
index 73e1fc9b35..e6eaffc4c1 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneChannelTabControl.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneChannelTabControl.cs
@@ -11,9 +11,9 @@ using osu.Framework.Graphics.Shapes;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Utils;
 using osu.Game.Graphics.Sprites;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Chat;
 using osu.Game.Overlays.Chat.Tabs;
-using osu.Game.Users;
 using osuTK.Graphics;
 
 namespace osu.Game.Tests.Visual.Online
@@ -108,7 +108,7 @@ namespace osu.Game.Tests.Visual.Online
         }
 
         private void addRandomPrivateChannel() =>
-            channelTabControl.AddChannel(new Channel(new User
+            channelTabControl.AddChannel(new Channel(new APIUser
             {
                 Id = RNG.Next(1000, 10000000),
                 Username = "Test User " + RNG.Next(1000)
diff --git a/osu.Game.Tests/Visual/Online/TestSceneChatLineTruncation.cs b/osu.Game.Tests/Visual/Online/TestSceneChatLineTruncation.cs
index 8408b7dd60..444bd7e5fb 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneChatLineTruncation.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneChatLineTruncation.cs
@@ -6,9 +6,9 @@ using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Chat;
 using osu.Game.Overlays.Chat;
-using osu.Game.Users;
 
 namespace osu.Game.Tests.Visual.Online
 {
@@ -55,14 +55,14 @@ namespace osu.Game.Tests.Visual.Online
         {
             private static long messageCounter;
 
-            internal static readonly User TEST_SENDER_BACKGROUND = new User
+            internal static readonly APIUser TEST_SENDER_BACKGROUND = new APIUser
             {
                 Username = @"i-am-important",
                 Id = 42,
                 Colour = "#250cc9",
             };
 
-            internal static readonly User TEST_SENDER = new User
+            internal static readonly APIUser TEST_SENDER = new APIUser
             {
                 Username = @"Somebody",
                 Id = 1,
@@ -75,7 +75,7 @@ namespace osu.Game.Tests.Visual.Online
             {
                 Content = text;
                 IsAction = isAction;
-                Sender = new User
+                Sender = new APIUser
                 {
                     Username = username ?? $"user {number}",
                     Id = number,
diff --git a/osu.Game.Tests/Visual/Online/TestSceneChatLink.cs b/osu.Game.Tests/Visual/Online/TestSceneChatLink.cs
index 74f53ebdca..a03c00eb58 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneChatLink.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneChatLink.cs
@@ -10,10 +10,10 @@ using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Graphics;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Chat;
 using osu.Game.Overlays;
 using osu.Game.Overlays.Chat;
-using osu.Game.Users;
 using osuTK.Graphics;
 
 namespace osu.Game.Tests.Visual.Online
@@ -168,14 +168,14 @@ namespace osu.Game.Tests.Visual.Online
         {
             private static long messageCounter;
 
-            internal static readonly User TEST_SENDER_BACKGROUND = new User
+            internal static readonly APIUser TEST_SENDER_BACKGROUND = new APIUser
             {
                 Username = @"i-am-important",
                 Id = 42,
                 Colour = "#250cc9",
             };
 
-            internal static readonly User TEST_SENDER = new User
+            internal static readonly APIUser TEST_SENDER = new APIUser
             {
                 Username = @"Somebody",
                 Id = 1,
@@ -188,7 +188,7 @@ namespace osu.Game.Tests.Visual.Online
             {
                 Content = text;
                 IsAction = isAction;
-                Sender = new User
+                Sender = new APIUser
                 {
                     Username = $"User {number}",
                     Id = number,
diff --git a/osu.Game.Tests/Visual/Online/TestSceneChatOverlay.cs b/osu.Game.Tests/Visual/Online/TestSceneChatOverlay.cs
index 99c3b398ab..7028ecf39f 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneChatOverlay.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneChatOverlay.cs
@@ -18,12 +18,12 @@ using osu.Framework.Testing;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Chat;
 using osu.Game.Overlays;
 using osu.Game.Overlays.Chat;
 using osu.Game.Overlays.Chat.Selection;
 using osu.Game.Overlays.Chat.Tabs;
-using osu.Game.Users;
 using osuTK.Input;
 
 namespace osu.Game.Tests.Visual.Online
@@ -53,7 +53,7 @@ namespace osu.Game.Tests.Visual.Online
         public TestSceneChatOverlay()
         {
             channels = Enumerable.Range(1, 10)
-                                 .Select(index => new Channel(new User())
+                                 .Select(index => new Channel(new APIUser())
                                  {
                                      Name = $"Channel no. {index}",
                                      Topic = index == 3 ? null : $"We talk about the number {index} here",
@@ -98,7 +98,7 @@ namespace osu.Game.Tests.Visual.Online
                         case GetUserRequest getUser:
                             if (getUser.Lookup.Equals("some body", StringComparison.OrdinalIgnoreCase))
                             {
-                                getUser.TriggerSuccess(new User
+                                getUser.TriggerSuccess(new APIUser
                                 {
                                     Username = "some body",
                                     Id = 1,
@@ -149,7 +149,7 @@ namespace osu.Game.Tests.Visual.Online
                         {
                             ChannelId = channel1.Id,
                             Content = "hello from channel 1!",
-                            Sender = new User
+                            Sender = new APIUser
                             {
                                 Id = 2,
                                 Username = "test_user"
diff --git a/osu.Game.Tests/Visual/Online/TestSceneCurrentlyPlayingDisplay.cs b/osu.Game.Tests/Visual/Online/TestSceneCurrentlyPlayingDisplay.cs
index 2f11fec6d1..b5a03b558d 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneCurrentlyPlayingDisplay.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneCurrentlyPlayingDisplay.cs
@@ -9,6 +9,7 @@ using NUnit.Framework;
 using osu.Framework.Graphics;
 using osu.Framework.Testing;
 using osu.Game.Database;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Spectator;
 using osu.Game.Overlays.Dashboard;
 using osu.Game.Tests.Visual.Spectator;
@@ -18,7 +19,7 @@ namespace osu.Game.Tests.Visual.Online
 {
     public class TestSceneCurrentlyPlayingDisplay : OsuTestScene
     {
-        private readonly User streamingUser = new User { Id = 2, Username = "Test user" };
+        private readonly APIUser streamingUser = new APIUser { Id = 2, Username = "Test user" };
 
         private TestSpectatorClient spectatorClient;
         private CurrentlyPlayingDisplay currentlyPlaying;
@@ -83,13 +84,13 @@ namespace osu.Game.Tests.Visual.Online
                 "pishifat"
             };
 
-            protected override Task<User> ComputeValueAsync(int lookup, CancellationToken token = default)
+            protected override Task<APIUser> ComputeValueAsync(int lookup, CancellationToken token = default)
             {
                 // tests against failed lookups
                 if (lookup == 13)
-                    return Task.FromResult<User>(null);
+                    return Task.FromResult<APIUser>(null);
 
-                return Task.FromResult(new User
+                return Task.FromResult(new APIUser
                 {
                     Id = lookup,
                     Username = usernames[lookup % usernames.Length],
diff --git a/osu.Game.Tests/Visual/Online/TestSceneDirectPanel.cs b/osu.Game.Tests/Visual/Online/TestSceneDirectPanel.cs
index a3c8935fa8..01dde97d38 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneDirectPanel.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneDirectPanel.cs
@@ -10,8 +10,8 @@ using osu.Game.Beatmaps;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays.BeatmapListing.Panels;
 using osu.Game.Rulesets;
-using osu.Game.Users;
 using osuTK;
+using APIUser = osu.Game.Online.API.Requests.Responses.APIUser;
 
 namespace osu.Game.Tests.Visual.Online
 {
@@ -74,7 +74,7 @@ namespace osu.Game.Tests.Visual.Online
                 Title = "undownloadable beatmap",
                 Artist = "test",
                 Source = "more tests",
-                Author = new User
+                Author = new APIUser
                 {
                     Username = "BanchoBot",
                     Id = 3,
@@ -121,7 +121,7 @@ namespace osu.Game.Tests.Visual.Online
                     Title = "undownloadable beatmap",
                     Artist = "test",
                     Source = "more tests",
-                    Author = new User
+                    Author = new APIUser
                     {
                         Username = "BanchoBot",
                         Id = 3,
diff --git a/osu.Game.Tests/Visual/Online/TestSceneFriendDisplay.cs b/osu.Game.Tests/Visual/Online/TestSceneFriendDisplay.cs
index e8d9ff72af..471d361c4e 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneFriendDisplay.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneFriendDisplay.cs
@@ -7,6 +7,7 @@ using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays;
 using osu.Game.Overlays.Dashboard.Friends;
 using osu.Game.Users;
@@ -44,9 +45,9 @@ namespace osu.Game.Tests.Visual.Online
             // No need to do anything, fetch is performed automatically.
         }
 
-        private List<User> getUsers() => new List<User>
+        private List<APIUser> getUsers() => new List<APIUser>
         {
-            new User
+            new APIUser
             {
                 Username = "flyte",
                 Id = 3103765,
@@ -55,7 +56,7 @@ namespace osu.Game.Tests.Visual.Online
                 Country = new Country { FlagName = "JP" },
                 CoverUrl = "https://osu.ppy.sh/images/headers/profile-covers/c6.jpg"
             },
-            new User
+            new APIUser
             {
                 Username = "peppy",
                 Id = 2,
@@ -66,7 +67,7 @@ namespace osu.Game.Tests.Visual.Online
                 IsSupporter = true,
                 SupportLevel = 3,
             },
-            new User
+            new APIUser
             {
                 Username = "Evast",
                 Id = 8195163,
diff --git a/osu.Game.Tests/Visual/Online/TestSceneHistoricalSection.cs b/osu.Game.Tests/Visual/Online/TestSceneHistoricalSection.cs
index 3ecca85ef1..2639a6506c 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneHistoricalSection.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneHistoricalSection.cs
@@ -7,9 +7,9 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Shapes;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays;
 using osu.Game.Overlays.Profile.Sections;
-using osu.Game.Users;
 
 namespace osu.Game.Tests.Visual.Online
 {
@@ -37,8 +37,8 @@ namespace osu.Game.Tests.Visual.Online
                 Child = section = new HistoricalSection(),
             });
 
-            AddStep("Show peppy", () => section.User.Value = new User { Id = 2 });
-            AddStep("Show WubWoofWolf", () => section.User.Value = new User { Id = 39828 });
+            AddStep("Show peppy", () => section.User.Value = new APIUser { Id = 2 });
+            AddStep("Show WubWoofWolf", () => section.User.Value = new APIUser { Id = 39828 });
         }
     }
 }
diff --git a/osu.Game.Tests/Visual/Online/TestSceneMessageNotifier.cs b/osu.Game.Tests/Visual/Online/TestSceneMessageNotifier.cs
index d193856217..175d2ea36b 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneMessageNotifier.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneMessageNotifier.cs
@@ -15,14 +15,14 @@ using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Chat;
 using osu.Game.Overlays;
 using osu.Game.Overlays.Notifications;
-using osu.Game.Users;
 using osuTK.Input;
+using APIUser = osu.Game.Online.API.Requests.Responses.APIUser;
 
 namespace osu.Game.Tests.Visual.Online
 {
     public class TestSceneMessageNotifier : OsuManualInputManagerTestScene
     {
-        private User friend;
+        private APIUser friend;
         private Channel publicChannel;
         private Channel privateMessageChannel;
         private TestContainer testContainer;
@@ -37,7 +37,7 @@ namespace osu.Game.Tests.Visual.Online
                 daa.HandleRequest = dummyAPIHandleRequest;
             }
 
-            friend = new User { Id = 0, Username = "Friend" };
+            friend = new APIUser { Id = 0, Username = "Friend" };
             publicChannel = new Channel { Id = 1, Name = "osu" };
             privateMessageChannel = new Channel(friend) { Id = 2, Name = friend.Username, Type = ChannelType.PM };
 
@@ -178,9 +178,9 @@ namespace osu.Game.Tests.Visual.Online
             AddAssert("1 notification fired", () => testContainer.NotificationOverlay.UnreadCount.Value == 1);
         }
 
-        private void receiveMessage(User sender, Channel channel, string content) => channel.AddNewMessages(createMessage(sender, channel, content));
+        private void receiveMessage(APIUser sender, Channel channel, string content) => channel.AddNewMessages(createMessage(sender, channel, content));
 
-        private Message createMessage(User sender, Channel channel, string content) => new Message(messageIdCounter++)
+        private Message createMessage(APIUser sender, Channel channel, string content) => new Message(messageIdCounter++)
         {
             Content = content,
             Sender = sender,
diff --git a/osu.Game.Tests/Visual/Online/TestSceneOfflineCommentsContainer.cs b/osu.Game.Tests/Visual/Online/TestSceneOfflineCommentsContainer.cs
index 4f7947b69c..0587e8884f 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneOfflineCommentsContainer.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneOfflineCommentsContainer.cs
@@ -11,9 +11,9 @@ using osu.Game.Overlays.Comments;
 using osu.Game.Overlays;
 using osu.Framework.Allocation;
 using osu.Game.Online.API.Requests.Responses;
-using osu.Game.Users;
 using JetBrains.Annotations;
 using osu.Framework.Testing;
+using APIUser = osu.Game.Online.API.Requests.Responses.APIUser;
 
 namespace osu.Game.Tests.Visual.Online
 {
@@ -154,9 +154,9 @@ namespace osu.Game.Tests.Visual.Online
             {
                 5
             },
-            Users = new List<User>
+            Users = new List<APIUser>
             {
-                new User
+                new APIUser
                 {
                     Id = 1,
                     Username = "Good_Admin"
diff --git a/osu.Game.Tests/Visual/Online/TestScenePlayHistorySubsection.cs b/osu.Game.Tests/Visual/Online/TestScenePlayHistorySubsection.cs
index cf5ecf5bf2..fecc1af03c 100644
--- a/osu.Game.Tests/Visual/Online/TestScenePlayHistorySubsection.cs
+++ b/osu.Game.Tests/Visual/Online/TestScenePlayHistorySubsection.cs
@@ -4,7 +4,6 @@
 using osu.Game.Overlays.Profile.Sections.Historical;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
-using osu.Game.Users;
 using NUnit.Framework;
 using osu.Game.Overlays;
 using osu.Framework.Allocation;
@@ -12,7 +11,7 @@ using System;
 using System.Linq;
 using osu.Framework.Testing;
 using osu.Framework.Graphics.Shapes;
-using static osu.Game.Users.User;
+using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Tests.Visual.Online
 {
@@ -21,7 +20,7 @@ namespace osu.Game.Tests.Visual.Online
         [Cached]
         private readonly OverlayColourProvider colourProvider = new OverlayColourProvider(OverlayColourScheme.Red);
 
-        private readonly Bindable<User> user = new Bindable<User>();
+        private readonly Bindable<APIUser> user = new Bindable<APIUser>();
         private readonly PlayHistorySubsection section;
 
         public TestScenePlayHistorySubsection()
@@ -101,80 +100,80 @@ namespace osu.Game.Tests.Visual.Online
 
         private int getChartValuesLength() => this.ChildrenOfType<ProfileLineChart>().Single().Values.Length;
 
-        private static readonly User user_with_null_values = new User
+        private static readonly APIUser user_with_null_values = new APIUser
         {
             Id = 1
         };
 
-        private static readonly User user_with_empty_values = new User
+        private static readonly APIUser user_with_empty_values = new APIUser
         {
             Id = 2,
-            MonthlyPlaycounts = Array.Empty<UserHistoryCount>()
+            MonthlyPlaycounts = Array.Empty<APIUserHistoryCount>()
         };
 
-        private static readonly User user_with_one_value = new User
+        private static readonly APIUser user_with_one_value = new APIUser
         {
             Id = 3,
             MonthlyPlaycounts = new[]
             {
-                new UserHistoryCount { Date = new DateTime(2010, 5, 1), Count = 100 }
+                new APIUserHistoryCount { Date = new DateTime(2010, 5, 1), Count = 100 }
             }
         };
 
-        private static readonly User user_with_two_values = new User
+        private static readonly APIUser user_with_two_values = new APIUser
         {
             Id = 4,
             MonthlyPlaycounts = new[]
             {
-                new UserHistoryCount { Date = new DateTime(2010, 5, 1), Count = 1 },
-                new UserHistoryCount { Date = new DateTime(2010, 6, 1), Count = 2 }
+                new APIUserHistoryCount { Date = new DateTime(2010, 5, 1), Count = 1 },
+                new APIUserHistoryCount { Date = new DateTime(2010, 6, 1), Count = 2 }
             }
         };
 
-        private static readonly User user_with_constant_values = new User
+        private static readonly APIUser user_with_constant_values = new APIUser
         {
             Id = 5,
             MonthlyPlaycounts = new[]
             {
-                new UserHistoryCount { Date = new DateTime(2010, 5, 1), Count = 5 },
-                new UserHistoryCount { Date = new DateTime(2010, 6, 1), Count = 5 },
-                new UserHistoryCount { Date = new DateTime(2010, 7, 1), Count = 5 }
+                new APIUserHistoryCount { Date = new DateTime(2010, 5, 1), Count = 5 },
+                new APIUserHistoryCount { Date = new DateTime(2010, 6, 1), Count = 5 },
+                new APIUserHistoryCount { Date = new DateTime(2010, 7, 1), Count = 5 }
             }
         };
 
-        private static readonly User user_with_zero_values = new User
+        private static readonly APIUser user_with_zero_values = new APIUser
         {
             Id = 6,
             MonthlyPlaycounts = new[]
             {
-                new UserHistoryCount { Date = new DateTime(2010, 5, 1), Count = 0 },
-                new UserHistoryCount { Date = new DateTime(2010, 6, 1), Count = 0 },
-                new UserHistoryCount { Date = new DateTime(2010, 7, 1), Count = 0 }
+                new APIUserHistoryCount { Date = new DateTime(2010, 5, 1), Count = 0 },
+                new APIUserHistoryCount { Date = new DateTime(2010, 6, 1), Count = 0 },
+                new APIUserHistoryCount { Date = new DateTime(2010, 7, 1), Count = 0 }
             }
         };
 
-        private static readonly User user_with_filled_values = new User
+        private static readonly APIUser user_with_filled_values = new APIUser
         {
             Id = 7,
             MonthlyPlaycounts = new[]
             {
-                new UserHistoryCount { Date = new DateTime(2010, 5, 1), Count = 1000 },
-                new UserHistoryCount { Date = new DateTime(2010, 6, 1), Count = 20 },
-                new UserHistoryCount { Date = new DateTime(2010, 7, 1), Count = 20000 },
-                new UserHistoryCount { Date = new DateTime(2010, 8, 1), Count = 30 },
-                new UserHistoryCount { Date = new DateTime(2010, 9, 1), Count = 50 },
-                new UserHistoryCount { Date = new DateTime(2010, 10, 1), Count = 2000 },
-                new UserHistoryCount { Date = new DateTime(2010, 11, 1), Count = 2100 }
+                new APIUserHistoryCount { Date = new DateTime(2010, 5, 1), Count = 1000 },
+                new APIUserHistoryCount { Date = new DateTime(2010, 6, 1), Count = 20 },
+                new APIUserHistoryCount { Date = new DateTime(2010, 7, 1), Count = 20000 },
+                new APIUserHistoryCount { Date = new DateTime(2010, 8, 1), Count = 30 },
+                new APIUserHistoryCount { Date = new DateTime(2010, 9, 1), Count = 50 },
+                new APIUserHistoryCount { Date = new DateTime(2010, 10, 1), Count = 2000 },
+                new APIUserHistoryCount { Date = new DateTime(2010, 11, 1), Count = 2100 }
             }
         };
 
-        private static readonly User user_with_missing_values = new User
+        private static readonly APIUser user_with_missing_values = new APIUser
         {
             Id = 8,
             MonthlyPlaycounts = new[]
             {
-                new UserHistoryCount { Date = new DateTime(2020, 1, 1), Count = 100 },
-                new UserHistoryCount { Date = new DateTime(2020, 7, 1), Count = 200 }
+                new APIUserHistoryCount { Date = new DateTime(2020, 1, 1), Count = 100 },
+                new APIUserHistoryCount { Date = new DateTime(2020, 7, 1), Count = 200 }
             }
         };
     }
diff --git a/osu.Game.Tests/Visual/Online/TestSceneProfileRulesetSelector.cs b/osu.Game.Tests/Visual/Online/TestSceneProfileRulesetSelector.cs
index 6a847e4269..cbbe8b8eac 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneProfileRulesetSelector.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneProfileRulesetSelector.cs
@@ -7,10 +7,10 @@ using osu.Game.Rulesets.Catch;
 using osu.Game.Rulesets.Mania;
 using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Taiko;
-using osu.Game.Users;
 using osu.Framework.Bindables;
 using osu.Game.Overlays;
 using osu.Framework.Allocation;
+using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Tests.Visual.Online
 {
@@ -22,7 +22,7 @@ namespace osu.Game.Tests.Visual.Online
         public TestSceneProfileRulesetSelector()
         {
             ProfileRulesetSelector selector;
-            var user = new Bindable<User>();
+            var user = new Bindable<APIUser>();
 
             Child = selector = new ProfileRulesetSelector
             {
@@ -36,10 +36,10 @@ namespace osu.Game.Tests.Visual.Online
             AddStep("set taiko as default", () => selector.SetDefaultRuleset(new TaikoRuleset().RulesetInfo));
             AddStep("set catch as default", () => selector.SetDefaultRuleset(new CatchRuleset().RulesetInfo));
 
-            AddStep("User with osu as default", () => user.Value = new User { PlayMode = "osu" });
-            AddStep("User with mania as default", () => user.Value = new User { PlayMode = "mania" });
-            AddStep("User with taiko as default", () => user.Value = new User { PlayMode = "taiko" });
-            AddStep("User with catch as default", () => user.Value = new User { PlayMode = "fruits" });
+            AddStep("User with osu as default", () => user.Value = new APIUser { PlayMode = "osu" });
+            AddStep("User with mania as default", () => user.Value = new APIUser { PlayMode = "mania" });
+            AddStep("User with taiko as default", () => user.Value = new APIUser { PlayMode = "taiko" });
+            AddStep("User with catch as default", () => user.Value = new APIUser { PlayMode = "fruits" });
             AddStep("null user", () => user.Value = null);
         }
     }
diff --git a/osu.Game.Tests/Visual/Online/TestSceneRankGraph.cs b/osu.Game.Tests/Visual/Online/TestSceneRankGraph.cs
index f577140e17..1f7da7ac0d 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneRankGraph.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneRankGraph.cs
@@ -7,6 +7,7 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
 using osu.Game.Graphics;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays;
 using osu.Game.Overlays.Profile.Header.Components;
 using osu.Game.Users;
@@ -81,7 +82,7 @@ namespace osu.Game.Tests.Visual.Online
                 {
                     GlobalRank = 89000,
                     PP = 12345,
-                    RankHistory = new User.RankHistoryData
+                    RankHistory = new APIUser.RankHistoryData
                     {
                         Data = data,
                     }
@@ -94,7 +95,7 @@ namespace osu.Game.Tests.Visual.Online
                 {
                     GlobalRank = 89000,
                     PP = 12345,
-                    RankHistory = new User.RankHistoryData
+                    RankHistory = new APIUser.RankHistoryData
                     {
                         Data = dataWithZeros,
                     }
@@ -107,7 +108,7 @@ namespace osu.Game.Tests.Visual.Online
                 {
                     GlobalRank = 12000,
                     PP = 12345,
-                    RankHistory = new User.RankHistoryData
+                    RankHistory = new APIUser.RankHistoryData
                     {
                         Data = smallData,
                     }
@@ -120,7 +121,7 @@ namespace osu.Game.Tests.Visual.Online
                 {
                     GlobalRank = 12000,
                     PP = 12345,
-                    RankHistory = new User.RankHistoryData
+                    RankHistory = new APIUser.RankHistoryData
                     {
                         Data = edgyData,
                     }
diff --git a/osu.Game.Tests/Visual/Online/TestSceneScoresContainer.cs b/osu.Game.Tests/Visual/Online/TestSceneScoresContainer.cs
index 23899154c4..50969aad9b 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneScoresContainer.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneScoresContainer.cs
@@ -15,6 +15,7 @@ using osu.Game.Rulesets.Osu.Mods;
 using osu.Game.Scoring;
 using osu.Game.Users;
 using osuTK.Graphics;
+using APIUser = osu.Game.Online.API.Requests.Responses.APIUser;
 
 namespace osu.Game.Tests.Visual.Online
 {
@@ -50,7 +51,7 @@ namespace osu.Game.Tests.Visual.Online
                 {
                     new APIScoreInfo
                     {
-                        User = new User
+                        User = new APIUser
                         {
                             Id = 6602580,
                             Username = @"waaiiru",
@@ -75,7 +76,7 @@ namespace osu.Game.Tests.Visual.Online
                     },
                     new APIScoreInfo
                     {
-                        User = new User
+                        User = new APIUser
                         {
                             Id = 4608074,
                             Username = @"Skycries",
@@ -99,7 +100,7 @@ namespace osu.Game.Tests.Visual.Online
                     },
                     new APIScoreInfo
                     {
-                        User = new User
+                        User = new APIUser
                         {
                             Id = 1014222,
                             Username = @"eLy",
@@ -122,7 +123,7 @@ namespace osu.Game.Tests.Visual.Online
                     },
                     new APIScoreInfo
                     {
-                        User = new User
+                        User = new APIUser
                         {
                             Id = 1541390,
                             Username = @"Toukai",
@@ -144,7 +145,7 @@ namespace osu.Game.Tests.Visual.Online
                     },
                     new APIScoreInfo
                     {
-                        User = new User
+                        User = new APIUser
                         {
                             Id = 7151382,
                             Username = @"Mayuri Hana",
@@ -167,7 +168,7 @@ namespace osu.Game.Tests.Visual.Online
             {
                 Score = new APIScoreInfo
                 {
-                    User = new User
+                    User = new APIUser
                     {
                         Id = 7151382,
                         Username = @"Mayuri Hana",
@@ -190,7 +191,7 @@ namespace osu.Game.Tests.Visual.Online
             {
                 Score = new APIScoreInfo
                 {
-                    User = new User
+                    User = new APIUser
                     {
                         Id = 7151382,
                         Username = @"Mayuri Hana",
@@ -215,7 +216,7 @@ namespace osu.Game.Tests.Visual.Online
                 {
                     new APIScoreInfo
                     {
-                        User = new User
+                        User = new APIUser
                         {
                             Id = 6602580,
                             Username = @"waaiiru",
diff --git a/osu.Game.Tests/Visual/Online/TestSceneStandAloneChatDisplay.cs b/osu.Game.Tests/Visual/Online/TestSceneStandAloneChatDisplay.cs
index b3b8d75c46..b7bce012ce 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneStandAloneChatDisplay.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneStandAloneChatDisplay.cs
@@ -4,13 +4,13 @@
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Game.Online.Chat;
-using osu.Game.Users;
 using osuTK;
 using System;
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Graphics.Containers;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays.Chat;
 using osuTK.Input;
 
@@ -18,26 +18,26 @@ namespace osu.Game.Tests.Visual.Online
 {
     public class TestSceneStandAloneChatDisplay : OsuManualInputManagerTestScene
     {
-        private readonly User admin = new User
+        private readonly APIUser admin = new APIUser
         {
             Username = "HappyStick",
             Id = 2,
             Colour = "f2ca34"
         };
 
-        private readonly User redUser = new User
+        private readonly APIUser redUser = new APIUser
         {
             Username = "BanchoBot",
             Id = 3,
         };
 
-        private readonly User blueUser = new User
+        private readonly APIUser blueUser = new APIUser
         {
             Username = "Zallius",
             Id = 4,
         };
 
-        private readonly User longUsernameUser = new User
+        private readonly APIUser longUsernameUser = new APIUser
         {
             Username = "Very Long Long Username",
             Id = 5,
diff --git a/osu.Game.Tests/Visual/Online/TestSceneUserHistoryGraph.cs b/osu.Game.Tests/Visual/Online/TestSceneUserHistoryGraph.cs
index 484c59695e..3f4a5cd420 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneUserHistoryGraph.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneUserHistoryGraph.cs
@@ -2,11 +2,11 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
-using osu.Game.Overlays.Profile.Sections.Historical;
-using osu.Framework.Graphics;
-using osu.Game.Overlays;
 using osu.Framework.Allocation;
-using static osu.Game.Users.User;
+using osu.Framework.Graphics;
+using osu.Game.Online.API.Requests.Responses;
+using osu.Game.Overlays;
+using osu.Game.Overlays.Profile.Sections.Historical;
 
 namespace osu.Game.Tests.Visual.Online
 {
@@ -29,28 +29,28 @@ namespace osu.Game.Tests.Visual.Online
 
             var values = new[]
             {
-                new UserHistoryCount { Date = new DateTime(2000, 1, 1), Count = 10 },
-                new UserHistoryCount { Date = new DateTime(2000, 2, 1), Count = 20 },
-                new UserHistoryCount { Date = new DateTime(2000, 3, 1), Count = 100 },
-                new UserHistoryCount { Date = new DateTime(2000, 4, 1), Count = 15 },
-                new UserHistoryCount { Date = new DateTime(2000, 5, 1), Count = 30 }
+                new APIUserHistoryCount { Date = new DateTime(2000, 1, 1), Count = 10 },
+                new APIUserHistoryCount { Date = new DateTime(2000, 2, 1), Count = 20 },
+                new APIUserHistoryCount { Date = new DateTime(2000, 3, 1), Count = 100 },
+                new APIUserHistoryCount { Date = new DateTime(2000, 4, 1), Count = 15 },
+                new APIUserHistoryCount { Date = new DateTime(2000, 5, 1), Count = 30 }
             };
 
             var moreValues = new[]
             {
-                new UserHistoryCount { Date = new DateTime(2010, 5, 1), Count = 1000 },
-                new UserHistoryCount { Date = new DateTime(2010, 6, 1), Count = 20 },
-                new UserHistoryCount { Date = new DateTime(2010, 7, 1), Count = 20000 },
-                new UserHistoryCount { Date = new DateTime(2010, 8, 1), Count = 30 },
-                new UserHistoryCount { Date = new DateTime(2010, 9, 1), Count = 50 },
-                new UserHistoryCount { Date = new DateTime(2010, 10, 1), Count = 2000 },
-                new UserHistoryCount { Date = new DateTime(2010, 11, 1), Count = 2100 }
+                new APIUserHistoryCount { Date = new DateTime(2010, 5, 1), Count = 1000 },
+                new APIUserHistoryCount { Date = new DateTime(2010, 6, 1), Count = 20 },
+                new APIUserHistoryCount { Date = new DateTime(2010, 7, 1), Count = 20000 },
+                new APIUserHistoryCount { Date = new DateTime(2010, 8, 1), Count = 30 },
+                new APIUserHistoryCount { Date = new DateTime(2010, 9, 1), Count = 50 },
+                new APIUserHistoryCount { Date = new DateTime(2010, 10, 1), Count = 2000 },
+                new APIUserHistoryCount { Date = new DateTime(2010, 11, 1), Count = 2100 }
             };
 
             AddStep("Set fake values", () => graph.Values = values);
             AddStep("Set more values", () => graph.Values = moreValues);
             AddStep("Set null values", () => graph.Values = null);
-            AddStep("Set empty values", () => graph.Values = Array.Empty<UserHistoryCount>());
+            AddStep("Set empty values", () => graph.Values = Array.Empty<APIUserHistoryCount>());
         }
     }
 }
diff --git a/osu.Game.Tests/Visual/Online/TestSceneUserPanel.cs b/osu.Game.Tests/Visual/Online/TestSceneUserPanel.cs
index a048ae2c54..19e06beaad 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneUserPanel.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneUserPanel.cs
@@ -7,6 +7,7 @@ using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets;
 using osu.Game.Users;
 using osuTK;
@@ -42,27 +43,27 @@ namespace osu.Game.Tests.Visual.Online
                 Spacing = new Vector2(10f),
                 Children = new Drawable[]
                 {
-                    new UserBrickPanel(new User
+                    new UserBrickPanel(new APIUser
                     {
                         Username = @"flyte",
                         Id = 3103765,
                         CoverUrl = @"https://osu.ppy.sh/images/headers/profile-covers/c6.jpg"
                     }),
-                    new UserBrickPanel(new User
+                    new UserBrickPanel(new APIUser
                     {
                         Username = @"peppy",
                         Id = 2,
                         Colour = "99EB47",
                         CoverUrl = @"https://osu.ppy.sh/images/headers/profile-covers/c3.jpg",
                     }),
-                    flyte = new UserGridPanel(new User
+                    flyte = new UserGridPanel(new APIUser
                     {
                         Username = @"flyte",
                         Id = 3103765,
                         Country = new Country { FlagName = @"JP" },
                         CoverUrl = @"https://osu.ppy.sh/images/headers/profile-covers/c6.jpg"
                     }) { Width = 300 },
-                    peppy = new UserGridPanel(new User
+                    peppy = new UserGridPanel(new APIUser
                     {
                         Username = @"peppy",
                         Id = 2,
@@ -71,7 +72,7 @@ namespace osu.Game.Tests.Visual.Online
                         IsSupporter = true,
                         SupportLevel = 3,
                     }) { Width = 300 },
-                    evast = new TestUserListPanel(new User
+                    evast = new TestUserListPanel(new APIUser
                     {
                         Username = @"Evast",
                         Id = 8195163,
@@ -134,7 +135,7 @@ namespace osu.Game.Tests.Visual.Online
 
         private class TestUserListPanel : UserListPanel
         {
-            public TestUserListPanel(User user)
+            public TestUserListPanel(APIUser user)
                 : base(user)
             {
             }
diff --git a/osu.Game.Tests/Visual/Online/TestSceneUserProfileHeader.cs b/osu.Game.Tests/Visual/Online/TestSceneUserProfileHeader.cs
index 04b741b2bb..76997bded7 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneUserProfileHeader.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneUserProfileHeader.cs
@@ -5,6 +5,7 @@ using System;
 using osu.Framework.Allocation;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays;
 using osu.Game.Overlays.Profile;
 using osu.Game.Users;
@@ -30,26 +31,26 @@ namespace osu.Game.Tests.Visual.Online
 
             AddStep("Show test dummy", () => header.User.Value = TestSceneUserProfileOverlay.TEST_USER);
 
-            AddStep("Show null dummy", () => header.User.Value = new User
+            AddStep("Show null dummy", () => header.User.Value = new APIUser
             {
                 Username = "Null"
             });
 
-            AddStep("Show online dummy", () => header.User.Value = new User
+            AddStep("Show online dummy", () => header.User.Value = new APIUser
             {
                 Username = "IAmOnline",
                 LastVisit = DateTimeOffset.Now,
                 IsOnline = true,
             });
 
-            AddStep("Show offline dummy", () => header.User.Value = new User
+            AddStep("Show offline dummy", () => header.User.Value = new APIUser
             {
                 Username = "IAmOffline",
                 LastVisit = DateTimeOffset.Now,
                 IsOnline = false,
             });
 
-            addOnlineStep("Show ppy", new User
+            addOnlineStep("Show ppy", new APIUser
             {
                 Username = @"peppy",
                 Id = 2,
@@ -58,7 +59,7 @@ namespace osu.Game.Tests.Visual.Online
                 CoverUrl = @"https://osu.ppy.sh/images/headers/profile-covers/c3.jpg"
             });
 
-            addOnlineStep("Show flyte", new User
+            addOnlineStep("Show flyte", new APIUser
             {
                 Username = @"flyte",
                 Id = 3103765,
@@ -67,7 +68,7 @@ namespace osu.Game.Tests.Visual.Online
             });
         }
 
-        private void addOnlineStep(string name, User fallback)
+        private void addOnlineStep(string name, APIUser fallback)
         {
             AddStep(name, () =>
             {
diff --git a/osu.Game.Tests/Visual/Online/TestSceneUserProfileOverlay.cs b/osu.Game.Tests/Visual/Online/TestSceneUserProfileOverlay.cs
index 70271b0b08..2a6f304369 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneUserProfileOverlay.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneUserProfileOverlay.cs
@@ -6,6 +6,7 @@ using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Game.Online.API;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays;
 using osu.Game.Overlays.Profile;
 using osu.Game.Users;
@@ -22,7 +23,7 @@ namespace osu.Game.Tests.Visual.Online
         [Resolved]
         private IAPIProvider api { get; set; }
 
-        public static readonly User TEST_USER = new User
+        public static readonly APIUser TEST_USER = new APIUser
         {
             Username = @"Somebody",
             Id = 1,
@@ -41,7 +42,7 @@ namespace osu.Game.Tests.Visual.Online
                     Current = 727,
                     Progress = 69,
                 },
-                RankHistory = new User.RankHistoryData
+                RankHistory = new APIUser.RankHistoryData
                 {
                     Mode = @"osu",
                     Data = Enumerable.Range(2345, 45).Concat(Enumerable.Range(2109, 40)).ToArray()
@@ -58,7 +59,7 @@ namespace osu.Game.Tests.Visual.Online
             },
             Title = "osu!volunteer",
             Colour = "ff0000",
-            Achievements = Array.Empty<User.UserAchievement>(),
+            Achievements = Array.Empty<APIUser.UserAchievement>(),
         };
 
         public TestSceneUserProfileOverlay()
@@ -72,13 +73,13 @@ namespace osu.Game.Tests.Visual.Online
 
             AddStep("Show offline dummy", () => profile.ShowUser(TEST_USER, false));
 
-            AddStep("Show null dummy", () => profile.ShowUser(new User
+            AddStep("Show null dummy", () => profile.ShowUser(new APIUser
             {
                 Username = @"Null",
                 Id = 1,
             }, false));
 
-            AddStep("Show ppy", () => profile.ShowUser(new User
+            AddStep("Show ppy", () => profile.ShowUser(new APIUser
             {
                 Username = @"peppy",
                 Id = 2,
@@ -87,7 +88,7 @@ namespace osu.Game.Tests.Visual.Online
                 CoverUrl = @"https://osu.ppy.sh/images/headers/profile-covers/c3.jpg"
             }, api.IsLoggedIn));
 
-            AddStep("Show flyte", () => profile.ShowUser(new User
+            AddStep("Show flyte", () => profile.ShowUser(new APIUser
             {
                 Username = @"flyte",
                 Id = 3103765,
@@ -95,7 +96,7 @@ namespace osu.Game.Tests.Visual.Online
                 CoverUrl = @"https://osu.ppy.sh/images/headers/profile-covers/c6.jpg"
             }, api.IsLoggedIn));
 
-            AddStep("Show bancho", () => profile.ShowUser(new User
+            AddStep("Show bancho", () => profile.ShowUser(new APIUser
             {
                 Username = @"BanchoBot",
                 Id = 3,
diff --git a/osu.Game.Tests/Visual/Online/TestSceneUserProfilePreviousUsernames.cs b/osu.Game.Tests/Visual/Online/TestSceneUserProfilePreviousUsernames.cs
index b5d2d15392..30774689a2 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneUserProfilePreviousUsernames.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneUserProfilePreviousUsernames.cs
@@ -4,8 +4,8 @@
 using System;
 using NUnit.Framework;
 using osu.Framework.Graphics;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays.Profile.Header.Components;
-using osu.Game.Users;
 
 namespace osu.Game.Tests.Visual.Online
 {
@@ -48,13 +48,13 @@ namespace osu.Game.Tests.Visual.Online
             AddUntilStep("Is hidden", () => container.Alpha == 0);
         }
 
-        private static readonly User[] users =
+        private static readonly APIUser[] users =
         {
-            new User { Id = 1, PreviousUsernames = new[] { "username1" } },
-            new User { Id = 2, PreviousUsernames = new[] { "longusername", "longerusername" } },
-            new User { Id = 3, PreviousUsernames = new[] { "test", "angelsim", "verylongusername" } },
-            new User { Id = 4, PreviousUsernames = new[] { "ihavenoidea", "howcani", "makethistext", "anylonger" } },
-            new User { Id = 5, PreviousUsernames = Array.Empty<string>() },
+            new APIUser { Id = 1, PreviousUsernames = new[] { "username1" } },
+            new APIUser { Id = 2, PreviousUsernames = new[] { "longusername", "longerusername" } },
+            new APIUser { Id = 3, PreviousUsernames = new[] { "test", "angelsim", "verylongusername" } },
+            new APIUser { Id = 4, PreviousUsernames = new[] { "ihavenoidea", "howcani", "makethistext", "anylonger" } },
+            new APIUser { Id = 5, PreviousUsernames = Array.Empty<string>() },
             null
         };
     }
diff --git a/osu.Game.Tests/Visual/Online/TestSceneUserRanks.cs b/osu.Game.Tests/Visual/Online/TestSceneUserRanks.cs
index c22cff4af6..b9272e7294 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneUserRanks.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneUserRanks.cs
@@ -8,9 +8,9 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays;
 using osu.Game.Overlays.Profile.Sections;
-using osu.Game.Users;
 
 namespace osu.Game.Tests.Visual.Online
 {
@@ -44,7 +44,7 @@ namespace osu.Game.Tests.Visual.Online
                 }
             });
 
-            AddStep("Show cookiezi", () => ranks.User.Value = new User { Id = 124493 });
+            AddStep("Show cookiezi", () => ranks.User.Value = new APIUser { Id = 124493 });
         }
     }
 }
diff --git a/osu.Game.Tests/Visual/Online/TestSceneUserRequest.cs b/osu.Game.Tests/Visual/Online/TestSceneUserRequest.cs
index 15cfd3ee54..e7b6a94642 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneUserRequest.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneUserRequest.cs
@@ -9,10 +9,10 @@ using osu.Game.Online.API;
 using osu.Game.Online.API.Requests;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Mania;
-using osu.Game.Users;
 using osu.Framework.Graphics;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.UserInterface;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets.Taiko;
 
 namespace osu.Game.Tests.Visual.Online
@@ -23,7 +23,7 @@ namespace osu.Game.Tests.Visual.Online
         [Resolved]
         private IAPIProvider api { get; set; }
 
-        private readonly Bindable<User> user = new Bindable<User>();
+        private readonly Bindable<APIUser> user = new Bindable<APIUser>();
         private GetUserRequest request;
         private readonly LoadingLayer loading;
 
@@ -71,7 +71,7 @@ namespace osu.Game.Tests.Visual.Online
 
         private class UserTestContainer : FillFlowContainer
         {
-            public readonly Bindable<User> User = new Bindable<User>();
+            public readonly Bindable<APIUser> User = new Bindable<APIUser>();
 
             public UserTestContainer()
             {
@@ -85,7 +85,7 @@ namespace osu.Game.Tests.Visual.Online
                 User.BindValueChanged(onUserUpdate, true);
             }
 
-            private void onUserUpdate(ValueChangedEvent<User> user)
+            private void onUserUpdate(ValueChangedEvent<APIUser> user)
             {
                 Clear();
 
diff --git a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsParticipantsList.cs b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsParticipantsList.cs
index 76a78c0a3c..1288b9e765 100644
--- a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsParticipantsList.cs
+++ b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsParticipantsList.cs
@@ -3,6 +3,7 @@
 
 using NUnit.Framework;
 using osu.Framework.Graphics;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Rooms;
 using osu.Game.Screens.OnlinePlay.Components;
 using osu.Game.Tests.Visual.OnlinePlay;
@@ -19,7 +20,7 @@ namespace osu.Game.Tests.Visual.Playlists
 
             for (int i = 0; i < 50; i++)
             {
-                SelectedRoom.Value.RecentParticipants.Add(new User
+                SelectedRoom.Value.RecentParticipants.Add(new APIUser
                 {
                     Username = "peppy",
                     Statistics = new UserStatistics { GlobalRank = 1234 },
diff --git a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsResultsScreen.cs b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsResultsScreen.cs
index d948aebbbf..4284bc6358 100644
--- a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsResultsScreen.cs
+++ b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsResultsScreen.cs
@@ -14,6 +14,7 @@ using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Rooms;
 using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Scoring;
@@ -21,7 +22,6 @@ using osu.Game.Scoring;
 using osu.Game.Screens.OnlinePlay.Playlists;
 using osu.Game.Screens.Ranking;
 using osu.Game.Tests.Beatmaps;
-using osu.Game.Users;
 
 namespace osu.Game.Tests.Visual.Playlists
 {
@@ -260,7 +260,7 @@ namespace osu.Game.Tests.Visual.Playlists
                     Rank = userScore.Rank,
                     MaxCombo = userScore.MaxCombo,
                     TotalScore = userScore.TotalScore - i,
-                    User = new User
+                    User = new APIUser
                     {
                         Id = 2,
                         Username = $"peppy{i}",
@@ -278,7 +278,7 @@ namespace osu.Game.Tests.Visual.Playlists
                     Rank = userScore.Rank,
                     MaxCombo = userScore.MaxCombo,
                     TotalScore = userScore.TotalScore + i,
-                    User = new User
+                    User = new APIUser
                     {
                         Id = 2,
                         Username = $"peppy{i}",
@@ -314,7 +314,7 @@ namespace osu.Game.Tests.Visual.Playlists
                     Rank = ScoreRank.X,
                     MaxCombo = 1000,
                     TotalScore = startTotalScore + (sort == "score_asc" ? i : -i),
-                    User = new User
+                    User = new APIUser
                     {
                         Id = 2,
                         Username = $"peppy{i}",
diff --git a/osu.Game.Tests/Visual/Ranking/TestSceneAccuracyCircle.cs b/osu.Game.Tests/Visual/Ranking/TestSceneAccuracyCircle.cs
index df8500fab2..944941723e 100644
--- a/osu.Game.Tests/Visual/Ranking/TestSceneAccuracyCircle.cs
+++ b/osu.Game.Tests/Visual/Ranking/TestSceneAccuracyCircle.cs
@@ -8,6 +8,7 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Colour;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Osu.Mods;
@@ -15,7 +16,6 @@ using osu.Game.Rulesets.Scoring;
 using osu.Game.Scoring;
 using osu.Game.Screens.Ranking.Expanded.Accuracy;
 using osu.Game.Tests.Beatmaps;
-using osu.Game.Users;
 using osuTK;
 
 namespace osu.Game.Tests.Visual.Ranking
@@ -66,7 +66,7 @@ namespace osu.Game.Tests.Visual.Ranking
 
         private ScoreInfo createScore(double accuracy, ScoreRank rank) => new ScoreInfo
         {
-            User = new User
+            User = new APIUser
             {
                 Id = 2,
                 Username = "peppy",
diff --git a/osu.Game.Tests/Visual/Ranking/TestSceneExpandedPanelMiddleContent.cs b/osu.Game.Tests/Visual/Ranking/TestSceneExpandedPanelMiddleContent.cs
index 899f351a2a..fee8985120 100644
--- a/osu.Game.Tests/Visual/Ranking/TestSceneExpandedPanelMiddleContent.cs
+++ b/osu.Game.Tests/Visual/Ranking/TestSceneExpandedPanelMiddleContent.cs
@@ -11,6 +11,7 @@ using osu.Framework.Graphics.Shapes;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
 using osu.Game.Graphics.Sprites;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Osu;
@@ -18,7 +19,6 @@ using osu.Game.Scoring;
 using osu.Game.Screens.Ranking;
 using osu.Game.Screens.Ranking.Expanded;
 using osu.Game.Tests.Beatmaps;
-using osu.Game.Users;
 using osuTK;
 
 namespace osu.Game.Tests.Visual.Ranking
@@ -31,7 +31,7 @@ namespace osu.Game.Tests.Visual.Ranking
         [Test]
         public void TestMapWithKnownMapper()
         {
-            var author = new User { Username = "mapper_name" };
+            var author = new APIUser { Username = "mapper_name" };
 
             AddStep("show example score", () => showPanel(new TestScoreInfo(new OsuRuleset().RulesetInfo)
             {
@@ -42,7 +42,7 @@ namespace osu.Game.Tests.Visual.Ranking
         [Test]
         public void TestExcessMods()
         {
-            var author = new User { Username = "mapper_name" };
+            var author = new APIUser { Username = "mapper_name" };
 
             AddStep("show excess mods score", () => showPanel(new TestScoreInfo(new OsuRuleset().RulesetInfo, true)
             {
@@ -90,7 +90,7 @@ namespace osu.Game.Tests.Visual.Ranking
         private void showPanel(ScoreInfo score) =>
             Child = new ExpandedPanelMiddleContentContainer(score);
 
-        private BeatmapInfo createTestBeatmap(User author)
+        private BeatmapInfo createTestBeatmap(APIUser author)
         {
             var beatmap = new TestBeatmap(rulesetStore.GetRuleset(0)).BeatmapInfo;
 
diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
index 13b769c80a..855a59b5f5 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
@@ -10,6 +10,7 @@ using osu.Framework.Graphics;
 using osu.Framework.Platform;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Leaderboards;
 using osu.Game.Overlays;
 using osu.Game.Rulesets;
@@ -133,7 +134,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                 MaxCombo = 244,
                 TotalScore = 1707827,
                 Mods = new Mod[] { new OsuModHidden(), new OsuModHardRock() },
-                User = new User
+                User = new APIUser
                 {
                     Id = 6602580,
                     Username = @"waaiiru",
@@ -156,7 +157,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                 MaxCombo = 244,
                 TotalScore = 1707827,
                 Mods = new Mod[] { new OsuModHidden(), new OsuModHardRock(), },
-                User = new User
+                User = new APIUser
                 {
                     Id = 6602580,
                     Username = @"waaiiru",
@@ -198,7 +199,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                     TotalScore = 1707827,
                     //Mods = new Mod[] { new OsuModHidden(), new OsuModHardRock(), },
                     BeatmapInfo = beatmapInfo,
-                    User = new User
+                    User = new APIUser
                     {
                         Id = 6602580,
                         Username = @"waaiiru",
@@ -217,7 +218,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                     TotalScore = 1707827,
                     //Mods = new Mod[] { new OsuModHidden(), new OsuModHardRock(), },
                     BeatmapInfo = beatmapInfo,
-                    User = new User
+                    User = new APIUser
                     {
                         Id = 4608074,
                         Username = @"Skycries",
@@ -236,7 +237,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                     TotalScore = 1707827,
                     //Mods = new Mod[] { new OsuModHidden(), new OsuModHardRock(), },
                     BeatmapInfo = beatmapInfo,
-                    User = new User
+                    User = new APIUser
                     {
                         Id = 1014222,
                         Username = @"eLy",
@@ -255,7 +256,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                     TotalScore = 1707827,
                     //Mods = new Mod[] { new OsuModHidden(), new OsuModHardRock(), },
                     BeatmapInfo = beatmapInfo,
-                    User = new User
+                    User = new APIUser
                     {
                         Id = 1541390,
                         Username = @"Toukai",
@@ -274,7 +275,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                     TotalScore = 1707827,
                     //Mods = new Mod[] { new OsuModHidden(), new OsuModHardRock(), },
                     BeatmapInfo = beatmapInfo,
-                    User = new User
+                    User = new APIUser
                     {
                         Id = 2243452,
                         Username = @"Satoruu",
@@ -293,7 +294,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                     TotalScore = 1707827,
                     //Mods = new Mod[] { new OsuModHidden(), new OsuModHardRock(), },
                     BeatmapInfo = beatmapInfo,
-                    User = new User
+                    User = new APIUser
                     {
                         Id = 2705430,
                         Username = @"Mooha",
@@ -312,7 +313,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                     TotalScore = 1707827,
                     //Mods = new Mod[] { new OsuModHidden(), new OsuModHardRock(), },
                     BeatmapInfo = beatmapInfo,
-                    User = new User
+                    User = new APIUser
                     {
                         Id = 7151382,
                         Username = @"Mayuri Hana",
@@ -331,7 +332,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                     TotalScore = 1707827,
                     //Mods = new Mod[] { new OsuModHidden(), new OsuModHardRock(), },
                     BeatmapInfo = beatmapInfo,
-                    User = new User
+                    User = new APIUser
                     {
                         Id = 2051389,
                         Username = @"FunOrange",
@@ -350,7 +351,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                     TotalScore = 1707827,
                     //Mods = new Mod[] { new OsuModHidden(), new OsuModHardRock(), },
                     BeatmapInfo = beatmapInfo,
-                    User = new User
+                    User = new APIUser
                     {
                         Id = 6169483,
                         Username = @"-Hebel-",
@@ -369,7 +370,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                     TotalScore = 1707827,
                     //Mods = new Mod[] { new OsuModHidden(), new OsuModHardRock(), },
                     BeatmapInfo = beatmapInfo,
-                    User = new User
+                    User = new APIUser
                     {
                         Id = 6702666,
                         Username = @"prhtnsm",
diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapRecommendations.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapRecommendations.cs
index c22b6a54e9..68d5836cac 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapRecommendations.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapRecommendations.cs
@@ -9,6 +9,7 @@ using osu.Framework.Testing;
 using osu.Game.Beatmaps;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Catch;
 using osu.Game.Rulesets.Mania;
@@ -40,9 +41,9 @@ namespace osu.Game.Tests.Visual.SongSelect
 
             base.SetUpSteps();
 
-            User getUser(int? rulesetID)
+            APIUser getUser(int? rulesetID)
             {
-                return new User
+                return new APIUser
                 {
                     Username = @"Dummy",
                     Id = 1001,
diff --git a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
index 4811fc979e..4861354921 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
@@ -18,6 +18,7 @@ using osu.Framework.Testing;
 using osu.Game.Beatmaps;
 using osu.Game.Configuration;
 using osu.Game.Graphics.UserInterface;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Mods;
@@ -29,7 +30,6 @@ using osu.Game.Screens.Play;
 using osu.Game.Screens.Select;
 using osu.Game.Screens.Select.Carousel;
 using osu.Game.Screens.Select.Filter;
-using osu.Game.Users;
 using osuTK.Input;
 
 namespace osu.Game.Tests.Visual.SongSelect
@@ -807,7 +807,7 @@ namespace osu.Game.Tests.Visual.SongSelect
 
                 songSelect.PresentScore(new ScoreInfo
                 {
-                    User = new User { Username = "woo" },
+                    User = new APIUser { Username = "woo" },
                     BeatmapInfo = getPresentBeatmap(),
                     Ruleset = getPresentBeatmap().Ruleset
                 });
@@ -839,7 +839,7 @@ namespace osu.Game.Tests.Visual.SongSelect
 
                 songSelect.PresentScore(new ScoreInfo
                 {
-                    User = new User { Username = "woo" },
+                    User = new APIUser { Username = "woo" },
                     BeatmapInfo = getPresentBeatmap(),
                     Ruleset = getPresentBeatmap().Ruleset
                 });
diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneUserTopScoreContainer.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneUserTopScoreContainer.cs
index b8b8792b9b..7af9e9eb40 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneUserTopScoreContainer.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneUserTopScoreContainer.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.Game.Online.API.Requests.Responses;
 using osuTK.Graphics;
 using osu.Game.Online.Leaderboards;
 using osu.Game.Overlays;
@@ -60,7 +61,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                     MaxCombo = 244,
                     TotalScore = 1707827,
                     Mods = new Mod[] { new OsuModHidden(), new OsuModHardRock(), },
-                    User = new User
+                    User = new APIUser
                     {
                         Id = 6602580,
                         Username = @"waaiiru",
@@ -78,7 +79,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                     Accuracy = 1,
                     MaxCombo = 244,
                     TotalScore = 1707827,
-                    User = new User
+                    User = new APIUser
                     {
                         Id = 4608074,
                         Username = @"Skycries",
@@ -96,7 +97,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                     Accuracy = 1,
                     MaxCombo = 244,
                     TotalScore = 1707827,
-                    User = new User
+                    User = new APIUser
                     {
                         Id = 1541390,
                         Username = @"Toukai",
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneDashboardBeatmapListing.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneDashboardBeatmapListing.cs
index 06c64a566e..17ac812eb0 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneDashboardBeatmapListing.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneDashboardBeatmapListing.cs
@@ -7,11 +7,11 @@ using osu.Game.Overlays.Dashboard.Home;
 using osu.Game.Beatmaps;
 using osu.Game.Overlays;
 using osu.Framework.Allocation;
-using osu.Game.Users;
 using System;
 using osu.Framework.Graphics.Shapes;
 using System.Collections.Generic;
 using osu.Game.Online.API.Requests.Responses;
+using APIUser = osu.Game.Online.API.Requests.Responses.APIUser;
 
 namespace osu.Game.Tests.Visual.UserInterface
 {
@@ -62,7 +62,7 @@ namespace osu.Game.Tests.Visual.UserInterface
             {
                 Title = "Very Long Title (TV size) [TATOE]",
                 Artist = "This artist has a really long name how is this possible",
-                Author = new User
+                Author = new APIUser
                 {
                     Username = "author",
                     Id = 100
@@ -77,7 +77,7 @@ namespace osu.Game.Tests.Visual.UserInterface
             {
                 Title = "Very Long Title (TV size) [TATOE]",
                 Artist = "This artist has a really long name how is this possible",
-                Author = new User
+                Author = new APIUser
                 {
                     Username = "author",
                     Id = 100
@@ -96,7 +96,7 @@ namespace osu.Game.Tests.Visual.UserInterface
             {
                 Title = "Very Long Title (TV size) [TATOE]",
                 Artist = "This artist has a really long name how is this possible",
-                Author = new User
+                Author = new APIUser
                 {
                     Username = "author",
                     Id = 100
@@ -111,7 +111,7 @@ namespace osu.Game.Tests.Visual.UserInterface
             {
                 Title = "Very Long Title (TV size) [TATOE]",
                 Artist = "This artist has a really long name how is this possible",
-                Author = new User
+                Author = new APIUser
                 {
                     Username = "author",
                     Id = 100
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
index 9a75d3c309..07759d598e 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
@@ -15,13 +15,13 @@ using osu.Game.Beatmaps;
 using osu.Game.Database;
 using osu.Game.Graphics.Cursor;
 using osu.Game.Graphics.UserInterface;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Leaderboards;
 using osu.Game.Overlays;
 using osu.Game.Rulesets;
 using osu.Game.Scoring;
 using osu.Game.Screens.Select.Leaderboards;
 using osu.Game.Tests.Resources;
-using osu.Game.Users;
 using osuTK;
 using osuTK.Input;
 
@@ -64,7 +64,7 @@ namespace osu.Game.Tests.Visual.UserInterface
                                 ID = 1,
                                 Title = "TestSong",
                                 Artist = "TestArtist",
-                                Author = new User
+                                Author = new APIUser
                                 {
                                     Username = "TestAuthor"
                                 },
@@ -98,7 +98,7 @@ namespace osu.Game.Tests.Visual.UserInterface
                     TotalScore = RNG.Next(1, 1000000),
                     MaxCombo = RNG.Next(1, 1000),
                     Rank = ScoreRank.XH,
-                    User = new User { Username = "TestUser" },
+                    User = new APIUser { Username = "TestUser" },
                 };
 
                 importedScores.Add(scoreManager.Import(score).Result.Value);
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneFriendsOnlineStatusControl.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneFriendsOnlineStatusControl.cs
index 9fa5c83dba..ea3cfbd497 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneFriendsOnlineStatusControl.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneFriendsOnlineStatusControl.cs
@@ -6,9 +6,9 @@ using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays;
 using osu.Game.Overlays.Dashboard.Friends;
-using osu.Game.Users;
 
 namespace osu.Game.Tests.Visual.UserInterface
 {
@@ -29,17 +29,17 @@ namespace osu.Game.Tests.Visual.UserInterface
         [Test]
         public void Populate()
         {
-            AddStep("Populate", () => control.Populate(new List<User>
+            AddStep("Populate", () => control.Populate(new List<APIUser>
             {
-                new User
+                new APIUser
                 {
                     IsOnline = true
                 },
-                new User
+                new APIUser
                 {
                     IsOnline = false
                 },
-                new User
+                new APIUser
                 {
                     IsOnline = false
                 }
diff --git a/osu.Game.Tournament.Tests/Components/TestSceneDrawableTournamentTeam.cs b/osu.Game.Tournament.Tests/Components/TestSceneDrawableTournamentTeam.cs
index 376c59ec2d..bb47683be1 100644
--- a/osu.Game.Tournament.Tests/Components/TestSceneDrawableTournamentTeam.cs
+++ b/osu.Game.Tournament.Tests/Components/TestSceneDrawableTournamentTeam.cs
@@ -3,13 +3,13 @@
 
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Tests.Visual;
 using osu.Game.Tournament.Components;
 using osu.Game.Tournament.Models;
 using osu.Game.Tournament.Screens.Drawings.Components;
 using osu.Game.Tournament.Screens.Gameplay.Components;
 using osu.Game.Tournament.Screens.Ladder.Components;
-using osu.Game.Users;
 
 namespace osu.Game.Tournament.Tests.Components
 {
@@ -24,13 +24,13 @@ namespace osu.Game.Tournament.Tests.Components
                 FullName = { Value = "Australia" },
                 Players =
                 {
-                    new User { Username = "ASecretBox" },
-                    new User { Username = "Dereban" },
-                    new User { Username = "mReKk" },
-                    new User { Username = "uyghti" },
-                    new User { Username = "Parkes" },
-                    new User { Username = "Shiroha" },
-                    new User { Username = "Jordan The Bear" },
+                    new APIUser { Username = "ASecretBox" },
+                    new APIUser { Username = "Dereban" },
+                    new APIUser { Username = "mReKk" },
+                    new APIUser { Username = "uyghti" },
+                    new APIUser { Username = "Parkes" },
+                    new APIUser { Username = "Shiroha" },
+                    new APIUser { Username = "Jordan The Bear" },
                 }
             };
 
diff --git a/osu.Game.Tournament.Tests/Components/TestSceneTournamentMatchChatDisplay.cs b/osu.Game.Tournament.Tests/Components/TestSceneTournamentMatchChatDisplay.cs
index 9905e17824..05989566c3 100644
--- a/osu.Game.Tournament.Tests/Components/TestSceneTournamentMatchChatDisplay.cs
+++ b/osu.Game.Tournament.Tests/Components/TestSceneTournamentMatchChatDisplay.cs
@@ -4,12 +4,12 @@
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Chat;
 using osu.Game.Tests.Visual;
 using osu.Game.Tournament.Components;
 using osu.Game.Tournament.IPC;
 using osu.Game.Tournament.Models;
-using osu.Game.Users;
 
 namespace osu.Game.Tournament.Tests.Components
 {
@@ -18,20 +18,20 @@ namespace osu.Game.Tournament.Tests.Components
         private readonly Channel testChannel = new Channel();
         private readonly Channel testChannel2 = new Channel();
 
-        private readonly User admin = new User
+        private readonly APIUser admin = new APIUser
         {
             Username = "HappyStick",
             Id = 2,
             Colour = "f2ca34"
         };
 
-        private readonly User redUser = new User
+        private readonly APIUser redUser = new APIUser
         {
             Username = "BanchoBot",
             Id = 3,
         };
 
-        private readonly User blueUser = new User
+        private readonly APIUser blueUser = new APIUser
         {
             Username = "Zallius",
             Id = 4,
@@ -57,11 +57,11 @@ namespace osu.Game.Tournament.Tests.Components
             {
                 Team1 =
                 {
-                    Value = new TournamentTeam { Players = new BindableList<User> { redUser } }
+                    Value = new TournamentTeam { Players = new BindableList<APIUser> { redUser } }
                 },
                 Team2 =
                 {
-                    Value = new TournamentTeam { Players = new BindableList<User> { blueUser } }
+                    Value = new TournamentTeam { Players = new BindableList<APIUser> { blueUser } }
                 }
             };
 
diff --git a/osu.Game.Tournament.Tests/TournamentTestScene.cs b/osu.Game.Tournament.Tests/TournamentTestScene.cs
index 81741a43a9..8c05b4e915 100644
--- a/osu.Game.Tournament.Tests/TournamentTestScene.cs
+++ b/osu.Game.Tournament.Tests/TournamentTestScene.cs
@@ -14,6 +14,7 @@ using osu.Game.Tournament.IO;
 using osu.Game.Tournament.IPC;
 using osu.Game.Tournament.Models;
 using osu.Game.Users;
+using APIUser = osu.Game.Online.API.Requests.Responses.APIUser;
 
 namespace osu.Game.Tournament.Tests
 {
@@ -120,11 +121,11 @@ namespace osu.Game.Tournament.Tests
                     },
                     Players =
                     {
-                        new User { Username = "Hello", Statistics = new UserStatistics { GlobalRank = 12 } },
-                        new User { Username = "Hello", Statistics = new UserStatistics { GlobalRank = 16 } },
-                        new User { Username = "Hello", Statistics = new UserStatistics { GlobalRank = 20 } },
-                        new User { Username = "Hello", Statistics = new UserStatistics { GlobalRank = 24 } },
-                        new User { Username = "Hello", Statistics = new UserStatistics { GlobalRank = 30 } },
+                        new APIUser { Username = "Hello", Statistics = new UserStatistics { GlobalRank = 12 } },
+                        new APIUser { Username = "Hello", Statistics = new UserStatistics { GlobalRank = 16 } },
+                        new APIUser { Username = "Hello", Statistics = new UserStatistics { GlobalRank = 20 } },
+                        new APIUser { Username = "Hello", Statistics = new UserStatistics { GlobalRank = 24 } },
+                        new APIUser { Username = "Hello", Statistics = new UserStatistics { GlobalRank = 30 } },
                     }
                 }
             },
@@ -137,11 +138,11 @@ namespace osu.Game.Tournament.Tests
                     FullName = { Value = "United States" },
                     Players =
                     {
-                        new User { Username = "Hello" },
-                        new User { Username = "Hello" },
-                        new User { Username = "Hello" },
-                        new User { Username = "Hello" },
-                        new User { Username = "Hello" },
+                        new APIUser { Username = "Hello" },
+                        new APIUser { Username = "Hello" },
+                        new APIUser { Username = "Hello" },
+                        new APIUser { Username = "Hello" },
+                        new APIUser { Username = "Hello" },
                     }
                 }
             },
diff --git a/osu.Game.Tournament/Components/DrawableTeamWithPlayers.cs b/osu.Game.Tournament/Components/DrawableTeamWithPlayers.cs
index e949bf9881..4d9afc23ac 100644
--- a/osu.Game.Tournament/Components/DrawableTeamWithPlayers.cs
+++ b/osu.Game.Tournament/Components/DrawableTeamWithPlayers.cs
@@ -5,8 +5,8 @@ using System.Linq;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Graphics;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Tournament.Models;
-using osu.Game.Users;
 using osuTK;
 using osuTK.Graphics;
 
@@ -54,7 +54,7 @@ namespace osu.Game.Tournament.Components
                 },
             };
 
-            TournamentSpriteText createPlayerText(User p) =>
+            TournamentSpriteText createPlayerText(APIUser p) =>
                 new TournamentSpriteText
                 {
                     Text = p.Username,
diff --git a/osu.Game.Tournament/Models/TournamentTeam.cs b/osu.Game.Tournament/Models/TournamentTeam.cs
index d895e4b538..24dee3b372 100644
--- a/osu.Game.Tournament/Models/TournamentTeam.cs
+++ b/osu.Game.Tournament/Models/TournamentTeam.cs
@@ -5,7 +5,7 @@ using System;
 using System.Linq;
 using Newtonsoft.Json;
 using osu.Framework.Bindables;
-using osu.Game.Users;
+using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Tournament.Models
 {
@@ -57,7 +57,7 @@ namespace osu.Game.Tournament.Models
         };
 
         [JsonProperty]
-        public BindableList<User> Players { get; set; } = new BindableList<User>();
+        public BindableList<APIUser> Players { get; set; } = new BindableList<APIUser>();
 
         public TournamentTeam()
         {
diff --git a/osu.Game.Tournament/Screens/Editors/TeamEditorScreen.cs b/osu.Game.Tournament/Screens/Editors/TeamEditorScreen.cs
index 0d2e64f300..6adddb5204 100644
--- a/osu.Game.Tournament/Screens/Editors/TeamEditorScreen.cs
+++ b/osu.Game.Tournament/Screens/Editors/TeamEditorScreen.cs
@@ -13,6 +13,7 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
 using osu.Game.Graphics;
 using osu.Game.Online.API;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays.Settings;
 using osu.Game.Tournament.Components;
 using osu.Game.Tournament.Models;
@@ -199,14 +200,14 @@ namespace osu.Game.Tournament.Screens.Editors
 
                 public void CreateNew()
                 {
-                    var user = new User();
+                    var user = new APIUser();
                     team.Players.Add(user);
                     flow.Add(new PlayerRow(team, user));
                 }
 
                 public class PlayerRow : CompositeDrawable
                 {
-                    private readonly User user;
+                    private readonly APIUser user;
 
                     [Resolved]
                     protected IAPIProvider API { get; private set; }
@@ -218,7 +219,7 @@ namespace osu.Game.Tournament.Screens.Editors
 
                     private readonly Container drawableContainer;
 
-                    public PlayerRow(TournamentTeam team, User user)
+                    public PlayerRow(TournamentTeam team, APIUser user)
                     {
                         this.user = user;
 
diff --git a/osu.Game.Tournament/TournamentGameBase.cs b/osu.Game.Tournament/TournamentGameBase.cs
index ee281466a2..d2f146c4c2 100644
--- a/osu.Game.Tournament/TournamentGameBase.cs
+++ b/osu.Game.Tournament/TournamentGameBase.cs
@@ -18,8 +18,8 @@ using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Tournament.IO;
 using osu.Game.Tournament.IPC;
 using osu.Game.Tournament.Models;
-using osu.Game.Users;
 using osuTK.Input;
+using APIUser = osu.Game.Online.API.Requests.Responses.APIUser;
 
 namespace osu.Game.Tournament
 {
@@ -241,7 +241,7 @@ namespace osu.Game.Tournament
 
         private void updateLoadProgressMessage(string s) => Schedule(() => initialisationText.Text = s);
 
-        public void PopulateUser(User user, Action success = null, Action failure = null, bool immediate = false)
+        public void PopulateUser(APIUser user, Action success = null, Action failure = null, bool immediate = false)
         {
             var req = new GetUserRequest(user.Id, Ruleset.Value);
 
diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index 7a9f3e0a45..680574cfc8 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -18,10 +18,10 @@ using osu.Game.Database;
 using osu.Game.IO;
 using osu.Game.IO.Archives;
 using osu.Game.Online.API;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays.Notifications;
 using osu.Game.Rulesets;
 using osu.Game.Skinning;
-using osu.Game.Users;
 
 namespace osu.Game.Beatmaps
 {
@@ -68,7 +68,7 @@ namespace osu.Game.Beatmaps
         /// <summary>
         /// Create a new <see cref="WorkingBeatmap"/>.
         /// </summary>
-        public WorkingBeatmap CreateNew(RulesetInfo ruleset, User user)
+        public WorkingBeatmap CreateNew(RulesetInfo ruleset, APIUser user)
         {
             var metadata = new BeatmapMetadata
             {
@@ -262,7 +262,7 @@ namespace osu.Game.Beatmaps
                     Artist = model.Metadata?.Artist ?? string.Empty,
                     TitleUnicode = model.Metadata?.TitleUnicode ?? string.Empty,
                     ArtistUnicode = model.Metadata?.ArtistUnicode ?? string.Empty,
-                    Author = new User { Username = model.Metadata?.Author },
+                    Author = new APIUser { Username = model.Metadata?.Author },
                 }
             }, minimiseDownloadSize);
         }
diff --git a/osu.Game/Beatmaps/BeatmapMetadata.cs b/osu.Game/Beatmaps/BeatmapMetadata.cs
index 5d3b4007ae..60e3bcc98d 100644
--- a/osu.Game/Beatmaps/BeatmapMetadata.cs
+++ b/osu.Game/Beatmaps/BeatmapMetadata.cs
@@ -7,7 +7,7 @@ using System.ComponentModel.DataAnnotations.Schema;
 using Newtonsoft.Json;
 using osu.Framework.Testing;
 using osu.Game.Database;
-using osu.Game.Users;
+using osu.Game.Online.API.Requests.Responses;
 
 #nullable enable
 
@@ -36,7 +36,7 @@ namespace osu.Game.Beatmaps
         public List<BeatmapSetInfo> BeatmapSets { get; set; } = new List<BeatmapSetInfo>();
 
         /// <summary>
-        /// Helper property to deserialize a username to <see cref="User"/>.
+        /// Helper property to deserialize a username to <see cref="APIUser"/>.
         /// </summary>
         [JsonProperty(@"user_id")]
         [Column("AuthorID")]
@@ -45,13 +45,13 @@ namespace osu.Game.Beatmaps
             get => Author?.Id ?? 1;
             set
             {
-                Author ??= new User();
+                Author ??= new APIUser();
                 Author.Id = value;
             }
         }
 
         /// <summary>
-        /// Helper property to deserialize a username to <see cref="User"/>.
+        /// Helper property to deserialize a username to <see cref="APIUser"/>.
         /// </summary>
         [JsonProperty(@"creator")]
         [Column("Author")]
@@ -60,7 +60,7 @@ namespace osu.Game.Beatmaps
             get => Author?.Username ?? string.Empty;
             set
             {
-                Author ??= new User();
+                Author ??= new APIUser();
                 Author.Username = value;
             }
         }
@@ -69,7 +69,7 @@ namespace osu.Game.Beatmaps
         /// The author of the beatmaps in this set.
         /// </summary>
         [JsonIgnore]
-        public User? Author;
+        public APIUser? Author;
 
         public string Source { get; set; } = string.Empty;
 
diff --git a/osu.Game/Database/UserLookupCache.cs b/osu.Game/Database/UserLookupCache.cs
index 3626f5e83a..dae2d2549c 100644
--- a/osu.Game/Database/UserLookupCache.cs
+++ b/osu.Game/Database/UserLookupCache.cs
@@ -9,33 +9,33 @@ using JetBrains.Annotations;
 using osu.Framework.Allocation;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests;
-using osu.Game.Users;
+using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Database
 {
-    public class UserLookupCache : MemoryCachingComponent<int, User>
+    public class UserLookupCache : MemoryCachingComponent<int, APIUser>
     {
         [Resolved]
         private IAPIProvider api { get; set; }
 
         /// <summary>
-        /// Perform an API lookup on the specified user, populating a <see cref="User"/> model.
+        /// Perform an API lookup on the specified user, populating a <see cref="APIUser"/> model.
         /// </summary>
         /// <param name="userId">The user to lookup.</param>
         /// <param name="token">An optional cancellation token.</param>
         /// <returns>The populated user, or null if the user does not exist or the request could not be satisfied.</returns>
         [ItemCanBeNull]
-        public Task<User> GetUserAsync(int userId, CancellationToken token = default) => GetAsync(userId, token);
+        public Task<APIUser> GetUserAsync(int userId, CancellationToken token = default) => GetAsync(userId, token);
 
         /// <summary>
-        /// Perform an API lookup on the specified users, populating a <see cref="User"/> model.
+        /// Perform an API lookup on the specified users, populating a <see cref="APIUser"/> model.
         /// </summary>
         /// <param name="userIds">The users to lookup.</param>
         /// <param name="token">An optional cancellation token.</param>
         /// <returns>The populated users. May include null results for failed retrievals.</returns>
-        public Task<User[]> GetUsersAsync(int[] userIds, CancellationToken token = default)
+        public Task<APIUser[]> GetUsersAsync(int[] userIds, CancellationToken token = default)
         {
-            var userLookupTasks = new List<Task<User>>();
+            var userLookupTasks = new List<Task<APIUser>>();
 
             foreach (int u in userIds)
             {
@@ -51,18 +51,18 @@ namespace osu.Game.Database
             return Task.WhenAll(userLookupTasks);
         }
 
-        protected override async Task<User> ComputeValueAsync(int lookup, CancellationToken token = default)
+        protected override async Task<APIUser> ComputeValueAsync(int lookup, CancellationToken token = default)
             => await queryUser(lookup).ConfigureAwait(false);
 
-        private readonly Queue<(int id, TaskCompletionSource<User>)> pendingUserTasks = new Queue<(int, TaskCompletionSource<User>)>();
+        private readonly Queue<(int id, TaskCompletionSource<APIUser>)> pendingUserTasks = new Queue<(int, TaskCompletionSource<APIUser>)>();
         private Task pendingRequestTask;
         private readonly object taskAssignmentLock = new object();
 
-        private Task<User> queryUser(int userId)
+        private Task<APIUser> queryUser(int userId)
         {
             lock (taskAssignmentLock)
             {
-                var tcs = new TaskCompletionSource<User>();
+                var tcs = new TaskCompletionSource<APIUser>();
 
                 // Add to the queue.
                 pendingUserTasks.Enqueue((userId, tcs));
@@ -78,14 +78,14 @@ namespace osu.Game.Database
         private void performLookup()
         {
             // contains at most 50 unique user IDs from userTasks, which is used to perform the lookup.
-            var userTasks = new Dictionary<int, List<TaskCompletionSource<User>>>();
+            var userTasks = new Dictionary<int, List<TaskCompletionSource<APIUser>>>();
 
             // Grab at most 50 unique user IDs from the queue.
             lock (taskAssignmentLock)
             {
                 while (pendingUserTasks.Count > 0 && userTasks.Count < 50)
                 {
-                    (int id, TaskCompletionSource<User> task) next = pendingUserTasks.Dequeue();
+                    (int id, TaskCompletionSource<APIUser> task) next = pendingUserTasks.Dequeue();
 
                     // Perform a secondary check for existence, in case the user was queried in a previous batch.
                     if (CheckExists(next.id, out var existing))
@@ -95,7 +95,7 @@ namespace osu.Game.Database
                         if (userTasks.TryGetValue(next.id, out var tasks))
                             tasks.Add(next.task);
                         else
-                            userTasks[next.id] = new List<TaskCompletionSource<User>> { next.task };
+                            userTasks[next.id] = new List<TaskCompletionSource<APIUser>> { next.task };
                     }
                 }
             }
@@ -115,7 +115,7 @@ namespace osu.Game.Database
                     createNewTask();
             }
 
-            List<User> foundUsers = request.Response?.Users;
+            List<APIUser> foundUsers = request.Response?.Users;
 
             if (foundUsers != null)
             {
diff --git a/osu.Game/Graphics/Containers/LinkFlowContainer.cs b/osu.Game/Graphics/Containers/LinkFlowContainer.cs
index 7d1210d0e3..48f6c36993 100644
--- a/osu.Game/Graphics/Containers/LinkFlowContainer.cs
+++ b/osu.Game/Graphics/Containers/LinkFlowContainer.cs
@@ -11,7 +11,7 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Localisation;
 using osu.Framework.Platform;
-using osu.Game.Users;
+using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Graphics.Containers
 {
@@ -70,7 +70,7 @@ namespace osu.Game.Graphics.Containers
             createLink(new TextPartManual(text), new LinkDetails(action, linkArgument), tooltipText);
         }
 
-        public void AddUserLink(User user, Action<SpriteText> creationParameters = null)
+        public void AddUserLink(APIUser user, Action<SpriteText> creationParameters = null)
             => createLink(CreateChunkFor(user.Username, true, CreateSpriteText, creationParameters), new LinkDetails(LinkAction.OpenUserProfile, user.Id.ToString()), "view profile");
 
         private void createLink(ITextPart textPart, LinkDetails link, LocalisableString tooltipText, Action action = null)
diff --git a/osu.Game/Online/API/APIAccess.cs b/osu.Game/Online/API/APIAccess.cs
index 94508e3a81..8d91548149 100644
--- a/osu.Game/Online/API/APIAccess.cs
+++ b/osu.Game/Online/API/APIAccess.cs
@@ -17,6 +17,7 @@ using osu.Framework.Graphics;
 using osu.Framework.Logging;
 using osu.Game.Configuration;
 using osu.Game.Online.API.Requests;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Users;
 
 namespace osu.Game.Online.API
@@ -41,13 +42,13 @@ namespace osu.Game.Online.API
 
         private string password;
 
-        public IBindable<User> LocalUser => localUser;
-        public IBindableList<User> Friends => friends;
+        public IBindable<APIUser> LocalUser => localUser;
+        public IBindableList<APIUser> Friends => friends;
         public IBindable<UserActivity> Activity => activity;
 
-        private Bindable<User> localUser { get; } = new Bindable<User>(createGuestUser());
+        private Bindable<APIUser> localUser { get; } = new Bindable<APIUser>(createGuestUser());
 
-        private BindableList<User> friends { get; } = new BindableList<User>();
+        private BindableList<APIUser> friends { get; } = new BindableList<APIUser>();
 
         private Bindable<UserActivity> activity { get; } = new Bindable<UserActivity>();
 
@@ -436,7 +437,7 @@ namespace osu.Game.Online.API
             flushQueue();
         }
 
-        private static User createGuestUser() => new GuestUser();
+        private static APIUser createGuestUser() => new GuestUser();
 
         protected override void Dispose(bool isDisposing)
         {
@@ -447,7 +448,7 @@ namespace osu.Game.Online.API
         }
     }
 
-    internal class GuestUser : User
+    internal class GuestUser : APIUser
     {
         public GuestUser()
         {
diff --git a/osu.Game/Online/API/APIRequest.cs b/osu.Game/Online/API/APIRequest.cs
index 69d72226ba..43195811dc 100644
--- a/osu.Game/Online/API/APIRequest.cs
+++ b/osu.Game/Online/API/APIRequest.cs
@@ -6,7 +6,7 @@ using JetBrains.Annotations;
 using Newtonsoft.Json;
 using osu.Framework.IO.Network;
 using osu.Framework.Logging;
-using osu.Game.Users;
+using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Online.API
 {
@@ -69,7 +69,7 @@ namespace osu.Game.Online.API
         /// <summary>
         /// The currently logged in user. Note that this will only be populated during <see cref="Perform"/>.
         /// </summary>
-        protected User User { get; private set; }
+        protected APIUser User { get; private set; }
 
         /// <summary>
         /// Invoked on successful completion of an API request.
diff --git a/osu.Game/Online/API/DummyAPIAccess.cs b/osu.Game/Online/API/DummyAPIAccess.cs
index 8f91a4d198..7131c3a7d4 100644
--- a/osu.Game/Online/API/DummyAPIAccess.cs
+++ b/osu.Game/Online/API/DummyAPIAccess.cs
@@ -6,19 +6,20 @@ using System.Threading;
 using System.Threading.Tasks;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Users;
 
 namespace osu.Game.Online.API
 {
     public class DummyAPIAccess : Component, IAPIProvider
     {
-        public Bindable<User> LocalUser { get; } = new Bindable<User>(new User
+        public Bindable<APIUser> LocalUser { get; } = new Bindable<APIUser>(new APIUser
         {
             Username = @"Dummy",
             Id = 1001,
         });
 
-        public BindableList<User> Friends { get; } = new BindableList<User>();
+        public BindableList<APIUser> Friends { get; } = new BindableList<APIUser>();
 
         public Bindable<UserActivity> Activity { get; } = new Bindable<UserActivity>();
 
@@ -90,7 +91,7 @@ namespace osu.Game.Online.API
             }
 
             LastLoginError = null;
-            LocalUser.Value = new User
+            LocalUser.Value = new APIUser
             {
                 Username = username,
                 Id = 1001,
@@ -115,8 +116,8 @@ namespace osu.Game.Online.API
 
         public void SetState(APIState newState) => state.Value = newState;
 
-        IBindable<User> IAPIProvider.LocalUser => LocalUser;
-        IBindableList<User> IAPIProvider.Friends => Friends;
+        IBindable<APIUser> IAPIProvider.LocalUser => LocalUser;
+        IBindableList<APIUser> IAPIProvider.Friends => Friends;
         IBindable<UserActivity> IAPIProvider.Activity => Activity;
 
         public void FailNextLogin() => shouldFailNextLogin = true;
diff --git a/osu.Game/Online/API/IAPIProvider.cs b/osu.Game/Online/API/IAPIProvider.cs
index 72ca37bcf4..a97eae77e3 100644
--- a/osu.Game/Online/API/IAPIProvider.cs
+++ b/osu.Game/Online/API/IAPIProvider.cs
@@ -6,6 +6,7 @@
 using System;
 using System.Threading.Tasks;
 using osu.Framework.Bindables;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Users;
 
 namespace osu.Game.Online.API
@@ -16,13 +17,13 @@ namespace osu.Game.Online.API
         /// The local user.
         /// This is not thread-safe and should be scheduled locally if consumed from a drawable component.
         /// </summary>
-        IBindable<User> LocalUser { get; }
+        IBindable<APIUser> LocalUser { get; }
 
         /// <summary>
         /// The user's friends.
         /// This is not thread-safe and should be scheduled locally if consumed from a drawable component.
         /// </summary>
-        IBindableList<User> Friends { get; }
+        IBindableList<APIUser> Friends { get; }
 
         /// <summary>
         /// The current user's activity.
diff --git a/osu.Game/Online/API/Requests/CreateNewPrivateMessageRequest.cs b/osu.Game/Online/API/Requests/CreateNewPrivateMessageRequest.cs
index 37ffc04e04..e5761149e7 100644
--- a/osu.Game/Online/API/Requests/CreateNewPrivateMessageRequest.cs
+++ b/osu.Game/Online/API/Requests/CreateNewPrivateMessageRequest.cs
@@ -3,17 +3,17 @@
 
 using System.Net.Http;
 using osu.Framework.IO.Network;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Chat;
-using osu.Game.Users;
 
 namespace osu.Game.Online.API.Requests
 {
     public class CreateNewPrivateMessageRequest : APIRequest<CreateNewPrivateMessageResponse>
     {
-        private readonly User user;
+        private readonly APIUser user;
         private readonly Message message;
 
-        public CreateNewPrivateMessageRequest(User user, Message message)
+        public CreateNewPrivateMessageRequest(APIUser user, Message message)
         {
             this.user = user;
             this.message = message;
diff --git a/osu.Game/Online/API/Requests/GetFriendsRequest.cs b/osu.Game/Online/API/Requests/GetFriendsRequest.cs
index 46890aa889..63a221d91a 100644
--- a/osu.Game/Online/API/Requests/GetFriendsRequest.cs
+++ b/osu.Game/Online/API/Requests/GetFriendsRequest.cs
@@ -2,11 +2,11 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System.Collections.Generic;
-using osu.Game.Users;
+using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Online.API.Requests
 {
-    public class GetFriendsRequest : APIRequest<List<User>>
+    public class GetFriendsRequest : APIRequest<List<APIUser>>
     {
         protected override string Target => @"friends";
     }
diff --git a/osu.Game/Online/API/Requests/GetUserRequest.cs b/osu.Game/Online/API/Requests/GetUserRequest.cs
index 730e4e02ed..e32451fc2f 100644
--- a/osu.Game/Online/API/Requests/GetUserRequest.cs
+++ b/osu.Game/Online/API/Requests/GetUserRequest.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.Game.Users;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets;
 
 namespace osu.Game.Online.API.Requests
 {
-    public class GetUserRequest : APIRequest<User>
+    public class GetUserRequest : APIRequest<APIUser>
     {
         public readonly string Lookup;
         public readonly RulesetInfo Ruleset;
diff --git a/osu.Game/Online/API/Requests/GetUsersResponse.cs b/osu.Game/Online/API/Requests/GetUsersResponse.cs
index 6f49d5cd53..022050de5c 100644
--- a/osu.Game/Online/API/Requests/GetUsersResponse.cs
+++ b/osu.Game/Online/API/Requests/GetUsersResponse.cs
@@ -3,13 +3,13 @@
 
 using System.Collections.Generic;
 using Newtonsoft.Json;
-using osu.Game.Users;
+using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Online.API.Requests
 {
     public class GetUsersResponse : ResponseWithCursor
     {
         [JsonProperty("users")]
-        public List<User> Users;
+        public List<APIUser> Users;
     }
 }
diff --git a/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs b/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs
index 47536879b2..f8a0acf96e 100644
--- a/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs
@@ -6,7 +6,6 @@ using System.Collections.Generic;
 using Newtonsoft.Json;
 using osu.Game.Beatmaps;
 using osu.Game.Database;
-using osu.Game.Users;
 
 #nullable enable
 
@@ -72,10 +71,10 @@ namespace osu.Game.Online.API.Requests.Responses
         [JsonProperty("artist_unicode")]
         public string ArtistUnicode { get; set; } = string.Empty;
 
-        public User? Author = new User();
+        public APIUser? Author = new APIUser();
 
         /// <summary>
-        /// Helper property to deserialize a username to <see cref="User"/>.
+        /// Helper property to deserialize a username to <see cref="APIUser"/>.
         /// </summary>
         [JsonProperty(@"user_id")]
         public int AuthorID
@@ -83,13 +82,13 @@ namespace osu.Game.Online.API.Requests.Responses
             get => Author?.Id ?? 1;
             set
             {
-                Author ??= new User();
+                Author ??= new APIUser();
                 Author.Id = value;
             }
         }
 
         /// <summary>
-        /// Helper property to deserialize a username to <see cref="User"/>.
+        /// Helper property to deserialize a username to <see cref="APIUser"/>.
         /// </summary>
         [JsonProperty(@"creator")]
         public string AuthorString
@@ -97,7 +96,7 @@ namespace osu.Game.Online.API.Requests.Responses
             get => Author?.Username ?? string.Empty;
             set
             {
-                Author ??= new User();
+                Author ??= new APIUser();
                 Author.Username = value;
             }
         }
diff --git a/osu.Game/Online/API/Requests/Responses/APIPlayStyle.cs b/osu.Game/Online/API/Requests/Responses/APIPlayStyle.cs
new file mode 100644
index 0000000000..9573ae1825
--- /dev/null
+++ b/osu.Game/Online/API/Requests/Responses/APIPlayStyle.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 System.ComponentModel;
+
+namespace osu.Game.Online.API.Requests.Responses
+{
+    public enum APIPlayStyle
+    {
+        [Description("Keyboard")]
+        Keyboard,
+
+        [Description("Mouse")]
+        Mouse,
+
+        [Description("Tablet")]
+        Tablet,
+
+        [Description("Touch Screen")]
+        Touch,
+    }
+}
diff --git a/osu.Game/Online/API/Requests/Responses/APIScoreInfo.cs b/osu.Game/Online/API/Requests/Responses/APIScoreInfo.cs
index 82f56d27fd..d0677eacab 100644
--- a/osu.Game/Online/API/Requests/Responses/APIScoreInfo.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIScoreInfo.cs
@@ -12,7 +12,6 @@ using osu.Game.Rulesets;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Scoring;
 using osu.Game.Scoring.Legacy;
-using osu.Game.Users;
 
 namespace osu.Game.Online.API.Requests.Responses
 {
@@ -25,7 +24,7 @@ namespace osu.Game.Online.API.Requests.Responses
         public int MaxCombo { get; set; }
 
         [JsonProperty(@"user")]
-        public User User { get; set; }
+        public APIUser User { get; set; }
 
         [JsonProperty(@"id")]
         public long OnlineID { get; set; }
diff --git a/osu.Game/Online/API/Requests/Responses/APIUser.cs b/osu.Game/Online/API/Requests/Responses/APIUser.cs
index ff422b8292..aa5c556826 100644
--- a/osu.Game/Online/API/Requests/Responses/APIUser.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIUser.cs
@@ -1,14 +1,263 @@
 // 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 JetBrains.Annotations;
 using Newtonsoft.Json;
+using osu.Framework.Bindables;
 using osu.Game.Users;
 
 namespace osu.Game.Online.API.Requests.Responses
 {
-    public class APIUser
+    public class APIUser : IEquatable<APIUser>, IUser
     {
+        [JsonProperty(@"id")]
+        public int Id { get; set; } = 1;
+
+        [JsonProperty(@"join_date")]
+        public DateTimeOffset JoinDate;
+
+        [JsonProperty(@"username")]
+        public string Username { get; set; }
+
+        [JsonProperty(@"previous_usernames")]
+        public string[] PreviousUsernames;
+
+        [JsonProperty(@"country")]
+        public Country Country;
+
+        public readonly Bindable<UserStatus> Status = new Bindable<UserStatus>();
+
+        public readonly Bindable<UserActivity> Activity = new Bindable<UserActivity>();
+
+        [JsonProperty(@"profile_colour")]
+        public string Colour;
+
+        [JsonProperty(@"avatar_url")]
+        public string AvatarUrl;
+
+        [JsonProperty(@"cover_url")]
+        public string CoverUrl
+        {
+            get => Cover?.Url;
+            set => Cover = new UserCover { Url = value };
+        }
+
+        [JsonProperty(@"cover")]
+        public UserCover Cover;
+
+        public class UserCover
+        {
+            [JsonProperty(@"custom_url")]
+            public string CustomUrl;
+
+            [JsonProperty(@"url")]
+            public string Url;
+
+            [JsonProperty(@"id")]
+            public int? Id;
+        }
+
+        [JsonProperty(@"is_admin")]
+        public bool IsAdmin;
+
+        [JsonProperty(@"is_supporter")]
+        public bool IsSupporter;
+
+        [JsonProperty(@"support_level")]
+        public int SupportLevel;
+
+        [JsonProperty(@"is_gmt")]
+        public bool IsGMT;
+
+        [JsonProperty(@"is_qat")]
+        public bool IsQAT;
+
+        [JsonProperty(@"is_bng")]
+        public bool IsBNG;
+
+        [JsonProperty(@"is_bot")]
+        public bool IsBot;
+
+        [JsonProperty(@"is_active")]
+        public bool Active;
+
+        [JsonProperty(@"is_online")]
+        public bool IsOnline;
+
+        [JsonProperty(@"pm_friends_only")]
+        public bool PMFriendsOnly;
+
+        [JsonProperty(@"interests")]
+        public string Interests;
+
+        [JsonProperty(@"occupation")]
+        public string Occupation;
+
+        [JsonProperty(@"title")]
+        public string Title;
+
+        [JsonProperty(@"location")]
+        public string Location;
+
+        [JsonProperty(@"last_visit")]
+        public DateTimeOffset? LastVisit;
+
+        [JsonProperty(@"twitter")]
+        public string Twitter;
+
+        [JsonProperty(@"discord")]
+        public string Discord;
+
+        [JsonProperty(@"website")]
+        public string Website;
+
+        [JsonProperty(@"post_count")]
+        public int PostCount;
+
+        [JsonProperty(@"comments_count")]
+        public int CommentsCount;
+
+        [JsonProperty(@"follower_count")]
+        public int FollowerCount;
+
+        [JsonProperty(@"mapping_follower_count")]
+        public int MappingFollowerCount;
+
+        [JsonProperty(@"favourite_beatmapset_count")]
+        public int FavouriteBeatmapsetCount;
+
+        [JsonProperty(@"graveyard_beatmapset_count")]
+        public int GraveyardBeatmapsetCount;
+
+        [JsonProperty(@"loved_beatmapset_count")]
+        public int LovedBeatmapsetCount;
+
+        [JsonProperty(@"ranked_beatmapset_count")]
+        public int RankedBeatmapsetCount;
+
+        [JsonProperty(@"pending_beatmapset_count")]
+        public int PendingBeatmapsetCount;
+
+        [JsonProperty(@"scores_best_count")]
+        public int ScoresBestCount;
+
+        [JsonProperty(@"scores_first_count")]
+        public int ScoresFirstCount;
+
+        [JsonProperty(@"scores_recent_count")]
+        public int ScoresRecentCount;
+
+        [JsonProperty(@"beatmap_playcounts_count")]
+        public int BeatmapPlaycountsCount;
+
         [JsonProperty]
-        public User User;
+        private string[] playstyle
+        {
+            set => PlayStyles = value?.Select(str => Enum.Parse(typeof(APIPlayStyle), str, true)).Cast<APIPlayStyle>().ToArray();
+        }
+
+        public APIPlayStyle[] PlayStyles;
+
+        [JsonProperty(@"playmode")]
+        public string PlayMode;
+
+        [JsonProperty(@"profile_order")]
+        public string[] ProfileOrder;
+
+        [JsonProperty(@"kudosu")]
+        public KudosuCount Kudosu;
+
+        public class KudosuCount
+        {
+            [JsonProperty(@"total")]
+            public int Total;
+
+            [JsonProperty(@"available")]
+            public int Available;
+        }
+
+        private UserStatistics statistics;
+
+        /// <summary>
+        /// User statistics for the requested ruleset (in the case of a <see cref="GetUserRequest"/> or <see cref="GetFriendsRequest"/> response).
+        /// Otherwise empty.
+        /// </summary>
+        [JsonProperty(@"statistics")]
+        public UserStatistics Statistics
+        {
+            get => statistics ??= new UserStatistics();
+            set
+            {
+                if (statistics != null)
+                    // we may already have rank history populated
+                    value.RankHistory = statistics.RankHistory;
+
+                statistics = value;
+            }
+        }
+
+        [JsonProperty(@"rank_history")]
+        private RankHistoryData rankHistory
+        {
+            set => statistics.RankHistory = value;
+        }
+
+        public class RankHistoryData
+        {
+            [JsonProperty(@"mode")]
+            public string Mode;
+
+            [JsonProperty(@"data")]
+            public int[] Data;
+        }
+
+        [JsonProperty("badges")]
+        public Badge[] Badges;
+
+        [JsonProperty("user_achievements")]
+        public UserAchievement[] Achievements;
+
+        public class UserAchievement
+        {
+            [JsonProperty("achieved_at")]
+            public DateTimeOffset AchievedAt;
+
+            [JsonProperty("achievement_id")]
+            public int ID;
+        }
+
+        [JsonProperty("monthly_playcounts")]
+        public APIUserHistoryCount[] MonthlyPlaycounts;
+
+        [JsonProperty("replays_watched_counts")]
+        public APIUserHistoryCount[] ReplaysWatchedCounts;
+
+        /// <summary>
+        /// All user statistics per ruleset's short name (in the case of a <see cref="GetUsersRequest"/> response).
+        /// Otherwise empty. Can be altered for testing purposes.
+        /// </summary>
+        // todo: this should likely be moved to a separate UserCompact class at some point.
+        [JsonProperty("statistics_rulesets")]
+        [CanBeNull]
+        public Dictionary<string, UserStatistics> RulesetsStatistics { get; set; }
+
+        public override string ToString() => Username;
+
+        /// <summary>
+        /// A user instance for displaying locally created system messages.
+        /// </summary>
+        public static readonly APIUser SYSTEM_USER = new APIUser
+        {
+            Id = 0,
+            Username = "system",
+            Colour = @"9c0101",
+        };
+
+        public int OnlineID => Id;
+
+        public bool Equals(APIUser other) => OnlineID == other?.OnlineID;
     }
 }
diff --git a/osu.Game/Online/API/Requests/Responses/APIUserContainer.cs b/osu.Game/Online/API/Requests/Responses/APIUserContainer.cs
new file mode 100644
index 0000000000..9eb4a2a4e3
--- /dev/null
+++ b/osu.Game/Online/API/Requests/Responses/APIUserContainer.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 Newtonsoft.Json;
+
+namespace osu.Game.Online.API.Requests.Responses
+{
+    public class APIUserContainer
+    {
+        [JsonProperty]
+        public APIUser User;
+    }
+}
diff --git a/osu.Game/Online/API/Requests/Responses/APIUserHistoryCount.cs b/osu.Game/Online/API/Requests/Responses/APIUserHistoryCount.cs
new file mode 100644
index 0000000000..1226c88c08
--- /dev/null
+++ b/osu.Game/Online/API/Requests/Responses/APIUserHistoryCount.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 System;
+using Newtonsoft.Json;
+
+namespace osu.Game.Online.API.Requests.Responses
+{
+    public class APIUserHistoryCount
+    {
+        [JsonProperty("start_date")]
+        public DateTime Date;
+
+        [JsonProperty("count")]
+        public long Count;
+    }
+}
diff --git a/osu.Game/Online/API/Requests/Responses/APIUserScoreAggregate.cs b/osu.Game/Online/API/Requests/Responses/APIUserScoreAggregate.cs
index 172fa3a583..9a7f0832a6 100644
--- a/osu.Game/Online/API/Requests/Responses/APIUserScoreAggregate.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIUserScoreAggregate.cs
@@ -3,7 +3,6 @@
 
 using Newtonsoft.Json;
 using osu.Game.Scoring;
-using osu.Game.Users;
 
 namespace osu.Game.Online.API.Requests.Responses
 {
@@ -31,7 +30,7 @@ namespace osu.Game.Online.API.Requests.Responses
         public long UserID { get; set; }
 
         [JsonProperty("user")]
-        public User User { get; set; }
+        public APIUser User { get; set; }
 
         [JsonProperty("position")]
         public int? Position { get; set; }
diff --git a/osu.Game/Online/API/Requests/Responses/Comment.cs b/osu.Game/Online/API/Requests/Responses/Comment.cs
index 32d489432d..13379a40a6 100644
--- a/osu.Game/Online/API/Requests/Responses/Comment.cs
+++ b/osu.Game/Online/API/Requests/Responses/Comment.cs
@@ -2,7 +2,6 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using Newtonsoft.Json;
-using osu.Game.Users;
 using System;
 
 namespace osu.Game.Online.API.Requests.Responses
@@ -20,7 +19,7 @@ namespace osu.Game.Online.API.Requests.Responses
         [JsonProperty(@"user_id")]
         public long? UserId { get; set; }
 
-        public User User { get; set; }
+        public APIUser User { get; set; }
 
         [JsonProperty(@"message")]
         public string Message { get; set; }
@@ -61,7 +60,7 @@ namespace osu.Game.Online.API.Requests.Responses
         [JsonProperty(@"pinned")]
         public bool Pinned { get; set; }
 
-        public User EditedUser { get; set; }
+        public APIUser EditedUser { get; set; }
 
         public bool IsTopLevel => !ParentId.HasValue;
 
diff --git a/osu.Game/Online/API/Requests/Responses/CommentBundle.cs b/osu.Game/Online/API/Requests/Responses/CommentBundle.cs
index 4070df493d..8436381090 100644
--- a/osu.Game/Online/API/Requests/Responses/CommentBundle.cs
+++ b/osu.Game/Online/API/Requests/Responses/CommentBundle.cs
@@ -2,7 +2,6 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using Newtonsoft.Json;
-using osu.Game.Users;
 using System.Collections.Generic;
 using System.Linq;
 
@@ -43,10 +42,10 @@ namespace osu.Game.Online.API.Requests.Responses
             }
         }
 
-        private List<User> users;
+        private List<APIUser> users;
 
         [JsonProperty(@"users")]
-        public List<User> Users
+        public List<APIUser> Users
         {
             get => users;
             set
diff --git a/osu.Game/Online/Chat/Channel.cs b/osu.Game/Online/Chat/Channel.cs
index 9b463a6348..9cbb2f37e4 100644
--- a/osu.Game/Online/Chat/Channel.cs
+++ b/osu.Game/Online/Chat/Channel.cs
@@ -8,7 +8,7 @@ using System.Linq;
 using Newtonsoft.Json;
 using osu.Framework.Bindables;
 using osu.Framework.Lists;
-using osu.Game.Users;
+using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Online.Chat
 {
@@ -19,7 +19,7 @@ namespace osu.Game.Online.Chat
         /// <summary>
         /// Contains every joined user except the current logged in user. Currently only returned for PM channels.
         /// </summary>
-        public readonly ObservableCollection<User> Users = new ObservableCollection<User>();
+        public readonly ObservableCollection<APIUser> Users = new ObservableCollection<APIUser>();
 
         [JsonProperty(@"users")]
         private int[] userIds
@@ -27,7 +27,7 @@ namespace osu.Game.Online.Chat
             set
             {
                 foreach (int id in value)
-                    Users.Add(new User { Id = id });
+                    Users.Add(new APIUser { Id = id });
             }
         }
 
@@ -98,7 +98,7 @@ namespace osu.Game.Online.Chat
         /// Create a private messaging channel with the specified user.
         /// </summary>
         /// <param name="user">The user to create the private conversation with.</param>
-        public Channel(User user)
+        public Channel(APIUser user)
         {
             Type = ChannelType.PM;
             Users.Add(user);
diff --git a/osu.Game/Online/Chat/ChannelManager.cs b/osu.Game/Online/Chat/ChannelManager.cs
index 52c9387185..edaf135e93 100644
--- a/osu.Game/Online/Chat/ChannelManager.cs
+++ b/osu.Game/Online/Chat/ChannelManager.cs
@@ -11,8 +11,8 @@ using osu.Framework.Logging;
 using osu.Game.Database;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays.Chat.Tabs;
-using osu.Game.Users;
 
 namespace osu.Game.Online.Chat
 {
@@ -91,7 +91,7 @@ namespace osu.Game.Online.Chat
         /// Opens a new private channel.
         /// </summary>
         /// <param name="user">The user the private channel is opened with.</param>
-        public void OpenPrivateChannel(User user)
+        public void OpenPrivateChannel(APIUser user)
         {
             if (user == null)
                 throw new ArgumentNullException(nameof(user));
diff --git a/osu.Game/Online/Chat/InfoMessage.cs b/osu.Game/Online/Chat/InfoMessage.cs
index cea336aae2..e97245df45 100644
--- a/osu.Game/Online/Chat/InfoMessage.cs
+++ b/osu.Game/Online/Chat/InfoMessage.cs
@@ -2,7 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
-using osu.Game.Users;
+using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Online.Chat
 {
@@ -14,7 +14,7 @@ namespace osu.Game.Online.Chat
             Timestamp = DateTimeOffset.Now;
             Content = message;
 
-            Sender = User.SYSTEM_USER;
+            Sender = APIUser.SYSTEM_USER;
         }
     }
 }
diff --git a/osu.Game/Online/Chat/Message.cs b/osu.Game/Online/Chat/Message.cs
index 4f33153e56..dcd15f9028 100644
--- a/osu.Game/Online/Chat/Message.cs
+++ b/osu.Game/Online/Chat/Message.cs
@@ -4,7 +4,7 @@
 using System;
 using System.Collections.Generic;
 using Newtonsoft.Json;
-using osu.Game.Users;
+using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Online.Chat
 {
@@ -26,7 +26,7 @@ namespace osu.Game.Online.Chat
         public string Content;
 
         [JsonProperty(@"sender")]
-        public User Sender;
+        public APIUser Sender;
 
         [JsonConstructor]
         public Message()
diff --git a/osu.Game/Online/Chat/MessageNotifier.cs b/osu.Game/Online/Chat/MessageNotifier.cs
index 6840c036ff..ca6317566f 100644
--- a/osu.Game/Online/Chat/MessageNotifier.cs
+++ b/osu.Game/Online/Chat/MessageNotifier.cs
@@ -12,9 +12,9 @@ using osu.Framework.Graphics.Sprites;
 using osu.Game.Configuration;
 using osu.Game.Graphics;
 using osu.Game.Online.API;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays;
 using osu.Game.Overlays.Notifications;
-using osu.Game.Users;
 
 namespace osu.Game.Online.Chat
 {
@@ -35,7 +35,7 @@ namespace osu.Game.Online.Chat
         private Bindable<bool> notifyOnUsername;
         private Bindable<bool> notifyOnPrivateMessage;
 
-        private readonly IBindable<User> localUser = new Bindable<User>();
+        private readonly IBindable<APIUser> localUser = new Bindable<APIUser>();
         private readonly IBindableList<Channel> joinedChannels = new BindableList<Channel>();
 
         [BackgroundDependencyLoader]
diff --git a/osu.Game/Online/Multiplayer/MultiplayerClient.cs b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
index 6c4747ea54..567e59e8a0 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
@@ -22,8 +22,8 @@ using osu.Game.Online.Rooms;
 using osu.Game.Online.Rooms.RoomStatuses;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Mods;
-using osu.Game.Users;
 using osu.Game.Utils;
+using APIUser = osu.Game.Online.API.Requests.Responses.APIUser;
 
 namespace osu.Game.Online.Multiplayer
 {
@@ -402,7 +402,7 @@ namespace osu.Game.Online.Multiplayer
         {
             Debug.Assert(APIRoom != null);
 
-            APIRoom.RecentParticipants.Add(user.User ?? new User
+            APIRoom.RecentParticipants.Add(user.User ?? new APIUser
             {
                 Id = user.UserID,
                 Username = "[Unresolved]"
@@ -614,7 +614,7 @@ namespace osu.Game.Online.Multiplayer
         }
 
         /// <summary>
-        /// Populates the <see cref="User"/> for a given <see cref="MultiplayerRoomUser"/>.
+        /// Populates the <see cref="APIUser"/> for a given <see cref="MultiplayerRoomUser"/>.
         /// </summary>
         /// <param name="multiplayerUser">The <see cref="MultiplayerRoomUser"/> to populate.</param>
         protected async Task PopulateUser(MultiplayerRoomUser multiplayerUser) => multiplayerUser.User ??= await userLookupCache.GetUserAsync(multiplayerUser.UserID).ConfigureAwait(false);
diff --git a/osu.Game/Online/Multiplayer/MultiplayerRoomUser.cs b/osu.Game/Online/Multiplayer/MultiplayerRoomUser.cs
index 5d11e2921a..519bfff116 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerRoomUser.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerRoomUser.cs
@@ -9,8 +9,8 @@ using System.Linq;
 using MessagePack;
 using Newtonsoft.Json;
 using osu.Game.Online.API;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Rooms;
-using osu.Game.Users;
 
 namespace osu.Game.Online.Multiplayer
 {
@@ -40,7 +40,7 @@ namespace osu.Game.Online.Multiplayer
         public IEnumerable<APIMod> Mods { get; set; } = Enumerable.Empty<APIMod>();
 
         [IgnoreMember]
-        public User? User { get; set; }
+        public APIUser? User { get; set; }
 
         [JsonConstructor]
         public MultiplayerRoomUser(int userId)
diff --git a/osu.Game/Online/Rooms/MultiplayerScore.cs b/osu.Game/Online/Rooms/MultiplayerScore.cs
index 375e0b6b9f..cfb81f0bad 100644
--- a/osu.Game/Online/Rooms/MultiplayerScore.cs
+++ b/osu.Game/Online/Rooms/MultiplayerScore.cs
@@ -9,10 +9,10 @@ using Newtonsoft.Json;
 using Newtonsoft.Json.Converters;
 using osu.Game.Beatmaps;
 using osu.Game.Online.API;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Scoring;
 using osu.Game.Scoring;
-using osu.Game.Users;
 
 namespace osu.Game.Online.Rooms
 {
@@ -22,7 +22,7 @@ namespace osu.Game.Online.Rooms
         public long ID { get; set; }
 
         [JsonProperty("user")]
-        public User User { get; set; }
+        public APIUser User { get; set; }
 
         [JsonProperty("rank")]
         [JsonConverter(typeof(StringEnumConverter))]
diff --git a/osu.Game/Online/Rooms/Room.cs b/osu.Game/Online/Rooms/Room.cs
index 39fc7f1da8..48c5412aa3 100644
--- a/osu.Game/Online/Rooms/Room.cs
+++ b/osu.Game/Online/Rooms/Room.cs
@@ -7,8 +7,8 @@ using Newtonsoft.Json;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Game.IO.Serialization.Converters;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Rooms.RoomStatuses;
-using osu.Game.Users;
 using osu.Game.Utils;
 
 namespace osu.Game.Online.Rooms
@@ -25,7 +25,7 @@ namespace osu.Game.Online.Rooms
 
         [Cached]
         [JsonProperty("host")]
-        public readonly Bindable<User> Host = new Bindable<User>();
+        public readonly Bindable<APIUser> Host = new Bindable<APIUser>();
 
         [Cached]
         [JsonProperty("playlist")]
@@ -86,7 +86,7 @@ namespace osu.Game.Online.Rooms
 
         [Cached]
         [JsonProperty("recent_participants")]
-        public readonly BindableList<User> RecentParticipants = new BindableList<User>();
+        public readonly BindableList<APIUser> RecentParticipants = new BindableList<APIUser>();
 
         [Cached]
         [JsonProperty("participant_count")]
diff --git a/osu.Game/Online/Solo/SubmittableScore.cs b/osu.Game/Online/Solo/SubmittableScore.cs
index bafb308a13..373c302844 100644
--- a/osu.Game/Online/Solo/SubmittableScore.cs
+++ b/osu.Game/Online/Solo/SubmittableScore.cs
@@ -10,7 +10,7 @@ using osu.Game.Online.API;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets.Scoring;
 using osu.Game.Scoring;
-using osu.Game.Users;
+using APIUser = osu.Game.Online.API.Requests.Responses.APIUser;
 
 namespace osu.Game.Online.Solo
 {
@@ -48,7 +48,7 @@ namespace osu.Game.Online.Solo
         public APIMod[] Mods { get; set; }
 
         [JsonProperty("user")]
-        public User User { get; set; }
+        public APIUser User { get; set; }
 
         [JsonProperty("statistics")]
         public Dictionary<HitResult, int> Statistics { get; set; }
diff --git a/osu.Game/Overlays/BeatmapSet/AuthorInfo.cs b/osu.Game/Overlays/BeatmapSet/AuthorInfo.cs
index c90e2e2085..9131f6f74c 100644
--- a/osu.Game/Overlays/BeatmapSet/AuthorInfo.cs
+++ b/osu.Game/Overlays/BeatmapSet/AuthorInfo.cs
@@ -13,9 +13,9 @@ using osuTK.Graphics;
 using osu.Framework.Graphics.Effects;
 using osu.Framework.Graphics.Sprites;
 using osu.Game.Graphics;
-using osu.Game.Users;
 using osu.Game.Graphics.Containers;
 using osu.Game.Online.API.Requests.Responses;
+using APIUser = osu.Game.Online.API.Requests.Responses.APIUser;
 
 namespace osu.Game.Overlays.BeatmapSet
 {
@@ -144,7 +144,7 @@ namespace osu.Game.Overlays.BeatmapSet
                 };
             }
 
-            public Field(string first, User second, FontUsage secondFont)
+            public Field(string first, APIUser second, FontUsage secondFont)
             {
                 AutoSizeAxes = Axes.Both;
                 Direction = FillDirection.Horizontal;
diff --git a/osu.Game/Overlays/BeatmapSet/Buttons/FavouriteButton.cs b/osu.Game/Overlays/BeatmapSet/Buttons/FavouriteButton.cs
index d4873f241c..8fe7450873 100644
--- a/osu.Game/Overlays/BeatmapSet/Buttons/FavouriteButton.cs
+++ b/osu.Game/Overlays/BeatmapSet/Buttons/FavouriteButton.cs
@@ -14,8 +14,8 @@ using osu.Game.Online.API.Requests;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays.Notifications;
 using osu.Game.Resources.Localisation.Web;
-using osu.Game.Users;
 using osuTK;
+using APIUser = osu.Game.Online.API.Requests.Responses.APIUser;
 
 namespace osu.Game.Overlays.BeatmapSet.Buttons
 {
@@ -28,7 +28,7 @@ namespace osu.Game.Overlays.BeatmapSet.Buttons
         private PostBeatmapFavouriteRequest request;
         private LoadingLayer loading;
 
-        private readonly IBindable<User> localUser = new Bindable<User>();
+        private readonly IBindable<APIUser> localUser = new Bindable<APIUser>();
 
         public LocalisableString TooltipText
         {
diff --git a/osu.Game/Overlays/BeatmapSet/Buttons/HeaderDownloadButton.cs b/osu.Game/Overlays/BeatmapSet/Buttons/HeaderDownloadButton.cs
index bd7723d3c0..ee40f114d2 100644
--- a/osu.Game/Overlays/BeatmapSet/Buttons/HeaderDownloadButton.cs
+++ b/osu.Game/Overlays/BeatmapSet/Buttons/HeaderDownloadButton.cs
@@ -17,9 +17,9 @@ using osu.Game.Online.API;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays.BeatmapListing.Panels;
 using osu.Game.Resources.Localisation.Web;
-using osu.Game.Users;
 using osuTK;
 using osuTK.Graphics;
+using APIUser = osu.Game.Online.API.Requests.Responses.APIUser;
 using CommonStrings = osu.Game.Localisation.CommonStrings;
 
 namespace osu.Game.Overlays.BeatmapSet.Buttons
@@ -32,7 +32,7 @@ namespace osu.Game.Overlays.BeatmapSet.Buttons
 
         public LocalisableString TooltipText => BeatmapsetsStrings.ShowDetailsDownloadDefault;
 
-        private readonly IBindable<User> localUser = new Bindable<User>();
+        private readonly IBindable<APIUser> localUser = new Bindable<APIUser>();
 
         private ShakeContainer shakeContainer;
         private HeaderButton button;
@@ -165,7 +165,7 @@ namespace osu.Game.Overlays.BeatmapSet.Buttons
             }, true);
         }
 
-        private void userChanged(ValueChangedEvent<User> e) => button.Enabled.Value = !(e.NewValue is GuestUser);
+        private void userChanged(ValueChangedEvent<APIUser> e) => button.Enabled.Value = !(e.NewValue is GuestUser);
 
         private void enabledChanged(ValueChangedEvent<bool> e) => this.FadeColour(e.NewValue ? Color4.White : Color4.Gray, 200, Easing.OutQuint);
 
diff --git a/osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.cs b/osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.cs
index 3891d68d35..65a422a92a 100644
--- a/osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.cs
+++ b/osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.cs
@@ -17,8 +17,8 @@ using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets;
 using osu.Game.Scoring;
 using osu.Game.Screens.Select.Leaderboards;
-using osu.Game.Users;
 using osuTK;
+using APIUser = osu.Game.Online.API.Requests.Responses.APIUser;
 
 namespace osu.Game.Overlays.BeatmapSet.Scores
 {
@@ -29,7 +29,7 @@ namespace osu.Game.Overlays.BeatmapSet.Scores
         public readonly Bindable<APIBeatmap> Beatmap = new Bindable<APIBeatmap>();
         private readonly Bindable<IRulesetInfo> ruleset = new Bindable<IRulesetInfo>();
         private readonly Bindable<BeatmapLeaderboardScope> scope = new Bindable<BeatmapLeaderboardScope>(BeatmapLeaderboardScope.Global);
-        private readonly IBindable<User> user = new Bindable<User>();
+        private readonly IBindable<APIUser> user = new Bindable<APIUser>();
 
         private readonly Box background;
         private readonly ScoreTable scoreTable;
@@ -218,7 +218,7 @@ namespace osu.Game.Overlays.BeatmapSet.Scores
             scope.Value = BeatmapLeaderboardScope.Global;
         }
 
-        private void onUserChanged(ValueChangedEvent<User> user)
+        private void onUserChanged(ValueChangedEvent<APIUser> user)
         {
             if (modSelector.SelectedMods.Any())
                 modSelector.DeselectAll();
diff --git a/osu.Game/Overlays/Changelog/ChangelogEntry.cs b/osu.Game/Overlays/Changelog/ChangelogEntry.cs
index 55edb40283..da062ca617 100644
--- a/osu.Game/Overlays/Changelog/ChangelogEntry.cs
+++ b/osu.Game/Overlays/Changelog/ChangelogEntry.cs
@@ -12,9 +12,9 @@ using osu.Framework.Graphics.Sprites;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Online.API.Requests.Responses;
-using osu.Game.Users;
 using osuTK;
 using osuTK.Graphics;
+using APIUser = osu.Game.Online.API.Requests.Responses.APIUser;
 
 namespace osu.Game.Overlays.Changelog
 {
@@ -131,7 +131,7 @@ namespace osu.Game.Overlays.Changelog
 
             if (entry.GithubUser.UserId != null)
             {
-                title.AddUserLink(new User
+                title.AddUserLink(new APIUser
                 {
                     Username = entry.GithubUser.OsuUsername,
                     Id = entry.GithubUser.UserId.Value
diff --git a/osu.Game/Overlays/Chat/ChatLine.cs b/osu.Game/Overlays/Chat/ChatLine.cs
index 6f4f568eb2..97cd913b56 100644
--- a/osu.Game/Overlays/Chat/ChatLine.cs
+++ b/osu.Game/Overlays/Chat/ChatLine.cs
@@ -17,8 +17,8 @@ using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Online.API;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Chat;
-using osu.Game.Users;
 using osuTK;
 using osuTK.Graphics;
 
@@ -217,14 +217,14 @@ namespace osu.Game.Overlays.Chat
 
         private class MessageSender : OsuClickableContainer, IHasContextMenu
         {
-            private readonly User sender;
+            private readonly APIUser sender;
 
             private Action startChatAction;
 
             [Resolved]
             private IAPIProvider api { get; set; }
 
-            public MessageSender(User sender)
+            public MessageSender(APIUser sender)
             {
                 this.sender = sender;
             }
@@ -240,7 +240,7 @@ namespace osu.Game.Overlays.Chat
             {
                 get
                 {
-                    if (sender.Equals(User.SYSTEM_USER))
+                    if (sender.Equals(APIUser.SYSTEM_USER))
                         return Array.Empty<MenuItem>();
 
                     List<MenuItem> items = new List<MenuItem>
diff --git a/osu.Game/Overlays/Comments/CommentsContainer.cs b/osu.Game/Overlays/Comments/CommentsContainer.cs
index 6b3d816e84..970fc5ccef 100644
--- a/osu.Game/Overlays/Comments/CommentsContainer.cs
+++ b/osu.Game/Overlays/Comments/CommentsContainer.cs
@@ -13,10 +13,10 @@ using System.Threading;
 using System.Linq;
 using osu.Framework.Extensions.IEnumerableExtensions;
 using osu.Framework.Threading;
-using osu.Game.Users;
 using System.Collections.Generic;
 using JetBrains.Annotations;
 using osu.Game.Graphics.Sprites;
+using APIUser = osu.Game.Online.API.Requests.Responses.APIUser;
 
 namespace osu.Game.Overlays.Comments
 {
@@ -28,7 +28,7 @@ namespace osu.Game.Overlays.Comments
         public readonly Bindable<CommentsSortCriteria> Sort = new Bindable<CommentsSortCriteria>();
         public readonly BindableBool ShowDeleted = new BindableBool();
 
-        protected readonly IBindable<User> User = new Bindable<User>();
+        protected readonly IBindable<APIUser> User = new Bindable<APIUser>();
 
         [Resolved]
         private IAPIProvider api { get; set; }
diff --git a/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs b/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs
index 454dd500fe..269ed81bb5 100644
--- a/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs
+++ b/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs
@@ -10,6 +10,7 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Screens;
 using osu.Game.Database;
 using osu.Game.Online.API;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Spectator;
 using osu.Game.Screens.OnlinePlay.Match.Components;
 using osu.Game.Screens.Play;
@@ -91,7 +92,7 @@ namespace osu.Game.Overlays.Dashboard
             }
         });
 
-        private PlayingUserPanel createUserPanel(User user) =>
+        private PlayingUserPanel createUserPanel(APIUser user) =>
             new PlayingUserPanel(user).With(panel =>
             {
                 panel.Anchor = Anchor.TopCentre;
@@ -100,12 +101,12 @@ namespace osu.Game.Overlays.Dashboard
 
         private class PlayingUserPanel : CompositeDrawable
         {
-            public readonly User User;
+            public readonly APIUser User;
 
             [Resolved(canBeNull: true)]
             private OsuGame game { get; set; }
 
-            public PlayingUserPanel(User user)
+            public PlayingUserPanel(APIUser user)
             {
                 User = user;
 
diff --git a/osu.Game/Overlays/Dashboard/Friends/FriendDisplay.cs b/osu.Game/Overlays/Dashboard/Friends/FriendDisplay.cs
index 0922ce5ecc..765f037d70 100644
--- a/osu.Game/Overlays/Dashboard/Friends/FriendDisplay.cs
+++ b/osu.Game/Overlays/Dashboard/Friends/FriendDisplay.cs
@@ -11,6 +11,7 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Online.API;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Users;
 using osuTK;
 
@@ -18,9 +19,9 @@ namespace osu.Game.Overlays.Dashboard.Friends
 {
     public class FriendDisplay : CompositeDrawable
     {
-        private List<User> users = new List<User>();
+        private List<APIUser> users = new List<APIUser>();
 
-        public List<User> Users
+        public List<APIUser> Users
         {
             get => users;
             set
@@ -41,7 +42,7 @@ namespace osu.Game.Overlays.Dashboard.Friends
         private Container itemsPlaceholder;
         private LoadingLayer loading;
 
-        private readonly IBindableList<User> apiFriends = new BindableList<User>();
+        private readonly IBindableList<APIUser> apiFriends = new BindableList<APIUser>();
 
         public FriendDisplay()
         {
@@ -169,7 +170,7 @@ namespace osu.Game.Overlays.Dashboard.Friends
             LoadComponentAsync(createTable(sortedUsers), addContentToPlaceholder, (cancellationToken = new CancellationTokenSource()).Token);
         }
 
-        private List<User> getUsersInCurrentGroup()
+        private List<APIUser> getUsersInCurrentGroup()
         {
             switch (onlineStreamControl.Current.Value?.Status)
             {
@@ -201,7 +202,7 @@ namespace osu.Game.Overlays.Dashboard.Friends
             currentContent.FadeIn(200, Easing.OutQuint);
         }
 
-        private FillFlowContainer createTable(List<User> users)
+        private FillFlowContainer createTable(List<APIUser> users)
         {
             var style = userListToolbar.DisplayStyle.Value;
 
@@ -214,7 +215,7 @@ namespace osu.Game.Overlays.Dashboard.Friends
             };
         }
 
-        private UserPanel createUserPanel(User user, OverlayPanelDisplayStyle style)
+        private UserPanel createUserPanel(APIUser user, OverlayPanelDisplayStyle style)
         {
             switch (style)
             {
@@ -235,7 +236,7 @@ namespace osu.Game.Overlays.Dashboard.Friends
             }
         }
 
-        private List<User> sortUsers(List<User> unsorted)
+        private List<APIUser> sortUsers(List<APIUser> unsorted)
         {
             switch (userListToolbar.SortCriteria.Value)
             {
diff --git a/osu.Game/Overlays/Dashboard/Friends/FriendOnlineStreamControl.cs b/osu.Game/Overlays/Dashboard/Friends/FriendOnlineStreamControl.cs
index d7f66e35b5..7275cdff7c 100644
--- a/osu.Game/Overlays/Dashboard/Friends/FriendOnlineStreamControl.cs
+++ b/osu.Game/Overlays/Dashboard/Friends/FriendOnlineStreamControl.cs
@@ -3,7 +3,7 @@
 
 using System.Collections.Generic;
 using System.Linq;
-using osu.Game.Users;
+using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Overlays.Dashboard.Friends
 {
@@ -11,7 +11,7 @@ namespace osu.Game.Overlays.Dashboard.Friends
     {
         protected override OverlayStreamItem<FriendStream> CreateStreamItem(FriendStream value) => new FriendsOnlineStatusItem(value);
 
-        public void Populate(List<User> users)
+        public void Populate(List<APIUser> users)
         {
             Clear();
 
diff --git a/osu.Game/Overlays/Profile/Header/BottomHeaderContainer.cs b/osu.Game/Overlays/Profile/Header/BottomHeaderContainer.cs
index fe61e532e1..ea52cec2e1 100644
--- a/osu.Game/Overlays/Profile/Header/BottomHeaderContainer.cs
+++ b/osu.Game/Overlays/Profile/Header/BottomHeaderContainer.cs
@@ -14,7 +14,7 @@ using osu.Framework.Graphics.Sprites;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Online.API;
-using osu.Game.Users;
+using osu.Game.Online.API.Requests.Responses;
 using osuTK;
 using osuTK.Graphics;
 
@@ -22,7 +22,7 @@ namespace osu.Game.Overlays.Profile.Header
 {
     public class BottomHeaderContainer : CompositeDrawable
     {
-        public readonly Bindable<User> User = new Bindable<User>();
+        public readonly Bindable<APIUser> User = new Bindable<APIUser>();
 
         private LinkFlowContainer topLinkContainer;
         private LinkFlowContainer bottomLinkContainer;
@@ -75,7 +75,7 @@ namespace osu.Game.Overlays.Profile.Header
             User.BindValueChanged(user => updateDisplay(user.NewValue));
         }
 
-        private void updateDisplay(User user)
+        private void updateDisplay(APIUser user)
         {
             topLinkContainer.Clear();
             bottomLinkContainer.Clear();
diff --git a/osu.Game/Overlays/Profile/Header/CentreHeaderContainer.cs b/osu.Game/Overlays/Profile/Header/CentreHeaderContainer.cs
index 180a288729..a13f5ed6ce 100644
--- a/osu.Game/Overlays/Profile/Header/CentreHeaderContainer.cs
+++ b/osu.Game/Overlays/Profile/Header/CentreHeaderContainer.cs
@@ -9,9 +9,9 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Graphics.Textures;
 using osu.Framework.Localisation;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays.Profile.Header.Components;
 using osu.Game.Resources.Localisation.Web;
-using osu.Game.Users;
 using osuTK;
 
 namespace osu.Game.Overlays.Profile.Header
@@ -19,7 +19,7 @@ namespace osu.Game.Overlays.Profile.Header
     public class CentreHeaderContainer : CompositeDrawable
     {
         public readonly BindableBool DetailsVisible = new BindableBool(true);
-        public readonly Bindable<User> User = new Bindable<User>();
+        public readonly Bindable<APIUser> User = new Bindable<APIUser>();
 
         private OverlinedInfoContainer hiddenDetailGlobal;
         private OverlinedInfoContainer hiddenDetailCountry;
@@ -145,7 +145,7 @@ namespace osu.Game.Overlays.Profile.Header
             User.BindValueChanged(user => updateDisplay(user.NewValue));
         }
 
-        private void updateDisplay(User user)
+        private void updateDisplay(APIUser user)
         {
             hiddenDetailGlobal.Content = user?.Statistics?.GlobalRank?.ToLocalisableString("\\##,##0") ?? (LocalisableString)"-";
             hiddenDetailCountry.Content = user?.Statistics?.CountryRank?.ToLocalisableString("\\##,##0") ?? (LocalisableString)"-";
diff --git a/osu.Game/Overlays/Profile/Header/Components/FollowersButton.cs b/osu.Game/Overlays/Profile/Header/Components/FollowersButton.cs
index 8f66120055..1b21bfc982 100644
--- a/osu.Game/Overlays/Profile/Header/Components/FollowersButton.cs
+++ b/osu.Game/Overlays/Profile/Header/Components/FollowersButton.cs
@@ -5,14 +5,14 @@ using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Localisation;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Resources.Localisation.Web;
-using osu.Game.Users;
 
 namespace osu.Game.Overlays.Profile.Header.Components
 {
     public class FollowersButton : ProfileHeaderStatisticsButton
     {
-        public readonly Bindable<User> User = new Bindable<User>();
+        public readonly Bindable<APIUser> User = new Bindable<APIUser>();
 
         public override LocalisableString TooltipText => FriendsStrings.ButtonsDisabled;
 
diff --git a/osu.Game/Overlays/Profile/Header/Components/LevelBadge.cs b/osu.Game/Overlays/Profile/Header/Components/LevelBadge.cs
index 1deed1a748..e1302788da 100644
--- a/osu.Game/Overlays/Profile/Header/Components/LevelBadge.cs
+++ b/osu.Game/Overlays/Profile/Header/Components/LevelBadge.cs
@@ -11,14 +11,14 @@ using osu.Framework.Graphics.Textures;
 using osu.Framework.Localisation;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Resources.Localisation.Web;
-using osu.Game.Users;
 
 namespace osu.Game.Overlays.Profile.Header.Components
 {
     public class LevelBadge : CompositeDrawable, IHasTooltip
     {
-        public readonly Bindable<User> User = new Bindable<User>();
+        public readonly Bindable<APIUser> User = new Bindable<APIUser>();
 
         public LocalisableString TooltipText { get; private set; }
 
@@ -51,7 +51,7 @@ namespace osu.Game.Overlays.Profile.Header.Components
             User.BindValueChanged(user => updateLevel(user.NewValue));
         }
 
-        private void updateLevel(User user)
+        private void updateLevel(APIUser user)
         {
             levelText.Text = user?.Statistics?.Level.Current.ToString() ?? "0";
             TooltipText = UsersStrings.ShowStatsLevel(user?.Statistics?.Level.Current.ToString());
diff --git a/osu.Game/Overlays/Profile/Header/Components/LevelProgressBar.cs b/osu.Game/Overlays/Profile/Header/Components/LevelProgressBar.cs
index 2c8c421eba..8f6b935128 100644
--- a/osu.Game/Overlays/Profile/Header/Components/LevelProgressBar.cs
+++ b/osu.Game/Overlays/Profile/Header/Components/LevelProgressBar.cs
@@ -11,15 +11,15 @@ using osu.Framework.Localisation;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.UserInterface;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Resources.Localisation.Web;
-using osu.Game.Users;
 using osuTK.Graphics;
 
 namespace osu.Game.Overlays.Profile.Header.Components
 {
     public class LevelProgressBar : CompositeDrawable, IHasTooltip
     {
-        public readonly Bindable<User> User = new Bindable<User>();
+        public readonly Bindable<APIUser> User = new Bindable<APIUser>();
 
         public LocalisableString TooltipText { get; }
 
@@ -59,7 +59,7 @@ namespace osu.Game.Overlays.Profile.Header.Components
             User.BindValueChanged(user => updateProgress(user.NewValue));
         }
 
-        private void updateProgress(User user)
+        private void updateProgress(APIUser user)
         {
             levelProgressBar.Length = user?.Statistics?.Level.Progress / 100f ?? 0;
             levelProgressText.Text = user?.Statistics?.Level.Progress.ToLocalisableString("0'%'");
diff --git a/osu.Game/Overlays/Profile/Header/Components/MappingSubscribersButton.cs b/osu.Game/Overlays/Profile/Header/Components/MappingSubscribersButton.cs
index 5cdf3a5ef9..6d1024ff18 100644
--- a/osu.Game/Overlays/Profile/Header/Components/MappingSubscribersButton.cs
+++ b/osu.Game/Overlays/Profile/Header/Components/MappingSubscribersButton.cs
@@ -5,14 +5,14 @@ using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Localisation;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Resources.Localisation.Web;
-using osu.Game.Users;
 
 namespace osu.Game.Overlays.Profile.Header.Components
 {
     public class MappingSubscribersButton : ProfileHeaderStatisticsButton
     {
-        public readonly Bindable<User> User = new Bindable<User>();
+        public readonly Bindable<APIUser> User = new Bindable<APIUser>();
 
         public override LocalisableString TooltipText => FollowsStrings.MappingFollowers;
 
diff --git a/osu.Game/Overlays/Profile/Header/Components/MessageUserButton.cs b/osu.Game/Overlays/Profile/Header/Components/MessageUserButton.cs
index 07f1f1c3ed..e3dc5f818a 100644
--- a/osu.Game/Overlays/Profile/Header/Components/MessageUserButton.cs
+++ b/osu.Game/Overlays/Profile/Header/Components/MessageUserButton.cs
@@ -7,16 +7,16 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Localisation;
 using osu.Game.Online.API;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Chat;
 using osu.Game.Resources.Localisation.Web;
-using osu.Game.Users;
 using osuTK;
 
 namespace osu.Game.Overlays.Profile.Header.Components
 {
     public class MessageUserButton : ProfileHeaderButton
     {
-        public readonly Bindable<User> User = new Bindable<User>();
+        public readonly Bindable<APIUser> User = new Bindable<APIUser>();
 
         public override LocalisableString TooltipText => UsersStrings.CardSendMessage;
 
diff --git a/osu.Game/Overlays/Profile/Header/Components/OverlinedTotalPlayTime.cs b/osu.Game/Overlays/Profile/Header/Components/OverlinedTotalPlayTime.cs
index 1a40944632..1ead2cd2f5 100644
--- a/osu.Game/Overlays/Profile/Header/Components/OverlinedTotalPlayTime.cs
+++ b/osu.Game/Overlays/Profile/Header/Components/OverlinedTotalPlayTime.cs
@@ -7,14 +7,14 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Cursor;
 using osu.Framework.Localisation;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Resources.Localisation.Web;
-using osu.Game.Users;
 
 namespace osu.Game.Overlays.Profile.Header.Components
 {
     public class OverlinedTotalPlayTime : CompositeDrawable, IHasTooltip
     {
-        public readonly Bindable<User> User = new Bindable<User>();
+        public readonly Bindable<APIUser> User = new Bindable<APIUser>();
 
         public LocalisableString TooltipText { get; set; }
 
@@ -39,7 +39,7 @@ namespace osu.Game.Overlays.Profile.Header.Components
             User.BindValueChanged(updateTime, true);
         }
 
-        private void updateTime(ValueChangedEvent<User> user)
+        private void updateTime(ValueChangedEvent<APIUser> user)
         {
             TooltipText = (user.NewValue?.Statistics?.PlayTime ?? 0) / 3600 + " hours";
             info.Content = formatTime(user.NewValue?.Statistics?.PlayTime);
diff --git a/osu.Game/Overlays/Profile/Header/Components/PreviousUsernames.cs b/osu.Game/Overlays/Profile/Header/Components/PreviousUsernames.cs
index b1076ba39b..229bbaef83 100644
--- a/osu.Game/Overlays/Profile/Header/Components/PreviousUsernames.cs
+++ b/osu.Game/Overlays/Profile/Header/Components/PreviousUsernames.cs
@@ -12,8 +12,8 @@ using osu.Framework.Graphics.Sprites;
 using osu.Framework.Input.Events;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Resources.Localisation.Web;
-using osu.Game.Users;
 using osuTK;
 
 namespace osu.Game.Overlays.Profile.Header.Components
@@ -25,7 +25,7 @@ namespace osu.Game.Overlays.Profile.Header.Components
         private const int width = 310;
         private const int move_offset = 15;
 
-        public readonly Bindable<User> User = new Bindable<User>();
+        public readonly Bindable<APIUser> User = new Bindable<APIUser>();
 
         private readonly TextFlowContainer text;
         private readonly Box background;
@@ -107,7 +107,7 @@ namespace osu.Game.Overlays.Profile.Header.Components
             User.BindValueChanged(onUserChanged, true);
         }
 
-        private void onUserChanged(ValueChangedEvent<User> user)
+        private void onUserChanged(ValueChangedEvent<APIUser> user)
         {
             text.Text = string.Empty;
 
diff --git a/osu.Game/Overlays/Profile/Header/Components/ProfileRulesetSelector.cs b/osu.Game/Overlays/Profile/Header/Components/ProfileRulesetSelector.cs
index 41a3ee8ad6..eaa9703834 100644
--- a/osu.Game/Overlays/Profile/Header/Components/ProfileRulesetSelector.cs
+++ b/osu.Game/Overlays/Profile/Header/Components/ProfileRulesetSelector.cs
@@ -3,14 +3,14 @@
 
 using osu.Framework.Bindables;
 using osu.Framework.Graphics.UserInterface;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets;
-using osu.Game.Users;
 
 namespace osu.Game.Overlays.Profile.Header.Components
 {
     public class ProfileRulesetSelector : OverlayRulesetSelector
     {
-        public readonly Bindable<User> User = new Bindable<User>();
+        public readonly Bindable<APIUser> User = new Bindable<APIUser>();
 
         protected override void LoadComplete()
         {
diff --git a/osu.Game/Overlays/Profile/Header/DetailHeaderContainer.cs b/osu.Game/Overlays/Profile/Header/DetailHeaderContainer.cs
index 8ca6961950..79e553062d 100644
--- a/osu.Game/Overlays/Profile/Header/DetailHeaderContainer.cs
+++ b/osu.Game/Overlays/Profile/Header/DetailHeaderContainer.cs
@@ -11,11 +11,11 @@ using osu.Framework.Graphics.Shapes;
 using osu.Framework.Localisation;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Leaderboards;
 using osu.Game.Overlays.Profile.Header.Components;
 using osu.Game.Resources.Localisation.Web;
 using osu.Game.Scoring;
-using osu.Game.Users;
 using osuTK;
 
 namespace osu.Game.Overlays.Profile.Header
@@ -30,7 +30,7 @@ namespace osu.Game.Overlays.Profile.Header
         private FillFlowContainer fillFlow;
         private RankGraph rankGraph;
 
-        public readonly Bindable<User> User = new Bindable<User>();
+        public readonly Bindable<APIUser> User = new Bindable<APIUser>();
 
         private bool expanded = true;
 
@@ -171,7 +171,7 @@ namespace osu.Game.Overlays.Profile.Header
             };
         }
 
-        private void updateDisplay(User user)
+        private void updateDisplay(APIUser user)
         {
             medalInfo.Content = user?.Achievements?.Length.ToString() ?? "0";
             ppInfo.Content = user?.Statistics?.PP?.ToLocalisableString("#,##0") ?? (LocalisableString)"0";
diff --git a/osu.Game/Overlays/Profile/Header/MedalHeaderContainer.cs b/osu.Game/Overlays/Profile/Header/MedalHeaderContainer.cs
index f6419db540..5f513582e5 100644
--- a/osu.Game/Overlays/Profile/Header/MedalHeaderContainer.cs
+++ b/osu.Game/Overlays/Profile/Header/MedalHeaderContainer.cs
@@ -8,8 +8,8 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Colour;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays.Profile.Header.Components;
-using osu.Game.Users;
 using osuTK;
 using osuTK.Graphics;
 
@@ -19,7 +19,7 @@ namespace osu.Game.Overlays.Profile.Header
     {
         private FillFlowContainer badgeFlowContainer;
 
-        public readonly Bindable<User> User = new Bindable<User>();
+        public readonly Bindable<APIUser> User = new Bindable<APIUser>();
 
         [BackgroundDependencyLoader]
         private void load(OverlayColourProvider colourProvider)
@@ -63,7 +63,7 @@ namespace osu.Game.Overlays.Profile.Header
             };
         }
 
-        private void updateDisplay(User user)
+        private void updateDisplay(APIUser user)
         {
             var badges = user.Badges;
             badgeFlowContainer.Clear();
diff --git a/osu.Game/Overlays/Profile/Header/TopHeaderContainer.cs b/osu.Game/Overlays/Profile/Header/TopHeaderContainer.cs
index f5720cffb0..6ba5cb2f7f 100644
--- a/osu.Game/Overlays/Profile/Header/TopHeaderContainer.cs
+++ b/osu.Game/Overlays/Profile/Header/TopHeaderContainer.cs
@@ -13,9 +13,9 @@ using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Online.API;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays.Profile.Header.Components;
 using osu.Game.Resources.Localisation.Web;
-using osu.Game.Users;
 using osu.Game.Users.Drawables;
 using osuTK;
 
@@ -25,7 +25,7 @@ namespace osu.Game.Overlays.Profile.Header
     {
         private const float avatar_size = 110;
 
-        public readonly Bindable<User> User = new Bindable<User>();
+        public readonly Bindable<APIUser> User = new Bindable<APIUser>();
 
         [Resolved]
         private IAPIProvider api { get; set; }
@@ -167,7 +167,7 @@ namespace osu.Game.Overlays.Profile.Header
             User.BindValueChanged(user => updateUser(user.NewValue));
         }
 
-        private void updateUser(User user)
+        private void updateUser(APIUser user)
         {
             avatar.User = user;
             usernameText.Text = user?.Username ?? string.Empty;
diff --git a/osu.Game/Overlays/Profile/ProfileHeader.cs b/osu.Game/Overlays/Profile/ProfileHeader.cs
index 815f9fdafc..fab2487c0d 100644
--- a/osu.Game/Overlays/Profile/ProfileHeader.cs
+++ b/osu.Game/Overlays/Profile/ProfileHeader.cs
@@ -8,6 +8,7 @@ using osu.Framework.Graphics.Colour;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Localisation;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays.Profile.Header;
 using osu.Game.Resources.Localisation.Web;
 using osu.Game.Users;
@@ -18,7 +19,7 @@ namespace osu.Game.Overlays.Profile
     {
         private UserCoverBackground coverContainer;
 
-        public Bindable<User> User = new Bindable<User>();
+        public Bindable<APIUser> User = new Bindable<APIUser>();
 
         private CentreHeaderContainer centreHeaderContainer;
         private DetailHeaderContainer detailHeaderContainer;
@@ -92,7 +93,7 @@ namespace osu.Game.Overlays.Profile
 
         protected override OverlayTitle CreateTitle() => new ProfileHeaderTitle();
 
-        private void updateDisplay(User user) => coverContainer.User = user;
+        private void updateDisplay(APIUser user) => coverContainer.User = user;
 
         private class ProfileHeaderTitle : OverlayTitle
         {
diff --git a/osu.Game/Overlays/Profile/ProfileSection.cs b/osu.Game/Overlays/Profile/ProfileSection.cs
index 1a5f562fff..6223b32814 100644
--- a/osu.Game/Overlays/Profile/ProfileSection.cs
+++ b/osu.Game/Overlays/Profile/ProfileSection.cs
@@ -12,7 +12,7 @@ using osu.Framework.Localisation;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Backgrounds;
 using osu.Game.Graphics.Sprites;
-using osu.Game.Users;
+using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Overlays.Profile
 {
@@ -28,7 +28,7 @@ namespace osu.Game.Overlays.Profile
 
         protected override Container<Drawable> Content => content;
 
-        public readonly Bindable<User> User = new Bindable<User>();
+        public readonly Bindable<APIUser> User = new Bindable<APIUser>();
 
         protected ProfileSection()
         {
diff --git a/osu.Game/Overlays/Profile/Sections/Beatmaps/PaginatedBeatmapContainer.cs b/osu.Game/Overlays/Profile/Sections/Beatmaps/PaginatedBeatmapContainer.cs
index fffa20dc11..36b94283e5 100644
--- a/osu.Game/Overlays/Profile/Sections/Beatmaps/PaginatedBeatmapContainer.cs
+++ b/osu.Game/Overlays/Profile/Sections/Beatmaps/PaginatedBeatmapContainer.cs
@@ -10,8 +10,8 @@ using osu.Game.Online.API;
 using osu.Game.Online.API.Requests;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays.BeatmapListing.Panels;
-using osu.Game.Users;
 using osuTK;
+using APIUser = osu.Game.Online.API.Requests.Responses.APIUser;
 
 namespace osu.Game.Overlays.Profile.Sections.Beatmaps
 {
@@ -20,7 +20,7 @@ namespace osu.Game.Overlays.Profile.Sections.Beatmaps
         private const float panel_padding = 10f;
         private readonly BeatmapSetType type;
 
-        public PaginatedBeatmapContainer(BeatmapSetType type, Bindable<User> user, LocalisableString headerText)
+        public PaginatedBeatmapContainer(BeatmapSetType type, Bindable<APIUser> user, LocalisableString headerText)
             : base(user, headerText)
         {
             this.type = type;
@@ -33,7 +33,7 @@ namespace osu.Game.Overlays.Profile.Sections.Beatmaps
             ItemsContainer.Spacing = new Vector2(panel_padding);
         }
 
-        protected override int GetCount(User user)
+        protected override int GetCount(APIUser user)
         {
             switch (type)
             {
diff --git a/osu.Game/Overlays/Profile/Sections/Historical/ChartProfileSubsection.cs b/osu.Game/Overlays/Profile/Sections/Historical/ChartProfileSubsection.cs
index 986b3d9874..4edbdc31bd 100644
--- a/osu.Game/Overlays/Profile/Sections/Historical/ChartProfileSubsection.cs
+++ b/osu.Game/Overlays/Profile/Sections/Historical/ChartProfileSubsection.cs
@@ -7,8 +7,7 @@ using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Localisation;
-using osu.Game.Users;
-using static osu.Game.Users.User;
+using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Overlays.Profile.Sections.Historical
 {
@@ -21,7 +20,7 @@ namespace osu.Game.Overlays.Profile.Sections.Historical
         /// </summary>
         protected abstract LocalisableString GraphCounterName { get; }
 
-        protected ChartProfileSubsection(Bindable<User> user, LocalisableString headerText)
+        protected ChartProfileSubsection(Bindable<APIUser> user, LocalisableString headerText)
             : base(user, headerText)
         {
         }
@@ -45,7 +44,7 @@ namespace osu.Game.Overlays.Profile.Sections.Historical
             User.BindValueChanged(onUserChanged, true);
         }
 
-        private void onUserChanged(ValueChangedEvent<User> e)
+        private void onUserChanged(ValueChangedEvent<APIUser> e)
         {
             var values = GetValues(e.NewValue);
 
@@ -62,9 +61,9 @@ namespace osu.Game.Overlays.Profile.Sections.Historical
         /// <summary>
         /// Add entries for any missing months (filled with zero values).
         /// </summary>
-        private UserHistoryCount[] fillZeroValues(UserHistoryCount[] historyEntries)
+        private APIUserHistoryCount[] fillZeroValues(APIUserHistoryCount[] historyEntries)
         {
-            var filledHistoryEntries = new List<UserHistoryCount>();
+            var filledHistoryEntries = new List<APIUserHistoryCount>();
 
             foreach (var entry in historyEntries)
             {
@@ -72,7 +71,7 @@ namespace osu.Game.Overlays.Profile.Sections.Historical
 
                 while (lastFilled?.Date.AddMonths(1) < entry.Date)
                 {
-                    filledHistoryEntries.Add(lastFilled = new UserHistoryCount
+                    filledHistoryEntries.Add(lastFilled = new APIUserHistoryCount
                     {
                         Count = 0,
                         Date = lastFilled.Date.AddMonths(1)
@@ -85,6 +84,6 @@ namespace osu.Game.Overlays.Profile.Sections.Historical
             return filledHistoryEntries.ToArray();
         }
 
-        protected abstract UserHistoryCount[] GetValues(User user);
+        protected abstract APIUserHistoryCount[] GetValues(APIUser user);
     }
 }
diff --git a/osu.Game/Overlays/Profile/Sections/Historical/PaginatedMostPlayedBeatmapContainer.cs b/osu.Game/Overlays/Profile/Sections/Historical/PaginatedMostPlayedBeatmapContainer.cs
index 428d04f985..c943d129cc 100644
--- a/osu.Game/Overlays/Profile/Sections/Historical/PaginatedMostPlayedBeatmapContainer.cs
+++ b/osu.Game/Overlays/Profile/Sections/Historical/PaginatedMostPlayedBeatmapContainer.cs
@@ -10,13 +10,13 @@ using osu.Game.Online.API;
 using osu.Game.Online.API.Requests;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Resources.Localisation.Web;
-using osu.Game.Users;
+using APIUser = osu.Game.Online.API.Requests.Responses.APIUser;
 
 namespace osu.Game.Overlays.Profile.Sections.Historical
 {
     public class PaginatedMostPlayedBeatmapContainer : PaginatedProfileSubsection<APIUserMostPlayedBeatmap>
     {
-        public PaginatedMostPlayedBeatmapContainer(Bindable<User> user)
+        public PaginatedMostPlayedBeatmapContainer(Bindable<APIUser> user)
             : base(user, UsersStrings.ShowExtraHistoricalMostPlayedTitle)
         {
             ItemsPerPage = 5;
@@ -28,7 +28,7 @@ namespace osu.Game.Overlays.Profile.Sections.Historical
             ItemsContainer.Direction = FillDirection.Vertical;
         }
 
-        protected override int GetCount(User user) => user.BeatmapPlaycountsCount;
+        protected override int GetCount(APIUser user) => user.BeatmapPlaycountsCount;
 
         protected override APIRequest<List<APIUserMostPlayedBeatmap>> CreateRequest() =>
             new GetUserMostPlayedBeatmapsRequest(User.Value.Id, VisiblePages++, ItemsPerPage);
diff --git a/osu.Game/Overlays/Profile/Sections/Historical/PlayHistorySubsection.cs b/osu.Game/Overlays/Profile/Sections/Historical/PlayHistorySubsection.cs
index 83c005970e..bca88318d5 100644
--- a/osu.Game/Overlays/Profile/Sections/Historical/PlayHistorySubsection.cs
+++ b/osu.Game/Overlays/Profile/Sections/Historical/PlayHistorySubsection.cs
@@ -3,9 +3,8 @@
 
 using osu.Framework.Bindables;
 using osu.Framework.Localisation;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Resources.Localisation.Web;
-using osu.Game.Users;
-using static osu.Game.Users.User;
 
 namespace osu.Game.Overlays.Profile.Sections.Historical
 {
@@ -13,11 +12,11 @@ namespace osu.Game.Overlays.Profile.Sections.Historical
     {
         protected override LocalisableString GraphCounterName => UsersStrings.ShowExtraHistoricalMonthlyPlaycountsCountLabel;
 
-        public PlayHistorySubsection(Bindable<User> user)
+        public PlayHistorySubsection(Bindable<APIUser> user)
             : base(user, UsersStrings.ShowExtraHistoricalMonthlyPlaycountsTitle)
         {
         }
 
-        protected override UserHistoryCount[] GetValues(User user) => user?.MonthlyPlaycounts;
+        protected override APIUserHistoryCount[] GetValues(APIUser user) => user?.MonthlyPlaycounts;
     }
 }
diff --git a/osu.Game/Overlays/Profile/Sections/Historical/ProfileLineChart.cs b/osu.Game/Overlays/Profile/Sections/Historical/ProfileLineChart.cs
index d402438376..c049bff7b2 100644
--- a/osu.Game/Overlays/Profile/Sections/Historical/ProfileLineChart.cs
+++ b/osu.Game/Overlays/Profile/Sections/Historical/ProfileLineChart.cs
@@ -14,16 +14,16 @@ using osu.Game.Graphics;
 using osu.Framework.Graphics.Shapes;
 using osuTK;
 using osu.Framework.Localisation;
-using static osu.Game.Users.User;
+using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Overlays.Profile.Sections.Historical
 {
     public class ProfileLineChart : CompositeDrawable
     {
-        private UserHistoryCount[] values;
+        private APIUserHistoryCount[] values;
 
         [NotNull]
-        public UserHistoryCount[] Values
+        public APIUserHistoryCount[] Values
         {
             get => values;
             set
diff --git a/osu.Game/Overlays/Profile/Sections/Historical/ReplaysSubsection.cs b/osu.Game/Overlays/Profile/Sections/Historical/ReplaysSubsection.cs
index 76d5f73bd7..22312afdc9 100644
--- a/osu.Game/Overlays/Profile/Sections/Historical/ReplaysSubsection.cs
+++ b/osu.Game/Overlays/Profile/Sections/Historical/ReplaysSubsection.cs
@@ -3,9 +3,8 @@
 
 using osu.Framework.Bindables;
 using osu.Framework.Localisation;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Resources.Localisation.Web;
-using osu.Game.Users;
-using static osu.Game.Users.User;
 
 namespace osu.Game.Overlays.Profile.Sections.Historical
 {
@@ -13,11 +12,11 @@ namespace osu.Game.Overlays.Profile.Sections.Historical
     {
         protected override LocalisableString GraphCounterName => UsersStrings.ShowExtraHistoricalReplaysWatchedCountsCountLabel;
 
-        public ReplaysSubsection(Bindable<User> user)
+        public ReplaysSubsection(Bindable<APIUser> user)
             : base(user, UsersStrings.ShowExtraHistoricalReplaysWatchedCountsTitle)
         {
         }
 
-        protected override UserHistoryCount[] GetValues(User user) => user?.ReplaysWatchedCounts;
+        protected override APIUserHistoryCount[] GetValues(APIUser user) => user?.ReplaysWatchedCounts;
     }
 }
diff --git a/osu.Game/Overlays/Profile/Sections/Historical/UserHistoryGraph.cs b/osu.Game/Overlays/Profile/Sections/Historical/UserHistoryGraph.cs
index 61f77cd6ff..f80167f9d3 100644
--- a/osu.Game/Overlays/Profile/Sections/Historical/UserHistoryGraph.cs
+++ b/osu.Game/Overlays/Profile/Sections/Historical/UserHistoryGraph.cs
@@ -7,7 +7,7 @@ using System.Linq;
 using JetBrains.Annotations;
 using osu.Framework.Extensions.LocalisationExtensions;
 using osu.Framework.Localisation;
-using static osu.Game.Users.User;
+using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Overlays.Profile.Sections.Historical
 {
@@ -16,7 +16,7 @@ namespace osu.Game.Overlays.Profile.Sections.Historical
         private readonly LocalisableString tooltipCounterName;
 
         [CanBeNull]
-        public UserHistoryCount[] Values
+        public APIUserHistoryCount[] Values
         {
             set => Data = value?.Select(v => new KeyValuePair<DateTime, long>(v.Date, v.Count)).ToArray();
         }
diff --git a/osu.Game/Overlays/Profile/Sections/Kudosu/KudosuInfo.cs b/osu.Game/Overlays/Profile/Sections/Kudosu/KudosuInfo.cs
index 762716efab..79a06ecdd4 100644
--- a/osu.Game/Overlays/Profile/Sections/Kudosu/KudosuInfo.cs
+++ b/osu.Game/Overlays/Profile/Sections/Kudosu/KudosuInfo.cs
@@ -10,19 +10,19 @@ using osu.Framework.Input.Events;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
-using osu.Game.Users;
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.LocalisationExtensions;
 using osu.Game.Resources.Localisation.Web;
 using osu.Framework.Localisation;
+using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Overlays.Profile.Sections.Kudosu
 {
     public class KudosuInfo : Container
     {
-        private readonly Bindable<User> user = new Bindable<User>();
+        private readonly Bindable<APIUser> user = new Bindable<APIUser>();
 
-        public KudosuInfo(Bindable<User> user)
+        public KudosuInfo(Bindable<APIUser> user)
         {
             this.user.BindTo(user);
             CountSection total;
diff --git a/osu.Game/Overlays/Profile/Sections/Kudosu/PaginatedKudosuHistoryContainer.cs b/osu.Game/Overlays/Profile/Sections/Kudosu/PaginatedKudosuHistoryContainer.cs
index 76cd7ed722..c4837cc0e2 100644
--- a/osu.Game/Overlays/Profile/Sections/Kudosu/PaginatedKudosuHistoryContainer.cs
+++ b/osu.Game/Overlays/Profile/Sections/Kudosu/PaginatedKudosuHistoryContainer.cs
@@ -3,18 +3,18 @@
 
 using osu.Framework.Graphics;
 using osu.Game.Online.API.Requests;
-using osu.Game.Users;
 using osu.Framework.Bindables;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.API;
 using System.Collections.Generic;
 using osu.Game.Resources.Localisation.Web;
+using APIUser = osu.Game.Online.API.Requests.Responses.APIUser;
 
 namespace osu.Game.Overlays.Profile.Sections.Kudosu
 {
     public class PaginatedKudosuHistoryContainer : PaginatedProfileSubsection<APIKudosuHistory>
     {
-        public PaginatedKudosuHistoryContainer(Bindable<User> user)
+        public PaginatedKudosuHistoryContainer(Bindable<APIUser> user)
             : base(user, missingText: UsersStrings.ShowExtraKudosuEntryEmpty)
         {
             ItemsPerPage = 5;
diff --git a/osu.Game/Overlays/Profile/Sections/PaginatedProfileSubsection.cs b/osu.Game/Overlays/Profile/Sections/PaginatedProfileSubsection.cs
index d60243cd0a..affe9ecb0c 100644
--- a/osu.Game/Overlays/Profile/Sections/PaginatedProfileSubsection.cs
+++ b/osu.Game/Overlays/Profile/Sections/PaginatedProfileSubsection.cs
@@ -7,7 +7,6 @@ using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Online.API;
-using osu.Game.Users;
 using System.Collections.Generic;
 using System.Linq;
 using System.Threading;
@@ -16,6 +15,7 @@ using osu.Game.Rulesets;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics;
 using osu.Framework.Localisation;
+using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Overlays.Profile.Sections
 {
@@ -39,7 +39,7 @@ namespace osu.Game.Overlays.Profile.Sections
         private OsuSpriteText missing;
         private readonly LocalisableString? missingText;
 
-        protected PaginatedProfileSubsection(Bindable<User> user, LocalisableString? headerText = null, LocalisableString? missingText = null)
+        protected PaginatedProfileSubsection(Bindable<APIUser> user, LocalisableString? headerText = null, LocalisableString? missingText = null)
             : base(user, headerText, CounterVisibilityState.AlwaysVisible)
         {
             this.missingText = missingText;
@@ -81,7 +81,7 @@ namespace osu.Game.Overlays.Profile.Sections
             User.BindValueChanged(onUserChanged, true);
         }
 
-        private void onUserChanged(ValueChangedEvent<User> e)
+        private void onUserChanged(ValueChangedEvent<APIUser> e)
         {
             loadCancellation?.Cancel();
             retrievalRequest?.Cancel();
@@ -131,7 +131,7 @@ namespace osu.Game.Overlays.Profile.Sections
             }, loadCancellation.Token);
         });
 
-        protected virtual int GetCount(User user) => 0;
+        protected virtual int GetCount(APIUser user) => 0;
 
         protected virtual void OnItemsReceived(List<TModel> items)
         {
diff --git a/osu.Game/Overlays/Profile/Sections/ProfileSubsection.cs b/osu.Game/Overlays/Profile/Sections/ProfileSubsection.cs
index 5a17f0d8bb..fdf8cb19ff 100644
--- a/osu.Game/Overlays/Profile/Sections/ProfileSubsection.cs
+++ b/osu.Game/Overlays/Profile/Sections/ProfileSubsection.cs
@@ -5,22 +5,22 @@ using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
-using osu.Game.Users;
 using JetBrains.Annotations;
 using osu.Framework.Localisation;
+using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Overlays.Profile.Sections
 {
     public abstract class ProfileSubsection : FillFlowContainer
     {
-        protected readonly Bindable<User> User = new Bindable<User>();
+        protected readonly Bindable<APIUser> User = new Bindable<APIUser>();
 
         private readonly LocalisableString headerText;
         private readonly CounterVisibilityState counterVisibilityState;
 
         private ProfileSubsectionHeader header;
 
-        protected ProfileSubsection(Bindable<User> user, LocalisableString? headerText = null, CounterVisibilityState counterVisibilityState = CounterVisibilityState.AlwaysHidden)
+        protected ProfileSubsection(Bindable<APIUser> user, LocalisableString? headerText = null, CounterVisibilityState counterVisibilityState = CounterVisibilityState.AlwaysHidden)
         {
             this.headerText = headerText ?? string.Empty;
             this.counterVisibilityState = counterVisibilityState;
diff --git a/osu.Game/Overlays/Profile/Sections/Ranks/PaginatedScoreContainer.cs b/osu.Game/Overlays/Profile/Sections/Ranks/PaginatedScoreContainer.cs
index cde386bc7b..c3f10587a9 100644
--- a/osu.Game/Overlays/Profile/Sections/Ranks/PaginatedScoreContainer.cs
+++ b/osu.Game/Overlays/Profile/Sections/Ranks/PaginatedScoreContainer.cs
@@ -3,7 +3,6 @@
 
 using osu.Framework.Graphics.Containers;
 using osu.Game.Online.API.Requests;
-using osu.Game.Users;
 using System;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
@@ -12,6 +11,7 @@ using System.Collections.Generic;
 using osu.Game.Online.API;
 using osu.Framework.Allocation;
 using osu.Framework.Localisation;
+using APIUser = osu.Game.Online.API.Requests.Responses.APIUser;
 
 namespace osu.Game.Overlays.Profile.Sections.Ranks
 {
@@ -19,7 +19,7 @@ namespace osu.Game.Overlays.Profile.Sections.Ranks
     {
         private readonly ScoreType type;
 
-        public PaginatedScoreContainer(ScoreType type, Bindable<User> user, LocalisableString headerText)
+        public PaginatedScoreContainer(ScoreType type, Bindable<APIUser> user, LocalisableString headerText)
             : base(user, headerText)
         {
             this.type = type;
@@ -33,7 +33,7 @@ namespace osu.Game.Overlays.Profile.Sections.Ranks
             ItemsContainer.Direction = FillDirection.Vertical;
         }
 
-        protected override int GetCount(User user)
+        protected override int GetCount(APIUser user)
         {
             switch (type)
             {
diff --git a/osu.Game/Overlays/Profile/Sections/Recent/PaginatedRecentActivityContainer.cs b/osu.Game/Overlays/Profile/Sections/Recent/PaginatedRecentActivityContainer.cs
index db2e6bc1e0..c5ff896654 100644
--- a/osu.Game/Overlays/Profile/Sections/Recent/PaginatedRecentActivityContainer.cs
+++ b/osu.Game/Overlays/Profile/Sections/Recent/PaginatedRecentActivityContainer.cs
@@ -3,7 +3,6 @@
 
 using osu.Framework.Graphics;
 using osu.Game.Online.API.Requests;
-using osu.Game.Users;
 using osu.Framework.Bindables;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.API;
@@ -11,12 +10,13 @@ using System.Collections.Generic;
 using osuTK;
 using osu.Framework.Allocation;
 using osu.Game.Resources.Localisation.Web;
+using APIUser = osu.Game.Online.API.Requests.Responses.APIUser;
 
 namespace osu.Game.Overlays.Profile.Sections.Recent
 {
     public class PaginatedRecentActivityContainer : PaginatedProfileSubsection<APIRecentActivity>
     {
-        public PaginatedRecentActivityContainer(Bindable<User> user)
+        public PaginatedRecentActivityContainer(Bindable<APIUser> user)
             : base(user, missingText: EventsStrings.Empty)
         {
             ItemsPerPage = 10;
diff --git a/osu.Game/Overlays/Settings/Sections/UserInterface/MainMenuSettings.cs b/osu.Game/Overlays/Settings/Sections/UserInterface/MainMenuSettings.cs
index 40485a070c..284e9cb2de 100644
--- a/osu.Game/Overlays/Settings/Sections/UserInterface/MainMenuSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/UserInterface/MainMenuSettings.cs
@@ -8,7 +8,7 @@ using osu.Framework.Localisation;
 using osu.Game.Configuration;
 using osu.Game.Localisation;
 using osu.Game.Online.API;
-using osu.Game.Users;
+using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Overlays.Settings.Sections.UserInterface
 {
@@ -16,7 +16,7 @@ namespace osu.Game.Overlays.Settings.Sections.UserInterface
     {
         protected override LocalisableString Header => UserInterfaceStrings.MainMenuHeader;
 
-        private IBindable<User> user;
+        private IBindable<APIUser> user;
 
         private SettingsEnumDropdown<BackgroundSource> backgroundSourceDropdown;
 
diff --git a/osu.Game/Overlays/Toolbar/ToolbarUserButton.cs b/osu.Game/Overlays/Toolbar/ToolbarUserButton.cs
index 5d4430caa2..b0c9a04285 100644
--- a/osu.Game/Overlays/Toolbar/ToolbarUserButton.cs
+++ b/osu.Game/Overlays/Toolbar/ToolbarUserButton.cs
@@ -8,7 +8,7 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Effects;
 using osu.Game.Graphics;
 using osu.Game.Online.API;
-using osu.Game.Users;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Users.Drawables;
 using osuTK;
 using osuTK.Graphics;
@@ -63,7 +63,7 @@ namespace osu.Game.Overlays.Toolbar
             {
                 default:
                     Text = @"Guest";
-                    avatar.User = new User();
+                    avatar.User = new APIUser();
                     break;
 
                 case APIState.Online:
diff --git a/osu.Game/Overlays/UserProfileOverlay.cs b/osu.Game/Overlays/UserProfileOverlay.cs
index b0327987f2..d9b4e68a75 100644
--- a/osu.Game/Overlays/UserProfileOverlay.cs
+++ b/osu.Game/Overlays/UserProfileOverlay.cs
@@ -11,9 +11,9 @@ using osu.Framework.Graphics.UserInterface;
 using osu.Framework.Input.Events;
 using osu.Game.Graphics.Containers;
 using osu.Game.Online.API.Requests;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays.Profile;
 using osu.Game.Overlays.Profile.Sections;
-using osu.Game.Users;
 using osuTK;
 using osuTK.Graphics;
 
@@ -38,13 +38,13 @@ namespace osu.Game.Overlays
 
         protected override Color4 BackgroundColour => ColourProvider.Background6;
 
-        public void ShowUser(int userId) => ShowUser(new User { Id = userId });
+        public void ShowUser(int userId) => ShowUser(new APIUser { Id = userId });
 
-        public void ShowUser(string username) => ShowUser(new User { Username = username });
+        public void ShowUser(string username) => ShowUser(new APIUser { Username = username });
 
-        public void ShowUser(User user, bool fetchOnline = true)
+        public void ShowUser(APIUser user, bool fetchOnline = true)
         {
-            if (user == User.SYSTEM_USER)
+            if (user == APIUser.SYSTEM_USER)
                 return;
 
             Show();
@@ -131,7 +131,7 @@ namespace osu.Game.Overlays
             sectionsContainer.ScrollToTop();
         }
 
-        private void userLoadComplete(User user)
+        private void userLoadComplete(APIUser user)
         {
             Header.User.Value = user;
 
diff --git a/osu.Game/Scoring/IScoreInfo.cs b/osu.Game/Scoring/IScoreInfo.cs
index 77579f23d9..21a402f8c3 100644
--- a/osu.Game/Scoring/IScoreInfo.cs
+++ b/osu.Game/Scoring/IScoreInfo.cs
@@ -4,14 +4,14 @@
 using System;
 using osu.Game.Beatmaps;
 using osu.Game.Database;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets;
-using osu.Game.Users;
 
 namespace osu.Game.Scoring
 {
     public interface IScoreInfo : IHasOnlineID<long>
     {
-        User User { get; }
+        APIUser User { get; }
 
         long TotalScore { get; }
 
diff --git a/osu.Game/Scoring/Legacy/LegacyScoreDecoder.cs b/osu.Game/Scoring/Legacy/LegacyScoreDecoder.cs
index 379718195c..7bfe0308f7 100644
--- a/osu.Game/Scoring/Legacy/LegacyScoreDecoder.cs
+++ b/osu.Game/Scoring/Legacy/LegacyScoreDecoder.cs
@@ -8,12 +8,12 @@ using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.Formats;
 using osu.Game.Beatmaps.Legacy;
 using osu.Game.IO.Legacy;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Replays;
 using osu.Game.Replays.Legacy;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Replays;
-using osu.Game.Users;
 using SharpCompress.Compressors.LZMA;
 
 namespace osu.Game.Scoring.Legacy
@@ -45,7 +45,7 @@ namespace osu.Game.Scoring.Legacy
                 if (workingBeatmap is DummyWorkingBeatmap)
                     throw new BeatmapNotFoundException();
 
-                scoreInfo.User = new User { Username = sr.ReadString() };
+                scoreInfo.User = new APIUser { Username = sr.ReadString() };
 
                 // MD5Hash
                 sr.ReadString();
diff --git a/osu.Game/Scoring/ScoreInfo.cs b/osu.Game/Scoring/ScoreInfo.cs
index 36608e2a74..e5b050fc01 100644
--- a/osu.Game/Scoring/ScoreInfo.cs
+++ b/osu.Game/Scoring/ScoreInfo.cs
@@ -10,10 +10,10 @@ using osu.Framework.Localisation;
 using osu.Game.Beatmaps;
 using osu.Game.Database;
 using osu.Game.Online.API;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Scoring;
-using osu.Game.Users;
 using osu.Game.Utils;
 
 namespace osu.Game.Scoring
@@ -105,7 +105,7 @@ namespace osu.Game.Scoring
         }
 
         [NotMapped]
-        public User User { get; set; }
+        public APIUser User { get; set; }
 
         [Column("User")]
         public string UserString
@@ -113,7 +113,7 @@ namespace osu.Game.Scoring
             get => User?.Username;
             set
             {
-                User ??= new User();
+                User ??= new APIUser();
                 User.Username = value;
             }
         }
@@ -124,7 +124,7 @@ namespace osu.Game.Scoring
             get => User?.Id ?? 1;
             set
             {
-                User ??= new User();
+                User ??= new APIUser();
                 User.Id = value ?? 1;
             }
         }
diff --git a/osu.Game/Screens/Backgrounds/BackgroundScreenDefault.cs b/osu.Game/Screens/Backgrounds/BackgroundScreenDefault.cs
index f0c90cc409..4a922c45b9 100644
--- a/osu.Game/Screens/Backgrounds/BackgroundScreenDefault.cs
+++ b/osu.Game/Screens/Backgrounds/BackgroundScreenDefault.cs
@@ -11,8 +11,8 @@ using osu.Game.Beatmaps;
 using osu.Game.Configuration;
 using osu.Game.Graphics.Backgrounds;
 using osu.Game.Online.API;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Skinning;
-using osu.Game.Users;
 
 namespace osu.Game.Screens.Backgrounds
 {
@@ -22,7 +22,7 @@ namespace osu.Game.Screens.Backgrounds
 
         private int currentDisplay;
         private const int background_count = 7;
-        private IBindable<User> user;
+        private IBindable<APIUser> user;
         private Bindable<Skin> skin;
         private Bindable<BackgroundSource> mode;
         private Bindable<IntroSequence> introSequence;
diff --git a/osu.Game/Screens/Menu/Disclaimer.cs b/osu.Game/Screens/Menu/Disclaimer.cs
index b8abc131fd..22151db0dd 100644
--- a/osu.Game/Screens/Menu/Disclaimer.cs
+++ b/osu.Game/Screens/Menu/Disclaimer.cs
@@ -14,9 +14,9 @@ using osu.Framework.Utils;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Online.API;
+using osu.Game.Online.API.Requests.Responses;
 using osuTK;
 using osuTK.Graphics;
-using osu.Game.Users;
 
 namespace osu.Game.Screens.Menu
 {
@@ -34,7 +34,7 @@ namespace osu.Game.Screens.Menu
 
         private readonly OsuScreen nextScreen;
 
-        private readonly Bindable<User> currentUser = new Bindable<User>();
+        private readonly Bindable<APIUser> currentUser = new Bindable<APIUser>();
         private FillFlowContainer fill;
 
         private readonly List<ITextPart> expendableText = new List<ITextPart>();
@@ -168,7 +168,7 @@ namespace osu.Game.Screens.Menu
             if (nextScreen != null)
                 LoadComponentAsync(nextScreen);
 
-            ((IBindable<User>)currentUser).BindTo(api.LocalUser);
+            ((IBindable<APIUser>)currentUser).BindTo(api.LocalUser);
         }
 
         public override void OnEntering(IScreen last)
diff --git a/osu.Game/Screens/Menu/MenuLogoVisualisation.cs b/osu.Game/Screens/Menu/MenuLogoVisualisation.cs
index c44beeffa5..f461136022 100644
--- a/osu.Game/Screens/Menu/MenuLogoVisualisation.cs
+++ b/osu.Game/Screens/Menu/MenuLogoVisualisation.cs
@@ -4,15 +4,15 @@
 using osuTK.Graphics;
 using osu.Game.Skinning;
 using osu.Game.Online.API;
-using osu.Game.Users;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
+using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Screens.Menu
 {
     internal class MenuLogoVisualisation : LogoVisualisation
     {
-        private IBindable<User> user;
+        private IBindable<APIUser> user;
         private Bindable<Skin> skin;
 
         [BackgroundDependencyLoader]
diff --git a/osu.Game/Screens/Menu/MenuSideFlashes.cs b/osu.Game/Screens/Menu/MenuSideFlashes.cs
index a1ae4555ed..bdcd3020f8 100644
--- a/osu.Game/Screens/Menu/MenuSideFlashes.cs
+++ b/osu.Game/Screens/Menu/MenuSideFlashes.cs
@@ -13,10 +13,10 @@ using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Skinning;
 using osu.Game.Online.API;
-using osu.Game.Users;
 using System;
 using osu.Framework.Audio.Track;
 using osu.Framework.Bindables;
+using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Screens.Menu
 {
@@ -35,7 +35,7 @@ namespace osu.Game.Screens.Menu
         private const double box_fade_in_time = 65;
         private const int box_width = 200;
 
-        private IBindable<User> user;
+        private IBindable<APIUser> user;
         private Bindable<Skin> skin;
 
         [Resolved]
diff --git a/osu.Game/Screens/OnlinePlay/Components/ParticipantsList.cs b/osu.Game/Screens/OnlinePlay/Components/ParticipantsList.cs
index e531ddb0ec..1d5552fa7d 100644
--- a/osu.Game/Screens/OnlinePlay/Components/ParticipantsList.cs
+++ b/osu.Game/Screens/OnlinePlay/Components/ParticipantsList.cs
@@ -7,7 +7,7 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Threading;
-using osu.Game.Users;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Users.Drawables;
 using osuTK;
 
@@ -92,7 +92,7 @@ namespace osu.Game.Screens.OnlinePlay.Components
 
         private class UserTile : CompositeDrawable
         {
-            public User User
+            public APIUser User
             {
                 get => avatar.User;
                 set => avatar.User = value;
diff --git a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
index 0681ac23ad..c22b9bd9aa 100644
--- a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
+++ b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
@@ -20,6 +20,7 @@ using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Online;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Chat;
 using osu.Game.Online.Rooms;
 using osu.Game.Overlays.BeatmapListing.Panels;
@@ -27,7 +28,6 @@ using osu.Game.Overlays.BeatmapSet;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Screens.Play.HUD;
-using osu.Game.Users;
 using osuTK;
 using osuTK.Graphics;
 
@@ -122,7 +122,7 @@ namespace osu.Game.Screens.OnlinePlay
             if (!string.IsNullOrEmpty(Item.Beatmap.Value?.Metadata.Author))
             {
                 authorText.AddText("mapped by ");
-                authorText.AddUserLink(new User { Username = Item.Beatmap.Value.Metadata.Author });
+                authorText.AddUserLink(new APIUser { Username = Item.Beatmap.Value.Metadata.Author });
             }
 
             bool hasExplicitContent = (Item.Beatmap.Value.BeatmapSet as IBeatmapSetOnlineInfo)?.HasExplicitContent == true;
diff --git a/osu.Game/Screens/OnlinePlay/Lounge/Components/DrawableRoomParticipantsList.cs b/osu.Game/Screens/OnlinePlay/Lounge/Components/DrawableRoomParticipantsList.cs
index 31eb5db9bc..10bd534b89 100644
--- a/osu.Game/Screens/OnlinePlay/Lounge/Components/DrawableRoomParticipantsList.cs
+++ b/osu.Game/Screens/OnlinePlay/Lounge/Components/DrawableRoomParticipantsList.cs
@@ -12,8 +12,8 @@ using osu.Framework.Graphics.Sprites;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays;
-using osu.Game.Users;
 using osu.Game.Users.Drawables;
 using osuTK;
 
@@ -195,12 +195,12 @@ namespace osu.Game.Screens.OnlinePlay.Lounge.Components
             switch (e.Action)
             {
                 case NotifyCollectionChangedAction.Add:
-                    foreach (var added in e.NewItems.OfType<User>())
+                    foreach (var added in e.NewItems.OfType<APIUser>())
                         addUser(added);
                     break;
 
                 case NotifyCollectionChangedAction.Remove:
-                    foreach (var removed in e.OldItems.OfType<User>())
+                    foreach (var removed in e.OldItems.OfType<APIUser>())
                         removeUser(removed);
                     break;
 
@@ -222,13 +222,13 @@ namespace osu.Game.Screens.OnlinePlay.Lounge.Components
 
         private int displayedCircles => avatarFlow.Count + (hiddenUsers.Count > 0 ? 1 : 0);
 
-        private void addUser(User user)
+        private void addUser(APIUser user)
         {
             if (displayedCircles < NumberOfCircles)
                 avatarFlow.Add(new CircularAvatar { User = user });
         }
 
-        private void removeUser(User user)
+        private void removeUser(APIUser user)
         {
             avatarFlow.RemoveAll(a => a.User == user);
         }
@@ -256,7 +256,7 @@ namespace osu.Game.Screens.OnlinePlay.Lounge.Components
             }
         }
 
-        private void onHostChanged(ValueChangedEvent<User> host)
+        private void onHostChanged(ValueChangedEvent<APIUser> host)
         {
             hostAvatar.User = host.NewValue;
             hostText.Clear();
@@ -270,7 +270,7 @@ namespace osu.Game.Screens.OnlinePlay.Lounge.Components
 
         private class CircularAvatar : CompositeDrawable
         {
-            public User User
+            public APIUser User
             {
                 get => avatar.User;
                 set => avatar.User = value;
diff --git a/osu.Game/Screens/OnlinePlay/Match/DrawableMatchRoom.cs b/osu.Game/Screens/OnlinePlay/Match/DrawableMatchRoom.cs
index e83403850f..a7b907c7d2 100644
--- a/osu.Game/Screens/OnlinePlay/Match/DrawableMatchRoom.cs
+++ b/osu.Game/Screens/OnlinePlay/Match/DrawableMatchRoom.cs
@@ -8,10 +8,10 @@ using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Game.Beatmaps.Drawables;
 using osu.Game.Online.API;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Rooms;
 using osu.Game.Screens.OnlinePlay.Lounge.Components;
 using osu.Game.Screens.OnlinePlay.Match.Components;
-using osu.Game.Users;
 using osuTK;
 
 namespace osu.Game.Screens.OnlinePlay.Match
@@ -24,7 +24,7 @@ namespace osu.Game.Screens.OnlinePlay.Match
         [Resolved]
         private IAPIProvider api { get; set; }
 
-        private readonly IBindable<User> host = new Bindable<User>();
+        private readonly IBindable<APIUser> host = new Bindable<APIUser>();
         private readonly bool allowEdit;
 
         [CanBeNull]
diff --git a/osu.Game/Screens/OnlinePlay/OnlinePlayComposite.cs b/osu.Game/Screens/OnlinePlay/OnlinePlayComposite.cs
index aa971864ef..cf274a3a21 100644
--- a/osu.Game/Screens/OnlinePlay/OnlinePlayComposite.cs
+++ b/osu.Game/Screens/OnlinePlay/OnlinePlayComposite.cs
@@ -6,9 +6,9 @@ using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics.Containers;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Rooms;
 using osu.Game.Screens.OnlinePlay.Match;
-using osu.Game.Users;
 
 namespace osu.Game.Screens.OnlinePlay
 {
@@ -24,7 +24,7 @@ namespace osu.Game.Screens.OnlinePlay
         protected Bindable<string> RoomName { get; private set; }
 
         [Resolved(typeof(Room))]
-        protected Bindable<User> Host { get; private set; }
+        protected Bindable<APIUser> Host { get; private set; }
 
         [Resolved(typeof(Room))]
         protected Bindable<RoomStatus> Status { get; private set; }
@@ -39,7 +39,7 @@ namespace osu.Game.Screens.OnlinePlay
         protected Bindable<RoomCategory> Category { get; private set; }
 
         [Resolved(typeof(Room))]
-        protected BindableList<User> RecentParticipants { get; private set; }
+        protected BindableList<APIUser> RecentParticipants { get; private set; }
 
         [Resolved(typeof(Room))]
         protected Bindable<int> ParticipantCount { get; private set; }
diff --git a/osu.Game/Screens/Play/HUD/GameplayLeaderboard.cs b/osu.Game/Screens/Play/HUD/GameplayLeaderboard.cs
index 871555e5a3..638b2c395f 100644
--- a/osu.Game/Screens/Play/HUD/GameplayLeaderboard.cs
+++ b/osu.Game/Screens/Play/HUD/GameplayLeaderboard.cs
@@ -11,7 +11,7 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Colour;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Graphics.Containers;
-using osu.Game.Users;
+using osu.Game.Online.API.Requests.Responses;
 using osuTK;
 using osuTK.Graphics;
 
@@ -75,7 +75,7 @@ namespace osu.Game.Screens.Play.HUD
         /// Whether the player should be tracked on the leaderboard.
         /// Set to <c>true</c> for the local player or a player whose replay is currently being played.
         /// </param>
-        public ILeaderboardScore Add([CanBeNull] User user, bool isTracked)
+        public ILeaderboardScore Add([CanBeNull] APIUser user, bool isTracked)
         {
             var drawable = CreateLeaderboardScoreDrawable(user, isTracked);
 
@@ -106,7 +106,7 @@ namespace osu.Game.Screens.Play.HUD
             scroll.ScrollToStart(false);
         }
 
-        protected virtual GameplayLeaderboardScore CreateLeaderboardScoreDrawable(User user, bool isTracked) =>
+        protected virtual GameplayLeaderboardScore CreateLeaderboardScoreDrawable(APIUser user, bool isTracked) =>
             new GameplayLeaderboardScore(user, isTracked);
 
         protected override void Update()
diff --git a/osu.Game/Screens/Play/HUD/GameplayLeaderboardScore.cs b/osu.Game/Screens/Play/HUD/GameplayLeaderboardScore.cs
index 85cf9d1966..773ee4a036 100644
--- a/osu.Game/Screens/Play/HUD/GameplayLeaderboardScore.cs
+++ b/osu.Game/Screens/Play/HUD/GameplayLeaderboardScore.cs
@@ -10,7 +10,7 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
-using osu.Game.Users;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Users.Drawables;
 using osu.Game.Utils;
 using osuTK;
@@ -79,7 +79,7 @@ namespace osu.Game.Screens.Play.HUD
         }
 
         [CanBeNull]
-        public User User { get; }
+        public APIUser User { get; }
 
         /// <summary>
         /// Whether this score is the local user or a replay player (and should be focused / always visible).
@@ -101,7 +101,7 @@ namespace osu.Game.Screens.Play.HUD
         /// </summary>
         /// <param name="user">The score's player.</param>
         /// <param name="tracked">Whether the player is the local user or a replay player.</param>
-        public GameplayLeaderboardScore([CanBeNull] User user, bool tracked)
+        public GameplayLeaderboardScore([CanBeNull] APIUser user, bool tracked)
         {
             User = user;
             Tracked = tracked;
diff --git a/osu.Game/Screens/Play/HUD/MultiplayerGameplayLeaderboard.cs b/osu.Game/Screens/Play/HUD/MultiplayerGameplayLeaderboard.cs
index 7caf90f610..e019ee9a3d 100644
--- a/osu.Game/Screens/Play/HUD/MultiplayerGameplayLeaderboard.cs
+++ b/osu.Game/Screens/Play/HUD/MultiplayerGameplayLeaderboard.cs
@@ -12,11 +12,11 @@ using osu.Game.Configuration;
 using osu.Game.Database;
 using osu.Game.Graphics;
 using osu.Game.Online.API;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Multiplayer.MatchTypes.TeamVersus;
 using osu.Game.Online.Spectator;
 using osu.Game.Rulesets.Scoring;
-using osu.Game.Users;
 using osuTK.Graphics;
 
 namespace osu.Game.Screens.Play.HUD
@@ -118,7 +118,7 @@ namespace osu.Game.Screens.Play.HUD
 
         protected virtual TrackedUserData CreateUserData(MultiplayerRoomUser user, ScoreProcessor scoreProcessor) => new TrackedUserData(user, scoreProcessor);
 
-        protected override GameplayLeaderboardScore CreateLeaderboardScoreDrawable(User user, bool isTracked)
+        protected override GameplayLeaderboardScore CreateLeaderboardScoreDrawable(APIUser user, bool isTracked)
         {
             var leaderboardScore = base.CreateLeaderboardScoreDrawable(user, isTracked);
 
diff --git a/osu.Game/Screens/Play/SoloSpectator.cs b/osu.Game/Screens/Play/SoloSpectator.cs
index 250738df39..1dcc191c0f 100644
--- a/osu.Game/Screens/Play/SoloSpectator.cs
+++ b/osu.Game/Screens/Play/SoloSpectator.cs
@@ -27,6 +27,7 @@ using osu.Game.Screens.OnlinePlay.Match.Components;
 using osu.Game.Screens.Spectate;
 using osu.Game.Users;
 using osuTK;
+using APIUser = osu.Game.Online.API.Requests.Responses.APIUser;
 
 namespace osu.Game.Screens.Play
 {
@@ -34,7 +35,7 @@ namespace osu.Game.Screens.Play
     public class SoloSpectator : SpectatorScreen, IPreviewTrackOwner
     {
         [NotNull]
-        private readonly User targetUser;
+        private readonly APIUser targetUser;
 
         [Resolved]
         private IAPIProvider api { get; set; }
@@ -62,7 +63,7 @@ namespace osu.Game.Screens.Play
 
         private APIBeatmapSet beatmapSet;
 
-        public SoloSpectator([NotNull] User targetUser)
+        public SoloSpectator([NotNull] APIUser targetUser)
             : base(targetUser.Id)
         {
             this.targetUser = targetUser;
diff --git a/osu.Game/Screens/Ranking/Expanded/ExpandedPanelTopContent.cs b/osu.Game/Screens/Ranking/Expanded/ExpandedPanelTopContent.cs
index 5dfc43cc29..bf06bc2227 100644
--- a/osu.Game/Screens/Ranking/Expanded/ExpandedPanelTopContent.cs
+++ b/osu.Game/Screens/Ranking/Expanded/ExpandedPanelTopContent.cs
@@ -6,7 +6,7 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
-using osu.Game.Users;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Users.Drawables;
 using osuTK;
 
@@ -17,13 +17,13 @@ namespace osu.Game.Screens.Ranking.Expanded
     /// </summary>
     public class ExpandedPanelTopContent : CompositeDrawable
     {
-        private readonly User user;
+        private readonly APIUser user;
 
         /// <summary>
         /// Creates a new <see cref="ExpandedPanelTopContent"/>.
         /// </summary>
-        /// <param name="user">The <see cref="User"/> to display.</param>
-        public ExpandedPanelTopContent(User user)
+        /// <param name="user">The <see cref="APIUser"/> to display.</param>
+        public ExpandedPanelTopContent(APIUser user)
         {
             this.user = user;
             Anchor = Anchor.TopCentre;
diff --git a/osu.Game/Screens/Spectate/SpectatorScreen.cs b/osu.Game/Screens/Spectate/SpectatorScreen.cs
index c8df01dae6..1c0483fa42 100644
--- a/osu.Game/Screens/Spectate/SpectatorScreen.cs
+++ b/osu.Game/Screens/Spectate/SpectatorScreen.cs
@@ -11,11 +11,11 @@ using osu.Framework.Bindables;
 using osu.Framework.Extensions.ObjectExtensions;
 using osu.Game.Beatmaps;
 using osu.Game.Database;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Spectator;
 using osu.Game.Replays;
 using osu.Game.Rulesets;
 using osu.Game.Scoring;
-using osu.Game.Users;
 
 namespace osu.Game.Screens.Spectate
 {
@@ -42,7 +42,7 @@ namespace osu.Game.Screens.Spectate
 
         private readonly IBindableDictionary<int, SpectatorState> playingUserStates = new BindableDictionary<int, SpectatorState>();
 
-        private readonly Dictionary<int, User> userMap = new Dictionary<int, User>();
+        private readonly Dictionary<int, APIUser> userMap = new Dictionary<int, APIUser>();
         private readonly Dictionary<int, SpectatorGameplayState> gameplayStates = new Dictionary<int, SpectatorGameplayState>();
 
         private IBindable<WeakReference<BeatmapSetInfo>> managerUpdated;
diff --git a/osu.Game/Tests/Beatmaps/HitObjectSampleTest.cs b/osu.Game/Tests/Beatmaps/HitObjectSampleTest.cs
index bb5dd09e16..b87c3d57c2 100644
--- a/osu.Game/Tests/Beatmaps/HitObjectSampleTest.cs
+++ b/osu.Game/Tests/Beatmaps/HitObjectSampleTest.cs
@@ -15,13 +15,13 @@ using osu.Framework.Timing;
 using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.Formats;
 using osu.Game.IO;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Objects;
 using osu.Game.Screens.Ranking;
 using osu.Game.Skinning;
 using osu.Game.Storyboards;
 using osu.Game.Tests.Visual;
-using osu.Game.Users;
 
 namespace osu.Game.Tests.Beatmaps
 {
@@ -41,7 +41,7 @@ namespace osu.Game.Tests.Beatmaps
             BeatmapSet = new BeatmapSetInfo(),
             Metadata = new BeatmapMetadata
             {
-                Author = User.SYSTEM_USER
+                Author = APIUser.SYSTEM_USER
             }
         };
 
diff --git a/osu.Game/Tests/TestScoreInfo.cs b/osu.Game/Tests/TestScoreInfo.cs
index 719d31b092..a53cb0ae78 100644
--- a/osu.Game/Tests/TestScoreInfo.cs
+++ b/osu.Game/Tests/TestScoreInfo.cs
@@ -3,12 +3,12 @@
 
 using System;
 using System.Linq;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Scoring;
 using osu.Game.Scoring;
 using osu.Game.Tests.Beatmaps;
-using osu.Game.Users;
 
 namespace osu.Game.Tests
 {
@@ -16,7 +16,7 @@ namespace osu.Game.Tests
     {
         public TestScoreInfo(RulesetInfo ruleset, bool excessMods = false)
         {
-            User = new User
+            User = new APIUser
             {
                 Id = 2,
                 Username = "peppy",
diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
index 70d907ba15..0860e45346 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
@@ -18,7 +18,7 @@ using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Multiplayer.MatchTypes.TeamVersus;
 using osu.Game.Online.Rooms;
 using osu.Game.Rulesets.Mods;
-using osu.Game.Users;
+using APIUser = osu.Game.Online.API.Requests.Responses.APIUser;
 
 namespace osu.Game.Tests.Visual.Multiplayer
 {
@@ -51,7 +51,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
         public void Disconnect() => isConnected.Value = false;
 
-        public MultiplayerRoomUser AddUser(User user, bool markAsPlaying = false)
+        public MultiplayerRoomUser AddUser(APIUser user, bool markAsPlaying = false)
         {
             var roomUser = new MultiplayerRoomUser(user.Id) { User = user };
 
@@ -73,7 +73,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             Scheduler.Update();
         }
 
-        public void RemoveUser(User user)
+        public void RemoveUser(APIUser user)
         {
             Debug.Assert(Room != null);
             ((IMultiplayerClient)this).UserLeft(new MultiplayerRoomUser(user.Id));
diff --git a/osu.Game/Tests/Visual/OnlinePlay/TestRoomManager.cs b/osu.Game/Tests/Visual/OnlinePlay/TestRoomManager.cs
index 5fe3dc8406..4cbc6174c9 100644
--- a/osu.Game/Tests/Visual/OnlinePlay/TestRoomManager.cs
+++ b/osu.Game/Tests/Visual/OnlinePlay/TestRoomManager.cs
@@ -3,10 +3,10 @@
 
 using System;
 using osu.Game.Beatmaps;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Rooms;
 using osu.Game.Rulesets;
 using osu.Game.Screens.OnlinePlay.Components;
-using osu.Game.Users;
 
 namespace osu.Game.Tests.Visual.OnlinePlay
 {
@@ -33,7 +33,7 @@ namespace osu.Game.Tests.Visual.OnlinePlay
                 {
                     RoomID = { Value = -currentRoomId },
                     Name = { Value = $@"Room {currentRoomId}" },
-                    Host = { Value = new User { Username = @"Host" } },
+                    Host = { Value = new APIUser { Username = @"Host" } },
                     EndDate = { Value = DateTimeOffset.Now + TimeSpan.FromSeconds(10) },
                     Category = { Value = i % 2 == 0 ? RoomCategory.Spotlight : RoomCategory.Normal },
                 };
diff --git a/osu.Game/Tests/Visual/OnlinePlay/TestRoomRequestsHandler.cs b/osu.Game/Tests/Visual/OnlinePlay/TestRoomRequestsHandler.cs
index 7f975c9985..dc12e48297 100644
--- a/osu.Game/Tests/Visual/OnlinePlay/TestRoomRequestsHandler.cs
+++ b/osu.Game/Tests/Visual/OnlinePlay/TestRoomRequestsHandler.cs
@@ -7,11 +7,11 @@ using System.Linq;
 using osu.Framework.Allocation;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Rooms;
 using osu.Game.Rulesets.Scoring;
 using osu.Game.Scoring;
 using osu.Game.Screens.OnlinePlay.Components;
-using osu.Game.Users;
 
 namespace osu.Game.Tests.Visual.OnlinePlay
 {
@@ -37,7 +37,7 @@ namespace osu.Game.Tests.Visual.OnlinePlay
         /// <param name="localUser">The local user to store in responses where required.</param>
         /// <param name="game">The game base for cases where actual online requests need to be sent.</param>
         /// <returns>Whether the request was successfully handled.</returns>
-        public bool HandleRequest(APIRequest request, User localUser, OsuGameBase game)
+        public bool HandleRequest(APIRequest request, APIUser localUser, OsuGameBase game)
         {
             switch (request)
             {
diff --git a/osu.Game/Tests/Visual/TestUserLookupCache.cs b/osu.Game/Tests/Visual/TestUserLookupCache.cs
index fcb9c070ff..ce1bbd5f15 100644
--- a/osu.Game/Tests/Visual/TestUserLookupCache.cs
+++ b/osu.Game/Tests/Visual/TestUserLookupCache.cs
@@ -4,24 +4,24 @@
 using System.Threading;
 using System.Threading.Tasks;
 using osu.Game.Database;
-using osu.Game.Users;
+using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Tests.Visual
 {
     public class TestUserLookupCache : UserLookupCache
     {
         /// <summary>
-        /// A special user ID which <see cref="ComputeValueAsync"/> would return a <see langword="null"/> <see cref="User"/> for.
+        /// A special user ID which <see cref="ComputeValueAsync"/> would return a <see langword="null"/> <see cref="APIUser"/> for.
         /// As a simulation to what a regular <see cref="UserLookupCache"/> would return in the case of failing to fetch the user.
         /// </summary>
         public const int UNRESOLVED_USER_ID = -1;
 
-        protected override Task<User> ComputeValueAsync(int lookup, CancellationToken token = default)
+        protected override Task<APIUser> ComputeValueAsync(int lookup, CancellationToken token = default)
         {
             if (lookup == UNRESOLVED_USER_ID)
-                return Task.FromResult((User)null);
+                return Task.FromResult((APIUser)null);
 
-            return Task.FromResult(new User
+            return Task.FromResult(new APIUser
             {
                 Id = lookup,
                 Username = $"User {lookup}"
diff --git a/osu.Game/Users/Drawables/ClickableAvatar.cs b/osu.Game/Users/Drawables/ClickableAvatar.cs
index c8af8d80e4..6883cc0e62 100644
--- a/osu.Game/Users/Drawables/ClickableAvatar.cs
+++ b/osu.Game/Users/Drawables/ClickableAvatar.cs
@@ -9,6 +9,7 @@ using osu.Framework.Input.Events;
 using osu.Framework.Localisation;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.UserInterface;
+using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Users.Drawables
 {
@@ -33,7 +34,7 @@ namespace osu.Game.Users.Drawables
             set => clickableArea.TooltipText = value ? (user?.Username ?? string.Empty) : default_tooltip_text;
         }
 
-        private readonly User user;
+        private readonly APIUser user;
 
         [Resolved(CanBeNull = true)]
         private OsuGame game { get; set; }
@@ -45,7 +46,7 @@ namespace osu.Game.Users.Drawables
         /// If <see cref="OpenOnClick"/> is <c>true</c>, clicking will open the user's profile.
         /// </summary>
         /// <param name="user">The user. A null value will get a placeholder avatar.</param>
-        public ClickableAvatar(User user = null)
+        public ClickableAvatar(APIUser user = null)
         {
             this.user = user;
 
diff --git a/osu.Game/Users/Drawables/DrawableAvatar.cs b/osu.Game/Users/Drawables/DrawableAvatar.cs
index 87860bd149..e6d7bb692d 100644
--- a/osu.Game/Users/Drawables/DrawableAvatar.cs
+++ b/osu.Game/Users/Drawables/DrawableAvatar.cs
@@ -5,19 +5,20 @@ using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Graphics.Textures;
+using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Users.Drawables
 {
     [LongRunningLoad]
     public class DrawableAvatar : Sprite
     {
-        private readonly User user;
+        private readonly APIUser user;
 
         /// <summary>
         /// A simple, non-interactable avatar sprite for the specified user.
         /// </summary>
         /// <param name="user">The user. A null value will get a placeholder avatar.</param>
-        public DrawableAvatar(User user = null)
+        public DrawableAvatar(APIUser user = null)
         {
             this.user = user;
 
diff --git a/osu.Game/Users/Drawables/UpdateableAvatar.cs b/osu.Game/Users/Drawables/UpdateableAvatar.cs
index 6d48104131..8ce6ce3460 100644
--- a/osu.Game/Users/Drawables/UpdateableAvatar.cs
+++ b/osu.Game/Users/Drawables/UpdateableAvatar.cs
@@ -4,15 +4,16 @@
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Effects;
+using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Users.Drawables
 {
     /// <summary>
     /// An avatar which can update to a new user when needed.
     /// </summary>
-    public class UpdateableAvatar : ModelBackedDrawable<User>
+    public class UpdateableAvatar : ModelBackedDrawable<APIUser>
     {
-        public User User
+        public APIUser User
         {
             get => Model;
             set => Model = value;
@@ -55,7 +56,7 @@ namespace osu.Game.Users.Drawables
         /// <param name="isInteractive">If set to true, hover/click sounds will play and clicking the avatar will open the user's profile.</param>
         /// <param name="showUsernameTooltip">Whether to show the username rather than "view profile" on the tooltip. (note: this only applies if <paramref name="isInteractive"/> is also true)</param>
         /// <param name="showGuestOnNull">Whether to show a default guest representation on null user (as opposed to nothing).</param>
-        public UpdateableAvatar(User user = null, bool isInteractive = true, bool showUsernameTooltip = false, bool showGuestOnNull = true)
+        public UpdateableAvatar(APIUser user = null, bool isInteractive = true, bool showUsernameTooltip = false, bool showGuestOnNull = true)
         {
             this.isInteractive = isInteractive;
             this.showUsernameTooltip = showUsernameTooltip;
@@ -64,7 +65,7 @@ namespace osu.Game.Users.Drawables
             User = user;
         }
 
-        protected override Drawable CreateDrawable(User user)
+        protected override Drawable CreateDrawable(APIUser user)
         {
             if (user == null && !showGuestOnNull)
                 return null;
diff --git a/osu.Game/Users/ExtendedUserPanel.cs b/osu.Game/Users/ExtendedUserPanel.cs
index 24317e6069..fc5e1eca5f 100644
--- a/osu.Game/Users/ExtendedUserPanel.cs
+++ b/osu.Game/Users/ExtendedUserPanel.cs
@@ -11,6 +11,7 @@ using osu.Game.Graphics.Sprites;
 using osu.Framework.Graphics.Sprites;
 using osu.Game.Users.Drawables;
 using osu.Framework.Input.Events;
+using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Users
 {
@@ -25,7 +26,7 @@ namespace osu.Game.Users
         private SpriteIcon statusIcon;
         private OsuSpriteText statusMessage;
 
-        protected ExtendedUserPanel(User user)
+        protected ExtendedUserPanel(APIUser user)
             : base(user)
         {
         }
diff --git a/osu.Game/Users/IUser.cs b/osu.Game/Users/IUser.cs
new file mode 100644
index 0000000000..34a59fa214
--- /dev/null
+++ b/osu.Game/Users/IUser.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 osu.Game.Database;
+
+namespace osu.Game.Users
+{
+    public interface IUser : IHasOnlineID<int>
+    {
+        string Username { get; set; }
+    }
+}
diff --git a/osu.Game/Users/User.cs b/osu.Game/Users/User.cs
deleted file mode 100644
index 4ee7d20734..0000000000
--- a/osu.Game/Users/User.cs
+++ /dev/null
@@ -1,292 +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.ComponentModel;
-using System.Linq;
-using JetBrains.Annotations;
-using Newtonsoft.Json;
-using osu.Framework.Bindables;
-using osu.Game.Online.API.Requests;
-
-namespace osu.Game.Users
-{
-    public class User : IEquatable<User>
-    {
-        [JsonProperty(@"id")]
-        public int Id = 1;
-
-        [JsonProperty(@"join_date")]
-        public DateTimeOffset JoinDate;
-
-        [JsonProperty(@"username")]
-        public string Username;
-
-        [JsonProperty(@"previous_usernames")]
-        public string[] PreviousUsernames;
-
-        [JsonProperty(@"country")]
-        public Country Country;
-
-        public readonly Bindable<UserStatus> Status = new Bindable<UserStatus>();
-
-        public readonly Bindable<UserActivity> Activity = new Bindable<UserActivity>();
-
-        [JsonProperty(@"profile_colour")]
-        public string Colour;
-
-        [JsonProperty(@"avatar_url")]
-        public string AvatarUrl;
-
-        [JsonProperty(@"cover_url")]
-        public string CoverUrl
-        {
-            get => Cover?.Url;
-            set => Cover = new UserCover { Url = value };
-        }
-
-        [JsonProperty(@"cover")]
-        public UserCover Cover;
-
-        public class UserCover
-        {
-            [JsonProperty(@"custom_url")]
-            public string CustomUrl;
-
-            [JsonProperty(@"url")]
-            public string Url;
-
-            [JsonProperty(@"id")]
-            public int? Id;
-        }
-
-        [JsonProperty(@"is_admin")]
-        public bool IsAdmin;
-
-        [JsonProperty(@"is_supporter")]
-        public bool IsSupporter;
-
-        [JsonProperty(@"support_level")]
-        public int SupportLevel;
-
-        [JsonProperty(@"is_gmt")]
-        public bool IsGMT;
-
-        [JsonProperty(@"is_qat")]
-        public bool IsQAT;
-
-        [JsonProperty(@"is_bng")]
-        public bool IsBNG;
-
-        [JsonProperty(@"is_bot")]
-        public bool IsBot;
-
-        [JsonProperty(@"is_active")]
-        public bool Active;
-
-        [JsonProperty(@"is_online")]
-        public bool IsOnline;
-
-        [JsonProperty(@"pm_friends_only")]
-        public bool PMFriendsOnly;
-
-        [JsonProperty(@"interests")]
-        public string Interests;
-
-        [JsonProperty(@"occupation")]
-        public string Occupation;
-
-        [JsonProperty(@"title")]
-        public string Title;
-
-        [JsonProperty(@"location")]
-        public string Location;
-
-        [JsonProperty(@"last_visit")]
-        public DateTimeOffset? LastVisit;
-
-        [JsonProperty(@"twitter")]
-        public string Twitter;
-
-        [JsonProperty(@"discord")]
-        public string Discord;
-
-        [JsonProperty(@"website")]
-        public string Website;
-
-        [JsonProperty(@"post_count")]
-        public int PostCount;
-
-        [JsonProperty(@"comments_count")]
-        public int CommentsCount;
-
-        [JsonProperty(@"follower_count")]
-        public int FollowerCount;
-
-        [JsonProperty(@"mapping_follower_count")]
-        public int MappingFollowerCount;
-
-        [JsonProperty(@"favourite_beatmapset_count")]
-        public int FavouriteBeatmapsetCount;
-
-        [JsonProperty(@"graveyard_beatmapset_count")]
-        public int GraveyardBeatmapsetCount;
-
-        [JsonProperty(@"loved_beatmapset_count")]
-        public int LovedBeatmapsetCount;
-
-        [JsonProperty(@"ranked_beatmapset_count")]
-        public int RankedBeatmapsetCount;
-
-        [JsonProperty(@"pending_beatmapset_count")]
-        public int PendingBeatmapsetCount;
-
-        [JsonProperty(@"scores_best_count")]
-        public int ScoresBestCount;
-
-        [JsonProperty(@"scores_first_count")]
-        public int ScoresFirstCount;
-
-        [JsonProperty(@"scores_recent_count")]
-        public int ScoresRecentCount;
-
-        [JsonProperty(@"beatmap_playcounts_count")]
-        public int BeatmapPlaycountsCount;
-
-        [JsonProperty]
-        private string[] playstyle
-        {
-            set => PlayStyles = value?.Select(str => Enum.Parse(typeof(PlayStyle), str, true)).Cast<PlayStyle>().ToArray();
-        }
-
-        public PlayStyle[] PlayStyles;
-
-        [JsonProperty(@"playmode")]
-        public string PlayMode;
-
-        [JsonProperty(@"profile_order")]
-        public string[] ProfileOrder;
-
-        [JsonProperty(@"kudosu")]
-        public KudosuCount Kudosu;
-
-        public class KudosuCount
-        {
-            [JsonProperty(@"total")]
-            public int Total;
-
-            [JsonProperty(@"available")]
-            public int Available;
-        }
-
-        private UserStatistics statistics;
-
-        /// <summary>
-        /// User statistics for the requested ruleset (in the case of a <see cref="GetUserRequest"/> or <see cref="GetFriendsRequest"/> response).
-        /// Otherwise empty.
-        /// </summary>
-        [JsonProperty(@"statistics")]
-        public UserStatistics Statistics
-        {
-            get => statistics ??= new UserStatistics();
-            set
-            {
-                if (statistics != null)
-                    // we may already have rank history populated
-                    value.RankHistory = statistics.RankHistory;
-
-                statistics = value;
-            }
-        }
-
-        [JsonProperty(@"rank_history")]
-        private RankHistoryData rankHistory
-        {
-            set => statistics.RankHistory = value;
-        }
-
-        public class RankHistoryData
-        {
-            [JsonProperty(@"mode")]
-            public string Mode;
-
-            [JsonProperty(@"data")]
-            public int[] Data;
-        }
-
-        [JsonProperty("badges")]
-        public Badge[] Badges;
-
-        [JsonProperty("user_achievements")]
-        public UserAchievement[] Achievements;
-
-        public class UserAchievement
-        {
-            [JsonProperty("achieved_at")]
-            public DateTimeOffset AchievedAt;
-
-            [JsonProperty("achievement_id")]
-            public int ID;
-        }
-
-        [JsonProperty("monthly_playcounts")]
-        public UserHistoryCount[] MonthlyPlaycounts;
-
-        [JsonProperty("replays_watched_counts")]
-        public UserHistoryCount[] ReplaysWatchedCounts;
-
-        /// <summary>
-        /// All user statistics per ruleset's short name (in the case of a <see cref="GetUsersRequest"/> response).
-        /// Otherwise empty. Can be altered for testing purposes.
-        /// </summary>
-        // todo: this should likely be moved to a separate UserCompact class at some point.
-        [JsonProperty("statistics_rulesets")]
-        [CanBeNull]
-        public Dictionary<string, UserStatistics> RulesetsStatistics { get; set; }
-
-        public override string ToString() => Username;
-
-        /// <summary>
-        /// A user instance for displaying locally created system messages.
-        /// </summary>
-        public static readonly User SYSTEM_USER = new User
-        {
-            Username = "system",
-            Colour = @"9c0101",
-            Id = 0
-        };
-
-        public bool Equals(User other)
-        {
-            if (ReferenceEquals(null, other)) return false;
-            if (ReferenceEquals(this, other)) return true;
-
-            return Id == other.Id;
-        }
-
-        public enum PlayStyle
-        {
-            [Description("Keyboard")]
-            Keyboard,
-
-            [Description("Mouse")]
-            Mouse,
-
-            [Description("Tablet")]
-            Tablet,
-
-            [Description("Touch Screen")]
-            Touch,
-        }
-
-        public class UserHistoryCount
-        {
-            [JsonProperty("start_date")]
-            public DateTime Date;
-
-            [JsonProperty("count")]
-            public long Count;
-        }
-    }
-}
diff --git a/osu.Game/Users/UserBrickPanel.cs b/osu.Game/Users/UserBrickPanel.cs
index 9ca7768187..3debdb6e72 100644
--- a/osu.Game/Users/UserBrickPanel.cs
+++ b/osu.Game/Users/UserBrickPanel.cs
@@ -7,13 +7,14 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
 using osu.Game.Graphics;
+using osu.Game.Online.API.Requests.Responses;
 using osuTK;
 
 namespace osu.Game.Users
 {
     public class UserBrickPanel : UserPanel
     {
-        public UserBrickPanel(User user)
+        public UserBrickPanel(APIUser user)
             : base(user)
         {
             AutoSizeAxes = Axes.Both;
diff --git a/osu.Game/Users/UserCoverBackground.cs b/osu.Game/Users/UserCoverBackground.cs
index 34bbf6892e..3f1f838b27 100644
--- a/osu.Game/Users/UserCoverBackground.cs
+++ b/osu.Game/Users/UserCoverBackground.cs
@@ -10,19 +10,20 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Graphics.Textures;
+using osu.Game.Online.API.Requests.Responses;
 using osuTK.Graphics;
 
 namespace osu.Game.Users
 {
-    public class UserCoverBackground : ModelBackedDrawable<User>
+    public class UserCoverBackground : ModelBackedDrawable<APIUser>
     {
-        public User User
+        public APIUser User
         {
             get => Model;
             set => Model = value;
         }
 
-        protected override Drawable CreateDrawable(User user) => new Cover(user);
+        protected override Drawable CreateDrawable(APIUser user) => new Cover(user);
 
         protected override double LoadDelay => 300;
 
@@ -37,9 +38,9 @@ namespace osu.Game.Users
         [LongRunningLoad]
         private class Cover : CompositeDrawable
         {
-            private readonly User user;
+            private readonly APIUser user;
 
-            public Cover(User user)
+            public Cover(APIUser user)
             {
                 this.user = user;
 
diff --git a/osu.Game/Users/UserGridPanel.cs b/osu.Game/Users/UserGridPanel.cs
index 44dcbc305d..c37eeb1cbf 100644
--- a/osu.Game/Users/UserGridPanel.cs
+++ b/osu.Game/Users/UserGridPanel.cs
@@ -4,6 +4,7 @@
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays.Profile.Header.Components;
 using osuTK;
 
@@ -13,7 +14,7 @@ namespace osu.Game.Users
     {
         private const int margin = 10;
 
-        public UserGridPanel(User user)
+        public UserGridPanel(APIUser user)
             : base(user)
         {
             Height = 120;
diff --git a/osu.Game/Users/UserListPanel.cs b/osu.Game/Users/UserListPanel.cs
index cc4fca9b94..f06e412315 100644
--- a/osu.Game/Users/UserListPanel.cs
+++ b/osu.Game/Users/UserListPanel.cs
@@ -7,6 +7,7 @@ using osu.Framework.Graphics.Colour;
 using osu.Framework.Extensions.Color4Extensions;
 using osuTK.Graphics;
 using osu.Framework.Graphics.Containers;
+using osu.Game.Online.API.Requests.Responses;
 using osuTK;
 using osu.Game.Overlays.Profile.Header.Components;
 
@@ -14,7 +15,7 @@ namespace osu.Game.Users
 {
     public class UserListPanel : ExtendedUserPanel
     {
-        public UserListPanel(User user)
+        public UserListPanel(APIUser user)
             : base(user)
         {
             RelativeSizeAxes = Axes.X;
diff --git a/osu.Game/Users/UserPanel.cs b/osu.Game/Users/UserPanel.cs
index ff0d03a036..248debf1d3 100644
--- a/osu.Game/Users/UserPanel.cs
+++ b/osu.Game/Users/UserPanel.cs
@@ -13,12 +13,13 @@ using osu.Game.Graphics.UserInterface;
 using osu.Framework.Graphics.Cursor;
 using osu.Game.Graphics.Containers;
 using JetBrains.Annotations;
+using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Users
 {
     public abstract class UserPanel : OsuClickableContainer, IHasContextMenu
     {
-        public readonly User User;
+        public readonly APIUser User;
 
         /// <summary>
         /// Perform an action in addition to showing the user's profile.
@@ -30,7 +31,7 @@ namespace osu.Game.Users
 
         protected Drawable Background { get; private set; }
 
-        protected UserPanel(User user)
+        protected UserPanel(APIUser user)
             : base(HoverSampleSet.Submit)
         {
             if (user == null)
diff --git a/osu.Game/Users/UserStatistics.cs b/osu.Game/Users/UserStatistics.cs
index 449b0aa212..6acb63fdc4 100644
--- a/osu.Game/Users/UserStatistics.cs
+++ b/osu.Game/Users/UserStatistics.cs
@@ -4,16 +4,17 @@
 using System;
 using Newtonsoft.Json;
 using osu.Framework.Localisation;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Scoring;
 using osu.Game.Utils;
-using static osu.Game.Users.User;
+using static osu.Game.Online.API.Requests.Responses.APIUser;
 
 namespace osu.Game.Users
 {
     public class UserStatistics
     {
         [JsonProperty]
-        public User User;
+        public APIUser User;
 
         [JsonProperty(@"level")]
         public LevelInfo Level;

From 75478109790d28a9b4f286e367cdb5c16ec29997 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 4 Nov 2021 18:13:45 +0900
Subject: [PATCH 0732/5547] Change `IBeatmapMetadataInfo.Author` to be an
 `IUser`

---
 osu.Game/Beatmaps/IBeatmapMetadataInfo.cs |  3 ++-
 osu.Game/Models/RealmBeatmapMetadata.cs   |  5 ++++-
 osu.Game/Models/RealmUser.cs              | 15 +++++++++++++++
 3 files changed, 21 insertions(+), 2 deletions(-)
 create mode 100644 osu.Game/Models/RealmUser.cs

diff --git a/osu.Game/Beatmaps/IBeatmapMetadataInfo.cs b/osu.Game/Beatmaps/IBeatmapMetadataInfo.cs
index 55aee7d7bc..968ad14928 100644
--- a/osu.Game/Beatmaps/IBeatmapMetadataInfo.cs
+++ b/osu.Game/Beatmaps/IBeatmapMetadataInfo.cs
@@ -2,6 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
+using osu.Game.Users;
 
 #nullable enable
 
@@ -35,7 +36,7 @@ namespace osu.Game.Beatmaps
         /// <summary>
         /// The author of this beatmap.
         /// </summary>
-        string Author { get; } // eventually should be linked to a persisted User.
+        IUser Author { get; }
 
         /// <summary>
         /// The source of this beatmap.
diff --git a/osu.Game/Models/RealmBeatmapMetadata.cs b/osu.Game/Models/RealmBeatmapMetadata.cs
index 6ea7170d0f..db1b09e6ad 100644
--- a/osu.Game/Models/RealmBeatmapMetadata.cs
+++ b/osu.Game/Models/RealmBeatmapMetadata.cs
@@ -5,6 +5,7 @@ using System;
 using Newtonsoft.Json;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
+using osu.Game.Users;
 using Realms;
 
 #nullable enable
@@ -26,7 +27,7 @@ namespace osu.Game.Models
         [JsonProperty("artist_unicode")]
         public string ArtistUnicode { get; set; } = string.Empty;
 
-        public string Author { get; set; } = string.Empty; // eventually should be linked to a persisted User.
+        public RealmUser Author { get; set; } = new RealmUser();
 
         public string Source { get; set; } = string.Empty;
 
@@ -41,5 +42,7 @@ namespace osu.Game.Models
 
         public string AudioFile { get; set; } = string.Empty;
         public string BackgroundFile { get; set; } = string.Empty;
+
+        IUser IBeatmapMetadataInfo.Author => Author;
     }
 }
diff --git a/osu.Game/Models/RealmUser.cs b/osu.Game/Models/RealmUser.cs
new file mode 100644
index 0000000000..8b050e8a93
--- /dev/null
+++ b/osu.Game/Models/RealmUser.cs
@@ -0,0 +1,15 @@
+// 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.Users;
+using Realms;
+
+namespace osu.Game.Models
+{
+    public class RealmUser : EmbeddedObject, IUser
+    {
+        public int OnlineID { get; set; } = 1;
+
+        public string Username { get; set; }
+    }
+}

From 86540d1fb6b488ca11242e79ec2891d80650a672 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 4 Nov 2021 18:22:21 +0900
Subject: [PATCH 0733/5547] Update existing usages of `Author` as `string` to
 access `Username` directly

---
 .../Database/BeatmapImporterTests.cs          |  5 ++-
 .../TestSceneExpandedPanelMiddleContent.cs    |  7 +++--
 .../Components/TournamentBeatmapPanel.cs      |  2 +-
 osu.Game/Beatmaps/BeatmapManager.cs           |  3 +-
 osu.Game/Beatmaps/BeatmapMetadata.cs          | 31 +++++++------------
 .../Beatmaps/BeatmapMetadataInfoExtensions.cs |  6 ++--
 .../Graphics/Containers/LinkFlowContainer.cs  |  6 ++--
 .../API/Requests/Responses/APIBeatmapSet.cs   | 18 +++--------
 .../OnlinePlay/DrawableRoomPlaylistItem.cs    |  5 ++-
 .../Expanded/ExpandedPanelMiddleContent.cs    |  2 +-
 osu.Game/Screens/Select/BeatmapInfoWedge.cs   |  2 +-
 .../Select/Carousel/CarouselBeatmapSet.cs     |  2 +-
 .../Carousel/DrawableCarouselBeatmap.cs       |  2 +-
 osu.Game/Stores/BeatmapImporter.cs            |  6 +++-
 14 files changed, 45 insertions(+), 52 deletions(-)

diff --git a/osu.Game.Tests/Database/BeatmapImporterTests.cs b/osu.Game.Tests/Database/BeatmapImporterTests.cs
index a21f935f6b..e1fe1e224e 100644
--- a/osu.Game.Tests/Database/BeatmapImporterTests.cs
+++ b/osu.Game.Tests/Database/BeatmapImporterTests.cs
@@ -482,7 +482,10 @@ namespace osu.Game.Tests.Database
                 var metadata = new RealmBeatmapMetadata
                 {
                     Artist = "SomeArtist",
-                    Author = "SomeAuthor"
+                    Author =
+                    {
+                        Username = "SomeAuthor"
+                    }
                 };
 
                 var ruleset = realmFactory.Context.All<RealmRuleset>().First();
diff --git a/osu.Game.Tests/Visual/Ranking/TestSceneExpandedPanelMiddleContent.cs b/osu.Game.Tests/Visual/Ranking/TestSceneExpandedPanelMiddleContent.cs
index fee8985120..9983993d9c 100644
--- a/osu.Game.Tests/Visual/Ranking/TestSceneExpandedPanelMiddleContent.cs
+++ b/osu.Game.Tests/Visual/Ranking/TestSceneExpandedPanelMiddleContent.cs
@@ -2,6 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System.Linq;
+using JetBrains.Annotations;
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.Color4Extensions;
@@ -57,7 +58,7 @@ namespace osu.Game.Tests.Visual.Ranking
         {
             AddStep("show example score", () => showPanel(new TestScoreInfo(new OsuRuleset().RulesetInfo)
             {
-                BeatmapInfo = createTestBeatmap(null)
+                BeatmapInfo = createTestBeatmap(new APIUser())
             }));
 
             AddAssert("mapped by text not present", () =>
@@ -74,7 +75,7 @@ namespace osu.Game.Tests.Visual.Ranking
                 var ruleset = new OsuRuleset();
 
                 var mods = new Mod[] { ruleset.GetAutoplayMod() };
-                var beatmap = createTestBeatmap(null);
+                var beatmap = createTestBeatmap(new APIUser());
 
                 showPanel(new TestScoreInfo(ruleset.RulesetInfo)
                 {
@@ -90,7 +91,7 @@ namespace osu.Game.Tests.Visual.Ranking
         private void showPanel(ScoreInfo score) =>
             Child = new ExpandedPanelMiddleContentContainer(score);
 
-        private BeatmapInfo createTestBeatmap(APIUser author)
+        private BeatmapInfo createTestBeatmap([NotNull] APIUser author)
         {
             var beatmap = new TestBeatmap(rulesetStore.GetRuleset(0)).BeatmapInfo;
 
diff --git a/osu.Game.Tournament/Components/TournamentBeatmapPanel.cs b/osu.Game.Tournament/Components/TournamentBeatmapPanel.cs
index f3550f7465..364cccd076 100644
--- a/osu.Game.Tournament/Components/TournamentBeatmapPanel.cs
+++ b/osu.Game.Tournament/Components/TournamentBeatmapPanel.cs
@@ -93,7 +93,7 @@ namespace osu.Game.Tournament.Components
                                 },
                                 new TournamentSpriteText
                                 {
-                                    Text = Beatmap.Metadata.Author,
+                                    Text = Beatmap.Metadata.Author.Username,
                                     Padding = new MarginPadding { Right = 20 },
                                     Font = OsuFont.Torus.With(weight: FontWeight.Bold, size: 14)
                                 },
diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index 680574cfc8..674d603d9a 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -262,7 +262,8 @@ namespace osu.Game.Beatmaps
                     Artist = model.Metadata?.Artist ?? string.Empty,
                     TitleUnicode = model.Metadata?.TitleUnicode ?? string.Empty,
                     ArtistUnicode = model.Metadata?.ArtistUnicode ?? string.Empty,
-                    Author = new APIUser { Username = model.Metadata?.Author },
+                    AuthorString = model.Metadata?.Author.Username ?? string.Empty,
+                    AuthorID = model.Metadata?.Author.OnlineID ?? 1,
                 }
             }, minimiseDownloadSize);
         }
diff --git a/osu.Game/Beatmaps/BeatmapMetadata.cs b/osu.Game/Beatmaps/BeatmapMetadata.cs
index 60e3bcc98d..4ae212c411 100644
--- a/osu.Game/Beatmaps/BeatmapMetadata.cs
+++ b/osu.Game/Beatmaps/BeatmapMetadata.cs
@@ -8,6 +8,7 @@ using Newtonsoft.Json;
 using osu.Framework.Testing;
 using osu.Game.Database;
 using osu.Game.Online.API.Requests.Responses;
+using osu.Game.Users;
 
 #nullable enable
 
@@ -35,6 +36,12 @@ namespace osu.Game.Beatmaps
         [JsonIgnore]
         public List<BeatmapSetInfo> BeatmapSets { get; set; } = new List<BeatmapSetInfo>();
 
+        /// <summary>
+        /// The author of the beatmaps in this set.
+        /// </summary>
+        [JsonIgnore]
+        public APIUser Author = new APIUser();
+
         /// <summary>
         /// Helper property to deserialize a username to <see cref="APIUser"/>.
         /// </summary>
@@ -42,12 +49,8 @@ namespace osu.Game.Beatmaps
         [Column("AuthorID")]
         public int AuthorID
         {
-            get => Author?.Id ?? 1;
-            set
-            {
-                Author ??= new APIUser();
-                Author.Id = value;
-            }
+            get => Author.Id;
+            set => Author.Id = value;
         }
 
         /// <summary>
@@ -57,20 +60,10 @@ namespace osu.Game.Beatmaps
         [Column("Author")]
         public string AuthorString
         {
-            get => Author?.Username ?? string.Empty;
-            set
-            {
-                Author ??= new APIUser();
-                Author.Username = value;
-            }
+            get => Author.Username;
+            set => Author.Username = value;
         }
 
-        /// <summary>
-        /// The author of the beatmaps in this set.
-        /// </summary>
-        [JsonIgnore]
-        public APIUser? Author;
-
         public string Source { get; set; } = string.Empty;
 
         [JsonProperty(@"tags")]
@@ -90,6 +83,6 @@ namespace osu.Game.Beatmaps
 
         public override string ToString() => this.GetDisplayTitle();
 
-        string IBeatmapMetadataInfo.Author => AuthorString;
+        IUser IBeatmapMetadataInfo.Author => Author;
     }
 }
diff --git a/osu.Game/Beatmaps/BeatmapMetadataInfoExtensions.cs b/osu.Game/Beatmaps/BeatmapMetadataInfoExtensions.cs
index fcaad17059..27cd7f8d9a 100644
--- a/osu.Game/Beatmaps/BeatmapMetadataInfoExtensions.cs
+++ b/osu.Game/Beatmaps/BeatmapMetadataInfoExtensions.cs
@@ -13,7 +13,7 @@ namespace osu.Game.Beatmaps
         /// </summary>
         public static string[] GetSearchableTerms(this IBeatmapMetadataInfo metadataInfo) => new[]
         {
-            metadataInfo.Author,
+            metadataInfo.Author.Username,
             metadataInfo.Artist,
             metadataInfo.ArtistUnicode,
             metadataInfo.Title,
@@ -27,7 +27,7 @@ namespace osu.Game.Beatmaps
         /// </summary>
         public static string GetDisplayTitle(this IBeatmapMetadataInfo metadataInfo)
         {
-            string author = string.IsNullOrEmpty(metadataInfo.Author) ? string.Empty : $"({metadataInfo.Author})";
+            string author = string.IsNullOrEmpty(metadataInfo.Author.Username) ? string.Empty : $"({metadataInfo.Author})";
             return $"{metadataInfo.Artist} - {metadataInfo.Title} {author}".Trim();
         }
 
@@ -36,7 +36,7 @@ namespace osu.Game.Beatmaps
         /// </summary>
         public static RomanisableString GetDisplayTitleRomanisable(this IBeatmapMetadataInfo metadataInfo, bool includeCreator = true)
         {
-            string author = !includeCreator || string.IsNullOrEmpty(metadataInfo.Author) ? string.Empty : $"({metadataInfo.Author})";
+            string author = !includeCreator || string.IsNullOrEmpty(metadataInfo.Author.Username) ? string.Empty : $"({metadataInfo.Author})";
             string artistUnicode = string.IsNullOrEmpty(metadataInfo.ArtistUnicode) ? metadataInfo.Artist : metadataInfo.ArtistUnicode;
             string titleUnicode = string.IsNullOrEmpty(metadataInfo.TitleUnicode) ? metadataInfo.Title : metadataInfo.TitleUnicode;
 
diff --git a/osu.Game/Graphics/Containers/LinkFlowContainer.cs b/osu.Game/Graphics/Containers/LinkFlowContainer.cs
index 48f6c36993..41b7df228e 100644
--- a/osu.Game/Graphics/Containers/LinkFlowContainer.cs
+++ b/osu.Game/Graphics/Containers/LinkFlowContainer.cs
@@ -11,7 +11,7 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Localisation;
 using osu.Framework.Platform;
-using osu.Game.Online.API.Requests.Responses;
+using osu.Game.Users;
 
 namespace osu.Game.Graphics.Containers
 {
@@ -70,8 +70,8 @@ namespace osu.Game.Graphics.Containers
             createLink(new TextPartManual(text), new LinkDetails(action, linkArgument), tooltipText);
         }
 
-        public void AddUserLink(APIUser user, Action<SpriteText> creationParameters = null)
-            => createLink(CreateChunkFor(user.Username, true, CreateSpriteText, creationParameters), new LinkDetails(LinkAction.OpenUserProfile, user.Id.ToString()), "view profile");
+        public void AddUserLink(IUser user, Action<SpriteText> creationParameters = null)
+            => createLink(CreateChunkFor(user.Username, true, CreateSpriteText, creationParameters), new LinkDetails(LinkAction.OpenUserProfile, user.OnlineID.ToString()), "view profile");
 
         private void createLink(ITextPart textPart, LinkDetails link, LocalisableString tooltipText, Action action = null)
         {
diff --git a/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs b/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs
index f8a0acf96e..1ff039a6b4 100644
--- a/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs
@@ -71,7 +71,7 @@ namespace osu.Game.Online.API.Requests.Responses
         [JsonProperty("artist_unicode")]
         public string ArtistUnicode { get; set; } = string.Empty;
 
-        public APIUser? Author = new APIUser();
+        public APIUser Author = new APIUser();
 
         /// <summary>
         /// Helper property to deserialize a username to <see cref="APIUser"/>.
@@ -79,12 +79,8 @@ namespace osu.Game.Online.API.Requests.Responses
         [JsonProperty(@"user_id")]
         public int AuthorID
         {
-            get => Author?.Id ?? 1;
-            set
-            {
-                Author ??= new APIUser();
-                Author.Id = value;
-            }
+            get => Author.Id;
+            set => Author.Id = value;
         }
 
         /// <summary>
@@ -93,12 +89,8 @@ namespace osu.Game.Online.API.Requests.Responses
         [JsonProperty(@"creator")]
         public string AuthorString
         {
-            get => Author?.Username ?? string.Empty;
-            set
-            {
-                Author ??= new APIUser();
-                Author.Username = value;
-            }
+            get => Author.Username;
+            set => Author.Username = value;
         }
 
         [JsonProperty(@"availability")]
diff --git a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
index c22b9bd9aa..85cee46a29 100644
--- a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
+++ b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
@@ -20,7 +20,6 @@ using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Online;
-using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Chat;
 using osu.Game.Online.Rooms;
 using osu.Game.Overlays.BeatmapListing.Panels;
@@ -119,10 +118,10 @@ namespace osu.Game.Screens.OnlinePlay
 
             authorText.Clear();
 
-            if (!string.IsNullOrEmpty(Item.Beatmap.Value?.Metadata.Author))
+            if (!string.IsNullOrEmpty(Item.Beatmap.Value?.Metadata.Author.Username))
             {
                 authorText.AddText("mapped by ");
-                authorText.AddUserLink(new APIUser { Username = Item.Beatmap.Value.Metadata.Author });
+                authorText.AddUserLink(Item.Beatmap.Value.Metadata.Author);
             }
 
             bool hasExplicitContent = (Item.Beatmap.Value.BeatmapSet as IBeatmapSetOnlineInfo)?.HasExplicitContent == true;
diff --git a/osu.Game/Screens/Ranking/Expanded/ExpandedPanelMiddleContent.cs b/osu.Game/Screens/Ranking/Expanded/ExpandedPanelMiddleContent.cs
index c27d5227b5..29b9d6164e 100644
--- a/osu.Game/Screens/Ranking/Expanded/ExpandedPanelMiddleContent.cs
+++ b/osu.Game/Screens/Ranking/Expanded/ExpandedPanelMiddleContent.cs
@@ -62,7 +62,7 @@ namespace osu.Game.Screens.Ranking.Expanded
         {
             var beatmap = score.BeatmapInfo;
             var metadata = beatmap.BeatmapSet?.Metadata ?? beatmap.Metadata;
-            string creator = metadata.Author?.Username;
+            string creator = metadata.Author.Username;
 
             var topStatistics = new List<StatisticDisplay>
             {
diff --git a/osu.Game/Screens/Select/BeatmapInfoWedge.cs b/osu.Game/Screens/Select/BeatmapInfoWedge.cs
index 89eed14e6d..e344da4027 100644
--- a/osu.Game/Screens/Select/BeatmapInfoWedge.cs
+++ b/osu.Game/Screens/Select/BeatmapInfoWedge.cs
@@ -428,7 +428,7 @@ namespace osu.Game.Screens.Select
 
             private Drawable getMapper(BeatmapMetadata metadata)
             {
-                if (metadata.Author == null)
+                if (string.IsNullOrEmpty(metadata.Author.Username))
                     return Empty();
 
                 return new LinkFlowContainer(s =>
diff --git a/osu.Game/Screens/Select/Carousel/CarouselBeatmapSet.cs b/osu.Game/Screens/Select/Carousel/CarouselBeatmapSet.cs
index d41cb73a29..e465f423bc 100644
--- a/osu.Game/Screens/Select/Carousel/CarouselBeatmapSet.cs
+++ b/osu.Game/Screens/Select/Carousel/CarouselBeatmapSet.cs
@@ -69,7 +69,7 @@ namespace osu.Game.Screens.Select.Carousel
                     return string.Compare(BeatmapSet.Metadata.Title, otherSet.BeatmapSet.Metadata.Title, StringComparison.OrdinalIgnoreCase);
 
                 case SortMode.Author:
-                    return string.Compare(BeatmapSet.Metadata.Author?.Username, otherSet.BeatmapSet.Metadata.Author?.Username, StringComparison.OrdinalIgnoreCase);
+                    return string.Compare(BeatmapSet.Metadata.Author.Username, otherSet.BeatmapSet.Metadata.Author.Username, StringComparison.OrdinalIgnoreCase);
 
                 case SortMode.Source:
                     return string.Compare(BeatmapSet.Metadata.Source, otherSet.BeatmapSet.Metadata.Source, StringComparison.OrdinalIgnoreCase);
diff --git a/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmap.cs b/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmap.cs
index 8a5dde961f..5940911d4a 100644
--- a/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmap.cs
+++ b/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmap.cs
@@ -142,7 +142,7 @@ namespace osu.Game.Screens.Select.Carousel
                                         },
                                         new OsuSpriteText
                                         {
-                                            Text = $"{(beatmapInfo.Metadata ?? beatmapInfo.BeatmapSet.Metadata).Author?.Username ?? string.Empty}",
+                                            Text = $"{(beatmapInfo.Metadata ?? beatmapInfo.BeatmapSet.Metadata).Author.Username}",
                                             Font = OsuFont.GetFont(italics: true),
                                             Anchor = Anchor.BottomLeft,
                                             Origin = Anchor.BottomLeft
diff --git a/osu.Game/Stores/BeatmapImporter.cs b/osu.Game/Stores/BeatmapImporter.cs
index 787b1ddd60..5eb7b10d9b 100644
--- a/osu.Game/Stores/BeatmapImporter.cs
+++ b/osu.Game/Stores/BeatmapImporter.cs
@@ -238,7 +238,11 @@ namespace osu.Game.Stores
                         TitleUnicode = decoded.Metadata.TitleUnicode,
                         Artist = decoded.Metadata.Artist,
                         ArtistUnicode = decoded.Metadata.ArtistUnicode,
-                        Author = decoded.Metadata.AuthorString,
+                        Author =
+                        {
+                            OnlineID = decoded.Metadata.AuthorID,
+                            Username = decoded.Metadata.AuthorString
+                        },
                         Source = decoded.Metadata.Source,
                         Tags = decoded.Metadata.Tags,
                         PreviewTime = decoded.Metadata.PreviewTime,

From 777b2cbcc4dfa993acfe4621e049b04beec57a92 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 4 Nov 2021 18:32:50 +0900
Subject: [PATCH 0734/5547] Add realm migration for new author storage

---
 osu.Game/Database/RealmContextFactory.cs | 26 +++++++++++++++++++++++-
 1 file changed, 25 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Database/RealmContextFactory.cs b/osu.Game/Database/RealmContextFactory.cs
index 85f7dd6b89..fb629ba963 100644
--- a/osu.Game/Database/RealmContextFactory.cs
+++ b/osu.Game/Database/RealmContextFactory.cs
@@ -35,8 +35,9 @@ namespace osu.Game.Database
         /// 6  First tracked version (~20211018)
         /// 7  Changed OnlineID fields to non-nullable to add indexing support (20211018)
         /// 8  Rebind scroll adjust keys to not have control modifier (20211029)
+        /// 9  Converted BeatmapMetadata.Author from string to RealmUser (20211104)
         /// </summary>
-        private const int schema_version = 8;
+        private const int schema_version = 9;
 
         /// <summary>
         /// Lock object which is held during <see cref="BlockAllOperations"/> sections, blocking context creation during blocking periods.
@@ -151,6 +152,29 @@ namespace osu.Game.Database
 
         private void onMigration(Migration migration, ulong lastSchemaVersion)
         {
+            if (lastSchemaVersion < 9)
+            {
+                // Pretty pointless to do this as beatmaps aren't really loaded via realm yet, but oh well.
+                string className = nameof(RealmBeatmapMetadata).Replace(@"Realm", string.Empty);
+
+                var oldItems = migration.OldRealm.DynamicApi.All(className);
+                var newItems = migration.NewRealm.All<RealmBeatmapMetadata>();
+
+                int itemCount = newItems.Count();
+
+                for (int i = 0; i < itemCount; i++)
+                {
+                    dynamic? oldItem = oldItems.ElementAt(i);
+                    var newItem = newItems.ElementAt(i);
+
+                    string username = oldItem.Author;
+                    newItem.Author = new RealmUser
+                    {
+                        Username = username
+                    };
+                }
+            }
+
             if (lastSchemaVersion < 8)
             {
                 // Ctrl -/+ now adjusts UI scale so let's clear any bindings which overlap these combinations.

From 7acc4a4708b6c5a063f4f27c78a314d4c0e0c025 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 4 Nov 2021 18:39:23 +0900
Subject: [PATCH 0735/5547] Refactor realm migrations to be a touch more
 legible

---
 osu.Game/Database/RealmContextFactory.cs | 105 ++++++++++++-----------
 1 file changed, 57 insertions(+), 48 deletions(-)

diff --git a/osu.Game/Database/RealmContextFactory.cs b/osu.Game/Database/RealmContextFactory.cs
index fb629ba963..be2cf8ff4e 100644
--- a/osu.Game/Database/RealmContextFactory.cs
+++ b/osu.Game/Database/RealmContextFactory.cs
@@ -152,73 +152,82 @@ namespace osu.Game.Database
 
         private void onMigration(Migration migration, ulong lastSchemaVersion)
         {
-            if (lastSchemaVersion < 9)
+            for (ulong i = lastSchemaVersion; i <= schema_version; i++)
+                applyMigrationsForVersion(migration, i);
+        }
+
+        private void applyMigrationsForVersion(Migration migration, ulong version)
+        {
+            switch (version)
             {
-                // Pretty pointless to do this as beatmaps aren't really loaded via realm yet, but oh well.
-                string className = nameof(RealmBeatmapMetadata).Replace(@"Realm", string.Empty);
+                case 7:
+                    convertOnlineIDs<RealmBeatmap>();
+                    convertOnlineIDs<RealmBeatmapSet>();
+                    convertOnlineIDs<RealmRuleset>();
 
-                var oldItems = migration.OldRealm.DynamicApi.All(className);
-                var newItems = migration.NewRealm.All<RealmBeatmapMetadata>();
-
-                int itemCount = newItems.Count();
-
-                for (int i = 0; i < itemCount; i++)
-                {
-                    dynamic? oldItem = oldItems.ElementAt(i);
-                    var newItem = newItems.ElementAt(i);
-
-                    string username = oldItem.Author;
-                    newItem.Author = new RealmUser
+                    void convertOnlineIDs<T>() where T : RealmObject
                     {
-                        Username = username
-                    };
-                }
-            }
+                        string className = typeof(T).Name.Replace(@"Realm", string.Empty);
 
-            if (lastSchemaVersion < 8)
-            {
-                // Ctrl -/+ now adjusts UI scale so let's clear any bindings which overlap these combinations.
-                // New defaults will be populated by the key store afterwards.
-                var keyBindings = migration.NewRealm.All<RealmKeyBinding>();
+                        // version was not bumped when the beatmap/ruleset models were added
+                        // therefore we must manually check for their presence to avoid throwing on the `DynamicApi` calls.
+                        if (!migration.OldRealm.Schema.TryFindObjectSchema(className, out _))
+                            return;
 
-                var increaseSpeedBinding = keyBindings.FirstOrDefault(k => k.ActionInt == (int)GlobalAction.IncreaseScrollSpeed);
-                if (increaseSpeedBinding != null && increaseSpeedBinding.KeyCombination.Keys.SequenceEqual(new[] { InputKey.Control, InputKey.Plus }))
-                    migration.NewRealm.Remove(increaseSpeedBinding);
+                        var oldItems = migration.OldRealm.DynamicApi.All(className);
+                        var newItems = migration.NewRealm.DynamicApi.All(className);
 
-                var decreaseSpeedBinding = keyBindings.FirstOrDefault(k => k.ActionInt == (int)GlobalAction.DecreaseScrollSpeed);
-                if (decreaseSpeedBinding != null && decreaseSpeedBinding.KeyCombination.Keys.SequenceEqual(new[] { InputKey.Control, InputKey.Minus }))
-                    migration.NewRealm.Remove(decreaseSpeedBinding);
-            }
+                        int itemCount = newItems.Count();
 
-            if (lastSchemaVersion < 7)
-            {
-                convertOnlineIDs<RealmBeatmap>();
-                convertOnlineIDs<RealmBeatmapSet>();
-                convertOnlineIDs<RealmRuleset>();
+                        for (int i = 0; i < itemCount; i++)
+                        {
+                            dynamic? oldItem = oldItems.ElementAt(i);
+                            dynamic? newItem = newItems.ElementAt(i);
 
-                void convertOnlineIDs<T>() where T : RealmObject
-                {
-                    string className = typeof(T).Name.Replace(@"Realm", string.Empty);
+                            long? nullableOnlineID = oldItem?.OnlineID;
+                            newItem.OnlineID = (int)(nullableOnlineID ?? -1);
+                        }
+                    }
 
-                    // version was not bumped when the beatmap/ruleset models were added
-                    // therefore we must manually check for their presence to avoid throwing on the `DynamicApi` calls.
-                    if (!migration.OldRealm.Schema.TryFindObjectSchema(className, out _))
-                        return;
+                    break;
+
+                case 8:
+                    // Ctrl -/+ now adjusts UI scale so let's clear any bindings which overlap these combinations.
+                    // New defaults will be populated by the key store afterwards.
+                    var keyBindings = migration.NewRealm.All<RealmKeyBinding>();
+
+                    var increaseSpeedBinding = keyBindings.FirstOrDefault(k => k.ActionInt == (int)GlobalAction.IncreaseScrollSpeed);
+                    if (increaseSpeedBinding != null && increaseSpeedBinding.KeyCombination.Keys.SequenceEqual(new[] { InputKey.Control, InputKey.Plus }))
+                        migration.NewRealm.Remove(increaseSpeedBinding);
+
+                    var decreaseSpeedBinding = keyBindings.FirstOrDefault(k => k.ActionInt == (int)GlobalAction.DecreaseScrollSpeed);
+                    if (decreaseSpeedBinding != null && decreaseSpeedBinding.KeyCombination.Keys.SequenceEqual(new[] { InputKey.Control, InputKey.Minus }))
+                        migration.NewRealm.Remove(decreaseSpeedBinding);
+
+                    break;
+
+                case 9:
+                    // Pretty pointless to do this as beatmaps aren't really loaded via realm yet, but oh well.
+                    string className = nameof(RealmBeatmapMetadata).Replace(@"Realm", string.Empty);
 
                     var oldItems = migration.OldRealm.DynamicApi.All(className);
-                    var newItems = migration.NewRealm.DynamicApi.All(className);
+                    var newItems = migration.NewRealm.All<RealmBeatmapMetadata>();
 
                     int itemCount = newItems.Count();
 
                     for (int i = 0; i < itemCount; i++)
                     {
                         dynamic? oldItem = oldItems.ElementAt(i);
-                        dynamic? newItem = newItems.ElementAt(i);
+                        var newItem = newItems.ElementAt(i);
 
-                        long? nullableOnlineID = oldItem?.OnlineID;
-                        newItem.OnlineID = (int)(nullableOnlineID ?? -1);
+                        string username = oldItem.Author;
+                        newItem.Author = new RealmUser
+                        {
+                            Username = username
+                        };
                     }
-                }
+
+                    break;
             }
         }
 

From ed07ee8c611744849d921b2c7110431cc19cdad3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 4 Nov 2021 18:46:26 +0900
Subject: [PATCH 0736/5547] Update all existing usages of
 `AuthorString`/`AuthorId`

Unfortunately the getters need to be left in place else EF breaks.
---
 .../Beatmaps/Formats/LegacyBeatmapDecoderTest.cs     | 12 ++++++------
 .../Beatmaps/Formats/OsuJsonDecoderTest.cs           |  2 +-
 osu.Game.Tests/Beatmaps/IO/OszArchiveReaderTest.cs   |  2 +-
 .../Visual/SongSelect/TestSceneBeatmapCarousel.cs    |  2 +-
 osu.Game/Beatmaps/BeatmapMetadata.cs                 |  4 ++--
 osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs    |  2 +-
 osu.Game/Screens/Edit/Setup/MetadataSection.cs       |  2 +-
 osu.Game/Screens/Play/BeatmapMetadataDisplay.cs      |  2 +-
 osu.Game/Screens/Select/Carousel/CarouselBeatmap.cs  |  2 +-
 osu.Game/Skinning/LegacyBeatmapSkin.cs               |  2 +-
 osu.Game/Stores/BeatmapImporter.cs                   |  4 ++--
 osu.Game/Tests/Visual/OsuTestScene.cs                |  4 +---
 12 files changed, 19 insertions(+), 21 deletions(-)

diff --git a/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs b/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs
index 7a95856c36..0bd7c19200 100644
--- a/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs
+++ b/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs
@@ -112,7 +112,7 @@ namespace osu.Game.Tests.Beatmaps.Formats
                 Assert.AreEqual("Renatus", metadata.TitleUnicode);
                 Assert.AreEqual("Soleily", metadata.Artist);
                 Assert.AreEqual("Soleily", metadata.ArtistUnicode);
-                Assert.AreEqual("Gamu", metadata.AuthorString);
+                Assert.AreEqual("Gamu", metadata.Author.Username);
                 Assert.AreEqual("Insane", beatmapInfo.Version);
                 Assert.AreEqual(string.Empty, metadata.Source);
                 Assert.AreEqual("MBC7 Unisphere 地球ヤバイEP Chikyu Yabai", metadata.Tags);
@@ -547,7 +547,7 @@ namespace osu.Game.Tests.Beatmaps.Formats
                 Assert.DoesNotThrow(() => beatmap = decoder.Decode(stream));
                 Assert.IsNotNull(beatmap);
                 Assert.AreEqual("Beatmap with corrupted header", beatmap.Metadata.Title);
-                Assert.AreEqual("Evil Hacker", beatmap.Metadata.AuthorString);
+                Assert.AreEqual("Evil Hacker", beatmap.Metadata.Author.Username);
             }
         }
 
@@ -565,7 +565,7 @@ namespace osu.Game.Tests.Beatmaps.Formats
                 Assert.DoesNotThrow(() => beatmap = decoder.Decode(stream));
                 Assert.IsNotNull(beatmap);
                 Assert.AreEqual("Beatmap with no header", beatmap.Metadata.Title);
-                Assert.AreEqual("Incredibly Evil Hacker", beatmap.Metadata.AuthorString);
+                Assert.AreEqual("Incredibly Evil Hacker", beatmap.Metadata.Author.Username);
             }
         }
 
@@ -583,7 +583,7 @@ namespace osu.Game.Tests.Beatmaps.Formats
                 Assert.DoesNotThrow(() => beatmap = decoder.Decode(stream));
                 Assert.IsNotNull(beatmap);
                 Assert.AreEqual("Empty lines at start", beatmap.Metadata.Title);
-                Assert.AreEqual("Edge Case Hunter", beatmap.Metadata.AuthorString);
+                Assert.AreEqual("Edge Case Hunter", beatmap.Metadata.Author.Username);
             }
         }
 
@@ -601,7 +601,7 @@ namespace osu.Game.Tests.Beatmaps.Formats
                 Assert.DoesNotThrow(() => beatmap = decoder.Decode(stream));
                 Assert.IsNotNull(beatmap);
                 Assert.AreEqual("The dog ate the file header", beatmap.Metadata.Title);
-                Assert.AreEqual("Why does this keep happening", beatmap.Metadata.AuthorString);
+                Assert.AreEqual("Why does this keep happening", beatmap.Metadata.Author.Username);
             }
         }
 
@@ -619,7 +619,7 @@ namespace osu.Game.Tests.Beatmaps.Formats
                 Assert.DoesNotThrow(() => beatmap = decoder.Decode(stream));
                 Assert.IsNotNull(beatmap);
                 Assert.AreEqual("No empty line delimiting header from contents", beatmap.Metadata.Title);
-                Assert.AreEqual("Edge Case Hunter", beatmap.Metadata.AuthorString);
+                Assert.AreEqual("Edge Case Hunter", beatmap.Metadata.Author.Username);
             }
         }
 
diff --git a/osu.Game.Tests/Beatmaps/Formats/OsuJsonDecoderTest.cs b/osu.Game.Tests/Beatmaps/Formats/OsuJsonDecoderTest.cs
index 9ec2f37569..37c1dfc657 100644
--- a/osu.Game.Tests/Beatmaps/Formats/OsuJsonDecoderTest.cs
+++ b/osu.Game.Tests/Beatmaps/Formats/OsuJsonDecoderTest.cs
@@ -35,7 +35,7 @@ namespace osu.Game.Tests.Beatmaps.Formats
             Assert.AreEqual("Soleily", meta.Artist);
             Assert.AreEqual("Soleily", meta.ArtistUnicode);
             Assert.AreEqual("03. Renatus - Soleily 192kbps.mp3", meta.AudioFile);
-            Assert.AreEqual("Gamu", meta.AuthorString);
+            Assert.AreEqual("Gamu", meta.Author.Username);
             Assert.AreEqual("machinetop_background.jpg", meta.BackgroundFile);
             Assert.AreEqual(164471, meta.PreviewTime);
             Assert.AreEqual(string.Empty, meta.Source);
diff --git a/osu.Game.Tests/Beatmaps/IO/OszArchiveReaderTest.cs b/osu.Game.Tests/Beatmaps/IO/OszArchiveReaderTest.cs
index d11da5e2a3..eaf5d107ca 100644
--- a/osu.Game.Tests/Beatmaps/IO/OszArchiveReaderTest.cs
+++ b/osu.Game.Tests/Beatmaps/IO/OszArchiveReaderTest.cs
@@ -60,7 +60,7 @@ namespace osu.Game.Tests.Beatmaps.IO
                 Assert.AreEqual("Soleily", meta.Artist);
                 Assert.AreEqual("Soleily", meta.ArtistUnicode);
                 Assert.AreEqual("03. Renatus - Soleily 192kbps.mp3", meta.AudioFile);
-                Assert.AreEqual("Deif", meta.AuthorString);
+                Assert.AreEqual("Deif", meta.Author.Username);
                 Assert.AreEqual("machinetop_background.jpg", meta.BackgroundFile);
                 Assert.AreEqual(164471, meta.PreviewTime);
                 Assert.AreEqual(string.Empty, meta.Source);
diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs
index 7a38d213d9..9a142f3ca8 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs
@@ -400,7 +400,7 @@ namespace osu.Game.Tests.Visual.SongSelect
             loadBeatmaps();
 
             AddStep("Sort by author", () => carousel.Filter(new FilterCriteria { Sort = SortMode.Author }, false));
-            AddAssert("Check zzzzz is at bottom", () => carousel.BeatmapSets.Last().Metadata.AuthorString == "zzzzz");
+            AddAssert("Check zzzzz is at bottom", () => carousel.BeatmapSets.Last().Metadata.Author.Username == "zzzzz");
             AddStep("Sort by artist", () => carousel.Filter(new FilterCriteria { Sort = SortMode.Artist }, false));
             AddAssert($"Check #{set_count} is at bottom", () => carousel.BeatmapSets.Last().Metadata.Title.EndsWith($"#{set_count}!", StringComparison.Ordinal));
         }
diff --git a/osu.Game/Beatmaps/BeatmapMetadata.cs b/osu.Game/Beatmaps/BeatmapMetadata.cs
index 4ae212c411..b395f16c24 100644
--- a/osu.Game/Beatmaps/BeatmapMetadata.cs
+++ b/osu.Game/Beatmaps/BeatmapMetadata.cs
@@ -49,7 +49,7 @@ namespace osu.Game.Beatmaps
         [Column("AuthorID")]
         public int AuthorID
         {
-            get => Author.Id;
+            get => Author.Id; // This should not be used, but is required to make EF work correctly.
             set => Author.Id = value;
         }
 
@@ -60,7 +60,7 @@ namespace osu.Game.Beatmaps
         [Column("Author")]
         public string AuthorString
         {
-            get => Author.Username;
+            get => Author.Username; // This should not be used, but is required to make EF work correctly.
             set => Author.Username = value;
         }
 
diff --git a/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs b/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs
index 3ed5055b7f..9117da5d32 100644
--- a/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs
+++ b/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs
@@ -129,7 +129,7 @@ namespace osu.Game.Beatmaps.Formats
             if (!string.IsNullOrEmpty(beatmap.Metadata.TitleUnicode)) writer.WriteLine(FormattableString.Invariant($"TitleUnicode: {beatmap.Metadata.TitleUnicode}"));
             writer.WriteLine(FormattableString.Invariant($"Artist: {beatmap.Metadata.Artist}"));
             if (!string.IsNullOrEmpty(beatmap.Metadata.ArtistUnicode)) writer.WriteLine(FormattableString.Invariant($"ArtistUnicode: {beatmap.Metadata.ArtistUnicode}"));
-            writer.WriteLine(FormattableString.Invariant($"Creator: {beatmap.Metadata.AuthorString}"));
+            writer.WriteLine(FormattableString.Invariant($"Creator: {beatmap.Metadata.Author.Username}"));
             writer.WriteLine(FormattableString.Invariant($"Version: {beatmap.BeatmapInfo.Version}"));
             if (!string.IsNullOrEmpty(beatmap.Metadata.Source)) writer.WriteLine(FormattableString.Invariant($"Source: {beatmap.Metadata.Source}"));
             if (!string.IsNullOrEmpty(beatmap.Metadata.Tags)) writer.WriteLine(FormattableString.Invariant($"Tags: {beatmap.Metadata.Tags}"));
diff --git a/osu.Game/Screens/Edit/Setup/MetadataSection.cs b/osu.Game/Screens/Edit/Setup/MetadataSection.cs
index 5bb40c09a5..34c2fa8480 100644
--- a/osu.Game/Screens/Edit/Setup/MetadataSection.cs
+++ b/osu.Game/Screens/Edit/Setup/MetadataSection.cs
@@ -46,7 +46,7 @@ namespace osu.Game.Screens.Edit.Setup
 
                 Empty(),
 
-                creatorTextBox = createTextBox<LabelledTextBox>("Creator", metadata.AuthorString),
+                creatorTextBox = createTextBox<LabelledTextBox>("Creator", metadata.Author.Username),
                 difficultyTextBox = createTextBox<LabelledTextBox>("Difficulty Name", Beatmap.BeatmapInfo.Version),
                 sourceTextBox = createTextBox<LabelledTextBox>("Source", metadata.Source),
                 tagsTextBox = createTextBox<LabelledTextBox>("Tags", metadata.Tags)
diff --git a/osu.Game/Screens/Play/BeatmapMetadataDisplay.cs b/osu.Game/Screens/Play/BeatmapMetadataDisplay.cs
index d77673580a..909f0a2b65 100644
--- a/osu.Game/Screens/Play/BeatmapMetadataDisplay.cs
+++ b/osu.Game/Screens/Play/BeatmapMetadataDisplay.cs
@@ -164,7 +164,7 @@ namespace osu.Game.Screens.Play
                                 new Drawable[]
                                 {
                                     new MetadataLineLabel("Mapper"),
-                                    new MetadataLineInfo(metadata.AuthorString)
+                                    new MetadataLineInfo(metadata.Author.Username)
                                 }
                             }
                         },
diff --git a/osu.Game/Screens/Select/Carousel/CarouselBeatmap.cs b/osu.Game/Screens/Select/Carousel/CarouselBeatmap.cs
index 9e057808a7..fa96e6dde7 100644
--- a/osu.Game/Screens/Select/Carousel/CarouselBeatmap.cs
+++ b/osu.Game/Screens/Select/Carousel/CarouselBeatmap.cs
@@ -49,7 +49,7 @@ namespace osu.Game.Screens.Select.Carousel
             match &= !criteria.BeatDivisor.HasFilter || criteria.BeatDivisor.IsInRange(BeatmapInfo.BeatDivisor);
             match &= !criteria.OnlineStatus.HasFilter || criteria.OnlineStatus.IsInRange(BeatmapInfo.Status);
 
-            match &= !criteria.Creator.HasFilter || criteria.Creator.Matches(BeatmapInfo.Metadata.AuthorString);
+            match &= !criteria.Creator.HasFilter || criteria.Creator.Matches(BeatmapInfo.Metadata.Author.Username);
             match &= !criteria.Artist.HasFilter || criteria.Artist.Matches(BeatmapInfo.Metadata.Artist) ||
                      criteria.Artist.Matches(BeatmapInfo.Metadata.ArtistUnicode);
 
diff --git a/osu.Game/Skinning/LegacyBeatmapSkin.cs b/osu.Game/Skinning/LegacyBeatmapSkin.cs
index 8720a55076..8abef6800d 100644
--- a/osu.Game/Skinning/LegacyBeatmapSkin.cs
+++ b/osu.Game/Skinning/LegacyBeatmapSkin.cs
@@ -77,6 +77,6 @@ namespace osu.Game.Skinning
         }
 
         private static SkinInfo createSkinInfo(BeatmapInfo beatmapInfo) =>
-            new SkinInfo { Name = beatmapInfo.ToString(), Creator = beatmapInfo.Metadata?.AuthorString };
+            new SkinInfo { Name = beatmapInfo.ToString(), Creator = beatmapInfo.Metadata?.Author.Username };
     }
 }
diff --git a/osu.Game/Stores/BeatmapImporter.cs b/osu.Game/Stores/BeatmapImporter.cs
index 5eb7b10d9b..1ac73cf781 100644
--- a/osu.Game/Stores/BeatmapImporter.cs
+++ b/osu.Game/Stores/BeatmapImporter.cs
@@ -240,8 +240,8 @@ namespace osu.Game.Stores
                         ArtistUnicode = decoded.Metadata.ArtistUnicode,
                         Author =
                         {
-                            OnlineID = decoded.Metadata.AuthorID,
-                            Username = decoded.Metadata.AuthorString
+                            OnlineID = decoded.Metadata.Author.Id,
+                            Username = decoded.Metadata.Author.Username
                         },
                         Source = decoded.Metadata.Source,
                         Tags = decoded.Metadata.Tags,
diff --git a/osu.Game/Tests/Visual/OsuTestScene.cs b/osu.Game/Tests/Visual/OsuTestScene.cs
index 153e2c487c..83e1423504 100644
--- a/osu.Game/Tests/Visual/OsuTestScene.cs
+++ b/osu.Game/Tests/Visual/OsuTestScene.cs
@@ -216,8 +216,6 @@ namespace osu.Game.Tests.Visual
                 Artist = beatmap.BeatmapSet.Metadata.Artist,
                 ArtistUnicode = beatmap.BeatmapSet.Metadata.ArtistUnicode,
                 Author = beatmap.BeatmapSet.Metadata.Author,
-                AuthorID = beatmap.BeatmapSet.Metadata.AuthorID,
-                AuthorString = beatmap.BeatmapSet.Metadata.AuthorString,
                 Source = beatmap.BeatmapSet.Metadata.Source,
                 Tags = beatmap.BeatmapSet.Metadata.Tags,
                 Beatmaps = new[]
@@ -228,7 +226,7 @@ namespace osu.Game.Tests.Visual
                         OnlineBeatmapSetID = beatmap.BeatmapSet.OnlineID,
                         Status = beatmap.Status,
                         Checksum = beatmap.MD5Hash,
-                        AuthorID = beatmap.Metadata.AuthorID,
+                        AuthorID = beatmap.Metadata.Author.OnlineID,
                         RulesetID = beatmap.RulesetID,
                         StarRating = beatmap.StarDifficulty,
                         DifficultyName = beatmap.Version,

From 28e9b9a25f2dbbb871d2e174371850aebad2a810 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 4 Nov 2021 19:01:39 +0900
Subject: [PATCH 0737/5547] Update framework

---
 osu.Android.props        | 2 +-
 osu.Game/osu.Game.csproj | 2 +-
 osu.iOS.props            | 4 ++--
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Android.props b/osu.Android.props
index 4887e3a95f..6d2e8428a7 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -52,7 +52,7 @@
   </ItemGroup>
   <ItemGroup>
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1026.0" />
-    <PackageReference Include="ppy.osu.Framework.Android" Version="2021.1103.0" />
+    <PackageReference Include="ppy.osu.Framework.Android" Version="2021.1104.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
     <!-- Realm needs to be directly referenced in all Xamarin projects, as it will not pull in its transitive dependencies otherwise. -->
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 972d64a997..6dda1f77c6 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="10.6.0" />
-    <PackageReference Include="ppy.osu.Framework" Version="2021.1103.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2021.1104.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1026.0" />
     <PackageReference Include="Sentry" Version="3.10.0" />
     <PackageReference Include="SharpCompress" Version="0.30.0" />
diff --git a/osu.iOS.props b/osu.iOS.props
index f6e4f61fde..df24a57e90 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -70,7 +70,7 @@
     <Reference Include="System.Net.Http" />
   </ItemGroup>
   <ItemGroup Label="Package References">
-    <PackageReference Include="ppy.osu.Framework.iOS" Version="2021.1103.0" />
+    <PackageReference Include="ppy.osu.Framework.iOS" Version="2021.1104.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1026.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net5.0 / net6.0) -->
@@ -93,7 +93,7 @@
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="2.2.6" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.Core" Version="2.2.6" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
-    <PackageReference Include="ppy.osu.Framework" Version="2021.1103.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2021.1104.0" />
     <PackageReference Include="SharpCompress" Version="0.30.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
     <PackageReference Include="SharpRaven" Version="2.4.0" />

From 30635fb4769dc70eaf27181450b5703cbf0a339e Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Thu, 4 Nov 2021 19:19:00 +0900
Subject: [PATCH 0738/5547] Use official nvika package again

---
 .config/dotnet-tools.json | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.config/dotnet-tools.json b/.config/dotnet-tools.json
index d64ad6ad21..6444127594 100644
--- a/.config/dotnet-tools.json
+++ b/.config/dotnet-tools.json
@@ -14,8 +14,8 @@
         "jb"
       ]
     },
-    "smoogipoo.nvika": {
-      "version": "1.0.4",
+    "nvika": {
+      "version": "2.2.0",
       "commands": [
         "nvika"
       ]

From 223efe55d5f8c0485f374c70a75ff32ee34cd7f9 Mon Sep 17 00:00:00 2001
From: Chinmay Patil <chinmaytlc@gmail.com>
Date: Thu, 4 Nov 2021 09:23:29 -0600
Subject: [PATCH 0739/5547] Added Tests for UR counter

---
 .../Gameplay/TestSceneUnstableRateCounter.cs  | 210 ++++++++++++++++++
 1 file changed, 210 insertions(+)
 create mode 100644 osu.Game.Tests/Visual/Gameplay/TestSceneUnstableRateCounter.cs

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneUnstableRateCounter.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneUnstableRateCounter.cs
new file mode 100644
index 0000000000..12bca1122a
--- /dev/null
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneUnstableRateCounter.cs
@@ -0,0 +1,210 @@
+// 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.CodeAnalysis;
+using System.Linq;
+using NUnit.Framework;
+using osu.Framework.Allocation;
+using osu.Framework.Extensions.IEnumerableExtensions;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
+using osu.Framework.Testing;
+using osu.Framework.Threading;
+using osu.Framework.Utils;
+using osu.Game.Graphics.Sprites;
+using osu.Game.Rulesets.Judgements;
+using osu.Game.Rulesets.Mania.Scoring;
+using osu.Game.Rulesets.Mods;
+using osu.Game.Rulesets.Objects;
+using osu.Game.Rulesets.Osu;
+using osu.Game.Rulesets.Osu.Objects;
+using osu.Game.Rulesets.Osu.Scoring;
+using osu.Game.Rulesets.Scoring;
+using osu.Game.Rulesets.Taiko.Scoring;
+using osu.Game.Rulesets.UI;
+using osu.Game.Scoring;
+using osu.Game.Screens.Play;
+using osu.Game.Screens.Play.HUD;
+using osu.Game.Screens.Play.HUD.HitErrorMeters;
+using osuTK;
+
+namespace osu.Game.Tests.Visual.Gameplay
+{
+    public class TestSceneUnstableRateCounter : OsuTestScene
+    {
+        [Cached(typeof(ScoreProcessor))]
+        private TestScoreProcessor scoreProcessor = new TestScoreProcessor();
+
+        [Cached(typeof(GameplayState))]
+        private GameplayState gameplayState;
+
+
+        [Cached(typeof(DrawableRuleset))]
+        private TestDrawableRuleset drawableRuleset = new TestDrawableRuleset();
+
+        private double prev;
+
+
+
+        public TestSceneUnstableRateCounter()
+        {
+            Score score = new Score
+            {
+                ScoreInfo = new ScoreInfo(),
+            };
+            gameplayState = new GameplayState(null, null, null, score);
+            scoreProcessor.NewJudgement += result => scoreProcessor.PopulateScore(score.ScoreInfo);
+        }
+
+
+
+
+
+        [SetUpSteps]
+        public void SetUp()
+        {
+            AddStep("Reset Score Processor", () => scoreProcessor.Reset());
+        }
+
+        [Test]
+        public void TestBasic()
+        {
+            AddStep("Create Display", () => recreateDisplay(new OsuHitWindows(), 5));
+
+
+            AddRepeatStep("Set UR to 250ms", () => setUR(25), 20);
+
+            AddStep("Reset UR", () =>
+            {
+                scoreProcessor.Reset();
+                recreateDisplay(new OsuHitWindows(), 5);
+            });
+
+            AddRepeatStep("Set UR to 100ms", () => setUR(10), 20);
+
+            AddStep("Reset UR", () =>
+            {
+                scoreProcessor.Reset();
+                recreateDisplay(new OsuHitWindows(), 5);
+            });
+
+            AddRepeatStep("Set UR to 0 (+50ms)", () => newJudgement(50), 20);
+
+            AddStep("Reset UR", () =>
+            {
+                scoreProcessor.Reset();
+                recreateDisplay(new OsuHitWindows(), 5);
+            });
+
+            AddRepeatStep("Set UR to 0 (-50ms)", () => newJudgement(-50), 20);
+
+            AddRepeatStep("New random judgement", () => newJudgement(), 40);
+        }
+        private void recreateDisplay(HitWindows hitWindows, float overallDifficulty)
+        {
+            hitWindows?.SetDifficulty(overallDifficulty);
+
+            drawableRuleset.HitWindows = hitWindows;
+
+            Clear();
+
+            Add(new UnstableRateCounter
+            {
+                Anchor = Anchor.Centre,
+                Origin = Anchor.Centre,
+                Scale = new Vector2(5),
+            });
+
+            Add(new BarHitErrorMeter
+            {
+                Anchor = Anchor.BottomCentre,
+                Origin = Anchor.CentreLeft,
+                Rotation = 270,
+            });
+
+            Add(new ColourHitErrorMeter
+            {
+                Anchor = Anchor.BottomCentre,
+                Origin = Anchor.CentreLeft,
+                Rotation = 270,
+                Margin = new MarginPadding { Left = 50 }
+            });
+        }
+
+
+
+
+
+
+        private void newJudgement(double offset = 0, HitResult result = HitResult.Perfect)
+        {
+            scoreProcessor.ApplyResult(new JudgementResult(new HitCircle { HitWindows = drawableRuleset.HitWindows }, new Judgement())
+            {
+                TimeOffset = offset == 0 ? RNG.Next(-150, 150) : offset,
+                Type = result,
+            });
+        }
+
+        private void setUR(double UR = 0, HitResult result = HitResult.Perfect)
+        {
+
+            double placement = prev > 0 ? -UR : UR;
+            scoreProcessor.ApplyResult(new JudgementResult(new HitCircle { HitWindows = drawableRuleset.HitWindows }, new Judgement())
+            {
+                TimeOffset = placement,
+                Type = result,
+            });
+            prev = placement;
+        }
+
+
+
+
+
+
+
+        [SuppressMessage("ReSharper", "UnassignedGetOnlyAutoProperty")]
+        private class TestDrawableRuleset : DrawableRuleset
+        {
+            public HitWindows HitWindows;
+
+            public override IEnumerable<HitObject> Objects => new[] { new HitCircle { HitWindows = HitWindows } };
+
+            public override event Action<JudgementResult> NewResult;
+            public override event Action<JudgementResult> RevertResult;
+
+            public override Playfield Playfield { get; }
+            public override Container Overlays { get; }
+            public override Container FrameStableComponents { get; }
+            public override IFrameStableClock FrameStableClock { get; }
+            internal override bool FrameStablePlayback { get; set; }
+            public override IReadOnlyList<Mod> Mods { get; }
+
+            public override double GameplayStartTime { get; }
+            public override GameplayCursorContainer Cursor { get; }
+
+            public TestDrawableRuleset()
+                : base(new OsuRuleset())
+            {
+                // won't compile without this.
+                NewResult?.Invoke(null);
+                RevertResult?.Invoke(null);
+            }
+
+            public override void SetReplayScore(Score replayScore) => throw new NotImplementedException();
+
+            public override void SetRecordTarget(Score score) => throw new NotImplementedException();
+
+            public override void RequestResume(Action continueResume) => throw new NotImplementedException();
+
+            public override void CancelResume() => throw new NotImplementedException();
+        }
+
+        private class TestScoreProcessor : ScoreProcessor
+        {
+            public void Reset() => base.Reset(false);
+        }
+    }
+}

From c5688885009ac1ec47b61b601a838354b9c4112e Mon Sep 17 00:00:00 2001
From: Chinmay Patil <chinmaytlc@gmail.com>
Date: Thu, 4 Nov 2021 09:47:52 -0600
Subject: [PATCH 0740/5547] Edited to remove unessicary blank lines

---
 .../Gameplay/TestSceneUnstableRateCounter.cs   | 18 ------------------
 .../Screens/Play/HUD/UnstableRateCounter.cs    |  7 ++-----
 2 files changed, 2 insertions(+), 23 deletions(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneUnstableRateCounter.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneUnstableRateCounter.cs
index 12bca1122a..7f0228c4b0 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneUnstableRateCounter.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneUnstableRateCounter.cs
@@ -46,8 +46,6 @@ namespace osu.Game.Tests.Visual.Gameplay
 
         private double prev;
 
-
-
         public TestSceneUnstableRateCounter()
         {
             Score score = new Score
@@ -58,10 +56,6 @@ namespace osu.Game.Tests.Visual.Gameplay
             scoreProcessor.NewJudgement += result => scoreProcessor.PopulateScore(score.ScoreInfo);
         }
 
-
-
-
-
         [SetUpSteps]
         public void SetUp()
         {
@@ -73,7 +67,6 @@ namespace osu.Game.Tests.Visual.Gameplay
         {
             AddStep("Create Display", () => recreateDisplay(new OsuHitWindows(), 5));
 
-
             AddRepeatStep("Set UR to 250ms", () => setUR(25), 20);
 
             AddStep("Reset UR", () =>
@@ -133,11 +126,6 @@ namespace osu.Game.Tests.Visual.Gameplay
             });
         }
 
-
-
-
-
-
         private void newJudgement(double offset = 0, HitResult result = HitResult.Perfect)
         {
             scoreProcessor.ApplyResult(new JudgementResult(new HitCircle { HitWindows = drawableRuleset.HitWindows }, new Judgement())
@@ -159,12 +147,6 @@ namespace osu.Game.Tests.Visual.Gameplay
             prev = placement;
         }
 
-
-
-
-
-
-
         [SuppressMessage("ReSharper", "UnassignedGetOnlyAutoProperty")]
         private class TestDrawableRuleset : DrawableRuleset
         {
diff --git a/osu.Game/Screens/Play/HUD/UnstableRateCounter.cs b/osu.Game/Screens/Play/HUD/UnstableRateCounter.cs
index 7109ea1995..489a7ff721 100644
--- a/osu.Game/Screens/Play/HUD/UnstableRateCounter.cs
+++ b/osu.Game/Screens/Play/HUD/UnstableRateCounter.cs
@@ -100,15 +100,12 @@ namespace osu.Game.Screens.Play.HUD
 
 
         protected override OsuSpriteText CreateSpriteText()
-            => base.CreateSpriteText().With(s => {
+            => base.CreateSpriteText().With(s =>
+            {
                 s.Font = s.Font.With(size: 12f, fixedWidth: true);
                 s.Alpha = alpha_when_invalid;
             });
 
-
-
-        
-
         protected override void Dispose(bool isDisposing)
         {
             base.Dispose(isDisposing);

From a76878e05350723e4d598be1c0832ac51525c782 Mon Sep 17 00:00:00 2001
From: Chinmay Patil <chinmaytlc@gmail.com>
Date: Thu, 4 Nov 2021 09:52:16 -0600
Subject: [PATCH 0741/5547] A bit more formatting

---
 .../Visual/Gameplay/TestSceneUnstableRateCounter.cs           | 2 --
 osu.Game/Screens/Play/HUD/UnstableRateCounter.cs              | 4 ----
 2 files changed, 6 deletions(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneUnstableRateCounter.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneUnstableRateCounter.cs
index 7f0228c4b0..8076799064 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneUnstableRateCounter.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneUnstableRateCounter.cs
@@ -40,7 +40,6 @@ namespace osu.Game.Tests.Visual.Gameplay
         [Cached(typeof(GameplayState))]
         private GameplayState gameplayState;
 
-
         [Cached(typeof(DrawableRuleset))]
         private TestDrawableRuleset drawableRuleset = new TestDrawableRuleset();
 
@@ -137,7 +136,6 @@ namespace osu.Game.Tests.Visual.Gameplay
 
         private void setUR(double UR = 0, HitResult result = HitResult.Perfect)
         {
-
             double placement = prev > 0 ? -UR : UR;
             scoreProcessor.ApplyResult(new JudgementResult(new HitCircle { HitWindows = drawableRuleset.HitWindows }, new Judgement())
             {
diff --git a/osu.Game/Screens/Play/HUD/UnstableRateCounter.cs b/osu.Game/Screens/Play/HUD/UnstableRateCounter.cs
index 489a7ff721..3e3240c683 100644
--- a/osu.Game/Screens/Play/HUD/UnstableRateCounter.cs
+++ b/osu.Game/Screens/Play/HUD/UnstableRateCounter.cs
@@ -76,7 +76,6 @@ namespace osu.Game.Screens.Play.HUD
 
         private void onJudgementChanged(JudgementResult judgement)
         {
-
             if (gameplayState == null)
             {
                 isValid = false;
@@ -98,7 +97,6 @@ namespace osu.Game.Screens.Play.HUD
             return count.ToLocalisableString("0.00 UR");
         }
 
-
         protected override OsuSpriteText CreateSpriteText()
             => base.CreateSpriteText().With(s =>
             {
@@ -115,7 +113,5 @@ namespace osu.Game.Screens.Play.HUD
 
             loadCancellationSource?.Cancel();
         }
-
-
     }
 }

From 8923561b0543cd2881ba55c56beef215b3d11bed Mon Sep 17 00:00:00 2001
From: Chinmay Patil <chinmaytlc@gmail.com>
Date: Thu, 4 Nov 2021 14:27:48 -0600
Subject: [PATCH 0742/5547] Removed Unnessicary class in the Test file, and
 optimized UR counter

---
 .../Gameplay/TestSceneUnstableRateCounter.cs  |  94 ++-----------
 .../Screens/Play/HUD/UnstableRateCounter.cs   | 133 +++++++++++++-----
 2 files changed, 109 insertions(+), 118 deletions(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneUnstableRateCounter.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneUnstableRateCounter.cs
index 8076799064..be1cd8a35c 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneUnstableRateCounter.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneUnstableRateCounter.cs
@@ -7,27 +7,16 @@ using System.Diagnostics.CodeAnalysis;
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
-using osu.Framework.Extensions.IEnumerableExtensions;
 using osu.Framework.Graphics;
-using osu.Framework.Graphics.Containers;
 using osu.Framework.Testing;
-using osu.Framework.Threading;
 using osu.Framework.Utils;
-using osu.Game.Graphics.Sprites;
 using osu.Game.Rulesets.Judgements;
-using osu.Game.Rulesets.Mania.Scoring;
-using osu.Game.Rulesets.Mods;
-using osu.Game.Rulesets.Objects;
-using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Osu.Objects;
 using osu.Game.Rulesets.Osu.Scoring;
 using osu.Game.Rulesets.Scoring;
-using osu.Game.Rulesets.Taiko.Scoring;
-using osu.Game.Rulesets.UI;
 using osu.Game.Scoring;
 using osu.Game.Screens.Play;
 using osu.Game.Screens.Play.HUD;
-using osu.Game.Screens.Play.HUD.HitErrorMeters;
 using osuTK;
 
 namespace osu.Game.Tests.Visual.Gameplay
@@ -40,8 +29,7 @@ namespace osu.Game.Tests.Visual.Gameplay
         [Cached(typeof(GameplayState))]
         private GameplayState gameplayState;
 
-        [Cached(typeof(DrawableRuleset))]
-        private TestDrawableRuleset drawableRuleset = new TestDrawableRuleset();
+        private OsuHitWindows hitWindows = new OsuHitWindows();
 
         private double prev;
 
@@ -64,42 +52,38 @@ namespace osu.Game.Tests.Visual.Gameplay
         [Test]
         public void TestBasic()
         {
-            AddStep("Create Display", () => recreateDisplay(new OsuHitWindows(), 5));
+            AddStep("Create Display", () => recreateDisplay());
 
-            AddRepeatStep("Set UR to 250ms", () => setUR(25), 20);
+            AddRepeatStep("Set UR to 250", () => setUR(25), 20);
 
             AddStep("Reset UR", () =>
             {
                 scoreProcessor.Reset();
-                recreateDisplay(new OsuHitWindows(), 5);
+                recreateDisplay();
             });
 
-            AddRepeatStep("Set UR to 100ms", () => setUR(10), 20);
+            AddRepeatStep("Set UR to 100", () => setUR(10), 20);
 
             AddStep("Reset UR", () =>
             {
                 scoreProcessor.Reset();
-                recreateDisplay(new OsuHitWindows(), 5);
+                recreateDisplay();
             });
 
-            AddRepeatStep("Set UR to 0 (+50ms)", () => newJudgement(50), 20);
+            AddRepeatStep("Set UR to 0 (+50ms offset)", () => newJudgement(50), 10);
 
             AddStep("Reset UR", () =>
             {
                 scoreProcessor.Reset();
-                recreateDisplay(new OsuHitWindows(), 5);
+                recreateDisplay();
             });
 
-            AddRepeatStep("Set UR to 0 (-50ms)", () => newJudgement(-50), 20);
+            AddRepeatStep("Set UR to 0 (-50 offset)", () => newJudgement(-50), 10);
 
-            AddRepeatStep("New random judgement", () => newJudgement(), 40);
+            AddRepeatStep("Random Judgements", () => newJudgement(), 20);
         }
-        private void recreateDisplay(HitWindows hitWindows, float overallDifficulty)
+        private void recreateDisplay()
         {
-            hitWindows?.SetDifficulty(overallDifficulty);
-
-            drawableRuleset.HitWindows = hitWindows;
-
             Clear();
 
             Add(new UnstableRateCounter
@@ -108,26 +92,11 @@ namespace osu.Game.Tests.Visual.Gameplay
                 Origin = Anchor.Centre,
                 Scale = new Vector2(5),
             });
-
-            Add(new BarHitErrorMeter
-            {
-                Anchor = Anchor.BottomCentre,
-                Origin = Anchor.CentreLeft,
-                Rotation = 270,
-            });
-
-            Add(new ColourHitErrorMeter
-            {
-                Anchor = Anchor.BottomCentre,
-                Origin = Anchor.CentreLeft,
-                Rotation = 270,
-                Margin = new MarginPadding { Left = 50 }
-            });
         }
 
         private void newJudgement(double offset = 0, HitResult result = HitResult.Perfect)
         {
-            scoreProcessor.ApplyResult(new JudgementResult(new HitCircle { HitWindows = drawableRuleset.HitWindows }, new Judgement())
+            scoreProcessor.ApplyResult(new JudgementResult(new HitCircle { HitWindows = hitWindows }, new Judgement())
             {
                 TimeOffset = offset == 0 ? RNG.Next(-150, 150) : offset,
                 Type = result,
@@ -137,7 +106,7 @@ namespace osu.Game.Tests.Visual.Gameplay
         private void setUR(double UR = 0, HitResult result = HitResult.Perfect)
         {
             double placement = prev > 0 ? -UR : UR;
-            scoreProcessor.ApplyResult(new JudgementResult(new HitCircle { HitWindows = drawableRuleset.HitWindows }, new Judgement())
+            scoreProcessor.ApplyResult(new JudgementResult(new HitCircle { HitWindows = hitWindows }, new Judgement())
             {
                 TimeOffset = placement,
                 Type = result,
@@ -145,43 +114,6 @@ namespace osu.Game.Tests.Visual.Gameplay
             prev = placement;
         }
 
-        [SuppressMessage("ReSharper", "UnassignedGetOnlyAutoProperty")]
-        private class TestDrawableRuleset : DrawableRuleset
-        {
-            public HitWindows HitWindows;
-
-            public override IEnumerable<HitObject> Objects => new[] { new HitCircle { HitWindows = HitWindows } };
-
-            public override event Action<JudgementResult> NewResult;
-            public override event Action<JudgementResult> RevertResult;
-
-            public override Playfield Playfield { get; }
-            public override Container Overlays { get; }
-            public override Container FrameStableComponents { get; }
-            public override IFrameStableClock FrameStableClock { get; }
-            internal override bool FrameStablePlayback { get; set; }
-            public override IReadOnlyList<Mod> Mods { get; }
-
-            public override double GameplayStartTime { get; }
-            public override GameplayCursorContainer Cursor { get; }
-
-            public TestDrawableRuleset()
-                : base(new OsuRuleset())
-            {
-                // won't compile without this.
-                NewResult?.Invoke(null);
-                RevertResult?.Invoke(null);
-            }
-
-            public override void SetReplayScore(Score replayScore) => throw new NotImplementedException();
-
-            public override void SetRecordTarget(Score score) => throw new NotImplementedException();
-
-            public override void RequestResume(Action continueResume) => throw new NotImplementedException();
-
-            public override void CancelResume() => throw new NotImplementedException();
-        }
-
         private class TestScoreProcessor : ScoreProcessor
         {
             public void Reset() => base.Reset(false);
diff --git a/osu.Game/Screens/Play/HUD/UnstableRateCounter.cs b/osu.Game/Screens/Play/HUD/UnstableRateCounter.cs
index 3e3240c683..401924a898 100644
--- a/osu.Game/Screens/Play/HUD/UnstableRateCounter.cs
+++ b/osu.Game/Screens/Play/HUD/UnstableRateCounter.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.Collections.Generic;
+using System.Linq;
 using System.Threading;
 using JetBrains.Annotations;
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.LocalisationExtensions;
 using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.Sprites;
 using osu.Framework.Localisation;
 using osu.Game.Beatmaps;
 using osu.Game.Graphics;
@@ -13,8 +18,10 @@ using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Rulesets.Judgements;
 using osu.Game.Rulesets.Scoring;
+using osu.Game.Scoring;
 using osu.Game.Screens.Ranking.Statistics;
 using osu.Game.Skinning;
+using osuTK;
 
 namespace osu.Game.Screens.Play.HUD
 {
@@ -28,19 +35,16 @@ namespace osu.Game.Screens.Play.HUD
 
         private const float alpha_when_invalid = 0.3f;
 
+        private List<double> hitList = new List<double>();
+
         [CanBeNull]
         [Resolved(CanBeNull = true)]
         private ScoreProcessor scoreProcessor { get; set; }
 
-        [Resolved(CanBeNull = true)]
-        [CanBeNull]
-        private GameplayState gameplayState { get; set; }
-
         private readonly CancellationTokenSource loadCancellationSource = new CancellationTokenSource();
-
         public UnstableRateCounter()
         {
-            Current.Value = DisplayedCount = 0.0;
+            Current.Value = 0.0;
         }
 
         [BackgroundDependencyLoader]
@@ -55,63 +59,118 @@ namespace osu.Game.Screens.Play.HUD
 
             if (scoreProcessor != null)
             {
-                scoreProcessor.NewJudgement += onJudgementChanged;
+                scoreProcessor.NewJudgement += onJudgementAdded;
                 scoreProcessor.JudgementReverted += onJudgementChanged;
             }
         }
 
         private bool isValid;
-
-        protected bool IsValid
+        private void setValid(bool valid)
         {
-            set
-            {
-                if (value == isValid)
-                    return;
-
-                isValid = value;
-                DrawableCount.FadeTo(isValid ? 1 : alpha_when_invalid, 1000, Easing.OutQuint);
-            }
+            isValid = valid;
+            DrawableCount.FadeTo(isValid ? 1 : alpha_when_invalid, 1000, Easing.OutQuint);
         }
 
+        private void onJudgementAdded(JudgementResult judgement)
+        {
+            if (!(judgement.HitObject.HitWindows is HitWindows.EmptyHitWindows) && judgement.IsHit)
+            {
+                hitList.Add(judgement.TimeOffset);
+            }
+            updateUR();
+        }
+
+        // Only populate via the score if the user has moved the current location. 
         private void onJudgementChanged(JudgementResult judgement)
         {
-            if (gameplayState == null)
-            {
-                isValid = false;
-                return;
-            }
+            ScoreInfo currentScore = new ScoreInfo();
+            scoreProcessor.PopulateScore(currentScore);
+            hitList = currentScore.HitEvents.Where(e => !(e.HitObject.HitWindows is HitWindows.EmptyHitWindows) && e.Result.IsHit())
+                                            .Select(ev => ev.TimeOffset).ToList<double>();
+            updateUR();
+        }
 
-            double ur = new UnstableRate(gameplayState.Score.ScoreInfo.HitEvents).Value;
-            if (double.IsNaN(ur)) // Error handling: If the user misses the first few notes, the UR is NaN.
+        private void updateUR()
+        {
+            if (hitList.Count > 0)
             {
-                isValid = false;
-                return;
+                double mean = hitList.Average();
+                double squares = hitList.Select(offset => Math.Pow(offset - mean, 2)).Sum();
+                Current.Value = Math.Sqrt(squares / hitList.Count) * 10;
+                setValid(true);
+            }
+            else
+            {
+                setValid(false);
             }
-            Current.Value = ur;
-            IsValid = true;
         }
 
         protected override LocalisableString FormatCount(double count)
         {
-            return count.ToLocalisableString("0.00 UR");
+            return count.ToString("0.00");
         }
 
-        protected override OsuSpriteText CreateSpriteText()
-            => base.CreateSpriteText().With(s =>
-            {
-                s.Font = s.Font.With(size: 12f, fixedWidth: true);
-                s.Alpha = alpha_when_invalid;
-            });
+        protected override IHasText CreateText() => new TextComponent
+        {
+            Alpha = alpha_when_invalid,
+        };
 
         protected override void Dispose(bool isDisposing)
         {
             base.Dispose(isDisposing);
 
             if (scoreProcessor != null)
-                scoreProcessor.NewJudgement -= onJudgementChanged;
-
+            {
+                scoreProcessor.NewJudgement -= onJudgementAdded;
+                scoreProcessor.JudgementReverted -= onJudgementChanged;
+            }
             loadCancellationSource?.Cancel();
         }
+
+        private class TextComponent : CompositeDrawable, IHasText
+        {
+            public LocalisableString Text
+            {
+                get => intPart.Text;
+                set {
+                    //Not too sure about this, is there a better way to go about doing this?
+                    splitValue = value.ToString().Split('.');
+                    intPart.Text = splitValue[0];
+                    decimalPart.Text = $".{splitValue[1]} UR";
+                }
+            }
+
+            private string[] splitValue;
+            private readonly OsuSpriteText intPart;
+            private readonly OsuSpriteText decimalPart;
+
+            public TextComponent()
+            {
+                AutoSizeAxes = Axes.Both;
+
+                InternalChild = new FillFlowContainer
+                {
+                    AutoSizeAxes = Axes.Both,
+                    //Spacing = new Vector2(2),
+                    Children = new Drawable[]
+                    {
+                        intPart = new OsuSpriteText
+                        {
+                            Anchor = Anchor.BottomLeft,
+                            Origin = Anchor.BottomLeft,
+                            Font = OsuFont.Numeric.With(size: 16, fixedWidth: true)
+                        },
+                        decimalPart = new OsuSpriteText
+                        {
+                            Anchor = Anchor.BottomLeft,
+                            Origin = Anchor.BottomLeft,
+                            Text = @" UR",
+                            Font = OsuFont.Numeric.With(size: 8, fixedWidth: true),
+                            Padding = new MarginPadding { Bottom = 1.5f },
+                        }
+                    }
+                };
+            }
+        }
     }
 }

From 0ffd41bb70a3e57dd729d36559fa9ef2e7c045f8 Mon Sep 17 00:00:00 2001
From: Chinmay Patil <chinmaytlc@gmail.com>
Date: Thu, 4 Nov 2021 14:32:28 -0600
Subject: [PATCH 0743/5547] Slight logical error in the setValid method

---
 osu.Game/Screens/Play/HUD/UnstableRateCounter.cs | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Play/HUD/UnstableRateCounter.cs b/osu.Game/Screens/Play/HUD/UnstableRateCounter.cs
index 401924a898..c68f24c721 100644
--- a/osu.Game/Screens/Play/HUD/UnstableRateCounter.cs
+++ b/osu.Game/Screens/Play/HUD/UnstableRateCounter.cs
@@ -67,8 +67,9 @@ namespace osu.Game.Screens.Play.HUD
         private bool isValid;
         private void setValid(bool valid)
         {
-            isValid = valid;
+            if (isValid == valid) return;
             DrawableCount.FadeTo(isValid ? 1 : alpha_when_invalid, 1000, Easing.OutQuint);
+            isValid = valid;
         }
 
         private void onJudgementAdded(JudgementResult judgement)

From 9246adc349f8e0e204029390548581d80ff2a87a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 4 Nov 2021 21:32:57 +0100
Subject: [PATCH 0744/5547] Add failing test coverage for labelled drawable
 description visible

---
 .../Visual/UserInterface/TestSceneLabelledDrawable.cs      | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneLabelledDrawable.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneLabelledDrawable.cs
index fe312ccc8f..d5dda6f6cd 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneLabelledDrawable.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneLabelledDrawable.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.Extensions.IEnumerableExtensions;
 using osu.Framework.Graphics;
@@ -65,10 +66,10 @@ namespace osu.Game.Tests.Visual.UserInterface
 
         private void createPaddedComponent(bool hasDescription = false, bool padded = true)
         {
+            LabelledDrawable<Drawable> component = null;
+
             AddStep("create component", () =>
             {
-                LabelledDrawable<Drawable> component;
-
                 Child = new Container
                 {
                     Anchor = Anchor.Centre,
@@ -81,6 +82,8 @@ namespace osu.Game.Tests.Visual.UserInterface
                 component.Label = "a sample component";
                 component.Description = hasDescription ? "this text describes the component" : string.Empty;
             });
+
+            AddAssert($"description {(hasDescription ? "visible" : "hidden")}", () => component.ChildrenOfType<TextFlowContainer>().ElementAt(1).IsPresent == hasDescription);
         }
 
         private class PaddedLabelledDrawable : LabelledDrawable<Drawable>

From 4c8d6a77be6baaac0bd0ee739bb93728e6bfb883 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 4 Nov 2021 21:38:01 +0100
Subject: [PATCH 0745/5547] Fix labelled drawable descriptions not showing

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

diff --git a/osu.Game/Graphics/UserInterfaceV2/LabelledDrawable.cs b/osu.Game/Graphics/UserInterfaceV2/LabelledDrawable.cs
index 95884f1515..1e6032c1d0 100644
--- a/osu.Game/Graphics/UserInterfaceV2/LabelledDrawable.cs
+++ b/osu.Game/Graphics/UserInterfaceV2/LabelledDrawable.cs
@@ -168,7 +168,7 @@ namespace osu.Game.Graphics.UserInterfaceV2
             {
                 descriptionText.Text = value;
 
-                if (value == default)
+                if (!string.IsNullOrEmpty(value.ToString()))
                     descriptionText.Show();
                 else
                     descriptionText.Hide();

From 9e7d559f55307930b24bd3de270ac3c6360248fb Mon Sep 17 00:00:00 2001
From: Jason Won <jasonwon628@gmail.com>
Date: Thu, 4 Nov 2021 17:10:41 -0400
Subject: [PATCH 0746/5547] fix aspect locked scaling of skin components

---
 .../Skinning/Editor/SkinSelectionHandler.cs    | 18 ++++++++++--------
 1 file changed, 10 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Skinning/Editor/SkinSelectionHandler.cs b/osu.Game/Skinning/Editor/SkinSelectionHandler.cs
index 0790faad34..01bd5e8196 100644
--- a/osu.Game/Skinning/Editor/SkinSelectionHandler.cs
+++ b/osu.Game/Skinning/Editor/SkinSelectionHandler.cs
@@ -70,14 +70,16 @@ namespace osu.Game.Skinning.Editor
             if (anchor.HasFlagFast(Anchor.x1)) scale.X = 0;
             if (anchor.HasFlagFast(Anchor.y1)) scale.Y = 0;
 
-            bool shouldAspectLock =
-                // for now aspect lock scale adjustments that occur at corners..
-                (!anchor.HasFlagFast(Anchor.x1) && !anchor.HasFlagFast(Anchor.y1))
-                // ..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).
-                || SelectedBlueprints.Any(b => !Precision.AlmostEquals(((Drawable)b.Item).Rotation, 0));
-
-            if (shouldAspectLock)
+            // 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, 0)))
             {
                 if (anchor.HasFlagFast(Anchor.x1))
                     // if dragging from the horizontal centre, only a vertical component is available.

From af6ae1cce560faa31fd4033c4678054050e99a7c Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 5 Nov 2021 03:49:11 +0300
Subject: [PATCH 0747/5547] Remove hacky code with explicit pragma disable

---
 osu.Game.Tests/NonVisual/FirstAvailableHitWindowsTest.cs | 5 ++---
 osu.Game.Tests/Visual/Gameplay/TestSceneHitErrorMeter.cs | 5 ++---
 2 files changed, 4 insertions(+), 6 deletions(-)

diff --git a/osu.Game.Tests/NonVisual/FirstAvailableHitWindowsTest.cs b/osu.Game.Tests/NonVisual/FirstAvailableHitWindowsTest.cs
index 97105b6b6a..8d83fe7452 100644
--- a/osu.Game.Tests/NonVisual/FirstAvailableHitWindowsTest.cs
+++ b/osu.Game.Tests/NonVisual/FirstAvailableHitWindowsTest.cs
@@ -79,8 +79,10 @@ namespace osu.Game.Tests.NonVisual
             public List<HitObject> HitObjects;
             public override IEnumerable<HitObject> Objects => HitObjects;
 
+#pragma warning disable 67
             public override event Action<JudgementResult> NewResult;
             public override event Action<JudgementResult> RevertResult;
+#pragma warning restore 67
 
             public override Playfield Playfield { get; }
             public override Container Overlays { get; }
@@ -95,9 +97,6 @@ namespace osu.Game.Tests.NonVisual
             public TestDrawableRuleset()
                 : base(new OsuRuleset())
             {
-                // won't compile without this.
-                NewResult?.Invoke(null);
-                RevertResult?.Invoke(null);
             }
 
             public override void SetReplayScore(Score replayScore) => throw new NotImplementedException();
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneHitErrorMeter.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneHitErrorMeter.cs
index 1ba0965ceb..aa29f1386c 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneHitErrorMeter.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneHitErrorMeter.cs
@@ -235,8 +235,10 @@ namespace osu.Game.Tests.Visual.Gameplay
 
             public override IEnumerable<HitObject> Objects => new[] { new HitCircle { HitWindows = HitWindows } };
 
+#pragma warning disable 67
             public override event Action<JudgementResult> NewResult;
             public override event Action<JudgementResult> RevertResult;
+#pragma warning restore 67
 
             public override Playfield Playfield { get; }
             public override Container Overlays { get; }
@@ -251,9 +253,6 @@ namespace osu.Game.Tests.Visual.Gameplay
             public TestDrawableRuleset()
                 : base(new OsuRuleset())
             {
-                // won't compile without this.
-                NewResult?.Invoke(null);
-                RevertResult?.Invoke(null);
             }
 
             public override void SetReplayScore(Score replayScore) => throw new NotImplementedException();

From 6197ef426dd1a70e1240e7a9ea0eb83b837f61df Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 5 Nov 2021 03:50:17 +0300
Subject: [PATCH 0748/5547] Disable another "code heurstically unreachable"
 with comment

---
 osu.Game.Tests/Mods/ModDifficultyAdjustTest.cs | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/osu.Game.Tests/Mods/ModDifficultyAdjustTest.cs b/osu.Game.Tests/Mods/ModDifficultyAdjustTest.cs
index 84cf796835..fd620a0e95 100644
--- a/osu.Game.Tests/Mods/ModDifficultyAdjustTest.cs
+++ b/osu.Game.Tests/Mods/ModDifficultyAdjustTest.cs
@@ -105,6 +105,9 @@ namespace osu.Game.Tests.Mods
             testMod.ResetSettingsToDefaults();
 
             Assert.That(testMod.DrainRate.Value, Is.Null);
+
+            // ReSharper disable once HeuristicUnreachableCode
+            // see https://youtrack.jetbrains.com/issue/RIDER-70159.
             Assert.That(testMod.OverallDifficulty.Value, Is.Null);
 
             var applied = applyDifficulty(new BeatmapDifficulty

From 36d99a2e34297f1a2c7f0dacb2704ab8e61a463f Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 5 Nov 2021 03:51:08 +0300
Subject: [PATCH 0749/5547] Move action to private named method to avoid null
 inspection

---
 osu.Game/Overlays/OverlayScrollContainer.cs | 12 +++++++-----
 1 file changed, 7 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Overlays/OverlayScrollContainer.cs b/osu.Game/Overlays/OverlayScrollContainer.cs
index ca5fc90027..7fe188eb04 100644
--- a/osu.Game/Overlays/OverlayScrollContainer.cs
+++ b/osu.Game/Overlays/OverlayScrollContainer.cs
@@ -37,11 +37,7 @@ namespace osu.Game.Overlays
                 Anchor = Anchor.BottomRight,
                 Origin = Anchor.BottomRight,
                 Margin = new MarginPadding(20),
-                Action = () =>
-                {
-                    ScrollToStart();
-                    Button.State = Visibility.Hidden;
-                }
+                Action = scrollToTop
             });
         }
 
@@ -58,6 +54,12 @@ namespace osu.Game.Overlays
             Button.State = Target > button_scroll_position ? Visibility.Visible : Visibility.Hidden;
         }
 
+        private void scrollToTop()
+        {
+            ScrollToStart();
+            Button.State = Visibility.Hidden;
+        }
+
         public class ScrollToTopButton : OsuHoverContainer
         {
             private const int fade_duration = 500;

From 4245af28e1a3b1d953e391d29c65d535779c70be Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 5 Nov 2021 04:50:52 +0300
Subject: [PATCH 0750/5547] Disable other false-positive null inspections with
 comment

---
 .../BeatmapListing/BeatmapSearchMultipleSelectionFilterRow.cs   | 2 ++
 osu.Game/Overlays/Changelog/ChangelogHeader.cs                  | 2 ++
 osu.Game/Overlays/Comments/CommentEditor.cs                     | 2 ++
 3 files changed, 6 insertions(+)

diff --git a/osu.Game/Overlays/BeatmapListing/BeatmapSearchMultipleSelectionFilterRow.cs b/osu.Game/Overlays/BeatmapListing/BeatmapSearchMultipleSelectionFilterRow.cs
index e0632ace58..845190f285 100644
--- a/osu.Game/Overlays/BeatmapListing/BeatmapSearchMultipleSelectionFilterRow.cs
+++ b/osu.Game/Overlays/BeatmapListing/BeatmapSearchMultipleSelectionFilterRow.cs
@@ -23,6 +23,8 @@ namespace osu.Game.Overlays.BeatmapListing
         public BeatmapSearchMultipleSelectionFilterRow(LocalisableString header)
             : base(header)
         {
+            // ReSharper disable once PossibleNullReferenceException
+            // see https://youtrack.jetbrains.com/issue/RSRP-486768
             Current.BindTo(filter.Current);
         }
 
diff --git a/osu.Game/Overlays/Changelog/ChangelogHeader.cs b/osu.Game/Overlays/Changelog/ChangelogHeader.cs
index 52dea63ab7..69a8cb2ce0 100644
--- a/osu.Game/Overlays/Changelog/ChangelogHeader.cs
+++ b/osu.Game/Overlays/Changelog/ChangelogHeader.cs
@@ -39,6 +39,8 @@ namespace osu.Game.Overlays.Changelog
 
             Build.ValueChanged += showBuild;
 
+            // ReSharper disable once PossibleNullReferenceException
+            // see https://youtrack.jetbrains.com/issue/RSRP-486768
             Streams.Current.ValueChanged += e =>
             {
                 if (e.NewValue?.LatestBuild != null && !e.NewValue.Equals(Build.Value?.UpdateStream))
diff --git a/osu.Game/Overlays/Comments/CommentEditor.cs b/osu.Game/Overlays/Comments/CommentEditor.cs
index 20a8ab64f7..1f3931901c 100644
--- a/osu.Game/Overlays/Comments/CommentEditor.cs
+++ b/osu.Game/Overlays/Comments/CommentEditor.cs
@@ -187,6 +187,8 @@ namespace osu.Game.Overlays.Comments
                 AutoSizeAxes = Axes.Both;
                 LoadingAnimationSize = new Vector2(10);
 
+                // ReSharper disable once PossibleNullReferenceException
+                // see https://youtrack.jetbrains.com/issue/RSRP-486768
                 drawableText.Text = text;
             }
 

From f528488aa2ddea3979ca35c4da2bedb1e2761910 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 5 Nov 2021 05:36:04 +0300
Subject: [PATCH 0751/5547] Mark as non-null and move current bind to BDL
 instead

---
 .../BeatmapSearchMultipleSelectionFilterRow.cs           | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Overlays/BeatmapListing/BeatmapSearchMultipleSelectionFilterRow.cs b/osu.Game/Overlays/BeatmapListing/BeatmapSearchMultipleSelectionFilterRow.cs
index 845190f285..461a06a634 100644
--- a/osu.Game/Overlays/BeatmapListing/BeatmapSearchMultipleSelectionFilterRow.cs
+++ b/osu.Game/Overlays/BeatmapListing/BeatmapSearchMultipleSelectionFilterRow.cs
@@ -4,6 +4,7 @@
 using System;
 using System.Collections.Generic;
 using System.Linq;
+using JetBrains.Annotations;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
@@ -23,8 +24,11 @@ namespace osu.Game.Overlays.BeatmapListing
         public BeatmapSearchMultipleSelectionFilterRow(LocalisableString header)
             : base(header)
         {
-            // ReSharper disable once PossibleNullReferenceException
-            // see https://youtrack.jetbrains.com/issue/RSRP-486768
+        }
+
+        [BackgroundDependencyLoader]
+        private void load()
+        {
             Current.BindTo(filter.Current);
         }
 
@@ -33,6 +37,7 @@ namespace osu.Game.Overlays.BeatmapListing
         /// <summary>
         /// Creates a filter control that can be used to simultaneously select multiple values of type <typeparamref name="T"/>.
         /// </summary>
+        [NotNull]
         protected virtual MultipleSelectionFilter CreateMultipleSelectionFilter() => new MultipleSelectionFilter();
 
         protected class MultipleSelectionFilter : FillFlowContainer<MultipleSelectionFilterTabItem>

From 8bfcb89221ebd11d919cafd04b14d9cb05a8bafc Mon Sep 17 00:00:00 2001
From: Chinmay Patil <chinmaytlc@gmail.com>
Date: Thu, 4 Nov 2021 21:24:25 -0600
Subject: [PATCH 0752/5547] Fixed issue where UR counter was always invalid

---
 osu.Game/Screens/Play/HUD/UnstableRateCounter.cs | 11 ++++-------
 1 file changed, 4 insertions(+), 7 deletions(-)

diff --git a/osu.Game/Screens/Play/HUD/UnstableRateCounter.cs b/osu.Game/Screens/Play/HUD/UnstableRateCounter.cs
index c68f24c721..0045dab004 100644
--- a/osu.Game/Screens/Play/HUD/UnstableRateCounter.cs
+++ b/osu.Game/Screens/Play/HUD/UnstableRateCounter.cs
@@ -21,7 +21,6 @@ using osu.Game.Rulesets.Scoring;
 using osu.Game.Scoring;
 using osu.Game.Screens.Ranking.Statistics;
 using osu.Game.Skinning;
-using osuTK;
 
 namespace osu.Game.Screens.Play.HUD
 {
@@ -64,11 +63,11 @@ namespace osu.Game.Screens.Play.HUD
             }
         }
 
-        private bool isValid;
+        private bool isValid = false;
         private void setValid(bool valid)
         {
             if (isValid == valid) return;
-            DrawableCount.FadeTo(isValid ? 1 : alpha_when_invalid, 1000, Easing.OutQuint);
+            DrawableCount.FadeTo(valid ? 1 : alpha_when_invalid, 1000, Easing.OutQuint);
             isValid = valid;
         }
 
@@ -81,7 +80,7 @@ namespace osu.Game.Screens.Play.HUD
             updateUR();
         }
 
-        // Only populate via the score if the user has moved the current location. 
+        // Only populate via the score if the user has moved the current location.
         private void onJudgementChanged(JudgementResult judgement)
         {
             ScoreInfo currentScore = new ScoreInfo();
@@ -93,7 +92,7 @@ namespace osu.Game.Screens.Play.HUD
 
         private void updateUR()
         {
-            if (hitList.Count > 0)
+            if (hitList.Count > 1)
             {
                 double mean = hitList.Average();
                 double squares = hitList.Select(offset => Math.Pow(offset - mean, 2)).Sum();
@@ -152,7 +151,6 @@ namespace osu.Game.Screens.Play.HUD
                 InternalChild = new FillFlowContainer
                 {
                     AutoSizeAxes = Axes.Both,
-                    //Spacing = new Vector2(2),
                     Children = new Drawable[]
                     {
                         intPart = new OsuSpriteText
@@ -165,7 +163,6 @@ namespace osu.Game.Screens.Play.HUD
                         {
                             Anchor = Anchor.BottomLeft,
                             Origin = Anchor.BottomLeft,
-                            Text = @" UR",
                             Font = OsuFont.Numeric.With(size: 8, fixedWidth: true),
                             Padding = new MarginPadding { Bottom = 1.5f },
                         }

From ead64282dd75bc88bec1fe71df77c56aec5d6ee9 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 5 Nov 2021 13:38:37 +0900
Subject: [PATCH 0753/5547] Split out a couple more nested classes

---
 .../Visual/Online/TestSceneRankGraph.cs       |  8 +++----
 .../Online/TestSceneUserProfileOverlay.cs     |  4 ++--
 .../API/Requests/Responses/APIRankHistory.cs  | 16 ++++++++++++++
 .../Online/API/Requests/Responses/APIUser.cs  | 22 ++-----------------
 .../Requests/Responses/APIUserAchievement.cs  | 17 ++++++++++++++
 osu.Game/Users/UserStatistics.cs              |  3 +--
 6 files changed, 42 insertions(+), 28 deletions(-)
 create mode 100644 osu.Game/Online/API/Requests/Responses/APIRankHistory.cs
 create mode 100644 osu.Game/Online/API/Requests/Responses/APIUserAchievement.cs

diff --git a/osu.Game.Tests/Visual/Online/TestSceneRankGraph.cs b/osu.Game.Tests/Visual/Online/TestSceneRankGraph.cs
index 1f7da7ac0d..61574a7f23 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneRankGraph.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneRankGraph.cs
@@ -82,7 +82,7 @@ namespace osu.Game.Tests.Visual.Online
                 {
                     GlobalRank = 89000,
                     PP = 12345,
-                    RankHistory = new APIUser.RankHistoryData
+                    RankHistory = new APIRankHistory
                     {
                         Data = data,
                     }
@@ -95,7 +95,7 @@ namespace osu.Game.Tests.Visual.Online
                 {
                     GlobalRank = 89000,
                     PP = 12345,
-                    RankHistory = new APIUser.RankHistoryData
+                    RankHistory = new APIRankHistory
                     {
                         Data = dataWithZeros,
                     }
@@ -108,7 +108,7 @@ namespace osu.Game.Tests.Visual.Online
                 {
                     GlobalRank = 12000,
                     PP = 12345,
-                    RankHistory = new APIUser.RankHistoryData
+                    RankHistory = new APIRankHistory
                     {
                         Data = smallData,
                     }
@@ -121,7 +121,7 @@ namespace osu.Game.Tests.Visual.Online
                 {
                     GlobalRank = 12000,
                     PP = 12345,
-                    RankHistory = new APIUser.RankHistoryData
+                    RankHistory = new APIRankHistory
                     {
                         Data = edgyData,
                     }
diff --git a/osu.Game.Tests/Visual/Online/TestSceneUserProfileOverlay.cs b/osu.Game.Tests/Visual/Online/TestSceneUserProfileOverlay.cs
index 2a6f304369..a8ed2cf110 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneUserProfileOverlay.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneUserProfileOverlay.cs
@@ -42,7 +42,7 @@ namespace osu.Game.Tests.Visual.Online
                     Current = 727,
                     Progress = 69,
                 },
-                RankHistory = new APIUser.RankHistoryData
+                RankHistory = new APIRankHistory
                 {
                     Mode = @"osu",
                     Data = Enumerable.Range(2345, 45).Concat(Enumerable.Range(2109, 40)).ToArray()
@@ -59,7 +59,7 @@ namespace osu.Game.Tests.Visual.Online
             },
             Title = "osu!volunteer",
             Colour = "ff0000",
-            Achievements = Array.Empty<APIUser.UserAchievement>(),
+            Achievements = Array.Empty<APIUserAchievement>(),
         };
 
         public TestSceneUserProfileOverlay()
diff --git a/osu.Game/Online/API/Requests/Responses/APIRankHistory.cs b/osu.Game/Online/API/Requests/Responses/APIRankHistory.cs
new file mode 100644
index 0000000000..064badcccb
--- /dev/null
+++ b/osu.Game/Online/API/Requests/Responses/APIRankHistory.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 Newtonsoft.Json;
+
+namespace osu.Game.Online.API.Requests.Responses
+{
+    public class APIRankHistory
+    {
+        [JsonProperty(@"mode")]
+        public string Mode;
+
+        [JsonProperty(@"data")]
+        public int[] Data;
+    }
+}
diff --git a/osu.Game/Online/API/Requests/Responses/APIUser.cs b/osu.Game/Online/API/Requests/Responses/APIUser.cs
index aa5c556826..58f19ceaad 100644
--- a/osu.Game/Online/API/Requests/Responses/APIUser.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIUser.cs
@@ -200,34 +200,16 @@ namespace osu.Game.Online.API.Requests.Responses
         }
 
         [JsonProperty(@"rank_history")]
-        private RankHistoryData rankHistory
+        private APIRankHistory rankHistory
         {
             set => statistics.RankHistory = value;
         }
 
-        public class RankHistoryData
-        {
-            [JsonProperty(@"mode")]
-            public string Mode;
-
-            [JsonProperty(@"data")]
-            public int[] Data;
-        }
-
         [JsonProperty("badges")]
         public Badge[] Badges;
 
         [JsonProperty("user_achievements")]
-        public UserAchievement[] Achievements;
-
-        public class UserAchievement
-        {
-            [JsonProperty("achieved_at")]
-            public DateTimeOffset AchievedAt;
-
-            [JsonProperty("achievement_id")]
-            public int ID;
-        }
+        public APIUserAchievement[] Achievements;
 
         [JsonProperty("monthly_playcounts")]
         public APIUserHistoryCount[] MonthlyPlaycounts;
diff --git a/osu.Game/Online/API/Requests/Responses/APIUserAchievement.cs b/osu.Game/Online/API/Requests/Responses/APIUserAchievement.cs
new file mode 100644
index 0000000000..cfba9118c2
--- /dev/null
+++ b/osu.Game/Online/API/Requests/Responses/APIUserAchievement.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 System;
+using Newtonsoft.Json;
+
+namespace osu.Game.Online.API.Requests.Responses
+{
+    public class APIUserAchievement
+    {
+        [JsonProperty("achievement_id")]
+        public int ID;
+
+        [JsonProperty("achieved_at")]
+        public DateTimeOffset AchievedAt;
+    }
+}
diff --git a/osu.Game/Users/UserStatistics.cs b/osu.Game/Users/UserStatistics.cs
index 6acb63fdc4..c690447256 100644
--- a/osu.Game/Users/UserStatistics.cs
+++ b/osu.Game/Users/UserStatistics.cs
@@ -7,7 +7,6 @@ using osu.Framework.Localisation;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Scoring;
 using osu.Game.Utils;
-using static osu.Game.Online.API.Requests.Responses.APIUser;
 
 namespace osu.Game.Users
 {
@@ -35,7 +34,7 @@ namespace osu.Game.Users
         public int? CountryRank;
 
         // populated via User model, as that's where the data currently lives.
-        public RankHistoryData RankHistory;
+        public APIRankHistory RankHistory;
 
         [JsonProperty(@"pp")]
         public decimal? PP;

From f2700b0a6d085593981dbea89d75de44cb529a83 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 5 Nov 2021 13:38:48 +0900
Subject: [PATCH 0754/5547] Expose bot state via interface

---
 osu.Game/Models/RealmUser.cs                      | 2 ++
 osu.Game/Online/API/Requests/Responses/APIUser.cs | 2 +-
 osu.Game/Users/IUser.cs                           | 2 ++
 3 files changed, 5 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Models/RealmUser.cs b/osu.Game/Models/RealmUser.cs
index 8b050e8a93..154ece502f 100644
--- a/osu.Game/Models/RealmUser.cs
+++ b/osu.Game/Models/RealmUser.cs
@@ -11,5 +11,7 @@ namespace osu.Game.Models
         public int OnlineID { get; set; } = 1;
 
         public string Username { get; set; }
+
+        public bool IsBot => false;
     }
 }
diff --git a/osu.Game/Online/API/Requests/Responses/APIUser.cs b/osu.Game/Online/API/Requests/Responses/APIUser.cs
index 58f19ceaad..49edfd036b 100644
--- a/osu.Game/Online/API/Requests/Responses/APIUser.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIUser.cs
@@ -79,7 +79,7 @@ namespace osu.Game.Online.API.Requests.Responses
         public bool IsBNG;
 
         [JsonProperty(@"is_bot")]
-        public bool IsBot;
+        public bool IsBot { get; set; }
 
         [JsonProperty(@"is_active")]
         public bool Active;
diff --git a/osu.Game/Users/IUser.cs b/osu.Game/Users/IUser.cs
index 34a59fa214..89831e6c4d 100644
--- a/osu.Game/Users/IUser.cs
+++ b/osu.Game/Users/IUser.cs
@@ -8,5 +8,7 @@ namespace osu.Game.Users
     public interface IUser : IHasOnlineID<int>
     {
         string Username { get; set; }
+
+        bool IsBot { get; }
     }
 }

From ba74dd93b211b1bcf9f4da92feac8ab9ccfd4507 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 5 Nov 2021 13:52:42 +0900
Subject: [PATCH 0755/5547] Remove weird `fetchOnline` logic

---
 .../Online/TestSceneUserProfileOverlay.cs     | 14 ++++++-------
 osu.Game/Overlays/UserProfileOverlay.cs       | 21 ++++++++++---------
 2 files changed, 18 insertions(+), 17 deletions(-)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneUserProfileOverlay.cs b/osu.Game.Tests/Visual/Online/TestSceneUserProfileOverlay.cs
index a8ed2cf110..ce8136199f 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneUserProfileOverlay.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneUserProfileOverlay.cs
@@ -71,13 +71,13 @@ namespace osu.Game.Tests.Visual.Online
         {
             base.LoadComplete();
 
-            AddStep("Show offline dummy", () => profile.ShowUser(TEST_USER, false));
+            AddStep("Show offline dummy", () => profile.ShowUser(TEST_USER));
 
             AddStep("Show null dummy", () => profile.ShowUser(new APIUser
             {
                 Username = @"Null",
                 Id = 1,
-            }, false));
+            }));
 
             AddStep("Show ppy", () => profile.ShowUser(new APIUser
             {
@@ -86,7 +86,7 @@ namespace osu.Game.Tests.Visual.Online
                 IsSupporter = true,
                 Country = new Country { FullName = @"Australia", FlagName = @"AU" },
                 CoverUrl = @"https://osu.ppy.sh/images/headers/profile-covers/c3.jpg"
-            }, api.IsLoggedIn));
+            }));
 
             AddStep("Show flyte", () => profile.ShowUser(new APIUser
             {
@@ -94,7 +94,7 @@ namespace osu.Game.Tests.Visual.Online
                 Id = 3103765,
                 Country = new Country { FullName = @"Japan", FlagName = @"JP" },
                 CoverUrl = @"https://osu.ppy.sh/images/headers/profile-covers/c6.jpg"
-            }, api.IsLoggedIn));
+            }));
 
             AddStep("Show bancho", () => profile.ShowUser(new APIUser
             {
@@ -103,10 +103,10 @@ namespace osu.Game.Tests.Visual.Online
                 IsBot = true,
                 Country = new Country { FullName = @"Saint Helena", FlagName = @"SH" },
                 CoverUrl = @"https://osu.ppy.sh/images/headers/profile-covers/c4.jpg"
-            }, api.IsLoggedIn));
+            }));
 
-            AddStep("Show ppy from username", () => profile.ShowUser(@"peppy"));
-            AddStep("Show flyte from username", () => profile.ShowUser(@"flyte"));
+            AddStep("Show ppy from username", () => profile.ShowUser(new APIUser { Username = @"peppy" }));
+            AddStep("Show flyte from username", () => profile.ShowUser(new APIUser { Username = @"flyte" }));
 
             AddStep("Hide", profile.Hide);
             AddStep("Show without reload", profile.Show);
diff --git a/osu.Game/Overlays/UserProfileOverlay.cs b/osu.Game/Overlays/UserProfileOverlay.cs
index d9b4e68a75..a187cc6e77 100644
--- a/osu.Game/Overlays/UserProfileOverlay.cs
+++ b/osu.Game/Overlays/UserProfileOverlay.cs
@@ -42,7 +42,7 @@ namespace osu.Game.Overlays
 
         public void ShowUser(string username) => ShowUser(new APIUser { Username = username });
 
-        public void ShowUser(APIUser user, bool fetchOnline = true)
+        public void ShowUser(IUser user)
         {
             if (user == APIUser.SYSTEM_USER)
                 return;
@@ -116,19 +116,20 @@ namespace osu.Game.Overlays
                 }
             };
 
-            if (fetchOnline)
-            {
-                userReq = user.Id > 1 ? new GetUserRequest(user.Id) : new GetUserRequest(user.Username);
-                userReq.Success += userLoadComplete;
-                API.Queue(userReq);
-            }
-            else
+            sectionsContainer.ScrollToTop();
+
+            // Check arbitrarily whether this user has already been populated.
+            // This is only generally used by tests, but should be quite safe unless we want to force a refresh on loading a previous user in the future.
+            if (user is APIUser apiUser && apiUser.JoinDate != default)
             {
                 userReq = null;
-                userLoadComplete(user);
+                userLoadComplete(apiUser);
+                return;
             }
 
-            sectionsContainer.ScrollToTop();
+            userReq = user.OnlineID > 1 ? new GetUserRequest(user.OnlineID) : new GetUserRequest(user.Username);
+            userReq.Success += userLoadComplete;
+            API.Queue(userReq);
         }
 
         private void userLoadComplete(APIUser user)

From b1f1cc0bf3a5120a033f5a9ff17b2bf6438be6e0 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 5 Nov 2021 13:53:00 +0900
Subject: [PATCH 0756/5547] Perform all user profile displays using an `IUser`
 interface

---
 osu.Game/OsuGame.cs                         | 19 +++++++------------
 osu.Game/Overlays/UserProfileOverlay.cs     |  7 ++-----
 osu.Game/Users/Drawables/ClickableAvatar.cs |  2 +-
 3 files changed, 10 insertions(+), 18 deletions(-)

diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index a7ed7fedf5..ea8682e696 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -53,8 +53,10 @@ using osu.Game.Database;
 using osu.Game.Extensions;
 using osu.Game.IO;
 using osu.Game.Localisation;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Performance;
 using osu.Game.Skinning.Editor;
+using osu.Game.Users;
 
 namespace osu.Game
 {
@@ -323,10 +325,9 @@ namespace osu.Game
                     break;
 
                 case LinkAction.OpenUserProfile:
-                    if (int.TryParse(link.Argument, out int userId))
-                        ShowUser(userId);
-                    else
-                        ShowUser(link.Argument);
+                    ShowUser(int.TryParse(link.Argument, out int userId)
+                        ? new APIUser { Id = userId }
+                        : new APIUser { Username = link.Argument });
 
                     break;
 
@@ -383,14 +384,8 @@ namespace osu.Game
         /// <summary>
         /// Show a user's profile as an overlay.
         /// </summary>
-        /// <param name="userId">The user to display.</param>
-        public void ShowUser(int userId) => waitForReady(() => userProfile, _ => userProfile.ShowUser(userId));
-
-        /// <summary>
-        /// Show a user's profile as an overlay.
-        /// </summary>
-        /// <param name="username">The user to display.</param>
-        public void ShowUser(string username) => waitForReady(() => userProfile, _ => userProfile.ShowUser(username));
+        /// <param name="user">The user to display.</param>
+        public void ShowUser(IUser user) => waitForReady(() => userProfile, _ => userProfile.ShowUser(user));
 
         /// <summary>
         /// Show a beatmap's set as an overlay, displaying the given beatmap.
diff --git a/osu.Game/Overlays/UserProfileOverlay.cs b/osu.Game/Overlays/UserProfileOverlay.cs
index a187cc6e77..9fac1463f2 100644
--- a/osu.Game/Overlays/UserProfileOverlay.cs
+++ b/osu.Game/Overlays/UserProfileOverlay.cs
@@ -14,6 +14,7 @@ using osu.Game.Online.API.Requests;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays.Profile;
 using osu.Game.Overlays.Profile.Sections;
+using osu.Game.Users;
 using osuTK;
 using osuTK.Graphics;
 
@@ -38,10 +39,6 @@ namespace osu.Game.Overlays
 
         protected override Color4 BackgroundColour => ColourProvider.Background6;
 
-        public void ShowUser(int userId) => ShowUser(new APIUser { Id = userId });
-
-        public void ShowUser(string username) => ShowUser(new APIUser { Username = username });
-
         public void ShowUser(IUser user)
         {
             if (user == APIUser.SYSTEM_USER)
@@ -49,7 +46,7 @@ namespace osu.Game.Overlays
 
             Show();
 
-            if (user.Id == Header?.User.Value?.Id)
+            if (user.OnlineID == Header?.User.Value?.Id)
                 return;
 
             if (sectionsContainer != null)
diff --git a/osu.Game/Users/Drawables/ClickableAvatar.cs b/osu.Game/Users/Drawables/ClickableAvatar.cs
index 6883cc0e62..2825c41ef6 100644
--- a/osu.Game/Users/Drawables/ClickableAvatar.cs
+++ b/osu.Game/Users/Drawables/ClickableAvatar.cs
@@ -66,7 +66,7 @@ namespace osu.Game.Users.Drawables
         private void openProfile()
         {
             if (user?.Id > 1)
-                game?.ShowUser(user.Id);
+                game?.ShowUser(user);
         }
 
         private class ClickableArea : OsuClickableContainer

From 9f9ef570ee86edcf32a6af143a2a1f15e1e838e2 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 5 Nov 2021 14:40:22 +0900
Subject: [PATCH 0757/5547] Also propagate `Status` in temporary `BeatmapInfo`
 usage

---
 .../Overlays/BeatmapSet/Scores/ScoresContainer.cs   | 13 +++++++++++--
 1 file changed, 11 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.cs b/osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.cs
index 3891d68d35..69739b3352 100644
--- a/osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.cs
+++ b/osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.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.Diagnostics;
 using System.Linq;
 using System.Threading;
 using System.Threading.Tasks;
@@ -66,8 +67,16 @@ namespace osu.Game.Overlays.BeatmapSet.Scores
                 if (value?.Scores.Any() != true)
                     return;
 
+                var apiBeatmap = Beatmap.Value;
+
+                Debug.Assert(apiBeatmap != null);
+
                 // TODO: temporary. should be removed once `OrderByTotalScore` can accept `IScoreInfo`.
-                var beatmapInfo = new BeatmapInfo { MaxCombo = Beatmap.Value.MaxCombo };
+                var beatmapInfo = new BeatmapInfo
+                {
+                    MaxCombo = apiBeatmap.MaxCombo,
+                    Status = apiBeatmap.Status
+                };
 
                 scoreManager.OrderByTotalScoreAsync(value.Scores.Select(s => s.CreateScoreInfo(rulesets, beatmapInfo)).ToArray(), loadCancellationSource.Token)
                             .ContinueWith(ordered => Schedule(() =>
@@ -77,7 +86,7 @@ namespace osu.Game.Overlays.BeatmapSet.Scores
 
                                 var topScore = ordered.Result.First();
 
-                                scoreTable.DisplayScores(ordered.Result, topScore.BeatmapInfo?.Status.GrantsPerformancePoints() == true);
+                                scoreTable.DisplayScores(ordered.Result, apiBeatmap.Status.GrantsPerformancePoints());
                                 scoreTable.Show();
 
                                 var userScore = value.UserScore;

From b7239757670ee73f41cf797df4d910a6ab9b9e93 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 5 Nov 2021 09:10:38 +0300
Subject: [PATCH 0758/5547] Replace pragma with `add/remove => throw`

---
 .../NonVisual/FirstAvailableHitWindowsTest.cs     | 15 +++++++++++----
 .../Visual/Gameplay/TestSceneHitErrorMeter.cs     | 15 +++++++++++----
 2 files changed, 22 insertions(+), 8 deletions(-)

diff --git a/osu.Game.Tests/NonVisual/FirstAvailableHitWindowsTest.cs b/osu.Game.Tests/NonVisual/FirstAvailableHitWindowsTest.cs
index 8d83fe7452..8386a10ebb 100644
--- a/osu.Game.Tests/NonVisual/FirstAvailableHitWindowsTest.cs
+++ b/osu.Game.Tests/NonVisual/FirstAvailableHitWindowsTest.cs
@@ -79,10 +79,17 @@ namespace osu.Game.Tests.NonVisual
             public List<HitObject> HitObjects;
             public override IEnumerable<HitObject> Objects => HitObjects;
 
-#pragma warning disable 67
-            public override event Action<JudgementResult> NewResult;
-            public override event Action<JudgementResult> RevertResult;
-#pragma warning restore 67
+            public override event Action<JudgementResult> NewResult
+            {
+                add => throw new InvalidOperationException();
+                remove => throw new InvalidOperationException();
+            }
+
+            public override event Action<JudgementResult> RevertResult
+            {
+                add => throw new InvalidOperationException();
+                remove => throw new InvalidOperationException();
+            }
 
             public override Playfield Playfield { get; }
             public override Container Overlays { get; }
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneHitErrorMeter.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneHitErrorMeter.cs
index aa29f1386c..c1260f0231 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneHitErrorMeter.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneHitErrorMeter.cs
@@ -235,10 +235,17 @@ namespace osu.Game.Tests.Visual.Gameplay
 
             public override IEnumerable<HitObject> Objects => new[] { new HitCircle { HitWindows = HitWindows } };
 
-#pragma warning disable 67
-            public override event Action<JudgementResult> NewResult;
-            public override event Action<JudgementResult> RevertResult;
-#pragma warning restore 67
+            public override event Action<JudgementResult> NewResult
+            {
+                add => throw new InvalidOperationException();
+                remove => throw new InvalidOperationException();
+            }
+
+            public override event Action<JudgementResult> RevertResult
+            {
+                add => throw new InvalidOperationException();
+                remove => throw new InvalidOperationException();
+            }
 
             public override Playfield Playfield { get; }
             public override Container Overlays { get; }

From 3a3ec1436b8a35323d6b731f3c6575214ffb8557 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 5 Nov 2021 09:14:50 +0300
Subject: [PATCH 0759/5547] Re-enable possible null refernece exception
 inspections and move code

---
 .../Overlays/Changelog/ChangelogHeader.cs     | 53 ++++++++++---------
 osu.Game/Overlays/Comments/CommentEditor.cs   | 12 +++--
 2 files changed, 35 insertions(+), 30 deletions(-)

diff --git a/osu.Game/Overlays/Changelog/ChangelogHeader.cs b/osu.Game/Overlays/Changelog/ChangelogHeader.cs
index 69a8cb2ce0..1b120ef57c 100644
--- a/osu.Game/Overlays/Changelog/ChangelogHeader.cs
+++ b/osu.Game/Overlays/Changelog/ChangelogHeader.cs
@@ -38,14 +38,6 @@ namespace osu.Game.Overlays.Changelog
             };
 
             Build.ValueChanged += showBuild;
-
-            // ReSharper disable once PossibleNullReferenceException
-            // see https://youtrack.jetbrains.com/issue/RSRP-486768
-            Streams.Current.ValueChanged += e =>
-            {
-                if (e.NewValue?.LatestBuild != null && !e.NewValue.Equals(Build.Value?.UpdateStream))
-                    Build.Value = e.NewValue.LatestBuild;
-            };
         }
 
         [BackgroundDependencyLoader]
@@ -75,29 +67,40 @@ namespace osu.Game.Overlays.Changelog
 
         protected override Drawable CreateBackground() => new OverlayHeaderBackground(@"Headers/changelog");
 
-        protected override Drawable CreateContent() => new Container
+        protected override Drawable CreateContent()
         {
-            RelativeSizeAxes = Axes.X,
-            AutoSizeAxes = Axes.Y,
-            Children = new Drawable[]
+            var content = new Container
             {
-                streamsBackground = new Box
+                RelativeSizeAxes = Axes.X,
+                AutoSizeAxes = Axes.Y,
+                Children = new Drawable[]
                 {
-                    RelativeSizeAxes = Axes.Both
-                },
-                new Container
-                {
-                    RelativeSizeAxes = Axes.X,
-                    AutoSizeAxes = Axes.Y,
-                    Padding = new MarginPadding
+                    streamsBackground = new Box
                     {
-                        Horizontal = 65,
-                        Vertical = 20
+                        RelativeSizeAxes = Axes.Both
                     },
-                    Child = Streams = new ChangelogUpdateStreamControl()
+                    new Container
+                    {
+                        RelativeSizeAxes = Axes.X,
+                        AutoSizeAxes = Axes.Y,
+                        Padding = new MarginPadding
+                        {
+                            Horizontal = 65,
+                            Vertical = 20
+                        },
+                        Child = Streams = new ChangelogUpdateStreamControl()
+                    }
                 }
-            }
-        };
+            };
+
+            Streams.Current.ValueChanged += e =>
+            {
+                if (e.NewValue?.LatestBuild != null && !e.NewValue.Equals(Build.Value?.UpdateStream))
+                    Build.Value = e.NewValue.LatestBuild;
+            };
+
+            return content;
+        }
 
         protected override OverlayTitle CreateTitle() => new ChangelogHeaderTitle();
 
diff --git a/osu.Game/Overlays/Comments/CommentEditor.cs b/osu.Game/Overlays/Comments/CommentEditor.cs
index 1f3931901c..1847de8660 100644
--- a/osu.Game/Overlays/Comments/CommentEditor.cs
+++ b/osu.Game/Overlays/Comments/CommentEditor.cs
@@ -175,6 +175,8 @@ namespace osu.Game.Overlays.Comments
 
             protected override IEnumerable<Drawable> EffectTargets => new[] { background };
 
+            private readonly string text;
+
             [Resolved]
             private OverlayColourProvider colourProvider { get; set; }
 
@@ -184,12 +186,10 @@ namespace osu.Game.Overlays.Comments
 
             public CommitButton(string text)
             {
+                this.text = text;
+
                 AutoSizeAxes = Axes.Both;
                 LoadingAnimationSize = new Vector2(10);
-
-                // ReSharper disable once PossibleNullReferenceException
-                // see https://youtrack.jetbrains.com/issue/RSRP-486768
-                drawableText.Text = text;
             }
 
             [BackgroundDependencyLoader]
@@ -198,6 +198,8 @@ namespace osu.Game.Overlays.Comments
                 IdleColour = colourProvider.Light4;
                 HoverColour = colourProvider.Light3;
                 blockedBackground.Colour = colourProvider.Background5;
+
+                drawableText.Text = text;
             }
 
             protected override void LoadComplete()
@@ -234,7 +236,7 @@ namespace osu.Game.Overlays.Comments
                         Anchor = Anchor.Centre,
                         Origin = Anchor.Centre,
                         Font = OsuFont.GetFont(size: 12, weight: FontWeight.Bold),
-                        Margin = new MarginPadding { Horizontal = 20 }
+                        Margin = new MarginPadding { Horizontal = 20 },
                     }
                 }
             };

From 6399c695e8809a0a8e27931b6eee8b85a06e7761 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 5 Nov 2021 15:54:27 +0900
Subject: [PATCH 0760/5547] Update usages of `BufferedContainer` in line with
 framework changes

---
 .../Skinning/Default/DefaultBodyPiece.cs                    | 6 ++----
 osu.Game.Rulesets.Osu/Statistics/AccuracyHeatmap.cs         | 3 +--
 osu.Game/Graphics/Backgrounds/Background.cs                 | 3 +--
 osu.Game/Graphics/Sprites/GlowingSpriteText.cs              | 3 +--
 osu.Game/Overlays/NowPlayingOverlay.cs                      | 3 +--
 osu.Game/Screens/Menu/IntroTriangles.cs                     | 2 +-
 osu.Game/Screens/Play/Break/BlurredIcon.cs                  | 2 +-
 osu.Game/Screens/Play/SquareGraph.cs                        | 3 +--
 osu.Game/Screens/Ranking/Expanded/Accuracy/RankText.cs      | 6 ++----
 osu.Game/Screens/Select/BeatmapInfoWedgeBackground.cs       | 3 +--
 osu.Game/Screens/Select/Carousel/SetPanelBackground.cs      | 2 +-
 11 files changed, 13 insertions(+), 23 deletions(-)

diff --git a/osu.Game.Rulesets.Mania/Skinning/Default/DefaultBodyPiece.cs b/osu.Game.Rulesets.Mania/Skinning/Default/DefaultBodyPiece.cs
index db1ac6da88..7138421b91 100644
--- a/osu.Game.Rulesets.Mania/Skinning/Default/DefaultBodyPiece.cs
+++ b/osu.Game.Rulesets.Mania/Skinning/Default/DefaultBodyPiece.cs
@@ -86,20 +86,18 @@ namespace osu.Game.Rulesets.Mania.Skinning.Default
             [BackgroundDependencyLoader]
             private void load()
             {
-                InternalChild = foregroundBuffer = new BufferedContainer
+                InternalChild = foregroundBuffer = new BufferedContainer(cachedFrameBuffer: true)
                 {
                     Blending = BlendingParameters.Additive,
                     RelativeSizeAxes = Axes.Both,
-                    CacheDrawnFrameBuffer = true,
                     Children = new Drawable[]
                     {
                         new Box { RelativeSizeAxes = Axes.Both },
-                        subtractionBuffer = new BufferedContainer
+                        subtractionBuffer = new BufferedContainer(cachedFrameBuffer: true)
                         {
                             RelativeSizeAxes = Axes.Both,
                             // This is needed because we're blending with another object
                             BackgroundColour = Color4.White.Opacity(0),
-                            CacheDrawnFrameBuffer = true,
                             // The 'hole' is achieved by subtracting the result of this container with the parent
                             Blending = new BlendingParameters { AlphaEquation = BlendingEquation.ReverseSubtract },
                             Child = subtractionLayer = new CircularContainer
diff --git a/osu.Game.Rulesets.Osu/Statistics/AccuracyHeatmap.cs b/osu.Game.Rulesets.Osu/Statistics/AccuracyHeatmap.cs
index 3c2077b3c8..db4a6eb50b 100644
--- a/osu.Game.Rulesets.Osu/Statistics/AccuracyHeatmap.cs
+++ b/osu.Game.Rulesets.Osu/Statistics/AccuracyHeatmap.cs
@@ -136,10 +136,9 @@ namespace osu.Game.Rulesets.Osu.Statistics
                             }
                         }
                     },
-                    bufferedGrid = new BufferedContainer
+                    bufferedGrid = new BufferedContainer(cachedFrameBuffer: true)
                     {
                         RelativeSizeAxes = Axes.Both,
-                        CacheDrawnFrameBuffer = true,
                         BackgroundColour = Color4Extensions.FromHex("#202624").Opacity(0),
                         Child = pointGrid = new GridContainer
                         {
diff --git a/osu.Game/Graphics/Backgrounds/Background.cs b/osu.Game/Graphics/Backgrounds/Background.cs
index cfc1eb1806..353054a1f1 100644
--- a/osu.Game/Graphics/Backgrounds/Background.cs
+++ b/osu.Game/Graphics/Backgrounds/Background.cs
@@ -58,10 +58,9 @@ namespace osu.Game.Graphics.Backgrounds
             {
                 RemoveInternal(Sprite);
 
-                AddInternal(bufferedContainer = new BufferedContainer
+                AddInternal(bufferedContainer = new BufferedContainer(cachedFrameBuffer: true)
                 {
                     RelativeSizeAxes = Axes.Both,
-                    CacheDrawnFrameBuffer = true,
                     RedrawOnScale = false,
                     Child = Sprite
                 });
diff --git a/osu.Game/Graphics/Sprites/GlowingSpriteText.cs b/osu.Game/Graphics/Sprites/GlowingSpriteText.cs
index fb273d7293..9c43383a29 100644
--- a/osu.Game/Graphics/Sprites/GlowingSpriteText.cs
+++ b/osu.Game/Graphics/Sprites/GlowingSpriteText.cs
@@ -69,12 +69,11 @@ namespace osu.Game.Graphics.Sprites
 
             Children = new Drawable[]
             {
-                new BufferedContainer
+                new BufferedContainer(cachedFrameBuffer: true)
                 {
                     Anchor = Anchor.Centre,
                     Origin = Anchor.Centre,
                     BlurSigma = new Vector2(4),
-                    CacheDrawnFrameBuffer = true,
                     RedrawOnScale = false,
                     RelativeSizeAxes = Axes.Both,
                     Blending = BlendingParameters.Additive,
diff --git a/osu.Game/Overlays/NowPlayingOverlay.cs b/osu.Game/Overlays/NowPlayingOverlay.cs
index 5619d7b38a..f37e6bedf7 100644
--- a/osu.Game/Overlays/NowPlayingOverlay.cs
+++ b/osu.Game/Overlays/NowPlayingOverlay.cs
@@ -366,14 +366,13 @@ namespace osu.Game.Overlays
             private readonly WorkingBeatmap beatmap;
 
             public Background(WorkingBeatmap beatmap = null)
+                : base(cachedFrameBuffer: true)
             {
                 this.beatmap = beatmap;
 
                 Depth = float.MaxValue;
                 RelativeSizeAxes = Axes.Both;
 
-                CacheDrawnFrameBuffer = true;
-
                 Children = new Drawable[]
                 {
                     sprite = new Sprite
diff --git a/osu.Game/Screens/Menu/IntroTriangles.cs b/osu.Game/Screens/Menu/IntroTriangles.cs
index 48ced63182..d171e481b1 100644
--- a/osu.Game/Screens/Menu/IntroTriangles.cs
+++ b/osu.Game/Screens/Menu/IntroTriangles.cs
@@ -393,6 +393,7 @@ namespace osu.Game.Screens.Menu
                 public class OutlineTriangle : BufferedContainer
                 {
                     public OutlineTriangle(bool outlineOnly, float size)
+                        : base(cachedFrameBuffer: true)
                     {
                         Size = new Vector2(size);
 
@@ -414,7 +415,6 @@ namespace osu.Game.Screens.Menu
                         }
 
                         Blending = BlendingParameters.Additive;
-                        CacheDrawnFrameBuffer = true;
                     }
                 }
             }
diff --git a/osu.Game/Screens/Play/Break/BlurredIcon.cs b/osu.Game/Screens/Play/Break/BlurredIcon.cs
index a88112a0db..1e974ec916 100644
--- a/osu.Game/Screens/Play/Break/BlurredIcon.cs
+++ b/osu.Game/Screens/Play/Break/BlurredIcon.cs
@@ -32,9 +32,9 @@ namespace osu.Game.Screens.Play.Break
         }
 
         public BlurredIcon()
+            : base(cachedFrameBuffer: true)
         {
             RelativePositionAxes = Axes.X;
-            CacheDrawnFrameBuffer = true;
             Child = icon = new SpriteIcon
             {
                 Origin = Anchor.Centre,
diff --git a/osu.Game/Screens/Play/SquareGraph.cs b/osu.Game/Screens/Play/SquareGraph.cs
index 67abcb66e6..a7d4454701 100644
--- a/osu.Game/Screens/Play/SquareGraph.cs
+++ b/osu.Game/Screens/Play/SquareGraph.cs
@@ -98,9 +98,8 @@ namespace osu.Game.Screens.Play
         /// </summary>
         protected virtual void RecreateGraph()
         {
-            var newColumns = new BufferedContainer<Column>
+            var newColumns = new BufferedContainer<Column>(cachedFrameBuffer: true)
             {
-                CacheDrawnFrameBuffer = true,
                 RedrawOnScale = false,
                 RelativeSizeAxes = Axes.Both,
             };
diff --git a/osu.Game/Screens/Ranking/Expanded/Accuracy/RankText.cs b/osu.Game/Screens/Ranking/Expanded/Accuracy/RankText.cs
index cc732382f4..5aea0184ee 100644
--- a/osu.Game/Screens/Ranking/Expanded/Accuracy/RankText.cs
+++ b/osu.Game/Screens/Ranking/Expanded/Accuracy/RankText.cs
@@ -51,13 +51,12 @@ namespace osu.Game.Screens.Ranking.Expanded.Accuracy
                     Font = OsuFont.Numeric.With(size: 76),
                     UseFullGlyphHeight = false
                 },
-                superFlash = new BufferedContainer
+                superFlash = new BufferedContainer(cachedFrameBuffer: true)
                 {
                     Anchor = Anchor.Centre,
                     Origin = Anchor.Centre,
                     BlurSigma = new Vector2(85),
                     Size = new Vector2(600),
-                    CacheDrawnFrameBuffer = true,
                     Blending = BlendingParameters.Additive,
                     Alpha = 0,
                     Children = new[]
@@ -71,14 +70,13 @@ namespace osu.Game.Screens.Ranking.Expanded.Accuracy
                         },
                     },
                 },
-                flash = new BufferedContainer
+                flash = new BufferedContainer(cachedFrameBuffer: true)
                 {
                     Anchor = Anchor.Centre,
                     Origin = Anchor.Centre,
                     BlurSigma = new Vector2(35),
                     BypassAutoSizeAxes = Axes.Both,
                     Size = new Vector2(200),
-                    CacheDrawnFrameBuffer = true,
                     Blending = BlendingParameters.Additive,
                     Alpha = 0,
                     Scale = new Vector2(1.8f),
diff --git a/osu.Game/Screens/Select/BeatmapInfoWedgeBackground.cs b/osu.Game/Screens/Select/BeatmapInfoWedgeBackground.cs
index f50fb4dc8a..25056790cc 100644
--- a/osu.Game/Screens/Select/BeatmapInfoWedgeBackground.cs
+++ b/osu.Game/Screens/Select/BeatmapInfoWedgeBackground.cs
@@ -27,9 +27,8 @@ namespace osu.Game.Screens.Select
         {
             RelativeSizeAxes = Axes.Both;
 
-            InternalChild = new BufferedContainer
+            InternalChild = new BufferedContainer(cachedFrameBuffer: true)
             {
-                CacheDrawnFrameBuffer = true,
                 RelativeSizeAxes = Axes.Both,
                 Children = new Drawable[]
                 {
diff --git a/osu.Game/Screens/Select/Carousel/SetPanelBackground.cs b/osu.Game/Screens/Select/Carousel/SetPanelBackground.cs
index 25139b27db..b4279cce51 100644
--- a/osu.Game/Screens/Select/Carousel/SetPanelBackground.cs
+++ b/osu.Game/Screens/Select/Carousel/SetPanelBackground.cs
@@ -15,8 +15,8 @@ namespace osu.Game.Screens.Select.Carousel
     public class SetPanelBackground : BufferedContainer
     {
         public SetPanelBackground(WorkingBeatmap working)
+            : base(cachedFrameBuffer: true)
         {
-            CacheDrawnFrameBuffer = true;
             RedrawOnScale = false;
 
             Children = new Drawable[]

From 7bbb2a7a674518eb77d19de3b42b5454f5072a31 Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Fri, 5 Nov 2021 15:57:32 +0900
Subject: [PATCH 0761/5547] Fix post-merge issues

---
 .../Multiplayer/QueueingModes/TestSceneHostOnlyQueueMode.cs     | 2 +-
 osu.Game/Online/Multiplayer/MultiplayerClient.cs                | 1 -
 2 files changed, 1 insertion(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/QueueingModes/TestSceneHostOnlyQueueMode.cs b/osu.Game.Tests/Visual/Multiplayer/QueueingModes/TestSceneHostOnlyQueueMode.cs
index c71a36f1a4..fb11416140 100644
--- a/osu.Game.Tests/Visual/Multiplayer/QueueingModes/TestSceneHostOnlyQueueMode.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/QueueingModes/TestSceneHostOnlyQueueMode.cs
@@ -54,7 +54,7 @@ namespace osu.Game.Tests.Visual.Multiplayer.QueueingModes
         {
             RunGameplay();
 
-            BeatmapInfo firstBeatmap = null;
+            IBeatmapInfo firstBeatmap = null;
             AddStep("get first playlist item beatmap", () => firstBeatmap = Client.APIRoom?.Playlist[0].Beatmap.Value);
 
             selectNewItem(() => OtherBeatmap);
diff --git a/osu.Game/Online/Multiplayer/MultiplayerClient.cs b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
index a058420f78..0e0f978a30 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
@@ -13,7 +13,6 @@ using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Logging;
-using osu.Game.Beatmaps;
 using osu.Game.Database;
 using osu.Game.Online.API;
 using osu.Game.Online.Multiplayer.Queueing;

From f013a1e37fd8f9184bbaa6e6c13841d611aa06e7 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 5 Nov 2021 10:12:41 +0300
Subject: [PATCH 0762/5547] Move `CreateContent()` to BDL

---
 .../Graphics/UserInterface/LoadingButton.cs   | 40 ++++++++++++-------
 osu.Game/Overlays/Comments/CommentEditor.cs   |  3 +-
 2 files changed, 27 insertions(+), 16 deletions(-)

diff --git a/osu.Game/Graphics/UserInterface/LoadingButton.cs b/osu.Game/Graphics/UserInterface/LoadingButton.cs
index 81dc023d7e..a75cf0639c 100644
--- a/osu.Game/Graphics/UserInterface/LoadingButton.cs
+++ b/osu.Game/Graphics/UserInterface/LoadingButton.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 osu.Framework.Allocation;
 using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
 using osu.Framework.Input.Events;
 using osu.Game.Graphics.Containers;
 using osuTK;
@@ -22,15 +24,9 @@ namespace osu.Game.Graphics.UserInterface
                 Enabled.Value = !isLoading;
 
                 if (value)
-                {
                     loading.Show();
-                    OnLoadStarted();
-                }
                 else
-                {
                     loading.Hide();
-                    OnLoadFinished();
-                }
             }
         }
 
@@ -44,18 +40,34 @@ namespace osu.Game.Graphics.UserInterface
 
         protected LoadingButton()
         {
-            AddRange(new[]
+            Add(loading = new LoadingSpinner
             {
-                CreateContent(),
-                loading = new LoadingSpinner
-                {
-                    Anchor = Anchor.Centre,
-                    Origin = Anchor.Centre,
-                    Size = new Vector2(12)
-                }
+                Anchor = Anchor.Centre,
+                Origin = Anchor.Centre,
+                Size = new Vector2(12),
+                Depth = -1,
             });
         }
 
+        [BackgroundDependencyLoader]
+        private void load()
+        {
+            Add(CreateContent());
+        }
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            loading.State.BindValueChanged(s =>
+            {
+                if (s.NewValue == Visibility.Visible)
+                    OnLoadStarted();
+                else
+                    OnLoadFinished();
+            }, true);
+        }
+
         protected override bool OnClick(ClickEvent e)
         {
             if (!Enabled.Value)
diff --git a/osu.Game/Overlays/Comments/CommentEditor.cs b/osu.Game/Overlays/Comments/CommentEditor.cs
index 1847de8660..3ff4cfad4a 100644
--- a/osu.Game/Overlays/Comments/CommentEditor.cs
+++ b/osu.Game/Overlays/Comments/CommentEditor.cs
@@ -198,8 +198,6 @@ namespace osu.Game.Overlays.Comments
                 IdleColour = colourProvider.Light4;
                 HoverColour = colourProvider.Light3;
                 blockedBackground.Colour = colourProvider.Background5;
-
-                drawableText.Text = text;
             }
 
             protected override void LoadComplete()
@@ -237,6 +235,7 @@ namespace osu.Game.Overlays.Comments
                         Origin = Anchor.Centre,
                         Font = OsuFont.GetFont(size: 12, weight: FontWeight.Bold),
                         Margin = new MarginPadding { Horizontal = 20 },
+                        Text = text,
                     }
                 }
             };

From b90f44493ca2cedbe985b72ec56d738e3d069307 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 5 Nov 2021 16:27:13 +0900
Subject: [PATCH 0763/5547] Remove importer inheritance from `IModelManager`

Now only exists in legacy implementations, to reduce inheritance
complexity of interfaces which are going to be used going forwards.
---
 osu.Game/Beatmaps/BeatmapManager.cs      | 2 +-
 osu.Game/Database/ArchiveModelManager.cs | 2 +-
 osu.Game/Database/IModelManager.cs       | 2 +-
 osu.Game/Scoring/ScoreManager.cs         | 2 +-
 4 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index 7a9f3e0a45..c68088a5e2 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -29,7 +29,7 @@ namespace osu.Game.Beatmaps
     /// Handles general operations related to global beatmap management.
     /// </summary>
     [ExcludeFromDynamicCompile]
-    public class BeatmapManager : IModelDownloader<BeatmapSetInfo>, IModelManager<BeatmapSetInfo>, IModelFileManager<BeatmapSetInfo, BeatmapSetFileInfo>, IWorkingBeatmapCache, IDisposable
+    public class BeatmapManager : IModelDownloader<BeatmapSetInfo>, IModelManager<BeatmapSetInfo>, IModelFileManager<BeatmapSetInfo, BeatmapSetFileInfo>, IModelImporter<BeatmapSetInfo>, IWorkingBeatmapCache, IDisposable
     {
         private readonly BeatmapModelManager beatmapModelManager;
         private readonly BeatmapModelDownloader beatmapModelDownloader;
diff --git a/osu.Game/Database/ArchiveModelManager.cs b/osu.Game/Database/ArchiveModelManager.cs
index 4e40e52051..d2f9ee1dc1 100644
--- a/osu.Game/Database/ArchiveModelManager.cs
+++ b/osu.Game/Database/ArchiveModelManager.cs
@@ -30,7 +30,7 @@ namespace osu.Game.Database
     /// </summary>
     /// <typeparam name="TModel">The model type.</typeparam>
     /// <typeparam name="TFileModel">The associated file join type.</typeparam>
-    public abstract class ArchiveModelManager<TModel, TFileModel> : IModelManager<TModel>, IModelFileManager<TModel, TFileModel>
+    public abstract class ArchiveModelManager<TModel, TFileModel> : IModelImporter<TModel>, IModelManager<TModel>, IModelFileManager<TModel, TFileModel>
         where TModel : class, IHasFiles<TFileModel>, IHasPrimaryKey, ISoftDelete
         where TFileModel : class, INamedFileInfo, IHasPrimaryKey, new()
     {
diff --git a/osu.Game/Database/IModelManager.cs b/osu.Game/Database/IModelManager.cs
index f5e401cdfb..0be927322d 100644
--- a/osu.Game/Database/IModelManager.cs
+++ b/osu.Game/Database/IModelManager.cs
@@ -14,7 +14,7 @@ namespace osu.Game.Database
     /// Represents a model manager that publishes events when <typeparamref name="TModel"/>s are added or removed.
     /// </summary>
     /// <typeparam name="TModel">The model type.</typeparam>
-    public interface IModelManager<TModel> : IModelImporter<TModel>
+    public interface IModelManager<TModel>
         where TModel : class
     {
         /// <summary>
diff --git a/osu.Game/Scoring/ScoreManager.cs b/osu.Game/Scoring/ScoreManager.cs
index 253591eb56..380d2590bf 100644
--- a/osu.Game/Scoring/ScoreManager.cs
+++ b/osu.Game/Scoring/ScoreManager.cs
@@ -25,7 +25,7 @@ using osu.Game.Rulesets.Scoring;
 
 namespace osu.Game.Scoring
 {
-    public class ScoreManager : IModelManager<ScoreInfo>, IModelFileManager<ScoreInfo, ScoreFileInfo>, IModelDownloader<ScoreInfo>
+    public class ScoreManager : IModelManager<ScoreInfo>, IModelImporter<ScoreInfo>, IModelFileManager<ScoreInfo, ScoreFileInfo>, IModelDownloader<ScoreInfo>
     {
         private readonly Scheduler scheduler;
         private readonly Func<BeatmapDifficultyCache> difficulties;

From 1fe9bca819bd4e7ee984c8756b7bc253e17a3098 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 5 Nov 2021 16:46:40 +0900
Subject: [PATCH 0764/5547] Change `ModelDownloader`'s requirement to an
 `IModelImporter` rather than `IModelManager`

---
 .../TestSceneOnlinePlayBeatmapAvailabilityTracker.cs   |  6 +++---
 osu.Game/Beatmaps/BeatmapManager.cs                    |  2 +-
 osu.Game/Beatmaps/BeatmapModelDownloader.cs            |  4 ++--
 osu.Game/Database/ModelDownloader.cs                   | 10 +++++-----
 osu.Game/Scoring/ScoreModelDownloader.cs               |  2 +-
 5 files changed, 12 insertions(+), 12 deletions(-)

diff --git a/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs b/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
index 5e7ce3abf5..70e62cc087 100644
--- a/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
+++ b/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
@@ -168,15 +168,15 @@ namespace osu.Game.Tests.Online
                 return new TestBeatmapModelManager(this, storage, contextFactory, rulesets, api, host);
             }
 
-            protected override BeatmapModelDownloader CreateBeatmapModelDownloader(IBeatmapModelManager manager, IAPIProvider api, GameHost host)
+            protected override BeatmapModelDownloader CreateBeatmapModelDownloader(IModelImporter<BeatmapSetInfo> manager, IAPIProvider api, GameHost host)
             {
                 return new TestBeatmapModelDownloader(manager, api, host);
             }
 
             internal class TestBeatmapModelDownloader : BeatmapModelDownloader
             {
-                public TestBeatmapModelDownloader(IBeatmapModelManager modelManager, IAPIProvider apiProvider, GameHost gameHost)
-                    : base(modelManager, apiProvider, gameHost)
+                public TestBeatmapModelDownloader(IModelImporter<BeatmapSetInfo> importer, IAPIProvider apiProvider, GameHost gameHost)
+                    : base(importer, apiProvider, gameHost)
                 {
                 }
 
diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index c68088a5e2..7e19057fb3 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -54,7 +54,7 @@ namespace osu.Game.Beatmaps
             }
         }
 
-        protected virtual BeatmapModelDownloader CreateBeatmapModelDownloader(IBeatmapModelManager modelManager, IAPIProvider api, GameHost host)
+        protected virtual BeatmapModelDownloader CreateBeatmapModelDownloader(IModelImporter<BeatmapSetInfo> modelManager, IAPIProvider api, GameHost host)
         {
             return new BeatmapModelDownloader(modelManager, api, host);
         }
diff --git a/osu.Game/Beatmaps/BeatmapModelDownloader.cs b/osu.Game/Beatmaps/BeatmapModelDownloader.cs
index 001726e741..e708190b0e 100644
--- a/osu.Game/Beatmaps/BeatmapModelDownloader.cs
+++ b/osu.Game/Beatmaps/BeatmapModelDownloader.cs
@@ -16,8 +16,8 @@ namespace osu.Game.Beatmaps
         public override ArchiveDownloadRequest<BeatmapSetInfo> GetExistingDownload(BeatmapSetInfo model)
             => CurrentDownloads.Find(r => r.Model.OnlineID == model.OnlineID);
 
-        public BeatmapModelDownloader(IBeatmapModelManager beatmapModelManager, IAPIProvider api, GameHost host = null)
-            : base(beatmapModelManager, api, host)
+        public BeatmapModelDownloader(IModelImporter<BeatmapSetInfo> beatmapImporter, IAPIProvider api, GameHost host = null)
+            : base(beatmapImporter, api, host)
         {
         }
     }
diff --git a/osu.Game/Database/ModelDownloader.cs b/osu.Game/Database/ModelDownloader.cs
index 12bf5e9ce7..a2a4209f1f 100644
--- a/osu.Game/Database/ModelDownloader.cs
+++ b/osu.Game/Database/ModelDownloader.cs
@@ -27,14 +27,14 @@ namespace osu.Game.Database
 
         private readonly Bindable<WeakReference<ArchiveDownloadRequest<TModel>>> downloadFailed = new Bindable<WeakReference<ArchiveDownloadRequest<TModel>>>();
 
-        private readonly IModelManager<TModel> modelManager;
+        private readonly IModelImporter<TModel> importer;
         private readonly IAPIProvider api;
 
         protected readonly List<ArchiveDownloadRequest<TModel>> CurrentDownloads = new List<ArchiveDownloadRequest<TModel>>();
 
-        protected ModelDownloader(IModelManager<TModel> modelManager, IAPIProvider api, IIpcHost importHost = null)
+        protected ModelDownloader(IModelImporter<TModel> importer, IAPIProvider api, IIpcHost importHost = null)
         {
-            this.modelManager = modelManager;
+            this.importer = importer;
             this.api = api;
         }
 
@@ -68,7 +68,7 @@ namespace osu.Game.Database
                 Task.Factory.StartNew(async () =>
                 {
                     // This gets scheduled back to the update thread, but we want the import to run in the background.
-                    var imported = await modelManager.Import(notification, new ImportTask(filename)).ConfigureAwait(false);
+                    var imported = await importer.Import(notification, new ImportTask(filename)).ConfigureAwait(false);
 
                     // for now a failed import will be marked as a failed download for simplicity.
                     if (!imported.Any())
@@ -103,7 +103,7 @@ namespace osu.Game.Database
                 notification.State = ProgressNotificationState.Cancelled;
 
                 if (!(error is OperationCanceledException))
-                    Logger.Error(error, $"{modelManager.HumanisedModelName.Titleize()} download failed!");
+                    Logger.Error(error, $"{importer.HumanisedModelName.Titleize()} download failed!");
             }
         }
 
diff --git a/osu.Game/Scoring/ScoreModelDownloader.cs b/osu.Game/Scoring/ScoreModelDownloader.cs
index 52355585a9..bd14493ab7 100644
--- a/osu.Game/Scoring/ScoreModelDownloader.cs
+++ b/osu.Game/Scoring/ScoreModelDownloader.cs
@@ -10,7 +10,7 @@ namespace osu.Game.Scoring
 {
     public class ScoreModelDownloader : ModelDownloader<ScoreInfo>
     {
-        public ScoreModelDownloader(ScoreModelManager scoreManager, IAPIProvider api, IIpcHost importHost = null)
+        public ScoreModelDownloader(IModelImporter<ScoreInfo> scoreManager, IAPIProvider api, IIpcHost importHost = null)
             : base(scoreManager, api, importHost)
         {
         }

From 7772a97cf72aeb89470028b2fa479264b2bdafbc Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 5 Nov 2021 17:01:00 +0900
Subject: [PATCH 0765/5547] Add helper function to get realm class names rather
 than hard-coding each time

---
 osu.Game/Database/RealmContextFactory.cs | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Database/RealmContextFactory.cs b/osu.Game/Database/RealmContextFactory.cs
index be2cf8ff4e..eb8b190975 100644
--- a/osu.Game/Database/RealmContextFactory.cs
+++ b/osu.Game/Database/RealmContextFactory.cs
@@ -3,6 +3,7 @@
 
 using System;
 using System.Linq;
+using System.Reflection;
 using System.Threading;
 using osu.Framework.Allocation;
 using osu.Framework.Development;
@@ -167,7 +168,7 @@ namespace osu.Game.Database
 
                     void convertOnlineIDs<T>() where T : RealmObject
                     {
-                        string className = typeof(T).Name.Replace(@"Realm", string.Empty);
+                        string className = getMappedOrOriginalName(typeof(T));
 
                         // version was not bumped when the beatmap/ruleset models were added
                         // therefore we must manually check for their presence to avoid throwing on the `DynamicApi` calls.
@@ -208,9 +209,7 @@ namespace osu.Game.Database
 
                 case 9:
                     // Pretty pointless to do this as beatmaps aren't really loaded via realm yet, but oh well.
-                    string className = nameof(RealmBeatmapMetadata).Replace(@"Realm", string.Empty);
-
-                    var oldItems = migration.OldRealm.DynamicApi.All(className);
+                    var oldItems = migration.OldRealm.DynamicApi.All(getMappedOrOriginalName(typeof(RealmBeatmapMetadata)));
                     var newItems = migration.NewRealm.All<RealmBeatmapMetadata>();
 
                     int itemCount = newItems.Count();
@@ -285,6 +284,9 @@ namespace osu.Game.Database
             });
         }
 
+        // https://github.com/realm/realm-dotnet/blob/32f4ebcc88b3e80a3b254412665340cd9f3bd6b5/Realm/Realm/Extensions/ReflectionExtensions.cs#L46
+        private static string getMappedOrOriginalName(MemberInfo member) => member.GetCustomAttribute<MapToAttribute>()?.Mapping ?? member.Name;
+
         private bool isDisposed;
 
         public void Dispose()

From 846c80f12cd83a6e37c2b07c8e074ae982d098c5 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 5 Nov 2021 17:02:23 +0900
Subject: [PATCH 0766/5547] Rename remaining clashing variables to appease CI
 somewhere

---
 osu.Game/Database/RealmContextFactory.cs | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Database/RealmContextFactory.cs b/osu.Game/Database/RealmContextFactory.cs
index eb8b190975..ba6fb4dd41 100644
--- a/osu.Game/Database/RealmContextFactory.cs
+++ b/osu.Game/Database/RealmContextFactory.cs
@@ -209,15 +209,15 @@ namespace osu.Game.Database
 
                 case 9:
                     // Pretty pointless to do this as beatmaps aren't really loaded via realm yet, but oh well.
-                    var oldItems = migration.OldRealm.DynamicApi.All(getMappedOrOriginalName(typeof(RealmBeatmapMetadata)));
-                    var newItems = migration.NewRealm.All<RealmBeatmapMetadata>();
+                    var oldMetadata = migration.OldRealm.DynamicApi.All(getMappedOrOriginalName(typeof(RealmBeatmapMetadata)));
+                    var newMetadata = migration.NewRealm.All<RealmBeatmapMetadata>();
 
-                    int itemCount = newItems.Count();
+                    int itemCount = newMetadata.Count();
 
                     for (int i = 0; i < itemCount; i++)
                     {
-                        dynamic? oldItem = oldItems.ElementAt(i);
-                        var newItem = newItems.ElementAt(i);
+                        dynamic? oldItem = oldMetadata.ElementAt(i);
+                        var newItem = newMetadata.ElementAt(i);
 
                         string username = oldItem.Author;
                         newItem.Author = new RealmUser

From 99df37f32dca7102579e6b7acecaa451ba8854cf Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 5 Nov 2021 16:51:48 +0900
Subject: [PATCH 0767/5547] Add input generic type to `IModelDownloader`

---
 osu.Game/Database/IModelDownloader.cs | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Database/IModelDownloader.cs b/osu.Game/Database/IModelDownloader.cs
index a5573b2190..8c1e454f0b 100644
--- a/osu.Game/Database/IModelDownloader.cs
+++ b/osu.Game/Database/IModelDownloader.cs
@@ -11,8 +11,9 @@ namespace osu.Game.Database
     /// Represents a <see cref="IModelManager{TModel}"/> that can download new models from an external source.
     /// </summary>
     /// <typeparam name="TModel">The model type.</typeparam>
-    public interface IModelDownloader<TModel> : IPostNotifications
-        where TModel : class
+    /// <typeparam name="T">The model's interface type.</typeparam>
+    public interface IModelDownloader<TModel, in T> : IPostNotifications
+        where TModel : class, T
     {
         /// <summary>
         /// Fired when a <typeparamref name="TModel"/> download begins.
@@ -32,7 +33,7 @@ namespace osu.Game.Database
         /// <param name="model">The <stypeparamref name="TModel"/> to be downloaded.</param>
         /// <param name="minimiseDownloadSize">Whether this download should be optimised for slow connections. Generally means extras are not included in the download bundle..</param>
         /// <returns>Whether the download was started.</returns>
-        bool Download(TModel model, bool minimiseDownloadSize);
+        bool Download(T model, bool minimiseDownloadSize);
 
         /// <summary>
         /// Gets an existing <typeparamref name="TModel"/> download request if it exists.

From 6c385ccd29bd7686a012519e5f369846c1419b1c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 5 Nov 2021 17:37:05 +0900
Subject: [PATCH 0768/5547] Move second generic to `abstract` model downloader
 rather than interface type

---
 ...eneOnlinePlayBeatmapAvailabilityTracker.cs |  6 ++--
 osu.Game/Beatmaps/BeatmapManager.cs           | 25 +++-----------
 osu.Game/Beatmaps/BeatmapModelDownloader.cs   |  6 ++--
 osu.Game/Database/IModelDownloader.cs         | 29 ++++++++--------
 osu.Game/Database/ModelDownloader.cs          | 33 ++++++++++---------
 .../API/Requests/DownloadBeatmapSetRequest.cs |  6 ++--
 .../API/Requests/DownloadReplayRequest.cs     |  6 ++--
 osu.Game/Online/BeatmapDownloadTracker.cs     | 12 +++----
 osu.Game/Online/ScoreDownloadTracker.cs       | 14 ++++----
 osu.Game/Scoring/ScoreManager.cs              | 14 ++++----
 osu.Game/Scoring/ScoreModelDownloader.cs      |  8 ++---
 11 files changed, 70 insertions(+), 89 deletions(-)

diff --git a/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs b/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
index 70e62cc087..e3e2304990 100644
--- a/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
+++ b/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
@@ -180,7 +180,7 @@ namespace osu.Game.Tests.Online
                 {
                 }
 
-                protected override ArchiveDownloadRequest<BeatmapSetInfo> CreateDownloadRequest(BeatmapSetInfo set, bool minimiseDownloadSize)
+                protected override ArchiveDownloadRequest<IBeatmapSetInfo> CreateDownloadRequest(IBeatmapSetInfo set, bool minimiseDownloadSize)
                     => new TestDownloadRequest(set);
             }
 
@@ -202,12 +202,12 @@ namespace osu.Game.Tests.Online
             }
         }
 
-        private class TestDownloadRequest : ArchiveDownloadRequest<BeatmapSetInfo>
+        private class TestDownloadRequest : ArchiveDownloadRequest<IBeatmapSetInfo>
         {
             public new void SetProgress(float progress) => base.SetProgress(progress);
             public new void TriggerSuccess(string filename) => base.TriggerSuccess(filename);
 
-            public TestDownloadRequest(BeatmapSetInfo model)
+            public TestDownloadRequest(IBeatmapSetInfo model)
                 : base(model)
             {
             }
diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index 7e19057fb3..e0e5b5e63d 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -29,7 +29,7 @@ namespace osu.Game.Beatmaps
     /// Handles general operations related to global beatmap management.
     /// </summary>
     [ExcludeFromDynamicCompile]
-    public class BeatmapManager : IModelDownloader<BeatmapSetInfo>, IModelManager<BeatmapSetInfo>, IModelFileManager<BeatmapSetInfo, BeatmapSetFileInfo>, IModelImporter<BeatmapSetInfo>, IWorkingBeatmapCache, IDisposable
+    public class BeatmapManager : IModelDownloader<IBeatmapSetInfo>, IModelManager<BeatmapSetInfo>, IModelFileManager<BeatmapSetInfo, BeatmapSetFileInfo>, IModelImporter<BeatmapSetInfo>, IWorkingBeatmapCache, IDisposable
     {
         private readonly BeatmapModelManager beatmapModelManager;
         private readonly BeatmapModelDownloader beatmapModelDownloader;
@@ -246,33 +246,16 @@ namespace osu.Game.Beatmaps
 
         #region Implementation of IModelDownloader<BeatmapSetInfo>
 
-        public IBindable<WeakReference<ArchiveDownloadRequest<BeatmapSetInfo>>> DownloadBegan => beatmapModelDownloader.DownloadBegan;
+        public IBindable<WeakReference<ArchiveDownloadRequest<IBeatmapSetInfo>>> DownloadBegan => beatmapModelDownloader.DownloadBegan;
 
-        public IBindable<WeakReference<ArchiveDownloadRequest<BeatmapSetInfo>>> DownloadFailed => beatmapModelDownloader.DownloadFailed;
+        public IBindable<WeakReference<ArchiveDownloadRequest<IBeatmapSetInfo>>> DownloadFailed => beatmapModelDownloader.DownloadFailed;
 
-        // Temporary method until this class supports IBeatmapSetInfo or otherwise.
         public bool Download(IBeatmapSetInfo model, bool minimiseDownloadSize = false)
-        {
-            return beatmapModelDownloader.Download(new BeatmapSetInfo
-            {
-                OnlineBeatmapSetID = model.OnlineID,
-                Metadata = new BeatmapMetadata
-                {
-                    Title = model.Metadata?.Title ?? string.Empty,
-                    Artist = model.Metadata?.Artist ?? string.Empty,
-                    TitleUnicode = model.Metadata?.TitleUnicode ?? string.Empty,
-                    ArtistUnicode = model.Metadata?.ArtistUnicode ?? string.Empty,
-                    Author = new User { Username = model.Metadata?.Author },
-                }
-            }, minimiseDownloadSize);
-        }
-
-        public bool Download(BeatmapSetInfo model, bool minimiseDownloadSize = false)
         {
             return beatmapModelDownloader.Download(model, minimiseDownloadSize);
         }
 
-        public ArchiveDownloadRequest<BeatmapSetInfo> GetExistingDownload(BeatmapSetInfo model)
+        public ArchiveDownloadRequest<IBeatmapSetInfo> GetExistingDownload(IBeatmapSetInfo model)
         {
             return beatmapModelDownloader.GetExistingDownload(model);
         }
diff --git a/osu.Game/Beatmaps/BeatmapModelDownloader.cs b/osu.Game/Beatmaps/BeatmapModelDownloader.cs
index e708190b0e..a170edc9f8 100644
--- a/osu.Game/Beatmaps/BeatmapModelDownloader.cs
+++ b/osu.Game/Beatmaps/BeatmapModelDownloader.cs
@@ -8,12 +8,12 @@ using osu.Game.Online.API.Requests;
 
 namespace osu.Game.Beatmaps
 {
-    public class BeatmapModelDownloader : ModelDownloader<BeatmapSetInfo>
+    public class BeatmapModelDownloader : ModelDownloader<BeatmapSetInfo, IBeatmapSetInfo>
     {
-        protected override ArchiveDownloadRequest<BeatmapSetInfo> CreateDownloadRequest(BeatmapSetInfo set, bool minimiseDownloadSize) =>
+        protected override ArchiveDownloadRequest<IBeatmapSetInfo> CreateDownloadRequest(IBeatmapSetInfo set, bool minimiseDownloadSize) =>
             new DownloadBeatmapSetRequest(set, minimiseDownloadSize);
 
-        public override ArchiveDownloadRequest<BeatmapSetInfo> GetExistingDownload(BeatmapSetInfo model)
+        public override ArchiveDownloadRequest<IBeatmapSetInfo> GetExistingDownload(IBeatmapSetInfo model)
             => CurrentDownloads.Find(r => r.Model.OnlineID == model.OnlineID);
 
         public BeatmapModelDownloader(IModelImporter<BeatmapSetInfo> beatmapImporter, IAPIProvider api, GameHost host = null)
diff --git a/osu.Game/Database/IModelDownloader.cs b/osu.Game/Database/IModelDownloader.cs
index 8c1e454f0b..3c57a277ba 100644
--- a/osu.Game/Database/IModelDownloader.cs
+++ b/osu.Game/Database/IModelDownloader.cs
@@ -10,36 +10,35 @@ namespace osu.Game.Database
     /// <summary>
     /// Represents a <see cref="IModelManager{TModel}"/> that can download new models from an external source.
     /// </summary>
-    /// <typeparam name="TModel">The model type.</typeparam>
-    /// <typeparam name="T">The model's interface type.</typeparam>
-    public interface IModelDownloader<TModel, in T> : IPostNotifications
-        where TModel : class, T
+    /// <typeparam name="T">The item's interface type.</typeparam>
+    public interface IModelDownloader<T> : IPostNotifications
+        where T : class
     {
         /// <summary>
-        /// Fired when a <typeparamref name="TModel"/> download begins.
+        /// Fired when a <typeparamref name="T"/> download begins.
         /// This is NOT run on the update thread and should be scheduled.
         /// </summary>
-        IBindable<WeakReference<ArchiveDownloadRequest<TModel>>> DownloadBegan { get; }
+        IBindable<WeakReference<ArchiveDownloadRequest<T>>> DownloadBegan { get; }
 
         /// <summary>
-        /// Fired when a <typeparamref name="TModel"/> download is interrupted, either due to user cancellation or failure.
+        /// Fired when a <typeparamref name="T"/> download is interrupted, either due to user cancellation or failure.
         /// This is NOT run on the update thread and should be scheduled.
         /// </summary>
-        IBindable<WeakReference<ArchiveDownloadRequest<TModel>>> DownloadFailed { get; }
+        IBindable<WeakReference<ArchiveDownloadRequest<T>>> DownloadFailed { get; }
 
         /// <summary>
-        /// Begin a download for the requested <typeparamref name="TModel"/>.
+        /// Begin a download for the requested <typeparamref name="T"/>.
         /// </summary>
-        /// <param name="model">The <stypeparamref name="TModel"/> to be downloaded.</param>
+        /// <param name="item">The <stypeparamref name="T"/> to be downloaded.</param>
         /// <param name="minimiseDownloadSize">Whether this download should be optimised for slow connections. Generally means extras are not included in the download bundle..</param>
         /// <returns>Whether the download was started.</returns>
-        bool Download(T model, bool minimiseDownloadSize);
+        bool Download(T item, bool minimiseDownloadSize);
 
         /// <summary>
-        /// Gets an existing <typeparamref name="TModel"/> download request if it exists.
+        /// Gets an existing <typeparamref name="T"/> download request if it exists.
         /// </summary>
-        /// <param name="model">The <typeparamref name="TModel"/> whose request is wanted.</param>
-        /// <returns>The <see cref="ArchiveDownloadRequest{TModel}"/> object if it exists, otherwise null.</returns>
-        ArchiveDownloadRequest<TModel> GetExistingDownload(TModel model);
+        /// <param name="item">The <typeparamref name="T"/> whose request is wanted.</param>
+        /// <returns>The <see cref="ArchiveDownloadRequest{T}"/> object if it exists, otherwise null.</returns>
+        ArchiveDownloadRequest<T> GetExistingDownload(T item);
     }
 }
diff --git a/osu.Game/Database/ModelDownloader.cs b/osu.Game/Database/ModelDownloader.cs
index a2a4209f1f..e44ae21ed6 100644
--- a/osu.Game/Database/ModelDownloader.cs
+++ b/osu.Game/Database/ModelDownloader.cs
@@ -14,23 +14,24 @@ using osu.Game.Overlays.Notifications;
 
 namespace osu.Game.Database
 {
-    public abstract class ModelDownloader<TModel> : IModelDownloader<TModel>
-        where TModel : class, IHasPrimaryKey, ISoftDelete, IEquatable<TModel>
+    public abstract class ModelDownloader<TModel, T> : IModelDownloader<T>
+        where TModel : class, IHasPrimaryKey, ISoftDelete, IEquatable<TModel>, T
+        where T : class
     {
         public Action<Notification> PostNotification { protected get; set; }
 
-        public IBindable<WeakReference<ArchiveDownloadRequest<TModel>>> DownloadBegan => downloadBegan;
+        public IBindable<WeakReference<ArchiveDownloadRequest<T>>> DownloadBegan => downloadBegan;
 
-        private readonly Bindable<WeakReference<ArchiveDownloadRequest<TModel>>> downloadBegan = new Bindable<WeakReference<ArchiveDownloadRequest<TModel>>>();
+        private readonly Bindable<WeakReference<ArchiveDownloadRequest<T>>> downloadBegan = new Bindable<WeakReference<ArchiveDownloadRequest<T>>>();
 
-        public IBindable<WeakReference<ArchiveDownloadRequest<TModel>>> DownloadFailed => downloadFailed;
+        public IBindable<WeakReference<ArchiveDownloadRequest<T>>> DownloadFailed => downloadFailed;
 
-        private readonly Bindable<WeakReference<ArchiveDownloadRequest<TModel>>> downloadFailed = new Bindable<WeakReference<ArchiveDownloadRequest<TModel>>>();
+        private readonly Bindable<WeakReference<ArchiveDownloadRequest<T>>> downloadFailed = new Bindable<WeakReference<ArchiveDownloadRequest<T>>>();
 
         private readonly IModelImporter<TModel> importer;
         private readonly IAPIProvider api;
 
-        protected readonly List<ArchiveDownloadRequest<TModel>> CurrentDownloads = new List<ArchiveDownloadRequest<TModel>>();
+        protected readonly List<ArchiveDownloadRequest<T>> CurrentDownloads = new List<ArchiveDownloadRequest<T>>();
 
         protected ModelDownloader(IModelImporter<TModel> importer, IAPIProvider api, IIpcHost importHost = null)
         {
@@ -39,14 +40,14 @@ namespace osu.Game.Database
         }
 
         /// <summary>
-        /// Creates the download request for this <typeparamref name="TModel"/>.
+        /// Creates the download request for this <typeparamref name="T"/>.
         /// </summary>
-        /// <param name="model">The <typeparamref name="TModel"/> to be downloaded.</param>
+        /// <param name="model">The <typeparamref name="T"/> to be downloaded.</param>
         /// <param name="minimiseDownloadSize">Whether this download should be optimised for slow connections. Generally means extras are not included in the download bundle.</param>
         /// <returns>The request object.</returns>
-        protected abstract ArchiveDownloadRequest<TModel> CreateDownloadRequest(TModel model, bool minimiseDownloadSize);
+        protected abstract ArchiveDownloadRequest<T> CreateDownloadRequest(T model, bool minimiseDownloadSize);
 
-        public bool Download(TModel model, bool minimiseDownloadSize = false)
+        public bool Download(T model, bool minimiseDownloadSize = false)
         {
             if (!canDownload(model)) return false;
 
@@ -72,7 +73,7 @@ namespace osu.Game.Database
 
                     // for now a failed import will be marked as a failed download for simplicity.
                     if (!imported.Any())
-                        downloadFailed.Value = new WeakReference<ArchiveDownloadRequest<TModel>>(request);
+                        downloadFailed.Value = new WeakReference<ArchiveDownloadRequest<T>>(request);
 
                     CurrentDownloads.Remove(request);
                 }, TaskCreationOptions.LongRunning);
@@ -91,14 +92,14 @@ namespace osu.Game.Database
 
             api.PerformAsync(request);
 
-            downloadBegan.Value = new WeakReference<ArchiveDownloadRequest<TModel>>(request);
+            downloadBegan.Value = new WeakReference<ArchiveDownloadRequest<T>>(request);
             return true;
 
             void triggerFailure(Exception error)
             {
                 CurrentDownloads.Remove(request);
 
-                downloadFailed.Value = new WeakReference<ArchiveDownloadRequest<TModel>>(request);
+                downloadFailed.Value = new WeakReference<ArchiveDownloadRequest<T>>(request);
 
                 notification.State = ProgressNotificationState.Cancelled;
 
@@ -107,9 +108,9 @@ namespace osu.Game.Database
             }
         }
 
-        public abstract ArchiveDownloadRequest<TModel> GetExistingDownload(TModel model);
+        public abstract ArchiveDownloadRequest<T> GetExistingDownload(T model);
 
-        private bool canDownload(TModel model) => GetExistingDownload(model) == null && api != null;
+        private bool canDownload(T model) => GetExistingDownload(model) == null && api != null;
 
         private class DownloadNotification : ProgressNotification
         {
diff --git a/osu.Game/Online/API/Requests/DownloadBeatmapSetRequest.cs b/osu.Game/Online/API/Requests/DownloadBeatmapSetRequest.cs
index 2898955de7..5254dc3cf8 100644
--- a/osu.Game/Online/API/Requests/DownloadBeatmapSetRequest.cs
+++ b/osu.Game/Online/API/Requests/DownloadBeatmapSetRequest.cs
@@ -6,11 +6,11 @@ using osu.Game.Beatmaps;
 
 namespace osu.Game.Online.API.Requests
 {
-    public class DownloadBeatmapSetRequest : ArchiveDownloadRequest<BeatmapSetInfo>
+    public class DownloadBeatmapSetRequest : ArchiveDownloadRequest<IBeatmapSetInfo>
     {
         private readonly bool noVideo;
 
-        public DownloadBeatmapSetRequest(BeatmapSetInfo set, bool noVideo)
+        public DownloadBeatmapSetRequest(IBeatmapSetInfo set, bool noVideo)
             : base(set)
         {
             this.noVideo = noVideo;
@@ -25,6 +25,6 @@ namespace osu.Game.Online.API.Requests
 
         protected override string FileExtension => ".osz";
 
-        protected override string Target => $@"beatmapsets/{Model.OnlineBeatmapSetID}/download{(noVideo ? "?noVideo=1" : "")}";
+        protected override string Target => $@"beatmapsets/{Model.OnlineID}/download{(noVideo ? "?noVideo=1" : "")}";
     }
 }
diff --git a/osu.Game/Online/API/Requests/DownloadReplayRequest.cs b/osu.Game/Online/API/Requests/DownloadReplayRequest.cs
index 6fd052653d..77174f0bb5 100644
--- a/osu.Game/Online/API/Requests/DownloadReplayRequest.cs
+++ b/osu.Game/Online/API/Requests/DownloadReplayRequest.cs
@@ -5,15 +5,15 @@ using osu.Game.Scoring;
 
 namespace osu.Game.Online.API.Requests
 {
-    public class DownloadReplayRequest : ArchiveDownloadRequest<ScoreInfo>
+    public class DownloadReplayRequest : ArchiveDownloadRequest<IScoreInfo>
     {
-        public DownloadReplayRequest(ScoreInfo score)
+        public DownloadReplayRequest(IScoreInfo score)
             : base(score)
         {
         }
 
         protected override string FileExtension => ".osr";
 
-        protected override string Target => $@"scores/{Model.Ruleset.ShortName}/{Model.OnlineScoreID}/download";
+        protected override string Target => $@"scores/{Model.Ruleset.ShortName}/{Model.OnlineID}/download";
     }
 }
diff --git a/osu.Game/Online/BeatmapDownloadTracker.cs b/osu.Game/Online/BeatmapDownloadTracker.cs
index 4a7d0b660a..12cbcdbec7 100644
--- a/osu.Game/Online/BeatmapDownloadTracker.cs
+++ b/osu.Game/Online/BeatmapDownloadTracker.cs
@@ -16,7 +16,7 @@ namespace osu.Game.Online
         [Resolved(CanBeNull = true)]
         protected BeatmapManager? Manager { get; private set; }
 
-        private ArchiveDownloadRequest<BeatmapSetInfo>? attachedRequest;
+        private ArchiveDownloadRequest<IBeatmapSetInfo>? attachedRequest;
 
         public BeatmapDownloadTracker(IBeatmapSetInfo trackedItem)
             : base(trackedItem)
@@ -25,8 +25,8 @@ namespace osu.Game.Online
 
         private IBindable<WeakReference<BeatmapSetInfo>>? managerUpdated;
         private IBindable<WeakReference<BeatmapSetInfo>>? managerRemoved;
-        private IBindable<WeakReference<ArchiveDownloadRequest<BeatmapSetInfo>>>? managerDownloadBegan;
-        private IBindable<WeakReference<ArchiveDownloadRequest<BeatmapSetInfo>>>? managerDownloadFailed;
+        private IBindable<WeakReference<ArchiveDownloadRequest<IBeatmapSetInfo>>>? managerDownloadBegan;
+        private IBindable<WeakReference<ArchiveDownloadRequest<IBeatmapSetInfo>>>? managerDownloadFailed;
 
         [BackgroundDependencyLoader(true)]
         private void load()
@@ -52,7 +52,7 @@ namespace osu.Game.Online
             managerRemoved.BindValueChanged(itemRemoved);
         }
 
-        private void downloadBegan(ValueChangedEvent<WeakReference<ArchiveDownloadRequest<BeatmapSetInfo>>> weakRequest)
+        private void downloadBegan(ValueChangedEvent<WeakReference<ArchiveDownloadRequest<IBeatmapSetInfo>>> weakRequest)
         {
             if (weakRequest.NewValue.TryGetTarget(out var request))
             {
@@ -64,7 +64,7 @@ namespace osu.Game.Online
             }
         }
 
-        private void downloadFailed(ValueChangedEvent<WeakReference<ArchiveDownloadRequest<BeatmapSetInfo>>> weakRequest)
+        private void downloadFailed(ValueChangedEvent<WeakReference<ArchiveDownloadRequest<IBeatmapSetInfo>>> weakRequest)
         {
             if (weakRequest.NewValue.TryGetTarget(out var request))
             {
@@ -76,7 +76,7 @@ namespace osu.Game.Online
             }
         }
 
-        private void attachDownload(ArchiveDownloadRequest<BeatmapSetInfo>? request)
+        private void attachDownload(ArchiveDownloadRequest<IBeatmapSetInfo>? request)
         {
             if (attachedRequest != null)
             {
diff --git a/osu.Game/Online/ScoreDownloadTracker.cs b/osu.Game/Online/ScoreDownloadTracker.cs
index e679071ac1..9ea6d5b79a 100644
--- a/osu.Game/Online/ScoreDownloadTracker.cs
+++ b/osu.Game/Online/ScoreDownloadTracker.cs
@@ -16,7 +16,7 @@ namespace osu.Game.Online
         [Resolved(CanBeNull = true)]
         protected ScoreManager? Manager { get; private set; }
 
-        private ArchiveDownloadRequest<ScoreInfo>? attachedRequest;
+        private ArchiveDownloadRequest<IScoreInfo>? attachedRequest;
 
         public ScoreDownloadTracker(ScoreInfo trackedItem)
             : base(trackedItem)
@@ -25,8 +25,8 @@ namespace osu.Game.Online
 
         private IBindable<WeakReference<ScoreInfo>>? managerUpdated;
         private IBindable<WeakReference<ScoreInfo>>? managerRemoved;
-        private IBindable<WeakReference<ArchiveDownloadRequest<ScoreInfo>>>? managerDownloadBegan;
-        private IBindable<WeakReference<ArchiveDownloadRequest<ScoreInfo>>>? managerDownloadFailed;
+        private IBindable<WeakReference<ArchiveDownloadRequest<IScoreInfo>>>? managerDownloadBegan;
+        private IBindable<WeakReference<ArchiveDownloadRequest<IScoreInfo>>>? managerDownloadFailed;
 
         [BackgroundDependencyLoader(true)]
         private void load()
@@ -56,7 +56,7 @@ namespace osu.Game.Online
             managerRemoved.BindValueChanged(itemRemoved);
         }
 
-        private void downloadBegan(ValueChangedEvent<WeakReference<ArchiveDownloadRequest<ScoreInfo>>> weakRequest)
+        private void downloadBegan(ValueChangedEvent<WeakReference<ArchiveDownloadRequest<IScoreInfo>>> weakRequest)
         {
             if (weakRequest.NewValue.TryGetTarget(out var request))
             {
@@ -68,7 +68,7 @@ namespace osu.Game.Online
             }
         }
 
-        private void downloadFailed(ValueChangedEvent<WeakReference<ArchiveDownloadRequest<ScoreInfo>>> weakRequest)
+        private void downloadFailed(ValueChangedEvent<WeakReference<ArchiveDownloadRequest<IScoreInfo>>> weakRequest)
         {
             if (weakRequest.NewValue.TryGetTarget(out var request))
             {
@@ -80,7 +80,7 @@ namespace osu.Game.Online
             }
         }
 
-        private void attachDownload(ArchiveDownloadRequest<ScoreInfo>? request)
+        private void attachDownload(ArchiveDownloadRequest<IScoreInfo>? request)
         {
             if (attachedRequest != null)
             {
@@ -144,7 +144,7 @@ namespace osu.Game.Online
             }
         }
 
-        private bool checkEquality(ScoreInfo x, ScoreInfo y) => x.OnlineScoreID == y.OnlineScoreID;
+        private bool checkEquality(IScoreInfo x, IScoreInfo y) => x.OnlineID == y.OnlineID;
 
         #region Disposal
 
diff --git a/osu.Game/Scoring/ScoreManager.cs b/osu.Game/Scoring/ScoreManager.cs
index 380d2590bf..676baf511a 100644
--- a/osu.Game/Scoring/ScoreManager.cs
+++ b/osu.Game/Scoring/ScoreManager.cs
@@ -25,7 +25,7 @@ using osu.Game.Rulesets.Scoring;
 
 namespace osu.Game.Scoring
 {
-    public class ScoreManager : IModelManager<ScoreInfo>, IModelImporter<ScoreInfo>, IModelFileManager<ScoreInfo, ScoreFileInfo>, IModelDownloader<ScoreInfo>
+    public class ScoreManager : IModelManager<ScoreInfo>, IModelImporter<ScoreInfo>, IModelFileManager<ScoreInfo, ScoreFileInfo>, IModelDownloader<IScoreInfo>
     {
         private readonly Scheduler scheduler;
         private readonly Func<BeatmapDifficultyCache> difficulties;
@@ -350,16 +350,14 @@ namespace osu.Game.Scoring
 
         #region Implementation of IModelDownloader<ScoreInfo>
 
-        public IBindable<WeakReference<ArchiveDownloadRequest<ScoreInfo>>> DownloadBegan => scoreModelDownloader.DownloadBegan;
+        public IBindable<WeakReference<ArchiveDownloadRequest<IScoreInfo>>> DownloadBegan => scoreModelDownloader.DownloadBegan;
 
-        public IBindable<WeakReference<ArchiveDownloadRequest<ScoreInfo>>> DownloadFailed => scoreModelDownloader.DownloadFailed;
+        public IBindable<WeakReference<ArchiveDownloadRequest<IScoreInfo>>> DownloadFailed => scoreModelDownloader.DownloadFailed;
 
-        public bool Download(ScoreInfo model, bool minimiseDownloadSize)
-        {
-            return scoreModelDownloader.Download(model, minimiseDownloadSize);
-        }
+        public bool Download(IScoreInfo model, bool minimiseDownloadSize) =>
+            scoreModelDownloader.Download(model, minimiseDownloadSize);
 
-        public ArchiveDownloadRequest<ScoreInfo> GetExistingDownload(ScoreInfo model)
+        public ArchiveDownloadRequest<IScoreInfo> GetExistingDownload(IScoreInfo model)
         {
             return scoreModelDownloader.GetExistingDownload(model);
         }
diff --git a/osu.Game/Scoring/ScoreModelDownloader.cs b/osu.Game/Scoring/ScoreModelDownloader.cs
index bd14493ab7..6c63e2aa71 100644
--- a/osu.Game/Scoring/ScoreModelDownloader.cs
+++ b/osu.Game/Scoring/ScoreModelDownloader.cs
@@ -8,16 +8,16 @@ using osu.Game.Online.API.Requests;
 
 namespace osu.Game.Scoring
 {
-    public class ScoreModelDownloader : ModelDownloader<ScoreInfo>
+    public class ScoreModelDownloader : ModelDownloader<ScoreInfo, IScoreInfo>
     {
         public ScoreModelDownloader(IModelImporter<ScoreInfo> scoreManager, IAPIProvider api, IIpcHost importHost = null)
             : base(scoreManager, api, importHost)
         {
         }
 
-        protected override ArchiveDownloadRequest<ScoreInfo> CreateDownloadRequest(ScoreInfo score, bool minimiseDownload) => new DownloadReplayRequest(score);
+        protected override ArchiveDownloadRequest<IScoreInfo> CreateDownloadRequest(IScoreInfo score, bool minimiseDownload) => new DownloadReplayRequest(score);
 
-        public override ArchiveDownloadRequest<ScoreInfo> GetExistingDownload(ScoreInfo model)
-            => CurrentDownloads.Find(r => r.Model.OnlineScoreID == model.OnlineScoreID);
+        public override ArchiveDownloadRequest<IScoreInfo> GetExistingDownload(IScoreInfo model)
+            => CurrentDownloads.Find(r => r.Model.OnlineID == model.OnlineID);
     }
 }

From 608958b18669277c9b306d03e7a21ce4746ba3ab Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 5 Nov 2021 12:10:05 +0300
Subject: [PATCH 0769/5547] Remove unused setter in interface type

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

diff --git a/osu.Game/Users/IUser.cs b/osu.Game/Users/IUser.cs
index 89831e6c4d..3995531fd9 100644
--- a/osu.Game/Users/IUser.cs
+++ b/osu.Game/Users/IUser.cs
@@ -7,7 +7,7 @@ namespace osu.Game.Users
 {
     public interface IUser : IHasOnlineID<int>
     {
-        string Username { get; set; }
+        string Username { get; }
 
         bool IsBot { get; }
     }

From 771bcbf8686ebdcbc58473003b2cbc6e9af4a830 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 5 Nov 2021 12:24:07 +0300
Subject: [PATCH 0770/5547] Rename one more clashing variable

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

diff --git a/osu.Game/Database/RealmContextFactory.cs b/osu.Game/Database/RealmContextFactory.cs
index ba6fb4dd41..20667bb3d1 100644
--- a/osu.Game/Database/RealmContextFactory.cs
+++ b/osu.Game/Database/RealmContextFactory.cs
@@ -212,9 +212,9 @@ namespace osu.Game.Database
                     var oldMetadata = migration.OldRealm.DynamicApi.All(getMappedOrOriginalName(typeof(RealmBeatmapMetadata)));
                     var newMetadata = migration.NewRealm.All<RealmBeatmapMetadata>();
 
-                    int itemCount = newMetadata.Count();
+                    int metadataCount = newMetadata.Count();
 
-                    for (int i = 0; i < itemCount; i++)
+                    for (int i = 0; i < metadataCount; i++)
                     {
                         dynamic? oldItem = oldMetadata.ElementAt(i);
                         var newItem = newMetadata.ElementAt(i);

From 54f72d68cab6ba44f9f8b5fe4d82b8b0cede0225 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 5 Nov 2021 18:05:31 +0900
Subject: [PATCH 0771/5547] Revert weird event flow in model manager/importers

---
 .../Beatmaps/IO/ImportBeatmapTest.cs          |  4 +-
 .../Online/TestSceneDirectDownloadButton.cs   |  4 +-
 osu.Game/Beatmaps/BeatmapManager.cs           | 37 +++++++--
 osu.Game/Beatmaps/BeatmapModelManager.cs      | 13 +--
 osu.Game/Database/ArchiveModelManager.cs      | 13 +--
 osu.Game/Database/IModelDownloader.cs         |  5 +-
 osu.Game/Database/IModelManager.cs            | 11 +--
 osu.Game/Database/ModelDownloader.cs          | 15 ++--
 osu.Game/Online/BeatmapDownloadTracker.cs     | 82 +++++++------------
 osu.Game/Online/ScoreDownloadTracker.cs       | 82 +++++++------------
 osu.Game/OsuGameBase.cs                       | 27 ++----
 osu.Game/Overlays/MusicController.cs          | 45 ++++------
 .../Overlays/Settings/Sections/SkinSection.cs | 33 ++++----
 osu.Game/Scoring/ScoreManager.cs              | 24 +++++-
 .../Screens/OnlinePlay/Match/RoomSubScreen.cs | 15 ++--
 osu.Game/Screens/Select/BeatmapCarousel.cs    | 57 +++++--------
 .../Screens/Select/Carousel/TopLocalRank.cs   | 31 +++----
 .../Select/Leaderboards/BeatmapLeaderboard.cs | 37 ++++-----
 osu.Game/Screens/Spectate/SpectatorScreen.cs  | 16 ++--
 19 files changed, 236 insertions(+), 315 deletions(-)

diff --git a/osu.Game.Tests/Beatmaps/IO/ImportBeatmapTest.cs b/osu.Game.Tests/Beatmaps/IO/ImportBeatmapTest.cs
index d68d43c998..f815598122 100644
--- a/osu.Game.Tests/Beatmaps/IO/ImportBeatmapTest.cs
+++ b/osu.Game.Tests/Beatmaps/IO/ImportBeatmapTest.cs
@@ -408,8 +408,8 @@ namespace osu.Game.Tests.Beatmaps.IO
                     var manager = osu.Dependencies.Get<BeatmapManager>();
 
                     // ReSharper disable once AccessToModifiedClosure
-                    manager.ItemUpdated.BindValueChanged(_ => Interlocked.Increment(ref itemAddRemoveFireCount));
-                    manager.ItemRemoved.BindValueChanged(_ => Interlocked.Increment(ref itemAddRemoveFireCount));
+                    manager.ItemUpdated += _ => Interlocked.Increment(ref itemAddRemoveFireCount);
+                    manager.ItemRemoved += _ => Interlocked.Increment(ref itemAddRemoveFireCount);
 
                     var imported = await LoadOszIntoOsu(osu);
 
diff --git a/osu.Game.Tests/Visual/Online/TestSceneDirectDownloadButton.cs b/osu.Game.Tests/Visual/Online/TestSceneDirectDownloadButton.cs
index 3d828077c8..a865bbe950 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneDirectDownloadButton.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneDirectDownloadButton.cs
@@ -45,10 +45,10 @@ namespace osu.Game.Tests.Visual.Online
             AddStep("import soleily", () => beatmaps.Import(TestResources.GetQuickTestBeatmapForImport()));
 
             AddUntilStep("wait for beatmap import", () => beatmaps.GetAllUsableBeatmapSets().Any(b => b.OnlineBeatmapSetID == 241526));
-            AddAssert("button state downloaded", () => downloadButton.DownloadState == DownloadState.LocallyAvailable);
+            AddUntilStep("button state downloaded", () => downloadButton.DownloadState == DownloadState.LocallyAvailable);
 
             createButtonWithBeatmap(createSoleily());
-            AddAssert("button state downloaded", () => downloadButton.DownloadState == DownloadState.LocallyAvailable);
+            AddUntilStep("button state downloaded", () => downloadButton.DownloadState == DownloadState.LocallyAvailable);
             ensureSoleilyRemoved();
             AddAssert("button state not downloaded", () => downloadButton.DownloadState == DownloadState.NotDownloaded);
         }
diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index 7a9f3e0a45..98c0ba648e 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -10,7 +10,6 @@ using System.Threading;
 using System.Threading.Tasks;
 using JetBrains.Annotations;
 using osu.Framework.Audio;
-using osu.Framework.Bindables;
 using osu.Framework.IO.Stores;
 using osu.Framework.Platform;
 using osu.Framework.Testing;
@@ -101,12 +100,20 @@ namespace osu.Game.Beatmaps
         /// <summary>
         /// Fired when a single difficulty has been hidden.
         /// </summary>
-        public IBindable<WeakReference<BeatmapInfo>> BeatmapHidden => beatmapModelManager.BeatmapHidden;
+        public Action<BeatmapInfo> BeatmapHidden
+        {
+            get => beatmapModelManager.BeatmapHidden;
+            set => beatmapModelManager.BeatmapHidden = value;
+        }
 
         /// <summary>
         /// Fired when a single difficulty has been restored.
         /// </summary>
-        public IBindable<WeakReference<BeatmapInfo>> BeatmapRestored => beatmapModelManager.BeatmapRestored;
+        public Action<BeatmapInfo> BeatmapRestored
+        {
+            get => beatmapModelManager.BeatmapRestored;
+            set => beatmapModelManager.BeatmapRestored = value;
+        }
 
         /// <summary>
         /// Saves an <see cref="IBeatmap"/> file against a given <see cref="BeatmapInfo"/>.
@@ -198,9 +205,17 @@ namespace osu.Game.Beatmaps
             return beatmapModelManager.IsAvailableLocally(model);
         }
 
-        public IBindable<WeakReference<BeatmapSetInfo>> ItemUpdated => beatmapModelManager.ItemUpdated;
+        public Action<BeatmapSetInfo> ItemUpdated
+        {
+            get => beatmapModelManager.ItemUpdated;
+            set => beatmapModelManager.ItemUpdated = value;
+        }
 
-        public IBindable<WeakReference<BeatmapSetInfo>> ItemRemoved => beatmapModelManager.ItemRemoved;
+        public Action<BeatmapSetInfo> ItemRemoved
+        {
+            get => beatmapModelManager.ItemRemoved;
+            set => beatmapModelManager.ItemRemoved = value;
+        }
 
         public Task ImportFromStableAsync(StableStorage stableStorage)
         {
@@ -246,9 +261,17 @@ namespace osu.Game.Beatmaps
 
         #region Implementation of IModelDownloader<BeatmapSetInfo>
 
-        public IBindable<WeakReference<ArchiveDownloadRequest<BeatmapSetInfo>>> DownloadBegan => beatmapModelDownloader.DownloadBegan;
+        public Action<ArchiveDownloadRequest<BeatmapSetInfo>> DownloadBegan
+        {
+            get => beatmapModelDownloader.DownloadBegan;
+            set => beatmapModelDownloader.DownloadBegan = value;
+        }
 
-        public IBindable<WeakReference<ArchiveDownloadRequest<BeatmapSetInfo>>> DownloadFailed => beatmapModelDownloader.DownloadFailed;
+        public Action<ArchiveDownloadRequest<BeatmapSetInfo>> DownloadFailed
+        {
+            get => beatmapModelDownloader.DownloadFailed;
+            set => beatmapModelDownloader.DownloadFailed = value;
+        }
 
         // Temporary method until this class supports IBeatmapSetInfo or otherwise.
         public bool Download(IBeatmapSetInfo model, bool minimiseDownloadSize = false)
diff --git a/osu.Game/Beatmaps/BeatmapModelManager.cs b/osu.Game/Beatmaps/BeatmapModelManager.cs
index f148d05aca..1a78a625d9 100644
--- a/osu.Game/Beatmaps/BeatmapModelManager.cs
+++ b/osu.Game/Beatmaps/BeatmapModelManager.cs
@@ -11,7 +11,6 @@ using System.Threading;
 using System.Threading.Tasks;
 using Microsoft.EntityFrameworkCore;
 using osu.Framework.Audio.Track;
-using osu.Framework.Bindables;
 using osu.Framework.Extensions;
 using osu.Framework.Graphics.Textures;
 using osu.Framework.Logging;
@@ -37,14 +36,12 @@ namespace osu.Game.Beatmaps
         /// <summary>
         /// Fired when a single difficulty has been hidden.
         /// </summary>
-        public IBindable<WeakReference<BeatmapInfo>> BeatmapHidden => beatmapHidden;
-
-        private readonly Bindable<WeakReference<BeatmapInfo>> beatmapHidden = new Bindable<WeakReference<BeatmapInfo>>();
+        public Action<BeatmapInfo> BeatmapHidden;
 
         /// <summary>
         /// Fired when a single difficulty has been restored.
         /// </summary>
-        public IBindable<WeakReference<BeatmapInfo>> BeatmapRestored => beatmapRestored;
+        public Action<BeatmapInfo> BeatmapRestored;
 
         /// <summary>
         /// An online lookup queue component which handles populating online beatmap metadata.
@@ -56,8 +53,6 @@ namespace osu.Game.Beatmaps
         /// </summary>
         public IWorkingBeatmapCache WorkingBeatmapCache { private get; set; }
 
-        private readonly Bindable<WeakReference<BeatmapInfo>> beatmapRestored = new Bindable<WeakReference<BeatmapInfo>>();
-
         public override IEnumerable<string> HandledExtensions => new[] { ".osz" };
 
         protected override string[] HashableFileTypes => new[] { ".osu" };
@@ -75,8 +70,8 @@ namespace osu.Game.Beatmaps
             this.rulesets = rulesets;
 
             beatmaps = (BeatmapStore)ModelStore;
-            beatmaps.BeatmapHidden += b => beatmapHidden.Value = new WeakReference<BeatmapInfo>(b);
-            beatmaps.BeatmapRestored += b => beatmapRestored.Value = new WeakReference<BeatmapInfo>(b);
+            beatmaps.BeatmapHidden += b => BeatmapHidden?.Invoke(b);
+            beatmaps.BeatmapRestored += b => BeatmapRestored?.Invoke(b);
             beatmaps.ItemRemoved += b => WorkingBeatmapCache?.Invalidate(b);
             beatmaps.ItemUpdated += obj => WorkingBeatmapCache?.Invalidate(obj);
         }
diff --git a/osu.Game/Database/ArchiveModelManager.cs b/osu.Game/Database/ArchiveModelManager.cs
index 4e40e52051..bc4d0cdabd 100644
--- a/osu.Game/Database/ArchiveModelManager.cs
+++ b/osu.Game/Database/ArchiveModelManager.cs
@@ -10,7 +10,6 @@ using System.Threading.Tasks;
 using Humanizer;
 using JetBrains.Annotations;
 using Microsoft.EntityFrameworkCore;
-using osu.Framework.Bindables;
 using osu.Framework.Extensions;
 using osu.Framework.Extensions.IEnumerableExtensions;
 using osu.Framework.Logging;
@@ -63,17 +62,13 @@ namespace osu.Game.Database
         /// Fired when a new or updated <typeparamref name="TModel"/> becomes available in the database.
         /// This is not guaranteed to run on the update thread.
         /// </summary>
-        public IBindable<WeakReference<TModel>> ItemUpdated => itemUpdated;
-
-        private readonly Bindable<WeakReference<TModel>> itemUpdated = new Bindable<WeakReference<TModel>>();
+        public Action<TModel> ItemUpdated { get; set; }
 
         /// <summary>
         /// Fired when a <typeparamref name="TModel"/> is removed from the database.
         /// This is not guaranteed to run on the update thread.
         /// </summary>
-        public IBindable<WeakReference<TModel>> ItemRemoved => itemRemoved;
-
-        private readonly Bindable<WeakReference<TModel>> itemRemoved = new Bindable<WeakReference<TModel>>();
+        public Action<TModel> ItemRemoved { get; set; }
 
         public virtual IEnumerable<string> HandledExtensions => new[] { @".zip" };
 
@@ -93,8 +88,8 @@ namespace osu.Game.Database
             ContextFactory = contextFactory;
 
             ModelStore = modelStore;
-            ModelStore.ItemUpdated += item => handleEvent(() => itemUpdated.Value = new WeakReference<TModel>(item));
-            ModelStore.ItemRemoved += item => handleEvent(() => itemRemoved.Value = new WeakReference<TModel>(item));
+            ModelStore.ItemUpdated += item => handleEvent(() => ItemUpdated?.Invoke(item));
+            ModelStore.ItemRemoved += item => handleEvent(() => ItemRemoved?.Invoke(item));
 
             exportStorage = storage.GetStorageForDirectory(@"exports");
 
diff --git a/osu.Game/Database/IModelDownloader.cs b/osu.Game/Database/IModelDownloader.cs
index a5573b2190..09bf838eeb 100644
--- a/osu.Game/Database/IModelDownloader.cs
+++ b/osu.Game/Database/IModelDownloader.cs
@@ -3,7 +3,6 @@
 
 using System;
 using osu.Game.Online.API;
-using osu.Framework.Bindables;
 
 namespace osu.Game.Database
 {
@@ -18,13 +17,13 @@ namespace osu.Game.Database
         /// Fired when a <typeparamref name="TModel"/> download begins.
         /// This is NOT run on the update thread and should be scheduled.
         /// </summary>
-        IBindable<WeakReference<ArchiveDownloadRequest<TModel>>> DownloadBegan { get; }
+        Action<ArchiveDownloadRequest<TModel>> DownloadBegan { get; set; }
 
         /// <summary>
         /// Fired when a <typeparamref name="TModel"/> download is interrupted, either due to user cancellation or failure.
         /// This is NOT run on the update thread and should be scheduled.
         /// </summary>
-        IBindable<WeakReference<ArchiveDownloadRequest<TModel>>> DownloadFailed { get; }
+        Action<ArchiveDownloadRequest<TModel>> DownloadFailed { get; set; }
 
         /// <summary>
         /// Begin a download for the requested <typeparamref name="TModel"/>.
diff --git a/osu.Game/Database/IModelManager.cs b/osu.Game/Database/IModelManager.cs
index f5e401cdfb..d8e5775f4d 100644
--- a/osu.Game/Database/IModelManager.cs
+++ b/osu.Game/Database/IModelManager.cs
@@ -5,7 +5,6 @@ using System;
 using System.Collections.Generic;
 using System.IO;
 using System.Threading.Tasks;
-using osu.Framework.Bindables;
 using osu.Game.IO;
 
 namespace osu.Game.Database
@@ -18,16 +17,14 @@ namespace osu.Game.Database
         where TModel : class
     {
         /// <summary>
-        /// A bindable which contains a weak reference to the last item that was updated.
-        /// This is not thread-safe and should be scheduled locally if consumed from a drawable component.
+        /// Fired when an item is updated.
         /// </summary>
-        IBindable<WeakReference<TModel>> ItemUpdated { get; }
+        Action<TModel> ItemUpdated { get; set; }
 
         /// <summary>
-        /// A bindable which contains a weak reference to the last item that was removed.
-        /// This is not thread-safe and should be scheduled locally if consumed from a drawable component.
+        /// Fired when an item is removed.
         /// </summary>
-        IBindable<WeakReference<TModel>> ItemRemoved { get; }
+        Action<TModel> ItemRemoved { get; set; }
 
         /// <summary>
         /// This is a temporary method and will likely be replaced by a full-fledged (and more correctly placed) migration process in the future.
diff --git a/osu.Game/Database/ModelDownloader.cs b/osu.Game/Database/ModelDownloader.cs
index 12bf5e9ce7..39ca4780eb 100644
--- a/osu.Game/Database/ModelDownloader.cs
+++ b/osu.Game/Database/ModelDownloader.cs
@@ -6,7 +6,6 @@ using System.Collections.Generic;
 using System.Linq;
 using System.Threading.Tasks;
 using Humanizer;
-using osu.Framework.Bindables;
 using osu.Framework.Logging;
 using osu.Framework.Platform;
 using osu.Game.Online.API;
@@ -19,13 +18,9 @@ namespace osu.Game.Database
     {
         public Action<Notification> PostNotification { protected get; set; }
 
-        public IBindable<WeakReference<ArchiveDownloadRequest<TModel>>> DownloadBegan => downloadBegan;
+        public Action<ArchiveDownloadRequest<TModel>> DownloadBegan { get; set; }
 
-        private readonly Bindable<WeakReference<ArchiveDownloadRequest<TModel>>> downloadBegan = new Bindable<WeakReference<ArchiveDownloadRequest<TModel>>>();
-
-        public IBindable<WeakReference<ArchiveDownloadRequest<TModel>>> DownloadFailed => downloadFailed;
-
-        private readonly Bindable<WeakReference<ArchiveDownloadRequest<TModel>>> downloadFailed = new Bindable<WeakReference<ArchiveDownloadRequest<TModel>>>();
+        public Action<ArchiveDownloadRequest<TModel>> DownloadFailed { get; set; }
 
         private readonly IModelManager<TModel> modelManager;
         private readonly IAPIProvider api;
@@ -72,7 +67,7 @@ namespace osu.Game.Database
 
                     // for now a failed import will be marked as a failed download for simplicity.
                     if (!imported.Any())
-                        downloadFailed.Value = new WeakReference<ArchiveDownloadRequest<TModel>>(request);
+                        DownloadFailed?.Invoke(request);
 
                     CurrentDownloads.Remove(request);
                 }, TaskCreationOptions.LongRunning);
@@ -91,14 +86,14 @@ namespace osu.Game.Database
 
             api.PerformAsync(request);
 
-            downloadBegan.Value = new WeakReference<ArchiveDownloadRequest<TModel>>(request);
+            DownloadBegan?.Invoke(request);
             return true;
 
             void triggerFailure(Exception error)
             {
                 CurrentDownloads.Remove(request);
 
-                downloadFailed.Value = new WeakReference<ArchiveDownloadRequest<TModel>>(request);
+                DownloadFailed?.Invoke(request);
 
                 notification.State = ProgressNotificationState.Cancelled;
 
diff --git a/osu.Game/Online/BeatmapDownloadTracker.cs b/osu.Game/Online/BeatmapDownloadTracker.cs
index 4a7d0b660a..6637c0705e 100644
--- a/osu.Game/Online/BeatmapDownloadTracker.cs
+++ b/osu.Game/Online/BeatmapDownloadTracker.cs
@@ -3,7 +3,6 @@
 
 using System;
 using osu.Framework.Allocation;
-using osu.Framework.Bindables;
 using osu.Game.Beatmaps;
 using osu.Game.Online.API;
 
@@ -23,11 +22,6 @@ namespace osu.Game.Online
         {
         }
 
-        private IBindable<WeakReference<BeatmapSetInfo>>? managerUpdated;
-        private IBindable<WeakReference<BeatmapSetInfo>>? managerRemoved;
-        private IBindable<WeakReference<ArchiveDownloadRequest<BeatmapSetInfo>>>? managerDownloadBegan;
-        private IBindable<WeakReference<ArchiveDownloadRequest<BeatmapSetInfo>>>? managerDownloadFailed;
-
         [BackgroundDependencyLoader(true)]
         private void load()
         {
@@ -42,39 +36,23 @@ namespace osu.Game.Online
             else
                 attachDownload(Manager.GetExistingDownload(beatmapSetInfo));
 
-            managerDownloadBegan = Manager.DownloadBegan.GetBoundCopy();
-            managerDownloadBegan.BindValueChanged(downloadBegan);
-            managerDownloadFailed = Manager.DownloadFailed.GetBoundCopy();
-            managerDownloadFailed.BindValueChanged(downloadFailed);
-            managerUpdated = Manager.ItemUpdated.GetBoundCopy();
-            managerUpdated.BindValueChanged(itemUpdated);
-            managerRemoved = Manager.ItemRemoved.GetBoundCopy();
-            managerRemoved.BindValueChanged(itemRemoved);
+            Manager.DownloadBegan += downloadBegan;
+            Manager.DownloadFailed += downloadFailed;
+            Manager.ItemUpdated += itemUpdated;
+            Manager.ItemRemoved += itemRemoved;
         }
 
-        private void downloadBegan(ValueChangedEvent<WeakReference<ArchiveDownloadRequest<BeatmapSetInfo>>> weakRequest)
+        private void downloadBegan(ArchiveDownloadRequest<BeatmapSetInfo> request) => Schedule(() =>
         {
-            if (weakRequest.NewValue.TryGetTarget(out var request))
-            {
-                Schedule(() =>
-                {
-                    if (checkEquality(request.Model, TrackedItem))
-                        attachDownload(request);
-                });
-            }
-        }
+            if (checkEquality(request.Model, TrackedItem))
+                attachDownload(request);
+        });
 
-        private void downloadFailed(ValueChangedEvent<WeakReference<ArchiveDownloadRequest<BeatmapSetInfo>>> weakRequest)
+        private void downloadFailed(ArchiveDownloadRequest<BeatmapSetInfo> request) => Schedule(() =>
         {
-            if (weakRequest.NewValue.TryGetTarget(out var request))
-            {
-                Schedule(() =>
-                {
-                    if (checkEquality(request.Model, TrackedItem))
-                        attachDownload(null);
-                });
-            }
-        }
+            if (checkEquality(request.Model, TrackedItem))
+                attachDownload(null);
+        });
 
         private void attachDownload(ArchiveDownloadRequest<BeatmapSetInfo>? request)
         {
@@ -116,29 +94,17 @@ namespace osu.Game.Online
 
         private void onRequestFailure(Exception e) => Schedule(() => attachDownload(null));
 
-        private void itemUpdated(ValueChangedEvent<WeakReference<BeatmapSetInfo>> weakItem)
+        private void itemUpdated(BeatmapSetInfo item) => Schedule(() =>
         {
-            if (weakItem.NewValue.TryGetTarget(out var item))
-            {
-                Schedule(() =>
-                {
-                    if (checkEquality(item, TrackedItem))
-                        UpdateState(DownloadState.LocallyAvailable);
-                });
-            }
-        }
+            if (checkEquality(item, TrackedItem))
+                UpdateState(DownloadState.LocallyAvailable);
+        });
 
-        private void itemRemoved(ValueChangedEvent<WeakReference<BeatmapSetInfo>> weakItem)
+        private void itemRemoved(BeatmapSetInfo item) => Schedule(() =>
         {
-            if (weakItem.NewValue.TryGetTarget(out var item))
-            {
-                Schedule(() =>
-                {
-                    if (checkEquality(item, TrackedItem))
-                        UpdateState(DownloadState.NotDownloaded);
-                });
-            }
-        }
+            if (checkEquality(item, TrackedItem))
+                UpdateState(DownloadState.NotDownloaded);
+        });
 
         private bool checkEquality(IBeatmapSetInfo x, IBeatmapSetInfo y) => x.OnlineID == y.OnlineID;
 
@@ -148,6 +114,14 @@ namespace osu.Game.Online
         {
             base.Dispose(isDisposing);
             attachDownload(null);
+
+            if (Manager != null)
+            {
+                Manager.DownloadBegan -= downloadBegan;
+                Manager.DownloadFailed -= downloadFailed;
+                Manager.ItemUpdated -= itemUpdated;
+                Manager.ItemRemoved -= itemRemoved;
+            }
         }
 
         #endregion
diff --git a/osu.Game/Online/ScoreDownloadTracker.cs b/osu.Game/Online/ScoreDownloadTracker.cs
index e679071ac1..37031ed930 100644
--- a/osu.Game/Online/ScoreDownloadTracker.cs
+++ b/osu.Game/Online/ScoreDownloadTracker.cs
@@ -3,7 +3,6 @@
 
 using System;
 using osu.Framework.Allocation;
-using osu.Framework.Bindables;
 using osu.Game.Online.API;
 using osu.Game.Scoring;
 
@@ -23,11 +22,6 @@ namespace osu.Game.Online
         {
         }
 
-        private IBindable<WeakReference<ScoreInfo>>? managerUpdated;
-        private IBindable<WeakReference<ScoreInfo>>? managerRemoved;
-        private IBindable<WeakReference<ArchiveDownloadRequest<ScoreInfo>>>? managerDownloadBegan;
-        private IBindable<WeakReference<ArchiveDownloadRequest<ScoreInfo>>>? managerDownloadFailed;
-
         [BackgroundDependencyLoader(true)]
         private void load()
         {
@@ -46,39 +40,23 @@ namespace osu.Game.Online
             else
                 attachDownload(Manager.GetExistingDownload(scoreInfo));
 
-            managerDownloadBegan = Manager.DownloadBegan.GetBoundCopy();
-            managerDownloadBegan.BindValueChanged(downloadBegan);
-            managerDownloadFailed = Manager.DownloadFailed.GetBoundCopy();
-            managerDownloadFailed.BindValueChanged(downloadFailed);
-            managerUpdated = Manager.ItemUpdated.GetBoundCopy();
-            managerUpdated.BindValueChanged(itemUpdated);
-            managerRemoved = Manager.ItemRemoved.GetBoundCopy();
-            managerRemoved.BindValueChanged(itemRemoved);
+            Manager.DownloadBegan += downloadBegan;
+            Manager.DownloadFailed += downloadFailed;
+            Manager.ItemUpdated += itemUpdated;
+            Manager.ItemRemoved += itemRemoved;
         }
 
-        private void downloadBegan(ValueChangedEvent<WeakReference<ArchiveDownloadRequest<ScoreInfo>>> weakRequest)
+        private void downloadBegan(ArchiveDownloadRequest<ScoreInfo> request) => Schedule(() =>
         {
-            if (weakRequest.NewValue.TryGetTarget(out var request))
-            {
-                Schedule(() =>
-                {
-                    if (checkEquality(request.Model, TrackedItem))
-                        attachDownload(request);
-                });
-            }
-        }
+            if (checkEquality(request.Model, TrackedItem))
+                attachDownload(request);
+        });
 
-        private void downloadFailed(ValueChangedEvent<WeakReference<ArchiveDownloadRequest<ScoreInfo>>> weakRequest)
+        private void downloadFailed(ArchiveDownloadRequest<ScoreInfo> request) => Schedule(() =>
         {
-            if (weakRequest.NewValue.TryGetTarget(out var request))
-            {
-                Schedule(() =>
-                {
-                    if (checkEquality(request.Model, TrackedItem))
-                        attachDownload(null);
-                });
-            }
-        }
+            if (checkEquality(request.Model, TrackedItem))
+                attachDownload(null);
+        });
 
         private void attachDownload(ArchiveDownloadRequest<ScoreInfo>? request)
         {
@@ -120,29 +98,17 @@ namespace osu.Game.Online
 
         private void onRequestFailure(Exception e) => Schedule(() => attachDownload(null));
 
-        private void itemUpdated(ValueChangedEvent<WeakReference<ScoreInfo>> weakItem)
+        private void itemUpdated(ScoreInfo item) => Schedule(() =>
         {
-            if (weakItem.NewValue.TryGetTarget(out var item))
-            {
-                Schedule(() =>
-                {
-                    if (checkEquality(item, TrackedItem))
-                        UpdateState(DownloadState.LocallyAvailable);
-                });
-            }
-        }
+            if (checkEquality(item, TrackedItem))
+                UpdateState(DownloadState.LocallyAvailable);
+        });
 
-        private void itemRemoved(ValueChangedEvent<WeakReference<ScoreInfo>> weakItem)
+        private void itemRemoved(ScoreInfo item) => Schedule(() =>
         {
-            if (weakItem.NewValue.TryGetTarget(out var item))
-            {
-                Schedule(() =>
-                {
-                    if (checkEquality(item, TrackedItem))
-                        UpdateState(DownloadState.NotDownloaded);
-                });
-            }
-        }
+            if (checkEquality(item, TrackedItem))
+                UpdateState(DownloadState.LocallyAvailable);
+        });
 
         private bool checkEquality(ScoreInfo x, ScoreInfo y) => x.OnlineScoreID == y.OnlineScoreID;
 
@@ -152,6 +118,14 @@ namespace osu.Game.Online
         {
             base.Dispose(isDisposing);
             attachDownload(null);
+
+            if (Manager != null)
+            {
+                Manager.DownloadBegan -= downloadBegan;
+                Manager.DownloadFailed -= downloadFailed;
+                Manager.ItemUpdated -= itemUpdated;
+                Manager.ItemRemoved -= itemRemoved;
+            }
         }
 
         #endregion
diff --git a/osu.Game/OsuGameBase.cs b/osu.Game/OsuGameBase.cs
index f6ec22a536..bf4f968e4e 100644
--- a/osu.Game/OsuGameBase.cs
+++ b/osu.Game/OsuGameBase.cs
@@ -206,17 +206,11 @@ namespace osu.Game
             dependencies.CacheAs<ISkinSource>(SkinManager);
 
             // needs to be done here rather than inside SkinManager to ensure thread safety of CurrentSkinInfo.
-            SkinManager.ItemRemoved.BindValueChanged(weakRemovedInfo =>
+            SkinManager.ItemRemoved += item => Schedule(() =>
             {
-                if (weakRemovedInfo.NewValue.TryGetTarget(out var removedInfo))
-                {
-                    Schedule(() =>
-                    {
-                        // check the removed skin is not the current user choice. if it is, switch back to default.
-                        if (removedInfo.ID == SkinManager.CurrentSkinInfo.Value.ID)
-                            SkinManager.CurrentSkinInfo.Value = SkinInfo.Default;
-                    });
-                }
+                // check the removed skin is not the current user choice. if it is, switch back to default.
+                if (item.ID == SkinManager.CurrentSkinInfo.Value.ID)
+                    SkinManager.CurrentSkinInfo.Value = SkinInfo.Default;
             });
 
             EndpointConfiguration endpoints = UseDevelopmentServer ? (EndpointConfiguration)new DevelopmentEndpointConfiguration() : new ProductionEndpointConfiguration();
@@ -246,17 +240,8 @@ namespace osu.Game
                 return ScoreManager.QueryScores(s => beatmapIds.Contains(s.BeatmapInfo.ID)).ToList();
             }
 
-            BeatmapManager.ItemRemoved.BindValueChanged(i =>
-            {
-                if (i.NewValue.TryGetTarget(out var item))
-                    ScoreManager.Delete(getBeatmapScores(item), true);
-            });
-
-            BeatmapManager.ItemUpdated.BindValueChanged(i =>
-            {
-                if (i.NewValue.TryGetTarget(out var item))
-                    ScoreManager.Undelete(getBeatmapScores(item), true);
-            });
+            BeatmapManager.ItemRemoved += item => ScoreManager.Delete(getBeatmapScores(item), true);
+            BeatmapManager.ItemUpdated += item => ScoreManager.Undelete(getBeatmapScores(item), true);
 
             dependencies.Cache(difficultyCache = new BeatmapDifficultyCache());
             AddInternal(difficultyCache);
diff --git a/osu.Game/Overlays/MusicController.cs b/osu.Game/Overlays/MusicController.cs
index 97c7aaeaeb..829ff5be25 100644
--- a/osu.Game/Overlays/MusicController.cs
+++ b/osu.Game/Overlays/MusicController.cs
@@ -65,16 +65,11 @@ namespace osu.Game.Overlays
         [NotNull]
         public DrawableTrack CurrentTrack { get; private set; } = new DrawableTrack(new TrackVirtual(1000));
 
-        private IBindable<WeakReference<BeatmapSetInfo>> managerUpdated;
-        private IBindable<WeakReference<BeatmapSetInfo>> managerRemoved;
-
         [BackgroundDependencyLoader]
         private void load()
         {
-            managerUpdated = beatmaps.ItemUpdated.GetBoundCopy();
-            managerUpdated.BindValueChanged(beatmapUpdated);
-            managerRemoved = beatmaps.ItemRemoved.GetBoundCopy();
-            managerRemoved.BindValueChanged(beatmapRemoved);
+            beatmaps.ItemUpdated += beatmapUpdated;
+            beatmaps.ItemRemoved += beatmapRemoved;
 
             beatmapSets.AddRange(beatmaps.GetAllUsableBeatmapSets(IncludedDetails.Minimal, true).OrderBy(_ => RNG.Next()));
 
@@ -110,28 +105,13 @@ namespace osu.Game.Overlays
         /// </summary>
         public bool TrackLoaded => CurrentTrack.TrackLoaded;
 
-        private void beatmapUpdated(ValueChangedEvent<WeakReference<BeatmapSetInfo>> weakSet)
+        private void beatmapUpdated(BeatmapSetInfo set) => Schedule(() =>
         {
-            if (weakSet.NewValue.TryGetTarget(out var set))
-            {
-                Schedule(() =>
-                {
-                    beatmapSets.Remove(set);
-                    beatmapSets.Add(set);
-                });
-            }
-        }
+            beatmapSets.Remove(set);
+            beatmapSets.Add(set);
+        });
 
-        private void beatmapRemoved(ValueChangedEvent<WeakReference<BeatmapSetInfo>> weakSet)
-        {
-            if (weakSet.NewValue.TryGetTarget(out var set))
-            {
-                Schedule(() =>
-                {
-                    beatmapSets.RemoveAll(s => s.ID == set.ID);
-                });
-            }
-        }
+        private void beatmapRemoved(BeatmapSetInfo set) => Schedule(() => beatmapSets.RemoveAll(s => s.ID == set.ID));
 
         private ScheduledDelegate seekDelegate;
 
@@ -437,6 +417,17 @@ namespace osu.Game.Overlays
                     mod.ApplyToTrack(CurrentTrack);
             }
         }
+
+        protected override void Dispose(bool isDisposing)
+        {
+            base.Dispose(isDisposing);
+
+            if (beatmaps != null)
+            {
+                beatmaps.ItemUpdated -= beatmapUpdated;
+                beatmaps.ItemRemoved -= beatmapRemoved;
+            }
+        }
     }
 
     public enum TrackChangeDirection
diff --git a/osu.Game/Overlays/Settings/Sections/SkinSection.cs b/osu.Game/Overlays/Settings/Sections/SkinSection.cs
index cf5d70ba91..0714b28b47 100644
--- a/osu.Game/Overlays/Settings/Sections/SkinSection.cs
+++ b/osu.Game/Overlays/Settings/Sections/SkinSection.cs
@@ -56,9 +56,6 @@ namespace osu.Game.Overlays.Settings.Sections
         [Resolved]
         private SkinManager skins { get; set; }
 
-        private IBindable<WeakReference<SkinInfo>> managerUpdated;
-        private IBindable<WeakReference<SkinInfo>> managerRemoved;
-
         [BackgroundDependencyLoader(permitNulls: true)]
         private void load(OsuConfigManager config, [CanBeNull] SkinEditorOverlay skinEditor)
         {
@@ -76,11 +73,8 @@ namespace osu.Game.Overlays.Settings.Sections
                 new ExportSkinButton(),
             };
 
-            managerUpdated = skins.ItemUpdated.GetBoundCopy();
-            managerUpdated.BindValueChanged(itemUpdated);
-
-            managerRemoved = skins.ItemRemoved.GetBoundCopy();
-            managerRemoved.BindValueChanged(itemRemoved);
+            skins.ItemUpdated += itemUpdated;
+            skins.ItemRemoved += itemRemoved;
 
             config.BindWith(OsuSetting.Skin, configBindable);
 
@@ -129,11 +123,7 @@ namespace osu.Game.Overlays.Settings.Sections
             skinDropdown.Items = skinItems;
         }
 
-        private void itemUpdated(ValueChangedEvent<WeakReference<SkinInfo>> weakItem)
-        {
-            if (weakItem.NewValue.TryGetTarget(out var item))
-                Schedule(() => addItem(item));
-        }
+        private void itemUpdated(SkinInfo item) => Schedule(() => addItem(item));
 
         private void addItem(SkinInfo item)
         {
@@ -142,11 +132,7 @@ namespace osu.Game.Overlays.Settings.Sections
             skinDropdown.Items = newDropdownItems;
         }
 
-        private void itemRemoved(ValueChangedEvent<WeakReference<SkinInfo>> weakItem)
-        {
-            if (weakItem.NewValue.TryGetTarget(out var item))
-                Schedule(() => skinDropdown.Items = skinDropdown.Items.Where(i => i.ID != item.ID).ToArray());
-        }
+        private void itemRemoved(SkinInfo item) => Schedule(() => skinDropdown.Items = skinDropdown.Items.Where(i => i.ID != item.ID).ToArray());
 
         private void sortUserSkins(List<SkinInfo> skinsList)
         {
@@ -155,6 +141,17 @@ namespace osu.Game.Overlays.Settings.Sections
                 Comparer<SkinInfo>.Create((a, b) => string.Compare(a.Name, b.Name, StringComparison.OrdinalIgnoreCase)));
         }
 
+        protected override void Dispose(bool isDisposing)
+        {
+            base.Dispose(isDisposing);
+
+            if (skins != null)
+            {
+                skins.ItemUpdated -= itemUpdated;
+                skins.ItemRemoved -= itemRemoved;
+            }
+        }
+
         private class SkinSettingsDropdown : SettingsDropdown<SkinInfo>
         {
             protected override OsuDropdown<SkinInfo> CreateDropdown() => new SkinDropdownControl();
diff --git a/osu.Game/Scoring/ScoreManager.cs b/osu.Game/Scoring/ScoreManager.cs
index 253591eb56..b5348cd179 100644
--- a/osu.Game/Scoring/ScoreManager.cs
+++ b/osu.Game/Scoring/ScoreManager.cs
@@ -246,9 +246,17 @@ namespace osu.Game.Scoring
 
         #region Implementation of IModelManager<ScoreInfo>
 
-        public IBindable<WeakReference<ScoreInfo>> ItemUpdated => scoreModelManager.ItemUpdated;
+        public Action<ScoreInfo> ItemUpdated
+        {
+            get => scoreModelManager.ItemUpdated;
+            set => scoreModelManager.ItemUpdated = value;
+        }
 
-        public IBindable<WeakReference<ScoreInfo>> ItemRemoved => scoreModelManager.ItemRemoved;
+        public Action<ScoreInfo> ItemRemoved
+        {
+            get => scoreModelManager.ItemRemoved;
+            set => scoreModelManager.ItemRemoved = value;
+        }
 
         public Task ImportFromStableAsync(StableStorage stableStorage)
         {
@@ -350,9 +358,17 @@ namespace osu.Game.Scoring
 
         #region Implementation of IModelDownloader<ScoreInfo>
 
-        public IBindable<WeakReference<ArchiveDownloadRequest<ScoreInfo>>> DownloadBegan => scoreModelDownloader.DownloadBegan;
+        public Action<ArchiveDownloadRequest<ScoreInfo>> DownloadBegan
+        {
+            get => scoreModelDownloader.DownloadBegan;
+            set => scoreModelDownloader.DownloadBegan = value;
+        }
 
-        public IBindable<WeakReference<ArchiveDownloadRequest<ScoreInfo>>> DownloadFailed => scoreModelDownloader.DownloadFailed;
+        public Action<ArchiveDownloadRequest<ScoreInfo>> DownloadFailed
+        {
+            get => scoreModelDownloader.DownloadFailed;
+            set => scoreModelDownloader.DownloadFailed = value;
+        }
 
         public bool Download(ScoreInfo model, bool minimiseDownloadSize)
         {
diff --git a/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs b/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
index 2cb29262e2..d6016ec4b9 100644
--- a/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
@@ -62,8 +62,6 @@ namespace osu.Game.Screens.OnlinePlay.Match
         [Resolved(canBeNull: true)]
         protected OnlinePlayScreen ParentScreen { get; private set; }
 
-        private IBindable<WeakReference<BeatmapSetInfo>> managerUpdated;
-
         [Cached]
         private OnlinePlayBeatmapAvailabilityTracker beatmapAvailabilityTracker { get; set; }
 
@@ -246,8 +244,7 @@ namespace osu.Game.Screens.OnlinePlay.Match
 
             SelectedItem.BindValueChanged(_ => Scheduler.AddOnce(selectedItemChanged));
 
-            managerUpdated = beatmapManager.ItemUpdated.GetBoundCopy();
-            managerUpdated.BindValueChanged(beatmapUpdated);
+            beatmapManager.ItemUpdated += beatmapUpdated;
 
             UserMods.BindValueChanged(_ => Scheduler.AddOnce(UpdateMods));
         }
@@ -362,7 +359,7 @@ namespace osu.Game.Screens.OnlinePlay.Match
             }
         }
 
-        private void beatmapUpdated(ValueChangedEvent<WeakReference<BeatmapSetInfo>> weakSet) => Schedule(updateWorkingBeatmap);
+        private void beatmapUpdated(BeatmapSetInfo set) => Schedule(updateWorkingBeatmap);
 
         private void updateWorkingBeatmap()
         {
@@ -431,6 +428,14 @@ namespace osu.Game.Screens.OnlinePlay.Match
         /// <param name="room">The room to change the settings of.</param>
         protected abstract RoomSettingsOverlay CreateRoomSettingsOverlay(Room room);
 
+        protected override void Dispose(bool isDisposing)
+        {
+            base.Dispose(isDisposing);
+
+            if (beatmapManager != null)
+                beatmapManager.ItemUpdated -= beatmapUpdated;
+        }
+
         public class UserModSelectButton : PurpleTriangleButton
         {
         }
diff --git a/osu.Game/Screens/Select/BeatmapCarousel.cs b/osu.Game/Screens/Select/BeatmapCarousel.cs
index e5e28d2fde..0c593ebea1 100644
--- a/osu.Game/Screens/Select/BeatmapCarousel.cs
+++ b/osu.Game/Screens/Select/BeatmapCarousel.cs
@@ -143,11 +143,6 @@ namespace osu.Game.Screens.Select
 
         private CarouselRoot root;
 
-        private IBindable<WeakReference<BeatmapSetInfo>> itemUpdated;
-        private IBindable<WeakReference<BeatmapSetInfo>> itemRemoved;
-        private IBindable<WeakReference<BeatmapInfo>> itemHidden;
-        private IBindable<WeakReference<BeatmapInfo>> itemRestored;
-
         private readonly DrawablePool<DrawableCarouselBeatmapSet> setPool = new DrawablePool<DrawableCarouselBeatmapSet>(100);
 
         public BeatmapCarousel()
@@ -179,14 +174,10 @@ namespace osu.Game.Screens.Select
             RightClickScrollingEnabled.ValueChanged += enabled => Scroll.RightMouseScrollbar = enabled.NewValue;
             RightClickScrollingEnabled.TriggerChange();
 
-            itemUpdated = beatmaps.ItemUpdated.GetBoundCopy();
-            itemUpdated.BindValueChanged(beatmapUpdated);
-            itemRemoved = beatmaps.ItemRemoved.GetBoundCopy();
-            itemRemoved.BindValueChanged(beatmapRemoved);
-            itemHidden = beatmaps.BeatmapHidden.GetBoundCopy();
-            itemHidden.BindValueChanged(beatmapHidden);
-            itemRestored = beatmaps.BeatmapRestored.GetBoundCopy();
-            itemRestored.BindValueChanged(beatmapRestored);
+            beatmaps.ItemUpdated += beatmapUpdated;
+            beatmaps.ItemRemoved += beatmapRemoved;
+            beatmaps.BeatmapHidden += beatmapHidden;
+            beatmaps.BeatmapRestored += beatmapRestored;
 
             if (!beatmapSets.Any())
                 loadBeatmapSets(GetLoadableBeatmaps());
@@ -675,29 +666,10 @@ namespace osu.Game.Screens.Select
             return (firstIndex, lastIndex);
         }
 
-        private void beatmapRemoved(ValueChangedEvent<WeakReference<BeatmapSetInfo>> weakItem)
-        {
-            if (weakItem.NewValue.TryGetTarget(out var item))
-                RemoveBeatmapSet(item);
-        }
-
-        private void beatmapUpdated(ValueChangedEvent<WeakReference<BeatmapSetInfo>> weakItem)
-        {
-            if (weakItem.NewValue.TryGetTarget(out var item))
-                UpdateBeatmapSet(item);
-        }
-
-        private void beatmapRestored(ValueChangedEvent<WeakReference<BeatmapInfo>> weakItem)
-        {
-            if (weakItem.NewValue.TryGetTarget(out var b))
-                UpdateBeatmapSet(beatmaps.QueryBeatmapSet(s => s.ID == b.BeatmapSetInfoID));
-        }
-
-        private void beatmapHidden(ValueChangedEvent<WeakReference<BeatmapInfo>> weakItem)
-        {
-            if (weakItem.NewValue.TryGetTarget(out var b))
-                UpdateBeatmapSet(beatmaps.QueryBeatmapSet(s => s.ID == b.BeatmapSetInfoID));
-        }
+        private void beatmapRemoved(BeatmapSetInfo item) => RemoveBeatmapSet(item);
+        private void beatmapUpdated(BeatmapSetInfo item) => UpdateBeatmapSet(item);
+        private void beatmapRestored(BeatmapInfo b) => UpdateBeatmapSet(beatmaps.QueryBeatmapSet(s => s.ID == b.BeatmapSetInfoID));
+        private void beatmapHidden(BeatmapInfo b) => UpdateBeatmapSet(beatmaps.QueryBeatmapSet(s => s.ID == b.BeatmapSetInfoID));
 
         private CarouselBeatmapSet createCarouselSet(BeatmapSetInfo beatmapSet)
         {
@@ -956,5 +928,18 @@ namespace osu.Game.Screens.Select
                 return base.OnDragStart(e);
             }
         }
+
+        protected override void Dispose(bool isDisposing)
+        {
+            base.Dispose(isDisposing);
+
+            if (beatmaps != null)
+            {
+                beatmaps.ItemUpdated -= beatmapUpdated;
+                beatmaps.ItemRemoved -= beatmapRemoved;
+                beatmaps.BeatmapHidden -= beatmapHidden;
+                beatmaps.BeatmapRestored -= beatmapRestored;
+            }
+        }
     }
 }
diff --git a/osu.Game/Screens/Select/Carousel/TopLocalRank.cs b/osu.Game/Screens/Select/Carousel/TopLocalRank.cs
index f2485587d8..34129f232c 100644
--- a/osu.Game/Screens/Select/Carousel/TopLocalRank.cs
+++ b/osu.Game/Screens/Select/Carousel/TopLocalRank.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.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
@@ -28,9 +27,6 @@ namespace osu.Game.Screens.Select.Carousel
         [Resolved]
         private IAPIProvider api { get; set; }
 
-        private IBindable<WeakReference<ScoreInfo>> itemUpdated;
-        private IBindable<WeakReference<ScoreInfo>> itemRemoved;
-
         public TopLocalRank(BeatmapInfo beatmapInfo)
             : base(null)
         {
@@ -40,24 +36,18 @@ namespace osu.Game.Screens.Select.Carousel
         [BackgroundDependencyLoader]
         private void load()
         {
-            itemUpdated = scores.ItemUpdated.GetBoundCopy();
-            itemUpdated.BindValueChanged(scoreChanged);
-
-            itemRemoved = scores.ItemRemoved.GetBoundCopy();
-            itemRemoved.BindValueChanged(scoreChanged);
+            scores.ItemUpdated += scoreChanged;
+            scores.ItemRemoved += scoreChanged;
 
             ruleset.ValueChanged += _ => fetchAndLoadTopScore();
 
             fetchAndLoadTopScore();
         }
 
-        private void scoreChanged(ValueChangedEvent<WeakReference<ScoreInfo>> weakScore)
+        private void scoreChanged(ScoreInfo score)
         {
-            if (weakScore.NewValue.TryGetTarget(out var score))
-            {
-                if (score.BeatmapInfoID == beatmapInfo.ID)
-                    fetchAndLoadTopScore();
-            }
+            if (score.BeatmapInfoID == beatmapInfo.ID)
+                fetchAndLoadTopScore();
         }
 
         private ScheduledDelegate scheduledRankUpdate;
@@ -86,5 +76,16 @@ namespace osu.Game.Screens.Select.Carousel
                          .OrderByDescending(s => s.TotalScore)
                          .FirstOrDefault();
         }
+
+        protected override void Dispose(bool isDisposing)
+        {
+            base.Dispose(isDisposing);
+
+            if (scores != null)
+            {
+                scores.ItemUpdated -= scoreChanged;
+                scores.ItemRemoved -= scoreChanged;
+            }
+        }
     }
 }
diff --git a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
index de1ba5cf2e..9205c6c0d2 100644
--- a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
+++ b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
@@ -44,10 +44,6 @@ namespace osu.Game.Screens.Select.Leaderboards
 
         private bool filterMods;
 
-        private IBindable<WeakReference<ScoreInfo>> itemRemoved;
-
-        private IBindable<WeakReference<ScoreInfo>> itemAdded;
-
         /// <summary>
         /// Whether to apply the game's currently selected mods as a filter when retrieving scores.
         /// </summary>
@@ -90,11 +86,8 @@ namespace osu.Game.Screens.Select.Leaderboards
                     UpdateScores();
             };
 
-            itemRemoved = scoreManager.ItemRemoved.GetBoundCopy();
-            itemRemoved.BindValueChanged(onScoreRemoved);
-
-            itemAdded = scoreManager.ItemUpdated.GetBoundCopy();
-            itemAdded.BindValueChanged(onScoreAdded);
+            scoreManager.ItemRemoved += scoreStoreChanged;
+            scoreManager.ItemUpdated += scoreStoreChanged;
         }
 
         protected override void Reset()
@@ -103,22 +96,13 @@ namespace osu.Game.Screens.Select.Leaderboards
             TopScore = null;
         }
 
-        private void onScoreRemoved(ValueChangedEvent<WeakReference<ScoreInfo>> score) =>
-            scoreStoreChanged(score);
-
-        private void onScoreAdded(ValueChangedEvent<WeakReference<ScoreInfo>> score) =>
-            scoreStoreChanged(score);
-
-        private void scoreStoreChanged(ValueChangedEvent<WeakReference<ScoreInfo>> score)
+        private void scoreStoreChanged(ScoreInfo score)
         {
             if (Scope != BeatmapLeaderboardScope.Local)
                 return;
 
-            if (score.NewValue.TryGetTarget(out var scoreInfo))
-            {
-                if (BeatmapInfo?.ID != scoreInfo.BeatmapInfoID)
-                    return;
-            }
+            if (BeatmapInfo?.ID != score.BeatmapInfoID)
+                return;
 
             RefreshScores();
         }
@@ -215,5 +199,16 @@ namespace osu.Game.Screens.Select.Leaderboards
         {
             Action = () => ScoreSelected?.Invoke(model)
         };
+
+        protected override void Dispose(bool isDisposing)
+        {
+            base.Dispose(isDisposing);
+
+            if (scoreManager != null)
+            {
+                scoreManager.ItemRemoved -= scoreStoreChanged;
+                scoreManager.ItemUpdated -= scoreStoreChanged;
+            }
+        }
     }
 }
diff --git a/osu.Game/Screens/Spectate/SpectatorScreen.cs b/osu.Game/Screens/Spectate/SpectatorScreen.cs
index c8df01dae6..f797f6e808 100644
--- a/osu.Game/Screens/Spectate/SpectatorScreen.cs
+++ b/osu.Game/Screens/Spectate/SpectatorScreen.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.Diagnostics;
 using System.Linq;
@@ -45,8 +44,6 @@ namespace osu.Game.Screens.Spectate
         private readonly Dictionary<int, User> userMap = new Dictionary<int, User>();
         private readonly Dictionary<int, SpectatorGameplayState> gameplayStates = new Dictionary<int, SpectatorGameplayState>();
 
-        private IBindable<WeakReference<BeatmapSetInfo>> managerUpdated;
-
         /// <summary>
         /// Creates a new <see cref="SpectatorScreen"/>.
         /// </summary>
@@ -73,20 +70,16 @@ namespace osu.Game.Screens.Spectate
                 playingUserStates.BindTo(spectatorClient.PlayingUserStates);
                 playingUserStates.BindCollectionChanged(onPlayingUserStatesChanged, true);
 
-                managerUpdated = beatmaps.ItemUpdated.GetBoundCopy();
-                managerUpdated.BindValueChanged(beatmapUpdated);
+                beatmaps.ItemUpdated += beatmapUpdated;
 
                 foreach ((int id, var _) in userMap)
                     spectatorClient.WatchUser(id);
             }));
         }
 
-        private void beatmapUpdated(ValueChangedEvent<WeakReference<BeatmapSetInfo>> e)
+        private void beatmapUpdated(BeatmapSetInfo beatmapSet)
         {
-            if (!e.NewValue.TryGetTarget(out var beatmapSet))
-                return;
-
-            foreach ((int userId, var _) in userMap)
+            foreach ((int userId, _) in userMap)
             {
                 if (!playingUserStates.TryGetValue(userId, out var userState))
                     continue;
@@ -223,7 +216,8 @@ namespace osu.Game.Screens.Spectate
                     spectatorClient.StopWatchingUser(userId);
             }
 
-            managerUpdated?.UnbindAll();
+            if (beatmaps != null)
+                beatmaps.ItemUpdated -= beatmapUpdated;
         }
     }
 }

From 51e7b9950e1bcedb85a97315616c486b3b3b75e7 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 5 Nov 2021 18:07:12 +0300
Subject: [PATCH 0772/5547] Define local current bindable to bind value change
 instead

---
 .../Overlays/Changelog/ChangelogHeader.cs     | 20 ++++++++++---------
 1 file changed, 11 insertions(+), 9 deletions(-)

diff --git a/osu.Game/Overlays/Changelog/ChangelogHeader.cs b/osu.Game/Overlays/Changelog/ChangelogHeader.cs
index 1b120ef57c..4a94666031 100644
--- a/osu.Game/Overlays/Changelog/ChangelogHeader.cs
+++ b/osu.Game/Overlays/Changelog/ChangelogHeader.cs
@@ -26,6 +26,8 @@ namespace osu.Game.Overlays.Changelog
 
         public static LocalisableString ListingString => LayoutStrings.HeaderChangelogIndex;
 
+        private readonly Bindable<APIUpdateStream> currentStream = new Bindable<APIUpdateStream>();
+
         private Box streamsBackground;
 
         public ChangelogHeader()
@@ -38,6 +40,12 @@ namespace osu.Game.Overlays.Changelog
             };
 
             Build.ValueChanged += showBuild;
+
+            currentStream.ValueChanged += e =>
+            {
+                if (e.NewValue?.LatestBuild != null && !e.NewValue.Equals(Build.Value?.UpdateStream))
+                    Build.Value = e.NewValue.LatestBuild;
+            };
         }
 
         [BackgroundDependencyLoader]
@@ -61,7 +69,7 @@ namespace osu.Game.Overlays.Changelog
             else
             {
                 Current.Value = ListingString;
-                Streams.Current.Value = null;
+                currentStream.Value = null;
             }
         }
 
@@ -88,17 +96,11 @@ namespace osu.Game.Overlays.Changelog
                             Horizontal = 65,
                             Vertical = 20
                         },
-                        Child = Streams = new ChangelogUpdateStreamControl()
+                        Child = Streams = new ChangelogUpdateStreamControl { Current = currentStream },
                     }
                 }
             };
 
-            Streams.Current.ValueChanged += e =>
-            {
-                if (e.NewValue?.LatestBuild != null && !e.NewValue.Equals(Build.Value?.UpdateStream))
-                    Build.Value = e.NewValue.LatestBuild;
-            };
-
             return content;
         }
 
@@ -115,7 +117,7 @@ namespace osu.Game.Overlays.Changelog
             if (Build.Value == null)
                 return;
 
-            Streams.Current.Value = Streams.Items.FirstOrDefault(s => s.Name == Build.Value.UpdateStream.Name);
+            currentStream.Value = Streams.Items.FirstOrDefault(s => s.Name == Build.Value.UpdateStream.Name);
         }
 
         private class ChangelogHeaderTitle : OverlayTitle

From 77e853ce2593f9973b89f4386592a12fda972e1f Mon Sep 17 00:00:00 2001
From: Chinmay Patil <chinmaytlc@gmail.com>
Date: Fri, 5 Nov 2021 12:16:58 -0600
Subject: [PATCH 0773/5547] Optimized UR Counter and removed redundant code

---
 .../Gameplay/TestSceneUnstableRateCounter.cs  | 90 +++++++------------
 .../Screens/Play/HUD/UnstableRateCounter.cs   | 83 +++++++++--------
 2 files changed, 79 insertions(+), 94 deletions(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneUnstableRateCounter.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneUnstableRateCounter.cs
index be1cd8a35c..0dc25cf378 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneUnstableRateCounter.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneUnstableRateCounter.cs
@@ -1,21 +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.Collections.Generic;
-using System.Diagnostics.CodeAnalysis;
-using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Testing;
-using osu.Framework.Utils;
 using osu.Game.Rulesets.Judgements;
 using osu.Game.Rulesets.Osu.Objects;
 using osu.Game.Rulesets.Osu.Scoring;
 using osu.Game.Rulesets.Scoring;
-using osu.Game.Scoring;
-using osu.Game.Screens.Play;
 using osu.Game.Screens.Play.HUD;
 using osuTK;
 
@@ -26,23 +19,12 @@ namespace osu.Game.Tests.Visual.Gameplay
         [Cached(typeof(ScoreProcessor))]
         private TestScoreProcessor scoreProcessor = new TestScoreProcessor();
 
-        [Cached(typeof(GameplayState))]
-        private GameplayState gameplayState;
+        private readonly OsuHitWindows hitWindows = new OsuHitWindows();
 
-        private OsuHitWindows hitWindows = new OsuHitWindows();
+        private UnstableRateCounter counter;
 
         private double prev;
 
-        public TestSceneUnstableRateCounter()
-        {
-            Score score = new Score
-            {
-                ScoreInfo = new ScoreInfo(),
-            };
-            gameplayState = new GameplayState(null, null, null, score);
-            scoreProcessor.NewJudgement += result => scoreProcessor.PopulateScore(score.ScoreInfo);
-        }
-
         [SetUpSteps]
         public void SetUp()
         {
@@ -52,41 +34,38 @@ namespace osu.Game.Tests.Visual.Gameplay
         [Test]
         public void TestBasic()
         {
-            AddStep("Create Display", () => recreateDisplay());
+            AddStep("Create Display", recreateDisplay);
 
-            AddRepeatStep("Set UR to 250", () => setUR(25), 20);
+            // Needs multiples 2 by the nature of UR, and went for 4 to be safe.
+            // Creates a 250 UR by placing a +25ms then a -25ms judgement, which then results in a 250 UR
+            AddRepeatStep("Set UR to 250", () => applyJudgement(25, true), 4);
 
-            AddStep("Reset UR", () =>
+            AddUntilStep("UR = 250", () => counter.Current.Value == 250.0);
+
+            AddRepeatStep("Revert UR", () =>
             {
-                scoreProcessor.Reset();
-                recreateDisplay();
-            });
+                scoreProcessor.RevertResult(
+                    new JudgementResult(new HitCircle { HitWindows = hitWindows }, new Judgement())
+                    {
+                        TimeOffset = 25,
+                        Type = HitResult.Perfect,
+                    });
+            }, 4);
 
-            AddRepeatStep("Set UR to 100", () => setUR(10), 20);
+            AddUntilStep("UR is 0", () => counter.Current.Value == 0.0);
+            AddUntilStep("Counter is invalid", () => counter.Child.Alpha == 0.3f);
 
-            AddStep("Reset UR", () =>
-            {
-                scoreProcessor.Reset();
-                recreateDisplay();
-            });
-
-            AddRepeatStep("Set UR to 0 (+50ms offset)", () => newJudgement(50), 10);
-
-            AddStep("Reset UR", () =>
-            {
-                scoreProcessor.Reset();
-                recreateDisplay();
-            });
-
-            AddRepeatStep("Set UR to 0 (-50 offset)", () => newJudgement(-50), 10);
-
-            AddRepeatStep("Random Judgements", () => newJudgement(), 20);
+            //Sets a UR of 0 by creating 10 10ms offset judgements. Since average = offset, UR = 0
+            AddRepeatStep("Set UR to 0", () => applyJudgement(10, false), 10);
+            //Applies a UR of 100 by creating 10 -10ms offset judgements. At the 10th judgement, offset should be 100.
+            AddRepeatStep("Bring UR to 100", () => applyJudgement(-10, false), 10);
         }
+
         private void recreateDisplay()
         {
             Clear();
 
-            Add(new UnstableRateCounter
+            Add(counter = new UnstableRateCounter
             {
                 Anchor = Anchor.Centre,
                 Origin = Anchor.Centre,
@@ -94,24 +73,21 @@ namespace osu.Game.Tests.Visual.Gameplay
             });
         }
 
-        private void newJudgement(double offset = 0, HitResult result = HitResult.Perfect)
+        private void applyJudgement(double offsetMs, bool alt)
         {
-            scoreProcessor.ApplyResult(new JudgementResult(new HitCircle { HitWindows = hitWindows }, new Judgement())
-            {
-                TimeOffset = offset == 0 ? RNG.Next(-150, 150) : offset,
-                Type = result,
-            });
-        }
+            double placement = offsetMs;
+
+            if (alt)
+            {
+                placement = prev > 0 ? -offsetMs : offsetMs;
+                prev = placement;
+            }
 
-        private void setUR(double UR = 0, HitResult result = HitResult.Perfect)
-        {
-            double placement = prev > 0 ? -UR : UR;
             scoreProcessor.ApplyResult(new JudgementResult(new HitCircle { HitWindows = hitWindows }, new Judgement())
             {
                 TimeOffset = placement,
-                Type = result,
+                Type = HitResult.Perfect,
             });
-            prev = placement;
         }
 
         private class TestScoreProcessor : ScoreProcessor
diff --git a/osu.Game/Screens/Play/HUD/UnstableRateCounter.cs b/osu.Game/Screens/Play/HUD/UnstableRateCounter.cs
index 0045dab004..7e6e3d9b39 100644
--- a/osu.Game/Screens/Play/HUD/UnstableRateCounter.cs
+++ b/osu.Game/Screens/Play/HUD/UnstableRateCounter.cs
@@ -4,10 +4,8 @@
 using System;
 using System.Collections.Generic;
 using System.Linq;
-using System.Threading;
 using JetBrains.Annotations;
 using osu.Framework.Allocation;
-using osu.Framework.Extensions.LocalisationExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Sprites;
@@ -18,8 +16,6 @@ using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Rulesets.Judgements;
 using osu.Game.Rulesets.Scoring;
-using osu.Game.Scoring;
-using osu.Game.Screens.Ranking.Statistics;
 using osu.Game.Skinning;
 
 namespace osu.Game.Screens.Play.HUD
@@ -28,19 +24,17 @@ namespace osu.Game.Screens.Play.HUD
     {
         public bool UsesFixedAnchor { get; set; }
 
-        protected override bool IsRollingProportional => true;
-
         protected override double RollingDuration => 750;
 
         private const float alpha_when_invalid = 0.3f;
 
-        private List<double> hitList = new List<double>();
+        private readonly List<double> hitOffsets = new List<double>();
 
+        //May be able to remove the CanBeNull as ScoreProcessor should exist everywhere, for example, in the skin editor it is cached.
         [CanBeNull]
         [Resolved(CanBeNull = true)]
         private ScoreProcessor scoreProcessor { get; set; }
 
-        private readonly CancellationTokenSource loadCancellationSource = new CancellationTokenSource();
         public UnstableRateCounter()
         {
             Current.Value = 0.0;
@@ -56,17 +50,18 @@ namespace osu.Game.Screens.Play.HUD
         {
             base.LoadComplete();
 
-            if (scoreProcessor != null)
-            {
-                scoreProcessor.NewJudgement += onJudgementAdded;
-                scoreProcessor.JudgementReverted += onJudgementChanged;
-            }
+            if (scoreProcessor == null) return;
+
+            scoreProcessor.NewJudgement += onJudgementAdded;
+            scoreProcessor.JudgementReverted += onJudgementReverted;
         }
 
-        private bool isValid = false;
+        private bool isValid;
+
         private void setValid(bool valid)
         {
             if (isValid == valid) return;
+
             DrawableCount.FadeTo(valid ? 1 : alpha_when_invalid, 1000, Easing.OutQuint);
             isValid = valid;
         }
@@ -75,39 +70,46 @@ namespace osu.Game.Screens.Play.HUD
         {
             if (!(judgement.HitObject.HitWindows is HitWindows.EmptyHitWindows) && judgement.IsHit)
             {
-                hitList.Add(judgement.TimeOffset);
+                hitOffsets.Add(judgement.TimeOffset);
             }
-            updateUR();
+
+            updateUr();
         }
 
-        // Only populate via the score if the user has moved the current location.
-        private void onJudgementChanged(JudgementResult judgement)
+        // If a judgement was reverted successfully, remove the item from the hitOffsets list.
+        private void onJudgementReverted(JudgementResult judgement)
         {
-            ScoreInfo currentScore = new ScoreInfo();
-            scoreProcessor.PopulateScore(currentScore);
-            hitList = currentScore.HitEvents.Where(e => !(e.HitObject.HitWindows is HitWindows.EmptyHitWindows) && e.Result.IsHit())
-                                            .Select(ev => ev.TimeOffset).ToList<double>();
-            updateUR();
+            //Score Processor Conditions to revert
+            if (judgement.FailedAtJudgement || !judgement.Type.IsScorable())
+                return;
+            //UR Conditions to Revert
+            if (judgement.HitObject.HitWindows is HitWindows.EmptyHitWindows || !judgement.IsHit)
+                return;
+
+            hitOffsets.RemoveAt(hitOffsets.Count - 1);
+            updateUr();
         }
 
-        private void updateUR()
+        private void updateUr()
         {
-            if (hitList.Count > 1)
+            // At Count = 0, we get NaN, While we are allowing count = 1, it will be 0 since average = offset.
+            if (hitOffsets.Count > 0)
             {
-                double mean = hitList.Average();
-                double squares = hitList.Select(offset => Math.Pow(offset - mean, 2)).Sum();
-                Current.Value = Math.Sqrt(squares / hitList.Count) * 10;
+                double mean = hitOffsets.Average();
+                double squares = hitOffsets.Select(offset => Math.Pow(offset - mean, 2)).Sum();
+                Current.Value = Math.Sqrt(squares / hitOffsets.Count) * 10;
                 setValid(true);
             }
             else
             {
+                Current.Value = 0;
                 setValid(false);
             }
         }
 
         protected override LocalisableString FormatCount(double count)
         {
-            return count.ToString("0.00");
+            return count.ToString("0.00 UR");
         }
 
         protected override IHasText CreateText() => new TextComponent
@@ -119,12 +121,10 @@ namespace osu.Game.Screens.Play.HUD
         {
             base.Dispose(isDisposing);
 
-            if (scoreProcessor != null)
-            {
-                scoreProcessor.NewJudgement -= onJudgementAdded;
-                scoreProcessor.JudgementReverted -= onJudgementChanged;
-            }
-            loadCancellationSource?.Cancel();
+            if (scoreProcessor == null) return;
+
+            scoreProcessor.NewJudgement -= onJudgementAdded;
+            scoreProcessor.JudgementReverted -= onJudgementReverted;
         }
 
         private class TextComponent : CompositeDrawable, IHasText
@@ -132,11 +132,12 @@ namespace osu.Game.Screens.Play.HUD
             public LocalisableString Text
             {
                 get => intPart.Text;
-                set {
+                set
+                {
                     //Not too sure about this, is there a better way to go about doing this?
                     splitValue = value.ToString().Split('.');
                     intPart.Text = splitValue[0];
-                    decimalPart.Text = $".{splitValue[1]} UR";
+                    decimalPart.Text = splitValue[1];
                 }
             }
 
@@ -159,6 +160,14 @@ namespace osu.Game.Screens.Play.HUD
                             Origin = Anchor.BottomLeft,
                             Font = OsuFont.Numeric.With(size: 16, fixedWidth: true)
                         },
+                        new OsuSpriteText
+                        {
+                            Anchor = Anchor.BottomLeft,
+                            Origin = Anchor.BottomLeft,
+                            Font = OsuFont.Numeric.With(size: 8, fixedWidth: true),
+                            Text = ".",
+                            Padding = new MarginPadding { Bottom = 1.5f },
+                        },
                         decimalPart = new OsuSpriteText
                         {
                             Anchor = Anchor.BottomLeft,

From f0caa1006631c08c9f15e665e865b3108543a64c Mon Sep 17 00:00:00 2001
From: Tollii <tolnes@protonmail.com>
Date: Fri, 5 Nov 2021 23:53:48 +0100
Subject: [PATCH 0774/5547] Add support for a provided cancellation token for
 GetPlayableBeatmap()

---
 osu.Game/Beatmaps/IWorkingBeatmap.cs                  | 4 +++-
 osu.Game/Beatmaps/WorkingBeatmap.cs                   | 7 ++++---
 osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs | 2 +-
 3 files changed, 8 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Beatmaps/IWorkingBeatmap.cs b/osu.Game/Beatmaps/IWorkingBeatmap.cs
index a916b37b85..6f0f408060 100644
--- a/osu.Game/Beatmaps/IWorkingBeatmap.cs
+++ b/osu.Game/Beatmaps/IWorkingBeatmap.cs
@@ -4,6 +4,7 @@
 using System;
 using System.Collections.Generic;
 using System.IO;
+using System.Threading;
 using osu.Framework.Audio.Track;
 using osu.Framework.Graphics.Textures;
 using osu.Game.Rulesets;
@@ -57,9 +58,10 @@ namespace osu.Game.Beatmaps
         /// <param name="ruleset">The <see cref="RulesetInfo"/> to create a playable <see cref="IBeatmap"/> for.</param>
         /// <param name="mods">The <see cref="Mod"/>s to apply to the <see cref="IBeatmap"/>.</param>
         /// <param name="timeout">The maximum length in milliseconds to wait for load to complete. Defaults to 10,000ms.</param>
+        /// <param name="cancellationToken">Externally provided cancellation token.</param>
         /// <returns>The converted <see cref="IBeatmap"/>.</returns>
         /// <exception cref="BeatmapInvalidForRulesetException">If <see cref="Beatmap"/> could not be converted to <paramref name="ruleset"/>.</exception>
-        IBeatmap GetPlayableBeatmap(RulesetInfo ruleset, IReadOnlyList<Mod> mods = null, TimeSpan? timeout = null);
+        IBeatmap GetPlayableBeatmap(RulesetInfo ruleset, IReadOnlyList<Mod> mods = null, TimeSpan? timeout = null, CancellationToken cancellationToken = default);
 
         /// <summary>
         /// Load a new audio track instance for this beatmap. This should be called once before accessing <see cref="Track"/>.
diff --git a/osu.Game/Beatmaps/WorkingBeatmap.cs b/osu.Game/Beatmaps/WorkingBeatmap.cs
index d2c0f7de0f..affc19c700 100644
--- a/osu.Game/Beatmaps/WorkingBeatmap.cs
+++ b/osu.Game/Beatmaps/WorkingBeatmap.cs
@@ -81,7 +81,7 @@ namespace osu.Game.Beatmaps
         /// <returns>The applicable <see cref="IBeatmapConverter"/>.</returns>
         protected virtual IBeatmapConverter CreateBeatmapConverter(IBeatmap beatmap, Ruleset ruleset) => ruleset.CreateBeatmapConverter(beatmap);
 
-        public virtual IBeatmap GetPlayableBeatmap(RulesetInfo ruleset, IReadOnlyList<Mod> mods = null, TimeSpan? timeout = null)
+        public virtual IBeatmap GetPlayableBeatmap(RulesetInfo ruleset, IReadOnlyList<Mod> mods = null, TimeSpan? timeout = null, CancellationToken cancellationToken = default)
         {
             using (var cancellationSource = createCancellationTokenSource(timeout))
             {
@@ -105,7 +105,7 @@ namespace osu.Game.Beatmaps
                 }
 
                 // Convert
-                IBeatmap converted = converter.Convert(cancellationSource.Token);
+                IBeatmap converted = converter.Convert(cancellationToken != CancellationToken.None ? cancellationToken : cancellationSource.Token);
 
                 // Apply conversion mods to the result
                 foreach (var mod in mods.OfType<IApplicableAfterBeatmapConversion>())
@@ -143,7 +143,7 @@ namespace osu.Game.Beatmaps
                         if (cancellationSource.IsCancellationRequested)
                             throw new BeatmapLoadTimeoutException(BeatmapInfo);
 
-                        obj.ApplyDefaults(converted.ControlPointInfo, converted.Difficulty, cancellationSource.Token);
+                        obj.ApplyDefaults(converted.ControlPointInfo, converted.Difficulty, cancellationToken != CancellationToken.None ? cancellationToken : cancellationSource.Token);
                     }
                 }
                 catch (OperationCanceledException)
@@ -167,6 +167,7 @@ namespace osu.Game.Beatmaps
                 foreach (var mod in mods.OfType<IApplicableToBeatmap>())
                 {
                     cancellationSource.Token.ThrowIfCancellationRequested();
+                    cancellationToken.ThrowIfCancellationRequested();
                     mod.ApplyToBeatmap(converted);
                 }
 
diff --git a/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs b/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs
index ef289c2a20..922d1e6bbe 100644
--- a/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs
+++ b/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs
@@ -210,7 +210,7 @@ namespace osu.Game.Screens.Play.HUD
                 this.gameplayBeatmap = gameplayBeatmap;
             }
 
-            public override IBeatmap GetPlayableBeatmap(RulesetInfo ruleset, IReadOnlyList<Mod> mods = null, TimeSpan? timeout = null)
+            public override IBeatmap GetPlayableBeatmap(RulesetInfo ruleset, IReadOnlyList<Mod> mods = null, TimeSpan? timeout = null, CancellationToken cancellationToken = default)
                 => gameplayBeatmap;
 
             protected override IBeatmap GetBeatmap() => gameplayBeatmap;

From eb7d04bc77da85ea95461828e0988bd1668d2e58 Mon Sep 17 00:00:00 2001
From: Tollii <tolnes@protonmail.com>
Date: Sat, 6 Nov 2021 00:19:48 +0100
Subject: [PATCH 0775/5547] Add cancellation token support for beatmap
 difficulty calculation.

---
 osu.Game/Beatmaps/BeatmapDifficultyCache.cs    |  9 +++++----
 osu.Game/Beatmaps/BeatmapModelManager.cs       |  2 +-
 .../Difficulty/DifficultyCalculator.cs         | 18 +++++++++++-------
 osu.Game/Stores/BeatmapImporter.cs             |  2 +-
 4 files changed, 18 insertions(+), 13 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapDifficultyCache.cs b/osu.Game/Beatmaps/BeatmapDifficultyCache.cs
index 035f438b89..bbe5ecb0df 100644
--- a/osu.Game/Beatmaps/BeatmapDifficultyCache.cs
+++ b/osu.Game/Beatmaps/BeatmapDifficultyCache.cs
@@ -147,13 +147,13 @@ namespace osu.Game.Beatmaps
                 if (CheckExists(lookup, out var existing))
                     return existing;
 
-                return computeDifficulty(lookup);
+                return computeDifficulty(lookup, token);
             }, token, TaskCreationOptions.HideScheduler | TaskCreationOptions.RunContinuationsAsynchronously, updateScheduler);
         }
 
         public Task<List<TimedDifficultyAttributes>> GetTimedDifficultyAttributesAsync(WorkingBeatmap beatmap, Ruleset ruleset, Mod[] mods, CancellationToken token = default)
         {
-            return Task.Factory.StartNew(() => ruleset.CreateDifficultyCalculator(beatmap).CalculateTimed(mods),
+            return Task.Factory.StartNew(() => ruleset.CreateDifficultyCalculator(beatmap).CalculateTimed(mods, token),
                 token,
                 TaskCreationOptions.HideScheduler | TaskCreationOptions.RunContinuationsAsynchronously,
                 updateScheduler);
@@ -270,8 +270,9 @@ namespace osu.Game.Beatmaps
         /// Computes the difficulty defined by a <see cref="DifficultyCacheLookup"/> key, and stores it to the timed cache.
         /// </summary>
         /// <param name="key">The <see cref="DifficultyCacheLookup"/> that defines the computation parameters.</param>
+        /// <param name="cancellationToken">The cancellation token.</param>
         /// <returns>The <see cref="StarDifficulty"/>.</returns>
-        private StarDifficulty computeDifficulty(in DifficultyCacheLookup key)
+        private StarDifficulty computeDifficulty(in DifficultyCacheLookup key, CancellationToken cancellationToken = default)
         {
             // In the case that the user hasn't given us a ruleset, use the beatmap's default ruleset.
             var beatmapInfo = key.BeatmapInfo;
@@ -283,7 +284,7 @@ namespace osu.Game.Beatmaps
                 Debug.Assert(ruleset != null);
 
                 var calculator = ruleset.CreateDifficultyCalculator(beatmapManager.GetWorkingBeatmap(key.BeatmapInfo));
-                var attributes = calculator.Calculate(key.OrderedMods);
+                var attributes = calculator.Calculate(key.OrderedMods, cancellationToken);
 
                 return new StarDifficulty(attributes);
             }
diff --git a/osu.Game/Beatmaps/BeatmapModelManager.cs b/osu.Game/Beatmaps/BeatmapModelManager.cs
index f148d05aca..2166ae1dfc 100644
--- a/osu.Game/Beatmaps/BeatmapModelManager.cs
+++ b/osu.Game/Beatmaps/BeatmapModelManager.cs
@@ -408,7 +408,7 @@ namespace osu.Game.Beatmaps
                     beatmap.BeatmapInfo.Ruleset = ruleset;
 
                     // TODO: this should be done in a better place once we actually need to dynamically update it.
-                    beatmap.BeatmapInfo.StarDifficulty = ruleset?.CreateInstance().CreateDifficultyCalculator(new DummyConversionBeatmap(beatmap)).Calculate().StarRating ?? 0;
+                    beatmap.BeatmapInfo.StarDifficulty = ruleset?.CreateInstance().CreateDifficultyCalculator(new DummyConversionBeatmap(beatmap)).Calculate(null).StarRating ?? 0;
                     beatmap.BeatmapInfo.Length = calculateLength(beatmap);
                     beatmap.BeatmapInfo.BPM = 60000 / beatmap.GetMostCommonBeatLength();
 
diff --git a/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs b/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs
index 5b4284dc2f..4fc984b491 100644
--- a/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs
+++ b/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs
@@ -4,6 +4,7 @@
 using System;
 using System.Collections.Generic;
 using System.Linq;
+using System.Threading;
 using osu.Framework.Audio.Track;
 using osu.Framework.Extensions.IEnumerableExtensions;
 using osu.Game.Beatmaps;
@@ -39,10 +40,11 @@ namespace osu.Game.Rulesets.Difficulty
         /// Calculates the difficulty of the beatmap using a specific mod combination.
         /// </summary>
         /// <param name="mods">The mods that should be applied to the beatmap.</param>
+        /// <param name="cancellationToken">The cancellation token.</param>
         /// <returns>A structure describing the difficulty of the beatmap.</returns>
-        public DifficultyAttributes Calculate(params Mod[] mods)
+        public DifficultyAttributes Calculate(IEnumerable<Mod> mods, CancellationToken cancellationToken = default)
         {
-            preProcess(mods);
+            preProcess(mods, cancellationToken);
 
             var skills = CreateSkills(Beatmap, playableMods, clockRate);
 
@@ -62,10 +64,11 @@ namespace osu.Game.Rulesets.Difficulty
         /// Calculates the difficulty of the beatmap and returns a set of <see cref="TimedDifficultyAttributes"/> representing the difficulty at every relevant time value in the beatmap.
         /// </summary>
         /// <param name="mods">The mods that should be applied to the beatmap.</param>
+        /// <param name="cancellationToken">The cancellation token.</param>
         /// <returns>The set of <see cref="TimedDifficultyAttributes"/>.</returns>
-        public List<TimedDifficultyAttributes> CalculateTimed(params Mod[] mods)
+        public List<TimedDifficultyAttributes> CalculateTimed(IEnumerable<Mod> mods, CancellationToken cancellationToken = default)
         {
-            preProcess(mods);
+            preProcess(mods, cancellationToken);
 
             var attribs = new List<TimedDifficultyAttributes>();
 
@@ -99,7 +102,7 @@ namespace osu.Game.Rulesets.Difficulty
                 if (combination is MultiMod multi)
                     yield return Calculate(multi.Mods);
                 else
-                    yield return Calculate(combination);
+                    yield return Calculate(new[] { combination });
             }
         }
 
@@ -112,11 +115,12 @@ namespace osu.Game.Rulesets.Difficulty
         /// Performs required tasks before every calculation.
         /// </summary>
         /// <param name="mods">The original list of <see cref="Mod"/>s.</param>
-        private void preProcess(Mod[] mods)
+        /// <param name="cancellationToken">The cancellation cancellationToken.</param>
+        private void preProcess(IEnumerable<Mod> mods, CancellationToken cancellationToken = default)
         {
             playableMods = mods.Select(m => m.DeepClone()).ToArray();
 
-            Beatmap = beatmap.GetPlayableBeatmap(ruleset.RulesetInfo, playableMods);
+            Beatmap = beatmap.GetPlayableBeatmap(ruleset.RulesetInfo, playableMods, cancellationToken: cancellationToken);
 
             var track = new TrackVirtual(10000);
             playableMods.OfType<IApplicableToTrack>().ForEach(m => m.ApplyToTrack(track));
diff --git a/osu.Game/Stores/BeatmapImporter.cs b/osu.Game/Stores/BeatmapImporter.cs
index 787b1ddd60..7916583ce1 100644
--- a/osu.Game/Stores/BeatmapImporter.cs
+++ b/osu.Game/Stores/BeatmapImporter.cs
@@ -284,7 +284,7 @@ namespace osu.Game.Stores
             decoded.BeatmapInfo.Ruleset = rulesetInstance.RulesetInfo;
 
             // TODO: this should be done in a better place once we actually need to dynamically update it.
-            beatmap.StarRating = rulesetInstance.CreateDifficultyCalculator(new DummyConversionBeatmap(decoded)).Calculate().StarRating;
+            beatmap.StarRating = rulesetInstance.CreateDifficultyCalculator(new DummyConversionBeatmap(decoded)).Calculate(null).StarRating;
             beatmap.Length = calculateLength(decoded);
             beatmap.BPM = 60000 / decoded.GetMostCommonBeatLength();
         }

From 2b3907db4b80ea7bd859a85d0bbccb7149f9aec3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 6 Nov 2021 14:33:45 +0900
Subject: [PATCH 0776/5547] Update framework

---
 osu.Android.props        | 2 +-
 osu.Game/osu.Game.csproj | 2 +-
 osu.iOS.props            | 4 ++--
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Android.props b/osu.Android.props
index 6d2e8428a7..4f9f83f199 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -52,7 +52,7 @@
   </ItemGroup>
   <ItemGroup>
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1026.0" />
-    <PackageReference Include="ppy.osu.Framework.Android" Version="2021.1104.0" />
+    <PackageReference Include="ppy.osu.Framework.Android" Version="2021.1106.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
     <!-- Realm needs to be directly referenced in all Xamarin projects, as it will not pull in its transitive dependencies otherwise. -->
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 6dda1f77c6..7811de5764 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="10.6.0" />
-    <PackageReference Include="ppy.osu.Framework" Version="2021.1104.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2021.1106.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1026.0" />
     <PackageReference Include="Sentry" Version="3.10.0" />
     <PackageReference Include="SharpCompress" Version="0.30.0" />
diff --git a/osu.iOS.props b/osu.iOS.props
index df24a57e90..9d95b7c765 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -70,7 +70,7 @@
     <Reference Include="System.Net.Http" />
   </ItemGroup>
   <ItemGroup Label="Package References">
-    <PackageReference Include="ppy.osu.Framework.iOS" Version="2021.1104.0" />
+    <PackageReference Include="ppy.osu.Framework.iOS" Version="2021.1106.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1026.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net5.0 / net6.0) -->
@@ -93,7 +93,7 @@
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="2.2.6" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.Core" Version="2.2.6" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
-    <PackageReference Include="ppy.osu.Framework" Version="2021.1104.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2021.1106.0" />
     <PackageReference Include="SharpCompress" Version="0.30.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
     <PackageReference Include="SharpRaven" Version="2.4.0" />

From b8fb22b769d15a26abdc9a11c0ca9c8840e7b8d7 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 6 Nov 2021 16:45:27 +0900
Subject: [PATCH 0777/5547] Add missing test coverage of score import process
 being tracked correctly

---
 .../Gameplay/TestSceneReplayDownloadButton.cs | 31 +++++++++++++++++++
 1 file changed, 31 insertions(+)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneReplayDownloadButton.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneReplayDownloadButton.cs
index 64d9addc77..e178550298 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneReplayDownloadButton.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneReplayDownloadButton.cs
@@ -11,6 +11,7 @@ using osu.Game.Users;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Testing;
+using osu.Game.Database;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Osu;
@@ -113,6 +114,36 @@ namespace osu.Game.Tests.Visual.Gameplay
             AddAssert("button is not enabled", () => !downloadButton.ChildrenOfType<DownloadButton>().First().Enabled.Value);
         }
 
+        [Resolved]
+        private ScoreManager scoreManager { get; set; }
+
+        [Test]
+        public void TestScoreImportThenDelete()
+        {
+            ILive<ScoreInfo> imported = null;
+
+            AddStep("create button without replay", () =>
+            {
+                Child = downloadButton = new TestReplayDownloadButton(getScoreInfo(false))
+                {
+                    Anchor = Anchor.Centre,
+                    Origin = Anchor.Centre,
+                };
+            });
+
+            AddUntilStep("wait for load", () => downloadButton.IsLoaded);
+
+            AddUntilStep("state is not downloaded", () => downloadButton.State.Value == DownloadState.NotDownloaded);
+
+            AddStep("import score", () => imported = scoreManager.Import(getScoreInfo(true)).Result);
+
+            AddUntilStep("state is available", () => downloadButton.State.Value == DownloadState.LocallyAvailable);
+
+            AddStep("delete score", () => scoreManager.Delete(imported.Value));
+
+            AddUntilStep("state is not downloaded", () => downloadButton.State.Value == DownloadState.NotDownloaded);
+        }
+
         [Test]
         public void CreateButtonWithNoScore()
         {

From 96ef210a4dda4b4b4fd6a78b3005a39590bd3262 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 6 Nov 2021 16:38:42 +0900
Subject: [PATCH 0778/5547] Fix backward state set

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

diff --git a/osu.Game/Online/ScoreDownloadTracker.cs b/osu.Game/Online/ScoreDownloadTracker.cs
index 554aaba39d..32307fc50e 100644
--- a/osu.Game/Online/ScoreDownloadTracker.cs
+++ b/osu.Game/Online/ScoreDownloadTracker.cs
@@ -107,7 +107,7 @@ namespace osu.Game.Online
         private void itemRemoved(ScoreInfo item) => Schedule(() =>
         {
             if (checkEquality(item, TrackedItem))
-                UpdateState(DownloadState.LocallyAvailable);
+                UpdateState(DownloadState.NotDownloaded);
         });
 
         private bool checkEquality(IScoreInfo x, IScoreInfo y) => x.OnlineID == y.OnlineID;

From 89cc2523efbc3b4e62f395f55401d2144b624df8 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 6 Nov 2021 22:31:49 +0900
Subject: [PATCH 0779/5547] Fix incorrectly specified events

---
 osu.Game/Beatmaps/BeatmapManager.cs      | 24 ++++++++++++------------
 osu.Game/Database/ArchiveModelManager.cs |  4 ++--
 osu.Game/Database/IModelDownloader.cs    |  4 ++--
 osu.Game/Database/IModelManager.cs       |  4 ++--
 osu.Game/Database/ModelDownloader.cs     |  4 ++--
 osu.Game/Scoring/ScoreManager.cs         | 24 ++++++++++++------------
 6 files changed, 32 insertions(+), 32 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index da0c379f90..0f2cf6a730 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -205,16 +205,16 @@ namespace osu.Game.Beatmaps
             return beatmapModelManager.IsAvailableLocally(model);
         }
 
-        public Action<BeatmapSetInfo> ItemUpdated
+        public event Action<BeatmapSetInfo> ItemUpdated
         {
-            get => beatmapModelManager.ItemUpdated;
-            set => beatmapModelManager.ItemUpdated = value;
+            add => beatmapModelManager.ItemUpdated += value;
+            remove => beatmapModelManager.ItemUpdated -= value;
         }
 
-        public Action<BeatmapSetInfo> ItemRemoved
+        public event Action<BeatmapSetInfo> ItemRemoved
         {
-            get => beatmapModelManager.ItemRemoved;
-            set => beatmapModelManager.ItemRemoved = value;
+            add => beatmapModelManager.ItemRemoved += value;
+            remove => beatmapModelManager.ItemRemoved -= value;
         }
 
         public Task ImportFromStableAsync(StableStorage stableStorage)
@@ -261,16 +261,16 @@ namespace osu.Game.Beatmaps
 
         #region Implementation of IModelDownloader<BeatmapSetInfo>
 
-        public Action<ArchiveDownloadRequest<IBeatmapSetInfo>> DownloadBegan
+        public event Action<ArchiveDownloadRequest<IBeatmapSetInfo>> DownloadBegan
         {
-            get => beatmapModelDownloader.DownloadBegan;
-            set => beatmapModelDownloader.DownloadBegan = value;
+            add => beatmapModelDownloader.DownloadBegan += value;
+            remove => beatmapModelDownloader.DownloadBegan -= value;
         }
 
-        public Action<ArchiveDownloadRequest<IBeatmapSetInfo>> DownloadFailed
+        public event Action<ArchiveDownloadRequest<IBeatmapSetInfo>> DownloadFailed
         {
-            get => beatmapModelDownloader.DownloadFailed;
-            set => beatmapModelDownloader.DownloadFailed = value;
+            add => beatmapModelDownloader.DownloadFailed += value;
+            remove => beatmapModelDownloader.DownloadFailed -= value;
         }
 
         public bool Download(IBeatmapSetInfo model, bool minimiseDownloadSize = false)
diff --git a/osu.Game/Database/ArchiveModelManager.cs b/osu.Game/Database/ArchiveModelManager.cs
index 85419aeedb..019749760f 100644
--- a/osu.Game/Database/ArchiveModelManager.cs
+++ b/osu.Game/Database/ArchiveModelManager.cs
@@ -62,13 +62,13 @@ namespace osu.Game.Database
         /// Fired when a new or updated <typeparamref name="TModel"/> becomes available in the database.
         /// This is not guaranteed to run on the update thread.
         /// </summary>
-        public Action<TModel> ItemUpdated { get; set; }
+        public event Action<TModel> ItemUpdated;
 
         /// <summary>
         /// Fired when a <typeparamref name="TModel"/> is removed from the database.
         /// This is not guaranteed to run on the update thread.
         /// </summary>
-        public Action<TModel> ItemRemoved { get; set; }
+        public event Action<TModel> ItemRemoved;
 
         public virtual IEnumerable<string> HandledExtensions => new[] { @".zip" };
 
diff --git a/osu.Game/Database/IModelDownloader.cs b/osu.Game/Database/IModelDownloader.cs
index d8e3dad8b5..81fba14244 100644
--- a/osu.Game/Database/IModelDownloader.cs
+++ b/osu.Game/Database/IModelDownloader.cs
@@ -17,13 +17,13 @@ namespace osu.Game.Database
         /// Fired when a <typeparamref name="T"/> download begins.
         /// This is NOT run on the update thread and should be scheduled.
         /// </summary>
-        Action<ArchiveDownloadRequest<T>> DownloadBegan { get; set; }
+        event Action<ArchiveDownloadRequest<T>> DownloadBegan;
 
         /// <summary>
         /// Fired when a <typeparamref name="T"/> download is interrupted, either due to user cancellation or failure.
         /// This is NOT run on the update thread and should be scheduled.
         /// </summary>
-        Action<ArchiveDownloadRequest<T>> DownloadFailed { get; set; }
+        event Action<ArchiveDownloadRequest<T>> DownloadFailed;
 
         /// <summary>
         /// Begin a download for the requested <typeparamref name="T"/>.
diff --git a/osu.Game/Database/IModelManager.cs b/osu.Game/Database/IModelManager.cs
index c9257f5877..15ad455f21 100644
--- a/osu.Game/Database/IModelManager.cs
+++ b/osu.Game/Database/IModelManager.cs
@@ -19,12 +19,12 @@ namespace osu.Game.Database
         /// <summary>
         /// Fired when an item is updated.
         /// </summary>
-        Action<TModel> ItemUpdated { get; set; }
+        event Action<TModel> ItemUpdated;
 
         /// <summary>
         /// Fired when an item is removed.
         /// </summary>
-        Action<TModel> ItemRemoved { get; set; }
+        event Action<TModel> ItemRemoved;
 
         /// <summary>
         /// This is a temporary method and will likely be replaced by a full-fledged (and more correctly placed) migration process in the future.
diff --git a/osu.Game/Database/ModelDownloader.cs b/osu.Game/Database/ModelDownloader.cs
index 3684dea456..3c1f181f24 100644
--- a/osu.Game/Database/ModelDownloader.cs
+++ b/osu.Game/Database/ModelDownloader.cs
@@ -19,9 +19,9 @@ namespace osu.Game.Database
     {
         public Action<Notification> PostNotification { protected get; set; }
 
-        public Action<ArchiveDownloadRequest<T>> DownloadBegan { get; set; }
+        public event Action<ArchiveDownloadRequest<T>> DownloadBegan;
 
-        public Action<ArchiveDownloadRequest<T>> DownloadFailed { get; set; }
+        public event Action<ArchiveDownloadRequest<T>> DownloadFailed;
 
         private readonly IModelImporter<TModel> importer;
         private readonly IAPIProvider api;
diff --git a/osu.Game/Scoring/ScoreManager.cs b/osu.Game/Scoring/ScoreManager.cs
index 0cb5ae2236..9b4216084e 100644
--- a/osu.Game/Scoring/ScoreManager.cs
+++ b/osu.Game/Scoring/ScoreManager.cs
@@ -246,16 +246,16 @@ namespace osu.Game.Scoring
 
         #region Implementation of IModelManager<ScoreInfo>
 
-        public Action<ScoreInfo> ItemUpdated
+        public event Action<ScoreInfo> ItemUpdated
         {
-            get => scoreModelManager.ItemUpdated;
-            set => scoreModelManager.ItemUpdated = value;
+            add => scoreModelManager.ItemUpdated += value;
+            remove => scoreModelManager.ItemUpdated -= value;
         }
 
-        public Action<ScoreInfo> ItemRemoved
+        public event Action<ScoreInfo> ItemRemoved
         {
-            get => scoreModelManager.ItemRemoved;
-            set => scoreModelManager.ItemRemoved = value;
+            add => scoreModelManager.ItemRemoved += value;
+            remove => scoreModelManager.ItemRemoved -= value;
         }
 
         public Task ImportFromStableAsync(StableStorage stableStorage)
@@ -358,16 +358,16 @@ namespace osu.Game.Scoring
 
         #region Implementation of IModelDownloader<IScoreInfo>
 
-        public Action<ArchiveDownloadRequest<IScoreInfo>> DownloadBegan
+        public event Action<ArchiveDownloadRequest<IScoreInfo>> DownloadBegan
         {
-            get => scoreModelDownloader.DownloadBegan;
-            set => scoreModelDownloader.DownloadBegan = value;
+            add => scoreModelDownloader.DownloadBegan += value;
+            remove => scoreModelDownloader.DownloadBegan -= value;
         }
 
-        public Action<ArchiveDownloadRequest<IScoreInfo>> DownloadFailed
+        public event Action<ArchiveDownloadRequest<IScoreInfo>> DownloadFailed
         {
-            get => scoreModelDownloader.DownloadFailed;
-            set => scoreModelDownloader.DownloadFailed = value;
+            add => scoreModelDownloader.DownloadFailed += value;
+            remove => scoreModelDownloader.DownloadFailed -= value;
         }
 
         public bool Download(IScoreInfo model, bool minimiseDownloadSize) =>

From c40f88749209b7cfd06b9f67a74c345fda3186bc Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 6 Nov 2021 15:20:29 +0100
Subject: [PATCH 0780/5547] Remove unnecessary local variable

---
 .../Overlays/Changelog/ChangelogHeader.cs     | 39 ++++++++-----------
 1 file changed, 17 insertions(+), 22 deletions(-)

diff --git a/osu.Game/Overlays/Changelog/ChangelogHeader.cs b/osu.Game/Overlays/Changelog/ChangelogHeader.cs
index 4a94666031..49a33ee5d6 100644
--- a/osu.Game/Overlays/Changelog/ChangelogHeader.cs
+++ b/osu.Game/Overlays/Changelog/ChangelogHeader.cs
@@ -75,34 +75,29 @@ namespace osu.Game.Overlays.Changelog
 
         protected override Drawable CreateBackground() => new OverlayHeaderBackground(@"Headers/changelog");
 
-        protected override Drawable CreateContent()
+        protected override Drawable CreateContent() => new Container
         {
-            var content = new Container
+            RelativeSizeAxes = Axes.X,
+            AutoSizeAxes = Axes.Y,
+            Children = new Drawable[]
             {
-                RelativeSizeAxes = Axes.X,
-                AutoSizeAxes = Axes.Y,
-                Children = new Drawable[]
+                streamsBackground = new Box
                 {
-                    streamsBackground = new Box
+                    RelativeSizeAxes = Axes.Both
+                },
+                new Container
+                {
+                    RelativeSizeAxes = Axes.X,
+                    AutoSizeAxes = Axes.Y,
+                    Padding = new MarginPadding
                     {
-                        RelativeSizeAxes = Axes.Both
+                        Horizontal = 65,
+                        Vertical = 20
                     },
-                    new Container
-                    {
-                        RelativeSizeAxes = Axes.X,
-                        AutoSizeAxes = Axes.Y,
-                        Padding = new MarginPadding
-                        {
-                            Horizontal = 65,
-                            Vertical = 20
-                        },
-                        Child = Streams = new ChangelogUpdateStreamControl { Current = currentStream },
-                    }
+                    Child = Streams = new ChangelogUpdateStreamControl { Current = currentStream },
                 }
-            };
-
-            return content;
-        }
+            }
+        };
 
         protected override OverlayTitle CreateTitle() => new ChangelogHeaderTitle();
 

From cf0b757b16f8369efd82968b6357aafe120e8549 Mon Sep 17 00:00:00 2001
From: Tollii <tolnes@protonmail.com>
Date: Sat, 6 Nov 2021 16:03:53 +0100
Subject: [PATCH 0781/5547] Fix PR comments. Nitpick, more cancellation token
 checks.

---
 osu.Game/Beatmaps/BeatmapModelManager.cs      |  2 +-
 osu.Game/Beatmaps/IWorkingBeatmap.cs          |  4 ++--
 osu.Game/Beatmaps/WorkingBeatmap.cs           | 24 +++++++++----------
 .../Difficulty/DifficultyCalculator.cs        | 18 ++++++++++----
 .../Play/HUD/PerformancePointsCounter.cs      |  2 +-
 osu.Game/Stores/BeatmapImporter.cs            |  2 +-
 6 files changed, 30 insertions(+), 22 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapModelManager.cs b/osu.Game/Beatmaps/BeatmapModelManager.cs
index 2166ae1dfc..f148d05aca 100644
--- a/osu.Game/Beatmaps/BeatmapModelManager.cs
+++ b/osu.Game/Beatmaps/BeatmapModelManager.cs
@@ -408,7 +408,7 @@ namespace osu.Game.Beatmaps
                     beatmap.BeatmapInfo.Ruleset = ruleset;
 
                     // TODO: this should be done in a better place once we actually need to dynamically update it.
-                    beatmap.BeatmapInfo.StarDifficulty = ruleset?.CreateInstance().CreateDifficultyCalculator(new DummyConversionBeatmap(beatmap)).Calculate(null).StarRating ?? 0;
+                    beatmap.BeatmapInfo.StarDifficulty = ruleset?.CreateInstance().CreateDifficultyCalculator(new DummyConversionBeatmap(beatmap)).Calculate().StarRating ?? 0;
                     beatmap.BeatmapInfo.Length = calculateLength(beatmap);
                     beatmap.BeatmapInfo.BPM = 60000 / beatmap.GetMostCommonBeatLength();
 
diff --git a/osu.Game/Beatmaps/IWorkingBeatmap.cs b/osu.Game/Beatmaps/IWorkingBeatmap.cs
index 6f0f408060..3bbfb2a889 100644
--- a/osu.Game/Beatmaps/IWorkingBeatmap.cs
+++ b/osu.Game/Beatmaps/IWorkingBeatmap.cs
@@ -58,10 +58,10 @@ namespace osu.Game.Beatmaps
         /// <param name="ruleset">The <see cref="RulesetInfo"/> to create a playable <see cref="IBeatmap"/> for.</param>
         /// <param name="mods">The <see cref="Mod"/>s to apply to the <see cref="IBeatmap"/>.</param>
         /// <param name="timeout">The maximum length in milliseconds to wait for load to complete. Defaults to 10,000ms.</param>
-        /// <param name="cancellationToken">Externally provided cancellation token.</param>
+        /// <param name="timeoutToken">Cancellation token that cancels the beatmap loading process.</param>
         /// <returns>The converted <see cref="IBeatmap"/>.</returns>
         /// <exception cref="BeatmapInvalidForRulesetException">If <see cref="Beatmap"/> could not be converted to <paramref name="ruleset"/>.</exception>
-        IBeatmap GetPlayableBeatmap(RulesetInfo ruleset, IReadOnlyList<Mod> mods = null, TimeSpan? timeout = null, CancellationToken cancellationToken = default);
+        IBeatmap GetPlayableBeatmap(RulesetInfo ruleset, IReadOnlyList<Mod> mods = null, TimeSpan? timeout = null, CancellationToken timeoutToken = default);
 
         /// <summary>
         /// Load a new audio track instance for this beatmap. This should be called once before accessing <see cref="Track"/>.
diff --git a/osu.Game/Beatmaps/WorkingBeatmap.cs b/osu.Game/Beatmaps/WorkingBeatmap.cs
index affc19c700..e0c2ae7873 100644
--- a/osu.Game/Beatmaps/WorkingBeatmap.cs
+++ b/osu.Game/Beatmaps/WorkingBeatmap.cs
@@ -81,9 +81,10 @@ namespace osu.Game.Beatmaps
         /// <returns>The applicable <see cref="IBeatmapConverter"/>.</returns>
         protected virtual IBeatmapConverter CreateBeatmapConverter(IBeatmap beatmap, Ruleset ruleset) => ruleset.CreateBeatmapConverter(beatmap);
 
-        public virtual IBeatmap GetPlayableBeatmap(RulesetInfo ruleset, IReadOnlyList<Mod> mods = null, TimeSpan? timeout = null, CancellationToken cancellationToken = default)
+        public virtual IBeatmap GetPlayableBeatmap(RulesetInfo ruleset, IReadOnlyList<Mod> mods = null, TimeSpan? timeout = null, CancellationToken timeoutToken = default)
         {
-            using (var cancellationSource = createCancellationTokenSource(timeout))
+            using (var timeoutSource = createTimeoutTokenSource(timeout))
+            using (var linkedTokenSource = CancellationTokenSource.CreateLinkedTokenSource(timeoutToken, timeoutSource.Token))
             {
                 mods ??= Array.Empty<Mod>();
 
@@ -98,19 +99,19 @@ namespace osu.Game.Beatmaps
                 // Apply conversion mods
                 foreach (var mod in mods.OfType<IApplicableToBeatmapConverter>())
                 {
-                    if (cancellationSource.IsCancellationRequested)
+                    if (linkedTokenSource.IsCancellationRequested)
                         throw new BeatmapLoadTimeoutException(BeatmapInfo);
 
                     mod.ApplyToBeatmapConverter(converter);
                 }
 
                 // Convert
-                IBeatmap converted = converter.Convert(cancellationToken != CancellationToken.None ? cancellationToken : cancellationSource.Token);
+                IBeatmap converted = converter.Convert(linkedTokenSource.Token);
 
                 // Apply conversion mods to the result
                 foreach (var mod in mods.OfType<IApplicableAfterBeatmapConversion>())
                 {
-                    if (cancellationSource.IsCancellationRequested)
+                    if (linkedTokenSource.IsCancellationRequested)
                         throw new BeatmapLoadTimeoutException(BeatmapInfo);
 
                     mod.ApplyToBeatmap(converted);
@@ -121,7 +122,7 @@ namespace osu.Game.Beatmaps
                 {
                     foreach (var mod in mods.OfType<IApplicableToDifficulty>())
                     {
-                        if (cancellationSource.IsCancellationRequested)
+                        if (linkedTokenSource.IsCancellationRequested)
                             throw new BeatmapLoadTimeoutException(BeatmapInfo);
 
                         mod.ApplyToDifficulty(converted.Difficulty);
@@ -140,10 +141,10 @@ namespace osu.Game.Beatmaps
                 {
                     foreach (var obj in converted.HitObjects)
                     {
-                        if (cancellationSource.IsCancellationRequested)
+                        if (linkedTokenSource.IsCancellationRequested)
                             throw new BeatmapLoadTimeoutException(BeatmapInfo);
 
-                        obj.ApplyDefaults(converted.ControlPointInfo, converted.Difficulty, cancellationToken != CancellationToken.None ? cancellationToken : cancellationSource.Token);
+                        obj.ApplyDefaults(converted.ControlPointInfo, converted.Difficulty, linkedTokenSource.Token);
                     }
                 }
                 catch (OperationCanceledException)
@@ -155,7 +156,7 @@ namespace osu.Game.Beatmaps
                 {
                     foreach (var obj in converted.HitObjects)
                     {
-                        if (cancellationSource.IsCancellationRequested)
+                        if (linkedTokenSource.IsCancellationRequested)
                             throw new BeatmapLoadTimeoutException(BeatmapInfo);
 
                         mod.ApplyToHitObject(obj);
@@ -166,8 +167,7 @@ namespace osu.Game.Beatmaps
 
                 foreach (var mod in mods.OfType<IApplicableToBeatmap>())
                 {
-                    cancellationSource.Token.ThrowIfCancellationRequested();
-                    cancellationToken.ThrowIfCancellationRequested();
+                    linkedTokenSource.Token.ThrowIfCancellationRequested();
                     mod.ApplyToBeatmap(converted);
                 }
 
@@ -200,7 +200,7 @@ namespace osu.Game.Beatmaps
             }
         }
 
-        private CancellationTokenSource createCancellationTokenSource(TimeSpan? timeout)
+        private CancellationTokenSource createTimeoutTokenSource(TimeSpan? timeout)
         {
             if (Debugger.IsAttached)
                 // ignore timeout when debugger is attached (may be breakpointing / debugging).
diff --git a/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs b/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs
index 4fc984b491..ffad6131be 100644
--- a/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs
+++ b/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs
@@ -42,8 +42,9 @@ namespace osu.Game.Rulesets.Difficulty
         /// <param name="mods">The mods that should be applied to the beatmap.</param>
         /// <param name="cancellationToken">The cancellation token.</param>
         /// <returns>A structure describing the difficulty of the beatmap.</returns>
-        public DifficultyAttributes Calculate(IEnumerable<Mod> mods, CancellationToken cancellationToken = default)
+        public DifficultyAttributes Calculate(IEnumerable<Mod> mods = null, CancellationToken cancellationToken = default)
         {
+            cancellationToken.ThrowIfCancellationRequested();
             preProcess(mods, cancellationToken);
 
             var skills = CreateSkills(Beatmap, playableMods, clockRate);
@@ -54,7 +55,10 @@ namespace osu.Game.Rulesets.Difficulty
             foreach (var hitObject in getDifficultyHitObjects())
             {
                 foreach (var skill in skills)
+                {
+                    cancellationToken.ThrowIfCancellationRequested();
                     skill.ProcessInternal(hitObject);
+                }
             }
 
             return CreateDifficultyAttributes(Beatmap, playableMods, skills, clockRate);
@@ -68,6 +72,7 @@ namespace osu.Game.Rulesets.Difficulty
         /// <returns>The set of <see cref="TimedDifficultyAttributes"/>.</returns>
         public List<TimedDifficultyAttributes> CalculateTimed(IEnumerable<Mod> mods, CancellationToken cancellationToken = default)
         {
+            cancellationToken.ThrowIfCancellationRequested();
             preProcess(mods, cancellationToken);
 
             var attribs = new List<TimedDifficultyAttributes>();
@@ -83,7 +88,10 @@ namespace osu.Game.Rulesets.Difficulty
                 progressiveBeatmap.HitObjects.Add(hitObject.BaseObject);
 
                 foreach (var skill in skills)
+                {
+                    cancellationToken.ThrowIfCancellationRequested();
                     skill.ProcessInternal(hitObject);
+                }
 
                 attribs.Add(new TimedDifficultyAttributes(hitObject.EndTime * clockRate, CreateDifficultyAttributes(progressiveBeatmap, playableMods, skills, clockRate)));
             }
@@ -102,7 +110,7 @@ namespace osu.Game.Rulesets.Difficulty
                 if (combination is MultiMod multi)
                     yield return Calculate(multi.Mods);
                 else
-                    yield return Calculate(new[] { combination });
+                    yield return Calculate(combination.Yield());
             }
         }
 
@@ -115,12 +123,12 @@ namespace osu.Game.Rulesets.Difficulty
         /// Performs required tasks before every calculation.
         /// </summary>
         /// <param name="mods">The original list of <see cref="Mod"/>s.</param>
-        /// <param name="cancellationToken">The cancellation cancellationToken.</param>
-        private void preProcess(IEnumerable<Mod> mods, CancellationToken cancellationToken = default)
+        /// <param name="cancellationToken">The cancellation timeoutToken.</param>
+        private void preProcess(IEnumerable<Mod> mods = null, CancellationToken cancellationToken = default)
         {
             playableMods = mods.Select(m => m.DeepClone()).ToArray();
 
-            Beatmap = beatmap.GetPlayableBeatmap(ruleset.RulesetInfo, playableMods, cancellationToken: cancellationToken);
+            Beatmap = beatmap.GetPlayableBeatmap(ruleset.RulesetInfo, playableMods, timeoutToken: cancellationToken);
 
             var track = new TrackVirtual(10000);
             playableMods.OfType<IApplicableToTrack>().ForEach(m => m.ApplyToTrack(track));
diff --git a/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs b/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs
index 922d1e6bbe..bd06e71304 100644
--- a/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs
+++ b/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs
@@ -210,7 +210,7 @@ namespace osu.Game.Screens.Play.HUD
                 this.gameplayBeatmap = gameplayBeatmap;
             }
 
-            public override IBeatmap GetPlayableBeatmap(RulesetInfo ruleset, IReadOnlyList<Mod> mods = null, TimeSpan? timeout = null, CancellationToken cancellationToken = default)
+            public override IBeatmap GetPlayableBeatmap(RulesetInfo ruleset, IReadOnlyList<Mod> mods = null, TimeSpan? timeout = null, CancellationToken timeoutToken = default)
                 => gameplayBeatmap;
 
             protected override IBeatmap GetBeatmap() => gameplayBeatmap;
diff --git a/osu.Game/Stores/BeatmapImporter.cs b/osu.Game/Stores/BeatmapImporter.cs
index 7916583ce1..787b1ddd60 100644
--- a/osu.Game/Stores/BeatmapImporter.cs
+++ b/osu.Game/Stores/BeatmapImporter.cs
@@ -284,7 +284,7 @@ namespace osu.Game.Stores
             decoded.BeatmapInfo.Ruleset = rulesetInstance.RulesetInfo;
 
             // TODO: this should be done in a better place once we actually need to dynamically update it.
-            beatmap.StarRating = rulesetInstance.CreateDifficultyCalculator(new DummyConversionBeatmap(decoded)).Calculate(null).StarRating;
+            beatmap.StarRating = rulesetInstance.CreateDifficultyCalculator(new DummyConversionBeatmap(decoded)).Calculate().StarRating;
             beatmap.Length = calculateLength(decoded);
             beatmap.BPM = 60000 / decoded.GetMostCommonBeatLength();
         }

From 3e08772660ef53624a8ccc8359897b8cb6d230a1 Mon Sep 17 00:00:00 2001
From: Xexxar <xexxar.xexxar@gmail.com>
Date: Sat, 6 Nov 2021 19:16:58 +0000
Subject: [PATCH 0782/5547] updated slider to use lazytraveldistance code
 location

---
 .../Preprocessing/OsuDifficultyHitObject.cs   | 138 +++++++-----------
 1 file changed, 56 insertions(+), 82 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
index b1de132aa7..92b50412d9 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
@@ -14,7 +14,8 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
     {
         private const int normalized_radius = 50; // Change radius to 50 to make 100 the diameter. Easier for mental maths.
         private const int min_delta_time = 25;
-        private const int minimum_slider_radius = normalized_radius * 2.4;
+        private const float maximum_slider_radius = normalized_radius * 2.4f;
+        private const float assumed_slider_radius = normalized_radius * 1.6f;
 
         protected new OsuHitObject BaseObject => (OsuHitObject)base.BaseObject;
 
@@ -90,63 +91,9 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
             if (lastObject is Slider lastSlider)
             {
                 computeSliderCursorPosition(lastSlider);
-                TravelDistance = 0;
+                TravelDistance = lastSlider.LazyTravelDistance;
                 TravelTime = Math.Max(lastSlider.LazyTravelTime / clockRate, min_delta_time);
                 MovementTime = Math.Max(StrainTime - TravelTime, min_delta_time);
-                MovementDistance = Vector2.Subtract(lastSlider.TailCircle.StackedPosition, BaseObject.StackedPosition).Length * scalingFactor;
-
-                int repeatCount = 0;
-
-                Vector2 currSliderPosition = ((OsuHitObject)lastSlider.NestedHitObjects[0]).StackedPosition;
-
-                for (int i = 1; i < lastSlider.NestedHitObjects.Count; i++)
-                {
-                    var currSliderObj = (OsuHitObject)lastSlider.NestedHitObjects[i];
-
-                    Vector2 currSlider = Vector2.Subtract(currSliderObj.StackedPosition, currSliderPosition);
-                    double currSliderLength = currSlider.Length * scalingFactor;
-
-                    if (currSliderObj is SliderEndCircle && !(currSliderObj is SliderRepeat))
-                    {
-                        Vector2 lazySlider = Vector2.Subtract((Vector2)lastSlider.LazyEndPosition, currSliderPosition);
-                        if (lazySlider.Length < currSlider.Length)
-                            currSlider = lazySlider; // Take the least distance from slider end vs lazy end.
-
-                        currSliderLength = currSlider.Length * scalingFactor;
-                    }
-
-                    if (currSliderObj is SliderTick)
-                    {
-                        if (currSliderLength > minimum_slider_radius) // minimum_slider_radius is used here as 120 = 2.4 * radius, which means that the cursor assumes the position of least movement required to reach the active tick window.
-                        {
-                            currSliderPosition = Vector2.Add(currSliderPosition, Vector2.Multiply(currSlider, (float)((currSliderLength - minimum_slider_radius) / currSliderLength)));
-                            currSliderLength *= (currSliderLength - minimum_slider_radius) / currSliderLength;
-                        }
-                        else
-                            currSliderLength = 0;
-                    }
-                    else if (currSliderObj is SliderRepeat)
-                    {
-                        if (currSliderLength > normalized_radius) // normalized_radius is used here as 50 = radius. This is a way to reward motion of back and forths sliders where we assume the player moves to atleast the rim of the hitcircle.
-                        {
-                            currSliderPosition = Vector2.Add(currSliderPosition, Vector2.Multiply(currSlider, (float)((currSliderLength - normalized_radius) / currSliderLength)));
-                            currSliderLength *= (currSliderLength - normalized_radius) / currSliderLength;
-                        }
-                        else
-                            currSliderLength = 0;
-                    }
-                    else
-                    {
-                        currSliderPosition = Vector2.Add(currSliderPosition, currSlider);
-                    }
-
-                    if (currSliderObj is SliderRepeat)
-                        repeatCount++;
-
-                    TravelDistance += currSliderLength;
-                }
-
-                TravelDistance *= Math.Pow(1 + repeatCount / 2.5, 1.0 / 2.5); // Bonus for repeat sliders until a better per nested object strain system can be achieved.
 
                 // Jump distance from the slider tail to the next object, as opposed to the lazy position of JumpDistance.
                 float tailJumpDistance = Vector2.Subtract(lastSlider.TailCircle.StackedPosition, BaseObject.StackedPosition).Length * scalingFactor;
@@ -155,8 +102,8 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
                 // such that they're not jumping from the lazy position but rather from very close to (or the end of) the slider.
                 // In such cases, a leniency is applied by also considering the jump distance from the tail of the slider, and taking the minimum jump distance.
                 // Additional distance is removed based on position of jump relative to slider follow circle radius.
-                // JumpDistance is normalized_radius because lazyCursorPos uses a tighter 1.4 followCircle. tailJumpDistance is minimum_slider_radius since the full distance of radial leniency is still possible.
-                MovementDistance = Math.Max(0, Math.Min(JumpDistance - normalized_radius, tailJumpDistance - 120));
+                // JumpDistance is the distance beyond the s. tailJumpDistance is maximum_slider_radius since the full distance of radial leniency is still possible.
+                MovementDistance = Math.Max(0, Math.Min(JumpDistance - (maximum_slider_radius - assumed_slider_radius), tailJumpDistance - maximum_slider_radius));
             }
             else
             {
@@ -183,37 +130,64 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
             if (slider.LazyEndPosition != null)
                 return;
 
-            slider.LazyEndPosition = slider.StackedPosition;
+            slider.LazyTravelTime = slider.NestedHitObjects[slider.NestedHitObjects.Count - 1].StartTime - slider.StartTime;
 
-            float approxFollowCircleRadius = (float)(slider.Radius * 1.4); // using 1.4 to better follow the real movement of a cursor.
-            var computeVertex = new Action<double>(t =>
-            {
-                double progress = (t - slider.StartTime) / slider.SpanDuration;
-                if (progress % 2 >= 1)
-                    progress = 1 - progress % 1;
+            double endTimeMin = slider.LazyTravelTime / slider.SpanDuration;
+                if (endTimeMin % 2 >= 1)
+                    endTimeMin = 1 - endTimeMin % 1;
                 else
-                    progress %= 1;
+                    endTimeMin %= 1;
 
-                // ReSharper disable once PossibleInvalidOperationException (bugged in current r# version)
-                var diff = slider.StackedPosition + slider.Path.PositionAt(progress) - slider.LazyEndPosition.Value;
-                float dist = diff.Length;
+            slider.LazyEndPosition = slider.StackedPosition + slider.Path.PositionAt(endTimeMin); // temporary lazy end position until a real result can be derived.
+            var currCursorPosition = slider.StackedPosition;
+            double scalingFactor = normalized_radius / slider.Radius; // lazySliderDistance is coded to be sensitive to scaling, this makes the maths easier with the thresholds being used.
 
-                slider.LazyTravelTime = t - slider.StartTime;
+            for (int i = 1; i < slider.NestedHitObjects.Count; i++)
+            {
+                var currMovementObj = (OsuHitObject)slider.NestedHitObjects[i];
 
-                if (dist > approxFollowCircleRadius)
+                Vector2 currMovement = Vector2.Subtract(currMovementObj.StackedPosition, currCursorPosition);
+                double currMovementLength = scalingFactor * currMovement.Length;
+
+                if (i == slider.NestedHitObjects.Count - 1)
                 {
-                    // The cursor would be outside the follow circle, we need to move it
-                    diff.Normalize(); // Obtain direction of diff
-                    dist -= approxFollowCircleRadius;
-                    slider.LazyEndPosition += diff * dist;
-                    slider.LazyTravelDistance += dist;
-                }
-            });
+                    // The end of a slider has special aim rules due to the relaxed time constraint on position.
+                    // There is both a lazy end position as well as the actual end slider position. We assume the player takes the simpler movement.
+                    // For sliders that are circular, the lazy end position may actually be farther away than the sliders true end.
+                    // This code is designed to prevent buffing situations where lazy end is actually a less efficient movement.
+                    Vector2 lazyMovement = Vector2.Subtract((Vector2)slider.LazyEndPosition, currCursorPosition);
 
-            // Skip the head circle
-            var scoringTimes = slider.NestedHitObjects.Skip(1).Select(t => t.StartTime);
-            foreach (double time in scoringTimes)
-                computeVertex(time);
+                    if (lazyMovement.Length < currMovement.Length)
+                        currMovement = lazyMovement;
+
+                    currMovementLength = scalingFactor * currMovement.Length;
+
+                    if (currMovementLength > assumed_slider_radius)
+                    {
+                        // Calculate the vector movement, regardless of final location to get the true lazy end position.
+                        currCursorPosition = Vector2.Add(currCursorPosition, Vector2.Multiply(currMovement, (float)((currMovementLength - assumed_slider_radius) / currMovementLength)));
+                        currMovementLength *= (currMovementLength - assumed_slider_radius) / currMovementLength;
+                        slider.LazyTravelDistance += (float)currMovementLength;
+                    }
+                    slider.LazyEndPosition = currCursorPosition;
+                }
+                else if (currMovementObj is SliderRepeat && currMovementLength > normalized_radius)
+                {
+                    // For a slider repeat, assume a tighter movement threshold to better assess repeat sliders.
+                    currCursorPosition = Vector2.Add(currCursorPosition, Vector2.Multiply(currMovement, (float)((currMovementLength - normalized_radius) / currMovementLength)));
+                    currMovementLength *= (currMovementLength - normalized_radius) / currMovementLength;
+                    slider.LazyTravelDistance += (float)currMovementLength;
+                }
+                else if (currMovementLength > assumed_slider_radius)
+                {
+                    // For a slider ticks, use the assumed slider radius for a more accurate movement assessment.
+                    currCursorPosition = Vector2.Add(currCursorPosition, Vector2.Multiply(currMovement, (float)((currMovementLength - assumed_slider_radius) / currMovementLength)));
+                    currMovementLength *= (currMovementLength - assumed_slider_radius) / currMovementLength;
+                    slider.LazyTravelDistance += (float)currMovementLength;
+                }
+            }
+
+            slider.LazyTravelDistance *= (float)Math.Pow(1 + slider.RepeatCount / 2.5, 1.0 / 2.5); // Bonus for repeat sliders until a better per nested object strain system can be achieved.
         }
 
         private Vector2 getEndCursorPosition(OsuHitObject hitObject)

From 9b8b6846e99d3b1fd26060afa847a434b77fdc1c Mon Sep 17 00:00:00 2001
From: Xexxar <xexxar.xexxar@gmail.com>
Date: Sat, 6 Nov 2021 19:22:30 +0000
Subject: [PATCH 0783/5547] restore original global multiplier so people dont
 mald

---
 osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
index 4c1b81a692..9134deb067 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
@@ -43,7 +43,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty
             countMiss = Score.Statistics.GetValueOrDefault(HitResult.Miss);
             effectiveMissCount = calculateEffectiveMissCount();
 
-            double multiplier = 1.1; // This is being adjusted to keep the final pp value scaled around what it used to be when changing things.
+            double multiplier = 1.12; // This is being adjusted to keep the final pp value scaled around what it used to be when changing things.
 
             // Custom multipliers for NoFail and SpunOut.
             if (mods.Any(m => m is OsuModNoFail))

From 7d2c31f4df8e29ee6f1dd61ae63d6aeabbb02f41 Mon Sep 17 00:00:00 2001
From: Xexxar <xexxar.xexxar@gmail.com>
Date: Sat, 6 Nov 2021 19:42:54 +0000
Subject: [PATCH 0784/5547] cleaned up code uglies

---
 .../Preprocessing/OsuDifficultyHitObject.cs         | 13 ++++++-------
 1 file changed, 6 insertions(+), 7 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
index f618d6b648..934f8667a4 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
@@ -2,8 +2,6 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
-using System.Diagnostics;
-using System.Linq;
 using osu.Game.Rulesets.Difficulty.Preprocessing;
 using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Osu.Objects;
@@ -131,13 +129,13 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
             if (slider.LazyEndPosition != null)
                 return;
 
-            slider.LazyTravelTime = slider.NestedHitObjects[slider.NestedHitObjects.Count - 1].StartTime - slider.StartTime;
+            slider.LazyTravelTime = slider.NestedHitObjects[^1].StartTime - slider.StartTime;
 
             double endTimeMin = slider.LazyTravelTime / slider.SpanDuration;
-                if (endTimeMin % 2 >= 1)
-                    endTimeMin = 1 - endTimeMin % 1;
-                else
-                    endTimeMin %= 1;
+            if (endTimeMin % 2 >= 1)
+                endTimeMin = 1 - endTimeMin % 1;
+            else
+                endTimeMin %= 1;
 
             slider.LazyEndPosition = slider.StackedPosition + slider.Path.PositionAt(endTimeMin); // temporary lazy end position until a real result can be derived.
             var currCursorPosition = slider.StackedPosition;
@@ -170,6 +168,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
                         currMovementLength *= (currMovementLength - assumed_slider_radius) / currMovementLength;
                         slider.LazyTravelDistance += (float)currMovementLength;
                     }
+
                     slider.LazyEndPosition = currCursorPosition;
                 }
                 else if (currMovementObj is SliderRepeat && currMovementLength > normalized_radius)

From 14a3e3bb06ec8831b42bde64c832ebc034ebc136 Mon Sep 17 00:00:00 2001
From: Xexxar <xexxar.xexxar@gmail.com>
Date: Sat, 6 Nov 2021 21:10:21 +0000
Subject: [PATCH 0785/5547] nerfed approx slider window

---
 .../Difficulty/Preprocessing/OsuDifficultyHitObject.cs          | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
index 934f8667a4..18599ed10d 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
@@ -14,7 +14,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
         private const int normalized_radius = 50; // Change radius to 50 to make 100 the diameter. Easier for mental maths.
         private const int min_delta_time = 25;
         private const float maximum_slider_radius = normalized_radius * 2.4f;
-        private const float assumed_slider_radius = normalized_radius * 1.6f;
+        private const float assumed_slider_radius = normalized_radius * 2.0f;
 
         protected new OsuHitObject BaseObject => (OsuHitObject)base.BaseObject;
 

From 7af1a0bf12abcc119a2f78a828e44c6b653ff2cc Mon Sep 17 00:00:00 2001
From: Xexxar <xexxar.xexxar@gmail.com>
Date: Sat, 6 Nov 2021 21:11:37 +0000
Subject: [PATCH 0786/5547] buffed velocity constant

---
 osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
index 915673f890..ae7e783c6a 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
@@ -24,7 +24,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
         private const double wide_angle_multiplier = 1.5;
         private const double acute_angle_multiplier = 2.0;
         private const double slider_multiplier = 1.5;
-        private const double vel_change_multiplier = 0.75;
+        private const double vel_change_multiplier = 1.0;
 
         private double currentStrain = 1;
 

From bd58d2873e5ee8a0d50db3c4a43bf0ccdae82c0d Mon Sep 17 00:00:00 2001
From: Xexxar <xexxar.xexxar@gmail.com>
Date: Sat, 6 Nov 2021 21:55:47 +0000
Subject: [PATCH 0787/5547] revert velocity multiplier to 0.75

---
 osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
index ae7e783c6a..915673f890 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
@@ -24,7 +24,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
         private const double wide_angle_multiplier = 1.5;
         private const double acute_angle_multiplier = 2.0;
         private const double slider_multiplier = 1.5;
-        private const double vel_change_multiplier = 1.0;
+        private const double vel_change_multiplier = 0.75;
 
         private double currentStrain = 1;
 

From f135a98d69205bce9073d9ebeaef1b15dd80f7dc Mon Sep 17 00:00:00 2001
From: Xexxar <xexxar.xexxar@gmail.com>
Date: Sat, 6 Nov 2021 22:27:58 +0000
Subject: [PATCH 0788/5547] updated for review, adding wide angle buff for
 velchanges

---
 .../Difficulty/Skills/Aim.cs                  | 26 +++++++++----------
 1 file changed, 13 insertions(+), 13 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
index 915673f890..df0105f32f 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
@@ -63,7 +63,8 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
                 prevVelocity = Math.Max(prevVelocity, movementVelocity + travelVelocity);
             }
 
-            double angleBonus = 0;
+            double wideAngleBonus = 0;
+            double acuteAngleBonus = 0;
             double sliderBonus = 0;
             double velChangeBonus = 0;
 
@@ -78,10 +79,10 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
                     double lastLastAngle = osuLastLastObj.Angle.Value;
 
                     // Rewarding angles, take the smaller velocity as base.
-                    angleBonus = Math.Min(currVelocity, prevVelocity);
+                    double angleBonus = Math.Min(currVelocity, prevVelocity);
 
-                    double wideAngleBonus = calcWideAngleBonus(currAngle);
-                    double acuteAngleBonus = calcAcuteAngleBonus(currAngle);
+                    wideAngleBonus = calcWideAngleBonus(currAngle);
+                    acuteAngleBonus = calcAcuteAngleBonus(currAngle);
 
                     if (osuCurrObj.StrainTime > 100) // Only buff deltaTime exceeding 300 bpm 1/2.
                         acuteAngleBonus = 0;
@@ -95,21 +96,20 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
 
                     wideAngleBonus *= angleBonus * (1 - Math.Min(wideAngleBonus, Math.Pow(calcWideAngleBonus(lastAngle), 3))); // Penalize wide angles if they're repeated, reducing the penalty as the lastAngle gets more acute.
                     acuteAngleBonus *= 0.5 + 0.5 * (1 - Math.Min(acuteAngleBonus, Math.Pow(calcAcuteAngleBonus(lastLastAngle), 3))); // Penalize acute angles if they're repeated, reducing the penalty as the lastLastAngle gets more obtuse.
-
-                    angleBonus = Math.Max(acuteAngleBonus * acute_angle_multiplier, wideAngleBonus * wide_angle_multiplier); // Take the max of the multipliers.
                 }
             }
 
             if (Math.Max(prevVelocity, currVelocity) != 0)
             {
-                prevVelocity = (osuLastObj.JumpDistance + osuLastObj.TravelDistance) / osuLastObj.StrainTime; // We want to use the average velocity when awarding differences, not necessarily combined.
+                prevVelocity = (osuLastObj.JumpDistance + osuLastObj.TravelDistance) / osuLastObj.StrainTime; // We want to use the average velocity over the whole object when awarding differences, not the individual jump and slider path velocities.
                 currVelocity = (osuCurrObj.JumpDistance + osuCurrObj.TravelDistance) / osuCurrObj.StrainTime;
 
-                velChangeBonus = Math.Max(Math.Abs(prevVelocity - currVelocity) // reward for % distance slowed down compared to previous, paying attention to not award overlap
-                                          * Math.Pow(Math.Sin(Math.PI / 2 * Math.Min(1, osuCurrObj.JumpDistance / 100)), 2) // do not award overlap
-                                          * Math.Pow(Math.Sin(Math.PI / 2 * Math.Abs(prevVelocity - currVelocity) / Math.Max(prevVelocity, currVelocity)), 2), // scale with ratio of difference compared to max
-                                          Math.Min(125 / Math.Min(osuCurrObj.StrainTime, osuLastObj.StrainTime), Math.Abs(prevVelocity - currVelocity)) // reward for % distance up to 125 / strainTime for overlaps where velocity is still changing.
-                                          * Math.Pow(Math.Sin(Math.PI / 2 * Math.Abs(prevVelocity - currVelocity) / Math.Max(prevVelocity, currVelocity)), 2)); // scale with ratio of difference compared to max
+                double distRatio = Math.Pow(Math.Sin(Math.PI / 2 * Math.Abs(prevVelocity - currVelocity) / Math.Max(prevVelocity, currVelocity)), 2); // scale with ratio of difference compared to max
+                double overlapVelocityBuff = Math.Min(125 / Math.Min(osuCurrObj.StrainTime, osuLastObj.StrainTime), Math.Abs(prevVelocity - currVelocity)); // reward for % distance up to 125 / strainTime for overlaps where velocity is still changing.
+                double nonOverlapVelocityBuff = Math.Abs(prevVelocity - currVelocity) // reward for % distance slowed down compared to previous, paying attention to not award overlap
+                                                 * Math.Pow(Math.Sin(Math.PI / 2 * Math.Min(1, osuCurrObj.JumpDistance / 100)), 2); // do not award overlap
+
+                velChangeBonus = Math.Max(overlapVelocityBuff, nonOverlapVelocityBuff) * distRatio; // choose larger distance, multiplied by ratio.
 
                 velChangeBonus *= Math.Pow(Math.Min(osuCurrObj.StrainTime, osuLastObj.StrainTime) / Math.Max(osuCurrObj.StrainTime, osuLastObj.StrainTime), 2); // penalize for rhythm changes.
             }
@@ -119,7 +119,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
                 sliderBonus = osuCurrObj.TravelDistance / osuCurrObj.TravelTime; // add some slider rewards
             }
 
-            aimStrain += Math.Max(angleBonus, velChangeBonus * vel_change_multiplier); // Add in angle bonus or velchange bonus, whichever is larger.
+            aimStrain += Math.Max(acuteAngleBonus * acute_angle_multiplier, wideAngleBonus * wide_angle_multiplier + velChangeBonus * vel_change_multiplier); // Add in acute angle bonus or wide angle bonus + velchange bonus, whichever is larger.
             aimStrain += sliderBonus * slider_multiplier; // Add in additional slider velocity.
 
             return aimStrain;

From adeebd954a4822852e52ab87da81299d5ca8e54e Mon Sep 17 00:00:00 2001
From: Xexxar <xexxar.xexxar@gmail.com>
Date: Sun, 7 Nov 2021 00:13:13 +0000
Subject: [PATCH 0789/5547] update to fix velocity change oversight

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

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
index df0105f32f..ab7a392b1b 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
@@ -104,10 +104,10 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
                 prevVelocity = (osuLastObj.JumpDistance + osuLastObj.TravelDistance) / osuLastObj.StrainTime; // We want to use the average velocity over the whole object when awarding differences, not the individual jump and slider path velocities.
                 currVelocity = (osuCurrObj.JumpDistance + osuCurrObj.TravelDistance) / osuCurrObj.StrainTime;
 
-                double distRatio = Math.Pow(Math.Sin(Math.PI / 2 * Math.Abs(prevVelocity - currVelocity) / Math.Max(prevVelocity, currVelocity)), 2); // scale with ratio of difference compared to max
+                double distRatio = Math.Pow(Math.Sin(Math.PI / 2 * Math.Min(1, Math.Abs(prevVelocity - currVelocity) / (0.5 * Math.Max(prevVelocity, currVelocity)))), 2); // scale with ratio of difference compared to 0.5 * max dist.
                 double overlapVelocityBuff = Math.Min(125 / Math.Min(osuCurrObj.StrainTime, osuLastObj.StrainTime), Math.Abs(prevVelocity - currVelocity)); // reward for % distance up to 125 / strainTime for overlaps where velocity is still changing.
                 double nonOverlapVelocityBuff = Math.Abs(prevVelocity - currVelocity) // reward for % distance slowed down compared to previous, paying attention to not award overlap
-                                                 * Math.Pow(Math.Sin(Math.PI / 2 * Math.Min(1, osuCurrObj.JumpDistance / 100)), 2); // do not award overlap
+                                                 * Math.Pow(Math.Sin(Math.PI / 2 * Math.Min(1, Math.Min(osuCurrObj.JumpDistance, osuLastObj.JumpDistance) / 100)), 2); // do not award overlap
 
                 velChangeBonus = Math.Max(overlapVelocityBuff, nonOverlapVelocityBuff) * distRatio; // choose larger distance, multiplied by ratio.
 

From 26ff292337e710b3415dfec66ba72d3152b4e7ef Mon Sep 17 00:00:00 2001
From: Xexxar <xexxar.xexxar@gmail.com>
Date: Sun, 7 Nov 2021 01:08:51 +0000
Subject: [PATCH 0790/5547] revert velchangetest change

---
 osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
index ab7a392b1b..44fff88202 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
@@ -104,7 +104,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
                 prevVelocity = (osuLastObj.JumpDistance + osuLastObj.TravelDistance) / osuLastObj.StrainTime; // We want to use the average velocity over the whole object when awarding differences, not the individual jump and slider path velocities.
                 currVelocity = (osuCurrObj.JumpDistance + osuCurrObj.TravelDistance) / osuCurrObj.StrainTime;
 
-                double distRatio = Math.Pow(Math.Sin(Math.PI / 2 * Math.Min(1, Math.Abs(prevVelocity - currVelocity) / (0.5 * Math.Max(prevVelocity, currVelocity)))), 2); // scale with ratio of difference compared to 0.5 * max dist.
+                double distRatio = Math.Pow(Math.Sin(Math.PI / 2 * Math.Abs(prevVelocity - currVelocity) / Math.Max(prevVelocity, currVelocity)), 2); // scale with ratio of difference compared to 0.5 * max dist.
                 double overlapVelocityBuff = Math.Min(125 / Math.Min(osuCurrObj.StrainTime, osuLastObj.StrainTime), Math.Abs(prevVelocity - currVelocity)); // reward for % distance up to 125 / strainTime for overlaps where velocity is still changing.
                 double nonOverlapVelocityBuff = Math.Abs(prevVelocity - currVelocity) // reward for % distance slowed down compared to previous, paying attention to not award overlap
                                                  * Math.Pow(Math.Sin(Math.PI / 2 * Math.Min(1, Math.Min(osuCurrObj.JumpDistance, osuLastObj.JumpDistance) / 100)), 2); // do not award overlap

From 22b9d2e87936b5ed97594291f8f9aeba3edddf34 Mon Sep 17 00:00:00 2001
From: Xexxar <xexxar.xexxar@gmail.com>
Date: Sun, 7 Nov 2021 01:50:17 +0000
Subject: [PATCH 0791/5547] adjustment to decrease slider leniency

---
 .../Difficulty/Preprocessing/OsuDifficultyHitObject.cs          | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
index 18599ed10d..3e220f6199 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
@@ -14,7 +14,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
         private const int normalized_radius = 50; // Change radius to 50 to make 100 the diameter. Easier for mental maths.
         private const int min_delta_time = 25;
         private const float maximum_slider_radius = normalized_radius * 2.4f;
-        private const float assumed_slider_radius = normalized_radius * 2.0f;
+        private const float assumed_slider_radius = normalized_radius * 1.65f;
 
         protected new OsuHitObject BaseObject => (OsuHitObject)base.BaseObject;
 

From 69aa620ab78f8160b7e20ff063dcdfe5a494f986 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 4 Nov 2021 17:39:32 +0900
Subject: [PATCH 0792/5547] Remove unused team class

---
 osu.Game/Users/Team.cs | 10 ----------
 osu.Game/Users/User.cs |  2 --
 2 files changed, 12 deletions(-)
 delete mode 100644 osu.Game/Users/Team.cs

diff --git a/osu.Game/Users/Team.cs b/osu.Game/Users/Team.cs
deleted file mode 100644
index b56a083fdf..0000000000
--- a/osu.Game/Users/Team.cs
+++ /dev/null
@@ -1,10 +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.Users
-{
-    public class Team
-    {
-        public string Name;
-    }
-}
diff --git a/osu.Game/Users/User.cs b/osu.Game/Users/User.cs
index 20c23153f0..4ee7d20734 100644
--- a/osu.Game/Users/User.cs
+++ b/osu.Game/Users/User.cs
@@ -33,8 +33,6 @@ namespace osu.Game.Users
 
         public readonly Bindable<UserActivity> Activity = new Bindable<UserActivity>();
 
-        //public Team Team;
-
         [JsonProperty(@"profile_colour")]
         public string Colour;
 

From 0ecf5f201c029923f94e51341f8fd0abc558ce17 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 4 Nov 2021 18:02:44 +0900
Subject: [PATCH 0793/5547] Rename `User` to `APIUser` and move to correct
 namespace

---
 .../Mods/EmptyFreeformModAutoplay.cs          |   4 +-
 .../Mods/PippidonModAutoplay.cs               |   4 +-
 .../Mods/EmptyScrollingModAutoplay.cs         |   4 +-
 .../Mods/PippidonModAutoplay.cs               |   4 +-
 osu.Desktop/DiscordRichPresence.cs            |   4 +-
 .../Mods/CatchModAutoplay.cs                  |   4 +-
 .../Mods/CatchModCinema.cs                    |   4 +-
 .../Mods/ManiaModAutoplay.cs                  |   4 +-
 .../Mods/ManiaModCinema.cs                    |   4 +-
 .../TestSceneMissHitWindowJudgements.cs       |   4 +-
 osu.Game.Rulesets.Osu/Mods/OsuModAutoplay.cs  |   4 +-
 osu.Game.Rulesets.Osu/Mods/OsuModCinema.cs    |   4 +-
 .../Mods/TaikoModAutoplay.cs                  |   4 +-
 .../Mods/TaikoModCinema.cs                    |   4 +-
 .../Beatmaps/IO/ImportBeatmapTest.cs          |   8 +-
 .../Beatmaps/ToStringFormattingTest.cs        |   6 +-
 .../Chat/TestSceneChannelManager.cs           |   4 +-
 .../StatefulMultiplayerClientTest.cs          |   6 +-
 .../StatefulMultiplayerClientTest.cs          |   6 +-
 osu.Game.Tests/Scores/IO/ImportScoreTest.cs   |   4 +-
 .../TestSceneBackgroundScreenDefault.cs       |   4 +-
 .../Background/TestSceneUserDimBackgrounds.cs |   4 +-
 .../Visual/Beatmaps/TestSceneBeatmapCard.cs   |   6 +-
 .../Gameplay/TestSceneGameplayLeaderboard.cs  |  28 +-
 .../Gameplay/TestSceneReplayDownloadButton.cs |   4 +-
 .../Visual/Gameplay/TestSceneSpectator.cs     |   4 +-
 .../Visual/Gameplay/TestSceneSpectatorHost.cs |   4 +-
 .../Visual/Menus/TestSceneDisclaimer.cs       |   4 +-
 .../Multiplayer/TestSceneDrawableRoom.cs      |   6 +-
 .../TestSceneDrawableRoomParticipantsList.cs  |   6 +-
 .../TestSceneDrawableRoomPlaylist.cs          |   4 +-
 .../Multiplayer/TestSceneMatchLeaderboard.cs  |   6 +-
 .../TestSceneMultiSpectatorLeaderboard.cs     |   4 +-
 .../TestSceneMultiSpectatorScreen.cs          |  12 +-
 .../Multiplayer/TestSceneMultiplayer.cs       |  12 +-
 ...TestSceneMultiplayerGameplayLeaderboard.cs |   4 +-
 ...ceneMultiplayerGameplayLeaderboardTeams.cs |   4 +-
 .../TestSceneMultiplayerMatchSubScreen.cs     |   4 +-
 .../TestSceneMultiplayerParticipantsList.cs   |  19 +-
 .../TestSceneMultiplayerReadyButton.cs        |  12 +-
 .../TestSceneMultiplayerResults.cs            |   4 +-
 .../TestSceneMultiplayerSpectateButton.cs     |   6 +-
 .../TestSceneMultiplayerTeamResults.cs        |   4 +-
 .../Multiplayer/TestSceneRankRangePill.cs     |  14 +-
 .../Online/TestSceneAccountCreationOverlay.cs |   3 +-
 .../Online/TestSceneBeatmapListingOverlay.cs  |   4 +-
 .../Online/TestSceneBeatmapSetOverlay.cs      |   4 +-
 .../Online/TestSceneChannelTabControl.cs      |   4 +-
 .../Online/TestSceneChatLineTruncation.cs     |   8 +-
 .../Visual/Online/TestSceneChatLink.cs        |   8 +-
 .../Visual/Online/TestSceneChatOverlay.cs     |   8 +-
 .../TestSceneCurrentlyPlayingDisplay.cs       |   9 +-
 .../Visual/Online/TestSceneDirectPanel.cs     |   6 +-
 .../Visual/Online/TestSceneFriendDisplay.cs   |   9 +-
 .../Online/TestSceneHistoricalSection.cs      |   6 +-
 .../Visual/Online/TestSceneMessageNotifier.cs |  10 +-
 .../TestSceneOfflineCommentsContainer.cs      |   6 +-
 .../Online/TestScenePlayHistorySubsection.cs  |  59 ++--
 .../Online/TestSceneProfileRulesetSelector.cs |  12 +-
 .../Visual/Online/TestSceneRankGraph.cs       |   9 +-
 .../Visual/Online/TestSceneScoresContainer.cs |  17 +-
 .../Online/TestSceneStandAloneChatDisplay.cs  |  10 +-
 .../Online/TestSceneUserHistoryGraph.cs       |  34 +-
 .../Visual/Online/TestSceneUserPanel.cs       |  13 +-
 .../Online/TestSceneUserProfileHeader.cs      |  13 +-
 .../Online/TestSceneUserProfileOverlay.cs     |  15 +-
 .../TestSceneUserProfilePreviousUsernames.cs  |  14 +-
 .../Visual/Online/TestSceneUserRanks.cs       |   4 +-
 .../Visual/Online/TestSceneUserRequest.cs     |   8 +-
 .../TestScenePlaylistsParticipantsList.cs     |   3 +-
 .../TestScenePlaylistsResultsScreen.cs        |   8 +-
 .../Visual/Ranking/TestSceneAccuracyCircle.cs |   4 +-
 .../TestSceneExpandedPanelMiddleContent.cs    |   8 +-
 .../SongSelect/TestSceneBeatmapLeaderboard.cs |  25 +-
 .../TestSceneBeatmapRecommendations.cs        |   5 +-
 .../SongSelect/TestScenePlaySongSelect.cs     |   6 +-
 .../TestSceneUserTopScoreContainer.cs         |   7 +-
 .../TestSceneDashboardBeatmapListing.cs       |  10 +-
 .../TestSceneDeleteLocalScore.cs              |   6 +-
 .../TestSceneFriendsOnlineStatusControl.cs    |  10 +-
 .../TestSceneDrawableTournamentTeam.cs        |  16 +-
 .../TestSceneTournamentMatchChatDisplay.cs    |  12 +-
 .../TournamentTestScene.cs                    |  21 +-
 .../Components/DrawableTeamWithPlayers.cs     |   4 +-
 osu.Game.Tournament/Models/TournamentTeam.cs  |   4 +-
 .../Screens/Editors/TeamEditorScreen.cs       |   7 +-
 osu.Game.Tournament/TournamentGameBase.cs     |   4 +-
 osu.Game/Beatmaps/BeatmapManager.cs           |   4 +-
 osu.Game/Beatmaps/BeatmapMetadata.cs          |  12 +-
 osu.Game/Database/UserLookupCache.cs          |  30 +-
 .../Graphics/Containers/LinkFlowContainer.cs  |   4 +-
 osu.Game/Online/API/APIAccess.cs              |  13 +-
 osu.Game/Online/API/APIRequest.cs             |   4 +-
 osu.Game/Online/API/DummyAPIAccess.cs         |  11 +-
 osu.Game/Online/API/IAPIProvider.cs           |   5 +-
 .../CreateNewPrivateMessageRequest.cs         |   6 +-
 .../Online/API/Requests/GetFriendsRequest.cs  |   4 +-
 .../Online/API/Requests/GetUserRequest.cs     |   4 +-
 .../Online/API/Requests/GetUsersResponse.cs   |   4 +-
 .../API/Requests/Responses/APIBeatmapSet.cs   |  11 +-
 .../API/Requests/Responses/APIPlayStyle.cs    |  22 ++
 .../API/Requests/Responses/APIScoreInfo.cs    |   3 +-
 .../Online/API/Requests/Responses/APIUser.cs  | 253 ++++++++++++++-
 .../Requests/Responses/APIUserContainer.cs    |  13 +
 .../Requests/Responses/APIUserHistoryCount.cs |  17 +
 .../Responses/APIUserScoreAggregate.cs        |   3 +-
 .../Online/API/Requests/Responses/Comment.cs  |   5 +-
 .../API/Requests/Responses/CommentBundle.cs   |   5 +-
 osu.Game/Online/Chat/Channel.cs               |   8 +-
 osu.Game/Online/Chat/ChannelManager.cs        |   4 +-
 osu.Game/Online/Chat/InfoMessage.cs           |   4 +-
 osu.Game/Online/Chat/Message.cs               |   4 +-
 osu.Game/Online/Chat/MessageNotifier.cs       |   4 +-
 .../Online/Multiplayer/MultiplayerClient.cs   |   6 +-
 .../Online/Multiplayer/MultiplayerRoomUser.cs |   4 +-
 osu.Game/Online/Rooms/MultiplayerScore.cs     |   4 +-
 osu.Game/Online/Rooms/Room.cs                 |   6 +-
 osu.Game/Online/Solo/SubmittableScore.cs      |   4 +-
 osu.Game/Overlays/BeatmapSet/AuthorInfo.cs    |   4 +-
 .../BeatmapSet/Buttons/FavouriteButton.cs     |   4 +-
 .../Buttons/HeaderDownloadButton.cs           |   6 +-
 .../BeatmapSet/Scores/ScoresContainer.cs      |   6 +-
 osu.Game/Overlays/Changelog/ChangelogEntry.cs |   4 +-
 osu.Game/Overlays/Chat/ChatLine.cs            |   8 +-
 .../Overlays/Comments/CommentsContainer.cs    |   4 +-
 .../Dashboard/CurrentlyPlayingDisplay.cs      |   7 +-
 .../Dashboard/Friends/FriendDisplay.cs        |  15 +-
 .../Friends/FriendOnlineStreamControl.cs      |   4 +-
 .../Profile/Header/BottomHeaderContainer.cs   |   6 +-
 .../Profile/Header/CentreHeaderContainer.cs   |   6 +-
 .../Header/Components/FollowersButton.cs      |   4 +-
 .../Profile/Header/Components/LevelBadge.cs   |   6 +-
 .../Header/Components/LevelProgressBar.cs     |   6 +-
 .../Components/MappingSubscribersButton.cs    |   4 +-
 .../Header/Components/MessageUserButton.cs    |   4 +-
 .../Components/OverlinedTotalPlayTime.cs      |   6 +-
 .../Header/Components/PreviousUsernames.cs    |   6 +-
 .../Components/ProfileRulesetSelector.cs      |   4 +-
 .../Profile/Header/DetailHeaderContainer.cs   |   6 +-
 .../Profile/Header/MedalHeaderContainer.cs    |   6 +-
 .../Profile/Header/TopHeaderContainer.cs      |   6 +-
 osu.Game/Overlays/Profile/ProfileHeader.cs    |   5 +-
 osu.Game/Overlays/Profile/ProfileSection.cs   |   4 +-
 .../Beatmaps/PaginatedBeatmapContainer.cs     |   6 +-
 .../Historical/ChartProfileSubsection.cs      |  15 +-
 .../PaginatedMostPlayedBeatmapContainer.cs    |   6 +-
 .../Historical/PlayHistorySubsection.cs       |   7 +-
 .../Sections/Historical/ProfileLineChart.cs   |   6 +-
 .../Sections/Historical/ReplaysSubsection.cs  |   7 +-
 .../Sections/Historical/UserHistoryGraph.cs   |   4 +-
 .../Profile/Sections/Kudosu/KudosuInfo.cs     |   6 +-
 .../Kudosu/PaginatedKudosuHistoryContainer.cs |   4 +-
 .../Sections/PaginatedProfileSubsection.cs    |   8 +-
 .../Profile/Sections/ProfileSubsection.cs     |   6 +-
 .../Sections/Ranks/PaginatedScoreContainer.cs |   6 +-
 .../PaginatedRecentActivityContainer.cs       |   4 +-
 .../UserInterface/MainMenuSettings.cs         |   4 +-
 .../Overlays/Toolbar/ToolbarUserButton.cs     |   4 +-
 osu.Game/Overlays/UserProfileOverlay.cs       |  12 +-
 osu.Game/Scoring/IScoreInfo.cs                |   4 +-
 osu.Game/Scoring/Legacy/LegacyScoreDecoder.cs |   4 +-
 osu.Game/Scoring/ScoreInfo.cs                 |   8 +-
 .../Backgrounds/BackgroundScreenDefault.cs    |   4 +-
 osu.Game/Screens/Menu/Disclaimer.cs           |   6 +-
 .../Screens/Menu/MenuLogoVisualisation.cs     |   4 +-
 osu.Game/Screens/Menu/MenuSideFlashes.cs      |   4 +-
 .../OnlinePlay/Components/ParticipantsList.cs |   4 +-
 .../OnlinePlay/DrawableRoomPlaylistItem.cs    |   4 +-
 .../DrawableRoomParticipantsList.cs           |  14 +-
 .../OnlinePlay/Match/DrawableMatchRoom.cs     |   4 +-
 .../Screens/OnlinePlay/OnlinePlayComposite.cs |   6 +-
 .../Screens/Play/HUD/GameplayLeaderboard.cs   |   6 +-
 .../Play/HUD/GameplayLeaderboardScore.cs      |   6 +-
 .../HUD/MultiplayerGameplayLeaderboard.cs     |   4 +-
 osu.Game/Screens/Play/SoloSpectator.cs        |   5 +-
 .../Expanded/ExpandedPanelTopContent.cs       |   8 +-
 osu.Game/Screens/Spectate/SpectatorScreen.cs  |   4 +-
 .../Tests/Beatmaps/HitObjectSampleTest.cs     |   4 +-
 osu.Game/Tests/TestScoreInfo.cs               |   4 +-
 .../Multiplayer/TestMultiplayerClient.cs      |   6 +-
 .../Visual/OnlinePlay/TestRoomManager.cs      |   4 +-
 .../OnlinePlay/TestRoomRequestsHandler.cs     |   4 +-
 osu.Game/Tests/Visual/TestUserLookupCache.cs  |  10 +-
 osu.Game/Users/Drawables/ClickableAvatar.cs   |   5 +-
 osu.Game/Users/Drawables/DrawableAvatar.cs    |   5 +-
 osu.Game/Users/Drawables/UpdateableAvatar.cs  |   9 +-
 osu.Game/Users/ExtendedUserPanel.cs           |   3 +-
 osu.Game/Users/IUser.cs                       |  12 +
 osu.Game/Users/User.cs                        | 292 ------------------
 osu.Game/Users/UserBrickPanel.cs              |   3 +-
 osu.Game/Users/UserCoverBackground.cs         |  11 +-
 osu.Game/Users/UserGridPanel.cs               |   3 +-
 osu.Game/Users/UserListPanel.cs               |   3 +-
 osu.Game/Users/UserPanel.cs                   |   5 +-
 osu.Game/Users/UserStatistics.cs              |   5 +-
 195 files changed, 990 insertions(+), 946 deletions(-)
 create mode 100644 osu.Game/Online/API/Requests/Responses/APIPlayStyle.cs
 create mode 100644 osu.Game/Online/API/Requests/Responses/APIUserContainer.cs
 create mode 100644 osu.Game/Online/API/Requests/Responses/APIUserHistoryCount.cs
 create mode 100644 osu.Game/Users/IUser.cs
 delete mode 100644 osu.Game/Users/User.cs

diff --git a/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform/Mods/EmptyFreeformModAutoplay.cs b/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform/Mods/EmptyFreeformModAutoplay.cs
index f705009d18..d4496a24fd 100644
--- a/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform/Mods/EmptyFreeformModAutoplay.cs
+++ b/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform/Mods/EmptyFreeformModAutoplay.cs
@@ -3,10 +3,10 @@
 
 using System.Collections.Generic;
 using osu.Game.Beatmaps;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets.EmptyFreeform.Replays;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Scoring;
-using osu.Game.Users;
 
 namespace osu.Game.Rulesets.EmptyFreeform.Mods
 {
@@ -16,7 +16,7 @@ namespace osu.Game.Rulesets.EmptyFreeform.Mods
         {
             ScoreInfo = new ScoreInfo
             {
-                User = new User { Username = "sample" },
+                User = new APIUser { Username = "sample" },
             },
             Replay = new EmptyFreeformAutoGenerator(beatmap).Generate(),
         };
diff --git a/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon/Mods/PippidonModAutoplay.cs b/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon/Mods/PippidonModAutoplay.cs
index 4565c97d1a..6e1fe42ee2 100644
--- a/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon/Mods/PippidonModAutoplay.cs
+++ b/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon/Mods/PippidonModAutoplay.cs
@@ -3,10 +3,10 @@
 
 using System.Collections.Generic;
 using osu.Game.Beatmaps;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Pippidon.Replays;
 using osu.Game.Scoring;
-using osu.Game.Users;
 
 namespace osu.Game.Rulesets.Pippidon.Mods
 {
@@ -16,7 +16,7 @@ namespace osu.Game.Rulesets.Pippidon.Mods
         {
             ScoreInfo = new ScoreInfo
             {
-                User = new User { Username = "sample" },
+                User = new APIUser { Username = "sample" },
             },
             Replay = new PippidonAutoGenerator(beatmap).Generate(),
         };
diff --git a/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling/Mods/EmptyScrollingModAutoplay.cs b/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling/Mods/EmptyScrollingModAutoplay.cs
index 431994e098..c5bacb522f 100644
--- a/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling/Mods/EmptyScrollingModAutoplay.cs
+++ b/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling/Mods/EmptyScrollingModAutoplay.cs
@@ -5,8 +5,8 @@ using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.EmptyScrolling.Replays;
 using osu.Game.Scoring;
-using osu.Game.Users;
 using System.Collections.Generic;
+using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Rulesets.EmptyScrolling.Mods
 {
@@ -16,7 +16,7 @@ namespace osu.Game.Rulesets.EmptyScrolling.Mods
         {
             ScoreInfo = new ScoreInfo
             {
-                User = new User { Username = "sample" },
+                User = new APIUser { Username = "sample" },
             },
             Replay = new EmptyScrollingAutoGenerator(beatmap).Generate(),
         };
diff --git a/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon/Mods/PippidonModAutoplay.cs b/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon/Mods/PippidonModAutoplay.cs
index 4565c97d1a..6e1fe42ee2 100644
--- a/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon/Mods/PippidonModAutoplay.cs
+++ b/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon/Mods/PippidonModAutoplay.cs
@@ -3,10 +3,10 @@
 
 using System.Collections.Generic;
 using osu.Game.Beatmaps;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Pippidon.Replays;
 using osu.Game.Scoring;
-using osu.Game.Users;
 
 namespace osu.Game.Rulesets.Pippidon.Mods
 {
@@ -16,7 +16,7 @@ namespace osu.Game.Rulesets.Pippidon.Mods
         {
             ScoreInfo = new ScoreInfo
             {
-                User = new User { Username = "sample" },
+                User = new APIUser { Username = "sample" },
             },
             Replay = new PippidonAutoGenerator(beatmap).Generate(),
         };
diff --git a/osu.Desktop/DiscordRichPresence.cs b/osu.Desktop/DiscordRichPresence.cs
index e2b40e9dc6..e1e7e6ad18 100644
--- a/osu.Desktop/DiscordRichPresence.cs
+++ b/osu.Desktop/DiscordRichPresence.cs
@@ -11,10 +11,10 @@ using osu.Framework.Graphics;
 using osu.Framework.Logging;
 using osu.Game.Configuration;
 using osu.Game.Online.API;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets;
 using osu.Game.Users;
 using LogLevel = osu.Framework.Logging.LogLevel;
-using User = osu.Game.Users.User;
 
 namespace osu.Desktop
 {
@@ -27,7 +27,7 @@ namespace osu.Desktop
         [Resolved]
         private IBindable<RulesetInfo> ruleset { get; set; }
 
-        private IBindable<User> user;
+        private IBindable<APIUser> user;
 
         private readonly IBindable<UserStatus> status = new Bindable<UserStatus>();
         private readonly IBindable<UserActivity> activity = new Bindable<UserActivity>();
diff --git a/osu.Game.Rulesets.Catch/Mods/CatchModAutoplay.cs b/osu.Game.Rulesets.Catch/Mods/CatchModAutoplay.cs
index 6f3e6763bd..11fffb31de 100644
--- a/osu.Game.Rulesets.Catch/Mods/CatchModAutoplay.cs
+++ b/osu.Game.Rulesets.Catch/Mods/CatchModAutoplay.cs
@@ -3,10 +3,10 @@
 
 using System.Collections.Generic;
 using osu.Game.Beatmaps;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets.Catch.Replays;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Scoring;
-using osu.Game.Users;
 
 namespace osu.Game.Rulesets.Catch.Mods
 {
@@ -14,7 +14,7 @@ namespace osu.Game.Rulesets.Catch.Mods
     {
         public override Score CreateReplayScore(IBeatmap beatmap, IReadOnlyList<Mod> mods) => new Score
         {
-            ScoreInfo = new ScoreInfo { User = new User { Username = "osu!salad" } },
+            ScoreInfo = new ScoreInfo { User = new APIUser { Username = "osu!salad" } },
             Replay = new CatchAutoGenerator(beatmap).Generate(),
         };
     }
diff --git a/osu.Game.Rulesets.Catch/Mods/CatchModCinema.cs b/osu.Game.Rulesets.Catch/Mods/CatchModCinema.cs
index 1b7d254321..6d2286b957 100644
--- a/osu.Game.Rulesets.Catch/Mods/CatchModCinema.cs
+++ b/osu.Game.Rulesets.Catch/Mods/CatchModCinema.cs
@@ -3,11 +3,11 @@
 
 using System.Collections.Generic;
 using osu.Game.Beatmaps;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets.Catch.Objects;
 using osu.Game.Rulesets.Catch.Replays;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Scoring;
-using osu.Game.Users;
 
 namespace osu.Game.Rulesets.Catch.Mods
 {
@@ -15,7 +15,7 @@ namespace osu.Game.Rulesets.Catch.Mods
     {
         public override Score CreateReplayScore(IBeatmap beatmap, IReadOnlyList<Mod> mods) => new Score
         {
-            ScoreInfo = new ScoreInfo { User = new User { Username = "osu!salad" } },
+            ScoreInfo = new ScoreInfo { User = new APIUser { Username = "osu!salad" } },
             Replay = new CatchAutoGenerator(beatmap).Generate(),
         };
     }
diff --git a/osu.Game.Rulesets.Mania/Mods/ManiaModAutoplay.cs b/osu.Game.Rulesets.Mania/Mods/ManiaModAutoplay.cs
index 86f667466f..1504c868d0 100644
--- a/osu.Game.Rulesets.Mania/Mods/ManiaModAutoplay.cs
+++ b/osu.Game.Rulesets.Mania/Mods/ManiaModAutoplay.cs
@@ -3,11 +3,11 @@
 
 using System.Collections.Generic;
 using osu.Game.Beatmaps;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets.Mania.Beatmaps;
 using osu.Game.Rulesets.Mania.Replays;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Scoring;
-using osu.Game.Users;
 
 namespace osu.Game.Rulesets.Mania.Mods
 {
@@ -15,7 +15,7 @@ namespace osu.Game.Rulesets.Mania.Mods
     {
         public override Score CreateReplayScore(IBeatmap beatmap, IReadOnlyList<Mod> mods) => new Score
         {
-            ScoreInfo = new ScoreInfo { User = new User { Username = "osu!topus" } },
+            ScoreInfo = new ScoreInfo { User = new APIUser { Username = "osu!topus" } },
             Replay = new ManiaAutoGenerator((ManiaBeatmap)beatmap).Generate(),
         };
     }
diff --git a/osu.Game.Rulesets.Mania/Mods/ManiaModCinema.cs b/osu.Game.Rulesets.Mania/Mods/ManiaModCinema.cs
index 1c06bb389b..4f1276946b 100644
--- a/osu.Game.Rulesets.Mania/Mods/ManiaModCinema.cs
+++ b/osu.Game.Rulesets.Mania/Mods/ManiaModCinema.cs
@@ -3,12 +3,12 @@
 
 using System.Collections.Generic;
 using osu.Game.Beatmaps;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets.Mania.Beatmaps;
 using osu.Game.Rulesets.Mania.Objects;
 using osu.Game.Rulesets.Mania.Replays;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Scoring;
-using osu.Game.Users;
 
 namespace osu.Game.Rulesets.Mania.Mods
 {
@@ -16,7 +16,7 @@ namespace osu.Game.Rulesets.Mania.Mods
     {
         public override Score CreateReplayScore(IBeatmap beatmap, IReadOnlyList<Mod> mods) => new Score
         {
-            ScoreInfo = new ScoreInfo { User = new User { Username = "osu!topus" } },
+            ScoreInfo = new ScoreInfo { User = new APIUser { Username = "osu!topus" } },
             Replay = new ManiaAutoGenerator((ManiaBeatmap)beatmap).Generate(),
         };
     }
diff --git a/osu.Game.Rulesets.Osu.Tests/TestSceneMissHitWindowJudgements.cs b/osu.Game.Rulesets.Osu.Tests/TestSceneMissHitWindowJudgements.cs
index a5629119b6..840d871b7b 100644
--- a/osu.Game.Rulesets.Osu.Tests/TestSceneMissHitWindowJudgements.cs
+++ b/osu.Game.Rulesets.Osu.Tests/TestSceneMissHitWindowJudgements.cs
@@ -4,6 +4,7 @@
 using System.Collections.Generic;
 using NUnit.Framework;
 using osu.Game.Beatmaps;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Replays;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Osu.Beatmaps;
@@ -14,7 +15,6 @@ using osu.Game.Rulesets.Osu.Scoring;
 using osu.Game.Rulesets.Scoring;
 using osu.Game.Scoring;
 using osu.Game.Tests.Visual;
-using osu.Game.Users;
 using osuTK;
 
 namespace osu.Game.Rulesets.Osu.Tests
@@ -69,7 +69,7 @@ namespace osu.Game.Rulesets.Osu.Tests
         {
             public override Score CreateReplayScore(IBeatmap beatmap, IReadOnlyList<Mod> mods) => new Score
             {
-                ScoreInfo = new ScoreInfo { User = new User { Username = "Autoplay" } },
+                ScoreInfo = new ScoreInfo { User = new APIUser { Username = "Autoplay" } },
                 Replay = new MissingAutoGenerator(beatmap, mods).Generate()
             };
         }
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModAutoplay.cs b/osu.Game.Rulesets.Osu/Mods/OsuModAutoplay.cs
index 652da7123e..106edfb623 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModAutoplay.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModAutoplay.cs
@@ -5,10 +5,10 @@ using System;
 using System.Collections.Generic;
 using System.Linq;
 using osu.Game.Beatmaps;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Osu.Replays;
 using osu.Game.Scoring;
-using osu.Game.Users;
 
 namespace osu.Game.Rulesets.Osu.Mods
 {
@@ -18,7 +18,7 @@ namespace osu.Game.Rulesets.Osu.Mods
 
         public override Score CreateReplayScore(IBeatmap beatmap, IReadOnlyList<Mod> mods) => new Score
         {
-            ScoreInfo = new ScoreInfo { User = new User { Username = "Autoplay" } },
+            ScoreInfo = new ScoreInfo { User = new APIUser { Username = "Autoplay" } },
             Replay = new OsuAutoGenerator(beatmap, mods).Generate()
         };
     }
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModCinema.cs b/osu.Game.Rulesets.Osu/Mods/OsuModCinema.cs
index df06988b70..f478790134 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModCinema.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModCinema.cs
@@ -5,11 +5,11 @@ using System;
 using System.Collections.Generic;
 using System.Linq;
 using osu.Game.Beatmaps;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Osu.Objects;
 using osu.Game.Rulesets.Osu.Replays;
 using osu.Game.Scoring;
-using osu.Game.Users;
 
 namespace osu.Game.Rulesets.Osu.Mods
 {
@@ -19,7 +19,7 @@ namespace osu.Game.Rulesets.Osu.Mods
 
         public override Score CreateReplayScore(IBeatmap beatmap, IReadOnlyList<Mod> mods) => new Score
         {
-            ScoreInfo = new ScoreInfo { User = new User { Username = "Autoplay" } },
+            ScoreInfo = new ScoreInfo { User = new APIUser { Username = "Autoplay" } },
             Replay = new OsuAutoGenerator(beatmap, mods).Generate()
         };
     }
diff --git a/osu.Game.Rulesets.Taiko/Mods/TaikoModAutoplay.cs b/osu.Game.Rulesets.Taiko/Mods/TaikoModAutoplay.cs
index 31d9abf8b2..5832ae3dc1 100644
--- a/osu.Game.Rulesets.Taiko/Mods/TaikoModAutoplay.cs
+++ b/osu.Game.Rulesets.Taiko/Mods/TaikoModAutoplay.cs
@@ -3,10 +3,10 @@
 
 using System.Collections.Generic;
 using osu.Game.Beatmaps;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Taiko.Replays;
 using osu.Game.Scoring;
-using osu.Game.Users;
 
 namespace osu.Game.Rulesets.Taiko.Mods
 {
@@ -14,7 +14,7 @@ namespace osu.Game.Rulesets.Taiko.Mods
     {
         public override Score CreateReplayScore(IBeatmap beatmap, IReadOnlyList<Mod> mods) => new Score
         {
-            ScoreInfo = new ScoreInfo { User = new User { Username = "mekkadosu!" } },
+            ScoreInfo = new ScoreInfo { User = new APIUser { Username = "mekkadosu!" } },
             Replay = new TaikoAutoGenerator(beatmap).Generate(),
         };
     }
diff --git a/osu.Game.Rulesets.Taiko/Mods/TaikoModCinema.cs b/osu.Game.Rulesets.Taiko/Mods/TaikoModCinema.cs
index 00f0c8e321..f76e04a069 100644
--- a/osu.Game.Rulesets.Taiko/Mods/TaikoModCinema.cs
+++ b/osu.Game.Rulesets.Taiko/Mods/TaikoModCinema.cs
@@ -3,11 +3,11 @@
 
 using System.Collections.Generic;
 using osu.Game.Beatmaps;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Taiko.Objects;
 using osu.Game.Rulesets.Taiko.Replays;
 using osu.Game.Scoring;
-using osu.Game.Users;
 
 namespace osu.Game.Rulesets.Taiko.Mods
 {
@@ -15,7 +15,7 @@ namespace osu.Game.Rulesets.Taiko.Mods
     {
         public override Score CreateReplayScore(IBeatmap beatmap, IReadOnlyList<Mod> mods) => new Score
         {
-            ScoreInfo = new ScoreInfo { User = new User { Username = "mekkadosu!" } },
+            ScoreInfo = new ScoreInfo { User = new APIUser { Username = "mekkadosu!" } },
             Replay = new TaikoAutoGenerator(beatmap).Generate(),
         };
     }
diff --git a/osu.Game.Tests/Beatmaps/IO/ImportBeatmapTest.cs b/osu.Game.Tests/Beatmaps/IO/ImportBeatmapTest.cs
index d68d43c998..5e8d741356 100644
--- a/osu.Game.Tests/Beatmaps/IO/ImportBeatmapTest.cs
+++ b/osu.Game.Tests/Beatmaps/IO/ImportBeatmapTest.cs
@@ -17,12 +17,12 @@ using osu.Framework.Logging;
 using osu.Game.Beatmaps;
 using osu.Game.Database;
 using osu.Game.IO;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Osu.Objects;
 using osu.Game.Scoring;
 using osu.Game.Tests.Resources;
 using osu.Game.Tests.Scores.IO;
-using osu.Game.Users;
 using SharpCompress.Archives;
 using SharpCompress.Archives.Zip;
 using SharpCompress.Common;
@@ -859,7 +859,7 @@ namespace osu.Game.Tests.Beatmaps.IO
 
                     var manager = osu.Dependencies.Get<BeatmapManager>();
 
-                    var working = manager.CreateNew(new OsuRuleset().RulesetInfo, User.SYSTEM_USER);
+                    var working = manager.CreateNew(new OsuRuleset().RulesetInfo, APIUser.SYSTEM_USER);
 
                     var beatmap = working.Beatmap;
 
@@ -892,7 +892,7 @@ namespace osu.Game.Tests.Beatmaps.IO
                     var osu = LoadOsuIntoHost(host);
                     var manager = osu.Dependencies.Get<BeatmapManager>();
 
-                    var working = manager.CreateNew(new OsuRuleset().RulesetInfo, User.SYSTEM_USER);
+                    var working = manager.CreateNew(new OsuRuleset().RulesetInfo, APIUser.SYSTEM_USER);
 
                     manager.Save(working.BeatmapInfo, working.Beatmap);
 
@@ -919,7 +919,7 @@ namespace osu.Game.Tests.Beatmaps.IO
                     var osu = LoadOsuIntoHost(host);
                     var manager = osu.Dependencies.Get<BeatmapManager>();
 
-                    var working = manager.CreateNew(new OsuRuleset().RulesetInfo, User.SYSTEM_USER);
+                    var working = manager.CreateNew(new OsuRuleset().RulesetInfo, APIUser.SYSTEM_USER);
 
                     ((Beatmap)working.Beatmap).HitObjects.Add(new HitCircle { StartTime = 5000 });
 
diff --git a/osu.Game.Tests/Beatmaps/ToStringFormattingTest.cs b/osu.Game.Tests/Beatmaps/ToStringFormattingTest.cs
index c477bbd9cf..da7f32a2d3 100644
--- a/osu.Game.Tests/Beatmaps/ToStringFormattingTest.cs
+++ b/osu.Game.Tests/Beatmaps/ToStringFormattingTest.cs
@@ -3,7 +3,7 @@
 
 using NUnit.Framework;
 using osu.Game.Beatmaps;
-using osu.Game.Users;
+using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Tests.Beatmaps
 {
@@ -34,7 +34,7 @@ namespace osu.Game.Tests.Beatmaps
                 {
                     Artist = "artist",
                     Title = "title",
-                    Author = new User { Username = "creator" }
+                    Author = new APIUser { Username = "creator" }
                 }
             };
 
@@ -50,7 +50,7 @@ namespace osu.Game.Tests.Beatmaps
                 {
                     Artist = "artist",
                     Title = "title",
-                    Author = new User { Username = "creator" }
+                    Author = new APIUser { Username = "creator" }
                 },
                 Version = "difficulty"
             };
diff --git a/osu.Game.Tests/Chat/TestSceneChannelManager.cs b/osu.Game.Tests/Chat/TestSceneChannelManager.cs
index 5e22101e5c..eaacc623c9 100644
--- a/osu.Game.Tests/Chat/TestSceneChannelManager.cs
+++ b/osu.Game.Tests/Chat/TestSceneChannelManager.cs
@@ -9,9 +9,9 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Testing;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Chat;
 using osu.Game.Tests.Visual;
-using osu.Game.Users;
 
 namespace osu.Game.Tests.Chat
 {
@@ -133,7 +133,7 @@ namespace osu.Game.Tests.Chat
             }
         }
 
-        private Channel createChannel(int id, ChannelType type) => new Channel(new User())
+        private Channel createChannel(int id, ChannelType type) => new Channel(new APIUser())
         {
             Id = id,
             Name = $"Channel {id}",
diff --git a/osu.Game.Tests/NonVisual/Multiplayer/StatefulMultiplayerClientTest.cs b/osu.Game.Tests/NonVisual/Multiplayer/StatefulMultiplayerClientTest.cs
index 8e2259bce8..abe5664737 100644
--- a/osu.Game.Tests/NonVisual/Multiplayer/StatefulMultiplayerClientTest.cs
+++ b/osu.Game.Tests/NonVisual/Multiplayer/StatefulMultiplayerClientTest.cs
@@ -6,10 +6,10 @@ using Humanizer;
 using NUnit.Framework;
 using osu.Framework.Extensions.ObjectExtensions;
 using osu.Framework.Testing;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Rooms;
 using osu.Game.Tests.Visual.Multiplayer;
-using osu.Game.Users;
 
 namespace osu.Game.Tests.NonVisual.Multiplayer
 {
@@ -21,7 +21,7 @@ namespace osu.Game.Tests.NonVisual.Multiplayer
         {
             int id = 2000;
 
-            AddRepeatStep("add some users", () => Client.AddUser(new User { Id = id++ }), 5);
+            AddRepeatStep("add some users", () => Client.AddUser(new APIUser { Id = id++ }), 5);
             checkPlayingUserCount(0);
 
             AddAssert("playlist item is available", () => Client.CurrentMatchPlayingItem.Value != null);
@@ -64,7 +64,7 @@ namespace osu.Game.Tests.NonVisual.Multiplayer
                     room.State = MultiplayerRoomState.Playing;
                     room.Users.Add(new MultiplayerRoomUser(PLAYER_1_ID)
                     {
-                        User = new User { Id = PLAYER_1_ID },
+                        User = new APIUser { Id = PLAYER_1_ID },
                         State = MultiplayerUserState.Playing
                     });
                 };
diff --git a/osu.Game.Tests/OnlinePlay/StatefulMultiplayerClientTest.cs b/osu.Game.Tests/OnlinePlay/StatefulMultiplayerClientTest.cs
index 82ce588c6f..5a621ecf84 100644
--- a/osu.Game.Tests/OnlinePlay/StatefulMultiplayerClientTest.cs
+++ b/osu.Game.Tests/OnlinePlay/StatefulMultiplayerClientTest.cs
@@ -3,8 +3,8 @@
 
 using NUnit.Framework;
 using osu.Framework.Testing;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Tests.Visual.Multiplayer;
-using osu.Game.Users;
 
 namespace osu.Game.Tests.OnlinePlay
 {
@@ -14,7 +14,7 @@ namespace osu.Game.Tests.OnlinePlay
         [Test]
         public void TestUserAddedOnJoin()
         {
-            var user = new User { Id = 33 };
+            var user = new APIUser { Id = 33 };
 
             AddRepeatStep("add user multiple times", () => Client.AddUser(user), 3);
             AddAssert("room has 2 users", () => Client.Room?.Users.Count == 2);
@@ -23,7 +23,7 @@ namespace osu.Game.Tests.OnlinePlay
         [Test]
         public void TestUserRemovedOnLeave()
         {
-            var user = new User { Id = 44 };
+            var user = new APIUser { Id = 44 };
 
             AddStep("add user", () => Client.AddUser(user));
             AddAssert("room has 2 users", () => Client.Room?.Users.Count == 2);
diff --git a/osu.Game.Tests/Scores/IO/ImportScoreTest.cs b/osu.Game.Tests/Scores/IO/ImportScoreTest.cs
index 2cd02329b7..be7803734e 100644
--- a/osu.Game.Tests/Scores/IO/ImportScoreTest.cs
+++ b/osu.Game.Tests/Scores/IO/ImportScoreTest.cs
@@ -11,12 +11,12 @@ using osu.Framework.Allocation;
 using osu.Framework.Platform;
 using osu.Game.Beatmaps;
 using osu.Game.IO.Archives;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Osu.Mods;
 using osu.Game.Rulesets.Scoring;
 using osu.Game.Scoring;
-using osu.Game.Users;
 
 namespace osu.Game.Tests.Scores.IO
 {
@@ -38,7 +38,7 @@ namespace osu.Game.Tests.Scores.IO
                         Accuracy = 0.8,
                         MaxCombo = 500,
                         Combo = 250,
-                        User = new User { Username = "Test user" },
+                        User = new APIUser { Username = "Test user" },
                         Date = DateTimeOffset.Now,
                         OnlineScoreID = 12345,
                     };
diff --git a/osu.Game.Tests/Visual/Background/TestSceneBackgroundScreenDefault.cs b/osu.Game.Tests/Visual/Background/TestSceneBackgroundScreenDefault.cs
index f7d42a2ee6..ec16578b71 100644
--- a/osu.Game.Tests/Visual/Background/TestSceneBackgroundScreenDefault.cs
+++ b/osu.Game.Tests/Visual/Background/TestSceneBackgroundScreenDefault.cs
@@ -10,10 +10,10 @@ using osu.Framework.Testing;
 using osu.Game.Configuration;
 using osu.Game.Graphics.Backgrounds;
 using osu.Game.Online.API;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Screens;
 using osu.Game.Screens.Backgrounds;
 using osu.Game.Skinning;
-using osu.Game.Users;
 
 namespace osu.Game.Tests.Visual.Background
 {
@@ -113,7 +113,7 @@ namespace osu.Game.Tests.Visual.Background
             AddStep($"set background mode to {source}", () => config.SetValue(OsuSetting.MenuBackgroundSource, source));
 
         private void setSupporter(bool isSupporter) =>
-            AddStep($"set supporter {isSupporter}", () => ((DummyAPIAccess)API).LocalUser.Value = new User
+            AddStep($"set supporter {isSupporter}", () => ((DummyAPIAccess)API).LocalUser.Value = new APIUser
             {
                 IsSupporter = isSupporter,
                 Id = API.LocalUser.Value.Id + 1,
diff --git a/osu.Game.Tests/Visual/Background/TestSceneUserDimBackgrounds.cs b/osu.Game.Tests/Visual/Background/TestSceneUserDimBackgrounds.cs
index 693c66ccb0..69ea1dc520 100644
--- a/osu.Game.Tests/Visual/Background/TestSceneUserDimBackgrounds.cs
+++ b/osu.Game.Tests/Visual/Background/TestSceneUserDimBackgrounds.cs
@@ -18,6 +18,7 @@ using osu.Game.Configuration;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Osu.Mods;
 using osu.Game.Scoring;
@@ -29,7 +30,6 @@ using osu.Game.Screens.Ranking;
 using osu.Game.Screens.Select;
 using osu.Game.Tests.Beatmaps;
 using osu.Game.Tests.Resources;
-using osu.Game.Users;
 using osuTK;
 using osuTK.Graphics;
 
@@ -231,7 +231,7 @@ namespace osu.Game.Tests.Visual.Background
 
             AddStep("Transition to Results", () => player.Push(results = new FadeAccessibleResults(new ScoreInfo
             {
-                User = new User { Username = "osu!" },
+                User = new APIUser { Username = "osu!" },
                 BeatmapInfo = new TestBeatmap(Ruleset.Value).BeatmapInfo,
                 Ruleset = Ruleset.Value,
             })));
diff --git a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs
index 2aeb4ab4e2..2f2594d5ed 100644
--- a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs
+++ b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs
@@ -13,8 +13,8 @@ using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.Drawables.Cards;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays;
-using osu.Game.Users;
 using osuTK;
+using APIUser = osu.Game.Online.API.Requests.Responses.APIUser;
 
 namespace osu.Game.Tests.Visual.Beatmaps
 {
@@ -75,7 +75,7 @@ namespace osu.Game.Tests.Visual.Beatmaps
             Title = "undownloadable beatmap",
             Artist = "test",
             Source = "more tests",
-            Author = new User
+            Author = new APIUser
             {
                 Username = "BanchoBot",
                 Id = 3,
@@ -120,7 +120,7 @@ namespace osu.Game.Tests.Visual.Beatmaps
                 OnlineID = 1,
                 Title = "many difficulties beatmap",
                 Artist = "test",
-                Author = new User
+                Author = new APIUser
                 {
                     Username = "BanchoBot",
                     Id = 3,
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneGameplayLeaderboard.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneGameplayLeaderboard.cs
index 0441c5641e..74212de210 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneGameplayLeaderboard.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneGameplayLeaderboard.cs
@@ -7,8 +7,8 @@ using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Testing;
 using osu.Framework.Utils;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Screens.Play.HUD;
-using osu.Game.Users;
 using osuTK;
 
 namespace osu.Game.Tests.Visual.Gameplay
@@ -39,7 +39,7 @@ namespace osu.Game.Tests.Visual.Gameplay
                 playerScore.Value = 1222333;
             });
 
-            AddStep("add local player", () => createLeaderboardScore(playerScore, new User { Username = "You", Id = 3 }, true));
+            AddStep("add local player", () => createLeaderboardScore(playerScore, new APIUser { Username = "You", Id = 3 }, true));
             AddStep("toggle expanded", () => leaderboard.Expanded.Value = !leaderboard.Expanded.Value);
             AddSliderStep("set player score", 50, 5000000, 1222333, v => playerScore.Value = v);
         }
@@ -50,8 +50,8 @@ namespace osu.Game.Tests.Visual.Gameplay
             var player2Score = new BindableDouble(1234567);
             var player3Score = new BindableDouble(1111111);
 
-            AddStep("add player 2", () => createLeaderboardScore(player2Score, new User { Username = "Player 2" }));
-            AddStep("add player 3", () => createLeaderboardScore(player3Score, new User { Username = "Player 3" }));
+            AddStep("add player 2", () => createLeaderboardScore(player2Score, new APIUser { Username = "Player 2" }));
+            AddStep("add player 3", () => createLeaderboardScore(player3Score, new APIUser { Username = "Player 3" }));
 
             AddUntilStep("is player 2 position #1", () => leaderboard.CheckPositionByUsername("Player 2", 1));
             AddUntilStep("is player position #2", () => leaderboard.CheckPositionByUsername("You", 2));
@@ -72,38 +72,38 @@ namespace osu.Game.Tests.Visual.Gameplay
         public void TestRandomScores()
         {
             int playerNumber = 1;
-            AddRepeatStep("add player with random score", () => createRandomScore(new User { Username = $"Player {playerNumber++}" }), 10);
+            AddRepeatStep("add player with random score", () => createRandomScore(new APIUser { Username = $"Player {playerNumber++}" }), 10);
         }
 
         [Test]
         public void TestExistingUsers()
         {
-            AddStep("add peppy", () => createRandomScore(new User { Username = "peppy", Id = 2 }));
-            AddStep("add smoogipoo", () => createRandomScore(new User { Username = "smoogipoo", Id = 1040328 }));
-            AddStep("add flyte", () => createRandomScore(new User { Username = "flyte", Id = 3103765 }));
-            AddStep("add frenzibyte", () => createRandomScore(new User { Username = "frenzibyte", Id = 14210502 }));
+            AddStep("add peppy", () => createRandomScore(new APIUser { Username = "peppy", Id = 2 }));
+            AddStep("add smoogipoo", () => createRandomScore(new APIUser { Username = "smoogipoo", Id = 1040328 }));
+            AddStep("add flyte", () => createRandomScore(new APIUser { Username = "flyte", Id = 3103765 }));
+            AddStep("add frenzibyte", () => createRandomScore(new APIUser { Username = "frenzibyte", Id = 14210502 }));
         }
 
         [Test]
         public void TestMaxHeight()
         {
             int playerNumber = 1;
-            AddRepeatStep("add 3 other players", () => createRandomScore(new User { Username = $"Player {playerNumber++}" }), 3);
+            AddRepeatStep("add 3 other players", () => createRandomScore(new APIUser { Username = $"Player {playerNumber++}" }), 3);
             checkHeight(4);
 
-            AddRepeatStep("add 4 other players", () => createRandomScore(new User { Username = $"Player {playerNumber++}" }), 4);
+            AddRepeatStep("add 4 other players", () => createRandomScore(new APIUser { Username = $"Player {playerNumber++}" }), 4);
             checkHeight(8);
 
-            AddRepeatStep("add 4 other players", () => createRandomScore(new User { Username = $"Player {playerNumber++}" }), 4);
+            AddRepeatStep("add 4 other players", () => createRandomScore(new APIUser { Username = $"Player {playerNumber++}" }), 4);
             checkHeight(8);
 
             void checkHeight(int panelCount)
                 => AddAssert($"leaderboard height is {panelCount} panels high", () => leaderboard.DrawHeight == (GameplayLeaderboardScore.PANEL_HEIGHT + leaderboard.Spacing) * panelCount);
         }
 
-        private void createRandomScore(User user) => createLeaderboardScore(new BindableDouble(RNG.Next(0, 5_000_000)), user);
+        private void createRandomScore(APIUser user) => createLeaderboardScore(new BindableDouble(RNG.Next(0, 5_000_000)), user);
 
-        private void createLeaderboardScore(BindableDouble score, User user, bool isTracked = false)
+        private void createLeaderboardScore(BindableDouble score, APIUser user, bool isTracked = false)
         {
             var leaderboardScore = leaderboard.Add(user, isTracked);
             leaderboardScore.TotalScore.BindTo(score);
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneReplayDownloadButton.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneReplayDownloadButton.cs
index 64d9addc77..c4a99eeb6c 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneReplayDownloadButton.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneReplayDownloadButton.cs
@@ -7,7 +7,6 @@ using osu.Framework.Graphics;
 using osu.Game.Online;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Scoring;
-using osu.Game.Users;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Testing;
@@ -16,6 +15,7 @@ using osu.Game.Rulesets;
 using osu.Game.Rulesets.Osu;
 using osu.Game.Screens.Ranking;
 using osuTK.Input;
+using APIUser = osu.Game.Online.API.Requests.Responses.APIUser;
 
 namespace osu.Game.Tests.Visual.Gameplay
 {
@@ -139,7 +139,7 @@ namespace osu.Game.Tests.Visual.Gameplay
                 RulesetID = 0,
                 Beatmap = CreateAPIBeatmapSet(new OsuRuleset().RulesetInfo).Beatmaps.First(),
                 HasReplay = replayAvailable,
-                User = new User
+                User = new APIUser
                 {
                     Id = 39828,
                     Username = @"WubWoofWolf",
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs
index 21c5d89aca..20e859dd2b 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs
@@ -9,6 +9,7 @@ using osu.Framework.Screens;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
 using osu.Game.Database;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Spectator;
 using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Osu.Replays;
@@ -18,13 +19,12 @@ using osu.Game.Screens.Play;
 using osu.Game.Tests.Beatmaps.IO;
 using osu.Game.Tests.Visual.Multiplayer;
 using osu.Game.Tests.Visual.Spectator;
-using osu.Game.Users;
 
 namespace osu.Game.Tests.Visual.Gameplay
 {
     public class TestSceneSpectator : ScreenTestScene
     {
-        private readonly User streamingUser = new User { Id = MultiplayerTestScene.PLAYER_1_ID, Username = "Test user" };
+        private readonly APIUser streamingUser = new APIUser { Id = MultiplayerTestScene.PLAYER_1_ID, Username = "Test user" };
 
         [Cached(typeof(UserLookupCache))]
         private UserLookupCache lookupCache = new TestUserLookupCache();
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorHost.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorHost.cs
index 89fea1f92d..2a82c65c7c 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorHost.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorHost.cs
@@ -4,11 +4,11 @@
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Game.Online.API;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Spectator;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Mania;
 using osu.Game.Tests.Visual.Spectator;
-using osu.Game.Users;
 
 namespace osu.Game.Tests.Visual.Gameplay
 {
@@ -24,7 +24,7 @@ namespace osu.Game.Tests.Visual.Gameplay
 
         public override void SetUpSteps()
         {
-            AddStep("set dummy user", () => dummyAPIAccess.LocalUser.Value = new User
+            AddStep("set dummy user", () => dummyAPIAccess.LocalUser.Value = new APIUser
             {
                 Id = dummy_user_id,
                 Username = "DummyUser"
diff --git a/osu.Game.Tests/Visual/Menus/TestSceneDisclaimer.cs b/osu.Game.Tests/Visual/Menus/TestSceneDisclaimer.cs
index 9cbdee3632..db5891bd4e 100644
--- a/osu.Game.Tests/Visual/Menus/TestSceneDisclaimer.cs
+++ b/osu.Game.Tests/Visual/Menus/TestSceneDisclaimer.cs
@@ -3,8 +3,8 @@
 
 using osu.Framework.Allocation;
 using osu.Game.Online.API;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Screens.Menu;
-using osu.Game.Users;
 
 namespace osu.Game.Tests.Visual.Menus
 {
@@ -17,7 +17,7 @@ namespace osu.Game.Tests.Visual.Menus
 
             AddStep("toggle support", () =>
             {
-                ((DummyAPIAccess)API).LocalUser.Value = new User
+                ((DummyAPIAccess)API).LocalUser.Value = new APIUser
                 {
                     Username = API.LocalUser.Value.Username,
                     Id = API.LocalUser.Value.Id + 1,
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoom.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoom.cs
index 84a6e95883..721862c177 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoom.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoom.cs
@@ -10,6 +10,7 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Testing;
 using osu.Framework.Utils;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Rooms;
 using osu.Game.Online.Rooms.RoomStatuses;
 using osu.Game.Overlays;
@@ -17,7 +18,6 @@ using osu.Game.Rulesets.Osu;
 using osu.Game.Screens.OnlinePlay.Lounge;
 using osu.Game.Screens.OnlinePlay.Lounge.Components;
 using osu.Game.Tests.Beatmaps;
-using osu.Game.Users;
 using osuTK;
 
 namespace osu.Game.Tests.Visual.Multiplayer
@@ -174,11 +174,11 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
         private DrawableRoom createLoungeRoom(Room room)
         {
-            room.Host.Value ??= new User { Username = "peppy", Id = 2 };
+            room.Host.Value ??= new APIUser { Username = "peppy", Id = 2 };
 
             if (room.RecentParticipants.Count == 0)
             {
-                room.RecentParticipants.AddRange(Enumerable.Range(0, 20).Select(i => new User
+                room.RecentParticipants.AddRange(Enumerable.Range(0, 20).Select(i => new APIUser
                 {
                     Id = i,
                     Username = $"User {i}"
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomParticipantsList.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomParticipantsList.cs
index 982dfc5cd9..60f47a01a9 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomParticipantsList.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomParticipantsList.cs
@@ -5,10 +5,10 @@ using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Graphics;
 using osu.Framework.Testing;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Rooms;
 using osu.Game.Screens.OnlinePlay.Lounge.Components;
 using osu.Game.Tests.Visual.OnlinePlay;
-using osu.Game.Users;
 using osu.Game.Users.Drawables;
 
 namespace osu.Game.Tests.Visual.Multiplayer
@@ -25,7 +25,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 Name = { Value = "test room" },
                 Host =
                 {
-                    Value = new User
+                    Value = new APIUser
                     {
                         Id = 2,
                         Username = "peppy",
@@ -137,7 +137,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
         private void addUser(int id)
         {
-            SelectedRoom.Value.RecentParticipants.Add(new User
+            SelectedRoom.Value.RecentParticipants.Add(new APIUser
             {
                 Id = id,
                 Username = $"User {id}"
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
index afd48d5191..8ac0a2cbe5 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
@@ -14,6 +14,7 @@ using osu.Framework.Testing;
 using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.Drawables;
 using osu.Game.Graphics.Containers;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Rooms;
 using osu.Game.Overlays.BeatmapListing.Panels;
 using osu.Game.Rulesets;
@@ -21,7 +22,6 @@ using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Osu.Mods;
 using osu.Game.Screens.OnlinePlay;
 using osu.Game.Tests.Beatmaps;
-using osu.Game.Users;
 using osuTK;
 using osuTK.Input;
 
@@ -294,7 +294,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                                     Metadata = new BeatmapMetadata
                                     {
                                         Artist = "Artist",
-                                        Author = new User { Username = "Creator name here" },
+                                        Author = new APIUser { Username = "Creator name here" },
                                         Title = "Long title used to check background colour",
                                     },
                                     BeatmapSet = new BeatmapSetInfo()
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchLeaderboard.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchLeaderboard.cs
index a7a5f3af39..955710bd50 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchLeaderboard.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchLeaderboard.cs
@@ -10,8 +10,8 @@ using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Rooms;
 using osu.Game.Screens.OnlinePlay.Match.Components;
 using osu.Game.Tests.Visual.OnlinePlay;
-using osu.Game.Users;
 using osuTK;
+using APIUser = osu.Game.Online.API.Requests.Responses.APIUser;
 
 namespace osu.Game.Tests.Visual.Multiplayer
 {
@@ -32,7 +32,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                                 new APIUserScoreAggregate
                                 {
                                     UserID = 2,
-                                    User = new User { Id = 2, Username = "peppy" },
+                                    User = new APIUser { Id = 2, Username = "peppy" },
                                     TotalScore = 995533,
                                     RoomID = 3,
                                     CompletedBeatmaps = 1,
@@ -42,7 +42,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                                 new APIUserScoreAggregate
                                 {
                                     UserID = 1040328,
-                                    User = new User { Id = 1040328, Username = "smoogipoo" },
+                                    User = new APIUser { Id = 1040328, Username = "smoogipoo" },
                                     TotalScore = 981100,
                                     RoomID = 3,
                                     CompletedBeatmaps = 1,
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorLeaderboard.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorLeaderboard.cs
index bd5320354e..a61e505970 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorLeaderboard.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorLeaderboard.cs
@@ -6,11 +6,11 @@ using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Testing;
 using osu.Framework.Timing;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Rulesets.Osu.Scoring;
 using osu.Game.Screens.OnlinePlay.Multiplayer.Spectate;
 using osu.Game.Screens.Play.HUD;
-using osu.Game.Users;
 
 namespace osu.Game.Tests.Visual.Multiplayer
 {
@@ -35,7 +35,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 foreach ((int userId, var _) in clocks)
                 {
                     SpectatorClient.StartPlay(userId, 0);
-                    OnlinePlayDependencies.Client.AddUser(new User { Id = userId });
+                    OnlinePlayDependencies.Client.AddUser(new APIUser { Id = userId });
                 }
             });
 
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs
index 7ff8c82145..fdd01446b9 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs
@@ -11,6 +11,7 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
 using osu.Game.Configuration;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Multiplayer.MatchTypes.TeamVersus;
 using osu.Game.Rulesets.UI;
@@ -19,7 +20,6 @@ using osu.Game.Screens.Play;
 using osu.Game.Screens.Play.HUD;
 using osu.Game.Screens.Play.PlayerSettings;
 using osu.Game.Tests.Beatmaps.IO;
-using osu.Game.Users;
 using osuTK.Graphics;
 
 namespace osu.Game.Tests.Visual.Multiplayer
@@ -59,8 +59,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             AddStep("start players silently", () =>
             {
-                OnlinePlayDependencies.Client.AddUser(new User { Id = PLAYER_1_ID }, true);
-                OnlinePlayDependencies.Client.AddUser(new User { Id = PLAYER_2_ID }, true);
+                OnlinePlayDependencies.Client.AddUser(new APIUser { Id = PLAYER_1_ID }, true);
+                OnlinePlayDependencies.Client.AddUser(new APIUser { Id = PLAYER_2_ID }, true);
 
                 playingUsers.Add(new MultiplayerRoomUser(PLAYER_1_ID));
                 playingUsers.Add(new MultiplayerRoomUser(PLAYER_2_ID));
@@ -120,13 +120,13 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             AddStep("start players", () =>
             {
-                var player1 = OnlinePlayDependencies.Client.AddUser(new User { Id = PLAYER_1_ID }, true);
+                var player1 = OnlinePlayDependencies.Client.AddUser(new APIUser { Id = PLAYER_1_ID }, true);
                 player1.MatchState = new TeamVersusUserState
                 {
                     TeamID = 0,
                 };
 
-                var player2 = OnlinePlayDependencies.Client.AddUser(new User { Id = PLAYER_2_ID }, true);
+                var player2 = OnlinePlayDependencies.Client.AddUser(new APIUser { Id = PLAYER_2_ID }, true);
                 player2.MatchState = new TeamVersusUserState
                 {
                     TeamID = 1,
@@ -367,7 +367,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 {
                     var user = new MultiplayerRoomUser(id)
                     {
-                        User = new User { Id = id },
+                        User = new APIUser { Id = id },
                     };
 
                     OnlinePlayDependencies.Client.AddUser(user.User, true);
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
index 38cf9d662f..e831d5b564 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
@@ -17,6 +17,7 @@ using osu.Framework.Utils;
 using osu.Game.Beatmaps;
 using osu.Game.Database;
 using osu.Game.Graphics.UserInterface;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Rooms;
 using osu.Game.Overlays.Mods;
@@ -32,7 +33,6 @@ using osu.Game.Screens.Play;
 using osu.Game.Screens.Ranking;
 using osu.Game.Screens.Spectate;
 using osu.Game.Tests.Resources;
-using osu.Game.Users;
 using osuTK.Input;
 
 namespace osu.Game.Tests.Visual.Multiplayer
@@ -129,12 +129,12 @@ namespace osu.Game.Tests.Visual.Multiplayer
         private void addRandomPlayer()
         {
             int randomUser = RNG.Next(200000, 500000);
-            client.AddUser(new User { Id = randomUser, Username = $"user {randomUser}" });
+            client.AddUser(new APIUser { Id = randomUser, Username = $"user {randomUser}" });
         }
 
         private void removeLastUser()
         {
-            User lastUser = client.Room?.Users.Last().User;
+            APIUser lastUser = client.Room?.Users.Last().User;
 
             if (lastUser == null || lastUser == client.LocalUser?.User)
                 return;
@@ -144,7 +144,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
         private void kickLastUser()
         {
-            User lastUser = client.Room?.Users.Last().User;
+            APIUser lastUser = client.Room?.Users.Last().User;
 
             if (lastUser == null || lastUser == client.LocalUser?.User)
                 return;
@@ -414,7 +414,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             AddStep("join other user (ready, host)", () =>
             {
-                client.AddUser(new User { Id = MultiplayerTestScene.PLAYER_1_ID, Username = "Other" });
+                client.AddUser(new APIUser { Id = MultiplayerTestScene.PLAYER_1_ID, Username = "Other" });
                 client.TransferHost(MultiplayerTestScene.PLAYER_1_ID);
                 client.ChangeUserState(MultiplayerTestScene.PLAYER_1_ID, MultiplayerUserState.Ready);
             });
@@ -454,7 +454,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             AddStep("join other user (ready, host)", () =>
             {
-                client.AddUser(new User { Id = MultiplayerTestScene.PLAYER_1_ID, Username = "Other" });
+                client.AddUser(new APIUser { Id = MultiplayerTestScene.PLAYER_1_ID, Username = "Other" });
                 client.TransferHost(MultiplayerTestScene.PLAYER_1_ID);
                 client.ChangeUserState(MultiplayerTestScene.PLAYER_1_ID, MultiplayerUserState.Ready);
             });
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs
index 832998d5d3..902629765f 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs
@@ -11,6 +11,7 @@ using osu.Framework.Graphics;
 using osu.Framework.Utils;
 using osu.Game.Configuration;
 using osu.Game.Online.API;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Spectator;
 using osu.Game.Replays.Legacy;
@@ -20,7 +21,6 @@ using osu.Game.Scoring;
 using osu.Game.Screens.Play.HUD;
 using osu.Game.Tests.Visual.OnlinePlay;
 using osu.Game.Tests.Visual.Spectator;
-using osu.Game.Users;
 
 namespace osu.Game.Tests.Visual.Multiplayer
 {
@@ -58,7 +58,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 foreach (int user in users)
                 {
                     SpectatorClient.StartPlay(user, Beatmap.Value.BeatmapInfo.OnlineBeatmapID ?? 0);
-                    multiplayerUsers.Add(OnlinePlayDependencies.Client.AddUser(new User { Id = user }, true));
+                    multiplayerUsers.Add(OnlinePlayDependencies.Client.AddUser(new APIUser { Id = user }, true));
                 }
 
                 Children = new Drawable[]
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboardTeams.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboardTeams.cs
index 3d48ddc7ca..af4e696fce 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboardTeams.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboardTeams.cs
@@ -7,6 +7,7 @@ using NUnit.Framework;
 using osu.Framework.Graphics;
 using osu.Framework.Utils;
 using osu.Game.Online.API;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Multiplayer.MatchTypes.TeamVersus;
 using osu.Game.Online.Rooms;
@@ -15,7 +16,6 @@ using osu.Game.Screens.OnlinePlay.Multiplayer;
 using osu.Game.Screens.Play.HUD;
 using osu.Game.Tests.Visual.OnlinePlay;
 using osu.Game.Tests.Visual.Spectator;
-using osu.Game.Users;
 
 namespace osu.Game.Tests.Visual.Multiplayer
 {
@@ -62,7 +62,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 foreach (int user in users)
                 {
                     SpectatorClient.StartPlay(user, Beatmap.Value.BeatmapInfo.OnlineBeatmapID ?? 0);
-                    var roomUser = OnlinePlayDependencies.Client.AddUser(new User { Id = user }, true);
+                    var roomUser = OnlinePlayDependencies.Client.AddUser(new APIUser { Id = user }, true);
 
                     roomUser.MatchState = new TeamVersusUserState
                     {
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs
index 21364fe154..bb5735a3b5 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs
@@ -9,6 +9,7 @@ using osu.Framework.Platform;
 using osu.Framework.Screens;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Rooms;
 using osu.Game.Rulesets;
@@ -18,7 +19,6 @@ using osu.Game.Screens.OnlinePlay.Multiplayer;
 using osu.Game.Screens.OnlinePlay.Multiplayer.Match;
 using osu.Game.Tests.Beatmaps;
 using osu.Game.Tests.Resources;
-using osu.Game.Users;
 using osuTK.Input;
 
 namespace osu.Game.Tests.Visual.Multiplayer
@@ -119,7 +119,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             AddStep("join other user (ready)", () =>
             {
-                Client.AddUser(new User { Id = PLAYER_1_ID });
+                Client.AddUser(new APIUser { Id = PLAYER_1_ID });
                 Client.ChangeUserState(PLAYER_1_ID, MultiplayerUserState.Ready);
             });
 
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerParticipantsList.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerParticipantsList.cs
index 2549681519..671b85164b 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerParticipantsList.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerParticipantsList.cs
@@ -11,6 +11,7 @@ using osu.Framework.Testing;
 using osu.Framework.Utils;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Online;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Rooms;
 using osu.Game.Rulesets.Mods;
@@ -34,7 +35,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             AddAssert("one unique panel", () => this.ChildrenOfType<ParticipantPanel>().Select(p => p.User).Distinct().Count() == 1);
 
-            AddStep("add user", () => Client.AddUser(new User
+            AddStep("add user", () => Client.AddUser(new APIUser
             {
                 Id = 3,
                 Username = "Second",
@@ -63,11 +64,11 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [Test]
         public void TestRemoveUser()
         {
-            User secondUser = null;
+            APIUser secondUser = null;
 
             AddStep("add a user", () =>
             {
-                Client.AddUser(secondUser = new User
+                Client.AddUser(secondUser = new APIUser
                 {
                     Id = 3,
                     Username = "Second",
@@ -146,7 +147,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [Test]
         public void TestCrownChangesStateWhenHostTransferred()
         {
-            AddStep("add user", () => Client.AddUser(new User
+            AddStep("add user", () => Client.AddUser(new APIUser
             {
                 Id = 3,
                 Username = "Second",
@@ -165,7 +166,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [Test]
         public void TestKickButtonOnlyPresentWhenHost()
         {
-            AddStep("add user", () => Client.AddUser(new User
+            AddStep("add user", () => Client.AddUser(new APIUser
             {
                 Id = 3,
                 Username = "Second",
@@ -186,7 +187,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [Test]
         public void TestKickButtonKicks()
         {
-            AddStep("add user", () => Client.AddUser(new User
+            AddStep("add user", () => Client.AddUser(new APIUser
             {
                 Id = 3,
                 Username = "Second",
@@ -205,7 +206,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             {
                 for (int i = 0; i < 20; i++)
                 {
-                    Client.AddUser(new User
+                    Client.AddUser(new APIUser
                     {
                         Id = i,
                         Username = $"User {i}",
@@ -249,7 +250,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             AddStep("add user", () =>
             {
-                Client.AddUser(new User
+                Client.AddUser(new APIUser
                 {
                     Id = 0,
                     Username = "User 0",
@@ -295,7 +296,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             AddStep("add user with mods", () =>
             {
-                Client.AddUser(new User
+                Client.AddUser(new APIUser
                 {
                     Id = 0,
                     Username = "Baka",
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs
index 820b403a10..e9612bf55c 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs
@@ -14,12 +14,12 @@ using osu.Framework.Testing;
 using osu.Framework.Utils;
 using osu.Game.Beatmaps;
 using osu.Game.Graphics.UserInterface;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Rooms;
 using osu.Game.Rulesets;
 using osu.Game.Screens.OnlinePlay.Multiplayer.Match;
 using osu.Game.Tests.Resources;
-using osu.Game.Users;
 using osuTK;
 using osuTK.Input;
 
@@ -108,7 +108,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             AddStep("add second user as host", () =>
             {
-                Client.AddUser(new User { Id = 2, Username = "Another user" });
+                Client.AddUser(new APIUser { Id = 2, Username = "Another user" });
                 Client.TransferHost(2);
             });
 
@@ -128,7 +128,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 Client.TransferHost(Client.Room?.Users[0].UserID ?? 0);
 
                 if (!allReady)
-                    Client.AddUser(new User { Id = 2, Username = "Another user" });
+                    Client.AddUser(new APIUser { Id = 2, Username = "Another user" });
             });
 
             addClickButtonStep();
@@ -142,7 +142,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             AddStep("add host", () =>
             {
-                Client.AddUser(new User { Id = 2, Username = "Another user" });
+                Client.AddUser(new APIUser { Id = 2, Username = "Another user" });
                 Client.TransferHost(2);
             });
 
@@ -158,7 +158,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddStep("setup", () =>
             {
                 Client.TransferHost(Client.Room?.Users[0].UserID ?? 0);
-                Client.AddUser(new User { Id = 2, Username = "Another user" });
+                Client.AddUser(new APIUser { Id = 2, Username = "Another user" });
             });
 
             addClickButtonStep();
@@ -177,7 +177,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             {
                 Client.TransferHost(Client.Room?.Users[0].UserID ?? 0);
                 for (int i = 0; i < users; i++)
-                    Client.AddUser(new User { Id = i, Username = "Another user" });
+                    Client.AddUser(new APIUser { Id = i, Username = "Another user" });
             });
 
             if (!isHost)
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerResults.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerResults.cs
index 5032cdaec7..c0b21c4421 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerResults.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerResults.cs
@@ -3,11 +3,11 @@
 
 using System;
 using NUnit.Framework;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Rooms;
 using osu.Game.Rulesets.Osu;
 using osu.Game.Scoring;
 using osu.Game.Screens.OnlinePlay.Multiplayer;
-using osu.Game.Users;
 
 namespace osu.Game.Tests.Visual.Multiplayer
 {
@@ -31,7 +31,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     MaxCombo = 500,
                     Combo = 250,
                     BeatmapInfo = beatmapInfo,
-                    User = new User { Username = "Test user" },
+                    User = new APIUser { Username = "Test user" },
                     Date = DateTimeOffset.Now,
                     OnlineScoreID = 12345,
                     Ruleset = rulesetInfo,
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerSpectateButton.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerSpectateButton.cs
index 3d08d5da9e..76c8de93c7 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerSpectateButton.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerSpectateButton.cs
@@ -14,12 +14,12 @@ using osu.Framework.Platform;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
 using osu.Game.Graphics.UserInterface;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Rooms;
 using osu.Game.Rulesets;
 using osu.Game.Screens.OnlinePlay.Multiplayer.Match;
 using osu.Game.Tests.Resources;
-using osu.Game.Users;
 using osuTK;
 using osuTK.Input;
 
@@ -145,7 +145,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [Test]
         public void TestReadyButtonEnabledWhenHostAndUsersReady()
         {
-            AddStep("add user", () => Client.AddUser(new User { Id = PLAYER_1_ID }));
+            AddStep("add user", () => Client.AddUser(new APIUser { Id = PLAYER_1_ID }));
             AddStep("set user ready", () => Client.ChangeUserState(PLAYER_1_ID, MultiplayerUserState.Ready));
 
             addClickSpectateButtonStep();
@@ -157,7 +157,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             AddStep("add user and transfer host", () =>
             {
-                Client.AddUser(new User { Id = PLAYER_1_ID });
+                Client.AddUser(new APIUser { Id = PLAYER_1_ID });
                 Client.TransferHost(PLAYER_1_ID);
             });
 
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerTeamResults.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerTeamResults.cs
index 99d5fd46e9..d391c39c89 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerTeamResults.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerTeamResults.cs
@@ -5,11 +5,11 @@ using System;
 using System.Collections.Generic;
 using NUnit.Framework;
 using osu.Framework.Bindables;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Rooms;
 using osu.Game.Rulesets.Osu;
 using osu.Game.Scoring;
 using osu.Game.Screens.OnlinePlay.Multiplayer;
-using osu.Game.Users;
 
 namespace osu.Game.Tests.Visual.Multiplayer
 {
@@ -35,7 +35,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     MaxCombo = 500,
                     Combo = 250,
                     BeatmapInfo = beatmapInfo,
-                    User = new User { Username = "Test user" },
+                    User = new APIUser { Username = "Test user" },
                     Date = DateTimeOffset.Now,
                     OnlineScoreID = 12345,
                     Ruleset = rulesetInfo,
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneRankRangePill.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneRankRangePill.cs
index 9e03743e8d..823ac07cf7 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneRankRangePill.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneRankRangePill.cs
@@ -3,8 +3,8 @@
 
 using NUnit.Framework;
 using osu.Framework.Graphics;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Screens.OnlinePlay.Lounge.Components;
-using osu.Game.Users;
 
 namespace osu.Game.Tests.Visual.Multiplayer
 {
@@ -25,7 +25,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             AddStep("add user", () =>
             {
-                Client.AddUser(new User
+                Client.AddUser(new APIUser
                 {
                     Id = 2,
                     Statistics = { GlobalRank = 1234 }
@@ -41,19 +41,19 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             AddStep("add users", () =>
             {
-                Client.AddUser(new User
+                Client.AddUser(new APIUser
                 {
                     Id = 2,
                     Statistics = { GlobalRank = 1234 }
                 });
 
-                Client.AddUser(new User
+                Client.AddUser(new APIUser
                 {
                     Id = 3,
                     Statistics = { GlobalRank = 3333 }
                 });
 
-                Client.AddUser(new User
+                Client.AddUser(new APIUser
                 {
                     Id = 4,
                     Statistics = { GlobalRank = 4321 }
@@ -75,13 +75,13 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             AddStep("add users", () =>
             {
-                Client.AddUser(new User
+                Client.AddUser(new APIUser
                 {
                     Id = 2,
                     Statistics = { GlobalRank = min }
                 });
 
-                Client.AddUser(new User
+                Client.AddUser(new APIUser
                 {
                     Id = 3,
                     Statistics = { GlobalRank = max }
diff --git a/osu.Game.Tests/Visual/Online/TestSceneAccountCreationOverlay.cs b/osu.Game.Tests/Visual/Online/TestSceneAccountCreationOverlay.cs
index 06cc613c17..8f0da8d182 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneAccountCreationOverlay.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneAccountCreationOverlay.cs
@@ -8,6 +8,7 @@ using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Testing;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays;
 using osu.Game.Overlays.AccountCreation;
 using osu.Game.Overlays.Settings;
@@ -20,7 +21,7 @@ namespace osu.Game.Tests.Visual.Online
         private readonly Container userPanelArea;
         private readonly AccountCreationOverlay accountCreation;
 
-        private IBindable<User> localUser;
+        private IBindable<APIUser> localUser;
 
         public TestSceneAccountCreationOverlay()
         {
diff --git a/osu.Game.Tests/Visual/Online/TestSceneBeatmapListingOverlay.cs b/osu.Game.Tests/Visual/Online/TestSceneBeatmapListingOverlay.cs
index c7a065fdd7..cbb6dce4d6 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneBeatmapListingOverlay.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneBeatmapListingOverlay.cs
@@ -14,8 +14,8 @@ using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays;
 using osu.Game.Overlays.BeatmapListing;
 using osu.Game.Scoring;
-using osu.Game.Users;
 using osuTK.Input;
+using APIUser = osu.Game.Online.API.Requests.Responses.APIUser;
 
 namespace osu.Game.Tests.Visual.Online
 {
@@ -53,7 +53,7 @@ namespace osu.Game.Tests.Visual.Online
                 };
 
                 // non-supporter user
-                api.LocalUser.Value = new User
+                api.LocalUser.Value = new APIUser
                 {
                     Username = "TestBot",
                     Id = API.LocalUser.Value.Id + 1,
diff --git a/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlay.cs b/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlay.cs
index 63ce057667..86863c0b5d 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlay.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlay.cs
@@ -7,11 +7,11 @@ using osu.Game.Beatmaps;
 using osu.Game.Overlays;
 using osu.Game.Overlays.BeatmapSet;
 using osu.Game.Rulesets;
-using osu.Game.Users;
 using System;
 using System.Collections.Generic;
 using System.Linq;
 using osu.Game.Online.API.Requests.Responses;
+using APIUser = osu.Game.Online.API.Requests.Responses.APIUser;
 
 namespace osu.Game.Tests.Visual.Online
 {
@@ -56,7 +56,7 @@ namespace osu.Game.Tests.Visual.Online
                     Artist = @"naru narusegawa",
                     Source = @"hinata sou",
                     Tags = @"test tag tag more tag",
-                    Author = new User
+                    Author = new APIUser
                     {
                         Username = @"BanchoBot",
                         Id = 3,
diff --git a/osu.Game.Tests/Visual/Online/TestSceneChannelTabControl.cs b/osu.Game.Tests/Visual/Online/TestSceneChannelTabControl.cs
index 73e1fc9b35..e6eaffc4c1 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneChannelTabControl.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneChannelTabControl.cs
@@ -11,9 +11,9 @@ using osu.Framework.Graphics.Shapes;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Utils;
 using osu.Game.Graphics.Sprites;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Chat;
 using osu.Game.Overlays.Chat.Tabs;
-using osu.Game.Users;
 using osuTK.Graphics;
 
 namespace osu.Game.Tests.Visual.Online
@@ -108,7 +108,7 @@ namespace osu.Game.Tests.Visual.Online
         }
 
         private void addRandomPrivateChannel() =>
-            channelTabControl.AddChannel(new Channel(new User
+            channelTabControl.AddChannel(new Channel(new APIUser
             {
                 Id = RNG.Next(1000, 10000000),
                 Username = "Test User " + RNG.Next(1000)
diff --git a/osu.Game.Tests/Visual/Online/TestSceneChatLineTruncation.cs b/osu.Game.Tests/Visual/Online/TestSceneChatLineTruncation.cs
index 8408b7dd60..444bd7e5fb 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneChatLineTruncation.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneChatLineTruncation.cs
@@ -6,9 +6,9 @@ using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Chat;
 using osu.Game.Overlays.Chat;
-using osu.Game.Users;
 
 namespace osu.Game.Tests.Visual.Online
 {
@@ -55,14 +55,14 @@ namespace osu.Game.Tests.Visual.Online
         {
             private static long messageCounter;
 
-            internal static readonly User TEST_SENDER_BACKGROUND = new User
+            internal static readonly APIUser TEST_SENDER_BACKGROUND = new APIUser
             {
                 Username = @"i-am-important",
                 Id = 42,
                 Colour = "#250cc9",
             };
 
-            internal static readonly User TEST_SENDER = new User
+            internal static readonly APIUser TEST_SENDER = new APIUser
             {
                 Username = @"Somebody",
                 Id = 1,
@@ -75,7 +75,7 @@ namespace osu.Game.Tests.Visual.Online
             {
                 Content = text;
                 IsAction = isAction;
-                Sender = new User
+                Sender = new APIUser
                 {
                     Username = username ?? $"user {number}",
                     Id = number,
diff --git a/osu.Game.Tests/Visual/Online/TestSceneChatLink.cs b/osu.Game.Tests/Visual/Online/TestSceneChatLink.cs
index 74f53ebdca..a03c00eb58 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneChatLink.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneChatLink.cs
@@ -10,10 +10,10 @@ using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Graphics;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Chat;
 using osu.Game.Overlays;
 using osu.Game.Overlays.Chat;
-using osu.Game.Users;
 using osuTK.Graphics;
 
 namespace osu.Game.Tests.Visual.Online
@@ -168,14 +168,14 @@ namespace osu.Game.Tests.Visual.Online
         {
             private static long messageCounter;
 
-            internal static readonly User TEST_SENDER_BACKGROUND = new User
+            internal static readonly APIUser TEST_SENDER_BACKGROUND = new APIUser
             {
                 Username = @"i-am-important",
                 Id = 42,
                 Colour = "#250cc9",
             };
 
-            internal static readonly User TEST_SENDER = new User
+            internal static readonly APIUser TEST_SENDER = new APIUser
             {
                 Username = @"Somebody",
                 Id = 1,
@@ -188,7 +188,7 @@ namespace osu.Game.Tests.Visual.Online
             {
                 Content = text;
                 IsAction = isAction;
-                Sender = new User
+                Sender = new APIUser
                 {
                     Username = $"User {number}",
                     Id = number,
diff --git a/osu.Game.Tests/Visual/Online/TestSceneChatOverlay.cs b/osu.Game.Tests/Visual/Online/TestSceneChatOverlay.cs
index 99c3b398ab..7028ecf39f 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneChatOverlay.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneChatOverlay.cs
@@ -18,12 +18,12 @@ using osu.Framework.Testing;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Chat;
 using osu.Game.Overlays;
 using osu.Game.Overlays.Chat;
 using osu.Game.Overlays.Chat.Selection;
 using osu.Game.Overlays.Chat.Tabs;
-using osu.Game.Users;
 using osuTK.Input;
 
 namespace osu.Game.Tests.Visual.Online
@@ -53,7 +53,7 @@ namespace osu.Game.Tests.Visual.Online
         public TestSceneChatOverlay()
         {
             channels = Enumerable.Range(1, 10)
-                                 .Select(index => new Channel(new User())
+                                 .Select(index => new Channel(new APIUser())
                                  {
                                      Name = $"Channel no. {index}",
                                      Topic = index == 3 ? null : $"We talk about the number {index} here",
@@ -98,7 +98,7 @@ namespace osu.Game.Tests.Visual.Online
                         case GetUserRequest getUser:
                             if (getUser.Lookup.Equals("some body", StringComparison.OrdinalIgnoreCase))
                             {
-                                getUser.TriggerSuccess(new User
+                                getUser.TriggerSuccess(new APIUser
                                 {
                                     Username = "some body",
                                     Id = 1,
@@ -149,7 +149,7 @@ namespace osu.Game.Tests.Visual.Online
                         {
                             ChannelId = channel1.Id,
                             Content = "hello from channel 1!",
-                            Sender = new User
+                            Sender = new APIUser
                             {
                                 Id = 2,
                                 Username = "test_user"
diff --git a/osu.Game.Tests/Visual/Online/TestSceneCurrentlyPlayingDisplay.cs b/osu.Game.Tests/Visual/Online/TestSceneCurrentlyPlayingDisplay.cs
index 2f11fec6d1..b5a03b558d 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneCurrentlyPlayingDisplay.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneCurrentlyPlayingDisplay.cs
@@ -9,6 +9,7 @@ using NUnit.Framework;
 using osu.Framework.Graphics;
 using osu.Framework.Testing;
 using osu.Game.Database;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Spectator;
 using osu.Game.Overlays.Dashboard;
 using osu.Game.Tests.Visual.Spectator;
@@ -18,7 +19,7 @@ namespace osu.Game.Tests.Visual.Online
 {
     public class TestSceneCurrentlyPlayingDisplay : OsuTestScene
     {
-        private readonly User streamingUser = new User { Id = 2, Username = "Test user" };
+        private readonly APIUser streamingUser = new APIUser { Id = 2, Username = "Test user" };
 
         private TestSpectatorClient spectatorClient;
         private CurrentlyPlayingDisplay currentlyPlaying;
@@ -83,13 +84,13 @@ namespace osu.Game.Tests.Visual.Online
                 "pishifat"
             };
 
-            protected override Task<User> ComputeValueAsync(int lookup, CancellationToken token = default)
+            protected override Task<APIUser> ComputeValueAsync(int lookup, CancellationToken token = default)
             {
                 // tests against failed lookups
                 if (lookup == 13)
-                    return Task.FromResult<User>(null);
+                    return Task.FromResult<APIUser>(null);
 
-                return Task.FromResult(new User
+                return Task.FromResult(new APIUser
                 {
                     Id = lookup,
                     Username = usernames[lookup % usernames.Length],
diff --git a/osu.Game.Tests/Visual/Online/TestSceneDirectPanel.cs b/osu.Game.Tests/Visual/Online/TestSceneDirectPanel.cs
index a3c8935fa8..01dde97d38 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneDirectPanel.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneDirectPanel.cs
@@ -10,8 +10,8 @@ using osu.Game.Beatmaps;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays.BeatmapListing.Panels;
 using osu.Game.Rulesets;
-using osu.Game.Users;
 using osuTK;
+using APIUser = osu.Game.Online.API.Requests.Responses.APIUser;
 
 namespace osu.Game.Tests.Visual.Online
 {
@@ -74,7 +74,7 @@ namespace osu.Game.Tests.Visual.Online
                 Title = "undownloadable beatmap",
                 Artist = "test",
                 Source = "more tests",
-                Author = new User
+                Author = new APIUser
                 {
                     Username = "BanchoBot",
                     Id = 3,
@@ -121,7 +121,7 @@ namespace osu.Game.Tests.Visual.Online
                     Title = "undownloadable beatmap",
                     Artist = "test",
                     Source = "more tests",
-                    Author = new User
+                    Author = new APIUser
                     {
                         Username = "BanchoBot",
                         Id = 3,
diff --git a/osu.Game.Tests/Visual/Online/TestSceneFriendDisplay.cs b/osu.Game.Tests/Visual/Online/TestSceneFriendDisplay.cs
index e8d9ff72af..471d361c4e 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneFriendDisplay.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneFriendDisplay.cs
@@ -7,6 +7,7 @@ using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays;
 using osu.Game.Overlays.Dashboard.Friends;
 using osu.Game.Users;
@@ -44,9 +45,9 @@ namespace osu.Game.Tests.Visual.Online
             // No need to do anything, fetch is performed automatically.
         }
 
-        private List<User> getUsers() => new List<User>
+        private List<APIUser> getUsers() => new List<APIUser>
         {
-            new User
+            new APIUser
             {
                 Username = "flyte",
                 Id = 3103765,
@@ -55,7 +56,7 @@ namespace osu.Game.Tests.Visual.Online
                 Country = new Country { FlagName = "JP" },
                 CoverUrl = "https://osu.ppy.sh/images/headers/profile-covers/c6.jpg"
             },
-            new User
+            new APIUser
             {
                 Username = "peppy",
                 Id = 2,
@@ -66,7 +67,7 @@ namespace osu.Game.Tests.Visual.Online
                 IsSupporter = true,
                 SupportLevel = 3,
             },
-            new User
+            new APIUser
             {
                 Username = "Evast",
                 Id = 8195163,
diff --git a/osu.Game.Tests/Visual/Online/TestSceneHistoricalSection.cs b/osu.Game.Tests/Visual/Online/TestSceneHistoricalSection.cs
index 3ecca85ef1..2639a6506c 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneHistoricalSection.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneHistoricalSection.cs
@@ -7,9 +7,9 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Shapes;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays;
 using osu.Game.Overlays.Profile.Sections;
-using osu.Game.Users;
 
 namespace osu.Game.Tests.Visual.Online
 {
@@ -37,8 +37,8 @@ namespace osu.Game.Tests.Visual.Online
                 Child = section = new HistoricalSection(),
             });
 
-            AddStep("Show peppy", () => section.User.Value = new User { Id = 2 });
-            AddStep("Show WubWoofWolf", () => section.User.Value = new User { Id = 39828 });
+            AddStep("Show peppy", () => section.User.Value = new APIUser { Id = 2 });
+            AddStep("Show WubWoofWolf", () => section.User.Value = new APIUser { Id = 39828 });
         }
     }
 }
diff --git a/osu.Game.Tests/Visual/Online/TestSceneMessageNotifier.cs b/osu.Game.Tests/Visual/Online/TestSceneMessageNotifier.cs
index d193856217..175d2ea36b 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneMessageNotifier.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneMessageNotifier.cs
@@ -15,14 +15,14 @@ using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Chat;
 using osu.Game.Overlays;
 using osu.Game.Overlays.Notifications;
-using osu.Game.Users;
 using osuTK.Input;
+using APIUser = osu.Game.Online.API.Requests.Responses.APIUser;
 
 namespace osu.Game.Tests.Visual.Online
 {
     public class TestSceneMessageNotifier : OsuManualInputManagerTestScene
     {
-        private User friend;
+        private APIUser friend;
         private Channel publicChannel;
         private Channel privateMessageChannel;
         private TestContainer testContainer;
@@ -37,7 +37,7 @@ namespace osu.Game.Tests.Visual.Online
                 daa.HandleRequest = dummyAPIHandleRequest;
             }
 
-            friend = new User { Id = 0, Username = "Friend" };
+            friend = new APIUser { Id = 0, Username = "Friend" };
             publicChannel = new Channel { Id = 1, Name = "osu" };
             privateMessageChannel = new Channel(friend) { Id = 2, Name = friend.Username, Type = ChannelType.PM };
 
@@ -178,9 +178,9 @@ namespace osu.Game.Tests.Visual.Online
             AddAssert("1 notification fired", () => testContainer.NotificationOverlay.UnreadCount.Value == 1);
         }
 
-        private void receiveMessage(User sender, Channel channel, string content) => channel.AddNewMessages(createMessage(sender, channel, content));
+        private void receiveMessage(APIUser sender, Channel channel, string content) => channel.AddNewMessages(createMessage(sender, channel, content));
 
-        private Message createMessage(User sender, Channel channel, string content) => new Message(messageIdCounter++)
+        private Message createMessage(APIUser sender, Channel channel, string content) => new Message(messageIdCounter++)
         {
             Content = content,
             Sender = sender,
diff --git a/osu.Game.Tests/Visual/Online/TestSceneOfflineCommentsContainer.cs b/osu.Game.Tests/Visual/Online/TestSceneOfflineCommentsContainer.cs
index 4f7947b69c..0587e8884f 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneOfflineCommentsContainer.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneOfflineCommentsContainer.cs
@@ -11,9 +11,9 @@ using osu.Game.Overlays.Comments;
 using osu.Game.Overlays;
 using osu.Framework.Allocation;
 using osu.Game.Online.API.Requests.Responses;
-using osu.Game.Users;
 using JetBrains.Annotations;
 using osu.Framework.Testing;
+using APIUser = osu.Game.Online.API.Requests.Responses.APIUser;
 
 namespace osu.Game.Tests.Visual.Online
 {
@@ -154,9 +154,9 @@ namespace osu.Game.Tests.Visual.Online
             {
                 5
             },
-            Users = new List<User>
+            Users = new List<APIUser>
             {
-                new User
+                new APIUser
                 {
                     Id = 1,
                     Username = "Good_Admin"
diff --git a/osu.Game.Tests/Visual/Online/TestScenePlayHistorySubsection.cs b/osu.Game.Tests/Visual/Online/TestScenePlayHistorySubsection.cs
index cf5ecf5bf2..fecc1af03c 100644
--- a/osu.Game.Tests/Visual/Online/TestScenePlayHistorySubsection.cs
+++ b/osu.Game.Tests/Visual/Online/TestScenePlayHistorySubsection.cs
@@ -4,7 +4,6 @@
 using osu.Game.Overlays.Profile.Sections.Historical;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
-using osu.Game.Users;
 using NUnit.Framework;
 using osu.Game.Overlays;
 using osu.Framework.Allocation;
@@ -12,7 +11,7 @@ using System;
 using System.Linq;
 using osu.Framework.Testing;
 using osu.Framework.Graphics.Shapes;
-using static osu.Game.Users.User;
+using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Tests.Visual.Online
 {
@@ -21,7 +20,7 @@ namespace osu.Game.Tests.Visual.Online
         [Cached]
         private readonly OverlayColourProvider colourProvider = new OverlayColourProvider(OverlayColourScheme.Red);
 
-        private readonly Bindable<User> user = new Bindable<User>();
+        private readonly Bindable<APIUser> user = new Bindable<APIUser>();
         private readonly PlayHistorySubsection section;
 
         public TestScenePlayHistorySubsection()
@@ -101,80 +100,80 @@ namespace osu.Game.Tests.Visual.Online
 
         private int getChartValuesLength() => this.ChildrenOfType<ProfileLineChart>().Single().Values.Length;
 
-        private static readonly User user_with_null_values = new User
+        private static readonly APIUser user_with_null_values = new APIUser
         {
             Id = 1
         };
 
-        private static readonly User user_with_empty_values = new User
+        private static readonly APIUser user_with_empty_values = new APIUser
         {
             Id = 2,
-            MonthlyPlaycounts = Array.Empty<UserHistoryCount>()
+            MonthlyPlaycounts = Array.Empty<APIUserHistoryCount>()
         };
 
-        private static readonly User user_with_one_value = new User
+        private static readonly APIUser user_with_one_value = new APIUser
         {
             Id = 3,
             MonthlyPlaycounts = new[]
             {
-                new UserHistoryCount { Date = new DateTime(2010, 5, 1), Count = 100 }
+                new APIUserHistoryCount { Date = new DateTime(2010, 5, 1), Count = 100 }
             }
         };
 
-        private static readonly User user_with_two_values = new User
+        private static readonly APIUser user_with_two_values = new APIUser
         {
             Id = 4,
             MonthlyPlaycounts = new[]
             {
-                new UserHistoryCount { Date = new DateTime(2010, 5, 1), Count = 1 },
-                new UserHistoryCount { Date = new DateTime(2010, 6, 1), Count = 2 }
+                new APIUserHistoryCount { Date = new DateTime(2010, 5, 1), Count = 1 },
+                new APIUserHistoryCount { Date = new DateTime(2010, 6, 1), Count = 2 }
             }
         };
 
-        private static readonly User user_with_constant_values = new User
+        private static readonly APIUser user_with_constant_values = new APIUser
         {
             Id = 5,
             MonthlyPlaycounts = new[]
             {
-                new UserHistoryCount { Date = new DateTime(2010, 5, 1), Count = 5 },
-                new UserHistoryCount { Date = new DateTime(2010, 6, 1), Count = 5 },
-                new UserHistoryCount { Date = new DateTime(2010, 7, 1), Count = 5 }
+                new APIUserHistoryCount { Date = new DateTime(2010, 5, 1), Count = 5 },
+                new APIUserHistoryCount { Date = new DateTime(2010, 6, 1), Count = 5 },
+                new APIUserHistoryCount { Date = new DateTime(2010, 7, 1), Count = 5 }
             }
         };
 
-        private static readonly User user_with_zero_values = new User
+        private static readonly APIUser user_with_zero_values = new APIUser
         {
             Id = 6,
             MonthlyPlaycounts = new[]
             {
-                new UserHistoryCount { Date = new DateTime(2010, 5, 1), Count = 0 },
-                new UserHistoryCount { Date = new DateTime(2010, 6, 1), Count = 0 },
-                new UserHistoryCount { Date = new DateTime(2010, 7, 1), Count = 0 }
+                new APIUserHistoryCount { Date = new DateTime(2010, 5, 1), Count = 0 },
+                new APIUserHistoryCount { Date = new DateTime(2010, 6, 1), Count = 0 },
+                new APIUserHistoryCount { Date = new DateTime(2010, 7, 1), Count = 0 }
             }
         };
 
-        private static readonly User user_with_filled_values = new User
+        private static readonly APIUser user_with_filled_values = new APIUser
         {
             Id = 7,
             MonthlyPlaycounts = new[]
             {
-                new UserHistoryCount { Date = new DateTime(2010, 5, 1), Count = 1000 },
-                new UserHistoryCount { Date = new DateTime(2010, 6, 1), Count = 20 },
-                new UserHistoryCount { Date = new DateTime(2010, 7, 1), Count = 20000 },
-                new UserHistoryCount { Date = new DateTime(2010, 8, 1), Count = 30 },
-                new UserHistoryCount { Date = new DateTime(2010, 9, 1), Count = 50 },
-                new UserHistoryCount { Date = new DateTime(2010, 10, 1), Count = 2000 },
-                new UserHistoryCount { Date = new DateTime(2010, 11, 1), Count = 2100 }
+                new APIUserHistoryCount { Date = new DateTime(2010, 5, 1), Count = 1000 },
+                new APIUserHistoryCount { Date = new DateTime(2010, 6, 1), Count = 20 },
+                new APIUserHistoryCount { Date = new DateTime(2010, 7, 1), Count = 20000 },
+                new APIUserHistoryCount { Date = new DateTime(2010, 8, 1), Count = 30 },
+                new APIUserHistoryCount { Date = new DateTime(2010, 9, 1), Count = 50 },
+                new APIUserHistoryCount { Date = new DateTime(2010, 10, 1), Count = 2000 },
+                new APIUserHistoryCount { Date = new DateTime(2010, 11, 1), Count = 2100 }
             }
         };
 
-        private static readonly User user_with_missing_values = new User
+        private static readonly APIUser user_with_missing_values = new APIUser
         {
             Id = 8,
             MonthlyPlaycounts = new[]
             {
-                new UserHistoryCount { Date = new DateTime(2020, 1, 1), Count = 100 },
-                new UserHistoryCount { Date = new DateTime(2020, 7, 1), Count = 200 }
+                new APIUserHistoryCount { Date = new DateTime(2020, 1, 1), Count = 100 },
+                new APIUserHistoryCount { Date = new DateTime(2020, 7, 1), Count = 200 }
             }
         };
     }
diff --git a/osu.Game.Tests/Visual/Online/TestSceneProfileRulesetSelector.cs b/osu.Game.Tests/Visual/Online/TestSceneProfileRulesetSelector.cs
index 6a847e4269..cbbe8b8eac 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneProfileRulesetSelector.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneProfileRulesetSelector.cs
@@ -7,10 +7,10 @@ using osu.Game.Rulesets.Catch;
 using osu.Game.Rulesets.Mania;
 using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Taiko;
-using osu.Game.Users;
 using osu.Framework.Bindables;
 using osu.Game.Overlays;
 using osu.Framework.Allocation;
+using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Tests.Visual.Online
 {
@@ -22,7 +22,7 @@ namespace osu.Game.Tests.Visual.Online
         public TestSceneProfileRulesetSelector()
         {
             ProfileRulesetSelector selector;
-            var user = new Bindable<User>();
+            var user = new Bindable<APIUser>();
 
             Child = selector = new ProfileRulesetSelector
             {
@@ -36,10 +36,10 @@ namespace osu.Game.Tests.Visual.Online
             AddStep("set taiko as default", () => selector.SetDefaultRuleset(new TaikoRuleset().RulesetInfo));
             AddStep("set catch as default", () => selector.SetDefaultRuleset(new CatchRuleset().RulesetInfo));
 
-            AddStep("User with osu as default", () => user.Value = new User { PlayMode = "osu" });
-            AddStep("User with mania as default", () => user.Value = new User { PlayMode = "mania" });
-            AddStep("User with taiko as default", () => user.Value = new User { PlayMode = "taiko" });
-            AddStep("User with catch as default", () => user.Value = new User { PlayMode = "fruits" });
+            AddStep("User with osu as default", () => user.Value = new APIUser { PlayMode = "osu" });
+            AddStep("User with mania as default", () => user.Value = new APIUser { PlayMode = "mania" });
+            AddStep("User with taiko as default", () => user.Value = new APIUser { PlayMode = "taiko" });
+            AddStep("User with catch as default", () => user.Value = new APIUser { PlayMode = "fruits" });
             AddStep("null user", () => user.Value = null);
         }
     }
diff --git a/osu.Game.Tests/Visual/Online/TestSceneRankGraph.cs b/osu.Game.Tests/Visual/Online/TestSceneRankGraph.cs
index f577140e17..1f7da7ac0d 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneRankGraph.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneRankGraph.cs
@@ -7,6 +7,7 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
 using osu.Game.Graphics;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays;
 using osu.Game.Overlays.Profile.Header.Components;
 using osu.Game.Users;
@@ -81,7 +82,7 @@ namespace osu.Game.Tests.Visual.Online
                 {
                     GlobalRank = 89000,
                     PP = 12345,
-                    RankHistory = new User.RankHistoryData
+                    RankHistory = new APIUser.RankHistoryData
                     {
                         Data = data,
                     }
@@ -94,7 +95,7 @@ namespace osu.Game.Tests.Visual.Online
                 {
                     GlobalRank = 89000,
                     PP = 12345,
-                    RankHistory = new User.RankHistoryData
+                    RankHistory = new APIUser.RankHistoryData
                     {
                         Data = dataWithZeros,
                     }
@@ -107,7 +108,7 @@ namespace osu.Game.Tests.Visual.Online
                 {
                     GlobalRank = 12000,
                     PP = 12345,
-                    RankHistory = new User.RankHistoryData
+                    RankHistory = new APIUser.RankHistoryData
                     {
                         Data = smallData,
                     }
@@ -120,7 +121,7 @@ namespace osu.Game.Tests.Visual.Online
                 {
                     GlobalRank = 12000,
                     PP = 12345,
-                    RankHistory = new User.RankHistoryData
+                    RankHistory = new APIUser.RankHistoryData
                     {
                         Data = edgyData,
                     }
diff --git a/osu.Game.Tests/Visual/Online/TestSceneScoresContainer.cs b/osu.Game.Tests/Visual/Online/TestSceneScoresContainer.cs
index 23899154c4..50969aad9b 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneScoresContainer.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneScoresContainer.cs
@@ -15,6 +15,7 @@ using osu.Game.Rulesets.Osu.Mods;
 using osu.Game.Scoring;
 using osu.Game.Users;
 using osuTK.Graphics;
+using APIUser = osu.Game.Online.API.Requests.Responses.APIUser;
 
 namespace osu.Game.Tests.Visual.Online
 {
@@ -50,7 +51,7 @@ namespace osu.Game.Tests.Visual.Online
                 {
                     new APIScoreInfo
                     {
-                        User = new User
+                        User = new APIUser
                         {
                             Id = 6602580,
                             Username = @"waaiiru",
@@ -75,7 +76,7 @@ namespace osu.Game.Tests.Visual.Online
                     },
                     new APIScoreInfo
                     {
-                        User = new User
+                        User = new APIUser
                         {
                             Id = 4608074,
                             Username = @"Skycries",
@@ -99,7 +100,7 @@ namespace osu.Game.Tests.Visual.Online
                     },
                     new APIScoreInfo
                     {
-                        User = new User
+                        User = new APIUser
                         {
                             Id = 1014222,
                             Username = @"eLy",
@@ -122,7 +123,7 @@ namespace osu.Game.Tests.Visual.Online
                     },
                     new APIScoreInfo
                     {
-                        User = new User
+                        User = new APIUser
                         {
                             Id = 1541390,
                             Username = @"Toukai",
@@ -144,7 +145,7 @@ namespace osu.Game.Tests.Visual.Online
                     },
                     new APIScoreInfo
                     {
-                        User = new User
+                        User = new APIUser
                         {
                             Id = 7151382,
                             Username = @"Mayuri Hana",
@@ -167,7 +168,7 @@ namespace osu.Game.Tests.Visual.Online
             {
                 Score = new APIScoreInfo
                 {
-                    User = new User
+                    User = new APIUser
                     {
                         Id = 7151382,
                         Username = @"Mayuri Hana",
@@ -190,7 +191,7 @@ namespace osu.Game.Tests.Visual.Online
             {
                 Score = new APIScoreInfo
                 {
-                    User = new User
+                    User = new APIUser
                     {
                         Id = 7151382,
                         Username = @"Mayuri Hana",
@@ -215,7 +216,7 @@ namespace osu.Game.Tests.Visual.Online
                 {
                     new APIScoreInfo
                     {
-                        User = new User
+                        User = new APIUser
                         {
                             Id = 6602580,
                             Username = @"waaiiru",
diff --git a/osu.Game.Tests/Visual/Online/TestSceneStandAloneChatDisplay.cs b/osu.Game.Tests/Visual/Online/TestSceneStandAloneChatDisplay.cs
index b3b8d75c46..b7bce012ce 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneStandAloneChatDisplay.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneStandAloneChatDisplay.cs
@@ -4,13 +4,13 @@
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Game.Online.Chat;
-using osu.Game.Users;
 using osuTK;
 using System;
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Graphics.Containers;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays.Chat;
 using osuTK.Input;
 
@@ -18,26 +18,26 @@ namespace osu.Game.Tests.Visual.Online
 {
     public class TestSceneStandAloneChatDisplay : OsuManualInputManagerTestScene
     {
-        private readonly User admin = new User
+        private readonly APIUser admin = new APIUser
         {
             Username = "HappyStick",
             Id = 2,
             Colour = "f2ca34"
         };
 
-        private readonly User redUser = new User
+        private readonly APIUser redUser = new APIUser
         {
             Username = "BanchoBot",
             Id = 3,
         };
 
-        private readonly User blueUser = new User
+        private readonly APIUser blueUser = new APIUser
         {
             Username = "Zallius",
             Id = 4,
         };
 
-        private readonly User longUsernameUser = new User
+        private readonly APIUser longUsernameUser = new APIUser
         {
             Username = "Very Long Long Username",
             Id = 5,
diff --git a/osu.Game.Tests/Visual/Online/TestSceneUserHistoryGraph.cs b/osu.Game.Tests/Visual/Online/TestSceneUserHistoryGraph.cs
index 484c59695e..3f4a5cd420 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneUserHistoryGraph.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneUserHistoryGraph.cs
@@ -2,11 +2,11 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
-using osu.Game.Overlays.Profile.Sections.Historical;
-using osu.Framework.Graphics;
-using osu.Game.Overlays;
 using osu.Framework.Allocation;
-using static osu.Game.Users.User;
+using osu.Framework.Graphics;
+using osu.Game.Online.API.Requests.Responses;
+using osu.Game.Overlays;
+using osu.Game.Overlays.Profile.Sections.Historical;
 
 namespace osu.Game.Tests.Visual.Online
 {
@@ -29,28 +29,28 @@ namespace osu.Game.Tests.Visual.Online
 
             var values = new[]
             {
-                new UserHistoryCount { Date = new DateTime(2000, 1, 1), Count = 10 },
-                new UserHistoryCount { Date = new DateTime(2000, 2, 1), Count = 20 },
-                new UserHistoryCount { Date = new DateTime(2000, 3, 1), Count = 100 },
-                new UserHistoryCount { Date = new DateTime(2000, 4, 1), Count = 15 },
-                new UserHistoryCount { Date = new DateTime(2000, 5, 1), Count = 30 }
+                new APIUserHistoryCount { Date = new DateTime(2000, 1, 1), Count = 10 },
+                new APIUserHistoryCount { Date = new DateTime(2000, 2, 1), Count = 20 },
+                new APIUserHistoryCount { Date = new DateTime(2000, 3, 1), Count = 100 },
+                new APIUserHistoryCount { Date = new DateTime(2000, 4, 1), Count = 15 },
+                new APIUserHistoryCount { Date = new DateTime(2000, 5, 1), Count = 30 }
             };
 
             var moreValues = new[]
             {
-                new UserHistoryCount { Date = new DateTime(2010, 5, 1), Count = 1000 },
-                new UserHistoryCount { Date = new DateTime(2010, 6, 1), Count = 20 },
-                new UserHistoryCount { Date = new DateTime(2010, 7, 1), Count = 20000 },
-                new UserHistoryCount { Date = new DateTime(2010, 8, 1), Count = 30 },
-                new UserHistoryCount { Date = new DateTime(2010, 9, 1), Count = 50 },
-                new UserHistoryCount { Date = new DateTime(2010, 10, 1), Count = 2000 },
-                new UserHistoryCount { Date = new DateTime(2010, 11, 1), Count = 2100 }
+                new APIUserHistoryCount { Date = new DateTime(2010, 5, 1), Count = 1000 },
+                new APIUserHistoryCount { Date = new DateTime(2010, 6, 1), Count = 20 },
+                new APIUserHistoryCount { Date = new DateTime(2010, 7, 1), Count = 20000 },
+                new APIUserHistoryCount { Date = new DateTime(2010, 8, 1), Count = 30 },
+                new APIUserHistoryCount { Date = new DateTime(2010, 9, 1), Count = 50 },
+                new APIUserHistoryCount { Date = new DateTime(2010, 10, 1), Count = 2000 },
+                new APIUserHistoryCount { Date = new DateTime(2010, 11, 1), Count = 2100 }
             };
 
             AddStep("Set fake values", () => graph.Values = values);
             AddStep("Set more values", () => graph.Values = moreValues);
             AddStep("Set null values", () => graph.Values = null);
-            AddStep("Set empty values", () => graph.Values = Array.Empty<UserHistoryCount>());
+            AddStep("Set empty values", () => graph.Values = Array.Empty<APIUserHistoryCount>());
         }
     }
 }
diff --git a/osu.Game.Tests/Visual/Online/TestSceneUserPanel.cs b/osu.Game.Tests/Visual/Online/TestSceneUserPanel.cs
index a048ae2c54..19e06beaad 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneUserPanel.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneUserPanel.cs
@@ -7,6 +7,7 @@ using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets;
 using osu.Game.Users;
 using osuTK;
@@ -42,27 +43,27 @@ namespace osu.Game.Tests.Visual.Online
                 Spacing = new Vector2(10f),
                 Children = new Drawable[]
                 {
-                    new UserBrickPanel(new User
+                    new UserBrickPanel(new APIUser
                     {
                         Username = @"flyte",
                         Id = 3103765,
                         CoverUrl = @"https://osu.ppy.sh/images/headers/profile-covers/c6.jpg"
                     }),
-                    new UserBrickPanel(new User
+                    new UserBrickPanel(new APIUser
                     {
                         Username = @"peppy",
                         Id = 2,
                         Colour = "99EB47",
                         CoverUrl = @"https://osu.ppy.sh/images/headers/profile-covers/c3.jpg",
                     }),
-                    flyte = new UserGridPanel(new User
+                    flyte = new UserGridPanel(new APIUser
                     {
                         Username = @"flyte",
                         Id = 3103765,
                         Country = new Country { FlagName = @"JP" },
                         CoverUrl = @"https://osu.ppy.sh/images/headers/profile-covers/c6.jpg"
                     }) { Width = 300 },
-                    peppy = new UserGridPanel(new User
+                    peppy = new UserGridPanel(new APIUser
                     {
                         Username = @"peppy",
                         Id = 2,
@@ -71,7 +72,7 @@ namespace osu.Game.Tests.Visual.Online
                         IsSupporter = true,
                         SupportLevel = 3,
                     }) { Width = 300 },
-                    evast = new TestUserListPanel(new User
+                    evast = new TestUserListPanel(new APIUser
                     {
                         Username = @"Evast",
                         Id = 8195163,
@@ -134,7 +135,7 @@ namespace osu.Game.Tests.Visual.Online
 
         private class TestUserListPanel : UserListPanel
         {
-            public TestUserListPanel(User user)
+            public TestUserListPanel(APIUser user)
                 : base(user)
             {
             }
diff --git a/osu.Game.Tests/Visual/Online/TestSceneUserProfileHeader.cs b/osu.Game.Tests/Visual/Online/TestSceneUserProfileHeader.cs
index 04b741b2bb..76997bded7 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneUserProfileHeader.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneUserProfileHeader.cs
@@ -5,6 +5,7 @@ using System;
 using osu.Framework.Allocation;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays;
 using osu.Game.Overlays.Profile;
 using osu.Game.Users;
@@ -30,26 +31,26 @@ namespace osu.Game.Tests.Visual.Online
 
             AddStep("Show test dummy", () => header.User.Value = TestSceneUserProfileOverlay.TEST_USER);
 
-            AddStep("Show null dummy", () => header.User.Value = new User
+            AddStep("Show null dummy", () => header.User.Value = new APIUser
             {
                 Username = "Null"
             });
 
-            AddStep("Show online dummy", () => header.User.Value = new User
+            AddStep("Show online dummy", () => header.User.Value = new APIUser
             {
                 Username = "IAmOnline",
                 LastVisit = DateTimeOffset.Now,
                 IsOnline = true,
             });
 
-            AddStep("Show offline dummy", () => header.User.Value = new User
+            AddStep("Show offline dummy", () => header.User.Value = new APIUser
             {
                 Username = "IAmOffline",
                 LastVisit = DateTimeOffset.Now,
                 IsOnline = false,
             });
 
-            addOnlineStep("Show ppy", new User
+            addOnlineStep("Show ppy", new APIUser
             {
                 Username = @"peppy",
                 Id = 2,
@@ -58,7 +59,7 @@ namespace osu.Game.Tests.Visual.Online
                 CoverUrl = @"https://osu.ppy.sh/images/headers/profile-covers/c3.jpg"
             });
 
-            addOnlineStep("Show flyte", new User
+            addOnlineStep("Show flyte", new APIUser
             {
                 Username = @"flyte",
                 Id = 3103765,
@@ -67,7 +68,7 @@ namespace osu.Game.Tests.Visual.Online
             });
         }
 
-        private void addOnlineStep(string name, User fallback)
+        private void addOnlineStep(string name, APIUser fallback)
         {
             AddStep(name, () =>
             {
diff --git a/osu.Game.Tests/Visual/Online/TestSceneUserProfileOverlay.cs b/osu.Game.Tests/Visual/Online/TestSceneUserProfileOverlay.cs
index 70271b0b08..2a6f304369 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneUserProfileOverlay.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneUserProfileOverlay.cs
@@ -6,6 +6,7 @@ using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Game.Online.API;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays;
 using osu.Game.Overlays.Profile;
 using osu.Game.Users;
@@ -22,7 +23,7 @@ namespace osu.Game.Tests.Visual.Online
         [Resolved]
         private IAPIProvider api { get; set; }
 
-        public static readonly User TEST_USER = new User
+        public static readonly APIUser TEST_USER = new APIUser
         {
             Username = @"Somebody",
             Id = 1,
@@ -41,7 +42,7 @@ namespace osu.Game.Tests.Visual.Online
                     Current = 727,
                     Progress = 69,
                 },
-                RankHistory = new User.RankHistoryData
+                RankHistory = new APIUser.RankHistoryData
                 {
                     Mode = @"osu",
                     Data = Enumerable.Range(2345, 45).Concat(Enumerable.Range(2109, 40)).ToArray()
@@ -58,7 +59,7 @@ namespace osu.Game.Tests.Visual.Online
             },
             Title = "osu!volunteer",
             Colour = "ff0000",
-            Achievements = Array.Empty<User.UserAchievement>(),
+            Achievements = Array.Empty<APIUser.UserAchievement>(),
         };
 
         public TestSceneUserProfileOverlay()
@@ -72,13 +73,13 @@ namespace osu.Game.Tests.Visual.Online
 
             AddStep("Show offline dummy", () => profile.ShowUser(TEST_USER, false));
 
-            AddStep("Show null dummy", () => profile.ShowUser(new User
+            AddStep("Show null dummy", () => profile.ShowUser(new APIUser
             {
                 Username = @"Null",
                 Id = 1,
             }, false));
 
-            AddStep("Show ppy", () => profile.ShowUser(new User
+            AddStep("Show ppy", () => profile.ShowUser(new APIUser
             {
                 Username = @"peppy",
                 Id = 2,
@@ -87,7 +88,7 @@ namespace osu.Game.Tests.Visual.Online
                 CoverUrl = @"https://osu.ppy.sh/images/headers/profile-covers/c3.jpg"
             }, api.IsLoggedIn));
 
-            AddStep("Show flyte", () => profile.ShowUser(new User
+            AddStep("Show flyte", () => profile.ShowUser(new APIUser
             {
                 Username = @"flyte",
                 Id = 3103765,
@@ -95,7 +96,7 @@ namespace osu.Game.Tests.Visual.Online
                 CoverUrl = @"https://osu.ppy.sh/images/headers/profile-covers/c6.jpg"
             }, api.IsLoggedIn));
 
-            AddStep("Show bancho", () => profile.ShowUser(new User
+            AddStep("Show bancho", () => profile.ShowUser(new APIUser
             {
                 Username = @"BanchoBot",
                 Id = 3,
diff --git a/osu.Game.Tests/Visual/Online/TestSceneUserProfilePreviousUsernames.cs b/osu.Game.Tests/Visual/Online/TestSceneUserProfilePreviousUsernames.cs
index b5d2d15392..30774689a2 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneUserProfilePreviousUsernames.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneUserProfilePreviousUsernames.cs
@@ -4,8 +4,8 @@
 using System;
 using NUnit.Framework;
 using osu.Framework.Graphics;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays.Profile.Header.Components;
-using osu.Game.Users;
 
 namespace osu.Game.Tests.Visual.Online
 {
@@ -48,13 +48,13 @@ namespace osu.Game.Tests.Visual.Online
             AddUntilStep("Is hidden", () => container.Alpha == 0);
         }
 
-        private static readonly User[] users =
+        private static readonly APIUser[] users =
         {
-            new User { Id = 1, PreviousUsernames = new[] { "username1" } },
-            new User { Id = 2, PreviousUsernames = new[] { "longusername", "longerusername" } },
-            new User { Id = 3, PreviousUsernames = new[] { "test", "angelsim", "verylongusername" } },
-            new User { Id = 4, PreviousUsernames = new[] { "ihavenoidea", "howcani", "makethistext", "anylonger" } },
-            new User { Id = 5, PreviousUsernames = Array.Empty<string>() },
+            new APIUser { Id = 1, PreviousUsernames = new[] { "username1" } },
+            new APIUser { Id = 2, PreviousUsernames = new[] { "longusername", "longerusername" } },
+            new APIUser { Id = 3, PreviousUsernames = new[] { "test", "angelsim", "verylongusername" } },
+            new APIUser { Id = 4, PreviousUsernames = new[] { "ihavenoidea", "howcani", "makethistext", "anylonger" } },
+            new APIUser { Id = 5, PreviousUsernames = Array.Empty<string>() },
             null
         };
     }
diff --git a/osu.Game.Tests/Visual/Online/TestSceneUserRanks.cs b/osu.Game.Tests/Visual/Online/TestSceneUserRanks.cs
index c22cff4af6..b9272e7294 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneUserRanks.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneUserRanks.cs
@@ -8,9 +8,9 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays;
 using osu.Game.Overlays.Profile.Sections;
-using osu.Game.Users;
 
 namespace osu.Game.Tests.Visual.Online
 {
@@ -44,7 +44,7 @@ namespace osu.Game.Tests.Visual.Online
                 }
             });
 
-            AddStep("Show cookiezi", () => ranks.User.Value = new User { Id = 124493 });
+            AddStep("Show cookiezi", () => ranks.User.Value = new APIUser { Id = 124493 });
         }
     }
 }
diff --git a/osu.Game.Tests/Visual/Online/TestSceneUserRequest.cs b/osu.Game.Tests/Visual/Online/TestSceneUserRequest.cs
index 15cfd3ee54..e7b6a94642 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneUserRequest.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneUserRequest.cs
@@ -9,10 +9,10 @@ using osu.Game.Online.API;
 using osu.Game.Online.API.Requests;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Mania;
-using osu.Game.Users;
 using osu.Framework.Graphics;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.UserInterface;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets.Taiko;
 
 namespace osu.Game.Tests.Visual.Online
@@ -23,7 +23,7 @@ namespace osu.Game.Tests.Visual.Online
         [Resolved]
         private IAPIProvider api { get; set; }
 
-        private readonly Bindable<User> user = new Bindable<User>();
+        private readonly Bindable<APIUser> user = new Bindable<APIUser>();
         private GetUserRequest request;
         private readonly LoadingLayer loading;
 
@@ -71,7 +71,7 @@ namespace osu.Game.Tests.Visual.Online
 
         private class UserTestContainer : FillFlowContainer
         {
-            public readonly Bindable<User> User = new Bindable<User>();
+            public readonly Bindable<APIUser> User = new Bindable<APIUser>();
 
             public UserTestContainer()
             {
@@ -85,7 +85,7 @@ namespace osu.Game.Tests.Visual.Online
                 User.BindValueChanged(onUserUpdate, true);
             }
 
-            private void onUserUpdate(ValueChangedEvent<User> user)
+            private void onUserUpdate(ValueChangedEvent<APIUser> user)
             {
                 Clear();
 
diff --git a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsParticipantsList.cs b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsParticipantsList.cs
index 76a78c0a3c..1288b9e765 100644
--- a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsParticipantsList.cs
+++ b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsParticipantsList.cs
@@ -3,6 +3,7 @@
 
 using NUnit.Framework;
 using osu.Framework.Graphics;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Rooms;
 using osu.Game.Screens.OnlinePlay.Components;
 using osu.Game.Tests.Visual.OnlinePlay;
@@ -19,7 +20,7 @@ namespace osu.Game.Tests.Visual.Playlists
 
             for (int i = 0; i < 50; i++)
             {
-                SelectedRoom.Value.RecentParticipants.Add(new User
+                SelectedRoom.Value.RecentParticipants.Add(new APIUser
                 {
                     Username = "peppy",
                     Statistics = new UserStatistics { GlobalRank = 1234 },
diff --git a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsResultsScreen.cs b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsResultsScreen.cs
index d948aebbbf..4284bc6358 100644
--- a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsResultsScreen.cs
+++ b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsResultsScreen.cs
@@ -14,6 +14,7 @@ using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Rooms;
 using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Scoring;
@@ -21,7 +22,6 @@ using osu.Game.Scoring;
 using osu.Game.Screens.OnlinePlay.Playlists;
 using osu.Game.Screens.Ranking;
 using osu.Game.Tests.Beatmaps;
-using osu.Game.Users;
 
 namespace osu.Game.Tests.Visual.Playlists
 {
@@ -260,7 +260,7 @@ namespace osu.Game.Tests.Visual.Playlists
                     Rank = userScore.Rank,
                     MaxCombo = userScore.MaxCombo,
                     TotalScore = userScore.TotalScore - i,
-                    User = new User
+                    User = new APIUser
                     {
                         Id = 2,
                         Username = $"peppy{i}",
@@ -278,7 +278,7 @@ namespace osu.Game.Tests.Visual.Playlists
                     Rank = userScore.Rank,
                     MaxCombo = userScore.MaxCombo,
                     TotalScore = userScore.TotalScore + i,
-                    User = new User
+                    User = new APIUser
                     {
                         Id = 2,
                         Username = $"peppy{i}",
@@ -314,7 +314,7 @@ namespace osu.Game.Tests.Visual.Playlists
                     Rank = ScoreRank.X,
                     MaxCombo = 1000,
                     TotalScore = startTotalScore + (sort == "score_asc" ? i : -i),
-                    User = new User
+                    User = new APIUser
                     {
                         Id = 2,
                         Username = $"peppy{i}",
diff --git a/osu.Game.Tests/Visual/Ranking/TestSceneAccuracyCircle.cs b/osu.Game.Tests/Visual/Ranking/TestSceneAccuracyCircle.cs
index df8500fab2..944941723e 100644
--- a/osu.Game.Tests/Visual/Ranking/TestSceneAccuracyCircle.cs
+++ b/osu.Game.Tests/Visual/Ranking/TestSceneAccuracyCircle.cs
@@ -8,6 +8,7 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Colour;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Osu.Mods;
@@ -15,7 +16,6 @@ using osu.Game.Rulesets.Scoring;
 using osu.Game.Scoring;
 using osu.Game.Screens.Ranking.Expanded.Accuracy;
 using osu.Game.Tests.Beatmaps;
-using osu.Game.Users;
 using osuTK;
 
 namespace osu.Game.Tests.Visual.Ranking
@@ -66,7 +66,7 @@ namespace osu.Game.Tests.Visual.Ranking
 
         private ScoreInfo createScore(double accuracy, ScoreRank rank) => new ScoreInfo
         {
-            User = new User
+            User = new APIUser
             {
                 Id = 2,
                 Username = "peppy",
diff --git a/osu.Game.Tests/Visual/Ranking/TestSceneExpandedPanelMiddleContent.cs b/osu.Game.Tests/Visual/Ranking/TestSceneExpandedPanelMiddleContent.cs
index 899f351a2a..fee8985120 100644
--- a/osu.Game.Tests/Visual/Ranking/TestSceneExpandedPanelMiddleContent.cs
+++ b/osu.Game.Tests/Visual/Ranking/TestSceneExpandedPanelMiddleContent.cs
@@ -11,6 +11,7 @@ using osu.Framework.Graphics.Shapes;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
 using osu.Game.Graphics.Sprites;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Osu;
@@ -18,7 +19,6 @@ using osu.Game.Scoring;
 using osu.Game.Screens.Ranking;
 using osu.Game.Screens.Ranking.Expanded;
 using osu.Game.Tests.Beatmaps;
-using osu.Game.Users;
 using osuTK;
 
 namespace osu.Game.Tests.Visual.Ranking
@@ -31,7 +31,7 @@ namespace osu.Game.Tests.Visual.Ranking
         [Test]
         public void TestMapWithKnownMapper()
         {
-            var author = new User { Username = "mapper_name" };
+            var author = new APIUser { Username = "mapper_name" };
 
             AddStep("show example score", () => showPanel(new TestScoreInfo(new OsuRuleset().RulesetInfo)
             {
@@ -42,7 +42,7 @@ namespace osu.Game.Tests.Visual.Ranking
         [Test]
         public void TestExcessMods()
         {
-            var author = new User { Username = "mapper_name" };
+            var author = new APIUser { Username = "mapper_name" };
 
             AddStep("show excess mods score", () => showPanel(new TestScoreInfo(new OsuRuleset().RulesetInfo, true)
             {
@@ -90,7 +90,7 @@ namespace osu.Game.Tests.Visual.Ranking
         private void showPanel(ScoreInfo score) =>
             Child = new ExpandedPanelMiddleContentContainer(score);
 
-        private BeatmapInfo createTestBeatmap(User author)
+        private BeatmapInfo createTestBeatmap(APIUser author)
         {
             var beatmap = new TestBeatmap(rulesetStore.GetRuleset(0)).BeatmapInfo;
 
diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
index 13b769c80a..855a59b5f5 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
@@ -10,6 +10,7 @@ using osu.Framework.Graphics;
 using osu.Framework.Platform;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Leaderboards;
 using osu.Game.Overlays;
 using osu.Game.Rulesets;
@@ -133,7 +134,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                 MaxCombo = 244,
                 TotalScore = 1707827,
                 Mods = new Mod[] { new OsuModHidden(), new OsuModHardRock() },
-                User = new User
+                User = new APIUser
                 {
                     Id = 6602580,
                     Username = @"waaiiru",
@@ -156,7 +157,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                 MaxCombo = 244,
                 TotalScore = 1707827,
                 Mods = new Mod[] { new OsuModHidden(), new OsuModHardRock(), },
-                User = new User
+                User = new APIUser
                 {
                     Id = 6602580,
                     Username = @"waaiiru",
@@ -198,7 +199,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                     TotalScore = 1707827,
                     //Mods = new Mod[] { new OsuModHidden(), new OsuModHardRock(), },
                     BeatmapInfo = beatmapInfo,
-                    User = new User
+                    User = new APIUser
                     {
                         Id = 6602580,
                         Username = @"waaiiru",
@@ -217,7 +218,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                     TotalScore = 1707827,
                     //Mods = new Mod[] { new OsuModHidden(), new OsuModHardRock(), },
                     BeatmapInfo = beatmapInfo,
-                    User = new User
+                    User = new APIUser
                     {
                         Id = 4608074,
                         Username = @"Skycries",
@@ -236,7 +237,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                     TotalScore = 1707827,
                     //Mods = new Mod[] { new OsuModHidden(), new OsuModHardRock(), },
                     BeatmapInfo = beatmapInfo,
-                    User = new User
+                    User = new APIUser
                     {
                         Id = 1014222,
                         Username = @"eLy",
@@ -255,7 +256,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                     TotalScore = 1707827,
                     //Mods = new Mod[] { new OsuModHidden(), new OsuModHardRock(), },
                     BeatmapInfo = beatmapInfo,
-                    User = new User
+                    User = new APIUser
                     {
                         Id = 1541390,
                         Username = @"Toukai",
@@ -274,7 +275,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                     TotalScore = 1707827,
                     //Mods = new Mod[] { new OsuModHidden(), new OsuModHardRock(), },
                     BeatmapInfo = beatmapInfo,
-                    User = new User
+                    User = new APIUser
                     {
                         Id = 2243452,
                         Username = @"Satoruu",
@@ -293,7 +294,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                     TotalScore = 1707827,
                     //Mods = new Mod[] { new OsuModHidden(), new OsuModHardRock(), },
                     BeatmapInfo = beatmapInfo,
-                    User = new User
+                    User = new APIUser
                     {
                         Id = 2705430,
                         Username = @"Mooha",
@@ -312,7 +313,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                     TotalScore = 1707827,
                     //Mods = new Mod[] { new OsuModHidden(), new OsuModHardRock(), },
                     BeatmapInfo = beatmapInfo,
-                    User = new User
+                    User = new APIUser
                     {
                         Id = 7151382,
                         Username = @"Mayuri Hana",
@@ -331,7 +332,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                     TotalScore = 1707827,
                     //Mods = new Mod[] { new OsuModHidden(), new OsuModHardRock(), },
                     BeatmapInfo = beatmapInfo,
-                    User = new User
+                    User = new APIUser
                     {
                         Id = 2051389,
                         Username = @"FunOrange",
@@ -350,7 +351,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                     TotalScore = 1707827,
                     //Mods = new Mod[] { new OsuModHidden(), new OsuModHardRock(), },
                     BeatmapInfo = beatmapInfo,
-                    User = new User
+                    User = new APIUser
                     {
                         Id = 6169483,
                         Username = @"-Hebel-",
@@ -369,7 +370,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                     TotalScore = 1707827,
                     //Mods = new Mod[] { new OsuModHidden(), new OsuModHardRock(), },
                     BeatmapInfo = beatmapInfo,
-                    User = new User
+                    User = new APIUser
                     {
                         Id = 6702666,
                         Username = @"prhtnsm",
diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapRecommendations.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapRecommendations.cs
index c22b6a54e9..68d5836cac 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapRecommendations.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapRecommendations.cs
@@ -9,6 +9,7 @@ using osu.Framework.Testing;
 using osu.Game.Beatmaps;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Catch;
 using osu.Game.Rulesets.Mania;
@@ -40,9 +41,9 @@ namespace osu.Game.Tests.Visual.SongSelect
 
             base.SetUpSteps();
 
-            User getUser(int? rulesetID)
+            APIUser getUser(int? rulesetID)
             {
-                return new User
+                return new APIUser
                 {
                     Username = @"Dummy",
                     Id = 1001,
diff --git a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
index 4811fc979e..4861354921 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
@@ -18,6 +18,7 @@ using osu.Framework.Testing;
 using osu.Game.Beatmaps;
 using osu.Game.Configuration;
 using osu.Game.Graphics.UserInterface;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Mods;
@@ -29,7 +30,6 @@ using osu.Game.Screens.Play;
 using osu.Game.Screens.Select;
 using osu.Game.Screens.Select.Carousel;
 using osu.Game.Screens.Select.Filter;
-using osu.Game.Users;
 using osuTK.Input;
 
 namespace osu.Game.Tests.Visual.SongSelect
@@ -807,7 +807,7 @@ namespace osu.Game.Tests.Visual.SongSelect
 
                 songSelect.PresentScore(new ScoreInfo
                 {
-                    User = new User { Username = "woo" },
+                    User = new APIUser { Username = "woo" },
                     BeatmapInfo = getPresentBeatmap(),
                     Ruleset = getPresentBeatmap().Ruleset
                 });
@@ -839,7 +839,7 @@ namespace osu.Game.Tests.Visual.SongSelect
 
                 songSelect.PresentScore(new ScoreInfo
                 {
-                    User = new User { Username = "woo" },
+                    User = new APIUser { Username = "woo" },
                     BeatmapInfo = getPresentBeatmap(),
                     Ruleset = getPresentBeatmap().Ruleset
                 });
diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneUserTopScoreContainer.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneUserTopScoreContainer.cs
index b8b8792b9b..7af9e9eb40 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneUserTopScoreContainer.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneUserTopScoreContainer.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.Game.Online.API.Requests.Responses;
 using osuTK.Graphics;
 using osu.Game.Online.Leaderboards;
 using osu.Game.Overlays;
@@ -60,7 +61,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                     MaxCombo = 244,
                     TotalScore = 1707827,
                     Mods = new Mod[] { new OsuModHidden(), new OsuModHardRock(), },
-                    User = new User
+                    User = new APIUser
                     {
                         Id = 6602580,
                         Username = @"waaiiru",
@@ -78,7 +79,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                     Accuracy = 1,
                     MaxCombo = 244,
                     TotalScore = 1707827,
-                    User = new User
+                    User = new APIUser
                     {
                         Id = 4608074,
                         Username = @"Skycries",
@@ -96,7 +97,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                     Accuracy = 1,
                     MaxCombo = 244,
                     TotalScore = 1707827,
-                    User = new User
+                    User = new APIUser
                     {
                         Id = 1541390,
                         Username = @"Toukai",
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneDashboardBeatmapListing.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneDashboardBeatmapListing.cs
index 06c64a566e..17ac812eb0 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneDashboardBeatmapListing.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneDashboardBeatmapListing.cs
@@ -7,11 +7,11 @@ using osu.Game.Overlays.Dashboard.Home;
 using osu.Game.Beatmaps;
 using osu.Game.Overlays;
 using osu.Framework.Allocation;
-using osu.Game.Users;
 using System;
 using osu.Framework.Graphics.Shapes;
 using System.Collections.Generic;
 using osu.Game.Online.API.Requests.Responses;
+using APIUser = osu.Game.Online.API.Requests.Responses.APIUser;
 
 namespace osu.Game.Tests.Visual.UserInterface
 {
@@ -62,7 +62,7 @@ namespace osu.Game.Tests.Visual.UserInterface
             {
                 Title = "Very Long Title (TV size) [TATOE]",
                 Artist = "This artist has a really long name how is this possible",
-                Author = new User
+                Author = new APIUser
                 {
                     Username = "author",
                     Id = 100
@@ -77,7 +77,7 @@ namespace osu.Game.Tests.Visual.UserInterface
             {
                 Title = "Very Long Title (TV size) [TATOE]",
                 Artist = "This artist has a really long name how is this possible",
-                Author = new User
+                Author = new APIUser
                 {
                     Username = "author",
                     Id = 100
@@ -96,7 +96,7 @@ namespace osu.Game.Tests.Visual.UserInterface
             {
                 Title = "Very Long Title (TV size) [TATOE]",
                 Artist = "This artist has a really long name how is this possible",
-                Author = new User
+                Author = new APIUser
                 {
                     Username = "author",
                     Id = 100
@@ -111,7 +111,7 @@ namespace osu.Game.Tests.Visual.UserInterface
             {
                 Title = "Very Long Title (TV size) [TATOE]",
                 Artist = "This artist has a really long name how is this possible",
-                Author = new User
+                Author = new APIUser
                 {
                     Username = "author",
                     Id = 100
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
index 9a75d3c309..07759d598e 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
@@ -15,13 +15,13 @@ using osu.Game.Beatmaps;
 using osu.Game.Database;
 using osu.Game.Graphics.Cursor;
 using osu.Game.Graphics.UserInterface;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Leaderboards;
 using osu.Game.Overlays;
 using osu.Game.Rulesets;
 using osu.Game.Scoring;
 using osu.Game.Screens.Select.Leaderboards;
 using osu.Game.Tests.Resources;
-using osu.Game.Users;
 using osuTK;
 using osuTK.Input;
 
@@ -64,7 +64,7 @@ namespace osu.Game.Tests.Visual.UserInterface
                                 ID = 1,
                                 Title = "TestSong",
                                 Artist = "TestArtist",
-                                Author = new User
+                                Author = new APIUser
                                 {
                                     Username = "TestAuthor"
                                 },
@@ -98,7 +98,7 @@ namespace osu.Game.Tests.Visual.UserInterface
                     TotalScore = RNG.Next(1, 1000000),
                     MaxCombo = RNG.Next(1, 1000),
                     Rank = ScoreRank.XH,
-                    User = new User { Username = "TestUser" },
+                    User = new APIUser { Username = "TestUser" },
                 };
 
                 importedScores.Add(scoreManager.Import(score).Result.Value);
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneFriendsOnlineStatusControl.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneFriendsOnlineStatusControl.cs
index 9fa5c83dba..ea3cfbd497 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneFriendsOnlineStatusControl.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneFriendsOnlineStatusControl.cs
@@ -6,9 +6,9 @@ using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays;
 using osu.Game.Overlays.Dashboard.Friends;
-using osu.Game.Users;
 
 namespace osu.Game.Tests.Visual.UserInterface
 {
@@ -29,17 +29,17 @@ namespace osu.Game.Tests.Visual.UserInterface
         [Test]
         public void Populate()
         {
-            AddStep("Populate", () => control.Populate(new List<User>
+            AddStep("Populate", () => control.Populate(new List<APIUser>
             {
-                new User
+                new APIUser
                 {
                     IsOnline = true
                 },
-                new User
+                new APIUser
                 {
                     IsOnline = false
                 },
-                new User
+                new APIUser
                 {
                     IsOnline = false
                 }
diff --git a/osu.Game.Tournament.Tests/Components/TestSceneDrawableTournamentTeam.cs b/osu.Game.Tournament.Tests/Components/TestSceneDrawableTournamentTeam.cs
index 376c59ec2d..bb47683be1 100644
--- a/osu.Game.Tournament.Tests/Components/TestSceneDrawableTournamentTeam.cs
+++ b/osu.Game.Tournament.Tests/Components/TestSceneDrawableTournamentTeam.cs
@@ -3,13 +3,13 @@
 
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Tests.Visual;
 using osu.Game.Tournament.Components;
 using osu.Game.Tournament.Models;
 using osu.Game.Tournament.Screens.Drawings.Components;
 using osu.Game.Tournament.Screens.Gameplay.Components;
 using osu.Game.Tournament.Screens.Ladder.Components;
-using osu.Game.Users;
 
 namespace osu.Game.Tournament.Tests.Components
 {
@@ -24,13 +24,13 @@ namespace osu.Game.Tournament.Tests.Components
                 FullName = { Value = "Australia" },
                 Players =
                 {
-                    new User { Username = "ASecretBox" },
-                    new User { Username = "Dereban" },
-                    new User { Username = "mReKk" },
-                    new User { Username = "uyghti" },
-                    new User { Username = "Parkes" },
-                    new User { Username = "Shiroha" },
-                    new User { Username = "Jordan The Bear" },
+                    new APIUser { Username = "ASecretBox" },
+                    new APIUser { Username = "Dereban" },
+                    new APIUser { Username = "mReKk" },
+                    new APIUser { Username = "uyghti" },
+                    new APIUser { Username = "Parkes" },
+                    new APIUser { Username = "Shiroha" },
+                    new APIUser { Username = "Jordan The Bear" },
                 }
             };
 
diff --git a/osu.Game.Tournament.Tests/Components/TestSceneTournamentMatchChatDisplay.cs b/osu.Game.Tournament.Tests/Components/TestSceneTournamentMatchChatDisplay.cs
index 9905e17824..05989566c3 100644
--- a/osu.Game.Tournament.Tests/Components/TestSceneTournamentMatchChatDisplay.cs
+++ b/osu.Game.Tournament.Tests/Components/TestSceneTournamentMatchChatDisplay.cs
@@ -4,12 +4,12 @@
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Chat;
 using osu.Game.Tests.Visual;
 using osu.Game.Tournament.Components;
 using osu.Game.Tournament.IPC;
 using osu.Game.Tournament.Models;
-using osu.Game.Users;
 
 namespace osu.Game.Tournament.Tests.Components
 {
@@ -18,20 +18,20 @@ namespace osu.Game.Tournament.Tests.Components
         private readonly Channel testChannel = new Channel();
         private readonly Channel testChannel2 = new Channel();
 
-        private readonly User admin = new User
+        private readonly APIUser admin = new APIUser
         {
             Username = "HappyStick",
             Id = 2,
             Colour = "f2ca34"
         };
 
-        private readonly User redUser = new User
+        private readonly APIUser redUser = new APIUser
         {
             Username = "BanchoBot",
             Id = 3,
         };
 
-        private readonly User blueUser = new User
+        private readonly APIUser blueUser = new APIUser
         {
             Username = "Zallius",
             Id = 4,
@@ -57,11 +57,11 @@ namespace osu.Game.Tournament.Tests.Components
             {
                 Team1 =
                 {
-                    Value = new TournamentTeam { Players = new BindableList<User> { redUser } }
+                    Value = new TournamentTeam { Players = new BindableList<APIUser> { redUser } }
                 },
                 Team2 =
                 {
-                    Value = new TournamentTeam { Players = new BindableList<User> { blueUser } }
+                    Value = new TournamentTeam { Players = new BindableList<APIUser> { blueUser } }
                 }
             };
 
diff --git a/osu.Game.Tournament.Tests/TournamentTestScene.cs b/osu.Game.Tournament.Tests/TournamentTestScene.cs
index 81741a43a9..8c05b4e915 100644
--- a/osu.Game.Tournament.Tests/TournamentTestScene.cs
+++ b/osu.Game.Tournament.Tests/TournamentTestScene.cs
@@ -14,6 +14,7 @@ using osu.Game.Tournament.IO;
 using osu.Game.Tournament.IPC;
 using osu.Game.Tournament.Models;
 using osu.Game.Users;
+using APIUser = osu.Game.Online.API.Requests.Responses.APIUser;
 
 namespace osu.Game.Tournament.Tests
 {
@@ -120,11 +121,11 @@ namespace osu.Game.Tournament.Tests
                     },
                     Players =
                     {
-                        new User { Username = "Hello", Statistics = new UserStatistics { GlobalRank = 12 } },
-                        new User { Username = "Hello", Statistics = new UserStatistics { GlobalRank = 16 } },
-                        new User { Username = "Hello", Statistics = new UserStatistics { GlobalRank = 20 } },
-                        new User { Username = "Hello", Statistics = new UserStatistics { GlobalRank = 24 } },
-                        new User { Username = "Hello", Statistics = new UserStatistics { GlobalRank = 30 } },
+                        new APIUser { Username = "Hello", Statistics = new UserStatistics { GlobalRank = 12 } },
+                        new APIUser { Username = "Hello", Statistics = new UserStatistics { GlobalRank = 16 } },
+                        new APIUser { Username = "Hello", Statistics = new UserStatistics { GlobalRank = 20 } },
+                        new APIUser { Username = "Hello", Statistics = new UserStatistics { GlobalRank = 24 } },
+                        new APIUser { Username = "Hello", Statistics = new UserStatistics { GlobalRank = 30 } },
                     }
                 }
             },
@@ -137,11 +138,11 @@ namespace osu.Game.Tournament.Tests
                     FullName = { Value = "United States" },
                     Players =
                     {
-                        new User { Username = "Hello" },
-                        new User { Username = "Hello" },
-                        new User { Username = "Hello" },
-                        new User { Username = "Hello" },
-                        new User { Username = "Hello" },
+                        new APIUser { Username = "Hello" },
+                        new APIUser { Username = "Hello" },
+                        new APIUser { Username = "Hello" },
+                        new APIUser { Username = "Hello" },
+                        new APIUser { Username = "Hello" },
                     }
                 }
             },
diff --git a/osu.Game.Tournament/Components/DrawableTeamWithPlayers.cs b/osu.Game.Tournament/Components/DrawableTeamWithPlayers.cs
index e949bf9881..4d9afc23ac 100644
--- a/osu.Game.Tournament/Components/DrawableTeamWithPlayers.cs
+++ b/osu.Game.Tournament/Components/DrawableTeamWithPlayers.cs
@@ -5,8 +5,8 @@ using System.Linq;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Graphics;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Tournament.Models;
-using osu.Game.Users;
 using osuTK;
 using osuTK.Graphics;
 
@@ -54,7 +54,7 @@ namespace osu.Game.Tournament.Components
                 },
             };
 
-            TournamentSpriteText createPlayerText(User p) =>
+            TournamentSpriteText createPlayerText(APIUser p) =>
                 new TournamentSpriteText
                 {
                     Text = p.Username,
diff --git a/osu.Game.Tournament/Models/TournamentTeam.cs b/osu.Game.Tournament/Models/TournamentTeam.cs
index d895e4b538..24dee3b372 100644
--- a/osu.Game.Tournament/Models/TournamentTeam.cs
+++ b/osu.Game.Tournament/Models/TournamentTeam.cs
@@ -5,7 +5,7 @@ using System;
 using System.Linq;
 using Newtonsoft.Json;
 using osu.Framework.Bindables;
-using osu.Game.Users;
+using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Tournament.Models
 {
@@ -57,7 +57,7 @@ namespace osu.Game.Tournament.Models
         };
 
         [JsonProperty]
-        public BindableList<User> Players { get; set; } = new BindableList<User>();
+        public BindableList<APIUser> Players { get; set; } = new BindableList<APIUser>();
 
         public TournamentTeam()
         {
diff --git a/osu.Game.Tournament/Screens/Editors/TeamEditorScreen.cs b/osu.Game.Tournament/Screens/Editors/TeamEditorScreen.cs
index 0d2e64f300..6adddb5204 100644
--- a/osu.Game.Tournament/Screens/Editors/TeamEditorScreen.cs
+++ b/osu.Game.Tournament/Screens/Editors/TeamEditorScreen.cs
@@ -13,6 +13,7 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
 using osu.Game.Graphics;
 using osu.Game.Online.API;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays.Settings;
 using osu.Game.Tournament.Components;
 using osu.Game.Tournament.Models;
@@ -199,14 +200,14 @@ namespace osu.Game.Tournament.Screens.Editors
 
                 public void CreateNew()
                 {
-                    var user = new User();
+                    var user = new APIUser();
                     team.Players.Add(user);
                     flow.Add(new PlayerRow(team, user));
                 }
 
                 public class PlayerRow : CompositeDrawable
                 {
-                    private readonly User user;
+                    private readonly APIUser user;
 
                     [Resolved]
                     protected IAPIProvider API { get; private set; }
@@ -218,7 +219,7 @@ namespace osu.Game.Tournament.Screens.Editors
 
                     private readonly Container drawableContainer;
 
-                    public PlayerRow(TournamentTeam team, User user)
+                    public PlayerRow(TournamentTeam team, APIUser user)
                     {
                         this.user = user;
 
diff --git a/osu.Game.Tournament/TournamentGameBase.cs b/osu.Game.Tournament/TournamentGameBase.cs
index ee281466a2..d2f146c4c2 100644
--- a/osu.Game.Tournament/TournamentGameBase.cs
+++ b/osu.Game.Tournament/TournamentGameBase.cs
@@ -18,8 +18,8 @@ using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Tournament.IO;
 using osu.Game.Tournament.IPC;
 using osu.Game.Tournament.Models;
-using osu.Game.Users;
 using osuTK.Input;
+using APIUser = osu.Game.Online.API.Requests.Responses.APIUser;
 
 namespace osu.Game.Tournament
 {
@@ -241,7 +241,7 @@ namespace osu.Game.Tournament
 
         private void updateLoadProgressMessage(string s) => Schedule(() => initialisationText.Text = s);
 
-        public void PopulateUser(User user, Action success = null, Action failure = null, bool immediate = false)
+        public void PopulateUser(APIUser user, Action success = null, Action failure = null, bool immediate = false)
         {
             var req = new GetUserRequest(user.Id, Ruleset.Value);
 
diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index e0e5b5e63d..ca931e8b8d 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -18,10 +18,10 @@ using osu.Game.Database;
 using osu.Game.IO;
 using osu.Game.IO.Archives;
 using osu.Game.Online.API;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays.Notifications;
 using osu.Game.Rulesets;
 using osu.Game.Skinning;
-using osu.Game.Users;
 
 namespace osu.Game.Beatmaps
 {
@@ -68,7 +68,7 @@ namespace osu.Game.Beatmaps
         /// <summary>
         /// Create a new <see cref="WorkingBeatmap"/>.
         /// </summary>
-        public WorkingBeatmap CreateNew(RulesetInfo ruleset, User user)
+        public WorkingBeatmap CreateNew(RulesetInfo ruleset, APIUser user)
         {
             var metadata = new BeatmapMetadata
             {
diff --git a/osu.Game/Beatmaps/BeatmapMetadata.cs b/osu.Game/Beatmaps/BeatmapMetadata.cs
index 5d3b4007ae..60e3bcc98d 100644
--- a/osu.Game/Beatmaps/BeatmapMetadata.cs
+++ b/osu.Game/Beatmaps/BeatmapMetadata.cs
@@ -7,7 +7,7 @@ using System.ComponentModel.DataAnnotations.Schema;
 using Newtonsoft.Json;
 using osu.Framework.Testing;
 using osu.Game.Database;
-using osu.Game.Users;
+using osu.Game.Online.API.Requests.Responses;
 
 #nullable enable
 
@@ -36,7 +36,7 @@ namespace osu.Game.Beatmaps
         public List<BeatmapSetInfo> BeatmapSets { get; set; } = new List<BeatmapSetInfo>();
 
         /// <summary>
-        /// Helper property to deserialize a username to <see cref="User"/>.
+        /// Helper property to deserialize a username to <see cref="APIUser"/>.
         /// </summary>
         [JsonProperty(@"user_id")]
         [Column("AuthorID")]
@@ -45,13 +45,13 @@ namespace osu.Game.Beatmaps
             get => Author?.Id ?? 1;
             set
             {
-                Author ??= new User();
+                Author ??= new APIUser();
                 Author.Id = value;
             }
         }
 
         /// <summary>
-        /// Helper property to deserialize a username to <see cref="User"/>.
+        /// Helper property to deserialize a username to <see cref="APIUser"/>.
         /// </summary>
         [JsonProperty(@"creator")]
         [Column("Author")]
@@ -60,7 +60,7 @@ namespace osu.Game.Beatmaps
             get => Author?.Username ?? string.Empty;
             set
             {
-                Author ??= new User();
+                Author ??= new APIUser();
                 Author.Username = value;
             }
         }
@@ -69,7 +69,7 @@ namespace osu.Game.Beatmaps
         /// The author of the beatmaps in this set.
         /// </summary>
         [JsonIgnore]
-        public User? Author;
+        public APIUser? Author;
 
         public string Source { get; set; } = string.Empty;
 
diff --git a/osu.Game/Database/UserLookupCache.cs b/osu.Game/Database/UserLookupCache.cs
index 3626f5e83a..dae2d2549c 100644
--- a/osu.Game/Database/UserLookupCache.cs
+++ b/osu.Game/Database/UserLookupCache.cs
@@ -9,33 +9,33 @@ using JetBrains.Annotations;
 using osu.Framework.Allocation;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests;
-using osu.Game.Users;
+using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Database
 {
-    public class UserLookupCache : MemoryCachingComponent<int, User>
+    public class UserLookupCache : MemoryCachingComponent<int, APIUser>
     {
         [Resolved]
         private IAPIProvider api { get; set; }
 
         /// <summary>
-        /// Perform an API lookup on the specified user, populating a <see cref="User"/> model.
+        /// Perform an API lookup on the specified user, populating a <see cref="APIUser"/> model.
         /// </summary>
         /// <param name="userId">The user to lookup.</param>
         /// <param name="token">An optional cancellation token.</param>
         /// <returns>The populated user, or null if the user does not exist or the request could not be satisfied.</returns>
         [ItemCanBeNull]
-        public Task<User> GetUserAsync(int userId, CancellationToken token = default) => GetAsync(userId, token);
+        public Task<APIUser> GetUserAsync(int userId, CancellationToken token = default) => GetAsync(userId, token);
 
         /// <summary>
-        /// Perform an API lookup on the specified users, populating a <see cref="User"/> model.
+        /// Perform an API lookup on the specified users, populating a <see cref="APIUser"/> model.
         /// </summary>
         /// <param name="userIds">The users to lookup.</param>
         /// <param name="token">An optional cancellation token.</param>
         /// <returns>The populated users. May include null results for failed retrievals.</returns>
-        public Task<User[]> GetUsersAsync(int[] userIds, CancellationToken token = default)
+        public Task<APIUser[]> GetUsersAsync(int[] userIds, CancellationToken token = default)
         {
-            var userLookupTasks = new List<Task<User>>();
+            var userLookupTasks = new List<Task<APIUser>>();
 
             foreach (int u in userIds)
             {
@@ -51,18 +51,18 @@ namespace osu.Game.Database
             return Task.WhenAll(userLookupTasks);
         }
 
-        protected override async Task<User> ComputeValueAsync(int lookup, CancellationToken token = default)
+        protected override async Task<APIUser> ComputeValueAsync(int lookup, CancellationToken token = default)
             => await queryUser(lookup).ConfigureAwait(false);
 
-        private readonly Queue<(int id, TaskCompletionSource<User>)> pendingUserTasks = new Queue<(int, TaskCompletionSource<User>)>();
+        private readonly Queue<(int id, TaskCompletionSource<APIUser>)> pendingUserTasks = new Queue<(int, TaskCompletionSource<APIUser>)>();
         private Task pendingRequestTask;
         private readonly object taskAssignmentLock = new object();
 
-        private Task<User> queryUser(int userId)
+        private Task<APIUser> queryUser(int userId)
         {
             lock (taskAssignmentLock)
             {
-                var tcs = new TaskCompletionSource<User>();
+                var tcs = new TaskCompletionSource<APIUser>();
 
                 // Add to the queue.
                 pendingUserTasks.Enqueue((userId, tcs));
@@ -78,14 +78,14 @@ namespace osu.Game.Database
         private void performLookup()
         {
             // contains at most 50 unique user IDs from userTasks, which is used to perform the lookup.
-            var userTasks = new Dictionary<int, List<TaskCompletionSource<User>>>();
+            var userTasks = new Dictionary<int, List<TaskCompletionSource<APIUser>>>();
 
             // Grab at most 50 unique user IDs from the queue.
             lock (taskAssignmentLock)
             {
                 while (pendingUserTasks.Count > 0 && userTasks.Count < 50)
                 {
-                    (int id, TaskCompletionSource<User> task) next = pendingUserTasks.Dequeue();
+                    (int id, TaskCompletionSource<APIUser> task) next = pendingUserTasks.Dequeue();
 
                     // Perform a secondary check for existence, in case the user was queried in a previous batch.
                     if (CheckExists(next.id, out var existing))
@@ -95,7 +95,7 @@ namespace osu.Game.Database
                         if (userTasks.TryGetValue(next.id, out var tasks))
                             tasks.Add(next.task);
                         else
-                            userTasks[next.id] = new List<TaskCompletionSource<User>> { next.task };
+                            userTasks[next.id] = new List<TaskCompletionSource<APIUser>> { next.task };
                     }
                 }
             }
@@ -115,7 +115,7 @@ namespace osu.Game.Database
                     createNewTask();
             }
 
-            List<User> foundUsers = request.Response?.Users;
+            List<APIUser> foundUsers = request.Response?.Users;
 
             if (foundUsers != null)
             {
diff --git a/osu.Game/Graphics/Containers/LinkFlowContainer.cs b/osu.Game/Graphics/Containers/LinkFlowContainer.cs
index 7d1210d0e3..48f6c36993 100644
--- a/osu.Game/Graphics/Containers/LinkFlowContainer.cs
+++ b/osu.Game/Graphics/Containers/LinkFlowContainer.cs
@@ -11,7 +11,7 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Localisation;
 using osu.Framework.Platform;
-using osu.Game.Users;
+using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Graphics.Containers
 {
@@ -70,7 +70,7 @@ namespace osu.Game.Graphics.Containers
             createLink(new TextPartManual(text), new LinkDetails(action, linkArgument), tooltipText);
         }
 
-        public void AddUserLink(User user, Action<SpriteText> creationParameters = null)
+        public void AddUserLink(APIUser user, Action<SpriteText> creationParameters = null)
             => createLink(CreateChunkFor(user.Username, true, CreateSpriteText, creationParameters), new LinkDetails(LinkAction.OpenUserProfile, user.Id.ToString()), "view profile");
 
         private void createLink(ITextPart textPart, LinkDetails link, LocalisableString tooltipText, Action action = null)
diff --git a/osu.Game/Online/API/APIAccess.cs b/osu.Game/Online/API/APIAccess.cs
index 94508e3a81..8d91548149 100644
--- a/osu.Game/Online/API/APIAccess.cs
+++ b/osu.Game/Online/API/APIAccess.cs
@@ -17,6 +17,7 @@ using osu.Framework.Graphics;
 using osu.Framework.Logging;
 using osu.Game.Configuration;
 using osu.Game.Online.API.Requests;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Users;
 
 namespace osu.Game.Online.API
@@ -41,13 +42,13 @@ namespace osu.Game.Online.API
 
         private string password;
 
-        public IBindable<User> LocalUser => localUser;
-        public IBindableList<User> Friends => friends;
+        public IBindable<APIUser> LocalUser => localUser;
+        public IBindableList<APIUser> Friends => friends;
         public IBindable<UserActivity> Activity => activity;
 
-        private Bindable<User> localUser { get; } = new Bindable<User>(createGuestUser());
+        private Bindable<APIUser> localUser { get; } = new Bindable<APIUser>(createGuestUser());
 
-        private BindableList<User> friends { get; } = new BindableList<User>();
+        private BindableList<APIUser> friends { get; } = new BindableList<APIUser>();
 
         private Bindable<UserActivity> activity { get; } = new Bindable<UserActivity>();
 
@@ -436,7 +437,7 @@ namespace osu.Game.Online.API
             flushQueue();
         }
 
-        private static User createGuestUser() => new GuestUser();
+        private static APIUser createGuestUser() => new GuestUser();
 
         protected override void Dispose(bool isDisposing)
         {
@@ -447,7 +448,7 @@ namespace osu.Game.Online.API
         }
     }
 
-    internal class GuestUser : User
+    internal class GuestUser : APIUser
     {
         public GuestUser()
         {
diff --git a/osu.Game/Online/API/APIRequest.cs b/osu.Game/Online/API/APIRequest.cs
index 69d72226ba..43195811dc 100644
--- a/osu.Game/Online/API/APIRequest.cs
+++ b/osu.Game/Online/API/APIRequest.cs
@@ -6,7 +6,7 @@ using JetBrains.Annotations;
 using Newtonsoft.Json;
 using osu.Framework.IO.Network;
 using osu.Framework.Logging;
-using osu.Game.Users;
+using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Online.API
 {
@@ -69,7 +69,7 @@ namespace osu.Game.Online.API
         /// <summary>
         /// The currently logged in user. Note that this will only be populated during <see cref="Perform"/>.
         /// </summary>
-        protected User User { get; private set; }
+        protected APIUser User { get; private set; }
 
         /// <summary>
         /// Invoked on successful completion of an API request.
diff --git a/osu.Game/Online/API/DummyAPIAccess.cs b/osu.Game/Online/API/DummyAPIAccess.cs
index 8f91a4d198..7131c3a7d4 100644
--- a/osu.Game/Online/API/DummyAPIAccess.cs
+++ b/osu.Game/Online/API/DummyAPIAccess.cs
@@ -6,19 +6,20 @@ using System.Threading;
 using System.Threading.Tasks;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Users;
 
 namespace osu.Game.Online.API
 {
     public class DummyAPIAccess : Component, IAPIProvider
     {
-        public Bindable<User> LocalUser { get; } = new Bindable<User>(new User
+        public Bindable<APIUser> LocalUser { get; } = new Bindable<APIUser>(new APIUser
         {
             Username = @"Dummy",
             Id = 1001,
         });
 
-        public BindableList<User> Friends { get; } = new BindableList<User>();
+        public BindableList<APIUser> Friends { get; } = new BindableList<APIUser>();
 
         public Bindable<UserActivity> Activity { get; } = new Bindable<UserActivity>();
 
@@ -90,7 +91,7 @@ namespace osu.Game.Online.API
             }
 
             LastLoginError = null;
-            LocalUser.Value = new User
+            LocalUser.Value = new APIUser
             {
                 Username = username,
                 Id = 1001,
@@ -115,8 +116,8 @@ namespace osu.Game.Online.API
 
         public void SetState(APIState newState) => state.Value = newState;
 
-        IBindable<User> IAPIProvider.LocalUser => LocalUser;
-        IBindableList<User> IAPIProvider.Friends => Friends;
+        IBindable<APIUser> IAPIProvider.LocalUser => LocalUser;
+        IBindableList<APIUser> IAPIProvider.Friends => Friends;
         IBindable<UserActivity> IAPIProvider.Activity => Activity;
 
         public void FailNextLogin() => shouldFailNextLogin = true;
diff --git a/osu.Game/Online/API/IAPIProvider.cs b/osu.Game/Online/API/IAPIProvider.cs
index 72ca37bcf4..a97eae77e3 100644
--- a/osu.Game/Online/API/IAPIProvider.cs
+++ b/osu.Game/Online/API/IAPIProvider.cs
@@ -6,6 +6,7 @@
 using System;
 using System.Threading.Tasks;
 using osu.Framework.Bindables;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Users;
 
 namespace osu.Game.Online.API
@@ -16,13 +17,13 @@ namespace osu.Game.Online.API
         /// The local user.
         /// This is not thread-safe and should be scheduled locally if consumed from a drawable component.
         /// </summary>
-        IBindable<User> LocalUser { get; }
+        IBindable<APIUser> LocalUser { get; }
 
         /// <summary>
         /// The user's friends.
         /// This is not thread-safe and should be scheduled locally if consumed from a drawable component.
         /// </summary>
-        IBindableList<User> Friends { get; }
+        IBindableList<APIUser> Friends { get; }
 
         /// <summary>
         /// The current user's activity.
diff --git a/osu.Game/Online/API/Requests/CreateNewPrivateMessageRequest.cs b/osu.Game/Online/API/Requests/CreateNewPrivateMessageRequest.cs
index 37ffc04e04..e5761149e7 100644
--- a/osu.Game/Online/API/Requests/CreateNewPrivateMessageRequest.cs
+++ b/osu.Game/Online/API/Requests/CreateNewPrivateMessageRequest.cs
@@ -3,17 +3,17 @@
 
 using System.Net.Http;
 using osu.Framework.IO.Network;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Chat;
-using osu.Game.Users;
 
 namespace osu.Game.Online.API.Requests
 {
     public class CreateNewPrivateMessageRequest : APIRequest<CreateNewPrivateMessageResponse>
     {
-        private readonly User user;
+        private readonly APIUser user;
         private readonly Message message;
 
-        public CreateNewPrivateMessageRequest(User user, Message message)
+        public CreateNewPrivateMessageRequest(APIUser user, Message message)
         {
             this.user = user;
             this.message = message;
diff --git a/osu.Game/Online/API/Requests/GetFriendsRequest.cs b/osu.Game/Online/API/Requests/GetFriendsRequest.cs
index 46890aa889..63a221d91a 100644
--- a/osu.Game/Online/API/Requests/GetFriendsRequest.cs
+++ b/osu.Game/Online/API/Requests/GetFriendsRequest.cs
@@ -2,11 +2,11 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System.Collections.Generic;
-using osu.Game.Users;
+using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Online.API.Requests
 {
-    public class GetFriendsRequest : APIRequest<List<User>>
+    public class GetFriendsRequest : APIRequest<List<APIUser>>
     {
         protected override string Target => @"friends";
     }
diff --git a/osu.Game/Online/API/Requests/GetUserRequest.cs b/osu.Game/Online/API/Requests/GetUserRequest.cs
index 730e4e02ed..e32451fc2f 100644
--- a/osu.Game/Online/API/Requests/GetUserRequest.cs
+++ b/osu.Game/Online/API/Requests/GetUserRequest.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.Game.Users;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets;
 
 namespace osu.Game.Online.API.Requests
 {
-    public class GetUserRequest : APIRequest<User>
+    public class GetUserRequest : APIRequest<APIUser>
     {
         public readonly string Lookup;
         public readonly RulesetInfo Ruleset;
diff --git a/osu.Game/Online/API/Requests/GetUsersResponse.cs b/osu.Game/Online/API/Requests/GetUsersResponse.cs
index 6f49d5cd53..022050de5c 100644
--- a/osu.Game/Online/API/Requests/GetUsersResponse.cs
+++ b/osu.Game/Online/API/Requests/GetUsersResponse.cs
@@ -3,13 +3,13 @@
 
 using System.Collections.Generic;
 using Newtonsoft.Json;
-using osu.Game.Users;
+using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Online.API.Requests
 {
     public class GetUsersResponse : ResponseWithCursor
     {
         [JsonProperty("users")]
-        public List<User> Users;
+        public List<APIUser> Users;
     }
 }
diff --git a/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs b/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs
index 47536879b2..f8a0acf96e 100644
--- a/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs
@@ -6,7 +6,6 @@ using System.Collections.Generic;
 using Newtonsoft.Json;
 using osu.Game.Beatmaps;
 using osu.Game.Database;
-using osu.Game.Users;
 
 #nullable enable
 
@@ -72,10 +71,10 @@ namespace osu.Game.Online.API.Requests.Responses
         [JsonProperty("artist_unicode")]
         public string ArtistUnicode { get; set; } = string.Empty;
 
-        public User? Author = new User();
+        public APIUser? Author = new APIUser();
 
         /// <summary>
-        /// Helper property to deserialize a username to <see cref="User"/>.
+        /// Helper property to deserialize a username to <see cref="APIUser"/>.
         /// </summary>
         [JsonProperty(@"user_id")]
         public int AuthorID
@@ -83,13 +82,13 @@ namespace osu.Game.Online.API.Requests.Responses
             get => Author?.Id ?? 1;
             set
             {
-                Author ??= new User();
+                Author ??= new APIUser();
                 Author.Id = value;
             }
         }
 
         /// <summary>
-        /// Helper property to deserialize a username to <see cref="User"/>.
+        /// Helper property to deserialize a username to <see cref="APIUser"/>.
         /// </summary>
         [JsonProperty(@"creator")]
         public string AuthorString
@@ -97,7 +96,7 @@ namespace osu.Game.Online.API.Requests.Responses
             get => Author?.Username ?? string.Empty;
             set
             {
-                Author ??= new User();
+                Author ??= new APIUser();
                 Author.Username = value;
             }
         }
diff --git a/osu.Game/Online/API/Requests/Responses/APIPlayStyle.cs b/osu.Game/Online/API/Requests/Responses/APIPlayStyle.cs
new file mode 100644
index 0000000000..9573ae1825
--- /dev/null
+++ b/osu.Game/Online/API/Requests/Responses/APIPlayStyle.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 System.ComponentModel;
+
+namespace osu.Game.Online.API.Requests.Responses
+{
+    public enum APIPlayStyle
+    {
+        [Description("Keyboard")]
+        Keyboard,
+
+        [Description("Mouse")]
+        Mouse,
+
+        [Description("Tablet")]
+        Tablet,
+
+        [Description("Touch Screen")]
+        Touch,
+    }
+}
diff --git a/osu.Game/Online/API/Requests/Responses/APIScoreInfo.cs b/osu.Game/Online/API/Requests/Responses/APIScoreInfo.cs
index 82f56d27fd..d0677eacab 100644
--- a/osu.Game/Online/API/Requests/Responses/APIScoreInfo.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIScoreInfo.cs
@@ -12,7 +12,6 @@ using osu.Game.Rulesets;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Scoring;
 using osu.Game.Scoring.Legacy;
-using osu.Game.Users;
 
 namespace osu.Game.Online.API.Requests.Responses
 {
@@ -25,7 +24,7 @@ namespace osu.Game.Online.API.Requests.Responses
         public int MaxCombo { get; set; }
 
         [JsonProperty(@"user")]
-        public User User { get; set; }
+        public APIUser User { get; set; }
 
         [JsonProperty(@"id")]
         public long OnlineID { get; set; }
diff --git a/osu.Game/Online/API/Requests/Responses/APIUser.cs b/osu.Game/Online/API/Requests/Responses/APIUser.cs
index ff422b8292..aa5c556826 100644
--- a/osu.Game/Online/API/Requests/Responses/APIUser.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIUser.cs
@@ -1,14 +1,263 @@
 // 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 JetBrains.Annotations;
 using Newtonsoft.Json;
+using osu.Framework.Bindables;
 using osu.Game.Users;
 
 namespace osu.Game.Online.API.Requests.Responses
 {
-    public class APIUser
+    public class APIUser : IEquatable<APIUser>, IUser
     {
+        [JsonProperty(@"id")]
+        public int Id { get; set; } = 1;
+
+        [JsonProperty(@"join_date")]
+        public DateTimeOffset JoinDate;
+
+        [JsonProperty(@"username")]
+        public string Username { get; set; }
+
+        [JsonProperty(@"previous_usernames")]
+        public string[] PreviousUsernames;
+
+        [JsonProperty(@"country")]
+        public Country Country;
+
+        public readonly Bindable<UserStatus> Status = new Bindable<UserStatus>();
+
+        public readonly Bindable<UserActivity> Activity = new Bindable<UserActivity>();
+
+        [JsonProperty(@"profile_colour")]
+        public string Colour;
+
+        [JsonProperty(@"avatar_url")]
+        public string AvatarUrl;
+
+        [JsonProperty(@"cover_url")]
+        public string CoverUrl
+        {
+            get => Cover?.Url;
+            set => Cover = new UserCover { Url = value };
+        }
+
+        [JsonProperty(@"cover")]
+        public UserCover Cover;
+
+        public class UserCover
+        {
+            [JsonProperty(@"custom_url")]
+            public string CustomUrl;
+
+            [JsonProperty(@"url")]
+            public string Url;
+
+            [JsonProperty(@"id")]
+            public int? Id;
+        }
+
+        [JsonProperty(@"is_admin")]
+        public bool IsAdmin;
+
+        [JsonProperty(@"is_supporter")]
+        public bool IsSupporter;
+
+        [JsonProperty(@"support_level")]
+        public int SupportLevel;
+
+        [JsonProperty(@"is_gmt")]
+        public bool IsGMT;
+
+        [JsonProperty(@"is_qat")]
+        public bool IsQAT;
+
+        [JsonProperty(@"is_bng")]
+        public bool IsBNG;
+
+        [JsonProperty(@"is_bot")]
+        public bool IsBot;
+
+        [JsonProperty(@"is_active")]
+        public bool Active;
+
+        [JsonProperty(@"is_online")]
+        public bool IsOnline;
+
+        [JsonProperty(@"pm_friends_only")]
+        public bool PMFriendsOnly;
+
+        [JsonProperty(@"interests")]
+        public string Interests;
+
+        [JsonProperty(@"occupation")]
+        public string Occupation;
+
+        [JsonProperty(@"title")]
+        public string Title;
+
+        [JsonProperty(@"location")]
+        public string Location;
+
+        [JsonProperty(@"last_visit")]
+        public DateTimeOffset? LastVisit;
+
+        [JsonProperty(@"twitter")]
+        public string Twitter;
+
+        [JsonProperty(@"discord")]
+        public string Discord;
+
+        [JsonProperty(@"website")]
+        public string Website;
+
+        [JsonProperty(@"post_count")]
+        public int PostCount;
+
+        [JsonProperty(@"comments_count")]
+        public int CommentsCount;
+
+        [JsonProperty(@"follower_count")]
+        public int FollowerCount;
+
+        [JsonProperty(@"mapping_follower_count")]
+        public int MappingFollowerCount;
+
+        [JsonProperty(@"favourite_beatmapset_count")]
+        public int FavouriteBeatmapsetCount;
+
+        [JsonProperty(@"graveyard_beatmapset_count")]
+        public int GraveyardBeatmapsetCount;
+
+        [JsonProperty(@"loved_beatmapset_count")]
+        public int LovedBeatmapsetCount;
+
+        [JsonProperty(@"ranked_beatmapset_count")]
+        public int RankedBeatmapsetCount;
+
+        [JsonProperty(@"pending_beatmapset_count")]
+        public int PendingBeatmapsetCount;
+
+        [JsonProperty(@"scores_best_count")]
+        public int ScoresBestCount;
+
+        [JsonProperty(@"scores_first_count")]
+        public int ScoresFirstCount;
+
+        [JsonProperty(@"scores_recent_count")]
+        public int ScoresRecentCount;
+
+        [JsonProperty(@"beatmap_playcounts_count")]
+        public int BeatmapPlaycountsCount;
+
         [JsonProperty]
-        public User User;
+        private string[] playstyle
+        {
+            set => PlayStyles = value?.Select(str => Enum.Parse(typeof(APIPlayStyle), str, true)).Cast<APIPlayStyle>().ToArray();
+        }
+
+        public APIPlayStyle[] PlayStyles;
+
+        [JsonProperty(@"playmode")]
+        public string PlayMode;
+
+        [JsonProperty(@"profile_order")]
+        public string[] ProfileOrder;
+
+        [JsonProperty(@"kudosu")]
+        public KudosuCount Kudosu;
+
+        public class KudosuCount
+        {
+            [JsonProperty(@"total")]
+            public int Total;
+
+            [JsonProperty(@"available")]
+            public int Available;
+        }
+
+        private UserStatistics statistics;
+
+        /// <summary>
+        /// User statistics for the requested ruleset (in the case of a <see cref="GetUserRequest"/> or <see cref="GetFriendsRequest"/> response).
+        /// Otherwise empty.
+        /// </summary>
+        [JsonProperty(@"statistics")]
+        public UserStatistics Statistics
+        {
+            get => statistics ??= new UserStatistics();
+            set
+            {
+                if (statistics != null)
+                    // we may already have rank history populated
+                    value.RankHistory = statistics.RankHistory;
+
+                statistics = value;
+            }
+        }
+
+        [JsonProperty(@"rank_history")]
+        private RankHistoryData rankHistory
+        {
+            set => statistics.RankHistory = value;
+        }
+
+        public class RankHistoryData
+        {
+            [JsonProperty(@"mode")]
+            public string Mode;
+
+            [JsonProperty(@"data")]
+            public int[] Data;
+        }
+
+        [JsonProperty("badges")]
+        public Badge[] Badges;
+
+        [JsonProperty("user_achievements")]
+        public UserAchievement[] Achievements;
+
+        public class UserAchievement
+        {
+            [JsonProperty("achieved_at")]
+            public DateTimeOffset AchievedAt;
+
+            [JsonProperty("achievement_id")]
+            public int ID;
+        }
+
+        [JsonProperty("monthly_playcounts")]
+        public APIUserHistoryCount[] MonthlyPlaycounts;
+
+        [JsonProperty("replays_watched_counts")]
+        public APIUserHistoryCount[] ReplaysWatchedCounts;
+
+        /// <summary>
+        /// All user statistics per ruleset's short name (in the case of a <see cref="GetUsersRequest"/> response).
+        /// Otherwise empty. Can be altered for testing purposes.
+        /// </summary>
+        // todo: this should likely be moved to a separate UserCompact class at some point.
+        [JsonProperty("statistics_rulesets")]
+        [CanBeNull]
+        public Dictionary<string, UserStatistics> RulesetsStatistics { get; set; }
+
+        public override string ToString() => Username;
+
+        /// <summary>
+        /// A user instance for displaying locally created system messages.
+        /// </summary>
+        public static readonly APIUser SYSTEM_USER = new APIUser
+        {
+            Id = 0,
+            Username = "system",
+            Colour = @"9c0101",
+        };
+
+        public int OnlineID => Id;
+
+        public bool Equals(APIUser other) => OnlineID == other?.OnlineID;
     }
 }
diff --git a/osu.Game/Online/API/Requests/Responses/APIUserContainer.cs b/osu.Game/Online/API/Requests/Responses/APIUserContainer.cs
new file mode 100644
index 0000000000..9eb4a2a4e3
--- /dev/null
+++ b/osu.Game/Online/API/Requests/Responses/APIUserContainer.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 Newtonsoft.Json;
+
+namespace osu.Game.Online.API.Requests.Responses
+{
+    public class APIUserContainer
+    {
+        [JsonProperty]
+        public APIUser User;
+    }
+}
diff --git a/osu.Game/Online/API/Requests/Responses/APIUserHistoryCount.cs b/osu.Game/Online/API/Requests/Responses/APIUserHistoryCount.cs
new file mode 100644
index 0000000000..1226c88c08
--- /dev/null
+++ b/osu.Game/Online/API/Requests/Responses/APIUserHistoryCount.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 System;
+using Newtonsoft.Json;
+
+namespace osu.Game.Online.API.Requests.Responses
+{
+    public class APIUserHistoryCount
+    {
+        [JsonProperty("start_date")]
+        public DateTime Date;
+
+        [JsonProperty("count")]
+        public long Count;
+    }
+}
diff --git a/osu.Game/Online/API/Requests/Responses/APIUserScoreAggregate.cs b/osu.Game/Online/API/Requests/Responses/APIUserScoreAggregate.cs
index 172fa3a583..9a7f0832a6 100644
--- a/osu.Game/Online/API/Requests/Responses/APIUserScoreAggregate.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIUserScoreAggregate.cs
@@ -3,7 +3,6 @@
 
 using Newtonsoft.Json;
 using osu.Game.Scoring;
-using osu.Game.Users;
 
 namespace osu.Game.Online.API.Requests.Responses
 {
@@ -31,7 +30,7 @@ namespace osu.Game.Online.API.Requests.Responses
         public long UserID { get; set; }
 
         [JsonProperty("user")]
-        public User User { get; set; }
+        public APIUser User { get; set; }
 
         [JsonProperty("position")]
         public int? Position { get; set; }
diff --git a/osu.Game/Online/API/Requests/Responses/Comment.cs b/osu.Game/Online/API/Requests/Responses/Comment.cs
index 32d489432d..13379a40a6 100644
--- a/osu.Game/Online/API/Requests/Responses/Comment.cs
+++ b/osu.Game/Online/API/Requests/Responses/Comment.cs
@@ -2,7 +2,6 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using Newtonsoft.Json;
-using osu.Game.Users;
 using System;
 
 namespace osu.Game.Online.API.Requests.Responses
@@ -20,7 +19,7 @@ namespace osu.Game.Online.API.Requests.Responses
         [JsonProperty(@"user_id")]
         public long? UserId { get; set; }
 
-        public User User { get; set; }
+        public APIUser User { get; set; }
 
         [JsonProperty(@"message")]
         public string Message { get; set; }
@@ -61,7 +60,7 @@ namespace osu.Game.Online.API.Requests.Responses
         [JsonProperty(@"pinned")]
         public bool Pinned { get; set; }
 
-        public User EditedUser { get; set; }
+        public APIUser EditedUser { get; set; }
 
         public bool IsTopLevel => !ParentId.HasValue;
 
diff --git a/osu.Game/Online/API/Requests/Responses/CommentBundle.cs b/osu.Game/Online/API/Requests/Responses/CommentBundle.cs
index 4070df493d..8436381090 100644
--- a/osu.Game/Online/API/Requests/Responses/CommentBundle.cs
+++ b/osu.Game/Online/API/Requests/Responses/CommentBundle.cs
@@ -2,7 +2,6 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using Newtonsoft.Json;
-using osu.Game.Users;
 using System.Collections.Generic;
 using System.Linq;
 
@@ -43,10 +42,10 @@ namespace osu.Game.Online.API.Requests.Responses
             }
         }
 
-        private List<User> users;
+        private List<APIUser> users;
 
         [JsonProperty(@"users")]
-        public List<User> Users
+        public List<APIUser> Users
         {
             get => users;
             set
diff --git a/osu.Game/Online/Chat/Channel.cs b/osu.Game/Online/Chat/Channel.cs
index 9b463a6348..9cbb2f37e4 100644
--- a/osu.Game/Online/Chat/Channel.cs
+++ b/osu.Game/Online/Chat/Channel.cs
@@ -8,7 +8,7 @@ using System.Linq;
 using Newtonsoft.Json;
 using osu.Framework.Bindables;
 using osu.Framework.Lists;
-using osu.Game.Users;
+using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Online.Chat
 {
@@ -19,7 +19,7 @@ namespace osu.Game.Online.Chat
         /// <summary>
         /// Contains every joined user except the current logged in user. Currently only returned for PM channels.
         /// </summary>
-        public readonly ObservableCollection<User> Users = new ObservableCollection<User>();
+        public readonly ObservableCollection<APIUser> Users = new ObservableCollection<APIUser>();
 
         [JsonProperty(@"users")]
         private int[] userIds
@@ -27,7 +27,7 @@ namespace osu.Game.Online.Chat
             set
             {
                 foreach (int id in value)
-                    Users.Add(new User { Id = id });
+                    Users.Add(new APIUser { Id = id });
             }
         }
 
@@ -98,7 +98,7 @@ namespace osu.Game.Online.Chat
         /// Create a private messaging channel with the specified user.
         /// </summary>
         /// <param name="user">The user to create the private conversation with.</param>
-        public Channel(User user)
+        public Channel(APIUser user)
         {
             Type = ChannelType.PM;
             Users.Add(user);
diff --git a/osu.Game/Online/Chat/ChannelManager.cs b/osu.Game/Online/Chat/ChannelManager.cs
index 52c9387185..edaf135e93 100644
--- a/osu.Game/Online/Chat/ChannelManager.cs
+++ b/osu.Game/Online/Chat/ChannelManager.cs
@@ -11,8 +11,8 @@ using osu.Framework.Logging;
 using osu.Game.Database;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays.Chat.Tabs;
-using osu.Game.Users;
 
 namespace osu.Game.Online.Chat
 {
@@ -91,7 +91,7 @@ namespace osu.Game.Online.Chat
         /// Opens a new private channel.
         /// </summary>
         /// <param name="user">The user the private channel is opened with.</param>
-        public void OpenPrivateChannel(User user)
+        public void OpenPrivateChannel(APIUser user)
         {
             if (user == null)
                 throw new ArgumentNullException(nameof(user));
diff --git a/osu.Game/Online/Chat/InfoMessage.cs b/osu.Game/Online/Chat/InfoMessage.cs
index cea336aae2..e97245df45 100644
--- a/osu.Game/Online/Chat/InfoMessage.cs
+++ b/osu.Game/Online/Chat/InfoMessage.cs
@@ -2,7 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
-using osu.Game.Users;
+using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Online.Chat
 {
@@ -14,7 +14,7 @@ namespace osu.Game.Online.Chat
             Timestamp = DateTimeOffset.Now;
             Content = message;
 
-            Sender = User.SYSTEM_USER;
+            Sender = APIUser.SYSTEM_USER;
         }
     }
 }
diff --git a/osu.Game/Online/Chat/Message.cs b/osu.Game/Online/Chat/Message.cs
index 4f33153e56..dcd15f9028 100644
--- a/osu.Game/Online/Chat/Message.cs
+++ b/osu.Game/Online/Chat/Message.cs
@@ -4,7 +4,7 @@
 using System;
 using System.Collections.Generic;
 using Newtonsoft.Json;
-using osu.Game.Users;
+using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Online.Chat
 {
@@ -26,7 +26,7 @@ namespace osu.Game.Online.Chat
         public string Content;
 
         [JsonProperty(@"sender")]
-        public User Sender;
+        public APIUser Sender;
 
         [JsonConstructor]
         public Message()
diff --git a/osu.Game/Online/Chat/MessageNotifier.cs b/osu.Game/Online/Chat/MessageNotifier.cs
index 6840c036ff..ca6317566f 100644
--- a/osu.Game/Online/Chat/MessageNotifier.cs
+++ b/osu.Game/Online/Chat/MessageNotifier.cs
@@ -12,9 +12,9 @@ using osu.Framework.Graphics.Sprites;
 using osu.Game.Configuration;
 using osu.Game.Graphics;
 using osu.Game.Online.API;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays;
 using osu.Game.Overlays.Notifications;
-using osu.Game.Users;
 
 namespace osu.Game.Online.Chat
 {
@@ -35,7 +35,7 @@ namespace osu.Game.Online.Chat
         private Bindable<bool> notifyOnUsername;
         private Bindable<bool> notifyOnPrivateMessage;
 
-        private readonly IBindable<User> localUser = new Bindable<User>();
+        private readonly IBindable<APIUser> localUser = new Bindable<APIUser>();
         private readonly IBindableList<Channel> joinedChannels = new BindableList<Channel>();
 
         [BackgroundDependencyLoader]
diff --git a/osu.Game/Online/Multiplayer/MultiplayerClient.cs b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
index 6c4747ea54..567e59e8a0 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
@@ -22,8 +22,8 @@ using osu.Game.Online.Rooms;
 using osu.Game.Online.Rooms.RoomStatuses;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Mods;
-using osu.Game.Users;
 using osu.Game.Utils;
+using APIUser = osu.Game.Online.API.Requests.Responses.APIUser;
 
 namespace osu.Game.Online.Multiplayer
 {
@@ -402,7 +402,7 @@ namespace osu.Game.Online.Multiplayer
         {
             Debug.Assert(APIRoom != null);
 
-            APIRoom.RecentParticipants.Add(user.User ?? new User
+            APIRoom.RecentParticipants.Add(user.User ?? new APIUser
             {
                 Id = user.UserID,
                 Username = "[Unresolved]"
@@ -614,7 +614,7 @@ namespace osu.Game.Online.Multiplayer
         }
 
         /// <summary>
-        /// Populates the <see cref="User"/> for a given <see cref="MultiplayerRoomUser"/>.
+        /// Populates the <see cref="APIUser"/> for a given <see cref="MultiplayerRoomUser"/>.
         /// </summary>
         /// <param name="multiplayerUser">The <see cref="MultiplayerRoomUser"/> to populate.</param>
         protected async Task PopulateUser(MultiplayerRoomUser multiplayerUser) => multiplayerUser.User ??= await userLookupCache.GetUserAsync(multiplayerUser.UserID).ConfigureAwait(false);
diff --git a/osu.Game/Online/Multiplayer/MultiplayerRoomUser.cs b/osu.Game/Online/Multiplayer/MultiplayerRoomUser.cs
index 5d11e2921a..519bfff116 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerRoomUser.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerRoomUser.cs
@@ -9,8 +9,8 @@ using System.Linq;
 using MessagePack;
 using Newtonsoft.Json;
 using osu.Game.Online.API;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Rooms;
-using osu.Game.Users;
 
 namespace osu.Game.Online.Multiplayer
 {
@@ -40,7 +40,7 @@ namespace osu.Game.Online.Multiplayer
         public IEnumerable<APIMod> Mods { get; set; } = Enumerable.Empty<APIMod>();
 
         [IgnoreMember]
-        public User? User { get; set; }
+        public APIUser? User { get; set; }
 
         [JsonConstructor]
         public MultiplayerRoomUser(int userId)
diff --git a/osu.Game/Online/Rooms/MultiplayerScore.cs b/osu.Game/Online/Rooms/MultiplayerScore.cs
index 375e0b6b9f..cfb81f0bad 100644
--- a/osu.Game/Online/Rooms/MultiplayerScore.cs
+++ b/osu.Game/Online/Rooms/MultiplayerScore.cs
@@ -9,10 +9,10 @@ using Newtonsoft.Json;
 using Newtonsoft.Json.Converters;
 using osu.Game.Beatmaps;
 using osu.Game.Online.API;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Scoring;
 using osu.Game.Scoring;
-using osu.Game.Users;
 
 namespace osu.Game.Online.Rooms
 {
@@ -22,7 +22,7 @@ namespace osu.Game.Online.Rooms
         public long ID { get; set; }
 
         [JsonProperty("user")]
-        public User User { get; set; }
+        public APIUser User { get; set; }
 
         [JsonProperty("rank")]
         [JsonConverter(typeof(StringEnumConverter))]
diff --git a/osu.Game/Online/Rooms/Room.cs b/osu.Game/Online/Rooms/Room.cs
index 39fc7f1da8..48c5412aa3 100644
--- a/osu.Game/Online/Rooms/Room.cs
+++ b/osu.Game/Online/Rooms/Room.cs
@@ -7,8 +7,8 @@ using Newtonsoft.Json;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Game.IO.Serialization.Converters;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Rooms.RoomStatuses;
-using osu.Game.Users;
 using osu.Game.Utils;
 
 namespace osu.Game.Online.Rooms
@@ -25,7 +25,7 @@ namespace osu.Game.Online.Rooms
 
         [Cached]
         [JsonProperty("host")]
-        public readonly Bindable<User> Host = new Bindable<User>();
+        public readonly Bindable<APIUser> Host = new Bindable<APIUser>();
 
         [Cached]
         [JsonProperty("playlist")]
@@ -86,7 +86,7 @@ namespace osu.Game.Online.Rooms
 
         [Cached]
         [JsonProperty("recent_participants")]
-        public readonly BindableList<User> RecentParticipants = new BindableList<User>();
+        public readonly BindableList<APIUser> RecentParticipants = new BindableList<APIUser>();
 
         [Cached]
         [JsonProperty("participant_count")]
diff --git a/osu.Game/Online/Solo/SubmittableScore.cs b/osu.Game/Online/Solo/SubmittableScore.cs
index bafb308a13..373c302844 100644
--- a/osu.Game/Online/Solo/SubmittableScore.cs
+++ b/osu.Game/Online/Solo/SubmittableScore.cs
@@ -10,7 +10,7 @@ using osu.Game.Online.API;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets.Scoring;
 using osu.Game.Scoring;
-using osu.Game.Users;
+using APIUser = osu.Game.Online.API.Requests.Responses.APIUser;
 
 namespace osu.Game.Online.Solo
 {
@@ -48,7 +48,7 @@ namespace osu.Game.Online.Solo
         public APIMod[] Mods { get; set; }
 
         [JsonProperty("user")]
-        public User User { get; set; }
+        public APIUser User { get; set; }
 
         [JsonProperty("statistics")]
         public Dictionary<HitResult, int> Statistics { get; set; }
diff --git a/osu.Game/Overlays/BeatmapSet/AuthorInfo.cs b/osu.Game/Overlays/BeatmapSet/AuthorInfo.cs
index c90e2e2085..9131f6f74c 100644
--- a/osu.Game/Overlays/BeatmapSet/AuthorInfo.cs
+++ b/osu.Game/Overlays/BeatmapSet/AuthorInfo.cs
@@ -13,9 +13,9 @@ using osuTK.Graphics;
 using osu.Framework.Graphics.Effects;
 using osu.Framework.Graphics.Sprites;
 using osu.Game.Graphics;
-using osu.Game.Users;
 using osu.Game.Graphics.Containers;
 using osu.Game.Online.API.Requests.Responses;
+using APIUser = osu.Game.Online.API.Requests.Responses.APIUser;
 
 namespace osu.Game.Overlays.BeatmapSet
 {
@@ -144,7 +144,7 @@ namespace osu.Game.Overlays.BeatmapSet
                 };
             }
 
-            public Field(string first, User second, FontUsage secondFont)
+            public Field(string first, APIUser second, FontUsage secondFont)
             {
                 AutoSizeAxes = Axes.Both;
                 Direction = FillDirection.Horizontal;
diff --git a/osu.Game/Overlays/BeatmapSet/Buttons/FavouriteButton.cs b/osu.Game/Overlays/BeatmapSet/Buttons/FavouriteButton.cs
index d4873f241c..8fe7450873 100644
--- a/osu.Game/Overlays/BeatmapSet/Buttons/FavouriteButton.cs
+++ b/osu.Game/Overlays/BeatmapSet/Buttons/FavouriteButton.cs
@@ -14,8 +14,8 @@ using osu.Game.Online.API.Requests;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays.Notifications;
 using osu.Game.Resources.Localisation.Web;
-using osu.Game.Users;
 using osuTK;
+using APIUser = osu.Game.Online.API.Requests.Responses.APIUser;
 
 namespace osu.Game.Overlays.BeatmapSet.Buttons
 {
@@ -28,7 +28,7 @@ namespace osu.Game.Overlays.BeatmapSet.Buttons
         private PostBeatmapFavouriteRequest request;
         private LoadingLayer loading;
 
-        private readonly IBindable<User> localUser = new Bindable<User>();
+        private readonly IBindable<APIUser> localUser = new Bindable<APIUser>();
 
         public LocalisableString TooltipText
         {
diff --git a/osu.Game/Overlays/BeatmapSet/Buttons/HeaderDownloadButton.cs b/osu.Game/Overlays/BeatmapSet/Buttons/HeaderDownloadButton.cs
index bd7723d3c0..ee40f114d2 100644
--- a/osu.Game/Overlays/BeatmapSet/Buttons/HeaderDownloadButton.cs
+++ b/osu.Game/Overlays/BeatmapSet/Buttons/HeaderDownloadButton.cs
@@ -17,9 +17,9 @@ using osu.Game.Online.API;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays.BeatmapListing.Panels;
 using osu.Game.Resources.Localisation.Web;
-using osu.Game.Users;
 using osuTK;
 using osuTK.Graphics;
+using APIUser = osu.Game.Online.API.Requests.Responses.APIUser;
 using CommonStrings = osu.Game.Localisation.CommonStrings;
 
 namespace osu.Game.Overlays.BeatmapSet.Buttons
@@ -32,7 +32,7 @@ namespace osu.Game.Overlays.BeatmapSet.Buttons
 
         public LocalisableString TooltipText => BeatmapsetsStrings.ShowDetailsDownloadDefault;
 
-        private readonly IBindable<User> localUser = new Bindable<User>();
+        private readonly IBindable<APIUser> localUser = new Bindable<APIUser>();
 
         private ShakeContainer shakeContainer;
         private HeaderButton button;
@@ -165,7 +165,7 @@ namespace osu.Game.Overlays.BeatmapSet.Buttons
             }, true);
         }
 
-        private void userChanged(ValueChangedEvent<User> e) => button.Enabled.Value = !(e.NewValue is GuestUser);
+        private void userChanged(ValueChangedEvent<APIUser> e) => button.Enabled.Value = !(e.NewValue is GuestUser);
 
         private void enabledChanged(ValueChangedEvent<bool> e) => this.FadeColour(e.NewValue ? Color4.White : Color4.Gray, 200, Easing.OutQuint);
 
diff --git a/osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.cs b/osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.cs
index 69739b3352..15e700fc91 100644
--- a/osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.cs
+++ b/osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.cs
@@ -18,8 +18,8 @@ using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets;
 using osu.Game.Scoring;
 using osu.Game.Screens.Select.Leaderboards;
-using osu.Game.Users;
 using osuTK;
+using APIUser = osu.Game.Online.API.Requests.Responses.APIUser;
 
 namespace osu.Game.Overlays.BeatmapSet.Scores
 {
@@ -30,7 +30,7 @@ namespace osu.Game.Overlays.BeatmapSet.Scores
         public readonly Bindable<APIBeatmap> Beatmap = new Bindable<APIBeatmap>();
         private readonly Bindable<IRulesetInfo> ruleset = new Bindable<IRulesetInfo>();
         private readonly Bindable<BeatmapLeaderboardScope> scope = new Bindable<BeatmapLeaderboardScope>(BeatmapLeaderboardScope.Global);
-        private readonly IBindable<User> user = new Bindable<User>();
+        private readonly IBindable<APIUser> user = new Bindable<APIUser>();
 
         private readonly Box background;
         private readonly ScoreTable scoreTable;
@@ -227,7 +227,7 @@ namespace osu.Game.Overlays.BeatmapSet.Scores
             scope.Value = BeatmapLeaderboardScope.Global;
         }
 
-        private void onUserChanged(ValueChangedEvent<User> user)
+        private void onUserChanged(ValueChangedEvent<APIUser> user)
         {
             if (modSelector.SelectedMods.Any())
                 modSelector.DeselectAll();
diff --git a/osu.Game/Overlays/Changelog/ChangelogEntry.cs b/osu.Game/Overlays/Changelog/ChangelogEntry.cs
index 55edb40283..da062ca617 100644
--- a/osu.Game/Overlays/Changelog/ChangelogEntry.cs
+++ b/osu.Game/Overlays/Changelog/ChangelogEntry.cs
@@ -12,9 +12,9 @@ using osu.Framework.Graphics.Sprites;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Online.API.Requests.Responses;
-using osu.Game.Users;
 using osuTK;
 using osuTK.Graphics;
+using APIUser = osu.Game.Online.API.Requests.Responses.APIUser;
 
 namespace osu.Game.Overlays.Changelog
 {
@@ -131,7 +131,7 @@ namespace osu.Game.Overlays.Changelog
 
             if (entry.GithubUser.UserId != null)
             {
-                title.AddUserLink(new User
+                title.AddUserLink(new APIUser
                 {
                     Username = entry.GithubUser.OsuUsername,
                     Id = entry.GithubUser.UserId.Value
diff --git a/osu.Game/Overlays/Chat/ChatLine.cs b/osu.Game/Overlays/Chat/ChatLine.cs
index 6f4f568eb2..97cd913b56 100644
--- a/osu.Game/Overlays/Chat/ChatLine.cs
+++ b/osu.Game/Overlays/Chat/ChatLine.cs
@@ -17,8 +17,8 @@ using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Online.API;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Chat;
-using osu.Game.Users;
 using osuTK;
 using osuTK.Graphics;
 
@@ -217,14 +217,14 @@ namespace osu.Game.Overlays.Chat
 
         private class MessageSender : OsuClickableContainer, IHasContextMenu
         {
-            private readonly User sender;
+            private readonly APIUser sender;
 
             private Action startChatAction;
 
             [Resolved]
             private IAPIProvider api { get; set; }
 
-            public MessageSender(User sender)
+            public MessageSender(APIUser sender)
             {
                 this.sender = sender;
             }
@@ -240,7 +240,7 @@ namespace osu.Game.Overlays.Chat
             {
                 get
                 {
-                    if (sender.Equals(User.SYSTEM_USER))
+                    if (sender.Equals(APIUser.SYSTEM_USER))
                         return Array.Empty<MenuItem>();
 
                     List<MenuItem> items = new List<MenuItem>
diff --git a/osu.Game/Overlays/Comments/CommentsContainer.cs b/osu.Game/Overlays/Comments/CommentsContainer.cs
index 6b3d816e84..970fc5ccef 100644
--- a/osu.Game/Overlays/Comments/CommentsContainer.cs
+++ b/osu.Game/Overlays/Comments/CommentsContainer.cs
@@ -13,10 +13,10 @@ using System.Threading;
 using System.Linq;
 using osu.Framework.Extensions.IEnumerableExtensions;
 using osu.Framework.Threading;
-using osu.Game.Users;
 using System.Collections.Generic;
 using JetBrains.Annotations;
 using osu.Game.Graphics.Sprites;
+using APIUser = osu.Game.Online.API.Requests.Responses.APIUser;
 
 namespace osu.Game.Overlays.Comments
 {
@@ -28,7 +28,7 @@ namespace osu.Game.Overlays.Comments
         public readonly Bindable<CommentsSortCriteria> Sort = new Bindable<CommentsSortCriteria>();
         public readonly BindableBool ShowDeleted = new BindableBool();
 
-        protected readonly IBindable<User> User = new Bindable<User>();
+        protected readonly IBindable<APIUser> User = new Bindable<APIUser>();
 
         [Resolved]
         private IAPIProvider api { get; set; }
diff --git a/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs b/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs
index 454dd500fe..269ed81bb5 100644
--- a/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs
+++ b/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs
@@ -10,6 +10,7 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Screens;
 using osu.Game.Database;
 using osu.Game.Online.API;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Spectator;
 using osu.Game.Screens.OnlinePlay.Match.Components;
 using osu.Game.Screens.Play;
@@ -91,7 +92,7 @@ namespace osu.Game.Overlays.Dashboard
             }
         });
 
-        private PlayingUserPanel createUserPanel(User user) =>
+        private PlayingUserPanel createUserPanel(APIUser user) =>
             new PlayingUserPanel(user).With(panel =>
             {
                 panel.Anchor = Anchor.TopCentre;
@@ -100,12 +101,12 @@ namespace osu.Game.Overlays.Dashboard
 
         private class PlayingUserPanel : CompositeDrawable
         {
-            public readonly User User;
+            public readonly APIUser User;
 
             [Resolved(canBeNull: true)]
             private OsuGame game { get; set; }
 
-            public PlayingUserPanel(User user)
+            public PlayingUserPanel(APIUser user)
             {
                 User = user;
 
diff --git a/osu.Game/Overlays/Dashboard/Friends/FriendDisplay.cs b/osu.Game/Overlays/Dashboard/Friends/FriendDisplay.cs
index 0922ce5ecc..765f037d70 100644
--- a/osu.Game/Overlays/Dashboard/Friends/FriendDisplay.cs
+++ b/osu.Game/Overlays/Dashboard/Friends/FriendDisplay.cs
@@ -11,6 +11,7 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Online.API;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Users;
 using osuTK;
 
@@ -18,9 +19,9 @@ namespace osu.Game.Overlays.Dashboard.Friends
 {
     public class FriendDisplay : CompositeDrawable
     {
-        private List<User> users = new List<User>();
+        private List<APIUser> users = new List<APIUser>();
 
-        public List<User> Users
+        public List<APIUser> Users
         {
             get => users;
             set
@@ -41,7 +42,7 @@ namespace osu.Game.Overlays.Dashboard.Friends
         private Container itemsPlaceholder;
         private LoadingLayer loading;
 
-        private readonly IBindableList<User> apiFriends = new BindableList<User>();
+        private readonly IBindableList<APIUser> apiFriends = new BindableList<APIUser>();
 
         public FriendDisplay()
         {
@@ -169,7 +170,7 @@ namespace osu.Game.Overlays.Dashboard.Friends
             LoadComponentAsync(createTable(sortedUsers), addContentToPlaceholder, (cancellationToken = new CancellationTokenSource()).Token);
         }
 
-        private List<User> getUsersInCurrentGroup()
+        private List<APIUser> getUsersInCurrentGroup()
         {
             switch (onlineStreamControl.Current.Value?.Status)
             {
@@ -201,7 +202,7 @@ namespace osu.Game.Overlays.Dashboard.Friends
             currentContent.FadeIn(200, Easing.OutQuint);
         }
 
-        private FillFlowContainer createTable(List<User> users)
+        private FillFlowContainer createTable(List<APIUser> users)
         {
             var style = userListToolbar.DisplayStyle.Value;
 
@@ -214,7 +215,7 @@ namespace osu.Game.Overlays.Dashboard.Friends
             };
         }
 
-        private UserPanel createUserPanel(User user, OverlayPanelDisplayStyle style)
+        private UserPanel createUserPanel(APIUser user, OverlayPanelDisplayStyle style)
         {
             switch (style)
             {
@@ -235,7 +236,7 @@ namespace osu.Game.Overlays.Dashboard.Friends
             }
         }
 
-        private List<User> sortUsers(List<User> unsorted)
+        private List<APIUser> sortUsers(List<APIUser> unsorted)
         {
             switch (userListToolbar.SortCriteria.Value)
             {
diff --git a/osu.Game/Overlays/Dashboard/Friends/FriendOnlineStreamControl.cs b/osu.Game/Overlays/Dashboard/Friends/FriendOnlineStreamControl.cs
index d7f66e35b5..7275cdff7c 100644
--- a/osu.Game/Overlays/Dashboard/Friends/FriendOnlineStreamControl.cs
+++ b/osu.Game/Overlays/Dashboard/Friends/FriendOnlineStreamControl.cs
@@ -3,7 +3,7 @@
 
 using System.Collections.Generic;
 using System.Linq;
-using osu.Game.Users;
+using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Overlays.Dashboard.Friends
 {
@@ -11,7 +11,7 @@ namespace osu.Game.Overlays.Dashboard.Friends
     {
         protected override OverlayStreamItem<FriendStream> CreateStreamItem(FriendStream value) => new FriendsOnlineStatusItem(value);
 
-        public void Populate(List<User> users)
+        public void Populate(List<APIUser> users)
         {
             Clear();
 
diff --git a/osu.Game/Overlays/Profile/Header/BottomHeaderContainer.cs b/osu.Game/Overlays/Profile/Header/BottomHeaderContainer.cs
index fe61e532e1..ea52cec2e1 100644
--- a/osu.Game/Overlays/Profile/Header/BottomHeaderContainer.cs
+++ b/osu.Game/Overlays/Profile/Header/BottomHeaderContainer.cs
@@ -14,7 +14,7 @@ using osu.Framework.Graphics.Sprites;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Online.API;
-using osu.Game.Users;
+using osu.Game.Online.API.Requests.Responses;
 using osuTK;
 using osuTK.Graphics;
 
@@ -22,7 +22,7 @@ namespace osu.Game.Overlays.Profile.Header
 {
     public class BottomHeaderContainer : CompositeDrawable
     {
-        public readonly Bindable<User> User = new Bindable<User>();
+        public readonly Bindable<APIUser> User = new Bindable<APIUser>();
 
         private LinkFlowContainer topLinkContainer;
         private LinkFlowContainer bottomLinkContainer;
@@ -75,7 +75,7 @@ namespace osu.Game.Overlays.Profile.Header
             User.BindValueChanged(user => updateDisplay(user.NewValue));
         }
 
-        private void updateDisplay(User user)
+        private void updateDisplay(APIUser user)
         {
             topLinkContainer.Clear();
             bottomLinkContainer.Clear();
diff --git a/osu.Game/Overlays/Profile/Header/CentreHeaderContainer.cs b/osu.Game/Overlays/Profile/Header/CentreHeaderContainer.cs
index 180a288729..a13f5ed6ce 100644
--- a/osu.Game/Overlays/Profile/Header/CentreHeaderContainer.cs
+++ b/osu.Game/Overlays/Profile/Header/CentreHeaderContainer.cs
@@ -9,9 +9,9 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Graphics.Textures;
 using osu.Framework.Localisation;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays.Profile.Header.Components;
 using osu.Game.Resources.Localisation.Web;
-using osu.Game.Users;
 using osuTK;
 
 namespace osu.Game.Overlays.Profile.Header
@@ -19,7 +19,7 @@ namespace osu.Game.Overlays.Profile.Header
     public class CentreHeaderContainer : CompositeDrawable
     {
         public readonly BindableBool DetailsVisible = new BindableBool(true);
-        public readonly Bindable<User> User = new Bindable<User>();
+        public readonly Bindable<APIUser> User = new Bindable<APIUser>();
 
         private OverlinedInfoContainer hiddenDetailGlobal;
         private OverlinedInfoContainer hiddenDetailCountry;
@@ -145,7 +145,7 @@ namespace osu.Game.Overlays.Profile.Header
             User.BindValueChanged(user => updateDisplay(user.NewValue));
         }
 
-        private void updateDisplay(User user)
+        private void updateDisplay(APIUser user)
         {
             hiddenDetailGlobal.Content = user?.Statistics?.GlobalRank?.ToLocalisableString("\\##,##0") ?? (LocalisableString)"-";
             hiddenDetailCountry.Content = user?.Statistics?.CountryRank?.ToLocalisableString("\\##,##0") ?? (LocalisableString)"-";
diff --git a/osu.Game/Overlays/Profile/Header/Components/FollowersButton.cs b/osu.Game/Overlays/Profile/Header/Components/FollowersButton.cs
index 8f66120055..1b21bfc982 100644
--- a/osu.Game/Overlays/Profile/Header/Components/FollowersButton.cs
+++ b/osu.Game/Overlays/Profile/Header/Components/FollowersButton.cs
@@ -5,14 +5,14 @@ using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Localisation;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Resources.Localisation.Web;
-using osu.Game.Users;
 
 namespace osu.Game.Overlays.Profile.Header.Components
 {
     public class FollowersButton : ProfileHeaderStatisticsButton
     {
-        public readonly Bindable<User> User = new Bindable<User>();
+        public readonly Bindable<APIUser> User = new Bindable<APIUser>();
 
         public override LocalisableString TooltipText => FriendsStrings.ButtonsDisabled;
 
diff --git a/osu.Game/Overlays/Profile/Header/Components/LevelBadge.cs b/osu.Game/Overlays/Profile/Header/Components/LevelBadge.cs
index 1deed1a748..e1302788da 100644
--- a/osu.Game/Overlays/Profile/Header/Components/LevelBadge.cs
+++ b/osu.Game/Overlays/Profile/Header/Components/LevelBadge.cs
@@ -11,14 +11,14 @@ using osu.Framework.Graphics.Textures;
 using osu.Framework.Localisation;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Resources.Localisation.Web;
-using osu.Game.Users;
 
 namespace osu.Game.Overlays.Profile.Header.Components
 {
     public class LevelBadge : CompositeDrawable, IHasTooltip
     {
-        public readonly Bindable<User> User = new Bindable<User>();
+        public readonly Bindable<APIUser> User = new Bindable<APIUser>();
 
         public LocalisableString TooltipText { get; private set; }
 
@@ -51,7 +51,7 @@ namespace osu.Game.Overlays.Profile.Header.Components
             User.BindValueChanged(user => updateLevel(user.NewValue));
         }
 
-        private void updateLevel(User user)
+        private void updateLevel(APIUser user)
         {
             levelText.Text = user?.Statistics?.Level.Current.ToString() ?? "0";
             TooltipText = UsersStrings.ShowStatsLevel(user?.Statistics?.Level.Current.ToString());
diff --git a/osu.Game/Overlays/Profile/Header/Components/LevelProgressBar.cs b/osu.Game/Overlays/Profile/Header/Components/LevelProgressBar.cs
index 2c8c421eba..8f6b935128 100644
--- a/osu.Game/Overlays/Profile/Header/Components/LevelProgressBar.cs
+++ b/osu.Game/Overlays/Profile/Header/Components/LevelProgressBar.cs
@@ -11,15 +11,15 @@ using osu.Framework.Localisation;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.UserInterface;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Resources.Localisation.Web;
-using osu.Game.Users;
 using osuTK.Graphics;
 
 namespace osu.Game.Overlays.Profile.Header.Components
 {
     public class LevelProgressBar : CompositeDrawable, IHasTooltip
     {
-        public readonly Bindable<User> User = new Bindable<User>();
+        public readonly Bindable<APIUser> User = new Bindable<APIUser>();
 
         public LocalisableString TooltipText { get; }
 
@@ -59,7 +59,7 @@ namespace osu.Game.Overlays.Profile.Header.Components
             User.BindValueChanged(user => updateProgress(user.NewValue));
         }
 
-        private void updateProgress(User user)
+        private void updateProgress(APIUser user)
         {
             levelProgressBar.Length = user?.Statistics?.Level.Progress / 100f ?? 0;
             levelProgressText.Text = user?.Statistics?.Level.Progress.ToLocalisableString("0'%'");
diff --git a/osu.Game/Overlays/Profile/Header/Components/MappingSubscribersButton.cs b/osu.Game/Overlays/Profile/Header/Components/MappingSubscribersButton.cs
index 5cdf3a5ef9..6d1024ff18 100644
--- a/osu.Game/Overlays/Profile/Header/Components/MappingSubscribersButton.cs
+++ b/osu.Game/Overlays/Profile/Header/Components/MappingSubscribersButton.cs
@@ -5,14 +5,14 @@ using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Localisation;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Resources.Localisation.Web;
-using osu.Game.Users;
 
 namespace osu.Game.Overlays.Profile.Header.Components
 {
     public class MappingSubscribersButton : ProfileHeaderStatisticsButton
     {
-        public readonly Bindable<User> User = new Bindable<User>();
+        public readonly Bindable<APIUser> User = new Bindable<APIUser>();
 
         public override LocalisableString TooltipText => FollowsStrings.MappingFollowers;
 
diff --git a/osu.Game/Overlays/Profile/Header/Components/MessageUserButton.cs b/osu.Game/Overlays/Profile/Header/Components/MessageUserButton.cs
index 07f1f1c3ed..e3dc5f818a 100644
--- a/osu.Game/Overlays/Profile/Header/Components/MessageUserButton.cs
+++ b/osu.Game/Overlays/Profile/Header/Components/MessageUserButton.cs
@@ -7,16 +7,16 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Localisation;
 using osu.Game.Online.API;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Chat;
 using osu.Game.Resources.Localisation.Web;
-using osu.Game.Users;
 using osuTK;
 
 namespace osu.Game.Overlays.Profile.Header.Components
 {
     public class MessageUserButton : ProfileHeaderButton
     {
-        public readonly Bindable<User> User = new Bindable<User>();
+        public readonly Bindable<APIUser> User = new Bindable<APIUser>();
 
         public override LocalisableString TooltipText => UsersStrings.CardSendMessage;
 
diff --git a/osu.Game/Overlays/Profile/Header/Components/OverlinedTotalPlayTime.cs b/osu.Game/Overlays/Profile/Header/Components/OverlinedTotalPlayTime.cs
index 1a40944632..1ead2cd2f5 100644
--- a/osu.Game/Overlays/Profile/Header/Components/OverlinedTotalPlayTime.cs
+++ b/osu.Game/Overlays/Profile/Header/Components/OverlinedTotalPlayTime.cs
@@ -7,14 +7,14 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Cursor;
 using osu.Framework.Localisation;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Resources.Localisation.Web;
-using osu.Game.Users;
 
 namespace osu.Game.Overlays.Profile.Header.Components
 {
     public class OverlinedTotalPlayTime : CompositeDrawable, IHasTooltip
     {
-        public readonly Bindable<User> User = new Bindable<User>();
+        public readonly Bindable<APIUser> User = new Bindable<APIUser>();
 
         public LocalisableString TooltipText { get; set; }
 
@@ -39,7 +39,7 @@ namespace osu.Game.Overlays.Profile.Header.Components
             User.BindValueChanged(updateTime, true);
         }
 
-        private void updateTime(ValueChangedEvent<User> user)
+        private void updateTime(ValueChangedEvent<APIUser> user)
         {
             TooltipText = (user.NewValue?.Statistics?.PlayTime ?? 0) / 3600 + " hours";
             info.Content = formatTime(user.NewValue?.Statistics?.PlayTime);
diff --git a/osu.Game/Overlays/Profile/Header/Components/PreviousUsernames.cs b/osu.Game/Overlays/Profile/Header/Components/PreviousUsernames.cs
index b1076ba39b..229bbaef83 100644
--- a/osu.Game/Overlays/Profile/Header/Components/PreviousUsernames.cs
+++ b/osu.Game/Overlays/Profile/Header/Components/PreviousUsernames.cs
@@ -12,8 +12,8 @@ using osu.Framework.Graphics.Sprites;
 using osu.Framework.Input.Events;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Resources.Localisation.Web;
-using osu.Game.Users;
 using osuTK;
 
 namespace osu.Game.Overlays.Profile.Header.Components
@@ -25,7 +25,7 @@ namespace osu.Game.Overlays.Profile.Header.Components
         private const int width = 310;
         private const int move_offset = 15;
 
-        public readonly Bindable<User> User = new Bindable<User>();
+        public readonly Bindable<APIUser> User = new Bindable<APIUser>();
 
         private readonly TextFlowContainer text;
         private readonly Box background;
@@ -107,7 +107,7 @@ namespace osu.Game.Overlays.Profile.Header.Components
             User.BindValueChanged(onUserChanged, true);
         }
 
-        private void onUserChanged(ValueChangedEvent<User> user)
+        private void onUserChanged(ValueChangedEvent<APIUser> user)
         {
             text.Text = string.Empty;
 
diff --git a/osu.Game/Overlays/Profile/Header/Components/ProfileRulesetSelector.cs b/osu.Game/Overlays/Profile/Header/Components/ProfileRulesetSelector.cs
index 41a3ee8ad6..eaa9703834 100644
--- a/osu.Game/Overlays/Profile/Header/Components/ProfileRulesetSelector.cs
+++ b/osu.Game/Overlays/Profile/Header/Components/ProfileRulesetSelector.cs
@@ -3,14 +3,14 @@
 
 using osu.Framework.Bindables;
 using osu.Framework.Graphics.UserInterface;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets;
-using osu.Game.Users;
 
 namespace osu.Game.Overlays.Profile.Header.Components
 {
     public class ProfileRulesetSelector : OverlayRulesetSelector
     {
-        public readonly Bindable<User> User = new Bindable<User>();
+        public readonly Bindable<APIUser> User = new Bindable<APIUser>();
 
         protected override void LoadComplete()
         {
diff --git a/osu.Game/Overlays/Profile/Header/DetailHeaderContainer.cs b/osu.Game/Overlays/Profile/Header/DetailHeaderContainer.cs
index 8ca6961950..79e553062d 100644
--- a/osu.Game/Overlays/Profile/Header/DetailHeaderContainer.cs
+++ b/osu.Game/Overlays/Profile/Header/DetailHeaderContainer.cs
@@ -11,11 +11,11 @@ using osu.Framework.Graphics.Shapes;
 using osu.Framework.Localisation;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Leaderboards;
 using osu.Game.Overlays.Profile.Header.Components;
 using osu.Game.Resources.Localisation.Web;
 using osu.Game.Scoring;
-using osu.Game.Users;
 using osuTK;
 
 namespace osu.Game.Overlays.Profile.Header
@@ -30,7 +30,7 @@ namespace osu.Game.Overlays.Profile.Header
         private FillFlowContainer fillFlow;
         private RankGraph rankGraph;
 
-        public readonly Bindable<User> User = new Bindable<User>();
+        public readonly Bindable<APIUser> User = new Bindable<APIUser>();
 
         private bool expanded = true;
 
@@ -171,7 +171,7 @@ namespace osu.Game.Overlays.Profile.Header
             };
         }
 
-        private void updateDisplay(User user)
+        private void updateDisplay(APIUser user)
         {
             medalInfo.Content = user?.Achievements?.Length.ToString() ?? "0";
             ppInfo.Content = user?.Statistics?.PP?.ToLocalisableString("#,##0") ?? (LocalisableString)"0";
diff --git a/osu.Game/Overlays/Profile/Header/MedalHeaderContainer.cs b/osu.Game/Overlays/Profile/Header/MedalHeaderContainer.cs
index f6419db540..5f513582e5 100644
--- a/osu.Game/Overlays/Profile/Header/MedalHeaderContainer.cs
+++ b/osu.Game/Overlays/Profile/Header/MedalHeaderContainer.cs
@@ -8,8 +8,8 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Colour;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays.Profile.Header.Components;
-using osu.Game.Users;
 using osuTK;
 using osuTK.Graphics;
 
@@ -19,7 +19,7 @@ namespace osu.Game.Overlays.Profile.Header
     {
         private FillFlowContainer badgeFlowContainer;
 
-        public readonly Bindable<User> User = new Bindable<User>();
+        public readonly Bindable<APIUser> User = new Bindable<APIUser>();
 
         [BackgroundDependencyLoader]
         private void load(OverlayColourProvider colourProvider)
@@ -63,7 +63,7 @@ namespace osu.Game.Overlays.Profile.Header
             };
         }
 
-        private void updateDisplay(User user)
+        private void updateDisplay(APIUser user)
         {
             var badges = user.Badges;
             badgeFlowContainer.Clear();
diff --git a/osu.Game/Overlays/Profile/Header/TopHeaderContainer.cs b/osu.Game/Overlays/Profile/Header/TopHeaderContainer.cs
index f5720cffb0..6ba5cb2f7f 100644
--- a/osu.Game/Overlays/Profile/Header/TopHeaderContainer.cs
+++ b/osu.Game/Overlays/Profile/Header/TopHeaderContainer.cs
@@ -13,9 +13,9 @@ using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Online.API;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays.Profile.Header.Components;
 using osu.Game.Resources.Localisation.Web;
-using osu.Game.Users;
 using osu.Game.Users.Drawables;
 using osuTK;
 
@@ -25,7 +25,7 @@ namespace osu.Game.Overlays.Profile.Header
     {
         private const float avatar_size = 110;
 
-        public readonly Bindable<User> User = new Bindable<User>();
+        public readonly Bindable<APIUser> User = new Bindable<APIUser>();
 
         [Resolved]
         private IAPIProvider api { get; set; }
@@ -167,7 +167,7 @@ namespace osu.Game.Overlays.Profile.Header
             User.BindValueChanged(user => updateUser(user.NewValue));
         }
 
-        private void updateUser(User user)
+        private void updateUser(APIUser user)
         {
             avatar.User = user;
             usernameText.Text = user?.Username ?? string.Empty;
diff --git a/osu.Game/Overlays/Profile/ProfileHeader.cs b/osu.Game/Overlays/Profile/ProfileHeader.cs
index 815f9fdafc..fab2487c0d 100644
--- a/osu.Game/Overlays/Profile/ProfileHeader.cs
+++ b/osu.Game/Overlays/Profile/ProfileHeader.cs
@@ -8,6 +8,7 @@ using osu.Framework.Graphics.Colour;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Localisation;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays.Profile.Header;
 using osu.Game.Resources.Localisation.Web;
 using osu.Game.Users;
@@ -18,7 +19,7 @@ namespace osu.Game.Overlays.Profile
     {
         private UserCoverBackground coverContainer;
 
-        public Bindable<User> User = new Bindable<User>();
+        public Bindable<APIUser> User = new Bindable<APIUser>();
 
         private CentreHeaderContainer centreHeaderContainer;
         private DetailHeaderContainer detailHeaderContainer;
@@ -92,7 +93,7 @@ namespace osu.Game.Overlays.Profile
 
         protected override OverlayTitle CreateTitle() => new ProfileHeaderTitle();
 
-        private void updateDisplay(User user) => coverContainer.User = user;
+        private void updateDisplay(APIUser user) => coverContainer.User = user;
 
         private class ProfileHeaderTitle : OverlayTitle
         {
diff --git a/osu.Game/Overlays/Profile/ProfileSection.cs b/osu.Game/Overlays/Profile/ProfileSection.cs
index 1a5f562fff..6223b32814 100644
--- a/osu.Game/Overlays/Profile/ProfileSection.cs
+++ b/osu.Game/Overlays/Profile/ProfileSection.cs
@@ -12,7 +12,7 @@ using osu.Framework.Localisation;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Backgrounds;
 using osu.Game.Graphics.Sprites;
-using osu.Game.Users;
+using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Overlays.Profile
 {
@@ -28,7 +28,7 @@ namespace osu.Game.Overlays.Profile
 
         protected override Container<Drawable> Content => content;
 
-        public readonly Bindable<User> User = new Bindable<User>();
+        public readonly Bindable<APIUser> User = new Bindable<APIUser>();
 
         protected ProfileSection()
         {
diff --git a/osu.Game/Overlays/Profile/Sections/Beatmaps/PaginatedBeatmapContainer.cs b/osu.Game/Overlays/Profile/Sections/Beatmaps/PaginatedBeatmapContainer.cs
index fffa20dc11..36b94283e5 100644
--- a/osu.Game/Overlays/Profile/Sections/Beatmaps/PaginatedBeatmapContainer.cs
+++ b/osu.Game/Overlays/Profile/Sections/Beatmaps/PaginatedBeatmapContainer.cs
@@ -10,8 +10,8 @@ using osu.Game.Online.API;
 using osu.Game.Online.API.Requests;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays.BeatmapListing.Panels;
-using osu.Game.Users;
 using osuTK;
+using APIUser = osu.Game.Online.API.Requests.Responses.APIUser;
 
 namespace osu.Game.Overlays.Profile.Sections.Beatmaps
 {
@@ -20,7 +20,7 @@ namespace osu.Game.Overlays.Profile.Sections.Beatmaps
         private const float panel_padding = 10f;
         private readonly BeatmapSetType type;
 
-        public PaginatedBeatmapContainer(BeatmapSetType type, Bindable<User> user, LocalisableString headerText)
+        public PaginatedBeatmapContainer(BeatmapSetType type, Bindable<APIUser> user, LocalisableString headerText)
             : base(user, headerText)
         {
             this.type = type;
@@ -33,7 +33,7 @@ namespace osu.Game.Overlays.Profile.Sections.Beatmaps
             ItemsContainer.Spacing = new Vector2(panel_padding);
         }
 
-        protected override int GetCount(User user)
+        protected override int GetCount(APIUser user)
         {
             switch (type)
             {
diff --git a/osu.Game/Overlays/Profile/Sections/Historical/ChartProfileSubsection.cs b/osu.Game/Overlays/Profile/Sections/Historical/ChartProfileSubsection.cs
index 986b3d9874..4edbdc31bd 100644
--- a/osu.Game/Overlays/Profile/Sections/Historical/ChartProfileSubsection.cs
+++ b/osu.Game/Overlays/Profile/Sections/Historical/ChartProfileSubsection.cs
@@ -7,8 +7,7 @@ using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Localisation;
-using osu.Game.Users;
-using static osu.Game.Users.User;
+using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Overlays.Profile.Sections.Historical
 {
@@ -21,7 +20,7 @@ namespace osu.Game.Overlays.Profile.Sections.Historical
         /// </summary>
         protected abstract LocalisableString GraphCounterName { get; }
 
-        protected ChartProfileSubsection(Bindable<User> user, LocalisableString headerText)
+        protected ChartProfileSubsection(Bindable<APIUser> user, LocalisableString headerText)
             : base(user, headerText)
         {
         }
@@ -45,7 +44,7 @@ namespace osu.Game.Overlays.Profile.Sections.Historical
             User.BindValueChanged(onUserChanged, true);
         }
 
-        private void onUserChanged(ValueChangedEvent<User> e)
+        private void onUserChanged(ValueChangedEvent<APIUser> e)
         {
             var values = GetValues(e.NewValue);
 
@@ -62,9 +61,9 @@ namespace osu.Game.Overlays.Profile.Sections.Historical
         /// <summary>
         /// Add entries for any missing months (filled with zero values).
         /// </summary>
-        private UserHistoryCount[] fillZeroValues(UserHistoryCount[] historyEntries)
+        private APIUserHistoryCount[] fillZeroValues(APIUserHistoryCount[] historyEntries)
         {
-            var filledHistoryEntries = new List<UserHistoryCount>();
+            var filledHistoryEntries = new List<APIUserHistoryCount>();
 
             foreach (var entry in historyEntries)
             {
@@ -72,7 +71,7 @@ namespace osu.Game.Overlays.Profile.Sections.Historical
 
                 while (lastFilled?.Date.AddMonths(1) < entry.Date)
                 {
-                    filledHistoryEntries.Add(lastFilled = new UserHistoryCount
+                    filledHistoryEntries.Add(lastFilled = new APIUserHistoryCount
                     {
                         Count = 0,
                         Date = lastFilled.Date.AddMonths(1)
@@ -85,6 +84,6 @@ namespace osu.Game.Overlays.Profile.Sections.Historical
             return filledHistoryEntries.ToArray();
         }
 
-        protected abstract UserHistoryCount[] GetValues(User user);
+        protected abstract APIUserHistoryCount[] GetValues(APIUser user);
     }
 }
diff --git a/osu.Game/Overlays/Profile/Sections/Historical/PaginatedMostPlayedBeatmapContainer.cs b/osu.Game/Overlays/Profile/Sections/Historical/PaginatedMostPlayedBeatmapContainer.cs
index 428d04f985..c943d129cc 100644
--- a/osu.Game/Overlays/Profile/Sections/Historical/PaginatedMostPlayedBeatmapContainer.cs
+++ b/osu.Game/Overlays/Profile/Sections/Historical/PaginatedMostPlayedBeatmapContainer.cs
@@ -10,13 +10,13 @@ using osu.Game.Online.API;
 using osu.Game.Online.API.Requests;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Resources.Localisation.Web;
-using osu.Game.Users;
+using APIUser = osu.Game.Online.API.Requests.Responses.APIUser;
 
 namespace osu.Game.Overlays.Profile.Sections.Historical
 {
     public class PaginatedMostPlayedBeatmapContainer : PaginatedProfileSubsection<APIUserMostPlayedBeatmap>
     {
-        public PaginatedMostPlayedBeatmapContainer(Bindable<User> user)
+        public PaginatedMostPlayedBeatmapContainer(Bindable<APIUser> user)
             : base(user, UsersStrings.ShowExtraHistoricalMostPlayedTitle)
         {
             ItemsPerPage = 5;
@@ -28,7 +28,7 @@ namespace osu.Game.Overlays.Profile.Sections.Historical
             ItemsContainer.Direction = FillDirection.Vertical;
         }
 
-        protected override int GetCount(User user) => user.BeatmapPlaycountsCount;
+        protected override int GetCount(APIUser user) => user.BeatmapPlaycountsCount;
 
         protected override APIRequest<List<APIUserMostPlayedBeatmap>> CreateRequest() =>
             new GetUserMostPlayedBeatmapsRequest(User.Value.Id, VisiblePages++, ItemsPerPage);
diff --git a/osu.Game/Overlays/Profile/Sections/Historical/PlayHistorySubsection.cs b/osu.Game/Overlays/Profile/Sections/Historical/PlayHistorySubsection.cs
index 83c005970e..bca88318d5 100644
--- a/osu.Game/Overlays/Profile/Sections/Historical/PlayHistorySubsection.cs
+++ b/osu.Game/Overlays/Profile/Sections/Historical/PlayHistorySubsection.cs
@@ -3,9 +3,8 @@
 
 using osu.Framework.Bindables;
 using osu.Framework.Localisation;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Resources.Localisation.Web;
-using osu.Game.Users;
-using static osu.Game.Users.User;
 
 namespace osu.Game.Overlays.Profile.Sections.Historical
 {
@@ -13,11 +12,11 @@ namespace osu.Game.Overlays.Profile.Sections.Historical
     {
         protected override LocalisableString GraphCounterName => UsersStrings.ShowExtraHistoricalMonthlyPlaycountsCountLabel;
 
-        public PlayHistorySubsection(Bindable<User> user)
+        public PlayHistorySubsection(Bindable<APIUser> user)
             : base(user, UsersStrings.ShowExtraHistoricalMonthlyPlaycountsTitle)
         {
         }
 
-        protected override UserHistoryCount[] GetValues(User user) => user?.MonthlyPlaycounts;
+        protected override APIUserHistoryCount[] GetValues(APIUser user) => user?.MonthlyPlaycounts;
     }
 }
diff --git a/osu.Game/Overlays/Profile/Sections/Historical/ProfileLineChart.cs b/osu.Game/Overlays/Profile/Sections/Historical/ProfileLineChart.cs
index d402438376..c049bff7b2 100644
--- a/osu.Game/Overlays/Profile/Sections/Historical/ProfileLineChart.cs
+++ b/osu.Game/Overlays/Profile/Sections/Historical/ProfileLineChart.cs
@@ -14,16 +14,16 @@ using osu.Game.Graphics;
 using osu.Framework.Graphics.Shapes;
 using osuTK;
 using osu.Framework.Localisation;
-using static osu.Game.Users.User;
+using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Overlays.Profile.Sections.Historical
 {
     public class ProfileLineChart : CompositeDrawable
     {
-        private UserHistoryCount[] values;
+        private APIUserHistoryCount[] values;
 
         [NotNull]
-        public UserHistoryCount[] Values
+        public APIUserHistoryCount[] Values
         {
             get => values;
             set
diff --git a/osu.Game/Overlays/Profile/Sections/Historical/ReplaysSubsection.cs b/osu.Game/Overlays/Profile/Sections/Historical/ReplaysSubsection.cs
index 76d5f73bd7..22312afdc9 100644
--- a/osu.Game/Overlays/Profile/Sections/Historical/ReplaysSubsection.cs
+++ b/osu.Game/Overlays/Profile/Sections/Historical/ReplaysSubsection.cs
@@ -3,9 +3,8 @@
 
 using osu.Framework.Bindables;
 using osu.Framework.Localisation;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Resources.Localisation.Web;
-using osu.Game.Users;
-using static osu.Game.Users.User;
 
 namespace osu.Game.Overlays.Profile.Sections.Historical
 {
@@ -13,11 +12,11 @@ namespace osu.Game.Overlays.Profile.Sections.Historical
     {
         protected override LocalisableString GraphCounterName => UsersStrings.ShowExtraHistoricalReplaysWatchedCountsCountLabel;
 
-        public ReplaysSubsection(Bindable<User> user)
+        public ReplaysSubsection(Bindable<APIUser> user)
             : base(user, UsersStrings.ShowExtraHistoricalReplaysWatchedCountsTitle)
         {
         }
 
-        protected override UserHistoryCount[] GetValues(User user) => user?.ReplaysWatchedCounts;
+        protected override APIUserHistoryCount[] GetValues(APIUser user) => user?.ReplaysWatchedCounts;
     }
 }
diff --git a/osu.Game/Overlays/Profile/Sections/Historical/UserHistoryGraph.cs b/osu.Game/Overlays/Profile/Sections/Historical/UserHistoryGraph.cs
index 61f77cd6ff..f80167f9d3 100644
--- a/osu.Game/Overlays/Profile/Sections/Historical/UserHistoryGraph.cs
+++ b/osu.Game/Overlays/Profile/Sections/Historical/UserHistoryGraph.cs
@@ -7,7 +7,7 @@ using System.Linq;
 using JetBrains.Annotations;
 using osu.Framework.Extensions.LocalisationExtensions;
 using osu.Framework.Localisation;
-using static osu.Game.Users.User;
+using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Overlays.Profile.Sections.Historical
 {
@@ -16,7 +16,7 @@ namespace osu.Game.Overlays.Profile.Sections.Historical
         private readonly LocalisableString tooltipCounterName;
 
         [CanBeNull]
-        public UserHistoryCount[] Values
+        public APIUserHistoryCount[] Values
         {
             set => Data = value?.Select(v => new KeyValuePair<DateTime, long>(v.Date, v.Count)).ToArray();
         }
diff --git a/osu.Game/Overlays/Profile/Sections/Kudosu/KudosuInfo.cs b/osu.Game/Overlays/Profile/Sections/Kudosu/KudosuInfo.cs
index 762716efab..79a06ecdd4 100644
--- a/osu.Game/Overlays/Profile/Sections/Kudosu/KudosuInfo.cs
+++ b/osu.Game/Overlays/Profile/Sections/Kudosu/KudosuInfo.cs
@@ -10,19 +10,19 @@ using osu.Framework.Input.Events;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
-using osu.Game.Users;
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.LocalisationExtensions;
 using osu.Game.Resources.Localisation.Web;
 using osu.Framework.Localisation;
+using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Overlays.Profile.Sections.Kudosu
 {
     public class KudosuInfo : Container
     {
-        private readonly Bindable<User> user = new Bindable<User>();
+        private readonly Bindable<APIUser> user = new Bindable<APIUser>();
 
-        public KudosuInfo(Bindable<User> user)
+        public KudosuInfo(Bindable<APIUser> user)
         {
             this.user.BindTo(user);
             CountSection total;
diff --git a/osu.Game/Overlays/Profile/Sections/Kudosu/PaginatedKudosuHistoryContainer.cs b/osu.Game/Overlays/Profile/Sections/Kudosu/PaginatedKudosuHistoryContainer.cs
index 76cd7ed722..c4837cc0e2 100644
--- a/osu.Game/Overlays/Profile/Sections/Kudosu/PaginatedKudosuHistoryContainer.cs
+++ b/osu.Game/Overlays/Profile/Sections/Kudosu/PaginatedKudosuHistoryContainer.cs
@@ -3,18 +3,18 @@
 
 using osu.Framework.Graphics;
 using osu.Game.Online.API.Requests;
-using osu.Game.Users;
 using osu.Framework.Bindables;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.API;
 using System.Collections.Generic;
 using osu.Game.Resources.Localisation.Web;
+using APIUser = osu.Game.Online.API.Requests.Responses.APIUser;
 
 namespace osu.Game.Overlays.Profile.Sections.Kudosu
 {
     public class PaginatedKudosuHistoryContainer : PaginatedProfileSubsection<APIKudosuHistory>
     {
-        public PaginatedKudosuHistoryContainer(Bindable<User> user)
+        public PaginatedKudosuHistoryContainer(Bindable<APIUser> user)
             : base(user, missingText: UsersStrings.ShowExtraKudosuEntryEmpty)
         {
             ItemsPerPage = 5;
diff --git a/osu.Game/Overlays/Profile/Sections/PaginatedProfileSubsection.cs b/osu.Game/Overlays/Profile/Sections/PaginatedProfileSubsection.cs
index d60243cd0a..affe9ecb0c 100644
--- a/osu.Game/Overlays/Profile/Sections/PaginatedProfileSubsection.cs
+++ b/osu.Game/Overlays/Profile/Sections/PaginatedProfileSubsection.cs
@@ -7,7 +7,6 @@ using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Online.API;
-using osu.Game.Users;
 using System.Collections.Generic;
 using System.Linq;
 using System.Threading;
@@ -16,6 +15,7 @@ using osu.Game.Rulesets;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics;
 using osu.Framework.Localisation;
+using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Overlays.Profile.Sections
 {
@@ -39,7 +39,7 @@ namespace osu.Game.Overlays.Profile.Sections
         private OsuSpriteText missing;
         private readonly LocalisableString? missingText;
 
-        protected PaginatedProfileSubsection(Bindable<User> user, LocalisableString? headerText = null, LocalisableString? missingText = null)
+        protected PaginatedProfileSubsection(Bindable<APIUser> user, LocalisableString? headerText = null, LocalisableString? missingText = null)
             : base(user, headerText, CounterVisibilityState.AlwaysVisible)
         {
             this.missingText = missingText;
@@ -81,7 +81,7 @@ namespace osu.Game.Overlays.Profile.Sections
             User.BindValueChanged(onUserChanged, true);
         }
 
-        private void onUserChanged(ValueChangedEvent<User> e)
+        private void onUserChanged(ValueChangedEvent<APIUser> e)
         {
             loadCancellation?.Cancel();
             retrievalRequest?.Cancel();
@@ -131,7 +131,7 @@ namespace osu.Game.Overlays.Profile.Sections
             }, loadCancellation.Token);
         });
 
-        protected virtual int GetCount(User user) => 0;
+        protected virtual int GetCount(APIUser user) => 0;
 
         protected virtual void OnItemsReceived(List<TModel> items)
         {
diff --git a/osu.Game/Overlays/Profile/Sections/ProfileSubsection.cs b/osu.Game/Overlays/Profile/Sections/ProfileSubsection.cs
index 5a17f0d8bb..fdf8cb19ff 100644
--- a/osu.Game/Overlays/Profile/Sections/ProfileSubsection.cs
+++ b/osu.Game/Overlays/Profile/Sections/ProfileSubsection.cs
@@ -5,22 +5,22 @@ using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
-using osu.Game.Users;
 using JetBrains.Annotations;
 using osu.Framework.Localisation;
+using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Overlays.Profile.Sections
 {
     public abstract class ProfileSubsection : FillFlowContainer
     {
-        protected readonly Bindable<User> User = new Bindable<User>();
+        protected readonly Bindable<APIUser> User = new Bindable<APIUser>();
 
         private readonly LocalisableString headerText;
         private readonly CounterVisibilityState counterVisibilityState;
 
         private ProfileSubsectionHeader header;
 
-        protected ProfileSubsection(Bindable<User> user, LocalisableString? headerText = null, CounterVisibilityState counterVisibilityState = CounterVisibilityState.AlwaysHidden)
+        protected ProfileSubsection(Bindable<APIUser> user, LocalisableString? headerText = null, CounterVisibilityState counterVisibilityState = CounterVisibilityState.AlwaysHidden)
         {
             this.headerText = headerText ?? string.Empty;
             this.counterVisibilityState = counterVisibilityState;
diff --git a/osu.Game/Overlays/Profile/Sections/Ranks/PaginatedScoreContainer.cs b/osu.Game/Overlays/Profile/Sections/Ranks/PaginatedScoreContainer.cs
index cde386bc7b..c3f10587a9 100644
--- a/osu.Game/Overlays/Profile/Sections/Ranks/PaginatedScoreContainer.cs
+++ b/osu.Game/Overlays/Profile/Sections/Ranks/PaginatedScoreContainer.cs
@@ -3,7 +3,6 @@
 
 using osu.Framework.Graphics.Containers;
 using osu.Game.Online.API.Requests;
-using osu.Game.Users;
 using System;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
@@ -12,6 +11,7 @@ using System.Collections.Generic;
 using osu.Game.Online.API;
 using osu.Framework.Allocation;
 using osu.Framework.Localisation;
+using APIUser = osu.Game.Online.API.Requests.Responses.APIUser;
 
 namespace osu.Game.Overlays.Profile.Sections.Ranks
 {
@@ -19,7 +19,7 @@ namespace osu.Game.Overlays.Profile.Sections.Ranks
     {
         private readonly ScoreType type;
 
-        public PaginatedScoreContainer(ScoreType type, Bindable<User> user, LocalisableString headerText)
+        public PaginatedScoreContainer(ScoreType type, Bindable<APIUser> user, LocalisableString headerText)
             : base(user, headerText)
         {
             this.type = type;
@@ -33,7 +33,7 @@ namespace osu.Game.Overlays.Profile.Sections.Ranks
             ItemsContainer.Direction = FillDirection.Vertical;
         }
 
-        protected override int GetCount(User user)
+        protected override int GetCount(APIUser user)
         {
             switch (type)
             {
diff --git a/osu.Game/Overlays/Profile/Sections/Recent/PaginatedRecentActivityContainer.cs b/osu.Game/Overlays/Profile/Sections/Recent/PaginatedRecentActivityContainer.cs
index db2e6bc1e0..c5ff896654 100644
--- a/osu.Game/Overlays/Profile/Sections/Recent/PaginatedRecentActivityContainer.cs
+++ b/osu.Game/Overlays/Profile/Sections/Recent/PaginatedRecentActivityContainer.cs
@@ -3,7 +3,6 @@
 
 using osu.Framework.Graphics;
 using osu.Game.Online.API.Requests;
-using osu.Game.Users;
 using osu.Framework.Bindables;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.API;
@@ -11,12 +10,13 @@ using System.Collections.Generic;
 using osuTK;
 using osu.Framework.Allocation;
 using osu.Game.Resources.Localisation.Web;
+using APIUser = osu.Game.Online.API.Requests.Responses.APIUser;
 
 namespace osu.Game.Overlays.Profile.Sections.Recent
 {
     public class PaginatedRecentActivityContainer : PaginatedProfileSubsection<APIRecentActivity>
     {
-        public PaginatedRecentActivityContainer(Bindable<User> user)
+        public PaginatedRecentActivityContainer(Bindable<APIUser> user)
             : base(user, missingText: EventsStrings.Empty)
         {
             ItemsPerPage = 10;
diff --git a/osu.Game/Overlays/Settings/Sections/UserInterface/MainMenuSettings.cs b/osu.Game/Overlays/Settings/Sections/UserInterface/MainMenuSettings.cs
index 40485a070c..284e9cb2de 100644
--- a/osu.Game/Overlays/Settings/Sections/UserInterface/MainMenuSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/UserInterface/MainMenuSettings.cs
@@ -8,7 +8,7 @@ using osu.Framework.Localisation;
 using osu.Game.Configuration;
 using osu.Game.Localisation;
 using osu.Game.Online.API;
-using osu.Game.Users;
+using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Overlays.Settings.Sections.UserInterface
 {
@@ -16,7 +16,7 @@ namespace osu.Game.Overlays.Settings.Sections.UserInterface
     {
         protected override LocalisableString Header => UserInterfaceStrings.MainMenuHeader;
 
-        private IBindable<User> user;
+        private IBindable<APIUser> user;
 
         private SettingsEnumDropdown<BackgroundSource> backgroundSourceDropdown;
 
diff --git a/osu.Game/Overlays/Toolbar/ToolbarUserButton.cs b/osu.Game/Overlays/Toolbar/ToolbarUserButton.cs
index 5d4430caa2..b0c9a04285 100644
--- a/osu.Game/Overlays/Toolbar/ToolbarUserButton.cs
+++ b/osu.Game/Overlays/Toolbar/ToolbarUserButton.cs
@@ -8,7 +8,7 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Effects;
 using osu.Game.Graphics;
 using osu.Game.Online.API;
-using osu.Game.Users;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Users.Drawables;
 using osuTK;
 using osuTK.Graphics;
@@ -63,7 +63,7 @@ namespace osu.Game.Overlays.Toolbar
             {
                 default:
                     Text = @"Guest";
-                    avatar.User = new User();
+                    avatar.User = new APIUser();
                     break;
 
                 case APIState.Online:
diff --git a/osu.Game/Overlays/UserProfileOverlay.cs b/osu.Game/Overlays/UserProfileOverlay.cs
index b0327987f2..d9b4e68a75 100644
--- a/osu.Game/Overlays/UserProfileOverlay.cs
+++ b/osu.Game/Overlays/UserProfileOverlay.cs
@@ -11,9 +11,9 @@ using osu.Framework.Graphics.UserInterface;
 using osu.Framework.Input.Events;
 using osu.Game.Graphics.Containers;
 using osu.Game.Online.API.Requests;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays.Profile;
 using osu.Game.Overlays.Profile.Sections;
-using osu.Game.Users;
 using osuTK;
 using osuTK.Graphics;
 
@@ -38,13 +38,13 @@ namespace osu.Game.Overlays
 
         protected override Color4 BackgroundColour => ColourProvider.Background6;
 
-        public void ShowUser(int userId) => ShowUser(new User { Id = userId });
+        public void ShowUser(int userId) => ShowUser(new APIUser { Id = userId });
 
-        public void ShowUser(string username) => ShowUser(new User { Username = username });
+        public void ShowUser(string username) => ShowUser(new APIUser { Username = username });
 
-        public void ShowUser(User user, bool fetchOnline = true)
+        public void ShowUser(APIUser user, bool fetchOnline = true)
         {
-            if (user == User.SYSTEM_USER)
+            if (user == APIUser.SYSTEM_USER)
                 return;
 
             Show();
@@ -131,7 +131,7 @@ namespace osu.Game.Overlays
             sectionsContainer.ScrollToTop();
         }
 
-        private void userLoadComplete(User user)
+        private void userLoadComplete(APIUser user)
         {
             Header.User.Value = user;
 
diff --git a/osu.Game/Scoring/IScoreInfo.cs b/osu.Game/Scoring/IScoreInfo.cs
index 77579f23d9..21a402f8c3 100644
--- a/osu.Game/Scoring/IScoreInfo.cs
+++ b/osu.Game/Scoring/IScoreInfo.cs
@@ -4,14 +4,14 @@
 using System;
 using osu.Game.Beatmaps;
 using osu.Game.Database;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets;
-using osu.Game.Users;
 
 namespace osu.Game.Scoring
 {
     public interface IScoreInfo : IHasOnlineID<long>
     {
-        User User { get; }
+        APIUser User { get; }
 
         long TotalScore { get; }
 
diff --git a/osu.Game/Scoring/Legacy/LegacyScoreDecoder.cs b/osu.Game/Scoring/Legacy/LegacyScoreDecoder.cs
index 379718195c..7bfe0308f7 100644
--- a/osu.Game/Scoring/Legacy/LegacyScoreDecoder.cs
+++ b/osu.Game/Scoring/Legacy/LegacyScoreDecoder.cs
@@ -8,12 +8,12 @@ using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.Formats;
 using osu.Game.Beatmaps.Legacy;
 using osu.Game.IO.Legacy;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Replays;
 using osu.Game.Replays.Legacy;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Replays;
-using osu.Game.Users;
 using SharpCompress.Compressors.LZMA;
 
 namespace osu.Game.Scoring.Legacy
@@ -45,7 +45,7 @@ namespace osu.Game.Scoring.Legacy
                 if (workingBeatmap is DummyWorkingBeatmap)
                     throw new BeatmapNotFoundException();
 
-                scoreInfo.User = new User { Username = sr.ReadString() };
+                scoreInfo.User = new APIUser { Username = sr.ReadString() };
 
                 // MD5Hash
                 sr.ReadString();
diff --git a/osu.Game/Scoring/ScoreInfo.cs b/osu.Game/Scoring/ScoreInfo.cs
index 36608e2a74..e5b050fc01 100644
--- a/osu.Game/Scoring/ScoreInfo.cs
+++ b/osu.Game/Scoring/ScoreInfo.cs
@@ -10,10 +10,10 @@ using osu.Framework.Localisation;
 using osu.Game.Beatmaps;
 using osu.Game.Database;
 using osu.Game.Online.API;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Scoring;
-using osu.Game.Users;
 using osu.Game.Utils;
 
 namespace osu.Game.Scoring
@@ -105,7 +105,7 @@ namespace osu.Game.Scoring
         }
 
         [NotMapped]
-        public User User { get; set; }
+        public APIUser User { get; set; }
 
         [Column("User")]
         public string UserString
@@ -113,7 +113,7 @@ namespace osu.Game.Scoring
             get => User?.Username;
             set
             {
-                User ??= new User();
+                User ??= new APIUser();
                 User.Username = value;
             }
         }
@@ -124,7 +124,7 @@ namespace osu.Game.Scoring
             get => User?.Id ?? 1;
             set
             {
-                User ??= new User();
+                User ??= new APIUser();
                 User.Id = value ?? 1;
             }
         }
diff --git a/osu.Game/Screens/Backgrounds/BackgroundScreenDefault.cs b/osu.Game/Screens/Backgrounds/BackgroundScreenDefault.cs
index f0c90cc409..4a922c45b9 100644
--- a/osu.Game/Screens/Backgrounds/BackgroundScreenDefault.cs
+++ b/osu.Game/Screens/Backgrounds/BackgroundScreenDefault.cs
@@ -11,8 +11,8 @@ using osu.Game.Beatmaps;
 using osu.Game.Configuration;
 using osu.Game.Graphics.Backgrounds;
 using osu.Game.Online.API;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Skinning;
-using osu.Game.Users;
 
 namespace osu.Game.Screens.Backgrounds
 {
@@ -22,7 +22,7 @@ namespace osu.Game.Screens.Backgrounds
 
         private int currentDisplay;
         private const int background_count = 7;
-        private IBindable<User> user;
+        private IBindable<APIUser> user;
         private Bindable<Skin> skin;
         private Bindable<BackgroundSource> mode;
         private Bindable<IntroSequence> introSequence;
diff --git a/osu.Game/Screens/Menu/Disclaimer.cs b/osu.Game/Screens/Menu/Disclaimer.cs
index b8abc131fd..22151db0dd 100644
--- a/osu.Game/Screens/Menu/Disclaimer.cs
+++ b/osu.Game/Screens/Menu/Disclaimer.cs
@@ -14,9 +14,9 @@ using osu.Framework.Utils;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Online.API;
+using osu.Game.Online.API.Requests.Responses;
 using osuTK;
 using osuTK.Graphics;
-using osu.Game.Users;
 
 namespace osu.Game.Screens.Menu
 {
@@ -34,7 +34,7 @@ namespace osu.Game.Screens.Menu
 
         private readonly OsuScreen nextScreen;
 
-        private readonly Bindable<User> currentUser = new Bindable<User>();
+        private readonly Bindable<APIUser> currentUser = new Bindable<APIUser>();
         private FillFlowContainer fill;
 
         private readonly List<ITextPart> expendableText = new List<ITextPart>();
@@ -168,7 +168,7 @@ namespace osu.Game.Screens.Menu
             if (nextScreen != null)
                 LoadComponentAsync(nextScreen);
 
-            ((IBindable<User>)currentUser).BindTo(api.LocalUser);
+            ((IBindable<APIUser>)currentUser).BindTo(api.LocalUser);
         }
 
         public override void OnEntering(IScreen last)
diff --git a/osu.Game/Screens/Menu/MenuLogoVisualisation.cs b/osu.Game/Screens/Menu/MenuLogoVisualisation.cs
index c44beeffa5..f461136022 100644
--- a/osu.Game/Screens/Menu/MenuLogoVisualisation.cs
+++ b/osu.Game/Screens/Menu/MenuLogoVisualisation.cs
@@ -4,15 +4,15 @@
 using osuTK.Graphics;
 using osu.Game.Skinning;
 using osu.Game.Online.API;
-using osu.Game.Users;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
+using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Screens.Menu
 {
     internal class MenuLogoVisualisation : LogoVisualisation
     {
-        private IBindable<User> user;
+        private IBindable<APIUser> user;
         private Bindable<Skin> skin;
 
         [BackgroundDependencyLoader]
diff --git a/osu.Game/Screens/Menu/MenuSideFlashes.cs b/osu.Game/Screens/Menu/MenuSideFlashes.cs
index a1ae4555ed..bdcd3020f8 100644
--- a/osu.Game/Screens/Menu/MenuSideFlashes.cs
+++ b/osu.Game/Screens/Menu/MenuSideFlashes.cs
@@ -13,10 +13,10 @@ using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Skinning;
 using osu.Game.Online.API;
-using osu.Game.Users;
 using System;
 using osu.Framework.Audio.Track;
 using osu.Framework.Bindables;
+using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Screens.Menu
 {
@@ -35,7 +35,7 @@ namespace osu.Game.Screens.Menu
         private const double box_fade_in_time = 65;
         private const int box_width = 200;
 
-        private IBindable<User> user;
+        private IBindable<APIUser> user;
         private Bindable<Skin> skin;
 
         [Resolved]
diff --git a/osu.Game/Screens/OnlinePlay/Components/ParticipantsList.cs b/osu.Game/Screens/OnlinePlay/Components/ParticipantsList.cs
index e531ddb0ec..1d5552fa7d 100644
--- a/osu.Game/Screens/OnlinePlay/Components/ParticipantsList.cs
+++ b/osu.Game/Screens/OnlinePlay/Components/ParticipantsList.cs
@@ -7,7 +7,7 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Threading;
-using osu.Game.Users;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Users.Drawables;
 using osuTK;
 
@@ -92,7 +92,7 @@ namespace osu.Game.Screens.OnlinePlay.Components
 
         private class UserTile : CompositeDrawable
         {
-            public User User
+            public APIUser User
             {
                 get => avatar.User;
                 set => avatar.User = value;
diff --git a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
index 0681ac23ad..c22b9bd9aa 100644
--- a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
+++ b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
@@ -20,6 +20,7 @@ using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Online;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Chat;
 using osu.Game.Online.Rooms;
 using osu.Game.Overlays.BeatmapListing.Panels;
@@ -27,7 +28,6 @@ using osu.Game.Overlays.BeatmapSet;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Screens.Play.HUD;
-using osu.Game.Users;
 using osuTK;
 using osuTK.Graphics;
 
@@ -122,7 +122,7 @@ namespace osu.Game.Screens.OnlinePlay
             if (!string.IsNullOrEmpty(Item.Beatmap.Value?.Metadata.Author))
             {
                 authorText.AddText("mapped by ");
-                authorText.AddUserLink(new User { Username = Item.Beatmap.Value.Metadata.Author });
+                authorText.AddUserLink(new APIUser { Username = Item.Beatmap.Value.Metadata.Author });
             }
 
             bool hasExplicitContent = (Item.Beatmap.Value.BeatmapSet as IBeatmapSetOnlineInfo)?.HasExplicitContent == true;
diff --git a/osu.Game/Screens/OnlinePlay/Lounge/Components/DrawableRoomParticipantsList.cs b/osu.Game/Screens/OnlinePlay/Lounge/Components/DrawableRoomParticipantsList.cs
index 31eb5db9bc..10bd534b89 100644
--- a/osu.Game/Screens/OnlinePlay/Lounge/Components/DrawableRoomParticipantsList.cs
+++ b/osu.Game/Screens/OnlinePlay/Lounge/Components/DrawableRoomParticipantsList.cs
@@ -12,8 +12,8 @@ using osu.Framework.Graphics.Sprites;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays;
-using osu.Game.Users;
 using osu.Game.Users.Drawables;
 using osuTK;
 
@@ -195,12 +195,12 @@ namespace osu.Game.Screens.OnlinePlay.Lounge.Components
             switch (e.Action)
             {
                 case NotifyCollectionChangedAction.Add:
-                    foreach (var added in e.NewItems.OfType<User>())
+                    foreach (var added in e.NewItems.OfType<APIUser>())
                         addUser(added);
                     break;
 
                 case NotifyCollectionChangedAction.Remove:
-                    foreach (var removed in e.OldItems.OfType<User>())
+                    foreach (var removed in e.OldItems.OfType<APIUser>())
                         removeUser(removed);
                     break;
 
@@ -222,13 +222,13 @@ namespace osu.Game.Screens.OnlinePlay.Lounge.Components
 
         private int displayedCircles => avatarFlow.Count + (hiddenUsers.Count > 0 ? 1 : 0);
 
-        private void addUser(User user)
+        private void addUser(APIUser user)
         {
             if (displayedCircles < NumberOfCircles)
                 avatarFlow.Add(new CircularAvatar { User = user });
         }
 
-        private void removeUser(User user)
+        private void removeUser(APIUser user)
         {
             avatarFlow.RemoveAll(a => a.User == user);
         }
@@ -256,7 +256,7 @@ namespace osu.Game.Screens.OnlinePlay.Lounge.Components
             }
         }
 
-        private void onHostChanged(ValueChangedEvent<User> host)
+        private void onHostChanged(ValueChangedEvent<APIUser> host)
         {
             hostAvatar.User = host.NewValue;
             hostText.Clear();
@@ -270,7 +270,7 @@ namespace osu.Game.Screens.OnlinePlay.Lounge.Components
 
         private class CircularAvatar : CompositeDrawable
         {
-            public User User
+            public APIUser User
             {
                 get => avatar.User;
                 set => avatar.User = value;
diff --git a/osu.Game/Screens/OnlinePlay/Match/DrawableMatchRoom.cs b/osu.Game/Screens/OnlinePlay/Match/DrawableMatchRoom.cs
index e83403850f..a7b907c7d2 100644
--- a/osu.Game/Screens/OnlinePlay/Match/DrawableMatchRoom.cs
+++ b/osu.Game/Screens/OnlinePlay/Match/DrawableMatchRoom.cs
@@ -8,10 +8,10 @@ using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Game.Beatmaps.Drawables;
 using osu.Game.Online.API;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Rooms;
 using osu.Game.Screens.OnlinePlay.Lounge.Components;
 using osu.Game.Screens.OnlinePlay.Match.Components;
-using osu.Game.Users;
 using osuTK;
 
 namespace osu.Game.Screens.OnlinePlay.Match
@@ -24,7 +24,7 @@ namespace osu.Game.Screens.OnlinePlay.Match
         [Resolved]
         private IAPIProvider api { get; set; }
 
-        private readonly IBindable<User> host = new Bindable<User>();
+        private readonly IBindable<APIUser> host = new Bindable<APIUser>();
         private readonly bool allowEdit;
 
         [CanBeNull]
diff --git a/osu.Game/Screens/OnlinePlay/OnlinePlayComposite.cs b/osu.Game/Screens/OnlinePlay/OnlinePlayComposite.cs
index aa971864ef..cf274a3a21 100644
--- a/osu.Game/Screens/OnlinePlay/OnlinePlayComposite.cs
+++ b/osu.Game/Screens/OnlinePlay/OnlinePlayComposite.cs
@@ -6,9 +6,9 @@ using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics.Containers;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Rooms;
 using osu.Game.Screens.OnlinePlay.Match;
-using osu.Game.Users;
 
 namespace osu.Game.Screens.OnlinePlay
 {
@@ -24,7 +24,7 @@ namespace osu.Game.Screens.OnlinePlay
         protected Bindable<string> RoomName { get; private set; }
 
         [Resolved(typeof(Room))]
-        protected Bindable<User> Host { get; private set; }
+        protected Bindable<APIUser> Host { get; private set; }
 
         [Resolved(typeof(Room))]
         protected Bindable<RoomStatus> Status { get; private set; }
@@ -39,7 +39,7 @@ namespace osu.Game.Screens.OnlinePlay
         protected Bindable<RoomCategory> Category { get; private set; }
 
         [Resolved(typeof(Room))]
-        protected BindableList<User> RecentParticipants { get; private set; }
+        protected BindableList<APIUser> RecentParticipants { get; private set; }
 
         [Resolved(typeof(Room))]
         protected Bindable<int> ParticipantCount { get; private set; }
diff --git a/osu.Game/Screens/Play/HUD/GameplayLeaderboard.cs b/osu.Game/Screens/Play/HUD/GameplayLeaderboard.cs
index 871555e5a3..638b2c395f 100644
--- a/osu.Game/Screens/Play/HUD/GameplayLeaderboard.cs
+++ b/osu.Game/Screens/Play/HUD/GameplayLeaderboard.cs
@@ -11,7 +11,7 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Colour;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Graphics.Containers;
-using osu.Game.Users;
+using osu.Game.Online.API.Requests.Responses;
 using osuTK;
 using osuTK.Graphics;
 
@@ -75,7 +75,7 @@ namespace osu.Game.Screens.Play.HUD
         /// Whether the player should be tracked on the leaderboard.
         /// Set to <c>true</c> for the local player or a player whose replay is currently being played.
         /// </param>
-        public ILeaderboardScore Add([CanBeNull] User user, bool isTracked)
+        public ILeaderboardScore Add([CanBeNull] APIUser user, bool isTracked)
         {
             var drawable = CreateLeaderboardScoreDrawable(user, isTracked);
 
@@ -106,7 +106,7 @@ namespace osu.Game.Screens.Play.HUD
             scroll.ScrollToStart(false);
         }
 
-        protected virtual GameplayLeaderboardScore CreateLeaderboardScoreDrawable(User user, bool isTracked) =>
+        protected virtual GameplayLeaderboardScore CreateLeaderboardScoreDrawable(APIUser user, bool isTracked) =>
             new GameplayLeaderboardScore(user, isTracked);
 
         protected override void Update()
diff --git a/osu.Game/Screens/Play/HUD/GameplayLeaderboardScore.cs b/osu.Game/Screens/Play/HUD/GameplayLeaderboardScore.cs
index 85cf9d1966..773ee4a036 100644
--- a/osu.Game/Screens/Play/HUD/GameplayLeaderboardScore.cs
+++ b/osu.Game/Screens/Play/HUD/GameplayLeaderboardScore.cs
@@ -10,7 +10,7 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
-using osu.Game.Users;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Users.Drawables;
 using osu.Game.Utils;
 using osuTK;
@@ -79,7 +79,7 @@ namespace osu.Game.Screens.Play.HUD
         }
 
         [CanBeNull]
-        public User User { get; }
+        public APIUser User { get; }
 
         /// <summary>
         /// Whether this score is the local user or a replay player (and should be focused / always visible).
@@ -101,7 +101,7 @@ namespace osu.Game.Screens.Play.HUD
         /// </summary>
         /// <param name="user">The score's player.</param>
         /// <param name="tracked">Whether the player is the local user or a replay player.</param>
-        public GameplayLeaderboardScore([CanBeNull] User user, bool tracked)
+        public GameplayLeaderboardScore([CanBeNull] APIUser user, bool tracked)
         {
             User = user;
             Tracked = tracked;
diff --git a/osu.Game/Screens/Play/HUD/MultiplayerGameplayLeaderboard.cs b/osu.Game/Screens/Play/HUD/MultiplayerGameplayLeaderboard.cs
index 7caf90f610..e019ee9a3d 100644
--- a/osu.Game/Screens/Play/HUD/MultiplayerGameplayLeaderboard.cs
+++ b/osu.Game/Screens/Play/HUD/MultiplayerGameplayLeaderboard.cs
@@ -12,11 +12,11 @@ using osu.Game.Configuration;
 using osu.Game.Database;
 using osu.Game.Graphics;
 using osu.Game.Online.API;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Multiplayer.MatchTypes.TeamVersus;
 using osu.Game.Online.Spectator;
 using osu.Game.Rulesets.Scoring;
-using osu.Game.Users;
 using osuTK.Graphics;
 
 namespace osu.Game.Screens.Play.HUD
@@ -118,7 +118,7 @@ namespace osu.Game.Screens.Play.HUD
 
         protected virtual TrackedUserData CreateUserData(MultiplayerRoomUser user, ScoreProcessor scoreProcessor) => new TrackedUserData(user, scoreProcessor);
 
-        protected override GameplayLeaderboardScore CreateLeaderboardScoreDrawable(User user, bool isTracked)
+        protected override GameplayLeaderboardScore CreateLeaderboardScoreDrawable(APIUser user, bool isTracked)
         {
             var leaderboardScore = base.CreateLeaderboardScoreDrawable(user, isTracked);
 
diff --git a/osu.Game/Screens/Play/SoloSpectator.cs b/osu.Game/Screens/Play/SoloSpectator.cs
index 250738df39..1dcc191c0f 100644
--- a/osu.Game/Screens/Play/SoloSpectator.cs
+++ b/osu.Game/Screens/Play/SoloSpectator.cs
@@ -27,6 +27,7 @@ using osu.Game.Screens.OnlinePlay.Match.Components;
 using osu.Game.Screens.Spectate;
 using osu.Game.Users;
 using osuTK;
+using APIUser = osu.Game.Online.API.Requests.Responses.APIUser;
 
 namespace osu.Game.Screens.Play
 {
@@ -34,7 +35,7 @@ namespace osu.Game.Screens.Play
     public class SoloSpectator : SpectatorScreen, IPreviewTrackOwner
     {
         [NotNull]
-        private readonly User targetUser;
+        private readonly APIUser targetUser;
 
         [Resolved]
         private IAPIProvider api { get; set; }
@@ -62,7 +63,7 @@ namespace osu.Game.Screens.Play
 
         private APIBeatmapSet beatmapSet;
 
-        public SoloSpectator([NotNull] User targetUser)
+        public SoloSpectator([NotNull] APIUser targetUser)
             : base(targetUser.Id)
         {
             this.targetUser = targetUser;
diff --git a/osu.Game/Screens/Ranking/Expanded/ExpandedPanelTopContent.cs b/osu.Game/Screens/Ranking/Expanded/ExpandedPanelTopContent.cs
index 5dfc43cc29..bf06bc2227 100644
--- a/osu.Game/Screens/Ranking/Expanded/ExpandedPanelTopContent.cs
+++ b/osu.Game/Screens/Ranking/Expanded/ExpandedPanelTopContent.cs
@@ -6,7 +6,7 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
-using osu.Game.Users;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Users.Drawables;
 using osuTK;
 
@@ -17,13 +17,13 @@ namespace osu.Game.Screens.Ranking.Expanded
     /// </summary>
     public class ExpandedPanelTopContent : CompositeDrawable
     {
-        private readonly User user;
+        private readonly APIUser user;
 
         /// <summary>
         /// Creates a new <see cref="ExpandedPanelTopContent"/>.
         /// </summary>
-        /// <param name="user">The <see cref="User"/> to display.</param>
-        public ExpandedPanelTopContent(User user)
+        /// <param name="user">The <see cref="APIUser"/> to display.</param>
+        public ExpandedPanelTopContent(APIUser user)
         {
             this.user = user;
             Anchor = Anchor.TopCentre;
diff --git a/osu.Game/Screens/Spectate/SpectatorScreen.cs b/osu.Game/Screens/Spectate/SpectatorScreen.cs
index c8df01dae6..1c0483fa42 100644
--- a/osu.Game/Screens/Spectate/SpectatorScreen.cs
+++ b/osu.Game/Screens/Spectate/SpectatorScreen.cs
@@ -11,11 +11,11 @@ using osu.Framework.Bindables;
 using osu.Framework.Extensions.ObjectExtensions;
 using osu.Game.Beatmaps;
 using osu.Game.Database;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Spectator;
 using osu.Game.Replays;
 using osu.Game.Rulesets;
 using osu.Game.Scoring;
-using osu.Game.Users;
 
 namespace osu.Game.Screens.Spectate
 {
@@ -42,7 +42,7 @@ namespace osu.Game.Screens.Spectate
 
         private readonly IBindableDictionary<int, SpectatorState> playingUserStates = new BindableDictionary<int, SpectatorState>();
 
-        private readonly Dictionary<int, User> userMap = new Dictionary<int, User>();
+        private readonly Dictionary<int, APIUser> userMap = new Dictionary<int, APIUser>();
         private readonly Dictionary<int, SpectatorGameplayState> gameplayStates = new Dictionary<int, SpectatorGameplayState>();
 
         private IBindable<WeakReference<BeatmapSetInfo>> managerUpdated;
diff --git a/osu.Game/Tests/Beatmaps/HitObjectSampleTest.cs b/osu.Game/Tests/Beatmaps/HitObjectSampleTest.cs
index bb5dd09e16..b87c3d57c2 100644
--- a/osu.Game/Tests/Beatmaps/HitObjectSampleTest.cs
+++ b/osu.Game/Tests/Beatmaps/HitObjectSampleTest.cs
@@ -15,13 +15,13 @@ using osu.Framework.Timing;
 using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.Formats;
 using osu.Game.IO;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Objects;
 using osu.Game.Screens.Ranking;
 using osu.Game.Skinning;
 using osu.Game.Storyboards;
 using osu.Game.Tests.Visual;
-using osu.Game.Users;
 
 namespace osu.Game.Tests.Beatmaps
 {
@@ -41,7 +41,7 @@ namespace osu.Game.Tests.Beatmaps
             BeatmapSet = new BeatmapSetInfo(),
             Metadata = new BeatmapMetadata
             {
-                Author = User.SYSTEM_USER
+                Author = APIUser.SYSTEM_USER
             }
         };
 
diff --git a/osu.Game/Tests/TestScoreInfo.cs b/osu.Game/Tests/TestScoreInfo.cs
index 719d31b092..a53cb0ae78 100644
--- a/osu.Game/Tests/TestScoreInfo.cs
+++ b/osu.Game/Tests/TestScoreInfo.cs
@@ -3,12 +3,12 @@
 
 using System;
 using System.Linq;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Scoring;
 using osu.Game.Scoring;
 using osu.Game.Tests.Beatmaps;
-using osu.Game.Users;
 
 namespace osu.Game.Tests
 {
@@ -16,7 +16,7 @@ namespace osu.Game.Tests
     {
         public TestScoreInfo(RulesetInfo ruleset, bool excessMods = false)
         {
-            User = new User
+            User = new APIUser
             {
                 Id = 2,
                 Username = "peppy",
diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
index 70d907ba15..0860e45346 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
@@ -18,7 +18,7 @@ using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Multiplayer.MatchTypes.TeamVersus;
 using osu.Game.Online.Rooms;
 using osu.Game.Rulesets.Mods;
-using osu.Game.Users;
+using APIUser = osu.Game.Online.API.Requests.Responses.APIUser;
 
 namespace osu.Game.Tests.Visual.Multiplayer
 {
@@ -51,7 +51,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
         public void Disconnect() => isConnected.Value = false;
 
-        public MultiplayerRoomUser AddUser(User user, bool markAsPlaying = false)
+        public MultiplayerRoomUser AddUser(APIUser user, bool markAsPlaying = false)
         {
             var roomUser = new MultiplayerRoomUser(user.Id) { User = user };
 
@@ -73,7 +73,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             Scheduler.Update();
         }
 
-        public void RemoveUser(User user)
+        public void RemoveUser(APIUser user)
         {
             Debug.Assert(Room != null);
             ((IMultiplayerClient)this).UserLeft(new MultiplayerRoomUser(user.Id));
diff --git a/osu.Game/Tests/Visual/OnlinePlay/TestRoomManager.cs b/osu.Game/Tests/Visual/OnlinePlay/TestRoomManager.cs
index 5fe3dc8406..4cbc6174c9 100644
--- a/osu.Game/Tests/Visual/OnlinePlay/TestRoomManager.cs
+++ b/osu.Game/Tests/Visual/OnlinePlay/TestRoomManager.cs
@@ -3,10 +3,10 @@
 
 using System;
 using osu.Game.Beatmaps;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Rooms;
 using osu.Game.Rulesets;
 using osu.Game.Screens.OnlinePlay.Components;
-using osu.Game.Users;
 
 namespace osu.Game.Tests.Visual.OnlinePlay
 {
@@ -33,7 +33,7 @@ namespace osu.Game.Tests.Visual.OnlinePlay
                 {
                     RoomID = { Value = -currentRoomId },
                     Name = { Value = $@"Room {currentRoomId}" },
-                    Host = { Value = new User { Username = @"Host" } },
+                    Host = { Value = new APIUser { Username = @"Host" } },
                     EndDate = { Value = DateTimeOffset.Now + TimeSpan.FromSeconds(10) },
                     Category = { Value = i % 2 == 0 ? RoomCategory.Spotlight : RoomCategory.Normal },
                 };
diff --git a/osu.Game/Tests/Visual/OnlinePlay/TestRoomRequestsHandler.cs b/osu.Game/Tests/Visual/OnlinePlay/TestRoomRequestsHandler.cs
index 7f975c9985..dc12e48297 100644
--- a/osu.Game/Tests/Visual/OnlinePlay/TestRoomRequestsHandler.cs
+++ b/osu.Game/Tests/Visual/OnlinePlay/TestRoomRequestsHandler.cs
@@ -7,11 +7,11 @@ using System.Linq;
 using osu.Framework.Allocation;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Rooms;
 using osu.Game.Rulesets.Scoring;
 using osu.Game.Scoring;
 using osu.Game.Screens.OnlinePlay.Components;
-using osu.Game.Users;
 
 namespace osu.Game.Tests.Visual.OnlinePlay
 {
@@ -37,7 +37,7 @@ namespace osu.Game.Tests.Visual.OnlinePlay
         /// <param name="localUser">The local user to store in responses where required.</param>
         /// <param name="game">The game base for cases where actual online requests need to be sent.</param>
         /// <returns>Whether the request was successfully handled.</returns>
-        public bool HandleRequest(APIRequest request, User localUser, OsuGameBase game)
+        public bool HandleRequest(APIRequest request, APIUser localUser, OsuGameBase game)
         {
             switch (request)
             {
diff --git a/osu.Game/Tests/Visual/TestUserLookupCache.cs b/osu.Game/Tests/Visual/TestUserLookupCache.cs
index fcb9c070ff..ce1bbd5f15 100644
--- a/osu.Game/Tests/Visual/TestUserLookupCache.cs
+++ b/osu.Game/Tests/Visual/TestUserLookupCache.cs
@@ -4,24 +4,24 @@
 using System.Threading;
 using System.Threading.Tasks;
 using osu.Game.Database;
-using osu.Game.Users;
+using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Tests.Visual
 {
     public class TestUserLookupCache : UserLookupCache
     {
         /// <summary>
-        /// A special user ID which <see cref="ComputeValueAsync"/> would return a <see langword="null"/> <see cref="User"/> for.
+        /// A special user ID which <see cref="ComputeValueAsync"/> would return a <see langword="null"/> <see cref="APIUser"/> for.
         /// As a simulation to what a regular <see cref="UserLookupCache"/> would return in the case of failing to fetch the user.
         /// </summary>
         public const int UNRESOLVED_USER_ID = -1;
 
-        protected override Task<User> ComputeValueAsync(int lookup, CancellationToken token = default)
+        protected override Task<APIUser> ComputeValueAsync(int lookup, CancellationToken token = default)
         {
             if (lookup == UNRESOLVED_USER_ID)
-                return Task.FromResult((User)null);
+                return Task.FromResult((APIUser)null);
 
-            return Task.FromResult(new User
+            return Task.FromResult(new APIUser
             {
                 Id = lookup,
                 Username = $"User {lookup}"
diff --git a/osu.Game/Users/Drawables/ClickableAvatar.cs b/osu.Game/Users/Drawables/ClickableAvatar.cs
index c8af8d80e4..6883cc0e62 100644
--- a/osu.Game/Users/Drawables/ClickableAvatar.cs
+++ b/osu.Game/Users/Drawables/ClickableAvatar.cs
@@ -9,6 +9,7 @@ using osu.Framework.Input.Events;
 using osu.Framework.Localisation;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.UserInterface;
+using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Users.Drawables
 {
@@ -33,7 +34,7 @@ namespace osu.Game.Users.Drawables
             set => clickableArea.TooltipText = value ? (user?.Username ?? string.Empty) : default_tooltip_text;
         }
 
-        private readonly User user;
+        private readonly APIUser user;
 
         [Resolved(CanBeNull = true)]
         private OsuGame game { get; set; }
@@ -45,7 +46,7 @@ namespace osu.Game.Users.Drawables
         /// If <see cref="OpenOnClick"/> is <c>true</c>, clicking will open the user's profile.
         /// </summary>
         /// <param name="user">The user. A null value will get a placeholder avatar.</param>
-        public ClickableAvatar(User user = null)
+        public ClickableAvatar(APIUser user = null)
         {
             this.user = user;
 
diff --git a/osu.Game/Users/Drawables/DrawableAvatar.cs b/osu.Game/Users/Drawables/DrawableAvatar.cs
index 87860bd149..e6d7bb692d 100644
--- a/osu.Game/Users/Drawables/DrawableAvatar.cs
+++ b/osu.Game/Users/Drawables/DrawableAvatar.cs
@@ -5,19 +5,20 @@ using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Graphics.Textures;
+using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Users.Drawables
 {
     [LongRunningLoad]
     public class DrawableAvatar : Sprite
     {
-        private readonly User user;
+        private readonly APIUser user;
 
         /// <summary>
         /// A simple, non-interactable avatar sprite for the specified user.
         /// </summary>
         /// <param name="user">The user. A null value will get a placeholder avatar.</param>
-        public DrawableAvatar(User user = null)
+        public DrawableAvatar(APIUser user = null)
         {
             this.user = user;
 
diff --git a/osu.Game/Users/Drawables/UpdateableAvatar.cs b/osu.Game/Users/Drawables/UpdateableAvatar.cs
index 6d48104131..8ce6ce3460 100644
--- a/osu.Game/Users/Drawables/UpdateableAvatar.cs
+++ b/osu.Game/Users/Drawables/UpdateableAvatar.cs
@@ -4,15 +4,16 @@
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Effects;
+using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Users.Drawables
 {
     /// <summary>
     /// An avatar which can update to a new user when needed.
     /// </summary>
-    public class UpdateableAvatar : ModelBackedDrawable<User>
+    public class UpdateableAvatar : ModelBackedDrawable<APIUser>
     {
-        public User User
+        public APIUser User
         {
             get => Model;
             set => Model = value;
@@ -55,7 +56,7 @@ namespace osu.Game.Users.Drawables
         /// <param name="isInteractive">If set to true, hover/click sounds will play and clicking the avatar will open the user's profile.</param>
         /// <param name="showUsernameTooltip">Whether to show the username rather than "view profile" on the tooltip. (note: this only applies if <paramref name="isInteractive"/> is also true)</param>
         /// <param name="showGuestOnNull">Whether to show a default guest representation on null user (as opposed to nothing).</param>
-        public UpdateableAvatar(User user = null, bool isInteractive = true, bool showUsernameTooltip = false, bool showGuestOnNull = true)
+        public UpdateableAvatar(APIUser user = null, bool isInteractive = true, bool showUsernameTooltip = false, bool showGuestOnNull = true)
         {
             this.isInteractive = isInteractive;
             this.showUsernameTooltip = showUsernameTooltip;
@@ -64,7 +65,7 @@ namespace osu.Game.Users.Drawables
             User = user;
         }
 
-        protected override Drawable CreateDrawable(User user)
+        protected override Drawable CreateDrawable(APIUser user)
         {
             if (user == null && !showGuestOnNull)
                 return null;
diff --git a/osu.Game/Users/ExtendedUserPanel.cs b/osu.Game/Users/ExtendedUserPanel.cs
index 24317e6069..fc5e1eca5f 100644
--- a/osu.Game/Users/ExtendedUserPanel.cs
+++ b/osu.Game/Users/ExtendedUserPanel.cs
@@ -11,6 +11,7 @@ using osu.Game.Graphics.Sprites;
 using osu.Framework.Graphics.Sprites;
 using osu.Game.Users.Drawables;
 using osu.Framework.Input.Events;
+using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Users
 {
@@ -25,7 +26,7 @@ namespace osu.Game.Users
         private SpriteIcon statusIcon;
         private OsuSpriteText statusMessage;
 
-        protected ExtendedUserPanel(User user)
+        protected ExtendedUserPanel(APIUser user)
             : base(user)
         {
         }
diff --git a/osu.Game/Users/IUser.cs b/osu.Game/Users/IUser.cs
new file mode 100644
index 0000000000..34a59fa214
--- /dev/null
+++ b/osu.Game/Users/IUser.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 osu.Game.Database;
+
+namespace osu.Game.Users
+{
+    public interface IUser : IHasOnlineID<int>
+    {
+        string Username { get; set; }
+    }
+}
diff --git a/osu.Game/Users/User.cs b/osu.Game/Users/User.cs
deleted file mode 100644
index 4ee7d20734..0000000000
--- a/osu.Game/Users/User.cs
+++ /dev/null
@@ -1,292 +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.ComponentModel;
-using System.Linq;
-using JetBrains.Annotations;
-using Newtonsoft.Json;
-using osu.Framework.Bindables;
-using osu.Game.Online.API.Requests;
-
-namespace osu.Game.Users
-{
-    public class User : IEquatable<User>
-    {
-        [JsonProperty(@"id")]
-        public int Id = 1;
-
-        [JsonProperty(@"join_date")]
-        public DateTimeOffset JoinDate;
-
-        [JsonProperty(@"username")]
-        public string Username;
-
-        [JsonProperty(@"previous_usernames")]
-        public string[] PreviousUsernames;
-
-        [JsonProperty(@"country")]
-        public Country Country;
-
-        public readonly Bindable<UserStatus> Status = new Bindable<UserStatus>();
-
-        public readonly Bindable<UserActivity> Activity = new Bindable<UserActivity>();
-
-        [JsonProperty(@"profile_colour")]
-        public string Colour;
-
-        [JsonProperty(@"avatar_url")]
-        public string AvatarUrl;
-
-        [JsonProperty(@"cover_url")]
-        public string CoverUrl
-        {
-            get => Cover?.Url;
-            set => Cover = new UserCover { Url = value };
-        }
-
-        [JsonProperty(@"cover")]
-        public UserCover Cover;
-
-        public class UserCover
-        {
-            [JsonProperty(@"custom_url")]
-            public string CustomUrl;
-
-            [JsonProperty(@"url")]
-            public string Url;
-
-            [JsonProperty(@"id")]
-            public int? Id;
-        }
-
-        [JsonProperty(@"is_admin")]
-        public bool IsAdmin;
-
-        [JsonProperty(@"is_supporter")]
-        public bool IsSupporter;
-
-        [JsonProperty(@"support_level")]
-        public int SupportLevel;
-
-        [JsonProperty(@"is_gmt")]
-        public bool IsGMT;
-
-        [JsonProperty(@"is_qat")]
-        public bool IsQAT;
-
-        [JsonProperty(@"is_bng")]
-        public bool IsBNG;
-
-        [JsonProperty(@"is_bot")]
-        public bool IsBot;
-
-        [JsonProperty(@"is_active")]
-        public bool Active;
-
-        [JsonProperty(@"is_online")]
-        public bool IsOnline;
-
-        [JsonProperty(@"pm_friends_only")]
-        public bool PMFriendsOnly;
-
-        [JsonProperty(@"interests")]
-        public string Interests;
-
-        [JsonProperty(@"occupation")]
-        public string Occupation;
-
-        [JsonProperty(@"title")]
-        public string Title;
-
-        [JsonProperty(@"location")]
-        public string Location;
-
-        [JsonProperty(@"last_visit")]
-        public DateTimeOffset? LastVisit;
-
-        [JsonProperty(@"twitter")]
-        public string Twitter;
-
-        [JsonProperty(@"discord")]
-        public string Discord;
-
-        [JsonProperty(@"website")]
-        public string Website;
-
-        [JsonProperty(@"post_count")]
-        public int PostCount;
-
-        [JsonProperty(@"comments_count")]
-        public int CommentsCount;
-
-        [JsonProperty(@"follower_count")]
-        public int FollowerCount;
-
-        [JsonProperty(@"mapping_follower_count")]
-        public int MappingFollowerCount;
-
-        [JsonProperty(@"favourite_beatmapset_count")]
-        public int FavouriteBeatmapsetCount;
-
-        [JsonProperty(@"graveyard_beatmapset_count")]
-        public int GraveyardBeatmapsetCount;
-
-        [JsonProperty(@"loved_beatmapset_count")]
-        public int LovedBeatmapsetCount;
-
-        [JsonProperty(@"ranked_beatmapset_count")]
-        public int RankedBeatmapsetCount;
-
-        [JsonProperty(@"pending_beatmapset_count")]
-        public int PendingBeatmapsetCount;
-
-        [JsonProperty(@"scores_best_count")]
-        public int ScoresBestCount;
-
-        [JsonProperty(@"scores_first_count")]
-        public int ScoresFirstCount;
-
-        [JsonProperty(@"scores_recent_count")]
-        public int ScoresRecentCount;
-
-        [JsonProperty(@"beatmap_playcounts_count")]
-        public int BeatmapPlaycountsCount;
-
-        [JsonProperty]
-        private string[] playstyle
-        {
-            set => PlayStyles = value?.Select(str => Enum.Parse(typeof(PlayStyle), str, true)).Cast<PlayStyle>().ToArray();
-        }
-
-        public PlayStyle[] PlayStyles;
-
-        [JsonProperty(@"playmode")]
-        public string PlayMode;
-
-        [JsonProperty(@"profile_order")]
-        public string[] ProfileOrder;
-
-        [JsonProperty(@"kudosu")]
-        public KudosuCount Kudosu;
-
-        public class KudosuCount
-        {
-            [JsonProperty(@"total")]
-            public int Total;
-
-            [JsonProperty(@"available")]
-            public int Available;
-        }
-
-        private UserStatistics statistics;
-
-        /// <summary>
-        /// User statistics for the requested ruleset (in the case of a <see cref="GetUserRequest"/> or <see cref="GetFriendsRequest"/> response).
-        /// Otherwise empty.
-        /// </summary>
-        [JsonProperty(@"statistics")]
-        public UserStatistics Statistics
-        {
-            get => statistics ??= new UserStatistics();
-            set
-            {
-                if (statistics != null)
-                    // we may already have rank history populated
-                    value.RankHistory = statistics.RankHistory;
-
-                statistics = value;
-            }
-        }
-
-        [JsonProperty(@"rank_history")]
-        private RankHistoryData rankHistory
-        {
-            set => statistics.RankHistory = value;
-        }
-
-        public class RankHistoryData
-        {
-            [JsonProperty(@"mode")]
-            public string Mode;
-
-            [JsonProperty(@"data")]
-            public int[] Data;
-        }
-
-        [JsonProperty("badges")]
-        public Badge[] Badges;
-
-        [JsonProperty("user_achievements")]
-        public UserAchievement[] Achievements;
-
-        public class UserAchievement
-        {
-            [JsonProperty("achieved_at")]
-            public DateTimeOffset AchievedAt;
-
-            [JsonProperty("achievement_id")]
-            public int ID;
-        }
-
-        [JsonProperty("monthly_playcounts")]
-        public UserHistoryCount[] MonthlyPlaycounts;
-
-        [JsonProperty("replays_watched_counts")]
-        public UserHistoryCount[] ReplaysWatchedCounts;
-
-        /// <summary>
-        /// All user statistics per ruleset's short name (in the case of a <see cref="GetUsersRequest"/> response).
-        /// Otherwise empty. Can be altered for testing purposes.
-        /// </summary>
-        // todo: this should likely be moved to a separate UserCompact class at some point.
-        [JsonProperty("statistics_rulesets")]
-        [CanBeNull]
-        public Dictionary<string, UserStatistics> RulesetsStatistics { get; set; }
-
-        public override string ToString() => Username;
-
-        /// <summary>
-        /// A user instance for displaying locally created system messages.
-        /// </summary>
-        public static readonly User SYSTEM_USER = new User
-        {
-            Username = "system",
-            Colour = @"9c0101",
-            Id = 0
-        };
-
-        public bool Equals(User other)
-        {
-            if (ReferenceEquals(null, other)) return false;
-            if (ReferenceEquals(this, other)) return true;
-
-            return Id == other.Id;
-        }
-
-        public enum PlayStyle
-        {
-            [Description("Keyboard")]
-            Keyboard,
-
-            [Description("Mouse")]
-            Mouse,
-
-            [Description("Tablet")]
-            Tablet,
-
-            [Description("Touch Screen")]
-            Touch,
-        }
-
-        public class UserHistoryCount
-        {
-            [JsonProperty("start_date")]
-            public DateTime Date;
-
-            [JsonProperty("count")]
-            public long Count;
-        }
-    }
-}
diff --git a/osu.Game/Users/UserBrickPanel.cs b/osu.Game/Users/UserBrickPanel.cs
index 9ca7768187..3debdb6e72 100644
--- a/osu.Game/Users/UserBrickPanel.cs
+++ b/osu.Game/Users/UserBrickPanel.cs
@@ -7,13 +7,14 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
 using osu.Game.Graphics;
+using osu.Game.Online.API.Requests.Responses;
 using osuTK;
 
 namespace osu.Game.Users
 {
     public class UserBrickPanel : UserPanel
     {
-        public UserBrickPanel(User user)
+        public UserBrickPanel(APIUser user)
             : base(user)
         {
             AutoSizeAxes = Axes.Both;
diff --git a/osu.Game/Users/UserCoverBackground.cs b/osu.Game/Users/UserCoverBackground.cs
index 34bbf6892e..3f1f838b27 100644
--- a/osu.Game/Users/UserCoverBackground.cs
+++ b/osu.Game/Users/UserCoverBackground.cs
@@ -10,19 +10,20 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Graphics.Textures;
+using osu.Game.Online.API.Requests.Responses;
 using osuTK.Graphics;
 
 namespace osu.Game.Users
 {
-    public class UserCoverBackground : ModelBackedDrawable<User>
+    public class UserCoverBackground : ModelBackedDrawable<APIUser>
     {
-        public User User
+        public APIUser User
         {
             get => Model;
             set => Model = value;
         }
 
-        protected override Drawable CreateDrawable(User user) => new Cover(user);
+        protected override Drawable CreateDrawable(APIUser user) => new Cover(user);
 
         protected override double LoadDelay => 300;
 
@@ -37,9 +38,9 @@ namespace osu.Game.Users
         [LongRunningLoad]
         private class Cover : CompositeDrawable
         {
-            private readonly User user;
+            private readonly APIUser user;
 
-            public Cover(User user)
+            public Cover(APIUser user)
             {
                 this.user = user;
 
diff --git a/osu.Game/Users/UserGridPanel.cs b/osu.Game/Users/UserGridPanel.cs
index 44dcbc305d..c37eeb1cbf 100644
--- a/osu.Game/Users/UserGridPanel.cs
+++ b/osu.Game/Users/UserGridPanel.cs
@@ -4,6 +4,7 @@
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays.Profile.Header.Components;
 using osuTK;
 
@@ -13,7 +14,7 @@ namespace osu.Game.Users
     {
         private const int margin = 10;
 
-        public UserGridPanel(User user)
+        public UserGridPanel(APIUser user)
             : base(user)
         {
             Height = 120;
diff --git a/osu.Game/Users/UserListPanel.cs b/osu.Game/Users/UserListPanel.cs
index cc4fca9b94..f06e412315 100644
--- a/osu.Game/Users/UserListPanel.cs
+++ b/osu.Game/Users/UserListPanel.cs
@@ -7,6 +7,7 @@ using osu.Framework.Graphics.Colour;
 using osu.Framework.Extensions.Color4Extensions;
 using osuTK.Graphics;
 using osu.Framework.Graphics.Containers;
+using osu.Game.Online.API.Requests.Responses;
 using osuTK;
 using osu.Game.Overlays.Profile.Header.Components;
 
@@ -14,7 +15,7 @@ namespace osu.Game.Users
 {
     public class UserListPanel : ExtendedUserPanel
     {
-        public UserListPanel(User user)
+        public UserListPanel(APIUser user)
             : base(user)
         {
             RelativeSizeAxes = Axes.X;
diff --git a/osu.Game/Users/UserPanel.cs b/osu.Game/Users/UserPanel.cs
index ff0d03a036..248debf1d3 100644
--- a/osu.Game/Users/UserPanel.cs
+++ b/osu.Game/Users/UserPanel.cs
@@ -13,12 +13,13 @@ using osu.Game.Graphics.UserInterface;
 using osu.Framework.Graphics.Cursor;
 using osu.Game.Graphics.Containers;
 using JetBrains.Annotations;
+using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Users
 {
     public abstract class UserPanel : OsuClickableContainer, IHasContextMenu
     {
-        public readonly User User;
+        public readonly APIUser User;
 
         /// <summary>
         /// Perform an action in addition to showing the user's profile.
@@ -30,7 +31,7 @@ namespace osu.Game.Users
 
         protected Drawable Background { get; private set; }
 
-        protected UserPanel(User user)
+        protected UserPanel(APIUser user)
             : base(HoverSampleSet.Submit)
         {
             if (user == null)
diff --git a/osu.Game/Users/UserStatistics.cs b/osu.Game/Users/UserStatistics.cs
index 449b0aa212..6acb63fdc4 100644
--- a/osu.Game/Users/UserStatistics.cs
+++ b/osu.Game/Users/UserStatistics.cs
@@ -4,16 +4,17 @@
 using System;
 using Newtonsoft.Json;
 using osu.Framework.Localisation;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Scoring;
 using osu.Game.Utils;
-using static osu.Game.Users.User;
+using static osu.Game.Online.API.Requests.Responses.APIUser;
 
 namespace osu.Game.Users
 {
     public class UserStatistics
     {
         [JsonProperty]
-        public User User;
+        public APIUser User;
 
         [JsonProperty(@"level")]
         public LevelInfo Level;

From f0809801c5784f68c947cda253fa18467cb96564 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 7 Nov 2021 11:34:37 +0900
Subject: [PATCH 0794/5547] Update remaining actions to events

---
 osu.Game/Beatmaps/BeatmapManager.cs      | 12 ++++++------
 osu.Game/Beatmaps/BeatmapModelManager.cs |  4 ++--
 2 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index 0f2cf6a730..b330cc2b4c 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -100,19 +100,19 @@ namespace osu.Game.Beatmaps
         /// <summary>
         /// Fired when a single difficulty has been hidden.
         /// </summary>
-        public Action<BeatmapInfo> BeatmapHidden
+        public event Action<BeatmapInfo> BeatmapHidden
         {
-            get => beatmapModelManager.BeatmapHidden;
-            set => beatmapModelManager.BeatmapHidden = value;
+            add => beatmapModelManager.BeatmapHidden += value;
+            remove => beatmapModelManager.BeatmapHidden -= value;
         }
 
         /// <summary>
         /// Fired when a single difficulty has been restored.
         /// </summary>
-        public Action<BeatmapInfo> BeatmapRestored
+        public event Action<BeatmapInfo> BeatmapRestored
         {
-            get => beatmapModelManager.BeatmapRestored;
-            set => beatmapModelManager.BeatmapRestored = value;
+            add => beatmapModelManager.BeatmapRestored += value;
+            remove => beatmapModelManager.BeatmapRestored -= value;
         }
 
         /// <summary>
diff --git a/osu.Game/Beatmaps/BeatmapModelManager.cs b/osu.Game/Beatmaps/BeatmapModelManager.cs
index 1a78a625d9..eb1bf598a4 100644
--- a/osu.Game/Beatmaps/BeatmapModelManager.cs
+++ b/osu.Game/Beatmaps/BeatmapModelManager.cs
@@ -36,12 +36,12 @@ namespace osu.Game.Beatmaps
         /// <summary>
         /// Fired when a single difficulty has been hidden.
         /// </summary>
-        public Action<BeatmapInfo> BeatmapHidden;
+        public event Action<BeatmapInfo> BeatmapHidden;
 
         /// <summary>
         /// Fired when a single difficulty has been restored.
         /// </summary>
-        public Action<BeatmapInfo> BeatmapRestored;
+        public event Action<BeatmapInfo> BeatmapRestored;
 
         /// <summary>
         /// An online lookup queue component which handles populating online beatmap metadata.

From b1f3fee239443c2c0fcf748e58be3c6a25ed4395 Mon Sep 17 00:00:00 2001
From: Sebastian Krajewski <mail@wieku.me>
Date: Sun, 7 Nov 2021 05:54:17 +0100
Subject: [PATCH 0795/5547] Add sanity check in Relax effectiveMissCount
 calculation

---
 osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
index 4bca87204a..06f3360f7f 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
@@ -54,7 +54,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty
 
             if (mods.Any(h => h is OsuModRelax))
             {
-                effectiveMissCount += countOk + countMeh;
+                effectiveMissCount = Math.Min(effectiveMissCount + countOk + countMeh, totalHits);
                 multiplier *= 0.6;
             }
 

From d5f5d74a89e880d3510867bab46698455504f7cd Mon Sep 17 00:00:00 2001
From: Tollii <tolnes@protonmail.com>
Date: Sun, 7 Nov 2021 13:38:00 +0100
Subject: [PATCH 0796/5547] Rename CancellationToken variable

---
 osu.Game/Beatmaps/IWorkingBeatmap.cs                 | 4 ++--
 osu.Game/Beatmaps/WorkingBeatmap.cs                  | 4 ++--
 osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs | 4 ++--
 3 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Beatmaps/IWorkingBeatmap.cs b/osu.Game/Beatmaps/IWorkingBeatmap.cs
index 3bbfb2a889..1e46e265ac 100644
--- a/osu.Game/Beatmaps/IWorkingBeatmap.cs
+++ b/osu.Game/Beatmaps/IWorkingBeatmap.cs
@@ -58,10 +58,10 @@ namespace osu.Game.Beatmaps
         /// <param name="ruleset">The <see cref="RulesetInfo"/> to create a playable <see cref="IBeatmap"/> for.</param>
         /// <param name="mods">The <see cref="Mod"/>s to apply to the <see cref="IBeatmap"/>.</param>
         /// <param name="timeout">The maximum length in milliseconds to wait for load to complete. Defaults to 10,000ms.</param>
-        /// <param name="timeoutToken">Cancellation token that cancels the beatmap loading process.</param>
+        /// <param name="token">Cancellation token that cancels the beatmap loading process.</param>
         /// <returns>The converted <see cref="IBeatmap"/>.</returns>
         /// <exception cref="BeatmapInvalidForRulesetException">If <see cref="Beatmap"/> could not be converted to <paramref name="ruleset"/>.</exception>
-        IBeatmap GetPlayableBeatmap(RulesetInfo ruleset, IReadOnlyList<Mod> mods = null, TimeSpan? timeout = null, CancellationToken timeoutToken = default);
+        IBeatmap GetPlayableBeatmap(RulesetInfo ruleset, IReadOnlyList<Mod> mods = null, TimeSpan? timeout = null, CancellationToken token = default);
 
         /// <summary>
         /// Load a new audio track instance for this beatmap. This should be called once before accessing <see cref="Track"/>.
diff --git a/osu.Game/Beatmaps/WorkingBeatmap.cs b/osu.Game/Beatmaps/WorkingBeatmap.cs
index e0c2ae7873..a93c50ce74 100644
--- a/osu.Game/Beatmaps/WorkingBeatmap.cs
+++ b/osu.Game/Beatmaps/WorkingBeatmap.cs
@@ -81,10 +81,10 @@ namespace osu.Game.Beatmaps
         /// <returns>The applicable <see cref="IBeatmapConverter"/>.</returns>
         protected virtual IBeatmapConverter CreateBeatmapConverter(IBeatmap beatmap, Ruleset ruleset) => ruleset.CreateBeatmapConverter(beatmap);
 
-        public virtual IBeatmap GetPlayableBeatmap(RulesetInfo ruleset, IReadOnlyList<Mod> mods = null, TimeSpan? timeout = null, CancellationToken timeoutToken = default)
+        public virtual IBeatmap GetPlayableBeatmap(RulesetInfo ruleset, IReadOnlyList<Mod> mods = null, TimeSpan? timeout = null, CancellationToken token = default)
         {
             using (var timeoutSource = createTimeoutTokenSource(timeout))
-            using (var linkedTokenSource = CancellationTokenSource.CreateLinkedTokenSource(timeoutToken, timeoutSource.Token))
+            using (var linkedTokenSource = CancellationTokenSource.CreateLinkedTokenSource(token, timeoutSource.Token))
             {
                 mods ??= Array.Empty<Mod>();
 
diff --git a/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs b/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs
index ffad6131be..6630530b65 100644
--- a/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs
+++ b/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs
@@ -123,12 +123,12 @@ namespace osu.Game.Rulesets.Difficulty
         /// Performs required tasks before every calculation.
         /// </summary>
         /// <param name="mods">The original list of <see cref="Mod"/>s.</param>
-        /// <param name="cancellationToken">The cancellation timeoutToken.</param>
+        /// <param name="cancellationToken">The cancellation token.</param>
         private void preProcess(IEnumerable<Mod> mods = null, CancellationToken cancellationToken = default)
         {
             playableMods = mods.Select(m => m.DeepClone()).ToArray();
 
-            Beatmap = beatmap.GetPlayableBeatmap(ruleset.RulesetInfo, playableMods, timeoutToken: cancellationToken);
+            Beatmap = beatmap.GetPlayableBeatmap(ruleset.RulesetInfo, playableMods, token: cancellationToken);
 
             var track = new TrackVirtual(10000);
             playableMods.OfType<IApplicableToTrack>().ForEach(m => m.ApplyToTrack(track));

From eb5e7402c3b86a4ce19243aaf678d8206c16edf3 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sun, 7 Nov 2021 16:14:24 +0300
Subject: [PATCH 0797/5547] Remove obsolete method in `ModAutoplay`

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

diff --git a/osu.Game/Rulesets/Mods/ModAutoplay.cs b/osu.Game/Rulesets/Mods/ModAutoplay.cs
index 4849d6ea36..60b9c29fe0 100644
--- a/osu.Game/Rulesets/Mods/ModAutoplay.cs
+++ b/osu.Game/Rulesets/Mods/ModAutoplay.cs
@@ -30,11 +30,6 @@ namespace osu.Game.Rulesets.Mods
 
         public override bool HasImplementation => GetType().GenericTypeArguments.Length == 0;
 
-        [Obsolete("Use the mod-supporting override")] // can be removed 20210731
-        public virtual Score CreateReplayScore(IBeatmap beatmap) => new Score { Replay = new Replay() };
-
-#pragma warning disable 618
-        public virtual Score CreateReplayScore(IBeatmap beatmap, IReadOnlyList<Mod> mods) => CreateReplayScore(beatmap);
-#pragma warning restore 618
+        public virtual Score CreateReplayScore(IBeatmap beatmap, IReadOnlyList<Mod> mods) => new Score { Replay = new Replay() };
     }
 }

From fedbbc02109b5a42d545276837da119ab91c00f9 Mon Sep 17 00:00:00 2001
From: Sebastian Krajewski <mail@wieku.me>
Date: Sun, 7 Nov 2021 14:50:00 +0100
Subject: [PATCH 0798/5547] Add a comment why Math.Min is used

---
 osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
index 06f3360f7f..6231ebf757 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
@@ -54,7 +54,9 @@ namespace osu.Game.Rulesets.Osu.Difficulty
 
             if (mods.Any(h => h is OsuModRelax))
             {
+                // As we're adding Oks and Mehs to an approximated number of combo breaks the result can be higher than total hits in specific scenarios (which breaks some calculations) so we need to clamp it.
                 effectiveMissCount = Math.Min(effectiveMissCount + countOk + countMeh, totalHits);
+
                 multiplier *= 0.6;
             }
 

From 91e261e2567ca3bdd72394b8343813e0c6ecda1c Mon Sep 17 00:00:00 2001
From: Sebastian Krajewski <mail@wieku.me>
Date: Sun, 7 Nov 2021 14:51:17 +0100
Subject: [PATCH 0799/5547] Start comments with upper case

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

diff --git a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
index 6231ebf757..b3501df515 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
@@ -257,7 +257,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty
 
         private int calculateEffectiveMissCount()
         {
-            // guess the number of misses + slider breaks from combo
+            // Guess the number of misses + slider breaks from combo
             double comboBasedMissCount = 0.0;
 
             if (Attributes.SliderCount > 0)
@@ -267,7 +267,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty
                     comboBasedMissCount = fullComboThreshold / Math.Max(1.0, scoreMaxCombo);
             }
 
-            // we're clamping misscount because since its derived from combo it can be higher than total hits and that breaks some calculations
+            // We're clamping misscount because since its derived from combo it can be higher than total hits and that breaks some calculations
             comboBasedMissCount = Math.Min(comboBasedMissCount, totalHits);
 
             return Math.Max(countMiss, (int)Math.Floor(comboBasedMissCount));

From 771620cef1e871b0bfe1e419bb74849f6c894b4c Mon Sep 17 00:00:00 2001
From: Xexxar <xexxar.xexxar@gmail.com>
Date: Sun, 7 Nov 2021 14:21:18 +0000
Subject: [PATCH 0800/5547] refactored duplicate code for simplicity

---
 .../Preprocessing/OsuDifficultyHitObject.cs   | 34 +++++++------------
 1 file changed, 12 insertions(+), 22 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
index 3e220f6199..a03d11575a 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
@@ -147,6 +147,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
 
                 Vector2 currMovement = Vector2.Subtract(currMovementObj.StackedPosition, currCursorPosition);
                 double currMovementLength = scalingFactor * currMovement.Length;
+                double currRadius = assumed_slider_radius;
 
                 if (i == slider.NestedHitObjects.Count - 1)
                 {
@@ -160,31 +161,20 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
                         currMovement = lazyMovement;
 
                     currMovementLength = scalingFactor * currMovement.Length;
+                }
+                else if (currMovementObj is SliderRepeat)
+                    currRadius = normalized_radius;
 
-                    if (currMovementLength > assumed_slider_radius)
-                    {
-                        // Calculate the vector movement, regardless of final location to get the true lazy end position.
-                        currCursorPosition = Vector2.Add(currCursorPosition, Vector2.Multiply(currMovement, (float)((currMovementLength - assumed_slider_radius) / currMovementLength)));
-                        currMovementLength *= (currMovementLength - assumed_slider_radius) / currMovementLength;
-                        slider.LazyTravelDistance += (float)currMovementLength;
-                    }
+                if (currMovementLength > currRadius)
+                {
+                    // this finds the positional delta from the required radius and the current position, and updates the currCursorPosition accordingly, as well as rewarding distance.
+                    currCursorPosition = Vector2.Add(currCursorPosition, Vector2.Multiply(currMovement, (float)((currMovementLength - currRadius) / currMovementLength)));
+                    currMovementLength *= (currMovementLength - currRadius) / currMovementLength;
+                    slider.LazyTravelDistance += (float)currMovementLength;
+                }
 
+                if (i == slider.NestedHitObjects.Count - 1)
                     slider.LazyEndPosition = currCursorPosition;
-                }
-                else if (currMovementObj is SliderRepeat && currMovementLength > normalized_radius)
-                {
-                    // For a slider repeat, assume a tighter movement threshold to better assess repeat sliders.
-                    currCursorPosition = Vector2.Add(currCursorPosition, Vector2.Multiply(currMovement, (float)((currMovementLength - normalized_radius) / currMovementLength)));
-                    currMovementLength *= (currMovementLength - normalized_radius) / currMovementLength;
-                    slider.LazyTravelDistance += (float)currMovementLength;
-                }
-                else if (currMovementLength > assumed_slider_radius)
-                {
-                    // For a slider ticks, use the assumed slider radius for a more accurate movement assessment.
-                    currCursorPosition = Vector2.Add(currCursorPosition, Vector2.Multiply(currMovement, (float)((currMovementLength - assumed_slider_radius) / currMovementLength)));
-                    currMovementLength *= (currMovementLength - assumed_slider_radius) / currMovementLength;
-                    slider.LazyTravelDistance += (float)currMovementLength;
-                }
             }
 
             slider.LazyTravelDistance *= (float)Math.Pow(1 + slider.RepeatCount / 2.5, 1.0 / 2.5); // Bonus for repeat sliders until a better per nested object strain system can be achieved.

From 6aecd682affbcfe63934814002be22e95c9bb8d1 Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Sun, 7 Nov 2021 23:26:13 +0900
Subject: [PATCH 0801/5547] Refactor a bit

---
 .../Preprocessing/OsuDifficultyHitObject.cs       | 15 ++++++++++-----
 1 file changed, 10 insertions(+), 5 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
index a03d11575a..606f6a5394 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
@@ -147,7 +147,9 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
 
                 Vector2 currMovement = Vector2.Subtract(currMovementObj.StackedPosition, currCursorPosition);
                 double currMovementLength = scalingFactor * currMovement.Length;
-                double currRadius = assumed_slider_radius;
+
+                // Amount of movement required so that the cursor position needs to be updated.
+                double requiredMovement = assumed_slider_radius;
 
                 if (i == slider.NestedHitObjects.Count - 1)
                 {
@@ -163,13 +165,16 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
                     currMovementLength = scalingFactor * currMovement.Length;
                 }
                 else if (currMovementObj is SliderRepeat)
-                    currRadius = normalized_radius;
+                {
+                    // For a slider repeat, assume a tighter movement threshold to better assess repeat sliders.
+                    requiredMovement = normalized_radius;
+                }
 
-                if (currMovementLength > currRadius)
+                if (currMovementLength > requiredMovement)
                 {
                     // this finds the positional delta from the required radius and the current position, and updates the currCursorPosition accordingly, as well as rewarding distance.
-                    currCursorPosition = Vector2.Add(currCursorPosition, Vector2.Multiply(currMovement, (float)((currMovementLength - currRadius) / currMovementLength)));
-                    currMovementLength *= (currMovementLength - currRadius) / currMovementLength;
+                    currCursorPosition = Vector2.Add(currCursorPosition, Vector2.Multiply(currMovement, (float)((currMovementLength - requiredMovement) / currMovementLength)));
+                    currMovementLength *= (currMovementLength - requiredMovement) / currMovementLength;
                     slider.LazyTravelDistance += (float)currMovementLength;
                 }
 

From 95f2bef119ba54f55a0983fc1ea795704b390c69 Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Sun, 7 Nov 2021 23:27:37 +0900
Subject: [PATCH 0802/5547] Update tests

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

diff --git a/osu.Game.Rulesets.Osu.Tests/OsuDifficultyCalculatorTest.cs b/osu.Game.Rulesets.Osu.Tests/OsuDifficultyCalculatorTest.cs
index 7cd06c5225..79d575ab3f 100644
--- a/osu.Game.Rulesets.Osu.Tests/OsuDifficultyCalculatorTest.cs
+++ b/osu.Game.Rulesets.Osu.Tests/OsuDifficultyCalculatorTest.cs
@@ -15,13 +15,13 @@ namespace osu.Game.Rulesets.Osu.Tests
     {
         protected override string ResourceAssembly => "osu.Game.Rulesets.Osu";
 
-        [TestCase(6.5295339534769958d, "diffcalc-test")]
-        [TestCase(1.1514260533755143d, "zero-length-sliders")]
+        [TestCase(6.531832890435525d, "diffcalc-test")]
+        [TestCase(1.4644923495008817d, "zero-length-sliders")]
         public void Test(double expected, string name)
             => base.Test(expected, name);
 
-        [TestCase(9.047752485219954d, "diffcalc-test")]
-        [TestCase(1.3985711787077566d, "zero-length-sliders")]
+        [TestCase(8.8067616302940852d, "diffcalc-test")]
+        [TestCase(1.7763214959309293d, "zero-length-sliders")]
         public void TestClockRateAdjusted(double expected, string name)
             => Test(expected, name, new OsuModDoubleTime());
 

From 03476e018e65591d08b47507a7ce410914b06e0f Mon Sep 17 00:00:00 2001
From: Xexxar <xexxar.xexxar@gmail.com>
Date: Sun, 7 Nov 2021 14:49:26 +0000
Subject: [PATCH 0803/5547] fixed comment

---
 .../Difficulty/Preprocessing/OsuDifficultyHitObject.cs          | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
index a03d11575a..313078f153 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
@@ -101,7 +101,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
                 // such that they're not jumping from the lazy position but rather from very close to (or the end of) the slider.
                 // In such cases, a leniency is applied by also considering the jump distance from the tail of the slider, and taking the minimum jump distance.
                 // Additional distance is removed based on position of jump relative to slider follow circle radius.
-                // JumpDistance is the distance beyond the s. tailJumpDistance is maximum_slider_radius since the full distance of radial leniency is still possible.
+                // JumpDistance is the leniency distance beyond the assumed_slider_radius. tailJumpDistance is maximum_slider_radius since the full distance of radial leniency is still possible.
                 MovementDistance = Math.Max(0, Math.Min(JumpDistance - (maximum_slider_radius - assumed_slider_radius), tailJumpDistance - maximum_slider_radius));
             }
             else

From ca933c53abcf42eb8317b121b05ddc3788c2ceb2 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 7 Nov 2021 23:52:32 +0900
Subject: [PATCH 0804/5547] Fix weird english in old comment

---
 osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
index b3501df515..cd8c1a2d0c 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
@@ -267,7 +267,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty
                     comboBasedMissCount = fullComboThreshold / Math.Max(1.0, scoreMaxCombo);
             }
 
-            // We're clamping misscount because since its derived from combo it can be higher than total hits and that breaks some calculations
+            // Clamp misscount since it's derived from combo and can be higher than total hits and that breaks some calculations
             comboBasedMissCount = Math.Min(comboBasedMissCount, totalHits);
 
             return Math.Max(countMiss, (int)Math.Floor(comboBasedMissCount));

From 86b635cdd33c06ed591b3e96c3ca64be4214b65f Mon Sep 17 00:00:00 2001
From: Xexxar <xexxar.xexxar@gmail.com>
Date: Sun, 7 Nov 2021 14:56:23 +0000
Subject: [PATCH 0805/5547] refactor comments to be on previous line for
 readability

---
 osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs | 18 ++++++++++++------
 1 file changed, 12 insertions(+), 6 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
index 44fff88202..cf983a5fc2 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
@@ -94,18 +94,23 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
                                            * Math.Pow(Math.Sin(Math.PI / 2 * (Math.Clamp(osuCurrObj.JumpDistance, 50, 100) - 50) / 50), 2); // Buff distance exceeding 50 (radius) up to 100 (diameter).
                     }
 
-                    wideAngleBonus *= angleBonus * (1 - Math.Min(wideAngleBonus, Math.Pow(calcWideAngleBonus(lastAngle), 3))); // Penalize wide angles if they're repeated, reducing the penalty as the lastAngle gets more acute.
-                    acuteAngleBonus *= 0.5 + 0.5 * (1 - Math.Min(acuteAngleBonus, Math.Pow(calcAcuteAngleBonus(lastLastAngle), 3))); // Penalize acute angles if they're repeated, reducing the penalty as the lastLastAngle gets more obtuse.
+                    // Penalize wide angles if they're repeated, reducing the penalty as the lastAngle gets more acute.
+                    wideAngleBonus *= angleBonus * (1 - Math.Min(wideAngleBonus, Math.Pow(calcWideAngleBonus(lastAngle), 3)));
+                    // Penalize acute angles if they're repeated, reducing the penalty as the lastLastAngle gets more obtuse.
+                    acuteAngleBonus *= 0.5 + 0.5 * (1 - Math.Min(acuteAngleBonus, Math.Pow(calcAcuteAngleBonus(lastLastAngle), 3)));
                 }
             }
 
             if (Math.Max(prevVelocity, currVelocity) != 0)
             {
-                prevVelocity = (osuLastObj.JumpDistance + osuLastObj.TravelDistance) / osuLastObj.StrainTime; // We want to use the average velocity over the whole object when awarding differences, not the individual jump and slider path velocities.
+                // We want to use the average velocity over the whole object when awarding differences, not the individual jump and slider path velocities.
+                prevVelocity = (osuLastObj.JumpDistance + osuLastObj.TravelDistance) / osuLastObj.StrainTime;
                 currVelocity = (osuCurrObj.JumpDistance + osuCurrObj.TravelDistance) / osuCurrObj.StrainTime;
 
-                double distRatio = Math.Pow(Math.Sin(Math.PI / 2 * Math.Abs(prevVelocity - currVelocity) / Math.Max(prevVelocity, currVelocity)), 2); // scale with ratio of difference compared to 0.5 * max dist.
-                double overlapVelocityBuff = Math.Min(125 / Math.Min(osuCurrObj.StrainTime, osuLastObj.StrainTime), Math.Abs(prevVelocity - currVelocity)); // reward for % distance up to 125 / strainTime for overlaps where velocity is still changing.
+                // scale with ratio of difference compared to 0.5 * max dist.
+                double distRatio = Math.Pow(Math.Sin(Math.PI / 2 * Math.Abs(prevVelocity - currVelocity) / Math.Max(prevVelocity, currVelocity)), 2);
+                // reward for % distance up to 125 / strainTime for overlaps where velocity is still changing.
+                double overlapVelocityBuff = Math.Min(125 / Math.Min(osuCurrObj.StrainTime, osuLastObj.StrainTime), Math.Abs(prevVelocity - currVelocity));
                 double nonOverlapVelocityBuff = Math.Abs(prevVelocity - currVelocity) // reward for % distance slowed down compared to previous, paying attention to not award overlap
                                                  * Math.Pow(Math.Sin(Math.PI / 2 * Math.Min(1, Math.Min(osuCurrObj.JumpDistance, osuLastObj.JumpDistance) / 100)), 2); // do not award overlap
 
@@ -119,7 +124,8 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
                 sliderBonus = osuCurrObj.TravelDistance / osuCurrObj.TravelTime; // add some slider rewards
             }
 
-            aimStrain += Math.Max(acuteAngleBonus * acute_angle_multiplier, wideAngleBonus * wide_angle_multiplier + velChangeBonus * vel_change_multiplier); // Add in acute angle bonus or wide angle bonus + velchange bonus, whichever is larger.
+            // Add in acute angle bonus or wide angle bonus + velchange bonus, whichever is larger.
+            aimStrain += Math.Max(acuteAngleBonus * acute_angle_multiplier, wideAngleBonus * wide_angle_multiplier + velChangeBonus * vel_change_multiplier);
             aimStrain += sliderBonus * slider_multiplier; // Add in additional slider velocity.
 
             return aimStrain;

From fed733202ea7626dcf4b6ebb36e2923acf010025 Mon Sep 17 00:00:00 2001
From: Xexxar <xexxar.xexxar@gmail.com>
Date: Sun, 7 Nov 2021 14:59:25 +0000
Subject: [PATCH 0806/5547] removed unneeded comment

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

diff --git a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
index 9134deb067..4aeb038847 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
@@ -123,7 +123,6 @@ namespace osu.Game.Rulesets.Osu.Difficulty
                 aimValue *= 1.0 + 0.04 * (12.0 - Attributes.ApproachRate);
             }
 
-            // Scale the aim value with accuracy
             aimValue *= accuracy;
             // It is important to also consider accuracy difficulty when doing that.
             aimValue *= 0.98 + Math.Pow(Attributes.OverallDifficulty, 2) / 2500;

From 366583c8e24bc3b7f2e533e8ea4623641507c5bd Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Mon, 8 Nov 2021 00:33:57 +0900
Subject: [PATCH 0807/5547] Update tests

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

diff --git a/osu.Game.Rulesets.Osu.Tests/OsuDifficultyCalculatorTest.cs b/osu.Game.Rulesets.Osu.Tests/OsuDifficultyCalculatorTest.cs
index 79d575ab3f..c88f70021b 100644
--- a/osu.Game.Rulesets.Osu.Tests/OsuDifficultyCalculatorTest.cs
+++ b/osu.Game.Rulesets.Osu.Tests/OsuDifficultyCalculatorTest.cs
@@ -15,13 +15,13 @@ namespace osu.Game.Rulesets.Osu.Tests
     {
         protected override string ResourceAssembly => "osu.Game.Rulesets.Osu";
 
-        [TestCase(6.531832890435525d, "diffcalc-test")]
-        [TestCase(1.4644923495008817d, "zero-length-sliders")]
+        [TestCase(6.6975550434910005d, "diffcalc-test")]
+        [TestCase(1.4673500058356748d, "zero-length-sliders")]
         public void Test(double expected, string name)
             => base.Test(expected, name);
 
-        [TestCase(8.8067616302940852d, "diffcalc-test")]
-        [TestCase(1.7763214959309293d, "zero-length-sliders")]
+        [TestCase(8.938989502378238d, "diffcalc-test")]
+        [TestCase(1.779323508403831d, "zero-length-sliders")]
         public void TestClockRateAdjusted(double expected, string name)
             => Test(expected, name, new OsuModDoubleTime());
 

From 84f3168a6c1fbb276ed12542158bd5257658b7eb Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Mon, 8 Nov 2021 00:46:35 +0900
Subject: [PATCH 0808/5547] More comment refactorings

---
 .../Difficulty/Skills/Aim.cs                  | 31 ++++++++++++-------
 1 file changed, 20 insertions(+), 11 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
index cf983a5fc2..89a6fb87d7 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
@@ -66,7 +66,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
             double wideAngleBonus = 0;
             double acuteAngleBonus = 0;
             double sliderBonus = 0;
-            double velChangeBonus = 0;
+            double velocityChangeBonus = 0;
 
             double aimStrain = currVelocity; // Start strain with regular velocity.
 
@@ -107,26 +107,35 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
                 prevVelocity = (osuLastObj.JumpDistance + osuLastObj.TravelDistance) / osuLastObj.StrainTime;
                 currVelocity = (osuCurrObj.JumpDistance + osuCurrObj.TravelDistance) / osuCurrObj.StrainTime;
 
-                // scale with ratio of difference compared to 0.5 * max dist.
+                // Scale with ratio of difference compared to 0.5 * max dist.
                 double distRatio = Math.Pow(Math.Sin(Math.PI / 2 * Math.Abs(prevVelocity - currVelocity) / Math.Max(prevVelocity, currVelocity)), 2);
-                // reward for % distance up to 125 / strainTime for overlaps where velocity is still changing.
+
+                // Reward for % distance up to 125 / strainTime for overlaps where velocity is still changing.
                 double overlapVelocityBuff = Math.Min(125 / Math.Min(osuCurrObj.StrainTime, osuLastObj.StrainTime), Math.Abs(prevVelocity - currVelocity));
-                double nonOverlapVelocityBuff = Math.Abs(prevVelocity - currVelocity) // reward for % distance slowed down compared to previous, paying attention to not award overlap
-                                                 * Math.Pow(Math.Sin(Math.PI / 2 * Math.Min(1, Math.Min(osuCurrObj.JumpDistance, osuLastObj.JumpDistance) / 100)), 2); // do not award overlap
 
-                velChangeBonus = Math.Max(overlapVelocityBuff, nonOverlapVelocityBuff) * distRatio; // choose larger distance, multiplied by ratio.
+                // Reward for % distance slowed down compared to previous, paying attention to not award overlap
+                double nonOverlapVelocityBuff = Math.Abs(prevVelocity - currVelocity)
+                                                // do not award overlap
+                                                * Math.Pow(Math.Sin(Math.PI / 2 * Math.Min(1, Math.Min(osuCurrObj.JumpDistance, osuLastObj.JumpDistance) / 100)), 2);
 
-                velChangeBonus *= Math.Pow(Math.Min(osuCurrObj.StrainTime, osuLastObj.StrainTime) / Math.Max(osuCurrObj.StrainTime, osuLastObj.StrainTime), 2); // penalize for rhythm changes.
+                // Choose the largest bonus, multiplied by ratio.
+                velocityChangeBonus = Math.Max(overlapVelocityBuff, nonOverlapVelocityBuff) * distRatio;
+
+                // Penalize for rhythm changes.
+                velocityChangeBonus *= Math.Pow(Math.Min(osuCurrObj.StrainTime, osuLastObj.StrainTime) / Math.Max(osuCurrObj.StrainTime, osuLastObj.StrainTime), 2);
             }
 
             if (osuCurrObj.TravelTime != 0)
             {
-                sliderBonus = osuCurrObj.TravelDistance / osuCurrObj.TravelTime; // add some slider rewards
+                // Reward sliders based on velocity.
+                sliderBonus = osuCurrObj.TravelDistance / osuCurrObj.TravelTime;
             }
 
-            // Add in acute angle bonus or wide angle bonus + velchange bonus, whichever is larger.
-            aimStrain += Math.Max(acuteAngleBonus * acute_angle_multiplier, wideAngleBonus * wide_angle_multiplier + velChangeBonus * vel_change_multiplier);
-            aimStrain += sliderBonus * slider_multiplier; // Add in additional slider velocity.
+            // Add in acute angle bonus or wide angle bonus + velocity change bonus, whichever is larger.
+            aimStrain += Math.Max(acuteAngleBonus * acute_angle_multiplier, wideAngleBonus * wide_angle_multiplier + velocityChangeBonus * vel_change_multiplier);
+
+            // Add in additional slider velocity bonus.
+            aimStrain += sliderBonus * slider_multiplier;
 
             return aimStrain;
         }

From 480a1604fab5263b5ee2cf1acb3f64920b65a0cd Mon Sep 17 00:00:00 2001
From: smoogipoo <smoogipoo@smgi.me>
Date: Mon, 8 Nov 2021 00:47:22 +0900
Subject: [PATCH 0809/5547] Rename constant

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

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
index 89a6fb87d7..aebc73f108 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
@@ -24,7 +24,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
         private const double wide_angle_multiplier = 1.5;
         private const double acute_angle_multiplier = 2.0;
         private const double slider_multiplier = 1.5;
-        private const double vel_change_multiplier = 0.75;
+        private const double velocity_change_multiplier = 0.75;
 
         private double currentStrain = 1;
 
@@ -132,7 +132,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
             }
 
             // Add in acute angle bonus or wide angle bonus + velocity change bonus, whichever is larger.
-            aimStrain += Math.Max(acuteAngleBonus * acute_angle_multiplier, wideAngleBonus * wide_angle_multiplier + velocityChangeBonus * vel_change_multiplier);
+            aimStrain += Math.Max(acuteAngleBonus * acute_angle_multiplier, wideAngleBonus * wide_angle_multiplier + velocityChangeBonus * velocity_change_multiplier);
 
             // Add in additional slider velocity bonus.
             aimStrain += sliderBonus * slider_multiplier;

From 04c2a9cd59a61e3951f1ab36566abbb78bf15ede Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 17 Oct 2021 20:50:44 +0200
Subject: [PATCH 0810/5547] Display basic statistics on card hover

---
 .../Visual/Beatmaps/TestSceneBeatmapCard.cs   | 10 +++
 .../Beatmaps/Drawables/Cards/BeatmapCard.cs   | 23 ++++++
 .../Statistics/BeatmapCardDateStatistic.cs    | 55 +++++++++++++
 .../Cards/Statistics/BeatmapCardStatistic.cs  | 81 +++++++++++++++++++
 .../Cards/Statistics/FavouritesStatistic.cs   | 23 ++++++
 .../Cards/Statistics/PlayCountStatistic.cs    | 23 ++++++
 6 files changed, 215 insertions(+)
 create mode 100644 osu.Game/Beatmaps/Drawables/Cards/Statistics/BeatmapCardDateStatistic.cs
 create mode 100644 osu.Game/Beatmaps/Drawables/Cards/Statistics/BeatmapCardStatistic.cs
 create mode 100644 osu.Game/Beatmaps/Drawables/Cards/Statistics/FavouritesStatistic.cs
 create mode 100644 osu.Game/Beatmaps/Drawables/Cards/Statistics/PlayCountStatistic.cs

diff --git a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs
index 2aeb4ab4e2..b56dcb0a43 100644
--- a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs
+++ b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs
@@ -31,11 +31,20 @@ namespace osu.Game.Tests.Visual.Beatmaps
             normal.HasVideo = true;
             normal.HasStoryboard = true;
 
+            var withStatistics = CreateAPIBeatmapSet(Ruleset.Value);
+            withStatistics.Status = BeatmapSetOnlineStatus.Approved;
+            withStatistics.FavouriteCount = 284_239;
+            withStatistics.PlayCount = 999_001;
+            withStatistics.Ranked = DateTimeOffset.Now.AddDays(-45);
+
             var undownloadable = getUndownloadableBeatmapSet();
+            undownloadable.LastUpdated = DateTimeOffset.Now.AddYears(-1);
 
             var someDifficulties = getManyDifficultiesBeatmapSet(11);
             someDifficulties.Title = someDifficulties.TitleUnicode = "some difficulties";
             someDifficulties.Status = BeatmapSetOnlineStatus.Qualified;
+            someDifficulties.HasFavourited = true;
+            someDifficulties.FavouriteCount = 1;
 
             var manyDifficulties = getManyDifficultiesBeatmapSet(100);
             manyDifficulties.Status = BeatmapSetOnlineStatus.Pending;
@@ -59,6 +68,7 @@ namespace osu.Game.Tests.Visual.Beatmaps
             testCases = new[]
             {
                 normal,
+                withStatistics,
                 undownloadable,
                 someDifficulties,
                 manyDifficulties,
diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
index 8136ebbd70..5d8f0a93cd 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.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.Graphics;
 using osu.Framework.Graphics.Containers;
@@ -8,6 +9,7 @@ using osu.Framework.Graphics.Shapes;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Input.Events;
 using osu.Framework.Localisation;
+using osu.Game.Beatmaps.Drawables.Cards.Statistics;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
@@ -40,6 +42,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
 
         private GridContainer titleContainer;
         private GridContainer artistContainer;
+        private FillFlowContainer<BeatmapCardStatistic> statisticsContainer;
 
         [Resolved]
         private OverlayColourProvider colourProvider { get; set; }
@@ -176,6 +179,15 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                                     d.AddText("mapped by ", t => t.Colour = colourProvider.Content2);
                                     d.AddUserLink(beatmapSet.Author);
                                 }),
+                                statisticsContainer = new FillFlowContainer<BeatmapCardStatistic>
+                                {
+                                    RelativeSizeAxes = Axes.X,
+                                    AutoSizeAxes = Axes.Y,
+                                    Direction = FillDirection.Horizontal,
+                                    Spacing = new Vector2(10, 0),
+                                    Alpha = 0,
+                                    ChildrenEnumerable = createStatistics()
+                                }
                             }
                         },
                         new FillFlowContainer
@@ -265,6 +277,16 @@ namespace osu.Game.Beatmaps.Drawables.Cards
             return BeatmapsetsStrings.ShowDetailsByArtist(romanisableArtist);
         }
 
+        private IEnumerable<BeatmapCardStatistic> createStatistics()
+        {
+            yield return new FavouritesStatistic(beatmapSet);
+            yield return new PlayCountStatistic(beatmapSet);
+
+            var dateStatistic = BeatmapCardDateStatistic.CreateFor(beatmapSet);
+            if (dateStatistic != null)
+                yield return dateStatistic;
+        }
+
         private void updateState()
         {
             float targetWidth = width - height;
@@ -275,6 +297,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
             mainContentBackground.Dimmed.Value = IsHovered;
 
             leftCover.FadeColour(IsHovered ? OsuColour.Gray(0.2f) : Color4.White, TRANSITION_DURATION, Easing.OutQuint);
+            statisticsContainer.FadeTo(IsHovered ? 1 : 0, TRANSITION_DURATION, Easing.OutQuint);
         }
     }
 }
diff --git a/osu.Game/Beatmaps/Drawables/Cards/Statistics/BeatmapCardDateStatistic.cs b/osu.Game/Beatmaps/Drawables/Cards/Statistics/BeatmapCardDateStatistic.cs
new file mode 100644
index 0000000000..8f2c4b538c
--- /dev/null
+++ b/osu.Game/Beatmaps/Drawables/Cards/Statistics/BeatmapCardDateStatistic.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.
+
+#nullable enable
+
+using System;
+using osu.Framework.Extensions.LocalisationExtensions;
+using osu.Framework.Graphics.Cursor;
+using osu.Framework.Graphics.Sprites;
+using osu.Game.Graphics;
+
+namespace osu.Game.Beatmaps.Drawables.Cards.Statistics
+{
+    public class BeatmapCardDateStatistic : BeatmapCardStatistic
+    {
+        private readonly DateTimeOffset dateTime;
+
+        private BeatmapCardDateStatistic(DateTimeOffset dateTime)
+        {
+            this.dateTime = dateTime;
+
+            Icon = FontAwesome.Regular.CheckCircle;
+            Text = dateTime.ToLocalisableString(@"d MMM yyyy");
+        }
+
+        public override object TooltipContent => dateTime;
+        public override ITooltip GetCustomTooltip() => new DateTooltip();
+
+        public static BeatmapCardDateStatistic? CreateFor(IBeatmapSetOnlineInfo beatmapSetInfo)
+        {
+            var displayDate = displayDateFor(beatmapSetInfo);
+
+            if (displayDate == null)
+                return null;
+
+            return new BeatmapCardDateStatistic(displayDate.Value);
+        }
+
+        private static DateTimeOffset? displayDateFor(IBeatmapSetOnlineInfo beatmapSetInfo)
+        {
+            // reference: https://github.com/ppy/osu-web/blob/ef432c11719fd1207bec5f9194b04f0033bdf02c/resources/assets/lib/beatmapset-panel.tsx#L36-L44
+            switch (beatmapSetInfo.Status)
+            {
+                case BeatmapSetOnlineStatus.Ranked:
+                case BeatmapSetOnlineStatus.Approved:
+                case BeatmapSetOnlineStatus.Loved:
+                case BeatmapSetOnlineStatus.Qualified:
+                    return beatmapSetInfo.Ranked;
+
+                default:
+                    return beatmapSetInfo.LastUpdated;
+            }
+        }
+    }
+}
diff --git a/osu.Game/Beatmaps/Drawables/Cards/Statistics/BeatmapCardStatistic.cs b/osu.Game/Beatmaps/Drawables/Cards/Statistics/BeatmapCardStatistic.cs
new file mode 100644
index 0000000000..95d99b9128
--- /dev/null
+++ b/osu.Game/Beatmaps/Drawables/Cards/Statistics/BeatmapCardStatistic.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 osu.Framework.Allocation;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.Cursor;
+using osu.Framework.Graphics.Sprites;
+using osu.Framework.Localisation;
+using osu.Game.Graphics;
+using osu.Game.Graphics.Sprites;
+using osu.Game.Overlays;
+using osuTK;
+
+namespace osu.Game.Beatmaps.Drawables.Cards.Statistics
+{
+    /// <summary>
+    /// A single statistic shown on a beatmap card.
+    /// </summary>
+    public abstract class BeatmapCardStatistic : CompositeDrawable, IHasTooltip, IHasCustomTooltip
+    {
+        protected IconUsage Icon
+        {
+            get => spriteIcon.Icon;
+            set => spriteIcon.Icon = value;
+        }
+
+        protected LocalisableString Text
+        {
+            get => spriteText.Text;
+            set => spriteText.Text = value;
+        }
+
+        protected LocalisableString TooltipText { get; set; }
+
+        private readonly SpriteIcon spriteIcon;
+        private readonly OsuSpriteText spriteText;
+
+        protected BeatmapCardStatistic()
+        {
+            AutoSizeAxes = Axes.Both;
+
+            InternalChild = new FillFlowContainer
+            {
+                AutoSizeAxes = Axes.Both,
+                Direction = FillDirection.Horizontal,
+                Spacing = new Vector2(5, 0),
+                Children = new Drawable[]
+                {
+                    spriteIcon = new SpriteIcon
+                    {
+                        Anchor = Anchor.CentreLeft,
+                        Origin = Anchor.CentreLeft,
+                        Size = new Vector2(10),
+                        Margin = new MarginPadding { Top = 1 }
+                    },
+                    spriteText = new OsuSpriteText
+                    {
+                        Anchor = Anchor.CentreLeft,
+                        Origin = Anchor.CentreLeft,
+                        Font = OsuFont.Default.With(size: 14)
+                    }
+                }
+            };
+        }
+
+        [BackgroundDependencyLoader]
+        private void load(OverlayColourProvider colourProvider)
+        {
+            spriteIcon.Colour = colourProvider.Content2;
+        }
+
+        #region Tooltip implementation
+
+        LocalisableString IHasTooltip.TooltipText => TooltipText;
+        public virtual ITooltip GetCustomTooltip() => null;
+        public virtual object TooltipContent => null;
+
+        #endregion
+    }
+}
diff --git a/osu.Game/Beatmaps/Drawables/Cards/Statistics/FavouritesStatistic.cs b/osu.Game/Beatmaps/Drawables/Cards/Statistics/FavouritesStatistic.cs
new file mode 100644
index 0000000000..7b3286ddcc
--- /dev/null
+++ b/osu.Game/Beatmaps/Drawables/Cards/Statistics/FavouritesStatistic.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 Humanizer;
+using osu.Framework.Extensions.LocalisationExtensions;
+using osu.Framework.Graphics.Sprites;
+using osu.Game.Resources.Localisation.Web;
+
+namespace osu.Game.Beatmaps.Drawables.Cards.Statistics
+{
+    /// <summary>
+    /// Shows the number of favourites that a beatmap set has received.
+    /// </summary>
+    public class FavouritesStatistic : BeatmapCardStatistic
+    {
+        public FavouritesStatistic(IBeatmapSetOnlineInfo onlineInfo)
+        {
+            Icon = onlineInfo.HasFavourited ? FontAwesome.Solid.Heart : FontAwesome.Regular.Heart;
+            Text = onlineInfo.FavouriteCount.ToMetric(decimals: 1);
+            TooltipText = BeatmapsStrings.PanelFavourites(onlineInfo.FavouriteCount.ToLocalisableString(@"N0"));
+        }
+    }
+}
diff --git a/osu.Game/Beatmaps/Drawables/Cards/Statistics/PlayCountStatistic.cs b/osu.Game/Beatmaps/Drawables/Cards/Statistics/PlayCountStatistic.cs
new file mode 100644
index 0000000000..d8f0c36bd9
--- /dev/null
+++ b/osu.Game/Beatmaps/Drawables/Cards/Statistics/PlayCountStatistic.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 Humanizer;
+using osu.Framework.Extensions.LocalisationExtensions;
+using osu.Framework.Graphics.Sprites;
+using osu.Game.Resources.Localisation.Web;
+
+namespace osu.Game.Beatmaps.Drawables.Cards.Statistics
+{
+    /// <summary>
+    /// Shows the number of times the given beatmap set has been played.
+    /// </summary>
+    public class PlayCountStatistic : BeatmapCardStatistic
+    {
+        public PlayCountStatistic(IBeatmapSetOnlineInfo onlineInfo)
+        {
+            Icon = FontAwesome.Regular.PlayCircle;
+            Text = onlineInfo.PlayCount.ToMetric(decimals: 1);
+            TooltipText = BeatmapsStrings.PanelPlaycount(onlineInfo.PlayCount.ToLocalisableString(@"N0"));
+        }
+    }
+}

From c0b5b0e9091b2f3b3b146b88bffd053ccdd7f370 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 17 Oct 2021 20:55:06 +0200
Subject: [PATCH 0811/5547] Add new statistic types to online info

---
 osu.Game/Beatmaps/BeatmapSetHypeStatus.cs     | 25 +++++++++++++++++++
 .../Beatmaps/BeatmapSetNominationStatus.cs    | 25 +++++++++++++++++++
 osu.Game/Beatmaps/IBeatmapSetOnlineInfo.cs    | 14 +++++++++++
 .../API/Requests/Responses/APIBeatmapSet.cs   |  6 +++++
 4 files changed, 70 insertions(+)
 create mode 100644 osu.Game/Beatmaps/BeatmapSetHypeStatus.cs
 create mode 100644 osu.Game/Beatmaps/BeatmapSetNominationStatus.cs

diff --git a/osu.Game/Beatmaps/BeatmapSetHypeStatus.cs b/osu.Game/Beatmaps/BeatmapSetHypeStatus.cs
new file mode 100644
index 0000000000..8a576e396a
--- /dev/null
+++ b/osu.Game/Beatmaps/BeatmapSetHypeStatus.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 Newtonsoft.Json;
+
+namespace osu.Game.Beatmaps
+{
+    /// <summary>
+    /// Contains information about the current hype status of a beatmap set.
+    /// </summary>
+    public class BeatmapSetHypeStatus
+    {
+        /// <summary>
+        /// The current number of hypes that the set has received.
+        /// </summary>
+        [JsonProperty(@"current")]
+        public int Current { get; set; }
+
+        /// <summary>
+        /// The number of hypes required so that the set is eligible for nomination.
+        /// </summary>
+        [JsonProperty(@"required")]
+        public int Required { get; set; }
+    }
+}
diff --git a/osu.Game/Beatmaps/BeatmapSetNominationStatus.cs b/osu.Game/Beatmaps/BeatmapSetNominationStatus.cs
new file mode 100644
index 0000000000..6a19616a97
--- /dev/null
+++ b/osu.Game/Beatmaps/BeatmapSetNominationStatus.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 Newtonsoft.Json;
+
+namespace osu.Game.Beatmaps
+{
+    /// <summary>
+    /// Contains information about the current nomination status of a beatmap set.
+    /// </summary>
+    public class BeatmapSetNominationStatus
+    {
+        /// <summary>
+        /// The current number of nominations that the set has received.
+        /// </summary>
+        [JsonProperty(@"current")]
+        public int Current { get; set; }
+
+        /// <summary>
+        /// The number of nominations required so that the map is eligible for qualification.
+        /// </summary>
+        [JsonProperty(@"required")]
+        public int Required { get; set; }
+    }
+}
diff --git a/osu.Game/Beatmaps/IBeatmapSetOnlineInfo.cs b/osu.Game/Beatmaps/IBeatmapSetOnlineInfo.cs
index 6def6ec21d..2982cf9c3a 100644
--- a/osu.Game/Beatmaps/IBeatmapSetOnlineInfo.cs
+++ b/osu.Game/Beatmaps/IBeatmapSetOnlineInfo.cs
@@ -102,5 +102,19 @@ namespace osu.Game.Beatmaps
         /// Total vote counts of user ratings on a scale of 0..10 where 0 is unused (probably will be fixed at API?).
         /// </summary>
         int[]? Ratings { get; }
+
+        /// <summary>
+        /// Contains the current hype status of the beatmap set.
+        /// Non-null only for <see cref="BeatmapSetOnlineStatus.WIP"/>, <see cref="BeatmapSetOnlineStatus.Pending"/>, and <see cref="BeatmapSetOnlineStatus.Qualified"/> sets.
+        /// </summary>
+        /// <remarks>
+        /// See: https://github.com/ppy/osu-web/blob/93930cd02cfbd49724929912597c727c9fbadcd1/app/Models/Beatmapset.php#L155
+        /// </remarks>
+        BeatmapSetHypeStatus? HypeStatus { get; }
+
+        /// <summary>
+        /// Contains the current nomination status of the beatmap set.
+        /// </summary>
+        BeatmapSetNominationStatus? NominationStatus { get; }
     }
 }
diff --git a/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs b/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs
index 47536879b2..db4c45d03f 100644
--- a/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs
@@ -62,6 +62,12 @@ namespace osu.Game.Online.API.Requests.Responses
         [JsonProperty(@"track_id")]
         public int? TrackId { get; set; }
 
+        [JsonProperty(@"hype")]
+        public BeatmapSetHypeStatus? HypeStatus { get; set; }
+
+        [JsonProperty(@"nominations_summary")]
+        public BeatmapSetNominationStatus? NominationStatus { get; set; }
+
         public string Title { get; set; } = string.Empty;
 
         [JsonProperty("title_unicode")]

From 1f405a7e71d399988bac3c19b2c9cd14db502d2e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 17 Oct 2021 21:05:26 +0200
Subject: [PATCH 0812/5547] Display extended statistics on card hover

---
 .../Visual/Beatmaps/TestSceneBeatmapCard.cs   | 10 +++++++++
 .../Beatmaps/Drawables/Cards/BeatmapCard.cs   |  6 +++++
 .../Cards/Statistics/HypesStatistic.cs        | 22 +++++++++++++++++++
 .../Cards/Statistics/NominationsStatistic.cs  | 22 +++++++++++++++++++
 4 files changed, 60 insertions(+)
 create mode 100644 osu.Game/Beatmaps/Drawables/Cards/Statistics/HypesStatistic.cs
 create mode 100644 osu.Game/Beatmaps/Drawables/Cards/Statistics/NominationsStatistic.cs

diff --git a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs
index b56dcb0a43..0f324ed846 100644
--- a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs
+++ b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs
@@ -36,6 +36,16 @@ namespace osu.Game.Tests.Visual.Beatmaps
             withStatistics.FavouriteCount = 284_239;
             withStatistics.PlayCount = 999_001;
             withStatistics.Ranked = DateTimeOffset.Now.AddDays(-45);
+            withStatistics.HypeStatus = new BeatmapSetHypeStatus
+            {
+                Current = 34,
+                Required = 5
+            };
+            withStatistics.NominationStatus = new BeatmapSetNominationStatus
+            {
+                Current = 1,
+                Required = 2
+            };
 
             var undownloadable = getUndownloadableBeatmapSet();
             undownloadable.LastUpdated = DateTimeOffset.Now.AddYears(-1);
diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
index 5d8f0a93cd..7a3d212716 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
@@ -279,6 +279,12 @@ namespace osu.Game.Beatmaps.Drawables.Cards
 
         private IEnumerable<BeatmapCardStatistic> createStatistics()
         {
+            if (beatmapSet.HypeStatus != null)
+                yield return new HypesStatistic(beatmapSet.HypeStatus);
+
+            if (beatmapSet.NominationStatus != null)
+                yield return new NominationsStatistic(beatmapSet.NominationStatus);
+
             yield return new FavouritesStatistic(beatmapSet);
             yield return new PlayCountStatistic(beatmapSet);
 
diff --git a/osu.Game/Beatmaps/Drawables/Cards/Statistics/HypesStatistic.cs b/osu.Game/Beatmaps/Drawables/Cards/Statistics/HypesStatistic.cs
new file mode 100644
index 0000000000..3fe31c7a41
--- /dev/null
+++ b/osu.Game/Beatmaps/Drawables/Cards/Statistics/HypesStatistic.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.Extensions.LocalisationExtensions;
+using osu.Framework.Graphics.Sprites;
+using osu.Game.Resources.Localisation.Web;
+
+namespace osu.Game.Beatmaps.Drawables.Cards.Statistics
+{
+    /// <summary>
+    /// Shows the number of current hypes that a map has received, as well as the number of hypes required for nomination.
+    /// </summary>
+    public class HypesStatistic : BeatmapCardStatistic
+    {
+        public HypesStatistic(BeatmapSetHypeStatus hypeStatus)
+        {
+            Icon = FontAwesome.Solid.Bullhorn;
+            Text = hypeStatus.Current.ToLocalisableString();
+            TooltipText = BeatmapsStrings.HypeRequiredText(hypeStatus.Current.ToLocalisableString(), hypeStatus.Required.ToLocalisableString());
+        }
+    }
+}
diff --git a/osu.Game/Beatmaps/Drawables/Cards/Statistics/NominationsStatistic.cs b/osu.Game/Beatmaps/Drawables/Cards/Statistics/NominationsStatistic.cs
new file mode 100644
index 0000000000..f09269a615
--- /dev/null
+++ b/osu.Game/Beatmaps/Drawables/Cards/Statistics/NominationsStatistic.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.Extensions.LocalisationExtensions;
+using osu.Framework.Graphics.Sprites;
+using osu.Game.Resources.Localisation.Web;
+
+namespace osu.Game.Beatmaps.Drawables.Cards.Statistics
+{
+    /// <summary>
+    /// Shows the number of current nominations that a map has received, as well as the number of nominations required for qualification.
+    /// </summary>
+    public class NominationsStatistic : BeatmapCardStatistic
+    {
+        public NominationsStatistic(BeatmapSetNominationStatus nominationStatus)
+        {
+            Icon = FontAwesome.Solid.ThumbsUp;
+            Text = nominationStatus.Current.ToLocalisableString();
+            TooltipText = BeatmapsStrings.NominationsRequiredText(nominationStatus.Current.ToLocalisableString(), nominationStatus.Required.ToLocalisableString());
+        }
+    }
+}

From 0e09edfce21999f6a06f5830067419b31f400161 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 7 Nov 2021 21:20:21 +0100
Subject: [PATCH 0813/5547] Do not show nomination info if hype info not
 present to match web

---
 osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs | 5 +++++
 osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs       | 4 +++-
 2 files changed, 8 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs
index 0f324ed846..b298a29c80 100644
--- a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs
+++ b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs
@@ -55,6 +55,11 @@ namespace osu.Game.Tests.Visual.Beatmaps
             someDifficulties.Status = BeatmapSetOnlineStatus.Qualified;
             someDifficulties.HasFavourited = true;
             someDifficulties.FavouriteCount = 1;
+            someDifficulties.NominationStatus = new BeatmapSetNominationStatus
+            {
+                Current = 2,
+                Required = 2
+            };
 
             var manyDifficulties = getManyDifficultiesBeatmapSet(100);
             manyDifficulties.Status = BeatmapSetOnlineStatus.Pending;
diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
index 7a3d212716..c53c1abd8d 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
@@ -282,7 +282,9 @@ namespace osu.Game.Beatmaps.Drawables.Cards
             if (beatmapSet.HypeStatus != null)
                 yield return new HypesStatistic(beatmapSet.HypeStatus);
 
-            if (beatmapSet.NominationStatus != null)
+            // web does not show nominations unless hypes are also present.
+            // see: https://github.com/ppy/osu-web/blob/8ed7d071fd1d3eaa7e43cf0e4ff55ca2fef9c07c/resources/assets/lib/beatmapset-panel.tsx#L443
+            if (beatmapSet.HypeStatus != null && beatmapSet.NominationStatus != null)
                 yield return new NominationsStatistic(beatmapSet.NominationStatus);
 
             yield return new FavouritesStatistic(beatmapSet);

From cc0bcf6b2c2187a8a5adaeb5e360f2a4d6705569 Mon Sep 17 00:00:00 2001
From: Chinmay Patil <chinmaytlc@gmail.com>
Date: Sun, 7 Nov 2021 17:44:50 -0700
Subject: [PATCH 0814/5547] Clean up judgement checks and clean up
 setter/getter for UR counter Text

---
 .../Screens/Play/HUD/UnstableRateCounter.cs   | 52 +++++++------------
 1 file changed, 18 insertions(+), 34 deletions(-)

diff --git a/osu.Game/Screens/Play/HUD/UnstableRateCounter.cs b/osu.Game/Screens/Play/HUD/UnstableRateCounter.cs
index 7e6e3d9b39..a9d6066e09 100644
--- a/osu.Game/Screens/Play/HUD/UnstableRateCounter.cs
+++ b/osu.Game/Screens/Play/HUD/UnstableRateCounter.cs
@@ -4,8 +4,8 @@
 using System;
 using System.Collections.Generic;
 using System.Linq;
-using JetBrains.Annotations;
 using osu.Framework.Allocation;
+using osu.Framework.Extensions.LocalisationExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Sprites;
@@ -30,9 +30,7 @@ namespace osu.Game.Screens.Play.HUD
 
         private readonly List<double> hitOffsets = new List<double>();
 
-        //May be able to remove the CanBeNull as ScoreProcessor should exist everywhere, for example, in the skin editor it is cached.
-        [CanBeNull]
-        [Resolved(CanBeNull = true)]
+        [Resolved]
         private ScoreProcessor scoreProcessor { get; set; }
 
         public UnstableRateCounter()
@@ -46,12 +44,15 @@ namespace osu.Game.Screens.Play.HUD
             Colour = colours.BlueLighter;
         }
 
+        private bool isUrInvalid(JudgementResult judgement)
+        {
+            return judgement.HitObject.HitWindows is HitWindows.EmptyHitWindows || !judgement.IsHit;
+        }
+
         protected override void LoadComplete()
         {
             base.LoadComplete();
 
-            if (scoreProcessor == null) return;
-
             scoreProcessor.NewJudgement += onJudgementAdded;
             scoreProcessor.JudgementReverted += onJudgementReverted;
         }
@@ -68,23 +69,15 @@ namespace osu.Game.Screens.Play.HUD
 
         private void onJudgementAdded(JudgementResult judgement)
         {
-            if (!(judgement.HitObject.HitWindows is HitWindows.EmptyHitWindows) && judgement.IsHit)
-            {
-                hitOffsets.Add(judgement.TimeOffset);
-            }
+            if (isUrInvalid(judgement)) return;
 
+            hitOffsets.Add(judgement.TimeOffset);
             updateUr();
         }
 
-        // If a judgement was reverted successfully, remove the item from the hitOffsets list.
         private void onJudgementReverted(JudgementResult judgement)
         {
-            //Score Processor Conditions to revert
-            if (judgement.FailedAtJudgement || !judgement.Type.IsScorable())
-                return;
-            //UR Conditions to Revert
-            if (judgement.HitObject.HitWindows is HitWindows.EmptyHitWindows || !judgement.IsHit)
-                return;
+            if (judgement.FailedAtJudgement || isUrInvalid(judgement)) return;
 
             hitOffsets.RemoveAt(hitOffsets.Count - 1);
             updateUr();
@@ -109,7 +102,7 @@ namespace osu.Game.Screens.Play.HUD
 
         protected override LocalisableString FormatCount(double count)
         {
-            return count.ToString("0.00 UR");
+            return count.ToString("0.00");
         }
 
         protected override IHasText CreateText() => new TextComponent
@@ -121,8 +114,6 @@ namespace osu.Game.Screens.Play.HUD
         {
             base.Dispose(isDisposing);
 
-            if (scoreProcessor == null) return;
-
             scoreProcessor.NewJudgement -= onJudgementAdded;
             scoreProcessor.JudgementReverted -= onJudgementReverted;
         }
@@ -131,17 +122,18 @@ namespace osu.Game.Screens.Play.HUD
         {
             public LocalisableString Text
             {
-                get => intPart.Text;
+                get => fullValue.ToLocalisableString("0.00 UR");
                 set
                 {
-                    //Not too sure about this, is there a better way to go about doing this?
-                    splitValue = value.ToString().Split('.');
-                    intPart.Text = splitValue[0];
-                    decimalPart.Text = splitValue[1];
+                    fullValue = Convert.ToDouble(value.ToString());
+                    intPart.Text = fullValue.ToLocalisableString("0");
+                    decimalPart.Text = (fullValue - Math.Truncate(fullValue))
+                        .ToLocalisableString(".00 UR");
                 }
             }
 
-            private string[] splitValue;
+            private double fullValue;
+
             private readonly OsuSpriteText intPart;
             private readonly OsuSpriteText decimalPart;
 
@@ -160,14 +152,6 @@ namespace osu.Game.Screens.Play.HUD
                             Origin = Anchor.BottomLeft,
                             Font = OsuFont.Numeric.With(size: 16, fixedWidth: true)
                         },
-                        new OsuSpriteText
-                        {
-                            Anchor = Anchor.BottomLeft,
-                            Origin = Anchor.BottomLeft,
-                            Font = OsuFont.Numeric.With(size: 8, fixedWidth: true),
-                            Text = ".",
-                            Padding = new MarginPadding { Bottom = 1.5f },
-                        },
                         decimalPart = new OsuSpriteText
                         {
                             Anchor = Anchor.BottomLeft,

From bd35a3b7ba7c881c6727781a8787832a6a9be47d Mon Sep 17 00:00:00 2001
From: Sebastian Krajewski <mail@wieku.me>
Date: Mon, 8 Nov 2021 01:53:51 +0100
Subject: [PATCH 0815/5547] Change currentStrain to 0 for standard mode skills

---
 osu.Game.Rulesets.Osu.Tests/OsuDifficultyCalculatorTest.cs | 6 +++---
 osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs             | 2 +-
 osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs      | 3 ++-
 osu.Game.Rulesets.Osu/Difficulty/Skills/Speed.cs           | 4 ++--
 4 files changed, 8 insertions(+), 7 deletions(-)

diff --git a/osu.Game.Rulesets.Osu.Tests/OsuDifficultyCalculatorTest.cs b/osu.Game.Rulesets.Osu.Tests/OsuDifficultyCalculatorTest.cs
index 7cd06c5225..ffb8b81f3d 100644
--- a/osu.Game.Rulesets.Osu.Tests/OsuDifficultyCalculatorTest.cs
+++ b/osu.Game.Rulesets.Osu.Tests/OsuDifficultyCalculatorTest.cs
@@ -16,12 +16,12 @@ namespace osu.Game.Rulesets.Osu.Tests
         protected override string ResourceAssembly => "osu.Game.Rulesets.Osu";
 
         [TestCase(6.5295339534769958d, "diffcalc-test")]
-        [TestCase(1.1514260533755143d, "zero-length-sliders")]
+        [TestCase(1.1509415392666302d, "zero-length-sliders")]
         public void Test(double expected, string name)
             => base.Test(expected, name);
 
-        [TestCase(9.047752485219954d, "diffcalc-test")]
-        [TestCase(1.3985711787077566d, "zero-length-sliders")]
+        [TestCase(9.0477401376769784d, "diffcalc-test")]
+        [TestCase(1.3975708804327773d, "zero-length-sliders")]
         public void TestClockRateAdjusted(double expected, string name)
             => Test(expected, name, new OsuModDoubleTime());
 
diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
index a054b46366..7b644f3f35 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
@@ -24,7 +24,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
         private const double wide_angle_multiplier = 1.5;
         private const double acute_angle_multiplier = 2.0;
 
-        private double currentStrain = 1;
+        private double currentStrain;
 
         private double skillMultiplier => 23.25;
         private double strainDecayBase => 0.15;
diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
index e3abe7d700..466f0556ab 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
@@ -23,7 +23,8 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
         private double strainDecayBase => 0.15;
         protected override double DecayWeight => 1.0;
         protected override int HistoryLength => 10; // Look back for 10 notes is added for the sake of flashlight calculations.
-        private double currentStrain = 1;
+
+        private double currentStrain;
 
         private double strainValueOf(DifficultyHitObject current)
         {
diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Speed.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Speed.cs
index cae6b8e01c..24881d9c47 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Speed.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Speed.cs
@@ -24,8 +24,8 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
         private double skillMultiplier => 1375;
         private double strainDecayBase => 0.3;
 
-        private double currentStrain = 1;
-        private double currentRhythm = 1;
+        private double currentStrain;
+        private double currentRhythm;
 
         protected override int ReducedSectionCount => 5;
         protected override double DifficultyMultiplier => 1.04;

From a8c9ad73c1bc1bcf9da155b5a14b09c5146803fe Mon Sep 17 00:00:00 2001
From: Chinmay Patil <chinmaytlc@gmail.com>
Date: Sun, 7 Nov 2021 18:06:13 -0700
Subject: [PATCH 0816/5547] Make UR Counter isValid into a bindable boolean

---
 .../Screens/Play/HUD/UnstableRateCounter.cs    | 18 ++++++------------
 1 file changed, 6 insertions(+), 12 deletions(-)

diff --git a/osu.Game/Screens/Play/HUD/UnstableRateCounter.cs b/osu.Game/Screens/Play/HUD/UnstableRateCounter.cs
index a9d6066e09..f7263b29e9 100644
--- a/osu.Game/Screens/Play/HUD/UnstableRateCounter.cs
+++ b/osu.Game/Screens/Play/HUD/UnstableRateCounter.cs
@@ -5,6 +5,7 @@ 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;
@@ -27,6 +28,7 @@ namespace osu.Game.Screens.Play.HUD
         protected override double RollingDuration => 750;
 
         private const float alpha_when_invalid = 0.3f;
+        private readonly Bindable<bool> valid = new Bindable<bool>();
 
         private readonly List<double> hitOffsets = new List<double>();
 
@@ -42,6 +44,8 @@ namespace osu.Game.Screens.Play.HUD
         private void load(OsuColour colours, BeatmapDifficultyCache difficultyCache)
         {
             Colour = colours.BlueLighter;
+            valid.BindValueChanged(e =>
+                DrawableCount.FadeTo(e.NewValue ? 1 : alpha_when_invalid, 1000, Easing.OutQuint));
         }
 
         private bool isUrInvalid(JudgementResult judgement)
@@ -57,16 +61,6 @@ namespace osu.Game.Screens.Play.HUD
             scoreProcessor.JudgementReverted += onJudgementReverted;
         }
 
-        private bool isValid;
-
-        private void setValid(bool valid)
-        {
-            if (isValid == valid) return;
-
-            DrawableCount.FadeTo(valid ? 1 : alpha_when_invalid, 1000, Easing.OutQuint);
-            isValid = valid;
-        }
-
         private void onJudgementAdded(JudgementResult judgement)
         {
             if (isUrInvalid(judgement)) return;
@@ -91,12 +85,12 @@ namespace osu.Game.Screens.Play.HUD
                 double mean = hitOffsets.Average();
                 double squares = hitOffsets.Select(offset => Math.Pow(offset - mean, 2)).Sum();
                 Current.Value = Math.Sqrt(squares / hitOffsets.Count) * 10;
-                setValid(true);
+                valid.Value = true;
             }
             else
             {
                 Current.Value = 0;
-                setValid(false);
+                valid.Value = false;
             }
         }
 

From e88b0e55875c682987eff45b521f58d6c6391392 Mon Sep 17 00:00:00 2001
From: Sebastian Krajewski <mail@wieku.me>
Date: Mon, 8 Nov 2021 02:08:12 +0100
Subject: [PATCH 0817/5547] Fix tests

---
 osu.Game.Rulesets.Osu.Tests/OsuDifficultyCalculatorTest.cs | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Rulesets.Osu.Tests/OsuDifficultyCalculatorTest.cs b/osu.Game.Rulesets.Osu.Tests/OsuDifficultyCalculatorTest.cs
index c88f70021b..b0e173e752 100644
--- a/osu.Game.Rulesets.Osu.Tests/OsuDifficultyCalculatorTest.cs
+++ b/osu.Game.Rulesets.Osu.Tests/OsuDifficultyCalculatorTest.cs
@@ -16,12 +16,12 @@ namespace osu.Game.Rulesets.Osu.Tests
         protected override string ResourceAssembly => "osu.Game.Rulesets.Osu";
 
         [TestCase(6.6975550434910005d, "diffcalc-test")]
-        [TestCase(1.4673500058356748d, "zero-length-sliders")]
+        [TestCase(1.4670676815251105d, "zero-length-sliders")]
         public void Test(double expected, string name)
             => base.Test(expected, name);
 
-        [TestCase(8.938989502378238d, "diffcalc-test")]
-        [TestCase(1.779323508403831d, "zero-length-sliders")]
+        [TestCase(8.9389769779826267d, "diffcalc-test")]
+        [TestCase(1.7786917985891204d, "zero-length-sliders")]
         public void TestClockRateAdjusted(double expected, string name)
             => Test(expected, name, new OsuModDoubleTime());
 

From ac5d9853d39a3b99da8052b27b9cba9723b97737 Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Sun, 7 Nov 2021 17:25:33 -0800
Subject: [PATCH 0818/5547] Fix loading spinner potentially showing on
 statistics unavailable message

---
 osu.Game/Screens/Ranking/Statistics/StatisticsPanel.cs | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/osu.Game/Screens/Ranking/Statistics/StatisticsPanel.cs b/osu.Game/Screens/Ranking/Statistics/StatisticsPanel.cs
index bc62bcf2b2..73359e61bc 100644
--- a/osu.Game/Screens/Ranking/Statistics/StatisticsPanel.cs
+++ b/osu.Game/Screens/Ranking/Statistics/StatisticsPanel.cs
@@ -76,6 +76,8 @@ namespace osu.Game.Screens.Ranking.Statistics
 
             if (newScore.HitEvents == null || newScore.HitEvents.Count == 0)
             {
+                spinner.Hide();
+
                 content.Add(new FillFlowContainer
                 {
                     RelativeSizeAxes = Axes.Both,

From 9e13c20bd4d702642d4f367a505e200d1ba4a9a8 Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Sun, 7 Nov 2021 19:35:30 -0800
Subject: [PATCH 0819/5547] Move spinner hiding before newScore null check

---
 osu.Game/Screens/Ranking/Statistics/StatisticsPanel.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/Ranking/Statistics/StatisticsPanel.cs b/osu.Game/Screens/Ranking/Statistics/StatisticsPanel.cs
index 73359e61bc..26dc3165f8 100644
--- a/osu.Game/Screens/Ranking/Statistics/StatisticsPanel.cs
+++ b/osu.Game/Screens/Ranking/Statistics/StatisticsPanel.cs
@@ -69,6 +69,8 @@ namespace osu.Game.Screens.Ranking.Statistics
             foreach (var child in content)
                 child.FadeOut(150).Expire();
 
+            spinner.Hide();
+
             var newScore = score.NewValue;
 
             if (newScore == null)
@@ -76,8 +78,6 @@ namespace osu.Game.Screens.Ranking.Statistics
 
             if (newScore.HitEvents == null || newScore.HitEvents.Count == 0)
             {
-                spinner.Hide();
-
                 content.Add(new FillFlowContainer
                 {
                     RelativeSizeAxes = Axes.Both,

From fb495d77ce61ed833b26f8dc96f4b21d00f3670c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 8 Nov 2021 13:22:57 +0900
Subject: [PATCH 0820/5547] Implement `TooltipText` directly

---
 .../Drawables/Cards/Statistics/BeatmapCardStatistic.cs         | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/osu.Game/Beatmaps/Drawables/Cards/Statistics/BeatmapCardStatistic.cs b/osu.Game/Beatmaps/Drawables/Cards/Statistics/BeatmapCardStatistic.cs
index 95d99b9128..f46926284f 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/Statistics/BeatmapCardStatistic.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/Statistics/BeatmapCardStatistic.cs
@@ -31,7 +31,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards.Statistics
             set => spriteText.Text = value;
         }
 
-        protected LocalisableString TooltipText { get; set; }
+        public LocalisableString TooltipText { get; protected set; }
 
         private readonly SpriteIcon spriteIcon;
         private readonly OsuSpriteText spriteText;
@@ -72,7 +72,6 @@ namespace osu.Game.Beatmaps.Drawables.Cards.Statistics
 
         #region Tooltip implementation
 
-        LocalisableString IHasTooltip.TooltipText => TooltipText;
         public virtual ITooltip GetCustomTooltip() => null;
         public virtual object TooltipContent => null;
 

From 43f87844e24c35357c459ec46216fca89e50d606 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 8 Nov 2021 13:27:04 +0900
Subject: [PATCH 0821/5547] Add text to test cards to better explain their
 purpose

---
 osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs
index b298a29c80..55e51a93f4 100644
--- a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs
+++ b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs
@@ -32,6 +32,7 @@ namespace osu.Game.Tests.Visual.Beatmaps
             normal.HasStoryboard = true;
 
             var withStatistics = CreateAPIBeatmapSet(Ruleset.Value);
+            withStatistics.Title = withStatistics.TitleUnicode = "play favourite stats";
             withStatistics.Status = BeatmapSetOnlineStatus.Approved;
             withStatistics.FavouriteCount = 284_239;
             withStatistics.PlayCount = 999_001;
@@ -51,6 +52,7 @@ namespace osu.Game.Tests.Visual.Beatmaps
             undownloadable.LastUpdated = DateTimeOffset.Now.AddYears(-1);
 
             var someDifficulties = getManyDifficultiesBeatmapSet(11);
+            someDifficulties.Title = someDifficulties.TitleUnicode = "favourited";
             someDifficulties.Title = someDifficulties.TitleUnicode = "some difficulties";
             someDifficulties.Status = BeatmapSetOnlineStatus.Qualified;
             someDifficulties.HasFavourited = true;
@@ -65,12 +67,15 @@ namespace osu.Game.Tests.Visual.Beatmaps
             manyDifficulties.Status = BeatmapSetOnlineStatus.Pending;
 
             var explicitMap = CreateAPIBeatmapSet(Ruleset.Value);
+            explicitMap.Title = someDifficulties.TitleUnicode = "explicit beatmap";
             explicitMap.HasExplicitContent = true;
 
             var featuredMap = CreateAPIBeatmapSet(Ruleset.Value);
+            featuredMap.Title = someDifficulties.TitleUnicode = "featured artist beatmap";
             featuredMap.TrackId = 1;
 
             var explicitFeaturedMap = CreateAPIBeatmapSet(Ruleset.Value);
+            explicitFeaturedMap.Title = someDifficulties.TitleUnicode = "explicit featured artist";
             explicitFeaturedMap.HasExplicitContent = true;
             explicitFeaturedMap.TrackId = 2;
 

From 6b6dd93e9e75e38bd73bd40b5a943f07c19b57d4 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 8 Nov 2021 14:17:47 +0900
Subject: [PATCH 0822/5547] Fix `LinkFlowContainer` not creating user links
 supporting full `IUser` specification

---
 .../Graphics/Containers/LinkFlowContainer.cs  | 10 +++----
 osu.Game/Online/Chat/MessageFormatter.cs      |  8 ++---
 osu.Game/OsuGame.cs                           | 29 ++++++++++++-------
 osu.Game/Overlays/Chat/ChatLine.cs            |  2 +-
 .../Sections/Recent/DrawableRecentActivity.cs |  2 +-
 5 files changed, 29 insertions(+), 22 deletions(-)

diff --git a/osu.Game/Graphics/Containers/LinkFlowContainer.cs b/osu.Game/Graphics/Containers/LinkFlowContainer.cs
index 41b7df228e..1d286d3487 100644
--- a/osu.Game/Graphics/Containers/LinkFlowContainer.cs
+++ b/osu.Game/Graphics/Containers/LinkFlowContainer.cs
@@ -46,7 +46,7 @@ namespace osu.Game.Graphics.Containers
                 AddText(text[previousLinkEnd..link.Index]);
 
                 string displayText = text.Substring(link.Index, link.Length);
-                string linkArgument = link.Argument;
+                object linkArgument = link.Argument;
                 string tooltip = displayText == link.Url ? null : link.Url;
 
                 AddLink(displayText, link.Action, linkArgument, tooltip);
@@ -62,16 +62,16 @@ namespace osu.Game.Graphics.Containers
         public void AddLink(LocalisableString text, Action action, string tooltipText = null, Action<SpriteText> creationParameters = null)
             => createLink(CreateChunkFor(text, true, CreateSpriteText, creationParameters), new LinkDetails(LinkAction.Custom, string.Empty), tooltipText, action);
 
-        public void AddLink(LocalisableString text, LinkAction action, string argument, string tooltipText = null, Action<SpriteText> creationParameters = null)
+        public void AddLink(LocalisableString text, LinkAction action, object argument, string tooltipText = null, Action<SpriteText> creationParameters = null)
             => createLink(CreateChunkFor(text, true, CreateSpriteText, creationParameters), new LinkDetails(action, argument), tooltipText);
 
-        public void AddLink(IEnumerable<SpriteText> text, LinkAction action, string linkArgument, string tooltipText = null)
+        public void AddLink(IEnumerable<SpriteText> text, LinkAction action, object linkArgument, string tooltipText = null)
         {
             createLink(new TextPartManual(text), new LinkDetails(action, linkArgument), tooltipText);
         }
 
         public void AddUserLink(IUser user, Action<SpriteText> creationParameters = null)
-            => createLink(CreateChunkFor(user.Username, true, CreateSpriteText, creationParameters), new LinkDetails(LinkAction.OpenUserProfile, user.OnlineID.ToString()), "view profile");
+            => createLink(CreateChunkFor(user.Username, true, CreateSpriteText, creationParameters), new LinkDetails(LinkAction.OpenUserProfile, user), "view profile");
 
         private void createLink(ITextPart textPart, LinkDetails link, LocalisableString tooltipText, Action action = null)
         {
@@ -83,7 +83,7 @@ namespace osu.Game.Graphics.Containers
                     game.HandleLink(link);
                 // fallback to handle cases where OsuGame is not available, ie. tournament client.
                 else if (link.Action == LinkAction.External)
-                    host.OpenUrlExternally(link.Argument);
+                    host.OpenUrlExternally(link.Argument.ToString());
             };
 
             AddPart(new TextLink(textPart, tooltipText, onClickAction));
diff --git a/osu.Game/Online/Chat/MessageFormatter.cs b/osu.Game/Online/Chat/MessageFormatter.cs
index 5e0f66443b..92911f0f51 100644
--- a/osu.Game/Online/Chat/MessageFormatter.cs
+++ b/osu.Game/Online/Chat/MessageFormatter.cs
@@ -320,9 +320,9 @@ namespace osu.Game.Online.Chat
     {
         public readonly LinkAction Action;
 
-        public readonly string Argument;
+        public readonly object Argument;
 
-        public LinkDetails(LinkAction action, string argument)
+        public LinkDetails(LinkAction action, object argument)
         {
             Action = action;
             Argument = argument;
@@ -351,9 +351,9 @@ namespace osu.Game.Online.Chat
         public int Index;
         public int Length;
         public LinkAction Action;
-        public string Argument;
+        public object Argument;
 
-        public Link(string url, int startIndex, int length, LinkAction action, string argument)
+        public Link(string url, int startIndex, int length, LinkAction action, object argument)
         {
             Url = url;
             Index = startIndex;
diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index ea8682e696..bf757a153f 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -289,25 +289,27 @@ namespace osu.Game
         /// <param name="link">The link to load.</param>
         public void HandleLink(LinkDetails link) => Schedule(() =>
         {
+            string argString = link.Argument.ToString();
+
             switch (link.Action)
             {
                 case LinkAction.OpenBeatmap:
                     // TODO: proper query params handling
-                    if (int.TryParse(link.Argument.Contains('?') ? link.Argument.Split('?')[0] : link.Argument, out int beatmapId))
+                    if (int.TryParse(argString.Contains('?') ? argString.Split('?')[0] : argString, out int beatmapId))
                         ShowBeatmap(beatmapId);
                     break;
 
                 case LinkAction.OpenBeatmapSet:
-                    if (int.TryParse(link.Argument, out int setId))
+                    if (int.TryParse(argString, out int setId))
                         ShowBeatmapSet(setId);
                     break;
 
                 case LinkAction.OpenChannel:
-                    ShowChannel(link.Argument);
+                    ShowChannel(argString);
                     break;
 
                 case LinkAction.SearchBeatmapSet:
-                    SearchBeatmapSet(link.Argument);
+                    SearchBeatmapSet(argString);
                     break;
 
                 case LinkAction.OpenEditorTimestamp:
@@ -321,26 +323,31 @@ namespace osu.Game
                     break;
 
                 case LinkAction.External:
-                    OpenUrlExternally(link.Argument);
+                    OpenUrlExternally(argString);
                     break;
 
                 case LinkAction.OpenUserProfile:
-                    ShowUser(int.TryParse(link.Argument, out int userId)
-                        ? new APIUser { Id = userId }
-                        : new APIUser { Username = link.Argument });
+                    if (!(link.Argument is IUser user))
+                    {
+                        user = int.TryParse(argString, out int userId)
+                            ? new APIUser { Id = userId }
+                            : new APIUser { Username = argString };
+                    }
+
+                    ShowUser(user);
 
                     break;
 
                 case LinkAction.OpenWiki:
-                    ShowWiki(link.Argument);
+                    ShowWiki(argString);
                     break;
 
                 case LinkAction.OpenChangelog:
-                    if (string.IsNullOrEmpty(link.Argument))
+                    if (string.IsNullOrEmpty(argString))
                         ShowChangelogListing();
                     else
                     {
-                        string[] changelogArgs = link.Argument.Split("/");
+                        string[] changelogArgs = argString.Split("/");
                         ShowChangelogBuild(changelogArgs[0], changelogArgs[1]);
                     }
 
diff --git a/osu.Game/Overlays/Chat/ChatLine.cs b/osu.Game/Overlays/Chat/ChatLine.cs
index 97cd913b56..87d1b1a3ad 100644
--- a/osu.Game/Overlays/Chat/ChatLine.cs
+++ b/osu.Game/Overlays/Chat/ChatLine.cs
@@ -209,7 +209,7 @@ namespace osu.Game.Overlays.Chat
             username.Text = $@"{message.Sender.Username}" + (senderHasBackground || message.IsAction ? "" : ":");
 
             // remove non-existent channels from the link list
-            message.Links.RemoveAll(link => link.Action == LinkAction.OpenChannel && chatManager?.AvailableChannels.Any(c => c.Name == link.Argument) != true);
+            message.Links.RemoveAll(link => link.Action == LinkAction.OpenChannel && chatManager?.AvailableChannels.Any(c => c.Name == link.Argument.ToString()) != true);
 
             ContentFlow.Clear();
             ContentFlow.AddLinks(message.DisplayContent, message.Links);
diff --git a/osu.Game/Overlays/Profile/Sections/Recent/DrawableRecentActivity.cs b/osu.Game/Overlays/Profile/Sections/Recent/DrawableRecentActivity.cs
index 49b46f7e7a..cb8dae0bbc 100644
--- a/osu.Game/Overlays/Profile/Sections/Recent/DrawableRecentActivity.cs
+++ b/osu.Game/Overlays/Profile/Sections/Recent/DrawableRecentActivity.cs
@@ -216,7 +216,7 @@ namespace osu.Game.Overlays.Profile.Sections.Recent
         private void addBeatmapsetLink()
             => content.AddLink(activity.Beatmapset?.Title, LinkAction.OpenBeatmapSet, getLinkArgument(activity.Beatmapset?.Url), creationParameters: t => t.Font = getLinkFont());
 
-        private string getLinkArgument(string url) => MessageFormatter.GetLinkDetails($"{api.APIEndpointUrl}{url}").Argument;
+        private string getLinkArgument(string url) => MessageFormatter.GetLinkDetails($"{api.APIEndpointUrl}{url}").Argument.ToString();
 
         private FontUsage getLinkFont(FontWeight fontWeight = FontWeight.Regular)
             => OsuFont.GetFont(size: font_size, weight: fontWeight, italics: true);

From 5b5e3dc4a2ee03256aac220341ad419d20df9e87 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 8 Nov 2021 14:33:15 +0900
Subject: [PATCH 0823/5547] Revert incorrect mod nullable parameter
 specification

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

diff --git a/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs b/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs
index 6630530b65..a6f3a75302 100644
--- a/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs
+++ b/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs
@@ -124,7 +124,7 @@ namespace osu.Game.Rulesets.Difficulty
         /// </summary>
         /// <param name="mods">The original list of <see cref="Mod"/>s.</param>
         /// <param name="cancellationToken">The cancellation token.</param>
-        private void preProcess(IEnumerable<Mod> mods = null, CancellationToken cancellationToken = default)
+        private void preProcess(IEnumerable<Mod> mods, CancellationToken cancellationToken = default)
         {
             playableMods = mods.Select(m => m.DeepClone()).ToArray();
 

From 97345ac9e6123c8fc3e990bc5fdc244c7ba14206 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 8 Nov 2021 14:33:32 +0900
Subject: [PATCH 0824/5547] Remove unnecessary `TimeSpan timeout` parameter
 (`CancellationToken` can now be used)

---
 osu.Game/Beatmaps/IWorkingBeatmap.cs          |   4 +-
 osu.Game/Beatmaps/WorkingBeatmap.cs           | 170 +++++++++---------
 .../Play/HUD/PerformancePointsCounter.cs      |   2 +-
 3 files changed, 85 insertions(+), 91 deletions(-)

diff --git a/osu.Game/Beatmaps/IWorkingBeatmap.cs b/osu.Game/Beatmaps/IWorkingBeatmap.cs
index 1e46e265ac..ed100d1876 100644
--- a/osu.Game/Beatmaps/IWorkingBeatmap.cs
+++ b/osu.Game/Beatmaps/IWorkingBeatmap.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.Threading;
@@ -57,11 +56,10 @@ namespace osu.Game.Beatmaps
         /// </summary>
         /// <param name="ruleset">The <see cref="RulesetInfo"/> to create a playable <see cref="IBeatmap"/> for.</param>
         /// <param name="mods">The <see cref="Mod"/>s to apply to the <see cref="IBeatmap"/>.</param>
-        /// <param name="timeout">The maximum length in milliseconds to wait for load to complete. Defaults to 10,000ms.</param>
         /// <param name="token">Cancellation token that cancels the beatmap loading process.</param>
         /// <returns>The converted <see cref="IBeatmap"/>.</returns>
         /// <exception cref="BeatmapInvalidForRulesetException">If <see cref="Beatmap"/> could not be converted to <paramref name="ruleset"/>.</exception>
-        IBeatmap GetPlayableBeatmap(RulesetInfo ruleset, IReadOnlyList<Mod> mods = null, TimeSpan? timeout = null, CancellationToken token = default);
+        IBeatmap GetPlayableBeatmap(RulesetInfo ruleset, IReadOnlyList<Mod> mods = null, CancellationToken token = default);
 
         /// <summary>
         /// Load a new audio track instance for this beatmap. This should be called once before accessing <see cref="Track"/>.
diff --git a/osu.Game/Beatmaps/WorkingBeatmap.cs b/osu.Game/Beatmaps/WorkingBeatmap.cs
index a93c50ce74..0527acca8f 100644
--- a/osu.Game/Beatmaps/WorkingBeatmap.cs
+++ b/osu.Game/Beatmaps/WorkingBeatmap.cs
@@ -81,98 +81,94 @@ namespace osu.Game.Beatmaps
         /// <returns>The applicable <see cref="IBeatmapConverter"/>.</returns>
         protected virtual IBeatmapConverter CreateBeatmapConverter(IBeatmap beatmap, Ruleset ruleset) => ruleset.CreateBeatmapConverter(beatmap);
 
-        public virtual IBeatmap GetPlayableBeatmap(RulesetInfo ruleset, IReadOnlyList<Mod> mods = null, TimeSpan? timeout = null, CancellationToken token = default)
+        public virtual IBeatmap GetPlayableBeatmap(RulesetInfo ruleset, IReadOnlyList<Mod> mods = null, CancellationToken token = default)
         {
-            using (var timeoutSource = createTimeoutTokenSource(timeout))
-            using (var linkedTokenSource = CancellationTokenSource.CreateLinkedTokenSource(token, timeoutSource.Token))
+            mods ??= Array.Empty<Mod>();
+
+            var rulesetInstance = ruleset.CreateInstance();
+
+            IBeatmapConverter converter = CreateBeatmapConverter(Beatmap, rulesetInstance);
+
+            // Check if the beatmap can be converted
+            if (Beatmap.HitObjects.Count > 0 && !converter.CanConvert())
+                throw new BeatmapInvalidForRulesetException($"{nameof(Beatmaps.Beatmap)} can not be converted for the ruleset (ruleset: {ruleset.InstantiationInfo}, converter: {converter}).");
+
+            // Apply conversion mods
+            foreach (var mod in mods.OfType<IApplicableToBeatmapConverter>())
             {
-                mods ??= Array.Empty<Mod>();
-
-                var rulesetInstance = ruleset.CreateInstance();
-
-                IBeatmapConverter converter = CreateBeatmapConverter(Beatmap, rulesetInstance);
-
-                // Check if the beatmap can be converted
-                if (Beatmap.HitObjects.Count > 0 && !converter.CanConvert())
-                    throw new BeatmapInvalidForRulesetException($"{nameof(Beatmaps.Beatmap)} can not be converted for the ruleset (ruleset: {ruleset.InstantiationInfo}, converter: {converter}).");
-
-                // Apply conversion mods
-                foreach (var mod in mods.OfType<IApplicableToBeatmapConverter>())
-                {
-                    if (linkedTokenSource.IsCancellationRequested)
-                        throw new BeatmapLoadTimeoutException(BeatmapInfo);
-
-                    mod.ApplyToBeatmapConverter(converter);
-                }
-
-                // Convert
-                IBeatmap converted = converter.Convert(linkedTokenSource.Token);
-
-                // Apply conversion mods to the result
-                foreach (var mod in mods.OfType<IApplicableAfterBeatmapConversion>())
-                {
-                    if (linkedTokenSource.IsCancellationRequested)
-                        throw new BeatmapLoadTimeoutException(BeatmapInfo);
-
-                    mod.ApplyToBeatmap(converted);
-                }
-
-                // Apply difficulty mods
-                if (mods.Any(m => m is IApplicableToDifficulty))
-                {
-                    foreach (var mod in mods.OfType<IApplicableToDifficulty>())
-                    {
-                        if (linkedTokenSource.IsCancellationRequested)
-                            throw new BeatmapLoadTimeoutException(BeatmapInfo);
-
-                        mod.ApplyToDifficulty(converted.Difficulty);
-                    }
-                }
-
-                IBeatmapProcessor processor = rulesetInstance.CreateBeatmapProcessor(converted);
-
-                foreach (var mod in mods.OfType<IApplicableToBeatmapProcessor>())
-                    mod.ApplyToBeatmapProcessor(processor);
-
-                processor?.PreProcess();
-
-                // Compute default values for hitobjects, including creating nested hitobjects in-case they're needed
-                try
-                {
-                    foreach (var obj in converted.HitObjects)
-                    {
-                        if (linkedTokenSource.IsCancellationRequested)
-                            throw new BeatmapLoadTimeoutException(BeatmapInfo);
-
-                        obj.ApplyDefaults(converted.ControlPointInfo, converted.Difficulty, linkedTokenSource.Token);
-                    }
-                }
-                catch (OperationCanceledException)
-                {
+                if (token.IsCancellationRequested)
                     throw new BeatmapLoadTimeoutException(BeatmapInfo);
-                }
 
-                foreach (var mod in mods.OfType<IApplicableToHitObject>())
-                {
-                    foreach (var obj in converted.HitObjects)
-                    {
-                        if (linkedTokenSource.IsCancellationRequested)
-                            throw new BeatmapLoadTimeoutException(BeatmapInfo);
-
-                        mod.ApplyToHitObject(obj);
-                    }
-                }
-
-                processor?.PostProcess();
-
-                foreach (var mod in mods.OfType<IApplicableToBeatmap>())
-                {
-                    linkedTokenSource.Token.ThrowIfCancellationRequested();
-                    mod.ApplyToBeatmap(converted);
-                }
-
-                return converted;
+                mod.ApplyToBeatmapConverter(converter);
             }
+
+            // Convert
+            IBeatmap converted = converter.Convert(token);
+
+            // Apply conversion mods to the result
+            foreach (var mod in mods.OfType<IApplicableAfterBeatmapConversion>())
+            {
+                if (token.IsCancellationRequested)
+                    throw new BeatmapLoadTimeoutException(BeatmapInfo);
+
+                mod.ApplyToBeatmap(converted);
+            }
+
+            // Apply difficulty mods
+            if (mods.Any(m => m is IApplicableToDifficulty))
+            {
+                foreach (var mod in mods.OfType<IApplicableToDifficulty>())
+                {
+                    if (token.IsCancellationRequested)
+                        throw new BeatmapLoadTimeoutException(BeatmapInfo);
+
+                    mod.ApplyToDifficulty(converted.Difficulty);
+                }
+            }
+
+            IBeatmapProcessor processor = rulesetInstance.CreateBeatmapProcessor(converted);
+
+            foreach (var mod in mods.OfType<IApplicableToBeatmapProcessor>())
+                mod.ApplyToBeatmapProcessor(processor);
+
+            processor?.PreProcess();
+
+            // Compute default values for hitobjects, including creating nested hitobjects in-case they're needed
+            try
+            {
+                foreach (var obj in converted.HitObjects)
+                {
+                    if (token.IsCancellationRequested)
+                        throw new BeatmapLoadTimeoutException(BeatmapInfo);
+
+                    obj.ApplyDefaults(converted.ControlPointInfo, converted.Difficulty, token);
+                }
+            }
+            catch (OperationCanceledException)
+            {
+                throw new BeatmapLoadTimeoutException(BeatmapInfo);
+            }
+
+            foreach (var mod in mods.OfType<IApplicableToHitObject>())
+            {
+                foreach (var obj in converted.HitObjects)
+                {
+                    if (token.IsCancellationRequested)
+                        throw new BeatmapLoadTimeoutException(BeatmapInfo);
+
+                    mod.ApplyToHitObject(obj);
+                }
+            }
+
+            processor?.PostProcess();
+
+            foreach (var mod in mods.OfType<IApplicableToBeatmap>())
+            {
+                token.ThrowIfCancellationRequested();
+                mod.ApplyToBeatmap(converted);
+            }
+
+            return converted;
         }
 
         private CancellationTokenSource loadCancellation = new CancellationTokenSource();
diff --git a/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs b/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs
index bd06e71304..dea1964faa 100644
--- a/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs
+++ b/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs
@@ -210,7 +210,7 @@ namespace osu.Game.Screens.Play.HUD
                 this.gameplayBeatmap = gameplayBeatmap;
             }
 
-            public override IBeatmap GetPlayableBeatmap(RulesetInfo ruleset, IReadOnlyList<Mod> mods = null, TimeSpan? timeout = null, CancellationToken timeoutToken = default)
+            public override IBeatmap GetPlayableBeatmap(RulesetInfo ruleset, IReadOnlyList<Mod> mods = null, CancellationToken timeoutToken = default)
                 => gameplayBeatmap;
 
             protected override IBeatmap GetBeatmap() => gameplayBeatmap;

From c58f21a11531860719268823ba02c2436668ccde Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 8 Nov 2021 14:43:46 +0900
Subject: [PATCH 0825/5547] Handle mods with overloaded method signature
 instead

---
 .../Difficulty/DifficultyCalculator.cs        | 25 ++++++++++++++++---
 .../Difficulty/TimedDifficultyAttributes.cs   |  2 +-
 2 files changed, 22 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs b/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs
index a6f3a75302..6748158d8f 100644
--- a/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs
+++ b/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs
@@ -5,6 +5,7 @@ using System;
 using System.Collections.Generic;
 using System.Linq;
 using System.Threading;
+using JetBrains.Annotations;
 using osu.Framework.Audio.Track;
 using osu.Framework.Extensions.IEnumerableExtensions;
 using osu.Game.Beatmaps;
@@ -36,13 +37,21 @@ namespace osu.Game.Rulesets.Difficulty
             this.beatmap = beatmap;
         }
 
+        /// <summary>
+        /// Calculates the difficulty of the beatmap with no mods applied.
+        /// </summary>
+        /// <param name="cancellationToken">The cancellation token.</param>
+        /// <returns>A structure describing the difficulty of the beatmap.</returns>
+        public DifficultyAttributes Calculate(CancellationToken cancellationToken = default)
+            => Calculate(Array.Empty<Mod>(), cancellationToken);
+
         /// <summary>
         /// Calculates the difficulty of the beatmap using a specific mod combination.
         /// </summary>
         /// <param name="mods">The mods that should be applied to the beatmap.</param>
         /// <param name="cancellationToken">The cancellation token.</param>
         /// <returns>A structure describing the difficulty of the beatmap.</returns>
-        public DifficultyAttributes Calculate(IEnumerable<Mod> mods = null, CancellationToken cancellationToken = default)
+        public DifficultyAttributes Calculate([NotNull] IEnumerable<Mod> mods, CancellationToken cancellationToken = default)
         {
             cancellationToken.ThrowIfCancellationRequested();
             preProcess(mods, cancellationToken);
@@ -65,12 +74,20 @@ namespace osu.Game.Rulesets.Difficulty
         }
 
         /// <summary>
-        /// Calculates the difficulty of the beatmap and returns a set of <see cref="TimedDifficultyAttributes"/> representing the difficulty at every relevant time value in the beatmap.
+        /// Calculates the difficulty of the beatmap with no mods applied and returns a set of <see cref="TimedDifficultyAttributes"/> representing the difficulty at every relevant time value in the beatmap.
+        /// </summary>
+        /// <param name="cancellationToken">The cancellation token.</param>
+        /// <returns>The set of <see cref="TimedDifficultyAttributes"/>.</returns>
+        public List<TimedDifficultyAttributes> CalculateTimed(CancellationToken cancellationToken = default)
+            => CalculateTimed(Array.Empty<Mod>(), cancellationToken);
+
+        /// <summary>
+        /// Calculates the difficulty of the beatmap using a specific mod combination and returns a set of <see cref="TimedDifficultyAttributes"/> representing the difficulty at every relevant time value in the beatmap.
         /// </summary>
         /// <param name="mods">The mods that should be applied to the beatmap.</param>
         /// <param name="cancellationToken">The cancellation token.</param>
         /// <returns>The set of <see cref="TimedDifficultyAttributes"/>.</returns>
-        public List<TimedDifficultyAttributes> CalculateTimed(IEnumerable<Mod> mods, CancellationToken cancellationToken = default)
+        public List<TimedDifficultyAttributes> CalculateTimed([NotNull] IEnumerable<Mod> mods, CancellationToken cancellationToken = default)
         {
             cancellationToken.ThrowIfCancellationRequested();
             preProcess(mods, cancellationToken);
@@ -124,7 +141,7 @@ namespace osu.Game.Rulesets.Difficulty
         /// </summary>
         /// <param name="mods">The original list of <see cref="Mod"/>s.</param>
         /// <param name="cancellationToken">The cancellation token.</param>
-        private void preProcess(IEnumerable<Mod> mods, CancellationToken cancellationToken = default)
+        private void preProcess([NotNull] IEnumerable<Mod> mods, CancellationToken cancellationToken = default)
         {
             playableMods = mods.Select(m => m.DeepClone()).ToArray();
 
diff --git a/osu.Game/Rulesets/Difficulty/TimedDifficultyAttributes.cs b/osu.Game/Rulesets/Difficulty/TimedDifficultyAttributes.cs
index 2509971389..c07d1cd46e 100644
--- a/osu.Game/Rulesets/Difficulty/TimedDifficultyAttributes.cs
+++ b/osu.Game/Rulesets/Difficulty/TimedDifficultyAttributes.cs
@@ -7,7 +7,7 @@ namespace osu.Game.Rulesets.Difficulty
 {
     /// <summary>
     /// Wraps a <see cref="DifficultyAttributes"/> object and adds a time value for which the attribute is valid.
-    /// Output by <see cref="DifficultyCalculator.CalculateTimed"/>.
+    /// Output by DifficultyCalculator.CalculateTimed methods.
     /// </summary>
     public class TimedDifficultyAttributes : IComparable<TimedDifficultyAttributes>
     {

From c3069ad002cb4e4a298b0a0da1e9419a6bb3c08a Mon Sep 17 00:00:00 2001
From: Susko3 <16479013+Susko3@users.noreply.github.com>
Date: Mon, 8 Nov 2021 06:55:26 +0100
Subject: [PATCH 0826/5547] Change to use `ReadableKeyCombinationProvider`

Changes all usages of `KeyCombination.ReadableString()` to
`ReadableKeyCombinationProvider.GetReadableString()`.

Subscribing to `KeymapChanged` is only required in `KeyButton`.
All other places query `GetReadableString()` every time.
---
 .../Database/TestRealmKeyBindingStore.cs      |  3 +-
 osu.Game/Input/RealmKeyBindingStore.cs        |  7 ++--
 osu.Game/OsuGameBase.cs                       |  4 +--
 .../Settings/Sections/Input/KeyBindingRow.cs  | 32 +++++++++++++++++--
 osu.Game/Overlays/Toolbar/ToolbarButton.cs    |  6 +++-
 5 files changed, 43 insertions(+), 9 deletions(-)

diff --git a/osu.Game.Tests/Database/TestRealmKeyBindingStore.cs b/osu.Game.Tests/Database/TestRealmKeyBindingStore.cs
index f10b11733e..860828ae81 100644
--- a/osu.Game.Tests/Database/TestRealmKeyBindingStore.cs
+++ b/osu.Game.Tests/Database/TestRealmKeyBindingStore.cs
@@ -6,6 +6,7 @@ using System.Collections.Generic;
 using System.IO;
 using System.Linq;
 using NUnit.Framework;
+using osu.Framework.Input;
 using osu.Framework.Input.Bindings;
 using osu.Framework.Platform;
 using osu.Game.Database;
@@ -33,7 +34,7 @@ namespace osu.Game.Tests.Database
             storage = new NativeStorage(directory.FullName);
 
             realmContextFactory = new RealmContextFactory(storage, "test");
-            keyBindingStore = new RealmKeyBindingStore(realmContextFactory);
+            keyBindingStore = new RealmKeyBindingStore(realmContextFactory, new ReadableKeyCombinationProvider());
         }
 
         [Test]
diff --git a/osu.Game/Input/RealmKeyBindingStore.cs b/osu.Game/Input/RealmKeyBindingStore.cs
index c65e36e478..677a7baf62 100644
--- a/osu.Game/Input/RealmKeyBindingStore.cs
+++ b/osu.Game/Input/RealmKeyBindingStore.cs
@@ -3,6 +3,7 @@
 
 using System.Collections.Generic;
 using System.Linq;
+using osu.Framework.Input;
 using osu.Framework.Input.Bindings;
 using osu.Game.Database;
 using osu.Game.Input.Bindings;
@@ -16,10 +17,12 @@ namespace osu.Game.Input
     public class RealmKeyBindingStore
     {
         private readonly RealmContextFactory realmFactory;
+        private readonly ReadableKeyCombinationProvider readableKeyCombinationProvider;
 
-        public RealmKeyBindingStore(RealmContextFactory realmFactory)
+        public RealmKeyBindingStore(RealmContextFactory realmFactory, ReadableKeyCombinationProvider readableKeyCombinationProvider)
         {
             this.realmFactory = realmFactory;
+            this.readableKeyCombinationProvider = readableKeyCombinationProvider;
         }
 
         /// <summary>
@@ -35,7 +38,7 @@ namespace osu.Game.Input
             {
                 foreach (var action in context.All<RealmKeyBinding>().Where(b => b.RulesetID == null && (GlobalAction)b.ActionInt == globalAction))
                 {
-                    string str = action.KeyCombination.ReadableString();
+                    string str = readableKeyCombinationProvider.GetReadableString(action.KeyCombination);
 
                     // even if found, the readable string may be empty for an unbound action.
                     if (str.Length > 0)
diff --git a/osu.Game/OsuGameBase.cs b/osu.Game/OsuGameBase.cs
index f6ec22a536..f23a0433e6 100644
--- a/osu.Game/OsuGameBase.cs
+++ b/osu.Game/OsuGameBase.cs
@@ -167,7 +167,7 @@ namespace osu.Game
         }
 
         [BackgroundDependencyLoader]
-        private void load()
+        private void load(ReadableKeyCombinationProvider readableKeyCombinationProvider)
         {
             try
             {
@@ -316,7 +316,7 @@ namespace osu.Game
 
             base.Content.Add(CreateScalingContainer().WithChildren(mainContent));
 
-            KeyBindingStore = new RealmKeyBindingStore(realmFactory);
+            KeyBindingStore = new RealmKeyBindingStore(realmFactory, readableKeyCombinationProvider);
             KeyBindingStore.Register(globalBindings, RulesetStore.AvailableRulesets);
 
             dependencies.Cache(globalBindings);
diff --git a/osu.Game/Overlays/Settings/Sections/Input/KeyBindingRow.cs b/osu.Game/Overlays/Settings/Sections/Input/KeyBindingRow.cs
index f44f02d0ed..758f93692e 100644
--- a/osu.Game/Overlays/Settings/Sections/Input/KeyBindingRow.cs
+++ b/osu.Game/Overlays/Settings/Sections/Input/KeyBindingRow.cs
@@ -12,6 +12,7 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Effects;
 using osu.Framework.Graphics.Shapes;
+using osu.Framework.Input;
 using osu.Framework.Input.Bindings;
 using osu.Framework.Input.Events;
 using osu.Game.Database;
@@ -57,13 +58,16 @@ namespace osu.Game.Overlays.Settings.Sections.Input
 
         public bool FilteringActive { get; set; }
 
+        [Resolved]
+        private ReadableKeyCombinationProvider readableKeyCombinationProvider { get; set; }
+
         private OsuSpriteText text;
         private FillFlowContainer cancelAndClearButtons;
         private FillFlowContainer<KeyButton> buttons;
 
         private Bindable<bool> isDefault { get; } = new BindableBool(true);
 
-        public IEnumerable<string> FilterTerms => bindings.Select(b => b.KeyCombination.ReadableString()).Prepend(text.Text.ToString());
+        public IEnumerable<string> FilterTerms => bindings.Select(b => readableKeyCombinationProvider.GetReadableString(b.KeyCombination)).Prepend(text.Text.ToString());
 
         public KeyBindingRow(object action, List<RealmKeyBinding> bindings)
         {
@@ -422,6 +426,9 @@ namespace osu.Game.Overlays.Settings.Sections.Input
             [Resolved]
             private OverlayColourProvider colourProvider { get; set; }
 
+            [Resolved]
+            private ReadableKeyCombinationProvider readableKeyCombinationProvider { get; set; }
+
             private bool isBinding;
 
             public bool IsBinding
@@ -470,12 +477,19 @@ namespace osu.Game.Overlays.Settings.Sections.Input
                         Margin = new MarginPadding(5),
                         Anchor = Anchor.Centre,
                         Origin = Anchor.Centre,
-                        Text = keyBinding.KeyCombination.ReadableString(),
                     },
                     new HoverSounds()
                 };
             }
 
+            protected override void LoadComplete()
+            {
+                base.LoadComplete();
+
+                readableKeyCombinationProvider.KeymapChanged += updateKeyCombinationText;
+                updateKeyCombinationText();
+            }
+
             [BackgroundDependencyLoader]
             private void load()
             {
@@ -508,13 +522,25 @@ namespace osu.Game.Overlays.Settings.Sections.Input
                 }
             }
 
+            private void updateKeyCombinationText()
+            {
+                Text.Text = readableKeyCombinationProvider.GetReadableString(KeyBinding.KeyCombination);
+            }
+
             public void UpdateKeyCombination(KeyCombination newCombination)
             {
                 if (KeyBinding.RulesetID != null && !RealmKeyBindingStore.CheckValidForGameplay(newCombination))
                     return;
 
                 KeyBinding.KeyCombination = newCombination;
-                Text.Text = KeyBinding.KeyCombination.ReadableString();
+                updateKeyCombinationText();
+            }
+
+            protected override void Dispose(bool isDisposing)
+            {
+                base.Dispose(isDisposing);
+
+                readableKeyCombinationProvider.KeymapChanged -= updateKeyCombinationText;
             }
         }
     }
diff --git a/osu.Game/Overlays/Toolbar/ToolbarButton.cs b/osu.Game/Overlays/Toolbar/ToolbarButton.cs
index ab37b3b355..0886bb8f8c 100644
--- a/osu.Game/Overlays/Toolbar/ToolbarButton.cs
+++ b/osu.Game/Overlays/Toolbar/ToolbarButton.cs
@@ -11,6 +11,7 @@ using osu.Framework.Graphics.Effects;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Graphics.Textures;
+using osu.Framework.Input;
 using osu.Framework.Input.Bindings;
 using osu.Framework.Input.Events;
 using osu.Game.Database;
@@ -39,6 +40,9 @@ namespace osu.Game.Overlays.Toolbar
         [Resolved]
         private TextureStore textures { get; set; }
 
+        [Resolved]
+        private ReadableKeyCombinationProvider readableKeyCombinationProvider { get; set; }
+
         public void SetIcon(string texture) =>
             SetIcon(new Sprite
             {
@@ -207,7 +211,7 @@ namespace osu.Game.Overlays.Toolbar
 
             if (realmKeyBinding != null)
             {
-                string keyBindingString = realmKeyBinding.KeyCombination.ReadableString();
+                string keyBindingString = readableKeyCombinationProvider.GetReadableString(realmKeyBinding.KeyCombination);
 
                 if (!string.IsNullOrEmpty(keyBindingString))
                     keyBindingTooltip.Text = $" ({keyBindingString})";

From cc286f165d9e7a693377acd8f5347d7d13e5bb31 Mon Sep 17 00:00:00 2001
From: Susko3 <16479013+Susko3@users.noreply.github.com>
Date: Mon, 8 Nov 2021 06:56:57 +0100
Subject: [PATCH 0827/5547] Change font to default

Non-english letters look tiny with size 10
and don't fit into the look.
---
 osu.Game/Overlays/Settings/Sections/Input/KeyBindingRow.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/Settings/Sections/Input/KeyBindingRow.cs b/osu.Game/Overlays/Settings/Sections/Input/KeyBindingRow.cs
index 758f93692e..fe0905d76f 100644
--- a/osu.Game/Overlays/Settings/Sections/Input/KeyBindingRow.cs
+++ b/osu.Game/Overlays/Settings/Sections/Input/KeyBindingRow.cs
@@ -473,7 +473,7 @@ namespace osu.Game.Overlays.Settings.Sections.Input
                     },
                     Text = new OsuSpriteText
                     {
-                        Font = OsuFont.Numeric.With(size: 10),
+                        Font = OsuFont.Default,
                         Margin = new MarginPadding(5),
                         Anchor = Anchor.Centre,
                         Origin = Anchor.Centre,

From 72b4afdea688bebc8d2b7eefd72815c8adf491f4 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 18 Oct 2021 16:51:34 +0900
Subject: [PATCH 0828/5547] Move `RealmRulesetStore` initial work off incorrect
 thread

---
 osu.Game/Stores/RealmRulesetStore.cs | 117 ++++++++++++++-------------
 1 file changed, 60 insertions(+), 57 deletions(-)

diff --git a/osu.Game/Stores/RealmRulesetStore.cs b/osu.Game/Stores/RealmRulesetStore.cs
index e9c04f652d..0d2cddf874 100644
--- a/osu.Game/Stores/RealmRulesetStore.cs
+++ b/osu.Game/Stores/RealmRulesetStore.cs
@@ -102,75 +102,78 @@ namespace osu.Game.Stores
 
         private void addMissingRulesets()
         {
-            realmFactory.Context.Write(realm =>
+            using (var context = realmFactory.CreateContext())
             {
-                var rulesets = realm.All<RealmRuleset>();
-
-                List<Ruleset> instances = loadedAssemblies.Values
-                                                          .Select(r => Activator.CreateInstance(r) as Ruleset)
-                                                          .Where(r => r != null)
-                                                          .Select(r => r.AsNonNull())
-                                                          .ToList();
-
-                // add all legacy rulesets first to ensure they have exclusive choice of primary key.
-                foreach (var r in instances.Where(r => r is ILegacyRuleset))
+                context.Write(realm =>
                 {
-                    if (realm.All<RealmRuleset>().FirstOrDefault(rr => rr.OnlineID == r.RulesetInfo.ID) == null)
-                        realm.Add(new RealmRuleset(r.RulesetInfo.ShortName, r.RulesetInfo.Name, r.RulesetInfo.InstantiationInfo, r.RulesetInfo.ID));
-                }
+                    var rulesets = realm.All<RealmRuleset>();
 
-                // add any other rulesets which have assemblies present but are not yet in the database.
-                foreach (var r in instances.Where(r => !(r is ILegacyRuleset)))
-                {
-                    if (rulesets.FirstOrDefault(ri => ri.InstantiationInfo.Equals(r.RulesetInfo.InstantiationInfo, StringComparison.Ordinal)) == null)
+                    List<Ruleset> instances = loadedAssemblies.Values
+                                                              .Select(r => Activator.CreateInstance(r) as Ruleset)
+                                                              .Where(r => r != null)
+                                                              .Select(r => r.AsNonNull())
+                                                              .ToList();
+
+                    // add all legacy rulesets first to ensure they have exclusive choice of primary key.
+                    foreach (var r in instances.Where(r => r is ILegacyRuleset))
                     {
-                        var existingSameShortName = rulesets.FirstOrDefault(ri => ri.ShortName == r.RulesetInfo.ShortName);
-
-                        if (existingSameShortName != null)
-                        {
-                            // even if a matching InstantiationInfo was not found, there may be an existing ruleset with the same ShortName.
-                            // this generally means the user or ruleset provider has renamed their dll but the underlying ruleset is *likely* the same one.
-                            // in such cases, update the instantiation info of the existing entry to point to the new one.
-                            existingSameShortName.InstantiationInfo = r.RulesetInfo.InstantiationInfo;
-                        }
-                        else
+                        if (realm.All<RealmRuleset>().FirstOrDefault(rr => rr.OnlineID == r.RulesetInfo.ID) == null)
                             realm.Add(new RealmRuleset(r.RulesetInfo.ShortName, r.RulesetInfo.Name, r.RulesetInfo.InstantiationInfo, r.RulesetInfo.ID));
                     }
-                }
 
-                List<RealmRuleset> detachedRulesets = new List<RealmRuleset>();
-
-                // perform a consistency check and detach final rulesets from realm for cross-thread runtime usage.
-                foreach (var r in rulesets)
-                {
-                    try
+                    // add any other rulesets which have assemblies present but are not yet in the database.
+                    foreach (var r in instances.Where(r => !(r is ILegacyRuleset)))
                     {
-                        var type = Type.GetType(r.InstantiationInfo);
+                        if (rulesets.FirstOrDefault(ri => ri.InstantiationInfo.Equals(r.RulesetInfo.InstantiationInfo, StringComparison.Ordinal)) == null)
+                        {
+                            var existingSameShortName = rulesets.FirstOrDefault(ri => ri.ShortName == r.RulesetInfo.ShortName);
 
-                        if (type == null)
-                            throw new InvalidOperationException(@"Type resolution failure.");
-
-                        var rInstance = (Activator.CreateInstance(type) as Ruleset)?.RulesetInfo;
-
-                        if (rInstance == null)
-                            throw new InvalidOperationException(@"Instantiation failure.");
-
-                        r.Name = rInstance.Name;
-                        r.ShortName = rInstance.ShortName;
-                        r.InstantiationInfo = rInstance.InstantiationInfo;
-                        r.Available = true;
-
-                        detachedRulesets.Add(r.Clone());
+                            if (existingSameShortName != null)
+                            {
+                                // even if a matching InstantiationInfo was not found, there may be an existing ruleset with the same ShortName.
+                                // this generally means the user or ruleset provider has renamed their dll but the underlying ruleset is *likely* the same one.
+                                // in such cases, update the instantiation info of the existing entry to point to the new one.
+                                existingSameShortName.InstantiationInfo = r.RulesetInfo.InstantiationInfo;
+                            }
+                            else
+                                realm.Add(new RealmRuleset(r.RulesetInfo.ShortName, r.RulesetInfo.Name, r.RulesetInfo.InstantiationInfo, r.RulesetInfo.ID));
+                        }
                     }
-                    catch (Exception ex)
+
+                    List<RealmRuleset> detachedRulesets = new List<RealmRuleset>();
+
+                    // perform a consistency check and detach final rulesets from realm for cross-thread runtime usage.
+                    foreach (var r in rulesets)
                     {
-                        r.Available = false;
-                        Logger.Log($"Could not load ruleset {r}: {ex.Message}");
-                    }
-                }
+                        try
+                        {
+                            var type = Type.GetType(r.InstantiationInfo);
 
-                availableRulesets.AddRange(detachedRulesets);
-            });
+                            if (type == null)
+                                throw new InvalidOperationException(@"Type resolution failure.");
+
+                            var rInstance = (Activator.CreateInstance(type) as Ruleset)?.RulesetInfo;
+
+                            if (rInstance == null)
+                                throw new InvalidOperationException(@"Instantiation failure.");
+
+                            r.Name = rInstance.Name;
+                            r.ShortName = rInstance.ShortName;
+                            r.InstantiationInfo = rInstance.InstantiationInfo;
+                            r.Available = true;
+
+                            detachedRulesets.Add(r.Clone());
+                        }
+                        catch (Exception ex)
+                        {
+                            r.Available = false;
+                            Logger.Log($"Could not load ruleset {r}: {ex.Message}");
+                        }
+                    }
+
+                    availableRulesets.AddRange(detachedRulesets);
+                });
+            }
         }
 
         private void loadFromAppDomain()

From 413f98999a06f54b7171ad299f401911b4865cf5 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 15 Oct 2021 16:33:09 +0900
Subject: [PATCH 0829/5547] Start initialising `RealmRulesetStore` on startup

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

diff --git a/osu.Game/OsuGameBase.cs b/osu.Game/OsuGameBase.cs
index f6ec22a536..c1cc2a7f25 100644
--- a/osu.Game/OsuGameBase.cs
+++ b/osu.Game/OsuGameBase.cs
@@ -40,6 +40,7 @@ using osu.Game.Rulesets;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Scoring;
 using osu.Game.Skinning;
+using osu.Game.Stores;
 using osu.Game.Utils;
 using RuntimeInfo = osu.Framework.RuntimeInfo;
 
@@ -237,6 +238,11 @@ namespace osu.Game
             dependencies.Cache(ScoreManager = new ScoreManager(RulesetStore, () => BeatmapManager, Storage, API, contextFactory, Scheduler, Host, () => difficultyCache, LocalConfig));
             dependencies.Cache(BeatmapManager = new BeatmapManager(Storage, contextFactory, RulesetStore, API, Audio, Resources, Host, defaultBeatmap, performOnlineLookups: true));
 
+            // the following realm components are not actively used yet, but initialised and kept up to date for initial testing.
+            var realmRulesetStore = new RealmRulesetStore(realmFactory, Storage);
+
+            dependencies.Cache(realmRulesetStore);
+
             // this should likely be moved to ArchiveModelManager when another case appears where it is necessary
             // to have inter-dependent model managers. this could be obtained with an IHasForeign<T> interface to
             // allow lookups to be done on the child (ScoreManager in this case) to perform the cascading delete.

From ea0715cce4083ea896f58c1d7763a893b903d9d6 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 8 Nov 2021 16:35:05 +0900
Subject: [PATCH 0830/5547] Add missing dispose call

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

diff --git a/osu.Game/OsuGameBase.cs b/osu.Game/OsuGameBase.cs
index 3f7339c031..7911e843d1 100644
--- a/osu.Game/OsuGameBase.cs
+++ b/osu.Game/OsuGameBase.cs
@@ -161,6 +161,8 @@ namespace osu.Game
 
         private readonly BindableNumber<double> globalTrackVolumeAdjust = new BindableNumber<double>(GLOBAL_TRACK_VOLUME_ADJUST);
 
+        private RealmRulesetStore realmRulesetStore;
+
         public OsuGameBase()
         {
             UseDevelopmentServer = DebugUtils.IsDebugBuild;
@@ -233,7 +235,7 @@ namespace osu.Game
             dependencies.Cache(BeatmapManager = new BeatmapManager(Storage, contextFactory, RulesetStore, API, Audio, Resources, Host, defaultBeatmap, performOnlineLookups: true));
 
             // the following realm components are not actively used yet, but initialised and kept up to date for initial testing.
-            var realmRulesetStore = new RealmRulesetStore(realmFactory, Storage);
+            realmRulesetStore = new RealmRulesetStore(realmFactory, Storage);
 
             dependencies.Cache(realmRulesetStore);
 
@@ -518,6 +520,8 @@ namespace osu.Game
             LocalConfig?.Dispose();
 
             contextFactory?.FlushConnections();
+
+            realmRulesetStore?.Dispose();
             realmFactory?.Dispose();
         }
     }

From c1e7fcd2d744edc62311bd8b4e9084888cab8af2 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 8 Nov 2021 18:15:51 +0900
Subject: [PATCH 0831/5547] Update framework

---
 osu.Android.props        | 2 +-
 osu.Game/osu.Game.csproj | 2 +-
 osu.iOS.props            | 4 ++--
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Android.props b/osu.Android.props
index 4f9f83f199..752eb160ed 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -52,7 +52,7 @@
   </ItemGroup>
   <ItemGroup>
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1026.0" />
-    <PackageReference Include="ppy.osu.Framework.Android" Version="2021.1106.0" />
+    <PackageReference Include="ppy.osu.Framework.Android" Version="2021.1108.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
     <!-- Realm needs to be directly referenced in all Xamarin projects, as it will not pull in its transitive dependencies otherwise. -->
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 7811de5764..df3c9b355a 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="10.6.0" />
-    <PackageReference Include="ppy.osu.Framework" Version="2021.1106.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2021.1108.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1026.0" />
     <PackageReference Include="Sentry" Version="3.10.0" />
     <PackageReference Include="SharpCompress" Version="0.30.0" />
diff --git a/osu.iOS.props b/osu.iOS.props
index 9d95b7c765..1852957e87 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -70,7 +70,7 @@
     <Reference Include="System.Net.Http" />
   </ItemGroup>
   <ItemGroup Label="Package References">
-    <PackageReference Include="ppy.osu.Framework.iOS" Version="2021.1106.0" />
+    <PackageReference Include="ppy.osu.Framework.iOS" Version="2021.1108.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1026.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net5.0 / net6.0) -->
@@ -93,7 +93,7 @@
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="2.2.6" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.Core" Version="2.2.6" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
-    <PackageReference Include="ppy.osu.Framework" Version="2021.1106.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2021.1108.0" />
     <PackageReference Include="SharpCompress" Version="0.30.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
     <PackageReference Include="SharpRaven" Version="2.4.0" />

From 82f24b0502272f48520f259100720c1356c16d55 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 8 Nov 2021 18:16:06 +0900
Subject: [PATCH 0832/5547] Revert "Change font to default"

This reverts commit cc286f165d9e7a693377acd8f5347d7d13e5bb31.
---
 osu.Game/Overlays/Settings/Sections/Input/KeyBindingRow.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/Settings/Sections/Input/KeyBindingRow.cs b/osu.Game/Overlays/Settings/Sections/Input/KeyBindingRow.cs
index fe0905d76f..758f93692e 100644
--- a/osu.Game/Overlays/Settings/Sections/Input/KeyBindingRow.cs
+++ b/osu.Game/Overlays/Settings/Sections/Input/KeyBindingRow.cs
@@ -473,7 +473,7 @@ namespace osu.Game.Overlays.Settings.Sections.Input
                     },
                     Text = new OsuSpriteText
                     {
-                        Font = OsuFont.Default,
+                        Font = OsuFont.Numeric.With(size: 10),
                         Margin = new MarginPadding(5),
                         Anchor = Anchor.Centre,
                         Origin = Anchor.Centre,

From f5842e75875feaf736d376dd33dfe5e47b8d7acd Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 8 Nov 2021 18:24:37 +0900
Subject: [PATCH 0833/5547] Shorten variable names

---
 osu.Game/Input/RealmKeyBindingStore.cs               |  8 ++++----
 osu.Game/OsuGameBase.cs                              |  4 ++--
 .../Settings/Sections/Input/KeyBindingRow.cs         | 12 ++++++------
 osu.Game/Overlays/Toolbar/ToolbarButton.cs           |  4 ++--
 4 files changed, 14 insertions(+), 14 deletions(-)

diff --git a/osu.Game/Input/RealmKeyBindingStore.cs b/osu.Game/Input/RealmKeyBindingStore.cs
index 677a7baf62..046969579c 100644
--- a/osu.Game/Input/RealmKeyBindingStore.cs
+++ b/osu.Game/Input/RealmKeyBindingStore.cs
@@ -17,12 +17,12 @@ namespace osu.Game.Input
     public class RealmKeyBindingStore
     {
         private readonly RealmContextFactory realmFactory;
-        private readonly ReadableKeyCombinationProvider readableKeyCombinationProvider;
+        private readonly ReadableKeyCombinationProvider keyCombinationProvider;
 
-        public RealmKeyBindingStore(RealmContextFactory realmFactory, ReadableKeyCombinationProvider readableKeyCombinationProvider)
+        public RealmKeyBindingStore(RealmContextFactory realmFactory, ReadableKeyCombinationProvider keyCombinationProvider)
         {
             this.realmFactory = realmFactory;
-            this.readableKeyCombinationProvider = readableKeyCombinationProvider;
+            this.keyCombinationProvider = keyCombinationProvider;
         }
 
         /// <summary>
@@ -38,7 +38,7 @@ namespace osu.Game.Input
             {
                 foreach (var action in context.All<RealmKeyBinding>().Where(b => b.RulesetID == null && (GlobalAction)b.ActionInt == globalAction))
                 {
-                    string str = readableKeyCombinationProvider.GetReadableString(action.KeyCombination);
+                    string str = keyCombinationProvider.GetReadableString(action.KeyCombination);
 
                     // even if found, the readable string may be empty for an unbound action.
                     if (str.Length > 0)
diff --git a/osu.Game/OsuGameBase.cs b/osu.Game/OsuGameBase.cs
index 0dc511c361..10166daf00 100644
--- a/osu.Game/OsuGameBase.cs
+++ b/osu.Game/OsuGameBase.cs
@@ -170,7 +170,7 @@ namespace osu.Game
         }
 
         [BackgroundDependencyLoader]
-        private void load(ReadableKeyCombinationProvider readableKeyCombinationProvider)
+        private void load(ReadableKeyCombinationProvider keyCombinationProvider)
         {
             try
             {
@@ -309,7 +309,7 @@ namespace osu.Game
 
             base.Content.Add(CreateScalingContainer().WithChildren(mainContent));
 
-            KeyBindingStore = new RealmKeyBindingStore(realmFactory, readableKeyCombinationProvider);
+            KeyBindingStore = new RealmKeyBindingStore(realmFactory, keyCombinationProvider);
             KeyBindingStore.Register(globalBindings, RulesetStore.AvailableRulesets);
 
             dependencies.Cache(globalBindings);
diff --git a/osu.Game/Overlays/Settings/Sections/Input/KeyBindingRow.cs b/osu.Game/Overlays/Settings/Sections/Input/KeyBindingRow.cs
index 758f93692e..f9856f30ce 100644
--- a/osu.Game/Overlays/Settings/Sections/Input/KeyBindingRow.cs
+++ b/osu.Game/Overlays/Settings/Sections/Input/KeyBindingRow.cs
@@ -59,7 +59,7 @@ namespace osu.Game.Overlays.Settings.Sections.Input
         public bool FilteringActive { get; set; }
 
         [Resolved]
-        private ReadableKeyCombinationProvider readableKeyCombinationProvider { get; set; }
+        private ReadableKeyCombinationProvider keyCombinationProvider { get; set; }
 
         private OsuSpriteText text;
         private FillFlowContainer cancelAndClearButtons;
@@ -67,7 +67,7 @@ namespace osu.Game.Overlays.Settings.Sections.Input
 
         private Bindable<bool> isDefault { get; } = new BindableBool(true);
 
-        public IEnumerable<string> FilterTerms => bindings.Select(b => readableKeyCombinationProvider.GetReadableString(b.KeyCombination)).Prepend(text.Text.ToString());
+        public IEnumerable<string> FilterTerms => bindings.Select(b => keyCombinationProvider.GetReadableString(b.KeyCombination)).Prepend(text.Text.ToString());
 
         public KeyBindingRow(object action, List<RealmKeyBinding> bindings)
         {
@@ -427,7 +427,7 @@ namespace osu.Game.Overlays.Settings.Sections.Input
             private OverlayColourProvider colourProvider { get; set; }
 
             [Resolved]
-            private ReadableKeyCombinationProvider readableKeyCombinationProvider { get; set; }
+            private ReadableKeyCombinationProvider keyCombinationProvider { get; set; }
 
             private bool isBinding;
 
@@ -486,7 +486,7 @@ namespace osu.Game.Overlays.Settings.Sections.Input
             {
                 base.LoadComplete();
 
-                readableKeyCombinationProvider.KeymapChanged += updateKeyCombinationText;
+                keyCombinationProvider.KeymapChanged += updateKeyCombinationText;
                 updateKeyCombinationText();
             }
 
@@ -524,7 +524,7 @@ namespace osu.Game.Overlays.Settings.Sections.Input
 
             private void updateKeyCombinationText()
             {
-                Text.Text = readableKeyCombinationProvider.GetReadableString(KeyBinding.KeyCombination);
+                Text.Text = keyCombinationProvider.GetReadableString(KeyBinding.KeyCombination);
             }
 
             public void UpdateKeyCombination(KeyCombination newCombination)
@@ -540,7 +540,7 @@ namespace osu.Game.Overlays.Settings.Sections.Input
             {
                 base.Dispose(isDisposing);
 
-                readableKeyCombinationProvider.KeymapChanged -= updateKeyCombinationText;
+                keyCombinationProvider.KeymapChanged -= updateKeyCombinationText;
             }
         }
     }
diff --git a/osu.Game/Overlays/Toolbar/ToolbarButton.cs b/osu.Game/Overlays/Toolbar/ToolbarButton.cs
index 0886bb8f8c..b2252a5575 100644
--- a/osu.Game/Overlays/Toolbar/ToolbarButton.cs
+++ b/osu.Game/Overlays/Toolbar/ToolbarButton.cs
@@ -41,7 +41,7 @@ namespace osu.Game.Overlays.Toolbar
         private TextureStore textures { get; set; }
 
         [Resolved]
-        private ReadableKeyCombinationProvider readableKeyCombinationProvider { get; set; }
+        private ReadableKeyCombinationProvider keyCombinationProvider { get; set; }
 
         public void SetIcon(string texture) =>
             SetIcon(new Sprite
@@ -211,7 +211,7 @@ namespace osu.Game.Overlays.Toolbar
 
             if (realmKeyBinding != null)
             {
-                string keyBindingString = readableKeyCombinationProvider.GetReadableString(realmKeyBinding.KeyCombination);
+                string keyBindingString = keyCombinationProvider.GetReadableString(realmKeyBinding.KeyCombination);
 
                 if (!string.IsNullOrEmpty(keyBindingString))
                     keyBindingTooltip.Text = $" ({keyBindingString})";

From b4225804ed5c44196db5df5dd7a07552f6e24561 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 8 Nov 2021 18:26:12 +0900
Subject: [PATCH 0834/5547] Add missing null check

---
 osu.Game/Overlays/Settings/Sections/Input/KeyBindingRow.cs | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/Settings/Sections/Input/KeyBindingRow.cs b/osu.Game/Overlays/Settings/Sections/Input/KeyBindingRow.cs
index f9856f30ce..40bf74cbf1 100644
--- a/osu.Game/Overlays/Settings/Sections/Input/KeyBindingRow.cs
+++ b/osu.Game/Overlays/Settings/Sections/Input/KeyBindingRow.cs
@@ -540,7 +540,8 @@ namespace osu.Game.Overlays.Settings.Sections.Input
             {
                 base.Dispose(isDisposing);
 
-                keyCombinationProvider.KeymapChanged -= updateKeyCombinationText;
+                if (keyCombinationProvider != null)
+                    keyCombinationProvider.KeymapChanged -= updateKeyCombinationText;
             }
         }
     }

From 49c26a465c75aabd628561e6a117243fe2fda6d2 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 8 Nov 2021 18:29:11 +0900
Subject: [PATCH 0835/5547] Debounce and schedule updates to key combinations

---
 .../Settings/Sections/Input/KeyBindingRow.cs         | 12 +++++++-----
 1 file changed, 7 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Overlays/Settings/Sections/Input/KeyBindingRow.cs b/osu.Game/Overlays/Settings/Sections/Input/KeyBindingRow.cs
index 40bf74cbf1..e6472dffeb 100644
--- a/osu.Game/Overlays/Settings/Sections/Input/KeyBindingRow.cs
+++ b/osu.Game/Overlays/Settings/Sections/Input/KeyBindingRow.cs
@@ -522,11 +522,6 @@ namespace osu.Game.Overlays.Settings.Sections.Input
                 }
             }
 
-            private void updateKeyCombinationText()
-            {
-                Text.Text = keyCombinationProvider.GetReadableString(KeyBinding.KeyCombination);
-            }
-
             public void UpdateKeyCombination(KeyCombination newCombination)
             {
                 if (KeyBinding.RulesetID != null && !RealmKeyBindingStore.CheckValidForGameplay(newCombination))
@@ -536,6 +531,13 @@ namespace osu.Game.Overlays.Settings.Sections.Input
                 updateKeyCombinationText();
             }
 
+            private void updateKeyCombinationText()
+            {
+                Scheduler.AddOnce(updateText);
+
+                void updateText() => Text.Text = keyCombinationProvider.GetReadableString(KeyBinding.KeyCombination);
+            }
+
             protected override void Dispose(bool isDisposing)
             {
                 base.Dispose(isDisposing);

From 0faa26fc13905d13f67cfef7da0fca420382f6b5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 17 Oct 2021 21:34:31 +0200
Subject: [PATCH 0836/5547] Add basic structure for buttons

---
 .../Beatmaps/Drawables/Cards/BeatmapCard.cs   | 34 ++++++++++++--
 .../Cards/Buttons/BeatmapCardIconButton.cs    | 46 +++++++++++++++++++
 .../Drawables/Cards/Buttons/DownloadButton.cs | 22 +++++++++
 .../Cards/Buttons/FavouriteButton.cs          | 22 +++++++++
 4 files changed, 120 insertions(+), 4 deletions(-)
 create mode 100644 osu.Game/Beatmaps/Drawables/Cards/Buttons/BeatmapCardIconButton.cs
 create mode 100644 osu.Game/Beatmaps/Drawables/Cards/Buttons/DownloadButton.cs
 create mode 100644 osu.Game/Beatmaps/Drawables/Cards/Buttons/FavouriteButton.cs

diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
index c53c1abd8d..a3650315cc 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
@@ -9,6 +9,7 @@ using osu.Framework.Graphics.Shapes;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Input.Events;
 using osu.Framework.Localisation;
+using osu.Game.Beatmaps.Drawables.Cards.Buttons;
 using osu.Game.Beatmaps.Drawables.Cards.Statistics;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
@@ -21,6 +22,7 @@ using osuTK;
 using osu.Game.Overlays.BeatmapListing.Panels;
 using osu.Game.Resources.Localisation.Web;
 using osuTK.Graphics;
+using DownloadButton = osu.Game.Beatmaps.Drawables.Cards.Buttons.DownloadButton;
 
 namespace osu.Game.Beatmaps.Drawables.Cards
 {
@@ -35,7 +37,9 @@ namespace osu.Game.Beatmaps.Drawables.Cards
         private readonly APIBeatmapSet beatmapSet;
 
         private UpdateableOnlineBeatmapSetCover leftCover;
-        private FillFlowContainer iconArea;
+        private FillFlowContainer leftIconArea;
+
+        private Container rightButtonArea;
 
         private Container mainContent;
         private BeatmapCardContentBackground mainContentBackground;
@@ -79,7 +83,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                             RelativeSizeAxes = Axes.Both,
                             OnlineInfo = beatmapSet
                         },
-                        iconArea = new FillFlowContainer
+                        leftIconArea = new FillFlowContainer
                         {
                             Margin = new MarginPadding(5),
                             AutoSizeAxes = Axes.Both,
@@ -88,6 +92,27 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                         }
                     }
                 },
+                rightButtonArea = new Container
+                {
+                    Name = @"Right (button) area",
+                    Width = 30,
+                    RelativeSizeAxes = Axes.Y,
+                    Origin = Anchor.TopRight,
+                    Anchor = Anchor.TopRight,
+                    Child = new FillFlowContainer<BeatmapCardIconButton>
+                    {
+                        AutoSizeAxes = Axes.Both,
+                        Anchor = Anchor.Centre,
+                        Origin = Anchor.Centre,
+                        Direction = FillDirection.Vertical,
+                        Spacing = new Vector2(0, 14),
+                        Children = new BeatmapCardIconButton[]
+                        {
+                            new FavouriteButton(beatmapSet),
+                            new DownloadButton(beatmapSet)
+                        }
+                    }
+                },
                 mainContent = new Container
                 {
                     Name = @"Main content",
@@ -226,10 +251,10 @@ namespace osu.Game.Beatmaps.Drawables.Cards
             };
 
             if (beatmapSet.HasVideo)
-                iconArea.Add(new IconPill(FontAwesome.Solid.Film));
+                leftIconArea.Add(new IconPill(FontAwesome.Solid.Film));
 
             if (beatmapSet.HasStoryboard)
-                iconArea.Add(new IconPill(FontAwesome.Solid.Image));
+                leftIconArea.Add(new IconPill(FontAwesome.Solid.Image));
 
             if (beatmapSet.HasExplicitContent)
             {
@@ -306,6 +331,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
 
             leftCover.FadeColour(IsHovered ? OsuColour.Gray(0.2f) : Color4.White, TRANSITION_DURATION, Easing.OutQuint);
             statisticsContainer.FadeTo(IsHovered ? 1 : 0, TRANSITION_DURATION, Easing.OutQuint);
+            rightButtonArea.FadeTo(IsHovered ? 1 : 0, TRANSITION_DURATION, Easing.OutQuint);
         }
     }
 }
diff --git a/osu.Game/Beatmaps/Drawables/Cards/Buttons/BeatmapCardIconButton.cs b/osu.Game/Beatmaps/Drawables/Cards/Buttons/BeatmapCardIconButton.cs
new file mode 100644
index 0000000000..155259d859
--- /dev/null
+++ b/osu.Game/Beatmaps/Drawables/Cards/Buttons/BeatmapCardIconButton.cs
@@ -0,0 +1,46 @@
+// 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.Sprites;
+using osu.Game.Graphics.Containers;
+using osu.Game.Overlays;
+using osuTK;
+
+namespace osu.Game.Beatmaps.Drawables.Cards.Buttons
+{
+    public abstract class BeatmapCardIconButton : OsuHoverContainer
+    {
+        protected readonly SpriteIcon Icon;
+
+        private float size;
+
+        public new float Size
+        {
+            get => size;
+            set
+            {
+                size = value;
+                Icon.Size = new Vector2(size);
+            }
+        }
+
+        protected BeatmapCardIconButton()
+        {
+            Add(Icon = new SpriteIcon());
+
+            AutoSizeAxes = Axes.Both;
+            Size = 12;
+        }
+
+        [BackgroundDependencyLoader]
+        private void load(OverlayColourProvider colourProvider)
+        {
+            Anchor = Origin = Anchor.Centre;
+
+            IdleColour = colourProvider.Light1;
+            HoverColour = colourProvider.Content1;
+        }
+    }
+}
diff --git a/osu.Game/Beatmaps/Drawables/Cards/Buttons/DownloadButton.cs b/osu.Game/Beatmaps/Drawables/Cards/Buttons/DownloadButton.cs
new file mode 100644
index 0000000000..da6fe3c8be
--- /dev/null
+++ b/osu.Game/Beatmaps/Drawables/Cards/Buttons/DownloadButton.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.Sprites;
+using osu.Game.Online.API.Requests.Responses;
+
+namespace osu.Game.Beatmaps.Drawables.Cards.Buttons
+{
+    public class DownloadButton : BeatmapCardIconButton
+    {
+        private readonly APIBeatmapSet beatmapSet;
+
+        public DownloadButton(APIBeatmapSet beatmapSet)
+        {
+            this.beatmapSet = beatmapSet;
+
+            Icon.Icon = FontAwesome.Solid.FileDownload;
+        }
+
+        // TODO: implement behaviour
+    }
+}
diff --git a/osu.Game/Beatmaps/Drawables/Cards/Buttons/FavouriteButton.cs b/osu.Game/Beatmaps/Drawables/Cards/Buttons/FavouriteButton.cs
new file mode 100644
index 0000000000..1859a66821
--- /dev/null
+++ b/osu.Game/Beatmaps/Drawables/Cards/Buttons/FavouriteButton.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.Sprites;
+using osu.Game.Online.API.Requests.Responses;
+
+namespace osu.Game.Beatmaps.Drawables.Cards.Buttons
+{
+    public class FavouriteButton : BeatmapCardIconButton
+    {
+        private readonly APIBeatmapSet beatmapSet;
+
+        public FavouriteButton(APIBeatmapSet beatmapSet)
+        {
+            this.beatmapSet = beatmapSet;
+
+            Icon.Icon = FontAwesome.Regular.Heart;
+        }
+
+        // TODO: implement behaviour
+    }
+}

From 5cb533004de0329b90c4428f4cf1311db51529d5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 22 Oct 2021 23:11:31 +0200
Subject: [PATCH 0837/5547] Add test coverage for favourite button

---
 .../TestSceneBeatmapCardFavouriteButton.cs    | 86 +++++++++++++++++++
 .../Requests/PostBeatmapFavouriteRequest.cs   |  7 +-
 2 files changed, 90 insertions(+), 3 deletions(-)
 create mode 100644 osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCardFavouriteButton.cs

diff --git a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCardFavouriteButton.cs b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCardFavouriteButton.cs
new file mode 100644
index 0000000000..77c9debef6
--- /dev/null
+++ b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCardFavouriteButton.cs
@@ -0,0 +1,86 @@
+// 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.Sprites;
+using osu.Framework.Testing;
+using osu.Game.Beatmaps.Drawables.Cards.Buttons;
+using osu.Game.Online.API;
+using osu.Game.Online.API.Requests;
+using osu.Game.Online.API.Requests.Responses;
+using osu.Game.Overlays;
+using osu.Game.Resources.Localisation.Web;
+using osuTK;
+using osuTK.Input;
+
+namespace osu.Game.Tests.Visual.Beatmaps
+{
+    public class TestSceneBeatmapCardFavouriteButton : OsuManualInputManagerTestScene
+    {
+        private DummyAPIAccess dummyAPI => (DummyAPIAccess)API;
+
+        [Cached]
+        private OverlayColourProvider colourProvider = new OverlayColourProvider(OverlayColourScheme.Blue);
+
+        [Test]
+        public void TestInitialState([Values] bool favourited)
+        {
+            APIBeatmapSet beatmapSetInfo = null;
+            FavouriteButton button = null;
+
+            AddStep("create beatmap set", () =>
+            {
+                beatmapSetInfo = CreateAPIBeatmapSet(Ruleset.Value);
+                beatmapSetInfo.HasFavourited = favourited;
+            });
+            AddStep("create button", () => Child = button = new FavouriteButton(beatmapSetInfo) { Scale = new Vector2(2) });
+
+            assertCorrectIcon(favourited);
+            AddAssert("correct tooltip text", () => button.TooltipText == (favourited ? BeatmapsetsStrings.ShowDetailsUnfavourite : BeatmapsetsStrings.ShowDetailsFavourite));
+        }
+
+        [Test]
+        public void TestRequestHandling()
+        {
+            APIBeatmapSet beatmapSetInfo = null;
+            FavouriteButton button = null;
+            BeatmapFavouriteAction? lastRequestAction = null;
+
+            AddStep("create beatmap set", () => beatmapSetInfo = CreateAPIBeatmapSet(Ruleset.Value));
+            AddStep("create button", () => Child = button = new FavouriteButton(beatmapSetInfo) { Scale = new Vector2(2) });
+
+            assertCorrectIcon(false);
+
+            AddStep("register request handling", () => dummyAPI.HandleRequest = request =>
+            {
+                if (!(request is PostBeatmapFavouriteRequest favouriteRequest))
+                    return false;
+
+                lastRequestAction = favouriteRequest.Action;
+                request.TriggerSuccess();
+                return true;
+            });
+
+            AddStep("click icon", () =>
+            {
+                InputManager.MoveMouseTo(button);
+                InputManager.Click(MouseButton.Left);
+            });
+            AddUntilStep("favourite request sent", () => lastRequestAction == BeatmapFavouriteAction.Favourite);
+            assertCorrectIcon(true);
+
+            AddStep("click icon", () =>
+            {
+                InputManager.MoveMouseTo(button);
+                InputManager.Click(MouseButton.Left);
+            });
+            AddUntilStep("unfavourite request sent", () => lastRequestAction == BeatmapFavouriteAction.UnFavourite);
+            assertCorrectIcon(false);
+        }
+
+        private void assertCorrectIcon(bool favourited) => AddAssert("icon correct",
+            () => this.ChildrenOfType<SpriteIcon>().Single().Icon.Equals(favourited ? FontAwesome.Solid.Heart : FontAwesome.Regular.Heart));
+    }
+}
diff --git a/osu.Game/Online/API/Requests/PostBeatmapFavouriteRequest.cs b/osu.Game/Online/API/Requests/PostBeatmapFavouriteRequest.cs
index f3724230cb..9fdc3382aa 100644
--- a/osu.Game/Online/API/Requests/PostBeatmapFavouriteRequest.cs
+++ b/osu.Game/Online/API/Requests/PostBeatmapFavouriteRequest.cs
@@ -8,20 +8,21 @@ namespace osu.Game.Online.API.Requests
 {
     public class PostBeatmapFavouriteRequest : APIRequest
     {
+        public readonly BeatmapFavouriteAction Action;
+
         private readonly int id;
-        private readonly BeatmapFavouriteAction action;
 
         public PostBeatmapFavouriteRequest(int id, BeatmapFavouriteAction action)
         {
             this.id = id;
-            this.action = action;
+            Action = action;
         }
 
         protected override WebRequest CreateWebRequest()
         {
             var req = base.CreateWebRequest();
             req.Method = HttpMethod.Post;
-            req.AddParameter(@"action", action.ToString().ToLowerInvariant());
+            req.AddParameter(@"action", Action.ToString().ToLowerInvariant());
             return req;
         }
 

From b5cbdcf9819dff87a57758b4577c80da49f9ed85 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 22 Oct 2021 23:36:27 +0200
Subject: [PATCH 0838/5547] Implement basic behaviour of favourite button

---
 .../Cards/Buttons/FavouriteButton.cs          | 50 ++++++++++++++++++-
 1 file changed, 48 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Beatmaps/Drawables/Cards/Buttons/FavouriteButton.cs b/osu.Game/Beatmaps/Drawables/Cards/Buttons/FavouriteButton.cs
index 1859a66821..145b3f41b0 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/Buttons/FavouriteButton.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/Buttons/FavouriteButton.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 osu.Framework.Allocation;
 using osu.Framework.Graphics.Sprites;
 using osu.Game.Online.API.Requests.Responses;
+using osu.Framework.Logging;
+using osu.Game.Online.API;
+using osu.Game.Online.API.Requests;
+using osu.Game.Resources.Localisation.Web;
 
 namespace osu.Game.Beatmaps.Drawables.Cards.Buttons
 {
@@ -10,13 +15,54 @@ namespace osu.Game.Beatmaps.Drawables.Cards.Buttons
     {
         private readonly APIBeatmapSet beatmapSet;
 
+        private PostBeatmapFavouriteRequest favouriteRequest;
+
         public FavouriteButton(APIBeatmapSet beatmapSet)
         {
             this.beatmapSet = beatmapSet;
 
-            Icon.Icon = FontAwesome.Regular.Heart;
+            updateState();
         }
 
-        // TODO: implement behaviour
+        [BackgroundDependencyLoader]
+        private void load(IAPIProvider api)
+        {
+            Action = () =>
+            {
+                var actionType = beatmapSet.HasFavourited ? BeatmapFavouriteAction.UnFavourite : BeatmapFavouriteAction.Favourite;
+
+                favouriteRequest?.Cancel();
+                favouriteRequest = new PostBeatmapFavouriteRequest(beatmapSet.OnlineID, actionType);
+
+                Enabled.Value = false;
+                favouriteRequest.Success += () =>
+                {
+                    beatmapSet.HasFavourited = actionType == BeatmapFavouriteAction.Favourite;
+                    Enabled.Value = true;
+                    updateState();
+                };
+                favouriteRequest.Failure += e =>
+                {
+                    Logger.Error(e, $"Failed to {actionType.ToString().ToLower()} beatmap: {e.Message}");
+                    Enabled.Value = true;
+                };
+
+                api.Queue(favouriteRequest);
+            };
+        }
+
+        private void updateState()
+        {
+            if (beatmapSet.HasFavourited)
+            {
+                Icon.Icon = FontAwesome.Solid.Heart;
+                TooltipText = BeatmapsetsStrings.ShowDetailsUnfavourite;
+            }
+            else
+            {
+                Icon.Icon = FontAwesome.Regular.Heart;
+                TooltipText = BeatmapsetsStrings.ShowDetailsFavourite;
+            }
+        }
     }
 }

From f4b8dee2d0562d931faf6a96f6326882f3190df8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 7 Nov 2021 17:42:32 +0100
Subject: [PATCH 0839/5547] Update favourite statistic value on favourite
 button clicks

---
 .../Visual/Beatmaps/TestSceneBeatmapCard.cs   | 18 +++++++++
 .../Beatmaps/Drawables/Cards/BeatmapCard.cs   |  7 +++-
 .../Cards/BeatmapSetFavouriteState.cs         | 31 ++++++++++++++++
 .../Cards/Buttons/FavouriteButton.cs          | 37 ++++++++++++++-----
 .../Cards/Statistics/FavouritesStatistic.cs   | 29 +++++++++++++--
 5 files changed, 106 insertions(+), 16 deletions(-)
 create mode 100644 osu.Game/Beatmaps/Drawables/Cards/BeatmapSetFavouriteState.cs

diff --git a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs
index 8bfee02310..0feaa8f480 100644
--- a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs
+++ b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs
@@ -9,8 +9,11 @@ using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
+using osu.Framework.Testing;
 using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.Drawables.Cards;
+using osu.Game.Online.API;
+using osu.Game.Online.API.Requests;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays;
 using osuTK;
@@ -20,6 +23,8 @@ namespace osu.Game.Tests.Visual.Beatmaps
 {
     public class TestSceneBeatmapCard : OsuTestScene
     {
+        private DummyAPIAccess dummyAPI => (DummyAPIAccess)API;
+
         private APIBeatmapSet[] testCases;
 
         #region Test case generation
@@ -164,6 +169,19 @@ namespace osu.Game.Tests.Visual.Beatmaps
 
         #endregion
 
+        [SetUpSteps]
+        public void SetUpSteps()
+        {
+            AddStep("register request handling", () => dummyAPI.HandleRequest = request =>
+            {
+                if (!(request is PostBeatmapFavouriteRequest))
+                    return false;
+
+                request.TriggerSuccess();
+                return true;
+            });
+        }
+
         private Drawable createContent(OverlayColourScheme colourScheme, Func<APIBeatmapSet, Drawable> creationFunc)
         {
             var colourProvider = new OverlayColourProvider(colourScheme);
diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
index a3650315cc..71376c28f1 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
@@ -3,6 +3,7 @@
 
 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;
@@ -35,6 +36,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
         private const float corner_radius = 10;
 
         private readonly APIBeatmapSet beatmapSet;
+        private readonly Bindable<BeatmapSetFavouriteState> favouriteState;
 
         private UpdateableOnlineBeatmapSetCover leftCover;
         private FillFlowContainer leftIconArea;
@@ -55,6 +57,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
             : base(HoverSampleSet.Submit)
         {
             this.beatmapSet = beatmapSet;
+            favouriteState = new Bindable<BeatmapSetFavouriteState>(new BeatmapSetFavouriteState(beatmapSet.HasFavourited, beatmapSet.FavouriteCount));
         }
 
         [BackgroundDependencyLoader]
@@ -108,7 +111,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                         Spacing = new Vector2(0, 14),
                         Children = new BeatmapCardIconButton[]
                         {
-                            new FavouriteButton(beatmapSet),
+                            new FavouriteButton(beatmapSet) { Current = favouriteState },
                             new DownloadButton(beatmapSet)
                         }
                     }
@@ -312,7 +315,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
             if (beatmapSet.HypeStatus != null && beatmapSet.NominationStatus != null)
                 yield return new NominationsStatistic(beatmapSet.NominationStatus);
 
-            yield return new FavouritesStatistic(beatmapSet);
+            yield return new FavouritesStatistic(beatmapSet) { Current = favouriteState };
             yield return new PlayCountStatistic(beatmapSet);
 
             var dateStatistic = BeatmapCardDateStatistic.CreateFor(beatmapSet);
diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapSetFavouriteState.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapSetFavouriteState.cs
new file mode 100644
index 0000000000..82523cc865
--- /dev/null
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapSetFavouriteState.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.Game.Beatmaps.Drawables.Cards.Buttons;
+using osu.Game.Beatmaps.Drawables.Cards.Statistics;
+
+namespace osu.Game.Beatmaps.Drawables.Cards
+{
+    /// <summary>
+    /// Stores the current favourite state of a beatmap set.
+    /// Used to coordinate between <see cref="FavouriteButton"/> and <see cref="FavouritesStatistic"/>.
+    /// </summary>
+    public readonly struct BeatmapSetFavouriteState
+    {
+        /// <summary>
+        /// Whether the currently logged-in user has favourited this beatmap.
+        /// </summary>
+        public bool Favourited { get; }
+
+        /// <summary>
+        /// The number of favourites that the beatmap set has received, including the currently logged-in user.
+        /// </summary>
+        public int FavouriteCount { get; }
+
+        public BeatmapSetFavouriteState(bool favourited, int favouriteCount)
+        {
+            Favourited = favourited;
+            FavouriteCount = favouriteCount;
+        }
+    }
+}
diff --git a/osu.Game/Beatmaps/Drawables/Cards/Buttons/FavouriteButton.cs b/osu.Game/Beatmaps/Drawables/Cards/Buttons/FavouriteButton.cs
index 145b3f41b0..0b43b1c619 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/Buttons/FavouriteButton.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/Buttons/FavouriteButton.cs
@@ -2,7 +2,9 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using osu.Framework.Allocation;
+using osu.Framework.Bindables;
 using osu.Framework.Graphics.Sprites;
+using osu.Framework.Graphics.UserInterface;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Framework.Logging;
 using osu.Game.Online.API;
@@ -11,17 +13,24 @@ using osu.Game.Resources.Localisation.Web;
 
 namespace osu.Game.Beatmaps.Drawables.Cards.Buttons
 {
-    public class FavouriteButton : BeatmapCardIconButton
+    public class FavouriteButton : BeatmapCardIconButton, IHasCurrentValue<BeatmapSetFavouriteState>
     {
-        private readonly APIBeatmapSet beatmapSet;
+        private readonly BindableWithCurrent<BeatmapSetFavouriteState> current;
+
+        public Bindable<BeatmapSetFavouriteState> Current
+        {
+            get => current.Current;
+            set => current.Current = value;
+        }
+
+        private readonly int onlineBeatmapID;
 
         private PostBeatmapFavouriteRequest favouriteRequest;
 
         public FavouriteButton(APIBeatmapSet beatmapSet)
         {
-            this.beatmapSet = beatmapSet;
-
-            updateState();
+            current = new BindableWithCurrent<BeatmapSetFavouriteState>(new BeatmapSetFavouriteState(beatmapSet.HasFavourited, beatmapSet.FavouriteCount));
+            onlineBeatmapID = beatmapSet.OnlineID;
         }
 
         [BackgroundDependencyLoader]
@@ -29,17 +38,19 @@ namespace osu.Game.Beatmaps.Drawables.Cards.Buttons
         {
             Action = () =>
             {
-                var actionType = beatmapSet.HasFavourited ? BeatmapFavouriteAction.UnFavourite : BeatmapFavouriteAction.Favourite;
+                var actionType = current.Value.Favourited ? BeatmapFavouriteAction.UnFavourite : BeatmapFavouriteAction.Favourite;
 
                 favouriteRequest?.Cancel();
-                favouriteRequest = new PostBeatmapFavouriteRequest(beatmapSet.OnlineID, actionType);
+                favouriteRequest = new PostBeatmapFavouriteRequest(onlineBeatmapID, actionType);
 
                 Enabled.Value = false;
                 favouriteRequest.Success += () =>
                 {
-                    beatmapSet.HasFavourited = actionType == BeatmapFavouriteAction.Favourite;
+                    bool favourited = actionType == BeatmapFavouriteAction.Favourite;
+
+                    current.Value = new BeatmapSetFavouriteState(favourited, current.Value.FavouriteCount + (favourited ? 1 : -1));
+
                     Enabled.Value = true;
-                    updateState();
                 };
                 favouriteRequest.Failure += e =>
                 {
@@ -51,9 +62,15 @@ namespace osu.Game.Beatmaps.Drawables.Cards.Buttons
             };
         }
 
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+            current.BindValueChanged(_ => updateState(), true);
+        }
+
         private void updateState()
         {
-            if (beatmapSet.HasFavourited)
+            if (current.Value.Favourited)
             {
                 Icon.Icon = FontAwesome.Solid.Heart;
                 TooltipText = BeatmapsetsStrings.ShowDetailsUnfavourite;
diff --git a/osu.Game/Beatmaps/Drawables/Cards/Statistics/FavouritesStatistic.cs b/osu.Game/Beatmaps/Drawables/Cards/Statistics/FavouritesStatistic.cs
index 7b3286ddcc..d924fd938b 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/Statistics/FavouritesStatistic.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/Statistics/FavouritesStatistic.cs
@@ -2,8 +2,10 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using Humanizer;
+using osu.Framework.Bindables;
 using osu.Framework.Extensions.LocalisationExtensions;
 using osu.Framework.Graphics.Sprites;
+using osu.Framework.Graphics.UserInterface;
 using osu.Game.Resources.Localisation.Web;
 
 namespace osu.Game.Beatmaps.Drawables.Cards.Statistics
@@ -11,13 +13,32 @@ namespace osu.Game.Beatmaps.Drawables.Cards.Statistics
     /// <summary>
     /// Shows the number of favourites that a beatmap set has received.
     /// </summary>
-    public class FavouritesStatistic : BeatmapCardStatistic
+    public class FavouritesStatistic : BeatmapCardStatistic, IHasCurrentValue<BeatmapSetFavouriteState>
     {
+        private readonly BindableWithCurrent<BeatmapSetFavouriteState> current;
+
+        public Bindable<BeatmapSetFavouriteState> Current
+        {
+            get => current.Current;
+            set => current.Current = value;
+        }
+
         public FavouritesStatistic(IBeatmapSetOnlineInfo onlineInfo)
         {
-            Icon = onlineInfo.HasFavourited ? FontAwesome.Solid.Heart : FontAwesome.Regular.Heart;
-            Text = onlineInfo.FavouriteCount.ToMetric(decimals: 1);
-            TooltipText = BeatmapsStrings.PanelFavourites(onlineInfo.FavouriteCount.ToLocalisableString(@"N0"));
+            current = new BindableWithCurrent<BeatmapSetFavouriteState>(new BeatmapSetFavouriteState(onlineInfo.HasFavourited, onlineInfo.FavouriteCount));
+        }
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+            current.BindValueChanged(_ => updateState(), true);
+        }
+
+        private void updateState()
+        {
+            Icon = current.Value.Favourited ? FontAwesome.Solid.Heart : FontAwesome.Regular.Heart;
+            Text = current.Value.FavouriteCount.ToMetric(decimals: 1);
+            TooltipText = BeatmapsStrings.PanelFavourites(current.Value.FavouriteCount.ToLocalisableString(@"N0"));
         }
     }
 }

From d88fd1bfd7a71d43ec907a66fb4038f9d1c36222 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 8 Nov 2021 13:23:24 +0100
Subject: [PATCH 0840/5547] Add failing test case

---
 .../Editor/TestSceneEditorSaving.cs           | 91 +++++++++++++++++++
 .../Beatmaps/TaikoBeatmapConverter.cs         |  2 +-
 2 files changed, 92 insertions(+), 1 deletion(-)
 create mode 100644 osu.Game.Rulesets.Taiko.Tests/Editor/TestSceneEditorSaving.cs

diff --git a/osu.Game.Rulesets.Taiko.Tests/Editor/TestSceneEditorSaving.cs b/osu.Game.Rulesets.Taiko.Tests/Editor/TestSceneEditorSaving.cs
new file mode 100644
index 0000000000..159a64d1ac
--- /dev/null
+++ b/osu.Game.Rulesets.Taiko.Tests/Editor/TestSceneEditorSaving.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.
+
+using System.Linq;
+using NUnit.Framework;
+using osu.Framework.Input;
+using osu.Framework.Testing;
+using osu.Framework.Utils;
+using osu.Game.Beatmaps;
+using osu.Game.Rulesets.Edit;
+using osu.Game.Rulesets.Taiko.Beatmaps;
+using osu.Game.Screens.Edit;
+using osu.Game.Screens.Edit.Setup;
+using osu.Game.Screens.Menu;
+using osu.Game.Screens.Select;
+using osu.Game.Tests.Visual;
+using osuTK.Input;
+
+namespace osu.Game.Rulesets.Taiko.Tests.Editor
+{
+    public class TestSceneEditorSaving : OsuGameTestScene
+    {
+        private Screens.Edit.Editor editor => Game.ChildrenOfType<Screens.Edit.Editor>().FirstOrDefault();
+
+        private EditorBeatmap editorBeatmap => (EditorBeatmap)editor.Dependencies.Get(typeof(EditorBeatmap));
+
+        /// <summary>
+        /// Tests the general expected flow of creating a new beatmap, saving it, then loading it back from song select.
+        /// Emphasis is placed on <see cref="BeatmapDifficulty.SliderMultiplier"/>, since taiko has special handling for it to keep compatibility with stable.
+        /// </summary>
+        [Test]
+        public void TestNewBeatmapSaveThenLoad()
+        {
+            AddStep("set default beatmap", () => Game.Beatmap.SetDefault());
+            AddStep("set taiko ruleset", () => Ruleset.Value = new TaikoRuleset().RulesetInfo);
+
+            PushAndConfirm(() => new EditorLoader());
+
+            AddUntilStep("wait for editor load", () => editor?.IsLoaded == true);
+
+            AddUntilStep("wait for metadata screen load", () => editor.ChildrenOfType<MetadataSection>().FirstOrDefault()?.IsLoaded == true);
+
+            // We intentionally switch away from the metadata screen, else there is a feedback loop with the textbox handling which causes metadata changes below to get overwritten.
+
+            AddStep("Enter compose mode", () => InputManager.Key(Key.F1));
+            AddUntilStep("Wait for compose mode load", () => editor.ChildrenOfType<HitObjectComposer>().FirstOrDefault()?.IsLoaded == true);
+
+            AddStep("Set slider multiplier", () => editorBeatmap.Difficulty.SliderMultiplier = 2);
+            AddStep("Set artist and title", () =>
+            {
+                editorBeatmap.BeatmapInfo.Metadata.Artist = "artist";
+                editorBeatmap.BeatmapInfo.Metadata.Title = "title";
+            });
+            AddStep("Set difficulty name", () => editorBeatmap.BeatmapInfo.Version = "difficulty");
+
+            checkMutations();
+
+            AddStep("Save", () => InputManager.Keys(PlatformAction.Save));
+
+            checkMutations();
+
+            AddStep("Exit", () => InputManager.Key(Key.Escape));
+
+            AddUntilStep("Wait for main menu", () => Game.ScreenStack.CurrentScreen is MainMenu);
+
+            PushAndConfirm(() => new PlaySongSelect());
+
+            AddUntilStep("Wait for beatmap selected", () => !Game.Beatmap.IsDefault);
+            AddStep("Open options", () => InputManager.Key(Key.F3));
+            AddStep("Enter editor", () => InputManager.Key(Key.Number5));
+
+            AddUntilStep("Wait for editor load", () => editor != null);
+
+            checkMutations();
+        }
+
+        private void checkMutations()
+        {
+            AddAssert("Beatmap has correct slider multiplier", () =>
+            {
+                // we can only assert value correctness on TaikoMultiplierAppliedDifficulty, because that is the final difficulty converted taiko beatmaps use.
+                // therefore, ensure that we have that difficulty type by calling .CopyFrom(), which is a no-op if the type is already correct.
+                var taikoDifficulty = new TaikoBeatmapConverter.TaikoMultiplierAppliedDifficulty();
+                taikoDifficulty.CopyFrom(editorBeatmap.Difficulty);
+                return Precision.AlmostEquals(taikoDifficulty.SliderMultiplier, 2);
+            });
+            AddAssert("Beatmap has correct metadata", () => editorBeatmap.BeatmapInfo.Metadata.Artist == "artist" && editorBeatmap.BeatmapInfo.Metadata.Title == "title");
+            AddAssert("Beatmap has correct difficulty name", () => editorBeatmap.BeatmapInfo.Version == "difficulty");
+        }
+    }
+}
diff --git a/osu.Game.Rulesets.Taiko/Beatmaps/TaikoBeatmapConverter.cs b/osu.Game.Rulesets.Taiko/Beatmaps/TaikoBeatmapConverter.cs
index 94dfb67d93..dc0edd92ea 100644
--- a/osu.Game.Rulesets.Taiko/Beatmaps/TaikoBeatmapConverter.cs
+++ b/osu.Game.Rulesets.Taiko/Beatmaps/TaikoBeatmapConverter.cs
@@ -191,7 +191,7 @@ namespace osu.Game.Rulesets.Taiko.Beatmaps
 
         protected override Beatmap<TaikoHitObject> CreateBeatmap() => new TaikoBeatmap();
 
-        private class TaikoMultiplierAppliedDifficulty : BeatmapDifficulty
+        internal class TaikoMultiplierAppliedDifficulty : BeatmapDifficulty
         {
             public TaikoMultiplierAppliedDifficulty(IBeatmapDifficultyInfo difficulty)
             {

From 540b7e1b386c149940847b6583c33dfd63f97974 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 8 Nov 2021 13:23:54 +0100
Subject: [PATCH 0841/5547] Fix taiko editor not unapplying slider multiplier
 changes on save

---
 osu.Game.Rulesets.Taiko/Beatmaps/TaikoBeatmapConverter.cs | 2 +-
 osu.Game/Beatmaps/BeatmapModelManager.cs                  | 6 +++++-
 2 files changed, 6 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Rulesets.Taiko/Beatmaps/TaikoBeatmapConverter.cs b/osu.Game.Rulesets.Taiko/Beatmaps/TaikoBeatmapConverter.cs
index dc0edd92ea..9b2e9fedc5 100644
--- a/osu.Game.Rulesets.Taiko/Beatmaps/TaikoBeatmapConverter.cs
+++ b/osu.Game.Rulesets.Taiko/Beatmaps/TaikoBeatmapConverter.cs
@@ -209,7 +209,7 @@ namespace osu.Game.Rulesets.Taiko.Beatmaps
             {
                 base.CopyTo(other);
                 if (!(other is TaikoMultiplierAppliedDifficulty))
-                    SliderMultiplier /= LegacyBeatmapEncoder.LEGACY_TAIKO_VELOCITY_MULTIPLIER;
+                    other.SliderMultiplier /= LegacyBeatmapEncoder.LEGACY_TAIKO_VELOCITY_MULTIPLIER;
             }
 
             public override void CopyFrom(IBeatmapDifficultyInfo other)
diff --git a/osu.Game/Beatmaps/BeatmapModelManager.cs b/osu.Game/Beatmaps/BeatmapModelManager.cs
index eb1bf598a4..a654b05edb 100644
--- a/osu.Game/Beatmaps/BeatmapModelManager.cs
+++ b/osu.Game/Beatmaps/BeatmapModelManager.cs
@@ -189,7 +189,11 @@ namespace osu.Game.Beatmaps
 
             // Difficulty settings must be copied first due to the clone in `Beatmap<>.BeatmapInfo_Set`.
             // This should hopefully be temporary, assuming said clone is eventually removed.
-            beatmapInfo.BaseDifficulty.CopyFrom(beatmapContent.Difficulty);
+
+            // Warning: The directionality here is important. Changes have to be copied *from* beatmapContent (which comes from editor and is being saved)
+            // *to* the beatmapInfo (which is a database model and needs to receive values without the taiko slider velocity multiplier for correct operation).
+            // CopyTo() will undo such adjustments, while CopyFrom() will not.
+            beatmapContent.Difficulty.CopyTo(beatmapInfo.BaseDifficulty);
 
             // All changes to metadata are made in the provided beatmapInfo, so this should be copied to the `IBeatmap` before encoding.
             beatmapContent.BeatmapInfo = beatmapInfo;

From 9a2425f316903a8725da40f6d0374afa91aebe8c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 8 Nov 2021 21:36:28 +0900
Subject: [PATCH 0842/5547] Remove unused field for now to appease inspectcode

---
 osu.Game/Beatmaps/Drawables/Cards/Buttons/DownloadButton.cs | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/osu.Game/Beatmaps/Drawables/Cards/Buttons/DownloadButton.cs b/osu.Game/Beatmaps/Drawables/Cards/Buttons/DownloadButton.cs
index da6fe3c8be..00c0ccc3ce 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/Buttons/DownloadButton.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/Buttons/DownloadButton.cs
@@ -8,12 +8,8 @@ namespace osu.Game.Beatmaps.Drawables.Cards.Buttons
 {
     public class DownloadButton : BeatmapCardIconButton
     {
-        private readonly APIBeatmapSet beatmapSet;
-
         public DownloadButton(APIBeatmapSet beatmapSet)
         {
-            this.beatmapSet = beatmapSet;
-
             Icon.Icon = FontAwesome.Solid.FileDownload;
         }
 

From 72489b32f922bc38f5306e5556411f32c5c582d1 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 8 Nov 2021 21:39:16 +0900
Subject: [PATCH 0843/5547] Move toggle code into own method for readability

---
 .../Cards/Buttons/FavouriteButton.cs          | 59 ++++++++++---------
 1 file changed, 30 insertions(+), 29 deletions(-)

diff --git a/osu.Game/Beatmaps/Drawables/Cards/Buttons/FavouriteButton.cs b/osu.Game/Beatmaps/Drawables/Cards/Buttons/FavouriteButton.cs
index 0b43b1c619..a61065b468 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/Buttons/FavouriteButton.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/Buttons/FavouriteButton.cs
@@ -27,47 +27,48 @@ namespace osu.Game.Beatmaps.Drawables.Cards.Buttons
 
         private PostBeatmapFavouriteRequest favouriteRequest;
 
+        [Resolved]
+        private IAPIProvider api { get; set; }
+
         public FavouriteButton(APIBeatmapSet beatmapSet)
         {
             current = new BindableWithCurrent<BeatmapSetFavouriteState>(new BeatmapSetFavouriteState(beatmapSet.HasFavourited, beatmapSet.FavouriteCount));
             onlineBeatmapID = beatmapSet.OnlineID;
         }
 
-        [BackgroundDependencyLoader]
-        private void load(IAPIProvider api)
-        {
-            Action = () =>
-            {
-                var actionType = current.Value.Favourited ? BeatmapFavouriteAction.UnFavourite : BeatmapFavouriteAction.Favourite;
-
-                favouriteRequest?.Cancel();
-                favouriteRequest = new PostBeatmapFavouriteRequest(onlineBeatmapID, actionType);
-
-                Enabled.Value = false;
-                favouriteRequest.Success += () =>
-                {
-                    bool favourited = actionType == BeatmapFavouriteAction.Favourite;
-
-                    current.Value = new BeatmapSetFavouriteState(favourited, current.Value.FavouriteCount + (favourited ? 1 : -1));
-
-                    Enabled.Value = true;
-                };
-                favouriteRequest.Failure += e =>
-                {
-                    Logger.Error(e, $"Failed to {actionType.ToString().ToLower()} beatmap: {e.Message}");
-                    Enabled.Value = true;
-                };
-
-                api.Queue(favouriteRequest);
-            };
-        }
-
         protected override void LoadComplete()
         {
             base.LoadComplete();
+
+            Action = toggleFavouriteStatus;
             current.BindValueChanged(_ => updateState(), true);
         }
 
+        private void toggleFavouriteStatus()
+        {
+            var actionType = current.Value.Favourited ? BeatmapFavouriteAction.UnFavourite : BeatmapFavouriteAction.Favourite;
+
+            favouriteRequest?.Cancel();
+            favouriteRequest = new PostBeatmapFavouriteRequest(onlineBeatmapID, actionType);
+
+            Enabled.Value = false;
+            favouriteRequest.Success += () =>
+            {
+                bool favourited = actionType == BeatmapFavouriteAction.Favourite;
+
+                current.Value = new BeatmapSetFavouriteState(favourited, current.Value.FavouriteCount + (favourited ? 1 : -1));
+
+                Enabled.Value = true;
+            };
+            favouriteRequest.Failure += e =>
+            {
+                Logger.Error(e, $"Failed to {actionType.ToString().ToLower()} beatmap: {e.Message}");
+                Enabled.Value = true;
+            };
+
+            api.Queue(favouriteRequest);
+        }
+
         private void updateState()
         {
             if (current.Value.Favourited)

From 74603253d2522baeb5342a68ee970c387efdb69a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 8 Nov 2021 13:42:56 +0100
Subject: [PATCH 0844/5547] Store full model rather than online ID only

---
 .../Beatmaps/Drawables/Cards/Buttons/FavouriteButton.cs     | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Beatmaps/Drawables/Cards/Buttons/FavouriteButton.cs b/osu.Game/Beatmaps/Drawables/Cards/Buttons/FavouriteButton.cs
index a61065b468..9fed2fde6f 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/Buttons/FavouriteButton.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/Buttons/FavouriteButton.cs
@@ -23,7 +23,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards.Buttons
             set => current.Current = value;
         }
 
-        private readonly int onlineBeatmapID;
+        private readonly APIBeatmapSet beatmapSet;
 
         private PostBeatmapFavouriteRequest favouriteRequest;
 
@@ -33,7 +33,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards.Buttons
         public FavouriteButton(APIBeatmapSet beatmapSet)
         {
             current = new BindableWithCurrent<BeatmapSetFavouriteState>(new BeatmapSetFavouriteState(beatmapSet.HasFavourited, beatmapSet.FavouriteCount));
-            onlineBeatmapID = beatmapSet.OnlineID;
+            this.beatmapSet = beatmapSet;
         }
 
         protected override void LoadComplete()
@@ -49,7 +49,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards.Buttons
             var actionType = current.Value.Favourited ? BeatmapFavouriteAction.UnFavourite : BeatmapFavouriteAction.Favourite;
 
             favouriteRequest?.Cancel();
-            favouriteRequest = new PostBeatmapFavouriteRequest(onlineBeatmapID, actionType);
+            favouriteRequest = new PostBeatmapFavouriteRequest(beatmapSet.OnlineID, actionType);
 
             Enabled.Value = false;
             favouriteRequest.Success += () =>

From d5ad776c33d88335e3a3a70c853a9d62c34c6d63 Mon Sep 17 00:00:00 2001
From: Chinmay Patil <chinmaytlc@gmail.com>
Date: Mon, 8 Nov 2021 06:27:25 -0700
Subject: [PATCH 0845/5547] Remove decimal part of UR Counter and rename
 methods

---
 .../Screens/Play/HUD/UnstableRateCounter.cs   | 50 +++++++------------
 1 file changed, 18 insertions(+), 32 deletions(-)

diff --git a/osu.Game/Screens/Play/HUD/UnstableRateCounter.cs b/osu.Game/Screens/Play/HUD/UnstableRateCounter.cs
index f7263b29e9..89ae4f8a21 100644
--- a/osu.Game/Screens/Play/HUD/UnstableRateCounter.cs
+++ b/osu.Game/Screens/Play/HUD/UnstableRateCounter.cs
@@ -6,7 +6,6 @@ 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.Sprites;
@@ -21,7 +20,7 @@ using osu.Game.Skinning;
 
 namespace osu.Game.Screens.Play.HUD
 {
-    public class UnstableRateCounter : RollingCounter<double>, ISkinnableDrawable
+    public class UnstableRateCounter : RollingCounter<int>, ISkinnableDrawable
     {
         public bool UsesFixedAnchor { get; set; }
 
@@ -37,7 +36,7 @@ namespace osu.Game.Screens.Play.HUD
 
         public UnstableRateCounter()
         {
-            Current.Value = 0.0;
+            Current.Value = 0;
         }
 
         [BackgroundDependencyLoader]
@@ -48,10 +47,8 @@ namespace osu.Game.Screens.Play.HUD
                 DrawableCount.FadeTo(e.NewValue ? 1 : alpha_when_invalid, 1000, Easing.OutQuint));
         }
 
-        private bool isUrInvalid(JudgementResult judgement)
-        {
-            return judgement.HitObject.HitWindows is HitWindows.EmptyHitWindows || !judgement.IsHit;
-        }
+        private bool changesUnstableRate(JudgementResult judgement)
+            => !(judgement.HitObject.HitWindows is HitWindows.EmptyHitWindows) && judgement.IsHit;
 
         protected override void LoadComplete()
         {
@@ -63,28 +60,28 @@ namespace osu.Game.Screens.Play.HUD
 
         private void onJudgementAdded(JudgementResult judgement)
         {
-            if (isUrInvalid(judgement)) return;
+            if (!changesUnstableRate(judgement)) return;
 
             hitOffsets.Add(judgement.TimeOffset);
-            updateUr();
+            updateDisplay();
         }
 
         private void onJudgementReverted(JudgementResult judgement)
         {
-            if (judgement.FailedAtJudgement || isUrInvalid(judgement)) return;
+            if (judgement.FailedAtJudgement || !changesUnstableRate(judgement)) return;
 
             hitOffsets.RemoveAt(hitOffsets.Count - 1);
-            updateUr();
+            updateDisplay();
         }
 
-        private void updateUr()
+        private void updateDisplay()
         {
             // At Count = 0, we get NaN, While we are allowing count = 1, it will be 0 since average = offset.
             if (hitOffsets.Count > 0)
             {
                 double mean = hitOffsets.Average();
                 double squares = hitOffsets.Select(offset => Math.Pow(offset - mean, 2)).Sum();
-                Current.Value = Math.Sqrt(squares / hitOffsets.Count) * 10;
+                Current.Value = (int)(Math.Sqrt(squares / hitOffsets.Count) * 10);
                 valid.Value = true;
             }
             else
@@ -94,11 +91,6 @@ namespace osu.Game.Screens.Play.HUD
             }
         }
 
-        protected override LocalisableString FormatCount(double count)
-        {
-            return count.ToString("0.00");
-        }
-
         protected override IHasText CreateText() => new TextComponent
         {
             Alpha = alpha_when_invalid,
@@ -108,6 +100,8 @@ namespace osu.Game.Screens.Play.HUD
         {
             base.Dispose(isDisposing);
 
+            if (scoreProcessor == null) return;
+
             scoreProcessor.NewJudgement -= onJudgementAdded;
             scoreProcessor.JudgementReverted -= onJudgementReverted;
         }
@@ -116,20 +110,11 @@ namespace osu.Game.Screens.Play.HUD
         {
             public LocalisableString Text
             {
-                get => fullValue.ToLocalisableString("0.00 UR");
-                set
-                {
-                    fullValue = Convert.ToDouble(value.ToString());
-                    intPart.Text = fullValue.ToLocalisableString("0");
-                    decimalPart.Text = (fullValue - Math.Truncate(fullValue))
-                        .ToLocalisableString(".00 UR");
-                }
+                get => text.Text;
+                set => text.Text = value;
             }
 
-            private double fullValue;
-
-            private readonly OsuSpriteText intPart;
-            private readonly OsuSpriteText decimalPart;
+            private readonly OsuSpriteText text;
 
             public TextComponent()
             {
@@ -140,17 +125,18 @@ namespace osu.Game.Screens.Play.HUD
                     AutoSizeAxes = Axes.Both,
                     Children = new Drawable[]
                     {
-                        intPart = new OsuSpriteText
+                        text = new OsuSpriteText
                         {
                             Anchor = Anchor.BottomLeft,
                             Origin = Anchor.BottomLeft,
                             Font = OsuFont.Numeric.With(size: 16, fixedWidth: true)
                         },
-                        decimalPart = new OsuSpriteText
+                        new OsuSpriteText
                         {
                             Anchor = Anchor.BottomLeft,
                             Origin = Anchor.BottomLeft,
                             Font = OsuFont.Numeric.With(size: 8, fixedWidth: true),
+                            Text = "UR",
                             Padding = new MarginPadding { Bottom = 1.5f },
                         }
                     }

From 8a23b648feb13433847f5a7979563f512f6a4222 Mon Sep 17 00:00:00 2001
From: Susko3 <16479013+Susko3@users.noreply.github.com>
Date: Mon, 8 Nov 2021 14:32:00 +0100
Subject: [PATCH 0846/5547] Move `HoverClickSounds` to the clickable button

---
 osu.Game/Overlays/Settings/Sections/Input/KeyBindingRow.cs | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Overlays/Settings/Sections/Input/KeyBindingRow.cs b/osu.Game/Overlays/Settings/Sections/Input/KeyBindingRow.cs
index e6472dffeb..96a685a9c5 100644
--- a/osu.Game/Overlays/Settings/Sections/Input/KeyBindingRow.cs
+++ b/osu.Game/Overlays/Settings/Sections/Input/KeyBindingRow.cs
@@ -153,12 +153,12 @@ namespace osu.Game.Overlays.Settings.Sections.Input
                                         new CancelButton { Action = finalise },
                                         new ClearButton { Action = clear },
                                     },
-                                }
+                                },
+                                new HoverClickSounds()
                             }
                         }
                     }
-                },
-                new HoverClickSounds()
+                }
             };
 
             foreach (var b in bindings)

From 1b11a034a75a59bd8bbf7eec441df298457e110e Mon Sep 17 00:00:00 2001
From: Chinmay Patil <chinmaytlc@gmail.com>
Date: Mon, 8 Nov 2021 07:25:02 -0700
Subject: [PATCH 0847/5547] Reverted Default Skin Changes

---
 osu.Game/Skinning/DefaultSkin.cs | 14 ++------------
 1 file changed, 2 insertions(+), 12 deletions(-)

diff --git a/osu.Game/Skinning/DefaultSkin.cs b/osu.Game/Skinning/DefaultSkin.cs
index e887ccb2e3..c377f16f8b 100644
--- a/osu.Game/Skinning/DefaultSkin.cs
+++ b/osu.Game/Skinning/DefaultSkin.cs
@@ -68,7 +68,6 @@ namespace osu.Game.Skinning
                                 var accuracy = container.OfType<DefaultAccuracyCounter>().FirstOrDefault();
                                 var combo = container.OfType<DefaultComboCounter>().FirstOrDefault();
                                 var ppCounter = container.OfType<PerformancePointsCounter>().FirstOrDefault();
-                                var unstableRate = container.OfType<UnstableRateCounter>().FirstOrDefault();
 
                                 if (score != null)
                                 {
@@ -85,17 +84,9 @@ namespace osu.Game.Skinning
                                     if (ppCounter != null)
                                     {
                                         ppCounter.Y = score.Position.Y + ppCounter.ScreenSpaceDeltaToParentSpace(score.ScreenSpaceDrawQuad.Size).Y - 4;
-                                        ppCounter.X = ppCounter.ScreenSpaceDeltaToParentSpace(score.ScreenSpaceDrawQuad.Size).X / 2 - horizontal_padding;
-                                        ppCounter.Origin = Anchor.TopRight;
+                                        ppCounter.Origin = Anchor.TopCentre;
                                         ppCounter.Anchor = Anchor.TopCentre;
                                     }
-                                    if (unstableRate != null)
-                                    {
-                                        unstableRate.Y = ppCounter.Position.Y;
-                                        unstableRate.X = -unstableRate.ScreenSpaceDeltaToParentSpace(score.ScreenSpaceDrawQuad.Size).X / 2 + horizontal_padding;
-                                        unstableRate.Origin = Anchor.TopLeft;
-                                        unstableRate.Anchor = Anchor.TopCentre;
-                                    }
 
                                     if (accuracy != null)
                                     {
@@ -139,8 +130,7 @@ namespace osu.Game.Skinning
                                     new SongProgress(),
                                     new BarHitErrorMeter(),
                                     new BarHitErrorMeter(),
-                                    new PerformancePointsCounter(),
-                                    new UnstableRateCounter()
+                                    new PerformancePointsCounter()
                                 }
                             };
 

From e6f39c4cada3e180d524be7c5fc0a8d3e7e6b206 Mon Sep 17 00:00:00 2001
From: Lucas A <game4allyt@gmail.com>
Date: Mon, 8 Nov 2021 21:38:01 +0100
Subject: [PATCH 0848/5547] Fix settings header text overflowing with some
 locales.

---
 osu.Game/Overlays/Settings/SettingsHeader.cs | 43 ++++++++------------
 1 file changed, 17 insertions(+), 26 deletions(-)

diff --git a/osu.Game/Overlays/Settings/SettingsHeader.cs b/osu.Game/Overlays/Settings/SettingsHeader.cs
index 69b7b69a29..8d6e93be9d 100644
--- a/osu.Game/Overlays/Settings/SettingsHeader.cs
+++ b/osu.Game/Overlays/Settings/SettingsHeader.cs
@@ -6,7 +6,7 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Localisation;
 using osu.Game.Graphics;
-using osu.Game.Graphics.Sprites;
+using osu.Game.Graphics.Containers;
 
 namespace osu.Game.Overlays.Settings
 {
@@ -29,36 +29,27 @@ namespace osu.Game.Overlays.Settings
 
             Children = new Drawable[]
             {
-                new FillFlowContainer
+                new OsuTextFlowContainer
                 {
                     AutoSizeAxes = Axes.Y,
                     RelativeSizeAxes = Axes.X,
-                    Direction = FillDirection.Vertical,
-                    Children = new Drawable[]
+                    Margin = new MarginPadding
                     {
-                        new OsuSpriteText
-                        {
-                            Text = heading,
-                            Font = OsuFont.TorusAlternate.With(size: 40),
-                            Margin = new MarginPadding
-                            {
-                                Left = SettingsPanel.CONTENT_MARGINS,
-                                Top = Toolbar.Toolbar.TOOLTIP_HEIGHT
-                            },
-                        },
-                        new OsuSpriteText
-                        {
-                            Colour = colourProvider.Content2,
-                            Text = subheading,
-                            Font = OsuFont.GetFont(size: 18),
-                            Margin = new MarginPadding
-                            {
-                                Left = SettingsPanel.CONTENT_MARGINS,
-                                Bottom = 30
-                            },
-                        },
+                        Left = SettingsPanel.CONTENT_MARGINS,
+                        Top = Toolbar.Toolbar.TOOLTIP_HEIGHT,
+                        Bottom = 30
                     }
-                }
+                }.With(flow =>
+                {
+                    flow.AddText(heading, header => header.Font = OsuFont.TorusAlternate.With(size: 40));
+                    flow.NewLine();
+                    flow.AddText(subheading, subheader =>
+                    {
+                        subheader.Colour = colourProvider.Content2;
+                        subheader.Font = OsuFont.GetFont(size: 18);
+                    });
+
+                })
             };
         }
     }

From b7e7b0f850766a568e1e08aa985826402f27d1cb Mon Sep 17 00:00:00 2001
From: Lucas A <game4allyt@gmail.com>
Date: Mon, 8 Nov 2021 21:42:51 +0100
Subject: [PATCH 0849/5547] Trim whitespace.

---
 osu.Game/Overlays/Settings/SettingsHeader.cs | 1 -
 1 file changed, 1 deletion(-)

diff --git a/osu.Game/Overlays/Settings/SettingsHeader.cs b/osu.Game/Overlays/Settings/SettingsHeader.cs
index 8d6e93be9d..53b3895390 100644
--- a/osu.Game/Overlays/Settings/SettingsHeader.cs
+++ b/osu.Game/Overlays/Settings/SettingsHeader.cs
@@ -48,7 +48,6 @@ namespace osu.Game.Overlays.Settings
                         subheader.Colour = colourProvider.Content2;
                         subheader.Font = OsuFont.GetFont(size: 18);
                     });
-
                 })
             };
         }

From c65e7a4436f0068f86ae2801564ef11bbc2bf705 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 23 Oct 2021 15:01:53 +0200
Subject: [PATCH 0850/5547] Add test coverage for download button

---
 .../TestSceneBeatmapCardDownloadButton.cs     | 166 ++++++++++++++++++
 .../Beatmaps/Drawables/Cards/BeatmapCard.cs   |   4 +-
 .../Drawables/Cards/Buttons/DownloadButton.cs |  59 ++++++-
 3 files changed, 225 insertions(+), 4 deletions(-)
 create mode 100644 osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCardDownloadButton.cs

diff --git a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCardDownloadButton.cs b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCardDownloadButton.cs
new file mode 100644
index 0000000000..88de1f8b98
--- /dev/null
+++ b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCardDownloadButton.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.Linq;
+using NUnit.Framework;
+using osu.Framework.Allocation;
+using osu.Framework.Bindables;
+using osu.Framework.Graphics;
+using osu.Game.Beatmaps;
+using osu.Game.Beatmaps.Drawables.Cards.Buttons;
+using osu.Game.Online;
+using osu.Game.Online.API.Requests.Responses;
+using osu.Game.Overlays;
+using osu.Game.Rulesets.Osu;
+using osu.Game.Tests.Resources;
+using osuTK;
+
+namespace osu.Game.Tests.Visual.Beatmaps
+{
+    public class TestSceneBeatmapCardDownloadButton : OsuTestScene
+    {
+        private TestDownloadButton downloadButton;
+
+        [Cached]
+        private OverlayColourProvider colourProvider = new OverlayColourProvider(OverlayColourScheme.Blue);
+
+        [Resolved]
+        private BeatmapManager beatmaps { get; set; }
+
+        [Test]
+        public void TestDownloadableBeatmap()
+        {
+            createButton(true);
+            assertDownloadEnabled(true);
+
+            AddStep("set downloading state", () => downloadButton.State.Value = DownloadState.Downloading);
+            AddStep("set progress to 30%", () => downloadButton.Progress.Value = 0.3f);
+            AddStep("set progress to 100%", () => downloadButton.Progress.Value = 1f);
+            AddStep("set importing state", () => downloadButton.State.Value = DownloadState.Importing);
+            AddStep("set locally available state", () => downloadButton.State.Value = DownloadState.LocallyAvailable);
+        }
+
+        [Test]
+        public void TestUndownloadableBeatmap()
+        {
+            createButton(false);
+            assertDownloadEnabled(false);
+        }
+
+        [Test]
+        public void TestDownloadState()
+        {
+            AddUntilStep("ensure manager loaded", () => beatmaps != null);
+            ensureSoleilyRemoved();
+            createButtonWithBeatmap(createSoleily());
+            AddAssert("button state not downloaded", () => downloadButton.State.Value == DownloadState.NotDownloaded);
+            AddStep("import soleily", () => beatmaps.Import(TestResources.GetQuickTestBeatmapForImport()));
+
+            AddUntilStep("wait for beatmap import", () => beatmaps.GetAllUsableBeatmapSets().Any(b => b.OnlineBeatmapSetID == 241526));
+            AddUntilStep("button state downloaded", () => downloadButton.State.Value == DownloadState.LocallyAvailable);
+
+            createButtonWithBeatmap(createSoleily());
+            AddUntilStep("button state downloaded", () => downloadButton.State.Value == DownloadState.LocallyAvailable);
+            ensureSoleilyRemoved();
+            AddUntilStep("button state not downloaded", () => downloadButton.State.Value == DownloadState.NotDownloaded);
+        }
+
+        private void ensureSoleilyRemoved()
+        {
+            AddStep("remove soleily", () =>
+            {
+                var beatmap = beatmaps.QueryBeatmapSet(b => b.OnlineBeatmapSetID == 241526);
+
+                if (beatmap != null) beatmaps.Delete(beatmap);
+            });
+        }
+
+        private void assertDownloadEnabled(bool enabled)
+        {
+            AddAssert($"button {(enabled ? "enabled" : "disabled")}", () => downloadButton.Download.IsPresent && downloadButton.Download.Enabled.Value == enabled);
+        }
+
+        private APIBeatmapSet createSoleily()
+        {
+            return new APIBeatmapSet
+            {
+                OnlineID = 241526,
+                Availability = new BeatmapSetOnlineAvailability
+                {
+                    DownloadDisabled = false,
+                    ExternalLink = string.Empty,
+                },
+            };
+        }
+
+        private void createButtonWithBeatmap(APIBeatmapSet beatmap)
+        {
+            AddStep("create button", () =>
+            {
+                Child = downloadButton = new TestDownloadButton(beatmap)
+                {
+                    Anchor = Anchor.Centre,
+                    Origin = Anchor.Centre,
+                    Scale = new Vector2(2)
+                };
+            });
+        }
+
+        private void createButton(bool downloadable)
+        {
+            AddStep("create button", () =>
+            {
+                Child = downloadButton = new TestDownloadButton(downloadable ? getDownloadableBeatmapSet() : getUndownloadableBeatmapSet())
+                {
+                    Anchor = Anchor.Centre,
+                    Origin = Anchor.Centre,
+                    Scale = new Vector2(2)
+                };
+            });
+        }
+
+        private APIBeatmapSet getDownloadableBeatmapSet()
+        {
+            var normal = CreateAPIBeatmapSet(new OsuRuleset().RulesetInfo);
+            normal.HasVideo = true;
+            normal.HasStoryboard = true;
+
+            return normal;
+        }
+
+        private APIBeatmapSet getUndownloadableBeatmapSet()
+        {
+            var beatmap = CreateAPIBeatmapSet(new OsuRuleset().RulesetInfo);
+            beatmap.Artist = "test";
+            beatmap.Title = "undownloadable";
+            beatmap.AuthorString = "test";
+
+            beatmap.HasVideo = true;
+            beatmap.HasStoryboard = true;
+
+            beatmap.Availability = new BeatmapSetOnlineAvailability
+            {
+                DownloadDisabled = true,
+                ExternalLink = "https://osu.ppy.sh",
+            };
+
+            return beatmap;
+        }
+
+        private class TestDownloadButton : DownloadButton
+        {
+            public readonly Bindable<DownloadState> State = new Bindable<DownloadState>();
+            public readonly BindableNumber<double> Progress = new BindableNumber<double>();
+
+            public new BeatmapCardIconButton Download => base.Download;
+            public new BeatmapCardIconButton Play => base.Play;
+
+            public TestDownloadButton(APIBeatmapSet beatmapSet)
+                : base(beatmapSet)
+            {
+                Tracker.State.BindTo(State);
+                Tracker.Progress.BindTo(Progress);
+            }
+        }
+    }
+}
diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
index 71376c28f1..3202ac4b3c 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
@@ -102,14 +102,14 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                     RelativeSizeAxes = Axes.Y,
                     Origin = Anchor.TopRight,
                     Anchor = Anchor.TopRight,
-                    Child = new FillFlowContainer<BeatmapCardIconButton>
+                    Child = new FillFlowContainer
                     {
                         AutoSizeAxes = Axes.Both,
                         Anchor = Anchor.Centre,
                         Origin = Anchor.Centre,
                         Direction = FillDirection.Vertical,
                         Spacing = new Vector2(0, 14),
-                        Children = new BeatmapCardIconButton[]
+                        Children = new Drawable[]
                         {
                             new FavouriteButton(beatmapSet) { Current = favouriteState },
                             new DownloadButton(beatmapSet)
diff --git a/osu.Game/Beatmaps/Drawables/Cards/Buttons/DownloadButton.cs b/osu.Game/Beatmaps/Drawables/Cards/Buttons/DownloadButton.cs
index 00c0ccc3ce..47475e5b31 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/Buttons/DownloadButton.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/Buttons/DownloadButton.cs
@@ -1,16 +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 osu.Framework.Allocation;
+using osu.Framework.Bindables;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Sprites;
 using osu.Game.Online.API.Requests.Responses;
+using osu.Framework.Graphics.UserInterface;
+using osu.Game.Online;
+using osu.Game.Overlays;
+using osuTK;
 
 namespace osu.Game.Beatmaps.Drawables.Cards.Buttons
 {
-    public class DownloadButton : BeatmapCardIconButton
+    public class DownloadButton : CompositeDrawable
     {
+        protected readonly DownloadIcon Download;
+        protected readonly PlayIcon Play;
+        protected readonly BeatmapDownloadTracker Tracker;
+
+        private readonly CircularProgress downloadProgress;
+
         public DownloadButton(APIBeatmapSet beatmapSet)
         {
-            Icon.Icon = FontAwesome.Solid.FileDownload;
+            Anchor = Anchor.Centre;
+            Origin = Anchor.Centre;
+
+            InternalChildren = new Drawable[]
+            {
+                Tracker = new BeatmapDownloadTracker(beatmapSet),
+                Download = new DownloadIcon(),
+                downloadProgress = new CircularProgress
+                {
+                    Size = new Vector2(16),
+                    InnerRadius = 0.1f,
+                },
+                Play = new PlayIcon()
+            };
+        }
+
+        [BackgroundDependencyLoader]
+        private void load(OverlayColourProvider colourProvider)
+        {
+            downloadProgress.Colour = colourProvider.Highlight1;
+        }
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+            ((IBindable<double>)downloadProgress.Current).BindTo(Tracker.Progress);
+        }
+
+        protected class DownloadIcon : BeatmapCardIconButton
+        {
+            public DownloadIcon()
+            {
+                Icon.Icon = FontAwesome.Solid.Download;
+            }
+        }
+
+        protected class PlayIcon : BeatmapCardIconButton
+        {
+            public PlayIcon()
+            {
+                Icon.Icon = FontAwesome.Regular.PlayCircle;
+            }
         }
 
         // TODO: implement behaviour

From a60cceeda6f55f45e5b158c847b0d578ecabec9f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 23 Oct 2021 15:27:04 +0200
Subject: [PATCH 0851/5547] Implement basic appearance of download button

---
 .../TestSceneBeatmapCardDownloadButton.cs     | 41 +++++++++++------
 .../Drawables/Cards/Buttons/DownloadButton.cs | 44 +++++++++++++------
 2 files changed, 58 insertions(+), 27 deletions(-)

diff --git a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCardDownloadButton.cs b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCardDownloadButton.cs
index 88de1f8b98..1d7acb0e7b 100644
--- a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCardDownloadButton.cs
+++ b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCardDownloadButton.cs
@@ -6,12 +6,14 @@ using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
+using osu.Framework.Testing;
 using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.Drawables.Cards.Buttons;
 using osu.Game.Online;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays;
 using osu.Game.Rulesets.Osu;
+using osu.Game.Screens.Ranking.Expanded.Accuracy;
 using osu.Game.Tests.Resources;
 using osuTK;
 
@@ -31,13 +33,25 @@ namespace osu.Game.Tests.Visual.Beatmaps
         public void TestDownloadableBeatmap()
         {
             createButton(true);
+
+            assertDownloadVisible(true);
             assertDownloadEnabled(true);
+            assertProgressVisible(false);
+            assertPlayVisible(false);
 
             AddStep("set downloading state", () => downloadButton.State.Value = DownloadState.Downloading);
+            assertDownloadVisible(false);
+            assertProgressVisible(true);
+            assertPlayVisible(false);
+
             AddStep("set progress to 30%", () => downloadButton.Progress.Value = 0.3f);
             AddStep("set progress to 100%", () => downloadButton.Progress.Value = 1f);
             AddStep("set importing state", () => downloadButton.State.Value = DownloadState.Importing);
+
             AddStep("set locally available state", () => downloadButton.State.Value = DownloadState.LocallyAvailable);
+            assertDownloadVisible(false);
+            assertProgressVisible(false);
+            assertPlayVisible(true);
         }
 
         [Test]
@@ -75,23 +89,22 @@ namespace osu.Game.Tests.Visual.Beatmaps
             });
         }
 
-        private void assertDownloadEnabled(bool enabled)
-        {
-            AddAssert($"button {(enabled ? "enabled" : "disabled")}", () => downloadButton.Download.IsPresent && downloadButton.Download.Enabled.Value == enabled);
-        }
+        private void assertDownloadVisible(bool visible) => AddUntilStep($"download {(visible ? "visible" : "not visible")}", () => downloadButton.Download.IsPresent == visible);
+        private void assertDownloadEnabled(bool enabled) => AddAssert($"download {(enabled ? "enabled" : "disabled")}", () => downloadButton.Download.Enabled.Value == enabled);
 
-        private APIBeatmapSet createSoleily()
+        private void assertProgressVisible(bool visible) => AddUntilStep($"progress {(visible ? "visible" : "not visible")}", () => downloadButton.ChildrenOfType<SmoothCircularProgress>().Single().IsPresent == visible);
+
+        private void assertPlayVisible(bool visible) => AddUntilStep($"play {(visible ? "visible" : "not visible")}", () => downloadButton.Play.IsPresent == visible);
+
+        private static APIBeatmapSet createSoleily() => new APIBeatmapSet
         {
-            return new APIBeatmapSet
+            OnlineID = 241526,
+            Availability = new BeatmapSetOnlineAvailability
             {
-                OnlineID = 241526,
-                Availability = new BeatmapSetOnlineAvailability
-                {
-                    DownloadDisabled = false,
-                    ExternalLink = string.Empty,
-                },
-            };
-        }
+                DownloadDisabled = false,
+                ExternalLink = string.Empty,
+            },
+        };
 
         private void createButtonWithBeatmap(APIBeatmapSet beatmap)
         {
diff --git a/osu.Game/Beatmaps/Drawables/Cards/Buttons/DownloadButton.cs b/osu.Game/Beatmaps/Drawables/Cards/Buttons/DownloadButton.cs
index 47475e5b31..43c222c949 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/Buttons/DownloadButton.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/Buttons/DownloadButton.cs
@@ -2,14 +2,14 @@
 // 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.Sprites;
 using osu.Game.Online.API.Requests.Responses;
-using osu.Framework.Graphics.UserInterface;
+using osu.Game.Graphics;
 using osu.Game.Online;
 using osu.Game.Overlays;
+using osu.Game.Screens.Ranking.Expanded.Accuracy;
 using osuTK;
 
 namespace osu.Game.Beatmaps.Drawables.Cards.Buttons
@@ -20,36 +20,54 @@ namespace osu.Game.Beatmaps.Drawables.Cards.Buttons
         protected readonly PlayIcon Play;
         protected readonly BeatmapDownloadTracker Tracker;
 
-        private readonly CircularProgress downloadProgress;
+        private readonly SmoothCircularProgress downloadProgress;
+
+        [Resolved]
+        private OsuColour colours { get; set; }
+
+        [Resolved]
+        private OverlayColourProvider colourProvider { get; set; }
 
         public DownloadButton(APIBeatmapSet beatmapSet)
         {
             Anchor = Anchor.Centre;
             Origin = Anchor.Centre;
+            AutoSizeAxes = Axes.Both;
 
             InternalChildren = new Drawable[]
             {
                 Tracker = new BeatmapDownloadTracker(beatmapSet),
                 Download = new DownloadIcon(),
-                downloadProgress = new CircularProgress
+                downloadProgress = new SmoothCircularProgress
                 {
-                    Size = new Vector2(16),
-                    InnerRadius = 0.1f,
+                    Size = new Vector2(12),
+                    Anchor = Anchor.Centre,
+                    Origin = Anchor.Centre,
+                    InnerRadius = 0.4f,
                 },
                 Play = new PlayIcon()
             };
         }
 
-        [BackgroundDependencyLoader]
-        private void load(OverlayColourProvider colourProvider)
-        {
-            downloadProgress.Colour = colourProvider.Highlight1;
-        }
-
         protected override void LoadComplete()
         {
             base.LoadComplete();
-            ((IBindable<double>)downloadProgress.Current).BindTo(Tracker.Progress);
+
+            Tracker.Progress.BindValueChanged(_ => updateState());
+            Tracker.State.BindValueChanged(_ => updateState(), true);
+            FinishTransforms(true);
+        }
+
+        private void updateState()
+        {
+            Download.FadeTo(Tracker.State.Value == DownloadState.NotDownloaded ? 1 : 0, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
+
+            downloadProgress.FadeTo(Tracker.State.Value == DownloadState.Downloading || Tracker.State.Value == DownloadState.Importing ? 1 : 0, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
+            downloadProgress.FadeColour(Tracker.State.Value == DownloadState.Importing ? colours.Yellow : colourProvider.Highlight1, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
+            if (Tracker.State.Value == DownloadState.Downloading)
+                downloadProgress.FillTo(Tracker.Progress.Value, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
+
+            Play.FadeTo(Tracker.State.Value == DownloadState.LocallyAvailable ? 1 : 0, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
         }
 
         protected class DownloadIcon : BeatmapCardIconButton

From 2186b51676b77ab5e96427fa46a29ad641c3174b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 23 Oct 2021 15:51:36 +0200
Subject: [PATCH 0852/5547] Implement detailed download button behaviour

---
 .../TestSceneBeatmapCardDownloadButton.cs     | 31 ++++++--
 .../Drawables/Cards/Buttons/DownloadButton.cs | 70 ++++++++++++++++---
 2 files changed, 87 insertions(+), 14 deletions(-)

diff --git a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCardDownloadButton.cs b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCardDownloadButton.cs
index 1d7acb0e7b..11eb93c5ac 100644
--- a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCardDownloadButton.cs
+++ b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCardDownloadButton.cs
@@ -9,9 +9,11 @@ using osu.Framework.Graphics;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.Drawables.Cards.Buttons;
+using osu.Game.Configuration;
 using osu.Game.Online;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays;
+using osu.Game.Resources.Localisation.Web;
 using osu.Game.Rulesets.Osu;
 using osu.Game.Screens.Ranking.Expanded.Accuracy;
 using osu.Game.Tests.Resources;
@@ -29,15 +31,20 @@ namespace osu.Game.Tests.Visual.Beatmaps
         [Resolved]
         private BeatmapManager beatmaps { get; set; }
 
+        [Resolved]
+        private OsuConfigManager config { get; set; }
+
         [Test]
         public void TestDownloadableBeatmap()
         {
+            ensureSoleilyRemoved();
             createButton(true);
 
             assertDownloadVisible(true);
             assertDownloadEnabled(true);
             assertProgressVisible(false);
             assertPlayVisible(false);
+            AddAssert("tooltip text correct", () => downloadButton.Download.TooltipText == BeatmapsetsStrings.PanelDownloadAll);
 
             AddStep("set downloading state", () => downloadButton.State.Value = DownloadState.Downloading);
             assertDownloadVisible(false);
@@ -54,17 +61,30 @@ namespace osu.Game.Tests.Visual.Beatmaps
             assertPlayVisible(true);
         }
 
+        [Test]
+        public void TestDownloadableBeatmapWithVideo()
+        {
+            createButton(true, true);
+            assertDownloadEnabled(true);
+
+            AddStep("prefer no video", () => config.SetValue(OsuSetting.PreferNoVideo, true));
+            AddAssert("tooltip text correct", () => downloadButton.Download.TooltipText == BeatmapsetsStrings.PanelDownloadNoVideo);
+
+            AddStep("prefer video", () => config.SetValue(OsuSetting.PreferNoVideo, false));
+            AddAssert("tooltip text correct", () => downloadButton.Download.TooltipText == BeatmapsetsStrings.PanelDownloadVideo);
+        }
+
         [Test]
         public void TestUndownloadableBeatmap()
         {
             createButton(false);
             assertDownloadEnabled(false);
+            AddAssert("tooltip text correct", () => downloadButton.Download.TooltipText == BeatmapsetsStrings.AvailabilityDisabled);
         }
 
         [Test]
         public void TestDownloadState()
         {
-            AddUntilStep("ensure manager loaded", () => beatmaps != null);
             ensureSoleilyRemoved();
             createButtonWithBeatmap(createSoleily());
             AddAssert("button state not downloaded", () => downloadButton.State.Value == DownloadState.NotDownloaded);
@@ -81,6 +101,7 @@ namespace osu.Game.Tests.Visual.Beatmaps
 
         private void ensureSoleilyRemoved()
         {
+            AddUntilStep("ensure manager loaded", () => beatmaps != null);
             AddStep("remove soleily", () =>
             {
                 var beatmap = beatmaps.QueryBeatmapSet(b => b.OnlineBeatmapSetID == 241526);
@@ -119,11 +140,11 @@ namespace osu.Game.Tests.Visual.Beatmaps
             });
         }
 
-        private void createButton(bool downloadable)
+        private void createButton(bool downloadable, bool hasVideo = false)
         {
             AddStep("create button", () =>
             {
-                Child = downloadButton = new TestDownloadButton(downloadable ? getDownloadableBeatmapSet() : getUndownloadableBeatmapSet())
+                Child = downloadButton = new TestDownloadButton(downloadable ? getDownloadableBeatmapSet(hasVideo) : getUndownloadableBeatmapSet())
                 {
                     Anchor = Anchor.Centre,
                     Origin = Anchor.Centre,
@@ -132,10 +153,10 @@ namespace osu.Game.Tests.Visual.Beatmaps
             });
         }
 
-        private APIBeatmapSet getDownloadableBeatmapSet()
+        private APIBeatmapSet getDownloadableBeatmapSet(bool hasVideo)
         {
             var normal = CreateAPIBeatmapSet(new OsuRuleset().RulesetInfo);
-            normal.HasVideo = true;
+            normal.HasVideo = hasVideo;
             normal.HasStoryboard = true;
 
             return normal;
diff --git a/osu.Game/Beatmaps/Drawables/Cards/Buttons/DownloadButton.cs b/osu.Game/Beatmaps/Drawables/Cards/Buttons/DownloadButton.cs
index 43c222c949..aeb36b579e 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/Buttons/DownloadButton.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/Buttons/DownloadButton.cs
@@ -1,14 +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.
 
+#nullable enable
+
 using osu.Framework.Allocation;
+using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Sprites;
 using osu.Game.Online.API.Requests.Responses;
+using osu.Game.Configuration;
 using osu.Game.Graphics;
 using osu.Game.Online;
 using osu.Game.Overlays;
+using osu.Game.Resources.Localisation.Web;
 using osu.Game.Screens.Ranking.Expanded.Accuracy;
 using osuTK;
 
@@ -23,10 +28,10 @@ namespace osu.Game.Beatmaps.Drawables.Cards.Buttons
         private readonly SmoothCircularProgress downloadProgress;
 
         [Resolved]
-        private OsuColour colours { get; set; }
+        private OsuColour colours { get; set; } = null!;
 
         [Resolved]
-        private OverlayColourProvider colourProvider { get; set; }
+        private OverlayColourProvider colourProvider { get; set; } = null!;
 
         public DownloadButton(APIBeatmapSet beatmapSet)
         {
@@ -37,7 +42,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards.Buttons
             InternalChildren = new Drawable[]
             {
                 Tracker = new BeatmapDownloadTracker(beatmapSet),
-                Download = new DownloadIcon(),
+                Download = new DownloadIcon(beatmapSet),
                 downloadProgress = new SmoothCircularProgress
                 {
                     Size = new Vector2(12),
@@ -45,7 +50,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards.Buttons
                     Origin = Anchor.Centre,
                     InnerRadius = 0.4f,
                 },
-                Play = new PlayIcon()
+                Play = new PlayIcon(beatmapSet)
             };
         }
 
@@ -65,27 +70,74 @@ namespace osu.Game.Beatmaps.Drawables.Cards.Buttons
             downloadProgress.FadeTo(Tracker.State.Value == DownloadState.Downloading || Tracker.State.Value == DownloadState.Importing ? 1 : 0, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
             downloadProgress.FadeColour(Tracker.State.Value == DownloadState.Importing ? colours.Yellow : colourProvider.Highlight1, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
             if (Tracker.State.Value == DownloadState.Downloading)
-                downloadProgress.FillTo(Tracker.Progress.Value, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
+                downloadProgress.FillTo(Tracker.Progress.Value, Tracker.Progress.Value > 0 ? BeatmapCard.TRANSITION_DURATION : 0, Easing.OutQuint);
 
             Play.FadeTo(Tracker.State.Value == DownloadState.LocallyAvailable ? 1 : 0, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
         }
 
         protected class DownloadIcon : BeatmapCardIconButton
         {
-            public DownloadIcon()
+            private readonly APIBeatmapSet beatmapSet;
+            private Bindable<bool> preferNoVideo = null!;
+
+            [Resolved]
+            private BeatmapManager beatmaps { get; set; } = null!;
+
+            public DownloadIcon(APIBeatmapSet beatmapSet)
             {
                 Icon.Icon = FontAwesome.Solid.Download;
+
+                this.beatmapSet = beatmapSet;
+            }
+
+            [BackgroundDependencyLoader]
+            private void load(OsuConfigManager config)
+            {
+                preferNoVideo = config.GetBindable<bool>(OsuSetting.PreferNoVideo);
+            }
+
+            protected override void LoadComplete()
+            {
+                base.LoadComplete();
+                preferNoVideo.BindValueChanged(_ => updateState(), true);
+            }
+
+            private void updateState()
+            {
+                if (beatmapSet.Availability.DownloadDisabled)
+                {
+                    Enabled.Value = false;
+                    TooltipText = BeatmapsetsStrings.AvailabilityDisabled;
+                    return;
+                }
+
+                if (!beatmapSet.HasVideo)
+                    TooltipText = BeatmapsetsStrings.PanelDownloadAll;
+                else
+                    TooltipText = preferNoVideo.Value ? BeatmapsetsStrings.PanelDownloadNoVideo : BeatmapsetsStrings.PanelDownloadVideo;
+
+                Action = () => beatmaps.Download(beatmapSet, preferNoVideo.Value);
             }
         }
 
         protected class PlayIcon : BeatmapCardIconButton
         {
-            public PlayIcon()
+            private readonly APIBeatmapSet beatmapSet;
+
+            public PlayIcon(APIBeatmapSet beatmapSet)
             {
+                this.beatmapSet = beatmapSet;
+
                 Icon.Icon = FontAwesome.Regular.PlayCircle;
+                TooltipText = "Go to beatmap";
+            }
+
+            [BackgroundDependencyLoader(true)]
+            private void load(OsuGame? game)
+            {
+                if (game != null)
+                    Action = () => game.PresentBeatmap(beatmapSet);
             }
         }
-
-        // TODO: implement behaviour
     }
 }

From 0f129b2cfbdfca268cb6c46272682ec4c2f9d7c0 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 9 Nov 2021 12:45:00 +0900
Subject: [PATCH 0853/5547] Disable dependabot for now

---
 .github/dependabot.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/dependabot.yml b/.github/dependabot.yml
index 9e9af23b27..814fc81f51 100644
--- a/.github/dependabot.yml
+++ b/.github/dependabot.yml
@@ -5,7 +5,7 @@ updates:
   schedule:
     interval: monthly
     time: "17:00"
-  open-pull-requests-limit: 99
+  open-pull-requests-limit: 0 # disabled until https://github.com/dependabot/dependabot-core/issues/369 is resolved.
   ignore:
   - dependency-name: Microsoft.EntityFrameworkCore.Design
     versions:

From 999d625e76fff81cde1de3a62a3ac1ed83db828f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 9 Nov 2021 14:51:06 +0900
Subject: [PATCH 0854/5547] Fix realm migration potentially failing for users
 that haven't run osu! in a long time

As reported at https://github.com/ppy/osu/discussions/15530.
---
 osu.Game/Database/RealmContextFactory.cs | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Database/RealmContextFactory.cs b/osu.Game/Database/RealmContextFactory.cs
index 20667bb3d1..7d9da96160 100644
--- a/osu.Game/Database/RealmContextFactory.cs
+++ b/osu.Game/Database/RealmContextFactory.cs
@@ -209,7 +209,13 @@ namespace osu.Game.Database
 
                 case 9:
                     // Pretty pointless to do this as beatmaps aren't really loaded via realm yet, but oh well.
-                    var oldMetadata = migration.OldRealm.DynamicApi.All(getMappedOrOriginalName(typeof(RealmBeatmapMetadata)));
+                    string className = getMappedOrOriginalName(typeof(RealmBeatmapMetadata));
+
+                    // May be coming from a version before `RealmBeatmapMetadata` existed.
+                    if (!migration.OldRealm.Schema.TryFindObjectSchema(className, out _))
+                        return;
+
+                    var oldMetadata = migration.OldRealm.DynamicApi.All(className);
                     var newMetadata = migration.NewRealm.All<RealmBeatmapMetadata>();
 
                     int metadataCount = newMetadata.Count();

From 704ff47a0e3404693785ba587ff2a97b74776d3d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 9 Nov 2021 08:07:56 +0100
Subject: [PATCH 0855/5547] Swap icon for "go to beatmap" state

---
 osu.Game/Beatmaps/Drawables/Cards/Buttons/DownloadButton.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Beatmaps/Drawables/Cards/Buttons/DownloadButton.cs b/osu.Game/Beatmaps/Drawables/Cards/Buttons/DownloadButton.cs
index aeb36b579e..df765e1e69 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/Buttons/DownloadButton.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/Buttons/DownloadButton.cs
@@ -128,7 +128,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards.Buttons
             {
                 this.beatmapSet = beatmapSet;
 
-                Icon.Icon = FontAwesome.Regular.PlayCircle;
+                Icon.Icon = FontAwesome.Solid.AngleDoubleRight;
                 TooltipText = "Go to beatmap";
             }
 

From 3b485b5f3700f11396601cd7d49212016d38a276 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 9 Nov 2021 17:27:07 +0900
Subject: [PATCH 0856/5547] Rewrite `PreviewTrackManager` to avoid constructing
 `TrackBass` locally

This paves the way for the framework code quality change
(https://github.com/ppy/osu-framework/pull/4873) which stops exposing
the constructor.

Most of the restructuring here is required to give `PreviewTrackManager`
an adjustable target to apply the global mute.
---
 .../TestScenePreviewTrackManager.cs           | 20 ++++-
 osu.Game/Audio/PreviewTrackManager.cs         | 73 +++----------------
 osu.Game/Beatmaps/BeatmapManager.cs           | 19 +++--
 osu.Game/Beatmaps/WorkingBeatmapCache.cs      |  4 +-
 osu.Game/OsuGameBase.cs                       |  6 +-
 osu.Game/Tests/Visual/EditorTestScene.cs      |  2 +-
 6 files changed, 46 insertions(+), 78 deletions(-)

diff --git a/osu.Game.Tests/Visual/Components/TestScenePreviewTrackManager.cs b/osu.Game.Tests/Visual/Components/TestScenePreviewTrackManager.cs
index 89e20043fb..82b6710a17 100644
--- a/osu.Game.Tests/Visual/Components/TestScenePreviewTrackManager.cs
+++ b/osu.Game.Tests/Visual/Components/TestScenePreviewTrackManager.cs
@@ -13,10 +13,17 @@ namespace osu.Game.Tests.Visual.Components
 {
     public class TestScenePreviewTrackManager : OsuTestScene, IPreviewTrackOwner
     {
-        private readonly TestPreviewTrackManager trackManager = new TestPreviewTrackManager();
+        private readonly IAdjustableAudioComponent gameTrackAudio = new AudioAdjustments();
+
+        private readonly TestPreviewTrackManager trackManager;
 
         private AudioManager audio;
 
+        public TestScenePreviewTrackManager()
+        {
+            trackManager = new TestPreviewTrackManager(gameTrackAudio);
+        }
+
         protected override IReadOnlyDependencyContainer CreateChildDependencies(IReadOnlyDependencyContainer parent)
         {
             var dependencies = new DependencyContainer(base.CreateChildDependencies(parent));
@@ -151,19 +158,19 @@ namespace osu.Game.Tests.Visual.Components
                     audio.VolumeTrack.Value = 1;
             });
 
-            AddAssert("game not muted", () => audio.Tracks.AggregateVolume.Value != 0);
+            AddAssert("game not muted", () => gameTrackAudio.AggregateVolume.Value != 0);
 
             AddStep("get track", () => Add(owner = new TestTrackOwner(track = getTrack())));
             AddUntilStep("wait loaded", () => track.IsLoaded);
             AddStep("start track", () => track.Start());
-            AddAssert("game is muted", () => audio.Tracks.AggregateVolume.Value == 0);
+            AddAssert("game is muted", () => gameTrackAudio.AggregateVolume.Value == 0);
 
             if (stopAnyPlaying)
                 AddStep("stop any playing", () => trackManager.StopAnyPlaying(owner));
             else
                 AddStep("stop track", () => track.Stop());
 
-            AddAssert("game not muted", () => audio.Tracks.AggregateVolume.Value != 0);
+            AddAssert("game not muted", () => gameTrackAudio.AggregateVolume.Value != 0);
         }
 
         [Test]
@@ -224,6 +231,11 @@ namespace osu.Game.Tests.Visual.Components
 
             public new PreviewTrack CurrentTrack => base.CurrentTrack;
 
+            public TestPreviewTrackManager(IAdjustableAudioComponent mainTrackAdjustments)
+                : base(mainTrackAdjustments)
+            {
+            }
+
             protected override TrackManagerPreviewTrack CreatePreviewTrack(IBeatmapSetInfo beatmapSetInfo, ITrackStore trackStore) => new TestPreviewTrack(beatmapSetInfo, trackStore);
 
             public override bool UpdateSubTree()
diff --git a/osu.Game/Audio/PreviewTrackManager.cs b/osu.Game/Audio/PreviewTrackManager.cs
index ca63add31d..fd9d5a97c6 100644
--- a/osu.Game/Audio/PreviewTrackManager.cs
+++ b/osu.Game/Audio/PreviewTrackManager.cs
@@ -1,13 +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.IO;
-using System.Threading.Tasks;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
-using osu.Framework.Audio.Mixing;
 using osu.Framework.Audio.Track;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
@@ -19,27 +14,26 @@ namespace osu.Game.Audio
 {
     public class PreviewTrackManager : Component
     {
+        private readonly IAdjustableAudioComponent mainTrackAdjustments;
+
         private readonly BindableDouble muteBindable = new BindableDouble();
 
         [Resolved]
         private AudioManager audio { get; set; }
 
-        private PreviewTrackStore trackStore;
+        private ITrackStore trackStore;
 
         protected TrackManagerPreviewTrack CurrentTrack;
 
-        private readonly BindableNumber<double> globalTrackVolumeAdjust = new BindableNumber<double>(OsuGameBase.GLOBAL_TRACK_VOLUME_ADJUST);
+        public PreviewTrackManager(IAdjustableAudioComponent mainTrackAdjustments)
+        {
+            this.mainTrackAdjustments = mainTrackAdjustments;
+        }
 
         [BackgroundDependencyLoader]
         private void load(AudioManager audioManager)
         {
-            // this is a temporary solution to get around muting ourselves.
-            // todo: update this once we have a BackgroundTrackManager or similar.
-            trackStore = new PreviewTrackStore(audioManager.TrackMixer, new OnlineStore());
-
-            audio.AddItem(trackStore);
-            trackStore.AddAdjustment(AdjustableProperty.Volume, globalTrackVolumeAdjust);
-            trackStore.AddAdjustment(AdjustableProperty.Volume, audio.VolumeTrack);
+            trackStore = audioManager.GetTrackStore(new OnlineStore());
         }
 
         /// <summary>
@@ -55,7 +49,7 @@ namespace osu.Game.Audio
             {
                 CurrentTrack?.Stop();
                 CurrentTrack = track;
-                audio.Tracks.AddAdjustment(AdjustableProperty.Volume, muteBindable);
+                mainTrackAdjustments.AddAdjustment(AdjustableProperty.Volume, muteBindable);
             });
 
             track.Stopped += () => Schedule(() =>
@@ -64,7 +58,7 @@ namespace osu.Game.Audio
                     return;
 
                 CurrentTrack = null;
-                audio.Tracks.RemoveAdjustment(AdjustableProperty.Volume, muteBindable);
+                mainTrackAdjustments.RemoveAdjustment(AdjustableProperty.Volume, muteBindable);
             });
 
             return track;
@@ -116,52 +110,5 @@ namespace osu.Game.Audio
 
             protected override Track GetTrack() => trackManager.Get($"https://b.ppy.sh/preview/{beatmapSetInfo.OnlineID}.mp3");
         }
-
-        private class PreviewTrackStore : AudioCollectionManager<AdjustableAudioComponent>, ITrackStore
-        {
-            private readonly AudioMixer defaultMixer;
-            private readonly IResourceStore<byte[]> store;
-
-            internal PreviewTrackStore(AudioMixer defaultMixer, IResourceStore<byte[]> store)
-            {
-                this.defaultMixer = defaultMixer;
-                this.store = store;
-            }
-
-            public Track GetVirtual(double length = double.PositiveInfinity)
-            {
-                if (IsDisposed) throw new ObjectDisposedException($"Cannot retrieve items for an already disposed {nameof(PreviewTrackStore)}");
-
-                var track = new TrackVirtual(length);
-                AddItem(track);
-                return track;
-            }
-
-            public Track Get(string name)
-            {
-                if (IsDisposed) throw new ObjectDisposedException($"Cannot retrieve items for an already disposed {nameof(PreviewTrackStore)}");
-
-                if (string.IsNullOrEmpty(name)) return null;
-
-                var dataStream = store.GetStream(name);
-
-                if (dataStream == null)
-                    return null;
-
-                // Todo: This is quite unsafe. TrackBass shouldn't be exposed as public.
-                Track track = new TrackBass(dataStream);
-
-                defaultMixer.Add(track);
-                AddItem(track);
-
-                return track;
-            }
-
-            public Task<Track> GetAsync(string name) => Task.Run(() => Get(name));
-
-            public Stream GetStream(string name) => store.GetStream(name);
-
-            public IEnumerable<string> GetAvailableResources() => store.GetAvailableResources();
-        }
     }
 }
diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index 1e33b54a8f..48a6663adb 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -10,6 +10,8 @@ using System.Threading;
 using System.Threading.Tasks;
 using JetBrains.Annotations;
 using osu.Framework.Audio;
+using osu.Framework.Audio.Mixing;
+using osu.Framework.Audio.Track;
 using osu.Framework.IO.Stores;
 using osu.Framework.Platform;
 using osu.Framework.Testing;
@@ -30,18 +32,23 @@ namespace osu.Game.Beatmaps
     [ExcludeFromDynamicCompile]
     public class BeatmapManager : IModelDownloader<IBeatmapSetInfo>, IModelManager<BeatmapSetInfo>, IModelFileManager<BeatmapSetInfo, BeatmapSetFileInfo>, IModelImporter<BeatmapSetInfo>, IWorkingBeatmapCache, IDisposable
     {
+        public ITrackStore BeatmapTrackStore { get; }
+
         private readonly BeatmapModelManager beatmapModelManager;
         private readonly BeatmapModelDownloader beatmapModelDownloader;
 
         private readonly WorkingBeatmapCache workingBeatmapCache;
         private readonly BeatmapOnlineLookupQueue onlineBeatmapLookupQueue;
 
-        public BeatmapManager(Storage storage, IDatabaseContextFactory contextFactory, RulesetStore rulesets, IAPIProvider api, [NotNull] AudioManager audioManager, IResourceStore<byte[]> resources, GameHost host = null,
-                              WorkingBeatmap defaultBeatmap = null, bool performOnlineLookups = false)
+        public BeatmapManager(Storage storage, IDatabaseContextFactory contextFactory, RulesetStore rulesets, IAPIProvider api, [NotNull] AudioManager audioManager, IResourceStore<byte[]> gameResources, GameHost host = null, WorkingBeatmap defaultBeatmap = null, bool performOnlineLookups = false, AudioMixer mainTrackMixer = null)
         {
+            var userResources = new FileStore(contextFactory, storage).Store;
+
+            BeatmapTrackStore = audioManager.GetTrackStore(userResources);
+
             beatmapModelManager = CreateBeatmapModelManager(storage, contextFactory, rulesets, api, host);
             beatmapModelDownloader = CreateBeatmapModelDownloader(beatmapModelManager, api, host);
-            workingBeatmapCache = CreateWorkingBeatmapCache(audioManager, resources, new FileStore(contextFactory, storage).Store, defaultBeatmap, host);
+            workingBeatmapCache = CreateWorkingBeatmapCache(audioManager, gameResources, userResources, defaultBeatmap, host);
 
             workingBeatmapCache.BeatmapManager = beatmapModelManager;
             beatmapModelManager.WorkingBeatmapCache = workingBeatmapCache;
@@ -58,8 +65,10 @@ namespace osu.Game.Beatmaps
             return new BeatmapModelDownloader(modelManager, api, host);
         }
 
-        protected virtual WorkingBeatmapCache CreateWorkingBeatmapCache(AudioManager audioManager, IResourceStore<byte[]> resources, IResourceStore<byte[]> storage, WorkingBeatmap defaultBeatmap, GameHost host) =>
-            new WorkingBeatmapCache(audioManager, resources, storage, defaultBeatmap, host);
+        protected virtual WorkingBeatmapCache CreateWorkingBeatmapCache(AudioManager audioManager, IResourceStore<byte[]> resources, IResourceStore<byte[]> storage, WorkingBeatmap defaultBeatmap, GameHost host)
+        {
+            return new WorkingBeatmapCache(BeatmapTrackStore, audioManager, resources, storage, defaultBeatmap, host);
+        }
 
         protected virtual BeatmapModelManager CreateBeatmapModelManager(Storage storage, IDatabaseContextFactory contextFactory, RulesetStore rulesets, IAPIProvider api, GameHost host) =>
             new BeatmapModelManager(storage, contextFactory, rulesets, host);
diff --git a/osu.Game/Beatmaps/WorkingBeatmapCache.cs b/osu.Game/Beatmaps/WorkingBeatmapCache.cs
index 11257e3abc..0af28902a0 100644
--- a/osu.Game/Beatmaps/WorkingBeatmapCache.cs
+++ b/osu.Game/Beatmaps/WorkingBeatmapCache.cs
@@ -41,7 +41,7 @@ namespace osu.Game.Beatmaps
         [CanBeNull]
         private readonly GameHost host;
 
-        public WorkingBeatmapCache([NotNull] AudioManager audioManager, IResourceStore<byte[]> resources, IResourceStore<byte[]> files, WorkingBeatmap defaultBeatmap = null, GameHost host = null)
+        public WorkingBeatmapCache(ITrackStore trackStore, AudioManager audioManager, IResourceStore<byte[]> resources, IResourceStore<byte[]> files, WorkingBeatmap defaultBeatmap = null, GameHost host = null)
         {
             DefaultBeatmap = defaultBeatmap;
 
@@ -50,7 +50,7 @@ namespace osu.Game.Beatmaps
             this.host = host;
             this.files = files;
             largeTextureStore = new LargeTextureStore(host?.CreateTextureLoaderStore(files));
-            trackStore = audioManager.GetTrackStore(files);
+            this.trackStore = trackStore;
         }
 
         public void Invalidate(BeatmapSetInfo info)
diff --git a/osu.Game/OsuGameBase.cs b/osu.Game/OsuGameBase.cs
index 10166daf00..e207d9ce3b 100644
--- a/osu.Game/OsuGameBase.cs
+++ b/osu.Game/OsuGameBase.cs
@@ -65,7 +65,7 @@ namespace osu.Game
         /// <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.
         /// </summary>
-        internal const double GLOBAL_TRACK_VOLUME_ADJUST = 0.8;
+        private const double global_track_volume_adjust = 0.8;
 
         public bool UseDevelopmentServer { get; }
 
@@ -159,7 +159,7 @@ namespace osu.Game
 
         private Bindable<bool> fpsDisplayVisible;
 
-        private readonly BindableNumber<double> globalTrackVolumeAdjust = new BindableNumber<double>(GLOBAL_TRACK_VOLUME_ADJUST);
+        private readonly BindableNumber<double> globalTrackVolumeAdjust = new BindableNumber<double>(global_track_volume_adjust);
 
         private RealmRulesetStore realmRulesetStore;
 
@@ -315,7 +315,7 @@ namespace osu.Game
             dependencies.Cache(globalBindings);
 
             PreviewTrackManager previewTrackManager;
-            dependencies.Cache(previewTrackManager = new PreviewTrackManager());
+            dependencies.Cache(previewTrackManager = new PreviewTrackManager(BeatmapManager.BeatmapTrackStore));
             Add(previewTrackManager);
 
             AddInternal(MusicController = new MusicController());
diff --git a/osu.Game/Tests/Visual/EditorTestScene.cs b/osu.Game/Tests/Visual/EditorTestScene.cs
index 4b02306d33..07152b5a3e 100644
--- a/osu.Game/Tests/Visual/EditorTestScene.cs
+++ b/osu.Game/Tests/Visual/EditorTestScene.cs
@@ -137,7 +137,7 @@ namespace osu.Game.Tests.Visual
                 private readonly TestBeatmapManager testBeatmapManager;
 
                 public TestWorkingBeatmapCache(TestBeatmapManager testBeatmapManager, AudioManager audioManager, IResourceStore<byte[]> resourceStore, IResourceStore<byte[]> storage, WorkingBeatmap defaultBeatmap, GameHost gameHost)
-                    : base(audioManager, resourceStore, storage, defaultBeatmap, gameHost)
+                    : base(testBeatmapManager.BeatmapTrackStore, audioManager, resourceStore, storage, defaultBeatmap, gameHost)
                 {
                     this.testBeatmapManager = testBeatmapManager;
                 }

From dfbc1f33947b2eeb355d8a3a1000ada5668a5041 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 9 Nov 2021 17:42:03 +0900
Subject: [PATCH 0857/5547] Fix "conflicting" variable name

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

diff --git a/osu.Game/Database/RealmContextFactory.cs b/osu.Game/Database/RealmContextFactory.cs
index 7d9da96160..42ae986921 100644
--- a/osu.Game/Database/RealmContextFactory.cs
+++ b/osu.Game/Database/RealmContextFactory.cs
@@ -209,13 +209,13 @@ namespace osu.Game.Database
 
                 case 9:
                     // Pretty pointless to do this as beatmaps aren't really loaded via realm yet, but oh well.
-                    string className = getMappedOrOriginalName(typeof(RealmBeatmapMetadata));
+                    string metadataClassName = getMappedOrOriginalName(typeof(RealmBeatmapMetadata));
 
                     // May be coming from a version before `RealmBeatmapMetadata` existed.
-                    if (!migration.OldRealm.Schema.TryFindObjectSchema(className, out _))
+                    if (!migration.OldRealm.Schema.TryFindObjectSchema(metadataClassName, out _))
                         return;
 
-                    var oldMetadata = migration.OldRealm.DynamicApi.All(className);
+                    var oldMetadata = migration.OldRealm.DynamicApi.All(metadataClassName);
                     var newMetadata = migration.NewRealm.All<RealmBeatmapMetadata>();
 
                     int metadataCount = newMetadata.Count();

From eba3cfc96e0e812a764cf70103905f4d7aff0874 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 9 Nov 2021 12:37:12 +0100
Subject: [PATCH 0858/5547] Move `ScoreInfo` string representation to extension
 method

---
 osu.Game/Scoring/ScoreInfo.cs           |  2 +-
 osu.Game/Scoring/ScoreInfoExtensions.cs | 15 +++++++++++++++
 2 files changed, 16 insertions(+), 1 deletion(-)
 create mode 100644 osu.Game/Scoring/ScoreInfoExtensions.cs

diff --git a/osu.Game/Scoring/ScoreInfo.cs b/osu.Game/Scoring/ScoreInfo.cs
index e5b050fc01..736a939a59 100644
--- a/osu.Game/Scoring/ScoreInfo.cs
+++ b/osu.Game/Scoring/ScoreInfo.cs
@@ -225,7 +225,7 @@ namespace osu.Game.Scoring
             return clone;
         }
 
-        public override string ToString() => $"{User} playing {BeatmapInfo}";
+        public override string ToString() => this.GetDisplayTitle();
 
         public bool Equals(ScoreInfo other)
         {
diff --git a/osu.Game/Scoring/ScoreInfoExtensions.cs b/osu.Game/Scoring/ScoreInfoExtensions.cs
new file mode 100644
index 0000000000..2279337fef
--- /dev/null
+++ b/osu.Game/Scoring/ScoreInfoExtensions.cs
@@ -0,0 +1,15 @@
+// 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.Beatmaps;
+
+namespace osu.Game.Scoring
+{
+    public static class ScoreInfoExtensions
+    {
+        /// <summary>
+        /// A user-presentable display title representing this score.
+        /// </summary>
+        public static string GetDisplayTitle(this IScoreInfo scoreInfo) => $"{scoreInfo.User.Username} playing {scoreInfo.Beatmap.GetDisplayTitle()}";
+    }
+}

From a1b55d6490cd103b9d3eb0238305df7a38234a31 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 9 Nov 2021 13:34:36 +0100
Subject: [PATCH 0859/5547] Add failing test case

---
 .../Online/TestSceneBeatmapManager.cs         | 52 ++++++++++++++++---
 .../Notifications/ProgressNotification.cs     |  9 +++-
 2 files changed, 54 insertions(+), 7 deletions(-)

diff --git a/osu.Game.Tests/Online/TestSceneBeatmapManager.cs b/osu.Game.Tests/Online/TestSceneBeatmapManager.cs
index 0ae0186770..4d5bee13f2 100644
--- a/osu.Game.Tests/Online/TestSceneBeatmapManager.cs
+++ b/osu.Game.Tests/Online/TestSceneBeatmapManager.cs
@@ -5,6 +5,7 @@ using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays.Notifications;
 using osu.Game.Tests.Visual;
 
@@ -16,7 +17,30 @@ namespace osu.Game.Tests.Online
         private BeatmapManager beatmaps;
         private ProgressNotification recentNotification;
 
-        private static readonly BeatmapSetInfo test_model = new BeatmapSetInfo { OnlineBeatmapSetID = 1 };
+        private static readonly BeatmapSetInfo test_db_model = new BeatmapSetInfo
+        {
+            OnlineBeatmapSetID = 1,
+            Metadata = new BeatmapMetadata
+            {
+                Artist = "test author",
+                Title = "test title",
+                Author = new APIUser
+                {
+                    Username = "mapper"
+                }
+            }
+        };
+
+        private static readonly APIBeatmapSet test_online_model = new APIBeatmapSet
+        {
+            OnlineID = 2,
+            Artist = "test author",
+            Title = "test title",
+            Author = new APIUser
+            {
+                Username = "mapper"
+            }
+        };
 
         [BackgroundDependencyLoader]
         private void load(BeatmapManager beatmaps)
@@ -26,25 +50,41 @@ namespace osu.Game.Tests.Online
             beatmaps.PostNotification = n => recentNotification = n as ProgressNotification;
         }
 
+        private static readonly object[][] notification_test_cases =
+        {
+            new object[] { test_db_model },
+            new object[] { test_online_model }
+        };
+
+        [TestCaseSource(nameof(notification_test_cases))]
+        public void TestNotificationMessage(IBeatmapSetInfo model)
+        {
+            AddStep("clear recent notification", () => recentNotification = null);
+            AddStep("download beatmap", () => beatmaps.Download(model));
+
+            AddUntilStep("wait for notification", () => recentNotification != null);
+            AddUntilStep("notification text correct", () => recentNotification.Text.ToString() == "Downloading test author - test title (mapper)");
+        }
+
         [Test]
         public void TestCancelDownloadFromRequest()
         {
-            AddStep("download beatmap", () => beatmaps.Download(test_model));
+            AddStep("download beatmap", () => beatmaps.Download(test_db_model));
 
-            AddStep("cancel download from request", () => beatmaps.GetExistingDownload(test_model).Cancel());
+            AddStep("cancel download from request", () => beatmaps.GetExistingDownload(test_db_model).Cancel());
 
-            AddUntilStep("is removed from download list", () => beatmaps.GetExistingDownload(test_model) == null);
+            AddUntilStep("is removed from download list", () => beatmaps.GetExistingDownload(test_db_model) == null);
             AddAssert("is notification cancelled", () => recentNotification.State == ProgressNotificationState.Cancelled);
         }
 
         [Test]
         public void TestCancelDownloadFromNotification()
         {
-            AddStep("download beatmap", () => beatmaps.Download(test_model));
+            AddStep("download beatmap", () => beatmaps.Download(test_db_model));
 
             AddStep("cancel download from notification", () => recentNotification.Close());
 
-            AddUntilStep("is removed from download list", () => beatmaps.GetExistingDownload(test_model) == null);
+            AddUntilStep("is removed from download list", () => beatmaps.GetExistingDownload(test_db_model) == null);
             AddAssert("is notification cancelled", () => recentNotification.State == ProgressNotificationState.Cancelled);
         }
     }
diff --git a/osu.Game/Overlays/Notifications/ProgressNotification.cs b/osu.Game/Overlays/Notifications/ProgressNotification.cs
index c44b88ad29..5b74bff817 100644
--- a/osu.Game/Overlays/Notifications/ProgressNotification.cs
+++ b/osu.Game/Overlays/Notifications/ProgressNotification.cs
@@ -23,9 +23,16 @@ namespace osu.Game.Overlays.Notifications
     {
         private const float loading_spinner_size = 22;
 
+        private LocalisableString text;
+
         public LocalisableString Text
         {
-            set => Schedule(() => textDrawable.Text = value);
+            get => text;
+            set
+            {
+                text = value;
+                Schedule(() => textDrawable.Text = text);
+            }
         }
 
         public string CompletionText { get; set; } = "Task has completed!";

From 5ec8288508876dff6b6af1717b4a9fb6866792f5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 9 Nov 2021 13:34:56 +0100
Subject: [PATCH 0860/5547] Add `GetDisplayString()` extension to handle all
 model interface types globally

---
 osu.Game/Database/ArchiveModelManager.cs |  3 +-
 osu.Game/Database/ModelDownloader.cs     |  3 +-
 osu.Game/Extensions/ModelExtensions.cs   | 61 ++++++++++++++++++++++++
 3 files changed, 65 insertions(+), 2 deletions(-)
 create mode 100644 osu.Game/Extensions/ModelExtensions.cs

diff --git a/osu.Game/Database/ArchiveModelManager.cs b/osu.Game/Database/ArchiveModelManager.cs
index 019749760f..320f108886 100644
--- a/osu.Game/Database/ArchiveModelManager.cs
+++ b/osu.Game/Database/ArchiveModelManager.cs
@@ -15,6 +15,7 @@ using osu.Framework.Extensions.IEnumerableExtensions;
 using osu.Framework.Logging;
 using osu.Framework.Platform;
 using osu.Framework.Threading;
+using osu.Game.Extensions;
 using osu.Game.IO;
 using osu.Game.IO.Archives;
 using osu.Game.IPC;
@@ -192,7 +193,7 @@ namespace osu.Game.Database
             else
             {
                 notification.CompletionText = imported.Count == 1
-                    ? $"Imported {imported.First().Value}!"
+                    ? $"Imported {imported.First().Value.GetDisplayString()}!"
                     : $"Imported {imported.Count} {HumanisedModelName}s!";
 
                 if (imported.Count > 0 && PostImport != null)
diff --git a/osu.Game/Database/ModelDownloader.cs b/osu.Game/Database/ModelDownloader.cs
index 3c1f181f24..43ba62dfe0 100644
--- a/osu.Game/Database/ModelDownloader.cs
+++ b/osu.Game/Database/ModelDownloader.cs
@@ -8,6 +8,7 @@ using System.Threading.Tasks;
 using Humanizer;
 using osu.Framework.Logging;
 using osu.Framework.Platform;
+using osu.Game.Extensions;
 using osu.Game.Online.API;
 using osu.Game.Overlays.Notifications;
 
@@ -50,7 +51,7 @@ namespace osu.Game.Database
 
             DownloadNotification notification = new DownloadNotification
             {
-                Text = $"Downloading {request.Model}",
+                Text = $"Downloading {request.Model.GetDisplayString()}",
             };
 
             request.DownloadProgressed += progress =>
diff --git a/osu.Game/Extensions/ModelExtensions.cs b/osu.Game/Extensions/ModelExtensions.cs
new file mode 100644
index 0000000000..5c96add076
--- /dev/null
+++ b/osu.Game/Extensions/ModelExtensions.cs
@@ -0,0 +1,61 @@
+// 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.Beatmaps;
+using osu.Game.Rulesets;
+using osu.Game.Scoring;
+using osu.Game.Users;
+
+namespace osu.Game.Extensions
+{
+    public static class ModelExtensions
+    {
+        /// <summary>
+        /// Returns a user-facing string representing the <paramref name="model"/>.
+        /// </summary>
+        /// <remarks>
+        /// <para>
+        /// Non-interface types without special handling will fall back to <see cref="object.ToString()"/>.
+        /// </para>
+        /// <para>
+        /// Warning: This method is _purposefully_ not called <c>GetDisplayTitle()</c> like the others, because otherwise
+        /// extension method type inference rules cause this method to call itself and cause a stack overflow.
+        /// </para>
+        /// </remarks>
+        public static string GetDisplayString(this object model)
+        {
+            string result = null;
+
+            switch (model)
+            {
+                case IBeatmapSetInfo beatmapSetInfo:
+                    result = beatmapSetInfo.Metadata?.GetDisplayTitle();
+                    break;
+
+                case IBeatmapInfo beatmapInfo:
+                    result = beatmapInfo.GetDisplayTitle();
+                    break;
+
+                case IBeatmapMetadataInfo metadataInfo:
+                    result = metadataInfo.GetDisplayTitle();
+                    break;
+
+                case IScoreInfo scoreInfo:
+                    result = scoreInfo.GetDisplayTitle();
+                    break;
+
+                case IRulesetInfo rulesetInfo:
+                    result = rulesetInfo.Name;
+                    break;
+
+                case IUser user:
+                    result = user.Username;
+                    break;
+            }
+
+            // fallback in case none of the above happens to match.
+            result ??= model.ToString();
+            return result;
+        }
+    }
+}

From 9686bf507d7b49419e802f44d841579a954536b4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 9 Nov 2021 13:48:05 +0100
Subject: [PATCH 0861/5547] Add failing tests for coverage of
 `GetDisplayString()`

---
 osu.Game.Tests/Models/DisplayStringTest.cs | 95 ++++++++++++++++++++++
 1 file changed, 95 insertions(+)
 create mode 100644 osu.Game.Tests/Models/DisplayStringTest.cs

diff --git a/osu.Game.Tests/Models/DisplayStringTest.cs b/osu.Game.Tests/Models/DisplayStringTest.cs
new file mode 100644
index 0000000000..9a3c32bfb2
--- /dev/null
+++ b/osu.Game.Tests/Models/DisplayStringTest.cs
@@ -0,0 +1,95 @@
+// 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 NUnit.Framework;
+using osu.Game.Beatmaps;
+using osu.Game.Extensions;
+using osu.Game.Online.API.Requests.Responses;
+using osu.Game.Rulesets;
+using osu.Game.Scoring;
+using osu.Game.Users;
+
+namespace osu.Game.Tests.Models
+{
+    [TestFixture]
+    public class DisplayStringTest
+    {
+        private static readonly object[][] test_cases =
+        {
+            new object[] { makeMockBeatmapSet(), "artist - title (author)" },
+            new object[] { makeMockBeatmap(), "artist - title (author) [difficulty]" },
+            new object[] { makeMockMetadata(), "artist - title (author)" },
+            new object[] { makeMockScore(), "user playing artist - title (author) [difficulty]" },
+            new object[] { makeMockRuleset(), "ruleset" },
+            new object[] { makeMockUser(), "user" },
+            new object[] { new Fallback(), "fallback" }
+        };
+
+        [TestCaseSource(nameof(test_cases))]
+        public void TestDisplayString(object model, string expected) => Assert.That(model.GetDisplayString(), Is.EqualTo(expected));
+
+        private static IBeatmapSetInfo makeMockBeatmapSet()
+        {
+            var mock = new Mock<IBeatmapSetInfo>();
+
+            mock.Setup(m => m.Metadata).Returns(makeMockMetadata);
+
+            return mock.Object;
+        }
+
+        private static IBeatmapInfo makeMockBeatmap()
+        {
+            var mock = new Mock<IBeatmapInfo>();
+
+            mock.Setup(m => m.Metadata).Returns(makeMockMetadata);
+            mock.Setup(m => m.DifficultyName).Returns("difficulty");
+
+            return mock.Object;
+        }
+
+        private static IBeatmapMetadataInfo makeMockMetadata()
+        {
+            var mock = new Mock<IBeatmapMetadataInfo>();
+
+            mock.Setup(m => m.Artist).Returns("artist");
+            mock.Setup(m => m.Title).Returns("title");
+            mock.Setup(m => m.Author.Username).Returns("author");
+
+            return mock.Object;
+        }
+
+        private static IScoreInfo makeMockScore()
+        {
+            var mock = new Mock<IScoreInfo>();
+
+            mock.Setup(m => m.User).Returns(new APIUser { Username = "user" }); // TODO: temporary.
+            mock.Setup(m => m.Beatmap).Returns(makeMockBeatmap);
+
+            return mock.Object;
+        }
+
+        private static IRulesetInfo makeMockRuleset()
+        {
+            var mock = new Mock<IRulesetInfo>();
+
+            mock.Setup(m => m.Name).Returns("ruleset");
+
+            return mock.Object;
+        }
+
+        private static IUser makeMockUser()
+        {
+            var mock = new Mock<IUser>();
+
+            mock.Setup(m => m.Username).Returns("user");
+
+            return mock.Object;
+        }
+
+        private class Fallback
+        {
+            public override string ToString() => "fallback";
+        }
+    }
+}

From 3d148aea4040615fa8250a2de890b6e318783633 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 9 Nov 2021 13:51:18 +0100
Subject: [PATCH 0862/5547] Fix `GetDisplayTitle()` implementations relying on
 `ToString()` themselves

---
 osu.Game/Beatmaps/BeatmapInfoExtensions.cs         | 2 +-
 osu.Game/Beatmaps/BeatmapMetadataInfoExtensions.cs | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapInfoExtensions.cs b/osu.Game/Beatmaps/BeatmapInfoExtensions.cs
index 707b588063..eab66b9857 100644
--- a/osu.Game/Beatmaps/BeatmapInfoExtensions.cs
+++ b/osu.Game/Beatmaps/BeatmapInfoExtensions.cs
@@ -11,7 +11,7 @@ namespace osu.Game.Beatmaps
         /// <summary>
         /// A user-presentable display title representing this beatmap.
         /// </summary>
-        public static string GetDisplayTitle(this IBeatmapInfo beatmapInfo) => $"{beatmapInfo.Metadata} {getVersionString(beatmapInfo)}".Trim();
+        public static string GetDisplayTitle(this IBeatmapInfo beatmapInfo) => $"{beatmapInfo.Metadata.GetDisplayTitle()} {getVersionString(beatmapInfo)}".Trim();
 
         /// <summary>
         /// A user-presentable display title representing this beatmap, with localisation handling for potentially romanisable fields.
diff --git a/osu.Game/Beatmaps/BeatmapMetadataInfoExtensions.cs b/osu.Game/Beatmaps/BeatmapMetadataInfoExtensions.cs
index 27cd7f8d9a..32fb389e9a 100644
--- a/osu.Game/Beatmaps/BeatmapMetadataInfoExtensions.cs
+++ b/osu.Game/Beatmaps/BeatmapMetadataInfoExtensions.cs
@@ -27,7 +27,7 @@ namespace osu.Game.Beatmaps
         /// </summary>
         public static string GetDisplayTitle(this IBeatmapMetadataInfo metadataInfo)
         {
-            string author = string.IsNullOrEmpty(metadataInfo.Author.Username) ? string.Empty : $"({metadataInfo.Author})";
+            string author = string.IsNullOrEmpty(metadataInfo.Author.Username) ? string.Empty : $"({metadataInfo.Author.Username})";
             return $"{metadataInfo.Artist} - {metadataInfo.Title} {author}".Trim();
         }
 

From 03a315b9f54595446861e5cd6377efd44f17ffb8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 9 Nov 2021 14:33:06 +0100
Subject: [PATCH 0863/5547] Fix missing beatmap in replay download test scene

Was causing nullrefs in `GetDisplayTitle()`.
---
 osu.Game.Tests/Visual/Gameplay/TestSceneReplayDownloadButton.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneReplayDownloadButton.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneReplayDownloadButton.cs
index d4036fefc0..f47fae33ca 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneReplayDownloadButton.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneReplayDownloadButton.cs
@@ -175,7 +175,7 @@ namespace osu.Game.Tests.Visual.Gameplay
                     Id = 39828,
                     Username = @"WubWoofWolf",
                 }
-            }.CreateScoreInfo(rulesets);
+            }.CreateScoreInfo(rulesets, CreateBeatmap(new OsuRuleset().RulesetInfo).BeatmapInfo);
         }
 
         private class TestReplayDownloadButton : ReplayDownloadButton

From 64bc8da14c5b2e22d4ddc36e5644a64359133f5f Mon Sep 17 00:00:00 2001
From: Semyon Rozhkov <semro@outlook.com>
Date: Tue, 9 Nov 2021 17:11:19 +0300
Subject: [PATCH 0864/5547] Add "No Scope" mod implementation for Catch

---
 .../Mods/TestSceneCatchModNoScope.cs          | 156 ++++++++++++++++++
 osu.Game.Rulesets.Catch/CatchRuleset.cs       |   1 +
 .../Mods/CatchModNoScope.cs                   |  38 +++++
 osu.Game.Rulesets.Osu/Mods/OsuModNoScope.cs   |  72 +-------
 osu.Game/Rulesets/Mods/ModNoScope.cs          |  75 +++++++++
 5 files changed, 275 insertions(+), 67 deletions(-)
 create mode 100644 osu.Game.Rulesets.Catch.Tests/Mods/TestSceneCatchModNoScope.cs
 create mode 100644 osu.Game.Rulesets.Catch/Mods/CatchModNoScope.cs
 create mode 100644 osu.Game/Rulesets/Mods/ModNoScope.cs

diff --git a/osu.Game.Rulesets.Catch.Tests/Mods/TestSceneCatchModNoScope.cs b/osu.Game.Rulesets.Catch.Tests/Mods/TestSceneCatchModNoScope.cs
new file mode 100644
index 0000000000..5d8bbad384
--- /dev/null
+++ b/osu.Game.Rulesets.Catch.Tests/Mods/TestSceneCatchModNoScope.cs
@@ -0,0 +1,156 @@
+// 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.Framework.Utils;
+using osu.Framework.Testing;
+using osu.Game.Beatmaps;
+using osu.Game.Beatmaps.Timing;
+using osu.Game.Rulesets.Catch.Mods;
+using osu.Game.Rulesets.Catch.Objects;
+using osu.Game.Rulesets.Catch.Objects.Drawables;
+using osu.Game.Rulesets.Catch.UI;
+using osu.Game.Rulesets.Objects;
+using osu.Game.Tests.Visual;
+
+namespace osu.Game.Rulesets.Catch.Tests.Mods
+{
+    public class TestSceneCatchModNoScope : ModTestScene
+    {
+        protected override Ruleset CreatePlayerRuleset() => new CatchRuleset();
+
+        [Test]
+        public void TestVisibleDuringBreak()
+        {
+            CreateModTest(new ModTestData
+            {
+                Mod = new CatchModNoScope
+                {
+                    HiddenComboCount = { Value = 0 },
+                },
+                Autoplay = true,
+                PassCondition = () => true,
+                Beatmap = new Beatmap
+                {
+                    HitObjects = new List<HitObject>
+                    {
+                        new Fruit
+                        {
+                            X = CatchPlayfield.CENTER_X,
+                            StartTime = 1000,
+                        },
+                        new Fruit
+                        {
+                            X = CatchPlayfield.CENTER_X,
+                            StartTime = 5000,
+                        }
+                    },
+                    Breaks = new List<BreakPeriod>
+                    {
+                        new BreakPeriod(2000, 4000),
+                    }
+                }
+            });
+
+            AddUntilStep("wait for catcher to hide", () => catcherAlphaAlmostEquals(0));
+            AddUntilStep("wait for start of break", isBreak);
+            AddUntilStep("wait for catcher to show", () => catcherAlphaAlmostEquals(1));
+            AddUntilStep("wait for end of break", () => !isBreak());
+            AddUntilStep("wait for catcher to hide", () => catcherAlphaAlmostEquals(0));
+        }
+
+        [Test]
+        public void TestVisibleDuringBananaShower()
+        {
+            CreateModTest(new ModTestData
+            {
+                Mod = new CatchModNoScope
+                {
+                    HiddenComboCount = { Value = 0 },
+                },
+                Autoplay = true,
+                PassCondition = () => true,
+                Beatmap = new Beatmap
+                {
+                    HitObjects = new List<HitObject>
+                    {
+                        new Fruit
+                        {
+                            X = CatchPlayfield.CENTER_X,
+                            StartTime = 1000,
+                        },
+                        new BananaShower
+                        {
+                            StartTime = 2000,
+                            Duration = 2000,
+                        },
+                        new Fruit
+                        {
+                            X = CatchPlayfield.CENTER_X,
+                            StartTime = 5000,
+                        }
+                    }
+                }
+            });
+
+            AddUntilStep("wait for catcher to hide", () => catcherAlphaAlmostEquals(0));
+            AddUntilStep("wait for start of banana shower", isBananaShower);
+            AddUntilStep("wait for catcher to show", () => catcherAlphaAlmostEquals(1));
+            AddUntilStep("wait for end of banana shower", () => !isBananaShower());
+            AddUntilStep("wait for catcher to hide", () => catcherAlphaAlmostEquals(0));
+        }
+
+        [Test]
+        public void TestVisibleAfterComboBreak()
+        {
+            CreateModTest(new ModTestData
+            {
+                Mod = new CatchModNoScope
+                {
+                    HiddenComboCount = { Value = 2 },
+                },
+                Autoplay = true,
+                PassCondition = () => true,
+                Beatmap = new Beatmap
+                {
+                    HitObjects = new List<HitObject>
+                    {
+                        new Fruit
+                        {
+                            X = 0,
+                            StartTime = 1000,
+                        },
+                        new Fruit
+                        {
+                            X = CatchPlayfield.CENTER_X,
+                            StartTime = 3000,
+                        },
+                        new Fruit
+                        {
+                            X = CatchPlayfield.WIDTH,
+                            StartTime = 5000,
+                        },
+                    }
+                }
+            });
+
+            AddAssert("catcher must start visible", () => catcherAlphaAlmostEquals(1));
+            AddUntilStep("wait for combo", () => Player.ScoreProcessor.Combo.Value >= 2);
+            AddAssert("catcher must dim after combo", () => !catcherAlphaAlmostEquals(1));
+            AddStep("break combo", () => Player.ScoreProcessor.Combo.Set(0));
+            AddUntilStep("wait for catcher to show", () => catcherAlphaAlmostEquals(1));
+        }
+
+        private bool isBananaShower() => Player.ChildrenOfType<DrawableBananaShower>().SingleOrDefault() != null;
+
+        private bool isBreak() => Player.IsBreakTime.Value;
+
+        private bool catcherAlphaAlmostEquals(float alpha)
+        {
+            var playfield = (CatchPlayfield)Player.DrawableRuleset.Playfield;
+            return Precision.AlmostEquals(playfield.CatcherArea.Alpha, alpha);
+        }
+    }
+}
diff --git a/osu.Game.Rulesets.Catch/CatchRuleset.cs b/osu.Game.Rulesets.Catch/CatchRuleset.cs
index 9fee6b2bc1..c256172177 100644
--- a/osu.Game.Rulesets.Catch/CatchRuleset.cs
+++ b/osu.Game.Rulesets.Catch/CatchRuleset.cs
@@ -133,6 +133,7 @@ namespace osu.Game.Rulesets.Catch
                         new MultiMod(new ModWindUp(), new ModWindDown()),
                         new CatchModFloatingFruits(),
                         new CatchModMuted(),
+                        new CatchModNoScope(),
                     };
 
                 default:
diff --git a/osu.Game.Rulesets.Catch/Mods/CatchModNoScope.cs b/osu.Game.Rulesets.Catch/Mods/CatchModNoScope.cs
new file mode 100644
index 0000000000..7b55150582
--- /dev/null
+++ b/osu.Game.Rulesets.Catch/Mods/CatchModNoScope.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;
+using System.Linq;
+using osu.Game.Beatmaps;
+using osu.Game.Rulesets.Mods;
+using osu.Framework.Utils;
+using osu.Game.Rulesets.Catch.Objects;
+using osu.Game.Rulesets.Catch.UI;
+using osu.Game.Rulesets.UI;
+using osu.Game.Utils;
+
+namespace osu.Game.Rulesets.Catch.Mods
+{
+    public class CatchModNoScope : ModNoScope, IApplicableToBeatmap, IApplicableToDrawableRuleset<CatchHitObject>
+    {
+        public override string Description => "Where's the catcher?";
+
+        public PeriodTracker BananaShowerPeriods;
+
+        public void ApplyToBeatmap(IBeatmap beatmap)
+        {
+            BananaShowerPeriods = new PeriodTracker(beatmap.HitObjects.OfType<BananaShower>().Select(b => new Period(b.StartTime - TRANSITION_DURATION, b.EndTime)));
+        }
+
+        public void ApplyToDrawableRuleset(DrawableRuleset<CatchHitObject> drawableRuleset)
+        {
+            var playfield = (CatchPlayfield)drawableRuleset.Playfield;
+            playfield.OnUpdate += _ =>
+            {
+                bool shouldAlwaysShowCatcher = IsBreakTime.Value || BananaShowerPeriods.IsInAny(playfield.Clock.CurrentTime);
+                float targetAlpha = shouldAlwaysShowCatcher ? 1 : ComboBasedAlpha;
+                playfield.CatcherArea.Alpha = (float)Interpolation.Lerp(playfield.CatcherArea.Alpha, targetAlpha, Math.Clamp(playfield.Time.Elapsed / TRANSITION_DURATION, 0, 1));
+            };
+        }
+    }
+}
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModNoScope.cs b/osu.Game.Rulesets.Osu/Mods/OsuModNoScope.cs
index 501c0a55bd..3f9cd098cd 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModNoScope.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModNoScope.cs
@@ -3,93 +3,31 @@
 
 using System;
 using System.Linq;
-using osu.Framework.Bindables;
-using osu.Framework.Graphics;
-using osu.Framework.Graphics.Sprites;
-using osu.Framework.Localisation;
 using osu.Framework.Utils;
 using osu.Game.Beatmaps;
-using osu.Game.Configuration;
-using osu.Game.Graphics.UserInterface;
-using osu.Game.Overlays.Settings;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Osu.Objects;
 using osu.Game.Rulesets.UI;
-using osu.Game.Rulesets.Scoring;
-using osu.Game.Scoring;
-using osu.Game.Screens.Play;
 using osu.Game.Utils;
 
 namespace osu.Game.Rulesets.Osu.Mods
 {
-    public class OsuModNoScope : Mod, IUpdatableByPlayfield, IApplicableToScoreProcessor, IApplicableToPlayer, IApplicableToBeatmap
+    public class OsuModNoScope : ModNoScope, IUpdatableByPlayfield, IApplicableToBeatmap
     {
-        /// <summary>
-        /// Slightly higher than the cutoff for <see cref="Drawable.IsPresent"/>.
-        /// </summary>
-        private const float min_alpha = 0.0002f;
-
-        private const float transition_duration = 100;
-
-        public override string Name => "No Scope";
-        public override string Acronym => "NS";
-        public override ModType Type => ModType.Fun;
-        public override IconUsage? Icon => FontAwesome.Solid.EyeSlash;
         public override string Description => "Where's the cursor?";
-        public override double ScoreMultiplier => 1;
 
-        private BindableNumber<int> currentCombo;
-        private IBindable<bool> isBreakTime;
         private PeriodTracker spinnerPeriods;
 
-        private float comboBasedAlpha;
-
-        [SettingSource(
-            "Hidden at combo",
-            "The combo count at which the cursor becomes completely hidden",
-            SettingControlType = typeof(SettingsSlider<int, HiddenComboSlider>)
-        )]
-        public BindableInt HiddenComboCount { get; } = new BindableInt
-        {
-            Default = 10,
-            Value = 10,
-            MinValue = 0,
-            MaxValue = 50,
-        };
-
-        public ScoreRank AdjustRank(ScoreRank rank, double accuracy) => rank;
-
-        public void ApplyToPlayer(Player player)
-        {
-            isBreakTime = player.IsBreakTime.GetBoundCopy();
-        }
-
         public void ApplyToBeatmap(IBeatmap beatmap)
         {
-            spinnerPeriods = new PeriodTracker(beatmap.HitObjects.OfType<Spinner>().Select(b => new Period(b.StartTime - transition_duration, b.EndTime)));
-        }
-
-        public void ApplyToScoreProcessor(ScoreProcessor scoreProcessor)
-        {
-            if (HiddenComboCount.Value == 0) return;
-
-            currentCombo = scoreProcessor.Combo.GetBoundCopy();
-            currentCombo.BindValueChanged(combo =>
-            {
-                comboBasedAlpha = Math.Max(min_alpha, 1 - (float)combo.NewValue / HiddenComboCount.Value);
-            }, true);
+            spinnerPeriods = new PeriodTracker(beatmap.HitObjects.OfType<Spinner>().Select(b => new Period(b.StartTime - TRANSITION_DURATION, b.EndTime)));
         }
 
         public virtual void Update(Playfield playfield)
         {
-            bool shouldAlwaysShowCursor = isBreakTime.Value || spinnerPeriods.IsInAny(playfield.Clock.CurrentTime);
-            float targetAlpha = shouldAlwaysShowCursor ? 1 : comboBasedAlpha;
-            playfield.Cursor.Alpha = (float)Interpolation.Lerp(playfield.Cursor.Alpha, targetAlpha, Math.Clamp(playfield.Time.Elapsed / transition_duration, 0, 1));
+            bool shouldAlwaysShowCursor = IsBreakTime.Value || spinnerPeriods.IsInAny(playfield.Clock.CurrentTime);
+            float targetAlpha = shouldAlwaysShowCursor ? 1 : ComboBasedAlpha;
+            playfield.Cursor.Alpha = (float)Interpolation.Lerp(playfield.Cursor.Alpha, targetAlpha, Math.Clamp(playfield.Time.Elapsed / TRANSITION_DURATION, 0, 1));
         }
     }
-
-    public class HiddenComboSlider : OsuSliderBar<int>
-    {
-        public override LocalisableString TooltipText => Current.Value == 0 ? "always hidden" : base.TooltipText;
-    }
 }
diff --git a/osu.Game/Rulesets/Mods/ModNoScope.cs b/osu.Game/Rulesets/Mods/ModNoScope.cs
new file mode 100644
index 0000000000..9e2734b775
--- /dev/null
+++ b/osu.Game/Rulesets/Mods/ModNoScope.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 System;
+using osu.Framework.Bindables;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Sprites;
+using osu.Framework.Localisation;
+using osu.Game.Configuration;
+using osu.Game.Graphics.UserInterface;
+using osu.Game.Overlays.Settings;
+using osu.Game.Rulesets.Scoring;
+using osu.Game.Scoring;
+using osu.Game.Screens.Play;
+
+namespace osu.Game.Rulesets.Mods
+{
+    public abstract class ModNoScope : Mod, IApplicableToScoreProcessor, IApplicableToPlayer
+    {
+        public override string Name => "No Scope";
+        public override string Acronym => "NS";
+        public override ModType Type => ModType.Fun;
+        public override IconUsage? Icon => FontAwesome.Solid.EyeSlash;
+        public override double ScoreMultiplier => 1;
+
+        /// <summary>
+        /// Slightly higher than the cutoff for <see cref="Drawable.IsPresent"/>.
+        /// </summary>
+        protected const float MIN_ALPHA = 0.0002f;
+
+        protected const float TRANSITION_DURATION = 100;
+
+        protected BindableNumber<int> CurrentCombo;
+
+        protected IBindable<bool> IsBreakTime;
+
+        protected float ComboBasedAlpha;
+
+        [SettingSource(
+            "Hidden at combo",
+            "The combo count at which the cursor becomes completely hidden",
+            SettingControlType = typeof(SettingsSlider<int, HiddenComboSlider>)
+        )]
+        public BindableInt HiddenComboCount { get; } = new BindableInt
+        {
+            Default = 10,
+            Value = 10,
+            MinValue = 0,
+            MaxValue = 50,
+        };
+
+        public ScoreRank AdjustRank(ScoreRank rank, double accuracy) => rank;
+
+        public void ApplyToPlayer(Player player)
+        {
+            IsBreakTime = player.IsBreakTime.GetBoundCopy();
+        }
+
+        public void ApplyToScoreProcessor(ScoreProcessor scoreProcessor)
+        {
+            if (HiddenComboCount.Value == 0) return;
+
+            CurrentCombo = scoreProcessor.Combo.GetBoundCopy();
+            CurrentCombo.BindValueChanged(combo =>
+            {
+                ComboBasedAlpha = Math.Max(MIN_ALPHA, 1 - (float)combo.NewValue / HiddenComboCount.Value);
+            }, true);
+        }
+    }
+
+    public class HiddenComboSlider : OsuSliderBar<int>
+    {
+        public override LocalisableString TooltipText => Current.Value == 0 ? "always hidden" : base.TooltipText;
+    }
+}

From 286754f6f73c4f0fbf87d0250ec964a088aa41bc Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 8 Nov 2021 14:24:39 +0100
Subject: [PATCH 0865/5547] Move clipboard operation implementation down to
 current screen

---
 .../Screens/Edit/Compose/ComposeScreen.cs     | 55 ++++++++++++++++++-
 osu.Game/Screens/Edit/Editor.cs               | 51 +++--------------
 osu.Game/Screens/Edit/EditorScreen.cs         | 25 +++++++++
 3 files changed, 86 insertions(+), 45 deletions(-)

diff --git a/osu.Game/Screens/Edit/Compose/ComposeScreen.cs b/osu.Game/Screens/Edit/Compose/ComposeScreen.cs
index 926a2ad4e0..2214c517db 100644
--- a/osu.Game/Screens/Edit/Compose/ComposeScreen.cs
+++ b/osu.Game/Screens/Edit/Compose/ComposeScreen.cs
@@ -13,6 +13,7 @@ using osu.Framework.Input.Events;
 using osu.Framework.Platform;
 using osu.Game.Beatmaps;
 using osu.Game.Extensions;
+using osu.Game.IO.Serialization;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Edit;
 using osu.Game.Screens.Edit.Compose.Components.Timeline;
@@ -21,15 +22,15 @@ namespace osu.Game.Screens.Edit.Compose
 {
     public class ComposeScreen : EditorScreenWithTimeline, IKeyBindingHandler<PlatformAction>
     {
-        [Resolved]
-        private IBindable<WorkingBeatmap> beatmap { get; set; }
-
         [Resolved]
         private GameHost host { get; set; }
 
         [Resolved]
         private EditorClock clock { get; set; }
 
+        [Resolved(Name = nameof(Editor.Clipboard))]
+        private Bindable<string> clipboard { get; set; }
+
         private HitObjectComposer composer;
 
         public ComposeScreen()
@@ -104,5 +105,53 @@ namespace osu.Game.Screens.Edit.Compose
         }
 
         #endregion
+
+        #region Clipboard operations
+
+        public override void Cut()
+        {
+            base.Cut();
+
+            Copy();
+            EditorBeatmap.RemoveRange(EditorBeatmap.SelectedHitObjects.ToArray());
+        }
+
+        public override void Copy()
+        {
+            base.Copy();
+
+            if (EditorBeatmap.SelectedHitObjects.Count == 0)
+                return;
+
+            clipboard.Value = new ClipboardContent(EditorBeatmap).Serialize();
+        }
+
+        public override void Paste()
+        {
+            base.Paste();
+
+            if (string.IsNullOrEmpty(clipboard.Value))
+                return;
+
+            var objects = clipboard.Value.Deserialize<ClipboardContent>().HitObjects;
+
+            Debug.Assert(objects.Any());
+
+            double timeOffset = clock.CurrentTime - objects.Min(o => o.StartTime);
+
+            foreach (var h in objects)
+                h.StartTime += timeOffset;
+
+            EditorBeatmap.BeginChange();
+
+            EditorBeatmap.SelectedHitObjects.Clear();
+
+            EditorBeatmap.AddRange(objects);
+            EditorBeatmap.SelectedHitObjects.AddRange(objects);
+
+            EditorBeatmap.EndChange();
+        }
+
+        #endregion
     }
 }
diff --git a/osu.Game/Screens/Edit/Editor.cs b/osu.Game/Screens/Edit/Editor.cs
index 81b2847443..f51b527117 100644
--- a/osu.Game/Screens/Edit/Editor.cs
+++ b/osu.Game/Screens/Edit/Editor.cs
@@ -3,7 +3,6 @@
 
 using System;
 using System.Collections.Generic;
-using System.Diagnostics;
 using System.Linq;
 using JetBrains.Annotations;
 using osu.Framework;
@@ -24,7 +23,6 @@ using osu.Game.Graphics;
 using osu.Game.Graphics.Cursor;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Input.Bindings;
-using osu.Game.IO.Serialization;
 using osu.Game.Online.API;
 using osu.Game.Overlays;
 using osu.Game.Rulesets.Edit;
@@ -105,6 +103,9 @@ namespace osu.Game.Screens.Edit
         [Resolved]
         private MusicController music { get; set; }
 
+        [Cached(Name = nameof(Clipboard))]
+        public readonly Bindable<string> Clipboard = new Bindable<string>();
+
         public Editor(EditorLoader loader = null)
         {
             this.loader = loader;
@@ -307,7 +308,7 @@ namespace osu.Game.Screens.Edit
                 copyMenuItem.Action.Disabled = !hasObjects;
             }, true);
 
-            clipboard.BindValueChanged(content => pasteMenuItem.Action.Disabled = string.IsNullOrEmpty(content.NewValue));
+            Clipboard.BindValueChanged(content => pasteMenuItem.Action.Disabled = string.IsNullOrEmpty(content.NewValue));
 
             menuBar.Mode.ValueChanged += onModeChanged;
         }
@@ -324,7 +325,7 @@ namespace osu.Game.Screens.Edit
         public void RestoreState([NotNull] EditorState state) => Schedule(() =>
         {
             clock.Seek(state.Time);
-            clipboard.Value = state.ClipboardContent;
+            Clipboard.Value = state.ClipboardContent;
         });
 
         protected void Save()
@@ -561,45 +562,11 @@ namespace osu.Game.Screens.Edit
             this.Exit();
         }
 
-        private readonly Bindable<string> clipboard = new Bindable<string>();
+        protected void Cut() => currentScreen?.Cut();
 
-        protected void Cut()
-        {
-            Copy();
-            editorBeatmap.RemoveRange(editorBeatmap.SelectedHitObjects.ToArray());
-        }
+        protected void Copy() => currentScreen?.Copy();
 
-        protected void Copy()
-        {
-            if (editorBeatmap.SelectedHitObjects.Count == 0)
-                return;
-
-            clipboard.Value = new ClipboardContent(editorBeatmap).Serialize();
-        }
-
-        protected void Paste()
-        {
-            if (string.IsNullOrEmpty(clipboard.Value))
-                return;
-
-            var objects = clipboard.Value.Deserialize<ClipboardContent>().HitObjects;
-
-            Debug.Assert(objects.Any());
-
-            double timeOffset = clock.CurrentTime - objects.Min(o => o.StartTime);
-
-            foreach (var h in objects)
-                h.StartTime += timeOffset;
-
-            editorBeatmap.BeginChange();
-
-            editorBeatmap.SelectedHitObjects.Clear();
-
-            editorBeatmap.AddRange(objects);
-            editorBeatmap.SelectedHitObjects.AddRange(objects);
-
-            editorBeatmap.EndChange();
-        }
+        protected void Paste() => currentScreen?.Paste();
 
         protected void Undo() => changeHandler.RestoreState(-1);
 
@@ -757,7 +724,7 @@ namespace osu.Game.Screens.Edit
         protected void SwitchToDifficulty(BeatmapInfo nextBeatmap) => loader?.ScheduleDifficultySwitch(nextBeatmap, new EditorState
         {
             Time = clock.CurrentTimeAccurate,
-            ClipboardContent = editorBeatmap.BeatmapInfo.RulesetID == nextBeatmap.RulesetID ? clipboard.Value : string.Empty
+            ClipboardContent = editorBeatmap.BeatmapInfo.RulesetID == nextBeatmap.RulesetID ? Clipboard.Value : string.Empty
         });
 
         private void cancelExit()
diff --git a/osu.Game/Screens/Edit/EditorScreen.cs b/osu.Game/Screens/Edit/EditorScreen.cs
index 2810f78835..a406aeb743 100644
--- a/osu.Game/Screens/Edit/EditorScreen.cs
+++ b/osu.Game/Screens/Edit/EditorScreen.cs
@@ -49,5 +49,30 @@ namespace osu.Game.Screens.Edit
             this.ScaleTo(0.98f, 200, Easing.OutQuint)
                 .FadeOut(200, Easing.OutQuint);
         }
+
+        #region Clipboard operations
+
+        /// <summary>
+        /// Performs a "cut to clipboard" operation appropriate for the given screen.
+        /// </summary>
+        public virtual void Cut()
+        {
+        }
+
+        /// <summary>
+        /// Performs a "copy to clipboard" operation appropriate for the given screen.
+        /// </summary>
+        public virtual void Copy()
+        {
+        }
+
+        /// <summary>
+        /// Performs a "paste from clipboard" operation appropriate for the given screen.
+        /// </summary>
+        public virtual void Paste()
+        {
+        }
+
+        #endregion
     }
 }

From 042b05a2501a29647d2db18df15ae7e9376ac5f0 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 8 Nov 2021 14:54:31 +0100
Subject: [PATCH 0866/5547] Move clipboard action availability logic down to
 editor screens

---
 .../Screens/Edit/Compose/ComposeScreen.cs     | 31 +++++++-----
 osu.Game/Screens/Edit/Editor.cs               | 47 +++++++++++++------
 osu.Game/Screens/Edit/EditorScreen.cs         | 29 +++++++++++-
 3 files changed, 79 insertions(+), 28 deletions(-)

diff --git a/osu.Game/Screens/Edit/Compose/ComposeScreen.cs b/osu.Game/Screens/Edit/Compose/ComposeScreen.cs
index 2214c517db..b0a85f33d9 100644
--- a/osu.Game/Screens/Edit/Compose/ComposeScreen.cs
+++ b/osu.Game/Screens/Edit/Compose/ComposeScreen.cs
@@ -77,6 +77,13 @@ namespace osu.Game.Screens.Edit.Compose
             return new EditorSkinProvidingContainer(EditorBeatmap).WithChild(content);
         }
 
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+            EditorBeatmap.SelectedHitObjects.BindCollectionChanged((_, __) => updateClipboardActionAvailability());
+            clipboard.BindValueChanged(_ => updateClipboardActionAvailability(), true);
+        }
+
         #region Input Handling
 
         public bool OnPressed(KeyBindingPressEvent<PlatformAction> e)
@@ -108,30 +115,24 @@ namespace osu.Game.Screens.Edit.Compose
 
         #region Clipboard operations
 
-        public override void Cut()
+        protected override void PerformCut()
         {
-            base.Cut();
+            base.PerformCut();
 
             Copy();
             EditorBeatmap.RemoveRange(EditorBeatmap.SelectedHitObjects.ToArray());
         }
 
-        public override void Copy()
+        protected override void PerformCopy()
         {
-            base.Copy();
-
-            if (EditorBeatmap.SelectedHitObjects.Count == 0)
-                return;
+            base.PerformCopy();
 
             clipboard.Value = new ClipboardContent(EditorBeatmap).Serialize();
         }
 
-        public override void Paste()
+        protected override void PerformPaste()
         {
-            base.Paste();
-
-            if (string.IsNullOrEmpty(clipboard.Value))
-                return;
+            base.PerformPaste();
 
             var objects = clipboard.Value.Deserialize<ClipboardContent>().HitObjects;
 
@@ -152,6 +153,12 @@ namespace osu.Game.Screens.Edit.Compose
             EditorBeatmap.EndChange();
         }
 
+        private void updateClipboardActionAvailability()
+        {
+            CanCut.Value = CanCopy.Value = EditorBeatmap.SelectedHitObjects.Any();
+            CanPaste.Value = !string.IsNullOrEmpty(clipboard.Value);
+        }
+
         #endregion
     }
 }
diff --git a/osu.Game/Screens/Edit/Editor.cs b/osu.Game/Screens/Edit/Editor.cs
index f51b527117..b8a1dda508 100644
--- a/osu.Game/Screens/Edit/Editor.cs
+++ b/osu.Game/Screens/Edit/Editor.cs
@@ -181,10 +181,6 @@ namespace osu.Game.Screens.Edit
             OsuMenuItem undoMenuItem;
             OsuMenuItem redoMenuItem;
 
-            EditorMenuItem cutMenuItem;
-            EditorMenuItem copyMenuItem;
-            EditorMenuItem pasteMenuItem;
-
             AddInternal(new OsuContextMenuContainer
             {
                 RelativeSizeAxes = Axes.Both,
@@ -300,19 +296,15 @@ namespace osu.Game.Screens.Edit
             changeHandler.CanUndo.BindValueChanged(v => undoMenuItem.Action.Disabled = !v.NewValue, true);
             changeHandler.CanRedo.BindValueChanged(v => redoMenuItem.Action.Disabled = !v.NewValue, true);
 
-            editorBeatmap.SelectedHitObjects.BindCollectionChanged((_, __) =>
-            {
-                bool hasObjects = editorBeatmap.SelectedHitObjects.Count > 0;
-
-                cutMenuItem.Action.Disabled = !hasObjects;
-                copyMenuItem.Action.Disabled = !hasObjects;
-            }, true);
-
-            Clipboard.BindValueChanged(content => pasteMenuItem.Action.Disabled = string.IsNullOrEmpty(content.NewValue));
-
             menuBar.Mode.ValueChanged += onModeChanged;
         }
 
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+            setUpClipboardActionAvailability();
+        }
+
         /// <summary>
         /// If the beatmap's track has changed, this method must be called to keep the editor in a valid state.
         /// </summary>
@@ -562,12 +554,38 @@ namespace osu.Game.Screens.Edit
             this.Exit();
         }
 
+        #region Clipboard support
+
+        private EditorMenuItem cutMenuItem;
+        private EditorMenuItem copyMenuItem;
+        private EditorMenuItem pasteMenuItem;
+
+        private readonly BindableWithCurrent<bool> canCut = new BindableWithCurrent<bool>();
+        private readonly BindableWithCurrent<bool> canCopy = new BindableWithCurrent<bool>();
+        private readonly BindableWithCurrent<bool> canPaste = new BindableWithCurrent<bool>();
+
+        private void setUpClipboardActionAvailability()
+        {
+            canCut.Current.BindValueChanged(cut => cutMenuItem.Action.Disabled = !cut.NewValue, true);
+            canCopy.Current.BindValueChanged(copy => copyMenuItem.Action.Disabled = !copy.NewValue, true);
+            canPaste.Current.BindValueChanged(paste => pasteMenuItem.Action.Disabled = !paste.NewValue, true);
+        }
+
+        private void rebindClipboardBindables()
+        {
+            canCut.Current = currentScreen.CanCut;
+            canCopy.Current = currentScreen.CanCopy;
+            canPaste.Current = currentScreen.CanPaste;
+        }
+
         protected void Cut() => currentScreen?.Cut();
 
         protected void Copy() => currentScreen?.Copy();
 
         protected void Paste() => currentScreen?.Paste();
 
+        #endregion
+
         protected void Undo() => changeHandler.RestoreState(-1);
 
         protected void Redo() => changeHandler.RestoreState(1);
@@ -644,6 +662,7 @@ namespace osu.Game.Screens.Edit
             finally
             {
                 updateSampleDisabledState();
+                rebindClipboardBindables();
             }
         }
 
diff --git a/osu.Game/Screens/Edit/EditorScreen.cs b/osu.Game/Screens/Edit/EditorScreen.cs
index a406aeb743..516d7a23e0 100644
--- a/osu.Game/Screens/Edit/EditorScreen.cs
+++ b/osu.Game/Screens/Edit/EditorScreen.cs
@@ -2,6 +2,7 @@
 // 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.Cursor;
@@ -52,25 +53,49 @@ namespace osu.Game.Screens.Edit
 
         #region Clipboard operations
 
+        public BindableBool CanCut { get; } = new BindableBool();
+
         /// <summary>
         /// Performs a "cut to clipboard" operation appropriate for the given screen.
         /// </summary>
-        public virtual void Cut()
+        protected virtual void PerformCut()
         {
         }
 
+        public void Cut()
+        {
+            if (CanCut.Value)
+                PerformCut();
+        }
+
+        public BindableBool CanCopy { get; } = new BindableBool();
+
         /// <summary>
         /// Performs a "copy to clipboard" operation appropriate for the given screen.
         /// </summary>
-        public virtual void Copy()
+        protected virtual void PerformCopy()
         {
         }
 
+        public virtual void Copy()
+        {
+            if (CanCopy.Value)
+                PerformCopy();
+        }
+
+        public BindableBool CanPaste { get; } = new BindableBool();
+
         /// <summary>
         /// Performs a "paste from clipboard" operation appropriate for the given screen.
         /// </summary>
+        protected virtual void PerformPaste()
+        {
+        }
+
         public virtual void Paste()
         {
+            if (CanPaste.Value)
+                PerformPaste();
         }
 
         #endregion

From 410e9159d1e70a132a1a404a773a370d8ee050c5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 8 Nov 2021 15:27:11 +0100
Subject: [PATCH 0867/5547] Fix test failures due to missing dependencies

---
 .../Editor/TestSceneManiaComposeScreen.cs                     | 4 ++++
 osu.Game.Tests/Visual/Editing/TestSceneComposeScreen.cs       | 4 ++++
 2 files changed, 8 insertions(+)

diff --git a/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneManiaComposeScreen.cs b/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneManiaComposeScreen.cs
index 0f520215a1..60a5051fb5 100644
--- a/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneManiaComposeScreen.cs
+++ b/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneManiaComposeScreen.cs
@@ -5,6 +5,7 @@ using System;
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
+using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Testing;
@@ -22,6 +23,9 @@ namespace osu.Game.Rulesets.Mania.Tests.Editor
         [Resolved]
         private SkinManager skins { get; set; }
 
+        [Cached(Name = nameof(Screens.Edit.Editor.Clipboard))]
+        private Bindable<string> clipboard = new Bindable<string>();
+
         [SetUpSteps]
         public void SetUpSteps()
         {
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneComposeScreen.cs b/osu.Game.Tests/Visual/Editing/TestSceneComposeScreen.cs
index 4813598c9d..8796088ec6 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneComposeScreen.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneComposeScreen.cs
@@ -3,6 +3,7 @@
 
 using NUnit.Framework;
 using osu.Framework.Allocation;
+using osu.Framework.Bindables;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Rulesets.Edit;
 using osu.Game.Rulesets.Osu;
@@ -26,6 +27,9 @@ namespace osu.Game.Tests.Visual.Editing
                 }
             });
 
+        [Cached(Name = nameof(Editor.Clipboard))]
+        private Bindable<string> clipboard = new Bindable<string>();
+
         [BackgroundDependencyLoader]
         private void load()
         {

From fbfed167565b3a8646ad6915d9d04f71f7eae42d Mon Sep 17 00:00:00 2001
From: Darius Wattimena <dariuswattimena@hotmail.com>
Date: Tue, 9 Nov 2021 23:05:25 +0100
Subject: [PATCH 0868/5547] Started on implementing a spinner gap check for
 catch

---
 .idea/.idea.osu.Desktop/.idea/indexLayout.xml |  5 +
 osu.Game.Rulesets.Catch/CatchRuleset.cs       |  2 +
 .../Edit/CatchBeatmapVerifier.cs              | 24 +++++
 .../Edit/Checks/CheckTooShortSpinnerGap.cs    | 91 +++++++++++++++++++
 4 files changed, 122 insertions(+)
 create mode 100644 osu.Game.Rulesets.Catch/Edit/CatchBeatmapVerifier.cs
 create mode 100644 osu.Game.Rulesets.Catch/Edit/Checks/CheckTooShortSpinnerGap.cs

diff --git a/.idea/.idea.osu.Desktop/.idea/indexLayout.xml b/.idea/.idea.osu.Desktop/.idea/indexLayout.xml
index 7b08163ceb..90e8a163b9 100644
--- a/.idea/.idea.osu.Desktop/.idea/indexLayout.xml
+++ b/.idea/.idea.osu.Desktop/.idea/indexLayout.xml
@@ -1,5 +1,10 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <project version="4">
+  <component name="ContentModelUserStore">
+    <attachedFolders />
+    <explicitIncludes />
+    <explicitExcludes />
+  </component>
   <component name="UserContentModel">
     <attachedFolders />
     <explicitIncludes />
diff --git a/osu.Game.Rulesets.Catch/CatchRuleset.cs b/osu.Game.Rulesets.Catch/CatchRuleset.cs
index 9fee6b2bc1..6b26a915dd 100644
--- a/osu.Game.Rulesets.Catch/CatchRuleset.cs
+++ b/osu.Game.Rulesets.Catch/CatchRuleset.cs
@@ -188,5 +188,7 @@ namespace osu.Game.Rulesets.Catch
         public override IConvertibleReplayFrame CreateConvertibleReplayFrame() => new CatchReplayFrame();
 
         public override HitObjectComposer CreateHitObjectComposer() => new CatchHitObjectComposer(this);
+
+        public override IBeatmapVerifier CreateBeatmapVerifier() => new CatchBeatmapVerifier();
     }
 }
diff --git a/osu.Game.Rulesets.Catch/Edit/CatchBeatmapVerifier.cs b/osu.Game.Rulesets.Catch/Edit/CatchBeatmapVerifier.cs
new file mode 100644
index 0000000000..6aa1749ff9
--- /dev/null
+++ b/osu.Game.Rulesets.Catch/Edit/CatchBeatmapVerifier.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.Catch.Edit.Checks;
+using osu.Game.Rulesets.Edit;
+using osu.Game.Rulesets.Edit.Checks.Components;
+
+namespace osu.Game.Rulesets.Catch.Edit
+{
+    public class CatchBeatmapVerifier : IBeatmapVerifier
+    {
+        private readonly List<ICheck> checks = new List<ICheck>
+        {
+            new CheckTooShortSpinnerGap()
+        };
+
+        public IEnumerable<Issue> Run(BeatmapVerifierContext context)
+        {
+            return checks.SelectMany(check => check.Run(context));
+        }
+    }
+}
diff --git a/osu.Game.Rulesets.Catch/Edit/Checks/CheckTooShortSpinnerGap.cs b/osu.Game.Rulesets.Catch/Edit/Checks/CheckTooShortSpinnerGap.cs
new file mode 100644
index 0000000000..7b0b5c74ce
--- /dev/null
+++ b/osu.Game.Rulesets.Catch/Edit/Checks/CheckTooShortSpinnerGap.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.
+
+using System;
+using System.Collections.Generic;
+using osu.Game.Rulesets.Catch.Objects;
+using osu.Game.Rulesets.Edit;
+using osu.Game.Rulesets.Edit.Checks.Components;
+using osu.Game.Rulesets.Objects;
+
+namespace osu.Game.Rulesets.Catch.Edit.Checks
+{
+    public class CheckTooShortSpinnerGap : ICheck
+    {
+        private static readonly int[] spinner_start_delta_threshold = { 250, 250, 125, 125, 62, 62 };
+        private static readonly int[] spinner_end_delta_threshold = { 250, 250, 250, 125, 125, 125 };
+
+        public CheckMetadata Metadata { get; } = new CheckMetadata(CheckCategory.Compose, "Too short spinner gap");
+
+        public IEnumerable<IssueTemplate> PossibleTemplates => new IssueTemplate[]
+        {
+            new IssueTemplateSpinnerStartGap(this),
+            new IssueTemplateSpinnerEndGap(this)
+        };
+
+        public IEnumerable<Issue> Run(BeatmapVerifierContext context)
+        {
+            var hitObjects = context.Beatmap.HitObjects;
+            int interpretedDifficulty = (int)context.InterpretedDifficulty;
+            int expectedStartDelta = spinner_start_delta_threshold[interpretedDifficulty];
+            int expectedEndDelta = spinner_end_delta_threshold[interpretedDifficulty];
+
+            for (int i = 0; i < hitObjects.Count - 1; ++i)
+            {
+                if (!(hitObjects[i] is BananaShower bananaShower))
+                    continue;
+
+                if (i != 0 && hitObjects[i - 1] is CatchHitObject previousHitObject && !(previousHitObject is BananaShower))
+                {
+                    double spinnerStartDelta = bananaShower.StartTime - previousHitObject.GetEndTime();
+
+                    if (spinnerStartDelta < expectedStartDelta)
+                    {
+                        yield return new IssueTemplateSpinnerStartGap(this)
+                            .Create(spinnerStartDelta, expectedStartDelta, bananaShower, previousHitObject);
+                    }
+                }
+
+                if (hitObjects[i + 1] is CatchHitObject nextHitObject && !(nextHitObject is BananaShower))
+                {
+                    double spinnerEndDelta = nextHitObject.StartTime - bananaShower.EndTime;
+
+                    if (spinnerEndDelta < expectedEndDelta)
+                    {
+                        yield return new IssueTemplateSpinnerEndGap(this)
+                            .Create(spinnerEndDelta, expectedEndDelta, bananaShower, nextHitObject);
+                    }
+                }
+            }
+        }
+
+        public abstract class IssueTemplateSpinnerGap : IssueTemplate
+        {
+            protected IssueTemplateSpinnerGap(ICheck check, IssueType issueType, string unformattedMessage)
+                : base(check, issueType, unformattedMessage)
+            {
+            }
+
+            public Issue Create(double deltaTime, int expectedDeltaTime, params HitObject[] hitObjects)
+            {
+                return new Issue(hitObjects, this, Math.Floor(deltaTime), expectedDeltaTime);
+            }
+        }
+
+        public class IssueTemplateSpinnerStartGap : IssueTemplateSpinnerGap
+        {
+            public IssueTemplateSpinnerStartGap(ICheck check)
+                : base(check, IssueType.Problem, "There is only {0} ms apart between the start of the spinner and the last object, there should be {1} ms or more.")
+            {
+            }
+        }
+
+        public class IssueTemplateSpinnerEndGap : IssueTemplateSpinnerGap
+        {
+            public IssueTemplateSpinnerEndGap(ICheck check)
+                : base(check, IssueType.Problem, "There is only {0} ms apart between the end of the spinner and the next object, there should be {1} ms or more.")
+            {
+            }
+        }
+    }
+}

From 5d8f35f3c973a941a017642cf09ba3f167ab7bd2 Mon Sep 17 00:00:00 2001
From: Darius Wattimena <dariuswattimena@hotmail.com>
Date: Wed, 10 Nov 2021 00:16:29 +0100
Subject: [PATCH 0869/5547] Code cleanup and added tests for the spinner check

---
 .../Editor/Checks/TestCheckBananaShowerGap.cs | 118 ++++++++++++++++++
 .../Edit/CatchBeatmapVerifier.cs              |   2 +-
 ...tSpinnerGap.cs => CheckBananaShowerGap.cs} |  31 +++--
 3 files changed, 137 insertions(+), 14 deletions(-)
 create mode 100644 osu.Game.Rulesets.Catch.Tests/Editor/Checks/TestCheckBananaShowerGap.cs
 rename osu.Game.Rulesets.Catch/Edit/Checks/{CheckTooShortSpinnerGap.cs => CheckBananaShowerGap.cs} (71%)

diff --git a/osu.Game.Rulesets.Catch.Tests/Editor/Checks/TestCheckBananaShowerGap.cs b/osu.Game.Rulesets.Catch.Tests/Editor/Checks/TestCheckBananaShowerGap.cs
new file mode 100644
index 0000000000..055c8429d7
--- /dev/null
+++ b/osu.Game.Rulesets.Catch.Tests/Editor/Checks/TestCheckBananaShowerGap.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.Collections.Generic;
+using System.Linq;
+using NUnit.Framework;
+using osu.Game.Beatmaps;
+using osu.Game.Rulesets.Catch.Edit.Checks;
+using osu.Game.Rulesets.Catch.Objects;
+using osu.Game.Rulesets.Edit;
+using osu.Game.Rulesets.Objects;
+using osu.Game.Tests.Beatmaps;
+
+namespace osu.Game.Rulesets.Catch.Tests.Editor.Checks
+{
+    [TestFixture]
+    public class TestCheckBananaShowerGap
+    {
+        private CheckBananaShowerGap check;
+
+        [SetUp]
+        public void Setup()
+        {
+            check = new CheckBananaShowerGap();
+        }
+
+        [Test]
+        public void TestAllowedSpinnerGaps()
+        {
+            assertOk(mockBeatmap(250, 1000, 1250), DifficultyRating.Easy);
+            assertOk(mockBeatmap(250, 1000, 1250), DifficultyRating.Normal);
+            assertOk(mockBeatmap(125, 1000, 1250), DifficultyRating.Hard);
+            assertOk(mockBeatmap(125, 1000, 1125), DifficultyRating.Insane);
+            assertOk(mockBeatmap(62, 1000, 1125), DifficultyRating.Expert);
+            assertOk(mockBeatmap(62, 1000, 1125), DifficultyRating.ExpertPlus);
+        }
+
+        [Test]
+        public void TestDisallowedSpinnerGapStart()
+        {
+            assertTooShortSpinnerStart(mockBeatmap(249, 1000, 1250), DifficultyRating.Easy);
+            assertTooShortSpinnerStart(mockBeatmap(249, 1000, 1250), DifficultyRating.Normal);
+            assertTooShortSpinnerStart(mockBeatmap(124, 1000, 1250), DifficultyRating.Hard);
+            assertTooShortSpinnerStart(mockBeatmap(124, 1000, 1250), DifficultyRating.Insane);
+            assertTooShortSpinnerStart(mockBeatmap(61, 1000, 1250), DifficultyRating.Expert);
+            assertTooShortSpinnerStart(mockBeatmap(61, 1000, 1250), DifficultyRating.ExpertPlus);
+        }
+
+        [Test]
+        public void TestDisallowedSpinnerGapEnd()
+        {
+            assertTooShortSpinnerEnd(mockBeatmap(250, 1000, 1249), DifficultyRating.Easy);
+            assertTooShortSpinnerEnd(mockBeatmap(250, 1000, 1249), DifficultyRating.Normal);
+            assertTooShortSpinnerEnd(mockBeatmap(125, 1000, 1249), DifficultyRating.Hard);
+            assertTooShortSpinnerEnd(mockBeatmap(125, 1000, 1124), DifficultyRating.Insane);
+            assertTooShortSpinnerEnd(mockBeatmap(62, 1000, 1124), DifficultyRating.Expert);
+            assertTooShortSpinnerEnd(mockBeatmap(62, 1000, 1124), DifficultyRating.ExpertPlus);
+        }
+
+        [Test]
+        public void TestConsecutiveSpinners()
+        {
+            var spinnerConsecutiveBeatmap = new Beatmap<HitObject>
+            {
+                HitObjects = new List<HitObject>
+                {
+                    new BananaShower { StartTime = 0, EndTime = 100, X = 0 },
+                    new BananaShower { StartTime = 101, EndTime = 200, X = 0 },
+                    new BananaShower { StartTime = 201, EndTime = 300, X = 0 }
+                }
+            };
+
+            assertOk(spinnerConsecutiveBeatmap, DifficultyRating.Easy);
+            assertOk(spinnerConsecutiveBeatmap, DifficultyRating.Normal);
+            assertOk(spinnerConsecutiveBeatmap, DifficultyRating.Hard);
+            assertOk(spinnerConsecutiveBeatmap, DifficultyRating.Insane);
+            assertOk(spinnerConsecutiveBeatmap, DifficultyRating.Expert);
+            assertOk(spinnerConsecutiveBeatmap, DifficultyRating.ExpertPlus);
+        }
+
+        private Beatmap<HitObject> mockBeatmap(double bananaShowerStart, double bananaShowerEnd, double nextFruitStart)
+        {
+            return new Beatmap<HitObject>
+            {
+                HitObjects = new List<HitObject>
+                {
+                    new Fruit { StartTime = 0, X = 0 },
+                    new BananaShower { StartTime = bananaShowerStart, EndTime = bananaShowerEnd, X = 0 },
+                    new Fruit { StartTime = nextFruitStart, X = 0 }
+                }
+            };
+        }
+
+        private void assertOk(IBeatmap beatmap, DifficultyRating difficultyRating)
+        {
+            var context = new BeatmapVerifierContext(beatmap, new TestWorkingBeatmap(beatmap), difficultyRating);
+            Assert.That(check.Run(context), Is.Empty);
+        }
+
+        private void assertTooShortSpinnerStart(IBeatmap beatmap, DifficultyRating difficultyRating)
+        {
+            var context = new BeatmapVerifierContext(beatmap, new TestWorkingBeatmap(beatmap), difficultyRating);
+            var issues = check.Run(context).ToList();
+
+            Assert.That(issues, Has.Count.EqualTo(1));
+            Assert.That(issues.All(issue => issue.Template is CheckBananaShowerGap.IssueTemplateBananaShowerStartGap));
+        }
+
+        private void assertTooShortSpinnerEnd(IBeatmap beatmap, DifficultyRating difficultyRating)
+        {
+            var context = new BeatmapVerifierContext(beatmap, new TestWorkingBeatmap(beatmap), difficultyRating);
+            var issues = check.Run(context).ToList();
+
+            Assert.That(issues, Has.Count.EqualTo(1));
+            Assert.That(issues.All(issue => issue.Template is CheckBananaShowerGap.IssueTemplateBananaShowerEndGap));
+        }
+    }
+}
diff --git a/osu.Game.Rulesets.Catch/Edit/CatchBeatmapVerifier.cs b/osu.Game.Rulesets.Catch/Edit/CatchBeatmapVerifier.cs
index 6aa1749ff9..c7a41a4e22 100644
--- a/osu.Game.Rulesets.Catch/Edit/CatchBeatmapVerifier.cs
+++ b/osu.Game.Rulesets.Catch/Edit/CatchBeatmapVerifier.cs
@@ -13,7 +13,7 @@ namespace osu.Game.Rulesets.Catch.Edit
     {
         private readonly List<ICheck> checks = new List<ICheck>
         {
-            new CheckTooShortSpinnerGap()
+            new CheckBananaShowerGap()
         };
 
         public IEnumerable<Issue> Run(BeatmapVerifierContext context)
diff --git a/osu.Game.Rulesets.Catch/Edit/Checks/CheckTooShortSpinnerGap.cs b/osu.Game.Rulesets.Catch/Edit/Checks/CheckBananaShowerGap.cs
similarity index 71%
rename from osu.Game.Rulesets.Catch/Edit/Checks/CheckTooShortSpinnerGap.cs
rename to osu.Game.Rulesets.Catch/Edit/Checks/CheckBananaShowerGap.cs
index 7b0b5c74ce..909a3110b1 100644
--- a/osu.Game.Rulesets.Catch/Edit/Checks/CheckTooShortSpinnerGap.cs
+++ b/osu.Game.Rulesets.Catch/Edit/Checks/CheckBananaShowerGap.cs
@@ -10,7 +10,10 @@ using osu.Game.Rulesets.Objects;
 
 namespace osu.Game.Rulesets.Catch.Edit.Checks
 {
-    public class CheckTooShortSpinnerGap : ICheck
+    /// <summary>
+    /// Check the spinner/banana shower gaps specified in the osu!catch difficulty specific ranking criteria.
+    /// </summary>
+    public class CheckBananaShowerGap : ICheck
     {
         private static readonly int[] spinner_start_delta_threshold = { 250, 250, 125, 125, 62, 62 };
         private static readonly int[] spinner_end_delta_threshold = { 250, 250, 250, 125, 125, 125 };
@@ -19,8 +22,8 @@ namespace osu.Game.Rulesets.Catch.Edit.Checks
 
         public IEnumerable<IssueTemplate> PossibleTemplates => new IssueTemplate[]
         {
-            new IssueTemplateSpinnerStartGap(this),
-            new IssueTemplateSpinnerEndGap(this)
+            new IssueTemplateBananaShowerStartGap(this),
+            new IssueTemplateBananaShowerEndGap(this)
         };
 
         public IEnumerable<Issue> Run(BeatmapVerifierContext context)
@@ -35,33 +38,35 @@ namespace osu.Game.Rulesets.Catch.Edit.Checks
                 if (!(hitObjects[i] is BananaShower bananaShower))
                     continue;
 
+                // Skip if the previous hitobject is a banana shower, consecutive spinners are allowed
                 if (i != 0 && hitObjects[i - 1] is CatchHitObject previousHitObject && !(previousHitObject is BananaShower))
                 {
                     double spinnerStartDelta = bananaShower.StartTime - previousHitObject.GetEndTime();
 
                     if (spinnerStartDelta < expectedStartDelta)
                     {
-                        yield return new IssueTemplateSpinnerStartGap(this)
+                        yield return new IssueTemplateBananaShowerStartGap(this)
                             .Create(spinnerStartDelta, expectedStartDelta, bananaShower, previousHitObject);
                     }
                 }
 
+                // Skip if the next hitobject is a banana shower, consecutive spinners are allowed
                 if (hitObjects[i + 1] is CatchHitObject nextHitObject && !(nextHitObject is BananaShower))
                 {
                     double spinnerEndDelta = nextHitObject.StartTime - bananaShower.EndTime;
 
                     if (spinnerEndDelta < expectedEndDelta)
                     {
-                        yield return new IssueTemplateSpinnerEndGap(this)
+                        yield return new IssueTemplateBananaShowerEndGap(this)
                             .Create(spinnerEndDelta, expectedEndDelta, bananaShower, nextHitObject);
                     }
                 }
             }
         }
 
-        public abstract class IssueTemplateSpinnerGap : IssueTemplate
+        public abstract class IssueTemplateBananaShowerGap : IssueTemplate
         {
-            protected IssueTemplateSpinnerGap(ICheck check, IssueType issueType, string unformattedMessage)
+            protected IssueTemplateBananaShowerGap(ICheck check, IssueType issueType, string unformattedMessage)
                 : base(check, issueType, unformattedMessage)
             {
             }
@@ -72,18 +77,18 @@ namespace osu.Game.Rulesets.Catch.Edit.Checks
             }
         }
 
-        public class IssueTemplateSpinnerStartGap : IssueTemplateSpinnerGap
+        public class IssueTemplateBananaShowerStartGap : IssueTemplateBananaShowerGap
         {
-            public IssueTemplateSpinnerStartGap(ICheck check)
-                : base(check, IssueType.Problem, "There is only {0} ms apart between the start of the spinner and the last object, there should be {1} ms or more.")
+            public IssueTemplateBananaShowerStartGap(ICheck check)
+                : base(check, IssueType.Problem, "There is only {0} ms apart between the start of the spinner and the last object, it should not be less than {1} ms.")
             {
             }
         }
 
-        public class IssueTemplateSpinnerEndGap : IssueTemplateSpinnerGap
+        public class IssueTemplateBananaShowerEndGap : IssueTemplateBananaShowerGap
         {
-            public IssueTemplateSpinnerEndGap(ICheck check)
-                : base(check, IssueType.Problem, "There is only {0} ms apart between the end of the spinner and the next object, there should be {1} ms or more.")
+            public IssueTemplateBananaShowerEndGap(ICheck check)
+                : base(check, IssueType.Problem, "There is only {0} ms apart between the end of the spinner and the next object, it should not be less than {1} ms.")
             {
             }
         }

From bd5caceeb1f2d95d40339fe08af3720d20749967 Mon Sep 17 00:00:00 2001
From: Darius Wattimena <dariuswattimena@hotmail.com>
Date: Wed, 10 Nov 2021 00:23:14 +0100
Subject: [PATCH 0870/5547] Fixed typo in banana shower gap check message

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

diff --git a/osu.Game.Rulesets.Catch/Edit/Checks/CheckBananaShowerGap.cs b/osu.Game.Rulesets.Catch/Edit/Checks/CheckBananaShowerGap.cs
index 909a3110b1..d6671cb9db 100644
--- a/osu.Game.Rulesets.Catch/Edit/Checks/CheckBananaShowerGap.cs
+++ b/osu.Game.Rulesets.Catch/Edit/Checks/CheckBananaShowerGap.cs
@@ -80,7 +80,7 @@ namespace osu.Game.Rulesets.Catch.Edit.Checks
         public class IssueTemplateBananaShowerStartGap : IssueTemplateBananaShowerGap
         {
             public IssueTemplateBananaShowerStartGap(ICheck check)
-                : base(check, IssueType.Problem, "There is only {0} ms apart between the start of the spinner and the last object, it should not be less than {1} ms.")
+                : base(check, IssueType.Problem, "There is only {0} ms between the start of the spinner and the last object, it should not be less than {1} ms.")
             {
             }
         }
@@ -88,7 +88,7 @@ namespace osu.Game.Rulesets.Catch.Edit.Checks
         public class IssueTemplateBananaShowerEndGap : IssueTemplateBananaShowerGap
         {
             public IssueTemplateBananaShowerEndGap(ICheck check)
-                : base(check, IssueType.Problem, "There is only {0} ms apart between the end of the spinner and the next object, it should not be less than {1} ms.")
+                : base(check, IssueType.Problem, "There is only {0} ms between the end of the spinner and the next object, it should not be less than {1} ms.")
             {
             }
         }

From 4e092fed0f472a0755fe650b4f05ac18e3dae65e Mon Sep 17 00:00:00 2001
From: Darius Wattimena <dariuswattimena@hotmail.com>
Date: Wed, 10 Nov 2021 00:35:09 +0100
Subject: [PATCH 0871/5547] Removed accidentally added Rider legacy
 UserContentModel

---
 .idea/.idea.osu.Desktop/.idea/indexLayout.xml | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/.idea/.idea.osu.Desktop/.idea/indexLayout.xml b/.idea/.idea.osu.Desktop/.idea/indexLayout.xml
index 90e8a163b9..7b08163ceb 100644
--- a/.idea/.idea.osu.Desktop/.idea/indexLayout.xml
+++ b/.idea/.idea.osu.Desktop/.idea/indexLayout.xml
@@ -1,10 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <project version="4">
-  <component name="ContentModelUserStore">
-    <attachedFolders />
-    <explicitIncludes />
-    <explicitExcludes />
-  </component>
   <component name="UserContentModel">
     <attachedFolders />
     <explicitIncludes />

From ce0eb0b26ff5a3ab152f5e9e48f4f991293b990e Mon Sep 17 00:00:00 2001
From: Semyon Rozhkov <semro@outlook.com>
Date: Wed, 10 Nov 2021 03:53:30 +0300
Subject: [PATCH 0872/5547] Using IUpdatableByPlayfield

---
 osu.Game.Rulesets.Catch/Mods/CatchModNoScope.cs | 15 ++++++---------
 1 file changed, 6 insertions(+), 9 deletions(-)

diff --git a/osu.Game.Rulesets.Catch/Mods/CatchModNoScope.cs b/osu.Game.Rulesets.Catch/Mods/CatchModNoScope.cs
index 7b55150582..b0e374898e 100644
--- a/osu.Game.Rulesets.Catch/Mods/CatchModNoScope.cs
+++ b/osu.Game.Rulesets.Catch/Mods/CatchModNoScope.cs
@@ -13,7 +13,7 @@ using osu.Game.Utils;
 
 namespace osu.Game.Rulesets.Catch.Mods
 {
-    public class CatchModNoScope : ModNoScope, IApplicableToBeatmap, IApplicableToDrawableRuleset<CatchHitObject>
+    public class CatchModNoScope : ModNoScope, IApplicableToBeatmap, IUpdatableByPlayfield
     {
         public override string Description => "Where's the catcher?";
 
@@ -24,15 +24,12 @@ namespace osu.Game.Rulesets.Catch.Mods
             BananaShowerPeriods = new PeriodTracker(beatmap.HitObjects.OfType<BananaShower>().Select(b => new Period(b.StartTime - TRANSITION_DURATION, b.EndTime)));
         }
 
-        public void ApplyToDrawableRuleset(DrawableRuleset<CatchHitObject> drawableRuleset)
+        public virtual void Update(Playfield playfield)
         {
-            var playfield = (CatchPlayfield)drawableRuleset.Playfield;
-            playfield.OnUpdate += _ =>
-            {
-                bool shouldAlwaysShowCatcher = IsBreakTime.Value || BananaShowerPeriods.IsInAny(playfield.Clock.CurrentTime);
-                float targetAlpha = shouldAlwaysShowCatcher ? 1 : ComboBasedAlpha;
-                playfield.CatcherArea.Alpha = (float)Interpolation.Lerp(playfield.CatcherArea.Alpha, targetAlpha, Math.Clamp(playfield.Time.Elapsed / TRANSITION_DURATION, 0, 1));
-            };
+            var catchPlayfield = (CatchPlayfield)playfield;
+            bool shouldAlwaysShowCatcher = IsBreakTime.Value || BananaShowerPeriods.IsInAny(catchPlayfield.Clock.CurrentTime);
+            float targetAlpha = shouldAlwaysShowCatcher ? 1 : ComboBasedAlpha;
+            catchPlayfield.CatcherArea.Alpha = (float)Interpolation.Lerp(catchPlayfield.CatcherArea.Alpha, targetAlpha, Math.Clamp(catchPlayfield.Time.Elapsed / TRANSITION_DURATION, 0, 1));
         }
     }
 }

From 41f4f0ab5e7eb373e8abe6d25c627c651415fe21 Mon Sep 17 00:00:00 2001
From: Semyon Rozhkov <semro@outlook.com>
Date: Wed, 10 Nov 2021 03:57:22 +0300
Subject: [PATCH 0873/5547] Different setting slider description in each mod

---
 osu.Game.Rulesets.Catch/Mods/CatchModNoScope.cs | 16 ++++++++++++++++
 osu.Game.Rulesets.Osu/Mods/OsuModNoScope.cs     | 16 ++++++++++++++++
 osu.Game/Rulesets/Mods/ModNoScope.cs            | 15 +--------------
 3 files changed, 33 insertions(+), 14 deletions(-)

diff --git a/osu.Game.Rulesets.Catch/Mods/CatchModNoScope.cs b/osu.Game.Rulesets.Catch/Mods/CatchModNoScope.cs
index b0e374898e..bec53fc3bd 100644
--- a/osu.Game.Rulesets.Catch/Mods/CatchModNoScope.cs
+++ b/osu.Game.Rulesets.Catch/Mods/CatchModNoScope.cs
@@ -3,9 +3,12 @@
 
 using System;
 using System.Linq;
+using osu.Framework.Bindables;
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Mods;
 using osu.Framework.Utils;
+using osu.Game.Configuration;
+using osu.Game.Overlays.Settings;
 using osu.Game.Rulesets.Catch.Objects;
 using osu.Game.Rulesets.Catch.UI;
 using osu.Game.Rulesets.UI;
@@ -19,6 +22,19 @@ namespace osu.Game.Rulesets.Catch.Mods
 
         public PeriodTracker BananaShowerPeriods;
 
+        [SettingSource(
+            "Hidden at combo",
+            "The combo count at which the catcher becomes completely hidden",
+            SettingControlType = typeof(SettingsSlider<int, HiddenComboSlider>)
+        )]
+        public override BindableInt HiddenComboCount { get; } = new BindableInt
+        {
+            Default = 10,
+            Value = 10,
+            MinValue = 0,
+            MaxValue = 50,
+        };
+
         public void ApplyToBeatmap(IBeatmap beatmap)
         {
             BananaShowerPeriods = new PeriodTracker(beatmap.HitObjects.OfType<BananaShower>().Select(b => new Period(b.StartTime - TRANSITION_DURATION, b.EndTime)));
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModNoScope.cs b/osu.Game.Rulesets.Osu/Mods/OsuModNoScope.cs
index 3f9cd098cd..a73ddde110 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModNoScope.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModNoScope.cs
@@ -3,8 +3,11 @@
 
 using System;
 using System.Linq;
+using osu.Framework.Bindables;
 using osu.Framework.Utils;
 using osu.Game.Beatmaps;
+using osu.Game.Configuration;
+using osu.Game.Overlays.Settings;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Osu.Objects;
 using osu.Game.Rulesets.UI;
@@ -18,6 +21,19 @@ namespace osu.Game.Rulesets.Osu.Mods
 
         private PeriodTracker spinnerPeriods;
 
+        [SettingSource(
+            "Hidden at combo",
+            "The combo count at which the cursor becomes completely hidden",
+            SettingControlType = typeof(SettingsSlider<int, HiddenComboSlider>)
+        )]
+        public override BindableInt HiddenComboCount { get; } = new BindableInt
+        {
+            Default = 10,
+            Value = 10,
+            MinValue = 0,
+            MaxValue = 50,
+        };
+
         public void ApplyToBeatmap(IBeatmap beatmap)
         {
             spinnerPeriods = new PeriodTracker(beatmap.HitObjects.OfType<Spinner>().Select(b => new Period(b.StartTime - TRANSITION_DURATION, b.EndTime)));
diff --git a/osu.Game/Rulesets/Mods/ModNoScope.cs b/osu.Game/Rulesets/Mods/ModNoScope.cs
index 9e2734b775..7a935eb38f 100644
--- a/osu.Game/Rulesets/Mods/ModNoScope.cs
+++ b/osu.Game/Rulesets/Mods/ModNoScope.cs
@@ -6,9 +6,7 @@ using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Localisation;
-using osu.Game.Configuration;
 using osu.Game.Graphics.UserInterface;
-using osu.Game.Overlays.Settings;
 using osu.Game.Rulesets.Scoring;
 using osu.Game.Scoring;
 using osu.Game.Screens.Play;
@@ -36,18 +34,7 @@ namespace osu.Game.Rulesets.Mods
 
         protected float ComboBasedAlpha;
 
-        [SettingSource(
-            "Hidden at combo",
-            "The combo count at which the cursor becomes completely hidden",
-            SettingControlType = typeof(SettingsSlider<int, HiddenComboSlider>)
-        )]
-        public BindableInt HiddenComboCount { get; } = new BindableInt
-        {
-            Default = 10,
-            Value = 10,
-            MinValue = 0,
-            MaxValue = 50,
-        };
+        public abstract BindableInt HiddenComboCount { get; }
 
         public ScoreRank AdjustRank(ScoreRank rank, double accuracy) => rank;
 

From fe2f143e8ab4de3e7aad820e43fe88c1eaaae23f Mon Sep 17 00:00:00 2001
From: apollo-dw <83023433+apollo-dw@users.noreply.github.com>
Date: Wed, 10 Nov 2021 00:59:28 +0000
Subject: [PATCH 0874/5547] Nerf slider aim for plays with dropped slider ends

---
 .../Difficulty/OsuDifficultyAttributes.cs             |  1 +
 .../Difficulty/OsuDifficultyCalculator.cs             | 11 ++++++++---
 .../Difficulty/OsuPerformanceCalculator.cs            |  4 ++++
 osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs        |  8 ++++++--
 4 files changed, 19 insertions(+), 5 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyAttributes.cs b/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyAttributes.cs
index a08fe3b7c5..e0a216c8e0 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyAttributes.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyAttributes.cs
@@ -10,6 +10,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty
         public double AimStrain { get; set; }
         public double SpeedStrain { get; set; }
         public double FlashlightRating { get; set; }
+        public double SliderFactor { get; set; }
         public double ApproachRate { get; set; }
         public double OverallDifficulty { get; set; }
         public double DrainRate { get; set; }
diff --git a/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs b/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs
index b0a764dc4d..7ee5f8622c 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs
@@ -34,8 +34,11 @@ namespace osu.Game.Rulesets.Osu.Difficulty
                 return new OsuDifficultyAttributes { Mods = mods, Skills = skills };
 
             double aimRating = Math.Sqrt(skills[0].DifficultyValue()) * difficulty_multiplier;
-            double speedRating = Math.Sqrt(skills[1].DifficultyValue()) * difficulty_multiplier;
-            double flashlightRating = Math.Sqrt(skills[2].DifficultyValue()) * difficulty_multiplier;
+            double aimRatingNoSliders = Math.Sqrt(skills[1].DifficultyValue()) * difficulty_multiplier;
+            double speedRating = Math.Sqrt(skills[2].DifficultyValue()) * difficulty_multiplier;
+            double flashlightRating = Math.Sqrt(skills[3].DifficultyValue()) * difficulty_multiplier;
+
+            double sliderFactor = aimRating / aimRatingNoSliders;
 
             if (mods.Any(h => h is OsuModRelax))
                 speedRating = 0.0;
@@ -74,6 +77,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty
                 AimStrain = aimRating,
                 SpeedStrain = speedRating,
                 FlashlightRating = flashlightRating,
+                SliderFactor = sliderFactor,
                 ApproachRate = preempt > 1200 ? (1800 - preempt) / 120 : (1200 - preempt) / 150 + 5,
                 OverallDifficulty = (80 - hitWindowGreat) / 6,
                 DrainRate = drainRate,
@@ -108,7 +112,8 @@ namespace osu.Game.Rulesets.Osu.Difficulty
 
             return new Skill[]
             {
-                new Aim(mods),
+                new Aim(mods, true),
+                new Aim(mods, false),
                 new Speed(mods, hitWindowGreat),
                 new Flashlight(mods)
             };
diff --git a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
index a9d9ff6985..36ce6730ac 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
@@ -125,6 +125,10 @@ namespace osu.Game.Rulesets.Osu.Difficulty
                 aimValue *= 1.0 + 0.04 * (12.0 - Attributes.ApproachRate);
             }
 
+            // Estimate the number of sliderends dropped
+            double estimateSliderEndsDropped = Math.Min(Attributes.SliderCount, Math.Min(countOk + countMeh + countMiss, Attributes.MaxCombo - scoreMaxCombo));
+            aimValue *= 1 - (((1 - Attributes.SliderFactor) * estimateSliderEndsDropped) / Attributes.SliderCount); 
+
             aimValue *= accuracy;
             // It is important to also consider accuracy difficulty when doing that.
             aimValue *= 0.98 + Math.Pow(Attributes.OverallDifficulty, 2) / 2500;
diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
index 4c40a49396..bb85b1669c 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
@@ -14,9 +14,10 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
     /// </summary>
     public class Aim : OsuStrainSkill
     {
-        public Aim(Mod[] mods)
+        public Aim(Mod[] mods, bool withSliders)
             : base(mods)
         {
+            this.withSliders = withSliders;
         }
 
         protected override int HistoryLength => 2;
@@ -31,6 +32,8 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
         private double skillMultiplier => 23.25;
         private double strainDecayBase => 0.15;
 
+        private bool withSliders = true;
+
         private double strainValueOf(DifficultyHitObject current)
         {
             if (current.BaseObject is Spinner || Previous.Count <= 1 || Previous[0].BaseObject is Spinner)
@@ -135,7 +138,8 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
             aimStrain += Math.Max(acuteAngleBonus * acute_angle_multiplier, wideAngleBonus * wide_angle_multiplier + velocityChangeBonus * velocity_change_multiplier);
 
             // Add in additional slider velocity bonus.
-            aimStrain += sliderBonus * slider_multiplier;
+            if (withSliders)
+                aimStrain += sliderBonus * slider_multiplier;
 
             return aimStrain;
         }

From 577bdade5b6369952a65fd44d8c3ad8663da92cd Mon Sep 17 00:00:00 2001
From: Semyon Rozhkov <semro@outlook.com>
Date: Wed, 10 Nov 2021 04:10:05 +0300
Subject: [PATCH 0875/5547] Hide catcher during banana shower

---
 .../Mods/TestSceneCatchModNoScope.cs          | 46 -------------------
 .../Mods/CatchModNoScope.cs                   | 15 +-----
 2 files changed, 2 insertions(+), 59 deletions(-)

diff --git a/osu.Game.Rulesets.Catch.Tests/Mods/TestSceneCatchModNoScope.cs b/osu.Game.Rulesets.Catch.Tests/Mods/TestSceneCatchModNoScope.cs
index 5d8bbad384..13d78145b3 100644
--- a/osu.Game.Rulesets.Catch.Tests/Mods/TestSceneCatchModNoScope.cs
+++ b/osu.Game.Rulesets.Catch.Tests/Mods/TestSceneCatchModNoScope.cs
@@ -2,15 +2,12 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System.Collections.Generic;
-using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Utils;
-using osu.Framework.Testing;
 using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.Timing;
 using osu.Game.Rulesets.Catch.Mods;
 using osu.Game.Rulesets.Catch.Objects;
-using osu.Game.Rulesets.Catch.Objects.Drawables;
 using osu.Game.Rulesets.Catch.UI;
 using osu.Game.Rulesets.Objects;
 using osu.Game.Tests.Visual;
@@ -61,47 +58,6 @@ namespace osu.Game.Rulesets.Catch.Tests.Mods
             AddUntilStep("wait for catcher to hide", () => catcherAlphaAlmostEquals(0));
         }
 
-        [Test]
-        public void TestVisibleDuringBananaShower()
-        {
-            CreateModTest(new ModTestData
-            {
-                Mod = new CatchModNoScope
-                {
-                    HiddenComboCount = { Value = 0 },
-                },
-                Autoplay = true,
-                PassCondition = () => true,
-                Beatmap = new Beatmap
-                {
-                    HitObjects = new List<HitObject>
-                    {
-                        new Fruit
-                        {
-                            X = CatchPlayfield.CENTER_X,
-                            StartTime = 1000,
-                        },
-                        new BananaShower
-                        {
-                            StartTime = 2000,
-                            Duration = 2000,
-                        },
-                        new Fruit
-                        {
-                            X = CatchPlayfield.CENTER_X,
-                            StartTime = 5000,
-                        }
-                    }
-                }
-            });
-
-            AddUntilStep("wait for catcher to hide", () => catcherAlphaAlmostEquals(0));
-            AddUntilStep("wait for start of banana shower", isBananaShower);
-            AddUntilStep("wait for catcher to show", () => catcherAlphaAlmostEquals(1));
-            AddUntilStep("wait for end of banana shower", () => !isBananaShower());
-            AddUntilStep("wait for catcher to hide", () => catcherAlphaAlmostEquals(0));
-        }
-
         [Test]
         public void TestVisibleAfterComboBreak()
         {
@@ -143,8 +99,6 @@ namespace osu.Game.Rulesets.Catch.Tests.Mods
             AddUntilStep("wait for catcher to show", () => catcherAlphaAlmostEquals(1));
         }
 
-        private bool isBananaShower() => Player.ChildrenOfType<DrawableBananaShower>().SingleOrDefault() != null;
-
         private bool isBreak() => Player.IsBreakTime.Value;
 
         private bool catcherAlphaAlmostEquals(float alpha)
diff --git a/osu.Game.Rulesets.Catch/Mods/CatchModNoScope.cs b/osu.Game.Rulesets.Catch/Mods/CatchModNoScope.cs
index bec53fc3bd..97c6d46e66 100644
--- a/osu.Game.Rulesets.Catch/Mods/CatchModNoScope.cs
+++ b/osu.Game.Rulesets.Catch/Mods/CatchModNoScope.cs
@@ -2,26 +2,20 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
-using System.Linq;
 using osu.Framework.Bindables;
-using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Mods;
 using osu.Framework.Utils;
 using osu.Game.Configuration;
 using osu.Game.Overlays.Settings;
-using osu.Game.Rulesets.Catch.Objects;
 using osu.Game.Rulesets.Catch.UI;
 using osu.Game.Rulesets.UI;
-using osu.Game.Utils;
 
 namespace osu.Game.Rulesets.Catch.Mods
 {
-    public class CatchModNoScope : ModNoScope, IApplicableToBeatmap, IUpdatableByPlayfield
+    public class CatchModNoScope : ModNoScope, IUpdatableByPlayfield
     {
         public override string Description => "Where's the catcher?";
 
-        public PeriodTracker BananaShowerPeriods;
-
         [SettingSource(
             "Hidden at combo",
             "The combo count at which the catcher becomes completely hidden",
@@ -35,15 +29,10 @@ namespace osu.Game.Rulesets.Catch.Mods
             MaxValue = 50,
         };
 
-        public void ApplyToBeatmap(IBeatmap beatmap)
-        {
-            BananaShowerPeriods = new PeriodTracker(beatmap.HitObjects.OfType<BananaShower>().Select(b => new Period(b.StartTime - TRANSITION_DURATION, b.EndTime)));
-        }
-
         public virtual void Update(Playfield playfield)
         {
             var catchPlayfield = (CatchPlayfield)playfield;
-            bool shouldAlwaysShowCatcher = IsBreakTime.Value || BananaShowerPeriods.IsInAny(catchPlayfield.Clock.CurrentTime);
+            bool shouldAlwaysShowCatcher = IsBreakTime.Value;
             float targetAlpha = shouldAlwaysShowCatcher ? 1 : ComboBasedAlpha;
             catchPlayfield.CatcherArea.Alpha = (float)Interpolation.Lerp(catchPlayfield.CatcherArea.Alpha, targetAlpha, Math.Clamp(catchPlayfield.Time.Elapsed / TRANSITION_DURATION, 0, 1));
         }

From 2d2a6d8a187c2ef6d59d12e85413fb01a0e27026 Mon Sep 17 00:00:00 2001
From: apollo-dw <83023433+apollo-dw@users.noreply.github.com>
Date: Wed, 10 Nov 2021 04:00:54 +0000
Subject: [PATCH 0876/5547] Swap to a harsher formula for slider dropped nerf

---
 osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs  | 2 +-
 osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs | 2 +-
 osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs               | 4 ++--
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs b/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs
index 7ee5f8622c..6908521dff 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs
@@ -38,7 +38,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty
             double speedRating = Math.Sqrt(skills[2].DifficultyValue()) * difficulty_multiplier;
             double flashlightRating = Math.Sqrt(skills[3].DifficultyValue()) * difficulty_multiplier;
 
-            double sliderFactor = aimRating / aimRatingNoSliders;
+            double sliderFactor = aimRatingNoSliders / aimRating;
 
             if (mods.Any(h => h is OsuModRelax))
                 speedRating = 0.0;
diff --git a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
index 36ce6730ac..4a37b8027f 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
@@ -127,7 +127,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty
 
             // Estimate the number of sliderends dropped
             double estimateSliderEndsDropped = Math.Min(Attributes.SliderCount, Math.Min(countOk + countMeh + countMiss, Attributes.MaxCombo - scoreMaxCombo));
-            aimValue *= 1 - (((1 - Attributes.SliderFactor) * estimateSliderEndsDropped) / Attributes.SliderCount); 
+            aimValue *= (1 - Attributes.SliderFactor) * Math.Pow(1 - (estimateSliderEndsDropped / Attributes.SliderCount), 5.5) + Attributes.SliderFactor;
 
             aimValue *= accuracy;
             // It is important to also consider accuracy difficulty when doing that.
diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
index bb85b1669c..747b0fff8c 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
@@ -47,7 +47,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
             double currVelocity = osuCurrObj.JumpDistance / osuCurrObj.StrainTime;
 
             // But if the last object is a slider, then we extend the travel velocity through the slider into the current object.
-            if (osuLastObj.BaseObject is Slider)
+            if (osuLastObj.BaseObject is Slider && withSliders)
             {
                 double movementVelocity = osuCurrObj.MovementDistance / osuCurrObj.MovementTime; // calculate the movement velocity from slider end to current object
                 double travelVelocity = osuCurrObj.TravelDistance / osuCurrObj.TravelTime; // calculate the slider velocity from slider head to slider end.
@@ -58,7 +58,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
             // As above, do the same for the previous hitobject.
             double prevVelocity = osuLastObj.JumpDistance / osuLastObj.StrainTime;
 
-            if (osuLastLastObj.BaseObject is Slider)
+            if (osuLastLastObj.BaseObject is Slider && withSliders)
             {
                 double movementVelocity = osuLastObj.MovementDistance / osuLastObj.MovementTime;
                 double travelVelocity = osuLastObj.TravelDistance / osuLastObj.TravelTime;

From 5dc6a9ed21ac66ae681c5878dc9f66990fc9014e Mon Sep 17 00:00:00 2001
From: Naxesss <30292137+Naxesss@users.noreply.github.com>
Date: Wed, 10 Nov 2021 05:04:30 +0100
Subject: [PATCH 0877/5547] Add background stream closed test

---
 .../Checks/CheckBackgroundQualityTest.cs       | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/osu.Game.Tests/Editing/Checks/CheckBackgroundQualityTest.cs b/osu.Game.Tests/Editing/Checks/CheckBackgroundQualityTest.cs
index 2918dde2db..42c1121c74 100644
--- a/osu.Game.Tests/Editing/Checks/CheckBackgroundQualityTest.cs
+++ b/osu.Game.Tests/Editing/Checks/CheckBackgroundQualityTest.cs
@@ -111,6 +111,24 @@ namespace osu.Game.Tests.Editing.Checks
             Assert.That(issues.Single().Template is CheckBackgroundQuality.IssueTemplateTooUncompressed);
         }
 
+        [Test]
+        public void TestStreamClosed()
+        {
+            var background = new Texture(1920, 1080);
+            var stream = new Mock<MemoryStream>(new byte[1024 * 1024]);
+
+            var mock = new Mock<IWorkingBeatmap>();
+            mock.SetupGet(w => w.Beatmap).Returns(beatmap);
+            mock.SetupGet(w => w.Background).Returns(background);
+            mock.Setup(w => w.GetStream(It.IsAny<string>())).Returns(stream.Object);
+
+            var context = new BeatmapVerifierContext(beatmap, mock.Object);
+
+            Assert.That(check.Run(context), Is.Empty);
+
+            stream.Verify(x => x.Close(), Times.Once());
+        }
+
         private BeatmapVerifierContext getContext(Texture background, [CanBeNull] byte[] fileBytes = null)
         {
             return new BeatmapVerifierContext(beatmap, getMockWorkingBeatmap(background, fileBytes).Object);

From b88818579992ce0751aa51b7f2fa93bf369e49f2 Mon Sep 17 00:00:00 2001
From: Naxesss <30292137+Naxesss@users.noreply.github.com>
Date: Wed, 10 Nov 2021 05:06:11 +0100
Subject: [PATCH 0878/5547] Properly dispose of `Stream` in bg quality check

---
 .../Rulesets/Edit/Checks/CheckBackgroundQuality.cs    | 11 ++++++++---
 1 file changed, 8 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Rulesets/Edit/Checks/CheckBackgroundQuality.cs b/osu.Game/Rulesets/Edit/Checks/CheckBackgroundQuality.cs
index 8fa79e2ee8..7ce2ee802e 100644
--- a/osu.Game/Rulesets/Edit/Checks/CheckBackgroundQuality.cs
+++ b/osu.Game/Rulesets/Edit/Checks/CheckBackgroundQuality.cs
@@ -2,6 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System.Collections.Generic;
+using System.IO;
 using osu.Game.Rulesets.Edit.Checks.Components;
 
 namespace osu.Game.Rulesets.Edit.Checks
@@ -48,10 +49,14 @@ namespace osu.Game.Rulesets.Edit.Checks
                 yield return new IssueTemplateLowResolution(this).Create(texture.Width, texture.Height);
 
             string storagePath = context.Beatmap.BeatmapInfo.BeatmapSet.GetPathForFile(backgroundFile);
-            double filesizeMb = context.WorkingBeatmap.GetStream(storagePath).Length / (1024d * 1024d);
 
-            if (filesizeMb > max_filesize_mb)
-                yield return new IssueTemplateTooUncompressed(this).Create(filesizeMb);
+            using (Stream stream = context.WorkingBeatmap.GetStream(storagePath))
+            {
+                double filesizeMb = stream.Length / (1024d * 1024d);
+
+                if (filesizeMb > max_filesize_mb)
+                    yield return new IssueTemplateTooUncompressed(this).Create(filesizeMb);
+            }
         }
 
         public class IssueTemplateTooHighResolution : IssueTemplate

From 52c740b3770480eda15fc006497a565c691d2308 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 10 Nov 2021 13:44:24 +0900
Subject: [PATCH 0879/5547] Add failing test showing team display display
 failure

---
 .../Visual/Multiplayer/TestSceneTeamVersus.cs        |  4 ++++
 .../Multiplayer/Participants/TeamDisplay.cs          | 12 ++++++------
 2 files changed, 10 insertions(+), 6 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs
index ad92886bab..1efa8d6810 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs
@@ -127,9 +127,13 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             AddAssert("room type is head to head", () => client.Room?.Settings.MatchType == MatchType.HeadToHead);
 
+            AddUntilStep("team displays are not displaying teams", () => multiplayerScreenStack.ChildrenOfType<TeamDisplay>().All(d => d.DisplayedTeam == null));
+
             AddStep("change to team vs", () => client.ChangeSettings(matchType: MatchType.TeamVersus));
 
             AddAssert("room type is team vs", () => client.Room?.Settings.MatchType == MatchType.TeamVersus);
+
+            AddUntilStep("team displays are displaying teams", () => multiplayerScreenStack.ChildrenOfType<TeamDisplay>().All(d => d.DisplayedTeam != null));
         }
 
         private void createRoom(Func<Room> room)
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/TeamDisplay.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/TeamDisplay.cs
index 833fbd6605..f2d09d44e9 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/TeamDisplay.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/TeamDisplay.cs
@@ -88,7 +88,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Participants
             });
         }
 
-        private int? displayedTeam;
+        public int? DisplayedTeam { get; private set; }
 
         protected override void OnRoomUpdated()
         {
@@ -102,19 +102,19 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Participants
 
             int? newTeam = (userRoomState as TeamVersusUserState)?.TeamID;
 
-            if (newTeam == displayedTeam)
+            if (newTeam == DisplayedTeam)
                 return;
 
             // only play the sample if an already valid team changes to another valid team.
             // this avoids playing a sound for each user if the match type is changed to/from a team mode.
-            if (newTeam != null && displayedTeam != null)
+            if (newTeam != null && DisplayedTeam != null)
                 sampleTeamSwap?.Play();
 
-            displayedTeam = newTeam;
+            DisplayedTeam = newTeam;
 
-            if (displayedTeam != null)
+            if (DisplayedTeam != null)
             {
-                box.FadeColour(getColourForTeam(displayedTeam.Value), duration, Easing.OutQuint);
+                box.FadeColour(getColourForTeam(DisplayedTeam.Value), duration, Easing.OutQuint);
                 box.ScaleTo(new Vector2(box.Scale.X < 0 ? 1 : -1, 1), duration, Easing.OutQuint);
 
                 this.ScaleTo(Vector2.One, duration, Easing.OutQuint);

From 328c72c3589b2ce21bcbccf2a8b0a8b4760634bd Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 10 Nov 2021 13:38:02 +0900
Subject: [PATCH 0880/5547] Fix `TeamDisplay` not showing after changing to
 team versus

---
 .../Multiplayer/Participants/TeamDisplay.cs   | 53 +++++++++----------
 1 file changed, 26 insertions(+), 27 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/TeamDisplay.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/TeamDisplay.cs
index f2d09d44e9..1bf62241f2 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/TeamDisplay.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/TeamDisplay.cs
@@ -29,52 +29,51 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Participants
         [Resolved]
         private OsuColour colours { get; set; }
 
+        private OsuClickableContainer clickableContent;
+
         public TeamDisplay(MultiplayerRoomUser user)
         {
             this.user = user;
 
             RelativeSizeAxes = Axes.Y;
-            Width = 15;
+
+            AutoSizeAxes = Axes.X;
 
             Margin = new MarginPadding { Horizontal = 3 };
-
-            Alpha = 0;
-            Scale = new Vector2(0, 1);
         }
 
         [BackgroundDependencyLoader]
         private void load(AudioManager audio)
         {
-            box = new Container
+            InternalChild = clickableContent = new OsuClickableContainer
             {
-                RelativeSizeAxes = Axes.Both,
-                CornerRadius = 5,
-                Masking = true,
+                Width = 15,
+                Alpha = 0,
                 Scale = new Vector2(0, 1),
-                Anchor = Anchor.Centre,
-                Origin = Anchor.Centre,
-                Child = new Box
+                RelativeSizeAxes = Axes.Y,
+                Action = changeTeam,
+                Child = box = new Container
                 {
-                    Colour = Color4.White,
                     RelativeSizeAxes = Axes.Both,
+                    CornerRadius = 5,
+                    Masking = true,
+                    Scale = new Vector2(0, 1),
                     Anchor = Anchor.Centre,
                     Origin = Anchor.Centre,
+                    Child = new Box
+                    {
+                        Colour = Color4.White,
+                        RelativeSizeAxes = Axes.Both,
+                        Anchor = Anchor.Centre,
+                        Origin = Anchor.Centre,
+                    }
                 }
             };
 
             if (Client.LocalUser?.Equals(user) == true)
             {
-                InternalChild = new OsuClickableContainer
-                {
-                    RelativeSizeAxes = Axes.Both,
-                    TooltipText = "Change team",
-                    Action = changeTeam,
-                    Child = box
-                };
-            }
-            else
-            {
-                InternalChild = box;
+                clickableContent.Action = changeTeam;
+                clickableContent.TooltipText = "Change team";
             }
 
             sampleTeamSwap = audio.Samples.Get(@"Multiplayer/team-swap");
@@ -117,13 +116,13 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Participants
                 box.FadeColour(getColourForTeam(DisplayedTeam.Value), duration, Easing.OutQuint);
                 box.ScaleTo(new Vector2(box.Scale.X < 0 ? 1 : -1, 1), duration, Easing.OutQuint);
 
-                this.ScaleTo(Vector2.One, duration, Easing.OutQuint);
-                this.FadeIn(duration);
+                clickableContent.ScaleTo(Vector2.One, duration, Easing.OutQuint);
+                clickableContent.FadeIn(duration);
             }
             else
             {
-                this.ScaleTo(new Vector2(0, 1), duration, Easing.OutQuint);
-                this.FadeOut(duration);
+                clickableContent.ScaleTo(new Vector2(0, 1), duration, Easing.OutQuint);
+                clickableContent.FadeOut(duration);
             }
         }
 

From 72ee2b155641d16a428083302bff6da667d9e6c4 Mon Sep 17 00:00:00 2001
From: Naxesss <30292137+Naxesss@users.noreply.github.com>
Date: Wed, 10 Nov 2021 06:18:40 +0100
Subject: [PATCH 0881/5547] Refactor to avoid duplicate code

---
 .../Checks/CheckBackgroundQualityTest.cs      | 23 ++++++++-----------
 1 file changed, 9 insertions(+), 14 deletions(-)

diff --git a/osu.Game.Tests/Editing/Checks/CheckBackgroundQualityTest.cs b/osu.Game.Tests/Editing/Checks/CheckBackgroundQualityTest.cs
index 42c1121c74..05bfae7e63 100644
--- a/osu.Game.Tests/Editing/Checks/CheckBackgroundQualityTest.cs
+++ b/osu.Game.Tests/Editing/Checks/CheckBackgroundQualityTest.cs
@@ -54,7 +54,7 @@ namespace osu.Game.Tests.Editing.Checks
         {
             // While this is a problem, it is out of scope for this check and is caught by a different one.
             beatmap.Metadata.BackgroundFile = string.Empty;
-            var context = getContext(null, System.Array.Empty<byte>());
+            var context = getContext(null, new MemoryStream(System.Array.Empty<byte>()));
 
             Assert.That(check.Run(context), Is.Empty);
         }
@@ -103,7 +103,7 @@ namespace osu.Game.Tests.Editing.Checks
         [Test]
         public void TestTooUncompressed()
         {
-            var context = getContext(new Texture(1920, 1080), new byte[1024 * 1024 * 3]);
+            var context = getContext(new Texture(1920, 1080), new MemoryStream(new byte[1024 * 1024 * 3]));
 
             var issues = check.Run(context).ToList();
 
@@ -117,31 +117,26 @@ namespace osu.Game.Tests.Editing.Checks
             var background = new Texture(1920, 1080);
             var stream = new Mock<MemoryStream>(new byte[1024 * 1024]);
 
-            var mock = new Mock<IWorkingBeatmap>();
-            mock.SetupGet(w => w.Beatmap).Returns(beatmap);
-            mock.SetupGet(w => w.Background).Returns(background);
-            mock.Setup(w => w.GetStream(It.IsAny<string>())).Returns(stream.Object);
-
-            var context = new BeatmapVerifierContext(beatmap, mock.Object);
+            var context = getContext(background, stream.Object);
 
             Assert.That(check.Run(context), Is.Empty);
 
             stream.Verify(x => x.Close(), Times.Once());
         }
 
-        private BeatmapVerifierContext getContext(Texture background, [CanBeNull] byte[] fileBytes = null)
+        private BeatmapVerifierContext getContext(Texture background, [CanBeNull] Stream stream = null)
         {
-            return new BeatmapVerifierContext(beatmap, getMockWorkingBeatmap(background, fileBytes).Object);
+            return new BeatmapVerifierContext(beatmap, getMockWorkingBeatmap(background, stream).Object);
         }
 
         /// <summary>
-        /// Returns the mock of the working beatmap with the given background and filesize.
+        /// Returns the mock of the working beatmap with the given background and its file stream.
         /// </summary>
         /// <param name="background">The texture of the background.</param>
-        /// <param name="fileBytes">The bytes that represent the background file.</param>
-        private Mock<IWorkingBeatmap> getMockWorkingBeatmap(Texture background, [CanBeNull] byte[] fileBytes = null)
+        /// <param name="stream">The stream representing the background file.</param>
+        private Mock<IWorkingBeatmap> getMockWorkingBeatmap(Texture background, [CanBeNull] Stream stream = null)
         {
-            var stream = new MemoryStream(fileBytes ?? new byte[1024 * 1024]);
+            stream ??= new MemoryStream(new byte[1024 * 1024]);
 
             var mock = new Mock<IWorkingBeatmap>();
             mock.SetupGet(w => w.Beatmap).Returns(beatmap);

From 6dc13ef396e8dce1198200cc2b61fd195977a340 Mon Sep 17 00:00:00 2001
From: Jamie Taylor <me@nekodex.net>
Date: Wed, 10 Nov 2021 17:07:06 +0900
Subject: [PATCH 0882/5547] Use default hover sample instead of song-ping
 (they're the same sample anyway)

---
 osu.Game/Screens/Select/Carousel/CarouselHeader.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Select/Carousel/CarouselHeader.cs b/osu.Game/Screens/Select/Carousel/CarouselHeader.cs
index 40ca3e0764..ed3aea3445 100644
--- a/osu.Game/Screens/Select/Carousel/CarouselHeader.cs
+++ b/osu.Game/Screens/Select/Carousel/CarouselHeader.cs
@@ -113,7 +113,7 @@ namespace osu.Game.Screens.Select.Carousel
                     RelativeSizeAxes = Axes.Both,
                 };
 
-                sampleHover = audio.Samples.Get("SongSelect/song-ping");
+                sampleHover = audio.Samples.Get("UI/default-hover");
             }
 
             public bool InsetForBorder

From 8d0f5b0d8201c0a382816ffcd52d2f97eec29e93 Mon Sep 17 00:00:00 2001
From: Jamie Taylor <me@nekodex.net>
Date: Wed, 10 Nov 2021 17:08:51 +0900
Subject: [PATCH 0883/5547] Add high-pass filter when song selection is
 confirmed

---
 osu.Game/Screens/Play/PlayerLoader.cs | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Play/PlayerLoader.cs b/osu.Game/Screens/Play/PlayerLoader.cs
index d852ac2940..4e5ccde579 100644
--- a/osu.Game/Screens/Play/PlayerLoader.cs
+++ b/osu.Game/Screens/Play/PlayerLoader.cs
@@ -5,6 +5,7 @@ using System;
 using System.Diagnostics;
 using System.Threading.Tasks;
 using JetBrains.Annotations;
+using ManagedBass.Fx;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
 using osu.Framework.Bindables;
@@ -67,6 +68,7 @@ namespace osu.Game.Screens.Play
         private readonly BindableDouble volumeAdjustment = new BindableDouble(1);
 
         private AudioFilter lowPassFilter;
+        private AudioFilter highPassFilter;
 
         protected bool BackgroundBrightnessReduction
         {
@@ -168,7 +170,8 @@ namespace osu.Game.Screens.Play
                     },
                     idleTracker = new IdleTracker(750),
                 }),
-                lowPassFilter = new AudioFilter(audio.TrackMixer)
+                lowPassFilter = new AudioFilter(audio.TrackMixer),
+                highPassFilter = new AudioFilter(audio.TrackMixer, BQFType.HighPass)
             };
 
             if (Beatmap.Value.BeatmapInfo.EpilepsyWarning)
@@ -239,6 +242,7 @@ namespace osu.Game.Screens.Play
             Beatmap.Value.Track.Stop();
             Beatmap.Value.Track.RemoveAdjustment(AdjustableProperty.Volume, volumeAdjustment);
             lowPassFilter.CutoffTo(AudioFilter.MAX_LOWPASS_CUTOFF);
+            highPassFilter.CutoffTo(0);
         }
 
         public override bool OnExiting(IScreen next)
@@ -352,6 +356,7 @@ namespace osu.Game.Screens.Play
             content.FadeInFromZero(400);
             content.ScaleTo(1, 650, Easing.OutQuint).Then().Schedule(prepareNewPlayer);
             lowPassFilter.CutoffTo(1000, 650, Easing.OutQuint);
+            highPassFilter.CutoffTo(300);
 
             ApplyToBackground(b => b?.FadeColour(Color4.White, 800, Easing.OutQuint));
         }
@@ -364,6 +369,7 @@ namespace osu.Game.Screens.Play
             content.ScaleTo(0.7f, content_out_duration * 2, Easing.OutQuint);
             content.FadeOut(content_out_duration, Easing.OutQuint);
             lowPassFilter.CutoffTo(AudioFilter.MAX_LOWPASS_CUTOFF, content_out_duration);
+            highPassFilter.CutoffTo(0, content_out_duration);
         }
 
         private void pushWhenLoaded()

From 5f462b6441c25cc30069ca1f13a02d2aa42de936 Mon Sep 17 00:00:00 2001
From: Jamie Taylor <me@nekodex.net>
Date: Wed, 10 Nov 2021 17:12:49 +0900
Subject: [PATCH 0884/5547] Move beatmap/difficulty change sample playback to
 outside of debounce

---
 osu.Game/Screens/Select/SongSelect.cs | 25 ++++++++++++++-----------
 1 file changed, 14 insertions(+), 11 deletions(-)

diff --git a/osu.Game/Screens/Select/SongSelect.cs b/osu.Game/Screens/Select/SongSelect.cs
index a2dea355ac..4943aac77c 100644
--- a/osu.Game/Screens/Select/SongSelect.cs
+++ b/osu.Game/Screens/Select/SongSelect.cs
@@ -435,6 +435,7 @@ namespace osu.Game.Screens.Select
         }
 
         // We need to keep track of the last selected beatmap ignoring debounce to play the correct selection sounds.
+        private BeatmapInfo beatmapInfoPrevious;
         private BeatmapInfo beatmapInfoNoDebounce;
         private RulesetInfo rulesetNoDebounce;
 
@@ -477,6 +478,19 @@ namespace osu.Game.Screens.Select
             else
                 selectionChangedDebounce = Scheduler.AddDelayed(run, 200);
 
+            if (beatmap != beatmapInfoPrevious)
+            {
+                if (beatmap != null && beatmapInfoPrevious != null)
+                {
+                    if (beatmap.BeatmapSetInfoID == beatmapInfoPrevious.BeatmapSetInfoID)
+                        sampleChangeDifficulty.Play();
+                    else
+                        sampleChangeBeatmap.Play();
+                }
+
+                beatmapInfoPrevious = beatmap;
+            }
+
             void run()
             {
                 // clear pending task immediately to track any potential nested debounce operation.
@@ -508,18 +522,7 @@ namespace osu.Game.Screens.Select
                 if (!EqualityComparer<BeatmapInfo>.Default.Equals(beatmap, Beatmap.Value.BeatmapInfo))
                 {
                     Logger.Log($"beatmap changed from \"{Beatmap.Value.BeatmapInfo}\" to \"{beatmap}\"");
-
-                    int? lastSetID = Beatmap.Value?.BeatmapInfo.BeatmapSetInfoID;
-
                     Beatmap.Value = beatmaps.GetWorkingBeatmap(beatmap);
-
-                    if (beatmap != null)
-                    {
-                        if (beatmap.BeatmapSetInfoID == lastSetID)
-                            sampleChangeDifficulty.Play();
-                        else
-                            sampleChangeBeatmap.Play();
-                    }
                 }
 
                 if (this.IsCurrentScreen())

From b13d020a499dee4f34becb6dc4e2be9a0fc37a05 Mon Sep 17 00:00:00 2001
From: Jamie Taylor <me@nekodex.net>
Date: Wed, 10 Nov 2021 17:13:47 +0900
Subject: [PATCH 0885/5547] Don't re-use confim-selection sample for the skip
 intro button

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

diff --git a/osu.Game/Screens/Play/SkipOverlay.cs b/osu.Game/Screens/Play/SkipOverlay.cs
index b04fcba0c6..c35548c6b4 100644
--- a/osu.Game/Screens/Play/SkipOverlay.cs
+++ b/osu.Game/Screens/Play/SkipOverlay.cs
@@ -270,7 +270,7 @@ namespace osu.Game.Screens.Play
                 colourNormal = colours.Yellow;
                 colourHover = colours.YellowDark;
 
-                sampleConfirm = audio.Samples.Get(@"SongSelect/confirm-selection");
+                sampleConfirm = audio.Samples.Get(@"UI/submit-select");
 
                 Children = new Drawable[]
                 {

From 71f3a64165f81d50b00cf4cb2b6a82ca8be6dba6 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 10 Nov 2021 18:25:14 +0900
Subject: [PATCH 0886/5547] Fix APIPlaylistItem serialisation

---
 osu.Game/Online/Rooms/APIPlaylistItem.cs | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/osu.Game/Online/Rooms/APIPlaylistItem.cs b/osu.Game/Online/Rooms/APIPlaylistItem.cs
index a9156f35ce..e9803a3a10 100644
--- a/osu.Game/Online/Rooms/APIPlaylistItem.cs
+++ b/osu.Game/Online/Rooms/APIPlaylistItem.cs
@@ -3,6 +3,7 @@
 
 #nullable enable
 
+using System;
 using System.Collections.Generic;
 using System.Linq;
 using MessagePack;
@@ -10,6 +11,8 @@ using osu.Game.Online.API;
 
 namespace osu.Game.Online.Rooms
 {
+    [Serializable]
+    [MessagePackObject]
     public class APIPlaylistItem
     {
         [Key(0)]

From f4ef8419729f4c80ccd8b1a666c180b2267a73f0 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 10 Nov 2021 18:27:23 +0900
Subject: [PATCH 0887/5547] Add fallback for cases where beatmap has no
 author/title/artist specified

---
 osu.Game.Tests/Models/DisplayStringTest.cs    | 22 +++++++++++++++++++
 .../Beatmaps/BeatmapMetadataInfoExtensions.cs |  8 +++++--
 2 files changed, 28 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Models/DisplayStringTest.cs b/osu.Game.Tests/Models/DisplayStringTest.cs
index 9a3c32bfb2..754a849ac8 100644
--- a/osu.Game.Tests/Models/DisplayStringTest.cs
+++ b/osu.Game.Tests/Models/DisplayStringTest.cs
@@ -17,6 +17,8 @@ namespace osu.Game.Tests.Models
     {
         private static readonly object[][] test_cases =
         {
+            new object[] { makeNoMetadataMockBeatmapSet(), "unknown artist - unknown title" },
+            new object[] { makeNoAuthorMockBeatmapSet(), "artist - title" },
             new object[] { makeMockBeatmapSet(), "artist - title (author)" },
             new object[] { makeMockBeatmap(), "artist - title (author) [difficulty]" },
             new object[] { makeMockMetadata(), "artist - title (author)" },
@@ -29,6 +31,26 @@ namespace osu.Game.Tests.Models
         [TestCaseSource(nameof(test_cases))]
         public void TestDisplayString(object model, string expected) => Assert.That(model.GetDisplayString(), Is.EqualTo(expected));
 
+        private static IBeatmapSetInfo makeNoAuthorMockBeatmapSet()
+        {
+            var mock = new Mock<IBeatmapSetInfo>();
+
+            mock.Setup(m => m.Metadata.Artist).Returns("artist");
+            mock.Setup(m => m.Metadata.Title).Returns("title");
+            mock.Setup(m => m.Metadata.Author.Username).Returns(string.Empty);
+
+            return mock.Object;
+        }
+
+        private static IBeatmapSetInfo makeNoMetadataMockBeatmapSet()
+        {
+            var mock = new Mock<IBeatmapSetInfo>();
+
+            mock.Setup(m => m.Metadata).Returns(new BeatmapMetadata());
+
+            return mock.Object;
+        }
+
         private static IBeatmapSetInfo makeMockBeatmapSet()
         {
             var mock = new Mock<IBeatmapSetInfo>();
diff --git a/osu.Game/Beatmaps/BeatmapMetadataInfoExtensions.cs b/osu.Game/Beatmaps/BeatmapMetadataInfoExtensions.cs
index 32fb389e9a..7aab6a7a9b 100644
--- a/osu.Game/Beatmaps/BeatmapMetadataInfoExtensions.cs
+++ b/osu.Game/Beatmaps/BeatmapMetadataInfoExtensions.cs
@@ -27,8 +27,12 @@ namespace osu.Game.Beatmaps
         /// </summary>
         public static string GetDisplayTitle(this IBeatmapMetadataInfo metadataInfo)
         {
-            string author = string.IsNullOrEmpty(metadataInfo.Author.Username) ? string.Empty : $"({metadataInfo.Author.Username})";
-            return $"{metadataInfo.Artist} - {metadataInfo.Title} {author}".Trim();
+            string author = string.IsNullOrEmpty(metadataInfo.Author.Username) ? string.Empty : $" ({metadataInfo.Author.Username})";
+
+            string artist = string.IsNullOrEmpty(metadataInfo.Artist) ? "unknown artist" : metadataInfo.Artist;
+            string title = string.IsNullOrEmpty(metadataInfo.Title) ? "unknown title" : metadataInfo.Title;
+
+            return $"{artist} - {title}{author}".Trim();
         }
 
         /// <summary>

From c7381b4df0045817bed83abbbffd65c397055041 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 10 Nov 2021 18:36:21 +0900
Subject: [PATCH 0888/5547] Fix host check

Although the underlying issue is that the host user is not populated.
Not sure whether this should be fixed at all.
---
 .../Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
index 4fcf60c0e8..aa936109c6 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
@@ -387,7 +387,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
             {
                 case QueueModes.HostOnly:
                     AddOrEditPlaylistButton.Text = "Edit beatmap";
-                    AddOrEditPlaylistButton.Alpha = client.Room.Host?.User?.Equals(client.LocalUser?.User) == true ? 1 : 0;
+                    AddOrEditPlaylistButton.Alpha = client.IsHost ? 1 : 0;
                     break;
 
                 case QueueModes.FreeForAll:

From 02efe24e39d7d940dea388aa439878b7776b8199 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 10 Nov 2021 18:36:55 +0900
Subject: [PATCH 0889/5547] Fix checksum not passed to AddPlaylistItem

---
 .../Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs
index df1e0c1fc2..40b086873d 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs
@@ -59,6 +59,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
                 client.AddPlaylistItem(new APIPlaylistItem
                 {
                     BeatmapID = item.BeatmapID,
+                    BeatmapChecksum = item.Beatmap.Value.MD5Hash,
                     RulesetID = item.RulesetID,
                     RequiredMods = item.RequiredMods.Select(m => new APIMod(m)).ToArray(),
                     AllowedMods = item.AllowedMods.Select(m => new APIMod(m)).ToArray()

From aad4b8ff809ff49f136dbf006f629d69dd0d860c Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 10 Nov 2021 18:42:46 +0900
Subject: [PATCH 0890/5547] Fix ready button remaining enabled for expired
 items

---
 .../OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs   | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
index b854b6d964..ce988e377f 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
@@ -106,7 +106,10 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
                     break;
             }
 
-            bool enableButton = Room?.State == MultiplayerRoomState.Open && !operationInProgress.Value;
+            bool enableButton =
+                Room?.State == MultiplayerRoomState.Open
+                && Client.CurrentMatchPlayingItem.Value?.Expired == false
+                && !operationInProgress.Value;
 
             // When the local user is the host and spectating the match, the "start match" state should be enabled if any users are ready.
             if (localUser?.State == MultiplayerUserState.Spectating)

From a52d9363f9a3a7dc8fe6e9b6d9e83a97f20985e3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 10 Nov 2021 11:09:09 +0100
Subject: [PATCH 0891/5547] Rewrite tests to be easier to follow

---
 osu.Game.Tests/Models/DisplayStringTest.cs | 83 ++++++++++++----------
 1 file changed, 45 insertions(+), 38 deletions(-)

diff --git a/osu.Game.Tests/Models/DisplayStringTest.cs b/osu.Game.Tests/Models/DisplayStringTest.cs
index 754a849ac8..cac5dd1aaa 100644
--- a/osu.Game.Tests/Models/DisplayStringTest.cs
+++ b/osu.Game.Tests/Models/DisplayStringTest.cs
@@ -15,23 +15,20 @@ namespace osu.Game.Tests.Models
     [TestFixture]
     public class DisplayStringTest
     {
-        private static readonly object[][] test_cases =
+        [Test]
+        public void TestBeatmapSet()
         {
-            new object[] { makeNoMetadataMockBeatmapSet(), "unknown artist - unknown title" },
-            new object[] { makeNoAuthorMockBeatmapSet(), "artist - title" },
-            new object[] { makeMockBeatmapSet(), "artist - title (author)" },
-            new object[] { makeMockBeatmap(), "artist - title (author) [difficulty]" },
-            new object[] { makeMockMetadata(), "artist - title (author)" },
-            new object[] { makeMockScore(), "user playing artist - title (author) [difficulty]" },
-            new object[] { makeMockRuleset(), "ruleset" },
-            new object[] { makeMockUser(), "user" },
-            new object[] { new Fallback(), "fallback" }
-        };
+            var mock = new Mock<IBeatmapSetInfo>();
 
-        [TestCaseSource(nameof(test_cases))]
-        public void TestDisplayString(object model, string expected) => Assert.That(model.GetDisplayString(), Is.EqualTo(expected));
+            mock.Setup(m => m.Metadata.Artist).Returns("artist");
+            mock.Setup(m => m.Metadata.Title).Returns("title");
+            mock.Setup(m => m.Metadata.Author.Username).Returns("author");
 
-        private static IBeatmapSetInfo makeNoAuthorMockBeatmapSet()
+            Assert.That(mock.Object.GetDisplayString(), Is.EqualTo("artist - title (author)"));
+        }
+
+        [Test]
+        public void TestBeatmapSetWithNoAuthor()
         {
             var mock = new Mock<IBeatmapSetInfo>();
 
@@ -39,38 +36,34 @@ namespace osu.Game.Tests.Models
             mock.Setup(m => m.Metadata.Title).Returns("title");
             mock.Setup(m => m.Metadata.Author.Username).Returns(string.Empty);
 
-            return mock.Object;
+            Assert.That(mock.Object.GetDisplayString(), Is.EqualTo("artist - title"));
         }
 
-        private static IBeatmapSetInfo makeNoMetadataMockBeatmapSet()
+        [Test]
+        public void TestBeatmapSetWithNoMetadata()
         {
             var mock = new Mock<IBeatmapSetInfo>();
 
             mock.Setup(m => m.Metadata).Returns(new BeatmapMetadata());
 
-            return mock.Object;
+            Assert.That(mock.Object.GetDisplayString(), Is.EqualTo("unknown artist - unknown title"));
         }
 
-        private static IBeatmapSetInfo makeMockBeatmapSet()
-        {
-            var mock = new Mock<IBeatmapSetInfo>();
-
-            mock.Setup(m => m.Metadata).Returns(makeMockMetadata);
-
-            return mock.Object;
-        }
-
-        private static IBeatmapInfo makeMockBeatmap()
+        [Test]
+        public void TestBeatmap()
         {
             var mock = new Mock<IBeatmapInfo>();
 
-            mock.Setup(m => m.Metadata).Returns(makeMockMetadata);
+            mock.Setup(m => m.Metadata.Artist).Returns("artist");
+            mock.Setup(m => m.Metadata.Title).Returns("title");
+            mock.Setup(m => m.Metadata.Author.Username).Returns("author");
             mock.Setup(m => m.DifficultyName).Returns("difficulty");
 
-            return mock.Object;
+            Assert.That(mock.Object.GetDisplayString(), Is.EqualTo("artist - title (author) [difficulty]"));
         }
 
-        private static IBeatmapMetadataInfo makeMockMetadata()
+        [Test]
+        public void TestMetadata()
         {
             var mock = new Mock<IBeatmapMetadataInfo>();
 
@@ -78,35 +71,49 @@ namespace osu.Game.Tests.Models
             mock.Setup(m => m.Title).Returns("title");
             mock.Setup(m => m.Author.Username).Returns("author");
 
-            return mock.Object;
+            Assert.That(mock.Object.GetDisplayString(), Is.EqualTo("artist - title (author)"));
         }
 
-        private static IScoreInfo makeMockScore()
+        [Test]
+        public void TestScore()
         {
             var mock = new Mock<IScoreInfo>();
 
             mock.Setup(m => m.User).Returns(new APIUser { Username = "user" }); // TODO: temporary.
-            mock.Setup(m => m.Beatmap).Returns(makeMockBeatmap);
+            mock.Setup(m => m.Beatmap.Metadata.Artist).Returns("artist");
+            mock.Setup(m => m.Beatmap.Metadata.Title).Returns("title");
+            mock.Setup(m => m.Beatmap.Metadata.Author.Username).Returns("author");
+            mock.Setup(m => m.Beatmap.DifficultyName).Returns("difficulty");
 
-            return mock.Object;
+            Assert.That(mock.Object.GetDisplayString(), Is.EqualTo("user playing artist - title (author) [difficulty]"));
         }
 
-        private static IRulesetInfo makeMockRuleset()
+        [Test]
+        public void TestRuleset()
         {
             var mock = new Mock<IRulesetInfo>();
 
             mock.Setup(m => m.Name).Returns("ruleset");
 
-            return mock.Object;
+            Assert.That(mock.Object.GetDisplayString(), Is.EqualTo("ruleset"));
         }
 
-        private static IUser makeMockUser()
+        [Test]
+        public void TestUser()
         {
             var mock = new Mock<IUser>();
 
             mock.Setup(m => m.Username).Returns("user");
 
-            return mock.Object;
+            Assert.That(mock.Object.GetDisplayString(), Is.EqualTo("user"));
+        }
+
+        [Test]
+        public void TestFallback()
+        {
+            var fallback = new Fallback();
+
+            Assert.That(fallback.GetDisplayString(), Is.EqualTo("fallback"));
         }
 
         private class Fallback

From 78793d8624e6045903ace6a71785d16bf3d8f667 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 10 Nov 2021 19:58:25 +0900
Subject: [PATCH 0892/5547] Update interface to remove items

---
 osu.Game/Online/Multiplayer/IMultiplayerClient.cs          | 4 ++--
 osu.Game/Online/Multiplayer/IMultiplayerRoomServer.cs      | 4 ++--
 osu.Game/Online/Multiplayer/MultiplayerClient.cs           | 6 +++---
 osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs     | 6 +++---
 osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs | 4 ++--
 5 files changed, 12 insertions(+), 12 deletions(-)

diff --git a/osu.Game/Online/Multiplayer/IMultiplayerClient.cs b/osu.Game/Online/Multiplayer/IMultiplayerClient.cs
index 81979c146c..4cadc5d606 100644
--- a/osu.Game/Online/Multiplayer/IMultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/IMultiplayerClient.cs
@@ -116,8 +116,8 @@ namespace osu.Game.Online.Multiplayer
         /// <summary>
         /// Signals that an item has been removed from the playlist.
         /// </summary>
-        /// <param name="item">The removed item.</param>
-        Task PlaylistItemRemoved(APIPlaylistItem item);
+        /// <param name="playlistItemId">The removed item.</param>
+        Task PlaylistItemRemoved(long playlistItemId);
 
         /// <summary>
         /// Signals that an item has been changed in the playlist.
diff --git a/osu.Game/Online/Multiplayer/IMultiplayerRoomServer.cs b/osu.Game/Online/Multiplayer/IMultiplayerRoomServer.cs
index 1f2e45b482..d6ff4f4993 100644
--- a/osu.Game/Online/Multiplayer/IMultiplayerRoomServer.cs
+++ b/osu.Game/Online/Multiplayer/IMultiplayerRoomServer.cs
@@ -86,7 +86,7 @@ namespace osu.Game.Online.Multiplayer
         /// <summary>
         /// Removes an item from the playlist.
         /// </summary>
-        /// <param name="item">The item to remove.</param>
-        Task RemovePlaylistItem(APIPlaylistItem item);
+        /// <param name="playlistItemId">The item to remove.</param>
+        Task RemovePlaylistItem(long playlistItemId);
     }
 }
diff --git a/osu.Game/Online/Multiplayer/MultiplayerClient.cs b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
index ed45662fec..ede42a8d1e 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
@@ -307,7 +307,7 @@ namespace osu.Game.Online.Multiplayer
 
         public abstract Task AddPlaylistItem(APIPlaylistItem item);
 
-        public abstract Task RemovePlaylistItem(APIPlaylistItem item);
+        public abstract Task RemovePlaylistItem(long playlistItemId);
 
         Task IMultiplayerClient.RoomStateChanged(MultiplayerRoomState state)
         {
@@ -613,7 +613,7 @@ namespace osu.Game.Online.Multiplayer
             }).ConfigureAwait(false);
         }
 
-        public Task PlaylistItemRemoved(APIPlaylistItem item)
+        public Task PlaylistItemRemoved(long playlistItemId)
         {
             if (Room == null)
                 return Task.CompletedTask;
@@ -625,7 +625,7 @@ namespace osu.Game.Online.Multiplayer
 
                 Debug.Assert(APIRoom != null);
 
-                APIRoom.Playlist.RemoveAll(i => i.ID == item.ID);
+                APIRoom.Playlist.RemoveAll(i => i.ID == playlistItemId);
                 RoomUpdated?.Invoke();
             });
         }
diff --git a/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs b/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs
index 94225b6de9..2f0e1623e7 100644
--- a/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs
@@ -63,7 +63,7 @@ namespace osu.Game.Online.Multiplayer
                     connection.On<int, MatchUserState>(nameof(IMultiplayerClient.MatchUserStateChanged), ((IMultiplayerClient)this).MatchUserStateChanged);
                     connection.On<MatchServerEvent>(nameof(IMultiplayerClient.MatchEvent), ((IMultiplayerClient)this).MatchEvent);
                     connection.On<APIPlaylistItem>(nameof(IMultiplayerClient.PlaylistItemAdded), ((IMultiplayerClient)this).PlaylistItemAdded);
-                    connection.On<APIPlaylistItem>(nameof(IMultiplayerClient.PlaylistItemRemoved), ((IMultiplayerClient)this).PlaylistItemRemoved);
+                    connection.On<long>(nameof(IMultiplayerClient.PlaylistItemRemoved), ((IMultiplayerClient)this).PlaylistItemRemoved);
                     connection.On<APIPlaylistItem>(nameof(IMultiplayerClient.PlaylistItemChanged), ((IMultiplayerClient)this).PlaylistItemChanged);
                 };
 
@@ -159,12 +159,12 @@ namespace osu.Game.Online.Multiplayer
             return connection.InvokeAsync(nameof(IMultiplayerServer.AddPlaylistItem), item);
         }
 
-        public override Task RemovePlaylistItem(APIPlaylistItem item)
+        public override Task RemovePlaylistItem(long playlistItemId)
         {
             if (!IsConnected.Value)
                 return Task.CompletedTask;
 
-            return connection.InvokeAsync(nameof(IMultiplayerServer.RemovePlaylistItem), item);
+            return connection.InvokeAsync(nameof(IMultiplayerServer.RemovePlaylistItem), playlistItemId);
         }
 
         protected override Task<APIBeatmapSet> GetOnlineBeatmapSet(int beatmapId, CancellationToken cancellationToken = default)
diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
index d35e12b6a2..ba004f83f8 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
@@ -299,14 +299,14 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 await addPlaylistItem(item).ConfigureAwait(false);
         }
 
-        public override Task RemovePlaylistItem(APIPlaylistItem item)
+        public override Task RemovePlaylistItem(long playlistItemId)
         {
             Debug.Assert(Room != null);
 
             if (Room.Host?.UserID != LocalUser?.UserID)
                 throw new InvalidOperationException("Local user is not the room host.");
 
-            return ((IMultiplayerClient)this).PlaylistItemRemoved(item);
+            return ((IMultiplayerClient)this).PlaylistItemRemoved(playlistItemId);
         }
 
         protected override Task<APIBeatmapSet> GetOnlineBeatmapSet(int beatmapId, CancellationToken cancellationToken = default)

From 6d04823b05e67470b6b62ee6b2eb63997c1c8334 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 10 Nov 2021 12:00:36 +0100
Subject: [PATCH 0893/5547] Remove unnecessary `virtual` specs

---
 osu.Game.Rulesets.Catch/Mods/CatchModNoScope.cs | 2 +-
 osu.Game.Rulesets.Osu/Mods/OsuModNoScope.cs     | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Rulesets.Catch/Mods/CatchModNoScope.cs b/osu.Game.Rulesets.Catch/Mods/CatchModNoScope.cs
index 97c6d46e66..a24a6227fe 100644
--- a/osu.Game.Rulesets.Catch/Mods/CatchModNoScope.cs
+++ b/osu.Game.Rulesets.Catch/Mods/CatchModNoScope.cs
@@ -29,7 +29,7 @@ namespace osu.Game.Rulesets.Catch.Mods
             MaxValue = 50,
         };
 
-        public virtual void Update(Playfield playfield)
+        public void Update(Playfield playfield)
         {
             var catchPlayfield = (CatchPlayfield)playfield;
             bool shouldAlwaysShowCatcher = IsBreakTime.Value;
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModNoScope.cs b/osu.Game.Rulesets.Osu/Mods/OsuModNoScope.cs
index a73ddde110..8e377ea632 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModNoScope.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModNoScope.cs
@@ -39,7 +39,7 @@ namespace osu.Game.Rulesets.Osu.Mods
             spinnerPeriods = new PeriodTracker(beatmap.HitObjects.OfType<Spinner>().Select(b => new Period(b.StartTime - TRANSITION_DURATION, b.EndTime)));
         }
 
-        public virtual void Update(Playfield playfield)
+        public void Update(Playfield playfield)
         {
             bool shouldAlwaysShowCursor = IsBreakTime.Value || spinnerPeriods.IsInAny(playfield.Clock.CurrentTime);
             float targetAlpha = shouldAlwaysShowCursor ? 1 : ComboBasedAlpha;

From 5e3ac5ac9f4a004bca348a1f23b17f0fc6e132ed Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 10 Nov 2021 12:05:14 +0100
Subject: [PATCH 0894/5547] Reset combo in test in a less weird way

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

diff --git a/osu.Game.Rulesets.Catch.Tests/Mods/TestSceneCatchModNoScope.cs b/osu.Game.Rulesets.Catch.Tests/Mods/TestSceneCatchModNoScope.cs
index 13d78145b3..bbe543e73e 100644
--- a/osu.Game.Rulesets.Catch.Tests/Mods/TestSceneCatchModNoScope.cs
+++ b/osu.Game.Rulesets.Catch.Tests/Mods/TestSceneCatchModNoScope.cs
@@ -95,7 +95,7 @@ namespace osu.Game.Rulesets.Catch.Tests.Mods
             AddAssert("catcher must start visible", () => catcherAlphaAlmostEquals(1));
             AddUntilStep("wait for combo", () => Player.ScoreProcessor.Combo.Value >= 2);
             AddAssert("catcher must dim after combo", () => !catcherAlphaAlmostEquals(1));
-            AddStep("break combo", () => Player.ScoreProcessor.Combo.Set(0));
+            AddStep("break combo", () => Player.ScoreProcessor.Combo.Value = 0);
             AddUntilStep("wait for catcher to show", () => catcherAlphaAlmostEquals(1));
         }
 

From 5e31e890ae8779a880f214c66aa64defacdae8a2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 10 Nov 2021 12:36:23 +0100
Subject: [PATCH 0895/5547] Extract class for clipboard contents for DI
 purposes

---
 .../Editor/TestSceneManiaComposeScreen.cs         |  5 ++---
 .../Visual/Editing/TestSceneComposeScreen.cs      |  5 ++---
 osu.Game/Screens/Edit/Compose/ComposeScreen.cs    |  7 ++++++-
 osu.Game/Screens/Edit/Editor.cs                   |  8 ++++----
 osu.Game/Screens/Edit/EditorClipboard.cs          | 15 +++++++++++++++
 5 files changed, 29 insertions(+), 11 deletions(-)
 create mode 100644 osu.Game/Screens/Edit/EditorClipboard.cs

diff --git a/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneManiaComposeScreen.cs b/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneManiaComposeScreen.cs
index 60a5051fb5..24d2a786a0 100644
--- a/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneManiaComposeScreen.cs
+++ b/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneManiaComposeScreen.cs
@@ -5,7 +5,6 @@ using System;
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
-using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Testing;
@@ -23,8 +22,8 @@ namespace osu.Game.Rulesets.Mania.Tests.Editor
         [Resolved]
         private SkinManager skins { get; set; }
 
-        [Cached(Name = nameof(Screens.Edit.Editor.Clipboard))]
-        private Bindable<string> clipboard = new Bindable<string>();
+        [Cached]
+        private EditorClipboard clipboard = new EditorClipboard();
 
         [SetUpSteps]
         public void SetUpSteps()
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneComposeScreen.cs b/osu.Game.Tests/Visual/Editing/TestSceneComposeScreen.cs
index 8796088ec6..9b8567e853 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneComposeScreen.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneComposeScreen.cs
@@ -3,7 +3,6 @@
 
 using NUnit.Framework;
 using osu.Framework.Allocation;
-using osu.Framework.Bindables;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Rulesets.Edit;
 using osu.Game.Rulesets.Osu;
@@ -27,8 +26,8 @@ namespace osu.Game.Tests.Visual.Editing
                 }
             });
 
-        [Cached(Name = nameof(Editor.Clipboard))]
-        private Bindable<string> clipboard = new Bindable<string>();
+        [Cached]
+        private EditorClipboard clipboard = new EditorClipboard();
 
         [BackgroundDependencyLoader]
         private void load()
diff --git a/osu.Game/Screens/Edit/Compose/ComposeScreen.cs b/osu.Game/Screens/Edit/Compose/ComposeScreen.cs
index b0a85f33d9..d78dce5b60 100644
--- a/osu.Game/Screens/Edit/Compose/ComposeScreen.cs
+++ b/osu.Game/Screens/Edit/Compose/ComposeScreen.cs
@@ -28,7 +28,6 @@ namespace osu.Game.Screens.Edit.Compose
         [Resolved]
         private EditorClock clock { get; set; }
 
-        [Resolved(Name = nameof(Editor.Clipboard))]
         private Bindable<string> clipboard { get; set; }
 
         private HitObjectComposer composer;
@@ -77,6 +76,12 @@ namespace osu.Game.Screens.Edit.Compose
             return new EditorSkinProvidingContainer(EditorBeatmap).WithChild(content);
         }
 
+        [BackgroundDependencyLoader]
+        private void load(EditorClipboard clipboard)
+        {
+            this.clipboard = clipboard.Content.GetBoundCopy();
+        }
+
         protected override void LoadComplete()
         {
             base.LoadComplete();
diff --git a/osu.Game/Screens/Edit/Editor.cs b/osu.Game/Screens/Edit/Editor.cs
index b8a1dda508..de265ad94b 100644
--- a/osu.Game/Screens/Edit/Editor.cs
+++ b/osu.Game/Screens/Edit/Editor.cs
@@ -103,8 +103,8 @@ namespace osu.Game.Screens.Edit
         [Resolved]
         private MusicController music { get; set; }
 
-        [Cached(Name = nameof(Clipboard))]
-        public readonly Bindable<string> Clipboard = new Bindable<string>();
+        [Cached]
+        public readonly EditorClipboard Clipboard = new EditorClipboard();
 
         public Editor(EditorLoader loader = null)
         {
@@ -317,7 +317,7 @@ namespace osu.Game.Screens.Edit
         public void RestoreState([NotNull] EditorState state) => Schedule(() =>
         {
             clock.Seek(state.Time);
-            Clipboard.Value = state.ClipboardContent;
+            Clipboard.Content.Value = state.ClipboardContent;
         });
 
         protected void Save()
@@ -743,7 +743,7 @@ namespace osu.Game.Screens.Edit
         protected void SwitchToDifficulty(BeatmapInfo nextBeatmap) => loader?.ScheduleDifficultySwitch(nextBeatmap, new EditorState
         {
             Time = clock.CurrentTimeAccurate,
-            ClipboardContent = editorBeatmap.BeatmapInfo.RulesetID == nextBeatmap.RulesetID ? Clipboard.Value : string.Empty
+            ClipboardContent = editorBeatmap.BeatmapInfo.RulesetID == nextBeatmap.RulesetID ? Clipboard.Content.Value : string.Empty
         });
 
         private void cancelExit()
diff --git a/osu.Game/Screens/Edit/EditorClipboard.cs b/osu.Game/Screens/Edit/EditorClipboard.cs
new file mode 100644
index 0000000000..f6f0c09e00
--- /dev/null
+++ b/osu.Game/Screens/Edit/EditorClipboard.cs
@@ -0,0 +1,15 @@
+// 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;
+
+namespace osu.Game.Screens.Edit
+{
+    /// <summary>
+    /// Wraps the contents of the editor clipboard.
+    /// </summary>
+    public class EditorClipboard
+    {
+        public Bindable<string> Content { get; } = new Bindable<string>();
+    }
+}

From b25ad8dfcb498dea0068de61397108c2074daee9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 10 Nov 2021 12:49:04 +0100
Subject: [PATCH 0896/5547] Copy editor timestamp to OS clipboard even when
 triggered via menu bar

Would only work when triggered via Ctrl+C before, and not work at all
for Ctrl+X.
---
 .../Screens/Edit/Compose/ComposeScreen.cs     | 49 ++++++-------------
 1 file changed, 16 insertions(+), 33 deletions(-)

diff --git a/osu.Game/Screens/Edit/Compose/ComposeScreen.cs b/osu.Game/Screens/Edit/Compose/ComposeScreen.cs
index d78dce5b60..3b02d42b41 100644
--- a/osu.Game/Screens/Edit/Compose/ComposeScreen.cs
+++ b/osu.Game/Screens/Edit/Compose/ComposeScreen.cs
@@ -7,9 +7,6 @@ using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 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.Framework.Platform;
 using osu.Game.Beatmaps;
 using osu.Game.Extensions;
@@ -20,7 +17,7 @@ using osu.Game.Screens.Edit.Compose.Components.Timeline;
 
 namespace osu.Game.Screens.Edit.Compose
 {
-    public class ComposeScreen : EditorScreenWithTimeline, IKeyBindingHandler<PlatformAction>
+    public class ComposeScreen : EditorScreenWithTimeline
     {
         [Resolved]
         private GameHost host { get; set; }
@@ -89,35 +86,6 @@ namespace osu.Game.Screens.Edit.Compose
             clipboard.BindValueChanged(_ => updateClipboardActionAvailability(), true);
         }
 
-        #region Input Handling
-
-        public bool OnPressed(KeyBindingPressEvent<PlatformAction> e)
-        {
-            if (e.Action == PlatformAction.Copy)
-                host.GetClipboard()?.SetText(formatSelectionAsString());
-
-            return false;
-        }
-
-        public void OnReleased(KeyBindingReleaseEvent<PlatformAction> e)
-        {
-        }
-
-        private string formatSelectionAsString()
-        {
-            if (composer == null)
-                return string.Empty;
-
-            double displayTime = EditorBeatmap.SelectedHitObjects.OrderBy(h => h.StartTime).FirstOrDefault()?.StartTime ?? clock.CurrentTime;
-            string selectionAsString = composer.ConvertSelectionToString();
-
-            return !string.IsNullOrEmpty(selectionAsString)
-                ? $"{displayTime.ToEditorFormattedString()} ({selectionAsString}) - "
-                : $"{displayTime.ToEditorFormattedString()} - ";
-        }
-
-        #endregion
-
         #region Clipboard operations
 
         protected override void PerformCut()
@@ -133,6 +101,8 @@ namespace osu.Game.Screens.Edit.Compose
             base.PerformCopy();
 
             clipboard.Value = new ClipboardContent(EditorBeatmap).Serialize();
+
+            host.GetClipboard()?.SetText(formatSelectionAsString());
         }
 
         protected override void PerformPaste()
@@ -164,6 +134,19 @@ namespace osu.Game.Screens.Edit.Compose
             CanPaste.Value = !string.IsNullOrEmpty(clipboard.Value);
         }
 
+        private string formatSelectionAsString()
+        {
+            if (composer == null)
+                return string.Empty;
+
+            double displayTime = EditorBeatmap.SelectedHitObjects.OrderBy(h => h.StartTime).FirstOrDefault()?.StartTime ?? clock.CurrentTime;
+            string selectionAsString = composer.ConvertSelectionToString();
+
+            return !string.IsNullOrEmpty(selectionAsString)
+                ? $"{displayTime.ToEditorFormattedString()} ({selectionAsString}) - "
+                : $"{displayTime.ToEditorFormattedString()} - ";
+        }
+
         #endregion
     }
 }

From 1bc6a58528c85574b68aac5e13b98411089212e3 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 10 Nov 2021 21:23:18 +0900
Subject: [PATCH 0897/5547] Fix RoomUpdated() not invoked on item changes

---
 osu.Game/Online/Multiplayer/MultiplayerClient.cs | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/osu.Game/Online/Multiplayer/MultiplayerClient.cs b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
index ede42a8d1e..cf61b83e08 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
@@ -656,6 +656,8 @@ namespace osu.Game.Online.Multiplayer
                 // If the currently-selected item was the one that got replaced, update the selected item to the new one.
                 if (CurrentMatchPlayingItem.Value == oldItem)
                     CurrentMatchPlayingItem.Value = APIRoom.Playlist[index];
+
+                RoomUpdated?.Invoke();
             }).ConfigureAwait(false);
         }
 

From c51cb623158d60745e4275dcb288019932b041c9 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 10 Nov 2021 21:27:20 +0900
Subject: [PATCH 0898/5547] Adjust TestMultiplayerClient for correctness

---
 .../Visual/Multiplayer/TestMultiplayerClient.cs   | 15 +++++----------
 1 file changed, 5 insertions(+), 10 deletions(-)

diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
index ba004f83f8..d2fc403d1d 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
@@ -383,25 +383,20 @@ namespace osu.Game.Tests.Visual.Multiplayer
             Debug.Assert(Room != null);
             Debug.Assert(APIRoom != null);
 
-            long nextId = 0;
+            long nextId;
 
             switch (Room.Settings.QueueMode)
             {
-                case QueueModes.HostOnly:
+                default:
                     // Pick the single non-expired playlist item.
-                    nextId = APIRoom.Playlist.SingleOrDefault(i => !i.Expired)?.ID ?? 0;
+                    nextId = APIRoom.Playlist.FirstOrDefault(i => !i.Expired)?.ID
+                             ?? APIRoom.Playlist.LastOrDefault()?.ID
+                             ?? 0;
                     break;
 
                 case QueueModes.FairRotate:
                     // Group playlist items by (user_id -> count_expired), and select the first available playlist item from a user that has available beatmaps where count_expired is the lowest.
                     throw new NotImplementedException();
-
-                case QueueModes.FreeForAll:
-                    // Pick the first available non-expired playlist item, or default to the last.
-                    nextId = APIRoom.Playlist.FirstOrDefault(i => !i.Expired)?.ID
-                             ?? APIRoom.Playlist.LastOrDefault()?.ID
-                             ?? 0;
-                    break;
             }
 
             if (nextId != Room.Settings.PlaylistItemId)

From 34d235b790bf5686a1074a8217e5b2c1b79bd68a Mon Sep 17 00:00:00 2001
From: Semyon Rozhkov <semro@outlook.com>
Date: Wed, 10 Nov 2021 15:50:36 +0300
Subject: [PATCH 0899/5547] Reset combo in different way

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

diff --git a/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModNoScope.cs b/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModNoScope.cs
index 0d0fefe0ff..8e226c7ded 100644
--- a/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModNoScope.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModNoScope.cs
@@ -137,7 +137,7 @@ namespace osu.Game.Rulesets.Osu.Tests.Mods
             AddAssert("cursor must start visible", () => cursorAlphaAlmostEquals(1));
             AddUntilStep("wait for combo", () => Player.ScoreProcessor.Combo.Value >= 2);
             AddAssert("cursor must dim after combo", () => !cursorAlphaAlmostEquals(1));
-            AddStep("break combo", () => Player.ScoreProcessor.Combo.Set(0));
+            AddStep("break combo", () => Player.ScoreProcessor.Combo.Value = 0);
             AddUntilStep("wait for cursor to show", () => cursorAlphaAlmostEquals(1));
         }
 

From 30efc589d1a6b33e83402400e2d3f1f732b989a8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 10 Nov 2021 14:03:29 +0100
Subject: [PATCH 0900/5547] Fix logo sample always playing in main menu when
 initially logged out

---
 osu.Game/Screens/Menu/MainMenu.cs | 13 ++++++++++---
 1 file changed, 10 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Screens/Menu/MainMenu.cs b/osu.Game/Screens/Menu/MainMenu.cs
index 221b31f855..3da740b85d 100644
--- a/osu.Game/Screens/Menu/MainMenu.cs
+++ b/osu.Game/Screens/Menu/MainMenu.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.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
@@ -214,10 +215,16 @@ namespace osu.Game.Screens.Menu
             }
             else if (!api.IsLoggedIn)
             {
-                logo.Action += displayLogin;
+                // copy out old action to avoid accidentally capturing logo.Action in closure, causing a self-reference loop.
+                var previousAction = logo.Action;
+
+                // we want to hook into logo.Action to display the login overlay, but also preserve the return value of the old action.
+                // therefore pass the old action to displayLogin, so that it can return that value.
+                // this ensures that the OsuLogo sample does not play when it is not desired.
+                logo.Action = () => displayLogin(previousAction);
             }
 
-            bool displayLogin()
+            bool displayLogin(Func<bool> originalAction)
             {
                 if (!loginDisplayed.Value)
                 {
@@ -225,7 +232,7 @@ namespace osu.Game.Screens.Menu
                     loginDisplayed.Value = true;
                 }
 
-                return true;
+                return originalAction.Invoke();
             }
         }
 

From f090e5ca7525edf51328dd892822941027ffd64f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 10 Nov 2021 15:24:36 +0100
Subject: [PATCH 0901/5547] Restyle card buttons to resemble buttons more

---
 .../Cards/BeatmapCardDownloadProgressBar.cs   | 10 +++++
 .../Cards/Buttons/BeatmapCardIconButton.cs    | 44 ++++++++++++++-----
 2 files changed, 44 insertions(+), 10 deletions(-)
 create mode 100644 osu.Game/Beatmaps/Drawables/Cards/BeatmapCardDownloadProgressBar.cs

diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardDownloadProgressBar.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardDownloadProgressBar.cs
new file mode 100644
index 0000000000..56e23f920b
--- /dev/null
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardDownloadProgressBar.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.Game.Beatmaps.Drawables.Cards
+{
+    public class BeatmapCardDownloadProgressBar
+    {
+        
+    }
+}
diff --git a/osu.Game/Beatmaps/Drawables/Cards/Buttons/BeatmapCardIconButton.cs b/osu.Game/Beatmaps/Drawables/Cards/Buttons/BeatmapCardIconButton.cs
index 155259d859..ebd78938c7 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/Buttons/BeatmapCardIconButton.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/Buttons/BeatmapCardIconButton.cs
@@ -1,8 +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.Collections.Generic;
 using osu.Framework.Allocation;
+using osu.Framework.Extensions.IEnumerableExtensions;
 using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.Shapes;
 using osu.Framework.Graphics.Sprites;
 using osu.Game.Graphics.Containers;
 using osu.Game.Overlays;
@@ -12,26 +16,45 @@ namespace osu.Game.Beatmaps.Drawables.Cards.Buttons
 {
     public abstract class BeatmapCardIconButton : OsuHoverContainer
     {
+        protected override IEnumerable<Drawable> EffectTargets => background.Yield();
+
+        private readonly Box background;
         protected readonly SpriteIcon Icon;
 
-        private float size;
+        private float iconSize;
 
-        public new float Size
+        public float IconSize
         {
-            get => size;
+            get => iconSize;
             set
             {
-                size = value;
-                Icon.Size = new Vector2(size);
+                iconSize = value;
+                Icon.Size = new Vector2(iconSize);
             }
         }
 
         protected BeatmapCardIconButton()
         {
-            Add(Icon = new SpriteIcon());
+            Child = new CircularContainer
+            {
+                RelativeSizeAxes = Axes.Both,
+                Masking = true,
+                Children = new Drawable[]
+                {
+                    background = new Box
+                    {
+                        RelativeSizeAxes = Axes.Both
+                    },
+                    Icon = new SpriteIcon
+                    {
+                        Origin = Anchor.Centre,
+                        Anchor = Anchor.Centre
+                    }
+                }
+            };
 
-            AutoSizeAxes = Axes.Both;
-            Size = 12;
+            Size = new Vector2(24);
+            IconSize = 12;
         }
 
         [BackgroundDependencyLoader]
@@ -39,8 +62,9 @@ namespace osu.Game.Beatmaps.Drawables.Cards.Buttons
         {
             Anchor = Origin = Anchor.Centre;
 
-            IdleColour = colourProvider.Light1;
-            HoverColour = colourProvider.Content1;
+            IdleColour = colourProvider.Background4;
+            HoverColour = colourProvider.Background1;
+            Icon.Colour = colourProvider.Content2;
         }
     }
 }

From 91baaa73f37c42d0adaf95aad2893c902f7f1019 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 10 Nov 2021 16:03:48 +0100
Subject: [PATCH 0902/5547] Show download progress on card body rather than in
 button

---
 .../Visual/Beatmaps/TestSceneBeatmapCard.cs   | 17 ++++
 .../TestSceneBeatmapCardDownloadButton.cs     | 15 ++--
 .../Beatmaps/Drawables/Cards/BeatmapCard.cs   | 60 +++++++++----
 .../Cards/BeatmapCardDownloadProgressBar.cs   | 84 ++++++++++++++++++-
 .../Drawables/Cards/Buttons/DownloadButton.cs | 19 +----
 5 files changed, 148 insertions(+), 47 deletions(-)

diff --git a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs
index 0feaa8f480..29a1e349c4 100644
--- a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs
+++ b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs
@@ -27,6 +27,9 @@ namespace osu.Game.Tests.Visual.Beatmaps
 
         private APIBeatmapSet[] testCases;
 
+        [Resolved]
+        private BeatmapManager beatmaps { get; set; }
+
         #region Test case generation
 
         [BackgroundDependencyLoader]
@@ -35,6 +38,7 @@ namespace osu.Game.Tests.Visual.Beatmaps
             var normal = CreateAPIBeatmapSet(Ruleset.Value);
             normal.HasVideo = true;
             normal.HasStoryboard = true;
+            normal.OnlineID = 241526;
 
             var withStatistics = CreateAPIBeatmapSet(Ruleset.Value);
             withStatistics.Title = withStatistics.TitleUnicode = "play favourite stats";
@@ -180,6 +184,19 @@ namespace osu.Game.Tests.Visual.Beatmaps
                 request.TriggerSuccess();
                 return true;
             });
+
+            ensureSoleilyRemoved();
+        }
+
+        private void ensureSoleilyRemoved()
+        {
+            AddUntilStep("ensure manager loaded", () => beatmaps != null);
+            AddStep("remove soleily", () =>
+            {
+                var beatmap = beatmaps.QueryBeatmapSet(b => b.OnlineBeatmapSetID == 241526);
+
+                if (beatmap != null) beatmaps.Delete(beatmap);
+            });
         }
 
         private Drawable createContent(OverlayColourScheme colourScheme, Func<APIBeatmapSet, Drawable> creationFunc)
diff --git a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCardDownloadButton.cs b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCardDownloadButton.cs
index 11eb93c5ac..82ab55cf0e 100644
--- a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCardDownloadButton.cs
+++ b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCardDownloadButton.cs
@@ -6,7 +6,6 @@ using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
-using osu.Framework.Testing;
 using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.Drawables.Cards.Buttons;
 using osu.Game.Configuration;
@@ -15,7 +14,6 @@ using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays;
 using osu.Game.Resources.Localisation.Web;
 using osu.Game.Rulesets.Osu;
-using osu.Game.Screens.Ranking.Expanded.Accuracy;
 using osu.Game.Tests.Resources;
 using osuTK;
 
@@ -42,22 +40,21 @@ namespace osu.Game.Tests.Visual.Beatmaps
 
             assertDownloadVisible(true);
             assertDownloadEnabled(true);
-            assertProgressVisible(false);
             assertPlayVisible(false);
             AddAssert("tooltip text correct", () => downloadButton.Download.TooltipText == BeatmapsetsStrings.PanelDownloadAll);
 
             AddStep("set downloading state", () => downloadButton.State.Value = DownloadState.Downloading);
-            assertDownloadVisible(false);
-            assertProgressVisible(true);
+            assertDownloadVisible(true);
+            assertDownloadEnabled(false);
             assertPlayVisible(false);
 
-            AddStep("set progress to 30%", () => downloadButton.Progress.Value = 0.3f);
-            AddStep("set progress to 100%", () => downloadButton.Progress.Value = 1f);
             AddStep("set importing state", () => downloadButton.State.Value = DownloadState.Importing);
+            assertDownloadVisible(true);
+            assertDownloadEnabled(false);
+            assertPlayVisible(false);
 
             AddStep("set locally available state", () => downloadButton.State.Value = DownloadState.LocallyAvailable);
             assertDownloadVisible(false);
-            assertProgressVisible(false);
             assertPlayVisible(true);
         }
 
@@ -113,8 +110,6 @@ namespace osu.Game.Tests.Visual.Beatmaps
         private void assertDownloadVisible(bool visible) => AddUntilStep($"download {(visible ? "visible" : "not visible")}", () => downloadButton.Download.IsPresent == visible);
         private void assertDownloadEnabled(bool enabled) => AddAssert($"download {(enabled ? "enabled" : "disabled")}", () => downloadButton.Download.Enabled.Value == enabled);
 
-        private void assertProgressVisible(bool visible) => AddUntilStep($"progress {(visible ? "visible" : "not visible")}", () => downloadButton.ChildrenOfType<SmoothCircularProgress>().Single().IsPresent == visible);
-
         private void assertPlayVisible(bool visible) => AddUntilStep($"play {(visible ? "visible" : "not visible")}", () => downloadButton.Play.IsPresent == visible);
 
         private static APIBeatmapSet createSoleily() => new APIBeatmapSet
diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
index 3202ac4b3c..fe25d3dc36 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
@@ -50,6 +50,9 @@ namespace osu.Game.Beatmaps.Drawables.Cards
         private GridContainer artistContainer;
         private FillFlowContainer<BeatmapCardStatistic> statisticsContainer;
 
+        private FillFlowContainer idleBottomContent;
+        private BeatmapCardDownloadProgressBar downloadProgressBar;
+
         [Resolved]
         private OverlayColourProvider colourProvider { get; set; }
 
@@ -218,34 +221,51 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                                 }
                             }
                         },
-                        new FillFlowContainer
+                        new Container
                         {
                             Name = @"Bottom content",
                             RelativeSizeAxes = Axes.X,
                             AutoSizeAxes = Axes.Y,
-                            Direction = FillDirection.Horizontal,
-                            Padding = new MarginPadding
-                            {
-                                Horizontal = 10,
-                                Vertical = 4
-                            },
-                            Spacing = new Vector2(4, 0),
                             Anchor = Anchor.BottomLeft,
                             Origin = Anchor.BottomLeft,
                             Children = new Drawable[]
                             {
-                                new BeatmapSetOnlineStatusPill
+                                idleBottomContent = new FillFlowContainer
                                 {
-                                    AutoSizeAxes = Axes.Both,
-                                    Status = beatmapSet.Status,
-                                    Anchor = Anchor.CentreLeft,
-                                    Origin = Anchor.CentreLeft
+                                    RelativeSizeAxes = Axes.X,
+                                    AutoSizeAxes = Axes.Y,
+                                    Direction = FillDirection.Horizontal,
+                                    Padding = new MarginPadding
+                                    {
+                                        Horizontal = 10,
+                                        Vertical = 4
+                                    },
+                                    Spacing = new Vector2(4, 0),
+                                    Anchor = Anchor.BottomLeft,
+                                    Origin = Anchor.BottomLeft,
+                                    Children = new Drawable[]
+                                    {
+                                        new BeatmapSetOnlineStatusPill
+                                        {
+                                            AutoSizeAxes = Axes.Both,
+                                            Status = beatmapSet.Status,
+                                            Anchor = Anchor.CentreLeft,
+                                            Origin = Anchor.CentreLeft
+                                        },
+                                        new DifficultySpectrumDisplay(beatmapSet)
+                                        {
+                                            Anchor = Anchor.CentreLeft,
+                                            Origin = Anchor.CentreLeft,
+                                            DotSize = new Vector2(6, 12)
+                                        }
+                                    }
                                 },
-                                new DifficultySpectrumDisplay(beatmapSet)
+                                downloadProgressBar = new BeatmapCardDownloadProgressBar(beatmapSet)
                                 {
-                                    Anchor = Anchor.CentreLeft,
-                                    Origin = Anchor.CentreLeft,
-                                    DotSize = new Vector2(6, 12)
+                                    RelativeSizeAxes = Axes.X,
+                                    Height = 0,
+                                    Anchor = Anchor.BottomLeft,
+                                    Origin = Anchor.BottomLeft
                                 }
                             }
                         }
@@ -283,7 +303,8 @@ namespace osu.Game.Beatmaps.Drawables.Cards
         protected override void LoadComplete()
         {
             base.LoadComplete();
-            updateState();
+
+            downloadProgressBar.IsActive.BindValueChanged(_ => updateState(), true);
             FinishTransforms(true);
         }
 
@@ -335,6 +356,9 @@ namespace osu.Game.Beatmaps.Drawables.Cards
             leftCover.FadeColour(IsHovered ? OsuColour.Gray(0.2f) : Color4.White, TRANSITION_DURATION, Easing.OutQuint);
             statisticsContainer.FadeTo(IsHovered ? 1 : 0, TRANSITION_DURATION, Easing.OutQuint);
             rightButtonArea.FadeTo(IsHovered ? 1 : 0, TRANSITION_DURATION, Easing.OutQuint);
+
+            idleBottomContent.FadeTo(downloadProgressBar.IsActive.Value ? 0 : 1, TRANSITION_DURATION, Easing.OutQuint);
+            downloadProgressBar.ResizeHeightTo(downloadProgressBar.IsActive.Value ? 8 : 0, TRANSITION_DURATION, Easing.OutQuint);
         }
     }
 }
diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardDownloadProgressBar.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardDownloadProgressBar.cs
index 56e23f920b..a016f99b20 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardDownloadProgressBar.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardDownloadProgressBar.cs
@@ -1,10 +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 osu.Framework.Allocation;
+using osu.Framework.Bindables;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.Shapes;
+using osu.Game.Graphics;
+using osu.Game.Online;
+using osu.Game.Online.API.Requests.Responses;
+using osu.Game.Overlays;
+
 namespace osu.Game.Beatmaps.Drawables.Cards
 {
-    public class BeatmapCardDownloadProgressBar
+    public class BeatmapCardDownloadProgressBar : CompositeDrawable
     {
-        
+        private readonly BindableBool isActive = new BindableBool();
+        public IBindable<bool> IsActive => isActive;
+
+        public override bool IsPresent => true;
+
+        private readonly BeatmapDownloadTracker tracker;
+        private readonly Box background;
+        private readonly Box foreground;
+
+        [Resolved]
+        private OsuColour colours { get; set; }
+
+        [Resolved]
+        private OverlayColourProvider colourProvider { get; set; }
+
+        public BeatmapCardDownloadProgressBar(APIBeatmapSet beatmapSet)
+        {
+            InternalChildren = new Drawable[]
+            {
+                tracker = new BeatmapDownloadTracker(beatmapSet),
+                background = new Box
+                {
+                    RelativeSizeAxes = Axes.Both
+                },
+                foreground = new Box
+                {
+                    RelativeSizeAxes = Axes.Both
+                }
+            };
+        }
+
+        [BackgroundDependencyLoader]
+        private void load()
+        {
+            background.Colour = colourProvider.Background6;
+        }
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            tracker.State.BindValueChanged(_ => stateChanged(), true);
+            tracker.Progress.BindValueChanged(_ => progressChanged(), true);
+        }
+
+        private void stateChanged()
+        {
+            switch (tracker.State.Value)
+            {
+                case DownloadState.Downloading:
+                    FinishTransforms(true);
+                    foreground.Colour = colourProvider.Highlight1;
+                    isActive.Value = true;
+                    break;
+
+                case DownloadState.Importing:
+                    foreground.FadeColour(colours.Yellow, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
+                    isActive.Value = true;
+                    break;
+
+                default:
+                    isActive.Value = false;
+                    break;
+            }
+        }
+
+        private void progressChanged()
+        {
+            double progress = tracker.Progress.Value;
+            foreground.ResizeWidthTo((float)progress, progress > 0 ? BeatmapCard.TRANSITION_DURATION : 0, Easing.OutQuint);
+        }
     }
 }
diff --git a/osu.Game/Beatmaps/Drawables/Cards/Buttons/DownloadButton.cs b/osu.Game/Beatmaps/Drawables/Cards/Buttons/DownloadButton.cs
index df765e1e69..85e2988614 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/Buttons/DownloadButton.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/Buttons/DownloadButton.cs
@@ -14,8 +14,6 @@ using osu.Game.Graphics;
 using osu.Game.Online;
 using osu.Game.Overlays;
 using osu.Game.Resources.Localisation.Web;
-using osu.Game.Screens.Ranking.Expanded.Accuracy;
-using osuTK;
 
 namespace osu.Game.Beatmaps.Drawables.Cards.Buttons
 {
@@ -25,8 +23,6 @@ namespace osu.Game.Beatmaps.Drawables.Cards.Buttons
         protected readonly PlayIcon Play;
         protected readonly BeatmapDownloadTracker Tracker;
 
-        private readonly SmoothCircularProgress downloadProgress;
-
         [Resolved]
         private OsuColour colours { get; set; } = null!;
 
@@ -43,13 +39,6 @@ namespace osu.Game.Beatmaps.Drawables.Cards.Buttons
             {
                 Tracker = new BeatmapDownloadTracker(beatmapSet),
                 Download = new DownloadIcon(beatmapSet),
-                downloadProgress = new SmoothCircularProgress
-                {
-                    Size = new Vector2(12),
-                    Anchor = Anchor.Centre,
-                    Origin = Anchor.Centre,
-                    InnerRadius = 0.4f,
-                },
                 Play = new PlayIcon(beatmapSet)
             };
         }
@@ -65,12 +54,8 @@ namespace osu.Game.Beatmaps.Drawables.Cards.Buttons
 
         private void updateState()
         {
-            Download.FadeTo(Tracker.State.Value == DownloadState.NotDownloaded ? 1 : 0, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
-
-            downloadProgress.FadeTo(Tracker.State.Value == DownloadState.Downloading || Tracker.State.Value == DownloadState.Importing ? 1 : 0, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
-            downloadProgress.FadeColour(Tracker.State.Value == DownloadState.Importing ? colours.Yellow : colourProvider.Highlight1, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
-            if (Tracker.State.Value == DownloadState.Downloading)
-                downloadProgress.FillTo(Tracker.Progress.Value, Tracker.Progress.Value > 0 ? BeatmapCard.TRANSITION_DURATION : 0, Easing.OutQuint);
+            Download.FadeTo(Tracker.State.Value != DownloadState.LocallyAvailable ? 1 : 0, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
+            Download.Enabled.Value = Tracker.State.Value == DownloadState.NotDownloaded;
 
             Play.FadeTo(Tracker.State.Value == DownloadState.LocallyAvailable ? 1 : 0, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
         }

From 222846290ead013320a99fab4c55ca59a309a6bd Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 10 Nov 2021 18:38:52 +0100
Subject: [PATCH 0903/5547] Update download progress bar appearance to match
 intended design

---
 .../Beatmaps/Drawables/Cards/BeatmapCard.cs   | 72 +++++++++++--------
 .../Cards/BeatmapCardDownloadProgressBar.cs   | 31 +++++---
 2 files changed, 63 insertions(+), 40 deletions(-)

diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
index fe25d3dc36..09ceb72a10 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
@@ -210,15 +210,6 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                                     d.AddText("mapped by ", t => t.Colour = colourProvider.Content2);
                                     d.AddUserLink(beatmapSet.Author);
                                 }),
-                                statisticsContainer = new FillFlowContainer<BeatmapCardStatistic>
-                                {
-                                    RelativeSizeAxes = Axes.X,
-                                    AutoSizeAxes = Axes.Y,
-                                    Direction = FillDirection.Horizontal,
-                                    Spacing = new Vector2(10, 0),
-                                    Alpha = 0,
-                                    ChildrenEnumerable = createStatistics()
-                                }
                             }
                         },
                         new Container
@@ -228,44 +219,63 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                             AutoSizeAxes = Axes.Y,
                             Anchor = Anchor.BottomLeft,
                             Origin = Anchor.BottomLeft,
+                            Padding = new MarginPadding
+                            {
+                                Horizontal = 10,
+                                Vertical = 4
+                            },
                             Children = new Drawable[]
                             {
                                 idleBottomContent = new FillFlowContainer
                                 {
                                     RelativeSizeAxes = Axes.X,
                                     AutoSizeAxes = Axes.Y,
-                                    Direction = FillDirection.Horizontal,
-                                    Padding = new MarginPadding
-                                    {
-                                        Horizontal = 10,
-                                        Vertical = 4
-                                    },
-                                    Spacing = new Vector2(4, 0),
-                                    Anchor = Anchor.BottomLeft,
-                                    Origin = Anchor.BottomLeft,
+                                    Direction = FillDirection.Vertical,
+                                    Spacing = new Vector2(0, 3),
+                                    AlwaysPresent = true,
                                     Children = new Drawable[]
                                     {
-                                        new BeatmapSetOnlineStatusPill
+                                        statisticsContainer = new FillFlowContainer<BeatmapCardStatistic>
                                         {
-                                            AutoSizeAxes = Axes.Both,
-                                            Status = beatmapSet.Status,
-                                            Anchor = Anchor.CentreLeft,
-                                            Origin = Anchor.CentreLeft
+                                            RelativeSizeAxes = Axes.X,
+                                            AutoSizeAxes = Axes.Y,
+                                            Direction = FillDirection.Horizontal,
+                                            Spacing = new Vector2(10, 0),
+                                            Alpha = 0,
+                                            AlwaysPresent = true,
+                                            ChildrenEnumerable = createStatistics()
                                         },
-                                        new DifficultySpectrumDisplay(beatmapSet)
+                                        new FillFlowContainer
                                         {
-                                            Anchor = Anchor.CentreLeft,
-                                            Origin = Anchor.CentreLeft,
-                                            DotSize = new Vector2(6, 12)
+                                            RelativeSizeAxes = Axes.X,
+                                            AutoSizeAxes = Axes.Y,
+                                            Direction = FillDirection.Horizontal,
+                                            Spacing = new Vector2(4, 0),
+                                            Children = new Drawable[]
+                                            {
+                                                new BeatmapSetOnlineStatusPill
+                                                {
+                                                    AutoSizeAxes = Axes.Both,
+                                                    Status = beatmapSet.Status,
+                                                    Anchor = Anchor.CentreLeft,
+                                                    Origin = Anchor.CentreLeft
+                                                },
+                                                new DifficultySpectrumDisplay(beatmapSet)
+                                                {
+                                                    Anchor = Anchor.CentreLeft,
+                                                    Origin = Anchor.CentreLeft,
+                                                    DotSize = new Vector2(6, 12)
+                                                }
+                                            }
                                         }
                                     }
                                 },
                                 downloadProgressBar = new BeatmapCardDownloadProgressBar(beatmapSet)
                                 {
                                     RelativeSizeAxes = Axes.X,
-                                    Height = 0,
-                                    Anchor = Anchor.BottomLeft,
-                                    Origin = Anchor.BottomLeft
+                                    Height = 6,
+                                    Anchor = Anchor.Centre,
+                                    Origin = Anchor.Centre
                                 }
                             }
                         }
@@ -358,7 +368,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
             rightButtonArea.FadeTo(IsHovered ? 1 : 0, TRANSITION_DURATION, Easing.OutQuint);
 
             idleBottomContent.FadeTo(downloadProgressBar.IsActive.Value ? 0 : 1, TRANSITION_DURATION, Easing.OutQuint);
-            downloadProgressBar.ResizeHeightTo(downloadProgressBar.IsActive.Value ? 8 : 0, TRANSITION_DURATION, Easing.OutQuint);
+            downloadProgressBar.FadeTo(downloadProgressBar.IsActive.Value ? 1 : 0, TRANSITION_DURATION, Easing.OutQuint);
         }
     }
 }
diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardDownloadProgressBar.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardDownloadProgressBar.cs
index a016f99b20..37a7e7d41d 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardDownloadProgressBar.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardDownloadProgressBar.cs
@@ -21,8 +21,11 @@ namespace osu.Game.Beatmaps.Drawables.Cards
         public override bool IsPresent => true;
 
         private readonly BeatmapDownloadTracker tracker;
-        private readonly Box background;
-        private readonly Box foreground;
+        private readonly CircularContainer background;
+        private readonly CircularContainer foreground;
+
+        private readonly Box backgroundFill;
+        private readonly Box foregroundFill;
 
         [Resolved]
         private OsuColour colours { get; set; }
@@ -35,13 +38,23 @@ namespace osu.Game.Beatmaps.Drawables.Cards
             InternalChildren = new Drawable[]
             {
                 tracker = new BeatmapDownloadTracker(beatmapSet),
-                background = new Box
+                background = new CircularContainer
                 {
-                    RelativeSizeAxes = Axes.Both
+                    RelativeSizeAxes = Axes.Both,
+                    Masking = true,
+                    Child = backgroundFill = new Box
+                    {
+                        RelativeSizeAxes = Axes.Both,
+                    }
                 },
-                foreground = new Box
+                foreground = new CircularContainer
                 {
-                    RelativeSizeAxes = Axes.Both
+                    RelativeSizeAxes = Axes.Both,
+                    Masking = true,
+                    Child = foregroundFill = new Box
+                    {
+                        RelativeSizeAxes = Axes.Both,
+                    }
                 }
             };
         }
@@ -49,7 +62,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
         [BackgroundDependencyLoader]
         private void load()
         {
-            background.Colour = colourProvider.Background6;
+            backgroundFill.Colour = colourProvider.Background6;
         }
 
         protected override void LoadComplete()
@@ -66,12 +79,12 @@ namespace osu.Game.Beatmaps.Drawables.Cards
             {
                 case DownloadState.Downloading:
                     FinishTransforms(true);
-                    foreground.Colour = colourProvider.Highlight1;
+                    foregroundFill.Colour = colourProvider.Highlight1;
                     isActive.Value = true;
                     break;
 
                 case DownloadState.Importing:
-                    foreground.FadeColour(colours.Yellow, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
+                    foregroundFill.FadeColour(colours.Yellow, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
                     isActive.Value = true;
                     break;
 

From d370f64ac3e83ece673948b6d9d59804814da615 Mon Sep 17 00:00:00 2001
From: Darius Wattimena <dariuswattimena@hotmail.com>
Date: Wed, 10 Nov 2021 19:58:36 +0100
Subject: [PATCH 0904/5547] Changed finding the spinner gaps via a dictionary
 instead of getting the thresholds via an array

---
 .../Edit/Checks/CheckBananaShowerGap.cs          | 16 +++++++++++-----
 1 file changed, 11 insertions(+), 5 deletions(-)

diff --git a/osu.Game.Rulesets.Catch/Edit/Checks/CheckBananaShowerGap.cs b/osu.Game.Rulesets.Catch/Edit/Checks/CheckBananaShowerGap.cs
index d6671cb9db..4b2933c0e1 100644
--- a/osu.Game.Rulesets.Catch/Edit/Checks/CheckBananaShowerGap.cs
+++ b/osu.Game.Rulesets.Catch/Edit/Checks/CheckBananaShowerGap.cs
@@ -3,6 +3,7 @@
 
 using System;
 using System.Collections.Generic;
+using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Catch.Objects;
 using osu.Game.Rulesets.Edit;
 using osu.Game.Rulesets.Edit.Checks.Components;
@@ -15,8 +16,15 @@ namespace osu.Game.Rulesets.Catch.Edit.Checks
     /// </summary>
     public class CheckBananaShowerGap : ICheck
     {
-        private static readonly int[] spinner_start_delta_threshold = { 250, 250, 125, 125, 62, 62 };
-        private static readonly int[] spinner_end_delta_threshold = { 250, 250, 250, 125, 125, 125 };
+        private static readonly Dictionary<DifficultyRating, (int startGap, int endGap)> spinner_delta_threshold = new Dictionary<DifficultyRating, (int, int)>
+        {
+            [DifficultyRating.Easy] = (250, 250),
+            [DifficultyRating.Normal] = (250, 250),
+            [DifficultyRating.Hard] = (125, 250),
+            [DifficultyRating.Insane] = (125, 125),
+            [DifficultyRating.Expert] = (62, 125),
+            [DifficultyRating.ExpertPlus] = (62, 125)
+        };
 
         public CheckMetadata Metadata { get; } = new CheckMetadata(CheckCategory.Compose, "Too short spinner gap");
 
@@ -29,9 +37,7 @@ namespace osu.Game.Rulesets.Catch.Edit.Checks
         public IEnumerable<Issue> Run(BeatmapVerifierContext context)
         {
             var hitObjects = context.Beatmap.HitObjects;
-            int interpretedDifficulty = (int)context.InterpretedDifficulty;
-            int expectedStartDelta = spinner_start_delta_threshold[interpretedDifficulty];
-            int expectedEndDelta = spinner_end_delta_threshold[interpretedDifficulty];
+            (int expectedStartDelta, int expectedEndDelta) = spinner_delta_threshold[context.InterpretedDifficulty];
 
             for (int i = 0; i < hitObjects.Count - 1; ++i)
             {

From 5df694e9126b89dd625acfcd545fa58ef00699a3 Mon Sep 17 00:00:00 2001
From: apollo-dw <83023433+apollo-dw@users.noreply.github.com>
Date: Thu, 11 Nov 2021 00:42:06 +0000
Subject: [PATCH 0905/5547] Estimate number of difficult sliders, and increase
 assumed slider radius

---
 .../Difficulty/OsuPerformanceCalculator.cs               | 9 +++++++--
 .../Difficulty/Preprocessing/OsuDifficultyHitObject.cs   | 2 +-
 2 files changed, 8 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
index 4a37b8027f..661dd0aed6 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
@@ -125,9 +125,14 @@ namespace osu.Game.Rulesets.Osu.Difficulty
                 aimValue *= 1.0 + 0.04 * (12.0 - Attributes.ApproachRate);
             }
 
-            // Estimate the number of sliderends dropped
+            // We assume 20% of sliders in a map are difficult since there's no way to tell from pp-side.
+            double estimateDifficultSliders = Attributes.SliderCount * 0.15;
             double estimateSliderEndsDropped = Math.Min(Attributes.SliderCount, Math.Min(countOk + countMeh + countMiss, Attributes.MaxCombo - scoreMaxCombo));
-            aimValue *= (1 - Attributes.SliderFactor) * Math.Pow(1 - (estimateSliderEndsDropped / Attributes.SliderCount), 5.5) + Attributes.SliderFactor;
+
+            estimateSliderEndsDropped = Math.Min(estimateSliderEndsDropped, estimateDifficultSliders);
+
+            double sliderNerfFactor = (1 - Attributes.SliderFactor) * Math.Pow(1 - estimateSliderEndsDropped / estimateDifficultSliders, 5.5) + Attributes.SliderFactor;
+            aimValue *= Math.Max(Attributes.SliderFactor, sliderNerfFactor);
 
             aimValue *= accuracy;
             // It is important to also consider accuracy difficulty when doing that.
diff --git a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
index cbaad93bed..d073d751d0 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
@@ -14,7 +14,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
         private const int normalized_radius = 50; // Change radius to 50 to make 100 the diameter. Easier for mental maths.
         private const int min_delta_time = 25;
         private const float maximum_slider_radius = normalized_radius * 2.4f;
-        private const float assumed_slider_radius = normalized_radius * 1.65f;
+        private const float assumed_slider_radius = normalized_radius * 1.8f;
 
         protected new OsuHitObject BaseObject => (OsuHitObject)base.BaseObject;
 

From e33c1f9a41df5ea52373ffc453a05fec8056c135 Mon Sep 17 00:00:00 2001
From: Jamie Taylor <me@nekodex.net>
Date: Thu, 11 Nov 2021 11:00:55 +0900
Subject: [PATCH 0906/5547] Lower filter cutoff frequency

---
 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 4e5ccde579..734caa43d4 100644
--- a/osu.Game/Screens/Play/PlayerLoader.cs
+++ b/osu.Game/Screens/Play/PlayerLoader.cs
@@ -356,7 +356,7 @@ namespace osu.Game.Screens.Play
             content.FadeInFromZero(400);
             content.ScaleTo(1, 650, Easing.OutQuint).Then().Schedule(prepareNewPlayer);
             lowPassFilter.CutoffTo(1000, 650, Easing.OutQuint);
-            highPassFilter.CutoffTo(300);
+            highPassFilter.CutoffTo(150);
 
             ApplyToBackground(b => b?.FadeColour(Color4.White, 800, Easing.OutQuint));
         }

From 86c6837e5d73a385eef53dd6e73a54e995bde6a1 Mon Sep 17 00:00:00 2001
From: apollo-dw <83023433+apollo-dw@users.noreply.github.com>
Date: Thu, 11 Nov 2021 02:49:24 +0000
Subject: [PATCH 0907/5547] Make slider nerf factor more lenient

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

diff --git a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
index 661dd0aed6..6015a16165 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
@@ -125,13 +125,13 @@ namespace osu.Game.Rulesets.Osu.Difficulty
                 aimValue *= 1.0 + 0.04 * (12.0 - Attributes.ApproachRate);
             }
 
-            // We assume 20% of sliders in a map are difficult since there's no way to tell from pp-side.
+            // 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;
             double estimateSliderEndsDropped = Math.Min(Attributes.SliderCount, Math.Min(countOk + countMeh + countMiss, Attributes.MaxCombo - scoreMaxCombo));
 
             estimateSliderEndsDropped = Math.Min(estimateSliderEndsDropped, estimateDifficultSliders);
 
-            double sliderNerfFactor = (1 - Attributes.SliderFactor) * Math.Pow(1 - estimateSliderEndsDropped / estimateDifficultSliders, 5.5) + Attributes.SliderFactor;
+            double sliderNerfFactor = (1 - Attributes.SliderFactor) * Math.Pow(1 - estimateSliderEndsDropped / estimateDifficultSliders, 3) + Attributes.SliderFactor;
             aimValue *= Math.Max(Attributes.SliderFactor, sliderNerfFactor);
 
             aimValue *= accuracy;

From 707510806286d3429943a6bea807ecf9de6bba3e Mon Sep 17 00:00:00 2001
From: apollo-dw <83023433+apollo-dw@users.noreply.github.com>
Date: Thu, 11 Nov 2021 02:57:34 +0000
Subject: [PATCH 0908/5547] Clean up clamp logic relating to slider end
 estimate

---
 osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
index 6015a16165..5298c2b479 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
@@ -127,9 +127,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty
 
             // 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;
-            double estimateSliderEndsDropped = Math.Min(Attributes.SliderCount, Math.Min(countOk + countMeh + countMiss, Attributes.MaxCombo - scoreMaxCombo));
-
-            estimateSliderEndsDropped = Math.Min(estimateSliderEndsDropped, estimateDifficultSliders);
+            double estimateSliderEndsDropped = Math.Min(estimateDifficultSliders, Math.Min(countOk + countMeh + countMiss, Attributes.MaxCombo - scoreMaxCombo));
 
             double sliderNerfFactor = (1 - Attributes.SliderFactor) * Math.Pow(1 - estimateSliderEndsDropped / estimateDifficultSliders, 3) + Attributes.SliderFactor;
             aimValue *= Math.Max(Attributes.SliderFactor, sliderNerfFactor);

From 16418ac2ab69c1bb8b3b247a218016e4a08fe666 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 11 Nov 2021 14:02:12 +0900
Subject: [PATCH 0909/5547] Remove outdated comments

---
 osu.Game/Online/Multiplayer/MatchRoomState.cs | 1 -
 osu.Game/Online/Multiplayer/MatchUserState.cs | 1 -
 2 files changed, 2 deletions(-)

diff --git a/osu.Game/Online/Multiplayer/MatchRoomState.cs b/osu.Game/Online/Multiplayer/MatchRoomState.cs
index edd34fb5a3..30d948f878 100644
--- a/osu.Game/Online/Multiplayer/MatchRoomState.cs
+++ b/osu.Game/Online/Multiplayer/MatchRoomState.cs
@@ -16,7 +16,6 @@ namespace osu.Game.Online.Multiplayer
     [Serializable]
     [MessagePackObject]
     [Union(0, typeof(TeamVersusRoomState))] // IMPORTANT: Add rules to SignalRUnionWorkaroundResolver for new derived types.
-    // TODO: abstract breaks json serialisation. attention will be required for iOS support (unless we get messagepack AOT working instead).
     public abstract class MatchRoomState
     {
     }
diff --git a/osu.Game/Online/Multiplayer/MatchUserState.cs b/osu.Game/Online/Multiplayer/MatchUserState.cs
index 69245deba0..665b64a8b4 100644
--- a/osu.Game/Online/Multiplayer/MatchUserState.cs
+++ b/osu.Game/Online/Multiplayer/MatchUserState.cs
@@ -16,7 +16,6 @@ namespace osu.Game.Online.Multiplayer
     [Serializable]
     [MessagePackObject]
     [Union(0, typeof(TeamVersusUserState))] // IMPORTANT: Add rules to SignalRUnionWorkaroundResolver for new derived types.
-    // TODO: abstract breaks json serialisation. attention will be required for iOS support (unless we get messagepack AOT working instead).
     public abstract class MatchUserState
     {
     }

From 98fa253e1ed82e6135ef97e8afbf6958494c8056 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 11 Nov 2021 14:04:17 +0900
Subject: [PATCH 0910/5547] Replace usage of `TypeNameHandling.All` with custom
 type converter

---
 osu.Game/Online/HubClientConnector.cs         |  8 ++-
 ...gnalRDerivedTypeWorkaroundJsonConverter.cs | 60 +++++++++++++++++++
 .../Online/SignalRUnionWorkaroundResolver.cs  | 17 +++++-
 3 files changed, 81 insertions(+), 4 deletions(-)
 create mode 100644 osu.Game/Online/SignalRDerivedTypeWorkaroundJsonConverter.cs

diff --git a/osu.Game/Online/HubClientConnector.cs b/osu.Game/Online/HubClientConnector.cs
index e9d6960c71..c79660568c 100644
--- a/osu.Game/Online/HubClientConnector.cs
+++ b/osu.Game/Online/HubClientConnector.cs
@@ -4,6 +4,7 @@
 #nullable enable
 
 using System;
+using System.Collections.Generic;
 using System.Threading;
 using System.Threading.Tasks;
 using Microsoft.AspNetCore.SignalR.Client;
@@ -161,9 +162,10 @@ namespace osu.Game.Online
                 builder.AddNewtonsoftJsonProtocol(options =>
                 {
                     options.PayloadSerializerSettings.ReferenceLoopHandling = ReferenceLoopHandling.Ignore;
-                    // TODO: This should only be required to be `TypeNameHandling.Auto`.
-                    // See usage in osu-server-spectator for further documentation as to why this is required.
-                    options.PayloadSerializerSettings.TypeNameHandling = TypeNameHandling.All;
+                    options.PayloadSerializerSettings.Converters = new List<JsonConverter>
+                    {
+                        new SignalRDerivedTypeWorkaroundJsonConverter(),
+                    };
                 });
             }
 
diff --git a/osu.Game/Online/SignalRDerivedTypeWorkaroundJsonConverter.cs b/osu.Game/Online/SignalRDerivedTypeWorkaroundJsonConverter.cs
new file mode 100644
index 0000000000..55516d2223
--- /dev/null
+++ b/osu.Game/Online/SignalRDerivedTypeWorkaroundJsonConverter.cs
@@ -0,0 +1,60 @@
+// 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 enable
+using System;
+using System.Linq;
+using Newtonsoft.Json;
+using Newtonsoft.Json.Linq;
+
+namespace osu.Game.Online
+{
+    /// <summary>
+    /// A type of <see cref="JsonConverter"/> that serializes a subset of types used in multiplayer/spectator communication that
+    /// derive from a known base type. This is a safe alternative to using <see cref="TypeNameHandling.Auto"/> or <see cref="TypeNameHandling.All"/>,
+    /// which are known to have security issues.
+    /// </summary>
+    public class SignalRDerivedTypeWorkaroundJsonConverter : JsonConverter
+    {
+        public override bool CanConvert(Type objectType) =>
+            SignalRUnionWorkaroundResolver.BASE_TYPES.Contains(objectType) ||
+            SignalRUnionWorkaroundResolver.DERIVED_TYPES.Contains(objectType);
+
+        public override object? ReadJson(JsonReader reader, Type objectType, object? o, JsonSerializer jsonSerializer)
+        {
+            if (reader.TokenType == JsonToken.Null)
+                return null;
+
+            JObject obj = JObject.Load(reader);
+
+            string type = (string)obj[@"$dtype"]!;
+
+            var resolvedType = SignalRUnionWorkaroundResolver.DERIVED_TYPES.Single(t => t.Name == type);
+
+            object? instance = Activator.CreateInstance(resolvedType);
+
+            jsonSerializer.Populate(obj["$value"]!.CreateReader(), instance);
+
+            return instance;
+        }
+
+        public override void WriteJson(JsonWriter writer, object? o, JsonSerializer serializer)
+        {
+            if (o == null)
+            {
+                writer.WriteNull();
+                return;
+            }
+
+            writer.WriteStartObject();
+
+            writer.WritePropertyName(@"$dtype");
+            serializer.Serialize(writer, o.GetType().Name);
+
+            writer.WritePropertyName(@"$value");
+            writer.WriteRawValue(JsonConvert.SerializeObject(o));
+
+            writer.WriteEndObject();
+        }
+    }
+}
diff --git a/osu.Game/Online/SignalRUnionWorkaroundResolver.cs b/osu.Game/Online/SignalRUnionWorkaroundResolver.cs
index e44da044cc..21413f8285 100644
--- a/osu.Game/Online/SignalRUnionWorkaroundResolver.cs
+++ b/osu.Game/Online/SignalRUnionWorkaroundResolver.cs
@@ -20,7 +20,22 @@ namespace osu.Game.Online
         public static readonly MessagePackSerializerOptions OPTIONS =
             MessagePackSerializerOptions.Standard.WithResolver(new SignalRUnionWorkaroundResolver());
 
-        private static readonly Dictionary<Type, IMessagePackFormatter> formatter_map = new Dictionary<Type, IMessagePackFormatter>
+        public static readonly IReadOnlyList<Type> BASE_TYPES = new[]
+        {
+            typeof(MatchServerEvent),
+            typeof(MatchUserRequest),
+            typeof(MatchRoomState),
+            typeof(MatchUserState),
+        };
+
+        public static readonly IReadOnlyList<Type> DERIVED_TYPES = new[]
+        {
+            typeof(ChangeTeamRequest),
+            typeof(TeamVersusRoomState),
+            typeof(TeamVersusUserState),
+        };
+
+        private static readonly IReadOnlyDictionary<Type, IMessagePackFormatter> formatter_map = new Dictionary<Type, IMessagePackFormatter>
         {
             { typeof(TeamVersusUserState), new TypeRedirectingFormatter<TeamVersusUserState, MatchUserState>() },
             { typeof(TeamVersusRoomState), new TypeRedirectingFormatter<TeamVersusRoomState, MatchRoomState>() },

From ea536dea23c9b6cfe75693b679304ff416aa7688 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 11 Nov 2021 14:45:40 +0900
Subject: [PATCH 0911/5547] Gracefully handle missing type rather than
 triggering `ArgumentNullException`

---
 osu.Game/Rulesets/RulesetStore.cs | 15 ++++++++++-----
 1 file changed, 10 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Rulesets/RulesetStore.cs b/osu.Game/Rulesets/RulesetStore.cs
index 391bf2c07d..914f33a7ae 100644
--- a/osu.Game/Rulesets/RulesetStore.cs
+++ b/osu.Game/Rulesets/RulesetStore.cs
@@ -129,13 +129,18 @@ namespace osu.Game.Rulesets
                 {
                     try
                     {
-                        var instanceInfo = ((Ruleset)Activator.CreateInstance(Type.GetType(r.InstantiationInfo).AsNonNull())).RulesetInfo;
+                        var resolvedType = Type.GetType(r.InstantiationInfo);
 
-                        r.Name = instanceInfo.Name;
-                        r.ShortName = instanceInfo.ShortName;
-                        r.InstantiationInfo = instanceInfo.InstantiationInfo;
+                        if (resolvedType != null)
+                        {
+                            var instanceInfo = ((Ruleset)Activator.CreateInstance(resolvedType)).RulesetInfo;
 
-                        r.Available = true;
+                            r.Name = instanceInfo.Name;
+                            r.ShortName = instanceInfo.ShortName;
+                            r.InstantiationInfo = instanceInfo.InstantiationInfo;
+
+                            r.Available = true;
+                        }
                     }
                     catch
                     {

From 57c333b472f724c24aab22e1890ed0b993926755 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 11 Nov 2021 15:29:08 +0900
Subject: [PATCH 0912/5547] Remove unused using

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

diff --git a/osu.Game/Rulesets/RulesetStore.cs b/osu.Game/Rulesets/RulesetStore.cs
index 914f33a7ae..1ddd5396f4 100644
--- a/osu.Game/Rulesets/RulesetStore.cs
+++ b/osu.Game/Rulesets/RulesetStore.cs
@@ -7,7 +7,6 @@ using System.IO;
 using System.Linq;
 using System.Reflection;
 using osu.Framework;
-using osu.Framework.Extensions.ObjectExtensions;
 using osu.Framework.Logging;
 using osu.Framework.Platform;
 using osu.Game.Database;

From f38d6ef8db67229dc7a4f440aa63be23d7a6c882 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 11 Nov 2021 08:39:59 +0100
Subject: [PATCH 0913/5547] Add failing test steps

---
 .../Visual/Multiplayer/TestSceneTeamVersus.cs     | 13 +++++++++++--
 .../Visual/Multiplayer/TestMultiplayerClient.cs   | 15 +++++++++++++++
 2 files changed, 26 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs
index 1efa8d6810..99ff307235 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs
@@ -10,6 +10,7 @@ using osu.Framework.Platform;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
 using osu.Game.Database;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Multiplayer.MatchTypes.TeamVersus;
 using osu.Game.Online.Rooms;
 using osu.Game.Rulesets;
@@ -97,16 +98,24 @@ namespace osu.Game.Tests.Visual.Multiplayer
             });
 
             AddAssert("user on team 0", () => (client.Room?.Users.FirstOrDefault()?.MatchState as TeamVersusUserState)?.TeamID == 0);
+            AddStep("add another user", () => client.AddUser(new APIUser { Username = "otheruser", Id = 44 }));
 
-            AddStep("press button", () =>
+            AddStep("press own button", () =>
             {
                 InputManager.MoveMouseTo(multiplayerScreenStack.ChildrenOfType<TeamDisplay>().First());
                 InputManager.Click(MouseButton.Left);
             });
             AddAssert("user on team 1", () => (client.Room?.Users.FirstOrDefault()?.MatchState as TeamVersusUserState)?.TeamID == 1);
 
-            AddStep("press button", () => InputManager.Click(MouseButton.Left));
+            AddStep("press own button again", () => InputManager.Click(MouseButton.Left));
             AddAssert("user on team 0", () => (client.Room?.Users.FirstOrDefault()?.MatchState as TeamVersusUserState)?.TeamID == 0);
+
+            AddStep("press other user's button", () =>
+            {
+                InputManager.MoveMouseTo(multiplayerScreenStack.ChildrenOfType<TeamDisplay>().ElementAt(1));
+                InputManager.Click(MouseButton.Left);
+            });
+            AddAssert("user still on team 0", () => (client.Room?.Users.FirstOrDefault()?.MatchState as TeamVersusUserState)?.TeamID == 0);
         }
 
         [Test]
diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
index 0860e45346..f81ca70631 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
@@ -71,6 +71,21 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             // We want the user to be immediately available for testing, so force a scheduler update to run the update-bound continuation.
             Scheduler.Update();
+
+            switch (Room?.MatchState)
+            {
+                case TeamVersusRoomState teamVersus:
+                    Debug.Assert(Room != null);
+
+                    // simulate the server's automatic assignment of users to teams on join.
+                    // the "best" team is the one with the least users on it.
+                    int bestTeam = teamVersus.Teams
+                                             .Select(team => (teamID: team.ID, userCount: Room.Users.Count(u => (u.MatchState as TeamVersusUserState)?.TeamID == team.ID)))
+                                             .OrderBy(pair => pair.userCount)
+                                             .First().teamID;
+                    ((IMultiplayerClient)this).MatchUserStateChanged(user.UserID, new TeamVersusUserState { TeamID = bestTeam }).Wait();
+                    break;
+            }
         }
 
         public void RemoveUser(APIUser user)

From 9664b9a97ca60957c2137e7c08b59c2ed12792ac Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 11 Nov 2021 08:40:50 +0100
Subject: [PATCH 0914/5547] Fix being able to switch own team by clicking other
 players' team indicators

---
 .../Screens/OnlinePlay/Multiplayer/Participants/TeamDisplay.cs   | 1 -
 1 file changed, 1 deletion(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/TeamDisplay.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/TeamDisplay.cs
index 1bf62241f2..73aca0acdc 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/TeamDisplay.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/TeamDisplay.cs
@@ -51,7 +51,6 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Participants
                 Alpha = 0,
                 Scale = new Vector2(0, 1),
                 RelativeSizeAxes = Axes.Y,
-                Action = changeTeam,
                 Child = box = new Container
                 {
                     RelativeSizeAxes = Axes.Both,

From ebe58cee1129a01d7c9c420cbdb94a16751e9f08 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 11 Nov 2021 17:18:51 +0900
Subject: [PATCH 0915/5547] Rename `BeatmapInfo.StarDifficulty` to `StarRating`
 to match underlying interface

---
 .../NonVisual/Filtering/FilterMatchingTest.cs          |  2 +-
 .../Visual/Multiplayer/TestSceneDrawableRoom.cs        |  8 ++++----
 .../Multiplayer/TestSceneStarRatingRangeDisplay.cs     |  4 ++--
 .../Visual/SongSelect/TestSceneAdvancedStats.cs        |  4 ++--
 .../Visual/SongSelect/TestSceneBeatmapCarousel.cs      | 10 +++++-----
 .../Visual/SongSelect/TestSceneBeatmapInfoWedge.cs     |  2 +-
 .../SongSelect/TestSceneBeatmapMetadataDisplay.cs      |  4 ++--
 .../SongSelect/TestSceneBeatmapRecommendations.cs      |  2 +-
 osu.Game/Beatmaps/BeatmapInfo.cs                       |  8 +++-----
 osu.Game/Beatmaps/BeatmapModelManager.cs               |  2 +-
 osu.Game/Beatmaps/BeatmapSetInfo.cs                    |  2 +-
 osu.Game/Beatmaps/DifficultyRecommender.cs             |  2 +-
 osu.Game/Screens/Edit/Editor.cs                        |  2 +-
 osu.Game/Screens/Select/Carousel/CarouselBeatmap.cs    |  6 +++---
 osu.Game/Screens/Select/Carousel/CarouselBeatmapSet.cs |  2 +-
 osu.Game/Tests/Visual/OsuTestScene.cs                  |  2 +-
 16 files changed, 30 insertions(+), 32 deletions(-)

diff --git a/osu.Game.Tests/NonVisual/Filtering/FilterMatchingTest.cs b/osu.Game.Tests/NonVisual/Filtering/FilterMatchingTest.cs
index 41939cec3f..743d11541d 100644
--- a/osu.Game.Tests/NonVisual/Filtering/FilterMatchingTest.cs
+++ b/osu.Game.Tests/NonVisual/Filtering/FilterMatchingTest.cs
@@ -17,7 +17,7 @@ namespace osu.Game.Tests.NonVisual.Filtering
         private BeatmapInfo getExampleBeatmap() => new BeatmapInfo
         {
             Ruleset = new RulesetInfo { ID = 5 },
-            StarDifficulty = 4.0d,
+            StarRating = 4.0d,
             BaseDifficulty = new BeatmapDifficulty
             {
                 ApproachRate = 5.0f,
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoom.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoom.cs
index 721862c177..2c28a1752e 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoom.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoom.cs
@@ -59,7 +59,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                                         {
                                             BeatmapInfo =
                                             {
-                                                StarDifficulty = 2.5
+                                                StarRating = 2.5
                                             }
                                         }.BeatmapInfo,
                                     }
@@ -82,7 +82,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                                         {
                                             BeatmapInfo =
                                             {
-                                                StarDifficulty = 2.5,
+                                                StarRating = 2.5,
                                                 Metadata =
                                                 {
                                                     Artist = "very very very very very very very very very long artist",
@@ -111,7 +111,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                                         {
                                             BeatmapInfo =
                                             {
-                                                StarDifficulty = 2.5
+                                                StarRating = 2.5
                                             }
                                         }.BeatmapInfo,
                                     }
@@ -124,7 +124,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                                         {
                                             BeatmapInfo =
                                             {
-                                                StarDifficulty = 4.5
+                                                StarRating = 4.5
                                             }
                                         }.BeatmapInfo,
                                     }
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneStarRatingRangeDisplay.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneStarRatingRangeDisplay.cs
index cdeafdc9a3..20db922122 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneStarRatingRangeDisplay.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneStarRatingRangeDisplay.cs
@@ -31,8 +31,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
             {
                 SelectedRoom.Value.Playlist.AddRange(new[]
                 {
-                    new PlaylistItem { Beatmap = { Value = new BeatmapInfo { StarDifficulty = min } } },
-                    new PlaylistItem { Beatmap = { Value = new BeatmapInfo { StarDifficulty = max } } },
+                    new PlaylistItem { Beatmap = { Value = new BeatmapInfo { StarRating = min } } },
+                    new PlaylistItem { Beatmap = { Value = new BeatmapInfo { StarRating = max } } },
                 });
             });
         }
diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneAdvancedStats.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneAdvancedStats.cs
index 07e68ef509..d57b3dec5d 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneAdvancedStats.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneAdvancedStats.cs
@@ -46,7 +46,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                 OverallDifficulty = 5.7f,
                 ApproachRate = 3.5f
             },
-            StarDifficulty = 4.5f
+            StarRating = 4.5f
         };
 
         [Test]
@@ -76,7 +76,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                     OverallDifficulty = 4.5f,
                     ApproachRate = 3.1f
                 },
-                StarDifficulty = 8
+                StarRating = 8
             });
 
             AddAssert("first bar text is Key Count", () => advancedStats.ChildrenOfType<SpriteText>().First().Text == "Key Count");
diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs
index 9a142f3ca8..3a5af6811d 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs
@@ -435,8 +435,8 @@ namespace osu.Game.Tests.Visual.SongSelect
             for (int i = 0; i < 3; i++)
             {
                 var set = createTestBeatmapSet(i);
-                set.Beatmaps[0].StarDifficulty = 3 - i;
-                set.Beatmaps[2].StarDifficulty = 6 + i;
+                set.Beatmaps[0].StarRating = 3 - i;
+                set.Beatmaps[2].StarRating = 6 + i;
                 sets.Add(set);
             }
 
@@ -686,7 +686,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                     {
                         Version = $"Stars: {i}",
                         Ruleset = new OsuRuleset().RulesetInfo,
-                        StarDifficulty = i,
+                        StarRating = i,
                     });
                 }
 
@@ -869,7 +869,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                 {
                     OnlineBeatmapID = id++ * 10,
                     Version = version,
-                    StarDifficulty = diff,
+                    StarRating = diff,
                     Ruleset = new OsuRuleset().RulesetInfo,
                     BaseDifficulty = new BeatmapDifficulty
                     {
@@ -904,7 +904,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                     Path = $"extra{b}.osu",
                     Version = $"Extra {b}",
                     Ruleset = rulesets.GetRuleset((b - 1) % 4),
-                    StarDifficulty = 2,
+                    StarRating = 2,
                     BaseDifficulty = new BeatmapDifficulty
                     {
                         OverallDifficulty = 3.5f,
diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapInfoWedge.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapInfoWedge.cs
index 9fa0eab548..666969eb2a 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapInfoWedge.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapInfoWedge.cs
@@ -198,7 +198,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                         Title = $"{ruleset.ShortName}Title"
                     },
                     Ruleset = ruleset,
-                    StarDifficulty = 6,
+                    StarRating = 6,
                     Version = $"{ruleset.ShortName}Version",
                     BaseDifficulty = new BeatmapDifficulty()
                 },
diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapMetadataDisplay.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapMetadataDisplay.cs
index 50ae673c06..574ccce6d5 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapMetadataDisplay.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapMetadataDisplay.cs
@@ -46,7 +46,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                         Title = title,
                     },
                     Version = version,
-                    StarDifficulty = RNG.NextDouble(0, 10),
+                    StarRating = RNG.NextDouble(0, 10),
                 }
             }));
         }
@@ -65,7 +65,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                         Title = "Heavy beatmap",
                     },
                     Version = "10k objects",
-                    StarDifficulty = 99.99f,
+                    StarRating = 99.99f,
                 }
             }));
 
diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapRecommendations.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapRecommendations.cs
index 68d5836cac..2c41ea1f53 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapRecommendations.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapRecommendations.cs
@@ -188,7 +188,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                     Metadata = metadata,
                     BaseDifficulty = new BeatmapDifficulty(),
                     Ruleset = ruleset,
-                    StarDifficulty = difficultyIndex + 1,
+                    StarRating = difficultyIndex + 1,
                     Version = $"SR{difficultyIndex + 1}"
                 }).ToList()
             };
diff --git a/osu.Game/Beatmaps/BeatmapInfo.cs b/osu.Game/Beatmaps/BeatmapInfo.cs
index 01a819dead..613b0599a0 100644
--- a/osu.Game/Beatmaps/BeatmapInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapInfo.cs
@@ -139,7 +139,8 @@ namespace osu.Game.Beatmaps
         private string versionString => string.IsNullOrEmpty(Version) ? string.Empty : $"[{Version}]";
 
         [JsonProperty("difficulty_rating")]
-        public double StarDifficulty { get; set; }
+        [Column("StarDifficulty")]
+        public double StarRating { get; set; }
 
         /// <summary>
         /// Currently only populated for beatmap deletion. Use <see cref="ScoreManager"/> to query scores.
@@ -147,7 +148,7 @@ namespace osu.Game.Beatmaps
         public List<ScoreInfo> Scores { get; set; }
 
         [JsonIgnore]
-        public DifficultyRating DifficultyRating => BeatmapDifficultyCache.GetDifficultyRating(StarDifficulty);
+        public DifficultyRating DifficultyRating => BeatmapDifficultyCache.GetDifficultyRating(StarRating);
 
         public override string ToString() => this.GetDisplayTitle();
 
@@ -197,9 +198,6 @@ namespace osu.Game.Beatmaps
         [JsonIgnore]
         IRulesetInfo IBeatmapInfo.Ruleset => Ruleset;
 
-        [JsonIgnore]
-        double IBeatmapInfo.StarRating => StarDifficulty;
-
         #endregion
     }
 }
diff --git a/osu.Game/Beatmaps/BeatmapModelManager.cs b/osu.Game/Beatmaps/BeatmapModelManager.cs
index a654b05edb..d166f42cde 100644
--- a/osu.Game/Beatmaps/BeatmapModelManager.cs
+++ b/osu.Game/Beatmaps/BeatmapModelManager.cs
@@ -407,7 +407,7 @@ namespace osu.Game.Beatmaps
                     beatmap.BeatmapInfo.Ruleset = ruleset;
 
                     // TODO: this should be done in a better place once we actually need to dynamically update it.
-                    beatmap.BeatmapInfo.StarDifficulty = ruleset?.CreateInstance().CreateDifficultyCalculator(new DummyConversionBeatmap(beatmap)).Calculate().StarRating ?? 0;
+                    beatmap.BeatmapInfo.StarRating = ruleset?.CreateInstance().CreateDifficultyCalculator(new DummyConversionBeatmap(beatmap)).Calculate().StarRating ?? 0;
                     beatmap.BeatmapInfo.Length = calculateLength(beatmap);
                     beatmap.BeatmapInfo.BPM = 60000 / beatmap.GetMostCommonBeatLength();
 
diff --git a/osu.Game/Beatmaps/BeatmapSetInfo.cs b/osu.Game/Beatmaps/BeatmapSetInfo.cs
index 638366c580..0c93c4b9db 100644
--- a/osu.Game/Beatmaps/BeatmapSetInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapSetInfo.cs
@@ -38,7 +38,7 @@ namespace osu.Game.Beatmaps
         /// <summary>
         /// The maximum star difficulty of all beatmaps in this set.
         /// </summary>
-        public double MaxStarDifficulty => Beatmaps?.Max(b => b.StarDifficulty) ?? 0;
+        public double MaxStarDifficulty => Beatmaps?.Max(b => b.StarRating) ?? 0;
 
         /// <summary>
         /// The maximum playable length in milliseconds of all beatmaps in this set.
diff --git a/osu.Game/Beatmaps/DifficultyRecommender.cs b/osu.Game/Beatmaps/DifficultyRecommender.cs
index 86f5e0dabf..a2bd7c6ce9 100644
--- a/osu.Game/Beatmaps/DifficultyRecommender.cs
+++ b/osu.Game/Beatmaps/DifficultyRecommender.cs
@@ -64,7 +64,7 @@ namespace osu.Game.Beatmaps
 
                 BeatmapInfo beatmapInfo = beatmaps.Where(b => b.Ruleset.Equals(r)).OrderBy(b =>
                 {
-                    double difference = b.StarDifficulty - recommendation;
+                    double difference = b.StarRating - recommendation;
                     return difference >= 0 ? difference * 2 : difference * -1; // prefer easier over harder
                 }).FirstOrDefault();
 
diff --git a/osu.Game/Screens/Edit/Editor.cs b/osu.Game/Screens/Edit/Editor.cs
index de265ad94b..0ca7038580 100644
--- a/osu.Game/Screens/Edit/Editor.cs
+++ b/osu.Game/Screens/Edit/Editor.cs
@@ -723,7 +723,7 @@ namespace osu.Game.Screens.Edit
                 if (difficultyItems.Count > 0)
                     difficultyItems.Add(new EditorMenuItemSpacer());
 
-                foreach (var beatmap in rulesetBeatmaps.OrderBy(b => b.StarDifficulty))
+                foreach (var beatmap in rulesetBeatmaps.OrderBy(b => b.StarRating))
                     difficultyItems.Add(createDifficultyMenuItem(beatmap));
             }
 
diff --git a/osu.Game/Screens/Select/Carousel/CarouselBeatmap.cs b/osu.Game/Screens/Select/Carousel/CarouselBeatmap.cs
index fa96e6dde7..1334784613 100644
--- a/osu.Game/Screens/Select/Carousel/CarouselBeatmap.cs
+++ b/osu.Game/Screens/Select/Carousel/CarouselBeatmap.cs
@@ -38,7 +38,7 @@ namespace osu.Game.Screens.Select.Carousel
                 return;
             }
 
-            match &= !criteria.StarDifficulty.HasFilter || criteria.StarDifficulty.IsInRange(BeatmapInfo.StarDifficulty);
+            match &= !criteria.StarDifficulty.HasFilter || criteria.StarDifficulty.IsInRange(BeatmapInfo.StarRating);
             match &= !criteria.ApproachRate.HasFilter || criteria.ApproachRate.IsInRange(BeatmapInfo.BaseDifficulty.ApproachRate);
             match &= !criteria.DrainRate.HasFilter || criteria.DrainRate.IsInRange(BeatmapInfo.BaseDifficulty.DrainRate);
             match &= !criteria.CircleSize.HasFilter || criteria.CircleSize.IsInRange(BeatmapInfo.BaseDifficulty.CircleSize);
@@ -53,7 +53,7 @@ namespace osu.Game.Screens.Select.Carousel
             match &= !criteria.Artist.HasFilter || criteria.Artist.Matches(BeatmapInfo.Metadata.Artist) ||
                      criteria.Artist.Matches(BeatmapInfo.Metadata.ArtistUnicode);
 
-            match &= !criteria.UserStarDifficulty.HasFilter || criteria.UserStarDifficulty.IsInRange(BeatmapInfo.StarDifficulty);
+            match &= !criteria.UserStarDifficulty.HasFilter || criteria.UserStarDifficulty.IsInRange(BeatmapInfo.StarRating);
 
             if (match)
             {
@@ -92,7 +92,7 @@ namespace osu.Game.Screens.Select.Carousel
                     int ruleset = BeatmapInfo.RulesetID.CompareTo(otherBeatmap.BeatmapInfo.RulesetID);
                     if (ruleset != 0) return ruleset;
 
-                    return BeatmapInfo.StarDifficulty.CompareTo(otherBeatmap.BeatmapInfo.StarDifficulty);
+                    return BeatmapInfo.StarRating.CompareTo(otherBeatmap.BeatmapInfo.StarRating);
             }
         }
 
diff --git a/osu.Game/Screens/Select/Carousel/CarouselBeatmapSet.cs b/osu.Game/Screens/Select/Carousel/CarouselBeatmapSet.cs
index e465f423bc..9e411d5daa 100644
--- a/osu.Game/Screens/Select/Carousel/CarouselBeatmapSet.cs
+++ b/osu.Game/Screens/Select/Carousel/CarouselBeatmapSet.cs
@@ -84,7 +84,7 @@ namespace osu.Game.Screens.Select.Carousel
                     return compareUsingAggregateMax(otherSet, b => b.Length);
 
                 case SortMode.Difficulty:
-                    return compareUsingAggregateMax(otherSet, b => b.StarDifficulty);
+                    return compareUsingAggregateMax(otherSet, b => b.StarRating);
             }
         }
 
diff --git a/osu.Game/Tests/Visual/OsuTestScene.cs b/osu.Game/Tests/Visual/OsuTestScene.cs
index 83e1423504..55a3a6874e 100644
--- a/osu.Game/Tests/Visual/OsuTestScene.cs
+++ b/osu.Game/Tests/Visual/OsuTestScene.cs
@@ -228,7 +228,7 @@ namespace osu.Game.Tests.Visual
                         Checksum = beatmap.MD5Hash,
                         AuthorID = beatmap.Metadata.Author.OnlineID,
                         RulesetID = beatmap.RulesetID,
-                        StarRating = beatmap.StarDifficulty,
+                        StarRating = beatmap.StarRating,
                         DifficultyName = beatmap.Version,
                     }
                 }

From 51a353e12db189f9958228d30fe045b8460c6b92 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 11 Nov 2021 17:19:53 +0900
Subject: [PATCH 0916/5547] Rename `BeatmapInfo.Version` to `DifficultyName` to
 match underlying interface

---
 .../Editor/TestSceneEditorSaving.cs                       | 4 ++--
 .../Beatmaps/Formats/LegacyBeatmapDecoderTest.cs          | 2 +-
 osu.Game.Tests/Beatmaps/IO/ImportBeatmapTest.cs           | 6 +++---
 osu.Game.Tests/Beatmaps/ToStringFormattingTest.cs         | 2 +-
 osu.Game.Tests/NonVisual/Filtering/FilterMatchingTest.cs  | 2 +-
 osu.Game.Tests/Visual/Editing/TestSceneEditorSaving.cs    | 4 ++--
 .../Visual/Multiplayer/TestScenePlaylistsSongSelect.cs    | 2 +-
 .../Visual/SongSelect/TestSceneBeatmapCarousel.cs         | 6 +++---
 .../Visual/SongSelect/TestSceneBeatmapInfoWedge.cs        | 4 ++--
 .../Visual/SongSelect/TestSceneBeatmapMetadataDisplay.cs  | 4 ++--
 .../Visual/SongSelect/TestSceneBeatmapRecommendations.cs  | 2 +-
 .../Visual/SongSelect/TestScenePlaySongSelect.cs          | 2 +-
 .../Visual/UserInterface/TestSceneDeleteLocalScore.cs     | 2 +-
 osu.Game/Beatmaps/Beatmap.cs                              | 2 +-
 osu.Game/Beatmaps/BeatmapInfo.cs                          | 8 ++------
 osu.Game/Beatmaps/BeatmapModelManager.cs                  | 2 +-
 osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs         | 2 +-
 osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs         | 2 +-
 .../Screens/Edit/Components/Menus/DifficultyMenuItem.cs   | 2 +-
 osu.Game/Screens/Edit/Setup/MetadataSection.cs            | 4 ++--
 osu.Game/Screens/Play/BeatmapMetadataDisplay.cs           | 2 +-
 .../Ranking/Expanded/ExpandedPanelMiddleContent.cs        | 2 +-
 osu.Game/Screens/Select/BeatmapInfoWedge.cs               | 4 ++--
 .../Screens/Select/Carousel/DrawableCarouselBeatmap.cs    | 2 +-
 osu.Game/Stores/BeatmapImporter.cs                        | 2 +-
 osu.Game/Tests/Visual/OsuTestScene.cs                     | 2 +-
 26 files changed, 37 insertions(+), 41 deletions(-)

diff --git a/osu.Game.Rulesets.Taiko.Tests/Editor/TestSceneEditorSaving.cs b/osu.Game.Rulesets.Taiko.Tests/Editor/TestSceneEditorSaving.cs
index 159a64d1ac..42ab84714a 100644
--- a/osu.Game.Rulesets.Taiko.Tests/Editor/TestSceneEditorSaving.cs
+++ b/osu.Game.Rulesets.Taiko.Tests/Editor/TestSceneEditorSaving.cs
@@ -51,7 +51,7 @@ namespace osu.Game.Rulesets.Taiko.Tests.Editor
                 editorBeatmap.BeatmapInfo.Metadata.Artist = "artist";
                 editorBeatmap.BeatmapInfo.Metadata.Title = "title";
             });
-            AddStep("Set difficulty name", () => editorBeatmap.BeatmapInfo.Version = "difficulty");
+            AddStep("Set difficulty name", () => editorBeatmap.BeatmapInfo.DifficultyName = "difficulty");
 
             checkMutations();
 
@@ -85,7 +85,7 @@ namespace osu.Game.Rulesets.Taiko.Tests.Editor
                 return Precision.AlmostEquals(taikoDifficulty.SliderMultiplier, 2);
             });
             AddAssert("Beatmap has correct metadata", () => editorBeatmap.BeatmapInfo.Metadata.Artist == "artist" && editorBeatmap.BeatmapInfo.Metadata.Title == "title");
-            AddAssert("Beatmap has correct difficulty name", () => editorBeatmap.BeatmapInfo.Version == "difficulty");
+            AddAssert("Beatmap has correct difficulty name", () => editorBeatmap.BeatmapInfo.DifficultyName == "difficulty");
         }
     }
 }
diff --git a/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs b/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs
index 0bd7c19200..304a65e5c7 100644
--- a/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs
+++ b/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs
@@ -113,7 +113,7 @@ namespace osu.Game.Tests.Beatmaps.Formats
                 Assert.AreEqual("Soleily", metadata.Artist);
                 Assert.AreEqual("Soleily", metadata.ArtistUnicode);
                 Assert.AreEqual("Gamu", metadata.Author.Username);
-                Assert.AreEqual("Insane", beatmapInfo.Version);
+                Assert.AreEqual("Insane", beatmapInfo.DifficultyName);
                 Assert.AreEqual(string.Empty, metadata.Source);
                 Assert.AreEqual("MBC7 Unisphere 地球ヤバイEP Chikyu Yabai", metadata.Tags);
                 Assert.AreEqual(557821, beatmapInfo.OnlineBeatmapID);
diff --git a/osu.Game.Tests/Beatmaps/IO/ImportBeatmapTest.cs b/osu.Game.Tests/Beatmaps/IO/ImportBeatmapTest.cs
index a19e977c1a..3093a5719d 100644
--- a/osu.Game.Tests/Beatmaps/IO/ImportBeatmapTest.cs
+++ b/osu.Game.Tests/Beatmaps/IO/ImportBeatmapTest.cs
@@ -790,12 +790,12 @@ namespace osu.Game.Tests.Beatmaps.IO
                     // Update via the beatmap, not the beatmap info, to ensure correct linking
                     BeatmapSetInfo setToUpdate = manager.GetAllUsableBeatmapSets()[0];
                     Beatmap beatmapToUpdate = (Beatmap)manager.GetWorkingBeatmap(setToUpdate.Beatmaps.First(b => b.RulesetID == 0)).Beatmap;
-                    beatmapToUpdate.BeatmapInfo.Version = "updated";
+                    beatmapToUpdate.BeatmapInfo.DifficultyName = "updated";
 
                     manager.Update(setToUpdate);
 
                     BeatmapInfo updatedInfo = manager.QueryBeatmap(b => b.ID == beatmapToUpdate.BeatmapInfo.ID);
-                    Assert.That(updatedInfo.Version, Is.EqualTo("updated"));
+                    Assert.That(updatedInfo.DifficultyName, Is.EqualTo("updated"));
                 }
                 finally
                 {
@@ -863,7 +863,7 @@ namespace osu.Game.Tests.Beatmaps.IO
 
                     var beatmap = working.Beatmap;
 
-                    beatmap.BeatmapInfo.Version = "difficulty";
+                    beatmap.BeatmapInfo.DifficultyName = "difficulty";
                     beatmap.BeatmapInfo.Metadata = new BeatmapMetadata
                     {
                         Artist = "Artist/With\\Slashes",
diff --git a/osu.Game.Tests/Beatmaps/ToStringFormattingTest.cs b/osu.Game.Tests/Beatmaps/ToStringFormattingTest.cs
index da7f32a2d3..4a7d7505ad 100644
--- a/osu.Game.Tests/Beatmaps/ToStringFormattingTest.cs
+++ b/osu.Game.Tests/Beatmaps/ToStringFormattingTest.cs
@@ -52,7 +52,7 @@ namespace osu.Game.Tests.Beatmaps
                     Title = "title",
                     Author = new APIUser { Username = "creator" }
                 },
-                Version = "difficulty"
+                DifficultyName = "difficulty"
             };
 
             Assert.That(beatmap.ToString(), Is.EqualTo("artist - title (creator) [difficulty]"));
diff --git a/osu.Game.Tests/NonVisual/Filtering/FilterMatchingTest.cs b/osu.Game.Tests/NonVisual/Filtering/FilterMatchingTest.cs
index 743d11541d..ec97948532 100644
--- a/osu.Game.Tests/NonVisual/Filtering/FilterMatchingTest.cs
+++ b/osu.Game.Tests/NonVisual/Filtering/FilterMatchingTest.cs
@@ -34,7 +34,7 @@ namespace osu.Game.Tests.NonVisual.Filtering
                 Source = "unit tests",
                 Tags = "look for tags too",
             },
-            Version = "version as well",
+            DifficultyName = "version as well",
             Length = 2500,
             BPM = 160,
             BeatDivisor = 12,
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneEditorSaving.cs b/osu.Game.Tests/Visual/Editing/TestSceneEditorSaving.cs
index af3d9beb69..e1e869cfbf 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneEditorSaving.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneEditorSaving.cs
@@ -46,7 +46,7 @@ namespace osu.Game.Tests.Visual.Editing
                 editorBeatmap.BeatmapInfo.Metadata.Artist = "artist";
                 editorBeatmap.BeatmapInfo.Metadata.Title = "title";
             });
-            AddStep("Set difficulty name", () => editorBeatmap.BeatmapInfo.Version = "difficulty");
+            AddStep("Set difficulty name", () => editorBeatmap.BeatmapInfo.DifficultyName = "difficulty");
 
             AddStep("Add timing point", () => editorBeatmap.ControlPointInfo.Add(0, new TimingControlPoint()));
 
@@ -85,7 +85,7 @@ namespace osu.Game.Tests.Visual.Editing
             AddAssert("Beatmap contains single hitcircle", () => editorBeatmap.HitObjects.Count == 1);
             AddAssert("Beatmap has correct overall difficulty", () => editorBeatmap.Difficulty.OverallDifficulty == 7);
             AddAssert("Beatmap has correct metadata", () => editorBeatmap.BeatmapInfo.Metadata.Artist == "artist" && editorBeatmap.BeatmapInfo.Metadata.Title == "title");
-            AddAssert("Beatmap has correct difficulty name", () => editorBeatmap.BeatmapInfo.Version == "difficulty");
+            AddAssert("Beatmap has correct difficulty name", () => editorBeatmap.BeatmapInfo.DifficultyName == "difficulty");
         }
     }
 }
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsSongSelect.cs b/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsSongSelect.cs
index ba30315663..5e55759e01 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsSongSelect.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsSongSelect.cs
@@ -55,7 +55,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 {
                     Ruleset = new OsuRuleset().RulesetInfo,
                     OnlineBeatmapID = beatmapId,
-                    Version = $"{beatmapId} (length {TimeSpan.FromMilliseconds(length):m\\:ss}, bpm {bpm:0.#})",
+                    DifficultyName = $"{beatmapId} (length {TimeSpan.FromMilliseconds(length):m\\:ss}, bpm {bpm:0.#})",
                     Length = length,
                     BPM = bpm,
                     BaseDifficulty = new BeatmapDifficulty
diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs
index 3a5af6811d..03079fdc5f 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs
@@ -684,7 +684,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                 {
                     set.Beatmaps.Add(new BeatmapInfo
                     {
-                        Version = $"Stars: {i}",
+                        DifficultyName = $"Stars: {i}",
                         Ruleset = new OsuRuleset().RulesetInfo,
                         StarRating = i,
                     });
@@ -868,7 +868,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                 yield return new BeatmapInfo
                 {
                     OnlineBeatmapID = id++ * 10,
-                    Version = version,
+                    DifficultyName = version,
                     StarRating = diff,
                     Ruleset = new OsuRuleset().RulesetInfo,
                     BaseDifficulty = new BeatmapDifficulty
@@ -902,7 +902,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                 {
                     OnlineBeatmapID = b * 10,
                     Path = $"extra{b}.osu",
-                    Version = $"Extra {b}",
+                    DifficultyName = $"Extra {b}",
                     Ruleset = rulesets.GetRuleset((b - 1) % 4),
                     StarRating = 2,
                     BaseDifficulty = new BeatmapDifficulty
diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapInfoWedge.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapInfoWedge.cs
index 666969eb2a..1b070c00bf 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapInfoWedge.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapInfoWedge.cs
@@ -199,7 +199,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                     },
                     Ruleset = ruleset,
                     StarRating = 6,
-                    Version = $"{ruleset.ShortName}Version",
+                    DifficultyName = $"{ruleset.ShortName}Version",
                     BaseDifficulty = new BeatmapDifficulty()
                 },
                 HitObjects = objects
@@ -219,7 +219,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                         Source = "Verrrrry long Source",
                         Title = "Verrrrry long Title"
                     },
-                    Version = "Verrrrrrrrrrrrrrrrrrrrrrrrrrrrry long Version",
+                    DifficultyName = "Verrrrrrrrrrrrrrrrrrrrrrrrrrrrry long Version",
                     Status = BeatmapSetOnlineStatus.Graveyard,
                 },
             };
diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapMetadataDisplay.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapMetadataDisplay.cs
index 574ccce6d5..9473b058cc 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapMetadataDisplay.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapMetadataDisplay.cs
@@ -45,7 +45,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                     {
                         Title = title,
                     },
-                    Version = version,
+                    DifficultyName = version,
                     StarRating = RNG.NextDouble(0, 10),
                 }
             }));
@@ -64,7 +64,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                     {
                         Title = "Heavy beatmap",
                     },
-                    Version = "10k objects",
+                    DifficultyName = "10k objects",
                     StarRating = 99.99f,
                 }
             }));
diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapRecommendations.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapRecommendations.cs
index 2c41ea1f53..57f2d436c5 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapRecommendations.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapRecommendations.cs
@@ -189,7 +189,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                     BaseDifficulty = new BeatmapDifficulty(),
                     Ruleset = ruleset,
                     StarRating = difficultyIndex + 1,
-                    Version = $"SR{difficultyIndex + 1}"
+                    DifficultyName = $"SR{difficultyIndex + 1}"
                 }).ToList()
             };
 
diff --git a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
index 4861354921..a0d78fff58 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
@@ -919,7 +919,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                 {
                     Ruleset = getRuleset(),
                     OnlineBeatmapID = beatmapId,
-                    Version = $"{beatmapId} (length {TimeSpan.FromMilliseconds(length):m\\:ss}, bpm {bpm:0.#})",
+                    DifficultyName = $"{beatmapId} (length {TimeSpan.FromMilliseconds(length):m\\:ss}, bpm {bpm:0.#})",
                     Length = length,
                     BPM = bpm,
                     BaseDifficulty = new BeatmapDifficulty
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
index 07759d598e..7353e47229 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
@@ -69,7 +69,7 @@ namespace osu.Game.Tests.Visual.UserInterface
                                     Username = "TestAuthor"
                                 },
                             },
-                            Version = "Insane"
+                            DifficultyName = "Insane"
                         },
                     }
                 },
diff --git a/osu.Game/Beatmaps/Beatmap.cs b/osu.Game/Beatmaps/Beatmap.cs
index 98087994b7..f69a10f000 100644
--- a/osu.Game/Beatmaps/Beatmap.cs
+++ b/osu.Game/Beatmaps/Beatmap.cs
@@ -56,7 +56,7 @@ namespace osu.Game.Beatmaps
                     Title = @"Unknown",
                     AuthorString = @"Unknown Creator",
                 },
-                Version = @"Normal",
+                DifficultyName = @"Normal",
                 BaseDifficulty = Difficulty,
             };
         }
diff --git a/osu.Game/Beatmaps/BeatmapInfo.cs b/osu.Game/Beatmaps/BeatmapInfo.cs
index 613b0599a0..5bbd48f26d 100644
--- a/osu.Game/Beatmaps/BeatmapInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapInfo.cs
@@ -134,9 +134,8 @@ namespace osu.Game.Beatmaps
         public double TimelineZoom { get; set; }
 
         // Metadata
-        public string Version { get; set; }
-
-        private string versionString => string.IsNullOrEmpty(Version) ? string.Empty : $"[{Version}]";
+        [Column("Version")]
+        public string DifficultyName { get; set; }
 
         [JsonProperty("difficulty_rating")]
         [Column("StarDifficulty")]
@@ -183,9 +182,6 @@ namespace osu.Game.Beatmaps
 
         #region Implementation of IBeatmapInfo
 
-        [JsonIgnore]
-        string IBeatmapInfo.DifficultyName => Version;
-
         [JsonIgnore]
         IBeatmapMetadataInfo IBeatmapInfo.Metadata => Metadata ?? BeatmapSet?.Metadata ?? new BeatmapMetadata();
 
diff --git a/osu.Game/Beatmaps/BeatmapModelManager.cs b/osu.Game/Beatmaps/BeatmapModelManager.cs
index d166f42cde..ff4305dc91 100644
--- a/osu.Game/Beatmaps/BeatmapModelManager.cs
+++ b/osu.Game/Beatmaps/BeatmapModelManager.cs
@@ -215,7 +215,7 @@ namespace osu.Game.Beatmaps
                     var fileInfo = setInfo.Files.SingleOrDefault(f => string.Equals(f.Filename, beatmapInfo.Path, StringComparison.OrdinalIgnoreCase)) ?? new BeatmapSetFileInfo();
 
                     // metadata may have changed; update the path with the standard format.
-                    beatmapInfo.Path = GetValidFilename($"{metadata.Artist} - {metadata.Title} ({metadata.Author}) [{beatmapInfo.Version}].osu");
+                    beatmapInfo.Path = GetValidFilename($"{metadata.Artist} - {metadata.Title} ({metadata.Author}) [{beatmapInfo.DifficultyName}].osu");
 
                     beatmapInfo.MD5Hash = stream.ComputeMD5Hash();
 
diff --git a/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs b/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
index bef2d78f21..f0c19f80f3 100644
--- a/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
+++ b/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
@@ -251,7 +251,7 @@ namespace osu.Game.Beatmaps.Formats
                     break;
 
                 case @"Version":
-                    beatmap.BeatmapInfo.Version = pair.Value;
+                    beatmap.BeatmapInfo.DifficultyName = pair.Value;
                     break;
 
                 case @"Source":
diff --git a/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs b/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs
index 9117da5d32..bcb14526c7 100644
--- a/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs
+++ b/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs
@@ -130,7 +130,7 @@ namespace osu.Game.Beatmaps.Formats
             writer.WriteLine(FormattableString.Invariant($"Artist: {beatmap.Metadata.Artist}"));
             if (!string.IsNullOrEmpty(beatmap.Metadata.ArtistUnicode)) writer.WriteLine(FormattableString.Invariant($"ArtistUnicode: {beatmap.Metadata.ArtistUnicode}"));
             writer.WriteLine(FormattableString.Invariant($"Creator: {beatmap.Metadata.Author.Username}"));
-            writer.WriteLine(FormattableString.Invariant($"Version: {beatmap.BeatmapInfo.Version}"));
+            writer.WriteLine(FormattableString.Invariant($"Version: {beatmap.BeatmapInfo.DifficultyName}"));
             if (!string.IsNullOrEmpty(beatmap.Metadata.Source)) writer.WriteLine(FormattableString.Invariant($"Source: {beatmap.Metadata.Source}"));
             if (!string.IsNullOrEmpty(beatmap.Metadata.Tags)) writer.WriteLine(FormattableString.Invariant($"Tags: {beatmap.Metadata.Tags}"));
             if (beatmap.BeatmapInfo.OnlineBeatmapID != null) writer.WriteLine(FormattableString.Invariant($"BeatmapID: {beatmap.BeatmapInfo.OnlineBeatmapID}"));
diff --git a/osu.Game/Screens/Edit/Components/Menus/DifficultyMenuItem.cs b/osu.Game/Screens/Edit/Components/Menus/DifficultyMenuItem.cs
index c458b65607..75dc479c25 100644
--- a/osu.Game/Screens/Edit/Components/Menus/DifficultyMenuItem.cs
+++ b/osu.Game/Screens/Edit/Components/Menus/DifficultyMenuItem.cs
@@ -13,7 +13,7 @@ namespace osu.Game.Screens.Edit.Components.Menus
         public BeatmapInfo BeatmapInfo { get; }
 
         public DifficultyMenuItem(BeatmapInfo beatmapInfo, bool selected, Action<BeatmapInfo> difficultyChangeFunc)
-            : base(beatmapInfo.Version ?? "(unnamed)", null)
+            : base(beatmapInfo.DifficultyName ?? "(unnamed)", null)
         {
             BeatmapInfo = beatmapInfo;
             State.Value = selected;
diff --git a/osu.Game/Screens/Edit/Setup/MetadataSection.cs b/osu.Game/Screens/Edit/Setup/MetadataSection.cs
index 34c2fa8480..0d2b093a2e 100644
--- a/osu.Game/Screens/Edit/Setup/MetadataSection.cs
+++ b/osu.Game/Screens/Edit/Setup/MetadataSection.cs
@@ -47,7 +47,7 @@ namespace osu.Game.Screens.Edit.Setup
                 Empty(),
 
                 creatorTextBox = createTextBox<LabelledTextBox>("Creator", metadata.Author.Username),
-                difficultyTextBox = createTextBox<LabelledTextBox>("Difficulty Name", Beatmap.BeatmapInfo.Version),
+                difficultyTextBox = createTextBox<LabelledTextBox>("Difficulty Name", Beatmap.BeatmapInfo.DifficultyName),
                 sourceTextBox = createTextBox<LabelledTextBox>("Source", metadata.Source),
                 tagsTextBox = createTextBox<LabelledTextBox>("Tags", metadata.Tags)
             };
@@ -111,7 +111,7 @@ namespace osu.Game.Screens.Edit.Setup
             Beatmap.Metadata.Title = RomanisedTitleTextBox.Current.Value;
 
             Beatmap.Metadata.AuthorString = creatorTextBox.Current.Value;
-            Beatmap.BeatmapInfo.Version = difficultyTextBox.Current.Value;
+            Beatmap.BeatmapInfo.DifficultyName = difficultyTextBox.Current.Value;
             Beatmap.Metadata.Source = sourceTextBox.Current.Value;
             Beatmap.Metadata.Tags = tagsTextBox.Current.Value;
         }
diff --git a/osu.Game/Screens/Play/BeatmapMetadataDisplay.cs b/osu.Game/Screens/Play/BeatmapMetadataDisplay.cs
index 909f0a2b65..430571e1da 100644
--- a/osu.Game/Screens/Play/BeatmapMetadataDisplay.cs
+++ b/osu.Game/Screens/Play/BeatmapMetadataDisplay.cs
@@ -126,7 +126,7 @@ namespace osu.Game.Screens.Play
                             {
                                 new OsuSpriteText
                                 {
-                                    Text = beatmap?.BeatmapInfo?.Version,
+                                    Text = beatmap?.BeatmapInfo?.DifficultyName,
                                     Font = OsuFont.GetFont(size: 26, italics: true),
                                     Anchor = Anchor.TopCentre,
                                     Origin = Anchor.TopCentre,
diff --git a/osu.Game/Screens/Ranking/Expanded/ExpandedPanelMiddleContent.cs b/osu.Game/Screens/Ranking/Expanded/ExpandedPanelMiddleContent.cs
index 29b9d6164e..e31a182a49 100644
--- a/osu.Game/Screens/Ranking/Expanded/ExpandedPanelMiddleContent.cs
+++ b/osu.Game/Screens/Ranking/Expanded/ExpandedPanelMiddleContent.cs
@@ -164,7 +164,7 @@ namespace osu.Game.Screens.Ranking.Expanded
                                     {
                                         Anchor = Anchor.TopCentre,
                                         Origin = Anchor.TopCentre,
-                                        Text = beatmap.Version,
+                                        Text = beatmap.DifficultyName,
                                         Font = OsuFont.Torus.With(size: 16, weight: FontWeight.SemiBold),
                                     },
                                     new OsuTextFlowContainer(s => s.Font = OsuFont.Torus.With(size: 12))
diff --git a/osu.Game/Screens/Select/BeatmapInfoWedge.cs b/osu.Game/Screens/Select/BeatmapInfoWedge.cs
index e344da4027..e4cf9bd868 100644
--- a/osu.Game/Screens/Select/BeatmapInfoWedge.cs
+++ b/osu.Game/Screens/Select/BeatmapInfoWedge.cs
@@ -229,7 +229,7 @@ namespace osu.Game.Screens.Select
                         {
                             VersionLabel = new OsuSpriteText
                             {
-                                Text = beatmapInfo.Version,
+                                Text = beatmapInfo.DifficultyName,
                                 Font = OsuFont.GetFont(size: 24, italics: true),
                                 RelativeSizeAxes = Axes.X,
                                 Truncate = true,
@@ -324,7 +324,7 @@ namespace osu.Game.Screens.Select
                 });
 
                 // no difficulty means it can't have a status to show
-                if (beatmapInfo.Version == null)
+                if (beatmapInfo.DifficultyName == null)
                     StatusPill.Hide();
 
                 addInfoLabels();
diff --git a/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmap.cs b/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmap.cs
index 5940911d4a..f30bec5d2b 100644
--- a/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmap.cs
+++ b/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmap.cs
@@ -129,7 +129,7 @@ namespace osu.Game.Screens.Select.Carousel
                                     {
                                         new OsuSpriteText
                                         {
-                                            Text = beatmapInfo.Version,
+                                            Text = beatmapInfo.DifficultyName,
                                             Font = OsuFont.GetFont(size: 20),
                                             Anchor = Anchor.BottomLeft,
                                             Origin = Anchor.BottomLeft
diff --git a/osu.Game/Stores/BeatmapImporter.cs b/osu.Game/Stores/BeatmapImporter.cs
index 1ac73cf781..01bf925547 100644
--- a/osu.Game/Stores/BeatmapImporter.cs
+++ b/osu.Game/Stores/BeatmapImporter.cs
@@ -253,7 +253,7 @@ namespace osu.Game.Stores
                     var beatmap = new RealmBeatmap(ruleset, difficulty, metadata)
                     {
                         Hash = hash,
-                        DifficultyName = decodedInfo.Version,
+                        DifficultyName = decodedInfo.DifficultyName,
                         OnlineID = decodedInfo.OnlineBeatmapID ?? -1,
                         AudioLeadIn = decodedInfo.AudioLeadIn,
                         StackLeniency = decodedInfo.StackLeniency,
diff --git a/osu.Game/Tests/Visual/OsuTestScene.cs b/osu.Game/Tests/Visual/OsuTestScene.cs
index 55a3a6874e..a4cef02395 100644
--- a/osu.Game/Tests/Visual/OsuTestScene.cs
+++ b/osu.Game/Tests/Visual/OsuTestScene.cs
@@ -229,7 +229,7 @@ namespace osu.Game.Tests.Visual
                         AuthorID = beatmap.Metadata.Author.OnlineID,
                         RulesetID = beatmap.RulesetID,
                         StarRating = beatmap.StarRating,
-                        DifficultyName = beatmap.Version,
+                        DifficultyName = beatmap.DifficultyName,
                     }
                 }
             };

From 4bca96d548b72725164ffdc73844ac4644bb26af Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 11 Nov 2021 17:37:43 +0900
Subject: [PATCH 0917/5547] Throw again to ensure correct available state is
 set

Also standardises handling between `RulesetStore` and `RealmRulesetStore`.
---
 osu.Game/Rulesets/RulesetLoadException.cs | 15 +++++++++++++++
 osu.Game/Rulesets/RulesetStore.cs         | 18 ++++++++----------
 osu.Game/Stores/RealmRulesetStore.cs      | 18 +++++++-----------
 3 files changed, 30 insertions(+), 21 deletions(-)
 create mode 100644 osu.Game/Rulesets/RulesetLoadException.cs

diff --git a/osu.Game/Rulesets/RulesetLoadException.cs b/osu.Game/Rulesets/RulesetLoadException.cs
new file mode 100644
index 0000000000..7c3a4bb75d
--- /dev/null
+++ b/osu.Game/Rulesets/RulesetLoadException.cs
@@ -0,0 +1,15 @@
+// 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.Rulesets
+{
+    public class RulesetLoadException : Exception
+    {
+        public RulesetLoadException(string message)
+            : base(@$"Ruleset could not be loaded ({message})")
+        {
+        }
+    }
+}
diff --git a/osu.Game/Rulesets/RulesetStore.cs b/osu.Game/Rulesets/RulesetStore.cs
index 1ddd5396f4..6dd036c0e6 100644
--- a/osu.Game/Rulesets/RulesetStore.cs
+++ b/osu.Game/Rulesets/RulesetStore.cs
@@ -128,18 +128,16 @@ namespace osu.Game.Rulesets
                 {
                     try
                     {
-                        var resolvedType = Type.GetType(r.InstantiationInfo);
+                        var resolvedType = Type.GetType(r.InstantiationInfo)
+                                           ?? throw new RulesetLoadException(@"Type could not be resolved");
 
-                        if (resolvedType != null)
-                        {
-                            var instanceInfo = ((Ruleset)Activator.CreateInstance(resolvedType)).RulesetInfo;
+                        var instanceInfo = (Activator.CreateInstance(resolvedType) as Ruleset)?.RulesetInfo
+                                           ?? throw new RulesetLoadException(@"Instantiation failure");
 
-                            r.Name = instanceInfo.Name;
-                            r.ShortName = instanceInfo.ShortName;
-                            r.InstantiationInfo = instanceInfo.InstantiationInfo;
-
-                            r.Available = true;
-                        }
+                        r.Name = instanceInfo.Name;
+                        r.ShortName = instanceInfo.ShortName;
+                        r.InstantiationInfo = instanceInfo.InstantiationInfo;
+                        r.Available = true;
                     }
                     catch
                     {
diff --git a/osu.Game/Stores/RealmRulesetStore.cs b/osu.Game/Stores/RealmRulesetStore.cs
index 0d2cddf874..cf9ffd112c 100644
--- a/osu.Game/Stores/RealmRulesetStore.cs
+++ b/osu.Game/Stores/RealmRulesetStore.cs
@@ -147,19 +147,15 @@ namespace osu.Game.Stores
                     {
                         try
                         {
-                            var type = Type.GetType(r.InstantiationInfo);
+                            var resolvedType = Type.GetType(r.InstantiationInfo)
+                                               ?? throw new RulesetLoadException(@"Type could not be resolved");
 
-                            if (type == null)
-                                throw new InvalidOperationException(@"Type resolution failure.");
+                            var instanceInfo = (Activator.CreateInstance(resolvedType) as Ruleset)?.RulesetInfo
+                                               ?? throw new RulesetLoadException(@"Instantiation failure");
 
-                            var rInstance = (Activator.CreateInstance(type) as Ruleset)?.RulesetInfo;
-
-                            if (rInstance == null)
-                                throw new InvalidOperationException(@"Instantiation failure.");
-
-                            r.Name = rInstance.Name;
-                            r.ShortName = rInstance.ShortName;
-                            r.InstantiationInfo = rInstance.InstantiationInfo;
+                            r.Name = instanceInfo.Name;
+                            r.ShortName = instanceInfo.ShortName;
+                            r.InstantiationInfo = instanceInfo.InstantiationInfo;
                             r.Available = true;
 
                             detachedRulesets.Add(r.Clone());

From 53e52d2c4b8f32eb7ce07cb7c2ed8a8cae05c5a3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 11 Nov 2021 10:04:16 +0100
Subject: [PATCH 0918/5547] Fix Android builds failing due to Xamarin-side
 regression

---
 .github/workflows/ci.yml | 17 ++++++++++++-----
 1 file changed, 12 insertions(+), 5 deletions(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 2a3b2fd978..68f8ef51ef 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -52,22 +52,29 @@ jobs:
 
   build-only-android:
     name: Build only (Android)
-    runs-on: windows-latest
+    runs-on: macos-latest
     timeout-minutes: 60
     steps:
       - name: Checkout
         uses: actions/checkout@v2
 
+      # Pin Xamarin.Android version to 11.2 for now to avoid build failures caused by a Xamarin-side regression.
+      # See: https://github.com/xamarin/xamarin-android/issues/6284
+      # This can be removed/reverted when the fix makes it to upstream and is deployed on github runners.
+      - name: Set default Xamarin SDK version
+        run: |
+            $VM_ASSETS/select-xamarin-sdk-v2.sh --mono=6.12 --android=11.2
+
       - name: Install .NET 5.0.x
         uses: actions/setup-dotnet@v1
         with:
           dotnet-version: "5.0.x"
 
-      - name: Setup MSBuild
-        uses: microsoft/setup-msbuild@v1
-
+      # Contrary to seemingly any other msbuild, msbuild running on macOS/Mono
+      # cannot accept .sln(f) files as arguments.
+      # Build just the main game for now.
       - name: Build
-        run: msbuild osu.Android.slnf /restore /p:Configuration=Debug
+        run: msbuild osu.Android/osu.Android.csproj /restore /p:Configuration=Debug
 
   build-only-ios:
     # While this workflow technically *can* run, it fails as iOS builds are blocked by multiple issues.

From 069ee6980f4297e0bec727ac0949e2a5eac3277f Mon Sep 17 00:00:00 2001
From: Jamie Taylor <me@nekodex.net>
Date: Thu, 11 Nov 2021 19:20:50 +0900
Subject: [PATCH 0919/5547] Add debounce to sample playback

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

diff --git a/osu.Game/Screens/Select/SongSelect.cs b/osu.Game/Screens/Select/SongSelect.cs
index 4943aac77c..4da15ee53c 100644
--- a/osu.Game/Screens/Select/SongSelect.cs
+++ b/osu.Game/Screens/Select/SongSelect.cs
@@ -105,6 +105,8 @@ namespace osu.Game.Screens.Select
 
         private readonly Bindable<RulesetInfo> decoupledRuleset = new Bindable<RulesetInfo>();
 
+        private double audioFeedbackLastPlaybackTime;
+
         [Resolved]
         private MusicController music { get; set; }
 
@@ -480,12 +482,14 @@ namespace osu.Game.Screens.Select
 
             if (beatmap != beatmapInfoPrevious)
             {
-                if (beatmap != null && beatmapInfoPrevious != null)
+                if (beatmap != null && beatmapInfoPrevious != null && Time.Current - audioFeedbackLastPlaybackTime >= 50)
                 {
                     if (beatmap.BeatmapSetInfoID == beatmapInfoPrevious.BeatmapSetInfoID)
                         sampleChangeDifficulty.Play();
                     else
                         sampleChangeBeatmap.Play();
+
+                    audioFeedbackLastPlaybackTime = Time.Current;
                 }
 
                 beatmapInfoPrevious = beatmap;

From 9bad912dd0eeafd7219ad902676327a255cf4ef0 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 11 Nov 2021 12:55:14 +0100
Subject: [PATCH 0920/5547] Add failing test case

---
 .../Visual/Gameplay/TestSceneUnstableRateCounter.cs    | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneUnstableRateCounter.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneUnstableRateCounter.cs
index 0dc25cf378..be20799479 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneUnstableRateCounter.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneUnstableRateCounter.cs
@@ -61,6 +61,16 @@ namespace osu.Game.Tests.Visual.Gameplay
             AddRepeatStep("Bring UR to 100", () => applyJudgement(-10, false), 10);
         }
 
+        [Test]
+        public void TestCounterReceivesJudgementsBeforeCreation()
+        {
+            AddRepeatStep("Set UR to 250", () => applyJudgement(25, true), 4);
+
+            AddStep("Create Display", recreateDisplay);
+
+            AddUntilStep("UR = 250", () => counter.Current.Value == 250.0);
+        }
+
         private void recreateDisplay()
         {
             Clear();

From 40cffd1682c25f9037e7f8ff22a1b3337afefcaf Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 11 Nov 2021 13:09:29 +0100
Subject: [PATCH 0921/5547] Expose `HitEvents` publically from `ScoreProcessor`

---
 osu.Game/Rulesets/Scoring/ScoreProcessor.cs | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/osu.Game/Rulesets/Scoring/ScoreProcessor.cs b/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
index c1234f8fb3..fc24972b8e 100644
--- a/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
+++ b/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
@@ -53,6 +53,12 @@ namespace osu.Game.Rulesets.Scoring
         /// </summary>
         public readonly Bindable<ScoringMode> Mode = new Bindable<ScoringMode>();
 
+        /// <summary>
+        /// The <see cref="HitEvent"/>s collected during gameplay thus far.
+        /// Intended for use with various statistics displays.
+        /// </summary>
+        public IReadOnlyList<HitEvent> HitEvents => hitEvents;
+
         /// <summary>
         /// The default portion of <see cref="max_score"/> awarded for hitting <see cref="HitObject"/>s accurately. Defaults to 30%.
         /// </summary>

From 69809390d37b4c4e4193562d5d84ac16a05ca590 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 11 Nov 2021 13:09:48 +0100
Subject: [PATCH 0922/5547] Fix HUD unstable rate counter not including
 judgements before load complete

Also unifies UR calculation logic with the results screen statistic item
to reduce duplication.
---
 .../NonVisual/Ranking/UnstableRateTest.cs     |  3 +-
 .../Rulesets/Scoring/HitEventExtensions.cs    | 37 +++++++++++++++
 .../Screens/Play/HUD/UnstableRateCounter.cs   | 46 ++++---------------
 .../Ranking/Statistics/UnstableRate.cs        | 20 ++------
 4 files changed, 52 insertions(+), 54 deletions(-)
 create mode 100644 osu.Game/Rulesets/Scoring/HitEventExtensions.cs

diff --git a/osu.Game.Tests/NonVisual/Ranking/UnstableRateTest.cs b/osu.Game.Tests/NonVisual/Ranking/UnstableRateTest.cs
index ad6f01881b..103831822c 100644
--- a/osu.Game.Tests/NonVisual/Ranking/UnstableRateTest.cs
+++ b/osu.Game.Tests/NonVisual/Ranking/UnstableRateTest.cs
@@ -22,7 +22,8 @@ namespace osu.Game.Tests.NonVisual.Ranking
 
             var unstableRate = new UnstableRate(events);
 
-            Assert.IsTrue(Precision.AlmostEquals(unstableRate.Value, 10 * Math.Sqrt(10)));
+            Assert.IsNotNull(unstableRate.Value);
+            Assert.IsTrue(Precision.AlmostEquals(unstableRate.Value.Value, 10 * Math.Sqrt(10)));
         }
 
         [Test]
diff --git a/osu.Game/Rulesets/Scoring/HitEventExtensions.cs b/osu.Game/Rulesets/Scoring/HitEventExtensions.cs
new file mode 100644
index 0000000000..f645b12483
--- /dev/null
+++ b/osu.Game/Rulesets/Scoring/HitEventExtensions.cs
@@ -0,0 +1,37 @@
+// 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;
+
+namespace osu.Game.Rulesets.Scoring
+{
+    public static class HitEventExtensions
+    {
+        /// <summary>
+        /// Calculates the "unstable rate" for a sequence of <see cref="HitEvent"/>s.
+        /// </summary>
+        /// <returns>
+        /// A non-null <see langword="double"/> value if unstable rate could be calculated,
+        /// and <see langword="null"/> if unstable rate cannot be calculated due to <paramref name="hitEvents"/> being empty.
+        /// </returns>
+        public static double? CalculateUnstableRate(this IEnumerable<HitEvent> hitEvents)
+        {
+            double[] timeOffsets = hitEvents.Where(affectsUnstableRate).Select(ev => ev.TimeOffset).ToArray();
+            return 10 * standardDeviation(timeOffsets);
+        }
+
+        private static bool affectsUnstableRate(HitEvent e) => !(e.HitObject.HitWindows is HitWindows.EmptyHitWindows) && e.Result.IsHit();
+
+        private static double? standardDeviation(double[] timeOffsets)
+        {
+            if (timeOffsets.Length == 0)
+                return null;
+
+            double mean = timeOffsets.Average();
+            double squares = timeOffsets.Select(offset => Math.Pow(offset - mean, 2)).Sum();
+            return Math.Sqrt(squares / timeOffsets.Length);
+        }
+    }
+}
diff --git a/osu.Game/Screens/Play/HUD/UnstableRateCounter.cs b/osu.Game/Screens/Play/HUD/UnstableRateCounter.cs
index 89ae4f8a21..4dc154fb9d 100644
--- a/osu.Game/Screens/Play/HUD/UnstableRateCounter.cs
+++ b/osu.Game/Screens/Play/HUD/UnstableRateCounter.cs
@@ -1,9 +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.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
@@ -29,8 +26,6 @@ namespace osu.Game.Screens.Play.HUD
         private const float alpha_when_invalid = 0.3f;
         private readonly Bindable<bool> valid = new Bindable<bool>();
 
-        private readonly List<double> hitOffsets = new List<double>();
-
         [Resolved]
         private ScoreProcessor scoreProcessor { get; set; }
 
@@ -54,41 +49,20 @@ namespace osu.Game.Screens.Play.HUD
         {
             base.LoadComplete();
 
-            scoreProcessor.NewJudgement += onJudgementAdded;
-            scoreProcessor.JudgementReverted += onJudgementReverted;
-        }
-
-        private void onJudgementAdded(JudgementResult judgement)
-        {
-            if (!changesUnstableRate(judgement)) return;
-
-            hitOffsets.Add(judgement.TimeOffset);
+            scoreProcessor.NewJudgement += updateDisplay;
+            scoreProcessor.JudgementReverted += updateDisplay;
             updateDisplay();
         }
 
-        private void onJudgementReverted(JudgementResult judgement)
-        {
-            if (judgement.FailedAtJudgement || !changesUnstableRate(judgement)) return;
-
-            hitOffsets.RemoveAt(hitOffsets.Count - 1);
-            updateDisplay();
-        }
+        private void updateDisplay(JudgementResult _) => Scheduler.AddOnce(updateDisplay);
 
         private void updateDisplay()
         {
-            // At Count = 0, we get NaN, While we are allowing count = 1, it will be 0 since average = offset.
-            if (hitOffsets.Count > 0)
-            {
-                double mean = hitOffsets.Average();
-                double squares = hitOffsets.Select(offset => Math.Pow(offset - mean, 2)).Sum();
-                Current.Value = (int)(Math.Sqrt(squares / hitOffsets.Count) * 10);
-                valid.Value = true;
-            }
-            else
-            {
-                Current.Value = 0;
-                valid.Value = false;
-            }
+            double? unstableRate = scoreProcessor.HitEvents.CalculateUnstableRate();
+
+            valid.Value = unstableRate != null;
+            if (unstableRate != null)
+                Current.Value = (int)unstableRate.Value;
         }
 
         protected override IHasText CreateText() => new TextComponent
@@ -102,8 +76,8 @@ namespace osu.Game.Screens.Play.HUD
 
             if (scoreProcessor == null) return;
 
-            scoreProcessor.NewJudgement -= onJudgementAdded;
-            scoreProcessor.JudgementReverted -= onJudgementReverted;
+            scoreProcessor.NewJudgement -= updateDisplay;
+            scoreProcessor.JudgementReverted -= updateDisplay;
         }
 
         private class TextComponent : CompositeDrawable, IHasText
diff --git a/osu.Game/Screens/Ranking/Statistics/UnstableRate.cs b/osu.Game/Screens/Ranking/Statistics/UnstableRate.cs
index cd2b292547..0d23490f40 100644
--- a/osu.Game/Screens/Ranking/Statistics/UnstableRate.cs
+++ b/osu.Game/Screens/Ranking/Statistics/UnstableRate.cs
@@ -1,9 +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.Rulesets.Scoring;
 
 namespace osu.Game.Screens.Ranking.Statistics
@@ -11,7 +9,7 @@ namespace osu.Game.Screens.Ranking.Statistics
     /// <summary>
     /// Displays the unstable rate statistic for a given play.
     /// </summary>
-    public class UnstableRate : SimpleStatisticItem<double>
+    public class UnstableRate : SimpleStatisticItem<double?>
     {
         /// <summary>
         /// Creates and computes an <see cref="UnstableRate"/> statistic.
@@ -20,21 +18,9 @@ namespace osu.Game.Screens.Ranking.Statistics
         public UnstableRate(IEnumerable<HitEvent> hitEvents)
             : base("Unstable Rate")
         {
-            double[] timeOffsets = hitEvents.Where(e => !(e.HitObject.HitWindows is HitWindows.EmptyHitWindows) && e.Result.IsHit())
-                                            .Select(ev => ev.TimeOffset).ToArray();
-            Value = 10 * standardDeviation(timeOffsets);
+            Value = hitEvents.CalculateUnstableRate();
         }
 
-        private static double standardDeviation(double[] timeOffsets)
-        {
-            if (timeOffsets.Length == 0)
-                return double.NaN;
-
-            double mean = timeOffsets.Average();
-            double squares = timeOffsets.Select(offset => Math.Pow(offset - mean, 2)).Sum();
-            return Math.Sqrt(squares / timeOffsets.Length);
-        }
-
-        protected override string DisplayValue(double value) => double.IsNaN(value) ? "(not available)" : value.ToString("N2");
+        protected override string DisplayValue(double? value) => value == null ? "(not available)" : value.Value.ToString(@"N2");
     }
 }

From 576417947e309712f2ac43713b6b03a111277e19 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 11 Nov 2021 13:21:56 +0100
Subject: [PATCH 0923/5547] Round unstable rate in counter rather than
 truncating

---
 osu.Game/Screens/Play/HUD/UnstableRateCounter.cs | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Play/HUD/UnstableRateCounter.cs b/osu.Game/Screens/Play/HUD/UnstableRateCounter.cs
index 4dc154fb9d..6cd9ca6154 100644
--- a/osu.Game/Screens/Play/HUD/UnstableRateCounter.cs
+++ b/osu.Game/Screens/Play/HUD/UnstableRateCounter.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.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
@@ -62,7 +63,7 @@ namespace osu.Game.Screens.Play.HUD
 
             valid.Value = unstableRate != null;
             if (unstableRate != null)
-                Current.Value = (int)unstableRate.Value;
+                Current.Value = (int)Math.Round(unstableRate.Value);
         }
 
         protected override IHasText CreateText() => new TextComponent

From 95bfb2c69b29b00920d7211a8b7cd4218da45c32 Mon Sep 17 00:00:00 2001
From: apollo-dw <83023433+apollo-dw@users.noreply.github.com>
Date: Thu, 11 Nov 2021 12:46:22 +0000
Subject: [PATCH 0924/5547] Clamp slider end estimate to 0

---
 osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs | 4 ++--
 osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs               | 4 ++--
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
index 5298c2b479..7c2f70af7d 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
@@ -127,10 +127,10 @@ namespace osu.Game.Rulesets.Osu.Difficulty
 
             // 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;
-            double estimateSliderEndsDropped = Math.Min(estimateDifficultSliders, Math.Min(countOk + countMeh + countMiss, Attributes.MaxCombo - scoreMaxCombo));
+            double estimateSliderEndsDropped = Math.Clamp(Math.Min(countOk + countMeh + countMiss, Attributes.MaxCombo - scoreMaxCombo), 0, estimateDifficultSliders);
 
             double sliderNerfFactor = (1 - Attributes.SliderFactor) * Math.Pow(1 - estimateSliderEndsDropped / estimateDifficultSliders, 3) + Attributes.SliderFactor;
-            aimValue *= Math.Max(Attributes.SliderFactor, sliderNerfFactor);
+            aimValue *= sliderNerfFactor;
 
             aimValue *= accuracy;
             // It is important to also consider accuracy difficulty when doing that.
diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
index 747b0fff8c..2a8d2ce759 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
@@ -20,6 +20,8 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
             this.withSliders = withSliders;
         }
 
+        private readonly bool withSliders;
+
         protected override int HistoryLength => 2;
 
         private const double wide_angle_multiplier = 1.5;
@@ -32,8 +34,6 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
         private double skillMultiplier => 23.25;
         private double strainDecayBase => 0.15;
 
-        private bool withSliders = true;
-
         private double strainValueOf(DifficultyHitObject current)
         {
             if (current.BaseObject is Spinner || Previous.Count <= 1 || Previous[0].BaseObject is Spinner)

From 1ba01a7e9a634b24e06585a4cee7b88b6282a0ee Mon Sep 17 00:00:00 2001
From: apollo-dw <83023433+apollo-dw@users.noreply.github.com>
Date: Thu, 11 Nov 2021 14:37:50 +0000
Subject: [PATCH 0925/5547] Fix circle-only map NaN values

---
 .../Difficulty/OsuPerformanceCalculator.cs               | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
index 7c2f70af7d..c28d4e124e 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
@@ -127,10 +127,13 @@ namespace osu.Game.Rulesets.Osu.Difficulty
 
             // 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;
-            double estimateSliderEndsDropped = Math.Clamp(Math.Min(countOk + countMeh + countMiss, Attributes.MaxCombo - scoreMaxCombo), 0, estimateDifficultSliders);
 
-            double sliderNerfFactor = (1 - Attributes.SliderFactor) * Math.Pow(1 - estimateSliderEndsDropped / estimateDifficultSliders, 3) + Attributes.SliderFactor;
-            aimValue *= sliderNerfFactor;
+            if (Attributes.SliderCount > 0)
+            {
+                double estimateSliderEndsDropped = Math.Min(Math.Min(countOk + countMeh + countMiss, Attributes.MaxCombo - scoreMaxCombo), estimateDifficultSliders);
+                double sliderNerfFactor = (1 - Attributes.SliderFactor) * Math.Pow(1 - estimateSliderEndsDropped / estimateDifficultSliders, 3) + Attributes.SliderFactor;
+                aimValue *= sliderNerfFactor;
+            }
 
             aimValue *= accuracy;
             // It is important to also consider accuracy difficulty when doing that.

From 5c8c121446e44f92840ff74a783fc5c9861db4dc Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 11 Nov 2021 23:39:15 +0900
Subject: [PATCH 0926/5547] Update behaviour to match server (removing playlist
 items) + tests

---
 .../TestSceneFreeForAllQueueMode.cs           |  6 +--
 .../Multiplayer/TestMultiplayerClient.cs      | 49 ++++++++++---------
 2 files changed, 29 insertions(+), 26 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/QueueingModes/TestSceneFreeForAllQueueMode.cs b/osu.Game.Tests/Visual/Multiplayer/QueueingModes/TestSceneFreeForAllQueueMode.cs
index 906e528ac5..0cf330bbbb 100644
--- a/osu.Game.Tests/Visual/Multiplayer/QueueingModes/TestSceneFreeForAllQueueMode.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/QueueingModes/TestSceneFreeForAllQueueMode.cs
@@ -73,9 +73,9 @@ namespace osu.Game.Tests.Visual.Multiplayer.QueueingModes
             RunGameplay();
 
             AddStep("change queue mode", () => Client.ChangeSettings(queueMode: QueueModes.HostOnly));
-            AddAssert("playlist has 1 item", () => Client.APIRoom?.Playlist.Count == 1);
-            AddAssert("playlist item is the same as last selected", () => Client.APIRoom?.Playlist[0].Beatmap.Value.OnlineID == OtherBeatmap.OnlineID);
-            AddAssert("playlist item is not expired", () => Client.APIRoom?.Playlist[0].Expired == false);
+            AddAssert("playlist has 2 items", () => Client.APIRoom?.Playlist.Count == 2);
+            AddAssert("playlist item is the other beatmap", () => Client.CurrentMatchPlayingItem.Value?.BeatmapID == OtherBeatmap.OnlineID);
+            AddAssert("playlist item is not expired", () => Client.APIRoom?.Playlist[1].Expired == false);
         }
 
         private void addItem(Func<BeatmapInfo> beatmap)
diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
index 0e0c9480dd..036afb26b4 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
@@ -209,29 +209,10 @@ namespace osu.Game.Tests.Visual.Multiplayer
             Debug.Assert(Room != null);
             Debug.Assert(APIRoom != null);
 
-            switch (Room.Settings.QueueMode, settings.QueueMode)
-            {
-                case (QueueModes.HostOnly, QueueModes.HostOnly):
-                    break;
+            // Server is authoritative for the time being.
+            settings.PlaylistItemId = Room.Settings.PlaylistItemId;
 
-                // Host-only is incompatible with other queueing modes, so expire all non-expired items.
-                case (QueueModes.HostOnly, _):
-                case (_, QueueModes.HostOnly):
-                    foreach (var playlistItem in APIRoom.Playlist.Where(i => !i.Expired).ToArray())
-                    {
-                        playlistItem.Expired = true;
-                        await ((IMultiplayerClient)this).PlaylistItemChanged(new APIPlaylistItem(playlistItem)).ConfigureAwait(false);
-                    }
-
-                    break;
-            }
-
-            await ((IMultiplayerClient)this).SettingsChanged(settings).ConfigureAwait(false);
-
-            foreach (var user in Room.Users.Where(u => u.State == MultiplayerUserState.Ready))
-                ChangeUserState(user.UserID, MultiplayerUserState.Idle);
-
-            await changeMatchType(settings.MatchType).ConfigureAwait(false);
+            await changeSettings(settings).ConfigureAwait(false);
         }
 
         public override Task ChangeState(MultiplayerUserState newState)
@@ -344,6 +325,28 @@ namespace osu.Game.Tests.Visual.Multiplayer
             return Task.FromResult(apiSet);
         }
 
+        private async Task changeSettings(MultiplayerRoomSettings settings)
+        {
+            Debug.Assert(Room != null);
+            Debug.Assert(APIRoom != null);
+
+            if (settings.QueueMode == QueueModes.HostOnly)
+            {
+                foreach (var playlistItem in APIRoom.Playlist.Where(i => !i.Expired && i.ID != Room.Settings.PlaylistItemId).ToArray())
+                {
+                    APIRoom.Playlist.Remove(playlistItem);
+                    await ((IMultiplayerClient)this).PlaylistItemRemoved(playlistItem.ID).ConfigureAwait(false);
+                }
+            }
+
+            await ((IMultiplayerClient)this).SettingsChanged(settings).ConfigureAwait(false);
+
+            foreach (var user in Room.Users.Where(u => u.State == MultiplayerUserState.Ready))
+                ChangeUserState(user.UserID, MultiplayerUserState.Idle);
+
+            await changeMatchType(settings.MatchType).ConfigureAwait(false);
+        }
+
         private async Task changeMatchType(MatchType type)
         {
             Debug.Assert(Room != null);
@@ -417,7 +420,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             if (nextId != Room.Settings.PlaylistItemId)
             {
                 Room.Settings.PlaylistItemId = nextId;
-                await ChangeSettings(Room.Settings).ConfigureAwait(false);
+                await changeSettings(Room.Settings).ConfigureAwait(false);
             }
         }
     }

From c3300934762d2a8b92069098c5da710ede8d5fa3 Mon Sep 17 00:00:00 2001
From: apollo-dw <83023433+apollo-dw@users.noreply.github.com>
Date: Thu, 11 Nov 2021 14:42:54 +0000
Subject: [PATCH 0927/5547] Add clamp back in

---
 osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
index c28d4e124e..8d45c7a8cc 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
@@ -130,7 +130,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty
 
             if (Attributes.SliderCount > 0)
             {
-                double estimateSliderEndsDropped = Math.Min(Math.Min(countOk + countMeh + countMiss, Attributes.MaxCombo - scoreMaxCombo), estimateDifficultSliders);
+                double estimateSliderEndsDropped = Math.Clamp(Math.Min(countOk + countMeh + countMiss, Attributes.MaxCombo - scoreMaxCombo), 0, estimateDifficultSliders);
                 double sliderNerfFactor = (1 - Attributes.SliderFactor) * Math.Pow(1 - estimateSliderEndsDropped / estimateDifficultSliders, 3) + Attributes.SliderFactor;
                 aimValue *= sliderNerfFactor;
             }

From dbdbfc472307caa185da783894dc5b46981e6be8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 11 Nov 2021 16:10:33 +0100
Subject: [PATCH 0928/5547] Add failing test case for PP counter not initially
 updating

---
 .../TestScenePerformancePointsCounter.cs      | 67 +++++++++++++------
 1 file changed, 46 insertions(+), 21 deletions(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestScenePerformancePointsCounter.cs b/osu.Game.Tests/Visual/Gameplay/TestScenePerformancePointsCounter.cs
index 4c48d52acd..84c7f611af 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestScenePerformancePointsCounter.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestScenePerformancePointsCounter.cs
@@ -1,9 +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.Diagnostics;
 using NUnit.Framework;
-using osu.Framework.Allocation;
+using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Testing;
 using osu.Game.Rulesets;
@@ -20,16 +21,17 @@ namespace osu.Game.Tests.Visual.Gameplay
 {
     public class TestScenePerformancePointsCounter : OsuTestScene
     {
-        [Cached]
-        private GameplayState gameplayState;
+        private DependencyProvidingContainer dependencyContainer;
 
-        [Cached]
+        private GameplayState gameplayState;
         private ScoreProcessor scoreProcessor;
 
         private int iteration;
+        private Bindable<JudgementResult> lastJudgementResult = new Bindable<JudgementResult>();
         private PerformancePointsCounter counter;
 
-        public TestScenePerformancePointsCounter()
+        [SetUpSteps]
+        public void SetUpSteps() => AddStep("create components", () =>
         {
             var ruleset = CreateRuleset();
 
@@ -38,32 +40,43 @@ namespace osu.Game.Tests.Visual.Gameplay
             var beatmap = CreateWorkingBeatmap(ruleset.RulesetInfo)
                 .GetPlayableBeatmap(ruleset.RulesetInfo);
 
+            lastJudgementResult = new Bindable<JudgementResult>();
+
             gameplayState = new GameplayState(beatmap, ruleset);
+            gameplayState.LastJudgementResult.BindTo(lastJudgementResult);
+
             scoreProcessor = new ScoreProcessor();
-        }
+
+            Child = dependencyContainer = new DependencyProvidingContainer
+            {
+                RelativeSizeAxes = Axes.Both,
+                CachedDependencies = new (Type, object)[]
+                {
+                    (typeof(GameplayState), gameplayState),
+                    (typeof(ScoreProcessor), scoreProcessor)
+                }
+            };
+
+            iteration = 0;
+        });
 
         protected override Ruleset CreateRuleset() => new OsuRuleset();
 
-        [SetUpSteps]
-        public void SetUpSteps()
+        private void createCounter() => AddStep("Create counter", () =>
         {
-            AddStep("Create counter", () =>
+            dependencyContainer.Child = counter = new PerformancePointsCounter
             {
-                iteration = 0;
-
-                Child = counter = new PerformancePointsCounter
-                {
-                    Anchor = Anchor.Centre,
-                    Origin = Anchor.Centre,
-                    Scale = new Vector2(5),
-                };
-            });
-        }
+                Anchor = Anchor.Centre,
+                Origin = Anchor.Centre,
+                Scale = new Vector2(5),
+            };
+        });
 
         [Test]
         public void TestBasicCounting()
         {
             int previousValue = 0;
+            createCounter();
 
             AddAssert("counter displaying zero", () => counter.Current.Value == 0);
 
@@ -86,6 +99,17 @@ namespace osu.Game.Tests.Visual.Gameplay
             AddUntilStep("counter non-zero", () => counter.Current.Value > 0);
         }
 
+        [Test]
+        public void TestCounterUpdatesWithJudgementsBeforeCreation()
+        {
+            AddRepeatStep("Add judgement", applyOneJudgement, 10);
+
+            createCounter();
+
+            AddUntilStep("counter non-zero", () => counter.Current.Value > 0);
+            AddUntilStep("counter opaque", () => counter.Child.Alpha == 1);
+        }
+
         private void applyOneJudgement()
         {
             var scoreInfo = gameplayState.Score.ScoreInfo;
@@ -94,13 +118,14 @@ namespace osu.Game.Tests.Visual.Gameplay
             scoreInfo.Accuracy = 1;
             scoreInfo.Statistics[HitResult.Great] = iteration * 1000;
 
-            scoreProcessor.ApplyResult(new OsuJudgementResult(new HitObject
+            lastJudgementResult.Value = new OsuJudgementResult(new HitObject
             {
                 StartTime = iteration * 10000,
             }, new OsuJudgement())
             {
                 Type = HitResult.Perfect,
-            });
+            };
+            scoreProcessor.ApplyResult(lastJudgementResult.Value);
 
             iteration++;
         }

From 2e3acffd1de244987d1974fb31f2db4f9fe5b1f3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 11 Nov 2021 16:23:37 +0100
Subject: [PATCH 0929/5547] Perform initial update of PP counter value on load
 complete

---
 osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs b/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs
index ef289c2a20..0ce36673ae 100644
--- a/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs
+++ b/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs
@@ -92,6 +92,9 @@ namespace osu.Game.Screens.Play.HUD
                 scoreProcessor.NewJudgement += onJudgementChanged;
                 scoreProcessor.JudgementReverted += onJudgementChanged;
             }
+
+            if (gameplayState?.LastJudgementResult.Value != null)
+                onJudgementChanged(gameplayState.LastJudgementResult.Value);
         }
 
         private bool isValid;

From 32b5a736c8b38e34817e5438f9d6ed927d9da27b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 11 Nov 2021 14:00:09 +0100
Subject: [PATCH 0930/5547] Add preview gameplay button to bottom editor bar

---
 .../Editing/TestSceneEditorTestGameplay.cs    | 13 +++++++
 .../Timelines/Summary/TestGameplayButton.cs   | 34 +++++++++++++++++++
 osu.Game/Screens/Edit/Editor.cs               | 13 ++++++-
 osu.Game/Screens/Edit/EditorRoundedScreen.cs  |  5 +--
 osu.Game/Screens/Edit/EditorScreen.cs         |  6 ----
 5 files changed, 62 insertions(+), 9 deletions(-)
 create mode 100644 osu.Game.Tests/Visual/Editing/TestSceneEditorTestGameplay.cs
 create mode 100644 osu.Game/Screens/Edit/Components/Timelines/Summary/TestGameplayButton.cs

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneEditorTestGameplay.cs b/osu.Game.Tests/Visual/Editing/TestSceneEditorTestGameplay.cs
new file mode 100644
index 0000000000..a2e210d92f
--- /dev/null
+++ b/osu.Game.Tests/Visual/Editing/TestSceneEditorTestGameplay.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.Game.Rulesets;
+using osu.Game.Rulesets.Osu;
+
+namespace osu.Game.Tests.Visual.Editing
+{
+    public class TestSceneEditorTestGameplay : EditorTestScene
+    {
+        protected override Ruleset CreateEditorRuleset() => new OsuRuleset();
+    }
+}
diff --git a/osu.Game/Screens/Edit/Components/Timelines/Summary/TestGameplayButton.cs b/osu.Game/Screens/Edit/Components/Timelines/Summary/TestGameplayButton.cs
new file mode 100644
index 0000000000..0d7a4ad057
--- /dev/null
+++ b/osu.Game/Screens/Edit/Components/Timelines/Summary/TestGameplayButton.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 osu.Framework.Allocation;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Sprites;
+using osu.Game.Graphics;
+using osu.Game.Graphics.Sprites;
+using osu.Game.Graphics.UserInterface;
+using osu.Game.Overlays;
+
+namespace osu.Game.Screens.Edit.Components.Timelines.Summary
+{
+    public class TestGameplayButton : OsuButton
+    {
+        protected override SpriteText CreateText() => new OsuSpriteText
+        {
+            Depth = -1,
+            Origin = Anchor.Centre,
+            Anchor = Anchor.Centre,
+            Font = OsuFont.TorusAlternate.With(weight: FontWeight.Light, size: 24),
+            Shadow = false
+        };
+
+        [BackgroundDependencyLoader]
+        private void load(OsuColour colours, OverlayColourProvider colourProvider)
+        {
+            BackgroundColour = colours.Orange1;
+            SpriteText.Colour = colourProvider.Background6;
+
+            Text = "Test!";
+        }
+    }
+}
diff --git a/osu.Game/Screens/Edit/Editor.cs b/osu.Game/Screens/Edit/Editor.cs
index 0ca7038580..ef9cce4bf7 100644
--- a/osu.Game/Screens/Edit/Editor.cs
+++ b/osu.Game/Screens/Edit/Editor.cs
@@ -36,6 +36,7 @@ using osu.Game.Screens.Edit.Timing;
 using osu.Game.Screens.Edit.Verify;
 using osu.Game.Screens.Play;
 using osu.Game.Users;
+using osuTK;
 using osuTK.Graphics;
 using osuTK.Input;
 
@@ -106,6 +107,9 @@ namespace osu.Game.Screens.Edit
         [Cached]
         public readonly EditorClipboard Clipboard = new EditorClipboard();
 
+        [Cached]
+        private readonly OverlayColourProvider colourProvider = new OverlayColourProvider(OverlayColourScheme.Blue);
+
         public Editor(EditorLoader loader = null)
         {
             this.loader = loader;
@@ -262,7 +266,8 @@ namespace osu.Game.Screens.Edit
                                     {
                                         new Dimension(GridSizeMode.Absolute, 220),
                                         new Dimension(),
-                                        new Dimension(GridSizeMode.Absolute, 220)
+                                        new Dimension(GridSizeMode.Absolute, 220),
+                                        new Dimension(GridSizeMode.Absolute, 160),
                                     },
                                     Content = new[]
                                     {
@@ -283,6 +288,12 @@ namespace osu.Game.Screens.Edit
                                                 RelativeSizeAxes = Axes.Both,
                                                 Padding = new MarginPadding { Left = 10 },
                                                 Child = new PlaybackControl { RelativeSizeAxes = Axes.Both },
+                                            },
+                                            new TestGameplayButton
+                                            {
+                                                RelativeSizeAxes = Axes.Both,
+                                                Padding = new MarginPadding { Left = 10 },
+                                                Size = new Vector2(1),
                                             }
                                         },
                                     }
diff --git a/osu.Game/Screens/Edit/EditorRoundedScreen.cs b/osu.Game/Screens/Edit/EditorRoundedScreen.cs
index 508663224d..7f7b3abc2a 100644
--- a/osu.Game/Screens/Edit/EditorRoundedScreen.cs
+++ b/osu.Game/Screens/Edit/EditorRoundedScreen.cs
@@ -6,6 +6,7 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
 using osu.Game.Graphics;
+using osu.Game.Overlays;
 
 namespace osu.Game.Screens.Edit
 {
@@ -26,7 +27,7 @@ namespace osu.Game.Screens.Edit
         }
 
         [BackgroundDependencyLoader]
-        private void load()
+        private void load(OverlayColourProvider colourProvider)
         {
             base.Content.Add(new Container
             {
@@ -41,7 +42,7 @@ namespace osu.Game.Screens.Edit
                     {
                         new Box
                         {
-                            Colour = ColourProvider.Background3,
+                            Colour = colourProvider.Background3,
                             RelativeSizeAxes = Axes.Both,
                         },
                         roundedContent = new Container
diff --git a/osu.Game/Screens/Edit/EditorScreen.cs b/osu.Game/Screens/Edit/EditorScreen.cs
index 516d7a23e0..2837cdcd9a 100644
--- a/osu.Game/Screens/Edit/EditorScreen.cs
+++ b/osu.Game/Screens/Edit/EditorScreen.cs
@@ -6,7 +6,6 @@ using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Cursor;
-using osu.Game.Overlays;
 
 namespace osu.Game.Screens.Edit
 {
@@ -18,9 +17,6 @@ namespace osu.Game.Screens.Edit
         [Resolved]
         protected EditorBeatmap EditorBeatmap { get; private set; }
 
-        [Cached]
-        protected readonly OverlayColourProvider ColourProvider;
-
         protected override Container<Drawable> Content => content;
         private readonly Container content;
 
@@ -34,8 +30,6 @@ namespace osu.Game.Screens.Edit
             Origin = Anchor.Centre;
             RelativeSizeAxes = Axes.Both;
 
-            ColourProvider = new OverlayColourProvider(OverlayColourScheme.Blue);
-
             InternalChild = content = new PopoverContainer { RelativeSizeAxes = Axes.Both };
         }
 

From 657c7d8834fee0a809ea1357d363acd62d88b257 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 11 Nov 2021 19:41:48 +0300
Subject: [PATCH 0931/5547] Update iOS native references and linker flags in
 line with framework changes

---
 osu.iOS.props | 16 +---------------
 1 file changed, 1 insertion(+), 15 deletions(-)

diff --git a/osu.iOS.props b/osu.iOS.props
index 1852957e87..6747c3aee1 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -4,12 +4,10 @@
     <ProjectTypeGuids>{FEACFBD2-3405-455C-9665-78FE426C6842};{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}</ProjectTypeGuids>
     <IPhoneResourcePrefix>Resources</IPhoneResourcePrefix>
     <RestoreProjectStyle>PackageReference</RestoreProjectStyle>
-    <DefaultMtouchExtraArgs>--nolinkaway</DefaultMtouchExtraArgs>
-    <DefaultMtouchGccFlags>-lstdc++ -lbz2 -framework AudioToolbox -framework AVFoundation -framework CoreMedia -framework VideoToolbox -framework SystemConfiguration -framework CFNetwork -framework Accelerate</DefaultMtouchGccFlags>
     <OutputPath>bin\$(Platform)\$(Configuration)</OutputPath>
     <MtouchI18n>cjk,mideast,other,rare,west</MtouchI18n>
     <OptimizePNGs>false</OptimizePNGs>
-    <MtouchExtraArgs>$(DefaultMtouchExtraArgs) -gcc_flags "$(DefaultMtouchGccFlags)"</MtouchExtraArgs>
+    <MtouchExtraArgs>--nolinkaway</MtouchExtraArgs>
     <MtouchHttpClientHandler>NSUrlSessionHandler</MtouchHttpClientHandler>
     <MtouchVerbosity></MtouchVerbosity>
     <CodesignKey>iPhone Developer</CodesignKey>
@@ -49,18 +47,6 @@
     <DeviceSpecificBuild>true</DeviceSpecificBuild>
     <IOSDebuggerPort>28126</IOSDebuggerPort>
   </PropertyGroup>
-  <ItemGroup>
-    <NativeReference Include="$(OutputPath)\libbass.a;$(OutputPath)\libbass_fx.a">
-      <Kind>Static</Kind>
-      <SmartLink>False</SmartLink>
-      <ForceLoad>True</ForceLoad>
-    </NativeReference>
-    <NativeReference Include="$(OutputPath)\libavcodec.a;$(OutputPath)\libavdevice.a;$(OutputPath)\libavfilter.a;$(OutputPath)\libavformat.a;$(OutputPath)\libavutil.a;$(OutputPath)\libswresample.a;$(OutputPath)\libswscale.a">
-      <Kind>Static</Kind>
-      <SmartLink>False</SmartLink>
-      <ForceLoad>True</ForceLoad>
-    </NativeReference>
-  </ItemGroup>
   <ItemGroup>
     <Reference Include="System" />
     <Reference Include="System.Xml" />

From b66758dac78c17b2c02ddda536d844acb4a3a319 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 11 Nov 2021 18:11:18 +0100
Subject: [PATCH 0932/5547] Fix missing unsubscribe from `JudgementReverted`

---
 osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs b/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs
index 0ce36673ae..0db1498756 100644
--- a/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs
+++ b/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs
@@ -158,7 +158,10 @@ namespace osu.Game.Screens.Play.HUD
             base.Dispose(isDisposing);
 
             if (scoreProcessor != null)
+            {
                 scoreProcessor.NewJudgement -= onJudgementChanged;
+                scoreProcessor.JudgementReverted -= onJudgementChanged;
+            }
 
             loadCancellationSource?.Cancel();
         }

From 8c9d39700d66af8c12ff2a82a46f39a8ea241b19 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 11 Nov 2021 20:22:32 +0300
Subject: [PATCH 0933/5547] Update deprecated code in iOS main entry

---
 osu.iOS/Application.cs | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/osu.iOS/Application.cs b/osu.iOS/Application.cs
index 740937e0e1..ffabdb4698 100644
--- a/osu.iOS/Application.cs
+++ b/osu.iOS/Application.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.iOS;
 using UIKit;
 
 namespace osu.iOS
@@ -9,7 +10,7 @@ namespace osu.iOS
     {
         public static void Main(string[] args)
         {
-            UIApplication.Main(args, "GameUIApplication", "AppDelegate");
+            UIApplication.Main(args, typeof(GameUIApplication), typeof(AppDelegate));
         }
     }
 }

From 59727ce836b6ac76c8dc60a0b3482f3adffdf991 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 10 Nov 2021 23:11:25 +0100
Subject: [PATCH 0934/5547] Add minimal implementation of gameplay testing from
 editor

---
 osu.Game/Screens/Edit/Editor.cs               | 37 +++++++++++++++++--
 osu.Game/Screens/Edit/EditorPlayer.cs         | 22 +++++++++++
 .../Edit/SaveBeforeGameplayTestDialog.cs      | 32 ++++++++++++++++
 3 files changed, 88 insertions(+), 3 deletions(-)
 create mode 100644 osu.Game/Screens/Edit/EditorPlayer.cs
 create mode 100644 osu.Game/Screens/Edit/SaveBeforeGameplayTestDialog.cs

diff --git a/osu.Game/Screens/Edit/Editor.cs b/osu.Game/Screens/Edit/Editor.cs
index ef9cce4bf7..a67ef070f6 100644
--- a/osu.Game/Screens/Edit/Editor.cs
+++ b/osu.Game/Screens/Edit/Editor.cs
@@ -294,6 +294,7 @@ namespace osu.Game.Screens.Edit
                                                 RelativeSizeAxes = Axes.Both,
                                                 Padding = new MarginPadding { Left = 10 },
                                                 Size = new Vector2(1),
+                                                Action = testGameplay
                                             }
                                         },
                                     }
@@ -521,7 +522,21 @@ namespace osu.Game.Screens.Edit
             ApplyToBackground(b => b.FadeColour(Color4.White, 500));
             resetTrack();
 
-            // To update the game-wide beatmap with any changes, perform a re-fetch on exit.
+            refetchBeatmap();
+
+            return base.OnExiting(next);
+        }
+
+        public override void OnSuspending(IScreen next)
+        {
+            refetchBeatmap();
+
+            base.OnSuspending(next);
+        }
+
+        private void refetchBeatmap()
+        {
+            // To update the game-wide beatmap with any changes, perform a re-fetch on exit/suspend.
             // This is required as the editor makes its local changes via EditorBeatmap
             // (which are not propagated outwards to a potentially cached WorkingBeatmap).
             var refetchedBeatmap = beatmapManager.GetWorkingBeatmap(Beatmap.Value.BeatmapInfo);
@@ -531,8 +546,6 @@ namespace osu.Game.Screens.Edit
                 Logger.Log("Editor providing re-fetched beatmap post edit session");
                 Beatmap.Value = refetchedBeatmap;
             }
-
-            return base.OnExiting(next);
         }
 
         private void confirmExitWithSave()
@@ -763,6 +776,24 @@ namespace osu.Game.Screens.Edit
             loader?.CancelPendingDifficultySwitch();
         }
 
+        private void testGameplay()
+        {
+            if (HasUnsavedChanges)
+            {
+                dialogOverlay.Push(new SaveBeforeGameplayTestDialog(() =>
+                {
+                    Save();
+                    pushEditorPlayer();
+                }));
+            }
+            else
+            {
+                pushEditorPlayer();
+            }
+
+            void pushEditorPlayer() => this.Push(new PlayerLoader(() => new EditorPlayer()));
+        }
+
         public double SnapTime(double time, double? referenceTime) => editorBeatmap.SnapTime(time, referenceTime);
 
         public double GetBeatLengthAtTime(double referenceTime) => editorBeatmap.GetBeatLengthAtTime(referenceTime);
diff --git a/osu.Game/Screens/Edit/EditorPlayer.cs b/osu.Game/Screens/Edit/EditorPlayer.cs
new file mode 100644
index 0000000000..f8dd75d94a
--- /dev/null
+++ b/osu.Game/Screens/Edit/EditorPlayer.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.Game.Screens.Play;
+
+namespace osu.Game.Screens.Edit
+{
+    public class EditorPlayer : Player
+    {
+        public EditorPlayer()
+            : base(new PlayerConfiguration { ShowResults = false })
+        {
+        }
+
+        protected override void PrepareReplay()
+        {
+            // don't record replays.
+        }
+
+        protected override bool CheckModsAllowFailure() => false; // never fail.
+    }
+}
diff --git a/osu.Game/Screens/Edit/SaveBeforeGameplayTestDialog.cs b/osu.Game/Screens/Edit/SaveBeforeGameplayTestDialog.cs
new file mode 100644
index 0000000000..7c03664c66
--- /dev/null
+++ b/osu.Game/Screens/Edit/SaveBeforeGameplayTestDialog.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;
+using osu.Framework.Graphics.Sprites;
+using osu.Game.Overlays.Dialog;
+
+namespace osu.Game.Screens.Edit
+{
+    public class SaveBeforeGameplayTestDialog : PopupDialog
+    {
+        public SaveBeforeGameplayTestDialog(Action saveAndPreview)
+        {
+            HeaderText = "The beatmap will be saved in order to test it.";
+
+            Icon = FontAwesome.Regular.Save;
+
+            Buttons = new PopupDialogButton[]
+            {
+                new PopupDialogOkButton
+                {
+                    Text = "Sounds good, let's go!",
+                    Action = saveAndPreview
+                },
+                new PopupDialogCancelButton
+                {
+                    Text = "Oops, continue editing",
+                },
+            };
+        }
+    }
+}

From 6ce1a78723f3c99c67fc3c4fa9cea40f4ed7775d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 11 Nov 2021 15:08:43 +0100
Subject: [PATCH 0935/5547] Add test coverage for basic gameplay testing
 scenarios

---
 .../Editing/TestSceneEditorTestGameplay.cs    | 109 ++++++++++++++++++
 1 file changed, 109 insertions(+)

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneEditorTestGameplay.cs b/osu.Game.Tests/Visual/Editing/TestSceneEditorTestGameplay.cs
index a2e210d92f..9c44a6a986 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneEditorTestGameplay.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneEditorTestGameplay.cs
@@ -1,13 +1,122 @@
 // 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.Allocation;
+using osu.Framework.Screens;
+using osu.Framework.Testing;
+using osu.Game.Beatmaps;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Osu;
+using osu.Game.Screens.Edit;
+using osu.Game.Screens.Edit.Components.Timelines.Summary;
+using osu.Game.Tests.Beatmaps.IO;
+using osuTK.Input;
 
 namespace osu.Game.Tests.Visual.Editing
 {
     public class TestSceneEditorTestGameplay : EditorTestScene
     {
+        protected override bool IsolateSavingFromDatabase => false;
+
         protected override Ruleset CreateEditorRuleset() => new OsuRuleset();
+
+        [Resolved]
+        private OsuGameBase game { get; set; }
+
+        [Resolved]
+        private BeatmapManager beatmaps { get; set; }
+
+        private BeatmapSetInfo importedBeatmapSet;
+
+        public override void SetUpSteps()
+        {
+            AddStep("import test beatmap", () => importedBeatmapSet = ImportBeatmapTest.LoadOszIntoOsu(game).Result);
+            base.SetUpSteps();
+        }
+
+        protected override void LoadEditor()
+        {
+            Beatmap.Value = beatmaps.GetWorkingBeatmap(importedBeatmapSet.Beatmaps.First(b => b.RulesetID == 0));
+            base.LoadEditor();
+        }
+
+        [Test]
+        public void TestBasicGameplayTest()
+        {
+            AddStep("click test gameplay button", () =>
+            {
+                var button = Editor.ChildrenOfType<TestGameplayButton>().Single();
+
+                InputManager.MoveMouseTo(button);
+                InputManager.Click(MouseButton.Left);
+            });
+
+            EditorPlayer editorPlayer = null;
+            AddUntilStep("player pushed", () => (editorPlayer = Stack.CurrentScreen as EditorPlayer) != null);
+            AddStep("exit player", () => editorPlayer.Exit());
+            AddUntilStep("current screen is editor", () => Stack.CurrentScreen is Editor);
+        }
+
+        [Test]
+        public void TestCancelGameplayTestWithUnsavedChanges()
+        {
+            AddStep("delete all but first object", () => EditorBeatmap.RemoveRange(EditorBeatmap.HitObjects.Skip(1).ToList()));
+
+            AddStep("click test gameplay button", () =>
+            {
+                var button = Editor.ChildrenOfType<TestGameplayButton>().Single();
+
+                InputManager.MoveMouseTo(button);
+                InputManager.Click(MouseButton.Left);
+            });
+            AddUntilStep("save prompt shown", () => DialogOverlay.CurrentDialog is SaveBeforeGameplayTestDialog);
+
+            AddStep("dismiss prompt", () =>
+            {
+                var button = DialogOverlay.CurrentDialog.Buttons.Last();
+                InputManager.MoveMouseTo(button);
+                InputManager.Click(MouseButton.Left);
+            });
+
+            AddWaitStep("wait some", 3);
+            AddAssert("stayed in editor", () => Stack.CurrentScreen is Editor);
+        }
+
+        [Test]
+        public void TestSaveChangesBeforeGameplayTest()
+        {
+            AddStep("delete all but first object", () => EditorBeatmap.RemoveRange(EditorBeatmap.HitObjects.Skip(1).ToList()));
+            // bit of a hack to ensure this test can be ran multiple times without running into UNIQUE constraint failures
+            AddStep("set unique difficulty name", () => EditorBeatmap.BeatmapInfo.DifficultyName = Guid.NewGuid().ToString());
+
+            AddStep("click test gameplay button", () =>
+            {
+                var button = Editor.ChildrenOfType<TestGameplayButton>().Single();
+
+                InputManager.MoveMouseTo(button);
+                InputManager.Click(MouseButton.Left);
+            });
+            AddUntilStep("save prompt shown", () => DialogOverlay.CurrentDialog is SaveBeforeGameplayTestDialog);
+
+            AddStep("save changes", () => DialogOverlay.CurrentDialog.PerformOkAction());
+
+            EditorPlayer editorPlayer = null;
+            AddUntilStep("player pushed", () => (editorPlayer = Stack.CurrentScreen as EditorPlayer) != null);
+            AddAssert("beatmap has 1 object", () => editorPlayer.Beatmap.Value.Beatmap.HitObjects.Count == 1);
+            AddStep("exit player", () => editorPlayer.Exit());
+            AddUntilStep("current screen is editor", () => Stack.CurrentScreen is Editor);
+        }
+
+        public override void TearDownSteps()
+        {
+            base.TearDownSteps();
+            AddStep("delete imported", () =>
+            {
+                beatmaps.Delete(importedBeatmapSet);
+            });
+        }
     }
 }

From 385df51b06d83e72bce2b3cc6b4a2d545e9f614b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 11 Nov 2021 15:25:58 +0100
Subject: [PATCH 0936/5547] Ensure editor test player is exited on completion

---
 .../Visual/Editing/TestSceneEditorTestGameplay.cs     |  3 +--
 osu.Game/Screens/Edit/EditorPlayer.cs                 | 11 +++++++++++
 2 files changed, 12 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneEditorTestGameplay.cs b/osu.Game.Tests/Visual/Editing/TestSceneEditorTestGameplay.cs
index 9c44a6a986..e2a36e1371 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneEditorTestGameplay.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneEditorTestGameplay.cs
@@ -106,8 +106,7 @@ namespace osu.Game.Tests.Visual.Editing
             EditorPlayer editorPlayer = null;
             AddUntilStep("player pushed", () => (editorPlayer = Stack.CurrentScreen as EditorPlayer) != null);
             AddAssert("beatmap has 1 object", () => editorPlayer.Beatmap.Value.Beatmap.HitObjects.Count == 1);
-            AddStep("exit player", () => editorPlayer.Exit());
-            AddUntilStep("current screen is editor", () => Stack.CurrentScreen is Editor);
+            AddUntilStep("wait for return to editor", () => Stack.CurrentScreen is Editor);
         }
 
         public override void TearDownSteps()
diff --git a/osu.Game/Screens/Edit/EditorPlayer.cs b/osu.Game/Screens/Edit/EditorPlayer.cs
index f8dd75d94a..15e2ecb73b 100644
--- a/osu.Game/Screens/Edit/EditorPlayer.cs
+++ b/osu.Game/Screens/Edit/EditorPlayer.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.Screens;
 using osu.Game.Screens.Play;
 
 namespace osu.Game.Screens.Edit
@@ -12,6 +13,16 @@ namespace osu.Game.Screens.Edit
         {
         }
 
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+            ScoreProcessor.HasCompleted.BindValueChanged(completed =>
+            {
+                if (completed.NewValue)
+                    Scheduler.AddDelayed(this.Exit, RESULTS_DISPLAY_DELAY);
+            });
+        }
+
         protected override void PrepareReplay()
         {
             // don't record replays.

From c465bcb82104a2e1739348daa89f140bedf7461c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 11 Nov 2021 15:45:10 +0100
Subject: [PATCH 0937/5547] Ensure track is stopped on player completion

---
 .../Visual/Editing/TestSceneEditorTestGameplay.cs     |  2 ++
 osu.Game/Screens/Edit/EditorPlayer.cs                 | 11 +++++++++++
 2 files changed, 13 insertions(+)

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneEditorTestGameplay.cs b/osu.Game.Tests/Visual/Editing/TestSceneEditorTestGameplay.cs
index e2a36e1371..db42667033 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneEditorTestGameplay.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneEditorTestGameplay.cs
@@ -106,7 +106,9 @@ namespace osu.Game.Tests.Visual.Editing
             EditorPlayer editorPlayer = null;
             AddUntilStep("player pushed", () => (editorPlayer = Stack.CurrentScreen as EditorPlayer) != null);
             AddAssert("beatmap has 1 object", () => editorPlayer.Beatmap.Value.Beatmap.HitObjects.Count == 1);
+
             AddUntilStep("wait for return to editor", () => Stack.CurrentScreen is Editor);
+            AddAssert("track stopped", () => !Beatmap.Value.Track.IsRunning);
         }
 
         public override void TearDownSteps()
diff --git a/osu.Game/Screens/Edit/EditorPlayer.cs b/osu.Game/Screens/Edit/EditorPlayer.cs
index 15e2ecb73b..b2fab3fefc 100644
--- a/osu.Game/Screens/Edit/EditorPlayer.cs
+++ b/osu.Game/Screens/Edit/EditorPlayer.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 osu.Framework.Allocation;
 using osu.Framework.Screens;
+using osu.Game.Overlays;
 using osu.Game.Screens.Play;
 
 namespace osu.Game.Screens.Edit
@@ -13,6 +15,9 @@ namespace osu.Game.Screens.Edit
         {
         }
 
+        [Resolved]
+        private MusicController musicController { get; set; }
+
         protected override void LoadComplete()
         {
             base.LoadComplete();
@@ -29,5 +34,11 @@ namespace osu.Game.Screens.Edit
         }
 
         protected override bool CheckModsAllowFailure() => false; // never fail.
+
+        public override bool OnExiting(IScreen next)
+        {
+            musicController.Stop();
+            return base.OnExiting(next);
+        }
     }
 }

From 459ec7b3bf4c60b9521629eead843dc9ebaea2df Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 11 Nov 2021 20:42:33 +0100
Subject: [PATCH 0938/5547] Fix test failures due to missing dependencies

---
 osu.Game.Tests/Visual/Editing/TestSceneSetupScreen.cs  | 4 ++++
 osu.Game.Tests/Visual/Editing/TestSceneTimingScreen.cs | 4 ++++
 2 files changed, 8 insertions(+)

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneSetupScreen.cs b/osu.Game.Tests/Visual/Editing/TestSceneSetupScreen.cs
index c3c803ff23..03e78ce854 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneSetupScreen.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneSetupScreen.cs
@@ -4,6 +4,7 @@
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics.Containers;
+using osu.Game.Overlays;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Catch;
 using osu.Game.Rulesets.Edit;
@@ -23,6 +24,9 @@ namespace osu.Game.Tests.Visual.Editing
         [Cached(typeof(IBeatSnapProvider))]
         private readonly EditorBeatmap editorBeatmap;
 
+        [Cached]
+        private readonly OverlayColourProvider colourProvider = new OverlayColourProvider(OverlayColourScheme.Blue);
+
         public TestSceneSetupScreen()
         {
             editorBeatmap = new EditorBeatmap(new OsuBeatmap());
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneTimingScreen.cs b/osu.Game.Tests/Visual/Editing/TestSceneTimingScreen.cs
index f961fff1e5..4bbffbdc7a 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneTimingScreen.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneTimingScreen.cs
@@ -4,6 +4,7 @@
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics.Containers;
+using osu.Game.Overlays;
 using osu.Game.Rulesets.Edit;
 using osu.Game.Rulesets.Osu;
 using osu.Game.Screens.Edit;
@@ -18,6 +19,9 @@ namespace osu.Game.Tests.Visual.Editing
         [Cached(typeof(IBeatSnapProvider))]
         private readonly EditorBeatmap editorBeatmap;
 
+        [Cached]
+        private readonly OverlayColourProvider colourProvider = new OverlayColourProvider(OverlayColourScheme.Blue);
+
         protected override bool ScrollUsingMouseWheel => false;
 
         public TestSceneTimingScreen()

From 27707d52ec3815d66cdcbb4ebcabca90caf4453c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 1 Nov 2021 19:37:29 +0100
Subject: [PATCH 0939/5547] Implement slider-to-stream conversion

---
 .../Sliders/SliderSelectionBlueprint.cs       | 51 +++++++++++++++++++
 1 file changed, 51 insertions(+)

diff --git a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/SliderSelectionBlueprint.cs b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/SliderSelectionBlueprint.cs
index a7fadfb67f..ecf134dd15 100644
--- a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/SliderSelectionBlueprint.cs
+++ b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/SliderSelectionBlueprint.cs
@@ -11,6 +11,7 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Primitives;
 using osu.Framework.Graphics.UserInterface;
 using osu.Framework.Input.Events;
+using osu.Framework.Utils;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Rulesets.Edit;
 using osu.Game.Rulesets.Objects;
@@ -47,6 +48,9 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders
         [Resolved(CanBeNull = true)]
         private IEditorChangeHandler changeHandler { get; set; }
 
+        [Resolved(CanBeNull = true)]
+        private BindableBeatDivisor beatDivisor { get; set; }
+
         public override Quad SelectionQuad => BodyPiece.ScreenSpaceDrawQuad;
 
         private readonly BindableList<PathControlPoint> controlPoints = new BindableList<PathControlPoint>();
@@ -173,6 +177,20 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders
             }
         }
 
+        protected override bool OnKeyDown(KeyDownEvent e)
+        {
+            if (!IsSelected)
+                return false;
+
+            if (e.Key == Key.F && e.ControlPressed && e.ShiftPressed)
+            {
+                convertToStream();
+                return true;
+            }
+
+            return false;
+        }
+
         private int addControlPoint(Vector2 position)
         {
             position -= HitObject.Position;
@@ -234,9 +252,42 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders
             editorBeatmap?.Update(HitObject);
         }
 
+        private void convertToStream()
+        {
+            if (editorBeatmap == null || changeHandler == null || beatDivisor == null)
+                return;
+
+            var timingPoint = editorBeatmap.ControlPointInfo.TimingPointAt(HitObject.StartTime);
+            double streamSpacing = timingPoint.BeatLength / beatDivisor.Value;
+
+            changeHandler.BeginChange();
+
+            int i = 0;
+            double time = HitObject.StartTime;
+
+            while (!Precision.DefinitelyBigger(time, HitObject.GetEndTime(), 1))
+            {
+                Vector2 position = HitObject.Position + HitObject.Path.PositionAt((time - HitObject.StartTime) / HitObject.Duration);
+                editorBeatmap.Add(new HitCircle
+                {
+                    StartTime = time,
+                    Position = position,
+                    NewCombo = i == 0 && HitObject.NewCombo
+                });
+
+                i += 1;
+                time = HitObject.StartTime + i * streamSpacing;
+            }
+
+            editorBeatmap.Remove(HitObject);
+
+            changeHandler.EndChange();
+        }
+
         public override MenuItem[] ContextMenuItems => new MenuItem[]
         {
             new OsuMenuItem("Add control point", MenuItemType.Standard, () => addControlPoint(rightClickPosition)),
+            new OsuMenuItem("Convert to stream", MenuItemType.Destructive, convertToStream),
         };
 
         // Always refer to the drawable object's slider body so subsequent movement deltas are calculated with updated positions.

From d9494d405ef5b12000a8a1a4a412ef0c21af3545 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 1 Nov 2021 19:37:37 +0100
Subject: [PATCH 0940/5547] Add test coverage for slider-to-stream conversion

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

diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderStreamConversion.cs b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderStreamConversion.cs
new file mode 100644
index 0000000000..f8cbd046d1
--- /dev/null
+++ b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderStreamConversion.cs
@@ -0,0 +1,140 @@
+// 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.Objects;
+using osu.Game.Rulesets.Osu.Objects;
+using osu.Game.Screens.Edit;
+using osuTK;
+using osuTK.Input;
+
+namespace osu.Game.Rulesets.Osu.Tests.Editor
+{
+    public class TestSceneSliderStreamConversion : TestSceneOsuEditor
+    {
+        private BindableBeatDivisor beatDivisor => (BindableBeatDivisor)Editor.Dependencies.Get(typeof(BindableBeatDivisor));
+
+        [Test]
+        public void TestSimpleConversion()
+        {
+            Slider slider = null;
+
+            AddStep("select first slider", () =>
+            {
+                slider = (Slider)EditorBeatmap.HitObjects.First(h => h is Slider);
+                EditorClock.Seek(slider.StartTime);
+                EditorBeatmap.SelectedHitObjects.Add(slider);
+            });
+
+            convertToStream();
+
+            AddAssert("stream created", () => streamCreatedFor(slider, 1 / 4d));
+
+            AddStep("undo", () => Editor.Undo());
+            AddAssert("slider restored", () => sliderRestored(slider));
+
+            AddStep("select first slider", () =>
+            {
+                slider = (Slider)EditorBeatmap.HitObjects.First(h => h is Slider);
+                EditorClock.Seek(slider.StartTime);
+                EditorBeatmap.SelectedHitObjects.Add(slider);
+            });
+            AddStep("change beat divisor", () => beatDivisor.Value = 8);
+
+            convertToStream();
+            AddAssert("stream created", () => streamCreatedFor(slider, 1 / 8d));
+        }
+
+        [Test]
+        public void TestConversionWithNonMatchingDivisor()
+        {
+            Slider slider = null;
+
+            AddStep("select second slider", () =>
+            {
+                slider = (Slider)EditorBeatmap.HitObjects.Where(h => h is Slider).ElementAt(1);
+                EditorClock.Seek(slider.StartTime);
+                EditorBeatmap.SelectedHitObjects.Add(slider);
+            });
+            AddStep("change beat divisor", () => beatDivisor.Value = 3);
+
+            convertToStream();
+
+            AddAssert("stream created", () => streamCreatedFor(slider, 2 / 3d));
+        }
+
+        [Test]
+        public void TestConversionPreservesNewCombo()
+        {
+            Slider slider = null;
+
+            AddStep("select second new-combo-starting slider", () =>
+            {
+                slider = (Slider)EditorBeatmap.HitObjects.Where(h => h is Slider s && s.NewCombo).ElementAt(1);
+                EditorClock.Seek(slider.StartTime);
+                EditorBeatmap.SelectedHitObjects.Add(slider);
+            });
+
+            convertToStream();
+
+            AddAssert("stream created", () => streamCreatedFor(slider, 1 / 4d));
+
+            AddStep("undo", () => Editor.Undo());
+            AddAssert("slider restored", () => sliderRestored(slider));
+        }
+
+        private void convertToStream()
+        {
+            AddStep("convert to stream", () =>
+            {
+                InputManager.PressKey(Key.LControl);
+                InputManager.PressKey(Key.LShift);
+                InputManager.Key(Key.F);
+                InputManager.ReleaseKey(Key.LShift);
+                InputManager.ReleaseKey(Key.LControl);
+            });
+        }
+
+        private bool streamCreatedFor(Slider slider, double spacing)
+        {
+            if (EditorBeatmap.HitObjects.Contains(slider))
+                return false;
+
+            for (int i = 0; i * spacing <= 1; ++i)
+            {
+                double progress = i * spacing;
+                double time = slider.StartTime + progress * slider.Duration;
+                Vector2 position = slider.Position + slider.Path.PositionAt(progress);
+
+                if (!EditorBeatmap.HitObjects.OfType<HitCircle>().Any(h => matches(h, time, position, slider.NewCombo && progress == 0)))
+                    return false;
+            }
+
+            return true;
+
+            bool matches(HitCircle circle, double time, Vector2 position, bool startsNewCombo) =>
+                Precision.AlmostEquals(circle.StartTime, time, 1)
+                && Precision.AlmostEquals(circle.Position, position, 0.01f)
+                && circle.NewCombo == startsNewCombo;
+        }
+
+        private bool sliderRestored(Slider slider)
+        {
+            var objects = EditorBeatmap.HitObjects.Where(h => h.StartTime >= slider.StartTime && h.GetEndTime() <= slider.EndTime).ToList();
+
+            if (objects.Count > 1)
+                return false;
+
+            var hitObject = objects.Single();
+            if (!(hitObject is Slider restoredSlider))
+                return false;
+
+            return Precision.AlmostEquals(slider.StartTime, restoredSlider.StartTime)
+                   && Precision.AlmostEquals(slider.GetEndTime(), restoredSlider.GetEndTime())
+                   && Precision.AlmostEquals(slider.Position, restoredSlider.Position, 0.01f)
+                   && Precision.AlmostEquals(slider.EndPosition, restoredSlider.EndPosition, 0.01f);
+        }
+    }
+}

From 0cd3f9859817f354076d766745463ab7e1d73436 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 11 Nov 2021 21:43:06 +0100
Subject: [PATCH 0941/5547] Ensure samples & sample points are carried over
 during conversion

---
 .../Editor/TestSceneSliderStreamConversion.cs            | 6 ++++--
 .../Edit/Blueprints/Sliders/SliderSelectionBlueprint.cs  | 9 ++++++++-
 2 files changed, 12 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderStreamConversion.cs b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderStreamConversion.cs
index f8cbd046d1..11ab05c84e 100644
--- a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderStreamConversion.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderStreamConversion.cs
@@ -66,7 +66,7 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
         }
 
         [Test]
-        public void TestConversionPreservesNewCombo()
+        public void TestConversionPreservesSliderProperties()
         {
             Slider slider = null;
 
@@ -117,7 +117,9 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
             bool matches(HitCircle circle, double time, Vector2 position, bool startsNewCombo) =>
                 Precision.AlmostEquals(circle.StartTime, time, 1)
                 && Precision.AlmostEquals(circle.Position, position, 0.01f)
-                && circle.NewCombo == startsNewCombo;
+                && circle.NewCombo == startsNewCombo
+                && circle.Samples.SequenceEqual(slider.HeadCircle.Samples)
+                && circle.SampleControlPoint.IsRedundant(slider.SampleControlPoint);
         }
 
         private bool sliderRestored(Slider slider)
diff --git a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/SliderSelectionBlueprint.cs b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/SliderSelectionBlueprint.cs
index ecf134dd15..d646d90d99 100644
--- a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/SliderSelectionBlueprint.cs
+++ b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/SliderSelectionBlueprint.cs
@@ -12,6 +12,7 @@ using osu.Framework.Graphics.Primitives;
 using osu.Framework.Graphics.UserInterface;
 using osu.Framework.Input.Events;
 using osu.Framework.Utils;
+using osu.Game.Beatmaps.ControlPoints;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Rulesets.Edit;
 using osu.Game.Rulesets.Objects;
@@ -268,11 +269,17 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders
             while (!Precision.DefinitelyBigger(time, HitObject.GetEndTime(), 1))
             {
                 Vector2 position = HitObject.Position + HitObject.Path.PositionAt((time - HitObject.StartTime) / HitObject.Duration);
+
+                var samplePoint = (SampleControlPoint)HitObject.SampleControlPoint.DeepClone();
+                samplePoint.Time = time;
+
                 editorBeatmap.Add(new HitCircle
                 {
                     StartTime = time,
                     Position = position,
-                    NewCombo = i == 0 && HitObject.NewCombo
+                    NewCombo = i == 0 && HitObject.NewCombo,
+                    SampleControlPoint = samplePoint,
+                    Samples = HitObject.HeadCircle.Samples.Select(s => s.With()).ToList()
                 });
 
                 i += 1;

From 8aa04864cef399d3408202bba6ddc9b202da0aed Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 11 Nov 2021 22:20:16 +0100
Subject: [PATCH 0942/5547] Add support for converting sliders with repeats to
 streams

---
 .../Editor/TestSceneSliderStreamConversion.cs | 63 ++++++++++++++++---
 .../Sliders/SliderSelectionBlueprint.cs       | 11 +++-
 2 files changed, 63 insertions(+), 11 deletions(-)

diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderStreamConversion.cs b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderStreamConversion.cs
index 11ab05c84e..559d612037 100644
--- a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderStreamConversion.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderStreamConversion.cs
@@ -30,7 +30,12 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
 
             convertToStream();
 
-            AddAssert("stream created", () => streamCreatedFor(slider, 1 / 4d));
+            AddAssert("stream created", () => streamCreatedFor(slider,
+                (time: 0, pathPosition: 0),
+                (time: 0.25, pathPosition: 0.25),
+                (time: 0.5, pathPosition: 0.5),
+                (time: 0.75, pathPosition: 0.75),
+                (time: 1, pathPosition: 1)));
 
             AddStep("undo", () => Editor.Undo());
             AddAssert("slider restored", () => sliderRestored(slider));
@@ -44,7 +49,16 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
             AddStep("change beat divisor", () => beatDivisor.Value = 8);
 
             convertToStream();
-            AddAssert("stream created", () => streamCreatedFor(slider, 1 / 8d));
+            AddAssert("stream created", () => streamCreatedFor(slider,
+                (time: 0, pathPosition: 0),
+                (time: 0.125, pathPosition: 0.125),
+                (time: 0.25, pathPosition: 0.25),
+                (time: 0.375, pathPosition: 0.375),
+                (time: 0.5, pathPosition: 0.5),
+                (time: 0.625, pathPosition: 0.625),
+                (time: 0.75, pathPosition: 0.75),
+                (time: 0.875, pathPosition: 0.875),
+                (time: 1, pathPosition: 1)));
         }
 
         [Test]
@@ -62,7 +76,32 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
 
             convertToStream();
 
-            AddAssert("stream created", () => streamCreatedFor(slider, 2 / 3d));
+            AddAssert("stream created", () => streamCreatedFor(slider,
+                (time: 0, pathPosition: 0),
+                (time: 2 / 3d, pathPosition: 2 / 3d)));
+        }
+
+        [Test]
+        public void TestConversionWithRepeats()
+        {
+            Slider slider = null;
+
+            AddStep("select first slider with repeats", () =>
+            {
+                slider = (Slider)EditorBeatmap.HitObjects.First(h => h is Slider s && s.RepeatCount > 0);
+                EditorClock.Seek(slider.StartTime);
+                EditorBeatmap.SelectedHitObjects.Add(slider);
+            });
+            AddStep("change beat divisor", () => beatDivisor.Value = 2);
+
+            convertToStream();
+
+            AddAssert("stream created", () => streamCreatedFor(slider,
+                (time: 0, pathPosition: 0),
+                (time: 0.25, pathPosition: 0.5),
+                (time: 0.5, pathPosition: 1),
+                (time: 0.75, pathPosition: 0.5),
+                (time: 1, pathPosition: 0)));
         }
 
         [Test]
@@ -79,7 +118,12 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
 
             convertToStream();
 
-            AddAssert("stream created", () => streamCreatedFor(slider, 1 / 4d));
+            AddAssert("stream created", () => streamCreatedFor(slider,
+                (time: 0, pathPosition: 0),
+                (time: 0.25, pathPosition: 0.25),
+                (time: 0.5, pathPosition: 0.5),
+                (time: 0.75, pathPosition: 0.75),
+                (time: 1, pathPosition: 1)));
 
             AddStep("undo", () => Editor.Undo());
             AddAssert("slider restored", () => sliderRestored(slider));
@@ -97,18 +141,17 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
             });
         }
 
-        private bool streamCreatedFor(Slider slider, double spacing)
+        private bool streamCreatedFor(Slider slider, params (double time, double pathPosition)[] expectedCircles)
         {
             if (EditorBeatmap.HitObjects.Contains(slider))
                 return false;
 
-            for (int i = 0; i * spacing <= 1; ++i)
+            foreach ((double expectedTime, double expectedPathPosition) in expectedCircles)
             {
-                double progress = i * spacing;
-                double time = slider.StartTime + progress * slider.Duration;
-                Vector2 position = slider.Position + slider.Path.PositionAt(progress);
+                double time = slider.StartTime + slider.Duration * expectedTime;
+                Vector2 position = slider.Position + slider.Path.PositionAt(expectedPathPosition);
 
-                if (!EditorBeatmap.HitObjects.OfType<HitCircle>().Any(h => matches(h, time, position, slider.NewCombo && progress == 0)))
+                if (!EditorBeatmap.HitObjects.OfType<HitCircle>().Any(h => matches(h, time, position, slider.NewCombo && expectedTime == 0)))
                     return false;
             }
 
diff --git a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/SliderSelectionBlueprint.cs b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/SliderSelectionBlueprint.cs
index d646d90d99..17a62fc61c 100644
--- a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/SliderSelectionBlueprint.cs
+++ b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/SliderSelectionBlueprint.cs
@@ -16,6 +16,7 @@ using osu.Game.Beatmaps.ControlPoints;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Rulesets.Edit;
 using osu.Game.Rulesets.Objects;
+using osu.Game.Rulesets.Objects.Types;
 using osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders.Components;
 using osu.Game.Rulesets.Osu.Objects;
 using osu.Game.Rulesets.Osu.Objects.Drawables;
@@ -268,7 +269,15 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders
 
             while (!Precision.DefinitelyBigger(time, HitObject.GetEndTime(), 1))
             {
-                Vector2 position = HitObject.Position + HitObject.Path.PositionAt((time - HitObject.StartTime) / HitObject.Duration);
+                // positionWithRepeats is a fractional number in the range of [0, HitObject.SpanCount()]
+                // and indicates how many fractional spans of a slider have passed up to time.
+                double positionWithRepeats = (time - HitObject.StartTime) / HitObject.Duration * HitObject.SpanCount();
+                double pathPosition = positionWithRepeats - (int)positionWithRepeats;
+                // every second span is in the reverse direction - need to reverse the path position.
+                if (Precision.AlmostBigger(positionWithRepeats % 2, 1))
+                    pathPosition = 1 - pathPosition;
+
+                Vector2 position = HitObject.Position + HitObject.Path.PositionAt(pathPosition);
 
                 var samplePoint = (SampleControlPoint)HitObject.SampleControlPoint.DeepClone();
                 samplePoint.Time = time;

From cdfe022805d7c0601460780f9824b05059c00c44 Mon Sep 17 00:00:00 2001
From: apollo-dw <83023433+apollo-dw@users.noreply.github.com>
Date: Fri, 12 Nov 2021 00:56:08 +0000
Subject: [PATCH 0943/5547] Fix potential NaN values

---
 osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs b/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs
index 6908521dff..6ccda57aad 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs
@@ -38,7 +38,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty
             double speedRating = Math.Sqrt(skills[2].DifficultyValue()) * difficulty_multiplier;
             double flashlightRating = Math.Sqrt(skills[3].DifficultyValue()) * difficulty_multiplier;
 
-            double sliderFactor = aimRatingNoSliders / aimRating;
+            double sliderFactor = (aimRating > 0) ? aimRatingNoSliders / aimRating : 1;
 
             if (mods.Any(h => h is OsuModRelax))
                 speedRating = 0.0;

From e31ea49dd41091c0252b01776ce71829ba023436 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 12 Nov 2021 13:18:46 +0900
Subject: [PATCH 0944/5547] Use fixed width font for performance points counter

Matches all other display counters for in-game metrics.

As mentioned in https://github.com/ppy/osu/discussions/15584.
---
 osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs b/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs
index ef289c2a20..e09adad081 100644
--- a/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs
+++ b/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs
@@ -184,7 +184,7 @@ namespace osu.Game.Screens.Play.HUD
                         {
                             Anchor = Anchor.BottomLeft,
                             Origin = Anchor.BottomLeft,
-                            Font = OsuFont.Numeric.With(size: 16)
+                            Font = OsuFont.Numeric.With(size: 16, fixedWidth: true)
                         },
                         new OsuSpriteText
                         {

From b9f9c27770b8d14933d6a2adbf3f3b6e56354983 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 12 Nov 2021 13:59:22 +0900
Subject: [PATCH 0945/5547] Standardise spacing and padding between UR and PP
 counters

---
 osu.Game/Screens/Play/HUD/UnstableRateCounter.cs | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/Play/HUD/UnstableRateCounter.cs b/osu.Game/Screens/Play/HUD/UnstableRateCounter.cs
index 6cd9ca6154..235f0f01fd 100644
--- a/osu.Game/Screens/Play/HUD/UnstableRateCounter.cs
+++ b/osu.Game/Screens/Play/HUD/UnstableRateCounter.cs
@@ -15,6 +15,7 @@ using osu.Game.Graphics.UserInterface;
 using osu.Game.Rulesets.Judgements;
 using osu.Game.Rulesets.Scoring;
 using osu.Game.Skinning;
+using osuTK;
 
 namespace osu.Game.Screens.Play.HUD
 {
@@ -98,6 +99,7 @@ namespace osu.Game.Screens.Play.HUD
                 InternalChild = new FillFlowContainer
                 {
                     AutoSizeAxes = Axes.Both,
+                    Spacing = new Vector2(2),
                     Children = new Drawable[]
                     {
                         text = new OsuSpriteText
@@ -111,8 +113,8 @@ namespace osu.Game.Screens.Play.HUD
                             Anchor = Anchor.BottomLeft,
                             Origin = Anchor.BottomLeft,
                             Font = OsuFont.Numeric.With(size: 8, fixedWidth: true),
-                            Text = "UR",
-                            Padding = new MarginPadding { Bottom = 1.5f },
+                            Text = @"UR",
+                            Padding = new MarginPadding { Bottom = 1.5f }, // align baseline better
                         }
                     }
                 };

From 512094c17bd2511b3c06de55ac4c7b3a51e83ee7 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 12 Nov 2021 14:00:36 +0900
Subject: [PATCH 0946/5547] Update tests

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

diff --git a/osu.Game.Rulesets.Osu.Tests/OsuDifficultyCalculatorTest.cs b/osu.Game.Rulesets.Osu.Tests/OsuDifficultyCalculatorTest.cs
index b0e173e752..9148f0715c 100644
--- a/osu.Game.Rulesets.Osu.Tests/OsuDifficultyCalculatorTest.cs
+++ b/osu.Game.Rulesets.Osu.Tests/OsuDifficultyCalculatorTest.cs
@@ -15,13 +15,13 @@ namespace osu.Game.Rulesets.Osu.Tests
     {
         protected override string ResourceAssembly => "osu.Game.Rulesets.Osu";
 
-        [TestCase(6.6975550434910005d, "diffcalc-test")]
-        [TestCase(1.4670676815251105d, "zero-length-sliders")]
+        [TestCase(6.6972307565739273d, "diffcalc-test")]
+        [TestCase(1.4484754139145539d, "zero-length-sliders")]
         public void Test(double expected, string name)
             => base.Test(expected, name);
 
-        [TestCase(8.9389769779826267d, "diffcalc-test")]
-        [TestCase(1.7786917985891204d, "zero-length-sliders")]
+        [TestCase(8.9382559208689809d, "diffcalc-test")]
+        [TestCase(1.7548875851757628d, "zero-length-sliders")]
         public void TestClockRateAdjusted(double expected, string name)
             => Test(expected, name, new OsuModDoubleTime());
 

From 321aa456a785ce47bf2bdf44cf11faa82beaac7b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 12 Nov 2021 14:04:34 +0900
Subject: [PATCH 0947/5547] Adjust button size slightly

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

diff --git a/osu.Game/Screens/Edit/Editor.cs b/osu.Game/Screens/Edit/Editor.cs
index a67ef070f6..d7e77b7fbf 100644
--- a/osu.Game/Screens/Edit/Editor.cs
+++ b/osu.Game/Screens/Edit/Editor.cs
@@ -267,7 +267,7 @@ namespace osu.Game.Screens.Edit
                                         new Dimension(GridSizeMode.Absolute, 220),
                                         new Dimension(),
                                         new Dimension(GridSizeMode.Absolute, 220),
-                                        new Dimension(GridSizeMode.Absolute, 160),
+                                        new Dimension(GridSizeMode.Absolute, 120),
                                     },
                                     Content = new[]
                                     {

From e891c0ce5362504d95d25120b5a449c5583596d6 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 12 Nov 2021 14:13:11 +0900
Subject: [PATCH 0948/5547] Add keyboard shortcut to start test mode in editor

---
 osu.Game/Input/Bindings/GlobalActionContainer.cs       | 6 +++++-
 osu.Game/Localisation/GlobalActionKeyBindingStrings.cs | 5 +++++
 osu.Game/Screens/Edit/Editor.cs                        | 4 ++++
 3 files changed, 14 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Input/Bindings/GlobalActionContainer.cs b/osu.Game/Input/Bindings/GlobalActionContainer.cs
index 22446634c1..c71cb6a00a 100644
--- a/osu.Game/Input/Bindings/GlobalActionContainer.cs
+++ b/osu.Game/Input/Bindings/GlobalActionContainer.cs
@@ -76,6 +76,7 @@ namespace osu.Game.Input.Bindings
             new KeyBinding(new[] { InputKey.J }, GlobalAction.EditorNudgeLeft),
             new KeyBinding(new[] { InputKey.K }, GlobalAction.EditorNudgeRight),
             new KeyBinding(new[] { InputKey.G }, GlobalAction.EditorCycleGridDisplayMode),
+            new KeyBinding(new[] { InputKey.F5 }, GlobalAction.EditorTestGameplay),
         };
 
         public IEnumerable<KeyBinding> InGameKeyBindings => new[]
@@ -288,6 +289,9 @@ namespace osu.Game.Input.Bindings
         ToggleChatFocus,
 
         [LocalisableDescription(typeof(GlobalActionKeyBindingStrings), nameof(GlobalActionKeyBindingStrings.EditorCycleGridDisplayMode))]
-        EditorCycleGridDisplayMode
+        EditorCycleGridDisplayMode,
+
+        [LocalisableDescription(typeof(GlobalActionKeyBindingStrings), nameof(GlobalActionKeyBindingStrings.EditorTestGameplay))]
+        EditorTestGameplay
     }
 }
diff --git a/osu.Game/Localisation/GlobalActionKeyBindingStrings.cs b/osu.Game/Localisation/GlobalActionKeyBindingStrings.cs
index 06f1b094bf..35a0c2ae74 100644
--- a/osu.Game/Localisation/GlobalActionKeyBindingStrings.cs
+++ b/osu.Game/Localisation/GlobalActionKeyBindingStrings.cs
@@ -169,6 +169,11 @@ namespace osu.Game.Localisation
         /// </summary>
         public static LocalisableString EditorCycleGridDisplayMode => new TranslatableString(getKey(@"editor_cycle_grid_display_mode"), @"Cycle grid display mode");
 
+        /// <summary>
+        /// "Test gameplay"
+        /// </summary>
+        public static LocalisableString EditorTestGameplay => new TranslatableString(getKey(@"editor_test_gameplay"), @"Test gameplay");
+
         /// <summary>
         /// "Hold for HUD"
         /// </summary>
diff --git a/osu.Game/Screens/Edit/Editor.cs b/osu.Game/Screens/Edit/Editor.cs
index d7e77b7fbf..77f097b79a 100644
--- a/osu.Game/Screens/Edit/Editor.cs
+++ b/osu.Game/Screens/Edit/Editor.cs
@@ -468,6 +468,10 @@ namespace osu.Game.Screens.Edit
                     menuBar.Mode.Value = EditorScreenMode.Verify;
                     return true;
 
+                case GlobalAction.EditorTestGameplay:
+                    testGameplay();
+                    return true;
+
                 default:
                     return false;
             }

From 113c95f3f55104856c44fc2a0ee0ba82f747f168 Mon Sep 17 00:00:00 2001
From: Jamie Taylor <me@nekodex.net>
Date: Fri, 12 Nov 2021 14:22:43 +0900
Subject: [PATCH 0949/5547] Only apply high-pass temporarily

---
 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 734caa43d4..fd54c10d86 100644
--- a/osu.Game/Screens/Play/PlayerLoader.cs
+++ b/osu.Game/Screens/Play/PlayerLoader.cs
@@ -356,7 +356,7 @@ namespace osu.Game.Screens.Play
             content.FadeInFromZero(400);
             content.ScaleTo(1, 650, Easing.OutQuint).Then().Schedule(prepareNewPlayer);
             lowPassFilter.CutoffTo(1000, 650, Easing.OutQuint);
-            highPassFilter.CutoffTo(150);
+            highPassFilter.CutoffTo(300).Then().CutoffTo(0, 1250); // 1250 is to line up with the appearance of MetadataInfo (750 delay + 500 fade-in)
 
             ApplyToBackground(b => b?.FadeColour(Color4.White, 800, Easing.OutQuint));
         }

From 54ae307a3d7ca38733065a7556a0978312d0cec1 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 12 Nov 2021 14:42:33 +0900
Subject: [PATCH 0950/5547] Trigger test via button click when using keyboard
 shortcut

---
 osu.Game/Screens/Edit/Editor.cs | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/Edit/Editor.cs b/osu.Game/Screens/Edit/Editor.cs
index 77f097b79a..738f607cc8 100644
--- a/osu.Game/Screens/Edit/Editor.cs
+++ b/osu.Game/Screens/Edit/Editor.cs
@@ -91,6 +91,8 @@ namespace osu.Game.Screens.Edit
 
         private DependencyContainer dependencies;
 
+        private TestGameplayButton testGameplayButton;
+
         private bool isNewBeatmap;
 
         protected override UserActivity InitialActivity => new UserActivity.Editing(Beatmap.Value.BeatmapInfo);
@@ -289,7 +291,7 @@ namespace osu.Game.Screens.Edit
                                                 Padding = new MarginPadding { Left = 10 },
                                                 Child = new PlaybackControl { RelativeSizeAxes = Axes.Both },
                                             },
-                                            new TestGameplayButton
+                                            testGameplayButton = new TestGameplayButton
                                             {
                                                 RelativeSizeAxes = Axes.Both,
                                                 Padding = new MarginPadding { Left = 10 },
@@ -469,7 +471,7 @@ namespace osu.Game.Screens.Edit
                     return true;
 
                 case GlobalAction.EditorTestGameplay:
-                    testGameplay();
+                    testGameplayButton.TriggerClick();
                     return true;
 
                 default:

From 98dcf487da8b6eb14c7fea68ac38b171c760cf53 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 12 Nov 2021 15:25:59 +0900
Subject: [PATCH 0951/5547] Add fallback case for `GetDisplayString` if called
 on a null reference

---
 osu.Game.Tests/Models/DisplayStringTest.cs | 21 +++++++++++++++------
 osu.Game/Extensions/ModelExtensions.cs     |  2 +-
 2 files changed, 16 insertions(+), 7 deletions(-)

diff --git a/osu.Game.Tests/Models/DisplayStringTest.cs b/osu.Game.Tests/Models/DisplayStringTest.cs
index cac5dd1aaa..95af21eb5f 100644
--- a/osu.Game.Tests/Models/DisplayStringTest.cs
+++ b/osu.Game.Tests/Models/DisplayStringTest.cs
@@ -10,19 +10,28 @@ using osu.Game.Rulesets;
 using osu.Game.Scoring;
 using osu.Game.Users;
 
+#nullable enable
+
 namespace osu.Game.Tests.Models
 {
     [TestFixture]
     public class DisplayStringTest
     {
+        [Test]
+        public void TestNull()
+        {
+            IBeatmapSetInfo? beatmap = null;
+            Assert.That(beatmap.GetDisplayString(), Is.EqualTo("null"));
+        }
+
         [Test]
         public void TestBeatmapSet()
         {
             var mock = new Mock<IBeatmapSetInfo>();
 
-            mock.Setup(m => m.Metadata.Artist).Returns("artist");
-            mock.Setup(m => m.Metadata.Title).Returns("title");
-            mock.Setup(m => m.Metadata.Author.Username).Returns("author");
+            mock.Setup(m => m.Metadata!.Artist).Returns("artist");
+            mock.Setup(m => m.Metadata!.Title).Returns("title");
+            mock.Setup(m => m.Metadata!.Author.Username).Returns("author");
 
             Assert.That(mock.Object.GetDisplayString(), Is.EqualTo("artist - title (author)"));
         }
@@ -32,9 +41,9 @@ namespace osu.Game.Tests.Models
         {
             var mock = new Mock<IBeatmapSetInfo>();
 
-            mock.Setup(m => m.Metadata.Artist).Returns("artist");
-            mock.Setup(m => m.Metadata.Title).Returns("title");
-            mock.Setup(m => m.Metadata.Author.Username).Returns(string.Empty);
+            mock.Setup(m => m.Metadata!.Artist).Returns("artist");
+            mock.Setup(m => m.Metadata!.Title).Returns("title");
+            mock.Setup(m => m.Metadata!.Author.Username).Returns(string.Empty);
 
             Assert.That(mock.Object.GetDisplayString(), Is.EqualTo("artist - title"));
         }
diff --git a/osu.Game/Extensions/ModelExtensions.cs b/osu.Game/Extensions/ModelExtensions.cs
index 5c96add076..d8e0938d46 100644
--- a/osu.Game/Extensions/ModelExtensions.cs
+++ b/osu.Game/Extensions/ModelExtensions.cs
@@ -54,7 +54,7 @@ namespace osu.Game.Extensions
             }
 
             // fallback in case none of the above happens to match.
-            result ??= model.ToString();
+            result ??= model?.ToString() ?? @"null";
             return result;
         }
     }

From ad8a710a690b3ee2888c145b171f9000bd21df3a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 12 Nov 2021 15:26:28 +0900
Subject: [PATCH 0952/5547] Fix failed imports being incorrectly considered as
 successfully importing for notification purposes

---
 osu.Game/Database/ArchiveModelManager.cs | 2 +-
 osu.Game/Database/IModelImporter.cs      | 8 +++++---
 2 files changed, 6 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Database/ArchiveModelManager.cs b/osu.Game/Database/ArchiveModelManager.cs
index 320f108886..e8b6996869 100644
--- a/osu.Game/Database/ArchiveModelManager.cs
+++ b/osu.Game/Database/ArchiveModelManager.cs
@@ -264,7 +264,7 @@ namespace osu.Game.Database
                 model = CreateModel(archive);
 
                 if (model == null)
-                    return Task.FromResult<ILive<TModel>>(new EntityFrameworkLive<TModel>(null));
+                    return Task.FromResult<ILive<TModel>>(null);
             }
             catch (TaskCanceledException)
             {
diff --git a/osu.Game/Database/IModelImporter.cs b/osu.Game/Database/IModelImporter.cs
index 5d0a044578..d00cfb2035 100644
--- a/osu.Game/Database/IModelImporter.cs
+++ b/osu.Game/Database/IModelImporter.cs
@@ -7,6 +7,8 @@ using System.Threading.Tasks;
 using osu.Game.IO.Archives;
 using osu.Game.Overlays.Notifications;
 
+#nullable enable
+
 namespace osu.Game.Database
 {
     /// <summary>
@@ -26,7 +28,7 @@ namespace osu.Game.Database
         /// <param name="lowPriority">Whether this is a low priority import.</param>
         /// <param name="cancellationToken">An optional cancellation token.</param>
         /// <returns>The imported model, if successful.</returns>
-        Task<ILive<TModel>> Import(ImportTask task, bool lowPriority = false, CancellationToken cancellationToken = default);
+        Task<ILive<TModel>?> Import(ImportTask task, bool lowPriority = false, CancellationToken cancellationToken = default);
 
         /// <summary>
         /// Silently import an item from an <see cref="ArchiveReader"/>.
@@ -34,7 +36,7 @@ namespace osu.Game.Database
         /// <param name="archive">The archive to be imported.</param>
         /// <param name="lowPriority">Whether this is a low priority import.</param>
         /// <param name="cancellationToken">An optional cancellation token.</param>
-        Task<ILive<TModel>> Import(ArchiveReader archive, bool lowPriority = false, CancellationToken cancellationToken = default);
+        Task<ILive<TModel>?> Import(ArchiveReader archive, bool lowPriority = false, CancellationToken cancellationToken = default);
 
         /// <summary>
         /// Silently import an item from a <typeparamref name="TModel"/>.
@@ -43,7 +45,7 @@ namespace osu.Game.Database
         /// <param name="archive">An optional archive to use for model population.</param>
         /// <param name="lowPriority">Whether this is a low priority import.</param>
         /// <param name="cancellationToken">An optional cancellation token.</param>
-        Task<ILive<TModel>> Import(TModel item, ArchiveReader archive = null, bool lowPriority = false, CancellationToken cancellationToken = default);
+        Task<ILive<TModel>?> Import(TModel item, ArchiveReader? archive = null, bool lowPriority = false, CancellationToken cancellationToken = default);
 
         /// <summary>
         /// A user displayable name for the model type associated with this manager.

From 5345018d4c98be6d4a82a2d571b073ee426fdbfc Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 12 Nov 2021 15:48:38 +0900
Subject: [PATCH 0953/5547] Add test coverage of failed imports

---
 .../Beatmaps/IO/ImportBeatmapTest.cs          | 36 +++++++++++++++++++
 .../Database/BeatmapImporterTests.cs          | 29 +++++++++++++++
 2 files changed, 65 insertions(+)

diff --git a/osu.Game.Tests/Beatmaps/IO/ImportBeatmapTest.cs b/osu.Game.Tests/Beatmaps/IO/ImportBeatmapTest.cs
index 3093a5719d..c206f874fd 100644
--- a/osu.Game.Tests/Beatmaps/IO/ImportBeatmapTest.cs
+++ b/osu.Game.Tests/Beatmaps/IO/ImportBeatmapTest.cs
@@ -18,6 +18,7 @@ using osu.Game.Beatmaps;
 using osu.Game.Database;
 using osu.Game.IO;
 using osu.Game.Online.API.Requests.Responses;
+using osu.Game.Overlays.Notifications;
 using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Osu.Objects;
 using osu.Game.Scoring;
@@ -387,6 +388,41 @@ namespace osu.Game.Tests.Beatmaps.IO
             }
         }
 
+        [Test]
+        public async Task TestModelCreationFailureDoesntReturn()
+        {
+            using (HeadlessGameHost host = new CleanRunHeadlessGameHost(nameof(ImportBeatmapTest)))
+            {
+                try
+                {
+                    var osu = LoadOsuIntoHost(host);
+                    var importer = osu.Dependencies.Get<BeatmapManager>();
+
+                    var progressNotification = new ImportProgressNotification();
+
+                    var zipStream = new MemoryStream();
+
+                    using (var zip = ZipArchive.Create())
+                        zip.SaveTo(zipStream, new ZipWriterOptions(CompressionType.Deflate));
+
+                    var imported = await importer.Import(
+                        progressNotification,
+                        new ImportTask(zipStream, string.Empty)
+                    );
+
+                    checkBeatmapSetCount(osu, 0);
+                    checkBeatmapCount(osu, 0);
+
+                    Assert.IsEmpty(imported);
+                    Assert.AreEqual(ProgressNotificationState.Cancelled, progressNotification.State);
+                }
+                finally
+                {
+                    host.Exit();
+                }
+            }
+        }
+
         [Test]
         public async Task TestRollbackOnFailure()
         {
diff --git a/osu.Game.Tests/Database/BeatmapImporterTests.cs b/osu.Game.Tests/Database/BeatmapImporterTests.cs
index e1fe1e224e..88d16c8a36 100644
--- a/osu.Game.Tests/Database/BeatmapImporterTests.cs
+++ b/osu.Game.Tests/Database/BeatmapImporterTests.cs
@@ -16,6 +16,7 @@ using osu.Game.Beatmaps;
 using osu.Game.Database;
 using osu.Game.IO.Archives;
 using osu.Game.Models;
+using osu.Game.Overlays.Notifications;
 using osu.Game.Stores;
 using osu.Game.Tests.Resources;
 using Realms;
@@ -367,6 +368,34 @@ namespace osu.Game.Tests.Database
             });
         }
 
+        [Test]
+        public void TestModelCreationFailureDoesntReturn()
+        {
+            RunTestWithRealmAsync(async (realmFactory, storage) =>
+            {
+                using var importer = new BeatmapImporter(realmFactory, storage);
+                using var store = new RealmRulesetStore(realmFactory, storage);
+
+                var progressNotification = new ImportProgressNotification();
+
+                var zipStream = new MemoryStream();
+
+                using (var zip = ZipArchive.Create())
+                    zip.SaveTo(zipStream, new ZipWriterOptions(CompressionType.Deflate));
+
+                var imported = await importer.Import(
+                    progressNotification,
+                    new ImportTask(zipStream, string.Empty)
+                );
+
+                checkBeatmapSetCount(realmFactory.Context, 0);
+                checkBeatmapCount(realmFactory.Context, 0);
+
+                Assert.IsEmpty(imported);
+                Assert.AreEqual(ProgressNotificationState.Cancelled, progressNotification.State);
+            });
+        }
+
         [Test]
         public void TestRollbackOnFailure()
         {

From 9fc4bb70553dda53c8b56e1cdeaea39e6f193f32 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 12 Nov 2021 15:09:01 +0900
Subject: [PATCH 0954/5547] Fix incorrect xmldoc

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

diff --git a/osu.Game/IO/Archives/LegacyByteArrayReader.cs b/osu.Game/IO/Archives/LegacyByteArrayReader.cs
index 0c3620403f..ea8ff3bbe0 100644
--- a/osu.Game/IO/Archives/LegacyByteArrayReader.cs
+++ b/osu.Game/IO/Archives/LegacyByteArrayReader.cs
@@ -7,7 +7,7 @@ using System.IO;
 namespace osu.Game.IO.Archives
 {
     /// <summary>
-    /// Allows reading a single file from the provided stream.
+    /// Allows reading a single file from the provided byte array.
     /// </summary>
     public class LegacyByteArrayReader : ArchiveReader
     {

From adf81d7fcd024e30a943a59d3f7ed9cc3584c3c7 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 12 Nov 2021 16:39:17 +0900
Subject: [PATCH 0955/5547] Add pathway to correctly handle stream-based
 imports which are not zip archives

---
 osu.Game/Database/ImportTask.cs | 26 +++++++++++++++++++++++---
 osu.Game/Utils/ZipUtils.cs      | 28 ++++++++++++++++++++++++++++
 2 files changed, 51 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Database/ImportTask.cs b/osu.Game/Database/ImportTask.cs
index 1433a567a9..1fb5a42630 100644
--- a/osu.Game/Database/ImportTask.cs
+++ b/osu.Game/Database/ImportTask.cs
@@ -47,10 +47,30 @@ namespace osu.Game.Database
         /// </summary>
         public ArchiveReader GetReader()
         {
-            if (Stream != null)
-                return new ZipArchiveReader(Stream, Path);
+            return Stream != null
+                ? getReaderFrom(Stream)
+                : getReaderFrom(Path);
+        }
 
-            return getReaderFrom(Path);
+        /// <summary>
+        /// Creates an <see cref="ArchiveReader"/> from a stream.
+        /// </summary>
+        /// <param name="stream">A seekable stream containing the archive content.</param>
+        /// <returns>A reader giving access to the archive's content.</returns>
+        private ArchiveReader getReaderFrom(Stream stream)
+        {
+            if (!(stream is MemoryStream memoryStream))
+            {
+                // This isn't used in any current path. May need to reconsider for performance reasons (ie. if we don't expect the incoming stream to be copied out).
+                byte[] buffer = new byte[stream.Length];
+                stream.Read(buffer, 0, (int)stream.Length);
+                memoryStream = new MemoryStream(buffer);
+            }
+
+            if (ZipUtils.IsZipArchive(memoryStream))
+                return new ZipArchiveReader(memoryStream, Path);
+
+            return new LegacyByteArrayReader(memoryStream.ToArray(), Path);
         }
 
         /// <summary>
diff --git a/osu.Game/Utils/ZipUtils.cs b/osu.Game/Utils/ZipUtils.cs
index cd4d876451..16eb1c7e4e 100644
--- a/osu.Game/Utils/ZipUtils.cs
+++ b/osu.Game/Utils/ZipUtils.cs
@@ -9,6 +9,34 @@ namespace osu.Game.Utils
 {
     public static class ZipUtils
     {
+        public static bool IsZipArchive(Stream stream)
+        {
+            try
+            {
+                stream.Seek(0, SeekOrigin.Begin);
+
+                using (var arc = ZipArchive.Open(stream))
+                {
+                    foreach (var entry in arc.Entries)
+                    {
+                        using (entry.OpenEntryStream())
+                        {
+                        }
+                    }
+                }
+
+                return true;
+            }
+            catch (Exception)
+            {
+                return false;
+            }
+            finally
+            {
+                stream.Seek(0, SeekOrigin.Begin);
+            }
+        }
+
         public static bool IsZipArchive(string path)
         {
             if (!File.Exists(path))

From 9fb2402781ad91c197d51aeec716b0000f52c4d1 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 12 Nov 2021 17:31:25 +0900
Subject: [PATCH 0956/5547] Remove unnecessary parens

---
 osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs b/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs
index 6ccda57aad..558ddc16ef 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs
@@ -38,7 +38,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty
             double speedRating = Math.Sqrt(skills[2].DifficultyValue()) * difficulty_multiplier;
             double flashlightRating = Math.Sqrt(skills[3].DifficultyValue()) * difficulty_multiplier;
 
-            double sliderFactor = (aimRating > 0) ? aimRatingNoSliders / aimRating : 1;
+            double sliderFactor = aimRating > 0 ? aimRatingNoSliders / aimRating : 1;
 
             if (mods.Any(h => h is OsuModRelax))
                 speedRating = 0.0;

From 6a098a86342505dcc6dbafdbb4b46cce784f4c38 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 12 Nov 2021 17:45:05 +0900
Subject: [PATCH 0957/5547] Rename `BeatmapInfo.OnlineBeatmapID` to `OnlineID`
 to match interface

---
 .../Formats/LegacyBeatmapDecoderTest.cs        |  2 +-
 .../Beatmaps/IO/ImportBeatmapTest.cs           | 12 ++++++------
 .../NonVisual/Filtering/FilterMatchingTest.cs  |  2 +-
 .../Gameplay/TestScenePlayerScoreSubmission.cs |  2 +-
 .../Visual/Gameplay/TestSceneSpectator.cs      |  2 +-
 .../TestSceneMultiSpectatorScreen.cs           |  2 +-
 .../TestSceneMultiplayerGameplayLeaderboard.cs |  2 +-
 ...SceneMultiplayerGameplayLeaderboardTeams.cs |  2 +-
 .../TestSceneMultiplayerMatchSongSelect.cs     |  2 +-
 .../TestScenePlaylistsSongSelect.cs            |  2 +-
 .../Navigation/TestScenePresentBeatmap.cs      |  8 ++++----
 .../Visual/Navigation/TestScenePresentScore.cs |  4 ++--
 .../Online/TestSceneNowPlayingCommand.cs       |  2 +-
 .../TestScenePlaylistsRoomCreation.cs          |  2 +-
 .../Visual/Ranking/TestSceneResultsScreen.cs   |  2 +-
 .../SongSelect/TestSceneBeatmapCarousel.cs     |  4 ++--
 .../SongSelect/TestSceneBeatmapLeaderboard.cs  |  2 +-
 .../TestSceneBeatmapRecommendations.cs         |  6 +++---
 .../SongSelect/TestScenePlaySongSelect.cs      | 14 +++++++-------
 osu.Game/Beatmaps/BeatmapDifficultyCache.cs    |  2 +-
 osu.Game/Beatmaps/BeatmapInfo.cs               | 11 ++++++-----
 osu.Game/Beatmaps/BeatmapModelManager.cs       | 18 +++++++++---------
 osu.Game/Beatmaps/BeatmapOnlineLookupQueue.cs  | 12 ++++++------
 .../Beatmaps/Formats/LegacyBeatmapDecoder.cs   |  2 +-
 .../Beatmaps/Formats/LegacyBeatmapEncoder.cs   |  2 +-
 osu.Game/Database/OsuDbContext.cs              |  2 +-
 osu.Game/Online/Chat/NowPlayingCommand.cs      |  2 +-
 .../Online/Multiplayer/MultiplayerClient.cs    |  2 +-
 .../OnlinePlayBeatmapAvailabilityTracker.cs    |  2 +-
 osu.Game/Online/Spectator/SpectatorClient.cs   |  2 +-
 .../Panels/BeatmapPanelDownloadButton.cs       |  2 +-
 .../Screens/OnlinePlay/Match/RoomSubScreen.cs  |  2 +-
 .../OnlinePlay/Playlists/PlaylistsPlayer.cs    |  2 +-
 osu.Game/Screens/Play/SoloPlayer.cs            |  6 +++---
 osu.Game/Screens/Ranking/SoloResultsScreen.cs  |  2 +-
 osu.Game/Screens/Select/BeatmapDetails.cs      |  2 +-
 .../Screens/Select/Carousel/CarouselBeatmap.cs |  2 +-
 .../Select/Carousel/DrawableCarouselBeatmap.cs |  4 ++--
 .../Select/Leaderboards/BeatmapLeaderboard.cs  |  2 +-
 osu.Game/Screens/Spectate/SpectatorScreen.cs   |  4 ++--
 osu.Game/Stores/BeatmapImporter.cs             |  6 +++---
 osu.Game/Tests/Beatmaps/TestBeatmap.cs         |  2 +-
 .../Multiplayer/TestMultiplayerClient.cs       |  2 +-
 osu.Game/Tests/Visual/OsuTestScene.cs          |  2 +-
 44 files changed, 86 insertions(+), 85 deletions(-)

diff --git a/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs b/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs
index 304a65e5c7..9dc144927b 100644
--- a/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs
+++ b/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs
@@ -116,7 +116,7 @@ namespace osu.Game.Tests.Beatmaps.Formats
                 Assert.AreEqual("Insane", beatmapInfo.DifficultyName);
                 Assert.AreEqual(string.Empty, metadata.Source);
                 Assert.AreEqual("MBC7 Unisphere 地球ヤバイEP Chikyu Yabai", metadata.Tags);
-                Assert.AreEqual(557821, beatmapInfo.OnlineBeatmapID);
+                Assert.AreEqual(557821, beatmapInfo.OnlineID);
                 Assert.AreEqual(241526, beatmapInfo.BeatmapSet.OnlineBeatmapSetID);
             }
         }
diff --git a/osu.Game.Tests/Beatmaps/IO/ImportBeatmapTest.cs b/osu.Game.Tests/Beatmaps/IO/ImportBeatmapTest.cs
index c206f874fd..10b9f5e0e2 100644
--- a/osu.Game.Tests/Beatmaps/IO/ImportBeatmapTest.cs
+++ b/osu.Game.Tests/Beatmaps/IO/ImportBeatmapTest.cs
@@ -542,7 +542,7 @@ namespace osu.Game.Tests.Beatmaps.IO
                     var imported = await LoadOszIntoOsu(osu);
 
                     foreach (var b in imported.Beatmaps)
-                        b.OnlineBeatmapID = null;
+                        b.OnlineID = null;
 
                     osu.Dependencies.Get<BeatmapManager>().Update(imported);
 
@@ -587,13 +587,13 @@ namespace osu.Game.Tests.Beatmaps.IO
                         {
                             new BeatmapInfo
                             {
-                                OnlineBeatmapID = 2,
+                                OnlineID = 2,
                                 Metadata = metadata,
                                 BaseDifficulty = difficulty
                             },
                             new BeatmapInfo
                             {
-                                OnlineBeatmapID = 2,
+                                OnlineID = 2,
                                 Metadata = metadata,
                                 Status = BeatmapSetOnlineStatus.Loved,
                                 BaseDifficulty = difficulty
@@ -606,8 +606,8 @@ namespace osu.Game.Tests.Beatmaps.IO
                     var imported = await manager.Import(toImport);
 
                     Assert.NotNull(imported);
-                    Assert.AreEqual(null, imported.Value.Beatmaps[0].OnlineBeatmapID);
-                    Assert.AreEqual(null, imported.Value.Beatmaps[1].OnlineBeatmapID);
+                    Assert.AreEqual(null, imported.Value.Beatmaps[0].OnlineID);
+                    Assert.AreEqual(null, imported.Value.Beatmaps[1].OnlineID);
                 }
                 finally
                 {
@@ -1078,7 +1078,7 @@ namespace osu.Game.Tests.Beatmaps.IO
 
             var set = queryBeatmapSets().First();
             foreach (BeatmapInfo b in set.Beatmaps)
-                Assert.IsTrue(set.Beatmaps.Any(c => c.OnlineBeatmapID == b.OnlineBeatmapID));
+                Assert.IsTrue(set.Beatmaps.Any(c => c.OnlineID == b.OnlineID));
             Assert.IsTrue(set.Beatmaps.Count > 0);
             var beatmap = store.GetWorkingBeatmap(set.Beatmaps.First(b => b.RulesetID == 0))?.Beatmap;
             Assert.IsTrue(beatmap?.HitObjects.Any() == true);
diff --git a/osu.Game.Tests/NonVisual/Filtering/FilterMatchingTest.cs b/osu.Game.Tests/NonVisual/Filtering/FilterMatchingTest.cs
index ec97948532..1bc663a1f9 100644
--- a/osu.Game.Tests/NonVisual/Filtering/FilterMatchingTest.cs
+++ b/osu.Game.Tests/NonVisual/Filtering/FilterMatchingTest.cs
@@ -207,7 +207,7 @@ namespace osu.Game.Tests.NonVisual.Filtering
         public void TestCriteriaMatchingBeatmapIDs(string query, bool filtered)
         {
             var beatmap = getExampleBeatmap();
-            beatmap.OnlineBeatmapID = 20201010;
+            beatmap.OnlineID = 20201010;
             beatmap.BeatmapSet = new BeatmapSetInfo { OnlineBeatmapSetID = 1535 };
 
             var criteria = new FilterCriteria { SearchText = query };
diff --git a/osu.Game.Tests/Visual/Gameplay/TestScenePlayerScoreSubmission.cs b/osu.Game.Tests/Visual/Gameplay/TestScenePlayerScoreSubmission.cs
index bf864f844c..cb5058779c 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestScenePlayerScoreSubmission.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestScenePlayerScoreSubmission.cs
@@ -215,7 +215,7 @@ namespace osu.Game.Tests.Visual.Gameplay
             createPlayerTest(false, r =>
             {
                 var beatmap = createTestBeatmap(r);
-                beatmap.BeatmapInfo.OnlineBeatmapID = null;
+                beatmap.BeatmapInfo.OnlineID = null;
                 return beatmap;
             });
 
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs
index 20e859dd2b..9fadbe02bd 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs
@@ -61,7 +61,7 @@ namespace osu.Game.Tests.Visual.Gameplay
             AddStep("import beatmap", () =>
             {
                 importedBeatmap = ImportBeatmapTest.LoadOszIntoOsu(game, virtualTrack: true).Result;
-                importedBeatmapId = importedBeatmap.Beatmaps.First(b => b.RulesetID == 0).OnlineBeatmapID ?? -1;
+                importedBeatmapId = importedBeatmap.Beatmaps.First(b => b.RulesetID == 0).OnlineID ?? -1;
             });
         }
 
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs
index fdd01446b9..b10856b704 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs
@@ -48,7 +48,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             importedSet = ImportBeatmapTest.LoadOszIntoOsu(game, virtualTrack: true).Result;
             importedBeatmap = importedSet.Beatmaps.First(b => b.RulesetID == 0);
-            importedBeatmapId = importedBeatmap.OnlineBeatmapID ?? -1;
+            importedBeatmapId = importedBeatmap.OnlineID ?? -1;
         }
 
         [SetUp]
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs
index 902629765f..25200560e4 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs
@@ -57,7 +57,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
                 foreach (int user in users)
                 {
-                    SpectatorClient.StartPlay(user, Beatmap.Value.BeatmapInfo.OnlineBeatmapID ?? 0);
+                    SpectatorClient.StartPlay(user, Beatmap.Value.BeatmapInfo.OnlineID ?? 0);
                     multiplayerUsers.Add(OnlinePlayDependencies.Client.AddUser(new APIUser { Id = user }, true));
                 }
 
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboardTeams.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboardTeams.cs
index af4e696fce..16a342df8c 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboardTeams.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboardTeams.cs
@@ -61,7 +61,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
                 foreach (int user in users)
                 {
-                    SpectatorClient.StartPlay(user, Beatmap.Value.BeatmapInfo.OnlineBeatmapID ?? 0);
+                    SpectatorClient.StartPlay(user, Beatmap.Value.BeatmapInfo.OnlineID ?? 0);
                     var roomUser = OnlinePlayDependencies.Client.AddUser(new APIUser { Id = user }, true);
 
                     roomUser.MatchState = new TeamVersusUserState
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs
index 0d6b428cce..1f96a15f80 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs
@@ -57,7 +57,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 beatmaps.Add(new BeatmapInfo
                 {
                     Ruleset = rulesets.GetRuleset(i % 4),
-                    OnlineBeatmapID = beatmapId,
+                    OnlineID = beatmapId,
                     Length = length,
                     BPM = bpm,
                     BaseDifficulty = new BeatmapDifficulty()
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsSongSelect.cs b/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsSongSelect.cs
index 5e55759e01..07ce6ebffc 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsSongSelect.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsSongSelect.cs
@@ -54,7 +54,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 beatmaps.Add(new BeatmapInfo
                 {
                     Ruleset = new OsuRuleset().RulesetInfo,
-                    OnlineBeatmapID = beatmapId,
+                    OnlineID = beatmapId,
                     DifficultyName = $"{beatmapId} (length {TimeSpan.FromMilliseconds(length):m\\:ss}, bpm {bpm:0.#})",
                     Length = length,
                     BPM = bpm,
diff --git a/osu.Game.Tests/Visual/Navigation/TestScenePresentBeatmap.cs b/osu.Game.Tests/Visual/Navigation/TestScenePresentBeatmap.cs
index 5f5ebfccfb..fc4679b2e3 100644
--- a/osu.Game.Tests/Visual/Navigation/TestScenePresentBeatmap.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestScenePresentBeatmap.cs
@@ -113,14 +113,14 @@ namespace osu.Game.Tests.Visual.Navigation
                     {
                         new BeatmapInfo
                         {
-                            OnlineBeatmapID = i * 1024,
+                            OnlineID = i * 1024,
                             Metadata = metadata,
                             BaseDifficulty = difficulty,
                             Ruleset = ruleset ?? new OsuRuleset().RulesetInfo
                         },
                         new BeatmapInfo
                         {
-                            OnlineBeatmapID = i * 2048,
+                            OnlineID = i * 2048,
                             Metadata = metadata,
                             BaseDifficulty = difficulty,
                             Ruleset = ruleset ?? new OsuRuleset().RulesetInfo
@@ -145,11 +145,11 @@ namespace osu.Game.Tests.Visual.Navigation
 
         private void presentSecondDifficultyAndConfirm(Func<BeatmapSetInfo> getImport, int importedID)
         {
-            Predicate<BeatmapInfo> pred = b => b.OnlineBeatmapID == importedID * 2048;
+            Predicate<BeatmapInfo> pred = b => b.OnlineID == importedID * 2048;
             AddStep("present difficulty", () => Game.PresentBeatmap(getImport(), pred));
 
             AddUntilStep("wait for song select", () => Game.ScreenStack.CurrentScreen is Screens.Select.SongSelect);
-            AddUntilStep("correct beatmap displayed", () => Game.Beatmap.Value.BeatmapInfo.OnlineBeatmapID == importedID * 2048);
+            AddUntilStep("correct beatmap displayed", () => Game.Beatmap.Value.BeatmapInfo.OnlineID == importedID * 2048);
             AddAssert("correct ruleset selected", () => Game.Ruleset.Value.ID == getImport().Beatmaps.First().Ruleset.ID);
         }
     }
diff --git a/osu.Game.Tests/Visual/Navigation/TestScenePresentScore.cs b/osu.Game.Tests/Visual/Navigation/TestScenePresentScore.cs
index aca7ada535..062acb4d2c 100644
--- a/osu.Game.Tests/Visual/Navigation/TestScenePresentScore.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestScenePresentScore.cs
@@ -45,14 +45,14 @@ namespace osu.Game.Tests.Visual.Navigation
                     {
                         new BeatmapInfo
                         {
-                            OnlineBeatmapID = 1 * 1024,
+                            OnlineID = 1 * 1024,
                             Metadata = metadata,
                             BaseDifficulty = difficulty,
                             Ruleset = new OsuRuleset().RulesetInfo
                         },
                         new BeatmapInfo
                         {
-                            OnlineBeatmapID = 1 * 2048,
+                            OnlineID = 1 * 2048,
                             Metadata = metadata,
                             BaseDifficulty = difficulty,
                             Ruleset = new OsuRuleset().RulesetInfo
diff --git a/osu.Game.Tests/Visual/Online/TestSceneNowPlayingCommand.cs b/osu.Game.Tests/Visual/Online/TestSceneNowPlayingCommand.cs
index 366fa8a4af..7a5ee84eb4 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneNowPlayingCommand.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneNowPlayingCommand.cs
@@ -64,7 +64,7 @@ namespace osu.Game.Tests.Visual.Online
 
             AddStep("Set beatmap", () => Beatmap.Value = new DummyWorkingBeatmap(Audio, null)
             {
-                BeatmapInfo = { OnlineBeatmapID = hasOnlineId ? 1234 : (int?)null }
+                BeatmapInfo = { OnlineID = hasOnlineId ? 1234 : (int?)null }
             });
 
             AddStep("Run command", () => Add(new NowPlayingCommand()));
diff --git a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs
index cda7e95a46..f3ee01354c 100644
--- a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs
+++ b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs
@@ -121,7 +121,7 @@ namespace osu.Game.Tests.Visual.Playlists
                 beatmap.BeatmapInfo.BaseDifficulty.CircleSize = 1;
 
                 // intentionally increment online IDs to clash with import below.
-                beatmap.BeatmapInfo.OnlineBeatmapID++;
+                beatmap.BeatmapInfo.OnlineID++;
                 beatmap.BeatmapInfo.BeatmapSet.OnlineBeatmapSetID++;
 
                 importedSet = manager.Import(beatmap.BeatmapInfo.BeatmapSet).Result.Value;
diff --git a/osu.Game.Tests/Visual/Ranking/TestSceneResultsScreen.cs b/osu.Game.Tests/Visual/Ranking/TestSceneResultsScreen.cs
index 8d5d0ba8c7..423c0a048c 100644
--- a/osu.Game.Tests/Visual/Ranking/TestSceneResultsScreen.cs
+++ b/osu.Game.Tests/Visual/Ranking/TestSceneResultsScreen.cs
@@ -337,7 +337,7 @@ namespace osu.Game.Tests.Visual.Ranking
             public UnrankedSoloResultsScreen(ScoreInfo score)
                 : base(score, true)
             {
-                Score.BeatmapInfo.OnlineBeatmapID = 0;
+                Score.BeatmapInfo.OnlineID = 0;
                 Score.BeatmapInfo.Status = BeatmapSetOnlineStatus.Pending;
             }
 
diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs
index 03079fdc5f..1c5898d073 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs
@@ -867,7 +867,7 @@ namespace osu.Game.Tests.Visual.SongSelect
 
                 yield return new BeatmapInfo
                 {
-                    OnlineBeatmapID = id++ * 10,
+                    OnlineID = id++ * 10,
                     DifficultyName = version,
                     StarRating = diff,
                     Ruleset = new OsuRuleset().RulesetInfo,
@@ -900,7 +900,7 @@ namespace osu.Game.Tests.Visual.SongSelect
             {
                 toReturn.Beatmaps.Add(new BeatmapInfo
                 {
-                    OnlineBeatmapID = b * 10,
+                    OnlineID = b * 10,
                     Path = $"extra{b}.osu",
                     DifficultyName = $"Extra {b}",
                     Ruleset = rulesets.GetRuleset((b - 1) % 4),
diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
index 855a59b5f5..a8a7a5d350 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
@@ -388,7 +388,7 @@ namespace osu.Game.Tests.Visual.SongSelect
         {
             leaderboard.BeatmapInfo = new BeatmapInfo
             {
-                OnlineBeatmapID = 1113057,
+                OnlineID = 1113057,
                 Status = status,
             };
         }
diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapRecommendations.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapRecommendations.cs
index 57f2d436c5..cbb58a916f 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapRecommendations.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapRecommendations.cs
@@ -184,7 +184,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                 Metadata = metadata,
                 Beatmaps = difficultyRulesets.Select((ruleset, difficultyIndex) => new BeatmapInfo
                 {
-                    OnlineBeatmapID = importID * 1024 + difficultyIndex,
+                    OnlineID = importID * 1024 + difficultyIndex,
                     Metadata = metadata,
                     BaseDifficulty = new BeatmapDifficulty(),
                     Ruleset = ruleset,
@@ -205,8 +205,8 @@ namespace osu.Game.Tests.Visual.SongSelect
             AddUntilStep("wait for song select", () => Game.ScreenStack.CurrentScreen is Screens.Select.SongSelect);
             AddUntilStep("recommended beatmap displayed", () =>
             {
-                int? expectedID = getImport().Beatmaps[expectedDiff - 1].OnlineBeatmapID;
-                return Game.Beatmap.Value.BeatmapInfo.OnlineBeatmapID == expectedID;
+                int? expectedID = getImport().Beatmaps[expectedDiff - 1].OnlineID;
+                return Game.Beatmap.Value.BeatmapInfo.OnlineID == expectedID;
             });
         }
     }
diff --git a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
index a0d78fff58..b2fc34d675 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
@@ -507,13 +507,13 @@ namespace osu.Game.Tests.Visual.SongSelect
                     i.IsFiltered || i.Item.BeatmapInfo.Ruleset.ID == targetRuleset || i.Item.BeatmapInfo.Ruleset.ID == 0);
             });
 
-            AddUntilStep("carousel has correct", () => songSelect.Carousel.SelectedBeatmapInfo?.OnlineBeatmapID == target.OnlineBeatmapID);
-            AddUntilStep("game has correct", () => Beatmap.Value.BeatmapInfo.OnlineBeatmapID == target.OnlineBeatmapID);
+            AddUntilStep("carousel has correct", () => songSelect.Carousel.SelectedBeatmapInfo?.OnlineID == target.OnlineID);
+            AddUntilStep("game has correct", () => Beatmap.Value.BeatmapInfo.OnlineID == target.OnlineID);
 
             AddStep("reset filter text", () => songSelect.FilterControl.ChildrenOfType<SearchTextBox>().First().Text = string.Empty);
 
-            AddAssert("game still correct", () => Beatmap.Value?.BeatmapInfo.OnlineBeatmapID == target.OnlineBeatmapID);
-            AddAssert("carousel still correct", () => songSelect.Carousel.SelectedBeatmapInfo.OnlineBeatmapID == target.OnlineBeatmapID);
+            AddAssert("game still correct", () => Beatmap.Value?.BeatmapInfo.OnlineID == target.OnlineID);
+            AddAssert("carousel still correct", () => songSelect.Carousel.SelectedBeatmapInfo.OnlineID == target.OnlineID);
         }
 
         [Test]
@@ -544,8 +544,8 @@ namespace osu.Game.Tests.Visual.SongSelect
 
             AddUntilStep("has selection", () => songSelect.Carousel.SelectedBeatmapInfo != null);
 
-            AddUntilStep("carousel has correct", () => songSelect.Carousel.SelectedBeatmapInfo?.OnlineBeatmapID == target.OnlineBeatmapID);
-            AddUntilStep("game has correct", () => Beatmap.Value.BeatmapInfo.OnlineBeatmapID == target.OnlineBeatmapID);
+            AddUntilStep("carousel has correct", () => songSelect.Carousel.SelectedBeatmapInfo?.OnlineID == target.OnlineID);
+            AddUntilStep("game has correct", () => Beatmap.Value.BeatmapInfo.OnlineID == target.OnlineID);
 
             AddStep("set filter text", () => songSelect.FilterControl.ChildrenOfType<SearchTextBox>().First().Text = "nononoo");
 
@@ -918,7 +918,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                 beatmaps.Add(new BeatmapInfo
                 {
                     Ruleset = getRuleset(),
-                    OnlineBeatmapID = beatmapId,
+                    OnlineID = beatmapId,
                     DifficultyName = $"{beatmapId} (length {TimeSpan.FromMilliseconds(length):m\\:ss}, bpm {bpm:0.#})",
                     Length = length,
                     BPM = bpm,
diff --git a/osu.Game/Beatmaps/BeatmapDifficultyCache.cs b/osu.Game/Beatmaps/BeatmapDifficultyCache.cs
index 035f438b89..7231409dc5 100644
--- a/osu.Game/Beatmaps/BeatmapDifficultyCache.cs
+++ b/osu.Game/Beatmaps/BeatmapDifficultyCache.cs
@@ -290,7 +290,7 @@ namespace osu.Game.Beatmaps
             catch (BeatmapInvalidForRulesetException e)
             {
                 if (rulesetInfo.Equals(beatmapInfo.Ruleset))
-                    Logger.Error(e, $"Failed to convert {beatmapInfo.OnlineBeatmapID} to the beatmap's default ruleset ({beatmapInfo.Ruleset}).");
+                    Logger.Error(e, $"Failed to convert {beatmapInfo.OnlineID} to the beatmap's default ruleset ({beatmapInfo.Ruleset}).");
 
                 return new StarDifficulty();
             }
diff --git a/osu.Game/Beatmaps/BeatmapInfo.cs b/osu.Game/Beatmaps/BeatmapInfo.cs
index 5bbd48f26d..90c5b13bc4 100644
--- a/osu.Game/Beatmaps/BeatmapInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapInfo.cs
@@ -23,13 +23,14 @@ namespace osu.Game.Beatmaps
 
         public int BeatmapVersion;
 
-        private int? onlineBeatmapID;
+        private int? onlineID;
 
         [JsonProperty("id")]
-        public int? OnlineBeatmapID
+        [Column("OnlineBeatmapID")]
+        public int? OnlineID
         {
-            get => onlineBeatmapID;
-            set => onlineBeatmapID = value > 0 ? value : null;
+            get => onlineID;
+            set => onlineID = value > 0 ? value : null;
         }
 
         [JsonIgnore]
@@ -176,7 +177,7 @@ namespace osu.Game.Beatmaps
 
         #region Implementation of IHasOnlineID
 
-        public int OnlineID => OnlineBeatmapID ?? -1;
+        int IHasOnlineID<int>.OnlineID => onlineID ?? -1;
 
         #endregion
 
diff --git a/osu.Game/Beatmaps/BeatmapModelManager.cs b/osu.Game/Beatmaps/BeatmapModelManager.cs
index ff4305dc91..ac94163b4d 100644
--- a/osu.Game/Beatmaps/BeatmapModelManager.cs
+++ b/osu.Game/Beatmaps/BeatmapModelManager.cs
@@ -94,13 +94,13 @@ namespace osu.Game.Beatmaps
 
             validateOnlineIds(beatmapSet);
 
-            bool hadOnlineBeatmapIDs = beatmapSet.Beatmaps.Any(b => b.OnlineBeatmapID > 0);
+            bool hadOnlineIDs = beatmapSet.Beatmaps.Any(b => b.OnlineID > 0);
 
             if (OnlineLookupQueue != null)
                 await OnlineLookupQueue.UpdateAsync(beatmapSet, cancellationToken).ConfigureAwait(false);
 
             // ensure at least one beatmap was able to retrieve or keep an online ID, else drop the set ID.
-            if (hadOnlineBeatmapIDs && !beatmapSet.Beatmaps.Any(b => b.OnlineBeatmapID > 0))
+            if (hadOnlineIDs && !beatmapSet.Beatmaps.Any(b => b.OnlineID > 0))
             {
                 if (beatmapSet.OnlineBeatmapSetID != null)
                 {
@@ -127,7 +127,7 @@ namespace osu.Game.Beatmaps
                     // in order to avoid a unique key constraint, immediately remove the online ID from the previous set.
                     existingSetWithSameOnlineID.OnlineBeatmapSetID = null;
                     foreach (var b in existingSetWithSameOnlineID.Beatmaps)
-                        b.OnlineBeatmapID = null;
+                        b.OnlineID = null;
 
                     LogForModel(beatmapSet, $"Found existing beatmap set with same OnlineBeatmapSetID ({beatmapSet.OnlineBeatmapSetID}). It has been deleted.");
                 }
@@ -136,7 +136,7 @@ namespace osu.Game.Beatmaps
 
         private void validateOnlineIds(BeatmapSetInfo beatmapSet)
         {
-            var beatmapIds = beatmapSet.Beatmaps.Where(b => b.OnlineBeatmapID.HasValue).Select(b => b.OnlineBeatmapID).ToList();
+            var beatmapIds = beatmapSet.Beatmaps.Where(b => b.OnlineID.HasValue).Select(b => b.OnlineID).ToList();
 
             // ensure all IDs are unique
             if (beatmapIds.GroupBy(b => b).Any(g => g.Count() > 1))
@@ -147,7 +147,7 @@ namespace osu.Game.Beatmaps
             }
 
             // find any existing beatmaps in the database that have matching online ids
-            var existingBeatmaps = QueryBeatmaps(b => beatmapIds.Contains(b.OnlineBeatmapID)).ToList();
+            var existingBeatmaps = QueryBeatmaps(b => beatmapIds.Contains(b.OnlineID)).ToList();
 
             if (existingBeatmaps.Count > 0)
             {
@@ -162,7 +162,7 @@ namespace osu.Game.Beatmaps
                 }
             }
 
-            void resetIds() => beatmapSet.Beatmaps.ForEach(b => b.OnlineBeatmapID = null);
+            void resetIds() => beatmapSet.Beatmaps.ForEach(b => b.OnlineID = null);
         }
 
         /// <summary>
@@ -242,7 +242,7 @@ namespace osu.Game.Beatmaps
             if (!base.CanSkipImport(existing, import))
                 return false;
 
-            return existing.Beatmaps.Any(b => b.OnlineBeatmapID != null);
+            return existing.Beatmaps.Any(b => b.OnlineID != null);
         }
 
         protected override bool CanReuseExisting(BeatmapSetInfo existing, BeatmapSetInfo import)
@@ -250,8 +250,8 @@ namespace osu.Game.Beatmaps
             if (!base.CanReuseExisting(existing, import))
                 return false;
 
-            var existingIds = existing.Beatmaps.Select(b => b.OnlineBeatmapID).OrderBy(i => i);
-            var importIds = import.Beatmaps.Select(b => b.OnlineBeatmapID).OrderBy(i => i);
+            var existingIds = existing.Beatmaps.Select(b => b.OnlineID).OrderBy(i => i);
+            var importIds = import.Beatmaps.Select(b => b.OnlineID).OrderBy(i => i);
 
             // force re-import if we are not in a sane state.
             return existing.OnlineBeatmapSetID == import.OnlineBeatmapSetID && existingIds.SequenceEqual(importIds);
diff --git a/osu.Game/Beatmaps/BeatmapOnlineLookupQueue.cs b/osu.Game/Beatmaps/BeatmapOnlineLookupQueue.cs
index b05ad9a1dd..69b03683dd 100644
--- a/osu.Game/Beatmaps/BeatmapOnlineLookupQueue.cs
+++ b/osu.Game/Beatmaps/BeatmapOnlineLookupQueue.cs
@@ -85,7 +85,7 @@ namespace osu.Game.Beatmaps
                     beatmapInfo.Status = res.Status;
                     beatmapInfo.BeatmapSet.Status = res.BeatmapSet?.Status ?? BeatmapSetOnlineStatus.None;
                     beatmapInfo.BeatmapSet.OnlineBeatmapSetID = res.OnlineBeatmapSetID;
-                    beatmapInfo.OnlineBeatmapID = res.OnlineID;
+                    beatmapInfo.OnlineID = res.OnlineID;
 
                     if (beatmapInfo.Metadata != null)
                         beatmapInfo.Metadata.AuthorID = res.AuthorID;
@@ -103,7 +103,7 @@ namespace osu.Game.Beatmaps
 
             void fail(Exception e)
             {
-                beatmapInfo.OnlineBeatmapID = null;
+                beatmapInfo.OnlineID = null;
                 logForModel(set, $"Online retrieval failed for {beatmapInfo} ({e.Message})");
             }
         }
@@ -161,7 +161,7 @@ namespace osu.Game.Beatmaps
 
             if (string.IsNullOrEmpty(beatmapInfo.MD5Hash)
                 && string.IsNullOrEmpty(beatmapInfo.Path)
-                && beatmapInfo.OnlineBeatmapID == null)
+                && beatmapInfo.OnlineID == null)
                 return false;
 
             try
@@ -172,10 +172,10 @@ namespace osu.Game.Beatmaps
 
                     using (var cmd = db.CreateCommand())
                     {
-                        cmd.CommandText = "SELECT beatmapset_id, beatmap_id, approved, user_id FROM osu_beatmaps WHERE checksum = @MD5Hash OR beatmap_id = @OnlineBeatmapID OR filename = @Path";
+                        cmd.CommandText = "SELECT beatmapset_id, beatmap_id, approved, user_id FROM osu_beatmaps WHERE checksum = @MD5Hash OR beatmap_id = @OnlineID OR filename = @Path";
 
                         cmd.Parameters.Add(new SqliteParameter("@MD5Hash", beatmapInfo.MD5Hash));
-                        cmd.Parameters.Add(new SqliteParameter("@OnlineBeatmapID", beatmapInfo.OnlineBeatmapID ?? (object)DBNull.Value));
+                        cmd.Parameters.Add(new SqliteParameter("@OnlineID", beatmapInfo.OnlineID ?? (object)DBNull.Value));
                         cmd.Parameters.Add(new SqliteParameter("@Path", beatmapInfo.Path));
 
                         using (var reader = cmd.ExecuteReader())
@@ -187,7 +187,7 @@ namespace osu.Game.Beatmaps
                                 beatmapInfo.Status = status;
                                 beatmapInfo.BeatmapSet.Status = status;
                                 beatmapInfo.BeatmapSet.OnlineBeatmapSetID = reader.GetInt32(0);
-                                beatmapInfo.OnlineBeatmapID = reader.GetInt32(1);
+                                beatmapInfo.OnlineID = reader.GetInt32(1);
 
                                 if (beatmapInfo.Metadata != null)
                                     beatmapInfo.Metadata.AuthorID = reader.GetInt32(3);
diff --git a/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs b/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
index f0c19f80f3..7a92d03e42 100644
--- a/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
+++ b/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
@@ -263,7 +263,7 @@ namespace osu.Game.Beatmaps.Formats
                     break;
 
                 case @"BeatmapID":
-                    beatmap.BeatmapInfo.OnlineBeatmapID = Parsing.ParseInt(pair.Value);
+                    beatmap.BeatmapInfo.OnlineID = Parsing.ParseInt(pair.Value);
                     break;
 
                 case @"BeatmapSetID":
diff --git a/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs b/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs
index bcb14526c7..e26b96254f 100644
--- a/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs
+++ b/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs
@@ -133,7 +133,7 @@ namespace osu.Game.Beatmaps.Formats
             writer.WriteLine(FormattableString.Invariant($"Version: {beatmap.BeatmapInfo.DifficultyName}"));
             if (!string.IsNullOrEmpty(beatmap.Metadata.Source)) writer.WriteLine(FormattableString.Invariant($"Source: {beatmap.Metadata.Source}"));
             if (!string.IsNullOrEmpty(beatmap.Metadata.Tags)) writer.WriteLine(FormattableString.Invariant($"Tags: {beatmap.Metadata.Tags}"));
-            if (beatmap.BeatmapInfo.OnlineBeatmapID != null) writer.WriteLine(FormattableString.Invariant($"BeatmapID: {beatmap.BeatmapInfo.OnlineBeatmapID}"));
+            if (beatmap.BeatmapInfo.OnlineID != null) writer.WriteLine(FormattableString.Invariant($"BeatmapID: {beatmap.BeatmapInfo.OnlineID}"));
             if (beatmap.BeatmapInfo.BeatmapSet?.OnlineBeatmapSetID != null) writer.WriteLine(FormattableString.Invariant($"BeatmapSetID: {beatmap.BeatmapInfo.BeatmapSet.OnlineBeatmapSetID}"));
         }
 
diff --git a/osu.Game/Database/OsuDbContext.cs b/osu.Game/Database/OsuDbContext.cs
index 1d8322aadd..91654e2827 100644
--- a/osu.Game/Database/OsuDbContext.cs
+++ b/osu.Game/Database/OsuDbContext.cs
@@ -125,7 +125,7 @@ namespace osu.Game.Database
         {
             base.OnModelCreating(modelBuilder);
 
-            modelBuilder.Entity<BeatmapInfo>().HasIndex(b => b.OnlineBeatmapID).IsUnique();
+            modelBuilder.Entity<BeatmapInfo>().HasIndex(b => b.OnlineID).IsUnique();
             modelBuilder.Entity<BeatmapInfo>().HasIndex(b => b.MD5Hash);
             modelBuilder.Entity<BeatmapInfo>().HasIndex(b => b.Hash);
 
diff --git a/osu.Game/Online/Chat/NowPlayingCommand.cs b/osu.Game/Online/Chat/NowPlayingCommand.cs
index adb3d88df6..34b12c23e6 100644
--- a/osu.Game/Online/Chat/NowPlayingCommand.cs
+++ b/osu.Game/Online/Chat/NowPlayingCommand.cs
@@ -57,7 +57,7 @@ namespace osu.Game.Online.Chat
                     break;
             }
 
-            string beatmapString = beatmapInfo.OnlineBeatmapID.HasValue ? $"[{api.WebsiteRootUrl}/b/{beatmapInfo.OnlineBeatmapID} {beatmapInfo}]" : beatmapInfo.ToString();
+            string beatmapString = beatmapInfo.OnlineID.HasValue ? $"[{api.WebsiteRootUrl}/b/{beatmapInfo.OnlineID} {beatmapInfo}]" : beatmapInfo.ToString();
 
             channelManager.PostMessage($"is {verb} {beatmapString}", true, target);
             Expire();
diff --git a/osu.Game/Online/Multiplayer/MultiplayerClient.cs b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
index 567e59e8a0..68f5dfce6a 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
@@ -229,7 +229,7 @@ namespace osu.Game.Online.Multiplayer
                 {
                     Value = new BeatmapInfo
                     {
-                        OnlineBeatmapID = Room.Settings.BeatmapID,
+                        OnlineID = Room.Settings.BeatmapID,
                         MD5Hash = Room.Settings.BeatmapChecksum
                     }
                 },
diff --git a/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs b/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs
index eb9ea608f7..aa0e37363b 100644
--- a/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs
+++ b/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs
@@ -113,7 +113,7 @@ namespace osu.Game.Online.Rooms
             int onlineId = SelectedItem.Value.Beatmap.Value.OnlineID;
             string checksum = SelectedItem.Value.Beatmap.Value.MD5Hash;
 
-            return beatmapManager.QueryBeatmap(b => b.OnlineBeatmapID == onlineId && b.MD5Hash == checksum && !b.BeatmapSet.DeletePending) != null;
+            return beatmapManager.QueryBeatmap(b => b.OnlineID == onlineId && b.MD5Hash == checksum && !b.BeatmapSet.DeletePending) != null;
         }
     }
 }
diff --git a/osu.Game/Online/Spectator/SpectatorClient.cs b/osu.Game/Online/Spectator/SpectatorClient.cs
index f9366674d8..6b95d288c5 100644
--- a/osu.Game/Online/Spectator/SpectatorClient.cs
+++ b/osu.Game/Online/Spectator/SpectatorClient.cs
@@ -144,7 +144,7 @@ namespace osu.Game.Online.Spectator
             IsPlaying = true;
 
             // transfer state at point of beginning play
-            currentState.BeatmapID = score.ScoreInfo.BeatmapInfo.OnlineBeatmapID;
+            currentState.BeatmapID = score.ScoreInfo.BeatmapInfo.OnlineID;
             currentState.RulesetID = score.ScoreInfo.RulesetID;
             currentState.Mods = score.ScoreInfo.Mods.Select(m => new APIMod(m)).ToArray();
 
diff --git a/osu.Game/Overlays/BeatmapListing/Panels/BeatmapPanelDownloadButton.cs b/osu.Game/Overlays/BeatmapListing/Panels/BeatmapPanelDownloadButton.cs
index 5ed49cf384..8c7846783d 100644
--- a/osu.Game/Overlays/BeatmapListing/Panels/BeatmapPanelDownloadButton.cs
+++ b/osu.Game/Overlays/BeatmapListing/Panels/BeatmapPanelDownloadButton.cs
@@ -80,7 +80,7 @@ namespace osu.Game.Overlays.BeatmapListing.Panels
                     case DownloadState.LocallyAvailable:
                         Predicate<BeatmapInfo> findPredicate = null;
                         if (SelectedBeatmap.Value != null)
-                            findPredicate = b => b.OnlineBeatmapID == SelectedBeatmap.Value.OnlineID;
+                            findPredicate = b => b.OnlineID == SelectedBeatmap.Value.OnlineID;
 
                         game?.PresentBeatmap(beatmapSet, findPredicate);
                         break;
diff --git a/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs b/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
index d6016ec4b9..dc928d90e9 100644
--- a/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
@@ -366,7 +366,7 @@ namespace osu.Game.Screens.OnlinePlay.Match
             var beatmap = SelectedItem.Value?.Beatmap.Value;
 
             // Retrieve the corresponding local beatmap, since we can't directly use the playlist's beatmap info
-            var localBeatmap = beatmap == null ? null : beatmapManager.QueryBeatmap(b => b.OnlineBeatmapID == beatmap.OnlineID);
+            var localBeatmap = beatmap == null ? null : beatmapManager.QueryBeatmap(b => b.OnlineID == beatmap.OnlineID);
 
             Beatmap.Value = beatmapManager.GetWorkingBeatmap(localBeatmap);
         }
diff --git a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsPlayer.cs b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsPlayer.cs
index bdb5ff9bb2..22537c3ce0 100644
--- a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsPlayer.cs
+++ b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsPlayer.cs
@@ -32,7 +32,7 @@ namespace osu.Game.Screens.OnlinePlay.Playlists
         private void load(IBindable<RulesetInfo> ruleset)
         {
             // Sanity checks to ensure that PlaylistsPlayer matches the settings for the current PlaylistItem
-            if (Beatmap.Value.BeatmapInfo.OnlineBeatmapID != PlaylistItem.Beatmap.Value.OnlineID)
+            if (Beatmap.Value.BeatmapInfo.OnlineID != PlaylistItem.Beatmap.Value.OnlineID)
                 throw new InvalidOperationException("Current Beatmap does not match PlaylistItem's Beatmap");
 
             if (ruleset.Value.ID != PlaylistItem.Ruleset.Value.ID)
diff --git a/osu.Game/Screens/Play/SoloPlayer.cs b/osu.Game/Screens/Play/SoloPlayer.cs
index 675cb71311..6cea75af0a 100644
--- a/osu.Game/Screens/Play/SoloPlayer.cs
+++ b/osu.Game/Screens/Play/SoloPlayer.cs
@@ -25,7 +25,7 @@ namespace osu.Game.Screens.Play
 
         protected override APIRequest<APIScoreToken> CreateTokenRequest()
         {
-            if (!(Beatmap.Value.BeatmapInfo.OnlineBeatmapID is int beatmapId))
+            if (!(Beatmap.Value.BeatmapInfo.OnlineID is int beatmapId))
                 return null;
 
             if (!(Ruleset.Value.ID is int rulesetId) || Ruleset.Value.ID > ILegacyRuleset.MAX_LEGACY_RULESET_ID)
@@ -40,9 +40,9 @@ namespace osu.Game.Screens.Play
         {
             var beatmap = score.ScoreInfo.BeatmapInfo;
 
-            Debug.Assert(beatmap.OnlineBeatmapID != null);
+            Debug.Assert(beatmap.OnlineID != null);
 
-            int beatmapId = beatmap.OnlineBeatmapID.Value;
+            int beatmapId = beatmap.OnlineID.Value;
 
             return new SubmitSoloScoreRequest(beatmapId, token, score.ScoreInfo);
         }
diff --git a/osu.Game/Screens/Ranking/SoloResultsScreen.cs b/osu.Game/Screens/Ranking/SoloResultsScreen.cs
index 4f4dfa4909..425e6f983b 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)
         {
-            if (Score.BeatmapInfo.OnlineBeatmapID == null || Score.BeatmapInfo.Status <= BeatmapSetOnlineStatus.Pending)
+            if (Score.BeatmapInfo.OnlineID == null || Score.BeatmapInfo.Status <= BeatmapSetOnlineStatus.Pending)
                 return null;
 
             getScoreRequest = new GetScoresRequest(Score.BeatmapInfo, Score.Ruleset);
diff --git a/osu.Game/Screens/Select/BeatmapDetails.cs b/osu.Game/Screens/Select/BeatmapDetails.cs
index 6f215b9287..7543c89f17 100644
--- a/osu.Game/Screens/Select/BeatmapDetails.cs
+++ b/osu.Game/Screens/Select/BeatmapDetails.cs
@@ -192,7 +192,7 @@ namespace osu.Game.Screens.Select
                 return;
             }
 
-            // for now, let's early abort if an OnlineBeatmapID is not present (should have been populated at import time).
+            // for now, let's early abort if an OnlineID is not present (should have been populated at import time).
             if (BeatmapInfo == null || BeatmapInfo.OnlineID <= 0 || api.State.Value == APIState.Offline)
             {
                 updateMetrics();
diff --git a/osu.Game/Screens/Select/Carousel/CarouselBeatmap.cs b/osu.Game/Screens/Select/Carousel/CarouselBeatmap.cs
index 1334784613..df51287d4a 100644
--- a/osu.Game/Screens/Select/Carousel/CarouselBeatmap.cs
+++ b/osu.Game/Screens/Select/Carousel/CarouselBeatmap.cs
@@ -66,7 +66,7 @@ namespace osu.Game.Screens.Select.Carousel
                 // this should be done after text matching so we can prioritise matching numbers in metadata.
                 if (!match && criteria.SearchNumber.HasValue)
                 {
-                    match = (BeatmapInfo.OnlineBeatmapID == criteria.SearchNumber.Value) ||
+                    match = (BeatmapInfo.OnlineID == criteria.SearchNumber.Value) ||
                             (BeatmapInfo.BeatmapSet?.OnlineBeatmapSetID == criteria.SearchNumber.Value);
                 }
             }
diff --git a/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmap.cs b/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmap.cs
index f30bec5d2b..d0f9d835fd 100644
--- a/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmap.cs
+++ b/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmap.cs
@@ -238,8 +238,8 @@ namespace osu.Game.Screens.Select.Carousel
                 if (editRequested != null)
                     items.Add(new OsuMenuItem("Edit", MenuItemType.Standard, () => editRequested(beatmapInfo)));
 
-                if (beatmapInfo.OnlineBeatmapID.HasValue && beatmapOverlay != null)
-                    items.Add(new OsuMenuItem("Details...", MenuItemType.Standard, () => beatmapOverlay.FetchAndShowBeatmap(beatmapInfo.OnlineBeatmapID.Value)));
+                if (beatmapInfo.OnlineID.HasValue && beatmapOverlay != null)
+                    items.Add(new OsuMenuItem("Details...", MenuItemType.Standard, () => beatmapOverlay.FetchAndShowBeatmap(beatmapInfo.OnlineID.Value)));
 
                 if (collectionManager != null)
                 {
diff --git a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
index 9205c6c0d2..9c8ccee99b 100644
--- a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
+++ b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
@@ -152,7 +152,7 @@ namespace osu.Game.Screens.Select.Leaderboards
                 return null;
             }
 
-            if (BeatmapInfo.OnlineBeatmapID == null || BeatmapInfo?.Status <= BeatmapSetOnlineStatus.Pending)
+            if (BeatmapInfo.OnlineID == null || BeatmapInfo?.Status <= BeatmapSetOnlineStatus.Pending)
             {
                 PlaceholderState = PlaceholderState.Unavailable;
                 return null;
diff --git a/osu.Game/Screens/Spectate/SpectatorScreen.cs b/osu.Game/Screens/Spectate/SpectatorScreen.cs
index 3bcfcb2a0b..1f07042ede 100644
--- a/osu.Game/Screens/Spectate/SpectatorScreen.cs
+++ b/osu.Game/Screens/Spectate/SpectatorScreen.cs
@@ -84,7 +84,7 @@ namespace osu.Game.Screens.Spectate
                 if (!playingUserStates.TryGetValue(userId, out var userState))
                     continue;
 
-                if (beatmapSet.Beatmaps.Any(b => b.OnlineBeatmapID == userState.BeatmapID))
+                if (beatmapSet.Beatmaps.Any(b => b.OnlineID == userState.BeatmapID))
                     updateGameplayState(userId);
             }
         }
@@ -150,7 +150,7 @@ namespace osu.Game.Screens.Spectate
             if (resolvedRuleset == null)
                 return;
 
-            var resolvedBeatmap = beatmaps.QueryBeatmap(b => b.OnlineBeatmapID == spectatorState.BeatmapID);
+            var resolvedBeatmap = beatmaps.QueryBeatmap(b => b.OnlineID == spectatorState.BeatmapID);
             if (resolvedBeatmap == null)
                 return;
 
diff --git a/osu.Game/Stores/BeatmapImporter.cs b/osu.Game/Stores/BeatmapImporter.cs
index 01bf925547..f203e55c27 100644
--- a/osu.Game/Stores/BeatmapImporter.cs
+++ b/osu.Game/Stores/BeatmapImporter.cs
@@ -63,7 +63,7 @@ namespace osu.Game.Stores
 
             validateOnlineIds(beatmapSet, realm);
 
-            bool hadOnlineBeatmapIDs = beatmapSet.Beatmaps.Any(b => b.OnlineID > 0);
+            bool hadOnlineIDs = beatmapSet.Beatmaps.Any(b => b.OnlineID > 0);
 
             if (onlineLookupQueue != null)
             {
@@ -72,7 +72,7 @@ namespace osu.Game.Stores
             }
 
             // ensure at least one beatmap was able to retrieve or keep an online ID, else drop the set ID.
-            if (hadOnlineBeatmapIDs && !beatmapSet.Beatmaps.Any(b => b.OnlineID > 0))
+            if (hadOnlineIDs && !beatmapSet.Beatmaps.Any(b => b.OnlineID > 0))
             {
                 if (beatmapSet.OnlineID > 0)
                 {
@@ -254,7 +254,7 @@ namespace osu.Game.Stores
                     {
                         Hash = hash,
                         DifficultyName = decodedInfo.DifficultyName,
-                        OnlineID = decodedInfo.OnlineBeatmapID ?? -1,
+                        OnlineID = decodedInfo.OnlineID ?? -1,
                         AudioLeadIn = decodedInfo.AudioLeadIn,
                         StackLeniency = decodedInfo.StackLeniency,
                         SpecialStyle = decodedInfo.SpecialStyle,
diff --git a/osu.Game/Tests/Beatmaps/TestBeatmap.cs b/osu.Game/Tests/Beatmaps/TestBeatmap.cs
index b9eda5c06e..38c8219813 100644
--- a/osu.Game/Tests/Beatmaps/TestBeatmap.cs
+++ b/osu.Game/Tests/Beatmaps/TestBeatmap.cs
@@ -38,7 +38,7 @@ namespace osu.Game.Tests.Beatmaps
             BeatmapInfo.BeatmapSet.OnlineBeatmapSetID = Interlocked.Increment(ref onlineSetID);
             BeatmapInfo.Length = 75000;
             BeatmapInfo.OnlineInfo = new APIBeatmap();
-            BeatmapInfo.OnlineBeatmapID = Interlocked.Increment(ref onlineBeatmapID);
+            BeatmapInfo.OnlineID = Interlocked.Increment(ref onlineBeatmapID);
         }
 
         protected virtual Beatmap CreateBeatmap() => createTestBeatmap();
diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
index f81ca70631..ac9be03cc1 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
@@ -287,7 +287,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             var apiRoom = roomManager.ServerSideRooms.Single(r => r.RoomID.Value == Room.RoomID);
             IBeatmapSetInfo? set = apiRoom.Playlist.FirstOrDefault(p => p.BeatmapID == beatmapId)?.Beatmap.Value.BeatmapSet
-                                   ?? beatmaps.QueryBeatmap(b => b.OnlineBeatmapID == beatmapId)?.BeatmapSet;
+                                   ?? beatmaps.QueryBeatmap(b => b.OnlineID == beatmapId)?.BeatmapSet;
 
             if (set == null)
                 throw new InvalidOperationException("Beatmap not found.");
diff --git a/osu.Game/Tests/Visual/OsuTestScene.cs b/osu.Game/Tests/Visual/OsuTestScene.cs
index a4cef02395..83bf130f26 100644
--- a/osu.Game/Tests/Visual/OsuTestScene.cs
+++ b/osu.Game/Tests/Visual/OsuTestScene.cs
@@ -222,7 +222,7 @@ namespace osu.Game.Tests.Visual
                 {
                     new APIBeatmap
                     {
-                        OnlineID = beatmap.OnlineID,
+                        OnlineID = ((IBeatmapInfo)beatmap).OnlineID,
                         OnlineBeatmapSetID = beatmap.BeatmapSet.OnlineID,
                         Status = beatmap.Status,
                         Checksum = beatmap.MD5Hash,

From 692e846acdbb188666e3a0cb2891337f0164a396 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 12 Nov 2021 17:50:31 +0900
Subject: [PATCH 0958/5547] Rename `BeatmapSetInfo.OnlineBeatmapSetID` to
 `OnlineID` to match interface

---
 .../Formats/LegacyBeatmapDecoderTest.cs        |  2 +-
 .../Beatmaps/Formats/OsuJsonDecoderTest.cs     |  2 +-
 .../Beatmaps/IO/ImportBeatmapTest.cs           |  8 ++++----
 .../Beatmaps/IO/OszArchiveReaderTest.cs        |  2 +-
 .../NonVisual/BeatmapSetInfoEqualityTest.cs    |  8 ++++----
 .../NonVisual/Filtering/FilterMatchingTest.cs  |  2 +-
 .../Online/TestSceneBeatmapManager.cs          |  2 +-
 ...ceneOnlinePlayBeatmapAvailabilityTracker.cs |  6 +++---
 .../TestSceneMultiplayerMatchSongSelect.cs     |  2 +-
 .../TestScenePlaylistsSongSelect.cs            |  2 +-
 .../Navigation/TestScenePerformFromScreen.cs   |  2 +-
 .../Navigation/TestScenePresentBeatmap.cs      |  2 +-
 .../Visual/Navigation/TestScenePresentScore.cs |  2 +-
 .../Online/TestSceneDirectDownloadButton.cs    |  4 ++--
 .../TestScenePlaylistsRoomCreation.cs          |  2 +-
 .../SongSelect/TestSceneBeatmapCarousel.cs     |  4 ++--
 .../TestSceneBeatmapRecommendations.cs         |  2 +-
 .../SongSelect/TestScenePlaySongSelect.cs      |  2 +-
 osu.Game/Beatmaps/BeatmapModelManager.cs       | 18 +++++++++---------
 osu.Game/Beatmaps/BeatmapOnlineLookupQueue.cs  |  4 ++--
 osu.Game/Beatmaps/BeatmapSetInfo.cs            | 15 ++++++++-------
 .../Beatmaps/Formats/LegacyBeatmapDecoder.cs   |  2 +-
 .../Beatmaps/Formats/LegacyBeatmapEncoder.cs   |  2 +-
 osu.Game/Database/OsuDbContext.cs              |  2 +-
 osu.Game/Online/BeatmapDownloadTracker.cs      |  2 +-
 osu.Game/OsuGame.cs                            |  2 +-
 osu.Game/Screens/Play/SoloSpectator.cs         |  2 +-
 .../Screens/Select/Carousel/CarouselBeatmap.cs |  2 +-
 .../Carousel/DrawableCarouselBeatmapSet.cs     |  4 ++--
 osu.Game/Stores/BeatmapImporter.cs             |  2 +-
 osu.Game/Tests/Beatmaps/TestBeatmap.cs         |  2 +-
 osu.Game/Tests/Visual/OsuTestScene.cs          |  4 ++--
 32 files changed, 60 insertions(+), 59 deletions(-)

diff --git a/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs b/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs
index 9dc144927b..677aaf6f78 100644
--- a/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs
+++ b/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs
@@ -117,7 +117,7 @@ namespace osu.Game.Tests.Beatmaps.Formats
                 Assert.AreEqual(string.Empty, metadata.Source);
                 Assert.AreEqual("MBC7 Unisphere 地球ヤバイEP Chikyu Yabai", metadata.Tags);
                 Assert.AreEqual(557821, beatmapInfo.OnlineID);
-                Assert.AreEqual(241526, beatmapInfo.BeatmapSet.OnlineBeatmapSetID);
+                Assert.AreEqual(241526, beatmapInfo.BeatmapSet.OnlineID);
             }
         }
 
diff --git a/osu.Game.Tests/Beatmaps/Formats/OsuJsonDecoderTest.cs b/osu.Game.Tests/Beatmaps/Formats/OsuJsonDecoderTest.cs
index 37c1dfc657..bfd6ff0314 100644
--- a/osu.Game.Tests/Beatmaps/Formats/OsuJsonDecoderTest.cs
+++ b/osu.Game.Tests/Beatmaps/Formats/OsuJsonDecoderTest.cs
@@ -31,7 +31,7 @@ namespace osu.Game.Tests.Beatmaps.Formats
         {
             var beatmap = decodeAsJson(normal);
             var meta = beatmap.BeatmapInfo.Metadata;
-            Assert.AreEqual(241526, beatmap.BeatmapInfo.BeatmapSet.OnlineBeatmapSetID);
+            Assert.AreEqual(241526, beatmap.BeatmapInfo.BeatmapSet.OnlineID);
             Assert.AreEqual("Soleily", meta.Artist);
             Assert.AreEqual("Soleily", meta.ArtistUnicode);
             Assert.AreEqual("03. Renatus - Soleily 192kbps.mp3", meta.AudioFile);
diff --git a/osu.Game.Tests/Beatmaps/IO/ImportBeatmapTest.cs b/osu.Game.Tests/Beatmaps/IO/ImportBeatmapTest.cs
index 10b9f5e0e2..e00d7a1115 100644
--- a/osu.Game.Tests/Beatmaps/IO/ImportBeatmapTest.cs
+++ b/osu.Game.Tests/Beatmaps/IO/ImportBeatmapTest.cs
@@ -581,7 +581,7 @@ namespace osu.Game.Tests.Beatmaps.IO
 
                     var toImport = new BeatmapSetInfo
                     {
-                        OnlineBeatmapSetID = 1,
+                        OnlineID = 1,
                         Metadata = metadata,
                         Beatmaps = new List<BeatmapInfo>
                         {
@@ -1056,13 +1056,13 @@ namespace osu.Game.Tests.Beatmaps.IO
         {
             IEnumerable<BeatmapSetInfo> resultSets = null;
             var store = osu.Dependencies.Get<BeatmapManager>();
-            waitForOrAssert(() => (resultSets = store.QueryBeatmapSets(s => s.OnlineBeatmapSetID == 241526)).Any(),
+            waitForOrAssert(() => (resultSets = store.QueryBeatmapSets(s => s.OnlineID == 241526)).Any(),
                 @"BeatmapSet did not import to the database in allocated time.", timeout);
 
             // ensure we were stored to beatmap database backing...
             Assert.IsTrue(resultSets.Count() == 1, $@"Incorrect result count found ({resultSets.Count()} but should be 1).");
-            IEnumerable<BeatmapInfo> queryBeatmaps() => store.QueryBeatmaps(s => s.BeatmapSet.OnlineBeatmapSetID == 241526 && s.BaseDifficultyID > 0);
-            IEnumerable<BeatmapSetInfo> queryBeatmapSets() => store.QueryBeatmapSets(s => s.OnlineBeatmapSetID == 241526);
+            IEnumerable<BeatmapInfo> queryBeatmaps() => store.QueryBeatmaps(s => s.BeatmapSet.OnlineID == 241526 && s.BaseDifficultyID > 0);
+            IEnumerable<BeatmapSetInfo> queryBeatmapSets() => store.QueryBeatmapSets(s => s.OnlineID == 241526);
 
             // if we don't re-check here, the set will be inserted but the beatmaps won't be present yet.
             waitForOrAssert(() => queryBeatmaps().Count() == 12,
diff --git a/osu.Game.Tests/Beatmaps/IO/OszArchiveReaderTest.cs b/osu.Game.Tests/Beatmaps/IO/OszArchiveReaderTest.cs
index eaf5d107ca..b2ab1eeaa6 100644
--- a/osu.Game.Tests/Beatmaps/IO/OszArchiveReaderTest.cs
+++ b/osu.Game.Tests/Beatmaps/IO/OszArchiveReaderTest.cs
@@ -56,7 +56,7 @@ namespace osu.Game.Tests.Beatmaps.IO
 
                 var meta = beatmap.Metadata;
 
-                Assert.AreEqual(241526, beatmap.BeatmapInfo.BeatmapSet.OnlineBeatmapSetID);
+                Assert.AreEqual(241526, beatmap.BeatmapInfo.BeatmapSet.OnlineID);
                 Assert.AreEqual("Soleily", meta.Artist);
                 Assert.AreEqual("Soleily", meta.ArtistUnicode);
                 Assert.AreEqual("03. Renatus - Soleily 192kbps.mp3", meta.AudioFile);
diff --git a/osu.Game.Tests/NonVisual/BeatmapSetInfoEqualityTest.cs b/osu.Game.Tests/NonVisual/BeatmapSetInfoEqualityTest.cs
index 9ce7e0a0e0..938edf07c6 100644
--- a/osu.Game.Tests/NonVisual/BeatmapSetInfoEqualityTest.cs
+++ b/osu.Game.Tests/NonVisual/BeatmapSetInfoEqualityTest.cs
@@ -12,8 +12,8 @@ namespace osu.Game.Tests.NonVisual
         [Test]
         public void TestOnlineWithOnline()
         {
-            var ourInfo = new BeatmapSetInfo { OnlineBeatmapSetID = 123 };
-            var otherInfo = new BeatmapSetInfo { OnlineBeatmapSetID = 123 };
+            var ourInfo = new BeatmapSetInfo { OnlineID = 123 };
+            var otherInfo = new BeatmapSetInfo { OnlineID = 123 };
 
             Assert.AreEqual(ourInfo, otherInfo);
         }
@@ -30,8 +30,8 @@ namespace osu.Game.Tests.NonVisual
         [Test]
         public void TestDatabasedWithOnline()
         {
-            var ourInfo = new BeatmapSetInfo { ID = 123, OnlineBeatmapSetID = 12 };
-            var otherInfo = new BeatmapSetInfo { OnlineBeatmapSetID = 12 };
+            var ourInfo = new BeatmapSetInfo { ID = 123, OnlineID = 12 };
+            var otherInfo = new BeatmapSetInfo { OnlineID = 12 };
 
             Assert.AreEqual(ourInfo, otherInfo);
         }
diff --git a/osu.Game.Tests/NonVisual/Filtering/FilterMatchingTest.cs b/osu.Game.Tests/NonVisual/Filtering/FilterMatchingTest.cs
index 1bc663a1f9..ee1feeca8d 100644
--- a/osu.Game.Tests/NonVisual/Filtering/FilterMatchingTest.cs
+++ b/osu.Game.Tests/NonVisual/Filtering/FilterMatchingTest.cs
@@ -208,7 +208,7 @@ namespace osu.Game.Tests.NonVisual.Filtering
         {
             var beatmap = getExampleBeatmap();
             beatmap.OnlineID = 20201010;
-            beatmap.BeatmapSet = new BeatmapSetInfo { OnlineBeatmapSetID = 1535 };
+            beatmap.BeatmapSet = new BeatmapSetInfo { OnlineID = 1535 };
 
             var criteria = new FilterCriteria { SearchText = query };
             var carouselItem = new CarouselBeatmap(beatmap);
diff --git a/osu.Game.Tests/Online/TestSceneBeatmapManager.cs b/osu.Game.Tests/Online/TestSceneBeatmapManager.cs
index 4d5bee13f2..fc1b4f224d 100644
--- a/osu.Game.Tests/Online/TestSceneBeatmapManager.cs
+++ b/osu.Game.Tests/Online/TestSceneBeatmapManager.cs
@@ -19,7 +19,7 @@ namespace osu.Game.Tests.Online
 
         private static readonly BeatmapSetInfo test_db_model = new BeatmapSetInfo
         {
-            OnlineBeatmapSetID = 1,
+            OnlineID = 1,
             Metadata = new BeatmapMetadata
             {
                 Artist = "test author",
diff --git a/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs b/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
index e3e2304990..b66da028f1 100644
--- a/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
+++ b/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
@@ -58,7 +58,7 @@ namespace osu.Game.Tests.Online
             testBeatmapInfo = getTestBeatmapInfo(testBeatmapFile);
             testBeatmapSet = testBeatmapInfo.BeatmapSet;
 
-            var existing = beatmaps.QueryBeatmapSet(s => s.OnlineBeatmapSetID == testBeatmapSet.OnlineBeatmapSetID);
+            var existing = beatmaps.QueryBeatmapSet(s => s.OnlineID == testBeatmapSet.OnlineID);
             if (existing != null)
                 beatmaps.Delete(existing);
 
@@ -101,10 +101,10 @@ namespace osu.Game.Tests.Online
             AddStep("import beatmap", () => beatmaps.Import(testBeatmapFile).Wait());
             addAvailabilityCheckStep("state locally available", BeatmapAvailability.LocallyAvailable);
 
-            AddStep("delete beatmap", () => beatmaps.Delete(beatmaps.QueryBeatmapSet(b => b.OnlineBeatmapSetID == testBeatmapSet.OnlineBeatmapSetID)));
+            AddStep("delete beatmap", () => beatmaps.Delete(beatmaps.QueryBeatmapSet(b => b.OnlineID == testBeatmapSet.OnlineID)));
             addAvailabilityCheckStep("state not downloaded", BeatmapAvailability.NotDownloaded);
 
-            AddStep("undelete beatmap", () => beatmaps.Undelete(beatmaps.QueryBeatmapSet(b => b.OnlineBeatmapSetID == testBeatmapSet.OnlineBeatmapSetID)));
+            AddStep("undelete beatmap", () => beatmaps.Undelete(beatmaps.QueryBeatmapSet(b => b.OnlineID == testBeatmapSet.OnlineID)));
             addAvailabilityCheckStep("state locally available", BeatmapAvailability.LocallyAvailable);
         }
 
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs
index 1f96a15f80..aef1fb31d6 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs
@@ -66,7 +66,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             manager.Import(new BeatmapSetInfo
             {
-                OnlineBeatmapSetID = 10,
+                OnlineID = 10,
                 Hash = Guid.NewGuid().ToString().ComputeMD5Hash(),
                 Metadata = new BeatmapMetadata
                 {
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsSongSelect.cs b/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsSongSelect.cs
index 07ce6ebffc..05f9a94cf7 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsSongSelect.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsSongSelect.cs
@@ -67,7 +67,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             manager.Import(new BeatmapSetInfo
             {
-                OnlineBeatmapSetID = 10,
+                OnlineID = 10,
                 Hash = new MemoryStream(Encoding.UTF8.GetBytes(Guid.NewGuid().ToString())).ComputeMD5Hash(),
                 Metadata = new BeatmapMetadata
                 {
diff --git a/osu.Game.Tests/Visual/Navigation/TestScenePerformFromScreen.cs b/osu.Game.Tests/Visual/Navigation/TestScenePerformFromScreen.cs
index 4ec76e1e4b..4e1b3bb9bf 100644
--- a/osu.Game.Tests/Visual/Navigation/TestScenePerformFromScreen.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestScenePerformFromScreen.cs
@@ -174,7 +174,7 @@ namespace osu.Game.Tests.Visual.Navigation
         {
             AddStep("import beatmap", () => ImportBeatmapTest.LoadQuickOszIntoOsu(Game).Wait());
             PushAndConfirm(() => new TestPlaySongSelect());
-            AddUntilStep("beatmap updated", () => Game.Beatmap.Value.BeatmapSetInfo.OnlineBeatmapSetID == 241526);
+            AddUntilStep("beatmap updated", () => Game.Beatmap.Value.BeatmapSetInfo.OnlineID == 241526);
         }
 
         public class DialogBlockingScreen : OsuScreen
diff --git a/osu.Game.Tests/Visual/Navigation/TestScenePresentBeatmap.cs b/osu.Game.Tests/Visual/Navigation/TestScenePresentBeatmap.cs
index fc4679b2e3..ff976c7bf6 100644
--- a/osu.Game.Tests/Visual/Navigation/TestScenePresentBeatmap.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestScenePresentBeatmap.cs
@@ -107,7 +107,7 @@ namespace osu.Game.Tests.Visual.Navigation
                 imported = Game.BeatmapManager.Import(new BeatmapSetInfo
                 {
                     Hash = Guid.NewGuid().ToString(),
-                    OnlineBeatmapSetID = i,
+                    OnlineID = i,
                     Metadata = metadata,
                     Beatmaps = new List<BeatmapInfo>
                     {
diff --git a/osu.Game.Tests/Visual/Navigation/TestScenePresentScore.cs b/osu.Game.Tests/Visual/Navigation/TestScenePresentScore.cs
index 062acb4d2c..72f160c9a9 100644
--- a/osu.Game.Tests/Visual/Navigation/TestScenePresentScore.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestScenePresentScore.cs
@@ -39,7 +39,7 @@ namespace osu.Game.Tests.Visual.Navigation
                 beatmap = Game.BeatmapManager.Import(new BeatmapSetInfo
                 {
                     Hash = Guid.NewGuid().ToString(),
-                    OnlineBeatmapSetID = 1,
+                    OnlineID = 1,
                     Metadata = metadata,
                     Beatmaps = new List<BeatmapInfo>
                     {
diff --git a/osu.Game.Tests/Visual/Online/TestSceneDirectDownloadButton.cs b/osu.Game.Tests/Visual/Online/TestSceneDirectDownloadButton.cs
index a865bbe950..22a91fa9a3 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneDirectDownloadButton.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneDirectDownloadButton.cs
@@ -44,7 +44,7 @@ namespace osu.Game.Tests.Visual.Online
             AddAssert("button state not downloaded", () => downloadButton.DownloadState == DownloadState.NotDownloaded);
             AddStep("import soleily", () => beatmaps.Import(TestResources.GetQuickTestBeatmapForImport()));
 
-            AddUntilStep("wait for beatmap import", () => beatmaps.GetAllUsableBeatmapSets().Any(b => b.OnlineBeatmapSetID == 241526));
+            AddUntilStep("wait for beatmap import", () => beatmaps.GetAllUsableBeatmapSets().Any(b => b.OnlineID == 241526));
             AddUntilStep("button state downloaded", () => downloadButton.DownloadState == DownloadState.LocallyAvailable);
 
             createButtonWithBeatmap(createSoleily());
@@ -57,7 +57,7 @@ namespace osu.Game.Tests.Visual.Online
         {
             AddStep("remove soleily", () =>
             {
-                var beatmap = beatmaps.QueryBeatmapSet(b => b.OnlineBeatmapSetID == 241526);
+                var beatmap = beatmaps.QueryBeatmapSet(b => b.OnlineID == 241526);
 
                 if (beatmap != null) beatmaps.Delete(beatmap);
             });
diff --git a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs
index f3ee01354c..c5287d4257 100644
--- a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs
+++ b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs
@@ -122,7 +122,7 @@ namespace osu.Game.Tests.Visual.Playlists
 
                 // intentionally increment online IDs to clash with import below.
                 beatmap.BeatmapInfo.OnlineID++;
-                beatmap.BeatmapInfo.BeatmapSet.OnlineBeatmapSetID++;
+                beatmap.BeatmapInfo.BeatmapSet.OnlineID++;
 
                 importedSet = manager.Import(beatmap.BeatmapInfo.BeatmapSet).Result.Value;
             });
diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs
index 1c5898d073..534442c8b6 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs
@@ -838,7 +838,7 @@ namespace osu.Game.Tests.Visual.SongSelect
             return new BeatmapSetInfo
             {
                 ID = id,
-                OnlineBeatmapSetID = id,
+                OnlineID = id,
                 Hash = new MemoryStream(Encoding.UTF8.GetBytes(Guid.NewGuid().ToString())).ComputeMD5Hash(),
                 Metadata = new BeatmapMetadata
                 {
@@ -884,7 +884,7 @@ namespace osu.Game.Tests.Visual.SongSelect
             var toReturn = new BeatmapSetInfo
             {
                 ID = id,
-                OnlineBeatmapSetID = id,
+                OnlineID = id,
                 Hash = new MemoryStream(Encoding.UTF8.GetBytes(Guid.NewGuid().ToString())).ComputeMD5Hash(),
                 Metadata = new BeatmapMetadata
                 {
diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapRecommendations.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapRecommendations.cs
index cbb58a916f..a0742b862b 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapRecommendations.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapRecommendations.cs
@@ -180,7 +180,7 @@ namespace osu.Game.Tests.Visual.SongSelect
             var beatmapSet = new BeatmapSetInfo
             {
                 Hash = Guid.NewGuid().ToString(),
-                OnlineBeatmapSetID = importID,
+                OnlineID = importID,
                 Metadata = metadata,
                 Beatmaps = difficultyRulesets.Select((ruleset, difficultyIndex) => new BeatmapInfo
                 {
diff --git a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
index b2fc34d675..ee5a61f21f 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
@@ -931,7 +931,7 @@ namespace osu.Game.Tests.Visual.SongSelect
 
             return new BeatmapSetInfo
             {
-                OnlineBeatmapSetID = setId,
+                OnlineID = setId,
                 Hash = new MemoryStream(Encoding.UTF8.GetBytes(Guid.NewGuid().ToString())).ComputeMD5Hash(),
                 Metadata = new BeatmapMetadata
                 {
diff --git a/osu.Game/Beatmaps/BeatmapModelManager.cs b/osu.Game/Beatmaps/BeatmapModelManager.cs
index ac94163b4d..3becbee0ba 100644
--- a/osu.Game/Beatmaps/BeatmapModelManager.cs
+++ b/osu.Game/Beatmaps/BeatmapModelManager.cs
@@ -102,9 +102,9 @@ namespace osu.Game.Beatmaps
             // ensure at least one beatmap was able to retrieve or keep an online ID, else drop the set ID.
             if (hadOnlineIDs && !beatmapSet.Beatmaps.Any(b => b.OnlineID > 0))
             {
-                if (beatmapSet.OnlineBeatmapSetID != null)
+                if (beatmapSet.OnlineID != null)
                 {
-                    beatmapSet.OnlineBeatmapSetID = null;
+                    beatmapSet.OnlineID = null;
                     LogForModel(beatmapSet, "Disassociating beatmap set ID due to loss of all beatmap IDs");
                 }
             }
@@ -116,20 +116,20 @@ namespace osu.Game.Beatmaps
                 throw new InvalidOperationException($"Cannot import {nameof(BeatmapInfo)} with null {nameof(BeatmapInfo.BaseDifficulty)}.");
 
             // check if a set already exists with the same online id, delete if it does.
-            if (beatmapSet.OnlineBeatmapSetID != null)
+            if (beatmapSet.OnlineID != null)
             {
-                var existingSetWithSameOnlineID = beatmaps.ConsumableItems.FirstOrDefault(b => b.OnlineBeatmapSetID == beatmapSet.OnlineBeatmapSetID);
+                var existingSetWithSameOnlineID = beatmaps.ConsumableItems.FirstOrDefault(b => b.OnlineID == beatmapSet.OnlineID);
 
                 if (existingSetWithSameOnlineID != null)
                 {
                     Delete(existingSetWithSameOnlineID);
 
                     // in order to avoid a unique key constraint, immediately remove the online ID from the previous set.
-                    existingSetWithSameOnlineID.OnlineBeatmapSetID = null;
+                    existingSetWithSameOnlineID.OnlineID = null;
                     foreach (var b in existingSetWithSameOnlineID.Beatmaps)
                         b.OnlineID = null;
 
-                    LogForModel(beatmapSet, $"Found existing beatmap set with same OnlineBeatmapSetID ({beatmapSet.OnlineBeatmapSetID}). It has been deleted.");
+                    LogForModel(beatmapSet, $"Found existing beatmap set with same OnlineBeatmapSetID ({beatmapSet.OnlineID}). It has been deleted.");
                 }
             }
         }
@@ -254,7 +254,7 @@ namespace osu.Game.Beatmaps
             var importIds = import.Beatmaps.Select(b => b.OnlineID).OrderBy(i => i);
 
             // force re-import if we are not in a sane state.
-            return existing.OnlineBeatmapSetID == import.OnlineBeatmapSetID && existingIds.SequenceEqual(importIds);
+            return existing.OnlineID == import.OnlineID && existingIds.SequenceEqual(importIds);
         }
 
         /// <summary>
@@ -349,7 +349,7 @@ namespace osu.Game.Beatmaps
 
         protected override bool CheckLocalAvailability(BeatmapSetInfo model, IQueryable<BeatmapSetInfo> items)
             => base.CheckLocalAvailability(model, items)
-               || (model.OnlineBeatmapSetID != null && items.Any(b => b.OnlineBeatmapSetID == model.OnlineBeatmapSetID));
+               || (model.OnlineID != null && items.Any(b => b.OnlineID == model.OnlineID));
 
         protected override BeatmapSetInfo CreateModel(ArchiveReader reader)
         {
@@ -368,7 +368,7 @@ namespace osu.Game.Beatmaps
 
             return new BeatmapSetInfo
             {
-                OnlineBeatmapSetID = beatmap.BeatmapInfo.BeatmapSet?.OnlineBeatmapSetID,
+                OnlineID = beatmap.BeatmapInfo.BeatmapSet?.OnlineID,
                 Beatmaps = new List<BeatmapInfo>(),
                 Metadata = beatmap.Metadata,
                 DateAdded = DateTimeOffset.UtcNow
diff --git a/osu.Game/Beatmaps/BeatmapOnlineLookupQueue.cs b/osu.Game/Beatmaps/BeatmapOnlineLookupQueue.cs
index 69b03683dd..7c80d8ad56 100644
--- a/osu.Game/Beatmaps/BeatmapOnlineLookupQueue.cs
+++ b/osu.Game/Beatmaps/BeatmapOnlineLookupQueue.cs
@@ -84,7 +84,7 @@ namespace osu.Game.Beatmaps
                 {
                     beatmapInfo.Status = res.Status;
                     beatmapInfo.BeatmapSet.Status = res.BeatmapSet?.Status ?? BeatmapSetOnlineStatus.None;
-                    beatmapInfo.BeatmapSet.OnlineBeatmapSetID = res.OnlineBeatmapSetID;
+                    beatmapInfo.BeatmapSet.OnlineID = res.OnlineBeatmapSetID;
                     beatmapInfo.OnlineID = res.OnlineID;
 
                     if (beatmapInfo.Metadata != null)
@@ -186,7 +186,7 @@ namespace osu.Game.Beatmaps
 
                                 beatmapInfo.Status = status;
                                 beatmapInfo.BeatmapSet.Status = status;
-                                beatmapInfo.BeatmapSet.OnlineBeatmapSetID = reader.GetInt32(0);
+                                beatmapInfo.BeatmapSet.OnlineID = reader.GetInt32(0);
                                 beatmapInfo.OnlineID = reader.GetInt32(1);
 
                                 if (beatmapInfo.Metadata != null)
diff --git a/osu.Game/Beatmaps/BeatmapSetInfo.cs b/osu.Game/Beatmaps/BeatmapSetInfo.cs
index 0c93c4b9db..f42e6876e3 100644
--- a/osu.Game/Beatmaps/BeatmapSetInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapSetInfo.cs
@@ -16,12 +16,13 @@ namespace osu.Game.Beatmaps
     {
         public int ID { get; set; }
 
-        private int? onlineBeatmapSetID;
+        private int? onlineID;
 
-        public int? OnlineBeatmapSetID
+        [Column("OnlineBeatmapSetID")]
+        public int? OnlineID
         {
-            get => onlineBeatmapSetID;
-            set => onlineBeatmapSetID = value > 0 ? value : null;
+            get => onlineID;
+            set => onlineID = value > 0 ? value : null;
         }
 
         public DateTimeOffset DateAdded { get; set; }
@@ -74,8 +75,8 @@ namespace osu.Game.Beatmaps
             if (ID != 0 && other.ID != 0)
                 return ID == other.ID;
 
-            if (OnlineBeatmapSetID.HasValue && other.OnlineBeatmapSetID.HasValue)
-                return OnlineBeatmapSetID == other.OnlineBeatmapSetID;
+            if (OnlineID.HasValue && other.OnlineID.HasValue)
+                return OnlineID == other.OnlineID;
 
             if (!string.IsNullOrEmpty(Hash) && !string.IsNullOrEmpty(other.Hash))
                 return Hash == other.Hash;
@@ -85,7 +86,7 @@ namespace osu.Game.Beatmaps
 
         #region Implementation of IHasOnlineID
 
-        public int OnlineID => OnlineBeatmapSetID ?? -1;
+        int IHasOnlineID<int>.OnlineID => OnlineID ?? -1;
 
         #endregion
 
diff --git a/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs b/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
index 7a92d03e42..65d050e608 100644
--- a/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
+++ b/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
@@ -267,7 +267,7 @@ namespace osu.Game.Beatmaps.Formats
                     break;
 
                 case @"BeatmapSetID":
-                    beatmap.BeatmapInfo.BeatmapSet = new BeatmapSetInfo { OnlineBeatmapSetID = Parsing.ParseInt(pair.Value) };
+                    beatmap.BeatmapInfo.BeatmapSet = new BeatmapSetInfo { OnlineID = Parsing.ParseInt(pair.Value) };
                     break;
             }
         }
diff --git a/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs b/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs
index e26b96254f..49853418d6 100644
--- a/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs
+++ b/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs
@@ -134,7 +134,7 @@ namespace osu.Game.Beatmaps.Formats
             if (!string.IsNullOrEmpty(beatmap.Metadata.Source)) writer.WriteLine(FormattableString.Invariant($"Source: {beatmap.Metadata.Source}"));
             if (!string.IsNullOrEmpty(beatmap.Metadata.Tags)) writer.WriteLine(FormattableString.Invariant($"Tags: {beatmap.Metadata.Tags}"));
             if (beatmap.BeatmapInfo.OnlineID != null) writer.WriteLine(FormattableString.Invariant($"BeatmapID: {beatmap.BeatmapInfo.OnlineID}"));
-            if (beatmap.BeatmapInfo.BeatmapSet?.OnlineBeatmapSetID != null) writer.WriteLine(FormattableString.Invariant($"BeatmapSetID: {beatmap.BeatmapInfo.BeatmapSet.OnlineBeatmapSetID}"));
+            if (beatmap.BeatmapInfo.BeatmapSet?.OnlineID != null) writer.WriteLine(FormattableString.Invariant($"BeatmapSetID: {beatmap.BeatmapInfo.BeatmapSet.OnlineID}"));
         }
 
         private void handleDifficulty(TextWriter writer)
diff --git a/osu.Game/Database/OsuDbContext.cs b/osu.Game/Database/OsuDbContext.cs
index 91654e2827..d8d2cb8981 100644
--- a/osu.Game/Database/OsuDbContext.cs
+++ b/osu.Game/Database/OsuDbContext.cs
@@ -129,7 +129,7 @@ namespace osu.Game.Database
             modelBuilder.Entity<BeatmapInfo>().HasIndex(b => b.MD5Hash);
             modelBuilder.Entity<BeatmapInfo>().HasIndex(b => b.Hash);
 
-            modelBuilder.Entity<BeatmapSetInfo>().HasIndex(b => b.OnlineBeatmapSetID).IsUnique();
+            modelBuilder.Entity<BeatmapSetInfo>().HasIndex(b => b.OnlineID).IsUnique();
             modelBuilder.Entity<BeatmapSetInfo>().HasIndex(b => b.DeletePending);
             modelBuilder.Entity<BeatmapSetInfo>().HasIndex(b => b.Hash).IsUnique();
 
diff --git a/osu.Game/Online/BeatmapDownloadTracker.cs b/osu.Game/Online/BeatmapDownloadTracker.cs
index 592dc60d20..77a8fca1e4 100644
--- a/osu.Game/Online/BeatmapDownloadTracker.cs
+++ b/osu.Game/Online/BeatmapDownloadTracker.cs
@@ -29,7 +29,7 @@ namespace osu.Game.Online
                 return;
 
             // Used to interact with manager classes that don't support interface types. Will eventually be replaced.
-            var beatmapSetInfo = new BeatmapSetInfo { OnlineBeatmapSetID = TrackedItem.OnlineID };
+            var beatmapSetInfo = new BeatmapSetInfo { OnlineID = TrackedItem.OnlineID };
 
             if (Manager.IsAvailableLocally(beatmapSetInfo))
                 UpdateState(DownloadState.LocallyAvailable);
diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index bf757a153f..095add399c 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -443,7 +443,7 @@ namespace osu.Game
             BeatmapSetInfo databasedSet = null;
 
             if (beatmap.OnlineID > 0)
-                databasedSet = BeatmapManager.QueryBeatmapSet(s => s.OnlineBeatmapSetID == beatmap.OnlineID);
+                databasedSet = BeatmapManager.QueryBeatmapSet(s => s.OnlineID == beatmap.OnlineID);
 
             if (beatmap is BeatmapSetInfo localBeatmap)
                 databasedSet ??= BeatmapManager.QueryBeatmapSet(s => s.Hash == localBeatmap.Hash);
diff --git a/osu.Game/Screens/Play/SoloSpectator.cs b/osu.Game/Screens/Play/SoloSpectator.cs
index 1dcc191c0f..c65d4af2ae 100644
--- a/osu.Game/Screens/Play/SoloSpectator.cs
+++ b/osu.Game/Screens/Play/SoloSpectator.cs
@@ -241,7 +241,7 @@ namespace osu.Game.Screens.Play
             if (!automaticDownload.Current.Value)
                 return;
 
-            if (beatmaps.IsAvailableLocally(new BeatmapSetInfo { OnlineBeatmapSetID = beatmapSet.OnlineID }))
+            if (beatmaps.IsAvailableLocally(new BeatmapSetInfo { OnlineID = beatmapSet.OnlineID }))
                 return;
 
             beatmaps.Download(beatmapSet);
diff --git a/osu.Game/Screens/Select/Carousel/CarouselBeatmap.cs b/osu.Game/Screens/Select/Carousel/CarouselBeatmap.cs
index df51287d4a..cc2db6ed31 100644
--- a/osu.Game/Screens/Select/Carousel/CarouselBeatmap.cs
+++ b/osu.Game/Screens/Select/Carousel/CarouselBeatmap.cs
@@ -67,7 +67,7 @@ namespace osu.Game.Screens.Select.Carousel
                 if (!match && criteria.SearchNumber.HasValue)
                 {
                     match = (BeatmapInfo.OnlineID == criteria.SearchNumber.Value) ||
-                            (BeatmapInfo.BeatmapSet?.OnlineBeatmapSetID == criteria.SearchNumber.Value);
+                            (BeatmapInfo.BeatmapSet?.OnlineID == criteria.SearchNumber.Value);
                 }
             }
 
diff --git a/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmapSet.cs b/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmapSet.cs
index 173b804d90..619b1e0fd0 100644
--- a/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmapSet.cs
+++ b/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmapSet.cs
@@ -214,8 +214,8 @@ namespace osu.Game.Screens.Select.Carousel
                 if (Item.State.Value == CarouselItemState.NotSelected)
                     items.Add(new OsuMenuItem("Expand", MenuItemType.Highlighted, () => Item.State.Value = CarouselItemState.Selected));
 
-                if (beatmapSet.OnlineBeatmapSetID != null && viewDetails != null)
-                    items.Add(new OsuMenuItem("Details...", MenuItemType.Standard, () => viewDetails(beatmapSet.OnlineBeatmapSetID.Value)));
+                if (beatmapSet.OnlineID != null && viewDetails != null)
+                    items.Add(new OsuMenuItem("Details...", MenuItemType.Standard, () => viewDetails(beatmapSet.OnlineID.Value)));
 
                 if (collectionManager != null)
                 {
diff --git a/osu.Game/Stores/BeatmapImporter.cs b/osu.Game/Stores/BeatmapImporter.cs
index f203e55c27..a9605f1fc3 100644
--- a/osu.Game/Stores/BeatmapImporter.cs
+++ b/osu.Game/Stores/BeatmapImporter.cs
@@ -182,7 +182,7 @@ namespace osu.Game.Stores
 
             return new RealmBeatmapSet
             {
-                OnlineID = beatmap.BeatmapInfo.BeatmapSet?.OnlineBeatmapSetID ?? -1,
+                OnlineID = beatmap.BeatmapInfo.BeatmapSet?.OnlineID ?? -1,
                 // Metadata = beatmap.Metadata,
                 DateAdded = DateTimeOffset.UtcNow
             };
diff --git a/osu.Game/Tests/Beatmaps/TestBeatmap.cs b/osu.Game/Tests/Beatmaps/TestBeatmap.cs
index 38c8219813..32a9b0b9d1 100644
--- a/osu.Game/Tests/Beatmaps/TestBeatmap.cs
+++ b/osu.Game/Tests/Beatmaps/TestBeatmap.cs
@@ -35,7 +35,7 @@ namespace osu.Game.Tests.Beatmaps
             BeatmapInfo.RulesetID = ruleset.ID ?? 0;
             BeatmapInfo.BeatmapSet.Metadata = BeatmapInfo.Metadata;
             BeatmapInfo.BeatmapSet.Beatmaps = new List<BeatmapInfo> { BeatmapInfo };
-            BeatmapInfo.BeatmapSet.OnlineBeatmapSetID = Interlocked.Increment(ref onlineSetID);
+            BeatmapInfo.BeatmapSet.OnlineID = Interlocked.Increment(ref onlineSetID);
             BeatmapInfo.Length = 75000;
             BeatmapInfo.OnlineInfo = new APIBeatmap();
             BeatmapInfo.OnlineID = Interlocked.Increment(ref onlineBeatmapID);
diff --git a/osu.Game/Tests/Visual/OsuTestScene.cs b/osu.Game/Tests/Visual/OsuTestScene.cs
index 83bf130f26..fc7bc324ca 100644
--- a/osu.Game/Tests/Visual/OsuTestScene.cs
+++ b/osu.Game/Tests/Visual/OsuTestScene.cs
@@ -203,7 +203,7 @@ namespace osu.Game.Tests.Visual
 
             return new APIBeatmapSet
             {
-                OnlineID = beatmap.BeatmapSet.OnlineID,
+                OnlineID = ((IBeatmapSetInfo)beatmap.BeatmapSet).OnlineID,
                 Status = BeatmapSetOnlineStatus.Ranked,
                 Covers = new BeatmapSetOnlineCovers
                 {
@@ -223,7 +223,7 @@ namespace osu.Game.Tests.Visual
                     new APIBeatmap
                     {
                         OnlineID = ((IBeatmapInfo)beatmap).OnlineID,
-                        OnlineBeatmapSetID = beatmap.BeatmapSet.OnlineID,
+                        OnlineBeatmapSetID = ((IBeatmapSetInfo)beatmap.BeatmapSet).OnlineID,
                         Status = beatmap.Status,
                         Checksum = beatmap.MD5Hash,
                         AuthorID = beatmap.Metadata.Author.OnlineID,

From a67e156883fb6f80aa10e3af6701ae2417181c48 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 12 Nov 2021 18:09:45 +0900
Subject: [PATCH 0959/5547] Add `IBeatmapInfo` equality support

---
 osu.Game/Beatmaps/BeatmapInfo.cs                  | 11 +++++++++++
 osu.Game/Beatmaps/IBeatmapInfo.cs                 |  3 ++-
 osu.Game/Models/RealmBeatmap.cs                   | 15 +++++++++++++++
 .../Online/API/Requests/Responses/APIBeatmap.cs   | 12 ++++++++++++
 4 files changed, 40 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Beatmaps/BeatmapInfo.cs b/osu.Game/Beatmaps/BeatmapInfo.cs
index 5bbd48f26d..ea2346f060 100644
--- a/osu.Game/Beatmaps/BeatmapInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapInfo.cs
@@ -151,6 +151,17 @@ namespace osu.Game.Beatmaps
 
         public override string ToString() => this.GetDisplayTitle();
 
+        public bool Equals(IBeatmapInfo other)
+        {
+            if (other is BeatmapInfo b)
+                return Equals(b);
+
+            if (OnlineID > 0 && other?.OnlineID > 0)
+                return other.OnlineID == OnlineID;
+
+            return false;
+        }
+
         public bool Equals(BeatmapInfo other)
         {
             if (ID == 0 || other?.ID == 0)
diff --git a/osu.Game/Beatmaps/IBeatmapInfo.cs b/osu.Game/Beatmaps/IBeatmapInfo.cs
index 84ea6d3019..ab096b8897 100644
--- a/osu.Game/Beatmaps/IBeatmapInfo.cs
+++ b/osu.Game/Beatmaps/IBeatmapInfo.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.Game.Database;
 using osu.Game.Rulesets;
 
@@ -11,7 +12,7 @@ namespace osu.Game.Beatmaps
     /// <summary>
     /// A single beatmap difficulty.
     /// </summary>
-    public interface IBeatmapInfo : IHasOnlineID<int>
+    public interface IBeatmapInfo : IHasOnlineID<int>, IEquatable<IBeatmapInfo>
     {
         /// <summary>
         /// The user-specified name given to this beatmap.
diff --git a/osu.Game/Models/RealmBeatmap.cs b/osu.Game/Models/RealmBeatmap.cs
index 9311425cb7..d1907d3ffd 100644
--- a/osu.Game/Models/RealmBeatmap.cs
+++ b/osu.Game/Models/RealmBeatmap.cs
@@ -98,6 +98,21 @@ namespace osu.Game.Models
 
         #endregion
 
+        #region Implementation of IEquatable<IBeatmapInfo>
+
+        public bool Equals(IBeatmapInfo? other)
+        {
+            if (other is RealmBeatmap b)
+                return b.ID == ID;
+
+            if (OnlineID > 0 && other?.OnlineID > 0)
+                return other.OnlineID == OnlineID;
+
+            return false;
+        }
+
+        #endregion
+
         public bool AudioEquals(RealmBeatmap? other) => other != null
                                                         && BeatmapSet != null
                                                         && other.BeatmapSet != null
diff --git a/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs b/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs
index 2560502173..33098a2919 100644
--- a/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs
@@ -103,5 +103,17 @@ namespace osu.Game.Online.API.Requests.Responses
         public string Hash => throw new NotImplementedException();
 
         #endregion
+
+        #region Implementation of IEquatable<IBeatmapInfo>
+
+        public bool Equals(IBeatmapInfo? other)
+        {
+            if (OnlineID > 0 && other?.OnlineID > 0)
+                return other.OnlineID == OnlineID;
+
+            return false;
+        }
+
+        #endregion
     }
 }

From 54cd1158a4b198e55d6747fd98124e50d29aa401 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 12 Nov 2021 18:14:11 +0900
Subject: [PATCH 0960/5547] Add `IBeatmapSetInfo` equality support

---
 osu.Game/Beatmaps/BeatmapSetInfo.cs                 | 11 +++++++++++
 osu.Game/Beatmaps/IBeatmapSetInfo.cs                |  2 +-
 osu.Game/Models/RealmBeatmapSet.cs                  | 13 ++++++++++++-
 .../Online/API/Requests/Responses/APIBeatmapSet.cs  | 12 ++++++++++++
 4 files changed, 36 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapSetInfo.cs b/osu.Game/Beatmaps/BeatmapSetInfo.cs
index 0c93c4b9db..5bdaf26471 100644
--- a/osu.Game/Beatmaps/BeatmapSetInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapSetInfo.cs
@@ -66,6 +66,17 @@ namespace osu.Game.Beatmaps
 
         public bool Protected { get; set; }
 
+        public bool Equals(IBeatmapSetInfo other)
+        {
+            if (other is BeatmapSetInfo b)
+                return Equals(b);
+
+            if (OnlineID > 0 && other?.OnlineID > 0)
+                return other.OnlineID == OnlineID;
+
+            return false;
+        }
+
         public bool Equals(BeatmapSetInfo other)
         {
             if (other == null)
diff --git a/osu.Game/Beatmaps/IBeatmapSetInfo.cs b/osu.Game/Beatmaps/IBeatmapSetInfo.cs
index 20c46d9063..67f38397d4 100644
--- a/osu.Game/Beatmaps/IBeatmapSetInfo.cs
+++ b/osu.Game/Beatmaps/IBeatmapSetInfo.cs
@@ -12,7 +12,7 @@ namespace osu.Game.Beatmaps
     /// <summary>
     /// A representation of a collection of beatmap difficulties, generally packaged as an ".osz" archive.
     /// </summary>
-    public interface IBeatmapSetInfo : IHasOnlineID<int>
+    public interface IBeatmapSetInfo : IHasOnlineID<int>, IEquatable<IBeatmapSetInfo>
     {
         /// <summary>
         /// The date when this beatmap was imported.
diff --git a/osu.Game/Models/RealmBeatmapSet.cs b/osu.Game/Models/RealmBeatmapSet.cs
index 6735510422..ddf2cf48fa 100644
--- a/osu.Game/Models/RealmBeatmapSet.cs
+++ b/osu.Game/Models/RealmBeatmapSet.cs
@@ -53,7 +53,16 @@ namespace osu.Game.Models
         /// <param name="filename">The name of the file to get the storage path of.</param>
         public string? GetPathForFile(string filename) => Files.SingleOrDefault(f => string.Equals(f.Filename, filename, StringComparison.OrdinalIgnoreCase))?.File.StoragePath;
 
-        public override string ToString() => Metadata?.ToString() ?? base.ToString();
+        public bool Equals(IBeatmapSetInfo? other)
+        {
+            if (other is RealmBeatmap b)
+                return b.ID == ID;
+
+            if (OnlineID > 0 && other?.OnlineID > 0)
+                return other.OnlineID == OnlineID;
+
+            return false;
+        }
 
         public bool Equals(RealmBeatmapSet? other)
         {
@@ -72,6 +81,8 @@ namespace osu.Game.Models
             return ReferenceEquals(this, other);
         }
 
+        public override string ToString() => Metadata?.ToString() ?? base.ToString();
+
         IEnumerable<IBeatmapInfo> IBeatmapSetInfo.Beatmaps => Beatmaps;
 
         IEnumerable<INamedFileUsage> IBeatmapSetInfo.Files => Files;
diff --git a/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs b/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs
index 168e9d5d51..f4515c4258 100644
--- a/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs
@@ -141,5 +141,17 @@ namespace osu.Game.Online.API.Requests.Responses
         double IBeatmapSetInfo.MaxBPM => BPM;
 
         #endregion
+
+        #region Implementation of IEquatable<IBeatmapSetInfo>
+
+        public bool Equals(IBeatmapSetInfo? other)
+        {
+            if (OnlineID > 0 && other?.OnlineID > 0)
+                return other.OnlineID == OnlineID;
+
+            return false;
+        }
+
+        #endregion
     }
 }

From 7349e5521a0dbbb73b50ad7bbbab2f8e7db19c26 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 12 Nov 2021 18:10:06 +0900
Subject: [PATCH 0961/5547] Update `BeatmapCollection` to use `IBeatmapInfo`

---
 osu.Game/Collections/BeatmapCollection.cs        | 2 +-
 osu.Game/Collections/CollectionFilterDropdown.cs | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Collections/BeatmapCollection.cs b/osu.Game/Collections/BeatmapCollection.cs
index 7e4b15ecf9..1a739f824f 100644
--- a/osu.Game/Collections/BeatmapCollection.cs
+++ b/osu.Game/Collections/BeatmapCollection.cs
@@ -25,7 +25,7 @@ namespace osu.Game.Collections
         /// <summary>
         /// The beatmaps contained by the collection.
         /// </summary>
-        public readonly BindableList<BeatmapInfo> Beatmaps = new BindableList<BeatmapInfo>();
+        public readonly BindableList<IBeatmapInfo> Beatmaps = new BindableList<IBeatmapInfo>();
 
         /// <summary>
         /// The date when this collection was last modified.
diff --git a/osu.Game/Collections/CollectionFilterDropdown.cs b/osu.Game/Collections/CollectionFilterDropdown.cs
index 7067f82fd3..ad23874b2e 100644
--- a/osu.Game/Collections/CollectionFilterDropdown.cs
+++ b/osu.Game/Collections/CollectionFilterDropdown.cs
@@ -39,7 +39,7 @@ namespace osu.Game.Collections
         }
 
         private readonly IBindableList<BeatmapCollection> collections = new BindableList<BeatmapCollection>();
-        private readonly IBindableList<BeatmapInfo> beatmaps = new BindableList<BeatmapInfo>();
+        private readonly IBindableList<IBeatmapInfo> beatmaps = new BindableList<IBeatmapInfo>();
         private readonly BindableList<CollectionFilterMenuItem> filters = new BindableList<CollectionFilterMenuItem>();
 
         [Resolved(CanBeNull = true)]
@@ -200,7 +200,7 @@ namespace osu.Game.Collections
             private IBindable<WorkingBeatmap> beatmap { get; set; }
 
             [CanBeNull]
-            private readonly BindableList<BeatmapInfo> collectionBeatmaps;
+            private readonly BindableList<IBeatmapInfo> collectionBeatmaps;
 
             [NotNull]
             private readonly Bindable<string> collectionName;

From 1c49c4a6029942c8fa8a07efe18a2a34534597a1 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 12 Nov 2021 18:32:39 +0900
Subject: [PATCH 0962/5547] Fix incorrect type check

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

diff --git a/osu.Game/Models/RealmBeatmapSet.cs b/osu.Game/Models/RealmBeatmapSet.cs
index ddf2cf48fa..3217abb419 100644
--- a/osu.Game/Models/RealmBeatmapSet.cs
+++ b/osu.Game/Models/RealmBeatmapSet.cs
@@ -55,7 +55,7 @@ namespace osu.Game.Models
 
         public bool Equals(IBeatmapSetInfo? other)
         {
-            if (other is RealmBeatmap b)
+            if (other is RealmBeatmapSet b)
                 return b.ID == ID;
 
             if (OnlineID > 0 && other?.OnlineID > 0)

From 63bc41556548be75ceab8fd9d1d0f5fb347d78b3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 12 Nov 2021 18:35:42 +0900
Subject: [PATCH 0963/5547] Warn on suspicious types

---
 osu.sln.DotSettings | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/osu.sln.DotSettings b/osu.sln.DotSettings
index f35bdfce66..3fac94b243 100644
--- a/osu.sln.DotSettings
+++ b/osu.sln.DotSettings
@@ -209,6 +209,8 @@
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=StructCanBeMadeReadOnly/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=SuggestVarOrType_005FBuiltInTypes/@EntryIndexedValue">SUGGESTION</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=SuggestVarOrType_005FSimpleTypes/@EntryIndexedValue">DO_NOT_SHOW</s:String>
+	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=SuspiciousTypeConversion_002EGlobal/@EntryIndexedValue"></s:String>
+	<s:Boolean x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=SuspiciousTypeConversion_002EGlobal/@EntryIndexRemoved">True</s:Boolean>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=SwitchStatementMissingSomeCases/@EntryIndexedValue">DO_NOT_SHOW</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=TabsAndSpacesMismatch/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=TabsAreDisallowed/@EntryIndexedValue">WARNING</s:String>

From 1d962648c29bd3e06e2b7609698274f57256da80 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 12 Nov 2021 18:48:34 +0900
Subject: [PATCH 0964/5547] Standardise implementations

---
 osu.Game/Beatmaps/BeatmapInfo.cs    | 26 +++++++++++++----------
 osu.Game/Beatmaps/BeatmapSetInfo.cs | 33 +++++++++++++----------------
 osu.Game/Models/RealmBeatmap.cs     | 22 +++++++++++++++----
 osu.Game/Models/RealmBeatmapSet.cs  | 32 ++++++++++++----------------
 4 files changed, 61 insertions(+), 52 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapInfo.cs b/osu.Game/Beatmaps/BeatmapInfo.cs
index ea2346f060..211a5f4088 100644
--- a/osu.Game/Beatmaps/BeatmapInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapInfo.cs
@@ -151,25 +151,29 @@ namespace osu.Game.Beatmaps
 
         public override string ToString() => this.GetDisplayTitle();
 
-        public bool Equals(IBeatmapInfo other)
+        public bool Equals(BeatmapInfo other)
         {
-            if (other is BeatmapInfo b)
-                return Equals(b);
+            if (ReferenceEquals(this, other)) return true;
+            if (other == null) return false;
 
-            if (OnlineID > 0 && other?.OnlineID > 0)
-                return other.OnlineID == OnlineID;
+            if (ID != 0 && other.ID != 0)
+                return ID == other.ID;
 
             return false;
         }
 
-        public bool Equals(BeatmapInfo other)
+        public bool Equals(IBeatmapInfo other)
         {
-            if (ID == 0 || other?.ID == 0)
-                // one of the two BeatmapInfos we are comparing isn't sourced from a database.
-                // fall back to reference equality.
-                return ReferenceEquals(this, other);
+            if (ReferenceEquals(this, other)) return true;
+            if (other == null) return false;
 
-            return ID == other?.ID;
+            if (other is BeatmapInfo b && Equals(b))
+                return true;
+
+            if (OnlineID > 0 && other.OnlineID > 0)
+                return other.OnlineID == OnlineID;
+
+            return false;
         }
 
         public bool AudioEquals(BeatmapInfo other) => other != null && BeatmapSet != null && other.BeatmapSet != null &&
diff --git a/osu.Game/Beatmaps/BeatmapSetInfo.cs b/osu.Game/Beatmaps/BeatmapSetInfo.cs
index 5bdaf26471..51d049c8f9 100644
--- a/osu.Game/Beatmaps/BeatmapSetInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapSetInfo.cs
@@ -66,32 +66,29 @@ namespace osu.Game.Beatmaps
 
         public bool Protected { get; set; }
 
-        public bool Equals(IBeatmapSetInfo other)
-        {
-            if (other is BeatmapSetInfo b)
-                return Equals(b);
-
-            if (OnlineID > 0 && other?.OnlineID > 0)
-                return other.OnlineID == OnlineID;
-
-            return false;
-        }
-
         public bool Equals(BeatmapSetInfo other)
         {
-            if (other == null)
-                return false;
+            if (ReferenceEquals(this, other)) return true;
+            if (other == null) return false;
 
             if (ID != 0 && other.ID != 0)
                 return ID == other.ID;
 
-            if (OnlineBeatmapSetID.HasValue && other.OnlineBeatmapSetID.HasValue)
-                return OnlineBeatmapSetID == other.OnlineBeatmapSetID;
+            return false;
+        }
 
-            if (!string.IsNullOrEmpty(Hash) && !string.IsNullOrEmpty(other.Hash))
-                return Hash == other.Hash;
+        public bool Equals(IBeatmapSetInfo other)
+        {
+            if (ReferenceEquals(this, other)) return true;
+            if (other == null) return false;
 
-            return ReferenceEquals(this, other);
+            if (other is BeatmapSetInfo b && Equals(b))
+                return true;
+
+            if (OnlineID > 0 && other.OnlineID > 0)
+                return other.OnlineID == OnlineID;
+
+            return false;
         }
 
         #region Implementation of IHasOnlineID
diff --git a/osu.Game/Models/RealmBeatmap.cs b/osu.Game/Models/RealmBeatmap.cs
index d1907d3ffd..f80d1f513a 100644
--- a/osu.Game/Models/RealmBeatmap.cs
+++ b/osu.Game/Models/RealmBeatmap.cs
@@ -20,7 +20,7 @@ namespace osu.Game.Models
     [ExcludeFromDynamicCompile]
     [Serializable]
     [MapTo("Beatmap")]
-    public class RealmBeatmap : RealmObject, IHasGuidPrimaryKey, IBeatmapInfo
+    public class RealmBeatmap : RealmObject, IHasGuidPrimaryKey, IBeatmapInfo, IEquatable<RealmBeatmap>
     {
         [PrimaryKey]
         public Guid ID { get; set; } = Guid.NewGuid();
@@ -98,14 +98,28 @@ namespace osu.Game.Models
 
         #endregion
 
+        public bool Equals(RealmBeatmap? other)
+        {
+            if (ReferenceEquals(this, other)) return true;
+            if (other == null) return false;
+
+            return ID == other.ID;
+        }
+
         #region Implementation of IEquatable<IBeatmapInfo>
 
         public bool Equals(IBeatmapInfo? other)
         {
-            if (other is RealmBeatmap b)
-                return b.ID == ID;
+            if (ReferenceEquals(this, other)) return true;
+            if (other == null) return false;
 
-            if (OnlineID > 0 && other?.OnlineID > 0)
+            if (other is RealmBeatmap b && Equals(b))
+                return true;
+
+            if (!string.IsNullOrEmpty(Hash) && !string.IsNullOrEmpty(other.Hash))
+                return Hash == other.Hash;
+
+            if (OnlineID > 0 && other.OnlineID > 0)
                 return other.OnlineID == OnlineID;
 
             return false;
diff --git a/osu.Game/Models/RealmBeatmapSet.cs b/osu.Game/Models/RealmBeatmapSet.cs
index 3217abb419..9cfa2de44d 100644
--- a/osu.Game/Models/RealmBeatmapSet.cs
+++ b/osu.Game/Models/RealmBeatmapSet.cs
@@ -53,32 +53,26 @@ namespace osu.Game.Models
         /// <param name="filename">The name of the file to get the storage path of.</param>
         public string? GetPathForFile(string filename) => Files.SingleOrDefault(f => string.Equals(f.Filename, filename, StringComparison.OrdinalIgnoreCase))?.File.StoragePath;
 
-        public bool Equals(IBeatmapSetInfo? other)
-        {
-            if (other is RealmBeatmapSet b)
-                return b.ID == ID;
-
-            if (OnlineID > 0 && other?.OnlineID > 0)
-                return other.OnlineID == OnlineID;
-
-            return false;
-        }
-
         public bool Equals(RealmBeatmapSet? other)
         {
-            if (other == null)
-                return false;
+            if (ReferenceEquals(this, other)) return true;
+            if (other == null) return false;
 
-            if (IsManaged && other.IsManaged)
-                return ID == other.ID;
+            return ID == other.ID;
+        }
+
+        public bool Equals(IBeatmapSetInfo? other)
+        {
+            if (ReferenceEquals(this, other)) return true;
+            if (other == null) return false;
+
+            if (other is RealmBeatmapSet b && Equals(b))
+                return true;
 
             if (OnlineID > 0 && other.OnlineID > 0)
                 return OnlineID == other.OnlineID;
 
-            if (!string.IsNullOrEmpty(Hash) && !string.IsNullOrEmpty(other.Hash))
-                return Hash == other.Hash;
-
-            return ReferenceEquals(this, other);
+            return false;
         }
 
         public override string ToString() => Metadata?.ToString() ?? base.ToString();

From 5e88d59a261575700b7913c8153bc9f005617c5e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 12 Nov 2021 19:06:12 +0900
Subject: [PATCH 0965/5547] Switch `BeatmapInfo.OnlineID` delegation to use
 property getter for conformity

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

diff --git a/osu.Game/Beatmaps/BeatmapInfo.cs b/osu.Game/Beatmaps/BeatmapInfo.cs
index 90c5b13bc4..602bb22c40 100644
--- a/osu.Game/Beatmaps/BeatmapInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapInfo.cs
@@ -177,7 +177,7 @@ namespace osu.Game.Beatmaps
 
         #region Implementation of IHasOnlineID
 
-        int IHasOnlineID<int>.OnlineID => onlineID ?? -1;
+        int IHasOnlineID<int>.OnlineID => OnlineID ?? -1;
 
         #endregion
 

From f02b57c37121a77523e4c54aa1a2fa5fc14a3cc1 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 12 Nov 2021 19:16:22 +0900
Subject: [PATCH 0966/5547] Limit new `IsZipArchive` method to `MemoryStream`
 for now
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/Utils/ZipUtils.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Utils/ZipUtils.cs b/osu.Game/Utils/ZipUtils.cs
index 16eb1c7e4e..eb2d2d3b80 100644
--- a/osu.Game/Utils/ZipUtils.cs
+++ b/osu.Game/Utils/ZipUtils.cs
@@ -9,7 +9,7 @@ namespace osu.Game.Utils
 {
     public static class ZipUtils
     {
-        public static bool IsZipArchive(Stream stream)
+        public static bool IsZipArchive(MemoryStream stream)
         {
             try
             {

From 131e64e56c14760ffc408993ca5416d44f863528 Mon Sep 17 00:00:00 2001
From: MBmasher <mbmasher@gmail.com>
Date: Fri, 12 Nov 2021 21:29:51 +1100
Subject: [PATCH 0967/5547] Add bonus based on opacity of hit objects

---
 .../Difficulty/OsuDifficultyCalculator.cs     | 17 ++++----
 .../Difficulty/OsuPerformanceCalculator.cs    | 14 -------
 .../Difficulty/Skills/Flashlight.cs           | 39 +++++++++++++++++--
 3 files changed, 43 insertions(+), 27 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs b/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs
index 558ddc16ef..19e92d4365 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs
@@ -22,6 +22,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty
     {
         private const double difficulty_multiplier = 0.0675;
         private double hitWindowGreat;
+        private double preempt;
 
         public OsuDifficultyCalculator(Ruleset ruleset, WorkingBeatmap beatmap)
             : base(ruleset, beatmap)
@@ -34,11 +35,8 @@ namespace osu.Game.Rulesets.Osu.Difficulty
                 return new OsuDifficultyAttributes { Mods = mods, Skills = skills };
 
             double aimRating = Math.Sqrt(skills[0].DifficultyValue()) * difficulty_multiplier;
-            double aimRatingNoSliders = Math.Sqrt(skills[1].DifficultyValue()) * difficulty_multiplier;
-            double speedRating = Math.Sqrt(skills[2].DifficultyValue()) * difficulty_multiplier;
-            double flashlightRating = Math.Sqrt(skills[3].DifficultyValue()) * difficulty_multiplier;
-
-            double sliderFactor = aimRating > 0 ? aimRatingNoSliders / aimRating : 1;
+            double speedRating = Math.Sqrt(skills[1].DifficultyValue()) * difficulty_multiplier;
+            double flashlightRating = Math.Sqrt(skills[2].DifficultyValue()) * difficulty_multiplier;
 
             if (mods.Any(h => h is OsuModRelax))
                 speedRating = 0.0;
@@ -77,7 +75,6 @@ namespace osu.Game.Rulesets.Osu.Difficulty
                 AimStrain = aimRating,
                 SpeedStrain = speedRating,
                 FlashlightRating = flashlightRating,
-                SliderFactor = sliderFactor,
                 ApproachRate = preempt > 1200 ? (1800 - preempt) / 120 : (1200 - preempt) / 150 + 5,
                 OverallDifficulty = (80 - hitWindowGreat) / 6,
                 DrainRate = drainRate,
@@ -110,12 +107,13 @@ namespace osu.Game.Rulesets.Osu.Difficulty
 
             hitWindowGreat = hitWindows.WindowFor(HitResult.Great) / clockRate;
 
+            preempt = IBeatmapDifficultyInfo.DifficultyRange(beatmap.Difficulty.ApproachRate, 1800, 1200, 450) / clockRate;
+
             return new Skill[]
             {
-                new Aim(mods, true),
-                new Aim(mods, false),
+                new Aim(mods),
                 new Speed(mods, hitWindowGreat),
-                new Flashlight(mods)
+                new Flashlight(mods, preempt)
             };
         }
 
@@ -126,6 +124,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty
             new OsuModEasy(),
             new OsuModHardRock(),
             new OsuModFlashlight(),
+            new OsuModHidden(),
         };
     }
 }
diff --git a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
index 8d45c7a8cc..817b0b63a8 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
@@ -125,16 +125,6 @@ namespace osu.Game.Rulesets.Osu.Difficulty
                 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;
-
-            if (Attributes.SliderCount > 0)
-            {
-                double estimateSliderEndsDropped = Math.Clamp(Math.Min(countOk + countMeh + countMiss, Attributes.MaxCombo - scoreMaxCombo), 0, estimateDifficultSliders);
-                double sliderNerfFactor = (1 - Attributes.SliderFactor) * Math.Pow(1 - estimateSliderEndsDropped / estimateDifficultSliders, 3) + Attributes.SliderFactor;
-                aimValue *= sliderNerfFactor;
-            }
-
             aimValue *= accuracy;
             // It is important to also consider accuracy difficulty when doing that.
             aimValue *= 0.98 + Math.Pow(Attributes.OverallDifficulty, 2) / 2500;
@@ -234,10 +224,6 @@ namespace osu.Game.Rulesets.Osu.Difficulty
 
             double flashlightValue = Math.Pow(rawFlashlight, 2.0) * 25.0;
 
-            // Add an additional bonus for HDFL.
-            if (mods.Any(h => h is OsuModHidden))
-                flashlightValue *= 1.3;
-
             // Penalize misses by assessing # of misses relative to the total # of objects. Default a 3% reduction for any # of misses.
             if (effectiveMissCount > 0)
                 flashlightValue *= 0.97 * Math.Pow(1 - Math.Pow((double)effectiveMissCount / totalHits, 0.775), Math.Pow(effectiveMissCount, .875));
diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
index 466f0556ab..55ef8db129 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
@@ -2,8 +2,10 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
+using System.Linq;
 using osu.Game.Rulesets.Difficulty.Preprocessing;
 using osu.Game.Rulesets.Mods;
+using osu.Game.Rulesets.Osu.Mods;
 using osu.Game.Rulesets.Osu.Difficulty.Preprocessing;
 using osu.Game.Rulesets.Osu.Objects;
 
@@ -14,16 +16,24 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
     /// </summary>
     public class Flashlight : OsuStrainSkill
     {
-        public Flashlight(Mod[] mods)
+        public Flashlight(Mod[] mods, double preemptTime)
             : base(mods)
         {
+            this.mods = mods;
+            this.preemptTime = preemptTime;
         }
 
-        private double skillMultiplier => 0.15;
+        private double skillMultiplier => 0.12;
         private double strainDecayBase => 0.15;
         protected override double DecayWeight => 1.0;
         protected override int HistoryLength => 10; // Look back for 10 notes is added for the sake of flashlight calculations.
 
+        private Mod[] mods;
+        private bool hidden;
+        private double preemptTime;
+
+        private const double max_opacity_bonus = 0.4;
+
         private double currentStrain;
 
         private double strainValueOf(DifficultyHitObject current)
@@ -31,6 +41,8 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
             if (current.BaseObject is Spinner)
                 return 0;
 
+            hidden = mods.Any(m => m is OsuModHidden);
+
             var osuCurrent = (OsuDifficultyHitObject)current;
             var osuHitObject = (OsuHitObject)(osuCurrent.BaseObject);
 
@@ -58,11 +70,30 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
                     // We also want to nerf stacks so that only the first object of the stack is accounted for.
                     double stackNerf = Math.Min(1.0, (osuPrevious.JumpDistance / scalingFactor) / 25.0);
 
-                    result += Math.Pow(0.8, i) * stackNerf * scalingFactor * jumpDistance / cumulativeStrainTime;
+                    // Bonus based on how visible the object is.
+                    double opacityBonus = 1.0 + max_opacity_bonus * (1.0 - opacity(cumulativeStrainTime, preemptTime, hidden));
+
+                    result += Math.Pow(0.8, i) * stackNerf * opacityBonus * scalingFactor * jumpDistance / cumulativeStrainTime;
                 }
             }
 
-            return Math.Pow(smallDistNerf * result, 2.0);
+            result = Math.Pow(smallDistNerf * result, 2.0);
+
+            if (hidden) {
+                result *= 1.0 + max_opacity_bonus;
+            }
+
+            return result;
+        }
+
+        private double opacity(double ms, double preemptTime, bool hidden) {
+            if (hidden) {
+                return Math.Clamp(Math.Min((1 - ms / preemptTime) * 2.5, (ms / preemptTime) * (1.0 / 0.3)), 0.0, 1.0);
+            }
+            else
+            {
+                return Math.Clamp((1.0 - ms / preemptTime) * 1.5, 0.0, 1.0);
+            }
         }
 
         private double strainDecay(double ms) => Math.Pow(strainDecayBase, ms / 1000);

From 338e5a78b89ca0153d4acc7877b1ce1a6906c698 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 12 Nov 2021 19:30:04 +0900
Subject: [PATCH 0968/5547] Adjust easing of logo to better match the sound

I'm sure we can come up with something better, but giving it a bit more
speed definitely feels closer to what the sound is portraying.
---
 osu.Game/Screens/Play/PlayerLoader.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/Play/PlayerLoader.cs b/osu.Game/Screens/Play/PlayerLoader.cs
index fd54c10d86..ba34df0e59 100644
--- a/osu.Game/Screens/Play/PlayerLoader.cs
+++ b/osu.Game/Screens/Play/PlayerLoader.cs
@@ -270,9 +270,9 @@ namespace osu.Game.Screens.Play
 
             const double duration = 300;
 
-            if (!resuming) logo.MoveTo(new Vector2(0.5f), duration, Easing.In);
+            if (!resuming) logo.MoveTo(new Vector2(0.5f), duration, Easing.OutQuint);
 
-            logo.ScaleTo(new Vector2(0.15f), duration, Easing.In);
+            logo.ScaleTo(new Vector2(0.15f), duration, Easing.OutQuint);
             logo.FadeIn(350);
 
             Scheduler.AddDelayed(() =>

From d2c1bc107218ef2447dd54b10069a11f5c89666e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 12 Nov 2021 19:33:35 +0900
Subject: [PATCH 0969/5547] Update resources

---
 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 752eb160ed..f7b7b6fb23 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -51,7 +51,7 @@
     <Reference Include="Java.Interop" />
   </ItemGroup>
   <ItemGroup>
-    <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1026.0" />
+    <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1112.0" />
     <PackageReference Include="ppy.osu.Framework.Android" Version="2021.1108.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index df3c9b355a..93fb729f46 100644
--- a/osu.Game/osu.Game.csproj
+++ b/osu.Game/osu.Game.csproj
@@ -37,7 +37,7 @@
     </PackageReference>
     <PackageReference Include="Realm" Version="10.6.0" />
     <PackageReference Include="ppy.osu.Framework" Version="2021.1108.0" />
-    <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1026.0" />
+    <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1112.0" />
     <PackageReference Include="Sentry" Version="3.10.0" />
     <PackageReference Include="SharpCompress" Version="0.30.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
diff --git a/osu.iOS.props b/osu.iOS.props
index 1852957e87..3a2a3fd65e 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -71,7 +71,7 @@
   </ItemGroup>
   <ItemGroup Label="Package References">
     <PackageReference Include="ppy.osu.Framework.iOS" Version="2021.1108.0" />
-    <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1026.0" />
+    <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1112.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net5.0 / net6.0) -->
   <PropertyGroup>

From 5a3be778a172405402bdcaadfdfdb7bb04ce190d Mon Sep 17 00:00:00 2001
From: MBmasher <mbmasher@gmail.com>
Date: Fri, 12 Nov 2021 21:41:01 +1100
Subject: [PATCH 0970/5547] Resolve conflicts with recent slider hotfix

---
 .../Difficulty/OsuDifficultyCalculator.cs         | 15 ++++++++++-----
 .../Difficulty/OsuPerformanceCalculator.cs        | 10 ++++++++++
 .../Difficulty/Skills/Flashlight.cs               |  2 +-
 3 files changed, 21 insertions(+), 6 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs b/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs
index 19e92d4365..4e916af813 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs
@@ -35,8 +35,11 @@ namespace osu.Game.Rulesets.Osu.Difficulty
                 return new OsuDifficultyAttributes { Mods = mods, Skills = skills };
 
             double aimRating = Math.Sqrt(skills[0].DifficultyValue()) * difficulty_multiplier;
-            double speedRating = Math.Sqrt(skills[1].DifficultyValue()) * difficulty_multiplier;
-            double flashlightRating = Math.Sqrt(skills[2].DifficultyValue()) * difficulty_multiplier;
+            double aimRatingNoSliders = Math.Sqrt(skills[1].DifficultyValue()) * difficulty_multiplier;
+            double speedRating = Math.Sqrt(skills[2].DifficultyValue()) * difficulty_multiplier;
+            double flashlightRating = Math.Sqrt(skills[3].DifficultyValue()) * difficulty_multiplier;
+
+            double sliderFactor = aimRating > 0 ? aimRatingNoSliders / aimRating : 1;
 
             if (mods.Any(h => h is OsuModRelax))
                 speedRating = 0.0;
@@ -75,6 +78,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty
                 AimStrain = aimRating,
                 SpeedStrain = speedRating,
                 FlashlightRating = flashlightRating,
+                SliderFactor = sliderFactor,
                 ApproachRate = preempt > 1200 ? (1800 - preempt) / 120 : (1200 - preempt) / 150 + 5,
                 OverallDifficulty = (80 - hitWindowGreat) / 6,
                 DrainRate = drainRate,
@@ -111,7 +115,8 @@ namespace osu.Game.Rulesets.Osu.Difficulty
 
             return new Skill[]
             {
-                new Aim(mods),
+                new Aim(mods, true),
+                new Aim(mods, false),
                 new Speed(mods, hitWindowGreat),
                 new Flashlight(mods, preempt)
             };
@@ -124,7 +129,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty
             new OsuModEasy(),
             new OsuModHardRock(),
             new OsuModFlashlight(),
-            new OsuModHidden(),
+            new OsuModHidden()
         };
     }
-}
+}
\ No newline at end of file
diff --git a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
index 817b0b63a8..f4c451f80b 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
@@ -125,6 +125,16 @@ namespace osu.Game.Rulesets.Osu.Difficulty
                 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;
+
+            if (Attributes.SliderCount > 0)
+            {
+                double estimateSliderEndsDropped = Math.Clamp(Math.Min(countOk + countMeh + countMiss, Attributes.MaxCombo - scoreMaxCombo), 0, estimateDifficultSliders);
+                double sliderNerfFactor = (1 - Attributes.SliderFactor) * Math.Pow(1 - estimateSliderEndsDropped / estimateDifficultSliders, 3) + Attributes.SliderFactor;
+                aimValue *= sliderNerfFactor;
+            }
+
             aimValue *= accuracy;
             // It is important to also consider accuracy difficulty when doing that.
             aimValue *= 0.98 + Math.Pow(Attributes.OverallDifficulty, 2) / 2500;
diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
index 55ef8db129..e0d2a084bd 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.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;

From efac11e886f887673b36d5d42d840bc85ead9688 Mon Sep 17 00:00:00 2001
From: MBmasher <mbmasher@gmail.com>
Date: Fri, 12 Nov 2021 21:42:27 +1100
Subject: [PATCH 0971/5547] Add extra bonus for hidden+flashlight

---
 osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
index e0d2a084bd..caae53516d 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
@@ -23,7 +23,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
             this.preemptTime = preemptTime;
         }
 
-        private double skillMultiplier => 0.12;
+        private double skillMultiplier => 0.11;
         private double strainDecayBase => 0.15;
         protected override double DecayWeight => 1.0;
         protected override int HistoryLength => 10; // Look back for 10 notes is added for the sake of flashlight calculations.
@@ -33,6 +33,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
         private double preemptTime;
 
         private const double max_opacity_bonus = 0.4;
+        private const double hidden_bonus = 0.3;
 
         private double currentStrain;
 
@@ -81,6 +82,8 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
 
             if (hidden) {
                 result *= 1.0 + max_opacity_bonus;
+                // Additional bonus for Hidden due to there being no approach circles.
+                result *= 1.0 + hidden_bonus;
             }
 
             return result;

From 9000d19c9eedca47292e4f283fdd0ab48a8dd9f3 Mon Sep 17 00:00:00 2001
From: Leon Gebler <leon.gebler@gebler-online.de>
Date: Fri, 12 Nov 2021 14:58:18 +0100
Subject: [PATCH 0972/5547] Update difficulty colour spectrum

---
 osu.Game/Graphics/OsuColour.cs | 17 ++++++++++-------
 1 file changed, 10 insertions(+), 7 deletions(-)

diff --git a/osu.Game/Graphics/OsuColour.cs b/osu.Game/Graphics/OsuColour.cs
index 3aa4dbf1d8..d3afb21933 100644
--- a/osu.Game/Graphics/OsuColour.cs
+++ b/osu.Game/Graphics/OsuColour.cs
@@ -52,15 +52,18 @@ namespace osu.Game.Graphics
 
         public Color4 ForStarDifficulty(double starDifficulty) => ColourUtils.SampleFromLinearGradient(new[]
         {
-            (1.5f, Color4Extensions.FromHex("4fc0ff")),
+            (0.1f, Color4Extensions.FromHex("aaaaaa")),
+            (0.1f, Color4Extensions.FromHex("4290fb")),
+            (1.25f, Color4Extensions.FromHex("4fc0ff")),
             (2.0f, Color4Extensions.FromHex("4fffd5")),
             (2.5f, Color4Extensions.FromHex("7cff4f")),
-            (3.25f, Color4Extensions.FromHex("f6f05c")),
-            (4.5f, Color4Extensions.FromHex("ff8068")),
-            (6.0f, Color4Extensions.FromHex("ff3c71")),
-            (7.0f, Color4Extensions.FromHex("6563de")),
-            (8.0f, Color4Extensions.FromHex("18158e")),
-            (8.0f, Color4.Black),
+            (3.3f, Color4Extensions.FromHex("f6f05c")),
+            (4.2f, Color4Extensions.FromHex("ff8068")),
+            (4.9f, Color4Extensions.FromHex("ff4e6f")),
+            (5.8f, Color4Extensions.FromHex("c645b8")),
+            (6.7f, Color4Extensions.FromHex("6563de")),
+            (7.7f, Color4Extensions.FromHex("18158e")),
+            (9.0f, Color4.Black),
         }, (float)Math.Round(starDifficulty, 2, MidpointRounding.AwayFromZero));
 
         /// <summary>

From 25202316cc62074b352eece649b50d29e02e1520 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Sat, 13 Nov 2021 00:22:48 +0900
Subject: [PATCH 0973/5547] Add user id to APIPlaylistItem

---
 osu.Game/Online/Rooms/APIPlaylistItem.cs | 13 ++++++++-----
 1 file changed, 8 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Online/Rooms/APIPlaylistItem.cs b/osu.Game/Online/Rooms/APIPlaylistItem.cs
index e9803a3a10..eddce69976 100644
--- a/osu.Game/Online/Rooms/APIPlaylistItem.cs
+++ b/osu.Game/Online/Rooms/APIPlaylistItem.cs
@@ -19,21 +19,24 @@ namespace osu.Game.Online.Rooms
         public long ID { get; set; }
 
         [Key(1)]
-        public int BeatmapID { get; set; }
+        public int UserID { get; set; }
 
         [Key(2)]
-        public string BeatmapChecksum { get; set; } = string.Empty;
+        public int BeatmapID { get; set; }
 
         [Key(3)]
-        public int RulesetID { get; set; }
+        public string BeatmapChecksum { get; set; } = string.Empty;
 
         [Key(4)]
-        public IEnumerable<APIMod> RequiredMods { get; set; } = Enumerable.Empty<APIMod>();
+        public int RulesetID { get; set; }
 
         [Key(5)]
-        public IEnumerable<APIMod> AllowedMods { get; set; } = Enumerable.Empty<APIMod>();
+        public IEnumerable<APIMod> RequiredMods { get; set; } = Enumerable.Empty<APIMod>();
 
         [Key(6)]
+        public IEnumerable<APIMod> AllowedMods { get; set; } = Enumerable.Empty<APIMod>();
+
+        [Key(7)]
         public bool Expired { get; set; }
 
         public APIPlaylistItem()

From 867403d94737cd85479199d44038231e19d95fad Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Sat, 13 Nov 2021 01:42:51 +0900
Subject: [PATCH 0974/5547] Update TestMultiplayerClient to be more in line
 with server

---
 .../Multiplayer/TestMultiplayerClient.cs      | 132 +++++++++++-------
 1 file changed, 79 insertions(+), 53 deletions(-)

diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
index 8f7e6d7f5c..7520740eb6 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
@@ -42,6 +42,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         private BeatmapManager beatmaps { get; set; } = null!;
 
         private readonly TestMultiplayerRoomManager roomManager;
+        private PlaylistItem? currentItem;
 
         public TestMultiplayerClient(TestMultiplayerRoomManager roomManager)
         {
@@ -138,7 +139,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
                             ((IMultiplayerClient)this).ResultsReady();
 
-                            finishPlaylistItem().ContinueWith(_ => advanceToNextPlaylistItem());
+                            Task.Run(finishCurrentItem);
                         }
 
                         break;
@@ -153,7 +154,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             ((IMultiplayerClient)this).UserBeatmapAvailabilityChanged(userId, newBeatmapAvailability);
         }
 
-        protected override Task<MultiplayerRoom> JoinRoom(long roomId, string? password = null)
+        protected override async Task<MultiplayerRoom> JoinRoom(long roomId, string? password = null)
         {
             var apiRoom = roomManager.ServerSideRooms.Single(r => r.RoomID.Value == roomId);
 
@@ -165,13 +166,16 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 User = api.LocalUser.Value
             };
 
+            await updateCurrentItem(apiRoom: apiRoom).ConfigureAwait(false);
+            Debug.Assert(currentItem != null);
+
             var room = new MultiplayerRoom(roomId)
             {
                 Settings =
                 {
                     Name = apiRoom.Name.Value,
                     MatchType = apiRoom.Type.Value,
-                    PlaylistItemId = apiRoom.Playlist.Single().ID,
+                    PlaylistItemId = currentItem.ID,
                     Password = password,
                     QueueMode = apiRoom.QueueMode.Value
                 },
@@ -182,7 +186,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             RoomSetupAction?.Invoke(room);
             RoomSetupAction = null;
 
-            return Task.FromResult(room);
+            return room;
         }
 
         protected override void OnRoomJoined()
@@ -208,11 +212,19 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             Debug.Assert(Room != null);
             Debug.Assert(APIRoom != null);
+            Debug.Assert(currentItem != null);
 
             // Server is authoritative for the time being.
             settings.PlaylistItemId = Room.Settings.PlaylistItemId;
 
-            await changeSettings(settings).ConfigureAwait(false);
+            await changeQueueMode(settings.QueueMode).ConfigureAwait(false);
+
+            await ((IMultiplayerClient)this).SettingsChanged(settings).ConfigureAwait(false);
+
+            foreach (var user in Room.Users.Where(u => u.State == MultiplayerUserState.Ready))
+                ChangeUserState(user.UserID, MultiplayerUserState.Idle);
+
+            await changeMatchType(settings.MatchType).ConfigureAwait(false);
         }
 
         public override Task ChangeState(MultiplayerUserState newState)
@@ -282,17 +294,28 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             Debug.Assert(Room != null);
             Debug.Assert(APIRoom != null);
+            Debug.Assert(currentItem != null);
 
-            if (Room.Settings.QueueMode == QueueModes.HostOnly && APIRoom.Playlist.Count > 0)
+            if (Room.Settings.QueueMode == QueueModes.HostOnly && Room.Host?.UserID != LocalUser?.UserID)
+                throw new InvalidOperationException("Local user is not the room host.");
+
+            switch (Room.Settings.QueueMode)
             {
-                if (Room.Host?.UserID != LocalUser?.UserID)
-                    throw new InvalidOperationException("Local user is not the room host.");
+                case QueueModes.HostOnly:
+                    // In host-only mode, the current item is re-used.
+                    item.ID = currentItem.ID;
+                    await ((IMultiplayerClient)this).PlaylistItemChanged(item).ConfigureAwait(false);
 
-                item.ID = APIRoom.Playlist.Last().ID;
-                await ((IMultiplayerClient)this).PlaylistItemChanged(item).ConfigureAwait(false);
+                    // Note: Unlike the server, this is the easiest way to update the current item at this point.
+                    await updateCurrentItem(false).ConfigureAwait(false);
+                    break;
+
+                default:
+                    item.ID = APIRoom.Playlist.Last().ID + 1;
+                    await ((IMultiplayerClient)this).PlaylistItemAdded(item).ConfigureAwait(false);
+                    await updateCurrentItem().ConfigureAwait(false);
+                    break;
             }
-            else
-                await addPlaylistItem(item).ConfigureAwait(false);
         }
 
         public override Task RemovePlaylistItem(long playlistItemId)
@@ -325,28 +348,6 @@ namespace osu.Game.Tests.Visual.Multiplayer
             return Task.FromResult(apiSet);
         }
 
-        private async Task changeSettings(MultiplayerRoomSettings settings)
-        {
-            Debug.Assert(Room != null);
-            Debug.Assert(APIRoom != null);
-
-            if (settings.QueueMode == QueueModes.HostOnly)
-            {
-                foreach (var playlistItem in APIRoom.Playlist.Where(i => !i.Expired && i.ID != Room.Settings.PlaylistItemId).ToArray())
-                {
-                    APIRoom.Playlist.Remove(playlistItem);
-                    await ((IMultiplayerClient)this).PlaylistItemRemoved(playlistItem.ID).ConfigureAwait(false);
-                }
-            }
-
-            await ((IMultiplayerClient)this).SettingsChanged(settings).ConfigureAwait(false);
-
-            foreach (var user in Room.Users.Where(u => u.State == MultiplayerUserState.Ready))
-                ChangeUserState(user.UserID, MultiplayerUserState.Idle);
-
-            await changeMatchType(settings.MatchType).ConfigureAwait(false);
-        }
-
         private async Task changeMatchType(MatchType type)
         {
             Debug.Assert(Room != null);
@@ -369,47 +370,69 @@ namespace osu.Game.Tests.Visual.Multiplayer
             }
         }
 
-        private async Task addPlaylistItem(APIPlaylistItem newItem)
+        private async Task changeQueueMode(QueueModes newMode)
         {
-            Debug.Assert(Room != null);
             Debug.Assert(APIRoom != null);
+            Debug.Assert(currentItem != null);
 
-            newItem.ID = (APIRoom.Playlist.LastOrDefault()?.ID ?? 0) + 1;
-            await ((IMultiplayerClient)this).PlaylistItemAdded(newItem).ConfigureAwait(false);
+            if (newMode == QueueModes.HostOnly)
+            {
+                foreach (var playlistItem in APIRoom.Playlist.Where(i => !i.Expired && i.ID != currentItem.ID).ToArray())
+                    await ((IMultiplayerClient)this).PlaylistItemRemoved(playlistItem.ID).ConfigureAwait(false);
+            }
 
-            // A more valid selection can occur as a result of adding a new playlist item (e.g. if all previous items were expired).
-            await advanceToNextPlaylistItem().ConfigureAwait(false);
+            // When changing modes, items could have been added (above) or the queueing order could have changed.
+            await updateCurrentItem().ConfigureAwait(false);
         }
 
-        private async Task finishPlaylistItem()
+        private async Task finishCurrentItem()
         {
             Debug.Assert(Room != null);
             Debug.Assert(APIRoom != null);
-
-            var currentItem = APIRoom.Playlist.Single(i => i.ID == Room.Settings.PlaylistItemId);
+            Debug.Assert(currentItem != null);
 
             // Expire the current playlist item.
             await ((IMultiplayerClient)this).PlaylistItemChanged(new APIPlaylistItem(currentItem) { Expired = true }).ConfigureAwait(false);
 
             // In host-only mode, a duplicate playlist item will be used for the next round.
             if (Room.Settings.QueueMode == QueueModes.HostOnly)
-                await addPlaylistItem(new APIPlaylistItem(currentItem)).ConfigureAwait(false);
+                await duplicateCurrentItem().ConfigureAwait(false);
+
+            await updateCurrentItem().ConfigureAwait(false);
         }
 
-        private async Task advanceToNextPlaylistItem()
+        private async Task duplicateCurrentItem()
         {
             Debug.Assert(Room != null);
             Debug.Assert(APIRoom != null);
+            Debug.Assert(currentItem != null);
 
-            long nextId;
+            var newItem = new PlaylistItem
+            {
+                ID = APIRoom.Playlist.Last().ID + 1,
+                BeatmapID = currentItem.BeatmapID,
+                RulesetID = currentItem.RulesetID,
+            };
 
-            switch (Room.Settings.QueueMode)
+            newItem.AllowedMods.AddRange(currentItem.AllowedMods);
+            newItem.RequiredMods.AddRange(currentItem.AllowedMods);
+
+            await ((IMultiplayerClient)this).PlaylistItemAdded(new APIPlaylistItem(newItem)).ConfigureAwait(false);
+        }
+
+        private async Task updateCurrentItem(bool notify = true, Room? apiRoom = null)
+        {
+            if (apiRoom == null)
+            {
+                Debug.Assert(APIRoom != null);
+                apiRoom = APIRoom;
+            }
+
+            switch (apiRoom.QueueMode.Value)
             {
                 default:
                     // Pick the single non-expired playlist item.
-                    nextId = APIRoom.Playlist.FirstOrDefault(i => !i.Expired)?.ID
-                             ?? APIRoom.Playlist.LastOrDefault()?.ID
-                             ?? 0;
+                    currentItem = apiRoom.Playlist.FirstOrDefault(i => !i.Expired) ?? apiRoom.Playlist.Last();
                     break;
 
                 case QueueModes.FairRotate:
@@ -417,10 +440,13 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     throw new NotImplementedException();
             }
 
-            if (nextId != Room.Settings.PlaylistItemId)
+            if (Room != null)
             {
-                Room.Settings.PlaylistItemId = nextId;
-                await changeSettings(Room.Settings).ConfigureAwait(false);
+                long lastItem = Room.Settings.PlaylistItemId;
+                Room.Settings.PlaylistItemId = currentItem.ID;
+
+                if (notify && currentItem.ID != lastItem)
+                    await ((IMultiplayerClient)this).SettingsChanged(Room.Settings).ConfigureAwait(false);
             }
         }
     }

From 060b4fa5266a9cd1e334111d968036141e379cd8 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Sat, 13 Nov 2021 01:53:19 +0900
Subject: [PATCH 0975/5547] Fix failing multiplayer player test

---
 .../Visual/Multiplayer/TestSceneMultiplayerPlayer.cs         | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlayer.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlayer.cs
index a1543f99e1..5708b2f789 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlayer.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlayer.cs
@@ -3,7 +3,9 @@
 
 using System.Linq;
 using NUnit.Framework;
+using osu.Framework.Screens;
 using osu.Framework.Testing;
+using osu.Game.Online.Multiplayer;
 using osu.Game.Rulesets.Osu;
 using osu.Game.Screens.OnlinePlay.Multiplayer;
 
@@ -27,6 +29,9 @@ namespace osu.Game.Tests.Visual.Multiplayer
             {
                 Stack.Push(player = new MultiplayerPlayer(Client.APIRoom, Client.CurrentMatchPlayingItem.Value, Client.Room?.Users.ToArray()));
             });
+
+            AddUntilStep("wait for player to be current", () => player.IsCurrentScreen() && player.IsLoaded);
+            AddStep("start gameplay", () => ((IMultiplayerClient)Client).MatchStarted());
         }
 
         [Test]

From 6fb2ccbb860513a17b84f99099e4bf1a7270a97d Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Sat, 13 Nov 2021 01:53:58 +0900
Subject: [PATCH 0976/5547] Add failing test ensuring room is updated after
 join

---
 .../Multiplayer/TestSceneMultiplayer.cs       | 50 +++++++++++++++++++
 1 file changed, 50 insertions(+)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
index e831d5b564..66c639ed62 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
@@ -19,11 +19,13 @@ using osu.Game.Database;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Multiplayer;
+using osu.Game.Online.Multiplayer.Queueing;
 using osu.Game.Online.Rooms;
 using osu.Game.Overlays.Mods;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Osu.Mods;
+using osu.Game.Screens.OnlinePlay.Components;
 using osu.Game.Screens.OnlinePlay.Lounge;
 using osu.Game.Screens.OnlinePlay.Lounge.Components;
 using osu.Game.Screens.OnlinePlay.Match;
@@ -579,6 +581,54 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddUntilStep("wait for results", () => multiplayerScreenStack.CurrentScreen is ResultsScreen);
         }
 
+        [Test]
+        public void TestRoomSettingsReQueriedWhenJoiningRoom()
+        {
+            AddStep("create room", () =>
+            {
+                roomManager.AddServerSideRoom(new Room
+                {
+                    Name = { Value = "Test Room" },
+                    QueueMode = { Value = QueueModes.FreeForAll },
+                    Playlist =
+                    {
+                        new PlaylistItem
+                        {
+                            Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.RulesetID == 0)).BeatmapInfo },
+                            Ruleset = { Value = new OsuRuleset().RulesetInfo },
+                        }
+                    }
+                });
+            });
+
+            AddStep("refresh rooms", () => this.ChildrenOfType<LoungeSubScreen>().Single().UpdateFilter());
+            AddUntilStep("wait for room", () => this.ChildrenOfType<DrawableRoom>().Any());
+            AddStep("select room", () => InputManager.Key(Key.Down));
+
+            AddStep("disable polling", () => this.ChildrenOfType<ListingPollingComponent>().Single().TimeBetweenPolls.Value = 0);
+            AddStep("change server-side settings", () =>
+            {
+                roomManager.ServerSideRooms[0].Name.Value = "New name";
+                roomManager.ServerSideRooms[0].Playlist.Add(new PlaylistItem
+                {
+                    ID = 2,
+                    Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.RulesetID == 0)).BeatmapInfo },
+                    Ruleset = { Value = new OsuRuleset().RulesetInfo },
+                });
+            });
+
+            AddStep("join room", () => InputManager.Key(Key.Enter));
+            AddUntilStep("wait for room open", () => this.ChildrenOfType<MultiplayerMatchSubScreen>().FirstOrDefault()?.IsLoaded == true);
+            AddUntilStep("wait for join", () => client.Room != null);
+
+            AddAssert("local room has correct settings", () =>
+            {
+                var localRoom = this.ChildrenOfType<MultiplayerMatchSubScreen>().Single().Room;
+                return localRoom.Name.Value == roomManager.ServerSideRooms[0].Name.Value
+                       && localRoom.Playlist.SequenceEqual(roomManager.ServerSideRooms[0].Playlist);
+            });
+        }
+
         private MultiplayerReadyButton readyButton => this.ChildrenOfType<MultiplayerReadyButton>().Single();
 
         private void createRoom(Func<Room> room)

From e31d7e8ad72321b9885c30d268e73b0a44d6beaa Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Sat, 13 Nov 2021 02:32:20 +0900
Subject: [PATCH 0977/5547] Fix new failing test

---
 osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
index 7520740eb6..fc6f8189e3 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
@@ -191,10 +191,17 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
         protected override void OnRoomJoined()
         {
+            Debug.Assert(APIRoom != null);
             Debug.Assert(Room != null);
 
             // emulate the server sending this after the join room. scheduler required to make sure the join room event is fired first (in Join).
             changeMatchType(Room.Settings.MatchType).Wait();
+
+            // emulate the server sending all playlist items after room join.
+            var serverSideRom = roomManager.ServerSideRooms.Single(r => r.RoomID.Value == APIRoom.RoomID.Value);
+
+            foreach (var playlistItem in serverSideRom.Playlist)
+                ((IMultiplayerClient)this).PlaylistItemAdded(new APIPlaylistItem(playlistItem)).Wait();
         }
 
         protected override Task LeaveRoomInternal() => Task.CompletedTask;

From dbc23e224f08a528c7f84de85495e6fc61567873 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Sat, 13 Nov 2021 03:34:45 +0900
Subject: [PATCH 0978/5547] Fix further test failures

---
 .../Online/Multiplayer/MultiplayerClient.cs   | 20 +++++++---
 .../Multiplayer/TestMultiplayerClient.cs      | 37 +++++++++++--------
 2 files changed, 35 insertions(+), 22 deletions(-)

diff --git a/osu.Game/Online/Multiplayer/MultiplayerClient.cs b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
index cf61b83e08..43c1148ba9 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
@@ -442,7 +442,12 @@ namespace osu.Game.Online.Multiplayer
             return Task.CompletedTask;
         }
 
-        Task IMultiplayerClient.SettingsChanged(MultiplayerRoomSettings newSettings) => updateLocalRoomSettings(newSettings);
+        Task IMultiplayerClient.SettingsChanged(MultiplayerRoomSettings newSettings)
+        {
+            // Do not return this task, as it will cause tests to deadlock.
+            updateLocalRoomSettings(newSettings);
+            return Task.CompletedTask;
+        }
 
         Task IMultiplayerClient.UserStateChanged(int userId, MultiplayerUserState state)
         {
@@ -601,16 +606,17 @@ namespace osu.Game.Online.Multiplayer
 
             var playlistItem = await createPlaylistItem(item).ConfigureAwait(false);
 
-            await scheduleAsync(() =>
+            Scheduler.Add(() =>
             {
                 if (Room == null)
                     return;
 
                 Debug.Assert(APIRoom != null);
 
+                APIRoom.Playlist.RemoveAll(i => i.ID == playlistItem.ID);
                 APIRoom.Playlist.Add(playlistItem);
                 RoomUpdated?.Invoke();
-            }).ConfigureAwait(false);
+            });
         }
 
         public Task PlaylistItemRemoved(long playlistItemId)
@@ -618,7 +624,7 @@ namespace osu.Game.Online.Multiplayer
             if (Room == null)
                 return Task.CompletedTask;
 
-            return scheduleAsync(() =>
+            Scheduler.Add(() =>
             {
                 if (Room == null)
                     return;
@@ -628,6 +634,8 @@ namespace osu.Game.Online.Multiplayer
                 APIRoom.Playlist.RemoveAll(i => i.ID == playlistItemId);
                 RoomUpdated?.Invoke();
             });
+
+            return Task.CompletedTask;
         }
 
         public async Task PlaylistItemChanged(APIPlaylistItem item)
@@ -637,7 +645,7 @@ namespace osu.Game.Online.Multiplayer
 
             var playlistItem = await createPlaylistItem(item).ConfigureAwait(false);
 
-            await scheduleAsync(() =>
+            Scheduler.Add(() =>
             {
                 if (Room == null)
                     return;
@@ -658,7 +666,7 @@ namespace osu.Game.Online.Multiplayer
                     CurrentMatchPlayingItem.Value = APIRoom.Playlist[index];
 
                 RoomUpdated?.Invoke();
-            }).ConfigureAwait(false);
+            });
         }
 
         /// <summary>
diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
index fc6f8189e3..5c779336ae 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
@@ -41,8 +41,9 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [Resolved]
         private BeatmapManager beatmaps { get; set; } = null!;
 
+        private readonly List<APIPlaylistItem> playlistItems = new List<APIPlaylistItem>();
         private readonly TestMultiplayerRoomManager roomManager;
-        private PlaylistItem? currentItem;
+        private APIPlaylistItem? currentItem;
 
         public TestMultiplayerClient(TestMultiplayerRoomManager roomManager)
         {
@@ -139,7 +140,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
                             ((IMultiplayerClient)this).ResultsReady();
 
-                            Task.Run(finishCurrentItem);
+                            finishCurrentItem().Wait();
                         }
 
                         break;
@@ -161,6 +162,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
             if (password != apiRoom.Password.Value)
                 throw new InvalidOperationException("Invalid password.");
 
+            playlistItems.AddRange(apiRoom.Playlist.Select(i => new APIPlaylistItem(i)));
+
             var localUser = new MultiplayerRoomUser(api.LocalUser.Value.Id)
             {
                 User = api.LocalUser.Value
@@ -198,10 +201,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
             changeMatchType(Room.Settings.MatchType).Wait();
 
             // emulate the server sending all playlist items after room join.
-            var serverSideRom = roomManager.ServerSideRooms.Single(r => r.RoomID.Value == APIRoom.RoomID.Value);
-
-            foreach (var playlistItem in serverSideRom.Playlist)
-                ((IMultiplayerClient)this).PlaylistItemAdded(new APIPlaylistItem(playlistItem)).Wait();
+            var serverSideRoom = roomManager.ServerSideRooms.Single(r => r.RoomID.Value == APIRoom.RoomID.Value);
+            Task.WhenAll(serverSideRoom.Playlist.Select(i => ((IMultiplayerClient)this).PlaylistItemAdded(new APIPlaylistItem(i)))).Wait();
         }
 
         protected override Task LeaveRoomInternal() => Task.CompletedTask;
@@ -311,6 +312,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 case QueueModes.HostOnly:
                     // In host-only mode, the current item is re-used.
                     item.ID = currentItem.ID;
+                    playlistItems[playlistItems.FindIndex(i => i == currentItem)] = item;
                     await ((IMultiplayerClient)this).PlaylistItemChanged(item).ConfigureAwait(false);
 
                     // Note: Unlike the server, this is the easiest way to update the current item at this point.
@@ -318,7 +320,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     break;
 
                 default:
-                    item.ID = APIRoom.Playlist.Last().ID + 1;
+                    item.ID = playlistItems.Last().ID + 1;
+                    playlistItems.Add(item);
                     await ((IMultiplayerClient)this).PlaylistItemAdded(item).ConfigureAwait(false);
                     await updateCurrentItem().ConfigureAwait(false);
                     break;
@@ -384,7 +387,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             if (newMode == QueueModes.HostOnly)
             {
-                foreach (var playlistItem in APIRoom.Playlist.Where(i => !i.Expired && i.ID != currentItem.ID).ToArray())
+                foreach (var playlistItem in playlistItems.Where(i => !i.Expired && i.ID != currentItem.ID).ToArray())
                     await ((IMultiplayerClient)this).PlaylistItemRemoved(playlistItem.ID).ConfigureAwait(false);
             }
 
@@ -399,7 +402,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
             Debug.Assert(currentItem != null);
 
             // Expire the current playlist item.
-            await ((IMultiplayerClient)this).PlaylistItemChanged(new APIPlaylistItem(currentItem) { Expired = true }).ConfigureAwait(false);
+            currentItem.Expired = true;
+            await ((IMultiplayerClient)this).PlaylistItemChanged(currentItem).ConfigureAwait(false);
 
             // In host-only mode, a duplicate playlist item will be used for the next round.
             if (Room.Settings.QueueMode == QueueModes.HostOnly)
@@ -414,17 +418,18 @@ namespace osu.Game.Tests.Visual.Multiplayer
             Debug.Assert(APIRoom != null);
             Debug.Assert(currentItem != null);
 
-            var newItem = new PlaylistItem
+            var newItem = new APIPlaylistItem
             {
-                ID = APIRoom.Playlist.Last().ID + 1,
+                ID = playlistItems.Last().ID + 1,
                 BeatmapID = currentItem.BeatmapID,
+                BeatmapChecksum = currentItem.BeatmapChecksum,
                 RulesetID = currentItem.RulesetID,
+                RequiredMods = currentItem.RequiredMods,
+                AllowedMods = currentItem.AllowedMods
             };
 
-            newItem.AllowedMods.AddRange(currentItem.AllowedMods);
-            newItem.RequiredMods.AddRange(currentItem.AllowedMods);
-
-            await ((IMultiplayerClient)this).PlaylistItemAdded(new APIPlaylistItem(newItem)).ConfigureAwait(false);
+            playlistItems.Add(newItem);
+            await ((IMultiplayerClient)this).PlaylistItemAdded(newItem).ConfigureAwait(false);
         }
 
         private async Task updateCurrentItem(bool notify = true, Room? apiRoom = null)
@@ -439,7 +444,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             {
                 default:
                     // Pick the single non-expired playlist item.
-                    currentItem = apiRoom.Playlist.FirstOrDefault(i => !i.Expired) ?? apiRoom.Playlist.Last();
+                    currentItem = playlistItems.FirstOrDefault(i => !i.Expired) ?? playlistItems.Last();
                     break;
 
                 case QueueModes.FairRotate:

From 4aaf412ac9a3735034dfdfae9dbeb9714c9375ad Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Sat, 13 Nov 2021 03:35:41 +0900
Subject: [PATCH 0979/5547] Ensure one non-expired item when switching to
 host-only

---
 osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
index 5c779336ae..a4175defa2 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
@@ -387,8 +387,13 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             if (newMode == QueueModes.HostOnly)
             {
+                // Remove all but the current and expired items. The current item may be re-used for host-only mode if it's non-expired.
                 foreach (var playlistItem in playlistItems.Where(i => !i.Expired && i.ID != currentItem.ID).ToArray())
                     await ((IMultiplayerClient)this).PlaylistItemRemoved(playlistItem.ID).ConfigureAwait(false);
+
+                // Always ensure that at least one non-expired item exists by duplicating the current item if required.
+                if (currentItem.Expired)
+                    await duplicateCurrentItem().ConfigureAwait(false);
             }
 
             // When changing modes, items could have been added (above) or the queueing order could have changed.

From cb2d1f3f04ae864b330bd2470e5769bb6839536b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 12 Nov 2021 20:28:42 +0100
Subject: [PATCH 0980/5547] Use horizontally symmetrical padding rather than
 margin

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

diff --git a/osu.Game/Overlays/Settings/SettingsHeader.cs b/osu.Game/Overlays/Settings/SettingsHeader.cs
index 53b3895390..f9ee8df0bd 100644
--- a/osu.Game/Overlays/Settings/SettingsHeader.cs
+++ b/osu.Game/Overlays/Settings/SettingsHeader.cs
@@ -33,9 +33,9 @@ namespace osu.Game.Overlays.Settings
                 {
                     AutoSizeAxes = Axes.Y,
                     RelativeSizeAxes = Axes.X,
-                    Margin = new MarginPadding
+                    Padding = new MarginPadding
                     {
-                        Left = SettingsPanel.CONTENT_MARGINS,
+                        Horizontal = SettingsPanel.CONTENT_MARGINS,
                         Top = Toolbar.Toolbar.TOOLTIP_HEIGHT,
                         Bottom = 30
                     }

From ce47f456ec4a8f61b5c9842c6334e344fe172164 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Sat, 13 Nov 2021 04:42:14 +0900
Subject: [PATCH 0981/5547] Change API for retrieving playlist items on join

---
 osu.Game/Online/Multiplayer/IMultiplayerRoomServer.cs  |  5 +++++
 osu.Game/Online/Multiplayer/MultiplayerClient.cs       |  4 ++++
 osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs |  9 +++++++++
 .../Tests/Visual/Multiplayer/TestMultiplayerClient.cs  | 10 ++++++----
 4 files changed, 24 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Online/Multiplayer/IMultiplayerRoomServer.cs b/osu.Game/Online/Multiplayer/IMultiplayerRoomServer.cs
index d6ff4f4993..d00022d6f5 100644
--- a/osu.Game/Online/Multiplayer/IMultiplayerRoomServer.cs
+++ b/osu.Game/Online/Multiplayer/IMultiplayerRoomServer.cs
@@ -77,6 +77,11 @@ namespace osu.Game.Online.Multiplayer
         /// <exception cref="InvalidStateException">If an attempt to start the game occurs when the game's (or users') state disallows it.</exception>
         Task StartMatch();
 
+        /// <summary>
+        /// Requests for all playlist items of the room to be sent to the client.
+        /// </summary>
+        Task RequestAllPlaylistItems();
+
         /// <summary>
         /// Adds an item to the playlist.
         /// </summary>
diff --git a/osu.Game/Online/Multiplayer/MultiplayerClient.cs b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
index 43c1148ba9..638eb30ee9 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
@@ -158,6 +158,8 @@ namespace osu.Game.Online.Multiplayer
                     OnRoomJoined();
                 }, cancellationSource.Token).ConfigureAwait(false);
 
+                await RequestAllPlaylistItems().ConfigureAwait(false);
+
                 // Update room settings.
                 await updateLocalRoomSettings(joinedRoom.Settings, cancellationSource.Token).ConfigureAwait(false);
             }, cancellationSource.Token).ConfigureAwait(false);
@@ -305,6 +307,8 @@ namespace osu.Game.Online.Multiplayer
 
         public abstract Task StartMatch();
 
+        public abstract Task RequestAllPlaylistItems();
+
         public abstract Task AddPlaylistItem(APIPlaylistItem item);
 
         public abstract Task RemovePlaylistItem(long playlistItemId);
diff --git a/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs b/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs
index 2f0e1623e7..c7a751500e 100644
--- a/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs
@@ -3,6 +3,7 @@
 
 #nullable enable
 
+using System;
 using System.Collections.Generic;
 using System.Threading;
 using System.Threading.Tasks;
@@ -151,6 +152,14 @@ namespace osu.Game.Online.Multiplayer
             return connection.InvokeAsync(nameof(IMultiplayerServer.StartMatch));
         }
 
+        public override Task RequestAllPlaylistItems()
+        {
+            if (!IsConnected.Value)
+                return Task.FromResult(Array.Empty<APIPlaylistItem>());
+
+            return connection.InvokeAsync<APIPlaylistItem[]>(nameof(IMultiplayerServer.RequestAllPlaylistItems));
+        }
+
         public override Task AddPlaylistItem(APIPlaylistItem item)
         {
             if (!IsConnected.Value)
diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
index a4175defa2..dc871de3f5 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
@@ -199,10 +199,6 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             // emulate the server sending this after the join room. scheduler required to make sure the join room event is fired first (in Join).
             changeMatchType(Room.Settings.MatchType).Wait();
-
-            // emulate the server sending all playlist items after room join.
-            var serverSideRoom = roomManager.ServerSideRooms.Single(r => r.RoomID.Value == APIRoom.RoomID.Value);
-            Task.WhenAll(serverSideRoom.Playlist.Select(i => ((IMultiplayerClient)this).PlaylistItemAdded(new APIPlaylistItem(i)))).Wait();
         }
 
         protected override Task LeaveRoomInternal() => Task.CompletedTask;
@@ -298,6 +294,12 @@ namespace osu.Game.Tests.Visual.Multiplayer
             return ((IMultiplayerClient)this).LoadRequested();
         }
 
+        public override async Task RequestAllPlaylistItems()
+        {
+            foreach (var item in playlistItems)
+                await ((IMultiplayerClient)this).PlaylistItemAdded(item).ConfigureAwait(false);
+        }
+
         public override async Task AddPlaylistItem(APIPlaylistItem item)
         {
             Debug.Assert(Room != null);

From 7ba93aac2799be99595ef4d49db3266c60b15d28 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 12 Nov 2021 21:36:03 +0100
Subject: [PATCH 0982/5547] Add test coverage for difficulty point piece
 operation

---
 ...ceneHitObjectDifficultyPointAdjustments.cs | 123 ++++++++++++++++++
 .../Timeline/DifficultyPointPiece.cs          |   6 +-
 2 files changed, 126 insertions(+), 3 deletions(-)
 create mode 100644 osu.Game.Tests/Visual/Editing/TestSceneHitObjectDifficultyPointAdjustments.cs

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneHitObjectDifficultyPointAdjustments.cs b/osu.Game.Tests/Visual/Editing/TestSceneHitObjectDifficultyPointAdjustments.cs
new file mode 100644
index 0000000000..bbae10e5ff
--- /dev/null
+++ b/osu.Game.Tests/Visual/Editing/TestSceneHitObjectDifficultyPointAdjustments.cs
@@ -0,0 +1,123 @@
+// 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 Humanizer;
+using NUnit.Framework;
+using osu.Framework.Testing;
+using osu.Game.Beatmaps;
+using osu.Game.Beatmaps.ControlPoints;
+using osu.Game.Rulesets;
+using osu.Game.Rulesets.Objects;
+using osu.Game.Rulesets.Osu;
+using osu.Game.Rulesets.Osu.Objects;
+using osu.Game.Rulesets.Osu.UI;
+using osu.Game.Screens.Edit.Compose.Components.Timeline;
+using osu.Game.Screens.Edit.Timing;
+using osu.Game.Tests.Beatmaps;
+using osuTK;
+using osuTK.Input;
+
+namespace osu.Game.Tests.Visual.Editing
+{
+    public class TestSceneHitObjectDifficultyPointAdjustments : EditorTestScene
+    {
+        protected override Ruleset CreateEditorRuleset() => new OsuRuleset();
+
+        protected override IBeatmap CreateBeatmap(RulesetInfo ruleset) => new TestBeatmap(ruleset, false);
+
+        public override void SetUpSteps()
+        {
+            base.SetUpSteps();
+
+            AddStep("add test objects", () =>
+            {
+                EditorBeatmap.Add(new Slider
+                {
+                    StartTime = 0,
+                    Position = (OsuPlayfield.BASE_SIZE - new Vector2(0, 100)) / 2,
+                    Path = new SliderPath
+                    {
+                        ControlPoints =
+                        {
+                            new PathControlPoint(new Vector2(0, 0)),
+                            new PathControlPoint(new Vector2(0, 100))
+                        }
+                    }
+                });
+
+                EditorBeatmap.Add(new Slider
+                {
+                    StartTime = 500,
+                    Position = (OsuPlayfield.BASE_SIZE - new Vector2(100, 0)) / 2,
+                    Path = new SliderPath
+                    {
+                        ControlPoints =
+                        {
+                            new PathControlPoint(new Vector2(0, 0)),
+                            new PathControlPoint(new Vector2(100, 0))
+                        }
+                    },
+                    DifficultyControlPoint = new DifficultyControlPoint
+                    {
+                        SliderVelocity = 2
+                    }
+                });
+            });
+        }
+
+        [Test]
+        public void TestSingleSelection()
+        {
+            clickDifficultyPiece(0);
+            velocityPopoverHasSingleValue(1);
+
+            dismissPopover();
+
+            // select first object to ensure that difficulty pieces for unselected objects
+            // work independently from selection state.
+            AddStep("select first object", () => EditorBeatmap.SelectedHitObjects.Add(EditorBeatmap.HitObjects.First()));
+
+            clickDifficultyPiece(1);
+            velocityPopoverHasSingleValue(2);
+
+            setVelocityViaPopover(5);
+            hitObjectHasVelocity(1, 5);
+        }
+
+        private void clickDifficultyPiece(int objectIndex) => AddStep($"click {objectIndex.ToOrdinalWords()} difficulty piece", () =>
+        {
+            var difficultyPiece = this.ChildrenOfType<DifficultyPointPiece>().Single(piece => piece.HitObject == EditorBeatmap.HitObjects.ElementAt(objectIndex));
+
+            InputManager.MoveMouseTo(difficultyPiece);
+            InputManager.Click(MouseButton.Left);
+        });
+
+        private void velocityPopoverHasSingleValue(double velocity) => AddUntilStep($"velocity popover has {velocity}", () =>
+        {
+            var popover = this.ChildrenOfType<DifficultyPointPiece.DifficultyEditPopover>().SingleOrDefault();
+            var slider = popover?.ChildrenOfType<SliderWithTextBoxInput<double>>().Single();
+
+            return slider?.Current.Value == velocity;
+        });
+
+        private void dismissPopover()
+        {
+            AddStep("dismiss popover", () => InputManager.Key(Key.Escape));
+            AddUntilStep("wait for dismiss", () => !this.ChildrenOfType<DifficultyPointPiece.DifficultyEditPopover>().Any(popover => popover.IsPresent));
+        }
+
+        private void setVelocityViaPopover(double velocity) => AddStep($"set {velocity} via popover", () =>
+        {
+            var popover = this.ChildrenOfType<DifficultyPointPiece.DifficultyEditPopover>().Single();
+            var slider = popover.ChildrenOfType<SliderWithTextBoxInput<double>>().Single();
+            slider.Current.Value = velocity;
+        });
+
+        private void hitObjectHasVelocity(int objectIndex, double velocity) => AddAssert($"{objectIndex.ToOrdinalWords()} has velocity {velocity}", () =>
+        {
+            var h = EditorBeatmap.HitObjects.ElementAt(objectIndex);
+            return h.DifficultyControlPoint.SliderVelocity == velocity;
+        });
+    }
+}
diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/DifficultyPointPiece.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/DifficultyPointPiece.cs
index 21457ea273..ae1884d295 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/DifficultyPointPiece.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/DifficultyPointPiece.cs
@@ -19,14 +19,14 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
 {
     public class DifficultyPointPiece : HitObjectPointPiece, IHasPopover
     {
-        private readonly HitObject hitObject;
+        public readonly HitObject HitObject;
 
         private readonly BindableNumber<double> speedMultiplier;
 
         public DifficultyPointPiece(HitObject hitObject)
             : base(hitObject.DifficultyControlPoint)
         {
-            this.hitObject = hitObject;
+            HitObject = hitObject;
 
             speedMultiplier = hitObject.DifficultyControlPoint.SliderVelocityBindable.GetBoundCopy();
         }
@@ -44,7 +44,7 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
             return true;
         }
 
-        public Popover GetPopover() => new DifficultyEditPopover(hitObject);
+        public Popover GetPopover() => new DifficultyEditPopover(HitObject);
 
         public class DifficultyEditPopover : OsuPopover
         {

From b8b86cbd2ae50baafae55158e9bb65187a76467c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 12 Nov 2021 21:41:17 +0100
Subject: [PATCH 0983/5547] Add failing tests for desired multiple selection
 behaviour

---
 ...ceneHitObjectDifficultyPointAdjustments.cs | 48 +++++++++++++++++++
 1 file changed, 48 insertions(+)

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneHitObjectDifficultyPointAdjustments.cs b/osu.Game.Tests/Visual/Editing/TestSceneHitObjectDifficultyPointAdjustments.cs
index bbae10e5ff..a678582dd6 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneHitObjectDifficultyPointAdjustments.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneHitObjectDifficultyPointAdjustments.cs
@@ -85,6 +85,46 @@ namespace osu.Game.Tests.Visual.Editing
             hitObjectHasVelocity(1, 5);
         }
 
+        [Test]
+        public void TestMultipleSelectionWithSameSliderVelocity()
+        {
+            AddStep("unify slider velocity", () =>
+            {
+                foreach (var h in EditorBeatmap.HitObjects)
+                    h.DifficultyControlPoint.SliderVelocity = 1.5;
+            });
+
+            AddStep("select both objects", () => EditorBeatmap.SelectedHitObjects.AddRange(EditorBeatmap.HitObjects));
+            clickDifficultyPiece(0);
+            velocityPopoverHasSingleValue(1.5);
+
+            dismissPopover();
+
+            clickDifficultyPiece(1);
+            velocityPopoverHasSingleValue(1.5);
+
+            setVelocityViaPopover(5);
+            hitObjectHasVelocity(0, 5);
+            hitObjectHasVelocity(1, 5);
+        }
+
+        [Test]
+        public void TestMultipleSelectionWithDifferentSliderVelocity()
+        {
+            AddStep("select both objects", () => EditorBeatmap.SelectedHitObjects.AddRange(EditorBeatmap.HitObjects));
+            clickDifficultyPiece(0);
+            velocityPopoverHasIndeterminateValue();
+
+            dismissPopover();
+
+            clickDifficultyPiece(1);
+            velocityPopoverHasIndeterminateValue();
+
+            setVelocityViaPopover(3);
+            hitObjectHasVelocity(0, 3);
+            hitObjectHasVelocity(1, 3);
+        }
+
         private void clickDifficultyPiece(int objectIndex) => AddStep($"click {objectIndex.ToOrdinalWords()} difficulty piece", () =>
         {
             var difficultyPiece = this.ChildrenOfType<DifficultyPointPiece>().Single(piece => piece.HitObject == EditorBeatmap.HitObjects.ElementAt(objectIndex));
@@ -101,6 +141,14 @@ namespace osu.Game.Tests.Visual.Editing
             return slider?.Current.Value == velocity;
         });
 
+        private void velocityPopoverHasIndeterminateValue() => AddUntilStep("velocity popover has indeterminate value", () =>
+        {
+            var popover = this.ChildrenOfType<DifficultyPointPiece.DifficultyEditPopover>().SingleOrDefault();
+            var slider = popover?.ChildrenOfType<SliderWithTextBoxInput<double>>().Single();
+
+            return slider != null && slider.Current.Value == null;
+        });
+
         private void dismissPopover()
         {
             AddStep("dismiss popover", () => InputManager.Key(Key.Escape));

From e55e2a1697aa7fe18050f61cfc3232f34855c0d3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 12 Nov 2021 22:54:27 +0100
Subject: [PATCH 0984/5547] Allow to adjust slider velocity on multiple objects
 simultaneously

---
 ...ceneHitObjectDifficultyPointAdjustments.cs |   6 +-
 .../Timeline/DifficultyPointPiece.cs          |  47 ++++---
 .../IndeterminateSliderWithTextBoxInput.cs    | 115 ++++++++++++++++++
 3 files changed, 151 insertions(+), 17 deletions(-)
 create mode 100644 osu.Game/Screens/Edit/Timing/IndeterminateSliderWithTextBoxInput.cs

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneHitObjectDifficultyPointAdjustments.cs b/osu.Game.Tests/Visual/Editing/TestSceneHitObjectDifficultyPointAdjustments.cs
index a678582dd6..4012a672ed 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneHitObjectDifficultyPointAdjustments.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneHitObjectDifficultyPointAdjustments.cs
@@ -136,7 +136,7 @@ namespace osu.Game.Tests.Visual.Editing
         private void velocityPopoverHasSingleValue(double velocity) => AddUntilStep($"velocity popover has {velocity}", () =>
         {
             var popover = this.ChildrenOfType<DifficultyPointPiece.DifficultyEditPopover>().SingleOrDefault();
-            var slider = popover?.ChildrenOfType<SliderWithTextBoxInput<double>>().Single();
+            var slider = popover?.ChildrenOfType<IndeterminateSliderWithTextBoxInput<double>>().Single();
 
             return slider?.Current.Value == velocity;
         });
@@ -144,7 +144,7 @@ namespace osu.Game.Tests.Visual.Editing
         private void velocityPopoverHasIndeterminateValue() => AddUntilStep("velocity popover has indeterminate value", () =>
         {
             var popover = this.ChildrenOfType<DifficultyPointPiece.DifficultyEditPopover>().SingleOrDefault();
-            var slider = popover?.ChildrenOfType<SliderWithTextBoxInput<double>>().Single();
+            var slider = popover?.ChildrenOfType<IndeterminateSliderWithTextBoxInput<double>>().Single();
 
             return slider != null && slider.Current.Value == null;
         });
@@ -158,7 +158,7 @@ namespace osu.Game.Tests.Visual.Editing
         private void setVelocityViaPopover(double velocity) => AddStep($"set {velocity} via popover", () =>
         {
             var popover = this.ChildrenOfType<DifficultyPointPiece.DifficultyEditPopover>().Single();
-            var slider = popover.ChildrenOfType<SliderWithTextBoxInput<double>>().Single();
+            var slider = popover.ChildrenOfType<IndeterminateSliderWithTextBoxInput<double>>().Single();
             slider.Current.Value = velocity;
         });
 
diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/DifficultyPointPiece.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/DifficultyPointPiece.cs
index ae1884d295..76a8243e05 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/DifficultyPointPiece.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/DifficultyPointPiece.cs
@@ -1,9 +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.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Extensions;
+using osu.Framework.Extensions.IEnumerableExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Cursor;
@@ -49,9 +51,8 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
         public class DifficultyEditPopover : OsuPopover
         {
             private readonly HitObject hitObject;
-            private readonly DifficultyControlPoint point;
 
-            private SliderWithTextBoxInput<double> sliderVelocitySlider;
+            private IndeterminateSliderWithTextBoxInput<double> sliderVelocitySlider;
 
             [Resolved(canBeNull: true)]
             private EditorBeatmap beatmap { get; set; }
@@ -59,7 +60,6 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
             public DifficultyEditPopover(HitObject hitObject)
             {
                 this.hitObject = hitObject;
-                point = hitObject.DifficultyControlPoint;
             }
 
             [BackgroundDependencyLoader]
@@ -74,9 +74,8 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
                         AutoSizeAxes = Axes.Y,
                         Children = new Drawable[]
                         {
-                            sliderVelocitySlider = new SliderWithTextBoxInput<double>("Velocity")
+                            sliderVelocitySlider = new IndeterminateSliderWithTextBoxInput<double>("Velocity", new DifficultyControlPoint().SliderVelocityBindable)
                             {
-                                Current = new DifficultyControlPoint().SliderVelocityBindable,
                                 KeyboardStep = 0.1f
                             },
                             new OsuTextFlowContainer
@@ -89,17 +88,37 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
                     }
                 };
 
-                var selectedPointBindable = point.SliderVelocityBindable;
+                // if the piece belongs to a currently selected object, assume that the user wants to change all selected objects.
+                // if the piece belongs to an unselected object, operate on that object alone, independently of the selection.
+                var relevantObjects = (beatmap.SelectedHitObjects.Contains(hitObject) ? beatmap.SelectedHitObjects : hitObject.Yield()).ToArray();
+                var relevantControlPoints = relevantObjects.Select(h => h.DifficultyControlPoint).ToArray();
 
-                // there may be legacy control points, which contain infinite precision for compatibility reasons (see LegacyDifficultyControlPoint).
-                // generally that level of precision could only be set by externally editing the .osu file, so at the point
-                // a user is looking to update this within the editor it should be safe to obliterate this additional precision.
-                double expectedPrecision = new DifficultyControlPoint().SliderVelocityBindable.Precision;
-                if (selectedPointBindable.Precision < expectedPrecision)
-                    selectedPointBindable.Precision = expectedPrecision;
+                // even if there are multiple objects selected, we can still display a value if they all have the same value.
+                var selectedPointBindable = relevantControlPoints.Select(point => point.SliderVelocity).Distinct().Count() == 1 ? relevantControlPoints.First().SliderVelocityBindable : null;
 
-                sliderVelocitySlider.Current = selectedPointBindable;
-                sliderVelocitySlider.Current.BindValueChanged(_ => beatmap?.Update(hitObject));
+                if (selectedPointBindable != null)
+                {
+                    // there may be legacy control points, which contain infinite precision for compatibility reasons (see LegacyDifficultyControlPoint).
+                    // generally that level of precision could only be set by externally editing the .osu file, so at the point
+                    // a user is looking to update this within the editor it should be safe to obliterate this additional precision.
+                    sliderVelocitySlider.Current.Value = selectedPointBindable.Value;
+                }
+
+                sliderVelocitySlider.Current.BindValueChanged(val =>
+                {
+                    if (val.NewValue == null)
+                        return;
+
+                    beatmap.BeginChange();
+
+                    foreach (var h in relevantObjects)
+                    {
+                        h.DifficultyControlPoint.SliderVelocity = val.NewValue.Value;
+                        beatmap.Update(h);
+                    }
+
+                    beatmap.EndChange();
+                });
             }
         }
     }
diff --git a/osu.Game/Screens/Edit/Timing/IndeterminateSliderWithTextBoxInput.cs b/osu.Game/Screens/Edit/Timing/IndeterminateSliderWithTextBoxInput.cs
new file mode 100644
index 0000000000..a5c682e56a
--- /dev/null
+++ b/osu.Game/Screens/Edit/Timing/IndeterminateSliderWithTextBoxInput.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;
+using osu.Framework.Bindables;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.UserInterface;
+using osu.Framework.Localisation;
+using osu.Game.Graphics.UserInterfaceV2;
+using osu.Game.Overlays.Settings;
+
+namespace osu.Game.Screens.Edit.Timing
+{
+    /// <summary>
+    /// Analogous to <see cref="SliderWithTextBoxInput{T}"/>, but supports scenarios
+    /// where multiple objects with multiple different property values are selected
+    /// by providing an "indeterminate state".
+    /// </summary>
+    public class IndeterminateSliderWithTextBoxInput<T> : CompositeDrawable, IHasCurrentValue<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.
+        /// </summary>
+        public float KeyboardStep
+        {
+            get => slider.KeyboardStep;
+            set => slider.KeyboardStep = value;
+        }
+
+        private readonly BindableWithCurrent<T?> current = new BindableWithCurrent<T?>();
+
+        public Bindable<T?> Current
+        {
+            get => current.Current;
+            set => current.Current = value;
+        }
+
+        private readonly SettingsSlider<T> slider;
+        private readonly LabelledTextBox textbox;
+
+        /// <summary>
+        /// Creates an <see cref="IndeterminateSliderWithTextBoxInput{T}"/>.
+        /// </summary>
+        /// <param name="labelText">The label text for the slider and text box.</param>
+        /// <param name="indeterminateValue">
+        /// Bindable to use for the slider until a non-null value is set for <see cref="Current"/>.
+        /// In particular, it can be used to control min/max bounds and precision in the case of <see cref="BindableNumber{T}"/>s.
+        /// </param>
+        public IndeterminateSliderWithTextBoxInput(LocalisableString labelText, Bindable<T> indeterminateValue)
+        {
+            RelativeSizeAxes = Axes.X;
+            AutoSizeAxes = Axes.Y;
+
+            InternalChildren = new Drawable[]
+            {
+                new FillFlowContainer
+                {
+                    RelativeSizeAxes = Axes.X,
+                    AutoSizeAxes = Axes.Y,
+                    Direction = FillDirection.Vertical,
+                    Children = new Drawable[]
+                    {
+                        textbox = new LabelledTextBox
+                        {
+                            Label = labelText,
+                            PlaceholderText = "(multiple)"
+                        },
+                        slider = new SettingsSlider<T>
+                        {
+                            TransferValueOnCommit = true,
+                            RelativeSizeAxes = Axes.X,
+                            Current = indeterminateValue
+                        }
+                    }
+                },
+            };
+
+            textbox.OnCommit += (t, isNew) =>
+            {
+                if (!isNew) return;
+
+                try
+                {
+                    slider.Current.Parse(t.Text);
+                }
+                catch
+                {
+                    // TriggerChange below will restore the previous text value on failure.
+                }
+
+                // This is run regardless of parsing success as the parsed number may not actually trigger a change
+                // due to bindable clamping. Even in such a case we want to update the textbox to a sane visual state.
+                Current.TriggerChange();
+            };
+            slider.Current.BindValueChanged(val => Current.Value = val.NewValue);
+
+            Current.BindValueChanged(_ => updateState(), true);
+        }
+
+        private void updateState()
+        {
+            if (Current.Value is T nonNullValue)
+            {
+                slider.Current.Value = nonNullValue;
+                textbox.Text = slider.Current.ToString();
+            }
+            else
+            {
+                textbox.Text = null;
+            }
+        }
+    }
+}

From d567d2be973cd860122454bfbb64b7150ef0a8b6 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 12 Nov 2021 23:07:24 +0100
Subject: [PATCH 0985/5547] Fix multiple issues with textbox content display

- Sometimes would display too many decimal digits due to floating point
  representation errors.

- Placeholder would also look wrong if text was removed during a
  multiple (but determinate) selection.
---
 .../Graphics/UserInterface/OsuSliderBar.cs    | 21 ++-----------------
 .../IndeterminateSliderWithTextBoxInput.cs    | 10 +++++++--
 osu.Game/Utils/FormatUtils.cs                 | 18 ++++++++++++++++
 3 files changed, 28 insertions(+), 21 deletions(-)

diff --git a/osu.Game/Graphics/UserInterface/OsuSliderBar.cs b/osu.Game/Graphics/UserInterface/OsuSliderBar.cs
index d4310dc901..333ae4f832 100644
--- a/osu.Game/Graphics/UserInterface/OsuSliderBar.cs
+++ b/osu.Game/Graphics/UserInterface/OsuSliderBar.cs
@@ -19,6 +19,7 @@ using osu.Framework.Input.Events;
 using osu.Framework.Localisation;
 using osu.Framework.Utils;
 using osu.Game.Overlays;
+using osu.Game.Utils;
 
 namespace osu.Game.Graphics.UserInterface
 {
@@ -219,7 +220,7 @@ namespace osu.Game.Graphics.UserInterface
                     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 = findPrecision(decimalPrecision);
+                    int significantDigits = FormatUtils.FindPrecision(decimalPrecision);
 
                     TooltipText = floatValue.ToString($"N{significantDigits}");
                 }
@@ -248,23 +249,5 @@ namespace osu.Game.Graphics.UserInterface
         /// <returns>The normalised decimal.</returns>
         private decimal normalise(decimal d, int sd)
             => decimal.Parse(Math.Round(d, sd).ToString(string.Concat("0.", new string('#', sd)), CultureInfo.InvariantCulture), CultureInfo.InvariantCulture);
-
-        /// <summary>
-        /// Finds the number of digits after the decimal.
-        /// </summary>
-        /// <param name="d">The value to find the number of decimal digits for.</param>
-        /// <returns>The number decimal digits.</returns>
-        private int findPrecision(decimal d)
-        {
-            int precision = 0;
-
-            while (d != Math.Round(d))
-            {
-                d *= 10;
-                precision++;
-            }
-
-            return precision;
-        }
     }
 }
diff --git a/osu.Game/Screens/Edit/Timing/IndeterminateSliderWithTextBoxInput.cs b/osu.Game/Screens/Edit/Timing/IndeterminateSliderWithTextBoxInput.cs
index a5c682e56a..17f82f4978 100644
--- a/osu.Game/Screens/Edit/Timing/IndeterminateSliderWithTextBoxInput.cs
+++ b/osu.Game/Screens/Edit/Timing/IndeterminateSliderWithTextBoxInput.cs
@@ -2,6 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
+using System.Globalization;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
@@ -9,6 +10,7 @@ using osu.Framework.Graphics.UserInterface;
 using osu.Framework.Localisation;
 using osu.Game.Graphics.UserInterfaceV2;
 using osu.Game.Overlays.Settings;
+using osu.Game.Utils;
 
 namespace osu.Game.Screens.Edit.Timing
 {
@@ -65,7 +67,6 @@ namespace osu.Game.Screens.Edit.Timing
                         textbox = new LabelledTextBox
                         {
                             Label = labelText,
-                            PlaceholderText = "(multiple)"
                         },
                         slider = new SettingsSlider<T>
                         {
@@ -104,11 +105,16 @@ namespace osu.Game.Screens.Edit.Timing
             if (Current.Value is T nonNullValue)
             {
                 slider.Current.Value = nonNullValue;
-                textbox.Text = slider.Current.ToString();
+
+                // 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);
+                textbox.Text = decimalValue.ToString($@"N{FormatUtils.FindPrecision(decimalValue)}");
+                textbox.PlaceholderText = string.Empty;
             }
             else
             {
                 textbox.Text = null;
+                textbox.PlaceholderText = "(multiple)";
             }
         }
     }
diff --git a/osu.Game/Utils/FormatUtils.cs b/osu.Game/Utils/FormatUtils.cs
index d14dbb49f3..799dc75ca9 100644
--- a/osu.Game/Utils/FormatUtils.cs
+++ b/osu.Game/Utils/FormatUtils.cs
@@ -31,5 +31,23 @@ namespace osu.Game.Utils
         /// </summary>
         /// <param name="rank">The rank/position to be formatted.</param>
         public static string FormatRank(this int rank) => rank.ToMetric(decimals: rank < 100_000 ? 1 : 0);
+
+        /// <summary>
+        /// Finds the number of digits after the decimal.
+        /// </summary>
+        /// <param name="d">The value to find the number of decimal digits for.</param>
+        /// <returns>The number decimal digits.</returns>
+        public static int FindPrecision(decimal d)
+        {
+            int precision = 0;
+
+            while (d != Math.Round(d))
+            {
+                d *= 10;
+                precision++;
+            }
+
+            return precision;
+        }
     }
 }

From e1c28ddd7617d15f466b6c7546b1e1ca353c85d8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 12 Nov 2021 23:16:45 +0100
Subject: [PATCH 0986/5547] Adjust difficulty point popover content spacing

---
 .../Edit/Compose/Components/Timeline/DifficultyPointPiece.cs    | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/DifficultyPointPiece.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/DifficultyPointPiece.cs
index 76a8243e05..b230bab0c2 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/DifficultyPointPiece.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/DifficultyPointPiece.cs
@@ -16,6 +16,7 @@ using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.UserInterfaceV2;
 using osu.Game.Rulesets.Objects;
 using osu.Game.Screens.Edit.Timing;
+using osuTK;
 
 namespace osu.Game.Screens.Edit.Compose.Components.Timeline
 {
@@ -72,6 +73,7 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
                         Width = 200,
                         Direction = FillDirection.Vertical,
                         AutoSizeAxes = Axes.Y,
+                        Spacing = new Vector2(0, 15),
                         Children = new Drawable[]
                         {
                             sliderVelocitySlider = new IndeterminateSliderWithTextBoxInput<double>("Velocity", new DifficultyControlPoint().SliderVelocityBindable)

From a5ba3bd012c95a6ab39ffcf3274a0ac74590efa8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 12 Nov 2021 12:07:38 +0100
Subject: [PATCH 0987/5547] Move gameplay test pieces to own namespace

---
 osu.Game.Tests/Visual/Editing/TestSceneEditorTestGameplay.cs    | 1 +
 osu.Game/Screens/Edit/Editor.cs                                 | 1 +
 osu.Game/Screens/Edit/{ => GameplayTest}/EditorPlayer.cs        | 2 +-
 .../Edit/{ => GameplayTest}/SaveBeforeGameplayTestDialog.cs     | 2 +-
 4 files changed, 4 insertions(+), 2 deletions(-)
 rename osu.Game/Screens/Edit/{ => GameplayTest}/EditorPlayer.cs (96%)
 rename osu.Game/Screens/Edit/{ => GameplayTest}/SaveBeforeGameplayTestDialog.cs (95%)

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneEditorTestGameplay.cs b/osu.Game.Tests/Visual/Editing/TestSceneEditorTestGameplay.cs
index db42667033..e311c7a7ec 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneEditorTestGameplay.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneEditorTestGameplay.cs
@@ -12,6 +12,7 @@ using osu.Game.Rulesets;
 using osu.Game.Rulesets.Osu;
 using osu.Game.Screens.Edit;
 using osu.Game.Screens.Edit.Components.Timelines.Summary;
+using osu.Game.Screens.Edit.GameplayTest;
 using osu.Game.Tests.Beatmaps.IO;
 using osuTK.Input;
 
diff --git a/osu.Game/Screens/Edit/Editor.cs b/osu.Game/Screens/Edit/Editor.cs
index 738f607cc8..0c54e39a35 100644
--- a/osu.Game/Screens/Edit/Editor.cs
+++ b/osu.Game/Screens/Edit/Editor.cs
@@ -31,6 +31,7 @@ using osu.Game.Screens.Edit.Components.Menus;
 using osu.Game.Screens.Edit.Components.Timelines.Summary;
 using osu.Game.Screens.Edit.Compose;
 using osu.Game.Screens.Edit.Design;
+using osu.Game.Screens.Edit.GameplayTest;
 using osu.Game.Screens.Edit.Setup;
 using osu.Game.Screens.Edit.Timing;
 using osu.Game.Screens.Edit.Verify;
diff --git a/osu.Game/Screens/Edit/EditorPlayer.cs b/osu.Game/Screens/Edit/GameplayTest/EditorPlayer.cs
similarity index 96%
rename from osu.Game/Screens/Edit/EditorPlayer.cs
rename to osu.Game/Screens/Edit/GameplayTest/EditorPlayer.cs
index b2fab3fefc..9856ad62bb 100644
--- a/osu.Game/Screens/Edit/EditorPlayer.cs
+++ b/osu.Game/Screens/Edit/GameplayTest/EditorPlayer.cs
@@ -6,7 +6,7 @@ using osu.Framework.Screens;
 using osu.Game.Overlays;
 using osu.Game.Screens.Play;
 
-namespace osu.Game.Screens.Edit
+namespace osu.Game.Screens.Edit.GameplayTest
 {
     public class EditorPlayer : Player
     {
diff --git a/osu.Game/Screens/Edit/SaveBeforeGameplayTestDialog.cs b/osu.Game/Screens/Edit/GameplayTest/SaveBeforeGameplayTestDialog.cs
similarity index 95%
rename from osu.Game/Screens/Edit/SaveBeforeGameplayTestDialog.cs
rename to osu.Game/Screens/Edit/GameplayTest/SaveBeforeGameplayTestDialog.cs
index 7c03664c66..9334c74706 100644
--- a/osu.Game/Screens/Edit/SaveBeforeGameplayTestDialog.cs
+++ b/osu.Game/Screens/Edit/GameplayTest/SaveBeforeGameplayTestDialog.cs
@@ -5,7 +5,7 @@ using System;
 using osu.Framework.Graphics.Sprites;
 using osu.Game.Overlays.Dialog;
 
-namespace osu.Game.Screens.Edit
+namespace osu.Game.Screens.Edit.GameplayTest
 {
     public class SaveBeforeGameplayTestDialog : PopupDialog
     {

From b47c0b63f4305fe3de7bcaf0d142825ddf3b3ec0 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 12 Nov 2021 12:30:40 +0100
Subject: [PATCH 0988/5547] Tweak loader transition when testing gameplay in
 editor

---
 osu.Game/Screens/Edit/Editor.cs               |  2 +-
 .../Edit/GameplayTest/EditorPlayerLoader.cs   | 44 +++++++++++++++++++
 osu.Game/Screens/Play/PlayerLoader.cs         | 26 ++++++-----
 3 files changed, 59 insertions(+), 13 deletions(-)
 create mode 100644 osu.Game/Screens/Edit/GameplayTest/EditorPlayerLoader.cs

diff --git a/osu.Game/Screens/Edit/Editor.cs b/osu.Game/Screens/Edit/Editor.cs
index 0c54e39a35..2c758eaf41 100644
--- a/osu.Game/Screens/Edit/Editor.cs
+++ b/osu.Game/Screens/Edit/Editor.cs
@@ -798,7 +798,7 @@ namespace osu.Game.Screens.Edit
                 pushEditorPlayer();
             }
 
-            void pushEditorPlayer() => this.Push(new PlayerLoader(() => new EditorPlayer()));
+            void pushEditorPlayer() => this.Push(new EditorPlayerLoader());
         }
 
         public double SnapTime(double time, double? referenceTime) => editorBeatmap.SnapTime(time, referenceTime);
diff --git a/osu.Game/Screens/Edit/GameplayTest/EditorPlayerLoader.cs b/osu.Game/Screens/Edit/GameplayTest/EditorPlayerLoader.cs
new file mode 100644
index 0000000000..610fff70f2
--- /dev/null
+++ b/osu.Game/Screens/Edit/GameplayTest/EditorPlayerLoader.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 osu.Framework.Allocation;
+using osu.Framework.Graphics;
+using osu.Framework.Screens;
+using osu.Game.Screens.Menu;
+using osu.Game.Screens.Play;
+
+namespace osu.Game.Screens.Edit.GameplayTest
+{
+    public class EditorPlayerLoader : PlayerLoader
+    {
+        [Resolved]
+        private OsuLogo osuLogo { get; set; }
+
+        public EditorPlayerLoader()
+            : base(() => new EditorPlayer())
+        {
+        }
+
+        public override void OnEntering(IScreen last)
+        {
+            base.OnEntering(last);
+
+            MetadataInfo.FinishTransforms(true);
+        }
+
+        protected override void LogoArriving(OsuLogo logo, bool resuming)
+        {
+            // call base with resuming forcefully set to true to reduce logo movements.
+            base.LogoArriving(logo, true);
+            logo.FinishTransforms(true, nameof(Scale));
+        }
+
+        protected override void ContentOut()
+        {
+            base.ContentOut();
+            osuLogo.FadeOut(CONTENT_OUT_DURATION, Easing.OutQuint);
+        }
+
+        protected override double PlayerPushDelay => 0;
+    }
+}
diff --git a/osu.Game/Screens/Play/PlayerLoader.cs b/osu.Game/Screens/Play/PlayerLoader.cs
index ba34df0e59..57db411571 100644
--- a/osu.Game/Screens/Play/PlayerLoader.cs
+++ b/osu.Game/Screens/Play/PlayerLoader.cs
@@ -36,7 +36,9 @@ namespace osu.Game.Screens.Play
     {
         protected const float BACKGROUND_BLUR = 15;
 
-        private const double content_out_duration = 300;
+        protected const double CONTENT_OUT_DURATION = 300;
+
+        protected virtual double PlayerPushDelay => 1800;
 
         public override bool HideOverlaysOnEnter => hideOverlays;
 
@@ -213,7 +215,7 @@ namespace osu.Game.Screens.Play
 
             // after an initial delay, start the debounced load check.
             // this will continue to execute even after resuming back on restart.
-            Scheduler.Add(new ScheduledDelegate(pushWhenLoaded, Clock.CurrentTime + 1800, 0));
+            Scheduler.Add(new ScheduledDelegate(pushWhenLoaded, Clock.CurrentTime + PlayerPushDelay, 0));
 
             showMuteWarningIfNeeded();
             showBatteryWarningIfNeeded();
@@ -248,13 +250,13 @@ namespace osu.Game.Screens.Play
         public override bool OnExiting(IScreen next)
         {
             cancelLoad();
-            contentOut();
+            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();
+            this.Delay(CONTENT_OUT_DURATION).FadeOut();
 
             ApplyToBackground(b => b.IgnoreUserSettings.Value = true);
 
@@ -361,15 +363,15 @@ namespace osu.Game.Screens.Play
             ApplyToBackground(b => b?.FadeColour(Color4.White, 800, Easing.OutQuint));
         }
 
-        private void contentOut()
+        protected virtual void ContentOut()
         {
             // Ensure the logo is no longer tracking before we scale the content
             content.StopTracking();
 
-            content.ScaleTo(0.7f, content_out_duration * 2, Easing.OutQuint);
-            content.FadeOut(content_out_duration, Easing.OutQuint);
-            lowPassFilter.CutoffTo(AudioFilter.MAX_LOWPASS_CUTOFF, content_out_duration);
-            highPassFilter.CutoffTo(0, content_out_duration);
+            content.ScaleTo(0.7f, CONTENT_OUT_DURATION * 2, Easing.OutQuint);
+            content.FadeOut(CONTENT_OUT_DURATION, Easing.OutQuint);
+            lowPassFilter.CutoffTo(AudioFilter.MAX_LOWPASS_CUTOFF, CONTENT_OUT_DURATION);
+            highPassFilter.CutoffTo(0, CONTENT_OUT_DURATION);
         }
 
         private void pushWhenLoaded()
@@ -394,9 +396,9 @@ namespace osu.Game.Screens.Play
                 // 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).
                 var consumedPlayer = consumePlayer();
 
-                contentOut();
+                ContentOut();
 
-                TransformSequence<PlayerLoader> pushSequence = this.Delay(content_out_duration);
+                TransformSequence<PlayerLoader> pushSequence = this.Delay(CONTENT_OUT_DURATION);
 
                 // 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).
@@ -418,7 +420,7 @@ namespace osu.Game.Screens.Play
                 else
                 {
                     // This goes hand-in-hand with the restoration of low pass filter in contentOut().
-                    this.TransformBindableTo(volumeAdjustment, 0, content_out_duration, Easing.OutCubic);
+                    this.TransformBindableTo(volumeAdjustment, 0, CONTENT_OUT_DURATION, Easing.OutCubic);
                 }
 
                 pushSequence.Schedule(() =>

From eb8c5292d5db823f1f99947ca936d3e8d3e722f9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 13 Nov 2021 13:50:57 +0100
Subject: [PATCH 0989/5547] Ensure editor background is dimmed after return
 from gameplay test

---
 .../Visual/Editing/TestSceneEditorTestGameplay.cs   |  7 +++++++
 osu.Game/Screens/Edit/Editor.cs                     | 13 +++++++++++--
 2 files changed, 18 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneEditorTestGameplay.cs b/osu.Game.Tests/Visual/Editing/TestSceneEditorTestGameplay.cs
index e311c7a7ec..f52a764708 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneEditorTestGameplay.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneEditorTestGameplay.cs
@@ -10,10 +10,12 @@ using osu.Framework.Testing;
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Osu;
+using osu.Game.Screens.Backgrounds;
 using osu.Game.Screens.Edit;
 using osu.Game.Screens.Edit.Components.Timelines.Summary;
 using osu.Game.Screens.Edit.GameplayTest;
 using osu.Game.Tests.Beatmaps.IO;
+using osuTK.Graphics;
 using osuTK.Input;
 
 namespace osu.Game.Tests.Visual.Editing
@@ -59,6 +61,11 @@ namespace osu.Game.Tests.Visual.Editing
             AddUntilStep("player pushed", () => (editorPlayer = Stack.CurrentScreen as EditorPlayer) != null);
             AddStep("exit player", () => editorPlayer.Exit());
             AddUntilStep("current screen is editor", () => Stack.CurrentScreen is Editor);
+            AddUntilStep("background has correct params", () =>
+            {
+                var background = this.ChildrenOfType<BackgroundScreenBeatmap>().Single();
+                return background.Colour == Color4.DarkGray && background.BlurAmount.Value == 0;
+            });
         }
 
         [Test]
diff --git a/osu.Game/Screens/Edit/Editor.cs b/osu.Game/Screens/Edit/Editor.cs
index 2c758eaf41..d97838e86d 100644
--- a/osu.Game/Screens/Edit/Editor.cs
+++ b/osu.Game/Screens/Edit/Editor.cs
@@ -487,7 +487,18 @@ namespace osu.Game.Screens.Edit
         public override void OnEntering(IScreen last)
         {
             base.OnEntering(last);
+            dimBackground();
+            resetTrack(true);
+        }
 
+        public override void OnResuming(IScreen last)
+        {
+            base.OnResuming(last);
+            dimBackground();
+        }
+
+        private void dimBackground()
+        {
             ApplyToBackground(b =>
             {
                 // todo: temporary. we want to be applying dim using the UserDimContainer eventually.
@@ -496,8 +507,6 @@ namespace osu.Game.Screens.Edit
                 b.IgnoreUserSettings.Value = true;
                 b.BlurAmount.Value = 0;
             });
-
-            resetTrack(true);
         }
 
         public override bool OnExiting(IScreen next)

From 5f2a789a6d58b564d79b03aa48475a3c6b686450 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 13 Nov 2021 14:01:00 +0100
Subject: [PATCH 0990/5547] Ensure editor clock is stopped before testing
 gameplay

---
 .../Editing/TestSceneEditorTestGameplay.cs    | 31 +++++++++++++++++++
 osu.Game/Screens/Edit/Editor.cs               |  4 +--
 2 files changed, 33 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneEditorTestGameplay.cs b/osu.Game.Tests/Visual/Editing/TestSceneEditorTestGameplay.cs
index f52a764708..1d572772eb 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneEditorTestGameplay.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneEditorTestGameplay.cs
@@ -68,6 +68,37 @@ namespace osu.Game.Tests.Visual.Editing
             });
         }
 
+        [Test]
+        public void TestGameplayTestWhenTrackRunning()
+        {
+            AddStep("start track", () => EditorClock.Start());
+            AddAssert("sample playback enabled", () => !Editor.SamplePlaybackDisabled.Value);
+
+            AddStep("click test gameplay button", () =>
+            {
+                var button = Editor.ChildrenOfType<TestGameplayButton>().Single();
+
+                InputManager.MoveMouseTo(button);
+                InputManager.Click(MouseButton.Left);
+            });
+
+            EditorPlayer editorPlayer = null;
+            AddUntilStep("player pushed", () => (editorPlayer = Stack.CurrentScreen as EditorPlayer) != null);
+            AddAssert("editor track stopped", () => !EditorClock.IsRunning);
+            AddAssert("sample playback disabled", () => Editor.SamplePlaybackDisabled.Value);
+
+            AddStep("exit player", () => editorPlayer.Exit());
+            AddUntilStep("current screen is editor", () => Stack.CurrentScreen is Editor);
+            AddUntilStep("background has correct params", () =>
+            {
+                var background = this.ChildrenOfType<BackgroundScreenBeatmap>().Single();
+                return background.Colour == Color4.DarkGray && background.BlurAmount.Value == 0;
+            });
+
+            AddStep("start track", () => EditorClock.Start());
+            AddAssert("sample playback re-enabled", () => !Editor.SamplePlaybackDisabled.Value);
+        }
+
         [Test]
         public void TestCancelGameplayTestWithUnsavedChanges()
         {
diff --git a/osu.Game/Screens/Edit/Editor.cs b/osu.Game/Screens/Edit/Editor.cs
index d97838e86d..ab24391bb4 100644
--- a/osu.Game/Screens/Edit/Editor.cs
+++ b/osu.Game/Screens/Edit/Editor.cs
@@ -545,9 +545,9 @@ namespace osu.Game.Screens.Edit
 
         public override void OnSuspending(IScreen next)
         {
-            refetchBeatmap();
-
             base.OnSuspending(next);
+            clock.Stop();
+            refetchBeatmap();
         }
 
         private void refetchBeatmap()

From be3f225d4bb6dbe4f4bb2dfdd6453a7e08ee1f30 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 13 Nov 2021 15:01:37 +0100
Subject: [PATCH 0991/5547] Update in line with `Online{BeatmapSet -> }ID`
 changes

---
 osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs        | 2 +-
 .../Visual/Beatmaps/TestSceneBeatmapCardDownloadButton.cs     | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs
index 29a1e349c4..addec15881 100644
--- a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs
+++ b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs
@@ -193,7 +193,7 @@ namespace osu.Game.Tests.Visual.Beatmaps
             AddUntilStep("ensure manager loaded", () => beatmaps != null);
             AddStep("remove soleily", () =>
             {
-                var beatmap = beatmaps.QueryBeatmapSet(b => b.OnlineBeatmapSetID == 241526);
+                var beatmap = beatmaps.QueryBeatmapSet(b => b.OnlineID == 241526);
 
                 if (beatmap != null) beatmaps.Delete(beatmap);
             });
diff --git a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCardDownloadButton.cs b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCardDownloadButton.cs
index 82ab55cf0e..4a8bd7cff0 100644
--- a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCardDownloadButton.cs
+++ b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCardDownloadButton.cs
@@ -87,7 +87,7 @@ namespace osu.Game.Tests.Visual.Beatmaps
             AddAssert("button state not downloaded", () => downloadButton.State.Value == DownloadState.NotDownloaded);
             AddStep("import soleily", () => beatmaps.Import(TestResources.GetQuickTestBeatmapForImport()));
 
-            AddUntilStep("wait for beatmap import", () => beatmaps.GetAllUsableBeatmapSets().Any(b => b.OnlineBeatmapSetID == 241526));
+            AddUntilStep("wait for beatmap import", () => beatmaps.GetAllUsableBeatmapSets().Any(b => b.OnlineID == 241526));
             AddUntilStep("button state downloaded", () => downloadButton.State.Value == DownloadState.LocallyAvailable);
 
             createButtonWithBeatmap(createSoleily());
@@ -101,7 +101,7 @@ namespace osu.Game.Tests.Visual.Beatmaps
             AddUntilStep("ensure manager loaded", () => beatmaps != null);
             AddStep("remove soleily", () =>
             {
-                var beatmap = beatmaps.QueryBeatmapSet(b => b.OnlineBeatmapSetID == 241526);
+                var beatmap = beatmaps.QueryBeatmapSet(b => b.OnlineID == 241526);
 
                 if (beatmap != null) beatmaps.Delete(beatmap);
             });

From b58fe2d80a88c90cb7f25accffd5be5dd62e8809 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 13 Nov 2021 15:38:04 +0100
Subject: [PATCH 0992/5547] Restructure card to use single tracker at the top
 level

---
 .../TestSceneBeatmapCardDownloadButton.cs     |  5 +--
 .../Beatmaps/Drawables/Cards/BeatmapCard.cs   | 16 ++++++---
 .../Cards/BeatmapCardDownloadProgressBar.cs   | 34 +++++++------------
 .../Drawables/Cards/Buttons/DownloadButton.cs | 19 +++++++----
 4 files changed, 38 insertions(+), 36 deletions(-)

diff --git a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCardDownloadButton.cs b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCardDownloadButton.cs
index 4a8bd7cff0..67ad699615 100644
--- a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCardDownloadButton.cs
+++ b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCardDownloadButton.cs
@@ -178,8 +178,7 @@ namespace osu.Game.Tests.Visual.Beatmaps
 
         private class TestDownloadButton : DownloadButton
         {
-            public readonly Bindable<DownloadState> State = new Bindable<DownloadState>();
-            public readonly BindableNumber<double> Progress = new BindableNumber<double>();
+            public new Bindable<DownloadState> State => base.State;
 
             public new BeatmapCardIconButton Download => base.Download;
             public new BeatmapCardIconButton Play => base.Play;
@@ -187,8 +186,6 @@ namespace osu.Game.Tests.Visual.Beatmaps
             public TestDownloadButton(APIBeatmapSet beatmapSet)
                 : base(beatmapSet)
             {
-                Tracker.State.BindTo(State);
-                Tracker.Progress.BindTo(Progress);
             }
         }
     }
diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
index 09ceb72a10..23009cda5e 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
@@ -16,6 +16,7 @@ using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.UserInterface;
+using osu.Game.Online;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays;
 using osu.Game.Overlays.BeatmapSet;
@@ -38,6 +39,9 @@ namespace osu.Game.Beatmaps.Drawables.Cards
         private readonly APIBeatmapSet beatmapSet;
         private readonly Bindable<BeatmapSetFavouriteState> favouriteState;
 
+        [Cached]
+        private readonly BeatmapDownloadTracker downloadTracker;
+
         private UpdateableOnlineBeatmapSetCover leftCover;
         private FillFlowContainer leftIconArea;
 
@@ -61,6 +65,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
         {
             this.beatmapSet = beatmapSet;
             favouriteState = new Bindable<BeatmapSetFavouriteState>(new BeatmapSetFavouriteState(beatmapSet.HasFavourited, beatmapSet.FavouriteCount));
+            downloadTracker = new BeatmapDownloadTracker(beatmapSet);
         }
 
         [BackgroundDependencyLoader]
@@ -73,6 +78,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
 
             InternalChildren = new Drawable[]
             {
+                downloadTracker,
                 new Box
                 {
                     RelativeSizeAxes = Axes.Both,
@@ -270,7 +276,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                                         }
                                     }
                                 },
-                                downloadProgressBar = new BeatmapCardDownloadProgressBar(beatmapSet)
+                                downloadProgressBar = new BeatmapCardDownloadProgressBar
                                 {
                                     RelativeSizeAxes = Axes.X,
                                     Height = 6,
@@ -314,7 +320,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
         {
             base.LoadComplete();
 
-            downloadProgressBar.IsActive.BindValueChanged(_ => updateState(), true);
+            downloadTracker.State.BindValueChanged(_ => updateState(), true);
             FinishTransforms(true);
         }
 
@@ -367,8 +373,10 @@ namespace osu.Game.Beatmaps.Drawables.Cards
             statisticsContainer.FadeTo(IsHovered ? 1 : 0, TRANSITION_DURATION, Easing.OutQuint);
             rightButtonArea.FadeTo(IsHovered ? 1 : 0, TRANSITION_DURATION, Easing.OutQuint);
 
-            idleBottomContent.FadeTo(downloadProgressBar.IsActive.Value ? 0 : 1, TRANSITION_DURATION, Easing.OutQuint);
-            downloadProgressBar.FadeTo(downloadProgressBar.IsActive.Value ? 1 : 0, TRANSITION_DURATION, Easing.OutQuint);
+            bool showProgress = downloadTracker.State.Value == DownloadState.Downloading || downloadTracker.State.Value == DownloadState.Importing;
+
+            idleBottomContent.FadeTo(showProgress ? 0 : 1, TRANSITION_DURATION, Easing.OutQuint);
+            downloadProgressBar.FadeTo(showProgress ? 1 : 0, TRANSITION_DURATION, Easing.OutQuint);
         }
     }
 }
diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardDownloadProgressBar.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardDownloadProgressBar.cs
index 37a7e7d41d..a94900b0c7 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardDownloadProgressBar.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardDownloadProgressBar.cs
@@ -8,37 +8,33 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
 using osu.Game.Graphics;
 using osu.Game.Online;
-using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays;
 
 namespace osu.Game.Beatmaps.Drawables.Cards
 {
     public class BeatmapCardDownloadProgressBar : CompositeDrawable
     {
-        private readonly BindableBool isActive = new BindableBool();
-        public IBindable<bool> IsActive => isActive;
-
         public override bool IsPresent => true;
 
-        private readonly BeatmapDownloadTracker tracker;
-        private readonly CircularContainer background;
         private readonly CircularContainer foreground;
 
         private readonly Box backgroundFill;
         private readonly Box foregroundFill;
 
+        private readonly Bindable<DownloadState> state = new Bindable<DownloadState>();
+        private readonly BindableDouble progress = new BindableDouble();
+
         [Resolved]
         private OsuColour colours { get; set; }
 
         [Resolved]
         private OverlayColourProvider colourProvider { get; set; }
 
-        public BeatmapCardDownloadProgressBar(APIBeatmapSet beatmapSet)
+        public BeatmapCardDownloadProgressBar()
         {
             InternalChildren = new Drawable[]
             {
-                tracker = new BeatmapDownloadTracker(beatmapSet),
-                background = new CircularContainer
+                new CircularContainer
                 {
                     RelativeSizeAxes = Axes.Both,
                     Masking = true,
@@ -60,44 +56,40 @@ namespace osu.Game.Beatmaps.Drawables.Cards
         }
 
         [BackgroundDependencyLoader]
-        private void load()
+        private void load(BeatmapDownloadTracker downloadTracker)
         {
             backgroundFill.Colour = colourProvider.Background6;
+
+            ((IBindable<DownloadState>)state).BindTo(downloadTracker.State);
+            ((IBindable<double>)progress).BindTo(downloadTracker.Progress);
         }
 
         protected override void LoadComplete()
         {
             base.LoadComplete();
 
-            tracker.State.BindValueChanged(_ => stateChanged(), true);
-            tracker.Progress.BindValueChanged(_ => progressChanged(), true);
+            state.BindValueChanged(_ => stateChanged(), true);
+            progress.BindValueChanged(_ => progressChanged(), true);
         }
 
         private void stateChanged()
         {
-            switch (tracker.State.Value)
+            switch (state.Value)
             {
                 case DownloadState.Downloading:
                     FinishTransforms(true);
                     foregroundFill.Colour = colourProvider.Highlight1;
-                    isActive.Value = true;
                     break;
 
                 case DownloadState.Importing:
                     foregroundFill.FadeColour(colours.Yellow, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
-                    isActive.Value = true;
-                    break;
-
-                default:
-                    isActive.Value = false;
                     break;
             }
         }
 
         private void progressChanged()
         {
-            double progress = tracker.Progress.Value;
-            foreground.ResizeWidthTo((float)progress, progress > 0 ? BeatmapCard.TRANSITION_DURATION : 0, Easing.OutQuint);
+            foreground.ResizeWidthTo((float)progress.Value, progress.Value > 0 ? BeatmapCard.TRANSITION_DURATION : 0, Easing.OutQuint);
         }
     }
 }
diff --git a/osu.Game/Beatmaps/Drawables/Cards/Buttons/DownloadButton.cs b/osu.Game/Beatmaps/Drawables/Cards/Buttons/DownloadButton.cs
index 85e2988614..0e6d63830c 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/Buttons/DownloadButton.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/Buttons/DownloadButton.cs
@@ -21,7 +21,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards.Buttons
     {
         protected readonly DownloadIcon Download;
         protected readonly PlayIcon Play;
-        protected readonly BeatmapDownloadTracker Tracker;
+        protected readonly Bindable<DownloadState> State = new Bindable<DownloadState>();
 
         [Resolved]
         private OsuColour colours { get; set; } = null!;
@@ -37,27 +37,32 @@ namespace osu.Game.Beatmaps.Drawables.Cards.Buttons
 
             InternalChildren = new Drawable[]
             {
-                Tracker = new BeatmapDownloadTracker(beatmapSet),
                 Download = new DownloadIcon(beatmapSet),
                 Play = new PlayIcon(beatmapSet)
             };
         }
 
+        [BackgroundDependencyLoader(true)]
+        private void load(BeatmapDownloadTracker? tracker)
+        {
+            if (tracker != null)
+                ((IBindable<DownloadState>)State).BindTo(tracker.State);
+        }
+
         protected override void LoadComplete()
         {
             base.LoadComplete();
 
-            Tracker.Progress.BindValueChanged(_ => updateState());
-            Tracker.State.BindValueChanged(_ => updateState(), true);
+            State.BindValueChanged(_ => updateState(), true);
             FinishTransforms(true);
         }
 
         private void updateState()
         {
-            Download.FadeTo(Tracker.State.Value != DownloadState.LocallyAvailable ? 1 : 0, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
-            Download.Enabled.Value = Tracker.State.Value == DownloadState.NotDownloaded;
+            Download.FadeTo(State.Value != DownloadState.LocallyAvailable ? 1 : 0, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
+            Download.Enabled.Value = State.Value == DownloadState.NotDownloaded;
 
-            Play.FadeTo(Tracker.State.Value == DownloadState.LocallyAvailable ? 1 : 0, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
+            Play.FadeTo(State.Value == DownloadState.LocallyAvailable ? 1 : 0, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
         }
 
         protected class DownloadIcon : BeatmapCardIconButton

From 9800cd490384bf41bebb1fe0d105e3a7c7ae4f16 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 13 Nov 2021 16:58:24 +0100
Subject: [PATCH 0993/5547] Add test coverage for sample control point piece
 operation

---
 ...estSceneHitObjectSamplePointAdjustments.cs | 139 ++++++++++++++++++
 .../Components/Timeline/SamplePointPiece.cs   |   6 +-
 2 files changed, 142 insertions(+), 3 deletions(-)
 create mode 100644 osu.Game.Tests/Visual/Editing/TestSceneHitObjectSamplePointAdjustments.cs

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneHitObjectSamplePointAdjustments.cs b/osu.Game.Tests/Visual/Editing/TestSceneHitObjectSamplePointAdjustments.cs
new file mode 100644
index 0000000000..24048e6052
--- /dev/null
+++ b/osu.Game.Tests/Visual/Editing/TestSceneHitObjectSamplePointAdjustments.cs
@@ -0,0 +1,139 @@
+// 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 Humanizer;
+using NUnit.Framework;
+using osu.Framework.Testing;
+using osu.Game.Beatmaps;
+using osu.Game.Beatmaps.ControlPoints;
+using osu.Game.Graphics.UserInterfaceV2;
+using osu.Game.Rulesets;
+using osu.Game.Rulesets.Osu;
+using osu.Game.Rulesets.Osu.Objects;
+using osu.Game.Rulesets.Osu.UI;
+using osu.Game.Screens.Edit.Compose.Components.Timeline;
+using osu.Game.Screens.Edit.Timing;
+using osu.Game.Tests.Beatmaps;
+using osuTK;
+using osuTK.Input;
+
+namespace osu.Game.Tests.Visual.Editing
+{
+    public class TestSceneHitObjectSamplePointAdjustments : EditorTestScene
+    {
+        protected override Ruleset CreateEditorRuleset() => new OsuRuleset();
+
+        protected override IBeatmap CreateBeatmap(RulesetInfo ruleset) => new TestBeatmap(ruleset, false);
+
+        public override void SetUpSteps()
+        {
+            base.SetUpSteps();
+
+            AddStep("add test objects", () =>
+            {
+                EditorBeatmap.Add(new HitCircle
+                {
+                    StartTime = 0,
+                    Position = (OsuPlayfield.BASE_SIZE - new Vector2(100, 0)) / 2,
+                    SampleControlPoint = new SampleControlPoint
+                    {
+                        SampleBank = "normal",
+                        SampleVolume = 80
+                    }
+                });
+
+                EditorBeatmap.Add(new HitCircle()
+                {
+                    StartTime = 500,
+                    Position = (OsuPlayfield.BASE_SIZE + new Vector2(100, 0)) / 2,
+                    SampleControlPoint = new SampleControlPoint
+                    {
+                        SampleBank = "soft",
+                        SampleVolume = 60
+                    }
+                });
+            });
+        }
+
+        [Test]
+        public void TestSingleSelection()
+        {
+            clickSamplePiece(0);
+            samplePopoverHasSingleBank("normal");
+            samplePopoverHasSingleVolume(80);
+
+            dismissPopover();
+
+            // select first object to ensure that sample pieces for unselected objects
+            // work independently from selection state.
+            AddStep("select first object", () => EditorBeatmap.SelectedHitObjects.Add(EditorBeatmap.HitObjects.First()));
+
+            clickSamplePiece(1);
+            samplePopoverHasSingleBank("soft");
+            samplePopoverHasSingleVolume(60);
+
+            setVolumeViaPopover(90);
+            hitObjectHasSampleVolume(1, 90);
+
+            setBankViaPopover("drum");
+            hitObjectHasSampleBank(1, "drum");
+        }
+
+        private void clickSamplePiece(int objectIndex) => AddStep($"click {objectIndex.ToOrdinalWords()} difficulty piece", () =>
+        {
+            var difficultyPiece = this.ChildrenOfType<SamplePointPiece>().Single(piece => piece.HitObject == EditorBeatmap.HitObjects.ElementAt(objectIndex));
+
+            InputManager.MoveMouseTo(difficultyPiece);
+            InputManager.Click(MouseButton.Left);
+        });
+
+        private void samplePopoverHasSingleVolume(int volume) => AddUntilStep($"sample popover has volume {volume}", () =>
+        {
+            var popover = this.ChildrenOfType<SamplePointPiece.SampleEditPopover>().SingleOrDefault();
+            var slider = popover?.ChildrenOfType<SliderWithTextBoxInput<int>>().Single();
+
+            return slider?.Current.Value == volume;
+        });
+
+        private void samplePopoverHasSingleBank(string bank) => AddUntilStep($"sample popover has bank {bank}", () =>
+        {
+            var popover = this.ChildrenOfType<SamplePointPiece.SampleEditPopover>().SingleOrDefault();
+            var textBox = popover?.ChildrenOfType<LabelledTextBox>().First();
+
+            return textBox?.Current.Value == bank;
+        });
+
+        private void dismissPopover()
+        {
+            AddStep("dismiss popover", () => InputManager.Key(Key.Escape));
+            AddUntilStep("wait for dismiss", () => !this.ChildrenOfType<DifficultyPointPiece.DifficultyEditPopover>().Any(popover => popover.IsPresent));
+        }
+
+        private void setVolumeViaPopover(int volume) => AddStep($"set volume {volume} via popover", () =>
+        {
+            var popover = this.ChildrenOfType<SamplePointPiece.SampleEditPopover>().Single();
+            var slider = popover.ChildrenOfType<SliderWithTextBoxInput<int>>().Single();
+            slider.Current.Value = volume;
+        });
+
+        private void hitObjectHasSampleVolume(int objectIndex, int volume) => AddAssert($"{objectIndex.ToOrdinalWords()} has volume {volume}", () =>
+        {
+            var h = EditorBeatmap.HitObjects.ElementAt(objectIndex);
+            return h.SampleControlPoint.SampleVolume == volume;
+        });
+
+        private void setBankViaPopover(string bank) => AddStep($"set bank {bank} via popover", () =>
+        {
+            var popover = this.ChildrenOfType<SamplePointPiece.SampleEditPopover>().Single();
+            var textBox = popover.ChildrenOfType<LabelledTextBox>().First();
+            textBox.Current.Value = bank;
+        });
+
+        private void hitObjectHasSampleBank(int objectIndex, string bank) => AddAssert($"{objectIndex.ToOrdinalWords()} has bank {bank}", () =>
+        {
+            var h = EditorBeatmap.HitObjects.ElementAt(objectIndex);
+            return h.SampleControlPoint.SampleBank == bank;
+        });
+    }
+}
diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/SamplePointPiece.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/SamplePointPiece.cs
index 6a26f69e41..6250a9ccb8 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/SamplePointPiece.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/SamplePointPiece.cs
@@ -19,7 +19,7 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
 {
     public class SamplePointPiece : HitObjectPointPiece, IHasPopover
     {
-        private readonly HitObject hitObject;
+        public readonly HitObject HitObject;
 
         private readonly Bindable<string> bank;
         private readonly BindableNumber<int> volume;
@@ -27,7 +27,7 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
         public SamplePointPiece(HitObject hitObject)
             : base(hitObject.SampleControlPoint)
         {
-            this.hitObject = hitObject;
+            HitObject = hitObject;
             volume = hitObject.SampleControlPoint.SampleVolumeBindable.GetBoundCopy();
             bank = hitObject.SampleControlPoint.SampleBankBindable.GetBoundCopy();
         }
@@ -50,7 +50,7 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
             Label.Text = $"{bank.Value} {volume.Value}";
         }
 
-        public Popover GetPopover() => new SampleEditPopover(hitObject);
+        public Popover GetPopover() => new SampleEditPopover(HitObject);
 
         public class SampleEditPopover : OsuPopover
         {

From 6ba154129bdae1037e4a3ae305020b0193e949b6 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 13 Nov 2021 17:02:55 +0100
Subject: [PATCH 0994/5547] Add failing test coverage for setting sample volume
 on multiple objects

---
 ...estSceneHitObjectSamplePointAdjustments.cs | 48 +++++++++++++++++++
 1 file changed, 48 insertions(+)

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneHitObjectSamplePointAdjustments.cs b/osu.Game.Tests/Visual/Editing/TestSceneHitObjectSamplePointAdjustments.cs
index 24048e6052..0c4056e90c 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneHitObjectSamplePointAdjustments.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneHitObjectSamplePointAdjustments.cs
@@ -80,6 +80,46 @@ namespace osu.Game.Tests.Visual.Editing
             hitObjectHasSampleBank(1, "drum");
         }
 
+        [Test]
+        public void TestMultipleSelectionWithSameSampleVolume()
+        {
+            AddStep("unify sample volume", () =>
+            {
+                foreach (var h in EditorBeatmap.HitObjects)
+                    h.SampleControlPoint.SampleVolume = 50;
+            });
+
+            AddStep("select both objects", () => EditorBeatmap.SelectedHitObjects.AddRange(EditorBeatmap.HitObjects));
+            clickSamplePiece(0);
+            samplePopoverHasSingleVolume(50);
+
+            dismissPopover();
+
+            clickSamplePiece(1);
+            samplePopoverHasSingleVolume(50);
+
+            setVolumeViaPopover(75);
+            hitObjectHasSampleVolume(0, 75);
+            hitObjectHasSampleVolume(1, 75);
+        }
+
+        [Test]
+        public void TestMultipleSelectionWithDifferentSampleVolume()
+        {
+            AddStep("select both objects", () => EditorBeatmap.SelectedHitObjects.AddRange(EditorBeatmap.HitObjects));
+            clickSamplePiece(0);
+            samplePopoverHasIndeterminateVolume();
+
+            dismissPopover();
+
+            clickSamplePiece(1);
+            samplePopoverHasIndeterminateVolume();
+
+            setVolumeViaPopover(30);
+            hitObjectHasSampleVolume(0, 30);
+            hitObjectHasSampleVolume(1, 30);
+        }
+
         private void clickSamplePiece(int objectIndex) => AddStep($"click {objectIndex.ToOrdinalWords()} difficulty piece", () =>
         {
             var difficultyPiece = this.ChildrenOfType<SamplePointPiece>().Single(piece => piece.HitObject == EditorBeatmap.HitObjects.ElementAt(objectIndex));
@@ -96,6 +136,14 @@ namespace osu.Game.Tests.Visual.Editing
             return slider?.Current.Value == volume;
         });
 
+        private void samplePopoverHasIndeterminateVolume() => AddUntilStep($"sample popover has indeterminate volume", () =>
+        {
+            var popover = this.ChildrenOfType<SamplePointPiece.SampleEditPopover>().SingleOrDefault();
+            var slider = popover?.ChildrenOfType<SliderWithTextBoxInput<int>>().Single();
+
+            return slider != null && slider.Current.Value == null;
+        });
+
         private void samplePopoverHasSingleBank(string bank) => AddUntilStep($"sample popover has bank {bank}", () =>
         {
             var popover = this.ChildrenOfType<SamplePointPiece.SampleEditPopover>().SingleOrDefault();

From 9cf45e418ab78da6e12dd40665777a285cd88269 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 13 Nov 2021 17:07:19 +0100
Subject: [PATCH 0995/5547] Add failing test coverage for setting sample bank
 on multiple objects

---
 ...estSceneHitObjectSamplePointAdjustments.cs | 48 +++++++++++++++++++
 1 file changed, 48 insertions(+)

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneHitObjectSamplePointAdjustments.cs b/osu.Game.Tests/Visual/Editing/TestSceneHitObjectSamplePointAdjustments.cs
index 0c4056e90c..5b2b6fc780 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneHitObjectSamplePointAdjustments.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneHitObjectSamplePointAdjustments.cs
@@ -120,6 +120,46 @@ namespace osu.Game.Tests.Visual.Editing
             hitObjectHasSampleVolume(1, 30);
         }
 
+        [Test]
+        public void TestMultipleSelectionWithSameSampleBank()
+        {
+            AddStep("unify sample bank", () =>
+            {
+                foreach (var h in EditorBeatmap.HitObjects)
+                    h.SampleControlPoint.SampleBank = "soft";
+            });
+
+            AddStep("select both objects", () => EditorBeatmap.SelectedHitObjects.AddRange(EditorBeatmap.HitObjects));
+            clickSamplePiece(0);
+            samplePopoverHasSingleBank("soft");
+
+            dismissPopover();
+
+            clickSamplePiece(1);
+            samplePopoverHasSingleBank("soft");
+
+            setBankViaPopover("drum");
+            hitObjectHasSampleBank(0, "drum");
+            hitObjectHasSampleBank(1, "drum");
+        }
+
+        [Test]
+        public void TestMultipleSelectionWithDifferentSampleBank()
+        {
+            AddStep("select both objects", () => EditorBeatmap.SelectedHitObjects.AddRange(EditorBeatmap.HitObjects));
+            clickSamplePiece(0);
+            samplePopoverHasIndeterminateBank();
+
+            dismissPopover();
+
+            clickSamplePiece(1);
+            samplePopoverHasIndeterminateBank();
+
+            setBankViaPopover("normal");
+            hitObjectHasSampleBank(0, "normal");
+            hitObjectHasSampleBank(1, "normal");
+        }
+
         private void clickSamplePiece(int objectIndex) => AddStep($"click {objectIndex.ToOrdinalWords()} difficulty piece", () =>
         {
             var difficultyPiece = this.ChildrenOfType<SamplePointPiece>().Single(piece => piece.HitObject == EditorBeatmap.HitObjects.ElementAt(objectIndex));
@@ -152,6 +192,14 @@ namespace osu.Game.Tests.Visual.Editing
             return textBox?.Current.Value == bank;
         });
 
+        private void samplePopoverHasIndeterminateBank() => AddUntilStep($"sample popover has indeterminate bank", () =>
+        {
+            var popover = this.ChildrenOfType<SamplePointPiece.SampleEditPopover>().SingleOrDefault();
+            var textBox = popover?.ChildrenOfType<LabelledTextBox>().First();
+
+            return textBox != null && textBox.Current.Value == null;
+        });
+
         private void dismissPopover()
         {
             AddStep("dismiss popover", () => InputManager.Key(Key.Escape));

From 3fee6b0938261e62654a1b1e8ab677d68653e524 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 13 Nov 2021 17:21:48 +0100
Subject: [PATCH 0996/5547] Add support for setting sample bank & volume for
 multiple objects at once

---
 ...estSceneHitObjectSamplePointAdjustments.cs | 10 +--
 .../Components/Timeline/SamplePointPiece.cs   | 71 +++++++++++++++----
 2 files changed, 63 insertions(+), 18 deletions(-)

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneHitObjectSamplePointAdjustments.cs b/osu.Game.Tests/Visual/Editing/TestSceneHitObjectSamplePointAdjustments.cs
index 5b2b6fc780..f30c56d53c 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneHitObjectSamplePointAdjustments.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneHitObjectSamplePointAdjustments.cs
@@ -171,15 +171,15 @@ namespace osu.Game.Tests.Visual.Editing
         private void samplePopoverHasSingleVolume(int volume) => AddUntilStep($"sample popover has volume {volume}", () =>
         {
             var popover = this.ChildrenOfType<SamplePointPiece.SampleEditPopover>().SingleOrDefault();
-            var slider = popover?.ChildrenOfType<SliderWithTextBoxInput<int>>().Single();
+            var slider = popover?.ChildrenOfType<IndeterminateSliderWithTextBoxInput<int>>().Single();
 
             return slider?.Current.Value == volume;
         });
 
-        private void samplePopoverHasIndeterminateVolume() => AddUntilStep($"sample popover has indeterminate volume", () =>
+        private void samplePopoverHasIndeterminateVolume() => AddUntilStep("sample popover has indeterminate volume", () =>
         {
             var popover = this.ChildrenOfType<SamplePointPiece.SampleEditPopover>().SingleOrDefault();
-            var slider = popover?.ChildrenOfType<SliderWithTextBoxInput<int>>().Single();
+            var slider = popover?.ChildrenOfType<IndeterminateSliderWithTextBoxInput<int>>().Single();
 
             return slider != null && slider.Current.Value == null;
         });
@@ -197,7 +197,7 @@ namespace osu.Game.Tests.Visual.Editing
             var popover = this.ChildrenOfType<SamplePointPiece.SampleEditPopover>().SingleOrDefault();
             var textBox = popover?.ChildrenOfType<LabelledTextBox>().First();
 
-            return textBox != null && textBox.Current.Value == null;
+            return textBox != null && string.IsNullOrEmpty(textBox.Current.Value);
         });
 
         private void dismissPopover()
@@ -209,7 +209,7 @@ namespace osu.Game.Tests.Visual.Editing
         private void setVolumeViaPopover(int volume) => AddStep($"set volume {volume} via popover", () =>
         {
             var popover = this.ChildrenOfType<SamplePointPiece.SampleEditPopover>().Single();
-            var slider = popover.ChildrenOfType<SliderWithTextBoxInput<int>>().Single();
+            var slider = popover.ChildrenOfType<IndeterminateSliderWithTextBoxInput<int>>().Single();
             slider.Current.Value = volume;
         });
 
diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/SamplePointPiece.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/SamplePointPiece.cs
index 6250a9ccb8..f0b11ce96e 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/SamplePointPiece.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/SamplePointPiece.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.
 
+#nullable enable
+
+using System.Collections.Generic;
+using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Extensions;
+using osu.Framework.Extensions.IEnumerableExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Cursor;
@@ -55,18 +60,16 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
         public class SampleEditPopover : OsuPopover
         {
             private readonly HitObject hitObject;
-            private readonly SampleControlPoint point;
 
-            private LabelledTextBox bank;
-            private SliderWithTextBoxInput<int> volume;
+            private LabelledTextBox bank = null!;
+            private IndeterminateSliderWithTextBoxInput<int> volume = null!;
 
             [Resolved(canBeNull: true)]
-            private EditorBeatmap beatmap { get; set; }
+            private EditorBeatmap beatmap { get; set; } = null!;
 
             public SampleEditPopover(HitObject hitObject)
             {
                 this.hitObject = hitObject;
-                point = hitObject.SampleControlPoint;
             }
 
             [BackgroundDependencyLoader]
@@ -85,19 +88,61 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
                             {
                                 Label = "Bank Name",
                             },
-                            volume = new SliderWithTextBoxInput<int>("Volume")
-                            {
-                                Current = new SampleControlPoint().SampleVolumeBindable,
-                            }
+                            volume = new IndeterminateSliderWithTextBoxInput<int>("Volume", new SampleControlPoint().SampleVolumeBindable)
                         }
                     }
                 };
 
-                bank.Current = point.SampleBankBindable;
-                bank.Current.BindValueChanged(_ => beatmap.Update(hitObject));
+                // if the piece belongs to a currently selected object, assume that the user wants to change all selected objects.
+                // if the piece belongs to an unselected object, operate on that object alone, independently of the selection.
+                var relevantObjects = (beatmap.SelectedHitObjects.Contains(hitObject) ? beatmap.SelectedHitObjects : hitObject.Yield()).ToArray();
+                var relevantControlPoints = relevantObjects.Select(h => h.SampleControlPoint).ToArray();
 
-                volume.Current = point.SampleVolumeBindable;
-                volume.Current.BindValueChanged(_ => beatmap.Update(hitObject));
+                // even if there are multiple objects selected, we can still display sample volume or bank if they all have the same value.
+                string? commonBank = relevantControlPoints.Select(point => point.SampleBank).Distinct().Count() == 1 ? relevantControlPoints.First().SampleBank : null;
+
+                if (!string.IsNullOrEmpty(commonBank))
+                    bank.Current.Value = commonBank;
+
+                int? commonVolume = relevantControlPoints.Select(point => point.SampleVolume).Distinct().Count() == 1 ? (int?)relevantControlPoints.First().SampleVolume : null;
+
+                if (commonVolume != null)
+                    volume.Current.Value = commonVolume.Value;
+
+                bank.Current.BindValueChanged(val => updateBankFor(relevantObjects, val.NewValue));
+                volume.Current.BindValueChanged(val => updateVolumeFor(relevantObjects, val.NewValue));
+            }
+
+            private void updateBankFor(IEnumerable<HitObject> objects, string? newBank)
+            {
+                if (string.IsNullOrEmpty(newBank))
+                    return;
+
+                beatmap.BeginChange();
+
+                foreach (var h in objects)
+                {
+                    h.SampleControlPoint.SampleBank = newBank;
+                    beatmap.Update(h);
+                }
+
+                beatmap.EndChange();
+            }
+
+            private void updateVolumeFor(IEnumerable<HitObject> objects, int? newVolume)
+            {
+                if (newVolume == null)
+                    return;
+
+                beatmap.BeginChange();
+
+                foreach (var h in objects)
+                {
+                    h.SampleControlPoint.SampleVolume = newVolume.Value;
+                    beatmap.Update(h);
+                }
+
+                beatmap.EndChange();
             }
         }
     }

From 76baf08140b4ae9971a44c9443f5b780a3d7ecef Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 13 Nov 2021 17:43:33 +0100
Subject: [PATCH 0997/5547] Expand test coverage with desired bank text box
 placeholder behaviour

---
 ...estSceneHitObjectSamplePointAdjustments.cs | 25 ++++++++++++++-----
 1 file changed, 19 insertions(+), 6 deletions(-)

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneHitObjectSamplePointAdjustments.cs b/osu.Game.Tests/Visual/Editing/TestSceneHitObjectSamplePointAdjustments.cs
index f30c56d53c..460b608166 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneHitObjectSamplePointAdjustments.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneHitObjectSamplePointAdjustments.cs
@@ -7,6 +7,7 @@ using NUnit.Framework;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.ControlPoints;
+using osu.Game.Graphics.UserInterface;
 using osu.Game.Graphics.UserInterfaceV2;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Osu;
@@ -43,7 +44,7 @@ namespace osu.Game.Tests.Visual.Editing
                     }
                 });
 
-                EditorBeatmap.Add(new HitCircle()
+                EditorBeatmap.Add(new HitCircle
                 {
                     StartTime = 500,
                     Position = (OsuPlayfield.BASE_SIZE + new Vector2(100, 0)) / 2,
@@ -138,9 +139,15 @@ namespace osu.Game.Tests.Visual.Editing
             clickSamplePiece(1);
             samplePopoverHasSingleBank("soft");
 
+            setBankViaPopover(string.Empty);
+            hitObjectHasSampleBank(0, "soft");
+            hitObjectHasSampleBank(1, "soft");
+            samplePopoverHasSingleBank("soft");
+
             setBankViaPopover("drum");
             hitObjectHasSampleBank(0, "drum");
             hitObjectHasSampleBank(1, "drum");
+            samplePopoverHasSingleBank("drum");
         }
 
         [Test]
@@ -155,9 +162,15 @@ namespace osu.Game.Tests.Visual.Editing
             clickSamplePiece(1);
             samplePopoverHasIndeterminateBank();
 
+            setBankViaPopover(string.Empty);
+            hitObjectHasSampleBank(0, "normal");
+            hitObjectHasSampleBank(1, "soft");
+            samplePopoverHasIndeterminateBank();
+
             setBankViaPopover("normal");
             hitObjectHasSampleBank(0, "normal");
             hitObjectHasSampleBank(1, "normal");
+            samplePopoverHasSingleBank("normal");
         }
 
         private void clickSamplePiece(int objectIndex) => AddStep($"click {objectIndex.ToOrdinalWords()} difficulty piece", () =>
@@ -187,17 +200,17 @@ namespace osu.Game.Tests.Visual.Editing
         private void samplePopoverHasSingleBank(string bank) => AddUntilStep($"sample popover has bank {bank}", () =>
         {
             var popover = this.ChildrenOfType<SamplePointPiece.SampleEditPopover>().SingleOrDefault();
-            var textBox = popover?.ChildrenOfType<LabelledTextBox>().First();
+            var textBox = popover?.ChildrenOfType<OsuTextBox>().First();
 
-            return textBox?.Current.Value == bank;
+            return textBox?.Current.Value == bank && string.IsNullOrEmpty(textBox?.PlaceholderText.ToString());
         });
 
-        private void samplePopoverHasIndeterminateBank() => AddUntilStep($"sample popover has indeterminate bank", () =>
+        private void samplePopoverHasIndeterminateBank() => AddUntilStep("sample popover has indeterminate bank", () =>
         {
             var popover = this.ChildrenOfType<SamplePointPiece.SampleEditPopover>().SingleOrDefault();
-            var textBox = popover?.ChildrenOfType<LabelledTextBox>().First();
+            var textBox = popover?.ChildrenOfType<OsuTextBox>().First();
 
-            return textBox != null && string.IsNullOrEmpty(textBox.Current.Value);
+            return textBox != null && string.IsNullOrEmpty(textBox.Current.Value) && !string.IsNullOrEmpty(textBox.PlaceholderText.ToString());
         });
 
         private void dismissPopover()

From 73ca1d39a2fbaeef88ad13ebc7904027eece8d5a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 13 Nov 2021 18:06:32 +0100
Subject: [PATCH 0998/5547] Improve sample bank text box UX in case of multiple
 selection

---
 ...estSceneHitObjectSamplePointAdjustments.cs |  4 +++
 .../Components/Timeline/SamplePointPiece.cs   | 26 +++++++++++++++----
 2 files changed, 25 insertions(+), 5 deletions(-)

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneHitObjectSamplePointAdjustments.cs b/osu.Game.Tests/Visual/Editing/TestSceneHitObjectSamplePointAdjustments.cs
index 460b608166..dca30a6fc0 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneHitObjectSamplePointAdjustments.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneHitObjectSamplePointAdjustments.cs
@@ -237,6 +237,10 @@ namespace osu.Game.Tests.Visual.Editing
             var popover = this.ChildrenOfType<SamplePointPiece.SampleEditPopover>().Single();
             var textBox = popover.ChildrenOfType<LabelledTextBox>().First();
             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);
+            InputManager.Key(Key.Enter);
         });
 
         private void hitObjectHasSampleBank(int objectIndex, string bank) => AddAssert($"{objectIndex.ToOrdinalWords()} has bank {bank}", () =>
diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/SamplePointPiece.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/SamplePointPiece.cs
index f0b11ce96e..fbbbb153b9 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/SamplePointPiece.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/SamplePointPiece.cs
@@ -99,20 +99,30 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
                 var relevantControlPoints = relevantObjects.Select(h => h.SampleControlPoint).ToArray();
 
                 // even if there are multiple objects selected, we can still display sample volume or bank if they all have the same value.
-                string? commonBank = relevantControlPoints.Select(point => point.SampleBank).Distinct().Count() == 1 ? relevantControlPoints.First().SampleBank : null;
-
+                string? commonBank = getCommonBank(relevantControlPoints);
                 if (!string.IsNullOrEmpty(commonBank))
                     bank.Current.Value = commonBank;
 
-                int? commonVolume = relevantControlPoints.Select(point => point.SampleVolume).Distinct().Count() == 1 ? (int?)relevantControlPoints.First().SampleVolume : null;
-
+                int? commonVolume = getCommonVolume(relevantControlPoints);
                 if (commonVolume != null)
                     volume.Current.Value = commonVolume.Value;
 
-                bank.Current.BindValueChanged(val => updateBankFor(relevantObjects, val.NewValue));
+                updateBankPlaceholderText(relevantObjects);
+                bank.Current.BindValueChanged(val =>
+                {
+                    updateBankFor(relevantObjects, val.NewValue);
+                    updateBankPlaceholderText(relevantObjects);
+                });
+                // on commit, ensure that the value is correct by sourcing it from the objects' control points again.
+                // this ensures that committing empty text causes a revert to the previous value.
+                bank.OnCommit += (_, __) => bank.Current.Value = getCommonBank(relevantControlPoints);
+
                 volume.Current.BindValueChanged(val => updateVolumeFor(relevantObjects, val.NewValue));
             }
 
+            private static string? getCommonBank(SampleControlPoint[] relevantControlPoints) => relevantControlPoints.Select(point => point.SampleBank).Distinct().Count() == 1 ? relevantControlPoints.First().SampleBank : null;
+            private static int? getCommonVolume(SampleControlPoint[] relevantControlPoints) => relevantControlPoints.Select(point => point.SampleVolume).Distinct().Count() == 1 ? (int?)relevantControlPoints.First().SampleVolume : null;
+
             private void updateBankFor(IEnumerable<HitObject> objects, string? newBank)
             {
                 if (string.IsNullOrEmpty(newBank))
@@ -129,6 +139,12 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
                 beatmap.EndChange();
             }
 
+            private void updateBankPlaceholderText(IEnumerable<HitObject> objects)
+            {
+                string? commonBank = getCommonBank(objects.Select(h => h.SampleControlPoint).ToArray());
+                bank.PlaceholderText = string.IsNullOrEmpty(commonBank) ? "(multiple)" : null;
+            }
+
             private void updateVolumeFor(IEnumerable<HitObject> objects, int? newVolume)
             {
                 if (newVolume == null)

From 9a19a516f99cd62b4b2dc5d5baa76e982ca96bce Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 13 Nov 2021 18:09:40 +0100
Subject: [PATCH 0999/5547] Adjust spacings on sample point piece popover

---
 .../Edit/Compose/Components/Timeline/SamplePointPiece.cs        | 2 ++
 .../Screens/Edit/Timing/IndeterminateSliderWithTextBoxInput.cs  | 2 ++
 2 files changed, 4 insertions(+)

diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/SamplePointPiece.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/SamplePointPiece.cs
index fbbbb153b9..2cbfe88519 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/SamplePointPiece.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/SamplePointPiece.cs
@@ -19,6 +19,7 @@ using osu.Game.Graphics;
 using osu.Game.Graphics.UserInterfaceV2;
 using osu.Game.Rulesets.Objects;
 using osu.Game.Screens.Edit.Timing;
+using osuTK;
 
 namespace osu.Game.Screens.Edit.Compose.Components.Timeline
 {
@@ -82,6 +83,7 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
                         Width = 200,
                         Direction = FillDirection.Vertical,
                         AutoSizeAxes = Axes.Y,
+                        Spacing = new Vector2(0, 10),
                         Children = new Drawable[]
                         {
                             bank = new LabelledTextBox
diff --git a/osu.Game/Screens/Edit/Timing/IndeterminateSliderWithTextBoxInput.cs b/osu.Game/Screens/Edit/Timing/IndeterminateSliderWithTextBoxInput.cs
index 17f82f4978..14b8c4c9de 100644
--- a/osu.Game/Screens/Edit/Timing/IndeterminateSliderWithTextBoxInput.cs
+++ b/osu.Game/Screens/Edit/Timing/IndeterminateSliderWithTextBoxInput.cs
@@ -11,6 +11,7 @@ using osu.Framework.Localisation;
 using osu.Game.Graphics.UserInterfaceV2;
 using osu.Game.Overlays.Settings;
 using osu.Game.Utils;
+using osuTK;
 
 namespace osu.Game.Screens.Edit.Timing
 {
@@ -62,6 +63,7 @@ namespace osu.Game.Screens.Edit.Timing
                     RelativeSizeAxes = Axes.X,
                     AutoSizeAxes = Axes.Y,
                     Direction = FillDirection.Vertical,
+                    Spacing = new Vector2(0, 5),
                     Children = new Drawable[]
                     {
                         textbox = new LabelledTextBox

From ca239ca40a2913103958552d911342bb2abef98b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 12 Nov 2021 12:41:16 +0100
Subject: [PATCH 1000/5547] Add failing test case for sharing clock state with
 gameplay test

---
 .../Editing/TestSceneEditorTestGameplay.cs    | 30 +++++++++++++++++++
 1 file changed, 30 insertions(+)

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneEditorTestGameplay.cs b/osu.Game.Tests/Visual/Editing/TestSceneEditorTestGameplay.cs
index 1d572772eb..160af47a6d 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneEditorTestGameplay.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneEditorTestGameplay.cs
@@ -14,6 +14,7 @@ using osu.Game.Screens.Backgrounds;
 using osu.Game.Screens.Edit;
 using osu.Game.Screens.Edit.Components.Timelines.Summary;
 using osu.Game.Screens.Edit.GameplayTest;
+using osu.Game.Screens.Play;
 using osu.Game.Tests.Beatmaps.IO;
 using osuTK.Graphics;
 using osuTK.Input;
@@ -150,6 +151,35 @@ namespace osu.Game.Tests.Visual.Editing
             AddAssert("track stopped", () => !Beatmap.Value.Track.IsRunning);
         }
 
+        [Test]
+        public void TestSharedClockState()
+        {
+            AddStep("seek to 00:01:00", () => EditorClock.Seek(60_000));
+            AddStep("click test gameplay button", () =>
+            {
+                var button = Editor.ChildrenOfType<TestGameplayButton>().Single();
+
+                InputManager.MoveMouseTo(button);
+                InputManager.Click(MouseButton.Left);
+            });
+
+            EditorPlayer editorPlayer = null;
+            AddUntilStep("player pushed", () => (editorPlayer = Stack.CurrentScreen as EditorPlayer) != null);
+
+            GameplayClockContainer gameplayClockContainer = null;
+            AddStep("fetch gameplay clock", () => gameplayClockContainer = editorPlayer.ChildrenOfType<GameplayClockContainer>().First());
+            AddUntilStep("gameplay clock running", () => gameplayClockContainer.IsRunning);
+            AddAssert("gameplay time past 00:01:00", () => gameplayClockContainer.CurrentTime >= 60_000);
+
+            double timeAtPlayerExit = 0;
+            AddWaitStep("wait some", 5);
+            AddStep("store time before exit", () => timeAtPlayerExit = gameplayClockContainer.CurrentTime);
+
+            AddStep("exit player", () => editorPlayer.Exit());
+            AddUntilStep("current screen is editor", () => Stack.CurrentScreen is Editor);
+            AddAssert("time is past player exit", () => EditorClock.CurrentTime >= timeAtPlayerExit);
+        }
+
         public override void TearDownSteps()
         {
             base.TearDownSteps();

From d2ddc25ab3a7457bf2496e5a5216f29ba31b4c05 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 12 Nov 2021 12:50:38 +0100
Subject: [PATCH 1001/5547] Propagate clock state from editor to gameplay test

---
 osu.Game/Screens/Edit/Editor.cs               | 21 +++++++++++++------
 .../Screens/Edit/GameplayTest/EditorPlayer.cs | 15 +++++++++----
 .../Edit/GameplayTest/EditorPlayerLoader.cs   |  4 ++--
 3 files changed, 28 insertions(+), 12 deletions(-)

diff --git a/osu.Game/Screens/Edit/Editor.cs b/osu.Game/Screens/Edit/Editor.cs
index ab24391bb4..ff9a19434b 100644
--- a/osu.Game/Screens/Edit/Editor.cs
+++ b/osu.Game/Screens/Edit/Editor.cs
@@ -325,6 +325,19 @@ namespace osu.Game.Screens.Edit
         /// </summary>
         public void UpdateClockSource() => clock.ChangeSource(Beatmap.Value.Track);
 
+        /// <summary>
+        /// Creates an <see cref="EditorState"/> instance representing the current state of the editor.
+        /// </summary>
+        /// <param name="nextBeatmap">
+        /// The next beatmap to be shown, in the case of difficulty switch.
+        /// <see langword="null"/> indicates that the beatmap will not be changing.
+        /// </param>
+        private EditorState getState([CanBeNull] BeatmapInfo nextBeatmap = null) => new EditorState
+        {
+            Time = clock.CurrentTimeAccurate,
+            ClipboardContent = nextBeatmap == null || editorBeatmap.BeatmapInfo.RulesetID == nextBeatmap.RulesetID ? Clipboard.Content.Value : string.Empty
+        };
+
         /// <summary>
         /// Restore the editor to a provided state.
         /// </summary>
@@ -780,11 +793,7 @@ namespace osu.Game.Screens.Edit
             return new DifficultyMenuItem(beatmapInfo, isCurrentDifficulty, SwitchToDifficulty);
         }
 
-        protected void SwitchToDifficulty(BeatmapInfo nextBeatmap) => loader?.ScheduleDifficultySwitch(nextBeatmap, new EditorState
-        {
-            Time = clock.CurrentTimeAccurate,
-            ClipboardContent = editorBeatmap.BeatmapInfo.RulesetID == nextBeatmap.RulesetID ? Clipboard.Content.Value : string.Empty
-        });
+        protected void SwitchToDifficulty(BeatmapInfo nextBeatmap) => loader?.ScheduleDifficultySwitch(nextBeatmap, getState(nextBeatmap));
 
         private void cancelExit()
         {
@@ -807,7 +816,7 @@ namespace osu.Game.Screens.Edit
                 pushEditorPlayer();
             }
 
-            void pushEditorPlayer() => this.Push(new EditorPlayerLoader());
+            void pushEditorPlayer() => this.Push(new EditorPlayerLoader(getState()));
         }
 
         public double SnapTime(double time, double? referenceTime) => editorBeatmap.SnapTime(time, referenceTime);
diff --git a/osu.Game/Screens/Edit/GameplayTest/EditorPlayer.cs b/osu.Game/Screens/Edit/GameplayTest/EditorPlayer.cs
index 9856ad62bb..266c5e81d4 100644
--- a/osu.Game/Screens/Edit/GameplayTest/EditorPlayer.cs
+++ b/osu.Game/Screens/Edit/GameplayTest/EditorPlayer.cs
@@ -3,6 +3,7 @@
 
 using osu.Framework.Allocation;
 using osu.Framework.Screens;
+using osu.Game.Beatmaps;
 using osu.Game.Overlays;
 using osu.Game.Screens.Play;
 
@@ -10,14 +11,20 @@ namespace osu.Game.Screens.Edit.GameplayTest
 {
     public class EditorPlayer : Player
     {
-        public EditorPlayer()
-            : base(new PlayerConfiguration { ShowResults = false })
-        {
-        }
+        private readonly EditorState editorState;
 
         [Resolved]
         private MusicController musicController { get; set; }
 
+        public EditorPlayer(EditorState editorState)
+            : base(new PlayerConfiguration { ShowResults = false })
+        {
+            this.editorState = editorState;
+        }
+
+        protected override GameplayClockContainer CreateGameplayClockContainer(WorkingBeatmap beatmap, double gameplayStart)
+            => new MasterGameplayClockContainer(beatmap, editorState.Time, true);
+
         protected override void LoadComplete()
         {
             base.LoadComplete();
diff --git a/osu.Game/Screens/Edit/GameplayTest/EditorPlayerLoader.cs b/osu.Game/Screens/Edit/GameplayTest/EditorPlayerLoader.cs
index 610fff70f2..5c2ab04fd7 100644
--- a/osu.Game/Screens/Edit/GameplayTest/EditorPlayerLoader.cs
+++ b/osu.Game/Screens/Edit/GameplayTest/EditorPlayerLoader.cs
@@ -14,8 +14,8 @@ namespace osu.Game.Screens.Edit.GameplayTest
         [Resolved]
         private OsuLogo osuLogo { get; set; }
 
-        public EditorPlayerLoader()
-            : base(() => new EditorPlayer())
+        public EditorPlayerLoader(EditorState editorState)
+            : base(() => new EditorPlayer(editorState))
         {
         }
 

From 2562412125e974efc2c89a4b4b31daa2070aa589 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 12 Nov 2021 13:12:25 +0100
Subject: [PATCH 1002/5547] Propagate clock state from gameplay test back to
 editor

---
 osu.Game/Screens/Edit/Editor.cs                          | 6 +++---
 osu.Game/Screens/Edit/GameplayTest/EditorPlayer.cs       | 9 +++++++--
 osu.Game/Screens/Edit/GameplayTest/EditorPlayerLoader.cs | 4 ++--
 3 files changed, 12 insertions(+), 7 deletions(-)

diff --git a/osu.Game/Screens/Edit/Editor.cs b/osu.Game/Screens/Edit/Editor.cs
index ff9a19434b..2a7e2c9cef 100644
--- a/osu.Game/Screens/Edit/Editor.cs
+++ b/osu.Game/Screens/Edit/Editor.cs
@@ -332,7 +332,7 @@ namespace osu.Game.Screens.Edit
         /// The next beatmap to be shown, in the case of difficulty switch.
         /// <see langword="null"/> indicates that the beatmap will not be changing.
         /// </param>
-        private EditorState getState([CanBeNull] BeatmapInfo nextBeatmap = null) => new EditorState
+        public EditorState GetState([CanBeNull] BeatmapInfo nextBeatmap = null) => new EditorState
         {
             Time = clock.CurrentTimeAccurate,
             ClipboardContent = nextBeatmap == null || editorBeatmap.BeatmapInfo.RulesetID == nextBeatmap.RulesetID ? Clipboard.Content.Value : string.Empty
@@ -793,7 +793,7 @@ namespace osu.Game.Screens.Edit
             return new DifficultyMenuItem(beatmapInfo, isCurrentDifficulty, SwitchToDifficulty);
         }
 
-        protected void SwitchToDifficulty(BeatmapInfo nextBeatmap) => loader?.ScheduleDifficultySwitch(nextBeatmap, getState(nextBeatmap));
+        protected void SwitchToDifficulty(BeatmapInfo nextBeatmap) => loader?.ScheduleDifficultySwitch(nextBeatmap, GetState(nextBeatmap));
 
         private void cancelExit()
         {
@@ -816,7 +816,7 @@ namespace osu.Game.Screens.Edit
                 pushEditorPlayer();
             }
 
-            void pushEditorPlayer() => this.Push(new EditorPlayerLoader(getState()));
+            void pushEditorPlayer() => this.Push(new EditorPlayerLoader(this));
         }
 
         public double SnapTime(double time, double? referenceTime) => editorBeatmap.SnapTime(time, referenceTime);
diff --git a/osu.Game/Screens/Edit/GameplayTest/EditorPlayer.cs b/osu.Game/Screens/Edit/GameplayTest/EditorPlayer.cs
index 266c5e81d4..479dc2e6b3 100644
--- a/osu.Game/Screens/Edit/GameplayTest/EditorPlayer.cs
+++ b/osu.Game/Screens/Edit/GameplayTest/EditorPlayer.cs
@@ -11,15 +11,17 @@ namespace osu.Game.Screens.Edit.GameplayTest
 {
     public class EditorPlayer : Player
     {
+        private readonly Editor editor;
         private readonly EditorState editorState;
 
         [Resolved]
         private MusicController musicController { get; set; }
 
-        public EditorPlayer(EditorState editorState)
+        public EditorPlayer(Editor editor)
             : base(new PlayerConfiguration { ShowResults = false })
         {
-            this.editorState = editorState;
+            this.editor = editor;
+            editorState = editor.GetState();
         }
 
         protected override GameplayClockContainer CreateGameplayClockContainer(WorkingBeatmap beatmap, double gameplayStart)
@@ -45,6 +47,9 @@ namespace osu.Game.Screens.Edit.GameplayTest
         public override bool OnExiting(IScreen next)
         {
             musicController.Stop();
+
+            editorState.Time = GameplayClockContainer.CurrentTime;
+            editor.RestoreState(editorState);
             return base.OnExiting(next);
         }
     }
diff --git a/osu.Game/Screens/Edit/GameplayTest/EditorPlayerLoader.cs b/osu.Game/Screens/Edit/GameplayTest/EditorPlayerLoader.cs
index 5c2ab04fd7..addc79ba61 100644
--- a/osu.Game/Screens/Edit/GameplayTest/EditorPlayerLoader.cs
+++ b/osu.Game/Screens/Edit/GameplayTest/EditorPlayerLoader.cs
@@ -14,8 +14,8 @@ namespace osu.Game.Screens.Edit.GameplayTest
         [Resolved]
         private OsuLogo osuLogo { get; set; }
 
-        public EditorPlayerLoader(EditorState editorState)
-            : base(() => new EditorPlayer(editorState))
+        public EditorPlayerLoader(Editor editor)
+            : base(() => new EditorPlayer(editor))
         {
         }
 

From 6b4b6de5545f16762a8a63fdeb011ed6e95ee093 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 12 Nov 2021 13:51:02 +0100
Subject: [PATCH 1003/5547] Fix test gameplay starting in a hidden state

---
 osu.Game/Screens/Edit/GameplayTest/EditorPlayer.cs | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/osu.Game/Screens/Edit/GameplayTest/EditorPlayer.cs b/osu.Game/Screens/Edit/GameplayTest/EditorPlayer.cs
index 479dc2e6b3..f49603c754 100644
--- a/osu.Game/Screens/Edit/GameplayTest/EditorPlayer.cs
+++ b/osu.Game/Screens/Edit/GameplayTest/EditorPlayer.cs
@@ -44,6 +44,16 @@ namespace osu.Game.Screens.Edit.GameplayTest
 
         protected override bool CheckModsAllowFailure() => false; // never fail.
 
+        public override void OnEntering(IScreen last)
+        {
+            base.OnEntering(last);
+
+            // finish alpha transforms on entering to avoid gameplay starting in a half-hidden state.
+            // the finish calls are purposefully not propagated to children to avoid messing up their state.
+            FinishTransforms();
+            GameplayClockContainer.FinishTransforms(false, nameof(Alpha));
+        }
+
         public override bool OnExiting(IScreen next)
         {
             musicController.Stop();

From 5be22916bb80ca652099369e6a69b2cee955fca5 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 14 Nov 2021 14:26:18 +0900
Subject: [PATCH 1004/5547] Add test coverage against frequency ramp increasing
 between fail animation and fail screen

---
 .../Visual/Gameplay/TestSceneFailAnimation.cs | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneFailAnimation.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneFailAnimation.cs
index 36fc6812bd..7167d3120a 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneFailAnimation.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneFailAnimation.cs
@@ -31,12 +31,18 @@ namespace osu.Game.Tests.Visual.Gameplay
         {
             AddUntilStep("wait for fail", () => Player.HasFailed);
             AddUntilStep("wait for fail overlay", () => ((FailPlayer)Player).FailOverlay.State.Value == Visibility.Visible);
+
+            // The pause screen and fail animation both ramp frequency.
+            // This tests to ensure that it doesn't reset during that handoff.
+            AddAssert("frequency only ever decreased", () => !((FailPlayer)Player).FrequencyIncreased);
         }
 
         private class FailPlayer : TestPlayer
         {
             public new FailOverlay FailOverlay => base.FailOverlay;
 
+            public bool FrequencyIncreased { get; private set; }
+
             public FailPlayer()
                 : base(false, false)
             {
@@ -47,6 +53,19 @@ namespace osu.Game.Tests.Visual.Gameplay
                 base.LoadComplete();
                 HealthProcessor.FailConditions += (_, __) => true;
             }
+
+            private double lastFrequency = double.MaxValue;
+
+            protected override void Update()
+            {
+                base.Update();
+
+                double freq = Beatmap.Value.Track.AggregateFrequency.Value;
+
+                FrequencyIncreased |= freq > lastFrequency;
+
+                lastFrequency = freq;
+            }
         }
     }
 }

From a4aa0087934c54b7dec27a833a83da6c7f692233 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 14 Nov 2021 14:13:12 +0900
Subject: [PATCH 1005/5547] Fix frequency ramping a second time incorrectly
 after fail

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

diff --git a/osu.Game/Screens/Play/FailAnimation.cs b/osu.Game/Screens/Play/FailAnimation.cs
index f3676baf80..193e1e4129 100644
--- a/osu.Game/Screens/Play/FailAnimation.cs
+++ b/osu.Game/Screens/Play/FailAnimation.cs
@@ -107,7 +107,8 @@ namespace osu.Game.Screens.Play
 
             this.TransformBindableTo(trackFreq, 0, duration).OnComplete(_ =>
             {
-                RemoveFilters();
+                // Don't reset frequency as the pause screen may appear post transform, causing a second frequency sweep.
+                RemoveFilters(false);
                 OnComplete?.Invoke();
             });
 
@@ -137,15 +138,16 @@ namespace osu.Game.Screens.Play
             Content.FadeColour(Color4.Gray, duration);
         }
 
-        public void RemoveFilters()
+        public void RemoveFilters(bool resetTrackFrequency = true)
         {
+            if (resetTrackFrequency)
+                track?.RemoveAdjustment(AdjustableProperty.Frequency, trackFreq);
+
             if (filters.Parent == null)
                 return;
 
             RemoveInternal(filters);
             filters.Dispose();
-
-            track?.RemoveAdjustment(AdjustableProperty.Frequency, trackFreq);
         }
 
         protected override void Update()

From 2c4f1817d3af1b20fe4e9002add599375c49bd95 Mon Sep 17 00:00:00 2001
From: Darius Wattimena <dariuswattimena@hotmail.com>
Date: Sun, 14 Nov 2021 20:43:31 +0100
Subject: [PATCH 1006/5547] Fixed an issue where banana showers don't clear the
 plate when missing the last banana

---
 osu.Game.Rulesets.Catch/UI/CatcherArea.cs | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Rulesets.Catch/UI/CatcherArea.cs b/osu.Game.Rulesets.Catch/UI/CatcherArea.cs
index 604e878782..0cbabac911 100644
--- a/osu.Game.Rulesets.Catch/UI/CatcherArea.cs
+++ b/osu.Game.Rulesets.Catch/UI/CatcherArea.cs
@@ -10,7 +10,6 @@ using osu.Game.Rulesets.Catch.Judgements;
 using osu.Game.Rulesets.Catch.Objects.Drawables;
 using osu.Game.Rulesets.Catch.Replays;
 using osu.Game.Rulesets.Judgements;
-using osu.Game.Rulesets.Scoring;
 using osu.Game.Rulesets.UI;
 using osuTK;
 
@@ -73,8 +72,8 @@ namespace osu.Game.Rulesets.Catch.UI
         {
             Catcher.OnNewResult(hitObject, result);
 
-            if (!result.Type.IsScorable())
-                return;
+            // Ignore JuiceStreams and BananaShowers
+            if (!(hitObject is DrawablePalpableCatchHitObject)) return;
 
             if (hitObject.HitObject.LastInCombo)
             {

From 4b5ff3288f43b0e3826a4052315f1b66c9e6a205 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Mon, 15 Nov 2021 07:44:42 +0300
Subject: [PATCH 1007/5547] Add generated mtouch symbol strip flags to osu!

---
 osu.iOS.props | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/osu.iOS.props b/osu.iOS.props
index 6747c3aee1..f81217d6dd 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -7,12 +7,16 @@
     <OutputPath>bin\$(Platform)\$(Configuration)</OutputPath>
     <MtouchI18n>cjk,mideast,other,rare,west</MtouchI18n>
     <OptimizePNGs>false</OptimizePNGs>
-    <MtouchExtraArgs>--nolinkaway</MtouchExtraArgs>
     <MtouchHttpClientHandler>NSUrlSessionHandler</MtouchHttpClientHandler>
     <MtouchVerbosity></MtouchVerbosity>
     <CodesignKey>iPhone Developer</CodesignKey>
     <AutoGenerateBindingRedirects>true</AutoGenerateBindingRedirects>
   </PropertyGroup>
+  <PropertyGroup>
+    <!-- Generated via osu.Framework.iOS/generate-symbol-strip-flags.sh -->
+    <GeneratedMtouchSymbolStripFlags>--nosymbolstrip=BASS_FX_BPM_BeatCallbackReset --nosymbolstrip=BASS_FX_BPM_BeatCallbackSet --nosymbolstrip=BASS_FX_BPM_BeatDecodeGet --nosymbolstrip=BASS_FX_BPM_BeatFree --nosymbolstrip=BASS_FX_BPM_BeatGetParameters --nosymbolstrip=BASS_FX_BPM_BeatSetParameters --nosymbolstrip=BASS_FX_BPM_CallbackReset --nosymbolstrip=BASS_FX_BPM_CallbackSet --nosymbolstrip=BASS_FX_BPM_DecodeGet --nosymbolstrip=BASS_FX_BPM_Free --nosymbolstrip=BASS_FX_BPM_Translate --nosymbolstrip=BASS_FX_GetVersion --nosymbolstrip=BASS_FX_ReverseCreate --nosymbolstrip=BASS_FX_ReverseGetSource --nosymbolstrip=BASS_FX_TempoCreate --nosymbolstrip=BASS_FX_TempoGetRateRatio --nosymbolstrip=BASS_FX_TempoGetSource --nosymbolstrip=BASS_Mixer_ChannelFlags --nosymbolstrip=BASS_Mixer_ChannelGetData --nosymbolstrip=BASS_Mixer_ChannelGetEnvelopePos --nosymbolstrip=BASS_Mixer_ChannelGetLevel --nosymbolstrip=BASS_Mixer_ChannelGetLevelEx --nosymbolstrip=BASS_Mixer_ChannelGetMatrix --nosymbolstrip=BASS_Mixer_ChannelGetMixer --nosymbolstrip=BASS_Mixer_ChannelGetPosition --nosymbolstrip=BASS_Mixer_ChannelGetPositionEx --nosymbolstrip=BASS_Mixer_ChannelIsActive --nosymbolstrip=BASS_Mixer_ChannelRemove --nosymbolstrip=BASS_Mixer_ChannelRemoveSync --nosymbolstrip=BASS_Mixer_ChannelSetEnvelope --nosymbolstrip=BASS_Mixer_ChannelSetEnvelopePos --nosymbolstrip=BASS_Mixer_ChannelSetMatrix --nosymbolstrip=BASS_Mixer_ChannelSetMatrixEx --nosymbolstrip=BASS_Mixer_ChannelSetPosition --nosymbolstrip=BASS_Mixer_ChannelSetSync --nosymbolstrip=BASS_Mixer_GetVersion --nosymbolstrip=BASS_Mixer_StreamAddChannel --nosymbolstrip=BASS_Mixer_StreamAddChannelEx --nosymbolstrip=BASS_Mixer_StreamCreate --nosymbolstrip=BASS_Mixer_StreamGetChannels --nosymbolstrip=BASS_Split_StreamCreate --nosymbolstrip=BASS_Split_StreamGetAvailable --nosymbolstrip=BASS_Split_StreamGetSource --nosymbolstrip=BASS_Split_StreamGetSplits --nosymbolstrip=BASS_Split_StreamReset --nosymbolstrip=BASS_Split_StreamResetEx</GeneratedMtouchSymbolStripFlags>
+    <MtouchExtraArgs>--nolinkaway $(GeneratedMtouchSymbolStripFlags)</MtouchExtraArgs>
+  </PropertyGroup>
   <PropertyGroup Condition="'$(Configuration)' == 'Debug'">
     <DebugSymbols>true</DebugSymbols>
     <DebugType>full</DebugType>

From a4c11e8813308b4bbd71489b711c9e556a7ca2f0 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 15 Nov 2021 14:34:50 +0900
Subject: [PATCH 1008/5547] Use extension method to compare online IDs

---
 osu.Game/Database/IHasOnlineID.cs      |  3 +++
 osu.Game/Extensions/ModelExtensions.cs | 29 ++++++++++++++++++++++++++
 osu.Game/Overlays/Music/Playlist.cs    |  3 ++-
 3 files changed, 34 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Database/IHasOnlineID.cs b/osu.Game/Database/IHasOnlineID.cs
index 4e83ed8876..7a720989cd 100644
--- a/osu.Game/Database/IHasOnlineID.cs
+++ b/osu.Game/Database/IHasOnlineID.cs
@@ -1,11 +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;
+
 #nullable enable
 
 namespace osu.Game.Database
 {
     public interface IHasOnlineID<out T>
+        where T : IEquatable<T>
     {
         /// <summary>
         /// The server-side ID representing this instance, if one exists. Any value 0 or less denotes a missing ID (except in special cases where autoincrement is not used, like rulesets).
diff --git a/osu.Game/Extensions/ModelExtensions.cs b/osu.Game/Extensions/ModelExtensions.cs
index d8e0938d46..2545045d96 100644
--- a/osu.Game/Extensions/ModelExtensions.cs
+++ b/osu.Game/Extensions/ModelExtensions.cs
@@ -2,6 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using osu.Game.Beatmaps;
+using osu.Game.Database;
 using osu.Game.Rulesets;
 using osu.Game.Scoring;
 using osu.Game.Users;
@@ -57,5 +58,33 @@ namespace osu.Game.Extensions
             result ??= model?.ToString() ?? @"null";
             return result;
         }
+
+        /// <summary>
+        /// Check whether the online ID of two instances match.
+        /// </summary>
+        /// <param name="instance">The instance to compare.</param>
+        /// <param name="other">The other instance to compare against.</param>
+        /// <returns>Whether online IDs match. If either instance is missing an online ID, this will return false.</returns>
+        public static bool MatchesOnlineID(this IHasOnlineID<long> instance, IHasOnlineID<long> other)
+        {
+            if (instance.OnlineID < 0 || other.OnlineID < 0)
+                return false;
+
+            return instance.OnlineID.Equals(other.OnlineID);
+        }
+
+        /// <summary>
+        /// Check whether the online ID of two instances match.
+        /// </summary>
+        /// <param name="instance">The instance to compare.</param>
+        /// <param name="other">The other instance to compare against.</param>
+        /// <returns>Whether online IDs match. If either instance is missing an online ID, this will return false.</returns>
+        public static bool MatchesOnlineID(this IHasOnlineID<int> instance, IHasOnlineID<int> other)
+        {
+            if (instance.OnlineID < 0 || other.OnlineID < 0)
+                return false;
+
+            return instance.OnlineID.Equals(other.OnlineID);
+        }
     }
 }
diff --git a/osu.Game/Overlays/Music/Playlist.cs b/osu.Game/Overlays/Music/Playlist.cs
index 4fe338926f..5de62ebfb8 100644
--- a/osu.Game/Overlays/Music/Playlist.cs
+++ b/osu.Game/Overlays/Music/Playlist.cs
@@ -7,6 +7,7 @@ using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Beatmaps;
+using osu.Game.Extensions;
 using osu.Game.Graphics.Containers;
 using osuTK;
 
@@ -29,7 +30,7 @@ namespace osu.Game.Overlays.Music
             var items = (SearchContainer<RearrangeableListItem<BeatmapSetInfo>>)ListContainer;
 
             foreach (var item in items.OfType<PlaylistItem>())
-                item.InSelectedCollection = criteria.Collection?.Beatmaps.Any(b => b.BeatmapSet.Equals(item.Model)) ?? true;
+                item.InSelectedCollection = criteria.Collection?.Beatmaps.Any(b => b.MatchesOnlineID(item.Model)) ?? true;
 
             items.SearchTerm = criteria.SearchText;
         }

From 0b4822b55225bb995bff04411082cc36cf42a3a6 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 15 Nov 2021 14:35:01 +0900
Subject: [PATCH 1009/5547] Remove newly added equality

---
 osu.Game/Beatmaps/BeatmapInfo.cs     | 14 --------------
 osu.Game/Beatmaps/BeatmapSetInfo.cs  | 14 --------------
 osu.Game/Beatmaps/IBeatmapInfo.cs    |  3 +--
 osu.Game/Beatmaps/IBeatmapSetInfo.cs |  2 +-
 osu.Game/Models/RealmBeatmap.cs      | 21 ---------------------
 osu.Game/Models/RealmBeatmapSet.cs   | 17 ++---------------
 6 files changed, 4 insertions(+), 67 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapInfo.cs b/osu.Game/Beatmaps/BeatmapInfo.cs
index 0b234b3c2d..6f45f5ec71 100644
--- a/osu.Game/Beatmaps/BeatmapInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapInfo.cs
@@ -163,20 +163,6 @@ namespace osu.Game.Beatmaps
             return false;
         }
 
-        public bool Equals(IBeatmapInfo other)
-        {
-            if (ReferenceEquals(this, other)) return true;
-            if (other == null) return false;
-
-            if (other is BeatmapInfo b && Equals(b))
-                return true;
-
-            if (OnlineID > 0 && other.OnlineID > 0)
-                return other.OnlineID == OnlineID;
-
-            return false;
-        }
-
         public bool AudioEquals(BeatmapInfo other) => other != null && BeatmapSet != null && other.BeatmapSet != null &&
                                                       BeatmapSet.Hash == other.BeatmapSet.Hash &&
                                                       (Metadata ?? BeatmapSet.Metadata).AudioFile == (other.Metadata ?? other.BeatmapSet.Metadata).AudioFile;
diff --git a/osu.Game/Beatmaps/BeatmapSetInfo.cs b/osu.Game/Beatmaps/BeatmapSetInfo.cs
index fa314fe400..6dd8cc5ade 100644
--- a/osu.Game/Beatmaps/BeatmapSetInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapSetInfo.cs
@@ -78,20 +78,6 @@ namespace osu.Game.Beatmaps
             return false;
         }
 
-        public bool Equals(IBeatmapSetInfo other)
-        {
-            if (ReferenceEquals(this, other)) return true;
-            if (other == null) return false;
-
-            if (other is BeatmapSetInfo b && Equals(b))
-                return true;
-
-            if (OnlineID > 0 && other.OnlineID > 0)
-                return other.OnlineID == OnlineID;
-
-            return false;
-        }
-
         #region Implementation of IHasOnlineID
 
         int IHasOnlineID<int>.OnlineID => OnlineID ?? -1;
diff --git a/osu.Game/Beatmaps/IBeatmapInfo.cs b/osu.Game/Beatmaps/IBeatmapInfo.cs
index ab096b8897..84ea6d3019 100644
--- a/osu.Game/Beatmaps/IBeatmapInfo.cs
+++ b/osu.Game/Beatmaps/IBeatmapInfo.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.Game.Database;
 using osu.Game.Rulesets;
 
@@ -12,7 +11,7 @@ namespace osu.Game.Beatmaps
     /// <summary>
     /// A single beatmap difficulty.
     /// </summary>
-    public interface IBeatmapInfo : IHasOnlineID<int>, IEquatable<IBeatmapInfo>
+    public interface IBeatmapInfo : IHasOnlineID<int>
     {
         /// <summary>
         /// The user-specified name given to this beatmap.
diff --git a/osu.Game/Beatmaps/IBeatmapSetInfo.cs b/osu.Game/Beatmaps/IBeatmapSetInfo.cs
index 67f38397d4..20c46d9063 100644
--- a/osu.Game/Beatmaps/IBeatmapSetInfo.cs
+++ b/osu.Game/Beatmaps/IBeatmapSetInfo.cs
@@ -12,7 +12,7 @@ namespace osu.Game.Beatmaps
     /// <summary>
     /// A representation of a collection of beatmap difficulties, generally packaged as an ".osz" archive.
     /// </summary>
-    public interface IBeatmapSetInfo : IHasOnlineID<int>, IEquatable<IBeatmapSetInfo>
+    public interface IBeatmapSetInfo : IHasOnlineID<int>
     {
         /// <summary>
         /// The date when this beatmap was imported.
diff --git a/osu.Game/Models/RealmBeatmap.cs b/osu.Game/Models/RealmBeatmap.cs
index f80d1f513a..2a197d296a 100644
--- a/osu.Game/Models/RealmBeatmap.cs
+++ b/osu.Game/Models/RealmBeatmap.cs
@@ -106,27 +106,6 @@ namespace osu.Game.Models
             return ID == other.ID;
         }
 
-        #region Implementation of IEquatable<IBeatmapInfo>
-
-        public bool Equals(IBeatmapInfo? other)
-        {
-            if (ReferenceEquals(this, other)) return true;
-            if (other == null) return false;
-
-            if (other is RealmBeatmap b && Equals(b))
-                return true;
-
-            if (!string.IsNullOrEmpty(Hash) && !string.IsNullOrEmpty(other.Hash))
-                return Hash == other.Hash;
-
-            if (OnlineID > 0 && other.OnlineID > 0)
-                return other.OnlineID == OnlineID;
-
-            return false;
-        }
-
-        #endregion
-
         public bool AudioEquals(RealmBeatmap? other) => other != null
                                                         && BeatmapSet != null
                                                         && other.BeatmapSet != null
diff --git a/osu.Game/Models/RealmBeatmapSet.cs b/osu.Game/Models/RealmBeatmapSet.cs
index 9cfa2de44d..1747cce67a 100644
--- a/osu.Game/Models/RealmBeatmapSet.cs
+++ b/osu.Game/Models/RealmBeatmapSet.cs
@@ -7,6 +7,7 @@ using System.Linq;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
 using osu.Game.Database;
+using osu.Game.Extensions;
 using Realms;
 
 #nullable enable
@@ -61,21 +62,7 @@ namespace osu.Game.Models
             return ID == other.ID;
         }
 
-        public bool Equals(IBeatmapSetInfo? other)
-        {
-            if (ReferenceEquals(this, other)) return true;
-            if (other == null) return false;
-
-            if (other is RealmBeatmapSet b && Equals(b))
-                return true;
-
-            if (OnlineID > 0 && other.OnlineID > 0)
-                return OnlineID == other.OnlineID;
-
-            return false;
-        }
-
-        public override string ToString() => Metadata?.ToString() ?? base.ToString();
+        public override string ToString() => Metadata?.GetDisplayString() ?? base.ToString();
 
         IEnumerable<IBeatmapInfo> IBeatmapSetInfo.Beatmaps => Beatmaps;
 

From 18f73b985b82de1d0eb07a9e827ba53065330008 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 15 Nov 2021 14:38:01 +0900
Subject: [PATCH 1010/5547] Make `ModelExtensions` nullable enabled

---
 osu.Game/Extensions/ModelExtensions.cs | 16 ++++++++++++----
 1 file changed, 12 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Extensions/ModelExtensions.cs b/osu.Game/Extensions/ModelExtensions.cs
index 2545045d96..48a3bac112 100644
--- a/osu.Game/Extensions/ModelExtensions.cs
+++ b/osu.Game/Extensions/ModelExtensions.cs
@@ -7,6 +7,8 @@ using osu.Game.Rulesets;
 using osu.Game.Scoring;
 using osu.Game.Users;
 
+#nullable enable
+
 namespace osu.Game.Extensions
 {
     public static class ModelExtensions
@@ -23,9 +25,9 @@ namespace osu.Game.Extensions
         /// extension method type inference rules cause this method to call itself and cause a stack overflow.
         /// </para>
         /// </remarks>
-        public static string GetDisplayString(this object model)
+        public static string GetDisplayString(this object? model)
         {
-            string result = null;
+            string? result = null;
 
             switch (model)
             {
@@ -65,8 +67,11 @@ namespace osu.Game.Extensions
         /// <param name="instance">The instance to compare.</param>
         /// <param name="other">The other instance to compare against.</param>
         /// <returns>Whether online IDs match. If either instance is missing an online ID, this will return false.</returns>
-        public static bool MatchesOnlineID(this IHasOnlineID<long> instance, IHasOnlineID<long> other)
+        public static bool MatchesOnlineID(this IHasOnlineID<long>? instance, IHasOnlineID<long>? other)
         {
+            if (instance == null || other == null)
+                return false;
+
             if (instance.OnlineID < 0 || other.OnlineID < 0)
                 return false;
 
@@ -79,8 +84,11 @@ namespace osu.Game.Extensions
         /// <param name="instance">The instance to compare.</param>
         /// <param name="other">The other instance to compare against.</param>
         /// <returns>Whether online IDs match. If either instance is missing an online ID, this will return false.</returns>
-        public static bool MatchesOnlineID(this IHasOnlineID<int> instance, IHasOnlineID<int> other)
+        public static bool MatchesOnlineID(this IHasOnlineID<int>? instance, IHasOnlineID<int>? other)
         {
+            if (instance == null || other == null)
+                return false;
+
             if (instance.OnlineID < 0 || other.OnlineID < 0)
                 return false;
 

From 93fe57d39970ee9c9dcc7dc0a757c2537aa10e55 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 15 Nov 2021 14:43:31 +0900
Subject: [PATCH 1011/5547] Update tests to match new equality not including
 online ID checks

---
 osu.Game.Tests/NonVisual/BeatmapSetInfoEqualityTest.cs | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/NonVisual/BeatmapSetInfoEqualityTest.cs b/osu.Game.Tests/NonVisual/BeatmapSetInfoEqualityTest.cs
index 938edf07c6..534983f869 100644
--- a/osu.Game.Tests/NonVisual/BeatmapSetInfoEqualityTest.cs
+++ b/osu.Game.Tests/NonVisual/BeatmapSetInfoEqualityTest.cs
@@ -3,6 +3,7 @@
 
 using NUnit.Framework;
 using osu.Game.Beatmaps;
+using osu.Game.Extensions;
 
 namespace osu.Game.Tests.NonVisual
 {
@@ -15,7 +16,8 @@ namespace osu.Game.Tests.NonVisual
             var ourInfo = new BeatmapSetInfo { OnlineID = 123 };
             var otherInfo = new BeatmapSetInfo { OnlineID = 123 };
 
-            Assert.AreEqual(ourInfo, otherInfo);
+            Assert.AreNotEqual(ourInfo, otherInfo);
+            Assert.IsTrue(ourInfo.MatchesOnlineID(otherInfo));
         }
 
         [Test]
@@ -33,7 +35,8 @@ namespace osu.Game.Tests.NonVisual
             var ourInfo = new BeatmapSetInfo { ID = 123, OnlineID = 12 };
             var otherInfo = new BeatmapSetInfo { OnlineID = 12 };
 
-            Assert.AreEqual(ourInfo, otherInfo);
+            Assert.AreNotEqual(ourInfo, otherInfo);
+            Assert.IsTrue(ourInfo.MatchesOnlineID(otherInfo));
         }
 
         [Test]

From 285b161da73612b3ed0f4f9c189730b6483cf024 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 15 Nov 2021 14:38:14 +0900
Subject: [PATCH 1012/5547] Update other usages of online ID comparisons to use
 new extension method

---
 osu.Game/Online/API/Requests/Responses/APIBeatmap.cs     | 9 ++-------
 osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs  | 9 ++-------
 osu.Game/Online/API/Requests/Responses/APIUser.cs        | 3 ++-
 .../BeatmapListing/Panels/BeatmapPanelDownloadButton.cs  | 3 ++-
 osu.Game/Overlays/BeatmapSet/BeatmapPicker.cs            | 3 ++-
 osu.Game/Overlays/BeatmapSet/BeatmapRulesetTabItem.cs    | 3 ++-
 osu.Game/Screens/OnlinePlay/Playlists/PlaylistsPlayer.cs | 3 ++-
 7 files changed, 14 insertions(+), 19 deletions(-)

diff --git a/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs b/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs
index 33098a2919..bbffaee87b 100644
--- a/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs
@@ -4,6 +4,7 @@
 using System;
 using Newtonsoft.Json;
 using osu.Game.Beatmaps;
+using osu.Game.Extensions;
 using osu.Game.Rulesets;
 
 #nullable enable
@@ -106,13 +107,7 @@ namespace osu.Game.Online.API.Requests.Responses
 
         #region Implementation of IEquatable<IBeatmapInfo>
 
-        public bool Equals(IBeatmapInfo? other)
-        {
-            if (OnlineID > 0 && other?.OnlineID > 0)
-                return other.OnlineID == OnlineID;
-
-            return false;
-        }
+        public bool Equals(IBeatmapInfo? other) => this.MatchesOnlineID(other);
 
         #endregion
     }
diff --git a/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs b/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs
index f4515c4258..ab8287871f 100644
--- a/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs
@@ -6,6 +6,7 @@ using System.Collections.Generic;
 using Newtonsoft.Json;
 using osu.Game.Beatmaps;
 using osu.Game.Database;
+using osu.Game.Extensions;
 
 #nullable enable
 
@@ -144,13 +145,7 @@ namespace osu.Game.Online.API.Requests.Responses
 
         #region Implementation of IEquatable<IBeatmapSetInfo>
 
-        public bool Equals(IBeatmapSetInfo? other)
-        {
-            if (OnlineID > 0 && other?.OnlineID > 0)
-                return other.OnlineID == OnlineID;
-
-            return false;
-        }
+        public bool Equals(IBeatmapInfo? other) => this.MatchesOnlineID(other);
 
         #endregion
     }
diff --git a/osu.Game/Online/API/Requests/Responses/APIUser.cs b/osu.Game/Online/API/Requests/Responses/APIUser.cs
index 49edfd036b..50f5d67796 100644
--- a/osu.Game/Online/API/Requests/Responses/APIUser.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIUser.cs
@@ -7,6 +7,7 @@ using System.Linq;
 using JetBrains.Annotations;
 using Newtonsoft.Json;
 using osu.Framework.Bindables;
+using osu.Game.Extensions;
 using osu.Game.Users;
 
 namespace osu.Game.Online.API.Requests.Responses
@@ -240,6 +241,6 @@ namespace osu.Game.Online.API.Requests.Responses
 
         public int OnlineID => Id;
 
-        public bool Equals(APIUser other) => OnlineID == other?.OnlineID;
+        public bool Equals(APIUser other) => this.MatchesOnlineID(other);
     }
 }
diff --git a/osu.Game/Overlays/BeatmapListing/Panels/BeatmapPanelDownloadButton.cs b/osu.Game/Overlays/BeatmapListing/Panels/BeatmapPanelDownloadButton.cs
index 8c7846783d..1282a14c3d 100644
--- a/osu.Game/Overlays/BeatmapListing/Panels/BeatmapPanelDownloadButton.cs
+++ b/osu.Game/Overlays/BeatmapListing/Panels/BeatmapPanelDownloadButton.cs
@@ -8,6 +8,7 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Beatmaps;
 using osu.Game.Configuration;
+using osu.Game.Extensions;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Online;
@@ -80,7 +81,7 @@ namespace osu.Game.Overlays.BeatmapListing.Panels
                     case DownloadState.LocallyAvailable:
                         Predicate<BeatmapInfo> findPredicate = null;
                         if (SelectedBeatmap.Value != null)
-                            findPredicate = b => b.OnlineID == SelectedBeatmap.Value.OnlineID;
+                            findPredicate = b => b.MatchesOnlineID(SelectedBeatmap.Value);
 
                         game?.PresentBeatmap(beatmapSet, findPredicate);
                         break;
diff --git a/osu.Game/Overlays/BeatmapSet/BeatmapPicker.cs b/osu.Game/Overlays/BeatmapSet/BeatmapPicker.cs
index b152375062..59e8e8db3c 100644
--- a/osu.Game/Overlays/BeatmapSet/BeatmapPicker.cs
+++ b/osu.Game/Overlays/BeatmapSet/BeatmapPicker.cs
@@ -14,6 +14,7 @@ using osu.Framework.Graphics.Sprites;
 using osu.Framework.Input.Events;
 using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.Drawables;
+using osu.Game.Extensions;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
@@ -166,7 +167,7 @@ namespace osu.Game.Overlays.BeatmapSet
             if (BeatmapSet != null)
             {
                 Difficulties.ChildrenEnumerable = BeatmapSet.Beatmaps
-                                                            .Where(b => b.Ruleset.OnlineID == ruleset.Value?.OnlineID)
+                                                            .Where(b => b.Ruleset.MatchesOnlineID(ruleset.Value))
                                                             .OrderBy(b => b.StarRating)
                                                             .Select(b => new DifficultySelectorButton(b)
                                                             {
diff --git a/osu.Game/Overlays/BeatmapSet/BeatmapRulesetTabItem.cs b/osu.Game/Overlays/BeatmapSet/BeatmapRulesetTabItem.cs
index b3b3d1980b..e8cdc6913b 100644
--- a/osu.Game/Overlays/BeatmapSet/BeatmapRulesetTabItem.cs
+++ b/osu.Game/Overlays/BeatmapSet/BeatmapRulesetTabItem.cs
@@ -7,6 +7,7 @@ using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
+using osu.Game.Extensions;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Online.API.Requests.Responses;
@@ -64,7 +65,7 @@ namespace osu.Game.Overlays.BeatmapSet
 
             BeatmapSet.BindValueChanged(setInfo =>
             {
-                int beatmapsCount = setInfo.NewValue?.Beatmaps.Count(b => b.Ruleset.OnlineID == Value.OnlineID) ?? 0;
+                int beatmapsCount = setInfo.NewValue?.Beatmaps.Count(b => b.Ruleset.MatchesOnlineID(Value)) ?? 0;
 
                 count.Text = beatmapsCount.ToString();
                 countContainer.FadeTo(beatmapsCount > 0 ? 1 : 0);
diff --git a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsPlayer.cs b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsPlayer.cs
index 22537c3ce0..56863cafad 100644
--- a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsPlayer.cs
+++ b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsPlayer.cs
@@ -8,6 +8,7 @@ using System.Threading.Tasks;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Screens;
+using osu.Game.Extensions;
 using osu.Game.Online.Rooms;
 using osu.Game.Rulesets;
 using osu.Game.Scoring;
@@ -32,7 +33,7 @@ namespace osu.Game.Screens.OnlinePlay.Playlists
         private void load(IBindable<RulesetInfo> ruleset)
         {
             // Sanity checks to ensure that PlaylistsPlayer matches the settings for the current PlaylistItem
-            if (Beatmap.Value.BeatmapInfo.OnlineID != PlaylistItem.Beatmap.Value.OnlineID)
+            if (!Beatmap.Value.BeatmapInfo.MatchesOnlineID(PlaylistItem.Beatmap.Value))
                 throw new InvalidOperationException("Current Beatmap does not match PlaylistItem's Beatmap");
 
             if (ruleset.Value.ID != PlaylistItem.Ruleset.Value.ID)

From 611b9fe9422e5e33ae7845b911dceda44a7b6b24 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 15 Nov 2021 14:50:09 +0900
Subject: [PATCH 1013/5547] Remove now unused implementations of interface
 equality

---
 osu.Game/Online/API/Requests/Responses/APIBeatmap.cs    | 7 -------
 osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs | 7 -------
 2 files changed, 14 deletions(-)

diff --git a/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs b/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs
index bbffaee87b..2560502173 100644
--- a/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs
@@ -4,7 +4,6 @@
 using System;
 using Newtonsoft.Json;
 using osu.Game.Beatmaps;
-using osu.Game.Extensions;
 using osu.Game.Rulesets;
 
 #nullable enable
@@ -104,11 +103,5 @@ namespace osu.Game.Online.API.Requests.Responses
         public string Hash => throw new NotImplementedException();
 
         #endregion
-
-        #region Implementation of IEquatable<IBeatmapInfo>
-
-        public bool Equals(IBeatmapInfo? other) => this.MatchesOnlineID(other);
-
-        #endregion
     }
 }
diff --git a/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs b/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs
index ab8287871f..168e9d5d51 100644
--- a/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs
@@ -6,7 +6,6 @@ using System.Collections.Generic;
 using Newtonsoft.Json;
 using osu.Game.Beatmaps;
 using osu.Game.Database;
-using osu.Game.Extensions;
 
 #nullable enable
 
@@ -142,11 +141,5 @@ namespace osu.Game.Online.API.Requests.Responses
         double IBeatmapSetInfo.MaxBPM => BPM;
 
         #endregion
-
-        #region Implementation of IEquatable<IBeatmapSetInfo>
-
-        public bool Equals(IBeatmapInfo? other) => this.MatchesOnlineID(other);
-
-        #endregion
     }
 }

From 73cb80d8a44a0c69717a47acdb2adb09da341b1a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 15 Nov 2021 16:00:45 +0900
Subject: [PATCH 1014/5547] Update one more missed usage

---
 osu.Game/Screens/OnlinePlay/Lounge/Components/RoomsContainer.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Screens/OnlinePlay/Lounge/Components/RoomsContainer.cs b/osu.Game/Screens/OnlinePlay/Lounge/Components/RoomsContainer.cs
index 85efdcef1a..32ae7cf859 100644
--- a/osu.Game/Screens/OnlinePlay/Lounge/Components/RoomsContainer.cs
+++ b/osu.Game/Screens/OnlinePlay/Lounge/Components/RoomsContainer.cs
@@ -82,7 +82,7 @@ namespace osu.Game.Screens.OnlinePlay.Lounge.Components
                 {
                     bool matchingFilter = true;
 
-                    matchingFilter &= r.Room.Playlist.Count == 0 || criteria.Ruleset == null || r.Room.Playlist.Any(i => i.Ruleset.Value.Equals(criteria.Ruleset));
+                    matchingFilter &= r.Room.Playlist.Count == 0 || criteria.Ruleset == null || r.Room.Playlist.Any(i => i.Ruleset.Value.MatchesOnlineID(criteria.Ruleset));
 
                     if (!string.IsNullOrEmpty(criteria.SearchString))
                         matchingFilter &= r.FilterTerms.Any(term => term.Contains(criteria.SearchString, StringComparison.InvariantCultureIgnoreCase));

From 1988b263c60331f02fd973eee2da70f077ea78df Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 15 Nov 2021 16:02:08 +0900
Subject: [PATCH 1015/5547] One more missed usage..

---
 osu.Game/Screens/OnlinePlay/Playlists/PlaylistsPlayer.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsPlayer.cs b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsPlayer.cs
index 56863cafad..35d417520e 100644
--- a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsPlayer.cs
+++ b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsPlayer.cs
@@ -36,7 +36,7 @@ namespace osu.Game.Screens.OnlinePlay.Playlists
             if (!Beatmap.Value.BeatmapInfo.MatchesOnlineID(PlaylistItem.Beatmap.Value))
                 throw new InvalidOperationException("Current Beatmap does not match PlaylistItem's Beatmap");
 
-            if (ruleset.Value.ID != PlaylistItem.Ruleset.Value.ID)
+            if (!ruleset.Value.MatchesOnlineID(PlaylistItem.Ruleset.Value))
                 throw new InvalidOperationException("Current Ruleset does not match PlaylistItem's Ruleset");
 
             if (!PlaylistItem.RequiredMods.All(m => Mods.Value.Any(m.Equals)))

From 907499f73afacb8cb419fbc2553d04cc26c0bd57 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Mon, 15 Nov 2021 16:06:29 +0900
Subject: [PATCH 1016/5547] Add json properties to difficulty attributes

---
 .../Difficulty/CatchDifficultyAttributes.cs   |  2 ++
 .../Difficulty/ManiaDifficultyAttributes.cs   |  4 ++++
 .../Difficulty/OsuDifficultyAttributes.cs     | 20 +++++++++++++++++++
 .../Difficulty/TaikoDifficultyAttributes.cs   | 10 ++++++++++
 .../Difficulty/DifficultyAttributes.cs        |  7 +++++++
 5 files changed, 43 insertions(+)

diff --git a/osu.Game.Rulesets.Catch/Difficulty/CatchDifficultyAttributes.cs b/osu.Game.Rulesets.Catch/Difficulty/CatchDifficultyAttributes.cs
index 4e05b1e3e0..57305ce62b 100644
--- a/osu.Game.Rulesets.Catch/Difficulty/CatchDifficultyAttributes.cs
+++ b/osu.Game.Rulesets.Catch/Difficulty/CatchDifficultyAttributes.cs
@@ -1,12 +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 Newtonsoft.Json;
 using osu.Game.Rulesets.Difficulty;
 
 namespace osu.Game.Rulesets.Catch.Difficulty
 {
     public class CatchDifficultyAttributes : DifficultyAttributes
     {
+        [JsonProperty("approach_rate")]
         public double ApproachRate { get; set; }
     }
 }
diff --git a/osu.Game.Rulesets.Mania/Difficulty/ManiaDifficultyAttributes.cs b/osu.Game.Rulesets.Mania/Difficulty/ManiaDifficultyAttributes.cs
index 628d77107f..dd966ca859 100644
--- a/osu.Game.Rulesets.Mania/Difficulty/ManiaDifficultyAttributes.cs
+++ b/osu.Game.Rulesets.Mania/Difficulty/ManiaDifficultyAttributes.cs
@@ -1,13 +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 Newtonsoft.Json;
 using osu.Game.Rulesets.Difficulty;
 
 namespace osu.Game.Rulesets.Mania.Difficulty
 {
     public class ManiaDifficultyAttributes : DifficultyAttributes
     {
+        [JsonProperty("great_hit_window")]
         public double GreatHitWindow { get; set; }
+
+        [JsonProperty("score_multiplier")]
         public double ScoreMultiplier { get; set; }
     }
 }
diff --git a/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyAttributes.cs b/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyAttributes.cs
index e0a216c8e0..323cda76d4 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyAttributes.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyAttributes.cs
@@ -1,21 +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 Newtonsoft.Json;
 using osu.Game.Rulesets.Difficulty;
 
 namespace osu.Game.Rulesets.Osu.Difficulty
 {
     public class OsuDifficultyAttributes : DifficultyAttributes
     {
+        [JsonProperty("aim_strain")]
         public double AimStrain { get; set; }
+
+        [JsonProperty("speed_strain")]
         public double SpeedStrain { get; set; }
+
+        [JsonProperty("flashlight_rating")]
         public double FlashlightRating { get; set; }
+
+        [JsonProperty("slider_factor")]
         public double SliderFactor { get; set; }
+
+        [JsonProperty("approach_rate")]
         public double ApproachRate { get; set; }
+
+        [JsonProperty("overall_difficulty")]
         public double OverallDifficulty { get; set; }
+
+        [JsonProperty("drain_rate")]
         public double DrainRate { get; set; }
+
+        [JsonProperty("hit_circle_count")]
         public int HitCircleCount { get; set; }
+
+        [JsonProperty("slider_count")]
         public int SliderCount { get; set; }
+
+        [JsonProperty("spinner_count")]
         public int SpinnerCount { get; set; }
     }
 }
diff --git a/osu.Game.Rulesets.Taiko/Difficulty/TaikoDifficultyAttributes.cs b/osu.Game.Rulesets.Taiko/Difficulty/TaikoDifficultyAttributes.cs
index 36adbd5a5b..171ac89e6f 100644
--- a/osu.Game.Rulesets.Taiko/Difficulty/TaikoDifficultyAttributes.cs
+++ b/osu.Game.Rulesets.Taiko/Difficulty/TaikoDifficultyAttributes.cs
@@ -1,16 +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 Newtonsoft.Json;
 using osu.Game.Rulesets.Difficulty;
 
 namespace osu.Game.Rulesets.Taiko.Difficulty
 {
     public class TaikoDifficultyAttributes : DifficultyAttributes
     {
+        [JsonProperty("stamina_strain")]
         public double StaminaStrain { get; set; }
+
+        [JsonProperty("rhythm_strain")]
         public double RhythmStrain { get; set; }
+
+        [JsonProperty("colour_strain")]
         public double ColourStrain { get; set; }
+
+        [JsonProperty("approach_rate")]
         public double ApproachRate { get; set; }
+
+        [JsonProperty("great_hit_window")]
         public double GreatHitWindow { get; set; }
     }
 }
diff --git a/osu.Game/Rulesets/Difficulty/DifficultyAttributes.cs b/osu.Game/Rulesets/Difficulty/DifficultyAttributes.cs
index 6bb780a68b..fb67396718 100644
--- a/osu.Game/Rulesets/Difficulty/DifficultyAttributes.cs
+++ b/osu.Game/Rulesets/Difficulty/DifficultyAttributes.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 Newtonsoft.Json;
 using osu.Game.Rulesets.Difficulty.Skills;
 using osu.Game.Rulesets.Mods;
 
@@ -8,10 +9,16 @@ namespace osu.Game.Rulesets.Difficulty
 {
     public class DifficultyAttributes
     {
+        [JsonIgnore]
         public Mod[] Mods { get; set; }
+
+        [JsonIgnore]
         public Skill[] Skills { get; set; }
 
+        [JsonProperty("star_rating")]
         public double StarRating { get; set; }
+
+        [JsonProperty("max_combo")]
         public int MaxCombo { get; set; }
 
         public DifficultyAttributes()

From 0cfd6fdf0455224de5d8a98be1aaae954e0f82c0 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Mon, 15 Nov 2021 16:06:46 +0900
Subject: [PATCH 1017/5547] Add to/from database mapping functions to
 difficulty attributes

---
 .../Difficulty/CatchDifficultyAttributes.cs   | 21 +++++++++++
 .../Difficulty/ManiaDifficultyAttributes.cs   | 21 +++++++++++
 .../Difficulty/OsuDifficultyAttributes.cs     | 37 +++++++++++++++++++
 .../Difficulty/TaikoDifficultyAttributes.cs   | 20 ++++++++++
 .../Difficulty/DifficultyAttributes.cs        |  8 ++++
 5 files changed, 107 insertions(+)

diff --git a/osu.Game.Rulesets.Catch/Difficulty/CatchDifficultyAttributes.cs b/osu.Game.Rulesets.Catch/Difficulty/CatchDifficultyAttributes.cs
index 57305ce62b..3f03fc102b 100644
--- a/osu.Game.Rulesets.Catch/Difficulty/CatchDifficultyAttributes.cs
+++ b/osu.Game.Rulesets.Catch/Difficulty/CatchDifficultyAttributes.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 Newtonsoft.Json;
 using osu.Game.Rulesets.Difficulty;
 
@@ -10,5 +11,25 @@ namespace osu.Game.Rulesets.Catch.Difficulty
     {
         [JsonProperty("approach_rate")]
         public double ApproachRate { get; set; }
+
+        public override IEnumerable<(int attributeId, object value)> ToDatabase()
+        {
+            foreach (var v in base.ToDatabase())
+                yield return v;
+
+            // Todo: Catch should not output star rating in the 'aim' attribute.
+            yield return (1, StarRating);
+            yield return (7, ApproachRate);
+            yield return (9, MaxCombo);
+        }
+
+        public override void FromDatabase(IReadOnlyDictionary<int, double> values, int hitCircleCount, int spinnerCount)
+        {
+            base.FromDatabase(values, hitCircleCount, spinnerCount);
+
+            StarRating = values[1];
+            ApproachRate = values[7];
+            MaxCombo = (int)values[9];
+        }
     }
 }
diff --git a/osu.Game.Rulesets.Mania/Difficulty/ManiaDifficultyAttributes.cs b/osu.Game.Rulesets.Mania/Difficulty/ManiaDifficultyAttributes.cs
index dd966ca859..d1cb48f728 100644
--- a/osu.Game.Rulesets.Mania/Difficulty/ManiaDifficultyAttributes.cs
+++ b/osu.Game.Rulesets.Mania/Difficulty/ManiaDifficultyAttributes.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 Newtonsoft.Json;
 using osu.Game.Rulesets.Difficulty;
 
@@ -13,5 +14,25 @@ namespace osu.Game.Rulesets.Mania.Difficulty
 
         [JsonProperty("score_multiplier")]
         public double ScoreMultiplier { get; set; }
+
+        public override IEnumerable<(int attributeId, object value)> ToDatabase()
+        {
+            foreach (var v in base.ToDatabase())
+                yield return v;
+
+            // Todo: Mania doesn't output MaxCombo attribute for some reason.
+            yield return (11, StarRating);
+            yield return (13, GreatHitWindow);
+            yield return (15, ScoreMultiplier);
+        }
+
+        public override void FromDatabase(IReadOnlyDictionary<int, double> values, int hitCircleCount, int spinnerCount)
+        {
+            base.FromDatabase(values, hitCircleCount, spinnerCount);
+
+            StarRating = values[11];
+            GreatHitWindow = values[13];
+            ScoreMultiplier = values[15];
+        }
     }
 }
diff --git a/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyAttributes.cs b/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyAttributes.cs
index 323cda76d4..75d1eed1ab 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyAttributes.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyAttributes.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 System.Collections.Generic;
+using System.Linq;
 using Newtonsoft.Json;
 using osu.Game.Rulesets.Difficulty;
+using osu.Game.Rulesets.Mods;
 
 namespace osu.Game.Rulesets.Osu.Difficulty
 {
@@ -37,5 +40,39 @@ namespace osu.Game.Rulesets.Osu.Difficulty
 
         [JsonProperty("spinner_count")]
         public int SpinnerCount { get; set; }
+
+        public override IEnumerable<(int attributeId, object value)> ToDatabase()
+        {
+            foreach (var v in base.ToDatabase())
+                yield return v;
+
+            yield return (1, AimStrain);
+            yield return (3, SpeedStrain);
+            yield return (5, OverallDifficulty);
+            yield return (7, ApproachRate);
+            yield return (9, MaxCombo);
+            yield return (11, StarRating);
+
+            if (Mods.Any(m => m is ModFlashlight))
+                yield return (17, FlashlightRating);
+
+            yield return (19, SliderFactor);
+        }
+
+        public override void FromDatabase(IReadOnlyDictionary<int, double> values, int hitCircleCount, int spinnerCount)
+        {
+            base.FromDatabase(values, hitCircleCount, spinnerCount);
+
+            AimStrain = values[1];
+            SpeedStrain = values[3];
+            OverallDifficulty = values[5];
+            ApproachRate = values[7];
+            MaxCombo = (int)values[9];
+            StarRating = values[11];
+            FlashlightRating = values.GetValueOrDefault(17);
+            SliderFactor = values[19];
+            HitCircleCount = hitCircleCount;
+            SpinnerCount = spinnerCount;
+        }
     }
 }
diff --git a/osu.Game.Rulesets.Taiko/Difficulty/TaikoDifficultyAttributes.cs b/osu.Game.Rulesets.Taiko/Difficulty/TaikoDifficultyAttributes.cs
index 171ac89e6f..b2208ea617 100644
--- a/osu.Game.Rulesets.Taiko/Difficulty/TaikoDifficultyAttributes.cs
+++ b/osu.Game.Rulesets.Taiko/Difficulty/TaikoDifficultyAttributes.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 Newtonsoft.Json;
 using osu.Game.Rulesets.Difficulty;
 
@@ -22,5 +23,24 @@ namespace osu.Game.Rulesets.Taiko.Difficulty
 
         [JsonProperty("great_hit_window")]
         public double GreatHitWindow { get; set; }
+
+        public override IEnumerable<(int attributeId, object value)> ToDatabase()
+        {
+            foreach (var v in base.ToDatabase())
+                yield return v;
+
+            yield return (9, MaxCombo);
+            yield return (11, StarRating);
+            yield return (13, GreatHitWindow);
+        }
+
+        public override void FromDatabase(IReadOnlyDictionary<int, double> values, int hitCircleCount, int spinnerCount)
+        {
+            base.FromDatabase(values, hitCircleCount, spinnerCount);
+
+            MaxCombo = (int)values[9];
+            StarRating = values[11];
+            GreatHitWindow = values[13];
+        }
     }
 }
diff --git a/osu.Game/Rulesets/Difficulty/DifficultyAttributes.cs b/osu.Game/Rulesets/Difficulty/DifficultyAttributes.cs
index fb67396718..96d52833e0 100644
--- a/osu.Game/Rulesets/Difficulty/DifficultyAttributes.cs
+++ b/osu.Game/Rulesets/Difficulty/DifficultyAttributes.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.Collections.Generic;
+using System.Linq;
 using Newtonsoft.Json;
 using osu.Game.Rulesets.Difficulty.Skills;
 using osu.Game.Rulesets.Mods;
@@ -31,5 +33,11 @@ namespace osu.Game.Rulesets.Difficulty
             Skills = skills;
             StarRating = starRating;
         }
+
+        public virtual IEnumerable<(int attributeId, object value)> ToDatabase() => Enumerable.Empty<(int, object)>();
+
+        public virtual void FromDatabase(IReadOnlyDictionary<int, double> values, int hitCircleCount, int spinnerCount)
+        {
+        }
     }
 }

From 5489b19c57f1f6d547d9d15efbdc2cd001ca062e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 15 Nov 2021 16:13:03 +0900
Subject: [PATCH 1018/5547] Update `PlaylistItem` to use `IRulesetInfo`

---
 osu.Game/Online/Rooms/MultiplayerScore.cs                   | 5 +++--
 osu.Game/Online/Rooms/PlaylistItem.cs                       | 4 ++--
 osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs     | 2 +-
 osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs          | 6 +++++-
 .../Screens/OnlinePlay/Playlists/PlaylistsResultsScreen.cs  | 6 +++++-
 5 files changed, 16 insertions(+), 7 deletions(-)

diff --git a/osu.Game/Online/Rooms/MultiplayerScore.cs b/osu.Game/Online/Rooms/MultiplayerScore.cs
index cfb81f0bad..7bc3377ad9 100644
--- a/osu.Game/Online/Rooms/MultiplayerScore.cs
+++ b/osu.Game/Online/Rooms/MultiplayerScore.cs
@@ -10,6 +10,7 @@ using Newtonsoft.Json.Converters;
 using osu.Game.Beatmaps;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests.Responses;
+using osu.Game.Rulesets;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Scoring;
 using osu.Game.Scoring;
@@ -62,7 +63,7 @@ namespace osu.Game.Online.Rooms
         [CanBeNull]
         public MultiplayerScoresAround ScoresAround { get; set; }
 
-        public ScoreInfo CreateScoreInfo(PlaylistItem playlistItem, [NotNull] BeatmapInfo beatmap)
+        public ScoreInfo CreateScoreInfo(RulesetStore rulesets, PlaylistItem playlistItem, [NotNull] BeatmapInfo beatmap)
         {
             var rulesetInstance = playlistItem.Ruleset.Value.CreateInstance();
 
@@ -73,7 +74,7 @@ namespace osu.Game.Online.Rooms
                 MaxCombo = MaxCombo,
                 BeatmapInfo = beatmap,
                 BeatmapInfoID = playlistItem.BeatmapID,
-                Ruleset = playlistItem.Ruleset.Value,
+                Ruleset = rulesets.GetRuleset(playlistItem.RulesetID),
                 RulesetID = playlistItem.RulesetID,
                 Statistics = Statistics,
                 User = User,
diff --git a/osu.Game/Online/Rooms/PlaylistItem.cs b/osu.Game/Online/Rooms/PlaylistItem.cs
index cb550281a9..6f3d13b224 100644
--- a/osu.Game/Online/Rooms/PlaylistItem.cs
+++ b/osu.Game/Online/Rooms/PlaylistItem.cs
@@ -34,7 +34,7 @@ namespace osu.Game.Online.Rooms
         public readonly Bindable<IBeatmapInfo> Beatmap = new Bindable<IBeatmapInfo>();
 
         [JsonIgnore]
-        public readonly Bindable<RulesetInfo> Ruleset = new Bindable<RulesetInfo>();
+        public readonly Bindable<IRulesetInfo> Ruleset = new Bindable<IRulesetInfo>();
 
         [JsonIgnore]
         public readonly BindableList<Mod> AllowedMods = new BindableList<Mod>();
@@ -66,7 +66,7 @@ namespace osu.Game.Online.Rooms
         public PlaylistItem()
         {
             Beatmap.BindValueChanged(beatmap => BeatmapID = beatmap.NewValue?.OnlineID ?? -1);
-            Ruleset.BindValueChanged(ruleset => RulesetID = ruleset.NewValue?.ID ?? 0);
+            Ruleset.BindValueChanged(ruleset => RulesetID = ruleset.NewValue?.OnlineID ?? 0);
         }
 
         public void MapObjects(RulesetStore rulesets)
diff --git a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
index 85cee46a29..817fb07d4b 100644
--- a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
+++ b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
@@ -46,7 +46,7 @@ namespace osu.Game.Screens.OnlinePlay
         private ModDisplay modDisplay;
 
         private readonly Bindable<IBeatmapInfo> beatmap = new Bindable<IBeatmapInfo>();
-        private readonly Bindable<RulesetInfo> ruleset = new Bindable<RulesetInfo>();
+        private readonly Bindable<IRulesetInfo> ruleset = new Bindable<IRulesetInfo>();
         private readonly BindableList<Mod> requiredMods = new BindableList<Mod>();
 
         public readonly PlaylistItem Item;
diff --git a/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs b/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
index dc928d90e9..323d38c881 100644
--- a/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
@@ -18,6 +18,7 @@ using osu.Game.Beatmaps;
 using osu.Game.Online.Rooms;
 using osu.Game.Overlays;
 using osu.Game.Overlays.Mods;
+using osu.Game.Rulesets;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Screens.OnlinePlay.Match.Components;
 
@@ -59,6 +60,9 @@ namespace osu.Game.Screens.OnlinePlay.Match
         [Resolved]
         private BeatmapManager beatmapManager { get; set; }
 
+        [Resolved]
+        private RulesetStore rulesets { get; set; }
+
         [Resolved(canBeNull: true)]
         protected OnlinePlayScreen ParentScreen { get; private set; }
 
@@ -344,7 +348,7 @@ namespace osu.Game.Screens.OnlinePlay.Match
 
             UpdateMods();
 
-            Ruleset.Value = selected.Ruleset.Value;
+            Ruleset.Value = rulesets.GetRuleset(selected.RulesetID);
 
             if (!selected.AllowedMods.Any())
             {
diff --git a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsResultsScreen.cs b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsResultsScreen.cs
index 34698fccab..aed3635cbc 100644
--- a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsResultsScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsResultsScreen.cs
@@ -12,6 +12,7 @@ using osu.Framework.Graphics.Containers;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Online.API;
 using osu.Game.Online.Rooms;
+using osu.Game.Rulesets;
 using osu.Game.Scoring;
 using osu.Game.Screens.Ranking;
 
@@ -35,6 +36,9 @@ namespace osu.Game.Screens.OnlinePlay.Playlists
         [Resolved]
         private ScoreManager scoreManager { get; set; }
 
+        [Resolved]
+        private RulesetStore rulesets { get; set; }
+
         public PlaylistsResultsScreen(ScoreInfo score, long roomId, PlaylistItem playlistItem, bool allowRetry, bool allowWatchingReplay = true)
             : base(score, allowRetry, allowWatchingReplay)
         {
@@ -169,7 +173,7 @@ namespace osu.Game.Screens.OnlinePlay.Playlists
         /// <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)
         {
-            var scoreInfos = scores.Select(s => s.CreateScoreInfo(playlistItem, Beatmap.Value.BeatmapInfo)).ToArray();
+            var scoreInfos = scores.Select(s => s.CreateScoreInfo(rulesets, playlistItem, Beatmap.Value.BeatmapInfo)).ToArray();
 
             // Score panels calculate total score before displaying, which can take some time. In order to count that calculation as part of the loading spinner display duration,
             // calculate the total scores locally before invoking the success callback.

From 45382a81277ae4f5663bded357cc8d9920eacef2 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Mon, 15 Nov 2021 16:32:25 +0900
Subject: [PATCH 1019/5547] Ignore some properties

---
 .../Difficulty/OsuDifficultyAttributes.cs                 | 8 ++++----
 osu.Game/Rulesets/Difficulty/DifficultyAttributes.cs      | 4 ++--
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyAttributes.cs b/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyAttributes.cs
index 75d1eed1ab..0d76cb855b 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyAttributes.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyAttributes.cs
@@ -29,16 +29,16 @@ namespace osu.Game.Rulesets.Osu.Difficulty
         [JsonProperty("overall_difficulty")]
         public double OverallDifficulty { get; set; }
 
-        [JsonProperty("drain_rate")]
+        [JsonIgnore]
         public double DrainRate { get; set; }
 
-        [JsonProperty("hit_circle_count")]
+        [JsonIgnore]
         public int HitCircleCount { get; set; }
 
-        [JsonProperty("slider_count")]
+        [JsonIgnore]
         public int SliderCount { get; set; }
 
-        [JsonProperty("spinner_count")]
+        [JsonIgnore]
         public int SpinnerCount { get; set; }
 
         public override IEnumerable<(int attributeId, object value)> ToDatabase()
diff --git a/osu.Game/Rulesets/Difficulty/DifficultyAttributes.cs b/osu.Game/Rulesets/Difficulty/DifficultyAttributes.cs
index 96d52833e0..6a3b97ab1d 100644
--- a/osu.Game/Rulesets/Difficulty/DifficultyAttributes.cs
+++ b/osu.Game/Rulesets/Difficulty/DifficultyAttributes.cs
@@ -17,10 +17,10 @@ namespace osu.Game.Rulesets.Difficulty
         [JsonIgnore]
         public Skill[] Skills { get; set; }
 
-        [JsonProperty("star_rating")]
+        [JsonProperty("star_rating", Order = -3)]
         public double StarRating { get; set; }
 
-        [JsonProperty("max_combo")]
+        [JsonProperty("max_combo", Order = -2)]
         public int MaxCombo { get; set; }
 
         public DifficultyAttributes()

From 21c0882b74d3267361ff2c9b55cf00b7408435e6 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Mon, 15 Nov 2021 17:24:53 +0900
Subject: [PATCH 1020/5547] Don't serialize FL rating without FL mod

---
 osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyAttributes.cs | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyAttributes.cs b/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyAttributes.cs
index 0d76cb855b..089f163dfb 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyAttributes.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyAttributes.cs
@@ -3,6 +3,7 @@
 
 using System.Collections.Generic;
 using System.Linq;
+using JetBrains.Annotations;
 using Newtonsoft.Json;
 using osu.Game.Rulesets.Difficulty;
 using osu.Game.Rulesets.Mods;
@@ -74,5 +75,8 @@ namespace osu.Game.Rulesets.Osu.Difficulty
             HitCircleCount = hitCircleCount;
             SpinnerCount = spinnerCount;
         }
+
+        [UsedImplicitly]
+        public bool ShouldSerializeFlashlightRating() => Mods.OfType<ModFlashlight>().Any();
     }
 }

From c8a01c35f76fd0a85d242aabb6f788f7d8bd8634 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Mon, 15 Nov 2021 18:11:07 +0900
Subject: [PATCH 1021/5547] Remove extra members from FromDatabaseAttributes

---
 .../Difficulty/CatchDifficultyAttributes.cs            |  8 ++++----
 .../Difficulty/ManiaDifficultyAttributes.cs            |  8 ++++----
 .../Difficulty/OsuDifficultyAttributes.cs              | 10 ++++------
 .../Difficulty/TaikoDifficultyAttributes.cs            |  8 ++++----
 osu.Game/Rulesets/Difficulty/DifficultyAttributes.cs   |  4 ++--
 5 files changed, 18 insertions(+), 20 deletions(-)

diff --git a/osu.Game.Rulesets.Catch/Difficulty/CatchDifficultyAttributes.cs b/osu.Game.Rulesets.Catch/Difficulty/CatchDifficultyAttributes.cs
index 3f03fc102b..ca63e87f8d 100644
--- a/osu.Game.Rulesets.Catch/Difficulty/CatchDifficultyAttributes.cs
+++ b/osu.Game.Rulesets.Catch/Difficulty/CatchDifficultyAttributes.cs
@@ -12,9 +12,9 @@ namespace osu.Game.Rulesets.Catch.Difficulty
         [JsonProperty("approach_rate")]
         public double ApproachRate { get; set; }
 
-        public override IEnumerable<(int attributeId, object value)> ToDatabase()
+        public override IEnumerable<(int attributeId, object value)> ToDatabaseAttributes()
         {
-            foreach (var v in base.ToDatabase())
+            foreach (var v in base.ToDatabaseAttributes())
                 yield return v;
 
             // Todo: Catch should not output star rating in the 'aim' attribute.
@@ -23,9 +23,9 @@ namespace osu.Game.Rulesets.Catch.Difficulty
             yield return (9, MaxCombo);
         }
 
-        public override void FromDatabase(IReadOnlyDictionary<int, double> values, int hitCircleCount, int spinnerCount)
+        public override void FromDatabaseAttributes(IReadOnlyDictionary<int, double> values)
         {
-            base.FromDatabase(values, hitCircleCount, spinnerCount);
+            base.FromDatabaseAttributes(values);
 
             StarRating = values[1];
             ApproachRate = values[7];
diff --git a/osu.Game.Rulesets.Mania/Difficulty/ManiaDifficultyAttributes.cs b/osu.Game.Rulesets.Mania/Difficulty/ManiaDifficultyAttributes.cs
index d1cb48f728..1e663fe103 100644
--- a/osu.Game.Rulesets.Mania/Difficulty/ManiaDifficultyAttributes.cs
+++ b/osu.Game.Rulesets.Mania/Difficulty/ManiaDifficultyAttributes.cs
@@ -15,9 +15,9 @@ namespace osu.Game.Rulesets.Mania.Difficulty
         [JsonProperty("score_multiplier")]
         public double ScoreMultiplier { get; set; }
 
-        public override IEnumerable<(int attributeId, object value)> ToDatabase()
+        public override IEnumerable<(int attributeId, object value)> ToDatabaseAttributes()
         {
-            foreach (var v in base.ToDatabase())
+            foreach (var v in base.ToDatabaseAttributes())
                 yield return v;
 
             // Todo: Mania doesn't output MaxCombo attribute for some reason.
@@ -26,9 +26,9 @@ namespace osu.Game.Rulesets.Mania.Difficulty
             yield return (15, ScoreMultiplier);
         }
 
-        public override void FromDatabase(IReadOnlyDictionary<int, double> values, int hitCircleCount, int spinnerCount)
+        public override void FromDatabaseAttributes(IReadOnlyDictionary<int, double> values)
         {
-            base.FromDatabase(values, hitCircleCount, spinnerCount);
+            base.FromDatabaseAttributes(values);
 
             StarRating = values[11];
             GreatHitWindow = values[13];
diff --git a/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyAttributes.cs b/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyAttributes.cs
index 089f163dfb..88f26db93c 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyAttributes.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyAttributes.cs
@@ -42,9 +42,9 @@ namespace osu.Game.Rulesets.Osu.Difficulty
         [JsonIgnore]
         public int SpinnerCount { get; set; }
 
-        public override IEnumerable<(int attributeId, object value)> ToDatabase()
+        public override IEnumerable<(int attributeId, object value)> ToDatabaseAttributes()
         {
-            foreach (var v in base.ToDatabase())
+            foreach (var v in base.ToDatabaseAttributes())
                 yield return v;
 
             yield return (1, AimStrain);
@@ -60,9 +60,9 @@ namespace osu.Game.Rulesets.Osu.Difficulty
             yield return (19, SliderFactor);
         }
 
-        public override void FromDatabase(IReadOnlyDictionary<int, double> values, int hitCircleCount, int spinnerCount)
+        public override void FromDatabaseAttributes(IReadOnlyDictionary<int, double> values)
         {
-            base.FromDatabase(values, hitCircleCount, spinnerCount);
+            base.FromDatabaseAttributes(values);
 
             AimStrain = values[1];
             SpeedStrain = values[3];
@@ -72,8 +72,6 @@ namespace osu.Game.Rulesets.Osu.Difficulty
             StarRating = values[11];
             FlashlightRating = values.GetValueOrDefault(17);
             SliderFactor = values[19];
-            HitCircleCount = hitCircleCount;
-            SpinnerCount = spinnerCount;
         }
 
         [UsedImplicitly]
diff --git a/osu.Game.Rulesets.Taiko/Difficulty/TaikoDifficultyAttributes.cs b/osu.Game.Rulesets.Taiko/Difficulty/TaikoDifficultyAttributes.cs
index b2208ea617..a6057d7952 100644
--- a/osu.Game.Rulesets.Taiko/Difficulty/TaikoDifficultyAttributes.cs
+++ b/osu.Game.Rulesets.Taiko/Difficulty/TaikoDifficultyAttributes.cs
@@ -24,9 +24,9 @@ namespace osu.Game.Rulesets.Taiko.Difficulty
         [JsonProperty("great_hit_window")]
         public double GreatHitWindow { get; set; }
 
-        public override IEnumerable<(int attributeId, object value)> ToDatabase()
+        public override IEnumerable<(int attributeId, object value)> ToDatabaseAttributes()
         {
-            foreach (var v in base.ToDatabase())
+            foreach (var v in base.ToDatabaseAttributes())
                 yield return v;
 
             yield return (9, MaxCombo);
@@ -34,9 +34,9 @@ namespace osu.Game.Rulesets.Taiko.Difficulty
             yield return (13, GreatHitWindow);
         }
 
-        public override void FromDatabase(IReadOnlyDictionary<int, double> values, int hitCircleCount, int spinnerCount)
+        public override void FromDatabaseAttributes(IReadOnlyDictionary<int, double> values)
         {
-            base.FromDatabase(values, hitCircleCount, spinnerCount);
+            base.FromDatabaseAttributes(values);
 
             MaxCombo = (int)values[9];
             StarRating = values[11];
diff --git a/osu.Game/Rulesets/Difficulty/DifficultyAttributes.cs b/osu.Game/Rulesets/Difficulty/DifficultyAttributes.cs
index 6a3b97ab1d..e25a8476f0 100644
--- a/osu.Game/Rulesets/Difficulty/DifficultyAttributes.cs
+++ b/osu.Game/Rulesets/Difficulty/DifficultyAttributes.cs
@@ -34,9 +34,9 @@ namespace osu.Game.Rulesets.Difficulty
             StarRating = starRating;
         }
 
-        public virtual IEnumerable<(int attributeId, object value)> ToDatabase() => Enumerable.Empty<(int, object)>();
+        public virtual IEnumerable<(int attributeId, object value)> ToDatabaseAttributes() => Enumerable.Empty<(int, object)>();
 
-        public virtual void FromDatabase(IReadOnlyDictionary<int, double> values, int hitCircleCount, int spinnerCount)
+        public virtual void FromDatabaseAttributes(IReadOnlyDictionary<int, double> values)
         {
         }
     }

From a0e25d18cd5f809bfade52754a652d318d47a805 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 15 Nov 2021 18:24:00 +0900
Subject: [PATCH 1022/5547] Expose more of `WorkingBeatmap` via interface

---
 osu.Game/Beatmaps/IWorkingBeatmap.cs | 65 +++++++++++++++++++++++++---
 osu.Game/Beatmaps/WorkingBeatmap.cs  | 21 ++++-----
 2 files changed, 66 insertions(+), 20 deletions(-)

diff --git a/osu.Game/Beatmaps/IWorkingBeatmap.cs b/osu.Game/Beatmaps/IWorkingBeatmap.cs
index a916b37b85..22a922db59 100644
--- a/osu.Game/Beatmaps/IWorkingBeatmap.cs
+++ b/osu.Game/Beatmaps/IWorkingBeatmap.cs
@@ -17,33 +17,69 @@ namespace osu.Game.Beatmaps
 {
     public interface IWorkingBeatmap
     {
+        IBeatmapInfo BeatmapInfo { get; }
+
+        IBeatmapSetInfo BeatmapSetInfo => BeatmapInfo.BeatmapSet;
+
+        IBeatmapMetadataInfo Metadata => BeatmapInfo.Metadata;
+
         /// <summary>
-        /// Retrieves the <see cref="IBeatmap"/> which this <see cref="WorkingBeatmap"/> represents.
+        /// Whether the Beatmap has finished loading.
+        ///</summary>
+        public bool BeatmapLoaded { get; }
+
+        /// <summary>
+        /// Whether the Background has finished loading.
+        ///</summary>
+        public bool BackgroundLoaded { get; }
+
+        /// <summary>
+        /// Whether the Waveform has finished loading.
+        ///</summary>
+        public bool WaveformLoaded { get; }
+
+        /// <summary>
+        /// Whether the Storyboard has finished loading.
+        ///</summary>
+        public bool StoryboardLoaded { get; }
+
+        /// <summary>
+        /// Whether the Skin has finished loading.
+        ///</summary>
+        public bool SkinLoaded { get; }
+
+        /// <summary>
+        /// Whether the Track has finished loading.
+        ///</summary>
+        public bool TrackLoaded { get; }
+
+        /// <summary>
+        /// Retrieves the <see cref="IBeatmap"/> which this <see cref="IWorkingBeatmap"/> represents.
         /// </summary>
         IBeatmap Beatmap { get; }
 
         /// <summary>
-        /// Retrieves the background for this <see cref="WorkingBeatmap"/>.
+        /// Retrieves the background for this <see cref="IWorkingBeatmap"/>.
         /// </summary>
         Texture Background { get; }
 
         /// <summary>
-        /// Retrieves the <see cref="Waveform"/> for the <see cref="Track"/> of this <see cref="WorkingBeatmap"/>.
+        /// Retrieves the <see cref="Waveform"/> for the <see cref="Track"/> of this <see cref="IWorkingBeatmap"/>.
         /// </summary>
         Waveform Waveform { get; }
 
         /// <summary>
-        /// Retrieves the <see cref="Storyboard"/> which this <see cref="WorkingBeatmap"/> provides.
+        /// Retrieves the <see cref="Storyboard"/> which this <see cref="IWorkingBeatmap"/> provides.
         /// </summary>
         Storyboard Storyboard { get; }
 
         /// <summary>
-        /// Retrieves the <see cref="Skin"/> which this <see cref="WorkingBeatmap"/> provides.
+        /// Retrieves the <see cref="Skin"/> which this <see cref="IWorkingBeatmap"/> provides.
         /// </summary>
         ISkin Skin { get; }
 
         /// <summary>
-        /// Retrieves the <see cref="Track"/> which this <see cref="WorkingBeatmap"/> has loaded.
+        /// Retrieves the <see cref="Track"/> which this <see cref="IWorkingBeatmap"/> has loaded.
         /// </summary>
         Track Track { get; }
 
@@ -67,7 +103,7 @@ namespace osu.Game.Beatmaps
         /// </summary>
         /// <remarks>
         /// In a standard game context, the loading of the track is managed solely by MusicController, which will
-        /// automatically load the track of the current global IBindable WorkingBeatmap.
+        /// automatically load the track of the current global IBindable IWorkingBeatmap.
         /// As such, this method should only be called in very special scenarios, such as external tests or apps which are
         /// outside of the game context.
         /// </remarks>
@@ -79,5 +115,20 @@ namespace osu.Game.Beatmaps
         /// </summary>
         /// <param name="storagePath">The storage path to the file.</param>
         Stream GetStream(string storagePath);
+
+        /// <summary>
+        /// Beings loading the contents of this <see cref="IWorkingBeatmap"/> asynchronously.
+        /// </summary>
+        public void BeginAsyncLoad();
+
+        /// <summary>
+        /// Cancels the asynchronous loading of the contents of this <see cref="IWorkingBeatmap"/>.
+        /// </summary>
+        public void CancelAsyncLoad();
+
+        /// <summary>
+        /// Reads the correct track restart point from beatmap metadata and sets looping to enabled.
+        /// </summary>
+        void PrepareTrackForPreviewLooping();
     }
 }
diff --git a/osu.Game/Beatmaps/WorkingBeatmap.cs b/osu.Game/Beatmaps/WorkingBeatmap.cs
index d2c0f7de0f..51eea94d3a 100644
--- a/osu.Game/Beatmaps/WorkingBeatmap.cs
+++ b/osu.Game/Beatmaps/WorkingBeatmap.cs
@@ -28,8 +28,10 @@ namespace osu.Game.Beatmaps
     {
         public readonly BeatmapInfo BeatmapInfo;
 
+        // ReSharper disable once FieldHidesInterfacePropertyWithDefaultImplementation
         public readonly BeatmapSetInfo BeatmapSetInfo;
 
+        // ReSharper disable once FieldHidesInterfacePropertyWithDefaultImplementation
         public readonly BeatmapMetadata Metadata;
 
         protected AudioManager AudioManager { get; }
@@ -89,6 +91,9 @@ namespace osu.Game.Beatmaps
 
                 var rulesetInstance = ruleset.CreateInstance();
 
+                if (rulesetInstance == null)
+                    throw new RulesetLoadException("Creating ruleset instance failed when attempting to create playable beatmap.");
+
                 IBeatmapConverter converter = CreateBeatmapConverter(Beatmap, rulesetInstance);
 
                 // Check if the beatmap can be converted
@@ -176,17 +181,8 @@ namespace osu.Game.Beatmaps
 
         private CancellationTokenSource loadCancellation = new CancellationTokenSource();
 
-        /// <summary>
-        /// Beings loading the contents of this <see cref="WorkingBeatmap"/> asynchronously.
-        /// </summary>
-        public void BeginAsyncLoad()
-        {
-            loadBeatmapAsync();
-        }
+        public void BeginAsyncLoad() => loadBeatmapAsync();
 
-        /// <summary>
-        /// Cancels the asynchronous loading of the contents of this <see cref="WorkingBeatmap"/>.
-        /// </summary>
         public void CancelAsyncLoad()
         {
             lock (beatmapFetchLock)
@@ -234,6 +230,8 @@ namespace osu.Game.Beatmaps
 
         public virtual bool BeatmapLoaded => beatmapLoadTask?.IsCompleted ?? false;
 
+        IBeatmapInfo IWorkingBeatmap.BeatmapInfo => BeatmapInfo;
+
         public IBeatmap Beatmap
         {
             get
@@ -273,9 +271,6 @@ namespace osu.Game.Beatmaps
         [NotNull]
         public Track LoadTrack() => loadedTrack = GetBeatmapTrack() ?? GetVirtualTrack(1000);
 
-        /// <summary>
-        /// Reads the correct track restart point from beatmap metadata and sets looping to enabled.
-        /// </summary>
         public void PrepareTrackForPreviewLooping()
         {
             Track.Looping = true;

From 62d670a3cac537459ebe3cfdcaf66a4df3cfc328 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 15 Nov 2021 18:19:23 +0900
Subject: [PATCH 1023/5547] Update `DifficultyCalculator` to take an
 `IWorkingBeatmap`

---
 .../EmptyFreeformDifficultyCalculator.cs                   | 2 +-
 .../EmptyFreeformRuleset.cs                                | 2 +-
 .../PippidonDifficultyCalculator.cs                        | 2 +-
 .../osu.Game.Rulesets.Pippidon/PippidonRuleset.cs          | 2 +-
 .../EmptyScrollingDifficultyCalculator.cs                  | 2 +-
 .../EmptyScrollingRuleset.cs                               | 2 +-
 .../PippidonDifficultyCalculator.cs                        | 2 +-
 .../osu.Game.Rulesets.Pippidon/PippidonRuleset.cs          | 2 +-
 osu.Game.Rulesets.Catch/CatchRuleset.cs                    | 2 +-
 .../Difficulty/CatchDifficultyCalculator.cs                | 2 +-
 .../Difficulty/ManiaDifficultyCalculator.cs                | 7 ++++---
 osu.Game.Rulesets.Mania/ManiaRuleset.cs                    | 2 +-
 .../Difficulty/OsuDifficultyCalculator.cs                  | 2 +-
 osu.Game.Rulesets.Osu/OsuRuleset.cs                        | 2 +-
 .../Difficulty/TaikoDifficultyCalculator.cs                | 2 +-
 osu.Game.Rulesets.Taiko/TaikoRuleset.cs                    | 2 +-
 osu.Game.Tests/Mods/ModDifficultyAdjustTest.cs             | 2 +-
 osu.Game.Tests/Online/TestAPIModJsonSerialization.cs       | 2 +-
 .../Online/TestAPIModMessagePackSerialization.cs           | 2 +-
 osu.Game.Tests/Testing/TestSceneRulesetDependencies.cs     | 2 +-
 .../Visual/Gameplay/TestSceneDrawableScrollingRuleset.cs   | 2 +-
 osu.Game.Tests/Visual/Gameplay/TestSceneKeyBindings.cs     | 2 +-
 osu.Game.Tests/Visual/Gameplay/TestScenePoolingRuleset.cs  | 2 +-
 .../Visual/UserInterface/TestSceneModSettings.cs           | 2 +-
 osu.Game/Beatmaps/DummyWorkingBeatmap.cs                   | 2 +-
 osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs       | 4 ++--
 osu.Game/Rulesets/Ruleset.cs                               | 4 ++--
 27 files changed, 32 insertions(+), 31 deletions(-)

diff --git a/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform/EmptyFreeformDifficultyCalculator.cs b/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform/EmptyFreeformDifficultyCalculator.cs
index a80f1178b6..34124a022d 100644
--- a/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform/EmptyFreeformDifficultyCalculator.cs
+++ b/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform/EmptyFreeformDifficultyCalculator.cs
@@ -13,7 +13,7 @@ namespace osu.Game.Rulesets.EmptyFreeform
 {
     public class EmptyFreeformDifficultyCalculator : DifficultyCalculator
     {
-        public EmptyFreeformDifficultyCalculator(Ruleset ruleset, WorkingBeatmap beatmap)
+        public EmptyFreeformDifficultyCalculator(Ruleset ruleset, IWorkingBeatmap beatmap)
             : base(ruleset, beatmap)
         {
         }
diff --git a/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform/EmptyFreeformRuleset.cs b/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform/EmptyFreeformRuleset.cs
index 96675e3e99..bd928404d5 100644
--- a/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform/EmptyFreeformRuleset.cs
+++ b/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform/EmptyFreeformRuleset.cs
@@ -30,7 +30,7 @@ namespace osu.Game.Rulesets.EmptyFreeform
         public override IBeatmapConverter CreateBeatmapConverter(IBeatmap beatmap) =>
             new EmptyFreeformBeatmapConverter(beatmap, this);
 
-        public override DifficultyCalculator CreateDifficultyCalculator(WorkingBeatmap beatmap) =>
+        public override DifficultyCalculator CreateDifficultyCalculator(IWorkingBeatmap beatmap) =>
             new EmptyFreeformDifficultyCalculator(this, beatmap);
 
         public override IEnumerable<Mod> GetModsFor(ModType type)
diff --git a/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon/PippidonDifficultyCalculator.cs b/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon/PippidonDifficultyCalculator.cs
index 290148d14b..ef484e27bc 100644
--- a/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon/PippidonDifficultyCalculator.cs
+++ b/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon/PippidonDifficultyCalculator.cs
@@ -13,7 +13,7 @@ namespace osu.Game.Rulesets.Pippidon
 {
     public class PippidonDifficultyCalculator : DifficultyCalculator
     {
-        public PippidonDifficultyCalculator(Ruleset ruleset, WorkingBeatmap beatmap)
+        public PippidonDifficultyCalculator(Ruleset ruleset, IWorkingBeatmap beatmap)
             : base(ruleset, beatmap)
         {
         }
diff --git a/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon/PippidonRuleset.cs b/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon/PippidonRuleset.cs
index 89fed791cd..5f463e71f8 100644
--- a/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon/PippidonRuleset.cs
+++ b/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon/PippidonRuleset.cs
@@ -26,7 +26,7 @@ namespace osu.Game.Rulesets.Pippidon
         public override IBeatmapConverter CreateBeatmapConverter(IBeatmap beatmap) =>
             new PippidonBeatmapConverter(beatmap, this);
 
-        public override DifficultyCalculator CreateDifficultyCalculator(WorkingBeatmap beatmap) =>
+        public override DifficultyCalculator CreateDifficultyCalculator(IWorkingBeatmap beatmap) =>
             new PippidonDifficultyCalculator(this, beatmap);
 
         public override IEnumerable<Mod> GetModsFor(ModType type)
diff --git a/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling/EmptyScrollingDifficultyCalculator.cs b/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling/EmptyScrollingDifficultyCalculator.cs
index f557a4c754..37c2b9f1eb 100644
--- a/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling/EmptyScrollingDifficultyCalculator.cs
+++ b/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling/EmptyScrollingDifficultyCalculator.cs
@@ -13,7 +13,7 @@ namespace osu.Game.Rulesets.EmptyScrolling
 {
     public class EmptyScrollingDifficultyCalculator : DifficultyCalculator
     {
-        public EmptyScrollingDifficultyCalculator(Ruleset ruleset, WorkingBeatmap beatmap)
+        public EmptyScrollingDifficultyCalculator(Ruleset ruleset, IWorkingBeatmap beatmap)
             : base(ruleset, beatmap)
         {
         }
diff --git a/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling/EmptyScrollingRuleset.cs b/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling/EmptyScrollingRuleset.cs
index c1d4de52b7..940eaa1a55 100644
--- a/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling/EmptyScrollingRuleset.cs
+++ b/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling/EmptyScrollingRuleset.cs
@@ -24,7 +24,7 @@ namespace osu.Game.Rulesets.EmptyScrolling
 
         public override IBeatmapConverter CreateBeatmapConverter(IBeatmap beatmap) => new EmptyScrollingBeatmapConverter(beatmap, this);
 
-        public override DifficultyCalculator CreateDifficultyCalculator(WorkingBeatmap beatmap) => new EmptyScrollingDifficultyCalculator(this, beatmap);
+        public override DifficultyCalculator CreateDifficultyCalculator(IWorkingBeatmap beatmap) => new EmptyScrollingDifficultyCalculator(this, beatmap);
 
         public override IEnumerable<Mod> GetModsFor(ModType type)
         {
diff --git a/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon/PippidonDifficultyCalculator.cs b/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon/PippidonDifficultyCalculator.cs
index 290148d14b..ef484e27bc 100644
--- a/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon/PippidonDifficultyCalculator.cs
+++ b/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon/PippidonDifficultyCalculator.cs
@@ -13,7 +13,7 @@ namespace osu.Game.Rulesets.Pippidon
 {
     public class PippidonDifficultyCalculator : DifficultyCalculator
     {
-        public PippidonDifficultyCalculator(Ruleset ruleset, WorkingBeatmap beatmap)
+        public PippidonDifficultyCalculator(Ruleset ruleset, IWorkingBeatmap beatmap)
             : base(ruleset, beatmap)
         {
         }
diff --git a/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon/PippidonRuleset.cs b/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon/PippidonRuleset.cs
index ede00f1510..4b1ef7c9a8 100644
--- a/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon/PippidonRuleset.cs
+++ b/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon/PippidonRuleset.cs
@@ -24,7 +24,7 @@ namespace osu.Game.Rulesets.Pippidon
 
         public override IBeatmapConverter CreateBeatmapConverter(IBeatmap beatmap) => new PippidonBeatmapConverter(beatmap, this);
 
-        public override DifficultyCalculator CreateDifficultyCalculator(WorkingBeatmap beatmap) => new PippidonDifficultyCalculator(this, beatmap);
+        public override DifficultyCalculator CreateDifficultyCalculator(IWorkingBeatmap beatmap) => new PippidonDifficultyCalculator(this, beatmap);
 
         public override IEnumerable<Mod> GetModsFor(ModType type)
         {
diff --git a/osu.Game.Rulesets.Catch/CatchRuleset.cs b/osu.Game.Rulesets.Catch/CatchRuleset.cs
index 93240d312b..c879398d23 100644
--- a/osu.Game.Rulesets.Catch/CatchRuleset.cs
+++ b/osu.Game.Rulesets.Catch/CatchRuleset.cs
@@ -178,7 +178,7 @@ namespace osu.Game.Rulesets.Catch
             return base.GetDisplayNameForHitResult(result);
         }
 
-        public override DifficultyCalculator CreateDifficultyCalculator(WorkingBeatmap beatmap) => new CatchDifficultyCalculator(this, beatmap);
+        public override DifficultyCalculator CreateDifficultyCalculator(IWorkingBeatmap beatmap) => new CatchDifficultyCalculator(this, beatmap);
 
         public override ISkin CreateLegacySkinProvider(ISkin skin, IBeatmap beatmap) => new CatchLegacySkinTransformer(skin);
 
diff --git a/osu.Game.Rulesets.Catch/Difficulty/CatchDifficultyCalculator.cs b/osu.Game.Rulesets.Catch/Difficulty/CatchDifficultyCalculator.cs
index 03a76f10ef..50ddbaba71 100644
--- a/osu.Game.Rulesets.Catch/Difficulty/CatchDifficultyCalculator.cs
+++ b/osu.Game.Rulesets.Catch/Difficulty/CatchDifficultyCalculator.cs
@@ -23,7 +23,7 @@ namespace osu.Game.Rulesets.Catch.Difficulty
 
         private float halfCatcherWidth;
 
-        public CatchDifficultyCalculator(Ruleset ruleset, WorkingBeatmap beatmap)
+        public CatchDifficultyCalculator(Ruleset ruleset, IWorkingBeatmap beatmap)
             : base(ruleset, beatmap)
         {
         }
diff --git a/osu.Game.Rulesets.Mania/Difficulty/ManiaDifficultyCalculator.cs b/osu.Game.Rulesets.Mania/Difficulty/ManiaDifficultyCalculator.cs
index aee3268544..640fdac225 100644
--- a/osu.Game.Rulesets.Mania/Difficulty/ManiaDifficultyCalculator.cs
+++ b/osu.Game.Rulesets.Mania/Difficulty/ManiaDifficultyCalculator.cs
@@ -5,6 +5,7 @@ using System;
 using System.Collections.Generic;
 using System.Linq;
 using osu.Game.Beatmaps;
+using osu.Game.Extensions;
 using osu.Game.Rulesets.Difficulty;
 using osu.Game.Rulesets.Difficulty.Preprocessing;
 using osu.Game.Rulesets.Difficulty.Skills;
@@ -28,11 +29,11 @@ namespace osu.Game.Rulesets.Mania.Difficulty
         private readonly bool isForCurrentRuleset;
         private readonly double originalOverallDifficulty;
 
-        public ManiaDifficultyCalculator(Ruleset ruleset, WorkingBeatmap beatmap)
+        public ManiaDifficultyCalculator(Ruleset ruleset, IWorkingBeatmap beatmap)
             : base(ruleset, beatmap)
         {
-            isForCurrentRuleset = beatmap.BeatmapInfo.Ruleset.Equals(ruleset.RulesetInfo);
-            originalOverallDifficulty = beatmap.BeatmapInfo.BaseDifficulty.OverallDifficulty;
+            isForCurrentRuleset = beatmap.BeatmapInfo.Ruleset.MatchesOnlineID(ruleset);
+            originalOverallDifficulty = beatmap.BeatmapInfo.Difficulty.OverallDifficulty;
         }
 
         protected override DifficultyAttributes CreateDifficultyAttributes(IBeatmap beatmap, Mod[] mods, Skill[] skills, double clockRate)
diff --git a/osu.Game.Rulesets.Mania/ManiaRuleset.cs b/osu.Game.Rulesets.Mania/ManiaRuleset.cs
index a9b16c61d4..d7d0fed846 100644
--- a/osu.Game.Rulesets.Mania/ManiaRuleset.cs
+++ b/osu.Game.Rulesets.Mania/ManiaRuleset.cs
@@ -272,7 +272,7 @@ namespace osu.Game.Rulesets.Mania
 
         public override Drawable CreateIcon() => new SpriteIcon { Icon = OsuIcon.RulesetMania };
 
-        public override DifficultyCalculator CreateDifficultyCalculator(WorkingBeatmap beatmap) => new ManiaDifficultyCalculator(this, beatmap);
+        public override DifficultyCalculator CreateDifficultyCalculator(IWorkingBeatmap beatmap) => new ManiaDifficultyCalculator(this, beatmap);
 
         public int LegacyID => 3;
 
diff --git a/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs b/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs
index 558ddc16ef..892b8da527 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs
@@ -23,7 +23,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty
         private const double difficulty_multiplier = 0.0675;
         private double hitWindowGreat;
 
-        public OsuDifficultyCalculator(Ruleset ruleset, WorkingBeatmap beatmap)
+        public OsuDifficultyCalculator(Ruleset ruleset, IWorkingBeatmap beatmap)
             : base(ruleset, beatmap)
         {
         }
diff --git a/osu.Game.Rulesets.Osu/OsuRuleset.cs b/osu.Game.Rulesets.Osu/OsuRuleset.cs
index ee4712c3b8..6d50dc0a06 100644
--- a/osu.Game.Rulesets.Osu/OsuRuleset.cs
+++ b/osu.Game.Rulesets.Osu/OsuRuleset.cs
@@ -208,7 +208,7 @@ namespace osu.Game.Rulesets.Osu
 
         public override Drawable CreateIcon() => new SpriteIcon { Icon = OsuIcon.RulesetOsu };
 
-        public override DifficultyCalculator CreateDifficultyCalculator(WorkingBeatmap beatmap) => new OsuDifficultyCalculator(this, beatmap);
+        public override DifficultyCalculator CreateDifficultyCalculator(IWorkingBeatmap beatmap) => new OsuDifficultyCalculator(this, beatmap);
 
         public override PerformanceCalculator CreatePerformanceCalculator(DifficultyAttributes attributes, ScoreInfo score) => new OsuPerformanceCalculator(this, attributes, score);
 
diff --git a/osu.Game.Rulesets.Taiko/Difficulty/TaikoDifficultyCalculator.cs b/osu.Game.Rulesets.Taiko/Difficulty/TaikoDifficultyCalculator.cs
index 7dd47e804b..31d7304184 100644
--- a/osu.Game.Rulesets.Taiko/Difficulty/TaikoDifficultyCalculator.cs
+++ b/osu.Game.Rulesets.Taiko/Difficulty/TaikoDifficultyCalculator.cs
@@ -24,7 +24,7 @@ namespace osu.Game.Rulesets.Taiko.Difficulty
         private const double colour_skill_multiplier = 0.01;
         private const double stamina_skill_multiplier = 0.02;
 
-        public TaikoDifficultyCalculator(Ruleset ruleset, WorkingBeatmap beatmap)
+        public TaikoDifficultyCalculator(Ruleset ruleset, IWorkingBeatmap beatmap)
             : base(ruleset, beatmap)
         {
         }
diff --git a/osu.Game.Rulesets.Taiko/TaikoRuleset.cs b/osu.Game.Rulesets.Taiko/TaikoRuleset.cs
index adc924ba38..e4dea77377 100644
--- a/osu.Game.Rulesets.Taiko/TaikoRuleset.cs
+++ b/osu.Game.Rulesets.Taiko/TaikoRuleset.cs
@@ -168,7 +168,7 @@ namespace osu.Game.Rulesets.Taiko
 
         public override HitObjectComposer CreateHitObjectComposer() => new TaikoHitObjectComposer(this);
 
-        public override DifficultyCalculator CreateDifficultyCalculator(WorkingBeatmap beatmap) => new TaikoDifficultyCalculator(this, beatmap);
+        public override DifficultyCalculator CreateDifficultyCalculator(IWorkingBeatmap beatmap) => new TaikoDifficultyCalculator(this, beatmap);
 
         public override PerformanceCalculator CreatePerformanceCalculator(DifficultyAttributes attributes, ScoreInfo score) => new TaikoPerformanceCalculator(this, attributes, score);
 
diff --git a/osu.Game.Tests/Mods/ModDifficultyAdjustTest.cs b/osu.Game.Tests/Mods/ModDifficultyAdjustTest.cs
index fd620a0e95..85b4688eb9 100644
--- a/osu.Game.Tests/Mods/ModDifficultyAdjustTest.cs
+++ b/osu.Game.Tests/Mods/ModDifficultyAdjustTest.cs
@@ -156,7 +156,7 @@ namespace osu.Game.Tests.Mods
                 throw new System.NotImplementedException();
             }
 
-            public override DifficultyCalculator CreateDifficultyCalculator(WorkingBeatmap beatmap)
+            public override DifficultyCalculator CreateDifficultyCalculator(IWorkingBeatmap beatmap)
             {
                 throw new System.NotImplementedException();
             }
diff --git a/osu.Game.Tests/Online/TestAPIModJsonSerialization.cs b/osu.Game.Tests/Online/TestAPIModJsonSerialization.cs
index 656e333073..8378b33b3d 100644
--- a/osu.Game.Tests/Online/TestAPIModJsonSerialization.cs
+++ b/osu.Game.Tests/Online/TestAPIModJsonSerialization.cs
@@ -128,7 +128,7 @@ namespace osu.Game.Tests.Online
 
             public override IBeatmapConverter CreateBeatmapConverter(IBeatmap beatmap) => throw new NotImplementedException();
 
-            public override DifficultyCalculator CreateDifficultyCalculator(WorkingBeatmap beatmap) => throw new NotImplementedException();
+            public override DifficultyCalculator CreateDifficultyCalculator(IWorkingBeatmap beatmap) => throw new NotImplementedException();
 
             public override string Description { get; } = string.Empty;
             public override string ShortName { get; } = string.Empty;
diff --git a/osu.Game.Tests/Online/TestAPIModMessagePackSerialization.cs b/osu.Game.Tests/Online/TestAPIModMessagePackSerialization.cs
index 0462e9feb5..69e19826fd 100644
--- a/osu.Game.Tests/Online/TestAPIModMessagePackSerialization.cs
+++ b/osu.Game.Tests/Online/TestAPIModMessagePackSerialization.cs
@@ -90,7 +90,7 @@ namespace osu.Game.Tests.Online
 
             public override IBeatmapConverter CreateBeatmapConverter(IBeatmap beatmap) => throw new System.NotImplementedException();
 
-            public override DifficultyCalculator CreateDifficultyCalculator(WorkingBeatmap beatmap) => throw new System.NotImplementedException();
+            public override DifficultyCalculator CreateDifficultyCalculator(IWorkingBeatmap beatmap) => throw new System.NotImplementedException();
 
             public override string Description { get; } = string.Empty;
             public override string ShortName { get; } = string.Empty;
diff --git a/osu.Game.Tests/Testing/TestSceneRulesetDependencies.cs b/osu.Game.Tests/Testing/TestSceneRulesetDependencies.cs
index 8c6932e792..bb9b705c7e 100644
--- a/osu.Game.Tests/Testing/TestSceneRulesetDependencies.cs
+++ b/osu.Game.Tests/Testing/TestSceneRulesetDependencies.cs
@@ -79,7 +79,7 @@ namespace osu.Game.Tests.Testing
             public override IEnumerable<Mod> GetModsFor(ModType type) => Array.Empty<Mod>();
             public override DrawableRuleset CreateDrawableRulesetWith(IBeatmap beatmap, IReadOnlyList<Mod> mods = null) => null;
             public override IBeatmapConverter CreateBeatmapConverter(IBeatmap beatmap) => null;
-            public override DifficultyCalculator CreateDifficultyCalculator(WorkingBeatmap beatmap) => null;
+            public override DifficultyCalculator CreateDifficultyCalculator(IWorkingBeatmap beatmap) => null;
         }
 
         private class TestRulesetConfigManager : IRulesetConfigManager
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneDrawableScrollingRuleset.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneDrawableScrollingRuleset.cs
index 3f10d7892d..e1755b8fc3 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneDrawableScrollingRuleset.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneDrawableScrollingRuleset.cs
@@ -293,7 +293,7 @@ namespace osu.Game.Tests.Visual.Gameplay
 
             public override IBeatmapConverter CreateBeatmapConverter(IBeatmap beatmap) => new TestBeatmapConverter(beatmap, null);
 
-            public override DifficultyCalculator CreateDifficultyCalculator(WorkingBeatmap beatmap) => throw new NotImplementedException();
+            public override DifficultyCalculator CreateDifficultyCalculator(IWorkingBeatmap beatmap) => throw new NotImplementedException();
 
             public override string Description { get; } = string.Empty;
 
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneKeyBindings.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneKeyBindings.cs
index 0a39d94027..883b8a1ae0 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneKeyBindings.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneKeyBindings.cs
@@ -49,7 +49,7 @@ namespace osu.Game.Tests.Visual.Gameplay
             public override IBeatmapConverter CreateBeatmapConverter(IBeatmap beatmap) =>
                 throw new System.NotImplementedException();
 
-            public override DifficultyCalculator CreateDifficultyCalculator(WorkingBeatmap beatmap) =>
+            public override DifficultyCalculator CreateDifficultyCalculator(IWorkingBeatmap beatmap) =>
                 throw new System.NotImplementedException();
 
             public override IEnumerable<KeyBinding> GetDefaultKeyBindings(int variant = 0)
diff --git a/osu.Game.Tests/Visual/Gameplay/TestScenePoolingRuleset.cs b/osu.Game.Tests/Visual/Gameplay/TestScenePoolingRuleset.cs
index 17a009a2ce..911fffbe7f 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestScenePoolingRuleset.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestScenePoolingRuleset.cs
@@ -182,7 +182,7 @@ namespace osu.Game.Tests.Visual.Gameplay
 
             public override IBeatmapConverter CreateBeatmapConverter(IBeatmap beatmap) => new TestBeatmapConverter(beatmap, this);
 
-            public override DifficultyCalculator CreateDifficultyCalculator(WorkingBeatmap beatmap) => throw new NotImplementedException();
+            public override DifficultyCalculator CreateDifficultyCalculator(IWorkingBeatmap beatmap) => throw new NotImplementedException();
 
             public override string Description { get; } = string.Empty;
 
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneModSettings.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneModSettings.cs
index da0fa5d76d..4bb5e29589 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneModSettings.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneModSettings.cs
@@ -199,7 +199,7 @@ namespace osu.Game.Tests.Visual.UserInterface
 
                 public override IBeatmapConverter CreateBeatmapConverter(IBeatmap beatmap) => throw new NotImplementedException();
 
-                public override DifficultyCalculator CreateDifficultyCalculator(WorkingBeatmap beatmap) => throw new NotImplementedException();
+                public override DifficultyCalculator CreateDifficultyCalculator(IWorkingBeatmap beatmap) => throw new NotImplementedException();
 
                 public override string Description { get; } = "test";
                 public override string ShortName { get; } = "tst";
diff --git a/osu.Game/Beatmaps/DummyWorkingBeatmap.cs b/osu.Game/Beatmaps/DummyWorkingBeatmap.cs
index acfd01a3c8..fcb44c462d 100644
--- a/osu.Game/Beatmaps/DummyWorkingBeatmap.cs
+++ b/osu.Game/Beatmaps/DummyWorkingBeatmap.cs
@@ -69,7 +69,7 @@ namespace osu.Game.Beatmaps
 
                 public override IBeatmapConverter CreateBeatmapConverter(IBeatmap beatmap) => new DummyBeatmapConverter { Beatmap = beatmap };
 
-                public override DifficultyCalculator CreateDifficultyCalculator(WorkingBeatmap beatmap) => null;
+                public override DifficultyCalculator CreateDifficultyCalculator(IWorkingBeatmap beatmap) => null;
 
                 public override string Description => "dummy";
 
diff --git a/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs b/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs
index 5b4284dc2f..f9855a819f 100644
--- a/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs
+++ b/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs
@@ -27,9 +27,9 @@ namespace osu.Game.Rulesets.Difficulty
         private double clockRate;
 
         private readonly Ruleset ruleset;
-        private readonly WorkingBeatmap beatmap;
+        private readonly IWorkingBeatmap beatmap;
 
-        protected DifficultyCalculator(Ruleset ruleset, WorkingBeatmap beatmap)
+        protected DifficultyCalculator(Ruleset ruleset, IWorkingBeatmap beatmap)
         {
             this.ruleset = ruleset;
             this.beatmap = beatmap;
diff --git a/osu.Game/Rulesets/Ruleset.cs b/osu.Game/Rulesets/Ruleset.cs
index b0c3836774..ade763eed8 100644
--- a/osu.Game/Rulesets/Ruleset.cs
+++ b/osu.Game/Rulesets/Ruleset.cs
@@ -222,7 +222,7 @@ namespace osu.Game.Rulesets
         /// <returns>The <see cref="IBeatmapProcessor"/>.</returns>
         public virtual IBeatmapProcessor CreateBeatmapProcessor(IBeatmap beatmap) => null;
 
-        public abstract DifficultyCalculator CreateDifficultyCalculator(WorkingBeatmap beatmap);
+        public abstract DifficultyCalculator CreateDifficultyCalculator(IWorkingBeatmap beatmap);
 
         /// <summary>
         /// Optionally creates a <see cref="PerformanceCalculator"/> to generate performance data from the provided score.
@@ -240,7 +240,7 @@ namespace osu.Game.Rulesets
         /// <param name="score">The score to be processed.</param>
         /// <returns>A performance calculator instance for the provided score.</returns>
         [CanBeNull]
-        public PerformanceCalculator CreatePerformanceCalculator(WorkingBeatmap beatmap, ScoreInfo score)
+        public PerformanceCalculator CreatePerformanceCalculator(IWorkingBeatmap beatmap, ScoreInfo score)
         {
             var difficultyCalculator = CreateDifficultyCalculator(beatmap);
             var difficultyAttributes = difficultyCalculator.Calculate(score.Mods);

From 369b4ba789be41026c54979b24872284fb536e13 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 15 Nov 2021 18:23:03 +0900
Subject: [PATCH 1024/5547] Update `DifficultyCalculator` to take an
 `IRulesetInfo`

---
 .../EmptyFreeformDifficultyCalculator.cs                    | 2 +-
 .../osu.Game.Rulesets.EmptyFreeform/EmptyFreeformRuleset.cs | 2 +-
 .../PippidonDifficultyCalculator.cs                         | 2 +-
 .../osu.Game.Rulesets.Pippidon/PippidonRuleset.cs           | 2 +-
 .../EmptyScrollingDifficultyCalculator.cs                   | 2 +-
 .../EmptyScrollingRuleset.cs                                | 2 +-
 .../PippidonDifficultyCalculator.cs                         | 2 +-
 .../osu.Game.Rulesets.Pippidon/PippidonRuleset.cs           | 2 +-
 .../CatchDifficultyCalculatorTest.cs                        | 2 +-
 osu.Game.Rulesets.Catch/CatchRuleset.cs                     | 2 +-
 .../Difficulty/CatchDifficultyCalculator.cs                 | 2 +-
 .../ManiaDifficultyCalculatorTest.cs                        | 2 +-
 .../Difficulty/ManiaDifficultyCalculator.cs                 | 2 +-
 osu.Game.Rulesets.Mania/ManiaRuleset.cs                     | 2 +-
 osu.Game.Rulesets.Osu.Tests/OsuDifficultyCalculatorTest.cs  | 2 +-
 osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs | 2 +-
 osu.Game.Rulesets.Osu/OsuRuleset.cs                         | 2 +-
 .../TaikoDifficultyCalculatorTest.cs                        | 2 +-
 .../Difficulty/TaikoDifficultyCalculator.cs                 | 2 +-
 osu.Game.Rulesets.Taiko/TaikoRuleset.cs                     | 2 +-
 osu.Game/Beatmaps/IWorkingBeatmap.cs                        | 2 +-
 osu.Game/Beatmaps/WorkingBeatmap.cs                         | 2 +-
 osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs        | 6 +++---
 osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs       | 2 +-
 24 files changed, 26 insertions(+), 26 deletions(-)

diff --git a/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform/EmptyFreeformDifficultyCalculator.cs b/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform/EmptyFreeformDifficultyCalculator.cs
index 34124a022d..79be2b27da 100644
--- a/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform/EmptyFreeformDifficultyCalculator.cs
+++ b/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform/EmptyFreeformDifficultyCalculator.cs
@@ -13,7 +13,7 @@ namespace osu.Game.Rulesets.EmptyFreeform
 {
     public class EmptyFreeformDifficultyCalculator : DifficultyCalculator
     {
-        public EmptyFreeformDifficultyCalculator(Ruleset ruleset, IWorkingBeatmap beatmap)
+        public EmptyFreeformDifficultyCalculator(IRulesetInfo ruleset, IWorkingBeatmap beatmap)
             : base(ruleset, beatmap)
         {
         }
diff --git a/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform/EmptyFreeformRuleset.cs b/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform/EmptyFreeformRuleset.cs
index bd928404d5..baf503085d 100644
--- a/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform/EmptyFreeformRuleset.cs
+++ b/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform/EmptyFreeformRuleset.cs
@@ -31,7 +31,7 @@ namespace osu.Game.Rulesets.EmptyFreeform
             new EmptyFreeformBeatmapConverter(beatmap, this);
 
         public override DifficultyCalculator CreateDifficultyCalculator(IWorkingBeatmap beatmap) =>
-            new EmptyFreeformDifficultyCalculator(this, beatmap);
+            new EmptyFreeformDifficultyCalculator(RulesetInfo, beatmap);
 
         public override IEnumerable<Mod> GetModsFor(ModType type)
         {
diff --git a/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon/PippidonDifficultyCalculator.cs b/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon/PippidonDifficultyCalculator.cs
index ef484e27bc..c612512938 100644
--- a/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon/PippidonDifficultyCalculator.cs
+++ b/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon/PippidonDifficultyCalculator.cs
@@ -13,7 +13,7 @@ namespace osu.Game.Rulesets.Pippidon
 {
     public class PippidonDifficultyCalculator : DifficultyCalculator
     {
-        public PippidonDifficultyCalculator(Ruleset ruleset, IWorkingBeatmap beatmap)
+        public PippidonDifficultyCalculator(IRulesetInfo ruleset, IWorkingBeatmap beatmap)
             : base(ruleset, beatmap)
         {
         }
diff --git a/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon/PippidonRuleset.cs b/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon/PippidonRuleset.cs
index 5f463e71f8..15e988f466 100644
--- a/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon/PippidonRuleset.cs
+++ b/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon/PippidonRuleset.cs
@@ -27,7 +27,7 @@ namespace osu.Game.Rulesets.Pippidon
             new PippidonBeatmapConverter(beatmap, this);
 
         public override DifficultyCalculator CreateDifficultyCalculator(IWorkingBeatmap beatmap) =>
-            new PippidonDifficultyCalculator(this, beatmap);
+            new PippidonDifficultyCalculator(RulesetInfo, beatmap);
 
         public override IEnumerable<Mod> GetModsFor(ModType type)
         {
diff --git a/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling/EmptyScrollingDifficultyCalculator.cs b/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling/EmptyScrollingDifficultyCalculator.cs
index 37c2b9f1eb..4628e6696b 100644
--- a/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling/EmptyScrollingDifficultyCalculator.cs
+++ b/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling/EmptyScrollingDifficultyCalculator.cs
@@ -13,7 +13,7 @@ namespace osu.Game.Rulesets.EmptyScrolling
 {
     public class EmptyScrollingDifficultyCalculator : DifficultyCalculator
     {
-        public EmptyScrollingDifficultyCalculator(Ruleset ruleset, IWorkingBeatmap beatmap)
+        public EmptyScrollingDifficultyCalculator(IRulesetInfo ruleset, IWorkingBeatmap beatmap)
             : base(ruleset, beatmap)
         {
         }
diff --git a/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling/EmptyScrollingRuleset.cs b/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling/EmptyScrollingRuleset.cs
index 940eaa1a55..b9bed74c88 100644
--- a/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling/EmptyScrollingRuleset.cs
+++ b/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling/EmptyScrollingRuleset.cs
@@ -24,7 +24,7 @@ namespace osu.Game.Rulesets.EmptyScrolling
 
         public override IBeatmapConverter CreateBeatmapConverter(IBeatmap beatmap) => new EmptyScrollingBeatmapConverter(beatmap, this);
 
-        public override DifficultyCalculator CreateDifficultyCalculator(IWorkingBeatmap beatmap) => new EmptyScrollingDifficultyCalculator(this, beatmap);
+        public override DifficultyCalculator CreateDifficultyCalculator(IWorkingBeatmap beatmap) => new EmptyScrollingDifficultyCalculator(RulesetInfo, beatmap);
 
         public override IEnumerable<Mod> GetModsFor(ModType type)
         {
diff --git a/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon/PippidonDifficultyCalculator.cs b/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon/PippidonDifficultyCalculator.cs
index ef484e27bc..c612512938 100644
--- a/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon/PippidonDifficultyCalculator.cs
+++ b/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon/PippidonDifficultyCalculator.cs
@@ -13,7 +13,7 @@ namespace osu.Game.Rulesets.Pippidon
 {
     public class PippidonDifficultyCalculator : DifficultyCalculator
     {
-        public PippidonDifficultyCalculator(Ruleset ruleset, IWorkingBeatmap beatmap)
+        public PippidonDifficultyCalculator(IRulesetInfo ruleset, IWorkingBeatmap beatmap)
             : base(ruleset, beatmap)
         {
         }
diff --git a/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon/PippidonRuleset.cs b/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon/PippidonRuleset.cs
index 4b1ef7c9a8..ea94ceb4b5 100644
--- a/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon/PippidonRuleset.cs
+++ b/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon/PippidonRuleset.cs
@@ -24,7 +24,7 @@ namespace osu.Game.Rulesets.Pippidon
 
         public override IBeatmapConverter CreateBeatmapConverter(IBeatmap beatmap) => new PippidonBeatmapConverter(beatmap, this);
 
-        public override DifficultyCalculator CreateDifficultyCalculator(IWorkingBeatmap beatmap) => new PippidonDifficultyCalculator(this, beatmap);
+        public override DifficultyCalculator CreateDifficultyCalculator(IWorkingBeatmap beatmap) => new PippidonDifficultyCalculator(RulesetInfo, beatmap);
 
         public override IEnumerable<Mod> GetModsFor(ModType type)
         {
diff --git a/osu.Game.Rulesets.Catch.Tests/CatchDifficultyCalculatorTest.cs b/osu.Game.Rulesets.Catch.Tests/CatchDifficultyCalculatorTest.cs
index 2fab47f857..971c47a3b1 100644
--- a/osu.Game.Rulesets.Catch.Tests/CatchDifficultyCalculatorTest.cs
+++ b/osu.Game.Rulesets.Catch.Tests/CatchDifficultyCalculatorTest.cs
@@ -22,7 +22,7 @@ namespace osu.Game.Rulesets.Catch.Tests
         public void TestClockRateAdjusted(double expected, string name)
             => Test(expected, name, new CatchModDoubleTime());
 
-        protected override DifficultyCalculator CreateDifficultyCalculator(WorkingBeatmap beatmap) => new CatchDifficultyCalculator(new CatchRuleset(), beatmap);
+        protected override DifficultyCalculator CreateDifficultyCalculator(WorkingBeatmap beatmap) => new CatchDifficultyCalculator(new CatchRuleset().RulesetInfo, beatmap);
 
         protected override Ruleset CreateRuleset() => new CatchRuleset();
     }
diff --git a/osu.Game.Rulesets.Catch/CatchRuleset.cs b/osu.Game.Rulesets.Catch/CatchRuleset.cs
index c879398d23..70d11c42e5 100644
--- a/osu.Game.Rulesets.Catch/CatchRuleset.cs
+++ b/osu.Game.Rulesets.Catch/CatchRuleset.cs
@@ -178,7 +178,7 @@ namespace osu.Game.Rulesets.Catch
             return base.GetDisplayNameForHitResult(result);
         }
 
-        public override DifficultyCalculator CreateDifficultyCalculator(IWorkingBeatmap beatmap) => new CatchDifficultyCalculator(this, beatmap);
+        public override DifficultyCalculator CreateDifficultyCalculator(IWorkingBeatmap beatmap) => new CatchDifficultyCalculator(RulesetInfo, beatmap);
 
         public override ISkin CreateLegacySkinProvider(ISkin skin, IBeatmap beatmap) => new CatchLegacySkinTransformer(skin);
 
diff --git a/osu.Game.Rulesets.Catch/Difficulty/CatchDifficultyCalculator.cs b/osu.Game.Rulesets.Catch/Difficulty/CatchDifficultyCalculator.cs
index 50ddbaba71..77a783a10d 100644
--- a/osu.Game.Rulesets.Catch/Difficulty/CatchDifficultyCalculator.cs
+++ b/osu.Game.Rulesets.Catch/Difficulty/CatchDifficultyCalculator.cs
@@ -23,7 +23,7 @@ namespace osu.Game.Rulesets.Catch.Difficulty
 
         private float halfCatcherWidth;
 
-        public CatchDifficultyCalculator(Ruleset ruleset, IWorkingBeatmap beatmap)
+        public CatchDifficultyCalculator(IRulesetInfo ruleset, IWorkingBeatmap beatmap)
             : base(ruleset, beatmap)
         {
         }
diff --git a/osu.Game.Rulesets.Mania.Tests/ManiaDifficultyCalculatorTest.cs b/osu.Game.Rulesets.Mania.Tests/ManiaDifficultyCalculatorTest.cs
index 6e6500a339..a1cae855cf 100644
--- a/osu.Game.Rulesets.Mania.Tests/ManiaDifficultyCalculatorTest.cs
+++ b/osu.Game.Rulesets.Mania.Tests/ManiaDifficultyCalculatorTest.cs
@@ -22,7 +22,7 @@ namespace osu.Game.Rulesets.Mania.Tests
         public void TestClockRateAdjusted(double expected, string name)
             => Test(expected, name, new ManiaModDoubleTime());
 
-        protected override DifficultyCalculator CreateDifficultyCalculator(WorkingBeatmap beatmap) => new ManiaDifficultyCalculator(new ManiaRuleset(), beatmap);
+        protected override DifficultyCalculator CreateDifficultyCalculator(WorkingBeatmap beatmap) => new ManiaDifficultyCalculator(new ManiaRuleset().RulesetInfo, beatmap);
 
         protected override Ruleset CreateRuleset() => new ManiaRuleset();
     }
diff --git a/osu.Game.Rulesets.Mania/Difficulty/ManiaDifficultyCalculator.cs b/osu.Game.Rulesets.Mania/Difficulty/ManiaDifficultyCalculator.cs
index 640fdac225..0040df72aa 100644
--- a/osu.Game.Rulesets.Mania/Difficulty/ManiaDifficultyCalculator.cs
+++ b/osu.Game.Rulesets.Mania/Difficulty/ManiaDifficultyCalculator.cs
@@ -29,7 +29,7 @@ namespace osu.Game.Rulesets.Mania.Difficulty
         private readonly bool isForCurrentRuleset;
         private readonly double originalOverallDifficulty;
 
-        public ManiaDifficultyCalculator(Ruleset ruleset, IWorkingBeatmap beatmap)
+        public ManiaDifficultyCalculator(IRulesetInfo ruleset, IWorkingBeatmap beatmap)
             : base(ruleset, beatmap)
         {
             isForCurrentRuleset = beatmap.BeatmapInfo.Ruleset.MatchesOnlineID(ruleset);
diff --git a/osu.Game.Rulesets.Mania/ManiaRuleset.cs b/osu.Game.Rulesets.Mania/ManiaRuleset.cs
index d7d0fed846..b0e7545d3e 100644
--- a/osu.Game.Rulesets.Mania/ManiaRuleset.cs
+++ b/osu.Game.Rulesets.Mania/ManiaRuleset.cs
@@ -272,7 +272,7 @@ namespace osu.Game.Rulesets.Mania
 
         public override Drawable CreateIcon() => new SpriteIcon { Icon = OsuIcon.RulesetMania };
 
-        public override DifficultyCalculator CreateDifficultyCalculator(IWorkingBeatmap beatmap) => new ManiaDifficultyCalculator(this, beatmap);
+        public override DifficultyCalculator CreateDifficultyCalculator(IWorkingBeatmap beatmap) => new ManiaDifficultyCalculator(RulesetInfo, beatmap);
 
         public int LegacyID => 3;
 
diff --git a/osu.Game.Rulesets.Osu.Tests/OsuDifficultyCalculatorTest.cs b/osu.Game.Rulesets.Osu.Tests/OsuDifficultyCalculatorTest.cs
index 9148f0715c..6150927826 100644
--- a/osu.Game.Rulesets.Osu.Tests/OsuDifficultyCalculatorTest.cs
+++ b/osu.Game.Rulesets.Osu.Tests/OsuDifficultyCalculatorTest.cs
@@ -25,7 +25,7 @@ namespace osu.Game.Rulesets.Osu.Tests
         public void TestClockRateAdjusted(double expected, string name)
             => Test(expected, name, new OsuModDoubleTime());
 
-        protected override DifficultyCalculator CreateDifficultyCalculator(WorkingBeatmap beatmap) => new OsuDifficultyCalculator(new OsuRuleset(), beatmap);
+        protected override DifficultyCalculator CreateDifficultyCalculator(WorkingBeatmap beatmap) => new OsuDifficultyCalculator(new OsuRuleset().RulesetInfo, beatmap);
 
         protected override Ruleset CreateRuleset() => new OsuRuleset();
     }
diff --git a/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs b/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs
index 892b8da527..3b4e85d0d3 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs
@@ -23,7 +23,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty
         private const double difficulty_multiplier = 0.0675;
         private double hitWindowGreat;
 
-        public OsuDifficultyCalculator(Ruleset ruleset, IWorkingBeatmap beatmap)
+        public OsuDifficultyCalculator(IRulesetInfo ruleset, IWorkingBeatmap beatmap)
             : base(ruleset, beatmap)
         {
         }
diff --git a/osu.Game.Rulesets.Osu/OsuRuleset.cs b/osu.Game.Rulesets.Osu/OsuRuleset.cs
index 6d50dc0a06..18e4bb259c 100644
--- a/osu.Game.Rulesets.Osu/OsuRuleset.cs
+++ b/osu.Game.Rulesets.Osu/OsuRuleset.cs
@@ -208,7 +208,7 @@ namespace osu.Game.Rulesets.Osu
 
         public override Drawable CreateIcon() => new SpriteIcon { Icon = OsuIcon.RulesetOsu };
 
-        public override DifficultyCalculator CreateDifficultyCalculator(IWorkingBeatmap beatmap) => new OsuDifficultyCalculator(this, beatmap);
+        public override DifficultyCalculator CreateDifficultyCalculator(IWorkingBeatmap beatmap) => new OsuDifficultyCalculator(RulesetInfo, beatmap);
 
         public override PerformanceCalculator CreatePerformanceCalculator(DifficultyAttributes attributes, ScoreInfo score) => new OsuPerformanceCalculator(this, attributes, score);
 
diff --git a/osu.Game.Rulesets.Taiko.Tests/TaikoDifficultyCalculatorTest.cs b/osu.Game.Rulesets.Taiko.Tests/TaikoDifficultyCalculatorTest.cs
index 4b0b74ad27..a44c6a1ded 100644
--- a/osu.Game.Rulesets.Taiko.Tests/TaikoDifficultyCalculatorTest.cs
+++ b/osu.Game.Rulesets.Taiko.Tests/TaikoDifficultyCalculatorTest.cs
@@ -24,7 +24,7 @@ namespace osu.Game.Rulesets.Taiko.Tests
         public void TestClockRateAdjusted(double expected, string name)
             => Test(expected, name, new TaikoModDoubleTime());
 
-        protected override DifficultyCalculator CreateDifficultyCalculator(WorkingBeatmap beatmap) => new TaikoDifficultyCalculator(new TaikoRuleset(), beatmap);
+        protected override DifficultyCalculator CreateDifficultyCalculator(WorkingBeatmap beatmap) => new TaikoDifficultyCalculator(new TaikoRuleset().RulesetInfo, beatmap);
 
         protected override Ruleset CreateRuleset() => new TaikoRuleset();
     }
diff --git a/osu.Game.Rulesets.Taiko/Difficulty/TaikoDifficultyCalculator.cs b/osu.Game.Rulesets.Taiko/Difficulty/TaikoDifficultyCalculator.cs
index 31d7304184..606afdbabc 100644
--- a/osu.Game.Rulesets.Taiko/Difficulty/TaikoDifficultyCalculator.cs
+++ b/osu.Game.Rulesets.Taiko/Difficulty/TaikoDifficultyCalculator.cs
@@ -24,7 +24,7 @@ namespace osu.Game.Rulesets.Taiko.Difficulty
         private const double colour_skill_multiplier = 0.01;
         private const double stamina_skill_multiplier = 0.02;
 
-        public TaikoDifficultyCalculator(Ruleset ruleset, IWorkingBeatmap beatmap)
+        public TaikoDifficultyCalculator(IRulesetInfo ruleset, IWorkingBeatmap beatmap)
             : base(ruleset, beatmap)
         {
         }
diff --git a/osu.Game.Rulesets.Taiko/TaikoRuleset.cs b/osu.Game.Rulesets.Taiko/TaikoRuleset.cs
index e4dea77377..ca860f24c3 100644
--- a/osu.Game.Rulesets.Taiko/TaikoRuleset.cs
+++ b/osu.Game.Rulesets.Taiko/TaikoRuleset.cs
@@ -168,7 +168,7 @@ namespace osu.Game.Rulesets.Taiko
 
         public override HitObjectComposer CreateHitObjectComposer() => new TaikoHitObjectComposer(this);
 
-        public override DifficultyCalculator CreateDifficultyCalculator(IWorkingBeatmap beatmap) => new TaikoDifficultyCalculator(this, beatmap);
+        public override DifficultyCalculator CreateDifficultyCalculator(IWorkingBeatmap beatmap) => new TaikoDifficultyCalculator(RulesetInfo, beatmap);
 
         public override PerformanceCalculator CreatePerformanceCalculator(DifficultyAttributes attributes, ScoreInfo score) => new TaikoPerformanceCalculator(this, attributes, score);
 
diff --git a/osu.Game/Beatmaps/IWorkingBeatmap.cs b/osu.Game/Beatmaps/IWorkingBeatmap.cs
index 22a922db59..27082916cb 100644
--- a/osu.Game/Beatmaps/IWorkingBeatmap.cs
+++ b/osu.Game/Beatmaps/IWorkingBeatmap.cs
@@ -95,7 +95,7 @@ namespace osu.Game.Beatmaps
         /// <param name="timeout">The maximum length in milliseconds to wait for load to complete. Defaults to 10,000ms.</param>
         /// <returns>The converted <see cref="IBeatmap"/>.</returns>
         /// <exception cref="BeatmapInvalidForRulesetException">If <see cref="Beatmap"/> could not be converted to <paramref name="ruleset"/>.</exception>
-        IBeatmap GetPlayableBeatmap(RulesetInfo ruleset, IReadOnlyList<Mod> mods = null, TimeSpan? timeout = null);
+        IBeatmap GetPlayableBeatmap(IRulesetInfo ruleset, IReadOnlyList<Mod> mods = null, TimeSpan? timeout = null);
 
         /// <summary>
         /// Load a new audio track instance for this beatmap. This should be called once before accessing <see cref="Track"/>.
diff --git a/osu.Game/Beatmaps/WorkingBeatmap.cs b/osu.Game/Beatmaps/WorkingBeatmap.cs
index 51eea94d3a..2ce1de380b 100644
--- a/osu.Game/Beatmaps/WorkingBeatmap.cs
+++ b/osu.Game/Beatmaps/WorkingBeatmap.cs
@@ -83,7 +83,7 @@ namespace osu.Game.Beatmaps
         /// <returns>The applicable <see cref="IBeatmapConverter"/>.</returns>
         protected virtual IBeatmapConverter CreateBeatmapConverter(IBeatmap beatmap, Ruleset ruleset) => ruleset.CreateBeatmapConverter(beatmap);
 
-        public virtual IBeatmap GetPlayableBeatmap(RulesetInfo ruleset, IReadOnlyList<Mod> mods = null, TimeSpan? timeout = null)
+        public virtual IBeatmap GetPlayableBeatmap(IRulesetInfo ruleset, IReadOnlyList<Mod> mods = null, TimeSpan? timeout = null)
         {
             using (var cancellationSource = createCancellationTokenSource(timeout))
             {
diff --git a/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs b/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs
index f9855a819f..5e431d54de 100644
--- a/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs
+++ b/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs
@@ -26,10 +26,10 @@ namespace osu.Game.Rulesets.Difficulty
         private Mod[] playableMods;
         private double clockRate;
 
-        private readonly Ruleset ruleset;
+        private readonly IRulesetInfo ruleset;
         private readonly IWorkingBeatmap beatmap;
 
-        protected DifficultyCalculator(Ruleset ruleset, IWorkingBeatmap beatmap)
+        protected DifficultyCalculator(IRulesetInfo ruleset, IWorkingBeatmap beatmap)
         {
             this.ruleset = ruleset;
             this.beatmap = beatmap;
@@ -116,7 +116,7 @@ namespace osu.Game.Rulesets.Difficulty
         {
             playableMods = mods.Select(m => m.DeepClone()).ToArray();
 
-            Beatmap = beatmap.GetPlayableBeatmap(ruleset.RulesetInfo, playableMods);
+            Beatmap = beatmap.GetPlayableBeatmap(ruleset, playableMods);
 
             var track = new TrackVirtual(10000);
             playableMods.OfType<IApplicableToTrack>().ForEach(m => m.ApplyToTrack(track));
diff --git a/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs b/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs
index b4359fe518..e6c549c7a9 100644
--- a/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs
+++ b/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs
@@ -216,7 +216,7 @@ namespace osu.Game.Screens.Play.HUD
                 this.gameplayBeatmap = gameplayBeatmap;
             }
 
-            public override IBeatmap GetPlayableBeatmap(RulesetInfo ruleset, IReadOnlyList<Mod> mods = null, TimeSpan? timeout = null)
+            public override IBeatmap GetPlayableBeatmap(IRulesetInfo ruleset, IReadOnlyList<Mod> mods = null, TimeSpan? timeout = null)
                 => gameplayBeatmap;
 
             protected override IBeatmap GetBeatmap() => gameplayBeatmap;

From fabf253381a3b4b7ebf5ea84789e257d08f20e7e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 15 Nov 2021 18:42:47 +0900
Subject: [PATCH 1025/5547] Update difficulty calculator tests to also use
 `IWorkingBeatmap`

---
 .../CatchDifficultyCalculatorTest.cs                          | 2 +-
 .../ManiaDifficultyCalculatorTest.cs                          | 2 +-
 osu.Game.Rulesets.Osu.Tests/OsuDifficultyCalculatorTest.cs    | 2 +-
 .../TaikoDifficultyCalculatorTest.cs                          | 2 +-
 osu.Game/Tests/Beatmaps/DifficultyCalculatorTest.cs           | 4 ++--
 5 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/osu.Game.Rulesets.Catch.Tests/CatchDifficultyCalculatorTest.cs b/osu.Game.Rulesets.Catch.Tests/CatchDifficultyCalculatorTest.cs
index 971c47a3b1..7e8d567fbe 100644
--- a/osu.Game.Rulesets.Catch.Tests/CatchDifficultyCalculatorTest.cs
+++ b/osu.Game.Rulesets.Catch.Tests/CatchDifficultyCalculatorTest.cs
@@ -22,7 +22,7 @@ namespace osu.Game.Rulesets.Catch.Tests
         public void TestClockRateAdjusted(double expected, string name)
             => Test(expected, name, new CatchModDoubleTime());
 
-        protected override DifficultyCalculator CreateDifficultyCalculator(WorkingBeatmap beatmap) => new CatchDifficultyCalculator(new CatchRuleset().RulesetInfo, beatmap);
+        protected override DifficultyCalculator CreateDifficultyCalculator(IWorkingBeatmap beatmap) => new CatchDifficultyCalculator(new CatchRuleset().RulesetInfo, beatmap);
 
         protected override Ruleset CreateRuleset() => new CatchRuleset();
     }
diff --git a/osu.Game.Rulesets.Mania.Tests/ManiaDifficultyCalculatorTest.cs b/osu.Game.Rulesets.Mania.Tests/ManiaDifficultyCalculatorTest.cs
index a1cae855cf..6ec49d7634 100644
--- a/osu.Game.Rulesets.Mania.Tests/ManiaDifficultyCalculatorTest.cs
+++ b/osu.Game.Rulesets.Mania.Tests/ManiaDifficultyCalculatorTest.cs
@@ -22,7 +22,7 @@ namespace osu.Game.Rulesets.Mania.Tests
         public void TestClockRateAdjusted(double expected, string name)
             => Test(expected, name, new ManiaModDoubleTime());
 
-        protected override DifficultyCalculator CreateDifficultyCalculator(WorkingBeatmap beatmap) => new ManiaDifficultyCalculator(new ManiaRuleset().RulesetInfo, beatmap);
+        protected override DifficultyCalculator CreateDifficultyCalculator(IWorkingBeatmap beatmap) => new ManiaDifficultyCalculator(new ManiaRuleset().RulesetInfo, beatmap);
 
         protected override Ruleset CreateRuleset() => new ManiaRuleset();
     }
diff --git a/osu.Game.Rulesets.Osu.Tests/OsuDifficultyCalculatorTest.cs b/osu.Game.Rulesets.Osu.Tests/OsuDifficultyCalculatorTest.cs
index 6150927826..b7984e6995 100644
--- a/osu.Game.Rulesets.Osu.Tests/OsuDifficultyCalculatorTest.cs
+++ b/osu.Game.Rulesets.Osu.Tests/OsuDifficultyCalculatorTest.cs
@@ -25,7 +25,7 @@ namespace osu.Game.Rulesets.Osu.Tests
         public void TestClockRateAdjusted(double expected, string name)
             => Test(expected, name, new OsuModDoubleTime());
 
-        protected override DifficultyCalculator CreateDifficultyCalculator(WorkingBeatmap beatmap) => new OsuDifficultyCalculator(new OsuRuleset().RulesetInfo, beatmap);
+        protected override DifficultyCalculator CreateDifficultyCalculator(IWorkingBeatmap beatmap) => new OsuDifficultyCalculator(new OsuRuleset().RulesetInfo, beatmap);
 
         protected override Ruleset CreateRuleset() => new OsuRuleset();
     }
diff --git a/osu.Game.Rulesets.Taiko.Tests/TaikoDifficultyCalculatorTest.cs b/osu.Game.Rulesets.Taiko.Tests/TaikoDifficultyCalculatorTest.cs
index a44c6a1ded..2b1cbc580e 100644
--- a/osu.Game.Rulesets.Taiko.Tests/TaikoDifficultyCalculatorTest.cs
+++ b/osu.Game.Rulesets.Taiko.Tests/TaikoDifficultyCalculatorTest.cs
@@ -24,7 +24,7 @@ namespace osu.Game.Rulesets.Taiko.Tests
         public void TestClockRateAdjusted(double expected, string name)
             => Test(expected, name, new TaikoModDoubleTime());
 
-        protected override DifficultyCalculator CreateDifficultyCalculator(WorkingBeatmap beatmap) => new TaikoDifficultyCalculator(new TaikoRuleset().RulesetInfo, beatmap);
+        protected override DifficultyCalculator CreateDifficultyCalculator(IWorkingBeatmap beatmap) => new TaikoDifficultyCalculator(new TaikoRuleset().RulesetInfo, beatmap);
 
         protected override Ruleset CreateRuleset() => new TaikoRuleset();
     }
diff --git a/osu.Game/Tests/Beatmaps/DifficultyCalculatorTest.cs b/osu.Game/Tests/Beatmaps/DifficultyCalculatorTest.cs
index e5b641b606..9f8811c7f9 100644
--- a/osu.Game/Tests/Beatmaps/DifficultyCalculatorTest.cs
+++ b/osu.Game/Tests/Beatmaps/DifficultyCalculatorTest.cs
@@ -28,7 +28,7 @@ namespace osu.Game.Tests.Beatmaps
             Assert.That(CreateDifficultyCalculator(getBeatmap(name)).Calculate(mods).StarRating, Is.EqualTo(expected).Within(0.00001));
         }
 
-        private WorkingBeatmap getBeatmap(string name)
+        private IWorkingBeatmap getBeatmap(string name)
         {
             using (var resStream = openResource($"{resource_namespace}.{name}.osu"))
             using (var stream = new LineBufferedReader(resStream))
@@ -53,7 +53,7 @@ namespace osu.Game.Tests.Beatmaps
             return Assembly.LoadFrom(Path.Combine(localPath, $"{ResourceAssembly}.dll")).GetManifestResourceStream($@"{ResourceAssembly}.Resources.{name}");
         }
 
-        protected abstract DifficultyCalculator CreateDifficultyCalculator(WorkingBeatmap beatmap);
+        protected abstract DifficultyCalculator CreateDifficultyCalculator(IWorkingBeatmap beatmap);
 
         protected abstract Ruleset CreateRuleset();
     }

From 86b8fd37207850d0e611d6622590b4fd22603d4b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 15 Nov 2021 18:05:10 +0900
Subject: [PATCH 1026/5547] Fix `TestSceneBeatmapRecommendations` testing with
 an online ID of 0

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

diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapRecommendations.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapRecommendations.cs
index a0742b862b..41e824a513 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapRecommendations.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapRecommendations.cs
@@ -102,8 +102,8 @@ namespace osu.Game.Tests.Visual.SongSelect
         {
             BeatmapSetInfo catchSet = null, mixedSet = null;
 
-            AddStep("create catch beatmapset", () => catchSet = importBeatmapSet(0, new[] { new CatchRuleset().RulesetInfo }));
-            AddStep("create mixed beatmapset", () => mixedSet = importBeatmapSet(1,
+            AddStep("create catch beatmapset", () => catchSet = importBeatmapSet(1, new[] { new CatchRuleset().RulesetInfo }));
+            AddStep("create mixed beatmapset", () => mixedSet = importBeatmapSet(2,
                 new[] { new TaikoRuleset().RulesetInfo, new CatchRuleset().RulesetInfo, new ManiaRuleset().RulesetInfo }));
 
             AddAssert("all sets imported", () => ensureAllBeatmapSetsImported(new[] { catchSet, mixedSet }));
@@ -120,8 +120,8 @@ namespace osu.Game.Tests.Visual.SongSelect
         {
             BeatmapSetInfo osuSet = null, mixedSet = null;
 
-            AddStep("create osu! beatmapset", () => osuSet = importBeatmapSet(0, new[] { new OsuRuleset().RulesetInfo }));
-            AddStep("create mixed beatmapset", () => mixedSet = importBeatmapSet(1,
+            AddStep("create osu! beatmapset", () => osuSet = importBeatmapSet(1, new[] { new OsuRuleset().RulesetInfo }));
+            AddStep("create mixed beatmapset", () => mixedSet = importBeatmapSet(2,
                 new[] { new TaikoRuleset().RulesetInfo, new CatchRuleset().RulesetInfo, new ManiaRuleset().RulesetInfo }));
 
             AddAssert("all sets imported", () => ensureAllBeatmapSetsImported(new[] { osuSet, mixedSet }));
@@ -138,8 +138,8 @@ namespace osu.Game.Tests.Visual.SongSelect
         {
             BeatmapSetInfo osuSet = null, mixedSet = null;
 
-            AddStep("create osu! beatmapset", () => osuSet = importBeatmapSet(0, new[] { new OsuRuleset().RulesetInfo }));
-            AddStep("create mixed beatmapset", () => mixedSet = importBeatmapSet(1,
+            AddStep("create osu! beatmapset", () => osuSet = importBeatmapSet(1, new[] { new OsuRuleset().RulesetInfo }));
+            AddStep("create mixed beatmapset", () => mixedSet = importBeatmapSet(2,
                 new[] { new TaikoRuleset().RulesetInfo, new CatchRuleset().RulesetInfo, new TaikoRuleset().RulesetInfo }));
 
             AddAssert("all sets imported", () => ensureAllBeatmapSetsImported(new[] { osuSet, mixedSet }));
@@ -156,8 +156,8 @@ namespace osu.Game.Tests.Visual.SongSelect
         {
             BeatmapSetInfo osuSet = null, maniaSet = null;
 
-            AddStep("create osu! beatmapset", () => osuSet = importBeatmapSet(0, new[] { new OsuRuleset().RulesetInfo }));
-            AddStep("create mania beatmapset", () => maniaSet = importBeatmapSet(1, Enumerable.Repeat(new ManiaRuleset().RulesetInfo, 10)));
+            AddStep("create osu! beatmapset", () => osuSet = importBeatmapSet(1, new[] { new OsuRuleset().RulesetInfo }));
+            AddStep("create mania beatmapset", () => maniaSet = importBeatmapSet(2, Enumerable.Repeat(new ManiaRuleset().RulesetInfo, 10)));
 
             AddAssert("all sets imported", () => ensureAllBeatmapSetsImported(new[] { osuSet, maniaSet }));
 

From 485618091249455a7a6aa2b7472c877d2df1fc63 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 15 Nov 2021 18:06:56 +0900
Subject: [PATCH 1027/5547] Use new helper method

---
 .../Visual/SongSelect/TestSceneBeatmapRecommendations.cs   | 7 ++-----
 1 file changed, 2 insertions(+), 5 deletions(-)

diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapRecommendations.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapRecommendations.cs
index 41e824a513..c9ec53cfd5 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapRecommendations.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapRecommendations.cs
@@ -7,6 +7,7 @@ using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
+using osu.Game.Extensions;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests;
 using osu.Game.Online.API.Requests.Responses;
@@ -203,11 +204,7 @@ namespace osu.Game.Tests.Visual.SongSelect
             AddStep("present beatmap", () => Game.PresentBeatmap(getImport()));
 
             AddUntilStep("wait for song select", () => Game.ScreenStack.CurrentScreen is Screens.Select.SongSelect);
-            AddUntilStep("recommended beatmap displayed", () =>
-            {
-                int? expectedID = getImport().Beatmaps[expectedDiff - 1].OnlineID;
-                return Game.Beatmap.Value.BeatmapInfo.OnlineID == expectedID;
-            });
+            AddUntilStep("recommended beatmap displayed", () => Game.Beatmap.Value.BeatmapInfo.MatchesOnlineID(getImport().Beatmaps[expectedDiff - 1]));
         }
     }
 }

From a90cfb4a2f9b4cf839e3ad0daac1219c984b96e4 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 15 Nov 2021 19:30:46 +0900
Subject: [PATCH 1028/5547] Implement remaining properties via implicit
 implementation rather than interface methods

---
 osu.Game/Beatmaps/IWorkingBeatmap.cs | 4 ++--
 osu.Game/Beatmaps/WorkingBeatmap.cs  | 2 ++
 2 files changed, 4 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Beatmaps/IWorkingBeatmap.cs b/osu.Game/Beatmaps/IWorkingBeatmap.cs
index 22a922db59..ba887edf62 100644
--- a/osu.Game/Beatmaps/IWorkingBeatmap.cs
+++ b/osu.Game/Beatmaps/IWorkingBeatmap.cs
@@ -19,9 +19,9 @@ namespace osu.Game.Beatmaps
     {
         IBeatmapInfo BeatmapInfo { get; }
 
-        IBeatmapSetInfo BeatmapSetInfo => BeatmapInfo.BeatmapSet;
+        IBeatmapSetInfo BeatmapSetInfo { get; }
 
-        IBeatmapMetadataInfo Metadata => BeatmapInfo.Metadata;
+        IBeatmapMetadataInfo Metadata { get; }
 
         /// <summary>
         /// Whether the Beatmap has finished loading.
diff --git a/osu.Game/Beatmaps/WorkingBeatmap.cs b/osu.Game/Beatmaps/WorkingBeatmap.cs
index 51eea94d3a..bba836484f 100644
--- a/osu.Game/Beatmaps/WorkingBeatmap.cs
+++ b/osu.Game/Beatmaps/WorkingBeatmap.cs
@@ -231,6 +231,8 @@ namespace osu.Game.Beatmaps
         public virtual bool BeatmapLoaded => beatmapLoadTask?.IsCompleted ?? false;
 
         IBeatmapInfo IWorkingBeatmap.BeatmapInfo => BeatmapInfo;
+        IBeatmapMetadataInfo IWorkingBeatmap.Metadata => Metadata;
+        IBeatmapSetInfo IWorkingBeatmap.BeatmapSetInfo => BeatmapSetInfo;
 
         public IBeatmap Beatmap
         {

From 1d87b47fecb9ed281d2c641a7e15262de827e55d Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Mon, 15 Nov 2021 19:40:31 +0900
Subject: [PATCH 1029/5547] Remove now-unnecessary R# disables

---
 osu.Game/Beatmaps/WorkingBeatmap.cs | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/osu.Game/Beatmaps/WorkingBeatmap.cs b/osu.Game/Beatmaps/WorkingBeatmap.cs
index bba836484f..f68f34f673 100644
--- a/osu.Game/Beatmaps/WorkingBeatmap.cs
+++ b/osu.Game/Beatmaps/WorkingBeatmap.cs
@@ -27,11 +27,7 @@ namespace osu.Game.Beatmaps
     public abstract class WorkingBeatmap : IWorkingBeatmap
     {
         public readonly BeatmapInfo BeatmapInfo;
-
-        // ReSharper disable once FieldHidesInterfacePropertyWithDefaultImplementation
         public readonly BeatmapSetInfo BeatmapSetInfo;
-
-        // ReSharper disable once FieldHidesInterfacePropertyWithDefaultImplementation
         public readonly BeatmapMetadata Metadata;
 
         protected AudioManager AudioManager { get; }

From 2c45a327bb20713d74368f79a0500a07de860ee0 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Mon, 15 Nov 2021 19:54:35 +0900
Subject: [PATCH 1030/5547] Remove JsonIgnores, require opt-in properties

---
 osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyAttributes.cs | 4 ----
 osu.Game/Rulesets/Difficulty/DifficultyAttributes.cs        | 3 +--
 2 files changed, 1 insertion(+), 6 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyAttributes.cs b/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyAttributes.cs
index 88f26db93c..7673d08440 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyAttributes.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyAttributes.cs
@@ -30,16 +30,12 @@ namespace osu.Game.Rulesets.Osu.Difficulty
         [JsonProperty("overall_difficulty")]
         public double OverallDifficulty { get; set; }
 
-        [JsonIgnore]
         public double DrainRate { get; set; }
 
-        [JsonIgnore]
         public int HitCircleCount { get; set; }
 
-        [JsonIgnore]
         public int SliderCount { get; set; }
 
-        [JsonIgnore]
         public int SpinnerCount { get; set; }
 
         public override IEnumerable<(int attributeId, object value)> ToDatabaseAttributes()
diff --git a/osu.Game/Rulesets/Difficulty/DifficultyAttributes.cs b/osu.Game/Rulesets/Difficulty/DifficultyAttributes.cs
index e25a8476f0..cc9d111aa2 100644
--- a/osu.Game/Rulesets/Difficulty/DifficultyAttributes.cs
+++ b/osu.Game/Rulesets/Difficulty/DifficultyAttributes.cs
@@ -9,12 +9,11 @@ using osu.Game.Rulesets.Mods;
 
 namespace osu.Game.Rulesets.Difficulty
 {
+    [JsonObject(MemberSerialization.OptIn)]
     public class DifficultyAttributes
     {
-        [JsonIgnore]
         public Mod[] Mods { get; set; }
 
-        [JsonIgnore]
         public Skill[] Skills { get; set; }
 
         [JsonProperty("star_rating", Order = -3)]

From f743a3647f8b8feb0056ef2dd3331246ef60b838 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Mon, 15 Nov 2021 23:14:27 +0900
Subject: [PATCH 1031/5547] Rename APIPlaylistItem -> MultiplayerPlaylistItem

---
 osu.Game/Online/Multiplayer/IMultiplayerClient.cs      |  4 ++--
 osu.Game/Online/Multiplayer/IMultiplayerRoomServer.cs  |  2 +-
 osu.Game/Online/Multiplayer/MultiplayerClient.cs       |  8 ++++----
 osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs | 10 +++++-----
 .../{APIPlaylistItem.cs => MultiplayerPlaylistItem.cs} |  6 +++---
 .../Multiplayer/MultiplayerMatchSongSelect.cs          |  2 +-
 .../Tests/Visual/Multiplayer/TestMultiplayerClient.cs  | 10 +++++-----
 7 files changed, 21 insertions(+), 21 deletions(-)
 rename osu.Game/Online/Rooms/{APIPlaylistItem.cs => MultiplayerPlaylistItem.cs} (90%)

diff --git a/osu.Game/Online/Multiplayer/IMultiplayerClient.cs b/osu.Game/Online/Multiplayer/IMultiplayerClient.cs
index 4cadc5d606..3e6821b1cd 100644
--- a/osu.Game/Online/Multiplayer/IMultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/IMultiplayerClient.cs
@@ -111,7 +111,7 @@ namespace osu.Game.Online.Multiplayer
         /// Signals that an item has been added to the playlist.
         /// </summary>
         /// <param name="item">The added item.</param>
-        Task PlaylistItemAdded(APIPlaylistItem item);
+        Task PlaylistItemAdded(MultiplayerPlaylistItem item);
 
         /// <summary>
         /// Signals that an item has been removed from the playlist.
@@ -123,6 +123,6 @@ namespace osu.Game.Online.Multiplayer
         /// Signals that an item has been changed in the playlist.
         /// </summary>
         /// <param name="item">The changed item.</param>
-        Task PlaylistItemChanged(APIPlaylistItem item);
+        Task PlaylistItemChanged(MultiplayerPlaylistItem item);
     }
 }
diff --git a/osu.Game/Online/Multiplayer/IMultiplayerRoomServer.cs b/osu.Game/Online/Multiplayer/IMultiplayerRoomServer.cs
index d00022d6f5..cb80c93ef9 100644
--- a/osu.Game/Online/Multiplayer/IMultiplayerRoomServer.cs
+++ b/osu.Game/Online/Multiplayer/IMultiplayerRoomServer.cs
@@ -86,7 +86,7 @@ namespace osu.Game.Online.Multiplayer
         /// Adds an item to the playlist.
         /// </summary>
         /// <param name="item">The item to add.</param>
-        Task AddPlaylistItem(APIPlaylistItem item);
+        Task AddPlaylistItem(MultiplayerPlaylistItem item);
 
         /// <summary>
         /// Removes an item from the playlist.
diff --git a/osu.Game/Online/Multiplayer/MultiplayerClient.cs b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
index 638eb30ee9..ebbd76f237 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
@@ -309,7 +309,7 @@ namespace osu.Game.Online.Multiplayer
 
         public abstract Task RequestAllPlaylistItems();
 
-        public abstract Task AddPlaylistItem(APIPlaylistItem item);
+        public abstract Task AddPlaylistItem(MultiplayerPlaylistItem item);
 
         public abstract Task RemovePlaylistItem(long playlistItemId);
 
@@ -603,7 +603,7 @@ namespace osu.Game.Online.Multiplayer
             return Task.CompletedTask;
         }
 
-        public async Task PlaylistItemAdded(APIPlaylistItem item)
+        public async Task PlaylistItemAdded(MultiplayerPlaylistItem item)
         {
             if (Room == null)
                 return;
@@ -642,7 +642,7 @@ namespace osu.Game.Online.Multiplayer
             return Task.CompletedTask;
         }
 
-        public async Task PlaylistItemChanged(APIPlaylistItem item)
+        public async Task PlaylistItemChanged(MultiplayerPlaylistItem item)
         {
             if (Room == null)
                 return;
@@ -703,7 +703,7 @@ namespace osu.Game.Online.Multiplayer
             CurrentMatchPlayingItem.Value = APIRoom.Playlist.SingleOrDefault(p => p.ID == settings.PlaylistItemId);
         }, cancellationToken);
 
-        private async Task<PlaylistItem> createPlaylistItem(APIPlaylistItem item)
+        private async Task<PlaylistItem> createPlaylistItem(MultiplayerPlaylistItem item)
         {
             var set = await GetOnlineBeatmapSet(item.BeatmapID).ConfigureAwait(false);
 
diff --git a/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs b/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs
index c7a751500e..5c60dae747 100644
--- a/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs
@@ -63,9 +63,9 @@ namespace osu.Game.Online.Multiplayer
                     connection.On<MatchRoomState>(nameof(IMultiplayerClient.MatchRoomStateChanged), ((IMultiplayerClient)this).MatchRoomStateChanged);
                     connection.On<int, MatchUserState>(nameof(IMultiplayerClient.MatchUserStateChanged), ((IMultiplayerClient)this).MatchUserStateChanged);
                     connection.On<MatchServerEvent>(nameof(IMultiplayerClient.MatchEvent), ((IMultiplayerClient)this).MatchEvent);
-                    connection.On<APIPlaylistItem>(nameof(IMultiplayerClient.PlaylistItemAdded), ((IMultiplayerClient)this).PlaylistItemAdded);
+                    connection.On<MultiplayerPlaylistItem>(nameof(IMultiplayerClient.PlaylistItemAdded), ((IMultiplayerClient)this).PlaylistItemAdded);
                     connection.On<long>(nameof(IMultiplayerClient.PlaylistItemRemoved), ((IMultiplayerClient)this).PlaylistItemRemoved);
-                    connection.On<APIPlaylistItem>(nameof(IMultiplayerClient.PlaylistItemChanged), ((IMultiplayerClient)this).PlaylistItemChanged);
+                    connection.On<MultiplayerPlaylistItem>(nameof(IMultiplayerClient.PlaylistItemChanged), ((IMultiplayerClient)this).PlaylistItemChanged);
                 };
 
                 IsConnected.BindTo(connector.IsConnected);
@@ -155,12 +155,12 @@ namespace osu.Game.Online.Multiplayer
         public override Task RequestAllPlaylistItems()
         {
             if (!IsConnected.Value)
-                return Task.FromResult(Array.Empty<APIPlaylistItem>());
+                return Task.FromResult(Array.Empty<MultiplayerPlaylistItem>());
 
-            return connection.InvokeAsync<APIPlaylistItem[]>(nameof(IMultiplayerServer.RequestAllPlaylistItems));
+            return connection.InvokeAsync<MultiplayerPlaylistItem[]>(nameof(IMultiplayerServer.RequestAllPlaylistItems));
         }
 
-        public override Task AddPlaylistItem(APIPlaylistItem item)
+        public override Task AddPlaylistItem(MultiplayerPlaylistItem item)
         {
             if (!IsConnected.Value)
                 return Task.CompletedTask;
diff --git a/osu.Game/Online/Rooms/APIPlaylistItem.cs b/osu.Game/Online/Rooms/MultiplayerPlaylistItem.cs
similarity index 90%
rename from osu.Game/Online/Rooms/APIPlaylistItem.cs
rename to osu.Game/Online/Rooms/MultiplayerPlaylistItem.cs
index eddce69976..a158be71a1 100644
--- a/osu.Game/Online/Rooms/APIPlaylistItem.cs
+++ b/osu.Game/Online/Rooms/MultiplayerPlaylistItem.cs
@@ -13,7 +13,7 @@ namespace osu.Game.Online.Rooms
 {
     [Serializable]
     [MessagePackObject]
-    public class APIPlaylistItem
+    public class MultiplayerPlaylistItem
     {
         [Key(0)]
         public long ID { get; set; }
@@ -39,11 +39,11 @@ namespace osu.Game.Online.Rooms
         [Key(7)]
         public bool Expired { get; set; }
 
-        public APIPlaylistItem()
+        public MultiplayerPlaylistItem()
         {
         }
 
-        public APIPlaylistItem(PlaylistItem item)
+        public MultiplayerPlaylistItem(PlaylistItem item)
         {
             ID = item.ID;
             BeatmapID = item.BeatmapID;
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs
index 40b086873d..e7998fc01c 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs
@@ -56,7 +56,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
             {
                 loadingLayer.Show();
 
-                client.AddPlaylistItem(new APIPlaylistItem
+                client.AddPlaylistItem(new MultiplayerPlaylistItem
                 {
                     BeatmapID = item.BeatmapID,
                     BeatmapChecksum = item.Beatmap.Value.MD5Hash,
diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
index dc871de3f5..a88bf56cee 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
@@ -41,9 +41,9 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [Resolved]
         private BeatmapManager beatmaps { get; set; } = null!;
 
-        private readonly List<APIPlaylistItem> playlistItems = new List<APIPlaylistItem>();
+        private readonly List<MultiplayerPlaylistItem> playlistItems = new List<MultiplayerPlaylistItem>();
         private readonly TestMultiplayerRoomManager roomManager;
-        private APIPlaylistItem? currentItem;
+        private MultiplayerPlaylistItem? currentItem;
 
         public TestMultiplayerClient(TestMultiplayerRoomManager roomManager)
         {
@@ -162,7 +162,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             if (password != apiRoom.Password.Value)
                 throw new InvalidOperationException("Invalid password.");
 
-            playlistItems.AddRange(apiRoom.Playlist.Select(i => new APIPlaylistItem(i)));
+            playlistItems.AddRange(apiRoom.Playlist.Select(i => new MultiplayerPlaylistItem(i)));
 
             var localUser = new MultiplayerRoomUser(api.LocalUser.Value.Id)
             {
@@ -300,7 +300,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 await ((IMultiplayerClient)this).PlaylistItemAdded(item).ConfigureAwait(false);
         }
 
-        public override async Task AddPlaylistItem(APIPlaylistItem item)
+        public override async Task AddPlaylistItem(MultiplayerPlaylistItem item)
         {
             Debug.Assert(Room != null);
             Debug.Assert(APIRoom != null);
@@ -425,7 +425,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             Debug.Assert(APIRoom != null);
             Debug.Assert(currentItem != null);
 
-            var newItem = new APIPlaylistItem
+            var newItem = new MultiplayerPlaylistItem
             {
                 ID = playlistItems.Last().ID + 1,
                 BeatmapID = currentItem.BeatmapID,

From eb983ed548dbd55492e74d995994ff08831a5aac Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 16 Nov 2021 00:02:38 +0900
Subject: [PATCH 1032/5547] Fix potential crash from playlist updating during
 async load

---
 .../Multiplayer/MultiplayerMatchSubScreen.cs          | 11 +++++++----
 1 file changed, 7 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
index aa936109c6..9e689773af 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
@@ -44,6 +44,8 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
 
         public override string ShortTitle => "room";
 
+        public OsuButton AddOrEditPlaylistButton { get; private set; }
+
         [Resolved]
         private MultiplayerClient client { get; set; }
 
@@ -55,7 +57,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
         [CanBeNull]
         private IDisposable readyClickOperation;
 
-        public OsuButton AddOrEditPlaylistButton { get; private set; }
+        private DrawableRoomPlaylist playlist;
 
         public MultiplayerMatchSubScreen(Room room)
             : base(room)
@@ -73,6 +75,9 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
             BeatmapAvailability.BindValueChanged(updateBeatmapAvailability, true);
             UserMods.BindValueChanged(onUserModsChanged);
 
+            playlist.Items.BindTo(Room.Playlist);
+            playlist.SelectedItem.BindTo(SelectedItem);
+
             client.LoadRequested += onLoadRequested;
             client.RoomUpdated += onRoomUpdated;
 
@@ -149,11 +154,9 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
                                 null,
                                 new Drawable[]
                                 {
-                                    new DrawableRoomPlaylist(false, false)
+                                    playlist = new DrawableRoomPlaylist(false, false)
                                     {
                                         RelativeSizeAxes = Axes.Both,
-                                        Items = { BindTarget = Room.Playlist },
-                                        SelectedItem = { BindTarget = SelectedItem }
                                     },
                                 },
                                 new[]

From 8e014ca17ad6bab674db6076e5c0c2bb0eee3c19 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 16 Nov 2021 00:09:38 +0900
Subject: [PATCH 1033/5547] Reverse in-match playlist

---
 .../OnlinePlay/DrawableRoomPlaylist.cs        | 25 ++++++++++++++++---
 .../Multiplayer/MultiplayerMatchSubScreen.cs  |  2 +-
 2 files changed, 22 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs
index a08d9edb34..296bb4bea5 100644
--- a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs
+++ b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs
@@ -19,10 +19,12 @@ namespace osu.Game.Screens.OnlinePlay
         private readonly bool allowEdit;
         private readonly bool allowSelection;
 
-        public DrawableRoomPlaylist(bool allowEdit, bool allowSelection)
+        public DrawableRoomPlaylist(bool allowEdit, bool allowSelection, bool reverse = false)
         {
             this.allowEdit = allowEdit;
             this.allowSelection = allowSelection;
+
+            ((ReversibleFillFlowContainer)ListContainer).Reverse = reverse;
         }
 
         protected override void LoadComplete()
@@ -47,10 +49,8 @@ namespace osu.Game.Screens.OnlinePlay
             d.ScrollbarVisible = false;
         });
 
-        protected override FillFlowContainer<RearrangeableListItem<PlaylistItem>> CreateListFillFlowContainer() => new FillFlowContainer<RearrangeableListItem<PlaylistItem>>
+        protected override FillFlowContainer<RearrangeableListItem<PlaylistItem>> CreateListFillFlowContainer() => new ReversibleFillFlowContainer
         {
-            LayoutDuration = 200,
-            LayoutEasing = Easing.OutQuint,
             Spacing = new Vector2(0, 2)
         };
 
@@ -72,5 +72,22 @@ namespace osu.Game.Screens.OnlinePlay
 
             Items.Remove(item);
         }
+
+        private class ReversibleFillFlowContainer : FillFlowContainer<RearrangeableListItem<PlaylistItem>>
+        {
+            private bool reverse;
+
+            public bool Reverse
+            {
+                get => reverse;
+                set
+                {
+                    reverse = value;
+                    Invalidate();
+                }
+            }
+
+            public override IEnumerable<Drawable> FlowingChildren => Reverse ? base.FlowingChildren.OrderBy(d => -GetLayoutPosition(d)) : base.FlowingChildren;
+        }
     }
 }
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
index 9e689773af..c99367851a 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
@@ -154,7 +154,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
                                 null,
                                 new Drawable[]
                                 {
-                                    playlist = new DrawableRoomPlaylist(false, false)
+                                    playlist = new DrawableRoomPlaylist(false, false, true)
                                     {
                                         RelativeSizeAxes = Axes.Both,
                                     },

From b9e38269e34a7fbfabf42a02b6d7fbe7e9f3b447 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 16 Nov 2021 00:09:49 +0900
Subject: [PATCH 1034/5547] Prevent playlist mangling selection if not allowed

---
 osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs
index 296bb4bea5..f5522cd25d 100644
--- a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs
+++ b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.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 System.Collections.Specialized;
+using System.Linq;
 using osu.Framework.Bindables;
 using osu.Framework.Extensions.IEnumerableExtensions;
 using osu.Framework.Graphics;
@@ -37,7 +39,7 @@ namespace osu.Game.Screens.OnlinePlay
                 switch (args.Action)
                 {
                     case NotifyCollectionChangedAction.Remove:
-                        if (args.OldItems.Contains(SelectedItem))
+                        if (allowSelection && args.OldItems.Contains(SelectedItem))
                             SelectedItem.Value = null;
                         break;
                 }
@@ -62,7 +64,7 @@ namespace osu.Game.Screens.OnlinePlay
 
         private void requestDeletion(PlaylistItem item)
         {
-            if (SelectedItem.Value == item)
+            if (allowSelection && SelectedItem.Value == item)
             {
                 if (Items.Count == 1)
                     SelectedItem.Value = null;

From d27edb3a2536eb6d8c650bcefa633cc16fe2db77 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 16 Nov 2021 00:31:35 +0900
Subject: [PATCH 1035/5547] Fix another potential crash from async load

---
 .../Match/MultiplayerMatchSettingsOverlay.cs      | 15 +++++++++++----
 1 file changed, 11 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs
index 3d95960bef..98a0cd3d37 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs
@@ -102,6 +102,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
             private readonly Room room;
 
             private Drawable playlistContainer;
+            private DrawableRoomPlaylist drawablePlaylist;
 
             public MatchSettings(Room room)
             {
@@ -256,12 +257,10 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
                                                     Spacing = new Vector2(5),
                                                     Children = new Drawable[]
                                                     {
-                                                        new DrawableRoomPlaylist(false, false)
+                                                        drawablePlaylist = new DrawableRoomPlaylist(false, false)
                                                         {
                                                             RelativeSizeAxes = Axes.X,
-                                                            Height = DrawableRoomPlaylistItem.HEIGHT,
-                                                            Items = { BindTarget = Playlist },
-                                                            SelectedItem = { BindTarget = SelectedItem }
+                                                            Height = DrawableRoomPlaylistItem.HEIGHT
                                                         },
                                                         new PurpleTriangleButton
                                                         {
@@ -348,6 +347,14 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
                 });
             }
 
+            protected override void LoadComplete()
+            {
+                base.LoadComplete();
+
+                drawablePlaylist.Items.BindTo(Playlist);
+                drawablePlaylist.SelectedItem.BindTo(SelectedItem);
+            }
+
             protected override void Update()
             {
                 base.Update();

From 459e819a5db1bcd68ba9b806eefc7955e06a21ee Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 16 Nov 2021 00:50:23 +0900
Subject: [PATCH 1036/5547] Update todo

---
 .../OnlinePlay/Multiplayer/Participants/ParticipantPanel.cs     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantPanel.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantPanel.cs
index e9085580f9..3152f50d3d 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantPanel.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantPanel.cs
@@ -184,7 +184,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Participants
 
             const double fade_time = 50;
 
-            // Todo: FIX THIS
+            // Todo: Should use the room's selected item to determine ruleset.
             var ruleset = rulesets.GetRuleset(0).CreateInstance();
 
             int? currentModeRank = User.User?.RulesetsStatistics?.GetValueOrDefault(ruleset.ShortName)?.GlobalRank;

From f0593115b2b4dd27752b4b8637b846b5ac5661bd Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 16 Nov 2021 12:08:53 +0900
Subject: [PATCH 1037/5547] Remove RemovePlaylistItem() server method for the
 time being

---
 osu.Game/Online/Multiplayer/IMultiplayerRoomServer.cs  |  6 ------
 osu.Game/Online/Multiplayer/MultiplayerClient.cs       |  2 --
 osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs |  8 --------
 .../Tests/Visual/Multiplayer/TestMultiplayerClient.cs  | 10 ----------
 4 files changed, 26 deletions(-)

diff --git a/osu.Game/Online/Multiplayer/IMultiplayerRoomServer.cs b/osu.Game/Online/Multiplayer/IMultiplayerRoomServer.cs
index cb80c93ef9..afaf1e89de 100644
--- a/osu.Game/Online/Multiplayer/IMultiplayerRoomServer.cs
+++ b/osu.Game/Online/Multiplayer/IMultiplayerRoomServer.cs
@@ -87,11 +87,5 @@ namespace osu.Game.Online.Multiplayer
         /// </summary>
         /// <param name="item">The item to add.</param>
         Task AddPlaylistItem(MultiplayerPlaylistItem item);
-
-        /// <summary>
-        /// Removes an item from the playlist.
-        /// </summary>
-        /// <param name="playlistItemId">The item to remove.</param>
-        Task RemovePlaylistItem(long playlistItemId);
     }
 }
diff --git a/osu.Game/Online/Multiplayer/MultiplayerClient.cs b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
index ebbd76f237..77a1b51b7d 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
@@ -311,8 +311,6 @@ namespace osu.Game.Online.Multiplayer
 
         public abstract Task AddPlaylistItem(MultiplayerPlaylistItem item);
 
-        public abstract Task RemovePlaylistItem(long playlistItemId);
-
         Task IMultiplayerClient.RoomStateChanged(MultiplayerRoomState state)
         {
             if (Room == null)
diff --git a/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs b/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs
index 5c60dae747..2609436890 100644
--- a/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs
@@ -168,14 +168,6 @@ namespace osu.Game.Online.Multiplayer
             return connection.InvokeAsync(nameof(IMultiplayerServer.AddPlaylistItem), item);
         }
 
-        public override Task RemovePlaylistItem(long playlistItemId)
-        {
-            if (!IsConnected.Value)
-                return Task.CompletedTask;
-
-            return connection.InvokeAsync(nameof(IMultiplayerServer.RemovePlaylistItem), playlistItemId);
-        }
-
         protected override Task<APIBeatmapSet> GetOnlineBeatmapSet(int beatmapId, CancellationToken cancellationToken = default)
         {
             var tcs = new TaskCompletionSource<APIBeatmapSet>();
diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
index a88bf56cee..e2dff61e7c 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
@@ -330,16 +330,6 @@ namespace osu.Game.Tests.Visual.Multiplayer
             }
         }
 
-        public override Task RemovePlaylistItem(long playlistItemId)
-        {
-            Debug.Assert(Room != null);
-
-            if (Room.Host?.UserID != LocalUser?.UserID)
-                throw new InvalidOperationException("Local user is not the room host.");
-
-            return ((IMultiplayerClient)this).PlaylistItemRemoved(playlistItemId);
-        }
-
         protected override Task<APIBeatmapSet> GetOnlineBeatmapSet(int beatmapId, CancellationToken cancellationToken = default)
         {
             Debug.Assert(Room != null);

From 3fe89293affaec4a0aae564e767341bcff2d0bca Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 16 Nov 2021 12:11:11 +0900
Subject: [PATCH 1038/5547] Add update manager which performs no update action

This is to be used in cases where updates are handled by an external
means. See
https://github.com/flathub/flathub/pull/2619#issuecomment-969731305 for
initial usage.
---
 osu.Desktop/OsuGameDesktop.cs             |  5 ++
 osu.Game/Updater/GitHubAsset.cs           | 16 ++++++
 osu.Game/Updater/GitHubRelease.cs         | 20 +++++++
 osu.Game/Updater/NoActionUpdateManager.cs | 67 +++++++++++++++++++++++
 osu.Game/Updater/SimpleUpdateManager.cs   | 23 --------
 5 files changed, 108 insertions(+), 23 deletions(-)
 create mode 100644 osu.Game/Updater/GitHubAsset.cs
 create mode 100644 osu.Game/Updater/GitHubRelease.cs
 create mode 100644 osu.Game/Updater/NoActionUpdateManager.cs

diff --git a/osu.Desktop/OsuGameDesktop.cs b/osu.Desktop/OsuGameDesktop.cs
index 19e1252a4d..645ea66654 100644
--- a/osu.Desktop/OsuGameDesktop.cs
+++ b/osu.Desktop/OsuGameDesktop.cs
@@ -93,6 +93,11 @@ namespace osu.Desktop
 
         protected override UpdateManager CreateUpdateManager()
         {
+            string packageManaged = Environment.GetEnvironmentVariable("OSU_EXTERNAL_UPDATE_PROVIDER");
+
+            if (!string.IsNullOrEmpty(packageManaged))
+                return new NoActionUpdateManager();
+
             switch (RuntimeInfo.OS)
             {
                 case RuntimeInfo.Platform.Windows:
diff --git a/osu.Game/Updater/GitHubAsset.cs b/osu.Game/Updater/GitHubAsset.cs
new file mode 100644
index 0000000000..4783161859
--- /dev/null
+++ b/osu.Game/Updater/GitHubAsset.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 Newtonsoft.Json;
+
+namespace osu.Game.Updater
+{
+    public class GitHubAsset
+    {
+        [JsonProperty("name")]
+        public string Name { get; set; }
+
+        [JsonProperty("browser_download_url")]
+        public string BrowserDownloadUrl { get; set; }
+    }
+}
diff --git a/osu.Game/Updater/GitHubRelease.cs b/osu.Game/Updater/GitHubRelease.cs
new file mode 100644
index 0000000000..363b2b628f
--- /dev/null
+++ b/osu.Game/Updater/GitHubRelease.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 Newtonsoft.Json;
+
+namespace osu.Game.Updater
+{
+    public class GitHubRelease
+    {
+        [JsonProperty("html_url")]
+        public string HtmlUrl { get; set; }
+
+        [JsonProperty("tag_name")]
+        public string TagName { get; set; }
+
+        [JsonProperty("assets")]
+        public List<GitHubAsset> Assets { get; set; }
+    }
+}
diff --git a/osu.Game/Updater/NoActionUpdateManager.cs b/osu.Game/Updater/NoActionUpdateManager.cs
new file mode 100644
index 0000000000..641263ed0f
--- /dev/null
+++ b/osu.Game/Updater/NoActionUpdateManager.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 System.Linq;
+using System.Threading.Tasks;
+using osu.Framework.Allocation;
+using osu.Framework.Graphics.Sprites;
+using osu.Framework.Platform;
+using osu.Game.Online.API;
+using osu.Game.Overlays.Notifications;
+
+namespace osu.Game.Updater
+{
+    /// <summary>
+    /// An update manager that shows notifications if a newer release is detected.
+    /// This is a case where updates are handled externally by a package manager or other means, so no action is performed on clicking the notification.
+    /// </summary>
+    public class NoActionUpdateManager : UpdateManager
+    {
+        private string version;
+
+        [Resolved]
+        private GameHost host { get; set; }
+
+        [BackgroundDependencyLoader]
+        private void load(OsuGameBase game)
+        {
+            version = game.Version;
+        }
+
+        protected override async Task<bool> PerformUpdateCheck()
+        {
+            try
+            {
+                var releases = new OsuJsonWebRequest<GitHubRelease>("https://api.github.com/repos/ppy/osu/releases/latest");
+
+                await releases.PerformAsync().ConfigureAwait(false);
+
+                var latest = releases.ResponseObject;
+
+                // avoid any discrepancies due to build suffixes for now.
+                // eventually we will want to support release streams and consider these.
+                version = version.Split('-').First();
+                string latestTagName = latest.TagName.Split('-').First();
+
+                if (latestTagName != version)
+                {
+                    Notifications.Post(new SimpleNotification
+                    {
+                        Text = $"A newer release of osu! has been found ({version} → {latestTagName}).\n\n"
+                               + "Check with your package manager / provider to bring osu! up-to-date!",
+                        Icon = FontAwesome.Solid.Upload,
+                    });
+
+                    return true;
+                }
+            }
+            catch
+            {
+                // we shouldn't crash on a web failure. or any failure for the matter.
+                return true;
+            }
+
+            return false;
+        }
+    }
+}
diff --git a/osu.Game/Updater/SimpleUpdateManager.cs b/osu.Game/Updater/SimpleUpdateManager.cs
index 5e466cc57f..61ca68a1ab 100644
--- a/osu.Game/Updater/SimpleUpdateManager.cs
+++ b/osu.Game/Updater/SimpleUpdateManager.cs
@@ -2,10 +2,8 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
-using System.Collections.Generic;
 using System.Linq;
 using System.Threading.Tasks;
-using Newtonsoft.Json;
 using osu.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics.Sprites;
@@ -104,26 +102,5 @@ namespace osu.Game.Updater
 
             return bestAsset?.BrowserDownloadUrl ?? release.HtmlUrl;
         }
-
-        public class GitHubRelease
-        {
-            [JsonProperty("html_url")]
-            public string HtmlUrl { get; set; }
-
-            [JsonProperty("tag_name")]
-            public string TagName { get; set; }
-
-            [JsonProperty("assets")]
-            public List<GitHubAsset> Assets { get; set; }
-        }
-
-        public class GitHubAsset
-        {
-            [JsonProperty("name")]
-            public string Name { get; set; }
-
-            [JsonProperty("browser_download_url")]
-            public string BrowserDownloadUrl { get; set; }
-        }
     }
 }

From 9207b87b7686ccef1ec9b17492b353ae51fb720d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 16 Nov 2021 12:25:37 +0900
Subject: [PATCH 1039/5547] Add back interface equality but limit to only
 matching types

---
 osu.Game/Beatmaps/BeatmapInfo.cs                        | 2 ++
 osu.Game/Beatmaps/BeatmapSetInfo.cs                     | 2 ++
 osu.Game/Beatmaps/IBeatmapInfo.cs                       | 3 ++-
 osu.Game/Beatmaps/IBeatmapSetInfo.cs                    | 2 +-
 osu.Game/Models/RealmBeatmap.cs                         | 2 ++
 osu.Game/Models/RealmBeatmapSet.cs                      | 2 ++
 osu.Game/Online/API/Requests/Responses/APIBeatmap.cs    | 2 ++
 osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs | 2 ++
 8 files changed, 15 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapInfo.cs b/osu.Game/Beatmaps/BeatmapInfo.cs
index 6f45f5ec71..d2b322a843 100644
--- a/osu.Game/Beatmaps/BeatmapInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapInfo.cs
@@ -163,6 +163,8 @@ namespace osu.Game.Beatmaps
             return false;
         }
 
+        public bool Equals(IBeatmapInfo other) => other is BeatmapInfo b && Equals(b);
+
         public bool AudioEquals(BeatmapInfo other) => other != null && BeatmapSet != null && other.BeatmapSet != null &&
                                                       BeatmapSet.Hash == other.BeatmapSet.Hash &&
                                                       (Metadata ?? BeatmapSet.Metadata).AudioFile == (other.Metadata ?? other.BeatmapSet.Metadata).AudioFile;
diff --git a/osu.Game/Beatmaps/BeatmapSetInfo.cs b/osu.Game/Beatmaps/BeatmapSetInfo.cs
index 6dd8cc5ade..a0de50a311 100644
--- a/osu.Game/Beatmaps/BeatmapSetInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapSetInfo.cs
@@ -78,6 +78,8 @@ namespace osu.Game.Beatmaps
             return false;
         }
 
+        public bool Equals(IBeatmapSetInfo other) => other is BeatmapSetInfo b && Equals(b);
+
         #region Implementation of IHasOnlineID
 
         int IHasOnlineID<int>.OnlineID => OnlineID ?? -1;
diff --git a/osu.Game/Beatmaps/IBeatmapInfo.cs b/osu.Game/Beatmaps/IBeatmapInfo.cs
index 84ea6d3019..ab096b8897 100644
--- a/osu.Game/Beatmaps/IBeatmapInfo.cs
+++ b/osu.Game/Beatmaps/IBeatmapInfo.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.Game.Database;
 using osu.Game.Rulesets;
 
@@ -11,7 +12,7 @@ namespace osu.Game.Beatmaps
     /// <summary>
     /// A single beatmap difficulty.
     /// </summary>
-    public interface IBeatmapInfo : IHasOnlineID<int>
+    public interface IBeatmapInfo : IHasOnlineID<int>, IEquatable<IBeatmapInfo>
     {
         /// <summary>
         /// The user-specified name given to this beatmap.
diff --git a/osu.Game/Beatmaps/IBeatmapSetInfo.cs b/osu.Game/Beatmaps/IBeatmapSetInfo.cs
index 20c46d9063..67f38397d4 100644
--- a/osu.Game/Beatmaps/IBeatmapSetInfo.cs
+++ b/osu.Game/Beatmaps/IBeatmapSetInfo.cs
@@ -12,7 +12,7 @@ namespace osu.Game.Beatmaps
     /// <summary>
     /// A representation of a collection of beatmap difficulties, generally packaged as an ".osz" archive.
     /// </summary>
-    public interface IBeatmapSetInfo : IHasOnlineID<int>
+    public interface IBeatmapSetInfo : IHasOnlineID<int>, IEquatable<IBeatmapSetInfo>
     {
         /// <summary>
         /// The date when this beatmap was imported.
diff --git a/osu.Game/Models/RealmBeatmap.cs b/osu.Game/Models/RealmBeatmap.cs
index 2a197d296a..1a25d55d04 100644
--- a/osu.Game/Models/RealmBeatmap.cs
+++ b/osu.Game/Models/RealmBeatmap.cs
@@ -106,6 +106,8 @@ namespace osu.Game.Models
             return ID == other.ID;
         }
 
+        public bool Equals(IBeatmapInfo? other) => other is RealmBeatmap b && Equals(b);
+
         public bool AudioEquals(RealmBeatmap? other) => other != null
                                                         && BeatmapSet != null
                                                         && other.BeatmapSet != null
diff --git a/osu.Game/Models/RealmBeatmapSet.cs b/osu.Game/Models/RealmBeatmapSet.cs
index 1747cce67a..b9b47b697c 100644
--- a/osu.Game/Models/RealmBeatmapSet.cs
+++ b/osu.Game/Models/RealmBeatmapSet.cs
@@ -64,6 +64,8 @@ namespace osu.Game.Models
 
         public override string ToString() => Metadata?.GetDisplayString() ?? base.ToString();
 
+        public bool Equals(IBeatmapSetInfo? other) => other is RealmBeatmapSet b && Equals(b);
+
         IEnumerable<IBeatmapInfo> IBeatmapSetInfo.Beatmaps => Beatmaps;
 
         IEnumerable<INamedFileUsage> IBeatmapSetInfo.Files => Files;
diff --git a/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs b/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs
index 2560502173..e90de5bdb7 100644
--- a/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs
@@ -103,5 +103,7 @@ namespace osu.Game.Online.API.Requests.Responses
         public string Hash => throw new NotImplementedException();
 
         #endregion
+
+        public bool Equals(IBeatmapInfo? other) => other is APIBeatmap b && Equals(b);
     }
 }
diff --git a/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs b/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs
index 168e9d5d51..2628880588 100644
--- a/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs
@@ -141,5 +141,7 @@ namespace osu.Game.Online.API.Requests.Responses
         double IBeatmapSetInfo.MaxBPM => BPM;
 
         #endregion
+
+        public bool Equals(IBeatmapSetInfo? other) => other is APIBeatmapSet b && Equals(b);
     }
 }

From 68e269904377205b62661aac719c886be9ba320d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 16 Nov 2021 12:28:57 +0900
Subject: [PATCH 1040/5547] Fix oversight in playlist matching logic

---
 osu.Game/Overlays/Music/Playlist.cs | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/osu.Game/Overlays/Music/Playlist.cs b/osu.Game/Overlays/Music/Playlist.cs
index 5de62ebfb8..0b15a3a1bc 100644
--- a/osu.Game/Overlays/Music/Playlist.cs
+++ b/osu.Game/Overlays/Music/Playlist.cs
@@ -7,7 +7,6 @@ using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Beatmaps;
-using osu.Game.Extensions;
 using osu.Game.Graphics.Containers;
 using osuTK;
 
@@ -30,7 +29,7 @@ namespace osu.Game.Overlays.Music
             var items = (SearchContainer<RearrangeableListItem<BeatmapSetInfo>>)ListContainer;
 
             foreach (var item in items.OfType<PlaylistItem>())
-                item.InSelectedCollection = criteria.Collection?.Beatmaps.Any(b => b.MatchesOnlineID(item.Model)) ?? true;
+                item.InSelectedCollection = criteria.Collection?.Beatmaps.Any(b => item.Model.Equals(b.BeatmapSet)) ?? true;
 
             items.SearchTerm = criteria.SearchText;
         }

From fbc46941fa1beab0c846176c113b9a360936dd8b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 16 Nov 2021 12:37:47 +0900
Subject: [PATCH 1041/5547] Add type safety to `MatchesOnlineID` extension
 methods

---
 osu.Game/Extensions/ModelExtensions.cs | 30 ++++++++++++++++++--------
 1 file changed, 21 insertions(+), 9 deletions(-)

diff --git a/osu.Game/Extensions/ModelExtensions.cs b/osu.Game/Extensions/ModelExtensions.cs
index 48a3bac112..c8561ecdb3 100644
--- a/osu.Game/Extensions/ModelExtensions.cs
+++ b/osu.Game/Extensions/ModelExtensions.cs
@@ -62,12 +62,30 @@ namespace osu.Game.Extensions
         }
 
         /// <summary>
-        /// Check whether the online ID of two instances match.
+        /// Check whether the online ID of two <see cref="IBeatmapSetInfo"/>s match.
         /// </summary>
         /// <param name="instance">The instance to compare.</param>
         /// <param name="other">The other instance to compare against.</param>
         /// <returns>Whether online IDs match. If either instance is missing an online ID, this will return false.</returns>
-        public static bool MatchesOnlineID(this IHasOnlineID<long>? instance, IHasOnlineID<long>? other)
+        public static bool MatchesOnlineID(this IBeatmapSetInfo? instance, IBeatmapSetInfo? other) => matchesOnlineID(instance, other);
+
+        /// <summary>
+        /// Check whether the online ID of two <see cref="IBeatmapInfo"/>s match.
+        /// </summary>
+        /// <param name="instance">The instance to compare.</param>
+        /// <param name="other">The other instance to compare against.</param>
+        /// <returns>Whether online IDs match. If either instance is missing an online ID, this will return false.</returns>
+        public static bool MatchesOnlineID(this IBeatmapInfo? instance, IBeatmapInfo? other) => matchesOnlineID(instance, other);
+
+        /// <summary>
+        /// Check whether the online ID of two <see cref="IRulesetInfo"/>s match.
+        /// </summary>
+        /// <param name="instance">The instance to compare.</param>
+        /// <param name="other">The other instance to compare against.</param>
+        /// <returns>Whether online IDs match. If either instance is missing an online ID, this will return false.</returns>
+        public static bool MatchesOnlineID(this IRulesetInfo? instance, IRulesetInfo? other) => matchesOnlineID(instance, other);
+
+        private static bool matchesOnlineID(this IHasOnlineID<long>? instance, IHasOnlineID<long>? other)
         {
             if (instance == null || other == null)
                 return false;
@@ -78,13 +96,7 @@ namespace osu.Game.Extensions
             return instance.OnlineID.Equals(other.OnlineID);
         }
 
-        /// <summary>
-        /// Check whether the online ID of two instances match.
-        /// </summary>
-        /// <param name="instance">The instance to compare.</param>
-        /// <param name="other">The other instance to compare against.</param>
-        /// <returns>Whether online IDs match. If either instance is missing an online ID, this will return false.</returns>
-        public static bool MatchesOnlineID(this IHasOnlineID<int>? instance, IHasOnlineID<int>? other)
+        private static bool matchesOnlineID(this IHasOnlineID<int>? instance, IHasOnlineID<int>? other)
         {
             if (instance == null || other == null)
                 return false;

From 2cbdac91ad02b84e9ec7c04685d6d55f2c574d92 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 16 Nov 2021 12:44:20 +0900
Subject: [PATCH 1042/5547] Add missing `APIUser` comparison method

---
 osu.Game/Extensions/ModelExtensions.cs | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/osu.Game/Extensions/ModelExtensions.cs b/osu.Game/Extensions/ModelExtensions.cs
index c8561ecdb3..3426484c14 100644
--- a/osu.Game/Extensions/ModelExtensions.cs
+++ b/osu.Game/Extensions/ModelExtensions.cs
@@ -3,6 +3,7 @@
 
 using osu.Game.Beatmaps;
 using osu.Game.Database;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets;
 using osu.Game.Scoring;
 using osu.Game.Users;
@@ -85,6 +86,14 @@ namespace osu.Game.Extensions
         /// <returns>Whether online IDs match. If either instance is missing an online ID, this will return false.</returns>
         public static bool MatchesOnlineID(this IRulesetInfo? instance, IRulesetInfo? other) => matchesOnlineID(instance, other);
 
+        /// <summary>
+        /// Check whether the online ID of two <see cref="APIUser"/>s match.
+        /// </summary>
+        /// <param name="instance">The instance to compare.</param>
+        /// <param name="other">The other instance to compare against.</param>
+        /// <returns>Whether online IDs match. If either instance is missing an online ID, this will return false.</returns>
+        public static bool MatchesOnlineID(this APIUser? instance, APIUser? other) => matchesOnlineID(instance, other);
+
         private static bool matchesOnlineID(this IHasOnlineID<long>? instance, IHasOnlineID<long>? other)
         {
             if (instance == null || other == null)

From 9076519710aa245baa50743789211aa5a34caf76 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 16 Nov 2021 13:49:06 +0900
Subject: [PATCH 1043/5547] Give MultiplayerRoom a playlist, remove
 RequestAllPlaylistItems()

---
 osu.Game/Online/Multiplayer/IMultiplayerRoomServer.cs  |  5 -----
 osu.Game/Online/Multiplayer/MultiplayerClient.cs       | 10 ++++++----
 osu.Game/Online/Multiplayer/MultiplayerRoom.cs         |  4 ++++
 osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs |  9 ---------
 .../Tests/Visual/Multiplayer/TestMultiplayerClient.cs  |  6 ------
 5 files changed, 10 insertions(+), 24 deletions(-)

diff --git a/osu.Game/Online/Multiplayer/IMultiplayerRoomServer.cs b/osu.Game/Online/Multiplayer/IMultiplayerRoomServer.cs
index afaf1e89de..3e84e4b904 100644
--- a/osu.Game/Online/Multiplayer/IMultiplayerRoomServer.cs
+++ b/osu.Game/Online/Multiplayer/IMultiplayerRoomServer.cs
@@ -77,11 +77,6 @@ namespace osu.Game.Online.Multiplayer
         /// <exception cref="InvalidStateException">If an attempt to start the game occurs when the game's (or users') state disallows it.</exception>
         Task StartMatch();
 
-        /// <summary>
-        /// Requests for all playlist items of the room to be sent to the client.
-        /// </summary>
-        Task RequestAllPlaylistItems();
-
         /// <summary>
         /// Adds an item to the playlist.
         /// </summary>
diff --git a/osu.Game/Online/Multiplayer/MultiplayerClient.cs b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
index 77a1b51b7d..07f827e748 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
@@ -139,6 +139,9 @@ namespace osu.Game.Online.Multiplayer
                 var joinedRoom = await JoinRoom(room.RoomID.Value.Value, password ?? room.Password.Value).ConfigureAwait(false);
                 Debug.Assert(joinedRoom != null);
 
+                // Populate playlist items.
+                var playlistItems = await Task.WhenAll(joinedRoom.Playlist.Select(createPlaylistItem)).ConfigureAwait(false);
+
                 // Populate users.
                 Debug.Assert(joinedRoom.Users != null);
                 await Task.WhenAll(joinedRoom.Users.Select(PopulateUser)).ConfigureAwait(false);
@@ -149,6 +152,9 @@ namespace osu.Game.Online.Multiplayer
                     Room = joinedRoom;
                     APIRoom = room;
 
+                    APIRoom.Playlist.Clear();
+                    APIRoom.Playlist.AddRange(playlistItems);
+
                     Debug.Assert(LocalUser != null);
                     addUserToAPIRoom(LocalUser);
 
@@ -158,8 +164,6 @@ namespace osu.Game.Online.Multiplayer
                     OnRoomJoined();
                 }, cancellationSource.Token).ConfigureAwait(false);
 
-                await RequestAllPlaylistItems().ConfigureAwait(false);
-
                 // Update room settings.
                 await updateLocalRoomSettings(joinedRoom.Settings, cancellationSource.Token).ConfigureAwait(false);
             }, cancellationSource.Token).ConfigureAwait(false);
@@ -307,8 +311,6 @@ namespace osu.Game.Online.Multiplayer
 
         public abstract Task StartMatch();
 
-        public abstract Task RequestAllPlaylistItems();
-
         public abstract Task AddPlaylistItem(MultiplayerPlaylistItem item);
 
         Task IMultiplayerClient.RoomStateChanged(MultiplayerRoomState state)
diff --git a/osu.Game/Online/Multiplayer/MultiplayerRoom.cs b/osu.Game/Online/Multiplayer/MultiplayerRoom.cs
index 175c0e0e27..a60e70dab3 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerRoom.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerRoom.cs
@@ -7,6 +7,7 @@ using System;
 using System.Collections.Generic;
 using MessagePack;
 using Newtonsoft.Json;
+using osu.Game.Online.Rooms;
 
 namespace osu.Game.Online.Multiplayer
 {
@@ -50,6 +51,9 @@ namespace osu.Game.Online.Multiplayer
         [Key(5)]
         public MatchRoomState? MatchState { get; set; }
 
+        [Key(6)]
+        public IList<MultiplayerPlaylistItem> Playlist { get; set; } = new List<MultiplayerPlaylistItem>();
+
         [JsonConstructor]
         [SerializationConstructor]
         public MultiplayerRoom(long roomId)
diff --git a/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs b/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs
index 2609436890..7308c03ec3 100644
--- a/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs
@@ -3,7 +3,6 @@
 
 #nullable enable
 
-using System;
 using System.Collections.Generic;
 using System.Threading;
 using System.Threading.Tasks;
@@ -152,14 +151,6 @@ namespace osu.Game.Online.Multiplayer
             return connection.InvokeAsync(nameof(IMultiplayerServer.StartMatch));
         }
 
-        public override Task RequestAllPlaylistItems()
-        {
-            if (!IsConnected.Value)
-                return Task.FromResult(Array.Empty<MultiplayerPlaylistItem>());
-
-            return connection.InvokeAsync<MultiplayerPlaylistItem[]>(nameof(IMultiplayerServer.RequestAllPlaylistItems));
-        }
-
         public override Task AddPlaylistItem(MultiplayerPlaylistItem item)
         {
             if (!IsConnected.Value)
diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
index e2dff61e7c..dc86c20b4c 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
@@ -294,12 +294,6 @@ namespace osu.Game.Tests.Visual.Multiplayer
             return ((IMultiplayerClient)this).LoadRequested();
         }
 
-        public override async Task RequestAllPlaylistItems()
-        {
-            foreach (var item in playlistItems)
-                await ((IMultiplayerClient)this).PlaylistItemAdded(item).ConfigureAwait(false);
-        }
-
         public override async Task AddPlaylistItem(MultiplayerPlaylistItem item)
         {
             Debug.Assert(Room != null);

From 71fef241dff90f4d9e9979396596bd15022e9c1c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 16 Nov 2021 14:13:47 +0900
Subject: [PATCH 1044/5547] Fix recursive equality call on `APIBeatmap` and
 `APIBeatmapSet`

---
 osu.Game/Online/API/Requests/Responses/APIBeatmap.cs    | 3 ++-
 osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs | 3 ++-
 2 files changed, 4 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs b/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs
index e90de5bdb7..3fb9335629 100644
--- a/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs
@@ -4,6 +4,7 @@
 using System;
 using Newtonsoft.Json;
 using osu.Game.Beatmaps;
+using osu.Game.Extensions;
 using osu.Game.Rulesets;
 
 #nullable enable
@@ -104,6 +105,6 @@ namespace osu.Game.Online.API.Requests.Responses
 
         #endregion
 
-        public bool Equals(IBeatmapInfo? other) => other is APIBeatmap b && Equals(b);
+        public bool Equals(IBeatmapInfo? other) => other is APIBeatmap b && this.MatchesOnlineID(b);
     }
 }
diff --git a/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs b/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs
index 2628880588..8d50f3d7dd 100644
--- a/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs
@@ -6,6 +6,7 @@ using System.Collections.Generic;
 using Newtonsoft.Json;
 using osu.Game.Beatmaps;
 using osu.Game.Database;
+using osu.Game.Extensions;
 
 #nullable enable
 
@@ -142,6 +143,6 @@ namespace osu.Game.Online.API.Requests.Responses
 
         #endregion
 
-        public bool Equals(IBeatmapSetInfo? other) => other is APIBeatmapSet b && Equals(b);
+        public bool Equals(IBeatmapSetInfo? other) => other is APIBeatmapSet b && this.MatchesOnlineID(b);
     }
 }

From 41e46f158fea5e36205569dd2f9bc7b1e808397c Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 16 Nov 2021 14:37:29 +0900
Subject: [PATCH 1045/5547] Fix tests following playlist changes

Also more closely follows the server implementation.
---
 .../Multiplayer/TestMultiplayerClient.cs      | 80 ++++++++++---------
 1 file changed, 42 insertions(+), 38 deletions(-)

diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
index dc86c20b4c..3f7ad4a710 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
@@ -41,9 +41,10 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [Resolved]
         private BeatmapManager beatmaps { get; set; } = null!;
 
-        private readonly List<MultiplayerPlaylistItem> playlistItems = new List<MultiplayerPlaylistItem>();
+        private MultiplayerPlaylistItem? currentItem => Room?.Playlist[currentIndex];
+
         private readonly TestMultiplayerRoomManager roomManager;
-        private MultiplayerPlaylistItem? currentItem;
+        private int currentIndex;
 
         public TestMultiplayerClient(TestMultiplayerRoomManager roomManager)
         {
@@ -162,30 +163,27 @@ namespace osu.Game.Tests.Visual.Multiplayer
             if (password != apiRoom.Password.Value)
                 throw new InvalidOperationException("Invalid password.");
 
-            playlistItems.AddRange(apiRoom.Playlist.Select(i => new MultiplayerPlaylistItem(i)));
-
             var localUser = new MultiplayerRoomUser(api.LocalUser.Value.Id)
             {
                 User = api.LocalUser.Value
             };
 
-            await updateCurrentItem(apiRoom: apiRoom).ConfigureAwait(false);
-            Debug.Assert(currentItem != null);
-
             var room = new MultiplayerRoom(roomId)
             {
                 Settings =
                 {
                     Name = apiRoom.Name.Value,
                     MatchType = apiRoom.Type.Value,
-                    PlaylistItemId = currentItem.ID,
                     Password = password,
                     QueueMode = apiRoom.QueueMode.Value
                 },
+                Playlist = apiRoom.Playlist.Select(item => new MultiplayerPlaylistItem(item)).ToList(),
                 Users = { localUser },
                 Host = localUser
             };
 
+            await updateCurrentItem(room, false).ConfigureAwait(false);
+
             RoomSetupAction?.Invoke(room);
             RoomSetupAction = null;
 
@@ -308,28 +306,29 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 case QueueModes.HostOnly:
                     // In host-only mode, the current item is re-used.
                     item.ID = currentItem.ID;
-                    playlistItems[playlistItems.FindIndex(i => i == currentItem)] = item;
+
+                    Room.Playlist[currentIndex] = item;
                     await ((IMultiplayerClient)this).PlaylistItemChanged(item).ConfigureAwait(false);
 
                     // Note: Unlike the server, this is the easiest way to update the current item at this point.
-                    await updateCurrentItem(false).ConfigureAwait(false);
+                    await updateCurrentItem(Room, false).ConfigureAwait(false);
                     break;
 
                 default:
-                    item.ID = playlistItems.Last().ID + 1;
-                    playlistItems.Add(item);
+                    item.ID = Room.Playlist.Last().ID + 1;
+
+                    Room.Playlist.Add(item);
                     await ((IMultiplayerClient)this).PlaylistItemAdded(item).ConfigureAwait(false);
-                    await updateCurrentItem().ConfigureAwait(false);
+
+                    await updateCurrentItem(Room).ConfigureAwait(false);
                     break;
             }
         }
 
         protected override Task<APIBeatmapSet> GetOnlineBeatmapSet(int beatmapId, CancellationToken cancellationToken = default)
         {
-            Debug.Assert(Room != null);
-
-            var apiRoom = roomManager.ServerSideRooms.Single(r => r.RoomID.Value == Room.RoomID);
-            IBeatmapSetInfo? set = apiRoom.Playlist.FirstOrDefault(p => p.BeatmapID == beatmapId)?.Beatmap.Value.BeatmapSet
+            IBeatmapSetInfo? set = roomManager.ServerSideRooms.SelectMany(r => r.Playlist)
+                                              .FirstOrDefault(p => p.BeatmapID == beatmapId)?.Beatmap.Value.BeatmapSet
                                    ?? beatmaps.QueryBeatmap(b => b.OnlineID == beatmapId)?.BeatmapSet;
 
             if (set == null)
@@ -368,14 +367,24 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
         private async Task changeQueueMode(QueueModes newMode)
         {
+            Debug.Assert(Room != null);
             Debug.Assert(APIRoom != null);
             Debug.Assert(currentItem != null);
 
             if (newMode == QueueModes.HostOnly)
             {
                 // Remove all but the current and expired items. The current item may be re-used for host-only mode if it's non-expired.
-                foreach (var playlistItem in playlistItems.Where(i => !i.Expired && i.ID != currentItem.ID).ToArray())
-                    await ((IMultiplayerClient)this).PlaylistItemRemoved(playlistItem.ID).ConfigureAwait(false);
+                for (int i = 0; i < Room.Playlist.Count; i++)
+                {
+                    var item = Room.Playlist[i];
+
+                    if (item.Expired || item.ID == Room.Settings.PlaylistItemId)
+                        continue;
+
+                    Room.Playlist.RemoveAt(i--);
+
+                    await ((IMultiplayerClient)this).PlaylistItemRemoved(item.ID).ConfigureAwait(false);
+                }
 
                 // Always ensure that at least one non-expired item exists by duplicating the current item if required.
                 if (currentItem.Expired)
@@ -383,7 +392,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             }
 
             // When changing modes, items could have been added (above) or the queueing order could have changed.
-            await updateCurrentItem().ConfigureAwait(false);
+            await updateCurrentItem(Room).ConfigureAwait(false);
         }
 
         private async Task finishCurrentItem()
@@ -400,7 +409,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             if (Room.Settings.QueueMode == QueueModes.HostOnly)
                 await duplicateCurrentItem().ConfigureAwait(false);
 
-            await updateCurrentItem().ConfigureAwait(false);
+            await updateCurrentItem(Room).ConfigureAwait(false);
         }
 
         private async Task duplicateCurrentItem()
@@ -411,7 +420,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             var newItem = new MultiplayerPlaylistItem
             {
-                ID = playlistItems.Last().ID + 1,
+                ID = Room.Playlist.Last().ID + 1,
                 BeatmapID = currentItem.BeatmapID,
                 BeatmapChecksum = currentItem.BeatmapChecksum,
                 RulesetID = currentItem.RulesetID,
@@ -419,23 +428,19 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 AllowedMods = currentItem.AllowedMods
             };
 
-            playlistItems.Add(newItem);
+            Room.Playlist.Add(newItem);
             await ((IMultiplayerClient)this).PlaylistItemAdded(newItem).ConfigureAwait(false);
         }
 
-        private async Task updateCurrentItem(bool notify = true, Room? apiRoom = null)
+        private async Task updateCurrentItem(MultiplayerRoom room, bool notify = true)
         {
-            if (apiRoom == null)
-            {
-                Debug.Assert(APIRoom != null);
-                apiRoom = APIRoom;
-            }
+            MultiplayerPlaylistItem newItem;
 
-            switch (apiRoom.QueueMode.Value)
+            switch (room.Settings.QueueMode)
             {
                 default:
                     // Pick the single non-expired playlist item.
-                    currentItem = playlistItems.FirstOrDefault(i => !i.Expired) ?? playlistItems.Last();
+                    newItem = room.Playlist.FirstOrDefault(i => !i.Expired) ?? room.Playlist.Last();
                     break;
 
                 case QueueModes.FairRotate:
@@ -443,14 +448,13 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     throw new NotImplementedException();
             }
 
-            if (Room != null)
-            {
-                long lastItem = Room.Settings.PlaylistItemId;
-                Room.Settings.PlaylistItemId = currentItem.ID;
+            currentIndex = room.Playlist.IndexOf(newItem);
 
-                if (notify && currentItem.ID != lastItem)
-                    await ((IMultiplayerClient)this).SettingsChanged(Room.Settings).ConfigureAwait(false);
-            }
+            long lastItem = room.Settings.PlaylistItemId;
+            room.Settings.PlaylistItemId = newItem.ID;
+
+            if (notify && newItem.ID != lastItem)
+                await ((IMultiplayerClient)this).SettingsChanged(room.Settings).ConfigureAwait(false);
         }
     }
 }

From f414877d00a32baa327040f4333fd44b587369d3 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 16 Nov 2021 14:37:54 +0900
Subject: [PATCH 1046/5547] Rename UserID -> OwnerID

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

diff --git a/osu.Game/Online/Rooms/MultiplayerPlaylistItem.cs b/osu.Game/Online/Rooms/MultiplayerPlaylistItem.cs
index a158be71a1..6ca0b822f3 100644
--- a/osu.Game/Online/Rooms/MultiplayerPlaylistItem.cs
+++ b/osu.Game/Online/Rooms/MultiplayerPlaylistItem.cs
@@ -19,7 +19,7 @@ namespace osu.Game.Online.Rooms
         public long ID { get; set; }
 
         [Key(1)]
-        public int UserID { get; set; }
+        public int OwnerID { get; set; }
 
         [Key(2)]
         public int BeatmapID { get; set; }

From 01f3649d7531689f0e3670c7bb4b5bb00764e45a Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 16 Nov 2021 14:44:47 +0900
Subject: [PATCH 1047/5547] Rename variables for readability

---
 .../Online/Multiplayer/MultiplayerClient.cs    | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/osu.Game/Online/Multiplayer/MultiplayerClient.cs b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
index 07f827e748..b1ec16ee8d 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
@@ -617,7 +617,7 @@ namespace osu.Game.Online.Multiplayer
 
                 Debug.Assert(APIRoom != null);
 
-                APIRoom.Playlist.RemoveAll(i => i.ID == playlistItem.ID);
+                APIRoom.Playlist.RemoveAll(existingItem => existingItem.ID == playlistItem.ID);
                 APIRoom.Playlist.Add(playlistItem);
                 RoomUpdated?.Invoke();
             });
@@ -635,7 +635,7 @@ namespace osu.Game.Online.Multiplayer
 
                 Debug.Assert(APIRoom != null);
 
-                APIRoom.Playlist.RemoveAll(i => i.ID == playlistItemId);
+                APIRoom.Playlist.RemoveAll(item => item.ID == playlistItemId);
                 RoomUpdated?.Invoke();
             });
 
@@ -656,18 +656,18 @@ namespace osu.Game.Online.Multiplayer
 
                 Debug.Assert(APIRoom != null);
 
-                int index = APIRoom.Playlist.Select((i, index) => (i, index)).Single(kvp => kvp.i.ID == item.ID).index;
-                var oldItem = APIRoom.Playlist[index];
-                if (oldItem.Equals(playlistItem))
+                PlaylistItem existingItem = APIRoom.Playlist.Single(existingItem => existingItem.ID == item.ID);
+                int existingIndex = APIRoom.Playlist.IndexOf(existingItem);
+                if (existingItem.Equals(playlistItem))
                     return;
 
                 // Replace the item.
-                APIRoom.Playlist.RemoveAt(index);
-                APIRoom.Playlist.Insert(index, playlistItem);
+                APIRoom.Playlist.RemoveAt(existingIndex);
+                APIRoom.Playlist.Insert(existingIndex, playlistItem);
 
                 // If the currently-selected item was the one that got replaced, update the selected item to the new one.
-                if (CurrentMatchPlayingItem.Value == oldItem)
-                    CurrentMatchPlayingItem.Value = APIRoom.Playlist[index];
+                if (CurrentMatchPlayingItem.Value == existingItem)
+                    CurrentMatchPlayingItem.Value = playlistItem;
 
                 RoomUpdated?.Invoke();
             });

From 6cca657a2d48c6424759493d8fe264791ed211db Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 16 Nov 2021 14:45:51 +0900
Subject: [PATCH 1048/5547] Standardise naming of `CancellationToken`
 parameters

---
 osu.Game/Beatmaps/BeatmapDifficultyCache.cs    | 12 ++++++------
 osu.Game/Beatmaps/IWorkingBeatmap.cs           |  4 ++--
 osu.Game/Beatmaps/WorkingBeatmap.cs            | 18 +++++++++---------
 .../Difficulty/DifficultyCalculator.cs         |  2 +-
 .../Play/HUD/PerformancePointsCounter.cs       |  2 +-
 5 files changed, 19 insertions(+), 19 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapDifficultyCache.cs b/osu.Game/Beatmaps/BeatmapDifficultyCache.cs
index dabff0141e..d761ea3212 100644
--- a/osu.Game/Beatmaps/BeatmapDifficultyCache.cs
+++ b/osu.Game/Beatmaps/BeatmapDifficultyCache.cs
@@ -140,21 +140,21 @@ namespace osu.Game.Beatmaps
             return GetAsync(new DifficultyCacheLookup(localBeatmapInfo, localRulesetInfo, mods), cancellationToken);
         }
 
-        protected override Task<StarDifficulty> ComputeValueAsync(DifficultyCacheLookup lookup, CancellationToken token = default)
+        protected override Task<StarDifficulty> ComputeValueAsync(DifficultyCacheLookup lookup, CancellationToken cancellationToken = default)
         {
             return Task.Factory.StartNew(() =>
             {
                 if (CheckExists(lookup, out var existing))
                     return existing;
 
-                return computeDifficulty(lookup, token);
-            }, token, TaskCreationOptions.HideScheduler | TaskCreationOptions.RunContinuationsAsynchronously, updateScheduler);
+                return computeDifficulty(lookup, cancellationToken);
+            }, cancellationToken, TaskCreationOptions.HideScheduler | TaskCreationOptions.RunContinuationsAsynchronously, updateScheduler);
         }
 
-        public Task<List<TimedDifficultyAttributes>> GetTimedDifficultyAttributesAsync(WorkingBeatmap beatmap, Ruleset ruleset, Mod[] mods, CancellationToken token = default)
+        public Task<List<TimedDifficultyAttributes>> GetTimedDifficultyAttributesAsync(WorkingBeatmap beatmap, Ruleset ruleset, Mod[] mods, CancellationToken cancellationToken = default)
         {
-            return Task.Factory.StartNew(() => ruleset.CreateDifficultyCalculator(beatmap).CalculateTimed(mods, token),
-                token,
+            return Task.Factory.StartNew(() => ruleset.CreateDifficultyCalculator(beatmap).CalculateTimed(mods, cancellationToken),
+                cancellationToken,
                 TaskCreationOptions.HideScheduler | TaskCreationOptions.RunContinuationsAsynchronously,
                 updateScheduler);
         }
diff --git a/osu.Game/Beatmaps/IWorkingBeatmap.cs b/osu.Game/Beatmaps/IWorkingBeatmap.cs
index 39f6ad7b58..5e9b77392a 100644
--- a/osu.Game/Beatmaps/IWorkingBeatmap.cs
+++ b/osu.Game/Beatmaps/IWorkingBeatmap.cs
@@ -92,10 +92,10 @@ namespace osu.Game.Beatmaps
         /// </summary>
         /// <param name="ruleset">The <see cref="RulesetInfo"/> to create a playable <see cref="IBeatmap"/> for.</param>
         /// <param name="mods">The <see cref="Mod"/>s to apply to the <see cref="IBeatmap"/>.</param>
-        /// <param name="token">Cancellation token that cancels the beatmap loading process.</param>
+        /// <param name="cancellationToken">Cancellation token that cancels the beatmap loading process.</param>
         /// <returns>The converted <see cref="IBeatmap"/>.</returns>
         /// <exception cref="BeatmapInvalidForRulesetException">If <see cref="Beatmap"/> could not be converted to <paramref name="ruleset"/>.</exception>
-        IBeatmap GetPlayableBeatmap(RulesetInfo ruleset, IReadOnlyList<Mod> mods = null, CancellationToken token = default);
+        IBeatmap GetPlayableBeatmap(RulesetInfo ruleset, IReadOnlyList<Mod> mods = null, CancellationToken cancellationToken = default);
 
         /// <summary>
         /// Load a new audio track instance for this beatmap. This should be called once before accessing <see cref="Track"/>.
diff --git a/osu.Game/Beatmaps/WorkingBeatmap.cs b/osu.Game/Beatmaps/WorkingBeatmap.cs
index b4db4b9f9f..4098a57bf2 100644
--- a/osu.Game/Beatmaps/WorkingBeatmap.cs
+++ b/osu.Game/Beatmaps/WorkingBeatmap.cs
@@ -79,7 +79,7 @@ namespace osu.Game.Beatmaps
         /// <returns>The applicable <see cref="IBeatmapConverter"/>.</returns>
         protected virtual IBeatmapConverter CreateBeatmapConverter(IBeatmap beatmap, Ruleset ruleset) => ruleset.CreateBeatmapConverter(beatmap);
 
-        public virtual IBeatmap GetPlayableBeatmap(RulesetInfo ruleset, IReadOnlyList<Mod> mods = null, CancellationToken token = default)
+        public virtual IBeatmap GetPlayableBeatmap(RulesetInfo ruleset, IReadOnlyList<Mod> mods = null, CancellationToken cancellationToken = default)
         {
             mods ??= Array.Empty<Mod>();
 
@@ -97,19 +97,19 @@ namespace osu.Game.Beatmaps
             // Apply conversion mods
             foreach (var mod in mods.OfType<IApplicableToBeatmapConverter>())
             {
-                if (token.IsCancellationRequested)
+                if (cancellationToken.IsCancellationRequested)
                     throw new BeatmapLoadTimeoutException(BeatmapInfo);
 
                 mod.ApplyToBeatmapConverter(converter);
             }
 
             // Convert
-            IBeatmap converted = converter.Convert(token);
+            IBeatmap converted = converter.Convert(cancellationToken);
 
             // Apply conversion mods to the result
             foreach (var mod in mods.OfType<IApplicableAfterBeatmapConversion>())
             {
-                if (token.IsCancellationRequested)
+                if (cancellationToken.IsCancellationRequested)
                     throw new BeatmapLoadTimeoutException(BeatmapInfo);
 
                 mod.ApplyToBeatmap(converted);
@@ -120,7 +120,7 @@ namespace osu.Game.Beatmaps
             {
                 foreach (var mod in mods.OfType<IApplicableToDifficulty>())
                 {
-                    if (token.IsCancellationRequested)
+                    if (cancellationToken.IsCancellationRequested)
                         throw new BeatmapLoadTimeoutException(BeatmapInfo);
 
                     mod.ApplyToDifficulty(converted.Difficulty);
@@ -139,10 +139,10 @@ namespace osu.Game.Beatmaps
             {
                 foreach (var obj in converted.HitObjects)
                 {
-                    if (token.IsCancellationRequested)
+                    if (cancellationToken.IsCancellationRequested)
                         throw new BeatmapLoadTimeoutException(BeatmapInfo);
 
-                    obj.ApplyDefaults(converted.ControlPointInfo, converted.Difficulty, token);
+                    obj.ApplyDefaults(converted.ControlPointInfo, converted.Difficulty, cancellationToken);
                 }
             }
             catch (OperationCanceledException)
@@ -154,7 +154,7 @@ namespace osu.Game.Beatmaps
             {
                 foreach (var obj in converted.HitObjects)
                 {
-                    if (token.IsCancellationRequested)
+                    if (cancellationToken.IsCancellationRequested)
                         throw new BeatmapLoadTimeoutException(BeatmapInfo);
 
                     mod.ApplyToHitObject(obj);
@@ -165,7 +165,7 @@ namespace osu.Game.Beatmaps
 
             foreach (var mod in mods.OfType<IApplicableToBeatmap>())
             {
-                token.ThrowIfCancellationRequested();
+                cancellationToken.ThrowIfCancellationRequested();
                 mod.ApplyToBeatmap(converted);
             }
 
diff --git a/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs b/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs
index 6748158d8f..f5b6883b27 100644
--- a/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs
+++ b/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs
@@ -145,7 +145,7 @@ namespace osu.Game.Rulesets.Difficulty
         {
             playableMods = mods.Select(m => m.DeepClone()).ToArray();
 
-            Beatmap = beatmap.GetPlayableBeatmap(ruleset.RulesetInfo, playableMods, token: cancellationToken);
+            Beatmap = beatmap.GetPlayableBeatmap(ruleset.RulesetInfo, playableMods, cancellationToken: cancellationToken);
 
             var track = new TrackVirtual(10000);
             playableMods.OfType<IApplicableToTrack>().ForEach(m => m.ApplyToTrack(track));
diff --git a/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs b/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs
index 24c6c87c7d..6e679279a4 100644
--- a/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs
+++ b/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs
@@ -216,7 +216,7 @@ namespace osu.Game.Screens.Play.HUD
                 this.gameplayBeatmap = gameplayBeatmap;
             }
 
-            public override IBeatmap GetPlayableBeatmap(RulesetInfo ruleset, IReadOnlyList<Mod> mods = null, CancellationToken timeoutToken = default)
+            public override IBeatmap GetPlayableBeatmap(RulesetInfo ruleset, IReadOnlyList<Mod> mods = null, CancellationToken cancellationToken = default)
                 => gameplayBeatmap;
 
             protected override IBeatmap GetBeatmap() => gameplayBeatmap;

From d2a767049437b30e6bdf1eb09e301e2bd92474ea Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 16 Nov 2021 14:48:02 +0900
Subject: [PATCH 1049/5547] Remove no longer used helper method

---
 osu.Game/Beatmaps/WorkingBeatmap.cs | 10 ----------
 1 file changed, 10 deletions(-)

diff --git a/osu.Game/Beatmaps/WorkingBeatmap.cs b/osu.Game/Beatmaps/WorkingBeatmap.cs
index 4098a57bf2..9be239e3b0 100644
--- a/osu.Game/Beatmaps/WorkingBeatmap.cs
+++ b/osu.Game/Beatmaps/WorkingBeatmap.cs
@@ -3,7 +3,6 @@
 
 using System;
 using System.Collections.Generic;
-using System.Diagnostics;
 using System.IO;
 using System.Linq;
 using System.Threading;
@@ -188,15 +187,6 @@ namespace osu.Game.Beatmaps
             }
         }
 
-        private CancellationTokenSource createTimeoutTokenSource(TimeSpan? timeout)
-        {
-            if (Debugger.IsAttached)
-                // ignore timeout when debugger is attached (may be breakpointing / debugging).
-                return new CancellationTokenSource();
-
-            return new CancellationTokenSource(timeout ?? TimeSpan.FromSeconds(10));
-        }
-
         private readonly object beatmapFetchLock = new object();
 
         private Task<IBeatmap> loadBeatmapAsync()

From 5c3141d16afd3a4091e42ed4f1906a58d1d6fba4 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 16 Nov 2021 14:48:52 +0900
Subject: [PATCH 1050/5547] Fix ready button tooltip showing when locally
 available

---
 osu.Game/Screens/OnlinePlay/Components/ReadyButton.cs | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Screens/OnlinePlay/Components/ReadyButton.cs b/osu.Game/Screens/OnlinePlay/Components/ReadyButton.cs
index 5a4a0a0fba..9822ceaaf6 100644
--- a/osu.Game/Screens/OnlinePlay/Components/ReadyButton.cs
+++ b/osu.Game/Screens/OnlinePlay/Components/ReadyButton.cs
@@ -36,7 +36,10 @@ namespace osu.Game.Screens.OnlinePlay.Components
                 if (Enabled.Value)
                     return string.Empty;
 
-                return "Beatmap not downloaded";
+                if (availability.Value.State != DownloadState.LocallyAvailable)
+                    return "Beatmap not downloaded";
+
+                return string.Empty;
             }
         }
     }

From 29d0d5badfc1951fe8f4fbac0791a90b73ec2868 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 16 Nov 2021 14:53:10 +0900
Subject: [PATCH 1051/5547] Rename QueueModes -> QueueMode

---
 .../Multiplayer/QueueingModes/QueueModeTestScene.cs  |  2 +-
 .../QueueingModes/TestSceneFreeForAllQueueMode.cs    |  4 ++--
 .../QueueingModes/TestSceneHostOnlyQueueMode.cs      |  2 +-
 .../Visual/Multiplayer/TestSceneMultiplayer.cs       |  2 +-
 osu.Game/Online/Multiplayer/MultiplayerClient.cs     |  2 +-
 .../Online/Multiplayer/MultiplayerRoomSettings.cs    |  2 +-
 .../Queueing/{QueueModes.cs => QueueMode.cs}         |  2 +-
 osu.Game/Online/Rooms/Room.cs                        |  4 ++--
 .../Match/MultiplayerMatchSettingsOverlay.cs         |  4 ++--
 .../Multiplayer/MultiplayerMatchSubScreen.cs         |  6 +++---
 osu.Game/Screens/OnlinePlay/OnlinePlayComposite.cs   |  2 +-
 .../Visual/Multiplayer/TestMultiplayerClient.cs      | 12 ++++++------
 12 files changed, 22 insertions(+), 22 deletions(-)
 rename osu.Game/Online/Multiplayer/Queueing/{QueueModes.cs => QueueMode.cs} (94%)

diff --git a/osu.Game.Tests/Visual/Multiplayer/QueueingModes/QueueModeTestScene.cs b/osu.Game.Tests/Visual/Multiplayer/QueueingModes/QueueModeTestScene.cs
index 82ad9f3afe..cdab83e463 100644
--- a/osu.Game.Tests/Visual/Multiplayer/QueueingModes/QueueModeTestScene.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/QueueingModes/QueueModeTestScene.cs
@@ -26,7 +26,7 @@ namespace osu.Game.Tests.Visual.Multiplayer.QueueingModes
 {
     public abstract class QueueModeTestScene : ScreenTestScene
     {
-        protected abstract QueueModes Mode { get; }
+        protected abstract QueueMode Mode { get; }
 
         protected BeatmapInfo InitialBeatmap { get; private set; }
         protected BeatmapInfo OtherBeatmap { get; private set; }
diff --git a/osu.Game.Tests/Visual/Multiplayer/QueueingModes/TestSceneFreeForAllQueueMode.cs b/osu.Game.Tests/Visual/Multiplayer/QueueingModes/TestSceneFreeForAllQueueMode.cs
index 0cf330bbbb..8217eabcdb 100644
--- a/osu.Game.Tests/Visual/Multiplayer/QueueingModes/TestSceneFreeForAllQueueMode.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/QueueingModes/TestSceneFreeForAllQueueMode.cs
@@ -14,7 +14,7 @@ namespace osu.Game.Tests.Visual.Multiplayer.QueueingModes
 {
     public class TestSceneFreeForAllQueueMode : QueueModeTestScene
     {
-        protected override QueueModes Mode => QueueModes.FreeForAll;
+        protected override QueueMode Mode => QueueMode.FreeForAll;
 
         [Test]
         public void TestFirstItemSelectedByDefault()
@@ -72,7 +72,7 @@ namespace osu.Game.Tests.Visual.Multiplayer.QueueingModes
             // Move to the "other" beatmap.
             RunGameplay();
 
-            AddStep("change queue mode", () => Client.ChangeSettings(queueMode: QueueModes.HostOnly));
+            AddStep("change queue mode", () => Client.ChangeSettings(queueMode: QueueMode.HostOnly));
             AddAssert("playlist has 2 items", () => Client.APIRoom?.Playlist.Count == 2);
             AddAssert("playlist item is the other beatmap", () => Client.CurrentMatchPlayingItem.Value?.BeatmapID == OtherBeatmap.OnlineID);
             AddAssert("playlist item is not expired", () => Client.APIRoom?.Playlist[1].Expired == false);
diff --git a/osu.Game.Tests/Visual/Multiplayer/QueueingModes/TestSceneHostOnlyQueueMode.cs b/osu.Game.Tests/Visual/Multiplayer/QueueingModes/TestSceneHostOnlyQueueMode.cs
index fb11416140..d9e6ea878b 100644
--- a/osu.Game.Tests/Visual/Multiplayer/QueueingModes/TestSceneHostOnlyQueueMode.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/QueueingModes/TestSceneHostOnlyQueueMode.cs
@@ -14,7 +14,7 @@ namespace osu.Game.Tests.Visual.Multiplayer.QueueingModes
 {
     public class TestSceneHostOnlyQueueMode : QueueModeTestScene
     {
-        protected override QueueModes Mode => QueueModes.HostOnly;
+        protected override QueueMode Mode => QueueMode.HostOnly;
 
         [Test]
         public void TestFirstItemSelectedByDefault()
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
index 66c639ed62..1cc770b670 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
@@ -589,7 +589,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 roomManager.AddServerSideRoom(new Room
                 {
                     Name = { Value = "Test Room" },
-                    QueueMode = { Value = QueueModes.FreeForAll },
+                    QueueMode = { Value = QueueMode.FreeForAll },
                     Playlist =
                     {
                         new PlaylistItem
diff --git a/osu.Game/Online/Multiplayer/MultiplayerClient.cs b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
index b1ec16ee8d..788cc1f40b 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
@@ -222,7 +222,7 @@ namespace osu.Game.Online.Multiplayer
         /// <param name="password">The new password, if any.</param>
         /// <param name="matchType">The type of the match, if any.</param>
         /// <param name="queueMode">The new queue mode, if any.</param>
-        public Task ChangeSettings(Optional<string> name = default, Optional<string> password = default, Optional<MatchType> matchType = default, Optional<QueueModes> queueMode = default)
+        public Task ChangeSettings(Optional<string> name = default, Optional<string> password = default, Optional<MatchType> matchType = default, Optional<QueueMode> queueMode = default)
         {
             if (Room == null)
                 throw new InvalidOperationException("Must be joined to a match to change settings.");
diff --git a/osu.Game/Online/Multiplayer/MultiplayerRoomSettings.cs b/osu.Game/Online/Multiplayer/MultiplayerRoomSettings.cs
index 70e884dcce..0f7c61bbc6 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerRoomSettings.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerRoomSettings.cs
@@ -27,7 +27,7 @@ namespace osu.Game.Online.Multiplayer
         public MatchType MatchType { get; set; } = MatchType.HeadToHead;
 
         [Key(4)]
-        public QueueModes QueueMode { get; set; } = QueueModes.HostOnly;
+        public QueueMode QueueMode { get; set; } = QueueMode.HostOnly;
 
         public bool Equals(MultiplayerRoomSettings other)
             => Password.Equals(other.Password, StringComparison.Ordinal)
diff --git a/osu.Game/Online/Multiplayer/Queueing/QueueModes.cs b/osu.Game/Online/Multiplayer/Queueing/QueueMode.cs
similarity index 94%
rename from osu.Game/Online/Multiplayer/Queueing/QueueModes.cs
rename to osu.Game/Online/Multiplayer/Queueing/QueueMode.cs
index 0ead8d2f06..169d238496 100644
--- a/osu.Game/Online/Multiplayer/Queueing/QueueModes.cs
+++ b/osu.Game/Online/Multiplayer/Queueing/QueueMode.cs
@@ -5,7 +5,7 @@ using System.ComponentModel;
 
 namespace osu.Game.Online.Multiplayer.Queueing
 {
-    public enum QueueModes
+    public enum QueueMode
     {
         // used for osu-web deserialization so names shouldn't be changed.
 
diff --git a/osu.Game/Online/Rooms/Room.cs b/osu.Game/Online/Rooms/Room.cs
index f3d591cde0..51f8bd7437 100644
--- a/osu.Game/Online/Rooms/Room.cs
+++ b/osu.Game/Online/Rooms/Room.cs
@@ -76,11 +76,11 @@ namespace osu.Game.Online.Rooms
 
         [Cached]
         [JsonIgnore]
-        public readonly Bindable<QueueModes> QueueMode = new Bindable<QueueModes>();
+        public readonly Bindable<QueueMode> QueueMode = new Bindable<QueueMode>();
 
         [JsonConverter(typeof(SnakeCaseStringEnumConverter))]
         [JsonProperty("queue_mode")]
-        private QueueModes queueMode
+        private QueueMode queueMode
         {
             get => QueueMode.Value;
             set => QueueMode.Value = value;
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs
index 98a0cd3d37..6bb698cd67 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs
@@ -61,7 +61,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
             public OsuTextBox NameField, MaxParticipantsField;
             public RoomAvailabilityPicker AvailabilityPicker;
             public MatchTypePicker TypePicker;
-            public OsuEnumDropdown<QueueModes> QueueModeDropdown;
+            public OsuEnumDropdown<QueueMode> QueueModeDropdown;
             public OsuTextBox PasswordTextBox;
             public TriangleButton ApplyButton;
 
@@ -208,7 +208,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
                                                                     {
                                                                         RelativeSizeAxes = Axes.X,
                                                                         Height = 40,
-                                                                        Child = QueueModeDropdown = new OsuEnumDropdown<QueueModes>
+                                                                        Child = QueueModeDropdown = new OsuEnumDropdown<QueueMode>
                                                                         {
                                                                             RelativeSizeAxes = Axes.X
                                                                         }
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
index c99367851a..09ebfbc13c 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
@@ -388,13 +388,13 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
 
             switch (client.Room.Settings.QueueMode)
             {
-                case QueueModes.HostOnly:
+                case QueueMode.HostOnly:
                     AddOrEditPlaylistButton.Text = "Edit beatmap";
                     AddOrEditPlaylistButton.Alpha = client.IsHost ? 1 : 0;
                     break;
 
-                case QueueModes.FreeForAll:
-                case QueueModes.FairRotate:
+                case QueueMode.FreeForAll:
+                case QueueMode.FairRotate:
                     AddOrEditPlaylistButton.Text = "Add beatmap";
                     AddOrEditPlaylistButton.Alpha = 1;
                     break;
diff --git a/osu.Game/Screens/OnlinePlay/OnlinePlayComposite.cs b/osu.Game/Screens/OnlinePlay/OnlinePlayComposite.cs
index da82a77a13..b6f4abdbb6 100644
--- a/osu.Game/Screens/OnlinePlay/OnlinePlayComposite.cs
+++ b/osu.Game/Screens/OnlinePlay/OnlinePlayComposite.cs
@@ -67,7 +67,7 @@ namespace osu.Game.Screens.OnlinePlay
         protected Bindable<TimeSpan?> Duration { get; private set; }
 
         [Resolved(typeof(Room), nameof(Room.QueueMode))]
-        protected Bindable<QueueModes> QueueMode { get; private set; }
+        protected Bindable<QueueMode> QueueMode { get; private set; }
 
         [Resolved(CanBeNull = true)]
         private IBindable<PlaylistItem> subScreenSelectedItem { get; set; }
diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
index 3f7ad4a710..7965bba8a1 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
@@ -298,12 +298,12 @@ namespace osu.Game.Tests.Visual.Multiplayer
             Debug.Assert(APIRoom != null);
             Debug.Assert(currentItem != null);
 
-            if (Room.Settings.QueueMode == QueueModes.HostOnly && Room.Host?.UserID != LocalUser?.UserID)
+            if (Room.Settings.QueueMode == QueueMode.HostOnly && Room.Host?.UserID != LocalUser?.UserID)
                 throw new InvalidOperationException("Local user is not the room host.");
 
             switch (Room.Settings.QueueMode)
             {
-                case QueueModes.HostOnly:
+                case QueueMode.HostOnly:
                     // In host-only mode, the current item is re-used.
                     item.ID = currentItem.ID;
 
@@ -365,13 +365,13 @@ namespace osu.Game.Tests.Visual.Multiplayer
             }
         }
 
-        private async Task changeQueueMode(QueueModes newMode)
+        private async Task changeQueueMode(QueueMode newMode)
         {
             Debug.Assert(Room != null);
             Debug.Assert(APIRoom != null);
             Debug.Assert(currentItem != null);
 
-            if (newMode == QueueModes.HostOnly)
+            if (newMode == QueueMode.HostOnly)
             {
                 // Remove all but the current and expired items. The current item may be re-used for host-only mode if it's non-expired.
                 for (int i = 0; i < Room.Playlist.Count; i++)
@@ -406,7 +406,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             await ((IMultiplayerClient)this).PlaylistItemChanged(currentItem).ConfigureAwait(false);
 
             // In host-only mode, a duplicate playlist item will be used for the next round.
-            if (Room.Settings.QueueMode == QueueModes.HostOnly)
+            if (Room.Settings.QueueMode == QueueMode.HostOnly)
                 await duplicateCurrentItem().ConfigureAwait(false);
 
             await updateCurrentItem(Room).ConfigureAwait(false);
@@ -443,7 +443,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     newItem = room.Playlist.FirstOrDefault(i => !i.Expired) ?? room.Playlist.Last();
                     break;
 
-                case QueueModes.FairRotate:
+                case QueueMode.FairRotate:
                     // Group playlist items by (user_id -> count_expired), and select the first available playlist item from a user that has available beatmaps where count_expired is the lowest.
                     throw new NotImplementedException();
             }

From 00f0321f25dde61ff830aaf2284a9a5b1a569fbe Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 16 Nov 2021 15:44:47 +0900
Subject: [PATCH 1052/5547] Add nullable equality comparers

---
 .../Multiplayer/MultiplayerRoomSettings.cs      | 17 +++++++++++------
 .../Online/Multiplayer/MultiplayerRoomUser.cs   |  3 ++-
 2 files changed, 13 insertions(+), 7 deletions(-)

diff --git a/osu.Game/Online/Multiplayer/MultiplayerRoomSettings.cs b/osu.Game/Online/Multiplayer/MultiplayerRoomSettings.cs
index 0f7c61bbc6..e84026529f 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerRoomSettings.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerRoomSettings.cs
@@ -29,12 +29,17 @@ namespace osu.Game.Online.Multiplayer
         [Key(4)]
         public QueueMode QueueMode { get; set; } = QueueMode.HostOnly;
 
-        public bool Equals(MultiplayerRoomSettings other)
-            => Password.Equals(other.Password, StringComparison.Ordinal)
-               && Name.Equals(other.Name, StringComparison.Ordinal)
-               && PlaylistItemId == other.PlaylistItemId
-               && MatchType == other.MatchType
-               && QueueMode == other.QueueMode;
+        public bool Equals(MultiplayerRoomSettings? other)
+        {
+            if (ReferenceEquals(this, other)) return true;
+            if (other == null) return false;
+
+            return Password.Equals(other.Password, StringComparison.Ordinal)
+                   && Name.Equals(other.Name, StringComparison.Ordinal)
+                   && PlaylistItemId == other.PlaylistItemId
+                   && MatchType == other.MatchType
+                   && QueueMode == other.QueueMode;
+        }
 
         public override string ToString() => $"Name:{Name}"
                                              + $" Password:{(string.IsNullOrEmpty(Password) ? "no" : "yes")}"
diff --git a/osu.Game/Online/Multiplayer/MultiplayerRoomUser.cs b/osu.Game/Online/Multiplayer/MultiplayerRoomUser.cs
index 519bfff116..f0b7dcbff8 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerRoomUser.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerRoomUser.cs
@@ -48,9 +48,10 @@ namespace osu.Game.Online.Multiplayer
             UserID = userId;
         }
 
-        public bool Equals(MultiplayerRoomUser other)
+        public bool Equals(MultiplayerRoomUser? other)
         {
             if (ReferenceEquals(this, other)) return true;
+            if (other == null) return false;
 
             return UserID == other.UserID;
         }

From c8038df5096a2696411a93190fd3fe2fbe989cd4 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 16 Nov 2021 16:06:30 +0900
Subject: [PATCH 1053/5547] Fix CI inspections

---
 osu.Game/Online/Multiplayer/MultiplayerClient.cs | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Online/Multiplayer/MultiplayerClient.cs b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
index 788cc1f40b..09f5c6a458 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
@@ -617,7 +617,7 @@ namespace osu.Game.Online.Multiplayer
 
                 Debug.Assert(APIRoom != null);
 
-                APIRoom.Playlist.RemoveAll(existingItem => existingItem.ID == playlistItem.ID);
+                APIRoom.Playlist.RemoveAll(existing => existing.ID == playlistItem.ID);
                 APIRoom.Playlist.Add(playlistItem);
                 RoomUpdated?.Invoke();
             });
@@ -635,7 +635,7 @@ namespace osu.Game.Online.Multiplayer
 
                 Debug.Assert(APIRoom != null);
 
-                APIRoom.Playlist.RemoveAll(item => item.ID == playlistItemId);
+                APIRoom.Playlist.RemoveAll(existing => existing.ID == playlistItemId);
                 RoomUpdated?.Invoke();
             });
 
@@ -656,7 +656,7 @@ namespace osu.Game.Online.Multiplayer
 
                 Debug.Assert(APIRoom != null);
 
-                PlaylistItem existingItem = APIRoom.Playlist.Single(existingItem => existingItem.ID == item.ID);
+                PlaylistItem existingItem = APIRoom.Playlist.Single(existing => existing.ID == item.ID);
                 int existingIndex = APIRoom.Playlist.IndexOf(existingItem);
                 if (existingItem.Equals(playlistItem))
                     return;

From 49cdcffa3008897850b0fe1072fa1fecf8c731b5 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 16 Nov 2021 16:58:44 +0900
Subject: [PATCH 1054/5547] Simplify schedule logic in
 `DrawableRoomPlaylistItem`

---
 .../OnlinePlay/DrawableRoomPlaylistItem.cs        | 15 +++------------
 1 file changed, 3 insertions(+), 12 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
index 85cee46a29..a1e3bfdd8b 100644
--- a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
+++ b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
@@ -13,7 +13,6 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Input.Events;
-using osu.Framework.Threading;
 using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.Drawables;
 using osu.Game.Graphics;
@@ -87,23 +86,15 @@ namespace osu.Game.Screens.OnlinePlay
 
             SelectedItem.BindValueChanged(selected => maskingContainer.BorderThickness = selected.NewValue == Model ? 5 : 0, true);
 
-            beatmap.BindValueChanged(_ => scheduleRefresh());
-            ruleset.BindValueChanged(_ => scheduleRefresh());
-
-            requiredMods.CollectionChanged += (_, __) => scheduleRefresh();
+            beatmap.BindValueChanged(_ => Scheduler.AddOnce(refresh));
+            ruleset.BindValueChanged(_ => Scheduler.AddOnce(refresh));
+            requiredMods.CollectionChanged += (_, __) => Scheduler.AddOnce(refresh);
 
             refresh();
         }
 
-        private ScheduledDelegate scheduledRefresh;
         private PanelBackground panelBackground;
 
-        private void scheduleRefresh()
-        {
-            scheduledRefresh?.Cancel();
-            scheduledRefresh = Schedule(refresh);
-        }
-
         private void refresh()
         {
             difficultyIconContainer.Child = new DifficultyIcon(Item.Beatmap.Value, ruleset.Value, requiredMods, performBackgroundDifficultyLookup: false) { Size = new Vector2(32) };

From aa188d5a52fa5004d5219596af75d9387ad81995 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 16 Nov 2021 17:01:24 +0900
Subject: [PATCH 1055/5547] Add ability for playlist items to be marked as
 invalid

---
 osu.Game/Online/Rooms/PlaylistItem.cs              |  7 +++++++
 .../Screens/OnlinePlay/DrawableRoomPlaylistItem.cs | 14 +++++++++++++-
 2 files changed, 20 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Online/Rooms/PlaylistItem.cs b/osu.Game/Online/Rooms/PlaylistItem.cs
index cb550281a9..4a94191a34 100644
--- a/osu.Game/Online/Rooms/PlaylistItem.cs
+++ b/osu.Game/Online/Rooms/PlaylistItem.cs
@@ -30,6 +30,11 @@ namespace osu.Game.Online.Rooms
         [JsonProperty("expired")]
         public bool Expired { get; set; }
 
+        [JsonIgnore]
+        public IBindable<bool> Valid => valid;
+
+        private readonly Bindable<bool> valid = new BindableBool(true);
+
         [JsonIgnore]
         public readonly Bindable<IBeatmapInfo> Beatmap = new Bindable<IBeatmapInfo>();
 
@@ -69,6 +74,8 @@ namespace osu.Game.Online.Rooms
             Ruleset.BindValueChanged(ruleset => RulesetID = ruleset.NewValue?.ID ?? 0);
         }
 
+        public void MarkInvalid() => valid.Value = false;
+
         public void MapObjects(RulesetStore rulesets)
         {
             Beatmap.Value ??= apiBeatmap;
diff --git a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
index a1e3bfdd8b..90cb362d5c 100644
--- a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
+++ b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
@@ -45,6 +45,7 @@ namespace osu.Game.Screens.OnlinePlay
         private ModDisplay modDisplay;
 
         private readonly Bindable<IBeatmapInfo> beatmap = new Bindable<IBeatmapInfo>();
+        private readonly IBindable<bool> valid = new Bindable<bool>();
         private readonly Bindable<RulesetInfo> ruleset = new Bindable<RulesetInfo>();
         private readonly BindableList<Mod> requiredMods = new BindableList<Mod>();
 
@@ -65,14 +66,18 @@ namespace osu.Game.Screens.OnlinePlay
             this.allowSelection = allowSelection;
 
             beatmap.BindTo(item.Beatmap);
+            valid.BindTo(item.Valid);
             ruleset.BindTo(item.Ruleset);
             requiredMods.BindTo(item.RequiredMods);
 
             ShowDragHandle.Value = allowEdit;
         }
 
+        [Resolved]
+        private OsuColour colours { get; set; }
+
         [BackgroundDependencyLoader]
-        private void load(OsuColour colours)
+        private void load()
         {
             if (!allowEdit)
                 HandleColour = HandleColour.Opacity(0);
@@ -88,6 +93,7 @@ namespace osu.Game.Screens.OnlinePlay
 
             beatmap.BindValueChanged(_ => Scheduler.AddOnce(refresh));
             ruleset.BindValueChanged(_ => Scheduler.AddOnce(refresh));
+            valid.BindValueChanged(_ => Scheduler.AddOnce(refresh));
             requiredMods.CollectionChanged += (_, __) => Scheduler.AddOnce(refresh);
 
             refresh();
@@ -97,6 +103,12 @@ namespace osu.Game.Screens.OnlinePlay
 
         private void refresh()
         {
+            if (!valid.Value)
+            {
+                maskingContainer.BorderThickness = 5;
+                maskingContainer.BorderColour = colours.Red;
+            }
+
             difficultyIconContainer.Child = new DifficultyIcon(Item.Beatmap.Value, ruleset.Value, requiredMods, performBackgroundDifficultyLookup: false) { Size = new Vector2(32) };
 
             panelBackground.Beatmap.Value = Item.Beatmap.Value;

From e78c5d0858479780a8bafaac5462533f5230738d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 16 Nov 2021 17:13:50 +0900
Subject: [PATCH 1056/5547] Show `loadingLayer` before calling `CreateRoom`

This fixes `TestScenePlaylistsMatchSettingsOverlay` incorrectly leaving
the loading layer visible.
---
 .../OnlinePlay/Playlists/PlaylistsRoomSettingsOverlay.cs       | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSettingsOverlay.cs b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSettingsOverlay.cs
index c2bd7730e9..3bcfb89aa7 100644
--- a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSettingsOverlay.cs
+++ b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSettingsOverlay.cs
@@ -339,9 +339,8 @@ namespace osu.Game.Screens.OnlinePlay.Playlists
 
                 Duration.Value = DurationField.Current.Value;
 
-                manager?.CreateRoom(room, onSuccess, onError);
-
                 loadingLayer.Show();
+                manager?.CreateRoom(room, onSuccess, onError);
             }
 
             private void hideError() => ErrorText.FadeOut(50);

From 6f82e6351fabbeb4adc71b36065a7a942664778a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 16 Nov 2021 17:01:37 +0900
Subject: [PATCH 1057/5547] Parse osu-web error text to present invalid items
 to the user in a more approachable format

---
 .../Playlists/PlaylistsRoomSettingsOverlay.cs | 27 +++++++++++++++++--
 1 file changed, 25 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSettingsOverlay.cs b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSettingsOverlay.cs
index 3bcfb89aa7..cb4a81f108 100644
--- a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSettingsOverlay.cs
+++ b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSettingsOverlay.cs
@@ -3,6 +3,7 @@
 
 using System;
 using System.Collections.Specialized;
+using System.Linq;
 using Humanizer;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
@@ -349,9 +350,31 @@ namespace osu.Game.Screens.OnlinePlay.Playlists
 
             private void onError(string text)
             {
-                ErrorText.Text = text;
-                ErrorText.FadeIn(50);
+                // see https://github.com/ppy/osu-web/blob/2c97aaeb64fb4ed97c747d8383a35b30f57428c7/app/Models/Multiplayer/PlaylistItem.php#L48.
+                const string not_found_prefix = "beatmaps not found:";
 
+                if (text.StartsWith(not_found_prefix, StringComparison.Ordinal))
+                {
+                    ErrorText.Text = "One or more beatmap was not available online. Please remove or replaced the highlighted items.";
+
+                    int[] invalidBeatmapIDs = text
+                                              .Substring(not_found_prefix.Length + 1)
+                                              .Split(", ")
+                                              .Select(int.Parse)
+                                              .ToArray();
+
+                    foreach (var item in Playlist)
+                    {
+                        if (invalidBeatmapIDs.Contains(item.BeatmapID))
+                            item.MarkInvalid();
+                    }
+                }
+                else
+                {
+                    ErrorText.Text = text;
+                }
+
+                ErrorText.FadeIn(50);
                 loadingLayer.Hide();
             }
         }

From 2d125893fce2f08702ec31e0fc6704cc25a38f45 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 16 Nov 2021 17:08:21 +0900
Subject: [PATCH 1058/5547] Add tests and disable selection on invalid items

---
 .../TestSceneDrawableRoomPlaylist.cs          | 13 +++++
 .../TestScenePlaylistsMatchSettingsOverlay.cs | 52 +++++++++++++++----
 .../OnlinePlay/DrawableRoomPlaylistItem.cs    |  2 +-
 3 files changed, 55 insertions(+), 12 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
index 8ac0a2cbe5..efc3b07d0a 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
@@ -67,6 +67,19 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddAssert("no item selected", () => playlist.SelectedItem.Value == null);
         }
 
+        [Test]
+        public void TestMarkInvalid()
+        {
+            createPlaylist(true, true);
+
+            AddStep("mark item 0 as invalid", () => playlist.Items[0].MarkInvalid());
+
+            moveToItem(0);
+
+            AddStep("click", () => InputManager.Click(MouseButton.Left));
+            AddAssert("no item selected", () => playlist.SelectedItem.Value == null);
+        }
+
         [Test]
         public void TestSelectable()
         {
diff --git a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsMatchSettingsOverlay.cs b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsMatchSettingsOverlay.cs
index 48222e6b94..278379c692 100644
--- a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsMatchSettingsOverlay.cs
+++ b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsMatchSettingsOverlay.cs
@@ -73,7 +73,7 @@ namespace osu.Game.Tests.Visual.Playlists
                 RoomManager.CreateRequested = r =>
                 {
                     createdRoom = r;
-                    return true;
+                    return string.Empty;
                 };
             });
 
@@ -82,28 +82,58 @@ namespace osu.Game.Tests.Visual.Playlists
             AddAssert("has correct duration", () => createdRoom.Duration.Value == expectedDuration);
         }
 
+        [Test]
+        public void TestInvalidBeatmapError()
+        {
+            const string not_found_prefix = "beatmaps not found:";
+
+            string errorMesage = null;
+
+            AddStep("setup", () =>
+            {
+                var beatmap = CreateBeatmap(Ruleset.Value).BeatmapInfo;
+
+                SelectedRoom.Value.Name.Value = "Test Room";
+                SelectedRoom.Value.Playlist.Add(new PlaylistItem { Beatmap = { Value = beatmap } });
+
+                errorMesage = $"{not_found_prefix} {beatmap.OnlineID}";
+
+                RoomManager.CreateRequested = _ => errorMesage;
+            });
+
+            AddAssert("error not displayed", () => !settings.ErrorText.IsPresent);
+            AddAssert("playlist item valid", () => SelectedRoom.Value.Playlist[0].Valid.Value);
+
+            AddStep("create room", () => settings.ApplyButton.Action.Invoke());
+
+            AddAssert("error displayed", () => settings.ErrorText.IsPresent);
+            AddAssert("error has custom text", () => settings.ErrorText.Text != errorMesage);
+            AddAssert("playlist item marked invalid", () => !SelectedRoom.Value.Playlist[0].Valid.Value);
+        }
+
         [Test]
         public void TestCreationFailureDisplaysError()
         {
-            bool fail;
+            const string error_message = "failed";
+
+            string failText = error_message;
 
             AddStep("setup", () =>
             {
                 SelectedRoom.Value.Name.Value = "Test Room";
                 SelectedRoom.Value.Playlist.Add(new PlaylistItem { Beatmap = { Value = CreateBeatmap(Ruleset.Value).BeatmapInfo } });
 
-                fail = true;
-                RoomManager.CreateRequested = _ => !fail;
+                RoomManager.CreateRequested = _ => failText;
             });
             AddAssert("error not displayed", () => !settings.ErrorText.IsPresent);
 
             AddStep("create room", () => settings.ApplyButton.Action.Invoke());
             AddAssert("error displayed", () => settings.ErrorText.IsPresent);
-            AddAssert("error has correct text", () => settings.ErrorText.Text == TestRoomManager.FAILED_TEXT);
+            AddAssert("error has correct text", () => settings.ErrorText.Text == error_message);
 
             AddStep("create room no fail", () =>
             {
-                fail = false;
+                failText = string.Empty;
                 settings.ApplyButton.Action.Invoke();
             });
 
@@ -132,9 +162,7 @@ namespace osu.Game.Tests.Visual.Playlists
 
         protected class TestRoomManager : IRoomManager
         {
-            public const string FAILED_TEXT = "failed";
-
-            public Func<Room, bool> CreateRequested;
+            public Func<Room, string> CreateRequested;
 
             public event Action RoomsUpdated
             {
@@ -157,8 +185,10 @@ namespace osu.Game.Tests.Visual.Playlists
                 if (CreateRequested == null)
                     return;
 
-                if (!CreateRequested.Invoke(room))
-                    onError?.Invoke(FAILED_TEXT);
+                string error = CreateRequested.Invoke(room);
+
+                if (!string.IsNullOrEmpty(error))
+                    onError?.Invoke(error);
                 else
                     onSuccess?.Invoke(room);
             }
diff --git a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
index 90cb362d5c..7af858f1f8 100644
--- a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
+++ b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
@@ -281,7 +281,7 @@ namespace osu.Game.Screens.OnlinePlay
 
         protected override bool OnClick(ClickEvent e)
         {
-            if (allowSelection)
+            if (allowSelection && valid.Value)
                 SelectedItem.Value = Model;
             return true;
         }

From 2dd721f7609480d212051bc80f214b3fc5068b3c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 16 Nov 2021 17:41:16 +0900
Subject: [PATCH 1059/5547] Fix incorrect `CancellationToken` being used for
 inner check during leaderboard updates

---
 .../Screens/Select/Leaderboards/BeatmapLeaderboard.cs     | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
index 9c8ccee99b..03da930c5c 100644
--- a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
+++ b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
@@ -116,6 +116,8 @@ namespace osu.Game.Screens.Select.Leaderboards
             loadCancellationSource?.Cancel();
             loadCancellationSource = new CancellationTokenSource();
 
+            var cancellationToken = loadCancellationSource.Token;
+
             if (BeatmapInfo == null)
             {
                 PlaceholderState = PlaceholderState.NoneSelected;
@@ -140,7 +142,7 @@ namespace osu.Game.Screens.Select.Leaderboards
                     scores = scores.Where(s => s.Mods.Any(m => selectedMods.Contains(m.Acronym)));
                 }
 
-                scoreManager.OrderByTotalScoreAsync(scores.ToArray(), loadCancellationSource.Token)
+                scoreManager.OrderByTotalScoreAsync(scores.ToArray(), cancellationToken)
                             .ContinueWith(ordered => scoresCallback?.Invoke(ordered.Result), TaskContinuationOptions.OnlyOnRanToCompletion);
 
                 return null;
@@ -176,10 +178,10 @@ namespace osu.Game.Screens.Select.Leaderboards
 
             req.Success += r =>
             {
-                scoreManager.OrderByTotalScoreAsync(r.Scores.Select(s => s.CreateScoreInfo(rulesets, BeatmapInfo)).ToArray(), loadCancellationSource.Token)
+                scoreManager.OrderByTotalScoreAsync(r.Scores.Select(s => s.CreateScoreInfo(rulesets, BeatmapInfo)).ToArray(), cancellationToken)
                             .ContinueWith(ordered => Schedule(() =>
                             {
-                                if (loadCancellationSource.IsCancellationRequested)
+                                if (cancellationToken.IsCancellationRequested)
                                     return;
 
                                 scoresCallback?.Invoke(ordered.Result);

From f74afb48fdc424ecf1c08c1e60a33de0b75623ff Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 16 Nov 2021 17:50:51 +0900
Subject: [PATCH 1060/5547] Fix `StandAloneChatDisplay`'s `TextBox` having
 different corner radius

---
 osu.Game/Online/Chat/StandAloneChatDisplay.cs | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Online/Chat/StandAloneChatDisplay.cs b/osu.Game/Online/Chat/StandAloneChatDisplay.cs
index ede76235b1..1f8d05fcd1 100644
--- a/osu.Game/Online/Chat/StandAloneChatDisplay.cs
+++ b/osu.Game/Online/Chat/StandAloneChatDisplay.cs
@@ -41,8 +41,10 @@ namespace osu.Game.Online.Chat
         /// <param name="postingTextbox">Whether a textbox for posting new messages should be displayed.</param>
         public StandAloneChatDisplay(bool postingTextbox = false)
         {
+            const float corner_radius = 10;
+
             this.postingTextbox = postingTextbox;
-            CornerRadius = 10;
+            CornerRadius = corner_radius;
             Masking = true;
 
             InternalChildren = new Drawable[]
@@ -62,6 +64,7 @@ namespace osu.Game.Online.Chat
                     RelativeSizeAxes = Axes.X,
                     Height = textbox_height,
                     PlaceholderText = "type your message",
+                    CornerRadius = corner_radius,
                     ReleaseFocusOnCommit = false,
                     HoldFocus = true,
                     Anchor = Anchor.BottomLeft,

From f2d05ea899ba2aaa93deb9680042c1ce6a5cba8f Mon Sep 17 00:00:00 2001
From: MBmasher <mbmasher@gmail.com>
Date: Wed, 17 Nov 2021 11:27:48 +1100
Subject: [PATCH 1061/5547] Remove strain being multiplied by max opacity bonus

---
 osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
index caae53516d..6d6f2b0f6c 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
@@ -80,11 +80,9 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
 
             result = Math.Pow(smallDistNerf * result, 2.0);
 
-            if (hidden) {
-                result *= 1.0 + max_opacity_bonus;
-                // Additional bonus for Hidden due to there being no approach circles.
+            // Additional bonus for Hidden due to there being no approach circles.
+            if (hidden)
                 result *= 1.0 + hidden_bonus;
-            }
 
             return result;
         }

From 63c5f7d9d7b16309f045fa22faf39e4809a0a631 Mon Sep 17 00:00:00 2001
From: MBmasher <mbmasher@gmail.com>
Date: Wed, 17 Nov 2021 11:39:12 +1100
Subject: [PATCH 1062/5547] Balancing opacity and hidden bonus

---
 osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
index 6d6f2b0f6c..12580cb450 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
@@ -33,7 +33,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
         private double preemptTime;
 
         private const double max_opacity_bonus = 0.4;
-        private const double hidden_bonus = 0.3;
+        private const double hidden_bonus = 0.4;
 
         private double currentStrain;
 

From 13f3e2eea9d3c590cd910e556feab0ee5e9742a6 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 17 Nov 2021 10:48:33 +0900
Subject: [PATCH 1063/5547] Add back default timeout to `GetPlayableBeatmap`

---
 osu.Game/Beatmaps/IWorkingBeatmap.cs          |  4 ++--
 osu.Game/Beatmaps/WorkingBeatmap.cs           | 19 ++++++++++---------
 .../Play/HUD/PerformancePointsCounter.cs      |  2 +-
 3 files changed, 13 insertions(+), 12 deletions(-)

diff --git a/osu.Game/Beatmaps/IWorkingBeatmap.cs b/osu.Game/Beatmaps/IWorkingBeatmap.cs
index 5e9b77392a..6bf338db59 100644
--- a/osu.Game/Beatmaps/IWorkingBeatmap.cs
+++ b/osu.Game/Beatmaps/IWorkingBeatmap.cs
@@ -92,10 +92,10 @@ namespace osu.Game.Beatmaps
         /// </summary>
         /// <param name="ruleset">The <see cref="RulesetInfo"/> to create a playable <see cref="IBeatmap"/> for.</param>
         /// <param name="mods">The <see cref="Mod"/>s to apply to the <see cref="IBeatmap"/>.</param>
-        /// <param name="cancellationToken">Cancellation token that cancels the beatmap loading process.</param>
+        /// <param name="cancellationToken">Cancellation token that cancels the beatmap loading process. If not provided, a default timeout of 10,000ms will be applied to the load process.</param>
         /// <returns>The converted <see cref="IBeatmap"/>.</returns>
         /// <exception cref="BeatmapInvalidForRulesetException">If <see cref="Beatmap"/> could not be converted to <paramref name="ruleset"/>.</exception>
-        IBeatmap GetPlayableBeatmap(RulesetInfo ruleset, IReadOnlyList<Mod> mods = null, CancellationToken cancellationToken = default);
+        IBeatmap GetPlayableBeatmap(RulesetInfo ruleset, IReadOnlyList<Mod> mods = null, CancellationToken? cancellationToken = null);
 
         /// <summary>
         /// Load a new audio track instance for this beatmap. This should be called once before accessing <see cref="Track"/>.
diff --git a/osu.Game/Beatmaps/WorkingBeatmap.cs b/osu.Game/Beatmaps/WorkingBeatmap.cs
index 9be239e3b0..a04345ec5c 100644
--- a/osu.Game/Beatmaps/WorkingBeatmap.cs
+++ b/osu.Game/Beatmaps/WorkingBeatmap.cs
@@ -78,8 +78,9 @@ namespace osu.Game.Beatmaps
         /// <returns>The applicable <see cref="IBeatmapConverter"/>.</returns>
         protected virtual IBeatmapConverter CreateBeatmapConverter(IBeatmap beatmap, Ruleset ruleset) => ruleset.CreateBeatmapConverter(beatmap);
 
-        public virtual IBeatmap GetPlayableBeatmap(RulesetInfo ruleset, IReadOnlyList<Mod> mods = null, CancellationToken cancellationToken = default)
+        public virtual IBeatmap GetPlayableBeatmap(RulesetInfo ruleset, IReadOnlyList<Mod> mods = null, CancellationToken? cancellationToken = null)
         {
+            var token = cancellationToken ?? new CancellationTokenSource(10000).Token;
             mods ??= Array.Empty<Mod>();
 
             var rulesetInstance = ruleset.CreateInstance();
@@ -96,19 +97,19 @@ namespace osu.Game.Beatmaps
             // Apply conversion mods
             foreach (var mod in mods.OfType<IApplicableToBeatmapConverter>())
             {
-                if (cancellationToken.IsCancellationRequested)
+                if (token.IsCancellationRequested)
                     throw new BeatmapLoadTimeoutException(BeatmapInfo);
 
                 mod.ApplyToBeatmapConverter(converter);
             }
 
             // Convert
-            IBeatmap converted = converter.Convert(cancellationToken);
+            IBeatmap converted = converter.Convert(token);
 
             // Apply conversion mods to the result
             foreach (var mod in mods.OfType<IApplicableAfterBeatmapConversion>())
             {
-                if (cancellationToken.IsCancellationRequested)
+                if (token.IsCancellationRequested)
                     throw new BeatmapLoadTimeoutException(BeatmapInfo);
 
                 mod.ApplyToBeatmap(converted);
@@ -119,7 +120,7 @@ namespace osu.Game.Beatmaps
             {
                 foreach (var mod in mods.OfType<IApplicableToDifficulty>())
                 {
-                    if (cancellationToken.IsCancellationRequested)
+                    if (token.IsCancellationRequested)
                         throw new BeatmapLoadTimeoutException(BeatmapInfo);
 
                     mod.ApplyToDifficulty(converted.Difficulty);
@@ -138,10 +139,10 @@ namespace osu.Game.Beatmaps
             {
                 foreach (var obj in converted.HitObjects)
                 {
-                    if (cancellationToken.IsCancellationRequested)
+                    if (token.IsCancellationRequested)
                         throw new BeatmapLoadTimeoutException(BeatmapInfo);
 
-                    obj.ApplyDefaults(converted.ControlPointInfo, converted.Difficulty, cancellationToken);
+                    obj.ApplyDefaults(converted.ControlPointInfo, converted.Difficulty, token);
                 }
             }
             catch (OperationCanceledException)
@@ -153,7 +154,7 @@ namespace osu.Game.Beatmaps
             {
                 foreach (var obj in converted.HitObjects)
                 {
-                    if (cancellationToken.IsCancellationRequested)
+                    if (token.IsCancellationRequested)
                         throw new BeatmapLoadTimeoutException(BeatmapInfo);
 
                     mod.ApplyToHitObject(obj);
@@ -164,7 +165,7 @@ namespace osu.Game.Beatmaps
 
             foreach (var mod in mods.OfType<IApplicableToBeatmap>())
             {
-                cancellationToken.ThrowIfCancellationRequested();
+                token.ThrowIfCancellationRequested();
                 mod.ApplyToBeatmap(converted);
             }
 
diff --git a/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs b/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs
index 6e679279a4..2f46682b1a 100644
--- a/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs
+++ b/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs
@@ -216,7 +216,7 @@ namespace osu.Game.Screens.Play.HUD
                 this.gameplayBeatmap = gameplayBeatmap;
             }
 
-            public override IBeatmap GetPlayableBeatmap(RulesetInfo ruleset, IReadOnlyList<Mod> mods = null, CancellationToken cancellationToken = default)
+            public override IBeatmap GetPlayableBeatmap(RulesetInfo ruleset, IReadOnlyList<Mod> mods = null, CancellationToken? cancellationToken = null)
                 => gameplayBeatmap;
 
             protected override IBeatmap GetBeatmap() => gameplayBeatmap;

From 4d11794d31d0822e0738f49d5adb09492843a021 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 17 Nov 2021 11:06:43 +0900
Subject: [PATCH 1064/5547] Add test coverage of `GetPlayableBeatmap` timeout
 and cancellation

---
 osu.Game.Tests/Beatmaps/WorkingBeatmapTest.cs | 102 ++++++++++++++++++
 1 file changed, 102 insertions(+)
 create mode 100644 osu.Game.Tests/Beatmaps/WorkingBeatmapTest.cs

diff --git a/osu.Game.Tests/Beatmaps/WorkingBeatmapTest.cs b/osu.Game.Tests/Beatmaps/WorkingBeatmapTest.cs
new file mode 100644
index 0000000000..02e4a87a7a
--- /dev/null
+++ b/osu.Game.Tests/Beatmaps/WorkingBeatmapTest.cs
@@ -0,0 +1,102 @@
+// 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.Threading;
+using System.Threading.Tasks;
+using NUnit.Framework;
+using osu.Game.Beatmaps;
+using osu.Game.Rulesets;
+using osu.Game.Rulesets.Objects;
+using osu.Game.Rulesets.Osu;
+using osu.Game.Rulesets.Osu.Beatmaps;
+
+namespace osu.Game.Tests.Beatmaps
+{
+    [TestFixture]
+    public class WorkingBeatmapTest
+    {
+        [Test]
+        public void TestGetPlayableSuccess()
+        {
+            var working = new TestNeverLoadsWorkingBeatmap();
+
+            working.ResetEvent.Set();
+
+            Assert.NotNull(working.GetPlayableBeatmap(new OsuRuleset().RulesetInfo));
+        }
+
+        [Test]
+        public void TestGetPlayableCancellationToken()
+        {
+            var working = new TestNeverLoadsWorkingBeatmap();
+
+            var cts = new CancellationTokenSource();
+            var loadStarted = new ManualResetEventSlim();
+            var loadCompleted = new ManualResetEventSlim();
+
+            Task.Factory.StartNew(() =>
+            {
+                loadStarted.Set();
+                Assert.Throws<OperationCanceledException>(() => working.GetPlayableBeatmap(new OsuRuleset().RulesetInfo, cancellationToken: cts.Token));
+                loadCompleted.Set();
+            }, TaskCreationOptions.LongRunning);
+
+            Assert.IsTrue(loadStarted.Wait(10000));
+
+            cts.Cancel();
+
+            Assert.IsTrue(loadCompleted.Wait(10000));
+
+            working.ResetEvent.Set();
+        }
+
+        [Test]
+        public void TestGetPlayableDefaultTimeout()
+        {
+            var working = new TestNeverLoadsWorkingBeatmap();
+
+            Assert.Throws<OperationCanceledException>(() => working.GetPlayableBeatmap(new OsuRuleset().RulesetInfo));
+
+            working.ResetEvent.Set();
+        }
+
+        public class TestNeverLoadsWorkingBeatmap : TestWorkingBeatmap
+        {
+            public ManualResetEventSlim ResetEvent = new ManualResetEventSlim();
+
+            public TestNeverLoadsWorkingBeatmap()
+                : base(new Beatmap())
+            {
+            }
+
+            protected override IBeatmapConverter CreateBeatmapConverter(IBeatmap beatmap, Ruleset ruleset) => new TestConverter(beatmap, ResetEvent);
+
+            public class TestConverter : IBeatmapConverter
+            {
+                private readonly ManualResetEventSlim resetEvent;
+
+                public TestConverter(IBeatmap beatmap, ManualResetEventSlim resetEvent)
+                {
+                    this.resetEvent = resetEvent;
+                    Beatmap = beatmap;
+                }
+
+                public event Action<HitObject, IEnumerable<HitObject>> ObjectConverted;
+
+                protected virtual void OnObjectConverted(HitObject arg1, IEnumerable<HitObject> arg2) => ObjectConverted?.Invoke(arg1, arg2);
+
+                public IBeatmap Beatmap { get; }
+
+                public bool CanConvert() => true;
+
+                public IBeatmap Convert(CancellationToken cancellationToken = default)
+                {
+                    resetEvent.Wait(cancellationToken);
+                    return new OsuBeatmap();
+                }
+            }
+        }
+    }
+}

From 8e9b55ef6dbd061666e75b4b1228eeaa43d93bd8 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 17 Nov 2021 11:28:43 +0900
Subject: [PATCH 1065/5547] Disallow selection of invalid items

---
 .../OnlinePlay/DrawableRoomPlaylistItem.cs    | 19 ++++++++++++++++++-
 1 file changed, 18 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
index 2fa1a79ddd..96ff44fab5 100644
--- a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
+++ b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
@@ -90,7 +90,24 @@ namespace osu.Game.Screens.OnlinePlay
         {
             base.LoadComplete();
 
-            SelectedItem.BindValueChanged(selected => maskingContainer.BorderThickness = selected.NewValue == Model ? 5 : 0, true);
+            SelectedItem.BindValueChanged(selected =>
+            {
+                bool isCurrent = selected.NewValue == Model;
+
+                if (!valid.Value)
+                {
+                    // Don't allow selection when not valid.
+                    if (isCurrent)
+                    {
+                        SelectedItem.Value = selected.OldValue;
+                    }
+
+                    // Don't update border when not valid (the border is displaying this fact).
+                    return;
+                }
+
+                maskingContainer.BorderThickness = isCurrent ? 5 : 0;
+            }, true);
 
             beatmap.BindValueChanged(_ => Scheduler.AddOnce(refresh));
             ruleset.BindValueChanged(_ => Scheduler.AddOnce(refresh));

From f5b95c9e6d73b8819ca80793a433ecb4d1548085 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 17 Nov 2021 11:30:47 +0900
Subject: [PATCH 1066/5547] Add ModUtils helper to instantiate mods from
 ruleset

---
 osu.Game/Utils/ModUtils.cs | 29 +++++++++++++++++++++++++++++
 1 file changed, 29 insertions(+)

diff --git a/osu.Game/Utils/ModUtils.cs b/osu.Game/Utils/ModUtils.cs
index 7485950f47..eb5deef6ea 100644
--- a/osu.Game/Utils/ModUtils.cs
+++ b/osu.Game/Utils/ModUtils.cs
@@ -8,6 +8,7 @@ using System.Diagnostics.CodeAnalysis;
 using System.Linq;
 using osu.Framework.Bindables;
 using osu.Game.Online.API;
+using osu.Game.Rulesets;
 using osu.Game.Rulesets.Mods;
 
 #nullable enable
@@ -185,5 +186,33 @@ namespace osu.Game.Utils
                     return setting;
             }
         }
+
+        /// <summary>
+        /// Verifies all proposed mods are valid for a given ruleset and returns instantiated <see cref="Mod"/>s for further processing.
+        /// </summary>
+        /// <param name="ruleset">The ruleset to verify mods against.</param>
+        /// <param name="proposedMods">The proposed mods.</param>
+        /// <param name="valid">Mods instantiated from <paramref name="proposedMods"/> which were valid for the given <paramref name="ruleset"/>.</param>
+        /// <returns>Whether all <see cref="proposedMods"/> were valid for the given <paramref name="ruleset"/>.</returns>
+        public static bool InstantiateValidModsForRuleset(Ruleset ruleset, IEnumerable<APIMod> proposedMods, out List<Mod> valid)
+        {
+            valid = new List<Mod>();
+            bool proposedWereValid = true;
+
+            foreach (var apiMod in proposedMods)
+            {
+                try
+                {
+                    // will throw if invalid
+                    valid.Add(apiMod.ToMod(ruleset));
+                }
+                catch
+                {
+                    proposedWereValid = false;
+                }
+            }
+
+            return proposedWereValid;
+        }
     }
 }

From d600a7327704dea2bd70a7e2f181c3ecacc8fbf3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 17 Nov 2021 11:38:41 +0900
Subject: [PATCH 1067/5547] Disable cancelling of update via notification

---
 osu.Desktop/Updater/SquirrelUpdateManager.cs | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/osu.Desktop/Updater/SquirrelUpdateManager.cs b/osu.Desktop/Updater/SquirrelUpdateManager.cs
index 910751a723..d48c9e9661 100644
--- a/osu.Desktop/Updater/SquirrelUpdateManager.cs
+++ b/osu.Desktop/Updater/SquirrelUpdateManager.cs
@@ -183,6 +183,19 @@ namespace osu.Desktop.Updater
                     }
                 });
             }
+
+            public override void Close()
+            {
+                // cancelling updates is not currently supported by the underlying updater.
+                // only allow dismissing for now.
+
+                switch (State)
+                {
+                    case ProgressNotificationState.Cancelled:
+                        base.Close();
+                        break;
+                }
+            }
         }
 
         private class SquirrelLogger : Splat.ILogger, IDisposable

From 97bc67245d8e4643b8144809454085ac74f170c5 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 17 Nov 2021 11:46:06 +0900
Subject: [PATCH 1068/5547] Fix xmldoc reference

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

diff --git a/osu.Game/Utils/ModUtils.cs b/osu.Game/Utils/ModUtils.cs
index eb5deef6ea..cdca277dd8 100644
--- a/osu.Game/Utils/ModUtils.cs
+++ b/osu.Game/Utils/ModUtils.cs
@@ -193,7 +193,7 @@ namespace osu.Game.Utils
         /// <param name="ruleset">The ruleset to verify mods against.</param>
         /// <param name="proposedMods">The proposed mods.</param>
         /// <param name="valid">Mods instantiated from <paramref name="proposedMods"/> which were valid for the given <paramref name="ruleset"/>.</param>
-        /// <returns>Whether all <see cref="proposedMods"/> were valid for the given <paramref name="ruleset"/>.</returns>
+        /// <returns>Whether all <paramref name="proposedMods"/> were valid for the given <paramref name="ruleset"/>.</returns>
         public static bool InstantiateValidModsForRuleset(Ruleset ruleset, IEnumerable<APIMod> proposedMods, out List<Mod> valid)
         {
             valid = new List<Mod>();

From 96e983bbad1cdd70108eb9a37c4a9a205606c6a8 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 17 Nov 2021 14:40:05 +0900
Subject: [PATCH 1069/5547] Disallow playlist item selection at playlist room
 creation screen

Wasn't being used for anything, confusing that it's even possible.
---
 .../OnlinePlay/Playlists/PlaylistsRoomSettingsOverlay.cs        | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSettingsOverlay.cs b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSettingsOverlay.cs
index cb4a81f108..7d96e5303c 100644
--- a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSettingsOverlay.cs
+++ b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSettingsOverlay.cs
@@ -205,7 +205,7 @@ namespace osu.Game.Screens.OnlinePlay.Playlists
                                                                 {
                                                                     new Drawable[]
                                                                     {
-                                                                        playlist = new DrawableRoomPlaylist(true, true) { RelativeSizeAxes = Axes.Both }
+                                                                        playlist = new DrawableRoomPlaylist(true, false) { RelativeSizeAxes = Axes.Both }
                                                                     },
                                                                     new Drawable[]
                                                                     {

From 08f129b4c885c2e98402b7445e4b1b8094717e42 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 17 Nov 2021 20:09:30 +0900
Subject: [PATCH 1070/5547] Expose LegacyScoreDecoder.CalculateAccuracy()

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

diff --git a/osu.Game/Scoring/Legacy/LegacyScoreDecoder.cs b/osu.Game/Scoring/Legacy/LegacyScoreDecoder.cs
index 7bfe0308f7..100ef121a8 100644
--- a/osu.Game/Scoring/Legacy/LegacyScoreDecoder.cs
+++ b/osu.Game/Scoring/Legacy/LegacyScoreDecoder.cs
@@ -124,7 +124,7 @@ namespace osu.Game.Scoring.Legacy
             return score;
         }
 
-        protected void CalculateAccuracy(ScoreInfo score)
+        public static void CalculateAccuracy(ScoreInfo score)
         {
             int countMiss = score.GetCountMiss() ?? 0;
             int count50 = score.GetCount50() ?? 0;

From abb333299bcddd0ecb5f2b4fe1aed1073f118063 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 17 Nov 2021 20:20:54 +0900
Subject: [PATCH 1071/5547] Document base class

---
 .../Difficulty/DifficultyAttributes.cs        | 34 +++++++++++++++++++
 1 file changed, 34 insertions(+)

diff --git a/osu.Game/Rulesets/Difficulty/DifficultyAttributes.cs b/osu.Game/Rulesets/Difficulty/DifficultyAttributes.cs
index cc9d111aa2..1073f689dd 100644
--- a/osu.Game/Rulesets/Difficulty/DifficultyAttributes.cs
+++ b/osu.Game/Rulesets/Difficulty/DifficultyAttributes.cs
@@ -9,23 +9,47 @@ using osu.Game.Rulesets.Mods;
 
 namespace osu.Game.Rulesets.Difficulty
 {
+    /// <summary>
+    /// Describes the difficulty of a beatmap, as output by a <see cref="DifficultyCalculator"/>.
+    /// </summary>
     [JsonObject(MemberSerialization.OptIn)]
     public class DifficultyAttributes
     {
+        /// <summary>
+        /// The mods which were applied to the beatmap.
+        /// </summary>
         public Mod[] Mods { get; set; }
 
+        /// <summary>
+        /// The skills resulting from the difficulty calculation.
+        /// </summary>
         public Skill[] Skills { get; set; }
 
+        /// <summary>
+        /// The combined star rating of all skill.
+        /// </summary>
         [JsonProperty("star_rating", Order = -3)]
         public double StarRating { get; set; }
 
+        /// <summary>
+        /// The maximum achievable combo.
+        /// </summary>
         [JsonProperty("max_combo", Order = -2)]
         public int MaxCombo { get; set; }
 
+        /// <summary>
+        /// Creates new <see cref="DifficultyAttributes"/>.
+        /// </summary>
         public DifficultyAttributes()
         {
         }
 
+        /// <summary>
+        /// Creates new <see cref="DifficultyAttributes"/>.
+        /// </summary>
+        /// <param name="mods">The mods which were applied to the beatmap.</param>
+        /// <param name="skills">The skills resulting from the difficulty calculation.</param>
+        /// <param name="starRating">The combined star rating of all skills.</param>
         public DifficultyAttributes(Mod[] mods, Skill[] skills, double starRating)
         {
             Mods = mods;
@@ -33,8 +57,18 @@ namespace osu.Game.Rulesets.Difficulty
             StarRating = starRating;
         }
 
+        /// <summary>
+        /// Converts this <see cref="DifficultyAttributes"/> to osu-web compatible database attribute mappings.
+        /// </summary>
+        /// <remarks>
+        /// See: osu_difficulty_attribs table.
+        /// </remarks>
         public virtual IEnumerable<(int attributeId, object value)> ToDatabaseAttributes() => Enumerable.Empty<(int, object)>();
 
+        /// <summary>
+        /// Reads osu-web database attribute mappings into this <see cref="DifficultyAttributes"/> object.
+        /// </summary>
+        /// <param name="values">The attribute mappings.</param>
         public virtual void FromDatabaseAttributes(IReadOnlyDictionary<int, double> values)
         {
         }

From 2ae46f901e7785adeb064f1a73733787e679c2cf Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 17 Nov 2021 20:22:43 +0900
Subject: [PATCH 1072/5547] Add comment for implicitly-used method

---
 osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyAttributes.cs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyAttributes.cs b/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyAttributes.cs
index 7673d08440..14a5a3e745 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyAttributes.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyAttributes.cs
@@ -70,6 +70,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty
             SliderFactor = values[19];
         }
 
+        // Used implicitly by Newtonsoft.Json to not serialize flashlight property in some cases.
         [UsedImplicitly]
         public bool ShouldSerializeFlashlightRating() => Mods.OfType<ModFlashlight>().Any();
     }

From 43cbb23b159ad9a3887cdcb63ae1f80a5e7c5695 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 17 Nov 2021 20:23:08 +0900
Subject: [PATCH 1073/5547] Use ShouldSerializeFlashlightRating() to serialise
 database attribute

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

diff --git a/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyAttributes.cs b/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyAttributes.cs
index 14a5a3e745..a22b605176 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyAttributes.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyAttributes.cs
@@ -50,7 +50,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty
             yield return (9, MaxCombo);
             yield return (11, StarRating);
 
-            if (Mods.Any(m => m is ModFlashlight))
+            if (ShouldSerializeFlashlightRating())
                 yield return (17, FlashlightRating);
 
             yield return (19, SliderFactor);
@@ -72,6 +72,6 @@ namespace osu.Game.Rulesets.Osu.Difficulty
 
         // Used implicitly by Newtonsoft.Json to not serialize flashlight property in some cases.
         [UsedImplicitly]
-        public bool ShouldSerializeFlashlightRating() => Mods.OfType<ModFlashlight>().Any();
+        public bool ShouldSerializeFlashlightRating() => Mods.Any(m => m is ModFlashlight);
     }
 }

From 815179f713dd2d1f7b636ebdd0bf387d821fbd35 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 17 Nov 2021 20:31:18 +0900
Subject: [PATCH 1074/5547] Use consts for attribute IDs

---
 .../Difficulty/CatchDifficultyAttributes.cs   | 14 ++++----
 .../Difficulty/ManiaDifficultyAttributes.cs   | 14 ++++----
 .../Difficulty/OsuDifficultyAttributes.cs     | 32 +++++++++----------
 .../Difficulty/TaikoDifficultyAttributes.cs   | 12 +++----
 .../Difficulty/DifficultyAttributes.cs        | 11 +++++++
 5 files changed, 47 insertions(+), 36 deletions(-)

diff --git a/osu.Game.Rulesets.Catch/Difficulty/CatchDifficultyAttributes.cs b/osu.Game.Rulesets.Catch/Difficulty/CatchDifficultyAttributes.cs
index ca63e87f8d..39a58d336d 100644
--- a/osu.Game.Rulesets.Catch/Difficulty/CatchDifficultyAttributes.cs
+++ b/osu.Game.Rulesets.Catch/Difficulty/CatchDifficultyAttributes.cs
@@ -17,19 +17,19 @@ namespace osu.Game.Rulesets.Catch.Difficulty
             foreach (var v in base.ToDatabaseAttributes())
                 yield return v;
 
-            // Todo: Catch should not output star rating in the 'aim' attribute.
-            yield return (1, StarRating);
-            yield return (7, ApproachRate);
-            yield return (9, MaxCombo);
+            // Todo: osu!catch should not output star rating in the 'aim' attribute.
+            yield return (ATTRIB_ID_AIM, StarRating);
+            yield return (ATTRIB_ID_APPROACH_RATE, ApproachRate);
+            yield return (ATTRIB_ID_MAX_COMBO, MaxCombo);
         }
 
         public override void FromDatabaseAttributes(IReadOnlyDictionary<int, double> values)
         {
             base.FromDatabaseAttributes(values);
 
-            StarRating = values[1];
-            ApproachRate = values[7];
-            MaxCombo = (int)values[9];
+            StarRating = values[ATTRIB_ID_AIM];
+            ApproachRate = values[ATTRIB_ID_APPROACH_RATE];
+            MaxCombo = (int)values[ATTRIB_ID_MAX_COMBO];
         }
     }
 }
diff --git a/osu.Game.Rulesets.Mania/Difficulty/ManiaDifficultyAttributes.cs b/osu.Game.Rulesets.Mania/Difficulty/ManiaDifficultyAttributes.cs
index 1e663fe103..bfdef893e9 100644
--- a/osu.Game.Rulesets.Mania/Difficulty/ManiaDifficultyAttributes.cs
+++ b/osu.Game.Rulesets.Mania/Difficulty/ManiaDifficultyAttributes.cs
@@ -20,19 +20,19 @@ namespace osu.Game.Rulesets.Mania.Difficulty
             foreach (var v in base.ToDatabaseAttributes())
                 yield return v;
 
-            // Todo: Mania doesn't output MaxCombo attribute for some reason.
-            yield return (11, StarRating);
-            yield return (13, GreatHitWindow);
-            yield return (15, ScoreMultiplier);
+            // Todo: osu!mania doesn't output MaxCombo attribute for some reason.
+            yield return (ATTRIB_ID_STRAIN, StarRating);
+            yield return (ATTRIB_ID_GREAT_HIT_WINDOW, GreatHitWindow);
+            yield return (ATTRIB_ID_SCORE_MULTIPLIER, ScoreMultiplier);
         }
 
         public override void FromDatabaseAttributes(IReadOnlyDictionary<int, double> values)
         {
             base.FromDatabaseAttributes(values);
 
-            StarRating = values[11];
-            GreatHitWindow = values[13];
-            ScoreMultiplier = values[15];
+            StarRating = values[ATTRIB_ID_STRAIN];
+            GreatHitWindow = values[ATTRIB_ID_GREAT_HIT_WINDOW];
+            ScoreMultiplier = values[ATTRIB_ID_SCORE_MULTIPLIER];
         }
     }
 }
diff --git a/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyAttributes.cs b/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyAttributes.cs
index a22b605176..4b2e54da17 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyAttributes.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyAttributes.cs
@@ -43,31 +43,31 @@ namespace osu.Game.Rulesets.Osu.Difficulty
             foreach (var v in base.ToDatabaseAttributes())
                 yield return v;
 
-            yield return (1, AimStrain);
-            yield return (3, SpeedStrain);
-            yield return (5, OverallDifficulty);
-            yield return (7, ApproachRate);
-            yield return (9, MaxCombo);
-            yield return (11, StarRating);
+            yield return (ATTRIB_ID_AIM, AimStrain);
+            yield return (ATTRIB_ID_SPEED, SpeedStrain);
+            yield return (ATTRIB_ID_OVERALL_DIFFICULTY, OverallDifficulty);
+            yield return (ATTRIB_ID_APPROACH_RATE, ApproachRate);
+            yield return (ATTRIB_ID_MAX_COMBO, MaxCombo);
+            yield return (ATTRIB_ID_STRAIN, StarRating);
 
             if (ShouldSerializeFlashlightRating())
-                yield return (17, FlashlightRating);
+                yield return (ATTRIB_ID_FLASHLIGHT, FlashlightRating);
 
-            yield return (19, SliderFactor);
+            yield return (ATTRIB_ID_SLIDER_FACTOR, SliderFactor);
         }
 
         public override void FromDatabaseAttributes(IReadOnlyDictionary<int, double> values)
         {
             base.FromDatabaseAttributes(values);
 
-            AimStrain = values[1];
-            SpeedStrain = values[3];
-            OverallDifficulty = values[5];
-            ApproachRate = values[7];
-            MaxCombo = (int)values[9];
-            StarRating = values[11];
-            FlashlightRating = values.GetValueOrDefault(17);
-            SliderFactor = values[19];
+            AimStrain = values[ATTRIB_ID_AIM];
+            SpeedStrain = values[ATTRIB_ID_SPEED];
+            OverallDifficulty = values[ATTRIB_ID_OVERALL_DIFFICULTY];
+            ApproachRate = values[ATTRIB_ID_APPROACH_RATE];
+            MaxCombo = (int)values[ATTRIB_ID_MAX_COMBO];
+            StarRating = values[ATTRIB_ID_STRAIN];
+            FlashlightRating = values.GetValueOrDefault(ATTRIB_ID_FLASHLIGHT);
+            SliderFactor = values[ATTRIB_ID_SLIDER_FACTOR];
         }
 
         // Used implicitly by Newtonsoft.Json to not serialize flashlight property in some cases.
diff --git a/osu.Game.Rulesets.Taiko/Difficulty/TaikoDifficultyAttributes.cs b/osu.Game.Rulesets.Taiko/Difficulty/TaikoDifficultyAttributes.cs
index a6057d7952..b2b5d056c3 100644
--- a/osu.Game.Rulesets.Taiko/Difficulty/TaikoDifficultyAttributes.cs
+++ b/osu.Game.Rulesets.Taiko/Difficulty/TaikoDifficultyAttributes.cs
@@ -29,18 +29,18 @@ namespace osu.Game.Rulesets.Taiko.Difficulty
             foreach (var v in base.ToDatabaseAttributes())
                 yield return v;
 
-            yield return (9, MaxCombo);
-            yield return (11, StarRating);
-            yield return (13, GreatHitWindow);
+            yield return (ATTRIB_ID_MAX_COMBO, MaxCombo);
+            yield return (ATTRIB_ID_STRAIN, StarRating);
+            yield return (ATTRIB_ID_GREAT_HIT_WINDOW, GreatHitWindow);
         }
 
         public override void FromDatabaseAttributes(IReadOnlyDictionary<int, double> values)
         {
             base.FromDatabaseAttributes(values);
 
-            MaxCombo = (int)values[9];
-            StarRating = values[11];
-            GreatHitWindow = values[13];
+            MaxCombo = (int)values[ATTRIB_ID_MAX_COMBO];
+            StarRating = values[ATTRIB_ID_STRAIN];
+            GreatHitWindow = values[ATTRIB_ID_GREAT_HIT_WINDOW];
         }
     }
 }
diff --git a/osu.Game/Rulesets/Difficulty/DifficultyAttributes.cs b/osu.Game/Rulesets/Difficulty/DifficultyAttributes.cs
index 1073f689dd..320321440a 100644
--- a/osu.Game/Rulesets/Difficulty/DifficultyAttributes.cs
+++ b/osu.Game/Rulesets/Difficulty/DifficultyAttributes.cs
@@ -72,5 +72,16 @@ namespace osu.Game.Rulesets.Difficulty
         public virtual void FromDatabaseAttributes(IReadOnlyDictionary<int, double> values)
         {
         }
+
+        protected const int ATTRIB_ID_AIM = 1;
+        protected const int ATTRIB_ID_SPEED = 3;
+        protected const int ATTRIB_ID_OVERALL_DIFFICULTY = 5;
+        protected const int ATTRIB_ID_APPROACH_RATE = 7;
+        protected const int ATTRIB_ID_MAX_COMBO = 9;
+        protected const int ATTRIB_ID_STRAIN = 11;
+        protected const int ATTRIB_ID_GREAT_HIT_WINDOW = 13;
+        protected const int ATTRIB_ID_SCORE_MULTIPLIER = 15;
+        protected const int ATTRIB_ID_FLASHLIGHT = 17;
+        protected const int ATTRIB_ID_SLIDER_FACTOR = 19;
     }
 }

From 9182eab48651f4ec41eeb8dc214f4bb11858e782 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 17 Nov 2021 20:45:48 +0900
Subject: [PATCH 1075/5547] Rename method + xmldoc

---
 osu.Game/Scoring/Legacy/LegacyScoreDecoder.cs | 11 +++++++++--
 1 file changed, 9 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Scoring/Legacy/LegacyScoreDecoder.cs b/osu.Game/Scoring/Legacy/LegacyScoreDecoder.cs
index 100ef121a8..7ac4f90c07 100644
--- a/osu.Game/Scoring/Legacy/LegacyScoreDecoder.cs
+++ b/osu.Game/Scoring/Legacy/LegacyScoreDecoder.cs
@@ -115,7 +115,7 @@ namespace osu.Game.Scoring.Legacy
                 }
             }
 
-            CalculateAccuracy(score.ScoreInfo);
+            PopulateAccuracy(score.ScoreInfo);
 
             // 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.
@@ -124,7 +124,14 @@ namespace osu.Game.Scoring.Legacy
             return score;
         }
 
-        public static void CalculateAccuracy(ScoreInfo score)
+        /// <summary>
+        /// Populates the accuracy of a given <see cref="ScoreInfo"/> from its contained statistics.
+        /// </summary>
+        /// <remarks>
+        /// Legacy use only.
+        /// </remarks>
+        /// <param name="score">The <see cref="ScoreInfo"/> to populate.</param>
+        public static void PopulateAccuracy(ScoreInfo score)
         {
             int countMiss = score.GetCountMiss() ?? 0;
             int count50 = score.GetCount50() ?? 0;

From 0a7498014fa7125929e93cab6f1682771ec58a32 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 17 Nov 2021 20:47:52 +0900
Subject: [PATCH 1076/5547] Move `const`s to top of file

---
 .../Difficulty/DifficultyAttributes.cs        | 22 +++++++++----------
 1 file changed, 11 insertions(+), 11 deletions(-)

diff --git a/osu.Game/Rulesets/Difficulty/DifficultyAttributes.cs b/osu.Game/Rulesets/Difficulty/DifficultyAttributes.cs
index 320321440a..e0d27799ce 100644
--- a/osu.Game/Rulesets/Difficulty/DifficultyAttributes.cs
+++ b/osu.Game/Rulesets/Difficulty/DifficultyAttributes.cs
@@ -15,6 +15,17 @@ namespace osu.Game.Rulesets.Difficulty
     [JsonObject(MemberSerialization.OptIn)]
     public class DifficultyAttributes
     {
+        protected const int ATTRIB_ID_AIM = 1;
+        protected const int ATTRIB_ID_SPEED = 3;
+        protected const int ATTRIB_ID_OVERALL_DIFFICULTY = 5;
+        protected const int ATTRIB_ID_APPROACH_RATE = 7;
+        protected const int ATTRIB_ID_MAX_COMBO = 9;
+        protected const int ATTRIB_ID_STRAIN = 11;
+        protected const int ATTRIB_ID_GREAT_HIT_WINDOW = 13;
+        protected const int ATTRIB_ID_SCORE_MULTIPLIER = 15;
+        protected const int ATTRIB_ID_FLASHLIGHT = 17;
+        protected const int ATTRIB_ID_SLIDER_FACTOR = 19;
+
         /// <summary>
         /// The mods which were applied to the beatmap.
         /// </summary>
@@ -72,16 +83,5 @@ namespace osu.Game.Rulesets.Difficulty
         public virtual void FromDatabaseAttributes(IReadOnlyDictionary<int, double> values)
         {
         }
-
-        protected const int ATTRIB_ID_AIM = 1;
-        protected const int ATTRIB_ID_SPEED = 3;
-        protected const int ATTRIB_ID_OVERALL_DIFFICULTY = 5;
-        protected const int ATTRIB_ID_APPROACH_RATE = 7;
-        protected const int ATTRIB_ID_MAX_COMBO = 9;
-        protected const int ATTRIB_ID_STRAIN = 11;
-        protected const int ATTRIB_ID_GREAT_HIT_WINDOW = 13;
-        protected const int ATTRIB_ID_SCORE_MULTIPLIER = 15;
-        protected const int ATTRIB_ID_FLASHLIGHT = 17;
-        protected const int ATTRIB_ID_SLIDER_FACTOR = 19;
     }
 }

From 7c2e79f911b1d09d9c0a022cdf3c4b59cb770367 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 15 Nov 2021 18:46:11 +0900
Subject: [PATCH 1077/5547] Update all simple cases of switching to
 `IWorkingBeatmap`

---
 .../TestSceneDrawableHitObjects.cs            |  2 +-
 .../DrawableTaikoRulesetTestScene.cs          |  2 +-
 .../Skins/TestSceneBeatmapSkinResources.cs    |  2 +-
 .../Editing/TestSceneHitObjectComposer.cs     |  4 ++--
 .../Visual/Editing/TestSceneWaveform.cs       |  2 +-
 .../Visual/Gameplay/TestScenePlayerLoader.cs  |  5 ++--
 .../TestScenePlayerReferenceLeaking.cs        |  2 +-
 .../Visual/Gameplay/TestSceneStoryboard.cs    |  2 +-
 .../Menus/TestSceneMusicActionHandling.cs     |  4 ++--
 .../Navigation/TestScenePresentBeatmap.cs     |  3 ++-
 .../Navigation/TestSceneScreenNavigation.cs   |  4 ++--
 .../TestSceneBeatmapMetadataDisplay.cs        |  2 +-
 .../SongSelect/TestScenePlaySongSelect.cs     | 23 ++++++++++---------
 osu.Game/Beatmaps/BeatmapDifficultyCache.cs   |  2 +-
 osu.Game/Beatmaps/BeatmapManager.cs           |  2 +-
 .../Drawables/BeatmapBackgroundSprite.cs      |  4 ++--
 osu.Game/Online/Chat/NowPlayingCommand.cs     |  4 ++--
 .../Screens/Play/BeatmapMetadataDisplay.cs    |  4 ++--
 osu.Game/Screens/Play/Player.cs               |  4 ++--
 .../Select/BeatmapInfoWedgeBackground.cs      |  4 ++--
 .../Select/Carousel/SetPanelBackground.cs     |  2 +-
 osu.Game/Screens/Select/SongSelect.cs         |  2 +-
 osu.Game/Storyboards/Storyboard.cs            |  2 +-
 osu.Game/Users/UserActivity.cs                | 14 +++++------
 24 files changed, 52 insertions(+), 49 deletions(-)

diff --git a/osu.Game.Rulesets.Catch.Tests/TestSceneDrawableHitObjects.cs b/osu.Game.Rulesets.Catch.Tests/TestSceneDrawableHitObjects.cs
index 3c61eb19e5..459b8e1f6f 100644
--- a/osu.Game.Rulesets.Catch.Tests/TestSceneDrawableHitObjects.cs
+++ b/osu.Game.Rulesets.Catch.Tests/TestSceneDrawableHitObjects.cs
@@ -30,7 +30,7 @@ namespace osu.Game.Rulesets.Catch.Tests
             var controlPointInfo = new ControlPointInfo();
             controlPointInfo.Add(0, new TimingControlPoint());
 
-            WorkingBeatmap beatmap = CreateWorkingBeatmap(new Beatmap
+            IWorkingBeatmap beatmap = CreateWorkingBeatmap(new Beatmap
             {
                 HitObjects = new List<HitObject> { new Fruit() },
                 BeatmapInfo = new BeatmapInfo
diff --git a/osu.Game.Rulesets.Taiko.Tests/DrawableTaikoRulesetTestScene.cs b/osu.Game.Rulesets.Taiko.Tests/DrawableTaikoRulesetTestScene.cs
index 783636a62d..4bdb85ba60 100644
--- a/osu.Game.Rulesets.Taiko.Tests/DrawableTaikoRulesetTestScene.cs
+++ b/osu.Game.Rulesets.Taiko.Tests/DrawableTaikoRulesetTestScene.cs
@@ -27,7 +27,7 @@ namespace osu.Game.Rulesets.Taiko.Tests
             var controlPointInfo = new ControlPointInfo();
             controlPointInfo.Add(0, new TimingControlPoint());
 
-            WorkingBeatmap beatmap = CreateWorkingBeatmap(new Beatmap
+            IWorkingBeatmap beatmap = CreateWorkingBeatmap(new Beatmap
             {
                 HitObjects = new List<HitObject> { new Hit { Type = HitType.Centre } },
                 BeatmapInfo = new BeatmapInfo
diff --git a/osu.Game.Tests/Skins/TestSceneBeatmapSkinResources.cs b/osu.Game.Tests/Skins/TestSceneBeatmapSkinResources.cs
index f03cda1489..1d8b754837 100644
--- a/osu.Game.Tests/Skins/TestSceneBeatmapSkinResources.cs
+++ b/osu.Game.Tests/Skins/TestSceneBeatmapSkinResources.cs
@@ -19,7 +19,7 @@ namespace osu.Game.Tests.Skins
         [Resolved]
         private BeatmapManager beatmaps { get; set; }
 
-        private WorkingBeatmap beatmap;
+        private IWorkingBeatmap beatmap;
 
         [BackgroundDependencyLoader]
         private void load()
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneHitObjectComposer.cs b/osu.Game.Tests/Visual/Editing/TestSceneHitObjectComposer.cs
index c758bd1707..eee0d6672c 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneHitObjectComposer.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneHitObjectComposer.cs
@@ -81,11 +81,11 @@ namespace osu.Game.Tests.Visual.Editing
 
         public class EditorBeatmapContainer : Container
         {
-            private readonly WorkingBeatmap working;
+            private readonly IWorkingBeatmap working;
 
             public EditorBeatmap EditorBeatmap { get; private set; }
 
-            public EditorBeatmapContainer(WorkingBeatmap working)
+            public EditorBeatmapContainer(IWorkingBeatmap working)
             {
                 this.working = working;
 
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneWaveform.cs b/osu.Game.Tests/Visual/Editing/TestSceneWaveform.cs
index c3a5a0e944..eb7e90f0a7 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneWaveform.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneWaveform.cs
@@ -20,7 +20,7 @@ namespace osu.Game.Tests.Visual.Editing
     [TestFixture]
     public class TestSceneWaveform : OsuTestScene
     {
-        private WorkingBeatmap waveformBeatmap;
+        private IWorkingBeatmap waveformBeatmap;
 
         [BackgroundDependencyLoader]
         private void load(AudioManager audio)
diff --git a/osu.Game.Tests/Visual/Gameplay/TestScenePlayerLoader.cs b/osu.Game.Tests/Visual/Gameplay/TestScenePlayerLoader.cs
index ba0ee5ac6e..06eaa726c9 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestScenePlayerLoader.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestScenePlayerLoader.cs
@@ -95,8 +95,9 @@ namespace osu.Game.Tests.Visual.Gameplay
 
         private void prepareBeatmap()
         {
-            Beatmap.Value = CreateWorkingBeatmap(new OsuRuleset().RulesetInfo);
-            Beatmap.Value.BeatmapInfo.EpilepsyWarning = epilepsyWarning;
+            var workingBeatmap = CreateWorkingBeatmap(new OsuRuleset().RulesetInfo);
+            workingBeatmap.BeatmapInfo.EpilepsyWarning = epilepsyWarning;
+            Beatmap.Value = workingBeatmap;
 
             foreach (var mod in SelectedMods.Value.OfType<IApplicableToTrack>())
                 mod.ApplyToTrack(Beatmap.Value.Track);
diff --git a/osu.Game.Tests/Visual/Gameplay/TestScenePlayerReferenceLeaking.cs b/osu.Game.Tests/Visual/Gameplay/TestScenePlayerReferenceLeaking.cs
index 8f767659c6..7c2f1c5bb2 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestScenePlayerReferenceLeaking.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestScenePlayerReferenceLeaking.cs
@@ -12,7 +12,7 @@ namespace osu.Game.Tests.Visual.Gameplay
 {
     public class TestScenePlayerReferenceLeaking : TestSceneAllRulesetPlayers
     {
-        private readonly WeakList<WorkingBeatmap> workingWeakReferences = new WeakList<WorkingBeatmap>();
+        private readonly WeakList<IWorkingBeatmap> workingWeakReferences = new WeakList<IWorkingBeatmap>();
 
         private readonly WeakList<Player> playerWeakReferences = new WeakList<Player>();
 
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboard.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboard.cs
index 5a2b8d22fd..3b6d02c67c 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboard.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboard.cs
@@ -86,7 +86,7 @@ namespace osu.Game.Tests.Visual.Gameplay
             track.Start();
         }
 
-        private void loadStoryboard(WorkingBeatmap working)
+        private void loadStoryboard(IWorkingBeatmap working)
         {
             if (storyboard != null)
                 storyboardContainer.Remove(storyboard);
diff --git a/osu.Game.Tests/Visual/Menus/TestSceneMusicActionHandling.cs b/osu.Game.Tests/Visual/Menus/TestSceneMusicActionHandling.cs
index 79dfe79299..6dda8df6f0 100644
--- a/osu.Game.Tests/Visual/Menus/TestSceneMusicActionHandling.cs
+++ b/osu.Game.Tests/Visual/Menus/TestSceneMusicActionHandling.cs
@@ -31,7 +31,7 @@ namespace osu.Game.Tests.Visual.Menus
         public void TestMusicNavigationActions()
         {
             int importId = 0;
-            Queue<(WorkingBeatmap working, TrackChangeDirection changeDirection)> trackChangeQueue = null;
+            Queue<(IWorkingBeatmap working, TrackChangeDirection changeDirection)> trackChangeQueue = null;
 
             // ensure we have at least two beatmaps available to identify the direction the music controller navigated to.
             AddRepeatStep("import beatmap", () => Game.BeatmapManager.Import(new BeatmapSetInfo
@@ -58,7 +58,7 @@ namespace osu.Game.Tests.Visual.Menus
 
             AddStep("bind to track change", () =>
             {
-                trackChangeQueue = new Queue<(WorkingBeatmap, TrackChangeDirection)>();
+                trackChangeQueue = new Queue<(IWorkingBeatmap, TrackChangeDirection)>();
                 Game.MusicController.TrackChanged += (working, changeDirection) => trackChangeQueue.Enqueue((working, changeDirection));
             });
 
diff --git a/osu.Game.Tests/Visual/Navigation/TestScenePresentBeatmap.cs b/osu.Game.Tests/Visual/Navigation/TestScenePresentBeatmap.cs
index ff976c7bf6..d1ee984682 100644
--- a/osu.Game.Tests/Visual/Navigation/TestScenePresentBeatmap.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestScenePresentBeatmap.cs
@@ -7,6 +7,7 @@ using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Screens;
 using osu.Game.Beatmaps;
+using osu.Game.Extensions;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Mania;
 using osu.Game.Rulesets.Osu;
@@ -139,7 +140,7 @@ namespace osu.Game.Tests.Visual.Navigation
             AddStep("present beatmap", () => Game.PresentBeatmap(getImport()));
 
             AddUntilStep("wait for song select", () => Game.ScreenStack.CurrentScreen is Screens.Select.SongSelect);
-            AddUntilStep("correct beatmap displayed", () => Game.Beatmap.Value.BeatmapSetInfo.ID == getImport().ID);
+            AddUntilStep("correct beatmap displayed", () => Game.Beatmap.Value.BeatmapSetInfo.MatchesOnlineID(getImport()));
             AddAssert("correct ruleset selected", () => Game.Ruleset.Value.ID == getImport().Beatmaps.First().Ruleset.ID);
         }
 
diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs b/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
index 5d4594c415..ef71c54e03 100644
--- a/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
@@ -96,7 +96,7 @@ namespace osu.Game.Tests.Visual.Navigation
             Player player = null;
             ResultsScreen results = null;
 
-            WorkingBeatmap beatmap() => Game.Beatmap.Value;
+            IWorkingBeatmap beatmap() => Game.Beatmap.Value;
 
             PushAndConfirm(() => new TestPlaySongSelect());
 
@@ -128,7 +128,7 @@ namespace osu.Game.Tests.Visual.Navigation
         {
             Player player = null;
 
-            WorkingBeatmap beatmap() => Game.Beatmap.Value;
+            IWorkingBeatmap beatmap() => Game.Beatmap.Value;
 
             PushAndConfirm(() => new TestPlaySongSelect());
 
diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapMetadataDisplay.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapMetadataDisplay.cs
index 9473b058cc..11d589f7bc 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapMetadataDisplay.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapMetadataDisplay.cs
@@ -88,7 +88,7 @@ namespace osu.Game.Tests.Visual.SongSelect
             });
         }
 
-        private void showMetadataForBeatmap(Func<WorkingBeatmap> getBeatmap)
+        private void showMetadataForBeatmap(Func<IWorkingBeatmap> getBeatmap)
         {
             AddStep("setup display", () =>
             {
diff --git a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
index ee5a61f21f..3646b52cfa 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
@@ -17,6 +17,7 @@ using osu.Framework.Screens;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
 using osu.Game.Configuration;
+using osu.Game.Extensions;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays;
@@ -360,7 +361,7 @@ namespace osu.Game.Tests.Visual.SongSelect
             AddUntilStep("has selection", () => songSelect.Carousel.SelectedBeatmapInfo.Equals(target));
 
             // this is an important check, to make sure updateComponentFromBeatmap() was actually run
-            AddUntilStep("selection shown on wedge", () => songSelect.CurrentBeatmapDetailsBeatmap.BeatmapInfo.Equals(target));
+            AddUntilStep("selection shown on wedge", () => songSelect.CurrentBeatmapDetailsBeatmap.BeatmapInfo.MatchesOnlineID(target));
         }
 
         [Test]
@@ -392,7 +393,7 @@ namespace osu.Game.Tests.Visual.SongSelect
             AddUntilStep("has correct ruleset", () => Ruleset.Value.ID == 0);
 
             // this is an important check, to make sure updateComponentFromBeatmap() was actually run
-            AddUntilStep("selection shown on wedge", () => songSelect.CurrentBeatmapDetailsBeatmap.BeatmapInfo.Equals(target));
+            AddUntilStep("selection shown on wedge", () => songSelect.CurrentBeatmapDetailsBeatmap.BeatmapInfo.MatchesOnlineID(target));
         }
 
         [Test]
@@ -672,7 +673,7 @@ namespace osu.Game.Tests.Visual.SongSelect
 
             AddUntilStep("wait for selection", () => !Beatmap.IsDefault);
 
-            AddStep("record set ID", () => previousSetID = Beatmap.Value.BeatmapSetInfo.ID);
+            AddStep("record set ID", () => previousSetID = ((IBeatmapSetInfo)Beatmap.Value.BeatmapSetInfo).OnlineID);
             AddAssert("selection changed once", () => changeCount == 1);
 
             AddAssert("Check ruleset is osu!", () => Ruleset.Value.ID == 0);
@@ -683,8 +684,8 @@ namespace osu.Game.Tests.Visual.SongSelect
 
             AddUntilStep("selection changed", () => changeCount > 1);
 
-            AddAssert("Selected beatmap still same set", () => Beatmap.Value.BeatmapSetInfo.ID == previousSetID);
-            AddAssert("Selected beatmap is mania", () => Beatmap.Value.BeatmapInfo.Ruleset.ID == 3);
+            AddAssert("Selected beatmap still same set", () => Beatmap.Value.BeatmapSetInfo.OnlineID == previousSetID);
+            AddAssert("Selected beatmap is mania", () => Beatmap.Value.BeatmapInfo.Ruleset.OnlineID == 3);
 
             AddAssert("selection changed only fired twice", () => changeCount == 2);
 
@@ -727,7 +728,7 @@ namespace osu.Game.Tests.Visual.SongSelect
 
             int previousSetID = 0;
 
-            AddStep("record set ID", () => previousSetID = Beatmap.Value.BeatmapSetInfo.ID);
+            AddStep("record set ID", () => previousSetID = ((IBeatmapSetInfo)Beatmap.Value.BeatmapSetInfo).OnlineID);
 
             AddStep("Click on a difficulty", () =>
             {
@@ -739,7 +740,7 @@ namespace osu.Game.Tests.Visual.SongSelect
             AddUntilStep("Check ruleset changed to mania", () => Ruleset.Value.ID == 3);
 
             AddAssert("Selected beatmap still same set", () => songSelect.Carousel.SelectedBeatmapInfo.BeatmapSet.ID == previousSetID);
-            AddAssert("Selected beatmap is mania", () => Beatmap.Value.BeatmapInfo.Ruleset.ID == 3);
+            AddAssert("Selected beatmap is mania", () => Beatmap.Value.BeatmapInfo.Ruleset.OnlineID == 3);
         }
 
         [Test]
@@ -784,7 +785,7 @@ namespace osu.Game.Tests.Visual.SongSelect
 
             AddUntilStep("Check ruleset changed to mania", () => Ruleset.Value.ID == 3);
 
-            AddAssert("Check first item in group selected", () => Beatmap.Value.BeatmapInfo.Equals(groupIcon.Items.First().BeatmapInfo));
+            AddAssert("Check first item in group selected", () => Beatmap.Value.BeatmapInfo.MatchesOnlineID(groupIcon.Items.First().BeatmapInfo));
         }
 
         [Test]
@@ -815,7 +816,7 @@ namespace osu.Game.Tests.Visual.SongSelect
 
             AddUntilStep("wait for results screen presented", () => !songSelect.IsCurrentScreen());
 
-            AddAssert("check beatmap is correct for score", () => Beatmap.Value.BeatmapInfo.Equals(getPresentBeatmap()));
+            AddAssert("check beatmap is correct for score", () => Beatmap.Value.BeatmapInfo.MatchesOnlineID(getPresentBeatmap()));
             AddAssert("check ruleset is correct for score", () => Ruleset.Value.ID == 0);
         }
 
@@ -847,7 +848,7 @@ namespace osu.Game.Tests.Visual.SongSelect
 
             AddUntilStep("wait for results screen presented", () => !songSelect.IsCurrentScreen());
 
-            AddAssert("check beatmap is correct for score", () => Beatmap.Value.BeatmapInfo.Equals(getPresentBeatmap()));
+            AddAssert("check beatmap is correct for score", () => Beatmap.Value.BeatmapInfo.MatchesOnlineID(getPresentBeatmap()));
             AddAssert("check ruleset is correct for score", () => Ruleset.Value.ID == 0);
         }
 
@@ -960,7 +961,7 @@ namespace osu.Game.Tests.Visual.SongSelect
             public new FilterControl FilterControl => base.FilterControl;
 
             public WorkingBeatmap CurrentBeatmap => Beatmap.Value;
-            public WorkingBeatmap CurrentBeatmapDetailsBeatmap => BeatmapDetails.Beatmap;
+            public IWorkingBeatmap CurrentBeatmapDetailsBeatmap => BeatmapDetails.Beatmap;
             public new BeatmapCarousel Carousel => base.Carousel;
 
             public new void PresentScore(ScoreInfo score) => base.PresentScore(score);
diff --git a/osu.Game/Beatmaps/BeatmapDifficultyCache.cs b/osu.Game/Beatmaps/BeatmapDifficultyCache.cs
index 7231409dc5..0e9a92989c 100644
--- a/osu.Game/Beatmaps/BeatmapDifficultyCache.cs
+++ b/osu.Game/Beatmaps/BeatmapDifficultyCache.cs
@@ -151,7 +151,7 @@ namespace osu.Game.Beatmaps
             }, token, TaskCreationOptions.HideScheduler | TaskCreationOptions.RunContinuationsAsynchronously, updateScheduler);
         }
 
-        public Task<List<TimedDifficultyAttributes>> GetTimedDifficultyAttributesAsync(WorkingBeatmap beatmap, Ruleset ruleset, Mod[] mods, CancellationToken token = default)
+        public Task<List<TimedDifficultyAttributes>> GetTimedDifficultyAttributesAsync(IWorkingBeatmap beatmap, Ruleset ruleset, Mod[] mods, CancellationToken token = default)
         {
             return Task.Factory.StartNew(() => ruleset.CreateDifficultyCalculator(beatmap).CalculateTimed(mods),
                 token,
diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index 48a6663adb..c2a2e93caf 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -179,7 +179,7 @@ namespace osu.Game.Beatmaps
         /// <summary>
         /// A default representation of a WorkingBeatmap to use when no beatmap is available.
         /// </summary>
-        public WorkingBeatmap DefaultBeatmap => workingBeatmapCache.DefaultBeatmap;
+        public IWorkingBeatmap DefaultBeatmap => workingBeatmapCache.DefaultBeatmap;
 
         /// <summary>
         /// Fired when a notification should be presented to the user.
diff --git a/osu.Game/Beatmaps/Drawables/BeatmapBackgroundSprite.cs b/osu.Game/Beatmaps/Drawables/BeatmapBackgroundSprite.cs
index 0c59eec1ef..916df429a4 100644
--- a/osu.Game/Beatmaps/Drawables/BeatmapBackgroundSprite.cs
+++ b/osu.Game/Beatmaps/Drawables/BeatmapBackgroundSprite.cs
@@ -9,9 +9,9 @@ namespace osu.Game.Beatmaps.Drawables
 {
     public class BeatmapBackgroundSprite : Sprite
     {
-        private readonly WorkingBeatmap working;
+        private readonly IWorkingBeatmap working;
 
-        public BeatmapBackgroundSprite(WorkingBeatmap working)
+        public BeatmapBackgroundSprite(IWorkingBeatmap working)
         {
             if (working == null)
                 throw new ArgumentNullException(nameof(working));
diff --git a/osu.Game/Online/Chat/NowPlayingCommand.cs b/osu.Game/Online/Chat/NowPlayingCommand.cs
index 34b12c23e6..2bf35d7973 100644
--- a/osu.Game/Online/Chat/NowPlayingCommand.cs
+++ b/osu.Game/Online/Chat/NowPlayingCommand.cs
@@ -37,7 +37,7 @@ namespace osu.Game.Online.Chat
             base.LoadComplete();
 
             string verb;
-            BeatmapInfo beatmapInfo;
+            IBeatmapInfo beatmapInfo;
 
             switch (api.Activity.Value)
             {
@@ -57,7 +57,7 @@ namespace osu.Game.Online.Chat
                     break;
             }
 
-            string beatmapString = beatmapInfo.OnlineID.HasValue ? $"[{api.WebsiteRootUrl}/b/{beatmapInfo.OnlineID} {beatmapInfo}]" : beatmapInfo.ToString();
+            string beatmapString = beatmapInfo.OnlineID > 0 ? $"[{api.WebsiteRootUrl}/b/{beatmapInfo.OnlineID} {beatmapInfo}]" : beatmapInfo.ToString();
 
             channelManager.PostMessage($"is {verb} {beatmapString}", true, target);
             Expire();
diff --git a/osu.Game/Screens/Play/BeatmapMetadataDisplay.cs b/osu.Game/Screens/Play/BeatmapMetadataDisplay.cs
index 430571e1da..795dddfaf5 100644
--- a/osu.Game/Screens/Play/BeatmapMetadataDisplay.cs
+++ b/osu.Game/Screens/Play/BeatmapMetadataDisplay.cs
@@ -25,7 +25,7 @@ namespace osu.Game.Screens.Play
     /// </summary>
     public class BeatmapMetadataDisplay : Container
     {
-        private readonly WorkingBeatmap beatmap;
+        private readonly IWorkingBeatmap beatmap;
         private readonly Bindable<IReadOnlyList<Mod>> mods;
         private readonly Drawable logoFacade;
         private LoadingSpinner loading;
@@ -43,7 +43,7 @@ namespace osu.Game.Screens.Play
             }
         }
 
-        public BeatmapMetadataDisplay(WorkingBeatmap beatmap, Bindable<IReadOnlyList<Mod>> mods, Drawable logoFacade)
+        public BeatmapMetadataDisplay(IWorkingBeatmap beatmap, Bindable<IReadOnlyList<Mod>> mods, Drawable logoFacade)
         {
             this.beatmap = beatmap;
             this.logoFacade = logoFacade;
diff --git a/osu.Game/Screens/Play/Player.cs b/osu.Game/Screens/Play/Player.cs
index 1381493fdf..4d574dea99 100644
--- a/osu.Game/Screens/Play/Player.cs
+++ b/osu.Game/Screens/Play/Player.cs
@@ -354,7 +354,7 @@ namespace osu.Game.Screens.Play
         private Drawable createUnderlayComponents() =>
             DimmableStoryboard = new DimmableStoryboard(Beatmap.Value.Storyboard) { RelativeSizeAxes = Axes.Both };
 
-        private Drawable createGameplayComponents(WorkingBeatmap working, IBeatmap playableBeatmap) => new ScalingContainer(ScalingMode.Gameplay)
+        private Drawable createGameplayComponents(IWorkingBeatmap working, IBeatmap playableBeatmap) => new ScalingContainer(ScalingMode.Gameplay)
         {
             Children = new Drawable[]
             {
@@ -372,7 +372,7 @@ namespace osu.Game.Screens.Play
             }
         };
 
-        private Drawable createOverlayComponents(WorkingBeatmap working)
+        private Drawable createOverlayComponents(IWorkingBeatmap working)
         {
             var container = new Container
             {
diff --git a/osu.Game/Screens/Select/BeatmapInfoWedgeBackground.cs b/osu.Game/Screens/Select/BeatmapInfoWedgeBackground.cs
index 25056790cc..d9b8a20846 100644
--- a/osu.Game/Screens/Select/BeatmapInfoWedgeBackground.cs
+++ b/osu.Game/Screens/Select/BeatmapInfoWedgeBackground.cs
@@ -15,9 +15,9 @@ namespace osu.Game.Screens.Select
 {
     internal class BeatmapInfoWedgeBackground : CompositeDrawable
     {
-        private readonly WorkingBeatmap beatmap;
+        private readonly IWorkingBeatmap beatmap;
 
-        public BeatmapInfoWedgeBackground(WorkingBeatmap beatmap)
+        public BeatmapInfoWedgeBackground(IWorkingBeatmap beatmap)
         {
             this.beatmap = beatmap;
         }
diff --git a/osu.Game/Screens/Select/Carousel/SetPanelBackground.cs b/osu.Game/Screens/Select/Carousel/SetPanelBackground.cs
index b4279cce51..2a37969be1 100644
--- a/osu.Game/Screens/Select/Carousel/SetPanelBackground.cs
+++ b/osu.Game/Screens/Select/Carousel/SetPanelBackground.cs
@@ -14,7 +14,7 @@ namespace osu.Game.Screens.Select.Carousel
 {
     public class SetPanelBackground : BufferedContainer
     {
-        public SetPanelBackground(WorkingBeatmap working)
+        public SetPanelBackground(IWorkingBeatmap working)
             : base(cachedFrameBuffer: true)
         {
             RedrawOnScale = false;
diff --git a/osu.Game/Screens/Select/SongSelect.cs b/osu.Game/Screens/Select/SongSelect.cs
index 4da15ee53c..aef00a9b00 100644
--- a/osu.Game/Screens/Select/SongSelect.cs
+++ b/osu.Game/Screens/Select/SongSelect.cs
@@ -671,7 +671,7 @@ namespace osu.Game.Screens.Select
             music.TrackChanged -= ensureTrackLooping;
         }
 
-        private void ensureTrackLooping(WorkingBeatmap beatmap, TrackChangeDirection changeDirection)
+        private void ensureTrackLooping(IWorkingBeatmap beatmap, TrackChangeDirection changeDirection)
             => beatmap.PrepareTrackForPreviewLooping();
 
         public override bool OnBackButton()
diff --git a/osu.Game/Storyboards/Storyboard.cs b/osu.Game/Storyboards/Storyboard.cs
index 9e3d3df915..d3d6797eae 100644
--- a/osu.Game/Storyboards/Storyboard.cs
+++ b/osu.Game/Storyboards/Storyboard.cs
@@ -89,7 +89,7 @@ namespace osu.Game.Storyboards
             }
         }
 
-        public DrawableStoryboard CreateDrawable(WorkingBeatmap working = null) =>
+        public DrawableStoryboard CreateDrawable(IWorkingBeatmap working = null) =>
             new DrawableStoryboard(this);
 
         public Drawable CreateSpriteFromResourcePath(string path, TextureStore textureStore)
diff --git a/osu.Game/Users/UserActivity.cs b/osu.Game/Users/UserActivity.cs
index 91bcb37fcc..0874685f49 100644
--- a/osu.Game/Users/UserActivity.cs
+++ b/osu.Game/Users/UserActivity.cs
@@ -27,11 +27,11 @@ namespace osu.Game.Users
 
         public abstract class InGame : UserActivity
         {
-            public BeatmapInfo BeatmapInfo { get; }
+            public IBeatmapInfo BeatmapInfo { get; }
 
             public RulesetInfo Ruleset { get; }
 
-            protected InGame(BeatmapInfo beatmapInfo, RulesetInfo ruleset)
+            protected InGame(IBeatmapInfo beatmapInfo, RulesetInfo ruleset)
             {
                 BeatmapInfo = beatmapInfo;
                 Ruleset = ruleset;
@@ -42,7 +42,7 @@ namespace osu.Game.Users
 
         public class InMultiplayerGame : InGame
         {
-            public InMultiplayerGame(BeatmapInfo beatmapInfo, RulesetInfo ruleset)
+            public InMultiplayerGame(IBeatmapInfo beatmapInfo, RulesetInfo ruleset)
                 : base(beatmapInfo, ruleset)
             {
             }
@@ -52,7 +52,7 @@ namespace osu.Game.Users
 
         public class InPlaylistGame : InGame
         {
-            public InPlaylistGame(BeatmapInfo beatmapInfo, RulesetInfo ruleset)
+            public InPlaylistGame(IBeatmapInfo beatmapInfo, RulesetInfo ruleset)
                 : base(beatmapInfo, ruleset)
             {
             }
@@ -60,7 +60,7 @@ namespace osu.Game.Users
 
         public class InSoloGame : InGame
         {
-            public InSoloGame(BeatmapInfo beatmapInfo, RulesetInfo ruleset)
+            public InSoloGame(IBeatmapInfo beatmapInfo, RulesetInfo ruleset)
                 : base(beatmapInfo, ruleset)
             {
             }
@@ -68,9 +68,9 @@ namespace osu.Game.Users
 
         public class Editing : UserActivity
         {
-            public BeatmapInfo BeatmapInfo { get; }
+            public IBeatmapInfo BeatmapInfo { get; }
 
-            public Editing(BeatmapInfo info)
+            public Editing(IBeatmapInfo info)
             {
                 BeatmapInfo = info;
             }

From a4953b5658a9f3dd71a4907fc032837ee6eed15a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 17 Nov 2021 11:34:46 +0900
Subject: [PATCH 1078/5547] Update some remaining test usage of database ID

---
 .../Visual/SongSelect/TestScenePlaySongSelect.cs   | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
index 3646b52cfa..0437c1b25b 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
@@ -508,13 +508,13 @@ namespace osu.Game.Tests.Visual.SongSelect
                     i.IsFiltered || i.Item.BeatmapInfo.Ruleset.ID == targetRuleset || i.Item.BeatmapInfo.Ruleset.ID == 0);
             });
 
-            AddUntilStep("carousel has correct", () => songSelect.Carousel.SelectedBeatmapInfo?.OnlineID == target.OnlineID);
-            AddUntilStep("game has correct", () => Beatmap.Value.BeatmapInfo.OnlineID == target.OnlineID);
+            AddUntilStep("carousel has correct", () => songSelect.Carousel.SelectedBeatmapInfo?.MatchesOnlineID(target) == true);
+            AddUntilStep("game has correct", () => Beatmap.Value.BeatmapInfo.MatchesOnlineID(target));
 
             AddStep("reset filter text", () => songSelect.FilterControl.ChildrenOfType<SearchTextBox>().First().Text = string.Empty);
 
-            AddAssert("game still correct", () => Beatmap.Value?.BeatmapInfo.OnlineID == target.OnlineID);
-            AddAssert("carousel still correct", () => songSelect.Carousel.SelectedBeatmapInfo.OnlineID == target.OnlineID);
+            AddAssert("game still correct", () => Beatmap.Value?.BeatmapInfo.MatchesOnlineID(target) == true);
+            AddAssert("carousel still correct", () => songSelect.Carousel.SelectedBeatmapInfo.MatchesOnlineID(target));
         }
 
         [Test]
@@ -545,8 +545,8 @@ namespace osu.Game.Tests.Visual.SongSelect
 
             AddUntilStep("has selection", () => songSelect.Carousel.SelectedBeatmapInfo != null);
 
-            AddUntilStep("carousel has correct", () => songSelect.Carousel.SelectedBeatmapInfo?.OnlineID == target.OnlineID);
-            AddUntilStep("game has correct", () => Beatmap.Value.BeatmapInfo.OnlineID == target.OnlineID);
+            AddUntilStep("carousel has correct", () => songSelect.Carousel.SelectedBeatmapInfo?.MatchesOnlineID(target) == true);
+            AddUntilStep("game has correct", () => Beatmap.Value.BeatmapInfo.MatchesOnlineID(target));
 
             AddStep("set filter text", () => songSelect.FilterControl.ChildrenOfType<SearchTextBox>().First().Text = "nononoo");
 
@@ -739,7 +739,7 @@ namespace osu.Game.Tests.Visual.SongSelect
 
             AddUntilStep("Check ruleset changed to mania", () => Ruleset.Value.ID == 3);
 
-            AddAssert("Selected beatmap still same set", () => songSelect.Carousel.SelectedBeatmapInfo.BeatmapSet.ID == previousSetID);
+            AddAssert("Selected beatmap still same set", () => songSelect.Carousel.SelectedBeatmapInfo.BeatmapSet.OnlineID == previousSetID);
             AddAssert("Selected beatmap is mania", () => Beatmap.Value.BeatmapInfo.Ruleset.OnlineID == 3);
         }
 

From 5fb5baa4c9d5442f8cb14b6c06577e2c829504af Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 17 Nov 2021 21:06:33 +0900
Subject: [PATCH 1079/5547] Adjust error message

---
 .../OnlinePlay/Playlists/PlaylistsRoomSettingsOverlay.cs        | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSettingsOverlay.cs b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSettingsOverlay.cs
index 7d96e5303c..dc773b7762 100644
--- a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSettingsOverlay.cs
+++ b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSettingsOverlay.cs
@@ -355,7 +355,7 @@ namespace osu.Game.Screens.OnlinePlay.Playlists
 
                 if (text.StartsWith(not_found_prefix, StringComparison.Ordinal))
                 {
-                    ErrorText.Text = "One or more beatmap was not available online. Please remove or replaced the highlighted items.";
+                    ErrorText.Text = "One or more beatmaps were not available online. Please remove or replaced the highlighted items.";
 
                     int[] invalidBeatmapIDs = text
                                               .Substring(not_found_prefix.Length + 1)

From 214705f1e528cc53e820bbc01a33313e61d608da Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 17 Nov 2021 21:11:37 +0900
Subject: [PATCH 1080/5547] Adjust error message, take 2

---
 .../OnlinePlay/Playlists/PlaylistsRoomSettingsOverlay.cs        | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSettingsOverlay.cs b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSettingsOverlay.cs
index dc773b7762..27c8dc1120 100644
--- a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSettingsOverlay.cs
+++ b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSettingsOverlay.cs
@@ -355,7 +355,7 @@ namespace osu.Game.Screens.OnlinePlay.Playlists
 
                 if (text.StartsWith(not_found_prefix, StringComparison.Ordinal))
                 {
-                    ErrorText.Text = "One or more beatmaps were not available online. Please remove or replaced the highlighted items.";
+                    ErrorText.Text = "One or more beatmaps were not available online. Please remove or replace the highlighted items.";
 
                     int[] invalidBeatmapIDs = text
                                               .Substring(not_found_prefix.Length + 1)

From 8528cab40b862c4b03c27c8543ebb9c95f6ea15d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 17 Nov 2021 22:07:24 +0100
Subject: [PATCH 1081/5547] Add test coverage for ruleset load failure scenario

---
 osu.Game.Tests/Beatmaps/WorkingBeatmapTest.cs | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/osu.Game.Tests/Beatmaps/WorkingBeatmapTest.cs b/osu.Game.Tests/Beatmaps/WorkingBeatmapTest.cs
index 02e4a87a7a..6ad63a5fbb 100644
--- a/osu.Game.Tests/Beatmaps/WorkingBeatmapTest.cs
+++ b/osu.Game.Tests/Beatmaps/WorkingBeatmapTest.cs
@@ -5,6 +5,7 @@ using System;
 using System.Collections.Generic;
 using System.Threading;
 using System.Threading.Tasks;
+using Moq;
 using NUnit.Framework;
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets;
@@ -62,6 +63,17 @@ namespace osu.Game.Tests.Beatmaps
             working.ResetEvent.Set();
         }
 
+        [Test]
+        public void TestGetPlayableRulesetLoadFailure()
+        {
+            var working = new TestWorkingBeatmap(new Beatmap());
+
+            // by default mocks return nulls if not set up, which is actually desired here to simulate a ruleset load failure scenario.
+            var ruleset = new Mock<IRulesetInfo>();
+
+            Assert.Throws<RulesetLoadException>(() => working.GetPlayableBeatmap(ruleset.Object));
+        }
+
         public class TestNeverLoadsWorkingBeatmap : TestWorkingBeatmap
         {
             public ManualResetEventSlim ResetEvent = new ManualResetEventSlim();

From 1c13b39104a14cf9dc9d7727a0460e8bfb63bab1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 17 Nov 2021 22:00:09 +0100
Subject: [PATCH 1082/5547] Revert incorrect ordering change

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

diff --git a/osu.Game/Beatmaps/WorkingBeatmap.cs b/osu.Game/Beatmaps/WorkingBeatmap.cs
index dc38a9af69..f46cd405b5 100644
--- a/osu.Game/Beatmaps/WorkingBeatmap.cs
+++ b/osu.Game/Beatmaps/WorkingBeatmap.cs
@@ -85,11 +85,11 @@ namespace osu.Game.Beatmaps
 
             var rulesetInstance = ruleset.CreateInstance();
 
-            IBeatmapConverter converter = CreateBeatmapConverter(Beatmap, rulesetInstance);
-
             if (rulesetInstance == null)
                 throw new RulesetLoadException("Creating ruleset instance failed when attempting to create playable beatmap.");
 
+            IBeatmapConverter converter = CreateBeatmapConverter(Beatmap, rulesetInstance);
+
             // Check if the beatmap can be converted
             if (Beatmap.HitObjects.Count > 0 && !converter.CanConvert())
                 throw new BeatmapInvalidForRulesetException($"{nameof(Beatmaps.Beatmap)} can not be converted for the ruleset (ruleset: {ruleset.InstantiationInfo}, converter: {converter}).");

From cd5e379c4828e8456bf2e6cd90d10ae3d8621e80 Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Tue, 16 Nov 2021 23:32:37 -0800
Subject: [PATCH 1083/5547] Link osu!supporter icon to its web page

---
 .../Profile/Header/Components/SupporterIcon.cs     | 14 ++++++++------
 1 file changed, 8 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Overlays/Profile/Header/Components/SupporterIcon.cs b/osu.Game/Overlays/Profile/Header/Components/SupporterIcon.cs
index 77f0378762..bee3548008 100644
--- a/osu.Game/Overlays/Profile/Header/Components/SupporterIcon.cs
+++ b/osu.Game/Overlays/Profile/Header/Components/SupporterIcon.cs
@@ -5,22 +5,22 @@ using System;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
-using osu.Framework.Graphics.Cursor;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Localisation;
 using osu.Game.Graphics;
+using osu.Game.Graphics.Containers;
 using osu.Game.Resources.Localisation.Web;
 
 namespace osu.Game.Overlays.Profile.Header.Components
 {
-    public class SupporterIcon : CompositeDrawable, IHasTooltip
+    public class SupporterIcon : OsuClickableContainer
     {
         private readonly Box background;
         private readonly FillFlowContainer iconContainer;
         private readonly CircularContainer content;
 
-        public LocalisableString TooltipText => UsersStrings.ShowIsSupporter;
+        public override LocalisableString TooltipText => UsersStrings.ShowIsSupporter;
 
         public int SupportLevel
         {
@@ -56,7 +56,7 @@ namespace osu.Game.Overlays.Profile.Header.Components
         {
             AutoSizeAxes = Axes.X;
 
-            InternalChild = content = new CircularContainer
+            Child = content = new CircularContainer
             {
                 RelativeSizeAxes = Axes.Y,
                 AutoSizeAxes = Axes.X,
@@ -78,10 +78,12 @@ namespace osu.Game.Overlays.Profile.Header.Components
             };
         }
 
-        [BackgroundDependencyLoader]
-        private void load(OsuColour colours)
+        [BackgroundDependencyLoader(true)]
+        private void load(OsuColour colours, OsuGame game)
         {
             background.Colour = colours.Pink;
+
+            Action = () => game?.OpenUrlExternally(@"/home/support");
         }
     }
 }

From 6a444b9edbc2c8b780e965b08dcef1ade102e990 Mon Sep 17 00:00:00 2001
From: MBmasher <mbmasher@gmail.com>
Date: Thu, 18 Nov 2021 09:47:41 +1100
Subject: [PATCH 1084/5547] Further balancing opacity/hidden bonus

---
 .../Difficulty/Flashlight.cs                  | 112 ++++++++++++++++++
 .../Difficulty/Skills/Flashlight.cs           |   8 +-
 2 files changed, 116 insertions(+), 4 deletions(-)
 create mode 100644 osu.Game.Rulesets.Osu/Difficulty/Flashlight.cs

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Flashlight.cs b/osu.Game.Rulesets.Osu/Difficulty/Flashlight.cs
new file mode 100644
index 0000000000..da7ab3d1fc
--- /dev/null
+++ b/osu.Game.Rulesets.Osu/Difficulty/Flashlight.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;
+using System.Linq;
+using osu.Game.Rulesets.Difficulty.Preprocessing;
+using osu.Game.Rulesets.Mods;
+using osu.Game.Rulesets.Osu.Mods;
+using osu.Game.Rulesets.Osu.Difficulty.Preprocessing;
+using osu.Game.Rulesets.Osu.Objects;
+
+namespace osu.Game.Rulesets.Osu.Difficulty.Skills
+{
+    /// <summary>
+    /// Represents the skill required to memorise and hit every object in a map with the Flashlight mod enabled.
+    /// </summary>
+    public class Flashlight : OsuStrainSkill
+    {
+        public Flashlight(Mod[] mods, double preemptTime)
+            : base(mods)
+        {
+            this.mods = mods;
+            this.preemptTime = preemptTime;
+        }
+
+        private double skillMultiplier => 0.07;
+        private double strainDecayBase => 0.15;
+        protected override double DecayWeight => 1.0;
+        protected override int HistoryLength => 10; // Look back for 10 notes is added for the sake of flashlight calculations.
+
+        private Mod[] mods;
+        private bool hidden;
+        private double preemptTime;
+
+        private const double max_opacity_bonus = 1.0;
+        private const double hidden_bonus = 0.8;
+
+        private double currentStrain;
+
+        private double strainValueOf(DifficultyHitObject current)
+        {
+            if (current.BaseObject is Spinner)
+                return 0;
+
+            hidden = mods.Any(m => m is OsuModHidden);
+
+            var osuCurrent = (OsuDifficultyHitObject)current;
+            var osuHitObject = (OsuHitObject)(osuCurrent.BaseObject);
+
+            double scalingFactor = 52.0 / osuHitObject.Radius;
+            double smallDistNerf = 1.0;
+            double cumulativeStrainTime = 0.0;
+
+            double result = 0.0;
+
+            for (int i = 0; i < Previous.Count; i++)
+            {
+                var osuPrevious = (OsuDifficultyHitObject)Previous[i];
+                var osuPreviousHitObject = (OsuHitObject)(osuPrevious.BaseObject);
+
+                if (!(osuPrevious.BaseObject is Spinner))
+                {
+                    double jumpDistance = (osuHitObject.StackedPosition - osuPreviousHitObject.EndPosition).Length;
+
+                    cumulativeStrainTime += osuPrevious.StrainTime;
+
+                    // We want to nerf objects that can be easily seen within the Flashlight circle radius.
+                    if (i == 0)
+                        smallDistNerf = Math.Min(1.0, jumpDistance / 75.0);
+
+                    // We also want to nerf stacks so that only the first object of the stack is accounted for.
+                    double stackNerf = Math.Min(1.0, (osuPrevious.JumpDistance / scalingFactor) / 25.0);
+
+                    // Bonus based on how visible the object is.
+                    double opacityBonus = 1.0 + max_opacity_bonus * (1.0 - opacity(cumulativeStrainTime, preemptTime, hidden));
+
+                    result += Math.Pow(0.8, i) * stackNerf * opacityBonus * scalingFactor * jumpDistance / cumulativeStrainTime;
+                }
+            }
+
+            result = Math.Pow(smallDistNerf * result, 2.0);
+
+            // Additional bonus for Hidden due to there being no approach circles.
+            if (hidden)
+                result *= 1.0 + hidden_bonus;
+
+            return result;
+        }
+
+        private double opacity(double ms, double preemptTime, bool hidden) {
+            if (hidden) {
+                return Math.Clamp(Math.Min((1 - ms / preemptTime) * 2.5, (ms / preemptTime) * (1.0 / 0.3)), 0.0, 1.0);
+            }
+            else
+            {
+                return Math.Clamp((1.0 - ms / preemptTime) * 1.5, 0.0, 1.0);
+            }
+        }
+
+        private double strainDecay(double ms) => Math.Pow(strainDecayBase, ms / 1000);
+
+        protected override double CalculateInitialStrain(double time) => currentStrain * strainDecay(time - Previous[0].StartTime);
+
+        protected override double StrainValueAt(DifficultyHitObject current)
+        {
+            currentStrain *= strainDecay(current.DeltaTime);
+            currentStrain += strainValueOf(current) * skillMultiplier;
+
+            return currentStrain;
+        }
+    }
+}
diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
index 12580cb450..209374714d 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.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;
@@ -23,7 +23,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
             this.preemptTime = preemptTime;
         }
 
-        private double skillMultiplier => 0.11;
+        private double skillMultiplier => 0.09;
         private double strainDecayBase => 0.15;
         protected override double DecayWeight => 1.0;
         protected override int HistoryLength => 10; // Look back for 10 notes is added for the sake of flashlight calculations.
@@ -32,8 +32,8 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
         private bool hidden;
         private double preemptTime;
 
-        private const double max_opacity_bonus = 0.4;
-        private const double hidden_bonus = 0.4;
+        private const double max_opacity_bonus = 0.7;
+        private const double hidden_bonus = 0.5;
 
         private double currentStrain;
 

From 8e8571543d526ee218cceb1c56b0ae784bc870bc Mon Sep 17 00:00:00 2001
From: MBmasher <mbmasher@gmail.com>
Date: Thu, 18 Nov 2021 09:48:18 +1100
Subject: [PATCH 1085/5547] Removing unnecessary file

---
 .../Difficulty/Flashlight.cs                  | 112 ------------------
 1 file changed, 112 deletions(-)
 delete mode 100644 osu.Game.Rulesets.Osu/Difficulty/Flashlight.cs

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Flashlight.cs b/osu.Game.Rulesets.Osu/Difficulty/Flashlight.cs
deleted file mode 100644
index da7ab3d1fc..0000000000
--- a/osu.Game.Rulesets.Osu/Difficulty/Flashlight.cs
+++ /dev/null
@@ -1,112 +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.Linq;
-using osu.Game.Rulesets.Difficulty.Preprocessing;
-using osu.Game.Rulesets.Mods;
-using osu.Game.Rulesets.Osu.Mods;
-using osu.Game.Rulesets.Osu.Difficulty.Preprocessing;
-using osu.Game.Rulesets.Osu.Objects;
-
-namespace osu.Game.Rulesets.Osu.Difficulty.Skills
-{
-    /// <summary>
-    /// Represents the skill required to memorise and hit every object in a map with the Flashlight mod enabled.
-    /// </summary>
-    public class Flashlight : OsuStrainSkill
-    {
-        public Flashlight(Mod[] mods, double preemptTime)
-            : base(mods)
-        {
-            this.mods = mods;
-            this.preemptTime = preemptTime;
-        }
-
-        private double skillMultiplier => 0.07;
-        private double strainDecayBase => 0.15;
-        protected override double DecayWeight => 1.0;
-        protected override int HistoryLength => 10; // Look back for 10 notes is added for the sake of flashlight calculations.
-
-        private Mod[] mods;
-        private bool hidden;
-        private double preemptTime;
-
-        private const double max_opacity_bonus = 1.0;
-        private const double hidden_bonus = 0.8;
-
-        private double currentStrain;
-
-        private double strainValueOf(DifficultyHitObject current)
-        {
-            if (current.BaseObject is Spinner)
-                return 0;
-
-            hidden = mods.Any(m => m is OsuModHidden);
-
-            var osuCurrent = (OsuDifficultyHitObject)current;
-            var osuHitObject = (OsuHitObject)(osuCurrent.BaseObject);
-
-            double scalingFactor = 52.0 / osuHitObject.Radius;
-            double smallDistNerf = 1.0;
-            double cumulativeStrainTime = 0.0;
-
-            double result = 0.0;
-
-            for (int i = 0; i < Previous.Count; i++)
-            {
-                var osuPrevious = (OsuDifficultyHitObject)Previous[i];
-                var osuPreviousHitObject = (OsuHitObject)(osuPrevious.BaseObject);
-
-                if (!(osuPrevious.BaseObject is Spinner))
-                {
-                    double jumpDistance = (osuHitObject.StackedPosition - osuPreviousHitObject.EndPosition).Length;
-
-                    cumulativeStrainTime += osuPrevious.StrainTime;
-
-                    // We want to nerf objects that can be easily seen within the Flashlight circle radius.
-                    if (i == 0)
-                        smallDistNerf = Math.Min(1.0, jumpDistance / 75.0);
-
-                    // We also want to nerf stacks so that only the first object of the stack is accounted for.
-                    double stackNerf = Math.Min(1.0, (osuPrevious.JumpDistance / scalingFactor) / 25.0);
-
-                    // Bonus based on how visible the object is.
-                    double opacityBonus = 1.0 + max_opacity_bonus * (1.0 - opacity(cumulativeStrainTime, preemptTime, hidden));
-
-                    result += Math.Pow(0.8, i) * stackNerf * opacityBonus * scalingFactor * jumpDistance / cumulativeStrainTime;
-                }
-            }
-
-            result = Math.Pow(smallDistNerf * result, 2.0);
-
-            // Additional bonus for Hidden due to there being no approach circles.
-            if (hidden)
-                result *= 1.0 + hidden_bonus;
-
-            return result;
-        }
-
-        private double opacity(double ms, double preemptTime, bool hidden) {
-            if (hidden) {
-                return Math.Clamp(Math.Min((1 - ms / preemptTime) * 2.5, (ms / preemptTime) * (1.0 / 0.3)), 0.0, 1.0);
-            }
-            else
-            {
-                return Math.Clamp((1.0 - ms / preemptTime) * 1.5, 0.0, 1.0);
-            }
-        }
-
-        private double strainDecay(double ms) => Math.Pow(strainDecayBase, ms / 1000);
-
-        protected override double CalculateInitialStrain(double time) => currentStrain * strainDecay(time - Previous[0].StartTime);
-
-        protected override double StrainValueAt(DifficultyHitObject current)
-        {
-            currentStrain *= strainDecay(current.DeltaTime);
-            currentStrain += strainValueOf(current) * skillMultiplier;
-
-            return currentStrain;
-        }
-    }
-}

From 92cf447180144a3b2a00fff624aacd531eda8406 Mon Sep 17 00:00:00 2001
From: MBmasher <mbmasher@gmail.com>
Date: Thu, 18 Nov 2021 10:32:41 +1100
Subject: [PATCH 1086/5547] Remove unnecessary braces

---
 osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs | 5 +----
 1 file changed, 1 insertion(+), 4 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
index 209374714d..d8e73ffad4 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
@@ -88,13 +88,10 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
         }
 
         private double opacity(double ms, double preemptTime, bool hidden) {
-            if (hidden) {
+            if (hidden)
                 return Math.Clamp(Math.Min((1 - ms / preemptTime) * 2.5, (ms / preemptTime) * (1.0 / 0.3)), 0.0, 1.0);
-            }
             else
-            {
                 return Math.Clamp((1.0 - ms / preemptTime) * 1.5, 0.0, 1.0);
-            }
         }
 
         private double strainDecay(double ms) => Math.Pow(strainDecayBase, ms / 1000);

From 30e18f16d9b6c42eec1b5cace8836cbc1151f7bf Mon Sep 17 00:00:00 2001
From: MBmasher <mbmasher@gmail.com>
Date: Thu, 18 Nov 2021 10:33:44 +1100
Subject: [PATCH 1087/5547] Change mods and preemptTime to readonly

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

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
index d8e73ffad4..3ae9c0eca9 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
@@ -28,9 +28,9 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
         protected override double DecayWeight => 1.0;
         protected override int HistoryLength => 10; // Look back for 10 notes is added for the sake of flashlight calculations.
 
-        private Mod[] mods;
+        private readonly Mod[] mods;
         private bool hidden;
-        private double preemptTime;
+        private readonly double preemptTime;
 
         private const double max_opacity_bonus = 0.7;
         private const double hidden_bonus = 0.5;

From f4b23f09607ca514c62e2da8f1e8b07a707f2036 Mon Sep 17 00:00:00 2001
From: MBmasher <mbmasher@gmail.com>
Date: Thu, 18 Nov 2021 10:37:07 +1100
Subject: [PATCH 1088/5547] Remove setting preempt in
 CreateDifficultyAttributes

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

diff --git a/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs b/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs
index 4e916af813..fe20ce112e 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs
@@ -60,7 +60,6 @@ namespace osu.Game.Rulesets.Osu.Difficulty
 
             double starRating = basePerformance > 0.00001 ? Math.Cbrt(1.12) * 0.027 * (Math.Cbrt(100000 / Math.Pow(2, 1 / 1.1) * basePerformance) + 4) : 0;
 
-            double preempt = IBeatmapDifficultyInfo.DifficultyRange(beatmap.Difficulty.ApproachRate, 1800, 1200, 450) / clockRate;
             double drainRate = beatmap.Difficulty.DrainRate;
 
             int maxCombo = beatmap.HitObjects.Count;

From fe83b8fc77c8e247bcf48fe597f35a4c381b49c3 Mon Sep 17 00:00:00 2001
From: MBmasher <mbmasher@gmail.com>
Date: Thu, 18 Nov 2021 10:50:32 +1100
Subject: [PATCH 1089/5547] Add line break

---
 osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
index 3ae9c0eca9..b45a54f9e7 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
@@ -87,7 +87,8 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
             return result;
         }
 
-        private double opacity(double ms, double preemptTime, bool hidden) {
+        private double opacity(double ms, double preemptTime, bool hidden)
+        {
             if (hidden)
                 return Math.Clamp(Math.Min((1 - ms / preemptTime) * 2.5, (ms / preemptTime) * (1.0 / 0.3)), 0.0, 1.0);
             else

From 3de8125eac9e73127a183553587fadf04f391061 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 18 Nov 2021 12:35:47 +0900
Subject: [PATCH 1090/5547] Update UI cases where repeat should not be handled

---
 osu.Game/Graphics/Containers/OsuFocusedOverlayContainer.cs     | 3 +++
 osu.Game/Graphics/ScreenshotManager.cs                         | 3 +++
 osu.Game/Graphics/UserInterface/BackButton.cs                  | 3 +++
 osu.Game/Graphics/UserInterface/FocusedTextBox.cs              | 3 +++
 osu.Game/Graphics/UserInterfaceV2/OsuPopover.cs                | 3 +++
 osu.Game/OsuGame.cs                                            | 3 +++
 osu.Game/Overlays/ChangelogOverlay.cs                          | 3 +++
 osu.Game/Overlays/DialogOverlay.cs                             | 3 +++
 osu.Game/Overlays/Music/MusicKeyBindingHandler.cs              | 3 +++
 osu.Game/Screens/Menu/ButtonSystem.cs                          | 3 +++
 osu.Game/Screens/Menu/ExitConfirmOverlay.cs                    | 3 +++
 osu.Game/Screens/OnlinePlay/Lounge/DrawableLoungeRoom.cs       | 3 +++
 .../Screens/OnlinePlay/Match/Components/CreateRoomButton.cs    | 3 +++
 .../Screens/OnlinePlay/Match/Components/RoomSettingsOverlay.cs | 3 +++
 osu.Game/Screens/Play/HUD/HoldForMenuButton.cs                 | 3 +++
 osu.Game/Screens/Play/HUDOverlay.cs                            | 3 +++
 osu.Game/Screens/Play/HotkeyExitOverlay.cs                     | 3 +++
 osu.Game/Screens/Play/HotkeyRetryOverlay.cs                    | 3 +++
 osu.Game/Screens/Play/SkipOverlay.cs                           | 3 +++
 osu.Game/Screens/Ranking/ResultsScreen.cs                      | 3 +++
 osu.Game/Screens/Select/SongSelect.cs                          | 3 +++
 21 files changed, 63 insertions(+)

diff --git a/osu.Game/Graphics/Containers/OsuFocusedOverlayContainer.cs b/osu.Game/Graphics/Containers/OsuFocusedOverlayContainer.cs
index 16ec7ab838..68351acd7e 100644
--- a/osu.Game/Graphics/Containers/OsuFocusedOverlayContainer.cs
+++ b/osu.Game/Graphics/Containers/OsuFocusedOverlayContainer.cs
@@ -90,6 +90,9 @@ namespace osu.Game.Graphics.Containers
 
         public virtual bool OnPressed(KeyBindingPressEvent<GlobalAction> e)
         {
+            if (e.Repeat)
+                return false;
+
             switch (e.Action)
             {
                 case GlobalAction.Back:
diff --git a/osu.Game/Graphics/ScreenshotManager.cs b/osu.Game/Graphics/ScreenshotManager.cs
index 1f7f93b3c3..a39d7bfb47 100644
--- a/osu.Game/Graphics/ScreenshotManager.cs
+++ b/osu.Game/Graphics/ScreenshotManager.cs
@@ -60,6 +60,9 @@ namespace osu.Game.Graphics
 
         public bool OnPressed(KeyBindingPressEvent<GlobalAction> e)
         {
+            if (e.Repeat)
+                return false;
+
             switch (e.Action)
             {
                 case GlobalAction.TakeScreenshot:
diff --git a/osu.Game/Graphics/UserInterface/BackButton.cs b/osu.Game/Graphics/UserInterface/BackButton.cs
index c965fbcf45..1b564ef1b4 100644
--- a/osu.Game/Graphics/UserInterface/BackButton.cs
+++ b/osu.Game/Graphics/UserInterface/BackButton.cs
@@ -64,6 +64,9 @@ namespace osu.Game.Graphics.UserInterface
 
             public bool OnPressed(KeyBindingPressEvent<GlobalAction> e)
             {
+                if (e.Repeat)
+                    return false;
+
                 switch (e.Action)
                 {
                     case GlobalAction.Back:
diff --git a/osu.Game/Graphics/UserInterface/FocusedTextBox.cs b/osu.Game/Graphics/UserInterface/FocusedTextBox.cs
index 88608bf43c..578ff3c618 100644
--- a/osu.Game/Graphics/UserInterface/FocusedTextBox.cs
+++ b/osu.Game/Graphics/UserInterface/FocusedTextBox.cs
@@ -75,6 +75,9 @@ namespace osu.Game.Graphics.UserInterface
 
         public virtual bool OnPressed(KeyBindingPressEvent<GlobalAction> e)
         {
+            if (e.Repeat)
+                return false;
+
             if (!HasFocus) return false;
 
             if (e.Action == GlobalAction.Back)
diff --git a/osu.Game/Graphics/UserInterfaceV2/OsuPopover.cs b/osu.Game/Graphics/UserInterfaceV2/OsuPopover.cs
index 226c39c030..d1857dd174 100644
--- a/osu.Game/Graphics/UserInterfaceV2/OsuPopover.cs
+++ b/osu.Game/Graphics/UserInterfaceV2/OsuPopover.cs
@@ -58,6 +58,9 @@ namespace osu.Game.Graphics.UserInterfaceV2
 
         public bool OnPressed(KeyBindingPressEvent<GlobalAction> e)
         {
+            if (e.Repeat)
+                return false;
+
             if (State.Value == Visibility.Hidden)
                 return false;
 
diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index 095add399c..1274d8d867 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -1007,6 +1007,9 @@ namespace osu.Game
 
         public bool OnPressed(KeyBindingPressEvent<GlobalAction> e)
         {
+            if (e.Repeat)
+                return false;
+
             if (introScreen == null) return false;
 
             switch (e.Action)
diff --git a/osu.Game/Overlays/ChangelogOverlay.cs b/osu.Game/Overlays/ChangelogOverlay.cs
index ce12e9554d..fe611d0134 100644
--- a/osu.Game/Overlays/ChangelogOverlay.cs
+++ b/osu.Game/Overlays/ChangelogOverlay.cs
@@ -94,6 +94,9 @@ namespace osu.Game.Overlays
 
         public override bool OnPressed(KeyBindingPressEvent<GlobalAction> e)
         {
+            if (e.Repeat)
+                return false;
+
             switch (e.Action)
             {
                 case GlobalAction.Back:
diff --git a/osu.Game/Overlays/DialogOverlay.cs b/osu.Game/Overlays/DialogOverlay.cs
index 9db0f34d1b..9dea1ca00a 100644
--- a/osu.Game/Overlays/DialogOverlay.cs
+++ b/osu.Game/Overlays/DialogOverlay.cs
@@ -102,6 +102,9 @@ namespace osu.Game.Overlays
 
         public override bool OnPressed(KeyBindingPressEvent<GlobalAction> e)
         {
+            if (e.Repeat)
+                return false;
+
             switch (e.Action)
             {
                 case GlobalAction.Select:
diff --git a/osu.Game/Overlays/Music/MusicKeyBindingHandler.cs b/osu.Game/Overlays/Music/MusicKeyBindingHandler.cs
index 18ec69e106..baee17fb00 100644
--- a/osu.Game/Overlays/Music/MusicKeyBindingHandler.cs
+++ b/osu.Game/Overlays/Music/MusicKeyBindingHandler.cs
@@ -32,6 +32,9 @@ namespace osu.Game.Overlays.Music
 
         public bool OnPressed(KeyBindingPressEvent<GlobalAction> e)
         {
+            if (e.Repeat)
+                return false;
+
             if (beatmap.Disabled)
                 return false;
 
diff --git a/osu.Game/Screens/Menu/ButtonSystem.cs b/osu.Game/Screens/Menu/ButtonSystem.cs
index 5f76176aab..feb6f6c92a 100644
--- a/osu.Game/Screens/Menu/ButtonSystem.cs
+++ b/osu.Game/Screens/Menu/ButtonSystem.cs
@@ -220,6 +220,9 @@ namespace osu.Game.Screens.Menu
 
         public bool OnPressed(KeyBindingPressEvent<GlobalAction> e)
         {
+            if (e.Repeat)
+                return false;
+
             switch (e.Action)
             {
                 case GlobalAction.Back:
diff --git a/osu.Game/Screens/Menu/ExitConfirmOverlay.cs b/osu.Game/Screens/Menu/ExitConfirmOverlay.cs
index 364da2f887..a90b83c5fe 100644
--- a/osu.Game/Screens/Menu/ExitConfirmOverlay.cs
+++ b/osu.Game/Screens/Menu/ExitConfirmOverlay.cs
@@ -21,6 +21,9 @@ namespace osu.Game.Screens.Menu
 
         public bool OnPressed(KeyBindingPressEvent<GlobalAction> e)
         {
+            if (e.Repeat)
+                return false;
+
             if (e.Action == GlobalAction.Back)
             {
                 BeginConfirm();
diff --git a/osu.Game/Screens/OnlinePlay/Lounge/DrawableLoungeRoom.cs b/osu.Game/Screens/OnlinePlay/Lounge/DrawableLoungeRoom.cs
index 72574b729a..0d2b2249ef 100644
--- a/osu.Game/Screens/OnlinePlay/Lounge/DrawableLoungeRoom.cs
+++ b/osu.Game/Screens/OnlinePlay/Lounge/DrawableLoungeRoom.cs
@@ -134,6 +134,9 @@ namespace osu.Game.Screens.OnlinePlay.Lounge
 
         public bool OnPressed(KeyBindingPressEvent<GlobalAction> e)
         {
+            if (e.Repeat)
+                return false;
+
             if (SelectedRoom.Value != Room)
                 return false;
 
diff --git a/osu.Game/Screens/OnlinePlay/Match/Components/CreateRoomButton.cs b/osu.Game/Screens/OnlinePlay/Match/Components/CreateRoomButton.cs
index 53131ab90e..81e1cb2406 100644
--- a/osu.Game/Screens/OnlinePlay/Match/Components/CreateRoomButton.cs
+++ b/osu.Game/Screens/OnlinePlay/Match/Components/CreateRoomButton.cs
@@ -19,6 +19,9 @@ namespace osu.Game.Screens.OnlinePlay.Match.Components
 
         public bool OnPressed(KeyBindingPressEvent<PlatformAction> e)
         {
+            if (e.Repeat)
+                return false;
+
             if (!Enabled.Value)
                 return false;
 
diff --git a/osu.Game/Screens/OnlinePlay/Match/Components/RoomSettingsOverlay.cs b/osu.Game/Screens/OnlinePlay/Match/Components/RoomSettingsOverlay.cs
index 6d14b95aec..435c9aca02 100644
--- a/osu.Game/Screens/OnlinePlay/Match/Components/RoomSettingsOverlay.cs
+++ b/osu.Game/Screens/OnlinePlay/Match/Components/RoomSettingsOverlay.cs
@@ -65,6 +65,9 @@ namespace osu.Game.Screens.OnlinePlay.Match.Components
 
         public bool OnPressed(KeyBindingPressEvent<GlobalAction> e)
         {
+            if (e.Repeat)
+                return false;
+
             switch (e.Action)
             {
                 case GlobalAction.Select:
diff --git a/osu.Game/Screens/Play/HUD/HoldForMenuButton.cs b/osu.Game/Screens/Play/HUD/HoldForMenuButton.cs
index 850543136c..8e0a38aa1f 100644
--- a/osu.Game/Screens/Play/HUD/HoldForMenuButton.cs
+++ b/osu.Game/Screens/Play/HUD/HoldForMenuButton.cs
@@ -208,6 +208,9 @@ namespace osu.Game.Screens.Play.HUD
 
             public bool OnPressed(KeyBindingPressEvent<GlobalAction> e)
             {
+                if (e.Repeat)
+                    return false;
+
                 switch (e.Action)
                 {
                     case GlobalAction.Back:
diff --git a/osu.Game/Screens/Play/HUDOverlay.cs b/osu.Game/Screens/Play/HUDOverlay.cs
index 54c74a7177..b5c4433719 100644
--- a/osu.Game/Screens/Play/HUDOverlay.cs
+++ b/osu.Game/Screens/Play/HUDOverlay.cs
@@ -283,6 +283,9 @@ namespace osu.Game.Screens.Play
 
         public bool OnPressed(KeyBindingPressEvent<GlobalAction> e)
         {
+            if (e.Repeat)
+                return false;
+
             switch (e.Action)
             {
                 case GlobalAction.HoldForHUD:
diff --git a/osu.Game/Screens/Play/HotkeyExitOverlay.cs b/osu.Game/Screens/Play/HotkeyExitOverlay.cs
index 13b72ffaf6..9fe7d17cc7 100644
--- a/osu.Game/Screens/Play/HotkeyExitOverlay.cs
+++ b/osu.Game/Screens/Play/HotkeyExitOverlay.cs
@@ -12,6 +12,9 @@ namespace osu.Game.Screens.Play
     {
         public bool OnPressed(KeyBindingPressEvent<GlobalAction> e)
         {
+            if (e.Repeat)
+                return false;
+
             if (e.Action != GlobalAction.QuickExit) return false;
 
             BeginConfirm();
diff --git a/osu.Game/Screens/Play/HotkeyRetryOverlay.cs b/osu.Game/Screens/Play/HotkeyRetryOverlay.cs
index 308befe372..2812df8bbe 100644
--- a/osu.Game/Screens/Play/HotkeyRetryOverlay.cs
+++ b/osu.Game/Screens/Play/HotkeyRetryOverlay.cs
@@ -12,6 +12,9 @@ namespace osu.Game.Screens.Play
     {
         public bool OnPressed(KeyBindingPressEvent<GlobalAction> e)
         {
+            if (e.Repeat)
+                return false;
+
             if (e.Action != GlobalAction.QuickRetry) return false;
 
             BeginConfirm();
diff --git a/osu.Game/Screens/Play/SkipOverlay.cs b/osu.Game/Screens/Play/SkipOverlay.cs
index c35548c6b4..84d5507dce 100644
--- a/osu.Game/Screens/Play/SkipOverlay.cs
+++ b/osu.Game/Screens/Play/SkipOverlay.cs
@@ -146,6 +146,9 @@ namespace osu.Game.Screens.Play
 
         public bool OnPressed(KeyBindingPressEvent<GlobalAction> e)
         {
+            if (e.Repeat)
+                return false;
+
             switch (e.Action)
             {
                 case GlobalAction.SkipCutscene:
diff --git a/osu.Game/Screens/Ranking/ResultsScreen.cs b/osu.Game/Screens/Ranking/ResultsScreen.cs
index dacc4f5f9e..e43f40e203 100644
--- a/osu.Game/Screens/Ranking/ResultsScreen.cs
+++ b/osu.Game/Screens/Ranking/ResultsScreen.cs
@@ -330,6 +330,9 @@ namespace osu.Game.Screens.Ranking
 
         public bool OnPressed(KeyBindingPressEvent<GlobalAction> e)
         {
+            if (e.Repeat)
+                return false;
+
             switch (e.Action)
             {
                 case GlobalAction.Select:
diff --git a/osu.Game/Screens/Select/SongSelect.cs b/osu.Game/Screens/Select/SongSelect.cs
index aef00a9b00..2c36bf5fc8 100644
--- a/osu.Game/Screens/Select/SongSelect.cs
+++ b/osu.Game/Screens/Select/SongSelect.cs
@@ -821,6 +821,9 @@ 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)

From 7599efac3044cc813abe6ceed8c39f59841e4a76 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 18 Nov 2021 12:36:15 +0900
Subject: [PATCH 1091/5547] Update editor cases where repeat should not be
 handled

---
 .../Screens/Edit/Compose/Components/BlueprintContainer.cs   | 3 +++
 osu.Game/Screens/Edit/Editor.cs                             | 6 ++++++
 2 files changed, 9 insertions(+)

diff --git a/osu.Game/Screens/Edit/Compose/Components/BlueprintContainer.cs b/osu.Game/Screens/Edit/Compose/Components/BlueprintContainer.cs
index 29e3f12d03..130d7a015f 100644
--- a/osu.Game/Screens/Edit/Compose/Components/BlueprintContainer.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/BlueprintContainer.cs
@@ -239,6 +239,9 @@ namespace osu.Game.Screens.Edit.Compose.Components
 
         public bool OnPressed(KeyBindingPressEvent<PlatformAction> e)
         {
+            if (e.Repeat)
+                return false;
+
             switch (e.Action)
             {
                 case PlatformAction.SelectAll:
diff --git a/osu.Game/Screens/Edit/Editor.cs b/osu.Game/Screens/Edit/Editor.cs
index 2a7e2c9cef..94b6e58b67 100644
--- a/osu.Game/Screens/Edit/Editor.cs
+++ b/osu.Game/Screens/Edit/Editor.cs
@@ -393,6 +393,9 @@ namespace osu.Game.Screens.Edit
                     return true;
 
                 case PlatformAction.Save:
+                    if (e.Repeat)
+                        return false;
+
                     Save();
                     return true;
             }
@@ -457,6 +460,9 @@ namespace osu.Game.Screens.Edit
 
         public bool OnPressed(KeyBindingPressEvent<GlobalAction> e)
         {
+            if (e.Repeat)
+                return false;
+
             switch (e.Action)
             {
                 case GlobalAction.Back:

From d7b178ea37225d7618916a534a923dd7aa101588 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 18 Nov 2021 12:36:52 +0900
Subject: [PATCH 1092/5547] Update test scenes which should not handle key
 repeat

---
 osu.Game.Tests/Visual/Gameplay/TestSceneKeyBindings.cs       | 3 +++
 osu.Game.Tests/Visual/Gameplay/TestSceneReplayRecorder.cs    | 3 +++
 osu.Game.Tests/Visual/Gameplay/TestSceneReplayRecording.cs   | 3 +++
 osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorPlayback.cs | 3 +++
 4 files changed, 12 insertions(+)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneKeyBindings.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneKeyBindings.cs
index 883b8a1ae0..70a43fafb5 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneKeyBindings.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneKeyBindings.cs
@@ -83,6 +83,9 @@ namespace osu.Game.Tests.Visual.Gameplay
 
             public bool OnPressed(KeyBindingPressEvent<TestAction> e)
             {
+                if (e.Repeat)
+                    return false;
+
                 ReceivedAction = e.Action == TestAction.Down;
                 return true;
             }
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneReplayRecorder.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneReplayRecorder.cs
index c8040f42f0..159d583fc0 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneReplayRecorder.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneReplayRecorder.cs
@@ -231,6 +231,9 @@ namespace osu.Game.Tests.Visual.Gameplay
 
             public bool OnPressed(KeyBindingPressEvent<TestAction> e)
             {
+                if (e.Repeat)
+                    return false;
+
                 box.Colour = Color4.White;
                 return true;
             }
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneReplayRecording.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneReplayRecording.cs
index 08578168d6..1d4245308d 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneReplayRecording.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneReplayRecording.cs
@@ -164,6 +164,9 @@ namespace osu.Game.Tests.Visual.Gameplay
 
         public bool OnPressed(KeyBindingPressEvent<TestAction> e)
         {
+            if (e.Repeat)
+                return false;
+
             box.Colour = Color4.White;
             return true;
         }
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorPlayback.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorPlayback.cs
index b4de060578..ef870a32a9 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorPlayback.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorPlayback.cs
@@ -283,6 +283,9 @@ namespace osu.Game.Tests.Visual.Gameplay
 
             public bool OnPressed(KeyBindingPressEvent<TestAction> e)
             {
+                if (e.Repeat)
+                    return false;
+
                 box.Colour = Color4.White;
                 return true;
             }

From 66c307e0eecc4842adbdf9c52f0b56ae8bd1768b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 18 Nov 2021 12:38:20 +0900
Subject: [PATCH 1093/5547] Remove usage of key repeat helper method

---
 osu.Game/Extensions/DrawableExtensions.cs     | 27 ---------
 .../Overlays/Volume/VolumeControlReceptor.cs  |  9 ---
 .../UI/Scrolling/DrawableScrollingRuleset.cs  | 11 +---
 .../Lounge/Components/RoomsContainer.cs       | 39 +------------
 osu.Game/Screens/Play/ReplayPlayer.cs         | 17 +-----
 osu.Game/Screens/Select/BeatmapCarousel.cs    | 58 ++-----------------
 6 files changed, 10 insertions(+), 151 deletions(-)

diff --git a/osu.Game/Extensions/DrawableExtensions.cs b/osu.Game/Extensions/DrawableExtensions.cs
index 03cc345947..005804789e 100644
--- a/osu.Game/Extensions/DrawableExtensions.cs
+++ b/osu.Game/Extensions/DrawableExtensions.cs
@@ -1,11 +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 osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
-using osu.Framework.Input.Bindings;
-using osu.Framework.Threading;
 using osu.Game.Screens.Play.HUD;
 using osu.Game.Skinning;
 using osuTK;
@@ -14,30 +11,6 @@ namespace osu.Game.Extensions
 {
     public static class DrawableExtensions
     {
-        public const double REPEAT_INTERVAL = 70;
-        public const double INITIAL_DELAY = 250;
-
-        /// <summary>
-        /// Helper method that is used while <see cref="IKeyBindingHandler"/> doesn't support repetitions of <see cref="IKeyBindingHandler{T}.OnPressed"/>.
-        /// Simulates repetitions by continually invoking a delegate according to the default key repeat rate.
-        /// </summary>
-        /// <remarks>
-        /// The returned delegate can be cancelled to stop repeat events from firing (usually in <see cref="IKeyBindingHandler{T}.OnReleased"/>).
-        /// </remarks>
-        /// <param name="handler">The <see cref="IKeyBindingHandler{T}"/> which is handling the repeat.</param>
-        /// <param name="scheduler">The <see cref="Scheduler"/> to schedule repetitions on.</param>
-        /// <param name="action">The <see cref="Action"/> to be invoked once immediately and with every repetition.</param>
-        /// <param name="initialRepeatDelay">The delay imposed on the first repeat. Defaults to <see cref="INITIAL_DELAY"/>.</param>
-        /// <returns>A <see cref="ScheduledDelegate"/> which can be cancelled to stop the repeat events from firing.</returns>
-        public static ScheduledDelegate BeginKeyRepeat(this IKeyBindingHandler handler, Scheduler scheduler, Action action, double initialRepeatDelay = INITIAL_DELAY)
-        {
-            action();
-
-            ScheduledDelegate repeatDelegate = new ScheduledDelegate(action, handler.Time.Current + initialRepeatDelay, REPEAT_INTERVAL);
-            scheduler.Add(repeatDelegate);
-            return repeatDelegate;
-        }
-
         /// <summary>
         /// Shakes this drawable.
         /// </summary>
diff --git a/osu.Game/Overlays/Volume/VolumeControlReceptor.cs b/osu.Game/Overlays/Volume/VolumeControlReceptor.cs
index 4129b46ce3..c601ce4130 100644
--- a/osu.Game/Overlays/Volume/VolumeControlReceptor.cs
+++ b/osu.Game/Overlays/Volume/VolumeControlReceptor.cs
@@ -6,8 +6,6 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Input;
 using osu.Framework.Input.Bindings;
 using osu.Framework.Input.Events;
-using osu.Framework.Threading;
-using osu.Game.Extensions;
 using osu.Game.Input.Bindings;
 
 namespace osu.Game.Overlays.Volume
@@ -17,18 +15,12 @@ namespace osu.Game.Overlays.Volume
         public Func<GlobalAction, bool> ActionRequested;
         public Func<GlobalAction, float, bool, bool> ScrollActionRequested;
 
-        private ScheduledDelegate keyRepeat;
-
         public bool OnPressed(KeyBindingPressEvent<GlobalAction> e)
         {
             switch (e.Action)
             {
                 case GlobalAction.DecreaseVolume:
                 case GlobalAction.IncreaseVolume:
-                    keyRepeat?.Cancel();
-                    keyRepeat = this.BeginKeyRepeat(Scheduler, () => ActionRequested?.Invoke(e.Action), 150);
-                    return true;
-
                 case GlobalAction.ToggleMute:
                 case GlobalAction.NextVolumeMeter:
                 case GlobalAction.PreviousVolumeMeter:
@@ -41,7 +33,6 @@ namespace osu.Game.Overlays.Volume
 
         public void OnReleased(KeyBindingReleaseEvent<GlobalAction> e)
         {
-            keyRepeat?.Cancel();
         }
 
         protected override bool OnScroll(ScrollEvent e)
diff --git a/osu.Game/Rulesets/UI/Scrolling/DrawableScrollingRuleset.cs b/osu.Game/Rulesets/UI/Scrolling/DrawableScrollingRuleset.cs
index 2a9d3d1cf0..1f3a937311 100644
--- a/osu.Game/Rulesets/UI/Scrolling/DrawableScrollingRuleset.cs
+++ b/osu.Game/Rulesets/UI/Scrolling/DrawableScrollingRuleset.cs
@@ -14,7 +14,6 @@ using osu.Framework.Threading;
 using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.ControlPoints;
 using osu.Game.Configuration;
-using osu.Game.Extensions;
 using osu.Game.Input.Bindings;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Objects;
@@ -204,11 +203,11 @@ namespace osu.Game.Rulesets.UI.Scrolling
             switch (e.Action)
             {
                 case GlobalAction.IncreaseScrollSpeed:
-                    scheduleScrollSpeedAdjustment(1);
+                    AdjustScrollSpeed(1);
                     return true;
 
                 case GlobalAction.DecreaseScrollSpeed:
-                    scheduleScrollSpeedAdjustment(-1);
+                    AdjustScrollSpeed(-1);
                     return true;
             }
 
@@ -223,12 +222,6 @@ namespace osu.Game.Rulesets.UI.Scrolling
             scheduledScrollSpeedAdjustment = null;
         }
 
-        private void scheduleScrollSpeedAdjustment(int amount)
-        {
-            scheduledScrollSpeedAdjustment?.Cancel();
-            scheduledScrollSpeedAdjustment = this.BeginKeyRepeat(Scheduler, () => AdjustScrollSpeed(amount));
-        }
-
         private class LocalScrollingInfo : IScrollingInfo
         {
             public IBindable<ScrollingDirection> Direction { get; } = new Bindable<ScrollingDirection>();
diff --git a/osu.Game/Screens/OnlinePlay/Lounge/Components/RoomsContainer.cs b/osu.Game/Screens/OnlinePlay/Lounge/Components/RoomsContainer.cs
index 32ae7cf859..54c762b8ce 100644
--- a/osu.Game/Screens/OnlinePlay/Lounge/Components/RoomsContainer.cs
+++ b/osu.Game/Screens/OnlinePlay/Lounge/Components/RoomsContainer.cs
@@ -12,7 +12,6 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Input.Bindings;
 using osu.Framework.Input.Events;
-using osu.Framework.Threading;
 using osu.Game.Extensions;
 using osu.Game.Graphics.Cursor;
 using osu.Game.Input.Bindings;
@@ -146,11 +145,11 @@ namespace osu.Game.Screens.OnlinePlay.Lounge.Components
             switch (e.Action)
             {
                 case GlobalAction.SelectNext:
-                    beginRepeatSelection(() => selectNext(1), e.Action);
+                    selectNext(1);
                     return true;
 
                 case GlobalAction.SelectPrevious:
-                    beginRepeatSelection(() => selectNext(-1), e.Action);
+                    selectNext(-1);
                     return true;
             }
 
@@ -159,40 +158,6 @@ namespace osu.Game.Screens.OnlinePlay.Lounge.Components
 
         public void OnReleased(KeyBindingReleaseEvent<GlobalAction> e)
         {
-            switch (e.Action)
-            {
-                case GlobalAction.SelectNext:
-                case GlobalAction.SelectPrevious:
-                    endRepeatSelection(e.Action);
-                    break;
-            }
-        }
-
-        private ScheduledDelegate repeatDelegate;
-        private object lastRepeatSource;
-
-        /// <summary>
-        /// Begin repeating the specified selection action.
-        /// </summary>
-        /// <param name="action">The action to perform.</param>
-        /// <param name="source">The source of the action. Used in conjunction with <see cref="endRepeatSelection"/> to only cancel the correct action (most recently pressed key).</param>
-        private void beginRepeatSelection(Action action, object source)
-        {
-            endRepeatSelection();
-
-            lastRepeatSource = source;
-            repeatDelegate = this.BeginKeyRepeat(Scheduler, action);
-        }
-
-        private void endRepeatSelection(object source = null)
-        {
-            // only the most recent source should be able to cancel the current action.
-            if (source != null && !EqualityComparer<object>.Default.Equals(lastRepeatSource, source))
-                return;
-
-            repeatDelegate?.Cancel();
-            repeatDelegate = null;
-            lastRepeatSource = null;
         }
 
         private void selectNext(int direction)
diff --git a/osu.Game/Screens/Play/ReplayPlayer.cs b/osu.Game/Screens/Play/ReplayPlayer.cs
index 93054b7bb5..617374b4fd 100644
--- a/osu.Game/Screens/Play/ReplayPlayer.cs
+++ b/osu.Game/Screens/Play/ReplayPlayer.cs
@@ -7,9 +7,7 @@ using System.Linq;
 using System.Threading.Tasks;
 using osu.Framework.Input.Bindings;
 using osu.Framework.Input.Events;
-using osu.Framework.Threading;
 using osu.Game.Beatmaps;
-using osu.Game.Extensions;
 using osu.Game.Input.Bindings;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Objects;
@@ -48,8 +46,6 @@ namespace osu.Game.Screens.Play
 
         protected override ResultsScreen CreateResults(ScoreInfo score) => new SoloResultsScreen(score, false);
 
-        private ScheduledDelegate keyboardSeekDelegate;
-
         public bool OnPressed(KeyBindingPressEvent<GlobalAction> e)
         {
             const double keyboard_seek_amount = 5000;
@@ -57,13 +53,11 @@ namespace osu.Game.Screens.Play
             switch (e.Action)
             {
                 case GlobalAction.SeekReplayBackward:
-                    keyboardSeekDelegate?.Cancel();
-                    keyboardSeekDelegate = this.BeginKeyRepeat(Scheduler, () => keyboardSeek(-1));
+                    keyboardSeek(-1);
                     return true;
 
                 case GlobalAction.SeekReplayForward:
-                    keyboardSeekDelegate?.Cancel();
-                    keyboardSeekDelegate = this.BeginKeyRepeat(Scheduler, () => keyboardSeek(1));
+                    keyboardSeek(1);
                     return true;
 
                 case GlobalAction.TogglePauseReplay:
@@ -86,13 +80,6 @@ namespace osu.Game.Screens.Play
 
         public void OnReleased(KeyBindingReleaseEvent<GlobalAction> e)
         {
-            switch (e.Action)
-            {
-                case GlobalAction.SeekReplayBackward:
-                case GlobalAction.SeekReplayForward:
-                    keyboardSeekDelegate?.Cancel();
-                    break;
-            }
         }
     }
 }
diff --git a/osu.Game/Screens/Select/BeatmapCarousel.cs b/osu.Game/Screens/Select/BeatmapCarousel.cs
index 0c593ebea1..0fc7a99c96 100644
--- a/osu.Game/Screens/Select/BeatmapCarousel.cs
+++ b/osu.Game/Screens/Select/BeatmapCarousel.cs
@@ -18,7 +18,6 @@ using osu.Framework.Threading;
 using osu.Framework.Utils;
 using osu.Game.Beatmaps;
 using osu.Game.Configuration;
-using osu.Game.Extensions;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Cursor;
 using osu.Game.Input.Bindings;
@@ -479,42 +478,27 @@ namespace osu.Game.Screens.Select
             switch (e.Key)
             {
                 case Key.Left:
-                    if (!e.Repeat)
-                        beginRepeatSelection(() => SelectNext(-1), e.Key);
+                    SelectNext(-1);
                     return true;
 
                 case Key.Right:
-                    if (!e.Repeat)
-                        beginRepeatSelection(() => SelectNext(), e.Key);
+                    SelectNext();
                     return true;
             }
 
             return false;
         }
 
-        protected override void OnKeyUp(KeyUpEvent e)
-        {
-            switch (e.Key)
-            {
-                case Key.Left:
-                case Key.Right:
-                    endRepeatSelection(e.Key);
-                    break;
-            }
-
-            base.OnKeyUp(e);
-        }
-
         public bool OnPressed(KeyBindingPressEvent<GlobalAction> e)
         {
             switch (e.Action)
             {
                 case GlobalAction.SelectNext:
-                    beginRepeatSelection(() => SelectNext(1, false), e.Action);
+                    SelectNext(1, false);
                     return true;
 
                 case GlobalAction.SelectPrevious:
-                    beginRepeatSelection(() => SelectNext(-1, false), e.Action);
+                    SelectNext(-1, false);
                     return true;
             }
 
@@ -523,40 +507,6 @@ namespace osu.Game.Screens.Select
 
         public void OnReleased(KeyBindingReleaseEvent<GlobalAction> e)
         {
-            switch (e.Action)
-            {
-                case GlobalAction.SelectNext:
-                case GlobalAction.SelectPrevious:
-                    endRepeatSelection(e.Action);
-                    break;
-            }
-        }
-
-        private ScheduledDelegate repeatDelegate;
-        private object lastRepeatSource;
-
-        /// <summary>
-        /// Begin repeating the specified selection action.
-        /// </summary>
-        /// <param name="action">The action to perform.</param>
-        /// <param name="source">The source of the action. Used in conjunction with <see cref="endRepeatSelection"/> to only cancel the correct action (most recently pressed key).</param>
-        private void beginRepeatSelection(Action action, object source)
-        {
-            endRepeatSelection();
-
-            lastRepeatSource = source;
-            repeatDelegate = this.BeginKeyRepeat(Scheduler, action);
-        }
-
-        private void endRepeatSelection(object source = null)
-        {
-            // only the most recent source should be able to cancel the current action.
-            if (source != null && !EqualityComparer<object>.Default.Equals(lastRepeatSource, source))
-                return;
-
-            repeatDelegate?.Cancel();
-            repeatDelegate = null;
-            lastRepeatSource = null;
         }
 
         #endregion

From cdb2a92f865c9a85a010e1010073b21c9392f120 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 18 Nov 2021 12:57:51 +0900
Subject: [PATCH 1094/5547] Disable key repeat for all ruleset handling cases

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

diff --git a/osu.Game/Rulesets/UI/RulesetInputManager.cs b/osu.Game/Rulesets/UI/RulesetInputManager.cs
index a3f311c7a6..6564ff9e23 100644
--- a/osu.Game/Rulesets/UI/RulesetInputManager.cs
+++ b/osu.Game/Rulesets/UI/RulesetInputManager.cs
@@ -168,6 +168,8 @@ namespace osu.Game.Rulesets.UI
 
         public class RulesetKeyBindingContainer : DatabasedKeyBindingContainer<T>
         {
+            protected override bool HandleRepeats => false;
+
             public RulesetKeyBindingContainer(RulesetInfo ruleset, int variant, SimultaneousBindingMode unique)
                 : base(ruleset, variant, unique)
             {

From db4e4c982c879e3f5f60b3b8d09fb82022a9a043 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 18 Nov 2021 13:35:42 +0900
Subject: [PATCH 1095/5547] Add hover effect to supporter button

---
 .../Profile/Header/Components/SupporterIcon.cs | 18 +++++++++++++++++-
 1 file changed, 17 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/Profile/Header/Components/SupporterIcon.cs b/osu.Game/Overlays/Profile/Header/Components/SupporterIcon.cs
index bee3548008..f450754c02 100644
--- a/osu.Game/Overlays/Profile/Header/Components/SupporterIcon.cs
+++ b/osu.Game/Overlays/Profile/Header/Components/SupporterIcon.cs
@@ -7,6 +7,7 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Graphics.Sprites;
+using osu.Framework.Input.Events;
 using osu.Framework.Localisation;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
@@ -78,12 +79,27 @@ namespace osu.Game.Overlays.Profile.Header.Components
             };
         }
 
+        [Resolved]
+        private OsuColour colours { get; set; }
+
         [BackgroundDependencyLoader(true)]
-        private void load(OsuColour colours, OsuGame game)
+        private void load(OsuGame game)
         {
             background.Colour = colours.Pink;
 
             Action = () => game?.OpenUrlExternally(@"/home/support");
         }
+
+        protected override bool OnHover(HoverEvent e)
+        {
+            background.FadeColour(colours.PinkLight, 500, Easing.OutQuint);
+            return base.OnHover(e);
+        }
+
+        protected override void OnHoverLost(HoverLostEvent e)
+        {
+            background.FadeColour(colours.Pink, 500, Easing.OutQuint);
+            base.OnHoverLost(e);
+        }
     }
 }

From 9ec6ecd3f6cf9fc147d910efaa6f670cd2bba98e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 18 Nov 2021 13:39:25 +0900
Subject: [PATCH 1096/5547] Update framework

---
 osu.Android.props        | 2 +-
 osu.Game/osu.Game.csproj | 2 +-
 osu.iOS.props            | 4 ++--
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Android.props b/osu.Android.props
index f7b7b6fb23..cbd1c92fbe 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -52,7 +52,7 @@
   </ItemGroup>
   <ItemGroup>
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1112.0" />
-    <PackageReference Include="ppy.osu.Framework.Android" Version="2021.1108.0" />
+    <PackageReference Include="ppy.osu.Framework.Android" Version="2021.1118.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
     <!-- Realm needs to be directly referenced in all Xamarin projects, as it will not pull in its transitive dependencies otherwise. -->
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 93fb729f46..6b722f00ea 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="10.6.0" />
-    <PackageReference Include="ppy.osu.Framework" Version="2021.1108.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2021.1118.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1112.0" />
     <PackageReference Include="Sentry" Version="3.10.0" />
     <PackageReference Include="SharpCompress" Version="0.30.0" />
diff --git a/osu.iOS.props b/osu.iOS.props
index 3a2a3fd65e..00cbe2c849 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -70,7 +70,7 @@
     <Reference Include="System.Net.Http" />
   </ItemGroup>
   <ItemGroup Label="Package References">
-    <PackageReference Include="ppy.osu.Framework.iOS" Version="2021.1108.0" />
+    <PackageReference Include="ppy.osu.Framework.iOS" Version="2021.1118.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1112.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net5.0 / net6.0) -->
@@ -93,7 +93,7 @@
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="2.2.6" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.Core" Version="2.2.6" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
-    <PackageReference Include="ppy.osu.Framework" Version="2021.1108.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2021.1118.0" />
     <PackageReference Include="SharpCompress" Version="0.30.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
     <PackageReference Include="SharpRaven" Version="2.4.0" />

From a09589f8339f39e19edc3c5c62ee765cbabc430f Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Wed, 17 Nov 2021 23:15:51 -0800
Subject: [PATCH 1097/5547] Fix score panels sometimes jumping when toggling
 statistics fast

---
 osu.Game/Screens/Ranking/ResultsScreen.cs | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Screens/Ranking/ResultsScreen.cs b/osu.Game/Screens/Ranking/ResultsScreen.cs
index e43f40e203..cb842ce4a0 100644
--- a/osu.Game/Screens/Ranking/ResultsScreen.cs
+++ b/osu.Game/Screens/Ranking/ResultsScreen.cs
@@ -311,10 +311,10 @@ namespace osu.Game.Screens.Ranking
                 ScorePanelList.Attach(detachedPanel);
 
                 // Move into its original location in the attached container first, then to the final location.
-                var origLocation = detachedPanel.Parent.ToLocalSpace(screenSpacePos);
-                detachedPanel.MoveTo(origLocation)
+                float origLocation = detachedPanel.Parent.ToLocalSpace(screenSpacePos).X;
+                detachedPanel.MoveToX(origLocation)
                              .Then()
-                             .MoveTo(new Vector2(0, origLocation.Y), 150, Easing.OutQuint);
+                             .MoveToX(0, 150, Easing.OutQuint);
 
                 // Show contracted panels.
                 foreach (var contracted in ScorePanelList.GetScorePanels().Where(p => p.State == PanelState.Contracted))

From 4c5599295cd9462167b402ea4f5d2742d35c9544 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Mon, 15 Nov 2021 12:20:57 +0300
Subject: [PATCH 1098/5547] Update more obsolete usages

---
 osu.Game.Rulesets.Catch.Tests.iOS/Application.cs | 3 ++-
 osu.Game.Rulesets.Mania.Tests.iOS/Application.cs | 3 ++-
 osu.Game.Rulesets.Osu.Tests.iOS/Application.cs   | 3 ++-
 osu.Game.Rulesets.Taiko.Tests.iOS/Application.cs | 3 ++-
 osu.Game.Tests.iOS/Application.cs                | 3 ++-
 5 files changed, 10 insertions(+), 5 deletions(-)

diff --git a/osu.Game.Rulesets.Catch.Tests.iOS/Application.cs b/osu.Game.Rulesets.Catch.Tests.iOS/Application.cs
index f7f07ef938..e44868e133 100644
--- a/osu.Game.Rulesets.Catch.Tests.iOS/Application.cs
+++ b/osu.Game.Rulesets.Catch.Tests.iOS/Application.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.iOS;
 using UIKit;
 
 namespace osu.Game.Rulesets.Catch.Tests.iOS
@@ -9,7 +10,7 @@ namespace osu.Game.Rulesets.Catch.Tests.iOS
     {
         public static void Main(string[] args)
         {
-            UIApplication.Main(args, "GameUIApplication", "AppDelegate");
+            UIApplication.Main(args, typeof(GameUIApplication), typeof(AppDelegate));
         }
     }
 }
diff --git a/osu.Game.Rulesets.Mania.Tests.iOS/Application.cs b/osu.Game.Rulesets.Mania.Tests.iOS/Application.cs
index c381ea585d..ec3db17e97 100644
--- a/osu.Game.Rulesets.Mania.Tests.iOS/Application.cs
+++ b/osu.Game.Rulesets.Mania.Tests.iOS/Application.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.iOS;
 using UIKit;
 
 namespace osu.Game.Rulesets.Mania.Tests.iOS
@@ -9,7 +10,7 @@ namespace osu.Game.Rulesets.Mania.Tests.iOS
     {
         public static void Main(string[] args)
         {
-            UIApplication.Main(args, "GameUIApplication", "AppDelegate");
+            UIApplication.Main(args, typeof(GameUIApplication), typeof(AppDelegate));
         }
     }
 }
diff --git a/osu.Game.Rulesets.Osu.Tests.iOS/Application.cs b/osu.Game.Rulesets.Osu.Tests.iOS/Application.cs
index b36d0b5728..be38a883d7 100644
--- a/osu.Game.Rulesets.Osu.Tests.iOS/Application.cs
+++ b/osu.Game.Rulesets.Osu.Tests.iOS/Application.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.iOS;
 using UIKit;
 
 namespace osu.Game.Rulesets.Osu.Tests.iOS
@@ -9,7 +10,7 @@ namespace osu.Game.Rulesets.Osu.Tests.iOS
     {
         public static void Main(string[] args)
         {
-            UIApplication.Main(args, "GameUIApplication", "AppDelegate");
+            UIApplication.Main(args, typeof(GameUIApplication), typeof(AppDelegate));
         }
     }
 }
diff --git a/osu.Game.Rulesets.Taiko.Tests.iOS/Application.cs b/osu.Game.Rulesets.Taiko.Tests.iOS/Application.cs
index 73faf16d9f..9fde65a074 100644
--- a/osu.Game.Rulesets.Taiko.Tests.iOS/Application.cs
+++ b/osu.Game.Rulesets.Taiko.Tests.iOS/Application.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.iOS;
 using UIKit;
 
 namespace osu.Game.Rulesets.Taiko.Tests.iOS
@@ -9,7 +10,7 @@ namespace osu.Game.Rulesets.Taiko.Tests.iOS
     {
         public static void Main(string[] args)
         {
-            UIApplication.Main(args, "GameUIApplication", "AppDelegate");
+            UIApplication.Main(args, typeof(GameUIApplication), typeof(AppDelegate));
         }
     }
 }
diff --git a/osu.Game.Tests.iOS/Application.cs b/osu.Game.Tests.iOS/Application.cs
index 9533b90131..585b495c96 100644
--- a/osu.Game.Tests.iOS/Application.cs
+++ b/osu.Game.Tests.iOS/Application.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.iOS;
 using UIKit;
 
 namespace osu.Game.Tests.iOS
@@ -9,7 +10,7 @@ namespace osu.Game.Tests.iOS
     {
         public static void Main(string[] args)
         {
-            UIApplication.Main(args, "GameUIApplication", "AppDelegate");
+            UIApplication.Main(args, typeof(GameUIApplication), typeof(AppDelegate));
         }
     }
 }

From bf8507c7b92dad894becf3d4eb41443cdff9ee5e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 18 Nov 2021 23:26:45 +0900
Subject: [PATCH 1099/5547] Only apply default timeout when debugger not
 attached

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

diff --git a/osu.Game/Beatmaps/WorkingBeatmap.cs b/osu.Game/Beatmaps/WorkingBeatmap.cs
index f46cd405b5..d2912229c6 100644
--- a/osu.Game/Beatmaps/WorkingBeatmap.cs
+++ b/osu.Game/Beatmaps/WorkingBeatmap.cs
@@ -3,6 +3,7 @@
 
 using System;
 using System.Collections.Generic;
+using System.Diagnostics;
 using System.IO;
 using System.Linq;
 using System.Threading;
@@ -80,7 +81,10 @@ namespace osu.Game.Beatmaps
 
         public virtual IBeatmap GetPlayableBeatmap(IRulesetInfo ruleset, IReadOnlyList<Mod> mods = null, CancellationToken? cancellationToken = null)
         {
-            var token = cancellationToken ?? new CancellationTokenSource(10000).Token;
+            var token = cancellationToken ??
+                        // don't apply the default timeout when debugger is attached (may be breakpointing / debugging).
+                        (Debugger.IsAttached ? new CancellationToken() : new CancellationTokenSource(10000).Token);
+
             mods ??= Array.Empty<Mod>();
 
             var rulesetInstance = ruleset.CreateInstance();

From 95891bc6550180c5a3959ebcb3122a8712e8da2d Mon Sep 17 00:00:00 2001
From: Darius Wattimena <dariuswattimena@hotmail.com>
Date: Thu, 18 Nov 2021 20:03:41 +0100
Subject: [PATCH 1100/5547] Moved clear plate logic to Catcher class

---
 osu.Game.Rulesets.Catch/UI/Catcher.cs     |  9 +++++++++
 osu.Game.Rulesets.Catch/UI/CatcherArea.cs | 13 -------------
 2 files changed, 9 insertions(+), 13 deletions(-)

diff --git a/osu.Game.Rulesets.Catch/UI/Catcher.cs b/osu.Game.Rulesets.Catch/UI/Catcher.cs
index 2a13190cc5..0b041da076 100644
--- a/osu.Game.Rulesets.Catch/UI/Catcher.cs
+++ b/osu.Game.Rulesets.Catch/UI/Catcher.cs
@@ -210,8 +210,17 @@ namespace osu.Game.Rulesets.Catch.UI
             catchResult.CatcherAnimationState = CurrentState;
             catchResult.CatcherHyperDash = HyperDashing;
 
+            // Ignore JuiceStreams and BananaShowers
             if (!(drawableObject is DrawablePalpableCatchHitObject palpableObject)) return;
 
+            if (palpableObject.HitObject.LastInCombo)
+            {
+                if (result.Judgement is CatchJudgement catchJudgement && catchJudgement.ShouldExplodeFor(result))
+                    Explode();
+                else
+                    Drop();
+            }
+
             var hitObject = palpableObject.HitObject;
 
             if (result.IsHit)
diff --git a/osu.Game.Rulesets.Catch/UI/CatcherArea.cs b/osu.Game.Rulesets.Catch/UI/CatcherArea.cs
index 0cbabac911..37002d1051 100644
--- a/osu.Game.Rulesets.Catch/UI/CatcherArea.cs
+++ b/osu.Game.Rulesets.Catch/UI/CatcherArea.cs
@@ -6,7 +6,6 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Input.Bindings;
 using osu.Framework.Input.Events;
-using osu.Game.Rulesets.Catch.Judgements;
 using osu.Game.Rulesets.Catch.Objects.Drawables;
 using osu.Game.Rulesets.Catch.Replays;
 using osu.Game.Rulesets.Judgements;
@@ -71,18 +70,6 @@ namespace osu.Game.Rulesets.Catch.UI
         public void OnNewResult(DrawableCatchHitObject hitObject, JudgementResult result)
         {
             Catcher.OnNewResult(hitObject, result);
-
-            // Ignore JuiceStreams and BananaShowers
-            if (!(hitObject is DrawablePalpableCatchHitObject)) return;
-
-            if (hitObject.HitObject.LastInCombo)
-            {
-                if (result.Judgement is CatchJudgement catchJudgement && catchJudgement.ShouldExplodeFor(result))
-                    Catcher.Explode();
-                else
-                    Catcher.Drop();
-            }
-
             comboDisplay.OnNewResult(hitObject, result);
         }
 

From cfedbb92c1ad6bb4ee58cf54fd7654d827da5be2 Mon Sep 17 00:00:00 2001
From: Darius Wattimena <dariuswattimena@hotmail.com>
Date: Thu, 18 Nov 2021 20:07:03 +0100
Subject: [PATCH 1101/5547] Added a unit test to cover clearing of the plate
 when missing the last banana

---
 osu.Game.Rulesets.Catch.Tests/TestSceneCatcher.cs | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/osu.Game.Rulesets.Catch.Tests/TestSceneCatcher.cs b/osu.Game.Rulesets.Catch.Tests/TestSceneCatcher.cs
index 29a7b03ad3..bc94b50301 100644
--- a/osu.Game.Rulesets.Catch.Tests/TestSceneCatcher.cs
+++ b/osu.Game.Rulesets.Catch.Tests/TestSceneCatcher.cs
@@ -168,6 +168,17 @@ namespace osu.Game.Rulesets.Catch.Tests
             checkHyperDash(false);
         }
 
+        [Test]
+        public void TestLastBananaShouldClearPlate()
+        {
+            AddStep("catch fruit", () => attemptCatch(new Fruit()));
+            checkPlate(1);
+            AddStep("miss banana", () => attemptCatch(new Banana { X = 100 }));
+            checkPlate(1);
+            AddStep("miss last banana", () => attemptCatch(new Banana { LastInCombo = true, X = 100 }));
+            checkPlate(0);
+        }
+
         [Test]
         public void TestCatcherRandomStacking()
         {

From 9685892b946c36f3f2ba4eadd0ed49b0834c4444 Mon Sep 17 00:00:00 2001
From: Darius Wattimena <dariuswattimena@hotmail.com>
Date: Thu, 18 Nov 2021 20:23:42 +0100
Subject: [PATCH 1102/5547] Added an extra unit test when actually catching the
 last banana to also clear the plate

---
 osu.Game.Rulesets.Catch.Tests/TestSceneCatcher.cs | 13 ++++++++++++-
 1 file changed, 12 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Catch.Tests/TestSceneCatcher.cs b/osu.Game.Rulesets.Catch.Tests/TestSceneCatcher.cs
index bc94b50301..4f527e9a0f 100644
--- a/osu.Game.Rulesets.Catch.Tests/TestSceneCatcher.cs
+++ b/osu.Game.Rulesets.Catch.Tests/TestSceneCatcher.cs
@@ -169,7 +169,7 @@ namespace osu.Game.Rulesets.Catch.Tests
         }
 
         [Test]
-        public void TestLastBananaShouldClearPlate()
+        public void TestLastBananaShouldClearPlateOnMiss()
         {
             AddStep("catch fruit", () => attemptCatch(new Fruit()));
             checkPlate(1);
@@ -179,6 +179,17 @@ namespace osu.Game.Rulesets.Catch.Tests
             checkPlate(0);
         }
 
+        [Test]
+        public void TestLastBananaShouldClearPlateOnCatch()
+        {
+            AddStep("catch fruit", () => attemptCatch(new Fruit()));
+            checkPlate(1);
+            AddStep("catch banana", () => attemptCatch(new Banana()));
+            checkPlate(2);
+            AddStep("catch last banana", () => attemptCatch(new Banana { LastInCombo = true }));
+            checkPlate(0);
+        }
+
         [Test]
         public void TestCatcherRandomStacking()
         {

From 38edeac71031aff9aaf6f1559d8407a6a396c1d3 Mon Sep 17 00:00:00 2001
From: Darius Wattimena <dariuswattimena@hotmail.com>
Date: Thu, 18 Nov 2021 20:24:40 +0100
Subject: [PATCH 1103/5547] Moved the logic to the bottom as placeCaughtObject
 is otherwise not called yet

---
 osu.Game.Rulesets.Catch/UI/Catcher.cs | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/osu.Game.Rulesets.Catch/UI/Catcher.cs b/osu.Game.Rulesets.Catch/UI/Catcher.cs
index 0b041da076..04708c8796 100644
--- a/osu.Game.Rulesets.Catch/UI/Catcher.cs
+++ b/osu.Game.Rulesets.Catch/UI/Catcher.cs
@@ -213,14 +213,6 @@ namespace osu.Game.Rulesets.Catch.UI
             // Ignore JuiceStreams and BananaShowers
             if (!(drawableObject is DrawablePalpableCatchHitObject palpableObject)) return;
 
-            if (palpableObject.HitObject.LastInCombo)
-            {
-                if (result.Judgement is CatchJudgement catchJudgement && catchJudgement.ShouldExplodeFor(result))
-                    Explode();
-                else
-                    Drop();
-            }
-
             var hitObject = palpableObject.HitObject;
 
             if (result.IsHit)
@@ -253,6 +245,14 @@ namespace osu.Game.Rulesets.Catch.UI
                 CurrentState = hitObject.Kiai ? CatcherAnimationState.Kiai : CatcherAnimationState.Idle;
             else if (!(hitObject is Banana))
                 CurrentState = CatcherAnimationState.Fail;
+
+            if (palpableObject.HitObject.LastInCombo)
+            {
+                if (result.Judgement is CatchJudgement catchJudgement && catchJudgement.ShouldExplodeFor(result))
+                    Explode();
+                else
+                    Drop();
+            }
         }
 
         public void OnRevertResult(DrawableCatchHitObject drawableObject, JudgementResult result)

From 761d1e45f24e6b0fc2286e491c0b8fe62d998bd2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 13 Nov 2021 15:40:47 +0100
Subject: [PATCH 1104/5547] Use lime background on right side of card to
 signify downloaded sets

---
 .../Beatmaps/Drawables/Cards/BeatmapCard.cs   | 30 ++++++++++++++-----
 1 file changed, 23 insertions(+), 7 deletions(-)

diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
index 23009cda5e..8bc234ec84 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
@@ -35,6 +35,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
         private const float width = 408;
         private const float height = 100;
         private const float corner_radius = 10;
+        private const float icon_area_width = 30;
 
         private readonly APIBeatmapSet beatmapSet;
         private readonly Bindable<BeatmapSetFavouriteState> favouriteState;
@@ -45,7 +46,8 @@ namespace osu.Game.Beatmaps.Drawables.Cards
         private UpdateableOnlineBeatmapSetCover leftCover;
         private FillFlowContainer leftIconArea;
 
-        private Container rightButtonArea;
+        private Container rightAreaBackground;
+        private Container rightAreaButtons;
 
         private Container mainContent;
         private BeatmapCardContentBackground mainContentBackground;
@@ -57,6 +59,9 @@ namespace osu.Game.Beatmaps.Drawables.Cards
         private FillFlowContainer idleBottomContent;
         private BeatmapCardDownloadProgressBar downloadProgressBar;
 
+        [Resolved]
+        private OsuColour colours { get; set; }
+
         [Resolved]
         private OverlayColourProvider colourProvider { get; set; }
 
@@ -79,10 +84,20 @@ namespace osu.Game.Beatmaps.Drawables.Cards
             InternalChildren = new Drawable[]
             {
                 downloadTracker,
-                new Box
+                rightAreaBackground = new Container
                 {
-                    RelativeSizeAxes = Axes.Both,
-                    Colour = colourProvider.Background3
+                    RelativeSizeAxes = Axes.Y,
+                    Width = icon_area_width + 2 * corner_radius,
+                    Anchor = Anchor.CentreRight,
+                    Origin = Anchor.CentreRight,
+                    // workaround for masking artifacts at the top & bottom of card,
+                    // which become especially visible on downloaded beatmaps (when the icon area has a lime background).
+                    Padding = new MarginPadding { Vertical = 1 },
+                    Child = new Box
+                    {
+                        RelativeSizeAxes = Axes.Both,
+                        Colour = Colour4.White
+                    },
                 },
                 new Container
                 {
@@ -104,7 +119,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                         }
                     }
                 },
-                rightButtonArea = new Container
+                rightAreaButtons = new Container
                 {
                     Name = @"Right (button) area",
                     Width = 30,
@@ -364,15 +379,16 @@ namespace osu.Game.Beatmaps.Drawables.Cards
         {
             float targetWidth = width - height;
             if (IsHovered)
-                targetWidth -= 20;
+                targetWidth = targetWidth - icon_area_width + corner_radius;
 
             mainContent.ResizeWidthTo(targetWidth, TRANSITION_DURATION, Easing.OutQuint);
             mainContentBackground.Dimmed.Value = IsHovered;
 
             leftCover.FadeColour(IsHovered ? OsuColour.Gray(0.2f) : Color4.White, TRANSITION_DURATION, Easing.OutQuint);
             statisticsContainer.FadeTo(IsHovered ? 1 : 0, TRANSITION_DURATION, Easing.OutQuint);
-            rightButtonArea.FadeTo(IsHovered ? 1 : 0, TRANSITION_DURATION, Easing.OutQuint);
 
+            rightAreaBackground.FadeColour(downloadTracker.State.Value == DownloadState.LocallyAvailable ? colours.Lime0 : colourProvider.Background3, TRANSITION_DURATION, Easing.OutQuint);
+            rightAreaButtons.FadeTo(IsHovered ? 1 : 0, TRANSITION_DURATION, Easing.OutQuint);
             bool showProgress = downloadTracker.State.Value == DownloadState.Downloading || downloadTracker.State.Value == DownloadState.Importing;
 
             idleBottomContent.FadeTo(showProgress ? 0 : 1, TRANSITION_DURATION, Easing.OutQuint);

From 412abf30d92531a0054f2e53d45ea8052a3c650c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 18 Nov 2021 22:28:17 +0100
Subject: [PATCH 1105/5547] Refactor buttons again to work with latest design
 guidelines

---
 .../TestSceneBeatmapCardDownloadButton.cs     | 129 +++---------------
 .../Beatmaps/Drawables/Cards/BeatmapCard.cs   |  39 ++++--
 .../Cards/Buttons/BeatmapCardIconButton.cs    |  71 ++++++++--
 .../Drawables/Cards/Buttons/DownloadButton.cs | 112 ++++-----------
 .../Drawables/Cards/Buttons/PlayButton.cs     |  50 +++++++
 5 files changed, 179 insertions(+), 222 deletions(-)
 create mode 100644 osu.Game/Beatmaps/Drawables/Cards/Buttons/PlayButton.cs

diff --git a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCardDownloadButton.cs b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCardDownloadButton.cs
index 67ad699615..d93209efe9 100644
--- a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCardDownloadButton.cs
+++ b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCardDownloadButton.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.Linq;
+using System;
 using NUnit.Framework;
 using osu.Framework.Allocation;
-using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.Drawables.Cards.Buttons;
@@ -14,50 +13,20 @@ using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays;
 using osu.Game.Resources.Localisation.Web;
 using osu.Game.Rulesets.Osu;
-using osu.Game.Tests.Resources;
 using osuTK;
 
 namespace osu.Game.Tests.Visual.Beatmaps
 {
     public class TestSceneBeatmapCardDownloadButton : OsuTestScene
     {
-        private TestDownloadButton downloadButton;
+        private DownloadButton downloadButton;
 
         [Cached]
         private OverlayColourProvider colourProvider = new OverlayColourProvider(OverlayColourScheme.Blue);
 
-        [Resolved]
-        private BeatmapManager beatmaps { get; set; }
-
         [Resolved]
         private OsuConfigManager config { get; set; }
 
-        [Test]
-        public void TestDownloadableBeatmap()
-        {
-            ensureSoleilyRemoved();
-            createButton(true);
-
-            assertDownloadVisible(true);
-            assertDownloadEnabled(true);
-            assertPlayVisible(false);
-            AddAssert("tooltip text correct", () => downloadButton.Download.TooltipText == BeatmapsetsStrings.PanelDownloadAll);
-
-            AddStep("set downloading state", () => downloadButton.State.Value = DownloadState.Downloading);
-            assertDownloadVisible(true);
-            assertDownloadEnabled(false);
-            assertPlayVisible(false);
-
-            AddStep("set importing state", () => downloadButton.State.Value = DownloadState.Importing);
-            assertDownloadVisible(true);
-            assertDownloadEnabled(false);
-            assertPlayVisible(false);
-
-            AddStep("set locally available state", () => downloadButton.State.Value = DownloadState.LocallyAvailable);
-            assertDownloadVisible(false);
-            assertPlayVisible(true);
-        }
-
         [Test]
         public void TestDownloadableBeatmapWithVideo()
         {
@@ -65,10 +34,10 @@ namespace osu.Game.Tests.Visual.Beatmaps
             assertDownloadEnabled(true);
 
             AddStep("prefer no video", () => config.SetValue(OsuSetting.PreferNoVideo, true));
-            AddAssert("tooltip text correct", () => downloadButton.Download.TooltipText == BeatmapsetsStrings.PanelDownloadNoVideo);
+            AddAssert("tooltip text correct", () => downloadButton.TooltipText == BeatmapsetsStrings.PanelDownloadNoVideo);
 
             AddStep("prefer video", () => config.SetValue(OsuSetting.PreferNoVideo, false));
-            AddAssert("tooltip text correct", () => downloadButton.Download.TooltipText == BeatmapsetsStrings.PanelDownloadVideo);
+            AddAssert("tooltip text correct", () => downloadButton.TooltipText == BeatmapsetsStrings.PanelDownloadVideo);
         }
 
         [Test]
@@ -76,74 +45,31 @@ namespace osu.Game.Tests.Visual.Beatmaps
         {
             createButton(false);
             assertDownloadEnabled(false);
-            AddAssert("tooltip text correct", () => downloadButton.Download.TooltipText == BeatmapsetsStrings.AvailabilityDisabled);
+            AddAssert("tooltip text correct", () => downloadButton.TooltipText == BeatmapsetsStrings.AvailabilityDisabled);
         }
 
-        [Test]
-        public void TestDownloadState()
-        {
-            ensureSoleilyRemoved();
-            createButtonWithBeatmap(createSoleily());
-            AddAssert("button state not downloaded", () => downloadButton.State.Value == DownloadState.NotDownloaded);
-            AddStep("import soleily", () => beatmaps.Import(TestResources.GetQuickTestBeatmapForImport()));
-
-            AddUntilStep("wait for beatmap import", () => beatmaps.GetAllUsableBeatmapSets().Any(b => b.OnlineID == 241526));
-            AddUntilStep("button state downloaded", () => downloadButton.State.Value == DownloadState.LocallyAvailable);
-
-            createButtonWithBeatmap(createSoleily());
-            AddUntilStep("button state downloaded", () => downloadButton.State.Value == DownloadState.LocallyAvailable);
-            ensureSoleilyRemoved();
-            AddUntilStep("button state not downloaded", () => downloadButton.State.Value == DownloadState.NotDownloaded);
-        }
-
-        private void ensureSoleilyRemoved()
-        {
-            AddUntilStep("ensure manager loaded", () => beatmaps != null);
-            AddStep("remove soleily", () =>
-            {
-                var beatmap = beatmaps.QueryBeatmapSet(b => b.OnlineID == 241526);
-
-                if (beatmap != null) beatmaps.Delete(beatmap);
-            });
-        }
-
-        private void assertDownloadVisible(bool visible) => AddUntilStep($"download {(visible ? "visible" : "not visible")}", () => downloadButton.Download.IsPresent == visible);
-        private void assertDownloadEnabled(bool enabled) => AddAssert($"download {(enabled ? "enabled" : "disabled")}", () => downloadButton.Download.Enabled.Value == enabled);
-
-        private void assertPlayVisible(bool visible) => AddUntilStep($"play {(visible ? "visible" : "not visible")}", () => downloadButton.Play.IsPresent == visible);
-
-        private static APIBeatmapSet createSoleily() => new APIBeatmapSet
-        {
-            OnlineID = 241526,
-            Availability = new BeatmapSetOnlineAvailability
-            {
-                DownloadDisabled = false,
-                ExternalLink = string.Empty,
-            },
-        };
-
-        private void createButtonWithBeatmap(APIBeatmapSet beatmap)
-        {
-            AddStep("create button", () =>
-            {
-                Child = downloadButton = new TestDownloadButton(beatmap)
-                {
-                    Anchor = Anchor.Centre,
-                    Origin = Anchor.Centre,
-                    Scale = new Vector2(2)
-                };
-            });
-        }
+        private void assertDownloadEnabled(bool enabled) => AddAssert($"download {(enabled ? "enabled" : "disabled")}", () => downloadButton.Enabled.Value == enabled);
 
         private void createButton(bool downloadable, bool hasVideo = false)
         {
             AddStep("create button", () =>
             {
-                Child = downloadButton = new TestDownloadButton(downloadable ? getDownloadableBeatmapSet(hasVideo) : getUndownloadableBeatmapSet())
+                var beatmapSet = downloadable ? getDownloadableBeatmapSet(hasVideo) : getUndownloadableBeatmapSet();
+                var downloadTracker = new BeatmapDownloadTracker(beatmapSet);
+
+                Child = new DependencyProvidingContainer
                 {
-                    Anchor = Anchor.Centre,
-                    Origin = Anchor.Centre,
-                    Scale = new Vector2(2)
+                    RelativeSizeAxes = Axes.Both,
+                    CachedDependencies = new (Type, object)[]
+                    {
+                        (typeof(BeatmapDownloadTracker), downloadTracker)
+                    },
+                    Child = downloadButton = new DownloadButton(downloadable ? getDownloadableBeatmapSet(hasVideo) : getUndownloadableBeatmapSet())
+                    {
+                        Anchor = Anchor.Centre,
+                        Origin = Anchor.Centre,
+                        Scale = new Vector2(2)
+                    }
                 };
             });
         }
@@ -175,18 +101,5 @@ namespace osu.Game.Tests.Visual.Beatmaps
 
             return beatmap;
         }
-
-        private class TestDownloadButton : DownloadButton
-        {
-            public new Bindable<DownloadState> State => base.State;
-
-            public new BeatmapCardIconButton Download => base.Download;
-            public new BeatmapCardIconButton Play => base.Play;
-
-            public TestDownloadButton(APIBeatmapSet beatmapSet)
-                : base(beatmapSet)
-            {
-            }
-        }
     }
 }
diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
index 8bc234ec84..e48b21cdb6 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
@@ -25,6 +25,7 @@ using osu.Game.Overlays.BeatmapListing.Panels;
 using osu.Game.Resources.Localisation.Web;
 using osuTK.Graphics;
 using DownloadButton = osu.Game.Beatmaps.Drawables.Cards.Buttons.DownloadButton;
+using PlayButton = osu.Game.Beatmaps.Drawables.Cards.Buttons.PlayButton;
 
 namespace osu.Game.Beatmaps.Drawables.Cards
 {
@@ -47,7 +48,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
         private FillFlowContainer leftIconArea;
 
         private Container rightAreaBackground;
-        private Container rightAreaButtons;
+        private Container<BeatmapCardIconButton> rightAreaButtons;
 
         private Container mainContent;
         private BeatmapCardContentBackground mainContentBackground;
@@ -119,24 +120,35 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                         }
                     }
                 },
-                rightAreaButtons = new Container
+                new Container
                 {
                     Name = @"Right (button) area",
                     Width = 30,
                     RelativeSizeAxes = Axes.Y,
                     Origin = Anchor.TopRight,
                     Anchor = Anchor.TopRight,
-                    Child = new FillFlowContainer
+                    Padding = new MarginPadding { Vertical = 17.5f },
+                    Child = rightAreaButtons = new Container<BeatmapCardIconButton>
                     {
-                        AutoSizeAxes = Axes.Both,
-                        Anchor = Anchor.Centre,
-                        Origin = Anchor.Centre,
-                        Direction = FillDirection.Vertical,
-                        Spacing = new Vector2(0, 14),
-                        Children = new Drawable[]
+                        RelativeSizeAxes = Axes.Both,
+                        Children = new BeatmapCardIconButton[]
                         {
-                            new FavouriteButton(beatmapSet) { Current = favouriteState },
+                            new FavouriteButton(beatmapSet)
+                            {
+                                Current = favouriteState,
+                                Anchor = Anchor.TopCentre,
+                                Origin = Anchor.TopCentre
+                            },
                             new DownloadButton(beatmapSet)
+                            {
+                                Anchor = Anchor.BottomCentre,
+                                Origin = Anchor.BottomCentre
+                            },
+                            new PlayButton(beatmapSet)
+                            {
+                                Anchor = Anchor.BottomCentre,
+                                Origin = Anchor.BottomCentre
+                            }
                         }
                     }
                 },
@@ -389,6 +401,13 @@ namespace osu.Game.Beatmaps.Drawables.Cards
 
             rightAreaBackground.FadeColour(downloadTracker.State.Value == DownloadState.LocallyAvailable ? colours.Lime0 : colourProvider.Background3, TRANSITION_DURATION, Easing.OutQuint);
             rightAreaButtons.FadeTo(IsHovered ? 1 : 0, TRANSITION_DURATION, Easing.OutQuint);
+
+            foreach (var button in rightAreaButtons)
+            {
+                button.IdleColour = downloadTracker.State.Value != DownloadState.LocallyAvailable ? colourProvider.Light1 : colourProvider.Background3;
+                button.HoverColour = downloadTracker.State.Value != DownloadState.LocallyAvailable ? colourProvider.Content1 : colourProvider.Foreground1;
+            }
+
             bool showProgress = downloadTracker.State.Value == DownloadState.Downloading || downloadTracker.State.Value == DownloadState.Importing;
 
             idleBottomContent.FadeTo(showProgress ? 0 : 1, TRANSITION_DURATION, Easing.OutQuint);
diff --git a/osu.Game/Beatmaps/Drawables/Cards/Buttons/BeatmapCardIconButton.cs b/osu.Game/Beatmaps/Drawables/Cards/Buttons/BeatmapCardIconButton.cs
index ebd78938c7..f0f7d9aff0 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/Buttons/BeatmapCardIconButton.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/Buttons/BeatmapCardIconButton.cs
@@ -1,25 +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 System.Collections.Generic;
 using osu.Framework.Allocation;
-using osu.Framework.Extensions.IEnumerableExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
-using osu.Framework.Graphics.Shapes;
 using osu.Framework.Graphics.Sprites;
+using osu.Framework.Input.Events;
 using osu.Game.Graphics.Containers;
 using osu.Game.Overlays;
 using osuTK;
 
 namespace osu.Game.Beatmaps.Drawables.Cards.Buttons
 {
-    public abstract class BeatmapCardIconButton : OsuHoverContainer
+    public abstract class BeatmapCardIconButton : OsuClickableContainer
     {
-        protected override IEnumerable<Drawable> EffectTargets => background.Yield();
+        private Colour4 idleColour;
 
-        private readonly Box background;
-        protected readonly SpriteIcon Icon;
+        public Colour4 IdleColour
+        {
+            get => idleColour;
+            set
+            {
+                idleColour = value;
+                if (IsLoaded)
+                    updateState();
+            }
+        }
+
+        private Colour4 hoverColour;
+
+        public Colour4 HoverColour
+        {
+            get => hoverColour;
+            set
+            {
+                hoverColour = value;
+                if (IsLoaded)
+                    updateState();
+            }
+        }
 
         private float iconSize;
 
@@ -33,18 +52,18 @@ namespace osu.Game.Beatmaps.Drawables.Cards.Buttons
             }
         }
 
+        protected readonly SpriteIcon Icon;
+
         protected BeatmapCardIconButton()
         {
+            Anchor = Origin = Anchor.Centre;
+
             Child = new CircularContainer
             {
                 RelativeSizeAxes = Axes.Both,
                 Masking = true,
                 Children = new Drawable[]
                 {
-                    background = new Box
-                    {
-                        RelativeSizeAxes = Axes.Both
-                    },
                     Icon = new SpriteIcon
                     {
                         Origin = Anchor.Centre,
@@ -60,11 +79,33 @@ namespace osu.Game.Beatmaps.Drawables.Cards.Buttons
         [BackgroundDependencyLoader]
         private void load(OverlayColourProvider colourProvider)
         {
-            Anchor = Origin = Anchor.Centre;
+            IdleColour = colourProvider.Light1;
+            HoverColour = colourProvider.Content1;
+        }
 
-            IdleColour = colourProvider.Background4;
-            HoverColour = colourProvider.Background1;
-            Icon.Colour = colourProvider.Content2;
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            Enabled.BindValueChanged(_ => updateState(), true);
+            FinishTransforms(true);
+        }
+
+        protected override bool OnHover(HoverEvent e)
+        {
+            updateState();
+            return base.OnHover(e);
+        }
+
+        protected override void OnHoverLost(HoverLostEvent e)
+        {
+            base.OnHoverLost(e);
+            updateState();
+        }
+
+        private void updateState()
+        {
+            Content.FadeColour(IsHovered && Enabled.Value ? HoverColour : IdleColour, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
         }
     }
 }
diff --git a/osu.Game/Beatmaps/Drawables/Cards/Buttons/DownloadButton.cs b/osu.Game/Beatmaps/Drawables/Cards/Buttons/DownloadButton.cs
index 0e6d63830c..737c4c4697 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/Buttons/DownloadButton.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/Buttons/DownloadButton.cs
@@ -6,128 +6,62 @@
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
-using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Sprites;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Configuration;
-using osu.Game.Graphics;
 using osu.Game.Online;
-using osu.Game.Overlays;
 using osu.Game.Resources.Localisation.Web;
 
 namespace osu.Game.Beatmaps.Drawables.Cards.Buttons
 {
-    public class DownloadButton : CompositeDrawable
+    public class DownloadButton : BeatmapCardIconButton
     {
-        protected readonly DownloadIcon Download;
-        protected readonly PlayIcon Play;
-        protected readonly Bindable<DownloadState> State = new Bindable<DownloadState>();
+        private readonly APIBeatmapSet beatmapSet;
+        private Bindable<bool> preferNoVideo = null!;
+        private Bindable<DownloadState> downloadState = new Bindable<DownloadState>();
 
         [Resolved]
-        private OsuColour colours { get; set; } = null!;
-
-        [Resolved]
-        private OverlayColourProvider colourProvider { get; set; } = null!;
+        private BeatmapManager beatmaps { get; set; } = null!;
 
         public DownloadButton(APIBeatmapSet beatmapSet)
         {
-            Anchor = Anchor.Centre;
-            Origin = Anchor.Centre;
-            AutoSizeAxes = Axes.Both;
+            Icon.Icon = FontAwesome.Solid.Download;
 
-            InternalChildren = new Drawable[]
-            {
-                Download = new DownloadIcon(beatmapSet),
-                Play = new PlayIcon(beatmapSet)
-            };
+            this.beatmapSet = beatmapSet;
         }
 
-        [BackgroundDependencyLoader(true)]
-        private void load(BeatmapDownloadTracker? tracker)
+        [BackgroundDependencyLoader]
+        private void load(OsuConfigManager config, BeatmapDownloadTracker downloadTracker)
         {
-            if (tracker != null)
-                ((IBindable<DownloadState>)State).BindTo(tracker.State);
+            preferNoVideo = config.GetBindable<bool>(OsuSetting.PreferNoVideo);
+            ((IBindable<DownloadState>)downloadState).BindTo(downloadTracker.State);
         }
 
         protected override void LoadComplete()
         {
             base.LoadComplete();
-
-            State.BindValueChanged(_ => updateState(), true);
+            preferNoVideo.BindValueChanged(_ => updateState());
+            downloadState.BindValueChanged(_ => updateState(), true);
             FinishTransforms(true);
         }
 
         private void updateState()
         {
-            Download.FadeTo(State.Value != DownloadState.LocallyAvailable ? 1 : 0, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
-            Download.Enabled.Value = State.Value == DownloadState.NotDownloaded;
+            this.FadeTo(downloadState.Value != DownloadState.LocallyAvailable ? 1 : 0, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
 
-            Play.FadeTo(State.Value == DownloadState.LocallyAvailable ? 1 : 0, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
-        }
-
-        protected class DownloadIcon : BeatmapCardIconButton
-        {
-            private readonly APIBeatmapSet beatmapSet;
-            private Bindable<bool> preferNoVideo = null!;
-
-            [Resolved]
-            private BeatmapManager beatmaps { get; set; } = null!;
-
-            public DownloadIcon(APIBeatmapSet beatmapSet)
+            if (beatmapSet.Availability.DownloadDisabled)
             {
-                Icon.Icon = FontAwesome.Solid.Download;
-
-                this.beatmapSet = beatmapSet;
+                Enabled.Value = false;
+                TooltipText = BeatmapsetsStrings.AvailabilityDisabled;
+                return;
             }
 
-            [BackgroundDependencyLoader]
-            private void load(OsuConfigManager config)
-            {
-                preferNoVideo = config.GetBindable<bool>(OsuSetting.PreferNoVideo);
-            }
+            if (!beatmapSet.HasVideo)
+                TooltipText = BeatmapsetsStrings.PanelDownloadAll;
+            else
+                TooltipText = preferNoVideo.Value ? BeatmapsetsStrings.PanelDownloadNoVideo : BeatmapsetsStrings.PanelDownloadVideo;
 
-            protected override void LoadComplete()
-            {
-                base.LoadComplete();
-                preferNoVideo.BindValueChanged(_ => updateState(), true);
-            }
-
-            private void updateState()
-            {
-                if (beatmapSet.Availability.DownloadDisabled)
-                {
-                    Enabled.Value = false;
-                    TooltipText = BeatmapsetsStrings.AvailabilityDisabled;
-                    return;
-                }
-
-                if (!beatmapSet.HasVideo)
-                    TooltipText = BeatmapsetsStrings.PanelDownloadAll;
-                else
-                    TooltipText = preferNoVideo.Value ? BeatmapsetsStrings.PanelDownloadNoVideo : BeatmapsetsStrings.PanelDownloadVideo;
-
-                Action = () => beatmaps.Download(beatmapSet, preferNoVideo.Value);
-            }
-        }
-
-        protected class PlayIcon : BeatmapCardIconButton
-        {
-            private readonly APIBeatmapSet beatmapSet;
-
-            public PlayIcon(APIBeatmapSet beatmapSet)
-            {
-                this.beatmapSet = beatmapSet;
-
-                Icon.Icon = FontAwesome.Solid.AngleDoubleRight;
-                TooltipText = "Go to beatmap";
-            }
-
-            [BackgroundDependencyLoader(true)]
-            private void load(OsuGame? game)
-            {
-                if (game != null)
-                    Action = () => game.PresentBeatmap(beatmapSet);
-            }
+            Action = () => beatmaps.Download(beatmapSet, preferNoVideo.Value);
         }
     }
 }
diff --git a/osu.Game/Beatmaps/Drawables/Cards/Buttons/PlayButton.cs b/osu.Game/Beatmaps/Drawables/Cards/Buttons/PlayButton.cs
new file mode 100644
index 0000000000..7f3dbf4502
--- /dev/null
+++ b/osu.Game/Beatmaps/Drawables/Cards/Buttons/PlayButton.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.
+
+#nullable enable
+
+using osu.Framework.Allocation;
+using osu.Framework.Bindables;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Sprites;
+using osu.Game.Online;
+using osu.Game.Online.API.Requests.Responses;
+
+namespace osu.Game.Beatmaps.Drawables.Cards.Buttons
+{
+    public class PlayButton : BeatmapCardIconButton
+    {
+        private readonly APIBeatmapSet beatmapSet;
+        private readonly Bindable<DownloadState> downloadState = new Bindable<DownloadState>();
+
+        public PlayButton(APIBeatmapSet beatmapSet)
+        {
+            this.beatmapSet = beatmapSet;
+
+            Icon.Icon = FontAwesome.Solid.AngleDoubleRight;
+            TooltipText = "Go to beatmap";
+        }
+
+        [BackgroundDependencyLoader(true)]
+        private void load(OsuGame? game, BeatmapDownloadTracker downloadTracker)
+        {
+            if (game != null)
+                Action = () => game.PresentBeatmap(beatmapSet);
+
+            ((IBindable<DownloadState>)downloadState).BindTo(downloadTracker.State);
+        }
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            downloadState.BindValueChanged(_ => updateState(), true);
+            FinishTransforms(true);
+        }
+
+        private void updateState()
+        {
+            this.FadeTo(downloadState.Value == DownloadState.LocallyAvailable ? 1 : 0, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
+        }
+    }
+}

From 0eaf450204c397fa58c7b310ccefe574f9e851cc Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 18 Nov 2021 22:50:41 +0100
Subject: [PATCH 1106/5547] Make field readonly

---
 osu.Game/Beatmaps/Drawables/Cards/Buttons/DownloadButton.cs | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Beatmaps/Drawables/Cards/Buttons/DownloadButton.cs b/osu.Game/Beatmaps/Drawables/Cards/Buttons/DownloadButton.cs
index 737c4c4697..325181598d 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/Buttons/DownloadButton.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/Buttons/DownloadButton.cs
@@ -17,8 +17,9 @@ namespace osu.Game.Beatmaps.Drawables.Cards.Buttons
     public class DownloadButton : BeatmapCardIconButton
     {
         private readonly APIBeatmapSet beatmapSet;
+        private readonly Bindable<DownloadState> downloadState = new Bindable<DownloadState>();
+
         private Bindable<bool> preferNoVideo = null!;
-        private Bindable<DownloadState> downloadState = new Bindable<DownloadState>();
 
         [Resolved]
         private BeatmapManager beatmaps { get; set; } = null!;

From 77c0b8dfa937a76ed071b1c195e4e2f6939a7080 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 19 Nov 2021 13:27:06 +0900
Subject: [PATCH 1107/5547] Fix stray typo

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

diff --git a/osu.Game/Migrations/20180628011956_RemoveNegativeSetIDs.cs b/osu.Game/Migrations/20180628011956_RemoveNegativeSetIDs.cs
index 026442f328..506d65f761 100644
--- a/osu.Game/Migrations/20180628011956_RemoveNegativeSetIDs.cs
+++ b/osu.Game/Migrations/20180628011956_RemoveNegativeSetIDs.cs
@@ -6,7 +6,7 @@ namespace osu.Game.Migrations
     {
         protected override void Up(MigrationBuilder migrationBuilder)
         {
-            // There was a change that baetmaps were being loaded with "-1" online IDs, which is completely incorrect.
+            // There was a change that beatmaps were being loaded with "-1" online IDs, which is completely incorrect.
             // This ensures there will not be unique key conflicts as a result of these incorrectly imported beatmaps.
             migrationBuilder.Sql("UPDATE BeatmapSetInfo SET OnlineBeatmapSetID = null WHERE OnlineBeatmapSetID <= 0");
         }

From c901a4fd7e5c25b816cf4fa2280b6c1c175046a7 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 19 Nov 2021 13:27:28 +0900
Subject: [PATCH 1108/5547] Show better error message when selecting an
 unavailable beatmap during multiplayer room creation

---
 .../Match/MultiplayerMatchSettingsOverlay.cs       | 14 +++++++++++++-
 1 file changed, 13 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs
index 5bc76a10bc..90feea4e6e 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs
@@ -365,7 +365,19 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
             {
                 Debug.Assert(applyingSettingsOperation != null);
 
-                ErrorText.Text = text;
+                // see https://github.com/ppy/osu-web/blob/2c97aaeb64fb4ed97c747d8383a35b30f57428c7/app/Models/Multiplayer/PlaylistItem.php#L48.
+                const string not_found_prefix = "beatmaps not found:";
+
+                if (text.StartsWith(not_found_prefix, StringComparison.Ordinal))
+                {
+                    ErrorText.Text = "The selected beatmap is not available online.";
+                    SelectedItem.Value.MarkInvalid();
+                }
+                else
+                {
+                    ErrorText.Text = text;
+                }
+
                 ErrorText.FadeIn(50);
 
                 applyingSettingsOperation.Dispose();

From 284e554cbffdb25c967957a096cb8259bc364747 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 19 Nov 2021 13:58:03 +0900
Subject: [PATCH 1109/5547] Only show user displayable portion of server errors
 when seleting a song in multiplayer

---
 .../Multiplayer/MultiplayerMatchSongSelect.cs | 26 ++++++++++++++++---
 1 file changed, 22 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs
index ad4bb90551..9ae352b3e7 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs
@@ -1,6 +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;
+using System.Diagnostics;
+using Microsoft.AspNetCore.SignalR;
 using osu.Framework.Allocation;
 using osu.Framework.Logging;
 using osu.Framework.Screens;
@@ -60,13 +63,28 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
                     {
                         loadingLayer.Hide();
 
-                        if (t.IsCompletedSuccessfully)
-                            this.Exit();
-                        else
+                        if (t.IsFaulted)
                         {
-                            Logger.Log($"Could not use current beatmap ({t.Exception?.Message})", level: LogLevel.Important);
+                            Exception exception = t.Exception;
+
+                            if (exception is AggregateException ae)
+                                exception = ae.InnerException;
+
+                            Debug.Assert(exception != null);
+
+                            string message = exception is HubException
+                                // HubExceptions arrive with additional message context added, but we want to display the human readable message:
+                                // "An unexpected error occurred invoking 'AddPlaylistItem' on the server.InvalidStateException: Can't enqueue more than 3 items at once."
+                                // We generally use the message field for a user-parseable error (eventually to be replaced), so drop the first part for now.
+                                ? exception.Message.Substring(exception.Message.IndexOf(':') + 1).Trim()
+                                : exception.Message;
+
+                            Logger.Log(message, level: LogLevel.Important);
                             Carousel.AllowSelection = true;
+                            return;
                         }
+
+                        this.Exit();
                     });
                 });
             }

From 6dc6ca1bbb67296931c47a32255aad866f22f192 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 19 Nov 2021 14:03:07 +0900
Subject: [PATCH 1110/5547] Fix potential null reference in
 `FadeAccessibleBackground` test class

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

diff --git a/osu.Game.Tests/Visual/Background/TestSceneUserDimBackgrounds.cs b/osu.Game.Tests/Visual/Background/TestSceneUserDimBackgrounds.cs
index 69ea1dc520..194341d1ab 100644
--- a/osu.Game.Tests/Visual/Background/TestSceneUserDimBackgrounds.cs
+++ b/osu.Game.Tests/Visual/Background/TestSceneUserDimBackgrounds.cs
@@ -428,7 +428,7 @@ namespace osu.Game.Tests.Visual.Background
 
             public float CurrentDim => dimmable.DimLevel;
 
-            public Vector2 CurrentBlur => Background.BlurSigma;
+            public Vector2 CurrentBlur => Background?.BlurSigma ?? Vector2.Zero;
 
             private TestDimmableBackground dimmable;
 

From 0c289bf8e5b63f49a7ce328958d018d16bafa077 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 19 Nov 2021 14:46:53 +0900
Subject: [PATCH 1111/5547] Remove pointless namespace

---
 .../Visual/Multiplayer/QueueingModes/QueueModeTestScene.cs      | 1 -
 .../Multiplayer/QueueingModes/TestSceneFreeForAllQueueMode.cs   | 2 +-
 .../Multiplayer/QueueingModes/TestSceneHostOnlyQueueMode.cs     | 2 +-
 osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs       | 1 -
 osu.Game/Online/Multiplayer/MultiplayerClient.cs                | 1 -
 osu.Game/Online/Multiplayer/MultiplayerRoomSettings.cs          | 1 -
 osu.Game/Online/Multiplayer/{Queueing => }/QueueMode.cs         | 2 +-
 osu.Game/Online/Rooms/Room.cs                                   | 2 +-
 .../Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs        | 1 -
 .../Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs | 1 -
 osu.Game/Screens/OnlinePlay/OnlinePlayComposite.cs              | 2 +-
 osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs      | 1 -
 12 files changed, 5 insertions(+), 12 deletions(-)
 rename osu.Game/Online/Multiplayer/{Queueing => }/QueueMode.cs (90%)

diff --git a/osu.Game.Tests/Visual/Multiplayer/QueueingModes/QueueModeTestScene.cs b/osu.Game.Tests/Visual/Multiplayer/QueueingModes/QueueModeTestScene.cs
index cdab83e463..97d24f2d8c 100644
--- a/osu.Game.Tests/Visual/Multiplayer/QueueingModes/QueueModeTestScene.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/QueueingModes/QueueModeTestScene.cs
@@ -11,7 +11,6 @@ using osu.Framework.Testing;
 using osu.Game.Beatmaps;
 using osu.Game.Database;
 using osu.Game.Online.Multiplayer;
-using osu.Game.Online.Multiplayer.Queueing;
 using osu.Game.Online.Rooms;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Osu;
diff --git a/osu.Game.Tests/Visual/Multiplayer/QueueingModes/TestSceneFreeForAllQueueMode.cs b/osu.Game.Tests/Visual/Multiplayer/QueueingModes/TestSceneFreeForAllQueueMode.cs
index 8217eabcdb..9de589b909 100644
--- a/osu.Game.Tests/Visual/Multiplayer/QueueingModes/TestSceneFreeForAllQueueMode.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/QueueingModes/TestSceneFreeForAllQueueMode.cs
@@ -6,7 +6,7 @@ using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
-using osu.Game.Online.Multiplayer.Queueing;
+using osu.Game.Online.Multiplayer;
 using osu.Game.Screens.OnlinePlay.Multiplayer;
 using osuTK.Input;
 
diff --git a/osu.Game.Tests/Visual/Multiplayer/QueueingModes/TestSceneHostOnlyQueueMode.cs b/osu.Game.Tests/Visual/Multiplayer/QueueingModes/TestSceneHostOnlyQueueMode.cs
index d9e6ea878b..8d162b875f 100644
--- a/osu.Game.Tests/Visual/Multiplayer/QueueingModes/TestSceneHostOnlyQueueMode.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/QueueingModes/TestSceneHostOnlyQueueMode.cs
@@ -6,7 +6,7 @@ using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
-using osu.Game.Online.Multiplayer.Queueing;
+using osu.Game.Online.Multiplayer;
 using osu.Game.Screens.OnlinePlay.Multiplayer;
 using osuTK.Input;
 
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
index 1cc770b670..cf14bfa312 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
@@ -19,7 +19,6 @@ using osu.Game.Database;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Multiplayer;
-using osu.Game.Online.Multiplayer.Queueing;
 using osu.Game.Online.Rooms;
 using osu.Game.Overlays.Mods;
 using osu.Game.Rulesets;
diff --git a/osu.Game/Online/Multiplayer/MultiplayerClient.cs b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
index 09f5c6a458..d757781a0a 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
@@ -15,7 +15,6 @@ using osu.Framework.Graphics;
 using osu.Framework.Logging;
 using osu.Game.Database;
 using osu.Game.Online.API;
-using osu.Game.Online.Multiplayer.Queueing;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Rooms;
 using osu.Game.Online.Rooms.RoomStatuses;
diff --git a/osu.Game/Online/Multiplayer/MultiplayerRoomSettings.cs b/osu.Game/Online/Multiplayer/MultiplayerRoomSettings.cs
index e84026529f..c392260a22 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerRoomSettings.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerRoomSettings.cs
@@ -5,7 +5,6 @@
 
 using System;
 using MessagePack;
-using osu.Game.Online.Multiplayer.Queueing;
 using osu.Game.Online.Rooms;
 
 namespace osu.Game.Online.Multiplayer
diff --git a/osu.Game/Online/Multiplayer/Queueing/QueueMode.cs b/osu.Game/Online/Multiplayer/QueueMode.cs
similarity index 90%
rename from osu.Game/Online/Multiplayer/Queueing/QueueMode.cs
rename to osu.Game/Online/Multiplayer/QueueMode.cs
index 169d238496..3a9ea93658 100644
--- a/osu.Game/Online/Multiplayer/Queueing/QueueMode.cs
+++ b/osu.Game/Online/Multiplayer/QueueMode.cs
@@ -3,7 +3,7 @@
 
 using System.ComponentModel;
 
-namespace osu.Game.Online.Multiplayer.Queueing
+namespace osu.Game.Online.Multiplayer
 {
     public enum QueueMode
     {
diff --git a/osu.Game/Online/Rooms/Room.cs b/osu.Game/Online/Rooms/Room.cs
index 51f8bd7437..c87411c3c0 100644
--- a/osu.Game/Online/Rooms/Room.cs
+++ b/osu.Game/Online/Rooms/Room.cs
@@ -7,8 +7,8 @@ using Newtonsoft.Json;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Game.IO.Serialization.Converters;
-using osu.Game.Online.Multiplayer.Queueing;
 using osu.Game.Online.API.Requests.Responses;
+using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Rooms.RoomStatuses;
 using osu.Game.Utils;
 
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs
index 6bb698cd67..947c9d3868 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs
@@ -18,7 +18,6 @@ using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Online.Multiplayer;
-using osu.Game.Online.Multiplayer.Queueing;
 using osu.Game.Online.Rooms;
 using osu.Game.Overlays;
 using osu.Game.Rulesets;
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
index 09ebfbc13c..7a840a05cd 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
@@ -17,7 +17,6 @@ using osu.Game.Configuration;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Online;
 using osu.Game.Online.Multiplayer;
-using osu.Game.Online.Multiplayer.Queueing;
 using osu.Game.Online.Rooms;
 using osu.Game.Overlays;
 using osu.Game.Overlays.Dialog;
diff --git a/osu.Game/Screens/OnlinePlay/OnlinePlayComposite.cs b/osu.Game/Screens/OnlinePlay/OnlinePlayComposite.cs
index b6f4abdbb6..2fd2af08ef 100644
--- a/osu.Game/Screens/OnlinePlay/OnlinePlayComposite.cs
+++ b/osu.Game/Screens/OnlinePlay/OnlinePlayComposite.cs
@@ -6,8 +6,8 @@ using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics.Containers;
-using osu.Game.Online.Multiplayer.Queueing;
 using osu.Game.Online.API.Requests.Responses;
+using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Rooms;
 using osu.Game.Screens.OnlinePlay.Match;
 
diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
index 7965bba8a1..7e0312e566 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
@@ -16,7 +16,6 @@ using osu.Game.Online.API;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Multiplayer.MatchTypes.TeamVersus;
-using osu.Game.Online.Multiplayer.Queueing;
 using osu.Game.Online.Rooms;
 using osu.Game.Rulesets.Mods;
 using APIUser = osu.Game.Online.API.Requests.Responses.APIUser;

From 741c27c1f2b92378ac4a8f63d3bf3edca6e129b0 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 19 Nov 2021 15:27:38 +0900
Subject: [PATCH 1112/5547] Always populate action to make button behave better
 in testing scenarios

---
 osu.Game/Beatmaps/Drawables/Cards/Buttons/PlayButton.cs | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/osu.Game/Beatmaps/Drawables/Cards/Buttons/PlayButton.cs b/osu.Game/Beatmaps/Drawables/Cards/Buttons/PlayButton.cs
index 7f3dbf4502..be964e306a 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/Buttons/PlayButton.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/Buttons/PlayButton.cs
@@ -28,8 +28,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards.Buttons
         [BackgroundDependencyLoader(true)]
         private void load(OsuGame? game, BeatmapDownloadTracker downloadTracker)
         {
-            if (game != null)
-                Action = () => game.PresentBeatmap(beatmapSet);
+            Action = () => game?.PresentBeatmap(beatmapSet);
 
             ((IBindable<DownloadState>)downloadState).BindTo(downloadTracker.State);
         }

From 6e5918a100c6f212f8ab590ed7b06ec2d2444ede Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 19 Nov 2021 15:27:51 +0900
Subject: [PATCH 1113/5547] Add slight scale to icon buttons

---
 .../Cards/Buttons/BeatmapCardIconButton.cs         | 14 +++++++++++---
 1 file changed, 11 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Beatmaps/Drawables/Cards/Buttons/BeatmapCardIconButton.cs b/osu.Game/Beatmaps/Drawables/Cards/Buttons/BeatmapCardIconButton.cs
index f0f7d9aff0..ad9caf7e34 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/Buttons/BeatmapCardIconButton.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/Buttons/BeatmapCardIconButton.cs
@@ -54,14 +54,19 @@ namespace osu.Game.Beatmaps.Drawables.Cards.Buttons
 
         protected readonly SpriteIcon Icon;
 
+        private readonly Container content;
+
         protected BeatmapCardIconButton()
         {
-            Anchor = Origin = Anchor.Centre;
+            Origin = Anchor.Centre;
+            Anchor = Anchor.Centre;
 
-            Child = new CircularContainer
+            Child = content = new Container
             {
                 RelativeSizeAxes = Axes.Both,
                 Masking = true,
+                Origin = Anchor.Centre,
+                Anchor = Anchor.Centre,
                 Children = new Drawable[]
                 {
                     Icon = new SpriteIcon
@@ -105,7 +110,10 @@ namespace osu.Game.Beatmaps.Drawables.Cards.Buttons
 
         private void updateState()
         {
-            Content.FadeColour(IsHovered && Enabled.Value ? HoverColour : IdleColour, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
+            bool isHovered = IsHovered && Enabled.Value;
+
+            content.ScaleTo(isHovered ? 1.2f : 1, 500, Easing.OutQuint);
+            content.FadeColour(isHovered ? HoverColour : IdleColour, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
         }
     }
 }

From a6a786b167a345aae17e7bec6916f65a1856f293 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 19 Nov 2021 15:43:11 +0900
Subject: [PATCH 1114/5547] Remove namespacing of queue tests

---
 .../Multiplayer/{QueueingModes => }/QueueModeTestScene.cs       | 2 +-
 .../{QueueingModes => }/TestSceneFreeForAllQueueMode.cs         | 2 +-
 .../{QueueingModes => }/TestSceneHostOnlyQueueMode.cs           | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)
 rename osu.Game.Tests/Visual/Multiplayer/{QueueingModes => }/QueueModeTestScene.cs (98%)
 rename osu.Game.Tests/Visual/Multiplayer/{QueueingModes => }/TestSceneFreeForAllQueueMode.cs (98%)
 rename osu.Game.Tests/Visual/Multiplayer/{QueueingModes => }/TestSceneHostOnlyQueueMode.cs (98%)

diff --git a/osu.Game.Tests/Visual/Multiplayer/QueueingModes/QueueModeTestScene.cs b/osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs
similarity index 98%
rename from osu.Game.Tests/Visual/Multiplayer/QueueingModes/QueueModeTestScene.cs
rename to osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs
index 97d24f2d8c..e94e91dfe3 100644
--- a/osu.Game.Tests/Visual/Multiplayer/QueueingModes/QueueModeTestScene.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs
@@ -21,7 +21,7 @@ using osu.Game.Screens.Play;
 using osu.Game.Tests.Resources;
 using osuTK.Input;
 
-namespace osu.Game.Tests.Visual.Multiplayer.QueueingModes
+namespace osu.Game.Tests.Visual.Multiplayer
 {
     public abstract class QueueModeTestScene : ScreenTestScene
     {
diff --git a/osu.Game.Tests/Visual/Multiplayer/QueueingModes/TestSceneFreeForAllQueueMode.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneFreeForAllQueueMode.cs
similarity index 98%
rename from osu.Game.Tests/Visual/Multiplayer/QueueingModes/TestSceneFreeForAllQueueMode.cs
rename to osu.Game.Tests/Visual/Multiplayer/TestSceneFreeForAllQueueMode.cs
index 9de589b909..967b9221bb 100644
--- a/osu.Game.Tests/Visual/Multiplayer/QueueingModes/TestSceneFreeForAllQueueMode.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneFreeForAllQueueMode.cs
@@ -10,7 +10,7 @@ using osu.Game.Online.Multiplayer;
 using osu.Game.Screens.OnlinePlay.Multiplayer;
 using osuTK.Input;
 
-namespace osu.Game.Tests.Visual.Multiplayer.QueueingModes
+namespace osu.Game.Tests.Visual.Multiplayer
 {
     public class TestSceneFreeForAllQueueMode : QueueModeTestScene
     {
diff --git a/osu.Game.Tests/Visual/Multiplayer/QueueingModes/TestSceneHostOnlyQueueMode.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneHostOnlyQueueMode.cs
similarity index 98%
rename from osu.Game.Tests/Visual/Multiplayer/QueueingModes/TestSceneHostOnlyQueueMode.cs
rename to osu.Game.Tests/Visual/Multiplayer/TestSceneHostOnlyQueueMode.cs
index 8d162b875f..2c60a98014 100644
--- a/osu.Game.Tests/Visual/Multiplayer/QueueingModes/TestSceneHostOnlyQueueMode.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneHostOnlyQueueMode.cs
@@ -10,7 +10,7 @@ using osu.Game.Online.Multiplayer;
 using osu.Game.Screens.OnlinePlay.Multiplayer;
 using osuTK.Input;
 
-namespace osu.Game.Tests.Visual.Multiplayer.QueueingModes
+namespace osu.Game.Tests.Visual.Multiplayer
 {
     public class TestSceneHostOnlyQueueMode : QueueModeTestScene
     {

From a922ce2fd9103b5c978300057345b3ac11cef0a6 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 19 Nov 2021 15:45:45 +0900
Subject: [PATCH 1115/5547] Remove unnecessary nameofs

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

diff --git a/osu.Game/Screens/OnlinePlay/OnlinePlayComposite.cs b/osu.Game/Screens/OnlinePlay/OnlinePlayComposite.cs
index 2fd2af08ef..6b111d76a5 100644
--- a/osu.Game/Screens/OnlinePlay/OnlinePlayComposite.cs
+++ b/osu.Game/Screens/OnlinePlay/OnlinePlayComposite.cs
@@ -60,13 +60,13 @@ namespace osu.Game.Screens.OnlinePlay
         [Resolved(typeof(Room))]
         protected Bindable<RoomAvailability> Availability { get; private set; }
 
-        [Resolved(typeof(Room), nameof(Room.Password))]
+        [Resolved(typeof(Room))]
         public Bindable<string> Password { get; private set; }
 
         [Resolved(typeof(Room))]
         protected Bindable<TimeSpan?> Duration { get; private set; }
 
-        [Resolved(typeof(Room), nameof(Room.QueueMode))]
+        [Resolved(typeof(Room))]
         protected Bindable<QueueMode> QueueMode { get; private set; }
 
         [Resolved(CanBeNull = true)]

From 12e1142b070fd710fda023ada912090b6695b99f Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 19 Nov 2021 15:47:38 +0900
Subject: [PATCH 1116/5547] Rename settings section

---
 .../Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs        | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs
index 947c9d3868..8a9a395222 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs
@@ -201,7 +201,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
                                                                         },
                                                                     },
                                                                 },
-                                                                new Section("Picking mode")
+                                                                new Section("Queue mode")
                                                                 {
                                                                     Child = new Container
                                                                     {

From 59e763467fb16f27afcfe71078d66bb52f2fe64a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 19 Nov 2021 16:07:55 +0900
Subject: [PATCH 1117/5547] Move `StoragePath` implementation to an extension
 method

---
 osu.Game.Tests/Beatmaps/IO/ImportBeatmapTest.cs          | 7 ++++---
 osu.Game.Tests/Database/BeatmapImporterTests.cs          | 7 ++++---
 osu.Game.Tests/Database/FileStoreTests.cs                | 7 ++++---
 osu.Game/Beatmaps/BeatmapModelManager.cs                 | 3 ++-
 osu.Game/Beatmaps/BeatmapSetInfo.cs                      | 3 ++-
 osu.Game/Database/ArchiveModelManager.cs                 | 4 ++--
 osu.Game/Extensions/ModelExtensions.cs                   | 9 +++++++++
 osu.Game/IO/FileInfo.cs                                  | 3 ---
 osu.Game/IO/FileStore.cs                                 | 5 +++--
 osu.Game/Models/RealmBeatmapSet.cs                       | 2 +-
 osu.Game/Models/RealmFile.cs                             | 3 ---
 osu.Game/Rulesets/Edit/Checks/CheckTooShortAudioFiles.cs | 3 ++-
 osu.Game/Rulesets/Edit/Checks/CheckZeroByteFiles.cs      | 3 ++-
 osu.Game/Scoring/LegacyDatabasedScore.cs                 | 3 ++-
 osu.Game/Scoring/ScoreModelManager.cs                    | 3 ++-
 osu.Game/Skinning/LegacySkinResourceStore.cs             | 3 ++-
 osu.Game/Skinning/Skin.cs                                | 5 +++--
 osu.Game/Skinning/SkinManager.cs                         | 2 +-
 osu.Game/Stores/BeatmapImporter.cs                       | 3 ++-
 osu.Game/Stores/RealmArchiveModelImporter.cs             | 3 ++-
 osu.Game/Stores/RealmFileStore.cs                        | 7 ++++---
 .../Storyboards/Drawables/DrawableStoryboardVideo.cs     | 4 +++-
 osu.Game/Storyboards/Storyboard.cs                       | 3 ++-
 23 files changed, 58 insertions(+), 37 deletions(-)

diff --git a/osu.Game.Tests/Beatmaps/IO/ImportBeatmapTest.cs b/osu.Game.Tests/Beatmaps/IO/ImportBeatmapTest.cs
index e00d7a1115..836cbfa6c5 100644
--- a/osu.Game.Tests/Beatmaps/IO/ImportBeatmapTest.cs
+++ b/osu.Game.Tests/Beatmaps/IO/ImportBeatmapTest.cs
@@ -16,6 +16,7 @@ using osu.Framework.Extensions.ObjectExtensions;
 using osu.Framework.Logging;
 using osu.Game.Beatmaps;
 using osu.Game.Database;
+using osu.Game.Extensions;
 using osu.Game.IO;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays.Notifications;
@@ -363,15 +364,15 @@ namespace osu.Game.Tests.Beatmaps.IO
                     var files = osu.Dependencies.Get<FileStore>();
 
                     long originalLength;
-                    using (var stream = files.Storage.GetStream(firstFile.FileInfo.StoragePath))
+                    using (var stream = files.Storage.GetStream(firstFile.FileInfo.GetStoragePath()))
                         originalLength = stream.Length;
 
-                    using (var stream = files.Storage.GetStream(firstFile.FileInfo.StoragePath, FileAccess.Write, FileMode.Create))
+                    using (var stream = files.Storage.GetStream(firstFile.FileInfo.GetStoragePath(), FileAccess.Write, FileMode.Create))
                         stream.WriteByte(0);
 
                     var importedSecondTime = await LoadOszIntoOsu(osu);
 
-                    using (var stream = files.Storage.GetStream(firstFile.FileInfo.StoragePath))
+                    using (var stream = files.Storage.GetStream(firstFile.FileInfo.GetStoragePath()))
                         Assert.AreEqual(stream.Length, originalLength, "Corruption was not fixed on second import");
 
                     // check the newly "imported" beatmap is actually just the restored previous import. since it matches hash.
diff --git a/osu.Game.Tests/Database/BeatmapImporterTests.cs b/osu.Game.Tests/Database/BeatmapImporterTests.cs
index 88d16c8a36..75eb4a043a 100644
--- a/osu.Game.Tests/Database/BeatmapImporterTests.cs
+++ b/osu.Game.Tests/Database/BeatmapImporterTests.cs
@@ -14,6 +14,7 @@ using osu.Framework.Extensions.ObjectExtensions;
 using osu.Framework.Logging;
 using osu.Game.Beatmaps;
 using osu.Game.Database;
+using osu.Game.Extensions;
 using osu.Game.IO.Archives;
 using osu.Game.Models;
 using osu.Game.Overlays.Notifications;
@@ -348,15 +349,15 @@ namespace osu.Game.Tests.Database
                 var firstFile = imported.Files.First();
 
                 long originalLength;
-                using (var stream = storage.GetStream(firstFile.File.StoragePath))
+                using (var stream = storage.GetStream(firstFile.File.GetStoragePath()))
                     originalLength = stream.Length;
 
-                using (var stream = storage.GetStream(firstFile.File.StoragePath, FileAccess.Write, FileMode.Create))
+                using (var stream = storage.GetStream(firstFile.File.GetStoragePath(), FileAccess.Write, FileMode.Create))
                     stream.WriteByte(0);
 
                 var importedSecondTime = await LoadOszIntoStore(importer, realmFactory.Context);
 
-                using (var stream = storage.GetStream(firstFile.File.StoragePath))
+                using (var stream = storage.GetStream(firstFile.File.GetStoragePath()))
                     Assert.AreEqual(stream.Length, originalLength, "Corruption was not fixed on second import");
 
                 // check the newly "imported" beatmap is actually just the restored previous import. since it matches hash.
diff --git a/osu.Game.Tests/Database/FileStoreTests.cs b/osu.Game.Tests/Database/FileStoreTests.cs
index 861de5303d..3cb4705381 100644
--- a/osu.Game.Tests/Database/FileStoreTests.cs
+++ b/osu.Game.Tests/Database/FileStoreTests.cs
@@ -6,6 +6,7 @@ using System.IO;
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Logging;
+using osu.Game.Extensions;
 using osu.Game.Models;
 using osu.Game.Stores;
 
@@ -28,7 +29,7 @@ namespace osu.Game.Tests.Database
                 realm.Write(() => files.Add(testData, realm));
 
                 Assert.True(files.Storage.Exists("0/05/054edec1d0211f624fed0cbca9d4f9400b0e491c43742af2c5b0abebf0c990d8"));
-                Assert.True(files.Storage.Exists(realm.All<RealmFile>().First().StoragePath));
+                Assert.True(files.Storage.Exists(realm.All<RealmFile>().First().GetStoragePath()));
             });
         }
 
@@ -74,7 +75,7 @@ namespace osu.Game.Tests.Database
 
                 Logger.Log($"Import complete at {timer.ElapsedMilliseconds}");
 
-                string path = file.StoragePath;
+                string path = file.GetStoragePath();
 
                 Assert.True(realm.All<RealmFile>().Any());
                 Assert.True(files.Storage.Exists(path));
@@ -98,7 +99,7 @@ namespace osu.Game.Tests.Database
 
                 var file = realm.Write(() => files.Add(new MemoryStream(new byte[] { 0, 1, 2, 3 }), realm));
 
-                string path = file.StoragePath;
+                string path = file.GetStoragePath();
 
                 Assert.True(realm.All<RealmFile>().Any());
                 Assert.True(files.Storage.Exists(path));
diff --git a/osu.Game/Beatmaps/BeatmapModelManager.cs b/osu.Game/Beatmaps/BeatmapModelManager.cs
index 3becbee0ba..8f55232031 100644
--- a/osu.Game/Beatmaps/BeatmapModelManager.cs
+++ b/osu.Game/Beatmaps/BeatmapModelManager.cs
@@ -18,6 +18,7 @@ using osu.Framework.Platform;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps.Formats;
 using osu.Game.Database;
+using osu.Game.Extensions;
 using osu.Game.IO;
 using osu.Game.IO.Archives;
 using osu.Game.Rulesets;
@@ -384,7 +385,7 @@ namespace osu.Game.Beatmaps
 
             foreach (var file in files.Where(f => f.Filename.EndsWith(".osu", StringComparison.OrdinalIgnoreCase)))
             {
-                using (var raw = Files.Store.GetStream(file.FileInfo.StoragePath))
+                using (var raw = Files.Store.GetStream(file.FileInfo.GetStoragePath()))
                 using (var ms = new MemoryStream()) // we need a memory stream so we can seek
                 using (var sr = new LineBufferedReader(ms))
                 {
diff --git a/osu.Game/Beatmaps/BeatmapSetInfo.cs b/osu.Game/Beatmaps/BeatmapSetInfo.cs
index a0de50a311..35468ce831 100644
--- a/osu.Game/Beatmaps/BeatmapSetInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapSetInfo.cs
@@ -8,6 +8,7 @@ using System.Linq;
 using JetBrains.Annotations;
 using osu.Framework.Testing;
 using osu.Game.Database;
+using osu.Game.Extensions;
 
 namespace osu.Game.Beatmaps
 {
@@ -61,7 +62,7 @@ namespace osu.Game.Beatmaps
         /// The path returned is relative to the user file storage.
         /// </summary>
         /// <param name="filename">The name of the file to get the storage path of.</param>
-        public string GetPathForFile(string filename) => Files.SingleOrDefault(f => string.Equals(f.Filename, filename, StringComparison.OrdinalIgnoreCase))?.FileInfo.StoragePath;
+        public string GetPathForFile(string filename) => Files.SingleOrDefault(f => string.Equals(f.Filename, filename, StringComparison.OrdinalIgnoreCase))?.FileInfo.GetStoragePath();
 
         public override string ToString() => Metadata?.ToString() ?? base.ToString();
 
diff --git a/osu.Game/Database/ArchiveModelManager.cs b/osu.Game/Database/ArchiveModelManager.cs
index e8b6996869..a0e8105285 100644
--- a/osu.Game/Database/ArchiveModelManager.cs
+++ b/osu.Game/Database/ArchiveModelManager.cs
@@ -325,7 +325,7 @@ namespace osu.Game.Database
 
                 foreach (TFileModel file in hashableFiles)
                 {
-                    using (Stream s = Files.Store.GetStream(file.FileInfo.StoragePath))
+                    using (Stream s = Files.Store.GetStream(file.FileInfo.GetStoragePath()))
                         s.CopyTo(hashable);
                 }
 
@@ -480,7 +480,7 @@ namespace osu.Game.Database
             using (var archive = ZipArchive.Create())
             {
                 foreach (var file in model.Files)
-                    archive.AddEntry(file.Filename, Files.Storage.GetStream(file.FileInfo.StoragePath));
+                    archive.AddEntry(file.Filename, Files.Storage.GetStream(file.FileInfo.GetStoragePath()));
 
                 archive.SaveTo(outputStream);
             }
diff --git a/osu.Game/Extensions/ModelExtensions.cs b/osu.Game/Extensions/ModelExtensions.cs
index 3426484c14..aaf87385c8 100644
--- a/osu.Game/Extensions/ModelExtensions.cs
+++ b/osu.Game/Extensions/ModelExtensions.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.IO;
 using osu.Game.Beatmaps;
 using osu.Game.Database;
+using osu.Game.IO;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets;
 using osu.Game.Scoring;
@@ -14,6 +16,13 @@ namespace osu.Game.Extensions
 {
     public static class ModelExtensions
     {
+        /// <summary>
+        /// Get the relative path in osu! storage for this file.
+        /// </summary>
+        /// <param name="fileInfo">The file info.</param>
+        /// <returns>A relative file path.</returns>
+        public static string GetStoragePath(this IFileInfo fileInfo) => Path.Combine(fileInfo.Hash.Remove(1), fileInfo.Hash.Remove(2), fileInfo.Hash);
+
         /// <summary>
         /// Returns a user-facing string representing the <paramref name="model"/>.
         /// </summary>
diff --git a/osu.Game/IO/FileInfo.cs b/osu.Game/IO/FileInfo.cs
index 331546f9f8..277ad0adac 100644
--- a/osu.Game/IO/FileInfo.cs
+++ b/osu.Game/IO/FileInfo.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.IO;
 using osu.Game.Database;
 
 namespace osu.Game.IO
@@ -12,8 +11,6 @@ namespace osu.Game.IO
 
         public string Hash { get; set; }
 
-        public string StoragePath => Path.Combine(Hash.Remove(1), Hash.Remove(2), Hash);
-
         public int ReferenceCount { get; set; }
     }
 }
diff --git a/osu.Game/IO/FileStore.cs b/osu.Game/IO/FileStore.cs
index bf4e881ed0..165cf756aa 100644
--- a/osu.Game/IO/FileStore.cs
+++ b/osu.Game/IO/FileStore.cs
@@ -12,6 +12,7 @@ using osu.Framework.IO.Stores;
 using osu.Framework.Logging;
 using osu.Framework.Platform;
 using osu.Game.Database;
+using osu.Game.Extensions;
 
 namespace osu.Game.IO
 {
@@ -47,7 +48,7 @@ namespace osu.Game.IO
 
                 var info = existing ?? new FileInfo { Hash = hash };
 
-                string path = info.StoragePath;
+                string path = info.GetStoragePath();
 
                 // we may be re-adding a file to fix missing store entries.
                 bool requiresCopy = !Storage.Exists(path);
@@ -120,7 +121,7 @@ namespace osu.Game.IO
                 {
                     try
                     {
-                        Storage.Delete(f.StoragePath);
+                        Storage.Delete(f.GetStoragePath());
                         context.FileInfo.Remove(f);
                     }
                     catch (Exception e)
diff --git a/osu.Game/Models/RealmBeatmapSet.cs b/osu.Game/Models/RealmBeatmapSet.cs
index b9b47b697c..da75978977 100644
--- a/osu.Game/Models/RealmBeatmapSet.cs
+++ b/osu.Game/Models/RealmBeatmapSet.cs
@@ -52,7 +52,7 @@ namespace osu.Game.Models
         /// The path returned is relative to the user file storage.
         /// </summary>
         /// <param name="filename">The name of the file to get the storage path of.</param>
-        public string? GetPathForFile(string filename) => Files.SingleOrDefault(f => string.Equals(f.Filename, filename, StringComparison.OrdinalIgnoreCase))?.File.StoragePath;
+        public string? GetPathForFile(string filename) => Files.SingleOrDefault(f => string.Equals(f.Filename, filename, StringComparison.OrdinalIgnoreCase))?.File.GetStoragePath();
 
         public bool Equals(RealmBeatmapSet? other)
         {
diff --git a/osu.Game/Models/RealmFile.cs b/osu.Game/Models/RealmFile.cs
index 2715f4be45..9e8da7cdc4 100644
--- a/osu.Game/Models/RealmFile.cs
+++ b/osu.Game/Models/RealmFile.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.IO;
 using osu.Framework.Testing;
 using osu.Game.IO;
 using Realms;
@@ -16,7 +15,5 @@ namespace osu.Game.Models
     {
         [PrimaryKey]
         public string Hash { get; set; } = string.Empty;
-
-        public string StoragePath => Path.Combine(Hash.Remove(1), Hash.Remove(2), Hash);
     }
 }
diff --git a/osu.Game/Rulesets/Edit/Checks/CheckTooShortAudioFiles.cs b/osu.Game/Rulesets/Edit/Checks/CheckTooShortAudioFiles.cs
index 57f7c60916..5cc98c5537 100644
--- a/osu.Game/Rulesets/Edit/Checks/CheckTooShortAudioFiles.cs
+++ b/osu.Game/Rulesets/Edit/Checks/CheckTooShortAudioFiles.cs
@@ -6,6 +6,7 @@ using System.IO;
 using System.Linq;
 using ManagedBass;
 using osu.Framework.Audio.Callbacks;
+using osu.Game.Extensions;
 using osu.Game.Rulesets.Edit.Checks.Components;
 
 namespace osu.Game.Rulesets.Edit.Checks
@@ -31,7 +32,7 @@ namespace osu.Game.Rulesets.Edit.Checks
 
             foreach (var file in beatmapSet.Files)
             {
-                using (Stream data = context.WorkingBeatmap.GetStream(file.FileInfo.StoragePath))
+                using (Stream data = context.WorkingBeatmap.GetStream(file.FileInfo.GetStoragePath()))
                 {
                     if (data == null)
                         continue;
diff --git a/osu.Game/Rulesets/Edit/Checks/CheckZeroByteFiles.cs b/osu.Game/Rulesets/Edit/Checks/CheckZeroByteFiles.cs
index 3a994fabfa..ab9959aec2 100644
--- a/osu.Game/Rulesets/Edit/Checks/CheckZeroByteFiles.cs
+++ b/osu.Game/Rulesets/Edit/Checks/CheckZeroByteFiles.cs
@@ -3,6 +3,7 @@
 
 using System.Collections.Generic;
 using System.IO;
+using osu.Game.Extensions;
 using osu.Game.Rulesets.Edit.Checks.Components;
 
 namespace osu.Game.Rulesets.Edit.Checks
@@ -22,7 +23,7 @@ namespace osu.Game.Rulesets.Edit.Checks
 
             foreach (var file in beatmapSet.Files)
             {
-                using (Stream data = context.WorkingBeatmap.GetStream(file.FileInfo.StoragePath))
+                using (Stream data = context.WorkingBeatmap.GetStream(file.FileInfo.GetStoragePath()))
                 {
                     if (data?.Length == 0)
                         yield return new IssueTemplateZeroBytes(this).Create(file.Filename);
diff --git a/osu.Game/Scoring/LegacyDatabasedScore.cs b/osu.Game/Scoring/LegacyDatabasedScore.cs
index 81892f65d0..69360cacc7 100644
--- a/osu.Game/Scoring/LegacyDatabasedScore.cs
+++ b/osu.Game/Scoring/LegacyDatabasedScore.cs
@@ -5,6 +5,7 @@ using System;
 using System.Linq;
 using osu.Framework.IO.Stores;
 using osu.Game.Beatmaps;
+using osu.Game.Extensions;
 using osu.Game.Rulesets;
 using osu.Game.Scoring.Legacy;
 
@@ -16,7 +17,7 @@ namespace osu.Game.Scoring
         {
             ScoreInfo = score;
 
-            string replayFilename = score.Files.FirstOrDefault(f => f.Filename.EndsWith(".osr", StringComparison.InvariantCultureIgnoreCase))?.FileInfo.StoragePath;
+            string replayFilename = score.Files.FirstOrDefault(f => f.Filename.EndsWith(".osr", StringComparison.InvariantCultureIgnoreCase))?.FileInfo.GetStoragePath();
 
             if (replayFilename == null)
                 return;
diff --git a/osu.Game/Scoring/ScoreModelManager.cs b/osu.Game/Scoring/ScoreModelManager.cs
index c65a6acdfb..c194a7166d 100644
--- a/osu.Game/Scoring/ScoreModelManager.cs
+++ b/osu.Game/Scoring/ScoreModelManager.cs
@@ -13,6 +13,7 @@ using osu.Framework.Logging;
 using osu.Framework.Platform;
 using osu.Game.Beatmaps;
 using osu.Game.Database;
+using osu.Game.Extensions;
 using osu.Game.IO.Archives;
 using osu.Game.Rulesets;
 using osu.Game.Scoring.Legacy;
@@ -77,7 +78,7 @@ namespace osu.Game.Scoring
             if (file == null)
                 return;
 
-            using (var inputStream = Files.Storage.GetStream(file.FileInfo.StoragePath))
+            using (var inputStream = Files.Storage.GetStream(file.FileInfo.GetStoragePath()))
                 inputStream.CopyTo(outputStream);
         }
 
diff --git a/osu.Game/Skinning/LegacySkinResourceStore.cs b/osu.Game/Skinning/LegacySkinResourceStore.cs
index fb06bb54d0..096b467867 100644
--- a/osu.Game/Skinning/LegacySkinResourceStore.cs
+++ b/osu.Game/Skinning/LegacySkinResourceStore.cs
@@ -7,6 +7,7 @@ using System.Linq;
 using osu.Framework.Extensions;
 using osu.Framework.IO.Stores;
 using osu.Game.Database;
+using osu.Game.Extensions;
 
 namespace osu.Game.Skinning
 {
@@ -35,7 +36,7 @@ namespace osu.Game.Skinning
         }
 
         private string getPathForFile(string filename) =>
-            source.Files.Find(f => string.Equals(f.Filename, filename, StringComparison.OrdinalIgnoreCase))?.FileInfo.StoragePath;
+            source.Files.Find(f => string.Equals(f.Filename, filename, StringComparison.OrdinalIgnoreCase))?.FileInfo.GetStoragePath();
 
         public override IEnumerable<string> GetAvailableResources() => source.Files.Select(f => f.Filename);
     }
diff --git a/osu.Game/Skinning/Skin.cs b/osu.Game/Skinning/Skin.cs
index f8f9c1172d..fae1a599d1 100644
--- a/osu.Game/Skinning/Skin.cs
+++ b/osu.Game/Skinning/Skin.cs
@@ -15,6 +15,7 @@ using osu.Framework.Graphics.OpenGL.Textures;
 using osu.Framework.Graphics.Textures;
 using osu.Framework.Logging;
 using osu.Game.Audio;
+using osu.Game.Extensions;
 using osu.Game.IO;
 using osu.Game.Screens.Play.HUD;
 
@@ -63,7 +64,7 @@ namespace osu.Game.Skinning
                 if (fileInfo == null)
                     continue;
 
-                byte[] bytes = resources?.Files.Get(fileInfo.FileInfo.StoragePath);
+                byte[] bytes = resources?.Files.Get(fileInfo.FileInfo.GetStoragePath());
 
                 if (bytes == null)
                     continue;
@@ -93,7 +94,7 @@ namespace osu.Game.Skinning
 
         private Stream getConfigurationStream()
         {
-            string path = SkinInfo.Files.SingleOrDefault(f => f.Filename.Equals(@"skin.ini", StringComparison.OrdinalIgnoreCase))?.FileInfo.StoragePath;
+            string path = SkinInfo.Files.SingleOrDefault(f => f.Filename.Equals(@"skin.ini", StringComparison.OrdinalIgnoreCase))?.FileInfo.GetStoragePath();
 
             if (string.IsNullOrEmpty(path))
                 return null;
diff --git a/osu.Game/Skinning/SkinManager.cs b/osu.Game/Skinning/SkinManager.cs
index 0739026544..6e0a8e0a11 100644
--- a/osu.Game/Skinning/SkinManager.cs
+++ b/osu.Game/Skinning/SkinManager.cs
@@ -215,7 +215,7 @@ namespace osu.Game.Skinning
             {
                 using (var sw = new StreamWriter(stream, Encoding.UTF8, 1024, true))
                 {
-                    using (var existingStream = Files.Storage.GetStream(existingFile.FileInfo.StoragePath))
+                    using (var existingStream = Files.Storage.GetStream(existingFile.FileInfo.GetStoragePath()))
                     using (var sr = new StreamReader(existingStream))
                     {
                         string line;
diff --git a/osu.Game/Stores/BeatmapImporter.cs b/osu.Game/Stores/BeatmapImporter.cs
index a9605f1fc3..dad2b29dd0 100644
--- a/osu.Game/Stores/BeatmapImporter.cs
+++ b/osu.Game/Stores/BeatmapImporter.cs
@@ -18,6 +18,7 @@ using osu.Framework.Testing;
 using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.Formats;
 using osu.Game.Database;
+using osu.Game.Extensions;
 using osu.Game.IO;
 using osu.Game.IO.Archives;
 using osu.Game.Models;
@@ -197,7 +198,7 @@ namespace osu.Game.Stores
 
             foreach (var file in files.Where(f => f.Filename.EndsWith(".osu", StringComparison.OrdinalIgnoreCase)))
             {
-                using (var memoryStream = new MemoryStream(Files.Store.Get(file.File.StoragePath))) // we need a memory stream so we can seek
+                using (var memoryStream = new MemoryStream(Files.Store.Get(file.File.GetStoragePath()))) // we need a memory stream so we can seek
                 {
                     IBeatmap decoded;
                     using (var lineReader = new LineBufferedReader(memoryStream, true))
diff --git a/osu.Game/Stores/RealmArchiveModelImporter.cs b/osu.Game/Stores/RealmArchiveModelImporter.cs
index 3398cc114d..5b8c73b218 100644
--- a/osu.Game/Stores/RealmArchiveModelImporter.cs
+++ b/osu.Game/Stores/RealmArchiveModelImporter.cs
@@ -15,6 +15,7 @@ using osu.Framework.Logging;
 using osu.Framework.Platform;
 using osu.Framework.Threading;
 using osu.Game.Database;
+using osu.Game.Extensions;
 using osu.Game.IO.Archives;
 using osu.Game.Models;
 using osu.Game.Overlays.Notifications;
@@ -305,7 +306,7 @@ namespace osu.Game.Stores
 
             foreach (RealmNamedFileUsage file in item.Files.Where(f => HashableFileTypes.Any(ext => f.Filename.EndsWith(ext, StringComparison.OrdinalIgnoreCase))).OrderBy(f => f.Filename))
             {
-                using (Stream s = Files.Store.GetStream(file.File.StoragePath))
+                using (Stream s = Files.Store.GetStream(file.File.GetStoragePath()))
                     s.CopyTo(hashable);
             }
 
diff --git a/osu.Game/Stores/RealmFileStore.cs b/osu.Game/Stores/RealmFileStore.cs
index f7b7471634..aebf330443 100644
--- a/osu.Game/Stores/RealmFileStore.cs
+++ b/osu.Game/Stores/RealmFileStore.cs
@@ -10,6 +10,7 @@ using osu.Framework.Logging;
 using osu.Framework.Platform;
 using osu.Framework.Testing;
 using osu.Game.Database;
+using osu.Game.Extensions;
 using osu.Game.Models;
 using Realms;
 
@@ -64,7 +65,7 @@ namespace osu.Game.Stores
         {
             data.Seek(0, SeekOrigin.Begin);
 
-            using (var output = Storage.GetStream(file.StoragePath, FileAccess.Write))
+            using (var output = Storage.GetStream(file.GetStoragePath(), FileAccess.Write))
                 data.CopyTo(output);
 
             data.Seek(0, SeekOrigin.Begin);
@@ -72,7 +73,7 @@ namespace osu.Game.Stores
 
         private bool checkFileExistsAndMatchesHash(RealmFile file)
         {
-            string path = file.StoragePath;
+            string path = file.GetStoragePath();
 
             // we may be re-adding a file to fix missing store entries.
             if (!Storage.Exists(path))
@@ -100,7 +101,7 @@ namespace osu.Game.Stores
 
                     try
                     {
-                        Storage.Delete(file.StoragePath);
+                        Storage.Delete(file.GetStoragePath());
                         realm.Remove(file);
                     }
                     catch (Exception e)
diff --git a/osu.Game/Storyboards/Drawables/DrawableStoryboardVideo.cs b/osu.Game/Storyboards/Drawables/DrawableStoryboardVideo.cs
index d21616955a..0625ddaffd 100644
--- a/osu.Game/Storyboards/Drawables/DrawableStoryboardVideo.cs
+++ b/osu.Game/Storyboards/Drawables/DrawableStoryboardVideo.cs
@@ -2,6 +2,7 @@
 // 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.Graphics;
@@ -9,6 +10,7 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Textures;
 using osu.Framework.Graphics.Video;
 using osu.Game.Beatmaps;
+using osu.Game.Extensions;
 
 namespace osu.Game.Storyboards.Drawables
 {
@@ -29,7 +31,7 @@ namespace osu.Game.Storyboards.Drawables
         [BackgroundDependencyLoader(true)]
         private void load(IBindable<WorkingBeatmap> beatmap, TextureStore textureStore)
         {
-            string path = beatmap.Value.BeatmapSetInfo?.Files.Find(f => f.Filename.Equals(Video.Path, StringComparison.OrdinalIgnoreCase))?.FileInfo.StoragePath;
+            string path = beatmap.Value.BeatmapSetInfo?.Files.FirstOrDefault(f => f.Filename.Equals(Video.Path, StringComparison.OrdinalIgnoreCase))?.File.GetStoragePath();
 
             if (path == null)
                 return;
diff --git a/osu.Game/Storyboards/Storyboard.cs b/osu.Game/Storyboards/Storyboard.cs
index d3d6797eae..fa90a00f0d 100644
--- a/osu.Game/Storyboards/Storyboard.cs
+++ b/osu.Game/Storyboards/Storyboard.cs
@@ -8,6 +8,7 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Graphics.Textures;
 using osu.Game.Beatmaps;
+using osu.Game.Extensions;
 using osu.Game.Skinning;
 using osu.Game.Storyboards.Drawables;
 
@@ -95,7 +96,7 @@ namespace osu.Game.Storyboards
         public Drawable CreateSpriteFromResourcePath(string path, TextureStore textureStore)
         {
             Drawable drawable = null;
-            string storyboardPath = BeatmapInfo.BeatmapSet?.Files.Find(f => f.Filename.Equals(path, StringComparison.OrdinalIgnoreCase))?.FileInfo.StoragePath;
+            string storyboardPath = BeatmapInfo.BeatmapSet?.Files.Find(f => f.Filename.Equals(path, StringComparison.OrdinalIgnoreCase))?.FileInfo.GetStoragePath();
 
             if (!string.IsNullOrEmpty(storyboardPath))
                 drawable = new Sprite { Texture = textureStore.Get(storyboardPath) };

From 215c179b929a29e0c083422f29a6031f9450ffe3 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 19 Nov 2021 16:16:20 +0900
Subject: [PATCH 1118/5547] Run nunit in blame mode

---
 .github/workflows/ci.yml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 68f8ef51ef..2139572601 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -38,7 +38,7 @@ jobs:
         run: dotnet build -c Debug -warnaserror osu.Desktop.slnf
 
       - name: Test
-        run: dotnet test $pwd/*.Tests/bin/Debug/*/*.Tests.dll --logger "trx;LogFileName=TestResults-${{matrix.os.prettyname}}-${{matrix.threadingMode}}.trx"
+        run: dotnet test $pwd/*.Tests/bin/Debug/*/*.Tests.dll --blame-crash --blame-hang --blame-hang-timeout 5m --logger "trx;LogFileName=TestResults-${{matrix.os.prettyname}}-${{matrix.threadingMode}}.trx"
         shell: pwsh
 
       # Attempt to upload results even if test fails.
@@ -48,7 +48,7 @@ jobs:
         if: ${{ always() }}
         with:
           name: osu-test-results-${{matrix.os.prettyname}}-${{matrix.threadingMode}}
-          path: ${{github.workspace}}/TestResults/TestResults-${{matrix.os.prettyname}}-${{matrix.threadingMode}}.trx
+          path: ${{github.workspace}}/TestResults/**/*
 
   build-only-android:
     name: Build only (Android)

From abb8b0de47e0e3cc5a71811b0fdc5737d993e7c8 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 19 Nov 2021 16:35:42 +0900
Subject: [PATCH 1119/5547] Also mutate multiplayer room playlist on callbacks

---
 osu.Game/Online/Multiplayer/MultiplayerClient.cs | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/osu.Game/Online/Multiplayer/MultiplayerClient.cs b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
index d757781a0a..daadef1db5 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
@@ -616,8 +616,9 @@ namespace osu.Game.Online.Multiplayer
 
                 Debug.Assert(APIRoom != null);
 
-                APIRoom.Playlist.RemoveAll(existing => existing.ID == playlistItem.ID);
+                Room.Playlist.Add(item);
                 APIRoom.Playlist.Add(playlistItem);
+
                 RoomUpdated?.Invoke();
             });
         }
@@ -634,7 +635,9 @@ namespace osu.Game.Online.Multiplayer
 
                 Debug.Assert(APIRoom != null);
 
+                Room.Playlist.Remove(Room.Playlist.Single(existing => existing.ID == playlistItemId));
                 APIRoom.Playlist.RemoveAll(existing => existing.ID == playlistItemId);
+
                 RoomUpdated?.Invoke();
             });
 
@@ -655,17 +658,14 @@ namespace osu.Game.Online.Multiplayer
 
                 Debug.Assert(APIRoom != null);
 
-                PlaylistItem existingItem = APIRoom.Playlist.Single(existing => existing.ID == item.ID);
-                int existingIndex = APIRoom.Playlist.IndexOf(existingItem);
-                if (existingItem.Equals(playlistItem))
-                    return;
+                Room.Playlist[Room.Playlist.IndexOf(Room.Playlist.First(existing => existing.ID == item.ID))] = item;
 
-                // Replace the item.
+                int existingIndex = APIRoom.Playlist.IndexOf(APIRoom.Playlist.Single(existing => existing.ID == item.ID));
                 APIRoom.Playlist.RemoveAt(existingIndex);
                 APIRoom.Playlist.Insert(existingIndex, playlistItem);
 
                 // If the currently-selected item was the one that got replaced, update the selected item to the new one.
-                if (CurrentMatchPlayingItem.Value == existingItem)
+                if (CurrentMatchPlayingItem.Value?.ID == playlistItem.ID)
                     CurrentMatchPlayingItem.Value = playlistItem;
 
                 RoomUpdated?.Invoke();

From f3f8ac2c438f8633eb6c4de5cbd94510c0b4cc78 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 19 Nov 2021 16:36:32 +0900
Subject: [PATCH 1120/5547] Use single

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

diff --git a/osu.Game/Online/Multiplayer/MultiplayerClient.cs b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
index daadef1db5..ad3c1f6781 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
@@ -658,7 +658,7 @@ namespace osu.Game.Online.Multiplayer
 
                 Debug.Assert(APIRoom != null);
 
-                Room.Playlist[Room.Playlist.IndexOf(Room.Playlist.First(existing => existing.ID == item.ID))] = item;
+                Room.Playlist[Room.Playlist.IndexOf(Room.Playlist.Single(existing => existing.ID == item.ID))] = item;
 
                 int existingIndex = APIRoom.Playlist.IndexOf(APIRoom.Playlist.Single(existing => existing.ID == item.ID));
                 APIRoom.Playlist.RemoveAt(existingIndex);

From 4e625b78e20fde95beefef4de8c67b76ce1bb0fb Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 19 Nov 2021 18:28:43 +0900
Subject: [PATCH 1121/5547] Update queue mode names

---
 ...ForAllQueueMode.cs => TestSceneAllPlayersQueueMode.cs} | 4 ++--
 osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs | 2 +-
 osu.Game/Online/Multiplayer/QueueMode.cs                  | 8 ++++----
 .../OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs   | 4 ++--
 .../Tests/Visual/Multiplayer/TestMultiplayerClient.cs     | 2 +-
 5 files changed, 10 insertions(+), 10 deletions(-)
 rename osu.Game.Tests/Visual/Multiplayer/{TestSceneFreeForAllQueueMode.cs => TestSceneAllPlayersQueueMode.cs} (96%)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneFreeForAllQueueMode.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneAllPlayersQueueMode.cs
similarity index 96%
rename from osu.Game.Tests/Visual/Multiplayer/TestSceneFreeForAllQueueMode.cs
rename to osu.Game.Tests/Visual/Multiplayer/TestSceneAllPlayersQueueMode.cs
index 967b9221bb..05cfd784eb 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneFreeForAllQueueMode.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneAllPlayersQueueMode.cs
@@ -12,9 +12,9 @@ using osuTK.Input;
 
 namespace osu.Game.Tests.Visual.Multiplayer
 {
-    public class TestSceneFreeForAllQueueMode : QueueModeTestScene
+    public class TestSceneAllPlayersQueueMode : QueueModeTestScene
     {
-        protected override QueueMode Mode => QueueMode.FreeForAll;
+        protected override QueueMode Mode => QueueMode.AllPlayers;
 
         [Test]
         public void TestFirstItemSelectedByDefault()
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
index cf14bfa312..b828379848 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
@@ -588,7 +588,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 roomManager.AddServerSideRoom(new Room
                 {
                     Name = { Value = "Test Room" },
-                    QueueMode = { Value = QueueMode.FreeForAll },
+                    QueueMode = { Value = QueueMode.AllPlayers },
                     Playlist =
                     {
                         new PlaylistItem
diff --git a/osu.Game/Online/Multiplayer/QueueMode.cs b/osu.Game/Online/Multiplayer/QueueMode.cs
index 3a9ea93658..026025890b 100644
--- a/osu.Game/Online/Multiplayer/QueueMode.cs
+++ b/osu.Game/Online/Multiplayer/QueueMode.cs
@@ -12,10 +12,10 @@ namespace osu.Game.Online.Multiplayer
         [Description("Host only")]
         HostOnly,
 
-        [Description("Free-for-all")]
-        FreeForAll,
+        [Description("All players")]
+        AllPlayers,
 
-        [Description("Fair rotate")]
-        FairRotate
+        [Description("All players (round robin)")]
+        AllPlayersRR
     }
 }
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
index 7a840a05cd..142beab024 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
@@ -392,8 +392,8 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
                     AddOrEditPlaylistButton.Alpha = client.IsHost ? 1 : 0;
                     break;
 
-                case QueueMode.FreeForAll:
-                case QueueMode.FairRotate:
+                case QueueMode.AllPlayers:
+                case QueueMode.AllPlayersRR:
                     AddOrEditPlaylistButton.Text = "Add beatmap";
                     AddOrEditPlaylistButton.Alpha = 1;
                     break;
diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
index 7e0312e566..e617ec3562 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
@@ -442,7 +442,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     newItem = room.Playlist.FirstOrDefault(i => !i.Expired) ?? room.Playlist.Last();
                     break;
 
-                case QueueMode.FairRotate:
+                case QueueMode.AllPlayersRR:
                     // Group playlist items by (user_id -> count_expired), and select the first available playlist item from a user that has available beatmaps where count_expired is the lowest.
                     throw new NotImplementedException();
             }

From 4c8c34b43f0b1a33e6d39a2ae2a00b605dc7fac0 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 19 Nov 2021 18:42:34 +0900
Subject: [PATCH 1122/5547] Use full name for round robin

---
 osu.Game/Online/Multiplayer/QueueMode.cs                        | 2 +-
 .../Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs | 2 +-
 osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs      | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Online/Multiplayer/QueueMode.cs b/osu.Game/Online/Multiplayer/QueueMode.cs
index 026025890b..3d113c028e 100644
--- a/osu.Game/Online/Multiplayer/QueueMode.cs
+++ b/osu.Game/Online/Multiplayer/QueueMode.cs
@@ -16,6 +16,6 @@ namespace osu.Game.Online.Multiplayer
         AllPlayers,
 
         [Description("All players (round robin)")]
-        AllPlayersRR
+        AllPlayersRoundRobin
     }
 }
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
index 142beab024..1e3cfdbcbb 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
@@ -393,7 +393,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
                     break;
 
                 case QueueMode.AllPlayers:
-                case QueueMode.AllPlayersRR:
+                case QueueMode.AllPlayersRoundRobin:
                     AddOrEditPlaylistButton.Text = "Add beatmap";
                     AddOrEditPlaylistButton.Alpha = 1;
                     break;
diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
index e617ec3562..4deeef331d 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
@@ -442,7 +442,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     newItem = room.Playlist.FirstOrDefault(i => !i.Expired) ?? room.Playlist.Last();
                     break;
 
-                case QueueMode.AllPlayersRR:
+                case QueueMode.AllPlayersRoundRobin:
                     // Group playlist items by (user_id -> count_expired), and select the first available playlist item from a user that has available beatmaps where count_expired is the lowest.
                     throw new NotImplementedException();
             }

From eecf6ad558983786890f5905370142fcff4d5a75 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 19 Nov 2021 21:53:40 +0900
Subject: [PATCH 1123/5547] Add `IsManaged` helper method to EF classes to
 match realm implementation

---
 osu.Game/Beatmaps/BeatmapDifficulty.cs     | 2 ++
 osu.Game/Beatmaps/BeatmapInfo.cs           | 2 ++
 osu.Game/Beatmaps/BeatmapMetadata.cs       | 2 ++
 osu.Game/Beatmaps/BeatmapSetFileInfo.cs    | 2 ++
 osu.Game/Beatmaps/BeatmapSetInfo.cs        | 2 ++
 osu.Game/Configuration/DatabasedSetting.cs | 2 ++
 osu.Game/Database/IHasPrimaryKey.cs        | 2 ++
 osu.Game/IO/FileInfo.cs                    | 2 ++
 osu.Game/Scoring/ScoreFileInfo.cs          | 2 ++
 osu.Game/Scoring/ScoreInfo.cs              | 2 ++
 osu.Game/Skinning/SkinFileInfo.cs          | 2 ++
 osu.Game/Skinning/SkinInfo.cs              | 2 ++
 12 files changed, 24 insertions(+)

diff --git a/osu.Game/Beatmaps/BeatmapDifficulty.cs b/osu.Game/Beatmaps/BeatmapDifficulty.cs
index dfd21469fa..65d1fb8286 100644
--- a/osu.Game/Beatmaps/BeatmapDifficulty.cs
+++ b/osu.Game/Beatmaps/BeatmapDifficulty.cs
@@ -15,6 +15,8 @@ namespace osu.Game.Beatmaps
 
         public int ID { get; set; }
 
+        public bool IsManaged => ID > 0;
+
         public float DrainRate { get; set; } = DEFAULT_DIFFICULTY;
         public float CircleSize { get; set; } = DEFAULT_DIFFICULTY;
         public float OverallDifficulty { get; set; } = DEFAULT_DIFFICULTY;
diff --git a/osu.Game/Beatmaps/BeatmapInfo.cs b/osu.Game/Beatmaps/BeatmapInfo.cs
index d2b322a843..7359de0cd7 100644
--- a/osu.Game/Beatmaps/BeatmapInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapInfo.cs
@@ -21,6 +21,8 @@ namespace osu.Game.Beatmaps
     {
         public int ID { get; set; }
 
+        public bool IsManaged => ID > 0;
+
         public int BeatmapVersion;
 
         private int? onlineID;
diff --git a/osu.Game/Beatmaps/BeatmapMetadata.cs b/osu.Game/Beatmaps/BeatmapMetadata.cs
index b395f16c24..5da0264893 100644
--- a/osu.Game/Beatmaps/BeatmapMetadata.cs
+++ b/osu.Game/Beatmaps/BeatmapMetadata.cs
@@ -20,6 +20,8 @@ namespace osu.Game.Beatmaps
     {
         public int ID { get; set; }
 
+        public bool IsManaged => ID > 0;
+
         public string Title { get; set; } = string.Empty;
 
         [JsonProperty("title_unicode")]
diff --git a/osu.Game/Beatmaps/BeatmapSetFileInfo.cs b/osu.Game/Beatmaps/BeatmapSetFileInfo.cs
index ce50463f05..29dcf4d6aa 100644
--- a/osu.Game/Beatmaps/BeatmapSetFileInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapSetFileInfo.cs
@@ -11,6 +11,8 @@ namespace osu.Game.Beatmaps
     {
         public int ID { get; set; }
 
+        public bool IsManaged => ID > 0;
+
         public int BeatmapSetInfoID { get; set; }
 
         public int FileInfoID { get; set; }
diff --git a/osu.Game/Beatmaps/BeatmapSetInfo.cs b/osu.Game/Beatmaps/BeatmapSetInfo.cs
index a0de50a311..db5c3bf15a 100644
--- a/osu.Game/Beatmaps/BeatmapSetInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapSetInfo.cs
@@ -16,6 +16,8 @@ namespace osu.Game.Beatmaps
     {
         public int ID { get; set; }
 
+        public bool IsManaged => ID > 0;
+
         private int? onlineID;
 
         [Column("OnlineBeatmapSetID")]
diff --git a/osu.Game/Configuration/DatabasedSetting.cs b/osu.Game/Configuration/DatabasedSetting.cs
index fe1d51d57f..65d9f7799d 100644
--- a/osu.Game/Configuration/DatabasedSetting.cs
+++ b/osu.Game/Configuration/DatabasedSetting.cs
@@ -11,6 +11,8 @@ namespace osu.Game.Configuration
     {
         public int ID { get; set; }
 
+        public bool IsManaged => ID > 0;
+
         public int? RulesetID { get; set; }
 
         public int? Variant { get; set; }
diff --git a/osu.Game/Database/IHasPrimaryKey.cs b/osu.Game/Database/IHasPrimaryKey.cs
index 3c0fc94418..51a49948fe 100644
--- a/osu.Game/Database/IHasPrimaryKey.cs
+++ b/osu.Game/Database/IHasPrimaryKey.cs
@@ -11,5 +11,7 @@ namespace osu.Game.Database
         [JsonIgnore]
         [DatabaseGenerated(DatabaseGeneratedOption.Identity)]
         int ID { get; set; }
+
+        bool IsManaged { get; }
     }
 }
diff --git a/osu.Game/IO/FileInfo.cs b/osu.Game/IO/FileInfo.cs
index 331546f9f8..360f8440f1 100644
--- a/osu.Game/IO/FileInfo.cs
+++ b/osu.Game/IO/FileInfo.cs
@@ -10,6 +10,8 @@ namespace osu.Game.IO
     {
         public int ID { get; set; }
 
+        public bool IsManaged => ID > 0;
+
         public string Hash { get; set; }
 
         public string StoragePath => Path.Combine(Hash.Remove(1), Hash.Remove(2), Hash);
diff --git a/osu.Game/Scoring/ScoreFileInfo.cs b/osu.Game/Scoring/ScoreFileInfo.cs
index 9075fdec5b..d98ef9fdc6 100644
--- a/osu.Game/Scoring/ScoreFileInfo.cs
+++ b/osu.Game/Scoring/ScoreFileInfo.cs
@@ -11,6 +11,8 @@ namespace osu.Game.Scoring
     {
         public int ID { get; set; }
 
+        public bool IsManaged => ID > 0;
+
         public int FileInfoID { get; set; }
 
         public FileInfo FileInfo { get; set; }
diff --git a/osu.Game/Scoring/ScoreInfo.cs b/osu.Game/Scoring/ScoreInfo.cs
index 736a939a59..2b02dfef9f 100644
--- a/osu.Game/Scoring/ScoreInfo.cs
+++ b/osu.Game/Scoring/ScoreInfo.cs
@@ -22,6 +22,8 @@ namespace osu.Game.Scoring
     {
         public int ID { get; set; }
 
+        public bool IsManaged => ID > 0;
+
         public ScoreRank Rank { get; set; }
 
         public long TotalScore { get; set; }
diff --git a/osu.Game/Skinning/SkinFileInfo.cs b/osu.Game/Skinning/SkinFileInfo.cs
index 8a7019e1a3..06d0d5e82e 100644
--- a/osu.Game/Skinning/SkinFileInfo.cs
+++ b/osu.Game/Skinning/SkinFileInfo.cs
@@ -11,6 +11,8 @@ namespace osu.Game.Skinning
     {
         public int ID { get; set; }
 
+        public bool IsManaged => ID > 0;
+
         public int SkinInfoID { get; set; }
 
         public int FileInfoID { get; set; }
diff --git a/osu.Game/Skinning/SkinInfo.cs b/osu.Game/Skinning/SkinInfo.cs
index 3b34e23d57..307bb2f9cd 100644
--- a/osu.Game/Skinning/SkinInfo.cs
+++ b/osu.Game/Skinning/SkinInfo.cs
@@ -18,6 +18,8 @@ namespace osu.Game.Skinning
 
         public int ID { get; set; }
 
+        public bool IsManaged => ID > 0;
+
         public string Name { get; set; } = string.Empty;
 
         public string Creator { get; set; } = string.Empty;

From 5d252f6fc09da218c857883aa0f55d6d81c1d460 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 18 Nov 2021 16:50:07 +0300
Subject: [PATCH 1124/5547] Add rider autogenerated .idea files for iOS
 solution filter

---
 .idea/.idea.osu.iOS/.idea/.name                      | 1 +
 .idea/.idea.osu.iOS/.idea/indexLayout.xml            | 8 ++++++++
 .idea/.idea.osu.iOS/.idea/misc.xml                   | 6 ++++++
 .idea/.idea.osu.iOS/.idea/projectSettingsUpdater.xml | 6 ++++++
 .idea/.idea.osu.iOS/.idea/vcs.xml                    | 6 ++++++
 5 files changed, 27 insertions(+)
 create mode 100644 .idea/.idea.osu.iOS/.idea/.name
 create mode 100644 .idea/.idea.osu.iOS/.idea/indexLayout.xml
 create mode 100644 .idea/.idea.osu.iOS/.idea/misc.xml
 create mode 100644 .idea/.idea.osu.iOS/.idea/projectSettingsUpdater.xml
 create mode 100644 .idea/.idea.osu.iOS/.idea/vcs.xml

diff --git a/.idea/.idea.osu.iOS/.idea/.name b/.idea/.idea.osu.iOS/.idea/.name
new file mode 100644
index 0000000000..0dba29f2dc
--- /dev/null
+++ b/.idea/.idea.osu.iOS/.idea/.name
@@ -0,0 +1 @@
+osu.iOS
\ No newline at end of file
diff --git a/.idea/.idea.osu.iOS/.idea/indexLayout.xml b/.idea/.idea.osu.iOS/.idea/indexLayout.xml
new file mode 100644
index 0000000000..7b08163ceb
--- /dev/null
+++ b/.idea/.idea.osu.iOS/.idea/indexLayout.xml
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="UserContentModel">
+    <attachedFolders />
+    <explicitIncludes />
+    <explicitExcludes />
+  </component>
+</project>
\ No newline at end of file
diff --git a/.idea/.idea.osu.iOS/.idea/misc.xml b/.idea/.idea.osu.iOS/.idea/misc.xml
new file mode 100644
index 0000000000..1d8c84d0af
--- /dev/null
+++ b/.idea/.idea.osu.iOS/.idea/misc.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="com.jetbrains.rider.android.RiderAndroidMiscFileCreationComponent">
+    <option name="ENSURE_MISC_FILE_EXISTS" value="true" />
+  </component>
+</project>
\ No newline at end of file
diff --git a/.idea/.idea.osu.iOS/.idea/projectSettingsUpdater.xml b/.idea/.idea.osu.iOS/.idea/projectSettingsUpdater.xml
new file mode 100644
index 0000000000..4bb9f4d2a0
--- /dev/null
+++ b/.idea/.idea.osu.iOS/.idea/projectSettingsUpdater.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="RiderProjectSettingsUpdater">
+    <option name="vcsConfiguration" value="2" />
+  </component>
+</project>
\ No newline at end of file
diff --git a/.idea/.idea.osu.iOS/.idea/vcs.xml b/.idea/.idea.osu.iOS/.idea/vcs.xml
new file mode 100644
index 0000000000..94a25f7f4c
--- /dev/null
+++ b/.idea/.idea.osu.iOS/.idea/vcs.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="VcsDirectoryMappings">
+    <mapping directory="$PROJECT_DIR$" vcs="Git" />
+  </component>
+</project>
\ No newline at end of file

From eb1bcf941f06f4ffd8ee1cba6c06d7a4fb42d089 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 19 Nov 2021 15:11:33 +0300
Subject: [PATCH 1125/5547] Sync `DiffPlex` dependency version with game
 project

---
 osu.iOS.props | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.iOS.props b/osu.iOS.props
index f81217d6dd..b4306d8a0b 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -78,7 +78,7 @@
   </ItemGroup>
   <!-- Xamarin.iOS does not automatically handle transitive dependencies from NuGet packages. -->
   <ItemGroup Label="Transitive Dependencies">
-    <PackageReference Include="DiffPlex" Version="1.6.3" />
+    <PackageReference Include="DiffPlex" Version="1.7.0" />
     <PackageReference Include="Humanizer" Version="2.11.10" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="2.2.6" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.Core" Version="2.2.6" />

From 83b4625bd54cff98c758e82daf4fd8fc5ec27e46 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 19 Nov 2021 22:13:07 +0900
Subject: [PATCH 1126/5547] Replace existing cases with new helper method

---
 .../Visual/Editing/TestSceneEditorBeatmapCreation.cs        | 2 +-
 osu.Game/Beatmaps/BeatmapDifficultyCache.cs                 | 2 +-
 osu.Game/Database/ArchiveModelManager.cs                    | 6 +++---
 osu.Game/Overlays/Settings/Sections/SkinSection.cs          | 4 ++--
 osu.Game/Screens/Select/SongSelect.cs                       | 4 ++--
 osu.Game/Skinning/SkinManager.cs                            | 2 +-
 6 files changed, 10 insertions(+), 10 deletions(-)

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneEditorBeatmapCreation.cs b/osu.Game.Tests/Visual/Editing/TestSceneEditorBeatmapCreation.cs
index 92c8131568..db20d3c7ba 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneEditorBeatmapCreation.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneEditorBeatmapCreation.cs
@@ -49,7 +49,7 @@ namespace osu.Game.Tests.Visual.Editing
         public void TestCreateNewBeatmap()
         {
             AddStep("save beatmap", () => Editor.Save());
-            AddAssert("new beatmap persisted", () => EditorBeatmap.BeatmapInfo.ID > 0);
+            AddAssert("new beatmap persisted", () => EditorBeatmap.BeatmapInfo.IsManaged);
             AddAssert("new beatmap in database", () => beatmapManager.QueryBeatmapSet(s => s.ID == EditorBeatmap.BeatmapInfo.BeatmapSet.ID)?.DeletePending == false);
         }
 
diff --git a/osu.Game/Beatmaps/BeatmapDifficultyCache.cs b/osu.Game/Beatmaps/BeatmapDifficultyCache.cs
index 5f20bf49b9..17d64bce4d 100644
--- a/osu.Game/Beatmaps/BeatmapDifficultyCache.cs
+++ b/osu.Game/Beatmaps/BeatmapDifficultyCache.cs
@@ -131,7 +131,7 @@ namespace osu.Game.Beatmaps
             var localRulesetInfo = rulesetInfo as RulesetInfo;
 
             // Difficulty can only be computed if the beatmap and ruleset are locally available.
-            if (localBeatmapInfo == null || localBeatmapInfo.ID == 0 || localRulesetInfo == null)
+            if (localBeatmapInfo?.IsManaged != true || localRulesetInfo == null)
             {
                 // If not, fall back to the existing star difficulty (e.g. from an online source).
                 return Task.FromResult(new StarDifficulty(beatmapInfo.StarRating, (beatmapInfo as IBeatmapOnlineInfo)?.MaxCombo ?? 0));
diff --git a/osu.Game/Database/ArchiveModelManager.cs b/osu.Game/Database/ArchiveModelManager.cs
index e8b6996869..5f9304448a 100644
--- a/osu.Game/Database/ArchiveModelManager.cs
+++ b/osu.Game/Database/ArchiveModelManager.cs
@@ -516,7 +516,7 @@ namespace osu.Game.Database
                 {
                     Files.Dereference(file.FileInfo);
 
-                    if (file.ID > 0)
+                    if (file.IsManaged)
                     {
                         // This shouldn't be required, but here for safety in case the provided TModel is not being change tracked
                         // Definitely can be removed once we rework the database backend.
@@ -545,7 +545,7 @@ namespace osu.Game.Database
                 });
             }
 
-            if (model.ID > 0)
+            if (model.IsManaged)
                 Update(model);
         }
 
@@ -811,7 +811,7 @@ namespace osu.Game.Database
         /// <param name="items">The usable items present in the store.</param>
         /// <returns>Whether the <typeparamref name="TModel"/> exists.</returns>
         protected virtual bool CheckLocalAvailability(TModel model, IQueryable<TModel> items)
-            => model.ID > 0 && items.Any(i => i.ID == model.ID && i.Files.Any());
+            => model.IsManaged && items.Any(i => i.ID == model.ID && i.Files.Any());
 
         /// <summary>
         /// Whether import can be skipped after finding an existing import early in the process.
diff --git a/osu.Game/Overlays/Settings/Sections/SkinSection.cs b/osu.Game/Overlays/Settings/Sections/SkinSection.cs
index 0714b28b47..e17abb5936 100644
--- a/osu.Game/Overlays/Settings/Sections/SkinSection.cs
+++ b/osu.Game/Overlays/Settings/Sections/SkinSection.cs
@@ -45,7 +45,7 @@ namespace osu.Game.Overlays.Settings.Sections
         {
             get
             {
-                int index = skinItems.FindIndex(s => s.ID > 0);
+                int index = skinItems.FindIndex(s => s.IsManaged);
                 if (index < 0)
                     index = skinItems.Count;
 
@@ -176,7 +176,7 @@ namespace osu.Game.Overlays.Settings.Sections
                 Action = export;
 
                 currentSkin = skins.CurrentSkin.GetBoundCopy();
-                currentSkin.BindValueChanged(skin => Enabled.Value = skin.NewValue.SkinInfo.ID > 0, true);
+                currentSkin.BindValueChanged(skin => Enabled.Value = skin.NewValue.SkinInfo.IsManaged, true);
             }
 
             private void export()
diff --git a/osu.Game/Screens/Select/SongSelect.cs b/osu.Game/Screens/Select/SongSelect.cs
index 2c36bf5fc8..969a6e0290 100644
--- a/osu.Game/Screens/Select/SongSelect.cs
+++ b/osu.Game/Screens/Select/SongSelect.cs
@@ -805,14 +805,14 @@ namespace osu.Game.Screens.Select
 
         private void delete(BeatmapSetInfo beatmap)
         {
-            if (beatmap == null || beatmap.ID <= 0) return;
+            if (beatmap == null || !beatmap.IsManaged) return;
 
             dialogOverlay?.Push(new BeatmapDeleteDialog(beatmap));
         }
 
         private void clearScores(BeatmapInfo beatmapInfo)
         {
-            if (beatmapInfo == null || beatmapInfo.ID <= 0) return;
+            if (beatmapInfo == null || !beatmapInfo.IsManaged) return;
 
             dialogOverlay?.Push(new BeatmapClearScoresDialog(beatmapInfo, () =>
                 // schedule done here rather than inside the dialog as the dialog may fade out and never callback.
diff --git a/osu.Game/Skinning/SkinManager.cs b/osu.Game/Skinning/SkinManager.cs
index 0739026544..2887d03029 100644
--- a/osu.Game/Skinning/SkinManager.cs
+++ b/osu.Game/Skinning/SkinManager.cs
@@ -307,7 +307,7 @@ namespace osu.Game.Skinning
 
         public void Save(Skin skin)
         {
-            if (skin.SkinInfo.ID <= 0)
+            if (!skin.SkinInfo.IsManaged)
                 throw new InvalidOperationException($"Attempting to save a skin which is not yet tracked. Call {nameof(EnsureMutableSkin)} first.");
 
             foreach (var drawableInfo in skin.DrawableComponentInfo)

From 96a5136c537361b277e1f9788fc6b777dc39ef8b Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 19 Nov 2021 17:56:07 +0300
Subject: [PATCH 1127/5547] Update framework

---
 osu.Android.props        | 2 +-
 osu.Game/osu.Game.csproj | 2 +-
 osu.iOS.props            | 4 ++--
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Android.props b/osu.Android.props
index cbd1c92fbe..25c68343c7 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -52,7 +52,7 @@
   </ItemGroup>
   <ItemGroup>
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1112.0" />
-    <PackageReference Include="ppy.osu.Framework.Android" Version="2021.1118.0" />
+    <PackageReference Include="ppy.osu.Framework.Android" Version="2021.1119.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
     <!-- Realm needs to be directly referenced in all Xamarin projects, as it will not pull in its transitive dependencies otherwise. -->
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 6b722f00ea..e175444724 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="10.6.0" />
-    <PackageReference Include="ppy.osu.Framework" Version="2021.1118.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2021.1119.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1112.0" />
     <PackageReference Include="Sentry" Version="3.10.0" />
     <PackageReference Include="SharpCompress" Version="0.30.0" />
diff --git a/osu.iOS.props b/osu.iOS.props
index ce78bafb6d..aed6860f21 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -60,7 +60,7 @@
     <Reference Include="System.Net.Http" />
   </ItemGroup>
   <ItemGroup Label="Package References">
-    <PackageReference Include="ppy.osu.Framework.iOS" Version="2021.1118.0" />
+    <PackageReference Include="ppy.osu.Framework.iOS" Version="2021.1119.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1112.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net5.0 / net6.0) -->
@@ -83,7 +83,7 @@
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="2.2.6" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.Core" Version="2.2.6" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
-    <PackageReference Include="ppy.osu.Framework" Version="2021.1118.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2021.1119.0" />
     <PackageReference Include="SharpCompress" Version="0.30.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
     <PackageReference Include="SharpRaven" Version="2.4.0" />

From 0342923408b83b2300ff70dbf8baa3308df63a07 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 19 Nov 2021 19:03:52 +0300
Subject: [PATCH 1128/5547] Fix SignalR messagepack formatter potentially
 initializing on iOS

---
 osu.Game/Online/SignalRUnionWorkaroundResolver.cs | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Online/SignalRUnionWorkaroundResolver.cs b/osu.Game/Online/SignalRUnionWorkaroundResolver.cs
index 21413f8285..89052ad052 100644
--- a/osu.Game/Online/SignalRUnionWorkaroundResolver.cs
+++ b/osu.Game/Online/SignalRUnionWorkaroundResolver.cs
@@ -35,7 +35,9 @@ namespace osu.Game.Online
             typeof(TeamVersusUserState),
         };
 
-        private static readonly IReadOnlyDictionary<Type, IMessagePackFormatter> formatter_map = new Dictionary<Type, IMessagePackFormatter>
+        private static IReadOnlyDictionary<Type, IMessagePackFormatter> formatterMapBacking;
+
+        private static IReadOnlyDictionary<Type, IMessagePackFormatter> formatterMap => formatterMapBacking ??= new Dictionary<Type, IMessagePackFormatter>
         {
             { typeof(TeamVersusUserState), new TypeRedirectingFormatter<TeamVersusUserState, MatchUserState>() },
             { typeof(TeamVersusRoomState), new TypeRedirectingFormatter<TeamVersusRoomState, MatchRoomState>() },
@@ -51,7 +53,7 @@ namespace osu.Game.Online
 
         public IMessagePackFormatter<T> GetFormatter<T>()
         {
-            if (formatter_map.TryGetValue(typeof(T), out var formatter))
+            if (formatterMap.TryGetValue(typeof(T), out var formatter))
                 return (IMessagePackFormatter<T>)formatter;
 
             return StandardResolver.Instance.GetFormatter<T>();

From e0629ba81c3afa3caac9ea1851cace6ad3f624e8 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 20 Nov 2021 13:31:10 +0900
Subject: [PATCH 1129/5547] Update all dependencies

---
 .../osu.Game.Rulesets.EmptyFreeform.Tests.csproj       |  2 +-
 .../osu.Game.Rulesets.Pippidon.Tests.csproj            |  2 +-
 .../osu.Game.Rulesets.EmptyScrolling.Tests.csproj      |  2 +-
 .../osu.Game.Rulesets.Pippidon.Tests.csproj            |  2 +-
 osu.Game.Benchmarks/osu.Game.Benchmarks.csproj         |  2 +-
 .../osu.Game.Rulesets.Catch.Tests.csproj               |  2 +-
 .../osu.Game.Rulesets.Mania.Tests.csproj               |  2 +-
 .../osu.Game.Rulesets.Osu.Tests.csproj                 |  2 +-
 .../osu.Game.Rulesets.Taiko.Tests.csproj               |  2 +-
 osu.Game.Tests/osu.Game.Tests.csproj                   |  2 +-
 .../osu.Game.Tournament.Tests.csproj                   |  2 +-
 osu.Game/osu.Game.csproj                               | 10 +++++-----
 12 files changed, 16 insertions(+), 16 deletions(-)

diff --git a/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform.Tests/osu.Game.Rulesets.EmptyFreeform.Tests.csproj b/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform.Tests/osu.Game.Rulesets.EmptyFreeform.Tests.csproj
index e9b92be0c3..3c6aaa39ca 100644
--- a/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform.Tests/osu.Game.Rulesets.EmptyFreeform.Tests.csproj
+++ b/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform.Tests/osu.Game.Rulesets.EmptyFreeform.Tests.csproj
@@ -12,7 +12,7 @@
     <PackageReference Include="Appveyor.TestLogger" Version="2.0.0" />
     <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.0.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
-    <PackageReference Include="NUnit3TestAdapter" Version="4.0.0" />
+    <PackageReference Include="NUnit3TestAdapter" Version="4.1.0" />
     <PackageReference Update="Microsoft.EntityFrameworkCore.Sqlite" Version="2.1.4" />
   </ItemGroup>
   <ItemGroup>
diff --git a/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon.Tests/osu.Game.Rulesets.Pippidon.Tests.csproj b/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon.Tests/osu.Game.Rulesets.Pippidon.Tests.csproj
index e145dd7b69..0719dd30df 100644
--- a/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon.Tests/osu.Game.Rulesets.Pippidon.Tests.csproj
+++ b/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon.Tests/osu.Game.Rulesets.Pippidon.Tests.csproj
@@ -12,7 +12,7 @@
     <PackageReference Include="Appveyor.TestLogger" Version="2.0.0" />
     <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.0.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
-    <PackageReference Include="NUnit3TestAdapter" Version="4.0.0" />
+    <PackageReference Include="NUnit3TestAdapter" Version="4.1.0" />
     <PackageReference Update="Microsoft.EntityFrameworkCore.Sqlite" Version="2.1.4" />
   </ItemGroup>
   <ItemGroup>
diff --git a/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling.Tests/osu.Game.Rulesets.EmptyScrolling.Tests.csproj b/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling.Tests/osu.Game.Rulesets.EmptyScrolling.Tests.csproj
index a301432a6c..d0db43cc81 100644
--- a/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling.Tests/osu.Game.Rulesets.EmptyScrolling.Tests.csproj
+++ b/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling.Tests/osu.Game.Rulesets.EmptyScrolling.Tests.csproj
@@ -12,7 +12,7 @@
     <PackageReference Include="Appveyor.TestLogger" Version="2.0.0" />
     <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.0.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
-    <PackageReference Include="NUnit3TestAdapter" Version="4.0.0" />
+    <PackageReference Include="NUnit3TestAdapter" Version="4.1.0" />
     <PackageReference Update="Microsoft.EntityFrameworkCore.Sqlite" Version="2.1.4" />
   </ItemGroup>
   <ItemGroup>
diff --git a/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon.Tests/osu.Game.Rulesets.Pippidon.Tests.csproj b/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon.Tests/osu.Game.Rulesets.Pippidon.Tests.csproj
index e145dd7b69..0719dd30df 100644
--- a/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon.Tests/osu.Game.Rulesets.Pippidon.Tests.csproj
+++ b/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon.Tests/osu.Game.Rulesets.Pippidon.Tests.csproj
@@ -12,7 +12,7 @@
     <PackageReference Include="Appveyor.TestLogger" Version="2.0.0" />
     <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.0.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
-    <PackageReference Include="NUnit3TestAdapter" Version="4.0.0" />
+    <PackageReference Include="NUnit3TestAdapter" Version="4.1.0" />
     <PackageReference Update="Microsoft.EntityFrameworkCore.Sqlite" Version="2.1.4" />
   </ItemGroup>
   <ItemGroup>
diff --git a/osu.Game.Benchmarks/osu.Game.Benchmarks.csproj b/osu.Game.Benchmarks/osu.Game.Benchmarks.csproj
index 03f39f226c..57b914bee6 100644
--- a/osu.Game.Benchmarks/osu.Game.Benchmarks.csproj
+++ b/osu.Game.Benchmarks/osu.Game.Benchmarks.csproj
@@ -9,7 +9,7 @@
   <ItemGroup>
     <PackageReference Include="BenchmarkDotNet" Version="0.13.1" />
     <PackageReference Include="nunit" Version="3.13.2" />
-    <PackageReference Include="NUnit3TestAdapter" Version="4.0.0" />
+    <PackageReference Include="NUnit3TestAdapter" Version="4.1.0" />
   </ItemGroup>
 
   <ItemGroup>
diff --git a/osu.Game.Rulesets.Catch.Tests/osu.Game.Rulesets.Catch.Tests.csproj b/osu.Game.Rulesets.Catch.Tests/osu.Game.Rulesets.Catch.Tests.csproj
index 4c8b9b2b08..13f2e25f05 100644
--- a/osu.Game.Rulesets.Catch.Tests/osu.Game.Rulesets.Catch.Tests.csproj
+++ b/osu.Game.Rulesets.Catch.Tests/osu.Game.Rulesets.Catch.Tests.csproj
@@ -4,7 +4,7 @@
     <PackageReference Include="Appveyor.TestLogger" Version="2.0.0" />
     <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.0.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
-    <PackageReference Include="NUnit3TestAdapter" Version="4.0.0" />
+    <PackageReference Include="NUnit3TestAdapter" Version="4.1.0" />
     <PackageReference Update="Microsoft.EntityFrameworkCore.Sqlite" Version="2.1.4" />
   </ItemGroup>
   <PropertyGroup Label="Project">
diff --git a/osu.Game.Rulesets.Mania.Tests/osu.Game.Rulesets.Mania.Tests.csproj b/osu.Game.Rulesets.Mania.Tests/osu.Game.Rulesets.Mania.Tests.csproj
index fad39ef9d6..d51a6da4f9 100644
--- a/osu.Game.Rulesets.Mania.Tests/osu.Game.Rulesets.Mania.Tests.csproj
+++ b/osu.Game.Rulesets.Mania.Tests/osu.Game.Rulesets.Mania.Tests.csproj
@@ -4,7 +4,7 @@
     <PackageReference Include="Appveyor.TestLogger" Version="2.0.0" />
     <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.0.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
-    <PackageReference Include="NUnit3TestAdapter" Version="4.0.0" />
+    <PackageReference Include="NUnit3TestAdapter" Version="4.1.0" />
     <PackageReference Update="Microsoft.EntityFrameworkCore.Sqlite" Version="2.1.4" />
   </ItemGroup>
   <PropertyGroup Label="Project">
diff --git a/osu.Game.Rulesets.Osu.Tests/osu.Game.Rulesets.Osu.Tests.csproj b/osu.Game.Rulesets.Osu.Tests/osu.Game.Rulesets.Osu.Tests.csproj
index 66f4ad3d3f..fea2e408f6 100644
--- a/osu.Game.Rulesets.Osu.Tests/osu.Game.Rulesets.Osu.Tests.csproj
+++ b/osu.Game.Rulesets.Osu.Tests/osu.Game.Rulesets.Osu.Tests.csproj
@@ -5,7 +5,7 @@
     <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.0.0" />
     <PackageReference Include="Moq" Version="4.16.1" />
     <PackageReference Include="NUnit" Version="3.13.2" />
-    <PackageReference Include="NUnit3TestAdapter" Version="4.0.0" />
+    <PackageReference Include="NUnit3TestAdapter" Version="4.1.0" />
     <PackageReference Update="Microsoft.EntityFrameworkCore.Sqlite" Version="2.1.4" />
   </ItemGroup>
   <PropertyGroup Label="Project">
diff --git a/osu.Game.Rulesets.Taiko.Tests/osu.Game.Rulesets.Taiko.Tests.csproj b/osu.Game.Rulesets.Taiko.Tests/osu.Game.Rulesets.Taiko.Tests.csproj
index 568e35c221..ad3713e047 100644
--- a/osu.Game.Rulesets.Taiko.Tests/osu.Game.Rulesets.Taiko.Tests.csproj
+++ b/osu.Game.Rulesets.Taiko.Tests/osu.Game.Rulesets.Taiko.Tests.csproj
@@ -4,7 +4,7 @@
     <PackageReference Include="Appveyor.TestLogger" Version="2.0.0" />
     <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.0.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
-    <PackageReference Include="NUnit3TestAdapter" Version="4.0.0" />
+    <PackageReference Include="NUnit3TestAdapter" Version="4.1.0" />
     <PackageReference Update="Microsoft.EntityFrameworkCore.Sqlite" Version="2.1.4" />
   </ItemGroup>
   <PropertyGroup Label="Project">
diff --git a/osu.Game.Tests/osu.Game.Tests.csproj b/osu.Game.Tests/osu.Game.Tests.csproj
index 57815d9273..3b115d43e5 100644
--- a/osu.Game.Tests/osu.Game.Tests.csproj
+++ b/osu.Game.Tests/osu.Game.Tests.csproj
@@ -6,7 +6,7 @@
     <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.0.0" />
     <PackageReference Include="Nito.AsyncEx" Version="5.1.2" />
     <PackageReference Include="NUnit" Version="3.13.2" />
-    <PackageReference Include="NUnit3TestAdapter" Version="4.0.0" />
+    <PackageReference Include="NUnit3TestAdapter" Version="4.1.0" />
     <PackageReference Update="Microsoft.EntityFrameworkCore.Sqlite" Version="2.1.4" />
     <PackageReference Include="Moq" Version="4.16.1" />
   </ItemGroup>
diff --git a/osu.Game.Tournament.Tests/osu.Game.Tournament.Tests.csproj b/osu.Game.Tournament.Tests/osu.Game.Tournament.Tests.csproj
index c0f94d49c7..130fcfaca1 100644
--- a/osu.Game.Tournament.Tests/osu.Game.Tournament.Tests.csproj
+++ b/osu.Game.Tournament.Tests/osu.Game.Tournament.Tests.csproj
@@ -7,7 +7,7 @@
     <PackageReference Include="Appveyor.TestLogger" Version="2.0.0" />
     <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.0.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
-    <PackageReference Include="NUnit3TestAdapter" Version="4.0.0" />
+    <PackageReference Include="NUnit3TestAdapter" Version="4.1.0" />
   </ItemGroup>
   <PropertyGroup Label="Project">
     <OutputType>WinExe</OutputType>
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 6b722f00ea..2f26e45ba8 100644
--- a/osu.Game/osu.Game.csproj
+++ b/osu.Game/osu.Game.csproj
@@ -20,8 +20,8 @@
   <ItemGroup Label="Package References">
     <PackageReference Include="AutoMapper" Version="10.1.1" />
     <PackageReference Include="DiffPlex" Version="1.7.0" />
-    <PackageReference Include="HtmlAgilityPack" Version="1.11.37" />
-    <PackageReference Include="Humanizer" Version="2.11.10" />
+    <PackageReference Include="HtmlAgilityPack" Version="1.11.38" />
+    <PackageReference Include="Humanizer" Version="2.13.14" />
     <PackageReference Include="MessagePack" Version="2.3.85" />
     <PackageReference Include="Microsoft.AspNetCore.SignalR.Client" Version="5.0.11" />
     <PackageReference Include="Microsoft.AspNetCore.SignalR.Protocols.MessagePack" Version="5.0.11" />
@@ -35,10 +35,10 @@
       <PrivateAssets>all</PrivateAssets>
       <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
     </PackageReference>
-    <PackageReference Include="Realm" Version="10.6.0" />
-    <PackageReference Include="ppy.osu.Framework" Version="2021.1118.0" />
+    <PackageReference Include="Realm" Version="10.7.1" />
+    <PackageReference Include="ppy.osu.Framework" Version="2021.1119.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1112.0" />
-    <PackageReference Include="Sentry" Version="3.10.0" />
+    <PackageReference Include="Sentry" Version="3.11.1" />
     <PackageReference Include="SharpCompress" Version="0.30.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
     <PackageReference Include="System.ComponentModel.Annotations" Version="5.0.0" />

From 50e18ccebbb8536d1422ad1700f3b699e054c75e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 20 Nov 2021 15:14:06 +0900
Subject: [PATCH 1130/5547] Update dependencies in mobile props files

---
 osu.Android.props | 4 ++--
 osu.iOS.props     | 4 ++--
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Android.props b/osu.Android.props
index cbd1c92fbe..d80fb858e9 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -52,10 +52,10 @@
   </ItemGroup>
   <ItemGroup>
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1112.0" />
-    <PackageReference Include="ppy.osu.Framework.Android" Version="2021.1118.0" />
+    <PackageReference Include="ppy.osu.Framework.Android" Version="2021.1119.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
     <!-- Realm needs to be directly referenced in all Xamarin projects, as it will not pull in its transitive dependencies otherwise. -->
-    <PackageReference Include="Realm" Version="10.6.0" />
+    <PackageReference Include="Realm" Version="10.7.1" />
   </ItemGroup>
 </Project>
diff --git a/osu.iOS.props b/osu.iOS.props
index 00cbe2c849..07b529b5cd 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -70,7 +70,7 @@
     <Reference Include="System.Net.Http" />
   </ItemGroup>
   <ItemGroup Label="Package References">
-    <PackageReference Include="ppy.osu.Framework.iOS" Version="2021.1118.0" />
+    <PackageReference Include="ppy.osu.Framework.iOS" Version="2021.1119.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1112.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net5.0 / net6.0) -->
@@ -99,6 +99,6 @@
     <PackageReference Include="SharpRaven" Version="2.4.0" />
     <PackageReference Include="System.ComponentModel.Annotations" Version="5.0.0" />
     <PackageReference Include="ppy.osu.Framework.NativeLibs" Version="2021.805.0" ExcludeAssets="all" />
-    <PackageReference Include="Realm" Version="10.6.0" />
+    <PackageReference Include="Realm" Version="10.7.1" />
   </ItemGroup>
 </Project>

From a8a2ffde420503aedf88507e1340270664e829cb Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sat, 20 Nov 2021 12:01:42 +0300
Subject: [PATCH 1131/5547] Sync iOS transitive dependency versions with game

---
 osu.iOS.props | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.iOS.props b/osu.iOS.props
index 07b529b5cd..fbbccdc069 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -88,12 +88,12 @@
   </ItemGroup>
   <!-- Xamarin.iOS does not automatically handle transitive dependencies from NuGet packages. -->
   <ItemGroup Label="Transitive Dependencies">
-    <PackageReference Include="DiffPlex" Version="1.6.3" />
-    <PackageReference Include="Humanizer" Version="2.11.10" />
+    <PackageReference Include="DiffPlex" Version="1.7.0" />
+    <PackageReference Include="Humanizer" Version="2.13.14" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="2.2.6" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.Core" Version="2.2.6" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
-    <PackageReference Include="ppy.osu.Framework" Version="2021.1118.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2021.1119.0" />
     <PackageReference Include="SharpCompress" Version="0.30.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
     <PackageReference Include="SharpRaven" Version="2.4.0" />

From 8b28bf31f69e44a1922ddc7a649c3f6d63875a48 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sat, 20 Nov 2021 15:11:02 +0300
Subject: [PATCH 1132/5547] Separate SignalR workaround types away from
 resolver

---
 ...gnalRDerivedTypeWorkaroundJsonConverter.cs |  7 +--
 .../Online/SignalRUnionWorkaroundResolver.cs  | 45 +++++++------------
 osu.Game/Online/SignalRWorkaroundTypes.cs     | 26 +++++++++++
 3 files changed, 45 insertions(+), 33 deletions(-)
 create mode 100644 osu.Game/Online/SignalRWorkaroundTypes.cs

diff --git a/osu.Game/Online/SignalRDerivedTypeWorkaroundJsonConverter.cs b/osu.Game/Online/SignalRDerivedTypeWorkaroundJsonConverter.cs
index 55516d2223..5643c5ca74 100644
--- a/osu.Game/Online/SignalRDerivedTypeWorkaroundJsonConverter.cs
+++ b/osu.Game/Online/SignalRDerivedTypeWorkaroundJsonConverter.cs
@@ -17,8 +17,9 @@ namespace osu.Game.Online
     public class SignalRDerivedTypeWorkaroundJsonConverter : JsonConverter
     {
         public override bool CanConvert(Type objectType) =>
-            SignalRUnionWorkaroundResolver.BASE_TYPES.Contains(objectType) ||
-            SignalRUnionWorkaroundResolver.DERIVED_TYPES.Contains(objectType);
+            SignalRWorkaroundTypes.BASE_DERIVED.Any(t =>
+                objectType == t.baseType ||
+                objectType == t.derivedType);
 
         public override object? ReadJson(JsonReader reader, Type objectType, object? o, JsonSerializer jsonSerializer)
         {
@@ -29,7 +30,7 @@ namespace osu.Game.Online
 
             string type = (string)obj[@"$dtype"]!;
 
-            var resolvedType = SignalRUnionWorkaroundResolver.DERIVED_TYPES.Single(t => t.Name == type);
+            var resolvedType = SignalRWorkaroundTypes.BASE_DERIVED.Select(t => t.derivedType).Single(t => t.Name == type);
 
             object? instance = Activator.CreateInstance(resolvedType);
 
diff --git a/osu.Game/Online/SignalRUnionWorkaroundResolver.cs b/osu.Game/Online/SignalRUnionWorkaroundResolver.cs
index 89052ad052..01e3c24c87 100644
--- a/osu.Game/Online/SignalRUnionWorkaroundResolver.cs
+++ b/osu.Game/Online/SignalRUnionWorkaroundResolver.cs
@@ -3,11 +3,10 @@
 
 using System;
 using System.Collections.Generic;
+using System.Linq;
 using MessagePack;
 using MessagePack.Formatters;
 using MessagePack.Resolvers;
-using osu.Game.Online.Multiplayer;
-using osu.Game.Online.Multiplayer.MatchTypes.TeamVersus;
 
 namespace osu.Game.Online
 {
@@ -20,40 +19,26 @@ namespace osu.Game.Online
         public static readonly MessagePackSerializerOptions OPTIONS =
             MessagePackSerializerOptions.Standard.WithResolver(new SignalRUnionWorkaroundResolver());
 
-        public static readonly IReadOnlyList<Type> BASE_TYPES = new[]
+        private static readonly IReadOnlyDictionary<Type, IMessagePackFormatter> formatter_map = createFormatterMap();
+
+        private static IReadOnlyDictionary<Type, IMessagePackFormatter> createFormatterMap()
         {
-            typeof(MatchServerEvent),
-            typeof(MatchUserRequest),
-            typeof(MatchRoomState),
-            typeof(MatchUserState),
-        };
+            IEnumerable<(Type derivedType, Type baseType)> baseDerived = SignalRWorkaroundTypes.BASE_DERIVED;
 
-        public static readonly IReadOnlyList<Type> DERIVED_TYPES = new[]
-        {
-            typeof(ChangeTeamRequest),
-            typeof(TeamVersusRoomState),
-            typeof(TeamVersusUserState),
-        };
-
-        private static IReadOnlyDictionary<Type, IMessagePackFormatter> formatterMapBacking;
-
-        private static IReadOnlyDictionary<Type, IMessagePackFormatter> formatterMap => formatterMapBacking ??= new Dictionary<Type, IMessagePackFormatter>
-        {
-            { typeof(TeamVersusUserState), new TypeRedirectingFormatter<TeamVersusUserState, MatchUserState>() },
-            { typeof(TeamVersusRoomState), new TypeRedirectingFormatter<TeamVersusRoomState, MatchRoomState>() },
-            { typeof(ChangeTeamRequest), new TypeRedirectingFormatter<ChangeTeamRequest, MatchUserRequest>() },
-
-            // These should not be required. The fallback should work. But something is weird with the way caching is done.
+            // This should not be required. The fallback should work. But something is weird with the way caching is done.
             // For future adventurers, I would not advise looking into this further. It's likely not worth the effort.
-            { typeof(MatchUserState), new TypeRedirectingFormatter<MatchUserState, MatchUserState>() },
-            { typeof(MatchRoomState), new TypeRedirectingFormatter<MatchRoomState, MatchRoomState>() },
-            { typeof(MatchUserRequest), new TypeRedirectingFormatter<MatchUserRequest, MatchUserRequest>() },
-            { typeof(MatchServerEvent), new TypeRedirectingFormatter<MatchServerEvent, MatchServerEvent>() },
-        };
+            baseDerived = baseDerived.Concat(baseDerived.Select(t => (t.baseType, t.baseType))).Distinct();
+
+            return new Dictionary<Type, IMessagePackFormatter>(baseDerived.Select(t =>
+            {
+                var formatter = (IMessagePackFormatter)Activator.CreateInstance(typeof(TypeRedirectingFormatter<,>).MakeGenericType(t.derivedType, t.baseType));
+                return new KeyValuePair<Type, IMessagePackFormatter>(t.derivedType, formatter);
+            }));
+        }
 
         public IMessagePackFormatter<T> GetFormatter<T>()
         {
-            if (formatterMap.TryGetValue(typeof(T), out var formatter))
+            if (formatter_map.TryGetValue(typeof(T), out var formatter))
                 return (IMessagePackFormatter<T>)formatter;
 
             return StandardResolver.Instance.GetFormatter<T>();
diff --git a/osu.Game/Online/SignalRWorkaroundTypes.cs b/osu.Game/Online/SignalRWorkaroundTypes.cs
new file mode 100644
index 0000000000..ae2d8b997c
--- /dev/null
+++ b/osu.Game/Online/SignalRWorkaroundTypes.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;
+using System.Collections.Generic;
+using osu.Game.Online.Multiplayer;
+using osu.Game.Online.Multiplayer.MatchTypes.TeamVersus;
+
+namespace osu.Game.Online
+{
+    /// <summary>
+    /// A static class providing the list of types requiring workarounds for serialisation in SignalR.
+    /// </summary>
+    /// <seealso cref="SignalRUnionWorkaroundResolver"/>
+    /// <seealso cref="SignalRDerivedTypeWorkaroundJsonConverter"/>
+    internal static class SignalRWorkaroundTypes
+    {
+        internal static readonly IReadOnlyList<(Type derivedType, Type baseType)> BASE_DERIVED = new[]
+        {
+            (typeof(ChangeTeamRequest), typeof(MatchUserRequest)),
+            (typeof(TeamVersusRoomState), typeof(MatchRoomState)),
+            (typeof(TeamVersusUserState), typeof(MatchUserState)),
+            (typeof(MatchServerEvent), typeof(MatchServerEvent)),
+        };
+    }
+}

From abbc13c60feeaf42ddb57d21d160020fcd5c6cf7 Mon Sep 17 00:00:00 2001
From: David Paiva <pillgp@icloud.com>
Date: Sat, 20 Nov 2021 12:41:01 +0000
Subject: [PATCH 1133/5547] Added Beatmap Link button to Discord Rich Presence

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

diff --git a/osu.Desktop/DiscordRichPresence.cs b/osu.Desktop/DiscordRichPresence.cs
index e1e7e6ad18..f58633ae9e 100644
--- a/osu.Desktop/DiscordRichPresence.cs
+++ b/osu.Desktop/DiscordRichPresence.cs
@@ -47,6 +47,8 @@ namespace osu.Desktop
                 SkipIdenticalPresence = false // handles better on discord IPC loss, see updateStatus call in onReady.
             };
 
+            client.RegisterUriScheme();
+
             client.OnReady += onReady;
 
             // safety measure for now, until we performance test / improve backoff for failed connections.
@@ -90,10 +92,22 @@ namespace osu.Desktop
                 return;
             }
 
-            if (status.Value is UserStatusOnline && activity.Value != null)
+            if (/*status.Value is UserStatusOnline &&*/ activity.Value != null)
             {
                 presence.State = truncate(activity.Value.Status);
                 presence.Details = truncate(getDetails(activity.Value));
+
+                if (getOnlineID(activity.Value) != string.Empty)
+                {
+                    presence.Buttons = new Button[]
+                    {
+                        new Button() { Label = "Beatmap Link", Url = $"https://osu.ppy.sh/b/{getOnlineID(activity.Value)}" }
+                    };
+                }
+                else
+                {
+                    presence.Buttons = null;
+                }
             }
             else
             {
@@ -109,6 +123,7 @@ namespace osu.Desktop
 
             // update ruleset
             presence.Assets.SmallImageKey = ruleset.Value.ID <= 3 ? $"mode_{ruleset.Value.ID}" : "mode_custom";
+
             presence.Assets.SmallImageText = ruleset.Value.Name;
 
             client.SetPresence(presence);
@@ -152,6 +167,20 @@ namespace osu.Desktop
             return string.Empty;
         }
 
+        private string getOnlineID(UserActivity activity)
+        {
+            switch (activity)
+            {
+                case UserActivity.InGame game:
+                    if (!(game.BeatmapInfo.OnlineID < 1))
+                        return game.BeatmapInfo.OnlineID.ToString();
+
+                    return string.Empty;
+            }
+
+            return string.Empty;
+        }
+
         protected override void Dispose(bool isDisposing)
         {
             client.Dispose();

From e65826979e8162c92613e19df322fb3546e3c0bb Mon Sep 17 00:00:00 2001
From: David Paiva <pillgp@icloud.com>
Date: Sat, 20 Nov 2021 12:41:31 +0000
Subject: [PATCH 1134/5547] Whoops, forgot that comment

---
 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 f58633ae9e..dd3fca095e 100644
--- a/osu.Desktop/DiscordRichPresence.cs
+++ b/osu.Desktop/DiscordRichPresence.cs
@@ -92,7 +92,7 @@ namespace osu.Desktop
                 return;
             }
 
-            if (/*status.Value is UserStatusOnline &&*/ activity.Value != null)
+            if (status.Value is UserStatusOnline && activity.Value != null)
             {
                 presence.State = truncate(activity.Value.Status);
                 presence.Details = truncate(getDetails(activity.Value));

From 5276300c081ce7d3cfd2042d89c7189fa9866e33 Mon Sep 17 00:00:00 2001
From: David Paiva <pillgp@icloud.com>
Date: Sat, 20 Nov 2021 14:11:02 +0000
Subject: [PATCH 1135/5547] Added required changes.

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

diff --git a/osu.Desktop/DiscordRichPresence.cs b/osu.Desktop/DiscordRichPresence.cs
index dd3fca095e..d72774e96f 100644
--- a/osu.Desktop/DiscordRichPresence.cs
+++ b/osu.Desktop/DiscordRichPresence.cs
@@ -97,7 +97,7 @@ namespace osu.Desktop
                 presence.State = truncate(activity.Value.Status);
                 presence.Details = truncate(getDetails(activity.Value));
 
-                if (getOnlineID(activity.Value) != string.Empty)
+                if (getOnlineID(activity.Value) != null)
                 {
                     presence.Buttons = new Button[]
                     {
@@ -167,18 +167,14 @@ namespace osu.Desktop
             return string.Empty;
         }
 
-        private string getOnlineID(UserActivity activity)
+        private int? getOnlineID(UserActivity activity)
         {
-            switch (activity)
+            if (activity is UserActivity.InGame game && game.BeatmapInfo.OnlineID > 0)
             {
-                case UserActivity.InGame game:
-                    if (!(game.BeatmapInfo.OnlineID < 1))
-                        return game.BeatmapInfo.OnlineID.ToString();
-
-                    return string.Empty;
+                return game.BeatmapInfo.OnlineID;
             }
 
-            return string.Empty;
+            return null;
         }
 
         protected override void Dispose(bool isDisposing)

From 15feb17da8c61563e3b8cc566aee2062b6df7173 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 20 Nov 2021 16:54:58 +0100
Subject: [PATCH 1136/5547] Change difficulty cache storage type to nullable

The recent changes related to adding support for working beatmap load
cancellation exposed a flaw in the beatmap difficulty cache. With the
way the difficulty computation logic was written, any error in the
calculation process (including beatmap load timeout, or cancellation)
would result in a 0.00 star rating being permanently cached in memory
for the given beatmap.

To resolve, change the difficulty cache's return type to nullable.
In failure scenarios, `null` is returned, rather than
`default(StarDifficulty)` as done previously.
---
 .../TestSceneBeatmapDifficultyCache.cs        |  4 +--
 .../TestSceneBeatmapMetadataDisplay.cs        |  2 +-
 osu.Game/Beatmaps/BeatmapDifficultyCache.cs   | 26 ++++++++++++-------
 osu.Game/Scoring/ScoreManager.cs              |  7 ++++-
 osu.Game/Scoring/ScorePerformanceCache.cs     |  4 +--
 .../Expanded/ExpandedPanelMiddleContent.cs    | 17 ++++++------
 .../Screens/Select/Details/AdvancedStats.cs   |  5 +++-
 7 files changed, 40 insertions(+), 25 deletions(-)

diff --git a/osu.Game.Tests/Beatmaps/TestSceneBeatmapDifficultyCache.cs b/osu.Game.Tests/Beatmaps/TestSceneBeatmapDifficultyCache.cs
index dcfeea5db8..f84dbca0be 100644
--- a/osu.Game.Tests/Beatmaps/TestSceneBeatmapDifficultyCache.cs
+++ b/osu.Game.Tests/Beatmaps/TestSceneBeatmapDifficultyCache.cs
@@ -164,9 +164,9 @@ namespace osu.Game.Tests.Beatmaps
         {
             public Func<DifficultyCacheLookup, StarDifficulty> ComputeDifficulty { get; set; }
 
-            protected override Task<StarDifficulty> ComputeValueAsync(DifficultyCacheLookup lookup, CancellationToken token = default)
+            protected override Task<StarDifficulty?> ComputeValueAsync(DifficultyCacheLookup lookup, CancellationToken token = default)
             {
-                return Task.FromResult(ComputeDifficulty?.Invoke(lookup) ?? new StarDifficulty(BASE_STARS, 0));
+                return Task.FromResult<StarDifficulty?>(ComputeDifficulty?.Invoke(lookup) ?? new StarDifficulty(BASE_STARS, 0));
             }
         }
     }
diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapMetadataDisplay.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapMetadataDisplay.cs
index 11d589f7bc..e573c96ce9 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapMetadataDisplay.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapMetadataDisplay.cs
@@ -140,7 +140,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                 }
             }
 
-            public override async Task<StarDifficulty> GetDifficultyAsync(IBeatmapInfo beatmapInfo, IRulesetInfo rulesetInfo = null, IEnumerable<Mod> mods = null, CancellationToken cancellationToken = default)
+            public override async Task<StarDifficulty?> GetDifficultyAsync(IBeatmapInfo beatmapInfo, IRulesetInfo rulesetInfo = null, IEnumerable<Mod> mods = null, CancellationToken cancellationToken = default)
             {
                 if (blockCalculation)
                     await calculationBlocker.Task.ConfigureAwait(false);
diff --git a/osu.Game/Beatmaps/BeatmapDifficultyCache.cs b/osu.Game/Beatmaps/BeatmapDifficultyCache.cs
index 5f20bf49b9..9106408e23 100644
--- a/osu.Game/Beatmaps/BeatmapDifficultyCache.cs
+++ b/osu.Game/Beatmaps/BeatmapDifficultyCache.cs
@@ -27,7 +27,7 @@ namespace osu.Game.Beatmaps
     /// A component which performs and acts as a central cache for difficulty calculations of beatmap/ruleset/mod combinations.
     /// Currently not persisted between game sessions.
     /// </summary>
-    public class BeatmapDifficultyCache : MemoryCachingComponent<BeatmapDifficultyCache.DifficultyCacheLookup, StarDifficulty>
+    public class BeatmapDifficultyCache : MemoryCachingComponent<BeatmapDifficultyCache.DifficultyCacheLookup, StarDifficulty?>
     {
         // Too many simultaneous updates can lead to stutters. One thread seems to work fine for song select display purposes.
         private readonly ThreadedTaskScheduler updateScheduler = new ThreadedTaskScheduler(1, nameof(BeatmapDifficultyCache));
@@ -120,9 +120,13 @@ namespace osu.Game.Beatmaps
         /// <param name="rulesetInfo">The <see cref="IRulesetInfo"/> to get the difficulty with.</param>
         /// <param name="mods">The <see cref="Mod"/>s to get the difficulty with.</param>
         /// <param name="cancellationToken">An optional <see cref="CancellationToken"/> which stops computing the star difficulty.</param>
-        /// <returns>The <see cref="StarDifficulty"/>.</returns>
-        public virtual Task<StarDifficulty> GetDifficultyAsync([NotNull] IBeatmapInfo beatmapInfo, [CanBeNull] IRulesetInfo rulesetInfo = null,
-                                                               [CanBeNull] IEnumerable<Mod> mods = null, CancellationToken cancellationToken = default)
+        /// <returns>
+        /// The requested <see cref="StarDifficulty"/>, if non-<see langword="null"/>.
+        /// A <see langword="null"/> return value indicates that the difficulty process failed or was interrupted early,
+        /// and as such there is no usable star difficulty value to be returned.
+        /// </returns>
+        public virtual Task<StarDifficulty?> GetDifficultyAsync([NotNull] IBeatmapInfo beatmapInfo, [CanBeNull] IRulesetInfo rulesetInfo = null,
+                                                                [CanBeNull] IEnumerable<Mod> mods = null, CancellationToken cancellationToken = default)
         {
             // In the case that the user hasn't given us a ruleset, use the beatmap's default ruleset.
             rulesetInfo ??= beatmapInfo.Ruleset;
@@ -134,13 +138,13 @@ namespace osu.Game.Beatmaps
             if (localBeatmapInfo == null || localBeatmapInfo.ID == 0 || localRulesetInfo == null)
             {
                 // If not, fall back to the existing star difficulty (e.g. from an online source).
-                return Task.FromResult(new StarDifficulty(beatmapInfo.StarRating, (beatmapInfo as IBeatmapOnlineInfo)?.MaxCombo ?? 0));
+                return Task.FromResult<StarDifficulty?>(new StarDifficulty(beatmapInfo.StarRating, (beatmapInfo as IBeatmapOnlineInfo)?.MaxCombo ?? 0));
             }
 
             return GetAsync(new DifficultyCacheLookup(localBeatmapInfo, localRulesetInfo, mods), cancellationToken);
         }
 
-        protected override Task<StarDifficulty> ComputeValueAsync(DifficultyCacheLookup lookup, CancellationToken cancellationToken = default)
+        protected override Task<StarDifficulty?> ComputeValueAsync(DifficultyCacheLookup lookup, CancellationToken cancellationToken = default)
         {
             return Task.Factory.StartNew(() =>
             {
@@ -151,6 +155,8 @@ namespace osu.Game.Beatmaps
             }, cancellationToken, TaskCreationOptions.HideScheduler | TaskCreationOptions.RunContinuationsAsynchronously, updateScheduler);
         }
 
+        protected override bool CacheNullValues => false;
+
         public Task<List<TimedDifficultyAttributes>> GetTimedDifficultyAttributesAsync(IWorkingBeatmap beatmap, Ruleset ruleset, Mod[] mods, CancellationToken cancellationToken = default)
         {
             return Task.Factory.StartNew(() => ruleset.CreateDifficultyCalculator(beatmap).CalculateTimed(mods, cancellationToken),
@@ -260,7 +266,7 @@ namespace osu.Game.Beatmaps
                     // We're on a threadpool thread, but we should exit back to the update thread so consumers can safely handle value-changed events.
                     Schedule(() =>
                     {
-                        if (!cancellationToken.IsCancellationRequested)
+                        if (!cancellationToken.IsCancellationRequested && t.Result != null)
                             bindable.Value = t.Result;
                     });
                 }, cancellationToken);
@@ -272,7 +278,7 @@ namespace osu.Game.Beatmaps
         /// <param name="key">The <see cref="DifficultyCacheLookup"/> that defines the computation parameters.</param>
         /// <param name="cancellationToken">The cancellation token.</param>
         /// <returns>The <see cref="StarDifficulty"/>.</returns>
-        private StarDifficulty computeDifficulty(in DifficultyCacheLookup key, CancellationToken cancellationToken = default)
+        private StarDifficulty? computeDifficulty(in DifficultyCacheLookup key, CancellationToken cancellationToken = default)
         {
             // In the case that the user hasn't given us a ruleset, use the beatmap's default ruleset.
             var beatmapInfo = key.BeatmapInfo;
@@ -293,11 +299,11 @@ namespace osu.Game.Beatmaps
                 if (rulesetInfo.Equals(beatmapInfo.Ruleset))
                     Logger.Error(e, $"Failed to convert {beatmapInfo.OnlineID} to the beatmap's default ruleset ({beatmapInfo.Ruleset}).");
 
-                return new StarDifficulty();
+                return null;
             }
             catch
             {
-                return new StarDifficulty();
+                return null;
             }
         }
 
diff --git a/osu.Game/Scoring/ScoreManager.cs b/osu.Game/Scoring/ScoreManager.cs
index 9b4216084e..29144e7bdc 100644
--- a/osu.Game/Scoring/ScoreManager.cs
+++ b/osu.Game/Scoring/ScoreManager.cs
@@ -162,7 +162,12 @@ namespace osu.Game.Scoring
 
                     // We can compute the max combo locally after the async beatmap difficulty computation.
                     var difficulty = await difficulties().GetDifficultyAsync(score.BeatmapInfo, score.Ruleset, score.Mods, cancellationToken).ConfigureAwait(false);
-                    beatmapMaxCombo = difficulty.MaxCombo;
+
+                    // Something failed during difficulty calculation. Fall back to provided score.
+                    if (difficulty == null)
+                        return score.TotalScore;
+
+                    beatmapMaxCombo = difficulty.Value.MaxCombo;
                 }
             }
             else
diff --git a/osu.Game/Scoring/ScorePerformanceCache.cs b/osu.Game/Scoring/ScorePerformanceCache.cs
index 82685e9a04..79fb47f4b0 100644
--- a/osu.Game/Scoring/ScorePerformanceCache.cs
+++ b/osu.Game/Scoring/ScorePerformanceCache.cs
@@ -37,12 +37,12 @@ namespace osu.Game.Scoring
             var attributes = await difficultyCache.GetDifficultyAsync(score.BeatmapInfo, score.Ruleset, score.Mods, token).ConfigureAwait(false);
 
             // Performance calculation requires the beatmap and ruleset to be locally available. If not, return a default value.
-            if (attributes.Attributes == null)
+            if (attributes?.Attributes == null)
                 return null;
 
             token.ThrowIfCancellationRequested();
 
-            var calculator = score.Ruleset.CreateInstance().CreatePerformanceCalculator(attributes.Attributes, score);
+            var calculator = score.Ruleset.CreateInstance().CreatePerformanceCalculator(attributes.Value.Attributes, score);
 
             return calculator?.Calculate();
         }
diff --git a/osu.Game/Screens/Ranking/Expanded/ExpandedPanelMiddleContent.cs b/osu.Game/Screens/Ranking/Expanded/ExpandedPanelMiddleContent.cs
index e31a182a49..3ab2658f97 100644
--- a/osu.Game/Screens/Ranking/Expanded/ExpandedPanelMiddleContent.cs
+++ b/osu.Game/Screens/Ranking/Expanded/ExpandedPanelMiddleContent.cs
@@ -143,14 +143,6 @@ namespace osu.Game.Screens.Ranking.Expanded
                                 Origin = Anchor.TopCentre,
                                 AutoSizeAxes = Axes.Both,
                                 Spacing = new Vector2(5, 0),
-                                Children = new Drawable[]
-                                {
-                                    new StarRatingDisplay(starDifficulty)
-                                    {
-                                        Anchor = Anchor.CentreLeft,
-                                        Origin = Anchor.CentreLeft
-                                    },
-                                }
                             },
                             new FillFlowContainer
                             {
@@ -231,6 +223,15 @@ namespace osu.Game.Screens.Ranking.Expanded
             if (score.Date != default)
                 AddInternal(new PlayedOnText(score.Date));
 
+            if (starDifficulty != null)
+            {
+                starAndModDisplay.Add(new StarRatingDisplay(starDifficulty.Value)
+                {
+                    Anchor = Anchor.CentreLeft,
+                    Origin = Anchor.CentreLeft
+                });
+            }
+
             if (score.Mods.Any())
             {
                 starAndModDisplay.Add(new ModDisplay
diff --git a/osu.Game/Screens/Select/Details/AdvancedStats.cs b/osu.Game/Screens/Select/Details/AdvancedStats.cs
index 91c8ce441e..edbaba40bc 100644
--- a/osu.Game/Screens/Select/Details/AdvancedStats.cs
+++ b/osu.Game/Screens/Select/Details/AdvancedStats.cs
@@ -152,7 +152,10 @@ namespace osu.Game.Screens.Select.Details
 
             Task.WhenAll(normalStarDifficulty, moddedStarDifficulty).ContinueWith(_ => Schedule(() =>
             {
-                starDifficulty.Value = ((float)normalStarDifficulty.Result.Stars, (float)moddedStarDifficulty.Result.Stars);
+                if (normalStarDifficulty.Result == null || moddedStarDifficulty.Result == null)
+                    return;
+
+                starDifficulty.Value = ((float)normalStarDifficulty.Result.Value.Stars, (float)moddedStarDifficulty.Result.Value.Stars);
             }), starDifficultyCancellationSource.Token, TaskContinuationOptions.OnlyOnRanToCompletion, TaskScheduler.Current);
         }
 

From 6100bf66a694dc6cac148c67689b3c4555418a83 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 20 Nov 2021 17:23:55 +0100
Subject: [PATCH 1137/5547] Clean up cancellation handling in `WorkingBeatmap`

After the recent changes introducing cancellation support to
`WorkingBeatmap`, it turned out that if the cancellation support was
used, `GetPlayableBeatmap()` would raise timeout exceptions rather than
the expected `OperationCanceledException`.

To that end, split off a separate overload for the typical usage, that
catches `OperationCanceledException` and converts them to beatmap load
timeout exceptions, and use normal `OperationCanceledException`s in the
overload that requires a cancellation token to work.
---
 osu.Game.Tests/Beatmaps/WorkingBeatmapTest.cs |  5 +-
 osu.Game/Beatmaps/IWorkingBeatmap.cs          | 23 +++++++-
 osu.Game/Beatmaps/WorkingBeatmap.cs           | 53 ++++++++-----------
 .../Play/HUD/PerformancePointsCounter.cs      |  2 +-
 4 files changed, 48 insertions(+), 35 deletions(-)

diff --git a/osu.Game.Tests/Beatmaps/WorkingBeatmapTest.cs b/osu.Game.Tests/Beatmaps/WorkingBeatmapTest.cs
index 6ad63a5fbb..5f70f08413 100644
--- a/osu.Game.Tests/Beatmaps/WorkingBeatmapTest.cs
+++ b/osu.Game.Tests/Beatmaps/WorkingBeatmapTest.cs
@@ -9,6 +9,7 @@ using Moq;
 using NUnit.Framework;
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets;
+using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Osu.Beatmaps;
@@ -40,7 +41,7 @@ namespace osu.Game.Tests.Beatmaps
             Task.Factory.StartNew(() =>
             {
                 loadStarted.Set();
-                Assert.Throws<OperationCanceledException>(() => working.GetPlayableBeatmap(new OsuRuleset().RulesetInfo, cancellationToken: cts.Token));
+                Assert.Throws<OperationCanceledException>(() => working.GetPlayableBeatmap(new OsuRuleset().RulesetInfo, Array.Empty<Mod>(), cts.Token));
                 loadCompleted.Set();
             }, TaskCreationOptions.LongRunning);
 
@@ -58,7 +59,7 @@ namespace osu.Game.Tests.Beatmaps
         {
             var working = new TestNeverLoadsWorkingBeatmap();
 
-            Assert.Throws<OperationCanceledException>(() => working.GetPlayableBeatmap(new OsuRuleset().RulesetInfo));
+            Assert.Throws(Is.InstanceOf<TimeoutException>(), () => working.GetPlayableBeatmap(new OsuRuleset().RulesetInfo));
 
             working.ResetEvent.Set();
         }
diff --git a/osu.Game/Beatmaps/IWorkingBeatmap.cs b/osu.Game/Beatmaps/IWorkingBeatmap.cs
index da977bb9d5..6cebce3c59 100644
--- a/osu.Game/Beatmaps/IWorkingBeatmap.cs
+++ b/osu.Game/Beatmaps/IWorkingBeatmap.cs
@@ -90,12 +90,31 @@ namespace osu.Game.Beatmaps
         /// have been applied, and <see cref="HitObject"/>s have been fully constructed.
         /// </para>
         /// </summary>
+        /// <remarks>
+        /// By default, the beatmap load process will be interrupted after 10 seconds.
+        /// For finer-grained control over the load process, use the
+        /// <see cref="GetPlayableBeatmap(osu.Game.Rulesets.IRulesetInfo,System.Collections.Generic.IReadOnlyList{osu.Game.Rulesets.Mods.Mod},System.Threading.CancellationToken)"/>
+        /// overload instead.
+        /// </remarks>
         /// <param name="ruleset">The <see cref="RulesetInfo"/> to create a playable <see cref="IBeatmap"/> for.</param>
         /// <param name="mods">The <see cref="Mod"/>s to apply to the <see cref="IBeatmap"/>.</param>
-        /// <param name="cancellationToken">Cancellation token that cancels the beatmap loading process. If not provided, a default timeout of 10,000ms will be applied to the load process.</param>
         /// <returns>The converted <see cref="IBeatmap"/>.</returns>
         /// <exception cref="BeatmapInvalidForRulesetException">If <see cref="Beatmap"/> could not be converted to <paramref name="ruleset"/>.</exception>
-        IBeatmap GetPlayableBeatmap(IRulesetInfo ruleset, IReadOnlyList<Mod> mods = null, CancellationToken? cancellationToken = null);
+        IBeatmap GetPlayableBeatmap(IRulesetInfo ruleset, params Mod[] mods);
+
+        /// <summary>
+        /// Constructs a playable <see cref="IBeatmap"/> from <see cref="Beatmap"/> using the applicable converters for a specific <see cref="RulesetInfo"/>.
+        /// <para>
+        /// The returned <see cref="IBeatmap"/> is in a playable state - all <see cref="HitObject"/> and <see cref="BeatmapDifficulty"/> <see cref="Mod"/>s
+        /// have been applied, and <see cref="HitObject"/>s have been fully constructed.
+        /// </para>
+        /// </summary>
+        /// <param name="ruleset">The <see cref="RulesetInfo"/> to create a playable <see cref="IBeatmap"/> for.</param>
+        /// <param name="mods">The <see cref="Mod"/>s to apply to the <see cref="IBeatmap"/>.</param>
+        /// <param name="cancellationToken">Cancellation token that cancels the beatmap loading process.</param>
+        /// <returns>The converted <see cref="IBeatmap"/>.</returns>
+        /// <exception cref="BeatmapInvalidForRulesetException">If <see cref="Beatmap"/> could not be converted to <paramref name="ruleset"/>.</exception>
+        IBeatmap GetPlayableBeatmap(IRulesetInfo ruleset, IReadOnlyList<Mod> mods, CancellationToken cancellationToken);
 
         /// <summary>
         /// Load a new audio track instance for this beatmap. This should be called once before accessing <see cref="Track"/>.
diff --git a/osu.Game/Beatmaps/WorkingBeatmap.cs b/osu.Game/Beatmaps/WorkingBeatmap.cs
index d2912229c6..a6f9f4e5f5 100644
--- a/osu.Game/Beatmaps/WorkingBeatmap.cs
+++ b/osu.Game/Beatmaps/WorkingBeatmap.cs
@@ -79,14 +79,24 @@ namespace osu.Game.Beatmaps
         /// <returns>The applicable <see cref="IBeatmapConverter"/>.</returns>
         protected virtual IBeatmapConverter CreateBeatmapConverter(IBeatmap beatmap, Ruleset ruleset) => ruleset.CreateBeatmapConverter(beatmap);
 
-        public virtual IBeatmap GetPlayableBeatmap(IRulesetInfo ruleset, IReadOnlyList<Mod> mods = null, CancellationToken? cancellationToken = null)
+        public IBeatmap GetPlayableBeatmap([NotNull] IRulesetInfo ruleset, params Mod[] mods)
         {
-            var token = cancellationToken ??
-                        // don't apply the default timeout when debugger is attached (may be breakpointing / debugging).
-                        (Debugger.IsAttached ? new CancellationToken() : new CancellationTokenSource(10000).Token);
-
-            mods ??= Array.Empty<Mod>();
+            try
+            {
+                using (var cancellationTokenSource = new CancellationTokenSource(10_000))
+                {
+                    // don't apply the default timeout when debugger is attached (may be breakpointing / debugging).
+                    return GetPlayableBeatmap(ruleset, mods, Debugger.IsAttached ? new CancellationToken() : cancellationTokenSource.Token);
+                }
+            }
+            catch (OperationCanceledException)
+            {
+                throw new BeatmapLoadTimeoutException(BeatmapInfo);
+            }
+        }
 
+        public virtual IBeatmap GetPlayableBeatmap([NotNull] IRulesetInfo ruleset, [NotNull] IReadOnlyList<Mod> mods, CancellationToken token)
+        {
             var rulesetInstance = ruleset.CreateInstance();
 
             if (rulesetInstance == null)
@@ -101,9 +111,7 @@ namespace osu.Game.Beatmaps
             // Apply conversion mods
             foreach (var mod in mods.OfType<IApplicableToBeatmapConverter>())
             {
-                if (token.IsCancellationRequested)
-                    throw new BeatmapLoadTimeoutException(BeatmapInfo);
-
+                token.ThrowIfCancellationRequested();
                 mod.ApplyToBeatmapConverter(converter);
             }
 
@@ -113,9 +121,7 @@ namespace osu.Game.Beatmaps
             // Apply conversion mods to the result
             foreach (var mod in mods.OfType<IApplicableAfterBeatmapConversion>())
             {
-                if (token.IsCancellationRequested)
-                    throw new BeatmapLoadTimeoutException(BeatmapInfo);
-
+                token.ThrowIfCancellationRequested();
                 mod.ApplyToBeatmap(converted);
             }
 
@@ -124,9 +130,7 @@ namespace osu.Game.Beatmaps
             {
                 foreach (var mod in mods.OfType<IApplicableToDifficulty>())
                 {
-                    if (token.IsCancellationRequested)
-                        throw new BeatmapLoadTimeoutException(BeatmapInfo);
-
+                    token.ThrowIfCancellationRequested();
                     mod.ApplyToDifficulty(converted.Difficulty);
                 }
             }
@@ -139,28 +143,17 @@ namespace osu.Game.Beatmaps
             processor?.PreProcess();
 
             // Compute default values for hitobjects, including creating nested hitobjects in-case they're needed
-            try
+            foreach (var obj in converted.HitObjects)
             {
-                foreach (var obj in converted.HitObjects)
-                {
-                    if (token.IsCancellationRequested)
-                        throw new BeatmapLoadTimeoutException(BeatmapInfo);
-
-                    obj.ApplyDefaults(converted.ControlPointInfo, converted.Difficulty, token);
-                }
-            }
-            catch (OperationCanceledException)
-            {
-                throw new BeatmapLoadTimeoutException(BeatmapInfo);
+                token.ThrowIfCancellationRequested();
+                obj.ApplyDefaults(converted.ControlPointInfo, converted.Difficulty, token);
             }
 
             foreach (var mod in mods.OfType<IApplicableToHitObject>())
             {
                 foreach (var obj in converted.HitObjects)
                 {
-                    if (token.IsCancellationRequested)
-                        throw new BeatmapLoadTimeoutException(BeatmapInfo);
-
+                    token.ThrowIfCancellationRequested();
                     mod.ApplyToHitObject(obj);
                 }
             }
diff --git a/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs b/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs
index 9cb5d3cd91..854f255269 100644
--- a/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs
+++ b/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs
@@ -216,7 +216,7 @@ namespace osu.Game.Screens.Play.HUD
                 this.gameplayBeatmap = gameplayBeatmap;
             }
 
-            public override IBeatmap GetPlayableBeatmap(IRulesetInfo ruleset, IReadOnlyList<Mod> mods = null, CancellationToken? cancellationToken = null)
+            public override IBeatmap GetPlayableBeatmap(IRulesetInfo ruleset, IReadOnlyList<Mod> mods, CancellationToken cancellationToken)
                 => gameplayBeatmap;
 
             protected override IBeatmap GetBeatmap() => gameplayBeatmap;

From a7e45a9098209000a179861ad4c77531f996e450 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 20 Nov 2021 17:32:40 +0100
Subject: [PATCH 1138/5547] Log all non-cancellation errors in difficulty cache

---
 osu.Game/Beatmaps/BeatmapDifficultyCache.cs | 13 ++++++++++---
 1 file changed, 10 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapDifficultyCache.cs b/osu.Game/Beatmaps/BeatmapDifficultyCache.cs
index 9106408e23..f444b597c9 100644
--- a/osu.Game/Beatmaps/BeatmapDifficultyCache.cs
+++ b/osu.Game/Beatmaps/BeatmapDifficultyCache.cs
@@ -294,15 +294,22 @@ namespace osu.Game.Beatmaps
 
                 return new StarDifficulty(attributes);
             }
-            catch (BeatmapInvalidForRulesetException e)
+            catch (OperationCanceledException)
+            {
+                // no need to log, cancellations are expected as part of normal operation.
+                return null;
+            }
+            catch (BeatmapInvalidForRulesetException invalidForRuleset)
             {
                 if (rulesetInfo.Equals(beatmapInfo.Ruleset))
-                    Logger.Error(e, $"Failed to convert {beatmapInfo.OnlineID} to the beatmap's default ruleset ({beatmapInfo.Ruleset}).");
+                    Logger.Error(invalidForRuleset, $"Failed to convert {beatmapInfo.OnlineID} to the beatmap's default ruleset ({beatmapInfo.Ruleset}).");
 
                 return null;
             }
-            catch
+            catch (Exception unknownException)
             {
+                Logger.Error(unknownException, "Failed to calculate beatmap difficulty");
+
                 return null;
             }
         }

From b3606f4a21334bea4fab2b5e22a31de52759b24c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 20 Nov 2021 18:36:39 +0100
Subject: [PATCH 1139/5547] Rename `{Play -> GoToBeatmap}Button`

---
 osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs              | 3 +--
 .../Cards/Buttons/{PlayButton.cs => GoToBeatmapButton.cs}     | 4 ++--
 2 files changed, 3 insertions(+), 4 deletions(-)
 rename osu.Game/Beatmaps/Drawables/Cards/Buttons/{PlayButton.cs => GoToBeatmapButton.cs} (92%)

diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
index e48b21cdb6..48f8e7b9c5 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
@@ -25,7 +25,6 @@ using osu.Game.Overlays.BeatmapListing.Panels;
 using osu.Game.Resources.Localisation.Web;
 using osuTK.Graphics;
 using DownloadButton = osu.Game.Beatmaps.Drawables.Cards.Buttons.DownloadButton;
-using PlayButton = osu.Game.Beatmaps.Drawables.Cards.Buttons.PlayButton;
 
 namespace osu.Game.Beatmaps.Drawables.Cards
 {
@@ -144,7 +143,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                                 Anchor = Anchor.BottomCentre,
                                 Origin = Anchor.BottomCentre
                             },
-                            new PlayButton(beatmapSet)
+                            new GoToBeatmapButton(beatmapSet)
                             {
                                 Anchor = Anchor.BottomCentre,
                                 Origin = Anchor.BottomCentre
diff --git a/osu.Game/Beatmaps/Drawables/Cards/Buttons/PlayButton.cs b/osu.Game/Beatmaps/Drawables/Cards/Buttons/GoToBeatmapButton.cs
similarity index 92%
rename from osu.Game/Beatmaps/Drawables/Cards/Buttons/PlayButton.cs
rename to osu.Game/Beatmaps/Drawables/Cards/Buttons/GoToBeatmapButton.cs
index be964e306a..793c02d9c4 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/Buttons/PlayButton.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/Buttons/GoToBeatmapButton.cs
@@ -12,12 +12,12 @@ using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Beatmaps.Drawables.Cards.Buttons
 {
-    public class PlayButton : BeatmapCardIconButton
+    public class GoToBeatmapButton : BeatmapCardIconButton
     {
         private readonly APIBeatmapSet beatmapSet;
         private readonly Bindable<DownloadState> downloadState = new Bindable<DownloadState>();
 
-        public PlayButton(APIBeatmapSet beatmapSet)
+        public GoToBeatmapButton(APIBeatmapSet beatmapSet)
         {
             this.beatmapSet = beatmapSet;
 

From 297de27a6a6d1533afcf4f9d565a1bd40b70bfa8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 20 Nov 2021 18:45:24 +0100
Subject: [PATCH 1140/5547] Use `BindTarget` from card rather than caching &
 resolving download tracker

---
 .../TestSceneBeatmapCardDownloadButton.cs     | 21 ++++---------------
 .../Beatmaps/Drawables/Cards/BeatmapCard.cs   | 10 ++++++---
 .../Cards/BeatmapCardDownloadProgressBar.cs   | 14 ++++++-------
 .../Drawables/Cards/Buttons/DownloadButton.cs | 11 +++++-----
 .../Cards/Buttons/GoToBeatmapButton.cs        | 12 +++++------
 5 files changed, 30 insertions(+), 38 deletions(-)

diff --git a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCardDownloadButton.cs b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCardDownloadButton.cs
index d93209efe9..068d2bdcbd 100644
--- a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCardDownloadButton.cs
+++ b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCardDownloadButton.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 System;
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.Drawables.Cards.Buttons;
 using osu.Game.Configuration;
-using osu.Game.Online;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays;
 using osu.Game.Resources.Localisation.Web;
@@ -54,22 +52,11 @@ namespace osu.Game.Tests.Visual.Beatmaps
         {
             AddStep("create button", () =>
             {
-                var beatmapSet = downloadable ? getDownloadableBeatmapSet(hasVideo) : getUndownloadableBeatmapSet();
-                var downloadTracker = new BeatmapDownloadTracker(beatmapSet);
-
-                Child = new DependencyProvidingContainer
+                Child = downloadButton = new DownloadButton(downloadable ? getDownloadableBeatmapSet(hasVideo) : getUndownloadableBeatmapSet())
                 {
-                    RelativeSizeAxes = Axes.Both,
-                    CachedDependencies = new (Type, object)[]
-                    {
-                        (typeof(BeatmapDownloadTracker), downloadTracker)
-                    },
-                    Child = downloadButton = new DownloadButton(downloadable ? getDownloadableBeatmapSet(hasVideo) : getUndownloadableBeatmapSet())
-                    {
-                        Anchor = Anchor.Centre,
-                        Origin = Anchor.Centre,
-                        Scale = new Vector2(2)
-                    }
+                    Anchor = Anchor.Centre,
+                    Origin = Anchor.Centre,
+                    Scale = new Vector2(2)
                 };
             });
         }
diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
index 48f8e7b9c5..b55fb91e92 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
@@ -141,12 +141,14 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                             new DownloadButton(beatmapSet)
                             {
                                 Anchor = Anchor.BottomCentre,
-                                Origin = Anchor.BottomCentre
+                                Origin = Anchor.BottomCentre,
+                                State = { BindTarget = downloadTracker.State }
                             },
                             new GoToBeatmapButton(beatmapSet)
                             {
                                 Anchor = Anchor.BottomCentre,
-                                Origin = Anchor.BottomCentre
+                                Origin = Anchor.BottomCentre,
+                                State = { BindTarget = downloadTracker.State }
                             }
                         }
                     }
@@ -307,7 +309,9 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                                     RelativeSizeAxes = Axes.X,
                                     Height = 6,
                                     Anchor = Anchor.Centre,
-                                    Origin = Anchor.Centre
+                                    Origin = Anchor.Centre,
+                                    State = { BindTarget = downloadTracker.State },
+                                    Progress = { BindTarget = downloadTracker.Progress }
                                 }
                             }
                         }
diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardDownloadProgressBar.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardDownloadProgressBar.cs
index a94900b0c7..ffb4e0c540 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardDownloadProgressBar.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardDownloadProgressBar.cs
@@ -14,6 +14,12 @@ namespace osu.Game.Beatmaps.Drawables.Cards
 {
     public class BeatmapCardDownloadProgressBar : CompositeDrawable
     {
+        public IBindable<DownloadState> State => state;
+        private readonly Bindable<DownloadState> state = new Bindable<DownloadState>();
+
+        public IBindable<double> Progress => progress;
+        private readonly BindableDouble progress = new BindableDouble();
+
         public override bool IsPresent => true;
 
         private readonly CircularContainer foreground;
@@ -21,9 +27,6 @@ namespace osu.Game.Beatmaps.Drawables.Cards
         private readonly Box backgroundFill;
         private readonly Box foregroundFill;
 
-        private readonly Bindable<DownloadState> state = new Bindable<DownloadState>();
-        private readonly BindableDouble progress = new BindableDouble();
-
         [Resolved]
         private OsuColour colours { get; set; }
 
@@ -56,12 +59,9 @@ namespace osu.Game.Beatmaps.Drawables.Cards
         }
 
         [BackgroundDependencyLoader]
-        private void load(BeatmapDownloadTracker downloadTracker)
+        private void load()
         {
             backgroundFill.Colour = colourProvider.Background6;
-
-            ((IBindable<DownloadState>)state).BindTo(downloadTracker.State);
-            ((IBindable<double>)progress).BindTo(downloadTracker.Progress);
         }
 
         protected override void LoadComplete()
diff --git a/osu.Game/Beatmaps/Drawables/Cards/Buttons/DownloadButton.cs b/osu.Game/Beatmaps/Drawables/Cards/Buttons/DownloadButton.cs
index 325181598d..7430fce1c8 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/Buttons/DownloadButton.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/Buttons/DownloadButton.cs
@@ -16,8 +16,10 @@ namespace osu.Game.Beatmaps.Drawables.Cards.Buttons
 {
     public class DownloadButton : BeatmapCardIconButton
     {
+        public IBindable<DownloadState> State => state;
+        private readonly Bindable<DownloadState> state = new Bindable<DownloadState>();
+
         private readonly APIBeatmapSet beatmapSet;
-        private readonly Bindable<DownloadState> downloadState = new Bindable<DownloadState>();
 
         private Bindable<bool> preferNoVideo = null!;
 
@@ -32,23 +34,22 @@ namespace osu.Game.Beatmaps.Drawables.Cards.Buttons
         }
 
         [BackgroundDependencyLoader]
-        private void load(OsuConfigManager config, BeatmapDownloadTracker downloadTracker)
+        private void load(OsuConfigManager config)
         {
             preferNoVideo = config.GetBindable<bool>(OsuSetting.PreferNoVideo);
-            ((IBindable<DownloadState>)downloadState).BindTo(downloadTracker.State);
         }
 
         protected override void LoadComplete()
         {
             base.LoadComplete();
             preferNoVideo.BindValueChanged(_ => updateState());
-            downloadState.BindValueChanged(_ => updateState(), true);
+            state.BindValueChanged(_ => updateState(), true);
             FinishTransforms(true);
         }
 
         private void updateState()
         {
-            this.FadeTo(downloadState.Value != DownloadState.LocallyAvailable ? 1 : 0, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
+            this.FadeTo(state.Value != DownloadState.LocallyAvailable ? 1 : 0, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
 
             if (beatmapSet.Availability.DownloadDisabled)
             {
diff --git a/osu.Game/Beatmaps/Drawables/Cards/Buttons/GoToBeatmapButton.cs b/osu.Game/Beatmaps/Drawables/Cards/Buttons/GoToBeatmapButton.cs
index 793c02d9c4..9a6a3c01b7 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/Buttons/GoToBeatmapButton.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/Buttons/GoToBeatmapButton.cs
@@ -14,8 +14,10 @@ namespace osu.Game.Beatmaps.Drawables.Cards.Buttons
 {
     public class GoToBeatmapButton : BeatmapCardIconButton
     {
+        public IBindable<DownloadState> State => state;
+        private readonly Bindable<DownloadState> state = new Bindable<DownloadState>();
+
         private readonly APIBeatmapSet beatmapSet;
-        private readonly Bindable<DownloadState> downloadState = new Bindable<DownloadState>();
 
         public GoToBeatmapButton(APIBeatmapSet beatmapSet)
         {
@@ -26,24 +28,22 @@ namespace osu.Game.Beatmaps.Drawables.Cards.Buttons
         }
 
         [BackgroundDependencyLoader(true)]
-        private void load(OsuGame? game, BeatmapDownloadTracker downloadTracker)
+        private void load(OsuGame? game)
         {
             Action = () => game?.PresentBeatmap(beatmapSet);
-
-            ((IBindable<DownloadState>)downloadState).BindTo(downloadTracker.State);
         }
 
         protected override void LoadComplete()
         {
             base.LoadComplete();
 
-            downloadState.BindValueChanged(_ => updateState(), true);
+            state.BindValueChanged(_ => updateState(), true);
             FinishTransforms(true);
         }
 
         private void updateState()
         {
-            this.FadeTo(downloadState.Value == DownloadState.LocallyAvailable ? 1 : 0, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
+            this.FadeTo(state.Value == DownloadState.LocallyAvailable ? 1 : 0, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
         }
     }
 }

From 915bde6f9638dd7ece25f1e5cbb51dbc4cacd9e5 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sun, 21 Nov 2021 06:09:45 +0300
Subject: [PATCH 1141/5547] Remove unnecessary `MatchServerEvent` mapping

---
 osu.Game/Online/SignalRWorkaroundTypes.cs | 1 -
 1 file changed, 1 deletion(-)

diff --git a/osu.Game/Online/SignalRWorkaroundTypes.cs b/osu.Game/Online/SignalRWorkaroundTypes.cs
index ae2d8b997c..ae1d9f9c6e 100644
--- a/osu.Game/Online/SignalRWorkaroundTypes.cs
+++ b/osu.Game/Online/SignalRWorkaroundTypes.cs
@@ -20,7 +20,6 @@ namespace osu.Game.Online
             (typeof(ChangeTeamRequest), typeof(MatchUserRequest)),
             (typeof(TeamVersusRoomState), typeof(MatchRoomState)),
             (typeof(TeamVersusUserState), typeof(MatchUserState)),
-            (typeof(MatchServerEvent), typeof(MatchServerEvent)),
         };
     }
 }

From 9f688f629152679a2dc18d14a83d0496d2e638a2 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 21 Nov 2021 12:12:24 +0900
Subject: [PATCH 1142/5547] Stop persisting `Skill`s in `DifficultyAttributes`

---
 .../EmptyFreeformDifficultyCalculator.cs               |  2 +-
 .../PippidonDifficultyCalculator.cs                    |  2 +-
 .../EmptyScrollingDifficultyCalculator.cs              |  2 +-
 .../PippidonDifficultyCalculator.cs                    |  2 +-
 .../Difficulty/CatchDifficultyCalculator.cs            |  3 +--
 .../Difficulty/ManiaDifficultyCalculator.cs            |  3 +--
 .../Difficulty/OsuDifficultyCalculator.cs              |  3 +--
 .../Difficulty/TaikoDifficultyCalculator.cs            |  3 +--
 osu.Game/Rulesets/Difficulty/DifficultyAttributes.cs   | 10 +---------
 9 files changed, 9 insertions(+), 21 deletions(-)

diff --git a/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform/EmptyFreeformDifficultyCalculator.cs b/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform/EmptyFreeformDifficultyCalculator.cs
index 79be2b27da..fae3784f5e 100644
--- a/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform/EmptyFreeformDifficultyCalculator.cs
+++ b/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform/EmptyFreeformDifficultyCalculator.cs
@@ -20,7 +20,7 @@ namespace osu.Game.Rulesets.EmptyFreeform
 
         protected override DifficultyAttributes CreateDifficultyAttributes(IBeatmap beatmap, Mod[] mods, Skill[] skills, double clockRate)
         {
-            return new DifficultyAttributes(mods, skills, 0);
+            return new DifficultyAttributes(mods, 0);
         }
 
         protected override IEnumerable<DifficultyHitObject> CreateDifficultyHitObjects(IBeatmap beatmap, double clockRate) => Enumerable.Empty<DifficultyHitObject>();
diff --git a/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon/PippidonDifficultyCalculator.cs b/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon/PippidonDifficultyCalculator.cs
index c612512938..ca64636076 100644
--- a/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon/PippidonDifficultyCalculator.cs
+++ b/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon/PippidonDifficultyCalculator.cs
@@ -20,7 +20,7 @@ namespace osu.Game.Rulesets.Pippidon
 
         protected override DifficultyAttributes CreateDifficultyAttributes(IBeatmap beatmap, Mod[] mods, Skill[] skills, double clockRate)
         {
-            return new DifficultyAttributes(mods, skills, 0);
+            return new DifficultyAttributes(mods, 0);
         }
 
         protected override IEnumerable<DifficultyHitObject> CreateDifficultyHitObjects(IBeatmap beatmap, double clockRate) => Enumerable.Empty<DifficultyHitObject>();
diff --git a/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling/EmptyScrollingDifficultyCalculator.cs b/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling/EmptyScrollingDifficultyCalculator.cs
index 4628e6696b..63a8b48b3c 100644
--- a/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling/EmptyScrollingDifficultyCalculator.cs
+++ b/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling/EmptyScrollingDifficultyCalculator.cs
@@ -20,7 +20,7 @@ namespace osu.Game.Rulesets.EmptyScrolling
 
         protected override DifficultyAttributes CreateDifficultyAttributes(IBeatmap beatmap, Mod[] mods, Skill[] skills, double clockRate)
         {
-            return new DifficultyAttributes(mods, skills, 0);
+            return new DifficultyAttributes(mods, 0);
         }
 
         protected override IEnumerable<DifficultyHitObject> CreateDifficultyHitObjects(IBeatmap beatmap, double clockRate) => Enumerable.Empty<DifficultyHitObject>();
diff --git a/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon/PippidonDifficultyCalculator.cs b/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon/PippidonDifficultyCalculator.cs
index c612512938..ca64636076 100644
--- a/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon/PippidonDifficultyCalculator.cs
+++ b/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon/PippidonDifficultyCalculator.cs
@@ -20,7 +20,7 @@ namespace osu.Game.Rulesets.Pippidon
 
         protected override DifficultyAttributes CreateDifficultyAttributes(IBeatmap beatmap, Mod[] mods, Skill[] skills, double clockRate)
         {
-            return new DifficultyAttributes(mods, skills, 0);
+            return new DifficultyAttributes(mods, 0);
         }
 
         protected override IEnumerable<DifficultyHitObject> CreateDifficultyHitObjects(IBeatmap beatmap, double clockRate) => Enumerable.Empty<DifficultyHitObject>();
diff --git a/osu.Game.Rulesets.Catch/Difficulty/CatchDifficultyCalculator.cs b/osu.Game.Rulesets.Catch/Difficulty/CatchDifficultyCalculator.cs
index 77a783a10d..0054047573 100644
--- a/osu.Game.Rulesets.Catch/Difficulty/CatchDifficultyCalculator.cs
+++ b/osu.Game.Rulesets.Catch/Difficulty/CatchDifficultyCalculator.cs
@@ -31,7 +31,7 @@ namespace osu.Game.Rulesets.Catch.Difficulty
         protected override DifficultyAttributes CreateDifficultyAttributes(IBeatmap beatmap, Mod[] mods, Skill[] skills, double clockRate)
         {
             if (beatmap.HitObjects.Count == 0)
-                return new CatchDifficultyAttributes { Mods = mods, Skills = skills };
+                return new CatchDifficultyAttributes { Mods = mods };
 
             // this is the same as osu!, so there's potential to share the implementation... maybe
             double preempt = IBeatmapDifficultyInfo.DifficultyRange(beatmap.Difficulty.ApproachRate, 1800, 1200, 450) / clockRate;
@@ -42,7 +42,6 @@ namespace osu.Game.Rulesets.Catch.Difficulty
                 Mods = mods,
                 ApproachRate = preempt > 1200.0 ? -(preempt - 1800.0) / 120.0 : -(preempt - 1200.0) / 150.0 + 5.0,
                 MaxCombo = beatmap.HitObjects.Count(h => h is Fruit) + beatmap.HitObjects.OfType<JuiceStream>().SelectMany(j => j.NestedHitObjects).Count(h => !(h is TinyDroplet)),
-                Skills = skills
             };
         }
 
diff --git a/osu.Game.Rulesets.Mania/Difficulty/ManiaDifficultyCalculator.cs b/osu.Game.Rulesets.Mania/Difficulty/ManiaDifficultyCalculator.cs
index 0040df72aa..1f82eb7ccd 100644
--- a/osu.Game.Rulesets.Mania/Difficulty/ManiaDifficultyCalculator.cs
+++ b/osu.Game.Rulesets.Mania/Difficulty/ManiaDifficultyCalculator.cs
@@ -39,7 +39,7 @@ namespace osu.Game.Rulesets.Mania.Difficulty
         protected override DifficultyAttributes CreateDifficultyAttributes(IBeatmap beatmap, Mod[] mods, Skill[] skills, double clockRate)
         {
             if (beatmap.HitObjects.Count == 0)
-                return new ManiaDifficultyAttributes { Mods = mods, Skills = skills };
+                return new ManiaDifficultyAttributes { Mods = mods };
 
             HitWindows hitWindows = new ManiaHitWindows();
             hitWindows.SetDifficulty(beatmap.Difficulty.OverallDifficulty);
@@ -51,7 +51,6 @@ namespace osu.Game.Rulesets.Mania.Difficulty
                 GreatHitWindow = Math.Ceiling(getHitWindow300(mods) / clockRate),
                 ScoreMultiplier = getScoreMultiplier(mods),
                 MaxCombo = beatmap.HitObjects.Sum(h => h is HoldNote ? 2 : 1),
-                Skills = skills
             };
         }
 
diff --git a/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs b/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs
index 3b4e85d0d3..ed42f333c0 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs
@@ -31,7 +31,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty
         protected override DifficultyAttributes CreateDifficultyAttributes(IBeatmap beatmap, Mod[] mods, Skill[] skills, double clockRate)
         {
             if (beatmap.HitObjects.Count == 0)
-                return new OsuDifficultyAttributes { Mods = mods, Skills = skills };
+                return new OsuDifficultyAttributes { Mods = mods };
 
             double aimRating = Math.Sqrt(skills[0].DifficultyValue()) * difficulty_multiplier;
             double aimRatingNoSliders = Math.Sqrt(skills[1].DifficultyValue()) * difficulty_multiplier;
@@ -85,7 +85,6 @@ namespace osu.Game.Rulesets.Osu.Difficulty
                 HitCircleCount = hitCirclesCount,
                 SliderCount = sliderCount,
                 SpinnerCount = spinnerCount,
-                Skills = skills
             };
         }
 
diff --git a/osu.Game.Rulesets.Taiko/Difficulty/TaikoDifficultyCalculator.cs b/osu.Game.Rulesets.Taiko/Difficulty/TaikoDifficultyCalculator.cs
index 606afdbabc..e84bee3d28 100644
--- a/osu.Game.Rulesets.Taiko/Difficulty/TaikoDifficultyCalculator.cs
+++ b/osu.Game.Rulesets.Taiko/Difficulty/TaikoDifficultyCalculator.cs
@@ -65,7 +65,7 @@ namespace osu.Game.Rulesets.Taiko.Difficulty
         protected override DifficultyAttributes CreateDifficultyAttributes(IBeatmap beatmap, Mod[] mods, Skill[] skills, double clockRate)
         {
             if (beatmap.HitObjects.Count == 0)
-                return new TaikoDifficultyAttributes { Mods = mods, Skills = skills };
+                return new TaikoDifficultyAttributes { Mods = mods };
 
             var colour = (Colour)skills[0];
             var rhythm = (Rhythm)skills[1];
@@ -96,7 +96,6 @@ namespace osu.Game.Rulesets.Taiko.Difficulty
                 ColourStrain = colourRating,
                 GreatHitWindow = hitWindows.WindowFor(HitResult.Great) / clockRate,
                 MaxCombo = beatmap.HitObjects.Count(h => h is Hit),
-                Skills = skills
             };
         }
 
diff --git a/osu.Game/Rulesets/Difficulty/DifficultyAttributes.cs b/osu.Game/Rulesets/Difficulty/DifficultyAttributes.cs
index e0d27799ce..47736ee033 100644
--- a/osu.Game/Rulesets/Difficulty/DifficultyAttributes.cs
+++ b/osu.Game/Rulesets/Difficulty/DifficultyAttributes.cs
@@ -4,7 +4,6 @@
 using System.Collections.Generic;
 using System.Linq;
 using Newtonsoft.Json;
-using osu.Game.Rulesets.Difficulty.Skills;
 using osu.Game.Rulesets.Mods;
 
 namespace osu.Game.Rulesets.Difficulty
@@ -31,11 +30,6 @@ namespace osu.Game.Rulesets.Difficulty
         /// </summary>
         public Mod[] Mods { get; set; }
 
-        /// <summary>
-        /// The skills resulting from the difficulty calculation.
-        /// </summary>
-        public Skill[] Skills { get; set; }
-
         /// <summary>
         /// The combined star rating of all skill.
         /// </summary>
@@ -59,12 +53,10 @@ namespace osu.Game.Rulesets.Difficulty
         /// Creates new <see cref="DifficultyAttributes"/>.
         /// </summary>
         /// <param name="mods">The mods which were applied to the beatmap.</param>
-        /// <param name="skills">The skills resulting from the difficulty calculation.</param>
         /// <param name="starRating">The combined star rating of all skills.</param>
-        public DifficultyAttributes(Mod[] mods, Skill[] skills, double starRating)
+        public DifficultyAttributes(Mod[] mods, double starRating)
         {
             Mods = mods;
-            Skills = skills;
             StarRating = starRating;
         }
 

From fd3e5d333edc33408838fddab8b36114e83e096b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 21 Nov 2021 12:12:38 +0900
Subject: [PATCH 1143/5547] Add xmldoc note about `Skill` potentially being
 memory expensive

---
 osu.Game/Rulesets/Difficulty/Skills/Skill.cs | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/osu.Game/Rulesets/Difficulty/Skills/Skill.cs b/osu.Game/Rulesets/Difficulty/Skills/Skill.cs
index 9f0fb987a7..b5c94ad806 100644
--- a/osu.Game/Rulesets/Difficulty/Skills/Skill.cs
+++ b/osu.Game/Rulesets/Difficulty/Skills/Skill.cs
@@ -11,6 +11,10 @@ namespace osu.Game.Rulesets.Difficulty.Skills
     /// <summary>
     /// A bare minimal abstract skill for fully custom skill implementations.
     /// </summary>
+    /// <remarks>
+    /// This class should be considered a "processing" class and not persisted, as it keeps references to
+    /// gameplay objects after processing is run (see <see cref="Previous"/>).
+    /// </remarks>
     public abstract class Skill
     {
         /// <summary>

From af01b0ed4825547706c80e1b1dc7e41078635d83 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sun, 21 Nov 2021 06:30:14 +0300
Subject: [PATCH 1144/5547] `BASE_DERIVED` -> `BASE_TYPE_MAPPING`

---
 .../Online/SignalRDerivedTypeWorkaroundJsonConverter.cs     | 4 ++--
 osu.Game/Online/SignalRUnionWorkaroundResolver.cs           | 6 +++---
 osu.Game/Online/SignalRWorkaroundTypes.cs                   | 2 +-
 3 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Online/SignalRDerivedTypeWorkaroundJsonConverter.cs b/osu.Game/Online/SignalRDerivedTypeWorkaroundJsonConverter.cs
index 5643c5ca74..ab04e046d3 100644
--- a/osu.Game/Online/SignalRDerivedTypeWorkaroundJsonConverter.cs
+++ b/osu.Game/Online/SignalRDerivedTypeWorkaroundJsonConverter.cs
@@ -17,7 +17,7 @@ namespace osu.Game.Online
     public class SignalRDerivedTypeWorkaroundJsonConverter : JsonConverter
     {
         public override bool CanConvert(Type objectType) =>
-            SignalRWorkaroundTypes.BASE_DERIVED.Any(t =>
+            SignalRWorkaroundTypes.BASE_TYPE_MAPPING.Any(t =>
                 objectType == t.baseType ||
                 objectType == t.derivedType);
 
@@ -30,7 +30,7 @@ namespace osu.Game.Online
 
             string type = (string)obj[@"$dtype"]!;
 
-            var resolvedType = SignalRWorkaroundTypes.BASE_DERIVED.Select(t => t.derivedType).Single(t => t.Name == type);
+            var resolvedType = SignalRWorkaroundTypes.BASE_TYPE_MAPPING.Select(t => t.derivedType).Single(t => t.Name == type);
 
             object? instance = Activator.CreateInstance(resolvedType);
 
diff --git a/osu.Game/Online/SignalRUnionWorkaroundResolver.cs b/osu.Game/Online/SignalRUnionWorkaroundResolver.cs
index 01e3c24c87..e64f9ed91c 100644
--- a/osu.Game/Online/SignalRUnionWorkaroundResolver.cs
+++ b/osu.Game/Online/SignalRUnionWorkaroundResolver.cs
@@ -23,13 +23,13 @@ namespace osu.Game.Online
 
         private static IReadOnlyDictionary<Type, IMessagePackFormatter> createFormatterMap()
         {
-            IEnumerable<(Type derivedType, Type baseType)> baseDerived = SignalRWorkaroundTypes.BASE_DERIVED;
+            IEnumerable<(Type derivedType, Type baseType)> baseMap = SignalRWorkaroundTypes.BASE_TYPE_MAPPING;
 
             // This should not be required. The fallback should work. But something is weird with the way caching is done.
             // For future adventurers, I would not advise looking into this further. It's likely not worth the effort.
-            baseDerived = baseDerived.Concat(baseDerived.Select(t => (t.baseType, t.baseType))).Distinct();
+            baseMap = baseMap.Concat(baseMap.Select(t => (t.baseType, t.baseType)));
 
-            return new Dictionary<Type, IMessagePackFormatter>(baseDerived.Select(t =>
+            return new Dictionary<Type, IMessagePackFormatter>(baseMap.Select(t =>
             {
                 var formatter = (IMessagePackFormatter)Activator.CreateInstance(typeof(TypeRedirectingFormatter<,>).MakeGenericType(t.derivedType, t.baseType));
                 return new KeyValuePair<Type, IMessagePackFormatter>(t.derivedType, formatter);
diff --git a/osu.Game/Online/SignalRWorkaroundTypes.cs b/osu.Game/Online/SignalRWorkaroundTypes.cs
index ae1d9f9c6e..f69d23d81c 100644
--- a/osu.Game/Online/SignalRWorkaroundTypes.cs
+++ b/osu.Game/Online/SignalRWorkaroundTypes.cs
@@ -15,7 +15,7 @@ namespace osu.Game.Online
     /// <seealso cref="SignalRDerivedTypeWorkaroundJsonConverter"/>
     internal static class SignalRWorkaroundTypes
     {
-        internal static readonly IReadOnlyList<(Type derivedType, Type baseType)> BASE_DERIVED = new[]
+        internal static readonly IReadOnlyList<(Type derivedType, Type baseType)> BASE_TYPE_MAPPING = new[]
         {
             (typeof(ChangeTeamRequest), typeof(MatchUserRequest)),
             (typeof(TeamVersusRoomState), typeof(MatchRoomState)),

From 58d3e66d8b194a07a83d52e6953a99d9c52261c4 Mon Sep 17 00:00:00 2001
From: David Paiva <pillgp@icloud.com>
Date: Sun, 21 Nov 2021 09:36:05 +0000
Subject: [PATCH 1145/5547] Update osu.Desktop/DiscordRichPresence.cs

Co-authored-by: Salman Ahmed <frenzibyte@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 d72774e96f..46aa080dfe 100644
--- a/osu.Desktop/DiscordRichPresence.cs
+++ b/osu.Desktop/DiscordRichPresence.cs
@@ -101,7 +101,7 @@ namespace osu.Desktop
                 {
                     presence.Buttons = new Button[]
                     {
-                        new Button() { Label = "Beatmap Link", Url = $"https://osu.ppy.sh/b/{getOnlineID(activity.Value)}" }
+                        new Button() { Label = "Open Beatmap", Url = $"https://osu.ppy.sh/b/{getOnlineID(activity.Value)}" }
                     };
                 }
                 else

From bb8e8bc4f084e19a536b2eb4239f97d41afbe3e0 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 21 Nov 2021 11:30:45 +0100
Subject: [PATCH 1146/5547] Use consistent type for mod collection in all
 overloads

---
 osu.Game/Beatmaps/IWorkingBeatmap.cs | 2 +-
 osu.Game/Beatmaps/WorkingBeatmap.cs  | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Beatmaps/IWorkingBeatmap.cs b/osu.Game/Beatmaps/IWorkingBeatmap.cs
index 6cebce3c59..717162fd7f 100644
--- a/osu.Game/Beatmaps/IWorkingBeatmap.cs
+++ b/osu.Game/Beatmaps/IWorkingBeatmap.cs
@@ -100,7 +100,7 @@ namespace osu.Game.Beatmaps
         /// <param name="mods">The <see cref="Mod"/>s to apply to the <see cref="IBeatmap"/>.</param>
         /// <returns>The converted <see cref="IBeatmap"/>.</returns>
         /// <exception cref="BeatmapInvalidForRulesetException">If <see cref="Beatmap"/> could not be converted to <paramref name="ruleset"/>.</exception>
-        IBeatmap GetPlayableBeatmap(IRulesetInfo ruleset, params Mod[] mods);
+        IBeatmap GetPlayableBeatmap(IRulesetInfo ruleset, IReadOnlyList<Mod> mods = null);
 
         /// <summary>
         /// Constructs a playable <see cref="IBeatmap"/> from <see cref="Beatmap"/> using the applicable converters for a specific <see cref="RulesetInfo"/>.
diff --git a/osu.Game/Beatmaps/WorkingBeatmap.cs b/osu.Game/Beatmaps/WorkingBeatmap.cs
index a6f9f4e5f5..a17f247d9b 100644
--- a/osu.Game/Beatmaps/WorkingBeatmap.cs
+++ b/osu.Game/Beatmaps/WorkingBeatmap.cs
@@ -79,14 +79,14 @@ namespace osu.Game.Beatmaps
         /// <returns>The applicable <see cref="IBeatmapConverter"/>.</returns>
         protected virtual IBeatmapConverter CreateBeatmapConverter(IBeatmap beatmap, Ruleset ruleset) => ruleset.CreateBeatmapConverter(beatmap);
 
-        public IBeatmap GetPlayableBeatmap([NotNull] IRulesetInfo ruleset, params Mod[] mods)
+        public IBeatmap GetPlayableBeatmap([NotNull] IRulesetInfo ruleset, IReadOnlyList<Mod> mods = null)
         {
             try
             {
                 using (var cancellationTokenSource = new CancellationTokenSource(10_000))
                 {
                     // don't apply the default timeout when debugger is attached (may be breakpointing / debugging).
-                    return GetPlayableBeatmap(ruleset, mods, Debugger.IsAttached ? new CancellationToken() : cancellationTokenSource.Token);
+                    return GetPlayableBeatmap(ruleset, mods ?? Array.Empty<Mod>(), Debugger.IsAttached ? new CancellationToken() : cancellationTokenSource.Token);
                 }
             }
             catch (OperationCanceledException)

From 975744d26c881940f65d980ce421c4091715fab4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 21 Nov 2021 13:19:16 +0100
Subject: [PATCH 1147/5547] Remove no longer used `[Cached]` attribute

---
 osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs | 1 -
 1 file changed, 1 deletion(-)

diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
index b55fb91e92..e3af253db9 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
@@ -40,7 +40,6 @@ namespace osu.Game.Beatmaps.Drawables.Cards
         private readonly APIBeatmapSet beatmapSet;
         private readonly Bindable<BeatmapSetFavouriteState> favouriteState;
 
-        [Cached]
         private readonly BeatmapDownloadTracker downloadTracker;
 
         private UpdateableOnlineBeatmapSetCover leftCover;

From afbec941249b1d309ed31be7fcd0e84e180805f6 Mon Sep 17 00:00:00 2001
From: MBmasher <mbmasher@gmail.com>
Date: Sun, 21 Nov 2021 23:40:15 +1100
Subject: [PATCH 1148/5547] Move opacity function to OsuDifficultyHitObject

---
 .../Preprocessing/OsuDifficultyHitObject.cs           | 11 +++++++++++
 osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs | 10 +---------
 2 files changed, 12 insertions(+), 9 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
index d073d751d0..dc8188929a 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
@@ -56,12 +56,14 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
 
         private readonly OsuHitObject lastLastObject;
         private readonly OsuHitObject lastObject;
+        private readonly double clockRate;
 
         public OsuDifficultyHitObject(HitObject hitObject, HitObject lastLastObject, HitObject lastObject, double clockRate)
             : base(hitObject, lastObject, clockRate)
         {
             this.lastLastObject = (OsuHitObject)lastLastObject;
             this.lastObject = (OsuHitObject)lastObject;
+            this.clockRate = clockRate;
 
             // Capped to 25ms to prevent difficulty calculation breaking from simultaneous objects.
             StrainTime = Math.Max(DeltaTime, min_delta_time);
@@ -69,6 +71,15 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
             setDistances(clockRate);
         }
 
+        public double opacity(double ms, bool hidden)
+        {
+            double preemptTime = BaseObject.TimePreempt / clockRate;
+            if (hidden)
+                return Math.Clamp(Math.Min((1 - ms / preemptTime) * 2.5, (ms / preemptTime) * (1.0 / 0.3)), 0.0, 1.0);
+            else
+                return Math.Clamp((1.0 - ms / preemptTime) * 1.5, 0.0, 1.0);
+        }
+
         private void setDistances(double clockRate)
         {
             // We don't need to calculate either angle or distance when one of the last->curr objects is a spinner
diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
index b45a54f9e7..701670974b 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
@@ -72,7 +72,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
                     double stackNerf = Math.Min(1.0, (osuPrevious.JumpDistance / scalingFactor) / 25.0);
 
                     // Bonus based on how visible the object is.
-                    double opacityBonus = 1.0 + max_opacity_bonus * (1.0 - opacity(cumulativeStrainTime, preemptTime, hidden));
+                    double opacityBonus = 1.0 + max_opacity_bonus * (1.0 - osuCurrent.opacity(cumulativeStrainTime, hidden));
 
                     result += Math.Pow(0.8, i) * stackNerf * opacityBonus * scalingFactor * jumpDistance / cumulativeStrainTime;
                 }
@@ -87,14 +87,6 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
             return result;
         }
 
-        private double opacity(double ms, double preemptTime, bool hidden)
-        {
-            if (hidden)
-                return Math.Clamp(Math.Min((1 - ms / preemptTime) * 2.5, (ms / preemptTime) * (1.0 / 0.3)), 0.0, 1.0);
-            else
-                return Math.Clamp((1.0 - ms / preemptTime) * 1.5, 0.0, 1.0);
-        }
-
         private double strainDecay(double ms) => Math.Pow(strainDecayBase, ms / 1000);
 
         protected override double CalculateInitialStrain(double time) => currentStrain * strainDecay(time - Previous[0].StartTime);

From a57c277a585573b3081f6834b1cab6f09be60cf8 Mon Sep 17 00:00:00 2001
From: MBmasher <mbmasher@gmail.com>
Date: Sun, 21 Nov 2021 23:43:09 +1100
Subject: [PATCH 1149/5547] Move preempt back to CreateDifficultyAttributes

---
 osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs | 6 ++----
 osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs       | 4 +---
 2 files changed, 3 insertions(+), 7 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs b/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs
index fe20ce112e..14101f8302 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs
@@ -22,7 +22,6 @@ namespace osu.Game.Rulesets.Osu.Difficulty
     {
         private const double difficulty_multiplier = 0.0675;
         private double hitWindowGreat;
-        private double preempt;
 
         public OsuDifficultyCalculator(Ruleset ruleset, WorkingBeatmap beatmap)
             : base(ruleset, beatmap)
@@ -60,6 +59,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty
 
             double starRating = basePerformance > 0.00001 ? Math.Cbrt(1.12) * 0.027 * (Math.Cbrt(100000 / Math.Pow(2, 1 / 1.1) * basePerformance) + 4) : 0;
 
+            double preempt = IBeatmapDifficultyInfo.DifficultyRange(beatmap.Difficulty.ApproachRate, 1800, 1200, 450) / clockRate;
             double drainRate = beatmap.Difficulty.DrainRate;
 
             int maxCombo = beatmap.HitObjects.Count;
@@ -110,14 +110,12 @@ namespace osu.Game.Rulesets.Osu.Difficulty
 
             hitWindowGreat = hitWindows.WindowFor(HitResult.Great) / clockRate;
 
-            preempt = IBeatmapDifficultyInfo.DifficultyRange(beatmap.Difficulty.ApproachRate, 1800, 1200, 450) / clockRate;
-
             return new Skill[]
             {
                 new Aim(mods, true),
                 new Aim(mods, false),
                 new Speed(mods, hitWindowGreat),
-                new Flashlight(mods, preempt)
+                new Flashlight(mods)
             };
         }
 
diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
index 701670974b..8969e95aba 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
@@ -16,11 +16,10 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
     /// </summary>
     public class Flashlight : OsuStrainSkill
     {
-        public Flashlight(Mod[] mods, double preemptTime)
+        public Flashlight(Mod[] mods)
             : base(mods)
         {
             this.mods = mods;
-            this.preemptTime = preemptTime;
         }
 
         private double skillMultiplier => 0.09;
@@ -30,7 +29,6 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
 
         private readonly Mod[] mods;
         private bool hidden;
-        private readonly double preemptTime;
 
         private const double max_opacity_bonus = 0.7;
         private const double hidden_bonus = 0.5;

From e9a4ee68004b998264f6577fe79050b276b7c1a0 Mon Sep 17 00:00:00 2001
From: MBmasher <mbmasher@gmail.com>
Date: Sun, 21 Nov 2021 23:53:40 +1100
Subject: [PATCH 1150/5547] Cleaning up code

---
 .../Difficulty/Preprocessing/OsuDifficultyHitObject.cs         | 3 ++-
 osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs          | 2 +-
 2 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
index dc8188929a..cc699aa3f9 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
@@ -71,9 +71,10 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
             setDistances(clockRate);
         }
 
-        public double opacity(double ms, bool hidden)
+        public double Opacity(double ms, bool hidden)
         {
             double preemptTime = BaseObject.TimePreempt / clockRate;
+
             if (hidden)
                 return Math.Clamp(Math.Min((1 - ms / preemptTime) * 2.5, (ms / preemptTime) * (1.0 / 0.3)), 0.0, 1.0);
             else
diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
index 8969e95aba..2523f66bf6 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
@@ -70,7 +70,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
                     double stackNerf = Math.Min(1.0, (osuPrevious.JumpDistance / scalingFactor) / 25.0);
 
                     // Bonus based on how visible the object is.
-                    double opacityBonus = 1.0 + max_opacity_bonus * (1.0 - osuCurrent.opacity(cumulativeStrainTime, hidden));
+                    double opacityBonus = 1.0 + max_opacity_bonus * (1.0 - osuCurrent.Opacity(cumulativeStrainTime, hidden));
 
                     result += Math.Pow(0.8, i) * stackNerf * opacityBonus * scalingFactor * jumpDistance / cumulativeStrainTime;
                 }

From e9745a3ac41c93ec5860505cf833ec5618c5a177 Mon Sep 17 00:00:00 2001
From: MBmasher <mbmasher@gmail.com>
Date: Mon, 22 Nov 2021 08:32:35 +1100
Subject: [PATCH 1151/5547] Fix wrong opacity formula

---
 .../Difficulty/Preprocessing/OsuDifficultyHitObject.cs       | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
index cc699aa3f9..4109c068ea 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
@@ -74,11 +74,12 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
         public double Opacity(double ms, bool hidden)
         {
             double preemptTime = BaseObject.TimePreempt / clockRate;
+            double fadeInTime = BaseObject.TimeFadeIn / clockRate;
 
             if (hidden)
-                return Math.Clamp(Math.Min((1 - ms / preemptTime) * 2.5, (ms / preemptTime) * (1.0 / 0.3)), 0.0, 1.0);
+                return Math.Clamp(Math.Min((1.0 - ms / preemptTime) * 2.5, (ms / preemptTime - 0.3) * (1.0 / 0.3)), 0.0, 1.0);
             else
-                return Math.Clamp((1.0 - ms / preemptTime) * 1.5, 0.0, 1.0);
+                return Math.Clamp((preemptTime - ms) / fadeInTime, 0.0, 1.0);
         }
 
         private void setDistances(double clockRate)

From 7833fab02d0f1e3add202aa2f24118b67f4f404d Mon Sep 17 00:00:00 2001
From: MBmasher <mbmasher@gmail.com>
Date: Mon, 22 Nov 2021 08:41:56 +1100
Subject: [PATCH 1152/5547] Balancing bonuses to adjust for corrected opacity
 formula

---
 osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
index 2523f66bf6..7518364dd1 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
@@ -22,7 +22,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
             this.mods = mods;
         }
 
-        private double skillMultiplier => 0.09;
+        private double skillMultiplier => 0.11;
         private double strainDecayBase => 0.15;
         protected override double DecayWeight => 1.0;
         protected override int HistoryLength => 10; // Look back for 10 notes is added for the sake of flashlight calculations.
@@ -30,8 +30,8 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
         private readonly Mod[] mods;
         private bool hidden;
 
-        private const double max_opacity_bonus = 0.7;
-        private const double hidden_bonus = 0.5;
+        private const double max_opacity_bonus = 0.5;
+        private const double hidden_bonus = 0.1;
 
         private double currentStrain;
 

From 65ef03034187ed9e65e288b1eee96d030eef145f Mon Sep 17 00:00:00 2001
From: MBmasher <mbmasher@gmail.com>
Date: Mon, 22 Nov 2021 08:59:41 +1100
Subject: [PATCH 1153/5547] Further balancing

---
 osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
index 7518364dd1..7b4119d354 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
@@ -22,7 +22,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
             this.mods = mods;
         }
 
-        private double skillMultiplier => 0.11;
+        private double skillMultiplier => 0.1;
         private double strainDecayBase => 0.15;
         protected override double DecayWeight => 1.0;
         protected override int HistoryLength => 10; // Look back for 10 notes is added for the sake of flashlight calculations.
@@ -30,8 +30,8 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
         private readonly Mod[] mods;
         private bool hidden;
 
-        private const double max_opacity_bonus = 0.5;
-        private const double hidden_bonus = 0.1;
+        private const double max_opacity_bonus = 0.4;
+        private const double hidden_bonus = 0.2;
 
         private double currentStrain;
 

From 7560d3de0435408c62d7e8ad9fbedfcb1e211747 Mon Sep 17 00:00:00 2001
From: MBmasher <mbmasher@gmail.com>
Date: Mon, 22 Nov 2021 10:52:04 +1100
Subject: [PATCH 1154/5547] Remove decay factor in Flashlight skill

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

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
index 466f0556ab..68434fd3d0 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
@@ -19,7 +19,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
         {
         }
 
-        private double skillMultiplier => 0.15;
+        private double skillMultiplier => 0.07;
         private double strainDecayBase => 0.15;
         protected override double DecayWeight => 1.0;
         protected override int HistoryLength => 10; // Look back for 10 notes is added for the sake of flashlight calculations.
@@ -58,7 +58,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
                     // We also want to nerf stacks so that only the first object of the stack is accounted for.
                     double stackNerf = Math.Min(1.0, (osuPrevious.JumpDistance / scalingFactor) / 25.0);
 
-                    result += Math.Pow(0.8, i) * stackNerf * scalingFactor * jumpDistance / cumulativeStrainTime;
+                    result += stackNerf * scalingFactor * jumpDistance / cumulativeStrainTime;
                 }
             }
 

From 642097166033bbcce457b09668e5c6fcdd51d5ce Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Mon, 22 Nov 2021 11:10:08 +0900
Subject: [PATCH 1155/5547] Adjust test client with new queue-changing logic

---
 .../Multiplayer/TestMultiplayerClient.cs      | 22 +++----------------
 1 file changed, 3 insertions(+), 19 deletions(-)

diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
index 4deeef331d..20226bdb4f 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
@@ -370,25 +370,9 @@ namespace osu.Game.Tests.Visual.Multiplayer
             Debug.Assert(APIRoom != null);
             Debug.Assert(currentItem != null);
 
-            if (newMode == QueueMode.HostOnly)
-            {
-                // Remove all but the current and expired items. The current item may be re-used for host-only mode if it's non-expired.
-                for (int i = 0; i < Room.Playlist.Count; i++)
-                {
-                    var item = Room.Playlist[i];
-
-                    if (item.Expired || item.ID == Room.Settings.PlaylistItemId)
-                        continue;
-
-                    Room.Playlist.RemoveAt(i--);
-
-                    await ((IMultiplayerClient)this).PlaylistItemRemoved(item.ID).ConfigureAwait(false);
-                }
-
-                // Always ensure that at least one non-expired item exists by duplicating the current item if required.
-                if (currentItem.Expired)
-                    await duplicateCurrentItem().ConfigureAwait(false);
-            }
+            // When changing to host-only mode, ensure that at least one non-expired playlist item exists by duplicating the current item.
+            if (newMode == QueueMode.HostOnly && Room.Playlist.All(item => item.Expired))
+                await duplicateCurrentItem().ConfigureAwait(false);
 
             // When changing modes, items could have been added (above) or the queueing order could have changed.
             await updateCurrentItem(Room).ConfigureAwait(false);

From 53dbbd6d64e02f84597816347f9fb97acaf9fd82 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Mon, 22 Nov 2021 11:16:29 +0900
Subject: [PATCH 1156/5547] Compare playlist item IDs instead in tests

---
 .../Visual/Multiplayer/TestSceneAllPlayersQueueMode.cs | 10 +++++-----
 .../Visual/Multiplayer/TestSceneHostOnlyQueueMode.cs   |  8 ++++----
 2 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneAllPlayersQueueMode.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneAllPlayersQueueMode.cs
index 05cfd784eb..8e44c07a09 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneAllPlayersQueueMode.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneAllPlayersQueueMode.cs
@@ -19,7 +19,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [Test]
         public void TestFirstItemSelectedByDefault()
         {
-            AddAssert("first item selected", () => Client.CurrentMatchPlayingItem.Value == Client.APIRoom?.Playlist[0]);
+            AddAssert("first item selected", () => Client.CurrentMatchPlayingItem.Value?.ID == Client.APIRoom?.Playlist[0].ID);
         }
 
         [Test]
@@ -33,7 +33,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddAssert("playlist has 3 items", () => Client.APIRoom?.Playlist.Count == 3);
             AddAssert("last playlist item is different", () => Client.APIRoom?.Playlist[2].Beatmap.Value.OnlineID == InitialBeatmap.OnlineID);
 
-            AddAssert("first item still selected", () => Client.CurrentMatchPlayingItem.Value == Client.APIRoom?.Playlist[0]);
+            AddAssert("first item still selected", () => Client.CurrentMatchPlayingItem.Value?.ID == Client.APIRoom?.Playlist[0].ID);
         }
 
         [Test]
@@ -43,7 +43,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             AddAssert("playlist has only one item", () => Client.APIRoom?.Playlist.Count == 1);
             AddAssert("playlist item is expired", () => Client.APIRoom?.Playlist[0].Expired == true);
-            AddAssert("last item selected", () => Client.CurrentMatchPlayingItem.Value == Client.APIRoom?.Playlist[0]);
+            AddAssert("last item selected", () => Client.CurrentMatchPlayingItem.Value?.ID == Client.APIRoom?.Playlist[0].ID);
         }
 
         [Test]
@@ -55,12 +55,12 @@ namespace osu.Game.Tests.Visual.Multiplayer
             RunGameplay();
 
             AddAssert("first item expired", () => Client.APIRoom?.Playlist[0].Expired == true);
-            AddAssert("next item selected", () => Client.CurrentMatchPlayingItem.Value == Client.APIRoom?.Playlist[1]);
+            AddAssert("next item selected", () => Client.CurrentMatchPlayingItem.Value?.ID == Client.APIRoom?.Playlist[1].ID);
 
             RunGameplay();
 
             AddAssert("second item expired", () => Client.APIRoom?.Playlist[1].Expired == true);
-            AddAssert("next item selected", () => Client.CurrentMatchPlayingItem.Value == Client.APIRoom?.Playlist[2]);
+            AddAssert("next item selected", () => Client.CurrentMatchPlayingItem.Value?.ID == Client.APIRoom?.Playlist[2].ID);
         }
 
         [Test]
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneHostOnlyQueueMode.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneHostOnlyQueueMode.cs
index 2c60a98014..507292652f 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneHostOnlyQueueMode.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneHostOnlyQueueMode.cs
@@ -19,7 +19,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [Test]
         public void TestFirstItemSelectedByDefault()
         {
-            AddAssert("first item selected", () => Client.CurrentMatchPlayingItem.Value == Client.APIRoom?.Playlist[0]);
+            AddAssert("first item selected", () => Client.CurrentMatchPlayingItem.Value?.ID == Client.APIRoom?.Playlist[0].ID);
         }
 
         [Test]
@@ -27,7 +27,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             selectNewItem(() => InitialBeatmap);
 
-            AddAssert("playlist item still selected", () => Client.CurrentMatchPlayingItem.Value == Client.APIRoom?.Playlist[0]);
+            AddAssert("playlist item still selected", () => Client.CurrentMatchPlayingItem.Value?.ID == Client.APIRoom?.Playlist[0].ID);
         }
 
         [Test]
@@ -35,7 +35,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             selectNewItem(() => OtherBeatmap);
 
-            AddAssert("playlist item still selected", () => Client.CurrentMatchPlayingItem.Value == Client.APIRoom?.Playlist[0]);
+            AddAssert("playlist item still selected", () => Client.CurrentMatchPlayingItem.Value?.ID == Client.APIRoom?.Playlist[0].ID);
         }
 
         [Test]
@@ -46,7 +46,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddAssert("playlist contains two items", () => Client.APIRoom?.Playlist.Count == 2);
             AddAssert("first playlist item expired", () => Client.APIRoom?.Playlist[0].Expired == true);
             AddAssert("second playlist item not expired", () => Client.APIRoom?.Playlist[1].Expired == false);
-            AddAssert("second playlist item selected", () => Client.CurrentMatchPlayingItem.Value == Client.APIRoom?.Playlist[1]);
+            AddAssert("second playlist item selected", () => Client.CurrentMatchPlayingItem.Value?.ID == Client.APIRoom?.Playlist[1].ID);
         }
 
         [Test]

From 10dc08a8553be586d6b1946f3900723918d3f4fa Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Mon, 22 Nov 2021 11:18:21 +0900
Subject: [PATCH 1157/5547] Store server-side playlist instead of mutating
 client-side version

---
 .../Multiplayer/TestMultiplayerClient.cs      | 22 +++++++++++--------
 1 file changed, 13 insertions(+), 9 deletions(-)

diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
index 20226bdb4f..6d50188161 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
@@ -43,6 +43,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         private MultiplayerPlaylistItem? currentItem => Room?.Playlist[currentIndex];
 
         private readonly TestMultiplayerRoomManager roomManager;
+        private readonly List<MultiplayerPlaylistItem> serverSidePlaylist = new List<MultiplayerPlaylistItem>();
         private int currentIndex;
 
         public TestMultiplayerClient(TestMultiplayerRoomManager roomManager)
@@ -162,6 +163,9 @@ namespace osu.Game.Tests.Visual.Multiplayer
             if (password != apiRoom.Password.Value)
                 throw new InvalidOperationException("Invalid password.");
 
+            serverSidePlaylist.Clear();
+            serverSidePlaylist.AddRange(apiRoom.Playlist.Select(item => new MultiplayerPlaylistItem(item)));
+
             var localUser = new MultiplayerRoomUser(api.LocalUser.Value.Id)
             {
                 User = api.LocalUser.Value
@@ -176,7 +180,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     Password = password,
                     QueueMode = apiRoom.QueueMode.Value
                 },
-                Playlist = apiRoom.Playlist.Select(item => new MultiplayerPlaylistItem(item)).ToList(),
+                Playlist = serverSidePlaylist.ToList(),
                 Users = { localUser },
                 Host = localUser
             };
@@ -306,7 +310,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     // In host-only mode, the current item is re-used.
                     item.ID = currentItem.ID;
 
-                    Room.Playlist[currentIndex] = item;
+                    serverSidePlaylist[currentIndex] = item;
                     await ((IMultiplayerClient)this).PlaylistItemChanged(item).ConfigureAwait(false);
 
                     // Note: Unlike the server, this is the easiest way to update the current item at this point.
@@ -314,9 +318,9 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     break;
 
                 default:
-                    item.ID = Room.Playlist.Last().ID + 1;
+                    item.ID = serverSidePlaylist.Last().ID + 1;
 
-                    Room.Playlist.Add(item);
+                    serverSidePlaylist.Add(item);
                     await ((IMultiplayerClient)this).PlaylistItemAdded(item).ConfigureAwait(false);
 
                     await updateCurrentItem(Room).ConfigureAwait(false);
@@ -371,7 +375,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             Debug.Assert(currentItem != null);
 
             // When changing to host-only mode, ensure that at least one non-expired playlist item exists by duplicating the current item.
-            if (newMode == QueueMode.HostOnly && Room.Playlist.All(item => item.Expired))
+            if (newMode == QueueMode.HostOnly && serverSidePlaylist.All(item => item.Expired))
                 await duplicateCurrentItem().ConfigureAwait(false);
 
             // When changing modes, items could have been added (above) or the queueing order could have changed.
@@ -403,7 +407,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             var newItem = new MultiplayerPlaylistItem
             {
-                ID = Room.Playlist.Last().ID + 1,
+                ID = serverSidePlaylist.Last().ID + 1,
                 BeatmapID = currentItem.BeatmapID,
                 BeatmapChecksum = currentItem.BeatmapChecksum,
                 RulesetID = currentItem.RulesetID,
@@ -411,7 +415,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 AllowedMods = currentItem.AllowedMods
             };
 
-            Room.Playlist.Add(newItem);
+            serverSidePlaylist.Add(newItem);
             await ((IMultiplayerClient)this).PlaylistItemAdded(newItem).ConfigureAwait(false);
         }
 
@@ -423,7 +427,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             {
                 default:
                     // Pick the single non-expired playlist item.
-                    newItem = room.Playlist.FirstOrDefault(i => !i.Expired) ?? room.Playlist.Last();
+                    newItem = serverSidePlaylist.FirstOrDefault(i => !i.Expired) ?? serverSidePlaylist.Last();
                     break;
 
                 case QueueMode.AllPlayersRoundRobin:
@@ -431,7 +435,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     throw new NotImplementedException();
             }
 
-            currentIndex = room.Playlist.IndexOf(newItem);
+            currentIndex = serverSidePlaylist.IndexOf(newItem);
 
             long lastItem = room.Settings.PlaylistItemId;
             room.Settings.PlaylistItemId = newItem.ID;

From cad6d1d25d01dab516c1f395bf93e4bd4f6a4573 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Mon, 22 Nov 2021 11:20:18 +0900
Subject: [PATCH 1158/5547] Adjust test to match new logic

---
 .../Visual/Multiplayer/TestSceneAllPlayersQueueMode.cs        | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneAllPlayersQueueMode.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneAllPlayersQueueMode.cs
index 8e44c07a09..dcb01b83cc 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneAllPlayersQueueMode.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneAllPlayersQueueMode.cs
@@ -64,7 +64,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         }
 
         [Test]
-        public void TestItemsClearedWhenSwitchToHostOnlyMode()
+        public void TestItemsNotClearedWhenSwitchToHostOnlyMode()
         {
             addItem(() => OtherBeatmap);
             addItem(() => InitialBeatmap);
@@ -73,7 +73,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             RunGameplay();
 
             AddStep("change queue mode", () => Client.ChangeSettings(queueMode: QueueMode.HostOnly));
-            AddAssert("playlist has 2 items", () => Client.APIRoom?.Playlist.Count == 2);
+            AddAssert("playlist has 3 items", () => Client.APIRoom?.Playlist.Count == 3);
             AddAssert("playlist item is the other beatmap", () => Client.CurrentMatchPlayingItem.Value?.BeatmapID == OtherBeatmap.OnlineID);
             AddAssert("playlist item is not expired", () => Client.APIRoom?.Playlist[1].Expired == false);
         }

From f3ba62d2c210ff5e855289ec0c6843536f0f1c75 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Mon, 22 Nov 2021 11:26:41 +0900
Subject: [PATCH 1159/5547] Add xmldoc to serverSidePlaylist

---
 .../Tests/Visual/Multiplayer/TestMultiplayerClient.cs     | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
index 6d50188161..b54e243bde 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
@@ -40,10 +40,14 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [Resolved]
         private BeatmapManager beatmaps { get; set; } = null!;
 
-        private MultiplayerPlaylistItem? currentItem => Room?.Playlist[currentIndex];
-
         private readonly TestMultiplayerRoomManager roomManager;
+
+        /// <summary>
+        /// Guaranteed up-to-date playlist.
+        /// </summary>
         private readonly List<MultiplayerPlaylistItem> serverSidePlaylist = new List<MultiplayerPlaylistItem>();
+
+        private MultiplayerPlaylistItem? currentItem => Room?.Playlist[currentIndex];
         private int currentIndex;
 
         public TestMultiplayerClient(TestMultiplayerRoomManager roomManager)

From f64d20ed718555029a6a77ee0e8a652451046ab7 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Mon, 22 Nov 2021 13:46:01 +0900
Subject: [PATCH 1160/5547] Fix APIRoom queue mode not updated on change

---
 .../Visual/Multiplayer/TestSceneHostOnlyQueueMode.cs  | 11 +++++++++++
 osu.Game/Online/Multiplayer/MultiplayerClient.cs      |  1 +
 2 files changed, 12 insertions(+)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneHostOnlyQueueMode.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneHostOnlyQueueMode.cs
index 507292652f..efa5c481ed 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneHostOnlyQueueMode.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneHostOnlyQueueMode.cs
@@ -63,6 +63,17 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddAssert("second playlist item changed", () => Client.APIRoom?.Playlist[1].Beatmap.Value != firstBeatmap);
         }
 
+        [Test]
+        public void TestSettingsUpdatedWhenChangingQueueMode()
+        {
+            AddStep("change queue mode", () => Client.ChangeSettings(new MultiplayerRoomSettings
+            {
+                QueueMode = QueueMode.AllPlayers
+            }));
+
+            AddUntilStep("api room updated", () => Client.APIRoom?.QueueMode.Value == QueueMode.AllPlayers);
+        }
+
         private void selectNewItem(Func<BeatmapInfo> beatmap)
         {
             AddStep("click edit button", () =>
diff --git a/osu.Game/Online/Multiplayer/MultiplayerClient.cs b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
index ad3c1f6781..bd32687c5e 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
@@ -697,6 +697,7 @@ namespace osu.Game.Online.Multiplayer
             Room.Settings = settings;
             APIRoom.Name.Value = Room.Settings.Name;
             APIRoom.Password.Value = Room.Settings.Password;
+            APIRoom.QueueMode.Value = Room.Settings.QueueMode;
             RoomUpdated?.Invoke();
 
             CurrentMatchPlayingItem.Value = APIRoom.Playlist.SingleOrDefault(p => p.ID == settings.PlaylistItemId);

From ff13a980770b8ac162eb6663b80556e07c2679e6 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 22 Nov 2021 15:23:16 +0900
Subject: [PATCH 1161/5547] Reformat realm migrations list for legibility

---
 osu.Game/Database/RealmContextFactory.cs | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Database/RealmContextFactory.cs b/osu.Game/Database/RealmContextFactory.cs
index 42ae986921..e235effc64 100644
--- a/osu.Game/Database/RealmContextFactory.cs
+++ b/osu.Game/Database/RealmContextFactory.cs
@@ -33,10 +33,10 @@ namespace osu.Game.Database
 
         /// <summary>
         /// Version history:
-        /// 6  First tracked version (~20211018)
-        /// 7  Changed OnlineID fields to non-nullable to add indexing support (20211018)
-        /// 8  Rebind scroll adjust keys to not have control modifier (20211029)
-        /// 9  Converted BeatmapMetadata.Author from string to RealmUser (20211104)
+        /// 6    ~2021-10-18   First tracked version.
+        /// 7    2021-10-18    Changed OnlineID fields to non-nullable to add indexing support.
+        /// 8    2021-10-29    Rebind scroll adjust keys to not have control modifier.
+        /// 9    2021-11-04    Converted BeatmapMetadata.Author from string to RealmUser.
         /// </summary>
         private const int schema_version = 9;
 

From 1cdfa6d9a098fd2db3725227c43bc64395fb1689 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 22 Nov 2021 15:30:11 +0900
Subject: [PATCH 1162/5547] Add helper property to access a realm beatmap's
 beatmap file

---
 .../Database/BeatmapImporterTests.cs           | 18 ++++++++++++++++++
 osu.Game/Models/RealmBeatmap.cs                |  3 +++
 2 files changed, 21 insertions(+)

diff --git a/osu.Game.Tests/Database/BeatmapImporterTests.cs b/osu.Game.Tests/Database/BeatmapImporterTests.cs
index 75eb4a043a..71e5e9081c 100644
--- a/osu.Game.Tests/Database/BeatmapImporterTests.cs
+++ b/osu.Game.Tests/Database/BeatmapImporterTests.cs
@@ -74,6 +74,24 @@ namespace osu.Game.Tests.Database
             });
         }
 
+        [Test]
+        public void TestAccessFileAfterImport()
+        {
+            RunTestWithRealmAsync(async (realmFactory, storage) =>
+            {
+                using var importer = new BeatmapImporter(realmFactory, storage);
+                using var store = new RealmRulesetStore(realmFactory, storage);
+
+                var imported = await LoadOszIntoStore(importer, realmFactory.Context);
+
+                var beatmap = imported.Beatmaps.First();
+                var file = beatmap.File;
+
+                Assert.NotNull(file);
+                Assert.AreEqual(beatmap.Hash, file!.File.Hash);
+            });
+        }
+
         [Test]
         public void TestImportThenDelete()
         {
diff --git a/osu.Game/Models/RealmBeatmap.cs b/osu.Game/Models/RealmBeatmap.cs
index 1a25d55d04..d190eb0c3b 100644
--- a/osu.Game/Models/RealmBeatmap.cs
+++ b/osu.Game/Models/RealmBeatmap.cs
@@ -2,6 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
+using System.Linq;
 using JetBrains.Annotations;
 using Newtonsoft.Json;
 using osu.Framework.Testing;
@@ -35,6 +36,8 @@ namespace osu.Game.Models
 
         public RealmBeatmapSet? BeatmapSet { get; set; }
 
+        public RealmNamedFileUsage? File => BeatmapSet?.Files.First(f => f.File.Hash == Hash);
+
         public BeatmapSetOnlineStatus Status
         {
             get => (BeatmapSetOnlineStatus)StatusInt;

From 0633f3bcfe23513d671c0d5dc7bf7efcb603ba44 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Mon, 22 Nov 2021 16:35:58 +0900
Subject: [PATCH 1163/5547] Add owner id to playlist items

---
 osu.Game/Online/Multiplayer/MultiplayerClient.cs | 1 +
 osu.Game/Online/Rooms/PlaylistItem.cs            | 3 +++
 2 files changed, 4 insertions(+)

diff --git a/osu.Game/Online/Multiplayer/MultiplayerClient.cs b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
index ad3c1f6781..df16fb3042 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
@@ -720,6 +720,7 @@ namespace osu.Game.Online.Multiplayer
             var playlistItem = new PlaylistItem
             {
                 ID = item.ID,
+                OwnerID = item.OwnerID,
                 Beatmap = { Value = beatmap },
                 Ruleset = { Value = ruleset },
                 Expired = item.Expired
diff --git a/osu.Game/Online/Rooms/PlaylistItem.cs b/osu.Game/Online/Rooms/PlaylistItem.cs
index c889dc514b..a1480865b8 100644
--- a/osu.Game/Online/Rooms/PlaylistItem.cs
+++ b/osu.Game/Online/Rooms/PlaylistItem.cs
@@ -18,6 +18,9 @@ namespace osu.Game.Online.Rooms
         [JsonProperty("id")]
         public long ID { get; set; }
 
+        [JsonProperty("owner_id")]
+        public int OwnerID { get; set; }
+
         [JsonProperty("beatmap_id")]
         public int BeatmapID { get; set; }
 

From b9923e53969e3a2ebd267de46086f5c1a7cada7a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 22 Nov 2021 16:39:17 +0900
Subject: [PATCH 1164/5547] Remove subclassing of `RulesetInfo`

---
 .../Gameplay/TestSceneReplayRecorder.cs       |  4 +-
 .../Gameplay/TestSceneReplayRecording.cs      |  4 +-
 .../Gameplay/TestSceneSpectatorPlayback.cs    |  4 +-
 .../UserInterface/TestSceneModSettings.cs     | 48 +++++++---------
 osu.Game/Beatmaps/DummyWorkingBeatmap.cs      | 57 +++++++++----------
 5 files changed, 52 insertions(+), 65 deletions(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneReplayRecorder.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneReplayRecorder.cs
index 159d583fc0..dcc193669b 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneReplayRecorder.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneReplayRecorder.cs
@@ -55,7 +55,7 @@ namespace osu.Game.Tests.Visual.Gameplay
                 {
                     new Drawable[]
                     {
-                        recordingManager = new TestRulesetInputManager(new TestSceneModSettings.TestRulesetInfo(), 0, SimultaneousBindingMode.Unique)
+                        recordingManager = new TestRulesetInputManager(TestSceneModSettings.CreateTestRulesetInfo(), 0, SimultaneousBindingMode.Unique)
                         {
                             Recorder = recorder = new TestReplayRecorder(new Score
                             {
@@ -89,7 +89,7 @@ namespace osu.Game.Tests.Visual.Gameplay
                     },
                     new Drawable[]
                     {
-                        playbackManager = new TestRulesetInputManager(new TestSceneModSettings.TestRulesetInfo(), 0, SimultaneousBindingMode.Unique)
+                        playbackManager = new TestRulesetInputManager(TestSceneModSettings.CreateTestRulesetInfo(), 0, SimultaneousBindingMode.Unique)
                         {
                             ReplayInputHandler = new TestFramedReplayInputHandler(replay)
                             {
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneReplayRecording.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneReplayRecording.cs
index 1d4245308d..3f7155f1e2 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneReplayRecording.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneReplayRecording.cs
@@ -46,7 +46,7 @@ namespace osu.Game.Tests.Visual.Gameplay
                 {
                     new Drawable[]
                     {
-                        recordingManager = new TestRulesetInputManager(new TestSceneModSettings.TestRulesetInfo(), 0, SimultaneousBindingMode.Unique)
+                        recordingManager = new TestRulesetInputManager(TestSceneModSettings.CreateTestRulesetInfo(), 0, SimultaneousBindingMode.Unique)
                         {
                             Recorder = new TestReplayRecorder(new Score
                             {
@@ -80,7 +80,7 @@ namespace osu.Game.Tests.Visual.Gameplay
                     },
                     new Drawable[]
                     {
-                        playbackManager = new TestRulesetInputManager(new TestSceneModSettings.TestRulesetInfo(), 0, SimultaneousBindingMode.Unique)
+                        playbackManager = new TestRulesetInputManager(TestSceneModSettings.CreateTestRulesetInfo(), 0, SimultaneousBindingMode.Unique)
                         {
                             ReplayInputHandler = new TestFramedReplayInputHandler(replay)
                             {
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorPlayback.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorPlayback.cs
index ef870a32a9..5fbccd54c8 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorPlayback.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorPlayback.cs
@@ -109,7 +109,7 @@ namespace osu.Game.Tests.Visual.Gameplay
                 {
                     new Drawable[]
                     {
-                        recordingManager = new TestRulesetInputManager(new TestSceneModSettings.TestRulesetInfo(), 0, SimultaneousBindingMode.Unique)
+                        recordingManager = new TestRulesetInputManager(TestSceneModSettings.CreateTestRulesetInfo(), 0, SimultaneousBindingMode.Unique)
                         {
                             Recorder = recorder = new TestReplayRecorder
                             {
@@ -139,7 +139,7 @@ namespace osu.Game.Tests.Visual.Gameplay
                     },
                     new Drawable[]
                     {
-                        playbackManager = new TestRulesetInputManager(new TestSceneModSettings.TestRulesetInfo(), 0, SimultaneousBindingMode.Unique)
+                        playbackManager = new TestRulesetInputManager(TestSceneModSettings.CreateTestRulesetInfo(), 0, SimultaneousBindingMode.Unique)
                         {
                             Clock = new FramedClock(manualClock),
                             ReplayInputHandler = replayHandler = new TestFramedReplayInputHandler(replay)
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneModSettings.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneModSettings.cs
index 4bb5e29589..9a3083e8db 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneModSettings.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneModSettings.cs
@@ -35,7 +35,7 @@ namespace osu.Game.Tests.Visual.UserInterface
         public void SetUp() => Schedule(() =>
         {
             SelectedMods.Value = Array.Empty<Mod>();
-            Ruleset.Value = new TestRulesetInfo();
+            Ruleset.Value = CreateTestRulesetInfo();
         });
 
         [Test]
@@ -170,40 +170,32 @@ namespace osu.Game.Tests.Visual.UserInterface
                 ModSettingsContainer.Parent.Width = newWidth;
         }
 
-        public class TestRulesetInfo : RulesetInfo
+        public static RulesetInfo CreateTestRulesetInfo() => new TestCustomisableModRuleset().RulesetInfo;
+
+        public class TestCustomisableModRuleset : Ruleset
         {
-            public override Ruleset CreateInstance() => new TestCustomisableModRuleset();
-
-            public TestRulesetInfo()
+            public override IEnumerable<Mod> GetModsFor(ModType type)
             {
-                Available = true;
-            }
-
-            public class TestCustomisableModRuleset : Ruleset
-            {
-                public override IEnumerable<Mod> GetModsFor(ModType type)
+                if (type == ModType.Conversion)
                 {
-                    if (type == ModType.Conversion)
+                    return new Mod[]
                     {
-                        return new Mod[]
-                        {
-                            new TestModCustomisable1(),
-                            new TestModCustomisable2()
-                        };
-                    }
-
-                    return Array.Empty<Mod>();
+                        new TestModCustomisable1(),
+                        new TestModCustomisable2()
+                    };
                 }
 
-                public override DrawableRuleset CreateDrawableRulesetWith(IBeatmap beatmap, IReadOnlyList<Mod> mods = null) => throw new NotImplementedException();
-
-                public override IBeatmapConverter CreateBeatmapConverter(IBeatmap beatmap) => throw new NotImplementedException();
-
-                public override DifficultyCalculator CreateDifficultyCalculator(IWorkingBeatmap beatmap) => throw new NotImplementedException();
-
-                public override string Description { get; } = "test";
-                public override string ShortName { get; } = "tst";
+                return Array.Empty<Mod>();
             }
+
+            public override DrawableRuleset CreateDrawableRulesetWith(IBeatmap beatmap, IReadOnlyList<Mod> mods = null) => throw new NotImplementedException();
+
+            public override IBeatmapConverter CreateBeatmapConverter(IBeatmap beatmap) => throw new NotImplementedException();
+
+            public override DifficultyCalculator CreateDifficultyCalculator(IWorkingBeatmap beatmap) => throw new NotImplementedException();
+
+            public override string Description { get; } = "test";
+            public override string ShortName { get; } = "tst";
         }
 
         private class TestModCustomisable1 : TestModCustomisable
diff --git a/osu.Game/Beatmaps/DummyWorkingBeatmap.cs b/osu.Game/Beatmaps/DummyWorkingBeatmap.cs
index fcb44c462d..9ea8517764 100644
--- a/osu.Game/Beatmaps/DummyWorkingBeatmap.cs
+++ b/osu.Game/Beatmaps/DummyWorkingBeatmap.cs
@@ -38,7 +38,7 @@ namespace osu.Game.Beatmaps
                     CircleSize = 0,
                     OverallDifficulty = 0,
                 },
-                Ruleset = new DummyRulesetInfo()
+                Ruleset = new DummyRuleset().RulesetInfo
             }, audio)
         {
             this.textures = textures;
@@ -54,42 +54,37 @@ namespace osu.Game.Beatmaps
 
         public override Stream GetStream(string storagePath) => null;
 
-        private class DummyRulesetInfo : RulesetInfo
+        private class DummyRuleset : Ruleset
         {
-            public override Ruleset CreateInstance() => new DummyRuleset();
+            public override IEnumerable<Mod> GetModsFor(ModType type) => Array.Empty<Mod>();
 
-            private class DummyRuleset : Ruleset
+            public override DrawableRuleset CreateDrawableRulesetWith(IBeatmap beatmap, IReadOnlyList<Mod> mods = null)
             {
-                public override IEnumerable<Mod> GetModsFor(ModType type) => Array.Empty<Mod>();
+                throw new NotImplementedException();
+            }
 
-                public override DrawableRuleset CreateDrawableRulesetWith(IBeatmap beatmap, IReadOnlyList<Mod> mods = null)
+            public override IBeatmapConverter CreateBeatmapConverter(IBeatmap beatmap) => new DummyBeatmapConverter { Beatmap = beatmap };
+
+            public override DifficultyCalculator CreateDifficultyCalculator(IWorkingBeatmap beatmap) => null;
+
+            public override string Description => "dummy";
+
+            public override string ShortName => "dummy";
+
+            private class DummyBeatmapConverter : IBeatmapConverter
+            {
+                public event Action<HitObject, IEnumerable<HitObject>> ObjectConverted;
+
+                public IBeatmap Beatmap { get; set; }
+
+                public bool CanConvert() => true;
+
+                public IBeatmap Convert(CancellationToken cancellationToken = default)
                 {
-                    throw new NotImplementedException();
-                }
+                    foreach (var obj in Beatmap.HitObjects)
+                        ObjectConverted?.Invoke(obj, obj.Yield());
 
-                public override IBeatmapConverter CreateBeatmapConverter(IBeatmap beatmap) => new DummyBeatmapConverter { Beatmap = beatmap };
-
-                public override DifficultyCalculator CreateDifficultyCalculator(IWorkingBeatmap beatmap) => null;
-
-                public override string Description => "dummy";
-
-                public override string ShortName => "dummy";
-
-                private class DummyBeatmapConverter : IBeatmapConverter
-                {
-                    public event Action<HitObject, IEnumerable<HitObject>> ObjectConverted;
-
-                    public IBeatmap Beatmap { get; set; }
-
-                    public bool CanConvert() => true;
-
-                    public IBeatmap Convert(CancellationToken cancellationToken = default)
-                    {
-                        foreach (var obj in Beatmap.HitObjects)
-                            ObjectConverted?.Invoke(obj, obj.Yield());
-
-                        return Beatmap;
-                    }
+                    return Beatmap;
                 }
             }
         }

From cb5b6911e6d3263e01f11f49258214cf256f705b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 22 Nov 2021 16:39:26 +0900
Subject: [PATCH 1165/5547] Seal `RulesetInfo` and remove `virtual` methods

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

diff --git a/osu.Game/Rulesets/RulesetInfo.cs b/osu.Game/Rulesets/RulesetInfo.cs
index 8083041a3b..ccb614fe91 100644
--- a/osu.Game/Rulesets/RulesetInfo.cs
+++ b/osu.Game/Rulesets/RulesetInfo.cs
@@ -10,7 +10,7 @@ using osu.Framework.Testing;
 namespace osu.Game.Rulesets
 {
     [ExcludeFromDynamicCompile]
-    public class RulesetInfo : IEquatable<RulesetInfo>, IRulesetInfo
+    public sealed class RulesetInfo : IEquatable<RulesetInfo>, IRulesetInfo
     {
         public int? ID { get; set; }
 
@@ -24,7 +24,7 @@ namespace osu.Game.Rulesets
         public bool Available { get; set; }
 
         // TODO: this should probably be moved to RulesetStore.
-        public virtual Ruleset CreateInstance()
+        public Ruleset CreateInstance()
         {
             if (!Available) return null;
 

From a8bc1ab052dbc75aa9461cf65545d228b8706a95 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 22 Nov 2021 16:45:55 +0900
Subject: [PATCH 1166/5547] Attempt to fix fody issues by ignoring new property

---
 osu.Game/Models/RealmBeatmap.cs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Game/Models/RealmBeatmap.cs b/osu.Game/Models/RealmBeatmap.cs
index d190eb0c3b..4e3f96ee5f 100644
--- a/osu.Game/Models/RealmBeatmap.cs
+++ b/osu.Game/Models/RealmBeatmap.cs
@@ -36,6 +36,7 @@ namespace osu.Game.Models
 
         public RealmBeatmapSet? BeatmapSet { get; set; }
 
+        [Ignored]
         public RealmNamedFileUsage? File => BeatmapSet?.Files.First(f => f.File.Hash == Hash);
 
         public BeatmapSetOnlineStatus Status

From 377ba2673aa1f6869e7bca74de95df2e99717365 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 22 Nov 2021 16:52:54 +0900
Subject: [PATCH 1167/5547] Use `Ruleset`'s `ShortName` for mod caching
 purposes

---
 osu.Game/Rulesets/Ruleset.cs | 9 +++------
 1 file changed, 3 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Rulesets/Ruleset.cs b/osu.Game/Rulesets/Ruleset.cs
index ade763eed8..a252bd4786 100644
--- a/osu.Game/Rulesets/Ruleset.cs
+++ b/osu.Game/Rulesets/Ruleset.cs
@@ -39,7 +39,7 @@ namespace osu.Game.Rulesets
     {
         public RulesetInfo RulesetInfo { get; internal set; }
 
-        private static readonly ConcurrentDictionary<int, IMod[]> mod_reference_cache = new ConcurrentDictionary<int, IMod[]>();
+        private static readonly ConcurrentDictionary<string, IMod[]> mod_reference_cache = new ConcurrentDictionary<string, IMod[]>();
 
         /// <summary>
         /// A queryable source containing all available mods.
@@ -49,11 +49,8 @@ namespace osu.Game.Rulesets
         {
             get
             {
-                if (!(RulesetInfo.ID is int id))
-                    return CreateAllMods();
-
-                if (!mod_reference_cache.TryGetValue(id, out var mods))
-                    mod_reference_cache[id] = mods = CreateAllMods().Cast<IMod>().ToArray();
+                if (!mod_reference_cache.TryGetValue(ShortName, out var mods))
+                    mod_reference_cache[ShortName] = mods = CreateAllMods().Cast<IMod>().ToArray();
 
                 return mods;
             }

From 001f7c36f36fe8151d422d45de86d7328acfaa72 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 22 Nov 2021 17:15:26 +0900
Subject: [PATCH 1168/5547] Use `Equals` in carousel tests for better realm
 compatibility

---
 .../SongSelect/TestSceneBeatmapCarousel.cs    | 25 ++++++++++---------
 .../SongSelect/TestScenePlaySongSelect.cs     |  8 +++---
 2 files changed, 17 insertions(+), 16 deletions(-)

diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs
index 534442c8b6..5c40a3dd94 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs
@@ -78,9 +78,9 @@ namespace osu.Game.Tests.Visual.SongSelect
                 {
                     AddStep("store selection", () => selection = carousel.SelectedBeatmapInfo);
                     if (isIterating)
-                        AddUntilStep("selection changed", () => carousel.SelectedBeatmapInfo != selection);
+                        AddUntilStep("selection changed", () => !carousel.SelectedBeatmapInfo.Equals(selection));
                     else
-                        AddUntilStep("selection not changed", () => carousel.SelectedBeatmapInfo == selection);
+                        AddUntilStep("selection not changed", () => carousel.SelectedBeatmapInfo.Equals(selection));
                 }
             }
         }
@@ -412,7 +412,8 @@ namespace osu.Game.Tests.Visual.SongSelect
 
             for (int i = 0; i < 20; i++)
             {
-                var set = createTestBeatmapSet(i);
+                // index + 1 because we are using OnlineID which should never be zero.
+                var set = createTestBeatmapSet(i + 1);
                 set.Metadata.Artist = "same artist";
                 set.Metadata.Title = "same title";
                 sets.Add(set);
@@ -421,10 +422,10 @@ namespace osu.Game.Tests.Visual.SongSelect
             loadBeatmaps(sets);
 
             AddStep("Sort by artist", () => carousel.Filter(new FilterCriteria { Sort = SortMode.Artist }, false));
-            AddAssert("Items remain in original order", () => carousel.BeatmapSets.Select((set, index) => set.ID == index).All(b => b));
+            AddAssert("Items remain in original order", () => carousel.BeatmapSets.Select((set, index) => set.OnlineID == index + 1).All(b => b));
 
             AddStep("Sort by title", () => carousel.Filter(new FilterCriteria { Sort = SortMode.Title }, false));
-            AddAssert("Items remain in original order", () => carousel.BeatmapSets.Select((set, index) => set.ID == index).All(b => b));
+            AddAssert("Items remain in original order", () => carousel.BeatmapSets.Select((set, index) => set.OnlineID == index + 1).All(b => b));
         }
 
         [Test]
@@ -443,12 +444,12 @@ namespace osu.Game.Tests.Visual.SongSelect
             loadBeatmaps(sets);
 
             AddStep("Filter to normal", () => carousel.Filter(new FilterCriteria { Sort = SortMode.Difficulty, SearchText = "Normal" }, false));
-            AddAssert("Check first set at end", () => carousel.BeatmapSets.First() == sets.Last());
-            AddAssert("Check last set at start", () => carousel.BeatmapSets.Last() == sets.First());
+            AddAssert("Check first set at end", () => carousel.BeatmapSets.First().Equals(sets.Last()));
+            AddAssert("Check last set at start", () => carousel.BeatmapSets.Last().Equals(sets.First()));
 
             AddStep("Filter to insane", () => carousel.Filter(new FilterCriteria { Sort = SortMode.Difficulty, SearchText = "Insane" }, false));
-            AddAssert("Check first set at start", () => carousel.BeatmapSets.First() == sets.First());
-            AddAssert("Check last set at end", () => carousel.BeatmapSets.Last() == sets.Last());
+            AddAssert("Check first set at start", () => carousel.BeatmapSets.First().Equals(sets.First()));
+            AddAssert("Check last set at end", () => carousel.BeatmapSets.Last().Equals(sets.Last()));
         }
 
         [Test]
@@ -662,7 +663,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                     eagerSelectedIDs.Add(carousel.SelectedBeatmapSet.ID);
                 });
 
-                AddAssert("selection changed", () => carousel.SelectedBeatmapInfo != manySets.First().Beatmaps.First());
+                AddAssert("selection changed", () => !carousel.SelectedBeatmapInfo.Equals(manySets.First().Beatmaps.First()));
             }
 
             AddAssert("Selection was random", () => eagerSelectedIDs.Count > 2);
@@ -759,13 +760,13 @@ namespace osu.Game.Tests.Visual.SongSelect
         }
 
         private void ensureRandomFetchSuccess() =>
-            AddAssert("ensure prev random fetch worked", () => selectedSets.Peek() == carousel.SelectedBeatmapSet);
+            AddAssert("ensure prev random fetch worked", () => selectedSets.Peek().Equals(carousel.SelectedBeatmapSet));
 
         private void waitForSelection(int set, int? diff = null) =>
             AddUntilStep($"selected is set{set}{(diff.HasValue ? $" diff{diff.Value}" : "")}", () =>
             {
                 if (diff != null)
-                    return carousel.SelectedBeatmapInfo == carousel.BeatmapSets.Skip(set - 1).First().Beatmaps.Skip(diff.Value - 1).First();
+                    return carousel.SelectedBeatmapInfo.Equals(carousel.BeatmapSets.Skip(set - 1).First().Beatmaps.Skip(diff.Value - 1).First());
 
                 return carousel.BeatmapSets.Skip(set - 1).First().Beatmaps.Contains(carousel.SelectedBeatmapInfo);
             });
diff --git a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
index 0437c1b25b..f09dc38378 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
@@ -148,7 +148,7 @@ namespace osu.Game.Tests.Visual.SongSelect
             AddStep("select next and enter", () =>
             {
                 InputManager.MoveMouseTo(songSelect.Carousel.ChildrenOfType<DrawableCarouselBeatmap>()
-                                                   .First(b => ((CarouselBeatmap)b.Item).BeatmapInfo != songSelect.Carousel.SelectedBeatmapInfo));
+                                                   .First(b => !((CarouselBeatmap)b.Item).BeatmapInfo.Equals(songSelect.Carousel.SelectedBeatmapInfo)));
 
                 InputManager.Click(MouseButton.Left);
 
@@ -175,7 +175,7 @@ namespace osu.Game.Tests.Visual.SongSelect
             AddStep("select next and enter", () =>
             {
                 InputManager.MoveMouseTo(songSelect.Carousel.ChildrenOfType<DrawableCarouselBeatmap>()
-                                                   .First(b => ((CarouselBeatmap)b.Item).BeatmapInfo != songSelect.Carousel.SelectedBeatmapInfo));
+                                                   .First(b => !((CarouselBeatmap)b.Item).BeatmapInfo.Equals(songSelect.Carousel.SelectedBeatmapInfo)));
 
                 InputManager.PressButton(MouseButton.Left);
 
@@ -644,7 +644,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                 InputManager.Click(MouseButton.Left);
             });
 
-            AddAssert("Selected beatmap correct", () => songSelect.Carousel.SelectedBeatmapInfo == filteredBeatmap);
+            AddAssert("Selected beatmap correct", () => songSelect.Carousel.SelectedBeatmapInfo.Equals(filteredBeatmap));
         }
 
         [Test]
@@ -858,7 +858,7 @@ namespace osu.Game.Tests.Visual.SongSelect
             AddUntilStep("wait for difficulty panels visible", () => songSelect.Carousel.ChildrenOfType<DrawableCarouselBeatmap>().Any());
         }
 
-        private int getBeatmapIndex(BeatmapSetInfo set, BeatmapInfo info) => set.Beatmaps.FindIndex(b => b == info);
+        private int getBeatmapIndex(BeatmapSetInfo set, BeatmapInfo info) => set.Beatmaps.IndexOf(info);
 
         private int getCurrentBeatmapIndex() => getBeatmapIndex(songSelect.Carousel.SelectedBeatmapSet, songSelect.Carousel.SelectedBeatmapInfo);
 

From f1926c6d275c082f2f0fa8df20aa6e6090982f75 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 22 Nov 2021 17:40:43 +0900
Subject: [PATCH 1169/5547] Store preferred ruleset to configuration using
 `ShortName` instead of `ID`

---
 osu.Game/Configuration/OsuConfigManager.cs |  2 +-
 osu.Game/OsuGame.cs                        | 64 +++++++++++-----------
 2 files changed, 34 insertions(+), 32 deletions(-)

diff --git a/osu.Game/Configuration/OsuConfigManager.cs b/osu.Game/Configuration/OsuConfigManager.cs
index 1beef89b51..84da3f666d 100644
--- a/osu.Game/Configuration/OsuConfigManager.cs
+++ b/osu.Game/Configuration/OsuConfigManager.cs
@@ -26,7 +26,7 @@ namespace osu.Game.Configuration
         protected override void InitialiseDefaults()
         {
             // UI/selection defaults
-            SetDefault(OsuSetting.Ruleset, 0, 0, int.MaxValue);
+            SetDefault(OsuSetting.Ruleset, string.Empty);
             SetDefault(OsuSetting.Skin, 0, -1, int.MaxValue);
 
             SetDefault(OsuSetting.BeatmapDetailTab, PlayBeatmapDetailArea.TabType.Details);
diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index 1274d8d867..574a5e5393 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -4,59 +4,58 @@
 using System;
 using System.Collections.Generic;
 using System.Diagnostics;
-using osu.Framework.Configuration;
-using osu.Framework.Screens;
-using osu.Game.Configuration;
-using osu.Framework.Graphics;
-using osu.Framework.Graphics.Containers;
-using osu.Game.Overlays;
-using osu.Framework.Logging;
-using osu.Framework.Allocation;
-using osu.Game.Overlays.Toolbar;
-using osu.Game.Screens;
-using osu.Game.Screens.Menu;
 using System.Linq;
 using System.Threading;
 using System.Threading.Tasks;
 using Humanizer;
 using JetBrains.Annotations;
+using osu.Framework.Allocation;
 using osu.Framework.Audio;
 using osu.Framework.Bindables;
+using osu.Framework.Configuration;
 using osu.Framework.Extensions.IEnumerableExtensions;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Input;
 using osu.Framework.Input.Bindings;
 using osu.Framework.Input.Events;
+using osu.Framework.Logging;
+using osu.Framework.Screens;
 using osu.Framework.Threading;
 using osu.Game.Beatmaps;
 using osu.Game.Collections;
+using osu.Game.Configuration;
+using osu.Game.Database;
+using osu.Game.Extensions;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Input;
-using osu.Game.Overlays.Notifications;
 using osu.Game.Input.Bindings;
-using osu.Game.Online.Chat;
-using osu.Game.Overlays.Music;
-using osu.Game.Skinning;
-using osuTK.Graphics;
-using osu.Game.Overlays.Volume;
-using osu.Game.Rulesets.Mods;
-using osu.Game.Scoring;
-using osu.Game.Screens.Play;
-using osu.Game.Screens.Ranking;
-using osu.Game.Screens.Select;
-using osu.Game.Updater;
-using osu.Game.Utils;
-using LogLevel = osu.Framework.Logging.LogLevel;
-using osu.Game.Database;
-using osu.Game.Extensions;
 using osu.Game.IO;
 using osu.Game.Localisation;
 using osu.Game.Online.API.Requests.Responses;
+using osu.Game.Online.Chat;
+using osu.Game.Overlays;
+using osu.Game.Overlays.Music;
+using osu.Game.Overlays.Notifications;
+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;
+using osu.Game.Screens.Menu;
+using osu.Game.Screens.Play;
+using osu.Game.Screens.Ranking;
+using osu.Game.Screens.Select;
+using osu.Game.Skinning;
 using osu.Game.Skinning.Editor;
+using osu.Game.Updater;
 using osu.Game.Users;
+using osu.Game.Utils;
+using osuTK.Graphics;
 
 namespace osu.Game
 {
@@ -158,7 +157,7 @@ namespace osu.Game
         [CanBeNull]
         private IntroScreen introScreen;
 
-        private Bindable<int> configRuleset;
+        private Bindable<string> configRuleset;
 
         private Bindable<float> uiScale;
 
@@ -222,10 +221,13 @@ namespace osu.Game
             dependencies.Cache(osuLogo = new OsuLogo { Alpha = 0 });
 
             // bind config int to database RulesetInfo
-            configRuleset = LocalConfig.GetBindable<int>(OsuSetting.Ruleset);
+            configRuleset = LocalConfig.GetBindable<string>(OsuSetting.Ruleset);
             uiScale = LocalConfig.GetBindable<float>(OsuSetting.UIScale);
 
-            var preferredRuleset = RulesetStore.GetRuleset(configRuleset.Value);
+            var preferredRuleset = int.TryParse(configRuleset.Value, out int rulesetId)
+                // int parsing can be removed 20220522
+                ? RulesetStore.GetRuleset(rulesetId)
+                : RulesetStore.GetRuleset(configRuleset.Value);
 
             try
             {
@@ -238,7 +240,7 @@ namespace osu.Game
                 Ruleset.Value = RulesetStore.AvailableRulesets.First();
             }
 
-            Ruleset.ValueChanged += r => configRuleset.Value = r.NewValue.ID ?? 0;
+            Ruleset.ValueChanged += r => configRuleset.Value = r.NewValue.ShortName;
 
             // bind config int to database SkinInfo
             configSkin = LocalConfig.GetBindable<int>(OsuSetting.Skin);

From 361cb7888071da026f7cacdc0486d88e05708598 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 22 Nov 2021 18:37:28 +0900
Subject: [PATCH 1170/5547] Fix realm applying migrations from one version too
 early

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

diff --git a/osu.Game/Database/RealmContextFactory.cs b/osu.Game/Database/RealmContextFactory.cs
index 42ae986921..0bb46a379a 100644
--- a/osu.Game/Database/RealmContextFactory.cs
+++ b/osu.Game/Database/RealmContextFactory.cs
@@ -153,13 +153,13 @@ namespace osu.Game.Database
 
         private void onMigration(Migration migration, ulong lastSchemaVersion)
         {
-            for (ulong i = lastSchemaVersion; i <= schema_version; i++)
+            for (ulong i = lastSchemaVersion + 1; i <= schema_version; i++)
                 applyMigrationsForVersion(migration, i);
         }
 
-        private void applyMigrationsForVersion(Migration migration, ulong version)
+        private void applyMigrationsForVersion(Migration migration, ulong targetVersion)
         {
-            switch (version)
+            switch (targetVersion)
             {
                 case 7:
                     convertOnlineIDs<RealmBeatmap>();

From d2062ff97fda0507ca1a1c12f853eb6713f548c4 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 22 Nov 2021 15:23:16 +0900
Subject: [PATCH 1171/5547] Reformat realm migrations list for legibility

---
 osu.Game/Database/RealmContextFactory.cs | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Database/RealmContextFactory.cs b/osu.Game/Database/RealmContextFactory.cs
index 0bb46a379a..e773ea9767 100644
--- a/osu.Game/Database/RealmContextFactory.cs
+++ b/osu.Game/Database/RealmContextFactory.cs
@@ -33,10 +33,10 @@ namespace osu.Game.Database
 
         /// <summary>
         /// Version history:
-        /// 6  First tracked version (~20211018)
-        /// 7  Changed OnlineID fields to non-nullable to add indexing support (20211018)
-        /// 8  Rebind scroll adjust keys to not have control modifier (20211029)
-        /// 9  Converted BeatmapMetadata.Author from string to RealmUser (20211104)
+        /// 6    ~2021-10-18   First tracked version.
+        /// 7    2021-10-18    Changed OnlineID fields to non-nullable to add indexing support.
+        /// 8    2021-10-29    Rebind scroll adjust keys to not have control modifier.
+        /// 9    2021-11-04    Converted BeatmapMetadata.Author from string to RealmUser.
         /// </summary>
         private const int schema_version = 9;
 

From ca26b6c5408309256ebbc4d89324cc52d472823a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 22 Nov 2021 18:51:37 +0900
Subject: [PATCH 1172/5547] Provide `RealmContextFactory` with the EF
 `RulesetStore` for migration purposes

---
 osu.Game/Database/RealmContextFactory.cs | 6 +++++-
 osu.Game/OsuGameBase.cs                  | 4 ++--
 2 files changed, 7 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Database/RealmContextFactory.cs b/osu.Game/Database/RealmContextFactory.cs
index e773ea9767..1d0da3ea5c 100644
--- a/osu.Game/Database/RealmContextFactory.cs
+++ b/osu.Game/Database/RealmContextFactory.cs
@@ -13,6 +13,7 @@ using osu.Framework.Platform;
 using osu.Framework.Statistics;
 using osu.Game.Input.Bindings;
 using osu.Game.Models;
+using osu.Game.Rulesets;
 using Realms;
 
 #nullable enable
@@ -31,6 +32,8 @@ namespace osu.Game.Database
         /// </summary>
         public readonly string Filename;
 
+        private readonly RulesetStore? rulesets;
+
         /// <summary>
         /// Version history:
         /// 6    ~2021-10-18   First tracked version.
@@ -72,9 +75,10 @@ namespace osu.Game.Database
             }
         }
 
-        public RealmContextFactory(Storage storage, string filename)
+        public RealmContextFactory(Storage storage, string filename, RulesetStore? rulesets = null)
         {
             this.storage = storage;
+            this.rulesets = rulesets;
 
             Filename = filename;
 
diff --git a/osu.Game/OsuGameBase.cs b/osu.Game/OsuGameBase.cs
index e207d9ce3b..3b2f397a72 100644
--- a/osu.Game/OsuGameBase.cs
+++ b/osu.Game/OsuGameBase.cs
@@ -187,8 +187,9 @@ namespace osu.Game
             Resources.AddStore(new DllResourceStore(OsuResources.ResourceAssembly));
 
             dependencies.Cache(contextFactory = new DatabaseContextFactory(Storage));
+            dependencies.Cache(RulesetStore = new RulesetStore(contextFactory, Storage));
 
-            dependencies.Cache(realmFactory = new RealmContextFactory(Storage, "client"));
+            dependencies.Cache(realmFactory = new RealmContextFactory(Storage, "client", RulesetStore));
 
             dependencies.CacheAs(Storage);
 
@@ -227,7 +228,6 @@ namespace osu.Game
 
             var defaultBeatmap = new DummyWorkingBeatmap(Audio, Textures);
 
-            dependencies.Cache(RulesetStore = new RulesetStore(contextFactory, Storage));
             dependencies.Cache(fileStore = new FileStore(contextFactory, Storage));
 
             // ordering is important here to ensure foreign keys rules are not broken in ModelStore.Cleanup()

From 329bae50b0e99b3450fc84daa9f3a4828c433c11 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 22 Nov 2021 18:07:28 +0900
Subject: [PATCH 1173/5547] Switch realm ruleset configuration to use ruleset's
 `ShortName` as key

---
 osu.Game/Configuration/RealmRulesetSetting.cs |  9 ++-----
 osu.Game/Database/RealmContextFactory.cs      | 26 ++++++++++++++++++-
 osu.Game/OsuGameBase.cs                       |  3 ++-
 .../Configuration/RulesetConfigManager.cs     | 13 ++++------
 4 files changed, 34 insertions(+), 17 deletions(-)

diff --git a/osu.Game/Configuration/RealmRulesetSetting.cs b/osu.Game/Configuration/RealmRulesetSetting.cs
index 07e56ad8dd..3fea35ee9d 100644
--- a/osu.Game/Configuration/RealmRulesetSetting.cs
+++ b/osu.Game/Configuration/RealmRulesetSetting.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 osu.Game.Database;
 using Realms;
 
 #nullable enable
@@ -10,13 +8,10 @@ using Realms;
 namespace osu.Game.Configuration
 {
     [MapTo(@"RulesetSetting")]
-    public class RealmRulesetSetting : RealmObject, IHasGuidPrimaryKey
+    public class RealmRulesetSetting : RealmObject
     {
-        [PrimaryKey]
-        public Guid ID { get; set; } = Guid.NewGuid();
-
         [Indexed]
-        public int RulesetID { get; set; }
+        public string RulesetName { get; set; } = string.Empty;
 
         [Indexed]
         public int Variant { get; set; }
diff --git a/osu.Game/Database/RealmContextFactory.cs b/osu.Game/Database/RealmContextFactory.cs
index 1d0da3ea5c..70ea24b581 100644
--- a/osu.Game/Database/RealmContextFactory.cs
+++ b/osu.Game/Database/RealmContextFactory.cs
@@ -11,6 +11,7 @@ using osu.Framework.Input.Bindings;
 using osu.Framework.Logging;
 using osu.Framework.Platform;
 using osu.Framework.Statistics;
+using osu.Game.Configuration;
 using osu.Game.Input.Bindings;
 using osu.Game.Models;
 using osu.Game.Rulesets;
@@ -40,8 +41,9 @@ namespace osu.Game.Database
         /// 7    2021-10-18    Changed OnlineID fields to non-nullable to add indexing support.
         /// 8    2021-10-29    Rebind scroll adjust keys to not have control modifier.
         /// 9    2021-11-04    Converted BeatmapMetadata.Author from string to RealmUser.
+        /// 10   2021-11-22    Use ShortName instead of RulesetID for ruleset settings.
         /// </summary>
-        private const int schema_version = 9;
+        private const int schema_version = 10;
 
         /// <summary>
         /// Lock object which is held during <see cref="BlockAllOperations"/> sections, blocking context creation during blocking periods.
@@ -236,6 +238,28 @@ namespace osu.Game.Database
                         };
                     }
 
+                    break;
+
+                case 10:
+                    string rulesetSettingClassName = getMappedOrOriginalName(typeof(RealmRulesetSetting));
+
+                    var oldSettings = migration.OldRealm.DynamicApi.All(rulesetSettingClassName);
+                    var newSettings = migration.NewRealm.All<RealmRulesetSetting>().ToList();
+
+                    for (int i = 0; i < newSettings.Count; i++)
+                    {
+                        dynamic? oldItem = oldSettings.ElementAt(i);
+                        var newItem = newSettings.ElementAt(i);
+
+                        long rulesetId = oldItem.RulesetID;
+                        string? rulesetName = rulesets?.GetRuleset((int)rulesetId)?.ShortName;
+
+                        if (string.IsNullOrEmpty(rulesetName))
+                            migration.NewRealm.Remove(newItem);
+                        else
+                            newItem.RulesetName = rulesetName;
+                    }
+
                     break;
             }
         }
diff --git a/osu.Game/OsuGameBase.cs b/osu.Game/OsuGameBase.cs
index 3b2f397a72..d8050353c5 100644
--- a/osu.Game/OsuGameBase.cs
+++ b/osu.Game/OsuGameBase.cs
@@ -456,7 +456,8 @@ namespace osu.Game
                         {
                             Key = dkb.Key,
                             Value = dkb.StringValue,
-                            RulesetID = dkb.RulesetID.Value,
+                            // important: this RulesetStore must be the EF one.
+                            RulesetName = RulesetStore.GetRuleset(dkb.RulesetID.Value).ShortName,
                             Variant = dkb.Variant ?? 0,
                         });
                     }
diff --git a/osu.Game/Rulesets/Configuration/RulesetConfigManager.cs b/osu.Game/Rulesets/Configuration/RulesetConfigManager.cs
index eec71a3623..17678775e9 100644
--- a/osu.Game/Rulesets/Configuration/RulesetConfigManager.cs
+++ b/osu.Game/Rulesets/Configuration/RulesetConfigManager.cs
@@ -20,16 +20,13 @@ namespace osu.Game.Rulesets.Configuration
 
         private List<RealmRulesetSetting> databasedSettings = new List<RealmRulesetSetting>();
 
-        private readonly int rulesetId;
+        private readonly string rulesetName;
 
         protected RulesetConfigManager(SettingsStore store, RulesetInfo ruleset, int? variant = null)
         {
             realmFactory = store?.Realm;
 
-            if (realmFactory != null && !ruleset.ID.HasValue)
-                throw new InvalidOperationException("Attempted to add databased settings for a non-databased ruleset");
-
-            rulesetId = ruleset.ID ?? -1;
+            rulesetName = ruleset.ShortName;
 
             this.variant = variant ?? 0;
 
@@ -43,7 +40,7 @@ namespace osu.Game.Rulesets.Configuration
             if (realmFactory != null)
             {
                 // As long as RulesetConfigCache exists, there is no need to subscribe to realm events.
-                databasedSettings = realmFactory.Context.All<RealmRulesetSetting>().Where(b => b.RulesetID == rulesetId && b.Variant == variant).ToList();
+                databasedSettings = realmFactory.Context.All<RealmRulesetSetting>().Where(b => b.RulesetName == rulesetName && b.Variant == variant).ToList();
             }
         }
 
@@ -68,7 +65,7 @@ namespace osu.Game.Rulesets.Configuration
                 {
                     foreach (var c in changed)
                     {
-                        var setting = realm.All<RealmRulesetSetting>().First(s => s.RulesetID == rulesetId && s.Variant == variant && s.Key == c.ToString());
+                        var setting = realm.All<RealmRulesetSetting>().First(s => s.RulesetName == rulesetName && s.Variant == variant && s.Key == c.ToString());
 
                         setting.Value = ConfigStore[c].ToString();
                     }
@@ -94,7 +91,7 @@ namespace osu.Game.Rulesets.Configuration
                 {
                     Key = lookup.ToString(),
                     Value = bindable.Value.ToString(),
-                    RulesetID = rulesetId,
+                    RulesetName = rulesetName,
                     Variant = variant,
                 };
 

From d94b27a8a22bae840d5a1eaac09468946ac8dec7 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 22 Nov 2021 18:34:04 +0900
Subject: [PATCH 1174/5547] Switch realm ruleset key bindings to use ruleset's
 `ShortName` as key

---
 osu.Game/Database/RealmContextFactory.cs      | 30 ++++++++++++++++++-
 .../Bindings/DatabasedKeyBindingContainer.cs  | 25 +++++++---------
 osu.Game/Input/Bindings/RealmKeyBinding.cs    |  6 ++--
 osu.Game/Input/RealmKeyBindingStore.cs        | 10 +++----
 .../Settings/Sections/Input/KeyBindingRow.cs  |  2 +-
 .../Sections/Input/KeyBindingsSubsection.cs   |  4 +--
 osu.Game/Overlays/Toolbar/ToolbarButton.cs    |  2 +-
 7 files changed, 53 insertions(+), 26 deletions(-)

diff --git a/osu.Game/Database/RealmContextFactory.cs b/osu.Game/Database/RealmContextFactory.cs
index 70ea24b581..2a2c94ee7d 100644
--- a/osu.Game/Database/RealmContextFactory.cs
+++ b/osu.Game/Database/RealmContextFactory.cs
@@ -42,8 +42,9 @@ namespace osu.Game.Database
         /// 8    2021-10-29    Rebind scroll adjust keys to not have control modifier.
         /// 9    2021-11-04    Converted BeatmapMetadata.Author from string to RealmUser.
         /// 10   2021-11-22    Use ShortName instead of RulesetID for ruleset settings.
+        /// 11   2021-11-22    Use ShortName instead of RulesetID for ruleset key bindings.
         /// </summary>
-        private const int schema_version = 10;
+        private const int schema_version = 11;
 
         /// <summary>
         /// Lock object which is held during <see cref="BlockAllOperations"/> sections, blocking context creation during blocking periods.
@@ -260,6 +261,33 @@ namespace osu.Game.Database
                             newItem.RulesetName = rulesetName;
                     }
 
+                    break;
+
+                case 11:
+
+                    string keyBindingClassName = getMappedOrOriginalName(typeof(RealmKeyBinding));
+
+                    var oldKeyBindings = migration.OldRealm.DynamicApi.All(keyBindingClassName);
+                    var newKeyBindings = migration.NewRealm.All<RealmKeyBinding>().ToList();
+
+                    for (int i = 0; i < newKeyBindings.Count; i++)
+                    {
+                        dynamic? oldItem = oldKeyBindings.ElementAt(i);
+                        var newItem = newKeyBindings.ElementAt(i);
+
+                        if (oldItem.RulesetID == null)
+                            continue;
+
+                        long rulesetId = oldItem.RulesetID;
+
+                        string? rulesetName = rulesets?.GetRuleset((int)rulesetId)?.ShortName;
+
+                        if (string.IsNullOrEmpty(rulesetName))
+                            migration.NewRealm.Remove(newItem);
+                        else
+                            newItem.RulesetName = rulesetName;
+                    }
+
                     break;
             }
         }
diff --git a/osu.Game/Input/Bindings/DatabasedKeyBindingContainer.cs b/osu.Game/Input/Bindings/DatabasedKeyBindingContainer.cs
index 5dced23614..baa5b9ff9c 100644
--- a/osu.Game/Input/Bindings/DatabasedKeyBindingContainer.cs
+++ b/osu.Game/Input/Bindings/DatabasedKeyBindingContainer.cs
@@ -50,23 +50,20 @@ namespace osu.Game.Input.Bindings
 
         protected override void LoadComplete()
         {
-            if (ruleset == null || ruleset.ID.HasValue)
-            {
-                int? rulesetId = ruleset?.ID;
+            string rulesetName = ruleset?.ShortName;
 
-                realmKeyBindings = realmFactory.Context.All<RealmKeyBinding>()
-                                               .Where(b => b.RulesetID == rulesetId && b.Variant == variant);
+            realmKeyBindings = realmFactory.Context.All<RealmKeyBinding>()
+                                           .Where(b => b.RulesetName == rulesetName && b.Variant == variant);
 
-                realmSubscription = realmKeyBindings
-                    .SubscribeForNotifications((sender, changes, error) =>
-                    {
-                        // first subscription ignored as we are handling this in LoadComplete.
-                        if (changes == null)
-                            return;
+            realmSubscription = realmKeyBindings
+                .SubscribeForNotifications((sender, changes, error) =>
+                {
+                    // first subscription ignored as we are handling this in LoadComplete.
+                    if (changes == null)
+                        return;
 
-                        ReloadMappings();
-                    });
-            }
+                    ReloadMappings();
+                });
 
             base.LoadComplete();
         }
diff --git a/osu.Game/Input/Bindings/RealmKeyBinding.cs b/osu.Game/Input/Bindings/RealmKeyBinding.cs
index 334d2da427..6a408847fe 100644
--- a/osu.Game/Input/Bindings/RealmKeyBinding.cs
+++ b/osu.Game/Input/Bindings/RealmKeyBinding.cs
@@ -6,6 +6,8 @@ using osu.Framework.Input.Bindings;
 using osu.Game.Database;
 using Realms;
 
+#nullable enable
+
 namespace osu.Game.Input.Bindings
 {
     [MapTo(nameof(KeyBinding))]
@@ -14,7 +16,7 @@ namespace osu.Game.Input.Bindings
         [PrimaryKey]
         public Guid ID { get; set; } = Guid.NewGuid();
 
-        public int? RulesetID { get; set; }
+        public string? RulesetName { get; set; }
 
         public int? Variant { get; set; }
 
@@ -34,6 +36,6 @@ namespace osu.Game.Input.Bindings
         public int ActionInt { get; set; }
 
         [MapTo(nameof(KeyCombination))]
-        public string KeyCombinationString { get; set; }
+        public string KeyCombinationString { get; set; } = string.Empty;
     }
 }
diff --git a/osu.Game/Input/RealmKeyBindingStore.cs b/osu.Game/Input/RealmKeyBindingStore.cs
index 046969579c..3bdb0a180d 100644
--- a/osu.Game/Input/RealmKeyBindingStore.cs
+++ b/osu.Game/Input/RealmKeyBindingStore.cs
@@ -36,7 +36,7 @@ namespace osu.Game.Input
 
             using (var context = realmFactory.CreateContext())
             {
-                foreach (var action in context.All<RealmKeyBinding>().Where(b => b.RulesetID == null && (GlobalAction)b.ActionInt == globalAction))
+                foreach (var action in context.All<RealmKeyBinding>().Where(b => string.IsNullOrEmpty(b.RulesetName) && (GlobalAction)b.ActionInt == globalAction))
                 {
                     string str = keyCombinationProvider.GetReadableString(action.KeyCombination);
 
@@ -69,20 +69,20 @@ namespace osu.Game.Input
                 {
                     var instance = ruleset.CreateInstance();
                     foreach (int variant in instance.AvailableVariants)
-                        insertDefaults(realm, existingBindings, instance.GetDefaultKeyBindings(variant), ruleset.ID, variant);
+                        insertDefaults(realm, existingBindings, instance.GetDefaultKeyBindings(variant), ruleset.ShortName, variant);
                 }
 
                 transaction.Commit();
             }
         }
 
-        private void insertDefaults(Realm realm, List<RealmKeyBinding> existingBindings, IEnumerable<IKeyBinding> defaults, int? rulesetId = null, int? variant = null)
+        private void insertDefaults(Realm realm, List<RealmKeyBinding> existingBindings, IEnumerable<IKeyBinding> defaults, string? rulesetName = null, int? variant = null)
         {
             // compare counts in database vs defaults for each action type.
             foreach (var defaultsForAction in defaults.GroupBy(k => k.Action))
             {
                 // avoid performing redundant queries when the database is empty and needs to be re-filled.
-                int existingCount = existingBindings.Count(k => k.RulesetID == rulesetId && k.Variant == variant && k.ActionInt == (int)defaultsForAction.Key);
+                int existingCount = existingBindings.Count(k => k.RulesetName == rulesetName && k.Variant == variant && k.ActionInt == (int)defaultsForAction.Key);
 
                 if (defaultsForAction.Count() <= existingCount)
                     continue;
@@ -92,7 +92,7 @@ namespace osu.Game.Input
                 {
                     KeyCombinationString = k.KeyCombination.ToString(),
                     ActionInt = (int)k.Action,
-                    RulesetID = rulesetId,
+                    RulesetName = rulesetName,
                     Variant = variant
                 }));
             }
diff --git a/osu.Game/Overlays/Settings/Sections/Input/KeyBindingRow.cs b/osu.Game/Overlays/Settings/Sections/Input/KeyBindingRow.cs
index 96a685a9c5..e0a1a82326 100644
--- a/osu.Game/Overlays/Settings/Sections/Input/KeyBindingRow.cs
+++ b/osu.Game/Overlays/Settings/Sections/Input/KeyBindingRow.cs
@@ -524,7 +524,7 @@ namespace osu.Game.Overlays.Settings.Sections.Input
 
             public void UpdateKeyCombination(KeyCombination newCombination)
             {
-                if (KeyBinding.RulesetID != null && !RealmKeyBindingStore.CheckValidForGameplay(newCombination))
+                if (KeyBinding.RulesetName != null && !RealmKeyBindingStore.CheckValidForGameplay(newCombination))
                     return;
 
                 KeyBinding.KeyCombination = newCombination;
diff --git a/osu.Game/Overlays/Settings/Sections/Input/KeyBindingsSubsection.cs b/osu.Game/Overlays/Settings/Sections/Input/KeyBindingsSubsection.cs
index be0830a7c2..115a7bdc79 100644
--- a/osu.Game/Overlays/Settings/Sections/Input/KeyBindingsSubsection.cs
+++ b/osu.Game/Overlays/Settings/Sections/Input/KeyBindingsSubsection.cs
@@ -32,12 +32,12 @@ namespace osu.Game.Overlays.Settings.Sections.Input
         [BackgroundDependencyLoader]
         private void load(RealmContextFactory realmFactory)
         {
-            int? rulesetId = Ruleset?.ID;
+            string rulesetName = Ruleset?.ShortName;
 
             List<RealmKeyBinding> bindings;
 
             using (var realm = realmFactory.CreateContext())
-                bindings = realm.All<RealmKeyBinding>().Where(b => b.RulesetID == rulesetId && b.Variant == variant).Detach();
+                bindings = realm.All<RealmKeyBinding>().Where(b => b.RulesetName == rulesetName && b.Variant == variant).Detach();
 
             foreach (var defaultGroup in Defaults.GroupBy(d => d.Action))
             {
diff --git a/osu.Game/Overlays/Toolbar/ToolbarButton.cs b/osu.Game/Overlays/Toolbar/ToolbarButton.cs
index b2252a5575..75bebfa763 100644
--- a/osu.Game/Overlays/Toolbar/ToolbarButton.cs
+++ b/osu.Game/Overlays/Toolbar/ToolbarButton.cs
@@ -207,7 +207,7 @@ namespace osu.Game.Overlays.Toolbar
         {
             if (Hotkey == null) return;
 
-            var realmKeyBinding = realmFactory.Context.All<RealmKeyBinding>().FirstOrDefault(rkb => rkb.RulesetID == null && rkb.ActionInt == (int)Hotkey.Value);
+            var realmKeyBinding = realmFactory.Context.All<RealmKeyBinding>().FirstOrDefault(rkb => rkb.RulesetName == null && rkb.ActionInt == (int)Hotkey.Value);
 
             if (realmKeyBinding != null)
             {

From 6c36770eb388fe80f079b6001e7f4899bc1f20c9 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 22 Nov 2021 21:41:09 +0900
Subject: [PATCH 1175/5547] Add back allowance for tests scenes using empty
 `ShortName`

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

diff --git a/osu.Game/Rulesets/Ruleset.cs b/osu.Game/Rulesets/Ruleset.cs
index a252bd4786..31ebcfd600 100644
--- a/osu.Game/Rulesets/Ruleset.cs
+++ b/osu.Game/Rulesets/Ruleset.cs
@@ -49,6 +49,10 @@ namespace osu.Game.Rulesets
         {
             get
             {
+                // Is the case for many test usages.
+                if (string.IsNullOrEmpty(ShortName))
+                    return CreateAllMods();
+
                 if (!mod_reference_cache.TryGetValue(ShortName, out var mods))
                     mod_reference_cache[ShortName] = mods = CreateAllMods().Cast<IMod>().ToArray();
 

From 2350806b4cc8fbe23ee21288e5c75d16407133a9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 22 Nov 2021 20:26:45 +0100
Subject: [PATCH 1176/5547] Add failing test case for number box stack overflow
 scenario

---
 .../Settings/TestSceneSettingsNumberBox.cs    | 25 +++++++++++++++++++
 1 file changed, 25 insertions(+)
 create mode 100644 osu.Game.Tests/Visual/Settings/TestSceneSettingsNumberBox.cs

diff --git a/osu.Game.Tests/Visual/Settings/TestSceneSettingsNumberBox.cs b/osu.Game.Tests/Visual/Settings/TestSceneSettingsNumberBox.cs
new file mode 100644
index 0000000000..ffa1200f32
--- /dev/null
+++ b/osu.Game.Tests/Visual/Settings/TestSceneSettingsNumberBox.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 System.Linq;
+using NUnit.Framework;
+using osu.Framework.Testing;
+using osu.Game.Graphics.UserInterface;
+using osu.Game.Overlays.Settings;
+
+namespace osu.Game.Tests.Visual.Settings
+{
+    public class TestSceneSettingsNumberBox : OsuTestScene
+    {
+        [Test]
+        public void TestLargeInteger()
+        {
+            SettingsNumberBox numberBox = null;
+
+            AddStep("create number box", () => Child = numberBox = new SettingsNumberBox());
+
+            AddStep("set value to 1,000,000,000", () => numberBox.Current.Value = 1_000_000_000);
+            AddAssert("text box text is correct", () => numberBox.ChildrenOfType<OsuTextBox>().Single().Current.Value == "1000000000");
+        }
+    }
+}

From dced6a2e682a9902f43e1901e2ae1912bb637016 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 22 Nov 2021 20:39:44 +0100
Subject: [PATCH 1177/5547] Add extended test coverage for desired input
 handling

---
 .../Settings/TestSceneSettingsNumberBox.cs    | 65 +++++++++++++++++--
 1 file changed, 59 insertions(+), 6 deletions(-)

diff --git a/osu.Game.Tests/Visual/Settings/TestSceneSettingsNumberBox.cs b/osu.Game.Tests/Visual/Settings/TestSceneSettingsNumberBox.cs
index ffa1200f32..c063e5526a 100644
--- a/osu.Game.Tests/Visual/Settings/TestSceneSettingsNumberBox.cs
+++ b/osu.Game.Tests/Visual/Settings/TestSceneSettingsNumberBox.cs
@@ -11,15 +11,68 @@ namespace osu.Game.Tests.Visual.Settings
 {
     public class TestSceneSettingsNumberBox : OsuTestScene
     {
+        private SettingsNumberBox numberBox;
+        private OsuTextBox textBox;
+
+        [SetUpSteps]
+        public void SetUpSteps()
+        {
+            AddStep("create number box", () => Child = numberBox = new SettingsNumberBox());
+            AddStep("get inner text box", () => textBox = numberBox.ChildrenOfType<OsuTextBox>().Single());
+        }
+
         [Test]
         public void TestLargeInteger()
         {
-            SettingsNumberBox numberBox = null;
-
-            AddStep("create number box", () => Child = numberBox = new SettingsNumberBox());
-
-            AddStep("set value to 1,000,000,000", () => numberBox.Current.Value = 1_000_000_000);
-            AddAssert("text box text is correct", () => numberBox.ChildrenOfType<OsuTextBox>().Single().Current.Value == "1000000000");
+            AddStep("set current to 1,000,000,000", () => numberBox.Current.Value = 1_000_000_000);
+            AddAssert("text box text is correct", () => textBox.Text == "1000000000");
         }
+
+        [Test]
+        public void TestUserInput()
+        {
+            inputText("42");
+            currentValueIs(42);
+            currentTextIs("42");
+
+            inputText(string.Empty);
+            currentValueIs(null);
+            currentTextIs(string.Empty);
+
+            inputText("555");
+            currentValueIs(555);
+            currentTextIs("555");
+
+            inputText("-4444");
+            // attempting to input the minus will raise an input error, the rest will pass through fine.
+            currentValueIs(4444);
+            currentTextIs("4444");
+
+            // checking the upper bound.
+            inputText(int.MaxValue.ToString());
+            currentValueIs(int.MaxValue);
+            currentTextIs(int.MaxValue.ToString());
+
+            inputText((long)int.MaxValue + 1.ToString());
+            currentValueIs(int.MaxValue);
+            currentTextIs(int.MaxValue.ToString());
+
+            inputText("0");
+            currentValueIs(0);
+            currentTextIs("0");
+
+            // checking that leading zeroes are stripped.
+            inputText("00");
+            currentValueIs(0);
+            currentTextIs("0");
+
+            inputText("01");
+            currentValueIs(1);
+            currentTextIs("1");
+        }
+
+        private void inputText(string text) => AddStep($"set textbox text to {text}", () => textBox.Text = text);
+        private void currentValueIs(int? value) => AddAssert($"current value is {value?.ToString() ?? "null"}", () => numberBox.Current.Value == value);
+        private void currentTextIs(string value) => AddAssert($"current text is {value}", () => textBox.Text == value);
     }
 }

From 4a9f080f3c0c227ff17ab5b4dc1744d4c433e354 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 22 Nov 2021 20:41:27 +0100
Subject: [PATCH 1178/5547] Accept full range of `int` in `SettingsNumberBox`

This fixes stack overflow exceptions that would arise when a
`Current.Value` of 1 billion or more was set on a `SettingsNumberBox`.
The stack overflow was caused by the "maximum 9 digits" spec. If a value
technically within `int` bounds, but larger than 1 billion (in the range
[1,000,000,000; 2,147,483,647], to be more precise), a feedback loop
between the setting control's `Current` and its inner text box's
`Current` would occur, wherein the last digit would be trimmed and then
re-appended again forevermore.

To resolve, remove the offending spec and rely on `int.TryParse`
entirely to be able to discern overflow range. Additionally, UX of the
text box is slightly changed to notify when the `int` range is exceeded
with a red flash.

This behaviour would not have been possible to implement without recent
framework-side fixes to text box (removal of text set scheduling).
---
 osu.Game/Overlays/Settings/SettingsNumberBox.cs | 16 ++++++++++++----
 1 file changed, 12 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Overlays/Settings/SettingsNumberBox.cs b/osu.Game/Overlays/Settings/SettingsNumberBox.cs
index 545f1050b2..cbe9f7fc64 100644
--- a/osu.Game/Overlays/Settings/SettingsNumberBox.cs
+++ b/osu.Game/Overlays/Settings/SettingsNumberBox.cs
@@ -35,7 +35,6 @@ namespace osu.Game.Overlays.Settings
                 {
                     numberBox = new OutlinedNumberBox
                     {
-                        LengthLimit = 9, // limited to less than a value that could overflow int32 backing.
                         Margin = new MarginPadding { Top = 5 },
                         RelativeSizeAxes = Axes.X,
                         CommitOnFocusLost = true
@@ -44,12 +43,19 @@ namespace osu.Game.Overlays.Settings
 
                 numberBox.Current.BindValueChanged(e =>
                 {
-                    int? value = null;
+                    if (string.IsNullOrEmpty(e.NewValue))
+                    {
+                        Current.Value = null;
+                        return;
+                    }
 
                     if (int.TryParse(e.NewValue, out int intVal))
-                        value = intVal;
+                        Current.Value = intVal;
+                    else
+                        numberBox.NotifyInputError();
 
-                    current.Value = value;
+                    // trigger Current again to either restore the previous text box value, or to reformat the new value via .ToString().
+                    Current.TriggerChange();
                 });
 
                 Current.BindValueChanged(e =>
@@ -62,6 +68,8 @@ namespace osu.Game.Overlays.Settings
         private class OutlinedNumberBox : OutlinedTextBox
         {
             protected override bool CanAddCharacter(char character) => char.IsNumber(character);
+
+            public new void NotifyInputError() => base.NotifyInputError();
         }
     }
 }

From 1f321e29107559f3e099ea9acf9f79988be94dd0 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 23 Nov 2021 11:48:56 +0900
Subject: [PATCH 1179/5547] Run EF migrations earlier to ensure it is complete
 before usage

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

diff --git a/osu.Game/OsuGameBase.cs b/osu.Game/OsuGameBase.cs
index d8050353c5..a2dd417491 100644
--- a/osu.Game/OsuGameBase.cs
+++ b/osu.Game/OsuGameBase.cs
@@ -187,6 +187,9 @@ namespace osu.Game
             Resources.AddStore(new DllResourceStore(OsuResources.ResourceAssembly));
 
             dependencies.Cache(contextFactory = new DatabaseContextFactory(Storage));
+
+            runMigrations();
+
             dependencies.Cache(RulesetStore = new RulesetStore(contextFactory, Storage));
 
             dependencies.Cache(realmFactory = new RealmContextFactory(Storage, "client", RulesetStore));
@@ -204,8 +207,6 @@ namespace osu.Game
 
             Audio.Samples.PlaybackConcurrency = SAMPLE_CONCURRENCY;
 
-            runMigrations();
-
             dependencies.Cache(SkinManager = new SkinManager(Storage, contextFactory, Host, Resources, Audio));
             dependencies.CacheAs<ISkinSource>(SkinManager);
 

From feb983d5bdb876ef9f0ac61a7985ab38f2b1b4ce Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 23 Nov 2021 13:09:41 +0900
Subject: [PATCH 1180/5547] Rename `Debug` namespace to avoid collisions

---
 osu.Game/Overlays/Settings/Sections/DebugSection.cs             | 2 +-
 .../Sections/{Debug => DebugSettings}/GeneralSettings.cs        | 2 +-
 .../Sections/{Debug => DebugSettings}/MemorySettings.cs         | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)
 rename osu.Game/Overlays/Settings/Sections/{Debug => DebugSettings}/GeneralSettings.cs (96%)
 rename osu.Game/Overlays/Settings/Sections/{Debug => DebugSettings}/MemorySettings.cs (93%)

diff --git a/osu.Game/Overlays/Settings/Sections/DebugSection.cs b/osu.Game/Overlays/Settings/Sections/DebugSection.cs
index aa85ec920c..2e23d8a22a 100644
--- a/osu.Game/Overlays/Settings/Sections/DebugSection.cs
+++ b/osu.Game/Overlays/Settings/Sections/DebugSection.cs
@@ -5,7 +5,7 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Localisation;
 using osu.Game.Localisation;
-using osu.Game.Overlays.Settings.Sections.Debug;
+using osu.Game.Overlays.Settings.Sections.DebugSettings;
 
 namespace osu.Game.Overlays.Settings.Sections
 {
diff --git a/osu.Game/Overlays/Settings/Sections/Debug/GeneralSettings.cs b/osu.Game/Overlays/Settings/Sections/DebugSettings/GeneralSettings.cs
similarity index 96%
rename from osu.Game/Overlays/Settings/Sections/Debug/GeneralSettings.cs
rename to osu.Game/Overlays/Settings/Sections/DebugSettings/GeneralSettings.cs
index 25e20911b8..60540a089e 100644
--- a/osu.Game/Overlays/Settings/Sections/Debug/GeneralSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/DebugSettings/GeneralSettings.cs
@@ -9,7 +9,7 @@ using osu.Framework.Screens;
 using osu.Game.Localisation;
 using osu.Game.Screens.Import;
 
-namespace osu.Game.Overlays.Settings.Sections.Debug
+namespace osu.Game.Overlays.Settings.Sections.DebugSettings
 {
     public class GeneralSettings : SettingsSubsection
     {
diff --git a/osu.Game/Overlays/Settings/Sections/Debug/MemorySettings.cs b/osu.Game/Overlays/Settings/Sections/DebugSettings/MemorySettings.cs
similarity index 93%
rename from osu.Game/Overlays/Settings/Sections/Debug/MemorySettings.cs
rename to osu.Game/Overlays/Settings/Sections/DebugSettings/MemorySettings.cs
index 07fb0aca5a..6f48768dcd 100644
--- a/osu.Game/Overlays/Settings/Sections/Debug/MemorySettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/DebugSettings/MemorySettings.cs
@@ -8,7 +8,7 @@ using osu.Framework.Localisation;
 using osu.Framework.Platform;
 using osu.Game.Localisation;
 
-namespace osu.Game.Overlays.Settings.Sections.Debug
+namespace osu.Game.Overlays.Settings.Sections.DebugSettings
 {
     public class MemorySettings : SettingsSubsection
     {

From 10bd7176e015f63e4bf2dfa829db66ce6d4a71f4 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 23 Nov 2021 14:06:06 +0900
Subject: [PATCH 1181/5547] Fix potential test failure in
 TestSceneMultiplayerReadyButton

Couldn't exactly reproduce https://github.com/ppy/osu/runs/4294316800,
but I found a similar issue via:

```diff
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs
index 84b63a5733..29cac9b061 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs
@@ -3,6 +3,7 @@

 using System;
 using System.Linq;
+using System.Threading;
 using System.Threading.Tasks;
 using NUnit.Framework;
 using osu.Framework.Allocation;
@@ -81,6 +82,8 @@ private void load(GameHost host, AudioManager audio)

                         await Client.ToggleReady();

+                        Thread.Sleep(1000);
+
                         readyClickOperation.Dispose();
                     });
                 }
```
---
 .../Multiplayer/TestSceneMultiplayerReadyButton.cs  | 13 +++++++++----
 1 file changed, 9 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs
index e9612bf55c..84b63a5733 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs
@@ -9,6 +9,7 @@ using osu.Framework.Allocation;
 using osu.Framework.Audio;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
+using osu.Framework.Graphics.UserInterface;
 using osu.Framework.Platform;
 using osu.Framework.Testing;
 using osu.Framework.Utils;
@@ -198,11 +199,15 @@ namespace osu.Game.Tests.Visual.Multiplayer
             }, users);
         }
 
-        private void addClickButtonStep() => AddStep("click button", () =>
+        private void addClickButtonStep()
         {
-            InputManager.MoveMouseTo(button);
-            InputManager.Click(MouseButton.Left);
-        });
+            AddUntilStep("wait for button to be ready", () => button.ChildrenOfType<Button>().Single().Enabled.Value);
+            AddStep("click button", () =>
+            {
+                InputManager.MoveMouseTo(button);
+                InputManager.Click(MouseButton.Left);
+            });
+        }
 
         private void verifyGameplayStartFlow()
         {

From 49e2a8afa3f345ec4dc12b8dc99ec546a3b06e6c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 23 Nov 2021 14:08:03 +0900
Subject: [PATCH 1182/5547] Don't directly reset the database when running
 tests

The containing storage is destroyed anyway, so this is redundant.
---
 osu.Game/Tests/Visual/OsuTestScene.cs | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/osu.Game/Tests/Visual/OsuTestScene.cs b/osu.Game/Tests/Visual/OsuTestScene.cs
index fc7bc324ca..2bacfcebca 100644
--- a/osu.Game/Tests/Visual/OsuTestScene.cs
+++ b/osu.Game/Tests/Visual/OsuTestScene.cs
@@ -90,11 +90,6 @@ namespace osu.Game.Tests.Visual
             {
                 var factory = new DatabaseContextFactory(LocalStorage);
 
-                // only reset the database if not using the host storage.
-                // if we reset the host storage, it will delete global key bindings.
-                if (isolatedHostStorage == null)
-                    factory.ResetDatabase();
-
                 using (var usage = factory.Get())
                     usage.Migrate();
                 return factory;

From 5631e75f16073892a81b1c4e6af5959049ee2b0c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 23 Nov 2021 14:11:27 +0900
Subject: [PATCH 1183/5547] Restructure how the headless storage is used /
 documented to hopefully make more sense

---
 osu.Game/Tests/Visual/OsuTestScene.cs | 15 +++++++++++----
 1 file changed, 11 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Tests/Visual/OsuTestScene.cs b/osu.Game/Tests/Visual/OsuTestScene.cs
index 2bacfcebca..cb4af67839 100644
--- a/osu.Game/Tests/Visual/OsuTestScene.cs
+++ b/osu.Game/Tests/Visual/OsuTestScene.cs
@@ -81,8 +81,7 @@ namespace osu.Game.Tests.Visual
 
         protected override IReadOnlyDependencyContainer CreateChildDependencies(IReadOnlyDependencyContainer parent)
         {
-            if (!UseFreshStoragePerRun)
-                isolatedHostStorage = (parent.Get<GameHost>() as HeadlessGameHost)?.Storage;
+            isolatedHostStorage = (parent.Get<GameHost>() as HeadlessGameHost)?.Storage;
 
             Resources = parent.Get<OsuGameBase>().Resources;
 
@@ -149,8 +148,16 @@ namespace osu.Game.Tests.Visual
                 }
             }
 
-            localStorage =
-                new Lazy<Storage>(() => isolatedHostStorage ?? new TemporaryNativeStorage($"{GetType().Name}-{Guid.NewGuid()}"));
+            localStorage = new Lazy<Storage>(() =>
+            {
+                // When running headless, there is an opportunity to use the host storage rather than creating a second isolated one.
+                // This is because the host is recycled per TestScene execution in headless at an nunit level.
+                // Importantly, we can't use this optimisation when `UseFreshStoragePerRun` is true, as it doesn't reset per test method.
+                if (!UseFreshStoragePerRun && isolatedHostStorage != null)
+                    return isolatedHostStorage;
+
+                return new TemporaryNativeStorage($"{GetType().Name}-{Guid.NewGuid()}");
+            });
         }
 
         [Resolved]

From 55f7d120e6325c0b003bcdb6373e31cae384149f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 23 Nov 2021 14:11:44 +0900
Subject: [PATCH 1184/5547] Rename and reorder fields in `OsuTestScene`

---
 osu.Game/Tests/Visual/OsuTestScene.cs | 34 +++++++++++++--------------
 1 file changed, 17 insertions(+), 17 deletions(-)

diff --git a/osu.Game/Tests/Visual/OsuTestScene.cs b/osu.Game/Tests/Visual/OsuTestScene.cs
index cb4af67839..ca7b7b27b0 100644
--- a/osu.Game/Tests/Visual/OsuTestScene.cs
+++ b/osu.Game/Tests/Visual/OsuTestScene.cs
@@ -43,13 +43,6 @@ namespace osu.Game.Tests.Visual
 
         protected new OsuScreenDependencies Dependencies { get; private set; }
 
-        private DrawableRulesetDependencies rulesetDependencies;
-
-        private Lazy<Storage> localStorage;
-        protected Storage LocalStorage => localStorage.Value;
-
-        private Lazy<DatabaseContextFactory> contextFactory;
-
         protected IResourceStore<byte[]> Resources;
 
         protected IAPIProvider API
@@ -65,23 +58,32 @@ namespace osu.Game.Tests.Visual
 
         private DummyAPIAccess dummyAPI;
 
-        protected DatabaseContextFactory ContextFactory => contextFactory.Value;
-
         /// <summary>
         /// Whether this test scene requires real-world API access.
         /// If true, this will bypass the local <see cref="DummyAPIAccess"/> and use the <see cref="OsuGameBase"/> provided one.
         /// </summary>
         protected virtual bool UseOnlineAPI => false;
 
+        protected DatabaseContextFactory ContextFactory => contextFactory.Value;
+
+        private Lazy<DatabaseContextFactory> contextFactory;
+
+        protected virtual bool UseFreshStoragePerRun => false;
+
         /// <summary>
-        /// When running headless, there is an opportunity to use the host storage rather than creating a second isolated one.
-        /// This is because the host is recycled per TestScene execution in headless at an nunit level.
+        /// A storage to be used by test runs. Can be isolated by setting <see cref="UseFreshStoragePerRun"/> to <c>true</c>.
         /// </summary>
-        private Storage isolatedHostStorage;
+        protected Storage LocalStorage => localStorage.Value;
+
+        private Lazy<Storage> localStorage;
+
+        private Storage headlessHostStorage;
+
+        private DrawableRulesetDependencies rulesetDependencies;
 
         protected override IReadOnlyDependencyContainer CreateChildDependencies(IReadOnlyDependencyContainer parent)
         {
-            isolatedHostStorage = (parent.Get<GameHost>() as HeadlessGameHost)?.Storage;
+            headlessHostStorage = (parent.Get<GameHost>() as HeadlessGameHost)?.Storage;
 
             Resources = parent.Get<OsuGameBase>().Resources;
 
@@ -132,8 +134,6 @@ namespace osu.Game.Tests.Visual
             base.Content.Add(content = new DrawSizePreservingFillContainer());
         }
 
-        protected virtual bool UseFreshStoragePerRun => false;
-
         public virtual void RecycleLocalStorage(bool isDisposing)
         {
             if (localStorage?.IsValueCreated == true)
@@ -153,8 +153,8 @@ namespace osu.Game.Tests.Visual
                 // When running headless, there is an opportunity to use the host storage rather than creating a second isolated one.
                 // This is because the host is recycled per TestScene execution in headless at an nunit level.
                 // Importantly, we can't use this optimisation when `UseFreshStoragePerRun` is true, as it doesn't reset per test method.
-                if (!UseFreshStoragePerRun && isolatedHostStorage != null)
-                    return isolatedHostStorage;
+                if (!UseFreshStoragePerRun && headlessHostStorage != null)
+                    return headlessHostStorage;
 
                 return new TemporaryNativeStorage($"{GetType().Name}-{Guid.NewGuid()}");
             });

From 473f6b0347dac2494172f21d701e341ed7332954 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 23 Nov 2021 14:14:53 +0900
Subject: [PATCH 1185/5547] Add more xmldoc

---
 osu.Game/Tests/Visual/OsuTestScene.cs | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/osu.Game/Tests/Visual/OsuTestScene.cs b/osu.Game/Tests/Visual/OsuTestScene.cs
index ca7b7b27b0..eedf266bbe 100644
--- a/osu.Game/Tests/Visual/OsuTestScene.cs
+++ b/osu.Game/Tests/Visual/OsuTestScene.cs
@@ -64,15 +64,32 @@ namespace osu.Game.Tests.Visual
         /// </summary>
         protected virtual bool UseOnlineAPI => false;
 
+        /// <summary>
+        /// A database context factory to be used by test runs. Can be isolated and reset by setting <see cref="UseFreshStoragePerRun"/> to <c>true</c>.
+        /// </summary>
+        /// <remarks>
+        /// In interactive runs (ie. VisualTests) this will use the user's database if <see cref="UseFreshStoragePerRun"/> is not set to <c>true</c>.
+        /// </remarks>
         protected DatabaseContextFactory ContextFactory => contextFactory.Value;
 
         private Lazy<DatabaseContextFactory> contextFactory;
 
+        /// <summary>
+        /// Whether a fresh storage should be initialised per test (method) run.
+        /// </summary>
+        /// <remarks>
+        /// By default (ie. if not set to <c>true</c>):
+        /// - in interactive runs, the user's storage will be used
+        /// - in headless runs, a shared temporary storage will be used per test class.
+        /// </remarks>
         protected virtual bool UseFreshStoragePerRun => false;
 
         /// <summary>
         /// A storage to be used by test runs. Can be isolated by setting <see cref="UseFreshStoragePerRun"/> to <c>true</c>.
         /// </summary>
+        /// <remarks>
+        /// In interactive runs (ie. VisualTests) this will use the user's storage if <see cref="UseFreshStoragePerRun"/> is not set to <c>true</c>.
+        /// </remarks>
         protected Storage LocalStorage => localStorage.Value;
 
         private Lazy<Storage> localStorage;

From 4624977b7709876eb92a11552982a4877abafdce Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 23 Nov 2021 14:38:37 +0900
Subject: [PATCH 1186/5547] Fix tournament tests potentially using data left
 over from previous runs

---
 .../NonVisual/CustomTourneyDirectoryTest.cs   | 36 ++++++++++++++-----
 .../NonVisual/IPCLocationTest.cs              | 13 +++++--
 .../NonVisual/TournamentHostTest.cs           |  2 +-
 3 files changed, 39 insertions(+), 12 deletions(-)

diff --git a/osu.Game.Tournament.Tests/NonVisual/CustomTourneyDirectoryTest.cs b/osu.Game.Tournament.Tests/NonVisual/CustomTourneyDirectoryTest.cs
index fcc9f44f0c..94472a8bc7 100644
--- a/osu.Game.Tournament.Tests/NonVisual/CustomTourneyDirectoryTest.cs
+++ b/osu.Game.Tournament.Tests/NonVisual/CustomTourneyDirectoryTest.cs
@@ -38,7 +38,7 @@ namespace osu.Game.Tournament.Tests.NonVisual
         {
             using (HeadlessGameHost host = new HeadlessGameHost(nameof(TestCustomDirectory))) // don't use clean run as we are writing a config file.
             {
-                string osuDesktopStorage = basePath(nameof(TestCustomDirectory));
+                string osuDesktopStorage = PrepareBasePath(nameof(TestCustomDirectory));
                 const string custom_tournament = "custom";
 
                 // need access before the game has constructed its own storage yet.
@@ -60,6 +60,15 @@ namespace osu.Game.Tournament.Tests.NonVisual
                 finally
                 {
                     host.Exit();
+
+                    try
+                    {
+                        if (Directory.Exists(osuDesktopStorage))
+                            Directory.Delete(osuDesktopStorage, true);
+                    }
+                    catch
+                    {
+                    }
                 }
             }
         }
@@ -69,7 +78,7 @@ namespace osu.Game.Tournament.Tests.NonVisual
         {
             using (HeadlessGameHost host = new HeadlessGameHost(nameof(TestMigration))) // don't use clean run as we are writing test files for migration.
             {
-                string osuRoot = basePath(nameof(TestMigration));
+                string osuRoot = PrepareBasePath(nameof(TestMigration));
                 string configFile = Path.Combine(osuRoot, "tournament.ini");
 
                 if (File.Exists(configFile))
@@ -136,18 +145,29 @@ namespace osu.Game.Tournament.Tests.NonVisual
                 }
                 finally
                 {
+                    host.Exit();
+
                     try
                     {
-                        host.Storage.Delete("tournament.ini");
-                        host.Storage.DeleteDirectory("tournaments");
+                        if (Directory.Exists(osuRoot))
+                            Directory.Delete(osuRoot, true);
+                    }
+                    catch
+                    {
                     }
-                    catch { }
-
-                    host.Exit();
                 }
             }
         }
 
-        private string basePath(string testInstance) => Path.Combine(RuntimeInfo.StartupDirectory, "headless", testInstance);
+        public static string PrepareBasePath(string testInstance)
+        {
+            string basePath = Path.Combine(RuntimeInfo.StartupDirectory, "headless", testInstance);
+
+            // manually clean before starting in case there are left-over files at the test site.
+            if (Directory.Exists(basePath))
+                Directory.Delete(basePath, true);
+
+            return basePath;
+        }
     }
 }
diff --git a/osu.Game.Tournament.Tests/NonVisual/IPCLocationTest.cs b/osu.Game.Tournament.Tests/NonVisual/IPCLocationTest.cs
index eaa009c180..22d9a4ff9d 100644
--- a/osu.Game.Tournament.Tests/NonVisual/IPCLocationTest.cs
+++ b/osu.Game.Tournament.Tests/NonVisual/IPCLocationTest.cs
@@ -20,7 +20,7 @@ namespace osu.Game.Tournament.Tests.NonVisual
             // don't use clean run because files are being written before osu! launches.
             using (HeadlessGameHost host = new HeadlessGameHost(nameof(CheckIPCLocation)))
             {
-                string basePath = Path.Combine(RuntimeInfo.StartupDirectory, "headless", nameof(CheckIPCLocation));
+                string basePath = CustomTourneyDirectoryTest.PrepareBasePath(nameof(CheckIPCLocation));
 
                 // Set up a fake IPC client for the IPC Storage to switch to.
                 string testStableInstallDirectory = Path.Combine(basePath, "stable-ce");
@@ -42,9 +42,16 @@ namespace osu.Game.Tournament.Tests.NonVisual
                 }
                 finally
                 {
-                    host.Storage.DeleteDirectory(testStableInstallDirectory);
-                    host.Storage.DeleteDirectory("tournaments");
                     host.Exit();
+
+                    try
+                    {
+                        if (Directory.Exists(basePath))
+                            Directory.Delete(basePath, true);
+                    }
+                    catch
+                    {
+                    }
                 }
             }
         }
diff --git a/osu.Game.Tournament.Tests/NonVisual/TournamentHostTest.cs b/osu.Game.Tournament.Tests/NonVisual/TournamentHostTest.cs
index 319a768e65..bf99f69b2a 100644
--- a/osu.Game.Tournament.Tests/NonVisual/TournamentHostTest.cs
+++ b/osu.Game.Tournament.Tests/NonVisual/TournamentHostTest.cs
@@ -20,7 +20,7 @@ namespace osu.Game.Tournament.Tests.NonVisual
             return tournament;
         }
 
-        public static void WaitForOrAssert(Func<bool> result, string failureMessage, int timeout = 90000)
+        public static void WaitForOrAssert(Func<bool> result, string failureMessage, int timeout = 30000)
         {
             Task task = Task.Run(() =>
             {

From b596a0204c5d4a48965812dbba173d3fa4729577 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 23 Nov 2021 06:43:17 +0100
Subject: [PATCH 1187/5547] Rewrite overflow test step for legibility

---
 .../Visual/Settings/TestSceneSettingsNumberBox.cs          | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/Settings/TestSceneSettingsNumberBox.cs b/osu.Game.Tests/Visual/Settings/TestSceneSettingsNumberBox.cs
index c063e5526a..334a814688 100644
--- a/osu.Game.Tests/Visual/Settings/TestSceneSettingsNumberBox.cs
+++ b/osu.Game.Tests/Visual/Settings/TestSceneSettingsNumberBox.cs
@@ -53,7 +53,7 @@ namespace osu.Game.Tests.Visual.Settings
             currentValueIs(int.MaxValue);
             currentTextIs(int.MaxValue.ToString());
 
-            inputText((long)int.MaxValue + 1.ToString());
+            inputText(smallestOverflowValue.ToString());
             currentValueIs(int.MaxValue);
             currentTextIs(int.MaxValue.ToString());
 
@@ -74,5 +74,10 @@ namespace osu.Game.Tests.Visual.Settings
         private void inputText(string text) => AddStep($"set textbox text to {text}", () => textBox.Text = text);
         private void currentValueIs(int? value) => AddAssert($"current value is {value?.ToString() ?? "null"}", () => numberBox.Current.Value == value);
         private void currentTextIs(string value) => AddAssert($"current text is {value}", () => textBox.Text == value);
+
+        /// <summary>
+        /// The smallest number that overflows <see langword="int"/>.
+        /// </summary>
+        private static long smallestOverflowValue => 1L + int.MaxValue;
     }
 }

From 6fb27577397056e76ac64be9b974b312a6be8ef3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 23 Nov 2021 14:58:18 +0900
Subject: [PATCH 1188/5547] Remove usage of `Nuget.Packaging` extension methods
 for `IList.AddRange`

---
 osu.Game/Extensions/CollectionExtensions.cs  | 22 ++++++++++++++++++++
 osu.Game/Stores/BeatmapImporter.cs           |  1 -
 osu.Game/Stores/RealmArchiveModelImporter.cs |  1 -
 3 files changed, 22 insertions(+), 2 deletions(-)
 create mode 100644 osu.Game/Extensions/CollectionExtensions.cs

diff --git a/osu.Game/Extensions/CollectionExtensions.cs b/osu.Game/Extensions/CollectionExtensions.cs
new file mode 100644
index 0000000000..473dc4b8f4
--- /dev/null
+++ b/osu.Game/Extensions/CollectionExtensions.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 System.Collections.Generic;
+
+namespace osu.Game.Extensions
+{
+    public static class CollectionExtensions
+    {
+        public static void AddRange<T>(this ICollection<T> collection, IEnumerable<T> items)
+        {
+            // List<T> has a potentially more optimal path to adding a range.
+            if (collection is List<T> list)
+                list.AddRange(items);
+            else
+            {
+                foreach (T obj in items)
+                    collection.Add(obj);
+            }
+        }
+    }
+}
diff --git a/osu.Game/Stores/BeatmapImporter.cs b/osu.Game/Stores/BeatmapImporter.cs
index dad2b29dd0..32f0cd3d7a 100644
--- a/osu.Game/Stores/BeatmapImporter.cs
+++ b/osu.Game/Stores/BeatmapImporter.cs
@@ -7,7 +7,6 @@ using System.IO;
 using System.Linq;
 using System.Threading;
 using System.Threading.Tasks;
-using NuGet.Packaging;
 using osu.Framework.Audio.Track;
 using osu.Framework.Extensions;
 using osu.Framework.Extensions.IEnumerableExtensions;
diff --git a/osu.Game/Stores/RealmArchiveModelImporter.cs b/osu.Game/Stores/RealmArchiveModelImporter.cs
index 5b8c73b218..6370d4ebe4 100644
--- a/osu.Game/Stores/RealmArchiveModelImporter.cs
+++ b/osu.Game/Stores/RealmArchiveModelImporter.cs
@@ -8,7 +8,6 @@ using System.Linq;
 using System.Threading;
 using System.Threading.Tasks;
 using Humanizer;
-using NuGet.Packaging;
 using osu.Framework.Extensions;
 using osu.Framework.Extensions.IEnumerableExtensions;
 using osu.Framework.Logging;

From a8c4fd694fcccd257f35ec07dd83d977c70f5ce3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 23 Nov 2021 15:04:44 +0900
Subject: [PATCH 1189/5547] Add `BannedSymbols` entry for `NuGet.Packaging`

---
 CodeAnalysis/BannedSymbols.txt | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/CodeAnalysis/BannedSymbols.txt b/CodeAnalysis/BannedSymbols.txt
index ea3e25142c..b72803482d 100644
--- a/CodeAnalysis/BannedSymbols.txt
+++ b/CodeAnalysis/BannedSymbols.txt
@@ -8,4 +8,5 @@ M:osu.Framework.Graphics.Sprites.SpriteText.#ctor;Use OsuSpriteText.
 M:osu.Framework.Bindables.IBindableList`1.GetBoundCopy();Fails on iOS. Use manual ctor + BindTo instead. (see https://github.com/mono/mono/issues/19900)
 T:Microsoft.EntityFrameworkCore.Internal.EnumerableExtensions;Don't use internal extension methods.
 T:Microsoft.EntityFrameworkCore.Internal.TypeExtensions;Don't use internal extension methods.
-M:System.Enum.HasFlag(System.Enum);Use osu.Framework.Extensions.EnumExtensions.HasFlagFast<T>() instead.
\ No newline at end of file
+T:NuGet.Packaging.CollectionExtensions;Don't use internal extension methods.
+M:System.Enum.HasFlag(System.Enum);Use osu.Framework.Extensions.EnumExtensions.HasFlagFast<T>() instead.

From 7906ae2b1dab8fd45b6b2fa0fb31a37c8fbf6756 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 23 Nov 2021 15:07:17 +0900
Subject: [PATCH 1190/5547] Update room immediately on join

---
 osu.Game/Online/Multiplayer/MultiplayerClient.cs | 12 +++++-------
 1 file changed, 5 insertions(+), 7 deletions(-)

diff --git a/osu.Game/Online/Multiplayer/MultiplayerClient.cs b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
index bd32687c5e..6b8bb7ecdf 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
@@ -160,11 +160,11 @@ namespace osu.Game.Online.Multiplayer
                     foreach (var user in joinedRoom.Users)
                         updateUserPlayingState(user.UserID, user.State);
 
+                    updateLocalRoomSettings(joinedRoom.Settings);
+
                     OnRoomJoined();
                 }, cancellationSource.Token).ConfigureAwait(false);
 
-                // Update room settings.
-                await updateLocalRoomSettings(joinedRoom.Settings, cancellationSource.Token).ConfigureAwait(false);
             }, cancellationSource.Token).ConfigureAwait(false);
         }
 
@@ -447,8 +447,7 @@ namespace osu.Game.Online.Multiplayer
 
         Task IMultiplayerClient.SettingsChanged(MultiplayerRoomSettings newSettings)
         {
-            // Do not return this task, as it will cause tests to deadlock.
-            updateLocalRoomSettings(newSettings);
+            Scheduler.Add(() => updateLocalRoomSettings(newSettings));
             return Task.CompletedTask;
         }
 
@@ -685,8 +684,7 @@ namespace osu.Game.Online.Multiplayer
         /// This updates both the joined <see cref="MultiplayerRoom"/> and the respective API <see cref="Room"/>.
         /// </remarks>
         /// <param name="settings">The new <see cref="MultiplayerRoomSettings"/> to update from.</param>
-        /// <param name="cancellationToken">The <see cref="CancellationToken"/> to cancel the update.</param>
-        private Task updateLocalRoomSettings(MultiplayerRoomSettings settings, CancellationToken cancellationToken = default) => scheduleAsync(() =>
+        private void updateLocalRoomSettings(MultiplayerRoomSettings settings)
         {
             if (Room == null)
                 return;
@@ -701,7 +699,7 @@ namespace osu.Game.Online.Multiplayer
             RoomUpdated?.Invoke();
 
             CurrentMatchPlayingItem.Value = APIRoom.Playlist.SingleOrDefault(p => p.ID == settings.PlaylistItemId);
-        }, cancellationToken);
+        }
 
         private async Task<PlaylistItem> createPlaylistItem(MultiplayerPlaylistItem item)
         {

From 69a9fc97328ef2bc70dddd30b76cece5b1b608c4 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 23 Nov 2021 16:04:11 +0900
Subject: [PATCH 1191/5547] Fix a few more multiplayer test timeouts

These can be tested by adding a `Task.Delay(3000);` at the end of the
`MultiplayerClient.JoinRoom` task. The reason is typically that
`Client.Room` becomes not-null but the join task still hasn't completed
yet, so e.g. the ready button is still disabled.
---
 .../StatefulMultiplayerClientTest.cs          |  2 +-
 .../Visual/Multiplayer/QueueModeTestScene.cs  |  2 +-
 .../Multiplayer/TestSceneMultiplayer.cs       | 10 +++----
 .../TestSceneMultiplayerMatchSubScreen.cs     |  4 +--
 .../Visual/Multiplayer/TestSceneTeamVersus.cs |  2 +-
 .../Visual/TestMultiplayerScreenStack.cs      |  2 ++
 .../Screens/OnlinePlay/OnlinePlayScreen.cs    |  4 +--
 .../Multiplayer/MultiplayerTestScene.cs       |  4 ++-
 .../Multiplayer/TestMultiplayerRoomManager.cs | 27 +++++++++++++++++++
 9 files changed, 44 insertions(+), 13 deletions(-)

diff --git a/osu.Game.Tests/NonVisual/Multiplayer/StatefulMultiplayerClientTest.cs b/osu.Game.Tests/NonVisual/Multiplayer/StatefulMultiplayerClientTest.cs
index abe5664737..840ff20a83 100644
--- a/osu.Game.Tests/NonVisual/Multiplayer/StatefulMultiplayerClientTest.cs
+++ b/osu.Game.Tests/NonVisual/Multiplayer/StatefulMultiplayerClientTest.cs
@@ -72,7 +72,7 @@ namespace osu.Game.Tests.NonVisual.Multiplayer
                 RoomManager.CreateRoom(newRoom);
             });
 
-            AddUntilStep("wait for room join", () => Client.Room != null);
+            AddUntilStep("wait for room join", () => RoomJoined);
             checkPlayingUserCount(1);
         }
 
diff --git a/osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs b/osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs
index e94e91dfe3..8e731e34ea 100644
--- a/osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs
@@ -92,7 +92,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 InputManager.Click(MouseButton.Left);
             });
 
-            AddUntilStep("wait for join", () => Client.Room != null);
+            AddUntilStep("wait for join", () => RoomManager.RoomJoined);
         }
 
         [Test]
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
index b828379848..c4833b5226 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
@@ -214,7 +214,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddStep("Press select", () => InputManager.Key(Key.Enter));
 
             AddUntilStep("wait for room open", () => this.ChildrenOfType<MultiplayerMatchSubScreen>().FirstOrDefault()?.IsLoaded == true);
-            AddUntilStep("wait for join", () => client.Room != null);
+            AddUntilStep("wait for join", () => roomManager.RoomJoined);
         }
 
         [Test]
@@ -293,7 +293,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddStep("join room", () => InputManager.Key(Key.Enter));
 
             AddUntilStep("wait for room open", () => this.ChildrenOfType<MultiplayerMatchSubScreen>().FirstOrDefault()?.IsLoaded == true);
-            AddUntilStep("wait for join", () => client.Room != null);
+            AddUntilStep("wait for join", () => roomManager.RoomJoined);
 
             AddAssert("Check participant count correct", () => client.APIRoom?.ParticipantCount.Value == 1);
             AddAssert("Check participant list contains user", () => client.APIRoom?.RecentParticipants.Count(u => u.Id == API.LocalUser.Value.Id) == 1);
@@ -351,7 +351,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddStep("press join room button", () => passwordEntryPopover.ChildrenOfType<OsuButton>().First().TriggerClick());
 
             AddUntilStep("wait for room open", () => this.ChildrenOfType<MultiplayerMatchSubScreen>().FirstOrDefault()?.IsLoaded == true);
-            AddUntilStep("wait for join", () => client.Room != null);
+            AddUntilStep("wait for join", () => roomManager.RoomJoined);
         }
 
         [Test]
@@ -618,7 +618,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             AddStep("join room", () => InputManager.Key(Key.Enter));
             AddUntilStep("wait for room open", () => this.ChildrenOfType<MultiplayerMatchSubScreen>().FirstOrDefault()?.IsLoaded == true);
-            AddUntilStep("wait for join", () => client.Room != null);
+            AddUntilStep("wait for join", () => roomManager.RoomJoined);
 
             AddAssert("local room has correct settings", () =>
             {
@@ -644,7 +644,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 InputManager.Click(MouseButton.Left);
             });
 
-            AddUntilStep("wait for join", () => client.Room != null);
+            AddUntilStep("wait for join", () => roomManager.RoomJoined);
         }
     }
 }
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs
index f544f5fdf3..bd230864df 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs
@@ -78,7 +78,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 });
             });
 
-            AddUntilStep("wait for join", () => Client.Room != null);
+            AddUntilStep("wait for join", () => RoomJoined);
         }
 
         [Test]
@@ -116,7 +116,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 InputManager.Click(MouseButton.Left);
             });
 
-            AddUntilStep("wait for room join", () => Client.Room != null);
+            AddUntilStep("wait for room join", () => RoomJoined);
 
             AddStep("join other user (ready)", () =>
             {
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs
index 99ff307235..c70906927e 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs
@@ -158,7 +158,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 InputManager.Click(MouseButton.Left);
             });
 
-            AddUntilStep("wait for join", () => client.Room != null);
+            AddUntilStep("wait for join", () => multiplayerScreenStack.RoomManager.RoomJoined);
         }
     }
 }
diff --git a/osu.Game.Tests/Visual/TestMultiplayerScreenStack.cs b/osu.Game.Tests/Visual/TestMultiplayerScreenStack.cs
index 7f1171db1f..43cb857c9a 100644
--- a/osu.Game.Tests/Visual/TestMultiplayerScreenStack.cs
+++ b/osu.Game.Tests/Visual/TestMultiplayerScreenStack.cs
@@ -7,6 +7,7 @@ using osu.Framework.Screens;
 using osu.Game.Online.API;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Screens;
+using osu.Game.Screens.OnlinePlay;
 using osu.Game.Screens.OnlinePlay.Components;
 using osu.Game.Tests.Visual.Multiplayer;
 using osu.Game.Tests.Visual.OnlinePlay;
@@ -76,6 +77,7 @@ namespace osu.Game.Tests.Visual
         {
             public new TestMultiplayerRoomManager RoomManager { get; private set; }
             public TestRoomRequestsHandler RequestsHandler { get; private set; }
+            public new OngoingOperationTracker OngoingOperationTracker => base.OngoingOperationTracker;
 
             protected override RoomManager CreateRoomManager() => RoomManager = new TestMultiplayerRoomManager(RequestsHandler = new TestRoomRequestsHandler());
         }
diff --git a/osu.Game/Screens/OnlinePlay/OnlinePlayScreen.cs b/osu.Game/Screens/OnlinePlay/OnlinePlayScreen.cs
index a18e4b45cf..6df79df535 100644
--- a/osu.Game/Screens/OnlinePlay/OnlinePlayScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/OnlinePlayScreen.cs
@@ -38,7 +38,7 @@ namespace osu.Game.Screens.OnlinePlay
         protected RoomManager RoomManager { get; private set; }
 
         [Cached]
-        private readonly OngoingOperationTracker ongoingOperationTracker = new OngoingOperationTracker();
+        protected readonly OngoingOperationTracker OngoingOperationTracker = new OngoingOperationTracker();
 
         [Resolved(CanBeNull = true)]
         private MusicController music { get; set; }
@@ -75,7 +75,7 @@ namespace osu.Game.Screens.OnlinePlay
                     screenStack = new OnlinePlaySubScreenStack { RelativeSizeAxes = Axes.Both },
                     new Header(ScreenTitle, screenStack),
                     RoomManager,
-                    ongoingOperationTracker
+                    OngoingOperationTracker
                 }
             };
         }
diff --git a/osu.Game/Tests/Visual/Multiplayer/MultiplayerTestScene.cs b/osu.Game/Tests/Visual/Multiplayer/MultiplayerTestScene.cs
index c628541825..5656704abf 100644
--- a/osu.Game/Tests/Visual/Multiplayer/MultiplayerTestScene.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/MultiplayerTestScene.cs
@@ -24,6 +24,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
         protected new MultiplayerTestSceneDependencies OnlinePlayDependencies => (MultiplayerTestSceneDependencies)base.OnlinePlayDependencies;
 
+        public bool RoomJoined => RoomManager.RoomJoined;
+
         private readonly bool joinRoom;
 
         protected MultiplayerTestScene(bool joinRoom = true)
@@ -61,7 +63,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             if (joinRoom)
             {
                 AddStep("join room", () => RoomManager.CreateRoom(SelectedRoom.Value));
-                AddUntilStep("wait for room join", () => Client.Room != null);
+                AddUntilStep("wait for room join", () => RoomJoined);
             }
         }
 
diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerRoomManager.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerRoomManager.cs
index 4129d190be..f8419b4164 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerRoomManager.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerRoomManager.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 osu.Game.Online.Rooms;
 using osu.Game.Screens.OnlinePlay.Components;
@@ -15,6 +16,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
     /// </summary>
     public class TestMultiplayerRoomManager : MultiplayerRoomManager
     {
+        public bool RoomJoined { get; private set; }
+
         private readonly TestRoomRequestsHandler requestsHandler;
 
         public TestMultiplayerRoomManager(TestRoomRequestsHandler requestsHandler)
@@ -24,6 +27,30 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
         public IReadOnlyList<Room> ServerSideRooms => requestsHandler.ServerSideRooms;
 
+        public override void CreateRoom(Room room, Action<Room> onSuccess = null, Action<string> onError = null)
+        {
+            base.CreateRoom(room, r =>
+            {
+                onSuccess?.Invoke(r);
+                RoomJoined = true;
+            }, onError);
+        }
+
+        public override void JoinRoom(Room room, string password = null, Action<Room> onSuccess = null, Action<string> onError = null)
+        {
+            base.JoinRoom(room, password, r =>
+            {
+                onSuccess?.Invoke(r);
+                RoomJoined = true;
+            }, onError);
+        }
+
+        public override void PartRoom()
+        {
+            base.PartRoom();
+            RoomJoined = false;
+        }
+
         /// <summary>
         /// Adds a room to a local "server-side" list that's returned when a <see cref="GetRoomsRequest"/> is fired.
         /// </summary>

From 1f136696362aab0824fb85e6e90693c85c5820ef Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 23 Nov 2021 16:13:53 +0900
Subject: [PATCH 1192/5547] Don't poll while in room

Fixes timeout in `TestJoinRoomWithoutPassword`, because the 'server' returns
out-of-date data while the `MatchSubScreen` has possible not been entered
yet (and thus hasn't disabled polling itself yet).

Can be tested by adding a `Task.Delay(3000);` at the end of
the `MultiplayerClient.JoinRoom()` task.
---
 .../OnlinePlay/Multiplayer/MultiplayerLoungeSubScreen.cs       | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerLoungeSubScreen.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerLoungeSubScreen.cs
index cf1066df10..5cdec52bc2 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerLoungeSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerLoungeSubScreen.cs
@@ -93,6 +93,9 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
                 if (!isConnected.Value)
                     return Task.CompletedTask;
 
+                if (client.Room != null)
+                    return Task.CompletedTask;
+
                 return base.Poll();
             }
         }

From 6363833fb3c1071bcea9a8d021270bf0cc64056b Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 23 Nov 2021 16:16:38 +0900
Subject: [PATCH 1193/5547] Revert unnecessary changes

---
 osu.Game.Tests/Visual/TestMultiplayerScreenStack.cs | 2 --
 osu.Game/Screens/OnlinePlay/OnlinePlayScreen.cs     | 4 ++--
 2 files changed, 2 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Tests/Visual/TestMultiplayerScreenStack.cs b/osu.Game.Tests/Visual/TestMultiplayerScreenStack.cs
index 43cb857c9a..7f1171db1f 100644
--- a/osu.Game.Tests/Visual/TestMultiplayerScreenStack.cs
+++ b/osu.Game.Tests/Visual/TestMultiplayerScreenStack.cs
@@ -7,7 +7,6 @@ using osu.Framework.Screens;
 using osu.Game.Online.API;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Screens;
-using osu.Game.Screens.OnlinePlay;
 using osu.Game.Screens.OnlinePlay.Components;
 using osu.Game.Tests.Visual.Multiplayer;
 using osu.Game.Tests.Visual.OnlinePlay;
@@ -77,7 +76,6 @@ namespace osu.Game.Tests.Visual
         {
             public new TestMultiplayerRoomManager RoomManager { get; private set; }
             public TestRoomRequestsHandler RequestsHandler { get; private set; }
-            public new OngoingOperationTracker OngoingOperationTracker => base.OngoingOperationTracker;
 
             protected override RoomManager CreateRoomManager() => RoomManager = new TestMultiplayerRoomManager(RequestsHandler = new TestRoomRequestsHandler());
         }
diff --git a/osu.Game/Screens/OnlinePlay/OnlinePlayScreen.cs b/osu.Game/Screens/OnlinePlay/OnlinePlayScreen.cs
index 6df79df535..a18e4b45cf 100644
--- a/osu.Game/Screens/OnlinePlay/OnlinePlayScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/OnlinePlayScreen.cs
@@ -38,7 +38,7 @@ namespace osu.Game.Screens.OnlinePlay
         protected RoomManager RoomManager { get; private set; }
 
         [Cached]
-        protected readonly OngoingOperationTracker OngoingOperationTracker = new OngoingOperationTracker();
+        private readonly OngoingOperationTracker ongoingOperationTracker = new OngoingOperationTracker();
 
         [Resolved(CanBeNull = true)]
         private MusicController music { get; set; }
@@ -75,7 +75,7 @@ namespace osu.Game.Screens.OnlinePlay
                     screenStack = new OnlinePlaySubScreenStack { RelativeSizeAxes = Axes.Both },
                     new Header(ScreenTitle, screenStack),
                     RoomManager,
-                    OngoingOperationTracker
+                    ongoingOperationTracker
                 }
             };
         }

From 0cf5a738dc9a0851e74d546ad155001f0e8ca646 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 23 Nov 2021 16:32:44 +0900
Subject: [PATCH 1194/5547] Remove unused using

---
 osu.Game.Tournament.Tests/NonVisual/IPCLocationTest.cs | 1 -
 1 file changed, 1 deletion(-)

diff --git a/osu.Game.Tournament.Tests/NonVisual/IPCLocationTest.cs b/osu.Game.Tournament.Tests/NonVisual/IPCLocationTest.cs
index 22d9a4ff9d..db89855db7 100644
--- a/osu.Game.Tournament.Tests/NonVisual/IPCLocationTest.cs
+++ b/osu.Game.Tournament.Tests/NonVisual/IPCLocationTest.cs
@@ -3,7 +3,6 @@
 
 using System.IO;
 using NUnit.Framework;
-using osu.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Platform;
 using osu.Game.Tournament.IO;

From 9157b91e5f2aebb4fcbee2052227a27c781041fa Mon Sep 17 00:00:00 2001
From: GoldenMine0502 <ehe123@naver.com>
Date: Tue, 23 Nov 2021 16:41:20 +0900
Subject: [PATCH 1195/5547] fix adding wrong values

---
 osu.Game.Rulesets.Osu/Difficulty/Skills/Speed.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Speed.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Speed.cs
index 24881d9c47..4f87767fa7 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Speed.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Speed.cs
@@ -154,7 +154,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
             if (strainTime < min_speed_bonus)
                 speedBonus = 1 + 0.75 * Math.Pow((min_speed_bonus - strainTime) / speed_balancing_factor, 2);
 
-            double distance = Math.Min(single_spacing_threshold, osuCurrObj.TravelDistance + osuCurrObj.JumpDistance);
+            double distance = Math.Min(single_spacing_threshold, osuCurrObj.TravelDistance + osuCurrObj.MovementDistance);
 
             return (speedBonus + speedBonus * Math.Pow(distance / single_spacing_threshold, 3.5)) / strainTime;
         }

From a521d1b83584c40f8ed201716c0b83e3b4ffa8b1 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 23 Nov 2021 17:09:38 +0900
Subject: [PATCH 1196/5547] Wait for ready button to be enabled first

---
 .../Visual/Multiplayer/QueueModeTestScene.cs  | 26 ++++++++++---------
 1 file changed, 14 insertions(+), 12 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs b/osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs
index 8e731e34ea..357db16e2c 100644
--- a/osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs
@@ -5,6 +5,7 @@ using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
+using osu.Framework.Graphics.UserInterface;
 using osu.Framework.Platform;
 using osu.Framework.Screens;
 using osu.Framework.Testing;
@@ -104,23 +105,24 @@ namespace osu.Game.Tests.Visual.Multiplayer
         protected void RunGameplay()
         {
             AddUntilStep("wait for idle", () => Client.LocalUser?.State == MultiplayerUserState.Idle);
-
-            AddStep("click ready button", () =>
-            {
-                InputManager.MoveMouseTo(this.ChildrenOfType<MultiplayerReadyButton>().Single());
-                InputManager.Click(MouseButton.Left);
-            });
+            clickReadyButton();
 
             AddUntilStep("wait for ready", () => Client.LocalUser?.State == MultiplayerUserState.Ready);
-
-            AddStep("click ready button", () =>
-            {
-                InputManager.MoveMouseTo(this.ChildrenOfType<MultiplayerReadyButton>().Single());
-                InputManager.Click(MouseButton.Left);
-            });
+            clickReadyButton();
 
             AddUntilStep("wait for player", () => multiplayerScreenStack.CurrentScreen is Player player && player.IsLoaded);
             AddStep("exit player", () => multiplayerScreenStack.MultiplayerScreen.MakeCurrent());
         }
+
+        private void clickReadyButton()
+        {
+            AddUntilStep("wait for ready button to be enabled", () => this.ChildrenOfType<MultiplayerReadyButton>().Single().ChildrenOfType<Button>().Single().Enabled.Value);
+
+            AddStep("click ready button", () =>
+            {
+                InputManager.MoveMouseTo(this.ChildrenOfType<MultiplayerReadyButton>().Single());
+                InputManager.Click(MouseButton.Left);
+            });
+        }
     }
 }

From 505fede44d93ff68c5ad150d1641b25143bef701 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 23 Nov 2021 16:27:28 +0900
Subject: [PATCH 1197/5547] Pass the full EF context rather than a legacy
 `RulesetStore`

---
 osu.Game/Database/RealmContextFactory.cs | 18 +++++++++++++-----
 osu.Game/OsuGameBase.cs                  |  2 +-
 2 files changed, 14 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Database/RealmContextFactory.cs b/osu.Game/Database/RealmContextFactory.cs
index 70ea24b581..f04492d0e8 100644
--- a/osu.Game/Database/RealmContextFactory.cs
+++ b/osu.Game/Database/RealmContextFactory.cs
@@ -14,7 +14,6 @@ using osu.Framework.Statistics;
 using osu.Game.Configuration;
 using osu.Game.Input.Bindings;
 using osu.Game.Models;
-using osu.Game.Rulesets;
 using Realms;
 
 #nullable enable
@@ -33,7 +32,7 @@ namespace osu.Game.Database
         /// </summary>
         public readonly string Filename;
 
-        private readonly RulesetStore? rulesets;
+        private readonly IDatabaseContextFactory? efContextFactory;
 
         /// <summary>
         /// Version history:
@@ -77,10 +76,10 @@ namespace osu.Game.Database
             }
         }
 
-        public RealmContextFactory(Storage storage, string filename, RulesetStore? rulesets = null)
+        public RealmContextFactory(Storage storage, string filename, IDatabaseContextFactory? efContextFactory = null)
         {
             this.storage = storage;
-            this.rulesets = rulesets;
+            this.efContextFactory = efContextFactory;
 
             Filename = filename;
 
@@ -252,7 +251,7 @@ namespace osu.Game.Database
                         var newItem = newSettings.ElementAt(i);
 
                         long rulesetId = oldItem.RulesetID;
-                        string? rulesetName = rulesets?.GetRuleset((int)rulesetId)?.ShortName;
+                        string? rulesetName = getRulesetShortNameFromLegacyID(rulesetId);
 
                         if (string.IsNullOrEmpty(rulesetName))
                             migration.NewRealm.Remove(newItem);
@@ -264,6 +263,15 @@ namespace osu.Game.Database
             }
         }
 
+        private string? getRulesetShortNameFromLegacyID(long rulesetId)
+        {
+            if (efContextFactory == null)
+                return null;
+
+            using (var efContext = efContextFactory.Get())
+                return efContext.RulesetInfo.First(r => r.ID == rulesetId)?.ShortName;
+        }
+
         /// <summary>
         /// Flush any active contexts and block any further writes.
         /// </summary>
diff --git a/osu.Game/OsuGameBase.cs b/osu.Game/OsuGameBase.cs
index a2dd417491..1890fd7d24 100644
--- a/osu.Game/OsuGameBase.cs
+++ b/osu.Game/OsuGameBase.cs
@@ -192,7 +192,7 @@ namespace osu.Game
 
             dependencies.Cache(RulesetStore = new RulesetStore(contextFactory, Storage));
 
-            dependencies.Cache(realmFactory = new RealmContextFactory(Storage, "client", RulesetStore));
+            dependencies.Cache(realmFactory = new RealmContextFactory(Storage, "client", contextFactory));
 
             dependencies.CacheAs(Storage);
 

From b1b67238268bed5945aa1ae90d21dac16629114a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 23 Nov 2021 17:47:43 +0900
Subject: [PATCH 1198/5547] Add xmldoc and verbatim string markers

---
 osu.Game/Database/RealmContextFactory.cs | 20 +++++++++++++-------
 1 file changed, 13 insertions(+), 7 deletions(-)

diff --git a/osu.Game/Database/RealmContextFactory.cs b/osu.Game/Database/RealmContextFactory.cs
index f04492d0e8..3949494766 100644
--- a/osu.Game/Database/RealmContextFactory.cs
+++ b/osu.Game/Database/RealmContextFactory.cs
@@ -49,8 +49,8 @@ namespace osu.Game.Database
         /// </summary>
         private readonly SemaphoreSlim contextCreationLock = new SemaphoreSlim(1);
 
-        private static readonly GlobalStatistic<int> refreshes = GlobalStatistics.Get<int>("Realm", "Dirty Refreshes");
-        private static readonly GlobalStatistic<int> contexts_created = GlobalStatistics.Get<int>("Realm", "Contexts (Created)");
+        private static readonly GlobalStatistic<int> refreshes = GlobalStatistics.Get<int>(@"Realm", @"Dirty Refreshes");
+        private static readonly GlobalStatistic<int> contexts_created = GlobalStatistics.Get<int>(@"Realm", @"Contexts (Created)");
 
         private readonly object contextLock = new object();
         private Realm? context;
@@ -60,14 +60,14 @@ namespace osu.Game.Database
             get
             {
                 if (!ThreadSafety.IsUpdateThread)
-                    throw new InvalidOperationException($"Use {nameof(CreateContext)} when performing realm operations from a non-update thread");
+                    throw new InvalidOperationException(@$"Use {nameof(CreateContext)} when performing realm operations from a non-update thread");
 
                 lock (contextLock)
                 {
                     if (context == null)
                     {
                         context = CreateContext();
-                        Logger.Log($"Opened realm \"{context.Config.DatabasePath}\" at version {context.Config.SchemaVersion}");
+                        Logger.Log(@$"Opened realm ""{context.Config.DatabasePath}"" at version {context.Config.SchemaVersion}");
                     }
 
                     // creating a context will ensure our schema is up-to-date and migrated.
@@ -76,6 +76,12 @@ namespace osu.Game.Database
             }
         }
 
+        /// <summary>
+        /// Construct a new instance of a realm context factory.
+        /// </summary>
+        /// <param name="storage">The game storage which will be used to create the realm backing file.</param>
+        /// <param name="filename">The filename to use for the realm backing file. A ".realm" extension will be added automatically if not specified.</param>
+        /// <param name="efContextFactory">An EF factory used only for migration purposes.</param>
         public RealmContextFactory(Storage storage, string filename, IDatabaseContextFactory? efContextFactory = null)
         {
             this.storage = storage;
@@ -83,7 +89,7 @@ namespace osu.Game.Database
 
             Filename = filename;
 
-            const string realm_extension = ".realm";
+            const string realm_extension = @".realm";
 
             if (!Filename.EndsWith(realm_extension, StringComparison.Ordinal))
                 Filename += realm_extension;
@@ -286,7 +292,7 @@ namespace osu.Game.Database
                 throw new ObjectDisposedException(nameof(RealmContextFactory));
 
             if (!ThreadSafety.IsUpdateThread)
-                throw new InvalidOperationException($"{nameof(BlockAllOperations)} must be called from the update thread.");
+                throw new InvalidOperationException(@$"{nameof(BlockAllOperations)} must be called from the update thread.");
 
             Logger.Log(@"Blocking realm operations.", LoggingTarget.Database);
 
@@ -310,7 +316,7 @@ namespace osu.Game.Database
                     timeout -= sleep_length;
 
                     if (timeout < 0)
-                        throw new TimeoutException("Took too long to acquire lock");
+                        throw new TimeoutException(@"Took too long to acquire lock");
                 }
             }
             catch

From 79a8e604684843f8441e38afe9a62acb93155f22 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 23 Nov 2021 17:55:04 +0900
Subject: [PATCH 1199/5547] Resolve inspection

---
 osu.Game/Online/Multiplayer/MultiplayerClient.cs | 1 -
 1 file changed, 1 deletion(-)

diff --git a/osu.Game/Online/Multiplayer/MultiplayerClient.cs b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
index 6b8bb7ecdf..5c339c5d55 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
@@ -164,7 +164,6 @@ namespace osu.Game.Online.Multiplayer
 
                     OnRoomJoined();
                 }, cancellationSource.Token).ConfigureAwait(false);
-
             }, cancellationSource.Token).ConfigureAwait(false);
         }
 

From 40cd998f997508a7f03f58d3d0d32c1283fb84ed Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 23 Nov 2021 18:13:05 +0900
Subject: [PATCH 1200/5547] Fix incorrect disposal

---
 osu.Game/Database/RealmContextFactory.cs | 10 ++--------
 1 file changed, 2 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Database/RealmContextFactory.cs b/osu.Game/Database/RealmContextFactory.cs
index 3949494766..d0d176c780 100644
--- a/osu.Game/Database/RealmContextFactory.cs
+++ b/osu.Game/Database/RealmContextFactory.cs
@@ -269,14 +269,8 @@ namespace osu.Game.Database
             }
         }
 
-        private string? getRulesetShortNameFromLegacyID(long rulesetId)
-        {
-            if (efContextFactory == null)
-                return null;
-
-            using (var efContext = efContextFactory.Get())
-                return efContext.RulesetInfo.First(r => r.ID == rulesetId)?.ShortName;
-        }
+        private string? getRulesetShortNameFromLegacyID(long rulesetId) =>
+            efContextFactory?.Get().RulesetInfo.First(r => r.ID == rulesetId)?.ShortName;
 
         /// <summary>
         /// Flush any active contexts and block any further writes.

From 4149d458f010598063e9ac3e2ff9673b6759f2b5 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 23 Nov 2021 18:04:21 +0900
Subject: [PATCH 1201/5547] Move realm data migrations inside the
 `RealmContextFactory`

---
 osu.Game/Database/RealmContextFactory.cs | 51 ++++++++++++++++++++++++
 osu.Game/OsuGameBase.cs                  | 31 --------------
 osu.sln.DotSettings                      |  1 +
 3 files changed, 52 insertions(+), 31 deletions(-)

diff --git a/osu.Game/Database/RealmContextFactory.cs b/osu.Game/Database/RealmContextFactory.cs
index 411cfc52ee..760b154397 100644
--- a/osu.Game/Database/RealmContextFactory.cs
+++ b/osu.Game/Database/RealmContextFactory.cs
@@ -96,6 +96,9 @@ namespace osu.Game.Database
                 Filename += realm_extension;
 
             cleanupPendingDeletions();
+
+            // run after the above operation to ensure realm is already in a good (fully migrated) state.
+            migrateDataFromEF();
         }
 
         private void cleanupPendingDeletions()
@@ -163,6 +166,54 @@ namespace osu.Game.Database
             };
         }
 
+        private void migrateDataFromEF()
+        {
+            if (efContextFactory == null)
+                return;
+
+            using (var db = efContextFactory.GetForWrite())
+            {
+                // migrate ruleset settings. can be removed 20220315.
+                var existingSettings = db.Context.DatabasedSetting;
+
+                // previous entries in EF are removed post migration.
+                if (!existingSettings.Any())
+                    return;
+
+                using (var realm = CreateContext())
+                using (var transaction = realm.BeginWrite())
+                {
+                    // only migrate data if the realm database is empty.
+                    if (!realm.All<RealmRulesetSetting>().Any())
+                    {
+                        foreach (var dkb in existingSettings)
+                        {
+                            if (dkb.RulesetID == null)
+                                continue;
+
+                            string? shortName = getRulesetShortNameFromLegacyID(dkb.RulesetID.Value);
+
+                            if (string.IsNullOrEmpty(shortName))
+                                continue;
+
+                            realm.Add(new RealmRulesetSetting
+                            {
+                                Key = dkb.Key,
+                                Value = dkb.StringValue,
+                                // important: this RulesetStore must be the EF one.
+                                RulesetName = shortName,
+                                Variant = dkb.Variant ?? 0,
+                            });
+                        }
+                    }
+
+                    db.Context.RemoveRange(existingSettings);
+
+                    transaction.Commit();
+                }
+            }
+        }
+
         private void onMigration(Migration migration, ulong lastSchemaVersion)
         {
             for (ulong i = lastSchemaVersion + 1; i <= schema_version; i++)
diff --git a/osu.Game/OsuGameBase.cs b/osu.Game/OsuGameBase.cs
index 1890fd7d24..8c35e65dfc 100644
--- a/osu.Game/OsuGameBase.cs
+++ b/osu.Game/OsuGameBase.cs
@@ -262,8 +262,6 @@ namespace osu.Game
             dependencies.Cache(scorePerformanceManager);
             AddInternal(scorePerformanceManager);
 
-            migrateDataToRealm();
-
             dependencies.Cache(rulesetConfigCache = new RulesetConfigCache(realmFactory, RulesetStore));
 
             var powerStatus = CreateBatteryInfo();
@@ -439,35 +437,6 @@ namespace osu.Game
 
         private void migrateDataToRealm()
         {
-            using (var db = contextFactory.GetForWrite())
-            using (var realm = realmFactory.CreateContext())
-            using (var transaction = realm.BeginWrite())
-            {
-                // migrate ruleset settings. can be removed 20220315.
-                var existingSettings = db.Context.DatabasedSetting;
-
-                // only migrate data if the realm database is empty.
-                if (!realm.All<RealmRulesetSetting>().Any())
-                {
-                    foreach (var dkb in existingSettings)
-                    {
-                        if (dkb.RulesetID == null) continue;
-
-                        realm.Add(new RealmRulesetSetting
-                        {
-                            Key = dkb.Key,
-                            Value = dkb.StringValue,
-                            // important: this RulesetStore must be the EF one.
-                            RulesetName = RulesetStore.GetRuleset(dkb.RulesetID.Value).ShortName,
-                            Variant = dkb.Variant ?? 0,
-                        });
-                    }
-                }
-
-                db.Context.RemoveRange(existingSettings);
-
-                transaction.Commit();
-            }
         }
 
         private void onRulesetChanged(ValueChangedEvent<RulesetInfo> r)
diff --git a/osu.sln.DotSettings b/osu.sln.DotSettings
index 3fac94b243..a96f64cdc3 100644
--- a/osu.sln.DotSettings
+++ b/osu.sln.DotSettings
@@ -311,6 +311,7 @@
 	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/Abbreviations/=AABB/@EntryIndexedValue">AABB</s:String>
 	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/Abbreviations/=API/@EntryIndexedValue">API</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/=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>
 	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/Abbreviations/=GL/@EntryIndexedValue">GL</s:String>

From 6b134359c932e7c0bda1b6bc129ee7e539b8e7e9 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 23 Nov 2021 19:15:52 +0900
Subject: [PATCH 1202/5547] Handle the case where the ruleset isn't found in
 the EF database any more

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

diff --git a/osu.Game/Database/RealmContextFactory.cs b/osu.Game/Database/RealmContextFactory.cs
index d0d176c780..0e602da190 100644
--- a/osu.Game/Database/RealmContextFactory.cs
+++ b/osu.Game/Database/RealmContextFactory.cs
@@ -270,7 +270,7 @@ namespace osu.Game.Database
         }
 
         private string? getRulesetShortNameFromLegacyID(long rulesetId) =>
-            efContextFactory?.Get().RulesetInfo.First(r => r.ID == rulesetId)?.ShortName;
+            efContextFactory?.Get().RulesetInfo.FirstOrDefault(r => r.ID == rulesetId)?.ShortName;
 
         /// <summary>
         /// Flush any active contexts and block any further writes.

From 4011da033bba3c51cf591857f2fb14ad8c8e10d2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 23 Oct 2021 17:59:52 +0200
Subject: [PATCH 1203/5547] Split off thumbnail to separate component

---
 .../Beatmaps/Drawables/Cards/BeatmapCard.cs   | 26 ++++-----
 .../Drawables/Cards/BeatmapCardThumbnail.cs   | 54 +++++++++++++++++++
 2 files changed, 63 insertions(+), 17 deletions(-)
 create mode 100644 osu.Game/Beatmaps/Drawables/Cards/BeatmapCardThumbnail.cs

diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
index e3af253db9..d52e8f6c20 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
@@ -23,7 +23,6 @@ using osu.Game.Overlays.BeatmapSet;
 using osuTK;
 using osu.Game.Overlays.BeatmapListing.Panels;
 using osu.Game.Resources.Localisation.Web;
-using osuTK.Graphics;
 using DownloadButton = osu.Game.Beatmaps.Drawables.Cards.Buttons.DownloadButton;
 
 namespace osu.Game.Beatmaps.Drawables.Cards
@@ -42,7 +41,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
 
         private readonly BeatmapDownloadTracker downloadTracker;
 
-        private UpdateableOnlineBeatmapSetCover leftCover;
+        private BeatmapCardThumbnail thumbnail;
         private FillFlowContainer leftIconArea;
 
         private Container rightAreaBackground;
@@ -98,24 +97,16 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                         Colour = Colour4.White
                     },
                 },
-                new Container
+                thumbnail = new BeatmapCardThumbnail(beatmapSet)
                 {
                     Name = @"Left (icon) area",
                     Size = new Vector2(height),
-                    Children = new Drawable[]
+                    Child = leftIconArea = new FillFlowContainer
                     {
-                        leftCover = new UpdateableOnlineBeatmapSetCover(BeatmapSetCoverType.List)
-                        {
-                            RelativeSizeAxes = Axes.Both,
-                            OnlineInfo = beatmapSet
-                        },
-                        leftIconArea = new FillFlowContainer
-                        {
-                            Margin = new MarginPadding(5),
-                            AutoSizeAxes = Axes.Both,
-                            Direction = FillDirection.Horizontal,
-                            Spacing = new Vector2(1)
-                        }
+                        Margin = new MarginPadding(5),
+                        AutoSizeAxes = Axes.Both,
+                        Direction = FillDirection.Horizontal,
+                        Spacing = new Vector2(1)
                     }
                 },
                 new Container
@@ -395,10 +386,11 @@ namespace osu.Game.Beatmaps.Drawables.Cards
             if (IsHovered)
                 targetWidth = targetWidth - icon_area_width + corner_radius;
 
+            thumbnail.Dimmed.Value = IsHovered;
+
             mainContent.ResizeWidthTo(targetWidth, TRANSITION_DURATION, Easing.OutQuint);
             mainContentBackground.Dimmed.Value = IsHovered;
 
-            leftCover.FadeColour(IsHovered ? OsuColour.Gray(0.2f) : Color4.White, TRANSITION_DURATION, Easing.OutQuint);
             statisticsContainer.FadeTo(IsHovered ? 1 : 0, TRANSITION_DURATION, Easing.OutQuint);
 
             rightAreaBackground.FadeColour(downloadTracker.State.Value == DownloadState.LocallyAvailable ? colours.Lime0 : colourProvider.Background3, TRANSITION_DURATION, Easing.OutQuint);
diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardThumbnail.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardThumbnail.cs
new file mode 100644
index 0000000000..b9304e744a
--- /dev/null
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardThumbnail.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.Bindables;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
+using osu.Game.Graphics;
+using osu.Game.Online.API.Requests.Responses;
+using osuTK.Graphics;
+
+namespace osu.Game.Beatmaps.Drawables.Cards
+{
+    public class BeatmapCardThumbnail : Container
+    {
+        public BindableBool Dimmed { get; } = new BindableBool();
+
+        private readonly APIBeatmapSet beatmapSetInfo;
+
+        private readonly UpdateableOnlineBeatmapSetCover cover;
+        private readonly Container content;
+
+        protected override Container<Drawable> Content => content;
+
+        public BeatmapCardThumbnail(APIBeatmapSet beatmapSetInfo)
+        {
+            this.beatmapSetInfo = beatmapSetInfo;
+
+            InternalChildren = new Drawable[]
+            {
+                cover = new UpdateableOnlineBeatmapSetCover(BeatmapSetCoverType.List)
+                {
+                    RelativeSizeAxes = Axes.Both,
+                    OnlineInfo = beatmapSetInfo
+                },
+                content = new Container
+                {
+                    RelativeSizeAxes = Axes.Both
+                }
+            };
+        }
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+            Dimmed.BindValueChanged(_ => updateState(), true);
+            FinishTransforms(true);
+        }
+
+        private void updateState()
+        {
+            cover.FadeColour(Dimmed.Value ? OsuColour.Gray(0.2f) : Color4.White, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
+        }
+    }
+}

From b44db9f5e5036fd59cb4e62f2b2a40df56aaff14 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 23 Oct 2021 18:05:30 +0200
Subject: [PATCH 1204/5547] Add test scene for thumbnail component

---
 .../Beatmaps/TestSceneBeatmapCardThumbnail.cs | 32 +++++++++++++++++++
 1 file changed, 32 insertions(+)
 create mode 100644 osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCardThumbnail.cs

diff --git a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCardThumbnail.cs b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCardThumbnail.cs
new file mode 100644
index 0000000000..b7c87219ca
--- /dev/null
+++ b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCardThumbnail.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 NUnit.Framework;
+using osu.Framework.Allocation;
+using osu.Framework.Graphics;
+using osu.Game.Beatmaps.Drawables.Cards;
+using osu.Game.Overlays;
+using osuTK;
+
+namespace osu.Game.Tests.Visual.Beatmaps
+{
+    public class TestSceneBeatmapCardThumbnail : OsuTestScene
+    {
+        [Cached]
+        private OverlayColourProvider colourProvider = new OverlayColourProvider(OverlayColourScheme.Blue);
+
+        [Test]
+        public void TestThumbnailPreview()
+        {
+            BeatmapCardThumbnail thumbnail = null;
+
+            AddStep("create thumbnail", () => Child = thumbnail = new BeatmapCardThumbnail(CreateAPIBeatmapSet(Ruleset.Value))
+            {
+                Anchor = Anchor.Centre,
+                Origin = Anchor.Centre,
+                Size = new Vector2(200)
+            });
+            AddToggleStep("toggle dim", dimmed => thumbnail.Dimmed.Value = dimmed);
+        }
+    }
+}

From 5d13686cdf689bd42b7dc9e992cb9bb19fcf8dfb Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 23 Oct 2021 18:26:28 +0200
Subject: [PATCH 1205/5547] Add play button for card preview

---
 .../Drawables/Cards/BeatmapCardThumbnail.cs   |  3 ++
 .../Drawables/Cards/Buttons/PlayButton.cs     | 34 +++++++++++++++++++
 2 files changed, 37 insertions(+)
 create mode 100644 osu.Game/Beatmaps/Drawables/Cards/Buttons/PlayButton.cs

diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardThumbnail.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardThumbnail.cs
index b9304e744a..75ed5bdcfe 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardThumbnail.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardThumbnail.cs
@@ -17,6 +17,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
         private readonly APIBeatmapSet beatmapSetInfo;
 
         private readonly UpdateableOnlineBeatmapSetCover cover;
+        private readonly PlayButton playButton;
         private readonly Container content;
 
         protected override Container<Drawable> Content => content;
@@ -32,6 +33,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                     RelativeSizeAxes = Axes.Both,
                     OnlineInfo = beatmapSetInfo
                 },
+                playButton = new PlayButton(),
                 content = new Container
                 {
                     RelativeSizeAxes = Axes.Both
@@ -48,6 +50,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
 
         private void updateState()
         {
+            playButton.FadeTo(Dimmed.Value ? 1 : 0, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
             cover.FadeColour(Dimmed.Value ? OsuColour.Gray(0.2f) : Color4.White, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
         }
     }
diff --git a/osu.Game/Beatmaps/Drawables/Cards/Buttons/PlayButton.cs b/osu.Game/Beatmaps/Drawables/Cards/Buttons/PlayButton.cs
new file mode 100644
index 0000000000..c1cbac1c59
--- /dev/null
+++ b/osu.Game/Beatmaps/Drawables/Cards/Buttons/PlayButton.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 osu.Framework.Allocation;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Sprites;
+using osu.Game.Graphics;
+using osu.Game.Graphics.Containers;
+using osuTK;
+
+namespace osu.Game.Beatmaps.Drawables.Cards.Buttons
+{
+    public class PlayButton : OsuHoverContainer
+    {
+        public PlayButton()
+        {
+            Anchor = Origin = Anchor.Centre;
+
+            Child = new SpriteIcon
+            {
+                Anchor = Anchor.Centre,
+                Origin = Anchor.Centre,
+                Icon = FontAwesome.Solid.Play,
+                Size = new Vector2(14)
+            };
+        }
+
+        [BackgroundDependencyLoader]
+        private void load(OsuColour colours)
+        {
+            HoverColour = colours.Yellow;
+        }
+    }
+}

From 9164f006aa17ac62a17fda40e4260237fc353cbc Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 23 Oct 2021 18:41:31 +0200
Subject: [PATCH 1206/5547] Implement basic behaviour of play button

---
 .../Beatmaps/TestSceneBeatmapCardThumbnail.cs | 42 ++++++++++++++++++-
 .../Drawables/Cards/BeatmapCardThumbnail.cs   | 15 +++++--
 .../Drawables/Cards/Buttons/PlayButton.cs     | 38 ++++++++++++++---
 3 files changed, 83 insertions(+), 12 deletions(-)

diff --git a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCardThumbnail.cs b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCardThumbnail.cs
index b7c87219ca..73424241cb 100644
--- a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCardThumbnail.cs
+++ b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCardThumbnail.cs
@@ -1,17 +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.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
+using osu.Framework.Graphics.Sprites;
+using osu.Framework.Testing;
 using osu.Game.Beatmaps.Drawables.Cards;
+using osu.Game.Beatmaps.Drawables.Cards.Buttons;
 using osu.Game.Overlays;
 using osuTK;
+using osuTK.Input;
 
 namespace osu.Game.Tests.Visual.Beatmaps
 {
-    public class TestSceneBeatmapCardThumbnail : OsuTestScene
+    public class TestSceneBeatmapCardThumbnail : OsuManualInputManagerTestScene
     {
+        private PlayButton playButton => this.ChildrenOfType<PlayButton>().Single();
+
         [Cached]
         private OverlayColourProvider colourProvider = new OverlayColourProvider(OverlayColourScheme.Blue);
 
@@ -26,7 +33,38 @@ namespace osu.Game.Tests.Visual.Beatmaps
                 Origin = Anchor.Centre,
                 Size = new Vector2(200)
             });
-            AddToggleStep("toggle dim", dimmed => thumbnail.Dimmed.Value = dimmed);
+            AddStep("enable dim", () => thumbnail.Dimmed.Value = true);
+            AddUntilStep("button visible", () => playButton.IsPresent);
+
+            AddStep("click button", () =>
+            {
+                InputManager.MoveMouseTo(playButton);
+                InputManager.Click(MouseButton.Left);
+            });
+            iconIs(FontAwesome.Solid.Stop);
+
+            AddStep("click again", () =>
+            {
+                InputManager.MoveMouseTo(playButton);
+                InputManager.Click(MouseButton.Left);
+            });
+            iconIs(FontAwesome.Solid.Play);
+
+            AddStep("click again", () =>
+            {
+                InputManager.MoveMouseTo(playButton);
+                InputManager.Click(MouseButton.Left);
+            });
+            iconIs(FontAwesome.Solid.Stop);
+
+            AddStep("disable dim", () => thumbnail.Dimmed.Value = false);
+            AddWaitStep("wait some", 3);
+            AddAssert("button still visible", () => playButton.IsPresent);
+
+            AddStep("end track playback", () => playButton.Playing.Value = false);
+            AddUntilStep("button hidden", () => !playButton.IsPresent);
         }
+
+        private void iconIs(IconUsage usage) => AddAssert("icon is correct", () => playButton.ChildrenOfType<SpriteIcon>().Single().Icon.Equals(usage));
     }
 }
diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardThumbnail.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardThumbnail.cs
index 75ed5bdcfe..ce1f856b84 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardThumbnail.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardThumbnail.cs
@@ -4,6 +4,7 @@
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
+using osu.Game.Beatmaps.Drawables.Cards.Buttons;
 using osu.Game.Graphics;
 using osu.Game.Online.API.Requests.Responses;
 using osuTK.Graphics;
@@ -33,7 +34,10 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                     RelativeSizeAxes = Axes.Both,
                     OnlineInfo = beatmapSetInfo
                 },
-                playButton = new PlayButton(),
+                playButton = new PlayButton(beatmapSetInfo)
+                {
+                    RelativeSizeAxes = Axes.Both
+                },
                 content = new Container
                 {
                     RelativeSizeAxes = Axes.Both
@@ -44,14 +48,17 @@ namespace osu.Game.Beatmaps.Drawables.Cards
         protected override void LoadComplete()
         {
             base.LoadComplete();
-            Dimmed.BindValueChanged(_ => updateState(), true);
+            Dimmed.BindValueChanged(_ => updateState());
+            playButton.Playing.BindValueChanged(_ => updateState(), true);
             FinishTransforms(true);
         }
 
         private void updateState()
         {
-            playButton.FadeTo(Dimmed.Value ? 1 : 0, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
-            cover.FadeColour(Dimmed.Value ? OsuColour.Gray(0.2f) : Color4.White, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
+            bool shouldDim = Dimmed.Value || playButton.Playing.Value;
+
+            playButton.FadeTo(shouldDim ? 1 : 0, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
+            cover.FadeColour(shouldDim ? OsuColour.Gray(0.2f) : Color4.White, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
         }
     }
 }
diff --git a/osu.Game/Beatmaps/Drawables/Cards/Buttons/PlayButton.cs b/osu.Game/Beatmaps/Drawables/Cards/Buttons/PlayButton.cs
index c1cbac1c59..c48999ed1a 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/Buttons/PlayButton.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/Buttons/PlayButton.cs
@@ -2,6 +2,7 @@
 // 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.Sprites;
 using osu.Game.Graphics;
@@ -12,17 +13,30 @@ namespace osu.Game.Beatmaps.Drawables.Cards.Buttons
 {
     public class PlayButton : OsuHoverContainer
     {
-        public PlayButton()
+        public BindableBool Playing { get; } = new BindableBool();
+
+        private readonly BeatmapSetInfo beatmapSetInfo;
+
+        private readonly SpriteIcon icon;
+
+        public PlayButton(BeatmapSetInfo beatmapSetInfo)
         {
+            this.beatmapSetInfo = beatmapSetInfo;
+
             Anchor = Origin = Anchor.Centre;
 
-            Child = new SpriteIcon
+            Children = new Drawable[]
             {
-                Anchor = Anchor.Centre,
-                Origin = Anchor.Centre,
-                Icon = FontAwesome.Solid.Play,
-                Size = new Vector2(14)
+                icon = new SpriteIcon
+                {
+                    Anchor = Anchor.Centre,
+                    Origin = Anchor.Centre,
+                    Icon = FontAwesome.Solid.Play,
+                    Size = new Vector2(14)
+                },
             };
+
+            Action = () => Playing.Toggle();
         }
 
         [BackgroundDependencyLoader]
@@ -30,5 +44,17 @@ namespace osu.Game.Beatmaps.Drawables.Cards.Buttons
         {
             HoverColour = colours.Yellow;
         }
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            Playing.BindValueChanged(_ => updateState(), true);
+        }
+
+        private void updateState()
+        {
+            icon.Icon = Playing.Value ? FontAwesome.Solid.Stop : FontAwesome.Solid.Play;
+        }
     }
 }

From 1a1603f0dba556e30a598a1deabe468a3455d810 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 23 Oct 2021 19:27:07 +0200
Subject: [PATCH 1207/5547] Implement preview track playback

---
 .../Beatmaps/TestSceneBeatmapCardThumbnail.cs |  7 +-
 .../Beatmaps/Drawables/Cards/BeatmapCard.cs   |  5 +-
 .../Drawables/Cards/BeatmapCardThumbnail.cs   | 49 ++++++++--
 .../Drawables/Cards/Buttons/PlayButton.cs     | 92 ++++++++++++++++++-
 4 files changed, 135 insertions(+), 18 deletions(-)

diff --git a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCardThumbnail.cs b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCardThumbnail.cs
index 73424241cb..59df0dc7ca 100644
--- a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCardThumbnail.cs
+++ b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCardThumbnail.cs
@@ -41,6 +41,7 @@ namespace osu.Game.Tests.Visual.Beatmaps
                 InputManager.MoveMouseTo(playButton);
                 InputManager.Click(MouseButton.Left);
             });
+            AddUntilStep("wait for start", () => playButton.Playing.Value && playButton.Enabled.Value);
             iconIs(FontAwesome.Solid.Stop);
 
             AddStep("click again", () =>
@@ -48,6 +49,7 @@ namespace osu.Game.Tests.Visual.Beatmaps
                 InputManager.MoveMouseTo(playButton);
                 InputManager.Click(MouseButton.Left);
             });
+            AddUntilStep("wait for stop", () => !playButton.Playing.Value && playButton.Enabled.Value);
             iconIs(FontAwesome.Solid.Play);
 
             AddStep("click again", () =>
@@ -55,16 +57,17 @@ namespace osu.Game.Tests.Visual.Beatmaps
                 InputManager.MoveMouseTo(playButton);
                 InputManager.Click(MouseButton.Left);
             });
+            AddUntilStep("wait for start", () => playButton.Playing.Value && playButton.Enabled.Value);
             iconIs(FontAwesome.Solid.Stop);
 
             AddStep("disable dim", () => thumbnail.Dimmed.Value = false);
             AddWaitStep("wait some", 3);
             AddAssert("button still visible", () => playButton.IsPresent);
 
-            AddStep("end track playback", () => playButton.Playing.Value = false);
+            AddUntilStep("wait for track to end", () => !playButton.Playing.Value);
             AddUntilStep("button hidden", () => !playButton.IsPresent);
         }
 
-        private void iconIs(IconUsage usage) => AddAssert("icon is correct", () => playButton.ChildrenOfType<SpriteIcon>().Single().Icon.Equals(usage));
+        private void iconIs(IconUsage usage) => AddUntilStep("icon is correct", () => playButton.ChildrenOfType<SpriteIcon>().Any(icon => icon.Icon.Equals(usage)));
     }
 }
diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
index d52e8f6c20..4ffad0f065 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
@@ -101,6 +101,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                 {
                     Name = @"Left (icon) area",
                     Size = new Vector2(height),
+                    Padding = new MarginPadding { Right = corner_radius },
                     Child = leftIconArea = new FillFlowContainer
                     {
                         Margin = new MarginPadding(5),
@@ -310,10 +311,10 @@ namespace osu.Game.Beatmaps.Drawables.Cards
             };
 
             if (beatmapSet.HasVideo)
-                leftIconArea.Add(new IconPill(FontAwesome.Solid.Film));
+                leftIconArea.Add(new IconPill(FontAwesome.Solid.Film) { IconSize = new Vector2(20) });
 
             if (beatmapSet.HasStoryboard)
-                leftIconArea.Add(new IconPill(FontAwesome.Solid.Image));
+                leftIconArea.Add(new IconPill(FontAwesome.Solid.Image) { IconSize = new Vector2(20) });
 
             if (beatmapSet.HasExplicitContent)
             {
diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardThumbnail.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardThumbnail.cs
index ce1f856b84..f11a5916e1 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardThumbnail.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardThumbnail.cs
@@ -1,12 +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 osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Beatmaps.Drawables.Cards.Buttons;
 using osu.Game.Graphics;
 using osu.Game.Online.API.Requests.Responses;
+using osu.Game.Overlays;
+using osu.Game.Screens.Ranking.Expanded.Accuracy;
+using osuTK;
 using osuTK.Graphics;
 
 namespace osu.Game.Beatmaps.Drawables.Cards
@@ -15,18 +19,22 @@ namespace osu.Game.Beatmaps.Drawables.Cards
     {
         public BindableBool Dimmed { get; } = new BindableBool();
 
-        private readonly APIBeatmapSet beatmapSetInfo;
+        public new MarginPadding Padding
+        {
+            get => foreground.Padding;
+            set => foreground.Padding = value;
+        }
 
         private readonly UpdateableOnlineBeatmapSetCover cover;
+        private readonly Container foreground;
         private readonly PlayButton playButton;
+        private readonly SmoothCircularProgress progress;
         private readonly Container content;
 
         protected override Container<Drawable> Content => content;
 
         public BeatmapCardThumbnail(APIBeatmapSet beatmapSetInfo)
         {
-            this.beatmapSetInfo = beatmapSetInfo;
-
             InternalChildren = new Drawable[]
             {
                 cover = new UpdateableOnlineBeatmapSetCover(BeatmapSetCoverType.List)
@@ -34,22 +42,45 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                     RelativeSizeAxes = Axes.Both,
                     OnlineInfo = beatmapSetInfo
                 },
-                playButton = new PlayButton(beatmapSetInfo)
+                foreground = new Container
                 {
-                    RelativeSizeAxes = Axes.Both
-                },
-                content = new Container
-                {
-                    RelativeSizeAxes = Axes.Both
+                    RelativeSizeAxes = Axes.Both,
+                    Children = new Drawable[]
+                    {
+                        playButton = new PlayButton(beatmapSetInfo)
+                        {
+                            RelativeSizeAxes = Axes.Both
+                        },
+                        progress = new SmoothCircularProgress
+                        {
+                            Anchor = Anchor.Centre,
+                            Origin = Anchor.Centre,
+                            Size = new Vector2(50),
+                            InnerRadius = 0.2f
+                        },
+                        content = new Container
+                        {
+                            RelativeSizeAxes = Axes.Both
+                        }
+                    }
                 }
             };
         }
 
+        [BackgroundDependencyLoader]
+        private void load(OverlayColourProvider colourProvider)
+        {
+            progress.Colour = colourProvider.Highlight1;
+        }
+
         protected override void LoadComplete()
         {
             base.LoadComplete();
             Dimmed.BindValueChanged(_ => updateState());
+
             playButton.Playing.BindValueChanged(_ => updateState(), true);
+            ((IBindable<double>)progress.Current).BindTo(playButton.Progress);
+
             FinishTransforms(true);
         }
 
diff --git a/osu.Game/Beatmaps/Drawables/Cards/Buttons/PlayButton.cs b/osu.Game/Beatmaps/Drawables/Cards/Buttons/PlayButton.cs
index c48999ed1a..4574d37da0 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/Buttons/PlayButton.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/Buttons/PlayButton.cs
@@ -1,25 +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.
 
+#nullable enable
+
+using System.Collections.Generic;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
+using osu.Framework.Extensions.IEnumerableExtensions;
 using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Sprites;
+using osu.Game.Audio;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
+using osu.Game.Graphics.UserInterface;
 using osuTK;
 
 namespace osu.Game.Beatmaps.Drawables.Cards.Buttons
 {
     public class PlayButton : OsuHoverContainer
     {
+        public IBindable<double> Progress => progress;
+        private readonly BindableDouble progress = new BindableDouble();
+
         public BindableBool Playing { get; } = new BindableBool();
 
-        private readonly BeatmapSetInfo beatmapSetInfo;
+        private readonly IBeatmapSetInfo beatmapSetInfo;
+
+        protected override IEnumerable<Drawable> EffectTargets => icon.Yield();
 
         private readonly SpriteIcon icon;
+        private readonly LoadingSpinner loadingSpinner;
 
-        public PlayButton(BeatmapSetInfo beatmapSetInfo)
+        [Resolved]
+        private PreviewTrackManager previewTrackManager { get; set; } = null!;
+
+        private PreviewTrack? previewTrack;
+
+        public PlayButton(IBeatmapSetInfo beatmapSetInfo)
         {
             this.beatmapSetInfo = beatmapSetInfo;
 
@@ -34,6 +52,10 @@ namespace osu.Game.Beatmaps.Drawables.Cards.Buttons
                     Icon = FontAwesome.Solid.Play,
                     Size = new Vector2(14)
                 },
+                loadingSpinner = new LoadingSpinner
+                {
+                    Size = new Vector2(14)
+                }
             };
 
             Action = () => Playing.Toggle();
@@ -49,12 +71,72 @@ namespace osu.Game.Beatmaps.Drawables.Cards.Buttons
         {
             base.LoadComplete();
 
-            Playing.BindValueChanged(_ => updateState(), true);
+            Playing.BindValueChanged(updateState, true);
         }
 
-        private void updateState()
+        protected override void Update()
         {
-            icon.Icon = Playing.Value ? FontAwesome.Solid.Stop : FontAwesome.Solid.Play;
+            base.Update();
+
+            if (Playing.Value && previewTrack != null && previewTrack.TrackLoaded)
+                progress.Value = previewTrack.CurrentTime / previewTrack.Length;
+            else
+                progress.Value = 0;
+        }
+
+        private void updateState(ValueChangedEvent<bool> playing)
+        {
+            icon.Icon = playing.NewValue ? FontAwesome.Solid.Stop : FontAwesome.Solid.Play;
+
+            if (!playing.NewValue)
+            {
+                stopPreview();
+                return;
+            }
+
+            if (previewTrack == null)
+            {
+                toggleLoading(true);
+                LoadComponentAsync(previewTrack = previewTrackManager.Get(beatmapSetInfo), onPreviewLoaded);
+            }
+            else
+                tryStartPreview();
+        }
+
+        private void stopPreview()
+        {
+            toggleLoading(false);
+            Playing.Value = false;
+            previewTrack?.Stop();
+        }
+
+        private void onPreviewLoaded(PreviewTrack loadedPreview)
+        {
+            // another async load might have completed before this one.
+            // if so, do not make any changes.
+            if (loadedPreview != previewTrack)
+                return;
+
+            AddInternal(loadedPreview);
+            toggleLoading(false);
+
+            loadedPreview.Stopped += () => Schedule(() => Playing.Value = false);
+
+            if (Playing.Value)
+                tryStartPreview();
+        }
+
+        private void tryStartPreview()
+        {
+            if (previewTrack?.Start() == false)
+                Playing.Value = false;
+        }
+
+        private void toggleLoading(bool loading)
+        {
+            Enabled.Value = !loading;
+            icon.FadeTo(loading ? 0 : 1, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
+            loadingSpinner.State.Value = loading ? Visibility.Visible : Visibility.Hidden;
         }
     }
 }

From e67d9b1c2153c068a762820b866372818a2c5405 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 24 Nov 2021 12:14:52 +0900
Subject: [PATCH 1208/5547] Reorder members a bit

---
 .../Preprocessing/OsuDifficultyHitObject.cs   | 26 +++++++++----------
 1 file changed, 13 insertions(+), 13 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
index d073d751d0..5c163eeb76 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
@@ -18,6 +18,11 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
 
         protected new OsuHitObject BaseObject => (OsuHitObject)base.BaseObject;
 
+        /// <summary>
+        /// Milliseconds elapsed since the start time of the previous <see cref="OsuDifficultyHitObject"/>, with a minimum of 25ms.
+        /// </summary>
+        public readonly double StrainTime;
+
         /// <summary>
         /// Normalized distance from the end position of the previous <see cref="OsuDifficultyHitObject"/> to the start position of this <see cref="OsuDifficultyHitObject"/>.
         /// </summary>
@@ -28,31 +33,26 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
         /// </summary>
         public double MovementDistance { get; private set; }
 
-        /// <summary>
-        /// Normalized distance between the start and end position of the previous <see cref="OsuDifficultyHitObject"/>.
-        /// </summary>
-        public double TravelDistance { get; private set; }
-
-        /// <summary>
-        /// Angle the player has to take to hit this <see cref="OsuDifficultyHitObject"/>.
-        /// Calculated as the angle between the circles (current-2, current-1, current).
-        /// </summary>
-        public double? Angle { get; private set; }
-
         /// <summary>
         /// Milliseconds elapsed since the end time of the previous <see cref="OsuDifficultyHitObject"/>, with a minimum of 25ms.
         /// </summary>
         public double MovementTime { get; private set; }
 
+        /// <summary>
+        /// Normalized distance between the start and end position of the previous <see cref="OsuDifficultyHitObject"/>.
+        /// </summary>
+        public double TravelDistance { get; private set; }
+
         /// <summary>
         /// Milliseconds elapsed since the start time of the previous <see cref="OsuDifficultyHitObject"/> to the end time of the same previous <see cref="OsuDifficultyHitObject"/>, with a minimum of 25ms.
         /// </summary>
         public double TravelTime { get; private set; }
 
         /// <summary>
-        /// Milliseconds elapsed since the start time of the previous <see cref="OsuDifficultyHitObject"/>, with a minimum of 25ms.
+        /// Angle the player has to take to hit this <see cref="OsuDifficultyHitObject"/>.
+        /// Calculated as the angle between the circles (current-2, current-1, current).
         /// </summary>
-        public readonly double StrainTime;
+        public double? Angle { get; private set; }
 
         private readonly OsuHitObject lastLastObject;
         private readonly OsuHitObject lastObject;

From 8d69ebd7db4bdd6b5a70797d633d7c6922416110 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 23 Nov 2021 20:17:07 +0900
Subject: [PATCH 1209/5547] Remove nullability of `Ruleset.CreateInstance`

---
 osu.Game/Models/RealmRuleset.cs   | 22 ++++++++++++++++++++++
 osu.Game/Rulesets/IRulesetInfo.cs | 17 +----------------
 osu.Game/Rulesets/RulesetInfo.cs  | 14 +++++++++++---
 3 files changed, 34 insertions(+), 19 deletions(-)

diff --git a/osu.Game/Models/RealmRuleset.cs b/osu.Game/Models/RealmRuleset.cs
index 5d70324713..5c18a10527 100644
--- a/osu.Game/Models/RealmRuleset.cs
+++ b/osu.Game/Models/RealmRuleset.cs
@@ -60,5 +60,27 @@ namespace osu.Game.Models
             InstantiationInfo = InstantiationInfo,
             Available = Available
         };
+
+        public Ruleset CreateInstance()
+        {
+            if (!Available)
+                throw new RulesetLoadException(@"Ruleset not available");
+
+            var type = Type.GetType(InstantiationInfo);
+
+            if (type == null)
+                throw new RulesetLoadException(@"Type lookup failure");
+
+            var ruleset = Activator.CreateInstance(type) as Ruleset;
+
+            if (ruleset == null)
+                throw new RulesetLoadException(@"Instantiation failure");
+
+            // overwrite the pre-populated RulesetInfo with a potentially database attached copy.
+            // TODO: figure if we still want/need this after switching to realm.
+            // ruleset.RulesetInfo = this;
+
+            return ruleset;
+        }
     }
 }
diff --git a/osu.Game/Rulesets/IRulesetInfo.cs b/osu.Game/Rulesets/IRulesetInfo.cs
index c3bc6c1995..4e529a73fb 100644
--- a/osu.Game/Rulesets/IRulesetInfo.cs
+++ b/osu.Game/Rulesets/IRulesetInfo.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.Game.Database;
 
 #nullable enable
@@ -28,20 +27,6 @@ namespace osu.Game.Rulesets
         /// </summary>
         string InstantiationInfo { get; }
 
-        Ruleset? CreateInstance()
-        {
-            var type = Type.GetType(InstantiationInfo);
-
-            if (type == null)
-                return null;
-
-            var ruleset = Activator.CreateInstance(type) as Ruleset;
-
-            // overwrite the pre-populated RulesetInfo with a potentially database attached copy.
-            // TODO: figure if we still want/need this after switching to realm.
-            // ruleset.RulesetInfo = this;
-
-            return ruleset;
-        }
+        Ruleset CreateInstance();
     }
 }
diff --git a/osu.Game/Rulesets/RulesetInfo.cs b/osu.Game/Rulesets/RulesetInfo.cs
index ccb614fe91..77be39650f 100644
--- a/osu.Game/Rulesets/RulesetInfo.cs
+++ b/osu.Game/Rulesets/RulesetInfo.cs
@@ -4,7 +4,6 @@
 using System;
 using System.Diagnostics.CodeAnalysis;
 using Newtonsoft.Json;
-using osu.Framework.Extensions.ObjectExtensions;
 using osu.Framework.Testing;
 
 namespace osu.Game.Rulesets
@@ -26,9 +25,18 @@ namespace osu.Game.Rulesets
         // TODO: this should probably be moved to RulesetStore.
         public Ruleset CreateInstance()
         {
-            if (!Available) return null;
+            if (!Available)
+                throw new RulesetLoadException(@"Ruleset not available");
 
-            var ruleset = (Ruleset)Activator.CreateInstance(Type.GetType(InstantiationInfo).AsNonNull());
+            var type = Type.GetType(InstantiationInfo);
+
+            if (type == null)
+                throw new RulesetLoadException(@"Type lookup failure");
+
+            var ruleset = Activator.CreateInstance(type) as Ruleset;
+
+            if (ruleset == null)
+                throw new RulesetLoadException(@"Instantiation failure");
 
             // overwrite the pre-populated RulesetInfo with a potentially database attached copy.
             ruleset.RulesetInfo = this;

From 0eea026afb36d96e37bf2c7f91be38afc61bd494 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 24 Nov 2021 12:22:13 +0900
Subject: [PATCH 1210/5547] Remove null checks on `CreateInstance()` calls

---
 osu.Game/Beatmaps/Drawables/DifficultySpectrumDisplay.cs       | 2 +-
 .../Overlays/Settings/Sections/Input/RulesetBindingsSection.cs | 2 +-
 osu.Game/Screens/Edit/Setup/SetupScreen.cs                     | 2 +-
 osu.Game/Screens/Edit/Verify/IssueList.cs                      | 2 +-
 osu.Game/Stores/BeatmapImporter.cs                             | 3 ---
 5 files changed, 4 insertions(+), 7 deletions(-)

diff --git a/osu.Game/Beatmaps/Drawables/DifficultySpectrumDisplay.cs b/osu.Game/Beatmaps/Drawables/DifficultySpectrumDisplay.cs
index 1feaa88350..f4501f0633 100644
--- a/osu.Game/Beatmaps/Drawables/DifficultySpectrumDisplay.cs
+++ b/osu.Game/Beatmaps/Drawables/DifficultySpectrumDisplay.cs
@@ -117,7 +117,7 @@ namespace osu.Game.Beatmaps.Drawables
                 Spacing = new Vector2(1, 0);
                 Direction = FillDirection.Horizontal;
 
-                var icon = rulesets.GetRuleset(rulesetId)?.CreateInstance()?.CreateIcon() ?? new SpriteIcon { Icon = FontAwesome.Regular.QuestionCircle };
+                var icon = rulesets.GetRuleset(rulesetId)?.CreateInstance().CreateIcon() ?? new SpriteIcon { Icon = FontAwesome.Regular.QuestionCircle };
                 Add(icon.With(i =>
                 {
                     i.Size = new Vector2(14);
diff --git a/osu.Game/Overlays/Settings/Sections/Input/RulesetBindingsSection.cs b/osu.Game/Overlays/Settings/Sections/Input/RulesetBindingsSection.cs
index 48cbe1b59e..b5d26d4887 100644
--- a/osu.Game/Overlays/Settings/Sections/Input/RulesetBindingsSection.cs
+++ b/osu.Game/Overlays/Settings/Sections/Input/RulesetBindingsSection.cs
@@ -11,7 +11,7 @@ namespace osu.Game.Overlays.Settings.Sections.Input
 {
     public class RulesetBindingsSection : SettingsSection
     {
-        public override Drawable CreateIcon() => ruleset?.CreateInstance()?.CreateIcon() ?? new SpriteIcon
+        public override Drawable CreateIcon() => ruleset?.CreateInstance().CreateIcon() ?? new SpriteIcon
         {
             Icon = OsuIcon.Hot
         };
diff --git a/osu.Game/Screens/Edit/Setup/SetupScreen.cs b/osu.Game/Screens/Edit/Setup/SetupScreen.cs
index 04767f1786..8d726f7752 100644
--- a/osu.Game/Screens/Edit/Setup/SetupScreen.cs
+++ b/osu.Game/Screens/Edit/Setup/SetupScreen.cs
@@ -33,7 +33,7 @@ namespace osu.Game.Screens.Edit.Setup
                 new DesignSection(),
             };
 
-            var rulesetSpecificSection = beatmap.BeatmapInfo.Ruleset?.CreateInstance()?.CreateEditorSetupSection();
+            var rulesetSpecificSection = beatmap.BeatmapInfo.Ruleset?.CreateInstance().CreateEditorSetupSection();
             if (rulesetSpecificSection != null)
                 sectionsEnumerable.Add(rulesetSpecificSection);
 
diff --git a/osu.Game/Screens/Edit/Verify/IssueList.cs b/osu.Game/Screens/Edit/Verify/IssueList.cs
index 0b1f988447..fd238feeac 100644
--- a/osu.Game/Screens/Edit/Verify/IssueList.cs
+++ b/osu.Game/Screens/Edit/Verify/IssueList.cs
@@ -43,7 +43,7 @@ namespace osu.Game.Screens.Edit.Verify
         private void load(OverlayColourProvider colours)
         {
             generalVerifier = new BeatmapVerifier();
-            rulesetVerifier = beatmap.BeatmapInfo.Ruleset?.CreateInstance()?.CreateBeatmapVerifier();
+            rulesetVerifier = beatmap.BeatmapInfo.Ruleset?.CreateInstance().CreateBeatmapVerifier();
 
             context = new BeatmapVerifierContext(beatmap, workingBeatmap.Value, verify.InterpretedDifficulty.Value);
             verify.InterpretedDifficulty.BindValueChanged(difficulty => context.InterpretedDifficulty = difficulty.NewValue);
diff --git a/osu.Game/Stores/BeatmapImporter.cs b/osu.Game/Stores/BeatmapImporter.cs
index 32f0cd3d7a..8ab6941885 100644
--- a/osu.Game/Stores/BeatmapImporter.cs
+++ b/osu.Game/Stores/BeatmapImporter.cs
@@ -282,9 +282,6 @@ namespace osu.Game.Stores
         {
             var rulesetInstance = ((IRulesetInfo)beatmap.Ruleset).CreateInstance();
 
-            if (rulesetInstance == null)
-                return;
-
             decoded.BeatmapInfo.Ruleset = rulesetInstance.RulesetInfo;
 
             // TODO: this should be done in a better place once we actually need to dynamically update it.

From 6cd1bfd94fc01ad76d9fee3d4c08de5bfc31559a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 24 Nov 2021 12:35:05 +0900
Subject: [PATCH 1211/5547] Remove outdated comment

---
 osu.Game/Database/RealmContextFactory.cs | 1 -
 1 file changed, 1 deletion(-)

diff --git a/osu.Game/Database/RealmContextFactory.cs b/osu.Game/Database/RealmContextFactory.cs
index 760b154397..f48e11da8d 100644
--- a/osu.Game/Database/RealmContextFactory.cs
+++ b/osu.Game/Database/RealmContextFactory.cs
@@ -200,7 +200,6 @@ namespace osu.Game.Database
                             {
                                 Key = dkb.Key,
                                 Value = dkb.StringValue,
-                                // important: this RulesetStore must be the EF one.
                                 RulesetName = shortName,
                                 Variant = dkb.Variant ?? 0,
                             });

From 63b09b356f4dad79198a211aa473862289db5679 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 24 Nov 2021 12:37:09 +0900
Subject: [PATCH 1212/5547] Rewrite commments to read better

---
 osu.Game/Database/RealmContextFactory.cs | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Database/RealmContextFactory.cs b/osu.Game/Database/RealmContextFactory.cs
index f48e11da8d..6f979a0f91 100644
--- a/osu.Game/Database/RealmContextFactory.cs
+++ b/osu.Game/Database/RealmContextFactory.cs
@@ -95,9 +95,11 @@ namespace osu.Game.Database
             if (!Filename.EndsWith(realm_extension, StringComparison.Ordinal))
                 Filename += realm_extension;
 
+            // This method triggers the first `CreateContext` call, which will implicitly run realm migrations and bring the schema up-to-date.
             cleanupPendingDeletions();
 
-            // run after the above operation to ensure realm is already in a good (fully migrated) state.
+            // Data migration is handled separately from schema migrations.
+            // This is required as the user may be initialising realm for the first time ever, which would result in no schema migrations running.
             migrateDataFromEF();
         }
 

From 402de754f7f459fc48fd0d86a88c5f708a03a2c9 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 24 Nov 2021 12:37:16 +0900
Subject: [PATCH 1213/5547] Make TravelDistance/TravelTime apply to the current
 object

---
 .../Preprocessing/OsuDifficultyHitObject.cs   | 27 ++++++++++---------
 .../Difficulty/Skills/Aim.cs                  | 12 ++++-----
 .../Difficulty/Skills/Speed.cs                |  3 ++-
 3 files changed, 23 insertions(+), 19 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
index 5c163eeb76..eb36e96995 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
@@ -39,12 +39,12 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
         public double MovementTime { get; private set; }
 
         /// <summary>
-        /// Normalized distance between the start and end position of the previous <see cref="OsuDifficultyHitObject"/>.
+        /// Normalized distance between the start and end position of this <see cref="OsuDifficultyHitObject"/>.
         /// </summary>
         public double TravelDistance { get; private set; }
 
         /// <summary>
-        /// Milliseconds elapsed since the start time of the previous <see cref="OsuDifficultyHitObject"/> to the end time of the same previous <see cref="OsuDifficultyHitObject"/>, with a minimum of 25ms.
+        /// Milliseconds elapsed between the start and end time of this <see cref="OsuDifficultyHitObject"/>, with a minimum of 25ms.
         /// </summary>
         public double TravelTime { get; private set; }
 
@@ -84,15 +84,23 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
                 scalingFactor *= 1 + smallCircleBonus;
             }
 
+            if (BaseObject is Slider currentSlider)
+            {
+                computeSliderCursorPosition(currentSlider);
+                TravelDistance = currentSlider.LazyTravelDistance;
+                TravelTime = Math.Max(currentSlider.LazyTravelTime / clockRate, min_delta_time);
+            }
+
             Vector2 lastCursorPosition = getEndCursorPosition(lastObject);
+
             JumpDistance = (BaseObject.StackedPosition * scalingFactor - lastCursorPosition * scalingFactor).Length;
+            MovementTime = StrainTime;
+            MovementDistance = JumpDistance;
 
             if (lastObject is Slider lastSlider)
             {
-                computeSliderCursorPosition(lastSlider);
-                TravelDistance = lastSlider.LazyTravelDistance;
-                TravelTime = Math.Max(lastSlider.LazyTravelTime / clockRate, min_delta_time);
-                MovementTime = Math.Max(StrainTime - TravelTime, min_delta_time);
+                double lastTravelTime = Math.Max(lastSlider.LazyTravelTime / clockRate, min_delta_time);
+                MovementTime = Math.Max(MovementTime - lastTravelTime, min_delta_time);
 
                 // Jump distance from the slider tail to the next object, as opposed to the lazy position of JumpDistance.
                 float tailJumpDistance = Vector2.Subtract(lastSlider.TailCircle.StackedPosition, BaseObject.StackedPosition).Length * scalingFactor;
@@ -102,12 +110,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
                 // In such cases, a leniency is applied by also considering the jump distance from the tail of the slider, and taking the minimum jump distance.
                 // Additional distance is removed based on position of jump relative to slider follow circle radius.
                 // JumpDistance is the leniency distance beyond the assumed_slider_radius. tailJumpDistance is maximum_slider_radius since the full distance of radial leniency is still possible.
-                MovementDistance = Math.Max(0, Math.Min(JumpDistance - (maximum_slider_radius - assumed_slider_radius), tailJumpDistance - maximum_slider_radius));
-            }
-            else
-            {
-                MovementTime = StrainTime;
-                MovementDistance = JumpDistance;
+                MovementDistance = Math.Max(0, Math.Min(MovementDistance - (maximum_slider_radius - assumed_slider_radius), tailJumpDistance - maximum_slider_radius));
             }
 
             if (lastLastObject != null && !(lastLastObject is Spinner))
diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
index 2a8d2ce759..4ddcbb7770 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
@@ -50,7 +50,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
             if (osuLastObj.BaseObject is Slider && withSliders)
             {
                 double movementVelocity = osuCurrObj.MovementDistance / osuCurrObj.MovementTime; // calculate the movement velocity from slider end to current object
-                double travelVelocity = osuCurrObj.TravelDistance / osuCurrObj.TravelTime; // calculate the slider velocity from slider head to slider end.
+                double travelVelocity = osuLastObj.TravelDistance / osuLastObj.TravelTime; // calculate the slider velocity from slider head to slider end.
 
                 currVelocity = Math.Max(currVelocity, movementVelocity + travelVelocity); // take the larger total combined velocity.
             }
@@ -61,7 +61,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
             if (osuLastLastObj.BaseObject is Slider && withSliders)
             {
                 double movementVelocity = osuLastObj.MovementDistance / osuLastObj.MovementTime;
-                double travelVelocity = osuLastObj.TravelDistance / osuLastObj.TravelTime;
+                double travelVelocity = osuLastLastObj.TravelDistance / osuLastLastObj.TravelTime;
 
                 prevVelocity = Math.Max(prevVelocity, movementVelocity + travelVelocity);
             }
@@ -107,8 +107,8 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
             if (Math.Max(prevVelocity, currVelocity) != 0)
             {
                 // We want to use the average velocity over the whole object when awarding differences, not the individual jump and slider path velocities.
-                prevVelocity = (osuLastObj.JumpDistance + osuLastObj.TravelDistance) / osuLastObj.StrainTime;
-                currVelocity = (osuCurrObj.JumpDistance + osuCurrObj.TravelDistance) / osuCurrObj.StrainTime;
+                prevVelocity = (osuLastObj.JumpDistance + osuLastLastObj.TravelDistance) / osuLastObj.StrainTime;
+                currVelocity = (osuCurrObj.JumpDistance + osuLastObj.TravelDistance) / osuCurrObj.StrainTime;
 
                 // Scale with ratio of difference compared to 0.5 * max dist.
                 double distRatio = Math.Pow(Math.Sin(Math.PI / 2 * Math.Abs(prevVelocity - currVelocity) / Math.Max(prevVelocity, currVelocity)), 2);
@@ -128,10 +128,10 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
                 velocityChangeBonus *= Math.Pow(Math.Min(osuCurrObj.StrainTime, osuLastObj.StrainTime) / Math.Max(osuCurrObj.StrainTime, osuLastObj.StrainTime), 2);
             }
 
-            if (osuCurrObj.TravelTime != 0)
+            if (osuLastObj.TravelTime != 0)
             {
                 // Reward sliders based on velocity.
-                sliderBonus = osuCurrObj.TravelDistance / osuCurrObj.TravelTime;
+                sliderBonus = osuLastObj.TravelDistance / osuLastObj.TravelTime;
             }
 
             // Add in acute angle bonus or wide angle bonus + velocity change bonus, whichever is larger.
diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Speed.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Speed.cs
index 24881d9c47..b53d287ee6 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Speed.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Speed.cs
@@ -154,7 +154,8 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
             if (strainTime < min_speed_bonus)
                 speedBonus = 1 + 0.75 * Math.Pow((min_speed_bonus - strainTime) / speed_balancing_factor, 2);
 
-            double distance = Math.Min(single_spacing_threshold, osuCurrObj.TravelDistance + osuCurrObj.JumpDistance);
+            double travelDistance = osuPrevObj?.TravelDistance ?? 0;
+            double distance = Math.Min(single_spacing_threshold, travelDistance + osuCurrObj.JumpDistance);
 
             return (speedBonus + speedBonus * Math.Pow(distance / single_spacing_threshold, 3.5)) / strainTime;
         }

From 729f6819381faafad4d2611f6d0ca0ad4491dccd Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 24 Nov 2021 12:49:57 +0900
Subject: [PATCH 1214/5547] Update cases where equality can be used instead of
 primary key equality

---
 osu.Game.Tests/Scores/IO/ImportScoreTest.cs            |  2 +-
 .../Visual/Navigation/TestScenePresentBeatmap.cs       |  4 ++--
 .../Visual/Navigation/TestScenePresentScore.cs         |  8 ++++----
 osu.Game/Beatmaps/BeatmapDifficultyCache.cs            |  4 ++--
 osu.Game/Beatmaps/BeatmapModelManager.cs               |  2 +-
 osu.Game/Beatmaps/WorkingBeatmapCache.cs               |  4 ++--
 osu.Game/OsuGameBase.cs                                |  2 +-
 osu.Game/Overlays/Music/PlaylistOverlay.cs             |  2 +-
 osu.Game/Overlays/MusicController.cs                   | 10 +++++-----
 .../Header/Components/ProfileRulesetSelector.cs        |  2 +-
 osu.Game/Overlays/Settings/Sections/SkinSection.cs     |  2 +-
 osu.Game/Screens/Select/BeatmapCarousel.cs             |  4 ++--
 12 files changed, 23 insertions(+), 23 deletions(-)

diff --git a/osu.Game.Tests/Scores/IO/ImportScoreTest.cs b/osu.Game.Tests/Scores/IO/ImportScoreTest.cs
index be7803734e..0dee0f89ea 100644
--- a/osu.Game.Tests/Scores/IO/ImportScoreTest.cs
+++ b/osu.Game.Tests/Scores/IO/ImportScoreTest.cs
@@ -142,7 +142,7 @@ namespace osu.Game.Tests.Scores.IO
                     var scoreManager = osu.Dependencies.Get<ScoreManager>();
 
                     beatmapManager.Delete(beatmapManager.QueryBeatmapSet(s => s.Beatmaps.Any(b => b.ID == imported.BeatmapInfo.ID)));
-                    Assert.That(scoreManager.Query(s => s.ID == imported.ID).DeletePending, Is.EqualTo(true));
+                    Assert.That(scoreManager.Query(s => s.Equals(imported)).DeletePending, Is.EqualTo(true));
 
                     var secondImport = await LoadScoreIntoOsu(osu, imported);
                     Assert.That(secondImport, Is.Null);
diff --git a/osu.Game.Tests/Visual/Navigation/TestScenePresentBeatmap.cs b/osu.Game.Tests/Visual/Navigation/TestScenePresentBeatmap.cs
index d1ee984682..22570b8567 100644
--- a/osu.Game.Tests/Visual/Navigation/TestScenePresentBeatmap.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestScenePresentBeatmap.cs
@@ -141,7 +141,7 @@ namespace osu.Game.Tests.Visual.Navigation
 
             AddUntilStep("wait for song select", () => Game.ScreenStack.CurrentScreen is Screens.Select.SongSelect);
             AddUntilStep("correct beatmap displayed", () => Game.Beatmap.Value.BeatmapSetInfo.MatchesOnlineID(getImport()));
-            AddAssert("correct ruleset selected", () => Game.Ruleset.Value.ID == getImport().Beatmaps.First().Ruleset.ID);
+            AddAssert("correct ruleset selected", () => Game.Ruleset.Value.Equals(getImport().Beatmaps.First().Ruleset));
         }
 
         private void presentSecondDifficultyAndConfirm(Func<BeatmapSetInfo> getImport, int importedID)
@@ -151,7 +151,7 @@ namespace osu.Game.Tests.Visual.Navigation
 
             AddUntilStep("wait for song select", () => Game.ScreenStack.CurrentScreen is Screens.Select.SongSelect);
             AddUntilStep("correct beatmap displayed", () => Game.Beatmap.Value.BeatmapInfo.OnlineID == importedID * 2048);
-            AddAssert("correct ruleset selected", () => Game.Ruleset.Value.ID == getImport().Beatmaps.First().Ruleset.ID);
+            AddAssert("correct ruleset selected", () => Game.Ruleset.Value.Equals(getImport().Beatmaps.First().Ruleset));
         }
     }
 }
diff --git a/osu.Game.Tests/Visual/Navigation/TestScenePresentScore.cs b/osu.Game.Tests/Visual/Navigation/TestScenePresentScore.cs
index 72f160c9a9..3b11a29962 100644
--- a/osu.Game.Tests/Visual/Navigation/TestScenePresentScore.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestScenePresentScore.cs
@@ -155,15 +155,15 @@ namespace osu.Game.Tests.Visual.Navigation
                 case ScorePresentType.Results:
                     AddUntilStep("wait for results", () => lastWaitedScreen != Game.ScreenStack.CurrentScreen && Game.ScreenStack.CurrentScreen is ResultsScreen);
                     AddStep("store last waited screen", () => lastWaitedScreen = Game.ScreenStack.CurrentScreen);
-                    AddUntilStep("correct score displayed", () => ((ResultsScreen)Game.ScreenStack.CurrentScreen).Score.ID == getImport().ID);
-                    AddAssert("correct ruleset selected", () => Game.Ruleset.Value.ID == getImport().Ruleset.ID);
+                    AddUntilStep("correct score displayed", () => ((ResultsScreen)Game.ScreenStack.CurrentScreen).Score.Equals(getImport()));
+                    AddAssert("correct ruleset selected", () => Game.Ruleset.Value.Equals(getImport().Ruleset));
                     break;
 
                 case ScorePresentType.Gameplay:
                     AddUntilStep("wait for player loader", () => lastWaitedScreen != Game.ScreenStack.CurrentScreen && Game.ScreenStack.CurrentScreen is ReplayPlayerLoader);
                     AddStep("store last waited screen", () => lastWaitedScreen = Game.ScreenStack.CurrentScreen);
-                    AddUntilStep("correct score displayed", () => ((ReplayPlayerLoader)Game.ScreenStack.CurrentScreen).Score.ID == getImport().ID);
-                    AddAssert("correct ruleset selected", () => Game.Ruleset.Value.ID == getImport().Ruleset.ID);
+                    AddUntilStep("correct score displayed", () => ((ReplayPlayerLoader)Game.ScreenStack.CurrentScreen).Score.Equals(getImport()));
+                    AddAssert("correct ruleset selected", () => Game.Ruleset.Value.Equals(getImport().Ruleset));
                     break;
             }
         }
diff --git a/osu.Game/Beatmaps/BeatmapDifficultyCache.cs b/osu.Game/Beatmaps/BeatmapDifficultyCache.cs
index f444b597c9..4d44b49218 100644
--- a/osu.Game/Beatmaps/BeatmapDifficultyCache.cs
+++ b/osu.Game/Beatmaps/BeatmapDifficultyCache.cs
@@ -340,8 +340,8 @@ namespace osu.Game.Beatmaps
             }
 
             public bool Equals(DifficultyCacheLookup other)
-                => BeatmapInfo.ID == other.BeatmapInfo.ID
-                   && Ruleset.ID == other.Ruleset.ID
+                => BeatmapInfo.Equals(other.BeatmapInfo)
+                   && Ruleset.Equals(other.Ruleset)
                    && OrderedMods.SequenceEqual(other.OrderedMods);
 
             public override int GetHashCode()
diff --git a/osu.Game/Beatmaps/BeatmapModelManager.cs b/osu.Game/Beatmaps/BeatmapModelManager.cs
index 8f55232031..46d6fc89bd 100644
--- a/osu.Game/Beatmaps/BeatmapModelManager.cs
+++ b/osu.Game/Beatmaps/BeatmapModelManager.cs
@@ -208,7 +208,7 @@ namespace osu.Game.Beatmaps
 
                 using (ContextFactory.GetForWrite())
                 {
-                    beatmapInfo = setInfo.Beatmaps.Single(b => b.ID == beatmapInfo.ID);
+                    beatmapInfo = setInfo.Beatmaps.Single(b => b.Equals(beatmapInfo));
 
                     var metadata = beatmapInfo.Metadata ?? setInfo.Metadata;
 
diff --git a/osu.Game/Beatmaps/WorkingBeatmapCache.cs b/osu.Game/Beatmaps/WorkingBeatmapCache.cs
index 0af28902a0..548f4a3d79 100644
--- a/osu.Game/Beatmaps/WorkingBeatmapCache.cs
+++ b/osu.Game/Beatmaps/WorkingBeatmapCache.cs
@@ -65,7 +65,7 @@ namespace osu.Game.Beatmaps
         {
             lock (workingCache)
             {
-                var working = workingCache.FirstOrDefault(w => w.BeatmapInfo?.ID == info.ID);
+                var working = workingCache.FirstOrDefault(w => info.Equals(w.BeatmapInfo));
 
                 if (working != null)
                 {
@@ -89,7 +89,7 @@ namespace osu.Game.Beatmaps
 
             lock (workingCache)
             {
-                var working = workingCache.FirstOrDefault(w => w.BeatmapInfo?.ID == beatmapInfo.ID);
+                var working = workingCache.FirstOrDefault(w => beatmapInfo.Equals(w.BeatmapInfo));
 
                 if (working != null)
                     return working;
diff --git a/osu.Game/OsuGameBase.cs b/osu.Game/OsuGameBase.cs
index 1890fd7d24..1f2dbf1054 100644
--- a/osu.Game/OsuGameBase.cs
+++ b/osu.Game/OsuGameBase.cs
@@ -214,7 +214,7 @@ namespace osu.Game
             SkinManager.ItemRemoved += item => Schedule(() =>
             {
                 // check the removed skin is not the current user choice. if it is, switch back to default.
-                if (item.ID == SkinManager.CurrentSkinInfo.Value.ID)
+                if (item.Equals(SkinManager.CurrentSkinInfo.Value))
                     SkinManager.CurrentSkinInfo.Value = SkinInfo.Default;
             });
 
diff --git a/osu.Game/Overlays/Music/PlaylistOverlay.cs b/osu.Game/Overlays/Music/PlaylistOverlay.cs
index b8d04eab4e..0f4806d9cf 100644
--- a/osu.Game/Overlays/Music/PlaylistOverlay.cs
+++ b/osu.Game/Overlays/Music/PlaylistOverlay.cs
@@ -114,7 +114,7 @@ namespace osu.Game.Overlays.Music
 
         private void itemSelected(BeatmapSetInfo set)
         {
-            if (set.ID == (beatmap.Value?.BeatmapSetInfo?.ID ?? -1))
+            if (set.Equals((beatmap.Value?.BeatmapSetInfo)))
             {
                 beatmap.Value?.Track.Seek(0);
                 return;
diff --git a/osu.Game/Overlays/MusicController.cs b/osu.Game/Overlays/MusicController.cs
index 829ff5be25..76358fca3f 100644
--- a/osu.Game/Overlays/MusicController.cs
+++ b/osu.Game/Overlays/MusicController.cs
@@ -111,7 +111,7 @@ namespace osu.Game.Overlays
             beatmapSets.Add(set);
         });
 
-        private void beatmapRemoved(BeatmapSetInfo set) => Schedule(() => beatmapSets.RemoveAll(s => s.ID == set.ID));
+        private void beatmapRemoved(BeatmapSetInfo set) => Schedule(() => beatmapSets.RemoveAll(s => s.Equals(set)));
 
         private ScheduledDelegate seekDelegate;
 
@@ -228,7 +228,7 @@ namespace osu.Game.Overlays
 
             queuedDirection = TrackChangeDirection.Prev;
 
-            var playable = BeatmapSets.TakeWhile(i => i.ID != current.BeatmapSetInfo.ID).LastOrDefault() ?? BeatmapSets.LastOrDefault();
+            var playable = BeatmapSets.TakeWhile(i => !i.Equals(current.BeatmapSetInfo)).LastOrDefault() ?? BeatmapSets.LastOrDefault();
 
             if (playable != null)
             {
@@ -259,7 +259,7 @@ namespace osu.Game.Overlays
 
             queuedDirection = TrackChangeDirection.Next;
 
-            var playable = BeatmapSets.SkipWhile(i => i.ID != current.BeatmapSetInfo.ID).ElementAtOrDefault(1) ?? BeatmapSets.FirstOrDefault();
+            var playable = BeatmapSets.SkipWhile(i => !i.Equals(current.BeatmapSetInfo)).ElementAtOrDefault(1) ?? BeatmapSets.FirstOrDefault();
 
             if (playable != null)
             {
@@ -309,8 +309,8 @@ namespace osu.Game.Overlays
                 else
                 {
                     // figure out the best direction based on order in playlist.
-                    int last = BeatmapSets.TakeWhile(b => b.ID != current.BeatmapSetInfo?.ID).Count();
-                    int next = newWorking == null ? -1 : BeatmapSets.TakeWhile(b => b.ID != newWorking.BeatmapSetInfo?.ID).Count();
+                    int last = BeatmapSets.TakeWhile(b => !b.Equals(current.BeatmapSetInfo)).Count();
+                    int next = newWorking == null ? -1 : BeatmapSets.TakeWhile(b => !b.Equals(newWorking.BeatmapSetInfo)).Count();
 
                     direction = last > next ? TrackChangeDirection.Prev : TrackChangeDirection.Next;
                 }
diff --git a/osu.Game/Overlays/Profile/Header/Components/ProfileRulesetSelector.cs b/osu.Game/Overlays/Profile/Header/Components/ProfileRulesetSelector.cs
index eaa9703834..4d2290266c 100644
--- a/osu.Game/Overlays/Profile/Header/Components/ProfileRulesetSelector.cs
+++ b/osu.Game/Overlays/Profile/Header/Components/ProfileRulesetSelector.cs
@@ -21,7 +21,7 @@ namespace osu.Game.Overlays.Profile.Header.Components
         public void SetDefaultRuleset(RulesetInfo ruleset)
         {
             foreach (var tabItem in TabContainer)
-                ((ProfileRulesetTabItem)tabItem).IsDefault = ((ProfileRulesetTabItem)tabItem).Value.ID == ruleset.ID;
+                ((ProfileRulesetTabItem)tabItem).IsDefault = ((ProfileRulesetTabItem)tabItem).Value.Equals(ruleset);
         }
 
         protected override TabItem<RulesetInfo> CreateTabItem(RulesetInfo value) => new ProfileRulesetTabItem(value);
diff --git a/osu.Game/Overlays/Settings/Sections/SkinSection.cs b/osu.Game/Overlays/Settings/Sections/SkinSection.cs
index 0714b28b47..e7a7abed59 100644
--- a/osu.Game/Overlays/Settings/Sections/SkinSection.cs
+++ b/osu.Game/Overlays/Settings/Sections/SkinSection.cs
@@ -132,7 +132,7 @@ namespace osu.Game.Overlays.Settings.Sections
             skinDropdown.Items = newDropdownItems;
         }
 
-        private void itemRemoved(SkinInfo item) => Schedule(() => skinDropdown.Items = skinDropdown.Items.Where(i => i.ID != item.ID).ToArray());
+        private void itemRemoved(SkinInfo item) => Schedule(() => skinDropdown.Items = skinDropdown.Items.Where(i => !i.Equals(item)).ToArray());
 
         private void sortUserSkins(List<SkinInfo> skinsList)
         {
diff --git a/osu.Game/Screens/Select/BeatmapCarousel.cs b/osu.Game/Screens/Select/BeatmapCarousel.cs
index 0fc7a99c96..b0d0821ee9 100644
--- a/osu.Game/Screens/Select/BeatmapCarousel.cs
+++ b/osu.Game/Screens/Select/BeatmapCarousel.cs
@@ -186,7 +186,7 @@ namespace osu.Game.Screens.Select
 
         public void RemoveBeatmapSet(BeatmapSetInfo beatmapSet) => Schedule(() =>
         {
-            var existingSet = beatmapSets.FirstOrDefault(b => b.BeatmapSet.ID == beatmapSet.ID);
+            var existingSet = beatmapSets.FirstOrDefault(b => b.BeatmapSet.Equals(beatmapSet));
 
             if (existingSet == null)
                 return;
@@ -198,7 +198,7 @@ namespace osu.Game.Screens.Select
         public void UpdateBeatmapSet(BeatmapSetInfo beatmapSet) => Schedule(() =>
         {
             int? previouslySelectedID = null;
-            CarouselBeatmapSet existingSet = beatmapSets.FirstOrDefault(b => b.BeatmapSet.ID == beatmapSet.ID);
+            CarouselBeatmapSet existingSet = beatmapSets.FirstOrDefault(b => b.BeatmapSet.Equals(beatmapSet));
 
             // If the selected beatmap is about to be removed, store its ID so it can be re-selected if required
             if (existingSet?.State?.Value == CarouselItemState.Selected)

From e07c44d79a02028f0d944b51e86a053b3940e307 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 24 Nov 2021 13:01:15 +0900
Subject: [PATCH 1215/5547] Reword comment with a more diagrammatical
 explanation

---
 .../Preprocessing/OsuDifficultyHitObject.cs   | 25 +++++++++++++------
 1 file changed, 18 insertions(+), 7 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
index eb36e96995..ecba2500d0 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
@@ -102,14 +102,25 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
                 double lastTravelTime = Math.Max(lastSlider.LazyTravelTime / clockRate, min_delta_time);
                 MovementTime = Math.Max(MovementTime - lastTravelTime, min_delta_time);
 
-                // Jump distance from the slider tail to the next object, as opposed to the lazy position of JumpDistance.
-                float tailJumpDistance = Vector2.Subtract(lastSlider.TailCircle.StackedPosition, BaseObject.StackedPosition).Length * scalingFactor;
+                //
+                // We'll try to better approximate the real movements a player will take in patterns following on from sliders. Consider the following slider-to-object patterns:
+                //
+                // 1.  <======o==>
+                //            | /
+                //            o
+                //
+                // 2.  <======o==>---o
+                //            |______|
+                //
+                // Where "<==>" represents a slider, and "o" represents where the cursor needs to be for either hitobject (for a slider, this is the lazy cursor position).
+                //
+                // Case (1) is an anti-flow pattern, where players will cut the slider short in order to move to the next object. The jump pattern is (o--o).
+                // Case (2) is a flow pattern, where players will follow the slider through to its visual extent. The jump pattern is (>--o).
+                //
+                // A lenience is applied by assuming that the player jumps the minimum of these two distances in all cases.
+                //
 
-                // For hitobjects which continue in the direction of the slider, the player will normally follow through the slider,
-                // such that they're not jumping from the lazy position but rather from very close to (or the end of) the slider.
-                // In such cases, a leniency is applied by also considering the jump distance from the tail of the slider, and taking the minimum jump distance.
-                // Additional distance is removed based on position of jump relative to slider follow circle radius.
-                // JumpDistance is the leniency distance beyond the assumed_slider_radius. tailJumpDistance is maximum_slider_radius since the full distance of radial leniency is still possible.
+                float tailJumpDistance = Vector2.Subtract(lastSlider.TailCircle.StackedPosition, BaseObject.StackedPosition).Length * scalingFactor;
                 MovementDistance = Math.Max(0, Math.Min(MovementDistance - (maximum_slider_radius - assumed_slider_radius), tailJumpDistance - maximum_slider_radius));
             }
 

From a081038076f647b6fa7632135f71766b8a97514c Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 24 Nov 2021 13:01:53 +0900
Subject: [PATCH 1216/5547] Normalized -> Normalised

---
 .../Preprocessing/OsuDifficultyHitObject.cs      | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
index ecba2500d0..5c20851e23 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
@@ -11,10 +11,10 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
 {
     public class OsuDifficultyHitObject : DifficultyHitObject
     {
-        private const int normalized_radius = 50; // Change radius to 50 to make 100 the diameter. Easier for mental maths.
+        private const int normalised_radius = 50; // Change radius to 50 to make 100 the diameter. Easier for mental maths.
         private const int min_delta_time = 25;
-        private const float maximum_slider_radius = normalized_radius * 2.4f;
-        private const float assumed_slider_radius = normalized_radius * 1.8f;
+        private const float maximum_slider_radius = normalised_radius * 2.4f;
+        private const float assumed_slider_radius = normalised_radius * 1.8f;
 
         protected new OsuHitObject BaseObject => (OsuHitObject)base.BaseObject;
 
@@ -24,7 +24,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
         public readonly double StrainTime;
 
         /// <summary>
-        /// Normalized distance from the end position of the previous <see cref="OsuDifficultyHitObject"/> to the start position of this <see cref="OsuDifficultyHitObject"/>.
+        /// Normalised distance from the end position of the previous <see cref="OsuDifficultyHitObject"/> to the start position of this <see cref="OsuDifficultyHitObject"/>.
         /// </summary>
         public double JumpDistance { get; private set; }
 
@@ -39,7 +39,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
         public double MovementTime { get; private set; }
 
         /// <summary>
-        /// Normalized distance between the start and end position of this <see cref="OsuDifficultyHitObject"/>.
+        /// Normalised distance between the start and end position of this <see cref="OsuDifficultyHitObject"/>.
         /// </summary>
         public double TravelDistance { get; private set; }
 
@@ -76,7 +76,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
                 return;
 
             // We will scale distances by this factor, so we can assume a uniform CircleSize among beatmaps.
-            float scalingFactor = normalized_radius / (float)BaseObject.Radius;
+            float scalingFactor = normalised_radius / (float)BaseObject.Radius;
 
             if (BaseObject.Radius < 30)
             {
@@ -153,7 +153,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
 
             slider.LazyEndPosition = slider.StackedPosition + slider.Path.PositionAt(endTimeMin); // temporary lazy end position until a real result can be derived.
             var currCursorPosition = slider.StackedPosition;
-            double scalingFactor = normalized_radius / slider.Radius; // lazySliderDistance is coded to be sensitive to scaling, this makes the maths easier with the thresholds being used.
+            double scalingFactor = normalised_radius / slider.Radius; // lazySliderDistance is coded to be sensitive to scaling, this makes the maths easier with the thresholds being used.
 
             for (int i = 1; i < slider.NestedHitObjects.Count; i++)
             {
@@ -181,7 +181,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
                 else if (currMovementObj is SliderRepeat)
                 {
                     // For a slider repeat, assume a tighter movement threshold to better assess repeat sliders.
-                    requiredMovement = normalized_radius;
+                    requiredMovement = normalised_radius;
                 }
 
                 if (currMovementLength > requiredMovement)

From b1f3e9804577a8e829483c4115a288ba75419637 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 22 Nov 2021 16:16:01 +0900
Subject: [PATCH 1217/5547] Fix incorrect usage of `ID` in
 `TestSceneMultiplayerResults`

---
 .../Visual/Multiplayer/TestSceneMultiplayerResults.cs           | 2 +-
 .../Visual/Multiplayer/TestSceneMultiplayerTeamResults.cs       | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerResults.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerResults.cs
index c0b21c4421..80f807e7d3 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerResults.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerResults.cs
@@ -39,7 +39,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
                 PlaylistItem playlistItem = new PlaylistItem
                 {
-                    BeatmapID = beatmapInfo.ID,
+                    BeatmapID = beatmapInfo.OnlineID ?? -1,
                 };
 
                 Stack.Push(screen = new MultiplayerResultsScreen(score, 1, playlistItem));
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerTeamResults.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerTeamResults.cs
index d391c39c89..da1fa226e1 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerTeamResults.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerTeamResults.cs
@@ -43,7 +43,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
                 PlaylistItem playlistItem = new PlaylistItem
                 {
-                    BeatmapID = beatmapInfo.ID,
+                    BeatmapID = beatmapInfo.OnlineID ?? -1,
                 };
 
                 SortedDictionary<int, BindableInt> teamScores = new SortedDictionary<int, BindableInt>

From ee22c24370f57b066d73d37e2d04a1c970a19ab4 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 23 Nov 2021 12:52:17 +0900
Subject: [PATCH 1218/5547] Update `RulesetConfigCache` to cache via
 `ShortName` instead of `ID`

---
 osu.Game/Rulesets/RulesetConfigCache.cs | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Rulesets/RulesetConfigCache.cs b/osu.Game/Rulesets/RulesetConfigCache.cs
index aeac052673..5a082300b4 100644
--- a/osu.Game/Rulesets/RulesetConfigCache.cs
+++ b/osu.Game/Rulesets/RulesetConfigCache.cs
@@ -19,7 +19,7 @@ namespace osu.Game.Rulesets
         private readonly RealmContextFactory realmFactory;
         private readonly RulesetStore rulesets;
 
-        private readonly Dictionary<int, IRulesetConfigManager> configCache = new Dictionary<int, IRulesetConfigManager>();
+        private readonly Dictionary<string, IRulesetConfigManager> configCache = new Dictionary<string, IRulesetConfigManager>();
 
         public RulesetConfigCache(RealmContextFactory realmFactory, RulesetStore rulesets)
         {
@@ -36,10 +36,10 @@ namespace osu.Game.Rulesets
             // let's keep things simple for now and just retrieve all the required configs at startup..
             foreach (var ruleset in rulesets.AvailableRulesets)
             {
-                if (ruleset.ID == null)
+                if (string.IsNullOrEmpty(ruleset.ShortName))
                     continue;
 
-                configCache[ruleset.ID.Value] = ruleset.CreateInstance().CreateConfig(settingsStore);
+                configCache[ruleset.ShortName] = ruleset.CreateInstance().CreateConfig(settingsStore);
             }
         }
 
@@ -51,10 +51,10 @@ namespace osu.Game.Rulesets
         /// <exception cref="InvalidOperationException">If <paramref name="ruleset"/> doesn't have a valid <see cref="RulesetInfo.ID"/>.</exception>
         public IRulesetConfigManager GetConfigFor(Ruleset ruleset)
         {
-            if (ruleset.RulesetInfo.ID == null)
+            if (string.IsNullOrEmpty(ruleset.ShortName))
                 return null;
 
-            if (!configCache.TryGetValue(ruleset.RulesetInfo.ID.Value, out var config))
+            if (!configCache.TryGetValue(ruleset.RulesetInfo.ShortName, out var config))
                 // any ruleset request which wasn't initialised on startup should not be stored to realm.
                 // this should only be used by tests.
                 return ruleset.CreateConfig(null);

From b5747f351dac23d33f63b3b804ea1052a7c5a5de Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 24 Nov 2021 13:11:44 +0900
Subject: [PATCH 1219/5547] Reword xmldocs

---
 .../Difficulty/Preprocessing/OsuDifficultyHitObject.cs   | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
index 5c20851e23..52108f85f9 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
@@ -29,12 +29,15 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
         public double JumpDistance { get; private set; }
 
         /// <summary>
-        /// Minimum distance from the end position of the previous <see cref="OsuDifficultyHitObject"/> to the start position of this <see cref="OsuDifficultyHitObject"/>.
+        /// Normalised minimum distance from the end position of the previous <see cref="OsuDifficultyHitObject"/> to the start position of this <see cref="OsuDifficultyHitObject"/>.
         /// </summary>
+        /// <remarks>
+        /// This is bounded by <see cref="JumpDistance"/>, but may be smaller if a more natural path is able to be taken through a preceding slider.
+        /// </remarks>
         public double MovementDistance { get; private set; }
 
         /// <summary>
-        /// Milliseconds elapsed since the end time of the previous <see cref="OsuDifficultyHitObject"/>, with a minimum of 25ms.
+        /// The time taken to travel through <see cref="MovementDistance"/>, with a minimum value of 25ms.
         /// </summary>
         public double MovementTime { get; private set; }
 
@@ -44,7 +47,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
         public double TravelDistance { get; private set; }
 
         /// <summary>
-        /// Milliseconds elapsed between the start and end time of this <see cref="OsuDifficultyHitObject"/>, with a minimum of 25ms.
+        /// The time taken to travel through <see cref="TravelDistance"/>, with a minimum value of 25ms for a non-zero distance.
         /// </summary>
         public double TravelTime { get; private set; }
 

From 274444ed6725345e3b4f0588fc046d1bba95a79f Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 24 Nov 2021 13:22:52 +0900
Subject: [PATCH 1220/5547] Add additional information to diagram

---
 .../Preprocessing/OsuDifficultyHitObject.cs           | 11 +++++++----
 1 file changed, 7 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
index 52108f85f9..36a1053317 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
@@ -103,7 +103,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
             if (lastObject is Slider lastSlider)
             {
                 double lastTravelTime = Math.Max(lastSlider.LazyTravelTime / clockRate, min_delta_time);
-                MovementTime = Math.Max(MovementTime - lastTravelTime, min_delta_time);
+                MovementTime = Math.Max(StrainTime - lastTravelTime, min_delta_time);
 
                 //
                 // We'll try to better approximate the real movements a player will take in patterns following on from sliders. Consider the following slider-to-object patterns:
@@ -117,14 +117,17 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
                 //
                 // Where "<==>" represents a slider, and "o" represents where the cursor needs to be for either hitobject (for a slider, this is the lazy cursor position).
                 //
-                // Case (1) is an anti-flow pattern, where players will cut the slider short in order to move to the next object. The jump pattern is (o--o).
-                // Case (2) is a flow pattern, where players will follow the slider through to its visual extent. The jump pattern is (>--o).
+                // The pattern (o--o) has distance JumpDistance.
+                // The pattern (>--o) is a new distance we'll call "tailJumpDistance".
+                //
+                // Case (1) is an anti-flow pattern, where players will cut the slider short in order to move to the next object. The most natural jump pattern is (o--o).
+                // Case (2) is a flow pattern, where players will follow the slider through to its visual extent. The most natural jump pattern is (>--o).
                 //
                 // A lenience is applied by assuming that the player jumps the minimum of these two distances in all cases.
                 //
 
                 float tailJumpDistance = Vector2.Subtract(lastSlider.TailCircle.StackedPosition, BaseObject.StackedPosition).Length * scalingFactor;
-                MovementDistance = Math.Max(0, Math.Min(MovementDistance - (maximum_slider_radius - assumed_slider_radius), tailJumpDistance - maximum_slider_radius));
+                MovementDistance = Math.Max(0, Math.Min(JumpDistance - (maximum_slider_radius - assumed_slider_radius), tailJumpDistance - maximum_slider_radius));
             }
 
             if (lastLastObject != null && !(lastLastObject is Spinner))

From 49c2cb91254fe4a3ff193826a97482b144cc1a31 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 24 Nov 2021 13:25:52 +0900
Subject: [PATCH 1221/5547] Initialise `BeatmapSet.Beatmaps` list to line up
 with realm expectations

---
 osu.Game/Beatmaps/BeatmapManager.cs      | 2 +-
 osu.Game/Beatmaps/BeatmapModelManager.cs | 1 -
 osu.Game/Beatmaps/BeatmapSetInfo.cs      | 2 +-
 3 files changed, 2 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index c2a2e93caf..4378da2dd3 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -86,7 +86,7 @@ namespace osu.Game.Beatmaps
             var set = new BeatmapSetInfo
             {
                 Metadata = metadata,
-                Beatmaps = new List<BeatmapInfo>
+                Beatmaps =
                 {
                     new BeatmapInfo
                     {
diff --git a/osu.Game/Beatmaps/BeatmapModelManager.cs b/osu.Game/Beatmaps/BeatmapModelManager.cs
index 8f55232031..132f15809a 100644
--- a/osu.Game/Beatmaps/BeatmapModelManager.cs
+++ b/osu.Game/Beatmaps/BeatmapModelManager.cs
@@ -370,7 +370,6 @@ namespace osu.Game.Beatmaps
             return new BeatmapSetInfo
             {
                 OnlineID = beatmap.BeatmapInfo.BeatmapSet?.OnlineID,
-                Beatmaps = new List<BeatmapInfo>(),
                 Metadata = beatmap.Metadata,
                 DateAdded = DateTimeOffset.UtcNow
             };
diff --git a/osu.Game/Beatmaps/BeatmapSetInfo.cs b/osu.Game/Beatmaps/BeatmapSetInfo.cs
index 35468ce831..818a6dd48f 100644
--- a/osu.Game/Beatmaps/BeatmapSetInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapSetInfo.cs
@@ -30,7 +30,7 @@ namespace osu.Game.Beatmaps
 
         public BeatmapMetadata Metadata { get; set; }
 
-        public List<BeatmapInfo> Beatmaps { get; set; }
+        public List<BeatmapInfo> Beatmaps { get; } = new List<BeatmapInfo>();
 
         public BeatmapSetOnlineStatus Status { get; set; } = BeatmapSetOnlineStatus.None;
 

From 8c60f37508cf52dbedab69a65a8d22c900695b0e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 24 Nov 2021 13:25:26 +0900
Subject: [PATCH 1222/5547] Fix cases of dynamically assigning `Beatmap`s to
 `BeatmapSetInfo` using list assignment

---
 .../Beatmaps/IO/ImportBeatmapTest.cs          |  2 +-
 ...eneOnlinePlayBeatmapAvailabilityTracker.cs |  9 ++--
 .../Menus/TestSceneMusicActionHandling.cs     |  2 +-
 .../TestSceneMultiplayerMatchSongSelect.cs    | 36 +++++++++------
 .../TestScenePlaylistsSongSelect.cs           | 34 +++++++-------
 .../Navigation/TestScenePresentBeatmap.cs     |  3 +-
 .../Navigation/TestScenePresentScore.cs       |  3 +-
 .../SongSelect/TestSceneBeatmapCarousel.cs    | 46 ++++++++++---------
 .../TestSceneBeatmapRecommendations.cs        | 20 ++++----
 .../SongSelect/TestScenePlaySongSelect.cs     | 33 ++++++-------
 osu.Game/Beatmaps/BeatmapModelManager.cs      |  2 +-
 osu.Game/Tests/Beatmaps/TestBeatmap.cs        | 12 +++--
 osu.Game/Tests/Visual/OsuTestScene.cs         | 21 ++++++---
 13 files changed, 123 insertions(+), 100 deletions(-)

diff --git a/osu.Game.Tests/Beatmaps/IO/ImportBeatmapTest.cs b/osu.Game.Tests/Beatmaps/IO/ImportBeatmapTest.cs
index 836cbfa6c5..a404a54ee4 100644
--- a/osu.Game.Tests/Beatmaps/IO/ImportBeatmapTest.cs
+++ b/osu.Game.Tests/Beatmaps/IO/ImportBeatmapTest.cs
@@ -584,7 +584,7 @@ namespace osu.Game.Tests.Beatmaps.IO
                     {
                         OnlineID = 1,
                         Metadata = metadata,
-                        Beatmaps = new List<BeatmapInfo>
+                        Beatmaps =
                         {
                             new BeatmapInfo
                             {
diff --git a/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs b/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
index b66da028f1..748de6c9a8 100644
--- a/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
+++ b/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
@@ -2,7 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
-using System.Collections.Generic;
+using System.Diagnostics;
 using System.IO;
 using System.Threading;
 using System.Threading.Tasks;
@@ -143,8 +143,11 @@ namespace osu.Game.Tests.Online
                 var beatmap = decoder.Decode(reader);
 
                 info = beatmap.BeatmapInfo;
-                info.BeatmapSet.Beatmaps = new List<BeatmapInfo> { info };
-                info.BeatmapSet.Metadata = info.Metadata;
+                info.Metadata = info.Metadata;
+
+                Debug.Assert(info.BeatmapSet != null);
+
+                info.BeatmapSet.Beatmaps.Add(info);
                 info.MD5Hash = stream.ComputeMD5Hash();
                 info.Hash = stream.ComputeSHA2Hash();
             }
diff --git a/osu.Game.Tests/Visual/Menus/TestSceneMusicActionHandling.cs b/osu.Game.Tests/Visual/Menus/TestSceneMusicActionHandling.cs
index 6dda8df6f0..f429b5b2a8 100644
--- a/osu.Game.Tests/Visual/Menus/TestSceneMusicActionHandling.cs
+++ b/osu.Game.Tests/Visual/Menus/TestSceneMusicActionHandling.cs
@@ -36,7 +36,7 @@ namespace osu.Game.Tests.Visual.Menus
             // ensure we have at least two beatmaps available to identify the direction the music controller navigated to.
             AddRepeatStep("import beatmap", () => Game.BeatmapManager.Import(new BeatmapSetInfo
             {
-                Beatmaps = new List<BeatmapInfo>
+                Beatmaps =
                 {
                     new BeatmapInfo
                     {
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs
index aef1fb31d6..f308886bf4 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs
@@ -47,6 +47,13 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             beatmaps = new List<BeatmapInfo>();
 
+            var beatmapSetInfo = new BeatmapSetInfo
+            {
+                OnlineID = 10,
+                Hash = Guid.NewGuid().ToString().ComputeMD5Hash(),
+                DateAdded = DateTimeOffset.UtcNow
+            };
+
             for (int i = 0; i < 8; ++i)
             {
                 int beatmapId = 10 * 10 + i;
@@ -54,29 +61,28 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 int length = RNG.Next(30000, 200000);
                 double bpm = RNG.NextSingle(80, 200);
 
-                beatmaps.Add(new BeatmapInfo
+                var metadata = new BeatmapMetadata
+                {
+                    Artist = "Some Artist",
+                    Title = "Some Beatmap",
+                    AuthorString = "Some Author"
+                };
+
+                var beatmap = new BeatmapInfo
                 {
                     Ruleset = rulesets.GetRuleset(i % 4),
                     OnlineID = beatmapId,
                     Length = length,
                     BPM = bpm,
+                    Metadata = metadata,
                     BaseDifficulty = new BeatmapDifficulty()
-                });
+                };
+
+                beatmaps.Add(beatmap);
+                beatmapSetInfo.Beatmaps.Add(beatmap);
             }
 
-            manager.Import(new BeatmapSetInfo
-            {
-                OnlineID = 10,
-                Hash = Guid.NewGuid().ToString().ComputeMD5Hash(),
-                Metadata = new BeatmapMetadata
-                {
-                    Artist = "Some Artist",
-                    Title = "Some Beatmap",
-                    AuthorString = "Some Author"
-                },
-                Beatmaps = beatmaps,
-                DateAdded = DateTimeOffset.UtcNow
-            }).Wait();
+            manager.Import(beatmapSetInfo).Wait();
         }
 
         public override void SetUpSteps()
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsSongSelect.cs b/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsSongSelect.cs
index 05f9a94cf7..04e47e17e5 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsSongSelect.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsSongSelect.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.IO;
 using System.Linq;
 using System.Text;
@@ -42,7 +41,20 @@ namespace osu.Game.Tests.Visual.Multiplayer
             Dependencies.Cache(rulesets = new RulesetStore(ContextFactory));
             Dependencies.Cache(manager = new BeatmapManager(LocalStorage, ContextFactory, rulesets, null, audio, Resources, host, Beatmap.Default));
 
-            var beatmaps = new List<BeatmapInfo>();
+            var metadata = new BeatmapMetadata
+            {
+                // Create random metadata, then we can check if sorting works based on these
+                Artist = "Some Artist " + RNG.Next(0, 9),
+                Title = "Some Song (set id 10)",
+                AuthorString = "Some Guy " + RNG.Next(0, 9),
+            };
+
+            var beatmapSet = new BeatmapSetInfo
+            {
+                OnlineID = 10,
+                Hash = new MemoryStream(Encoding.UTF8.GetBytes(Guid.NewGuid().ToString())).ComputeMD5Hash(),
+                DateAdded = DateTimeOffset.UtcNow,
+            };
 
             for (int i = 0; i < 6; i++)
             {
@@ -51,12 +63,13 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 int length = RNG.Next(30000, 200000);
                 double bpm = RNG.NextSingle(80, 200);
 
-                beatmaps.Add(new BeatmapInfo
+                beatmapSet.Beatmaps.Add(new BeatmapInfo
                 {
                     Ruleset = new OsuRuleset().RulesetInfo,
                     OnlineID = beatmapId,
                     DifficultyName = $"{beatmapId} (length {TimeSpan.FromMilliseconds(length):m\\:ss}, bpm {bpm:0.#})",
                     Length = length,
+                    Metadata = metadata,
                     BPM = bpm,
                     BaseDifficulty = new BeatmapDifficulty
                     {
@@ -65,20 +78,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 });
             }
 
-            manager.Import(new BeatmapSetInfo
-            {
-                OnlineID = 10,
-                Hash = new MemoryStream(Encoding.UTF8.GetBytes(Guid.NewGuid().ToString())).ComputeMD5Hash(),
-                Metadata = new BeatmapMetadata
-                {
-                    // Create random metadata, then we can check if sorting works based on these
-                    Artist = "Some Artist " + RNG.Next(0, 9),
-                    Title = $"Some Song (set id 10), max bpm {beatmaps.Max(b => b.BPM):0.#})",
-                    AuthorString = "Some Guy " + RNG.Next(0, 9),
-                },
-                Beatmaps = beatmaps,
-                DateAdded = DateTimeOffset.UtcNow,
-            }).Wait();
+            manager.Import(beatmapSet).Wait();
         }
 
         public override void SetUpSteps()
diff --git a/osu.Game.Tests/Visual/Navigation/TestScenePresentBeatmap.cs b/osu.Game.Tests/Visual/Navigation/TestScenePresentBeatmap.cs
index d1ee984682..2d1512209e 100644
--- a/osu.Game.Tests/Visual/Navigation/TestScenePresentBeatmap.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestScenePresentBeatmap.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 NUnit.Framework;
 using osu.Framework.Screens;
@@ -110,7 +109,7 @@ namespace osu.Game.Tests.Visual.Navigation
                     Hash = Guid.NewGuid().ToString(),
                     OnlineID = i,
                     Metadata = metadata,
-                    Beatmaps = new List<BeatmapInfo>
+                    Beatmaps =
                     {
                         new BeatmapInfo
                         {
diff --git a/osu.Game.Tests/Visual/Navigation/TestScenePresentScore.cs b/osu.Game.Tests/Visual/Navigation/TestScenePresentScore.cs
index 72f160c9a9..1d4459a852 100644
--- a/osu.Game.Tests/Visual/Navigation/TestScenePresentScore.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestScenePresentScore.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 NUnit.Framework;
 using osu.Framework.Screens;
@@ -41,7 +40,7 @@ namespace osu.Game.Tests.Visual.Navigation
                     Hash = Guid.NewGuid().ToString(),
                     OnlineID = 1,
                     Metadata = metadata,
-                    Beatmaps = new List<BeatmapInfo>
+                    Beatmaps =
                     {
                         new BeatmapInfo
                         {
diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs
index 5c40a3dd94..512e34975e 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs
@@ -836,23 +836,27 @@ namespace osu.Game.Tests.Visual.SongSelect
 
         private BeatmapSetInfo createTestBeatmapSet(int id, bool randomDifficultyCount = false)
         {
-            return new BeatmapSetInfo
+            var metadata = new BeatmapMetadata
+            {
+                // Create random metadata, then we can check if sorting works based on these
+                Artist = $"peppy{id.ToString().PadLeft(6, '0')}",
+                Title = $"test set #{id}!",
+                AuthorString = string.Concat(Enumerable.Repeat((char)('z' - Math.Min(25, id - 1)), 5))
+            };
+
+            var beatmapSet = new BeatmapSetInfo
             {
-                ID = id,
                 OnlineID = id,
                 Hash = new MemoryStream(Encoding.UTF8.GetBytes(Guid.NewGuid().ToString())).ComputeMD5Hash(),
-                Metadata = new BeatmapMetadata
-                {
-                    // Create random metadata, then we can check if sorting works based on these
-                    Artist = $"peppy{id.ToString().PadLeft(6, '0')}",
-                    Title = $"test set #{id}!",
-                    AuthorString = string.Concat(Enumerable.Repeat((char)('z' - Math.Min(25, id - 1)), 5))
-                },
-                Beatmaps = getBeatmaps(randomDifficultyCount ? RNG.Next(1, 20) : 3).ToList()
             };
+
+            foreach (var b in getBeatmaps(randomDifficultyCount ? RNG.Next(1, 20) : 3, metadata))
+                beatmapSet.Beatmaps.Add(b);
+
+            return beatmapSet;
         }
 
-        private IEnumerable<BeatmapInfo> getBeatmaps(int count)
+        private IEnumerable<BeatmapInfo> getBeatmaps(int count, BeatmapMetadata metadata)
         {
             int id = 0;
 
@@ -872,6 +876,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                     DifficultyName = version,
                     StarRating = diff,
                     Ruleset = new OsuRuleset().RulesetInfo,
+                    Metadata = metadata,
                     BaseDifficulty = new BeatmapDifficulty
                     {
                         OverallDifficulty = diff,
@@ -882,19 +887,18 @@ namespace osu.Game.Tests.Visual.SongSelect
 
         private BeatmapSetInfo createTestBeatmapSetWithManyDifficulties(int id)
         {
+            var metadata = new BeatmapMetadata
+            {
+                // Create random metadata, then we can check if sorting works based on these
+                Artist = $"peppy{id.ToString().PadLeft(6, '0')}",
+                Title = $"test set #{id}!",
+                AuthorString = string.Concat(Enumerable.Repeat((char)('z' - Math.Min(25, id - 1)), 5))
+            };
+
             var toReturn = new BeatmapSetInfo
             {
-                ID = id,
                 OnlineID = id,
                 Hash = new MemoryStream(Encoding.UTF8.GetBytes(Guid.NewGuid().ToString())).ComputeMD5Hash(),
-                Metadata = new BeatmapMetadata
-                {
-                    // Create random metadata, then we can check if sorting works based on these
-                    Artist = $"peppy{id.ToString().PadLeft(6, '0')}",
-                    Title = $"test set #{id}!",
-                    AuthorString = string.Concat(Enumerable.Repeat((char)('z' - Math.Min(25, id - 1)), 5))
-                },
-                Beatmaps = new List<BeatmapInfo>(),
             };
 
             for (int b = 1; b < 101; b++)
@@ -902,10 +906,10 @@ namespace osu.Game.Tests.Visual.SongSelect
                 toReturn.Beatmaps.Add(new BeatmapInfo
                 {
                     OnlineID = b * 10,
-                    Path = $"extra{b}.osu",
                     DifficultyName = $"Extra {b}",
                     Ruleset = rulesets.GetRuleset((b - 1) % 4),
                     StarRating = 2,
+                    Metadata = metadata,
                     BaseDifficulty = new BeatmapDifficulty
                     {
                         OverallDifficulty = 3.5f,
diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapRecommendations.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapRecommendations.cs
index c9ec53cfd5..73144b584f 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapRecommendations.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapRecommendations.cs
@@ -182,18 +182,18 @@ namespace osu.Game.Tests.Visual.SongSelect
             {
                 Hash = Guid.NewGuid().ToString(),
                 OnlineID = importID,
-                Metadata = metadata,
-                Beatmaps = difficultyRulesets.Select((ruleset, difficultyIndex) => new BeatmapInfo
-                {
-                    OnlineID = importID * 1024 + difficultyIndex,
-                    Metadata = metadata,
-                    BaseDifficulty = new BeatmapDifficulty(),
-                    Ruleset = ruleset,
-                    StarRating = difficultyIndex + 1,
-                    DifficultyName = $"SR{difficultyIndex + 1}"
-                }).ToList()
             };
 
+            beatmapSet.Beatmaps.AddRange(difficultyRulesets.Select((ruleset, difficultyIndex) => new BeatmapInfo
+            {
+                OnlineID = importID * 1024 + difficultyIndex,
+                Metadata = metadata,
+                BaseDifficulty = new BeatmapDifficulty(),
+                Ruleset = ruleset,
+                StarRating = difficultyIndex + 1,
+                DifficultyName = $"SR{difficultyIndex + 1}"
+            }));
+
             return Game.BeatmapManager.Import(beatmapSet).Result.Value;
         }
 
diff --git a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
index f09dc38378..025c7f0dfd 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
@@ -907,7 +907,20 @@ namespace osu.Game.Tests.Visual.SongSelect
 
             int setId = getImportId();
 
-            var beatmaps = new List<BeatmapInfo>();
+            var beatmapSet = new BeatmapSetInfo
+            {
+                OnlineID = setId,
+                Hash = new MemoryStream(Encoding.UTF8.GetBytes(Guid.NewGuid().ToString())).ComputeMD5Hash(),
+                DateAdded = DateTimeOffset.UtcNow,
+            };
+
+            var metadata = new BeatmapMetadata
+            {
+                // Create random metadata, then we can check if sorting works based on these
+                Artist = "Some Artist " + RNG.Next(0, 9),
+                Title = $"Some Song (set id {setId})",
+                AuthorString = "Some Guy " + RNG.Next(0, 9),
+            };
 
             for (int i = 0; i < countPerRuleset; i++)
             {
@@ -916,12 +929,13 @@ namespace osu.Game.Tests.Visual.SongSelect
                 int length = RNG.Next(30000, 200000);
                 double bpm = RNG.NextSingle(80, 200);
 
-                beatmaps.Add(new BeatmapInfo
+                beatmapSet.Beatmaps.Add(new BeatmapInfo
                 {
                     Ruleset = getRuleset(),
                     OnlineID = beatmapId,
                     DifficultyName = $"{beatmapId} (length {TimeSpan.FromMilliseconds(length):m\\:ss}, bpm {bpm:0.#})",
                     Length = length,
+                    Metadata = metadata,
                     BPM = bpm,
                     BaseDifficulty = new BeatmapDifficulty
                     {
@@ -930,20 +944,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                 });
             }
 
-            return new BeatmapSetInfo
-            {
-                OnlineID = setId,
-                Hash = new MemoryStream(Encoding.UTF8.GetBytes(Guid.NewGuid().ToString())).ComputeMD5Hash(),
-                Metadata = new BeatmapMetadata
-                {
-                    // Create random metadata, then we can check if sorting works based on these
-                    Artist = "Some Artist " + RNG.Next(0, 9),
-                    Title = $"Some Song (set id {setId}, max bpm {beatmaps.Max(b => b.BPM):0.#})",
-                    AuthorString = "Some Guy " + RNG.Next(0, 9),
-                },
-                Beatmaps = beatmaps,
-                DateAdded = DateTimeOffset.UtcNow,
-            };
+            return beatmapSet;
         }
 
         protected override void Dispose(bool isDisposing)
diff --git a/osu.Game/Beatmaps/BeatmapModelManager.cs b/osu.Game/Beatmaps/BeatmapModelManager.cs
index 132f15809a..15eac962cc 100644
--- a/osu.Game/Beatmaps/BeatmapModelManager.cs
+++ b/osu.Game/Beatmaps/BeatmapModelManager.cs
@@ -82,7 +82,7 @@ namespace osu.Game.Beatmaps
         protected override async Task Populate(BeatmapSetInfo beatmapSet, ArchiveReader archive, CancellationToken cancellationToken = default)
         {
             if (archive != null)
-                beatmapSet.Beatmaps = createBeatmapDifficulties(beatmapSet.Files);
+                beatmapSet.Beatmaps.AddRange(createBeatmapDifficulties(beatmapSet.Files));
 
             foreach (BeatmapInfo b in beatmapSet.Beatmaps)
             {
diff --git a/osu.Game/Tests/Beatmaps/TestBeatmap.cs b/osu.Game/Tests/Beatmaps/TestBeatmap.cs
index 32a9b0b9d1..729253e25c 100644
--- a/osu.Game/Tests/Beatmaps/TestBeatmap.cs
+++ b/osu.Game/Tests/Beatmaps/TestBeatmap.cs
@@ -2,7 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
-using System.Collections.Generic;
+using System.Diagnostics;
 using System.IO;
 using System.Text;
 using System.Threading;
@@ -33,12 +33,16 @@ namespace osu.Game.Tests.Beatmaps
 
             BeatmapInfo.Ruleset = ruleset;
             BeatmapInfo.RulesetID = ruleset.ID ?? 0;
-            BeatmapInfo.BeatmapSet.Metadata = BeatmapInfo.Metadata;
-            BeatmapInfo.BeatmapSet.Beatmaps = new List<BeatmapInfo> { BeatmapInfo };
-            BeatmapInfo.BeatmapSet.OnlineID = Interlocked.Increment(ref onlineSetID);
+            BeatmapInfo.Metadata = BeatmapInfo.Metadata;
             BeatmapInfo.Length = 75000;
             BeatmapInfo.OnlineInfo = new APIBeatmap();
             BeatmapInfo.OnlineID = Interlocked.Increment(ref onlineBeatmapID);
+
+            Debug.Assert(BeatmapInfo.BeatmapSet != null);
+
+            BeatmapInfo.BeatmapSet.Metadata = BeatmapInfo.Metadata;
+            BeatmapInfo.BeatmapSet.Beatmaps.Add(BeatmapInfo);
+            BeatmapInfo.BeatmapSet.OnlineID = Interlocked.Increment(ref onlineSetID);
         }
 
         protected virtual Beatmap CreateBeatmap() => createTestBeatmap();
diff --git a/osu.Game/Tests/Visual/OsuTestScene.cs b/osu.Game/Tests/Visual/OsuTestScene.cs
index eedf266bbe..d774514dda 100644
--- a/osu.Game/Tests/Visual/OsuTestScene.cs
+++ b/osu.Game/Tests/Visual/OsuTestScene.cs
@@ -3,6 +3,7 @@
 
 using System;
 using System.Collections.Generic;
+using System.Diagnostics;
 using System.IO;
 using System.Linq;
 using System.Threading.Tasks;
@@ -220,6 +221,8 @@ namespace osu.Game.Tests.Visual
         {
             var beatmap = CreateBeatmap(ruleset ?? Ruleset.Value).BeatmapInfo;
 
+            Debug.Assert(beatmap.BeatmapSet != null);
+
             return new APIBeatmapSet
             {
                 OnlineID = ((IBeatmapSetInfo)beatmap.BeatmapSet).OnlineID,
@@ -230,13 +233,17 @@ namespace osu.Game.Tests.Visual
                     Card = "https://assets.ppy.sh/beatmaps/163112/covers/card.jpg",
                     List = "https://assets.ppy.sh/beatmaps/163112/covers/list.jpg"
                 },
-                Title = beatmap.BeatmapSet.Metadata.Title,
-                TitleUnicode = beatmap.BeatmapSet.Metadata.TitleUnicode,
-                Artist = beatmap.BeatmapSet.Metadata.Artist,
-                ArtistUnicode = beatmap.BeatmapSet.Metadata.ArtistUnicode,
-                Author = beatmap.BeatmapSet.Metadata.Author,
-                Source = beatmap.BeatmapSet.Metadata.Source,
-                Tags = beatmap.BeatmapSet.Metadata.Tags,
+                Title = beatmap.Metadata.Title,
+                TitleUnicode = beatmap.Metadata.TitleUnicode,
+                Artist = beatmap.Metadata.Artist,
+                ArtistUnicode = beatmap.Metadata.ArtistUnicode,
+                Author = new APIUser
+                {
+                    Username = beatmap.Metadata.Author.Username,
+                    Id = beatmap.Metadata.Author.OnlineID
+                },
+                Source = beatmap.Metadata.Source,
+                Tags = beatmap.Metadata.Tags,
                 Beatmaps = new[]
                 {
                     new APIBeatmap

From a3fdab34d5b39840ca60b79cf80bebfe4bfbb780 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 24 Nov 2021 13:34:52 +0900
Subject: [PATCH 1223/5547] Avoid json serialisation of aggregate helper
 properties

Also avoids `throw`ing when there are no beatmaps available. Until now
this wasn't an issue due to the `Beatmaps` list being null instead of empty.
---
 osu.Game/Beatmaps/BeatmapSetInfo.cs | 11 ++++++++---
 1 file changed, 8 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapSetInfo.cs b/osu.Game/Beatmaps/BeatmapSetInfo.cs
index 818a6dd48f..998bc6f16c 100644
--- a/osu.Game/Beatmaps/BeatmapSetInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapSetInfo.cs
@@ -6,6 +6,7 @@ using System.Collections.Generic;
 using System.ComponentModel.DataAnnotations.Schema;
 using System.Linq;
 using JetBrains.Annotations;
+using Newtonsoft.Json;
 using osu.Framework.Testing;
 using osu.Game.Database;
 using osu.Game.Extensions;
@@ -30,6 +31,7 @@ namespace osu.Game.Beatmaps
 
         public BeatmapMetadata Metadata { get; set; }
 
+        [NotNull]
         public List<BeatmapInfo> Beatmaps { get; } = new List<BeatmapInfo>();
 
         public BeatmapSetOnlineStatus Status { get; set; } = BeatmapSetOnlineStatus.None;
@@ -40,17 +42,20 @@ namespace osu.Game.Beatmaps
         /// <summary>
         /// The maximum star difficulty of all beatmaps in this set.
         /// </summary>
-        public double MaxStarDifficulty => Beatmaps?.Max(b => b.StarRating) ?? 0;
+        [JsonIgnore]
+        public double MaxStarDifficulty => Beatmaps.Count == 0 ? 0 : Beatmaps.Max(b => b.StarRating);
 
         /// <summary>
         /// The maximum playable length in milliseconds of all beatmaps in this set.
         /// </summary>
-        public double MaxLength => Beatmaps?.Max(b => b.Length) ?? 0;
+        [JsonIgnore]
+        public double MaxLength => Beatmaps.Count == 0 ? 0 : Beatmaps.Max(b => b.Length);
 
         /// <summary>
         /// The maximum BPM of all beatmaps in this set.
         /// </summary>
-        public double MaxBPM => Beatmaps?.Max(b => b.BPM) ?? 0;
+        [JsonIgnore]
+        public double MaxBPM => Beatmaps.Count == 0 ? 0 : Beatmaps.Max(b => b.BPM);
 
         [NotMapped]
         public bool DeletePending { get; set; }

From 5a0a95f9d470f9d7d1c3d30ef7d937195a2d0056 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 24 Nov 2021 13:48:59 +0900
Subject: [PATCH 1224/5547] Trim whitespace

---
 osu.Game/Database/RealmContextFactory.cs | 1 -
 1 file changed, 1 deletion(-)

diff --git a/osu.Game/Database/RealmContextFactory.cs b/osu.Game/Database/RealmContextFactory.cs
index 0a21f67422..99eb038b2d 100644
--- a/osu.Game/Database/RealmContextFactory.cs
+++ b/osu.Game/Database/RealmContextFactory.cs
@@ -269,7 +269,6 @@ namespace osu.Game.Database
                     break;
 
                 case 11:
-
                     string keyBindingClassName = getMappedOrOriginalName(typeof(RealmKeyBinding));
 
                     var oldKeyBindings = migration.OldRealm.DynamicApi.All(keyBindingClassName);

From 99a139dc988441f317b87d5bdb4a58db99e4d48d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 24 Nov 2021 13:42:07 +0900
Subject: [PATCH 1225/5547] Initialise all file lists at construction time (and
 remove setter)

---
 osu.Game/Beatmaps/BeatmapSetInfo.cs              | 4 +---
 osu.Game/Database/ArchiveModelManager.cs         | 3 ++-
 osu.Game/Database/IHasFiles.cs                   | 4 +++-
 osu.Game/Online/Leaderboards/LeaderboardScore.cs | 2 +-
 osu.Game/Scoring/ScoreInfo.cs                    | 2 +-
 osu.Game/Skinning/Skin.cs                        | 2 +-
 osu.Game/Skinning/SkinInfo.cs                    | 2 +-
 7 files changed, 10 insertions(+), 9 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapSetInfo.cs b/osu.Game/Beatmaps/BeatmapSetInfo.cs
index 35468ce831..1806c2b491 100644
--- a/osu.Game/Beatmaps/BeatmapSetInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapSetInfo.cs
@@ -5,7 +5,6 @@ using System;
 using System.Collections.Generic;
 using System.ComponentModel.DataAnnotations.Schema;
 using System.Linq;
-using JetBrains.Annotations;
 using osu.Framework.Testing;
 using osu.Game.Database;
 using osu.Game.Extensions;
@@ -34,8 +33,7 @@ namespace osu.Game.Beatmaps
 
         public BeatmapSetOnlineStatus Status { get; set; } = BeatmapSetOnlineStatus.None;
 
-        [NotNull]
-        public List<BeatmapSetFileInfo> Files { get; set; } = new List<BeatmapSetFileInfo>();
+        public List<BeatmapSetFileInfo> Files { get; } = new List<BeatmapSetFileInfo>();
 
         /// <summary>
         /// The maximum star difficulty of all beatmaps in this set.
diff --git a/osu.Game/Database/ArchiveModelManager.cs b/osu.Game/Database/ArchiveModelManager.cs
index a0e8105285..adbb71c8da 100644
--- a/osu.Game/Database/ArchiveModelManager.cs
+++ b/osu.Game/Database/ArchiveModelManager.cs
@@ -392,7 +392,8 @@ namespace osu.Game.Database
             {
                 LogForModel(item, @"Beginning import...");
 
-                item.Files = archive != null ? createFileInfos(archive, Files) : new List<TFileModel>();
+                if (archive != null)
+                    item.Files.AddRange(createFileInfos(archive, Files));
                 item.Hash = ComputeHash(item);
 
                 await Populate(item, archive, cancellationToken).ConfigureAwait(false);
diff --git a/osu.Game/Database/IHasFiles.cs b/osu.Game/Database/IHasFiles.cs
index f6aa941ec2..3f6531832f 100644
--- a/osu.Game/Database/IHasFiles.cs
+++ b/osu.Game/Database/IHasFiles.cs
@@ -2,6 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System.Collections.Generic;
+using JetBrains.Annotations;
 
 namespace osu.Game.Database
 {
@@ -12,7 +13,8 @@ namespace osu.Game.Database
     public interface IHasFiles<TFile>
         where TFile : INamedFileInfo
     {
-        List<TFile> Files { get; set; }
+        [NotNull]
+        List<TFile> Files { get; }
 
         string Hash { get; set; }
     }
diff --git a/osu.Game/Online/Leaderboards/LeaderboardScore.cs b/osu.Game/Online/Leaderboards/LeaderboardScore.cs
index 26749a23f9..f0c57cb953 100644
--- a/osu.Game/Online/Leaderboards/LeaderboardScore.cs
+++ b/osu.Game/Online/Leaderboards/LeaderboardScore.cs
@@ -394,7 +394,7 @@ namespace osu.Game.Online.Leaderboards
                 if (Score.Mods.Length > 0 && modsContainer.Any(s => s.IsHovered) && songSelect != null)
                     items.Add(new OsuMenuItem("Use these mods", MenuItemType.Highlighted, () => songSelect.Mods.Value = Score.Mods));
 
-                if (Score.Files?.Count > 0)
+                if (Score.Files.Count > 0)
                     items.Add(new OsuMenuItem("Export", MenuItemType.Standard, () => scoreManager.Export(Score)));
 
                 if (Score.ID != 0)
diff --git a/osu.Game/Scoring/ScoreInfo.cs b/osu.Game/Scoring/ScoreInfo.cs
index 736a939a59..b4e194cbed 100644
--- a/osu.Game/Scoring/ScoreInfo.cs
+++ b/osu.Game/Scoring/ScoreInfo.cs
@@ -160,7 +160,7 @@ namespace osu.Game.Scoring
         [NotMapped]
         public List<HitEvent> HitEvents { get; set; }
 
-        public List<ScoreFileInfo> Files { get; set; }
+        public List<ScoreFileInfo> Files { get; } = new List<ScoreFileInfo>();
 
         public string Hash { get; set; }
 
diff --git a/osu.Game/Skinning/Skin.cs b/osu.Game/Skinning/Skin.cs
index fae1a599d1..10526b69af 100644
--- a/osu.Game/Skinning/Skin.cs
+++ b/osu.Game/Skinning/Skin.cs
@@ -59,7 +59,7 @@ namespace osu.Game.Skinning
                 string filename = $"{skinnableTarget}.json";
 
                 // skininfo files may be null for default skin.
-                var fileInfo = SkinInfo.Files?.FirstOrDefault(f => f.Filename == filename);
+                var fileInfo = SkinInfo.Files.FirstOrDefault(f => f.Filename == filename);
 
                 if (fileInfo == null)
                     continue;
diff --git a/osu.Game/Skinning/SkinInfo.cs b/osu.Game/Skinning/SkinInfo.cs
index 3b34e23d57..4733e8cdd9 100644
--- a/osu.Game/Skinning/SkinInfo.cs
+++ b/osu.Game/Skinning/SkinInfo.cs
@@ -36,7 +36,7 @@ namespace osu.Game.Skinning
             return (Skin)Activator.CreateInstance(type, this, resources);
         }
 
-        public List<SkinFileInfo> Files { get; set; } = new List<SkinFileInfo>();
+        public List<SkinFileInfo> Files { get; } = new List<SkinFileInfo>();
 
         public bool DeletePending { get; set; }
 

From c2f8d9f677d505e0b82bb76e8c1b589870d8827c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 24 Nov 2021 13:49:38 +0900
Subject: [PATCH 1226/5547] Update tests which set `Files` lists directly

---
 .../Editing/Checks/CheckAudioInVideoTest.cs   |  5 ++--
 .../Checks/CheckBackgroundQualityTest.cs      |  8 +++----
 .../Editing/Checks/CheckFilePresenceTest.cs   |  5 ++--
 .../Checks/CheckTooShortAudioFilesTest.cs     |  5 ++--
 .../Editing/Checks/CheckZeroByteFilesTest.cs  |  5 ++--
 .../Tests/Beatmaps/HitObjectSampleTest.cs     | 24 ++++++++-----------
 6 files changed, 22 insertions(+), 30 deletions(-)

diff --git a/osu.Game.Tests/Editing/Checks/CheckAudioInVideoTest.cs b/osu.Game.Tests/Editing/Checks/CheckAudioInVideoTest.cs
index f3a4f10210..f9b16990ef 100644
--- a/osu.Game.Tests/Editing/Checks/CheckAudioInVideoTest.cs
+++ b/osu.Game.Tests/Editing/Checks/CheckAudioInVideoTest.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.IO;
 using System.Linq;
 using Moq;
@@ -33,14 +32,14 @@ namespace osu.Game.Tests.Editing.Checks
                 {
                     BeatmapSet = new BeatmapSetInfo
                     {
-                        Files = new List<BeatmapSetFileInfo>(new[]
+                        Files =
                         {
                             new BeatmapSetFileInfo
                             {
                                 Filename = "abc123.mp4",
                                 FileInfo = new FileInfo { Hash = "abcdef" }
                             }
-                        })
+                        }
                     }
                 }
             };
diff --git a/osu.Game.Tests/Editing/Checks/CheckBackgroundQualityTest.cs b/osu.Game.Tests/Editing/Checks/CheckBackgroundQualityTest.cs
index 05bfae7e63..5a45857e5c 100644
--- a/osu.Game.Tests/Editing/Checks/CheckBackgroundQualityTest.cs
+++ b/osu.Game.Tests/Editing/Checks/CheckBackgroundQualityTest.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.Collections.Generic;
+using System;
 using System.IO;
 using System.Linq;
 using JetBrains.Annotations;
@@ -33,7 +33,7 @@ namespace osu.Game.Tests.Editing.Checks
                     Metadata = new BeatmapMetadata { BackgroundFile = "abc123.jpg" },
                     BeatmapSet = new BeatmapSetInfo
                     {
-                        Files = new List<BeatmapSetFileInfo>(new[]
+                        Files =
                         {
                             new BeatmapSetFileInfo
                             {
@@ -43,7 +43,7 @@ namespace osu.Game.Tests.Editing.Checks
                                     Hash = "abcdef"
                                 }
                             }
-                        })
+                        }
                     }
                 }
             };
@@ -54,7 +54,7 @@ namespace osu.Game.Tests.Editing.Checks
         {
             // While this is a problem, it is out of scope for this check and is caught by a different one.
             beatmap.Metadata.BackgroundFile = string.Empty;
-            var context = getContext(null, new MemoryStream(System.Array.Empty<byte>()));
+            var context = getContext(null, new MemoryStream(Array.Empty<byte>()));
 
             Assert.That(check.Run(context), Is.Empty);
         }
diff --git a/osu.Game.Tests/Editing/Checks/CheckFilePresenceTest.cs b/osu.Game.Tests/Editing/Checks/CheckFilePresenceTest.cs
index 70e4c76b19..59dfc88923 100644
--- a/osu.Game.Tests/Editing/Checks/CheckFilePresenceTest.cs
+++ b/osu.Game.Tests/Editing/Checks/CheckFilePresenceTest.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.Linq;
 using NUnit.Framework;
 using osu.Game.Beatmaps;
@@ -30,14 +29,14 @@ namespace osu.Game.Tests.Editing.Checks
                     Metadata = new BeatmapMetadata { BackgroundFile = "abc123.jpg" },
                     BeatmapSet = new BeatmapSetInfo
                     {
-                        Files = new List<BeatmapSetFileInfo>(new[]
+                        Files =
                         {
                             new BeatmapSetFileInfo
                             {
                                 Filename = "abc123.jpg",
                                 FileInfo = new FileInfo { Hash = "abcdef" }
                             }
-                        })
+                        }
                     }
                 }
             };
diff --git a/osu.Game.Tests/Editing/Checks/CheckTooShortAudioFilesTest.cs b/osu.Game.Tests/Editing/Checks/CheckTooShortAudioFilesTest.cs
index 9b090591bc..64285cd46e 100644
--- a/osu.Game.Tests/Editing/Checks/CheckTooShortAudioFilesTest.cs
+++ b/osu.Game.Tests/Editing/Checks/CheckTooShortAudioFilesTest.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.IO;
 using System.Linq;
 using ManagedBass;
@@ -34,14 +33,14 @@ namespace osu.Game.Tests.Editing.Checks
                 {
                     BeatmapSet = new BeatmapSetInfo
                     {
-                        Files = new List<BeatmapSetFileInfo>(new[]
+                        Files =
                         {
                             new BeatmapSetFileInfo
                             {
                                 Filename = "abc123.wav",
                                 FileInfo = new FileInfo { Hash = "abcdef" }
                             }
-                        })
+                        }
                     }
                 }
             };
diff --git a/osu.Game.Tests/Editing/Checks/CheckZeroByteFilesTest.cs b/osu.Game.Tests/Editing/Checks/CheckZeroByteFilesTest.cs
index c9adc030c1..1a581cc27d 100644
--- a/osu.Game.Tests/Editing/Checks/CheckZeroByteFilesTest.cs
+++ b/osu.Game.Tests/Editing/Checks/CheckZeroByteFilesTest.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.IO;
 using System.Linq;
 using Moq;
@@ -30,14 +29,14 @@ namespace osu.Game.Tests.Editing.Checks
                 {
                     BeatmapSet = new BeatmapSetInfo
                     {
-                        Files = new List<BeatmapSetFileInfo>(new[]
+                        Files =
                         {
                             new BeatmapSetFileInfo
                             {
                                 Filename = "abc123.jpg",
                                 FileInfo = new FileInfo { Hash = "abcdef" }
                             }
-                        })
+                        }
                     }
                 }
             };
diff --git a/osu.Game/Tests/Beatmaps/HitObjectSampleTest.cs b/osu.Game/Tests/Beatmaps/HitObjectSampleTest.cs
index b87c3d57c2..127c853a8e 100644
--- a/osu.Game/Tests/Beatmaps/HitObjectSampleTest.cs
+++ b/osu.Game/Tests/Beatmaps/HitObjectSampleTest.cs
@@ -91,23 +91,19 @@ namespace osu.Game.Tests.Beatmaps
         {
             AddStep("setup skins", () =>
             {
-                userSkinInfo.Files = new List<SkinFileInfo>
+                userSkinInfo.Files.Clear();
+                userSkinInfo.Files.Add(new SkinFileInfo
                 {
-                    new SkinFileInfo
-                    {
-                        Filename = userFile,
-                        FileInfo = new IO.FileInfo { Hash = userFile }
-                    }
-                };
+                    Filename = userFile,
+                    FileInfo = new IO.FileInfo { Hash = userFile }
+                });
 
-                beatmapInfo.BeatmapSet.Files = new List<BeatmapSetFileInfo>
+                beatmapInfo.BeatmapSet.Files.Clear();
+                beatmapInfo.BeatmapSet.Files.Add(new BeatmapSetFileInfo
                 {
-                    new BeatmapSetFileInfo
-                    {
-                        Filename = beatmapFile,
-                        FileInfo = new IO.FileInfo { Hash = beatmapFile }
-                    }
-                };
+                    Filename = beatmapFile,
+                    FileInfo = new IO.FileInfo { Hash = beatmapFile }
+                });
 
                 // Need to refresh the cached skin source to refresh the skin resource store.
                 dependencies.SkinSource = new SkinProvidingContainer(Skin = new LegacySkin(userSkinInfo, this));

From 0aedbbe165a67c1436e53b6a0b144bcd3d215d70 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 24 Nov 2021 14:04:55 +0900
Subject: [PATCH 1227/5547] Fix incorrect fallback logic causing test failure

---
 osu.Game/Rulesets/RulesetConfigCache.cs | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/osu.Game/Rulesets/RulesetConfigCache.cs b/osu.Game/Rulesets/RulesetConfigCache.cs
index 5a082300b4..262340b4ee 100644
--- a/osu.Game/Rulesets/RulesetConfigCache.cs
+++ b/osu.Game/Rulesets/RulesetConfigCache.cs
@@ -51,9 +51,6 @@ namespace osu.Game.Rulesets
         /// <exception cref="InvalidOperationException">If <paramref name="ruleset"/> doesn't have a valid <see cref="RulesetInfo.ID"/>.</exception>
         public IRulesetConfigManager GetConfigFor(Ruleset ruleset)
         {
-            if (string.IsNullOrEmpty(ruleset.ShortName))
-                return null;
-
             if (!configCache.TryGetValue(ruleset.RulesetInfo.ShortName, out var config))
                 // any ruleset request which wasn't initialised on startup should not be stored to realm.
                 // this should only be used by tests.

From ec89dfa04314eab13e78f12ab104cd407d4a62ad Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 24 Nov 2021 14:09:25 +0900
Subject: [PATCH 1228/5547] Update framework

---
 osu.Android.props        | 2 +-
 osu.Game/osu.Game.csproj | 2 +-
 osu.iOS.props            | 4 ++--
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Android.props b/osu.Android.props
index d80fb858e9..d893792285 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -52,7 +52,7 @@
   </ItemGroup>
   <ItemGroup>
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1112.0" />
-    <PackageReference Include="ppy.osu.Framework.Android" Version="2021.1119.0" />
+    <PackageReference Include="ppy.osu.Framework.Android" Version="2021.1124.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
     <!-- Realm needs to be directly referenced in all Xamarin projects, as it will not pull in its transitive dependencies otherwise. -->
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 2f26e45ba8..f9c8d9743d 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="10.7.1" />
-    <PackageReference Include="ppy.osu.Framework" Version="2021.1119.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2021.1124.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1112.0" />
     <PackageReference Include="Sentry" Version="3.11.1" />
     <PackageReference Include="SharpCompress" Version="0.30.0" />
diff --git a/osu.iOS.props b/osu.iOS.props
index 4554469c19..47f8fbb43a 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -60,7 +60,7 @@
     <Reference Include="System.Net.Http" />
   </ItemGroup>
   <ItemGroup Label="Package References">
-    <PackageReference Include="ppy.osu.Framework.iOS" Version="2021.1119.0" />
+    <PackageReference Include="ppy.osu.Framework.iOS" Version="2021.1124.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1112.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net5.0 / net6.0) -->
@@ -83,7 +83,7 @@
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="2.2.6" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.Core" Version="2.2.6" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
-    <PackageReference Include="ppy.osu.Framework" Version="2021.1119.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2021.1124.0" />
     <PackageReference Include="SharpCompress" Version="0.30.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
     <PackageReference Include="SharpRaven" Version="2.4.0" />

From c7bc03e6f70ebe69de6906def31e7ccad4459ba9 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 24 Nov 2021 14:22:41 +0900
Subject: [PATCH 1229/5547] Add helper method for editor check tests

---
 .../Editing/Checks/CheckAudioInVideoTest.cs    |  7 +------
 .../Checks/CheckBackgroundQualityTest.cs       | 17 ++++-------------
 .../Editing/Checks/CheckFilePresenceTest.cs    | 14 ++++----------
 .../Editing/Checks/CheckTestHelpers.cs         | 18 ++++++++++++++++++
 .../Checks/CheckTooShortAudioFilesTest.cs      | 16 ++--------------
 .../Editing/Checks/CheckZeroByteFilesTest.cs   |  7 +------
 6 files changed, 30 insertions(+), 49 deletions(-)
 create mode 100644 osu.Game.Tests/Editing/Checks/CheckTestHelpers.cs

diff --git a/osu.Game.Tests/Editing/Checks/CheckAudioInVideoTest.cs b/osu.Game.Tests/Editing/Checks/CheckAudioInVideoTest.cs
index f9b16990ef..f9b7bfa586 100644
--- a/osu.Game.Tests/Editing/Checks/CheckAudioInVideoTest.cs
+++ b/osu.Game.Tests/Editing/Checks/CheckAudioInVideoTest.cs
@@ -12,7 +12,6 @@ using osu.Game.Rulesets.Objects;
 using osu.Game.Storyboards;
 using osu.Game.Tests.Beatmaps;
 using osu.Game.Tests.Resources;
-using FileInfo = osu.Game.IO.FileInfo;
 
 namespace osu.Game.Tests.Editing.Checks
 {
@@ -34,11 +33,7 @@ namespace osu.Game.Tests.Editing.Checks
                     {
                         Files =
                         {
-                            new BeatmapSetFileInfo
-                            {
-                                Filename = "abc123.mp4",
-                                FileInfo = new FileInfo { Hash = "abcdef" }
-                            }
+                            CheckTestHelpers.CreateMockFile("mp4"),
                         }
                     }
                 }
diff --git a/osu.Game.Tests/Editing/Checks/CheckBackgroundQualityTest.cs b/osu.Game.Tests/Editing/Checks/CheckBackgroundQualityTest.cs
index 5a45857e5c..bb560054a3 100644
--- a/osu.Game.Tests/Editing/Checks/CheckBackgroundQualityTest.cs
+++ b/osu.Game.Tests/Editing/Checks/CheckBackgroundQualityTest.cs
@@ -12,7 +12,6 @@ using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Edit;
 using osu.Game.Rulesets.Edit.Checks;
 using osu.Game.Rulesets.Objects;
-using FileInfo = osu.Game.IO.FileInfo;
 
 namespace osu.Game.Tests.Editing.Checks
 {
@@ -25,25 +24,17 @@ namespace osu.Game.Tests.Editing.Checks
         [SetUp]
         public void Setup()
         {
+            var file = CheckTestHelpers.CreateMockFile("jpg");
+
             check = new CheckBackgroundQuality();
             beatmap = new Beatmap<HitObject>
             {
                 BeatmapInfo = new BeatmapInfo
                 {
-                    Metadata = new BeatmapMetadata { BackgroundFile = "abc123.jpg" },
+                    Metadata = new BeatmapMetadata { BackgroundFile = file.Filename },
                     BeatmapSet = new BeatmapSetInfo
                     {
-                        Files =
-                        {
-                            new BeatmapSetFileInfo
-                            {
-                                Filename = "abc123.jpg",
-                                FileInfo = new FileInfo
-                                {
-                                    Hash = "abcdef"
-                                }
-                            }
-                        }
+                        Files = { file }
                     }
                 }
             };
diff --git a/osu.Game.Tests/Editing/Checks/CheckFilePresenceTest.cs b/osu.Game.Tests/Editing/Checks/CheckFilePresenceTest.cs
index 59dfc88923..f36454aa71 100644
--- a/osu.Game.Tests/Editing/Checks/CheckFilePresenceTest.cs
+++ b/osu.Game.Tests/Editing/Checks/CheckFilePresenceTest.cs
@@ -4,7 +4,6 @@
 using System.Linq;
 using NUnit.Framework;
 using osu.Game.Beatmaps;
-using osu.Game.IO;
 using osu.Game.Rulesets.Edit;
 using osu.Game.Rulesets.Edit.Checks;
 using osu.Game.Rulesets.Objects;
@@ -21,22 +20,17 @@ namespace osu.Game.Tests.Editing.Checks
         [SetUp]
         public void Setup()
         {
+            var file = CheckTestHelpers.CreateMockFile("jpg");
+
             check = new CheckBackgroundPresence();
             beatmap = new Beatmap<HitObject>
             {
                 BeatmapInfo = new BeatmapInfo
                 {
-                    Metadata = new BeatmapMetadata { BackgroundFile = "abc123.jpg" },
+                    Metadata = new BeatmapMetadata { BackgroundFile = file.Filename },
                     BeatmapSet = new BeatmapSetInfo
                     {
-                        Files =
-                        {
-                            new BeatmapSetFileInfo
-                            {
-                                Filename = "abc123.jpg",
-                                FileInfo = new FileInfo { Hash = "abcdef" }
-                            }
-                        }
+                        Files = { file }
                     }
                 }
             };
diff --git a/osu.Game.Tests/Editing/Checks/CheckTestHelpers.cs b/osu.Game.Tests/Editing/Checks/CheckTestHelpers.cs
new file mode 100644
index 0000000000..f702921986
--- /dev/null
+++ b/osu.Game.Tests/Editing/Checks/CheckTestHelpers.cs
@@ -0,0 +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 osu.Game.Beatmaps;
+using osu.Game.IO;
+
+namespace osu.Game.Tests.Editing.Checks
+{
+    public static class CheckTestHelpers
+    {
+        public static BeatmapSetFileInfo CreateMockFile(string extension) =>
+            new BeatmapSetFileInfo
+            {
+                Filename = $"abc123.{extension}",
+                FileInfo = new FileInfo { Hash = "abcdef" }
+            };
+    }
+}
diff --git a/osu.Game.Tests/Editing/Checks/CheckTooShortAudioFilesTest.cs b/osu.Game.Tests/Editing/Checks/CheckTooShortAudioFilesTest.cs
index 64285cd46e..8adf0d3764 100644
--- a/osu.Game.Tests/Editing/Checks/CheckTooShortAudioFilesTest.cs
+++ b/osu.Game.Tests/Editing/Checks/CheckTooShortAudioFilesTest.cs
@@ -13,7 +13,6 @@ using osu.Game.Rulesets.Objects;
 using osu.Game.Tests.Beatmaps;
 using osu.Game.Tests.Resources;
 using osuTK.Audio;
-using FileInfo = osu.Game.IO.FileInfo;
 
 namespace osu.Game.Tests.Editing.Checks
 {
@@ -33,14 +32,7 @@ namespace osu.Game.Tests.Editing.Checks
                 {
                     BeatmapSet = new BeatmapSetInfo
                     {
-                        Files =
-                        {
-                            new BeatmapSetFileInfo
-                            {
-                                Filename = "abc123.wav",
-                                FileInfo = new FileInfo { Hash = "abcdef" }
-                            }
-                        }
+                        Files = { CheckTestHelpers.CreateMockFile("wav") }
                     }
                 }
             };
@@ -54,11 +46,7 @@ namespace osu.Game.Tests.Editing.Checks
         public void TestDifferentExtension()
         {
             beatmap.BeatmapInfo.BeatmapSet.Files.Clear();
-            beatmap.BeatmapInfo.BeatmapSet.Files.Add(new BeatmapSetFileInfo
-            {
-                Filename = "abc123.jpg",
-                FileInfo = new FileInfo { Hash = "abcdef" }
-            });
+            beatmap.BeatmapInfo.BeatmapSet.Files.Add(CheckTestHelpers.CreateMockFile("jpg"));
 
             // Should fail to load, but not produce an error due to the extension not being expected to load.
             Assert.IsEmpty(check.Run(getContext(null, allowMissing: true)));
diff --git a/osu.Game.Tests/Editing/Checks/CheckZeroByteFilesTest.cs b/osu.Game.Tests/Editing/Checks/CheckZeroByteFilesTest.cs
index 1a581cc27d..79d00e6a60 100644
--- a/osu.Game.Tests/Editing/Checks/CheckZeroByteFilesTest.cs
+++ b/osu.Game.Tests/Editing/Checks/CheckZeroByteFilesTest.cs
@@ -9,7 +9,6 @@ using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Edit;
 using osu.Game.Rulesets.Edit.Checks;
 using osu.Game.Rulesets.Objects;
-using FileInfo = osu.Game.IO.FileInfo;
 
 namespace osu.Game.Tests.Editing.Checks
 {
@@ -31,11 +30,7 @@ namespace osu.Game.Tests.Editing.Checks
                     {
                         Files =
                         {
-                            new BeatmapSetFileInfo
-                            {
-                                Filename = "abc123.jpg",
-                                FileInfo = new FileInfo { Hash = "abcdef" }
-                            }
+                            CheckTestHelpers.CreateMockFile("jpg"),
                         }
                     }
                 }

From a7853fc9cc96fa50b92b12b5c25dee18f9ccc11a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 24 Nov 2021 14:26:23 +0900
Subject: [PATCH 1230/5547] Fix cases of known-non-null

---
 osu.Game/Beatmaps/WorkingBeatmapCache.cs   | 2 --
 osu.Game/Overlays/Music/PlaylistOverlay.cs | 2 +-
 2 files changed, 1 insertion(+), 3 deletions(-)

diff --git a/osu.Game/Beatmaps/WorkingBeatmapCache.cs b/osu.Game/Beatmaps/WorkingBeatmapCache.cs
index 0af28902a0..857a1ca06f 100644
--- a/osu.Game/Beatmaps/WorkingBeatmapCache.cs
+++ b/osu.Game/Beatmaps/WorkingBeatmapCache.cs
@@ -55,8 +55,6 @@ namespace osu.Game.Beatmaps
 
         public void Invalidate(BeatmapSetInfo info)
         {
-            if (info.Beatmaps == null) return;
-
             foreach (var b in info.Beatmaps)
                 Invalidate(b);
         }
diff --git a/osu.Game/Overlays/Music/PlaylistOverlay.cs b/osu.Game/Overlays/Music/PlaylistOverlay.cs
index b8d04eab4e..41c4942c55 100644
--- a/osu.Game/Overlays/Music/PlaylistOverlay.cs
+++ b/osu.Game/Overlays/Music/PlaylistOverlay.cs
@@ -77,7 +77,7 @@ namespace osu.Game.Overlays.Music
 
             filter.Search.OnCommit += (sender, newText) =>
             {
-                BeatmapInfo toSelect = list.FirstVisibleSet?.Beatmaps?.FirstOrDefault();
+                BeatmapInfo toSelect = list.FirstVisibleSet?.Beatmaps.FirstOrDefault();
 
                 if (toSelect != null)
                 {

From 44c34ca7b2473d65e24dffde56ca2270724267dd Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 24 Nov 2021 14:32:18 +0900
Subject: [PATCH 1231/5547] Revert changes causing `BeatmapSet.Metadata` to be
 expectedly null in some tests

---
 ...stSceneOnlinePlayBeatmapAvailabilityTracker.cs |  1 +
 .../TestSceneMultiplayerMatchSongSelect.cs        | 15 ++++++++-------
 .../Multiplayer/TestScenePlaylistsSongSelect.cs   |  1 +
 .../Visual/SongSelect/TestSceneBeatmapCarousel.cs |  3 +++
 .../SongSelect/TestSceneBeatmapRecommendations.cs |  1 +
 .../Visual/SongSelect/TestScenePlaySongSelect.cs  | 15 ++++++++-------
 6 files changed, 22 insertions(+), 14 deletions(-)

diff --git a/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs b/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
index 748de6c9a8..0fba0eb7a9 100644
--- a/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
+++ b/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
@@ -148,6 +148,7 @@ namespace osu.Game.Tests.Online
                 Debug.Assert(info.BeatmapSet != null);
 
                 info.BeatmapSet.Beatmaps.Add(info);
+                info.BeatmapSet.Metadata = info.Metadata;
                 info.MD5Hash = stream.ComputeMD5Hash();
                 info.Hash = stream.ComputeSHA2Hash();
             }
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs
index f308886bf4..6b67a979e5 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs
@@ -47,10 +47,18 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             beatmaps = new List<BeatmapInfo>();
 
+            var metadata = new BeatmapMetadata
+            {
+                Artist = "Some Artist",
+                Title = "Some Beatmap",
+                AuthorString = "Some Author"
+            };
+
             var beatmapSetInfo = new BeatmapSetInfo
             {
                 OnlineID = 10,
                 Hash = Guid.NewGuid().ToString().ComputeMD5Hash(),
+                Metadata = metadata,
                 DateAdded = DateTimeOffset.UtcNow
             };
 
@@ -61,13 +69,6 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 int length = RNG.Next(30000, 200000);
                 double bpm = RNG.NextSingle(80, 200);
 
-                var metadata = new BeatmapMetadata
-                {
-                    Artist = "Some Artist",
-                    Title = "Some Beatmap",
-                    AuthorString = "Some Author"
-                };
-
                 var beatmap = new BeatmapInfo
                 {
                     Ruleset = rulesets.GetRuleset(i % 4),
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsSongSelect.cs b/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsSongSelect.cs
index 04e47e17e5..3e24b7a1d0 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsSongSelect.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsSongSelect.cs
@@ -53,6 +53,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             {
                 OnlineID = 10,
                 Hash = new MemoryStream(Encoding.UTF8.GetBytes(Guid.NewGuid().ToString())).ComputeMD5Hash(),
+                Metadata = metadata,
                 DateAdded = DateTimeOffset.UtcNow,
             };
 
diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs
index 512e34975e..1808f98c23 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs
@@ -846,8 +846,10 @@ namespace osu.Game.Tests.Visual.SongSelect
 
             var beatmapSet = new BeatmapSetInfo
             {
+                ID = id,
                 OnlineID = id,
                 Hash = new MemoryStream(Encoding.UTF8.GetBytes(Guid.NewGuid().ToString())).ComputeMD5Hash(),
+                Metadata = metadata,
             };
 
             foreach (var b in getBeatmaps(randomDifficultyCount ? RNG.Next(1, 20) : 3, metadata))
@@ -899,6 +901,7 @@ namespace osu.Game.Tests.Visual.SongSelect
             {
                 OnlineID = id,
                 Hash = new MemoryStream(Encoding.UTF8.GetBytes(Guid.NewGuid().ToString())).ComputeMD5Hash(),
+                Metadata = metadata,
             };
 
             for (int b = 1; b < 101; b++)
diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapRecommendations.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapRecommendations.cs
index 73144b584f..7d855a88e2 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapRecommendations.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapRecommendations.cs
@@ -182,6 +182,7 @@ namespace osu.Game.Tests.Visual.SongSelect
             {
                 Hash = Guid.NewGuid().ToString(),
                 OnlineID = importID,
+                Metadata = metadata,
             };
 
             beatmapSet.Beatmaps.AddRange(difficultyRulesets.Select((ruleset, difficultyIndex) => new BeatmapInfo
diff --git a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
index 025c7f0dfd..c89b7e858b 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
@@ -907,13 +907,6 @@ namespace osu.Game.Tests.Visual.SongSelect
 
             int setId = getImportId();
 
-            var beatmapSet = new BeatmapSetInfo
-            {
-                OnlineID = setId,
-                Hash = new MemoryStream(Encoding.UTF8.GetBytes(Guid.NewGuid().ToString())).ComputeMD5Hash(),
-                DateAdded = DateTimeOffset.UtcNow,
-            };
-
             var metadata = new BeatmapMetadata
             {
                 // Create random metadata, then we can check if sorting works based on these
@@ -922,6 +915,14 @@ namespace osu.Game.Tests.Visual.SongSelect
                 AuthorString = "Some Guy " + RNG.Next(0, 9),
             };
 
+            var beatmapSet = new BeatmapSetInfo
+            {
+                OnlineID = setId,
+                Hash = new MemoryStream(Encoding.UTF8.GetBytes(Guid.NewGuid().ToString())).ComputeMD5Hash(),
+                DateAdded = DateTimeOffset.UtcNow,
+                Metadata = metadata
+            };
+
             for (int i = 0; i < countPerRuleset; i++)
             {
                 int beatmapId = setId * 1000 + i;

From 3946a39b65c7734285bca71dbd54f00801b9f32f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 24 Nov 2021 15:01:45 +0900
Subject: [PATCH 1232/5547] Make `BeatmapSet.Metadata` non-null

---
 osu.Game.Tests/Models/DisplayStringTest.cs | 12 ++++++------
 osu.Game/Beatmaps/BeatmapSetInfo.cs        |  2 +-
 osu.Game/Beatmaps/IBeatmapSetInfo.cs       |  2 +-
 osu.Game/Extensions/ModelExtensions.cs     |  2 +-
 osu.Game/Models/RealmBeatmapSet.cs         |  4 ++--
 5 files changed, 11 insertions(+), 11 deletions(-)

diff --git a/osu.Game.Tests/Models/DisplayStringTest.cs b/osu.Game.Tests/Models/DisplayStringTest.cs
index 95af21eb5f..2d0bda88e4 100644
--- a/osu.Game.Tests/Models/DisplayStringTest.cs
+++ b/osu.Game.Tests/Models/DisplayStringTest.cs
@@ -29,9 +29,9 @@ namespace osu.Game.Tests.Models
         {
             var mock = new Mock<IBeatmapSetInfo>();
 
-            mock.Setup(m => m.Metadata!.Artist).Returns("artist");
-            mock.Setup(m => m.Metadata!.Title).Returns("title");
-            mock.Setup(m => m.Metadata!.Author.Username).Returns("author");
+            mock.Setup(m => m.Metadata.Artist).Returns("artist");
+            mock.Setup(m => m.Metadata.Title).Returns("title");
+            mock.Setup(m => m.Metadata.Author.Username).Returns("author");
 
             Assert.That(mock.Object.GetDisplayString(), Is.EqualTo("artist - title (author)"));
         }
@@ -41,9 +41,9 @@ namespace osu.Game.Tests.Models
         {
             var mock = new Mock<IBeatmapSetInfo>();
 
-            mock.Setup(m => m.Metadata!.Artist).Returns("artist");
-            mock.Setup(m => m.Metadata!.Title).Returns("title");
-            mock.Setup(m => m.Metadata!.Author.Username).Returns(string.Empty);
+            mock.Setup(m => m.Metadata.Artist).Returns("artist");
+            mock.Setup(m => m.Metadata.Title).Returns("title");
+            mock.Setup(m => m.Metadata.Author.Username).Returns(string.Empty);
 
             Assert.That(mock.Object.GetDisplayString(), Is.EqualTo("artist - title"));
         }
diff --git a/osu.Game/Beatmaps/BeatmapSetInfo.cs b/osu.Game/Beatmaps/BeatmapSetInfo.cs
index 35468ce831..47960201d8 100644
--- a/osu.Game/Beatmaps/BeatmapSetInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapSetInfo.cs
@@ -89,7 +89,7 @@ namespace osu.Game.Beatmaps
 
         #region Implementation of IBeatmapSetInfo
 
-        IBeatmapMetadataInfo IBeatmapSetInfo.Metadata => Metadata;
+        IBeatmapMetadataInfo IBeatmapSetInfo.Metadata => Metadata ?? Beatmaps.FirstOrDefault()?.Metadata ?? new BeatmapMetadata();
         IEnumerable<IBeatmapInfo> IBeatmapSetInfo.Beatmaps => Beatmaps;
         IEnumerable<INamedFileUsage> IBeatmapSetInfo.Files => Files;
 
diff --git a/osu.Game/Beatmaps/IBeatmapSetInfo.cs b/osu.Game/Beatmaps/IBeatmapSetInfo.cs
index 67f38397d4..aa114c8472 100644
--- a/osu.Game/Beatmaps/IBeatmapSetInfo.cs
+++ b/osu.Game/Beatmaps/IBeatmapSetInfo.cs
@@ -22,7 +22,7 @@ namespace osu.Game.Beatmaps
         /// <summary>
         /// The best-effort metadata representing this set. In the case metadata differs between contained beatmaps, one is arbitrarily chosen.
         /// </summary>
-        IBeatmapMetadataInfo? Metadata { get; }
+        IBeatmapMetadataInfo Metadata { get; }
 
         /// <summary>
         /// All beatmaps contained in this set.
diff --git a/osu.Game/Extensions/ModelExtensions.cs b/osu.Game/Extensions/ModelExtensions.cs
index aaf87385c8..9f00d21383 100644
--- a/osu.Game/Extensions/ModelExtensions.cs
+++ b/osu.Game/Extensions/ModelExtensions.cs
@@ -42,7 +42,7 @@ namespace osu.Game.Extensions
             switch (model)
             {
                 case IBeatmapSetInfo beatmapSetInfo:
-                    result = beatmapSetInfo.Metadata?.GetDisplayTitle();
+                    result = beatmapSetInfo.Metadata.GetDisplayTitle();
                     break;
 
                 case IBeatmapInfo beatmapInfo:
diff --git a/osu.Game/Models/RealmBeatmapSet.cs b/osu.Game/Models/RealmBeatmapSet.cs
index da75978977..ff39bcf13e 100644
--- a/osu.Game/Models/RealmBeatmapSet.cs
+++ b/osu.Game/Models/RealmBeatmapSet.cs
@@ -26,7 +26,7 @@ namespace osu.Game.Models
 
         public DateTimeOffset DateAdded { get; set; }
 
-        public IBeatmapMetadataInfo? Metadata => Beatmaps.FirstOrDefault()?.Metadata;
+        public IBeatmapMetadataInfo Metadata => Beatmaps.FirstOrDefault()?.Metadata ?? new RealmBeatmapMetadata();
 
         public IList<RealmBeatmap> Beatmaps { get; } = null!;
 
@@ -62,7 +62,7 @@ namespace osu.Game.Models
             return ID == other.ID;
         }
 
-        public override string ToString() => Metadata?.GetDisplayString() ?? base.ToString();
+        public override string ToString() => Metadata.GetDisplayString();
 
         public bool Equals(IBeatmapSetInfo? other) => other is RealmBeatmapSet b && Equals(b);
 

From cb093e1e017202836d14ad233ddb13b959eec15a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 24 Nov 2021 15:08:04 +0900
Subject: [PATCH 1233/5547] Remove reundant self-sets of metadata

---
 .../Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs      | 1 -
 osu.Game/Tests/Beatmaps/TestBeatmap.cs                           | 1 -
 2 files changed, 2 deletions(-)

diff --git a/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs b/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
index 0fba0eb7a9..a4c69075be 100644
--- a/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
+++ b/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
@@ -143,7 +143,6 @@ namespace osu.Game.Tests.Online
                 var beatmap = decoder.Decode(reader);
 
                 info = beatmap.BeatmapInfo;
-                info.Metadata = info.Metadata;
 
                 Debug.Assert(info.BeatmapSet != null);
 
diff --git a/osu.Game/Tests/Beatmaps/TestBeatmap.cs b/osu.Game/Tests/Beatmaps/TestBeatmap.cs
index 729253e25c..99944bcf6d 100644
--- a/osu.Game/Tests/Beatmaps/TestBeatmap.cs
+++ b/osu.Game/Tests/Beatmaps/TestBeatmap.cs
@@ -33,7 +33,6 @@ namespace osu.Game.Tests.Beatmaps
 
             BeatmapInfo.Ruleset = ruleset;
             BeatmapInfo.RulesetID = ruleset.ID ?? 0;
-            BeatmapInfo.Metadata = BeatmapInfo.Metadata;
             BeatmapInfo.Length = 75000;
             BeatmapInfo.OnlineInfo = new APIBeatmap();
             BeatmapInfo.OnlineID = Interlocked.Increment(ref onlineBeatmapID);

From db2d8b6d8bf875deddccecd0d583982060c30718 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 22 Nov 2021 16:08:42 +0900
Subject: [PATCH 1234/5547] Fix ruleset instance creation null checks

---
 .../Components/TestSceneTournamentModDisplay.cs            | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Tournament.Tests/Components/TestSceneTournamentModDisplay.cs b/osu.Game.Tournament.Tests/Components/TestSceneTournamentModDisplay.cs
index 3c22bdca03..3cd13df0d3 100644
--- a/osu.Game.Tournament.Tests/Components/TestSceneTournamentModDisplay.cs
+++ b/osu.Game.Tournament.Tests/Components/TestSceneTournamentModDisplay.cs
@@ -42,7 +42,12 @@ namespace osu.Game.Tournament.Tests.Components
 
         private void success(APIBeatmap beatmap)
         {
-            var mods = rulesets.GetRuleset(Ladder.Ruleset.Value.ID ?? 0).CreateInstance().AllMods;
+            var ruleset = rulesets.GetRuleset(Ladder.Ruleset.Value.OnlineID);
+
+            if (ruleset == null)
+                return;
+
+            var mods = ruleset.CreateInstance().AllMods;
 
             foreach (var mod in mods)
             {

From eff1293b5b3bd867fe165e9b87ac21c43e5282b5 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 24 Nov 2021 15:26:40 +0900
Subject: [PATCH 1235/5547] Revert "Run nunit in blame mode"

This reverts commit 215c179b929a29e0c083422f29a6031f9450ffe3.
---
 .github/workflows/ci.yml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 2139572601..68f8ef51ef 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -38,7 +38,7 @@ jobs:
         run: dotnet build -c Debug -warnaserror osu.Desktop.slnf
 
       - name: Test
-        run: dotnet test $pwd/*.Tests/bin/Debug/*/*.Tests.dll --blame-crash --blame-hang --blame-hang-timeout 5m --logger "trx;LogFileName=TestResults-${{matrix.os.prettyname}}-${{matrix.threadingMode}}.trx"
+        run: dotnet test $pwd/*.Tests/bin/Debug/*/*.Tests.dll --logger "trx;LogFileName=TestResults-${{matrix.os.prettyname}}-${{matrix.threadingMode}}.trx"
         shell: pwsh
 
       # Attempt to upload results even if test fails.
@@ -48,7 +48,7 @@ jobs:
         if: ${{ always() }}
         with:
           name: osu-test-results-${{matrix.os.prettyname}}-${{matrix.threadingMode}}
-          path: ${{github.workspace}}/TestResults/**/*
+          path: ${{github.workspace}}/TestResults/TestResults-${{matrix.os.prettyname}}-${{matrix.threadingMode}}.trx
 
   build-only-android:
     name: Build only (Android)

From e57c343531f5fe5bc8a5a34d64f7907fcf0eee6f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 24 Nov 2021 15:23:05 +0900
Subject: [PATCH 1236/5547] Add helper setter to EF `RulesetInfo.OnlineID` to
 allow updating usages

---
 osu.Game/Rulesets/RulesetInfo.cs | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Rulesets/RulesetInfo.cs b/osu.Game/Rulesets/RulesetInfo.cs
index 77be39650f..4a146c05bf 100644
--- a/osu.Game/Rulesets/RulesetInfo.cs
+++ b/osu.Game/Rulesets/RulesetInfo.cs
@@ -2,6 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
+using System.ComponentModel.DataAnnotations.Schema;
 using System.Diagnostics.CodeAnalysis;
 using Newtonsoft.Json;
 using osu.Framework.Testing;
@@ -65,7 +66,12 @@ namespace osu.Game.Rulesets
 
         #region Implementation of IHasOnlineID
 
-        public int OnlineID => ID ?? -1;
+        [NotMapped]
+        public int OnlineID
+        {
+            get => ID ?? -1;
+            set => ID = value >= 0 ? value : (int?)null;
+        }
 
         #endregion
     }

From f283770f34354422a1e4974907ac833cc8b8b268 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 22 Nov 2021 14:26:24 +0900
Subject: [PATCH 1237/5547] Update mock `RulesetInfo` usage to set `OnlineID`
 instead of `ID`

---
 .../TestSceneBeatmapDifficultyCache.cs        | 16 +++----
 .../NonVisual/Filtering/FilterMatchingTest.cs | 12 +++---
 .../Testing/TestSceneRulesetDependencies.cs   |  2 +-
 .../TestScenePlayerScoreSubmission.cs         |  2 +-
 .../Visual/Gameplay/TestSceneSpectatorHost.cs |  2 +-
 .../Navigation/TestSceneScreenNavigation.cs   |  4 +-
 .../Online/TestSceneBeatmapSetOverlay.cs      |  2 +-
 .../Visual/Online/TestSceneDirectPanel.cs     |  2 +-
 .../Online/TestSceneNowPlayingCommand.cs      |  2 +-
 .../TestSceneBeatmapRecommendations.cs        |  2 +-
 .../SongSelect/TestScenePlaySongSelect.cs     | 42 +++++++++----------
 .../TestSceneModSelectOverlay.cs              |  4 +-
 .../API/Requests/Responses/APIBeatmap.cs      |  2 +-
 .../API/Requests/Responses/APIScoreInfo.cs    |  2 +-
 osu.Game/Rulesets/Ruleset.cs                  |  2 +-
 15 files changed, 49 insertions(+), 49 deletions(-)

diff --git a/osu.Game.Tests/Beatmaps/TestSceneBeatmapDifficultyCache.cs b/osu.Game.Tests/Beatmaps/TestSceneBeatmapDifficultyCache.cs
index f84dbca0be..2a60a7b96d 100644
--- a/osu.Game.Tests/Beatmaps/TestSceneBeatmapDifficultyCache.cs
+++ b/osu.Game.Tests/Beatmaps/TestSceneBeatmapDifficultyCache.cs
@@ -100,8 +100,8 @@ namespace osu.Game.Tests.Beatmaps
         [Test]
         public void TestKeyEqualsWithDifferentModInstances()
         {
-            var key1 = new BeatmapDifficultyCache.DifficultyCacheLookup(new BeatmapInfo { ID = 1234 }, new RulesetInfo { ID = 0 }, new Mod[] { new OsuModHardRock(), new OsuModHidden() });
-            var key2 = new BeatmapDifficultyCache.DifficultyCacheLookup(new BeatmapInfo { ID = 1234 }, new RulesetInfo { ID = 0 }, new Mod[] { new OsuModHardRock(), new OsuModHidden() });
+            var key1 = new BeatmapDifficultyCache.DifficultyCacheLookup(new BeatmapInfo { ID = 1234 }, new RulesetInfo { OnlineID = 0 }, new Mod[] { new OsuModHardRock(), new OsuModHidden() });
+            var key2 = new BeatmapDifficultyCache.DifficultyCacheLookup(new BeatmapInfo { ID = 1234 }, new RulesetInfo { OnlineID = 0 }, new Mod[] { new OsuModHardRock(), new OsuModHidden() });
 
             Assert.That(key1, Is.EqualTo(key2));
             Assert.That(key1.GetHashCode(), Is.EqualTo(key2.GetHashCode()));
@@ -110,8 +110,8 @@ namespace osu.Game.Tests.Beatmaps
         [Test]
         public void TestKeyEqualsWithDifferentModOrder()
         {
-            var key1 = new BeatmapDifficultyCache.DifficultyCacheLookup(new BeatmapInfo { ID = 1234 }, new RulesetInfo { ID = 0 }, new Mod[] { new OsuModHardRock(), new OsuModHidden() });
-            var key2 = new BeatmapDifficultyCache.DifficultyCacheLookup(new BeatmapInfo { ID = 1234 }, new RulesetInfo { ID = 0 }, new Mod[] { new OsuModHidden(), new OsuModHardRock() });
+            var key1 = new BeatmapDifficultyCache.DifficultyCacheLookup(new BeatmapInfo { ID = 1234 }, new RulesetInfo { OnlineID = 0 }, new Mod[] { new OsuModHardRock(), new OsuModHidden() });
+            var key2 = new BeatmapDifficultyCache.DifficultyCacheLookup(new BeatmapInfo { ID = 1234 }, new RulesetInfo { OnlineID = 0 }, new Mod[] { new OsuModHidden(), new OsuModHardRock() });
 
             Assert.That(key1, Is.EqualTo(key2));
             Assert.That(key1.GetHashCode(), Is.EqualTo(key2.GetHashCode()));
@@ -120,8 +120,8 @@ namespace osu.Game.Tests.Beatmaps
         [Test]
         public void TestKeyDoesntEqualWithDifferentModSettings()
         {
-            var key1 = new BeatmapDifficultyCache.DifficultyCacheLookup(new BeatmapInfo { ID = 1234 }, new RulesetInfo { ID = 0 }, new Mod[] { new OsuModDoubleTime { SpeedChange = { Value = 1.1 } } });
-            var key2 = new BeatmapDifficultyCache.DifficultyCacheLookup(new BeatmapInfo { ID = 1234 }, new RulesetInfo { ID = 0 }, new Mod[] { new OsuModDoubleTime { SpeedChange = { Value = 1.9 } } });
+            var key1 = new BeatmapDifficultyCache.DifficultyCacheLookup(new BeatmapInfo { ID = 1234 }, new RulesetInfo { OnlineID = 0 }, new Mod[] { new OsuModDoubleTime { SpeedChange = { Value = 1.1 } } });
+            var key2 = new BeatmapDifficultyCache.DifficultyCacheLookup(new BeatmapInfo { ID = 1234 }, new RulesetInfo { OnlineID = 0 }, new Mod[] { new OsuModDoubleTime { SpeedChange = { Value = 1.9 } } });
 
             Assert.That(key1, Is.Not.EqualTo(key2));
             Assert.That(key1.GetHashCode(), Is.Not.EqualTo(key2.GetHashCode()));
@@ -130,8 +130,8 @@ namespace osu.Game.Tests.Beatmaps
         [Test]
         public void TestKeyEqualWithMatchingModSettings()
         {
-            var key1 = new BeatmapDifficultyCache.DifficultyCacheLookup(new BeatmapInfo { ID = 1234 }, new RulesetInfo { ID = 0 }, new Mod[] { new OsuModDoubleTime { SpeedChange = { Value = 1.25 } } });
-            var key2 = new BeatmapDifficultyCache.DifficultyCacheLookup(new BeatmapInfo { ID = 1234 }, new RulesetInfo { ID = 0 }, new Mod[] { new OsuModDoubleTime { SpeedChange = { Value = 1.25 } } });
+            var key1 = new BeatmapDifficultyCache.DifficultyCacheLookup(new BeatmapInfo { ID = 1234 }, new RulesetInfo { OnlineID = 0 }, new Mod[] { new OsuModDoubleTime { SpeedChange = { Value = 1.25 } } });
+            var key2 = new BeatmapDifficultyCache.DifficultyCacheLookup(new BeatmapInfo { ID = 1234 }, new RulesetInfo { OnlineID = 0 }, new Mod[] { new OsuModDoubleTime { SpeedChange = { Value = 1.25 } } });
 
             Assert.That(key1, Is.EqualTo(key2));
             Assert.That(key1.GetHashCode(), Is.EqualTo(key2.GetHashCode()));
diff --git a/osu.Game.Tests/NonVisual/Filtering/FilterMatchingTest.cs b/osu.Game.Tests/NonVisual/Filtering/FilterMatchingTest.cs
index ee1feeca8d..e49b0d3a67 100644
--- a/osu.Game.Tests/NonVisual/Filtering/FilterMatchingTest.cs
+++ b/osu.Game.Tests/NonVisual/Filtering/FilterMatchingTest.cs
@@ -16,7 +16,7 @@ namespace osu.Game.Tests.NonVisual.Filtering
     {
         private BeatmapInfo getExampleBeatmap() => new BeatmapInfo
         {
-            Ruleset = new RulesetInfo { ID = 5 },
+            Ruleset = new RulesetInfo { OnlineID = 5 },
             StarRating = 4.0d,
             BaseDifficulty = new BeatmapDifficulty
             {
@@ -57,7 +57,7 @@ namespace osu.Game.Tests.NonVisual.Filtering
             var exampleBeatmapInfo = getExampleBeatmap();
             var criteria = new FilterCriteria
             {
-                Ruleset = new RulesetInfo { ID = 6 }
+                Ruleset = new RulesetInfo { OnlineID = 6 }
             };
             var carouselItem = new CarouselBeatmap(exampleBeatmapInfo);
             carouselItem.Filter(criteria);
@@ -70,7 +70,7 @@ namespace osu.Game.Tests.NonVisual.Filtering
             var exampleBeatmapInfo = getExampleBeatmap();
             var criteria = new FilterCriteria
             {
-                Ruleset = new RulesetInfo { ID = 6 },
+                Ruleset = new RulesetInfo { OnlineID = 6 },
                 AllowConvertedBeatmaps = true
             };
             var carouselItem = new CarouselBeatmap(exampleBeatmapInfo);
@@ -86,7 +86,7 @@ namespace osu.Game.Tests.NonVisual.Filtering
             var exampleBeatmapInfo = getExampleBeatmap();
             var criteria = new FilterCriteria
             {
-                Ruleset = new RulesetInfo { ID = 6 },
+                Ruleset = new RulesetInfo { OnlineID = 6 },
                 AllowConvertedBeatmaps = true,
                 ApproachRate = new FilterCriteria.OptionalRange<float>
                 {
@@ -107,7 +107,7 @@ namespace osu.Game.Tests.NonVisual.Filtering
             var exampleBeatmapInfo = getExampleBeatmap();
             var criteria = new FilterCriteria
             {
-                Ruleset = new RulesetInfo { ID = 6 },
+                Ruleset = new RulesetInfo { OnlineID = 6 },
                 AllowConvertedBeatmaps = true,
                 BPM = new FilterCriteria.OptionalRange<double>
                 {
@@ -132,7 +132,7 @@ namespace osu.Game.Tests.NonVisual.Filtering
             var exampleBeatmapInfo = getExampleBeatmap();
             var criteria = new FilterCriteria
             {
-                Ruleset = new RulesetInfo { ID = 6 },
+                Ruleset = new RulesetInfo { OnlineID = 6 },
                 AllowConvertedBeatmaps = true,
                 SearchText = terms
             };
diff --git a/osu.Game.Tests/Testing/TestSceneRulesetDependencies.cs b/osu.Game.Tests/Testing/TestSceneRulesetDependencies.cs
index bb9b705c7e..330d3dd2ae 100644
--- a/osu.Game.Tests/Testing/TestSceneRulesetDependencies.cs
+++ b/osu.Game.Tests/Testing/TestSceneRulesetDependencies.cs
@@ -70,7 +70,7 @@ namespace osu.Game.Tests.Testing
             {
                 // temporary ID to let RulesetConfigCache pass our
                 // config manager to the ruleset dependencies.
-                RulesetInfo.ID = -1;
+                RulesetInfo.OnlineID = -1;
             }
 
             public override IResourceStore<byte[]> CreateResourceStore() => new NamespacedResourceStore<byte[]>(TestResources.GetStore(), @"Resources");
diff --git a/osu.Game.Tests/Visual/Gameplay/TestScenePlayerScoreSubmission.cs b/osu.Game.Tests/Visual/Gameplay/TestScenePlayerScoreSubmission.cs
index cb5058779c..324a132120 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestScenePlayerScoreSubmission.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestScenePlayerScoreSubmission.cs
@@ -233,7 +233,7 @@ namespace osu.Game.Tests.Visual.Gameplay
         {
             prepareTokenResponse(true);
 
-            createPlayerTest(false, createRuleset: () => new OsuRuleset { RulesetInfo = { ID = rulesetId } });
+            createPlayerTest(false, createRuleset: () => new OsuRuleset { RulesetInfo = { OnlineID = rulesetId ?? -1 } });
 
             AddUntilStep("wait for token request", () => Player.TokenCreationRequested);
 
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorHost.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorHost.cs
index 2a82c65c7c..409cec4cf6 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorHost.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorHost.cs
@@ -38,7 +38,7 @@ namespace osu.Game.Tests.Visual.Gameplay
         public void TestClientSendsCorrectRuleset()
         {
             AddUntilStep("spectator client sending frames", () => spectatorClient.PlayingUserStates.ContainsKey(dummy_user_id));
-            AddAssert("spectator client sent correct ruleset", () => spectatorClient.PlayingUserStates[dummy_user_id].RulesetID == Ruleset.Value.ID);
+            AddAssert("spectator client sent correct ruleset", () => spectatorClient.PlayingUserStates[dummy_user_id].RulesetID == Ruleset.Value.OnlineID);
         }
 
         public override void TearDownSteps()
diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs b/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
index ef71c54e03..497c68cf2e 100644
--- a/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
@@ -257,7 +257,7 @@ namespace osu.Game.Tests.Visual.Navigation
                 InputManager.ReleaseKey(Key.ControlLeft);
             });
 
-            AddAssert("Ruleset changed to osu!taiko", () => Game.Toolbar.ChildrenOfType<ToolbarRulesetSelector>().Single().Current.Value.ID == 1);
+            AddAssert("Ruleset changed to osu!taiko", () => Game.Toolbar.ChildrenOfType<ToolbarRulesetSelector>().Single().Current.Value.OnlineID == 1);
 
             AddAssert("Mods overlay still visible", () => songSelect.ModSelectOverlay.State.Value == Visibility.Visible);
         }
@@ -278,7 +278,7 @@ namespace osu.Game.Tests.Visual.Navigation
                 InputManager.ReleaseKey(Key.ControlLeft);
             });
 
-            AddAssert("Ruleset changed to osu!taiko", () => Game.Toolbar.ChildrenOfType<ToolbarRulesetSelector>().Single().Current.Value.ID == 1);
+            AddAssert("Ruleset changed to osu!taiko", () => Game.Toolbar.ChildrenOfType<ToolbarRulesetSelector>().Single().Current.Value.OnlineID == 1);
 
             AddAssert("Options overlay still visible", () => songSelect.BeatmapOptionsOverlay.State.Value == Visibility.Visible);
         }
diff --git a/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlay.cs b/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlay.cs
index 86863c0b5d..3314e291e8 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlay.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlay.cs
@@ -200,7 +200,7 @@ namespace osu.Game.Tests.Visual.Online
                 {
                     OnlineID = i * 10,
                     DifficultyName = $"Test #{i}",
-                    RulesetID = Ruleset.Value.ID ?? -1,
+                    RulesetID = Ruleset.Value.OnlineID,
                     StarRating = 2 + i * 0.1,
                     OverallDifficulty = 3.5f,
                     FailTimes = new APIFailTimes
diff --git a/osu.Game.Tests/Visual/Online/TestSceneDirectPanel.cs b/osu.Game.Tests/Visual/Online/TestSceneDirectPanel.cs
index 01dde97d38..510b9e8483 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneDirectPanel.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneDirectPanel.cs
@@ -94,7 +94,7 @@ namespace osu.Game.Tests.Visual.Online
                 {
                     new APIBeatmap
                     {
-                        RulesetID = Ruleset.Value.ID ?? 0,
+                        RulesetID = Ruleset.Value.OnlineID,
                         DifficultyName = "Test",
                         StarRating = 6.42,
                     }
diff --git a/osu.Game.Tests/Visual/Online/TestSceneNowPlayingCommand.cs b/osu.Game.Tests/Visual/Online/TestSceneNowPlayingCommand.cs
index 7a5ee84eb4..b689b85490 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneNowPlayingCommand.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneNowPlayingCommand.cs
@@ -64,7 +64,7 @@ namespace osu.Game.Tests.Visual.Online
 
             AddStep("Set beatmap", () => Beatmap.Value = new DummyWorkingBeatmap(Audio, null)
             {
-                BeatmapInfo = { OnlineID = hasOnlineId ? 1234 : (int?)null }
+                BeatmapInfo = { OnlineID = hasOnlineId ? 1234 : -1 }
             });
 
             AddStep("Run command", () => Add(new NowPlayingCommand()));
diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapRecommendations.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapRecommendations.cs
index c9ec53cfd5..af3312f50b 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapRecommendations.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapRecommendations.cs
@@ -32,7 +32,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                     switch (req)
                     {
                         case GetUserRequest userRequest:
-                            userRequest.TriggerSuccess(getUser(userRequest.Ruleset.ID));
+                            userRequest.TriggerSuccess(getUser(userRequest.Ruleset.OnlineID));
                             return true;
                     }
 
diff --git a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
index f09dc38378..42ec966b2e 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
@@ -258,7 +258,7 @@ namespace osu.Game.Tests.Visual.SongSelect
             {
                 AddStep("import multi-ruleset map", () =>
                 {
-                    var usableRulesets = rulesets.AvailableRulesets.Where(r => r.ID != 2).ToArray();
+                    var usableRulesets = rulesets.AvailableRulesets.Where(r => r.OnlineID != 2).ToArray();
                     manager.Import(createTestBeatmapSet(usableRulesets)).Wait();
                 });
             }
@@ -354,7 +354,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                 target = manager.GetAllUsableBeatmapSets()
                                 .Last(b => b.Beatmaps.Any(bi => bi.RulesetID == 0)).Beatmaps.Last();
 
-                Ruleset.Value = rulesets.AvailableRulesets.First(r => r.ID == 0);
+                Ruleset.Value = rulesets.AvailableRulesets.First(r => r.OnlineID == 0);
                 Beatmap.Value = manager.GetWorkingBeatmap(target);
             });
 
@@ -385,12 +385,12 @@ namespace osu.Game.Tests.Visual.SongSelect
                                 .Last(b => b.Beatmaps.Any(bi => bi.RulesetID == 0)).Beatmaps.Last();
 
                 Beatmap.Value = manager.GetWorkingBeatmap(target);
-                Ruleset.Value = rulesets.AvailableRulesets.First(r => r.ID == 0);
+                Ruleset.Value = rulesets.AvailableRulesets.First(r => r.OnlineID == 0);
             });
 
             AddUntilStep("has selection", () => songSelect.Carousel.SelectedBeatmapInfo.Equals(target));
 
-            AddUntilStep("has correct ruleset", () => Ruleset.Value.ID == 0);
+            AddUntilStep("has correct ruleset", () => Ruleset.Value.OnlineID == 0);
 
             // this is an important check, to make sure updateComponentFromBeatmap() was actually run
             AddUntilStep("selection shown on wedge", () => songSelect.CurrentBeatmapDetailsBeatmap.BeatmapInfo.MatchesOnlineID(target));
@@ -505,7 +505,7 @@ namespace osu.Game.Tests.Visual.SongSelect
 
                 // special case for converts checked here.
                 return selectedPanel.ChildrenOfType<FilterableDifficultyIcon>().All(i =>
-                    i.IsFiltered || i.Item.BeatmapInfo.Ruleset.ID == targetRuleset || i.Item.BeatmapInfo.Ruleset.ID == 0);
+                    i.IsFiltered || i.Item.BeatmapInfo.Ruleset.OnlineID == targetRuleset || i.Item.BeatmapInfo.Ruleset.OnlineID == 0);
             });
 
             AddUntilStep("carousel has correct", () => songSelect.Carousel.SelectedBeatmapInfo?.MatchesOnlineID(target) == true);
@@ -665,7 +665,7 @@ namespace osu.Game.Tests.Visual.SongSelect
 
             AddStep("import multi-ruleset map", () =>
             {
-                var usableRulesets = rulesets.AvailableRulesets.Where(r => r.ID != 2).ToArray();
+                var usableRulesets = rulesets.AvailableRulesets.Where(r => r.OnlineID != 2).ToArray();
                 manager.Import(createTestBeatmapSet(usableRulesets)).Wait();
             });
 
@@ -676,11 +676,11 @@ namespace osu.Game.Tests.Visual.SongSelect
             AddStep("record set ID", () => previousSetID = ((IBeatmapSetInfo)Beatmap.Value.BeatmapSetInfo).OnlineID);
             AddAssert("selection changed once", () => changeCount == 1);
 
-            AddAssert("Check ruleset is osu!", () => Ruleset.Value.ID == 0);
+            AddAssert("Check ruleset is osu!", () => Ruleset.Value.OnlineID == 0);
 
             changeRuleset(3);
 
-            AddUntilStep("Check ruleset changed to mania", () => Ruleset.Value.ID == 3);
+            AddUntilStep("Check ruleset changed to mania", () => Ruleset.Value.OnlineID == 3);
 
             AddUntilStep("selection changed", () => changeCount > 1);
 
@@ -705,7 +705,7 @@ namespace osu.Game.Tests.Visual.SongSelect
 
             AddStep("import multi-ruleset map", () =>
             {
-                var usableRulesets = rulesets.AvailableRulesets.Where(r => r.ID != 2).ToArray();
+                var usableRulesets = rulesets.AvailableRulesets.Where(r => r.OnlineID != 2).ToArray();
                 manager.Import(createTestBeatmapSet(usableRulesets)).Wait();
             });
 
@@ -720,11 +720,11 @@ namespace osu.Game.Tests.Visual.SongSelect
             AddUntilStep("Find an icon for different ruleset", () =>
             {
                 difficultyIcon = set.ChildrenOfType<FilterableDifficultyIcon>()
-                                    .FirstOrDefault(icon => icon.Item.BeatmapInfo.Ruleset.ID == 3);
+                                    .FirstOrDefault(icon => icon.Item.BeatmapInfo.Ruleset.OnlineID == 3);
                 return difficultyIcon != null;
             });
 
-            AddAssert("Check ruleset is osu!", () => Ruleset.Value.ID == 0);
+            AddAssert("Check ruleset is osu!", () => Ruleset.Value.OnlineID == 0);
 
             int previousSetID = 0;
 
@@ -737,7 +737,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                 InputManager.Click(MouseButton.Left);
             });
 
-            AddUntilStep("Check ruleset changed to mania", () => Ruleset.Value.ID == 3);
+            AddUntilStep("Check ruleset changed to mania", () => Ruleset.Value.OnlineID == 3);
 
             AddAssert("Selected beatmap still same set", () => songSelect.Carousel.SelectedBeatmapInfo.BeatmapSet.OnlineID == previousSetID);
             AddAssert("Selected beatmap is mania", () => Beatmap.Value.BeatmapInfo.Ruleset.OnlineID == 3);
@@ -754,7 +754,7 @@ namespace osu.Game.Tests.Visual.SongSelect
 
             AddStep("import huge difficulty count map", () =>
             {
-                var usableRulesets = rulesets.AvailableRulesets.Where(r => r.ID != 2).ToArray();
+                var usableRulesets = rulesets.AvailableRulesets.Where(r => r.OnlineID != 2).ToArray();
                 imported = manager.Import(createTestBeatmapSet(usableRulesets, 50)).Result.Value;
             });
 
@@ -771,10 +771,10 @@ namespace osu.Game.Tests.Visual.SongSelect
             AddUntilStep("Find group icon for different ruleset", () =>
             {
                 return (groupIcon = set.ChildrenOfType<FilterableGroupedDifficultyIcon>()
-                                       .FirstOrDefault(icon => icon.Items.First().BeatmapInfo.Ruleset.ID == 3)) != null;
+                                       .FirstOrDefault(icon => icon.Items.First().BeatmapInfo.Ruleset.OnlineID == 3)) != null;
             });
 
-            AddAssert("Check ruleset is osu!", () => Ruleset.Value.ID == 0);
+            AddAssert("Check ruleset is osu!", () => Ruleset.Value.OnlineID == 0);
 
             AddStep("Click on group", () =>
             {
@@ -783,7 +783,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                 InputManager.Click(MouseButton.Left);
             });
 
-            AddUntilStep("Check ruleset changed to mania", () => Ruleset.Value.ID == 3);
+            AddUntilStep("Check ruleset changed to mania", () => Ruleset.Value.OnlineID == 3);
 
             AddAssert("Check first item in group selected", () => Beatmap.Value.BeatmapInfo.MatchesOnlineID(groupIcon.Items.First().BeatmapInfo));
         }
@@ -817,7 +817,7 @@ namespace osu.Game.Tests.Visual.SongSelect
             AddUntilStep("wait for results screen presented", () => !songSelect.IsCurrentScreen());
 
             AddAssert("check beatmap is correct for score", () => Beatmap.Value.BeatmapInfo.MatchesOnlineID(getPresentBeatmap()));
-            AddAssert("check ruleset is correct for score", () => Ruleset.Value.ID == 0);
+            AddAssert("check ruleset is correct for score", () => Ruleset.Value.OnlineID == 0);
         }
 
         [Test]
@@ -849,7 +849,7 @@ namespace osu.Game.Tests.Visual.SongSelect
             AddUntilStep("wait for results screen presented", () => !songSelect.IsCurrentScreen());
 
             AddAssert("check beatmap is correct for score", () => Beatmap.Value.BeatmapInfo.MatchesOnlineID(getPresentBeatmap()));
-            AddAssert("check ruleset is correct for score", () => Ruleset.Value.ID == 0);
+            AddAssert("check ruleset is correct for score", () => Ruleset.Value.OnlineID == 0);
         }
 
         private void waitForInitialSelection()
@@ -869,7 +869,7 @@ namespace osu.Game.Tests.Visual.SongSelect
 
         private void addRulesetImportStep(int id) => AddStep($"import test map for ruleset {id}", () => importForRuleset(id));
 
-        private void importForRuleset(int id) => manager.Import(createTestBeatmapSet(rulesets.AvailableRulesets.Where(r => r.ID == id).ToArray())).Wait();
+        private void importForRuleset(int id) => manager.Import(createTestBeatmapSet(rulesets.AvailableRulesets.Where(r => r.OnlineID == id).ToArray())).Wait();
 
         private static int importId;
 
@@ -880,7 +880,7 @@ namespace osu.Game.Tests.Visual.SongSelect
 
         private void changeMods(params Mod[] mods) => AddStep($"change mods to {string.Join(", ", mods.Select(m => m.Acronym))}", () => SelectedMods.Value = mods);
 
-        private void changeRuleset(int id) => AddStep($"change ruleset to {id}", () => Ruleset.Value = rulesets.AvailableRulesets.First(r => r.ID == id));
+        private void changeRuleset(int id) => AddStep($"change ruleset to {id}", () => Ruleset.Value = rulesets.AvailableRulesets.First(r => r.OnlineID == id));
 
         private void createSongSelect()
         {
@@ -893,7 +893,7 @@ namespace osu.Game.Tests.Visual.SongSelect
         {
             AddStep("import test maps", () =>
             {
-                var usableRulesets = rulesets.AvailableRulesets.Where(r => r.ID != 2).ToArray();
+                var usableRulesets = rulesets.AvailableRulesets.Where(r => r.OnlineID != 2).ToArray();
 
                 for (int i = 0; i < 100; i += 10)
                     manager.Import(createTestBeatmapSet(usableRulesets)).Wait();
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectOverlay.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectOverlay.cs
index 4f7aec3b67..f196bbd76e 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectOverlay.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectOverlay.cs
@@ -378,9 +378,9 @@ namespace osu.Game.Tests.Visual.UserInterface
             });
         }
 
-        private void changeRuleset(int? id)
+        private void changeRuleset(int? onlineId)
         {
-            AddStep($"change ruleset to {(id?.ToString() ?? "none")}", () => { Ruleset.Value = rulesets.AvailableRulesets.FirstOrDefault(r => r.ID == id); });
+            AddStep($"change ruleset to {(onlineId?.ToString() ?? "none")}", () => { Ruleset.Value = rulesets.AvailableRulesets.FirstOrDefault(r => r.OnlineID == onlineId); });
             waitForLoad();
         }
 
diff --git a/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs b/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs
index 3fb9335629..243c39ab53 100644
--- a/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs
@@ -98,7 +98,7 @@ namespace osu.Game.Online.API.Requests.Responses
 
         public string MD5Hash => Checksum;
 
-        public IRulesetInfo Ruleset => new RulesetInfo { ID = RulesetID };
+        public IRulesetInfo Ruleset => new RulesetInfo { OnlineID = RulesetID };
 
         [JsonIgnore]
         public string Hash => throw new NotImplementedException();
diff --git a/osu.Game/Online/API/Requests/Responses/APIScoreInfo.cs b/osu.Game/Online/API/Requests/Responses/APIScoreInfo.cs
index d0677eacab..0a2d6ca7b0 100644
--- a/osu.Game/Online/API/Requests/Responses/APIScoreInfo.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIScoreInfo.cs
@@ -146,7 +146,7 @@ namespace osu.Game.Online.API.Requests.Responses
             return scoreInfo;
         }
 
-        public IRulesetInfo Ruleset => new RulesetInfo { ID = RulesetID };
+        public IRulesetInfo Ruleset => new RulesetInfo { OnlineID = RulesetID };
 
         IBeatmapInfo IScoreInfo.Beatmap => Beatmap;
     }
diff --git a/osu.Game/Rulesets/Ruleset.cs b/osu.Game/Rulesets/Ruleset.cs
index 31ebcfd600..d279f6d6ee 100644
--- a/osu.Game/Rulesets/Ruleset.cs
+++ b/osu.Game/Rulesets/Ruleset.cs
@@ -183,7 +183,7 @@ namespace osu.Game.Rulesets
             {
                 Name = Description,
                 ShortName = ShortName,
-                ID = (this as ILegacyRuleset)?.LegacyID,
+                OnlineID = (this as ILegacyRuleset)?.LegacyID ?? -1,
                 InstantiationInfo = GetType().GetInvariantInstantiationInfo(),
                 Available = true,
             };

From bbd3ea5b7756b8ad2c40a13b1bd276e4e98ba8c0 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 24 Nov 2021 15:25:49 +0900
Subject: [PATCH 1238/5547] Update all actual usages of `RulesetInfo.ID` to use
 `OnlineID` instead

---
 osu.Desktop/DiscordRichPresence.cs               |  5 ++++-
 .../Beatmaps/Formats/LegacyScoreDecoderTest.cs   |  2 +-
 osu.Game.Tournament/Components/SongBar.cs        |  2 +-
 osu.Game/Beatmaps/BeatmapDifficultyCache.cs      |  2 +-
 osu.Game/Beatmaps/DifficultyRecommender.cs       |  2 +-
 osu.Game/Models/RealmRuleset.cs                  |  4 ++--
 .../API/Requests/SearchBeatmapSetsRequest.cs     |  4 ++--
 osu.Game/Scoring/Legacy/LegacyScoreDecoder.cs    |  2 +-
 osu.Game/Scoring/Legacy/LegacyScoreEncoder.cs    |  2 +-
 osu.Game/Screens/Play/SoloPlayer.cs              | 16 +++++++++-------
 osu.Game/Screens/Spectate/SpectatorScreen.cs     |  2 +-
 osu.Game/Stores/RealmRulesetStore.cs             |  6 +++---
 12 files changed, 27 insertions(+), 22 deletions(-)

diff --git a/osu.Desktop/DiscordRichPresence.cs b/osu.Desktop/DiscordRichPresence.cs
index e1e7e6ad18..3642f70a56 100644
--- a/osu.Desktop/DiscordRichPresence.cs
+++ b/osu.Desktop/DiscordRichPresence.cs
@@ -108,7 +108,10 @@ namespace osu.Desktop
                 presence.Assets.LargeImageText = $"{user.Value.Username}" + (user.Value.Statistics?.GlobalRank > 0 ? $" (rank #{user.Value.Statistics.GlobalRank:N0})" : string.Empty);
 
             // update ruleset
-            presence.Assets.SmallImageKey = ruleset.Value.ID <= 3 ? $"mode_{ruleset.Value.ID}" : "mode_custom";
+            int onlineID = ruleset.Value.OnlineID;
+            bool isLegacyRuleset = onlineID >= 0 && onlineID <= ILegacyRuleset.MAX_LEGACY_RULESET_ID;
+
+            presence.Assets.SmallImageKey = isLegacyRuleset ? $"mode_{onlineID}" : "mode_custom";
             presence.Assets.SmallImageText = ruleset.Value.Name;
 
             client.SetPresence(presence);
diff --git a/osu.Game.Tests/Beatmaps/Formats/LegacyScoreDecoderTest.cs b/osu.Game.Tests/Beatmaps/Formats/LegacyScoreDecoderTest.cs
index 9c71466489..6e5a546e87 100644
--- a/osu.Game.Tests/Beatmaps/Formats/LegacyScoreDecoderTest.cs
+++ b/osu.Game.Tests/Beatmaps/Formats/LegacyScoreDecoderTest.cs
@@ -30,7 +30,7 @@ namespace osu.Game.Tests.Beatmaps.Formats
             {
                 var score = decoder.Parse(resourceStream);
 
-                Assert.AreEqual(3, score.ScoreInfo.Ruleset.ID);
+                Assert.AreEqual(3, score.ScoreInfo.Ruleset.OnlineID);
 
                 Assert.AreEqual(2, score.ScoreInfo.Statistics[HitResult.Great]);
                 Assert.AreEqual(1, score.ScoreInfo.Statistics[HitResult.Good]);
diff --git a/osu.Game.Tournament/Components/SongBar.cs b/osu.Game.Tournament/Components/SongBar.cs
index a74b88c592..a7f0d58145 100644
--- a/osu.Game.Tournament/Components/SongBar.cs
+++ b/osu.Game.Tournament/Components/SongBar.cs
@@ -127,7 +127,7 @@ namespace osu.Game.Tournament.Components
 
             (string heading, string content)[] stats;
 
-            switch (ruleset.Value.ID)
+            switch (ruleset.Value.OnlineID)
             {
                 default:
                     stats = new (string heading, string content)[]
diff --git a/osu.Game/Beatmaps/BeatmapDifficultyCache.cs b/osu.Game/Beatmaps/BeatmapDifficultyCache.cs
index 4d44b49218..61717c18d5 100644
--- a/osu.Game/Beatmaps/BeatmapDifficultyCache.cs
+++ b/osu.Game/Beatmaps/BeatmapDifficultyCache.cs
@@ -349,7 +349,7 @@ namespace osu.Game.Beatmaps
                 var hashCode = new HashCode();
 
                 hashCode.Add(BeatmapInfo.ID);
-                hashCode.Add(Ruleset.ID);
+                hashCode.Add(Ruleset.ShortName);
 
                 foreach (var mod in OrderedMods)
                     hashCode.Add(mod);
diff --git a/osu.Game/Beatmaps/DifficultyRecommender.cs b/osu.Game/Beatmaps/DifficultyRecommender.cs
index a2bd7c6ce9..8b00d0f7f2 100644
--- a/osu.Game/Beatmaps/DifficultyRecommender.cs
+++ b/osu.Game/Beatmaps/DifficultyRecommender.cs
@@ -83,7 +83,7 @@ namespace osu.Game.Beatmaps
             requestedUserId = api.LocalUser.Value.Id;
 
             // only query API for built-in rulesets
-            rulesets.AvailableRulesets.Where(ruleset => ruleset.ID <= ILegacyRuleset.MAX_LEGACY_RULESET_ID).ForEach(rulesetInfo =>
+            rulesets.AvailableRulesets.Where(ruleset => ruleset.OnlineID >= 0 && ruleset.OnlineID <= ILegacyRuleset.MAX_LEGACY_RULESET_ID).ForEach(rulesetInfo =>
             {
                 var req = new GetUserRequest(api.LocalUser.Value.Id, rulesetInfo);
 
diff --git a/osu.Game/Models/RealmRuleset.cs b/osu.Game/Models/RealmRuleset.cs
index 5c18a10527..9a7488fda2 100644
--- a/osu.Game/Models/RealmRuleset.cs
+++ b/osu.Game/Models/RealmRuleset.cs
@@ -25,12 +25,12 @@ namespace osu.Game.Models
 
         public string InstantiationInfo { get; set; } = string.Empty;
 
-        public RealmRuleset(string shortName, string name, string instantiationInfo, int? onlineID = null)
+        public RealmRuleset(string shortName, string name, string instantiationInfo, int onlineID)
         {
             ShortName = shortName;
             Name = name;
             InstantiationInfo = instantiationInfo;
-            OnlineID = onlineID ?? -1;
+            OnlineID = onlineID;
         }
 
         [UsedImplicitly]
diff --git a/osu.Game/Online/API/Requests/SearchBeatmapSetsRequest.cs b/osu.Game/Online/API/Requests/SearchBeatmapSetsRequest.cs
index ae082ca82e..736024b08b 100644
--- a/osu.Game/Online/API/Requests/SearchBeatmapSetsRequest.cs
+++ b/osu.Game/Online/API/Requests/SearchBeatmapSetsRequest.cs
@@ -86,8 +86,8 @@ namespace osu.Game.Online.API.Requests
             if (General != null && General.Any())
                 req.AddParameter("c", string.Join('.', General.Select(e => e.ToString().Underscore())));
 
-            if (ruleset.ID.HasValue)
-                req.AddParameter("m", ruleset.ID.Value.ToString());
+            if (ruleset.OnlineID >= 0)
+                req.AddParameter("m", ruleset.OnlineID.ToString());
 
             req.AddParameter("s", SearchCategory.ToString().ToLowerInvariant());
 
diff --git a/osu.Game/Scoring/Legacy/LegacyScoreDecoder.cs b/osu.Game/Scoring/Legacy/LegacyScoreDecoder.cs
index 7ac4f90c07..f943422389 100644
--- a/osu.Game/Scoring/Legacy/LegacyScoreDecoder.cs
+++ b/osu.Game/Scoring/Legacy/LegacyScoreDecoder.cs
@@ -140,7 +140,7 @@ namespace osu.Game.Scoring.Legacy
             int countGeki = score.GetCountGeki() ?? 0;
             int countKatu = score.GetCountKatu() ?? 0;
 
-            switch (score.Ruleset.ID)
+            switch (score.Ruleset.OnlineID)
             {
                 case 0:
                 {
diff --git a/osu.Game/Scoring/Legacy/LegacyScoreEncoder.cs b/osu.Game/Scoring/Legacy/LegacyScoreEncoder.cs
index 5769406948..7b8cacb35b 100644
--- a/osu.Game/Scoring/Legacy/LegacyScoreEncoder.cs
+++ b/osu.Game/Scoring/Legacy/LegacyScoreEncoder.cs
@@ -42,7 +42,7 @@ namespace osu.Game.Scoring.Legacy
         {
             using (SerializationWriter sw = new SerializationWriter(stream))
             {
-                sw.Write((byte)(score.ScoreInfo.Ruleset.ID ?? 0));
+                sw.Write((byte)(score.ScoreInfo.Ruleset.OnlineID));
                 sw.Write(LATEST_VERSION);
                 sw.Write(score.ScoreInfo.BeatmapInfo.MD5Hash);
                 sw.Write(score.ScoreInfo.UserString);
diff --git a/osu.Game/Screens/Play/SoloPlayer.cs b/osu.Game/Screens/Play/SoloPlayer.cs
index 6cea75af0a..c8d831ebe6 100644
--- a/osu.Game/Screens/Play/SoloPlayer.cs
+++ b/osu.Game/Screens/Play/SoloPlayer.cs
@@ -3,6 +3,7 @@
 
 using System;
 using System.Diagnostics;
+using osu.Game.Beatmaps;
 using osu.Game.Online.API;
 using osu.Game.Online.Rooms;
 using osu.Game.Online.Solo;
@@ -25,10 +26,13 @@ namespace osu.Game.Screens.Play
 
         protected override APIRequest<APIScoreToken> CreateTokenRequest()
         {
-            if (!(Beatmap.Value.BeatmapInfo.OnlineID is int beatmapId))
+            int beatmapId = Beatmap.Value.BeatmapInfo.OnlineID ?? -1;
+            int rulesetId = Ruleset.Value.OnlineID;
+
+            if (beatmapId <= 0)
                 return null;
 
-            if (!(Ruleset.Value.ID is int rulesetId) || Ruleset.Value.ID > ILegacyRuleset.MAX_LEGACY_RULESET_ID)
+            if (rulesetId < 0 || rulesetId > ILegacyRuleset.MAX_LEGACY_RULESET_ID)
                 return null;
 
             return new CreateSoloScoreRequest(beatmapId, rulesetId, Game.VersionHash);
@@ -38,13 +42,11 @@ namespace osu.Game.Screens.Play
 
         protected override APIRequest<MultiplayerScore> CreateSubmissionRequest(Score score, long token)
         {
-            var beatmap = score.ScoreInfo.BeatmapInfo;
+            IBeatmapInfo beatmap = score.ScoreInfo.BeatmapInfo;
 
-            Debug.Assert(beatmap.OnlineID != null);
+            Debug.Assert(beatmap.OnlineID > 0);
 
-            int beatmapId = beatmap.OnlineID.Value;
-
-            return new SubmitSoloScoreRequest(beatmapId, token, score.ScoreInfo);
+            return new SubmitSoloScoreRequest(beatmap.OnlineID, token, score.ScoreInfo);
         }
     }
 }
diff --git a/osu.Game/Screens/Spectate/SpectatorScreen.cs b/osu.Game/Screens/Spectate/SpectatorScreen.cs
index 1f07042ede..ca56366927 100644
--- a/osu.Game/Screens/Spectate/SpectatorScreen.cs
+++ b/osu.Game/Screens/Spectate/SpectatorScreen.cs
@@ -146,7 +146,7 @@ namespace osu.Game.Screens.Spectate
             var user = userMap[userId];
             var spectatorState = playingUserStates[userId];
 
-            var resolvedRuleset = rulesets.AvailableRulesets.FirstOrDefault(r => r.ID == spectatorState.RulesetID)?.CreateInstance();
+            var resolvedRuleset = rulesets.AvailableRulesets.FirstOrDefault(r => r.OnlineID == spectatorState.RulesetID)?.CreateInstance();
             if (resolvedRuleset == null)
                 return;
 
diff --git a/osu.Game/Stores/RealmRulesetStore.cs b/osu.Game/Stores/RealmRulesetStore.cs
index cf9ffd112c..0119aec9a4 100644
--- a/osu.Game/Stores/RealmRulesetStore.cs
+++ b/osu.Game/Stores/RealmRulesetStore.cs
@@ -117,8 +117,8 @@ namespace osu.Game.Stores
                     // add all legacy rulesets first to ensure they have exclusive choice of primary key.
                     foreach (var r in instances.Where(r => r is ILegacyRuleset))
                     {
-                        if (realm.All<RealmRuleset>().FirstOrDefault(rr => rr.OnlineID == r.RulesetInfo.ID) == null)
-                            realm.Add(new RealmRuleset(r.RulesetInfo.ShortName, r.RulesetInfo.Name, r.RulesetInfo.InstantiationInfo, r.RulesetInfo.ID));
+                        if (realm.All<RealmRuleset>().FirstOrDefault(rr => rr.OnlineID == r.RulesetInfo.OnlineID) == null)
+                            realm.Add(new RealmRuleset(r.RulesetInfo.ShortName, r.RulesetInfo.Name, r.RulesetInfo.InstantiationInfo, r.RulesetInfo.OnlineID));
                     }
 
                     // add any other rulesets which have assemblies present but are not yet in the database.
@@ -136,7 +136,7 @@ namespace osu.Game.Stores
                                 existingSameShortName.InstantiationInfo = r.RulesetInfo.InstantiationInfo;
                             }
                             else
-                                realm.Add(new RealmRuleset(r.RulesetInfo.ShortName, r.RulesetInfo.Name, r.RulesetInfo.InstantiationInfo, r.RulesetInfo.ID));
+                                realm.Add(new RealmRuleset(r.RulesetInfo.ShortName, r.RulesetInfo.Name, r.RulesetInfo.InstantiationInfo, r.RulesetInfo.OnlineID));
                         }
                     }
 

From 9c61ec217b8a644100419203c9e94b2653f3b784 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 19 Nov 2021 18:47:07 +0900
Subject: [PATCH 1239/5547] Remove unnecessary `mainTrackMixer` parameter from
 `BeatmapManager`

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

diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index c2a2e93caf..8acdc96ac0 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -10,7 +10,6 @@ using System.Threading;
 using System.Threading.Tasks;
 using JetBrains.Annotations;
 using osu.Framework.Audio;
-using osu.Framework.Audio.Mixing;
 using osu.Framework.Audio.Track;
 using osu.Framework.IO.Stores;
 using osu.Framework.Platform;
@@ -40,7 +39,7 @@ namespace osu.Game.Beatmaps
         private readonly WorkingBeatmapCache workingBeatmapCache;
         private readonly BeatmapOnlineLookupQueue onlineBeatmapLookupQueue;
 
-        public BeatmapManager(Storage storage, IDatabaseContextFactory contextFactory, RulesetStore rulesets, IAPIProvider api, [NotNull] AudioManager audioManager, IResourceStore<byte[]> gameResources, GameHost host = null, WorkingBeatmap defaultBeatmap = null, bool performOnlineLookups = false, AudioMixer mainTrackMixer = null)
+        public BeatmapManager(Storage storage, IDatabaseContextFactory contextFactory, RulesetStore rulesets, IAPIProvider api, [NotNull] AudioManager audioManager, IResourceStore<byte[]> gameResources, GameHost host = null, WorkingBeatmap defaultBeatmap = null, bool performOnlineLookups = false)
         {
             var userResources = new FileStore(contextFactory, storage).Store;
 

From 3e0e01abdb6f75ba2d05c0dc9c712160e426d11f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 23 Nov 2021 01:02:22 +0900
Subject: [PATCH 1240/5547] Move bookmark parsing logic into
 `LegacyBeatmapDecoder`

---
 osu.Game/Beatmaps/BeatmapInfo.cs              | 23 -------------------
 .../Beatmaps/Formats/LegacyBeatmapDecoder.cs  |  6 ++++-
 2 files changed, 5 insertions(+), 24 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapInfo.cs b/osu.Game/Beatmaps/BeatmapInfo.cs
index d2b322a843..782944c28e 100644
--- a/osu.Game/Beatmaps/BeatmapInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapInfo.cs
@@ -5,7 +5,6 @@ using System;
 using System.Collections.Generic;
 using System.ComponentModel.DataAnnotations;
 using System.ComponentModel.DataAnnotations.Schema;
-using System.Linq;
 using Newtonsoft.Json;
 using osu.Framework.Testing;
 using osu.Game.Database;
@@ -104,28 +103,6 @@ namespace osu.Game.Beatmaps
         /// </summary>
         public int CountdownOffset { get; set; }
 
-        // Editor
-        // This bookmarks stuff is necessary because DB doesn't know how to store int[]
-        [JsonIgnore]
-        public string StoredBookmarks
-        {
-            get => string.Join(',', Bookmarks);
-            set
-            {
-                if (string.IsNullOrEmpty(value))
-                {
-                    Bookmarks = Array.Empty<int>();
-                    return;
-                }
-
-                Bookmarks = value.Split(',').Select(v =>
-                {
-                    bool result = int.TryParse(v, out int val);
-                    return new { result, val };
-                }).Where(p => p.result).Select(p => p.val).ToArray();
-            }
-        }
-
         [NotMapped]
         public int[] Bookmarks { get; set; } = Array.Empty<int>();
 
diff --git a/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs b/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
index 65d050e608..e5db9d045a 100644
--- a/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
+++ b/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
@@ -201,7 +201,11 @@ namespace osu.Game.Beatmaps.Formats
             switch (pair.Key)
             {
                 case @"Bookmarks":
-                    beatmap.BeatmapInfo.StoredBookmarks = pair.Value;
+                    beatmap.BeatmapInfo.Bookmarks = pair.Value.Split(',').Select(v =>
+                    {
+                        bool result = int.TryParse(v, out int val);
+                        return new { result, val };
+                    }).Where(p => p.result).Select(p => p.val).ToArray();
                     break;
 
                 case @"DistanceSpacing":

From 2dabedebffaa87919d1a6593de963a72bdd8e54a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 23 Nov 2021 01:22:19 +0900
Subject: [PATCH 1241/5547] Remove unnecessary user assign in
 `HitObjectSampleTest`

---
 osu.Game/Tests/Beatmaps/HitObjectSampleTest.cs | 6 +-----
 1 file changed, 1 insertion(+), 5 deletions(-)

diff --git a/osu.Game/Tests/Beatmaps/HitObjectSampleTest.cs b/osu.Game/Tests/Beatmaps/HitObjectSampleTest.cs
index b87c3d57c2..adb447c927 100644
--- a/osu.Game/Tests/Beatmaps/HitObjectSampleTest.cs
+++ b/osu.Game/Tests/Beatmaps/HitObjectSampleTest.cs
@@ -15,7 +15,6 @@ using osu.Framework.Timing;
 using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.Formats;
 using osu.Game.IO;
-using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Objects;
 using osu.Game.Screens.Ranking;
@@ -39,10 +38,7 @@ namespace osu.Game.Tests.Beatmaps
         private readonly BeatmapInfo beatmapInfo = new BeatmapInfo
         {
             BeatmapSet = new BeatmapSetInfo(),
-            Metadata = new BeatmapMetadata
-            {
-                Author = APIUser.SYSTEM_USER
-            }
+            Metadata = new BeatmapMetadata(),
         };
 
         private readonly TestResourceStore userSkinResourceStore = new TestResourceStore();

From b20ff22af0c41294dfffedb6717e6fc78c43ec3b Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 24 Nov 2021 16:50:33 +0900
Subject: [PATCH 1242/5547] Ensure travel distance is calculated for all
 sliders

---
 .../Preprocessing/OsuDifficultyHitObject.cs        | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
index 36a1053317..f1f246359a 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
@@ -74,6 +74,13 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
 
         private void setDistances(double clockRate)
         {
+            if (BaseObject is Slider currentSlider)
+            {
+                computeSliderCursorPosition(currentSlider);
+                TravelDistance = currentSlider.LazyTravelDistance;
+                TravelTime = Math.Max(currentSlider.LazyTravelTime / clockRate, min_delta_time);
+            }
+
             // We don't need to calculate either angle or distance when one of the last->curr objects is a spinner
             if (BaseObject is Spinner || lastObject is Spinner)
                 return;
@@ -87,13 +94,6 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
                 scalingFactor *= 1 + smallCircleBonus;
             }
 
-            if (BaseObject is Slider currentSlider)
-            {
-                computeSliderCursorPosition(currentSlider);
-                TravelDistance = currentSlider.LazyTravelDistance;
-                TravelTime = Math.Max(currentSlider.LazyTravelTime / clockRate, min_delta_time);
-            }
-
             Vector2 lastCursorPosition = getEndCursorPosition(lastObject);
 
             JumpDistance = (BaseObject.StackedPosition * scalingFactor - lastCursorPosition * scalingFactor).Length;

From 0c819b9cfbf39f338e2c604aeea5998de38c67f3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 24 Nov 2021 17:59:23 +0900
Subject: [PATCH 1243/5547] Combine all test data `BeatmapSetInfo` creation
 into a single method

---
 osu.Game.Tests/Resources/TestResources.cs     |  81 ++++++++
 .../Menus/TestSceneMusicActionHandling.cs     |  17 +-
 .../TestScenePlaylistsSongSelect.cs           |  42 +---
 .../SongSelect/TestSceneBeatmapCarousel.cs    | 189 ++++++------------
 .../SongSelect/TestScenePlaySongSelect.cs     |  69 +------
 .../UserInterface/TestScenePlaylistOverlay.cs |  24 +--
 6 files changed, 160 insertions(+), 262 deletions(-)

diff --git a/osu.Game.Tests/Resources/TestResources.cs b/osu.Game.Tests/Resources/TestResources.cs
index dff9478852..440d5e701f 100644
--- a/osu.Game.Tests/Resources/TestResources.cs
+++ b/osu.Game.Tests/Resources/TestResources.cs
@@ -2,10 +2,18 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
+using System.Collections.Generic;
 using System.IO;
+using System.Text;
+using System.Threading;
 using NUnit.Framework;
+using osu.Framework.Extensions;
 using osu.Framework.IO.Stores;
 using osu.Framework.Testing;
+using osu.Framework.Utils;
+using osu.Game.Beatmaps;
+using osu.Game.Rulesets;
+using osu.Game.Rulesets.Osu;
 
 namespace osu.Game.Tests.Resources
 {
@@ -56,5 +64,78 @@ namespace osu.Game.Tests.Resources
         }
 
         private static string getTempFilename() => temp_storage.GetFullPath(Guid.NewGuid() + ".osz");
+
+        private static int importId;
+
+        /// <summary>
+        /// Create a test beatmap set model.
+        /// </summary>
+        /// <param name="difficultyCount">Number of difficulties. If null, a random number between 1 and 20 will be used.</param>
+        /// <param name="rulesets">Rulesets to cycle through when creating difficulties. If <c>null</c>, osu! ruleset will be used.</param>
+        public static BeatmapSetInfo CreateTestBeatmapSetInfo(int? difficultyCount = null, RulesetInfo[] rulesets = null)
+        {
+            int j = 0;
+            RulesetInfo getRuleset() => rulesets?[j++ % rulesets.Length] ?? new OsuRuleset().RulesetInfo;
+
+            int setId = Interlocked.Increment(ref importId);
+
+            var metadata = new BeatmapMetadata
+            {
+                // Create random metadata, then we can check if sorting works based on these
+                Artist = "Some Artist " + RNG.Next(0, 9),
+                Title = $"Some Song (set id {setId}) {Guid.NewGuid()}",
+                AuthorString = "Some Guy " + RNG.Next(0, 9),
+            };
+
+            var beatmapSet = new BeatmapSetInfo
+            {
+                OnlineID = setId,
+                Hash = new MemoryStream(Encoding.UTF8.GetBytes(Guid.NewGuid().ToString())).ComputeMD5Hash(),
+                DateAdded = DateTimeOffset.UtcNow,
+                Metadata = metadata
+            };
+
+            foreach (var b in getBeatmaps(difficultyCount ?? RNG.Next(1, 20)))
+                beatmapSet.Beatmaps.Add(b);
+
+            return beatmapSet;
+
+            IEnumerable<BeatmapInfo> getBeatmaps(int count)
+            {
+                for (int i = 0; i < count; i++)
+                {
+                    int beatmapId = setId * 1000 + i;
+
+                    int length = RNG.Next(30000, 200000);
+                    double bpm = RNG.NextSingle(80, 200);
+
+                    float diff = (float)i / count * 10;
+
+                    string version = "Normal";
+                    if (diff > 6.6)
+                        version = "Insane";
+                    else if (diff > 3.3)
+                        version = "Hard";
+
+                    var rulesetInfo = getRuleset();
+
+                    yield return new BeatmapInfo
+                    {
+                        OnlineID = beatmapId,
+                        DifficultyName = $"{version} {beatmapId} (length {TimeSpan.FromMilliseconds(length):m\\:ss}, bpm {bpm:0.#})",
+                        StarRating = diff,
+                        Length = length,
+                        BPM = bpm,
+                        Ruleset = rulesetInfo,
+                        RulesetID = rulesetInfo.ID ?? -1,
+                        Metadata = metadata,
+                        BaseDifficulty = new BeatmapDifficulty
+                        {
+                            OverallDifficulty = diff,
+                        }
+                    };
+                }
+            }
+        }
     }
 }
diff --git a/osu.Game.Tests/Visual/Menus/TestSceneMusicActionHandling.cs b/osu.Game.Tests/Visual/Menus/TestSceneMusicActionHandling.cs
index f429b5b2a8..55e453c3d3 100644
--- a/osu.Game.Tests/Visual/Menus/TestSceneMusicActionHandling.cs
+++ b/osu.Game.Tests/Visual/Menus/TestSceneMusicActionHandling.cs
@@ -30,25 +30,10 @@ namespace osu.Game.Tests.Visual.Menus
         [Test]
         public void TestMusicNavigationActions()
         {
-            int importId = 0;
             Queue<(IWorkingBeatmap working, TrackChangeDirection changeDirection)> trackChangeQueue = null;
 
             // ensure we have at least two beatmaps available to identify the direction the music controller navigated to.
-            AddRepeatStep("import beatmap", () => Game.BeatmapManager.Import(new BeatmapSetInfo
-            {
-                Beatmaps =
-                {
-                    new BeatmapInfo
-                    {
-                        BaseDifficulty = new BeatmapDifficulty(),
-                    }
-                },
-                Metadata = new BeatmapMetadata
-                {
-                    Artist = $"a test map {importId++}",
-                    Title = "title",
-                }
-            }).Wait(), 5);
+            AddRepeatStep("import beatmap", () => Game.BeatmapManager.Import(TestResources.CreateTestBeatmapSetInfo()).Wait(), 5);
 
             AddStep("import beatmap with track", () =>
             {
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsSongSelect.cs b/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsSongSelect.cs
index 3e24b7a1d0..6d761105c1 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsSongSelect.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsSongSelect.cs
@@ -2,13 +2,10 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
-using System.IO;
 using System.Linq;
-using System.Text;
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
-using osu.Framework.Extensions;
 using osu.Framework.Platform;
 using osu.Framework.Screens;
 using osu.Framework.Utils;
@@ -20,6 +17,7 @@ using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Osu.Mods;
 using osu.Game.Screens.OnlinePlay.Components;
 using osu.Game.Screens.OnlinePlay.Playlists;
+using osu.Game.Tests.Resources;
 using osu.Game.Tests.Visual.OnlinePlay;
 
 namespace osu.Game.Tests.Visual.Multiplayer
@@ -41,43 +39,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             Dependencies.Cache(rulesets = new RulesetStore(ContextFactory));
             Dependencies.Cache(manager = new BeatmapManager(LocalStorage, ContextFactory, rulesets, null, audio, Resources, host, Beatmap.Default));
 
-            var metadata = new BeatmapMetadata
-            {
-                // Create random metadata, then we can check if sorting works based on these
-                Artist = "Some Artist " + RNG.Next(0, 9),
-                Title = "Some Song (set id 10)",
-                AuthorString = "Some Guy " + RNG.Next(0, 9),
-            };
-
-            var beatmapSet = new BeatmapSetInfo
-            {
-                OnlineID = 10,
-                Hash = new MemoryStream(Encoding.UTF8.GetBytes(Guid.NewGuid().ToString())).ComputeMD5Hash(),
-                Metadata = metadata,
-                DateAdded = DateTimeOffset.UtcNow,
-            };
-
-            for (int i = 0; i < 6; i++)
-            {
-                int beatmapId = 10 * 10 + i;
-
-                int length = RNG.Next(30000, 200000);
-                double bpm = RNG.NextSingle(80, 200);
-
-                beatmapSet.Beatmaps.Add(new BeatmapInfo
-                {
-                    Ruleset = new OsuRuleset().RulesetInfo,
-                    OnlineID = beatmapId,
-                    DifficultyName = $"{beatmapId} (length {TimeSpan.FromMilliseconds(length):m\\:ss}, bpm {bpm:0.#})",
-                    Length = length,
-                    Metadata = metadata,
-                    BPM = bpm,
-                    BaseDifficulty = new BeatmapDifficulty
-                    {
-                        OverallDifficulty = 3.5f,
-                    },
-                });
-            }
+            var beatmapSet = TestResources.CreateTestBeatmapSetInfo();
 
             manager.Import(beatmapSet).Wait();
         }
diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs
index 1808f98c23..b979457c75 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs
@@ -3,15 +3,11 @@
 
 using System;
 using System.Collections.Generic;
-using System.IO;
 using System.Linq;
-using System.Text;
 using NUnit.Framework;
 using osu.Framework.Allocation;
-using osu.Framework.Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
-using osu.Framework.Utils;
 using osu.Game.Beatmaps;
 using osu.Game.Configuration;
 using osu.Game.Rulesets;
@@ -19,6 +15,7 @@ using osu.Game.Rulesets.Osu;
 using osu.Game.Screens.Select;
 using osu.Game.Screens.Select.Carousel;
 using osu.Game.Screens.Select.Filter;
+using osu.Game.Tests.Resources;
 using osuTK.Input;
 
 namespace osu.Game.Tests.Visual.SongSelect
@@ -152,7 +149,7 @@ namespace osu.Game.Tests.Visual.SongSelect
             const int total_set_count = 200;
 
             for (int i = 0; i < total_set_count; i++)
-                sets.Add(createTestBeatmapSet(i + 1));
+                sets.Add(TestResources.CreateTestBeatmapSetInfo(i + 1));
 
             loadBeatmaps(sets);
 
@@ -183,7 +180,7 @@ namespace osu.Game.Tests.Visual.SongSelect
             const int total_set_count = 20;
 
             for (int i = 0; i < total_set_count; i++)
-                sets.Add(createTestBeatmapSet(i + 1));
+                sets.Add(TestResources.CreateTestBeatmapSetInfo(3));
 
             loadBeatmaps(sets);
 
@@ -228,10 +225,9 @@ namespace osu.Game.Tests.Visual.SongSelect
             loadBeatmaps();
 
             // basic filtering
-
             setSelected(1, 1);
 
-            AddStep("Filter", () => carousel.Filter(new FilterCriteria { SearchText = "set #3!" }, false));
+            AddStep("Filter", () => carousel.Filter(new FilterCriteria { SearchText = carousel.BeatmapSets.ElementAt(2).Metadata.Title }, false));
             checkVisibleItemCount(diff: false, count: 1);
             checkVisibleItemCount(diff: true, count: 3);
             waitForSelection(3, 1);
@@ -275,16 +271,20 @@ namespace osu.Game.Tests.Visual.SongSelect
         [Test]
         public void TestFilterRange()
         {
+            string searchText = null;
+
             loadBeatmaps();
 
             // buffer the selection
             setSelected(3, 2);
 
+            AddStep("get search text", () => searchText = carousel.SelectedBeatmapSet.Metadata.Title);
+
             setSelected(1, 3);
 
             AddStep("Apply a range filter", () => carousel.Filter(new FilterCriteria
             {
-                SearchText = "#3",
+                SearchText = searchText,
                 StarDifficulty = new FilterCriteria.OptionalRange<double>
                 {
                     Min = 2,
@@ -327,7 +327,7 @@ namespace osu.Game.Tests.Visual.SongSelect
             nextRandom();
             AddAssert("ensure repeat", () => selectedSets.Contains(carousel.SelectedBeatmapSet));
 
-            AddStep("Add set with 100 difficulties", () => carousel.UpdateBeatmapSet(createTestBeatmapSetWithManyDifficulties(set_count + 1)));
+            AddStep("Add set with 100 difficulties", () => carousel.UpdateBeatmapSet(TestResources.CreateTestBeatmapSetInfo(100, rulesets.AvailableRulesets.ToArray())));
             AddStep("Filter Extra", () => carousel.Filter(new FilterCriteria { SearchText = "Extra 10" }, false));
             checkInvisibleDifficultiesUnselectable();
             checkInvisibleDifficultiesUnselectable();
@@ -345,18 +345,21 @@ namespace osu.Game.Tests.Visual.SongSelect
         {
             loadBeatmaps();
 
-            AddStep("Add new set", () => carousel.UpdateBeatmapSet(createTestBeatmapSet(set_count + 1)));
-            AddStep("Add new set", () => carousel.UpdateBeatmapSet(createTestBeatmapSet(set_count + 2)));
+            var firstAdded = TestResources.CreateTestBeatmapSetInfo();
+            var secondAdded = TestResources.CreateTestBeatmapSetInfo();
+
+            AddStep("Add new set", () => carousel.UpdateBeatmapSet(firstAdded));
+            AddStep("Add new set", () => carousel.UpdateBeatmapSet(secondAdded));
 
             checkVisibleItemCount(false, set_count + 2);
 
-            AddStep("Remove set", () => carousel.RemoveBeatmapSet(createTestBeatmapSet(set_count + 2)));
+            AddStep("Remove set", () => carousel.RemoveBeatmapSet(firstAdded));
 
             checkVisibleItemCount(false, set_count + 1);
 
             setSelected(set_count + 1, 1);
 
-            AddStep("Remove set", () => carousel.RemoveBeatmapSet(createTestBeatmapSet(set_count + 1)));
+            AddStep("Remove set", () => carousel.RemoveBeatmapSet(secondAdded));
 
             checkVisibleItemCount(false, set_count);
 
@@ -372,7 +375,7 @@ namespace osu.Game.Tests.Visual.SongSelect
             {
                 sets.Clear();
 
-                var rulesetBeatmapSet = createTestBeatmapSet(1);
+                var rulesetBeatmapSet = TestResources.CreateTestBeatmapSetInfo(1);
                 var taikoRuleset = rulesets.AvailableRulesets.ElementAt(1);
                 rulesetBeatmapSet.Beatmaps.ForEach(b =>
                 {
@@ -397,12 +400,30 @@ namespace osu.Game.Tests.Visual.SongSelect
         [Test]
         public void TestSorting()
         {
-            loadBeatmaps();
+            var sets = new List<BeatmapSetInfo>();
+
+            const string zzz_string = "zzzzz";
+
+            for (int i = 0; i < 20; i++)
+            {
+                // index + 1 because we are using OnlineID which should never be zero.
+                var set = TestResources.CreateTestBeatmapSetInfo(i + 1);
+
+                if (i == 4)
+                    set.Metadata.Artist = zzz_string;
+
+                if (i == 16)
+                    set.Metadata.AuthorString = zzz_string;
+
+                sets.Add(set);
+            }
+
+            loadBeatmaps(sets);
 
             AddStep("Sort by author", () => carousel.Filter(new FilterCriteria { Sort = SortMode.Author }, false));
-            AddAssert("Check zzzzz is at bottom", () => carousel.BeatmapSets.Last().Metadata.Author.Username == "zzzzz");
+            AddAssert($"Check {zzz_string} is at bottom", () => carousel.BeatmapSets.Last().Metadata.Author.Username == zzz_string);
             AddStep("Sort by artist", () => carousel.Filter(new FilterCriteria { Sort = SortMode.Artist }, false));
-            AddAssert($"Check #{set_count} is at bottom", () => carousel.BeatmapSets.Last().Metadata.Title.EndsWith($"#{set_count}!", StringComparison.Ordinal));
+            AddAssert($"Check {zzz_string} is at bottom", () => carousel.BeatmapSets.Last().Metadata.Artist == zzz_string);
         }
 
         [Test]
@@ -413,19 +434,21 @@ namespace osu.Game.Tests.Visual.SongSelect
             for (int i = 0; i < 20; i++)
             {
                 // index + 1 because we are using OnlineID which should never be zero.
-                var set = createTestBeatmapSet(i + 1);
+                var set = TestResources.CreateTestBeatmapSetInfo(i + 1);
                 set.Metadata.Artist = "same artist";
                 set.Metadata.Title = "same title";
                 sets.Add(set);
             }
 
+            int idOffset = sets.First().OnlineID ?? 0;
+
             loadBeatmaps(sets);
 
             AddStep("Sort by artist", () => carousel.Filter(new FilterCriteria { Sort = SortMode.Artist }, false));
-            AddAssert("Items remain in original order", () => carousel.BeatmapSets.Select((set, index) => set.OnlineID == index + 1).All(b => b));
+            AddAssert("Items remain in original order", () => carousel.BeatmapSets.Select((set, index) => set.OnlineID == index + idOffset).All(b => b));
 
             AddStep("Sort by title", () => carousel.Filter(new FilterCriteria { Sort = SortMode.Title }, false));
-            AddAssert("Items remain in original order", () => carousel.BeatmapSets.Select((set, index) => set.OnlineID == index + 1).All(b => b));
+            AddAssert("Items remain in original order", () => carousel.BeatmapSets.Select((set, index) => set.OnlineID == index + idOffset).All(b => b));
         }
 
         [Test]
@@ -435,7 +458,7 @@ namespace osu.Game.Tests.Visual.SongSelect
 
             for (int i = 0; i < 3; i++)
             {
-                var set = createTestBeatmapSet(i);
+                var set = TestResources.CreateTestBeatmapSetInfo(3);
                 set.Beatmaps[0].StarRating = 3 - i;
                 set.Beatmaps[2].StarRating = 6 + i;
                 sets.Add(set);
@@ -504,7 +527,7 @@ namespace osu.Game.Tests.Visual.SongSelect
 
             AddStep("create hidden set", () =>
             {
-                hidingSet = createTestBeatmapSet(1);
+                hidingSet = TestResources.CreateTestBeatmapSetInfo(3);
                 hidingSet.Beatmaps[1].Hidden = true;
 
                 hiddenList.Clear();
@@ -551,7 +574,7 @@ namespace osu.Game.Tests.Visual.SongSelect
 
             AddStep("add mixed ruleset beatmapset", () =>
             {
-                testMixed = createTestBeatmapSet(set_count + 1);
+                testMixed = TestResources.CreateTestBeatmapSetInfo();
 
                 for (int i = 0; i <= 2; i++)
                 {
@@ -574,7 +597,7 @@ namespace osu.Game.Tests.Visual.SongSelect
             BeatmapSetInfo testSingle = null;
             AddStep("add single ruleset beatmapset", () =>
             {
-                testSingle = createTestBeatmapSet(set_count + 2);
+                testSingle = TestResources.CreateTestBeatmapSetInfo();
                 testSingle.Beatmaps.ForEach(b =>
                 {
                     b.Ruleset = rulesets.AvailableRulesets.ElementAt(1);
@@ -594,7 +617,7 @@ namespace osu.Game.Tests.Visual.SongSelect
             List<BeatmapSetInfo> manySets = new List<BeatmapSetInfo>();
 
             for (int i = 1; i <= 50; i++)
-                manySets.Add(createTestBeatmapSet(i));
+                manySets.Add(TestResources.CreateTestBeatmapSetInfo(i));
 
             loadBeatmaps(manySets);
 
@@ -627,18 +650,11 @@ namespace osu.Game.Tests.Visual.SongSelect
             {
                 for (int i = 0; i < 10; i++)
                 {
-                    var set = createTestBeatmapSet(i);
-
-                    foreach (var b in set.Beatmaps)
+                    manySets.Add(TestResources.CreateTestBeatmapSetInfo(3, new[]
                     {
                         // all taiko except for first
-                        int ruleset = i > 0 ? 1 : 0;
-
-                        b.Ruleset = rulesets.GetRuleset(ruleset);
-                        b.RulesetID = ruleset;
-                    }
-
-                    manySets.Add(set);
+                        rulesets.GetRuleset(i > 0 ? 1 : 0)
+                    }));
                 }
             });
 
@@ -660,7 +676,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                 AddStep("Restore different ruleset filter", () =>
                 {
                     carousel.Filter(new FilterCriteria { Ruleset = rulesets.GetRuleset(1) }, false);
-                    eagerSelectedIDs.Add(carousel.SelectedBeatmapSet.ID);
+                    eagerSelectedIDs.Add(carousel.SelectedBeatmapSet.OnlineID ?? -1);
                 });
 
                 AddAssert("selection changed", () => !carousel.SelectedBeatmapInfo.Equals(manySets.First().Beatmaps.First()));
@@ -678,7 +694,7 @@ namespace osu.Game.Tests.Visual.SongSelect
 
             AddStep("add mixed difficulty set", () =>
             {
-                set = createTestBeatmapSet(1);
+                set = TestResources.CreateTestBeatmapSetInfo(1);
                 set.Beatmaps.Clear();
 
                 for (int i = 1; i <= 15; i++)
@@ -730,7 +746,11 @@ namespace osu.Game.Tests.Visual.SongSelect
                     beatmapSets = new List<BeatmapSetInfo>();
 
                     for (int i = 1; i <= (count ?? set_count); i++)
-                        beatmapSets.Add(createTestBeatmapSet(i, randomDifficulties));
+                    {
+                        beatmapSets.Add(randomDifficulties
+                            ? TestResources.CreateTestBeatmapSetInfo()
+                            : TestResources.CreateTestBeatmapSetInfo(3));
+                    }
                 }
 
                 carousel.Filter(initialCriteria?.Invoke() ?? new FilterCriteria());
@@ -766,7 +786,7 @@ namespace osu.Game.Tests.Visual.SongSelect
             AddUntilStep($"selected is set{set}{(diff.HasValue ? $" diff{diff.Value}" : "")}", () =>
             {
                 if (diff != null)
-                    return carousel.SelectedBeatmapInfo.Equals(carousel.BeatmapSets.Skip(set - 1).First().Beatmaps.Skip(diff.Value - 1).First());
+                    return carousel.SelectedBeatmapInfo?.Equals(carousel.BeatmapSets.Skip(set - 1).First().Beatmaps.Skip(diff.Value - 1).First()) == true;
 
                 return carousel.BeatmapSets.Skip(set - 1).First().Beatmaps.Contains(carousel.SelectedBeatmapInfo);
             });
@@ -834,95 +854,6 @@ namespace osu.Game.Tests.Visual.SongSelect
             AddAssert("Selection is visible", selectedBeatmapVisible);
         }
 
-        private BeatmapSetInfo createTestBeatmapSet(int id, bool randomDifficultyCount = false)
-        {
-            var metadata = new BeatmapMetadata
-            {
-                // Create random metadata, then we can check if sorting works based on these
-                Artist = $"peppy{id.ToString().PadLeft(6, '0')}",
-                Title = $"test set #{id}!",
-                AuthorString = string.Concat(Enumerable.Repeat((char)('z' - Math.Min(25, id - 1)), 5))
-            };
-
-            var beatmapSet = new BeatmapSetInfo
-            {
-                ID = id,
-                OnlineID = id,
-                Hash = new MemoryStream(Encoding.UTF8.GetBytes(Guid.NewGuid().ToString())).ComputeMD5Hash(),
-                Metadata = metadata,
-            };
-
-            foreach (var b in getBeatmaps(randomDifficultyCount ? RNG.Next(1, 20) : 3, metadata))
-                beatmapSet.Beatmaps.Add(b);
-
-            return beatmapSet;
-        }
-
-        private IEnumerable<BeatmapInfo> getBeatmaps(int count, BeatmapMetadata metadata)
-        {
-            int id = 0;
-
-            for (int i = 0; i < count; i++)
-            {
-                float diff = (float)i / count * 10;
-
-                string version = "Normal";
-                if (diff > 6.6)
-                    version = "Insane";
-                else if (diff > 3.3)
-                    version = "Hard";
-
-                yield return new BeatmapInfo
-                {
-                    OnlineID = id++ * 10,
-                    DifficultyName = version,
-                    StarRating = diff,
-                    Ruleset = new OsuRuleset().RulesetInfo,
-                    Metadata = metadata,
-                    BaseDifficulty = new BeatmapDifficulty
-                    {
-                        OverallDifficulty = diff,
-                    }
-                };
-            }
-        }
-
-        private BeatmapSetInfo createTestBeatmapSetWithManyDifficulties(int id)
-        {
-            var metadata = new BeatmapMetadata
-            {
-                // Create random metadata, then we can check if sorting works based on these
-                Artist = $"peppy{id.ToString().PadLeft(6, '0')}",
-                Title = $"test set #{id}!",
-                AuthorString = string.Concat(Enumerable.Repeat((char)('z' - Math.Min(25, id - 1)), 5))
-            };
-
-            var toReturn = new BeatmapSetInfo
-            {
-                OnlineID = id,
-                Hash = new MemoryStream(Encoding.UTF8.GetBytes(Guid.NewGuid().ToString())).ComputeMD5Hash(),
-                Metadata = metadata,
-            };
-
-            for (int b = 1; b < 101; b++)
-            {
-                toReturn.Beatmaps.Add(new BeatmapInfo
-                {
-                    OnlineID = b * 10,
-                    DifficultyName = $"Extra {b}",
-                    Ruleset = rulesets.GetRuleset((b - 1) % 4),
-                    StarRating = 2,
-                    Metadata = metadata,
-                    BaseDifficulty = new BeatmapDifficulty
-                    {
-                        OverallDifficulty = 3.5f,
-                    }
-                });
-            }
-
-            return toReturn;
-        }
-
         private class TestBeatmapCarousel : BeatmapCarousel
         {
             public bool PendingFilterTask => PendingFilter != null;
diff --git a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
index 5a9a377605..0494d1de3c 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
@@ -3,15 +3,11 @@
 
 using System;
 using System.Collections.Generic;
-using System.IO;
 using System.Linq;
-using System.Text;
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
 using osu.Framework.Bindables;
-using osu.Framework.Extensions;
-using osu.Framework.Utils;
 using osu.Framework.Platform;
 using osu.Framework.Screens;
 using osu.Framework.Testing;
@@ -31,6 +27,7 @@ using osu.Game.Screens.Play;
 using osu.Game.Screens.Select;
 using osu.Game.Screens.Select.Carousel;
 using osu.Game.Screens.Select.Filter;
+using osu.Game.Tests.Resources;
 using osuTK.Input;
 
 namespace osu.Game.Tests.Visual.SongSelect
@@ -259,7 +256,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                 AddStep("import multi-ruleset map", () =>
                 {
                     var usableRulesets = rulesets.AvailableRulesets.Where(r => r.OnlineID != 2).ToArray();
-                    manager.Import(createTestBeatmapSet(usableRulesets)).Wait();
+                    manager.Import(TestResources.CreateTestBeatmapSetInfo(rulesets: usableRulesets)).Wait();
                 });
             }
             else
@@ -666,7 +663,7 @@ namespace osu.Game.Tests.Visual.SongSelect
             AddStep("import multi-ruleset map", () =>
             {
                 var usableRulesets = rulesets.AvailableRulesets.Where(r => r.OnlineID != 2).ToArray();
-                manager.Import(createTestBeatmapSet(usableRulesets)).Wait();
+                manager.Import(TestResources.CreateTestBeatmapSetInfo(3, usableRulesets)).Wait();
             });
 
             int previousSetID = 0;
@@ -706,7 +703,7 @@ namespace osu.Game.Tests.Visual.SongSelect
             AddStep("import multi-ruleset map", () =>
             {
                 var usableRulesets = rulesets.AvailableRulesets.Where(r => r.OnlineID != 2).ToArray();
-                manager.Import(createTestBeatmapSet(usableRulesets)).Wait();
+                manager.Import(TestResources.CreateTestBeatmapSetInfo(3, usableRulesets)).Wait();
             });
 
             DrawableCarouselBeatmapSet set = null;
@@ -755,7 +752,7 @@ namespace osu.Game.Tests.Visual.SongSelect
             AddStep("import huge difficulty count map", () =>
             {
                 var usableRulesets = rulesets.AvailableRulesets.Where(r => r.OnlineID != 2).ToArray();
-                imported = manager.Import(createTestBeatmapSet(usableRulesets, 50)).Result.Value;
+                imported = manager.Import(TestResources.CreateTestBeatmapSetInfo(50, usableRulesets)).Result.Value;
             });
 
             AddStep("select the first beatmap of import", () => Beatmap.Value = manager.GetWorkingBeatmap(imported.Beatmaps.First()));
@@ -869,11 +866,7 @@ namespace osu.Game.Tests.Visual.SongSelect
 
         private void addRulesetImportStep(int id) => AddStep($"import test map for ruleset {id}", () => importForRuleset(id));
 
-        private void importForRuleset(int id) => manager.Import(createTestBeatmapSet(rulesets.AvailableRulesets.Where(r => r.OnlineID == id).ToArray())).Wait();
-
-        private static int importId;
-
-        private int getImportId() => ++importId;
+        private void importForRuleset(int id) => manager.Import(TestResources.CreateTestBeatmapSetInfo(3, rulesets.AvailableRulesets.Where(r => r.OnlineID == id).ToArray())).Wait();
 
         private void checkMusicPlaying(bool playing) =>
             AddUntilStep($"music {(playing ? "" : "not ")}playing", () => music.IsPlaying == playing);
@@ -896,58 +889,10 @@ namespace osu.Game.Tests.Visual.SongSelect
                 var usableRulesets = rulesets.AvailableRulesets.Where(r => r.OnlineID != 2).ToArray();
 
                 for (int i = 0; i < 100; i += 10)
-                    manager.Import(createTestBeatmapSet(usableRulesets)).Wait();
+                    manager.Import(TestResources.CreateTestBeatmapSetInfo(rulesets: usableRulesets)).Wait();
             });
         }
 
-        private BeatmapSetInfo createTestBeatmapSet(RulesetInfo[] rulesets, int countPerRuleset = 6)
-        {
-            int j = 0;
-            RulesetInfo getRuleset() => rulesets[j++ % rulesets.Length];
-
-            int setId = getImportId();
-
-            var metadata = new BeatmapMetadata
-            {
-                // Create random metadata, then we can check if sorting works based on these
-                Artist = "Some Artist " + RNG.Next(0, 9),
-                Title = $"Some Song (set id {setId})",
-                AuthorString = "Some Guy " + RNG.Next(0, 9),
-            };
-
-            var beatmapSet = new BeatmapSetInfo
-            {
-                OnlineID = setId,
-                Hash = new MemoryStream(Encoding.UTF8.GetBytes(Guid.NewGuid().ToString())).ComputeMD5Hash(),
-                DateAdded = DateTimeOffset.UtcNow,
-                Metadata = metadata
-            };
-
-            for (int i = 0; i < countPerRuleset; i++)
-            {
-                int beatmapId = setId * 1000 + i;
-
-                int length = RNG.Next(30000, 200000);
-                double bpm = RNG.NextSingle(80, 200);
-
-                beatmapSet.Beatmaps.Add(new BeatmapInfo
-                {
-                    Ruleset = getRuleset(),
-                    OnlineID = beatmapId,
-                    DifficultyName = $"{beatmapId} (length {TimeSpan.FromMilliseconds(length):m\\:ss}, bpm {bpm:0.#})",
-                    Length = length,
-                    Metadata = metadata,
-                    BPM = bpm,
-                    BaseDifficulty = new BeatmapDifficulty
-                    {
-                        OverallDifficulty = 3.5f,
-                    },
-                });
-            }
-
-            return beatmapSet;
-        }
-
         protected override void Dispose(bool isDisposing)
         {
             base.Dispose(isDisposing);
diff --git a/osu.Game.Tests/Visual/UserInterface/TestScenePlaylistOverlay.cs b/osu.Game.Tests/Visual/UserInterface/TestScenePlaylistOverlay.cs
index 52141dea1a..39146d584c 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestScenePlaylistOverlay.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestScenePlaylistOverlay.cs
@@ -1,16 +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.Linq;
 using NUnit.Framework;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Testing;
-using osu.Framework.Utils;
 using osu.Game.Beatmaps;
+using osu.Game.Graphics.Containers;
 using osu.Game.Overlays.Music;
+using osu.Game.Tests.Resources;
 using osuTK;
 using osuTK.Input;
 
@@ -22,6 +22,8 @@ namespace osu.Game.Tests.Visual.UserInterface
 
         private PlaylistOverlay playlistOverlay;
 
+        private BeatmapSetInfo first;
+
         [SetUp]
         public void Setup() => Schedule(() =>
         {
@@ -43,19 +45,11 @@ namespace osu.Game.Tests.Visual.UserInterface
 
             for (int i = 0; i < 100; i++)
             {
-                beatmapSets.Add(new BeatmapSetInfo
-                {
-                    Metadata = new BeatmapMetadata
-                    {
-                        // Create random metadata, then we can check if sorting works based on these
-                        Artist = "Some Artist " + RNG.Next(0, 9),
-                        Title = $"Some Song {i + 1}",
-                        AuthorString = "Some Guy " + RNG.Next(0, 9),
-                    },
-                    DateAdded = DateTimeOffset.UtcNow,
-                });
+                beatmapSets.Add(TestResources.CreateTestBeatmapSetInfo());
             }
 
+            first = beatmapSets.First();
+
             playlistOverlay.BeatmapSets.BindTo(beatmapSets);
         });
 
@@ -66,7 +60,7 @@ namespace osu.Game.Tests.Visual.UserInterface
 
             AddStep("hold 1st item handle", () =>
             {
-                var handle = this.ChildrenOfType<PlaylistItem.PlaylistItemHandle>().First();
+                var handle = this.ChildrenOfType<OsuRearrangeableListItem<BeatmapSetInfo>.PlaylistItemHandle>().First();
                 InputManager.MoveMouseTo(handle.ScreenSpaceDrawQuad.Centre);
                 InputManager.PressButton(MouseButton.Left);
             });
@@ -77,7 +71,7 @@ namespace osu.Game.Tests.Visual.UserInterface
                 InputManager.MoveMouseTo(item.ScreenSpaceDrawQuad.Centre);
             });
 
-            AddAssert("song 1 is 5th", () => beatmapSets[4].Metadata.Title == "Some Song 1");
+            AddAssert("song 1 is 5th", () => beatmapSets[4] == first);
 
             AddStep("release handle", () => InputManager.ReleaseButton(MouseButton.Left));
         }

From 7603f7eb366460415c0a83badd6ff667faf86440 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 24 Nov 2021 18:14:18 +0900
Subject: [PATCH 1244/5547] Fix a few incorrectly updated arguments

---
 .../Visual/SongSelect/TestSceneBeatmapCarousel.cs         | 8 +++-----
 1 file changed, 3 insertions(+), 5 deletions(-)

diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs
index b979457c75..5906979bc4 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs
@@ -149,7 +149,7 @@ namespace osu.Game.Tests.Visual.SongSelect
             const int total_set_count = 200;
 
             for (int i = 0; i < total_set_count; i++)
-                sets.Add(TestResources.CreateTestBeatmapSetInfo(i + 1));
+                sets.Add(TestResources.CreateTestBeatmapSetInfo());
 
             loadBeatmaps(sets);
 
@@ -406,8 +406,7 @@ namespace osu.Game.Tests.Visual.SongSelect
 
             for (int i = 0; i < 20; i++)
             {
-                // index + 1 because we are using OnlineID which should never be zero.
-                var set = TestResources.CreateTestBeatmapSetInfo(i + 1);
+                var set = TestResources.CreateTestBeatmapSetInfo();
 
                 if (i == 4)
                     set.Metadata.Artist = zzz_string;
@@ -433,8 +432,7 @@ namespace osu.Game.Tests.Visual.SongSelect
 
             for (int i = 0; i < 20; i++)
             {
-                // index + 1 because we are using OnlineID which should never be zero.
-                var set = TestResources.CreateTestBeatmapSetInfo(i + 1);
+                var set = TestResources.CreateTestBeatmapSetInfo();
                 set.Metadata.Artist = "same artist";
                 set.Metadata.Title = "same title";
                 sets.Add(set);

From 0fe27cc8a1971cecd9a747e0796299ad6b5eddc2 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 24 Nov 2021 18:29:33 +0900
Subject: [PATCH 1245/5547] Replace one more usage

---
 .../TestSceneBeatmapRecommendations.cs        | 52 +++++++------------
 1 file changed, 19 insertions(+), 33 deletions(-)

diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapRecommendations.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapRecommendations.cs
index 60b6fd81a2..ef11ad4153 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapRecommendations.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapRecommendations.cs
@@ -16,6 +16,7 @@ using osu.Game.Rulesets.Catch;
 using osu.Game.Rulesets.Mania;
 using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Taiko;
+using osu.Game.Tests.Resources;
 using osu.Game.Users;
 
 namespace osu.Game.Tests.Visual.SongSelect
@@ -89,7 +90,7 @@ namespace osu.Game.Tests.Visual.SongSelect
 
                 for (int i = 0; i < import_count; ++i)
                 {
-                    beatmapSets.Add(importBeatmapSet(i, Enumerable.Repeat(new OsuRuleset().RulesetInfo, 5)));
+                    beatmapSets.Add(importBeatmapSet(Enumerable.Repeat(new OsuRuleset().RulesetInfo, 5)));
                 }
             });
 
@@ -103,9 +104,8 @@ namespace osu.Game.Tests.Visual.SongSelect
         {
             BeatmapSetInfo catchSet = null, mixedSet = null;
 
-            AddStep("create catch beatmapset", () => catchSet = importBeatmapSet(1, new[] { new CatchRuleset().RulesetInfo }));
-            AddStep("create mixed beatmapset", () => mixedSet = importBeatmapSet(2,
-                new[] { new TaikoRuleset().RulesetInfo, new CatchRuleset().RulesetInfo, new ManiaRuleset().RulesetInfo }));
+            AddStep("create catch beatmapset", () => catchSet = importBeatmapSet(new[] { new CatchRuleset().RulesetInfo }));
+            AddStep("create mixed beatmapset", () => mixedSet = importBeatmapSet(new[] { new TaikoRuleset().RulesetInfo, new CatchRuleset().RulesetInfo, new ManiaRuleset().RulesetInfo }));
 
             AddAssert("all sets imported", () => ensureAllBeatmapSetsImported(new[] { catchSet, mixedSet }));
 
@@ -121,9 +121,8 @@ namespace osu.Game.Tests.Visual.SongSelect
         {
             BeatmapSetInfo osuSet = null, mixedSet = null;
 
-            AddStep("create osu! beatmapset", () => osuSet = importBeatmapSet(1, new[] { new OsuRuleset().RulesetInfo }));
-            AddStep("create mixed beatmapset", () => mixedSet = importBeatmapSet(2,
-                new[] { new TaikoRuleset().RulesetInfo, new CatchRuleset().RulesetInfo, new ManiaRuleset().RulesetInfo }));
+            AddStep("create osu! beatmapset", () => osuSet = importBeatmapSet(new[] { new OsuRuleset().RulesetInfo }));
+            AddStep("create mixed beatmapset", () => mixedSet = importBeatmapSet(new[] { new TaikoRuleset().RulesetInfo, new CatchRuleset().RulesetInfo, new ManiaRuleset().RulesetInfo }));
 
             AddAssert("all sets imported", () => ensureAllBeatmapSetsImported(new[] { osuSet, mixedSet }));
 
@@ -139,9 +138,8 @@ namespace osu.Game.Tests.Visual.SongSelect
         {
             BeatmapSetInfo osuSet = null, mixedSet = null;
 
-            AddStep("create osu! beatmapset", () => osuSet = importBeatmapSet(1, new[] { new OsuRuleset().RulesetInfo }));
-            AddStep("create mixed beatmapset", () => mixedSet = importBeatmapSet(2,
-                new[] { new TaikoRuleset().RulesetInfo, new CatchRuleset().RulesetInfo, new TaikoRuleset().RulesetInfo }));
+            AddStep("create osu! beatmapset", () => osuSet = importBeatmapSet(new[] { new OsuRuleset().RulesetInfo }));
+            AddStep("create mixed beatmapset", () => mixedSet = importBeatmapSet(new[] { new TaikoRuleset().RulesetInfo, new CatchRuleset().RulesetInfo, new TaikoRuleset().RulesetInfo }));
 
             AddAssert("all sets imported", () => ensureAllBeatmapSetsImported(new[] { osuSet, mixedSet }));
 
@@ -157,8 +155,8 @@ namespace osu.Game.Tests.Visual.SongSelect
         {
             BeatmapSetInfo osuSet = null, maniaSet = null;
 
-            AddStep("create osu! beatmapset", () => osuSet = importBeatmapSet(1, new[] { new OsuRuleset().RulesetInfo }));
-            AddStep("create mania beatmapset", () => maniaSet = importBeatmapSet(2, Enumerable.Repeat(new ManiaRuleset().RulesetInfo, 10)));
+            AddStep("create osu! beatmapset", () => osuSet = importBeatmapSet(new[] { new OsuRuleset().RulesetInfo }));
+            AddStep("create mania beatmapset", () => maniaSet = importBeatmapSet(Enumerable.Repeat(new ManiaRuleset().RulesetInfo, 10)));
 
             AddAssert("all sets imported", () => ensureAllBeatmapSetsImported(new[] { osuSet, maniaSet }));
 
@@ -169,31 +167,19 @@ namespace osu.Game.Tests.Visual.SongSelect
             presentAndConfirm(() => maniaSet, 5);
         }
 
-        private BeatmapSetInfo importBeatmapSet(int importID, IEnumerable<RulesetInfo> difficultyRulesets)
+        private BeatmapSetInfo importBeatmapSet(IEnumerable<RulesetInfo> difficultyRulesets)
         {
-            var metadata = new BeatmapMetadata
-            {
-                Artist = "SomeArtist",
-                AuthorString = "SomeAuthor",
-                Title = $"import {importID}"
-            };
+            var rulesets = difficultyRulesets.ToArray();
 
-            var beatmapSet = new BeatmapSetInfo
-            {
-                Hash = Guid.NewGuid().ToString(),
-                OnlineID = importID,
-                Metadata = metadata,
-            };
+            var beatmapSet = TestResources.CreateTestBeatmapSetInfo(rulesets.Length, rulesets);
 
-            beatmapSet.Beatmaps.AddRange(difficultyRulesets.Select((ruleset, difficultyIndex) => new BeatmapInfo
+            for (int i = 0; i < rulesets.Length; i++)
             {
-                OnlineID = importID * 1024 + difficultyIndex,
-                Metadata = metadata,
-                BaseDifficulty = new BeatmapDifficulty(),
-                Ruleset = ruleset,
-                StarRating = difficultyIndex + 1,
-                DifficultyName = $"SR{difficultyIndex + 1}"
-            }));
+                var beatmap = beatmapSet.Beatmaps[i];
+
+                beatmap.StarRating = i + 1;
+                beatmap.DifficultyName = $"SR{i + 1}";
+            }
 
             return Game.BeatmapManager.Import(beatmapSet).Result.Value;
         }

From 183b95cbc21b0b56b44937a76410689921355024 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 24 Nov 2021 18:42:47 +0900
Subject: [PATCH 1246/5547] Rename `BeatmapSetOnlineStatus` to
 `BeatmapOnlineStatus`

This variable is used at more than just a set level.
---
 .../Beatmaps/IO/ImportBeatmapTest.cs           |  2 +-
 .../Database/BeatmapImporterTests.cs           |  2 +-
 .../NonVisual/Filtering/FilterMatchingTest.cs  |  2 +-
 .../Filtering/FilterQueryParserTest.cs         |  4 ++--
 .../Visual/Beatmaps/TestSceneBeatmapCard.cs    |  6 +++---
 .../TestSceneBeatmapSetOnlineStatusPill.cs     |  2 +-
 .../TestSceneBeatmapSetOverlayDetails.cs       |  2 +-
 .../Visual/Ranking/TestSceneResultsScreen.cs   |  2 +-
 .../SongSelect/TestSceneBeatmapInfoWedge.cs    |  2 +-
 .../SongSelect/TestSceneBeatmapLeaderboard.cs  |  4 ++--
 .../UserInterface/TestSceneLabelledDropdown.cs |  2 +-
 .../UserInterface/TestSceneOsuDropdown.cs      |  2 +-
 osu.Game/Beatmaps/BeatmapInfo.cs               |  2 +-
 osu.Game/Beatmaps/BeatmapOnlineLookupQueue.cs  |  4 ++--
 ...tOnlineStatus.cs => BeatmapOnlineStatus.cs} |  6 +++---
 osu.Game/Beatmaps/BeatmapSetInfo.cs            |  2 +-
 .../Drawables/BeatmapSetOnlineStatusPill.cs    | 12 ++++++------
 .../Statistics/BeatmapCardDateStatistic.cs     |  8 ++++----
 osu.Game/Beatmaps/IBeatmapSetOnlineInfo.cs     |  4 ++--
 osu.Game/Graphics/OsuColour.cs                 | 18 +++++++++---------
 osu.Game/Models/RealmBeatmap.cs                |  4 ++--
 .../API/Requests/Responses/APIBeatmap.cs       |  2 +-
 .../API/Requests/Responses/APIBeatmapSet.cs    |  2 +-
 .../BeatmapSet/Scores/ScoresContainer.cs       |  2 +-
 osu.Game/Screens/Ranking/SoloResultsScreen.cs  |  2 +-
 osu.Game/Screens/Select/FilterCriteria.cs      |  2 +-
 .../Select/Leaderboards/BeatmapLeaderboard.cs  |  2 +-
 osu.Game/Tests/Visual/OsuTestScene.cs          |  2 +-
 28 files changed, 53 insertions(+), 53 deletions(-)
 rename osu.Game/Beatmaps/{BeatmapSetOnlineStatus.cs => BeatmapOnlineStatus.cs} (84%)

diff --git a/osu.Game.Tests/Beatmaps/IO/ImportBeatmapTest.cs b/osu.Game.Tests/Beatmaps/IO/ImportBeatmapTest.cs
index a404a54ee4..cac1bf05a6 100644
--- a/osu.Game.Tests/Beatmaps/IO/ImportBeatmapTest.cs
+++ b/osu.Game.Tests/Beatmaps/IO/ImportBeatmapTest.cs
@@ -596,7 +596,7 @@ namespace osu.Game.Tests.Beatmaps.IO
                             {
                                 OnlineID = 2,
                                 Metadata = metadata,
-                                Status = BeatmapSetOnlineStatus.Loved,
+                                Status = BeatmapOnlineStatus.Loved,
                                 BaseDifficulty = difficulty
                             }
                         }
diff --git a/osu.Game.Tests/Database/BeatmapImporterTests.cs b/osu.Game.Tests/Database/BeatmapImporterTests.cs
index 71e5e9081c..9ee237cfd9 100644
--- a/osu.Game.Tests/Database/BeatmapImporterTests.cs
+++ b/osu.Game.Tests/Database/BeatmapImporterTests.cs
@@ -550,7 +550,7 @@ namespace osu.Game.Tests.Database
                         new RealmBeatmap(ruleset, new RealmBeatmapDifficulty(), metadata)
                         {
                             OnlineID = 2,
-                            Status = BeatmapSetOnlineStatus.Loved,
+                            Status = BeatmapOnlineStatus.Loved,
                         }
                     }
                 };
diff --git a/osu.Game.Tests/NonVisual/Filtering/FilterMatchingTest.cs b/osu.Game.Tests/NonVisual/Filtering/FilterMatchingTest.cs
index e49b0d3a67..55378043e6 100644
--- a/osu.Game.Tests/NonVisual/Filtering/FilterMatchingTest.cs
+++ b/osu.Game.Tests/NonVisual/Filtering/FilterMatchingTest.cs
@@ -38,7 +38,7 @@ namespace osu.Game.Tests.NonVisual.Filtering
             Length = 2500,
             BPM = 160,
             BeatDivisor = 12,
-            Status = BeatmapSetOnlineStatus.Loved
+            Status = BeatmapOnlineStatus.Loved
         };
 
         [Test]
diff --git a/osu.Game.Tests/NonVisual/Filtering/FilterQueryParserTest.cs b/osu.Game.Tests/NonVisual/Filtering/FilterQueryParserTest.cs
index df42c70c87..460f89528b 100644
--- a/osu.Game.Tests/NonVisual/Filtering/FilterQueryParserTest.cs
+++ b/osu.Game.Tests/NonVisual/Filtering/FilterQueryParserTest.cs
@@ -162,9 +162,9 @@ 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(BeatmapSetOnlineStatus.Ranked, filterCriteria.OnlineStatus.Min);
+            Assert.AreEqual(BeatmapOnlineStatus.Ranked, filterCriteria.OnlineStatus.Min);
             Assert.IsTrue(filterCriteria.OnlineStatus.IsLowerInclusive);
-            Assert.AreEqual(BeatmapSetOnlineStatus.Ranked, filterCriteria.OnlineStatus.Max);
+            Assert.AreEqual(BeatmapOnlineStatus.Ranked, filterCriteria.OnlineStatus.Max);
             Assert.IsTrue(filterCriteria.OnlineStatus.IsUpperInclusive);
         }
 
diff --git a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs
index addec15881..cae7781db7 100644
--- a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs
+++ b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs
@@ -42,7 +42,7 @@ namespace osu.Game.Tests.Visual.Beatmaps
 
             var withStatistics = CreateAPIBeatmapSet(Ruleset.Value);
             withStatistics.Title = withStatistics.TitleUnicode = "play favourite stats";
-            withStatistics.Status = BeatmapSetOnlineStatus.Approved;
+            withStatistics.Status = BeatmapOnlineStatus.Approved;
             withStatistics.FavouriteCount = 284_239;
             withStatistics.PlayCount = 999_001;
             withStatistics.Ranked = DateTimeOffset.Now.AddDays(-45);
@@ -63,7 +63,7 @@ namespace osu.Game.Tests.Visual.Beatmaps
             var someDifficulties = getManyDifficultiesBeatmapSet(11);
             someDifficulties.Title = someDifficulties.TitleUnicode = "favourited";
             someDifficulties.Title = someDifficulties.TitleUnicode = "some difficulties";
-            someDifficulties.Status = BeatmapSetOnlineStatus.Qualified;
+            someDifficulties.Status = BeatmapOnlineStatus.Qualified;
             someDifficulties.HasFavourited = true;
             someDifficulties.FavouriteCount = 1;
             someDifficulties.NominationStatus = new BeatmapSetNominationStatus
@@ -73,7 +73,7 @@ namespace osu.Game.Tests.Visual.Beatmaps
             };
 
             var manyDifficulties = getManyDifficultiesBeatmapSet(100);
-            manyDifficulties.Status = BeatmapSetOnlineStatus.Pending;
+            manyDifficulties.Status = BeatmapOnlineStatus.Pending;
 
             var explicitMap = CreateAPIBeatmapSet(Ruleset.Value);
             explicitMap.Title = someDifficulties.TitleUnicode = "explicit beatmap";
diff --git a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapSetOnlineStatusPill.cs b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapSetOnlineStatusPill.cs
index c48b63ac89..8132fe6ab8 100644
--- a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapSetOnlineStatusPill.cs
+++ b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapSetOnlineStatusPill.cs
@@ -26,7 +26,7 @@ namespace osu.Game.Tests.Visual.Beatmaps
             Origin = Anchor.Centre,
             Direction = FillDirection.Vertical,
             Spacing = new Vector2(0, 10),
-            ChildrenEnumerable = Enum.GetValues(typeof(BeatmapSetOnlineStatus)).Cast<BeatmapSetOnlineStatus>().Select(status => new BeatmapSetOnlineStatusPill
+            ChildrenEnumerable = Enum.GetValues(typeof(BeatmapOnlineStatus)).Cast<BeatmapOnlineStatus>().Select(status => new BeatmapSetOnlineStatusPill
             {
                 AutoSizeAxes = Axes.Both,
                 Anchor = Anchor.Centre,
diff --git a/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlayDetails.cs b/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlayDetails.cs
index 9c0c67b1d8..629c413d85 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlayDetails.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlayDetails.cs
@@ -57,7 +57,7 @@ namespace osu.Game.Tests.Visual.Online
                     }
                 },
                 Ratings = Enumerable.Range(0, 11).Select(_ => RNG.Next(10)).ToArray(),
-                Status = BeatmapSetOnlineStatus.Ranked
+                Status = BeatmapOnlineStatus.Ranked
             };
         }
 
diff --git a/osu.Game.Tests/Visual/Ranking/TestSceneResultsScreen.cs b/osu.Game.Tests/Visual/Ranking/TestSceneResultsScreen.cs
index 423c0a048c..94700bac6a 100644
--- a/osu.Game.Tests/Visual/Ranking/TestSceneResultsScreen.cs
+++ b/osu.Game.Tests/Visual/Ranking/TestSceneResultsScreen.cs
@@ -338,7 +338,7 @@ namespace osu.Game.Tests.Visual.Ranking
                 : base(score, true)
             {
                 Score.BeatmapInfo.OnlineID = 0;
-                Score.BeatmapInfo.Status = BeatmapSetOnlineStatus.Pending;
+                Score.BeatmapInfo.Status = BeatmapOnlineStatus.Pending;
             }
 
             protected override void LoadComplete()
diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapInfoWedge.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapInfoWedge.cs
index 1b070c00bf..e7c54efa8c 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapInfoWedge.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapInfoWedge.cs
@@ -220,7 +220,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                         Title = "Verrrrry long Title"
                     },
                     DifficultyName = "Verrrrrrrrrrrrrrrrrrrrrrrrrrrrry long Version",
-                    Status = BeatmapSetOnlineStatus.Graveyard,
+                    Status = BeatmapOnlineStatus.Graveyard,
                 },
             };
         }
diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
index a8a7a5d350..2a2df777f7 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
@@ -121,7 +121,7 @@ namespace osu.Game.Tests.Visual.SongSelect
         [Test]
         public void TestBeatmapStates()
         {
-            foreach (BeatmapSetOnlineStatus status in Enum.GetValues(typeof(BeatmapSetOnlineStatus)))
+            foreach (BeatmapOnlineStatus status in Enum.GetValues(typeof(BeatmapOnlineStatus)))
                 AddStep($"{status} beatmap", () => showBeatmapWithStatus(status));
         }
 
@@ -384,7 +384,7 @@ namespace osu.Game.Tests.Visual.SongSelect
             };
         }
 
-        private void showBeatmapWithStatus(BeatmapSetOnlineStatus status)
+        private void showBeatmapWithStatus(BeatmapOnlineStatus status)
         {
             leaderboard.BeatmapInfo = new BeatmapInfo
             {
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneLabelledDropdown.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneLabelledDropdown.cs
index 4b74e37ec4..a9aaefdf6c 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneLabelledDropdown.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneLabelledDropdown.cs
@@ -25,7 +25,7 @@ namespace osu.Game.Tests.Visual.UserInterface
 
         [Test]
         public void TestLabelledEnumDropdown()
-            => AddStep(@"create dropdown", () => Child = new LabelledEnumDropdown<BeatmapSetOnlineStatus>
+            => AddStep(@"create dropdown", () => Child = new LabelledEnumDropdown<BeatmapOnlineStatus>
             {
                 Label = @"Beatmap status",
                 Description = @"This is a description"
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneOsuDropdown.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneOsuDropdown.cs
index 9e77fcf675..cce0295413 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneOsuDropdown.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneOsuDropdown.cs
@@ -10,7 +10,7 @@ namespace osu.Game.Tests.Visual.UserInterface
     public class TestSceneOsuDropdown : ThemeComparisonTestScene
     {
         protected override Drawable CreateContent() =>
-            new OsuEnumDropdown<BeatmapSetOnlineStatus>
+            new OsuEnumDropdown<BeatmapOnlineStatus>
             {
                 Anchor = Anchor.Centre,
                 Origin = Anchor.Centre,
diff --git a/osu.Game/Beatmaps/BeatmapInfo.cs b/osu.Game/Beatmaps/BeatmapInfo.cs
index 782944c28e..36f82ac56c 100644
--- a/osu.Game/Beatmaps/BeatmapInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapInfo.cs
@@ -35,7 +35,7 @@ namespace osu.Game.Beatmaps
         [JsonIgnore]
         public int BeatmapSetInfoID { get; set; }
 
-        public BeatmapSetOnlineStatus Status { get; set; } = BeatmapSetOnlineStatus.None;
+        public BeatmapOnlineStatus Status { get; set; } = BeatmapOnlineStatus.None;
 
         [Required]
         public BeatmapSetInfo BeatmapSet { get; set; }
diff --git a/osu.Game/Beatmaps/BeatmapOnlineLookupQueue.cs b/osu.Game/Beatmaps/BeatmapOnlineLookupQueue.cs
index 7c80d8ad56..76232c2932 100644
--- a/osu.Game/Beatmaps/BeatmapOnlineLookupQueue.cs
+++ b/osu.Game/Beatmaps/BeatmapOnlineLookupQueue.cs
@@ -83,7 +83,7 @@ namespace osu.Game.Beatmaps
                 if (res != null)
                 {
                     beatmapInfo.Status = res.Status;
-                    beatmapInfo.BeatmapSet.Status = res.BeatmapSet?.Status ?? BeatmapSetOnlineStatus.None;
+                    beatmapInfo.BeatmapSet.Status = res.BeatmapSet?.Status ?? BeatmapOnlineStatus.None;
                     beatmapInfo.BeatmapSet.OnlineID = res.OnlineBeatmapSetID;
                     beatmapInfo.OnlineID = res.OnlineID;
 
@@ -182,7 +182,7 @@ namespace osu.Game.Beatmaps
                         {
                             if (reader.Read())
                             {
-                                var status = (BeatmapSetOnlineStatus)reader.GetByte(2);
+                                var status = (BeatmapOnlineStatus)reader.GetByte(2);
 
                                 beatmapInfo.Status = status;
                                 beatmapInfo.BeatmapSet.Status = status;
diff --git a/osu.Game/Beatmaps/BeatmapSetOnlineStatus.cs b/osu.Game/Beatmaps/BeatmapOnlineStatus.cs
similarity index 84%
rename from osu.Game/Beatmaps/BeatmapSetOnlineStatus.cs
rename to osu.Game/Beatmaps/BeatmapOnlineStatus.cs
index edaf044466..7ac25b7b75 100644
--- a/osu.Game/Beatmaps/BeatmapSetOnlineStatus.cs
+++ b/osu.Game/Beatmaps/BeatmapOnlineStatus.cs
@@ -6,7 +6,7 @@ using osu.Game.Resources.Localisation.Web;
 
 namespace osu.Game.Beatmaps
 {
-    public enum BeatmapSetOnlineStatus
+    public enum BeatmapOnlineStatus
     {
         None = -3,
 
@@ -34,7 +34,7 @@ namespace osu.Game.Beatmaps
 
     public static class BeatmapSetOnlineStatusExtensions
     {
-        public static bool GrantsPerformancePoints(this BeatmapSetOnlineStatus status)
-            => status == BeatmapSetOnlineStatus.Ranked || status == BeatmapSetOnlineStatus.Approved;
+        public static bool GrantsPerformancePoints(this BeatmapOnlineStatus status)
+            => status == BeatmapOnlineStatus.Ranked || status == BeatmapOnlineStatus.Approved;
     }
 }
diff --git a/osu.Game/Beatmaps/BeatmapSetInfo.cs b/osu.Game/Beatmaps/BeatmapSetInfo.cs
index 71bca48c2c..5bb9eefc6e 100644
--- a/osu.Game/Beatmaps/BeatmapSetInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapSetInfo.cs
@@ -34,7 +34,7 @@ namespace osu.Game.Beatmaps
         [NotNull]
         public List<BeatmapInfo> Beatmaps { get; } = new List<BeatmapInfo>();
 
-        public BeatmapSetOnlineStatus Status { get; set; } = BeatmapSetOnlineStatus.None;
+        public BeatmapOnlineStatus Status { get; set; } = BeatmapOnlineStatus.None;
 
         [NotNull]
         public List<BeatmapSetFileInfo> Files { get; set; } = new List<BeatmapSetFileInfo>();
diff --git a/osu.Game/Beatmaps/Drawables/BeatmapSetOnlineStatusPill.cs b/osu.Game/Beatmaps/Drawables/BeatmapSetOnlineStatusPill.cs
index ec098f4ca2..6345085069 100644
--- a/osu.Game/Beatmaps/Drawables/BeatmapSetOnlineStatusPill.cs
+++ b/osu.Game/Beatmaps/Drawables/BeatmapSetOnlineStatusPill.cs
@@ -18,9 +18,9 @@ namespace osu.Game.Beatmaps.Drawables
 {
     public class BeatmapSetOnlineStatusPill : CircularContainer
     {
-        private BeatmapSetOnlineStatus status;
+        private BeatmapOnlineStatus status;
 
-        public BeatmapSetOnlineStatus Status
+        public BeatmapOnlineStatus Status
         {
             get => status;
             set
@@ -75,7 +75,7 @@ namespace osu.Game.Beatmaps.Drawables
                 },
             };
 
-            Status = BeatmapSetOnlineStatus.None;
+            Status = BeatmapOnlineStatus.None;
             TextPadding = new MarginPadding { Horizontal = 5, Bottom = 1 };
         }
 
@@ -87,14 +87,14 @@ namespace osu.Game.Beatmaps.Drawables
 
         private void updateState()
         {
-            Alpha = Status == BeatmapSetOnlineStatus.None ? 0 : 1;
+            Alpha = Status == BeatmapOnlineStatus.None ? 0 : 1;
 
             statusText.Text = Status.GetLocalisableDescription().ToUpper();
 
             if (colourProvider != null)
-                statusText.Colour = status == BeatmapSetOnlineStatus.Graveyard ? colourProvider.Background1 : colourProvider.Background3;
+                statusText.Colour = status == BeatmapOnlineStatus.Graveyard ? colourProvider.Background1 : colourProvider.Background3;
             else
-                statusText.Colour = status == BeatmapSetOnlineStatus.Graveyard ? colours.GreySeafoamLight : Color4.Black;
+                statusText.Colour = status == BeatmapOnlineStatus.Graveyard ? colours.GreySeafoamLight : Color4.Black;
 
             background.Colour = OsuColour.ForBeatmapSetOnlineStatus(Status) ?? colourProvider?.Light1 ?? colours.GreySeafoamLighter;
         }
diff --git a/osu.Game/Beatmaps/Drawables/Cards/Statistics/BeatmapCardDateStatistic.cs b/osu.Game/Beatmaps/Drawables/Cards/Statistics/BeatmapCardDateStatistic.cs
index 8f2c4b538c..9dbe5a9114 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/Statistics/BeatmapCardDateStatistic.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/Statistics/BeatmapCardDateStatistic.cs
@@ -41,10 +41,10 @@ namespace osu.Game.Beatmaps.Drawables.Cards.Statistics
             // reference: https://github.com/ppy/osu-web/blob/ef432c11719fd1207bec5f9194b04f0033bdf02c/resources/assets/lib/beatmapset-panel.tsx#L36-L44
             switch (beatmapSetInfo.Status)
             {
-                case BeatmapSetOnlineStatus.Ranked:
-                case BeatmapSetOnlineStatus.Approved:
-                case BeatmapSetOnlineStatus.Loved:
-                case BeatmapSetOnlineStatus.Qualified:
+                case BeatmapOnlineStatus.Ranked:
+                case BeatmapOnlineStatus.Approved:
+                case BeatmapOnlineStatus.Loved:
+                case BeatmapOnlineStatus.Qualified:
                     return beatmapSetInfo.Ranked;
 
                 default:
diff --git a/osu.Game/Beatmaps/IBeatmapSetOnlineInfo.cs b/osu.Game/Beatmaps/IBeatmapSetOnlineInfo.cs
index 2982cf9c3a..0510770d5b 100644
--- a/osu.Game/Beatmaps/IBeatmapSetOnlineInfo.cs
+++ b/osu.Game/Beatmaps/IBeatmapSetOnlineInfo.cs
@@ -30,7 +30,7 @@ namespace osu.Game.Beatmaps
         /// <summary>
         /// The status of this beatmap set.
         /// </summary>
-        BeatmapSetOnlineStatus Status { get; }
+        BeatmapOnlineStatus Status { get; }
 
         /// <summary>
         /// Whether or not this beatmap set has explicit content.
@@ -105,7 +105,7 @@ namespace osu.Game.Beatmaps
 
         /// <summary>
         /// Contains the current hype status of the beatmap set.
-        /// Non-null only for <see cref="BeatmapSetOnlineStatus.WIP"/>, <see cref="BeatmapSetOnlineStatus.Pending"/>, and <see cref="BeatmapSetOnlineStatus.Qualified"/> sets.
+        /// Non-null only for <see cref="BeatmapOnlineStatus.WIP"/>, <see cref="BeatmapOnlineStatus.Pending"/>, and <see cref="BeatmapOnlineStatus.Qualified"/> sets.
         /// </summary>
         /// <remarks>
         /// See: https://github.com/ppy/osu-web/blob/93930cd02cfbd49724929912597c727c9fbadcd1/app/Models/Beatmapset.php#L155
diff --git a/osu.Game/Graphics/OsuColour.cs b/osu.Game/Graphics/OsuColour.cs
index d3afb21933..69dfd3a7a1 100644
--- a/osu.Game/Graphics/OsuColour.cs
+++ b/osu.Game/Graphics/OsuColour.cs
@@ -122,34 +122,34 @@ namespace osu.Game.Graphics
         }
 
         /// <summary>
-        /// Retrieves a colour for the given <see cref="BeatmapSetOnlineStatus"/>.
+        /// Retrieves a colour for the given <see cref="BeatmapOnlineStatus"/>.
         /// A <see langword="null"/> value indicates that a "background" shade from the local <see cref="OverlayColourProvider"/>
         /// (or another fallback colour) should be used.
         /// </summary>
         /// <remarks>
         /// Sourced from web: https://github.com/ppy/osu-web/blob/007eebb1916ed5cb6a7866d82d8011b1060a945e/resources/assets/less/layout.less#L36-L50
         /// </remarks>
-        public static Color4? ForBeatmapSetOnlineStatus(BeatmapSetOnlineStatus status)
+        public static Color4? ForBeatmapSetOnlineStatus(BeatmapOnlineStatus status)
         {
             switch (status)
             {
-                case BeatmapSetOnlineStatus.Ranked:
-                case BeatmapSetOnlineStatus.Approved:
+                case BeatmapOnlineStatus.Ranked:
+                case BeatmapOnlineStatus.Approved:
                     return Color4Extensions.FromHex(@"b3ff66");
 
-                case BeatmapSetOnlineStatus.Loved:
+                case BeatmapOnlineStatus.Loved:
                     return Color4Extensions.FromHex(@"ff66ab");
 
-                case BeatmapSetOnlineStatus.Qualified:
+                case BeatmapOnlineStatus.Qualified:
                     return Color4Extensions.FromHex(@"66ccff");
 
-                case BeatmapSetOnlineStatus.Pending:
+                case BeatmapOnlineStatus.Pending:
                     return Color4Extensions.FromHex(@"ffd966");
 
-                case BeatmapSetOnlineStatus.WIP:
+                case BeatmapOnlineStatus.WIP:
                     return Color4Extensions.FromHex(@"ff9966");
 
-                case BeatmapSetOnlineStatus.Graveyard:
+                case BeatmapOnlineStatus.Graveyard:
                     return Color4.Black;
 
                 default:
diff --git a/osu.Game/Models/RealmBeatmap.cs b/osu.Game/Models/RealmBeatmap.cs
index 4e3f96ee5f..005a7ac2a8 100644
--- a/osu.Game/Models/RealmBeatmap.cs
+++ b/osu.Game/Models/RealmBeatmap.cs
@@ -39,9 +39,9 @@ namespace osu.Game.Models
         [Ignored]
         public RealmNamedFileUsage? File => BeatmapSet?.Files.First(f => f.File.Hash == Hash);
 
-        public BeatmapSetOnlineStatus Status
+        public BeatmapOnlineStatus Status
         {
-            get => (BeatmapSetOnlineStatus)StatusInt;
+            get => (BeatmapOnlineStatus)StatusInt;
             set => StatusInt = (int)value;
         }
 
diff --git a/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs b/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs
index 243c39ab53..ebbac0dcab 100644
--- a/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs
@@ -20,7 +20,7 @@ namespace osu.Game.Online.API.Requests.Responses
         public int OnlineBeatmapSetID { get; set; }
 
         [JsonProperty(@"status")]
-        public BeatmapSetOnlineStatus Status { get; set; }
+        public BeatmapOnlineStatus Status { get; set; }
 
         [JsonProperty("checksum")]
         public string Checksum { get; set; } = string.Empty;
diff --git a/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs b/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs
index 8d50f3d7dd..9005fa8eb7 100644
--- a/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs
@@ -21,7 +21,7 @@ namespace osu.Game.Online.API.Requests.Responses
         public int OnlineID { get; set; }
 
         [JsonProperty(@"status")]
-        public BeatmapSetOnlineStatus Status { get; set; }
+        public BeatmapOnlineStatus Status { get; set; }
 
         [JsonProperty(@"preview_url")]
         public string Preview { get; set; } = string.Empty;
diff --git a/osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.cs b/osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.cs
index 15e700fc91..2fcdc9402d 100644
--- a/osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.cs
+++ b/osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.cs
@@ -244,7 +244,7 @@ namespace osu.Game.Overlays.BeatmapSet.Scores
 
             noScoresPlaceholder.Hide();
 
-            if (Beatmap.Value == null || Beatmap.Value.OnlineID <= 0 || (Beatmap.Value?.BeatmapSet as IBeatmapSetOnlineInfo)?.Status <= BeatmapSetOnlineStatus.Pending)
+            if (Beatmap.Value == null || Beatmap.Value.OnlineID <= 0 || (Beatmap.Value?.BeatmapSet as IBeatmapSetOnlineInfo)?.Status <= BeatmapOnlineStatus.Pending)
             {
                 Scores = null;
                 Hide();
diff --git a/osu.Game/Screens/Ranking/SoloResultsScreen.cs b/osu.Game/Screens/Ranking/SoloResultsScreen.cs
index 425e6f983b..929bda6508 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)
         {
-            if (Score.BeatmapInfo.OnlineID == null || Score.BeatmapInfo.Status <= BeatmapSetOnlineStatus.Pending)
+            if (Score.BeatmapInfo.OnlineID == null || Score.BeatmapInfo.Status <= BeatmapOnlineStatus.Pending)
                 return null;
 
             getScoreRequest = new GetScoresRequest(Score.BeatmapInfo, Score.Ruleset);
diff --git a/osu.Game/Screens/Select/FilterCriteria.cs b/osu.Game/Screens/Select/FilterCriteria.cs
index f47bc5f466..1f6e99f0c6 100644
--- a/osu.Game/Screens/Select/FilterCriteria.cs
+++ b/osu.Game/Screens/Select/FilterCriteria.cs
@@ -28,7 +28,7 @@ namespace osu.Game.Screens.Select
         public OptionalRange<double> Length;
         public OptionalRange<double> BPM;
         public OptionalRange<int> BeatDivisor;
-        public OptionalRange<BeatmapSetOnlineStatus> OnlineStatus;
+        public OptionalRange<BeatmapOnlineStatus> OnlineStatus;
         public OptionalTextFilter Creator;
         public OptionalTextFilter Artist;
 
diff --git a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
index 03da930c5c..1fd6d8c921 100644
--- a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
+++ b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
@@ -154,7 +154,7 @@ namespace osu.Game.Screens.Select.Leaderboards
                 return null;
             }
 
-            if (BeatmapInfo.OnlineID == null || BeatmapInfo?.Status <= BeatmapSetOnlineStatus.Pending)
+            if (BeatmapInfo.OnlineID == null || BeatmapInfo?.Status <= BeatmapOnlineStatus.Pending)
             {
                 PlaceholderState = PlaceholderState.Unavailable;
                 return null;
diff --git a/osu.Game/Tests/Visual/OsuTestScene.cs b/osu.Game/Tests/Visual/OsuTestScene.cs
index d774514dda..7bc63a8c26 100644
--- a/osu.Game/Tests/Visual/OsuTestScene.cs
+++ b/osu.Game/Tests/Visual/OsuTestScene.cs
@@ -226,7 +226,7 @@ namespace osu.Game.Tests.Visual
             return new APIBeatmapSet
             {
                 OnlineID = ((IBeatmapSetInfo)beatmap.BeatmapSet).OnlineID,
-                Status = BeatmapSetOnlineStatus.Ranked,
+                Status = BeatmapOnlineStatus.Ranked,
                 Covers = new BeatmapSetOnlineCovers
                 {
                     Cover = "https://assets.ppy.sh/beatmaps/163112/covers/cover.jpg",

From 052ed8f930f1f289b11369aeb95980798a57a1a5 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 24 Nov 2021 18:45:34 +0900
Subject: [PATCH 1247/5547] Add online status to `RealmBeatmapSet`

---
 osu.Game/Database/RealmContextFactory.cs | 3 ++-
 osu.Game/Models/RealmBeatmapSet.cs       | 9 +++++++++
 2 files changed, 11 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Database/RealmContextFactory.cs b/osu.Game/Database/RealmContextFactory.cs
index d0ca2f0fd4..738ecaea7c 100644
--- a/osu.Game/Database/RealmContextFactory.cs
+++ b/osu.Game/Database/RealmContextFactory.cs
@@ -42,8 +42,9 @@ namespace osu.Game.Database
         /// 9    2021-11-04    Converted BeatmapMetadata.Author from string to RealmUser.
         /// 10   2021-11-22    Use ShortName instead of RulesetID for ruleset settings.
         /// 11   2021-11-22    Use ShortName instead of RulesetID for ruleset key bindings.
+        /// 12   2021-11-24    Add Status to RealmBeatmapSet.
         /// </summary>
-        private const int schema_version = 11;
+        private const int schema_version = 12;
 
         /// <summary>
         /// Lock object which is held during <see cref="BlockAllOperations"/> sections, blocking context creation during blocking periods.
diff --git a/osu.Game/Models/RealmBeatmapSet.cs b/osu.Game/Models/RealmBeatmapSet.cs
index ff39bcf13e..fbc63389af 100644
--- a/osu.Game/Models/RealmBeatmapSet.cs
+++ b/osu.Game/Models/RealmBeatmapSet.cs
@@ -32,6 +32,15 @@ namespace osu.Game.Models
 
         public IList<RealmNamedFileUsage> Files { get; } = null!;
 
+        public BeatmapOnlineStatus Status
+        {
+            get => (BeatmapOnlineStatus)StatusInt;
+            set => StatusInt = (int)value;
+        }
+
+        [MapTo(nameof(Status))]
+        public int StatusInt { get; set; }
+
         public bool DeletePending { get; set; }
 
         public string Hash { get; set; } = string.Empty;

From 61009013ccbb946d0bd0e88e923ca6f00ea8ee62 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 24 Nov 2021 18:48:12 +0900
Subject: [PATCH 1248/5547] Give a more correct default value to beatmap and
 set statuses

---
 osu.Game/Models/RealmBeatmap.cs    | 2 +-
 osu.Game/Models/RealmBeatmapSet.cs | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Models/RealmBeatmap.cs b/osu.Game/Models/RealmBeatmap.cs
index 005a7ac2a8..8e132687f7 100644
--- a/osu.Game/Models/RealmBeatmap.cs
+++ b/osu.Game/Models/RealmBeatmap.cs
@@ -46,7 +46,7 @@ namespace osu.Game.Models
         }
 
         [MapTo(nameof(Status))]
-        public int StatusInt { get; set; }
+        public int StatusInt { get; set; } = (int)BeatmapOnlineStatus.None;
 
         [Indexed]
         public int OnlineID { get; set; } = -1;
diff --git a/osu.Game/Models/RealmBeatmapSet.cs b/osu.Game/Models/RealmBeatmapSet.cs
index fbc63389af..fee59633f1 100644
--- a/osu.Game/Models/RealmBeatmapSet.cs
+++ b/osu.Game/Models/RealmBeatmapSet.cs
@@ -39,7 +39,7 @@ namespace osu.Game.Models
         }
 
         [MapTo(nameof(Status))]
-        public int StatusInt { get; set; }
+        public int StatusInt { get; set; } = (int)BeatmapOnlineStatus.None;
 
         public bool DeletePending { get; set; }
 

From 1dc1de3d1f99d7dde97e5fd69419d01bab94b78c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 24 Nov 2021 19:05:52 +0900
Subject: [PATCH 1249/5547] Close a failed update notification immediately

Fixes visual issue pointed out at
https://github.com/ppy/osu/discussions/15653#discussioncomment-1679263.
---
 osu.Desktop/Updater/SquirrelUpdateManager.cs | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/osu.Desktop/Updater/SquirrelUpdateManager.cs b/osu.Desktop/Updater/SquirrelUpdateManager.cs
index d48c9e9661..7b60bc03e4 100644
--- a/osu.Desktop/Updater/SquirrelUpdateManager.cs
+++ b/osu.Desktop/Updater/SquirrelUpdateManager.cs
@@ -103,7 +103,10 @@ namespace osu.Desktop.Updater
                     }
                     else
                     {
+                        // In the case of an error, a separate notification will be displayed.
                         notification.State = ProgressNotificationState.Cancelled;
+                        notification.Close();
+
                         Logger.Error(e, @"update failed!");
                     }
                 }

From 132bb592030667a967425447714aa2f074d7666e Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 24 Nov 2021 19:53:21 +0900
Subject: [PATCH 1250/5547] Update working beatmap when returning to match

---
 .../Visual/Multiplayer/TestSceneAllPlayersQueueMode.cs     | 7 +++++++
 osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs         | 1 +
 2 files changed, 8 insertions(+)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneAllPlayersQueueMode.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneAllPlayersQueueMode.cs
index dcb01b83cc..aaf0a49c96 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneAllPlayersQueueMode.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneAllPlayersQueueMode.cs
@@ -78,6 +78,13 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddAssert("playlist item is not expired", () => Client.APIRoom?.Playlist[1].Expired == false);
         }
 
+        [Test]
+        public void TestCorrectItemSelectedAfterNewItemAdded()
+        {
+            addItem(() => OtherBeatmap);
+            AddAssert("selected beatmap is initial beatmap", () => Beatmap.Value.BeatmapInfo.OnlineID == InitialBeatmap.OnlineID);
+        }
+
         private void addItem(Func<BeatmapInfo> beatmap)
         {
             AddStep("click edit button", () =>
diff --git a/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs b/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
index 323d38c881..7c5ed3f5cc 100644
--- a/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
@@ -302,6 +302,7 @@ namespace osu.Game.Screens.OnlinePlay.Match
         public override void OnResuming(IScreen last)
         {
             base.OnResuming(last);
+            updateWorkingBeatmap();
             beginHandlingTrack();
             Scheduler.AddOnce(UpdateMods);
         }

From 016684b52d65db6e1e94723f134a4d03dc16549a Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 24 Nov 2021 20:29:47 +0900
Subject: [PATCH 1251/5547] Remove unreachable code

---
 osu.Game/Skinning/LegacySkinResourceStore.cs | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/osu.Game/Skinning/LegacySkinResourceStore.cs b/osu.Game/Skinning/LegacySkinResourceStore.cs
index 096b467867..c4418baeff 100644
--- a/osu.Game/Skinning/LegacySkinResourceStore.cs
+++ b/osu.Game/Skinning/LegacySkinResourceStore.cs
@@ -24,9 +24,6 @@ namespace osu.Game.Skinning
 
         protected override IEnumerable<string> GetFilenames(string name)
         {
-            if (source.Files == null)
-                yield break;
-
             foreach (string filename in base.GetFilenames(name))
             {
                 string path = getPathForFile(filename.ToStandardisedPath());

From 1907b42f8252900ff0d3d83fa34f0eb1d5d9f6e3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 24 Nov 2021 20:34:33 +0100
Subject: [PATCH 1252/5547] Use constant online IDs in tests to avoid preview
 not working randomly

---
 .../Visual/Beatmaps/TestSceneBeatmapCard.cs        | 13 ++++++++++---
 .../Beatmaps/TestSceneBeatmapCardThumbnail.cs      | 14 ++++++++++----
 2 files changed, 20 insertions(+), 7 deletions(-)

diff --git a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs
index addec15881..a45ba30ccd 100644
--- a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs
+++ b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs
@@ -23,6 +23,11 @@ namespace osu.Game.Tests.Visual.Beatmaps
 {
     public class TestSceneBeatmapCard : OsuTestScene
     {
+        /// <summary>
+        /// All cards on this scene use a common online ID to ensure that map download, preview tracks, etc. can be tested manually with online sources.
+        /// </summary>
+        private const int online_id = 163112;
+
         private DummyAPIAccess dummyAPI => (DummyAPIAccess)API;
 
         private APIBeatmapSet[] testCases;
@@ -38,7 +43,6 @@ namespace osu.Game.Tests.Visual.Beatmaps
             var normal = CreateAPIBeatmapSet(Ruleset.Value);
             normal.HasVideo = true;
             normal.HasStoryboard = true;
-            normal.OnlineID = 241526;
 
             var withStatistics = CreateAPIBeatmapSet(Ruleset.Value);
             withStatistics.Title = withStatistics.TitleUnicode = "play favourite stats";
@@ -106,6 +110,9 @@ namespace osu.Game.Tests.Visual.Beatmaps
                 explicitFeaturedMap,
                 longName
             };
+
+            foreach (var testCase in testCases)
+                testCase.OnlineID = online_id;
         }
 
         private APIBeatmapSet getUndownloadableBeatmapSet() => new APIBeatmapSet
@@ -191,9 +198,9 @@ namespace osu.Game.Tests.Visual.Beatmaps
         private void ensureSoleilyRemoved()
         {
             AddUntilStep("ensure manager loaded", () => beatmaps != null);
-            AddStep("remove soleily", () =>
+            AddStep("remove map", () =>
             {
-                var beatmap = beatmaps.QueryBeatmapSet(b => b.OnlineID == 241526);
+                var beatmap = beatmaps.QueryBeatmapSet(b => b.OnlineID == online_id);
 
                 if (beatmap != null) beatmaps.Delete(beatmap);
             });
diff --git a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCardThumbnail.cs b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCardThumbnail.cs
index 59df0dc7ca..1b4542d946 100644
--- a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCardThumbnail.cs
+++ b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCardThumbnail.cs
@@ -27,11 +27,17 @@ namespace osu.Game.Tests.Visual.Beatmaps
         {
             BeatmapCardThumbnail thumbnail = null;
 
-            AddStep("create thumbnail", () => Child = thumbnail = new BeatmapCardThumbnail(CreateAPIBeatmapSet(Ruleset.Value))
+            AddStep("create thumbnail", () =>
             {
-                Anchor = Anchor.Centre,
-                Origin = Anchor.Centre,
-                Size = new Vector2(200)
+                var beatmapSet = CreateAPIBeatmapSet(Ruleset.Value);
+                beatmapSet.OnlineID = 241526; // ID hardcoded to ensure that the preview track exists online.
+
+                Child = thumbnail = new BeatmapCardThumbnail(beatmapSet)
+                {
+                    Anchor = Anchor.Centre,
+                    Origin = Anchor.Centre,
+                    Size = new Vector2(200)
+                };
             });
             AddStep("enable dim", () => thumbnail.Dimmed.Value = true);
             AddUntilStep("button visible", () => playButton.IsPresent);

From 306e13fa7b11ab242300d3a4a4c314dd014d098a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 25 Nov 2021 14:06:02 +0900
Subject: [PATCH 1253/5547] Remove all usages of `FileStore.QueryFiles`

---
 osu.Game.Tests/Beatmaps/IO/ImportBeatmapTest.cs |  2 +-
 osu.Game/IO/FileStore.cs                        | 10 ----------
 2 files changed, 1 insertion(+), 11 deletions(-)

diff --git a/osu.Game.Tests/Beatmaps/IO/ImportBeatmapTest.cs b/osu.Game.Tests/Beatmaps/IO/ImportBeatmapTest.cs
index cac1bf05a6..6e2b9d20a8 100644
--- a/osu.Game.Tests/Beatmaps/IO/ImportBeatmapTest.cs
+++ b/osu.Game.Tests/Beatmaps/IO/ImportBeatmapTest.cs
@@ -1050,7 +1050,7 @@ namespace osu.Game.Tests.Beatmaps.IO
 
         private static void checkSingleReferencedFileCount(OsuGameBase osu, int expected)
         {
-            Assert.AreEqual(expected, osu.Dependencies.Get<FileStore>().QueryFiles(f => f.ReferenceCount == 1).Count());
+            Assert.AreEqual(expected, osu.Dependencies.Get<DatabaseContextFactory>().Get().FileInfo.Count(f => f.ReferenceCount == 1));
         }
 
         private static void ensureLoaded(OsuGameBase osu, int timeout = 60000)
diff --git a/osu.Game/IO/FileStore.cs b/osu.Game/IO/FileStore.cs
index 165cf756aa..ebe1ebfe69 100644
--- a/osu.Game/IO/FileStore.cs
+++ b/osu.Game/IO/FileStore.cs
@@ -2,11 +2,8 @@
 // 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 System.Linq.Expressions;
-using Microsoft.EntityFrameworkCore;
 using osu.Framework.Extensions;
 using osu.Framework.IO.Stores;
 using osu.Framework.Logging;
@@ -31,13 +28,6 @@ namespace osu.Game.IO
             Store = new StorageBackedResourceStore(Storage);
         }
 
-        /// <summary>
-        /// Perform a lookup query on available <see cref="FileInfo"/>s.
-        /// </summary>
-        /// <param name="query">The query.</param>
-        /// <returns>Results from the provided query.</returns>
-        public IEnumerable<FileInfo> QueryFiles(Expression<Func<FileInfo, bool>> query) => ContextFactory.Get().Set<FileInfo>().AsNoTracking().Where(f => f.ReferenceCount > 0).Where(query);
-
         public FileInfo Add(Stream data, bool reference = true)
         {
             using (var usage = ContextFactory.GetForWrite())

From fd321109da8f9f621c7ae5b0e3dfb974154a1fc6 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 25 Nov 2021 14:06:12 +0900
Subject: [PATCH 1254/5547] Remove unnecessary `virtual` specification on
 `Refresh`

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

diff --git a/osu.Game/Database/DatabaseBackedStore.cs b/osu.Game/Database/DatabaseBackedStore.cs
index a11efba54b..03e1c014b2 100644
--- a/osu.Game/Database/DatabaseBackedStore.cs
+++ b/osu.Game/Database/DatabaseBackedStore.cs
@@ -19,7 +19,7 @@ namespace osu.Game.Database
         /// <param name="obj">The object to use as a reference when negotiating a local instance.</param>
         /// <param name="lookupSource">An optional lookup source which will be used to query and populate a freshly retrieved replacement. If not provided, the refreshed object will still be returned but will not have any includes.</param>
         /// <typeparam name="T">A valid EF-stored type.</typeparam>
-        protected virtual void Refresh<T>(ref T obj, IQueryable<T> lookupSource = null) where T : class, IHasPrimaryKey
+        protected void Refresh<T>(ref T obj, IQueryable<T> lookupSource = null) where T : class, IHasPrimaryKey
         {
             using (var usage = ContextFactory.GetForWrite())
             {

From 3e4b774992b7aa811d60bc75e5b7979ba4889f07 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 25 Nov 2021 14:08:08 +0900
Subject: [PATCH 1255/5547] Invert lines for better chronological order

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

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
index 4ddcbb7770..d2a1083f29 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
@@ -49,8 +49,8 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
             // But if the last object is a slider, then we extend the travel velocity through the slider into the current object.
             if (osuLastObj.BaseObject is Slider && withSliders)
             {
-                double movementVelocity = osuCurrObj.MovementDistance / osuCurrObj.MovementTime; // calculate the movement velocity from slider end to current object
                 double travelVelocity = osuLastObj.TravelDistance / osuLastObj.TravelTime; // calculate the slider velocity from slider head to slider end.
+                double movementVelocity = osuCurrObj.MovementDistance / osuCurrObj.MovementTime; // calculate the movement velocity from slider end to current object
 
                 currVelocity = Math.Max(currVelocity, movementVelocity + travelVelocity); // take the larger total combined velocity.
             }
@@ -60,8 +60,8 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
 
             if (osuLastLastObj.BaseObject is Slider && withSliders)
             {
-                double movementVelocity = osuLastObj.MovementDistance / osuLastObj.MovementTime;
                 double travelVelocity = osuLastLastObj.TravelDistance / osuLastLastObj.TravelTime;
+                double movementVelocity = osuLastObj.MovementDistance / osuLastObj.MovementTime;
 
                 prevVelocity = Math.Max(prevVelocity, movementVelocity + travelVelocity);
             }

From 204bd2b604a30f13c899d14a804f1a1582b1463e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 25 Nov 2021 14:17:42 +0900
Subject: [PATCH 1256/5547] Ensure `Cleanup` can run from non-update thread and
 add basic log output

---
 osu.Game/Stores/RealmFileStore.cs | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Stores/RealmFileStore.cs b/osu.Game/Stores/RealmFileStore.cs
index aebf330443..f9abbda4c0 100644
--- a/osu.Game/Stores/RealmFileStore.cs
+++ b/osu.Game/Stores/RealmFileStore.cs
@@ -86,9 +86,13 @@ namespace osu.Game.Stores
 
         public void Cleanup()
         {
-            var realm = realmFactory.Context;
+            Logger.Log(@"Beginning realm file store cleanup");
+
+            int totalFiles = 0;
+            int removedFiles = 0;
 
             // can potentially be run asynchronously, although we will need to consider operation order for disk deletion vs realm removal.
+            using (var realm = realmFactory.CreateContext())
             using (var transaction = realm.BeginWrite())
             {
                 // TODO: consider using a realm native query to avoid iterating all files (https://github.com/realm/realm-dotnet/issues/2659#issuecomment-927823707)
@@ -96,11 +100,14 @@ namespace osu.Game.Stores
 
                 foreach (var file in files)
                 {
+                    totalFiles++;
+
                     if (file.BacklinksCount > 0)
                         continue;
 
                     try
                     {
+                        removedFiles++;
                         Storage.Delete(file.GetStoragePath());
                         realm.Remove(file);
                     }
@@ -112,6 +119,8 @@ namespace osu.Game.Stores
 
                 transaction.Commit();
             }
+
+            Logger.Log($@"Finished realm file store cleanup ({removedFiles} of {totalFiles} deleted)");
         }
     }
 }

From 315e126497db5d6c343b57662d5e66ea4fefa834 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 25 Nov 2021 14:12:49 +0900
Subject: [PATCH 1257/5547] Add automatic clean-up call for `RealmFileStore`

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

diff --git a/osu.Game/Database/RealmContextFactory.cs b/osu.Game/Database/RealmContextFactory.cs
index 738ecaea7c..0cffb2b0ae 100644
--- a/osu.Game/Database/RealmContextFactory.cs
+++ b/osu.Game/Database/RealmContextFactory.cs
@@ -14,6 +14,7 @@ using osu.Framework.Statistics;
 using osu.Game.Configuration;
 using osu.Game.Input.Bindings;
 using osu.Game.Models;
+using osu.Game.Stores;
 using Realms;
 
 #nullable enable
@@ -106,6 +107,8 @@ namespace osu.Game.Database
 
         private void cleanupPendingDeletions()
         {
+            new RealmFileStore(this, storage).Cleanup();
+
             using (var realm = CreateContext())
             using (var transaction = realm.BeginWrite())
             {

From bcdb73e1e847cc2a2d099f4c24600fbae3b5d228 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 25 Nov 2021 14:28:27 +0900
Subject: [PATCH 1258/5547] Clean up files last

---
 osu.Game/Database/RealmContextFactory.cs | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Database/RealmContextFactory.cs b/osu.Game/Database/RealmContextFactory.cs
index 0cffb2b0ae..3c5dfeafe8 100644
--- a/osu.Game/Database/RealmContextFactory.cs
+++ b/osu.Game/Database/RealmContextFactory.cs
@@ -107,8 +107,6 @@ namespace osu.Game.Database
 
         private void cleanupPendingDeletions()
         {
-            new RealmFileStore(this, storage).Cleanup();
-
             using (var realm = CreateContext())
             using (var transaction = realm.BeginWrite())
             {
@@ -124,6 +122,10 @@ namespace osu.Game.Database
 
                 transaction.Commit();
             }
+
+            // clean up files after dropping any pending deletions.
+            // in the future we may want to only do this when the game is idle, rather than on every startup.
+            new RealmFileStore(this, storage).Cleanup();
         }
 
         /// <summary>

From 60b207f20aa34f31aefd723716a347d6248aa574 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 25 Nov 2021 14:34:13 +0900
Subject: [PATCH 1259/5547] Reduce interface exposure of `ScoreManager`

---
 osu.Game/Scoring/ScoreManager.cs | 21 +--------------------
 1 file changed, 1 insertion(+), 20 deletions(-)

diff --git a/osu.Game/Scoring/ScoreManager.cs b/osu.Game/Scoring/ScoreManager.cs
index 29144e7bdc..abc0bfdda7 100644
--- a/osu.Game/Scoring/ScoreManager.cs
+++ b/osu.Game/Scoring/ScoreManager.cs
@@ -25,7 +25,7 @@ using osu.Game.Rulesets.Scoring;
 
 namespace osu.Game.Scoring
 {
-    public class ScoreManager : IModelManager<ScoreInfo>, IModelImporter<ScoreInfo>, IModelFileManager<ScoreInfo, ScoreFileInfo>, IModelDownloader<IScoreInfo>
+    public class ScoreManager : IModelManager<ScoreInfo>, IModelImporter<ScoreInfo>, IModelDownloader<IScoreInfo>
     {
         private readonly Scheduler scheduler;
         private readonly Func<BeatmapDifficultyCache> difficulties;
@@ -342,25 +342,6 @@ namespace osu.Game.Scoring
 
         #endregion
 
-        #region Implementation of IModelFileManager<in ScoreInfo,in ScoreFileInfo>
-
-        public void ReplaceFile(ScoreInfo model, ScoreFileInfo file, Stream contents, string filename = null)
-        {
-            scoreModelManager.ReplaceFile(model, file, contents, filename);
-        }
-
-        public void DeleteFile(ScoreInfo model, ScoreFileInfo file)
-        {
-            scoreModelManager.DeleteFile(model, file);
-        }
-
-        public void AddFile(ScoreInfo model, Stream contents, string filename)
-        {
-            scoreModelManager.AddFile(model, contents, filename);
-        }
-
-        #endregion
-
         #region Implementation of IModelDownloader<IScoreInfo>
 
         public event Action<ArchiveDownloadRequest<IScoreInfo>> DownloadBegan

From 2bfc47368952dce7ef01f914dc06551be784a445 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 25 Nov 2021 15:14:43 +0900
Subject: [PATCH 1260/5547] Split out `SkinModelManager` from `SkinManager`

---
 osu.Game/Skinning/SkinManager.cs      | 295 +++++++++++---------------
 osu.Game/Skinning/SkinModelManager.cs | 191 +++++++++++++++++
 2 files changed, 317 insertions(+), 169 deletions(-)
 create mode 100644 osu.Game/Skinning/SkinModelManager.cs

diff --git a/osu.Game/Skinning/SkinManager.cs b/osu.Game/Skinning/SkinManager.cs
index 6e0a8e0a11..a840e17ed1 100644
--- a/osu.Game/Skinning/SkinManager.cs
+++ b/osu.Game/Skinning/SkinManager.cs
@@ -18,15 +18,14 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.OpenGL.Textures;
 using osu.Framework.Graphics.Textures;
 using osu.Framework.IO.Stores;
-using osu.Framework.Logging;
 using osu.Framework.Platform;
 using osu.Framework.Testing;
 using osu.Framework.Utils;
 using osu.Game.Audio;
 using osu.Game.Database;
-using osu.Game.Extensions;
 using osu.Game.IO;
 using osu.Game.IO.Archives;
+using osu.Game.Overlays.Notifications;
 
 namespace osu.Game.Skinning
 {
@@ -38,7 +37,7 @@ namespace osu.Game.Skinning
     /// For gameplay components, see <see cref="RulesetSkinProvidingContainer"/> which adds extra legacy and toggle logic that may affect the lookup process.
     /// </remarks>
     [ExcludeFromDynamicCompile]
-    public class SkinManager : ArchiveModelManager<SkinInfo, SkinFileInfo>, ISkinSource, IStorageResourceProvider
+    public class SkinManager : ISkinSource, IStorageResourceProvider, IModelImporter<SkinInfo>, IModelManager<SkinInfo>
     {
         private readonly AudioManager audio;
 
@@ -49,11 +48,11 @@ namespace osu.Game.Skinning
         public readonly Bindable<Skin> CurrentSkin = new Bindable<Skin>();
         public readonly Bindable<SkinInfo> CurrentSkinInfo = new Bindable<SkinInfo>(SkinInfo.Default) { Default = SkinInfo.Default };
 
-        public override IEnumerable<string> HandledExtensions => new[] { ".osk" };
+        private readonly SkinModelManager skinModelManager;
 
-        protected override string[] HashableFileTypes => new[] { ".ini", ".json" };
+        private readonly SkinStore skinStore;
 
-        protected override string ImportFromStablePath => "Skins";
+        private readonly IResourceStore<byte[]> userFiles;
 
         /// <summary>
         /// The default skin.
@@ -66,12 +65,16 @@ namespace osu.Game.Skinning
         public Skin DefaultLegacySkin { get; }
 
         public SkinManager(Storage storage, DatabaseContextFactory contextFactory, GameHost host, IResourceStore<byte[]> resources, AudioManager audio)
-            : base(storage, contextFactory, new SkinStore(contextFactory, storage), host)
         {
             this.audio = audio;
             this.host = host;
             this.resources = resources;
 
+            skinStore = new SkinStore(contextFactory, storage);
+            userFiles = new FileStore(contextFactory, storage).Store;
+
+            skinModelManager = new SkinModelManager(storage, contextFactory, skinStore, host, this);
+
             DefaultLegacySkin = new DefaultLegacySkin(this);
             DefaultSkin = new DefaultSkin(this);
 
@@ -85,31 +88,8 @@ namespace osu.Game.Skinning
 
                 SourceChanged?.Invoke();
             };
-
-            // can be removed 20220420.
-            populateMissingHashes();
         }
 
-        private void populateMissingHashes()
-        {
-            var skinsWithoutHashes = ModelStore.ConsumableItems.Where(i => i.Hash == null).ToArray();
-
-            foreach (SkinInfo skin in skinsWithoutHashes)
-            {
-                try
-                {
-                    Update(skin);
-                }
-                catch (Exception e)
-                {
-                    Delete(skin);
-                    Logger.Error(e, $"Existing skin {skin} has been deleted during hash recomputation due to being invalid");
-                }
-            }
-        }
-
-        protected override bool ShouldDeleteArchive(string path) => Path.GetExtension(path)?.ToLowerInvariant() == @".osk";
-
         /// <summary>
         /// Returns a list of all usable <see cref="SkinInfo"/>s. Includes the special default skin plus all skins from <see cref="GetAllUserSkins"/>.
         /// </summary>
@@ -129,15 +109,15 @@ namespace osu.Game.Skinning
         public List<SkinInfo> GetAllUserSkins(bool includeFiles = false)
         {
             if (includeFiles)
-                return ModelStore.ConsumableItems.Where(s => !s.DeletePending).ToList();
+                return skinStore.ConsumableItems.Where(s => !s.DeletePending).ToList();
 
-            return ModelStore.Items.Where(s => !s.DeletePending).ToList();
+            return skinStore.Items.Where(s => !s.DeletePending).ToList();
         }
 
         public void SelectRandomSkin()
         {
             // choose from only user skins, removing the current selection to ensure a new one is chosen.
-            var randomChoices = ModelStore.Items.Where(s => !s.DeletePending && s.ID != CurrentSkinInfo.Value.ID).ToArray();
+            var randomChoices = skinStore.Items.Where(s => !s.DeletePending && s.ID != CurrentSkinInfo.Value.ID).ToArray();
 
             if (randomChoices.Length == 0)
             {
@@ -146,137 +126,7 @@ namespace osu.Game.Skinning
             }
 
             var chosen = randomChoices.ElementAt(RNG.Next(0, randomChoices.Length));
-            CurrentSkinInfo.Value = ModelStore.ConsumableItems.Single(i => i.ID == chosen.ID);
-        }
-
-        protected override SkinInfo CreateModel(ArchiveReader archive) => new SkinInfo { Name = archive.Name ?? @"No name" };
-
-        private const string unknown_creator_string = @"Unknown";
-
-        protected override bool HasCustomHashFunction => true;
-
-        protected override string ComputeHash(SkinInfo item)
-        {
-            var instance = GetSkin(item);
-
-            // This function can be run on fresh import or save. The logic here ensures a skin.ini file is in a good state for both operations.
-
-            // `Skin` will parse the skin.ini and populate `Skin.Configuration` during construction above.
-            string skinIniSourcedName = instance.Configuration.SkinInfo.Name;
-            string skinIniSourcedCreator = instance.Configuration.SkinInfo.Creator;
-            string archiveName = item.Name.Replace(@".osk", string.Empty, StringComparison.OrdinalIgnoreCase);
-
-            bool isImport = item.ID == 0;
-
-            if (isImport)
-            {
-                item.Name = !string.IsNullOrEmpty(skinIniSourcedName) ? skinIniSourcedName : archiveName;
-                item.Creator = !string.IsNullOrEmpty(skinIniSourcedCreator) ? skinIniSourcedCreator : unknown_creator_string;
-
-                // For imports, we want to use the archive or folder name as part of the metadata, in addition to any existing skin.ini metadata.
-                // In an ideal world, skin.ini would be the only source of metadata, but a lot of skin creators and users don't update it when making modifications.
-                // In both of these cases, the expectation from the user is that the filename or folder name is displayed somewhere to identify the skin.
-                if (archiveName != item.Name)
-                    item.Name = @$"{item.Name} [{archiveName}]";
-            }
-
-            // By this point, the metadata in SkinInfo will be correct.
-            // Regardless of whether this is an import or not, let's write the skin.ini if non-existing or non-matching.
-            // This is (weirdly) done inside ComputeHash to avoid adding a new method to handle this case. After switching to realm it can be moved into another place.
-            if (skinIniSourcedName != item.Name)
-                updateSkinIniMetadata(item);
-
-            return base.ComputeHash(item);
-        }
-
-        private void updateSkinIniMetadata(SkinInfo item)
-        {
-            string nameLine = @$"Name: {item.Name}";
-            string authorLine = @$"Author: {item.Creator}";
-
-            string[] newLines =
-            {
-                @"// The following content was automatically added by osu! during import, based on filename / folder metadata.",
-                @"[General]",
-                nameLine,
-                authorLine,
-            };
-
-            var existingFile = item.Files.SingleOrDefault(f => f.Filename.Equals(@"skin.ini", StringComparison.OrdinalIgnoreCase));
-
-            if (existingFile == null)
-            {
-                // In the case a skin doesn't have a skin.ini yet, let's create one.
-                writeNewSkinIni();
-                return;
-            }
-
-            using (Stream stream = new MemoryStream())
-            {
-                using (var sw = new StreamWriter(stream, Encoding.UTF8, 1024, true))
-                {
-                    using (var existingStream = Files.Storage.GetStream(existingFile.FileInfo.GetStoragePath()))
-                    using (var sr = new StreamReader(existingStream))
-                    {
-                        string line;
-                        while ((line = sr.ReadLine()) != null)
-                            sw.WriteLine(line);
-                    }
-
-                    sw.WriteLine();
-
-                    foreach (string line in newLines)
-                        sw.WriteLine(line);
-                }
-
-                ReplaceFile(item, existingFile, stream);
-
-                // can be removed 20220502.
-                if (!ensureIniWasUpdated(item))
-                {
-                    Logger.Log($"Skin {item}'s skin.ini had issues and has been removed. Please report this and provide the problematic skin.", LoggingTarget.Database, LogLevel.Important);
-
-                    DeleteFile(item, item.Files.SingleOrDefault(f => f.Filename.Equals(@"skin.ini", StringComparison.OrdinalIgnoreCase)));
-                    writeNewSkinIni();
-                }
-            }
-
-            void writeNewSkinIni()
-            {
-                using (Stream stream = new MemoryStream())
-                {
-                    using (var sw = new StreamWriter(stream, Encoding.UTF8, 1024, true))
-                    {
-                        foreach (string line in newLines)
-                            sw.WriteLine(line);
-                    }
-
-                    AddFile(item, stream, @"skin.ini");
-                }
-            }
-        }
-
-        private bool ensureIniWasUpdated(SkinInfo item)
-        {
-            // This is a final consistency check to ensure that hash computation doesn't enter an infinite loop.
-            // With other changes to the surrounding code this should never be hit, but until we are 101% sure that there
-            // are no other cases let's avoid a hard startup crash by bailing and alerting.
-
-            var instance = GetSkin(item);
-
-            return instance.Configuration.SkinInfo.Name == item.Name;
-        }
-
-        protected override Task Populate(SkinInfo model, ArchiveReader archive, CancellationToken cancellationToken = default)
-        {
-            var instance = GetSkin(model);
-
-            model.InstantiationInfo ??= instance.GetType().GetInvariantInstantiationInfo();
-
-            model.Name = instance.Configuration.SkinInfo.Name;
-            model.Creator = instance.Configuration.SkinInfo.Creator;
-
-            return Task.CompletedTask;
+            CurrentSkinInfo.Value = skinStore.ConsumableItems.Single(i => i.ID == chosen.ID);
         }
 
         /// <summary>
@@ -297,7 +147,7 @@ namespace osu.Game.Skinning
             var skin = CurrentSkin.Value;
 
             // if the user is attempting to save one of the default skin implementations, create a copy first.
-            CurrentSkinInfo.Value = Import(new SkinInfo
+            CurrentSkinInfo.Value = skinModelManager.Import(new SkinInfo
             {
                 Name = skin.SkinInfo.Name + @" (modified)",
                 Creator = skin.SkinInfo.Creator,
@@ -321,9 +171,9 @@ namespace osu.Game.Skinning
                     var oldFile = skin.SkinInfo.Files.FirstOrDefault(f => f.Filename == filename);
 
                     if (oldFile != null)
-                        ReplaceFile(skin.SkinInfo, oldFile, streamContent, oldFile.Filename);
+                        skinModelManager.ReplaceFile(skin.SkinInfo, oldFile, streamContent, oldFile.Filename);
                     else
-                        AddFile(skin.SkinInfo, streamContent, filename);
+                        skinModelManager.AddFile(skin.SkinInfo, streamContent, filename);
                 }
             }
         }
@@ -333,7 +183,7 @@ namespace osu.Game.Skinning
         /// </summary>
         /// <param name="query">The query.</param>
         /// <returns>The first result for the provided query, or null if no results were found.</returns>
-        public SkinInfo Query(Expression<Func<SkinInfo, bool>> query) => ModelStore.ConsumableItems.AsNoTracking().FirstOrDefault(query);
+        public SkinInfo Query(Expression<Func<SkinInfo, bool>> query) => skinStore.ConsumableItems.AsNoTracking().FirstOrDefault(query);
 
         public event Action SourceChanged;
 
@@ -386,9 +236,116 @@ namespace osu.Game.Skinning
 
         AudioManager IStorageResourceProvider.AudioManager => audio;
         IResourceStore<byte[]> IStorageResourceProvider.Resources => resources;
-        IResourceStore<byte[]> IStorageResourceProvider.Files => Files.Store;
+        IResourceStore<byte[]> IStorageResourceProvider.Files => userFiles;
         IResourceStore<TextureUpload> IStorageResourceProvider.CreateTextureLoaderStore(IResourceStore<byte[]> underlyingStore) => host.CreateTextureLoaderStore(underlyingStore);
 
         #endregion
+
+        #region Implementation of IModelImporter<SkinInfo>
+
+        public Action<Notification> PostNotification
+        {
+            set => skinModelManager.PostNotification = value;
+        }
+
+        public Action<IEnumerable<ILive<SkinInfo>>> PostImport
+        {
+            set => skinModelManager.PostImport = value;
+        }
+
+        public Task Import(params string[] paths)
+        {
+            return skinModelManager.Import(paths);
+        }
+
+        public Task Import(params ImportTask[] tasks)
+        {
+            return skinModelManager.Import(tasks);
+        }
+
+        public IEnumerable<string> HandledExtensions => skinModelManager.HandledExtensions;
+
+        public Task<IEnumerable<ILive<SkinInfo>>> Import(ProgressNotification notification, params ImportTask[] tasks)
+        {
+            return skinModelManager.Import(notification, tasks);
+        }
+
+        public Task<ILive<SkinInfo>> Import(ImportTask task, bool lowPriority = false, CancellationToken cancellationToken = default)
+        {
+            return skinModelManager.Import(task, lowPriority, cancellationToken);
+        }
+
+        public Task<ILive<SkinInfo>> Import(ArchiveReader archive, bool lowPriority = false, CancellationToken cancellationToken = default)
+        {
+            return skinModelManager.Import(archive, lowPriority, cancellationToken);
+        }
+
+        public Task<ILive<SkinInfo>> Import(SkinInfo item, ArchiveReader archive = null, bool lowPriority = false, CancellationToken cancellationToken = default)
+        {
+            return skinModelManager.Import(item, archive, lowPriority, cancellationToken);
+        }
+
+        #endregion
+
+        #region Implementation of IModelManager<SkinInfo>
+
+        public event Action<SkinInfo> ItemUpdated
+        {
+            add => skinModelManager.ItemUpdated += value;
+            remove => skinModelManager.ItemUpdated -= value;
+        }
+
+        public event Action<SkinInfo> ItemRemoved
+        {
+            add => skinModelManager.ItemRemoved += value;
+            remove => skinModelManager.ItemRemoved -= value;
+        }
+
+        public Task ImportFromStableAsync(StableStorage stableStorage)
+        {
+            return skinModelManager.ImportFromStableAsync(stableStorage);
+        }
+
+        public void Export(SkinInfo item)
+        {
+            skinModelManager.Export(item);
+        }
+
+        public void ExportModelTo(SkinInfo model, Stream outputStream)
+        {
+            skinModelManager.ExportModelTo(model, outputStream);
+        }
+
+        public void Update(SkinInfo item)
+        {
+            skinModelManager.Update(item);
+        }
+
+        public bool Delete(SkinInfo item)
+        {
+            return skinModelManager.Delete(item);
+        }
+
+        public void Delete(List<SkinInfo> items, bool silent = false)
+        {
+            skinModelManager.Delete(items, silent);
+        }
+
+        public void Undelete(List<SkinInfo> items, bool silent = false)
+        {
+            skinModelManager.Undelete(items, silent);
+        }
+
+        public void Undelete(SkinInfo item)
+        {
+            skinModelManager.Undelete(item);
+        }
+
+        public bool IsAvailableLocally(SkinInfo model)
+        {
+            return skinModelManager.IsAvailableLocally(model);
+        }
+
+        #endregion
     }
 }
diff --git a/osu.Game/Skinning/SkinModelManager.cs b/osu.Game/Skinning/SkinModelManager.cs
new file mode 100644
index 0000000000..f28b0c066b
--- /dev/null
+++ b/osu.Game/Skinning/SkinModelManager.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.IO;
+using System.Linq;
+using System.Text;
+using System.Threading;
+using System.Threading.Tasks;
+using osu.Framework.Logging;
+using osu.Framework.Platform;
+using osu.Game.Database;
+using osu.Game.Extensions;
+using osu.Game.IO;
+using osu.Game.IO.Archives;
+
+namespace osu.Game.Skinning
+{
+    public class SkinModelManager : ArchiveModelManager<SkinInfo, SkinFileInfo>
+    {
+        private readonly IStorageResourceProvider skinResources;
+
+        public SkinModelManager(Storage storage, DatabaseContextFactory contextFactory, SkinStore skinStore, GameHost host, IStorageResourceProvider skinResources)
+            : base(storage, contextFactory, skinStore, host)
+        {
+            this.skinResources = skinResources;
+
+            // can be removed 20220420.
+            populateMissingHashes();
+        }
+
+        public override IEnumerable<string> HandledExtensions => new[] { ".osk" };
+
+        protected override string[] HashableFileTypes => new[] { ".ini", ".json" };
+
+        protected override string ImportFromStablePath => "Skins";
+
+        protected override bool ShouldDeleteArchive(string path) => Path.GetExtension(path)?.ToLowerInvariant() == @".osk";
+
+        protected override SkinInfo CreateModel(ArchiveReader archive) => new SkinInfo { Name = archive.Name ?? @"No name" };
+
+        private const string unknown_creator_string = @"Unknown";
+
+        protected override bool HasCustomHashFunction => true;
+
+        protected override string ComputeHash(SkinInfo item)
+        {
+            var instance = createInstance(item);
+
+            // This function can be run on fresh import or save. The logic here ensures a skin.ini file is in a good state for both operations.
+
+            // `Skin` will parse the skin.ini and populate `Skin.Configuration` during construction above.
+            string skinIniSourcedName = instance.Configuration.SkinInfo.Name;
+            string skinIniSourcedCreator = instance.Configuration.SkinInfo.Creator;
+            string archiveName = item.Name.Replace(@".osk", string.Empty, StringComparison.OrdinalIgnoreCase);
+
+            bool isImport = item.ID == 0;
+
+            if (isImport)
+            {
+                item.Name = !string.IsNullOrEmpty(skinIniSourcedName) ? skinIniSourcedName : archiveName;
+                item.Creator = !string.IsNullOrEmpty(skinIniSourcedCreator) ? skinIniSourcedCreator : unknown_creator_string;
+
+                // For imports, we want to use the archive or folder name as part of the metadata, in addition to any existing skin.ini metadata.
+                // In an ideal world, skin.ini would be the only source of metadata, but a lot of skin creators and users don't update it when making modifications.
+                // In both of these cases, the expectation from the user is that the filename or folder name is displayed somewhere to identify the skin.
+                if (archiveName != item.Name)
+                    item.Name = @$"{item.Name} [{archiveName}]";
+            }
+
+            // By this point, the metadata in SkinInfo will be correct.
+            // Regardless of whether this is an import or not, let's write the skin.ini if non-existing or non-matching.
+            // This is (weirdly) done inside ComputeHash to avoid adding a new method to handle this case. After switching to realm it can be moved into another place.
+            if (skinIniSourcedName != item.Name)
+                updateSkinIniMetadata(item);
+
+            return base.ComputeHash(item);
+        }
+
+        private void updateSkinIniMetadata(SkinInfo item)
+        {
+            string nameLine = @$"Name: {item.Name}";
+            string authorLine = @$"Author: {item.Creator}";
+
+            string[] newLines =
+            {
+                @"// The following content was automatically added by osu! during import, based on filename / folder metadata.",
+                @"[General]",
+                nameLine,
+                authorLine,
+            };
+
+            var existingFile = item.Files.SingleOrDefault(f => f.Filename.Equals(@"skin.ini", StringComparison.OrdinalIgnoreCase));
+
+            if (existingFile == null)
+            {
+                // In the case a skin doesn't have a skin.ini yet, let's create one.
+                writeNewSkinIni();
+                return;
+            }
+
+            using (Stream stream = new MemoryStream())
+            {
+                using (var sw = new StreamWriter(stream, Encoding.UTF8, 1024, true))
+                {
+                    using (var existingStream = Files.Storage.GetStream(existingFile.FileInfo.GetStoragePath()))
+                    using (var sr = new StreamReader(existingStream))
+                    {
+                        string line;
+                        while ((line = sr.ReadLine()) != null)
+                            sw.WriteLine(line);
+                    }
+
+                    sw.WriteLine();
+
+                    foreach (string line in newLines)
+                        sw.WriteLine(line);
+                }
+
+                ReplaceFile(item, existingFile, stream);
+
+                // can be removed 20220502.
+                if (!ensureIniWasUpdated(item))
+                {
+                    Logger.Log($"Skin {item}'s skin.ini had issues and has been removed. Please report this and provide the problematic skin.", LoggingTarget.Database, LogLevel.Important);
+
+                    DeleteFile(item, item.Files.SingleOrDefault(f => f.Filename.Equals(@"skin.ini", StringComparison.OrdinalIgnoreCase)));
+                    writeNewSkinIni();
+                }
+            }
+
+            void writeNewSkinIni()
+            {
+                using (Stream stream = new MemoryStream())
+                {
+                    using (var sw = new StreamWriter(stream, Encoding.UTF8, 1024, true))
+                    {
+                        foreach (string line in newLines)
+                            sw.WriteLine(line);
+                    }
+
+                    AddFile(item, stream, @"skin.ini");
+                }
+            }
+        }
+
+        private bool ensureIniWasUpdated(SkinInfo item)
+        {
+            // This is a final consistency check to ensure that hash computation doesn't enter an infinite loop.
+            // With other changes to the surrounding code this should never be hit, but until we are 101% sure that there
+            // are no other cases let's avoid a hard startup crash by bailing and alerting.
+
+            var instance = createInstance(item);
+
+            return instance.Configuration.SkinInfo.Name == item.Name;
+        }
+
+        protected override Task Populate(SkinInfo model, ArchiveReader archive, CancellationToken cancellationToken = default)
+        {
+            var instance = createInstance(model);
+
+            model.InstantiationInfo ??= instance.GetType().GetInvariantInstantiationInfo();
+
+            model.Name = instance.Configuration.SkinInfo.Name;
+            model.Creator = instance.Configuration.SkinInfo.Creator;
+
+            return Task.CompletedTask;
+        }
+
+        private void populateMissingHashes()
+        {
+            var skinsWithoutHashes = ModelStore.ConsumableItems.Where(i => i.Hash == null).ToArray();
+
+            foreach (SkinInfo skin in skinsWithoutHashes)
+            {
+                try
+                {
+                    Update(skin);
+                }
+                catch (Exception e)
+                {
+                    Delete(skin);
+                    Logger.Error(e, $"Existing skin {skin} has been deleted during hash recomputation due to being invalid");
+                }
+            }
+        }
+
+        private Skin createInstance(SkinInfo item) => item.CreateInstance(skinResources);
+    }
+}

From 6cab7b877dc40883e860ad4e7f10c7e8c5fa68e3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 25 Nov 2021 15:36:12 +0900
Subject: [PATCH 1261/5547] Move stable import handling into its own class

---
 osu.Game/Beatmaps/BeatmapManager.cs        |  5 --
 osu.Game/Beatmaps/BeatmapModelManager.cs   |  4 --
 osu.Game/Database/ArchiveModelManager.cs   | 34 ------------
 osu.Game/Database/IModelManager.cs         |  7 ---
 osu.Game/Database/StableBeatmapImporter.cs | 18 +++++++
 osu.Game/Database/StableImportManager.cs   | 10 ++--
 osu.Game/Database/StableImporter.cs        | 60 ++++++++++++++++++++++
 osu.Game/Database/StableScoreImporter.cs   | 23 +++++++++
 osu.Game/Database/StableSkinImporter.cs    | 14 +++++
 osu.Game/Scoring/ScoreManager.cs           |  6 ---
 osu.Game/Scoring/ScoreModelManager.cs      |  6 ---
 osu.Game/Skinning/SkinManager.cs           |  5 --
 osu.Game/Skinning/SkinModelManager.cs      |  2 -
 13 files changed, 122 insertions(+), 72 deletions(-)
 create mode 100644 osu.Game/Database/StableBeatmapImporter.cs
 create mode 100644 osu.Game/Database/StableImporter.cs
 create mode 100644 osu.Game/Database/StableScoreImporter.cs
 create mode 100644 osu.Game/Database/StableSkinImporter.cs

diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index 0594cd1316..2cca3ceaeb 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -225,11 +225,6 @@ namespace osu.Game.Beatmaps
             remove => beatmapModelManager.ItemRemoved -= value;
         }
 
-        public Task ImportFromStableAsync(StableStorage stableStorage)
-        {
-            return beatmapModelManager.ImportFromStableAsync(stableStorage);
-        }
-
         public void Export(BeatmapSetInfo item)
         {
             beatmapModelManager.Export(item);
diff --git a/osu.Game/Beatmaps/BeatmapModelManager.cs b/osu.Game/Beatmaps/BeatmapModelManager.cs
index ae395c6da6..63cdd0b852 100644
--- a/osu.Game/Beatmaps/BeatmapModelManager.cs
+++ b/osu.Game/Beatmaps/BeatmapModelManager.cs
@@ -58,10 +58,6 @@ namespace osu.Game.Beatmaps
 
         protected override string[] HashableFileTypes => new[] { ".osu" };
 
-        protected override string ImportFromStablePath => ".";
-
-        protected override Storage PrepareStableStorage(StableStorage stableStorage) => stableStorage.GetSongStorage();
-
         private readonly BeatmapStore beatmaps;
         private readonly RulesetStore rulesets;
 
diff --git a/osu.Game/Database/ArchiveModelManager.cs b/osu.Game/Database/ArchiveModelManager.cs
index adbb71c8da..e5919cb5c4 100644
--- a/osu.Game/Database/ArchiveModelManager.cs
+++ b/osu.Game/Database/ArchiveModelManager.cs
@@ -728,17 +728,6 @@ namespace osu.Game.Database
 
         #region osu-stable import
 
-        /// <summary>
-        /// The relative path from osu-stable's data directory to import items from.
-        /// </summary>
-        protected virtual string ImportFromStablePath => null;
-
-        /// <summary>
-        /// Select paths to import from stable where all paths should be absolute. Default implementation iterates all directories in <see cref="ImportFromStablePath"/>.
-        /// </summary>
-        protected virtual IEnumerable<string> GetStableImportPaths(Storage storage) => storage.GetDirectories(ImportFromStablePath)
-                                                                                              .Select(path => storage.GetFullPath(path));
-
         /// <summary>
         /// Whether this specified path should be removed after successful import.
         /// </summary>
@@ -746,29 +735,6 @@ namespace osu.Game.Database
         /// <returns>Whether to perform deletion.</returns>
         protected virtual bool ShouldDeleteArchive(string path) => false;
 
-        public Task ImportFromStableAsync(StableStorage stableStorage)
-        {
-            var storage = PrepareStableStorage(stableStorage);
-
-            // Handle situations like when the user does not have a Skins folder.
-            if (!storage.ExistsDirectory(ImportFromStablePath))
-            {
-                string fullPath = storage.GetFullPath(ImportFromStablePath);
-
-                Logger.Log(@$"Folder ""{fullPath}"" not available in the target osu!stable installation to import {HumanisedModelName}s.", LoggingTarget.Information, LogLevel.Error);
-                return Task.CompletedTask;
-            }
-
-            return Task.Run(async () => await Import(GetStableImportPaths(storage).ToArray()).ConfigureAwait(false));
-        }
-
-        /// <summary>
-        /// Run any required traversal operations on the stable storage location before performing operations.
-        /// </summary>
-        /// <param name="stableStorage">The stable storage.</param>
-        /// <returns>The usable storage. Return the unchanged <paramref name="stableStorage"/> if no traversal is required.</returns>
-        protected virtual Storage PrepareStableStorage(StableStorage stableStorage) => stableStorage;
-
         #endregion
 
         /// <summary>
diff --git a/osu.Game/Database/IModelManager.cs b/osu.Game/Database/IModelManager.cs
index 15ad455f21..6c9cca7c7a 100644
--- a/osu.Game/Database/IModelManager.cs
+++ b/osu.Game/Database/IModelManager.cs
@@ -4,8 +4,6 @@
 using System;
 using System.Collections.Generic;
 using System.IO;
-using System.Threading.Tasks;
-using osu.Game.IO;
 
 namespace osu.Game.Database
 {
@@ -26,11 +24,6 @@ namespace osu.Game.Database
         /// </summary>
         event Action<TModel> ItemRemoved;
 
-        /// <summary>
-        /// This is a temporary method and will likely be replaced by a full-fledged (and more correctly placed) migration process in the future.
-        /// </summary>
-        Task ImportFromStableAsync(StableStorage stableStorage);
-
         /// <summary>
         /// Exports an item to a legacy (.zip based) package.
         /// </summary>
diff --git a/osu.Game/Database/StableBeatmapImporter.cs b/osu.Game/Database/StableBeatmapImporter.cs
new file mode 100644
index 0000000000..7aaa8ba013
--- /dev/null
+++ b/osu.Game/Database/StableBeatmapImporter.cs
@@ -0,0 +1,18 @@
+using osu.Framework.Platform;
+using osu.Game.Beatmaps;
+using osu.Game.IO;
+
+namespace osu.Game.Database
+{
+    public class StableBeatmapImporter : StableImporter<BeatmapSetInfo>
+    {
+        protected override string ImportFromStablePath => ".";
+
+        protected override Storage PrepareStableStorage(StableStorage stableStorage) => stableStorage.GetSongStorage();
+
+        public StableBeatmapImporter(IModelImporter<BeatmapSetInfo> importer)
+            : base(importer)
+        {
+        }
+    }
+}
\ No newline at end of file
diff --git a/osu.Game/Database/StableImportManager.cs b/osu.Game/Database/StableImportManager.cs
index fe8c14c085..0a30fcb2be 100644
--- a/osu.Game/Database/StableImportManager.cs
+++ b/osu.Game/Database/StableImportManager.cs
@@ -51,18 +51,22 @@ namespace osu.Game.Database
             var stableStorage = await getStableStorage().ConfigureAwait(false);
             var importTasks = new List<Task>();
 
+            var beatmapImporter = new StableBeatmapImporter(beatmaps);
+            var skinImporter = new StableSkinImporter(skins);
+            var scoreImporter = new StableScoreImporter(scores);
+
             Task beatmapImportTask = Task.CompletedTask;
             if (content.HasFlagFast(StableContent.Beatmaps))
-                importTasks.Add(beatmapImportTask = beatmaps.ImportFromStableAsync(stableStorage));
+                importTasks.Add(beatmapImportTask = beatmapImporter.ImportFromStableAsync(stableStorage));
 
             if (content.HasFlagFast(StableContent.Skins))
-                importTasks.Add(skins.ImportFromStableAsync(stableStorage));
+                importTasks.Add(skinImporter.ImportFromStableAsync(stableStorage));
 
             if (content.HasFlagFast(StableContent.Collections))
                 importTasks.Add(beatmapImportTask.ContinueWith(_ => collections.ImportFromStableAsync(stableStorage), TaskContinuationOptions.OnlyOnRanToCompletion));
 
             if (content.HasFlagFast(StableContent.Scores))
-                importTasks.Add(beatmapImportTask.ContinueWith(_ => scores.ImportFromStableAsync(stableStorage), TaskContinuationOptions.OnlyOnRanToCompletion));
+                importTasks.Add(beatmapImportTask.ContinueWith(_ => scoreImporter.ImportFromStableAsync(stableStorage), TaskContinuationOptions.OnlyOnRanToCompletion));
 
             await Task.WhenAll(importTasks.ToArray()).ConfigureAwait(false);
         }
diff --git a/osu.Game/Database/StableImporter.cs b/osu.Game/Database/StableImporter.cs
new file mode 100644
index 0000000000..e56737959e
--- /dev/null
+++ b/osu.Game/Database/StableImporter.cs
@@ -0,0 +1,60 @@
+// 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 System.Threading.Tasks;
+using osu.Framework.Logging;
+using osu.Framework.Platform;
+using osu.Game.IO;
+
+namespace osu.Game.Database
+{
+    /// <summary>
+    /// A class which handled importing various user data from osu-stable.
+    /// </summary>
+    public class StableImporter<TModel>
+        where TModel : class
+    {
+        /// <summary>
+        /// The relative path from osu-stable's data directory to import items from.
+        /// </summary>
+        protected virtual string ImportFromStablePath => null;
+
+        /// <summary>
+        /// Select paths to import from stable where all paths should be absolute. Default implementation iterates all directories in <see cref="ImportFromStablePath"/>.
+        /// </summary>
+        protected virtual IEnumerable<string> GetStableImportPaths(Storage storage) => storage.GetDirectories(ImportFromStablePath)
+                                                                                              .Select(path => storage.GetFullPath(path));
+
+        protected readonly IModelImporter<TModel> Importer;
+
+        public StableImporter(IModelImporter<TModel> importer)
+        {
+            Importer = importer;
+        }
+
+        public Task ImportFromStableAsync(StableStorage stableStorage)
+        {
+            var storage = PrepareStableStorage(stableStorage);
+
+            // Handle situations like when the user does not have a Skins folder.
+            if (!storage.ExistsDirectory(ImportFromStablePath))
+            {
+                string fullPath = storage.GetFullPath(ImportFromStablePath);
+
+                Logger.Log(@$"Folder ""{fullPath}"" not available in the target osu!stable installation to import {Importer.HumanisedModelName}s.", LoggingTarget.Information, LogLevel.Error);
+                return Task.CompletedTask;
+            }
+
+            return Task.Run(async () => await Importer.Import(GetStableImportPaths(storage).ToArray()).ConfigureAwait(false));
+        }
+
+        /// <summary>
+        /// Run any required traversal operations on the stable storage location before performing operations.
+        /// </summary>
+        /// <param name="stableStorage">The stable storage.</param>
+        /// <returns>The usable storage. Return the unchanged <paramref name="stableStorage"/> if no traversal is required.</returns>
+        protected virtual Storage PrepareStableStorage(StableStorage stableStorage) => stableStorage;
+    }
+}
diff --git a/osu.Game/Database/StableScoreImporter.cs b/osu.Game/Database/StableScoreImporter.cs
new file mode 100644
index 0000000000..fede10c7ea
--- /dev/null
+++ b/osu.Game/Database/StableScoreImporter.cs
@@ -0,0 +1,23 @@
+using System;
+using System.Collections.Generic;
+using System.IO;
+using System.Linq;
+using osu.Framework.Platform;
+using osu.Game.Scoring;
+
+namespace osu.Game.Database
+{
+    public class StableScoreImporter : StableImporter<ScoreInfo>
+    {
+        protected override string ImportFromStablePath => Path.Combine("Data", "r");
+
+        protected override IEnumerable<string> GetStableImportPaths(Storage storage)
+            => storage.GetFiles(ImportFromStablePath).Where(p => Importer.HandledExtensions.Any(ext => Path.GetExtension(p)?.Equals(ext, StringComparison.OrdinalIgnoreCase) ?? false))
+                      .Select(path => storage.GetFullPath(path));
+
+        public StableScoreImporter(IModelImporter<ScoreInfo> importer)
+            : base(importer)
+        {
+        }
+    }
+}
diff --git a/osu.Game/Database/StableSkinImporter.cs b/osu.Game/Database/StableSkinImporter.cs
new file mode 100644
index 0000000000..65601e85b7
--- /dev/null
+++ b/osu.Game/Database/StableSkinImporter.cs
@@ -0,0 +1,14 @@
+using osu.Game.Skinning;
+
+namespace osu.Game.Database
+{
+    public class StableSkinImporter : StableImporter<SkinInfo>
+    {
+        protected override string ImportFromStablePath => "Skins";
+
+        public StableSkinImporter(IModelImporter<SkinInfo> importer)
+            : base(importer)
+        {
+        }
+    }
+}
\ No newline at end of file
diff --git a/osu.Game/Scoring/ScoreManager.cs b/osu.Game/Scoring/ScoreManager.cs
index 29144e7bdc..d25671d77e 100644
--- a/osu.Game/Scoring/ScoreManager.cs
+++ b/osu.Game/Scoring/ScoreManager.cs
@@ -15,7 +15,6 @@ using osu.Framework.Threading;
 using osu.Game.Beatmaps;
 using osu.Game.Configuration;
 using osu.Game.Database;
-using osu.Game.IO;
 using osu.Game.IO.Archives;
 using osu.Game.Online.API;
 using osu.Game.Overlays.Notifications;
@@ -263,11 +262,6 @@ namespace osu.Game.Scoring
             remove => scoreModelManager.ItemRemoved -= value;
         }
 
-        public Task ImportFromStableAsync(StableStorage stableStorage)
-        {
-            return scoreModelManager.ImportFromStableAsync(stableStorage);
-        }
-
         public void Export(ScoreInfo item)
         {
             scoreModelManager.Export(item);
diff --git a/osu.Game/Scoring/ScoreModelManager.cs b/osu.Game/Scoring/ScoreModelManager.cs
index c194a7166d..9da739237b 100644
--- a/osu.Game/Scoring/ScoreModelManager.cs
+++ b/osu.Game/Scoring/ScoreModelManager.cs
@@ -26,8 +26,6 @@ namespace osu.Game.Scoring
 
         protected override string[] HashableFileTypes => new[] { ".osr" };
 
-        protected override string ImportFromStablePath => Path.Combine("Data", "r");
-
         private readonly RulesetStore rulesets;
         private readonly Func<BeatmapManager> beatmaps;
 
@@ -81,9 +79,5 @@ namespace osu.Game.Scoring
             using (var inputStream = Files.Storage.GetStream(file.FileInfo.GetStoragePath()))
                 inputStream.CopyTo(outputStream);
         }
-
-        protected override IEnumerable<string> GetStableImportPaths(Storage storage)
-            => storage.GetFiles(ImportFromStablePath).Where(p => HandledExtensions.Any(ext => Path.GetExtension(p)?.Equals(ext, StringComparison.OrdinalIgnoreCase) ?? false))
-                      .Select(path => storage.GetFullPath(path));
     }
 }
diff --git a/osu.Game/Skinning/SkinManager.cs b/osu.Game/Skinning/SkinManager.cs
index a840e17ed1..679b35799e 100644
--- a/osu.Game/Skinning/SkinManager.cs
+++ b/osu.Game/Skinning/SkinManager.cs
@@ -301,11 +301,6 @@ namespace osu.Game.Skinning
             remove => skinModelManager.ItemRemoved -= value;
         }
 
-        public Task ImportFromStableAsync(StableStorage stableStorage)
-        {
-            return skinModelManager.ImportFromStableAsync(stableStorage);
-        }
-
         public void Export(SkinInfo item)
         {
             skinModelManager.Export(item);
diff --git a/osu.Game/Skinning/SkinModelManager.cs b/osu.Game/Skinning/SkinModelManager.cs
index f28b0c066b..572ae5cbfc 100644
--- a/osu.Game/Skinning/SkinModelManager.cs
+++ b/osu.Game/Skinning/SkinModelManager.cs
@@ -34,8 +34,6 @@ namespace osu.Game.Skinning
 
         protected override string[] HashableFileTypes => new[] { ".ini", ".json" };
 
-        protected override string ImportFromStablePath => "Skins";
-
         protected override bool ShouldDeleteArchive(string path) => Path.GetExtension(path)?.ToLowerInvariant() == @".osk";
 
         protected override SkinInfo CreateModel(ArchiveReader archive) => new SkinInfo { Name = archive.Name ?? @"No name" };

From 9dcb20a8217ff9dfe62487c8d578a7e42ab8ab35 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 25 Nov 2021 15:39:05 +0900
Subject: [PATCH 1262/5547] Rename `Stable` to `Legacy` and add xmldoc

---
 ...ImportManager.cs => LeagcyImportManager.cs} | 11 +++++++----
 ...mapImporter.cs => LegacyBeatmapImporter.cs} |  6 +++---
 .../{StableImporter.cs => LegacyImporter.cs}   |  6 +++---
 ...ScoreImporter.cs => LegacyScoreImporter.cs} |  4 ++--
 ...leSkinImporter.cs => LegacySkinImporter.cs} |  4 ++--
 osu.Game/OsuGame.cs                            |  4 ++--
 .../Sections/Maintenance/GeneralSettings.cs    | 18 +++++++++---------
 osu.Game/Screens/Select/SongSelect.cs          |  6 +++---
 8 files changed, 31 insertions(+), 28 deletions(-)
 rename osu.Game/Database/{StableImportManager.cs => LeagcyImportManager.cs} (90%)
 rename osu.Game/Database/{StableBeatmapImporter.cs => LegacyBeatmapImporter.cs} (74%)
 rename osu.Game/Database/{StableImporter.cs => LegacyImporter.cs} (92%)
 rename osu.Game/Database/{StableScoreImporter.cs => LegacyScoreImporter.cs} (83%)
 rename osu.Game/Database/{StableSkinImporter.cs => LegacySkinImporter.cs} (60%)

diff --git a/osu.Game/Database/StableImportManager.cs b/osu.Game/Database/LeagcyImportManager.cs
similarity index 90%
rename from osu.Game/Database/StableImportManager.cs
rename to osu.Game/Database/LeagcyImportManager.cs
index 0a30fcb2be..9f3f9d007a 100644
--- a/osu.Game/Database/StableImportManager.cs
+++ b/osu.Game/Database/LeagcyImportManager.cs
@@ -19,7 +19,10 @@ using osu.Game.Skinning;
 
 namespace osu.Game.Database
 {
-    public class StableImportManager : Component
+    /// <summary>
+    /// Handles migration of legacy user data from osu-stable.
+    /// </summary>
+    public class LeagcyImportManager : Component
     {
         [Resolved]
         private SkinManager skins { get; set; }
@@ -51,9 +54,9 @@ namespace osu.Game.Database
             var stableStorage = await getStableStorage().ConfigureAwait(false);
             var importTasks = new List<Task>();
 
-            var beatmapImporter = new StableBeatmapImporter(beatmaps);
-            var skinImporter = new StableSkinImporter(skins);
-            var scoreImporter = new StableScoreImporter(scores);
+            var beatmapImporter = new LegacyBeatmapImporter(beatmaps);
+            var skinImporter = new LegacySkinImporter(skins);
+            var scoreImporter = new LegacyScoreImporter(scores);
 
             Task beatmapImportTask = Task.CompletedTask;
             if (content.HasFlagFast(StableContent.Beatmaps))
diff --git a/osu.Game/Database/StableBeatmapImporter.cs b/osu.Game/Database/LegacyBeatmapImporter.cs
similarity index 74%
rename from osu.Game/Database/StableBeatmapImporter.cs
rename to osu.Game/Database/LegacyBeatmapImporter.cs
index 7aaa8ba013..a377c39b90 100644
--- a/osu.Game/Database/StableBeatmapImporter.cs
+++ b/osu.Game/Database/LegacyBeatmapImporter.cs
@@ -4,15 +4,15 @@ using osu.Game.IO;
 
 namespace osu.Game.Database
 {
-    public class StableBeatmapImporter : StableImporter<BeatmapSetInfo>
+    public class LegacyBeatmapImporter : LegacyImporter<BeatmapSetInfo>
     {
         protected override string ImportFromStablePath => ".";
 
         protected override Storage PrepareStableStorage(StableStorage stableStorage) => stableStorage.GetSongStorage();
 
-        public StableBeatmapImporter(IModelImporter<BeatmapSetInfo> importer)
+        public LegacyBeatmapImporter(IModelImporter<BeatmapSetInfo> importer)
             : base(importer)
         {
         }
     }
-}
\ No newline at end of file
+}
diff --git a/osu.Game/Database/StableImporter.cs b/osu.Game/Database/LegacyImporter.cs
similarity index 92%
rename from osu.Game/Database/StableImporter.cs
rename to osu.Game/Database/LegacyImporter.cs
index e56737959e..4480aa9ee8 100644
--- a/osu.Game/Database/StableImporter.cs
+++ b/osu.Game/Database/LegacyImporter.cs
@@ -11,9 +11,9 @@ using osu.Game.IO;
 namespace osu.Game.Database
 {
     /// <summary>
-    /// A class which handled importing various user data from osu-stable.
+    /// A class which handles importing legacy user data of a single type from osu-stable.
     /// </summary>
-    public class StableImporter<TModel>
+    public abstract class LegacyImporter<TModel>
         where TModel : class
     {
         /// <summary>
@@ -29,7 +29,7 @@ namespace osu.Game.Database
 
         protected readonly IModelImporter<TModel> Importer;
 
-        public StableImporter(IModelImporter<TModel> importer)
+        protected LegacyImporter(IModelImporter<TModel> importer)
         {
             Importer = importer;
         }
diff --git a/osu.Game/Database/StableScoreImporter.cs b/osu.Game/Database/LegacyScoreImporter.cs
similarity index 83%
rename from osu.Game/Database/StableScoreImporter.cs
rename to osu.Game/Database/LegacyScoreImporter.cs
index fede10c7ea..4cc2be60e6 100644
--- a/osu.Game/Database/StableScoreImporter.cs
+++ b/osu.Game/Database/LegacyScoreImporter.cs
@@ -7,7 +7,7 @@ using osu.Game.Scoring;
 
 namespace osu.Game.Database
 {
-    public class StableScoreImporter : StableImporter<ScoreInfo>
+    public class LegacyScoreImporter : LegacyImporter<ScoreInfo>
     {
         protected override string ImportFromStablePath => Path.Combine("Data", "r");
 
@@ -15,7 +15,7 @@ namespace osu.Game.Database
             => storage.GetFiles(ImportFromStablePath).Where(p => Importer.HandledExtensions.Any(ext => Path.GetExtension(p)?.Equals(ext, StringComparison.OrdinalIgnoreCase) ?? false))
                       .Select(path => storage.GetFullPath(path));
 
-        public StableScoreImporter(IModelImporter<ScoreInfo> importer)
+        public LegacyScoreImporter(IModelImporter<ScoreInfo> importer)
             : base(importer)
         {
         }
diff --git a/osu.Game/Database/StableSkinImporter.cs b/osu.Game/Database/LegacySkinImporter.cs
similarity index 60%
rename from osu.Game/Database/StableSkinImporter.cs
rename to osu.Game/Database/LegacySkinImporter.cs
index 65601e85b7..357da1b005 100644
--- a/osu.Game/Database/StableSkinImporter.cs
+++ b/osu.Game/Database/LegacySkinImporter.cs
@@ -2,11 +2,11 @@ using osu.Game.Skinning;
 
 namespace osu.Game.Database
 {
-    public class StableSkinImporter : StableImporter<SkinInfo>
+    public class LegacySkinImporter : LegacyImporter<SkinInfo>
     {
         protected override string ImportFromStablePath => "Skins";
 
-        public StableSkinImporter(IModelImporter<SkinInfo> importer)
+        public LegacySkinImporter(IModelImporter<SkinInfo> importer)
             : base(importer)
         {
         }
diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index 574a5e5393..9b9ec585e8 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -116,7 +116,7 @@ namespace osu.Game
         private readonly DifficultyRecommender difficultyRecommender = new DifficultyRecommender();
 
         [Cached]
-        private readonly StableImportManager stableImportManager = new StableImportManager();
+        private readonly LeagcyImportManager leagcyImportManager = new LeagcyImportManager();
 
         [Cached]
         private readonly ScreenshotManager screenshotManager = new ScreenshotManager();
@@ -782,7 +782,7 @@ namespace osu.Game
                 PostNotification = n => Notifications.Post(n),
             }, Add, true);
 
-            loadComponentSingleFile(stableImportManager, Add);
+            loadComponentSingleFile(leagcyImportManager, Add);
 
             loadComponentSingleFile(screenshotManager, Add);
 
diff --git a/osu.Game/Overlays/Settings/Sections/Maintenance/GeneralSettings.cs b/osu.Game/Overlays/Settings/Sections/Maintenance/GeneralSettings.cs
index 43df58a8b1..9dfd0d8ff4 100644
--- a/osu.Game/Overlays/Settings/Sections/Maintenance/GeneralSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Maintenance/GeneralSettings.cs
@@ -31,9 +31,9 @@ namespace osu.Game.Overlays.Settings.Sections.Maintenance
         private SettingsButton undeleteButton;
 
         [BackgroundDependencyLoader(permitNulls: true)]
-        private void load(BeatmapManager beatmaps, ScoreManager scores, SkinManager skins, [CanBeNull] CollectionManager collectionManager, [CanBeNull] StableImportManager stableImportManager, DialogOverlay dialogOverlay)
+        private void load(BeatmapManager beatmaps, ScoreManager scores, SkinManager skins, [CanBeNull] CollectionManager collectionManager, [CanBeNull] LeagcyImportManager leagcyImportManager, DialogOverlay dialogOverlay)
         {
-            if (stableImportManager?.SupportsImportFromStable == true)
+            if (leagcyImportManager?.SupportsImportFromStable == true)
             {
                 Add(importBeatmapsButton = new SettingsButton
                 {
@@ -41,7 +41,7 @@ namespace osu.Game.Overlays.Settings.Sections.Maintenance
                     Action = () =>
                     {
                         importBeatmapsButton.Enabled.Value = false;
-                        stableImportManager.ImportFromStableAsync(StableContent.Beatmaps).ContinueWith(t => Schedule(() => importBeatmapsButton.Enabled.Value = true));
+                        leagcyImportManager.ImportFromStableAsync(StableContent.Beatmaps).ContinueWith(t => Schedule(() => importBeatmapsButton.Enabled.Value = true));
                     }
                 });
             }
@@ -59,7 +59,7 @@ namespace osu.Game.Overlays.Settings.Sections.Maintenance
                 }
             });
 
-            if (stableImportManager?.SupportsImportFromStable == true)
+            if (leagcyImportManager?.SupportsImportFromStable == true)
             {
                 Add(importScoresButton = new SettingsButton
                 {
@@ -67,7 +67,7 @@ namespace osu.Game.Overlays.Settings.Sections.Maintenance
                     Action = () =>
                     {
                         importScoresButton.Enabled.Value = false;
-                        stableImportManager.ImportFromStableAsync(StableContent.Scores).ContinueWith(t => Schedule(() => importScoresButton.Enabled.Value = true));
+                        leagcyImportManager.ImportFromStableAsync(StableContent.Scores).ContinueWith(t => Schedule(() => importScoresButton.Enabled.Value = true));
                     }
                 });
             }
@@ -85,7 +85,7 @@ namespace osu.Game.Overlays.Settings.Sections.Maintenance
                 }
             });
 
-            if (stableImportManager?.SupportsImportFromStable == true)
+            if (leagcyImportManager?.SupportsImportFromStable == true)
             {
                 Add(importSkinsButton = new SettingsButton
                 {
@@ -93,7 +93,7 @@ namespace osu.Game.Overlays.Settings.Sections.Maintenance
                     Action = () =>
                     {
                         importSkinsButton.Enabled.Value = false;
-                        stableImportManager.ImportFromStableAsync(StableContent.Skins).ContinueWith(t => Schedule(() => importSkinsButton.Enabled.Value = true));
+                        leagcyImportManager.ImportFromStableAsync(StableContent.Skins).ContinueWith(t => Schedule(() => importSkinsButton.Enabled.Value = true));
                     }
                 });
             }
@@ -113,7 +113,7 @@ namespace osu.Game.Overlays.Settings.Sections.Maintenance
 
             if (collectionManager != null)
             {
-                if (stableImportManager?.SupportsImportFromStable == true)
+                if (leagcyImportManager?.SupportsImportFromStable == true)
                 {
                     Add(importCollectionsButton = new SettingsButton
                     {
@@ -121,7 +121,7 @@ namespace osu.Game.Overlays.Settings.Sections.Maintenance
                         Action = () =>
                         {
                             importCollectionsButton.Enabled.Value = false;
-                            stableImportManager.ImportFromStableAsync(StableContent.Collections).ContinueWith(t => Schedule(() => importCollectionsButton.Enabled.Value = true));
+                            leagcyImportManager.ImportFromStableAsync(StableContent.Collections).ContinueWith(t => Schedule(() => importCollectionsButton.Enabled.Value = true));
                         }
                     });
                 }
diff --git a/osu.Game/Screens/Select/SongSelect.cs b/osu.Game/Screens/Select/SongSelect.cs
index 2c36bf5fc8..b6933a9830 100644
--- a/osu.Game/Screens/Select/SongSelect.cs
+++ b/osu.Game/Screens/Select/SongSelect.cs
@@ -51,7 +51,7 @@ namespace osu.Game.Screens.Select
 
         protected virtual bool ShowFooter => true;
 
-        protected virtual bool DisplayStableImportPrompt => stableImportManager?.SupportsImportFromStable == true;
+        protected virtual bool DisplayStableImportPrompt => leagcyImportManager?.SupportsImportFromStable == true;
 
         public override bool? AllowTrackAdjustments => true;
 
@@ -90,7 +90,7 @@ namespace osu.Game.Screens.Select
         private BeatmapManager beatmaps { get; set; }
 
         [Resolved(CanBeNull = true)]
-        private StableImportManager stableImportManager { get; set; }
+        private LeagcyImportManager leagcyImportManager { get; set; }
 
         protected ModSelectOverlay ModSelect { get; private set; }
 
@@ -297,7 +297,7 @@ namespace osu.Game.Screens.Select
                     {
                         dialogOverlay.Push(new ImportFromStablePopup(() =>
                         {
-                            Task.Run(() => stableImportManager.ImportFromStableAsync(StableContent.All));
+                            Task.Run(() => leagcyImportManager.ImportFromStableAsync(StableContent.All));
                         }));
                     }
                 });

From 2df793ca228e69032fcb0e8027ebd4bf4a138589 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 25 Nov 2021 15:44:04 +0900
Subject: [PATCH 1263/5547] Inline individual importers to avoid unnecessary
 construction for singular import types

---
 osu.Game/Database/LeagcyImportManager.cs | 10 +++-------
 1 file changed, 3 insertions(+), 7 deletions(-)

diff --git a/osu.Game/Database/LeagcyImportManager.cs b/osu.Game/Database/LeagcyImportManager.cs
index 9f3f9d007a..8ee63429e2 100644
--- a/osu.Game/Database/LeagcyImportManager.cs
+++ b/osu.Game/Database/LeagcyImportManager.cs
@@ -54,22 +54,18 @@ namespace osu.Game.Database
             var stableStorage = await getStableStorage().ConfigureAwait(false);
             var importTasks = new List<Task>();
 
-            var beatmapImporter = new LegacyBeatmapImporter(beatmaps);
-            var skinImporter = new LegacySkinImporter(skins);
-            var scoreImporter = new LegacyScoreImporter(scores);
-
             Task beatmapImportTask = Task.CompletedTask;
             if (content.HasFlagFast(StableContent.Beatmaps))
-                importTasks.Add(beatmapImportTask = beatmapImporter.ImportFromStableAsync(stableStorage));
+                importTasks.Add(beatmapImportTask = new LegacyBeatmapImporter(beatmaps).ImportFromStableAsync(stableStorage));
 
             if (content.HasFlagFast(StableContent.Skins))
-                importTasks.Add(skinImporter.ImportFromStableAsync(stableStorage));
+                importTasks.Add(new LegacySkinImporter(skins).ImportFromStableAsync(stableStorage));
 
             if (content.HasFlagFast(StableContent.Collections))
                 importTasks.Add(beatmapImportTask.ContinueWith(_ => collections.ImportFromStableAsync(stableStorage), TaskContinuationOptions.OnlyOnRanToCompletion));
 
             if (content.HasFlagFast(StableContent.Scores))
-                importTasks.Add(beatmapImportTask.ContinueWith(_ => scoreImporter.ImportFromStableAsync(stableStorage), TaskContinuationOptions.OnlyOnRanToCompletion));
+                importTasks.Add(beatmapImportTask.ContinueWith(_ => new LegacyScoreImporter(scores).ImportFromStableAsync(stableStorage), TaskContinuationOptions.OnlyOnRanToCompletion));
 
             await Task.WhenAll(importTasks.ToArray()).ConfigureAwait(false);
         }

From e6cfe44652ac475f733135863458ac569487b7d9 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 25 Nov 2021 16:27:55 +0900
Subject: [PATCH 1264/5547] Fix occasional test failure due to default value
 oversight in `TestSceneBeatmapCarousel`

---
 .../Visual/SongSelect/TestSceneBeatmapCarousel.cs           | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs
index 5906979bc4..f637c715a1 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs
@@ -572,7 +572,7 @@ namespace osu.Game.Tests.Visual.SongSelect
 
             AddStep("add mixed ruleset beatmapset", () =>
             {
-                testMixed = TestResources.CreateTestBeatmapSetInfo();
+                testMixed = TestResources.CreateTestBeatmapSetInfo(3);
 
                 for (int i = 0; i <= 2; i++)
                 {
@@ -595,7 +595,7 @@ namespace osu.Game.Tests.Visual.SongSelect
             BeatmapSetInfo testSingle = null;
             AddStep("add single ruleset beatmapset", () =>
             {
-                testSingle = TestResources.CreateTestBeatmapSetInfo();
+                testSingle = TestResources.CreateTestBeatmapSetInfo(3);
                 testSingle.Beatmaps.ForEach(b =>
                 {
                     b.Ruleset = rulesets.AvailableRulesets.ElementAt(1);
@@ -615,7 +615,7 @@ namespace osu.Game.Tests.Visual.SongSelect
             List<BeatmapSetInfo> manySets = new List<BeatmapSetInfo>();
 
             for (int i = 1; i <= 50; i++)
-                manySets.Add(TestResources.CreateTestBeatmapSetInfo(i));
+                manySets.Add(TestResources.CreateTestBeatmapSetInfo(3));
 
             loadBeatmaps(manySets);
 

From a0fa030f55385cb3f85d1a2d4c1d8e99e65cbb07 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 25 Nov 2021 16:33:04 +0900
Subject: [PATCH 1265/5547] Rename base class to `LegacyModelImporter`

---
 osu.Game/Database/LegacyBeatmapImporter.cs                    | 2 +-
 .../Database/{LegacyImporter.cs => LegacyModelImporter.cs}    | 4 ++--
 osu.Game/Database/LegacyScoreImporter.cs                      | 2 +-
 osu.Game/Database/LegacySkinImporter.cs                       | 2 +-
 4 files changed, 5 insertions(+), 5 deletions(-)
 rename osu.Game/Database/{LegacyImporter.cs => LegacyModelImporter.cs} (95%)

diff --git a/osu.Game/Database/LegacyBeatmapImporter.cs b/osu.Game/Database/LegacyBeatmapImporter.cs
index a377c39b90..041a692655 100644
--- a/osu.Game/Database/LegacyBeatmapImporter.cs
+++ b/osu.Game/Database/LegacyBeatmapImporter.cs
@@ -4,7 +4,7 @@ using osu.Game.IO;
 
 namespace osu.Game.Database
 {
-    public class LegacyBeatmapImporter : LegacyImporter<BeatmapSetInfo>
+    public class LegacyBeatmapImporter : LegacyModelImporter<BeatmapSetInfo>
     {
         protected override string ImportFromStablePath => ".";
 
diff --git a/osu.Game/Database/LegacyImporter.cs b/osu.Game/Database/LegacyModelImporter.cs
similarity index 95%
rename from osu.Game/Database/LegacyImporter.cs
rename to osu.Game/Database/LegacyModelImporter.cs
index 4480aa9ee8..dacb7327ea 100644
--- a/osu.Game/Database/LegacyImporter.cs
+++ b/osu.Game/Database/LegacyModelImporter.cs
@@ -13,7 +13,7 @@ namespace osu.Game.Database
     /// <summary>
     /// A class which handles importing legacy user data of a single type from osu-stable.
     /// </summary>
-    public abstract class LegacyImporter<TModel>
+    public abstract class LegacyModelImporter<TModel>
         where TModel : class
     {
         /// <summary>
@@ -29,7 +29,7 @@ namespace osu.Game.Database
 
         protected readonly IModelImporter<TModel> Importer;
 
-        protected LegacyImporter(IModelImporter<TModel> importer)
+        protected LegacyModelImporter(IModelImporter<TModel> importer)
         {
             Importer = importer;
         }
diff --git a/osu.Game/Database/LegacyScoreImporter.cs b/osu.Game/Database/LegacyScoreImporter.cs
index 4cc2be60e6..984aa8a1ac 100644
--- a/osu.Game/Database/LegacyScoreImporter.cs
+++ b/osu.Game/Database/LegacyScoreImporter.cs
@@ -7,7 +7,7 @@ using osu.Game.Scoring;
 
 namespace osu.Game.Database
 {
-    public class LegacyScoreImporter : LegacyImporter<ScoreInfo>
+    public class LegacyScoreImporter : LegacyModelImporter<ScoreInfo>
     {
         protected override string ImportFromStablePath => Path.Combine("Data", "r");
 
diff --git a/osu.Game/Database/LegacySkinImporter.cs b/osu.Game/Database/LegacySkinImporter.cs
index 357da1b005..b102e26bc6 100644
--- a/osu.Game/Database/LegacySkinImporter.cs
+++ b/osu.Game/Database/LegacySkinImporter.cs
@@ -2,7 +2,7 @@ using osu.Game.Skinning;
 
 namespace osu.Game.Database
 {
-    public class LegacySkinImporter : LegacyImporter<SkinInfo>
+    public class LegacySkinImporter : LegacyModelImporter<SkinInfo>
     {
         protected override string ImportFromStablePath => "Skins";
 

From 416ee2447a02f60b29d39b19d65851628b139236 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 25 Nov 2021 16:33:35 +0900
Subject: [PATCH 1266/5547] Move archive filename helper method to extension
 method

---
 osu.Game/Beatmaps/BeatmapModelManager.cs |  2 +-
 osu.Game/Extensions/ModelExtensions.cs   | 17 +++++++++++++++++
 2 files changed, 18 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Beatmaps/BeatmapModelManager.cs b/osu.Game/Beatmaps/BeatmapModelManager.cs
index 63cdd0b852..c91264c03a 100644
--- a/osu.Game/Beatmaps/BeatmapModelManager.cs
+++ b/osu.Game/Beatmaps/BeatmapModelManager.cs
@@ -212,7 +212,7 @@ namespace osu.Game.Beatmaps
                     var fileInfo = setInfo.Files.SingleOrDefault(f => string.Equals(f.Filename, beatmapInfo.Path, StringComparison.OrdinalIgnoreCase)) ?? new BeatmapSetFileInfo();
 
                     // metadata may have changed; update the path with the standard format.
-                    beatmapInfo.Path = GetValidFilename($"{metadata.Artist} - {metadata.Title} ({metadata.Author}) [{beatmapInfo.DifficultyName}].osu");
+                    beatmapInfo.Path = $"{metadata.Artist} - {metadata.Title} ({metadata.Author}) [{beatmapInfo.DifficultyName}].osu".GetValidArchiveContentFilename();
 
                     beatmapInfo.MD5Hash = stream.ComputeMD5Hash();
 
diff --git a/osu.Game/Extensions/ModelExtensions.cs b/osu.Game/Extensions/ModelExtensions.cs
index 9f00d21383..2274da0fd4 100644
--- a/osu.Game/Extensions/ModelExtensions.cs
+++ b/osu.Game/Extensions/ModelExtensions.cs
@@ -2,6 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System.IO;
+using System.Linq;
 using osu.Game.Beatmaps;
 using osu.Game.Database;
 using osu.Game.IO;
@@ -124,5 +125,21 @@ namespace osu.Game.Extensions
 
             return instance.OnlineID.Equals(other.OnlineID);
         }
+
+        private static readonly char[] invalid_filename_characters = Path.GetInvalidFileNameChars()
+                                                                         // Backslash is added to avoid issues when exporting to zip.
+                                                                         // See SharpCompress filename normalisation https://github.com/adamhathcock/sharpcompress/blob/a1e7c0068db814c9aa78d86a94ccd1c761af74bd/src/SharpCompress/Writers/Zip/ZipWriter.cs#L143.
+                                                                         .Append('\\')
+                                                                         .ToArray();
+
+        /// <summary>
+        /// Get a valid filename for use inside a zip file. Avoids backslashes being incorrectly converted to directories.
+        /// </summary>
+        public static string GetValidArchiveContentFilename(this string filename)
+        {
+            foreach (char c in invalid_filename_characters)
+                filename = filename.Replace(c, '_');
+            return filename;
+        }
     }
 }

From 7488ccd5fe4830469b9e8e1bc393ea1a0e0c7348 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 25 Nov 2021 16:35:42 +0900
Subject: [PATCH 1267/5547] Update all models to implement `IHasNamedFiles`

---
 osu.Game/Beatmaps/BeatmapSetInfo.cs               |  2 +-
 osu.Game/Beatmaps/IBeatmapSetInfo.cs              |  7 +------
 osu.Game/Database/IHasNamedFiles.cs               | 15 +++++++++++++++
 osu.Game/Models/RealmBeatmapSet.cs                |  3 +--
 .../API/Requests/Responses/APIBeatmapSet.cs       |  2 +-
 .../Online/API/Requests/Responses/APIScoreInfo.cs |  2 ++
 osu.Game/Scoring/IScoreInfo.cs                    |  2 +-
 osu.Game/Scoring/ScoreFileInfo.cs                 |  4 +++-
 osu.Game/Scoring/ScoreInfo.cs                     |  2 ++
 osu.Game/Skinning/SkinFileInfo.cs                 |  4 +++-
 osu.Game/Skinning/SkinInfo.cs                     |  4 +++-
 11 files changed, 33 insertions(+), 14 deletions(-)
 create mode 100644 osu.Game/Database/IHasNamedFiles.cs

diff --git a/osu.Game/Beatmaps/BeatmapSetInfo.cs b/osu.Game/Beatmaps/BeatmapSetInfo.cs
index a4d60d7ea0..ac7067edda 100644
--- a/osu.Game/Beatmaps/BeatmapSetInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapSetInfo.cs
@@ -95,7 +95,7 @@ namespace osu.Game.Beatmaps
 
         IBeatmapMetadataInfo IBeatmapSetInfo.Metadata => Metadata ?? Beatmaps.FirstOrDefault()?.Metadata ?? new BeatmapMetadata();
         IEnumerable<IBeatmapInfo> IBeatmapSetInfo.Beatmaps => Beatmaps;
-        IEnumerable<INamedFileUsage> IBeatmapSetInfo.Files => Files;
+        IEnumerable<INamedFileUsage> IHasNamedFiles.Files => Files;
 
         #endregion
     }
diff --git a/osu.Game/Beatmaps/IBeatmapSetInfo.cs b/osu.Game/Beatmaps/IBeatmapSetInfo.cs
index aa114c8472..9755120457 100644
--- a/osu.Game/Beatmaps/IBeatmapSetInfo.cs
+++ b/osu.Game/Beatmaps/IBeatmapSetInfo.cs
@@ -12,7 +12,7 @@ namespace osu.Game.Beatmaps
     /// <summary>
     /// A representation of a collection of beatmap difficulties, generally packaged as an ".osz" archive.
     /// </summary>
-    public interface IBeatmapSetInfo : IHasOnlineID<int>, IEquatable<IBeatmapSetInfo>
+    public interface IBeatmapSetInfo : IHasOnlineID<int>, IEquatable<IBeatmapSetInfo>, IHasNamedFiles
     {
         /// <summary>
         /// The date when this beatmap was imported.
@@ -29,11 +29,6 @@ namespace osu.Game.Beatmaps
         /// </summary>
         IEnumerable<IBeatmapInfo> Beatmaps { get; }
 
-        /// <summary>
-        /// All files used by this set.
-        /// </summary>
-        IEnumerable<INamedFileUsage> Files { get; }
-
         /// <summary>
         /// The maximum star difficulty of all beatmaps in this set.
         /// </summary>
diff --git a/osu.Game/Database/IHasNamedFiles.cs b/osu.Game/Database/IHasNamedFiles.cs
new file mode 100644
index 0000000000..08906aaa08
--- /dev/null
+++ b/osu.Game/Database/IHasNamedFiles.cs
@@ -0,0 +1,15 @@
+// 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;
+
+namespace osu.Game.Database
+{
+    public interface IHasNamedFiles
+    {
+        /// <summary>
+        /// All files used by this model.
+        /// </summary>
+        IEnumerable<INamedFileUsage> Files { get; }
+    }
+}
diff --git a/osu.Game/Models/RealmBeatmapSet.cs b/osu.Game/Models/RealmBeatmapSet.cs
index fee59633f1..3566ff5321 100644
--- a/osu.Game/Models/RealmBeatmapSet.cs
+++ b/osu.Game/Models/RealmBeatmapSet.cs
@@ -76,7 +76,6 @@ namespace osu.Game.Models
         public bool Equals(IBeatmapSetInfo? other) => other is RealmBeatmapSet b && Equals(b);
 
         IEnumerable<IBeatmapInfo> IBeatmapSetInfo.Beatmaps => Beatmaps;
-
-        IEnumerable<INamedFileUsage> IBeatmapSetInfo.Files => Files;
+        IEnumerable<INamedFileUsage> IHasNamedFiles.Files => Files;
     }
 }
diff --git a/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs b/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs
index 9005fa8eb7..57c45faed3 100644
--- a/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs
@@ -136,7 +136,7 @@ namespace osu.Game.Online.API.Requests.Responses
         IBeatmapMetadataInfo IBeatmapSetInfo.Metadata => metadata;
 
         DateTimeOffset IBeatmapSetInfo.DateAdded => throw new NotImplementedException();
-        IEnumerable<INamedFileUsage> IBeatmapSetInfo.Files => throw new NotImplementedException();
+        IEnumerable<INamedFileUsage> IHasNamedFiles.Files => throw new NotImplementedException();
         double IBeatmapSetInfo.MaxStarDifficulty => throw new NotImplementedException();
         double IBeatmapSetInfo.MaxLength => throw new NotImplementedException();
         double IBeatmapSetInfo.MaxBPM => BPM;
diff --git a/osu.Game/Online/API/Requests/Responses/APIScoreInfo.cs b/osu.Game/Online/API/Requests/Responses/APIScoreInfo.cs
index 0a2d6ca7b0..467d5a9f23 100644
--- a/osu.Game/Online/API/Requests/Responses/APIScoreInfo.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIScoreInfo.cs
@@ -8,6 +8,7 @@ using JetBrains.Annotations;
 using Newtonsoft.Json;
 using Newtonsoft.Json.Converters;
 using osu.Game.Beatmaps;
+using osu.Game.Database;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Scoring;
@@ -147,6 +148,7 @@ namespace osu.Game.Online.API.Requests.Responses
         }
 
         public IRulesetInfo Ruleset => new RulesetInfo { OnlineID = RulesetID };
+        IEnumerable<INamedFileUsage> IHasNamedFiles.Files => throw new NotImplementedException();
 
         IBeatmapInfo IScoreInfo.Beatmap => Beatmap;
     }
diff --git a/osu.Game/Scoring/IScoreInfo.cs b/osu.Game/Scoring/IScoreInfo.cs
index 21a402f8c3..8b5b228632 100644
--- a/osu.Game/Scoring/IScoreInfo.cs
+++ b/osu.Game/Scoring/IScoreInfo.cs
@@ -9,7 +9,7 @@ using osu.Game.Rulesets;
 
 namespace osu.Game.Scoring
 {
-    public interface IScoreInfo : IHasOnlineID<long>
+    public interface IScoreInfo : IHasOnlineID<long>, IHasNamedFiles
     {
         APIUser User { get; }
 
diff --git a/osu.Game/Scoring/ScoreFileInfo.cs b/osu.Game/Scoring/ScoreFileInfo.cs
index 9075fdec5b..b2e81d4b8d 100644
--- a/osu.Game/Scoring/ScoreFileInfo.cs
+++ b/osu.Game/Scoring/ScoreFileInfo.cs
@@ -7,7 +7,7 @@ using osu.Game.IO;
 
 namespace osu.Game.Scoring
 {
-    public class ScoreFileInfo : INamedFileInfo, IHasPrimaryKey
+    public class ScoreFileInfo : INamedFileInfo, IHasPrimaryKey, INamedFileUsage
     {
         public int ID { get; set; }
 
@@ -17,5 +17,7 @@ namespace osu.Game.Scoring
 
         [Required]
         public string Filename { get; set; }
+
+        IFileInfo INamedFileUsage.File => FileInfo;
     }
 }
diff --git a/osu.Game/Scoring/ScoreInfo.cs b/osu.Game/Scoring/ScoreInfo.cs
index b4e194cbed..564aa3b98c 100644
--- a/osu.Game/Scoring/ScoreInfo.cs
+++ b/osu.Game/Scoring/ScoreInfo.cs
@@ -257,5 +257,7 @@ namespace osu.Game.Scoring
         bool IScoreInfo.HasReplay => Files.Any();
 
         #endregion
+
+        IEnumerable<INamedFileUsage> IHasNamedFiles.Files => Files;
     }
 }
diff --git a/osu.Game/Skinning/SkinFileInfo.cs b/osu.Game/Skinning/SkinFileInfo.cs
index 8a7019e1a3..db7cd953bb 100644
--- a/osu.Game/Skinning/SkinFileInfo.cs
+++ b/osu.Game/Skinning/SkinFileInfo.cs
@@ -7,7 +7,7 @@ using osu.Game.IO;
 
 namespace osu.Game.Skinning
 {
-    public class SkinFileInfo : INamedFileInfo, IHasPrimaryKey
+    public class SkinFileInfo : INamedFileInfo, IHasPrimaryKey, INamedFileUsage
     {
         public int ID { get; set; }
 
@@ -19,5 +19,7 @@ namespace osu.Game.Skinning
 
         [Required]
         public string Filename { get; set; }
+
+        IFileInfo INamedFileUsage.File => FileInfo;
     }
 }
diff --git a/osu.Game/Skinning/SkinInfo.cs b/osu.Game/Skinning/SkinInfo.cs
index 4733e8cdd9..5d2d51a9b0 100644
--- a/osu.Game/Skinning/SkinInfo.cs
+++ b/osu.Game/Skinning/SkinInfo.cs
@@ -10,7 +10,7 @@ using osu.Game.IO;
 
 namespace osu.Game.Skinning
 {
-    public class SkinInfo : IHasFiles<SkinFileInfo>, IEquatable<SkinInfo>, IHasPrimaryKey, ISoftDelete
+    public class SkinInfo : IHasFiles<SkinFileInfo>, IEquatable<SkinInfo>, IHasPrimaryKey, ISoftDelete, IHasNamedFiles
     {
         internal const int DEFAULT_SKIN = 0;
         internal const int CLASSIC_SKIN = -1;
@@ -55,5 +55,7 @@ namespace osu.Game.Skinning
             string author = Creator == null ? string.Empty : $"({Creator})";
             return $"{Name} {author}".Trim();
         }
+
+        IEnumerable<INamedFileUsage> IHasNamedFiles.Files => Files;
     }
 }

From cc1b91e4bd9aa7730771088da568d841a22eaf72 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 25 Nov 2021 16:36:30 +0900
Subject: [PATCH 1268/5547] Split out legacy model export logic into
 `LegacyModelExporter` classes

---
 osu.Game/Beatmaps/BeatmapManager.cs           | 10 ---
 osu.Game/Database/ArchiveModelManager.cs      | 53 ---------------
 osu.Game/Database/IModelManager.cs            | 14 ----
 osu.Game/Database/LegacyBeatmapExporter.cs    | 18 +++++
 osu.Game/Database/LegacyExporter.cs           | 66 +++++++++++++++++++
 osu.Game/Database/LegacyScoreExporter.cs      | 31 +++++++++
 osu.Game/Database/LegacySkinExporter.cs       | 18 +++++
 .../Online/Leaderboards/LeaderboardScore.cs   |  7 +-
 .../Overlays/Settings/Sections/SkinSection.cs |  7 +-
 osu.Game/Scoring/ScoreManager.cs              | 10 ---
 osu.Game/Scoring/ScoreModelManager.cs         | 12 ----
 osu.Game/Screens/Edit/Editor.cs               |  7 +-
 osu.Game/Skinning/SkinManager.cs              | 10 ---
 13 files changed, 151 insertions(+), 112 deletions(-)
 create mode 100644 osu.Game/Database/LegacyBeatmapExporter.cs
 create mode 100644 osu.Game/Database/LegacyExporter.cs
 create mode 100644 osu.Game/Database/LegacyScoreExporter.cs
 create mode 100644 osu.Game/Database/LegacySkinExporter.cs

diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index 2cca3ceaeb..1c01f100eb 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -225,16 +225,6 @@ namespace osu.Game.Beatmaps
             remove => beatmapModelManager.ItemRemoved -= value;
         }
 
-        public void Export(BeatmapSetInfo item)
-        {
-            beatmapModelManager.Export(item);
-        }
-
-        public void ExportModelTo(BeatmapSetInfo model, Stream outputStream)
-        {
-            beatmapModelManager.ExportModelTo(model, outputStream);
-        }
-
         public void Update(BeatmapSetInfo item)
         {
             beatmapModelManager.Update(item);
diff --git a/osu.Game/Database/ArchiveModelManager.cs b/osu.Game/Database/ArchiveModelManager.cs
index e5919cb5c4..e73f4a7f6e 100644
--- a/osu.Game/Database/ArchiveModelManager.cs
+++ b/osu.Game/Database/ArchiveModelManager.cs
@@ -20,7 +20,6 @@ using osu.Game.IO;
 using osu.Game.IO.Archives;
 using osu.Game.IPC;
 using osu.Game.Overlays.Notifications;
-using SharpCompress.Archives.Zip;
 
 namespace osu.Game.Database
 {
@@ -82,8 +81,6 @@ namespace osu.Game.Database
         // ReSharper disable once NotAccessedField.Local (we should keep a reference to this so it is not finalised)
         private ArchiveImportIPCChannel ipc;
 
-        private readonly Storage exportStorage;
-
         protected ArchiveModelManager(Storage storage, IDatabaseContextFactory contextFactory, MutableDatabaseBackedStoreWithFileIncludes<TModel, TFileModel> modelStore, IIpcHost importHost = null)
         {
             ContextFactory = contextFactory;
@@ -92,8 +89,6 @@ namespace osu.Game.Database
             ModelStore.ItemUpdated += item => handleEvent(() => ItemUpdated?.Invoke(item));
             ModelStore.ItemRemoved += item => handleEvent(() => ItemRemoved?.Invoke(item));
 
-            exportStorage = storage.GetStorageForDirectory(@"exports");
-
             Files = new FileStore(contextFactory, storage);
 
             if (importHost != null)
@@ -452,41 +447,6 @@ namespace osu.Game.Database
             return item.ToEntityFrameworkLive();
         }, cancellationToken, TaskCreationOptions.HideScheduler, lowPriority ? import_scheduler_low_priority : import_scheduler).Unwrap().ConfigureAwait(false);
 
-        /// <summary>
-        /// Exports an item to a legacy (.zip based) package.
-        /// </summary>
-        /// <param name="item">The item to export.</param>
-        public void Export(TModel item)
-        {
-            var retrievedItem = ModelStore.ConsumableItems.FirstOrDefault(s => s.ID == item.ID);
-
-            if (retrievedItem == null)
-                throw new ArgumentException(@"Specified model could not be found", nameof(item));
-
-            string filename = $"{GetValidFilename(item.ToString())}{HandledExtensions.First()}";
-
-            using (var stream = exportStorage.GetStream(filename, FileAccess.Write, FileMode.Create))
-                ExportModelTo(retrievedItem, stream);
-
-            exportStorage.PresentFileExternally(filename);
-        }
-
-        /// <summary>
-        /// Exports an item to the given output stream.
-        /// </summary>
-        /// <param name="model">The item to export.</param>
-        /// <param name="outputStream">The output stream to export to.</param>
-        public virtual void ExportModelTo(TModel model, Stream outputStream)
-        {
-            using (var archive = ZipArchive.Create())
-            {
-                foreach (var file in model.Files)
-                    archive.AddEntry(file.Filename, Files.Storage.GetStream(file.FileInfo.GetStoragePath()));
-
-                archive.SaveTo(outputStream);
-            }
-        }
-
         /// <summary>
         /// Replace an existing file with a new version.
         /// </summary>
@@ -875,18 +835,5 @@ namespace osu.Game.Database
             // this doesn't follow the SHA2 hashing schema intentionally, so such entries on the data store can be identified.
             return Guid.NewGuid().ToString();
         }
-
-        private readonly char[] invalidFilenameCharacters = Path.GetInvalidFileNameChars()
-                                                                // Backslash is added to avoid issues when exporting to zip.
-                                                                // See SharpCompress filename normalisation https://github.com/adamhathcock/sharpcompress/blob/a1e7c0068db814c9aa78d86a94ccd1c761af74bd/src/SharpCompress/Writers/Zip/ZipWriter.cs#L143.
-                                                                .Append('\\')
-                                                                .ToArray();
-
-        protected string GetValidFilename(string filename)
-        {
-            foreach (char c in invalidFilenameCharacters)
-                filename = filename.Replace(c, '_');
-            return filename;
-        }
     }
 }
diff --git a/osu.Game/Database/IModelManager.cs b/osu.Game/Database/IModelManager.cs
index 6c9cca7c7a..779d0522f7 100644
--- a/osu.Game/Database/IModelManager.cs
+++ b/osu.Game/Database/IModelManager.cs
@@ -3,7 +3,6 @@
 
 using System;
 using System.Collections.Generic;
-using System.IO;
 
 namespace osu.Game.Database
 {
@@ -24,19 +23,6 @@ namespace osu.Game.Database
         /// </summary>
         event Action<TModel> ItemRemoved;
 
-        /// <summary>
-        /// Exports an item to a legacy (.zip based) package.
-        /// </summary>
-        /// <param name="item">The item to export.</param>
-        void Export(TModel item);
-
-        /// <summary>
-        /// Exports an item to the given output stream.
-        /// </summary>
-        /// <param name="model">The item to export.</param>
-        /// <param name="outputStream">The output stream to export to.</param>
-        void ExportModelTo(TModel model, Stream outputStream);
-
         /// <summary>
         /// Perform an update of the specified item.
         /// TODO: Support file additions/removals.
diff --git a/osu.Game/Database/LegacyBeatmapExporter.cs b/osu.Game/Database/LegacyBeatmapExporter.cs
new file mode 100644
index 0000000000..671ed54326
--- /dev/null
+++ b/osu.Game/Database/LegacyBeatmapExporter.cs
@@ -0,0 +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 osu.Framework.Platform;
+using osu.Game.Beatmaps;
+
+namespace osu.Game.Database
+{
+    public class LegacyBeatmapExporter : LegacyExporter<BeatmapSetInfo>
+    {
+        protected override string FileExtension => ".osz";
+
+        public LegacyBeatmapExporter(Storage storage, IModelManager<BeatmapSetInfo> manager)
+            : base(storage, manager)
+        {
+        }
+    }
+}
diff --git a/osu.Game/Database/LegacyExporter.cs b/osu.Game/Database/LegacyExporter.cs
new file mode 100644
index 0000000000..846495b1ed
--- /dev/null
+++ b/osu.Game/Database/LegacyExporter.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 System.IO;
+using osu.Framework.Platform;
+using osu.Game.Extensions;
+using SharpCompress.Archives.Zip;
+
+namespace osu.Game.Database
+{
+    /// <summary>
+    /// A class which handles exporting legacy user data of a single type from osu-stable.
+    /// </summary>
+    public abstract class LegacyExporter<TModel>
+        where TModel : class, IHasNamedFiles
+    {
+        /// <summary>
+        /// The file extension for exports (including the leading '.').
+        /// </summary>
+        protected abstract string FileExtension { get; }
+
+        protected readonly IModelManager<TModel> Manager;
+
+        protected readonly Storage UserFileStorage;
+
+        private readonly Storage exportStorage;
+
+        protected LegacyExporter(Storage storage, IModelManager<TModel> manager)
+        {
+            Manager = manager;
+
+            exportStorage = storage.GetStorageForDirectory(@"exports");
+            UserFileStorage = storage.GetStorageForDirectory(@"files");
+        }
+
+        /// <summary>
+        /// Exports an item to a legacy (.zip based) package.
+        /// </summary>
+        /// <param name="item">The item to export.</param>
+        public void Export(TModel item)
+        {
+            string filename = $"{item.ToString().GetValidArchiveContentFilename()}{FileExtension}";
+
+            using (var stream = exportStorage.GetStream(filename, FileAccess.Write, FileMode.Create))
+                ExportModelTo(item, stream);
+
+            exportStorage.PresentFileExternally(filename);
+        }
+
+        /// <summary>
+        /// Exports an item to the given output stream.
+        /// </summary>
+        /// <param name="model">The item to export.</param>
+        /// <param name="outputStream">The output stream to export to.</param>
+        public virtual void ExportModelTo(TModel model, Stream outputStream)
+        {
+            using (var archive = ZipArchive.Create())
+            {
+                foreach (var file in model.Files)
+                    archive.AddEntry(file.Filename, UserFileStorage.GetStream(file.File.GetStoragePath()));
+
+                archive.SaveTo(outputStream);
+            }
+        }
+    }
+}
diff --git a/osu.Game/Database/LegacyScoreExporter.cs b/osu.Game/Database/LegacyScoreExporter.cs
new file mode 100644
index 0000000000..e4ddd5982b
--- /dev/null
+++ b/osu.Game/Database/LegacyScoreExporter.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 System.IO;
+using System.Linq;
+using osu.Framework.Platform;
+using osu.Game.Extensions;
+using osu.Game.Scoring;
+
+namespace osu.Game.Database
+{
+    public class LegacyScoreExporter : LegacyExporter<ScoreInfo>
+    {
+        protected override string FileExtension => ".osr";
+
+        public LegacyScoreExporter(Storage storage, IModelManager<ScoreInfo> manager)
+            : base(storage, manager)
+        {
+        }
+
+        public override void ExportModelTo(ScoreInfo model, Stream outputStream)
+        {
+            var file = model.Files.SingleOrDefault();
+            if (file == null)
+                return;
+
+            using (var inputStream = UserFileStorage.GetStream(file.FileInfo.GetStoragePath()))
+                inputStream.CopyTo(outputStream);
+        }
+    }
+}
diff --git a/osu.Game/Database/LegacySkinExporter.cs b/osu.Game/Database/LegacySkinExporter.cs
new file mode 100644
index 0000000000..f6d243315c
--- /dev/null
+++ b/osu.Game/Database/LegacySkinExporter.cs
@@ -0,0 +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 osu.Framework.Platform;
+using osu.Game.Skinning;
+
+namespace osu.Game.Database
+{
+    public class LegacySkinExporter : LegacyExporter<SkinInfo>
+    {
+        protected override string FileExtension => ".osk";
+
+        public LegacySkinExporter(Storage storage, IModelManager<SkinInfo> manager)
+            : base(storage, manager)
+        {
+        }
+    }
+}
diff --git a/osu.Game/Online/Leaderboards/LeaderboardScore.cs b/osu.Game/Online/Leaderboards/LeaderboardScore.cs
index f0c57cb953..06c0636d17 100644
--- a/osu.Game/Online/Leaderboards/LeaderboardScore.cs
+++ b/osu.Game/Online/Leaderboards/LeaderboardScore.cs
@@ -14,6 +14,8 @@ using osu.Framework.Graphics.Sprites;
 using osu.Framework.Graphics.UserInterface;
 using osu.Framework.Input.Events;
 using osu.Framework.Localisation;
+using osu.Framework.Platform;
+using osu.Game.Database;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
@@ -66,6 +68,9 @@ namespace osu.Game.Online.Leaderboards
         [Resolved]
         private ScoreManager scoreManager { get; set; }
 
+        [Resolved]
+        private Storage storage { get; set; }
+
         public LeaderboardScore(ScoreInfo score, int? rank, bool allowHighlight = true)
         {
             Score = score;
@@ -395,7 +400,7 @@ namespace osu.Game.Online.Leaderboards
                     items.Add(new OsuMenuItem("Use these mods", MenuItemType.Highlighted, () => songSelect.Mods.Value = Score.Mods));
 
                 if (Score.Files.Count > 0)
-                    items.Add(new OsuMenuItem("Export", MenuItemType.Standard, () => scoreManager.Export(Score)));
+                    items.Add(new OsuMenuItem("Export", MenuItemType.Standard, () => new LegacyScoreExporter(storage, scoreManager).Export(Score)));
 
                 if (Score.ID != 0)
                     items.Add(new OsuMenuItem("Delete", MenuItemType.Destructive, () => dialogOverlay?.Push(new LocalScoreDeleteDialog(Score))));
diff --git a/osu.Game/Overlays/Settings/Sections/SkinSection.cs b/osu.Game/Overlays/Settings/Sections/SkinSection.cs
index e7a7abed59..0eec6f5f77 100644
--- a/osu.Game/Overlays/Settings/Sections/SkinSection.cs
+++ b/osu.Game/Overlays/Settings/Sections/SkinSection.cs
@@ -11,7 +11,9 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Localisation;
 using osu.Framework.Logging;
+using osu.Framework.Platform;
 using osu.Game.Configuration;
+using osu.Game.Database;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Localisation;
 using osu.Game.Skinning;
@@ -167,6 +169,9 @@ namespace osu.Game.Overlays.Settings.Sections
             [Resolved]
             private SkinManager skins { get; set; }
 
+            [Resolved]
+            private Storage storage { get; set; }
+
             private Bindable<Skin> currentSkin;
 
             [BackgroundDependencyLoader]
@@ -183,7 +188,7 @@ namespace osu.Game.Overlays.Settings.Sections
             {
                 try
                 {
-                    skins.Export(currentSkin.Value.SkinInfo);
+                    new LegacySkinExporter(storage, skins).Export(currentSkin.Value.SkinInfo);
                 }
                 catch (Exception e)
                 {
diff --git a/osu.Game/Scoring/ScoreManager.cs b/osu.Game/Scoring/ScoreManager.cs
index d25671d77e..a89444408d 100644
--- a/osu.Game/Scoring/ScoreManager.cs
+++ b/osu.Game/Scoring/ScoreManager.cs
@@ -262,16 +262,6 @@ namespace osu.Game.Scoring
             remove => scoreModelManager.ItemRemoved -= value;
         }
 
-        public void Export(ScoreInfo item)
-        {
-            scoreModelManager.Export(item);
-        }
-
-        public void ExportModelTo(ScoreInfo model, Stream outputStream)
-        {
-            scoreModelManager.ExportModelTo(model, outputStream);
-        }
-
         public void Update(ScoreInfo item)
         {
             scoreModelManager.Update(item);
diff --git a/osu.Game/Scoring/ScoreModelManager.cs b/osu.Game/Scoring/ScoreModelManager.cs
index 9da739237b..2cbd3aded7 100644
--- a/osu.Game/Scoring/ScoreModelManager.cs
+++ b/osu.Game/Scoring/ScoreModelManager.cs
@@ -3,7 +3,6 @@
 
 using System;
 using System.Collections.Generic;
-using System.IO;
 using System.Linq;
 using System.Linq.Expressions;
 using System.Threading;
@@ -13,7 +12,6 @@ using osu.Framework.Logging;
 using osu.Framework.Platform;
 using osu.Game.Beatmaps;
 using osu.Game.Database;
-using osu.Game.Extensions;
 using osu.Game.IO.Archives;
 using osu.Game.Rulesets;
 using osu.Game.Scoring.Legacy;
@@ -69,15 +67,5 @@ namespace osu.Game.Scoring
         protected override bool CheckLocalAvailability(ScoreInfo model, IQueryable<ScoreInfo> items)
             => base.CheckLocalAvailability(model, items)
                || (model.OnlineScoreID != null && items.Any(i => i.OnlineScoreID == model.OnlineScoreID));
-
-        public override void ExportModelTo(ScoreInfo model, Stream outputStream)
-        {
-            var file = model.Files.SingleOrDefault();
-            if (file == null)
-                return;
-
-            using (var inputStream = Files.Storage.GetStream(file.FileInfo.GetStoragePath()))
-                inputStream.CopyTo(outputStream);
-        }
     }
 }
diff --git a/osu.Game/Screens/Edit/Editor.cs b/osu.Game/Screens/Edit/Editor.cs
index 94b6e58b67..46d84fe73d 100644
--- a/osu.Game/Screens/Edit/Editor.cs
+++ b/osu.Game/Screens/Edit/Editor.cs
@@ -16,9 +16,11 @@ using osu.Framework.Input;
 using osu.Framework.Input.Bindings;
 using osu.Framework.Input.Events;
 using osu.Framework.Logging;
+using osu.Framework.Platform;
 using osu.Framework.Screens;
 using osu.Game.Beatmaps;
 using osu.Game.Configuration;
+using osu.Game.Database;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Cursor;
 using osu.Game.Graphics.UserInterface;
@@ -63,6 +65,9 @@ namespace osu.Game.Screens.Edit
         [Resolved]
         private BeatmapManager beatmapManager { get; set; }
 
+        [Resolved]
+        private Storage storage { get; set; }
+
         [Resolved(canBeNull: true)]
         private DialogOverlay dialogOverlay { get; set; }
 
@@ -753,7 +758,7 @@ namespace osu.Game.Screens.Edit
         private void exportBeatmap()
         {
             Save();
-            beatmapManager.Export(Beatmap.Value.BeatmapSetInfo);
+            new LegacyBeatmapExporter(storage, beatmapManager).Export(Beatmap.Value.BeatmapSetInfo);
         }
 
         private void updateLastSavedHash()
diff --git a/osu.Game/Skinning/SkinManager.cs b/osu.Game/Skinning/SkinManager.cs
index 679b35799e..8d07dd046a 100644
--- a/osu.Game/Skinning/SkinManager.cs
+++ b/osu.Game/Skinning/SkinManager.cs
@@ -301,16 +301,6 @@ namespace osu.Game.Skinning
             remove => skinModelManager.ItemRemoved -= value;
         }
 
-        public void Export(SkinInfo item)
-        {
-            skinModelManager.Export(item);
-        }
-
-        public void ExportModelTo(SkinInfo model, Stream outputStream)
-        {
-            skinModelManager.ExportModelTo(model, outputStream);
-        }
-
         public void Update(SkinInfo item)
         {
             skinModelManager.Update(item);

From ec9a09d5a42a0a2818c369faf22e134802e73917 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 25 Nov 2021 16:56:19 +0900
Subject: [PATCH 1269/5547] Add missing licence headers

---
 osu.Game/Database/LegacyBeatmapImporter.cs | 3 +++
 osu.Game/Database/LegacyScoreImporter.cs   | 3 +++
 osu.Game/Database/LegacySkinImporter.cs    | 5 ++++-
 3 files changed, 10 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Database/LegacyBeatmapImporter.cs b/osu.Game/Database/LegacyBeatmapImporter.cs
index 041a692655..97f6eba6c2 100644
--- a/osu.Game/Database/LegacyBeatmapImporter.cs
+++ b/osu.Game/Database/LegacyBeatmapImporter.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 osu.Framework.Platform;
 using osu.Game.Beatmaps;
 using osu.Game.IO;
diff --git a/osu.Game/Database/LegacyScoreImporter.cs b/osu.Game/Database/LegacyScoreImporter.cs
index 984aa8a1ac..48445b7bdb 100644
--- a/osu.Game/Database/LegacyScoreImporter.cs
+++ b/osu.Game/Database/LegacyScoreImporter.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;
 using System.Collections.Generic;
 using System.IO;
diff --git a/osu.Game/Database/LegacySkinImporter.cs b/osu.Game/Database/LegacySkinImporter.cs
index b102e26bc6..2f05ccae45 100644
--- a/osu.Game/Database/LegacySkinImporter.cs
+++ b/osu.Game/Database/LegacySkinImporter.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 osu.Game.Skinning;
 
 namespace osu.Game.Database
@@ -11,4 +14,4 @@ namespace osu.Game.Database
         {
         }
     }
-}
\ No newline at end of file
+}

From 79459c1aebc968ac4821161399126075b6301c93 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 25 Nov 2021 17:12:15 +0900
Subject: [PATCH 1270/5547] Fix typo in class and variable names

---
 ...ImportManager.cs => LegacyImportManager.cs} |  2 +-
 osu.Game/OsuGame.cs                            |  4 ++--
 .../Sections/Maintenance/GeneralSettings.cs    | 18 +++++++++---------
 osu.Game/Screens/Select/SongSelect.cs          |  6 +++---
 4 files changed, 15 insertions(+), 15 deletions(-)
 rename osu.Game/Database/{LeagcyImportManager.cs => LegacyImportManager.cs} (98%)

diff --git a/osu.Game/Database/LeagcyImportManager.cs b/osu.Game/Database/LegacyImportManager.cs
similarity index 98%
rename from osu.Game/Database/LeagcyImportManager.cs
rename to osu.Game/Database/LegacyImportManager.cs
index 8ee63429e2..4dc26b18bb 100644
--- a/osu.Game/Database/LeagcyImportManager.cs
+++ b/osu.Game/Database/LegacyImportManager.cs
@@ -22,7 +22,7 @@ namespace osu.Game.Database
     /// <summary>
     /// Handles migration of legacy user data from osu-stable.
     /// </summary>
-    public class LeagcyImportManager : Component
+    public class LegacyImportManager : Component
     {
         [Resolved]
         private SkinManager skins { get; set; }
diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index 9b9ec585e8..0e050304f0 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -116,7 +116,7 @@ namespace osu.Game
         private readonly DifficultyRecommender difficultyRecommender = new DifficultyRecommender();
 
         [Cached]
-        private readonly LeagcyImportManager leagcyImportManager = new LeagcyImportManager();
+        private readonly LegacyImportManager legacyImportManager = new LegacyImportManager();
 
         [Cached]
         private readonly ScreenshotManager screenshotManager = new ScreenshotManager();
@@ -782,7 +782,7 @@ namespace osu.Game
                 PostNotification = n => Notifications.Post(n),
             }, Add, true);
 
-            loadComponentSingleFile(leagcyImportManager, Add);
+            loadComponentSingleFile(legacyImportManager, Add);
 
             loadComponentSingleFile(screenshotManager, Add);
 
diff --git a/osu.Game/Overlays/Settings/Sections/Maintenance/GeneralSettings.cs b/osu.Game/Overlays/Settings/Sections/Maintenance/GeneralSettings.cs
index 9dfd0d8ff4..5bc89ec77c 100644
--- a/osu.Game/Overlays/Settings/Sections/Maintenance/GeneralSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Maintenance/GeneralSettings.cs
@@ -31,9 +31,9 @@ namespace osu.Game.Overlays.Settings.Sections.Maintenance
         private SettingsButton undeleteButton;
 
         [BackgroundDependencyLoader(permitNulls: true)]
-        private void load(BeatmapManager beatmaps, ScoreManager scores, SkinManager skins, [CanBeNull] CollectionManager collectionManager, [CanBeNull] LeagcyImportManager leagcyImportManager, DialogOverlay dialogOverlay)
+        private void load(BeatmapManager beatmaps, ScoreManager scores, SkinManager skins, [CanBeNull] CollectionManager collectionManager, [CanBeNull] LegacyImportManager legacyImportManager, DialogOverlay dialogOverlay)
         {
-            if (leagcyImportManager?.SupportsImportFromStable == true)
+            if (legacyImportManager?.SupportsImportFromStable == true)
             {
                 Add(importBeatmapsButton = new SettingsButton
                 {
@@ -41,7 +41,7 @@ namespace osu.Game.Overlays.Settings.Sections.Maintenance
                     Action = () =>
                     {
                         importBeatmapsButton.Enabled.Value = false;
-                        leagcyImportManager.ImportFromStableAsync(StableContent.Beatmaps).ContinueWith(t => Schedule(() => importBeatmapsButton.Enabled.Value = true));
+                        legacyImportManager.ImportFromStableAsync(StableContent.Beatmaps).ContinueWith(t => Schedule(() => importBeatmapsButton.Enabled.Value = true));
                     }
                 });
             }
@@ -59,7 +59,7 @@ namespace osu.Game.Overlays.Settings.Sections.Maintenance
                 }
             });
 
-            if (leagcyImportManager?.SupportsImportFromStable == true)
+            if (legacyImportManager?.SupportsImportFromStable == true)
             {
                 Add(importScoresButton = new SettingsButton
                 {
@@ -67,7 +67,7 @@ namespace osu.Game.Overlays.Settings.Sections.Maintenance
                     Action = () =>
                     {
                         importScoresButton.Enabled.Value = false;
-                        leagcyImportManager.ImportFromStableAsync(StableContent.Scores).ContinueWith(t => Schedule(() => importScoresButton.Enabled.Value = true));
+                        legacyImportManager.ImportFromStableAsync(StableContent.Scores).ContinueWith(t => Schedule(() => importScoresButton.Enabled.Value = true));
                     }
                 });
             }
@@ -85,7 +85,7 @@ namespace osu.Game.Overlays.Settings.Sections.Maintenance
                 }
             });
 
-            if (leagcyImportManager?.SupportsImportFromStable == true)
+            if (legacyImportManager?.SupportsImportFromStable == true)
             {
                 Add(importSkinsButton = new SettingsButton
                 {
@@ -93,7 +93,7 @@ namespace osu.Game.Overlays.Settings.Sections.Maintenance
                     Action = () =>
                     {
                         importSkinsButton.Enabled.Value = false;
-                        leagcyImportManager.ImportFromStableAsync(StableContent.Skins).ContinueWith(t => Schedule(() => importSkinsButton.Enabled.Value = true));
+                        legacyImportManager.ImportFromStableAsync(StableContent.Skins).ContinueWith(t => Schedule(() => importSkinsButton.Enabled.Value = true));
                     }
                 });
             }
@@ -113,7 +113,7 @@ namespace osu.Game.Overlays.Settings.Sections.Maintenance
 
             if (collectionManager != null)
             {
-                if (leagcyImportManager?.SupportsImportFromStable == true)
+                if (legacyImportManager?.SupportsImportFromStable == true)
                 {
                     Add(importCollectionsButton = new SettingsButton
                     {
@@ -121,7 +121,7 @@ namespace osu.Game.Overlays.Settings.Sections.Maintenance
                         Action = () =>
                         {
                             importCollectionsButton.Enabled.Value = false;
-                            leagcyImportManager.ImportFromStableAsync(StableContent.Collections).ContinueWith(t => Schedule(() => importCollectionsButton.Enabled.Value = true));
+                            legacyImportManager.ImportFromStableAsync(StableContent.Collections).ContinueWith(t => Schedule(() => importCollectionsButton.Enabled.Value = true));
                         }
                     });
                 }
diff --git a/osu.Game/Screens/Select/SongSelect.cs b/osu.Game/Screens/Select/SongSelect.cs
index b6933a9830..25efe22892 100644
--- a/osu.Game/Screens/Select/SongSelect.cs
+++ b/osu.Game/Screens/Select/SongSelect.cs
@@ -51,7 +51,7 @@ namespace osu.Game.Screens.Select
 
         protected virtual bool ShowFooter => true;
 
-        protected virtual bool DisplayStableImportPrompt => leagcyImportManager?.SupportsImportFromStable == true;
+        protected virtual bool DisplayStableImportPrompt => legacyImportManager?.SupportsImportFromStable == true;
 
         public override bool? AllowTrackAdjustments => true;
 
@@ -90,7 +90,7 @@ namespace osu.Game.Screens.Select
         private BeatmapManager beatmaps { get; set; }
 
         [Resolved(CanBeNull = true)]
-        private LeagcyImportManager leagcyImportManager { get; set; }
+        private LegacyImportManager legacyImportManager { get; set; }
 
         protected ModSelectOverlay ModSelect { get; private set; }
 
@@ -297,7 +297,7 @@ namespace osu.Game.Screens.Select
                     {
                         dialogOverlay.Push(new ImportFromStablePopup(() =>
                         {
-                            Task.Run(() => leagcyImportManager.ImportFromStableAsync(StableContent.All));
+                            Task.Run(() => legacyImportManager.ImportFromStableAsync(StableContent.All));
                         }));
                     }
                 });

From 716543b5b3ba8bb467da72ae059a153fc449a813 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 25 Nov 2021 17:23:46 +0900
Subject: [PATCH 1271/5547] Move beatmap download logic out of `BeatmapManager`

---
 ...ager.cs => TestSceneBeatmapDownloading.cs} |  6 +--
 ...eneOnlinePlayBeatmapAvailabilityTracker.cs | 35 ++++++++----------
 osu.Game/Beatmaps/BeatmapManager.cs           | 37 +------------------
 .../Drawables/Cards/Buttons/DownloadButton.cs |  2 +-
 osu.Game/Online/BeatmapDownloadTracker.cs     | 19 +++++++---
 osu.Game/OsuGame.cs                           |  1 +
 osu.Game/OsuGameBase.cs                       |  3 ++
 .../Panels/BeatmapPanelDownloadButton.cs      |  2 +-
 .../Buttons/HeaderDownloadButton.cs           |  2 +-
 osu.Game/Screens/Play/SoloSpectator.cs        |  5 ++-
 10 files changed, 45 insertions(+), 67 deletions(-)
 rename osu.Game.Tests/Online/{TestSceneBeatmapManager.cs => TestSceneBeatmapDownloading.cs} (94%)

diff --git a/osu.Game.Tests/Online/TestSceneBeatmapManager.cs b/osu.Game.Tests/Online/TestSceneBeatmapDownloading.cs
similarity index 94%
rename from osu.Game.Tests/Online/TestSceneBeatmapManager.cs
rename to osu.Game.Tests/Online/TestSceneBeatmapDownloading.cs
index fc1b4f224d..4e77973655 100644
--- a/osu.Game.Tests/Online/TestSceneBeatmapManager.cs
+++ b/osu.Game.Tests/Online/TestSceneBeatmapDownloading.cs
@@ -12,9 +12,9 @@ using osu.Game.Tests.Visual;
 namespace osu.Game.Tests.Online
 {
     [HeadlessTest]
-    public class TestSceneBeatmapManager : OsuTestScene
+    public class TestSceneBeatmapDownloading : OsuTestScene
     {
-        private BeatmapManager beatmaps;
+        private BeatmapModelDownloader beatmaps;
         private ProgressNotification recentNotification;
 
         private static readonly BeatmapSetInfo test_db_model = new BeatmapSetInfo
@@ -43,7 +43,7 @@ namespace osu.Game.Tests.Online
         };
 
         [BackgroundDependencyLoader]
-        private void load(BeatmapManager beatmaps)
+        private void load(BeatmapModelDownloader beatmaps)
         {
             this.beatmaps = beatmaps;
 
diff --git a/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs b/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
index a4c69075be..f5d57240ca 100644
--- a/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
+++ b/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
@@ -33,6 +33,7 @@ namespace osu.Game.Tests.Online
     {
         private RulesetStore rulesets;
         private TestBeatmapManager beatmaps;
+        private TestBeatmapModelDownloader beatmapDownloader;
 
         private string testBeatmapFile;
         private BeatmapInfo testBeatmapInfo;
@@ -46,6 +47,7 @@ namespace osu.Game.Tests.Online
         {
             Dependencies.Cache(rulesets = new RulesetStore(ContextFactory));
             Dependencies.CacheAs<BeatmapManager>(beatmaps = new TestBeatmapManager(LocalStorage, ContextFactory, rulesets, API, audio, Resources, host, Beatmap.Default));
+            Dependencies.CacheAs<BeatmapModelDownloader>(beatmapDownloader = new TestBeatmapModelDownloader(beatmaps, API, host));
         }
 
         [SetUp]
@@ -80,13 +82,13 @@ namespace osu.Game.Tests.Online
             AddAssert("ensure beatmap unavailable", () => !beatmaps.IsAvailableLocally(testBeatmapSet));
             addAvailabilityCheckStep("state not downloaded", BeatmapAvailability.NotDownloaded);
 
-            AddStep("start downloading", () => beatmaps.Download(testBeatmapSet));
+            AddStep("start downloading", () => beatmapDownloader.Download(testBeatmapSet));
             addAvailabilityCheckStep("state downloading 0%", () => BeatmapAvailability.Downloading(0.0f));
 
-            AddStep("set progress 40%", () => ((TestDownloadRequest)beatmaps.GetExistingDownload(testBeatmapSet)).SetProgress(0.4f));
+            AddStep("set progress 40%", () => ((TestDownloadRequest)beatmapDownloader.GetExistingDownload(testBeatmapSet)).SetProgress(0.4f));
             addAvailabilityCheckStep("state downloading 40%", () => BeatmapAvailability.Downloading(0.4f));
 
-            AddStep("finish download", () => ((TestDownloadRequest)beatmaps.GetExistingDownload(testBeatmapSet)).TriggerSuccess(testBeatmapFile));
+            AddStep("finish download", () => ((TestDownloadRequest)beatmapDownloader.GetExistingDownload(testBeatmapSet)).TriggerSuccess(testBeatmapFile));
             addAvailabilityCheckStep("state importing", BeatmapAvailability.Importing);
 
             AddStep("allow importing", () => beatmaps.AllowImport.SetResult(true));
@@ -171,22 +173,6 @@ namespace osu.Game.Tests.Online
                 return new TestBeatmapModelManager(this, storage, contextFactory, rulesets, api, host);
             }
 
-            protected override BeatmapModelDownloader CreateBeatmapModelDownloader(IModelImporter<BeatmapSetInfo> manager, IAPIProvider api, GameHost host)
-            {
-                return new TestBeatmapModelDownloader(manager, api, host);
-            }
-
-            internal class TestBeatmapModelDownloader : BeatmapModelDownloader
-            {
-                public TestBeatmapModelDownloader(IModelImporter<BeatmapSetInfo> importer, IAPIProvider apiProvider, GameHost gameHost)
-                    : base(importer, apiProvider, gameHost)
-                {
-                }
-
-                protected override ArchiveDownloadRequest<IBeatmapSetInfo> CreateDownloadRequest(IBeatmapSetInfo set, bool minimiseDownloadSize)
-                    => new TestDownloadRequest(set);
-            }
-
             internal class TestBeatmapModelManager : BeatmapModelManager
             {
                 private readonly TestBeatmapManager testBeatmapManager;
@@ -205,6 +191,17 @@ namespace osu.Game.Tests.Online
             }
         }
 
+        internal class TestBeatmapModelDownloader : BeatmapModelDownloader
+        {
+            public TestBeatmapModelDownloader(IModelImporter<BeatmapSetInfo> importer, IAPIProvider apiProvider, GameHost gameHost)
+                : base(importer, apiProvider, gameHost)
+            {
+            }
+
+            protected override ArchiveDownloadRequest<IBeatmapSetInfo> CreateDownloadRequest(IBeatmapSetInfo set, bool minimiseDownloadSize)
+                => new TestDownloadRequest(set);
+        }
+
         private class TestDownloadRequest : ArchiveDownloadRequest<IBeatmapSetInfo>
         {
             public new void SetProgress(float progress) => base.SetProgress(progress);
diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index 0594cd1316..179d479b53 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -29,12 +29,11 @@ namespace osu.Game.Beatmaps
     /// Handles general operations related to global beatmap management.
     /// </summary>
     [ExcludeFromDynamicCompile]
-    public class BeatmapManager : IModelDownloader<IBeatmapSetInfo>, IModelManager<BeatmapSetInfo>, IModelFileManager<BeatmapSetInfo, BeatmapSetFileInfo>, IModelImporter<BeatmapSetInfo>, IWorkingBeatmapCache, IDisposable
+    public class BeatmapManager : IModelManager<BeatmapSetInfo>, IModelFileManager<BeatmapSetInfo, BeatmapSetFileInfo>, IModelImporter<BeatmapSetInfo>, IWorkingBeatmapCache, IDisposable
     {
         public ITrackStore BeatmapTrackStore { get; }
 
         private readonly BeatmapModelManager beatmapModelManager;
-        private readonly BeatmapModelDownloader beatmapModelDownloader;
 
         private readonly WorkingBeatmapCache workingBeatmapCache;
         private readonly BeatmapOnlineLookupQueue onlineBeatmapLookupQueue;
@@ -46,7 +45,6 @@ namespace osu.Game.Beatmaps
             BeatmapTrackStore = audioManager.GetTrackStore(userResources);
 
             beatmapModelManager = CreateBeatmapModelManager(storage, contextFactory, rulesets, api, host);
-            beatmapModelDownloader = CreateBeatmapModelDownloader(beatmapModelManager, api, host);
             workingBeatmapCache = CreateWorkingBeatmapCache(audioManager, gameResources, userResources, defaultBeatmap, host);
 
             workingBeatmapCache.BeatmapManager = beatmapModelManager;
@@ -59,11 +57,6 @@ namespace osu.Game.Beatmaps
             }
         }
 
-        protected virtual BeatmapModelDownloader CreateBeatmapModelDownloader(IModelImporter<BeatmapSetInfo> modelManager, IAPIProvider api, GameHost host)
-        {
-            return new BeatmapModelDownloader(modelManager, api, host);
-        }
-
         protected virtual WorkingBeatmapCache CreateWorkingBeatmapCache(AudioManager audioManager, IResourceStore<byte[]> resources, IResourceStore<byte[]> storage, WorkingBeatmap defaultBeatmap, GameHost host)
         {
             return new WorkingBeatmapCache(BeatmapTrackStore, audioManager, resources, storage, defaultBeatmap, host);
@@ -185,11 +178,7 @@ namespace osu.Game.Beatmaps
         /// </summary>
         public Action<Notification> PostNotification
         {
-            set
-            {
-                beatmapModelManager.PostNotification = value;
-                beatmapModelDownloader.PostNotification = value;
-            }
+            set => beatmapModelManager.PostNotification = value;
         }
 
         /// <summary>
@@ -267,28 +256,6 @@ namespace osu.Game.Beatmaps
 
         #endregion
 
-        #region Implementation of IModelDownloader<BeatmapSetInfo>
-
-        public event Action<ArchiveDownloadRequest<IBeatmapSetInfo>> DownloadBegan
-        {
-            add => beatmapModelDownloader.DownloadBegan += value;
-            remove => beatmapModelDownloader.DownloadBegan -= value;
-        }
-
-        public event Action<ArchiveDownloadRequest<IBeatmapSetInfo>> DownloadFailed
-        {
-            add => beatmapModelDownloader.DownloadFailed += value;
-            remove => beatmapModelDownloader.DownloadFailed -= value;
-        }
-
-        public bool Download(IBeatmapSetInfo model, bool minimiseDownloadSize = false) =>
-            beatmapModelDownloader.Download(model, minimiseDownloadSize);
-
-        public ArchiveDownloadRequest<IBeatmapSetInfo> GetExistingDownload(IBeatmapSetInfo model) =>
-            beatmapModelDownloader.GetExistingDownload(model);
-
-        #endregion
-
         #region Implementation of ICanAcceptFiles
 
         public Task Import(params string[] paths)
diff --git a/osu.Game/Beatmaps/Drawables/Cards/Buttons/DownloadButton.cs b/osu.Game/Beatmaps/Drawables/Cards/Buttons/DownloadButton.cs
index 7430fce1c8..1a514c8d36 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/Buttons/DownloadButton.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/Buttons/DownloadButton.cs
@@ -24,7 +24,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards.Buttons
         private Bindable<bool> preferNoVideo = null!;
 
         [Resolved]
-        private BeatmapManager beatmaps { get; set; } = null!;
+        private BeatmapModelDownloader beatmaps { get; set; } = null!;
 
         public DownloadButton(APIBeatmapSet beatmapSet)
         {
diff --git a/osu.Game/Online/BeatmapDownloadTracker.cs b/osu.Game/Online/BeatmapDownloadTracker.cs
index 77a8fca1e4..509d5c1b71 100644
--- a/osu.Game/Online/BeatmapDownloadTracker.cs
+++ b/osu.Game/Online/BeatmapDownloadTracker.cs
@@ -15,6 +15,9 @@ namespace osu.Game.Online
         [Resolved(CanBeNull = true)]
         protected BeatmapManager? Manager { get; private set; }
 
+        [Resolved(CanBeNull = true)]
+        protected BeatmapModelDownloader? Downloader { get; private set; }
+
         private ArchiveDownloadRequest<IBeatmapSetInfo>? attachedRequest;
 
         public BeatmapDownloadTracker(IBeatmapSetInfo trackedItem)
@@ -25,7 +28,7 @@ namespace osu.Game.Online
         [BackgroundDependencyLoader(true)]
         private void load()
         {
-            if (Manager == null)
+            if (Manager == null || Downloader == null)
                 return;
 
             // Used to interact with manager classes that don't support interface types. Will eventually be replaced.
@@ -34,10 +37,10 @@ namespace osu.Game.Online
             if (Manager.IsAvailableLocally(beatmapSetInfo))
                 UpdateState(DownloadState.LocallyAvailable);
             else
-                attachDownload(Manager.GetExistingDownload(beatmapSetInfo));
+                attachDownload(Downloader.GetExistingDownload(beatmapSetInfo));
 
-            Manager.DownloadBegan += downloadBegan;
-            Manager.DownloadFailed += downloadFailed;
+            Downloader.DownloadBegan += downloadBegan;
+            Downloader.DownloadFailed += downloadFailed;
             Manager.ItemUpdated += itemUpdated;
             Manager.ItemRemoved += itemRemoved;
         }
@@ -115,10 +118,14 @@ namespace osu.Game.Online
             base.Dispose(isDisposing);
             attachDownload(null);
 
+            if (Downloader != null)
+            {
+                Downloader.DownloadBegan -= downloadBegan;
+                Downloader.DownloadFailed -= downloadFailed;
+            }
+
             if (Manager != null)
             {
-                Manager.DownloadBegan -= downloadBegan;
-                Manager.DownloadFailed -= downloadFailed;
                 Manager.ItemUpdated -= itemUpdated;
                 Manager.ItemRemoved -= itemRemoved;
             }
diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index 574a5e5393..1060724680 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -656,6 +656,7 @@ namespace osu.Game
             BeatmapManager.PostNotification = n => Notifications.Post(n);
             BeatmapManager.PostImport = items => PresentBeatmap(items.First().Value);
 
+            BeatmapDownloader.PostNotification = n => Notifications.Post(n);
             ScoreManager.PostNotification = n => Notifications.Post(n);
             ScoreManager.PostImport = items => PresentScore(items.First().Value);
 
diff --git a/osu.Game/OsuGameBase.cs b/osu.Game/OsuGameBase.cs
index dd4ae590c7..a64d9ac01a 100644
--- a/osu.Game/OsuGameBase.cs
+++ b/osu.Game/OsuGameBase.cs
@@ -96,6 +96,8 @@ namespace osu.Game
 
         protected BeatmapManager BeatmapManager { get; private set; }
 
+        protected BeatmapModelDownloader BeatmapDownloader { get; private set; }
+
         protected ScoreManager ScoreManager { get; private set; }
 
         protected SkinManager SkinManager { get; private set; }
@@ -235,6 +237,7 @@ namespace osu.Game
             dependencies.Cache(ScoreManager = new ScoreManager(RulesetStore, () => BeatmapManager, Storage, API, contextFactory, Scheduler, Host, () => difficultyCache, LocalConfig));
             dependencies.Cache(BeatmapManager = new BeatmapManager(Storage, contextFactory, RulesetStore, API, Audio, Resources, Host, defaultBeatmap, performOnlineLookups: true));
 
+            dependencies.Cache(BeatmapDownloader = new BeatmapModelDownloader(BeatmapManager, API, Host));
             // the following realm components are not actively used yet, but initialised and kept up to date for initial testing.
             realmRulesetStore = new RealmRulesetStore(realmFactory, Storage);
 
diff --git a/osu.Game/Overlays/BeatmapListing/Panels/BeatmapPanelDownloadButton.cs b/osu.Game/Overlays/BeatmapListing/Panels/BeatmapPanelDownloadButton.cs
index 1282a14c3d..0a66c3ccb7 100644
--- a/osu.Game/Overlays/BeatmapListing/Panels/BeatmapPanelDownloadButton.cs
+++ b/osu.Game/Overlays/BeatmapListing/Panels/BeatmapPanelDownloadButton.cs
@@ -65,7 +65,7 @@ namespace osu.Game.Overlays.BeatmapListing.Panels
         }
 
         [BackgroundDependencyLoader(true)]
-        private void load(OsuGame game, BeatmapManager beatmaps, OsuConfigManager osuConfig)
+        private void load(OsuGame game, BeatmapModelDownloader beatmaps, OsuConfigManager osuConfig)
         {
             noVideoSetting = osuConfig.GetBindable<bool>(OsuSetting.PreferNoVideo);
 
diff --git a/osu.Game/Overlays/BeatmapSet/Buttons/HeaderDownloadButton.cs b/osu.Game/Overlays/BeatmapSet/Buttons/HeaderDownloadButton.cs
index ee40f114d2..4eed8f28f2 100644
--- a/osu.Game/Overlays/BeatmapSet/Buttons/HeaderDownloadButton.cs
+++ b/osu.Game/Overlays/BeatmapSet/Buttons/HeaderDownloadButton.cs
@@ -51,7 +51,7 @@ namespace osu.Game.Overlays.BeatmapSet.Buttons
         }
 
         [BackgroundDependencyLoader]
-        private void load(IAPIProvider api, BeatmapManager beatmaps)
+        private void load(IAPIProvider api, BeatmapModelDownloader beatmaps)
         {
             FillFlowContainer textSprites;
 
diff --git a/osu.Game/Screens/Play/SoloSpectator.cs b/osu.Game/Screens/Play/SoloSpectator.cs
index c65d4af2ae..5ecdb91718 100644
--- a/osu.Game/Screens/Play/SoloSpectator.cs
+++ b/osu.Game/Screens/Play/SoloSpectator.cs
@@ -49,6 +49,9 @@ namespace osu.Game.Screens.Play
         [Resolved]
         private BeatmapManager beatmaps { get; set; }
 
+        [Resolved]
+        private BeatmapModelDownloader beatmapDownloader { get; set; }
+
         private Container beatmapPanelContainer;
         private TriangleButton watchButton;
         private SettingsCheckbox automaticDownload;
@@ -244,7 +247,7 @@ namespace osu.Game.Screens.Play
             if (beatmaps.IsAvailableLocally(new BeatmapSetInfo { OnlineID = beatmapSet.OnlineID }))
                 return;
 
-            beatmaps.Download(beatmapSet);
+            beatmapDownloader.Download(beatmapSet);
         }
 
         public override bool OnExiting(IScreen next)

From a2ab9f457d8c883d8a302befd7a3a78241d89174 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 25 Nov 2021 17:21:05 +0900
Subject: [PATCH 1272/5547] Move score download logic out of `ScoreManager`

---
 .../SongSelect/TestSceneBeatmapLeaderboard.cs |  2 +-
 .../TestSceneDeleteLocalScore.cs              |  2 +-
 osu.Game/Online/ScoreDownloadTracker.cs       | 19 +++++++---
 osu.Game/OsuGame.cs                           |  2 +
 osu.Game/OsuGameBase.cs                       |  6 ++-
 osu.Game/Scoring/ScoreManager.cs              | 37 ++-----------------
 .../Screens/Ranking/ReplayDownloadButton.cs   |  4 +-
 7 files changed, 27 insertions(+), 45 deletions(-)

diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
index 2a2df777f7..aa36bde030 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
@@ -42,7 +42,7 @@ namespace osu.Game.Tests.Visual.SongSelect
 
             dependencies.Cache(rulesetStore = new RulesetStore(ContextFactory));
             dependencies.Cache(beatmapManager = new BeatmapManager(LocalStorage, ContextFactory, rulesetStore, null, dependencies.Get<AudioManager>(), Resources, dependencies.Get<GameHost>(), Beatmap.Default));
-            dependencies.Cache(scoreManager = new ScoreManager(rulesetStore, () => beatmapManager, LocalStorage, null, ContextFactory, Scheduler));
+            dependencies.Cache(scoreManager = new ScoreManager(rulesetStore, () => beatmapManager, LocalStorage, ContextFactory, Scheduler));
 
             return dependencies;
         }
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
index 7353e47229..9f0f4a6b8b 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
@@ -83,7 +83,7 @@ namespace osu.Game.Tests.Visual.UserInterface
 
             dependencies.Cache(rulesetStore = new RulesetStore(ContextFactory));
             dependencies.Cache(beatmapManager = new BeatmapManager(LocalStorage, ContextFactory, rulesetStore, null, dependencies.Get<AudioManager>(), Resources, dependencies.Get<GameHost>(), Beatmap.Default));
-            dependencies.Cache(scoreManager = new ScoreManager(rulesetStore, () => beatmapManager, LocalStorage, null, ContextFactory, Scheduler));
+            dependencies.Cache(scoreManager = new ScoreManager(rulesetStore, () => beatmapManager, LocalStorage, ContextFactory, Scheduler));
 
             beatmapInfo = beatmapManager.Import(new ImportTask(TestResources.GetQuickTestBeatmapForImport())).Result.Value.Beatmaps[0];
 
diff --git a/osu.Game/Online/ScoreDownloadTracker.cs b/osu.Game/Online/ScoreDownloadTracker.cs
index 32307fc50e..e09cc7c9cd 100644
--- a/osu.Game/Online/ScoreDownloadTracker.cs
+++ b/osu.Game/Online/ScoreDownloadTracker.cs
@@ -15,6 +15,9 @@ namespace osu.Game.Online
         [Resolved(CanBeNull = true)]
         protected ScoreManager? Manager { get; private set; }
 
+        [Resolved(CanBeNull = true)]
+        protected ScoreModelDownloader? Downloader { get; private set; }
+
         private ArchiveDownloadRequest<IScoreInfo>? attachedRequest;
 
         public ScoreDownloadTracker(ScoreInfo trackedItem)
@@ -25,7 +28,7 @@ namespace osu.Game.Online
         [BackgroundDependencyLoader(true)]
         private void load()
         {
-            if (Manager == null)
+            if (Manager == null || Downloader == null)
                 return;
 
             // Used to interact with manager classes that don't support interface types. Will eventually be replaced.
@@ -38,10 +41,10 @@ namespace osu.Game.Online
             if (Manager.IsAvailableLocally(scoreInfo))
                 UpdateState(DownloadState.LocallyAvailable);
             else
-                attachDownload(Manager.GetExistingDownload(scoreInfo));
+                attachDownload(Downloader.GetExistingDownload(scoreInfo));
 
-            Manager.DownloadBegan += downloadBegan;
-            Manager.DownloadFailed += downloadFailed;
+            Downloader.DownloadBegan += downloadBegan;
+            Downloader.DownloadFailed += downloadFailed;
             Manager.ItemUpdated += itemUpdated;
             Manager.ItemRemoved += itemRemoved;
         }
@@ -119,10 +122,14 @@ namespace osu.Game.Online
             base.Dispose(isDisposing);
             attachDownload(null);
 
+            if (Downloader != null)
+            {
+                Downloader.DownloadBegan -= downloadBegan;
+                Downloader.DownloadFailed -= downloadFailed;
+            }
+
             if (Manager != null)
             {
-                Manager.DownloadBegan -= downloadBegan;
-                Manager.DownloadFailed -= downloadFailed;
                 Manager.ItemUpdated -= itemUpdated;
                 Manager.ItemRemoved -= itemRemoved;
             }
diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index 1060724680..aa9bdac756 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -657,6 +657,8 @@ namespace osu.Game
             BeatmapManager.PostImport = items => PresentBeatmap(items.First().Value);
 
             BeatmapDownloader.PostNotification = n => Notifications.Post(n);
+            ScoreDownloader.PostNotification = n => Notifications.Post(n);
+
             ScoreManager.PostNotification = n => Notifications.Post(n);
             ScoreManager.PostImport = items => PresentScore(items.First().Value);
 
diff --git a/osu.Game/OsuGameBase.cs b/osu.Game/OsuGameBase.cs
index a64d9ac01a..c0594231df 100644
--- a/osu.Game/OsuGameBase.cs
+++ b/osu.Game/OsuGameBase.cs
@@ -100,6 +100,8 @@ namespace osu.Game
 
         protected ScoreManager ScoreManager { get; private set; }
 
+        protected ScoreModelDownloader ScoreDownloader { get; private set; }
+
         protected SkinManager SkinManager { get; private set; }
 
         protected RulesetStore RulesetStore { get; private set; }
@@ -234,10 +236,12 @@ namespace osu.Game
             dependencies.Cache(fileStore = new FileStore(contextFactory, Storage));
 
             // ordering is important here to ensure foreign keys rules are not broken in ModelStore.Cleanup()
-            dependencies.Cache(ScoreManager = new ScoreManager(RulesetStore, () => BeatmapManager, Storage, API, contextFactory, Scheduler, Host, () => difficultyCache, LocalConfig));
+            dependencies.Cache(ScoreManager = new ScoreManager(RulesetStore, () => BeatmapManager, Storage, contextFactory, Scheduler, Host, () => difficultyCache, LocalConfig));
             dependencies.Cache(BeatmapManager = new BeatmapManager(Storage, contextFactory, RulesetStore, API, Audio, Resources, Host, defaultBeatmap, performOnlineLookups: true));
 
             dependencies.Cache(BeatmapDownloader = new BeatmapModelDownloader(BeatmapManager, API, Host));
+            dependencies.Cache(ScoreDownloader = new ScoreModelDownloader(ScoreManager, API, Host));
+
             // the following realm components are not actively used yet, but initialised and kept up to date for initial testing.
             realmRulesetStore = new RealmRulesetStore(realmFactory, Storage);
 
diff --git a/osu.Game/Scoring/ScoreManager.cs b/osu.Game/Scoring/ScoreManager.cs
index abc0bfdda7..8d9733669c 100644
--- a/osu.Game/Scoring/ScoreManager.cs
+++ b/osu.Game/Scoring/ScoreManager.cs
@@ -17,7 +17,6 @@ using osu.Game.Configuration;
 using osu.Game.Database;
 using osu.Game.IO;
 using osu.Game.IO.Archives;
-using osu.Game.Online.API;
 using osu.Game.Overlays.Notifications;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Judgements;
@@ -25,15 +24,14 @@ using osu.Game.Rulesets.Scoring;
 
 namespace osu.Game.Scoring
 {
-    public class ScoreManager : IModelManager<ScoreInfo>, IModelImporter<ScoreInfo>, IModelDownloader<IScoreInfo>
+    public class ScoreManager : IModelManager<ScoreInfo>, IModelImporter<ScoreInfo>
     {
         private readonly Scheduler scheduler;
         private readonly Func<BeatmapDifficultyCache> difficulties;
         private readonly OsuConfigManager configManager;
         private readonly ScoreModelManager scoreModelManager;
-        private readonly ScoreModelDownloader scoreModelDownloader;
 
-        public ScoreManager(RulesetStore rulesets, Func<BeatmapManager> beatmaps, Storage storage, IAPIProvider api, IDatabaseContextFactory contextFactory, Scheduler scheduler,
+        public ScoreManager(RulesetStore rulesets, Func<BeatmapManager> beatmaps, Storage storage, IDatabaseContextFactory contextFactory, Scheduler scheduler,
                             IIpcHost importHost = null, Func<BeatmapDifficultyCache> difficulties = null, OsuConfigManager configManager = null)
         {
             this.scheduler = scheduler;
@@ -41,7 +39,6 @@ namespace osu.Game.Scoring
             this.configManager = configManager;
 
             scoreModelManager = new ScoreModelManager(rulesets, beatmaps, storage, contextFactory, importHost);
-            scoreModelDownloader = new ScoreModelDownloader(scoreModelManager, api, importHost);
         }
 
         public Score GetScore(ScoreInfo score) => scoreModelManager.GetScore(score);
@@ -240,11 +237,7 @@ namespace osu.Game.Scoring
 
         public Action<Notification> PostNotification
         {
-            set
-            {
-                scoreModelManager.PostNotification = value;
-                scoreModelDownloader.PostNotification = value;
-            }
+            set => scoreModelManager.PostNotification = value;
         }
 
         #endregion
@@ -342,30 +335,6 @@ namespace osu.Game.Scoring
 
         #endregion
 
-        #region Implementation of IModelDownloader<IScoreInfo>
-
-        public event Action<ArchiveDownloadRequest<IScoreInfo>> DownloadBegan
-        {
-            add => scoreModelDownloader.DownloadBegan += value;
-            remove => scoreModelDownloader.DownloadBegan -= value;
-        }
-
-        public event Action<ArchiveDownloadRequest<IScoreInfo>> DownloadFailed
-        {
-            add => scoreModelDownloader.DownloadFailed += value;
-            remove => scoreModelDownloader.DownloadFailed -= value;
-        }
-
-        public bool Download(IScoreInfo model, bool minimiseDownloadSize) =>
-            scoreModelDownloader.Download(model, minimiseDownloadSize);
-
-        public ArchiveDownloadRequest<IScoreInfo> GetExistingDownload(IScoreInfo model)
-        {
-            return scoreModelDownloader.GetExistingDownload(model);
-        }
-
-        #endregion
-
         #region Implementation of IPresentImports<ScoreInfo>
 
         public Action<IEnumerable<ILive<ScoreInfo>>> PostImport
diff --git a/osu.Game/Screens/Ranking/ReplayDownloadButton.cs b/osu.Game/Screens/Ranking/ReplayDownloadButton.cs
index 66b3c973f5..6a74fdaf75 100644
--- a/osu.Game/Screens/Ranking/ReplayDownloadButton.cs
+++ b/osu.Game/Screens/Ranking/ReplayDownloadButton.cs
@@ -45,7 +45,7 @@ namespace osu.Game.Screens.Ranking
         }
 
         [BackgroundDependencyLoader(true)]
-        private void load(OsuGame game, ScoreManager scores)
+        private void load(OsuGame game, ScoreModelDownloader scores)
         {
             InternalChild = shakeContainer = new ShakeContainer
             {
@@ -65,7 +65,7 @@ namespace osu.Game.Screens.Ranking
                         break;
 
                     case DownloadState.NotDownloaded:
-                        scores.Download(Score.Value, false);
+                        scores.Download(Score.Value);
                         break;
 
                     case DownloadState.Importing:

From eeccf836ec04d2e3aac1fec93c15b48aa6672352 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 25 Nov 2021 17:42:41 +0900
Subject: [PATCH 1273/5547] Remove unnecessary `GameHost` parameter

---
 .../Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs  | 2 +-
 osu.Game/Beatmaps/BeatmapModelDownloader.cs                  | 5 ++---
 osu.Game/Database/ModelDownloader.cs                         | 3 +--
 osu.Game/OsuGameBase.cs                                      | 4 ++--
 osu.Game/Scoring/ScoreModelDownloader.cs                     | 5 ++---
 5 files changed, 8 insertions(+), 11 deletions(-)

diff --git a/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs b/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
index f5d57240ca..24824b1e23 100644
--- a/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
+++ b/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
@@ -194,7 +194,7 @@ namespace osu.Game.Tests.Online
         internal class TestBeatmapModelDownloader : BeatmapModelDownloader
         {
             public TestBeatmapModelDownloader(IModelImporter<BeatmapSetInfo> importer, IAPIProvider apiProvider, GameHost gameHost)
-                : base(importer, apiProvider, gameHost)
+                : base(importer, apiProvider)
             {
             }
 
diff --git a/osu.Game/Beatmaps/BeatmapModelDownloader.cs b/osu.Game/Beatmaps/BeatmapModelDownloader.cs
index a170edc9f8..d31730ca15 100644
--- a/osu.Game/Beatmaps/BeatmapModelDownloader.cs
+++ b/osu.Game/Beatmaps/BeatmapModelDownloader.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.Platform;
 using osu.Game.Database;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests;
@@ -16,8 +15,8 @@ namespace osu.Game.Beatmaps
         public override ArchiveDownloadRequest<IBeatmapSetInfo> GetExistingDownload(IBeatmapSetInfo model)
             => CurrentDownloads.Find(r => r.Model.OnlineID == model.OnlineID);
 
-        public BeatmapModelDownloader(IModelImporter<BeatmapSetInfo> beatmapImporter, IAPIProvider api, GameHost host = null)
-            : base(beatmapImporter, api, host)
+        public BeatmapModelDownloader(IModelImporter<BeatmapSetInfo> beatmapImporter, IAPIProvider api)
+            : base(beatmapImporter, api)
         {
         }
     }
diff --git a/osu.Game/Database/ModelDownloader.cs b/osu.Game/Database/ModelDownloader.cs
index 43ba62dfe0..362bc68cc1 100644
--- a/osu.Game/Database/ModelDownloader.cs
+++ b/osu.Game/Database/ModelDownloader.cs
@@ -7,7 +7,6 @@ using System.Linq;
 using System.Threading.Tasks;
 using Humanizer;
 using osu.Framework.Logging;
-using osu.Framework.Platform;
 using osu.Game.Extensions;
 using osu.Game.Online.API;
 using osu.Game.Overlays.Notifications;
@@ -29,7 +28,7 @@ namespace osu.Game.Database
 
         protected readonly List<ArchiveDownloadRequest<T>> CurrentDownloads = new List<ArchiveDownloadRequest<T>>();
 
-        protected ModelDownloader(IModelImporter<TModel> importer, IAPIProvider api, IIpcHost importHost = null)
+        protected ModelDownloader(IModelImporter<TModel> importer, IAPIProvider api)
         {
             this.importer = importer;
             this.api = api;
diff --git a/osu.Game/OsuGameBase.cs b/osu.Game/OsuGameBase.cs
index c0594231df..88c9ab370c 100644
--- a/osu.Game/OsuGameBase.cs
+++ b/osu.Game/OsuGameBase.cs
@@ -239,8 +239,8 @@ namespace osu.Game
             dependencies.Cache(ScoreManager = new ScoreManager(RulesetStore, () => BeatmapManager, Storage, contextFactory, Scheduler, Host, () => difficultyCache, LocalConfig));
             dependencies.Cache(BeatmapManager = new BeatmapManager(Storage, contextFactory, RulesetStore, API, Audio, Resources, Host, defaultBeatmap, performOnlineLookups: true));
 
-            dependencies.Cache(BeatmapDownloader = new BeatmapModelDownloader(BeatmapManager, API, Host));
-            dependencies.Cache(ScoreDownloader = new ScoreModelDownloader(ScoreManager, API, Host));
+            dependencies.Cache(BeatmapDownloader = new BeatmapModelDownloader(BeatmapManager, API));
+            dependencies.Cache(ScoreDownloader = new ScoreModelDownloader(ScoreManager, API));
 
             // the following realm components are not actively used yet, but initialised and kept up to date for initial testing.
             realmRulesetStore = new RealmRulesetStore(realmFactory, Storage);
diff --git a/osu.Game/Scoring/ScoreModelDownloader.cs b/osu.Game/Scoring/ScoreModelDownloader.cs
index 6c63e2aa71..038a4bc351 100644
--- a/osu.Game/Scoring/ScoreModelDownloader.cs
+++ b/osu.Game/Scoring/ScoreModelDownloader.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.Platform;
 using osu.Game.Database;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests;
@@ -10,8 +9,8 @@ namespace osu.Game.Scoring
 {
     public class ScoreModelDownloader : ModelDownloader<ScoreInfo, IScoreInfo>
     {
-        public ScoreModelDownloader(IModelImporter<ScoreInfo> scoreManager, IAPIProvider api, IIpcHost importHost = null)
-            : base(scoreManager, api, importHost)
+        public ScoreModelDownloader(IModelImporter<ScoreInfo> scoreManager, IAPIProvider api)
+            : base(scoreManager, api)
         {
         }
 

From a6ee0eec0dcaaed2844adf40fa9d7d54f6633ad1 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 25 Nov 2021 18:15:09 +0900
Subject: [PATCH 1274/5547] Remove pointless interface class for
 `IBeatmapModelManager`

Was originally going to be used but serves no purpose any more.
---
 osu.Game/Beatmaps/BeatmapModelManager.cs  |  2 +-
 osu.Game/Beatmaps/IBeatmapModelManager.cs | 20 --------------------
 2 files changed, 1 insertion(+), 21 deletions(-)
 delete mode 100644 osu.Game/Beatmaps/IBeatmapModelManager.cs

diff --git a/osu.Game/Beatmaps/BeatmapModelManager.cs b/osu.Game/Beatmaps/BeatmapModelManager.cs
index ae395c6da6..fc25884446 100644
--- a/osu.Game/Beatmaps/BeatmapModelManager.cs
+++ b/osu.Game/Beatmaps/BeatmapModelManager.cs
@@ -32,7 +32,7 @@ namespace osu.Game.Beatmaps
     /// Handles ef-core storage of beatmaps.
     /// </summary>
     [ExcludeFromDynamicCompile]
-    public class BeatmapModelManager : ArchiveModelManager<BeatmapSetInfo, BeatmapSetFileInfo>, IBeatmapModelManager
+    public class BeatmapModelManager : ArchiveModelManager<BeatmapSetInfo, BeatmapSetFileInfo>
     {
         /// <summary>
         /// Fired when a single difficulty has been hidden.
diff --git a/osu.Game/Beatmaps/IBeatmapModelManager.cs b/osu.Game/Beatmaps/IBeatmapModelManager.cs
deleted file mode 100644
index 8c243c2b77..0000000000
--- a/osu.Game/Beatmaps/IBeatmapModelManager.cs
+++ /dev/null
@@ -1,20 +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.Database;
-
-namespace osu.Game.Beatmaps
-{
-    public interface IBeatmapModelManager : IModelManager<BeatmapSetInfo>
-    {
-        /// <summary>
-        /// Provide an online lookup queue component to handle populating online beatmap metadata.
-        /// </summary>
-        BeatmapOnlineLookupQueue OnlineLookupQueue { set; }
-
-        /// <summary>
-        /// Provide a working beatmap cache, used to invalidate entries on changes.
-        /// </summary>
-        IWorkingBeatmapCache WorkingBeatmapCache { set; }
-    }
-}

From 5e0763ae33c65105ef38a38cddc833abc921854d Mon Sep 17 00:00:00 2001
From: MK56 <74463310+mk56-spn@users.noreply.github.com>
Date: Thu, 25 Nov 2021 10:24:00 +0100
Subject: [PATCH 1275/5547] Expand the functionality of Approach different

---
 osu.Game.Rulesets.Osu/Mods/OsuModApproachDifferent.cs | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModApproachDifferent.cs b/osu.Game.Rulesets.Osu/Mods/OsuModApproachDifferent.cs
index d832411104..d3a01e5def 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModApproachDifferent.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModApproachDifferent.cs
@@ -26,7 +26,7 @@ namespace osu.Game.Rulesets.Osu.Mods
         public BindableFloat Scale { get; } = new BindableFloat(4)
         {
             Precision = 0.1f,
-            MinValue = 2,
+            MinValue = 1.5f,
             MaxValue = 10,
         };
 
@@ -58,6 +58,9 @@ namespace osu.Game.Rulesets.Osu.Mods
                 case AnimationStyle.Accelerate1:
                     return Easing.In;
 
+                case AnimationStyle.Linear:
+                    return Easing.None;
+
                 case AnimationStyle.Accelerate2:
                     return Easing.InCubic;
 
@@ -86,6 +89,7 @@ namespace osu.Game.Rulesets.Osu.Mods
 
         public enum AnimationStyle
         {
+            Linear,
             Gravity,
             InOut1,
             InOut2,

From e2ebcf7a26f932b5ea0bbd8db285d9c2b46b7971 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 25 Nov 2021 18:36:01 +0900
Subject: [PATCH 1276/5547] Remove unnecessary manager parameter

Confused why I added this in the first place..
---
 osu.Game/Database/LegacyBeatmapExporter.cs         | 4 ++--
 osu.Game/Database/LegacyExporter.cs                | 6 +-----
 osu.Game/Database/LegacyScoreExporter.cs           | 4 ++--
 osu.Game/Database/LegacySkinExporter.cs            | 4 ++--
 osu.Game/Online/Leaderboards/LeaderboardScore.cs   | 2 +-
 osu.Game/Overlays/Settings/Sections/SkinSection.cs | 2 +-
 osu.Game/Screens/Edit/Editor.cs                    | 2 +-
 7 files changed, 10 insertions(+), 14 deletions(-)

diff --git a/osu.Game/Database/LegacyBeatmapExporter.cs b/osu.Game/Database/LegacyBeatmapExporter.cs
index 671ed54326..fb8ee8f5f5 100644
--- a/osu.Game/Database/LegacyBeatmapExporter.cs
+++ b/osu.Game/Database/LegacyBeatmapExporter.cs
@@ -10,8 +10,8 @@ namespace osu.Game.Database
     {
         protected override string FileExtension => ".osz";
 
-        public LegacyBeatmapExporter(Storage storage, IModelManager<BeatmapSetInfo> manager)
-            : base(storage, manager)
+        public LegacyBeatmapExporter(Storage storage)
+            : base(storage)
         {
         }
     }
diff --git a/osu.Game/Database/LegacyExporter.cs b/osu.Game/Database/LegacyExporter.cs
index 846495b1ed..802ccec6ed 100644
--- a/osu.Game/Database/LegacyExporter.cs
+++ b/osu.Game/Database/LegacyExporter.cs
@@ -19,16 +19,12 @@ namespace osu.Game.Database
         /// </summary>
         protected abstract string FileExtension { get; }
 
-        protected readonly IModelManager<TModel> Manager;
-
         protected readonly Storage UserFileStorage;
 
         private readonly Storage exportStorage;
 
-        protected LegacyExporter(Storage storage, IModelManager<TModel> manager)
+        protected LegacyExporter(Storage storage)
         {
-            Manager = manager;
-
             exportStorage = storage.GetStorageForDirectory(@"exports");
             UserFileStorage = storage.GetStorageForDirectory(@"files");
         }
diff --git a/osu.Game/Database/LegacyScoreExporter.cs b/osu.Game/Database/LegacyScoreExporter.cs
index e4ddd5982b..41f8516880 100644
--- a/osu.Game/Database/LegacyScoreExporter.cs
+++ b/osu.Game/Database/LegacyScoreExporter.cs
@@ -13,8 +13,8 @@ namespace osu.Game.Database
     {
         protected override string FileExtension => ".osr";
 
-        public LegacyScoreExporter(Storage storage, IModelManager<ScoreInfo> manager)
-            : base(storage, manager)
+        public LegacyScoreExporter(Storage storage)
+            : base(storage)
         {
         }
 
diff --git a/osu.Game/Database/LegacySkinExporter.cs b/osu.Game/Database/LegacySkinExporter.cs
index f6d243315c..9432a1b5fc 100644
--- a/osu.Game/Database/LegacySkinExporter.cs
+++ b/osu.Game/Database/LegacySkinExporter.cs
@@ -10,8 +10,8 @@ namespace osu.Game.Database
     {
         protected override string FileExtension => ".osk";
 
-        public LegacySkinExporter(Storage storage, IModelManager<SkinInfo> manager)
-            : base(storage, manager)
+        public LegacySkinExporter(Storage storage)
+            : base(storage)
         {
         }
     }
diff --git a/osu.Game/Online/Leaderboards/LeaderboardScore.cs b/osu.Game/Online/Leaderboards/LeaderboardScore.cs
index 06c0636d17..e01c7c9e49 100644
--- a/osu.Game/Online/Leaderboards/LeaderboardScore.cs
+++ b/osu.Game/Online/Leaderboards/LeaderboardScore.cs
@@ -400,7 +400,7 @@ namespace osu.Game.Online.Leaderboards
                     items.Add(new OsuMenuItem("Use these mods", MenuItemType.Highlighted, () => songSelect.Mods.Value = Score.Mods));
 
                 if (Score.Files.Count > 0)
-                    items.Add(new OsuMenuItem("Export", MenuItemType.Standard, () => new LegacyScoreExporter(storage, scoreManager).Export(Score)));
+                    items.Add(new OsuMenuItem("Export", MenuItemType.Standard, () => new LegacyScoreExporter(storage).Export(Score)));
 
                 if (Score.ID != 0)
                     items.Add(new OsuMenuItem("Delete", MenuItemType.Destructive, () => dialogOverlay?.Push(new LocalScoreDeleteDialog(Score))));
diff --git a/osu.Game/Overlays/Settings/Sections/SkinSection.cs b/osu.Game/Overlays/Settings/Sections/SkinSection.cs
index 0eec6f5f77..0eb65b4b0f 100644
--- a/osu.Game/Overlays/Settings/Sections/SkinSection.cs
+++ b/osu.Game/Overlays/Settings/Sections/SkinSection.cs
@@ -188,7 +188,7 @@ namespace osu.Game.Overlays.Settings.Sections
             {
                 try
                 {
-                    new LegacySkinExporter(storage, skins).Export(currentSkin.Value.SkinInfo);
+                    new LegacySkinExporter(storage).Export(currentSkin.Value.SkinInfo);
                 }
                 catch (Exception e)
                 {
diff --git a/osu.Game/Screens/Edit/Editor.cs b/osu.Game/Screens/Edit/Editor.cs
index 46d84fe73d..ac71298f36 100644
--- a/osu.Game/Screens/Edit/Editor.cs
+++ b/osu.Game/Screens/Edit/Editor.cs
@@ -758,7 +758,7 @@ namespace osu.Game.Screens.Edit
         private void exportBeatmap()
         {
             Save();
-            new LegacyBeatmapExporter(storage, beatmapManager).Export(Beatmap.Value.BeatmapSetInfo);
+            new LegacyBeatmapExporter(storage).Export(Beatmap.Value.BeatmapSetInfo);
         }
 
         private void updateLastSavedHash()

From 8baf00c0231c3276f497257fd810c36cc3f82109 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 25 Nov 2021 19:36:06 +0900
Subject: [PATCH 1277/5547] Remove unused using

---
 osu.Game/Scoring/ScoreManager.cs | 1 -
 1 file changed, 1 deletion(-)

diff --git a/osu.Game/Scoring/ScoreManager.cs b/osu.Game/Scoring/ScoreManager.cs
index cb2659442d..1564b3bcc5 100644
--- a/osu.Game/Scoring/ScoreManager.cs
+++ b/osu.Game/Scoring/ScoreManager.cs
@@ -3,7 +3,6 @@
 
 using System;
 using System.Collections.Generic;
-using System.IO;
 using System.Linq;
 using System.Linq.Expressions;
 using System.Threading;

From 09dd0542836a83bc411b99dfb6f46db01b30fbf8 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 25 Nov 2021 21:11:13 +0900
Subject: [PATCH 1278/5547] Fix SongSelect-related test failures

---
 .../Visual/Editing/TestSceneEditorSaving.cs          |  5 ++++-
 .../Multiplayer/TestSceneAllPlayersQueueMode.cs      |  2 +-
 .../Visual/Multiplayer/TestSceneHostOnlyQueueMode.cs |  2 +-
 .../Visual/Multiplayer/TestSceneMultiplayer.cs       |  2 +-
 .../TestSceneMultiplayerMatchSongSelect.cs           |  2 +-
 .../Multiplayer/TestScenePlaylistsSongSelect.cs      |  2 +-
 .../Visual/Navigation/TestSceneScreenNavigation.cs   | 12 +++++++++---
 osu.Game/Screens/Select/SongSelect.cs                |  2 ++
 8 files changed, 20 insertions(+), 9 deletions(-)

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneEditorSaving.cs b/osu.Game.Tests/Visual/Editing/TestSceneEditorSaving.cs
index e1e869cfbf..f89be0adf3 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneEditorSaving.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneEditorSaving.cs
@@ -69,7 +69,10 @@ namespace osu.Game.Tests.Visual.Editing
 
             AddUntilStep("Wait for main menu", () => Game.ScreenStack.CurrentScreen is MainMenu);
 
-            PushAndConfirm(() => new PlaySongSelect());
+            Screens.Select.SongSelect songSelect = null;
+
+            PushAndConfirm(() => songSelect = new PlaySongSelect());
+            AddUntilStep("wait for carousel load", () => songSelect.BeatmapSetsLoaded);
 
             AddUntilStep("Wait for beatmap selected", () => !Game.Beatmap.IsDefault);
             AddStep("Open options", () => InputManager.Key(Key.F3));
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneAllPlayersQueueMode.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneAllPlayersQueueMode.cs
index dcb01b83cc..85982682c6 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneAllPlayersQueueMode.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneAllPlayersQueueMode.cs
@@ -86,7 +86,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 InputManager.Click(MouseButton.Left);
             });
 
-            AddUntilStep("wait for song select", () => CurrentSubScreen is Screens.Select.SongSelect select && select.IsLoaded);
+            AddUntilStep("wait for song select", () => CurrentSubScreen is Screens.Select.SongSelect select && select.BeatmapSetsLoaded);
             AddStep("select other beatmap", () => ((Screens.Select.SongSelect)CurrentSubScreen).FinaliseSelection(beatmap()));
             AddUntilStep("wait for return to match", () => CurrentSubScreen is MultiplayerMatchSubScreen);
         }
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneHostOnlyQueueMode.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneHostOnlyQueueMode.cs
index efa5c481ed..1de7289446 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneHostOnlyQueueMode.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneHostOnlyQueueMode.cs
@@ -82,7 +82,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 InputManager.Click(MouseButton.Left);
             });
 
-            AddUntilStep("wait for song select", () => CurrentSubScreen is Screens.Select.SongSelect select && select.IsLoaded);
+            AddUntilStep("wait for song select", () => CurrentSubScreen is Screens.Select.SongSelect select && select.BeatmapSetsLoaded);
 
             BeatmapInfo otherBeatmap = null;
             AddStep("select other beatmap", () => ((Screens.Select.SongSelect)CurrentSubScreen).FinaliseSelection(otherBeatmap = beatmap()));
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
index c4833b5226..027769995a 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
@@ -204,7 +204,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             // edit playlist item
             AddStep("Press select", () => InputManager.Key(Key.Enter));
-            AddUntilStep("wait for song select", () => InputManager.ChildrenOfType<MultiplayerMatchSongSelect>().FirstOrDefault() != null);
+            AddUntilStep("wait for song select", () => InputManager.ChildrenOfType<MultiplayerMatchSongSelect>().FirstOrDefault()?.BeatmapSetsLoaded == true);
 
             // select beatmap
             AddStep("Press select", () => InputManager.Key(Key.Enter));
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs
index 6b67a979e5..84b24ba3a1 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs
@@ -98,7 +98,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             });
 
             AddStep("create song select", () => LoadScreen(songSelect = new TestMultiplayerMatchSongSelect(SelectedRoom.Value)));
-            AddUntilStep("wait for present", () => songSelect.IsCurrentScreen());
+            AddUntilStep("wait for present", () => songSelect.IsCurrentScreen() && songSelect.BeatmapSetsLoaded);
         }
 
         [Test]
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsSongSelect.cs b/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsSongSelect.cs
index 6d761105c1..35c66e8cda 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsSongSelect.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsSongSelect.cs
@@ -57,7 +57,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             });
 
             AddStep("create song select", () => LoadScreen(songSelect = new TestPlaylistsSongSelect(SelectedRoom.Value)));
-            AddUntilStep("wait for present", () => songSelect.IsCurrentScreen());
+            AddUntilStep("wait for present", () => songSelect.IsCurrentScreen() && songSelect.BeatmapSetsLoaded);
         }
 
         [Test]
diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs b/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
index 497c68cf2e..664c186cf8 100644
--- a/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
@@ -66,7 +66,9 @@ namespace osu.Game.Tests.Visual.Navigation
         {
             Player player = null;
 
-            PushAndConfirm(() => new TestPlaySongSelect());
+            Screens.Select.SongSelect songSelect = null;
+            PushAndConfirm(() => songSelect = new TestPlaySongSelect());
+            AddUntilStep("wait for song select", () => songSelect.BeatmapSetsLoaded);
 
             AddStep("import beatmap", () => ImportBeatmapTest.LoadQuickOszIntoOsu(Game).Wait());
 
@@ -98,7 +100,9 @@ namespace osu.Game.Tests.Visual.Navigation
 
             IWorkingBeatmap beatmap() => Game.Beatmap.Value;
 
-            PushAndConfirm(() => new TestPlaySongSelect());
+            Screens.Select.SongSelect songSelect = null;
+            PushAndConfirm(() => songSelect = new TestPlaySongSelect());
+            AddUntilStep("wait for song select", () => songSelect.BeatmapSetsLoaded);
 
             AddStep("import beatmap", () => ImportBeatmapTest.LoadQuickOszIntoOsu(Game).Wait());
 
@@ -130,7 +134,9 @@ namespace osu.Game.Tests.Visual.Navigation
 
             IWorkingBeatmap beatmap() => Game.Beatmap.Value;
 
-            PushAndConfirm(() => new TestPlaySongSelect());
+            Screens.Select.SongSelect songSelect = null;
+            PushAndConfirm(() => songSelect = new TestPlaySongSelect());
+            AddUntilStep("wait for song select", () => songSelect.BeatmapSetsLoaded);
 
             AddStep("import beatmap", () => ImportBeatmapTest.LoadOszIntoOsu(Game, virtualTrack: true).Wait());
 
diff --git a/osu.Game/Screens/Select/SongSelect.cs b/osu.Game/Screens/Select/SongSelect.cs
index 2c36bf5fc8..045a8fbe54 100644
--- a/osu.Game/Screens/Select/SongSelect.cs
+++ b/osu.Game/Screens/Select/SongSelect.cs
@@ -76,6 +76,8 @@ namespace osu.Game.Screens.Select
         /// </summary>
         public virtual bool AllowEditing => true;
 
+        public bool BeatmapSetsLoaded => IsLoaded && Carousel?.BeatmapSetsLoaded == true;
+
         [Resolved]
         private Bindable<IReadOnlyList<Mod>> selectedMods { get; set; }
 

From 8a941fa42206becffc9a8059c0ce11f9b76d0806 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 25 Nov 2021 21:41:03 +0900
Subject: [PATCH 1279/5547] Add owner id to PlaylistItem

---
 osu.Game/Online/Multiplayer/MultiplayerClient.cs | 1 +
 osu.Game/Online/Rooms/PlaylistItem.cs            | 3 +++
 2 files changed, 4 insertions(+)

diff --git a/osu.Game/Online/Multiplayer/MultiplayerClient.cs b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
index 5c339c5d55..4c472164d6 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
@@ -718,6 +718,7 @@ namespace osu.Game.Online.Multiplayer
             var playlistItem = new PlaylistItem
             {
                 ID = item.ID,
+                OwnerID = item.OwnerID,
                 Beatmap = { Value = beatmap },
                 Ruleset = { Value = ruleset },
                 Expired = item.Expired
diff --git a/osu.Game/Online/Rooms/PlaylistItem.cs b/osu.Game/Online/Rooms/PlaylistItem.cs
index c889dc514b..a1480865b8 100644
--- a/osu.Game/Online/Rooms/PlaylistItem.cs
+++ b/osu.Game/Online/Rooms/PlaylistItem.cs
@@ -18,6 +18,9 @@ namespace osu.Game.Online.Rooms
         [JsonProperty("id")]
         public long ID { get; set; }
 
+        [JsonProperty("owner_id")]
+        public int OwnerID { get; set; }
+
         [JsonProperty("beatmap_id")]
         public int BeatmapID { get; set; }
 

From d0c0b7ce476971c039bf8ad5d6dd9e325b975ea5 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 25 Nov 2021 22:05:39 +0900
Subject: [PATCH 1280/5547] Fix intermittent beatmap thumbnail test

---
 .../Visual/Beatmaps/TestSceneBeatmapCardThumbnail.cs         | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCardThumbnail.cs b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCardThumbnail.cs
index 1b4542d946..a5b52f75f6 100644
--- a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCardThumbnail.cs
+++ b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCardThumbnail.cs
@@ -70,6 +70,11 @@ namespace osu.Game.Tests.Visual.Beatmaps
             AddWaitStep("wait some", 3);
             AddAssert("button still visible", () => playButton.IsPresent);
 
+            // The track plays in real-time, so we need to check for progress in increments to avoid timeout.
+            AddUntilStep("progress > 0.25", () => thumbnail.ChildrenOfType<PlayButton>().Single().Progress.Value > 0.25);
+            AddUntilStep("progress > 0.5", () => thumbnail.ChildrenOfType<PlayButton>().Single().Progress.Value > 0.5);
+            AddUntilStep("progress > 0.75", () => thumbnail.ChildrenOfType<PlayButton>().Single().Progress.Value > 0.75);
+
             AddUntilStep("wait for track to end", () => !playButton.Playing.Value);
             AddUntilStep("button hidden", () => !playButton.IsPresent);
         }

From 7c91cd674e2eb01704a512ae6a0facfcea92a028 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 25 Nov 2021 22:17:18 +0900
Subject: [PATCH 1281/5547] Update test classes to set owner ids

---
 osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs  | 6 +++++-
 osu.Game/Tests/Visual/OnlinePlay/TestRoomRequestsHandler.cs | 4 ++++
 2 files changed, 9 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
index b54e243bde..2d77e17513 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
@@ -299,7 +299,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             return ((IMultiplayerClient)this).LoadRequested();
         }
 
-        public override async Task AddPlaylistItem(MultiplayerPlaylistItem item)
+        public async Task AddUserPlaylistItem(int userId, MultiplayerPlaylistItem item)
         {
             Debug.Assert(Room != null);
             Debug.Assert(APIRoom != null);
@@ -313,6 +313,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 case QueueMode.HostOnly:
                     // In host-only mode, the current item is re-used.
                     item.ID = currentItem.ID;
+                    item.OwnerID = currentItem.OwnerID;
 
                     serverSidePlaylist[currentIndex] = item;
                     await ((IMultiplayerClient)this).PlaylistItemChanged(item).ConfigureAwait(false);
@@ -323,6 +324,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
                 default:
                     item.ID = serverSidePlaylist.Last().ID + 1;
+                    item.OwnerID = userId;
 
                     serverSidePlaylist.Add(item);
                     await ((IMultiplayerClient)this).PlaylistItemAdded(item).ConfigureAwait(false);
@@ -332,6 +334,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
             }
         }
 
+        public override Task AddPlaylistItem(MultiplayerPlaylistItem item) => AddUserPlaylistItem(api.LocalUser.Value.OnlineID, item);
+
         protected override Task<APIBeatmapSet> GetOnlineBeatmapSet(int beatmapId, CancellationToken cancellationToken = default)
         {
             IBeatmapSetInfo? set = roomManager.ServerSideRooms.SelectMany(r => r.Playlist)
diff --git a/osu.Game/Tests/Visual/OnlinePlay/TestRoomRequestsHandler.cs b/osu.Game/Tests/Visual/OnlinePlay/TestRoomRequestsHandler.cs
index dc12e48297..0b7d9af5e7 100644
--- a/osu.Game/Tests/Visual/OnlinePlay/TestRoomRequestsHandler.cs
+++ b/osu.Game/Tests/Visual/OnlinePlay/TestRoomRequestsHandler.cs
@@ -128,8 +128,12 @@ namespace osu.Game.Tests.Visual.OnlinePlay
         public void AddServerSideRoom(Room room)
         {
             room.RoomID.Value ??= currentRoomId++;
+
             for (int i = 0; i < room.Playlist.Count; i++)
+            {
                 room.Playlist[i].ID = currentPlaylistItemId++;
+                room.Playlist[i].OwnerID = room.Host.Value.OnlineID;
+            }
 
             serverSideRooms.Add(room);
         }

From 1f5d95666e660557d825f52bb9ef6d0a29c18b6b Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 25 Nov 2021 23:15:28 +0900
Subject: [PATCH 1282/5547] Add owner avatar to multiplayer items

---
 .../TestSceneDrawableRoomPlaylist.cs          |  6 ++
 .../OnlinePlay/DrawableRoomPlaylistItem.cs    | 57 +++++++++++++++++--
 2 files changed, 58 insertions(+), 5 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
index 1d0401832f..b0174104f7 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
@@ -13,6 +13,7 @@ using osu.Framework.Platform;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.Drawables;
+using osu.Game.Database;
 using osu.Game.Graphics.Containers;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Rooms;
@@ -34,6 +35,9 @@ namespace osu.Game.Tests.Visual.Multiplayer
         private BeatmapManager manager;
         private RulesetStore rulesets;
 
+        [Cached(typeof(UserLookupCache))]
+        private readonly TestUserLookupCache userLookupCache = new TestUserLookupCache();
+
         [BackgroundDependencyLoader]
         private void load(GameHost host, AudioManager audio)
         {
@@ -343,6 +347,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     playlist.Items.Add(new PlaylistItem
                     {
                         ID = i,
+                        OwnerID = 2,
                         Beatmap =
                         {
                             Value = i % 2 == 1
@@ -390,6 +395,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     playlist.Items.Add(new PlaylistItem
                     {
                         ID = index++,
+                        OwnerID = 2,
                         Beatmap = { Value = b },
                         Ruleset = { Value = new OsuRuleset().RulesetInfo },
                         RequiredMods =
diff --git a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
index 5a86161b50..5b90713148 100644
--- a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
+++ b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
@@ -4,17 +4,21 @@
 using System;
 using System.Collections.Generic;
 using System.Linq;
+using System.Threading.Tasks;
 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.Cursor;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Input.Events;
+using osu.Framework.Localisation;
 using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.Drawables;
+using osu.Game.Database;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.UserInterface;
@@ -26,6 +30,7 @@ using osu.Game.Overlays.BeatmapSet;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Screens.Play.HUD;
+using osu.Game.Users.Drawables;
 using osuTK;
 using osuTK.Graphics;
 
@@ -34,6 +39,7 @@ namespace osu.Game.Screens.OnlinePlay
     public class DrawableRoomPlaylistItem : OsuRearrangeableListItem<PlaylistItem>
     {
         public const float HEIGHT = 50;
+        public const float ICON_HEIGHT = 34;
 
         public Action<PlaylistItem> RequestDeletion;
 
@@ -45,6 +51,7 @@ namespace osu.Game.Screens.OnlinePlay
         private LinkFlowContainer authorText;
         private ExplicitContentBeatmapPill explicitContentPill;
         private ModDisplay modDisplay;
+        private UpdateableAvatar ownerAvatar;
 
         private readonly IBindable<bool> valid = new Bindable<bool>();
 
@@ -54,6 +61,12 @@ namespace osu.Game.Screens.OnlinePlay
 
         public readonly PlaylistItem Item;
 
+        [Resolved]
+        private OsuColour colours { get; set; }
+
+        [Resolved]
+        private UserLookupCache userLookupCache { get; set; }
+
         private readonly bool allowEdit;
         private readonly bool allowSelection;
 
@@ -79,9 +92,6 @@ namespace osu.Game.Screens.OnlinePlay
                 Colour = OsuColour.Gray(0.5f);
         }
 
-        [Resolved]
-        private OsuColour colours { get; set; }
-
         [BackgroundDependencyLoader]
         private void load()
         {
@@ -132,7 +142,8 @@ namespace osu.Game.Screens.OnlinePlay
                 maskingContainer.BorderColour = colours.Red;
             }
 
-            difficultyIconContainer.Child = new DifficultyIcon(Item.Beatmap.Value, ruleset.Value, requiredMods, performBackgroundDifficultyLookup: false) { Size = new Vector2(32) };
+            userLookupCache.GetUserAsync(Item.OwnerID).ContinueWith(u => Schedule(() => ownerAvatar.User = u.Result), TaskContinuationOptions.OnlyOnRanToCompletion);
+            difficultyIconContainer.Child = new DifficultyIcon(Item.Beatmap.Value, ruleset.Value, requiredMods, performBackgroundDifficultyLookup: false) { Size = new Vector2(ICON_HEIGHT) };
 
             panelBackground.Beatmap.Value = Item.Beatmap.Value;
 
@@ -183,6 +194,7 @@ namespace osu.Game.Screens.OnlinePlay
                         RelativeSizeAxes = Axes.Both,
                         ColumnDimensions = new[]
                         {
+                            new Dimension(GridSizeMode.AutoSize),
                             new Dimension(GridSizeMode.AutoSize),
                             new Dimension(),
                             new Dimension(GridSizeMode.AutoSize),
@@ -191,12 +203,21 @@ namespace osu.Game.Screens.OnlinePlay
                         {
                             new Drawable[]
                             {
+                                ownerAvatar = new OwnerAvatar
+                                {
+                                    Anchor = Anchor.Centre,
+                                    Origin = Anchor.Centre,
+                                    Size = new Vector2(ICON_HEIGHT),
+                                    Margin = new MarginPadding { Left = 8, Right = 8, },
+                                    Masking = true,
+                                    CornerRadius = 4,
+                                },
                                 difficultyIconContainer = new Container
                                 {
                                     Anchor = Anchor.CentreLeft,
                                     Origin = Anchor.CentreLeft,
                                     AutoSizeAxes = Axes.Both,
-                                    Margin = new MarginPadding { Left = 8, Right = 8, },
+                                    Margin = new MarginPadding { Right = 8 },
                                 },
                                 new FillFlowContainer
                                 {
@@ -417,5 +438,31 @@ namespace osu.Game.Screens.OnlinePlay
                 Beatmap.BindValueChanged(beatmap => backgroundSprite.Beatmap.Value = beatmap.NewValue);
             }
         }
+
+        private class OwnerAvatar : UpdateableAvatar, IHasTooltip
+        {
+            public OwnerAvatar()
+            {
+                AddInternal(new TooltipArea(this)
+                {
+                    RelativeSizeAxes = Axes.Both,
+                    Depth = -1
+                });
+            }
+
+            public LocalisableString TooltipText => User == null ? "loading user..." : $"queued by {User.Username}";
+
+            private class TooltipArea : Component, IHasTooltip
+            {
+                private readonly OwnerAvatar avatar;
+
+                public TooltipArea(OwnerAvatar avatar)
+                {
+                    this.avatar = avatar;
+                }
+
+                public LocalisableString TooltipText => avatar.TooltipText;
+            }
+        }
     }
 }

From 84a36ab4a9c6af5c2a310b4e5233e940fc65f546 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 23 Oct 2021 16:48:54 +0200
Subject: [PATCH 1283/5547] Add integration with beatmap set overlay

---
 .../Beatmaps/Drawables/Cards/BeatmapCard.cs   | 36 ++++++++++---------
 1 file changed, 20 insertions(+), 16 deletions(-)

diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
index 4ffad0f065..76b1166626 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.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.
 
+#nullable enable
+
 using System.Collections.Generic;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
@@ -41,27 +43,23 @@ namespace osu.Game.Beatmaps.Drawables.Cards
 
         private readonly BeatmapDownloadTracker downloadTracker;
 
-        private BeatmapCardThumbnail thumbnail;
-        private FillFlowContainer leftIconArea;
+        private BeatmapCardThumbnail thumbnail = null!;
 
-        private Container rightAreaBackground;
-        private Container<BeatmapCardIconButton> rightAreaButtons;
+        private Container rightAreaBackground = null!;
+        private Container<BeatmapCardIconButton> rightAreaButtons = null!;
 
-        private Container mainContent;
-        private BeatmapCardContentBackground mainContentBackground;
+        private Container mainContent = null!;
+        private BeatmapCardContentBackground mainContentBackground = null!;
+        private FillFlowContainer<BeatmapCardStatistic> statisticsContainer = null!;
 
-        private GridContainer titleContainer;
-        private GridContainer artistContainer;
-        private FillFlowContainer<BeatmapCardStatistic> statisticsContainer;
-
-        private FillFlowContainer idleBottomContent;
-        private BeatmapCardDownloadProgressBar downloadProgressBar;
+        private FillFlowContainer idleBottomContent = null!;
+        private BeatmapCardDownloadProgressBar downloadProgressBar = null!;
 
         [Resolved]
-        private OsuColour colours { get; set; }
+        private OsuColour colours { get; set; } = null!;
 
         [Resolved]
-        private OverlayColourProvider colourProvider { get; set; }
+        private OverlayColourProvider colourProvider { get; set; } = null!;
 
         public BeatmapCard(APIBeatmapSet beatmapSet)
             : base(HoverSampleSet.Submit)
@@ -71,14 +69,18 @@ namespace osu.Game.Beatmaps.Drawables.Cards
             downloadTracker = new BeatmapDownloadTracker(beatmapSet);
         }
 
-        [BackgroundDependencyLoader]
-        private void load()
+        [BackgroundDependencyLoader(true)]
+        private void load(BeatmapSetOverlay? beatmapSetOverlay)
         {
             Width = width;
             Height = height;
             CornerRadius = corner_radius;
             Masking = true;
 
+            FillFlowContainer leftIconArea;
+            GridContainer titleContainer;
+            GridContainer artistContainer;
+
             InternalChildren = new Drawable[]
             {
                 downloadTracker,
@@ -335,6 +337,8 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                     Margin = new MarginPadding { Left = 5 }
                 };
             }
+
+            Action = () => beatmapSetOverlay?.FetchAndShowBeatmapSet(beatmapSet.OnlineID);
         }
 
         protected override void LoadComplete()

From 0f9ebe3d5d9b0c9a4e213b5c9ea12fbb4ae9e817 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 23 Oct 2021 16:55:05 +0200
Subject: [PATCH 1284/5547] Use beatmap cards in beatmap listing overlay

---
 .../BeatmapListing/BeatmapListingFilterControl.cs   |  2 +-
 osu.Game/Overlays/BeatmapListingOverlay.cs          | 13 ++++++-------
 2 files changed, 7 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Overlays/BeatmapListing/BeatmapListingFilterControl.cs b/osu.Game/Overlays/BeatmapListing/BeatmapListingFilterControl.cs
index fa57191ef3..38f2bdb34f 100644
--- a/osu.Game/Overlays/BeatmapListing/BeatmapListingFilterControl.cs
+++ b/osu.Game/Overlays/BeatmapListing/BeatmapListingFilterControl.cs
@@ -119,7 +119,7 @@ namespace osu.Game.Overlays.BeatmapListing
         [BackgroundDependencyLoader]
         private void load(OverlayColourProvider colourProvider)
         {
-            sortControlBackground.Colour = colourProvider.Background5;
+            sortControlBackground.Colour = colourProvider.Background4;
         }
 
         public void Search(string query)
diff --git a/osu.Game/Overlays/BeatmapListingOverlay.cs b/osu.Game/Overlays/BeatmapListingOverlay.cs
index e08af52a72..49f2f5c211 100644
--- a/osu.Game/Overlays/BeatmapListingOverlay.cs
+++ b/osu.Game/Overlays/BeatmapListingOverlay.cs
@@ -15,12 +15,11 @@ using osu.Framework.Graphics.Sprites;
 using osu.Framework.Graphics.Textures;
 using osu.Framework.Input.Events;
 using osu.Game.Audio;
+using osu.Game.Beatmaps.Drawables.Cards;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.Containers;
-using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays.BeatmapListing;
-using osu.Game.Overlays.BeatmapListing.Panels;
 using osu.Game.Resources.Localisation.Web;
 using osuTK;
 using osuTK.Graphics;
@@ -34,7 +33,7 @@ namespace osu.Game.Overlays
 
         private Drawable currentContent;
         private Container panelTarget;
-        private FillFlowContainer<BeatmapPanel> foundContent;
+        private FillFlowContainer<BeatmapCard> foundContent;
         private NotFoundDrawable notFoundContent;
         private SupporterRequiredDrawable supporterRequiredContent;
         private BeatmapListingFilterControl filterControl;
@@ -69,7 +68,7 @@ namespace osu.Game.Overlays
                             new Box
                             {
                                 RelativeSizeAxes = Axes.Both,
-                                Colour = ColourProvider.Background4,
+                                Colour = ColourProvider.Background5,
                             },
                             panelTarget = new Container
                             {
@@ -79,7 +78,7 @@ namespace osu.Game.Overlays
                                 Padding = new MarginPadding { Horizontal = 20 },
                                 Children = new Drawable[]
                                 {
-                                    foundContent = new FillFlowContainer<BeatmapPanel>(),
+                                    foundContent = new FillFlowContainer<BeatmapCard>(),
                                     notFoundContent = new NotFoundDrawable(),
                                     supporterRequiredContent = new SupporterRequiredDrawable(),
                                 }
@@ -136,7 +135,7 @@ namespace osu.Game.Overlays
                 return;
             }
 
-            var newPanels = searchResult.Results.Select<APIBeatmapSet, BeatmapPanel>(b => new GridBeatmapPanel(b)
+            var newPanels = searchResult.Results.Select(b => new BeatmapCard(b)
             {
                 Anchor = Anchor.TopCentre,
                 Origin = Anchor.TopCentre,
@@ -152,7 +151,7 @@ namespace osu.Game.Overlays
                 }
 
                 // spawn new children with the contained so we only clear old content at the last moment.
-                var content = new FillFlowContainer<BeatmapPanel>
+                var content = new FillFlowContainer<BeatmapCard>
                 {
                     RelativeSizeAxes = Axes.X,
                     AutoSizeAxes = Axes.Y,

From 42b09fd1ece244ba589df58ec8fccbdd16cf5795 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 24 Oct 2021 19:20:57 +0200
Subject: [PATCH 1285/5547] Use beatmap cards in user profile overlay

---
 .../Profile/Sections/Beatmaps/PaginatedBeatmapContainer.cs    | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Overlays/Profile/Sections/Beatmaps/PaginatedBeatmapContainer.cs b/osu.Game/Overlays/Profile/Sections/Beatmaps/PaginatedBeatmapContainer.cs
index 36b94283e5..e46e503dfa 100644
--- a/osu.Game/Overlays/Profile/Sections/Beatmaps/PaginatedBeatmapContainer.cs
+++ b/osu.Game/Overlays/Profile/Sections/Beatmaps/PaginatedBeatmapContainer.cs
@@ -6,10 +6,10 @@ using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Localisation;
+using osu.Game.Beatmaps.Drawables.Cards;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests;
 using osu.Game.Online.API.Requests.Responses;
-using osu.Game.Overlays.BeatmapListing.Panels;
 using osuTK;
 using APIUser = osu.Game.Online.API.Requests.Responses.APIUser;
 
@@ -61,7 +61,7 @@ namespace osu.Game.Overlays.Profile.Sections.Beatmaps
             new GetUserBeatmapsRequest(User.Value.Id, type, VisiblePages++, ItemsPerPage);
 
         protected override Drawable CreateDrawableItem(APIBeatmapSet model) => model.OnlineID > 0
-            ? new GridBeatmapPanel(model)
+            ? new BeatmapCard(model)
             {
                 Anchor = Anchor.TopCentre,
                 Origin = Anchor.TopCentre,

From ec2265d5bbddc2690fcb028be0dc44d96ec7f051 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 24 Oct 2021 19:21:46 +0200
Subject: [PATCH 1286/5547] Use beatmap cards in spotlights layout

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

diff --git a/osu.Game/Overlays/Rankings/SpotlightsLayout.cs b/osu.Game/Overlays/Rankings/SpotlightsLayout.cs
index b95b0a1afc..cc553ad361 100644
--- a/osu.Game/Overlays/Rankings/SpotlightsLayout.cs
+++ b/osu.Game/Overlays/Rankings/SpotlightsLayout.cs
@@ -13,9 +13,9 @@ using osu.Game.Online.API.Requests;
 using osu.Game.Overlays.Rankings.Tables;
 using System.Linq;
 using System.Threading;
+using osu.Game.Beatmaps.Drawables.Cards;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.UserInterface;
-using osu.Game.Overlays.BeatmapListing.Panels;
 
 namespace osu.Game.Overlays.Rankings
 {
@@ -143,7 +143,7 @@ namespace osu.Game.Overlays.Rankings
                     AutoSizeAxes = Axes.Y,
                     RelativeSizeAxes = Axes.X,
                     Spacing = new Vector2(10),
-                    Children = response.BeatmapSets.Select(b => new GridBeatmapPanel(b)
+                    Children = response.BeatmapSets.Select(b => new BeatmapCard(b)
                     {
                         Anchor = Anchor.TopCentre,
                         Origin = Anchor.TopCentre,

From a188d6662fa72452f82b94815be841b5be558f3a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 24 Oct 2021 19:44:32 +0200
Subject: [PATCH 1287/5547] Use beatmap card in solo spectator screen

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

diff --git a/osu.Game/Screens/Play/SoloSpectator.cs b/osu.Game/Screens/Play/SoloSpectator.cs
index 5ecdb91718..45601999a0 100644
--- a/osu.Game/Screens/Play/SoloSpectator.cs
+++ b/osu.Game/Screens/Play/SoloSpectator.cs
@@ -12,6 +12,7 @@ using osu.Framework.Screens;
 using osu.Framework.Threading;
 using osu.Game.Audio;
 using osu.Game.Beatmaps;
+using osu.Game.Beatmaps.Drawables.Cards;
 using osu.Game.Configuration;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
@@ -20,7 +21,7 @@ using osu.Game.Online.API;
 using osu.Game.Online.API.Requests;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Spectator;
-using osu.Game.Overlays.BeatmapListing.Panels;
+using osu.Game.Overlays;
 using osu.Game.Overlays.Settings;
 using osu.Game.Rulesets;
 using osu.Game.Screens.OnlinePlay.Match.Components;
@@ -52,6 +53,9 @@ namespace osu.Game.Screens.Play
         [Resolved]
         private BeatmapModelDownloader beatmapDownloader { get; set; }
 
+        [Cached]
+        private OverlayColourProvider colourProvider = new OverlayColourProvider(OverlayColourScheme.Purple);
+
         private Container beatmapPanelContainer;
         private TriangleButton watchButton;
         private SettingsCheckbox automaticDownload;
@@ -73,7 +77,7 @@ namespace osu.Game.Screens.Play
         }
 
         [BackgroundDependencyLoader]
-        private void load(OsuColour colours, OsuConfigManager config)
+        private void load(OsuConfigManager config)
         {
             InternalChild = new Container
             {
@@ -88,7 +92,7 @@ namespace osu.Game.Screens.Play
                 {
                     new Box
                     {
-                        Colour = colours.GreySeafoamDark,
+                        Colour = colourProvider.Background5,
                         RelativeSizeAxes = Axes.Both,
                     },
                     new FillFlowContainer
@@ -229,7 +233,7 @@ namespace osu.Game.Screens.Play
             onlineBeatmapRequest.Success += beatmapSet => Schedule(() =>
             {
                 this.beatmapSet = beatmapSet;
-                beatmapPanelContainer.Child = new GridBeatmapPanel(this.beatmapSet);
+                beatmapPanelContainer.Child = new BeatmapCard(this.beatmapSet);
                 checkForAutomaticDownload();
             });
 

From 1d96542a2ac430d75e3d6177d3f503775e13577d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 26 Nov 2021 12:19:24 +0900
Subject: [PATCH 1288/5547] Fix incorrect `ConfigureAwait` specification
 causing stalled test

This only occurs on upcoming changes I have (occurred when switching
existing skin import tests across to realm). Unsure why it was set to
`true`, seems like a weird oversight.
---
 osu.Game/Stores/RealmArchiveModelImporter.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Stores/RealmArchiveModelImporter.cs b/osu.Game/Stores/RealmArchiveModelImporter.cs
index 6370d4ebe4..b74670e722 100644
--- a/osu.Game/Stores/RealmArchiveModelImporter.cs
+++ b/osu.Game/Stores/RealmArchiveModelImporter.cs
@@ -253,7 +253,7 @@ namespace osu.Game.Stores
             var scheduledImport = Task.Factory.StartNew(async () => await Import(model, archive, lowPriority, cancellationToken).ConfigureAwait(false),
                 cancellationToken, TaskCreationOptions.HideScheduler, lowPriority ? import_scheduler_low_priority : import_scheduler).Unwrap();
 
-            return await scheduledImport.ConfigureAwait(true);
+            return await scheduledImport.ConfigureAwait(false);
         }
 
         /// <summary>

From 13612c0d02b0b1d94d3b8b293c025757a452cf01 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 26 Nov 2021 14:38:39 +0900
Subject: [PATCH 1289/5547] Add equality support to `ILive` types

---
 osu.Game.Tests/Database/RealmLiveTests.cs | 9 ++++-----
 osu.Game/Database/EntityFrameworkLive.cs  | 4 ++++
 osu.Game/Database/ILive.cs                | 3 ++-
 osu.Game/Database/IPostImports.cs         | 2 +-
 osu.Game/Database/RealmLive.cs            | 2 ++
 5 files changed, 13 insertions(+), 7 deletions(-)

diff --git a/osu.Game.Tests/Database/RealmLiveTests.cs b/osu.Game.Tests/Database/RealmLiveTests.cs
index 33aa1afb89..41a81382f8 100644
--- a/osu.Game.Tests/Database/RealmLiveTests.cs
+++ b/osu.Game.Tests/Database/RealmLiveTests.cs
@@ -6,7 +6,6 @@ using System.Diagnostics;
 using System.Linq;
 using System.Threading.Tasks;
 using NUnit.Framework;
-using osu.Game.Beatmaps;
 using osu.Game.Database;
 using osu.Game.Models;
 using Realms;
@@ -18,15 +17,15 @@ namespace osu.Game.Tests.Database
     public class RealmLiveTests : RealmTest
     {
         [Test]
-        public void TestLiveCastability()
+        public void TestLiveEquality()
         {
             RunTestWithRealm((realmFactory, _) =>
             {
-                RealmLive<RealmBeatmap> beatmap = realmFactory.CreateContext().Write(r => r.Add(new RealmBeatmap(CreateRuleset(), new RealmBeatmapDifficulty(), new RealmBeatmapMetadata()))).ToLive();
+                ILive<RealmBeatmap> beatmap = realmFactory.CreateContext().Write(r => r.Add(new RealmBeatmap(CreateRuleset(), new RealmBeatmapDifficulty(), new RealmBeatmapMetadata()))).ToLive();
 
-                ILive<IBeatmapInfo> iBeatmap = beatmap;
+                ILive<RealmBeatmap> beatmap2 = realmFactory.CreateContext().All<RealmBeatmap>().First().ToLive();
 
-                Assert.AreEqual(0, iBeatmap.Value.Length);
+                Assert.AreEqual(beatmap, beatmap2);
             });
         }
 
diff --git a/osu.Game/Database/EntityFrameworkLive.cs b/osu.Game/Database/EntityFrameworkLive.cs
index 1d7b53911a..0fe8fea1ff 100644
--- a/osu.Game/Database/EntityFrameworkLive.cs
+++ b/osu.Game/Database/EntityFrameworkLive.cs
@@ -3,6 +3,8 @@
 
 using System;
 
+#nullable enable
+
 namespace osu.Game.Database
 {
     public class EntityFrameworkLive<T> : ILive<T> where T : class
@@ -30,5 +32,7 @@ namespace osu.Game.Database
         }
 
         public T Value { get; }
+
+        public bool Equals(ILive<T>? other) => ID == other?.ID;
     }
 }
diff --git a/osu.Game/Database/ILive.cs b/osu.Game/Database/ILive.cs
index 9359b09eaf..ed2b926782 100644
--- a/osu.Game/Database/ILive.cs
+++ b/osu.Game/Database/ILive.cs
@@ -9,7 +9,8 @@ namespace osu.Game.Database
     /// A wrapper to provide access to database backed classes in a thread-safe manner.
     /// </summary>
     /// <typeparam name="T">The databased type.</typeparam>
-    public interface ILive<out T> where T : class // TODO: Add IHasGuidPrimaryKey once we don't need EF support any more.
+    public interface ILive<T> : IEquatable<ILive<T>>
+        where T : class // TODO: Add IHasGuidPrimaryKey once we don't need EF support any more.
     {
         Guid ID { get; }
 
diff --git a/osu.Game/Database/IPostImports.cs b/osu.Game/Database/IPostImports.cs
index b3b83f23ef..adb3a7108d 100644
--- a/osu.Game/Database/IPostImports.cs
+++ b/osu.Game/Database/IPostImports.cs
@@ -8,7 +8,7 @@ using System.Collections.Generic;
 
 namespace osu.Game.Database
 {
-    public interface IPostImports<out TModel>
+    public interface IPostImports<TModel>
         where TModel : class
     {
         /// <summary>
diff --git a/osu.Game/Database/RealmLive.cs b/osu.Game/Database/RealmLive.cs
index abb69644d6..d988a81739 100644
--- a/osu.Game/Database/RealmLive.cs
+++ b/osu.Game/Database/RealmLive.cs
@@ -107,5 +107,7 @@ namespace osu.Game.Database
         // this matches realm's internal thread validation (see https://github.com/realm/realm-dotnet/blob/903b4d0b304f887e37e2d905384fb572a6496e70/Realm/Realm/Native/SynchronizationContextScheduler.cs#L72)
         private bool isCorrectThread
             => (fetchedContext != null && SynchronizationContext.Current == fetchedContext) || fetchedThreadId == Thread.CurrentThread.ManagedThreadId;
+
+        public bool Equals(ILive<T>? other) => ID == other?.ID;
     }
 }

From 40d1b97af10fa5d5a6f8a70f4d65886da78181cc Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 26 Nov 2021 14:39:35 +0900
Subject: [PATCH 1290/5547] Avoid attempting to fetch a non-managed `RealmLive`
 instance from the realm backing

For compatibility reasons, we quite often convert completely unmanaged
instances to `ILive`s so they fit the required parameters of a property
or method call. This ensures such cases will not cause any issues when
trying to interact with the underlying data.

Originally I had this allowing write operations, but that seems a bit
unsafe (when performing a write one would assume that the underlying
data is being persisted, whereas in this case it is not). We can change
this if the requirements change in the future, but I think throwing is
the safest bet for now.
---
 osu.Game.Tests/Database/RealmLiveTests.cs | 17 +++++++++++++++++
 osu.Game/Database/EntityFrameworkLive.cs  |  3 +++
 osu.Game/Database/ILive.cs                |  5 +++++
 osu.Game/Database/RealmLive.cs            | 20 ++++++++++++++++----
 4 files changed, 41 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Tests/Database/RealmLiveTests.cs b/osu.Game.Tests/Database/RealmLiveTests.cs
index 33aa1afb89..4f7681e3ae 100644
--- a/osu.Game.Tests/Database/RealmLiveTests.cs
+++ b/osu.Game.Tests/Database/RealmLiveTests.cs
@@ -30,6 +30,23 @@ namespace osu.Game.Tests.Database
             });
         }
 
+        [Test]
+        public void TestAccessNonManaged()
+        {
+            var beatmap = new RealmBeatmap(CreateRuleset(), new RealmBeatmapDifficulty(), new RealmBeatmapMetadata());
+            var liveBeatmap = beatmap.ToLive();
+
+            Assert.IsFalse(beatmap.Hidden);
+            Assert.IsFalse(liveBeatmap.Value.Hidden);
+            Assert.IsFalse(liveBeatmap.PerformRead(l => l.Hidden));
+
+            Assert.Throws<InvalidOperationException>(() => liveBeatmap.PerformWrite(l => l.Hidden = true));
+
+            Assert.IsFalse(beatmap.Hidden);
+            Assert.IsFalse(liveBeatmap.Value.Hidden);
+            Assert.IsFalse(liveBeatmap.PerformRead(l => l.Hidden));
+        }
+
         [Test]
         public void TestValueAccessWithOpenContext()
         {
diff --git a/osu.Game/Database/EntityFrameworkLive.cs b/osu.Game/Database/EntityFrameworkLive.cs
index 1d7b53911a..e4507b8d3b 100644
--- a/osu.Game/Database/EntityFrameworkLive.cs
+++ b/osu.Game/Database/EntityFrameworkLive.cs
@@ -9,6 +9,7 @@ namespace osu.Game.Database
     {
         public EntityFrameworkLive(T item)
         {
+            IsManaged = true; // no way to really know.
             Value = item;
         }
 
@@ -29,6 +30,8 @@ namespace osu.Game.Database
             perform(Value);
         }
 
+        public bool IsManaged { get; }
+
         public T Value { get; }
     }
 }
diff --git a/osu.Game/Database/ILive.cs b/osu.Game/Database/ILive.cs
index 9359b09eaf..ae287f1f6f 100644
--- a/osu.Game/Database/ILive.cs
+++ b/osu.Game/Database/ILive.cs
@@ -31,6 +31,11 @@ namespace osu.Game.Database
         /// <param name="perform">The action to perform.</param>
         void PerformWrite(Action<T> perform);
 
+        /// <summary>
+        /// Whether this instance is tracking data which is managed by the database backing.
+        /// </summary>
+        bool IsManaged { get; }
+
         /// <summary>
         /// Resolve the value of this instance on the current thread's context.
         /// </summary>
diff --git a/osu.Game/Database/RealmLive.cs b/osu.Game/Database/RealmLive.cs
index abb69644d6..fe631a9964 100644
--- a/osu.Game/Database/RealmLive.cs
+++ b/osu.Game/Database/RealmLive.cs
@@ -17,6 +17,8 @@ namespace osu.Game.Database
     {
         public Guid ID { get; }
 
+        public bool IsManaged { get; }
+
         private readonly SynchronizationContext? fetchedContext;
         private readonly int fetchedThreadId;
 
@@ -33,8 +35,13 @@ namespace osu.Game.Database
         {
             this.data = data;
 
-            fetchedContext = SynchronizationContext.Current;
-            fetchedThreadId = Thread.CurrentThread.ManagedThreadId;
+            if (data.IsManaged)
+            {
+                IsManaged = true;
+
+                fetchedContext = SynchronizationContext.Current;
+                fetchedThreadId = Thread.CurrentThread.ManagedThreadId;
+            }
 
             ID = data.ID;
         }
@@ -75,13 +82,18 @@ namespace osu.Game.Database
         /// Perform a write operation on this live object.
         /// </summary>
         /// <param name="perform">The action to perform.</param>
-        public void PerformWrite(Action<T> perform) =>
+        public void PerformWrite(Action<T> perform)
+        {
+            if (!IsManaged)
+                throw new InvalidOperationException("Can't perform writes on a non-managed underlying value");
+
             PerformRead(t =>
             {
                 var transaction = t.Realm.BeginWrite();
                 perform(t);
                 transaction.Commit();
             });
+        }
 
         public T Value
         {
@@ -102,7 +114,7 @@ namespace osu.Game.Database
             }
         }
 
-        private bool originalDataValid => isCorrectThread && data.IsValid;
+        private bool originalDataValid => !IsManaged || (isCorrectThread && data.IsValid);
 
         // this matches realm's internal thread validation (see https://github.com/realm/realm-dotnet/blob/903b4d0b304f887e37e2d905384fb572a6496e70/Realm/Realm/Native/SynchronizationContextScheduler.cs#L72)
         private bool isCorrectThread

From 5de2f6211d72a7d1820e223faa6d076ad7349f8f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 26 Nov 2021 15:32:33 +0900
Subject: [PATCH 1291/5547] Show a spinner instead of the download button on
 the new card during beatmap download

---
 .../Cards/Buttons/BeatmapCardIconButton.cs    |  6 +-
 .../Drawables/Cards/Buttons/DownloadButton.cs | 56 ++++++++++++++-----
 2 files changed, 47 insertions(+), 15 deletions(-)

diff --git a/osu.Game/Beatmaps/Drawables/Cards/Buttons/BeatmapCardIconButton.cs b/osu.Game/Beatmaps/Drawables/Cards/Buttons/BeatmapCardIconButton.cs
index ad9caf7e34..e362e3abeb 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/Buttons/BeatmapCardIconButton.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/Buttons/BeatmapCardIconButton.cs
@@ -54,6 +54,8 @@ namespace osu.Game.Beatmaps.Drawables.Cards.Buttons
 
         protected readonly SpriteIcon Icon;
 
+        protected override Container<Drawable> Content => content;
+
         private readonly Container content;
 
         protected BeatmapCardIconButton()
@@ -61,7 +63,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards.Buttons
             Origin = Anchor.Centre;
             Anchor = Anchor.Centre;
 
-            Child = content = new Container
+            base.Content.Add(content = new Container
             {
                 RelativeSizeAxes = Axes.Both,
                 Masking = true,
@@ -75,7 +77,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards.Buttons
                         Anchor = Anchor.Centre
                     }
                 }
-            };
+            });
 
             Size = new Vector2(24);
             IconSize = 12;
diff --git a/osu.Game/Beatmaps/Drawables/Cards/Buttons/DownloadButton.cs b/osu.Game/Beatmaps/Drawables/Cards/Buttons/DownloadButton.cs
index 1a514c8d36..150a5b1d15 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/Buttons/DownloadButton.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/Buttons/DownloadButton.cs
@@ -3,14 +3,17 @@
 
 #nullable enable
 
+using System;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Sprites;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Configuration;
+using osu.Game.Graphics.UserInterface;
 using osu.Game.Online;
 using osu.Game.Resources.Localisation.Web;
+using osuTK;
 
 namespace osu.Game.Beatmaps.Drawables.Cards.Buttons
 {
@@ -23,6 +26,8 @@ namespace osu.Game.Beatmaps.Drawables.Cards.Buttons
 
         private Bindable<bool> preferNoVideo = null!;
 
+        private readonly LoadingSpinner spinner;
+
         [Resolved]
         private BeatmapModelDownloader beatmaps { get; set; } = null!;
 
@@ -30,6 +35,8 @@ namespace osu.Game.Beatmaps.Drawables.Cards.Buttons
         {
             Icon.Icon = FontAwesome.Solid.Download;
 
+            Content.Add(spinner = new LoadingSpinner { Size = new Vector2(IconSize) });
+
             this.beatmapSet = beatmapSet;
         }
 
@@ -49,21 +56,44 @@ namespace osu.Game.Beatmaps.Drawables.Cards.Buttons
 
         private void updateState()
         {
-            this.FadeTo(state.Value != DownloadState.LocallyAvailable ? 1 : 0, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
-
-            if (beatmapSet.Availability.DownloadDisabled)
+            switch (state.Value)
             {
-                Enabled.Value = false;
-                TooltipText = BeatmapsetsStrings.AvailabilityDisabled;
-                return;
+                case DownloadState.Downloading:
+                case DownloadState.Importing:
+                    Action = null;
+                    TooltipText = string.Empty;
+                    spinner.Show();
+                    Icon.Hide();
+                    return;
+
+                case DownloadState.LocallyAvailable:
+                    Action = null;
+                    TooltipText = string.Empty;
+                    this.FadeOut(BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
+                    break;
+
+                case DownloadState.NotDownloaded:
+                    if (beatmapSet.Availability.DownloadDisabled)
+                    {
+                        Enabled.Value = false;
+                        TooltipText = BeatmapsetsStrings.AvailabilityDisabled;
+                        return;
+                    }
+
+                    Action = () => beatmaps.Download(beatmapSet, preferNoVideo.Value);
+                    this.FadeIn(BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
+                    spinner.Hide();
+                    Icon.Show();
+
+                    if (!beatmapSet.HasVideo)
+                        TooltipText = BeatmapsetsStrings.PanelDownloadAll;
+                    else
+                        TooltipText = preferNoVideo.Value ? BeatmapsetsStrings.PanelDownloadNoVideo : BeatmapsetsStrings.PanelDownloadVideo;
+                    break;
+
+                default:
+                    throw new InvalidOperationException($"Unknown {nameof(DownloadState)} specified.");
             }
-
-            if (!beatmapSet.HasVideo)
-                TooltipText = BeatmapsetsStrings.PanelDownloadAll;
-            else
-                TooltipText = preferNoVideo.Value ? BeatmapsetsStrings.PanelDownloadNoVideo : BeatmapsetsStrings.PanelDownloadVideo;
-
-            Action = () => beatmaps.Download(beatmapSet, preferNoVideo.Value);
         }
     }
 }

From bf443a5a7a447b05c2cbed666022ae78d688568c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 26 Nov 2021 15:36:16 +0900
Subject: [PATCH 1292/5547] Switch unnecessary `return` to `break` instead

---
 osu.Game/Beatmaps/Drawables/Cards/Buttons/DownloadButton.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Beatmaps/Drawables/Cards/Buttons/DownloadButton.cs b/osu.Game/Beatmaps/Drawables/Cards/Buttons/DownloadButton.cs
index 150a5b1d15..c94e335e8f 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/Buttons/DownloadButton.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/Buttons/DownloadButton.cs
@@ -64,7 +64,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards.Buttons
                     TooltipText = string.Empty;
                     spinner.Show();
                     Icon.Hide();
-                    return;
+                    break;
 
                 case DownloadState.LocallyAvailable:
                     Action = null;

From 8be2defd09d018bfe4df29373005b6badda0844a Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 26 Nov 2021 17:17:06 +0900
Subject: [PATCH 1293/5547] Right-align avatar

---
 .../OnlinePlay/DrawableRoomPlaylistItem.cs    | 26 +++++++++----------
 1 file changed, 13 insertions(+), 13 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
index 5b90713148..6c518616e2 100644
--- a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
+++ b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
@@ -194,30 +194,21 @@ namespace osu.Game.Screens.OnlinePlay
                         RelativeSizeAxes = Axes.Both,
                         ColumnDimensions = new[]
                         {
-                            new Dimension(GridSizeMode.AutoSize),
                             new Dimension(GridSizeMode.AutoSize),
                             new Dimension(),
                             new Dimension(GridSizeMode.AutoSize),
+                            new Dimension(GridSizeMode.AutoSize)
                         },
                         Content = new[]
                         {
                             new Drawable[]
                             {
-                                ownerAvatar = new OwnerAvatar
-                                {
-                                    Anchor = Anchor.Centre,
-                                    Origin = Anchor.Centre,
-                                    Size = new Vector2(ICON_HEIGHT),
-                                    Margin = new MarginPadding { Left = 8, Right = 8, },
-                                    Masking = true,
-                                    CornerRadius = 4,
-                                },
                                 difficultyIconContainer = new Container
                                 {
                                     Anchor = Anchor.CentreLeft,
                                     Origin = Anchor.CentreLeft,
                                     AutoSizeAxes = Axes.Both,
-                                    Margin = new MarginPadding { Right = 8 },
+                                    Margin = new MarginPadding { Left = 8, Right = 8 },
                                 },
                                 new FillFlowContainer
                                 {
@@ -280,7 +271,7 @@ namespace osu.Game.Screens.OnlinePlay
                                     Anchor = Anchor.CentreRight,
                                     Origin = Anchor.CentreRight,
                                     Direction = FillDirection.Horizontal,
-                                    Margin = new MarginPadding { Left = 8, Right = 10, },
+                                    Margin = new MarginPadding { Left = 8 },
                                     AutoSizeAxes = Axes.Both,
                                     Spacing = new Vector2(5),
                                     ChildrenEnumerable = CreateButtons().Select(button => button.With(b =>
@@ -288,7 +279,16 @@ namespace osu.Game.Screens.OnlinePlay
                                         b.Anchor = Anchor.Centre;
                                         b.Origin = Anchor.Centre;
                                     }))
-                                }
+                                },
+                                ownerAvatar = new OwnerAvatar
+                                {
+                                    Anchor = Anchor.Centre,
+                                    Origin = Anchor.Centre,
+                                    Size = new Vector2(ICON_HEIGHT),
+                                    Margin = new MarginPadding { Left = 8, Right = 8, },
+                                    Masking = true,
+                                    CornerRadius = 4,
+                                },
                             }
                         }
                     },

From e9a19aacd7c1551dbcfb57573ec86cda82109c28 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 26 Nov 2021 17:23:50 +0900
Subject: [PATCH 1294/5547] Fix tests by requiring host

---
 osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs | 8 ++++----
 .../Visual/Multiplayer/TestMultiplayerRoomManager.cs      | 4 +++-
 .../Tests/Visual/OnlinePlay/TestRoomRequestsHandler.cs    | 6 ++++--
 3 files changed, 11 insertions(+), 7 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
index 027769995a..4521a7fa0f 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
@@ -253,7 +253,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                             Ruleset = { Value = new OsuRuleset().RulesetInfo },
                         }
                     }
-                });
+                }, API.LocalUser.Value);
             });
 
             AddStep("refresh rooms", () => this.ChildrenOfType<LoungeSubScreen>().Single().UpdateFilter());
@@ -283,7 +283,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                             Ruleset = { Value = new OsuRuleset().RulesetInfo },
                         }
                     }
-                });
+                }, API.LocalUser.Value);
             });
 
             AddStep("refresh rooms", () => this.ChildrenOfType<LoungeSubScreen>().Single().UpdateFilter());
@@ -336,7 +336,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                             Ruleset = { Value = new OsuRuleset().RulesetInfo },
                         }
                     }
-                });
+                }, API.LocalUser.Value);
             });
 
             AddStep("refresh rooms", () => this.ChildrenOfType<LoungeSubScreen>().Single().UpdateFilter());
@@ -597,7 +597,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                             Ruleset = { Value = new OsuRuleset().RulesetInfo },
                         }
                     }
-                });
+                }, API.LocalUser.Value);
             });
 
             AddStep("refresh rooms", () => this.ChildrenOfType<LoungeSubScreen>().Single().UpdateFilter());
diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerRoomManager.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerRoomManager.cs
index f8419b4164..a1f010f082 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerRoomManager.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerRoomManager.cs
@@ -3,6 +3,7 @@
 
 using System;
 using System.Collections.Generic;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Rooms;
 using osu.Game.Screens.OnlinePlay.Components;
 using osu.Game.Screens.OnlinePlay.Multiplayer;
@@ -55,6 +56,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         /// Adds a room to a local "server-side" list that's returned when a <see cref="GetRoomsRequest"/> is fired.
         /// </summary>
         /// <param name="room">The room.</param>
-        public void AddServerSideRoom(Room room) => requestsHandler.AddServerSideRoom(room);
+        /// <param name="host">The host.</param>
+        public void AddServerSideRoom(Room room, APIUser host) => requestsHandler.AddServerSideRoom(room, host);
     }
 }
diff --git a/osu.Game/Tests/Visual/OnlinePlay/TestRoomRequestsHandler.cs b/osu.Game/Tests/Visual/OnlinePlay/TestRoomRequestsHandler.cs
index 0b7d9af5e7..abcf31c007 100644
--- a/osu.Game/Tests/Visual/OnlinePlay/TestRoomRequestsHandler.cs
+++ b/osu.Game/Tests/Visual/OnlinePlay/TestRoomRequestsHandler.cs
@@ -50,7 +50,7 @@ namespace osu.Game.Tests.Visual.OnlinePlay
                     apiRoom.HasPassword.Value = !string.IsNullOrEmpty(createRoomRequest.Room.Password.Value);
                     apiRoom.Password.Value = createRoomRequest.Room.Password.Value;
 
-                    AddServerSideRoom(apiRoom);
+                    AddServerSideRoom(apiRoom, localUser);
 
                     var responseRoom = new APICreatedRoom();
                     responseRoom.CopyFrom(createResponseRoom(apiRoom, false));
@@ -125,9 +125,11 @@ namespace osu.Game.Tests.Visual.OnlinePlay
         /// Adds a room to a local "server-side" list that's returned when a <see cref="GetRoomsRequest"/> is fired.
         /// </summary>
         /// <param name="room">The room.</param>
-        public void AddServerSideRoom(Room room)
+        /// <param name="host">The room host.</param>
+        public void AddServerSideRoom(Room room, APIUser host)
         {
             room.RoomID.Value ??= currentRoomId++;
+            room.Host.Value = host;
 
             for (int i = 0; i < room.Playlist.Count; i++)
             {

From e1445dcb058495d909efab2800f84d51e0f81aaf Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 26 Nov 2021 17:40:45 +0900
Subject: [PATCH 1295/5547] Only show owner in match subscreen

---
 .../TestSceneDrawableRoomPlaylist.cs           | 18 ++++++++++++++----
 .../Screens/OnlinePlay/DrawableRoomPlaylist.cs |  6 ++++--
 .../OnlinePlay/DrawableRoomPlaylistItem.cs     | 16 ++++++++++++----
 .../DrawableRoomPlaylistWithResults.cs         | 13 ++++++++-----
 .../Multiplayer/MultiplayerMatchSubScreen.cs   |  2 +-
 5 files changed, 39 insertions(+), 16 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
index b0174104f7..13d98145a1 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
@@ -23,6 +23,7 @@ using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Osu.Mods;
 using osu.Game.Screens.OnlinePlay;
 using osu.Game.Tests.Beatmaps;
+using osu.Game.Users.Drawables;
 using osuTK;
 using osuTK.Input;
 
@@ -308,6 +309,15 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddUntilStep("wait for items to load", () => playlist.ItemMap.Values.All(i => i.IsLoaded));
         }
 
+        [TestCase(false)]
+        [TestCase(true)]
+        public void TestWithOwner(bool withOwner)
+        {
+            createPlaylist(false, false, withOwner);
+
+            AddAssert("owner visible", () => playlist.ChildrenOfType<UpdateableAvatar>().All(a => a.IsPresent == withOwner));
+        }
+
         private void moveToItem(int index, Vector2? offset = null)
             => AddStep($"move mouse to item {index}", () => InputManager.MoveMouseTo(playlist.ChildrenOfType<DifficultyIcon>().ElementAt(index), offset));
 
@@ -331,11 +341,11 @@ namespace osu.Game.Tests.Visual.Multiplayer
             => AddAssert($"delete button {index} {(visible ? "is" : "is not")} visible",
                 () => (playlist.ChildrenOfType<DrawableRoomPlaylistItem.PlaylistRemoveButton>().ElementAt(2 + index * 2).Alpha > 0) == visible);
 
-        private void createPlaylist(bool allowEdit, bool allowSelection)
+        private void createPlaylist(bool allowEdit, bool allowSelection, bool showItemOwner = false)
         {
             AddStep("create playlist", () =>
             {
-                Child = playlist = new TestPlaylist(allowEdit, allowSelection)
+                Child = playlist = new TestPlaylist(allowEdit, allowSelection, showItemOwner)
                 {
                     Anchor = Anchor.Centre,
                     Origin = Anchor.Centre,
@@ -415,8 +425,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             public new IReadOnlyDictionary<PlaylistItem, RearrangeableListItem<PlaylistItem>> ItemMap => base.ItemMap;
 
-            public TestPlaylist(bool allowEdit, bool allowSelection)
-                : base(allowEdit, allowSelection)
+            public TestPlaylist(bool allowEdit, bool allowSelection, bool showItemOwner = false)
+                : base(allowEdit, allowSelection, showItemOwner: showItemOwner)
             {
             }
         }
diff --git a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs
index f5522cd25d..6deca0482a 100644
--- a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs
+++ b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs
@@ -20,11 +20,13 @@ namespace osu.Game.Screens.OnlinePlay
 
         private readonly bool allowEdit;
         private readonly bool allowSelection;
+        private readonly bool showItemOwner;
 
-        public DrawableRoomPlaylist(bool allowEdit, bool allowSelection, bool reverse = false)
+        public DrawableRoomPlaylist(bool allowEdit, bool allowSelection, bool reverse = false, bool showItemOwner = false)
         {
             this.allowEdit = allowEdit;
             this.allowSelection = allowSelection;
+            this.showItemOwner = showItemOwner;
 
             ((ReversibleFillFlowContainer)ListContainer).Reverse = reverse;
         }
@@ -56,7 +58,7 @@ namespace osu.Game.Screens.OnlinePlay
             Spacing = new Vector2(0, 2)
         };
 
-        protected override OsuRearrangeableListItem<PlaylistItem> CreateOsuDrawable(PlaylistItem item) => new DrawableRoomPlaylistItem(item, allowEdit, allowSelection)
+        protected override OsuRearrangeableListItem<PlaylistItem> CreateOsuDrawable(PlaylistItem item) => new DrawableRoomPlaylistItem(item, allowEdit, allowSelection, showItemOwner)
         {
             SelectedItem = { BindTarget = SelectedItem },
             RequestDeletion = requestDeletion
diff --git a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
index 6c518616e2..6cbdc80d60 100644
--- a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
+++ b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
@@ -69,10 +69,11 @@ namespace osu.Game.Screens.OnlinePlay
 
         private readonly bool allowEdit;
         private readonly bool allowSelection;
+        private readonly bool showItemOwner;
 
         protected override bool ShouldBeConsideredForInput(Drawable child) => allowEdit || !allowSelection || SelectedItem.Value == Model;
 
-        public DrawableRoomPlaylistItem(PlaylistItem item, bool allowEdit, bool allowSelection)
+        public DrawableRoomPlaylistItem(PlaylistItem item, bool allowEdit, bool allowSelection, bool showItemOwner)
             : base(item)
         {
             Item = item;
@@ -80,6 +81,7 @@ namespace osu.Game.Screens.OnlinePlay
             // TODO: edit support should be moved out into a derived class
             this.allowEdit = allowEdit;
             this.allowSelection = allowSelection;
+            this.showItemOwner = showItemOwner;
 
             beatmap.BindTo(item.Beatmap);
             valid.BindTo(item.Valid);
@@ -142,7 +144,12 @@ namespace osu.Game.Screens.OnlinePlay
                 maskingContainer.BorderColour = colours.Red;
             }
 
-            userLookupCache.GetUserAsync(Item.OwnerID).ContinueWith(u => Schedule(() => ownerAvatar.User = u.Result), TaskContinuationOptions.OnlyOnRanToCompletion);
+            if (showItemOwner)
+            {
+                ownerAvatar.Show();
+                userLookupCache.GetUserAsync(Item.OwnerID).ContinueWith(u => Schedule(() => ownerAvatar.User = u.Result), TaskContinuationOptions.OnlyOnRanToCompletion);
+            }
+
             difficultyIconContainer.Child = new DifficultyIcon(Item.Beatmap.Value, ruleset.Value, requiredMods, performBackgroundDifficultyLookup: false) { Size = new Vector2(ICON_HEIGHT) };
 
             panelBackground.Beatmap.Value = Item.Beatmap.Value;
@@ -271,7 +278,7 @@ namespace osu.Game.Screens.OnlinePlay
                                     Anchor = Anchor.CentreRight,
                                     Origin = Anchor.CentreRight,
                                     Direction = FillDirection.Horizontal,
-                                    Margin = new MarginPadding { Left = 8 },
+                                    Margin = new MarginPadding { Horizontal = 8 },
                                     AutoSizeAxes = Axes.Both,
                                     Spacing = new Vector2(5),
                                     ChildrenEnumerable = CreateButtons().Select(button => button.With(b =>
@@ -285,9 +292,10 @@ namespace osu.Game.Screens.OnlinePlay
                                     Anchor = Anchor.Centre,
                                     Origin = Anchor.Centre,
                                     Size = new Vector2(ICON_HEIGHT),
-                                    Margin = new MarginPadding { Left = 8, Right = 8, },
+                                    Margin = new MarginPadding { Right = 8 },
                                     Masking = true,
                                     CornerRadius = 4,
+                                    Alpha = showItemOwner ? 1 : 0
                                 },
                             }
                         }
diff --git a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistWithResults.cs b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistWithResults.cs
index 575f336e58..8b1bb7abc1 100644
--- a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistWithResults.cs
+++ b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistWithResults.cs
@@ -19,13 +19,16 @@ namespace osu.Game.Screens.OnlinePlay
     {
         public Action<PlaylistItem> RequestShowResults;
 
-        public DrawableRoomPlaylistWithResults()
-            : base(false, true)
+        private readonly bool showItemOwner;
+
+        public DrawableRoomPlaylistWithResults(bool showItemOwner = false)
+            : base(false, true, showItemOwner: showItemOwner)
         {
+            this.showItemOwner = showItemOwner;
         }
 
         protected override OsuRearrangeableListItem<PlaylistItem> CreateOsuDrawable(PlaylistItem item) =>
-            new DrawableRoomPlaylistItemWithResults(item, false, true)
+            new DrawableRoomPlaylistItemWithResults(item, false, true, showItemOwner)
             {
                 RequestShowResults = () => RequestShowResults(item),
                 SelectedItem = { BindTarget = SelectedItem },
@@ -35,8 +38,8 @@ namespace osu.Game.Screens.OnlinePlay
         {
             public Action RequestShowResults;
 
-            public DrawableRoomPlaylistItemWithResults(PlaylistItem item, bool allowEdit, bool allowSelection)
-                : base(item, allowEdit, allowSelection)
+            public DrawableRoomPlaylistItemWithResults(PlaylistItem item, bool allowEdit, bool allowSelection, bool showItemOwner)
+                : base(item, allowEdit, allowSelection, showItemOwner)
             {
             }
 
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
index 1e3cfdbcbb..077e9cef93 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
@@ -153,7 +153,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
                                 null,
                                 new Drawable[]
                                 {
-                                    playlist = new DrawableRoomPlaylist(false, false, true)
+                                    playlist = new DrawableRoomPlaylist(false, false, true, true)
                                     {
                                         RelativeSizeAxes = Axes.Both,
                                     },

From 5e56122d650f78c1a69e9890b608aa4d9021c446 Mon Sep 17 00:00:00 2001
From: MK-56 <darioheadleysilva@gmail.com>
Date: Fri, 26 Nov 2021 09:48:38 +0100
Subject: [PATCH 1296/5547] Linear approach type moved per peppys request

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

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModApproachDifferent.cs b/osu.Game.Rulesets.Osu/Mods/OsuModApproachDifferent.cs
index d3a01e5def..ae5ca0d679 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModApproachDifferent.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModApproachDifferent.cs
@@ -89,7 +89,6 @@ namespace osu.Game.Rulesets.Osu.Mods
 
         public enum AnimationStyle
         {
-            Linear,
             Gravity,
             InOut1,
             InOut2,
@@ -99,6 +98,7 @@ namespace osu.Game.Rulesets.Osu.Mods
             Decelerate1,
             Decelerate2,
             Decelerate3,
+            Linear,
         }
     }
 }

From 89b4e5cffbfa5df0815e46e3b8f816baee4228a8 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 26 Nov 2021 18:18:45 +0900
Subject: [PATCH 1297/5547] Rename mass deletion confirmation dialog

---
 .../Settings/Sections/Maintenance/GeneralSettings.cs      | 8 ++++----
 ...lBeatmapsDialog.cs => MassDeleteConfirmationDialog.cs} | 4 ++--
 2 files changed, 6 insertions(+), 6 deletions(-)
 rename osu.Game/Overlays/Settings/Sections/Maintenance/{DeleteAllBeatmapsDialog.cs => MassDeleteConfirmationDialog.cs} (87%)

diff --git a/osu.Game/Overlays/Settings/Sections/Maintenance/GeneralSettings.cs b/osu.Game/Overlays/Settings/Sections/Maintenance/GeneralSettings.cs
index 5bc89ec77c..acdf9cdea6 100644
--- a/osu.Game/Overlays/Settings/Sections/Maintenance/GeneralSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Maintenance/GeneralSettings.cs
@@ -51,7 +51,7 @@ namespace osu.Game.Overlays.Settings.Sections.Maintenance
                 Text = MaintenanceSettingsStrings.DeleteAllBeatmaps,
                 Action = () =>
                 {
-                    dialogOverlay?.Push(new DeleteAllBeatmapsDialog(() =>
+                    dialogOverlay?.Push(new MassDeleteConfirmationDialog(() =>
                     {
                         deleteBeatmapsButton.Enabled.Value = false;
                         Task.Run(() => beatmaps.Delete(beatmaps.GetAllUsableBeatmapSets())).ContinueWith(t => Schedule(() => deleteBeatmapsButton.Enabled.Value = true));
@@ -77,7 +77,7 @@ namespace osu.Game.Overlays.Settings.Sections.Maintenance
                 Text = MaintenanceSettingsStrings.DeleteAllScores,
                 Action = () =>
                 {
-                    dialogOverlay?.Push(new DeleteAllBeatmapsDialog(() =>
+                    dialogOverlay?.Push(new MassDeleteConfirmationDialog(() =>
                     {
                         deleteScoresButton.Enabled.Value = false;
                         Task.Run(() => scores.Delete(scores.GetAllUsableScores())).ContinueWith(t => Schedule(() => deleteScoresButton.Enabled.Value = true));
@@ -103,7 +103,7 @@ namespace osu.Game.Overlays.Settings.Sections.Maintenance
                 Text = MaintenanceSettingsStrings.DeleteAllSkins,
                 Action = () =>
                 {
-                    dialogOverlay?.Push(new DeleteAllBeatmapsDialog(() =>
+                    dialogOverlay?.Push(new MassDeleteConfirmationDialog(() =>
                     {
                         deleteSkinsButton.Enabled.Value = false;
                         Task.Run(() => skins.Delete(skins.GetAllUserSkins())).ContinueWith(t => Schedule(() => deleteSkinsButton.Enabled.Value = true));
@@ -131,7 +131,7 @@ namespace osu.Game.Overlays.Settings.Sections.Maintenance
                     Text = MaintenanceSettingsStrings.DeleteAllCollections,
                     Action = () =>
                     {
-                        dialogOverlay?.Push(new DeleteAllBeatmapsDialog(collectionManager.DeleteAll));
+                        dialogOverlay?.Push(new MassDeleteConfirmationDialog(collectionManager.DeleteAll));
                     }
                 });
             }
diff --git a/osu.Game/Overlays/Settings/Sections/Maintenance/DeleteAllBeatmapsDialog.cs b/osu.Game/Overlays/Settings/Sections/Maintenance/MassDeleteConfirmationDialog.cs
similarity index 87%
rename from osu.Game/Overlays/Settings/Sections/Maintenance/DeleteAllBeatmapsDialog.cs
rename to osu.Game/Overlays/Settings/Sections/Maintenance/MassDeleteConfirmationDialog.cs
index a124501454..6380232bbb 100644
--- a/osu.Game/Overlays/Settings/Sections/Maintenance/DeleteAllBeatmapsDialog.cs
+++ b/osu.Game/Overlays/Settings/Sections/Maintenance/MassDeleteConfirmationDialog.cs
@@ -7,9 +7,9 @@ using osu.Game.Overlays.Dialog;
 
 namespace osu.Game.Overlays.Settings.Sections.Maintenance
 {
-    public class DeleteAllBeatmapsDialog : PopupDialog
+    public class MassDeleteConfirmationDialog : PopupDialog
     {
-        public DeleteAllBeatmapsDialog(Action deleteAction)
+        public MassDeleteConfirmationDialog(Action deleteAction)
         {
             BodyText = "Everything?";
 

From 7f9cc4d5ff9195d9b9de05b8479342574b5b2b4a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 26 Nov 2021 21:37:43 +0900
Subject: [PATCH 1298/5547] Fix incorrect logging of preview tracks without
 track owner

---
 osu.Game/Audio/PreviewTrackManager.cs | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Audio/PreviewTrackManager.cs b/osu.Game/Audio/PreviewTrackManager.cs
index fd9d5a97c6..e631d35180 100644
--- a/osu.Game/Audio/PreviewTrackManager.cs
+++ b/osu.Game/Audio/PreviewTrackManager.cs
@@ -105,7 +105,9 @@ namespace osu.Game.Audio
             protected override void LoadComplete()
             {
                 base.LoadComplete();
-                Logger.Log($"A {nameof(PreviewTrack)} was created without a containing {nameof(IPreviewTrackOwner)}. An owner should be added for correct behaviour.");
+
+                if (Owner == null)
+                    Logger.Log($"A {nameof(PreviewTrack)} was created without a containing {nameof(IPreviewTrackOwner)}. An owner should be added for correct behaviour.");
             }
 
             protected override Track GetTrack() => trackManager.Get($"https://b.ppy.sh/preview/{beatmapSetInfo.OnlineID}.mp3");

From f16ef1ee69fafc74caeb3c3a0964fca3fe58fbfd Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 26 Nov 2021 22:34:05 +0900
Subject: [PATCH 1299/5547] Reapply schedule workaround for `PreviewTrack`

---
 .../Drawables/Cards/Buttons/PlayButton.cs     | 24 ++++++++++++-------
 1 file changed, 15 insertions(+), 9 deletions(-)

diff --git a/osu.Game/Beatmaps/Drawables/Cards/Buttons/PlayButton.cs b/osu.Game/Beatmaps/Drawables/Cards/Buttons/PlayButton.cs
index 4574d37da0..f7bab26666 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/Buttons/PlayButton.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/Buttons/PlayButton.cs
@@ -97,6 +97,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards.Buttons
             if (previewTrack == null)
             {
                 toggleLoading(true);
+
                 LoadComponentAsync(previewTrack = previewTrackManager.Get(beatmapSetInfo), onPreviewLoaded);
             }
             else
@@ -112,18 +113,23 @@ namespace osu.Game.Beatmaps.Drawables.Cards.Buttons
 
         private void onPreviewLoaded(PreviewTrack loadedPreview)
         {
-            // another async load might have completed before this one.
-            // if so, do not make any changes.
-            if (loadedPreview != previewTrack)
-                return;
+            // Make sure that we schedule to after the next audio frame to fix crashes in single-threaded execution.
+            // See: https://github.com/ppy/osu-framework/issues/4692
+            Schedule(() =>
+            {
+                // another async load might have completed before this one.
+                // if so, do not make any changes.
+                if (loadedPreview != previewTrack)
+                    return;
 
-            AddInternal(loadedPreview);
-            toggleLoading(false);
+                AddInternal(loadedPreview);
+                toggleLoading(false);
 
-            loadedPreview.Stopped += () => Schedule(() => Playing.Value = false);
+                loadedPreview.Stopped += () => Schedule(() => Playing.Value = false);
 
-            if (Playing.Value)
-                tryStartPreview();
+                if (Playing.Value)
+                    tryStartPreview();
+            });
         }
 
         private void tryStartPreview()

From b8a47755faa7bc3c28a556ecbe6d66023209526c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 26 Nov 2021 22:54:10 +0900
Subject: [PATCH 1300/5547] Don't show loading tooltip for now

Should probably be replaced with a loading spinner in the future, don't
really like "loading" tooltips.
---
 osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
index 6cbdc80d60..8d9ea91b47 100644
--- a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
+++ b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
@@ -147,7 +147,8 @@ namespace osu.Game.Screens.OnlinePlay
             if (showItemOwner)
             {
                 ownerAvatar.Show();
-                userLookupCache.GetUserAsync(Item.OwnerID).ContinueWith(u => Schedule(() => ownerAvatar.User = u.Result), TaskContinuationOptions.OnlyOnRanToCompletion);
+                userLookupCache.GetUserAsync(Item.OwnerID)
+                               .ContinueWith(u => Schedule(() => ownerAvatar.User = u.Result), TaskContinuationOptions.OnlyOnRanToCompletion);
             }
 
             difficultyIconContainer.Child = new DifficultyIcon(Item.Beatmap.Value, ruleset.Value, requiredMods, performBackgroundDifficultyLookup: false) { Size = new Vector2(ICON_HEIGHT) };
@@ -458,7 +459,7 @@ namespace osu.Game.Screens.OnlinePlay
                 });
             }
 
-            public LocalisableString TooltipText => User == null ? "loading user..." : $"queued by {User.Username}";
+            public LocalisableString TooltipText => User == null ? string.Empty : $"queued by {User.Username}";
 
             private class TooltipArea : Component, IHasTooltip
             {

From 0a75067ee55e880ef108ef5299f590ab56949679 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 27 Nov 2021 12:13:39 +0900
Subject: [PATCH 1301/5547] Update framework

---
 osu.Android.props        | 2 +-
 osu.Game/osu.Game.csproj | 2 +-
 osu.iOS.props            | 4 ++--
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Android.props b/osu.Android.props
index d893792285..eff0eed278 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -52,7 +52,7 @@
   </ItemGroup>
   <ItemGroup>
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1112.0" />
-    <PackageReference Include="ppy.osu.Framework.Android" Version="2021.1124.0" />
+    <PackageReference Include="ppy.osu.Framework.Android" Version="2021.1127.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
     <!-- Realm needs to be directly referenced in all Xamarin projects, as it will not pull in its transitive dependencies otherwise. -->
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index f9c8d9743d..7cc8893d8d 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="10.7.1" />
-    <PackageReference Include="ppy.osu.Framework" Version="2021.1124.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2021.1127.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1112.0" />
     <PackageReference Include="Sentry" Version="3.11.1" />
     <PackageReference Include="SharpCompress" Version="0.30.0" />
diff --git a/osu.iOS.props b/osu.iOS.props
index 47f8fbb43a..9c21f76617 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -60,7 +60,7 @@
     <Reference Include="System.Net.Http" />
   </ItemGroup>
   <ItemGroup Label="Package References">
-    <PackageReference Include="ppy.osu.Framework.iOS" Version="2021.1124.0" />
+    <PackageReference Include="ppy.osu.Framework.iOS" Version="2021.1127.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1112.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net5.0 / net6.0) -->
@@ -83,7 +83,7 @@
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="2.2.6" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.Core" Version="2.2.6" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
-    <PackageReference Include="ppy.osu.Framework" Version="2021.1124.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2021.1127.0" />
     <PackageReference Include="SharpCompress" Version="0.30.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
     <PackageReference Include="SharpRaven" Version="2.4.0" />

From 0df97744ad8425e7b62dd8ea305a07310d921066 Mon Sep 17 00:00:00 2001
From: mk-56 <dhsjplt@gmail.com>
Date: Sat, 27 Nov 2021 13:34:09 +0100
Subject: [PATCH 1302/5547] Moved linear to a better place.

i decided to go with leaving it under gravity, its plenty visible and fine there, since the public enum list self orders I wasn't sure about how i could set a default that wasn't the topmost option
---
 osu.Game.Rulesets.Osu/Mods/OsuModApproachDifferent.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModApproachDifferent.cs b/osu.Game.Rulesets.Osu/Mods/OsuModApproachDifferent.cs
index ae5ca0d679..6aeb378c69 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModApproachDifferent.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModApproachDifferent.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;
@@ -90,6 +90,7 @@ namespace osu.Game.Rulesets.Osu.Mods
         public enum AnimationStyle
         {
             Gravity,
+            Linear,
             InOut1,
             InOut2,
             Accelerate1,
@@ -98,7 +99,6 @@ namespace osu.Game.Rulesets.Osu.Mods
             Decelerate1,
             Decelerate2,
             Decelerate3,
-            Linear,
         }
     }
 }

From f4b7db5a7bfb89e18b5ac83bbd89ca339e07a6eb Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 27 Nov 2021 14:36:34 +0100
Subject: [PATCH 1303/5547] Ensure correct disabled beatmap callback scheduling
 in now playing overlay

---
 osu.Game/Overlays/NowPlayingOverlay.cs | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Overlays/NowPlayingOverlay.cs b/osu.Game/Overlays/NowPlayingOverlay.cs
index f37e6bedf7..4dd23c0008 100644
--- a/osu.Game/Overlays/NowPlayingOverlay.cs
+++ b/osu.Game/Overlays/NowPlayingOverlay.cs
@@ -214,7 +214,8 @@ namespace osu.Game.Overlays
         {
             base.LoadComplete();
 
-            beatmap.BindDisabledChanged(beatmapDisabledChanged, true);
+            beatmap.BindDisabledChanged(_ => Scheduler.AddOnce(beatmapDisabledChanged));
+            beatmapDisabledChanged();
 
             musicController.TrackChanged += trackChanged;
             trackChanged(beatmap.Value);
@@ -318,8 +319,10 @@ namespace osu.Game.Overlays
             };
         }
 
-        private void beatmapDisabledChanged(bool disabled)
+        private void beatmapDisabledChanged()
         {
+            bool disabled = beatmap.Disabled;
+
             if (disabled)
                 playlist?.Hide();
 

From 567c985da0faf08c088c42276a6e6a4cb9218048 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 27 Nov 2021 14:56:27 +0100
Subject: [PATCH 1304/5547] Remove beatmap panel test scene

---
 .../Visual/Online/TestSceneDirectPanel.cs     | 137 ------------------
 1 file changed, 137 deletions(-)
 delete mode 100644 osu.Game.Tests/Visual/Online/TestSceneDirectPanel.cs

diff --git a/osu.Game.Tests/Visual/Online/TestSceneDirectPanel.cs b/osu.Game.Tests/Visual/Online/TestSceneDirectPanel.cs
deleted file mode 100644
index 510b9e8483..0000000000
--- a/osu.Game.Tests/Visual/Online/TestSceneDirectPanel.cs
+++ /dev/null
@@ -1,137 +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.Collections.Generic;
-using osu.Framework.Allocation;
-using osu.Framework.Graphics;
-using osu.Framework.Graphics.Containers;
-using osu.Game.Audio;
-using osu.Game.Beatmaps;
-using osu.Game.Online.API.Requests.Responses;
-using osu.Game.Overlays.BeatmapListing.Panels;
-using osu.Game.Rulesets;
-using osuTK;
-using APIUser = osu.Game.Online.API.Requests.Responses.APIUser;
-
-namespace osu.Game.Tests.Visual.Online
-{
-    [Cached(typeof(IPreviewTrackOwner))]
-    public class TestSceneDirectPanel : OsuTestScene, IPreviewTrackOwner
-    {
-        [BackgroundDependencyLoader]
-        private void load(RulesetStore rulesets)
-        {
-            var normal = getBeatmapSet();
-            normal.HasVideo = true;
-            normal.HasStoryboard = true;
-
-            var undownloadable = getUndownloadableBeatmapSet();
-            var manyDifficulties = getManyDifficultiesBeatmapSet();
-
-            var explicitMap = getBeatmapSet();
-            explicitMap.HasExplicitContent = true;
-
-            var featuredMap = getBeatmapSet();
-            featuredMap.TrackId = 1;
-
-            var explicitFeaturedMap = getBeatmapSet();
-            explicitFeaturedMap.HasExplicitContent = true;
-            explicitFeaturedMap.TrackId = 2;
-
-            Child = new BasicScrollContainer
-            {
-                RelativeSizeAxes = Axes.Both,
-                Child = new FillFlowContainer
-                {
-                    RelativeSizeAxes = Axes.X,
-                    AutoSizeAxes = Axes.Y,
-                    Direction = FillDirection.Full,
-                    Padding = new MarginPadding(20),
-                    Spacing = new Vector2(5, 20),
-                    Children = new Drawable[]
-                    {
-                        new GridBeatmapPanel(normal),
-                        new GridBeatmapPanel(undownloadable),
-                        new GridBeatmapPanel(manyDifficulties),
-                        new GridBeatmapPanel(explicitMap),
-                        new GridBeatmapPanel(featuredMap),
-                        new GridBeatmapPanel(explicitFeaturedMap),
-                        new ListBeatmapPanel(normal),
-                        new ListBeatmapPanel(undownloadable),
-                        new ListBeatmapPanel(manyDifficulties),
-                        new ListBeatmapPanel(explicitMap),
-                        new ListBeatmapPanel(featuredMap),
-                        new ListBeatmapPanel(explicitFeaturedMap)
-                    },
-                },
-            };
-
-            APIBeatmapSet getBeatmapSet() => CreateAPIBeatmapSet(Ruleset.Value);
-
-            APIBeatmapSet getUndownloadableBeatmapSet() => new APIBeatmapSet
-            {
-                OnlineID = 123,
-                Title = "undownloadable beatmap",
-                Artist = "test",
-                Source = "more tests",
-                Author = new APIUser
-                {
-                    Username = "BanchoBot",
-                    Id = 3,
-                },
-                Availability = new BeatmapSetOnlineAvailability
-                {
-                    DownloadDisabled = true,
-                },
-                Preview = @"https://b.ppy.sh/preview/12345.mp3",
-                PlayCount = 123,
-                FavouriteCount = 456,
-                BPM = 111,
-                HasVideo = true,
-                HasStoryboard = true,
-                Covers = new BeatmapSetOnlineCovers(),
-                Beatmaps = new[]
-                {
-                    new APIBeatmap
-                    {
-                        RulesetID = Ruleset.Value.OnlineID,
-                        DifficultyName = "Test",
-                        StarRating = 6.42,
-                    }
-                }
-            };
-
-            APIBeatmapSet getManyDifficultiesBeatmapSet()
-            {
-                var beatmaps = new List<APIBeatmap>();
-
-                for (int i = 0; i < 100; i++)
-                {
-                    beatmaps.Add(new APIBeatmap
-                    {
-                        RulesetID = i % 4,
-                        StarRating = 2 + i % 4 * 2,
-                        OverallDifficulty = 3.5f,
-                    });
-                }
-
-                return new APIBeatmapSet
-                {
-                    OnlineID = 1,
-                    Title = "undownloadable beatmap",
-                    Artist = "test",
-                    Source = "more tests",
-                    Author = new APIUser
-                    {
-                        Username = "BanchoBot",
-                        Id = 3,
-                    },
-                    HasVideo = true,
-                    HasStoryboard = true,
-                    Covers = new BeatmapSetOnlineCovers(),
-                    Beatmaps = beatmaps.ToArray(),
-                };
-            }
-        }
-    }
-}

From 6773877a40c532732d92fbbb1b655fd87ce92ef9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 27 Nov 2021 15:00:06 +0100
Subject: [PATCH 1305/5547] Remove no-longer-used beatmap panels

---
 .../BeatmapListing/Panels/BeatmapPanel.cs     | 216 --------------
 .../BeatmapListing/Panels/GridBeatmapPanel.cs | 269 ------------------
 .../BeatmapListing/Panels/ListBeatmapPanel.cs | 267 -----------------
 3 files changed, 752 deletions(-)
 delete mode 100644 osu.Game/Overlays/BeatmapListing/Panels/BeatmapPanel.cs
 delete mode 100644 osu.Game/Overlays/BeatmapListing/Panels/GridBeatmapPanel.cs
 delete mode 100644 osu.Game/Overlays/BeatmapListing/Panels/ListBeatmapPanel.cs

diff --git a/osu.Game/Overlays/BeatmapListing/Panels/BeatmapPanel.cs b/osu.Game/Overlays/BeatmapListing/Panels/BeatmapPanel.cs
deleted file mode 100644
index 34086c214f..0000000000
--- a/osu.Game/Overlays/BeatmapListing/Panels/BeatmapPanel.cs
+++ /dev/null
@@ -1,216 +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.Diagnostics;
-using System.Linq;
-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.Effects;
-using osu.Framework.Graphics.Shapes;
-using osu.Framework.Graphics.Sprites;
-using osu.Framework.Graphics.UserInterface;
-using osu.Framework.Input.Events;
-using osu.Game.Audio;
-using osu.Game.Beatmaps;
-using osu.Game.Beatmaps.Drawables;
-using osu.Game.Graphics;
-using osu.Game.Graphics.Containers;
-using osu.Game.Graphics.Sprites;
-using osu.Game.Graphics.UserInterface;
-using osu.Game.Online.API.Requests.Responses;
-using osuTK;
-using osuTK.Graphics;
-
-namespace osu.Game.Overlays.BeatmapListing.Panels
-{
-    public abstract class BeatmapPanel : OsuClickableContainer, IHasContextMenu
-    {
-        public readonly APIBeatmapSet SetInfo;
-
-        private const double hover_transition_time = 400;
-        private const int maximum_difficulty_icons = 10;
-
-        private Container content;
-
-        public PreviewTrack Preview => PlayButton.Preview;
-        public IBindable<bool> PreviewPlaying => PlayButton?.Playing;
-
-        protected abstract PlayButton PlayButton { get; }
-        protected abstract Box PreviewBar { get; }
-
-        protected virtual bool FadePlayButton => true;
-
-        protected override Container<Drawable> Content => content;
-
-        protected Action ViewBeatmap;
-
-        protected BeatmapPanel(APIBeatmapSet setInfo)
-            : base(HoverSampleSet.Submit)
-        {
-            Debug.Assert(setInfo.OnlineID > 0);
-
-            SetInfo = setInfo;
-        }
-
-        private readonly EdgeEffectParameters edgeEffectNormal = new EdgeEffectParameters
-        {
-            Type = EdgeEffectType.Shadow,
-            Offset = new Vector2(0f, 1f),
-            Radius = 2f,
-            Colour = Color4.Black.Opacity(0.25f),
-        };
-
-        private readonly EdgeEffectParameters edgeEffectHovered = new EdgeEffectParameters
-        {
-            Type = EdgeEffectType.Shadow,
-            Offset = new Vector2(0f, 5f),
-            Radius = 10f,
-            Colour = Color4.Black.Opacity(0.3f),
-        };
-
-        [BackgroundDependencyLoader(permitNulls: true)]
-        private void load(BeatmapManager beatmaps, OsuColour colours, BeatmapSetOverlay beatmapSetOverlay)
-        {
-            AddInternal(content = new Container
-            {
-                RelativeSizeAxes = Axes.Both,
-                Masking = true,
-                EdgeEffect = edgeEffectNormal,
-                Children = new[]
-                {
-                    CreateBackground(),
-                    new DownloadProgressBar(SetInfo)
-                    {
-                        Anchor = Anchor.BottomLeft,
-                        Origin = Anchor.BottomLeft,
-                        Depth = -1,
-                    },
-                }
-            });
-
-            Action = ViewBeatmap = () =>
-            {
-                Debug.Assert(SetInfo.OnlineID > 0);
-                beatmapSetOverlay?.FetchAndShowBeatmapSet(SetInfo.OnlineID);
-            };
-        }
-
-        protected override void Update()
-        {
-            base.Update();
-
-            if (PreviewPlaying.Value && Preview != null && Preview.TrackLoaded)
-            {
-                PreviewBar.Width = (float)(Preview.CurrentTime / Preview.Length);
-            }
-        }
-
-        protected override bool OnHover(HoverEvent e)
-        {
-            content.TweenEdgeEffectTo(edgeEffectHovered, hover_transition_time, Easing.OutQuint);
-            content.MoveToY(-4, hover_transition_time, Easing.OutQuint);
-            if (FadePlayButton)
-                PlayButton.FadeIn(120, Easing.InOutQuint);
-
-            return base.OnHover(e);
-        }
-
-        protected override void OnHoverLost(HoverLostEvent e)
-        {
-            content.TweenEdgeEffectTo(edgeEffectNormal, hover_transition_time, Easing.OutQuint);
-            content.MoveToY(0, hover_transition_time, Easing.OutQuint);
-            if (FadePlayButton && !PreviewPlaying.Value)
-                PlayButton.FadeOut(120, Easing.InOutQuint);
-
-            base.OnHoverLost(e);
-        }
-
-        protected override void LoadComplete()
-        {
-            base.LoadComplete();
-            this.FadeInFromZero(200, Easing.Out);
-
-            PreviewPlaying.ValueChanged += playing =>
-            {
-                PlayButton.FadeTo(playing.NewValue || IsHovered || !FadePlayButton ? 1 : 0, 120, Easing.InOutQuint);
-                PreviewBar.FadeTo(playing.NewValue ? 1 : 0, 120, Easing.InOutQuint);
-            };
-        }
-
-        protected List<DifficultyIcon> GetDifficultyIcons(OsuColour colours)
-        {
-            var icons = new List<DifficultyIcon>();
-
-            if (SetInfo.Beatmaps.Length > maximum_difficulty_icons)
-            {
-                foreach (var ruleset in SetInfo.Beatmaps.Select(b => b.Ruleset).Distinct())
-                    icons.Add(new GroupedDifficultyIcon(SetInfo.Beatmaps.Where(b => b.RulesetID == ruleset.OnlineID).ToList(), ruleset, this is ListBeatmapPanel ? Color4.White : colours.Gray5));
-            }
-            else
-            {
-                foreach (var b in SetInfo.Beatmaps.OrderBy(beatmap => beatmap.RulesetID).ThenBy(beatmap => beatmap.StarRating))
-                    icons.Add(new DifficultyIcon(b));
-            }
-
-            return icons;
-        }
-
-        protected Drawable CreateBackground() => new UpdateableOnlineBeatmapSetCover
-        {
-            RelativeSizeAxes = Axes.Both,
-            OnlineInfo = SetInfo,
-        };
-
-        public class Statistic : FillFlowContainer
-        {
-            private readonly SpriteText text;
-
-            private int value;
-
-            public int Value
-            {
-                get => value;
-                set
-                {
-                    this.value = value;
-                    text.Text = Value.ToString(@"N0");
-                }
-            }
-
-            public Statistic(IconUsage icon, int value = 0)
-            {
-                Anchor = Anchor.TopRight;
-                Origin = Anchor.TopRight;
-                AutoSizeAxes = Axes.Both;
-                Direction = FillDirection.Horizontal;
-                Spacing = new Vector2(5f, 0f);
-
-                Children = new Drawable[]
-                {
-                    text = new OsuSpriteText { Font = OsuFont.GetFont(weight: FontWeight.SemiBold, italics: true) },
-                    new SpriteIcon
-                    {
-                        Anchor = Anchor.CentreLeft,
-                        Origin = Anchor.CentreLeft,
-                        Icon = icon,
-                        Shadow = true,
-                        Size = new Vector2(14),
-                    },
-                };
-
-                Value = value;
-            }
-        }
-
-        public MenuItem[] ContextMenuItems => new MenuItem[]
-        {
-            new OsuMenuItem("View Beatmap", MenuItemType.Highlighted, ViewBeatmap),
-        };
-    }
-}
diff --git a/osu.Game/Overlays/BeatmapListing/Panels/GridBeatmapPanel.cs b/osu.Game/Overlays/BeatmapListing/Panels/GridBeatmapPanel.cs
deleted file mode 100644
index 770e5af7bd..0000000000
--- a/osu.Game/Overlays/BeatmapListing/Panels/GridBeatmapPanel.cs
+++ /dev/null
@@ -1,269 +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.Extensions.Color4Extensions;
-using osu.Framework.Graphics;
-using osu.Framework.Graphics.Containers;
-using osu.Framework.Graphics.Shapes;
-using osu.Framework.Graphics.Sprites;
-using osu.Framework.Input.Events;
-using osu.Framework.Localisation;
-using osu.Game.Beatmaps.Drawables;
-using osu.Game.Graphics;
-using osu.Game.Graphics.Containers;
-using osu.Game.Graphics.Sprites;
-using osu.Game.Online.API.Requests.Responses;
-using osu.Game.Overlays.BeatmapSet;
-using osuTK;
-using osuTK.Graphics;
-
-namespace osu.Game.Overlays.BeatmapListing.Panels
-{
-    public class GridBeatmapPanel : BeatmapPanel
-    {
-        private const float horizontal_padding = 10;
-        private const float vertical_padding = 5;
-
-        private FillFlowContainer bottomPanel, statusContainer, titleContainer, artistContainer;
-        private PlayButton playButton;
-        private Box progressBar;
-
-        protected override PlayButton PlayButton => playButton;
-        protected override Box PreviewBar => progressBar;
-
-        public GridBeatmapPanel(APIBeatmapSet beatmap)
-            : base(beatmap)
-        {
-            Width = 380;
-            Height = 140 + vertical_padding; // full height of all the elements plus vertical padding (autosize uses the image)
-        }
-
-        protected override void LoadComplete()
-        {
-            base.LoadComplete();
-            bottomPanel.LayoutDuration = 200;
-            bottomPanel.LayoutEasing = Easing.Out;
-            bottomPanel.Origin = Anchor.BottomLeft;
-        }
-
-        [BackgroundDependencyLoader]
-        private void load(OsuColour colours)
-        {
-            Content.CornerRadius = 4;
-
-            AddRange(new Drawable[]
-            {
-                new Box
-                {
-                    RelativeSizeAxes = Axes.Both,
-                    Colour = Color4.Black.Opacity(0.5f),
-                },
-                bottomPanel = new FillFlowContainer
-                {
-                    Anchor = Anchor.BottomLeft,
-                    Origin = Anchor.TopLeft,
-                    Direction = FillDirection.Vertical,
-                    RelativeSizeAxes = Axes.X,
-                    AutoSizeAxes = Axes.Y,
-                    Spacing = new Vector2(0f, vertical_padding),
-                    Children = new Drawable[]
-                    {
-                        new FillFlowContainer
-                        {
-                            AutoSizeAxes = Axes.Both,
-                            Padding = new MarginPadding { Left = horizontal_padding, Right = horizontal_padding },
-                            Direction = FillDirection.Vertical,
-                            Children = new Drawable[]
-                            {
-                                titleContainer = new FillFlowContainer
-                                {
-                                    AutoSizeAxes = Axes.Both,
-                                    Direction = FillDirection.Horizontal,
-                                    Children = new Drawable[]
-                                    {
-                                        new OsuSpriteText
-                                        {
-                                            Text = new RomanisableString(SetInfo.TitleUnicode, SetInfo.Title),
-                                            Font = OsuFont.GetFont(size: 18, weight: FontWeight.Bold, italics: true)
-                                        },
-                                    }
-                                },
-                                artistContainer = new FillFlowContainer
-                                {
-                                    AutoSizeAxes = Axes.Both,
-                                    Direction = FillDirection.Horizontal,
-                                    Children = new Drawable[]
-                                    {
-                                        new OsuSpriteText
-                                        {
-                                            Text = new RomanisableString(SetInfo.ArtistUnicode, SetInfo.Artist),
-                                            Font = OsuFont.GetFont(weight: FontWeight.Bold, italics: true)
-                                        }
-                                    }
-                                }
-                            },
-                        },
-                        new Container
-                        {
-                            RelativeSizeAxes = Axes.X,
-                            AutoSizeAxes = Axes.Y,
-                            Children = new Drawable[]
-                            {
-                                new Box
-                                {
-                                    RelativeSizeAxes = Axes.Both,
-                                },
-                                progressBar = new Box
-                                {
-                                    Origin = Anchor.BottomLeft,
-                                    RelativeSizeAxes = Axes.X,
-                                    BypassAutoSizeAxes = Axes.Both,
-                                    Size = new Vector2(0, 3),
-                                    Alpha = 0,
-                                    Colour = colours.Yellow,
-                                },
-                                new FillFlowContainer
-                                {
-                                    RelativeSizeAxes = Axes.X,
-                                    AutoSizeAxes = Axes.Y,
-                                    Direction = FillDirection.Vertical,
-                                    Padding = new MarginPadding
-                                    {
-                                        Top = vertical_padding,
-                                        Bottom = vertical_padding,
-                                        Left = horizontal_padding,
-                                        Right = horizontal_padding,
-                                    },
-                                    Children = new Drawable[]
-                                    {
-                                        new LinkFlowContainer(s =>
-                                        {
-                                            s.Shadow = false;
-                                            s.Font = OsuFont.GetFont(size: 14);
-                                        }).With(d =>
-                                        {
-                                            d.AutoSizeAxes = Axes.Both;
-                                            d.AddText("mapped by ", t => t.Colour = colours.Gray5);
-                                            d.AddUserLink(SetInfo.Author);
-                                        }),
-                                        new Container
-                                        {
-                                            AutoSizeAxes = Axes.X,
-                                            Height = 14,
-                                            Children = new[]
-                                            {
-                                                new OsuSpriteText
-                                                {
-                                                    Text = SetInfo.Source,
-                                                    Font = OsuFont.GetFont(size: 14),
-                                                    Shadow = false,
-                                                    Colour = colours.Gray5,
-                                                    Alpha = string.IsNullOrEmpty(SetInfo.Source) ? 0f : 1f,
-                                                },
-                                            },
-                                        },
-                                        new FillFlowContainer
-                                        {
-                                            AutoSizeAxes = Axes.X,
-                                            Height = 20,
-                                            Margin = new MarginPadding { Top = vertical_padding, Bottom = vertical_padding },
-                                            Spacing = new Vector2(3),
-                                            Children = GetDifficultyIcons(colours),
-                                        },
-                                    },
-                                },
-                                new BeatmapPanelDownloadButton(SetInfo)
-                                {
-                                    Size = new Vector2(50, 30),
-                                    Margin = new MarginPadding(horizontal_padding),
-                                    Anchor = Anchor.TopRight,
-                                    Origin = Anchor.TopRight,
-                                },
-                            },
-                        },
-                    },
-                },
-                new FillFlowContainer
-                {
-                    Anchor = Anchor.TopRight,
-                    Origin = Anchor.TopRight,
-                    AutoSizeAxes = Axes.Both,
-                    Direction = FillDirection.Vertical,
-                    Margin = new MarginPadding { Top = vertical_padding, Right = vertical_padding },
-                    Children = new[]
-                    {
-                        new Statistic(FontAwesome.Solid.PlayCircle, SetInfo.PlayCount),
-                        new Statistic(FontAwesome.Solid.Heart, SetInfo.FavouriteCount),
-                    },
-                },
-                statusContainer = new FillFlowContainer
-                {
-                    AutoSizeAxes = Axes.Both,
-                    Margin = new MarginPadding { Top = 5, Left = 5 },
-                    Spacing = new Vector2(5),
-                },
-                playButton = new PlayButton(SetInfo)
-                {
-                    Margin = new MarginPadding { Top = 5, Left = 10 },
-                    Size = new Vector2(30),
-                    Alpha = 0,
-                },
-            });
-
-            if (SetInfo.HasExplicitContent)
-            {
-                titleContainer.Add(new ExplicitContentBeatmapPill
-                {
-                    Anchor = Anchor.CentreLeft,
-                    Origin = Anchor.CentreLeft,
-                    Margin = new MarginPadding { Left = 10f, Top = 2f },
-                });
-            }
-
-            if (SetInfo.TrackId != null)
-            {
-                artistContainer.Add(new FeaturedArtistBeatmapPill
-                {
-                    Anchor = Anchor.CentreLeft,
-                    Origin = Anchor.CentreLeft,
-                    Margin = new MarginPadding { Left = 10f, Top = 2f },
-                });
-            }
-
-            if (SetInfo.HasVideo)
-            {
-                statusContainer.Add(new IconPill(FontAwesome.Solid.Film));
-            }
-
-            if (SetInfo.HasStoryboard)
-            {
-                statusContainer.Add(new IconPill(FontAwesome.Solid.Image));
-            }
-
-            statusContainer.Add(new BeatmapSetOnlineStatusPill
-            {
-                AutoSizeAxes = Axes.Both,
-                TextSize = 12,
-                TextPadding = new MarginPadding { Horizontal = 10, Vertical = 5 },
-                Status = SetInfo.Status,
-            });
-
-            PreviewPlaying.ValueChanged += _ => updateStatusContainer();
-        }
-
-        protected override bool OnHover(HoverEvent e)
-        {
-            updateStatusContainer();
-            return base.OnHover(e);
-        }
-
-        protected override void OnHoverLost(HoverLostEvent e)
-        {
-            base.OnHoverLost(e);
-            updateStatusContainer();
-        }
-
-        private void updateStatusContainer() => statusContainer.FadeTo(IsHovered || PreviewPlaying.Value ? 0 : 1, 120, Easing.InOutQuint);
-    }
-}
diff --git a/osu.Game/Overlays/BeatmapListing/Panels/ListBeatmapPanel.cs b/osu.Game/Overlays/BeatmapListing/Panels/ListBeatmapPanel.cs
deleted file mode 100644
index dcd676724a..0000000000
--- a/osu.Game/Overlays/BeatmapListing/Panels/ListBeatmapPanel.cs
+++ /dev/null
@@ -1,267 +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.Extensions.Color4Extensions;
-using osu.Framework.Graphics;
-using osu.Framework.Graphics.Colour;
-using osu.Framework.Graphics.Containers;
-using osu.Framework.Graphics.Shapes;
-using osu.Framework.Graphics.Sprites;
-using osu.Framework.Localisation;
-using osu.Game.Beatmaps.Drawables;
-using osu.Game.Graphics;
-using osu.Game.Graphics.Containers;
-using osu.Game.Graphics.Sprites;
-using osu.Game.Online.API.Requests.Responses;
-using osu.Game.Overlays.BeatmapSet;
-using osuTK;
-using osuTK.Graphics;
-
-namespace osu.Game.Overlays.BeatmapListing.Panels
-{
-    public class ListBeatmapPanel : BeatmapPanel
-    {
-        private const float transition_duration = 120;
-        private const float horizontal_padding = 10;
-        private const float vertical_padding = 5;
-        private const float height = 70;
-
-        private FillFlowContainer statusContainer, titleContainer, artistContainer;
-        protected BeatmapPanelDownloadButton DownloadButton;
-        private PlayButton playButton;
-        private Box progressBar;
-
-        protected override bool FadePlayButton => false;
-
-        protected override PlayButton PlayButton => playButton;
-        protected override Box PreviewBar => progressBar;
-
-        public ListBeatmapPanel(APIBeatmapSet beatmap)
-            : base(beatmap)
-        {
-            RelativeSizeAxes = Axes.X;
-            Height = height;
-        }
-
-        [BackgroundDependencyLoader]
-        private void load(OsuColour colours)
-        {
-            Content.CornerRadius = 5;
-
-            AddRange(new Drawable[]
-            {
-                new Box
-                {
-                    RelativeSizeAxes = Axes.Both,
-                    Colour = ColourInfo.GradientHorizontal(Color4.Black.Opacity(0.25f), Color4.Black.Opacity(0.75f)),
-                },
-                new Container
-                {
-                    RelativeSizeAxes = Axes.Both,
-                    Padding = new MarginPadding { Top = vertical_padding, Bottom = vertical_padding, Left = horizontal_padding, Right = vertical_padding },
-                    Children = new Drawable[]
-                    {
-                        new FillFlowContainer
-                        {
-                            Origin = Anchor.CentreLeft,
-                            Anchor = Anchor.CentreLeft,
-                            AutoSizeAxes = Axes.Both,
-                            Direction = FillDirection.Horizontal,
-                            LayoutEasing = Easing.OutQuint,
-                            LayoutDuration = transition_duration,
-                            Spacing = new Vector2(10, 0),
-                            Children = new Drawable[]
-                            {
-                                new FillFlowContainer
-                                {
-                                    AutoSizeAxes = Axes.Both,
-                                    Direction = FillDirection.Vertical,
-                                    Children = new Drawable[]
-                                    {
-                                        new FillFlowContainer
-                                        {
-                                            AutoSizeAxes = Axes.Both,
-                                            Direction = FillDirection.Horizontal,
-                                            Children = new Drawable[]
-                                            {
-                                                playButton = new PlayButton(SetInfo)
-                                                {
-                                                    Origin = Anchor.CentreLeft,
-                                                    Anchor = Anchor.CentreLeft,
-                                                    Size = new Vector2(height / 3),
-                                                    FillMode = FillMode.Fit,
-                                                    Margin = new MarginPadding { Right = 10 },
-                                                },
-                                                new FillFlowContainer
-                                                {
-                                                    AutoSizeAxes = Axes.Both,
-                                                    Direction = FillDirection.Vertical,
-                                                    Children = new Drawable[]
-                                                    {
-                                                        titleContainer = new FillFlowContainer
-                                                        {
-                                                            AutoSizeAxes = Axes.Both,
-                                                            Direction = FillDirection.Horizontal,
-                                                            Children = new[]
-                                                            {
-                                                                new OsuSpriteText
-                                                                {
-                                                                    Text = new RomanisableString(SetInfo.TitleUnicode, SetInfo.Title),
-                                                                    Font = OsuFont.GetFont(size: 18, weight: FontWeight.Bold, italics: true)
-                                                                },
-                                                            }
-                                                        },
-                                                        artistContainer = new FillFlowContainer
-                                                        {
-                                                            AutoSizeAxes = Axes.Both,
-                                                            Direction = FillDirection.Horizontal,
-                                                            Children = new[]
-                                                            {
-                                                                new OsuSpriteText
-                                                                {
-                                                                    Text = new RomanisableString(SetInfo.ArtistUnicode, SetInfo.Artist),
-                                                                    Font = OsuFont.GetFont(weight: FontWeight.Bold, italics: true)
-                                                                },
-                                                            },
-                                                        },
-                                                    }
-                                                },
-                                            }
-                                        },
-                                        new FillFlowContainer
-                                        {
-                                            AutoSizeAxes = Axes.Both,
-                                            Direction = FillDirection.Horizontal,
-                                            Children = new Drawable[]
-                                            {
-                                                statusContainer = new FillFlowContainer
-                                                {
-                                                    AutoSizeAxes = Axes.Both,
-                                                    Margin = new MarginPadding { Vertical = vertical_padding, Horizontal = 5 },
-                                                    Spacing = new Vector2(5),
-                                                },
-                                                new FillFlowContainer
-                                                {
-                                                    AutoSizeAxes = Axes.X,
-                                                    Height = 20,
-                                                    Margin = new MarginPadding { Top = vertical_padding, Bottom = vertical_padding },
-                                                    Spacing = new Vector2(3),
-                                                    Children = GetDifficultyIcons(colours),
-                                                },
-                                            },
-                                        },
-                                    },
-                                },
-                            }
-                        },
-                        new FillFlowContainer
-                        {
-                            Anchor = Anchor.TopRight,
-                            Origin = Anchor.TopRight,
-                            AutoSizeAxes = Axes.Both,
-                            Direction = FillDirection.Horizontal,
-                            Children = new Drawable[]
-                            {
-                                new Container
-                                {
-                                    Anchor = Anchor.CentreRight,
-                                    Origin = Anchor.CentreRight,
-                                    AutoSizeAxes = Axes.Both,
-                                    Child = DownloadButton = new BeatmapPanelDownloadButton(SetInfo)
-                                    {
-                                        Size = new Vector2(height - vertical_padding * 3),
-                                        Margin = new MarginPadding { Left = vertical_padding * 2, Right = vertical_padding },
-                                    },
-                                },
-                                new FillFlowContainer
-                                {
-                                    Anchor = Anchor.TopRight,
-                                    Origin = Anchor.TopRight,
-                                    AutoSizeAxes = Axes.Both,
-                                    Direction = FillDirection.Vertical,
-                                    Children = new Drawable[]
-                                    {
-                                        new Statistic(FontAwesome.Solid.PlayCircle, SetInfo.PlayCount),
-                                        new Statistic(FontAwesome.Solid.Heart, SetInfo.FavouriteCount),
-                                        new LinkFlowContainer(s =>
-                                        {
-                                            s.Shadow = false;
-                                            s.Font = OsuFont.GetFont(size: 14);
-                                        })
-                                        {
-                                            Anchor = Anchor.TopRight,
-                                            Origin = Anchor.TopRight,
-                                            AutoSizeAxes = Axes.Both,
-                                        }.With(d =>
-                                        {
-                                            d.AutoSizeAxes = Axes.Both;
-                                            d.AddText("mapped by ");
-                                            d.AddUserLink(SetInfo.Author);
-                                        }),
-                                        new OsuSpriteText
-                                        {
-                                            Text = SetInfo.Source,
-                                            Anchor = Anchor.TopRight,
-                                            Origin = Anchor.TopRight,
-                                            Font = OsuFont.GetFont(size: 14),
-                                            Alpha = string.IsNullOrEmpty(SetInfo.Source) ? 0f : 1f,
-                                        },
-                                    },
-                                },
-                            },
-                        },
-                    },
-                },
-                progressBar = new Box
-                {
-                    Anchor = Anchor.BottomLeft,
-                    Origin = Anchor.BottomLeft,
-                    RelativeSizeAxes = Axes.X,
-                    BypassAutoSizeAxes = Axes.Y,
-                    Size = new Vector2(0, 3),
-                    Alpha = 0,
-                    Colour = colours.Yellow,
-                },
-            });
-
-            if (SetInfo.HasExplicitContent)
-            {
-                titleContainer.Add(new ExplicitContentBeatmapPill
-                {
-                    Anchor = Anchor.CentreLeft,
-                    Origin = Anchor.CentreLeft,
-                    Margin = new MarginPadding { Left = 10f, Top = 2f },
-                });
-            }
-
-            if (SetInfo.TrackId != null)
-            {
-                artistContainer.Add(new FeaturedArtistBeatmapPill
-                {
-                    Anchor = Anchor.CentreLeft,
-                    Origin = Anchor.CentreLeft,
-                    Margin = new MarginPadding { Left = 10f, Top = 2f },
-                });
-            }
-
-            if (SetInfo.HasVideo)
-            {
-                statusContainer.Add(new IconPill(FontAwesome.Solid.Film) { IconSize = new Vector2(20) });
-            }
-
-            if (SetInfo.HasStoryboard)
-            {
-                statusContainer.Add(new IconPill(FontAwesome.Solid.Image) { IconSize = new Vector2(20) });
-            }
-
-            statusContainer.Add(new BeatmapSetOnlineStatusPill
-            {
-                AutoSizeAxes = Axes.Both,
-                TextSize = 12,
-                TextPadding = new MarginPadding { Horizontal = 10, Vertical = 4 },
-                Status = SetInfo.Status,
-            });
-        }
-    }
-}

From 74196823348350b2ec5ad1d871ca57fe4cb65e54 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 27 Nov 2021 15:01:48 +0100
Subject: [PATCH 1306/5547] Move icon pill to beatmap card-specific namespace

---
 osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs                | 1 -
 .../Panels => Beatmaps/Drawables/Cards}/IconPill.cs             | 2 +-
 2 files changed, 1 insertion(+), 2 deletions(-)
 rename osu.Game/{Overlays/BeatmapListing/Panels => Beatmaps/Drawables/Cards}/IconPill.cs (96%)

diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
index 76b1166626..37c1bacda4 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
@@ -23,7 +23,6 @@ using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays;
 using osu.Game.Overlays.BeatmapSet;
 using osuTK;
-using osu.Game.Overlays.BeatmapListing.Panels;
 using osu.Game.Resources.Localisation.Web;
 using DownloadButton = osu.Game.Beatmaps.Drawables.Cards.Buttons.DownloadButton;
 
diff --git a/osu.Game/Overlays/BeatmapListing/Panels/IconPill.cs b/osu.Game/Beatmaps/Drawables/Cards/IconPill.cs
similarity index 96%
rename from osu.Game/Overlays/BeatmapListing/Panels/IconPill.cs
rename to osu.Game/Beatmaps/Drawables/Cards/IconPill.cs
index 1cb6c84f13..c55e9c0a28 100644
--- a/osu.Game/Overlays/BeatmapListing/Panels/IconPill.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/IconPill.cs
@@ -8,7 +8,7 @@ using osu.Framework.Graphics.Sprites;
 using osuTK;
 using osuTK.Graphics;
 
-namespace osu.Game.Overlays.BeatmapListing.Panels
+namespace osu.Game.Beatmaps.Drawables.Cards
 {
     public class IconPill : CircularContainer
     {

From 251ab183a08627d3b309e1dab89e4c238674f83d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 27 Nov 2021 15:04:05 +0100
Subject: [PATCH 1307/5547] Move beatmap play button nearer its only remaining
 usage

---
 .../{BeatmapListing/Panels => BeatmapSet/Buttons}/PlayButton.cs | 2 +-
 osu.Game/Overlays/BeatmapSet/Buttons/PreviewButton.cs           | 1 -
 2 files changed, 1 insertion(+), 2 deletions(-)
 rename osu.Game/Overlays/{BeatmapListing/Panels => BeatmapSet/Buttons}/PlayButton.cs (99%)

diff --git a/osu.Game/Overlays/BeatmapListing/Panels/PlayButton.cs b/osu.Game/Overlays/BeatmapSet/Buttons/PlayButton.cs
similarity index 99%
rename from osu.Game/Overlays/BeatmapListing/Panels/PlayButton.cs
rename to osu.Game/Overlays/BeatmapSet/Buttons/PlayButton.cs
index c352fe0223..63b7a0a062 100644
--- a/osu.Game/Overlays/BeatmapListing/Panels/PlayButton.cs
+++ b/osu.Game/Overlays/BeatmapSet/Buttons/PlayButton.cs
@@ -14,7 +14,7 @@ using osu.Game.Online.API.Requests.Responses;
 using osuTK;
 using osuTK.Graphics;
 
-namespace osu.Game.Overlays.BeatmapListing.Panels
+namespace osu.Game.Overlays.BeatmapSet.Buttons
 {
     public class PlayButton : Container
     {
diff --git a/osu.Game/Overlays/BeatmapSet/Buttons/PreviewButton.cs b/osu.Game/Overlays/BeatmapSet/Buttons/PreviewButton.cs
index 6bcdb7bdc5..751299161d 100644
--- a/osu.Game/Overlays/BeatmapSet/Buttons/PreviewButton.cs
+++ b/osu.Game/Overlays/BeatmapSet/Buttons/PreviewButton.cs
@@ -11,7 +11,6 @@ using osu.Game.Audio;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Online.API.Requests.Responses;
-using osu.Game.Overlays.BeatmapListing.Panels;
 using osuTK;
 
 namespace osu.Game.Overlays.BeatmapSet.Buttons

From a043d1e4273804350eace4c6d658c5afe24fe36f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 27 Nov 2021 15:06:57 +0100
Subject: [PATCH 1308/5547] Move old beatmap download button to more general
 namespace

---
 .../Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs        | 1 -
 osu.Game.Tests/Visual/Online/TestSceneDirectDownloadButton.cs  | 2 +-
 .../Drawables}/BeatmapPanelDownloadButton.cs                   | 3 +--
 .../Panels => Beatmaps/Drawables}/DownloadProgressBar.cs       | 3 +--
 osu.Game/Overlays/BeatmapSet/BeatmapSetHeaderContent.cs        | 1 -
 osu.Game/Overlays/BeatmapSet/Buttons/HeaderDownloadButton.cs   | 2 +-
 osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs        | 1 -
 7 files changed, 4 insertions(+), 9 deletions(-)
 rename osu.Game/{Overlays/BeatmapListing/Panels => Beatmaps/Drawables}/BeatmapPanelDownloadButton.cs (98%)
 rename osu.Game/{Overlays/BeatmapListing/Panels => Beatmaps/Drawables}/DownloadProgressBar.cs (97%)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
index 13d98145a1..0b3ecb41cd 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
@@ -17,7 +17,6 @@ using osu.Game.Database;
 using osu.Game.Graphics.Containers;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Rooms;
-using osu.Game.Overlays.BeatmapListing.Panels;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Osu.Mods;
diff --git a/osu.Game.Tests/Visual/Online/TestSceneDirectDownloadButton.cs b/osu.Game.Tests/Visual/Online/TestSceneDirectDownloadButton.cs
index 22a91fa9a3..d1af8dd685 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneDirectDownloadButton.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneDirectDownloadButton.cs
@@ -6,9 +6,9 @@ using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Game.Beatmaps;
+using osu.Game.Beatmaps.Drawables;
 using osu.Game.Online;
 using osu.Game.Online.API.Requests.Responses;
-using osu.Game.Overlays.BeatmapListing.Panels;
 using osu.Game.Tests.Resources;
 using osuTK;
 
diff --git a/osu.Game/Overlays/BeatmapListing/Panels/BeatmapPanelDownloadButton.cs b/osu.Game/Beatmaps/Drawables/BeatmapPanelDownloadButton.cs
similarity index 98%
rename from osu.Game/Overlays/BeatmapListing/Panels/BeatmapPanelDownloadButton.cs
rename to osu.Game/Beatmaps/Drawables/BeatmapPanelDownloadButton.cs
index 0a66c3ccb7..1a47182d22 100644
--- a/osu.Game/Overlays/BeatmapListing/Panels/BeatmapPanelDownloadButton.cs
+++ b/osu.Game/Beatmaps/Drawables/BeatmapPanelDownloadButton.cs
@@ -6,7 +6,6 @@ using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
-using osu.Game.Beatmaps;
 using osu.Game.Configuration;
 using osu.Game.Extensions;
 using osu.Game.Graphics.Containers;
@@ -14,7 +13,7 @@ using osu.Game.Graphics.UserInterface;
 using osu.Game.Online;
 using osu.Game.Online.API.Requests.Responses;
 
-namespace osu.Game.Overlays.BeatmapListing.Panels
+namespace osu.Game.Beatmaps.Drawables
 {
     public class BeatmapPanelDownloadButton : CompositeDrawable
     {
diff --git a/osu.Game/Overlays/BeatmapListing/Panels/DownloadProgressBar.cs b/osu.Game/Beatmaps/Drawables/DownloadProgressBar.cs
similarity index 97%
rename from osu.Game/Overlays/BeatmapListing/Panels/DownloadProgressBar.cs
rename to osu.Game/Beatmaps/Drawables/DownloadProgressBar.cs
index 93eaf775e0..54dcdc55e3 100644
--- a/osu.Game/Overlays/BeatmapListing/Panels/DownloadProgressBar.cs
+++ b/osu.Game/Beatmaps/Drawables/DownloadProgressBar.cs
@@ -5,13 +5,12 @@ using osu.Framework.Allocation;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
-using osu.Game.Beatmaps;
 using osu.Game.Graphics;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Online;
 using osuTK.Graphics;
 
-namespace osu.Game.Overlays.BeatmapListing.Panels
+namespace osu.Game.Beatmaps.Drawables
 {
     public class DownloadProgressBar : CompositeDrawable
     {
diff --git a/osu.Game/Overlays/BeatmapSet/BeatmapSetHeaderContent.cs b/osu.Game/Overlays/BeatmapSet/BeatmapSetHeaderContent.cs
index 547b8a6ec3..b46919ef18 100644
--- a/osu.Game/Overlays/BeatmapSet/BeatmapSetHeaderContent.cs
+++ b/osu.Game/Overlays/BeatmapSet/BeatmapSetHeaderContent.cs
@@ -17,7 +17,6 @@ using osu.Game.Graphics.UserInterface;
 using osu.Game.Online;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests.Responses;
-using osu.Game.Overlays.BeatmapListing.Panels;
 using osu.Game.Overlays.BeatmapSet.Buttons;
 using osuTK;
 
diff --git a/osu.Game/Overlays/BeatmapSet/Buttons/HeaderDownloadButton.cs b/osu.Game/Overlays/BeatmapSet/Buttons/HeaderDownloadButton.cs
index 4eed8f28f2..74417b0ac6 100644
--- a/osu.Game/Overlays/BeatmapSet/Buttons/HeaderDownloadButton.cs
+++ b/osu.Game/Overlays/BeatmapSet/Buttons/HeaderDownloadButton.cs
@@ -9,13 +9,13 @@ using osu.Framework.Graphics.Cursor;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Localisation;
 using osu.Game.Beatmaps;
+using osu.Game.Beatmaps.Drawables;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Online;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests.Responses;
-using osu.Game.Overlays.BeatmapListing.Panels;
 using osu.Game.Resources.Localisation.Web;
 using osuTK;
 using osuTK.Graphics;
diff --git a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
index 8d9ea91b47..58c63010fd 100644
--- a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
+++ b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
@@ -25,7 +25,6 @@ using osu.Game.Graphics.UserInterface;
 using osu.Game.Online;
 using osu.Game.Online.Chat;
 using osu.Game.Online.Rooms;
-using osu.Game.Overlays.BeatmapListing.Panels;
 using osu.Game.Overlays.BeatmapSet;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Mods;

From 05f7ea6b6d27ea5378b10c1e4f0965e162a5ce96 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 27 Nov 2021 15:08:03 +0100
Subject: [PATCH 1309/5547] Remove mentions of "panel" and "direct" from names
 of old download buttons

---
 .../Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs       | 4 ++--
 ...ectDownloadButton.cs => TestSceneBeatmapDownloadButton.cs} | 4 ++--
 ...BeatmapPanelDownloadButton.cs => BeatmapDownloadButton.cs} | 4 ++--
 osu.Game/Overlays/BeatmapSet/BeatmapSetHeaderContent.cs       | 2 +-
 osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs       | 2 +-
 5 files changed, 8 insertions(+), 8 deletions(-)
 rename osu.Game.Tests/Visual/Online/{TestSceneDirectDownloadButton.cs => TestSceneBeatmapDownloadButton.cs} (97%)
 rename osu.Game/Beatmaps/Drawables/{BeatmapPanelDownloadButton.cs => BeatmapDownloadButton.cs} (96%)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
index 0b3ecb41cd..55aa665ff1 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
@@ -235,7 +235,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             assertDownloadButtonVisible(false);
 
             void assertDownloadButtonVisible(bool visible) => AddUntilStep($"download button {(visible ? "shown" : "hidden")}",
-                () => playlist.ChildrenOfType<BeatmapPanelDownloadButton>().Single().Alpha == (visible ? 1 : 0));
+                () => playlist.ChildrenOfType<BeatmapDownloadButton>().Single().Alpha == (visible ? 1 : 0));
         }
 
         [Test]
@@ -249,7 +249,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             createPlaylist(byOnlineId, byChecksum);
 
-            AddAssert("download buttons shown", () => playlist.ChildrenOfType<BeatmapPanelDownloadButton>().All(d => d.IsPresent));
+            AddAssert("download buttons shown", () => playlist.ChildrenOfType<BeatmapDownloadButton>().All(d => d.IsPresent));
         }
 
         [Test]
diff --git a/osu.Game.Tests/Visual/Online/TestSceneDirectDownloadButton.cs b/osu.Game.Tests/Visual/Online/TestSceneBeatmapDownloadButton.cs
similarity index 97%
rename from osu.Game.Tests/Visual/Online/TestSceneDirectDownloadButton.cs
rename to osu.Game.Tests/Visual/Online/TestSceneBeatmapDownloadButton.cs
index d1af8dd685..21bf8d1c5a 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneDirectDownloadButton.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneBeatmapDownloadButton.cs
@@ -14,7 +14,7 @@ using osuTK;
 
 namespace osu.Game.Tests.Visual.Online
 {
-    public class TestSceneDirectDownloadButton : OsuTestScene
+    public class TestSceneBeatmapDownloadButton : OsuTestScene
     {
         private TestDownloadButton downloadButton;
 
@@ -137,7 +137,7 @@ namespace osu.Game.Tests.Visual.Online
             return apiBeatmapSet;
         }
 
-        private class TestDownloadButton : BeatmapPanelDownloadButton
+        private class TestDownloadButton : BeatmapDownloadButton
         {
             public new bool DownloadEnabled => base.DownloadEnabled;
 
diff --git a/osu.Game/Beatmaps/Drawables/BeatmapPanelDownloadButton.cs b/osu.Game/Beatmaps/Drawables/BeatmapDownloadButton.cs
similarity index 96%
rename from osu.Game/Beatmaps/Drawables/BeatmapPanelDownloadButton.cs
rename to osu.Game/Beatmaps/Drawables/BeatmapDownloadButton.cs
index 1a47182d22..e2485e7a77 100644
--- a/osu.Game/Beatmaps/Drawables/BeatmapPanelDownloadButton.cs
+++ b/osu.Game/Beatmaps/Drawables/BeatmapDownloadButton.cs
@@ -15,7 +15,7 @@ using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Beatmaps.Drawables
 {
-    public class BeatmapPanelDownloadButton : CompositeDrawable
+    public class BeatmapDownloadButton : CompositeDrawable
     {
         protected bool DownloadEnabled => button.Enabled.Value;
 
@@ -34,7 +34,7 @@ namespace osu.Game.Beatmaps.Drawables
 
         private readonly IBeatmapSetInfo beatmapSet;
 
-        public BeatmapPanelDownloadButton(IBeatmapSetInfo beatmapSet)
+        public BeatmapDownloadButton(IBeatmapSetInfo beatmapSet)
         {
             this.beatmapSet = beatmapSet;
 
diff --git a/osu.Game/Overlays/BeatmapSet/BeatmapSetHeaderContent.cs b/osu.Game/Overlays/BeatmapSet/BeatmapSetHeaderContent.cs
index b46919ef18..8f4089c707 100644
--- a/osu.Game/Overlays/BeatmapSet/BeatmapSetHeaderContent.cs
+++ b/osu.Game/Overlays/BeatmapSet/BeatmapSetHeaderContent.cs
@@ -285,7 +285,7 @@ namespace osu.Game.Overlays.BeatmapSet
             {
                 case DownloadState.LocallyAvailable:
                     // temporary for UX until new design is implemented.
-                    downloadButtonsContainer.Child = new BeatmapPanelDownloadButton(BeatmapSet.Value)
+                    downloadButtonsContainer.Child = new BeatmapDownloadButton(BeatmapSet.Value)
                     {
                         Width = 50,
                         RelativeSizeAxes = Axes.Y,
diff --git a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
index 58c63010fd..2dbe2df82c 100644
--- a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
+++ b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
@@ -338,7 +338,7 @@ namespace osu.Game.Screens.OnlinePlay
             return true;
         }
 
-        private sealed class PlaylistDownloadButton : BeatmapPanelDownloadButton
+        private sealed class PlaylistDownloadButton : BeatmapDownloadButton
         {
             private readonly PlaylistItem playlistItem;
 

From db49d99cc0e86901357538c515da4a3f58a26361 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 27 Nov 2021 14:39:12 +0100
Subject: [PATCH 1310/5547] Ensure correct disabled ruleset callback scheduling
 in ruleset selector

---
 osu.Game/Overlays/Toolbar/ToolbarRulesetSelector.cs | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Overlays/Toolbar/ToolbarRulesetSelector.cs b/osu.Game/Overlays/Toolbar/ToolbarRulesetSelector.cs
index 9ca105ee7f..6e5fbf6efb 100644
--- a/osu.Game/Overlays/Toolbar/ToolbarRulesetSelector.cs
+++ b/osu.Game/Overlays/Toolbar/ToolbarRulesetSelector.cs
@@ -68,13 +68,19 @@ namespace osu.Game.Overlays.Toolbar
         {
             base.LoadComplete();
 
-            Current.BindDisabledChanged(disabled => this.FadeColour(disabled ? Color4.Gray : Color4.White, 300), true);
-            Current.BindValueChanged(_ => moveLineToCurrent());
+            Current.BindDisabledChanged(_ => Scheduler.AddOnce(currentDisabledChanged));
+            currentDisabledChanged();
 
+            Current.BindValueChanged(_ => moveLineToCurrent());
             // Scheduled to allow the button flow layout to be computed before the line position is updated
             ScheduleAfterChildren(moveLineToCurrent);
         }
 
+        private void currentDisabledChanged()
+        {
+            this.FadeColour(Current.Disabled ? Color4.Gray : Color4.White, 300);
+        }
+
         private bool hasInitialPosition;
 
         private void moveLineToCurrent()

From 1ae41118cd611d4965272a3272035f2c307acc7a Mon Sep 17 00:00:00 2001
From: mk-56 <darioheadleysilva@gmail.com>
Date: Sat, 27 Nov 2021 22:59:09 +0100
Subject: [PATCH 1311/5547] Added gravity as a default.

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

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModApproachDifferent.cs b/osu.Game.Rulesets.Osu/Mods/OsuModApproachDifferent.cs
index 6aeb378c69..db74790221 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModApproachDifferent.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModApproachDifferent.cs
@@ -31,7 +31,7 @@ namespace osu.Game.Rulesets.Osu.Mods
         };
 
         [SettingSource("Style", "Change the animation style of the approach circles.", 1)]
-        public Bindable<AnimationStyle> Style { get; } = new Bindable<AnimationStyle>();
+        public Bindable<AnimationStyle> Style { get; } = new Bindable<AnimationStyle>(AnimationStyle.Gravity);
 
         public void ApplyToDrawableHitObject(DrawableHitObject drawable)
         {
@@ -89,8 +89,8 @@ namespace osu.Game.Rulesets.Osu.Mods
 
         public enum AnimationStyle
         {
-            Gravity,
             Linear,
+            Gravity,           
             InOut1,
             InOut2,
             Accelerate1,

From eaa464e548582da39515ded5d9421146eabdcfc6 Mon Sep 17 00:00:00 2001
From: mk-56 <darioheadleysilva@gmail.com>
Date: Sun, 28 Nov 2021 02:58:08 +0100
Subject: [PATCH 1312/5547] Initial implementation of adjustable positional
 hitobject audio strength

---
 osu.Game/Configuration/OsuConfigManager.cs    |  2 ++
 osu.Game/Localisation/AudioSettingsStrings.cs |  5 ++++
 .../Sections/Gameplay/AudioSettings.cs        | 28 ++++++++++++++++++-
 .../Objects/Drawables/DrawableHitObject.cs    |  4 ++-
 4 files changed, 37 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Configuration/OsuConfigManager.cs b/osu.Game/Configuration/OsuConfigManager.cs
index 84da3f666d..a124c1c5ae 100644
--- a/osu.Game/Configuration/OsuConfigManager.cs
+++ b/osu.Game/Configuration/OsuConfigManager.cs
@@ -97,6 +97,7 @@ namespace osu.Game.Configuration
             SetDefault(OsuSetting.MenuParallax, true);
 
             // Gameplay
+            SetDefault(OsuSetting.PositionalHitsoundsLevel, 0.8f, 0.1f, 1f);
             SetDefault(OsuSetting.DimLevel, 0.8, 0, 1, 0.01);
             SetDefault(OsuSetting.BlurLevel, 0, 0, 1, 0.01);
             SetDefault(OsuSetting.LightenDuringBreaks, true);
@@ -251,6 +252,7 @@ namespace osu.Game.Configuration
         BlurLevel,
         LightenDuringBreaks,
         ShowStoryboard,
+        PositionalHitsoundsLevel,
         KeyOverlay,
         PositionalHitSounds,
         AlwaysPlayFirstComboBreak,
diff --git a/osu.Game/Localisation/AudioSettingsStrings.cs b/osu.Game/Localisation/AudioSettingsStrings.cs
index 008781c2e5..a55816b401 100644
--- a/osu.Game/Localisation/AudioSettingsStrings.cs
+++ b/osu.Game/Localisation/AudioSettingsStrings.cs
@@ -32,6 +32,11 @@ namespace osu.Game.Localisation
         /// <summary>
         /// "Master"
         /// </summary>
+        public static LocalisableString PositionalLevel => new TranslatableString(getKey(@"positional_hitsound_audio_level"), @"Positional hitsound audio level.");
+
+        /// <summary>
+        /// "Level"
+        /// </summary>
         public static LocalisableString MasterVolume => new TranslatableString(getKey(@"master_volume"), @"Master");
 
         /// <summary>
diff --git a/osu.Game/Overlays/Settings/Sections/Gameplay/AudioSettings.cs b/osu.Game/Overlays/Settings/Sections/Gameplay/AudioSettings.cs
index dba64d695a..c239fd282a 100644
--- a/osu.Game/Overlays/Settings/Sections/Gameplay/AudioSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Gameplay/AudioSettings.cs
@@ -2,10 +2,13 @@
 // 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.Localisation;
 using osu.Game.Configuration;
 using osu.Game.Localisation;
+using osu.Framework.Graphics.Containers;
+
 
 namespace osu.Game.Overlays.Settings.Sections.Gameplay
 {
@@ -13,9 +16,15 @@ namespace osu.Game.Overlays.Settings.Sections.Gameplay
     {
         protected override LocalisableString Header => GameplaySettingsStrings.AudioHeader;
 
+        private Bindable<float> positionalHitsoundsLevel;
+
+        private FillFlowContainer<SettingsSlider<float>> positionalHitsoundsSettings;
+
+
         [BackgroundDependencyLoader]
-        private void load(OsuConfigManager config)
+        private void load(OsuConfigManager config,OsuConfigManager osuConfig)
         {
+            positionalHitsoundsLevel = osuConfig.GetBindable<float>(OsuSetting.PositionalHitsoundsLevel);
             Children = new Drawable[]
             {
                 new SettingsCheckbox
@@ -23,6 +32,23 @@ namespace osu.Game.Overlays.Settings.Sections.Gameplay
                     LabelText = GameplaySettingsStrings.PositionalHitsounds,
                     Current = config.GetBindable<bool>(OsuSetting.PositionalHitSounds)
                 },
+                positionalHitsoundsSettings = new FillFlowContainer<SettingsSlider<float>>
+                {
+                    Direction = FillDirection.Vertical,
+                    RelativeSizeAxes = Axes.X,
+                    AutoSizeAxes = Axes.Y,
+                    Masking = true,
+                    Children = new[]
+                    {
+                        new SettingsSlider<float>
+                        {
+                            LabelText = AudioSettingsStrings.PositionalLevel,
+                            Current = positionalHitsoundsLevel,
+                            KeyboardStep = 0.01f,
+                            DisplayAsPercentage = true,
+                        },
+                    }
+                },
                 new SettingsCheckbox
                 {
                     LabelText = GameplaySettingsStrings.AlwaysPlayFirstComboBreak,
diff --git a/osu.Game/Rulesets/Objects/Drawables/DrawableHitObject.cs b/osu.Game/Rulesets/Objects/Drawables/DrawableHitObject.cs
index 01817147ae..1a0fe8d004 100644
--- a/osu.Game/Rulesets/Objects/Drawables/DrawableHitObject.cs
+++ b/osu.Game/Rulesets/Objects/Drawables/DrawableHitObject.cs
@@ -22,6 +22,7 @@ using osu.Game.Rulesets.Scoring;
 using osu.Game.Rulesets.UI;
 using osu.Game.Skinning;
 using osuTK.Graphics;
+using osu.Game.Overlays.Settings.Sections.Gameplay;
 
 namespace osu.Game.Rulesets.Objects.Drawables
 {
@@ -124,6 +125,7 @@ namespace osu.Game.Rulesets.Objects.Drawables
         public readonly Bindable<double> StartTimeBindable = new Bindable<double>();
         private readonly BindableList<HitSampleInfo> samplesBindable = new BindableList<HitSampleInfo>();
         private readonly Bindable<bool> userPositionalHitSounds = new Bindable<bool>();
+        private readonly Bindable<float> positionalHitsoundsLevel = new Bindable<float>();
 
         private readonly Bindable<int> comboIndexBindable = new Bindable<int>();
         private readonly Bindable<int> comboIndexWithOffsetsBindable = new Bindable<int>();
@@ -532,7 +534,7 @@ namespace osu.Game.Rulesets.Objects.Drawables
         /// <param name="position">The lookup X position. Generally should be <see cref="SamplePlaybackPosition"/>.</param>
         protected double CalculateSamplePlaybackBalance(double position)
         {
-            const float balance_adjust_amount = 0.4f;
+            float balance_adjust_amount = positionalHitsoundsLevel.Value;
 
             return balance_adjust_amount * (userPositionalHitSounds.Value ? position - 0.5f : 0);
         }

From e83115ad5e617843937eb751a74bc60538fa0796 Mon Sep 17 00:00:00 2001
From: mk-56 <darioheadleysilva@gmail.com>
Date: Sun, 28 Nov 2021 03:25:11 +0100
Subject: [PATCH 1313/5547] Binding logic fix, nullification of unnecessary
 path

---
 osu.Game/Configuration/OsuConfigManager.cs               | 2 +-
 osu.Game/Rulesets/Objects/Drawables/DrawableHitObject.cs | 5 +++--
 2 files changed, 4 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Configuration/OsuConfigManager.cs b/osu.Game/Configuration/OsuConfigManager.cs
index a124c1c5ae..ed0fe17e27 100644
--- a/osu.Game/Configuration/OsuConfigManager.cs
+++ b/osu.Game/Configuration/OsuConfigManager.cs
@@ -97,7 +97,7 @@ namespace osu.Game.Configuration
             SetDefault(OsuSetting.MenuParallax, true);
 
             // Gameplay
-            SetDefault(OsuSetting.PositionalHitsoundsLevel, 0.8f, 0.1f, 1f);
+            SetDefault(OsuSetting.PositionalHitsoundsLevel, 0.8f, 0, 1);
             SetDefault(OsuSetting.DimLevel, 0.8, 0, 1, 0.01);
             SetDefault(OsuSetting.BlurLevel, 0, 0, 1, 0.01);
             SetDefault(OsuSetting.LightenDuringBreaks, true);
diff --git a/osu.Game/Rulesets/Objects/Drawables/DrawableHitObject.cs b/osu.Game/Rulesets/Objects/Drawables/DrawableHitObject.cs
index 1a0fe8d004..601756485b 100644
--- a/osu.Game/Rulesets/Objects/Drawables/DrawableHitObject.cs
+++ b/osu.Game/Rulesets/Objects/Drawables/DrawableHitObject.cs
@@ -171,6 +171,7 @@ namespace osu.Game.Rulesets.Objects.Drawables
         private void load(OsuConfigManager config, ISkinSource skinSource)
         {
             config.BindWith(OsuSetting.PositionalHitSounds, userPositionalHitSounds);
+            config.BindWith(OsuSetting.PositionalHitsoundsLevel, positionalHitsoundsLevel);
 
             // Explicit non-virtual function call.
             base.AddInternal(Samples = new PausableSkinnableSound());
@@ -534,9 +535,9 @@ namespace osu.Game.Rulesets.Objects.Drawables
         /// <param name="position">The lookup X position. Generally should be <see cref="SamplePlaybackPosition"/>.</param>
         protected double CalculateSamplePlaybackBalance(double position)
         {
-            float balance_adjust_amount = positionalHitsoundsLevel.Value;
+            float balance_adjust_amount = positionalHitsoundsLevel.Value*2;
 
-            return balance_adjust_amount * (userPositionalHitSounds.Value ? position - 0.5f : 0);
+            return balance_adjust_amount * (true ? position - 0.5f : 0);
         }
 
         /// <summary>

From ff9c68dd6aafcb0103e33f8f735674a6b1cb2b11 Mon Sep 17 00:00:00 2001
From: mk-56 <darioheadleysilva@gmail.com>
Date: Sun, 28 Nov 2021 03:28:35 +0100
Subject: [PATCH 1314/5547] cleanup

---
 osu.Game/Overlays/Settings/Sections/Gameplay/AudioSettings.cs | 2 --
 1 file changed, 2 deletions(-)

diff --git a/osu.Game/Overlays/Settings/Sections/Gameplay/AudioSettings.cs b/osu.Game/Overlays/Settings/Sections/Gameplay/AudioSettings.cs
index c239fd282a..9e677943c2 100644
--- a/osu.Game/Overlays/Settings/Sections/Gameplay/AudioSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Gameplay/AudioSettings.cs
@@ -9,7 +9,6 @@ using osu.Game.Configuration;
 using osu.Game.Localisation;
 using osu.Framework.Graphics.Containers;
 
-
 namespace osu.Game.Overlays.Settings.Sections.Gameplay
 {
     public class AudioSettings : SettingsSubsection
@@ -20,7 +19,6 @@ namespace osu.Game.Overlays.Settings.Sections.Gameplay
 
         private FillFlowContainer<SettingsSlider<float>> positionalHitsoundsSettings;
 
-
         [BackgroundDependencyLoader]
         private void load(OsuConfigManager config,OsuConfigManager osuConfig)
         {

From e5dcfc311390a22b0b1fd6ad880980e90bc292ca Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Sun, 28 Nov 2021 14:03:21 +0900
Subject: [PATCH 1315/5547] Use console IPC

---
 osu.Desktop/Program.cs                      | 53 +++++++++++++++++++--
 osu.Game/Beatmaps/FlatFileWorkingBeatmap.cs | 52 ++++++++++++++++++++
 2 files changed, 100 insertions(+), 5 deletions(-)
 create mode 100644 osu.Game/Beatmaps/FlatFileWorkingBeatmap.cs

diff --git a/osu.Desktop/Program.cs b/osu.Desktop/Program.cs
index 898f7d5105..6dd6849d78 100644
--- a/osu.Desktop/Program.cs
+++ b/osu.Desktop/Program.cs
@@ -3,13 +3,22 @@
 
 using System;
 using System.IO;
+using System.Linq;
 using System.Threading;
 using System.Threading.Tasks;
 using osu.Framework;
 using osu.Framework.Development;
 using osu.Framework.Logging;
 using osu.Framework.Platform;
+using osu.Game.Beatmaps;
+using osu.Game.Beatmaps.Legacy;
 using osu.Game.IPC;
+using osu.Game.Rulesets;
+using osu.Game.Rulesets.Catch;
+using osu.Game.Rulesets.Mania;
+using osu.Game.Rulesets.Mods;
+using osu.Game.Rulesets.Osu;
+using osu.Game.Rulesets.Taiko;
 using osu.Game.Tournament;
 
 namespace osu.Desktop
@@ -19,7 +28,7 @@ namespace osu.Desktop
         private const string base_game_name = @"osu";
 
         [STAThread]
-        public static int Main(string[] args)
+        public static void Main(string[] args)
         {
             // Back up the cwd before DesktopGameHost changes it
             string cwd = Environment.CurrentDirectory;
@@ -49,6 +58,34 @@ namespace osu.Desktop
 
                         gameName = $"{base_game_name}-{clientID}";
                         break;
+
+                    case "--osu-stable-difficulty-stream":
+                        while (true)
+                        {
+                            try
+                            {
+                                string beatmapFile = Console.ReadLine() ?? string.Empty;
+                                int rulesetId = int.Parse(Console.ReadLine() ?? string.Empty);
+                                LegacyMods legacyMods = (LegacyMods)int.Parse(Console.ReadLine() ?? string.Empty);
+
+                                Ruleset ruleset = rulesetId switch
+                                {
+                                    0 => new OsuRuleset(),
+                                    1 => new TaikoRuleset(),
+                                    2 => new CatchRuleset(),
+                                    3 => new ManiaRuleset(),
+                                    _ => throw new ArgumentException("Invalid ruleset id")
+                                };
+
+                                Mod[] mods = ruleset.ConvertFromLegacyMods(legacyMods).ToArray();
+                                WorkingBeatmap beatmap = new FlatFileWorkingBeatmap(beatmapFile, _ => ruleset);
+                                Console.WriteLine(ruleset.CreateDifficultyCalculator(beatmap).Calculate(mods).StarRating);
+                            }
+                            catch
+                            {
+                                Console.WriteLine(0);
+                            }
+                        }
                 }
             }
 
@@ -69,14 +106,14 @@ namespace osu.Desktop
                                 throw new TimeoutException(@"IPC took too long to send");
                         }
 
-                        return 0;
+                        return;
                     }
 
                     // we want to allow multiple instances to be started when in debug.
                     if (!DebugUtils.IsDebugBuild)
                     {
                         Logger.Log(@"osu! does not support multiple running instances.", LoggingTarget.Runtime, LogLevel.Error);
-                        return 0;
+                        return;
                     }
                 }
 
@@ -84,8 +121,6 @@ namespace osu.Desktop
                     host.Run(new TournamentGame());
                 else
                     host.Run(new OsuGameDesktop(args));
-
-                return 0;
             }
         }
 
@@ -107,4 +142,12 @@ namespace osu.Desktop
             return continueExecution;
         }
     }
+
+    // Note: Keep in osu.Desktop namespace, or update osu!stable also.
+    public class DifficultyCalculationMessage
+    {
+        public string BeatmapFile { get; set; }
+        public int RulesetId { get; set; }
+        public int Mods { get; set; }
+    }
 }
diff --git a/osu.Game/Beatmaps/FlatFileWorkingBeatmap.cs b/osu.Game/Beatmaps/FlatFileWorkingBeatmap.cs
new file mode 100644
index 0000000000..8c915e2872
--- /dev/null
+++ b/osu.Game/Beatmaps/FlatFileWorkingBeatmap.cs
@@ -0,0 +1,52 @@
+// 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 osu.Framework.Audio.Track;
+using osu.Framework.Graphics.Textures;
+using osu.Game.Beatmaps.Formats;
+using osu.Game.IO;
+using osu.Game.Rulesets;
+using osu.Game.Skinning;
+
+namespace osu.Game.Beatmaps
+{
+    /// <summary>
+    /// A <see cref="WorkingBeatmap"/> which can be constructed directly from a .osu file, providing an implementation for
+    /// <see cref="WorkingBeatmap.GetPlayableBeatmap(osu.Game.Rulesets.IRulesetInfo,System.Collections.Generic.IReadOnlyList{osu.Game.Rulesets.Mods.Mod})"/>.
+    /// </summary>
+    public class FlatFileWorkingBeatmap : WorkingBeatmap
+    {
+        private readonly Beatmap beatmap;
+
+        public FlatFileWorkingBeatmap(string file, Func<int, Ruleset> rulesetProvider, int? beatmapId = null)
+            : this(readFromFile(file), rulesetProvider, beatmapId)
+        {
+        }
+
+        private FlatFileWorkingBeatmap(Beatmap beatmap, Func<int, Ruleset> rulesetProvider, int? beatmapId = null)
+            : base(beatmap.BeatmapInfo, null)
+        {
+            this.beatmap = beatmap;
+
+            beatmap.BeatmapInfo.Ruleset = rulesetProvider(beatmap.BeatmapInfo.RulesetID).RulesetInfo;
+
+            if (beatmapId.HasValue)
+                beatmap.BeatmapInfo.OnlineID = beatmapId;
+        }
+
+        private static Beatmap readFromFile(string filename)
+        {
+            using (var stream = File.OpenRead(filename))
+            using (var reader = new LineBufferedReader(stream))
+                return Decoder.GetDecoder<Beatmap>(reader).Decode(reader);
+        }
+
+        protected override IBeatmap GetBeatmap() => beatmap;
+        protected override Texture GetBackground() => throw new NotImplementedException();
+        protected override Track GetBeatmapTrack() => throw new NotImplementedException();
+        protected internal override ISkin GetSkin() => throw new NotImplementedException();
+        public override Stream GetStream(string storagePath) => throw new NotImplementedException();
+    }
+}

From ef247806429270a6e69fb0a25bcb8d81ae124ba7 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Sun, 28 Nov 2021 18:00:06 +0900
Subject: [PATCH 1316/5547] Use IPC via TCP

---
 .../LegacyIpcDifficultyCalculationRequest.cs  | 18 ++++
 .../LegacyIpcDifficultyCalculationResponse.cs | 16 ++++
 osu.Desktop/LegacyIpc/LegacyIpcMessage.cs     | 40 +++++++++
 osu.Desktop/LegacyIpc/LegacyTcpIpcProvider.cs | 65 ++++++++++++++
 osu.Desktop/Program.cs                        | 86 ++++++++++++-------
 5 files changed, 193 insertions(+), 32 deletions(-)
 create mode 100644 osu.Desktop/LegacyIpc/LegacyIpcDifficultyCalculationRequest.cs
 create mode 100644 osu.Desktop/LegacyIpc/LegacyIpcDifficultyCalculationResponse.cs
 create mode 100644 osu.Desktop/LegacyIpc/LegacyIpcMessage.cs
 create mode 100644 osu.Desktop/LegacyIpc/LegacyTcpIpcProvider.cs

diff --git a/osu.Desktop/LegacyIpc/LegacyIpcDifficultyCalculationRequest.cs b/osu.Desktop/LegacyIpc/LegacyIpcDifficultyCalculationRequest.cs
new file mode 100644
index 0000000000..d6ef390a8f
--- /dev/null
+++ b/osu.Desktop/LegacyIpc/LegacyIpcDifficultyCalculationRequest.cs
@@ -0,0 +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.
+
+namespace osu.Desktop.LegacyIpc
+{
+    /// <summary>
+    /// A difficulty calculation request from the legacy client.
+    /// </summary>
+    /// <remarks>
+    /// Synchronise any changes with osu!stable.
+    /// </remarks>
+    public class LegacyIpcDifficultyCalculationRequest
+    {
+        public string BeatmapFile { get; set; }
+        public int RulesetId { get; set; }
+        public int Mods { get; set; }
+    }
+}
diff --git a/osu.Desktop/LegacyIpc/LegacyIpcDifficultyCalculationResponse.cs b/osu.Desktop/LegacyIpc/LegacyIpcDifficultyCalculationResponse.cs
new file mode 100644
index 0000000000..7b9fae5797
--- /dev/null
+++ b/osu.Desktop/LegacyIpc/LegacyIpcDifficultyCalculationResponse.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.LegacyIpc
+{
+    /// <summary>
+    /// A difficulty calculation response returned to the legacy client.
+    /// </summary>
+    /// <remarks>
+    /// Synchronise any changes with osu!stable.
+    /// </remarks>
+    public class LegacyIpcDifficultyCalculationResponse
+    {
+        public double StarRating { get; set; }
+    }
+}
diff --git a/osu.Desktop/LegacyIpc/LegacyIpcMessage.cs b/osu.Desktop/LegacyIpc/LegacyIpcMessage.cs
new file mode 100644
index 0000000000..6fefae4509
--- /dev/null
+++ b/osu.Desktop/LegacyIpc/LegacyIpcMessage.cs
@@ -0,0 +1,40 @@
+// 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.Platform;
+
+namespace osu.Desktop.LegacyIpc
+{
+    /// <summary>
+    /// An <see cref="IpcMessage"/> that can be used to communicate to and from legacy clients.
+    /// </summary>
+    /// <remarks>
+    /// Synchronise any changes with osu-stable.
+    /// </remarks>
+    public class LegacyIpcMessage : IpcMessage
+    {
+        public LegacyIpcMessage()
+        {
+            // Types/assemblies are not inter-compatible, so always serialise/deserialise into objects.
+            base.Type = typeof(object).FullName;
+        }
+
+        public new string Type => base.Type; // Hide setter.
+
+        public new object Value
+        {
+            get => base.Value;
+            set => base.Value = new Data
+            {
+                MessageType = value.GetType().Name,
+                MessageData = value
+            };
+        }
+
+        public class Data
+        {
+            public string MessageType { get; set; }
+            public object MessageData { get; set; }
+        }
+    }
+}
diff --git a/osu.Desktop/LegacyIpc/LegacyTcpIpcProvider.cs b/osu.Desktop/LegacyIpc/LegacyTcpIpcProvider.cs
new file mode 100644
index 0000000000..4fca40f22f
--- /dev/null
+++ b/osu.Desktop/LegacyIpc/LegacyTcpIpcProvider.cs
@@ -0,0 +1,65 @@
+// 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.Threading.Tasks;
+using Newtonsoft.Json.Linq;
+using osu.Framework.Platform;
+
+namespace osu.Desktop.LegacyIpc
+{
+    public class LegacyTcpIpcProvider : TcpIpcProvider
+    {
+        public new Func<object, object> MessageReceived;
+
+        public LegacyTcpIpcProvider()
+        {
+            base.MessageReceived += msg =>
+            {
+                try
+                {
+                    var legacyData = ((JObject)msg.Value).ToObject<LegacyIpcMessage.Data>();
+                    object value = parseObject((JObject)legacyData.MessageData, legacyData.MessageType);
+
+                    object result = MessageReceived?.Invoke(value);
+                    return result != null ? new LegacyIpcMessage { Value = result } : null;
+                }
+                catch (Exception ex)
+                {
+                    Console.WriteLine(ex);
+                }
+
+                return null;
+            };
+        }
+
+        public Task SendMessageAsync(object message) => base.SendMessageAsync(new LegacyIpcMessage { Value = message });
+
+        public async Task<T> SendMessageWithResponseAsync<T>(object message)
+        {
+            var result = await base.SendMessageWithResponseAsync(new LegacyIpcMessage { Value = message }).ConfigureAwait(false);
+
+            var legacyData = ((JObject)result.Value).ToObject<LegacyIpcMessage.Data>();
+            return (T)parseObject((JObject)legacyData.MessageData, legacyData.MessageType);
+        }
+
+        public new Task SendMessageAsync(IpcMessage message) => throw new InvalidOperationException("Use typed overloads.");
+
+        public new Task<IpcMessage> SendMessageWithResponseAsync(IpcMessage message) => throw new InvalidOperationException("Use typed overloads.");
+
+        private object parseObject(JObject value, string type)
+        {
+            switch (type)
+            {
+                case nameof(LegacyIpcDifficultyCalculationRequest):
+                    return value.ToObject<LegacyIpcDifficultyCalculationRequest>();
+
+                case nameof(LegacyIpcDifficultyCalculationResponse):
+                    return value.ToObject<LegacyIpcDifficultyCalculationResponse>();
+
+                default:
+                    throw new ArgumentException($"Unknown type: {type}");
+            }
+        }
+    }
+}
diff --git a/osu.Desktop/Program.cs b/osu.Desktop/Program.cs
index 6dd6849d78..cb9204f518 100644
--- a/osu.Desktop/Program.cs
+++ b/osu.Desktop/Program.cs
@@ -6,6 +6,7 @@ using System.IO;
 using System.Linq;
 using System.Threading;
 using System.Threading.Tasks;
+using osu.Desktop.LegacyIpc;
 using osu.Framework;
 using osu.Framework.Development;
 using osu.Framework.Logging;
@@ -27,6 +28,8 @@ namespace osu.Desktop
     {
         private const string base_game_name = @"osu";
 
+        private static LegacyTcpIpcProvider legacyIpcProvider;
+
         [STAThread]
         public static void Main(string[] args)
         {
@@ -59,33 +62,26 @@ namespace osu.Desktop
                         gameName = $"{base_game_name}-{clientID}";
                         break;
 
-                    case "--osu-stable-difficulty-stream":
-                        while (true)
+                    case "--legacy-ipc-server":
+                        using (legacyIpcProvider = new LegacyTcpIpcProvider())
                         {
-                            try
-                            {
-                                string beatmapFile = Console.ReadLine() ?? string.Empty;
-                                int rulesetId = int.Parse(Console.ReadLine() ?? string.Empty);
-                                LegacyMods legacyMods = (LegacyMods)int.Parse(Console.ReadLine() ?? string.Empty);
-
-                                Ruleset ruleset = rulesetId switch
-                                {
-                                    0 => new OsuRuleset(),
-                                    1 => new TaikoRuleset(),
-                                    2 => new CatchRuleset(),
-                                    3 => new ManiaRuleset(),
-                                    _ => throw new ArgumentException("Invalid ruleset id")
-                                };
-
-                                Mod[] mods = ruleset.ConvertFromLegacyMods(legacyMods).ToArray();
-                                WorkingBeatmap beatmap = new FlatFileWorkingBeatmap(beatmapFile, _ => ruleset);
-                                Console.WriteLine(ruleset.CreateDifficultyCalculator(beatmap).Calculate(mods).StarRating);
-                            }
-                            catch
-                            {
-                                Console.WriteLine(0);
-                            }
+                            legacyIpcProvider.MessageReceived += onLegacyIpcMessageReceived;
+                            legacyIpcProvider.Bind();
+                            legacyIpcProvider.StartAsync().Wait();
                         }
+
+                        return;
+
+                    case "--legacy-ipc-client":
+                        using (legacyIpcProvider = new LegacyTcpIpcProvider())
+                        {
+                            Console.WriteLine(legacyIpcProvider.SendMessageWithResponseAsync<LegacyIpcDifficultyCalculationResponse>(new LegacyIpcDifficultyCalculationRequest
+                            {
+                                BeatmapFile = "/home/smgi/Downloads/osu_files/129891.osu",
+                            }).Result.StarRating);
+                        }
+
+                        return;
                 }
             }
 
@@ -141,13 +137,39 @@ namespace osu.Desktop
 
             return continueExecution;
         }
-    }
 
-    // Note: Keep in osu.Desktop namespace, or update osu!stable also.
-    public class DifficultyCalculationMessage
-    {
-        public string BeatmapFile { get; set; }
-        public int RulesetId { get; set; }
-        public int Mods { get; set; }
+        private static object onLegacyIpcMessageReceived(object message)
+        {
+            switch (message)
+            {
+                case LegacyIpcDifficultyCalculationRequest req:
+                    try
+                    {
+                        Ruleset ruleset = req.RulesetId switch
+                        {
+                            0 => new OsuRuleset(),
+                            1 => new TaikoRuleset(),
+                            2 => new CatchRuleset(),
+                            3 => new ManiaRuleset(),
+                            _ => throw new ArgumentException("Invalid ruleset id")
+                        };
+
+                        Mod[] mods = ruleset.ConvertFromLegacyMods((LegacyMods)req.Mods).ToArray();
+                        WorkingBeatmap beatmap = new FlatFileWorkingBeatmap(req.BeatmapFile, _ => ruleset);
+
+                        return new LegacyIpcDifficultyCalculationResponse
+                        {
+                            StarRating = ruleset.CreateDifficultyCalculator(beatmap).Calculate(mods).StarRating
+                        };
+                    }
+                    catch
+                    {
+                        return new LegacyIpcDifficultyCalculationResponse();
+                    }
+            }
+
+            Console.WriteLine("Type not matched.");
+            return null;
+        }
     }
 }

From 5711c428caa9af871aa2e8e2509f16896470eabb Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Sun, 28 Nov 2021 21:15:21 +0900
Subject: [PATCH 1317/5547] Increment IPC port

---
 osu.Desktop/LegacyIpc/LegacyTcpIpcProvider.cs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Desktop/LegacyIpc/LegacyTcpIpcProvider.cs b/osu.Desktop/LegacyIpc/LegacyTcpIpcProvider.cs
index 4fca40f22f..5d5a34e850 100644
--- a/osu.Desktop/LegacyIpc/LegacyTcpIpcProvider.cs
+++ b/osu.Desktop/LegacyIpc/LegacyTcpIpcProvider.cs
@@ -13,6 +13,7 @@ namespace osu.Desktop.LegacyIpc
         public new Func<object, object> MessageReceived;
 
         public LegacyTcpIpcProvider()
+            : base(45357)
         {
             base.MessageReceived += msg =>
             {

From f506cb35bc4781b404b0f039f5978a11514d80f8 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Sun, 28 Nov 2021 21:15:29 +0900
Subject: [PATCH 1318/5547] Bind legacy IPC on startup

---
 osu.Desktop/Program.cs | 29 ++++++++---------------------
 1 file changed, 8 insertions(+), 21 deletions(-)

diff --git a/osu.Desktop/Program.cs b/osu.Desktop/Program.cs
index cb9204f518..7762aa9010 100644
--- a/osu.Desktop/Program.cs
+++ b/osu.Desktop/Program.cs
@@ -61,27 +61,6 @@ namespace osu.Desktop
 
                         gameName = $"{base_game_name}-{clientID}";
                         break;
-
-                    case "--legacy-ipc-server":
-                        using (legacyIpcProvider = new LegacyTcpIpcProvider())
-                        {
-                            legacyIpcProvider.MessageReceived += onLegacyIpcMessageReceived;
-                            legacyIpcProvider.Bind();
-                            legacyIpcProvider.StartAsync().Wait();
-                        }
-
-                        return;
-
-                    case "--legacy-ipc-client":
-                        using (legacyIpcProvider = new LegacyTcpIpcProvider())
-                        {
-                            Console.WriteLine(legacyIpcProvider.SendMessageWithResponseAsync<LegacyIpcDifficultyCalculationResponse>(new LegacyIpcDifficultyCalculationRequest
-                            {
-                                BeatmapFile = "/home/smgi/Downloads/osu_files/129891.osu",
-                            }).Result.StarRating);
-                        }
-
-                        return;
                 }
             }
 
@@ -113,6 +92,14 @@ namespace osu.Desktop
                     }
                 }
 
+                if (host.IsPrimaryInstance)
+                {
+                    var legacyIpc = new LegacyTcpIpcProvider();
+                    legacyIpc.MessageReceived += onLegacyIpcMessageReceived;
+                    legacyIpc.Bind();
+                    legacyIpc.StartAsync();
+                }
+
                 if (tournamentClient)
                     host.Run(new TournamentGame());
                 else

From 36fffbd9178585aa3c497918a220f9df767c75b6 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Sun, 28 Nov 2021 21:31:22 +0900
Subject: [PATCH 1319/5547] Refactoring

---
 osu.Desktop/LegacyIpc/LegacyIpcMessage.cs     |  1 -
 osu.Desktop/LegacyIpc/LegacyTcpIpcProvider.cs | 33 ++++++++-----------
 osu.Desktop/Program.cs                        |  2 --
 3 files changed, 14 insertions(+), 22 deletions(-)

diff --git a/osu.Desktop/LegacyIpc/LegacyIpcMessage.cs b/osu.Desktop/LegacyIpc/LegacyIpcMessage.cs
index 6fefae4509..2e421068dc 100644
--- a/osu.Desktop/LegacyIpc/LegacyIpcMessage.cs
+++ b/osu.Desktop/LegacyIpc/LegacyIpcMessage.cs
@@ -23,7 +23,6 @@ namespace osu.Desktop.LegacyIpc
 
         public new object Value
         {
-            get => base.Value;
             set => base.Value = new Data
             {
                 MessageType = value.GetType().Name,
diff --git a/osu.Desktop/LegacyIpc/LegacyTcpIpcProvider.cs b/osu.Desktop/LegacyIpc/LegacyTcpIpcProvider.cs
index 5d5a34e850..43d9dd741c 100644
--- a/osu.Desktop/LegacyIpc/LegacyTcpIpcProvider.cs
+++ b/osu.Desktop/LegacyIpc/LegacyTcpIpcProvider.cs
@@ -2,14 +2,22 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
-using System.Threading.Tasks;
 using Newtonsoft.Json.Linq;
+using osu.Framework.Logging;
 using osu.Framework.Platform;
 
 namespace osu.Desktop.LegacyIpc
 {
+    /// <summary>
+    /// Provides IPC to legacy osu! clients.
+    /// </summary>
     public class LegacyTcpIpcProvider : TcpIpcProvider
     {
+        private static readonly Logger logger = Logger.GetLogger("ipc");
+
+        /// <summary>
+        /// Invoked when a message is received from a legacy client.
+        /// </summary>
         public new Func<object, object> MessageReceived;
 
         public LegacyTcpIpcProvider()
@@ -19,35 +27,22 @@ namespace osu.Desktop.LegacyIpc
             {
                 try
                 {
+                    logger.Add($"Processing incoming IPC message: {msg.Value}");
+
                     var legacyData = ((JObject)msg.Value).ToObject<LegacyIpcMessage.Data>();
-                    object value = parseObject((JObject)legacyData.MessageData, legacyData.MessageType);
+                    object value = parseObject((JObject)legacyData!.MessageData, legacyData.MessageType);
 
                     object result = MessageReceived?.Invoke(value);
                     return result != null ? new LegacyIpcMessage { Value = result } : null;
                 }
                 catch (Exception ex)
                 {
-                    Console.WriteLine(ex);
+                    logger.Add("Processing IPC message failed!", exception: ex);
+                    return null;
                 }
-
-                return null;
             };
         }
 
-        public Task SendMessageAsync(object message) => base.SendMessageAsync(new LegacyIpcMessage { Value = message });
-
-        public async Task<T> SendMessageWithResponseAsync<T>(object message)
-        {
-            var result = await base.SendMessageWithResponseAsync(new LegacyIpcMessage { Value = message }).ConfigureAwait(false);
-
-            var legacyData = ((JObject)result.Value).ToObject<LegacyIpcMessage.Data>();
-            return (T)parseObject((JObject)legacyData.MessageData, legacyData.MessageType);
-        }
-
-        public new Task SendMessageAsync(IpcMessage message) => throw new InvalidOperationException("Use typed overloads.");
-
-        public new Task<IpcMessage> SendMessageWithResponseAsync(IpcMessage message) => throw new InvalidOperationException("Use typed overloads.");
-
         private object parseObject(JObject value, string type)
         {
             switch (type)
diff --git a/osu.Desktop/Program.cs b/osu.Desktop/Program.cs
index 7762aa9010..c41a6a4f5d 100644
--- a/osu.Desktop/Program.cs
+++ b/osu.Desktop/Program.cs
@@ -28,8 +28,6 @@ namespace osu.Desktop
     {
         private const string base_game_name = @"osu";
 
-        private static LegacyTcpIpcProvider legacyIpcProvider;
-
         [STAThread]
         public static void Main(string[] args)
         {

From c3fb7937627301cb92359ff2939cd9e3197cae31 Mon Sep 17 00:00:00 2001
From: mk-56 <darioheadleysilva@gmail.com>
Date: Sun, 28 Nov 2021 14:06:53 +0100
Subject: [PATCH 1320/5547] Fixed the problems that were brought up and deleted
 the old bind logic

---
 osu.Game/Configuration/OsuConfigManager.cs            |  4 +---
 osu.Game/Localisation/AudioSettingsStrings.cs         |  2 +-
 osu.Game/Localisation/GameplaySettingsStrings.cs      |  5 -----
 .../Settings/Sections/Gameplay/AudioSettings.cs       |  7 +------
 .../Rulesets/Objects/Drawables/DrawableHitObject.cs   | 11 +++++------
 5 files changed, 8 insertions(+), 21 deletions(-)

diff --git a/osu.Game/Configuration/OsuConfigManager.cs b/osu.Game/Configuration/OsuConfigManager.cs
index ed0fe17e27..90cf09dce1 100644
--- a/osu.Game/Configuration/OsuConfigManager.cs
+++ b/osu.Game/Configuration/OsuConfigManager.cs
@@ -97,7 +97,7 @@ namespace osu.Game.Configuration
             SetDefault(OsuSetting.MenuParallax, true);
 
             // Gameplay
-            SetDefault(OsuSetting.PositionalHitsoundsLevel, 0.8f, 0, 1);
+            SetDefault(OsuSetting.PositionalHitsoundsLevel, 0.2f, 0, 1);
             SetDefault(OsuSetting.DimLevel, 0.8, 0, 1, 0.01);
             SetDefault(OsuSetting.BlurLevel, 0, 0, 1, 0.01);
             SetDefault(OsuSetting.LightenDuringBreaks, true);
@@ -109,7 +109,6 @@ namespace osu.Game.Configuration
             SetDefault(OsuSetting.ShowHealthDisplayWhenCantFail, true);
             SetDefault(OsuSetting.FadePlayfieldWhenHealthLow, true);
             SetDefault(OsuSetting.KeyOverlay, false);
-            SetDefault(OsuSetting.PositionalHitSounds, true);
             SetDefault(OsuSetting.AlwaysPlayFirstComboBreak, true);
 
             SetDefault(OsuSetting.FloatingComments, false);
@@ -254,7 +253,6 @@ namespace osu.Game.Configuration
         ShowStoryboard,
         PositionalHitsoundsLevel,
         KeyOverlay,
-        PositionalHitSounds,
         AlwaysPlayFirstComboBreak,
         FloatingComments,
         HUDVisibilityMode,
diff --git a/osu.Game/Localisation/AudioSettingsStrings.cs b/osu.Game/Localisation/AudioSettingsStrings.cs
index a55816b401..ba48c412c4 100644
--- a/osu.Game/Localisation/AudioSettingsStrings.cs
+++ b/osu.Game/Localisation/AudioSettingsStrings.cs
@@ -32,7 +32,7 @@ namespace osu.Game.Localisation
         /// <summary>
         /// "Master"
         /// </summary>
-        public static LocalisableString PositionalLevel => new TranslatableString(getKey(@"positional_hitsound_audio_level"), @"Positional hitsound audio level.");
+        public static LocalisableString PositionalLevel => new TranslatableString(getKey(@"positional_hitsound_audio_level"), @"Positional hitsound audio level");
 
         /// <summary>
         /// "Level"
diff --git a/osu.Game/Localisation/GameplaySettingsStrings.cs b/osu.Game/Localisation/GameplaySettingsStrings.cs
index fa92187650..84c3704e26 100644
--- a/osu.Game/Localisation/GameplaySettingsStrings.cs
+++ b/osu.Game/Localisation/GameplaySettingsStrings.cs
@@ -84,11 +84,6 @@ namespace osu.Game.Localisation
         /// </summary>
         public static LocalisableString AlwaysShowKeyOverlay => new TranslatableString(getKey(@"key_overlay"), @"Always show key overlay");
 
-        /// <summary>
-        /// "Positional hitsounds"
-        /// </summary>
-        public static LocalisableString PositionalHitsounds => new TranslatableString(getKey(@"positional_hitsounds"), @"Positional hitsounds");
-
         /// <summary>
         /// "Always play first combo break sound"
         /// </summary>
diff --git a/osu.Game/Overlays/Settings/Sections/Gameplay/AudioSettings.cs b/osu.Game/Overlays/Settings/Sections/Gameplay/AudioSettings.cs
index 9e677943c2..a5c5399e98 100644
--- a/osu.Game/Overlays/Settings/Sections/Gameplay/AudioSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Gameplay/AudioSettings.cs
@@ -24,12 +24,7 @@ namespace osu.Game.Overlays.Settings.Sections.Gameplay
         {
             positionalHitsoundsLevel = osuConfig.GetBindable<float>(OsuSetting.PositionalHitsoundsLevel);
             Children = new Drawable[]
-            {
-                new SettingsCheckbox
-                {
-                    LabelText = GameplaySettingsStrings.PositionalHitsounds,
-                    Current = config.GetBindable<bool>(OsuSetting.PositionalHitSounds)
-                },
+            {                
                 positionalHitsoundsSettings = new FillFlowContainer<SettingsSlider<float>>
                 {
                     Direction = FillDirection.Vertical,
diff --git a/osu.Game/Rulesets/Objects/Drawables/DrawableHitObject.cs b/osu.Game/Rulesets/Objects/Drawables/DrawableHitObject.cs
index 601756485b..ea153bd0e6 100644
--- a/osu.Game/Rulesets/Objects/Drawables/DrawableHitObject.cs
+++ b/osu.Game/Rulesets/Objects/Drawables/DrawableHitObject.cs
@@ -124,10 +124,8 @@ namespace osu.Game.Rulesets.Objects.Drawables
 
         public readonly Bindable<double> StartTimeBindable = new Bindable<double>();
         private readonly BindableList<HitSampleInfo> samplesBindable = new BindableList<HitSampleInfo>();
-        private readonly Bindable<bool> userPositionalHitSounds = new Bindable<bool>();
-        private readonly Bindable<float> positionalHitsoundsLevel = new Bindable<float>();
 
-        private readonly Bindable<int> comboIndexBindable = new Bindable<int>();
+        private readonly Bindable<float> positionalHitsoundsLevel = new Bindable<float>();        private readonly Bindable<int> comboIndexBindable = new Bindable<int>();
         private readonly Bindable<int> comboIndexWithOffsetsBindable = new Bindable<int>();
 
         protected override bool RequiresChildrenUpdate => true;
@@ -170,7 +168,6 @@ namespace osu.Game.Rulesets.Objects.Drawables
         [BackgroundDependencyLoader]
         private void load(OsuConfigManager config, ISkinSource skinSource)
         {
-            config.BindWith(OsuSetting.PositionalHitSounds, userPositionalHitSounds);
             config.BindWith(OsuSetting.PositionalHitsoundsLevel, positionalHitsoundsLevel);
 
             // Explicit non-virtual function call.
@@ -535,9 +532,11 @@ namespace osu.Game.Rulesets.Objects.Drawables
         /// <param name="position">The lookup X position. Generally should be <see cref="SamplePlaybackPosition"/>.</param>
         protected double CalculateSamplePlaybackBalance(double position)
         {
+            double returnedvalue;
             float balance_adjust_amount = positionalHitsoundsLevel.Value*2;
-
-            return balance_adjust_amount * (true ? position - 0.5f : 0);
+            returnedvalue = balance_adjust_amount *(position - 0.5f );
+            
+            return returnedvalue;
         }
 
         /// <summary>

From 9065179c523eb1f1cfdfa02559da4f9bdfddde60 Mon Sep 17 00:00:00 2001
From: mk-56 <darioheadleysilva@gmail.com>
Date: Sun, 28 Nov 2021 14:09:30 +0100
Subject: [PATCH 1321/5547] Fix

---
 osu.Game/Rulesets/Objects/Drawables/DrawableHitObject.cs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Game/Rulesets/Objects/Drawables/DrawableHitObject.cs b/osu.Game/Rulesets/Objects/Drawables/DrawableHitObject.cs
index ea153bd0e6..152f92985e 100644
--- a/osu.Game/Rulesets/Objects/Drawables/DrawableHitObject.cs
+++ b/osu.Game/Rulesets/Objects/Drawables/DrawableHitObject.cs
@@ -124,6 +124,7 @@ namespace osu.Game.Rulesets.Objects.Drawables
 
         public readonly Bindable<double> StartTimeBindable = new Bindable<double>();
         private readonly BindableList<HitSampleInfo> samplesBindable = new BindableList<HitSampleInfo>();
+        private readonly Bindable<int> comboIndexBindable = new Bindable<int>();
 
         private readonly Bindable<float> positionalHitsoundsLevel = new Bindable<float>();        private readonly Bindable<int> comboIndexBindable = new Bindable<int>();
         private readonly Bindable<int> comboIndexWithOffsetsBindable = new Bindable<int>();

From 9c42cc0c05e643c807fb8fc05afba98a95e0cd3c Mon Sep 17 00:00:00 2001
From: mk-56 <darioheadleysilva@gmail.com>
Date: Sun, 28 Nov 2021 14:09:30 +0100
Subject: [PATCH 1322/5547] Fix

---
 osu.Game/Rulesets/Objects/Drawables/DrawableHitObject.cs | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Rulesets/Objects/Drawables/DrawableHitObject.cs b/osu.Game/Rulesets/Objects/Drawables/DrawableHitObject.cs
index ea153bd0e6..01c573eb94 100644
--- a/osu.Game/Rulesets/Objects/Drawables/DrawableHitObject.cs
+++ b/osu.Game/Rulesets/Objects/Drawables/DrawableHitObject.cs
@@ -125,7 +125,8 @@ namespace osu.Game.Rulesets.Objects.Drawables
         public readonly Bindable<double> StartTimeBindable = new Bindable<double>();
         private readonly BindableList<HitSampleInfo> samplesBindable = new BindableList<HitSampleInfo>();
 
-        private readonly Bindable<float> positionalHitsoundsLevel = new Bindable<float>();        private readonly Bindable<int> comboIndexBindable = new Bindable<int>();
+        private readonly Bindable<float> positionalHitsoundsLevel = new Bindable<float>();        
+        private readonly Bindable<int> comboIndexBindable = new Bindable<int>();
         private readonly Bindable<int> comboIndexWithOffsetsBindable = new Bindable<int>();
 
         protected override bool RequiresChildrenUpdate => true;

From 27ba3c6d1a8c18bb69aeac5e38d97966dcba56ed Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Sun, 28 Nov 2021 22:16:21 +0900
Subject: [PATCH 1323/5547] Add back removed getter

Seems to somehow be required.
---
 osu.Desktop/LegacyIpc/LegacyIpcMessage.cs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Desktop/LegacyIpc/LegacyIpcMessage.cs b/osu.Desktop/LegacyIpc/LegacyIpcMessage.cs
index 2e421068dc..6fefae4509 100644
--- a/osu.Desktop/LegacyIpc/LegacyIpcMessage.cs
+++ b/osu.Desktop/LegacyIpc/LegacyIpcMessage.cs
@@ -23,6 +23,7 @@ namespace osu.Desktop.LegacyIpc
 
         public new object Value
         {
+            get => base.Value;
             set => base.Value = new Data
             {
                 MessageType = value.GetType().Name,

From 18a0a791fd9f56c08a81b622ea0f196fef00097a Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Sun, 28 Nov 2021 22:24:42 +0900
Subject: [PATCH 1324/5547] Refactor

---
 osu.Desktop/LegacyIpc/LegacyTcpIpcProvider.cs |  5 +++--
 osu.Desktop/Program.cs                        | 18 ++++++++++++++----
 2 files changed, 17 insertions(+), 6 deletions(-)

diff --git a/osu.Desktop/LegacyIpc/LegacyTcpIpcProvider.cs b/osu.Desktop/LegacyIpc/LegacyTcpIpcProvider.cs
index 43d9dd741c..7855f9c7ce 100644
--- a/osu.Desktop/LegacyIpc/LegacyTcpIpcProvider.cs
+++ b/osu.Desktop/LegacyIpc/LegacyTcpIpcProvider.cs
@@ -13,7 +13,7 @@ namespace osu.Desktop.LegacyIpc
     /// </summary>
     public class LegacyTcpIpcProvider : TcpIpcProvider
     {
-        private static readonly Logger logger = Logger.GetLogger("ipc");
+        private static readonly Logger logger = Logger.GetLogger("legacy-ipc");
 
         /// <summary>
         /// Invoked when a message is received from a legacy client.
@@ -27,7 +27,8 @@ namespace osu.Desktop.LegacyIpc
             {
                 try
                 {
-                    logger.Add($"Processing incoming IPC message: {msg.Value}");
+                    logger.Add($"Processing legacy IPC message...");
+                    logger.Add($"\t{msg.Value}", LogLevel.Debug);
 
                     var legacyData = ((JObject)msg.Value).ToObject<LegacyIpcMessage.Data>();
                     object value = parseObject((JObject)legacyData!.MessageData, legacyData.MessageType);
diff --git a/osu.Desktop/Program.cs b/osu.Desktop/Program.cs
index c41a6a4f5d..9542ccd8dc 100644
--- a/osu.Desktop/Program.cs
+++ b/osu.Desktop/Program.cs
@@ -28,6 +28,8 @@ namespace osu.Desktop
     {
         private const string base_game_name = @"osu";
 
+        private static LegacyTcpIpcProvider legacyIpc;
+
         [STAThread]
         public static void Main(string[] args)
         {
@@ -92,10 +94,18 @@ namespace osu.Desktop
 
                 if (host.IsPrimaryInstance)
                 {
-                    var legacyIpc = new LegacyTcpIpcProvider();
-                    legacyIpc.MessageReceived += onLegacyIpcMessageReceived;
-                    legacyIpc.Bind();
-                    legacyIpc.StartAsync();
+                    try
+                    {
+                        Logger.Log("Starting legacy IPC provider...");
+                        legacyIpc = new LegacyTcpIpcProvider();
+                        legacyIpc.MessageReceived += onLegacyIpcMessageReceived;
+                        legacyIpc.Bind();
+                        legacyIpc.StartAsync();
+                    }
+                    catch (Exception ex)
+                    {
+                        Logger.Error(ex, "Failed to start legacy IPC provider");
+                    }
                 }
 
                 if (tournamentClient)

From fc3eb08452d620fb0b5c5158be30313f117c1ca5 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Sun, 28 Nov 2021 22:27:59 +0900
Subject: [PATCH 1325/5547] Output raw message on failure

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

diff --git a/osu.Desktop/LegacyIpc/LegacyTcpIpcProvider.cs b/osu.Desktop/LegacyIpc/LegacyTcpIpcProvider.cs
index 7855f9c7ce..4fb500fa9c 100644
--- a/osu.Desktop/LegacyIpc/LegacyTcpIpcProvider.cs
+++ b/osu.Desktop/LegacyIpc/LegacyTcpIpcProvider.cs
@@ -38,7 +38,7 @@ namespace osu.Desktop.LegacyIpc
                 }
                 catch (Exception ex)
                 {
-                    logger.Add("Processing IPC message failed!", exception: ex);
+                    logger.Add($"Processing IPC message failed: {msg.Value}", exception: ex);
                     return null;
                 }
             };

From 0d147b4ad9f7a7bc308eef9508034b45b499add5 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Sun, 28 Nov 2021 22:59:49 +0900
Subject: [PATCH 1326/5547] Return null IPC response for archive imports

---
 osu.Game/IPC/ArchiveImportIPCChannel.cs | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/osu.Game/IPC/ArchiveImportIPCChannel.cs b/osu.Game/IPC/ArchiveImportIPCChannel.cs
index d9d0e4c0ea..f381aad39a 100644
--- a/osu.Game/IPC/ArchiveImportIPCChannel.cs
+++ b/osu.Game/IPC/ArchiveImportIPCChannel.cs
@@ -18,6 +18,7 @@ namespace osu.Game.IPC
             : base(host)
         {
             this.importer = importer;
+
             MessageReceived += msg =>
             {
                 Debug.Assert(importer != null);
@@ -25,6 +26,8 @@ namespace osu.Game.IPC
                 {
                     if (t.Exception != null) throw t.Exception;
                 }, TaskContinuationOptions.OnlyOnFaulted);
+
+                return null;
             };
         }
 

From 93b5aec23ec00b85b75a4aebcc22dfc40d68750d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 28 Nov 2021 15:00:40 +0100
Subject: [PATCH 1327/5547] Fix realm migration failures when upgrading from
 old versions

* `RealmRulesetSetting` was added in 2021.916.0.
* `RealmKeyBinding` was added in 2021.703.0.

Attempting to upgrade from older releases than the above would cause
migrations up to schema versions 10 and 11 to fail.
---
 osu.Game/Database/RealmContextFactory.cs | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/osu.Game/Database/RealmContextFactory.cs b/osu.Game/Database/RealmContextFactory.cs
index 3c5dfeafe8..2bc77934a8 100644
--- a/osu.Game/Database/RealmContextFactory.cs
+++ b/osu.Game/Database/RealmContextFactory.cs
@@ -307,6 +307,9 @@ namespace osu.Game.Database
                 case 10:
                     string rulesetSettingClassName = getMappedOrOriginalName(typeof(RealmRulesetSetting));
 
+                    if (!migration.OldRealm.Schema.TryFindObjectSchema(rulesetSettingClassName, out _))
+                        return;
+
                     var oldSettings = migration.OldRealm.DynamicApi.All(rulesetSettingClassName);
                     var newSettings = migration.NewRealm.All<RealmRulesetSetting>().ToList();
 
@@ -329,6 +332,9 @@ namespace osu.Game.Database
                 case 11:
                     string keyBindingClassName = getMappedOrOriginalName(typeof(RealmKeyBinding));
 
+                    if (!migration.OldRealm.Schema.TryFindObjectSchema(keyBindingClassName, out _))
+                        return;
+
                     var oldKeyBindings = migration.OldRealm.DynamicApi.All(keyBindingClassName);
                     var newKeyBindings = migration.NewRealm.All<RealmKeyBinding>().ToList();
 

From 4ee2063683f7fb14a9e93a0f36e1800e6f20b514 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Sun, 28 Nov 2021 23:02:57 +0900
Subject: [PATCH 1328/5547] Move event handlign internal to
 LegacyTcpIpcProvider

---
 osu.Desktop/LegacyIpc/LegacyTcpIpcProvider.cs | 45 ++++++++++++++++++-
 osu.Desktop/Program.cs                        | 44 ------------------
 2 files changed, 44 insertions(+), 45 deletions(-)

diff --git a/osu.Desktop/LegacyIpc/LegacyTcpIpcProvider.cs b/osu.Desktop/LegacyIpc/LegacyTcpIpcProvider.cs
index 4fb500fa9c..273e17d24b 100644
--- a/osu.Desktop/LegacyIpc/LegacyTcpIpcProvider.cs
+++ b/osu.Desktop/LegacyIpc/LegacyTcpIpcProvider.cs
@@ -2,9 +2,18 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
+using System.Linq;
 using Newtonsoft.Json.Linq;
 using osu.Framework.Logging;
 using osu.Framework.Platform;
+using osu.Game.Beatmaps;
+using osu.Game.Beatmaps.Legacy;
+using osu.Game.Rulesets;
+using osu.Game.Rulesets.Catch;
+using osu.Game.Rulesets.Mania;
+using osu.Game.Rulesets.Mods;
+using osu.Game.Rulesets.Osu;
+using osu.Game.Rulesets.Taiko;
 
 namespace osu.Desktop.LegacyIpc
 {
@@ -33,7 +42,7 @@ namespace osu.Desktop.LegacyIpc
                     var legacyData = ((JObject)msg.Value).ToObject<LegacyIpcMessage.Data>();
                     object value = parseObject((JObject)legacyData!.MessageData, legacyData.MessageType);
 
-                    object result = MessageReceived?.Invoke(value);
+                    object result = onLegacyIpcMessageReceived(value);
                     return result != null ? new LegacyIpcMessage { Value = result } : null;
                 }
                 catch (Exception ex)
@@ -58,5 +67,39 @@ namespace osu.Desktop.LegacyIpc
                     throw new ArgumentException($"Unknown type: {type}");
             }
         }
+
+        private object onLegacyIpcMessageReceived(object message)
+        {
+            switch (message)
+            {
+                case LegacyIpcDifficultyCalculationRequest req:
+                    try
+                    {
+                        Ruleset ruleset = req.RulesetId switch
+                        {
+                            0 => new OsuRuleset(),
+                            1 => new TaikoRuleset(),
+                            2 => new CatchRuleset(),
+                            3 => new ManiaRuleset(),
+                            _ => throw new ArgumentException("Invalid ruleset id")
+                        };
+
+                        Mod[] mods = ruleset.ConvertFromLegacyMods((LegacyMods)req.Mods).ToArray();
+                        WorkingBeatmap beatmap = new FlatFileWorkingBeatmap(req.BeatmapFile, _ => ruleset);
+
+                        return new LegacyIpcDifficultyCalculationResponse
+                        {
+                            StarRating = ruleset.CreateDifficultyCalculator(beatmap).Calculate(mods).StarRating
+                        };
+                    }
+                    catch
+                    {
+                        return new LegacyIpcDifficultyCalculationResponse();
+                    }
+            }
+
+            Console.WriteLine("Type not matched.");
+            return null;
+        }
     }
 }
diff --git a/osu.Desktop/Program.cs b/osu.Desktop/Program.cs
index 9542ccd8dc..a9e3575a49 100644
--- a/osu.Desktop/Program.cs
+++ b/osu.Desktop/Program.cs
@@ -3,7 +3,6 @@
 
 using System;
 using System.IO;
-using System.Linq;
 using System.Threading;
 using System.Threading.Tasks;
 using osu.Desktop.LegacyIpc;
@@ -11,15 +10,7 @@ using osu.Framework;
 using osu.Framework.Development;
 using osu.Framework.Logging;
 using osu.Framework.Platform;
-using osu.Game.Beatmaps;
-using osu.Game.Beatmaps.Legacy;
 using osu.Game.IPC;
-using osu.Game.Rulesets;
-using osu.Game.Rulesets.Catch;
-using osu.Game.Rulesets.Mania;
-using osu.Game.Rulesets.Mods;
-using osu.Game.Rulesets.Osu;
-using osu.Game.Rulesets.Taiko;
 using osu.Game.Tournament;
 
 namespace osu.Desktop
@@ -98,7 +89,6 @@ namespace osu.Desktop
                     {
                         Logger.Log("Starting legacy IPC provider...");
                         legacyIpc = new LegacyTcpIpcProvider();
-                        legacyIpc.MessageReceived += onLegacyIpcMessageReceived;
                         legacyIpc.Bind();
                         legacyIpc.StartAsync();
                     }
@@ -132,39 +122,5 @@ namespace osu.Desktop
 
             return continueExecution;
         }
-
-        private static object onLegacyIpcMessageReceived(object message)
-        {
-            switch (message)
-            {
-                case LegacyIpcDifficultyCalculationRequest req:
-                    try
-                    {
-                        Ruleset ruleset = req.RulesetId switch
-                        {
-                            0 => new OsuRuleset(),
-                            1 => new TaikoRuleset(),
-                            2 => new CatchRuleset(),
-                            3 => new ManiaRuleset(),
-                            _ => throw new ArgumentException("Invalid ruleset id")
-                        };
-
-                        Mod[] mods = ruleset.ConvertFromLegacyMods((LegacyMods)req.Mods).ToArray();
-                        WorkingBeatmap beatmap = new FlatFileWorkingBeatmap(req.BeatmapFile, _ => ruleset);
-
-                        return new LegacyIpcDifficultyCalculationResponse
-                        {
-                            StarRating = ruleset.CreateDifficultyCalculator(beatmap).Calculate(mods).StarRating
-                        };
-                    }
-                    catch
-                    {
-                        return new LegacyIpcDifficultyCalculationResponse();
-                    }
-            }
-
-            Console.WriteLine("Type not matched.");
-            return null;
-        }
     }
 }

From aba9ed624a408d7b0b28e45796d6dd1e096b977f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 28 Nov 2021 15:16:33 +0100
Subject: [PATCH 1329/5547] Remove unnecessary whitespace

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

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModApproachDifferent.cs b/osu.Game.Rulesets.Osu/Mods/OsuModApproachDifferent.cs
index db74790221..d784320d22 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModApproachDifferent.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModApproachDifferent.cs
@@ -90,7 +90,7 @@ namespace osu.Game.Rulesets.Osu.Mods
         public enum AnimationStyle
         {
             Linear,
-            Gravity,           
+            Gravity,
             InOut1,
             InOut2,
             Accelerate1,

From 5001412a0dada04c25400ebeb8676e5d927f1f9c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 28 Nov 2021 15:19:12 +0100
Subject: [PATCH 1330/5547] Reorder easing mapping to match enum order and
 throw on unknown animation style

---
 .../Mods/OsuModApproachDifferent.cs           | 24 +++++++++----------
 1 file changed, 12 insertions(+), 12 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModApproachDifferent.cs b/osu.Game.Rulesets.Osu/Mods/OsuModApproachDifferent.cs
index d784320d22..8b323eefa6 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModApproachDifferent.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModApproachDifferent.cs
@@ -52,24 +52,27 @@ namespace osu.Game.Rulesets.Osu.Mods
         {
             switch (style)
             {
-                default:
+                case AnimationStyle.Linear:
                     return Easing.None;
 
+                case AnimationStyle.Gravity:
+                    return Easing.InBack;
+
+                case AnimationStyle.InOut1:
+                    return Easing.InOutCubic;
+
+                case AnimationStyle.InOut2:
+                    return Easing.InOutQuint;
+
                 case AnimationStyle.Accelerate1:
                     return Easing.In;
 
-                case AnimationStyle.Linear:
-                    return Easing.None;
-
                 case AnimationStyle.Accelerate2:
                     return Easing.InCubic;
 
                 case AnimationStyle.Accelerate3:
                     return Easing.InQuint;
 
-                case AnimationStyle.Gravity:
-                    return Easing.InBack;
-
                 case AnimationStyle.Decelerate1:
                     return Easing.Out;
 
@@ -79,11 +82,8 @@ namespace osu.Game.Rulesets.Osu.Mods
                 case AnimationStyle.Decelerate3:
                     return Easing.OutQuint;
 
-                case AnimationStyle.InOut1:
-                    return Easing.InOutCubic;
-
-                case AnimationStyle.InOut2:
-                    return Easing.InOutQuint;
+                default:
+                    throw new ArgumentOutOfRangeException(nameof(style), style, @"Unsupported animation style");
             }
         }
 

From 87d6a743dd9cd153d347a6257cb7086b69449b1f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 28 Nov 2021 16:14:12 +0100
Subject: [PATCH 1331/5547] Migrate custom tournament client assets to
 uppercased directories

It has transpired that on filename-case-sensitive filesystems, the
tournament client does not consistently handle custom asset paths.
Videos and mods could only be looked up from `videos` and `mods`
directories (lowercase), while flags could only be looked up from the
`Flags` directory (uppercase).

A complicating circumstance is that default country flags, coming from
osu-resources, also depend on the flag lookup being uppercased.

To attempt to clean up the handling as much as it appears to be
possible, automatically move user-supplied lowercase directories to
uppercase.
---
 .../NonVisual/CustomTourneyDirectoryTest.cs     | 12 ++++++------
 .../Components/TournamentModIcon.cs             |  2 +-
 osu.Game.Tournament/IO/TournamentStorage.cs     | 17 +++++++++++++++++
 .../IO/TournamentVideoResourceStore.cs          |  2 +-
 .../Screens/TeamIntro/SeedingScreen.cs          |  2 +-
 5 files changed, 26 insertions(+), 9 deletions(-)

diff --git a/osu.Game.Tournament.Tests/NonVisual/CustomTourneyDirectoryTest.cs b/osu.Game.Tournament.Tests/NonVisual/CustomTourneyDirectoryTest.cs
index 94472a8bc7..d149ec145b 100644
--- a/osu.Game.Tournament.Tests/NonVisual/CustomTourneyDirectoryTest.cs
+++ b/osu.Game.Tournament.Tests/NonVisual/CustomTourneyDirectoryTest.cs
@@ -87,9 +87,9 @@ namespace osu.Game.Tournament.Tests.NonVisual
                 // Recreate the old setup that uses "tournament" as the base path.
                 string oldPath = Path.Combine(osuRoot, "tournament");
 
-                string videosPath = Path.Combine(oldPath, "videos");
-                string modsPath = Path.Combine(oldPath, "mods");
-                string flagsPath = Path.Combine(oldPath, "flags");
+                string videosPath = Path.Combine(oldPath, "Videos");
+                string modsPath = Path.Combine(oldPath, "Mods");
+                string flagsPath = Path.Combine(oldPath, "Flags");
 
                 Directory.CreateDirectory(videosPath);
                 Directory.CreateDirectory(modsPath);
@@ -123,9 +123,9 @@ namespace osu.Game.Tournament.Tests.NonVisual
 
                     string migratedPath = Path.Combine(host.Storage.GetFullPath("."), "tournaments", "default");
 
-                    videosPath = Path.Combine(migratedPath, "videos");
-                    modsPath = Path.Combine(migratedPath, "mods");
-                    flagsPath = Path.Combine(migratedPath, "flags");
+                    videosPath = Path.Combine(migratedPath, "Videos");
+                    modsPath = Path.Combine(migratedPath, "Mods");
+                    flagsPath = Path.Combine(migratedPath, "Flags");
 
                     videoFile = Path.Combine(videosPath, "video.mp4");
                     modFile = Path.Combine(modsPath, "mod.png");
diff --git a/osu.Game.Tournament/Components/TournamentModIcon.cs b/osu.Game.Tournament/Components/TournamentModIcon.cs
index 7c4e9c69a2..0fde263bc8 100644
--- a/osu.Game.Tournament/Components/TournamentModIcon.cs
+++ b/osu.Game.Tournament/Components/TournamentModIcon.cs
@@ -31,7 +31,7 @@ namespace osu.Game.Tournament.Components
         [BackgroundDependencyLoader]
         private void load(TextureStore textures, LadderInfo ladderInfo)
         {
-            var customTexture = textures.Get($"mods/{modAcronym}");
+            var customTexture = textures.Get($"Mods/{modAcronym}");
 
             if (customTexture != null)
             {
diff --git a/osu.Game.Tournament/IO/TournamentStorage.cs b/osu.Game.Tournament/IO/TournamentStorage.cs
index 044b60bbd5..02cf567837 100644
--- a/osu.Game.Tournament/IO/TournamentStorage.cs
+++ b/osu.Game.Tournament/IO/TournamentStorage.cs
@@ -51,6 +51,23 @@ namespace osu.Game.Tournament.IO
             Logger.Log("Changing tournament storage: " + GetFullPath(string.Empty));
         }
 
+        protected override void ChangeTargetStorage(Storage newStorage)
+        {
+            // due to an unfortunate oversight, on OSes that are sensitive to pathname casing
+            // the custom flags directory needed to be named `Flags` (uppercase),
+            // while custom mods and videos directories needed to be named `mods` and `videos` respectively (lowercase).
+            // to unify handling to uppercase, move any non-compliant directories automatically for the user to migrate.
+            // can be removed 20220528
+            if (newStorage.ExistsDirectory("flags"))
+                AttemptOperation(() => Directory.Move(newStorage.GetFullPath("flags"), newStorage.GetFullPath("Flags")));
+            if (newStorage.ExistsDirectory("mods"))
+                AttemptOperation(() => Directory.Move(newStorage.GetFullPath("mods"), newStorage.GetFullPath("Mods")));
+            if (newStorage.ExistsDirectory("videos"))
+                AttemptOperation(() => Directory.Move(newStorage.GetFullPath("videos"), newStorage.GetFullPath("Videos")));
+
+            base.ChangeTargetStorage(newStorage);
+        }
+
         public IEnumerable<string> ListTournaments() => AllTournaments.GetDirectories(string.Empty);
 
         public override void Migrate(Storage newStorage)
diff --git a/osu.Game.Tournament/IO/TournamentVideoResourceStore.cs b/osu.Game.Tournament/IO/TournamentVideoResourceStore.cs
index 4b26840b79..964d03220d 100644
--- a/osu.Game.Tournament/IO/TournamentVideoResourceStore.cs
+++ b/osu.Game.Tournament/IO/TournamentVideoResourceStore.cs
@@ -9,7 +9,7 @@ namespace osu.Game.Tournament.IO
     public class TournamentVideoResourceStore : NamespacedResourceStore<byte[]>
     {
         public TournamentVideoResourceStore(Storage storage)
-            : base(new StorageBackedResourceStore(storage), "videos")
+            : base(new StorageBackedResourceStore(storage), "Videos")
         {
             AddExtension("m4v");
             AddExtension("avi");
diff --git a/osu.Game.Tournament/Screens/TeamIntro/SeedingScreen.cs b/osu.Game.Tournament/Screens/TeamIntro/SeedingScreen.cs
index d34a8583b9..cd74a75b10 100644
--- a/osu.Game.Tournament/Screens/TeamIntro/SeedingScreen.cs
+++ b/osu.Game.Tournament/Screens/TeamIntro/SeedingScreen.cs
@@ -197,7 +197,7 @@ namespace osu.Game.Tournament.Screens.TeamIntro
                     {
                         row.Add(new Sprite
                         {
-                            Texture = textures.Get($"mods/{mods.ToLower()}"),
+                            Texture = textures.Get($"Mods/{mods.ToLower()}"),
                             Scale = new Vector2(0.5f)
                         });
                     }

From 21e8ab835769c5be5c66f16b241bdf6cb774b848 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 26 Nov 2021 14:40:09 +0900
Subject: [PATCH 1332/5547] Return `ILive` from `ToLive` calls instead of
 realm-typed instance

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

diff --git a/osu.Game/Database/RealmObjectExtensions.cs b/osu.Game/Database/RealmObjectExtensions.cs
index 18a926fa8c..ac4ca436ad 100644
--- a/osu.Game/Database/RealmObjectExtensions.cs
+++ b/osu.Game/Database/RealmObjectExtensions.cs
@@ -49,13 +49,13 @@ namespace osu.Game.Database
             return mapper.Map<T>(item);
         }
 
-        public static List<RealmLive<T>> ToLive<T>(this IEnumerable<T> realmList)
+        public static List<ILive<T>> ToLive<T>(this IEnumerable<T> realmList)
             where T : RealmObject, IHasGuidPrimaryKey
         {
-            return realmList.Select(l => new RealmLive<T>(l)).ToList();
+            return realmList.Select(l => new RealmLive<T>(l)).Cast<ILive<T>>().ToList();
         }
 
-        public static RealmLive<T> ToLive<T>(this T realmObject)
+        public static ILive<T> ToLive<T>(this T realmObject)
             where T : RealmObject, IHasGuidPrimaryKey
         {
             return new RealmLive<T>(realmObject);

From 3bd4872520ca02a1ec1af4de5ad4fdf548731e9d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 26 Nov 2021 16:36:05 +0900
Subject: [PATCH 1333/5547] Add note about indexing support for
 `RealmNamedFileUsage.Filename`

---
 osu.Game/Models/RealmNamedFileUsage.cs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Game/Models/RealmNamedFileUsage.cs b/osu.Game/Models/RealmNamedFileUsage.cs
index ba12d51d0b..17e32510a8 100644
--- a/osu.Game/Models/RealmNamedFileUsage.cs
+++ b/osu.Game/Models/RealmNamedFileUsage.cs
@@ -16,6 +16,7 @@ namespace osu.Game.Models
     {
         public RealmFile File { get; set; } = null!;
 
+        // [Indexed] cannot be used on `EmbeddedObject`s as it only applies to top-level queries. May need to reconsider this if performance becomes a concern.
         public string Filename { get; set; } = null!;
 
         public RealmNamedFileUsage(RealmFile file, string filename)

From e40e5096ea7a7d71e4070aa9e1e095b5b4cc1f7b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 26 Nov 2021 14:43:35 +0900
Subject: [PATCH 1334/5547] Remove `RealmLive` context re-fetch optimisation
 for now

---
 osu.Game/Database/RealmLive.cs | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Database/RealmLive.cs b/osu.Game/Database/RealmLive.cs
index 73e6715aaa..dae4197309 100644
--- a/osu.Game/Database/RealmLive.cs
+++ b/osu.Game/Database/RealmLive.cs
@@ -114,7 +114,10 @@ namespace osu.Game.Database
             }
         }
 
-        private bool originalDataValid => !IsManaged || (isCorrectThread && data.IsValid);
+        // TODO: Revisit adding these conditionals back as an optimisation: || (isCorrectThread && data.IsValid);
+        // They have temporarily been removed due to an oversight involving .AsQueryable, see https://github.com/realm/realm-dotnet/discussions/2734.
+        // This means we are fetching a new context every `PerformRead` or `PerformWrite`, even when on the correct thread.
+        private bool originalDataValid => !IsManaged;
 
         // this matches realm's internal thread validation (see https://github.com/realm/realm-dotnet/blob/903b4d0b304f887e37e2d905384fb572a6496e70/Realm/Realm/Native/SynchronizationContextScheduler.cs#L72)
         private bool isCorrectThread

From cb8fa803524d951d94dbb406322de050b304f9be Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 26 Nov 2021 21:33:11 +0900
Subject: [PATCH 1335/5547] Don't dispose fetched realm instance when using
 `RealmLive.Value`

See https://github.com/realm/realm-dotnet/discussions/2734#discussioncomment-1705038 for reasoning.
---
 osu.Game/Database/RealmLive.cs | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Database/RealmLive.cs b/osu.Game/Database/RealmLive.cs
index dae4197309..7ae7d8544a 100644
--- a/osu.Game/Database/RealmLive.cs
+++ b/osu.Game/Database/RealmLive.cs
@@ -102,10 +102,11 @@ namespace osu.Game.Database
                 if (originalDataValid)
                     return data;
 
-                T retrieved;
+                if (!isCorrectThread)
+                    throw new InvalidOperationException($"Can't use {nameof(Value)} unless on the same thread the original data was fetched from.");
 
-                using (var realm = Realm.GetInstance(data.Realm.Config))
-                    retrieved = realm.Find<T>(ID);
+                var realm = Realm.GetInstance(data.Realm.Config);
+                var retrieved = realm.Find<T>(ID);
 
                 if (!retrieved.IsValid)
                     throw new InvalidOperationException("Attempted to access value without an open context");

From d73e81ee63f1bc385b76a2e52c4663d04776df44 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 29 Nov 2021 14:48:28 +0900
Subject: [PATCH 1336/5547] Add test coverage of non-optimised existing model
 check

---
 .../Database/BeatmapImporterTests.cs          | 41 ++++++++++++++++++-
 1 file changed, 40 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Database/BeatmapImporterTests.cs b/osu.Game.Tests/Database/BeatmapImporterTests.cs
index 9ee237cfd9..d2193350ad 100644
--- a/osu.Game.Tests/Database/BeatmapImporterTests.cs
+++ b/osu.Game.Tests/Database/BeatmapImporterTests.cs
@@ -12,6 +12,7 @@ using NUnit.Framework;
 using osu.Framework.Extensions;
 using osu.Framework.Extensions.ObjectExtensions;
 using osu.Framework.Logging;
+using osu.Framework.Platform;
 using osu.Game.Beatmaps;
 using osu.Game.Database;
 using osu.Game.Extensions;
@@ -474,7 +475,7 @@ namespace osu.Game.Tests.Database
         }
 
         [Test]
-        public void TestImportThenDeleteThenImport()
+        public void TestImportThenDeleteThenImportOptimisedPath()
         {
             RunTestWithRealmAsync(async (realmFactory, storage) =>
             {
@@ -485,11 +486,39 @@ namespace osu.Game.Tests.Database
 
                 deleteBeatmapSet(imported, realmFactory.Context);
 
+                Assert.IsTrue(imported.DeletePending);
+
                 var importedSecondTime = await LoadOszIntoStore(importer, realmFactory.Context);
 
                 // check the newly "imported" beatmap is actually just the restored previous import. since it matches hash.
                 Assert.IsTrue(imported.ID == importedSecondTime.ID);
                 Assert.IsTrue(imported.Beatmaps.First().ID == importedSecondTime.Beatmaps.First().ID);
+                Assert.IsFalse(imported.DeletePending);
+                Assert.IsFalse(importedSecondTime.DeletePending);
+            });
+        }
+
+        [Test]
+        public void TestImportThenDeleteThenImportNonOptimisedPath()
+        {
+            RunTestWithRealmAsync(async (realmFactory, storage) =>
+            {
+                using var importer = new NonOptimisedBeatmapImporter(realmFactory, storage);
+                using var store = new RealmRulesetStore(realmFactory, storage);
+
+                var imported = await LoadOszIntoStore(importer, realmFactory.Context);
+
+                deleteBeatmapSet(imported, realmFactory.Context);
+
+                Assert.IsTrue(imported.DeletePending);
+
+                var importedSecondTime = await LoadOszIntoStore(importer, realmFactory.Context);
+
+                // check the newly "imported" beatmap is actually just the restored previous import. since it matches hash.
+                Assert.IsTrue(imported.ID == importedSecondTime.ID);
+                Assert.IsTrue(imported.Beatmaps.First().ID == importedSecondTime.Beatmaps.First().ID);
+                Assert.IsFalse(imported.DeletePending);
+                Assert.IsFalse(importedSecondTime.DeletePending);
             });
         }
 
@@ -867,5 +896,15 @@ namespace osu.Game.Tests.Database
 
             Assert.Fail(failureMessage);
         }
+
+        public class NonOptimisedBeatmapImporter : BeatmapImporter
+        {
+            public NonOptimisedBeatmapImporter(RealmContextFactory realmFactory, Storage storage)
+                : base(realmFactory, storage)
+            {
+            }
+
+            protected override bool HasCustomHashFunction => true;
+        }
     }
 }

From 2ee08b5f4cb35e832dedbda3fc1c8b9876d629d4 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 26 Nov 2021 19:05:34 +0900
Subject: [PATCH 1337/5547] Fix undelete on existing not committing transaction

---
 osu.Game/Stores/RealmArchiveModelImporter.cs | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/osu.Game/Stores/RealmArchiveModelImporter.cs b/osu.Game/Stores/RealmArchiveModelImporter.cs
index b74670e722..56469184a9 100644
--- a/osu.Game/Stores/RealmArchiveModelImporter.cs
+++ b/osu.Game/Stores/RealmArchiveModelImporter.cs
@@ -387,7 +387,9 @@ namespace osu.Game.Stores
                             if (CanReuseExisting(existing, item))
                             {
                                 LogForModel(item, @$"Found existing {HumanisedModelName} for {item} (ID {existing.ID}) – skipping import.");
+
                                 existing.DeletePending = false;
+                                transaction.Commit();
 
                                 return existing.ToLive();
                             }

From 791f7e380139b40389cde6d8927e4683dc25607e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 29 Nov 2021 15:14:27 +0900
Subject: [PATCH 1338/5547] Update `RealmLive` tests in line with modified
 behaviour

---
 osu.Game.Tests/Database/RealmLiveTests.cs | 68 ++++++++++++++---------
 1 file changed, 42 insertions(+), 26 deletions(-)

diff --git a/osu.Game.Tests/Database/RealmLiveTests.cs b/osu.Game.Tests/Database/RealmLiveTests.cs
index f86761fdc8..63566394d6 100644
--- a/osu.Game.Tests/Database/RealmLiveTests.cs
+++ b/osu.Game.Tests/Database/RealmLiveTests.cs
@@ -66,19 +66,29 @@ namespace osu.Game.Tests.Database
 
                 Task.Factory.StartNew(() =>
                 {
-                    Assert.DoesNotThrow(() =>
+                    // TODO: The commented code is the behaviour we hope to obtain, but is temporarily disabled.
+                    // See https://github.com/ppy/osu/pull/15851
+                    using (realmFactory.CreateContext())
                     {
-                        using (realmFactory.CreateContext())
+                        Assert.Throws<InvalidOperationException>(() =>
                         {
-                            var resolved = liveBeatmap.Value;
+                            var __ = liveBeatmap.Value;
+                        });
+                    }
 
-                            Assert.IsTrue(resolved.Realm.IsClosed);
-                            Assert.IsTrue(resolved.IsValid);
-
-                            // can access properties without a crash.
-                            Assert.IsFalse(resolved.Hidden);
-                        }
-                    });
+                    // Assert.DoesNotThrow(() =>
+                    // {
+                    //     using (realmFactory.CreateContext())
+                    //     {
+                    //         var resolved = liveBeatmap.Value;
+                    //
+                    //         Assert.IsTrue(resolved.Realm.IsClosed);
+                    //         Assert.IsTrue(resolved.IsValid);
+                    //
+                    //         // can access properties without a crash.
+                    //         Assert.IsFalse(resolved.Hidden);
+                    //     }
+                    // });
                 }, TaskCreationOptions.LongRunning | TaskCreationOptions.HideScheduler).Wait();
             });
         }
@@ -199,23 +209,29 @@ namespace osu.Game.Tests.Database
                     Assert.AreEqual(0, updateThreadContext.All<RealmBeatmap>().Count());
                     Assert.AreEqual(0, changesTriggered);
 
-                    var resolved = liveBeatmap.Value;
-
-                    // retrieval causes an implicit refresh. even changes that aren't related to the retrieval are fired at this point.
-                    Assert.AreEqual(2, updateThreadContext.All<RealmBeatmap>().Count());
-                    Assert.AreEqual(1, changesTriggered);
-
-                    // even though the realm that this instance was resolved for was closed, it's still valid.
-                    Assert.IsTrue(resolved.Realm.IsClosed);
-                    Assert.IsTrue(resolved.IsValid);
-
-                    // can access properties without a crash.
-                    Assert.IsFalse(resolved.Hidden);
-
-                    updateThreadContext.Write(r =>
+                    // TODO: Originally the following was using `liveBeatmap.Value`. This has been temporarily disabled.
+                    // See https://github.com/ppy/osu/pull/15851
+                    liveBeatmap.PerformRead(resolved =>
                     {
-                        // can use with the main context.
-                        r.Remove(resolved);
+                        // retrieval causes an implicit refresh. even changes that aren't related to the retrieval are fired at this point.
+                        // ReSharper disable once AccessToDisposedClosure
+                        Assert.AreEqual(2, updateThreadContext.All<RealmBeatmap>().Count());
+                        Assert.AreEqual(1, changesTriggered);
+
+                        // TODO: as above, temporarily disabled as it doesn't make sense inside a `PerformRead`.
+                        // // even though the realm that this instance was resolved for was closed, it's still valid.
+                        // Assert.IsTrue(resolved.Realm.IsClosed);
+                        // Assert.IsTrue(resolved.IsValid);
+
+                        // can access properties without a crash.
+                        Assert.IsFalse(resolved.Hidden);
+
+                        // ReSharper disable once AccessToDisposedClosure
+                        updateThreadContext.Write(r =>
+                        {
+                            // can use with the main context.
+                            r.Remove(resolved);
+                        });
                     });
                 }
 

From 54798eabc9c34f83466bd42296236e4cec26c531 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 29 Nov 2021 16:27:16 +0900
Subject: [PATCH 1339/5547] Add test coverage of potential deeadlock scenario
 with nested realm context fetching

---
 osu.Game.Tests/Database/GeneralUsageTests.cs | 34 ++++++++++++++++++++
 1 file changed, 34 insertions(+)

diff --git a/osu.Game.Tests/Database/GeneralUsageTests.cs b/osu.Game.Tests/Database/GeneralUsageTests.cs
index 3e8b6091fd..fec1a0dedd 100644
--- a/osu.Game.Tests/Database/GeneralUsageTests.cs
+++ b/osu.Game.Tests/Database/GeneralUsageTests.cs
@@ -5,6 +5,9 @@ using System;
 using System.Threading;
 using System.Threading.Tasks;
 using NUnit.Framework;
+using osu.Game.Database;
+using osu.Game.Models;
+using Realms;
 
 #nullable enable
 
@@ -33,6 +36,37 @@ namespace osu.Game.Tests.Database
             });
         }
 
+        [Test]
+        public void TestNestedContextCreation()
+        {
+            RunTestWithRealm((realmFactory, _) =>
+            {
+                var mainContext = realmFactory.Context;
+                bool callbackRan = false;
+
+                var subscription = mainContext.All<RealmBeatmap>().SubscribeForNotifications((sender, changes, error) =>
+                {
+                    realmFactory.CreateContext();
+                    callbackRan = true;
+                });
+
+                Task.Factory.StartNew(() =>
+                {
+                    using (var threadContext = realmFactory.CreateContext())
+                    {
+                        threadContext.Write(r => r.Add(new RealmBeatmap(CreateRuleset(), new RealmBeatmapDifficulty(), new RealmBeatmapMetadata())));
+                    }
+                }, TaskCreationOptions.LongRunning | TaskCreationOptions.HideScheduler).Wait();
+
+                // will create a context but also run the callback above (Refresh is implicitly run when getting a new context).
+                realmFactory.CreateContext();
+
+                Assert.IsTrue(callbackRan);
+
+                subscription.Dispose();
+            });
+        }
+
         [Test]
         public void TestBlockOperationsWithContention()
         {

From c98451a7bf2a75af6dab4ed82818c80f72c994c8 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 29 Nov 2021 16:18:57 +0900
Subject: [PATCH 1340/5547] Fix potential deadlock on nested context creation
 requests

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

diff --git a/osu.Game/Database/RealmContextFactory.cs b/osu.Game/Database/RealmContextFactory.cs
index 2bc77934a8..08d7580db7 100644
--- a/osu.Game/Database/RealmContextFactory.cs
+++ b/osu.Game/Database/RealmContextFactory.cs
@@ -52,6 +52,8 @@ namespace osu.Game.Database
         /// </summary>
         private readonly SemaphoreSlim contextCreationLock = new SemaphoreSlim(1);
 
+        private bool canCreateContexts;
+
         private static readonly GlobalStatistic<int> refreshes = GlobalStatistics.Get<int>(@"Realm", @"Dirty Refreshes");
         private static readonly GlobalStatistic<int> contexts_created = GlobalStatistics.Get<int>(@"Realm", @"Contexts (Created)");
 
@@ -153,7 +155,13 @@ namespace osu.Game.Database
 
             try
             {
-                contextCreationLock.Wait();
+                if (!canCreateContexts)
+                    contextCreationLock.Wait();
+
+                // the semaphore is used to stop all context creation.
+                // once the semaphore has been taken by this code section, it is safe to create further contexts.
+                // this can happen if a realm subscription is active and triggers a callback which has user code that calls `CreateContext`.
+                canCreateContexts = true;
 
                 contexts_created.Value++;
 
@@ -162,6 +170,7 @@ namespace osu.Game.Database
             finally
             {
                 contextCreationLock.Release();
+                canCreateContexts = false;
             }
         }
 

From 071a8c670942c04a2566e493f278acc4778352b1 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 29 Nov 2021 17:34:56 +0900
Subject: [PATCH 1341/5547] Add test coverage showing `RealmLive` failure after
 an attach

---
 osu.Game.Tests/Database/RealmLiveTests.cs | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/osu.Game.Tests/Database/RealmLiveTests.cs b/osu.Game.Tests/Database/RealmLiveTests.cs
index f86761fdc8..a4b82fb8b1 100644
--- a/osu.Game.Tests/Database/RealmLiveTests.cs
+++ b/osu.Game.Tests/Database/RealmLiveTests.cs
@@ -29,6 +29,22 @@ namespace osu.Game.Tests.Database
             });
         }
 
+        [Test]
+        public void TestAccessAfterAttach()
+        {
+            RunTestWithRealm((realmFactory, _) =>
+            {
+                var beatmap = new RealmBeatmap(CreateRuleset(), new RealmBeatmapDifficulty(), new RealmBeatmapMetadata());
+
+                var liveBeatmap = beatmap.ToLive();
+
+                using (var context = realmFactory.CreateContext())
+                    context.Write(r => r.Add(beatmap));
+
+                Assert.IsFalse(liveBeatmap.PerformRead(l => l.Hidden));
+            });
+        }
+
         [Test]
         public void TestAccessNonManaged()
         {

From 6dcc244e2185ae77622c261b1a4c19c3cc901c8c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 29 Nov 2021 17:21:51 +0900
Subject: [PATCH 1342/5547] Fix `RealmLive` not working is data is attached to
 realm post-`ToLive` call

---
 osu.Game/Database/RealmLive.cs | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/osu.Game/Database/RealmLive.cs b/osu.Game/Database/RealmLive.cs
index 73e6715aaa..5ee40f5b4d 100644
--- a/osu.Game/Database/RealmLive.cs
+++ b/osu.Game/Database/RealmLive.cs
@@ -17,7 +17,7 @@ namespace osu.Game.Database
     {
         public Guid ID { get; }
 
-        public bool IsManaged { get; }
+        public bool IsManaged => data.IsManaged;
 
         private readonly SynchronizationContext? fetchedContext;
         private readonly int fetchedThreadId;
@@ -37,8 +37,6 @@ namespace osu.Game.Database
 
             if (data.IsManaged)
             {
-                IsManaged = true;
-
                 fetchedContext = SynchronizationContext.Current;
                 fetchedThreadId = Thread.CurrentThread.ManagedThreadId;
             }

From 673481ebc5eaece0e99f0bc61124655fd3944d4c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 29 Nov 2021 17:38:42 +0900
Subject: [PATCH 1343/5547] Use `ThreadLocal` to avoid potential threading
 issues

---
 osu.Game/Database/RealmContextFactory.cs | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Database/RealmContextFactory.cs b/osu.Game/Database/RealmContextFactory.cs
index 08d7580db7..9e66248d78 100644
--- a/osu.Game/Database/RealmContextFactory.cs
+++ b/osu.Game/Database/RealmContextFactory.cs
@@ -52,7 +52,7 @@ namespace osu.Game.Database
         /// </summary>
         private readonly SemaphoreSlim contextCreationLock = new SemaphoreSlim(1);
 
-        private bool canCreateContexts;
+        private ThreadLocal<bool> currentThreadCanCreateContexts = new ThreadLocal<bool>();
 
         private static readonly GlobalStatistic<int> refreshes = GlobalStatistics.Get<int>(@"Realm", @"Dirty Refreshes");
         private static readonly GlobalStatistic<int> contexts_created = GlobalStatistics.Get<int>(@"Realm", @"Contexts (Created)");
@@ -155,13 +155,13 @@ namespace osu.Game.Database
 
             try
             {
-                if (!canCreateContexts)
+                if (!currentThreadCanCreateContexts.Value)
                     contextCreationLock.Wait();
 
                 // the semaphore is used to stop all context creation.
                 // once the semaphore has been taken by this code section, it is safe to create further contexts.
                 // this can happen if a realm subscription is active and triggers a callback which has user code that calls `CreateContext`.
-                canCreateContexts = true;
+                currentThreadCanCreateContexts.Value = true;
 
                 contexts_created.Value++;
 
@@ -170,7 +170,7 @@ namespace osu.Game.Database
             finally
             {
                 contextCreationLock.Release();
-                canCreateContexts = false;
+                currentThreadCanCreateContexts.Value = false;
             }
         }
 

From f19cfcc82e8decff5d63c1d4e098cfcb746e7b03 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 29 Nov 2021 17:38:54 +0900
Subject: [PATCH 1344/5547] Make `readonly`

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

diff --git a/osu.Game/Database/RealmContextFactory.cs b/osu.Game/Database/RealmContextFactory.cs
index 9e66248d78..b1e97a45d0 100644
--- a/osu.Game/Database/RealmContextFactory.cs
+++ b/osu.Game/Database/RealmContextFactory.cs
@@ -52,7 +52,7 @@ namespace osu.Game.Database
         /// </summary>
         private readonly SemaphoreSlim contextCreationLock = new SemaphoreSlim(1);
 
-        private ThreadLocal<bool> currentThreadCanCreateContexts = new ThreadLocal<bool>();
+        private readonly ThreadLocal<bool> currentThreadCanCreateContexts = new ThreadLocal<bool>();
 
         private static readonly GlobalStatistic<int> refreshes = GlobalStatistics.Get<int>(@"Realm", @"Dirty Refreshes");
         private static readonly GlobalStatistic<int> contexts_created = GlobalStatistics.Get<int>(@"Realm", @"Contexts (Created)");

From a7e4e7be3adad487acf9e190ea0a6291396ca4e7 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 29 Nov 2021 18:08:02 +0900
Subject: [PATCH 1345/5547] Remove the ability to specify a filename in
 `ReplaceFile`

---
 osu.Game/Beatmaps/BeatmapManager.cs             |  4 ++--
 osu.Game/Database/ArchiveModelManager.cs        |  5 ++---
 osu.Game/Database/IModelFileManager.cs          |  3 +--
 osu.Game/Screens/Edit/Setup/ResourcesSection.cs | 11 +++++------
 4 files changed, 10 insertions(+), 13 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index d920b194b5..8502b91096 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -288,9 +288,9 @@ namespace osu.Game.Beatmaps
 
         #region Implementation of IModelFileManager<in BeatmapSetInfo,in BeatmapSetFileInfo>
 
-        public void ReplaceFile(BeatmapSetInfo model, BeatmapSetFileInfo file, Stream contents, string filename = null)
+        public void ReplaceFile(BeatmapSetInfo model, BeatmapSetFileInfo file, Stream contents)
         {
-            beatmapModelManager.ReplaceFile(model, file, contents, filename);
+            beatmapModelManager.ReplaceFile(model, file, contents);
         }
 
         public void DeleteFile(BeatmapSetInfo model, BeatmapSetFileInfo file)
diff --git a/osu.Game/Database/ArchiveModelManager.cs b/osu.Game/Database/ArchiveModelManager.cs
index e73f4a7f6e..8cabb55cc3 100644
--- a/osu.Game/Database/ArchiveModelManager.cs
+++ b/osu.Game/Database/ArchiveModelManager.cs
@@ -453,13 +453,12 @@ namespace osu.Game.Database
         /// <param name="model">The item to operate on.</param>
         /// <param name="file">The existing file to be replaced.</param>
         /// <param name="contents">The new file contents.</param>
-        /// <param name="filename">An optional filename for the new file. Will use the previous filename if not specified.</param>
-        public void ReplaceFile(TModel model, TFileModel file, Stream contents, string filename = null)
+        public void ReplaceFile(TModel model, TFileModel file, Stream contents)
         {
             using (ContextFactory.GetForWrite())
             {
                 DeleteFile(model, file);
-                AddFile(model, contents, filename ?? file.Filename);
+                AddFile(model, contents, file.Filename);
             }
         }
 
diff --git a/osu.Game/Database/IModelFileManager.cs b/osu.Game/Database/IModelFileManager.cs
index c74b945eb7..4bc1e2d29b 100644
--- a/osu.Game/Database/IModelFileManager.cs
+++ b/osu.Game/Database/IModelFileManager.cs
@@ -15,8 +15,7 @@ namespace osu.Game.Database
         /// <param name="model">The item to operate on.</param>
         /// <param name="file">The existing file to be replaced.</param>
         /// <param name="contents">The new file contents.</param>
-        /// <param name="filename">An optional filename for the new file. Will use the previous filename if not specified.</param>
-        void ReplaceFile(TModel model, TFileModel file, Stream contents, string filename = null);
+        void ReplaceFile(TModel model, TFileModel file, Stream contents);
 
         /// <summary>
         /// Delete an existing file.
diff --git a/osu.Game/Screens/Edit/Setup/ResourcesSection.cs b/osu.Game/Screens/Edit/Setup/ResourcesSection.cs
index 8e739a786f..1e97218074 100644
--- a/osu.Game/Screens/Edit/Setup/ResourcesSection.cs
+++ b/osu.Game/Screens/Edit/Setup/ResourcesSection.cs
@@ -78,9 +78,9 @@ namespace osu.Game.Screens.Edit.Setup
             using (var stream = info.OpenRead())
             {
                 if (oldFile != null)
-                    beatmaps.ReplaceFile(set, oldFile, stream, info.Name);
-                else
-                    beatmaps.AddFile(set, stream, info.Name);
+                    beatmaps.DeleteFile(set, oldFile);
+
+                beatmaps.AddFile(set, stream, info.Name);
             }
 
             working.Value.Metadata.BackgroundFile = info.Name;
@@ -105,9 +105,8 @@ namespace osu.Game.Screens.Edit.Setup
             using (var stream = info.OpenRead())
             {
                 if (oldFile != null)
-                    beatmaps.ReplaceFile(set, oldFile, stream, info.Name);
-                else
-                    beatmaps.AddFile(set, stream, info.Name);
+                    beatmaps.DeleteFile(set, oldFile);
+                beatmaps.AddFile(set, stream, info.Name);
             }
 
             working.Value.Metadata.AudioFile = info.Name;

From 6aad90674eeccdc505cc8b431ac0b39a27b5ab55 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 29 Nov 2021 18:06:21 +0900
Subject: [PATCH 1346/5547] Remove `computeHashFast` usage in
 `RealmArchiveModelImporter.ComputeHash`

---
 osu.Game/Stores/RealmArchiveModelImporter.cs | 8 ++------
 1 file changed, 2 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Stores/RealmArchiveModelImporter.cs b/osu.Game/Stores/RealmArchiveModelImporter.cs
index 56469184a9..1681dad750 100644
--- a/osu.Game/Stores/RealmArchiveModelImporter.cs
+++ b/osu.Game/Stores/RealmArchiveModelImporter.cs
@@ -294,12 +294,8 @@ namespace osu.Game.Stores
         /// <remarks>
         ///  In the case of no matching files, a hash will be generated from the passed archive's <see cref="ArchiveReader.Name"/>.
         /// </remarks>
-        protected virtual string ComputeHash(TModel item, ArchiveReader? reader = null)
+        protected virtual string ComputeHash(TModel item)
         {
-            if (reader != null)
-                // fast hashing for cases where the item's files may not be populated.
-                return computeHashFast(reader);
-
             // for now, concatenate all hashable files in the set to create a unique hash.
             MemoryStream hashable = new MemoryStream();
 
@@ -374,7 +370,7 @@ namespace osu.Game.Stores
                             // TODO: look into rollback of file additions (or delayed commit).
                             item.Files.AddRange(createFileInfos(archive, Files, realm));
 
-                        item.Hash = ComputeHash(item, archive);
+                        item.Hash = ComputeHash(item);
 
                         // TODO: we may want to run this outside of the transaction.
                         await Populate(item, archive, realm, cancellationToken).ConfigureAwait(false);

From bac79663371dfdd4efa40c5f73192ce38efa782a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 29 Nov 2021 18:00:28 +0900
Subject: [PATCH 1347/5547] Update `RealmLiveTests` to use interface type

---
 osu.Game.Tests/Database/RealmLiveTests.cs | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/osu.Game.Tests/Database/RealmLiveTests.cs b/osu.Game.Tests/Database/RealmLiveTests.cs
index f86761fdc8..d6eca80274 100644
--- a/osu.Game.Tests/Database/RealmLiveTests.cs
+++ b/osu.Game.Tests/Database/RealmLiveTests.cs
@@ -51,7 +51,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealm((realmFactory, _) =>
             {
-                RealmLive<RealmBeatmap>? liveBeatmap = null;
+                ILive<RealmBeatmap>? liveBeatmap = null;
                 Task.Factory.StartNew(() =>
                 {
                     using (var threadContext = realmFactory.CreateContext())
@@ -88,7 +88,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealm((realmFactory, _) =>
             {
-                RealmLive<RealmBeatmap>? liveBeatmap = null;
+                ILive<RealmBeatmap>? liveBeatmap = null;
                 Task.Factory.StartNew(() =>
                 {
                     using (var threadContext = realmFactory.CreateContext())
@@ -117,7 +117,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealm((realmFactory, _) =>
             {
-                RealmLive<RealmBeatmap>? liveBeatmap = null;
+                ILive<RealmBeatmap>? liveBeatmap = null;
                 Task.Factory.StartNew(() =>
                 {
                     using (var threadContext = realmFactory.CreateContext())
@@ -143,7 +143,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealm((realmFactory, _) =>
             {
-                RealmLive<RealmBeatmap>? liveBeatmap = null;
+                ILive<RealmBeatmap>? liveBeatmap = null;
                 Task.Factory.StartNew(() =>
                 {
                     using (var threadContext = realmFactory.CreateContext())
@@ -176,7 +176,7 @@ namespace osu.Game.Tests.Database
                 using (var updateThreadContext = realmFactory.CreateContext())
                 {
                     updateThreadContext.All<RealmBeatmap>().SubscribeForNotifications(gotChange);
-                    RealmLive<RealmBeatmap>? liveBeatmap = null;
+                    ILive<RealmBeatmap>? liveBeatmap = null;
 
                     Task.Factory.StartNew(() =>
                     {

From 94b10492be658d028bec1fc8768400c303357f51 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 29 Nov 2021 18:20:07 +0900
Subject: [PATCH 1348/5547] Update legacy `SkinManager` to match new interface

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

diff --git a/osu.Game/Skinning/SkinManager.cs b/osu.Game/Skinning/SkinManager.cs
index 8d07dd046a..26ff4457af 100644
--- a/osu.Game/Skinning/SkinManager.cs
+++ b/osu.Game/Skinning/SkinManager.cs
@@ -171,7 +171,7 @@ namespace osu.Game.Skinning
                     var oldFile = skin.SkinInfo.Files.FirstOrDefault(f => f.Filename == filename);
 
                     if (oldFile != null)
-                        skinModelManager.ReplaceFile(skin.SkinInfo, oldFile, streamContent, oldFile.Filename);
+                        skinModelManager.ReplaceFile(skin.SkinInfo, oldFile, streamContent);
                     else
                         skinModelManager.AddFile(skin.SkinInfo, streamContent, filename);
                 }

From 23fded4a3ac22be9eb0f92a38dc173402feed386 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 29 Nov 2021 18:26:37 +0900
Subject: [PATCH 1349/5547] Fix potential oversight in semaphore release logic

---
 osu.Game/Database/RealmContextFactory.cs | 24 +++++++++++++++++-------
 1 file changed, 17 insertions(+), 7 deletions(-)

diff --git a/osu.Game/Database/RealmContextFactory.cs b/osu.Game/Database/RealmContextFactory.cs
index b1e97a45d0..6948918fe7 100644
--- a/osu.Game/Database/RealmContextFactory.cs
+++ b/osu.Game/Database/RealmContextFactory.cs
@@ -153,15 +153,22 @@ namespace osu.Game.Database
             if (isDisposed)
                 throw new ObjectDisposedException(nameof(RealmContextFactory));
 
+            bool tookSemaphoreLock = false;
+
             try
             {
                 if (!currentThreadCanCreateContexts.Value)
+                {
                     contextCreationLock.Wait();
-
-                // the semaphore is used to stop all context creation.
-                // once the semaphore has been taken by this code section, it is safe to create further contexts.
-                // this can happen if a realm subscription is active and triggers a callback which has user code that calls `CreateContext`.
-                currentThreadCanCreateContexts.Value = true;
+                    tookSemaphoreLock = true;
+                }
+                else
+                {
+                    // the semaphore is used to handle blocking of all context creation during certain periods.
+                    // once the semaphore has been taken by this code section, it is safe to create further contexts on the same thread.
+                    // this can happen if a realm subscription is active and triggers a callback which has user code that calls `CreateContext`.
+                    currentThreadCanCreateContexts.Value = true;
+                }
 
                 contexts_created.Value++;
 
@@ -169,8 +176,11 @@ namespace osu.Game.Database
             }
             finally
             {
-                contextCreationLock.Release();
-                currentThreadCanCreateContexts.Value = false;
+                if (tookSemaphoreLock)
+                {
+                    contextCreationLock.Release();
+                    currentThreadCanCreateContexts.Value = false;
+                }
             }
         }
 

From 1dd5e1ca89d78190cea96f56d0d05ee691ac7908 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 26 Nov 2021 14:43:35 +0900
Subject: [PATCH 1350/5547] Remove `RealmLive` context re-fetch optimisation
 for now

---
 osu.Game/Database/RealmLive.cs | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Database/RealmLive.cs b/osu.Game/Database/RealmLive.cs
index 5ee40f5b4d..45b598ed92 100644
--- a/osu.Game/Database/RealmLive.cs
+++ b/osu.Game/Database/RealmLive.cs
@@ -112,7 +112,10 @@ namespace osu.Game.Database
             }
         }
 
-        private bool originalDataValid => !IsManaged || (isCorrectThread && data.IsValid);
+        // TODO: Revisit adding these conditionals back as an optimisation: || (isCorrectThread && data.IsValid);
+        // They have temporarily been removed due to an oversight involving .AsQueryable, see https://github.com/realm/realm-dotnet/discussions/2734.
+        // This means we are fetching a new context every `PerformRead` or `PerformWrite`, even when on the correct thread.
+        private bool originalDataValid => !IsManaged;
 
         // this matches realm's internal thread validation (see https://github.com/realm/realm-dotnet/blob/903b4d0b304f887e37e2d905384fb572a6496e70/Realm/Realm/Native/SynchronizationContextScheduler.cs#L72)
         private bool isCorrectThread

From 348d1d0be910ccacf482360150c6b77634af560b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 26 Nov 2021 21:33:11 +0900
Subject: [PATCH 1351/5547] Don't dispose fetched realm instance when using
 `RealmLive.Value`

See https://github.com/realm/realm-dotnet/discussions/2734#discussioncomment-1705038 for reasoning.
---
 osu.Game/Database/RealmLive.cs | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Database/RealmLive.cs b/osu.Game/Database/RealmLive.cs
index 45b598ed92..6d5410d1cd 100644
--- a/osu.Game/Database/RealmLive.cs
+++ b/osu.Game/Database/RealmLive.cs
@@ -100,10 +100,11 @@ namespace osu.Game.Database
                 if (originalDataValid)
                     return data;
 
-                T retrieved;
+                if (!isCorrectThread)
+                    throw new InvalidOperationException($"Can't use {nameof(Value)} unless on the same thread the original data was fetched from.");
 
-                using (var realm = Realm.GetInstance(data.Realm.Config))
-                    retrieved = realm.Find<T>(ID);
+                var realm = Realm.GetInstance(data.Realm.Config);
+                var retrieved = realm.Find<T>(ID);
 
                 if (!retrieved.IsValid)
                     throw new InvalidOperationException("Attempted to access value without an open context");

From 4c2b0dd2d1168df00120016d02af29861eb9052a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 29 Nov 2021 15:14:27 +0900
Subject: [PATCH 1352/5547] Update `RealmLive` tests in line with modified
 behaviour

---
 osu.Game.Tests/Database/RealmLiveTests.cs | 68 ++++++++++++++---------
 1 file changed, 42 insertions(+), 26 deletions(-)

diff --git a/osu.Game.Tests/Database/RealmLiveTests.cs b/osu.Game.Tests/Database/RealmLiveTests.cs
index 16e2c0fc6a..baedf44c1a 100644
--- a/osu.Game.Tests/Database/RealmLiveTests.cs
+++ b/osu.Game.Tests/Database/RealmLiveTests.cs
@@ -82,19 +82,29 @@ namespace osu.Game.Tests.Database
 
                 Task.Factory.StartNew(() =>
                 {
-                    Assert.DoesNotThrow(() =>
+                    // TODO: The commented code is the behaviour we hope to obtain, but is temporarily disabled.
+                    // See https://github.com/ppy/osu/pull/15851
+                    using (realmFactory.CreateContext())
                     {
-                        using (realmFactory.CreateContext())
+                        Assert.Throws<InvalidOperationException>(() =>
                         {
-                            var resolved = liveBeatmap.Value;
+                            var __ = liveBeatmap.Value;
+                        });
+                    }
 
-                            Assert.IsTrue(resolved.Realm.IsClosed);
-                            Assert.IsTrue(resolved.IsValid);
-
-                            // can access properties without a crash.
-                            Assert.IsFalse(resolved.Hidden);
-                        }
-                    });
+                    // Assert.DoesNotThrow(() =>
+                    // {
+                    //     using (realmFactory.CreateContext())
+                    //     {
+                    //         var resolved = liveBeatmap.Value;
+                    //
+                    //         Assert.IsTrue(resolved.Realm.IsClosed);
+                    //         Assert.IsTrue(resolved.IsValid);
+                    //
+                    //         // can access properties without a crash.
+                    //         Assert.IsFalse(resolved.Hidden);
+                    //     }
+                    // });
                 }, TaskCreationOptions.LongRunning | TaskCreationOptions.HideScheduler).Wait();
             });
         }
@@ -215,23 +225,29 @@ namespace osu.Game.Tests.Database
                     Assert.AreEqual(0, updateThreadContext.All<RealmBeatmap>().Count());
                     Assert.AreEqual(0, changesTriggered);
 
-                    var resolved = liveBeatmap.Value;
-
-                    // retrieval causes an implicit refresh. even changes that aren't related to the retrieval are fired at this point.
-                    Assert.AreEqual(2, updateThreadContext.All<RealmBeatmap>().Count());
-                    Assert.AreEqual(1, changesTriggered);
-
-                    // even though the realm that this instance was resolved for was closed, it's still valid.
-                    Assert.IsTrue(resolved.Realm.IsClosed);
-                    Assert.IsTrue(resolved.IsValid);
-
-                    // can access properties without a crash.
-                    Assert.IsFalse(resolved.Hidden);
-
-                    updateThreadContext.Write(r =>
+                    // TODO: Originally the following was using `liveBeatmap.Value`. This has been temporarily disabled.
+                    // See https://github.com/ppy/osu/pull/15851
+                    liveBeatmap.PerformRead(resolved =>
                     {
-                        // can use with the main context.
-                        r.Remove(resolved);
+                        // retrieval causes an implicit refresh. even changes that aren't related to the retrieval are fired at this point.
+                        // ReSharper disable once AccessToDisposedClosure
+                        Assert.AreEqual(2, updateThreadContext.All<RealmBeatmap>().Count());
+                        Assert.AreEqual(1, changesTriggered);
+
+                        // TODO: as above, temporarily disabled as it doesn't make sense inside a `PerformRead`.
+                        // // even though the realm that this instance was resolved for was closed, it's still valid.
+                        // Assert.IsTrue(resolved.Realm.IsClosed);
+                        // Assert.IsTrue(resolved.IsValid);
+
+                        // can access properties without a crash.
+                        Assert.IsFalse(resolved.Hidden);
+
+                        // ReSharper disable once AccessToDisposedClosure
+                        updateThreadContext.Write(r =>
+                        {
+                            // can use with the main context.
+                            r.Remove(resolved);
+                        });
                     });
                 }
 

From 0a961fd9d8d2da027f88904e575ec952d5535b7e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 23 Nov 2021 13:24:43 +0900
Subject: [PATCH 1353/5547] Replace usages of `IHasFiles` with `IHasRealmFiles`

---
 osu.Game/Skinning/DefaultLegacySkin.cs       | 2 +-
 osu.Game/Skinning/LegacyBeatmapSkin.cs       | 2 +-
 osu.Game/Skinning/LegacySkin.cs              | 2 +-
 osu.Game/Skinning/LegacySkinResourceStore.cs | 9 ++++-----
 4 files changed, 7 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Skinning/DefaultLegacySkin.cs b/osu.Game/Skinning/DefaultLegacySkin.cs
index cd6dbd9ddd..95e9a19c99 100644
--- a/osu.Game/Skinning/DefaultLegacySkin.cs
+++ b/osu.Game/Skinning/DefaultLegacySkin.cs
@@ -25,7 +25,7 @@ namespace osu.Game.Skinning
                 resources,
                 // A default legacy skin may still have a skin.ini if it is modified by the user.
                 // We must specify the stream directly as we are redirecting storage to the osu-resources location for other files.
-                new LegacySkinResourceStore<SkinFileInfo>(skin, resources.Files).GetStream("skin.ini")
+                new LegacySkinResourceStore(skin, resources.Files).GetStream("skin.ini")
             )
         {
             Configuration.CustomColours["SliderBall"] = new Color4(2, 170, 255, 255);
diff --git a/osu.Game/Skinning/LegacyBeatmapSkin.cs b/osu.Game/Skinning/LegacyBeatmapSkin.cs
index 8abef6800d..0599334b46 100644
--- a/osu.Game/Skinning/LegacyBeatmapSkin.cs
+++ b/osu.Game/Skinning/LegacyBeatmapSkin.cs
@@ -21,7 +21,7 @@ namespace osu.Game.Skinning
         protected override bool UseCustomSampleBanks => true;
 
         public LegacyBeatmapSkin(BeatmapInfo beatmapInfo, IResourceStore<byte[]> storage, IStorageResourceProvider resources)
-            : base(createSkinInfo(beatmapInfo), new LegacySkinResourceStore<BeatmapSetFileInfo>(beatmapInfo.BeatmapSet, storage), resources, beatmapInfo.Path)
+            : base(createSkinInfo(beatmapInfo), new LegacySkinResourceStore(beatmapInfo.BeatmapSet, storage), resources, beatmapInfo.Path)
         {
             // Disallow default colours fallback on beatmap skins to allow using parent skin combo colours. (via SkinProvidingContainer)
             Configuration.AllowDefaultComboColoursFallback = false;
diff --git a/osu.Game/Skinning/LegacySkin.cs b/osu.Game/Skinning/LegacySkin.cs
index 0e7ae95169..64f920de85 100644
--- a/osu.Game/Skinning/LegacySkin.cs
+++ b/osu.Game/Skinning/LegacySkin.cs
@@ -51,7 +51,7 @@ namespace osu.Game.Skinning
 
         [UsedImplicitly(ImplicitUseKindFlags.InstantiatedWithFixedConstructorSignature)]
         public LegacySkin(SkinInfo skin, IStorageResourceProvider resources)
-            : this(skin, new LegacySkinResourceStore<SkinFileInfo>(skin, resources.Files), resources, "skin.ini")
+            : this(skin, new LegacySkinResourceStore(skin, resources.Files), resources, "skin.ini")
         {
         }
 
diff --git a/osu.Game/Skinning/LegacySkinResourceStore.cs b/osu.Game/Skinning/LegacySkinResourceStore.cs
index c4418baeff..71efc949b8 100644
--- a/osu.Game/Skinning/LegacySkinResourceStore.cs
+++ b/osu.Game/Skinning/LegacySkinResourceStore.cs
@@ -11,12 +11,11 @@ using osu.Game.Extensions;
 
 namespace osu.Game.Skinning
 {
-    public class LegacySkinResourceStore<T> : ResourceStore<byte[]>
-        where T : INamedFileInfo
+    public class LegacySkinResourceStore : ResourceStore<byte[]>
     {
-        private readonly IHasFiles<T> source;
+        private readonly IHasRealmFiles source;
 
-        public LegacySkinResourceStore(IHasFiles<T> source, IResourceStore<byte[]> underlyingStore)
+        public LegacySkinResourceStore(IHasRealmFiles source, IResourceStore<byte[]> underlyingStore)
             : base(underlyingStore)
         {
             this.source = source;
@@ -33,7 +32,7 @@ namespace osu.Game.Skinning
         }
 
         private string getPathForFile(string filename) =>
-            source.Files.Find(f => string.Equals(f.Filename, filename, StringComparison.OrdinalIgnoreCase))?.FileInfo.GetStoragePath();
+            source.Files.FirstOrDefault(f => string.Equals(f.Filename, filename, StringComparison.OrdinalIgnoreCase))?.FileInfo.GetStoragePath();
 
         public override IEnumerable<string> GetAvailableResources() => source.Files.Select(f => f.Filename);
     }

From 5f067172b41e243aa79d8d25bac024b551212ce6 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 23 Nov 2021 14:54:57 +0900
Subject: [PATCH 1354/5547] Add model class for realm skin

---
 osu.Game/Models/RealmSkin.cs | 67 ++++++++++++++++++++++++++++++++++++
 1 file changed, 67 insertions(+)
 create mode 100644 osu.Game/Models/RealmSkin.cs

diff --git a/osu.Game/Models/RealmSkin.cs b/osu.Game/Models/RealmSkin.cs
new file mode 100644
index 0000000000..2ae1328974
--- /dev/null
+++ b/osu.Game/Models/RealmSkin.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 System;
+using System.Collections.Generic;
+using osu.Framework.Extensions.ObjectExtensions;
+using osu.Framework.Testing;
+using osu.Game.Database;
+using osu.Game.Extensions;
+using osu.Game.IO;
+using osu.Game.Skinning;
+using Realms;
+
+#nullable enable
+
+namespace osu.Game.Models
+{
+    [ExcludeFromDynamicCompile]
+    [MapTo("Skin")]
+    public class RealmSkin : RealmObject, IHasRealmFiles, IEquatable<RealmSkin>, IHasGuidPrimaryKey, ISoftDelete
+    {
+        public Guid ID { get; set; }
+
+        public string Name { get; set; } = string.Empty;
+
+        public string Creator { get; set; } = string.Empty;
+
+        public string Hash { get; set; } = string.Empty;
+
+        public string InstantiationInfo { get; set; } = string.Empty;
+
+        public virtual Skin CreateInstance(IStorageResourceProvider resources)
+        {
+            var type = string.IsNullOrEmpty(InstantiationInfo)
+                // handle the case of skins imported before InstantiationInfo was added.
+                ? typeof(LegacySkin)
+                : Type.GetType(InstantiationInfo).AsNonNull();
+
+            return (Skin)Activator.CreateInstance(type, this, resources);
+        }
+
+        public IList<RealmNamedFileUsage> Files { get; } = null!;
+
+        public bool DeletePending { get; set; }
+
+        public static RealmSkin Default { get; } = new RealmSkin
+        {
+            Name = "osu! (triangles)",
+            Creator = "team osu!",
+            InstantiationInfo = typeof(DefaultSkin).GetInvariantInstantiationInfo()
+        };
+
+        public bool Equals(RealmSkin? other)
+        {
+            if (ReferenceEquals(this, other)) return true;
+            if (other == null) return false;
+
+            return ID == other.ID;
+        }
+
+        public override string ToString()
+        {
+            string author = string.IsNullOrEmpty(Creator) ? string.Empty : $"({Creator})";
+            return $"{Name} {author}".Trim();
+        }
+    }
+}

From e283379f0ebaa703bf613a9108604a98c162bd91 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 23 Nov 2021 15:31:07 +0900
Subject: [PATCH 1355/5547] Replace EF `SkinInfo` with realm implementation

---
 osu.Game/Database/OsuDbContext.cs             |  6 +--
 .../RealmSkin.cs => Skinning/EFSkinInfo.cs}   | 40 ++++++++-----------
 osu.Game/Skinning/SkinInfo.cs                 | 37 +++++++++++------
 osu.Game/Skinning/SkinStore.cs                |  2 +-
 4 files changed, 46 insertions(+), 39 deletions(-)
 rename osu.Game/{Models/RealmSkin.cs => Skinning/EFSkinInfo.cs} (54%)

diff --git a/osu.Game/Database/OsuDbContext.cs b/osu.Game/Database/OsuDbContext.cs
index d8d2cb8981..26f287da26 100644
--- a/osu.Game/Database/OsuDbContext.cs
+++ b/osu.Game/Database/OsuDbContext.cs
@@ -25,7 +25,7 @@ namespace osu.Game.Database
         public DbSet<BeatmapSetInfo> BeatmapSetInfo { get; set; }
         public DbSet<FileInfo> FileInfo { get; set; }
         public DbSet<RulesetInfo> RulesetInfo { get; set; }
-        public DbSet<SkinInfo> SkinInfo { get; set; }
+        public DbSet<EFSkinInfo> SkinInfo { get; set; }
         public DbSet<ScoreInfo> ScoreInfo { get; set; }
 
         // migrated to realm
@@ -133,8 +133,8 @@ namespace osu.Game.Database
             modelBuilder.Entity<BeatmapSetInfo>().HasIndex(b => b.DeletePending);
             modelBuilder.Entity<BeatmapSetInfo>().HasIndex(b => b.Hash).IsUnique();
 
-            modelBuilder.Entity<SkinInfo>().HasIndex(b => b.Hash).IsUnique();
-            modelBuilder.Entity<SkinInfo>().HasIndex(b => b.DeletePending);
+            modelBuilder.Entity<EFSkinInfo>().HasIndex(b => b.Hash).IsUnique();
+            modelBuilder.Entity<EFSkinInfo>().HasIndex(b => b.DeletePending);
 
             modelBuilder.Entity<DatabasedSetting>().HasIndex(b => new { b.RulesetID, b.Variant });
 
diff --git a/osu.Game/Models/RealmSkin.cs b/osu.Game/Skinning/EFSkinInfo.cs
similarity index 54%
rename from osu.Game/Models/RealmSkin.cs
rename to osu.Game/Skinning/EFSkinInfo.cs
index 2ae1328974..8bd734d4ff 100644
--- a/osu.Game/Models/RealmSkin.cs
+++ b/osu.Game/Skinning/EFSkinInfo.cs
@@ -1,33 +1,32 @@
-// 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;
 using System.Collections.Generic;
+using System.ComponentModel.DataAnnotations.Schema;
 using osu.Framework.Extensions.ObjectExtensions;
-using osu.Framework.Testing;
 using osu.Game.Database;
 using osu.Game.Extensions;
 using osu.Game.IO;
-using osu.Game.Skinning;
-using Realms;
 
-#nullable enable
-
-namespace osu.Game.Models
+namespace osu.Game.Skinning
 {
-    [ExcludeFromDynamicCompile]
-    [MapTo("Skin")]
-    public class RealmSkin : RealmObject, IHasRealmFiles, IEquatable<RealmSkin>, IHasGuidPrimaryKey, ISoftDelete
+    [Table(@"SkinInfo")]
+    public class EFSkinInfo : IHasFiles<SkinFileInfo>, IEquatable<EFSkinInfo>, IHasPrimaryKey, ISoftDelete
     {
-        public Guid ID { get; set; }
+        internal const int DEFAULT_SKIN = 0;
+        internal const int CLASSIC_SKIN = -1;
+        internal const int RANDOM_SKIN = -2;
+
+        public int ID { get; set; }
 
         public string Name { get; set; } = string.Empty;
 
         public string Creator { get; set; } = string.Empty;
 
-        public string Hash { get; set; } = string.Empty;
+        public string Hash { get; set; }
 
-        public string InstantiationInfo { get; set; } = string.Empty;
+        public string InstantiationInfo { get; set; }
 
         public virtual Skin CreateInstance(IStorageResourceProvider resources)
         {
@@ -39,28 +38,23 @@ namespace osu.Game.Models
             return (Skin)Activator.CreateInstance(type, this, resources);
         }
 
-        public IList<RealmNamedFileUsage> Files { get; } = null!;
+        public List<SkinFileInfo> Files { get; set; } = new List<SkinFileInfo>();
 
         public bool DeletePending { get; set; }
 
-        public static RealmSkin Default { get; } = new RealmSkin
+        public static EFSkinInfo Default { get; } = new EFSkinInfo
         {
+            ID = DEFAULT_SKIN,
             Name = "osu! (triangles)",
             Creator = "team osu!",
             InstantiationInfo = typeof(DefaultSkin).GetInvariantInstantiationInfo()
         };
 
-        public bool Equals(RealmSkin? other)
-        {
-            if (ReferenceEquals(this, other)) return true;
-            if (other == null) return false;
-
-            return ID == other.ID;
-        }
+        public bool Equals(EFSkinInfo other) => other != null && ID == other.ID;
 
         public override string ToString()
         {
-            string author = string.IsNullOrEmpty(Creator) ? string.Empty : $"({Creator})";
+            string author = Creator == null ? string.Empty : $"({Creator})";
             return $"{Name} {author}".Trim();
         }
     }
diff --git a/osu.Game/Skinning/SkinInfo.cs b/osu.Game/Skinning/SkinInfo.cs
index 5d2d51a9b0..a83e7f5b1e 100644
--- a/osu.Game/Skinning/SkinInfo.cs
+++ b/osu.Game/Skinning/SkinInfo.cs
@@ -1,30 +1,38 @@
-// 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;
 using System.Collections.Generic;
 using osu.Framework.Extensions.ObjectExtensions;
+using osu.Framework.Testing;
 using osu.Game.Database;
 using osu.Game.Extensions;
 using osu.Game.IO;
+using osu.Game.Models;
+using Realms;
+
+#nullable enable
 
 namespace osu.Game.Skinning
 {
-    public class SkinInfo : IHasFiles<SkinFileInfo>, IEquatable<SkinInfo>, IHasPrimaryKey, ISoftDelete, IHasNamedFiles
+    [ExcludeFromDynamicCompile]
+    [MapTo("Skin")]
+    public class SkinInfo : RealmObject, IHasRealmFiles, IEquatable<SkinInfo>, IHasGuidPrimaryKey, ISoftDelete, IHasNamedFiles
     {
-        internal const int DEFAULT_SKIN = 0;
-        internal const int CLASSIC_SKIN = -1;
-        internal const int RANDOM_SKIN = -2;
+        internal static readonly Guid DEFAULT_SKIN = new Guid("2991CFD8-2140-469A-BCB9-2EC23FBCE4AD");
+        internal static readonly Guid CLASSIC_SKIN = new Guid("81F02CD3-EEC6-4865-AC23-FAE26A386187");
+        internal static readonly Guid RANDOM_SKIN = new Guid("D39DFEFB-477C-4372-B1EA-2BCEA5FB8908");
 
-        public int ID { get; set; }
+        [PrimaryKey]
+        public Guid ID { get; set; } = Guid.NewGuid();
 
         public string Name { get; set; } = string.Empty;
 
         public string Creator { get; set; } = string.Empty;
 
-        public string Hash { get; set; }
+        public string Hash { get; set; } = string.Empty;
 
-        public string InstantiationInfo { get; set; }
+        public string InstantiationInfo { get; set; } = string.Empty;
 
         public virtual Skin CreateInstance(IStorageResourceProvider resources)
         {
@@ -36,23 +44,28 @@ namespace osu.Game.Skinning
             return (Skin)Activator.CreateInstance(type, this, resources);
         }
 
-        public List<SkinFileInfo> Files { get; } = new List<SkinFileInfo>();
+        public IList<RealmNamedFileUsage> Files { get; } = null!;
 
         public bool DeletePending { get; set; }
 
         public static SkinInfo Default { get; } = new SkinInfo
         {
-            ID = DEFAULT_SKIN,
             Name = "osu! (triangles)",
             Creator = "team osu!",
             InstantiationInfo = typeof(DefaultSkin).GetInvariantInstantiationInfo()
         };
 
-        public bool Equals(SkinInfo other) => other != null && ID == other.ID;
+        public bool Equals(SkinInfo? other)
+        {
+            if (ReferenceEquals(this, other)) return true;
+            if (other == null) return false;
+
+            return ID == other.ID;
+        }
 
         public override string ToString()
         {
-            string author = Creator == null ? string.Empty : $"({Creator})";
+            string author = string.IsNullOrEmpty(Creator) ? string.Empty : $"({Creator})";
             return $"{Name} {author}".Trim();
         }
 
diff --git a/osu.Game/Skinning/SkinStore.cs b/osu.Game/Skinning/SkinStore.cs
index 31cadb0a24..922d146259 100644
--- a/osu.Game/Skinning/SkinStore.cs
+++ b/osu.Game/Skinning/SkinStore.cs
@@ -6,7 +6,7 @@ using osu.Game.Database;
 
 namespace osu.Game.Skinning
 {
-    public class SkinStore : MutableDatabaseBackedStoreWithFileIncludes<SkinInfo, SkinFileInfo>
+    public class SkinStore : MutableDatabaseBackedStoreWithFileIncludes<EFSkinInfo, SkinFileInfo>
     {
         public SkinStore(DatabaseContextFactory contextFactory, Storage storage = null)
             : base(contextFactory, storage)

From 3db5646fa846e5c6d2550915e626d1fda5c0ed66 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 23 Nov 2021 16:04:55 +0900
Subject: [PATCH 1356/5547] Create Guid constants for system skins (and store
 skin choice to configuration as guid)

---
 osu.Game/Configuration/OsuConfigManager.cs    | 11 +++++---
 osu.Game/OsuGame.cs                           | 26 ++++++++-----------
 .../Overlays/Settings/Sections/SkinSection.cs | 20 +++++++-------
 osu.Game/Skinning/SkinInfo.cs                 |  1 +
 4 files changed, 29 insertions(+), 29 deletions(-)

diff --git a/osu.Game/Configuration/OsuConfigManager.cs b/osu.Game/Configuration/OsuConfigManager.cs
index 84da3f666d..ade817e652 100644
--- a/osu.Game/Configuration/OsuConfigManager.cs
+++ b/osu.Game/Configuration/OsuConfigManager.cs
@@ -27,7 +27,7 @@ namespace osu.Game.Configuration
         {
             // UI/selection defaults
             SetDefault(OsuSetting.Ruleset, string.Empty);
-            SetDefault(OsuSetting.Skin, 0, -1, int.MaxValue);
+            SetDefault(OsuSetting.Skin, string.Empty);
 
             SetDefault(OsuSetting.BeatmapDetailTab, PlayBeatmapDetailArea.TabType.Details);
             SetDefault(OsuSetting.BeatmapDetailModsFilter, false);
@@ -210,9 +210,12 @@ namespace osu.Game.Configuration
                         value: scalingMode.GetLocalisableDescription()
                     )
                 ),
-                new TrackedSetting<int>(OsuSetting.Skin, skin =>
+                new TrackedSetting<string>(OsuSetting.Skin, skin =>
                 {
-                    string skinName = LookupSkinName(skin) ?? string.Empty;
+                    string skinName = string.Empty;
+
+                    if (Guid.TryParse(skin, out var id))
+                        skinName = LookupSkinName(id) ?? string.Empty;
 
                     return new SettingDescription(
                         rawValue: skinName,
@@ -233,7 +236,7 @@ namespace osu.Game.Configuration
             };
         }
 
-        public Func<int, string> LookupSkinName { private get; set; }
+        public Func<Guid, string> LookupSkinName { private get; set; }
 
         public Func<GlobalAction, LocalisableString> LookupKeyBindings { get; set; }
     }
diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index 99b67976e3..c294efa647 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -161,7 +161,7 @@ namespace osu.Game
 
         private Bindable<float> uiScale;
 
-        private Bindable<int> configSkin;
+        private Bindable<string> configSkin;
 
         private readonly string[] args;
 
@@ -243,27 +243,23 @@ namespace osu.Game
             Ruleset.ValueChanged += r => configRuleset.Value = r.NewValue.ShortName;
 
             // bind config int to database SkinInfo
-            configSkin = LocalConfig.GetBindable<int>(OsuSetting.Skin);
-            SkinManager.CurrentSkinInfo.ValueChanged += skin => configSkin.Value = skin.NewValue.ID;
+            configSkin = LocalConfig.GetBindable<string>(OsuSetting.Skin);
+            SkinManager.CurrentSkinInfo.ValueChanged += skin => configSkin.Value = skin.NewValue.ID.ToString();
             configSkin.ValueChanged += skinId =>
             {
-                var skinInfo = SkinManager.Query(s => s.ID == skinId.NewValue);
+                // TODO: migrate the user skin selection to the new ID format.
+                SkinInfo skinInfo = null;
+
+                if (Guid.TryParse(skinId.NewValue, out var guid))
+                    skinInfo = SkinManager.Query(s => s.ID == guid);
 
                 if (skinInfo == null)
                 {
-                    switch (skinId.NewValue)
-                    {
-                        case -1:
-                            skinInfo = DefaultLegacySkin.Info;
-                            break;
-
-                        default:
-                            skinInfo = SkinInfo.Default;
-                            break;
-                    }
+                    if (guid == SkinInfo.CLASSIC_SKIN)
+                        skinInfo = DefaultLegacySkin.Info;
                 }
 
-                SkinManager.CurrentSkinInfo.Value = skinInfo;
+                SkinManager.CurrentSkinInfo.Value = skinInfo ?? SkinInfo.Default;
             };
             configSkin.TriggerChange();
 
diff --git a/osu.Game/Overlays/Settings/Sections/SkinSection.cs b/osu.Game/Overlays/Settings/Sections/SkinSection.cs
index 0eb65b4b0f..168214bbde 100644
--- a/osu.Game/Overlays/Settings/Sections/SkinSection.cs
+++ b/osu.Game/Overlays/Settings/Sections/SkinSection.cs
@@ -33,7 +33,7 @@ namespace osu.Game.Overlays.Settings.Sections
         };
 
         private readonly Bindable<SkinInfo> dropdownBindable = new Bindable<SkinInfo> { Default = SkinInfo.Default };
-        private readonly Bindable<int> configBindable = new Bindable<int>();
+        private readonly Bindable<string> configBindable = new Bindable<string>();
 
         private static readonly SkinInfo random_skin_info = new SkinInfo
         {
@@ -47,7 +47,7 @@ namespace osu.Game.Overlays.Settings.Sections
         {
             get
             {
-                int index = skinItems.FindIndex(s => s.ID > 0);
+                int index = skinItems.FindIndex(s => s.ID == SkinInfo.CLASSIC_SKIN);
                 if (index < 0)
                     index = skinItems.Count;
 
@@ -84,33 +84,33 @@ namespace osu.Game.Overlays.Settings.Sections
             updateItems();
 
             // Todo: This should not be necessary when OsuConfigManager is databased
-            if (skinDropdown.Items.All(s => s.ID != configBindable.Value))
-                configBindable.Value = 0;
+            if (!Guid.TryParse(configBindable.Value, out var configId) || skinDropdown.Items.All(s => s.ID != configId))
+                configBindable.Value = string.Empty;
 
             configBindable.BindValueChanged(id => Scheduler.AddOnce(updateSelectedSkinFromConfig), true);
             dropdownBindable.BindValueChanged(skin =>
             {
-                if (skin.NewValue == random_skin_info)
+                if (skin.NewValue.Equals(random_skin_info))
                 {
                     skins.SelectRandomSkin();
                     return;
                 }
 
-                configBindable.Value = skin.NewValue.ID;
+                configBindable.Value = skin.NewValue.ID.ToString();
             });
         }
 
         private void updateSelectedSkinFromConfig()
         {
-            int id = configBindable.Value;
+            if (!Guid.TryParse(configBindable.Value, out var configId)) return;
 
-            var skin = skinDropdown.Items.FirstOrDefault(s => s.ID == id);
+            var skin = skinDropdown.Items.FirstOrDefault(s => s.ID == configId);
 
             if (skin == null)
             {
                 // there may be a thread race condition where an item is selected that hasn't yet been added to the dropdown.
                 // to avoid adding complexity, let's just ensure the item is added so we can perform the selection.
-                skin = skins.Query(s => s.ID == id);
+                skin = skins.Query(s => s.ID == configId);
                 addItem(skin);
             }
 
@@ -181,7 +181,7 @@ namespace osu.Game.Overlays.Settings.Sections
                 Action = export;
 
                 currentSkin = skins.CurrentSkin.GetBoundCopy();
-                currentSkin.BindValueChanged(skin => Enabled.Value = skin.NewValue.SkinInfo.ID > 0, true);
+                currentSkin.BindValueChanged(skin => Enabled.Value = skin.NewValue.SkinInfo.IsManaged, true);
             }
 
             private void export()
diff --git a/osu.Game/Skinning/SkinInfo.cs b/osu.Game/Skinning/SkinInfo.cs
index a83e7f5b1e..c09d45c227 100644
--- a/osu.Game/Skinning/SkinInfo.cs
+++ b/osu.Game/Skinning/SkinInfo.cs
@@ -50,6 +50,7 @@ namespace osu.Game.Skinning
 
         public static SkinInfo Default { get; } = new SkinInfo
         {
+            ID = DEFAULT_SKIN,
             Name = "osu! (triangles)",
             Creator = "team osu!",
             InstantiationInfo = typeof(DefaultSkin).GetInvariantInstantiationInfo()

From 2a9c7c00c8a261c63bb1e8860066940fbad7a2a3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 23 Nov 2021 16:05:28 +0900
Subject: [PATCH 1357/5547] Update tests and file access code

---
 osu.Game.Tests/Skins/IO/ImportSkinTest.cs                  | 4 ++--
 .../Visual/Background/TestSceneBackgroundScreenDefault.cs  | 2 +-
 osu.Game/Skinning/Skin.cs                                  | 4 ++--
 osu.Game/Tests/Beatmaps/HitObjectSampleTest.cs             | 7 ++-----
 4 files changed, 7 insertions(+), 10 deletions(-)

diff --git a/osu.Game.Tests/Skins/IO/ImportSkinTest.cs b/osu.Game.Tests/Skins/IO/ImportSkinTest.cs
index ecc9c92025..64d7359480 100644
--- a/osu.Game.Tests/Skins/IO/ImportSkinTest.cs
+++ b/osu.Game.Tests/Skins/IO/ImportSkinTest.cs
@@ -181,14 +181,14 @@ namespace osu.Game.Tests.Skins.IO
         {
             Assert.That(import2.ID, Is.Not.EqualTo(import1.ID));
             Assert.That(import2.Hash, Is.Not.EqualTo(import1.Hash));
-            Assert.That(import2.Files.Select(f => f.FileInfoID), Is.Not.EquivalentTo(import1.Files.Select(f => f.FileInfoID)));
+            Assert.That(import2.Files.First(), Is.Not.EqualTo(import1.Files.First()));
         }
 
         private void assertImportedOnce(SkinInfo import1, SkinInfo import2)
         {
             Assert.That(import2.ID, Is.EqualTo(import1.ID));
             Assert.That(import2.Hash, Is.EqualTo(import1.Hash));
-            Assert.That(import2.Files.Select(f => f.FileInfoID), Is.EquivalentTo(import1.Files.Select(f => f.FileInfoID)));
+            Assert.That(import2.Files.First(), Is.EqualTo(import1.Files.First()));
         }
 
         private MemoryStream createEmptyOsk()
diff --git a/osu.Game.Tests/Visual/Background/TestSceneBackgroundScreenDefault.cs b/osu.Game.Tests/Visual/Background/TestSceneBackgroundScreenDefault.cs
index ec16578b71..a56b69a024 100644
--- a/osu.Game.Tests/Visual/Background/TestSceneBackgroundScreenDefault.cs
+++ b/osu.Game.Tests/Visual/Background/TestSceneBackgroundScreenDefault.cs
@@ -122,7 +122,7 @@ namespace osu.Game.Tests.Visual.Background
         private void setCustomSkin()
         {
             // feign a skin switch. this doesn't do anything except force CurrentSkin to become a LegacySkin.
-            AddStep("set custom skin", () => skins.CurrentSkinInfo.Value = new SkinInfo { ID = 5 });
+            AddStep("set custom skin", () => skins.CurrentSkinInfo.Value = new SkinInfo());
         }
 
         private void setDefaultSkin() => AddStep("set default skin", () => skins.CurrentSkinInfo.SetDefault());
diff --git a/osu.Game/Skinning/Skin.cs b/osu.Game/Skinning/Skin.cs
index 10526b69af..2f16270fb7 100644
--- a/osu.Game/Skinning/Skin.cs
+++ b/osu.Game/Skinning/Skin.cs
@@ -64,7 +64,7 @@ namespace osu.Game.Skinning
                 if (fileInfo == null)
                     continue;
 
-                byte[] bytes = resources?.Files.Get(fileInfo.FileInfo.GetStoragePath());
+                byte[] bytes = resources?.Files.Get(fileInfo.File.GetStoragePath());
 
                 if (bytes == null)
                     continue;
@@ -94,7 +94,7 @@ namespace osu.Game.Skinning
 
         private Stream getConfigurationStream()
         {
-            string path = SkinInfo.Files.SingleOrDefault(f => f.Filename.Equals(@"skin.ini", StringComparison.OrdinalIgnoreCase))?.FileInfo.GetStoragePath();
+            string path = SkinInfo.Files.SingleOrDefault(f => f.Filename.Equals(@"skin.ini", StringComparison.OrdinalIgnoreCase))?.File.GetStoragePath();
 
             if (string.IsNullOrEmpty(path))
                 return null;
diff --git a/osu.Game/Tests/Beatmaps/HitObjectSampleTest.cs b/osu.Game/Tests/Beatmaps/HitObjectSampleTest.cs
index 9d92f5c5fc..31a2071249 100644
--- a/osu.Game/Tests/Beatmaps/HitObjectSampleTest.cs
+++ b/osu.Game/Tests/Beatmaps/HitObjectSampleTest.cs
@@ -15,6 +15,7 @@ using osu.Framework.Timing;
 using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.Formats;
 using osu.Game.IO;
+using osu.Game.Models;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Objects;
 using osu.Game.Screens.Ranking;
@@ -88,11 +89,7 @@ namespace osu.Game.Tests.Beatmaps
             AddStep("setup skins", () =>
             {
                 userSkinInfo.Files.Clear();
-                userSkinInfo.Files.Add(new SkinFileInfo
-                {
-                    Filename = userFile,
-                    FileInfo = new IO.FileInfo { Hash = userFile }
-                });
+                userSkinInfo.Files.Add(new RealmNamedFileUsage(new RealmFile { Hash = userFile }, userFile));
 
                 beatmapInfo.BeatmapSet.Files.Clear();
                 beatmapInfo.BeatmapSet.Files.Add(new BeatmapSetFileInfo

From 23146d59d1b1ee9464e52723113ec86d798130f5 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 29 Nov 2021 17:57:17 +0900
Subject: [PATCH 1358/5547] Use `ILive` for current skin

---
 .../Editor/TestSceneManiaComposeScreen.cs     |  5 ++-
 osu.Game.Tests/Skins/IO/ImportSkinTest.cs     | 44 ++++++++++++-------
 .../Skins/TestSceneSkinResources.cs           |  2 +-
 .../TestSceneBackgroundScreenDefault.cs       |  3 +-
 .../Gameplay/TestSceneBeatmapSkinFallbacks.cs |  3 +-
 osu.Game/OsuGame.cs                           |  6 +--
 osu.Game/Skinning/SkinManager.cs              |  2 +-
 osu.Game/Tests/Visual/SkinnableTestScene.cs   |  2 +-
 8 files changed, 40 insertions(+), 27 deletions(-)

diff --git a/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneManiaComposeScreen.cs b/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneManiaComposeScreen.cs
index 24d2a786a0..a7e76e44b5 100644
--- a/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneManiaComposeScreen.cs
+++ b/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneManiaComposeScreen.cs
@@ -8,6 +8,7 @@ using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Testing;
+using osu.Game.Database;
 using osu.Game.Rulesets.Edit;
 using osu.Game.Rulesets.Mania.Beatmaps;
 using osu.Game.Screens.Edit;
@@ -55,13 +56,13 @@ namespace osu.Game.Rulesets.Mania.Tests.Editor
         [Test]
         public void TestDefaultSkin()
         {
-            AddStep("set default skin", () => skins.CurrentSkinInfo.Value = SkinInfo.Default);
+            AddStep("set default skin", () => skins.CurrentSkinInfo.Value = SkinInfo.Default.ToLive());
         }
 
         [Test]
         public void TestLegacySkin()
         {
-            AddStep("set legacy skin", () => skins.CurrentSkinInfo.Value = DefaultLegacySkin.Info);
+            AddStep("set legacy skin", () => skins.CurrentSkinInfo.Value = DefaultLegacySkin.Info.ToLive());
         }
     }
 }
diff --git a/osu.Game.Tests/Skins/IO/ImportSkinTest.cs b/osu.Game.Tests/Skins/IO/ImportSkinTest.cs
index 64d7359480..9b7e169745 100644
--- a/osu.Game.Tests/Skins/IO/ImportSkinTest.cs
+++ b/osu.Game.Tests/Skins/IO/ImportSkinTest.cs
@@ -9,6 +9,7 @@ using System.Threading.Tasks;
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Platform;
+using osu.Game.Database;
 using osu.Game.IO;
 using osu.Game.IO.Archives;
 using osu.Game.Skinning;
@@ -165,30 +166,39 @@ namespace osu.Game.Tests.Skins.IO
 
         #endregion
 
-        private void assertCorrectMetadata(SkinInfo import1, string name, string creator, OsuGameBase osu)
+        private void assertCorrectMetadata(ILive<SkinInfo> import1, string name, string creator, OsuGameBase osu)
         {
-            Assert.That(import1.Name, Is.EqualTo(name));
-            Assert.That(import1.Creator, Is.EqualTo(creator));
+            import1.PerformRead(i =>
+            {
+                Assert.That(i.Name, Is.EqualTo(name));
+                Assert.That(i.Creator, Is.EqualTo(creator));
 
-            // for extra safety let's reconstruct the skin, reading from the skin.ini.
-            var instance = import1.CreateInstance((IStorageResourceProvider)osu.Dependencies.Get(typeof(SkinManager)));
+                // for extra safety let's reconstruct the skin, reading from the skin.ini.
+                var instance = i.CreateInstance((IStorageResourceProvider)osu.Dependencies.Get(typeof(SkinManager)));
 
-            Assert.That(instance.Configuration.SkinInfo.Name, Is.EqualTo(name));
-            Assert.That(instance.Configuration.SkinInfo.Creator, Is.EqualTo(creator));
+                Assert.That(instance.Configuration.SkinInfo.Name, Is.EqualTo(name));
+                Assert.That(instance.Configuration.SkinInfo.Creator, Is.EqualTo(creator));
+            });
         }
 
-        private void assertImportedBoth(SkinInfo import1, SkinInfo import2)
+        private void assertImportedBoth(ILive<SkinInfo> import1, ILive<SkinInfo> import2)
         {
-            Assert.That(import2.ID, Is.Not.EqualTo(import1.ID));
-            Assert.That(import2.Hash, Is.Not.EqualTo(import1.Hash));
-            Assert.That(import2.Files.First(), Is.Not.EqualTo(import1.Files.First()));
+            import1.PerformRead(i1 => import2.PerformRead(i2 =>
+            {
+                Assert.That(i2.ID, Is.Not.EqualTo(i1.ID));
+                Assert.That(i2.Hash, Is.Not.EqualTo(i1.Hash));
+                Assert.That(i2.Files.First(), Is.Not.EqualTo(i1.Files.First()));
+            }));
         }
 
-        private void assertImportedOnce(SkinInfo import1, SkinInfo import2)
+        private void assertImportedOnce(ILive<SkinInfo> import1, ILive<SkinInfo> import2)
         {
-            Assert.That(import2.ID, Is.EqualTo(import1.ID));
-            Assert.That(import2.Hash, Is.EqualTo(import1.Hash));
-            Assert.That(import2.Files.First(), Is.EqualTo(import1.Files.First()));
+            import1.PerformRead(i1 => import2.PerformRead(i2 =>
+            {
+                Assert.That(i2.ID, Is.EqualTo(i1.ID));
+                Assert.That(i2.Hash, Is.EqualTo(i1.Hash));
+                Assert.That(i2.Files.First(), Is.EqualTo(i1.Files.First()));
+            }));
         }
 
         private MemoryStream createEmptyOsk()
@@ -255,10 +265,10 @@ namespace osu.Game.Tests.Skins.IO
             }
         }
 
-        private async Task<SkinInfo> loadSkinIntoOsu(OsuGameBase osu, ArchiveReader archive = null)
+        private async Task<ILive<SkinInfo>> loadSkinIntoOsu(OsuGameBase osu, ArchiveReader archive = null)
         {
             var skinManager = osu.Dependencies.Get<SkinManager>();
-            return (await skinManager.Import(archive)).Value;
+            return (await skinManager.Import(archive));
         }
     }
 }
diff --git a/osu.Game.Tests/Skins/TestSceneSkinResources.cs b/osu.Game.Tests/Skins/TestSceneSkinResources.cs
index 10f1ab31df..09535b76e3 100644
--- a/osu.Game.Tests/Skins/TestSceneSkinResources.cs
+++ b/osu.Game.Tests/Skins/TestSceneSkinResources.cs
@@ -24,7 +24,7 @@ namespace osu.Game.Tests.Skins
         private void load()
         {
             var imported = skins.Import(new ZipArchiveReader(TestResources.OpenResource("Archives/ogg-skin.osk"))).Result;
-            skin = skins.GetSkin(imported.Value);
+            skin = imported.PerformRead(skinInfo => skins.GetSkin(skinInfo));
         }
 
         [Test]
diff --git a/osu.Game.Tests/Visual/Background/TestSceneBackgroundScreenDefault.cs b/osu.Game.Tests/Visual/Background/TestSceneBackgroundScreenDefault.cs
index a56b69a024..bdd1b92c8d 100644
--- a/osu.Game.Tests/Visual/Background/TestSceneBackgroundScreenDefault.cs
+++ b/osu.Game.Tests/Visual/Background/TestSceneBackgroundScreenDefault.cs
@@ -8,6 +8,7 @@ using osu.Framework.Allocation;
 using osu.Framework.Screens;
 using osu.Framework.Testing;
 using osu.Game.Configuration;
+using osu.Game.Database;
 using osu.Game.Graphics.Backgrounds;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests.Responses;
@@ -122,7 +123,7 @@ namespace osu.Game.Tests.Visual.Background
         private void setCustomSkin()
         {
             // feign a skin switch. this doesn't do anything except force CurrentSkin to become a LegacySkin.
-            AddStep("set custom skin", () => skins.CurrentSkinInfo.Value = new SkinInfo());
+            AddStep("set custom skin", () => skins.CurrentSkinInfo.Value = new SkinInfo().ToLive());
         }
 
         private void setDefaultSkin() => AddStep("set default skin", () => skins.CurrentSkinInfo.SetDefault());
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneBeatmapSkinFallbacks.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneBeatmapSkinFallbacks.cs
index 7398527f57..c174a3edc2 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneBeatmapSkinFallbacks.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneBeatmapSkinFallbacks.cs
@@ -12,6 +12,7 @@ using osu.Framework.Testing;
 using osu.Framework.Timing;
 using osu.Framework.Utils;
 using osu.Game.Beatmaps;
+using osu.Game.Database;
 using osu.Game.Extensions;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Osu;
@@ -52,7 +53,7 @@ namespace osu.Game.Tests.Visual.Gameplay
             {
                 AddStep("setup skins", () =>
                 {
-                    skinManager.CurrentSkinInfo.Value = gameCurrentSkin;
+                    skinManager.CurrentSkinInfo.Value = gameCurrentSkin.ToLive();
                     currentBeatmapSkin = getBeatmapSkin();
                 });
             });
diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index c294efa647..1ffbb4cb85 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -248,7 +248,7 @@ namespace osu.Game
             configSkin.ValueChanged += skinId =>
             {
                 // TODO: migrate the user skin selection to the new ID format.
-                SkinInfo skinInfo = null;
+                ILive<SkinInfo> skinInfo = null;
 
                 if (Guid.TryParse(skinId.NewValue, out var guid))
                     skinInfo = SkinManager.Query(s => s.ID == guid);
@@ -256,10 +256,10 @@ namespace osu.Game
                 if (skinInfo == null)
                 {
                     if (guid == SkinInfo.CLASSIC_SKIN)
-                        skinInfo = DefaultLegacySkin.Info;
+                        skinInfo = DefaultLegacySkin.Info.ToLive();
                 }
 
-                SkinManager.CurrentSkinInfo.Value = skinInfo ?? SkinInfo.Default;
+                SkinManager.CurrentSkinInfo.Value = skinInfo ?? SkinInfo.Default.ToLive();
             };
             configSkin.TriggerChange();
 
diff --git a/osu.Game/Skinning/SkinManager.cs b/osu.Game/Skinning/SkinManager.cs
index 26ff4457af..24ec454276 100644
--- a/osu.Game/Skinning/SkinManager.cs
+++ b/osu.Game/Skinning/SkinManager.cs
@@ -46,7 +46,7 @@ namespace osu.Game.Skinning
         private readonly IResourceStore<byte[]> resources;
 
         public readonly Bindable<Skin> CurrentSkin = new Bindable<Skin>();
-        public readonly Bindable<SkinInfo> CurrentSkinInfo = new Bindable<SkinInfo>(SkinInfo.Default) { Default = SkinInfo.Default };
+        public readonly Bindable<ILive<SkinInfo>> CurrentSkinInfo = new Bindable<ILive<SkinInfo>>(SkinInfo.Default.ToLive()) { Default = SkinInfo.Default.ToLive() };
 
         private readonly SkinModelManager skinModelManager;
 
diff --git a/osu.Game/Tests/Visual/SkinnableTestScene.cs b/osu.Game/Tests/Visual/SkinnableTestScene.cs
index 000e7194bc..cdd3e47930 100644
--- a/osu.Game/Tests/Visual/SkinnableTestScene.cs
+++ b/osu.Game/Tests/Visual/SkinnableTestScene.cs
@@ -95,7 +95,7 @@ namespace osu.Game.Tests.Visual
                     },
                     new OsuSpriteText
                     {
-                        Text = skin?.SkinInfo?.Name ?? "none",
+                        Text = skin?.SkinInfo?.Value.Name ?? "none",
                         Scale = new Vector2(1.5f),
                         Padding = new MarginPadding(5),
                     },

From 5db7cf23d35a75f3af71cfd22303efffe352be3a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 29 Nov 2021 17:59:41 +0900
Subject: [PATCH 1359/5547] Add pending deletion skin cleanup

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

diff --git a/osu.Game/Database/RealmContextFactory.cs b/osu.Game/Database/RealmContextFactory.cs
index 6948918fe7..911c88a61f 100644
--- a/osu.Game/Database/RealmContextFactory.cs
+++ b/osu.Game/Database/RealmContextFactory.cs
@@ -14,6 +14,7 @@ using osu.Framework.Statistics;
 using osu.Game.Configuration;
 using osu.Game.Input.Bindings;
 using osu.Game.Models;
+using osu.Game.Skinning;
 using osu.Game.Stores;
 using Realms;
 
@@ -122,6 +123,11 @@ namespace osu.Game.Database
                     realm.Remove(s);
                 }
 
+                var pendingDeleteSkins = realm.All<SkinInfo>().Where(s => s.DeletePending);
+
+                foreach (var s in pendingDeleteSkins)
+                    realm.Remove(s);
+
                 transaction.Commit();
             }
 

From cd0c811ab1fdb40cd745b1913f5e7e3f727b229f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 29 Nov 2021 18:00:03 +0900
Subject: [PATCH 1360/5547] Add the ability to call `ToString` on a `RealmLive`
 to get the underlying object's implementation

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

diff --git a/osu.Game/Database/RealmLive.cs b/osu.Game/Database/RealmLive.cs
index 6d5410d1cd..6f17493097 100644
--- a/osu.Game/Database/RealmLive.cs
+++ b/osu.Game/Database/RealmLive.cs
@@ -123,5 +123,7 @@ namespace osu.Game.Database
             => (fetchedContext != null && SynchronizationContext.Current == fetchedContext) || fetchedThreadId == Thread.CurrentThread.ManagedThreadId;
 
         public bool Equals(ILive<T>? other) => ID == other?.ID;
+
+        public override string ToString() => PerformRead(i => i.ToString());
     }
 }

From 6b55de2845d22e8f14778bf764ff1208292682e4 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 29 Nov 2021 18:02:09 +0900
Subject: [PATCH 1361/5547] Use `ILive` for `Skin.SkinInfo`

---
 osu.Game/Skinning/Skin.cs | 61 +++++++++++++++++++++------------------
 1 file changed, 33 insertions(+), 28 deletions(-)

diff --git a/osu.Game/Skinning/Skin.cs b/osu.Game/Skinning/Skin.cs
index 2f16270fb7..54fc2340f1 100644
--- a/osu.Game/Skinning/Skin.cs
+++ b/osu.Game/Skinning/Skin.cs
@@ -15,6 +15,7 @@ using osu.Framework.Graphics.OpenGL.Textures;
 using osu.Framework.Graphics.Textures;
 using osu.Framework.Logging;
 using osu.Game.Audio;
+using osu.Game.Database;
 using osu.Game.Extensions;
 using osu.Game.IO;
 using osu.Game.Screens.Play.HUD;
@@ -23,7 +24,7 @@ namespace osu.Game.Skinning
 {
     public abstract class Skin : IDisposable, ISkin
     {
-        public readonly SkinInfo SkinInfo;
+        public readonly ILive<SkinInfo> SkinInfo;
         private readonly IStorageResourceProvider resources;
 
         public SkinConfiguration Configuration { get; set; }
@@ -42,7 +43,7 @@ namespace osu.Game.Skinning
 
         protected Skin(SkinInfo skin, IStorageResourceProvider resources, [CanBeNull] Stream configurationStream = null)
         {
-            SkinInfo = skin;
+            SkinInfo = skin.ToLive();
             this.resources = resources;
 
             configurationStream ??= getConfigurationStream();
@@ -53,37 +54,41 @@ namespace osu.Game.Skinning
             else
                 Configuration = new SkinConfiguration();
 
-            // we may want to move this to some kind of async operation in the future.
-            foreach (SkinnableTarget skinnableTarget in Enum.GetValues(typeof(SkinnableTarget)))
+            // skininfo files may be null for default skin.
+            SkinInfo.PerformRead(s =>
             {
-                string filename = $"{skinnableTarget}.json";
-
-                // skininfo files may be null for default skin.
-                var fileInfo = SkinInfo.Files.FirstOrDefault(f => f.Filename == filename);
-
-                if (fileInfo == null)
-                    continue;
-
-                byte[] bytes = resources?.Files.Get(fileInfo.File.GetStoragePath());
-
-                if (bytes == null)
-                    continue;
-
-                try
+                // we may want to move this to some kind of async operation in the future.
+                foreach (SkinnableTarget skinnableTarget in Enum.GetValues(typeof(SkinnableTarget)))
                 {
-                    string jsonContent = Encoding.UTF8.GetString(bytes);
-                    var deserializedContent = JsonConvert.DeserializeObject<IEnumerable<SkinnableInfo>>(jsonContent);
+                    string filename = $"{skinnableTarget}.json";
 
-                    if (deserializedContent == null)
+                    // skininfo files may be null for default skin.
+                    var fileInfo = s.Files.FirstOrDefault(f => f.Filename == filename);
+
+                    if (fileInfo == null)
                         continue;
 
-                    DrawableComponentInfo[skinnableTarget] = deserializedContent.ToArray();
+                    byte[] bytes = resources?.Files.Get(fileInfo.File.GetStoragePath());
+
+                    if (bytes == null)
+                        continue;
+
+                    try
+                    {
+                        string jsonContent = Encoding.UTF8.GetString(bytes);
+                        var deserializedContent = JsonConvert.DeserializeObject<IEnumerable<SkinnableInfo>>(jsonContent);
+
+                        if (deserializedContent == null)
+                            continue;
+
+                        DrawableComponentInfo[skinnableTarget] = deserializedContent.ToArray();
+                    }
+                    catch (Exception ex)
+                    {
+                        Logger.Error(ex, "Failed to load skin configuration.");
+                    }
                 }
-                catch (Exception ex)
-                {
-                    Logger.Error(ex, "Failed to load skin configuration.");
-                }
-            }
+            });
         }
 
         protected virtual void ParseConfigurationStream(Stream stream)
@@ -94,7 +99,7 @@ namespace osu.Game.Skinning
 
         private Stream getConfigurationStream()
         {
-            string path = SkinInfo.Files.SingleOrDefault(f => f.Filename.Equals(@"skin.ini", StringComparison.OrdinalIgnoreCase))?.File.GetStoragePath();
+            string path = SkinInfo.PerformRead(s => s.Files.SingleOrDefault(f => f.Filename.Equals(@"skin.ini", StringComparison.OrdinalIgnoreCase))?.File.GetStoragePath());
 
             if (string.IsNullOrEmpty(path))
                 return null;

From 744a5b33f5c261e124de28759ead387a52f4093b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 29 Nov 2021 18:04:07 +0900
Subject: [PATCH 1362/5547] Rewrite `SkinSection` to use realm subscriptions
 and databased defaults

---
 .../Sections/Maintenance/GeneralSettings.cs   |  5 +-
 .../Overlays/Settings/Sections/SkinSection.cs | 47 ++++++++++++-------
 2 files changed, 34 insertions(+), 18 deletions(-)

diff --git a/osu.Game/Overlays/Settings/Sections/Maintenance/GeneralSettings.cs b/osu.Game/Overlays/Settings/Sections/Maintenance/GeneralSettings.cs
index acdf9cdea6..e7e196555f 100644
--- a/osu.Game/Overlays/Settings/Sections/Maintenance/GeneralSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Maintenance/GeneralSettings.cs
@@ -106,7 +106,10 @@ namespace osu.Game.Overlays.Settings.Sections.Maintenance
                     dialogOverlay?.Push(new MassDeleteConfirmationDialog(() =>
                     {
                         deleteSkinsButton.Enabled.Value = false;
-                        Task.Run(() => skins.Delete(skins.GetAllUserSkins())).ContinueWith(t => Schedule(() => deleteSkinsButton.Enabled.Value = true));
+                        Task.Run(() =>
+                        {
+                            skins.Delete(s => !s.DeletePending);
+                        }).ContinueWith(t => Schedule(() => deleteSkinsButton.Enabled.Value = true));
                     }));
                 }
             });
diff --git a/osu.Game/Overlays/Settings/Sections/SkinSection.cs b/osu.Game/Overlays/Settings/Sections/SkinSection.cs
index 168214bbde..9c5a2dff47 100644
--- a/osu.Game/Overlays/Settings/Sections/SkinSection.cs
+++ b/osu.Game/Overlays/Settings/Sections/SkinSection.cs
@@ -32,16 +32,16 @@ namespace osu.Game.Overlays.Settings.Sections
             Icon = FontAwesome.Solid.PaintBrush
         };
 
-        private readonly Bindable<SkinInfo> dropdownBindable = new Bindable<SkinInfo> { Default = SkinInfo.Default };
+        private readonly Bindable<ILive<SkinInfo>> dropdownBindable = new Bindable<ILive<SkinInfo>> { Default = SkinInfo.Default.ToLive() };
         private readonly Bindable<string> configBindable = new Bindable<string>();
 
-        private static readonly SkinInfo random_skin_info = new SkinInfo
+        private static readonly ILive<SkinInfo> random_skin_info = new SkinInfo
         {
             ID = SkinInfo.RANDOM_SKIN,
             Name = "<Random Skin>",
-        };
+        }.ToLive();
 
-        private List<SkinInfo> skinItems;
+        private List<ILive<SkinInfo>> skinItems;
 
         private int firstNonDefaultSkinIndex
         {
@@ -79,6 +79,11 @@ namespace osu.Game.Overlays.Settings.Sections
             skins.ItemRemoved += itemRemoved;
 
             config.BindWith(OsuSetting.Skin, configBindable);
+        }
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
 
             skinDropdown.Current = dropdownBindable;
             updateItems();
@@ -125,22 +130,30 @@ namespace osu.Game.Overlays.Settings.Sections
             skinDropdown.Items = skinItems;
         }
 
-        private void itemUpdated(SkinInfo item) => Schedule(() => addItem(item));
+        private void itemUpdated(SkinInfo item) => Schedule(() => addItem(item.ToLive()));
 
-        private void addItem(SkinInfo item)
+        private void addItem(ILive<SkinInfo> item)
         {
-            List<SkinInfo> newDropdownItems = skinDropdown.Items.Where(i => !i.Equals(item)).Append(item).ToList();
+            List<ILive<SkinInfo>> newDropdownItems = skinDropdown.Items.Where(i => !i.Equals(item)).Append(item).ToList();
             sortUserSkins(newDropdownItems);
             skinDropdown.Items = newDropdownItems;
         }
 
-        private void itemRemoved(SkinInfo item) => Schedule(() => skinDropdown.Items = skinDropdown.Items.Where(i => !i.Equals(item)).ToArray());
+        private void itemRemoved(SkinInfo item) => Schedule(() => skinDropdown.Items = skinDropdown.Items.Where(i => !i.ID.Equals(item.ID)).ToArray());
 
-        private void sortUserSkins(List<SkinInfo> skinsList)
+        private void sortUserSkins(List<ILive<SkinInfo>> skinsList)
         {
-            // Sort user skins separately from built-in skins
-            skinsList.Sort(firstNonDefaultSkinIndex, skinsList.Count - firstNonDefaultSkinIndex,
-                Comparer<SkinInfo>.Create((a, b) => string.Compare(a.Name, b.Name, StringComparison.OrdinalIgnoreCase)));
+            try
+            {
+                // Sort user skins separately from built-in skins
+                skinsList.Sort(firstNonDefaultSkinIndex, skinsList.Count - firstNonDefaultSkinIndex,
+                    Comparer<ILive<SkinInfo>>.Create((a, b) =>
+                    {
+                        // o_________________________o
+                        return a.PerformRead(ai => b.PerformRead(bi => string.Compare(ai.Name, bi.Name, StringComparison.OrdinalIgnoreCase)));
+                    }));
+            }
+            catch { }
         }
 
         protected override void Dispose(bool isDisposing)
@@ -154,13 +167,13 @@ namespace osu.Game.Overlays.Settings.Sections
             }
         }
 
-        private class SkinSettingsDropdown : SettingsDropdown<SkinInfo>
+        private class SkinSettingsDropdown : SettingsDropdown<ILive<SkinInfo>>
         {
-            protected override OsuDropdown<SkinInfo> CreateDropdown() => new SkinDropdownControl();
+            protected override OsuDropdown<ILive<SkinInfo>> CreateDropdown() => new SkinDropdownControl();
 
             private class SkinDropdownControl : DropdownControl
             {
-                protected override LocalisableString GenerateItemText(SkinInfo item) => item.ToString();
+                protected override LocalisableString GenerateItemText(ILive<SkinInfo> item) => item.ToString();
             }
         }
 
@@ -181,14 +194,14 @@ namespace osu.Game.Overlays.Settings.Sections
                 Action = export;
 
                 currentSkin = skins.CurrentSkin.GetBoundCopy();
-                currentSkin.BindValueChanged(skin => Enabled.Value = skin.NewValue.SkinInfo.IsManaged, true);
+                currentSkin.BindValueChanged(skin => Enabled.Value = skin.NewValue.SkinInfo.PerformRead(s => s.IsManaged), true);
             }
 
             private void export()
             {
                 try
                 {
-                    new LegacySkinExporter(storage).Export(currentSkin.Value.SkinInfo);
+                    currentSkin.Value.SkinInfo.PerformRead(s => new LegacySkinExporter(storage).Export(s));
                 }
                 catch (Exception e)
                 {

From e2d9a685d7ed48525a9c73465d0fb326ef25c283 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 29 Nov 2021 18:05:36 +0900
Subject: [PATCH 1363/5547] Update skin implementations to match new structures

---
 osu.Game/Skinning/DefaultLegacySkin.cs        |  4 +-
 osu.Game/Skinning/DefaultSkin.cs              |  2 +-
 osu.Game/Skinning/LegacyBeatmapSkin.cs        |  2 +-
 .../LegacyDatabasedSkinResourceStore.cs       | 49 +++++++++++++++++++
 osu.Game/Skinning/LegacySkin.cs               |  2 +-
 osu.Game/Skinning/LegacySkinResourceStore.cs  |  6 +--
 6 files changed, 57 insertions(+), 8 deletions(-)
 create mode 100644 osu.Game/Skinning/LegacyDatabasedSkinResourceStore.cs

diff --git a/osu.Game/Skinning/DefaultLegacySkin.cs b/osu.Game/Skinning/DefaultLegacySkin.cs
index 95e9a19c99..2332e6e160 100644
--- a/osu.Game/Skinning/DefaultLegacySkin.cs
+++ b/osu.Game/Skinning/DefaultLegacySkin.cs
@@ -25,7 +25,7 @@ namespace osu.Game.Skinning
                 resources,
                 // A default legacy skin may still have a skin.ini if it is modified by the user.
                 // We must specify the stream directly as we are redirecting storage to the osu-resources location for other files.
-                new LegacySkinResourceStore(skin, resources.Files).GetStream("skin.ini")
+                new LegacyDatabasedSkinResourceStore(skin, resources.Files).GetStream("skin.ini")
             )
         {
             Configuration.CustomColours["SliderBall"] = new Color4(2, 170, 255, 255);
@@ -42,7 +42,7 @@ namespace osu.Game.Skinning
 
         public static SkinInfo Info { get; } = new SkinInfo
         {
-            ID = SkinInfo.CLASSIC_SKIN, // this is temporary until database storage is decided upon.
+            ID = osu.Game.Skinning.SkinInfo.CLASSIC_SKIN, // this is temporary until database storage is decided upon.
             Name = "osu!classic",
             Creator = "team osu!",
             InstantiationInfo = typeof(DefaultLegacySkin).GetInvariantInstantiationInfo()
diff --git a/osu.Game/Skinning/DefaultSkin.cs b/osu.Game/Skinning/DefaultSkin.cs
index c377f16f8b..8d3a83f589 100644
--- a/osu.Game/Skinning/DefaultSkin.cs
+++ b/osu.Game/Skinning/DefaultSkin.cs
@@ -26,7 +26,7 @@ namespace osu.Game.Skinning
         private readonly IStorageResourceProvider resources;
 
         public DefaultSkin(IStorageResourceProvider resources)
-            : this(SkinInfo.Default, resources)
+            : this(osu.Game.Skinning.SkinInfo.Default, resources)
         {
         }
 
diff --git a/osu.Game/Skinning/LegacyBeatmapSkin.cs b/osu.Game/Skinning/LegacyBeatmapSkin.cs
index 0599334b46..d44d3dce49 100644
--- a/osu.Game/Skinning/LegacyBeatmapSkin.cs
+++ b/osu.Game/Skinning/LegacyBeatmapSkin.cs
@@ -77,6 +77,6 @@ namespace osu.Game.Skinning
         }
 
         private static SkinInfo createSkinInfo(BeatmapInfo beatmapInfo) =>
-            new SkinInfo { Name = beatmapInfo.ToString(), Creator = beatmapInfo.Metadata?.Author.Username };
+            new SkinInfo { Name = beatmapInfo.ToString(), Creator = beatmapInfo.Metadata?.Author.Username ?? string.Empty };
     }
 }
diff --git a/osu.Game/Skinning/LegacyDatabasedSkinResourceStore.cs b/osu.Game/Skinning/LegacyDatabasedSkinResourceStore.cs
new file mode 100644
index 0000000000..ab820a13ab
--- /dev/null
+++ b/osu.Game/Skinning/LegacyDatabasedSkinResourceStore.cs
@@ -0,0 +1,49 @@
+// 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.Extensions;
+using osu.Framework.IO.Stores;
+using osu.Game.Database;
+using osu.Game.Extensions;
+using Realms;
+
+namespace osu.Game.Skinning
+{
+    public class LegacyDatabasedSkinResourceStore : ResourceStore<byte[]>
+    {
+        private readonly ILive<SkinInfo> source;
+
+        public LegacyDatabasedSkinResourceStore(SkinInfo source, IResourceStore<byte[]> underlyingStore)
+            : base(underlyingStore)
+        {
+            this.source = source.ToLive();
+        }
+
+        protected override IEnumerable<string> GetFilenames(string name)
+        {
+            foreach (string filename in base.GetFilenames(name))
+            {
+                string path = getPathForFile(filename.ToStandardisedPath());
+                if (path != null)
+                    yield return path;
+            }
+        }
+
+        private string getPathForFile(string filename) =>
+            source.PerformRead(s =>
+            {
+                if (s.IsManaged)
+                {
+                    // avoid enumerating all files if this is a managed realm instance.
+                    return s.Files.Filter(@"Filename ==[c] $0", filename).FirstOrDefault()?.File.GetStoragePath();
+                }
+
+                return s.Files.FirstOrDefault(f => string.Equals(f.Filename, filename, StringComparison.OrdinalIgnoreCase))?.File.GetStoragePath();
+            });
+
+        public override IEnumerable<string> GetAvailableResources() => source.PerformRead(s => s.Files.Select(f => f.Filename));
+    }
+}
diff --git a/osu.Game/Skinning/LegacySkin.cs b/osu.Game/Skinning/LegacySkin.cs
index 64f920de85..e677e2c01b 100644
--- a/osu.Game/Skinning/LegacySkin.cs
+++ b/osu.Game/Skinning/LegacySkin.cs
@@ -51,7 +51,7 @@ namespace osu.Game.Skinning
 
         [UsedImplicitly(ImplicitUseKindFlags.InstantiatedWithFixedConstructorSignature)]
         public LegacySkin(SkinInfo skin, IStorageResourceProvider resources)
-            : this(skin, new LegacySkinResourceStore(skin, resources.Files), resources, "skin.ini")
+            : this(skin, new LegacyDatabasedSkinResourceStore(skin, resources.Files), resources, "skin.ini")
         {
         }
 
diff --git a/osu.Game/Skinning/LegacySkinResourceStore.cs b/osu.Game/Skinning/LegacySkinResourceStore.cs
index 71efc949b8..2487a469c8 100644
--- a/osu.Game/Skinning/LegacySkinResourceStore.cs
+++ b/osu.Game/Skinning/LegacySkinResourceStore.cs
@@ -13,9 +13,9 @@ namespace osu.Game.Skinning
 {
     public class LegacySkinResourceStore : ResourceStore<byte[]>
     {
-        private readonly IHasRealmFiles source;
+        private readonly IHasNamedFiles source;
 
-        public LegacySkinResourceStore(IHasRealmFiles source, IResourceStore<byte[]> underlyingStore)
+        public LegacySkinResourceStore(IHasNamedFiles source, IResourceStore<byte[]> underlyingStore)
             : base(underlyingStore)
         {
             this.source = source;
@@ -32,7 +32,7 @@ namespace osu.Game.Skinning
         }
 
         private string getPathForFile(string filename) =>
-            source.Files.FirstOrDefault(f => string.Equals(f.Filename, filename, StringComparison.OrdinalIgnoreCase))?.FileInfo.GetStoragePath();
+            source.Files.FirstOrDefault(f => string.Equals(f.Filename, filename, StringComparison.OrdinalIgnoreCase))?.File.GetStoragePath();
 
         public override IEnumerable<string> GetAvailableResources() => source.Files.Select(f => f.Filename);
     }

From 29d074bdb8629ff480207498c0eeec61b010a530 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 29 Nov 2021 18:07:32 +0900
Subject: [PATCH 1364/5547] Implement missing behaviours required for skin file
 operations via `RealmArchiveModelManager`

---
 osu.Game/OsuGameBase.cs                     |  10 +-
 osu.Game/Skinning/SkinManager.cs            | 163 ++++++++-----------
 osu.Game/Skinning/SkinModelManager.cs       | 144 ++++++++++------
 osu.Game/Stores/RealmArchiveModelManager.cs | 172 ++++++++++++++++++++
 4 files changed, 332 insertions(+), 157 deletions(-)
 create mode 100644 osu.Game/Stores/RealmArchiveModelManager.cs

diff --git a/osu.Game/OsuGameBase.cs b/osu.Game/OsuGameBase.cs
index 88c9ab370c..4bae6f3c1d 100644
--- a/osu.Game/OsuGameBase.cs
+++ b/osu.Game/OsuGameBase.cs
@@ -211,17 +211,9 @@ namespace osu.Game
 
             Audio.Samples.PlaybackConcurrency = SAMPLE_CONCURRENCY;
 
-            dependencies.Cache(SkinManager = new SkinManager(Storage, contextFactory, Host, Resources, Audio));
+            dependencies.Cache(SkinManager = new SkinManager(Storage, realmFactory, Host, Resources, Audio, Scheduler));
             dependencies.CacheAs<ISkinSource>(SkinManager);
 
-            // needs to be done here rather than inside SkinManager to ensure thread safety of CurrentSkinInfo.
-            SkinManager.ItemRemoved += item => Schedule(() =>
-            {
-                // check the removed skin is not the current user choice. if it is, switch back to default.
-                if (item.Equals(SkinManager.CurrentSkinInfo.Value))
-                    SkinManager.CurrentSkinInfo.Value = SkinInfo.Default;
-            });
-
             EndpointConfiguration endpoints = UseDevelopmentServer ? (EndpointConfiguration)new DevelopmentEndpointConfiguration() : new ProductionEndpointConfiguration();
 
             MessageFormatter.WebsiteRootUrl = endpoints.WebsiteRootUrl;
diff --git a/osu.Game/Skinning/SkinManager.cs b/osu.Game/Skinning/SkinManager.cs
index 24ec454276..2ec934ac32 100644
--- a/osu.Game/Skinning/SkinManager.cs
+++ b/osu.Game/Skinning/SkinManager.cs
@@ -3,14 +3,10 @@
 
 using System;
 using System.Collections.Generic;
-using System.IO;
 using System.Linq;
 using System.Linq.Expressions;
-using System.Text;
 using System.Threading;
 using System.Threading.Tasks;
-using Microsoft.EntityFrameworkCore;
-using Newtonsoft.Json;
 using osu.Framework.Audio;
 using osu.Framework.Audio.Sample;
 using osu.Framework.Bindables;
@@ -20,6 +16,7 @@ using osu.Framework.Graphics.Textures;
 using osu.Framework.IO.Stores;
 using osu.Framework.Platform;
 using osu.Framework.Testing;
+using osu.Framework.Threading;
 using osu.Framework.Utils;
 using osu.Game.Audio;
 using osu.Game.Database;
@@ -37,7 +34,7 @@ namespace osu.Game.Skinning
     /// For gameplay components, see <see cref="RulesetSkinProvidingContainer"/> which adds extra legacy and toggle logic that may affect the lookup process.
     /// </remarks>
     [ExcludeFromDynamicCompile]
-    public class SkinManager : ISkinSource, IStorageResourceProvider, IModelImporter<SkinInfo>, IModelManager<SkinInfo>
+    public class SkinManager : ISkinSource, IStorageResourceProvider, IModelImporter<SkinInfo>
     {
         private readonly AudioManager audio;
 
@@ -49,8 +46,7 @@ namespace osu.Game.Skinning
         public readonly Bindable<ILive<SkinInfo>> CurrentSkinInfo = new Bindable<ILive<SkinInfo>>(SkinInfo.Default.ToLive()) { Default = SkinInfo.Default.ToLive() };
 
         private readonly SkinModelManager skinModelManager;
-
-        private readonly SkinStore skinStore;
+        private readonly RealmContextFactory contextFactory;
 
         private readonly IResourceStore<byte[]> userFiles;
 
@@ -64,69 +60,73 @@ namespace osu.Game.Skinning
         /// </summary>
         public Skin DefaultLegacySkin { get; }
 
-        public SkinManager(Storage storage, DatabaseContextFactory contextFactory, GameHost host, IResourceStore<byte[]> resources, AudioManager audio)
+        public SkinManager(Storage storage, RealmContextFactory contextFactory, GameHost host, IResourceStore<byte[]> resources, AudioManager audio, Scheduler scheduler)
         {
+            this.contextFactory = contextFactory;
             this.audio = audio;
             this.host = host;
             this.resources = resources;
 
-            skinStore = new SkinStore(contextFactory, storage);
-            userFiles = new FileStore(contextFactory, storage).Store;
+            userFiles = new StorageBackedResourceStore(storage.GetStorageForDirectory("files"));
 
-            skinModelManager = new SkinModelManager(storage, contextFactory, skinStore, host, this);
+            skinModelManager = new SkinModelManager(storage, contextFactory, host, this);
 
             DefaultLegacySkin = new DefaultLegacySkin(this);
             DefaultSkin = new DefaultSkin(this);
 
-            CurrentSkinInfo.ValueChanged += skin => CurrentSkin.Value = GetSkin(skin.NewValue);
+            CurrentSkinInfo.ValueChanged += skin => CurrentSkin.Value = skin.NewValue.PerformRead(GetSkin);
 
             CurrentSkin.Value = DefaultSkin;
             CurrentSkin.ValueChanged += skin =>
             {
-                if (skin.NewValue.SkinInfo != CurrentSkinInfo.Value)
+                if (!skin.NewValue.SkinInfo.Equals(CurrentSkinInfo.Value))
                     throw new InvalidOperationException($"Setting {nameof(CurrentSkin)}'s value directly is not supported. Use {nameof(CurrentSkinInfo)} instead.");
 
                 SourceChanged?.Invoke();
             };
+
+            // needs to be done here rather than inside SkinManager to ensure thread safety of CurrentSkinInfo.
+            ItemRemoved += item => scheduler.Add(() =>
+            {
+                // TODO: fix.
+                // check the removed skin is not the current user choice. if it is, switch back to default.
+                // if (item.Equals(CurrentSkinInfo.Value))
+                //     CurrentSkinInfo.Value = SkinInfo.Default;
+            });
         }
 
         /// <summary>
-        /// Returns a list of all usable <see cref="SkinInfo"/>s. Includes the special default skin plus all skins from <see cref="GetAllUserSkins"/>.
+        /// Returns a list of all usable <see cref="SkinInfo"/>s. Includes the non-databased default skins.
         /// </summary>
         /// <returns>A newly allocated list of available <see cref="SkinInfo"/>.</returns>
-        public List<SkinInfo> GetAllUsableSkins()
+        public List<ILive<SkinInfo>> GetAllUsableSkins()
         {
-            var userSkins = GetAllUserSkins();
-            userSkins.Insert(0, DefaultSkin.SkinInfo);
-            userSkins.Insert(1, DefaultLegacySkin.SkinInfo);
-            return userSkins;
-        }
-
-        /// <summary>
-        /// Returns a list of all usable <see cref="SkinInfo"/>s that have been loaded by the user.
-        /// </summary>
-        /// <returns>A newly allocated list of available <see cref="SkinInfo"/>.</returns>
-        public List<SkinInfo> GetAllUserSkins(bool includeFiles = false)
-        {
-            if (includeFiles)
-                return skinStore.ConsumableItems.Where(s => !s.DeletePending).ToList();
-
-            return skinStore.Items.Where(s => !s.DeletePending).ToList();
+            using (var context = contextFactory.CreateContext())
+            {
+                var userSkins = context.All<SkinInfo>().Where(s => !s.DeletePending).ToLive();
+                userSkins.Insert(0, DefaultSkin.SkinInfo);
+                userSkins.Insert(1, DefaultLegacySkin.SkinInfo);
+                return userSkins;
+            }
         }
 
         public void SelectRandomSkin()
         {
-            // choose from only user skins, removing the current selection to ensure a new one is chosen.
-            var randomChoices = skinStore.Items.Where(s => !s.DeletePending && s.ID != CurrentSkinInfo.Value.ID).ToArray();
-
-            if (randomChoices.Length == 0)
+            using (var context = contextFactory.CreateContext())
             {
-                CurrentSkinInfo.Value = SkinInfo.Default;
-                return;
-            }
+                // choose from only user skins, removing the current selection to ensure a new one is chosen.
+                var randomChoices = context.All<SkinInfo>().Where(s => !s.DeletePending && s.ID != CurrentSkinInfo.Value.ID).ToArray();
 
-            var chosen = randomChoices.ElementAt(RNG.Next(0, randomChoices.Length));
-            CurrentSkinInfo.Value = skinStore.ConsumableItems.Single(i => i.ID == chosen.ID);
+                if (randomChoices.Length == 0)
+                {
+                    CurrentSkinInfo.Value = SkinInfo.Default.ToLive();
+                    return;
+                }
+
+                var chosen = randomChoices.ElementAt(RNG.Next(0, randomChoices.Length));
+
+                CurrentSkinInfo.Value = chosen.ToLive();
+            }
         }
 
         /// <summary>
@@ -142,40 +142,30 @@ namespace osu.Game.Skinning
         /// </summary>
         public void EnsureMutableSkin()
         {
-            if (CurrentSkinInfo.Value.ID >= 1) return;
-
-            var skin = CurrentSkin.Value;
-
-            // if the user is attempting to save one of the default skin implementations, create a copy first.
-            CurrentSkinInfo.Value = skinModelManager.Import(new SkinInfo
+            CurrentSkinInfo.Value.PerformRead(s =>
             {
-                Name = skin.SkinInfo.Name + @" (modified)",
-                Creator = skin.SkinInfo.Creator,
-                InstantiationInfo = skin.SkinInfo.InstantiationInfo,
-            }).Result.Value;
+                if (s.IsManaged)
+                    return;
+
+                // if the user is attempting to save one of the default skin implementations, create a copy first.
+                var result = skinModelManager.Import(new SkinInfo
+                {
+                    Name = s.Name + @" (modified)",
+                    Creator = s.Creator,
+                    InstantiationInfo = s.InstantiationInfo,
+                }).Result;
+
+                if (result != null)
+                    CurrentSkinInfo.Value = result;
+            });
         }
 
         public void Save(Skin skin)
         {
-            if (skin.SkinInfo.ID <= 0)
+            if (!skin.SkinInfo.IsManaged)
                 throw new InvalidOperationException($"Attempting to save a skin which is not yet tracked. Call {nameof(EnsureMutableSkin)} first.");
 
-            foreach (var drawableInfo in skin.DrawableComponentInfo)
-            {
-                string json = JsonConvert.SerializeObject(drawableInfo.Value, new JsonSerializerSettings { Formatting = Formatting.Indented });
-
-                using (var streamContent = new MemoryStream(Encoding.UTF8.GetBytes(json)))
-                {
-                    string filename = @$"{drawableInfo.Key}.json";
-
-                    var oldFile = skin.SkinInfo.Files.FirstOrDefault(f => f.Filename == filename);
-
-                    if (oldFile != null)
-                        skinModelManager.ReplaceFile(skin.SkinInfo, oldFile, streamContent);
-                    else
-                        skinModelManager.AddFile(skin.SkinInfo, streamContent, filename);
-                }
-            }
+            skinModelManager.Save(skin);
         }
 
         /// <summary>
@@ -183,7 +173,11 @@ namespace osu.Game.Skinning
         /// </summary>
         /// <param name="query">The query.</param>
         /// <returns>The first result for the provided query, or null if no results were found.</returns>
-        public SkinInfo Query(Expression<Func<SkinInfo, bool>> query) => skinStore.ConsumableItems.AsNoTracking().FirstOrDefault(query);
+        public ILive<SkinInfo> Query(Expression<Func<SkinInfo, bool>> query)
+        {
+            using (var context = contextFactory.CreateContext())
+                return context.All<SkinInfo>().FirstOrDefault(query)?.ToLive();
+        }
 
         public event Action SourceChanged;
 
@@ -301,34 +295,13 @@ namespace osu.Game.Skinning
             remove => skinModelManager.ItemRemoved -= value;
         }
 
-        public void Update(SkinInfo item)
+        public void Delete(Expression<Func<SkinInfo, bool>> filter, bool silent = false)
         {
-            skinModelManager.Update(item);
-        }
-
-        public bool Delete(SkinInfo item)
-        {
-            return skinModelManager.Delete(item);
-        }
-
-        public void Delete(List<SkinInfo> items, bool silent = false)
-        {
-            skinModelManager.Delete(items, silent);
-        }
-
-        public void Undelete(List<SkinInfo> items, bool silent = false)
-        {
-            skinModelManager.Undelete(items, silent);
-        }
-
-        public void Undelete(SkinInfo item)
-        {
-            skinModelManager.Undelete(item);
-        }
-
-        public bool IsAvailableLocally(SkinInfo model)
-        {
-            return skinModelManager.IsAvailableLocally(model);
+            using (var context = contextFactory.CreateContext())
+            {
+                var items = context.All<SkinInfo>().Where(filter).ToList();
+                skinModelManager.Delete(items, silent);
+            }
         }
 
         #endregion
diff --git a/osu.Game/Skinning/SkinModelManager.cs b/osu.Game/Skinning/SkinModelManager.cs
index 572ae5cbfc..059345f9bc 100644
--- a/osu.Game/Skinning/SkinModelManager.cs
+++ b/osu.Game/Skinning/SkinModelManager.cs
@@ -8,21 +8,26 @@ using System.Linq;
 using System.Text;
 using System.Threading;
 using System.Threading.Tasks;
+using Newtonsoft.Json;
 using osu.Framework.Logging;
 using osu.Framework.Platform;
 using osu.Game.Database;
 using osu.Game.Extensions;
 using osu.Game.IO;
 using osu.Game.IO.Archives;
+using osu.Game.Stores;
+using Realms;
+
+#nullable enable
 
 namespace osu.Game.Skinning
 {
-    public class SkinModelManager : ArchiveModelManager<SkinInfo, SkinFileInfo>
+    public class SkinModelManager : RealmArchiveModelManager<SkinInfo>
     {
         private readonly IStorageResourceProvider skinResources;
 
-        public SkinModelManager(Storage storage, DatabaseContextFactory contextFactory, SkinStore skinStore, GameHost host, IStorageResourceProvider skinResources)
-            : base(storage, contextFactory, skinStore, host)
+        public SkinModelManager(Storage storage, RealmContextFactory contextFactory, GameHost host, IStorageResourceProvider skinResources)
+            : base(storage, contextFactory)
         {
             this.skinResources = skinResources;
 
@@ -42,18 +47,27 @@ namespace osu.Game.Skinning
 
         protected override bool HasCustomHashFunction => true;
 
-        protected override string ComputeHash(SkinInfo item)
+        protected override Task Populate(SkinInfo model, ArchiveReader? archive, Realm realm, CancellationToken cancellationToken = default)
+        {
+            if (string.IsNullOrEmpty(model.InstantiationInfo))
+                model.InstantiationInfo = createInstance(model).GetType().GetInvariantInstantiationInfo();
+
+            checkSkinIniMetadata(model, realm);
+
+            return Task.CompletedTask;
+        }
+
+        private void checkSkinIniMetadata(SkinInfo item, Realm realm)
         {
             var instance = createInstance(item);
 
             // This function can be run on fresh import or save. The logic here ensures a skin.ini file is in a good state for both operations.
-
             // `Skin` will parse the skin.ini and populate `Skin.Configuration` during construction above.
             string skinIniSourcedName = instance.Configuration.SkinInfo.Name;
             string skinIniSourcedCreator = instance.Configuration.SkinInfo.Creator;
             string archiveName = item.Name.Replace(@".osk", string.Empty, StringComparison.OrdinalIgnoreCase);
 
-            bool isImport = item.ID == 0;
+            bool isImport = !item.IsManaged;
 
             if (isImport)
             {
@@ -71,12 +85,10 @@ namespace osu.Game.Skinning
             // Regardless of whether this is an import or not, let's write the skin.ini if non-existing or non-matching.
             // This is (weirdly) done inside ComputeHash to avoid adding a new method to handle this case. After switching to realm it can be moved into another place.
             if (skinIniSourcedName != item.Name)
-                updateSkinIniMetadata(item);
-
-            return base.ComputeHash(item);
+                updateSkinIniMetadata(item, realm);
         }
 
-        private void updateSkinIniMetadata(SkinInfo item)
+        private void updateSkinIniMetadata(SkinInfo item, Realm realm)
         {
             string nameLine = @$"Name: {item.Name}";
             string authorLine = @$"Author: {item.Creator}";
@@ -95,39 +107,47 @@ namespace osu.Game.Skinning
             {
                 // In the case a skin doesn't have a skin.ini yet, let's create one.
                 writeNewSkinIni();
-                return;
             }
-
-            using (Stream stream = new MemoryStream())
+            else
             {
-                using (var sw = new StreamWriter(stream, Encoding.UTF8, 1024, true))
+                using (Stream stream = new MemoryStream())
                 {
-                    using (var existingStream = Files.Storage.GetStream(existingFile.FileInfo.GetStoragePath()))
-                    using (var sr = new StreamReader(existingStream))
+                    using (var sw = new StreamWriter(stream, Encoding.UTF8, 1024, true))
                     {
-                        string line;
-                        while ((line = sr.ReadLine()) != null)
+                        using (var existingStream = Files.Storage.GetStream(existingFile.File.GetStoragePath()))
+                        using (var sr = new StreamReader(existingStream))
+                        {
+                            string? line;
+                            while ((line = sr.ReadLine()) != null)
+                                sw.WriteLine(line);
+                        }
+
+                        sw.WriteLine();
+
+                        foreach (string line in newLines)
                             sw.WriteLine(line);
                     }
 
-                    sw.WriteLine();
+                    ReplaceFile(item, existingFile, stream, realm);
 
-                    foreach (string line in newLines)
-                        sw.WriteLine(line);
-                }
+                    // can be removed 20220502.
+                    if (!ensureIniWasUpdated(item))
+                    {
+                        Logger.Log($"Skin {item}'s skin.ini had issues and has been removed. Please report this and provide the problematic skin.", LoggingTarget.Database, LogLevel.Important);
 
-                ReplaceFile(item, existingFile, stream);
+                        var existingIni = item.Files.SingleOrDefault(f => f.Filename.Equals(@"skin.ini", StringComparison.OrdinalIgnoreCase));
+                        if (existingIni != null)
+                            item.Files.Remove(existingIni);
 
-                // can be removed 20220502.
-                if (!ensureIniWasUpdated(item))
-                {
-                    Logger.Log($"Skin {item}'s skin.ini had issues and has been removed. Please report this and provide the problematic skin.", LoggingTarget.Database, LogLevel.Important);
-
-                    DeleteFile(item, item.Files.SingleOrDefault(f => f.Filename.Equals(@"skin.ini", StringComparison.OrdinalIgnoreCase)));
-                    writeNewSkinIni();
+                        writeNewSkinIni();
+                    }
                 }
             }
 
+            // The hash is already populated at this point in import.
+            // As we have changed files, it needs to be recomputed.
+            item.Hash = ComputeHash(item);
+
             void writeNewSkinIni()
             {
                 using (Stream stream = new MemoryStream())
@@ -138,8 +158,10 @@ namespace osu.Game.Skinning
                             sw.WriteLine(line);
                     }
 
-                    AddFile(item, stream, @"skin.ini");
+                    AddFile(item, stream, @"skin.ini", realm);
                 }
+
+                item.Hash = ComputeHash(item);
             }
         }
 
@@ -154,36 +176,52 @@ namespace osu.Game.Skinning
             return instance.Configuration.SkinInfo.Name == item.Name;
         }
 
-        protected override Task Populate(SkinInfo model, ArchiveReader archive, CancellationToken cancellationToken = default)
-        {
-            var instance = createInstance(model);
-
-            model.InstantiationInfo ??= instance.GetType().GetInvariantInstantiationInfo();
-
-            model.Name = instance.Configuration.SkinInfo.Name;
-            model.Creator = instance.Configuration.SkinInfo.Creator;
-
-            return Task.CompletedTask;
-        }
-
         private void populateMissingHashes()
         {
-            var skinsWithoutHashes = ModelStore.ConsumableItems.Where(i => i.Hash == null).ToArray();
-
-            foreach (SkinInfo skin in skinsWithoutHashes)
+            using (var realm = ContextFactory.CreateContext())
             {
-                try
+                var skinsWithoutHashes = realm.All<SkinInfo>().Where(i => string.IsNullOrEmpty(i.Hash)).ToArray();
+
+                foreach (SkinInfo skin in skinsWithoutHashes)
                 {
-                    Update(skin);
-                }
-                catch (Exception e)
-                {
-                    Delete(skin);
-                    Logger.Error(e, $"Existing skin {skin} has been deleted during hash recomputation due to being invalid");
+                    try
+                    {
+                        Update(skin);
+                    }
+                    catch (Exception e)
+                    {
+                        Delete(skin);
+                        Logger.Error(e, $"Existing skin {skin} has been deleted during hash recomputation due to being invalid");
+                    }
                 }
             }
         }
 
         private Skin createInstance(SkinInfo item) => item.CreateInstance(skinResources);
+
+        public void Save(Skin skin)
+        {
+            skin.SkinInfo.PerformWrite(s =>
+            {
+                foreach (var drawableInfo in skin.DrawableComponentInfo)
+                {
+                    string json = JsonConvert.SerializeObject(drawableInfo.Value, new JsonSerializerSettings { Formatting = Formatting.Indented });
+
+                    using (var streamContent = new MemoryStream(Encoding.UTF8.GetBytes(json)))
+                    {
+                        string filename = @$"{drawableInfo.Key}.json";
+
+                        var oldFile = s.Files.FirstOrDefault(f => f.Filename == filename);
+
+                        if (oldFile != null)
+                            ReplaceFile(s, oldFile, streamContent, s.Realm);
+                        else
+                            AddFile(s, streamContent, filename, s.Realm);
+                    }
+                }
+
+                s.Hash = ComputeHash(s);
+            });
+        }
     }
 }
diff --git a/osu.Game/Stores/RealmArchiveModelManager.cs b/osu.Game/Stores/RealmArchiveModelManager.cs
new file mode 100644
index 0000000000..14b7077dd2
--- /dev/null
+++ b/osu.Game/Stores/RealmArchiveModelManager.cs
@@ -0,0 +1,172 @@
+// 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 System.Threading;
+using System.Threading.Tasks;
+using osu.Framework.Platform;
+using osu.Game.Database;
+using osu.Game.IO.Archives;
+using osu.Game.Models;
+using osu.Game.Overlays.Notifications;
+using Realms;
+
+#nullable enable
+
+namespace osu.Game.Stores
+{
+    /// <summary>
+    /// Class which adds all the missing pieces bridging the gap between <see cref="RealmArchiveModelImporter{TModel}"/> and <see cref="ArchiveModelManager{TModel,TFileModel}"/>.
+    /// </summary>
+    public abstract class RealmArchiveModelManager<TModel> : RealmArchiveModelImporter<TModel>, IModelManager<TModel>, IModelFileManager<TModel, RealmNamedFileUsage>
+        where TModel : RealmObject, IHasRealmFiles, IHasGuidPrimaryKey, ISoftDelete
+    {
+        public event Action<TModel>? ItemUpdated;
+        public event Action<TModel>? ItemRemoved;
+
+        private readonly RealmFileStore realmFileStore;
+
+        protected RealmArchiveModelManager(Storage storage, RealmContextFactory contextFactory)
+            : base(storage, contextFactory)
+        {
+            realmFileStore = new RealmFileStore(contextFactory, storage);
+        }
+
+        public void DeleteFile(TModel item, RealmNamedFileUsage file) =>
+            item.Realm.Write(() => DeleteFile(item, file, item.Realm));
+
+        public void ReplaceFile(TModel item, RealmNamedFileUsage file, Stream contents)
+            => item.Realm.Write(() => ReplaceFile(item, file, contents, item.Realm));
+
+        public void AddFile(TModel item, Stream stream, string filename)
+            => item.Realm.Write(() => AddFile(item, stream, filename, item.Realm));
+
+        public void DeleteFile(TModel item, RealmNamedFileUsage file, Realm realm)
+        {
+            item.Files.Remove(file);
+        }
+
+        public void ReplaceFile(TModel model, RealmNamedFileUsage file, Stream contents, Realm realm)
+        {
+            file.File = realmFileStore.Add(contents, realm);
+        }
+
+        public void AddFile(TModel item, Stream stream, string filename, Realm realm)
+        {
+            var file = realmFileStore.Add(stream, realm);
+            var namedUsage = new RealmNamedFileUsage(file, filename);
+
+            item.Files.Add(namedUsage);
+        }
+
+        public override async Task<ILive<TModel>?> Import(TModel item, ArchiveReader? archive = null, bool lowPriority = false, CancellationToken cancellationToken = default)
+        {
+            var imported = await base.Import(item, archive, lowPriority, cancellationToken).ConfigureAwait(false);
+
+            imported?.PerformRead(i => ItemUpdated?.Invoke(i.Detach()));
+
+            return imported;
+        }
+
+        /// <summary>
+        /// Delete multiple items.
+        /// This will post notifications tracking progress.
+        /// </summary>
+        public void Delete(List<TModel> items, bool silent = false)
+        {
+            if (items.Count == 0) return;
+
+            var notification = new ProgressNotification
+            {
+                Progress = 0,
+                Text = $"Preparing to delete all {HumanisedModelName}s...",
+                CompletionText = $"Deleted all {HumanisedModelName}s!",
+                State = ProgressNotificationState.Active,
+            };
+
+            if (!silent)
+                PostNotification?.Invoke(notification);
+
+            int i = 0;
+
+            foreach (var b in items)
+            {
+                if (notification.State == ProgressNotificationState.Cancelled)
+                    // user requested abort
+                    return;
+
+                notification.Text = $"Deleting {HumanisedModelName}s ({++i} of {items.Count})";
+
+                Delete(b);
+
+                notification.Progress = (float)i / items.Count;
+            }
+
+            notification.State = ProgressNotificationState.Completed;
+        }
+
+        /// <summary>
+        /// Restore multiple items that were previously deleted.
+        /// This will post notifications tracking progress.
+        /// </summary>
+        public void Undelete(List<TModel> items, bool silent = false)
+        {
+            if (!items.Any()) return;
+
+            var notification = new ProgressNotification
+            {
+                CompletionText = "Restored all deleted items!",
+                Progress = 0,
+                State = ProgressNotificationState.Active,
+            };
+
+            if (!silent)
+                PostNotification?.Invoke(notification);
+
+            int i = 0;
+
+            foreach (var item in items)
+            {
+                if (notification.State == ProgressNotificationState.Cancelled)
+                    // user requested abort
+                    return;
+
+                notification.Text = $"Restoring ({++i} of {items.Count})";
+
+                Undelete(item);
+
+                notification.Progress = (float)i / items.Count;
+            }
+
+            notification.State = ProgressNotificationState.Completed;
+        }
+
+        public bool Delete(TModel item)
+        {
+            if (item.DeletePending)
+                return false;
+
+            item.Realm.Write(r => item.DeletePending = true);
+            ItemRemoved?.Invoke(item.Detach());
+            return true;
+        }
+
+        public void Undelete(TModel item)
+        {
+            if (!item.DeletePending)
+                return;
+
+            item.Realm.Write(r => item.DeletePending = false);
+            ItemUpdated?.Invoke(item);
+        }
+
+        public virtual bool IsAvailableLocally(TModel model) => false; // TODO: implement
+
+        public void Update(TModel skin)
+        {
+        }
+    }
+}

From c629a7a36fe1acdd9e1143fb9c6692b5152c38a3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 29 Nov 2021 16:18:34 +0900
Subject: [PATCH 1365/5547] Fix random selection and avoid using legacy events
 for handling skin import/deletion

---
 .../Overlays/Settings/Sections/SkinSection.cs | 95 +++++++++----------
 osu.Game/Skinning/SkinManager.cs              | 33 +++----
 osu.Game/Stores/RealmArchiveModelManager.cs   | 27 ++++--
 3 files changed, 73 insertions(+), 82 deletions(-)

diff --git a/osu.Game/Overlays/Settings/Sections/SkinSection.cs b/osu.Game/Overlays/Settings/Sections/SkinSection.cs
index 9c5a2dff47..88f60a6004 100644
--- a/osu.Game/Overlays/Settings/Sections/SkinSection.cs
+++ b/osu.Game/Overlays/Settings/Sections/SkinSection.cs
@@ -18,6 +18,7 @@ using osu.Game.Graphics.UserInterface;
 using osu.Game.Localisation;
 using osu.Game.Skinning;
 using osu.Game.Skinning.Editor;
+using Realms;
 
 namespace osu.Game.Overlays.Settings.Sections
 {
@@ -43,21 +44,15 @@ namespace osu.Game.Overlays.Settings.Sections
 
         private List<ILive<SkinInfo>> skinItems;
 
-        private int firstNonDefaultSkinIndex
-        {
-            get
-            {
-                int index = skinItems.FindIndex(s => s.ID == SkinInfo.CLASSIC_SKIN);
-                if (index < 0)
-                    index = skinItems.Count;
-
-                return index;
-            }
-        }
-
         [Resolved]
         private SkinManager skins { get; set; }
 
+        [Resolved]
+        private RealmContextFactory realmFactory { get; set; }
+
+        private IDisposable realmSubscription;
+        private IQueryable<SkinInfo> realmSkins;
+
         [BackgroundDependencyLoader(permitNulls: true)]
         private void load(OsuConfigManager config, [CanBeNull] SkinEditorOverlay skinEditor)
         {
@@ -75,9 +70,6 @@ namespace osu.Game.Overlays.Settings.Sections
                 new ExportSkinButton(),
             };
 
-            skins.ItemUpdated += itemUpdated;
-            skins.ItemRemoved += itemRemoved;
-
             config.BindWith(OsuSetting.Skin, configBindable);
         }
 
@@ -86,6 +78,21 @@ namespace osu.Game.Overlays.Settings.Sections
             base.LoadComplete();
 
             skinDropdown.Current = dropdownBindable;
+
+            realmSkins = realmFactory.Context.All<SkinInfo>()
+                                     .Where(s => !s.DeletePending)
+                                     .OrderBy(s => s.Name, StringComparer.OrdinalIgnoreCase);
+
+            realmSubscription = realmSkins
+                .SubscribeForNotifications((sender, changes, error) =>
+                {
+                    if (changes == null)
+                        return;
+
+                    // Eventually this should be handling the individual changes rather than refreshing the whole dropdown.
+                    updateItems();
+                });
+
             updateItems();
 
             // Todo: This should not be necessary when OsuConfigManager is databased
@@ -97,7 +104,16 @@ namespace osu.Game.Overlays.Settings.Sections
             {
                 if (skin.NewValue.Equals(random_skin_info))
                 {
+                    var skinBefore = skins.CurrentSkinInfo.Value;
+
                     skins.SelectRandomSkin();
+
+                    if (skinBefore == skins.CurrentSkinInfo.Value)
+                    {
+                        // the random selection didn't change the skin, so we should manually update the dropdown to match.
+                        dropdownBindable.Value = skins.CurrentSkinInfo.Value;
+                    }
+
                     return;
                 }
 
@@ -111,12 +127,13 @@ namespace osu.Game.Overlays.Settings.Sections
 
             var skin = skinDropdown.Items.FirstOrDefault(s => s.ID == configId);
 
+            // TODO: i don't think this will be required any more.
             if (skin == null)
             {
                 // there may be a thread race condition where an item is selected that hasn't yet been added to the dropdown.
                 // to avoid adding complexity, let's just ensure the item is added so we can perform the selection.
                 skin = skins.Query(s => s.ID == configId);
-                addItem(skin);
+                updateItems();
             }
 
             dropdownBindable.Value = skin;
@@ -124,47 +141,20 @@ namespace osu.Game.Overlays.Settings.Sections
 
         private void updateItems()
         {
-            skinItems = skins.GetAllUsableSkins();
-            skinItems.Insert(firstNonDefaultSkinIndex, random_skin_info);
-            sortUserSkins(skinItems);
+            skinItems = realmSkins.ToLive();
+
+            skinItems.Insert(0, SkinInfo.Default.ToLive());
+            skinItems.Insert(1, DefaultLegacySkin.Info.ToLive());
+            skinItems.Insert(2, random_skin_info);
+
             skinDropdown.Items = skinItems;
         }
 
-        private void itemUpdated(SkinInfo item) => Schedule(() => addItem(item.ToLive()));
-
-        private void addItem(ILive<SkinInfo> item)
-        {
-            List<ILive<SkinInfo>> newDropdownItems = skinDropdown.Items.Where(i => !i.Equals(item)).Append(item).ToList();
-            sortUserSkins(newDropdownItems);
-            skinDropdown.Items = newDropdownItems;
-        }
-
-        private void itemRemoved(SkinInfo item) => Schedule(() => skinDropdown.Items = skinDropdown.Items.Where(i => !i.ID.Equals(item.ID)).ToArray());
-
-        private void sortUserSkins(List<ILive<SkinInfo>> skinsList)
-        {
-            try
-            {
-                // Sort user skins separately from built-in skins
-                skinsList.Sort(firstNonDefaultSkinIndex, skinsList.Count - firstNonDefaultSkinIndex,
-                    Comparer<ILive<SkinInfo>>.Create((a, b) =>
-                    {
-                        // o_________________________o
-                        return a.PerformRead(ai => b.PerformRead(bi => string.Compare(ai.Name, bi.Name, StringComparison.OrdinalIgnoreCase)));
-                    }));
-            }
-            catch { }
-        }
-
         protected override void Dispose(bool isDisposing)
         {
             base.Dispose(isDisposing);
 
-            if (skins != null)
-            {
-                skins.ItemUpdated -= itemUpdated;
-                skins.ItemRemoved -= itemRemoved;
-            }
+            realmSubscription?.Dispose();
         }
 
         private class SkinSettingsDropdown : SettingsDropdown<ILive<SkinInfo>>
@@ -192,6 +182,11 @@ namespace osu.Game.Overlays.Settings.Sections
             {
                 Text = SkinSettingsStrings.ExportSkinButton;
                 Action = export;
+            }
+
+            protected override void LoadComplete()
+            {
+                base.LoadComplete();
 
                 currentSkin = skins.CurrentSkin.GetBoundCopy();
                 currentSkin.BindValueChanged(skin => Enabled.Value = skin.NewValue.SkinInfo.PerformRead(s => s.IsManaged), true);
diff --git a/osu.Game/Skinning/SkinManager.cs b/osu.Game/Skinning/SkinManager.cs
index 2ec934ac32..bcad5277ab 100644
--- a/osu.Game/Skinning/SkinManager.cs
+++ b/osu.Game/Skinning/SkinManager.cs
@@ -38,6 +38,8 @@ namespace osu.Game.Skinning
     {
         private readonly AudioManager audio;
 
+        private readonly Scheduler scheduler;
+
         private readonly GameHost host;
 
         private readonly IResourceStore<byte[]> resources;
@@ -64,6 +66,7 @@ namespace osu.Game.Skinning
         {
             this.contextFactory = contextFactory;
             this.audio = audio;
+            this.scheduler = scheduler;
             this.host = host;
             this.resources = resources;
 
@@ -84,15 +87,6 @@ namespace osu.Game.Skinning
 
                 SourceChanged?.Invoke();
             };
-
-            // needs to be done here rather than inside SkinManager to ensure thread safety of CurrentSkinInfo.
-            ItemRemoved += item => scheduler.Add(() =>
-            {
-                // TODO: fix.
-                // check the removed skin is not the current user choice. if it is, switch back to default.
-                // if (item.Equals(CurrentSkinInfo.Value))
-                //     CurrentSkinInfo.Value = SkinInfo.Default;
-            });
         }
 
         /// <summary>
@@ -283,23 +277,18 @@ namespace osu.Game.Skinning
 
         #region Implementation of IModelManager<SkinInfo>
 
-        public event Action<SkinInfo> ItemUpdated
-        {
-            add => skinModelManager.ItemUpdated += value;
-            remove => skinModelManager.ItemUpdated -= value;
-        }
-
-        public event Action<SkinInfo> ItemRemoved
-        {
-            add => skinModelManager.ItemRemoved += value;
-            remove => skinModelManager.ItemRemoved -= value;
-        }
-
-        public void Delete(Expression<Func<SkinInfo, bool>> filter, bool silent = false)
+        public void Delete([CanBeNull] Expression<Func<SkinInfo, bool>> filter = null, bool silent = false)
         {
             using (var context = contextFactory.CreateContext())
             {
                 var items = context.All<SkinInfo>().Where(filter).ToList();
+
+                // check the removed skin is not the current user choice. if it is, switch back to default.
+                Guid currentUserSkin = CurrentSkinInfo.Value.ID;
+
+                if (items.Any(s => s.ID == currentUserSkin))
+                    scheduler.Add(() => CurrentSkinInfo.Value = SkinInfo.Default.ToLive());
+
                 skinModelManager.Delete(items, silent);
             }
         }
diff --git a/osu.Game/Stores/RealmArchiveModelManager.cs b/osu.Game/Stores/RealmArchiveModelManager.cs
index 14b7077dd2..ae40bcac79 100644
--- a/osu.Game/Stores/RealmArchiveModelManager.cs
+++ b/osu.Game/Stores/RealmArchiveModelManager.cs
@@ -24,8 +24,21 @@ namespace osu.Game.Stores
     public abstract class RealmArchiveModelManager<TModel> : RealmArchiveModelImporter<TModel>, IModelManager<TModel>, IModelFileManager<TModel, RealmNamedFileUsage>
         where TModel : RealmObject, IHasRealmFiles, IHasGuidPrimaryKey, ISoftDelete
     {
-        public event Action<TModel>? ItemUpdated;
-        public event Action<TModel>? ItemRemoved;
+        public event Action<TModel>? ItemUpdated
+        {
+            // This may be brought back for beatmaps to ease integration.
+            // The eventual goal would be not requiring this and using realm subscriptions in its place.
+            add => throw new NotImplementedException();
+            remove => throw new NotImplementedException();
+        }
+
+        public event Action<TModel>? ItemRemoved
+        {
+            // This may be brought back for beatmaps to ease integration.
+            // The eventual goal would be not requiring this and using realm subscriptions in its place.
+            add => throw new NotImplementedException();
+            remove => throw new NotImplementedException();
+        }
 
         private readonly RealmFileStore realmFileStore;
 
@@ -64,11 +77,7 @@ namespace osu.Game.Stores
 
         public override async Task<ILive<TModel>?> Import(TModel item, ArchiveReader? archive = null, bool lowPriority = false, CancellationToken cancellationToken = default)
         {
-            var imported = await base.Import(item, archive, lowPriority, cancellationToken).ConfigureAwait(false);
-
-            imported?.PerformRead(i => ItemUpdated?.Invoke(i.Detach()));
-
-            return imported;
+            return await base.Import(item, archive, lowPriority, cancellationToken).ConfigureAwait(false);
         }
 
         /// <summary>
@@ -150,7 +159,6 @@ namespace osu.Game.Stores
                 return false;
 
             item.Realm.Write(r => item.DeletePending = true);
-            ItemRemoved?.Invoke(item.Detach());
             return true;
         }
 
@@ -160,10 +168,9 @@ namespace osu.Game.Stores
                 return;
 
             item.Realm.Write(r => item.DeletePending = false);
-            ItemUpdated?.Invoke(item);
         }
 
-        public virtual bool IsAvailableLocally(TModel model) => false; // TODO: implement
+        public virtual bool IsAvailableLocally(TModel model) => false; // Not relevant for skins since they can't be downloaded yet.
 
         public void Update(TModel skin)
         {

From f6a3709060b3ba4d81ce4f9d01df52aba7fa18dd Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 29 Nov 2021 17:15:26 +0900
Subject: [PATCH 1366/5547] Store default skins to database

---
 .../TestSceneHyperDashColouring.cs            |  2 +-
 .../Editor/TestSceneManiaComposeScreen.cs     |  4 +-
 .../TestSceneSliderApplication.cs             |  2 +-
 .../Gameplay/TestSceneStoryboardSamples.cs    |  2 +-
 .../Gameplay/TestSceneBeatmapSkinFallbacks.cs |  2 +-
 osu.Game/OsuGame.cs                           |  6 +--
 .../Overlays/Settings/Sections/SkinSection.cs | 11 ++---
 osu.Game/Skinning/DefaultLegacySkin.cs        | 19 ++++----
 osu.Game/Skinning/DefaultSkin.cs              | 11 ++++-
 osu.Game/Skinning/SkinInfo.cs                 | 11 +----
 osu.Game/Skinning/SkinManager.cs              | 43 +++++++++++--------
 11 files changed, 61 insertions(+), 52 deletions(-)

diff --git a/osu.Game.Rulesets.Catch.Tests/TestSceneHyperDashColouring.cs b/osu.Game.Rulesets.Catch.Tests/TestSceneHyperDashColouring.cs
index 70b2c8c82a..14a4d02396 100644
--- a/osu.Game.Rulesets.Catch.Tests/TestSceneHyperDashColouring.cs
+++ b/osu.Game.Rulesets.Catch.Tests/TestSceneHyperDashColouring.cs
@@ -174,7 +174,7 @@ namespace osu.Game.Rulesets.Catch.Tests
 
         private Drawable setupSkinHierarchy(Drawable child, ISkin skin)
         {
-            var legacySkinProvider = new SkinProvidingContainer(skins.GetSkin(DefaultLegacySkin.Info));
+            var legacySkinProvider = new SkinProvidingContainer(skins.GetSkin(DefaultLegacySkin.CreateInfo()));
             var testSkinProvider = new SkinProvidingContainer(skin);
             var legacySkinTransformer = new SkinProvidingContainer(new CatchLegacySkinTransformer(testSkinProvider));
 
diff --git a/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneManiaComposeScreen.cs b/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneManiaComposeScreen.cs
index a7e76e44b5..91f5f93905 100644
--- a/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneManiaComposeScreen.cs
+++ b/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneManiaComposeScreen.cs
@@ -56,13 +56,13 @@ namespace osu.Game.Rulesets.Mania.Tests.Editor
         [Test]
         public void TestDefaultSkin()
         {
-            AddStep("set default skin", () => skins.CurrentSkinInfo.Value = SkinInfo.Default.ToLive());
+            AddStep("set default skin", () => skins.CurrentSkinInfo.Value = DefaultSkin.CreateInfo().ToLive());
         }
 
         [Test]
         public void TestLegacySkin()
         {
-            AddStep("set legacy skin", () => skins.CurrentSkinInfo.Value = DefaultLegacySkin.Info.ToLive());
+            AddStep("set legacy skin", () => skins.CurrentSkinInfo.Value = DefaultLegacySkin.CreateInfo().ToLive());
         }
     }
 }
diff --git a/osu.Game.Rulesets.Osu.Tests/TestSceneSliderApplication.cs b/osu.Game.Rulesets.Osu.Tests/TestSceneSliderApplication.cs
index e698766aac..d673b7a6ac 100644
--- a/osu.Game.Rulesets.Osu.Tests/TestSceneSliderApplication.cs
+++ b/osu.Game.Rulesets.Osu.Tests/TestSceneSliderApplication.cs
@@ -67,7 +67,7 @@ namespace osu.Game.Rulesets.Osu.Tests
 
             AddStep("create slider", () =>
             {
-                var tintingSkin = skinManager.GetSkin(DefaultLegacySkin.Info);
+                var tintingSkin = skinManager.GetSkin(DefaultLegacySkin.CreateInfo());
                 tintingSkin.Configuration.ConfigDictionary["AllowSliderBallTint"] = "1";
 
                 Child = new SkinProvidingContainer(tintingSkin)
diff --git a/osu.Game.Tests/Gameplay/TestSceneStoryboardSamples.cs b/osu.Game.Tests/Gameplay/TestSceneStoryboardSamples.cs
index 3bf6aaac7a..88f35976ad 100644
--- a/osu.Game.Tests/Gameplay/TestSceneStoryboardSamples.cs
+++ b/osu.Game.Tests/Gameplay/TestSceneStoryboardSamples.cs
@@ -167,7 +167,7 @@ namespace osu.Game.Tests.Gameplay
         private class TestSkin : LegacySkin
         {
             public TestSkin(string resourceName, IStorageResourceProvider resources)
-                : base(DefaultLegacySkin.Info, new TestResourceStore(resourceName), resources, "skin.ini")
+                : base(DefaultLegacySkin.CreateInfo(), new TestResourceStore(resourceName), resources, "skin.ini")
             {
             }
         }
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneBeatmapSkinFallbacks.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneBeatmapSkinFallbacks.cs
index c174a3edc2..cccc962a3f 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneBeatmapSkinFallbacks.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneBeatmapSkinFallbacks.cs
@@ -42,7 +42,7 @@ namespace osu.Game.Tests.Visual.Gameplay
         [Test]
         public void TestEmptyLegacyBeatmapSkinFallsBack()
         {
-            CreateSkinTest(SkinInfo.Default, () => new LegacyBeatmapSkin(new BeatmapInfo(), null, null));
+            CreateSkinTest(DefaultSkin.CreateInfo(), () => new LegacyBeatmapSkin(new BeatmapInfo(), null, null));
             AddUntilStep("wait for hud load", () => Player.ChildrenOfType<SkinnableTargetContainer>().All(c => c.ComponentsLoaded));
             AddAssert("hud from default skin", () => AssertComponentsFromExpectedSource(SkinnableTarget.MainHUDComponents, skinManager.CurrentSkin.Value));
         }
diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index 1ffbb4cb85..8af76c1289 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -256,10 +256,10 @@ namespace osu.Game
                 if (skinInfo == null)
                 {
                     if (guid == SkinInfo.CLASSIC_SKIN)
-                        skinInfo = DefaultLegacySkin.Info.ToLive();
+                        skinInfo = DefaultLegacySkin.CreateInfo().ToLive();
                 }
 
-                SkinManager.CurrentSkinInfo.Value = skinInfo ?? SkinInfo.Default.ToLive();
+                SkinManager.CurrentSkinInfo.Value = skinInfo ?? DefaultSkin.CreateInfo().ToLive();
             };
             configSkin.TriggerChange();
 
@@ -660,7 +660,7 @@ namespace osu.Game
 
             // make config aware of how to lookup skins for on-screen display purposes.
             // if this becomes a more common thing, tracked settings should be reconsidered to allow local DI.
-            LocalConfig.LookupSkinName = id => SkinManager.GetAllUsableSkins().FirstOrDefault(s => s.ID == id)?.ToString() ?? "Unknown";
+            LocalConfig.LookupSkinName = id => SkinManager.Query(s => s.ID == id)?.ToString() ?? "Unknown";
 
             LocalConfig.LookupKeyBindings = l =>
             {
diff --git a/osu.Game/Overlays/Settings/Sections/SkinSection.cs b/osu.Game/Overlays/Settings/Sections/SkinSection.cs
index 88f60a6004..bf0f6bf142 100644
--- a/osu.Game/Overlays/Settings/Sections/SkinSection.cs
+++ b/osu.Game/Overlays/Settings/Sections/SkinSection.cs
@@ -33,7 +33,7 @@ namespace osu.Game.Overlays.Settings.Sections
             Icon = FontAwesome.Solid.PaintBrush
         };
 
-        private readonly Bindable<ILive<SkinInfo>> dropdownBindable = new Bindable<ILive<SkinInfo>> { Default = SkinInfo.Default.ToLive() };
+        private readonly Bindable<ILive<SkinInfo>> dropdownBindable = new Bindable<ILive<SkinInfo>> { Default = DefaultSkin.CreateInfo().ToLive() };
         private readonly Bindable<string> configBindable = new Bindable<string>();
 
         private static readonly ILive<SkinInfo> random_skin_info = new SkinInfo
@@ -81,7 +81,8 @@ namespace osu.Game.Overlays.Settings.Sections
 
             realmSkins = realmFactory.Context.All<SkinInfo>()
                                      .Where(s => !s.DeletePending)
-                                     .OrderBy(s => s.Name, StringComparer.OrdinalIgnoreCase);
+                                     .OrderBy(s => s.Protected)
+                                     .ThenBy(s => s.Name, StringComparer.OrdinalIgnoreCase);
 
             realmSubscription = realmSkins
                 .SubscribeForNotifications((sender, changes, error) =>
@@ -141,11 +142,11 @@ namespace osu.Game.Overlays.Settings.Sections
 
         private void updateItems()
         {
+            int protectedCount = realmSkins.Count(s => s.Protected);
+
             skinItems = realmSkins.ToLive();
 
-            skinItems.Insert(0, SkinInfo.Default.ToLive());
-            skinItems.Insert(1, DefaultLegacySkin.Info.ToLive());
-            skinItems.Insert(2, random_skin_info);
+            skinItems.Insert(protectedCount, random_skin_info);
 
             skinDropdown.Items = skinItems;
         }
diff --git a/osu.Game/Skinning/DefaultLegacySkin.cs b/osu.Game/Skinning/DefaultLegacySkin.cs
index 2332e6e160..c7033d37dc 100644
--- a/osu.Game/Skinning/DefaultLegacySkin.cs
+++ b/osu.Game/Skinning/DefaultLegacySkin.cs
@@ -12,8 +12,17 @@ namespace osu.Game.Skinning
 {
     public class DefaultLegacySkin : LegacySkin
     {
+        public static SkinInfo CreateInfo() => new SkinInfo
+        {
+            ID = Skinning.SkinInfo.CLASSIC_SKIN, // this is temporary until database storage is decided upon.
+            Name = "osu!classic",
+            Creator = "team osu!",
+            Protected = true,
+            InstantiationInfo = typeof(DefaultLegacySkin).GetInvariantInstantiationInfo()
+        };
+
         public DefaultLegacySkin(IStorageResourceProvider resources)
-            : this(Info, resources)
+            : this(CreateInfo(), resources)
         {
         }
 
@@ -39,13 +48,5 @@ namespace osu.Game.Skinning
 
             Configuration.LegacyVersion = 2.7m;
         }
-
-        public static SkinInfo Info { get; } = new SkinInfo
-        {
-            ID = osu.Game.Skinning.SkinInfo.CLASSIC_SKIN, // this is temporary until database storage is decided upon.
-            Name = "osu!classic",
-            Creator = "team osu!",
-            InstantiationInfo = typeof(DefaultLegacySkin).GetInvariantInstantiationInfo()
-        };
     }
 }
diff --git a/osu.Game/Skinning/DefaultSkin.cs b/osu.Game/Skinning/DefaultSkin.cs
index 8d3a83f589..951e3f9cc5 100644
--- a/osu.Game/Skinning/DefaultSkin.cs
+++ b/osu.Game/Skinning/DefaultSkin.cs
@@ -23,10 +23,19 @@ namespace osu.Game.Skinning
 {
     public class DefaultSkin : Skin
     {
+        public static SkinInfo CreateInfo() => new SkinInfo
+        {
+            ID = osu.Game.Skinning.SkinInfo.DEFAULT_SKIN,
+            Name = "osu! (triangles)",
+            Creator = "team osu!",
+            Protected = true,
+            InstantiationInfo = typeof(DefaultSkin).GetInvariantInstantiationInfo()
+        };
+
         private readonly IStorageResourceProvider resources;
 
         public DefaultSkin(IStorageResourceProvider resources)
-            : this(osu.Game.Skinning.SkinInfo.Default, resources)
+            : this(CreateInfo(), resources)
         {
         }
 
diff --git a/osu.Game/Skinning/SkinInfo.cs b/osu.Game/Skinning/SkinInfo.cs
index c09d45c227..9a82964933 100644
--- a/osu.Game/Skinning/SkinInfo.cs
+++ b/osu.Game/Skinning/SkinInfo.cs
@@ -6,7 +6,6 @@ using System.Collections.Generic;
 using osu.Framework.Extensions.ObjectExtensions;
 using osu.Framework.Testing;
 using osu.Game.Database;
-using osu.Game.Extensions;
 using osu.Game.IO;
 using osu.Game.Models;
 using Realms;
@@ -32,6 +31,8 @@ namespace osu.Game.Skinning
 
         public string Hash { get; set; } = string.Empty;
 
+        public bool Protected { get; set; }
+
         public string InstantiationInfo { get; set; } = string.Empty;
 
         public virtual Skin CreateInstance(IStorageResourceProvider resources)
@@ -48,14 +49,6 @@ namespace osu.Game.Skinning
 
         public bool DeletePending { get; set; }
 
-        public static SkinInfo Default { get; } = new SkinInfo
-        {
-            ID = DEFAULT_SKIN,
-            Name = "osu! (triangles)",
-            Creator = "team osu!",
-            InstantiationInfo = typeof(DefaultSkin).GetInvariantInstantiationInfo()
-        };
-
         public bool Equals(SkinInfo? other)
         {
             if (ReferenceEquals(this, other)) return true;
diff --git a/osu.Game/Skinning/SkinManager.cs b/osu.Game/Skinning/SkinManager.cs
index bcad5277ab..5c07244e0f 100644
--- a/osu.Game/Skinning/SkinManager.cs
+++ b/osu.Game/Skinning/SkinManager.cs
@@ -45,7 +45,11 @@ namespace osu.Game.Skinning
         private readonly IResourceStore<byte[]> resources;
 
         public readonly Bindable<Skin> CurrentSkin = new Bindable<Skin>();
-        public readonly Bindable<ILive<SkinInfo>> CurrentSkinInfo = new Bindable<ILive<SkinInfo>>(SkinInfo.Default.ToLive()) { Default = SkinInfo.Default.ToLive() };
+
+        public readonly Bindable<ILive<SkinInfo>> CurrentSkinInfo = new Bindable<ILive<SkinInfo>>(Skinning.DefaultSkin.CreateInfo().ToLive())
+        {
+            Default = Skinning.DefaultSkin.CreateInfo().ToLive()
+        };
 
         private readonly SkinModelManager skinModelManager;
         private readonly RealmContextFactory contextFactory;
@@ -74,8 +78,24 @@ namespace osu.Game.Skinning
 
             skinModelManager = new SkinModelManager(storage, contextFactory, host, this);
 
-            DefaultLegacySkin = new DefaultLegacySkin(this);
-            DefaultSkin = new DefaultSkin(this);
+            var defaultSkins = new[]
+            {
+                DefaultLegacySkin = new DefaultLegacySkin(this),
+                DefaultSkin = new DefaultSkin(this),
+            };
+
+            // Ensure the default entries are present.
+            using (var context = contextFactory.CreateContext())
+            using (var transaction = context.BeginWrite())
+            {
+                foreach (var skin in defaultSkins)
+                {
+                    if (context.Find<SkinInfo>(skin.SkinInfo.ID) == null)
+                        context.Add(skin.SkinInfo.Value);
+                }
+
+                transaction.Commit();
+            }
 
             CurrentSkinInfo.ValueChanged += skin => CurrentSkin.Value = skin.NewValue.PerformRead(GetSkin);
 
@@ -89,21 +109,6 @@ namespace osu.Game.Skinning
             };
         }
 
-        /// <summary>
-        /// Returns a list of all usable <see cref="SkinInfo"/>s. Includes the non-databased default skins.
-        /// </summary>
-        /// <returns>A newly allocated list of available <see cref="SkinInfo"/>.</returns>
-        public List<ILive<SkinInfo>> GetAllUsableSkins()
-        {
-            using (var context = contextFactory.CreateContext())
-            {
-                var userSkins = context.All<SkinInfo>().Where(s => !s.DeletePending).ToLive();
-                userSkins.Insert(0, DefaultSkin.SkinInfo);
-                userSkins.Insert(1, DefaultLegacySkin.SkinInfo);
-                return userSkins;
-            }
-        }
-
         public void SelectRandomSkin()
         {
             using (var context = contextFactory.CreateContext())
@@ -113,7 +118,7 @@ namespace osu.Game.Skinning
 
                 if (randomChoices.Length == 0)
                 {
-                    CurrentSkinInfo.Value = SkinInfo.Default.ToLive();
+                    CurrentSkinInfo.Value = Skinning.DefaultSkin.CreateInfo().ToLive();
                     return;
                 }
 

From 0d18c83d758e033daf823218015e25eb1458960f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 29 Nov 2021 17:15:48 +0900
Subject: [PATCH 1367/5547] Simplify deletion by adding always present
 conditionals to `Delete` method

---
 .../Settings/Sections/Maintenance/GeneralSettings.cs   |  2 +-
 osu.Game/Skinning/SkinManager.cs                       | 10 +++++++---
 2 files changed, 8 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Overlays/Settings/Sections/Maintenance/GeneralSettings.cs b/osu.Game/Overlays/Settings/Sections/Maintenance/GeneralSettings.cs
index e7e196555f..98ccbf85fd 100644
--- a/osu.Game/Overlays/Settings/Sections/Maintenance/GeneralSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Maintenance/GeneralSettings.cs
@@ -108,7 +108,7 @@ namespace osu.Game.Overlays.Settings.Sections.Maintenance
                         deleteSkinsButton.Enabled.Value = false;
                         Task.Run(() =>
                         {
-                            skins.Delete(s => !s.DeletePending);
+                            skins.Delete();
                         }).ContinueWith(t => Schedule(() => deleteSkinsButton.Enabled.Value = true));
                     }));
                 }
diff --git a/osu.Game/Skinning/SkinManager.cs b/osu.Game/Skinning/SkinManager.cs
index 5c07244e0f..d6c884d259 100644
--- a/osu.Game/Skinning/SkinManager.cs
+++ b/osu.Game/Skinning/SkinManager.cs
@@ -7,6 +7,7 @@ using System.Linq;
 using System.Linq.Expressions;
 using System.Threading;
 using System.Threading.Tasks;
+using JetBrains.Annotations;
 using osu.Framework.Audio;
 using osu.Framework.Audio.Sample;
 using osu.Framework.Bindables;
@@ -286,15 +287,18 @@ namespace osu.Game.Skinning
         {
             using (var context = contextFactory.CreateContext())
             {
-                var items = context.All<SkinInfo>().Where(filter).ToList();
+                var items = context.All<SkinInfo>()
+                                   .Where(s => !s.Protected && !s.DeletePending);
+                if (filter != null)
+                    items = items.Where(filter);
 
                 // check the removed skin is not the current user choice. if it is, switch back to default.
                 Guid currentUserSkin = CurrentSkinInfo.Value.ID;
 
                 if (items.Any(s => s.ID == currentUserSkin))
-                    scheduler.Add(() => CurrentSkinInfo.Value = SkinInfo.Default.ToLive());
+                    scheduler.Add(() => CurrentSkinInfo.Value = Skinning.DefaultSkin.CreateInfo().ToLive());
 
-                skinModelManager.Delete(items, silent);
+                skinModelManager.Delete(items.ToList(), silent);
             }
         }
 

From 68778674674e7f50598ba9e39d780417eff8a09f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 29 Nov 2021 17:48:44 +0900
Subject: [PATCH 1368/5547] Make default fallback logic more robust

---
 .../Overlays/Settings/Sections/SkinSection.cs | 22 +++++--------------
 1 file changed, 6 insertions(+), 16 deletions(-)

diff --git a/osu.Game/Overlays/Settings/Sections/SkinSection.cs b/osu.Game/Overlays/Settings/Sections/SkinSection.cs
index bf0f6bf142..4de5d455fe 100644
--- a/osu.Game/Overlays/Settings/Sections/SkinSection.cs
+++ b/osu.Game/Overlays/Settings/Sections/SkinSection.cs
@@ -96,11 +96,9 @@ namespace osu.Game.Overlays.Settings.Sections
 
             updateItems();
 
-            // Todo: This should not be necessary when OsuConfigManager is databased
-            if (!Guid.TryParse(configBindable.Value, out var configId) || skinDropdown.Items.All(s => s.ID != configId))
-                configBindable.Value = string.Empty;
+            configBindable.BindValueChanged(id => Scheduler.AddOnce(updateSelectedSkinFromConfig));
+            updateSelectedSkinFromConfig();
 
-            configBindable.BindValueChanged(id => Scheduler.AddOnce(updateSelectedSkinFromConfig), true);
             dropdownBindable.BindValueChanged(skin =>
             {
                 if (skin.NewValue.Equals(random_skin_info))
@@ -124,20 +122,12 @@ namespace osu.Game.Overlays.Settings.Sections
 
         private void updateSelectedSkinFromConfig()
         {
-            if (!Guid.TryParse(configBindable.Value, out var configId)) return;
+            ILive<SkinInfo> skin = null;
 
-            var skin = skinDropdown.Items.FirstOrDefault(s => s.ID == configId);
+            if (Guid.TryParse(configBindable.Value, out var configId))
+                skin = skinDropdown.Items.FirstOrDefault(s => s.ID == configId);
 
-            // TODO: i don't think this will be required any more.
-            if (skin == null)
-            {
-                // there may be a thread race condition where an item is selected that hasn't yet been added to the dropdown.
-                // to avoid adding complexity, let's just ensure the item is added so we can perform the selection.
-                skin = skins.Query(s => s.ID == configId);
-                updateItems();
-            }
-
-            dropdownBindable.Value = skin;
+            dropdownBindable.Value = skin ?? skinDropdown.Items.First();
         }
 
         private void updateItems()

From 0bcfb8e199004cb123598d9d5972d97ebf383cd2 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 29 Nov 2021 18:52:29 +0900
Subject: [PATCH 1369/5547] Fix regression in implementation of fix

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

diff --git a/osu.Game/Database/RealmContextFactory.cs b/osu.Game/Database/RealmContextFactory.cs
index 6948918fe7..a20139e830 100644
--- a/osu.Game/Database/RealmContextFactory.cs
+++ b/osu.Game/Database/RealmContextFactory.cs
@@ -160,6 +160,7 @@ namespace osu.Game.Database
                 if (!currentThreadCanCreateContexts.Value)
                 {
                     contextCreationLock.Wait();
+                    currentThreadCanCreateContexts.Value = true;
                     tookSemaphoreLock = true;
                 }
                 else
@@ -167,7 +168,6 @@ namespace osu.Game.Database
                     // the semaphore is used to handle blocking of all context creation during certain periods.
                     // once the semaphore has been taken by this code section, it is safe to create further contexts on the same thread.
                     // this can happen if a realm subscription is active and triggers a callback which has user code that calls `CreateContext`.
-                    currentThreadCanCreateContexts.Value = true;
                 }
 
                 contexts_created.Value++;

From 566e10f8ccff29b3c0780832ec1811c13f1e4276 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 29 Nov 2021 18:54:01 +0900
Subject: [PATCH 1370/5547] Refactor test to be easier to follow

---
 osu.Game.Tests/Database/GeneralUsageTests.cs | 36 +++++++++++---------
 1 file changed, 19 insertions(+), 17 deletions(-)

diff --git a/osu.Game.Tests/Database/GeneralUsageTests.cs b/osu.Game.Tests/Database/GeneralUsageTests.cs
index fec1a0dedd..d15e34f2da 100644
--- a/osu.Game.Tests/Database/GeneralUsageTests.cs
+++ b/osu.Game.Tests/Database/GeneralUsageTests.cs
@@ -36,34 +36,36 @@ namespace osu.Game.Tests.Database
             });
         }
 
+        /// <summary>
+        /// Test to ensure that a `CreateContext` call nested inside a subscription doesn't cause any deadlocks
+        /// due to context fetching semaphores.
+        /// </summary>
         [Test]
-        public void TestNestedContextCreation()
+        public void TestNestedContextCreationWithSubscription()
         {
             RunTestWithRealm((realmFactory, _) =>
             {
-                var mainContext = realmFactory.Context;
                 bool callbackRan = false;
 
-                var subscription = mainContext.All<RealmBeatmap>().SubscribeForNotifications((sender, changes, error) =>
+                using (var context = realmFactory.CreateContext())
                 {
-                    realmFactory.CreateContext();
-                    callbackRan = true;
-                });
-
-                Task.Factory.StartNew(() =>
-                {
-                    using (var threadContext = realmFactory.CreateContext())
+                    var subscription = context.All<RealmBeatmap>().SubscribeForNotifications((sender, changes, error) =>
                     {
-                        threadContext.Write(r => r.Add(new RealmBeatmap(CreateRuleset(), new RealmBeatmapDifficulty(), new RealmBeatmapMetadata())));
-                    }
-                }, TaskCreationOptions.LongRunning | TaskCreationOptions.HideScheduler).Wait();
+                        using (realmFactory.CreateContext())
+                        {
+                            callbackRan = true;
+                        }
+                    });
 
-                // will create a context but also run the callback above (Refresh is implicitly run when getting a new context).
-                realmFactory.CreateContext();
+                    // Force the callback above to run.
+                    using (realmFactory.CreateContext())
+                    {
+                    }
+
+                    subscription.Dispose();
+                }
 
                 Assert.IsTrue(callbackRan);
-
-                subscription.Dispose();
             });
         }
 

From 431ac1d97b951f988be2be3cbb87f300842f6457 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 29 Nov 2021 20:57:55 +0100
Subject: [PATCH 1371/5547] Remove unused using directive

---
 osu.Game.Tests/Database/GeneralUsageTests.cs | 1 -
 1 file changed, 1 deletion(-)

diff --git a/osu.Game.Tests/Database/GeneralUsageTests.cs b/osu.Game.Tests/Database/GeneralUsageTests.cs
index d15e34f2da..841bf2de43 100644
--- a/osu.Game.Tests/Database/GeneralUsageTests.cs
+++ b/osu.Game.Tests/Database/GeneralUsageTests.cs
@@ -5,7 +5,6 @@ using System;
 using System.Threading;
 using System.Threading.Tasks;
 using NUnit.Framework;
-using osu.Game.Database;
 using osu.Game.Models;
 using Realms;
 

From 0fc4d6dc2a85636d8390a144dcb13ee5ecab9eaa Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 28 Nov 2021 21:43:56 +0100
Subject: [PATCH 1372/5547] Implement beatmap card difficulty list

---
 .../TestSceneBeatmapCardDifficultyList.cs     |  71 ++++++++++++
 .../Cards/BeatmapCardDifficultyList.cs        | 103 ++++++++++++++++++
 2 files changed, 174 insertions(+)
 create mode 100644 osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCardDifficultyList.cs
 create mode 100644 osu.Game/Beatmaps/Drawables/Cards/BeatmapCardDifficultyList.cs

diff --git a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCardDifficultyList.cs b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCardDifficultyList.cs
new file mode 100644
index 0000000000..aec75884d6
--- /dev/null
+++ b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCardDifficultyList.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 osu.Framework.Allocation;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.Shapes;
+using osu.Game.Beatmaps.Drawables.Cards;
+using osu.Game.Graphics;
+using osu.Game.Online.API.Requests.Responses;
+using osu.Game.Overlays;
+
+namespace osu.Game.Tests.Visual.Beatmaps
+{
+    public class TestSceneBeatmapCardDifficultyList : OsuTestScene
+    {
+        [Cached]
+        private OverlayColourProvider colourProvider = new OverlayColourProvider(OverlayColourScheme.Blue);
+
+        [BackgroundDependencyLoader]
+        private void load(OsuColour colours)
+        {
+            var beatmapSet = new APIBeatmapSet
+            {
+                Beatmaps = new[]
+                {
+                    new APIBeatmap { RulesetID = 1, StarRating = 5.76, DifficultyName = "Oni" },
+                    new APIBeatmap { RulesetID = 1, StarRating = 3.20, DifficultyName = "Muzukashii" },
+                    new APIBeatmap { RulesetID = 1, StarRating = 2.45, DifficultyName = "Futsuu" },
+
+                    new APIBeatmap { RulesetID = 0, StarRating = 2.04, DifficultyName = "Normal" },
+                    new APIBeatmap { RulesetID = 0, StarRating = 3.51, DifficultyName = "Hard" },
+                    new APIBeatmap { RulesetID = 0, StarRating = 5.25, DifficultyName = "Insane" },
+
+                    new APIBeatmap { RulesetID = 2, StarRating = 2.64, DifficultyName = "Salad" },
+                    new APIBeatmap { RulesetID = 2, StarRating = 3.56, DifficultyName = "Platter" },
+                    new APIBeatmap { RulesetID = 2, StarRating = 4.65, DifficultyName = "Rain" },
+
+                    new APIBeatmap { RulesetID = 3, StarRating = 1.93, DifficultyName = "[7K] Normal" },
+                    new APIBeatmap { RulesetID = 3, StarRating = 3.18, DifficultyName = "[7K] Hyper" },
+                    new APIBeatmap { RulesetID = 3, StarRating = 4.82, DifficultyName = "[7K] Another" },
+
+                    new APIBeatmap { RulesetID = 4, StarRating = 9.99, DifficultyName = "Unknown?!" },
+                }
+            };
+
+            Child = new Container
+            {
+                Width = 300,
+                AutoSizeAxes = Axes.Y,
+                Anchor = Anchor.Centre,
+                Origin = Anchor.Centre,
+                Children = new Drawable[]
+                {
+                    new Box
+                    {
+                        RelativeSizeAxes = Axes.Both,
+                        Colour = colourProvider.Background2
+                    },
+                    new Container
+                    {
+                        RelativeSizeAxes = Axes.X,
+                        AutoSizeAxes = Axes.Y,
+                        Padding = new MarginPadding(10),
+                        Child = new BeatmapCardDifficultyList(beatmapSet)
+                    }
+                }
+            };
+        }
+    }
+}
diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardDifficultyList.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardDifficultyList.cs
new file mode 100644
index 0000000000..7753d8480a
--- /dev/null
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardDifficultyList.cs
@@ -0,0 +1,103 @@
+// 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;
+using osu.Framework.Graphics.Sprites;
+using osu.Game.Graphics;
+using osu.Game.Graphics.Containers;
+using osu.Game.Online.Chat;
+using osu.Game.Rulesets;
+using osuTK;
+
+namespace osu.Game.Beatmaps.Drawables.Cards
+{
+    public class BeatmapCardDifficultyList : CompositeDrawable
+    {
+        public BeatmapCardDifficultyList(IBeatmapSetInfo beatmapSetInfo)
+        {
+            RelativeSizeAxes = Axes.X;
+            AutoSizeAxes = Axes.Y;
+
+            FillFlowContainer flow;
+
+            InternalChild = flow = new FillFlowContainer
+            {
+                RelativeSizeAxes = Axes.X,
+                AutoSizeAxes = Axes.Y,
+                Direction = FillDirection.Vertical,
+                Spacing = new Vector2(0, 3)
+            };
+
+            bool firstGroup = true;
+
+            foreach (var group in beatmapSetInfo.Beatmaps.GroupBy(beatmap => beatmap.Ruleset.OnlineID).OrderBy(group => group.Key))
+            {
+                if (!firstGroup)
+                {
+                    flow.Add(Empty().With(s =>
+                    {
+                        s.RelativeSizeAxes = Axes.X;
+                        s.Height = 4;
+                    }));
+                }
+
+                foreach (var difficulty in group.OrderBy(b => b.StarRating))
+                    flow.Add(new BeatmapCardDifficultyRow(difficulty));
+
+                firstGroup = false;
+            }
+        }
+
+        private class BeatmapCardDifficultyRow : CompositeDrawable
+        {
+            private readonly IBeatmapInfo beatmapInfo;
+
+            public BeatmapCardDifficultyRow(IBeatmapInfo beatmapInfo)
+            {
+                this.beatmapInfo = beatmapInfo;
+            }
+
+            [BackgroundDependencyLoader]
+            private void load(RulesetStore rulesets)
+            {
+                RelativeSizeAxes = Axes.X;
+                AutoSizeAxes = Axes.Y;
+
+                InternalChild = new FillFlowContainer
+                {
+                    RelativeSizeAxes = Axes.X,
+                    AutoSizeAxes = Axes.Y,
+                    Direction = FillDirection.Horizontal,
+                    Spacing = new Vector2(4, 0),
+                    Children = new[]
+                    {
+                        (rulesets.GetRuleset(beatmapInfo.Ruleset.OnlineID)?.CreateInstance().CreateIcon() ?? new SpriteIcon { Icon = FontAwesome.Regular.QuestionCircle }).With(icon =>
+                        {
+                            icon.Anchor = icon.Origin = Anchor.CentreLeft;
+                            icon.Size = new Vector2(16);
+                        }),
+                        new StarRatingDisplay(new StarDifficulty(beatmapInfo.StarRating, 0), StarRatingDisplaySize.Small)
+                        {
+                            Anchor = Anchor.CentreLeft,
+                            Origin = Anchor.CentreLeft
+                        },
+                        new LinkFlowContainer(s =>
+                        {
+                            s.Font = OsuFont.Default.With(size: 14, weight: FontWeight.SemiBold);
+                        }).With(d =>
+                        {
+                            d.AutoSizeAxes = Axes.Both;
+                            d.Anchor = Anchor.CentreLeft;
+                            d.Origin = Anchor.CentreLeft;
+                            d.Padding = new MarginPadding { Bottom = 2 };
+                            d.AddLink(beatmapInfo.DifficultyName, LinkAction.OpenBeatmap, beatmapInfo.OnlineID.ToString());
+                        })
+                    }
+                };
+            }
+        }
+    }
+}

From 45656c359936b935e17b8ef0ec4b6ada043cc85f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 29 Nov 2021 22:06:11 +0100
Subject: [PATCH 1373/5547] Fix difficulty spectrum display not ordering
 ruleset groups by ID

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

diff --git a/osu.Game/Beatmaps/Drawables/DifficultySpectrumDisplay.cs b/osu.Game/Beatmaps/Drawables/DifficultySpectrumDisplay.cs
index f4501f0633..5b211084ab 100644
--- a/osu.Game/Beatmaps/Drawables/DifficultySpectrumDisplay.cs
+++ b/osu.Game/Beatmaps/Drawables/DifficultySpectrumDisplay.cs
@@ -62,7 +62,7 @@ namespace osu.Game.Beatmaps.Drawables
             // matching web: https://github.com/ppy/osu-web/blob/d06d8c5e735eb1f48799b1654b528e9a7afb0a35/resources/assets/lib/beatmapset-panel.tsx#L127
             bool collapsed = beatmapSet.Beatmaps.Count() > 12;
 
-            foreach (var rulesetGrouping in beatmapSet.Beatmaps.GroupBy(beatmap => beatmap.Ruleset.OnlineID))
+            foreach (var rulesetGrouping in beatmapSet.Beatmaps.GroupBy(beatmap => beatmap.Ruleset.OnlineID).OrderBy(group => group.Key))
             {
                 flow.Add(new RulesetDifficultyGroup(rulesetGrouping.Key, rulesetGrouping, collapsed));
             }

From 383bf7cdfc7f71d3528ad054fcfd7c16aef751ff Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 30 Nov 2021 10:39:48 +0900
Subject: [PATCH 1374/5547] Only allow HD combination alongside FL

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

diff --git a/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs b/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs
index 1b6eb2915b..79314344ea 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs
@@ -125,7 +125,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty
             new OsuModEasy(),
             new OsuModHardRock(),
             new OsuModFlashlight(),
-            new OsuModHidden()
+            new MultiMod(new OsuModFlashlight(), new OsuModHidden())
         };
     }
-}
\ No newline at end of file
+}

From 43546992586fcefc8f072deb091004edcf418175 Mon Sep 17 00:00:00 2001
From: MBmasher <mbmasher@gmail.com>
Date: Tue, 30 Nov 2021 12:51:23 +1100
Subject: [PATCH 1375/5547] Fix cumulative strain time calculation in
 Flashlight skill

---
 osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
index 466f0556ab..9c539d5e4b 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
@@ -45,11 +45,17 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
                 var osuPrevious = (OsuDifficultyHitObject)Previous[i];
                 var osuPreviousHitObject = (OsuHitObject)(osuPrevious.BaseObject);
 
+                OsuDifficultyHitObject osuLastPrevious;
+                if (i == 0)
+                    osuLastPrevious = osuCurrent;
+                else
+                    osuLastPrevious = (OsuDifficultyHitObject)Previous[i - 1];
+
                 if (!(osuPrevious.BaseObject is Spinner))
                 {
                     double jumpDistance = (osuHitObject.StackedPosition - osuPreviousHitObject.EndPosition).Length;
 
-                    cumulativeStrainTime += osuPrevious.StrainTime;
+                    cumulativeStrainTime += osuLastPrevious.StrainTime;
 
                     // We want to nerf objects that can be easily seen within the Flashlight circle radius.
                     if (i == 0)

From b0dc8bf0616cbf5ac9cb07edc8f26a7b33845223 Mon Sep 17 00:00:00 2001
From: MBmasher <mbmasher@gmail.com>
Date: Tue, 30 Nov 2021 12:58:49 +1100
Subject: [PATCH 1376/5547] Change Opacity function to take in absolute map
 time rather than relative time

---
 .../Difficulty/Preprocessing/OsuDifficultyHitObject.cs       | 5 ++++-
 osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs        | 2 +-
 2 files changed, 5 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
index 4109c068ea..c94fd10db5 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
@@ -71,8 +71,11 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
             setDistances(clockRate);
         }
 
-        public double Opacity(double ms, bool hidden)
+        public double Opacity(double T, bool hidden)
         {
+            double ms = (BaseObject.StartTime - T) / clockRate;
+            if (ms < 0)
+                return 0.0;
             double preemptTime = BaseObject.TimePreempt / clockRate;
             double fadeInTime = BaseObject.TimeFadeIn / clockRate;
 
diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
index 7b4119d354..d7f515602e 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
@@ -70,7 +70,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
                     double stackNerf = Math.Min(1.0, (osuPrevious.JumpDistance / scalingFactor) / 25.0);
 
                     // Bonus based on how visible the object is.
-                    double opacityBonus = 1.0 + max_opacity_bonus * (1.0 - osuCurrent.Opacity(cumulativeStrainTime, hidden));
+                    double opacityBonus = 1.0 + max_opacity_bonus * (1.0 - osuCurrent.Opacity(osuPreviousHitObject.StartTime, hidden));
 
                     result += Math.Pow(0.8, i) * stackNerf * opacityBonus * scalingFactor * jumpDistance / cumulativeStrainTime;
                 }

From 4a34a5c738fe5d0a765f85c1b167926bdc678952 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 30 Nov 2021 11:11:42 +0900
Subject: [PATCH 1377/5547] Refactor difficulty adjustment mod combinations
 test

---
 ...DifficultyAdjustmentModCombinationsTest.cs | 136 ++++++++++--------
 1 file changed, 75 insertions(+), 61 deletions(-)

diff --git a/osu.Game.Tests/NonVisual/DifficultyAdjustmentModCombinationsTest.cs b/osu.Game.Tests/NonVisual/DifficultyAdjustmentModCombinationsTest.cs
index e458e66ab7..612927337f 100644
--- a/osu.Game.Tests/NonVisual/DifficultyAdjustmentModCombinationsTest.cs
+++ b/osu.Game.Tests/NonVisual/DifficultyAdjustmentModCombinationsTest.cs
@@ -3,12 +3,14 @@
 
 using System;
 using System.Collections.Generic;
+using System.Linq;
 using NUnit.Framework;
 using osu.Game.Beatmaps;
 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.Utils;
 
 namespace osu.Game.Tests.NonVisual
 {
@@ -20,8 +22,10 @@ namespace osu.Game.Tests.NonVisual
         {
             var combinations = new TestLegacyDifficultyCalculator().CreateDifficultyAdjustmentModCombinations();
 
-            Assert.AreEqual(1, combinations.Length);
-            Assert.IsTrue(combinations[0] is ModNoMod);
+            assertCombinations(new[]
+            {
+                new[] { typeof(ModNoMod) }
+            }, combinations);
         }
 
         [Test]
@@ -29,9 +33,11 @@ namespace osu.Game.Tests.NonVisual
         {
             var combinations = new TestLegacyDifficultyCalculator(new ModA()).CreateDifficultyAdjustmentModCombinations();
 
-            Assert.AreEqual(2, combinations.Length);
-            Assert.IsTrue(combinations[0] is ModNoMod);
-            Assert.IsTrue(combinations[1] is ModA);
+            assertCombinations(new[]
+            {
+                new[] { typeof(ModNoMod) },
+                new[] { typeof(ModA) }
+            }, combinations);
         }
 
         [Test]
@@ -39,14 +45,13 @@ namespace osu.Game.Tests.NonVisual
         {
             var combinations = new TestLegacyDifficultyCalculator(new ModA(), new ModB()).CreateDifficultyAdjustmentModCombinations();
 
-            Assert.AreEqual(4, combinations.Length);
-            Assert.IsTrue(combinations[0] is ModNoMod);
-            Assert.IsTrue(combinations[1] is ModA);
-            Assert.IsTrue(combinations[2] is MultiMod);
-            Assert.IsTrue(combinations[3] is ModB);
-
-            Assert.IsTrue(((MultiMod)combinations[2]).Mods[0] is ModA);
-            Assert.IsTrue(((MultiMod)combinations[2]).Mods[1] is ModB);
+            assertCombinations(new[]
+            {
+                new[] { typeof(ModNoMod) },
+                new[] { typeof(ModA) },
+                new[] { typeof(ModA), typeof(ModB) },
+                new[] { typeof(ModB) }
+            }, combinations);
         }
 
         [Test]
@@ -54,10 +59,12 @@ namespace osu.Game.Tests.NonVisual
         {
             var combinations = new TestLegacyDifficultyCalculator(new ModA(), new ModIncompatibleWithA()).CreateDifficultyAdjustmentModCombinations();
 
-            Assert.AreEqual(3, combinations.Length);
-            Assert.IsTrue(combinations[0] is ModNoMod);
-            Assert.IsTrue(combinations[1] is ModA);
-            Assert.IsTrue(combinations[2] is ModIncompatibleWithA);
+            assertCombinations(new[]
+            {
+                new[] { typeof(ModNoMod) },
+                new[] { typeof(ModA) },
+                new[] { typeof(ModIncompatibleWithA) }
+            }, combinations);
         }
 
         [Test]
@@ -65,22 +72,17 @@ namespace osu.Game.Tests.NonVisual
         {
             var combinations = new TestLegacyDifficultyCalculator(new ModA(), new ModB(), new ModIncompatibleWithA(), new ModIncompatibleWithAAndB()).CreateDifficultyAdjustmentModCombinations();
 
-            Assert.AreEqual(8, combinations.Length);
-            Assert.IsTrue(combinations[0] is ModNoMod);
-            Assert.IsTrue(combinations[1] is ModA);
-            Assert.IsTrue(combinations[2] is MultiMod);
-            Assert.IsTrue(combinations[3] is ModB);
-            Assert.IsTrue(combinations[4] is MultiMod);
-            Assert.IsTrue(combinations[5] is ModIncompatibleWithA);
-            Assert.IsTrue(combinations[6] is MultiMod);
-            Assert.IsTrue(combinations[7] is ModIncompatibleWithAAndB);
-
-            Assert.IsTrue(((MultiMod)combinations[2]).Mods[0] is ModA);
-            Assert.IsTrue(((MultiMod)combinations[2]).Mods[1] is ModB);
-            Assert.IsTrue(((MultiMod)combinations[4]).Mods[0] is ModB);
-            Assert.IsTrue(((MultiMod)combinations[4]).Mods[1] is ModIncompatibleWithA);
-            Assert.IsTrue(((MultiMod)combinations[6]).Mods[0] is ModIncompatibleWithA);
-            Assert.IsTrue(((MultiMod)combinations[6]).Mods[1] is ModIncompatibleWithAAndB);
+            assertCombinations(new[]
+            {
+                new[] { typeof(ModNoMod) },
+                new[] { typeof(ModA) },
+                new[] { typeof(ModA), typeof(ModB) },
+                new[] { typeof(ModB) },
+                new[] { typeof(ModB), typeof(ModIncompatibleWithA) },
+                new[] { typeof(ModIncompatibleWithA) },
+                new[] { typeof(ModIncompatibleWithA), typeof(ModIncompatibleWithAAndB) },
+                new[] { typeof(ModIncompatibleWithAAndB) },
+            }, combinations);
         }
 
         [Test]
@@ -88,10 +90,12 @@ namespace osu.Game.Tests.NonVisual
         {
             var combinations = new TestLegacyDifficultyCalculator(new ModAofA(), new ModIncompatibleWithAofA()).CreateDifficultyAdjustmentModCombinations();
 
-            Assert.AreEqual(3, combinations.Length);
-            Assert.IsTrue(combinations[0] is ModNoMod);
-            Assert.IsTrue(combinations[1] is ModAofA);
-            Assert.IsTrue(combinations[2] is ModIncompatibleWithAofA);
+            assertCombinations(new[]
+            {
+                new[] { typeof(ModNoMod) },
+                new[] { typeof(ModAofA) },
+                new[] { typeof(ModIncompatibleWithAofA) }
+            }, combinations);
         }
 
         [Test]
@@ -99,17 +103,13 @@ namespace osu.Game.Tests.NonVisual
         {
             var combinations = new TestLegacyDifficultyCalculator(new ModA(), new MultiMod(new ModB(), new ModC())).CreateDifficultyAdjustmentModCombinations();
 
-            Assert.AreEqual(4, combinations.Length);
-            Assert.IsTrue(combinations[0] is ModNoMod);
-            Assert.IsTrue(combinations[1] is ModA);
-            Assert.IsTrue(combinations[2] is MultiMod);
-            Assert.IsTrue(combinations[3] is MultiMod);
-
-            Assert.IsTrue(((MultiMod)combinations[2]).Mods[0] is ModA);
-            Assert.IsTrue(((MultiMod)combinations[2]).Mods[1] is ModB);
-            Assert.IsTrue(((MultiMod)combinations[2]).Mods[2] is ModC);
-            Assert.IsTrue(((MultiMod)combinations[3]).Mods[0] is ModB);
-            Assert.IsTrue(((MultiMod)combinations[3]).Mods[1] is ModC);
+            assertCombinations(new[]
+            {
+                new[] { typeof(ModNoMod) },
+                new[] { typeof(ModA) },
+                new[] { typeof(ModA), typeof(ModB), typeof(ModC) },
+                new[] { typeof(ModB), typeof(ModC) }
+            }, combinations);
         }
 
         [Test]
@@ -117,13 +117,12 @@ namespace osu.Game.Tests.NonVisual
         {
             var combinations = new TestLegacyDifficultyCalculator(new ModA(), new MultiMod(new ModB(), new ModIncompatibleWithA())).CreateDifficultyAdjustmentModCombinations();
 
-            Assert.AreEqual(3, combinations.Length);
-            Assert.IsTrue(combinations[0] is ModNoMod);
-            Assert.IsTrue(combinations[1] is ModA);
-            Assert.IsTrue(combinations[2] is MultiMod);
-
-            Assert.IsTrue(((MultiMod)combinations[2]).Mods[0] is ModB);
-            Assert.IsTrue(((MultiMod)combinations[2]).Mods[1] is ModIncompatibleWithA);
+            assertCombinations(new[]
+            {
+                new[] { typeof(ModNoMod) },
+                new[] { typeof(ModA) },
+                new[] { typeof(ModB), typeof(ModIncompatibleWithA) }
+            }, combinations);
         }
 
         [Test]
@@ -131,13 +130,28 @@ namespace osu.Game.Tests.NonVisual
         {
             var combinations = new TestLegacyDifficultyCalculator(new ModA(), new MultiMod(new ModA(), new ModB())).CreateDifficultyAdjustmentModCombinations();
 
-            Assert.AreEqual(3, combinations.Length);
-            Assert.IsTrue(combinations[0] is ModNoMod);
-            Assert.IsTrue(combinations[1] is ModA);
-            Assert.IsTrue(combinations[2] is MultiMod);
+            assertCombinations(new[]
+            {
+                new[] { typeof(ModNoMod) },
+                new[] { typeof(ModA) },
+                new[] { typeof(ModA), typeof(ModB) }
+            }, combinations);
+        }
 
-            Assert.IsTrue(((MultiMod)combinations[2]).Mods[0] is ModA);
-            Assert.IsTrue(((MultiMod)combinations[2]).Mods[1] is ModB);
+        private void assertCombinations(Type[][] expectedCombinations, Mod[] actualCombinations)
+        {
+            Assert.AreEqual(expectedCombinations.Length, actualCombinations.Length);
+
+            foreach (Type[] expected in expectedCombinations)
+            {
+                Type[] actualTypes = ModUtils.FlattenMods(actualCombinations).Select(m => m.GetType()).ToArray();
+
+                Assert.Multiple(() =>
+                {
+                    foreach (var expectedType in expected)
+                        Assert.Contains(expectedType, actualTypes);
+                });
+            }
         }
 
         private class ModA : Mod

From 35d68d6ab039318bf024853ca3214c4d25368d2d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 30 Nov 2021 11:47:29 +0900
Subject: [PATCH 1378/5547] Remove all optimisations from `RealmLive`

---
 osu.Game/Database/RealmLive.cs | 43 +++++++++-------------------------
 1 file changed, 11 insertions(+), 32 deletions(-)

diff --git a/osu.Game/Database/RealmLive.cs b/osu.Game/Database/RealmLive.cs
index 7ae7d8544a..0b422fd36f 100644
--- a/osu.Game/Database/RealmLive.cs
+++ b/osu.Game/Database/RealmLive.cs
@@ -2,7 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
-using System.Threading;
+using osu.Framework.Development;
 using Realms;
 
 #nullable enable
@@ -17,10 +17,7 @@ namespace osu.Game.Database
     {
         public Guid ID { get; }
 
-        public bool IsManaged { get; }
-
-        private readonly SynchronizationContext? fetchedContext;
-        private readonly int fetchedThreadId;
+        public bool IsManaged => data.IsManaged;
 
         /// <summary>
         /// The original live data used to create this instance.
@@ -35,14 +32,6 @@ namespace osu.Game.Database
         {
             this.data = data;
 
-            if (data.IsManaged)
-            {
-                IsManaged = true;
-
-                fetchedContext = SynchronizationContext.Current;
-                fetchedThreadId = Thread.CurrentThread.ManagedThreadId;
-            }
-
             ID = data.ID;
         }
 
@@ -52,7 +41,7 @@ namespace osu.Game.Database
         /// <param name="perform">The action to perform.</param>
         public void PerformRead(Action<T> perform)
         {
-            if (originalDataValid)
+            if (!IsManaged)
             {
                 perform(data);
                 return;
@@ -71,7 +60,7 @@ namespace osu.Game.Database
             if (typeof(RealmObjectBase).IsAssignableFrom(typeof(TReturn)))
                 throw new InvalidOperationException($"Realm live objects should not exit the scope of {nameof(PerformRead)}.");
 
-            if (originalDataValid)
+            if (!IsManaged)
                 return perform(data);
 
             using (var realm = Realm.GetInstance(data.Realm.Config))
@@ -99,31 +88,21 @@ namespace osu.Game.Database
         {
             get
             {
-                if (originalDataValid)
+                if (!IsManaged)
                     return data;
 
-                if (!isCorrectThread)
-                    throw new InvalidOperationException($"Can't use {nameof(Value)} unless on the same thread the original data was fetched from.");
+                if (!ThreadSafety.IsUpdateThread)
+                    throw new InvalidOperationException($"Can't use {nameof(Value)} on managed objects from non-update threads");
+
+                // When using Value, we rely on garbage collection for the realm instance used to retrieve the instance.
+                // As we are sure that this is on the same thread
 
                 var realm = Realm.GetInstance(data.Realm.Config);
-                var retrieved = realm.Find<T>(ID);
 
-                if (!retrieved.IsValid)
-                    throw new InvalidOperationException("Attempted to access value without an open context");
-
-                return retrieved;
+                return realm.Find<T>(ID);
             }
         }
 
-        // TODO: Revisit adding these conditionals back as an optimisation: || (isCorrectThread && data.IsValid);
-        // They have temporarily been removed due to an oversight involving .AsQueryable, see https://github.com/realm/realm-dotnet/discussions/2734.
-        // This means we are fetching a new context every `PerformRead` or `PerformWrite`, even when on the correct thread.
-        private bool originalDataValid => !IsManaged;
-
-        // this matches realm's internal thread validation (see https://github.com/realm/realm-dotnet/blob/903b4d0b304f887e37e2d905384fb572a6496e70/Realm/Realm/Native/SynchronizationContextScheduler.cs#L72)
-        private bool isCorrectThread
-            => (fetchedContext != null && SynchronizationContext.Current == fetchedContext) || fetchedThreadId == Thread.CurrentThread.ManagedThreadId;
-
         public bool Equals(ILive<T>? other) => ID == other?.ID;
     }
 }

From 3339afd6485270b4b3ac9db1d1dbffe599dc31da Mon Sep 17 00:00:00 2001
From: MBmasher <mbmasher@gmail.com>
Date: Tue, 30 Nov 2021 13:52:58 +1100
Subject: [PATCH 1379/5547] Change input variable name in Opacity function

---
 .../Difficulty/Preprocessing/OsuDifficultyHitObject.cs        | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
index c94fd10db5..7ab12f109f 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
@@ -71,9 +71,9 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
             setDistances(clockRate);
         }
 
-        public double Opacity(double T, bool hidden)
+        public double Opacity(double mapTime, bool hidden)
         {
-            double ms = (BaseObject.StartTime - T) / clockRate;
+            double ms = (BaseObject.StartTime - mapTime) / clockRate;
             if (ms < 0)
                 return 0.0;
             double preemptTime = BaseObject.TimePreempt / clockRate;

From 5884b058b9f15ab2d518316d5e62c690431367b0 Mon Sep 17 00:00:00 2001
From: MBmasher <mbmasher@gmail.com>
Date: Tue, 30 Nov 2021 13:54:41 +1100
Subject: [PATCH 1380/5547] Add blank line

---
 .../Difficulty/Preprocessing/OsuDifficultyHitObject.cs           | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
index 7ab12f109f..a497c95990 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
@@ -76,6 +76,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
             double ms = (BaseObject.StartTime - mapTime) / clockRate;
             if (ms < 0)
                 return 0.0;
+
             double preemptTime = BaseObject.TimePreempt / clockRate;
             double fadeInTime = BaseObject.TimeFadeIn / clockRate;
 

From 2e31f5a338988fb69dd77c709c1e36f742dbb943 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 30 Nov 2021 11:55:13 +0900
Subject: [PATCH 1381/5547] Update tests to match new behaviour

---
 osu.Game.Tests/Database/RealmLiveTests.cs | 107 +++++++++++-----------
 1 file changed, 53 insertions(+), 54 deletions(-)

diff --git a/osu.Game.Tests/Database/RealmLiveTests.cs b/osu.Game.Tests/Database/RealmLiveTests.cs
index 63566394d6..41c82399dc 100644
--- a/osu.Game.Tests/Database/RealmLiveTests.cs
+++ b/osu.Game.Tests/Database/RealmLiveTests.cs
@@ -46,53 +46,6 @@ namespace osu.Game.Tests.Database
             Assert.IsFalse(liveBeatmap.PerformRead(l => l.Hidden));
         }
 
-        [Test]
-        public void TestValueAccessWithOpenContext()
-        {
-            RunTestWithRealm((realmFactory, _) =>
-            {
-                RealmLive<RealmBeatmap>? liveBeatmap = null;
-                Task.Factory.StartNew(() =>
-                {
-                    using (var threadContext = realmFactory.CreateContext())
-                    {
-                        var beatmap = threadContext.Write(r => r.Add(new RealmBeatmap(CreateRuleset(), new RealmBeatmapDifficulty(), new RealmBeatmapMetadata())));
-
-                        liveBeatmap = beatmap.ToLive();
-                    }
-                }, TaskCreationOptions.LongRunning | TaskCreationOptions.HideScheduler).Wait();
-
-                Debug.Assert(liveBeatmap != null);
-
-                Task.Factory.StartNew(() =>
-                {
-                    // TODO: The commented code is the behaviour we hope to obtain, but is temporarily disabled.
-                    // See https://github.com/ppy/osu/pull/15851
-                    using (realmFactory.CreateContext())
-                    {
-                        Assert.Throws<InvalidOperationException>(() =>
-                        {
-                            var __ = liveBeatmap.Value;
-                        });
-                    }
-
-                    // Assert.DoesNotThrow(() =>
-                    // {
-                    //     using (realmFactory.CreateContext())
-                    //     {
-                    //         var resolved = liveBeatmap.Value;
-                    //
-                    //         Assert.IsTrue(resolved.Realm.IsClosed);
-                    //         Assert.IsTrue(resolved.IsValid);
-                    //
-                    //         // can access properties without a crash.
-                    //         Assert.IsFalse(resolved.Hidden);
-                    //     }
-                    // });
-                }, TaskCreationOptions.LongRunning | TaskCreationOptions.HideScheduler).Wait();
-            });
-        }
-
         [Test]
         public void TestScopedReadWithoutContext()
         {
@@ -148,6 +101,59 @@ namespace osu.Game.Tests.Database
             });
         }
 
+        [Test]
+        public void TestValueAccessNonManaged()
+        {
+            RunTestWithRealm((realmFactory, _) =>
+            {
+                var beatmap = new RealmBeatmap(CreateRuleset(), new RealmBeatmapDifficulty(), new RealmBeatmapMetadata());
+                var liveBeatmap = beatmap.ToLive();
+
+                Assert.DoesNotThrow(() =>
+                {
+                    var __ = liveBeatmap.Value;
+                });
+            });
+        }
+
+        [Test]
+        public void TestValueAccessWithOpenContextFails()
+        {
+            RunTestWithRealm((realmFactory, _) =>
+            {
+                RealmLive<RealmBeatmap>? liveBeatmap = null;
+                Task.Factory.StartNew(() =>
+                {
+                    using (var threadContext = realmFactory.CreateContext())
+                    {
+                        var beatmap = threadContext.Write(r => r.Add(new RealmBeatmap(CreateRuleset(), new RealmBeatmapDifficulty(), new RealmBeatmapMetadata())));
+
+                        liveBeatmap = beatmap.ToLive();
+                    }
+                }, TaskCreationOptions.LongRunning | TaskCreationOptions.HideScheduler).Wait();
+
+                Debug.Assert(liveBeatmap != null);
+
+                Task.Factory.StartNew(() =>
+                {
+                    // Can't be used, without a valid context.
+                    Assert.Throws<InvalidOperationException>(() =>
+                    {
+                        var __ = liveBeatmap.Value;
+                    });
+
+                    // Can't be used, even from within a valid context.
+                    using (realmFactory.CreateContext())
+                    {
+                        Assert.Throws<InvalidOperationException>(() =>
+                        {
+                            var __ = liveBeatmap.Value;
+                        });
+                    }
+                }, TaskCreationOptions.LongRunning | TaskCreationOptions.HideScheduler).Wait();
+            });
+        }
+
         [Test]
         public void TestValueAccessWithoutOpenContextFails()
         {
@@ -209,8 +215,6 @@ namespace osu.Game.Tests.Database
                     Assert.AreEqual(0, updateThreadContext.All<RealmBeatmap>().Count());
                     Assert.AreEqual(0, changesTriggered);
 
-                    // TODO: Originally the following was using `liveBeatmap.Value`. This has been temporarily disabled.
-                    // See https://github.com/ppy/osu/pull/15851
                     liveBeatmap.PerformRead(resolved =>
                     {
                         // retrieval causes an implicit refresh. even changes that aren't related to the retrieval are fired at this point.
@@ -218,11 +222,6 @@ namespace osu.Game.Tests.Database
                         Assert.AreEqual(2, updateThreadContext.All<RealmBeatmap>().Count());
                         Assert.AreEqual(1, changesTriggered);
 
-                        // TODO: as above, temporarily disabled as it doesn't make sense inside a `PerformRead`.
-                        // // even though the realm that this instance was resolved for was closed, it's still valid.
-                        // Assert.IsTrue(resolved.Realm.IsClosed);
-                        // Assert.IsTrue(resolved.IsValid);
-
                         // can access properties without a crash.
                         Assert.IsFalse(resolved.Hidden);
 

From f3f77fa05316faa2e046edf7ef116058f190c9fa Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 30 Nov 2021 11:56:53 +0900
Subject: [PATCH 1382/5547] Update missed xmldoc/comments

---
 osu.Game/Database/ILive.cs     | 4 ++--
 osu.Game/Database/RealmLive.cs | 3 +--
 2 files changed, 3 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Database/ILive.cs b/osu.Game/Database/ILive.cs
index a863339f11..3011754bc1 100644
--- a/osu.Game/Database/ILive.cs
+++ b/osu.Game/Database/ILive.cs
@@ -38,10 +38,10 @@ namespace osu.Game.Database
         bool IsManaged { get; }
 
         /// <summary>
-        /// Resolve the value of this instance on the current thread's context.
+        /// Resolve the value of this instance on the update thread.
         /// </summary>
         /// <remarks>
-        /// After resolving the data should not be passed between threads.
+        /// After resolving, the data should not be passed between threads.
         /// </remarks>
         T Value { get; }
     }
diff --git a/osu.Game/Database/RealmLive.cs b/osu.Game/Database/RealmLive.cs
index 0b422fd36f..2accea305a 100644
--- a/osu.Game/Database/RealmLive.cs
+++ b/osu.Game/Database/RealmLive.cs
@@ -95,8 +95,7 @@ namespace osu.Game.Database
                     throw new InvalidOperationException($"Can't use {nameof(Value)} on managed objects from non-update threads");
 
                 // When using Value, we rely on garbage collection for the realm instance used to retrieve the instance.
-                // As we are sure that this is on the same thread
-
+                // As we are sure that this is on the update thread, there should always be an open and constantly refreshing realm instance to ensure file size growth is a non-issue.
                 var realm = Realm.GetInstance(data.Realm.Config);
 
                 return realm.Find<T>(ID);

From a73919917c3f829bee58a827c9071a8e145ddb51 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 30 Nov 2021 12:32:08 +0900
Subject: [PATCH 1383/5547] Fix intermittent test failures in
 `TestScenBeatmapInfoWedge` due to async load

https://github.com/ppy/osu/runs/4358685294?check_suite_focus=true

Occurs due to the wedge content also reloading on ruleset change, which
wasn't being accounted for. In a fail case, the content would change
during the "select beatmap" step's async load wait, causing incorrect
results.

https://github.com/ppy/osu/blob/51a353e12db189f9958228d30fe045b8460c6b92/osu.Game/Screens/Select/BeatmapInfoWedge.cs#L70
---
 .../SongSelect/TestSceneBeatmapInfoWedge.cs    | 18 +++++++++++++++++-
 1 file changed, 17 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapInfoWedge.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapInfoWedge.cs
index e7c54efa8c..9ad5242df4 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapInfoWedge.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapInfoWedge.cs
@@ -82,7 +82,7 @@ namespace osu.Game.Tests.Visual.SongSelect
 
                 beatmaps.Add(testBeatmap);
 
-                AddStep("set ruleset", () => Ruleset.Value = rulesetInfo);
+                setRuleset(rulesetInfo);
 
                 selectBeatmap(testBeatmap);
 
@@ -167,6 +167,22 @@ namespace osu.Game.Tests.Visual.SongSelect
                     label => label.Statistic.Name == "BPM" && label.Statistic.Content == target.ToString(CultureInfo.InvariantCulture)));
         }
 
+        private void setRuleset(RulesetInfo rulesetInfo)
+        {
+            Container containerBefore = null;
+
+            AddStep("set ruleset", () =>
+            {
+                // wedge content is only refreshed if the ruleset changes, so only wait for load in that case.
+                if (!rulesetInfo.Equals(Ruleset.Value))
+                    containerBefore = infoWedge.DisplayedContent;
+
+                Ruleset.Value = rulesetInfo;
+            });
+
+            AddUntilStep("wait for async load", () => infoWedge.DisplayedContent != containerBefore);
+        }
+
         private void selectBeatmap([CanBeNull] IBeatmap b)
         {
             Container containerBefore = null;

From 9824d805eac344ab727d87d2b269ac0fca34d6b2 Mon Sep 17 00:00:00 2001
From: MBmasher <mbmasher@gmail.com>
Date: Tue, 30 Nov 2021 14:36:38 +1100
Subject: [PATCH 1384/5547] Remove unnecessary clockRate in Opacity function

---
 .../Difficulty/Preprocessing/OsuDifficultyHitObject.cs    | 8 +++-----
 1 file changed, 3 insertions(+), 5 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
index a497c95990..dacbb4c51f 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
@@ -56,14 +56,12 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
 
         private readonly OsuHitObject lastLastObject;
         private readonly OsuHitObject lastObject;
-        private readonly double clockRate;
 
         public OsuDifficultyHitObject(HitObject hitObject, HitObject lastLastObject, HitObject lastObject, double clockRate)
             : base(hitObject, lastObject, clockRate)
         {
             this.lastLastObject = (OsuHitObject)lastLastObject;
             this.lastObject = (OsuHitObject)lastObject;
-            this.clockRate = clockRate;
 
             // Capped to 25ms to prevent difficulty calculation breaking from simultaneous objects.
             StrainTime = Math.Max(DeltaTime, min_delta_time);
@@ -73,12 +71,12 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
 
         public double Opacity(double mapTime, bool hidden)
         {
-            double ms = (BaseObject.StartTime - mapTime) / clockRate;
+            double ms = BaseObject.StartTime - mapTime;
             if (ms < 0)
                 return 0.0;
 
-            double preemptTime = BaseObject.TimePreempt / clockRate;
-            double fadeInTime = BaseObject.TimeFadeIn / clockRate;
+            double preemptTime = BaseObject.TimePreempt;
+            double fadeInTime = BaseObject.TimeFadeIn;
 
             if (hidden)
                 return Math.Clamp(Math.Min((1.0 - ms / preemptTime) * 2.5, (ms / preemptTime - 0.3) * (1.0 / 0.3)), 0.0, 1.0);

From f921acc681fbef678c39a15cc3502b58d286148c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 30 Nov 2021 13:01:40 +0900
Subject: [PATCH 1385/5547] Fix chat tab dropdown not being reachable at
 default sizing

Would have liked to fix this in a more local way, but the structure of
the dropdowns is just a pain in the ass to work with, so this will do
for now.
---
 osu.Game/Graphics/UserInterface/OsuTabDropdown.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Graphics/UserInterface/OsuTabDropdown.cs b/osu.Game/Graphics/UserInterface/OsuTabDropdown.cs
index 68ffc6bf4e..b7e25ae4e7 100644
--- a/osu.Game/Graphics/UserInterface/OsuTabDropdown.cs
+++ b/osu.Game/Graphics/UserInterface/OsuTabDropdown.cs
@@ -66,7 +66,7 @@ namespace osu.Game.Graphics.UserInterface
                 Origin = Anchor.TopRight;
 
                 BackgroundColour = Color4.Black.Opacity(0.7f);
-                MaxHeight = 400;
+                MaxHeight = 200;
             }
 
             protected override DrawableDropdownMenuItem CreateDrawableDropdownMenuItem(MenuItem item) => new DrawableOsuTabDropdownMenuItem(item);

From 384a0664c27101c9f32712942e817913a12cb73e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 30 Nov 2021 14:05:44 +0900
Subject: [PATCH 1386/5547] Remove unused migration method

---
 osu.Game/OsuGameBase.cs | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/osu.Game/OsuGameBase.cs b/osu.Game/OsuGameBase.cs
index 88c9ab370c..bfc0da468b 100644
--- a/osu.Game/OsuGameBase.cs
+++ b/osu.Game/OsuGameBase.cs
@@ -442,10 +442,6 @@ namespace osu.Game
 
         protected override Storage CreateStorage(GameHost host, Storage defaultStorage) => new OsuStorage(host, defaultStorage);
 
-        private void migrateDataToRealm()
-        {
-        }
-
         private void onRulesetChanged(ValueChangedEvent<RulesetInfo> r)
         {
             if (r.NewValue?.Available != true)

From 6e4cd91b7bb782572e2e7abbd5b6dc9926dca95e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 30 Nov 2021 14:12:36 +0900
Subject: [PATCH 1387/5547] Fix update thread realm context never being
 `Refresh()`ed

---
 osu.Game/OsuGameBase.cs | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/osu.Game/OsuGameBase.cs b/osu.Game/OsuGameBase.cs
index bfc0da468b..6eb67b34e8 100644
--- a/osu.Game/OsuGameBase.cs
+++ b/osu.Game/OsuGameBase.cs
@@ -377,6 +377,13 @@ namespace osu.Game
             FrameStatistics.ValueChanged += e => fpsDisplayVisible.Value = e.NewValue != FrameStatisticsMode.None;
         }
 
+        protected override void Update()
+        {
+            base.Update();
+
+            realmFactory.Refresh();
+        }
+
         protected override IReadOnlyDependencyContainer CreateChildDependencies(IReadOnlyDependencyContainer parent) =>
             dependencies = new DependencyContainer(base.CreateChildDependencies(parent));
 

From 0feec0996665a0009479d4667a4500d3edd8b8b1 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 30 Nov 2021 14:12:49 +0900
Subject: [PATCH 1388/5547] Refactor beatmap importer tests to ensure realm is
 refreshed when waiting on state

---
 .../Database/BeatmapImporterTests.cs          | 22 +++++++++++--------
 1 file changed, 13 insertions(+), 9 deletions(-)

diff --git a/osu.Game.Tests/Database/BeatmapImporterTests.cs b/osu.Game.Tests/Database/BeatmapImporterTests.cs
index d2193350ad..a6edd6cb5f 100644
--- a/osu.Game.Tests/Database/BeatmapImporterTests.cs
+++ b/osu.Game.Tests/Database/BeatmapImporterTests.cs
@@ -852,7 +852,11 @@ namespace osu.Game.Tests.Database
         {
             IQueryable<RealmBeatmapSet>? resultSets = null;
 
-            waitForOrAssert(() => (resultSets = realm.All<RealmBeatmapSet>().Where(s => !s.DeletePending && s.OnlineID == 241526)).Any(),
+            waitForOrAssert(() =>
+                {
+                    realm.Refresh();
+                    return (resultSets = realm.All<RealmBeatmapSet>().Where(s => !s.DeletePending && s.OnlineID == 241526)).Any();
+                },
                 @"BeatmapSet did not import to the database in allocated time.", timeout);
 
             // ensure we were stored to beatmap database backing...
@@ -865,16 +869,16 @@ namespace osu.Game.Tests.Database
             // ReSharper disable once PossibleUnintendedReferenceComparison
             IEnumerable<RealmBeatmap> queryBeatmaps() => realm.All<RealmBeatmap>().Where(s => s.BeatmapSet != null && s.BeatmapSet == set);
 
-            waitForOrAssert(() => queryBeatmaps().Count() == 12, @"Beatmaps did not import to the database in allocated time", timeout);
-            waitForOrAssert(() => queryBeatmapSets().Count() == 1, @"BeatmapSet did not import to the database in allocated time", timeout);
+            Assert.AreEqual(12, queryBeatmaps().Count(), @"Beatmap count was not correct");
+            Assert.AreEqual(1, queryBeatmapSets().Count(), @"Beatmapset count was not correct");
 
-            int countBeatmapSetBeatmaps = 0;
-            int countBeatmaps = 0;
+            int countBeatmapSetBeatmaps;
+            int countBeatmaps;
 
-            waitForOrAssert(() =>
-                    (countBeatmapSetBeatmaps = queryBeatmapSets().First().Beatmaps.Count) ==
-                    (countBeatmaps = queryBeatmaps().Count()),
-                $@"Incorrect database beatmap count post-import ({countBeatmaps} but should be {countBeatmapSetBeatmaps}).", timeout);
+            Assert.AreEqual(
+                countBeatmapSetBeatmaps = queryBeatmapSets().First().Beatmaps.Count,
+                countBeatmaps = queryBeatmaps().Count(),
+                $@"Incorrect database beatmap count post-import ({countBeatmaps} but should be {countBeatmapSetBeatmaps}).");
 
             foreach (RealmBeatmap b in set.Beatmaps)
                 Assert.IsTrue(set.Beatmaps.Any(c => c.OnlineID == b.OnlineID));

From 6bf9327228e66b49e4c3cd590e055eb5bf7bad8a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 30 Nov 2021 15:17:16 +0900
Subject: [PATCH 1389/5547] Add linking property on `SkinFileInfo` to allow EF
 to understand the link post-rename

---
 osu.Game/Database/OsuDbContext.cs | 1 +
 osu.Game/Skinning/SkinFileInfo.cs | 3 +++
 2 files changed, 4 insertions(+)

diff --git a/osu.Game/Database/OsuDbContext.cs b/osu.Game/Database/OsuDbContext.cs
index 26f287da26..13d362e0be 100644
--- a/osu.Game/Database/OsuDbContext.cs
+++ b/osu.Game/Database/OsuDbContext.cs
@@ -135,6 +135,7 @@ namespace osu.Game.Database
 
             modelBuilder.Entity<EFSkinInfo>().HasIndex(b => b.Hash).IsUnique();
             modelBuilder.Entity<EFSkinInfo>().HasIndex(b => b.DeletePending);
+            modelBuilder.Entity<EFSkinInfo>().HasMany(s => s.Files).WithOne(f => f.SkinInfo);
 
             modelBuilder.Entity<DatabasedSetting>().HasIndex(b => new { b.RulesetID, b.Variant });
 
diff --git a/osu.Game/Skinning/SkinFileInfo.cs b/osu.Game/Skinning/SkinFileInfo.cs
index db7cd953bb..4a86a6ed94 100644
--- a/osu.Game/Skinning/SkinFileInfo.cs
+++ b/osu.Game/Skinning/SkinFileInfo.cs
@@ -2,6 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System.ComponentModel.DataAnnotations;
+using System.ComponentModel.DataAnnotations.Schema;
 using osu.Game.Database;
 using osu.Game.IO;
 
@@ -13,6 +14,8 @@ namespace osu.Game.Skinning
 
         public int SkinInfoID { get; set; }
 
+        public EFSkinInfo SkinInfo { get; set; }
+
         public int FileInfoID { get; set; }
 
         public FileInfo FileInfo { get; set; }

From a943089be261495bbc7c1aec19bff731d5277543 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 30 Nov 2021 15:17:26 +0900
Subject: [PATCH 1390/5547] Add support for migration of skins from EF to Realm

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

diff --git a/osu.Game/Database/RealmContextFactory.cs b/osu.Game/Database/RealmContextFactory.cs
index 911c88a61f..290b42311c 100644
--- a/osu.Game/Database/RealmContextFactory.cs
+++ b/osu.Game/Database/RealmContextFactory.cs
@@ -5,6 +5,7 @@ using System;
 using System.Linq;
 using System.Reflection;
 using System.Threading;
+using Microsoft.EntityFrameworkCore;
 using osu.Framework.Allocation;
 using osu.Framework.Development;
 using osu.Framework.Input.Bindings;
@@ -205,6 +206,61 @@ namespace osu.Game.Database
                 return;
 
             using (var db = efContextFactory.GetForWrite())
+            {
+                migrateSettings(db);
+                migrateSkins(db);
+            }
+
+            void migrateSkins(DatabaseWriteUsage db)
+            {
+                // migrate ruleset settings. can be removed 20220530.
+                var existingSkins = db.Context.SkinInfo
+                                      .Include(s => s.Files)
+                                      .ThenInclude(f => f.FileInfo);
+
+                // previous entries in EF are removed post migration.
+                if (!existingSkins.Any())
+                    return;
+
+                using (var realm = CreateContext())
+                using (var transaction = realm.BeginWrite())
+                {
+                    // only migrate data if the realm database is empty.
+                    if (!realm.All<SkinInfo>().Any(s => !s.Protected))
+                    {
+                        foreach (var skin in existingSkins)
+                        {
+                            var realmSkin = new SkinInfo
+                            {
+                                Name = skin.Name,
+                                Creator = skin.Creator,
+                                Hash = skin.Hash,
+                                Protected = false,
+                                InstantiationInfo = skin.InstantiationInfo,
+                            };
+
+                            foreach (var file in skin.Files)
+                            {
+                                var realmFile = realm.Find<RealmFile>(file.FileInfo.Hash);
+
+                                if (realmFile == null)
+                                    realm.Add(realmFile = new RealmFile { Hash = file.FileInfo.Hash });
+
+                                realmSkin.Files.Add(new RealmNamedFileUsage(realmFile, file.Filename));
+                            }
+
+                            realm.Add(realmSkin);
+                        }
+                    }
+
+                    db.Context.RemoveRange(existingSkins);
+                    // Intentionally don't clean up the files, so they don't get purged by EF.
+
+                    transaction.Commit();
+                }
+            }
+
+            void migrateSettings(DatabaseWriteUsage db)
             {
                 // migrate ruleset settings. can be removed 20220315.
                 var existingSettings = db.Context.DatabasedSetting;

From 0efd565c8b974986effde26819648030eb8ea326 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 30 Nov 2021 15:41:07 +0900
Subject: [PATCH 1391/5547] Remove forgotten using statement

---
 osu.Game/Skinning/SkinFileInfo.cs | 1 -
 1 file changed, 1 deletion(-)

diff --git a/osu.Game/Skinning/SkinFileInfo.cs b/osu.Game/Skinning/SkinFileInfo.cs
index 4a86a6ed94..f414687b33 100644
--- a/osu.Game/Skinning/SkinFileInfo.cs
+++ b/osu.Game/Skinning/SkinFileInfo.cs
@@ -2,7 +2,6 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System.ComponentModel.DataAnnotations;
-using System.ComponentModel.DataAnnotations.Schema;
 using osu.Game.Database;
 using osu.Game.IO;
 

From 6f66ecd77be4d6e5fc9b9a03308b2600ebf92c31 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 30 Nov 2021 15:41:18 +0900
Subject: [PATCH 1392/5547] Move migrations to own file and add user skin
 choice config migration

---
 osu.Game/Database/EFToRealmMigrator.cs   | 147 +++++++++++++++++++++++
 osu.Game/Database/RealmContextFactory.cs | 107 -----------------
 osu.Game/OsuGameBase.cs                  |   2 +
 3 files changed, 149 insertions(+), 107 deletions(-)
 create mode 100644 osu.Game/Database/EFToRealmMigrator.cs

diff --git a/osu.Game/Database/EFToRealmMigrator.cs b/osu.Game/Database/EFToRealmMigrator.cs
new file mode 100644
index 0000000000..670eb95ad6
--- /dev/null
+++ b/osu.Game/Database/EFToRealmMigrator.cs
@@ -0,0 +1,147 @@
+// 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 Microsoft.EntityFrameworkCore;
+using osu.Game.Configuration;
+using osu.Game.Models;
+using osu.Game.Skinning;
+
+#nullable enable
+
+namespace osu.Game.Database
+{
+    internal class EFToRealmMigrator
+    {
+        private readonly DatabaseContextFactory efContextFactory;
+        private readonly RealmContextFactory realmContextFactory;
+        private readonly OsuConfigManager config;
+
+        public EFToRealmMigrator(DatabaseContextFactory efContextFactory, RealmContextFactory realmContextFactory, OsuConfigManager config)
+        {
+            this.efContextFactory = efContextFactory;
+            this.realmContextFactory = realmContextFactory;
+            this.config = config;
+        }
+
+        public void Run()
+        {
+            using (var db = efContextFactory.GetForWrite())
+            {
+                migrateSettings(db);
+                migrateSkins(db);
+            }
+        }
+
+        private void migrateSkins(DatabaseWriteUsage db)
+        {
+            var userSkinChoice = config.GetBindable<string>(OsuSetting.Skin);
+            int.TryParse(userSkinChoice.Value, out int userSkinInt);
+
+            switch (userSkinInt)
+            {
+                case EFSkinInfo.DEFAULT_SKIN:
+                    userSkinChoice.Value = SkinInfo.DEFAULT_SKIN.ToString();
+                    break;
+
+                case EFSkinInfo.CLASSIC_SKIN:
+                    userSkinChoice.Value = SkinInfo.CLASSIC_SKIN.ToString();
+                    break;
+            }
+
+            // migrate ruleset settings. can be removed 20220530.
+            var existingSkins = db.Context.SkinInfo
+                                  .Include(s => s.Files)
+                                  .ThenInclude(f => f.FileInfo)
+                                  .ToList();
+
+            // previous entries in EF are removed post migration.
+            if (!existingSkins.Any())
+                return;
+
+            using (var realm = realmContextFactory.CreateContext())
+            using (var transaction = realm.BeginWrite())
+            {
+                // only migrate data if the realm database is empty.
+                if (!realm.All<SkinInfo>().Any(s => !s.Protected))
+                {
+                    foreach (var skin in existingSkins)
+                    {
+                        var realmSkin = new SkinInfo
+                        {
+                            Name = skin.Name,
+                            Creator = skin.Creator,
+                            Hash = skin.Hash,
+                            Protected = false,
+                            InstantiationInfo = skin.InstantiationInfo,
+                        };
+
+                        foreach (var file in skin.Files)
+                        {
+                            var realmFile = realm.Find<RealmFile>(file.FileInfo.Hash);
+
+                            if (realmFile == null)
+                                realm.Add(realmFile = new RealmFile { Hash = file.FileInfo.Hash });
+
+                            realmSkin.Files.Add(new RealmNamedFileUsage(realmFile, file.Filename));
+                        }
+
+                        realm.Add(realmSkin);
+
+                        if (skin.ID == userSkinInt)
+                            userSkinChoice.Value = realmSkin.ID.ToString();
+                    }
+                }
+
+                db.Context.RemoveRange(existingSkins);
+                // Intentionally don't clean up the files, so they don't get purged by EF.
+
+                transaction.Commit();
+            }
+        }
+
+        private void migrateSettings(DatabaseWriteUsage db)
+        {
+            // migrate ruleset settings. can be removed 20220315.
+            var existingSettings = db.Context.DatabasedSetting;
+
+            // previous entries in EF are removed post migration.
+            if (!existingSettings.Any())
+                return;
+
+            using (var realm = realmContextFactory.CreateContext())
+            using (var transaction = realm.BeginWrite())
+            {
+                // only migrate data if the realm database is empty.
+                if (!realm.All<RealmRulesetSetting>().Any())
+                {
+                    foreach (var dkb in existingSettings)
+                    {
+                        if (dkb.RulesetID == null)
+                            continue;
+
+                        string? shortName = getRulesetShortNameFromLegacyID(dkb.RulesetID.Value);
+
+                        if (string.IsNullOrEmpty(shortName))
+                            continue;
+
+                        realm.Add(new RealmRulesetSetting
+                        {
+                            Key = dkb.Key,
+                            Value = dkb.StringValue,
+                            RulesetName = shortName,
+                            Variant = dkb.Variant ?? 0,
+                        });
+                    }
+                }
+
+                db.Context.RemoveRange(existingSettings);
+
+                transaction.Commit();
+            }
+        }
+
+        private string? getRulesetShortNameFromLegacyID(long rulesetId) =>
+            efContextFactory.Get().RulesetInfo.FirstOrDefault(r => r.ID == rulesetId)?.ShortName;
+    }
+}
diff --git a/osu.Game/Database/RealmContextFactory.cs b/osu.Game/Database/RealmContextFactory.cs
index 290b42311c..c6acd3097c 100644
--- a/osu.Game/Database/RealmContextFactory.cs
+++ b/osu.Game/Database/RealmContextFactory.cs
@@ -5,7 +5,6 @@ using System;
 using System.Linq;
 using System.Reflection;
 using System.Threading;
-using Microsoft.EntityFrameworkCore;
 using osu.Framework.Allocation;
 using osu.Framework.Development;
 using osu.Framework.Input.Bindings;
@@ -103,10 +102,6 @@ namespace osu.Game.Database
 
             // This method triggers the first `CreateContext` call, which will implicitly run realm migrations and bring the schema up-to-date.
             cleanupPendingDeletions();
-
-            // Data migration is handled separately from schema migrations.
-            // This is required as the user may be initialising realm for the first time ever, which would result in no schema migrations running.
-            migrateDataFromEF();
         }
 
         private void cleanupPendingDeletions()
@@ -200,108 +195,6 @@ namespace osu.Game.Database
             };
         }
 
-        private void migrateDataFromEF()
-        {
-            if (efContextFactory == null)
-                return;
-
-            using (var db = efContextFactory.GetForWrite())
-            {
-                migrateSettings(db);
-                migrateSkins(db);
-            }
-
-            void migrateSkins(DatabaseWriteUsage db)
-            {
-                // migrate ruleset settings. can be removed 20220530.
-                var existingSkins = db.Context.SkinInfo
-                                      .Include(s => s.Files)
-                                      .ThenInclude(f => f.FileInfo);
-
-                // previous entries in EF are removed post migration.
-                if (!existingSkins.Any())
-                    return;
-
-                using (var realm = CreateContext())
-                using (var transaction = realm.BeginWrite())
-                {
-                    // only migrate data if the realm database is empty.
-                    if (!realm.All<SkinInfo>().Any(s => !s.Protected))
-                    {
-                        foreach (var skin in existingSkins)
-                        {
-                            var realmSkin = new SkinInfo
-                            {
-                                Name = skin.Name,
-                                Creator = skin.Creator,
-                                Hash = skin.Hash,
-                                Protected = false,
-                                InstantiationInfo = skin.InstantiationInfo,
-                            };
-
-                            foreach (var file in skin.Files)
-                            {
-                                var realmFile = realm.Find<RealmFile>(file.FileInfo.Hash);
-
-                                if (realmFile == null)
-                                    realm.Add(realmFile = new RealmFile { Hash = file.FileInfo.Hash });
-
-                                realmSkin.Files.Add(new RealmNamedFileUsage(realmFile, file.Filename));
-                            }
-
-                            realm.Add(realmSkin);
-                        }
-                    }
-
-                    db.Context.RemoveRange(existingSkins);
-                    // Intentionally don't clean up the files, so they don't get purged by EF.
-
-                    transaction.Commit();
-                }
-            }
-
-            void migrateSettings(DatabaseWriteUsage db)
-            {
-                // migrate ruleset settings. can be removed 20220315.
-                var existingSettings = db.Context.DatabasedSetting;
-
-                // previous entries in EF are removed post migration.
-                if (!existingSettings.Any())
-                    return;
-
-                using (var realm = CreateContext())
-                using (var transaction = realm.BeginWrite())
-                {
-                    // only migrate data if the realm database is empty.
-                    if (!realm.All<RealmRulesetSetting>().Any())
-                    {
-                        foreach (var dkb in existingSettings)
-                        {
-                            if (dkb.RulesetID == null)
-                                continue;
-
-                            string? shortName = getRulesetShortNameFromLegacyID(dkb.RulesetID.Value);
-
-                            if (string.IsNullOrEmpty(shortName))
-                                continue;
-
-                            realm.Add(new RealmRulesetSetting
-                            {
-                                Key = dkb.Key,
-                                Value = dkb.StringValue,
-                                RulesetName = shortName,
-                                Variant = dkb.Variant ?? 0,
-                            });
-                        }
-                    }
-
-                    db.Context.RemoveRange(existingSettings);
-
-                    transaction.Commit();
-                }
-            }
-        }
-
         private void onMigration(Migration migration, ulong lastSchemaVersion)
         {
             for (ulong i = lastSchemaVersion + 1; i <= schema_version; i++)
diff --git a/osu.Game/OsuGameBase.cs b/osu.Game/OsuGameBase.cs
index 4bae6f3c1d..f6e2c780ed 100644
--- a/osu.Game/OsuGameBase.cs
+++ b/osu.Game/OsuGameBase.cs
@@ -198,6 +198,8 @@ namespace osu.Game
 
             dependencies.Cache(realmFactory = new RealmContextFactory(Storage, "client", contextFactory));
 
+            new EFToRealmMigrator(contextFactory, realmFactory, LocalConfig).Run();
+
             dependencies.CacheAs(Storage);
 
             var largeStore = new LargeTextureStore(Host.CreateTextureLoaderStore(new NamespacedResourceStore<byte[]>(Resources, @"Textures")));

From 049d9ce5ef5b906278b39bf83d9e5eac17284993 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 30 Nov 2021 17:09:32 +0900
Subject: [PATCH 1393/5547] Add test coverage of match type propagating to
 other users' settings

---
 .../Visual/Multiplayer/TestSceneTeamVersus.cs | 20 +++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs
index c70906927e..7763e11609 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs
@@ -11,6 +11,7 @@ using osu.Framework.Testing;
 using osu.Game.Beatmaps;
 using osu.Game.Database;
 using osu.Game.Online.API.Requests.Responses;
+using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Multiplayer.MatchTypes.TeamVersus;
 using osu.Game.Online.Rooms;
 using osu.Game.Rulesets;
@@ -118,6 +119,25 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddAssert("user still on team 0", () => (client.Room?.Users.FirstOrDefault()?.MatchState as TeamVersusUserState)?.TeamID == 0);
         }
 
+        [Test]
+        public void TestSettingsUpdatedWhenChangingQueueMode()
+        {
+            createRoom(() => new Room
+            {
+                Name = { Value = "Test Room" },
+                Type = { Value = MatchType.TeamVersus }
+            });
+
+            AddUntilStep("match type versus", () => client.APIRoom?.Type.Value == MatchType.HeadToHead);
+
+            AddStep("change match type", () => client.ChangeSettings(new MultiplayerRoomSettings
+            {
+                MatchType = MatchType.TeamVersus
+            }));
+
+            AddUntilStep("api room updated", () => client.APIRoom?.Type.Value == MatchType.TeamVersus);
+        }
+
         [Test]
         public void TestChangeTypeViaMatchSettings()
         {

From 25b9575de01d4a7d35dc19ece9b6748506f60cab Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 30 Nov 2021 17:09:40 +0900
Subject: [PATCH 1394/5547] Fix missing transfer of match type to settings

---
 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 4c472164d6..02fb94133a 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
@@ -694,6 +694,7 @@ namespace osu.Game.Online.Multiplayer
             Room.Settings = settings;
             APIRoom.Name.Value = Room.Settings.Name;
             APIRoom.Password.Value = Room.Settings.Password;
+            APIRoom.Type.Value = Room.Settings.MatchType;
             APIRoom.QueueMode.Value = Room.Settings.QueueMode;
             RoomUpdated?.Invoke();
 

From 8de06803a8f3285d683c8db38a818e5a9c4b4ced Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 30 Nov 2021 17:16:30 +0900
Subject: [PATCH 1395/5547] Fix incorrect test step text

Co-authored-by: Dan Balasescu <smoogipoo@smgi.me>
---
 osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs
index 7763e11609..e00939a4de 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs
@@ -120,7 +120,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         }
 
         [Test]
-        public void TestSettingsUpdatedWhenChangingQueueMode()
+        public void TestSettingsUpdatedWhenChangingMatchType()
         {
             createRoom(() => new Room
             {

From 23e297d414815477ed71f4e6e9360aee2bb8f7ce Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 30 Nov 2021 19:08:51 +0900
Subject: [PATCH 1396/5547] Log output response sizes

Visibility is the first step towards action. Or something.
---
 osu.Game/Online/API/APIRequest.cs | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Online/API/APIRequest.cs b/osu.Game/Online/API/APIRequest.cs
index 43195811dc..efb0b102d0 100644
--- a/osu.Game/Online/API/APIRequest.cs
+++ b/osu.Game/Online/API/APIRequest.cs
@@ -38,7 +38,12 @@ namespace osu.Game.Online.API
         protected override void PostProcess()
         {
             base.PostProcess();
-            Response = ((OsuJsonWebRequest<T>)WebRequest)?.ResponseObject;
+
+            if (WebRequest != null)
+            {
+                Response = ((OsuJsonWebRequest<T>)WebRequest).ResponseObject;
+                Logger.Log($"{GetType()} finished with response size of {WebRequest.ResponseStream.Length:#,0} bytes");
+            }
         }
 
         internal void TriggerSuccess(T result)

From 87883f1fe433608090aebdeaa981632310fa5158 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 30 Nov 2021 19:27:43 +0900
Subject: [PATCH 1397/5547] Add `BeatmapLookupCache`

---
 osu.Game/Database/BeatmapLookupCache.cs | 143 ++++++++++++++++++++++++
 osu.Game/OsuGameBase.cs                 |   4 +
 2 files changed, 147 insertions(+)
 create mode 100644 osu.Game/Database/BeatmapLookupCache.cs

diff --git a/osu.Game/Database/BeatmapLookupCache.cs b/osu.Game/Database/BeatmapLookupCache.cs
new file mode 100644
index 0000000000..c4e20d59b6
--- /dev/null
+++ b/osu.Game/Database/BeatmapLookupCache.cs
@@ -0,0 +1,143 @@
+// 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 System.Threading;
+using System.Threading.Tasks;
+using JetBrains.Annotations;
+using osu.Framework.Allocation;
+using osu.Game.Online.API;
+using osu.Game.Online.API.Requests;
+using osu.Game.Online.API.Requests.Responses;
+
+namespace osu.Game.Database
+{
+    // This class is based on `UserLookupCache` which is well tested.
+    // If modifications are to be made here, a base abstract implementation should likely be created and shared between the two.
+    public class BeatmapLookupCache : MemoryCachingComponent<int, APIBeatmap>
+    {
+        [Resolved]
+        private IAPIProvider api { get; set; }
+
+        /// <summary>
+        /// Perform an API lookup on the specified beatmap, populating a <see cref="APIBeatmap"/> model.
+        /// </summary>
+        /// <param name="beatmapId">The beatmap to lookup.</param>
+        /// <param name="token">An optional cancellation token.</param>
+        /// <returns>The populated beatmap, or null if the beatmap does not exist or the request could not be satisfied.</returns>
+        [ItemCanBeNull]
+        public Task<APIBeatmap> GetBeatmapAsync(int beatmapId, CancellationToken token = default) => GetAsync(beatmapId, token);
+
+        /// <summary>
+        /// Perform an API lookup on the specified beatmaps, populating a <see cref="APIBeatmap"/> model.
+        /// </summary>
+        /// <param name="beatmapIds">The beatmaps to lookup.</param>
+        /// <param name="token">An optional cancellation token.</param>
+        /// <returns>The populated beatmaps. May include null results for failed retrievals.</returns>
+        public Task<APIBeatmap[]> GetBeatmapsAsync(int[] beatmapIds, CancellationToken token = default)
+        {
+            var beatmapLookupTasks = new List<Task<APIBeatmap>>();
+
+            foreach (int u in beatmapIds)
+            {
+                beatmapLookupTasks.Add(GetBeatmapAsync(u, token).ContinueWith(task =>
+                {
+                    if (!task.IsCompletedSuccessfully)
+                        return null;
+
+                    return task.Result;
+                }, token));
+            }
+
+            return Task.WhenAll(beatmapLookupTasks);
+        }
+
+        protected override async Task<APIBeatmap> ComputeValueAsync(int lookup, CancellationToken token = default)
+            => await queryBeatmap(lookup).ConfigureAwait(false);
+
+        private readonly Queue<(int id, TaskCompletionSource<APIBeatmap>)> pendingBeatmapTasks = new Queue<(int, TaskCompletionSource<APIBeatmap>)>();
+        private Task pendingRequestTask;
+        private readonly object taskAssignmentLock = new object();
+
+        private Task<APIBeatmap> queryBeatmap(int beatmapId)
+        {
+            lock (taskAssignmentLock)
+            {
+                var tcs = new TaskCompletionSource<APIBeatmap>();
+
+                // Add to the queue.
+                pendingBeatmapTasks.Enqueue((beatmapId, tcs));
+
+                // Create a request task if there's not already one.
+                if (pendingRequestTask == null)
+                    createNewTask();
+
+                return tcs.Task;
+            }
+        }
+
+        private void performLookup()
+        {
+            // contains at most 50 unique beatmap IDs from beatmapTasks, which is used to perform the lookup.
+            var beatmapTasks = new Dictionary<int, List<TaskCompletionSource<APIBeatmap>>>();
+
+            // Grab at most 50 unique beatmap IDs from the queue.
+            lock (taskAssignmentLock)
+            {
+                while (pendingBeatmapTasks.Count > 0 && beatmapTasks.Count < 1)
+                {
+                    (int id, TaskCompletionSource<APIBeatmap> task) next = pendingBeatmapTasks.Dequeue();
+
+                    // Perform a secondary check for existence, in case the beatmap was queried in a previous batch.
+                    if (CheckExists(next.id, out var existing))
+                        next.task.SetResult(existing);
+                    else
+                    {
+                        if (beatmapTasks.TryGetValue(next.id, out var tasks))
+                            tasks.Add(next.task);
+                        else
+                            beatmapTasks[next.id] = new List<TaskCompletionSource<APIBeatmap>> { next.task };
+                    }
+                }
+            }
+
+            // Query the beatmaps.
+            var request = new GetBeatmapRequest(new APIBeatmap { OnlineID = beatmapTasks.Keys.First() });
+
+            // rather than queueing, we maintain our own single-threaded request stream.
+            // todo: we probably want retry logic here.
+            api.Perform(request);
+
+            // Create a new request task if there's still more beatmaps to query.
+            lock (taskAssignmentLock)
+            {
+                pendingRequestTask = null;
+                if (pendingBeatmapTasks.Count > 0)
+                    createNewTask();
+            }
+
+            List<APIBeatmap> foundBeatmaps = new List<APIBeatmap> { request.Response };
+
+            foreach (var beatmap in foundBeatmaps)
+            {
+                if (beatmapTasks.TryGetValue(beatmap.OnlineID, out var tasks))
+                {
+                    foreach (var task in tasks)
+                        task.SetResult(beatmap);
+
+                    beatmapTasks.Remove(beatmap.OnlineID);
+                }
+            }
+
+            // if any tasks remain which were not satisfied, return null.
+            foreach (var tasks in beatmapTasks.Values)
+            {
+                foreach (var task in tasks)
+                    task.SetResult(null);
+            }
+        }
+
+        private void createNewTask() => pendingRequestTask = Task.Run(performLookup);
+    }
+}
diff --git a/osu.Game/OsuGameBase.cs b/osu.Game/OsuGameBase.cs
index 6eb67b34e8..34344f8022 100644
--- a/osu.Game/OsuGameBase.cs
+++ b/osu.Game/OsuGameBase.cs
@@ -142,6 +142,7 @@ namespace osu.Game
         private BeatmapDifficultyCache difficultyCache;
 
         private UserLookupCache userCache;
+        private BeatmapLookupCache beatmapCache;
 
         private FileStore fileStore;
 
@@ -265,6 +266,9 @@ namespace osu.Game
             dependencies.Cache(userCache = new UserLookupCache());
             AddInternal(userCache);
 
+            dependencies.Cache(beatmapCache = new BeatmapLookupCache());
+            AddInternal(beatmapCache);
+
             var scorePerformanceManager = new ScorePerformanceCache();
             dependencies.Cache(scorePerformanceManager);
             AddInternal(scorePerformanceManager);

From f58c5cd9c0f2d9a6ffaf0457d11cb62cc124249e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 30 Nov 2021 19:36:25 +0900
Subject: [PATCH 1398/5547] Update `MultiplayerClient` to use
 `BeatmapLookupCache`

---
 .../Online/Multiplayer/MultiplayerClient.cs   | 20 +++++---------
 .../Multiplayer/OnlineMultiplayerClient.cs    | 27 +++++--------------
 .../Multiplayer/TestMultiplayerClient.cs      | 15 ++++++-----
 3 files changed, 20 insertions(+), 42 deletions(-)

diff --git a/osu.Game/Online/Multiplayer/MultiplayerClient.cs b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
index 4c472164d6..aa91d5e56f 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
@@ -702,15 +702,7 @@ namespace osu.Game.Online.Multiplayer
 
         private async Task<PlaylistItem> createPlaylistItem(MultiplayerPlaylistItem item)
         {
-            var set = await GetOnlineBeatmapSet(item.BeatmapID).ConfigureAwait(false);
-
-            // The incoming response is deserialised without circular reference handling currently.
-            // Because we require using metadata from this instance, populate the nested beatmaps' sets manually here.
-            foreach (var b in set.Beatmaps)
-                b.BeatmapSet = set;
-
-            var beatmap = set.Beatmaps.Single(b => b.OnlineID == item.BeatmapID);
-            beatmap.Checksum = item.BeatmapChecksum;
+            var apiBeatmap = await GetOnlineBeatmapSet(item.BeatmapID).ConfigureAwait(false);
 
             var ruleset = Rulesets.GetRuleset(item.RulesetID);
             var rulesetInstance = ruleset.CreateInstance();
@@ -719,7 +711,7 @@ namespace osu.Game.Online.Multiplayer
             {
                 ID = item.ID,
                 OwnerID = item.OwnerID,
-                Beatmap = { Value = beatmap },
+                Beatmap = { Value = apiBeatmap },
                 Ruleset = { Value = ruleset },
                 Expired = item.Expired
             };
@@ -731,12 +723,12 @@ namespace osu.Game.Online.Multiplayer
         }
 
         /// <summary>
-        /// Retrieves a <see cref="APIBeatmapSet"/> from an online source.
+        /// Retrieves a <see cref="APIBeatmap"/> from an online source.
         /// </summary>
-        /// <param name="beatmapId">The beatmap set ID.</param>
+        /// <param name="beatmapId">The beatmap ID.</param>
         /// <param name="cancellationToken">A token to cancel the request.</param>
-        /// <returns>The <see cref="APIBeatmapSet"/> retrieval task.</returns>
-        protected abstract Task<APIBeatmapSet> GetOnlineBeatmapSet(int beatmapId, CancellationToken cancellationToken = default);
+        /// <returns>The <see cref="APIBeatmap"/> retrieval task.</returns>
+        protected abstract Task<APIBeatmap> GetOnlineBeatmapSet(int beatmapId, CancellationToken cancellationToken = default);
 
         /// <summary>
         /// For the provided user ID, update whether the user is included in <see cref="CurrentMatchPlayingUserIds"/>.
diff --git a/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs b/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs
index 7308c03ec3..de974cb3e1 100644
--- a/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs
@@ -9,8 +9,8 @@ using System.Threading.Tasks;
 using Microsoft.AspNetCore.SignalR.Client;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
+using osu.Game.Database;
 using osu.Game.Online.API;
-using osu.Game.Online.API.Requests;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Rooms;
 
@@ -29,6 +29,9 @@ namespace osu.Game.Online.Multiplayer
 
         private HubConnection? connection => connector?.CurrentConnection;
 
+        [Resolved]
+        private BeatmapLookupCache beatmapLookupCache { get; set; } = null!;
+
         public OnlineMultiplayerClient(EndpointConfiguration endpoints)
         {
             endpoint = endpoints.MultiplayerEndpointUrl;
@@ -159,27 +162,9 @@ namespace osu.Game.Online.Multiplayer
             return connection.InvokeAsync(nameof(IMultiplayerServer.AddPlaylistItem), item);
         }
 
-        protected override Task<APIBeatmapSet> GetOnlineBeatmapSet(int beatmapId, CancellationToken cancellationToken = default)
+        protected override Task<APIBeatmap> GetOnlineBeatmapSet(int beatmapId, CancellationToken cancellationToken = default)
         {
-            var tcs = new TaskCompletionSource<APIBeatmapSet>();
-            var req = new GetBeatmapSetRequest(beatmapId, BeatmapSetLookupType.BeatmapId);
-
-            req.Success += res =>
-            {
-                if (cancellationToken.IsCancellationRequested)
-                {
-                    tcs.SetCanceled();
-                    return;
-                }
-
-                tcs.SetResult(res);
-            };
-
-            req.Failure += e => tcs.SetException(e);
-
-            API.Queue(req);
-
-            return tcs.Task;
+            return beatmapLookupCache.GetBeatmapAsync(beatmapId, cancellationToken);
         }
 
         protected override void Dispose(bool isDisposing)
diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
index 2d77e17513..39199ae304 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
@@ -336,7 +336,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
         public override Task AddPlaylistItem(MultiplayerPlaylistItem item) => AddUserPlaylistItem(api.LocalUser.Value.OnlineID, item);
 
-        protected override Task<APIBeatmapSet> GetOnlineBeatmapSet(int beatmapId, CancellationToken cancellationToken = default)
+        protected override Task<APIBeatmap> GetOnlineBeatmapSet(int beatmapId, CancellationToken cancellationToken = default)
         {
             IBeatmapSetInfo? set = roomManager.ServerSideRooms.SelectMany(r => r.Playlist)
                                               .FirstOrDefault(p => p.BeatmapID == beatmapId)?.Beatmap.Value.BeatmapSet
@@ -345,13 +345,14 @@ namespace osu.Game.Tests.Visual.Multiplayer
             if (set == null)
                 throw new InvalidOperationException("Beatmap not found.");
 
-            var apiSet = new APIBeatmapSet
+            return Task.FromResult(new APIBeatmap
             {
-                OnlineID = set.OnlineID,
-                Beatmaps = set.Beatmaps.Select(b => new APIBeatmap { OnlineID = b.OnlineID }).ToArray(),
-            };
-
-            return Task.FromResult(apiSet);
+                BeatmapSet = new APIBeatmapSet
+                {
+                    OnlineID = set.OnlineID,
+                },
+                OnlineID = set.Beatmaps.First().OnlineID
+            });
         }
 
         private async Task changeMatchType(MatchType type)

From 01bc330d1ce8468cecd95f83bca02be187730867 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 30 Nov 2021 19:42:46 +0900
Subject: [PATCH 1399/5547] Rename method to match new purpose

---
 osu.Game/Online/Multiplayer/MultiplayerClient.cs           | 4 ++--
 osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs     | 2 +-
 osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs | 2 +-
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Online/Multiplayer/MultiplayerClient.cs b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
index aa91d5e56f..478da983cd 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
@@ -702,7 +702,7 @@ namespace osu.Game.Online.Multiplayer
 
         private async Task<PlaylistItem> createPlaylistItem(MultiplayerPlaylistItem item)
         {
-            var apiBeatmap = await GetOnlineBeatmapSet(item.BeatmapID).ConfigureAwait(false);
+            var apiBeatmap = await GetAPIBeatmap(item.BeatmapID).ConfigureAwait(false);
 
             var ruleset = Rulesets.GetRuleset(item.RulesetID);
             var rulesetInstance = ruleset.CreateInstance();
@@ -728,7 +728,7 @@ namespace osu.Game.Online.Multiplayer
         /// <param name="beatmapId">The beatmap ID.</param>
         /// <param name="cancellationToken">A token to cancel the request.</param>
         /// <returns>The <see cref="APIBeatmap"/> retrieval task.</returns>
-        protected abstract Task<APIBeatmap> GetOnlineBeatmapSet(int beatmapId, CancellationToken cancellationToken = default);
+        protected abstract Task<APIBeatmap> GetAPIBeatmap(int beatmapId, CancellationToken cancellationToken = default);
 
         /// <summary>
         /// For the provided user ID, update whether the user is included in <see cref="CurrentMatchPlayingUserIds"/>.
diff --git a/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs b/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs
index de974cb3e1..41687b54b0 100644
--- a/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs
@@ -162,7 +162,7 @@ namespace osu.Game.Online.Multiplayer
             return connection.InvokeAsync(nameof(IMultiplayerServer.AddPlaylistItem), item);
         }
 
-        protected override Task<APIBeatmap> GetOnlineBeatmapSet(int beatmapId, CancellationToken cancellationToken = default)
+        protected override Task<APIBeatmap> GetAPIBeatmap(int beatmapId, CancellationToken cancellationToken = default)
         {
             return beatmapLookupCache.GetBeatmapAsync(beatmapId, cancellationToken);
         }
diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
index 39199ae304..037dccc63f 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
@@ -336,7 +336,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
         public override Task AddPlaylistItem(MultiplayerPlaylistItem item) => AddUserPlaylistItem(api.LocalUser.Value.OnlineID, item);
 
-        protected override Task<APIBeatmap> GetOnlineBeatmapSet(int beatmapId, CancellationToken cancellationToken = default)
+        protected override Task<APIBeatmap> GetAPIBeatmap(int beatmapId, CancellationToken cancellationToken = default)
         {
             IBeatmapSetInfo? set = roomManager.ServerSideRooms.SelectMany(r => r.Playlist)
                                               .FirstOrDefault(p => p.BeatmapID == beatmapId)?.Beatmap.Value.BeatmapSet

From 23dd21339ddf8fd973817e6c19fe18fcdd8b3156 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 27 Nov 2021 13:39:09 +0100
Subject: [PATCH 1400/5547] Delay online fetch of non-current playlist item on
 room join

---
 .../Online/Multiplayer/MultiplayerClient.cs   | 27 ++++++++++++++-----
 1 file changed, 20 insertions(+), 7 deletions(-)

diff --git a/osu.Game/Online/Multiplayer/MultiplayerClient.cs b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
index 478da983cd..4b44d5724f 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
@@ -139,7 +139,7 @@ namespace osu.Game.Online.Multiplayer
                 Debug.Assert(joinedRoom != null);
 
                 // Populate playlist items.
-                var playlistItems = await Task.WhenAll(joinedRoom.Playlist.Select(createPlaylistItem)).ConfigureAwait(false);
+                var playlistItems = await Task.WhenAll(joinedRoom.Playlist.Select(item => createPlaylistItem(item, item.ID == joinedRoom.Settings.PlaylistItemId))).ConfigureAwait(false);
 
                 // Populate users.
                 Debug.Assert(joinedRoom.Users != null);
@@ -605,7 +605,7 @@ namespace osu.Game.Online.Multiplayer
             if (Room == null)
                 return;
 
-            var playlistItem = await createPlaylistItem(item).ConfigureAwait(false);
+            var playlistItem = await createPlaylistItem(item, true).ConfigureAwait(false);
 
             Scheduler.Add(() =>
             {
@@ -647,7 +647,7 @@ namespace osu.Game.Online.Multiplayer
             if (Room == null)
                 return;
 
-            var playlistItem = await createPlaylistItem(item).ConfigureAwait(false);
+            var playlistItem = await createPlaylistItem(item, true).ConfigureAwait(false);
 
             Scheduler.Add(() =>
             {
@@ -700,10 +700,8 @@ namespace osu.Game.Online.Multiplayer
             CurrentMatchPlayingItem.Value = APIRoom.Playlist.SingleOrDefault(p => p.ID == settings.PlaylistItemId);
         }
 
-        private async Task<PlaylistItem> createPlaylistItem(MultiplayerPlaylistItem item)
+        private async Task<PlaylistItem> createPlaylistItem(MultiplayerPlaylistItem item, bool populateImmediately)
         {
-            var apiBeatmap = await GetAPIBeatmap(item.BeatmapID).ConfigureAwait(false);
-
             var ruleset = Rulesets.GetRuleset(item.RulesetID);
             var rulesetInstance = ruleset.CreateInstance();
 
@@ -711,7 +709,6 @@ namespace osu.Game.Online.Multiplayer
             {
                 ID = item.ID,
                 OwnerID = item.OwnerID,
-                Beatmap = { Value = apiBeatmap },
                 Ruleset = { Value = ruleset },
                 Expired = item.Expired
             };
@@ -719,9 +716,25 @@ namespace osu.Game.Online.Multiplayer
             playlistItem.RequiredMods.AddRange(item.RequiredMods.Select(m => m.ToMod(rulesetInstance)));
             playlistItem.AllowedMods.AddRange(item.AllowedMods.Select(m => m.ToMod(rulesetInstance)));
 
+            if (populateImmediately)
+            {
+                await populateFromOnline(item, playlistItem).ConfigureAwait(false);
+            }
+            else
+            {
+                // to avoid blocking other operations (like the initial room join), schedule online population to happen in the background.
+                // ReSharper disable once AsyncVoidLambda
+                Schedule(async () => await populateFromOnline(item, playlistItem).ConfigureAwait(false));
+            }
+
             return playlistItem;
         }
 
+        private async Task populateFromOnline(MultiplayerPlaylistItem item, PlaylistItem playlistItem)
+        {
+            playlistItem.Beatmap.Value = await GetAPIBeatmap(item.BeatmapID).ConfigureAwait(false);
+        }
+
         /// <summary>
         /// Retrieves a <see cref="APIBeatmap"/> from an online source.
         /// </summary>

From 695167a7493e305e0e1f011de1750105561d65a0 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 27 Nov 2021 13:45:29 +0100
Subject: [PATCH 1401/5547] Add support for null item display in
 `DrawableRoomPlaylistItem`

---
 .../OnlinePlay/DrawableRoomPlaylistItem.cs    | 27 +++++++++++++------
 1 file changed, 19 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
index 2dbe2df82c..79a624b884 100644
--- a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
+++ b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
@@ -50,6 +50,7 @@ namespace osu.Game.Screens.OnlinePlay
         private LinkFlowContainer authorText;
         private ExplicitContentBeatmapPill explicitContentPill;
         private ModDisplay modDisplay;
+        private FillFlowContainer buttonsFlow;
         private UpdateableAvatar ownerAvatar;
 
         private readonly IBindable<bool> valid = new Bindable<bool>();
@@ -150,15 +151,22 @@ namespace osu.Game.Screens.OnlinePlay
                                .ContinueWith(u => Schedule(() => ownerAvatar.User = u.Result), TaskContinuationOptions.OnlyOnRanToCompletion);
             }
 
-            difficultyIconContainer.Child = new DifficultyIcon(Item.Beatmap.Value, ruleset.Value, requiredMods, performBackgroundDifficultyLookup: false) { Size = new Vector2(ICON_HEIGHT) };
+            if (Item.Beatmap.Value != null)
+                difficultyIconContainer.Child = new DifficultyIcon(Item.Beatmap.Value, ruleset.Value, requiredMods, performBackgroundDifficultyLookup: false) { Size = new Vector2(ICON_HEIGHT) };
+            else
+                difficultyIconContainer.Clear();
 
             panelBackground.Beatmap.Value = Item.Beatmap.Value;
 
             beatmapText.Clear();
-            beatmapText.AddLink(Item.Beatmap.Value.GetDisplayTitleRomanisable(), LinkAction.OpenBeatmap, Item.Beatmap.Value.OnlineID.ToString(), null, text =>
+
+            if (Item.Beatmap.Value != null)
             {
-                text.Truncate = true;
-            });
+                beatmapText.AddLink(Item.Beatmap.Value.GetDisplayTitleRomanisable(), LinkAction.OpenBeatmap, Item.Beatmap.Value.OnlineID.ToString(), null, text =>
+                {
+                    text.Truncate = true;
+                });
+            }
 
             authorText.Clear();
 
@@ -168,10 +176,13 @@ namespace osu.Game.Screens.OnlinePlay
                 authorText.AddUserLink(Item.Beatmap.Value.Metadata.Author);
             }
 
-            bool hasExplicitContent = (Item.Beatmap.Value.BeatmapSet as IBeatmapSetOnlineInfo)?.HasExplicitContent == true;
+            bool hasExplicitContent = (Item.Beatmap.Value?.BeatmapSet as IBeatmapSetOnlineInfo)?.HasExplicitContent == true;
             explicitContentPill.Alpha = hasExplicitContent ? 1 : 0;
 
             modDisplay.Current.Value = requiredMods.ToArray();
+
+            buttonsFlow.Clear();
+            buttonsFlow.ChildrenEnumerable = CreateButtons();
         }
 
         protected override Drawable CreateContent()
@@ -273,7 +284,7 @@ namespace osu.Game.Screens.OnlinePlay
                                         }
                                     }
                                 },
-                                new FillFlowContainer
+                                buttonsFlow = new FillFlowContainer
                                 {
                                     Anchor = Anchor.CentreRight,
                                     Origin = Anchor.CentreRight,
@@ -305,9 +316,9 @@ namespace osu.Game.Screens.OnlinePlay
         }
 
         protected virtual IEnumerable<Drawable> CreateButtons() =>
-            new Drawable[]
+            new[]
             {
-                new PlaylistDownloadButton(Item),
+                Item.Beatmap.Value == null ? Empty() : new PlaylistDownloadButton(Item),
                 new PlaylistRemoveButton
                 {
                     Size = new Vector2(30, 30),

From 95373649a4440067f424bb30226153a5f48aa378 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 27 Nov 2021 14:02:47 +0100
Subject: [PATCH 1402/5547] Skip null items in star rating range display

---
 .../Screens/OnlinePlay/Components/StarRatingRangeDisplay.cs     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Screens/OnlinePlay/Components/StarRatingRangeDisplay.cs b/osu.Game/Screens/OnlinePlay/Components/StarRatingRangeDisplay.cs
index fc029543bb..edf9c5d155 100644
--- a/osu.Game/Screens/OnlinePlay/Components/StarRatingRangeDisplay.cs
+++ b/osu.Game/Screens/OnlinePlay/Components/StarRatingRangeDisplay.cs
@@ -80,7 +80,7 @@ namespace osu.Game.Screens.OnlinePlay.Components
 
         private void updateRange(object sender, NotifyCollectionChangedEventArgs e)
         {
-            var orderedDifficulties = Playlist.Select(p => p.Beatmap.Value).OrderBy(b => b.StarRating).ToArray();
+            var orderedDifficulties = Playlist.Where(p => p.Beatmap.Value != null).Select(p => p.Beatmap.Value).OrderBy(b => b.StarRating).ToArray();
 
             StarDifficulty minDifficulty = new StarDifficulty(orderedDifficulties.Length > 0 ? orderedDifficulties[0].StarRating : 0, 0);
             StarDifficulty maxDifficulty = new StarDifficulty(orderedDifficulties.Length > 0 ? orderedDifficulties[^1].StarRating : 0, 0);

From fe119da044a3290df438908da7d82a7ecfe879b4 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 30 Nov 2021 19:52:36 +0900
Subject: [PATCH 1403/5547] Add fetching of beatmap and user data when playlist
 panels come on screen

---
 .../Online/Multiplayer/MultiplayerClient.cs   | 34 +++++++++--------
 .../OnlinePlay/DrawableRoomPlaylistItem.cs    | 37 ++++++++++++++-----
 2 files changed, 47 insertions(+), 24 deletions(-)

diff --git a/osu.Game/Online/Multiplayer/MultiplayerClient.cs b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
index 4b44d5724f..78bf2c4db3 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
@@ -444,10 +444,18 @@ namespace osu.Game.Online.Multiplayer
             return Task.CompletedTask;
         }
 
-        Task IMultiplayerClient.SettingsChanged(MultiplayerRoomSettings newSettings)
+        async Task IMultiplayerClient.SettingsChanged(MultiplayerRoomSettings newSettings)
         {
+            Debug.Assert(APIRoom != null);
+            Debug.Assert(Room != null);
+
+            // ensure the new selected item is populated immediately.
+            var playlistItem = APIRoom.Playlist.SingleOrDefault(p => p.ID == newSettings.PlaylistItemId);
+
+            if (playlistItem != null)
+                await PopulateBeatmap(playlistItem).ConfigureAwait(false);
+
             Scheduler.Add(() => updateLocalRoomSettings(newSettings));
-            return Task.CompletedTask;
         }
 
         Task IMultiplayerClient.UserStateChanged(int userId, MultiplayerUserState state)
@@ -700,7 +708,7 @@ namespace osu.Game.Online.Multiplayer
             CurrentMatchPlayingItem.Value = APIRoom.Playlist.SingleOrDefault(p => p.ID == settings.PlaylistItemId);
         }
 
-        private async Task<PlaylistItem> createPlaylistItem(MultiplayerPlaylistItem item, bool populateImmediately)
+        private async Task<PlaylistItem> createPlaylistItem(MultiplayerPlaylistItem item, bool populateBeatmapImmediately)
         {
             var ruleset = Rulesets.GetRuleset(item.RulesetID);
             var rulesetInstance = ruleset.CreateInstance();
@@ -708,6 +716,7 @@ namespace osu.Game.Online.Multiplayer
             var playlistItem = new PlaylistItem
             {
                 ID = item.ID,
+                BeatmapID = item.BeatmapID,
                 OwnerID = item.OwnerID,
                 Ruleset = { Value = ruleset },
                 Expired = item.Expired
@@ -716,23 +725,18 @@ namespace osu.Game.Online.Multiplayer
             playlistItem.RequiredMods.AddRange(item.RequiredMods.Select(m => m.ToMod(rulesetInstance)));
             playlistItem.AllowedMods.AddRange(item.AllowedMods.Select(m => m.ToMod(rulesetInstance)));
 
-            if (populateImmediately)
-            {
-                await populateFromOnline(item, playlistItem).ConfigureAwait(false);
-            }
-            else
-            {
-                // to avoid blocking other operations (like the initial room join), schedule online population to happen in the background.
-                // ReSharper disable once AsyncVoidLambda
-                Schedule(async () => await populateFromOnline(item, playlistItem).ConfigureAwait(false));
-            }
+            if (populateBeatmapImmediately)
+                await PopulateBeatmap(playlistItem).ConfigureAwait(false);
 
             return playlistItem;
         }
 
-        private async Task populateFromOnline(MultiplayerPlaylistItem item, PlaylistItem playlistItem)
+        public async Task PopulateBeatmap(PlaylistItem item)
         {
-            playlistItem.Beatmap.Value = await GetAPIBeatmap(item.BeatmapID).ConfigureAwait(false);
+            if (item.Beatmap.Value != null)
+                return;
+
+            item.Beatmap.Value = await GetAPIBeatmap(item.BeatmapID).ConfigureAwait(false);
         }
 
         /// <summary>
diff --git a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
index 79a624b884..737c331d2f 100644
--- a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
+++ b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
@@ -16,6 +16,7 @@ using osu.Framework.Graphics.Shapes;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Input.Events;
 using osu.Framework.Localisation;
+using osu.Framework.Logging;
 using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.Drawables;
 using osu.Game.Database;
@@ -24,6 +25,7 @@ using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Online;
 using osu.Game.Online.Chat;
+using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Rooms;
 using osu.Game.Overlays.BeatmapSet;
 using osu.Game.Rulesets;
@@ -67,6 +69,13 @@ namespace osu.Game.Screens.OnlinePlay
         [Resolved]
         private UserLookupCache userLookupCache { get; set; }
 
+        [Resolved]
+        private MultiplayerClient multiplayerClient { get; set; }
+
+        private PanelBackground panelBackground;
+
+        private readonly DelayedLoadWrapper onScreenLoader = new DelayedLoadWrapper(Empty);
+
         private readonly bool allowEdit;
         private readonly bool allowSelection;
         private readonly bool showItemOwner;
@@ -131,11 +140,27 @@ namespace osu.Game.Screens.OnlinePlay
             valid.BindValueChanged(_ => Scheduler.AddOnce(refresh));
             requiredMods.CollectionChanged += (_, __) => Scheduler.AddOnce(refresh);
 
+            onScreenLoader.DelayedLoadStarted += _ =>
+            {
+                Task.Run(async () =>
+                {
+                    try
+                    {
+                        var user = await userLookupCache.GetUserAsync(Item.OwnerID).ConfigureAwait(false);
+                        Schedule(() => ownerAvatar.User = user);
+
+                        await multiplayerClient.PopulateBeatmap(Item).ConfigureAwait(false);
+                    }
+                    catch (Exception e)
+                    {
+                        Logger.Log($"Error while populating playlist item {e}");
+                    }
+                });
+            };
+
             refresh();
         }
 
-        private PanelBackground panelBackground;
-
         private void refresh()
         {
             if (!valid.Value)
@@ -144,13 +169,6 @@ namespace osu.Game.Screens.OnlinePlay
                 maskingContainer.BorderColour = colours.Red;
             }
 
-            if (showItemOwner)
-            {
-                ownerAvatar.Show();
-                userLookupCache.GetUserAsync(Item.OwnerID)
-                               .ContinueWith(u => Schedule(() => ownerAvatar.User = u.Result), TaskContinuationOptions.OnlyOnRanToCompletion);
-            }
-
             if (Item.Beatmap.Value != null)
                 difficultyIconContainer.Child = new DifficultyIcon(Item.Beatmap.Value, ruleset.Value, requiredMods, performBackgroundDifficultyLookup: false) { Size = new Vector2(ICON_HEIGHT) };
             else
@@ -203,6 +221,7 @@ namespace osu.Game.Screens.OnlinePlay
                         Alpha = 0,
                         AlwaysPresent = true
                     },
+                    onScreenLoader,
                     panelBackground = new PanelBackground
                     {
                         RelativeSizeAxes = Axes.Both,

From e4ba66877d95c6ed45d2fd9f9204ee4a7058ed7c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 30 Nov 2021 19:54:23 +0900
Subject: [PATCH 1404/5547] Improve transitions when loading new data into a
 playlist panel

---
 osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
index 737c331d2f..e4b0d9647e 100644
--- a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
+++ b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
@@ -80,6 +80,8 @@ namespace osu.Game.Screens.OnlinePlay
         private readonly bool allowSelection;
         private readonly bool showItemOwner;
 
+        private FillFlowContainer mainFillFlow;
+
         protected override bool ShouldBeConsideredForInput(Drawable child) => allowEdit || !allowSelection || SelectedItem.Value == Model;
 
         public DrawableRoomPlaylistItem(PlaylistItem item, bool allowEdit, bool allowSelection, bool showItemOwner)
@@ -201,6 +203,9 @@ namespace osu.Game.Screens.OnlinePlay
 
             buttonsFlow.Clear();
             buttonsFlow.ChildrenEnumerable = CreateButtons();
+
+            difficultyIconContainer.FadeInFromZero(500, Easing.OutQuint);
+            mainFillFlow.FadeInFromZero(500, Easing.OutQuint);
         }
 
         protected override Drawable CreateContent()
@@ -247,7 +252,7 @@ namespace osu.Game.Screens.OnlinePlay
                                     AutoSizeAxes = Axes.Both,
                                     Margin = new MarginPadding { Left = 8, Right = 8 },
                                 },
-                                new FillFlowContainer
+                                mainFillFlow = new FillFlowContainer
                                 {
                                     Anchor = Anchor.CentreLeft,
                                     Origin = Anchor.CentreLeft,

From 0fae10500a2860933f7125da02b1c4c2e09d80b1 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 30 Nov 2021 20:02:15 +0900
Subject: [PATCH 1405/5547] Fix failing tests

---
 .../Tests/Visual/Multiplayer/TestMultiplayerClient.cs     | 8 +++-----
 1 file changed, 3 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
index 037dccc63f..05b7c11e34 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
@@ -347,11 +347,9 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             return Task.FromResult(new APIBeatmap
             {
-                BeatmapSet = new APIBeatmapSet
-                {
-                    OnlineID = set.OnlineID,
-                },
-                OnlineID = set.Beatmaps.First().OnlineID
+                BeatmapSet = new APIBeatmapSet { OnlineID = set.OnlineID },
+                OnlineID = beatmapId,
+                Checksum = set.Beatmaps.First(b => b.OnlineID == beatmapId).MD5Hash
             });
         }
 

From d18417aa2706d1eae6ac1094d942d4538372c0e9 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Tue, 23 Nov 2021 12:04:27 +0300
Subject: [PATCH 1406/5547] Enable build-only iOS CI

---
 .github/workflows/ci.yml | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 68f8ef51ef..3c52802cf6 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -77,10 +77,6 @@ jobs:
         run: msbuild osu.Android/osu.Android.csproj /restore /p:Configuration=Debug
 
   build-only-ios:
-    # While this workflow technically *can* run, it fails as iOS builds are blocked by multiple issues.
-    # See https://github.com/ppy/osu-framework/issues/4677 for the details.
-    # The job can be unblocked once those issues are resolved and game deployments can happen again.
-    if: false
     name: Build only (iOS)
     runs-on: macos-latest
     timeout-minutes: 60

From 03e1305b3f54639fd4375d715faaf7257c8adec2 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 1 Dec 2021 01:55:14 +0900
Subject: [PATCH 1407/5547] Fix toast display potentially causing a child
 mutation before load complete

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

diff --git a/osu.Game/Overlays/OnScreenDisplay.cs b/osu.Game/Overlays/OnScreenDisplay.cs
index af6d24fc65..be9d3cd794 100644
--- a/osu.Game/Overlays/OnScreenDisplay.cs
+++ b/osu.Game/Overlays/OnScreenDisplay.cs
@@ -95,13 +95,13 @@ namespace osu.Game.Overlays
         /// Displays the provided <see cref="Toast"/> temporarily.
         /// </summary>
         /// <param name="toast"></param>
-        public void Display(Toast toast)
+        public void Display(Toast toast) => Schedule(() =>
         {
             box.Child = toast;
             DisplayTemporarily(box);
-        }
+        });
 
-        private void displayTrackedSettingChange(SettingDescription description) => Schedule(() => Display(new TrackedSettingToast(description)));
+        private void displayTrackedSettingChange(SettingDescription description) => Display(new TrackedSettingToast(description));
 
         private TransformSequence<Drawable> fadeIn;
         private ScheduledDelegate fadeOut;

From dda7142f48226f9db18e96efd8ce06b1fb286f47 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 1 Dec 2021 02:06:40 +0900
Subject: [PATCH 1408/5547] Fix double screen exit in multiplayer song select
 tests potentially causing failure

---
 .../Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs  | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs
index 84b24ba3a1..a5229702a8 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs
@@ -144,7 +144,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddStep("set mods", () => SelectedMods.Value = new[] { new TaikoModDoubleTime() });
 
             AddStep("confirm selection", () => songSelect.FinaliseSelection());
-            AddStep("exit song select", () => songSelect.Exit());
+
+            AddUntilStep("song select exited", () => !songSelect.IsCurrentScreen());
 
             AddAssert("beatmap not changed", () => Beatmap.Value.BeatmapInfo.Equals(selectedBeatmap));
             AddAssert("ruleset not changed", () => Ruleset.Value.Equals(new TaikoRuleset().RulesetInfo));

From 9411b42d0a68c3ca6123da8843ea64d4415e4718 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 1 Dec 2021 02:27:41 +0900
Subject: [PATCH 1409/5547] Cache skin filename to path mapping to reduce realm
 lookups during gameplay skin changes

---
 .../LegacyDatabasedSkinResourceStore.cs       | 50 +++++++++++++------
 1 file changed, 35 insertions(+), 15 deletions(-)

diff --git a/osu.Game/Skinning/LegacyDatabasedSkinResourceStore.cs b/osu.Game/Skinning/LegacyDatabasedSkinResourceStore.cs
index ab820a13ab..4194aa5089 100644
--- a/osu.Game/Skinning/LegacyDatabasedSkinResourceStore.cs
+++ b/osu.Game/Skinning/LegacyDatabasedSkinResourceStore.cs
@@ -3,10 +3,8 @@
 
 using System;
 using System.Collections.Generic;
-using System.Linq;
 using osu.Framework.Extensions;
 using osu.Framework.IO.Stores;
-using osu.Game.Database;
 using osu.Game.Extensions;
 using Realms;
 
@@ -14,12 +12,36 @@ namespace osu.Game.Skinning
 {
     public class LegacyDatabasedSkinResourceStore : ResourceStore<byte[]>
     {
-        private readonly ILive<SkinInfo> source;
+        private readonly Dictionary<string, string> fileToStoragePathMapping = new Dictionary<string, string>();
+
+        private readonly IDisposable subscription;
 
         public LegacyDatabasedSkinResourceStore(SkinInfo source, IResourceStore<byte[]> underlyingStore)
             : base(underlyingStore)
         {
-            this.source = source.ToLive();
+            subscription = source.Files.SubscribeForNotifications((sender, changes, error) =>
+            {
+                if (changes == null)
+                    return;
+
+                // If a large number of changes are made on skin files, this may be better suited to being cleared here
+                // and reinitialised on next usage.
+                initialiseFileCache(source);
+            });
+
+            initialiseFileCache(source);
+        }
+
+        ~LegacyDatabasedSkinResourceStore()
+        {
+            Dispose(false);
+        }
+
+        private void initialiseFileCache(SkinInfo source)
+        {
+            fileToStoragePathMapping.Clear();
+            foreach (var f in source.Files)
+                fileToStoragePathMapping[f.Filename.ToLowerInvariant()] = f.File.GetStoragePath();
         }
 
         protected override IEnumerable<string> GetFilenames(string name)
@@ -32,18 +54,16 @@ namespace osu.Game.Skinning
             }
         }
 
+        protected override void Dispose(bool disposing)
+        {
+            base.Dispose(disposing);
+
+            subscription?.Dispose();
+        }
+
         private string getPathForFile(string filename) =>
-            source.PerformRead(s =>
-            {
-                if (s.IsManaged)
-                {
-                    // avoid enumerating all files if this is a managed realm instance.
-                    return s.Files.Filter(@"Filename ==[c] $0", filename).FirstOrDefault()?.File.GetStoragePath();
-                }
+            fileToStoragePathMapping.TryGetValue(filename.ToLower(), out string path) ? path : null;
 
-                return s.Files.FirstOrDefault(f => string.Equals(f.Filename, filename, StringComparison.OrdinalIgnoreCase))?.File.GetStoragePath();
-            });
-
-        public override IEnumerable<string> GetAvailableResources() => source.PerformRead(s => s.Files.Select(f => f.Filename));
+        public override IEnumerable<string> GetAvailableResources() => fileToStoragePathMapping.Keys;
     }
 }

From b74b09eb3a7f18634bc84696ba9a57dbca0f7f1d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 30 Nov 2021 20:56:11 +0100
Subject: [PATCH 1410/5547] Add extra until step to make cause of potential
 failures more obvious

---
 osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs
index e00939a4de..ab9dc9c989 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs
@@ -172,6 +172,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddUntilStep("wait for room open", () => this.ChildrenOfType<MultiplayerMatchSubScreen>().FirstOrDefault()?.IsLoaded == true);
             AddWaitStep("wait for transition", 2);
 
+            AddUntilStep("create room button enabled", () => this.ChildrenOfType<MultiplayerMatchSettingsOverlay.CreateOrUpdateButton>().Single().Enabled.Value);
             AddStep("create room", () =>
             {
                 InputManager.MoveMouseTo(this.ChildrenOfType<MultiplayerMatchSettingsOverlay.CreateOrUpdateButton>().Single());

From de034b4d9c93d09e9ce4695fbccf13fe648f9414 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 30 Nov 2021 20:57:02 +0100
Subject: [PATCH 1411/5547] Fix test failures due to wrong asserts &
 uninitialised playlist

* The "create room" button was disabled headless due to not specifying
  the imported beatmap. In visual tests it seems to work due to
  selecting from the local database randomly.

* The test asserts are brought in line with expectations.
---
 .../Visual/Multiplayer/TestSceneTeamVersus.cs      | 14 +++++++++++---
 1 file changed, 11 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs
index ab9dc9c989..981989c28a 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs
@@ -125,17 +125,25 @@ namespace osu.Game.Tests.Visual.Multiplayer
             createRoom(() => new Room
             {
                 Name = { Value = "Test Room" },
-                Type = { Value = MatchType.TeamVersus }
+                Type = { Value = MatchType.HeadToHead },
+                Playlist =
+                {
+                    new PlaylistItem
+                    {
+                        Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.RulesetID == 0)).BeatmapInfo },
+                        Ruleset = { Value = new OsuRuleset().RulesetInfo },
+                    }
+                }
             });
 
-            AddUntilStep("match type versus", () => client.APIRoom?.Type.Value == MatchType.HeadToHead);
+            AddUntilStep("match type head to head", () => client.APIRoom?.Type.Value == MatchType.HeadToHead);
 
             AddStep("change match type", () => client.ChangeSettings(new MultiplayerRoomSettings
             {
                 MatchType = MatchType.TeamVersus
             }));
 
-            AddUntilStep("api room updated", () => client.APIRoom?.Type.Value == MatchType.TeamVersus);
+            AddUntilStep("api room updated to team versus", () => client.APIRoom?.Type.Value == MatchType.TeamVersus);
         }
 
         [Test]

From 0479027f644c686cf65d3ee9ceb65e14bd0e42e4 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 1 Dec 2021 11:29:02 +0900
Subject: [PATCH 1412/5547] Apply assertion fix from review

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

diff --git a/osu.Game.Tests/NonVisual/DifficultyAdjustmentModCombinationsTest.cs b/osu.Game.Tests/NonVisual/DifficultyAdjustmentModCombinationsTest.cs
index 612927337f..ae8eec2629 100644
--- a/osu.Game.Tests/NonVisual/DifficultyAdjustmentModCombinationsTest.cs
+++ b/osu.Game.Tests/NonVisual/DifficultyAdjustmentModCombinationsTest.cs
@@ -142,16 +142,16 @@ namespace osu.Game.Tests.NonVisual
         {
             Assert.AreEqual(expectedCombinations.Length, actualCombinations.Length);
 
-            foreach (Type[] expected in expectedCombinations)
+            Assert.Multiple(() =>
             {
-                Type[] actualTypes = ModUtils.FlattenMods(actualCombinations).Select(m => m.GetType()).ToArray();
-
-                Assert.Multiple(() =>
+                for (int i = 0; i < expectedCombinations.Length; ++i)
                 {
-                    foreach (var expectedType in expected)
-                        Assert.Contains(expectedType, actualTypes);
-                });
-            }
+                    Type[] expectedTypes = expectedCombinations[i];
+                    Type[] actualTypes = ModUtils.FlattenMod(actualCombinations[i]).Select(m => m.GetType()).ToArray();
+
+                    Assert.That(expectedTypes, Is.EquivalentTo(actualTypes));
+                }
+            });
         }
 
         private class ModA : Mod

From d78c18d03f6982f260ef717f53357d2db823d6e2 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 1 Dec 2021 12:44:25 +0900
Subject: [PATCH 1413/5547] Remove excess brackets
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.Tests/Skins/IO/ImportSkinTest.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Skins/IO/ImportSkinTest.cs b/osu.Game.Tests/Skins/IO/ImportSkinTest.cs
index 9b7e169745..f3c2cd8ba2 100644
--- a/osu.Game.Tests/Skins/IO/ImportSkinTest.cs
+++ b/osu.Game.Tests/Skins/IO/ImportSkinTest.cs
@@ -268,7 +268,7 @@ namespace osu.Game.Tests.Skins.IO
         private async Task<ILive<SkinInfo>> loadSkinIntoOsu(OsuGameBase osu, ArchiveReader archive = null)
         {
             var skinManager = osu.Dependencies.Get<SkinManager>();
-            return (await skinManager.Import(archive));
+            return await skinManager.Import(archive);
         }
     }
 }

From fb2310f82695f146a3c8dfb1a8ebb176ed7fe5b5 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 1 Dec 2021 12:45:47 +0900
Subject: [PATCH 1414/5547] Specify config file default as `DEFAULT_SKIN`'s
 guid

---
 osu.Game/Configuration/OsuConfigManager.cs | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Configuration/OsuConfigManager.cs b/osu.Game/Configuration/OsuConfigManager.cs
index ade817e652..c6a2abecd7 100644
--- a/osu.Game/Configuration/OsuConfigManager.cs
+++ b/osu.Game/Configuration/OsuConfigManager.cs
@@ -17,6 +17,7 @@ using osu.Game.Overlays;
 using osu.Game.Rulesets.Scoring;
 using osu.Game.Screens.Select;
 using osu.Game.Screens.Select.Filter;
+using osu.Game.Skinning;
 
 namespace osu.Game.Configuration
 {
@@ -27,7 +28,7 @@ namespace osu.Game.Configuration
         {
             // UI/selection defaults
             SetDefault(OsuSetting.Ruleset, string.Empty);
-            SetDefault(OsuSetting.Skin, string.Empty);
+            SetDefault(OsuSetting.Skin, SkinInfo.DEFAULT_SKIN.ToString());
 
             SetDefault(OsuSetting.BeatmapDetailTab, PlayBeatmapDetailArea.TabType.Details);
             SetDefault(OsuSetting.BeatmapDetailModsFilter, false);

From 370135d484bd1bece6925fe577a9074cfaa8e163 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 1 Dec 2021 12:47:32 +0900
Subject: [PATCH 1415/5547] Remove outdated TODO

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

diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index 8af76c1289..047c3b4225 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -247,7 +247,6 @@ namespace osu.Game
             SkinManager.CurrentSkinInfo.ValueChanged += skin => configSkin.Value = skin.NewValue.ID.ToString();
             configSkin.ValueChanged += skinId =>
             {
-                // TODO: migrate the user skin selection to the new ID format.
                 ILive<SkinInfo> skinInfo = null;
 
                 if (Guid.TryParse(skinId.NewValue, out var guid))

From 0e0e8c25e8587e0fd121d1c4a0ad8cfe9055a08f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 1 Dec 2021 12:48:49 +0900
Subject: [PATCH 1416/5547] Refactor migration precondition to read better

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

diff --git a/osu.Game/Database/EFToRealmMigrator.cs b/osu.Game/Database/EFToRealmMigrator.cs
index 670eb95ad6..8f436470af 100644
--- a/osu.Game/Database/EFToRealmMigrator.cs
+++ b/osu.Game/Database/EFToRealmMigrator.cs
@@ -63,7 +63,7 @@ namespace osu.Game.Database
             using (var transaction = realm.BeginWrite())
             {
                 // only migrate data if the realm database is empty.
-                if (!realm.All<SkinInfo>().Any(s => !s.Protected))
+                if (realm.All<SkinInfo>().All(s => s.Protected))
                 {
                     foreach (var skin in existingSkins)
                     {

From 8ce7467e9784f7ebd1a0f6f75fcf437e87832d1c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 1 Dec 2021 12:50:47 +0900
Subject: [PATCH 1417/5547] Fix ordering of skins in dropdown being reverse of
 expected

---
 osu.Game/Overlays/Settings/Sections/SkinSection.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/Settings/Sections/SkinSection.cs b/osu.Game/Overlays/Settings/Sections/SkinSection.cs
index 4de5d455fe..e3230098e2 100644
--- a/osu.Game/Overlays/Settings/Sections/SkinSection.cs
+++ b/osu.Game/Overlays/Settings/Sections/SkinSection.cs
@@ -81,7 +81,7 @@ namespace osu.Game.Overlays.Settings.Sections
 
             realmSkins = realmFactory.Context.All<SkinInfo>()
                                      .Where(s => !s.DeletePending)
-                                     .OrderBy(s => s.Protected)
+                                     .OrderByDescending(s => s.Protected) // protected skins should be at the top.
                                      .ThenBy(s => s.Name, StringComparer.OrdinalIgnoreCase);
 
             realmSubscription = realmSkins

From ea66cd6c5e3c31602cec5a9d03d54a9d24cb411d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 1 Dec 2021 12:55:19 +0900
Subject: [PATCH 1418/5547] Add xmldoc and make realm ongoing transaction file
 op methods `protected` instead of `public`

---
 osu.Game/Stores/RealmArchiveModelManager.cs | 15 ++++++++++++---
 1 file changed, 12 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Stores/RealmArchiveModelManager.cs b/osu.Game/Stores/RealmArchiveModelManager.cs
index ae40bcac79..a916e2b53a 100644
--- a/osu.Game/Stores/RealmArchiveModelManager.cs
+++ b/osu.Game/Stores/RealmArchiveModelManager.cs
@@ -57,17 +57,26 @@ namespace osu.Game.Stores
         public void AddFile(TModel item, Stream stream, string filename)
             => item.Realm.Write(() => AddFile(item, stream, filename, item.Realm));
 
-        public void DeleteFile(TModel item, RealmNamedFileUsage file, Realm realm)
+        /// <summary>
+        /// Delete a file from within an ongoing realm transaction.
+        /// </summary>
+        protected void DeleteFile(TModel item, RealmNamedFileUsage file, Realm realm)
         {
             item.Files.Remove(file);
         }
 
-        public void ReplaceFile(TModel model, RealmNamedFileUsage file, Stream contents, Realm realm)
+        /// <summary>
+        /// Replace a file from within an ongoing realm transaction.
+        /// </summary>
+        protected void ReplaceFile(TModel model, RealmNamedFileUsage file, Stream contents, Realm realm)
         {
             file.File = realmFileStore.Add(contents, realm);
         }
 
-        public void AddFile(TModel item, Stream stream, string filename, Realm realm)
+        /// <summary>
+        /// Add a file from within an ongoing realm transaction.
+        /// </summary>
+        protected void AddFile(TModel item, Stream stream, string filename, Realm realm)
         {
             var file = realmFileStore.Add(stream, realm);
             var namedUsage = new RealmNamedFileUsage(file, filename);

From 1cf15438664b5271f8ebf8c15bc201093c8da468 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 1 Dec 2021 13:50:19 +0900
Subject: [PATCH 1419/5547] Fix test failures due to attempting to subscribe to
 non-managed instances

---
 .../LegacyDatabasedSkinResourceStore.cs       | 25 +++++++++++++------
 1 file changed, 18 insertions(+), 7 deletions(-)

diff --git a/osu.Game/Skinning/LegacyDatabasedSkinResourceStore.cs b/osu.Game/Skinning/LegacyDatabasedSkinResourceStore.cs
index 4194aa5089..667dc1876b 100644
--- a/osu.Game/Skinning/LegacyDatabasedSkinResourceStore.cs
+++ b/osu.Game/Skinning/LegacyDatabasedSkinResourceStore.cs
@@ -3,6 +3,8 @@
 
 using System;
 using System.Collections.Generic;
+using System.Diagnostics;
+using osu.Framework.Development;
 using osu.Framework.Extensions;
 using osu.Framework.IO.Stores;
 using osu.Game.Extensions;
@@ -19,15 +21,24 @@ namespace osu.Game.Skinning
         public LegacyDatabasedSkinResourceStore(SkinInfo source, IResourceStore<byte[]> underlyingStore)
             : base(underlyingStore)
         {
-            subscription = source.Files.SubscribeForNotifications((sender, changes, error) =>
+            // Subscribing to non-managed instances doesn't work.
+            // In this usage, the skin may be non-managed in tests.
+            if (source.IsManaged)
             {
-                if (changes == null)
-                    return;
+                // Subscriptions can only work on the main thread.
+                Debug.Assert(ThreadSafety.IsUpdateThread);
 
-                // If a large number of changes are made on skin files, this may be better suited to being cleared here
-                // and reinitialised on next usage.
-                initialiseFileCache(source);
-            });
+                subscription = source.Files
+                                     .AsRealmCollection().SubscribeForNotifications((sender, changes, error) =>
+                                     {
+                                         if (changes == null)
+                                             return;
+
+                                         // If a large number of changes are made on skin files, this may be better suited to being cleared here
+                                         // and reinitialised on next usage.
+                                         initialiseFileCache(source);
+                                     });
+            }
 
             initialiseFileCache(source);
         }

From 4306420922ef927a88101f1322b3cc5b181ce2ba Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 1 Dec 2021 15:09:51 +0900
Subject: [PATCH 1420/5547] Add extension methods to add extra safety to realm
 subscriptions

Also adjusts the naming and documentation to make it (hopefully) easier
to understand what this method/process implies.
---
 osu.Game.Tests/Database/GeneralUsageTests.cs  |   6 +-
 osu.Game.Tests/Database/RealmLiveTests.cs     |   2 +-
 osu.Game/Database/RealmObjectExtensions.cs    | 106 ++++++++++++++++++
 .../Bindings/DatabasedKeyBindingContainer.cs  |   3 +-
 4 files changed, 111 insertions(+), 6 deletions(-)

diff --git a/osu.Game.Tests/Database/GeneralUsageTests.cs b/osu.Game.Tests/Database/GeneralUsageTests.cs
index 841bf2de43..2285b22a3a 100644
--- a/osu.Game.Tests/Database/GeneralUsageTests.cs
+++ b/osu.Game.Tests/Database/GeneralUsageTests.cs
@@ -5,8 +5,8 @@ using System;
 using System.Threading;
 using System.Threading.Tasks;
 using NUnit.Framework;
+using osu.Game.Database;
 using osu.Game.Models;
-using Realms;
 
 #nullable enable
 
@@ -48,7 +48,7 @@ namespace osu.Game.Tests.Database
 
                 using (var context = realmFactory.CreateContext())
                 {
-                    var subscription = context.All<RealmBeatmap>().SubscribeForNotifications((sender, changes, error) =>
+                    var subscription = context.All<RealmBeatmap>().QueryAsyncWithNotifications((sender, changes, error) =>
                     {
                         using (realmFactory.CreateContext())
                         {
@@ -61,7 +61,7 @@ namespace osu.Game.Tests.Database
                     {
                     }
 
-                    subscription.Dispose();
+                    subscription?.Dispose();
                 }
 
                 Assert.IsTrue(callbackRan);
diff --git a/osu.Game.Tests/Database/RealmLiveTests.cs b/osu.Game.Tests/Database/RealmLiveTests.cs
index 8ab19c8329..9b6769b788 100644
--- a/osu.Game.Tests/Database/RealmLiveTests.cs
+++ b/osu.Game.Tests/Database/RealmLiveTests.cs
@@ -208,7 +208,7 @@ namespace osu.Game.Tests.Database
 
                 using (var updateThreadContext = realmFactory.CreateContext())
                 {
-                    updateThreadContext.All<RealmBeatmap>().SubscribeForNotifications(gotChange);
+                    updateThreadContext.All<RealmBeatmap>().QueryAsyncWithNotifications(gotChange);
                     ILive<RealmBeatmap>? liveBeatmap = null;
 
                     Task.Factory.StartNew(() =>
diff --git a/osu.Game/Database/RealmObjectExtensions.cs b/osu.Game/Database/RealmObjectExtensions.cs
index ac4ca436ad..170756e743 100644
--- a/osu.Game/Database/RealmObjectExtensions.cs
+++ b/osu.Game/Database/RealmObjectExtensions.cs
@@ -1,12 +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.Collections.Generic;
 using System.Linq;
 using AutoMapper;
+using osu.Framework.Development;
 using osu.Game.Input.Bindings;
 using Realms;
 
+#nullable enable
+
 namespace osu.Game.Database
 {
     public static class RealmObjectExtensions
@@ -60,5 +64,107 @@ namespace osu.Game.Database
         {
             return new RealmLive<T>(realmObject);
         }
+
+        /// <summary>
+        /// Register a callback to be invoked each time this <see cref="T:Realms.IRealmCollection`1" /> changes.
+        /// </summary>
+        /// <remarks>
+        /// <para>
+        /// This adds osu! specific thread and managed state safety checks on top of <see cref="IRealmCollection{T}.SubscribeForNotifications"/>.
+        /// </para>
+        /// <para>
+        /// The first callback will be invoked with the initial <see cref="T:Realms.IRealmCollection`1" /> after the asynchronous query completes,
+        /// and then called again after each write transaction which changes either any of the objects in the collection, or
+        /// which objects are in the collection. The <c>changes</c> parameter will
+        /// be <c>null</c> the first time the callback is invoked with the initial results. For each call after that,
+        /// it will contain information about which rows in the results were added, removed or modified.
+        /// </para>
+        /// <para>
+        /// If a write transaction did not modify any objects in this <see cref="T:Realms.IRealmCollection`1" />, the callback is not invoked at all.
+        /// If an error occurs the callback will be invoked with <c>null</c> for the <c>sender</c> parameter and a non-<c>null</c> <c>error</c>.
+        /// Currently the only errors that can occur are when opening the <see cref="T:Realms.Realm" /> on the background worker thread.
+        /// </para>
+        /// <para>
+        /// At the time when the block is called, the <see cref="T:Realms.IRealmCollection`1" /> object will be fully evaluated
+        /// and up-to-date, and as long as you do not perform a write transaction on the same thread
+        /// or explicitly call <see cref="M:Realms.Realm.Refresh" />, accessing it will never perform blocking work.
+        /// </para>
+        /// <para>
+        /// Notifications are delivered via the standard event loop, and so can't be delivered while the event loop is blocked by other activity.
+        /// When notifications can't be delivered instantly, multiple notifications may be coalesced into a single notification.
+        /// This can include the notification with the initial collection.
+        /// </para>
+        /// </remarks>
+        /// <param name="collection">The <see cref="IRealmCollection{T}"/> to observe for changes.</param>
+        /// <param name="callback">The callback to be invoked with the updated <see cref="T:Realms.IRealmCollection`1" />.</param>
+        /// <returns>
+        /// A subscription token. It must be kept alive for as long as you want to receive change notifications.
+        /// To stop receiving notifications, call <see cref="M:System.IDisposable.Dispose" />.
+        /// </returns>
+        /// <seealso cref="M:Realms.CollectionExtensions.SubscribeForNotifications``1(System.Collections.Generic.IList{``0},Realms.NotificationCallbackDelegate{``0})" />
+        /// <seealso cref="M:Realms.CollectionExtensions.SubscribeForNotifications``1(System.Linq.IQueryable{``0},Realms.NotificationCallbackDelegate{``0})" />
+        public static IDisposable? QueryAsyncWithNotifications<T>(this IRealmCollection<T> collection, NotificationCallbackDelegate<T> callback)
+            where T : RealmObjectBase
+        {
+            // Subscriptions can only work on the main thread.
+            if (!ThreadSafety.IsUpdateThread)
+                throw new InvalidOperationException("Cannot subscribe for realm notifications from a non-update thread.");
+
+            return collection.SubscribeForNotifications(callback);
+        }
+
+        /// <summary>
+        /// A convenience method that casts <see cref="IQueryable{T}"/> to <see cref="IRealmCollection{T}"/> and subscribes for change notifications.
+        /// </summary>
+        /// <remarks>
+        /// This adds osu! specific thread and managed state safety checks on top of <see cref="IRealmCollection{T}.SubscribeForNotifications"/>.
+        /// </remarks>
+        /// <param name="list">The <see cref="IQueryable{T}"/> to observe for changes.</param>
+        /// <typeparam name="T">Type of the elements in the list.</typeparam>
+        /// <seealso cref="IRealmCollection{T}.SubscribeForNotifications"/>
+        /// <param name="callback">The callback to be invoked with the updated <see cref="IRealmCollection{T}"/>.</param>
+        /// <returns>
+        /// A subscription token. It must be kept alive for as long as you want to receive change notifications.
+        /// To stop receiving notifications, call <see cref="IDisposable.Dispose"/>.
+        ///
+        /// May be null in the case the provided collection is not managed.
+        /// </returns>
+        public static IDisposable? QueryAsyncWithNotifications<T>(this IQueryable<T> list, NotificationCallbackDelegate<T> callback)
+            where T : RealmObjectBase
+        {
+            // Subscribing to non-managed instances doesn't work.
+            // In this usage, the skin may be non-managed in tests.
+            if (!(list is IRealmCollection<T> realmCollection))
+                return null;
+
+            return QueryAsyncWithNotifications(realmCollection, callback);
+        }
+
+        /// <summary>
+        /// A convenience method that casts <see cref="IList{T}"/> to <see cref="IRealmCollection{T}"/> and subscribes for change notifications.
+        /// </summary>
+        /// <remarks>
+        /// This adds osu! specific thread and managed state safety checks on top of <see cref="IRealmCollection{T}.SubscribeForNotifications"/>.
+        /// </remarks>
+        /// <param name="list">The <see cref="IList{T}"/> to observe for changes.</param>
+        /// <typeparam name="T">Type of the elements in the list.</typeparam>
+        /// <seealso cref="IRealmCollection{T}.SubscribeForNotifications"/>
+        /// <param name="callback">The callback to be invoked with the updated <see cref="IRealmCollection{T}"/>.</param>
+        /// <returns>
+        /// A subscription token. It must be kept alive for as long as you want to receive change notifications.
+        /// To stop receiving notifications, call <see cref="IDisposable.Dispose"/>.
+        ///
+        /// May be null in the case the provided collection is not managed.
+        /// </returns>
+        public static IDisposable? QueryAsyncWithNotifications<T>(this IList<T> list, NotificationCallbackDelegate<T> callback)
+            where T : RealmObjectBase
+        {
+            // Subscribing to non-managed instances doesn't work.
+            // In this usage, the skin may be non-managed in tests.
+            if (!(list is IRealmCollection<T> realmCollection))
+                return null;
+
+            return QueryAsyncWithNotifications(realmCollection, callback);
+        }
     }
 }
diff --git a/osu.Game/Input/Bindings/DatabasedKeyBindingContainer.cs b/osu.Game/Input/Bindings/DatabasedKeyBindingContainer.cs
index baa5b9ff9c..f95c884fe5 100644
--- a/osu.Game/Input/Bindings/DatabasedKeyBindingContainer.cs
+++ b/osu.Game/Input/Bindings/DatabasedKeyBindingContainer.cs
@@ -8,7 +8,6 @@ using osu.Framework.Allocation;
 using osu.Framework.Input.Bindings;
 using osu.Game.Database;
 using osu.Game.Rulesets;
-using Realms;
 
 namespace osu.Game.Input.Bindings
 {
@@ -56,7 +55,7 @@ namespace osu.Game.Input.Bindings
                                            .Where(b => b.RulesetName == rulesetName && b.Variant == variant);
 
             realmSubscription = realmKeyBindings
-                .SubscribeForNotifications((sender, changes, error) =>
+                .QueryAsyncWithNotifications((sender, changes, error) =>
                 {
                     // first subscription ignored as we are handling this in LoadComplete.
                     if (changes == null)

From a439209535ec8a439aab350225b1e6640c6e3cc6 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 1 Dec 2021 15:23:28 +0900
Subject: [PATCH 1421/5547] Add `BannedSymbols` rules for
 `SubscribeForNotifications` variants we use

---
 CodeAnalysis/BannedSymbols.txt | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/CodeAnalysis/BannedSymbols.txt b/CodeAnalysis/BannedSymbols.txt
index b72803482d..c567adc0ae 100644
--- a/CodeAnalysis/BannedSymbols.txt
+++ b/CodeAnalysis/BannedSymbols.txt
@@ -10,3 +10,6 @@ T:Microsoft.EntityFrameworkCore.Internal.EnumerableExtensions;Don't use internal
 T:Microsoft.EntityFrameworkCore.Internal.TypeExtensions;Don't use internal extension methods.
 T:NuGet.Packaging.CollectionExtensions;Don't use internal extension methods.
 M:System.Enum.HasFlag(System.Enum);Use osu.Framework.Extensions.EnumExtensions.HasFlagFast<T>() instead.
+M:Realms.IRealmCollection`1.SubscribeForNotifications`1(Realms.NotificationCallbackDelegate{``0});Use osu.Game.Database.RealmObjectExtensions.QueryAsyncWithNotifications(IRealmCollection<T>,NotificationCallbackDelegate<T>) instead.
+M:Realms.CollectionExtensions.SubscribeForNotifications`1(System.Linq.IQueryable{``0},Realms.NotificationCallbackDelegate{``0});Use osu.Game.Database.RealmObjectExtensions.QueryAsyncWithNotifications(IQueryable<T>,NotificationCallbackDelegate<T>) instead.
+M:Realms.CollectionExtensions.SubscribeForNotifications`1(System.Collections.Generic.IList{``0},Realms.NotificationCallbackDelegate{``0});Use osu.Game.Database.RealmObjectExtensions.QueryAsyncWithNotifications(IList<T>,NotificationCallbackDelegate<T>) instead.

From 09817ff161aa6768aa6fbf9828b62f572d075402 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 1 Dec 2021 15:27:10 +0900
Subject: [PATCH 1422/5547] Add missing `returns` additional documentation to
 main method call

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

diff --git a/osu.Game/Database/RealmObjectExtensions.cs b/osu.Game/Database/RealmObjectExtensions.cs
index 170756e743..cb38c910da 100644
--- a/osu.Game/Database/RealmObjectExtensions.cs
+++ b/osu.Game/Database/RealmObjectExtensions.cs
@@ -100,6 +100,8 @@ namespace osu.Game.Database
         /// <returns>
         /// A subscription token. It must be kept alive for as long as you want to receive change notifications.
         /// To stop receiving notifications, call <see cref="M:System.IDisposable.Dispose" />.
+        ///
+        /// May be null in the case the provided collection is not managed.
         /// </returns>
         /// <seealso cref="M:Realms.CollectionExtensions.SubscribeForNotifications``1(System.Collections.Generic.IList{``0},Realms.NotificationCallbackDelegate{``0})" />
         /// <seealso cref="M:Realms.CollectionExtensions.SubscribeForNotifications``1(System.Linq.IQueryable{``0},Realms.NotificationCallbackDelegate{``0})" />

From 81f82c24c39014decc49b676e68cca913db95645 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 1 Dec 2021 17:45:41 +0900
Subject: [PATCH 1423/5547] Use new API endpoint to do batch lookups

---
 osu.Game/Database/BeatmapLookupCache.cs       | 19 ++++++++-------
 .../Online/API/Requests/GetBeatmapsRequest.cs | 24 +++++++++++++++++++
 .../API/Requests/GetBeatmapsResponse.cs       | 15 ++++++++++++
 3 files changed, 50 insertions(+), 8 deletions(-)
 create mode 100644 osu.Game/Online/API/Requests/GetBeatmapsRequest.cs
 create mode 100644 osu.Game/Online/API/Requests/GetBeatmapsResponse.cs

diff --git a/osu.Game/Database/BeatmapLookupCache.cs b/osu.Game/Database/BeatmapLookupCache.cs
index c4e20d59b6..2082031714 100644
--- a/osu.Game/Database/BeatmapLookupCache.cs
+++ b/osu.Game/Database/BeatmapLookupCache.cs
@@ -85,7 +85,7 @@ namespace osu.Game.Database
             // Grab at most 50 unique beatmap IDs from the queue.
             lock (taskAssignmentLock)
             {
-                while (pendingBeatmapTasks.Count > 0 && beatmapTasks.Count < 1)
+                while (pendingBeatmapTasks.Count > 0 && beatmapTasks.Count < 50)
                 {
                     (int id, TaskCompletionSource<APIBeatmap> task) next = pendingBeatmapTasks.Dequeue();
 
@@ -103,7 +103,7 @@ namespace osu.Game.Database
             }
 
             // Query the beatmaps.
-            var request = new GetBeatmapRequest(new APIBeatmap { OnlineID = beatmapTasks.Keys.First() });
+            var request = new GetBeatmapsRequest(beatmapTasks.Keys.ToArray());
 
             // rather than queueing, we maintain our own single-threaded request stream.
             // todo: we probably want retry logic here.
@@ -117,16 +117,19 @@ namespace osu.Game.Database
                     createNewTask();
             }
 
-            List<APIBeatmap> foundBeatmaps = new List<APIBeatmap> { request.Response };
+            List<APIBeatmap> foundBeatmaps = request.Response?.Beatmaps;
 
-            foreach (var beatmap in foundBeatmaps)
+            if (foundBeatmaps != null)
             {
-                if (beatmapTasks.TryGetValue(beatmap.OnlineID, out var tasks))
+                foreach (var beatmap in foundBeatmaps)
                 {
-                    foreach (var task in tasks)
-                        task.SetResult(beatmap);
+                    if (beatmapTasks.TryGetValue(beatmap.OnlineID, out var tasks))
+                    {
+                        foreach (var task in tasks)
+                            task.SetResult(beatmap);
 
-                    beatmapTasks.Remove(beatmap.OnlineID);
+                        beatmapTasks.Remove(beatmap.OnlineID);
+                    }
                 }
             }
 
diff --git a/osu.Game/Online/API/Requests/GetBeatmapsRequest.cs b/osu.Game/Online/API/Requests/GetBeatmapsRequest.cs
new file mode 100644
index 0000000000..1d71e22b77
--- /dev/null
+++ b/osu.Game/Online/API/Requests/GetBeatmapsRequest.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;
+
+namespace osu.Game.Online.API.Requests
+{
+    public class GetBeatmapsRequest : APIRequest<GetBeatmapsResponse>
+    {
+        private readonly int[] beatmapIds;
+
+        private const int max_ids_per_request = 50;
+
+        public GetBeatmapsRequest(int[] beatmapIds)
+        {
+            if (beatmapIds.Length > max_ids_per_request)
+                throw new ArgumentException($"{nameof(GetBeatmapsRequest)} calls only support up to {max_ids_per_request} IDs at once");
+
+            this.beatmapIds = beatmapIds;
+        }
+
+        protected override string Target => "beatmaps/?ids[]=" + string.Join("&ids[]=", beatmapIds);
+    }
+}
diff --git a/osu.Game/Online/API/Requests/GetBeatmapsResponse.cs b/osu.Game/Online/API/Requests/GetBeatmapsResponse.cs
new file mode 100644
index 0000000000..c450c3269c
--- /dev/null
+++ b/osu.Game/Online/API/Requests/GetBeatmapsResponse.cs
@@ -0,0 +1,15 @@
+// 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 Newtonsoft.Json;
+using osu.Game.Online.API.Requests.Responses;
+
+namespace osu.Game.Online.API.Requests
+{
+    public class GetBeatmapsResponse : ResponseWithCursor
+    {
+        [JsonProperty("beatmaps")]
+        public List<APIBeatmap> Beatmaps;
+    }
+}

From bf5a186a2b03774d7f51dd6a591a7d529894f534 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 1 Dec 2021 17:47:16 +0900
Subject: [PATCH 1424/5547] Add early abort to avoid sending empty lookup
 requests

---
 osu.Game/Database/BeatmapLookupCache.cs | 3 +++
 osu.Game/Database/UserLookupCache.cs    | 3 +++
 2 files changed, 6 insertions(+)

diff --git a/osu.Game/Database/BeatmapLookupCache.cs b/osu.Game/Database/BeatmapLookupCache.cs
index 2082031714..c6f8244494 100644
--- a/osu.Game/Database/BeatmapLookupCache.cs
+++ b/osu.Game/Database/BeatmapLookupCache.cs
@@ -102,6 +102,9 @@ namespace osu.Game.Database
                 }
             }
 
+            if (beatmapTasks.Count == 0)
+                return;
+
             // Query the beatmaps.
             var request = new GetBeatmapsRequest(beatmapTasks.Keys.ToArray());
 
diff --git a/osu.Game/Database/UserLookupCache.cs b/osu.Game/Database/UserLookupCache.cs
index dae2d2549c..26f4e9fb3b 100644
--- a/osu.Game/Database/UserLookupCache.cs
+++ b/osu.Game/Database/UserLookupCache.cs
@@ -100,6 +100,9 @@ namespace osu.Game.Database
                 }
             }
 
+            if (userTasks.Count == 0)
+                return;
+
             // Query the users.
             var request = new GetUsersRequest(userTasks.Keys.ToArray());
 

From 7224f6bac54127ad9c4559b02fb92eeb9d20277a Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 1 Dec 2021 20:00:31 +0900
Subject: [PATCH 1425/5547] Fix testable online IDs starting at 0

---
 osu.Game/Tests/Visual/OnlinePlay/TestRoomRequestsHandler.cs | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Tests/Visual/OnlinePlay/TestRoomRequestsHandler.cs b/osu.Game/Tests/Visual/OnlinePlay/TestRoomRequestsHandler.cs
index abcf31c007..a4586dea12 100644
--- a/osu.Game/Tests/Visual/OnlinePlay/TestRoomRequestsHandler.cs
+++ b/osu.Game/Tests/Visual/OnlinePlay/TestRoomRequestsHandler.cs
@@ -25,9 +25,9 @@ namespace osu.Game.Tests.Visual.OnlinePlay
 
         private readonly List<Room> serverSideRooms = new List<Room>();
 
-        private int currentRoomId;
-        private int currentPlaylistItemId;
-        private int currentScoreId;
+        private int currentRoomId = 1;
+        private int currentPlaylistItemId = 1;
+        private int currentScoreId = 1;
 
         /// <summary>
         /// Handles an API request, while also updating the local state to match

From 685bdd522e1111749243e95b5dca854bd7064b31 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 1 Dec 2021 20:17:26 +0900
Subject: [PATCH 1426/5547] Replace 'skin' in comments with 'instance'

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

diff --git a/osu.Game/Database/RealmObjectExtensions.cs b/osu.Game/Database/RealmObjectExtensions.cs
index cb38c910da..b38e21453c 100644
--- a/osu.Game/Database/RealmObjectExtensions.cs
+++ b/osu.Game/Database/RealmObjectExtensions.cs
@@ -135,7 +135,7 @@ namespace osu.Game.Database
             where T : RealmObjectBase
         {
             // Subscribing to non-managed instances doesn't work.
-            // In this usage, the skin may be non-managed in tests.
+            // In this usage, the instance may be non-managed in tests.
             if (!(list is IRealmCollection<T> realmCollection))
                 return null;
 
@@ -162,7 +162,7 @@ namespace osu.Game.Database
             where T : RealmObjectBase
         {
             // Subscribing to non-managed instances doesn't work.
-            // In this usage, the skin may be non-managed in tests.
+            // In this usage, the instance may be non-managed in tests.
             if (!(list is IRealmCollection<T> realmCollection))
                 return null;
 

From c38537a51ab1a0e313ee0ed3b73d990c726ff214 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Mon, 22 Nov 2021 18:39:50 +0900
Subject: [PATCH 1427/5547] Initial implementation of MultiplayerPlaylist

---
 .../TestSceneMultiplayerPlaylist.cs           | 255 ++++++++++++++++++
 .../Online/Multiplayer/MultiplayerClient.cs   |   9 +-
 .../OnlinePlay/DrawableRoomPlaylist.cs        |  23 +-
 .../Multiplayer/MultiplayerRoomComposite.cs   |  34 +++
 4 files changed, 297 insertions(+), 24 deletions(-)
 create mode 100644 osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs
new file mode 100644
index 0000000000..ee5cb7f32c
--- /dev/null
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs
@@ -0,0 +1,255 @@
+// 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 NUnit.Framework;
+using osu.Framework.Allocation;
+using osu.Framework.Audio;
+using osu.Framework.Bindables;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
+using osu.Framework.Platform;
+using osu.Framework.Testing;
+using osu.Game.Beatmaps;
+using osu.Game.Database;
+using osu.Game.Online.Multiplayer;
+using osu.Game.Online.Rooms;
+using osu.Game.Rulesets;
+using osu.Game.Screens.OnlinePlay;
+using osu.Game.Screens.OnlinePlay.Multiplayer;
+using osu.Game.Tests.Resources;
+using osuTK;
+
+namespace osu.Game.Tests.Visual.Multiplayer
+{
+    public class TestSceneMultiplayerPlaylist : MultiplayerTestScene
+    {
+        private BeatmapManager beatmaps;
+        private RulesetStore rulesets;
+        private BeatmapSetInfo importedSet;
+        private BeatmapInfo importedBeatmap;
+
+        [Cached(typeof(UserLookupCache))]
+        private UserLookupCache lookupCache = new TestUserLookupCache();
+
+        [BackgroundDependencyLoader]
+        private void load(GameHost host, AudioManager audio)
+        {
+            Dependencies.Cache(rulesets = new RulesetStore(ContextFactory));
+            Dependencies.Cache(beatmaps = new BeatmapManager(LocalStorage, ContextFactory, rulesets, null, audio, Resources, host, Beatmap.Default));
+        }
+
+        [SetUp]
+        public new void Setup() => Schedule(() =>
+        {
+            Child = new MultiplayerPlaylist
+            {
+                Anchor = Anchor.Centre,
+                Origin = Anchor.Centre,
+                RelativeSizeAxes = Axes.Both,
+                Size = new Vector2(0.4f, 0.8f)
+            };
+        });
+
+        [SetUpSteps]
+        public new void SetUpSteps()
+        {
+            AddStep("import beatmap", () =>
+            {
+                beatmaps.Import(TestResources.GetQuickTestBeatmapForImport()).Wait();
+                importedSet = beatmaps.GetAllUsableBeatmapSetsEnumerable(IncludedDetails.All).First();
+                importedBeatmap = importedSet.Beatmaps.First(b => b.RulesetID == 0);
+            });
+        }
+
+        [Test]
+        public void DoTest()
+        {
+            AddStep("change to round robin mode", () => Client.ChangeSettings(new MultiplayerRoomSettings { QueueMode = QueueMode.AllPlayersRoundRobin }));
+            AddStep("add playlist item for user 1", () => Client.AddPlaylistItem(new MultiplayerPlaylistItem
+            {
+                BeatmapID = importedBeatmap.OnlineID!.Value
+            }));
+        }
+
+        public class MultiplayerPlaylist : MultiplayerRoomComposite
+        {
+            private QueueList queueList;
+            private DrawableRoomPlaylist historyList;
+            private bool firstPopulation = true;
+
+            [BackgroundDependencyLoader]
+            private void load()
+            {
+                InternalChild = new GridContainer
+                {
+                    RelativeSizeAxes = Axes.Both,
+                    Content = new[]
+                    {
+                        new Drawable[]
+                        {
+                            queueList = new QueueList(false, false, true)
+                            {
+                                RelativeSizeAxes = Axes.Both
+                            },
+                            historyList = new DrawableRoomPlaylist(false, false, true)
+                            {
+                                RelativeSizeAxes = Axes.Both
+                            }
+                        }
+                    }
+                };
+            }
+
+            protected override void OnRoomUpdated()
+            {
+                base.OnRoomUpdated();
+
+                if (Room == null)
+                    return;
+
+                if (!firstPopulation) return;
+
+                foreach (var item in Room.Playlist)
+                    PlaylistItemAdded(item);
+
+                firstPopulation = false;
+            }
+
+            protected override void PlaylistItemAdded(MultiplayerPlaylistItem item)
+            {
+                base.PlaylistItemAdded(item);
+
+                if (item.Expired)
+                    historyList.Items.Add(getPlaylistItem(item));
+                else
+                    queueList.Items.Add(getPlaylistItem(item));
+            }
+
+            protected override void PlaylistItemRemoved(long item)
+            {
+                base.PlaylistItemRemoved(item);
+
+                queueList.Items.RemoveAll(i => i.ID == item);
+            }
+
+            protected override void PlaylistItemChanged(MultiplayerPlaylistItem item)
+            {
+                base.PlaylistItemChanged(item);
+
+                PlaylistItemRemoved(item.ID);
+                PlaylistItemAdded(item);
+            }
+
+            private PlaylistItem getPlaylistItem(MultiplayerPlaylistItem item) => Playlist.Single(i => i.ID == item.ID);
+        }
+
+        public class QueueList : DrawableRoomPlaylist
+        {
+            public readonly IBindable<QueueMode> QueueMode = new Bindable<QueueMode>();
+
+            public QueueList(bool allowEdit, bool allowSelection, bool reverse = false)
+                : base(allowEdit, allowSelection, reverse)
+            {
+            }
+
+            protected override FillFlowContainer<RearrangeableListItem<PlaylistItem>> CreateListFillFlowContainer() => new QueueFillFlowContainer
+            {
+                QueueMode = { BindTarget = QueueMode },
+                Spacing = new Vector2(0, 2)
+            };
+
+            private class QueueFillFlowContainer : FillFlowContainer<RearrangeableListItem<PlaylistItem>>
+            {
+                public readonly IBindable<QueueMode> QueueMode = new Bindable<QueueMode>();
+
+                protected override void LoadComplete()
+                {
+                    base.LoadComplete();
+                    QueueMode.BindValueChanged(_ => InvalidateLayout());
+                }
+
+                public override IEnumerable<Drawable> FlowingChildren
+                {
+                    get
+                    {
+                        switch (QueueMode.Value)
+                        {
+                            default:
+                                return AliveInternalChildren.Where(d => d.IsPresent)
+                                                            .OfType<RearrangeableListItem<PlaylistItem>>()
+                                                            .OrderBy(item => item.Model.ID);
+
+                            case Game.Online.Multiplayer.QueueMode.AllPlayersRoundRobin:
+                                // TODO: THIS IS SO INEFFICIENT, can it be done any better?
+
+                                // Group all items by their owners.
+                                var groups = AliveInternalChildren.Where(d => d.IsPresent)
+                                                                  .OfType<RearrangeableListItem<PlaylistItem>>()
+                                                                  .GroupBy(item => item.Model.OwnerID)
+                                                                  .Select(g => g.ToArray())
+                                                                  .ToArray();
+
+                                if (groups.Length == 0)
+                                    return Enumerable.Empty<Drawable>();
+
+                                // Find the initial picking order for the groups. The group with the smallest 'weight' picks first.
+                                int[] groupWeights = new int[groups.Length];
+
+                                for (int i = 0; i < groups.Length; i++)
+                                {
+                                    groupWeights[i] = groups[i].Count(item => item.Model.Expired);
+                                    groups[i] = groups[i].Where(item => !item.Model.Expired).ToArray();
+                                }
+
+                                var result = new List<Drawable>();
+
+                                // Simulate the playlist by picking in order from the smallest-weighted room each time until no longer able to.
+                                while (true)
+                                {
+                                    var candidateGroup = groups
+                                                         // Map each group to an index.
+                                                         .Select((items, index) => new { index, items })
+                                                         // Order groups by their weights.
+                                                         .OrderBy(group => groupWeights[group.index])
+                                                         // Select the first group with remaining items (null is set from previous iterations).
+                                                         .FirstOrDefault(group => group.items.Any(i => i != null));
+
+                                    // Iteration ends when all groups have been exhausted of items.
+                                    if (candidateGroup == null)
+                                        break;
+
+                                    // Find the index of the first non-null (i.e. unused) item in the group.
+                                    int candidateItemIndex = 0;
+                                    RearrangeableListItem<PlaylistItem> candidateItem = null;
+
+                                    for (int i = 0; i < candidateGroup.items.Length; i++)
+                                    {
+                                        if (candidateGroup.items[i] != null)
+                                        {
+                                            candidateItemIndex = i;
+                                            candidateItem = candidateGroup.items[i];
+                                        }
+                                    }
+
+                                    // The item is guaranteed to not be expired, since we've previously removed all expired items.
+                                    Debug.Assert(candidateItem?.Model.Expired == false);
+
+                                    // Add the item to the result set.
+                                    result.Add(candidateItem);
+
+                                    // Update the group for the next iteration.
+                                    candidateGroup.items[candidateItemIndex] = null;
+                                    groupWeights[candidateGroup.index]++;
+                                }
+
+                                return result;
+                        }
+                    }
+                }
+            }
+        }
+    }
+}
diff --git a/osu.Game/Online/Multiplayer/MultiplayerClient.cs b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
index df16fb3042..fb716c9814 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
@@ -33,11 +33,13 @@ namespace osu.Game.Online.Multiplayer
         public event Action? RoomUpdated;
 
         public event Action<MultiplayerRoomUser>? UserJoined;
-
         public event Action<MultiplayerRoomUser>? UserLeft;
-
         public event Action<MultiplayerRoomUser>? UserKicked;
 
+        public event Action<MultiplayerPlaylistItem>? ItemAdded;
+        public event Action<long>? ItemRemoved;
+        public event Action<MultiplayerPlaylistItem>? ItemChanged;
+
         /// <summary>
         /// Invoked when the multiplayer server requests the current beatmap to be loaded into play.
         /// </summary>
@@ -619,6 +621,7 @@ namespace osu.Game.Online.Multiplayer
                 Room.Playlist.Add(item);
                 APIRoom.Playlist.Add(playlistItem);
 
+                ItemAdded?.Invoke(item);
                 RoomUpdated?.Invoke();
             });
         }
@@ -638,6 +641,7 @@ namespace osu.Game.Online.Multiplayer
                 Room.Playlist.Remove(Room.Playlist.Single(existing => existing.ID == playlistItemId));
                 APIRoom.Playlist.RemoveAll(existing => existing.ID == playlistItemId);
 
+                ItemRemoved?.Invoke(playlistItemId);
                 RoomUpdated?.Invoke();
             });
 
@@ -668,6 +672,7 @@ namespace osu.Game.Online.Multiplayer
                 if (CurrentMatchPlayingItem.Value?.ID == playlistItem.ID)
                     CurrentMatchPlayingItem.Value = playlistItem;
 
+                ItemChanged?.Invoke(item);
                 RoomUpdated?.Invoke();
             });
         }
diff --git a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs
index f5522cd25d..dc04d9a77b 100644
--- a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs
+++ b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs
@@ -1,9 +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.Collections.Specialized;
-using System.Linq;
 using osu.Framework.Bindables;
 using osu.Framework.Extensions.IEnumerableExtensions;
 using osu.Framework.Graphics;
@@ -25,8 +23,6 @@ namespace osu.Game.Screens.OnlinePlay
         {
             this.allowEdit = allowEdit;
             this.allowSelection = allowSelection;
-
-            ((ReversibleFillFlowContainer)ListContainer).Reverse = reverse;
         }
 
         protected override void LoadComplete()
@@ -51,7 +47,7 @@ namespace osu.Game.Screens.OnlinePlay
             d.ScrollbarVisible = false;
         });
 
-        protected override FillFlowContainer<RearrangeableListItem<PlaylistItem>> CreateListFillFlowContainer() => new ReversibleFillFlowContainer
+        protected override FillFlowContainer<RearrangeableListItem<PlaylistItem>> CreateListFillFlowContainer() => new FillFlowContainer<RearrangeableListItem<PlaylistItem>>
         {
             Spacing = new Vector2(0, 2)
         };
@@ -74,22 +70,5 @@ namespace osu.Game.Screens.OnlinePlay
 
             Items.Remove(item);
         }
-
-        private class ReversibleFillFlowContainer : FillFlowContainer<RearrangeableListItem<PlaylistItem>>
-        {
-            private bool reverse;
-
-            public bool Reverse
-            {
-                get => reverse;
-                set
-                {
-                    reverse = value;
-                    Invalidate();
-                }
-            }
-
-            public override IEnumerable<Drawable> FlowingChildren => Reverse ? base.FlowingChildren.OrderBy(d => -GetLayoutPosition(d)) : base.FlowingChildren;
-        }
     }
 }
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerRoomComposite.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerRoomComposite.cs
index a380ddef25..f2cac708e4 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerRoomComposite.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerRoomComposite.cs
@@ -4,6 +4,7 @@
 using JetBrains.Annotations;
 using osu.Framework.Allocation;
 using osu.Game.Online.Multiplayer;
+using osu.Game.Online.Rooms;
 
 namespace osu.Game.Screens.OnlinePlay.Multiplayer
 {
@@ -23,6 +24,9 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
             Client.UserLeft += invokeUserLeft;
             Client.UserKicked += invokeUserKicked;
             Client.UserJoined += invokeUserJoined;
+            Client.ItemAdded += invokeItemAdded;
+            Client.ItemRemoved += invokeItemRemoved;
+            Client.ItemChanged += invokeItemChanged;
 
             OnRoomUpdated();
         }
@@ -31,6 +35,9 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
         private void invokeUserJoined(MultiplayerRoomUser user) => Scheduler.AddOnce(UserJoined, user);
         private void invokeUserKicked(MultiplayerRoomUser user) => Scheduler.AddOnce(UserKicked, user);
         private void invokeUserLeft(MultiplayerRoomUser user) => Scheduler.AddOnce(UserLeft, user);
+        private void invokeItemAdded(MultiplayerPlaylistItem item) => Scheduler.AddOnce(PlaylistItemAdded, item);
+        private void invokeItemRemoved(long item) => Scheduler.AddOnce(PlaylistItemRemoved, item);
+        private void invokeItemChanged(MultiplayerPlaylistItem item) => Scheduler.AddOnce(PlaylistItemChanged, item);
 
         /// <summary>
         /// Invoked when a user has joined the room.
@@ -56,6 +63,30 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
         {
         }
 
+        /// <summary>
+        /// Invoked when a playlist item is added to the room.
+        /// </summary>
+        /// <param name="item">The added playlist item.</param>
+        protected virtual void PlaylistItemAdded(MultiplayerPlaylistItem item)
+        {
+        }
+
+        /// <summary>
+        /// Invoked when a playlist item is removed from the room.
+        /// </summary>
+        /// <param name="item">The ID of the removed playlist item.</param>
+        protected virtual void PlaylistItemRemoved(long item)
+        {
+        }
+
+        /// <summary>
+        /// Invoked when a playlist item is changed in the room.
+        /// </summary>
+        /// <param name="item">The new playlist item, with an existing item's ID.</param>
+        protected virtual void PlaylistItemChanged(MultiplayerPlaylistItem item)
+        {
+        }
+
         /// <summary>
         /// Invoked when any change occurs to the multiplayer room.
         /// </summary>
@@ -71,6 +102,9 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
                 Client.UserLeft -= invokeUserLeft;
                 Client.UserKicked -= invokeUserKicked;
                 Client.UserJoined -= invokeUserJoined;
+                Client.ItemAdded -= invokeItemAdded;
+                Client.ItemRemoved -= invokeItemRemoved;
+                Client.ItemChanged -= invokeItemChanged;
             }
 
             base.Dispose(isDisposing);

From 0cb35e8b1852d0c6f76a14db8382c84b25597ec9 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 26 Nov 2021 19:24:49 +0900
Subject: [PATCH 1428/5547] Separate out QueueList

---
 .../TestSceneMultiplayerPlaylist.cs           | 110 +---------------
 .../Multiplayer/Match/Playlist/QueueList.cs   | 121 ++++++++++++++++++
 2 files changed, 122 insertions(+), 109 deletions(-)
 create mode 100644 osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/QueueList.cs

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs
index ee5cb7f32c..3244e9420d 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.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.
 
-using System.Collections.Generic;
-using System.Diagnostics;
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
-using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Platform;
@@ -19,6 +16,7 @@ using osu.Game.Online.Rooms;
 using osu.Game.Rulesets;
 using osu.Game.Screens.OnlinePlay;
 using osu.Game.Screens.OnlinePlay.Multiplayer;
+using osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist;
 using osu.Game.Tests.Resources;
 using osuTK;
 
@@ -145,111 +143,5 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             private PlaylistItem getPlaylistItem(MultiplayerPlaylistItem item) => Playlist.Single(i => i.ID == item.ID);
         }
-
-        public class QueueList : DrawableRoomPlaylist
-        {
-            public readonly IBindable<QueueMode> QueueMode = new Bindable<QueueMode>();
-
-            public QueueList(bool allowEdit, bool allowSelection, bool reverse = false)
-                : base(allowEdit, allowSelection, reverse)
-            {
-            }
-
-            protected override FillFlowContainer<RearrangeableListItem<PlaylistItem>> CreateListFillFlowContainer() => new QueueFillFlowContainer
-            {
-                QueueMode = { BindTarget = QueueMode },
-                Spacing = new Vector2(0, 2)
-            };
-
-            private class QueueFillFlowContainer : FillFlowContainer<RearrangeableListItem<PlaylistItem>>
-            {
-                public readonly IBindable<QueueMode> QueueMode = new Bindable<QueueMode>();
-
-                protected override void LoadComplete()
-                {
-                    base.LoadComplete();
-                    QueueMode.BindValueChanged(_ => InvalidateLayout());
-                }
-
-                public override IEnumerable<Drawable> FlowingChildren
-                {
-                    get
-                    {
-                        switch (QueueMode.Value)
-                        {
-                            default:
-                                return AliveInternalChildren.Where(d => d.IsPresent)
-                                                            .OfType<RearrangeableListItem<PlaylistItem>>()
-                                                            .OrderBy(item => item.Model.ID);
-
-                            case Game.Online.Multiplayer.QueueMode.AllPlayersRoundRobin:
-                                // TODO: THIS IS SO INEFFICIENT, can it be done any better?
-
-                                // Group all items by their owners.
-                                var groups = AliveInternalChildren.Where(d => d.IsPresent)
-                                                                  .OfType<RearrangeableListItem<PlaylistItem>>()
-                                                                  .GroupBy(item => item.Model.OwnerID)
-                                                                  .Select(g => g.ToArray())
-                                                                  .ToArray();
-
-                                if (groups.Length == 0)
-                                    return Enumerable.Empty<Drawable>();
-
-                                // Find the initial picking order for the groups. The group with the smallest 'weight' picks first.
-                                int[] groupWeights = new int[groups.Length];
-
-                                for (int i = 0; i < groups.Length; i++)
-                                {
-                                    groupWeights[i] = groups[i].Count(item => item.Model.Expired);
-                                    groups[i] = groups[i].Where(item => !item.Model.Expired).ToArray();
-                                }
-
-                                var result = new List<Drawable>();
-
-                                // Simulate the playlist by picking in order from the smallest-weighted room each time until no longer able to.
-                                while (true)
-                                {
-                                    var candidateGroup = groups
-                                                         // Map each group to an index.
-                                                         .Select((items, index) => new { index, items })
-                                                         // Order groups by their weights.
-                                                         .OrderBy(group => groupWeights[group.index])
-                                                         // Select the first group with remaining items (null is set from previous iterations).
-                                                         .FirstOrDefault(group => group.items.Any(i => i != null));
-
-                                    // Iteration ends when all groups have been exhausted of items.
-                                    if (candidateGroup == null)
-                                        break;
-
-                                    // Find the index of the first non-null (i.e. unused) item in the group.
-                                    int candidateItemIndex = 0;
-                                    RearrangeableListItem<PlaylistItem> candidateItem = null;
-
-                                    for (int i = 0; i < candidateGroup.items.Length; i++)
-                                    {
-                                        if (candidateGroup.items[i] != null)
-                                        {
-                                            candidateItemIndex = i;
-                                            candidateItem = candidateGroup.items[i];
-                                        }
-                                    }
-
-                                    // The item is guaranteed to not be expired, since we've previously removed all expired items.
-                                    Debug.Assert(candidateItem?.Model.Expired == false);
-
-                                    // Add the item to the result set.
-                                    result.Add(candidateItem);
-
-                                    // Update the group for the next iteration.
-                                    candidateGroup.items[candidateItemIndex] = null;
-                                    groupWeights[candidateGroup.index]++;
-                                }
-
-                                return result;
-                        }
-                    }
-                }
-            }
-        }
     }
 }
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/QueueList.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/QueueList.cs
new file mode 100644
index 0000000000..5b691fdfda
--- /dev/null
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/QueueList.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.Collections.Generic;
+using System.Diagnostics;
+using System.Linq;
+using osu.Framework.Bindables;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
+using osu.Game.Online.Multiplayer;
+using osu.Game.Online.Rooms;
+using osuTK;
+
+namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist
+{
+    public class QueueList : DrawableRoomPlaylist
+    {
+        public readonly IBindable<QueueMode> QueueMode = new Bindable<QueueMode>();
+
+        public QueueList(bool allowEdit, bool allowSelection, bool reverse = false)
+            : base(allowEdit, allowSelection, reverse)
+        {
+        }
+
+        protected override FillFlowContainer<RearrangeableListItem<PlaylistItem>> CreateListFillFlowContainer() => new QueueFillFlowContainer
+        {
+            QueueMode = { BindTarget = QueueMode },
+            Spacing = new Vector2(0, 2)
+        };
+
+        private class QueueFillFlowContainer : FillFlowContainer<RearrangeableListItem<PlaylistItem>>
+        {
+            public readonly IBindable<QueueMode> QueueMode = new Bindable<QueueMode>();
+
+            protected override void LoadComplete()
+            {
+                base.LoadComplete();
+                QueueMode.BindValueChanged(_ => InvalidateLayout());
+            }
+
+            public override IEnumerable<Drawable> FlowingChildren
+            {
+                get
+                {
+                    switch (QueueMode.Value)
+                    {
+                        default:
+                            return AliveInternalChildren.Where(d => d.IsPresent)
+                                                        .OfType<RearrangeableListItem<PlaylistItem>>()
+                                                        .OrderBy(item => item.Model.ID);
+
+                        case Game.Online.Multiplayer.QueueMode.AllPlayersRoundRobin:
+                            // TODO: THIS IS SO INEFFICIENT, can it be done any better?
+
+                            // Group all items by their owners.
+                            var groups = AliveInternalChildren.Where(d => d.IsPresent)
+                                                              .OfType<RearrangeableListItem<PlaylistItem>>()
+                                                              .GroupBy(item => item.Model.OwnerID)
+                                                              .Select(g => g.ToArray())
+                                                              .ToArray();
+
+                            if (groups.Length == 0)
+                                return Enumerable.Empty<Drawable>();
+
+                            // Find the initial picking order for the groups. The group with the smallest 'weight' picks first.
+                            int[] groupWeights = new int[groups.Length];
+
+                            for (int i = 0; i < groups.Length; i++)
+                            {
+                                groupWeights[i] = groups[i].Count(item => item.Model.Expired);
+                                groups[i] = groups[i].Where(item => !item.Model.Expired).ToArray();
+                            }
+
+                            var result = new List<Drawable>();
+
+                            // Simulate the playlist by picking in order from the smallest-weighted room each time until no longer able to.
+                            while (true)
+                            {
+                                var candidateGroup = groups
+                                                     // Map each group to an index.
+                                                     .Select((items, index) => new { index, items })
+                                                     // Order groups by their weights.
+                                                     .OrderBy(group => groupWeights[group.index])
+                                                     // Select the first group with remaining items (null is set from previous iterations).
+                                                     .FirstOrDefault(group => group.items.Any(i => i != null));
+
+                                // Iteration ends when all groups have been exhausted of items.
+                                if (candidateGroup == null)
+                                    break;
+
+                                // Find the index of the first non-null (i.e. unused) item in the group.
+                                int candidateItemIndex = 0;
+                                RearrangeableListItem<PlaylistItem> candidateItem = null;
+
+                                for (int i = 0; i < candidateGroup.items.Length; i++)
+                                {
+                                    if (candidateGroup.items[i] != null)
+                                    {
+                                        candidateItemIndex = i;
+                                        candidateItem = candidateGroup.items[i];
+                                    }
+                                }
+
+                                // The item is guaranteed to not be expired, since we've previously removed all expired items.
+                                Debug.Assert(candidateItem?.Model.Expired == false);
+
+                                // Add the item to the result set.
+                                result.Add(candidateItem);
+
+                                // Update the group for the next iteration.
+                                candidateGroup.items[candidateItemIndex] = null;
+                                groupWeights[candidateGroup.index]++;
+                            }
+
+                            return result;
+                    }
+                }
+            }
+        }
+    }
+}

From 68bb49fc1e795c86879ebcebaa6b599402531dd0 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 26 Nov 2021 20:02:30 +0900
Subject: [PATCH 1429/5547] Add QueueList tests

---
 .../TestSceneMultiplayerQueueList.cs          | 153 ++++++++++++++++++
 .../Multiplayer/Match/Playlist/QueueList.cs   |   2 +-
 2 files changed, 154 insertions(+), 1 deletion(-)
 create mode 100644 osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs
new file mode 100644
index 0000000000..b08b76a7ac
--- /dev/null
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs
@@ -0,0 +1,153 @@
+// 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.Online.Multiplayer;
+using osu.Game.Online.Rooms;
+using osu.Game.Rulesets.Osu;
+using osu.Game.Screens.OnlinePlay;
+using osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist;
+using osu.Game.Tests.Beatmaps;
+
+namespace osu.Game.Tests.Visual.Multiplayer
+{
+    public class TestSceneMultiplayerQueueList : OsuTestScene
+    {
+        private QueueList list;
+        private int currentItemId;
+
+        [SetUp]
+        public void Setup() => Schedule(() =>
+        {
+            Child = list = new QueueList(false, false)
+            {
+                Anchor = Anchor.Centre,
+                Origin = Anchor.Centre,
+                RelativeSizeAxes = Axes.Both,
+                Width = 0.4f,
+                Height = 0.6f
+            };
+        });
+
+        [Test]
+        public void TestItemsAddedToEndInHostOnlyMode()
+        {
+            changeQueueModeStep(QueueMode.HostOnly);
+
+            // User 1.
+
+            PlaylistItem item1 = addItemStep(1);
+            assertPositionStep(item1, 0);
+
+            PlaylistItem item2 = addItemStep(1);
+            assertPositionStep(item2, 1);
+
+            // User 2.
+
+            PlaylistItem item3 = addItemStep(2);
+            assertPositionStep(item3, 2);
+        }
+
+        [Test]
+        public void TestItemsAddedToEndInAllPlayersMode()
+        {
+            changeQueueModeStep(QueueMode.AllPlayers);
+
+            // User 1.
+
+            PlaylistItem item1 = addItemStep(1);
+            assertPositionStep(item1, 0);
+
+            PlaylistItem item2 = addItemStep(1);
+            assertPositionStep(item2, 1);
+
+            // User 2.
+
+            PlaylistItem item3 = addItemStep(2);
+            assertPositionStep(item3, 2);
+        }
+
+        [Test]
+        public void TestItemsInsertedInCorrectPositionInRoundRobinMode()
+        {
+            changeQueueModeStep(QueueMode.AllPlayersRoundRobin);
+
+            // User 1.
+
+            PlaylistItem item1 = addItemStep(1);
+            assertPositionStep(item1, 0);
+
+            PlaylistItem item2 = addItemStep(1);
+            assertPositionStep(item2, 1);
+
+            // User 2.
+
+            PlaylistItem item3 = addItemStep(2);
+            assertPositionStep(item3, 1);
+            assertPositionStep(item2, 2);
+
+            PlaylistItem item4 = addItemStep(2);
+            assertPositionStep(item4, 3);
+
+            PlaylistItem item5 = addItemStep(2);
+            assertPositionStep(item5, 4);
+
+            // User 1.
+
+            PlaylistItem item6 = addItemStep(1);
+            assertPositionStep(item6, 4);
+            assertPositionStep(item5, 5);
+
+            // User 3.
+
+            PlaylistItem item7 = addItemStep(3);
+            assertPositionStep(item7, 2);
+
+            PlaylistItem item8 = addItemStep(3);
+            assertPositionStep(item8, 5);
+
+            PlaylistItem item9 = addItemStep(3);
+            assertPositionStep(item9, 8);
+        }
+
+        /// <summary>
+        /// Adds a step to create a new playlist item.
+        /// </summary>
+        /// <param name="ownerId">The item owner.</param>
+        /// <returns>The playlist item's ID.</returns>
+        private PlaylistItem addItemStep(int ownerId)
+        {
+            var item = new PlaylistItem
+            {
+                ID = ++currentItemId,
+                OwnerID = ownerId,
+                Beatmap = { Value = new TestBeatmap(new OsuRuleset().RulesetInfo, false).BeatmapInfo }
+            };
+
+            AddStep($"add {{ item: {item.ID}, user: {ownerId} }}", () => list.Items.Add(item));
+
+            return item;
+        }
+
+        /// <summary>
+        /// Asserts the position of a given playlist item in the visual layout of the list.
+        /// </summary>
+        /// <param name="item">The playlist item.</param>
+        /// <param name="visualIndex">The index at which the item should appear visually. The item with index 0 is at the top of the list.</param>
+        private void assertPositionStep(PlaylistItem item, int visualIndex)
+        {
+            AddUntilStep($"item {item.ID} has pos = {visualIndex}", () =>
+            {
+                return this.ChildrenOfType<DrawableRoomPlaylistItem>()
+                           .OrderBy(drawable => drawable.Position.Y)
+                           .TakeWhile(drawable => drawable.Item.ID != item.ID)
+                           .Count() == visualIndex;
+            });
+        }
+
+        private void changeQueueModeStep(QueueMode newMode) => AddStep($"change queue mode to {newMode}", () => list.QueueMode.Value = newMode);
+    }
+}
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/QueueList.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/QueueList.cs
index 5b691fdfda..971196865b 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/QueueList.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/QueueList.cs
@@ -15,7 +15,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist
 {
     public class QueueList : DrawableRoomPlaylist
     {
-        public readonly IBindable<QueueMode> QueueMode = new Bindable<QueueMode>();
+        public readonly Bindable<QueueMode> QueueMode = new Bindable<QueueMode>();
 
         public QueueList(bool allowEdit, bool allowSelection, bool reverse = false)
             : base(allowEdit, allowSelection, reverse)

From 9806c75743387baa015630b611f4355451fa2ae2 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 26 Nov 2021 21:13:21 +0900
Subject: [PATCH 1430/5547] Implement better round robin algorithm

---
 .../Multiplayer/Match/Playlist/QueueList.cs   | 77 ++++++-------------
 1 file changed, 23 insertions(+), 54 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/QueueList.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/QueueList.cs
index 971196865b..6d4ea5c7fa 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/QueueList.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/QueueList.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;
 using System.Collections.Generic;
-using System.Diagnostics;
 using System.Linq;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
@@ -50,66 +50,35 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist
                                                         .OrderBy(item => item.Model.ID);
 
                         case Game.Online.Multiplayer.QueueMode.AllPlayersRoundRobin:
-                            // TODO: THIS IS SO INEFFICIENT, can it be done any better?
+                            RearrangeableListItem<PlaylistItem>[] allItems = AliveInternalChildren
+                                                                             .Where(d => d.IsPresent)
+                                                                             .OfType<RearrangeableListItem<PlaylistItem>>()
+                                                                             .OrderBy(item => item.Model.ID)
+                                                                             .ToArray();
 
-                            // Group all items by their owners.
-                            var groups = AliveInternalChildren.Where(d => d.IsPresent)
-                                                              .OfType<RearrangeableListItem<PlaylistItem>>()
-                                                              .GroupBy(item => item.Model.OwnerID)
-                                                              .Select(g => g.ToArray())
-                                                              .ToArray();
-
-                            if (groups.Length == 0)
+                            int totalCount = allItems.Length;
+                            if (totalCount == 0)
                                 return Enumerable.Empty<Drawable>();
 
-                            // Find the initial picking order for the groups. The group with the smallest 'weight' picks first.
-                            int[] groupWeights = new int[groups.Length];
+                            Dictionary<int, int> perUserCounts = allItems
+                                                                 .Select(item => item.Model.OwnerID)
+                                                                 .Distinct()
+                                                                 .ToDictionary(u => u, _ => 0);
 
-                            for (int i = 0; i < groups.Length; i++)
+                            List<Drawable> result = new List<Drawable>();
+
+                            while (totalCount-- > 0)
                             {
-                                groupWeights[i] = groups[i].Count(item => item.Model.Expired);
-                                groups[i] = groups[i].Where(item => !item.Model.Expired).ToArray();
-                            }
+                                var candidateItem = allItems
+                                                    .Where(item => item != null)
+                                                    .OrderBy(item => perUserCounts[item.Model.OwnerID])
+                                                    .First();
 
-                            var result = new List<Drawable>();
+                                int itemIndex = Array.IndexOf(allItems, candidateItem);
 
-                            // Simulate the playlist by picking in order from the smallest-weighted room each time until no longer able to.
-                            while (true)
-                            {
-                                var candidateGroup = groups
-                                                     // Map each group to an index.
-                                                     .Select((items, index) => new { index, items })
-                                                     // Order groups by their weights.
-                                                     .OrderBy(group => groupWeights[group.index])
-                                                     // Select the first group with remaining items (null is set from previous iterations).
-                                                     .FirstOrDefault(group => group.items.Any(i => i != null));
-
-                                // Iteration ends when all groups have been exhausted of items.
-                                if (candidateGroup == null)
-                                    break;
-
-                                // Find the index of the first non-null (i.e. unused) item in the group.
-                                int candidateItemIndex = 0;
-                                RearrangeableListItem<PlaylistItem> candidateItem = null;
-
-                                for (int i = 0; i < candidateGroup.items.Length; i++)
-                                {
-                                    if (candidateGroup.items[i] != null)
-                                    {
-                                        candidateItemIndex = i;
-                                        candidateItem = candidateGroup.items[i];
-                                    }
-                                }
-
-                                // The item is guaranteed to not be expired, since we've previously removed all expired items.
-                                Debug.Assert(candidateItem?.Model.Expired == false);
-
-                                // Add the item to the result set.
-                                result.Add(candidateItem);
-
-                                // Update the group for the next iteration.
-                                candidateGroup.items[candidateItemIndex] = null;
-                                groupWeights[candidateGroup.index]++;
+                                result.Add(allItems[itemIndex]);
+                                perUserCounts[candidateItem.Model.OwnerID]++;
+                                allItems[itemIndex] = null;
                             }
 
                             return result;

From 48a181af1f002df2ead3c7c1764497acd3c26a5f Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 30 Nov 2021 19:09:45 +0900
Subject: [PATCH 1431/5547] Fix test button display

---
 .../Visual/Multiplayer/TestSceneMultiplayerQueueList.cs    | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs
index b08b76a7ac..f52683df8e 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs
@@ -32,6 +32,13 @@ namespace osu.Game.Tests.Visual.Multiplayer
             };
         });
 
+        [SetUpSteps]
+        public void SetUpSteps()
+        {
+            // Not scheduled since this should affect buttons added by the current test.
+            currentItemId = 0;
+        }
+
         [Test]
         public void TestItemsAddedToEndInHostOnlyMode()
         {

From 7e800659aa1fec2acac5b70e48f30efba4bbf260 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 30 Nov 2021 19:09:52 +0900
Subject: [PATCH 1432/5547] Fix incorrect assertion

---
 .../Visual/Multiplayer/TestSceneMultiplayerQueueList.cs      | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs
index f52683df8e..c88b8bf4d5 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs
@@ -104,9 +104,10 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             // User 1.
 
+            // This item is added to the end rather than injected between item4 and item5, since both users have an equal number
+            // of added items at this point and this user was the last of the two to add an item.
             PlaylistItem item6 = addItemStep(1);
-            assertPositionStep(item6, 4);
-            assertPositionStep(item5, 5);
+            assertPositionStep(item6, 5);
 
             // User 3.
 

From 6b198ce11260e8a1884de26d27b67f0e9b21f2a3 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 30 Nov 2021 20:12:18 +0900
Subject: [PATCH 1433/5547] Document simulation

---
 .../OnlinePlay/Multiplayer/Match/Playlist/QueueList.cs        | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/QueueList.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/QueueList.cs
index 6d4ea5c7fa..a783e66ee6 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/QueueList.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/QueueList.cs
@@ -67,6 +67,10 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist
 
                             List<Drawable> result = new List<Drawable>();
 
+                            // Run a simulation...
+                            // In every iteration, pick the first available item from the user with the lowest number of items in the queue to add to the result set.
+                            // If multiple users have the same number of items in the queue, then the item with the lowest ID is chosen.
+                            // Todo: This could probably be more efficient, likely at the cost of increased complexity.
                             while (totalCount-- > 0)
                             {
                                 var candidateItem = allItems

From 89d22824c354dedbc19d8312ccb6f7fa5402a98c Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 30 Nov 2021 20:54:20 +0900
Subject: [PATCH 1434/5547] Fix incorrect comment

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

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs
index c88b8bf4d5..d6b53819c9 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs
@@ -35,7 +35,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [SetUpSteps]
         public void SetUpSteps()
         {
-            // Not scheduled since this should affect buttons added by the current test.
+            // Not inside a step since this is used to affect steps added by the current test.
             currentItemId = 0;
         }
 

From 01108016a7f45c7e9d47a1cc77d46128846ffd9f Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 30 Nov 2021 21:13:38 +0900
Subject: [PATCH 1435/5547] Add reorder test

---
 .../TestSceneMultiplayerQueueList.cs          | 23 +++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs
index d6b53819c9..83c611e325 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.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.Framework.Graphics;
@@ -121,6 +122,28 @@ namespace osu.Game.Tests.Visual.Multiplayer
             assertPositionStep(item9, 8);
         }
 
+        [Test]
+        public void TestItemsReorderedWhenQueueModeChanged()
+        {
+            changeQueueModeStep(QueueMode.AllPlayers);
+
+            var items = new List<PlaylistItem>();
+
+            for (int i = 0; i < 8; i++)
+                items.Add(addItemStep(i <= 3 ? 1 : 2));
+
+            for (int i = 0; i < 8; i++)
+                assertPositionStep(items[i], i);
+
+            changeQueueModeStep(QueueMode.AllPlayersRoundRobin);
+
+            for (int i = 0; i < 4; i++)
+            {
+                assertPositionStep(items[i], i * 2); // Items by user 1.
+                assertPositionStep(items[i + 4], i * 2 + 1); // Items by user 2.
+            }
+        }
+
         /// <summary>
         /// Adds a step to create a new playlist item.
         /// </summary>

From bfd2dc28c896e109926f8111bb7891e7ccf1234b Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 1 Dec 2021 16:56:32 +0900
Subject: [PATCH 1436/5547] Rename QueueList -> MultiplayerQueueList

---
 .../Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs    | 8 ++++----
 .../Visual/Multiplayer/TestSceneMultiplayerQueueList.cs   | 4 ++--
 .../Playlist/{QueueList.cs => MultiplayerQueueList.cs}    | 4 ++--
 3 files changed, 8 insertions(+), 8 deletions(-)
 rename osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/{QueueList.cs => MultiplayerQueueList.cs} (96%)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs
index 3244e9420d..977a6f0115 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs
@@ -74,7 +74,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
         public class MultiplayerPlaylist : MultiplayerRoomComposite
         {
-            private QueueList queueList;
+            private MultiplayerQueueList multiplayerQueueList;
             private DrawableRoomPlaylist historyList;
             private bool firstPopulation = true;
 
@@ -88,7 +88,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     {
                         new Drawable[]
                         {
-                            queueList = new QueueList(false, false, true)
+                            multiplayerQueueList = new MultiplayerQueueList(false, false, true)
                             {
                                 RelativeSizeAxes = Axes.Both
                             },
@@ -123,14 +123,14 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 if (item.Expired)
                     historyList.Items.Add(getPlaylistItem(item));
                 else
-                    queueList.Items.Add(getPlaylistItem(item));
+                    multiplayerQueueList.Items.Add(getPlaylistItem(item));
             }
 
             protected override void PlaylistItemRemoved(long item)
             {
                 base.PlaylistItemRemoved(item);
 
-                queueList.Items.RemoveAll(i => i.ID == item);
+                multiplayerQueueList.Items.RemoveAll(i => i.ID == item);
             }
 
             protected override void PlaylistItemChanged(MultiplayerPlaylistItem item)
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs
index 83c611e325..2186d2e594 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs
@@ -17,13 +17,13 @@ namespace osu.Game.Tests.Visual.Multiplayer
 {
     public class TestSceneMultiplayerQueueList : OsuTestScene
     {
-        private QueueList list;
+        private MultiplayerQueueList list;
         private int currentItemId;
 
         [SetUp]
         public void Setup() => Schedule(() =>
         {
-            Child = list = new QueueList(false, false)
+            Child = list = new MultiplayerQueueList(false, false)
             {
                 Anchor = Anchor.Centre,
                 Origin = Anchor.Centre,
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/QueueList.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerQueueList.cs
similarity index 96%
rename from osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/QueueList.cs
rename to osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerQueueList.cs
index a783e66ee6..de3ad7b824 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/QueueList.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerQueueList.cs
@@ -13,11 +13,11 @@ using osuTK;
 
 namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist
 {
-    public class QueueList : DrawableRoomPlaylist
+    public class MultiplayerQueueList : DrawableRoomPlaylist
     {
         public readonly Bindable<QueueMode> QueueMode = new Bindable<QueueMode>();
 
-        public QueueList(bool allowEdit, bool allowSelection, bool reverse = false)
+        public MultiplayerQueueList(bool allowEdit, bool allowSelection, bool reverse = false)
             : base(allowEdit, allowSelection, reverse)
         {
         }

From e0ca1af9b896565bf41f2bb8d75d4ae0413b59c4 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 1 Dec 2021 16:58:48 +0900
Subject: [PATCH 1437/5547] Remove ctor params

---
 .../Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs        | 2 +-
 .../Visual/Multiplayer/TestSceneMultiplayerQueueList.cs       | 2 +-
 .../Multiplayer/Match/Playlist/MultiplayerQueueList.cs        | 4 ++--
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs
index 977a6f0115..b9f147e44a 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs
@@ -88,7 +88,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     {
                         new Drawable[]
                         {
-                            multiplayerQueueList = new MultiplayerQueueList(false, false, true)
+                            multiplayerQueueList = new MultiplayerQueueList
                             {
                                 RelativeSizeAxes = Axes.Both
                             },
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs
index 2186d2e594..2e24d54b59 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs
@@ -23,7 +23,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [SetUp]
         public void Setup() => Schedule(() =>
         {
-            Child = list = new MultiplayerQueueList(false, false)
+            Child = list = new MultiplayerQueueList
             {
                 Anchor = Anchor.Centre,
                 Origin = Anchor.Centre,
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerQueueList.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerQueueList.cs
index de3ad7b824..802603d7e1 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerQueueList.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerQueueList.cs
@@ -17,8 +17,8 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist
     {
         public readonly Bindable<QueueMode> QueueMode = new Bindable<QueueMode>();
 
-        public MultiplayerQueueList(bool allowEdit, bool allowSelection, bool reverse = false)
-            : base(allowEdit, allowSelection, reverse)
+        public MultiplayerQueueList()
+            : base(false, false, false, true)
         {
         }
 

From fc8c8685b87dd958a8cdeb0d1abba6157a120926 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 1 Dec 2021 18:44:46 +0900
Subject: [PATCH 1438/5547] Add playlist queue tests

---
 .../TestSceneMultiplayerPlaylist.cs           | 145 +++++++++++++++---
 .../Match/Playlist/MultiplayerHistoryList.cs  |  30 ++++
 .../Multiplayer/TestMultiplayerClient.cs      |   4 +-
 3 files changed, 158 insertions(+), 21 deletions(-)
 create mode 100644 osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerHistoryList.cs

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs
index b9f147e44a..136625682a 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs
@@ -10,7 +10,6 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Platform;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
-using osu.Game.Database;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Rooms;
 using osu.Game.Rulesets;
@@ -29,9 +28,6 @@ namespace osu.Game.Tests.Visual.Multiplayer
         private BeatmapSetInfo importedSet;
         private BeatmapInfo importedBeatmap;
 
-        [Cached(typeof(UserLookupCache))]
-        private UserLookupCache lookupCache = new TestUserLookupCache();
-
         [BackgroundDependencyLoader]
         private void load(GameHost host, AudioManager audio)
         {
@@ -60,22 +56,132 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 importedSet = beatmaps.GetAllUsableBeatmapSetsEnumerable(IncludedDetails.All).First();
                 importedBeatmap = importedSet.Beatmaps.First(b => b.RulesetID == 0);
             });
+
+            AddStep("change to all players mode", () => Client.ChangeSettings(new MultiplayerRoomSettings { QueueMode = QueueMode.AllPlayers }));
         }
 
         [Test]
-        public void DoTest()
+        public void TestNonExpiredItemsAddedToQueueList()
         {
-            AddStep("change to round robin mode", () => Client.ChangeSettings(new MultiplayerRoomSettings { QueueMode = QueueMode.AllPlayersRoundRobin }));
-            AddStep("add playlist item for user 1", () => Client.AddPlaylistItem(new MultiplayerPlaylistItem
-            {
-                BeatmapID = importedBeatmap.OnlineID!.Value
-            }));
+            assertItemInQueueListStep(1, 0);
+
+            addItemStep();
+            assertItemInQueueListStep(2, 1);
+
+            addItemStep();
+            assertItemInQueueListStep(3, 2);
+        }
+
+        [Test]
+        public void TestExpiredItemsAddedToHistoryList()
+        {
+            assertItemInQueueListStep(1, 0);
+
+            addItemStep(true);
+            assertItemInHistoryListStep(2, 0);
+
+            addItemStep(true);
+            assertItemInHistoryListStep(3, 0);
+            assertItemInHistoryListStep(2, 1);
+
+            // Initial item is still in the queue.
+            assertItemInQueueListStep(1, 0);
+        }
+
+        [Test]
+        public void TestExpiredItemsMoveToQueueList()
+        {
+            addItemStep();
+            addItemStep();
+
+            AddStep("finish current item", () => Client.FinishCurrentItem());
+
+            assertItemInHistoryListStep(1, 0);
+            assertItemInQueueListStep(2, 0);
+            assertItemInQueueListStep(3, 1);
+
+            AddStep("finish current item", () => Client.FinishCurrentItem());
+
+            assertItemInHistoryListStep(2, 0);
+            assertItemInHistoryListStep(1, 1);
+            assertItemInQueueListStep(3, 0);
+
+            AddStep("finish current item", () => Client.FinishCurrentItem());
+
+            assertItemInHistoryListStep(3, 0);
+            assertItemInHistoryListStep(2, 1);
+            assertItemInHistoryListStep(1, 2);
+        }
+
+        [Test]
+        public void TestJoinRoomWithMixedItemsAddedInCorrectLists()
+        {
+            AddStep("leave room", () => RoomManager.PartRoom());
+            AddUntilStep("wait for room part", () => Client.Room == null);
+        }
+
+        /// <summary>
+        /// Adds a step to create a new playlist item.
+        /// </summary>
+        private void addItemStep(bool expired = false) => AddStep("add item", () => Client.AddPlaylistItem(new MultiplayerPlaylistItem(new PlaylistItem
+        {
+            Beatmap = { Value = importedBeatmap },
+            BeatmapID = importedBeatmap.OnlineID ?? -1,
+            Expired = expired
+        })));
+
+        /// <summary>
+        /// Asserts the position of a given playlist item in the queue list.
+        /// </summary>
+        /// <param name="playlistItemId">The item id.</param>
+        /// <param name="visualIndex">The index at which the item should appear visually. The item with index 0 is at the top of the list.</param>
+        private void assertItemInQueueListStep(int playlistItemId, int visualIndex) => AddUntilStep($"{playlistItemId} in queue at pos = {visualIndex}", () =>
+        {
+            return !inHistoryList(playlistItemId)
+                   && this.ChildrenOfType<MultiplayerQueueList>()
+                          .Single()
+                          .ChildrenOfType<DrawableRoomPlaylistItem>()
+                          .OrderBy(drawable => drawable.Position.Y)
+                          .TakeWhile(drawable => drawable.Item.ID != playlistItemId)
+                          .Count() == visualIndex;
+        });
+
+        /// <summary>
+        /// Asserts the position of a given playlist item in the history list.
+        /// </summary>
+        /// <param name="playlistItemId">The item id.</param>
+        /// <param name="visualIndex">The index at which the item should appear visually. The item with index 0 is at the top of the list.</param>
+        private void assertItemInHistoryListStep(int playlistItemId, int visualIndex) => AddUntilStep($"{playlistItemId} in history at pos = {visualIndex}", () =>
+        {
+            return !inQueueList(playlistItemId)
+                   && this.ChildrenOfType<MultiplayerHistoryList>()
+                          .Single()
+                          .ChildrenOfType<DrawableRoomPlaylistItem>()
+                          .OrderBy(drawable => drawable.Position.Y)
+                          .TakeWhile(drawable => drawable.Item.ID != playlistItemId)
+                          .Count() == visualIndex;
+        });
+
+        private bool inQueueList(int playlistItemId)
+        {
+            return this.ChildrenOfType<MultiplayerQueueList>()
+                       .Single()
+                       .ChildrenOfType<DrawableRoomPlaylistItem>()
+                       .Any(i => i.Item.ID == playlistItemId);
+        }
+
+        private bool inHistoryList(int playlistItemId)
+        {
+            return this.ChildrenOfType<MultiplayerHistoryList>()
+                       .Single()
+                       .ChildrenOfType<DrawableRoomPlaylistItem>()
+                       .Any(i => i.Item.ID == playlistItemId);
         }
 
         public class MultiplayerPlaylist : MultiplayerRoomComposite
         {
-            private MultiplayerQueueList multiplayerQueueList;
-            private DrawableRoomPlaylist historyList;
+            private MultiplayerQueueList queueList;
+            private MultiplayerHistoryList historyList;
             private bool firstPopulation = true;
 
             [BackgroundDependencyLoader]
@@ -88,11 +194,11 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     {
                         new Drawable[]
                         {
-                            multiplayerQueueList = new MultiplayerQueueList
+                            queueList = new MultiplayerQueueList
                             {
                                 RelativeSizeAxes = Axes.Both
                             },
-                            historyList = new DrawableRoomPlaylist(false, false, true)
+                            historyList = new MultiplayerHistoryList
                             {
                                 RelativeSizeAxes = Axes.Both
                             }
@@ -120,17 +226,20 @@ namespace osu.Game.Tests.Visual.Multiplayer
             {
                 base.PlaylistItemAdded(item);
 
+                var apiItem = Playlist.Single(i => i.ID == item.ID);
+
                 if (item.Expired)
-                    historyList.Items.Add(getPlaylistItem(item));
+                    historyList.Items.Add(apiItem);
                 else
-                    multiplayerQueueList.Items.Add(getPlaylistItem(item));
+                    queueList.Items.Add(apiItem);
             }
 
             protected override void PlaylistItemRemoved(long item)
             {
                 base.PlaylistItemRemoved(item);
 
-                multiplayerQueueList.Items.RemoveAll(i => i.ID == item);
+                queueList.Items.RemoveAll(i => i.ID == item);
+                historyList.Items.RemoveAll(i => i.ID == item);
             }
 
             protected override void PlaylistItemChanged(MultiplayerPlaylistItem item)
@@ -140,8 +249,6 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 PlaylistItemRemoved(item.ID);
                 PlaylistItemAdded(item);
             }
-
-            private PlaylistItem getPlaylistItem(MultiplayerPlaylistItem item) => Playlist.Single(i => i.ID == item.ID);
         }
     }
 }
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerHistoryList.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerHistoryList.cs
new file mode 100644
index 0000000000..76bb364f3a
--- /dev/null
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerHistoryList.cs
@@ -0,0 +1,30 @@
+// 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.Graphics;
+using osu.Framework.Graphics.Containers;
+using osu.Game.Online.Rooms;
+using osuTK;
+
+namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist
+{
+    public class MultiplayerHistoryList : DrawableRoomPlaylist
+    {
+        public MultiplayerHistoryList()
+            : base(false, false, false, true)
+        {
+        }
+
+        protected override FillFlowContainer<RearrangeableListItem<PlaylistItem>> CreateListFillFlowContainer() => new HistoryFillFlowContainer
+        {
+            Spacing = new Vector2(0, 2)
+        };
+
+        private class HistoryFillFlowContainer : FillFlowContainer<RearrangeableListItem<PlaylistItem>>
+        {
+            public override IEnumerable<Drawable> FlowingChildren => base.FlowingChildren.Reverse();
+        }
+    }
+}
diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
index 2d77e17513..b746f7e667 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
@@ -145,7 +145,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
                             ((IMultiplayerClient)this).ResultsReady();
 
-                            finishCurrentItem().Wait();
+                            FinishCurrentItem().Wait();
                         }
 
                         break;
@@ -390,7 +390,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             await updateCurrentItem(Room).ConfigureAwait(false);
         }
 
-        private async Task finishCurrentItem()
+        public async Task FinishCurrentItem()
         {
             Debug.Assert(Room != null);
             Debug.Assert(APIRoom != null);

From a4cd22d5a97295bb2de4b53026ae33afd1a40e56 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 1 Dec 2021 18:57:29 +0900
Subject: [PATCH 1439/5547] Clear lists on room leave

---
 .../Multiplayer/TestSceneMultiplayerPlaylist.cs | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs
index 136625682a..74284e21f1 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs
@@ -113,6 +113,19 @@ namespace osu.Game.Tests.Visual.Multiplayer
             assertItemInHistoryListStep(1, 2);
         }
 
+        [Test]
+        public void TestListsClearedWhenRoomLeft()
+        {
+            addItemStep();
+            AddStep("finish current item", () => Client.FinishCurrentItem());
+
+            AddStep("leave room", () => RoomManager.PartRoom());
+            AddUntilStep("wait for room part", () => Client.Room == null);
+
+            AddUntilStep("item 0 not in lists", () => !inHistoryList(0) && !inQueueList(0));
+            AddUntilStep("item 1 not in lists", () => !inHistoryList(0) && !inQueueList(0));
+        }
+
         [Test]
         public void TestJoinRoomWithMixedItemsAddedInCorrectLists()
         {
@@ -212,7 +225,11 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 base.OnRoomUpdated();
 
                 if (Room == null)
+                {
+                    historyList.Items.Clear();
+                    queueList.Items.Clear();
                     return;
+                }
 
                 if (!firstPopulation) return;
 

From 0b3cc47a51645d67892ac1182a4a9d3b8141eb6b Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 1 Dec 2021 19:02:17 +0900
Subject: [PATCH 1440/5547] Fix list not repopulating on new room

---
 .../TestSceneMultiplayerPlaylist.cs           | 40 ++++++++++++++++---
 1 file changed, 35 insertions(+), 5 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs
index 74284e21f1..df34e3b6af 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs
@@ -16,6 +16,7 @@ using osu.Game.Rulesets;
 using osu.Game.Screens.OnlinePlay;
 using osu.Game.Screens.OnlinePlay.Multiplayer;
 using osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist;
+using osu.Game.Tests.Beatmaps;
 using osu.Game.Tests.Resources;
 using osuTK;
 
@@ -131,6 +132,33 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             AddStep("leave room", () => RoomManager.PartRoom());
             AddUntilStep("wait for room part", () => Client.Room == null);
+
+            AddStep("join room with items", () =>
+            {
+                RoomManager.CreateRoom(new Room
+                {
+                    Name = { Value = "test name" },
+                    Playlist =
+                    {
+                        new PlaylistItem
+                        {
+                            Beatmap = { Value = new TestBeatmap(Ruleset.Value).BeatmapInfo },
+                            Ruleset = { Value = Ruleset.Value }
+                        },
+                        new PlaylistItem
+                        {
+                            Beatmap = { Value = new TestBeatmap(Ruleset.Value).BeatmapInfo },
+                            Ruleset = { Value = Ruleset.Value },
+                            Expired = true
+                        }
+                    }
+                });
+            });
+
+            AddUntilStep("wait for room join", () => RoomJoined);
+
+            assertItemInQueueListStep(1, 0);
+            assertItemInHistoryListStep(2, 0);
         }
 
         /// <summary>
@@ -228,15 +256,17 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 {
                     historyList.Items.Clear();
                     queueList.Items.Clear();
+                    firstPopulation = true;
                     return;
                 }
 
-                if (!firstPopulation) return;
+                if (firstPopulation)
+                {
+                    foreach (var item in Room.Playlist)
+                        PlaylistItemAdded(item);
 
-                foreach (var item in Room.Playlist)
-                    PlaylistItemAdded(item);
-
-                firstPopulation = false;
+                    firstPopulation = false;
+                }
             }
 
             protected override void PlaylistItemAdded(MultiplayerPlaylistItem item)

From 11c137cf83523a76904a6f2eb539f80b07a30874 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 1 Dec 2021 19:22:21 +0900
Subject: [PATCH 1441/5547] Ignore test

---
 .../Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs           | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs
index df34e3b6af..3117db8900 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs
@@ -127,6 +127,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddUntilStep("item 1 not in lists", () => !inHistoryList(0) && !inQueueList(0));
         }
 
+        [Ignore("Expired items are initially removed from the room.")]
         [Test]
         public void TestJoinRoomWithMixedItemsAddedInCorrectLists()
         {

From 95050d6597e559879b6103899979e7529f00d936 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 1 Dec 2021 19:23:35 +0900
Subject: [PATCH 1442/5547] Extract class to file

---
 .../TestSceneMultiplayerPlaylist.cs           | 81 -----------------
 .../Match/Playlist/MultiplayerPlaylist.cs     | 90 +++++++++++++++++++
 2 files changed, 90 insertions(+), 81 deletions(-)
 create mode 100644 osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylist.cs

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs
index 3117db8900..b21dbbd462 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs
@@ -6,7 +6,6 @@ using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
 using osu.Framework.Graphics;
-using osu.Framework.Graphics.Containers;
 using osu.Framework.Platform;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
@@ -14,7 +13,6 @@ using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Rooms;
 using osu.Game.Rulesets;
 using osu.Game.Screens.OnlinePlay;
-using osu.Game.Screens.OnlinePlay.Multiplayer;
 using osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist;
 using osu.Game.Tests.Beatmaps;
 using osu.Game.Tests.Resources;
@@ -219,84 +217,5 @@ namespace osu.Game.Tests.Visual.Multiplayer
                        .ChildrenOfType<DrawableRoomPlaylistItem>()
                        .Any(i => i.Item.ID == playlistItemId);
         }
-
-        public class MultiplayerPlaylist : MultiplayerRoomComposite
-        {
-            private MultiplayerQueueList queueList;
-            private MultiplayerHistoryList historyList;
-            private bool firstPopulation = true;
-
-            [BackgroundDependencyLoader]
-            private void load()
-            {
-                InternalChild = new GridContainer
-                {
-                    RelativeSizeAxes = Axes.Both,
-                    Content = new[]
-                    {
-                        new Drawable[]
-                        {
-                            queueList = new MultiplayerQueueList
-                            {
-                                RelativeSizeAxes = Axes.Both
-                            },
-                            historyList = new MultiplayerHistoryList
-                            {
-                                RelativeSizeAxes = Axes.Both
-                            }
-                        }
-                    }
-                };
-            }
-
-            protected override void OnRoomUpdated()
-            {
-                base.OnRoomUpdated();
-
-                if (Room == null)
-                {
-                    historyList.Items.Clear();
-                    queueList.Items.Clear();
-                    firstPopulation = true;
-                    return;
-                }
-
-                if (firstPopulation)
-                {
-                    foreach (var item in Room.Playlist)
-                        PlaylistItemAdded(item);
-
-                    firstPopulation = false;
-                }
-            }
-
-            protected override void PlaylistItemAdded(MultiplayerPlaylistItem item)
-            {
-                base.PlaylistItemAdded(item);
-
-                var apiItem = Playlist.Single(i => i.ID == item.ID);
-
-                if (item.Expired)
-                    historyList.Items.Add(apiItem);
-                else
-                    queueList.Items.Add(apiItem);
-            }
-
-            protected override void PlaylistItemRemoved(long item)
-            {
-                base.PlaylistItemRemoved(item);
-
-                queueList.Items.RemoveAll(i => i.ID == item);
-                historyList.Items.RemoveAll(i => i.ID == item);
-            }
-
-            protected override void PlaylistItemChanged(MultiplayerPlaylistItem item)
-            {
-                base.PlaylistItemChanged(item);
-
-                PlaylistItemRemoved(item.ID);
-                PlaylistItemAdded(item);
-            }
-        }
     }
 }
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylist.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylist.cs
new file mode 100644
index 0000000000..f853333b08
--- /dev/null
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylist.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 osu.Framework.Allocation;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
+using osu.Game.Online.Rooms;
+
+namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist
+{
+    public class MultiplayerPlaylist : MultiplayerRoomComposite
+    {
+        private MultiplayerQueueList queueList;
+        private MultiplayerHistoryList historyList;
+        private bool firstPopulation = true;
+
+        [BackgroundDependencyLoader]
+        private void load()
+        {
+            InternalChild = new GridContainer
+            {
+                RelativeSizeAxes = Axes.Both,
+                Content = new[]
+                {
+                    new Drawable[]
+                    {
+                        queueList = new MultiplayerQueueList
+                        {
+                            RelativeSizeAxes = Axes.Both
+                        },
+                        historyList = new MultiplayerHistoryList
+                        {
+                            RelativeSizeAxes = Axes.Both
+                        }
+                    }
+                }
+            };
+        }
+
+        protected override void OnRoomUpdated()
+        {
+            base.OnRoomUpdated();
+
+            if (Room == null)
+            {
+                historyList.Items.Clear();
+                queueList.Items.Clear();
+                firstPopulation = true;
+                return;
+            }
+
+            if (firstPopulation)
+            {
+                foreach (var item in Room.Playlist)
+                    PlaylistItemAdded(item);
+
+                firstPopulation = false;
+            }
+        }
+
+        protected override void PlaylistItemAdded(MultiplayerPlaylistItem item)
+        {
+            base.PlaylistItemAdded(item);
+
+            var apiItem = Playlist.Single(i => i.ID == item.ID);
+
+            if (item.Expired)
+                historyList.Items.Add(apiItem);
+            else
+                queueList.Items.Add(apiItem);
+        }
+
+        protected override void PlaylistItemRemoved(long item)
+        {
+            base.PlaylistItemRemoved(item);
+
+            queueList.Items.RemoveAll(i => i.ID == item);
+            historyList.Items.RemoveAll(i => i.ID == item);
+        }
+
+        protected override void PlaylistItemChanged(MultiplayerPlaylistItem item)
+        {
+            base.PlaylistItemChanged(item);
+
+            PlaylistItemRemoved(item.ID);
+            PlaylistItemAdded(item);
+        }
+    }
+}

From 7847ce6253e5c3bc8ba43b838852273d65f8bc68 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 1 Dec 2021 19:44:29 +0900
Subject: [PATCH 1443/5547] Redesign with tab control

---
 .../Match/Playlist/MultiplayerPlaylist.cs     | 39 ++++++++++++++++---
 1 file changed, 33 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylist.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylist.cs
index f853333b08..a44e086814 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylist.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylist.cs
@@ -3,8 +3,11 @@
 
 using System.Linq;
 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.UserInterface;
 using osu.Game.Online.Rooms;
 
 namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist
@@ -18,24 +21,42 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist
         [BackgroundDependencyLoader]
         private void load()
         {
-            InternalChild = new GridContainer
+            TabControl<DisplayMode> displayModeTabControl;
+
+            InternalChildren = new Drawable[]
             {
-                RelativeSizeAxes = Axes.Both,
-                Content = new[]
+                displayModeTabControl = new OsuTabControl<DisplayMode>
                 {
-                    new Drawable[]
+                    RelativeSizeAxes = Axes.X,
+                    Height = 25
+                },
+                new Container
+                {
+                    RelativeSizeAxes = Axes.Both,
+                    Padding = new MarginPadding { Top = 27 },
+                    Masking = true,
+                    Children = new Drawable[]
                     {
                         queueList = new MultiplayerQueueList
                         {
-                            RelativeSizeAxes = Axes.Both
+                            RelativeSizeAxes = Axes.Both,
                         },
                         historyList = new MultiplayerHistoryList
                         {
-                            RelativeSizeAxes = Axes.Both
+                            RelativeSizeAxes = Axes.Both,
+                            Alpha = 0,
                         }
                     }
                 }
             };
+
+            displayModeTabControl.Current.BindValueChanged(onDisplayModeChanged, true);
+        }
+
+        private void onDisplayModeChanged(ValueChangedEvent<DisplayMode> mode)
+        {
+            historyList.FadeTo(mode.NewValue == DisplayMode.History ? 1 : 0, 100);
+            queueList.FadeTo(mode.NewValue == DisplayMode.Queue ? 1 : 0, 100);
         }
 
         protected override void OnRoomUpdated()
@@ -86,5 +107,11 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist
             PlaylistItemRemoved(item.ID);
             PlaylistItemAdded(item);
         }
+
+        private enum DisplayMode
+        {
+            Queue,
+            History,
+        }
     }
 }

From 1152c4e8e9bb91b6dc5209645cc9f2da69ac5eb0 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 1 Dec 2021 19:54:39 +0900
Subject: [PATCH 1444/5547] Fix tests

---
 .../TestSceneMultiplayerPlaylist.cs           | 57 +++++++++++--------
 .../Match/Playlist/MultiplayerPlaylist.cs     | 31 +++++-----
 .../MultiplayerPlaylistDisplayMode.cs         | 11 ++++
 3 files changed, 60 insertions(+), 39 deletions(-)
 create mode 100644 osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylistDisplayMode.cs

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs
index b21dbbd462..ae885685f7 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs
@@ -22,6 +22,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 {
     public class TestSceneMultiplayerPlaylist : MultiplayerTestScene
     {
+        private MultiplayerPlaylist list;
         private BeatmapManager beatmaps;
         private RulesetStore rulesets;
         private BeatmapSetInfo importedSet;
@@ -37,7 +38,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [SetUp]
         public new void Setup() => Schedule(() =>
         {
-            Child = new MultiplayerPlaylist
+            Child = list = new MultiplayerPlaylist
             {
                 Anchor = Anchor.Centre,
                 Origin = Anchor.Centre,
@@ -175,47 +176,57 @@ namespace osu.Game.Tests.Visual.Multiplayer
         /// </summary>
         /// <param name="playlistItemId">The item id.</param>
         /// <param name="visualIndex">The index at which the item should appear visually. The item with index 0 is at the top of the list.</param>
-        private void assertItemInQueueListStep(int playlistItemId, int visualIndex) => AddUntilStep($"{playlistItemId} in queue at pos = {visualIndex}", () =>
+        private void assertItemInQueueListStep(int playlistItemId, int visualIndex)
         {
-            return !inHistoryList(playlistItemId)
-                   && this.ChildrenOfType<MultiplayerQueueList>()
-                          .Single()
-                          .ChildrenOfType<DrawableRoomPlaylistItem>()
-                          .OrderBy(drawable => drawable.Position.Y)
-                          .TakeWhile(drawable => drawable.Item.ID != playlistItemId)
-                          .Count() == visualIndex;
-        });
+            changeDisplayModeStep(MultiplayerPlaylistDisplayMode.Queue);
+
+            AddUntilStep($"{playlistItemId} in queue at pos = {visualIndex}", () =>
+            {
+                return !inHistoryList(playlistItemId)
+                       && this.ChildrenOfType<MultiplayerQueueList>()
+                              .Single()
+                              .ChildrenOfType<DrawableRoomPlaylistItem>()
+                              .OrderBy(drawable => drawable.Position.Y)
+                              .TakeWhile(drawable => drawable.Item.ID != playlistItemId)
+                              .Count() == visualIndex;
+            });
+        }
 
         /// <summary>
         /// Asserts the position of a given playlist item in the history list.
         /// </summary>
         /// <param name="playlistItemId">The item id.</param>
         /// <param name="visualIndex">The index at which the item should appear visually. The item with index 0 is at the top of the list.</param>
-        private void assertItemInHistoryListStep(int playlistItemId, int visualIndex) => AddUntilStep($"{playlistItemId} in history at pos = {visualIndex}", () =>
+        private void assertItemInHistoryListStep(int playlistItemId, int visualIndex)
         {
-            return !inQueueList(playlistItemId)
-                   && this.ChildrenOfType<MultiplayerHistoryList>()
-                          .Single()
-                          .ChildrenOfType<DrawableRoomPlaylistItem>()
-                          .OrderBy(drawable => drawable.Position.Y)
-                          .TakeWhile(drawable => drawable.Item.ID != playlistItemId)
-                          .Count() == visualIndex;
-        });
+            changeDisplayModeStep(MultiplayerPlaylistDisplayMode.History);
+
+            AddUntilStep($"{playlistItemId} in history at pos = {visualIndex}", () =>
+            {
+                return !inQueueList(playlistItemId)
+                       && this.ChildrenOfType<MultiplayerHistoryList>()
+                              .Single()
+                              .ChildrenOfType<DrawableRoomPlaylistItem>()
+                              .OrderBy(drawable => drawable.Position.Y)
+                              .TakeWhile(drawable => drawable.Item.ID != playlistItemId)
+                              .Count() == visualIndex;
+            });
+        }
+
+        private void changeDisplayModeStep(MultiplayerPlaylistDisplayMode mode) => AddStep($"change list to {mode}", () => list.DisplayMode.Value = mode);
 
         private bool inQueueList(int playlistItemId)
         {
             return this.ChildrenOfType<MultiplayerQueueList>()
                        .Single()
-                       .ChildrenOfType<DrawableRoomPlaylistItem>()
-                       .Any(i => i.Item.ID == playlistItemId);
+                       .Items.Any(i => i.ID == playlistItemId);
         }
 
         private bool inHistoryList(int playlistItemId)
         {
             return this.ChildrenOfType<MultiplayerHistoryList>()
                        .Single()
-                       .ChildrenOfType<DrawableRoomPlaylistItem>()
-                       .Any(i => i.Item.ID == playlistItemId);
+                       .Items.Any(i => i.ID == playlistItemId);
         }
     }
 }
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylist.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylist.cs
index a44e086814..aebe70f95a 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylist.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylist.cs
@@ -6,7 +6,6 @@ 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.UserInterface;
 using osu.Game.Online.Rooms;
 
@@ -14,6 +13,8 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist
 {
     public class MultiplayerPlaylist : MultiplayerRoomComposite
     {
+        public readonly Bindable<MultiplayerPlaylistDisplayMode> DisplayMode = new Bindable<MultiplayerPlaylistDisplayMode>();
+
         private MultiplayerQueueList queueList;
         private MultiplayerHistoryList historyList;
         private bool firstPopulation = true;
@@ -21,14 +22,13 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist
         [BackgroundDependencyLoader]
         private void load()
         {
-            TabControl<DisplayMode> displayModeTabControl;
-
             InternalChildren = new Drawable[]
             {
-                displayModeTabControl = new OsuTabControl<DisplayMode>
+                new OsuTabControl<MultiplayerPlaylistDisplayMode>
                 {
                     RelativeSizeAxes = Axes.X,
-                    Height = 25
+                    Height = 25,
+                    Current = { BindTarget = DisplayMode }
                 },
                 new Container
                 {
@@ -49,14 +49,19 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist
                     }
                 }
             };
-
-            displayModeTabControl.Current.BindValueChanged(onDisplayModeChanged, true);
         }
 
-        private void onDisplayModeChanged(ValueChangedEvent<DisplayMode> mode)
+        protected override void LoadComplete()
         {
-            historyList.FadeTo(mode.NewValue == DisplayMode.History ? 1 : 0, 100);
-            queueList.FadeTo(mode.NewValue == DisplayMode.Queue ? 1 : 0, 100);
+            base.LoadComplete();
+
+            DisplayMode.BindValueChanged(onDisplayModeChanged, true);
+        }
+
+        private void onDisplayModeChanged(ValueChangedEvent<MultiplayerPlaylistDisplayMode> mode)
+        {
+            historyList.FadeTo(mode.NewValue == MultiplayerPlaylistDisplayMode.History ? 1 : 0, 100);
+            queueList.FadeTo(mode.NewValue == MultiplayerPlaylistDisplayMode.Queue ? 1 : 0, 100);
         }
 
         protected override void OnRoomUpdated()
@@ -107,11 +112,5 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist
             PlaylistItemRemoved(item.ID);
             PlaylistItemAdded(item);
         }
-
-        private enum DisplayMode
-        {
-            Queue,
-            History,
-        }
     }
 }
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylistDisplayMode.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylistDisplayMode.cs
new file mode 100644
index 0000000000..af1fac1c79
--- /dev/null
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylistDisplayMode.cs
@@ -0,0 +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.
+
+namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist
+{
+    public enum MultiplayerPlaylistDisplayMode
+    {
+        Queue,
+        History,
+    }
+}

From c3dfe10a8a637d472500dc67e9d4c1cd5b7bc17d Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 1 Dec 2021 19:54:48 +0900
Subject: [PATCH 1445/5547] Add new list to match subscreen

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

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
index 077e9cef93..16017a1f0e 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
@@ -26,6 +26,7 @@ using osu.Game.Screens.OnlinePlay.Components;
 using osu.Game.Screens.OnlinePlay.Match;
 using osu.Game.Screens.OnlinePlay.Match.Components;
 using osu.Game.Screens.OnlinePlay.Multiplayer.Match;
+using osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist;
 using osu.Game.Screens.OnlinePlay.Multiplayer.Participants;
 using osu.Game.Screens.OnlinePlay.Multiplayer.Spectate;
 using osu.Game.Screens.Play;
@@ -56,8 +57,6 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
         [CanBeNull]
         private IDisposable readyClickOperation;
 
-        private DrawableRoomPlaylist playlist;
-
         public MultiplayerMatchSubScreen(Room room)
             : base(room)
         {
@@ -74,9 +73,6 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
             BeatmapAvailability.BindValueChanged(updateBeatmapAvailability, true);
             UserMods.BindValueChanged(onUserModsChanged);
 
-            playlist.Items.BindTo(Room.Playlist);
-            playlist.SelectedItem.BindTo(SelectedItem);
-
             client.LoadRequested += onLoadRequested;
             client.RoomUpdated += onRoomUpdated;
 
@@ -153,10 +149,10 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
                                 null,
                                 new Drawable[]
                                 {
-                                    playlist = new DrawableRoomPlaylist(false, false, true, true)
+                                    new MultiplayerPlaylist
                                     {
-                                        RelativeSizeAxes = Axes.Both,
-                                    },
+                                        RelativeSizeAxes = Axes.Both
+                                    }
                                 },
                                 new[]
                                 {

From d70355237df75dd4b8e374fed92e4f3ab7b7bd7a Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 1 Dec 2021 19:55:53 +0900
Subject: [PATCH 1446/5547] Fix selected item not bound

---
 .../Multiplayer/Match/Playlist/MultiplayerPlaylist.cs           | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylist.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylist.cs
index aebe70f95a..8ab6531300 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylist.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylist.cs
@@ -40,11 +40,13 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist
                         queueList = new MultiplayerQueueList
                         {
                             RelativeSizeAxes = Axes.Both,
+                            SelectedItem = { BindTarget = SelectedItem }
                         },
                         historyList = new MultiplayerHistoryList
                         {
                             RelativeSizeAxes = Axes.Both,
                             Alpha = 0,
+                            SelectedItem = { BindTarget = SelectedItem }
                         }
                     }
                 }

From 93a7726f4a39410dfcc38cf14a0ebd9126acca75 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 1 Dec 2021 20:24:14 +0900
Subject: [PATCH 1447/5547] Remove now-unused parameter

---
 osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs             | 2 +-
 .../Multiplayer/Match/Playlist/MultiplayerHistoryList.cs        | 2 +-
 .../Multiplayer/Match/Playlist/MultiplayerQueueList.cs          | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs
index 3592a51b4a..14c5bd5240 100644
--- a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs
+++ b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs
@@ -20,7 +20,7 @@ namespace osu.Game.Screens.OnlinePlay
         private readonly bool allowSelection;
         private readonly bool showItemOwner;
 
-        public DrawableRoomPlaylist(bool allowEdit, bool allowSelection, bool reverse = false, bool showItemOwner = false)
+        public DrawableRoomPlaylist(bool allowEdit, bool allowSelection, bool showItemOwner = false)
         {
             this.allowEdit = allowEdit;
             this.allowSelection = allowSelection;
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerHistoryList.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerHistoryList.cs
index 76bb364f3a..63b2925c41 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerHistoryList.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerHistoryList.cs
@@ -13,7 +13,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist
     public class MultiplayerHistoryList : DrawableRoomPlaylist
     {
         public MultiplayerHistoryList()
-            : base(false, false, false, true)
+            : base(false, false, true)
         {
         }
 
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerQueueList.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerQueueList.cs
index 802603d7e1..7292e2edca 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerQueueList.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerQueueList.cs
@@ -18,7 +18,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist
         public readonly Bindable<QueueMode> QueueMode = new Bindable<QueueMode>();
 
         public MultiplayerQueueList()
-            : base(false, false, false, true)
+            : base(false, false, true)
         {
         }
 

From e2f289eeffa1d97378aa9800ba4641b31d61bd34 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 1 Dec 2021 20:27:47 +0900
Subject: [PATCH 1448/5547] Xmldocs

---
 .../Multiplayer/Match/Playlist/MultiplayerHistoryList.cs     | 3 +++
 .../Multiplayer/Match/Playlist/MultiplayerPlaylist.cs        | 5 ++++-
 .../Match/Playlist/MultiplayerPlaylistDisplayMode.cs         | 3 +++
 .../Multiplayer/Match/Playlist/MultiplayerQueueList.cs       | 3 +++
 4 files changed, 13 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerHistoryList.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerHistoryList.cs
index 63b2925c41..76088180c4 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerHistoryList.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerHistoryList.cs
@@ -10,6 +10,9 @@ using osuTK;
 
 namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist
 {
+    /// <summary>
+    /// A historically-ordered list of <see cref="DrawableRoomPlaylistItem"/>s.
+    /// </summary>
     public class MultiplayerHistoryList : DrawableRoomPlaylist
     {
         public MultiplayerHistoryList()
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylist.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylist.cs
index 8ab6531300..38199532e2 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylist.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylist.cs
@@ -7,10 +7,14 @@ using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Graphics.UserInterface;
+using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Rooms;
 
 namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist
 {
+    /// <summary>
+    /// The multiplayer playlist, containing lists to show the items from a <see cref="MultiplayerRoom"/> in both gameplay-order and historical-order.
+    /// </summary>
     public class MultiplayerPlaylist : MultiplayerRoomComposite
     {
         public readonly Bindable<MultiplayerPlaylistDisplayMode> DisplayMode = new Bindable<MultiplayerPlaylistDisplayMode>();
@@ -56,7 +60,6 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist
         protected override void LoadComplete()
         {
             base.LoadComplete();
-
             DisplayMode.BindValueChanged(onDisplayModeChanged, true);
         }
 
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylistDisplayMode.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylistDisplayMode.cs
index af1fac1c79..cc3dca6a34 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylistDisplayMode.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylistDisplayMode.cs
@@ -3,6 +3,9 @@
 
 namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist
 {
+    /// <summary>
+    /// The type of list displayed in a <see cref="MultiplayerPlaylist"/>.
+    /// </summary>
     public enum MultiplayerPlaylistDisplayMode
     {
         Queue,
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerQueueList.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerQueueList.cs
index 7292e2edca..c1bc60becc 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerQueueList.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerQueueList.cs
@@ -13,6 +13,9 @@ using osuTK;
 
 namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist
 {
+    /// <summary>
+    /// A gameplay-ordered list of <see cref="DrawableRoomPlaylistItem"/>s.
+    /// </summary>
     public class MultiplayerQueueList : DrawableRoomPlaylist
     {
         public readonly Bindable<QueueMode> QueueMode = new Bindable<QueueMode>();

From ad35f3434b210de9de114b88516cf192311fe3e3 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 1 Dec 2021 20:53:29 +0900
Subject: [PATCH 1449/5547] Fix queue list not considering expired items

---
 .../TestSceneMultiplayerQueueList.cs          |  8 ++--
 .../Match/Playlist/MultiplayerQueueList.cs    | 37 ++++++++++++-------
 2 files changed, 28 insertions(+), 17 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs
index 2e24d54b59..efb4a395f4 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs
@@ -15,13 +15,13 @@ using osu.Game.Tests.Beatmaps;
 
 namespace osu.Game.Tests.Visual.Multiplayer
 {
-    public class TestSceneMultiplayerQueueList : OsuTestScene
+    public class TestSceneMultiplayerQueueList : MultiplayerTestScene
     {
         private MultiplayerQueueList list;
         private int currentItemId;
 
         [SetUp]
-        public void Setup() => Schedule(() =>
+        public new void Setup() => Schedule(() =>
         {
             Child = list = new MultiplayerQueueList
             {
@@ -34,8 +34,10 @@ namespace osu.Game.Tests.Visual.Multiplayer
         });
 
         [SetUpSteps]
-        public void SetUpSteps()
+        public override void SetUpSteps()
         {
+            base.SetUpSteps();
+
             // Not inside a step since this is used to affect steps added by the current test.
             currentItemId = 0;
         }
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerQueueList.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerQueueList.cs
index c1bc60becc..9184cf6aba 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerQueueList.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerQueueList.cs
@@ -4,6 +4,7 @@
 using System;
 using System.Collections.Generic;
 using System.Linq;
+using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
@@ -35,6 +36,9 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist
         {
             public readonly IBindable<QueueMode> QueueMode = new Bindable<QueueMode>();
 
+            [Resolved(typeof(Room), nameof(Room.Playlist))]
+            private BindableList<PlaylistItem> roomPlaylist { get; set; }
+
             protected override void LoadComplete()
             {
                 base.LoadComplete();
@@ -53,20 +57,25 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist
                                                         .OrderBy(item => item.Model.ID);
 
                         case Game.Online.Multiplayer.QueueMode.AllPlayersRoundRobin:
-                            RearrangeableListItem<PlaylistItem>[] allItems = AliveInternalChildren
-                                                                             .Where(d => d.IsPresent)
-                                                                             .OfType<RearrangeableListItem<PlaylistItem>>()
-                                                                             .OrderBy(item => item.Model.ID)
-                                                                             .ToArray();
+                            RearrangeableListItem<PlaylistItem>[] items = AliveInternalChildren
+                                                                          .Where(d => d.IsPresent)
+                                                                          .OfType<RearrangeableListItem<PlaylistItem>>()
+                                                                          .OrderBy(item => item.Model.ID)
+                                                                          .ToArray();
 
-                            int totalCount = allItems.Length;
+                            int totalCount = items.Length;
                             if (totalCount == 0)
                                 return Enumerable.Empty<Drawable>();
 
-                            Dictionary<int, int> perUserCounts = allItems
-                                                                 .Select(item => item.Model.OwnerID)
-                                                                 .Distinct()
-                                                                 .ToDictionary(u => u, _ => 0);
+                            // Count of "expired" items per user.
+                            Dictionary<int, int> perUserCounts = roomPlaylist
+                                                                 .Where(item => item.Expired)
+                                                                 .GroupBy(item => item.OwnerID)
+                                                                 .ToDictionary(group => group.Key, group => group.Count());
+
+                            // Fill the count dictionary with zeroes for all users with no currently expired items.
+                            foreach (var item in items)
+                                perUserCounts.TryAdd(item.Model.OwnerID, 0);
 
                             List<Drawable> result = new List<Drawable>();
 
@@ -76,16 +85,16 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist
                             // Todo: This could probably be more efficient, likely at the cost of increased complexity.
                             while (totalCount-- > 0)
                             {
-                                var candidateItem = allItems
+                                var candidateItem = items
                                                     .Where(item => item != null)
                                                     .OrderBy(item => perUserCounts[item.Model.OwnerID])
                                                     .First();
 
-                                int itemIndex = Array.IndexOf(allItems, candidateItem);
+                                int itemIndex = Array.IndexOf(items, candidateItem);
 
-                                result.Add(allItems[itemIndex]);
+                                result.Add(items[itemIndex]);
                                 perUserCounts[candidateItem.Model.OwnerID]++;
-                                allItems[itemIndex] = null;
+                                items[itemIndex] = null;
                             }
 
                             return result;

From e87b0003fb01c89a70586dcf7ce16bda22b1f685 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 1 Dec 2021 20:54:10 +0900
Subject: [PATCH 1450/5547] Fix queue mode not being bound to in all cases

---
 .../Multiplayer/TestSceneMultiplayerQueueList.cs     |  2 +-
 .../Match/Playlist/MultiplayerQueueList.cs           | 12 +++++-------
 2 files changed, 6 insertions(+), 8 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs
index efb4a395f4..9e002a7f71 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs
@@ -181,6 +181,6 @@ namespace osu.Game.Tests.Visual.Multiplayer
             });
         }
 
-        private void changeQueueModeStep(QueueMode newMode) => AddStep($"change queue mode to {newMode}", () => list.QueueMode.Value = newMode);
+        private void changeQueueModeStep(QueueMode newMode) => AddStep($"change queue mode to {newMode}", () => SelectedRoom.Value.QueueMode.Value = newMode);
     }
 }
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerQueueList.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerQueueList.cs
index 9184cf6aba..614e7133fc 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerQueueList.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerQueueList.cs
@@ -19,8 +19,6 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist
     /// </summary>
     public class MultiplayerQueueList : DrawableRoomPlaylist
     {
-        public readonly Bindable<QueueMode> QueueMode = new Bindable<QueueMode>();
-
         public MultiplayerQueueList()
             : base(false, false, true)
         {
@@ -28,13 +26,13 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist
 
         protected override FillFlowContainer<RearrangeableListItem<PlaylistItem>> CreateListFillFlowContainer() => new QueueFillFlowContainer
         {
-            QueueMode = { BindTarget = QueueMode },
             Spacing = new Vector2(0, 2)
         };
 
         private class QueueFillFlowContainer : FillFlowContainer<RearrangeableListItem<PlaylistItem>>
         {
-            public readonly IBindable<QueueMode> QueueMode = new Bindable<QueueMode>();
+            [Resolved(typeof(Room), nameof(Room.QueueMode))]
+            private Bindable<QueueMode> queueMode { get; set; }
 
             [Resolved(typeof(Room), nameof(Room.Playlist))]
             private BindableList<PlaylistItem> roomPlaylist { get; set; }
@@ -42,21 +40,21 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist
             protected override void LoadComplete()
             {
                 base.LoadComplete();
-                QueueMode.BindValueChanged(_ => InvalidateLayout());
+                queueMode.BindValueChanged(_ => InvalidateLayout());
             }
 
             public override IEnumerable<Drawable> FlowingChildren
             {
                 get
                 {
-                    switch (QueueMode.Value)
+                    switch (queueMode.Value)
                     {
                         default:
                             return AliveInternalChildren.Where(d => d.IsPresent)
                                                         .OfType<RearrangeableListItem<PlaylistItem>>()
                                                         .OrderBy(item => item.Model.ID);
 
-                        case Game.Online.Multiplayer.QueueMode.AllPlayersRoundRobin:
+                        case QueueMode.AllPlayersRoundRobin:
                             RearrangeableListItem<PlaylistItem>[] items = AliveInternalChildren
                                                                           .Where(d => d.IsPresent)
                                                                           .OfType<RearrangeableListItem<PlaylistItem>>()

From f9b4e6f004f8d8e12dfb295e055ae6fb8c07983b Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 1 Dec 2021 21:00:00 +0900
Subject: [PATCH 1451/5547] Add test considering expired items

---
 .../TestSceneMultiplayerQueueList.cs          | 36 +++++++++++++++++--
 1 file changed, 33 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs
index 9e002a7f71..bd513ddf64 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs
@@ -146,21 +146,51 @@ namespace osu.Game.Tests.Visual.Multiplayer
             }
         }
 
+        [Test]
+        public void TestPreviouslyExpiredItemsConsideredInRoundRobinMode()
+        {
+            changeQueueModeStep(QueueMode.AllPlayersRoundRobin);
+
+            // User 1.
+
+            addItemStep(1, true);
+            addItemStep(1, true);
+            PlaylistItem item3 = addItemStep(1);
+            PlaylistItem item4 = addItemStep(1);
+
+            // User2.
+
+            PlaylistItem item5 = addItemStep(2);
+            PlaylistItem item6 = addItemStep(2);
+
+            assertPositionStep(item5, 0);
+            assertPositionStep(item6, 1);
+            assertPositionStep(item3, 2);
+            assertPositionStep(item4, 3);
+        }
+
         /// <summary>
         /// Adds a step to create a new playlist item.
         /// </summary>
         /// <param name="ownerId">The item owner.</param>
+        /// <param name="expired">Whether the item should be added in an expired state.</param>
         /// <returns>The playlist item's ID.</returns>
-        private PlaylistItem addItemStep(int ownerId)
+        private PlaylistItem addItemStep(int ownerId, bool expired = false)
         {
             var item = new PlaylistItem
             {
                 ID = ++currentItemId,
                 OwnerID = ownerId,
-                Beatmap = { Value = new TestBeatmap(new OsuRuleset().RulesetInfo, false).BeatmapInfo }
+                Beatmap = { Value = new TestBeatmap(new OsuRuleset().RulesetInfo, false).BeatmapInfo },
+                Expired = expired
             };
 
-            AddStep($"add {{ item: {item.ID}, user: {ownerId} }}", () => list.Items.Add(item));
+            AddStep($"add {{ item: {item.ID}, user: {ownerId} }}", () =>
+            {
+                SelectedRoom.Value.Playlist.Add(item);
+                if (!expired)
+                    list.Items.Add(item);
+            });
 
             return item;
         }

From e5e2ae8ab4f682addd7b8ad3cce7d7d61a39f422 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 1 Dec 2021 21:36:25 +0900
Subject: [PATCH 1452/5547] Fix dangling line post-rebase

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

diff --git a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs
index 14c5bd5240..f2d31c8e67 100644
--- a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs
+++ b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs
@@ -25,8 +25,6 @@ namespace osu.Game.Screens.OnlinePlay
             this.allowEdit = allowEdit;
             this.allowSelection = allowSelection;
             this.showItemOwner = showItemOwner;
-
-            ((ReversibleFillFlowContainer)ListContainer).Reverse = reverse;
         }
 
         protected override void LoadComplete()

From a0ff86f5e80055ac91cb63eb456899b6d7b4a139 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 1 Dec 2021 22:43:03 +0900
Subject: [PATCH 1453/5547] Ensure all read and write operations on `APIRoom`
 are done on the update thread

---
 .../Online/Multiplayer/MultiplayerClient.cs   | 32 ++++++++++---------
 .../OnlinePlay/DrawableRoomPlaylistItem.cs    | 10 ++++--
 2 files changed, 24 insertions(+), 18 deletions(-)

diff --git a/osu.Game/Online/Multiplayer/MultiplayerClient.cs b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
index 60a7dda961..82844af3c5 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
@@ -444,18 +444,28 @@ namespace osu.Game.Online.Multiplayer
             return Task.CompletedTask;
         }
 
-        async Task IMultiplayerClient.SettingsChanged(MultiplayerRoomSettings newSettings)
+        Task IMultiplayerClient.SettingsChanged(MultiplayerRoomSettings newSettings)
         {
             Debug.Assert(APIRoom != null);
             Debug.Assert(Room != null);
 
-            // ensure the new selected item is populated immediately.
-            var playlistItem = APIRoom.Playlist.SingleOrDefault(p => p.ID == newSettings.PlaylistItemId);
+            Scheduler.Add(() =>
+            {
+                // ensure the new selected item is populated immediately.
+                var playlistItem = APIRoom.Playlist.SingleOrDefault(p => p.ID == newSettings.PlaylistItemId);
 
-            if (playlistItem != null)
-                await PopulateBeatmap(playlistItem).ConfigureAwait(false);
+                if (playlistItem != null)
+                {
+                    GetAPIBeatmap(playlistItem.BeatmapID).ContinueWith(b =>
+                    {
+                        Scheduler.Add(() => playlistItem.Beatmap.Value = b.Result);
+                    }, TaskContinuationOptions.OnlyOnRanToCompletion);
+                }
 
-            Scheduler.Add(() => updateLocalRoomSettings(newSettings));
+                updateLocalRoomSettings(newSettings);
+            });
+
+            return Task.CompletedTask;
         }
 
         Task IMultiplayerClient.UserStateChanged(int userId, MultiplayerUserState state)
@@ -727,19 +737,11 @@ namespace osu.Game.Online.Multiplayer
             playlistItem.AllowedMods.AddRange(item.AllowedMods.Select(m => m.ToMod(rulesetInstance)));
 
             if (populateBeatmapImmediately)
-                await PopulateBeatmap(playlistItem).ConfigureAwait(false);
+                playlistItem.Beatmap.Value = await GetAPIBeatmap(item.BeatmapID).ConfigureAwait(false);
 
             return playlistItem;
         }
 
-        public async Task PopulateBeatmap(PlaylistItem item)
-        {
-            if (item.Beatmap.Value != null)
-                return;
-
-            item.Beatmap.Value = await GetAPIBeatmap(item.BeatmapID).ConfigureAwait(false);
-        }
-
         /// <summary>
         /// Retrieves a <see cref="APIBeatmap"/> from an online source.
         /// </summary>
diff --git a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
index e4b0d9647e..2e630262f3 100644
--- a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
+++ b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
@@ -69,6 +69,9 @@ namespace osu.Game.Screens.OnlinePlay
         [Resolved]
         private UserLookupCache userLookupCache { get; set; }
 
+        [Resolved]
+        private BeatmapLookupCache beatmapLookupCache { get; set; }
+
         [Resolved]
         private MultiplayerClient multiplayerClient { get; set; }
 
@@ -148,10 +151,11 @@ namespace osu.Game.Screens.OnlinePlay
                 {
                     try
                     {
-                        var user = await userLookupCache.GetUserAsync(Item.OwnerID).ConfigureAwait(false);
-                        Schedule(() => ownerAvatar.User = user);
+                        var foundUser = await userLookupCache.GetUserAsync(Item.OwnerID).ConfigureAwait(false);
+                        Schedule(() => ownerAvatar.User = foundUser);
 
-                        await multiplayerClient.PopulateBeatmap(Item).ConfigureAwait(false);
+                        var foundBeatmap = await beatmapLookupCache.GetBeatmapAsync(Item.BeatmapID).ConfigureAwait(false);
+                        Schedule(() => Item.Beatmap.Value = foundBeatmap);
                     }
                     catch (Exception e)
                     {

From d262baefada800347338f6422739baa1b50bc45a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 1 Dec 2021 22:43:32 +0900
Subject: [PATCH 1454/5547] Only query for the owner user metadata in the case
 it is actually required

---
 osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
index 2e630262f3..e2471d71d6 100644
--- a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
+++ b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
@@ -151,8 +151,11 @@ namespace osu.Game.Screens.OnlinePlay
                 {
                     try
                     {
-                        var foundUser = await userLookupCache.GetUserAsync(Item.OwnerID).ConfigureAwait(false);
-                        Schedule(() => ownerAvatar.User = foundUser);
+                        if (showItemOwner)
+                        {
+                            var foundUser = await userLookupCache.GetUserAsync(Item.OwnerID).ConfigureAwait(false);
+                            Schedule(() => ownerAvatar.User = foundUser);
+                        }
 
                         var foundBeatmap = await beatmapLookupCache.GetBeatmapAsync(Item.BeatmapID).ConfigureAwait(false);
                         Schedule(() => Item.Beatmap.Value = foundBeatmap);

From a8e17cb3a5bad201deb8d2df3a07412e613d7282 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 1 Dec 2021 22:46:32 +0900
Subject: [PATCH 1455/5547] Add relative size specs so partially on-screen
 panels still start loading

Without this, panels at the top of the list but not fully on-screen
wouldn't begin their metadata loading process.
---
 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 e2471d71d6..dae7b611f2 100644
--- a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
+++ b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
@@ -77,7 +77,7 @@ namespace osu.Game.Screens.OnlinePlay
 
         private PanelBackground panelBackground;
 
-        private readonly DelayedLoadWrapper onScreenLoader = new DelayedLoadWrapper(Empty);
+        private readonly DelayedLoadWrapper onScreenLoader = new DelayedLoadWrapper(Empty) { RelativeSizeAxes = Axes.Both };
 
         private readonly bool allowEdit;
         private readonly bool allowSelection;

From 8bef50cbbaf79a3918f242643f412822bcd313e1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 1 Dec 2021 19:35:15 +0100
Subject: [PATCH 1456/5547] Revert "Refactor migration precondition to read
 better"

Realm cannot translate `.All()` LINQ queries.

This reverts commit 0e0e8c25e8587e0fd121d1c4a0ad8cfe9055a08f.
---
 osu.Game/Database/EFToRealmMigrator.cs | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Database/EFToRealmMigrator.cs b/osu.Game/Database/EFToRealmMigrator.cs
index 8f436470af..3790dc8ae9 100644
--- a/osu.Game/Database/EFToRealmMigrator.cs
+++ b/osu.Game/Database/EFToRealmMigrator.cs
@@ -63,7 +63,8 @@ namespace osu.Game.Database
             using (var transaction = realm.BeginWrite())
             {
                 // only migrate data if the realm database is empty.
-                if (realm.All<SkinInfo>().All(s => s.Protected))
+                // note that this cannot be written as: `realm.All<SkinInfo>().All(s => s.Protected)`, because realm does not support `.All()`.
+                if (!realm.All<SkinInfo>().Any(s => !s.Protected))
                 {
                     foreach (var skin in existingSkins)
                     {

From 4f826589e51fc504db7f0ece73fa94e2e9da374c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 2 Dec 2021 12:20:07 +0900
Subject: [PATCH 1457/5547] Remove subscription logic for the time being

---
 .../LegacyDatabasedSkinResourceStore.cs       | 37 -------------------
 1 file changed, 37 deletions(-)

diff --git a/osu.Game/Skinning/LegacyDatabasedSkinResourceStore.cs b/osu.Game/Skinning/LegacyDatabasedSkinResourceStore.cs
index 667dc1876b..cd90fea9bb 100644
--- a/osu.Game/Skinning/LegacyDatabasedSkinResourceStore.cs
+++ b/osu.Game/Skinning/LegacyDatabasedSkinResourceStore.cs
@@ -1,14 +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.Diagnostics;
-using osu.Framework.Development;
 using osu.Framework.Extensions;
 using osu.Framework.IO.Stores;
 using osu.Game.Extensions;
-using Realms;
 
 namespace osu.Game.Skinning
 {
@@ -16,38 +12,12 @@ namespace osu.Game.Skinning
     {
         private readonly Dictionary<string, string> fileToStoragePathMapping = new Dictionary<string, string>();
 
-        private readonly IDisposable subscription;
-
         public LegacyDatabasedSkinResourceStore(SkinInfo source, IResourceStore<byte[]> underlyingStore)
             : base(underlyingStore)
         {
-            // Subscribing to non-managed instances doesn't work.
-            // In this usage, the skin may be non-managed in tests.
-            if (source.IsManaged)
-            {
-                // Subscriptions can only work on the main thread.
-                Debug.Assert(ThreadSafety.IsUpdateThread);
-
-                subscription = source.Files
-                                     .AsRealmCollection().SubscribeForNotifications((sender, changes, error) =>
-                                     {
-                                         if (changes == null)
-                                             return;
-
-                                         // If a large number of changes are made on skin files, this may be better suited to being cleared here
-                                         // and reinitialised on next usage.
-                                         initialiseFileCache(source);
-                                     });
-            }
-
             initialiseFileCache(source);
         }
 
-        ~LegacyDatabasedSkinResourceStore()
-        {
-            Dispose(false);
-        }
-
         private void initialiseFileCache(SkinInfo source)
         {
             fileToStoragePathMapping.Clear();
@@ -65,13 +35,6 @@ namespace osu.Game.Skinning
             }
         }
 
-        protected override void Dispose(bool disposing)
-        {
-            base.Dispose(disposing);
-
-            subscription?.Dispose();
-        }
-
         private string getPathForFile(string filename) =>
             fileToStoragePathMapping.TryGetValue(filename.ToLower(), out string path) ? path : null;
 

From c82195390fb19ed1e69121271ce4b91ea870f954 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 2 Dec 2021 13:24:16 +0900
Subject: [PATCH 1458/5547] Update usage of `SubscribeForNotifications`

---
 osu.Game/Overlays/Settings/Sections/SkinSection.cs | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/osu.Game/Overlays/Settings/Sections/SkinSection.cs b/osu.Game/Overlays/Settings/Sections/SkinSection.cs
index e3230098e2..c932f4837a 100644
--- a/osu.Game/Overlays/Settings/Sections/SkinSection.cs
+++ b/osu.Game/Overlays/Settings/Sections/SkinSection.cs
@@ -18,7 +18,6 @@ using osu.Game.Graphics.UserInterface;
 using osu.Game.Localisation;
 using osu.Game.Skinning;
 using osu.Game.Skinning.Editor;
-using Realms;
 
 namespace osu.Game.Overlays.Settings.Sections
 {
@@ -85,7 +84,7 @@ namespace osu.Game.Overlays.Settings.Sections
                                      .ThenBy(s => s.Name, StringComparer.OrdinalIgnoreCase);
 
             realmSubscription = realmSkins
-                .SubscribeForNotifications((sender, changes, error) =>
+                .QueryAsyncWithNotifications((sender, changes, error) =>
                 {
                     if (changes == null)
                         return;

From 0a14acfd83d636ab2f7a087b6c4efcd134e7ea46 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 2 Dec 2021 13:41:20 +0900
Subject: [PATCH 1459/5547] Fix incorrect conditional on export/mutate
 feasability of skin

---
 osu.Game/Overlays/Settings/Sections/SkinSection.cs | 2 +-
 osu.Game/Skinning/SkinManager.cs                   | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Overlays/Settings/Sections/SkinSection.cs b/osu.Game/Overlays/Settings/Sections/SkinSection.cs
index c932f4837a..bcf0a367ef 100644
--- a/osu.Game/Overlays/Settings/Sections/SkinSection.cs
+++ b/osu.Game/Overlays/Settings/Sections/SkinSection.cs
@@ -179,7 +179,7 @@ namespace osu.Game.Overlays.Settings.Sections
                 base.LoadComplete();
 
                 currentSkin = skins.CurrentSkin.GetBoundCopy();
-                currentSkin.BindValueChanged(skin => Enabled.Value = skin.NewValue.SkinInfo.PerformRead(s => s.IsManaged), true);
+                currentSkin.BindValueChanged(skin => Enabled.Value = skin.NewValue.SkinInfo.PerformRead(s => !s.Protected), true);
             }
 
             private void export()
diff --git a/osu.Game/Skinning/SkinManager.cs b/osu.Game/Skinning/SkinManager.cs
index d6c884d259..701bf6d0cf 100644
--- a/osu.Game/Skinning/SkinManager.cs
+++ b/osu.Game/Skinning/SkinManager.cs
@@ -144,7 +144,7 @@ namespace osu.Game.Skinning
         {
             CurrentSkinInfo.Value.PerformRead(s =>
             {
-                if (s.IsManaged)
+                if (!s.Protected)
                     return;
 
                 // if the user is attempting to save one of the default skin implementations, create a copy first.

From e855a49833fb0a08694233757641e8828f5d3955 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 2 Dec 2021 14:01:18 +0900
Subject: [PATCH 1460/5547] Add test coverage of default skin edit and export

---
 .../Navigation/TestSceneEditDefaultSkin.cs    | 40 +++++++++++++++++++
 .../Overlays/Settings/Sections/SkinSection.cs |  2 +-
 2 files changed, 41 insertions(+), 1 deletion(-)
 create mode 100644 osu.Game.Tests/Visual/Navigation/TestSceneEditDefaultSkin.cs

diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneEditDefaultSkin.cs b/osu.Game.Tests/Visual/Navigation/TestSceneEditDefaultSkin.cs
new file mode 100644
index 0000000000..f5b9d287ca
--- /dev/null
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneEditDefaultSkin.cs
@@ -0,0 +1,40 @@
+// 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 NUnit.Framework;
+using osu.Framework.Allocation;
+using osu.Framework.Testing;
+using osu.Game.Overlays.Settings.Sections;
+using osu.Game.Skinning;
+using osu.Game.Skinning.Editor;
+
+namespace osu.Game.Tests.Visual.Navigation
+{
+    public class TestSceneEditDefaultSkin : OsuGameTestScene
+    {
+        private SkinManager skinManager => Game.Dependencies.Get<SkinManager>();
+        private SkinEditorOverlay skinEditor => Game.Dependencies.Get<SkinEditorOverlay>();
+
+        [Test]
+        public void TestEditDefaultSkin()
+        {
+            AddAssert("is default skin", () => skinManager.CurrentSkinInfo.Value.ID == SkinInfo.DEFAULT_SKIN);
+
+            AddStep("open settings", () => { Game.Settings.Show(); });
+
+            // Until step requires as settings has a delayed load.
+            AddUntilStep("export button disabled", () => Game.Settings.ChildrenOfType<SkinSection.ExportSkinButton>().SingleOrDefault()?.Enabled.Value == false);
+
+            // Will create a mutable skin.
+            AddStep("open skin editor", () => skinEditor.Show());
+
+            // Until step required as the skin editor may take time to load (and an extra scheduled frame for the mutable part).
+            AddUntilStep("is modified default skin", () => skinManager.CurrentSkinInfo.Value.ID != SkinInfo.DEFAULT_SKIN);
+            AddAssert("is not protected", () => skinManager.CurrentSkinInfo.Value.PerformRead(s => !s.Protected));
+
+            AddUntilStep("export button enabled", () => Game.Settings.ChildrenOfType<SkinSection.ExportSkinButton>().SingleOrDefault()?.Enabled.Value == true);
+        }
+    }
+}
diff --git a/osu.Game/Overlays/Settings/Sections/SkinSection.cs b/osu.Game/Overlays/Settings/Sections/SkinSection.cs
index bcf0a367ef..b1582d7bee 100644
--- a/osu.Game/Overlays/Settings/Sections/SkinSection.cs
+++ b/osu.Game/Overlays/Settings/Sections/SkinSection.cs
@@ -157,7 +157,7 @@ namespace osu.Game.Overlays.Settings.Sections
             }
         }
 
-        private class ExportSkinButton : SettingsButton
+        public class ExportSkinButton : SettingsButton
         {
             [Resolved]
             private SkinManager skins { get; set; }

From ec700e91427549ff29a36ba9300a8e1aa94d2410 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 2 Dec 2021 14:01:57 +0900
Subject: [PATCH 1461/5547] Remove unused using statement

---
 osu.Game.Tests/Visual/Navigation/TestSceneEditDefaultSkin.cs | 1 -
 1 file changed, 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneEditDefaultSkin.cs b/osu.Game.Tests/Visual/Navigation/TestSceneEditDefaultSkin.cs
index f5b9d287ca..06306ad197 100644
--- a/osu.Game.Tests/Visual/Navigation/TestSceneEditDefaultSkin.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneEditDefaultSkin.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.IO;
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;

From 624ec4580a1b5347224b073323cb6a39adb6ea5f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 2 Dec 2021 14:31:59 +0900
Subject: [PATCH 1462/5547] Ensure `updateLocalRoomSettings` is only called
 after full population

---
 osu.Game/Online/Multiplayer/MultiplayerClient.cs | 14 ++++++++++----
 1 file changed, 10 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Online/Multiplayer/MultiplayerClient.cs b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
index 82844af3c5..c2b9727309 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
@@ -458,11 +458,17 @@ namespace osu.Game.Online.Multiplayer
                 {
                     GetAPIBeatmap(playlistItem.BeatmapID).ContinueWith(b =>
                     {
-                        Scheduler.Add(() => playlistItem.Beatmap.Value = b.Result);
-                    }, TaskContinuationOptions.OnlyOnRanToCompletion);
-                }
+                        bool success = b.IsCompletedSuccessfully;
 
-                updateLocalRoomSettings(newSettings);
+                        Scheduler.Add(() =>
+                        {
+                            if (success)
+                                playlistItem.Beatmap.Value = b.Result;
+
+                            updateLocalRoomSettings(newSettings);
+                        });
+                    });
+                }
             });
 
             return Task.CompletedTask;

From bdddaba3521f524a150d41505efcbf8ee6fb0020 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 2 Dec 2021 14:31:08 +0900
Subject: [PATCH 1463/5547] Remove unnecessary test request handling

---
 .../Visual/OnlinePlay/TestRoomRequestsHandler.cs      | 11 -----------
 1 file changed, 11 deletions(-)

diff --git a/osu.Game/Tests/Visual/OnlinePlay/TestRoomRequestsHandler.cs b/osu.Game/Tests/Visual/OnlinePlay/TestRoomRequestsHandler.cs
index abcf31c007..af2202b05a 100644
--- a/osu.Game/Tests/Visual/OnlinePlay/TestRoomRequestsHandler.cs
+++ b/osu.Game/Tests/Visual/OnlinePlay/TestRoomRequestsHandler.cs
@@ -4,9 +4,7 @@
 using System;
 using System.Collections.Generic;
 using System.Linq;
-using osu.Framework.Allocation;
 using osu.Game.Online.API;
-using osu.Game.Online.API.Requests;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Rooms;
 using osu.Game.Rulesets.Scoring;
@@ -89,15 +87,6 @@ namespace osu.Game.Tests.Visual.OnlinePlay
                     getRoomRequest.TriggerSuccess(createResponseRoom(ServerSideRooms.Single(r => r.RoomID.Value == getRoomRequest.RoomId), true));
                     return true;
 
-                case GetBeatmapSetRequest getBeatmapSetRequest:
-                    var onlineReq = new GetBeatmapSetRequest(getBeatmapSetRequest.ID, getBeatmapSetRequest.Type);
-                    onlineReq.Success += res => getBeatmapSetRequest.TriggerSuccess(res);
-                    onlineReq.Failure += e => getBeatmapSetRequest.TriggerFailure(e);
-
-                    // Get the online API from the game's dependencies.
-                    game.Dependencies.Get<IAPIProvider>().Queue(onlineReq);
-                    return true;
-
                 case CreateRoomScoreRequest createRoomScoreRequest:
                     createRoomScoreRequest.TriggerSuccess(new APIScoreToken { ID = 1 });
                     return true;

From 0adfb75cf36decb00fec3ac4189d38513b366408 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 2 Dec 2021 14:53:06 +0900
Subject: [PATCH 1464/5547] Combine similarly named `StatefulMultiplayerClient`
 tests

---
 .../StatefulMultiplayerClientTest.cs          | 21 +++++++++++
 .../StatefulMultiplayerClientTest.cs          | 35 -------------------
 2 files changed, 21 insertions(+), 35 deletions(-)
 delete mode 100644 osu.Game.Tests/OnlinePlay/StatefulMultiplayerClientTest.cs

diff --git a/osu.Game.Tests/NonVisual/Multiplayer/StatefulMultiplayerClientTest.cs b/osu.Game.Tests/NonVisual/Multiplayer/StatefulMultiplayerClientTest.cs
index 840ff20a83..42305ccd81 100644
--- a/osu.Game.Tests/NonVisual/Multiplayer/StatefulMultiplayerClientTest.cs
+++ b/osu.Game.Tests/NonVisual/Multiplayer/StatefulMultiplayerClientTest.cs
@@ -16,6 +16,27 @@ namespace osu.Game.Tests.NonVisual.Multiplayer
     [HeadlessTest]
     public class StatefulMultiplayerClientTest : MultiplayerTestScene
     {
+        [Test]
+        public void TestUserAddedOnJoin()
+        {
+            var user = new APIUser { Id = 33 };
+
+            AddRepeatStep("add user multiple times", () => Client.AddUser(user), 3);
+            AddAssert("room has 2 users", () => Client.Room?.Users.Count == 2);
+        }
+
+        [Test]
+        public void TestUserRemovedOnLeave()
+        {
+            var user = new APIUser { Id = 44 };
+
+            AddStep("add user", () => Client.AddUser(user));
+            AddAssert("room has 2 users", () => Client.Room?.Users.Count == 2);
+
+            AddRepeatStep("remove user multiple times", () => Client.RemoveUser(user), 3);
+            AddAssert("room has 1 user", () => Client.Room?.Users.Count == 1);
+        }
+
         [Test]
         public void TestPlayingUserTracking()
         {
diff --git a/osu.Game.Tests/OnlinePlay/StatefulMultiplayerClientTest.cs b/osu.Game.Tests/OnlinePlay/StatefulMultiplayerClientTest.cs
deleted file mode 100644
index 5a621ecf84..0000000000
--- a/osu.Game.Tests/OnlinePlay/StatefulMultiplayerClientTest.cs
+++ /dev/null
@@ -1,35 +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.Testing;
-using osu.Game.Online.API.Requests.Responses;
-using osu.Game.Tests.Visual.Multiplayer;
-
-namespace osu.Game.Tests.OnlinePlay
-{
-    [HeadlessTest]
-    public class StatefulMultiplayerClientTest : MultiplayerTestScene
-    {
-        [Test]
-        public void TestUserAddedOnJoin()
-        {
-            var user = new APIUser { Id = 33 };
-
-            AddRepeatStep("add user multiple times", () => Client.AddUser(user), 3);
-            AddAssert("room has 2 users", () => Client.Room?.Users.Count == 2);
-        }
-
-        [Test]
-        public void TestUserRemovedOnLeave()
-        {
-            var user = new APIUser { Id = 44 };
-
-            AddStep("add user", () => Client.AddUser(user));
-            AddAssert("room has 2 users", () => Client.Room?.Users.Count == 2);
-
-            AddRepeatStep("remove user multiple times", () => Client.RemoveUser(user), 3);
-            AddAssert("room has 1 user", () => Client.Room?.Users.Count == 1);
-        }
-    }
-}

From 5976982b12c158282a67b97844965dc98a989d39 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 2 Dec 2021 16:45:26 +0900
Subject: [PATCH 1465/5547] Add missing xmldoc for `MultiplayerClient` events

---
 .../Online/Multiplayer/MultiplayerClient.cs   | 22 +++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/osu.Game/Online/Multiplayer/MultiplayerClient.cs b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
index 784d365520..8ac2de9902 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
@@ -32,12 +32,34 @@ namespace osu.Game.Online.Multiplayer
         /// </summary>
         public event Action? RoomUpdated;
 
+        /// <summary>
+        /// Invoked when a new user joins the room.
+        /// </summary>
         public event Action<MultiplayerRoomUser>? UserJoined;
+
+        /// <summary>
+        /// Invoked when a user leaves the room of their own accord.
+        /// </summary>
         public event Action<MultiplayerRoomUser>? UserLeft;
+
+        /// <summary>
+        /// Invoked when a user was kicked from the room forcefully.
+        /// </summary>
         public event Action<MultiplayerRoomUser>? UserKicked;
 
+        /// <summary>
+        /// Invoked when a new item is added to the playlist.
+        /// </summary>
         public event Action<MultiplayerPlaylistItem>? ItemAdded;
+
+        /// <summary>
+        /// Invoked when a playlist item is removed from the playlist. The provided <c>long</c> is the playlist's item ID.
+        /// </summary>
         public event Action<long>? ItemRemoved;
+
+        /// <summary>
+        /// Invoked when a playlist item's details change.
+        /// </summary>
         public event Action<MultiplayerPlaylistItem>? ItemChanged;
 
         /// <summary>

From 512818648f0f0fd2efe4df15e9231b20d15c96d4 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 2 Dec 2021 16:56:30 +0900
Subject: [PATCH 1466/5547] Add some more breathing room between tab control
 and queue content

---
 .../Multiplayer/Match/Playlist/MultiplayerPlaylist.cs       | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylist.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylist.cs
index 38199532e2..2c50c88de8 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylist.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylist.cs
@@ -26,18 +26,20 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist
         [BackgroundDependencyLoader]
         private void load()
         {
+            const float tab_control_height = 25;
+
             InternalChildren = new Drawable[]
             {
                 new OsuTabControl<MultiplayerPlaylistDisplayMode>
                 {
                     RelativeSizeAxes = Axes.X,
-                    Height = 25,
+                    Height = tab_control_height,
                     Current = { BindTarget = DisplayMode }
                 },
                 new Container
                 {
                     RelativeSizeAxes = Axes.Both,
-                    Padding = new MarginPadding { Top = 27 },
+                    Padding = new MarginPadding { Top = tab_control_height + 5 },
                     Masking = true,
                     Children = new Drawable[]
                     {

From ae3038ead4afb1329f765eca71dbdfa3dcfc78d0 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 2 Dec 2021 17:17:12 +0900
Subject: [PATCH 1467/5547] Overwrite existing files if `AddFile` is called
 with an existing filename

---
 osu.Game/Database/IModelFileManager.cs      |  2 +-
 osu.Game/Stores/RealmArchiveModelManager.cs | 10 +++++++++-
 2 files changed, 10 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Database/IModelFileManager.cs b/osu.Game/Database/IModelFileManager.cs
index 4bc1e2d29b..390be4a69d 100644
--- a/osu.Game/Database/IModelFileManager.cs
+++ b/osu.Game/Database/IModelFileManager.cs
@@ -25,7 +25,7 @@ namespace osu.Game.Database
         void DeleteFile(TModel model, TFileModel file);
 
         /// <summary>
-        /// Add a new file.
+        /// Add a new file. If the file already exists, it is overwritten.
         /// </summary>
         /// <param name="model">The item to operate on.</param>
         /// <param name="contents">The new file contents.</param>
diff --git a/osu.Game/Stores/RealmArchiveModelManager.cs b/osu.Game/Stores/RealmArchiveModelManager.cs
index a916e2b53a..4efcdd096c 100644
--- a/osu.Game/Stores/RealmArchiveModelManager.cs
+++ b/osu.Game/Stores/RealmArchiveModelManager.cs
@@ -74,10 +74,18 @@ namespace osu.Game.Stores
         }
 
         /// <summary>
-        /// Add a file from within an ongoing realm transaction.
+        /// Add a file from within an ongoing realm transaction. If the file already exists, it is overwritten.
         /// </summary>
         protected void AddFile(TModel item, Stream stream, string filename, Realm realm)
         {
+            var existing = item.Files.FirstOrDefault(f => string.Equals(f.Filename, filename, StringComparison.OrdinalIgnoreCase));
+
+            if (existing != null)
+            {
+                ReplaceFile(item, existing, stream, realm);
+                return;
+            }
+
             var file = realmFileStore.Add(stream, realm);
             var namedUsage = new RealmNamedFileUsage(file, filename);
 

From fe99d4e984c7fad82bfb12e54ebcbd03d1835f55 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 2 Dec 2021 17:19:53 +0900
Subject: [PATCH 1468/5547] Standardise parameter naming across all file IO
 methods

---
 osu.Game/Skinning/SkinModelManager.cs       |  4 ++--
 osu.Game/Stores/RealmArchiveModelManager.cs | 14 +++++++-------
 2 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/osu.Game/Skinning/SkinModelManager.cs b/osu.Game/Skinning/SkinModelManager.cs
index 059345f9bc..40c280c5c2 100644
--- a/osu.Game/Skinning/SkinModelManager.cs
+++ b/osu.Game/Skinning/SkinModelManager.cs
@@ -128,7 +128,7 @@ namespace osu.Game.Skinning
                             sw.WriteLine(line);
                     }
 
-                    ReplaceFile(item, existingFile, stream, realm);
+                    ReplaceFile(existingFile, stream, realm);
 
                     // can be removed 20220502.
                     if (!ensureIniWasUpdated(item))
@@ -214,7 +214,7 @@ namespace osu.Game.Skinning
                         var oldFile = s.Files.FirstOrDefault(f => f.Filename == filename);
 
                         if (oldFile != null)
-                            ReplaceFile(s, oldFile, streamContent, s.Realm);
+                            ReplaceFile(oldFile, streamContent, s.Realm);
                         else
                             AddFile(s, streamContent, filename, s.Realm);
                     }
diff --git a/osu.Game/Stores/RealmArchiveModelManager.cs b/osu.Game/Stores/RealmArchiveModelManager.cs
index 4efcdd096c..87a27cbbbc 100644
--- a/osu.Game/Stores/RealmArchiveModelManager.cs
+++ b/osu.Game/Stores/RealmArchiveModelManager.cs
@@ -52,10 +52,10 @@ namespace osu.Game.Stores
             item.Realm.Write(() => DeleteFile(item, file, item.Realm));
 
         public void ReplaceFile(TModel item, RealmNamedFileUsage file, Stream contents)
-            => item.Realm.Write(() => ReplaceFile(item, file, contents, item.Realm));
+            => item.Realm.Write(() => ReplaceFile(file, contents, item.Realm));
 
-        public void AddFile(TModel item, Stream stream, string filename)
-            => item.Realm.Write(() => AddFile(item, stream, filename, item.Realm));
+        public void AddFile(TModel item, Stream contents, string filename)
+            => item.Realm.Write(() => AddFile(item, contents, filename, item.Realm));
 
         /// <summary>
         /// Delete a file from within an ongoing realm transaction.
@@ -68,7 +68,7 @@ namespace osu.Game.Stores
         /// <summary>
         /// Replace a file from within an ongoing realm transaction.
         /// </summary>
-        protected void ReplaceFile(TModel model, RealmNamedFileUsage file, Stream contents, Realm realm)
+        protected void ReplaceFile(RealmNamedFileUsage file, Stream contents, Realm realm)
         {
             file.File = realmFileStore.Add(contents, realm);
         }
@@ -76,17 +76,17 @@ namespace osu.Game.Stores
         /// <summary>
         /// Add a file from within an ongoing realm transaction. If the file already exists, it is overwritten.
         /// </summary>
-        protected void AddFile(TModel item, Stream stream, string filename, Realm realm)
+        protected void AddFile(TModel item, Stream contents, string filename, Realm realm)
         {
             var existing = item.Files.FirstOrDefault(f => string.Equals(f.Filename, filename, StringComparison.OrdinalIgnoreCase));
 
             if (existing != null)
             {
-                ReplaceFile(item, existing, stream, realm);
+                ReplaceFile(existing, contents, realm);
                 return;
             }
 
-            var file = realmFileStore.Add(stream, realm);
+            var file = realmFileStore.Add(contents, realm);
             var namedUsage = new RealmNamedFileUsage(file, filename);
 
             item.Files.Add(namedUsage);

From 0e82e9355bd0072979459e11454fcfdd2f926c88 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 2 Dec 2021 17:42:16 +0900
Subject: [PATCH 1469/5547] Ensure skin is saved immediately after becoming
 mutable

Without doing this, the JSON content is not written to the file. A user
assumption is that as soon as a skin shows up in the skin list as
exportable, it should export correctly, so it makes sense that it should
be in a sane state even if the user has not made any changes in the skin
editor yet.

Going forward, we might move more of the json serialisation logic out,
and run for consistency as part of the import process. This seems like
the simplest way to guarantee things for now, though.
---
 osu.Game/Skinning/SkinManager.cs | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/osu.Game/Skinning/SkinManager.cs b/osu.Game/Skinning/SkinManager.cs
index 701bf6d0cf..5134632fb1 100644
--- a/osu.Game/Skinning/SkinManager.cs
+++ b/osu.Game/Skinning/SkinManager.cs
@@ -156,7 +156,13 @@ namespace osu.Game.Skinning
                 }).Result;
 
                 if (result != null)
+                {
+                    // save once to ensure the required json content is populated.
+                    // currently this only happens on save.
+                    result.PerformRead(skin => Save(skin.CreateInstance(this)));
+
                     CurrentSkinInfo.Value = result;
+                }
             });
         }
 

From b9768487742c254866f4460adc808cc580cd6a16 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 2 Dec 2021 18:00:04 +0900
Subject: [PATCH 1470/5547] Add failing test coverage of exporting default skin
 importing with incorrect type

---
 osu.Game.Tests/Skins/IO/ImportSkinTest.cs | 68 +++++++++++++++++++++++
 1 file changed, 68 insertions(+)

diff --git a/osu.Game.Tests/Skins/IO/ImportSkinTest.cs b/osu.Game.Tests/Skins/IO/ImportSkinTest.cs
index f3c2cd8ba2..f2ce002650 100644
--- a/osu.Game.Tests/Skins/IO/ImportSkinTest.cs
+++ b/osu.Game.Tests/Skins/IO/ImportSkinTest.cs
@@ -164,6 +164,74 @@ namespace osu.Game.Tests.Skins.IO
             assertCorrectMetadata(import2, "name 1 [my custom skin 2]", "author 1", osu);
         });
 
+        [Test]
+        public Task TestExportThenImportDefaultSkin() => runSkinTest(osu =>
+        {
+            var skinManager = osu.Dependencies.Get<SkinManager>();
+
+            skinManager.EnsureMutableSkin();
+
+            MemoryStream exportStream = new MemoryStream();
+
+            Guid originalSkinId = skinManager.CurrentSkinInfo.Value.ID;
+
+            skinManager.CurrentSkinInfo.Value.PerformRead(s =>
+            {
+                Assert.IsFalse(s.Protected);
+                Assert.AreEqual(typeof(DefaultSkin), s.CreateInstance(skinManager).GetType());
+
+                new LegacySkinExporter(osu.Dependencies.Get<Storage>()).ExportModelTo(s, exportStream);
+
+                Assert.Greater(exportStream.Length, 0);
+            });
+
+            var imported = skinManager.Import(new ImportTask(exportStream, "exported.osk"));
+
+            imported.Result.PerformRead(s =>
+            {
+                Assert.IsFalse(s.Protected);
+                Assert.AreNotEqual(originalSkinId, s.ID);
+                Assert.AreEqual(typeof(DefaultSkin), s.CreateInstance(skinManager).GetType());
+            });
+
+            return Task.CompletedTask;
+        });
+
+        [Test]
+        public Task TestExportThenImportClassicSkin() => runSkinTest(osu =>
+        {
+            var skinManager = osu.Dependencies.Get<SkinManager>();
+
+            skinManager.CurrentSkinInfo.Value = skinManager.DefaultLegacySkin.SkinInfo;
+
+            skinManager.EnsureMutableSkin();
+
+            MemoryStream exportStream = new MemoryStream();
+
+            Guid originalSkinId = skinManager.CurrentSkinInfo.Value.ID;
+
+            skinManager.CurrentSkinInfo.Value.PerformRead(s =>
+            {
+                Assert.IsFalse(s.Protected);
+                Assert.AreEqual(typeof(DefaultLegacySkin), s.CreateInstance(skinManager).GetType());
+
+                new LegacySkinExporter(osu.Dependencies.Get<Storage>()).ExportModelTo(s, exportStream);
+
+                Assert.Greater(exportStream.Length, 0);
+            });
+
+            var imported = skinManager.Import(new ImportTask(exportStream, "exported.osk"));
+
+            imported.Result.PerformRead(s =>
+            {
+                Assert.IsFalse(s.Protected);
+                Assert.AreNotEqual(originalSkinId, s.ID);
+                Assert.AreEqual(typeof(DefaultLegacySkin), s.CreateInstance(skinManager).GetType());
+            });
+
+            return Task.CompletedTask;
+        });
+
         #endregion
 
         private void assertCorrectMetadata(ILive<SkinInfo> import1, string name, string creator, OsuGameBase osu)

From cdf2fa99304759414ff11db461508ce32c3f616f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 2 Dec 2021 17:43:54 +0900
Subject: [PATCH 1471/5547] Serialise and deserialise
 `SkinInfo.InstantiationInfo` to allow for more correct imports

Until now, skins were always imported using the `LegacySkin`
instantiation type. For cases where a user has edited the lazer or
classic default (via the new skin editor), which would result in
incorrect fallback paths after exporting and importing the edited skin.
---
 osu.Game/Skinning/SkinModelManager.cs | 43 +++++++++++++++++++++++++--
 1 file changed, 41 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Skinning/SkinModelManager.cs b/osu.Game/Skinning/SkinModelManager.cs
index 40c280c5c2..822cb8efa0 100644
--- a/osu.Game/Skinning/SkinModelManager.cs
+++ b/osu.Game/Skinning/SkinModelManager.cs
@@ -24,6 +24,8 @@ namespace osu.Game.Skinning
 {
     public class SkinModelManager : RealmArchiveModelManager<SkinInfo>
     {
+        private const string skin_info_file = "skininfo.json";
+
         private readonly IStorageResourceProvider skinResources;
 
         public SkinModelManager(Storage storage, RealmContextFactory contextFactory, GameHost host, IStorageResourceProvider skinResources)
@@ -49,8 +51,36 @@ namespace osu.Game.Skinning
 
         protected override Task Populate(SkinInfo model, ArchiveReader? archive, Realm realm, CancellationToken cancellationToken = default)
         {
-            if (string.IsNullOrEmpty(model.InstantiationInfo))
-                model.InstantiationInfo = createInstance(model).GetType().GetInvariantInstantiationInfo();
+            var skinInfoFile = model.Files.SingleOrDefault(f => f.Filename == skin_info_file);
+
+            if (skinInfoFile != null)
+            {
+                try
+                {
+                    using (var existingStream = Files.Storage.GetStream(skinInfoFile.File.GetStoragePath()))
+                    using (var reader = new StreamReader(existingStream))
+                    {
+                        var deserialisedSkinInfo = JsonConvert.DeserializeObject<SkinInfo>(reader.ReadToEnd());
+
+                        if (deserialisedSkinInfo != null)
+                        {
+                            // for now we only care about the instantiation info.
+                            // eventually we probably want to transfer everything across.
+                            model.InstantiationInfo = deserialisedSkinInfo.InstantiationInfo;
+                        }
+                    }
+                }
+                catch (Exception e)
+                {
+                    LogForModel(model, $"Error during {skin_info_file} parsing, falling back to default", e);
+
+                    // Not sure if we should still run the import in the case of failure here, but let's do so for now.
+                    model.InstantiationInfo = string.Empty;
+                }
+            }
+
+            // Always rewrite instantiation info (even after parsing in from the skin json) for sanity.
+            model.InstantiationInfo = createInstance(model).GetType().GetInvariantInstantiationInfo();
 
             checkSkinIniMetadata(model, realm);
 
@@ -203,6 +233,15 @@ namespace osu.Game.Skinning
         {
             skin.SkinInfo.PerformWrite(s =>
             {
+                // Serialise out the SkinInfo itself.
+                string skinInfoJson = JsonConvert.SerializeObject(s, new JsonSerializerSettings { Formatting = Formatting.Indented });
+
+                using (var streamContent = new MemoryStream(Encoding.UTF8.GetBytes(skinInfoJson)))
+                {
+                    AddFile(s, streamContent, skin_info_file, s.Realm);
+                }
+
+                // Then serialise each of the drawable component groups into respective files.
                 foreach (var drawableInfo in skin.DrawableComponentInfo)
                 {
                     string json = JsonConvert.SerializeObject(drawableInfo.Value, new JsonSerializerSettings { Formatting = Formatting.Indented });

From ba8af303ccc0e2e9053f22034be7baa4b86dbdc7 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 2 Dec 2021 19:15:27 +0900
Subject: [PATCH 1472/5547] Add GameplayOrder to MultiplayerPlaylistItem

---
 osu.Game/Online/Multiplayer/MultiplayerClient.cs |  3 ++-
 osu.Game/Online/Rooms/MultiplayerPlaylistItem.cs | 10 ++++++++++
 osu.Game/Online/Rooms/PlaylistItem.cs            |  3 +++
 3 files changed, 15 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Online/Multiplayer/MultiplayerClient.cs b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
index 8ac2de9902..0ffb81d986 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
@@ -741,7 +741,8 @@ namespace osu.Game.Online.Multiplayer
                 OwnerID = item.OwnerID,
                 Beatmap = { Value = apiBeatmap },
                 Ruleset = { Value = ruleset },
-                Expired = item.Expired
+                Expired = item.Expired,
+                GameplayOrder = item.GameplayOrder
             };
 
             playlistItem.RequiredMods.AddRange(item.RequiredMods.Select(m => m.ToMod(rulesetInstance)));
diff --git a/osu.Game/Online/Rooms/MultiplayerPlaylistItem.cs b/osu.Game/Online/Rooms/MultiplayerPlaylistItem.cs
index 6ca0b822f3..5094ee510f 100644
--- a/osu.Game/Online/Rooms/MultiplayerPlaylistItem.cs
+++ b/osu.Game/Online/Rooms/MultiplayerPlaylistItem.cs
@@ -39,6 +39,15 @@ namespace osu.Game.Online.Rooms
         [Key(7)]
         public bool Expired { get; set; }
 
+        /// <summary>
+        /// The order in which this <see cref="MultiplayerPlaylistItem"/> will be played, starting from 0 and increasing for items which will be played later.
+        /// </summary>
+        /// <remarks>
+        /// Undefined value for items which are expired.
+        /// </remarks>
+        [Key(8)]
+        public int GameplayOrder { get; set; }
+
         public MultiplayerPlaylistItem()
         {
         }
@@ -52,6 +61,7 @@ namespace osu.Game.Online.Rooms
             RequiredMods = item.RequiredMods.Select(m => new APIMod(m)).ToArray();
             AllowedMods = item.AllowedMods.Select(m => new APIMod(m)).ToArray();
             Expired = item.Expired;
+            GameplayOrder = item.GameplayOrder;
         }
     }
 }
diff --git a/osu.Game/Online/Rooms/PlaylistItem.cs b/osu.Game/Online/Rooms/PlaylistItem.cs
index a1480865b8..4c7f9e139a 100644
--- a/osu.Game/Online/Rooms/PlaylistItem.cs
+++ b/osu.Game/Online/Rooms/PlaylistItem.cs
@@ -33,6 +33,9 @@ namespace osu.Game.Online.Rooms
         [JsonProperty("expired")]
         public bool Expired { get; set; }
 
+        [JsonProperty("gameplay_order")]
+        public int GameplayOrder { get; set; }
+
         [JsonIgnore]
         public IBindable<bool> Valid => valid;
 

From 9760a2b08723f326e349bad1d799d7e99f596a23 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 2 Dec 2021 21:13:20 +0900
Subject: [PATCH 1473/5547] Update MultiplayerQueueList to take advantage of
 GameplayOrder

---
 .../Match/Playlist/MultiplayerQueueList.cs    | 64 +------------------
 1 file changed, 2 insertions(+), 62 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerQueueList.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerQueueList.cs
index 614e7133fc..58f35b940a 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerQueueList.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerQueueList.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 System;
 using System.Collections.Generic;
 using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
-using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Rooms;
 using osuTK;
 
@@ -31,74 +29,16 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist
 
         private class QueueFillFlowContainer : FillFlowContainer<RearrangeableListItem<PlaylistItem>>
         {
-            [Resolved(typeof(Room), nameof(Room.QueueMode))]
-            private Bindable<QueueMode> queueMode { get; set; }
-
             [Resolved(typeof(Room), nameof(Room.Playlist))]
             private BindableList<PlaylistItem> roomPlaylist { get; set; }
 
             protected override void LoadComplete()
             {
                 base.LoadComplete();
-                queueMode.BindValueChanged(_ => InvalidateLayout());
+                roomPlaylist.BindCollectionChanged((_, __) => InvalidateLayout());
             }
 
-            public override IEnumerable<Drawable> FlowingChildren
-            {
-                get
-                {
-                    switch (queueMode.Value)
-                    {
-                        default:
-                            return AliveInternalChildren.Where(d => d.IsPresent)
-                                                        .OfType<RearrangeableListItem<PlaylistItem>>()
-                                                        .OrderBy(item => item.Model.ID);
-
-                        case QueueMode.AllPlayersRoundRobin:
-                            RearrangeableListItem<PlaylistItem>[] items = AliveInternalChildren
-                                                                          .Where(d => d.IsPresent)
-                                                                          .OfType<RearrangeableListItem<PlaylistItem>>()
-                                                                          .OrderBy(item => item.Model.ID)
-                                                                          .ToArray();
-
-                            int totalCount = items.Length;
-                            if (totalCount == 0)
-                                return Enumerable.Empty<Drawable>();
-
-                            // Count of "expired" items per user.
-                            Dictionary<int, int> perUserCounts = roomPlaylist
-                                                                 .Where(item => item.Expired)
-                                                                 .GroupBy(item => item.OwnerID)
-                                                                 .ToDictionary(group => group.Key, group => group.Count());
-
-                            // Fill the count dictionary with zeroes for all users with no currently expired items.
-                            foreach (var item in items)
-                                perUserCounts.TryAdd(item.Model.OwnerID, 0);
-
-                            List<Drawable> result = new List<Drawable>();
-
-                            // Run a simulation...
-                            // In every iteration, pick the first available item from the user with the lowest number of items in the queue to add to the result set.
-                            // If multiple users have the same number of items in the queue, then the item with the lowest ID is chosen.
-                            // Todo: This could probably be more efficient, likely at the cost of increased complexity.
-                            while (totalCount-- > 0)
-                            {
-                                var candidateItem = items
-                                                    .Where(item => item != null)
-                                                    .OrderBy(item => perUserCounts[item.Model.OwnerID])
-                                                    .First();
-
-                                int itemIndex = Array.IndexOf(items, candidateItem);
-
-                                result.Add(items[itemIndex]);
-                                perUserCounts[candidateItem.Model.OwnerID]++;
-                                items[itemIndex] = null;
-                            }
-
-                            return result;
-                    }
-                }
-            }
+            public override IEnumerable<Drawable> FlowingChildren => base.FlowingChildren.OfType<RearrangeableListItem<PlaylistItem>>().OrderBy(item => item.Model.GameplayOrder);
         }
     }
 }

From 933fd49cff4fb0c9d66535cfab6aa7166d7f097e Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 2 Dec 2021 22:11:28 +0900
Subject: [PATCH 1474/5547] Fix missed callbacks due to AddOnce() schedules

---
 .../OnlinePlay/Multiplayer/MultiplayerRoomComposite.cs      | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerRoomComposite.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerRoomComposite.cs
index f2cac708e4..2f75f09a9f 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerRoomComposite.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerRoomComposite.cs
@@ -35,9 +35,9 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
         private void invokeUserJoined(MultiplayerRoomUser user) => Scheduler.AddOnce(UserJoined, user);
         private void invokeUserKicked(MultiplayerRoomUser user) => Scheduler.AddOnce(UserKicked, user);
         private void invokeUserLeft(MultiplayerRoomUser user) => Scheduler.AddOnce(UserLeft, user);
-        private void invokeItemAdded(MultiplayerPlaylistItem item) => Scheduler.AddOnce(PlaylistItemAdded, item);
-        private void invokeItemRemoved(long item) => Scheduler.AddOnce(PlaylistItemRemoved, item);
-        private void invokeItemChanged(MultiplayerPlaylistItem item) => Scheduler.AddOnce(PlaylistItemChanged, item);
+        private void invokeItemAdded(MultiplayerPlaylistItem item) => Schedule(() => PlaylistItemAdded(item));
+        private void invokeItemRemoved(long item) => Schedule(() => PlaylistItemRemoved(item));
+        private void invokeItemChanged(MultiplayerPlaylistItem item) => Schedule(() => PlaylistItemChanged(item));
 
         /// <summary>
         /// Invoked when a user has joined the room.

From 806ca5d4de4f9dac36c1e3a00ff9cc1a0331c13e Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 2 Dec 2021 22:32:41 +0900
Subject: [PATCH 1475/5547] Update TestMultiplayerClient implementation to
 match server

---
 .../Multiplayer/TestMultiplayerClient.cs      | 102 +++++++++++++-----
 1 file changed, 77 insertions(+), 25 deletions(-)

diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
index 82a8212a94..2831c94429 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
@@ -45,7 +45,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         /// <summary>
         /// Guaranteed up-to-date playlist.
         /// </summary>
-        private readonly List<MultiplayerPlaylistItem> serverSidePlaylist = new List<MultiplayerPlaylistItem>();
+        private List<MultiplayerPlaylistItem> serverSidePlaylist = new List<MultiplayerPlaylistItem>();
 
         private MultiplayerPlaylistItem? currentItem => Room?.Playlist[currentIndex];
         private int currentIndex;
@@ -189,6 +189,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 Host = localUser
             };
 
+            await updatePlaylistOrder(room).ConfigureAwait(false);
             await updateCurrentItem(room, false).ConfigureAwait(false);
 
             RoomSetupAction?.Invoke(room);
@@ -308,12 +309,14 @@ namespace osu.Game.Tests.Visual.Multiplayer
             if (Room.Settings.QueueMode == QueueMode.HostOnly && Room.Host?.UserID != LocalUser?.UserID)
                 throw new InvalidOperationException("Local user is not the room host.");
 
+            item.OwnerID = userId;
+
             switch (Room.Settings.QueueMode)
             {
                 case QueueMode.HostOnly:
                     // In host-only mode, the current item is re-used.
                     item.ID = currentItem.ID;
-                    item.OwnerID = currentItem.OwnerID;
+                    item.GameplayOrder = currentItem.GameplayOrder;
 
                     serverSidePlaylist[currentIndex] = item;
                     await ((IMultiplayerClient)this).PlaylistItemChanged(item).ConfigureAwait(false);
@@ -323,12 +326,9 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     break;
 
                 default:
-                    item.ID = serverSidePlaylist.Last().ID + 1;
-                    item.OwnerID = userId;
-
-                    serverSidePlaylist.Add(item);
-                    await ((IMultiplayerClient)this).PlaylistItemAdded(item).ConfigureAwait(false);
+                    await addItem(item).ConfigureAwait(false);
 
+                    // The current item can change as a result of an item being added. For example, if all items earlier in the queue were expired.
                     await updateCurrentItem(Room).ConfigureAwait(false);
                     break;
             }
@@ -385,7 +385,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             if (newMode == QueueMode.HostOnly && serverSidePlaylist.All(item => item.Expired))
                 await duplicateCurrentItem().ConfigureAwait(false);
 
-            // When changing modes, items could have been added (above) or the queueing order could have changed.
+            await updatePlaylistOrder(Room).ConfigureAwait(false);
             await updateCurrentItem(Room).ConfigureAwait(false);
         }
 
@@ -408,47 +408,99 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
         private async Task duplicateCurrentItem()
         {
-            Debug.Assert(Room != null);
-            Debug.Assert(APIRoom != null);
             Debug.Assert(currentItem != null);
 
-            var newItem = new MultiplayerPlaylistItem
+            await addItem(new MultiplayerPlaylistItem
             {
-                ID = serverSidePlaylist.Last().ID + 1,
                 BeatmapID = currentItem.BeatmapID,
                 BeatmapChecksum = currentItem.BeatmapChecksum,
                 RulesetID = currentItem.RulesetID,
                 RequiredMods = currentItem.RequiredMods,
                 AllowedMods = currentItem.AllowedMods
-            };
+            }).ConfigureAwait(false);
+        }
 
-            serverSidePlaylist.Add(newItem);
-            await ((IMultiplayerClient)this).PlaylistItemAdded(newItem).ConfigureAwait(false);
+        private async Task addItem(MultiplayerPlaylistItem item)
+        {
+            Debug.Assert(Room != null);
+
+            // Add the item to the list first in order to compute gameplay order.
+            serverSidePlaylist.Add(item);
+            await updatePlaylistOrder(Room).ConfigureAwait(false);
+
+            item.ID = serverSidePlaylist[^2].ID + 1;
+            await ((IMultiplayerClient)this).PlaylistItemAdded(item).ConfigureAwait(false);
         }
 
         private async Task updateCurrentItem(MultiplayerRoom room, bool notify = true)
         {
-            MultiplayerPlaylistItem newItem;
+            // The playlist is already in correct gameplay order, so pick the next non-expired item or default to the last item.
+            MultiplayerPlaylistItem nextItem = serverSidePlaylist.FirstOrDefault(i => !i.Expired) ?? room.Playlist.Last();
+            currentIndex = serverSidePlaylist.IndexOf(nextItem);
+
+            long lastItem = room.Settings.PlaylistItemId;
+            room.Settings.PlaylistItemId = nextItem.ID;
+
+            if (notify && nextItem.ID != lastItem)
+                await ((IMultiplayerClient)this).SettingsChanged(room.Settings).ConfigureAwait(false);
+        }
+
+        private async Task updatePlaylistOrder(MultiplayerRoom room)
+        {
+            List<MultiplayerPlaylistItem> orderedItems;
 
             switch (room.Settings.QueueMode)
             {
                 default:
-                    // Pick the single non-expired playlist item.
-                    newItem = serverSidePlaylist.FirstOrDefault(i => !i.Expired) ?? serverSidePlaylist.Last();
+                    orderedItems = serverSidePlaylist.OrderBy(item => item.ID == 0 ? int.MaxValue : item.ID).ToList();
                     break;
 
                 case QueueMode.AllPlayersRoundRobin:
-                    // Group playlist items by (user_id -> count_expired), and select the first available playlist item from a user that has available beatmaps where count_expired is the lowest.
-                    throw new NotImplementedException();
+                    // Todo: This could probably be more efficient, likely at the cost of increased complexity.
+                    // Number of "expired" or "used" items per player.
+                    Dictionary<int, int> perUserCounts = serverSidePlaylist
+                                                         .GroupBy(item => item.OwnerID)
+                                                         .ToDictionary(group => group.Key, group => group.Count(item => item.Expired));
+
+                    // We'll run a simulation over all items which are not expired ("unprocessed"). Expired items will not have their ordering updated.
+                    List<MultiplayerPlaylistItem> processedItems = serverSidePlaylist.Where(item => item.Expired).ToList();
+                    List<MultiplayerPlaylistItem> unprocessedItems = serverSidePlaylist.Where(item => !item.Expired).ToList();
+
+                    // In every iteration of the simulation, pick the first available item from the user with the lowest number of items in the queue to add to the result set.
+                    // If multiple users have the same number of items in the queue, then the item with the lowest ID is chosen.
+                    while (unprocessedItems.Count > 0)
+                    {
+                        MultiplayerPlaylistItem candidateItem = unprocessedItems
+                                                                .OrderBy(item => perUserCounts[item.OwnerID])
+                                                                .ThenBy(item => item.ID == 0 ? int.MaxValue : item.ID)
+                                                                .First();
+
+                        unprocessedItems.Remove(candidateItem);
+                        processedItems.Add(candidateItem);
+
+                        perUserCounts[candidateItem.OwnerID]++;
+                    }
+
+                    orderedItems = processedItems;
+                    break;
             }
 
-            currentIndex = serverSidePlaylist.IndexOf(newItem);
+            for (int i = 0; i < orderedItems.Count; i++)
+            {
+                // Items which are already ordered correct don't need to be updated.
+                if (orderedItems[i].GameplayOrder == i)
+                    continue;
 
-            long lastItem = room.Settings.PlaylistItemId;
-            room.Settings.PlaylistItemId = newItem.ID;
+                orderedItems[i].GameplayOrder = i;
 
-            if (notify && newItem.ID != lastItem)
-                await ((IMultiplayerClient)this).SettingsChanged(room.Settings).ConfigureAwait(false);
+                // Items which have an ID of 0 are not in the database, so avoid propagating database/hub events for them.
+                if (orderedItems[i].ID <= 0)
+                    continue;
+
+                await ((IMultiplayerClient)this).PlaylistItemChanged(orderedItems[i]).ConfigureAwait(false);
+            }
+
+            serverSidePlaylist = orderedItems;
         }
     }
 }

From 10932dd2824024418a24794c502f98f813cd4b3b Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 2 Dec 2021 22:37:09 +0900
Subject: [PATCH 1476/5547] Remove now unnecessary test

---
 .../TestSceneMultiplayerQueueList.cs          | 216 ------------------
 1 file changed, 216 deletions(-)
 delete mode 100644 osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs
deleted file mode 100644
index bd513ddf64..0000000000
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs
+++ /dev/null
@@ -1,216 +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.Collections.Generic;
-using System.Linq;
-using NUnit.Framework;
-using osu.Framework.Graphics;
-using osu.Framework.Testing;
-using osu.Game.Online.Multiplayer;
-using osu.Game.Online.Rooms;
-using osu.Game.Rulesets.Osu;
-using osu.Game.Screens.OnlinePlay;
-using osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist;
-using osu.Game.Tests.Beatmaps;
-
-namespace osu.Game.Tests.Visual.Multiplayer
-{
-    public class TestSceneMultiplayerQueueList : MultiplayerTestScene
-    {
-        private MultiplayerQueueList list;
-        private int currentItemId;
-
-        [SetUp]
-        public new void Setup() => Schedule(() =>
-        {
-            Child = list = new MultiplayerQueueList
-            {
-                Anchor = Anchor.Centre,
-                Origin = Anchor.Centre,
-                RelativeSizeAxes = Axes.Both,
-                Width = 0.4f,
-                Height = 0.6f
-            };
-        });
-
-        [SetUpSteps]
-        public override void SetUpSteps()
-        {
-            base.SetUpSteps();
-
-            // Not inside a step since this is used to affect steps added by the current test.
-            currentItemId = 0;
-        }
-
-        [Test]
-        public void TestItemsAddedToEndInHostOnlyMode()
-        {
-            changeQueueModeStep(QueueMode.HostOnly);
-
-            // User 1.
-
-            PlaylistItem item1 = addItemStep(1);
-            assertPositionStep(item1, 0);
-
-            PlaylistItem item2 = addItemStep(1);
-            assertPositionStep(item2, 1);
-
-            // User 2.
-
-            PlaylistItem item3 = addItemStep(2);
-            assertPositionStep(item3, 2);
-        }
-
-        [Test]
-        public void TestItemsAddedToEndInAllPlayersMode()
-        {
-            changeQueueModeStep(QueueMode.AllPlayers);
-
-            // User 1.
-
-            PlaylistItem item1 = addItemStep(1);
-            assertPositionStep(item1, 0);
-
-            PlaylistItem item2 = addItemStep(1);
-            assertPositionStep(item2, 1);
-
-            // User 2.
-
-            PlaylistItem item3 = addItemStep(2);
-            assertPositionStep(item3, 2);
-        }
-
-        [Test]
-        public void TestItemsInsertedInCorrectPositionInRoundRobinMode()
-        {
-            changeQueueModeStep(QueueMode.AllPlayersRoundRobin);
-
-            // User 1.
-
-            PlaylistItem item1 = addItemStep(1);
-            assertPositionStep(item1, 0);
-
-            PlaylistItem item2 = addItemStep(1);
-            assertPositionStep(item2, 1);
-
-            // User 2.
-
-            PlaylistItem item3 = addItemStep(2);
-            assertPositionStep(item3, 1);
-            assertPositionStep(item2, 2);
-
-            PlaylistItem item4 = addItemStep(2);
-            assertPositionStep(item4, 3);
-
-            PlaylistItem item5 = addItemStep(2);
-            assertPositionStep(item5, 4);
-
-            // User 1.
-
-            // This item is added to the end rather than injected between item4 and item5, since both users have an equal number
-            // of added items at this point and this user was the last of the two to add an item.
-            PlaylistItem item6 = addItemStep(1);
-            assertPositionStep(item6, 5);
-
-            // User 3.
-
-            PlaylistItem item7 = addItemStep(3);
-            assertPositionStep(item7, 2);
-
-            PlaylistItem item8 = addItemStep(3);
-            assertPositionStep(item8, 5);
-
-            PlaylistItem item9 = addItemStep(3);
-            assertPositionStep(item9, 8);
-        }
-
-        [Test]
-        public void TestItemsReorderedWhenQueueModeChanged()
-        {
-            changeQueueModeStep(QueueMode.AllPlayers);
-
-            var items = new List<PlaylistItem>();
-
-            for (int i = 0; i < 8; i++)
-                items.Add(addItemStep(i <= 3 ? 1 : 2));
-
-            for (int i = 0; i < 8; i++)
-                assertPositionStep(items[i], i);
-
-            changeQueueModeStep(QueueMode.AllPlayersRoundRobin);
-
-            for (int i = 0; i < 4; i++)
-            {
-                assertPositionStep(items[i], i * 2); // Items by user 1.
-                assertPositionStep(items[i + 4], i * 2 + 1); // Items by user 2.
-            }
-        }
-
-        [Test]
-        public void TestPreviouslyExpiredItemsConsideredInRoundRobinMode()
-        {
-            changeQueueModeStep(QueueMode.AllPlayersRoundRobin);
-
-            // User 1.
-
-            addItemStep(1, true);
-            addItemStep(1, true);
-            PlaylistItem item3 = addItemStep(1);
-            PlaylistItem item4 = addItemStep(1);
-
-            // User2.
-
-            PlaylistItem item5 = addItemStep(2);
-            PlaylistItem item6 = addItemStep(2);
-
-            assertPositionStep(item5, 0);
-            assertPositionStep(item6, 1);
-            assertPositionStep(item3, 2);
-            assertPositionStep(item4, 3);
-        }
-
-        /// <summary>
-        /// Adds a step to create a new playlist item.
-        /// </summary>
-        /// <param name="ownerId">The item owner.</param>
-        /// <param name="expired">Whether the item should be added in an expired state.</param>
-        /// <returns>The playlist item's ID.</returns>
-        private PlaylistItem addItemStep(int ownerId, bool expired = false)
-        {
-            var item = new PlaylistItem
-            {
-                ID = ++currentItemId,
-                OwnerID = ownerId,
-                Beatmap = { Value = new TestBeatmap(new OsuRuleset().RulesetInfo, false).BeatmapInfo },
-                Expired = expired
-            };
-
-            AddStep($"add {{ item: {item.ID}, user: {ownerId} }}", () =>
-            {
-                SelectedRoom.Value.Playlist.Add(item);
-                if (!expired)
-                    list.Items.Add(item);
-            });
-
-            return item;
-        }
-
-        /// <summary>
-        /// Asserts the position of a given playlist item in the visual layout of the list.
-        /// </summary>
-        /// <param name="item">The playlist item.</param>
-        /// <param name="visualIndex">The index at which the item should appear visually. The item with index 0 is at the top of the list.</param>
-        private void assertPositionStep(PlaylistItem item, int visualIndex)
-        {
-            AddUntilStep($"item {item.ID} has pos = {visualIndex}", () =>
-            {
-                return this.ChildrenOfType<DrawableRoomPlaylistItem>()
-                           .OrderBy(drawable => drawable.Position.Y)
-                           .TakeWhile(drawable => drawable.Item.ID != item.ID)
-                           .Count() == visualIndex;
-            });
-        }
-
-        private void changeQueueModeStep(QueueMode newMode) => AddStep($"change queue mode to {newMode}", () => SelectedRoom.Value.QueueMode.Value = newMode);
-    }
-}

From abf7735b8403efb9e76e80b7d30ba49f4de8367d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 3 Dec 2021 14:18:03 +0900
Subject: [PATCH 1477/5547] Update framework

---
 osu.Android.props        | 2 +-
 osu.Game/osu.Game.csproj | 2 +-
 osu.iOS.props            | 4 ++--
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Android.props b/osu.Android.props
index eff0eed278..cd2710c3ba 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -52,7 +52,7 @@
   </ItemGroup>
   <ItemGroup>
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1112.0" />
-    <PackageReference Include="ppy.osu.Framework.Android" Version="2021.1127.0" />
+    <PackageReference Include="ppy.osu.Framework.Android" Version="2021.1203.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
     <!-- Realm needs to be directly referenced in all Xamarin projects, as it will not pull in its transitive dependencies otherwise. -->
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 7cc8893d8d..a4a4661822 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="10.7.1" />
-    <PackageReference Include="ppy.osu.Framework" Version="2021.1127.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2021.1203.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1112.0" />
     <PackageReference Include="Sentry" Version="3.11.1" />
     <PackageReference Include="SharpCompress" Version="0.30.0" />
diff --git a/osu.iOS.props b/osu.iOS.props
index 9c21f76617..c095d3ef74 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -60,7 +60,7 @@
     <Reference Include="System.Net.Http" />
   </ItemGroup>
   <ItemGroup Label="Package References">
-    <PackageReference Include="ppy.osu.Framework.iOS" Version="2021.1127.0" />
+    <PackageReference Include="ppy.osu.Framework.iOS" Version="2021.1203.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1112.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net5.0 / net6.0) -->
@@ -83,7 +83,7 @@
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="2.2.6" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.Core" Version="2.2.6" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
-    <PackageReference Include="ppy.osu.Framework" Version="2021.1127.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2021.1203.0" />
     <PackageReference Include="SharpCompress" Version="0.30.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
     <PackageReference Include="SharpRaven" Version="2.4.0" />

From 614256697442c2c543d0120d1271be1264dfb858 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 3 Dec 2021 14:26:53 +0900
Subject: [PATCH 1478/5547] Update resources

---
 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 cd2710c3ba..17b5cb67e9 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -51,7 +51,7 @@
     <Reference Include="Java.Interop" />
   </ItemGroup>
   <ItemGroup>
-    <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1112.0" />
+    <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1203.0" />
     <PackageReference Include="ppy.osu.Framework.Android" Version="2021.1203.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index a4a4661822..53a3337c9d 100644
--- a/osu.Game/osu.Game.csproj
+++ b/osu.Game/osu.Game.csproj
@@ -37,7 +37,7 @@
     </PackageReference>
     <PackageReference Include="Realm" Version="10.7.1" />
     <PackageReference Include="ppy.osu.Framework" Version="2021.1203.0" />
-    <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1112.0" />
+    <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1203.0" />
     <PackageReference Include="Sentry" Version="3.11.1" />
     <PackageReference Include="SharpCompress" Version="0.30.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
diff --git a/osu.iOS.props b/osu.iOS.props
index c095d3ef74..f3dc163a67 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -61,7 +61,7 @@
   </ItemGroup>
   <ItemGroup Label="Package References">
     <PackageReference Include="ppy.osu.Framework.iOS" Version="2021.1203.0" />
-    <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1112.0" />
+    <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1203.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net5.0 / net6.0) -->
   <PropertyGroup>

From 9803e63e6f0c9a2a14f6427c9faafb629c5ef2ac Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 3 Dec 2021 14:30:15 +0900
Subject: [PATCH 1479/5547] Update IPC usage to return `null`

---
 osu.Game/IPC/ArchiveImportIPCChannel.cs | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/osu.Game/IPC/ArchiveImportIPCChannel.cs b/osu.Game/IPC/ArchiveImportIPCChannel.cs
index d9d0e4c0ea..3ef1dc051d 100644
--- a/osu.Game/IPC/ArchiveImportIPCChannel.cs
+++ b/osu.Game/IPC/ArchiveImportIPCChannel.cs
@@ -25,6 +25,8 @@ namespace osu.Game.IPC
                 {
                     if (t.Exception != null) throw t.Exception;
                 }, TaskContinuationOptions.OnlyOnFaulted);
+
+                return null;
             };
         }
 

From 1d2d1bfcf3497c35a5e06b2eb3d322518d56ece2 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 3 Dec 2021 14:38:14 +0900
Subject: [PATCH 1480/5547] Add UpdatedAt to MultiplayerPlaylistItem

---
 osu.Game/Online/Rooms/MultiplayerPlaylistItem.cs | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Online/Rooms/MultiplayerPlaylistItem.cs b/osu.Game/Online/Rooms/MultiplayerPlaylistItem.cs
index 5094ee510f..ec98de2b43 100644
--- a/osu.Game/Online/Rooms/MultiplayerPlaylistItem.cs
+++ b/osu.Game/Online/Rooms/MultiplayerPlaylistItem.cs
@@ -42,12 +42,16 @@ namespace osu.Game.Online.Rooms
         /// <summary>
         /// The order in which this <see cref="MultiplayerPlaylistItem"/> will be played, starting from 0 and increasing for items which will be played later.
         /// </summary>
-        /// <remarks>
-        /// Undefined value for items which are expired.
-        /// </remarks>
         [Key(8)]
         public int GameplayOrder { get; set; }
 
+        /// <summary>
+        /// The date when this <see cref="MultiplayerPlaylistItem"/> was last updated.
+        /// Not serialised to/from the client.
+        /// </summary>
+        [IgnoreMember]
+        public DateTimeOffset UpdatedAt { get; set; }
+
         public MultiplayerPlaylistItem()
         {
         }

From b75a5b778e0d22206dd17f0afce694825b39214f Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 3 Dec 2021 15:05:52 +0900
Subject: [PATCH 1481/5547] Update history list to also sort by gameplay order

---
 .../Multiplayer/Match/Playlist/MultiplayerHistoryList.cs        | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerHistoryList.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerHistoryList.cs
index 76088180c4..25f658446a 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerHistoryList.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerHistoryList.cs
@@ -27,7 +27,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist
 
         private class HistoryFillFlowContainer : FillFlowContainer<RearrangeableListItem<PlaylistItem>>
         {
-            public override IEnumerable<Drawable> FlowingChildren => base.FlowingChildren.Reverse();
+            public override IEnumerable<Drawable> FlowingChildren => base.FlowingChildren.OfType<RearrangeableListItem<PlaylistItem>>().OrderByDescending(item => item.Model.GameplayOrder);
         }
     }
 }

From 0a1304b92a00200c318828d995b63e1660ce1a18 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 3 Dec 2021 15:45:13 +0900
Subject: [PATCH 1482/5547] Remove gameplay_order, use existing playlist_order

---
 osu.Game/Online/Multiplayer/MultiplayerClient.cs            | 2 +-
 osu.Game/Online/Rooms/MultiplayerPlaylistItem.cs            | 4 ++--
 osu.Game/Online/Rooms/PlaylistItem.cs                       | 4 ++--
 .../Multiplayer/Match/Playlist/MultiplayerHistoryList.cs    | 2 +-
 .../Multiplayer/Match/Playlist/MultiplayerQueueList.cs      | 2 +-
 osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs  | 6 +++---
 6 files changed, 10 insertions(+), 10 deletions(-)

diff --git a/osu.Game/Online/Multiplayer/MultiplayerClient.cs b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
index 0ffb81d986..ae53ef2e52 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
@@ -742,7 +742,7 @@ namespace osu.Game.Online.Multiplayer
                 Beatmap = { Value = apiBeatmap },
                 Ruleset = { Value = ruleset },
                 Expired = item.Expired,
-                GameplayOrder = item.GameplayOrder
+                PlaylistOrder = item.PlaylistOrder
             };
 
             playlistItem.RequiredMods.AddRange(item.RequiredMods.Select(m => m.ToMod(rulesetInstance)));
diff --git a/osu.Game/Online/Rooms/MultiplayerPlaylistItem.cs b/osu.Game/Online/Rooms/MultiplayerPlaylistItem.cs
index ec98de2b43..c84b5b9039 100644
--- a/osu.Game/Online/Rooms/MultiplayerPlaylistItem.cs
+++ b/osu.Game/Online/Rooms/MultiplayerPlaylistItem.cs
@@ -43,7 +43,7 @@ namespace osu.Game.Online.Rooms
         /// The order in which this <see cref="MultiplayerPlaylistItem"/> will be played, starting from 0 and increasing for items which will be played later.
         /// </summary>
         [Key(8)]
-        public int GameplayOrder { get; set; }
+        public ushort PlaylistOrder { get; set; }
 
         /// <summary>
         /// The date when this <see cref="MultiplayerPlaylistItem"/> was last updated.
@@ -65,7 +65,7 @@ namespace osu.Game.Online.Rooms
             RequiredMods = item.RequiredMods.Select(m => new APIMod(m)).ToArray();
             AllowedMods = item.AllowedMods.Select(m => new APIMod(m)).ToArray();
             Expired = item.Expired;
-            GameplayOrder = item.GameplayOrder;
+            PlaylistOrder = item.PlaylistOrder ?? 0;
         }
     }
 }
diff --git a/osu.Game/Online/Rooms/PlaylistItem.cs b/osu.Game/Online/Rooms/PlaylistItem.cs
index 4c7f9e139a..beefb17d54 100644
--- a/osu.Game/Online/Rooms/PlaylistItem.cs
+++ b/osu.Game/Online/Rooms/PlaylistItem.cs
@@ -33,8 +33,8 @@ namespace osu.Game.Online.Rooms
         [JsonProperty("expired")]
         public bool Expired { get; set; }
 
-        [JsonProperty("gameplay_order")]
-        public int GameplayOrder { get; set; }
+        [JsonProperty("playlist_order")]
+        public ushort? PlaylistOrder { get; set; }
 
         [JsonIgnore]
         public IBindable<bool> Valid => valid;
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerHistoryList.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerHistoryList.cs
index 25f658446a..ed41a6fc78 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerHistoryList.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerHistoryList.cs
@@ -27,7 +27,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist
 
         private class HistoryFillFlowContainer : FillFlowContainer<RearrangeableListItem<PlaylistItem>>
         {
-            public override IEnumerable<Drawable> FlowingChildren => base.FlowingChildren.OfType<RearrangeableListItem<PlaylistItem>>().OrderByDescending(item => item.Model.GameplayOrder);
+            public override IEnumerable<Drawable> FlowingChildren => base.FlowingChildren.OfType<RearrangeableListItem<PlaylistItem>>().OrderByDescending(item => item.Model.PlaylistOrder);
         }
     }
 }
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerQueueList.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerQueueList.cs
index 58f35b940a..1b1b66273f 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerQueueList.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerQueueList.cs
@@ -38,7 +38,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist
                 roomPlaylist.BindCollectionChanged((_, __) => InvalidateLayout());
             }
 
-            public override IEnumerable<Drawable> FlowingChildren => base.FlowingChildren.OfType<RearrangeableListItem<PlaylistItem>>().OrderBy(item => item.Model.GameplayOrder);
+            public override IEnumerable<Drawable> FlowingChildren => base.FlowingChildren.OfType<RearrangeableListItem<PlaylistItem>>().OrderBy(item => item.Model.PlaylistOrder);
         }
     }
 }
diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
index 2831c94429..b47b86a2d8 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
@@ -316,7 +316,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 case QueueMode.HostOnly:
                     // In host-only mode, the current item is re-used.
                     item.ID = currentItem.ID;
-                    item.GameplayOrder = currentItem.GameplayOrder;
+                    item.PlaylistOrder = currentItem.PlaylistOrder;
 
                     serverSidePlaylist[currentIndex] = item;
                     await ((IMultiplayerClient)this).PlaylistItemChanged(item).ConfigureAwait(false);
@@ -488,10 +488,10 @@ namespace osu.Game.Tests.Visual.Multiplayer
             for (int i = 0; i < orderedItems.Count; i++)
             {
                 // Items which are already ordered correct don't need to be updated.
-                if (orderedItems[i].GameplayOrder == i)
+                if (orderedItems[i].PlaylistOrder == i)
                     continue;
 
-                orderedItems[i].GameplayOrder = i;
+                orderedItems[i].PlaylistOrder = (ushort)i;
 
                 // Items which have an ID of 0 are not in the database, so avoid propagating database/hub events for them.
                 if (orderedItems[i].ID <= 0)

From 2262b7b331efdd1ecfaa8572687e03dacd175d8f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 3 Dec 2021 15:35:06 +0900
Subject: [PATCH 1483/5547] Adjust logging to avoid using tabs

---
 osu.Desktop/LegacyIpc/LegacyTcpIpcProvider.cs | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Desktop/LegacyIpc/LegacyTcpIpcProvider.cs b/osu.Desktop/LegacyIpc/LegacyTcpIpcProvider.cs
index 273e17d24b..a48a6fc631 100644
--- a/osu.Desktop/LegacyIpc/LegacyTcpIpcProvider.cs
+++ b/osu.Desktop/LegacyIpc/LegacyTcpIpcProvider.cs
@@ -36,8 +36,8 @@ namespace osu.Desktop.LegacyIpc
             {
                 try
                 {
-                    logger.Add($"Processing legacy IPC message...");
-                    logger.Add($"\t{msg.Value}", LogLevel.Debug);
+                    logger.Add("Processing legacy IPC message...");
+                    logger.Add($"    {msg.Value}", LogLevel.Debug);
 
                     var legacyData = ((JObject)msg.Value).ToObject<LegacyIpcMessage.Data>();
                     object value = parseObject((JObject)legacyData!.MessageData, legacyData.MessageType);
@@ -64,7 +64,7 @@ namespace osu.Desktop.LegacyIpc
                     return value.ToObject<LegacyIpcDifficultyCalculationResponse>();
 
                 default:
-                    throw new ArgumentException($"Unknown type: {type}");
+                    throw new ArgumentException($"Unsupported object type {type}");
             }
         }
 

From 33992e11e09e0d8b8dc2ca851c15167abb3b0ed5 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 3 Dec 2021 15:40:53 +0900
Subject: [PATCH 1484/5547] Split out ruleset lookup code

---
 osu.Desktop/LegacyIpc/LegacyTcpIpcProvider.cs | 30 ++++++++++++++-----
 1 file changed, 22 insertions(+), 8 deletions(-)

diff --git a/osu.Desktop/LegacyIpc/LegacyTcpIpcProvider.cs b/osu.Desktop/LegacyIpc/LegacyTcpIpcProvider.cs
index a48a6fc631..b7f8baf219 100644
--- a/osu.Desktop/LegacyIpc/LegacyTcpIpcProvider.cs
+++ b/osu.Desktop/LegacyIpc/LegacyTcpIpcProvider.cs
@@ -75,14 +75,7 @@ namespace osu.Desktop.LegacyIpc
                 case LegacyIpcDifficultyCalculationRequest req:
                     try
                     {
-                        Ruleset ruleset = req.RulesetId switch
-                        {
-                            0 => new OsuRuleset(),
-                            1 => new TaikoRuleset(),
-                            2 => new CatchRuleset(),
-                            3 => new ManiaRuleset(),
-                            _ => throw new ArgumentException("Invalid ruleset id")
-                        };
+                        var ruleset = getLegacyRulesetFromID(req.RulesetId);
 
                         Mod[] mods = ruleset.ConvertFromLegacyMods((LegacyMods)req.Mods).ToArray();
                         WorkingBeatmap beatmap = new FlatFileWorkingBeatmap(req.BeatmapFile, _ => ruleset);
@@ -101,5 +94,26 @@ namespace osu.Desktop.LegacyIpc
             Console.WriteLine("Type not matched.");
             return null;
         }
+
+        private static Ruleset getLegacyRulesetFromID(int rulesetId)
+        {
+            switch (rulesetId)
+            {
+                case 0:
+                    return new OsuRuleset();
+
+                case 1:
+                    return new TaikoRuleset();
+
+                case 2:
+                    return new CatchRuleset();
+
+                case 3:
+                    return new ManiaRuleset();
+
+                default:
+                    throw new ArgumentException("Invalid ruleset id");
+            }
+        }
     }
 }

From 79d723172a30c44b432f852fb8d29e0742f521cd Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 3 Dec 2021 15:48:40 +0900
Subject: [PATCH 1485/5547] Remove `Console.WriteLine` usage

---
 osu.Desktop/LegacyIpc/LegacyTcpIpcProvider.cs | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Desktop/LegacyIpc/LegacyTcpIpcProvider.cs b/osu.Desktop/LegacyIpc/LegacyTcpIpcProvider.cs
index b7f8baf219..8ac946d4a4 100644
--- a/osu.Desktop/LegacyIpc/LegacyTcpIpcProvider.cs
+++ b/osu.Desktop/LegacyIpc/LegacyTcpIpcProvider.cs
@@ -89,10 +89,10 @@ namespace osu.Desktop.LegacyIpc
                     {
                         return new LegacyIpcDifficultyCalculationResponse();
                     }
-            }
 
-            Console.WriteLine("Type not matched.");
-            return null;
+                default:
+                    throw new ArgumentException($"Unsupported message type {message}");
+            }
         }
 
         private static Ruleset getLegacyRulesetFromID(int rulesetId)

From f9ad3075261edfc9c590beda29a8f8323c18b197 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 3 Dec 2021 15:49:01 +0900
Subject: [PATCH 1486/5547] Apply nullable

---
 osu.Desktop/LegacyIpc/LegacyTcpIpcProvider.cs | 16 +++++++++++-----
 1 file changed, 11 insertions(+), 5 deletions(-)

diff --git a/osu.Desktop/LegacyIpc/LegacyTcpIpcProvider.cs b/osu.Desktop/LegacyIpc/LegacyTcpIpcProvider.cs
index 8ac946d4a4..2c9eb76dfc 100644
--- a/osu.Desktop/LegacyIpc/LegacyTcpIpcProvider.cs
+++ b/osu.Desktop/LegacyIpc/LegacyTcpIpcProvider.cs
@@ -15,6 +15,8 @@ using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Taiko;
 
+#nullable enable
+
 namespace osu.Desktop.LegacyIpc
 {
     /// <summary>
@@ -27,7 +29,7 @@ namespace osu.Desktop.LegacyIpc
         /// <summary>
         /// Invoked when a message is received from a legacy client.
         /// </summary>
-        public new Func<object, object> MessageReceived;
+        public new Func<object, object>? MessageReceived;
 
         public LegacyTcpIpcProvider()
             : base(45357)
@@ -42,8 +44,10 @@ namespace osu.Desktop.LegacyIpc
                     var legacyData = ((JObject)msg.Value).ToObject<LegacyIpcMessage.Data>();
                     object value = parseObject((JObject)legacyData!.MessageData, legacyData.MessageType);
 
-                    object result = onLegacyIpcMessageReceived(value);
-                    return result != null ? new LegacyIpcMessage { Value = result } : null;
+                    return new LegacyIpcMessage
+                    {
+                        Value = onLegacyIpcMessageReceived(value)
+                    };
                 }
                 catch (Exception ex)
                 {
@@ -58,10 +62,12 @@ namespace osu.Desktop.LegacyIpc
             switch (type)
             {
                 case nameof(LegacyIpcDifficultyCalculationRequest):
-                    return value.ToObject<LegacyIpcDifficultyCalculationRequest>();
+                    return value.ToObject<LegacyIpcDifficultyCalculationRequest>()
+                           ?? throw new InvalidOperationException($"Failed to parse request {value}");
 
                 case nameof(LegacyIpcDifficultyCalculationResponse):
-                    return value.ToObject<LegacyIpcDifficultyCalculationResponse>();
+                    return value.ToObject<LegacyIpcDifficultyCalculationResponse>()
+                           ?? throw new InvalidOperationException($"Failed to parse request {value}");
 
                 default:
                     throw new ArgumentException($"Unsupported object type {type}");

From ba05a0a3834b6d02a07ef2f94e69a23b02584d14 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 3 Dec 2021 16:04:11 +0900
Subject: [PATCH 1487/5547] Centralise specification of bracket.json filename

---
 .../NonVisual/CustomTourneyDirectoryTest.cs               | 4 ++--
 osu.Game.Tournament/IO/TournamentStorage.cs               | 2 +-
 osu.Game.Tournament/TournamentGame.cs                     | 2 +-
 osu.Game.Tournament/TournamentGameBase.cs                 | 8 ++++----
 4 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/osu.Game.Tournament.Tests/NonVisual/CustomTourneyDirectoryTest.cs b/osu.Game.Tournament.Tests/NonVisual/CustomTourneyDirectoryTest.cs
index d149ec145b..3619aae7e0 100644
--- a/osu.Game.Tournament.Tests/NonVisual/CustomTourneyDirectoryTest.cs
+++ b/osu.Game.Tournament.Tests/NonVisual/CustomTourneyDirectoryTest.cs
@@ -96,7 +96,7 @@ namespace osu.Game.Tournament.Tests.NonVisual
                 Directory.CreateDirectory(flagsPath);
 
                 // Define testing files corresponding to the specific file migrations that are needed
-                string bracketFile = Path.Combine(osuRoot, "bracket.json");
+                string bracketFile = Path.Combine(osuRoot, TournamentGameBase.BRACKET_FILENAME);
 
                 string drawingsConfig = Path.Combine(osuRoot, "drawings.ini");
                 string drawingsFile = Path.Combine(osuRoot, "drawings.txt");
@@ -133,7 +133,7 @@ namespace osu.Game.Tournament.Tests.NonVisual
 
                     Assert.That(storage.GetFullPath("."), Is.EqualTo(migratedPath));
 
-                    Assert.True(storage.Exists("bracket.json"));
+                    Assert.True(storage.Exists(TournamentGameBase.BRACKET_FILENAME));
                     Assert.True(storage.Exists("drawings.txt"));
                     Assert.True(storage.Exists("drawings_results.txt"));
 
diff --git a/osu.Game.Tournament/IO/TournamentStorage.cs b/osu.Game.Tournament/IO/TournamentStorage.cs
index 02cf567837..347d368a04 100644
--- a/osu.Game.Tournament/IO/TournamentStorage.cs
+++ b/osu.Game.Tournament/IO/TournamentStorage.cs
@@ -86,7 +86,7 @@ namespace osu.Game.Tournament.IO
                 DeleteRecursive(source);
             }
 
-            moveFileIfExists("bracket.json", destination);
+            moveFileIfExists(TournamentGameBase.BRACKET_FILENAME, destination);
             moveFileIfExists("drawings.txt", destination);
             moveFileIfExists("drawings_results.txt", destination);
             moveFileIfExists("drawings.ini", destination);
diff --git a/osu.Game.Tournament/TournamentGame.cs b/osu.Game.Tournament/TournamentGame.cs
index f03f815b83..5d613894d4 100644
--- a/osu.Game.Tournament/TournamentGame.cs
+++ b/osu.Game.Tournament/TournamentGame.cs
@@ -71,7 +71,7 @@ namespace osu.Game.Tournament
                         loadingSpinner.Expire();
 
                         Logger.Error(t.Exception, "Couldn't load bracket with error");
-                        Add(new WarningBox("Your bracket.json file could not be parsed. Please check runtime.log for more details."));
+                        Add(new WarningBox($"Your {BRACKET_FILENAME} file could not be parsed. Please check runtime.log for more details."));
                     });
 
                     return;
diff --git a/osu.Game.Tournament/TournamentGameBase.cs b/osu.Game.Tournament/TournamentGameBase.cs
index d2f146c4c2..9db007f3ee 100644
--- a/osu.Game.Tournament/TournamentGameBase.cs
+++ b/osu.Game.Tournament/TournamentGameBase.cs
@@ -26,7 +26,7 @@ namespace osu.Game.Tournament
     [Cached(typeof(TournamentGameBase))]
     public class TournamentGameBase : OsuGameBase
     {
-        private const string bracket_filename = "bracket.json";
+        public const string BRACKET_FILENAME = @"bracket.json";
         private LadderInfo ladder;
         private TournamentStorage storage;
         private DependencyContainer dependencies;
@@ -71,9 +71,9 @@ namespace osu.Game.Tournament
         {
             try
             {
-                if (storage.Exists(bracket_filename))
+                if (storage.Exists(BRACKET_FILENAME))
                 {
-                    using (Stream stream = storage.GetStream(bracket_filename, FileAccess.Read, FileMode.Open))
+                    using (Stream stream = storage.GetStream(BRACKET_FILENAME, FileAccess.Read, FileMode.Open))
                     using (var sr = new StreamReader(stream))
                         ladder = JsonConvert.DeserializeObject<LadderInfo>(sr.ReadToEnd(), new JsonPointConverter());
                 }
@@ -309,7 +309,7 @@ namespace osu.Game.Tournament
                     Converters = new JsonConverter[] { new JsonPointConverter() }
                 });
 
-            using (var stream = storage.GetStream(bracket_filename, FileAccess.Write, FileMode.Create))
+            using (var stream = storage.GetStream(BRACKET_FILENAME, FileAccess.Write, FileMode.Create))
             using (var sw = new StreamWriter(stream))
                 sw.Write(serialisedLadder);
         }

From 5158736839ee93732531e2f596e2db22c0076bbc Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 3 Dec 2021 16:06:38 +0900
Subject: [PATCH 1488/5547] Avoid saving bracket if parsing failed, at all
 costs

---
 osu.Game.Tournament/TournamentGameBase.cs | 15 +++++++++++----
 1 file changed, 11 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Tournament/TournamentGameBase.cs b/osu.Game.Tournament/TournamentGameBase.cs
index 9db007f3ee..d08322a3e8 100644
--- a/osu.Game.Tournament/TournamentGameBase.cs
+++ b/osu.Game.Tournament/TournamentGameBase.cs
@@ -11,6 +11,7 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Textures;
 using osu.Framework.Input;
 using osu.Framework.IO.Stores;
+using osu.Framework.Logging;
 using osu.Framework.Platform;
 using osu.Game.Graphics;
 using osu.Game.Online.API.Requests;
@@ -32,9 +33,9 @@ namespace osu.Game.Tournament
         private DependencyContainer dependencies;
         private FileBasedIPC ipc;
 
-        protected Task BracketLoadTask => taskCompletionSource.Task;
+        protected Task BracketLoadTask => bracketLoadTaskCompletionSource.Task;
 
-        private readonly TaskCompletionSource<bool> taskCompletionSource = new TaskCompletionSource<bool>();
+        private readonly TaskCompletionSource<bool> bracketLoadTaskCompletionSource = new TaskCompletionSource<bool>();
 
         protected override IReadOnlyDependencyContainer CreateChildDependencies(IReadOnlyDependencyContainer parent)
         {
@@ -144,7 +145,7 @@ namespace osu.Game.Tournament
             }
             catch (Exception e)
             {
-                taskCompletionSource.SetException(e);
+                bracketLoadTaskCompletionSource.SetException(e);
                 return;
             }
 
@@ -156,7 +157,7 @@ namespace osu.Game.Tournament
                 dependencies.CacheAs<MatchIPCInfo>(ipc = new FileBasedIPC());
                 Add(ipc);
 
-                taskCompletionSource.SetResult(true);
+                bracketLoadTaskCompletionSource.SetResult(true);
 
                 initialisationText.Expire();
             });
@@ -292,6 +293,12 @@ namespace osu.Game.Tournament
 
         protected virtual void SaveChanges()
         {
+            if (!bracketLoadTaskCompletionSource.Task.IsCompletedSuccessfully)
+            {
+                Logger.Log("Inhibiting bracket save as bracket parsing failed");
+                return;
+            }
+
             foreach (var r in ladder.Rounds)
                 r.Matches = ladder.Matches.Where(p => p.Round.Value == r).Select(p => p.ID).ToList();
 

From dad5b06e8402205a67e6b4d5b899e2de642e6aef Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 3 Dec 2021 16:23:39 +0900
Subject: [PATCH 1489/5547] Avoid sending empty parameters in
 `GetBeatmapRequest`

---
 osu.Game/Online/API/Requests/GetBeatmapRequest.cs | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Online/API/Requests/GetBeatmapRequest.cs b/osu.Game/Online/API/Requests/GetBeatmapRequest.cs
index 6cd45a41df..671f543422 100644
--- a/osu.Game/Online/API/Requests/GetBeatmapRequest.cs
+++ b/osu.Game/Online/API/Requests/GetBeatmapRequest.cs
@@ -26,9 +26,12 @@ namespace osu.Game.Online.API.Requests
         {
             var request = base.CreateWebRequest();
 
-            request.AddParameter(@"id", beatmapInfo.OnlineID.ToString());
-            request.AddParameter(@"checksum", beatmapInfo.MD5Hash);
-            request.AddParameter(@"filename", filename);
+            if (beatmapInfo.OnlineID > 0)
+                request.AddParameter(@"id", beatmapInfo.OnlineID.ToString());
+            if (!string.IsNullOrEmpty(beatmapInfo.MD5Hash))
+                request.AddParameter(@"checksum", beatmapInfo.MD5Hash);
+            if (!string.IsNullOrEmpty(filename))
+                request.AddParameter(@"filename", filename);
 
             return request;
         }

From e4b296e16ee7b144e0529c7890328c14b7eb5389 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 3 Dec 2021 16:36:27 +0900
Subject: [PATCH 1490/5547] Use `OptIn` serialisation on `SkinInfo` to avoid
 writing unnecessary information

---
 osu.Game/Skinning/SkinInfo.cs | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Skinning/SkinInfo.cs b/osu.Game/Skinning/SkinInfo.cs
index 9a82964933..20c66a23a6 100644
--- a/osu.Game/Skinning/SkinInfo.cs
+++ b/osu.Game/Skinning/SkinInfo.cs
@@ -3,6 +3,7 @@
 
 using System;
 using System.Collections.Generic;
+using Newtonsoft.Json;
 using osu.Framework.Extensions.ObjectExtensions;
 using osu.Framework.Testing;
 using osu.Game.Database;
@@ -16,6 +17,7 @@ namespace osu.Game.Skinning
 {
     [ExcludeFromDynamicCompile]
     [MapTo("Skin")]
+    [JsonObject(MemberSerialization.OptIn)]
     public class SkinInfo : RealmObject, IHasRealmFiles, IEquatable<SkinInfo>, IHasGuidPrimaryKey, ISoftDelete, IHasNamedFiles
     {
         internal static readonly Guid DEFAULT_SKIN = new Guid("2991CFD8-2140-469A-BCB9-2EC23FBCE4AD");
@@ -23,18 +25,22 @@ namespace osu.Game.Skinning
         internal static readonly Guid RANDOM_SKIN = new Guid("D39DFEFB-477C-4372-B1EA-2BCEA5FB8908");
 
         [PrimaryKey]
+        [JsonProperty]
         public Guid ID { get; set; } = Guid.NewGuid();
 
+        [JsonProperty]
         public string Name { get; set; } = string.Empty;
 
+        [JsonProperty]
         public string Creator { get; set; } = string.Empty;
 
+        [JsonProperty]
+        public string InstantiationInfo { get; set; } = string.Empty;
+
         public string Hash { get; set; } = string.Empty;
 
         public bool Protected { get; set; }
 
-        public string InstantiationInfo { get; set; } = string.Empty;
-
         public virtual Skin CreateInstance(IStorageResourceProvider resources)
         {
             var type = string.IsNullOrEmpty(InstantiationInfo)

From 487a71312e3cebbea75902dbae6146ee0ef79ee3 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 3 Dec 2021 16:40:20 +0900
Subject: [PATCH 1491/5547] Split out code so base methods aren't called

---
 .../Match/Playlist/MultiplayerPlaylist.cs     | 32 ++++++++++++-------
 1 file changed, 20 insertions(+), 12 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylist.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylist.cs
index 2c50c88de8..c3245b550f 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylist.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylist.cs
@@ -86,7 +86,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist
             if (firstPopulation)
             {
                 foreach (var item in Room.Playlist)
-                    PlaylistItemAdded(item);
+                    addItemToLists(item);
 
                 firstPopulation = false;
             }
@@ -95,7 +95,25 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist
         protected override void PlaylistItemAdded(MultiplayerPlaylistItem item)
         {
             base.PlaylistItemAdded(item);
+            addItemToLists(item);
+        }
 
+        protected override void PlaylistItemRemoved(long item)
+        {
+            base.PlaylistItemRemoved(item);
+            removeItemFromLists(item);
+        }
+
+        protected override void PlaylistItemChanged(MultiplayerPlaylistItem item)
+        {
+            base.PlaylistItemChanged(item);
+
+            removeItemFromLists(item.ID);
+            addItemToLists(item);
+        }
+
+        private void addItemToLists(MultiplayerPlaylistItem item)
+        {
             var apiItem = Playlist.Single(i => i.ID == item.ID);
 
             if (item.Expired)
@@ -104,20 +122,10 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist
                 queueList.Items.Add(apiItem);
         }
 
-        protected override void PlaylistItemRemoved(long item)
+        private void removeItemFromLists(long item)
         {
-            base.PlaylistItemRemoved(item);
-
             queueList.Items.RemoveAll(i => i.ID == item);
             historyList.Items.RemoveAll(i => i.ID == item);
         }
-
-        protected override void PlaylistItemChanged(MultiplayerPlaylistItem item)
-        {
-            base.PlaylistItemChanged(item);
-
-            PlaylistItemRemoved(item.ID);
-            PlaylistItemAdded(item);
-        }
     }
 }

From 9d6fe558c2d554e40203e963eceb72c619a7e5c7 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 3 Dec 2021 16:48:54 +0900
Subject: [PATCH 1492/5547] Update TestMultiplayerClient with expired item
 ordering

---
 .../Multiplayer/TestMultiplayerClient.cs      | 57 ++++++++++++-------
 1 file changed, 38 insertions(+), 19 deletions(-)

diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
index b47b86a2d8..f2d5323386 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
@@ -45,11 +45,13 @@ namespace osu.Game.Tests.Visual.Multiplayer
         /// <summary>
         /// Guaranteed up-to-date playlist.
         /// </summary>
-        private List<MultiplayerPlaylistItem> serverSidePlaylist = new List<MultiplayerPlaylistItem>();
+        private readonly List<MultiplayerPlaylistItem> serverSidePlaylist = new List<MultiplayerPlaylistItem>();
 
         private MultiplayerPlaylistItem? currentItem => Room?.Playlist[currentIndex];
         private int currentIndex;
 
+        private long lastPlaylistItemId;
+
         public TestMultiplayerClient(TestMultiplayerRoomManager roomManager)
         {
             this.roomManager = roomManager;
@@ -169,6 +171,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             serverSidePlaylist.Clear();
             serverSidePlaylist.AddRange(apiRoom.Playlist.Select(item => new MultiplayerPlaylistItem(item)));
+            lastPlaylistItemId = serverSidePlaylist.Max(item => item.ID);
 
             var localUser = new MultiplayerRoomUser(api.LocalUser.Value.Id)
             {
@@ -397,10 +400,13 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             // Expire the current playlist item.
             currentItem.Expired = true;
+            currentItem.UpdatedAt = DateTimeOffset.Now;
+
             await ((IMultiplayerClient)this).PlaylistItemChanged(currentItem).ConfigureAwait(false);
+            await updatePlaylistOrder(Room).ConfigureAwait(false);
 
             // In host-only mode, a duplicate playlist item will be used for the next round.
-            if (Room.Settings.QueueMode == QueueMode.HostOnly)
+            if (Room.Settings.QueueMode == QueueMode.HostOnly && serverSidePlaylist.All(item => item.Expired))
                 await duplicateCurrentItem().ConfigureAwait(false);
 
             await updateCurrentItem(Room).ConfigureAwait(false);
@@ -424,11 +430,14 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             Debug.Assert(Room != null);
 
+            // Some tests can add items in already-expired states.
+            item.UpdatedAt = DateTimeOffset.Now;
+
             // Add the item to the list first in order to compute gameplay order.
             serverSidePlaylist.Add(item);
             await updatePlaylistOrder(Room).ConfigureAwait(false);
 
-            item.ID = serverSidePlaylist[^2].ID + 1;
+            item.ID = ++lastPlaylistItemId;
             await ((IMultiplayerClient)this).PlaylistItemAdded(item).ConfigureAwait(false);
         }
 
@@ -447,15 +456,17 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
         private async Task updatePlaylistOrder(MultiplayerRoom room)
         {
-            List<MultiplayerPlaylistItem> orderedItems;
+            List<MultiplayerPlaylistItem> orderedActiveItems;
 
             switch (room.Settings.QueueMode)
             {
                 default:
-                    orderedItems = serverSidePlaylist.OrderBy(item => item.ID == 0 ? int.MaxValue : item.ID).ToList();
+                    orderedActiveItems = serverSidePlaylist.Where(item => !item.Expired).OrderBy(item => item.ID == 0 ? int.MaxValue : item.ID).ToList();
                     break;
 
                 case QueueMode.AllPlayersRoundRobin:
+                    orderedActiveItems = new List<MultiplayerPlaylistItem>();
+
                     // Todo: This could probably be more efficient, likely at the cost of increased complexity.
                     // Number of "expired" or "used" items per player.
                     Dictionary<int, int> perUserCounts = serverSidePlaylist
@@ -463,7 +474,6 @@ namespace osu.Game.Tests.Visual.Multiplayer
                                                          .ToDictionary(group => group.Key, group => group.Count(item => item.Expired));
 
                     // We'll run a simulation over all items which are not expired ("unprocessed"). Expired items will not have their ordering updated.
-                    List<MultiplayerPlaylistItem> processedItems = serverSidePlaylist.Where(item => item.Expired).ToList();
                     List<MultiplayerPlaylistItem> unprocessedItems = serverSidePlaylist.Where(item => !item.Expired).ToList();
 
                     // In every iteration of the simulation, pick the first available item from the user with the lowest number of items in the queue to add to the result set.
@@ -476,31 +486,40 @@ namespace osu.Game.Tests.Visual.Multiplayer
                                                                 .First();
 
                         unprocessedItems.Remove(candidateItem);
-                        processedItems.Add(candidateItem);
+                        orderedActiveItems.Add(candidateItem);
 
                         perUserCounts[candidateItem.OwnerID]++;
                     }
 
-                    orderedItems = processedItems;
                     break;
             }
 
-            for (int i = 0; i < orderedItems.Count; i++)
-            {
-                // Items which are already ordered correct don't need to be updated.
-                if (orderedItems[i].PlaylistOrder == i)
-                    continue;
+            // For expired items, it's important that they're ordered in ascending order such that the last updated item is the last in the list.
+            // This is so that the updated_at database column doesn't get refreshed as a result of change in ordering.
+            List<MultiplayerPlaylistItem> orderedExpiredItems = serverSidePlaylist.Where(item => item.Expired).OrderBy(item => item.UpdatedAt).ToList();
+            for (int i = 0; i < orderedExpiredItems.Count; i++)
+                await setOrder(orderedExpiredItems[i], (ushort)i).ConfigureAwait(false);
 
-                orderedItems[i].PlaylistOrder = (ushort)i;
+            for (int i = 0; i < orderedActiveItems.Count; i++)
+                await setOrder(orderedActiveItems[i], (ushort)i).ConfigureAwait(false);
+
+            serverSidePlaylist.Clear();
+            serverSidePlaylist.AddRange(orderedExpiredItems);
+            serverSidePlaylist.AddRange(orderedActiveItems);
+
+            async Task setOrder(MultiplayerPlaylistItem item, ushort order)
+            {
+                if (item.PlaylistOrder == order)
+                    return;
+
+                item.PlaylistOrder = order;
 
                 // Items which have an ID of 0 are not in the database, so avoid propagating database/hub events for them.
-                if (orderedItems[i].ID <= 0)
-                    continue;
+                if (item.ID <= 0)
+                    return;
 
-                await ((IMultiplayerClient)this).PlaylistItemChanged(orderedItems[i]).ConfigureAwait(false);
+                await ((IMultiplayerClient)this).PlaylistItemChanged(item).ConfigureAwait(false);
             }
-
-            serverSidePlaylist = orderedItems;
         }
     }
 }

From 2927b235dec25bc6c27cac9786e1d0736ccea593 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 3 Dec 2021 17:18:02 +0900
Subject: [PATCH 1493/5547] Add test coverage of mouse wheel scroll adjusting
 volume

---
 .../TestSceneMouseWheelVolumeAdjust.cs        | 99 +++++++++++++++++++
 1 file changed, 99 insertions(+)
 create mode 100644 osu.Game.Tests/Visual/Navigation/TestSceneMouseWheelVolumeAdjust.cs

diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneMouseWheelVolumeAdjust.cs b/osu.Game.Tests/Visual/Navigation/TestSceneMouseWheelVolumeAdjust.cs
new file mode 100644
index 0000000000..9e684e4f10
--- /dev/null
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneMouseWheelVolumeAdjust.cs
@@ -0,0 +1,99 @@
+// 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.Configuration;
+using osu.Game.Screens.Play;
+using osu.Game.Tests.Beatmaps.IO;
+using osuTK.Input;
+
+namespace osu.Game.Tests.Visual.Navigation
+{
+    public class TestSceneMouseWheelVolumeAdjust : OsuGameTestScene
+    {
+        public override void SetUpSteps()
+        {
+            base.SetUpSteps();
+
+            // Headless tests are always at minimum volume. This covers interactive tests, matching that initial value.
+            AddStep("Set volume to min", () => Game.Audio.Volume.Value = 0);
+            AddAssert("Volume is min", () => Game.Audio.AggregateVolume.Value == 0);
+            AddStep("Move mouse to centre", () => InputManager.MoveMouseTo(Game.ScreenSpaceDrawQuad.Centre));
+        }
+
+        [Test]
+        public void TestAdjustVolumeFromMainMenu()
+        {
+            // First scroll makes volume controls appear, second adjusts volume.
+            AddRepeatStep("Adjust volume using mouse wheel", () => InputManager.ScrollVerticalBy(5), 2);
+            AddUntilStep("Volume is above zero", () => Game.Audio.AggregateVolume.Value > 0);
+        }
+
+        [Test]
+        public void TestAdjustVolumeFromPlayerWheelEnabled()
+        {
+            loadToPlayerNonBreakTime();
+
+            // First scroll makes volume controls appear, second adjusts volume.
+            AddRepeatStep("Adjust volume using mouse wheel", () => InputManager.ScrollVerticalBy(5), 2);
+            AddAssert("Volume is above zero", () => Game.Audio.Volume.Value > 0);
+        }
+
+        [Test]
+        public void TestAdjustVolumeFromPlayerWheelDisabled()
+        {
+            AddStep("disable wheel volume adjust", () => Game.LocalConfig.SetValue(OsuSetting.MouseDisableWheel, true));
+
+            loadToPlayerNonBreakTime();
+
+            // First scroll makes volume controls appear, second adjusts volume.
+            AddRepeatStep("Adjust volume using mouse wheel", () => InputManager.ScrollVerticalBy(5), 2);
+            AddAssert("Volume is still zero", () => Game.Audio.Volume.Value == 0);
+        }
+
+        [Test]
+        public void TestAdjustVolumeFromPlayerWheelDisabledHoldingAlt()
+        {
+            AddStep("disable wheel volume adjust", () => Game.LocalConfig.SetValue(OsuSetting.MouseDisableWheel, true));
+
+            loadToPlayerNonBreakTime();
+
+            // First scroll makes volume controls appear, second adjusts volume.
+            AddRepeatStep("Adjust volume using mouse wheel holding alt", () =>
+            {
+                InputManager.PressKey(Key.AltLeft);
+                InputManager.ScrollVerticalBy(5);
+                InputManager.ReleaseKey(Key.AltLeft);
+            }, 2);
+
+            AddAssert("Volume is above zero", () => Game.Audio.Volume.Value > 0);
+        }
+
+        private void loadToPlayerNonBreakTime()
+        {
+            Player player = null;
+            Screens.Select.SongSelect songSelect = null;
+            PushAndConfirm(() => songSelect = new TestSceneScreenNavigation.TestPlaySongSelect());
+            AddUntilStep("wait for song select", () => songSelect.BeatmapSetsLoaded);
+
+            AddStep("import beatmap", () => ImportBeatmapTest.LoadOszIntoOsu(Game, virtualTrack: true).Wait());
+            AddUntilStep("wait for selected", () => !Game.Beatmap.IsDefault);
+            AddStep("press enter", () => InputManager.Key(Key.Enter));
+
+            AddUntilStep("wait for player", () =>
+            {
+                // dismiss any notifications that may appear (ie. muted notification).
+                clickMouseInCentre();
+                return (player = Game.ScreenStack.CurrentScreen as Player) != null;
+            });
+
+            AddUntilStep("wait for play time active", () => !player.IsBreakTime.Value);
+        }
+
+        private void clickMouseInCentre()
+        {
+            InputManager.MoveMouseTo(Game.ScreenSpaceDrawQuad.Centre);
+            InputManager.Click(MouseButton.Left);
+        }
+    }
+}

From aaa46960b3967562034481e9773f6d2d2af51893 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 3 Dec 2021 16:56:14 +0900
Subject: [PATCH 1494/5547] Reword mouse wheel disable setting to better
 explain its purpose

---
 osu.Game/Localisation/MouseSettingsStrings.cs            | 9 +++++++--
 .../Overlays/Settings/Sections/Input/MouseSettings.cs    | 3 ++-
 2 files changed, 9 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Localisation/MouseSettingsStrings.cs b/osu.Game/Localisation/MouseSettingsStrings.cs
index 5e894c4e0b..fd7225ad2e 100644
--- a/osu.Game/Localisation/MouseSettingsStrings.cs
+++ b/osu.Game/Localisation/MouseSettingsStrings.cs
@@ -35,9 +35,14 @@ namespace osu.Game.Localisation
         public static LocalisableString ConfineMouseMode => new TranslatableString(getKey(@"confine_mouse_mode"), @"Confine mouse cursor to window");
 
         /// <summary>
-        /// "Disable mouse wheel during gameplay"
+        /// "Disable mouse wheel adjusting volume during gameplay"
         /// </summary>
-        public static LocalisableString DisableMouseWheel => new TranslatableString(getKey(@"disable_mouse_wheel"), @"Disable mouse wheel during gameplay");
+        public static LocalisableString DisableMouseWheelVolumeAdjust => new TranslatableString(getKey(@"disable_mouse_wheel_volume_adjust"), @"Disable mouse wheel adjusting volume during gameplay");
+
+        /// <summary>
+        /// "Volume can still be adjusted using the mouse wheel by holding "Alt""
+        /// </summary>
+        public static LocalisableString DisableMouseWheelVolumeAdjustTooltip => new TranslatableString(getKey(@"disable_mouse_wheel_volume_adjust_tooltip"), @"Volume can still be adjusted using the mouse wheel by holding ""Alt""");
 
         /// <summary>
         /// "Disable mouse buttons during gameplay"
diff --git a/osu.Game/Overlays/Settings/Sections/Input/MouseSettings.cs b/osu.Game/Overlays/Settings/Sections/Input/MouseSettings.cs
index 0334167759..4235dc0a05 100644
--- a/osu.Game/Overlays/Settings/Sections/Input/MouseSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Input/MouseSettings.cs
@@ -67,7 +67,8 @@ namespace osu.Game.Overlays.Settings.Sections.Input
                 },
                 new SettingsCheckbox
                 {
-                    LabelText = MouseSettingsStrings.DisableMouseWheel,
+                    LabelText = MouseSettingsStrings.DisableMouseWheelVolumeAdjust,
+                    TooltipText = MouseSettingsStrings.DisableMouseWheelVolumeAdjustTooltip,
                     Current = osuConfig.GetBindable<bool>(OsuSetting.MouseDisableWheel)
                 },
                 new SettingsCheckbox

From 6b7367240354715ade59470e1488e90ba3772cc7 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 3 Dec 2021 16:56:34 +0900
Subject: [PATCH 1495/5547] Stop `Player` from blocking volume adjust when
 `Alt` it held

Similar case to what we already have in `OsuScrollContainer`, so there
is precedent for handling this locally in this fashion.
---
 osu.Game/Screens/Play/Player.cs | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Play/Player.cs b/osu.Game/Screens/Play/Player.cs
index 4d574dea99..a0e9428cff 100644
--- a/osu.Game/Screens/Play/Player.cs
+++ b/osu.Game/Screens/Play/Player.cs
@@ -768,7 +768,15 @@ namespace osu.Game.Screens.Play
             Scheduler.Add(resultsDisplayDelegate);
         }
 
-        protected override bool OnScroll(ScrollEvent e) => mouseWheelDisabled.Value && !GameplayClockContainer.IsPaused.Value;
+        protected override bool OnScroll(ScrollEvent e)
+        {
+            // During pause, allow global volume adjust regardless of settings.
+            if (GameplayClockContainer.IsPaused.Value)
+                return false;
+
+            // Block global volume adjust if the user has asked for it (special case when holding "Alt").
+            return mouseWheelDisabled.Value && !e.AltPressed;
+        }
 
         #region Fail Logic
 

From 675ecb603f7500dd3b92547b703e4e14b985be3b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 3 Dec 2021 17:50:07 +0900
Subject: [PATCH 1496/5547] Add `IRulesetStore` to allow for transitional usage
 in upcoming manager classes

---
 osu.Game.Tests/Database/RulesetStoreTests.cs |  6 ++--
 osu.Game/Rulesets/IRulesetStore.cs           | 31 ++++++++++++++++++++
 osu.Game/Rulesets/RulesetStore.cs            | 10 ++++++-
 osu.Game/Stores/RealmRulesetStore.cs         | 18 ++++++++----
 4 files changed, 56 insertions(+), 9 deletions(-)
 create mode 100644 osu.Game/Rulesets/IRulesetStore.cs

diff --git a/osu.Game.Tests/Database/RulesetStoreTests.cs b/osu.Game.Tests/Database/RulesetStoreTests.cs
index f4e0838be1..b82dab1874 100644
--- a/osu.Game.Tests/Database/RulesetStoreTests.cs
+++ b/osu.Game.Tests/Database/RulesetStoreTests.cs
@@ -45,9 +45,9 @@ namespace osu.Game.Tests.Database
             {
                 var rulesets = new RealmRulesetStore(realmFactory, storage);
 
-                Assert.IsTrue((rulesets.AvailableRulesets.First() as RealmRuleset)?.IsManaged == false);
-                Assert.IsTrue((rulesets.GetRuleset(0) as RealmRuleset)?.IsManaged == false);
-                Assert.IsTrue((rulesets.GetRuleset("mania") as RealmRuleset)?.IsManaged == false);
+                Assert.IsTrue(rulesets.AvailableRulesets.First().IsManaged == false);
+                Assert.IsTrue(rulesets.GetRuleset(0)?.IsManaged == false);
+                Assert.IsTrue(rulesets.GetRuleset("mania")?.IsManaged == false);
             });
         }
     }
diff --git a/osu.Game/Rulesets/IRulesetStore.cs b/osu.Game/Rulesets/IRulesetStore.cs
new file mode 100644
index 0000000000..08d907810b
--- /dev/null
+++ b/osu.Game/Rulesets/IRulesetStore.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 System.Collections.Generic;
+
+#nullable enable
+
+namespace osu.Game.Rulesets
+{
+    public interface IRulesetStore
+    {
+        /// <summary>
+        /// Retrieve a ruleset using a known ID.
+        /// </summary>
+        /// <param name="id">The ruleset's internal ID.</param>
+        /// <returns>A ruleset, if available, else null.</returns>
+        IRulesetInfo? GetRuleset(int id);
+
+        /// <summary>
+        /// Retrieve a ruleset using a known short name.
+        /// </summary>
+        /// <param name="shortName">The ruleset's short name.</param>
+        /// <returns>A ruleset, if available, else null.</returns>
+        IRulesetInfo? GetRuleset(string shortName);
+
+        /// <summary>
+        /// All available rulesets.
+        /// </summary>
+        IEnumerable<IRulesetInfo> AvailableRulesets { get; }
+    }
+}
diff --git a/osu.Game/Rulesets/RulesetStore.cs b/osu.Game/Rulesets/RulesetStore.cs
index 6dd036c0e6..5cc6a75f43 100644
--- a/osu.Game/Rulesets/RulesetStore.cs
+++ b/osu.Game/Rulesets/RulesetStore.cs
@@ -13,7 +13,7 @@ using osu.Game.Database;
 
 namespace osu.Game.Rulesets
 {
-    public class RulesetStore : DatabaseBackedStore, IDisposable
+    public class RulesetStore : DatabaseBackedStore, IRulesetStore, IDisposable
     {
         private const string ruleset_library_prefix = "osu.Game.Rulesets";
 
@@ -236,5 +236,13 @@ namespace osu.Game.Rulesets
         {
             AppDomain.CurrentDomain.AssemblyResolve -= resolveRulesetDependencyAssembly;
         }
+
+        #region Implementation of IRulesetStore
+
+        IRulesetInfo IRulesetStore.GetRuleset(int id) => GetRuleset(id);
+        IRulesetInfo IRulesetStore.GetRuleset(string shortName) => GetRuleset(shortName);
+        IEnumerable<IRulesetInfo> IRulesetStore.AvailableRulesets => AvailableRulesets;
+
+        #endregion
     }
 }
diff --git a/osu.Game/Stores/RealmRulesetStore.cs b/osu.Game/Stores/RealmRulesetStore.cs
index 0119aec9a4..93b6d29e7d 100644
--- a/osu.Game/Stores/RealmRulesetStore.cs
+++ b/osu.Game/Stores/RealmRulesetStore.cs
@@ -18,7 +18,7 @@ using osu.Game.Rulesets;
 
 namespace osu.Game.Stores
 {
-    public class RealmRulesetStore : IDisposable
+    public class RealmRulesetStore : IRulesetStore, IDisposable
     {
         private readonly RealmContextFactory realmFactory;
 
@@ -29,9 +29,9 @@ namespace osu.Game.Stores
         /// <summary>
         /// All available rulesets.
         /// </summary>
-        public IEnumerable<IRulesetInfo> AvailableRulesets => availableRulesets;
+        public IEnumerable<RealmRuleset> AvailableRulesets => availableRulesets;
 
-        private readonly List<IRulesetInfo> availableRulesets = new List<IRulesetInfo>();
+        private readonly List<RealmRuleset> availableRulesets = new List<RealmRuleset>();
 
         public RealmRulesetStore(RealmContextFactory realmFactory, Storage? storage = null)
         {
@@ -64,14 +64,14 @@ namespace osu.Game.Stores
         /// </summary>
         /// <param name="id">The ruleset's internal ID.</param>
         /// <returns>A ruleset, if available, else null.</returns>
-        public IRulesetInfo? GetRuleset(int id) => AvailableRulesets.FirstOrDefault(r => r.OnlineID == id);
+        public RealmRuleset? GetRuleset(int id) => AvailableRulesets.FirstOrDefault(r => r.OnlineID == id);
 
         /// <summary>
         /// Retrieve a ruleset using a known short name.
         /// </summary>
         /// <param name="shortName">The ruleset's short name.</param>
         /// <returns>A ruleset, if available, else null.</returns>
-        public IRulesetInfo? GetRuleset(string shortName) => AvailableRulesets.FirstOrDefault(r => r.ShortName == shortName);
+        public RealmRuleset? GetRuleset(string shortName) => AvailableRulesets.FirstOrDefault(r => r.ShortName == shortName);
 
         private Assembly? resolveRulesetDependencyAssembly(object? sender, ResolveEventArgs args)
         {
@@ -258,5 +258,13 @@ namespace osu.Game.Stores
         {
             AppDomain.CurrentDomain.AssemblyResolve -= resolveRulesetDependencyAssembly;
         }
+
+        #region Implementation of IRulesetStore
+
+        IRulesetInfo? IRulesetStore.GetRuleset(int id) => GetRuleset(id);
+        IRulesetInfo? IRulesetStore.GetRuleset(string shortName) => GetRuleset(shortName);
+        IEnumerable<IRulesetInfo> IRulesetStore.AvailableRulesets => AvailableRulesets;
+
+        #endregion
     }
 }

From 15db1372aafa23a0b431fdf54465f1b7fdf55d18 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 3 Dec 2021 18:01:29 +0900
Subject: [PATCH 1497/5547] Add missing equality implementations on
 `IRulesetInfo`

---
 osu.Game/Models/RealmRuleset.cs   | 2 ++
 osu.Game/Rulesets/IRulesetInfo.cs | 3 ++-
 osu.Game/Rulesets/RulesetInfo.cs  | 2 ++
 3 files changed, 6 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Models/RealmRuleset.cs b/osu.Game/Models/RealmRuleset.cs
index 9a7488fda2..b959d0b4dc 100644
--- a/osu.Game/Models/RealmRuleset.cs
+++ b/osu.Game/Models/RealmRuleset.cs
@@ -50,6 +50,8 @@ namespace osu.Game.Models
 
         public bool Equals(RealmRuleset? other) => other != null && OnlineID == other.OnlineID && Available == other.Available && Name == other.Name && InstantiationInfo == other.InstantiationInfo;
 
+        public bool Equals(IRulesetInfo? other) => other is RealmRuleset b && Equals(b);
+
         public override string ToString() => Name;
 
         public RealmRuleset Clone() => new RealmRuleset
diff --git a/osu.Game/Rulesets/IRulesetInfo.cs b/osu.Game/Rulesets/IRulesetInfo.cs
index 4e529a73fb..6599e0d59d 100644
--- a/osu.Game/Rulesets/IRulesetInfo.cs
+++ b/osu.Game/Rulesets/IRulesetInfo.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.Game.Database;
 
 #nullable enable
@@ -10,7 +11,7 @@ namespace osu.Game.Rulesets
     /// <summary>
     /// A representation of a ruleset's metadata.
     /// </summary>
-    public interface IRulesetInfo : IHasOnlineID<int>
+    public interface IRulesetInfo : IHasOnlineID<int>, IEquatable<IRulesetInfo>
     {
         /// <summary>
         /// The user-exposed name of this ruleset.
diff --git a/osu.Game/Rulesets/RulesetInfo.cs b/osu.Game/Rulesets/RulesetInfo.cs
index 4a146c05bf..d018cc4194 100644
--- a/osu.Game/Rulesets/RulesetInfo.cs
+++ b/osu.Game/Rulesets/RulesetInfo.cs
@@ -49,6 +49,8 @@ namespace osu.Game.Rulesets
 
         public override bool Equals(object obj) => obj is RulesetInfo rulesetInfo && Equals(rulesetInfo);
 
+        public bool Equals(IRulesetInfo other) => other is RulesetInfo b && Equals(b);
+
         [SuppressMessage("ReSharper", "NonReadonlyMemberInGetHashCode")]
         public override int GetHashCode()
         {

From e75e209053adc92ba696110b87b5691a1aa0b9c0 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 3 Dec 2021 18:14:44 +0900
Subject: [PATCH 1498/5547] Cache and consume `IRulesetStore` where feasible

---
 osu.Game.Tests/Visual/Menus/TestSceneToolbar.cs        |  2 +-
 .../Visual/Online/TestSceneBeatmapRulesetSelector.cs   |  2 +-
 .../Visual/Online/TestSceneBeatmapSetOverlay.cs        |  2 +-
 osu.Game.Tests/Visual/Online/TestSceneUserPanel.cs     |  2 +-
 .../Ranking/TestSceneContractedPanelMiddleContent.cs   |  2 +-
 .../Components/TestSceneTournamentModDisplay.cs        |  2 +-
 osu.Game.Tournament/Components/TournamentModIcon.cs    |  2 +-
 osu.Game.Tournament/IPC/FileBasedIPC.cs                |  2 +-
 osu.Game/Beatmaps/DifficultyRecommender.cs             |  6 +++---
 osu.Game/Beatmaps/Drawables/DifficultyIcon.cs          |  2 +-
 osu.Game/Online/API/Requests/GetUserRequest.cs         |  6 +++---
 osu.Game/Online/Multiplayer/MultiplayerClient.cs       |  5 ++++-
 osu.Game/Online/Rooms/PlaylistItem.cs                  |  5 ++++-
 osu.Game/OsuGameBase.cs                                |  1 +
 osu.Game/Overlays/BeatmapSet/LeaderboardModSelector.cs |  9 +++++++--
 .../Profile/Sections/Recent/DrawableRecentActivity.cs  |  2 +-
 osu.Game/Screens/OnlinePlay/Components/RoomManager.cs  |  2 +-
 .../Multiplayer/Participants/ParticipantPanel.cs       |  4 ++--
 osu.Game/Users/UserActivity.cs                         | 10 +++++-----
 19 files changed, 40 insertions(+), 28 deletions(-)

diff --git a/osu.Game.Tests/Visual/Menus/TestSceneToolbar.cs b/osu.Game.Tests/Visual/Menus/TestSceneToolbar.cs
index 57d60cea9e..c65595d82e 100644
--- a/osu.Game.Tests/Visual/Menus/TestSceneToolbar.cs
+++ b/osu.Game.Tests/Visual/Menus/TestSceneToolbar.cs
@@ -20,7 +20,7 @@ namespace osu.Game.Tests.Visual.Menus
         private TestToolbar toolbar;
 
         [Resolved]
-        private RulesetStore rulesets { get; set; }
+        private IRulesetStore rulesets { get; set; }
 
         [SetUp]
         public void SetUp() => Schedule(() =>
diff --git a/osu.Game.Tests/Visual/Online/TestSceneBeatmapRulesetSelector.cs b/osu.Game.Tests/Visual/Online/TestSceneBeatmapRulesetSelector.cs
index 90f3eb64e4..63741451f3 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneBeatmapRulesetSelector.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneBeatmapRulesetSelector.cs
@@ -25,7 +25,7 @@ namespace osu.Game.Tests.Visual.Online
         }
 
         [Resolved]
-        private RulesetStore rulesets { get; set; }
+        private IRulesetStore rulesets { get; set; }
 
         [Test]
         public void TestMultipleRulesetsBeatmapSet()
diff --git a/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlay.cs b/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlay.cs
index 3314e291e8..f87cca80b0 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlay.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlay.cs
@@ -30,7 +30,7 @@ namespace osu.Game.Tests.Visual.Online
         }
 
         [Resolved]
-        private RulesetStore rulesets { get; set; }
+        private IRulesetStore rulesets { get; set; }
 
         [Test]
         public void TestLoading()
diff --git a/osu.Game.Tests/Visual/Online/TestSceneUserPanel.cs b/osu.Game.Tests/Visual/Online/TestSceneUserPanel.cs
index 19e06beaad..52d5eb2c65 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneUserPanel.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneUserPanel.cs
@@ -24,7 +24,7 @@ namespace osu.Game.Tests.Visual.Online
         private TestUserListPanel evast;
 
         [Resolved]
-        private RulesetStore rulesetStore { get; set; }
+        private IRulesetStore rulesetStore { get; set; }
 
         [SetUp]
         public void SetUp() => Schedule(() =>
diff --git a/osu.Game.Tests/Visual/Ranking/TestSceneContractedPanelMiddleContent.cs b/osu.Game.Tests/Visual/Ranking/TestSceneContractedPanelMiddleContent.cs
index acacdf8644..9ed135e8b8 100644
--- a/osu.Game.Tests/Visual/Ranking/TestSceneContractedPanelMiddleContent.cs
+++ b/osu.Game.Tests/Visual/Ranking/TestSceneContractedPanelMiddleContent.cs
@@ -21,7 +21,7 @@ namespace osu.Game.Tests.Visual.Ranking
     public class TestSceneContractedPanelMiddleContent : OsuTestScene
     {
         [Resolved]
-        private RulesetStore rulesetStore { get; set; }
+        private IRulesetStore rulesetStore { get; set; }
 
         [Test]
         public void TestShowPanel()
diff --git a/osu.Game.Tournament.Tests/Components/TestSceneTournamentModDisplay.cs b/osu.Game.Tournament.Tests/Components/TestSceneTournamentModDisplay.cs
index 3cd13df0d3..9feef36a02 100644
--- a/osu.Game.Tournament.Tests/Components/TestSceneTournamentModDisplay.cs
+++ b/osu.Game.Tournament.Tests/Components/TestSceneTournamentModDisplay.cs
@@ -19,7 +19,7 @@ namespace osu.Game.Tournament.Tests.Components
         private IAPIProvider api { get; set; }
 
         [Resolved]
-        private RulesetStore rulesets { get; set; }
+        private IRulesetStore rulesets { get; set; }
 
         private FillFlowContainer<TournamentBeatmapPanel> fillFlow;
 
diff --git a/osu.Game.Tournament/Components/TournamentModIcon.cs b/osu.Game.Tournament/Components/TournamentModIcon.cs
index 0fde263bc8..ed8a36c220 100644
--- a/osu.Game.Tournament/Components/TournamentModIcon.cs
+++ b/osu.Game.Tournament/Components/TournamentModIcon.cs
@@ -21,7 +21,7 @@ namespace osu.Game.Tournament.Components
         private readonly string modAcronym;
 
         [Resolved]
-        private RulesetStore rulesets { get; set; }
+        private IRulesetStore rulesets { get; set; }
 
         public TournamentModIcon(string modAcronym)
         {
diff --git a/osu.Game.Tournament/IPC/FileBasedIPC.cs b/osu.Game.Tournament/IPC/FileBasedIPC.cs
index a57f9fd691..5278d538d2 100644
--- a/osu.Game.Tournament/IPC/FileBasedIPC.cs
+++ b/osu.Game.Tournament/IPC/FileBasedIPC.cs
@@ -28,7 +28,7 @@ namespace osu.Game.Tournament.IPC
         protected IAPIProvider API { get; private set; }
 
         [Resolved]
-        protected RulesetStore Rulesets { get; private set; }
+        protected IRulesetStore Rulesets { get; private set; }
 
         [Resolved]
         private GameHost host { get; set; }
diff --git a/osu.Game/Beatmaps/DifficultyRecommender.cs b/osu.Game/Beatmaps/DifficultyRecommender.cs
index 8b00d0f7f2..3949e84f4a 100644
--- a/osu.Game/Beatmaps/DifficultyRecommender.cs
+++ b/osu.Game/Beatmaps/DifficultyRecommender.cs
@@ -25,7 +25,7 @@ namespace osu.Game.Beatmaps
         private IAPIProvider api { get; set; }
 
         [Resolved]
-        private RulesetStore rulesets { get; set; }
+        private IRulesetStore rulesets { get; set; }
 
         [Resolved]
         private Bindable<RulesetInfo> ruleset { get; set; }
@@ -35,7 +35,7 @@ namespace osu.Game.Beatmaps
         /// </summary>
         private int? requestedUserId;
 
-        private readonly Dictionary<RulesetInfo, double> recommendedDifficultyMapping = new Dictionary<RulesetInfo, double>();
+        private readonly Dictionary<IRulesetInfo, double> recommendedDifficultyMapping = new Dictionary<IRulesetInfo, double>();
 
         private readonly IBindable<APIState> apiState = new Bindable<APIState>();
 
@@ -101,7 +101,7 @@ namespace osu.Game.Beatmaps
         /// Rulesets ordered descending by their respective recommended difficulties.
         /// The currently selected ruleset will always be first.
         /// </returns>
-        private IEnumerable<RulesetInfo> orderedRulesets
+        private IEnumerable<IRulesetInfo> orderedRulesets
         {
             get
             {
diff --git a/osu.Game/Beatmaps/Drawables/DifficultyIcon.cs b/osu.Game/Beatmaps/Drawables/DifficultyIcon.cs
index 6e573cc2a0..82be0559a7 100644
--- a/osu.Game/Beatmaps/Drawables/DifficultyIcon.cs
+++ b/osu.Game/Beatmaps/Drawables/DifficultyIcon.cs
@@ -86,7 +86,7 @@ namespace osu.Game.Beatmaps.Drawables
         }
 
         [Resolved]
-        private RulesetStore rulesets { get; set; }
+        private IRulesetStore rulesets { get; set; }
 
         [BackgroundDependencyLoader]
         private void load(OsuColour colours)
diff --git a/osu.Game/Online/API/Requests/GetUserRequest.cs b/osu.Game/Online/API/Requests/GetUserRequest.cs
index e32451fc2f..28da5222f9 100644
--- a/osu.Game/Online/API/Requests/GetUserRequest.cs
+++ b/osu.Game/Online/API/Requests/GetUserRequest.cs
@@ -9,7 +9,7 @@ namespace osu.Game.Online.API.Requests
     public class GetUserRequest : APIRequest<APIUser>
     {
         public readonly string Lookup;
-        public readonly RulesetInfo Ruleset;
+        public readonly IRulesetInfo Ruleset;
         private readonly LookupType lookupType;
 
         /// <summary>
@@ -24,7 +24,7 @@ namespace osu.Game.Online.API.Requests
         /// </summary>
         /// <param name="userId">The user to get.</param>
         /// <param name="ruleset">The ruleset to get the user's info for.</param>
-        public GetUserRequest(long? userId = null, RulesetInfo ruleset = null)
+        public GetUserRequest(long? userId = null, IRulesetInfo ruleset = null)
         {
             Lookup = userId.ToString();
             lookupType = LookupType.Id;
@@ -36,7 +36,7 @@ namespace osu.Game.Online.API.Requests
         /// </summary>
         /// <param name="username">The user to get.</param>
         /// <param name="ruleset">The ruleset to get the user's info for.</param>
-        public GetUserRequest(string username = null, RulesetInfo ruleset = null)
+        public GetUserRequest(string username = null, IRulesetInfo ruleset = null)
         {
             Lookup = username;
             lookupType = LookupType.Username;
diff --git a/osu.Game/Online/Multiplayer/MultiplayerClient.cs b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
index 0822c29376..19ee6a3af3 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
@@ -94,7 +94,7 @@ namespace osu.Game.Online.Multiplayer
         protected IAPIProvider API { get; private set; } = null!;
 
         [Resolved]
-        protected RulesetStore Rulesets { get; private set; } = null!;
+        protected IRulesetStore Rulesets { get; private set; } = null!;
 
         [Resolved]
         private UserLookupCache userLookupCache { get; set; } = null!;
@@ -706,6 +706,9 @@ namespace osu.Game.Online.Multiplayer
             var apiBeatmap = await GetAPIBeatmap(item.BeatmapID).ConfigureAwait(false);
 
             var ruleset = Rulesets.GetRuleset(item.RulesetID);
+
+            Debug.Assert(ruleset != null);
+
             var rulesetInstance = ruleset.CreateInstance();
 
             var playlistItem = new PlaylistItem
diff --git a/osu.Game/Online/Rooms/PlaylistItem.cs b/osu.Game/Online/Rooms/PlaylistItem.cs
index a1480865b8..3eae03c702 100644
--- a/osu.Game/Online/Rooms/PlaylistItem.cs
+++ b/osu.Game/Online/Rooms/PlaylistItem.cs
@@ -2,6 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
+using System.Diagnostics;
 using System.Linq;
 using Newtonsoft.Json;
 using osu.Framework.Bindables;
@@ -79,11 +80,13 @@ namespace osu.Game.Online.Rooms
 
         public void MarkInvalid() => valid.Value = false;
 
-        public void MapObjects(RulesetStore rulesets)
+        public void MapObjects(IRulesetStore rulesets)
         {
             Beatmap.Value ??= apiBeatmap;
             Ruleset.Value ??= rulesets.GetRuleset(RulesetID);
 
+            Debug.Assert(Ruleset.Value != null);
+
             Ruleset rulesetInstance = Ruleset.Value.CreateInstance();
 
             if (allowedModsBacking != null)
diff --git a/osu.Game/OsuGameBase.cs b/osu.Game/OsuGameBase.cs
index 34344f8022..e852e3955b 100644
--- a/osu.Game/OsuGameBase.cs
+++ b/osu.Game/OsuGameBase.cs
@@ -196,6 +196,7 @@ namespace osu.Game
             runMigrations();
 
             dependencies.Cache(RulesetStore = new RulesetStore(contextFactory, Storage));
+            dependencies.CacheAs<IRulesetStore>(RulesetStore);
 
             dependencies.Cache(realmFactory = new RealmContextFactory(Storage, "client", contextFactory));
 
diff --git a/osu.Game/Overlays/BeatmapSet/LeaderboardModSelector.cs b/osu.Game/Overlays/BeatmapSet/LeaderboardModSelector.cs
index a9723c9c62..25aed4c980 100644
--- a/osu.Game/Overlays/BeatmapSet/LeaderboardModSelector.cs
+++ b/osu.Game/Overlays/BeatmapSet/LeaderboardModSelector.cs
@@ -47,7 +47,7 @@ namespace osu.Game.Overlays.BeatmapSet
         }
 
         [Resolved]
-        private RulesetStore rulesets { get; set; }
+        private IRulesetStore rulesets { get; set; }
 
         private void onRulesetChanged(ValueChangedEvent<IRulesetInfo> ruleset)
         {
@@ -57,8 +57,13 @@ namespace osu.Game.Overlays.BeatmapSet
             if (ruleset.NewValue == null)
                 return;
 
+            var rulesetInstance = rulesets.GetRuleset(ruleset.NewValue.OnlineID)?.CreateInstance();
+
+            if (rulesetInstance == null)
+                return;
+
             modsContainer.Add(new ModButton(new ModNoMod()));
-            modsContainer.AddRange(rulesets.GetRuleset(ruleset.NewValue.OnlineID).CreateInstance().AllMods.Where(m => m.UserPlayable).Select(m => new ModButton(m)));
+            modsContainer.AddRange(rulesetInstance.AllMods.Where(m => m.UserPlayable).Select(m => new ModButton(m)));
 
             modsContainer.ForEach(button =>
             {
diff --git a/osu.Game/Overlays/Profile/Sections/Recent/DrawableRecentActivity.cs b/osu.Game/Overlays/Profile/Sections/Recent/DrawableRecentActivity.cs
index cb8dae0bbc..7a27c6e4e1 100644
--- a/osu.Game/Overlays/Profile/Sections/Recent/DrawableRecentActivity.cs
+++ b/osu.Game/Overlays/Profile/Sections/Recent/DrawableRecentActivity.cs
@@ -25,7 +25,7 @@ namespace osu.Game.Overlays.Profile.Sections.Recent
         private IAPIProvider api { get; set; }
 
         [Resolved]
-        private RulesetStore rulesets { get; set; }
+        private IRulesetStore rulesets { get; set; }
 
         private readonly APIRecentActivity activity;
 
diff --git a/osu.Game/Screens/OnlinePlay/Components/RoomManager.cs b/osu.Game/Screens/OnlinePlay/Components/RoomManager.cs
index ddfdab18f7..1391422f9f 100644
--- a/osu.Game/Screens/OnlinePlay/Components/RoomManager.cs
+++ b/osu.Game/Screens/OnlinePlay/Components/RoomManager.cs
@@ -28,7 +28,7 @@ namespace osu.Game.Screens.OnlinePlay.Components
         private readonly Bindable<Room> joinedRoom = new Bindable<Room>();
 
         [Resolved]
-        private RulesetStore rulesets { get; set; }
+        private IRulesetStore rulesets { get; set; }
 
         [Resolved]
         private BeatmapManager beatmaps { get; set; }
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantPanel.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantPanel.cs
index 3152f50d3d..a68309dae5 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantPanel.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantPanel.cs
@@ -35,7 +35,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Participants
         private IAPIProvider api { get; set; }
 
         [Resolved]
-        private RulesetStore rulesets { get; set; }
+        private IRulesetStore rulesets { get; set; }
 
         private SpriteIcon crown;
 
@@ -185,7 +185,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Participants
             const double fade_time = 50;
 
             // Todo: Should use the room's selected item to determine ruleset.
-            var ruleset = rulesets.GetRuleset(0).CreateInstance();
+            var ruleset = rulesets.GetRuleset(0)?.CreateInstance();
 
             int? currentModeRank = User.User?.RulesetsStatistics?.GetValueOrDefault(ruleset.ShortName)?.GlobalRank;
             userRankText.Text = currentModeRank != null ? $"#{currentModeRank.Value:N0}" : string.Empty;
diff --git a/osu.Game/Users/UserActivity.cs b/osu.Game/Users/UserActivity.cs
index 0874685f49..516aa80652 100644
--- a/osu.Game/Users/UserActivity.cs
+++ b/osu.Game/Users/UserActivity.cs
@@ -29,9 +29,9 @@ namespace osu.Game.Users
         {
             public IBeatmapInfo BeatmapInfo { get; }
 
-            public RulesetInfo Ruleset { get; }
+            public IRulesetInfo Ruleset { get; }
 
-            protected InGame(IBeatmapInfo beatmapInfo, RulesetInfo ruleset)
+            protected InGame(IBeatmapInfo beatmapInfo, IRulesetInfo ruleset)
             {
                 BeatmapInfo = beatmapInfo;
                 Ruleset = ruleset;
@@ -42,7 +42,7 @@ namespace osu.Game.Users
 
         public class InMultiplayerGame : InGame
         {
-            public InMultiplayerGame(IBeatmapInfo beatmapInfo, RulesetInfo ruleset)
+            public InMultiplayerGame(IBeatmapInfo beatmapInfo, IRulesetInfo ruleset)
                 : base(beatmapInfo, ruleset)
             {
             }
@@ -52,7 +52,7 @@ namespace osu.Game.Users
 
         public class InPlaylistGame : InGame
         {
-            public InPlaylistGame(IBeatmapInfo beatmapInfo, RulesetInfo ruleset)
+            public InPlaylistGame(IBeatmapInfo beatmapInfo, IRulesetInfo ruleset)
                 : base(beatmapInfo, ruleset)
             {
             }
@@ -60,7 +60,7 @@ namespace osu.Game.Users
 
         public class InSoloGame : InGame
         {
-            public InSoloGame(IBeatmapInfo beatmapInfo, RulesetInfo ruleset)
+            public InSoloGame(IBeatmapInfo beatmapInfo, IRulesetInfo ruleset)
                 : base(beatmapInfo, ruleset)
             {
             }

From 2acf46154af93674dcb178e117dae20116243198 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 3 Dec 2021 18:16:29 +0900
Subject: [PATCH 1499/5547] Remove many unused resolutions of `RulesetStore`

---
 .../TestSceneMatchBeatmapDetailArea.cs        |  9 --------
 .../TestSceneTournamentBeatmapPanel.cs        | 10 +-------
 .../Leaderboards/UserTopScoreContainer.cs     |  5 ----
 .../BeatmapListingFilterControl.cs            |  4 ----
 osu.Game/Overlays/BeatmapSetOverlay.cs        |  5 ----
 .../Sections/PaginatedProfileSubsection.cs    | 20 +++++++---------
 .../Overlays/Rankings/SpotlightsLayout.cs     | 23 ++++++++-----------
 osu.Game/Screens/Play/SoloSpectator.cs        |  5 ----
 osu.Game/Screens/Select/BeatmapDetails.cs     |  4 ----
 9 files changed, 19 insertions(+), 66 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchBeatmapDetailArea.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchBeatmapDetailArea.cs
index d66603a448..1d61a5d496 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchBeatmapDetailArea.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchBeatmapDetailArea.cs
@@ -2,11 +2,8 @@
 // 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.Game.Beatmaps;
 using osu.Game.Online.Rooms;
-using osu.Game.Rulesets;
 using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Osu.Mods;
 using osu.Game.Screens.OnlinePlay.Components;
@@ -18,12 +15,6 @@ namespace osu.Game.Tests.Visual.Multiplayer
 {
     public class TestSceneMatchBeatmapDetailArea : OnlinePlayTestScene
     {
-        [Resolved]
-        private BeatmapManager beatmapManager { get; set; }
-
-        [Resolved]
-        private RulesetStore rulesetStore { get; set; }
-
         [SetUp]
         public new void Setup() => Schedule(() =>
         {
diff --git a/osu.Game.Tournament.Tests/Components/TestSceneTournamentBeatmapPanel.cs b/osu.Game.Tournament.Tests/Components/TestSceneTournamentBeatmapPanel.cs
index 8139387a96..7132655535 100644
--- a/osu.Game.Tournament.Tests/Components/TestSceneTournamentBeatmapPanel.cs
+++ b/osu.Game.Tournament.Tests/Components/TestSceneTournamentBeatmapPanel.cs
@@ -3,28 +3,20 @@
 
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
-using osu.Game.Online.API;
 using osu.Game.Online.API.Requests;
 using osu.Game.Online.API.Requests.Responses;
-using osu.Game.Rulesets;
 using osu.Game.Tournament.Components;
 
 namespace osu.Game.Tournament.Tests.Components
 {
     public class TestSceneTournamentBeatmapPanel : TournamentTestScene
     {
-        [Resolved]
-        private IAPIProvider api { get; set; }
-
-        [Resolved]
-        private RulesetStore rulesets { get; set; }
-
         [BackgroundDependencyLoader]
         private void load()
         {
             var req = new GetBeatmapRequest(new APIBeatmap { OnlineID = 1091460 });
             req.Success += success;
-            api.Queue(req);
+            API.Queue(req);
         }
 
         private void success(APIBeatmap beatmap)
diff --git a/osu.Game/Online/Leaderboards/UserTopScoreContainer.cs b/osu.Game/Online/Leaderboards/UserTopScoreContainer.cs
index ab4210251e..3db497bd6a 100644
--- a/osu.Game/Online/Leaderboards/UserTopScoreContainer.cs
+++ b/osu.Game/Online/Leaderboards/UserTopScoreContainer.cs
@@ -3,13 +3,11 @@
 
 using System;
 using System.Threading;
-using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
-using osu.Game.Rulesets;
 using osuTK;
 
 namespace osu.Game.Online.Leaderboards
@@ -25,9 +23,6 @@ namespace osu.Game.Online.Leaderboards
 
         protected override bool StartHidden => true;
 
-        [Resolved]
-        private RulesetStore rulesets { get; set; }
-
         public UserTopScoreContainer(Func<TScoreInfo, LeaderboardScore> createScoreDelegate)
         {
             this.createScoreDelegate = createScoreDelegate;
diff --git a/osu.Game/Overlays/BeatmapListing/BeatmapListingFilterControl.cs b/osu.Game/Overlays/BeatmapListing/BeatmapListingFilterControl.cs
index 38f2bdb34f..f5b4785264 100644
--- a/osu.Game/Overlays/BeatmapListing/BeatmapListingFilterControl.cs
+++ b/osu.Game/Overlays/BeatmapListing/BeatmapListingFilterControl.cs
@@ -15,7 +15,6 @@ using osu.Framework.Threading;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests;
 using osu.Game.Online.API.Requests.Responses;
-using osu.Game.Rulesets;
 using osu.Game.Resources.Localisation.Web;
 using osuTK;
 using osuTK.Graphics;
@@ -61,9 +60,6 @@ namespace osu.Game.Overlays.BeatmapListing
         [Resolved]
         private IAPIProvider api { get; set; }
 
-        [Resolved]
-        private RulesetStore rulesets { get; set; }
-
         public BeatmapListingFilterControl()
         {
             RelativeSizeAxes = Axes.X;
diff --git a/osu.Game/Overlays/BeatmapSetOverlay.cs b/osu.Game/Overlays/BeatmapSetOverlay.cs
index fa5a7c66d0..b9d3854066 100644
--- a/osu.Game/Overlays/BeatmapSetOverlay.cs
+++ b/osu.Game/Overlays/BeatmapSetOverlay.cs
@@ -2,7 +2,6 @@
 // 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.Framework.Graphics.Containers;
@@ -12,7 +11,6 @@ using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays.BeatmapSet;
 using osu.Game.Overlays.BeatmapSet.Scores;
 using osu.Game.Overlays.Comments;
-using osu.Game.Rulesets;
 using osuTK;
 using osuTK.Graphics;
 
@@ -24,9 +22,6 @@ namespace osu.Game.Overlays
         public const float Y_PADDING = 25;
         public const float RIGHT_WIDTH = 275;
 
-        [Resolved]
-        private RulesetStore rulesets { get; set; }
-
         private readonly Bindable<APIBeatmapSet> beatmapSet = new Bindable<APIBeatmapSet>();
 
         // receive input outside our bounds so we can trigger a close event on ourselves.
diff --git a/osu.Game/Overlays/Profile/Sections/PaginatedProfileSubsection.cs b/osu.Game/Overlays/Profile/Sections/PaginatedProfileSubsection.cs
index affe9ecb0c..130ae44273 100644
--- a/osu.Game/Overlays/Profile/Sections/PaginatedProfileSubsection.cs
+++ b/osu.Game/Overlays/Profile/Sections/PaginatedProfileSubsection.cs
@@ -1,21 +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 osuTK;
+using System.Collections.Generic;
+using System.Linq;
+using System.Threading;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
-using osu.Game.Online.API;
-using System.Collections.Generic;
-using System.Linq;
-using System.Threading;
-using osu.Game.Graphics.UserInterface;
-using osu.Game.Rulesets;
-using osu.Game.Graphics.Sprites;
-using osu.Game.Graphics;
 using osu.Framework.Localisation;
+using osu.Game.Graphics;
+using osu.Game.Graphics.Sprites;
+using osu.Game.Graphics.UserInterface;
+using osu.Game.Online.API;
 using osu.Game.Online.API.Requests.Responses;
+using osuTK;
 
 namespace osu.Game.Overlays.Profile.Sections
 {
@@ -24,9 +23,6 @@ namespace osu.Game.Overlays.Profile.Sections
         [Resolved]
         private IAPIProvider api { get; set; }
 
-        [Resolved]
-        protected RulesetStore Rulesets { get; private set; }
-
         protected int VisiblePages;
         protected int ItemsPerPage;
 
diff --git a/osu.Game/Overlays/Rankings/SpotlightsLayout.cs b/osu.Game/Overlays/Rankings/SpotlightsLayout.cs
index cc553ad361..a37f762532 100644
--- a/osu.Game/Overlays/Rankings/SpotlightsLayout.cs
+++ b/osu.Game/Overlays/Rankings/SpotlightsLayout.cs
@@ -1,21 +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.Bindables;
-using osu.Game.Rulesets;
-using osu.Framework.Graphics.Containers;
-using osu.Game.Online.API.Requests.Responses;
-using osuTK;
-using osu.Framework.Allocation;
-using osu.Game.Online.API;
-using osu.Game.Online.API.Requests;
-using osu.Game.Overlays.Rankings.Tables;
 using System.Linq;
 using System.Threading;
+using osu.Framework.Allocation;
+using osu.Framework.Bindables;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
 using osu.Game.Beatmaps.Drawables.Cards;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.UserInterface;
+using osu.Game.Online.API;
+using osu.Game.Online.API.Requests;
+using osu.Game.Online.API.Requests.Responses;
+using osu.Game.Overlays.Rankings.Tables;
+using osu.Game.Rulesets;
+using osuTK;
 
 namespace osu.Game.Overlays.Rankings
 {
@@ -29,9 +29,6 @@ namespace osu.Game.Overlays.Rankings
         [Resolved]
         private IAPIProvider api { get; set; }
 
-        [Resolved]
-        private RulesetStore rulesets { get; set; }
-
         private CancellationTokenSource cancellationToken;
         private GetSpotlightRankingsRequest getRankingsRequest;
         private GetSpotlightsRequest spotlightsRequest;
diff --git a/osu.Game/Screens/Play/SoloSpectator.cs b/osu.Game/Screens/Play/SoloSpectator.cs
index 45601999a0..7fea44b3ea 100644
--- a/osu.Game/Screens/Play/SoloSpectator.cs
+++ b/osu.Game/Screens/Play/SoloSpectator.cs
@@ -23,12 +23,10 @@ using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Spectator;
 using osu.Game.Overlays;
 using osu.Game.Overlays.Settings;
-using osu.Game.Rulesets;
 using osu.Game.Screens.OnlinePlay.Match.Components;
 using osu.Game.Screens.Spectate;
 using osu.Game.Users;
 using osuTK;
-using APIUser = osu.Game.Online.API.Requests.Responses.APIUser;
 
 namespace osu.Game.Screens.Play
 {
@@ -44,9 +42,6 @@ namespace osu.Game.Screens.Play
         [Resolved]
         private PreviewTrackManager previewTrackManager { get; set; }
 
-        [Resolved]
-        private RulesetStore rulesets { get; set; }
-
         [Resolved]
         private BeatmapManager beatmaps { get; set; }
 
diff --git a/osu.Game/Screens/Select/BeatmapDetails.cs b/osu.Game/Screens/Select/BeatmapDetails.cs
index 7543c89f17..bbe0a37d8e 100644
--- a/osu.Game/Screens/Select/BeatmapDetails.cs
+++ b/osu.Game/Screens/Select/BeatmapDetails.cs
@@ -16,7 +16,6 @@ using osu.Game.Online;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests;
 using osu.Game.Overlays.BeatmapSet;
-using osu.Game.Rulesets;
 using osu.Game.Screens.Select.Details;
 using osuTK;
 using osuTK.Graphics;
@@ -38,9 +37,6 @@ namespace osu.Game.Screens.Select
         [Resolved]
         private IAPIProvider api { get; set; }
 
-        [Resolved]
-        private RulesetStore rulesets { get; set; }
-
         private IBeatmapInfo beatmapInfo;
 
         private APIFailTimes failTimes;

From 1eed2436e6d76b94312541b01e1fd7b0baf8632e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 3 Dec 2021 18:37:45 +0900
Subject: [PATCH 1500/5547] Clean up unused resolved properties

---
 osu.Game.Rulesets.Mania/Edit/ManiaBeatSnapGrid.cs        | 7 -------
 osu.Game.Rulesets.Mania/Edit/ManiaSelectionHandler.cs    | 4 ----
 osu.Game.Rulesets.Mania/UI/PoolableHitExplosion.cs       | 3 ---
 osu.Game.Rulesets.Taiko/UI/InputDrum.cs                  | 4 ----
 .../Beatmaps/TestSceneBeatmapDifficultyCache.cs          | 3 ---
 osu.Game.Tests/Input/ConfineMouseTrackerTest.cs          | 3 ---
 osu.Game.Tests/Visual/Gameplay/TestSceneSkinEditor.cs    | 5 -----
 .../Visual/Gameplay/TestSceneSkinnableHUDOverlay.cs      | 4 ----
 .../Multiplayer/TestSceneMatchBeatmapDetailArea.cs       | 9 ---------
 .../Visual/Multiplayer/TestScenePlaylistsSongSelect.cs   | 3 ---
 osu.Game.Tests/Visual/Navigation/TestSceneOsuGame.cs     | 3 ---
 osu.Game.Tests/Visual/Online/TestSceneChatOverlay.cs     | 4 ----
 .../Visual/Online/TestSceneUserProfileOverlay.cs         | 5 -----
 .../Ranking/TestSceneContractedPanelMiddleContent.cs     | 4 ----
 .../TestSceneUpdateableBeatmapBackgroundSprite.cs        | 3 ---
 .../Components/TestSceneTournamentBeatmapPanel.cs        | 4 ----
 .../Screens/Editors/SeedingEditorScreen.cs               | 6 ------
 .../Screens/Setup/StablePathSelectScreen.cs              | 3 ---
 osu.Game/Audio/PreviewTrackManager.cs                    | 3 ---
 osu.Game/Collections/CollectionFilterDropdown.cs         | 4 ----
 osu.Game/Collections/CollectionManager.cs                | 3 ---
 osu.Game/Online/Leaderboards/LeaderboardScore.cs         | 3 ---
 osu.Game/Online/Leaderboards/UserTopScoreContainer.cs    | 5 -----
 .../BeatmapListing/BeatmapListingFilterControl.cs        | 4 ----
 osu.Game/Overlays/BeatmapSetOverlay.cs                   | 5 -----
 osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs   | 3 ---
 osu.Game/Overlays/Rankings/SpotlightsLayout.cs           | 3 ---
 osu.Game/Overlays/Wiki/Markdown/WikiMarkdownContainer.cs | 5 -----
 osu.Game/Rulesets/UI/Playfield.cs                        | 4 ----
 .../Timelines/Summary/Parts/GroupVisualisation.cs        | 5 -----
 .../Screens/Edit/Compose/Components/Timeline/Timeline.cs | 3 ---
 .../Components/Timeline/TimelineControlPointGroup.cs     | 5 -----
 .../Components/Timeline/TimelineHitObjectBlueprint.cs    | 3 ---
 osu.Game/Screens/Edit/Editor.cs                          | 3 ---
 osu.Game/Screens/Edit/EditorRoundedScreen.cs             | 4 ----
 osu.Game/Screens/Edit/EditorTable.cs                     | 3 ---
 .../Screens/Edit/Setup/FileChooserLabelledTextBox.cs     | 4 ----
 osu.Game/Screens/Edit/Timing/ControlPointTable.cs        | 3 ---
 osu.Game/Screens/Edit/Verify/IssueList.cs                | 3 ---
 osu.Game/Screens/Menu/StorageErrorDialog.cs              | 3 ---
 osu.Game/Screens/OnlinePlay/Components/RoomManager.cs    | 4 ----
 .../OnlinePlay/Components/SelectionPollingComponent.cs   | 4 ----
 .../Screens/OnlinePlay/Lounge/Components/DrawableRoom.cs | 3 ---
 .../OnlinePlay/Lounge/Components/RoomsContainer.cs       | 3 ---
 .../Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs | 8 --------
 .../Multiplayer/Match/MultiplayerReadyButton.cs          | 4 ----
 .../Multiplayer/Spectate/MultiSpectatorScreen.cs         | 3 ---
 osu.Game/Screens/OnlinePlay/OnlinePlayScreen.cs          | 9 ---------
 .../OnlinePlay/Playlists/PlaylistsRoomSubScreen.cs       | 4 ----
 .../Screens/OnlinePlay/Playlists/PlaylistsSongSelect.cs  | 5 -----
 osu.Game/Screens/Play/HUD/DefaultAccuracyCounter.cs      | 3 ---
 osu.Game/Screens/Play/HUD/DefaultComboCounter.cs         | 3 ---
 osu.Game/Screens/Play/HUD/DefaultScoreCounter.cs         | 3 ---
 osu.Game/Screens/Play/HUD/LegacyComboCounter.cs          | 3 ---
 osu.Game/Screens/Play/SoloSpectator.cs                   | 4 ----
 osu.Game/Screens/Ranking/ScorePanelList.cs               | 4 ----
 osu.Game/Screens/Select/BeatmapDetails.cs                | 4 ----
 .../Screens/Select/Leaderboards/BeatmapLeaderboard.cs    | 3 ---
 osu.Game/Skinning/Editor/SkinEditorOverlay.cs            | 5 -----
 osu.Game/Skinning/LegacyAccuracyCounter.cs               | 5 -----
 osu.Game/Skinning/PoolableSkinnableSample.cs             | 4 ----
 osu.Game/Skinning/SkinnableSound.cs                      | 4 ----
 osu.Game/Updater/NoActionUpdateManager.cs                | 4 ----
 63 files changed, 254 deletions(-)

diff --git a/osu.Game.Rulesets.Mania/Edit/ManiaBeatSnapGrid.cs b/osu.Game.Rulesets.Mania/Edit/ManiaBeatSnapGrid.cs
index 9d1f5429a1..1aa20f4737 100644
--- a/osu.Game.Rulesets.Mania/Edit/ManiaBeatSnapGrid.cs
+++ b/osu.Game.Rulesets.Mania/Edit/ManiaBeatSnapGrid.cs
@@ -9,7 +9,6 @@ using osu.Framework.Bindables;
 using osu.Framework.Caching;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Shapes;
-using osu.Game.Beatmaps;
 using osu.Game.Graphics;
 using osu.Game.Rulesets.Edit;
 using osu.Game.Rulesets.Mania.UI;
@@ -46,12 +45,6 @@ namespace osu.Game.Rulesets.Mania.Edit
         [Resolved]
         private EditorBeatmap beatmap { get; set; }
 
-        [Resolved]
-        private IScrollingInfo scrollingInfo { get; set; }
-
-        [Resolved]
-        private Bindable<WorkingBeatmap> working { get; set; }
-
         [Resolved]
         private OsuColour colours { get; set; }
 
diff --git a/osu.Game.Rulesets.Mania/Edit/ManiaSelectionHandler.cs b/osu.Game.Rulesets.Mania/Edit/ManiaSelectionHandler.cs
index dc858fb54f..9fe1eb7932 100644
--- a/osu.Game.Rulesets.Mania/Edit/ManiaSelectionHandler.cs
+++ b/osu.Game.Rulesets.Mania/Edit/ManiaSelectionHandler.cs
@@ -7,16 +7,12 @@ using osu.Framework.Allocation;
 using osu.Game.Rulesets.Edit;
 using osu.Game.Rulesets.Mania.Objects;
 using osu.Game.Rulesets.Objects;
-using osu.Game.Rulesets.UI.Scrolling;
 using osu.Game.Screens.Edit.Compose.Components;
 
 namespace osu.Game.Rulesets.Mania.Edit
 {
     public class ManiaSelectionHandler : EditorSelectionHandler
     {
-        [Resolved]
-        private IScrollingInfo scrollingInfo { get; set; }
-
         [Resolved]
         private HitObjectComposer composer { get; set; }
 
diff --git a/osu.Game.Rulesets.Mania/UI/PoolableHitExplosion.cs b/osu.Game.Rulesets.Mania/UI/PoolableHitExplosion.cs
index 90d3c6c4c7..9f4963b022 100644
--- a/osu.Game.Rulesets.Mania/UI/PoolableHitExplosion.cs
+++ b/osu.Game.Rulesets.Mania/UI/PoolableHitExplosion.cs
@@ -15,9 +15,6 @@ namespace osu.Game.Rulesets.Mania.UI
 
         public JudgementResult Result { get; private set; }
 
-        [Resolved]
-        private Column column { get; set; }
-
         private SkinnableDrawable skinnableExplosion;
 
         public PoolableHitExplosion()
diff --git a/osu.Game.Rulesets.Taiko/UI/InputDrum.cs b/osu.Game.Rulesets.Taiko/UI/InputDrum.cs
index 861b800038..16be20f7f3 100644
--- a/osu.Game.Rulesets.Taiko/UI/InputDrum.cs
+++ b/osu.Game.Rulesets.Taiko/UI/InputDrum.cs
@@ -12,7 +12,6 @@ using osu.Framework.Input.Events;
 using osu.Game.Graphics;
 using osu.Game.Rulesets.Taiko.Objects;
 using osu.Game.Rulesets.UI;
-using osu.Game.Screens.Play;
 using osu.Game.Skinning;
 using osuTK;
 
@@ -149,9 +148,6 @@ namespace osu.Game.Rulesets.Taiko.UI
                 centreHit.Colour = colours.Pink;
             }
 
-            [Resolved(canBeNull: true)]
-            private GameplayClock gameplayClock { get; set; }
-
             public bool OnPressed(KeyBindingPressEvent<TaikoAction> e)
             {
                 Drawable target = null;
diff --git a/osu.Game.Tests/Beatmaps/TestSceneBeatmapDifficultyCache.cs b/osu.Game.Tests/Beatmaps/TestSceneBeatmapDifficultyCache.cs
index 2a60a7b96d..3a82cbc785 100644
--- a/osu.Game.Tests/Beatmaps/TestSceneBeatmapDifficultyCache.cs
+++ b/osu.Game.Tests/Beatmaps/TestSceneBeatmapDifficultyCache.cs
@@ -25,9 +25,6 @@ namespace osu.Game.Tests.Beatmaps
 
         private BeatmapSetInfo importedSet;
 
-        [Resolved]
-        private BeatmapManager beatmaps { get; set; }
-
         private TestBeatmapDifficultyCache difficultyCache;
 
         private IBindable<StarDifficulty?> starDifficultyBindable;
diff --git a/osu.Game.Tests/Input/ConfineMouseTrackerTest.cs b/osu.Game.Tests/Input/ConfineMouseTrackerTest.cs
index b612899d79..28937b2120 100644
--- a/osu.Game.Tests/Input/ConfineMouseTrackerTest.cs
+++ b/osu.Game.Tests/Input/ConfineMouseTrackerTest.cs
@@ -18,9 +18,6 @@ namespace osu.Game.Tests.Input
         [Resolved]
         private FrameworkConfigManager frameworkConfigManager { get; set; }
 
-        [Resolved]
-        private OsuConfigManager osuConfigManager { get; set; }
-
         [TestCase(WindowMode.Windowed)]
         [TestCase(WindowMode.Borderless)]
         public void TestDisableConfining(WindowMode windowMode)
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSkinEditor.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSkinEditor.cs
index a0b27755b7..a0602e21b9 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSkinEditor.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSkinEditor.cs
@@ -2,12 +2,10 @@
 // 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.Testing;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Osu;
-using osu.Game.Skinning;
 using osu.Game.Skinning.Editor;
 
 namespace osu.Game.Tests.Visual.Gameplay
@@ -16,9 +14,6 @@ namespace osu.Game.Tests.Visual.Gameplay
     {
         private SkinEditor skinEditor;
 
-        [Resolved]
-        private SkinManager skinManager { get; set; }
-
         protected override bool Autoplay => true;
 
         [SetUpSteps]
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableHUDOverlay.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableHUDOverlay.cs
index 723e35ed55..3074a91dc6 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableHUDOverlay.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableHUDOverlay.cs
@@ -10,7 +10,6 @@ using osu.Framework.Extensions.IEnumerableExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Testing;
-using osu.Game.Configuration;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Osu;
@@ -36,9 +35,6 @@ namespace osu.Game.Tests.Visual.Gameplay
         private Drawable hideTarget => hudOverlay.KeyCounter;
         private FillFlowContainer<KeyCounter> keyCounterFlow => hudOverlay.KeyCounter.ChildrenOfType<FillFlowContainer<KeyCounter>>().First();
 
-        [Resolved]
-        private OsuConfigManager config { get; set; }
-
         [Test]
         public void TestComboCounterIncrementing()
         {
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchBeatmapDetailArea.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchBeatmapDetailArea.cs
index d66603a448..1d61a5d496 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchBeatmapDetailArea.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchBeatmapDetailArea.cs
@@ -2,11 +2,8 @@
 // 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.Game.Beatmaps;
 using osu.Game.Online.Rooms;
-using osu.Game.Rulesets;
 using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Osu.Mods;
 using osu.Game.Screens.OnlinePlay.Components;
@@ -18,12 +15,6 @@ namespace osu.Game.Tests.Visual.Multiplayer
 {
     public class TestSceneMatchBeatmapDetailArea : OnlinePlayTestScene
     {
-        [Resolved]
-        private BeatmapManager beatmapManager { get; set; }
-
-        [Resolved]
-        private RulesetStore rulesetStore { get; set; }
-
         [SetUp]
         public new void Setup() => Schedule(() =>
         {
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsSongSelect.cs b/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsSongSelect.cs
index 35c66e8cda..5aac228f4b 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsSongSelect.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsSongSelect.cs
@@ -24,9 +24,6 @@ namespace osu.Game.Tests.Visual.Multiplayer
 {
     public class TestScenePlaylistsSongSelect : OnlinePlayTestScene
     {
-        [Resolved]
-        private BeatmapManager beatmapManager { get; set; }
-
         private BeatmapManager manager;
 
         private RulesetStore rulesets;
diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneOsuGame.cs b/osu.Game.Tests/Visual/Navigation/TestSceneOsuGame.cs
index 2706ff5ceb..4d1e279090 100644
--- a/osu.Game.Tests/Visual/Navigation/TestSceneOsuGame.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneOsuGame.cs
@@ -83,9 +83,6 @@ namespace osu.Game.Tests.Visual.Navigation
         [Resolved]
         private OsuGameBase gameBase { get; set; }
 
-        [Resolved]
-        private GameHost host { get; set; }
-
         [Test]
         public void TestNullRulesetHandled()
         {
diff --git a/osu.Game.Tests/Visual/Online/TestSceneChatOverlay.cs b/osu.Game.Tests/Visual/Online/TestSceneChatOverlay.cs
index 7028ecf39f..9c65b2dc51 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneChatOverlay.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneChatOverlay.cs
@@ -13,7 +13,6 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.UserInterface;
 using osu.Framework.Input;
-using osu.Framework.Platform;
 using osu.Framework.Testing;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Online.API;
@@ -47,9 +46,6 @@ namespace osu.Game.Tests.Visual.Online
         [CanBeNull]
         private Func<Channel, List<Message>> onGetMessages;
 
-        [Resolved]
-        private GameHost host { get; set; }
-
         public TestSceneChatOverlay()
         {
             channels = Enumerable.Range(1, 10)
diff --git a/osu.Game.Tests/Visual/Online/TestSceneUserProfileOverlay.cs b/osu.Game.Tests/Visual/Online/TestSceneUserProfileOverlay.cs
index ce8136199f..1c92bb1e38 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneUserProfileOverlay.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneUserProfileOverlay.cs
@@ -4,8 +4,6 @@
 using System;
 using System.Linq;
 using NUnit.Framework;
-using osu.Framework.Allocation;
-using osu.Game.Online.API;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays;
 using osu.Game.Overlays.Profile;
@@ -20,9 +18,6 @@ namespace osu.Game.Tests.Visual.Online
 
         private readonly TestUserProfileOverlay profile;
 
-        [Resolved]
-        private IAPIProvider api { get; set; }
-
         public static readonly APIUser TEST_USER = new APIUser
         {
             Username = @"Somebody",
diff --git a/osu.Game.Tests/Visual/Ranking/TestSceneContractedPanelMiddleContent.cs b/osu.Game.Tests/Visual/Ranking/TestSceneContractedPanelMiddleContent.cs
index acacdf8644..f246560c82 100644
--- a/osu.Game.Tests/Visual/Ranking/TestSceneContractedPanelMiddleContent.cs
+++ b/osu.Game.Tests/Visual/Ranking/TestSceneContractedPanelMiddleContent.cs
@@ -9,7 +9,6 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
 using osu.Game.Beatmaps;
-using osu.Game.Rulesets;
 using osu.Game.Rulesets.Osu;
 using osu.Game.Scoring;
 using osu.Game.Screens.Ranking;
@@ -20,9 +19,6 @@ namespace osu.Game.Tests.Visual.Ranking
 {
     public class TestSceneContractedPanelMiddleContent : OsuTestScene
     {
-        [Resolved]
-        private RulesetStore rulesetStore { get; set; }
-
         [Test]
         public void TestShowPanel()
         {
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneUpdateableBeatmapBackgroundSprite.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneUpdateableBeatmapBackgroundSprite.cs
index d30f1e8889..3fa9b8b877 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneUpdateableBeatmapBackgroundSprite.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneUpdateableBeatmapBackgroundSprite.cs
@@ -26,9 +26,6 @@ namespace osu.Game.Tests.Visual.UserInterface
         private BeatmapSetInfo testBeatmap;
         private IAPIProvider api;
 
-        [Resolved]
-        private BeatmapManager beatmaps { get; set; }
-
         [BackgroundDependencyLoader]
         private void load(OsuGameBase osu, IAPIProvider api, RulesetStore rulesets)
         {
diff --git a/osu.Game.Tournament.Tests/Components/TestSceneTournamentBeatmapPanel.cs b/osu.Game.Tournament.Tests/Components/TestSceneTournamentBeatmapPanel.cs
index 8139387a96..a96c5123e0 100644
--- a/osu.Game.Tournament.Tests/Components/TestSceneTournamentBeatmapPanel.cs
+++ b/osu.Game.Tournament.Tests/Components/TestSceneTournamentBeatmapPanel.cs
@@ -6,7 +6,6 @@ using osu.Framework.Graphics;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests;
 using osu.Game.Online.API.Requests.Responses;
-using osu.Game.Rulesets;
 using osu.Game.Tournament.Components;
 
 namespace osu.Game.Tournament.Tests.Components
@@ -16,9 +15,6 @@ namespace osu.Game.Tournament.Tests.Components
         [Resolved]
         private IAPIProvider api { get; set; }
 
-        [Resolved]
-        private RulesetStore rulesets { get; set; }
-
         [BackgroundDependencyLoader]
         private void load()
         {
diff --git a/osu.Game.Tournament/Screens/Editors/SeedingEditorScreen.cs b/osu.Game.Tournament/Screens/Editors/SeedingEditorScreen.cs
index 9abf1d3adb..5d2fddffd9 100644
--- a/osu.Game.Tournament/Screens/Editors/SeedingEditorScreen.cs
+++ b/osu.Game.Tournament/Screens/Editors/SeedingEditorScreen.cs
@@ -25,9 +25,6 @@ namespace osu.Game.Tournament.Screens.Editors
 
         protected override BindableList<SeedingResult> Storage => team.SeedingResults;
 
-        [Resolved(canBeNull: true)]
-        private TournamentSceneManager sceneManager { get; set; }
-
         public SeedingEditorScreen(TournamentTeam team, TournamentScreen parentScreen)
             : base(parentScreen)
         {
@@ -38,9 +35,6 @@ namespace osu.Game.Tournament.Screens.Editors
         {
             public SeedingResult Model { get; }
 
-            [Resolved]
-            private LadderInfo ladderInfo { get; set; }
-
             public SeedingResultRow(TournamentTeam team, SeedingResult round)
             {
                 Model = round;
diff --git a/osu.Game.Tournament/Screens/Setup/StablePathSelectScreen.cs b/osu.Game.Tournament/Screens/Setup/StablePathSelectScreen.cs
index 8e9b32231f..5a1ceecd01 100644
--- a/osu.Game.Tournament/Screens/Setup/StablePathSelectScreen.cs
+++ b/osu.Game.Tournament/Screens/Setup/StablePathSelectScreen.cs
@@ -21,9 +21,6 @@ namespace osu.Game.Tournament.Screens.Setup
 {
     public class StablePathSelectScreen : TournamentScreen
     {
-        [Resolved]
-        private GameHost host { get; set; }
-
         [Resolved(canBeNull: true)]
         private TournamentSceneManager sceneManager { get; set; }
 
diff --git a/osu.Game/Audio/PreviewTrackManager.cs b/osu.Game/Audio/PreviewTrackManager.cs
index e631d35180..6d56d152f1 100644
--- a/osu.Game/Audio/PreviewTrackManager.cs
+++ b/osu.Game/Audio/PreviewTrackManager.cs
@@ -18,9 +18,6 @@ namespace osu.Game.Audio
 
         private readonly BindableDouble muteBindable = new BindableDouble();
 
-        [Resolved]
-        private AudioManager audio { get; set; }
-
         private ITrackStore trackStore;
 
         protected TrackManagerPreviewTrack CurrentTrack;
diff --git a/osu.Game/Collections/CollectionFilterDropdown.cs b/osu.Game/Collections/CollectionFilterDropdown.cs
index ad23874b2e..77bda00107 100644
--- a/osu.Game/Collections/CollectionFilterDropdown.cs
+++ b/osu.Game/Collections/CollectionFilterDropdown.cs
@@ -13,7 +13,6 @@ using osu.Framework.Graphics.UserInterface;
 using osu.Framework.Input.Events;
 using osu.Framework.Localisation;
 using osu.Game.Beatmaps;
-using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.UserInterface;
 using osuTK;
@@ -193,9 +192,6 @@ namespace osu.Game.Collections
             [NotNull]
             protected new CollectionFilterMenuItem Item => ((DropdownMenuItem<CollectionFilterMenuItem>)base.Item).Value;
 
-            [Resolved]
-            private OsuColour colours { get; set; }
-
             [Resolved]
             private IBindable<WorkingBeatmap> beatmap { get; set; }
 
diff --git a/osu.Game/Collections/CollectionManager.cs b/osu.Game/Collections/CollectionManager.cs
index 9ff92032b7..c4f991094c 100644
--- a/osu.Game/Collections/CollectionManager.cs
+++ b/osu.Game/Collections/CollectionManager.cs
@@ -40,9 +40,6 @@ namespace osu.Game.Collections
 
         public readonly BindableList<BeatmapCollection> Collections = new BindableList<BeatmapCollection>();
 
-        [Resolved]
-        private GameHost host { get; set; }
-
         [Resolved]
         private BeatmapManager beatmaps { get; set; }
 
diff --git a/osu.Game/Online/Leaderboards/LeaderboardScore.cs b/osu.Game/Online/Leaderboards/LeaderboardScore.cs
index e01c7c9e49..644c2e2a99 100644
--- a/osu.Game/Online/Leaderboards/LeaderboardScore.cs
+++ b/osu.Game/Online/Leaderboards/LeaderboardScore.cs
@@ -65,9 +65,6 @@ namespace osu.Game.Online.Leaderboards
         [Resolved(CanBeNull = true)]
         private SongSelect songSelect { get; set; }
 
-        [Resolved]
-        private ScoreManager scoreManager { get; set; }
-
         [Resolved]
         private Storage storage { get; set; }
 
diff --git a/osu.Game/Online/Leaderboards/UserTopScoreContainer.cs b/osu.Game/Online/Leaderboards/UserTopScoreContainer.cs
index ab4210251e..3db497bd6a 100644
--- a/osu.Game/Online/Leaderboards/UserTopScoreContainer.cs
+++ b/osu.Game/Online/Leaderboards/UserTopScoreContainer.cs
@@ -3,13 +3,11 @@
 
 using System;
 using System.Threading;
-using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
-using osu.Game.Rulesets;
 using osuTK;
 
 namespace osu.Game.Online.Leaderboards
@@ -25,9 +23,6 @@ namespace osu.Game.Online.Leaderboards
 
         protected override bool StartHidden => true;
 
-        [Resolved]
-        private RulesetStore rulesets { get; set; }
-
         public UserTopScoreContainer(Func<TScoreInfo, LeaderboardScore> createScoreDelegate)
         {
             this.createScoreDelegate = createScoreDelegate;
diff --git a/osu.Game/Overlays/BeatmapListing/BeatmapListingFilterControl.cs b/osu.Game/Overlays/BeatmapListing/BeatmapListingFilterControl.cs
index 38f2bdb34f..f5b4785264 100644
--- a/osu.Game/Overlays/BeatmapListing/BeatmapListingFilterControl.cs
+++ b/osu.Game/Overlays/BeatmapListing/BeatmapListingFilterControl.cs
@@ -15,7 +15,6 @@ using osu.Framework.Threading;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests;
 using osu.Game.Online.API.Requests.Responses;
-using osu.Game.Rulesets;
 using osu.Game.Resources.Localisation.Web;
 using osuTK;
 using osuTK.Graphics;
@@ -61,9 +60,6 @@ namespace osu.Game.Overlays.BeatmapListing
         [Resolved]
         private IAPIProvider api { get; set; }
 
-        [Resolved]
-        private RulesetStore rulesets { get; set; }
-
         public BeatmapListingFilterControl()
         {
             RelativeSizeAxes = Axes.X;
diff --git a/osu.Game/Overlays/BeatmapSetOverlay.cs b/osu.Game/Overlays/BeatmapSetOverlay.cs
index fa5a7c66d0..b9d3854066 100644
--- a/osu.Game/Overlays/BeatmapSetOverlay.cs
+++ b/osu.Game/Overlays/BeatmapSetOverlay.cs
@@ -2,7 +2,6 @@
 // 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.Framework.Graphics.Containers;
@@ -12,7 +11,6 @@ using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays.BeatmapSet;
 using osu.Game.Overlays.BeatmapSet.Scores;
 using osu.Game.Overlays.Comments;
-using osu.Game.Rulesets;
 using osuTK;
 using osuTK.Graphics;
 
@@ -24,9 +22,6 @@ namespace osu.Game.Overlays
         public const float Y_PADDING = 25;
         public const float RIGHT_WIDTH = 275;
 
-        [Resolved]
-        private RulesetStore rulesets { get; set; }
-
         private readonly Bindable<APIBeatmapSet> beatmapSet = new Bindable<APIBeatmapSet>();
 
         // receive input outside our bounds so we can trigger a close event on ourselves.
diff --git a/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs b/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs
index 269ed81bb5..0844975906 100644
--- a/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs
+++ b/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs
@@ -43,9 +43,6 @@ namespace osu.Game.Overlays.Dashboard
             };
         }
 
-        [Resolved]
-        private IAPIProvider api { get; set; }
-
         [Resolved]
         private UserLookupCache users { get; set; }
 
diff --git a/osu.Game/Overlays/Rankings/SpotlightsLayout.cs b/osu.Game/Overlays/Rankings/SpotlightsLayout.cs
index cc553ad361..dbfcfea414 100644
--- a/osu.Game/Overlays/Rankings/SpotlightsLayout.cs
+++ b/osu.Game/Overlays/Rankings/SpotlightsLayout.cs
@@ -29,9 +29,6 @@ namespace osu.Game.Overlays.Rankings
         [Resolved]
         private IAPIProvider api { get; set; }
 
-        [Resolved]
-        private RulesetStore rulesets { get; set; }
-
         private CancellationTokenSource cancellationToken;
         private GetSpotlightRankingsRequest getRankingsRequest;
         private GetSpotlightsRequest spotlightsRequest;
diff --git a/osu.Game/Overlays/Wiki/Markdown/WikiMarkdownContainer.cs b/osu.Game/Overlays/Wiki/Markdown/WikiMarkdownContainer.cs
index 6f0b433acb..789ed457a4 100644
--- a/osu.Game/Overlays/Wiki/Markdown/WikiMarkdownContainer.cs
+++ b/osu.Game/Overlays/Wiki/Markdown/WikiMarkdownContainer.cs
@@ -5,19 +5,14 @@ using System.Linq;
 using Markdig.Extensions.Yaml;
 using Markdig.Syntax;
 using Markdig.Syntax.Inlines;
-using osu.Framework.Allocation;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Containers.Markdown;
 using osu.Game.Graphics.Containers.Markdown;
-using osu.Game.Online.API;
 
 namespace osu.Game.Overlays.Wiki.Markdown
 {
     public class WikiMarkdownContainer : OsuMarkdownContainer
     {
-        [Resolved]
-        private IAPIProvider api { get; set; }
-
         public string CurrentPath
         {
             set => DocumentUrl = value;
diff --git a/osu.Game/Rulesets/UI/Playfield.cs b/osu.Game/Rulesets/UI/Playfield.cs
index 52aecb27de..d0bbf859af 100644
--- a/osu.Game/Rulesets/UI/Playfield.cs
+++ b/osu.Game/Rulesets/UI/Playfield.cs
@@ -19,7 +19,6 @@ using osu.Game.Rulesets.Objects;
 using osu.Game.Skinning;
 using osuTK;
 using System.Diagnostics;
-using osu.Framework.Audio.Sample;
 
 namespace osu.Game.Rulesets.UI
 {
@@ -88,9 +87,6 @@ namespace osu.Game.Rulesets.UI
         [Resolved(CanBeNull = true)]
         private IReadOnlyList<Mod> mods { get; set; }
 
-        [Resolved]
-        private ISampleStore sampleStore { get; set; }
-
         /// <summary>
         /// Creates a new <see cref="Playfield"/>.
         /// </summary>
diff --git a/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/GroupVisualisation.cs b/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/GroupVisualisation.cs
index 4629f9b540..f0e643f805 100644
--- a/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/GroupVisualisation.cs
+++ b/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/GroupVisualisation.cs
@@ -1,20 +1,15 @@
 // 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.Game.Beatmaps.ControlPoints;
-using osu.Game.Graphics;
 
 namespace osu.Game.Screens.Edit.Components.Timelines.Summary.Parts
 {
     public class GroupVisualisation : CompositeDrawable
     {
-        [Resolved]
-        private OsuColour colours { get; set; }
-
         public readonly ControlPointGroup Group;
 
         private readonly IBindableList<ControlPoint> controlPoints = new BindableList<ControlPoint>();
diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/Timeline.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/Timeline.cs
index b8fa05e7eb..265f56534f 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/Timeline.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/Timeline.cs
@@ -279,9 +279,6 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
                 editorClock.Start();
         }
 
-        [Resolved]
-        private EditorBeatmap beatmap { get; set; }
-
         [Resolved]
         private IBeatSnapProvider beatSnapProvider { get; set; }
 
diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineControlPointGroup.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineControlPointGroup.cs
index 2b2e66fb18..9610f6424c 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineControlPointGroup.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineControlPointGroup.cs
@@ -1,12 +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 osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Beatmaps.ControlPoints;
-using osu.Game.Graphics;
 
 namespace osu.Game.Screens.Edit.Compose.Components.Timeline
 {
@@ -16,9 +14,6 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
 
         private readonly IBindableList<ControlPoint> controlPoints = new BindableList<ControlPoint>();
 
-        [Resolved]
-        private OsuColour colours { get; set; }
-
         public TimelineControlPointGroup(ControlPointGroup group)
         {
             Group = group;
diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineHitObjectBlueprint.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineHitObjectBlueprint.cs
index 80aa6972b1..1839b0507d 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineHitObjectBlueprint.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineHitObjectBlueprint.cs
@@ -184,9 +184,6 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
         private SamplePointPiece sampleOverrideDisplay;
         private DifficultyPointPiece difficultyOverrideDisplay;
 
-        [Resolved]
-        private EditorBeatmap beatmap { get; set; }
-
         private DifficultyControlPoint difficultyControlPoint;
         private SampleControlPoint sampleControlPoint;
 
diff --git a/osu.Game/Screens/Edit/Editor.cs b/osu.Game/Screens/Edit/Editor.cs
index ac71298f36..48489c60ab 100644
--- a/osu.Game/Screens/Edit/Editor.cs
+++ b/osu.Game/Screens/Edit/Editor.cs
@@ -109,9 +109,6 @@ namespace osu.Game.Screens.Edit
         [Resolved]
         private IAPIProvider api { get; set; }
 
-        [Resolved]
-        private MusicController music { get; set; }
-
         [Cached]
         public readonly EditorClipboard Clipboard = new EditorClipboard();
 
diff --git a/osu.Game/Screens/Edit/EditorRoundedScreen.cs b/osu.Game/Screens/Edit/EditorRoundedScreen.cs
index 7f7b3abc2a..62f40f0325 100644
--- a/osu.Game/Screens/Edit/EditorRoundedScreen.cs
+++ b/osu.Game/Screens/Edit/EditorRoundedScreen.cs
@@ -5,7 +5,6 @@ using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
-using osu.Game.Graphics;
 using osu.Game.Overlays;
 
 namespace osu.Game.Screens.Edit
@@ -14,9 +13,6 @@ namespace osu.Game.Screens.Edit
     {
         public const int HORIZONTAL_PADDING = 100;
 
-        [Resolved]
-        private OsuColour colours { get; set; }
-
         private Container roundedContent;
 
         protected override Container<Drawable> Content => roundedContent;
diff --git a/osu.Game/Screens/Edit/EditorTable.cs b/osu.Game/Screens/Edit/EditorTable.cs
index ab8bd6a3bc..a67a060134 100644
--- a/osu.Game/Screens/Edit/EditorTable.cs
+++ b/osu.Game/Screens/Edit/EditorTable.cs
@@ -62,9 +62,6 @@ namespace osu.Game.Screens.Edit
 
             private readonly Box hoveredBackground;
 
-            [Resolved]
-            private EditorClock clock { get; set; }
-
             public RowBackground(object item)
             {
                 Item = item;
diff --git a/osu.Game/Screens/Edit/Setup/FileChooserLabelledTextBox.cs b/osu.Game/Screens/Edit/Setup/FileChooserLabelledTextBox.cs
index f833bc49f7..d1e35ae20d 100644
--- a/osu.Game/Screens/Edit/Setup/FileChooserLabelledTextBox.cs
+++ b/osu.Game/Screens/Edit/Setup/FileChooserLabelledTextBox.cs
@@ -15,7 +15,6 @@ using osu.Framework.Graphics.Cursor;
 using osu.Framework.Graphics.UserInterface;
 using osu.Framework.Input.Events;
 using osu.Game.Database;
-using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Graphics.UserInterfaceV2;
 using osuTK;
@@ -36,9 +35,6 @@ namespace osu.Game.Screens.Edit.Setup
         [Resolved]
         private OsuGameBase game { get; set; }
 
-        [Resolved]
-        private SectionsContainer<SetupSection> sectionsContainer { get; set; }
-
         public FileChooserLabelledTextBox(params string[] handledExtensions)
         {
             this.handledExtensions = handledExtensions;
diff --git a/osu.Game/Screens/Edit/Timing/ControlPointTable.cs b/osu.Game/Screens/Edit/Timing/ControlPointTable.cs
index 7a98cf63c3..1e6899e05f 100644
--- a/osu.Game/Screens/Edit/Timing/ControlPointTable.cs
+++ b/osu.Game/Screens/Edit/Timing/ControlPointTable.cs
@@ -132,9 +132,6 @@ namespace osu.Game.Screens.Edit.Timing
                 controlPoints.BindTo(group.ControlPoints);
             }
 
-            [Resolved]
-            private OsuColour colours { get; set; }
-
             [BackgroundDependencyLoader]
             private void load()
             {
diff --git a/osu.Game/Screens/Edit/Verify/IssueList.cs b/osu.Game/Screens/Edit/Verify/IssueList.cs
index fd238feeac..cadcdebc6e 100644
--- a/osu.Game/Screens/Edit/Verify/IssueList.cs
+++ b/osu.Game/Screens/Edit/Verify/IssueList.cs
@@ -23,9 +23,6 @@ namespace osu.Game.Screens.Edit.Verify
     {
         private IssueTable table;
 
-        [Resolved]
-        private EditorClock clock { get; set; }
-
         [Resolved]
         private IBindable<WorkingBeatmap> workingBeatmap { get; set; }
 
diff --git a/osu.Game/Screens/Menu/StorageErrorDialog.cs b/osu.Game/Screens/Menu/StorageErrorDialog.cs
index dcaad4013a..250623ec68 100644
--- a/osu.Game/Screens/Menu/StorageErrorDialog.cs
+++ b/osu.Game/Screens/Menu/StorageErrorDialog.cs
@@ -15,9 +15,6 @@ namespace osu.Game.Screens.Menu
         [Resolved]
         private DialogOverlay dialogOverlay { get; set; }
 
-        [Resolved]
-        private OsuGameBase osuGame { get; set; }
-
         public StorageErrorDialog(OsuStorage storage, OsuStorageError error)
         {
             HeaderText = "osu! storage error";
diff --git a/osu.Game/Screens/OnlinePlay/Components/RoomManager.cs b/osu.Game/Screens/OnlinePlay/Components/RoomManager.cs
index ddfdab18f7..47055c9c36 100644
--- a/osu.Game/Screens/OnlinePlay/Components/RoomManager.cs
+++ b/osu.Game/Screens/OnlinePlay/Components/RoomManager.cs
@@ -9,7 +9,6 @@ using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Logging;
-using osu.Game.Beatmaps;
 using osu.Game.Online.API;
 using osu.Game.Online.Rooms;
 using osu.Game.Rulesets;
@@ -30,9 +29,6 @@ namespace osu.Game.Screens.OnlinePlay.Components
         [Resolved]
         private RulesetStore rulesets { get; set; }
 
-        [Resolved]
-        private BeatmapManager beatmaps { get; set; }
-
         [Resolved]
         private IAPIProvider api { get; set; }
 
diff --git a/osu.Game/Screens/OnlinePlay/Components/SelectionPollingComponent.cs b/osu.Game/Screens/OnlinePlay/Components/SelectionPollingComponent.cs
index b9d2bdf23e..22842fbb9e 100644
--- a/osu.Game/Screens/OnlinePlay/Components/SelectionPollingComponent.cs
+++ b/osu.Game/Screens/OnlinePlay/Components/SelectionPollingComponent.cs
@@ -2,7 +2,6 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System.Threading.Tasks;
-using osu.Framework.Allocation;
 using osu.Game.Online.Rooms;
 
 namespace osu.Game.Screens.OnlinePlay.Components
@@ -12,9 +11,6 @@ namespace osu.Game.Screens.OnlinePlay.Components
     /// </summary>
     public class SelectionPollingComponent : RoomPollingComponent
     {
-        [Resolved]
-        private IRoomManager roomManager { get; set; }
-
         private readonly Room room;
 
         public SelectionPollingComponent(Room room)
diff --git a/osu.Game/Screens/OnlinePlay/Lounge/Components/DrawableRoom.cs b/osu.Game/Screens/OnlinePlay/Lounge/Components/DrawableRoom.cs
index 9920883078..0502c4abe6 100644
--- a/osu.Game/Screens/OnlinePlay/Lounge/Components/DrawableRoom.cs
+++ b/osu.Game/Screens/OnlinePlay/Lounge/Components/DrawableRoom.cs
@@ -30,9 +30,6 @@ namespace osu.Game.Screens.OnlinePlay.Lounge.Components
 
         public readonly Room Room;
 
-        [Resolved]
-        private BeatmapManager beatmaps { get; set; }
-
         protected Container ButtonsContainer { get; private set; }
 
         private readonly Bindable<MatchType> roomType = new Bindable<MatchType>();
diff --git a/osu.Game/Screens/OnlinePlay/Lounge/Components/RoomsContainer.cs b/osu.Game/Screens/OnlinePlay/Lounge/Components/RoomsContainer.cs
index 54c762b8ce..f4d7823fcc 100644
--- a/osu.Game/Screens/OnlinePlay/Lounge/Components/RoomsContainer.cs
+++ b/osu.Game/Screens/OnlinePlay/Lounge/Components/RoomsContainer.cs
@@ -33,9 +33,6 @@ namespace osu.Game.Screens.OnlinePlay.Lounge.Components
         [Resolved]
         private IRoomManager roomManager { get; set; }
 
-        [Resolved(CanBeNull = true)]
-        private LoungeSubScreen loungeSubScreen { get; set; }
-
         // handle deselection
         public override bool ReceivePositionalInputAt(Vector2 screenSpacePos) => true;
 
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs
index 34edc1ccd1..39d60a0b05 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs
@@ -12,7 +12,6 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Screens;
-using osu.Game.Beatmaps;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
@@ -20,7 +19,6 @@ using osu.Game.Graphics.UserInterface;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Rooms;
 using osu.Game.Overlays;
-using osu.Game.Rulesets;
 using osu.Game.Screens.OnlinePlay.Match.Components;
 using osuTK;
 
@@ -84,12 +82,6 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
             [Resolved]
             private MultiplayerClient client { get; set; }
 
-            [Resolved]
-            private Bindable<WorkingBeatmap> beatmap { get; set; }
-
-            [Resolved]
-            private Bindable<RulesetInfo> ruleset { get; set; }
-
             [Resolved]
             private OngoingOperationTracker ongoingOperationTracker { get; set; }
 
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
index ce988e377f..874113d859 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
@@ -11,7 +11,6 @@ using osu.Framework.Graphics;
 using osu.Framework.Threading;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Backgrounds;
-using osu.Game.Online.API;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Screens.OnlinePlay.Components;
 using osuTK;
@@ -25,9 +24,6 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
             set => button.Action = value;
         }
 
-        [Resolved]
-        private IAPIProvider api { get; set; }
-
         [Resolved]
         private OsuColour colours { get; set; }
 
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorScreen.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorScreen.cs
index 57d0d2c198..9ac64add9a 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorScreen.cs
@@ -36,9 +36,6 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Spectate
         [Resolved]
         private OsuColour colours { get; set; }
 
-        [Resolved]
-        private SpectatorClient spectatorClient { get; set; }
-
         [Resolved]
         private MultiplayerClient multiplayerClient { get; set; }
 
diff --git a/osu.Game/Screens/OnlinePlay/OnlinePlayScreen.cs b/osu.Game/Screens/OnlinePlay/OnlinePlayScreen.cs
index a18e4b45cf..19153521cd 100644
--- a/osu.Game/Screens/OnlinePlay/OnlinePlayScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/OnlinePlayScreen.cs
@@ -40,18 +40,9 @@ namespace osu.Game.Screens.OnlinePlay
         [Cached]
         private readonly OngoingOperationTracker ongoingOperationTracker = new OngoingOperationTracker();
 
-        [Resolved(CanBeNull = true)]
-        private MusicController music { get; set; }
-
-        [Resolved]
-        private OsuGameBase game { get; set; }
-
         [Resolved]
         protected IAPIProvider API { get; private set; }
 
-        [Resolved(CanBeNull = true)]
-        private OsuLogo logo { get; set; }
-
         protected OnlinePlayScreen()
         {
             Anchor = Anchor.Centre;
diff --git a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSubScreen.cs b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSubScreen.cs
index 6d2a426e70..7e045802f7 100644
--- a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSubScreen.cs
@@ -11,7 +11,6 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Logging;
 using osu.Framework.Screens;
 using osu.Game.Input;
-using osu.Game.Online.API;
 using osu.Game.Online.Rooms;
 using osu.Game.Screens.OnlinePlay.Components;
 using osu.Game.Screens.OnlinePlay.Match;
@@ -29,9 +28,6 @@ namespace osu.Game.Screens.OnlinePlay.Playlists
 
         public override string ShortTitle => "playlist";
 
-        [Resolved]
-        private IAPIProvider api { get; set; }
-
         private readonly IBindable<bool> isIdle = new BindableBool();
 
         private MatchLeaderboard leaderboard;
diff --git a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsSongSelect.cs b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsSongSelect.cs
index 03c95ec060..0fd76f7e25 100644
--- a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsSongSelect.cs
+++ b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsSongSelect.cs
@@ -2,9 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System.Linq;
-using osu.Framework.Allocation;
 using osu.Framework.Screens;
-using osu.Game.Beatmaps;
 using osu.Game.Online.Rooms;
 using osu.Game.Screens.OnlinePlay.Components;
 using osu.Game.Screens.Select;
@@ -13,9 +11,6 @@ namespace osu.Game.Screens.OnlinePlay.Playlists
 {
     public class PlaylistsSongSelect : OnlinePlaySongSelect
     {
-        [Resolved]
-        private BeatmapManager beatmaps { get; set; }
-
         public PlaylistsSongSelect(Room room)
             : base(room)
         {
diff --git a/osu.Game/Screens/Play/HUD/DefaultAccuracyCounter.cs b/osu.Game/Screens/Play/HUD/DefaultAccuracyCounter.cs
index 324e5d43b5..06b53e8426 100644
--- a/osu.Game/Screens/Play/HUD/DefaultAccuracyCounter.cs
+++ b/osu.Game/Screens/Play/HUD/DefaultAccuracyCounter.cs
@@ -9,9 +9,6 @@ namespace osu.Game.Screens.Play.HUD
 {
     public class DefaultAccuracyCounter : GameplayAccuracyCounter, ISkinnableDrawable
     {
-        [Resolved(canBeNull: true)]
-        private HUDOverlay hud { get; set; }
-
         public bool UsesFixedAnchor { get; set; }
 
         [BackgroundDependencyLoader]
diff --git a/osu.Game/Screens/Play/HUD/DefaultComboCounter.cs b/osu.Game/Screens/Play/HUD/DefaultComboCounter.cs
index 6d87211ddc..52f86d2bc3 100644
--- a/osu.Game/Screens/Play/HUD/DefaultComboCounter.cs
+++ b/osu.Game/Screens/Play/HUD/DefaultComboCounter.cs
@@ -15,9 +15,6 @@ namespace osu.Game.Screens.Play.HUD
 {
     public class DefaultComboCounter : RollingCounter<int>, ISkinnableDrawable
     {
-        [Resolved(canBeNull: true)]
-        private HUDOverlay hud { get; set; }
-
         public bool UsesFixedAnchor { get; set; }
 
         public DefaultComboCounter()
diff --git a/osu.Game/Screens/Play/HUD/DefaultScoreCounter.cs b/osu.Game/Screens/Play/HUD/DefaultScoreCounter.cs
index 87b19e8433..6af89404e0 100644
--- a/osu.Game/Screens/Play/HUD/DefaultScoreCounter.cs
+++ b/osu.Game/Screens/Play/HUD/DefaultScoreCounter.cs
@@ -16,9 +16,6 @@ namespace osu.Game.Screens.Play.HUD
             Origin = Anchor.TopCentre;
         }
 
-        [Resolved(canBeNull: true)]
-        private HUDOverlay hud { get; set; }
-
         public bool UsesFixedAnchor { get; set; }
 
         [BackgroundDependencyLoader]
diff --git a/osu.Game/Screens/Play/HUD/LegacyComboCounter.cs b/osu.Game/Screens/Play/HUD/LegacyComboCounter.cs
index 5c5b66d496..4859f1b977 100644
--- a/osu.Game/Screens/Play/HUD/LegacyComboCounter.cs
+++ b/osu.Game/Screens/Play/HUD/LegacyComboCounter.cs
@@ -40,9 +40,6 @@ namespace osu.Game.Screens.Play.HUD
 
         private bool isRolling;
 
-        [Resolved]
-        private ISkinSource skin { get; set; }
-
         private readonly Container counterContainer;
 
         /// <summary>
diff --git a/osu.Game/Screens/Play/SoloSpectator.cs b/osu.Game/Screens/Play/SoloSpectator.cs
index 45601999a0..b48c787752 100644
--- a/osu.Game/Screens/Play/SoloSpectator.cs
+++ b/osu.Game/Screens/Play/SoloSpectator.cs
@@ -23,7 +23,6 @@ using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Spectator;
 using osu.Game.Overlays;
 using osu.Game.Overlays.Settings;
-using osu.Game.Rulesets;
 using osu.Game.Screens.OnlinePlay.Match.Components;
 using osu.Game.Screens.Spectate;
 using osu.Game.Users;
@@ -44,9 +43,6 @@ namespace osu.Game.Screens.Play
         [Resolved]
         private PreviewTrackManager previewTrackManager { get; set; }
 
-        [Resolved]
-        private RulesetStore rulesets { get; set; }
-
         [Resolved]
         private BeatmapManager beatmaps { get; set; }
 
diff --git a/osu.Game/Screens/Ranking/ScorePanelList.cs b/osu.Game/Screens/Ranking/ScorePanelList.cs
index d5b8a4c8ea..22be91b974 100644
--- a/osu.Game/Screens/Ranking/ScorePanelList.cs
+++ b/osu.Game/Screens/Ranking/ScorePanelList.cs
@@ -13,7 +13,6 @@ using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Input.Events;
-using osu.Game.Beatmaps;
 using osu.Game.Graphics.Containers;
 using osu.Game.Scoring;
 using osuTK;
@@ -70,9 +69,6 @@ namespace osu.Game.Screens.Ranking
         [Resolved]
         private ScoreManager scoreManager { get; set; }
 
-        [Resolved]
-        private BeatmapDifficultyCache difficultyCache { get; set; }
-
         private readonly CancellationTokenSource loadCancellationSource = new CancellationTokenSource();
         private readonly Flow flow;
         private readonly Scroll scroll;
diff --git a/osu.Game/Screens/Select/BeatmapDetails.cs b/osu.Game/Screens/Select/BeatmapDetails.cs
index 7543c89f17..bbe0a37d8e 100644
--- a/osu.Game/Screens/Select/BeatmapDetails.cs
+++ b/osu.Game/Screens/Select/BeatmapDetails.cs
@@ -16,7 +16,6 @@ using osu.Game.Online;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests;
 using osu.Game.Overlays.BeatmapSet;
-using osu.Game.Rulesets;
 using osu.Game.Screens.Select.Details;
 using osuTK;
 using osuTK.Graphics;
@@ -38,9 +37,6 @@ namespace osu.Game.Screens.Select
         [Resolved]
         private IAPIProvider api { get; set; }
 
-        [Resolved]
-        private RulesetStore rulesets { get; set; }
-
         private IBeatmapInfo beatmapInfo;
 
         private APIFailTimes failTimes;
diff --git a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
index 1fd6d8c921..872e630ba0 100644
--- a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
+++ b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
@@ -64,9 +64,6 @@ namespace osu.Game.Screens.Select.Leaderboards
         [Resolved]
         private ScoreManager scoreManager { get; set; }
 
-        [Resolved]
-        private BeatmapDifficultyCache difficultyCache { get; set; }
-
         [Resolved]
         private IBindable<RulesetInfo> ruleset { get; set; }
 
diff --git a/osu.Game/Skinning/Editor/SkinEditorOverlay.cs b/osu.Game/Skinning/Editor/SkinEditorOverlay.cs
index d27122aea8..340c6ed931 100644
--- a/osu.Game/Skinning/Editor/SkinEditorOverlay.cs
+++ b/osu.Game/Skinning/Editor/SkinEditorOverlay.cs
@@ -3,13 +3,11 @@
 
 using System.Diagnostics;
 using JetBrains.Annotations;
-using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Input.Bindings;
 using osu.Framework.Input.Events;
-using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Input.Bindings;
 
@@ -28,9 +26,6 @@ namespace osu.Game.Skinning.Editor
 
         public const float VISIBLE_TARGET_SCALE = 0.8f;
 
-        [Resolved]
-        private OsuColour colours { get; set; }
-
         public SkinEditorOverlay(ScalingContainer target)
         {
             this.target = target;
diff --git a/osu.Game/Skinning/LegacyAccuracyCounter.cs b/osu.Game/Skinning/LegacyAccuracyCounter.cs
index fd5a9500d9..bdcb85456a 100644
--- a/osu.Game/Skinning/LegacyAccuracyCounter.cs
+++ b/osu.Game/Skinning/LegacyAccuracyCounter.cs
@@ -1,10 +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.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Game.Graphics.Sprites;
-using osu.Game.Screens.Play;
 using osu.Game.Screens.Play.HUD;
 using osuTK;
 
@@ -23,9 +21,6 @@ namespace osu.Game.Skinning
             Margin = new MarginPadding(10);
         }
 
-        [Resolved(canBeNull: true)]
-        private HUDOverlay hud { get; set; }
-
         protected sealed override OsuSpriteText CreateSpriteText() => new LegacySpriteText(LegacyFont.Score)
         {
             Anchor = Anchor.TopRight,
diff --git a/osu.Game/Skinning/PoolableSkinnableSample.cs b/osu.Game/Skinning/PoolableSkinnableSample.cs
index 3fcca74fb8..5db4f00b46 100644
--- a/osu.Game/Skinning/PoolableSkinnableSample.cs
+++ b/osu.Game/Skinning/PoolableSkinnableSample.cs
@@ -4,7 +4,6 @@
 using System;
 using System.Linq;
 using JetBrains.Annotations;
-using osu.Framework.Allocation;
 using osu.Framework.Audio;
 using osu.Framework.Audio.Sample;
 using osu.Framework.Bindables;
@@ -30,9 +29,6 @@ namespace osu.Game.Skinning
         private ISampleInfo sampleInfo;
         private SampleChannel activeChannel;
 
-        [Resolved]
-        private ISampleStore sampleStore { get; set; }
-
         /// <summary>
         /// Creates a new <see cref="PoolableSkinnableSample"/> with no applied <see cref="ISampleInfo"/>.
         /// An <see cref="ISampleInfo"/> can be applied later via <see cref="Apply"/>.
diff --git a/osu.Game/Skinning/SkinnableSound.cs b/osu.Game/Skinning/SkinnableSound.cs
index f935adf7a5..c9e55c09aa 100644
--- a/osu.Game/Skinning/SkinnableSound.cs
+++ b/osu.Game/Skinning/SkinnableSound.cs
@@ -7,7 +7,6 @@ using System.Linq;
 using JetBrains.Annotations;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
-using osu.Framework.Audio.Sample;
 using osu.Framework.Bindables;
 using osu.Framework.Extensions.IEnumerableExtensions;
 using osu.Framework.Graphics;
@@ -43,9 +42,6 @@ namespace osu.Game.Skinning
 
         private readonly AudioContainer<PoolableSkinnableSample> samplesContainer;
 
-        [Resolved]
-        private ISampleStore sampleStore { get; set; }
-
         [Resolved(CanBeNull = true)]
         private IPooledSampleProvider samplePool { get; set; }
 
diff --git a/osu.Game/Updater/NoActionUpdateManager.cs b/osu.Game/Updater/NoActionUpdateManager.cs
index 641263ed0f..8f9c4c6f16 100644
--- a/osu.Game/Updater/NoActionUpdateManager.cs
+++ b/osu.Game/Updater/NoActionUpdateManager.cs
@@ -5,7 +5,6 @@ using System.Linq;
 using System.Threading.Tasks;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics.Sprites;
-using osu.Framework.Platform;
 using osu.Game.Online.API;
 using osu.Game.Overlays.Notifications;
 
@@ -19,9 +18,6 @@ namespace osu.Game.Updater
     {
         private string version;
 
-        [Resolved]
-        private GameHost host { get; set; }
-
         [BackgroundDependencyLoader]
         private void load(OsuGameBase game)
         {

From d5803e541bdfcc1b0f6ed703bdb0773b766b5624 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 3 Dec 2021 20:05:25 +0900
Subject: [PATCH 1501/5547] Give playlist items a PlayedAt date

---
 .../TestSceneMultiplayerPlaylist.cs           |  4 ++-
 .../Online/Multiplayer/MultiplayerClient.cs   |  3 +-
 .../Online/Rooms/MultiplayerPlaylistItem.cs   |  8 ++---
 osu.Game/Online/Rooms/PlaylistItem.cs         |  3 ++
 .../Match/Playlist/MultiplayerHistoryList.cs  |  2 +-
 .../Multiplayer/TestMultiplayerClient.cs      | 36 +++++++------------
 6 files changed, 26 insertions(+), 30 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs
index ae885685f7..674ee0f186 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.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.Allocation;
@@ -168,7 +169,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             Beatmap = { Value = importedBeatmap },
             BeatmapID = importedBeatmap.OnlineID ?? -1,
-            Expired = expired
+            Expired = expired,
+            PlayedAt = DateTimeOffset.Now
         })));
 
         /// <summary>
diff --git a/osu.Game/Online/Multiplayer/MultiplayerClient.cs b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
index ae53ef2e52..555558eb6d 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
@@ -742,7 +742,8 @@ namespace osu.Game.Online.Multiplayer
                 Beatmap = { Value = apiBeatmap },
                 Ruleset = { Value = ruleset },
                 Expired = item.Expired,
-                PlaylistOrder = item.PlaylistOrder
+                PlaylistOrder = item.PlaylistOrder,
+                PlayedAt = item.PlayedAt
             };
 
             playlistItem.RequiredMods.AddRange(item.RequiredMods.Select(m => m.ToMod(rulesetInstance)));
diff --git a/osu.Game/Online/Rooms/MultiplayerPlaylistItem.cs b/osu.Game/Online/Rooms/MultiplayerPlaylistItem.cs
index c84b5b9039..1c33b79531 100644
--- a/osu.Game/Online/Rooms/MultiplayerPlaylistItem.cs
+++ b/osu.Game/Online/Rooms/MultiplayerPlaylistItem.cs
@@ -46,11 +46,10 @@ namespace osu.Game.Online.Rooms
         public ushort PlaylistOrder { get; set; }
 
         /// <summary>
-        /// The date when this <see cref="MultiplayerPlaylistItem"/> was last updated.
-        /// Not serialised to/from the client.
+        /// The date when this <see cref="MultiplayerPlaylistItem"/> was played.
         /// </summary>
-        [IgnoreMember]
-        public DateTimeOffset UpdatedAt { get; set; }
+        [Key(9)]
+        public DateTimeOffset? PlayedAt { get; set; }
 
         public MultiplayerPlaylistItem()
         {
@@ -66,6 +65,7 @@ namespace osu.Game.Online.Rooms
             AllowedMods = item.AllowedMods.Select(m => new APIMod(m)).ToArray();
             Expired = item.Expired;
             PlaylistOrder = item.PlaylistOrder ?? 0;
+            PlayedAt = item.PlayedAt;
         }
     }
 }
diff --git a/osu.Game/Online/Rooms/PlaylistItem.cs b/osu.Game/Online/Rooms/PlaylistItem.cs
index beefb17d54..4d67864048 100644
--- a/osu.Game/Online/Rooms/PlaylistItem.cs
+++ b/osu.Game/Online/Rooms/PlaylistItem.cs
@@ -36,6 +36,9 @@ namespace osu.Game.Online.Rooms
         [JsonProperty("playlist_order")]
         public ushort? PlaylistOrder { get; set; }
 
+        [JsonProperty("played_at")]
+        public DateTimeOffset? PlayedAt { get; set; }
+
         [JsonIgnore]
         public IBindable<bool> Valid => valid;
 
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerHistoryList.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerHistoryList.cs
index ed41a6fc78..d708b39898 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerHistoryList.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerHistoryList.cs
@@ -27,7 +27,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist
 
         private class HistoryFillFlowContainer : FillFlowContainer<RearrangeableListItem<PlaylistItem>>
         {
-            public override IEnumerable<Drawable> FlowingChildren => base.FlowingChildren.OfType<RearrangeableListItem<PlaylistItem>>().OrderByDescending(item => item.Model.PlaylistOrder);
+            public override IEnumerable<Drawable> FlowingChildren => base.FlowingChildren.OfType<RearrangeableListItem<PlaylistItem>>().OrderByDescending(item => item.Model.PlayedAt);
         }
     }
 }
diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
index f2d5323386..024b091bfb 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
@@ -400,7 +400,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             // Expire the current playlist item.
             currentItem.Expired = true;
-            currentItem.UpdatedAt = DateTimeOffset.Now;
+            currentItem.PlayedAt = DateTimeOffset.Now;
 
             await ((IMultiplayerClient)this).PlaylistItemChanged(currentItem).ConfigureAwait(false);
             await updatePlaylistOrder(Room).ConfigureAwait(false);
@@ -430,9 +430,6 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             Debug.Assert(Room != null);
 
-            // Some tests can add items in already-expired states.
-            item.UpdatedAt = DateTimeOffset.Now;
-
             // Add the item to the list first in order to compute gameplay order.
             serverSidePlaylist.Add(item);
             await updatePlaylistOrder(Room).ConfigureAwait(false);
@@ -443,8 +440,12 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
         private async Task updateCurrentItem(MultiplayerRoom room, bool notify = true)
         {
-            // The playlist is already in correct gameplay order, so pick the next non-expired item or default to the last item.
-            MultiplayerPlaylistItem nextItem = serverSidePlaylist.FirstOrDefault(i => !i.Expired) ?? room.Playlist.Last();
+            MultiplayerPlaylistItem nextItem = serverSidePlaylist
+                                               .Where(i => !i.Expired)
+                                               .OrderBy(i => i.PlaylistOrder)
+                                               .FirstOrDefault()
+                                               ?? room.Playlist.Last();
+
             currentIndex = serverSidePlaylist.IndexOf(nextItem);
 
             long lastItem = room.Settings.PlaylistItemId;
@@ -494,29 +495,18 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     break;
             }
 
-            // For expired items, it's important that they're ordered in ascending order such that the last updated item is the last in the list.
-            // This is so that the updated_at database column doesn't get refreshed as a result of change in ordering.
-            List<MultiplayerPlaylistItem> orderedExpiredItems = serverSidePlaylist.Where(item => item.Expired).OrderBy(item => item.UpdatedAt).ToList();
-            for (int i = 0; i < orderedExpiredItems.Count; i++)
-                await setOrder(orderedExpiredItems[i], (ushort)i).ConfigureAwait(false);
-
             for (int i = 0; i < orderedActiveItems.Count; i++)
-                await setOrder(orderedActiveItems[i], (ushort)i).ConfigureAwait(false);
-
-            serverSidePlaylist.Clear();
-            serverSidePlaylist.AddRange(orderedExpiredItems);
-            serverSidePlaylist.AddRange(orderedActiveItems);
-
-            async Task setOrder(MultiplayerPlaylistItem item, ushort order)
             {
-                if (item.PlaylistOrder == order)
-                    return;
+                var item = orderedActiveItems[i];
 
-                item.PlaylistOrder = order;
+                if (item.PlaylistOrder == i)
+                    continue;
+
+                item.PlaylistOrder = (ushort)i;
 
                 // Items which have an ID of 0 are not in the database, so avoid propagating database/hub events for them.
                 if (item.ID <= 0)
-                    return;
+                    continue;
 
                 await ((IMultiplayerClient)this).PlaylistItemChanged(item).ConfigureAwait(false);
             }

From 9acc0556a4fbe260a5cea97f9b823cdd2aa893df Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 3 Dec 2021 20:35:47 +0900
Subject: [PATCH 1502/5547] Remove unused event

---
 osu.Desktop/LegacyIpc/LegacyTcpIpcProvider.cs | 7 +------
 1 file changed, 1 insertion(+), 6 deletions(-)

diff --git a/osu.Desktop/LegacyIpc/LegacyTcpIpcProvider.cs b/osu.Desktop/LegacyIpc/LegacyTcpIpcProvider.cs
index 2c9eb76dfc..e42a10430a 100644
--- a/osu.Desktop/LegacyIpc/LegacyTcpIpcProvider.cs
+++ b/osu.Desktop/LegacyIpc/LegacyTcpIpcProvider.cs
@@ -26,15 +26,10 @@ namespace osu.Desktop.LegacyIpc
     {
         private static readonly Logger logger = Logger.GetLogger("legacy-ipc");
 
-        /// <summary>
-        /// Invoked when a message is received from a legacy client.
-        /// </summary>
-        public new Func<object, object>? MessageReceived;
-
         public LegacyTcpIpcProvider()
             : base(45357)
         {
-            base.MessageReceived += msg =>
+            MessageReceived += msg =>
             {
                 try
                 {

From 34b0e374d855cacde830c91b7251f74d499d1a1d Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 3 Dec 2021 21:29:20 +0900
Subject: [PATCH 1503/5547] Add serialisation/deserialisation explanation

---
 osu.Desktop/LegacyIpc/LegacyIpcMessage.cs     | 13 +++++++++++++
 osu.Desktop/LegacyIpc/LegacyTcpIpcProvider.cs |  1 +
 2 files changed, 14 insertions(+)

diff --git a/osu.Desktop/LegacyIpc/LegacyIpcMessage.cs b/osu.Desktop/LegacyIpc/LegacyIpcMessage.cs
index 6fefae4509..0fa60e2068 100644
--- a/osu.Desktop/LegacyIpc/LegacyIpcMessage.cs
+++ b/osu.Desktop/LegacyIpc/LegacyIpcMessage.cs
@@ -2,11 +2,24 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using osu.Framework.Platform;
+using Newtonsoft.Json.Linq;
 
 namespace osu.Desktop.LegacyIpc
 {
     /// <summary>
     /// An <see cref="IpcMessage"/> that can be used to communicate to and from legacy clients.
+    /// <para>
+    /// In order to deserialise types at either end, types must be serialised as their <see cref="System.Type.AssemblyQualifiedName"/>,
+    /// however this cannot be done since osu!stable and osu!lazer live in two different assemblies.
+    /// <br />
+    /// To get around this, this class exists which serialises a payload (<see cref="LegacyIpcMessage.Data"/>) as an <see cref="System.Object"/> type,
+    /// which can be deserialised at either end because it is part of the core library (mscorlib / System.Private.CorLib).
+    /// The payload contains the data to be sent over the IPC channel.
+    /// <br />
+    /// At either end, Json.NET deserialises the payload into a <see cref="JObject"/> which is manually converted back into the expected <see cref="LegacyIpcMessage.Data"/> type,
+    /// which then further contains another <see cref="JObject"/> representing the data sent over the IPC channel whose type can likewise be lazily matched through
+    /// <see cref="LegacyIpcMessage.Data.MessageType"/>.
+    /// </para>
     /// </summary>
     /// <remarks>
     /// Synchronise any changes with osu-stable.
diff --git a/osu.Desktop/LegacyIpc/LegacyTcpIpcProvider.cs b/osu.Desktop/LegacyIpc/LegacyTcpIpcProvider.cs
index e42a10430a..97a4c57bf0 100644
--- a/osu.Desktop/LegacyIpc/LegacyTcpIpcProvider.cs
+++ b/osu.Desktop/LegacyIpc/LegacyTcpIpcProvider.cs
@@ -36,6 +36,7 @@ namespace osu.Desktop.LegacyIpc
                     logger.Add("Processing legacy IPC message...");
                     logger.Add($"    {msg.Value}", LogLevel.Debug);
 
+                    // See explanation in LegacyIpcMessage for why this is done this way.
                     var legacyData = ((JObject)msg.Value).ToObject<LegacyIpcMessage.Data>();
                     object value = parseObject((JObject)legacyData!.MessageData, legacyData.MessageType);
 

From b3b239c9a138067cfdc6d0907f7194bd959aa959 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 4 Dec 2021 13:57:39 +0100
Subject: [PATCH 1504/5547] Fix test failures due to beatmap lookup logic being
 active even when model is populated

---
 osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
index dae7b611f2..de82c463b3 100644
--- a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
+++ b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
@@ -157,8 +157,11 @@ namespace osu.Game.Screens.OnlinePlay
                             Schedule(() => ownerAvatar.User = foundUser);
                         }
 
-                        var foundBeatmap = await beatmapLookupCache.GetBeatmapAsync(Item.BeatmapID).ConfigureAwait(false);
-                        Schedule(() => Item.Beatmap.Value = foundBeatmap);
+                        if (Item.Beatmap.Value == null)
+                        {
+                            var foundBeatmap = await beatmapLookupCache.GetBeatmapAsync(Item.BeatmapID).ConfigureAwait(false);
+                            Schedule(() => Item.Beatmap.Value = foundBeatmap);
+                        }
                     }
                     catch (Exception e)
                     {

From 85d3b70d8ce096011172daf8a4dede7100aa75a7 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Sat, 4 Dec 2021 22:34:37 +0900
Subject: [PATCH 1505/5547] Update test multiplayer client to match server-side

---
 .../Multiplayer/TestMultiplayerClient.cs       | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
index 024b091bfb..f5f5eebe0f 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
@@ -431,6 +431,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             Debug.Assert(Room != null);
 
             // Add the item to the list first in order to compute gameplay order.
+            item.ID = long.MaxValue;
             serverSidePlaylist.Add(item);
             await updatePlaylistOrder(Room).ConfigureAwait(false);
 
@@ -440,11 +441,9 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
         private async Task updateCurrentItem(MultiplayerRoom room, bool notify = true)
         {
-            MultiplayerPlaylistItem nextItem = serverSidePlaylist
-                                               .Where(i => !i.Expired)
-                                               .OrderBy(i => i.PlaylistOrder)
-                                               .FirstOrDefault()
-                                               ?? room.Playlist.Last();
+            // Pick the next non-expired playlist item by playlist order, or default to the most-recently-expired item.
+            MultiplayerPlaylistItem nextItem = serverSidePlaylist.Where(i => !i.Expired).OrderBy(i => i.PlaylistOrder).FirstOrDefault()
+                                               ?? serverSidePlaylist.OrderByDescending(i => i.PlayedAt).First();
 
             currentIndex = serverSidePlaylist.IndexOf(nextItem);
 
@@ -462,7 +461,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             switch (room.Settings.QueueMode)
             {
                 default:
-                    orderedActiveItems = serverSidePlaylist.Where(item => !item.Expired).OrderBy(item => item.ID == 0 ? int.MaxValue : item.ID).ToList();
+                    orderedActiveItems = serverSidePlaylist.Where(item => !item.Expired).OrderBy(item => item.ID).ToList();
                     break;
 
                 case QueueMode.AllPlayersRoundRobin:
@@ -483,7 +482,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     {
                         MultiplayerPlaylistItem candidateItem = unprocessedItems
                                                                 .OrderBy(item => perUserCounts[item.OwnerID])
-                                                                .ThenBy(item => item.ID == 0 ? int.MaxValue : item.ID)
+                                                                .ThenBy(item => item.ID)
                                                                 .First();
 
                         unprocessedItems.Remove(candidateItem);
@@ -504,8 +503,9 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
                 item.PlaylistOrder = (ushort)i;
 
-                // Items which have an ID of 0 are not in the database, so avoid propagating database/hub events for them.
-                if (item.ID <= 0)
+                // Items which have an "infinite" ID are not yet in the database, so avoid propagating database/hub events for them.
+                // See addItem() for when this occurs.
+                if (item.ID == long.MaxValue)
                     continue;
 
                 await ((IMultiplayerClient)this).PlaylistItemChanged(item).ConfigureAwait(false);

From 16fd7f5a287cf921445f51ae7a587b6ccebe1327 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 4 Dec 2021 14:42:01 +0100
Subject: [PATCH 1506/5547] Simplify slightly redundant assertions

---
 osu.Game.Tests/Database/RulesetStoreTests.cs | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Tests/Database/RulesetStoreTests.cs b/osu.Game.Tests/Database/RulesetStoreTests.cs
index b82dab1874..cc7e8a0c97 100644
--- a/osu.Game.Tests/Database/RulesetStoreTests.cs
+++ b/osu.Game.Tests/Database/RulesetStoreTests.cs
@@ -45,9 +45,9 @@ namespace osu.Game.Tests.Database
             {
                 var rulesets = new RealmRulesetStore(realmFactory, storage);
 
-                Assert.IsTrue(rulesets.AvailableRulesets.First().IsManaged == false);
-                Assert.IsTrue(rulesets.GetRuleset(0)?.IsManaged == false);
-                Assert.IsTrue(rulesets.GetRuleset("mania")?.IsManaged == false);
+                Assert.IsFalse(rulesets.AvailableRulesets.First().IsManaged);
+                Assert.IsFalse(rulesets.GetRuleset(0)?.IsManaged);
+                Assert.IsFalse(rulesets.GetRuleset("mania")?.IsManaged);
             });
         }
     }

From 53a6ef22ceb9122faff7a0b538dbf654246b0da1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 4 Dec 2021 14:55:35 +0100
Subject: [PATCH 1507/5547] Add null check to resolve inspection

---
 .../OnlinePlay/Multiplayer/Participants/ParticipantPanel.cs     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantPanel.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantPanel.cs
index a68309dae5..8fbaebadfe 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantPanel.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantPanel.cs
@@ -187,7 +187,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Participants
             // Todo: Should use the room's selected item to determine ruleset.
             var ruleset = rulesets.GetRuleset(0)?.CreateInstance();
 
-            int? currentModeRank = User.User?.RulesetsStatistics?.GetValueOrDefault(ruleset.ShortName)?.GlobalRank;
+            int? currentModeRank = ruleset != null ? User.User?.RulesetsStatistics?.GetValueOrDefault(ruleset.ShortName)?.GlobalRank : null;
             userRankText.Text = currentModeRank != null ? $"#{currentModeRank.Value:N0}" : string.Empty;
 
             userStateDisplay.UpdateStatus(User.State, User.BeatmapAvailability);

From 054543f58fd8a0ec7641047635d1b8c9d6ff821c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 4 Dec 2021 15:33:02 +0100
Subject: [PATCH 1508/5547] Revert tournament beatmap panel test change with
 comment

---
 .../Components/TestSceneTournamentBeatmapPanel.cs     | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Tournament.Tests/Components/TestSceneTournamentBeatmapPanel.cs b/osu.Game.Tournament.Tests/Components/TestSceneTournamentBeatmapPanel.cs
index 7132655535..b678f69b8f 100644
--- a/osu.Game.Tournament.Tests/Components/TestSceneTournamentBeatmapPanel.cs
+++ b/osu.Game.Tournament.Tests/Components/TestSceneTournamentBeatmapPanel.cs
@@ -3,20 +3,29 @@
 
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
+using osu.Game.Online.API;
 using osu.Game.Online.API.Requests;
 using osu.Game.Online.API.Requests.Responses;
+using osu.Game.Tests.Visual;
 using osu.Game.Tournament.Components;
 
 namespace osu.Game.Tournament.Tests.Components
 {
     public class TestSceneTournamentBeatmapPanel : TournamentTestScene
     {
+        /// <remarks>
+        /// Warning: the below API instance is actually the online API, rather than the dummy API provided by the test.
+        /// It cannot be trivially replaced because setting <see cref="OsuTestScene.UseOnlineAPI"/> to <see langword="true"/> causes <see cref="OsuTestScene.API"/> to no longer be usable.
+        /// </remarks>
+        [Resolved]
+        private IAPIProvider api { get; set; }
+
         [BackgroundDependencyLoader]
         private void load()
         {
             var req = new GetBeatmapRequest(new APIBeatmap { OnlineID = 1091460 });
             req.Success += success;
-            API.Queue(req);
+            api.Queue(req);
         }
 
         private void success(APIBeatmap beatmap)

From ea6766d940f6e4bf2a1510d375bb09f6d6215023 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 4 Dec 2021 16:47:53 +0100
Subject: [PATCH 1509/5547] Add failing test case

---
 .../Formats/LegacyScoreDecoderTest.cs         | 67 +++++++++++++++++++
 1 file changed, 67 insertions(+)

diff --git a/osu.Game.Tests/Beatmaps/Formats/LegacyScoreDecoderTest.cs b/osu.Game.Tests/Beatmaps/Formats/LegacyScoreDecoderTest.cs
index 6e5a546e87..a73ae9dcdb 100644
--- a/osu.Game.Tests/Beatmaps/Formats/LegacyScoreDecoderTest.cs
+++ b/osu.Game.Tests/Beatmaps/Formats/LegacyScoreDecoderTest.cs
@@ -2,14 +2,20 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System.Collections.Generic;
+using System.Globalization;
+using System.IO;
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Utils;
 using osu.Game.Beatmaps;
+using osu.Game.Replays;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Catch;
 using osu.Game.Rulesets.Mania;
 using osu.Game.Rulesets.Osu;
+using osu.Game.Rulesets.Osu.Replays;
+using osu.Game.Rulesets.Osu.UI;
+using osu.Game.Rulesets.Replays;
 using osu.Game.Rulesets.Scoring;
 using osu.Game.Rulesets.Taiko;
 using osu.Game.Scoring;
@@ -21,6 +27,14 @@ namespace osu.Game.Tests.Beatmaps.Formats
     [TestFixture]
     public class LegacyScoreDecoderTest
     {
+        private CultureInfo originalCulture;
+
+        [SetUp]
+        public void SetUp()
+        {
+            originalCulture = CultureInfo.CurrentCulture;
+        }
+
         [Test]
         public void TestDecodeManiaReplay()
         {
@@ -44,6 +58,59 @@ namespace osu.Game.Tests.Beatmaps.Formats
             }
         }
 
+        [Test]
+        public void TestCultureInvariance()
+        {
+            var ruleset = new OsuRuleset().RulesetInfo;
+            var scoreInfo = new TestScoreInfo(ruleset);
+            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)
+                    }
+                }
+            };
+
+            // the "se" culture is used here, as it encodes the negative number sign as U+2212 MINUS SIGN,
+            // rather than the classic ASCII U+002D HYPHEN-MINUS.
+            CultureInfo.CurrentCulture = new CultureInfo("se");
+
+            var encodeStream = new MemoryStream();
+
+            var encoder = new LegacyScoreEncoder(score, beatmap);
+            encoder.Encode(encodeStream);
+
+            var decodeStream = new MemoryStream(encodeStream.GetBuffer());
+
+            var decoder = new TestLegacyScoreDecoder();
+            var decodedAfterEncode = decoder.Parse(decodeStream);
+
+            Assert.Multiple(() =>
+            {
+                Assert.That(decodedAfterEncode, Is.Not.Null);
+
+                Assert.That(decodedAfterEncode.ScoreInfo.User.Username, Is.EqualTo(scoreInfo.User.Username));
+                Assert.That(decodedAfterEncode.ScoreInfo.BeatmapInfoID, Is.EqualTo(scoreInfo.BeatmapInfoID));
+                Assert.That(decodedAfterEncode.ScoreInfo.Ruleset, Is.EqualTo(scoreInfo.Ruleset));
+                Assert.That(decodedAfterEncode.ScoreInfo.TotalScore, Is.EqualTo(scoreInfo.TotalScore));
+                Assert.That(decodedAfterEncode.ScoreInfo.MaxCombo, Is.EqualTo(scoreInfo.MaxCombo));
+                Assert.That(decodedAfterEncode.ScoreInfo.Date, Is.EqualTo(scoreInfo.Date));
+
+                Assert.That(decodedAfterEncode.Replay.Frames.Count, Is.EqualTo(1));
+            });
+        }
+
+        [TearDown]
+        public void TearDown()
+        {
+            CultureInfo.CurrentCulture = originalCulture;
+        }
+
         private class TestLegacyScoreDecoder : LegacyScoreDecoder
         {
             private static readonly Dictionary<int, Ruleset> rulesets = new Ruleset[]

From f051720fa14256b2f7ad46d9f7aacf40ae157a1a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 4 Dec 2021 17:02:39 +0100
Subject: [PATCH 1510/5547] Fix score encoder being dependent on current
 culture

As it turns out, on some cultures, the "negative integer" sign is not
encoded using the U+002D HYPHEN-MINUS codepoint. For instance, Swedish
uses U+2212 MINUS SIGN instead. This was confusing the legacy decoder,
since it is correctly depending on the serialisation being
culture-independent.

To fix, ensure that the special "end replay" frame, as well as the
replay MD5 hash, are generated in a culture-invariant manner.

Thankfully the replay MD5 hash is currently being discarded in
`LegacyScoreDecoder`, so it changing in future scores should not have
any negative effect on lazer operation.
---
 osu.Game/Scoring/Legacy/LegacyScoreEncoder.cs | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Scoring/Legacy/LegacyScoreEncoder.cs b/osu.Game/Scoring/Legacy/LegacyScoreEncoder.cs
index 7b8cacb35b..3d67aa9558 100644
--- a/osu.Game/Scoring/Legacy/LegacyScoreEncoder.cs
+++ b/osu.Game/Scoring/Legacy/LegacyScoreEncoder.cs
@@ -46,7 +46,7 @@ namespace osu.Game.Scoring.Legacy
                 sw.Write(LATEST_VERSION);
                 sw.Write(score.ScoreInfo.BeatmapInfo.MD5Hash);
                 sw.Write(score.ScoreInfo.UserString);
-                sw.Write($"lazer-{score.ScoreInfo.UserString}-{score.ScoreInfo.Date}".ComputeMD5Hash());
+                sw.Write(FormattableString.Invariant($"lazer-{score.ScoreInfo.UserString}-{score.ScoreInfo.Date}").ComputeMD5Hash());
                 sw.Write((ushort)(score.ScoreInfo.GetCount300() ?? 0));
                 sw.Write((ushort)(score.ScoreInfo.GetCount100() ?? 0));
                 sw.Write((ushort)(score.ScoreInfo.GetCount50() ?? 0));
@@ -110,7 +110,9 @@ namespace osu.Game.Scoring.Legacy
                     }
                 }
 
-                replayData.AppendFormat(@"{0}|{1}|{2}|{3},", -12345, 0, 0, 0);
+                // Warning: this is purposefully hardcoded as a string rather than interpolating, as in some cultures the minus sign is not encoded as the standard ASCII U+00C2 codepoint,
+                // which then would break decoding.
+                replayData.Append(@"-12345|0|0|0");
                 return replayData.ToString();
             }
         }

From e1897f9998065b499e758503ecff3d11cbaae880 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 5 Dec 2021 01:38:37 +0900
Subject: [PATCH 1511/5547] Don't debounce `MultiplayerRoomComposite` events

This avoids accidental usage which could result in data being lost or
ignored (as only the last `user` in a single frame would arrive).

This was added specifically to debounce sample playback, but given that
it's only debouncing on a single frame (hardly noticeable) I'm not going
to add back support for that yet. It should be handled by sample
playback concurrency or something more local to the usage.
---
 .../OnlinePlay/Multiplayer/MultiplayerRoomComposite.cs      | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerRoomComposite.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerRoomComposite.cs
index 2f75f09a9f..7d2fe44c4e 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerRoomComposite.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerRoomComposite.cs
@@ -32,9 +32,9 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
         }
 
         private void invokeOnRoomUpdated() => Scheduler.AddOnce(OnRoomUpdated);
-        private void invokeUserJoined(MultiplayerRoomUser user) => Scheduler.AddOnce(UserJoined, user);
-        private void invokeUserKicked(MultiplayerRoomUser user) => Scheduler.AddOnce(UserKicked, user);
-        private void invokeUserLeft(MultiplayerRoomUser user) => Scheduler.AddOnce(UserLeft, user);
+        private void invokeUserJoined(MultiplayerRoomUser user) => Scheduler.Add(() => UserJoined(user));
+        private void invokeUserKicked(MultiplayerRoomUser user) => Scheduler.Add(() => UserKicked(user));
+        private void invokeUserLeft(MultiplayerRoomUser user) => Scheduler.Add(() => UserLeft(user));
         private void invokeItemAdded(MultiplayerPlaylistItem item) => Schedule(() => PlaylistItemAdded(item));
         private void invokeItemRemoved(long item) => Schedule(() => PlaylistItemRemoved(item));
         private void invokeItemChanged(MultiplayerPlaylistItem item) => Schedule(() => PlaylistItemChanged(item));

From 81215b9f0e7b70c2cfbd31bf0345d64e92fa4fc4 Mon Sep 17 00:00:00 2001
From: ColdVolcano <16726733+ColdVolcano@users.noreply.github.com>
Date: Sat, 4 Dec 2021 22:31:55 -0600
Subject: [PATCH 1512/5547] Use correct effect points when
 EarlyActivationMilliseconds is not zero

---
 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 6e4901ab1a..2024d18570 100644
--- a/osu.Game/Graphics/Containers/BeatSyncedContainer.cs
+++ b/osu.Game/Graphics/Containers/BeatSyncedContainer.cs
@@ -111,7 +111,7 @@ namespace osu.Game.Graphics.Containers
             if (clock == null)
                 return;
 
-            double currentTrackTime = clock.CurrentTime;
+            double currentTrackTime = clock.CurrentTime + EarlyActivationMilliseconds;
 
             if (Beatmap.Value.TrackLoaded && Beatmap.Value.BeatmapLoaded)
             {
@@ -132,13 +132,11 @@ namespace osu.Game.Graphics.Containers
             {
                 // this may be the case where the beat syncing clock has been paused.
                 // we still want to show an idle animation, so use this container's time instead.
-                currentTrackTime = Clock.CurrentTime;
+                currentTrackTime = Clock.CurrentTime + EarlyActivationMilliseconds;
                 timingPoint = TimingControlPoint.DEFAULT;
                 effectPoint = EffectControlPoint.DEFAULT;
             }
 
-            currentTrackTime += EarlyActivationMilliseconds;
-
             double beatLength = timingPoint.BeatLength / Divisor;
 
             while (beatLength < MinimumBeatLength)

From 86c908c657db4771840435887c69964cdbfeb9d3 Mon Sep 17 00:00:00 2001
From: ColdVolcano <16726733+ColdVolcano@users.noreply.github.com>
Date: Sun, 5 Dec 2021 03:53:36 -0600
Subject: [PATCH 1513/5547] Add test coverage

---
 .../TestSceneBeatSyncedContainer.cs           | 35 +++++++++++++++++++
 1 file changed, 35 insertions(+)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneBeatSyncedContainer.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneBeatSyncedContainer.cs
index e5bcc08924..ede89c6096 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneBeatSyncedContainer.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneBeatSyncedContainer.cs
@@ -135,6 +135,35 @@ namespace osu.Game.Tests.Visual.UserInterface
             AddAssert("bpm is default", () => lastBpm != null && Precision.AlmostEquals(lastBpm.Value, 60));
         }
 
+        [TestCase(true)]
+        [TestCase(false)]
+        public void TestEarlyActivationEffectPoint(bool earlyActivating)
+        {
+            double earlyActivationMilliseconds = earlyActivating ? 100 : 0;
+            ControlPoint actualEffectPoint = null;
+
+            AddStep($"set early activation to {earlyActivationMilliseconds}", () => beatContainer.EarlyActivationMilliseconds = earlyActivationMilliseconds);
+
+            AddStep("seek before kiai effect point", () =>
+            {
+                ControlPoint expectedEffectPoint = Beatmap.Value.Beatmap.ControlPointInfo.EffectPoints.First(ep => ep.KiaiMode);
+                actualEffectPoint = null;
+                beatContainer.AllowMistimedEventFiring = false;
+
+                beatContainer.NewBeat = (i, timingControlPoint, effectControlPoint, channelAmplitudes) =>
+                {
+                    if (Precision.AlmostEquals(gameplayClockContainer.CurrentTime + earlyActivationMilliseconds, expectedEffectPoint.Time, BeatSyncedContainer.MISTIMED_ALLOWANCE))
+                        actualEffectPoint = effectControlPoint;
+                };
+
+                gameplayClockContainer.Seek(expectedEffectPoint.Time - earlyActivationMilliseconds);
+            });
+
+            AddUntilStep("wait for effect point", () => actualEffectPoint != null);
+
+            AddAssert("effect has kiai", () => actualEffectPoint != null && ((EffectControlPoint)actualEffectPoint).KiaiMode);
+        }
+
         private class TestBeatSyncedContainer : BeatSyncedContainer
         {
             private const int flash_layer_height = 150;
@@ -145,6 +174,12 @@ namespace osu.Game.Tests.Visual.UserInterface
                 set => base.AllowMistimedEventFiring = value;
             }
 
+            public new double EarlyActivationMilliseconds
+            {
+                get => base.EarlyActivationMilliseconds;
+                set => base.EarlyActivationMilliseconds = value;
+            }
+
             private readonly InfoString timingPointCount;
             private readonly InfoString currentTimingPoint;
             private readonly InfoString beatCount;

From a07f8c74dc454de38c1ca4b54323e29345747bb2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 5 Dec 2021 15:04:44 +0100
Subject: [PATCH 1514/5547] Add basic structure for composable card dropdown

---
 .../Visual/Beatmaps/TestSceneBeatmapCard.cs   |  10 +-
 .../Beatmaps/Drawables/Cards/BeatmapCard.cs   | 413 +++++++++---------
 .../Drawables/Cards/BeatmapCardDropdown.cs    |  85 ++++
 3 files changed, 307 insertions(+), 201 deletions(-)
 create mode 100644 osu.Game/Beatmaps/Drawables/Cards/BeatmapCardDropdown.cs

diff --git a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs
index 5effc1f215..d3ce5028b7 100644
--- a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs
+++ b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs
@@ -12,6 +12,7 @@ using osu.Framework.Graphics.Shapes;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.Drawables.Cards;
+using osu.Game.Graphics.Containers;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests;
 using osu.Game.Online.API.Requests.Responses;
@@ -227,7 +228,7 @@ namespace osu.Game.Tests.Visual.Beatmaps
                     new BasicScrollContainer
                     {
                         RelativeSizeAxes = Axes.Both,
-                        Child = new FillFlowContainer
+                        Child = new ReverseChildIDFillFlowContainer<Drawable>
                         {
                             RelativeSizeAxes = Axes.X,
                             AutoSizeAxes = Axes.Y,
@@ -248,6 +249,11 @@ namespace osu.Game.Tests.Visual.Beatmaps
         }
 
         [Test]
-        public void TestNormal() => createTestCase(beatmapSetInfo => new BeatmapCard(beatmapSetInfo));
+        public void TestNormal()
+        {
+            createTestCase(beatmapSetInfo => new BeatmapCard(beatmapSetInfo));
+
+            AddToggleStep("toggle expanded state", expanded => this.ChildrenOfType<BeatmapCard>().Last().Expanded.Value = expanded);
+        }
     }
 }
diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
index 37c1bacda4..46ee9afb86 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
@@ -31,10 +31,12 @@ namespace osu.Game.Beatmaps.Drawables.Cards
     public class BeatmapCard : OsuClickableContainer
     {
         public const float TRANSITION_DURATION = 400;
+        public const float CORNER_RADIUS = 10;
+
+        public Bindable<bool> Expanded { get; } = new BindableBool();
 
         private const float width = 408;
         private const float height = 100;
-        private const float corner_radius = 10;
         private const float icon_area_width = 30;
 
         private readonly APIBeatmapSet beatmapSet;
@@ -73,242 +75,255 @@ namespace osu.Game.Beatmaps.Drawables.Cards
         {
             Width = width;
             Height = height;
-            CornerRadius = corner_radius;
-            Masking = true;
 
             FillFlowContainer leftIconArea;
             GridContainer titleContainer;
             GridContainer artistContainer;
 
-            InternalChildren = new Drawable[]
+            InternalChild = new BeatmapCardDropdown(height)
             {
-                downloadTracker,
-                rightAreaBackground = new Container
+                Body = new Container
                 {
-                    RelativeSizeAxes = Axes.Y,
-                    Width = icon_area_width + 2 * corner_radius,
-                    Anchor = Anchor.CentreRight,
-                    Origin = Anchor.CentreRight,
-                    // workaround for masking artifacts at the top & bottom of card,
-                    // which become especially visible on downloaded beatmaps (when the icon area has a lime background).
-                    Padding = new MarginPadding { Vertical = 1 },
-                    Child = new Box
-                    {
-                        RelativeSizeAxes = Axes.Both,
-                        Colour = Colour4.White
-                    },
-                },
-                thumbnail = new BeatmapCardThumbnail(beatmapSet)
-                {
-                    Name = @"Left (icon) area",
-                    Size = new Vector2(height),
-                    Padding = new MarginPadding { Right = corner_radius },
-                    Child = leftIconArea = new FillFlowContainer
-                    {
-                        Margin = new MarginPadding(5),
-                        AutoSizeAxes = Axes.Both,
-                        Direction = FillDirection.Horizontal,
-                        Spacing = new Vector2(1)
-                    }
-                },
-                new Container
-                {
-                    Name = @"Right (button) area",
-                    Width = 30,
-                    RelativeSizeAxes = Axes.Y,
-                    Origin = Anchor.TopRight,
-                    Anchor = Anchor.TopRight,
-                    Padding = new MarginPadding { Vertical = 17.5f },
-                    Child = rightAreaButtons = new Container<BeatmapCardIconButton>
-                    {
-                        RelativeSizeAxes = Axes.Both,
-                        Children = new BeatmapCardIconButton[]
-                        {
-                            new FavouriteButton(beatmapSet)
-                            {
-                                Current = favouriteState,
-                                Anchor = Anchor.TopCentre,
-                                Origin = Anchor.TopCentre
-                            },
-                            new DownloadButton(beatmapSet)
-                            {
-                                Anchor = Anchor.BottomCentre,
-                                Origin = Anchor.BottomCentre,
-                                State = { BindTarget = downloadTracker.State }
-                            },
-                            new GoToBeatmapButton(beatmapSet)
-                            {
-                                Anchor = Anchor.BottomCentre,
-                                Origin = Anchor.BottomCentre,
-                                State = { BindTarget = downloadTracker.State }
-                            }
-                        }
-                    }
-                },
-                mainContent = new Container
-                {
-                    Name = @"Main content",
-                    X = height - corner_radius,
-                    Height = height,
-                    CornerRadius = corner_radius,
-                    Masking = true,
+                    RelativeSizeAxes = Axes.Both,
                     Children = new Drawable[]
                     {
-                        mainContentBackground = new BeatmapCardContentBackground(beatmapSet)
+                        downloadTracker,
+                        rightAreaBackground = new Container
                         {
-                            RelativeSizeAxes = Axes.Both,
-                        },
-                        new FillFlowContainer
-                        {
-                            RelativeSizeAxes = Axes.Both,
-                            Padding = new MarginPadding
+                            RelativeSizeAxes = Axes.Y,
+                            Width = icon_area_width + 2 * CORNER_RADIUS,
+                            Anchor = Anchor.CentreRight,
+                            Origin = Anchor.CentreRight,
+                            // workaround for masking artifacts at the top & bottom of card,
+                            // which become especially visible on downloaded beatmaps (when the icon area has a lime background).
+                            Padding = new MarginPadding { Vertical = 1 },
+                            Child = new Box
                             {
-                                Horizontal = 10,
-                                Vertical = 4
+                                RelativeSizeAxes = Axes.Both,
+                                Colour = Colour4.White
                             },
-                            Direction = FillDirection.Vertical,
-                            Children = new Drawable[]
+                        },
+                        thumbnail = new BeatmapCardThumbnail(beatmapSet)
+                        {
+                            Name = @"Left (icon) area",
+                            Size = new Vector2(height),
+                            Padding = new MarginPadding { Right = CORNER_RADIUS },
+                            Child = leftIconArea = new FillFlowContainer
                             {
-                                titleContainer = new GridContainer
-                                {
-                                    RelativeSizeAxes = Axes.X,
-                                    AutoSizeAxes = Axes.Y,
-                                    ColumnDimensions = new[]
-                                    {
-                                        new Dimension(),
-                                        new Dimension(GridSizeMode.AutoSize)
-                                    },
-                                    RowDimensions = new[]
-                                    {
-                                        new Dimension(GridSizeMode.AutoSize)
-                                    },
-                                    Content = new[]
-                                    {
-                                        new[]
-                                        {
-                                            new OsuSpriteText
-                                            {
-                                                Text = new RomanisableString(beatmapSet.TitleUnicode, beatmapSet.Title),
-                                                Font = OsuFont.Default.With(size: 22.5f, weight: FontWeight.SemiBold),
-                                                RelativeSizeAxes = Axes.X,
-                                                Truncate = true
-                                            },
-                                            Empty()
-                                        }
-                                    }
-                                },
-                                artistContainer = new GridContainer
-                                {
-                                    RelativeSizeAxes = Axes.X,
-                                    AutoSizeAxes = Axes.Y,
-                                    ColumnDimensions = new[]
-                                    {
-                                        new Dimension(),
-                                        new Dimension(GridSizeMode.AutoSize)
-                                    },
-                                    RowDimensions = new[]
-                                    {
-                                        new Dimension(GridSizeMode.AutoSize)
-                                    },
-                                    Content = new[]
-                                    {
-                                        new[]
-                                        {
-                                            new OsuSpriteText
-                                            {
-                                                Text = createArtistText(),
-                                                Font = OsuFont.Default.With(size: 17.5f, weight: FontWeight.SemiBold),
-                                                RelativeSizeAxes = Axes.X,
-                                                Truncate = true
-                                            },
-                                            Empty()
-                                        },
-                                    }
-                                },
-                                new LinkFlowContainer(s =>
-                                {
-                                    s.Shadow = false;
-                                    s.Font = OsuFont.GetFont(size: 14, weight: FontWeight.SemiBold);
-                                }).With(d =>
-                                {
-                                    d.AutoSizeAxes = Axes.Both;
-                                    d.Margin = new MarginPadding { Top = 2 };
-                                    d.AddText("mapped by ", t => t.Colour = colourProvider.Content2);
-                                    d.AddUserLink(beatmapSet.Author);
-                                }),
+                                Margin = new MarginPadding(5),
+                                AutoSizeAxes = Axes.Both,
+                                Direction = FillDirection.Horizontal,
+                                Spacing = new Vector2(1)
                             }
                         },
                         new Container
                         {
-                            Name = @"Bottom content",
-                            RelativeSizeAxes = Axes.X,
-                            AutoSizeAxes = Axes.Y,
-                            Anchor = Anchor.BottomLeft,
-                            Origin = Anchor.BottomLeft,
-                            Padding = new MarginPadding
+                            Name = @"Right (button) area",
+                            Width = 30,
+                            RelativeSizeAxes = Axes.Y,
+                            Origin = Anchor.TopRight,
+                            Anchor = Anchor.TopRight,
+                            Padding = new MarginPadding { Vertical = 17.5f },
+                            Child = rightAreaButtons = new Container<BeatmapCardIconButton>
                             {
-                                Horizontal = 10,
-                                Vertical = 4
-                            },
+                                RelativeSizeAxes = Axes.Both,
+                                Children = new BeatmapCardIconButton[]
+                                {
+                                    new FavouriteButton(beatmapSet)
+                                    {
+                                        Current = favouriteState,
+                                        Anchor = Anchor.TopCentre,
+                                        Origin = Anchor.TopCentre
+                                    },
+                                    new DownloadButton(beatmapSet)
+                                    {
+                                        Anchor = Anchor.BottomCentre,
+                                        Origin = Anchor.BottomCentre,
+                                        State = { BindTarget = downloadTracker.State }
+                                    },
+                                    new GoToBeatmapButton(beatmapSet)
+                                    {
+                                        Anchor = Anchor.BottomCentre,
+                                        Origin = Anchor.BottomCentre,
+                                        State = { BindTarget = downloadTracker.State }
+                                    }
+                                }
+                            }
+                        },
+                        mainContent = new Container
+                        {
+                            Name = @"Main content",
+                            X = height - CORNER_RADIUS,
+                            Height = height,
+                            CornerRadius = CORNER_RADIUS,
+                            Masking = true,
                             Children = new Drawable[]
                             {
-                                idleBottomContent = new FillFlowContainer
+                                mainContentBackground = new BeatmapCardContentBackground(beatmapSet)
                                 {
-                                    RelativeSizeAxes = Axes.X,
-                                    AutoSizeAxes = Axes.Y,
+                                    RelativeSizeAxes = Axes.Both,
+                                },
+                                new FillFlowContainer
+                                {
+                                    RelativeSizeAxes = Axes.Both,
+                                    Padding = new MarginPadding
+                                    {
+                                        Horizontal = 10,
+                                        Vertical = 4
+                                    },
                                     Direction = FillDirection.Vertical,
-                                    Spacing = new Vector2(0, 3),
-                                    AlwaysPresent = true,
                                     Children = new Drawable[]
                                     {
-                                        statisticsContainer = new FillFlowContainer<BeatmapCardStatistic>
+                                        titleContainer = new GridContainer
                                         {
                                             RelativeSizeAxes = Axes.X,
                                             AutoSizeAxes = Axes.Y,
-                                            Direction = FillDirection.Horizontal,
-                                            Spacing = new Vector2(10, 0),
-                                            Alpha = 0,
-                                            AlwaysPresent = true,
-                                            ChildrenEnumerable = createStatistics()
-                                        },
-                                        new FillFlowContainer
-                                        {
-                                            RelativeSizeAxes = Axes.X,
-                                            AutoSizeAxes = Axes.Y,
-                                            Direction = FillDirection.Horizontal,
-                                            Spacing = new Vector2(4, 0),
-                                            Children = new Drawable[]
+                                            ColumnDimensions = new[]
                                             {
-                                                new BeatmapSetOnlineStatusPill
+                                                new Dimension(),
+                                                new Dimension(GridSizeMode.AutoSize)
+                                            },
+                                            RowDimensions = new[]
+                                            {
+                                                new Dimension(GridSizeMode.AutoSize)
+                                            },
+                                            Content = new[]
+                                            {
+                                                new[]
                                                 {
-                                                    AutoSizeAxes = Axes.Both,
-                                                    Status = beatmapSet.Status,
-                                                    Anchor = Anchor.CentreLeft,
-                                                    Origin = Anchor.CentreLeft
-                                                },
-                                                new DifficultySpectrumDisplay(beatmapSet)
-                                                {
-                                                    Anchor = Anchor.CentreLeft,
-                                                    Origin = Anchor.CentreLeft,
-                                                    DotSize = new Vector2(6, 12)
+                                                    new OsuSpriteText
+                                                    {
+                                                        Text = new RomanisableString(beatmapSet.TitleUnicode, beatmapSet.Title),
+                                                        Font = OsuFont.Default.With(size: 22.5f, weight: FontWeight.SemiBold),
+                                                        RelativeSizeAxes = Axes.X,
+                                                        Truncate = true
+                                                    },
+                                                    Empty()
                                                 }
                                             }
-                                        }
+                                        },
+                                        artistContainer = new GridContainer
+                                        {
+                                            RelativeSizeAxes = Axes.X,
+                                            AutoSizeAxes = Axes.Y,
+                                            ColumnDimensions = new[]
+                                            {
+                                                new Dimension(),
+                                                new Dimension(GridSizeMode.AutoSize)
+                                            },
+                                            RowDimensions = new[]
+                                            {
+                                                new Dimension(GridSizeMode.AutoSize)
+                                            },
+                                            Content = new[]
+                                            {
+                                                new[]
+                                                {
+                                                    new OsuSpriteText
+                                                    {
+                                                        Text = createArtistText(),
+                                                        Font = OsuFont.Default.With(size: 17.5f, weight: FontWeight.SemiBold),
+                                                        RelativeSizeAxes = Axes.X,
+                                                        Truncate = true
+                                                    },
+                                                    Empty()
+                                                },
+                                            }
+                                        },
+                                        new LinkFlowContainer(s =>
+                                        {
+                                            s.Shadow = false;
+                                            s.Font = OsuFont.GetFont(size: 14, weight: FontWeight.SemiBold);
+                                        }).With(d =>
+                                        {
+                                            d.AutoSizeAxes = Axes.Both;
+                                            d.Margin = new MarginPadding { Top = 2 };
+                                            d.AddText("mapped by ", t => t.Colour = colourProvider.Content2);
+                                            d.AddUserLink(beatmapSet.Author);
+                                        }),
                                     }
                                 },
-                                downloadProgressBar = new BeatmapCardDownloadProgressBar
+                                new Container
                                 {
+                                    Name = @"Bottom content",
                                     RelativeSizeAxes = Axes.X,
-                                    Height = 6,
-                                    Anchor = Anchor.Centre,
-                                    Origin = Anchor.Centre,
-                                    State = { BindTarget = downloadTracker.State },
-                                    Progress = { BindTarget = downloadTracker.Progress }
+                                    AutoSizeAxes = Axes.Y,
+                                    Anchor = Anchor.BottomLeft,
+                                    Origin = Anchor.BottomLeft,
+                                    Padding = new MarginPadding
+                                    {
+                                        Horizontal = 10,
+                                        Vertical = 4
+                                    },
+                                    Children = new Drawable[]
+                                    {
+                                        idleBottomContent = new FillFlowContainer
+                                        {
+                                            RelativeSizeAxes = Axes.X,
+                                            AutoSizeAxes = Axes.Y,
+                                            Direction = FillDirection.Vertical,
+                                            Spacing = new Vector2(0, 3),
+                                            AlwaysPresent = true,
+                                            Children = new Drawable[]
+                                            {
+                                                statisticsContainer = new FillFlowContainer<BeatmapCardStatistic>
+                                                {
+                                                    RelativeSizeAxes = Axes.X,
+                                                    AutoSizeAxes = Axes.Y,
+                                                    Direction = FillDirection.Horizontal,
+                                                    Spacing = new Vector2(10, 0),
+                                                    Alpha = 0,
+                                                    AlwaysPresent = true,
+                                                    ChildrenEnumerable = createStatistics()
+                                                },
+                                                new FillFlowContainer
+                                                {
+                                                    RelativeSizeAxes = Axes.X,
+                                                    AutoSizeAxes = Axes.Y,
+                                                    Direction = FillDirection.Horizontal,
+                                                    Spacing = new Vector2(4, 0),
+                                                    Children = new Drawable[]
+                                                    {
+                                                        new BeatmapSetOnlineStatusPill
+                                                        {
+                                                            AutoSizeAxes = Axes.Both,
+                                                            Status = beatmapSet.Status,
+                                                            Anchor = Anchor.CentreLeft,
+                                                            Origin = Anchor.CentreLeft
+                                                        },
+                                                        new DifficultySpectrumDisplay(beatmapSet)
+                                                        {
+                                                            Anchor = Anchor.CentreLeft,
+                                                            Origin = Anchor.CentreLeft,
+                                                            DotSize = new Vector2(6, 12)
+                                                        }
+                                                    }
+                                                }
+                                            }
+                                        },
+                                        downloadProgressBar = new BeatmapCardDownloadProgressBar
+                                        {
+                                            RelativeSizeAxes = Axes.X,
+                                            Height = 6,
+                                            Anchor = Anchor.Centre,
+                                            Origin = Anchor.Centre,
+                                            State = { BindTarget = downloadTracker.State },
+                                            Progress = { BindTarget = downloadTracker.Progress }
+                                        }
+                                    }
                                 }
                             }
                         }
                     }
-                }
+                },
+                Dropdown = new Container
+                {
+                    RelativeSizeAxes = Axes.X,
+                    AutoSizeAxes = Axes.Y,
+                    Padding = new MarginPadding { Horizontal = 10, Vertical = 13 },
+                    Child = new BeatmapCardDifficultyList(beatmapSet)
+                },
+                Expanded = { BindTarget = Expanded }
             };
 
             if (beatmapSet.HasVideo)
@@ -388,7 +403,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
         {
             float targetWidth = width - height;
             if (IsHovered)
-                targetWidth = targetWidth - icon_area_width + corner_radius;
+                targetWidth = targetWidth - icon_area_width + CORNER_RADIUS;
 
             thumbnail.Dimmed.Value = IsHovered;
 
diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardDropdown.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardDropdown.cs
new file mode 100644
index 0000000000..29f12de947
--- /dev/null
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardDropdown.cs
@@ -0,0 +1,85 @@
+// 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.Shapes;
+using osu.Game.Overlays;
+
+namespace osu.Game.Beatmaps.Drawables.Cards
+{
+    public class BeatmapCardDropdown : CompositeDrawable
+    {
+        public Drawable Body
+        {
+            set => bodyContent.Child = value;
+        }
+
+        public Drawable Dropdown
+        {
+            set => dropdownContent.Child = value;
+        }
+
+        public Bindable<bool> Expanded { get; } = new BindableBool();
+
+        private readonly Box background;
+        private readonly Container bodyContent;
+        private readonly Container dropdownContent;
+
+        public BeatmapCardDropdown(float height)
+        {
+            RelativeSizeAxes = Axes.X;
+            Height = height;
+
+            InternalChild = new Container
+            {
+                RelativeSizeAxes = Axes.X,
+                AutoSizeAxes = Axes.Y,
+                CornerRadius = BeatmapCard.CORNER_RADIUS,
+                Masking = true,
+
+                Children = new Drawable[]
+                {
+                    background = new Box
+                    {
+                        RelativeSizeAxes = Axes.Both
+                    },
+                    bodyContent = new Container
+                    {
+                        RelativeSizeAxes = Axes.X,
+                        Height = height,
+                        CornerRadius = BeatmapCard.CORNER_RADIUS,
+                        Masking = true,
+                    },
+                    dropdownContent = new Container
+                    {
+                        RelativeSizeAxes = Axes.X,
+                        AutoSizeAxes = Axes.Y,
+                        Margin = new MarginPadding { Top = height },
+                        Alpha = 0
+                    }
+                }
+            };
+        }
+
+        [BackgroundDependencyLoader]
+        private void load(OverlayColourProvider colourProvider)
+        {
+            background.Colour = colourProvider.Background2;
+        }
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+            Expanded.BindValueChanged(_ => updateState());
+        }
+
+        private void updateState()
+        {
+            background.FadeTo(Expanded.Value ? 1 : 0, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
+            dropdownContent.FadeTo(Expanded.Value ? 1 : 0, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
+        }
+    }
+}

From 3fea8d5e62e709ce46bc480e32dc10b33c6c251f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 5 Dec 2021 15:48:02 +0100
Subject: [PATCH 1515/5547] Implement visual behaviour of expanded card state

---
 .../Beatmaps/Drawables/Cards/BeatmapCard.cs   | 15 +++++----
 .../Drawables/Cards/BeatmapCardDropdown.cs    | 33 +++++++++++++++++--
 2 files changed, 40 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
index 46ee9afb86..f0425794be 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
@@ -359,7 +359,8 @@ namespace osu.Game.Beatmaps.Drawables.Cards
         {
             base.LoadComplete();
 
-            downloadTracker.State.BindValueChanged(_ => updateState(), true);
+            downloadTracker.State.BindValueChanged(_ => updateState());
+            Expanded.BindValueChanged(_ => updateState(), true);
             FinishTransforms(true);
         }
 
@@ -401,19 +402,21 @@ namespace osu.Game.Beatmaps.Drawables.Cards
 
         private void updateState()
         {
+            bool showDetails = IsHovered || Expanded.Value;
+
             float targetWidth = width - height;
-            if (IsHovered)
+            if (showDetails)
                 targetWidth = targetWidth - icon_area_width + CORNER_RADIUS;
 
-            thumbnail.Dimmed.Value = IsHovered;
+            thumbnail.Dimmed.Value = showDetails;
 
             mainContent.ResizeWidthTo(targetWidth, TRANSITION_DURATION, Easing.OutQuint);
-            mainContentBackground.Dimmed.Value = IsHovered;
+            mainContentBackground.Dimmed.Value = showDetails;
 
-            statisticsContainer.FadeTo(IsHovered ? 1 : 0, TRANSITION_DURATION, Easing.OutQuint);
+            statisticsContainer.FadeTo(showDetails ? 1 : 0, TRANSITION_DURATION, Easing.OutQuint);
 
             rightAreaBackground.FadeColour(downloadTracker.State.Value == DownloadState.LocallyAvailable ? colours.Lime0 : colourProvider.Background3, TRANSITION_DURATION, Easing.OutQuint);
-            rightAreaButtons.FadeTo(IsHovered ? 1 : 0, TRANSITION_DURATION, Easing.OutQuint);
+            rightAreaButtons.FadeTo(showDetails ? 1 : 0, TRANSITION_DURATION, Easing.OutQuint);
 
             foreach (var button in rightAreaButtons)
             {
diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardDropdown.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardDropdown.cs
index 29f12de947..877338ecb0 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardDropdown.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardDropdown.cs
@@ -5,8 +5,10 @@ using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.Effects;
 using osu.Framework.Graphics.Shapes;
 using osu.Game.Overlays;
+using osuTK;
 
 namespace osu.Game.Beatmaps.Drawables.Cards
 {
@@ -25,15 +27,17 @@ namespace osu.Game.Beatmaps.Drawables.Cards
         public Bindable<bool> Expanded { get; } = new BindableBool();
 
         private readonly Box background;
+        private readonly Container content;
         private readonly Container bodyContent;
         private readonly Container dropdownContent;
+        private readonly Container borderContainer;
 
         public BeatmapCardDropdown(float height)
         {
             RelativeSizeAxes = Axes.X;
             Height = height;
 
-            InternalChild = new Container
+            InternalChild = content = new Container
             {
                 RelativeSizeAxes = Axes.X,
                 AutoSizeAxes = Axes.Y,
@@ -59,6 +63,19 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                         AutoSizeAxes = Axes.Y,
                         Margin = new MarginPadding { Top = height },
                         Alpha = 0
+                    },
+                    borderContainer = new Container
+                    {
+                        RelativeSizeAxes = Axes.Both,
+                        CornerRadius = BeatmapCard.CORNER_RADIUS,
+                        Masking = true,
+                        BorderThickness = 3,
+                        Child = new Box
+                        {
+                            RelativeSizeAxes = Axes.Both,
+                            Alpha = 0,
+                            AlwaysPresent = true
+                        }
                     }
                 }
             };
@@ -68,18 +85,30 @@ namespace osu.Game.Beatmaps.Drawables.Cards
         private void load(OverlayColourProvider colourProvider)
         {
             background.Colour = colourProvider.Background2;
+            borderContainer.BorderColour = colourProvider.Highlight1;
         }
 
         protected override void LoadComplete()
         {
             base.LoadComplete();
-            Expanded.BindValueChanged(_ => updateState());
+            Expanded.BindValueChanged(_ => updateState(), true);
+            FinishTransforms(true);
         }
 
         private void updateState()
         {
             background.FadeTo(Expanded.Value ? 1 : 0, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
             dropdownContent.FadeTo(Expanded.Value ? 1 : 0, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
+            borderContainer.FadeTo(Expanded.Value ? 1 : 0, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
+
+            content.TweenEdgeEffectTo(new EdgeEffectParameters
+            {
+                Type = EdgeEffectType.Shadow,
+                Offset = new Vector2(0, 2),
+                Radius = 10,
+                Colour = Colour4.Black.Opacity(Expanded.Value ? 0.3f : 0f),
+                Hollow = true,
+            }, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
         }
     }
 }

From 250e5b47b7b1f9e7c50c0f552529f9b0bc47b4a0 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 28 Nov 2021 20:25:23 +0100
Subject: [PATCH 1516/5547] Move "extra info" beatmap card row to separate
 component

---
 .../Beatmaps/Drawables/Cards/BeatmapCard.cs   | 24 +----------
 .../Cards/BeatmapCardExtraInfoRow.cs          | 43 +++++++++++++++++++
 2 files changed, 44 insertions(+), 23 deletions(-)
 create mode 100644 osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtraInfoRow.cs

diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
index f0425794be..1a05607074 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
@@ -276,29 +276,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                                                     AlwaysPresent = true,
                                                     ChildrenEnumerable = createStatistics()
                                                 },
-                                                new FillFlowContainer
-                                                {
-                                                    RelativeSizeAxes = Axes.X,
-                                                    AutoSizeAxes = Axes.Y,
-                                                    Direction = FillDirection.Horizontal,
-                                                    Spacing = new Vector2(4, 0),
-                                                    Children = new Drawable[]
-                                                    {
-                                                        new BeatmapSetOnlineStatusPill
-                                                        {
-                                                            AutoSizeAxes = Axes.Both,
-                                                            Status = beatmapSet.Status,
-                                                            Anchor = Anchor.CentreLeft,
-                                                            Origin = Anchor.CentreLeft
-                                                        },
-                                                        new DifficultySpectrumDisplay(beatmapSet)
-                                                        {
-                                                            Anchor = Anchor.CentreLeft,
-                                                            Origin = Anchor.CentreLeft,
-                                                            DotSize = new Vector2(6, 12)
-                                                        }
-                                                    }
-                                                }
+                                                new BeatmapCardExtraInfoRow(beatmapSet)
                                             }
                                         },
                                         downloadProgressBar = new BeatmapCardDownloadProgressBar
diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtraInfoRow.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtraInfoRow.cs
new file mode 100644
index 0000000000..c64e5b83d8
--- /dev/null
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtraInfoRow.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 osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
+using osu.Game.Online.API.Requests.Responses;
+using osuTK;
+
+namespace osu.Game.Beatmaps.Drawables.Cards
+{
+    public class BeatmapCardExtraInfoRow : CompositeDrawable
+    {
+        public BeatmapCardExtraInfoRow(APIBeatmapSet beatmapSet)
+        {
+            RelativeSizeAxes = Axes.X;
+            AutoSizeAxes = Axes.Y;
+
+            InternalChild = new FillFlowContainer
+            {
+                RelativeSizeAxes = Axes.X,
+                AutoSizeAxes = Axes.Y,
+                Direction = FillDirection.Horizontal,
+                Spacing = new Vector2(4, 0),
+                Children = new Drawable[]
+                {
+                    new BeatmapSetOnlineStatusPill
+                    {
+                        AutoSizeAxes = Axes.Both,
+                        Status = beatmapSet.Status,
+                        Anchor = Anchor.CentreLeft,
+                        Origin = Anchor.CentreLeft
+                    },
+                    new DifficultySpectrumDisplay(beatmapSet)
+                    {
+                        Anchor = Anchor.CentreLeft,
+                        Origin = Anchor.CentreLeft,
+                        DotSize = new Vector2(6, 12)
+                    }
+                }
+            };
+        }
+    }
+}

From e451e43b9022542bc28c6f96e2263c44b27a1213 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 5 Dec 2021 16:31:45 +0100
Subject: [PATCH 1517/5547] Implement input handling behaviour of beatmap card
 dropdown

---
 .../Beatmaps/Drawables/Cards/BeatmapCard.cs   | 12 ++++-
 .../Drawables/Cards/BeatmapCardDropdown.cs    | 52 +++++++++++++++++--
 .../Cards/BeatmapCardExtraInfoRow.cs          |  4 +-
 .../Drawables/Cards/HoverHandlingContainer.cs | 27 ++++++++++
 4 files changed, 88 insertions(+), 7 deletions(-)
 create mode 100644 osu.Game/Beatmaps/Drawables/Cards/HoverHandlingContainer.cs

diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
index 1a05607074..2ab77539b3 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
@@ -44,6 +44,8 @@ namespace osu.Game.Beatmaps.Drawables.Cards
 
         private readonly BeatmapDownloadTracker downloadTracker;
 
+        private BeatmapCardDropdown dropdown = null!;
+
         private BeatmapCardThumbnail thumbnail = null!;
 
         private Container rightAreaBackground = null!;
@@ -80,7 +82,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
             GridContainer titleContainer;
             GridContainer artistContainer;
 
-            InternalChild = new BeatmapCardDropdown(height)
+            InternalChild = dropdown = new BeatmapCardDropdown(height)
             {
                 Body = new Container
                 {
@@ -277,6 +279,14 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                                                     ChildrenEnumerable = createStatistics()
                                                 },
                                                 new BeatmapCardExtraInfoRow(beatmapSet)
+                                                {
+                                                    Hovered = _ =>
+                                                    {
+                                                        dropdown.ScheduleShow();
+                                                        return false;
+                                                    },
+                                                    Unhovered = _ => dropdown.ScheduleHide()
+                                                }
                                             }
                                         },
                                         downloadProgressBar = new BeatmapCardDownloadProgressBar
diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardDropdown.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardDropdown.cs
index 877338ecb0..ef4ba67ab7 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardDropdown.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardDropdown.cs
@@ -1,12 +1,15 @@
 // 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 enable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Effects;
 using osu.Framework.Graphics.Shapes;
+using osu.Framework.Threading;
 using osu.Game.Overlays;
 using osuTK;
 
@@ -37,13 +40,13 @@ namespace osu.Game.Beatmaps.Drawables.Cards
             RelativeSizeAxes = Axes.X;
             Height = height;
 
-            InternalChild = content = new Container
+            InternalChild = content = new HoverHandlingContainer
             {
                 RelativeSizeAxes = Axes.X,
                 AutoSizeAxes = Axes.Y,
                 CornerRadius = BeatmapCard.CORNER_RADIUS,
                 Masking = true,
-
+                Unhovered = _ => checkForHide(),
                 Children = new Drawable[]
                 {
                     background = new Box
@@ -57,12 +60,18 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                         CornerRadius = BeatmapCard.CORNER_RADIUS,
                         Masking = true,
                     },
-                    dropdownContent = new Container
+                    dropdownContent = new HoverHandlingContainer
                     {
                         RelativeSizeAxes = Axes.X,
                         AutoSizeAxes = Axes.Y,
                         Margin = new MarginPadding { Top = height },
-                        Alpha = 0
+                        Alpha = 0,
+                        Hovered = _ =>
+                        {
+                            keep();
+                            return true;
+                        },
+                        Unhovered = _ => checkForHide()
                     },
                     borderContainer = new Container
                     {
@@ -95,6 +104,41 @@ namespace osu.Game.Beatmaps.Drawables.Cards
             FinishTransforms(true);
         }
 
+        private ScheduledDelegate? scheduledExpandedChange;
+
+        public void ScheduleShow()
+        {
+            scheduledExpandedChange?.Cancel();
+            if (Expanded.Value)
+                return;
+
+            scheduledExpandedChange = Scheduler.AddDelayed(() => Expanded.Value = true, 100);
+        }
+
+        public void ScheduleHide()
+        {
+            scheduledExpandedChange?.Cancel();
+            if (!Expanded.Value)
+                return;
+
+            scheduledExpandedChange = Scheduler.AddDelayed(() => Expanded.Value = false, 500);
+        }
+
+        private void checkForHide()
+        {
+            if (content.IsHovered || dropdownContent.IsHovered)
+                return;
+
+            scheduledExpandedChange?.Cancel();
+            Expanded.Value = false;
+        }
+
+        private void keep()
+        {
+            scheduledExpandedChange?.Cancel();
+            Expanded.Value = true;
+        }
+
         private void updateState()
         {
             background.FadeTo(Expanded.Value ? 1 : 0, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtraInfoRow.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtraInfoRow.cs
index c64e5b83d8..0a9d98e621 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtraInfoRow.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtraInfoRow.cs
@@ -8,14 +8,14 @@ using osuTK;
 
 namespace osu.Game.Beatmaps.Drawables.Cards
 {
-    public class BeatmapCardExtraInfoRow : CompositeDrawable
+    public class BeatmapCardExtraInfoRow : HoverHandlingContainer
     {
         public BeatmapCardExtraInfoRow(APIBeatmapSet beatmapSet)
         {
             RelativeSizeAxes = Axes.X;
             AutoSizeAxes = Axes.Y;
 
-            InternalChild = new FillFlowContainer
+            Child = new FillFlowContainer
             {
                 RelativeSizeAxes = Axes.X,
                 AutoSizeAxes = Axes.Y,
diff --git a/osu.Game/Beatmaps/Drawables/Cards/HoverHandlingContainer.cs b/osu.Game/Beatmaps/Drawables/Cards/HoverHandlingContainer.cs
new file mode 100644
index 0000000000..1e2c616332
--- /dev/null
+++ b/osu.Game/Beatmaps/Drawables/Cards/HoverHandlingContainer.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.
+
+#nullable enable
+
+using System;
+using osu.Framework.Graphics.Containers;
+using osu.Framework.Input.Events;
+
+namespace osu.Game.Beatmaps.Drawables.Cards
+{
+    public class HoverHandlingContainer : Container
+    {
+        public Func<HoverEvent, bool>? Hovered { get; set; }
+        public Action<HoverLostEvent>? Unhovered { get; set; }
+
+        protected override bool OnHover(HoverEvent e) => Hovered?.Invoke(e) ?? base.OnHover(e);
+
+        protected override void OnHoverLost(HoverLostEvent e)
+        {
+            if (Unhovered != null)
+                Unhovered?.Invoke(e);
+            else
+                base.OnHoverLost(e);
+        }
+    }
+}

From af10223ac4d7841cd5fc7212a09d5498211fbc6f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 29 Nov 2021 01:08:45 +0100
Subject: [PATCH 1518/5547] Add reverse fill flows & depth specs at usage sites
 for correct Z-ordering

---
 osu.Game/Overlays/BeatmapListingOverlay.cs                  | 2 +-
 osu.Game/Overlays/Profile/ProfileSection.cs                 | 5 +++--
 .../Overlays/Profile/Sections/PaginatedProfileSubsection.cs | 6 ++++--
 osu.Game/Overlays/Rankings/SpotlightsLayout.cs              | 2 +-
 4 files changed, 9 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Overlays/BeatmapListingOverlay.cs b/osu.Game/Overlays/BeatmapListingOverlay.cs
index 49f2f5c211..a454af00c4 100644
--- a/osu.Game/Overlays/BeatmapListingOverlay.cs
+++ b/osu.Game/Overlays/BeatmapListingOverlay.cs
@@ -151,7 +151,7 @@ namespace osu.Game.Overlays
                 }
 
                 // spawn new children with the contained so we only clear old content at the last moment.
-                var content = new FillFlowContainer<BeatmapCard>
+                var content = new ReverseChildIDFillFlowContainer<BeatmapCard>
                 {
                     RelativeSizeAxes = Axes.X,
                     AutoSizeAxes = Axes.Y,
diff --git a/osu.Game/Overlays/Profile/ProfileSection.cs b/osu.Game/Overlays/Profile/ProfileSection.cs
index 6223b32814..fdf3077bf0 100644
--- a/osu.Game/Overlays/Profile/ProfileSection.cs
+++ b/osu.Game/Overlays/Profile/ProfileSection.cs
@@ -11,6 +11,7 @@ using osu.Framework.Graphics.Shapes;
 using osu.Framework.Localisation;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Backgrounds;
+using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Online.API.Requests.Responses;
 
@@ -22,7 +23,7 @@ namespace osu.Game.Overlays.Profile
 
         public abstract string Identifier { get; }
 
-        private readonly FillFlowContainer content;
+        private readonly FillFlowContainer<Drawable> content;
         private readonly Box background;
         private readonly Box underscore;
 
@@ -79,7 +80,7 @@ namespace osu.Game.Overlays.Profile
                                 }
                             }
                         },
-                        content = new FillFlowContainer
+                        content = new ReverseChildIDFillFlowContainer<Drawable>
                         {
                             Direction = FillDirection.Vertical,
                             AutoSizeAxes = Axes.Y,
diff --git a/osu.Game/Overlays/Profile/Sections/PaginatedProfileSubsection.cs b/osu.Game/Overlays/Profile/Sections/PaginatedProfileSubsection.cs
index 130ae44273..e7053ec4fa 100644
--- a/osu.Game/Overlays/Profile/Sections/PaginatedProfileSubsection.cs
+++ b/osu.Game/Overlays/Profile/Sections/PaginatedProfileSubsection.cs
@@ -13,6 +13,7 @@ using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Online.API;
+using osu.Game.Graphics.Containers;
 using osu.Game.Online.API.Requests.Responses;
 using osuTK;
 
@@ -26,7 +27,7 @@ namespace osu.Game.Overlays.Profile.Sections
         protected int VisiblePages;
         protected int ItemsPerPage;
 
-        protected FillFlowContainer ItemsContainer { get; private set; }
+        protected ReverseChildIDFillFlowContainer<Drawable> ItemsContainer { get; private set; }
 
         private APIRequest<List<TModel>> retrievalRequest;
         private CancellationTokenSource loadCancellation;
@@ -48,11 +49,12 @@ namespace osu.Game.Overlays.Profile.Sections
             Direction = FillDirection.Vertical,
             Children = new Drawable[]
             {
-                ItemsContainer = new FillFlowContainer
+                ItemsContainer = new ReverseChildIDFillFlowContainer<Drawable>
                 {
                     AutoSizeAxes = Axes.Y,
                     RelativeSizeAxes = Axes.X,
                     Spacing = new Vector2(0, 2),
+                    Depth = float.MinValue
                 },
                 moreButton = new ShowMoreButton
                 {
diff --git a/osu.Game/Overlays/Rankings/SpotlightsLayout.cs b/osu.Game/Overlays/Rankings/SpotlightsLayout.cs
index a37f762532..61d68b7d29 100644
--- a/osu.Game/Overlays/Rankings/SpotlightsLayout.cs
+++ b/osu.Game/Overlays/Rankings/SpotlightsLayout.cs
@@ -135,7 +135,7 @@ namespace osu.Game.Overlays.Rankings
             Children = new Drawable[]
             {
                 new ScoresTable(1, response.Users),
-                new FillFlowContainer
+                new ReverseChildIDFillFlowContainer<BeatmapCard>
                 {
                     AutoSizeAxes = Axes.Y,
                     RelativeSizeAxes = Axes.X,

From af35652b8b9f97dc700f19040e161f8d477c2748 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 5 Dec 2021 17:16:41 +0100
Subject: [PATCH 1519/5547] Disable beatmap card expansion on solo spectator
 screen

---
 .../Visual/Beatmaps/TestSceneBeatmapCard.cs   |  9 +++++++-
 .../Drawables/Cards/BeatmapCardDropdown.cs    | 22 +++++++++++++++----
 osu.Game/Screens/Play/SoloSpectator.cs        |  5 ++++-
 3 files changed, 30 insertions(+), 6 deletions(-)

diff --git a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs
index d3ce5028b7..f835d21603 100644
--- a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs
+++ b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs
@@ -6,6 +6,7 @@ using System.Collections.Generic;
 using System.Linq;
 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.Shapes;
@@ -253,7 +254,13 @@ namespace osu.Game.Tests.Visual.Beatmaps
         {
             createTestCase(beatmapSetInfo => new BeatmapCard(beatmapSetInfo));
 
-            AddToggleStep("toggle expanded state", expanded => this.ChildrenOfType<BeatmapCard>().Last().Expanded.Value = expanded);
+            AddToggleStep("toggle expanded state", expanded =>
+            {
+                var card = this.ChildrenOfType<BeatmapCard>().Last();
+                if (!card.Expanded.Disabled)
+                    card.Expanded.Value = expanded;
+            });
+            AddToggleStep("disable/enable expansion", disabled => this.ChildrenOfType<BeatmapCard>().ForEach(card => card.Expanded.Disabled = disabled));
         }
     }
 }
diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardDropdown.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardDropdown.cs
index ef4ba67ab7..366e5cb0fc 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardDropdown.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardDropdown.cs
@@ -109,23 +109,34 @@ namespace osu.Game.Beatmaps.Drawables.Cards
         public void ScheduleShow()
         {
             scheduledExpandedChange?.Cancel();
-            if (Expanded.Value)
+            if (Expanded.Disabled || Expanded.Value)
                 return;
 
-            scheduledExpandedChange = Scheduler.AddDelayed(() => Expanded.Value = true, 100);
+            scheduledExpandedChange = Scheduler.AddDelayed(() =>
+            {
+                if (!Expanded.Disabled)
+                    Expanded.Value = true;
+            }, 100);
         }
 
         public void ScheduleHide()
         {
             scheduledExpandedChange?.Cancel();
-            if (!Expanded.Value)
+            if (Expanded.Disabled || !Expanded.Value)
                 return;
 
-            scheduledExpandedChange = Scheduler.AddDelayed(() => Expanded.Value = false, 500);
+            scheduledExpandedChange = Scheduler.AddDelayed(() =>
+            {
+                if (!Expanded.Disabled)
+                    Expanded.Value = false;
+            }, 500);
         }
 
         private void checkForHide()
         {
+            if (Expanded.Disabled)
+                return;
+
             if (content.IsHovered || dropdownContent.IsHovered)
                 return;
 
@@ -135,6 +146,9 @@ namespace osu.Game.Beatmaps.Drawables.Cards
 
         private void keep()
         {
+            if (Expanded.Disabled)
+                return;
+
             scheduledExpandedChange?.Cancel();
             Expanded.Value = true;
         }
diff --git a/osu.Game/Screens/Play/SoloSpectator.cs b/osu.Game/Screens/Play/SoloSpectator.cs
index 7fea44b3ea..3918dbe8fc 100644
--- a/osu.Game/Screens/Play/SoloSpectator.cs
+++ b/osu.Game/Screens/Play/SoloSpectator.cs
@@ -228,7 +228,10 @@ namespace osu.Game.Screens.Play
             onlineBeatmapRequest.Success += beatmapSet => Schedule(() =>
             {
                 this.beatmapSet = beatmapSet;
-                beatmapPanelContainer.Child = new BeatmapCard(this.beatmapSet);
+                beatmapPanelContainer.Child = new BeatmapCard(this.beatmapSet)
+                {
+                    Expanded = { Disabled = true }
+                };
                 checkForAutomaticDownload();
             });
 

From 0f743893890029d010b75a42d6472c79a12b69c1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 5 Dec 2021 17:35:10 +0100
Subject: [PATCH 1520/5547] Add scrolling for long difficulty lists in beatmap
 card

---
 .../Drawables/Cards/BeatmapCardDropdown.cs    | 63 ++++++++++++++++++-
 1 file changed, 61 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardDropdown.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardDropdown.cs
index 366e5cb0fc..a24f09a9b5 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardDropdown.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardDropdown.cs
@@ -3,13 +3,17 @@
 
 #nullable enable
 
+using System;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Effects;
 using osu.Framework.Graphics.Shapes;
+using osu.Framework.Input.Events;
 using osu.Framework.Threading;
+using osu.Framework.Utils;
+using osu.Game.Graphics.Containers;
 using osu.Game.Overlays;
 using osuTK;
 
@@ -24,7 +28,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
 
         public Drawable Dropdown
         {
-            set => dropdownContent.Child = value;
+            set => dropdownScroll.Child = value;
         }
 
         public Bindable<bool> Expanded { get; } = new BindableBool();
@@ -33,6 +37,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
         private readonly Container content;
         private readonly Container bodyContent;
         private readonly Container dropdownContent;
+        private readonly OsuScrollContainer dropdownScroll;
         private readonly Container borderContainer;
 
         public BeatmapCardDropdown(float height)
@@ -71,7 +76,12 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                             keep();
                             return true;
                         },
-                        Unhovered = _ => checkForHide()
+                        Unhovered = _ => checkForHide(),
+                        Child = dropdownScroll = new DropdownScrollContainer
+                        {
+                            RelativeSizeAxes = Axes.X,
+                            ScrollbarVisible = false
+                        }
                     },
                     borderContainer = new Container
                     {
@@ -168,5 +178,54 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                 Hollow = true,
             }, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
         }
+
+        private class DropdownScrollContainer : OsuScrollContainer
+        {
+            public DropdownScrollContainer()
+            {
+                ScrollbarVisible = false;
+            }
+
+            protected override void Update()
+            {
+                base.Update();
+
+                Height = Math.Min(Content.DrawHeight, 400);
+            }
+
+            private bool allowScroll => !Precision.AlmostEquals(DrawSize, Content.DrawSize);
+
+            protected override bool OnDragStart(DragStartEvent e)
+            {
+                if (!allowScroll)
+                    return false;
+
+                return base.OnDragStart(e);
+            }
+
+            protected override void OnDrag(DragEvent e)
+            {
+                if (!allowScroll)
+                    return;
+
+                base.OnDrag(e);
+            }
+
+            protected override void OnDragEnd(DragEndEvent e)
+            {
+                if (!allowScroll)
+                    return;
+
+                base.OnDragEnd(e);
+            }
+
+            protected override bool OnScroll(ScrollEvent e)
+            {
+                if (!allowScroll)
+                    return false;
+
+                return base.OnScroll(e);
+            }
+        }
     }
 }

From 91aa38c4f6d60aa243c2af8d806e8606967b3b42 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 6 Dec 2021 12:28:46 +0900
Subject: [PATCH 1521/5547] Change playlist lookup to fail hard when failing

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

diff --git a/osu.Game/Online/Multiplayer/MultiplayerClient.cs b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
index c2b9727309..f8a25e0388 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
@@ -452,7 +452,7 @@ namespace osu.Game.Online.Multiplayer
             Scheduler.Add(() =>
             {
                 // ensure the new selected item is populated immediately.
-                var playlistItem = APIRoom.Playlist.SingleOrDefault(p => p.ID == newSettings.PlaylistItemId);
+                var playlistItem = APIRoom.Playlist.Single(p => p.ID == newSettings.PlaylistItemId);
 
                 if (playlistItem != null)
                 {

From 5ff452cc9aa8e47be3a36a15facd7e148bb820dc Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 6 Dec 2021 12:29:11 +0900
Subject: [PATCH 1522/5547] Update success bool to access `Exception` to stop
 exceptions from firing outwards

---
 osu.Game/Online/Multiplayer/MultiplayerClient.cs | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Online/Multiplayer/MultiplayerClient.cs b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
index f8a25e0388..2ddcc09e1b 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
@@ -458,7 +458,8 @@ namespace osu.Game.Online.Multiplayer
                 {
                     GetAPIBeatmap(playlistItem.BeatmapID).ContinueWith(b =>
                     {
-                        bool success = b.IsCompletedSuccessfully;
+                        // Should be called outside of the `Scheduler` logic (and specifically accessing `Exception`) to suppress an exception from firing outwards.
+                        bool success = b.Exception == null;
 
                         Scheduler.Add(() =>
                         {

From ca1f96d2c2ef22d4917a3a60364e949ac546082f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 6 Dec 2021 13:03:11 +0900
Subject: [PATCH 1523/5547] Reword xmldoc of
 `MultiplayerPlaylistItem.PlaylistOrder` to better match actual behaviour

---
 osu.Game/Online/Rooms/MultiplayerPlaylistItem.cs | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Online/Rooms/MultiplayerPlaylistItem.cs b/osu.Game/Online/Rooms/MultiplayerPlaylistItem.cs
index 1c33b79531..cee6d8fe41 100644
--- a/osu.Game/Online/Rooms/MultiplayerPlaylistItem.cs
+++ b/osu.Game/Online/Rooms/MultiplayerPlaylistItem.cs
@@ -40,8 +40,12 @@ namespace osu.Game.Online.Rooms
         public bool Expired { get; set; }
 
         /// <summary>
-        /// The order in which this <see cref="MultiplayerPlaylistItem"/> will be played, starting from 0 and increasing for items which will be played later.
+        /// The order in which this <see cref="MultiplayerPlaylistItem"/> will be played relative to others.
+        /// Playlist items should be played in increasing order (lower values are played first).
         /// </summary>
+        /// <remarks>
+        /// This is only valid for items which are not <see cref="Expired"/>. The value for expired items is undefined and should not be used.
+        /// </remarks>
         [Key(8)]
         public ushort PlaylistOrder { get; set; }
 

From a76cfbea2163ed0869d507ccb9865d5ee55c9cbd Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 6 Dec 2021 14:03:24 +0900
Subject: [PATCH 1524/5547] Add test coverage of incorrect beatmap being used
 in multiplayer when match started from song select

---
 .../Multiplayer/TestSceneMultiplayer.cs       | 38 +++++++++++++++++++
 .../Multiplayer/MultiplayerMatchSubScreen.cs  | 14 ++++---
 2 files changed, 47 insertions(+), 5 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
index 4521a7fa0f..843b7a0c51 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
@@ -397,6 +397,44 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddUntilStep("user state is idle", () => client.LocalUser?.State == MultiplayerUserState.Idle);
         }
 
+        [Test]
+        public void TestPlayStartsWithCorrectBeatmapWhileAtSongSelect()
+        {
+            createRoom(() => new Room
+            {
+                Name = { Value = "Test Room" },
+                Playlist =
+                {
+                    new PlaylistItem
+                    {
+                        Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.RulesetID == 0)).BeatmapInfo },
+                        Ruleset = { Value = new OsuRuleset().RulesetInfo },
+                    }
+                }
+            });
+
+            AddStep("Enter song select", () =>
+            {
+                var currentSubScreen = ((Screens.OnlinePlay.Multiplayer.Multiplayer)multiplayerScreenStack.CurrentScreen).CurrentSubScreen;
+
+                ((MultiplayerMatchSubScreen)currentSubScreen).SelectBeatmap();
+            });
+
+            AddUntilStep("wait for song select", () => this.ChildrenOfType<MultiplayerMatchSongSelect>().FirstOrDefault()?.IsLoaded == true);
+
+            AddAssert("Beatmap matches current item", () => Beatmap.Value.BeatmapInfo.OnlineID == client.Room?.Playlist.First().BeatmapID);
+
+            AddStep("Select next beatmap", () => InputManager.Key(Key.Down));
+
+            AddUntilStep("Beatmap doesn't match current item", () => Beatmap.Value.BeatmapInfo.OnlineID != client.Room?.Playlist.First().BeatmapID);
+
+            AddStep("start match externally", () => client.StartMatch());
+
+            AddUntilStep("play started", () => multiplayerScreenStack.CurrentScreen is Player);
+
+            AddAssert("Beatmap matches current item", () => Beatmap.Value.BeatmapInfo.OnlineID == client.Room?.Playlist.First().BeatmapID);
+        }
+
         [Test]
         public void TestLocalPlayDoesNotStartWhileSpectatingWithNoBeatmap()
         {
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
index 16017a1f0e..3a25bd7b06 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
@@ -138,11 +138,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
                                     {
                                         RelativeSizeAxes = Axes.X,
                                         Height = 40,
-                                        Action = () =>
-                                        {
-                                            if (this.IsCurrentScreen())
-                                                this.Push(new MultiplayerMatchSongSelect(Room));
-                                        },
+                                        Action = SelectBeatmap,
                                         Alpha = 0
                                     },
                                 },
@@ -224,6 +220,14 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
             }
         };
 
+        internal void SelectBeatmap()
+        {
+            if (!this.IsCurrentScreen())
+                return;
+
+            this.Push(new MultiplayerMatchSongSelect(Room));
+        }
+
         protected override Drawable CreateFooter() => new MultiplayerMatchFooter
         {
             OnReadyClick = onReadyClick,

From 0ea7a6908422342c130c35141e0e35aa20e564a8 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 6 Dec 2021 14:03:51 +0900
Subject: [PATCH 1525/5547] Ensure user is returned to the `RoomSubScreen`
 before gameplay is started

This covers the scenario where a user may be at the song select screen
while another user (the room host) starts the match. This was only made
possible with the new queue modes, so is quite a recent regression.
---
 osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs b/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
index 7c5ed3f5cc..184ac2c563 100644
--- a/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
@@ -319,6 +319,16 @@ namespace osu.Game.Screens.OnlinePlay.Match
 
         protected void StartPlay()
         {
+            // User may be at song select or otherwise when the host starts gameplay.
+            // Ensure that they first return to this screen, else global bindables (beatmap etc.) may be in a bad state.
+            if (!this.IsCurrentScreen())
+            {
+                this.MakeCurrent();
+
+                Schedule(StartPlay);
+                return;
+            }
+
             sampleStart?.Play();
 
             // fallback is to allow this class to operate when there is no parent OnlineScreen (testing purposes).

From 0fa1a96e9dc508f16c27a0ad7b128c0f8899ccc6 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 6 Dec 2021 15:03:17 +0900
Subject: [PATCH 1526/5547] Wait for beatmap sets to finish loading to avoid
 test failures

Co-authored-by: Dan Balasescu <smoogipoo@smgi.me>
---
 osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
index 843b7a0c51..2411f39ae3 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
@@ -420,7 +420,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 ((MultiplayerMatchSubScreen)currentSubScreen).SelectBeatmap();
             });
 
-            AddUntilStep("wait for song select", () => this.ChildrenOfType<MultiplayerMatchSongSelect>().FirstOrDefault()?.IsLoaded == true);
+            AddUntilStep("wait for song select", () => this.ChildrenOfType<MultiplayerMatchSongSelect>().FirstOrDefault()?.BeatmapSetsLoaded == true);
 
             AddAssert("Beatmap matches current item", () => Beatmap.Value.BeatmapInfo.OnlineID == client.Room?.Playlist.First().BeatmapID);
 

From 5be74af8fe58a1a4c859b4af73007e96d4fdd061 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Mon, 6 Dec 2021 15:09:06 +0900
Subject: [PATCH 1527/5547] Update addItem() implementation

---
 .../Tests/Visual/Multiplayer/TestMultiplayerClient.cs    | 9 ++++-----
 1 file changed, 4 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
index f5f5eebe0f..740693ef76 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
@@ -430,13 +430,12 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             Debug.Assert(Room != null);
 
-            // Add the item to the list first in order to compute gameplay order.
-            item.ID = long.MaxValue;
-            serverSidePlaylist.Add(item);
-            await updatePlaylistOrder(Room).ConfigureAwait(false);
-
             item.ID = ++lastPlaylistItemId;
+
+            serverSidePlaylist.Add(item);
             await ((IMultiplayerClient)this).PlaylistItemAdded(item).ConfigureAwait(false);
+
+            await updatePlaylistOrder(Room).ConfigureAwait(false);
         }
 
         private async Task updateCurrentItem(MultiplayerRoom room, bool notify = true)

From fae41b21821fa8740004612972385b48d2719be5 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Mon, 6 Dec 2021 15:17:28 +0900
Subject: [PATCH 1528/5547] Remove one more piece of code

---
 osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
index 740693ef76..2510ddb432 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
@@ -502,11 +502,6 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
                 item.PlaylistOrder = (ushort)i;
 
-                // Items which have an "infinite" ID are not yet in the database, so avoid propagating database/hub events for them.
-                // See addItem() for when this occurs.
-                if (item.ID == long.MaxValue)
-                    continue;
-
                 await ((IMultiplayerClient)this).PlaylistItemChanged(item).ConfigureAwait(false);
             }
         }

From 7a333ffdcc1d8d599d80096fb054462db873c040 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 6 Dec 2021 16:34:15 +0900
Subject: [PATCH 1529/5547] Add a paired schedule in
 `SpectatorClient.BeginPlaying`

Optimally, I would like to remove the `Schedule` in `EndPlaying`, but it
turns out quite a few test are relying on this at very least. Adding a
paired schedule ensure that order of operations is correct, at least.
---
 osu.Game/Online/Spectator/SpectatorClient.cs | 30 +++++++++++---------
 1 file changed, 16 insertions(+), 14 deletions(-)

diff --git a/osu.Game/Online/Spectator/SpectatorClient.cs b/osu.Game/Online/Spectator/SpectatorClient.cs
index 6b95d288c5..4da9bace70 100644
--- a/osu.Game/Online/Spectator/SpectatorClient.cs
+++ b/osu.Game/Online/Spectator/SpectatorClient.cs
@@ -136,30 +136,32 @@ namespace osu.Game.Online.Spectator
 
         public void BeginPlaying(GameplayState state, Score score)
         {
-            Debug.Assert(ThreadSafety.IsUpdateThread);
+            // This schedule is only here to match the one below in `EndPlaying`.
+            Schedule(() =>
+            {
+                if (IsPlaying)
+                    throw new InvalidOperationException($"Cannot invoke {nameof(BeginPlaying)} when already playing");
 
-            if (IsPlaying)
-                throw new InvalidOperationException($"Cannot invoke {nameof(BeginPlaying)} when already playing");
+                IsPlaying = true;
 
-            IsPlaying = true;
+                // transfer state at point of beginning play
+                currentState.BeatmapID = score.ScoreInfo.BeatmapInfo.OnlineID;
+                currentState.RulesetID = score.ScoreInfo.RulesetID;
+                currentState.Mods = score.ScoreInfo.Mods.Select(m => new APIMod(m)).ToArray();
 
-            // transfer state at point of beginning play
-            currentState.BeatmapID = score.ScoreInfo.BeatmapInfo.OnlineID;
-            currentState.RulesetID = score.ScoreInfo.RulesetID;
-            currentState.Mods = score.ScoreInfo.Mods.Select(m => new APIMod(m)).ToArray();
+                currentBeatmap = state.Beatmap;
+                currentScore = score;
 
-            currentBeatmap = state.Beatmap;
-            currentScore = score;
-
-            BeginPlayingInternal(currentState);
+                BeginPlayingInternal(currentState);
+            });
         }
 
         public void SendFrames(FrameDataBundle data) => lastSend = SendFramesInternal(data);
 
         public void EndPlaying()
         {
-            // This method is most commonly called via Dispose(), which is asynchronous.
-            // Todo: This should not be a thing, but requires framework changes.
+            // This method is most commonly called via Dispose(), which is can be asynchronous (via the AsyncDisposalQueue).
+            // We probably need to find a better way to handle this...
             Schedule(() =>
             {
                 if (!IsPlaying)

From d58b85b381f6434eb570655c137c4332ff438e0c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 6 Dec 2021 16:35:06 +0900
Subject: [PATCH 1530/5547] Refactor `TestScenSpectatorPlayback` to properly
 clean up without async disposal

---
 .../Gameplay/TestSceneSpectatorPlayback.cs    | 205 ++++++++++--------
 1 file changed, 109 insertions(+), 96 deletions(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorPlayback.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorPlayback.cs
index 5fbccd54c8..4836cf8ecd 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorPlayback.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorPlayback.cs
@@ -51,7 +51,7 @@ namespace osu.Game.Tests.Visual.Gameplay
 
         private TestReplayRecorder recorder;
 
-        private readonly ManualClock manualClock = new ManualClock();
+        private ManualClock manualClock;
 
         private OsuSpriteText latencyDisplay;
 
@@ -66,113 +66,121 @@ namespace osu.Game.Tests.Visual.Gameplay
         [Cached]
         private GameplayState gameplayState = new GameplayState(new Beatmap(), new OsuRuleset(), Array.Empty<Mod>());
 
-        [SetUp]
-        public void SetUp() => Schedule(() =>
+        [SetUpSteps]
+        public void SetUpSteps()
         {
-            replay = new Replay();
+            AddStep("Reset recorder state", cleanUpState);
 
-            users.BindTo(spectatorClient.PlayingUsers);
-            users.BindCollectionChanged((obj, args) =>
+            AddStep("Setup containers", () =>
             {
-                switch (args.Action)
+                replay = new Replay();
+                manualClock = new ManualClock();
+
+                spectatorClient.OnNewFrames += onNewFrames;
+
+                users.BindTo(spectatorClient.PlayingUsers);
+                users.BindCollectionChanged((obj, args) =>
                 {
-                    case NotifyCollectionChangedAction.Add:
-                        Debug.Assert(args.NewItems != null);
-
-                        foreach (int user in args.NewItems)
-                        {
-                            if (user == api.LocalUser.Value.Id)
-                                spectatorClient.WatchUser(user);
-                        }
-
-                        break;
-
-                    case NotifyCollectionChangedAction.Remove:
-                        Debug.Assert(args.OldItems != null);
-
-                        foreach (int user in args.OldItems)
-                        {
-                            if (user == api.LocalUser.Value.Id)
-                                spectatorClient.StopWatchingUser(user);
-                        }
-
-                        break;
-                }
-            }, true);
-
-            spectatorClient.OnNewFrames += onNewFrames;
-
-            Add(new GridContainer
-            {
-                RelativeSizeAxes = Axes.Both,
-                Content = new[]
-                {
-                    new Drawable[]
+                    switch (args.Action)
                     {
-                        recordingManager = new TestRulesetInputManager(TestSceneModSettings.CreateTestRulesetInfo(), 0, SimultaneousBindingMode.Unique)
+                        case NotifyCollectionChangedAction.Add:
+                            Debug.Assert(args.NewItems != null);
+
+                            foreach (int user in args.NewItems)
+                            {
+                                if (user == api.LocalUser.Value.Id)
+                                    spectatorClient.WatchUser(user);
+                            }
+
+                            break;
+
+                        case NotifyCollectionChangedAction.Remove:
+                            Debug.Assert(args.OldItems != null);
+
+                            foreach (int user in args.OldItems)
+                            {
+                                if (user == api.LocalUser.Value.Id)
+                                    spectatorClient.StopWatchingUser(user);
+                            }
+
+                            break;
+                    }
+                }, true);
+
+                Children = new Drawable[]
+                {
+                    new GridContainer
+                    {
+                        RelativeSizeAxes = Axes.Both,
+                        Content = new[]
                         {
-                            Recorder = recorder = new TestReplayRecorder
+                            new Drawable[]
                             {
-                                ScreenSpaceToGamefield = pos => recordingManager.ToLocalSpace(pos),
-                            },
-                            Child = new Container
-                            {
-                                RelativeSizeAxes = Axes.Both,
-                                Children = new Drawable[]
+                                recordingManager = new TestRulesetInputManager(TestSceneModSettings.CreateTestRulesetInfo(), 0, SimultaneousBindingMode.Unique)
                                 {
-                                    new Box
+                                    Recorder = recorder = new TestReplayRecorder
+                                    {
+                                        ScreenSpaceToGamefield = pos => recordingManager.ToLocalSpace(pos),
+                                    },
+                                    Child = new Container
                                     {
-                                        Colour = Color4.Brown,
                                         RelativeSizeAxes = Axes.Both,
+                                        Children = new Drawable[]
+                                        {
+                                            new Box
+                                            {
+                                                Colour = Color4.Brown,
+                                                RelativeSizeAxes = Axes.Both,
+                                            },
+                                            new OsuSpriteText
+                                            {
+                                                Text = "Sending",
+                                                Scale = new Vector2(3),
+                                                Anchor = Anchor.Centre,
+                                                Origin = Anchor.Centre,
+                                            },
+                                            new TestInputConsumer()
+                                        }
                                     },
-                                    new OsuSpriteText
-                                    {
-                                        Text = "Sending",
-                                        Scale = new Vector2(3),
-                                        Anchor = Anchor.Centre,
-                                        Origin = Anchor.Centre,
-                                    },
-                                    new TestInputConsumer()
                                 }
                             },
+                            new Drawable[]
+                            {
+                                playbackManager = new TestRulesetInputManager(TestSceneModSettings.CreateTestRulesetInfo(), 0, SimultaneousBindingMode.Unique)
+                                {
+                                    Clock = new FramedClock(manualClock),
+                                    ReplayInputHandler = replayHandler = new TestFramedReplayInputHandler(replay)
+                                    {
+                                        GamefieldToScreenSpace = pos => playbackManager.ToScreenSpace(pos),
+                                    },
+                                    Child = new Container
+                                    {
+                                        RelativeSizeAxes = Axes.Both,
+                                        Children = new Drawable[]
+                                        {
+                                            new Box
+                                            {
+                                                Colour = Color4.DarkBlue,
+                                                RelativeSizeAxes = Axes.Both,
+                                            },
+                                            new OsuSpriteText
+                                            {
+                                                Text = "Receiving",
+                                                Scale = new Vector2(3),
+                                                Anchor = Anchor.Centre,
+                                                Origin = Anchor.Centre,
+                                            },
+                                            new TestInputConsumer()
+                                        }
+                                    },
+                                }
+                            }
                         }
                     },
-                    new Drawable[]
-                    {
-                        playbackManager = new TestRulesetInputManager(TestSceneModSettings.CreateTestRulesetInfo(), 0, SimultaneousBindingMode.Unique)
-                        {
-                            Clock = new FramedClock(manualClock),
-                            ReplayInputHandler = replayHandler = new TestFramedReplayInputHandler(replay)
-                            {
-                                GamefieldToScreenSpace = pos => playbackManager.ToScreenSpace(pos),
-                            },
-                            Child = new Container
-                            {
-                                RelativeSizeAxes = Axes.Both,
-                                Children = new Drawable[]
-                                {
-                                    new Box
-                                    {
-                                        Colour = Color4.DarkBlue,
-                                        RelativeSizeAxes = Axes.Both,
-                                    },
-                                    new OsuSpriteText
-                                    {
-                                        Text = "Receiving",
-                                        Scale = new Vector2(3),
-                                        Anchor = Anchor.Centre,
-                                        Origin = Anchor.Centre,
-                                    },
-                                    new TestInputConsumer()
-                                }
-                            },
-                        }
-                    }
-                }
+                    latencyDisplay = new OsuSpriteText()
+                };
             });
-
-            Add(latencyDisplay = new OsuSpriteText());
-        });
+        }
 
         private void onNewFrames(int userId, FrameDataBundle frames)
         {
@@ -189,6 +197,7 @@ namespace osu.Game.Tests.Visual.Gameplay
         [Test]
         public void TestBasic()
         {
+            AddStep("Wait for user input", () => { });
         }
 
         private double latency = SpectatorClient.TIME_BETWEEN_SENDS;
@@ -232,11 +241,15 @@ namespace osu.Game.Tests.Visual.Gameplay
         [TearDownSteps]
         public void TearDown()
         {
-            AddStep("stop recorder", () =>
-            {
-                recorder.Expire();
+            AddStep("stop recorder", cleanUpState);
+        }
+
+        private void cleanUpState()
+        {
+                // Ensure previous recorder is disposed else it may affect the global playing state of `SpectatorClient`.
+                recorder?.RemoveAndDisposeImmediately();
+                recorder = null;
                 spectatorClient.OnNewFrames -= onNewFrames;
-            });
         }
 
         public class TestFramedReplayInputHandler : FramedReplayInputHandler<TestReplayFrame>

From 50a5f52f92bee93f4fd43e9c08db60363dc8d677 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 6 Dec 2021 16:42:02 +0900
Subject: [PATCH 1531/5547] Remove duplicated test scene (see
 `TestSceeneReplayRecorder`)

---
 .../Gameplay/TestSceneReplayRecording.cs      | 228 ------------------
 1 file changed, 228 deletions(-)
 delete mode 100644 osu.Game.Tests/Visual/Gameplay/TestSceneReplayRecording.cs

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneReplayRecording.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneReplayRecording.cs
deleted file mode 100644
index 3f7155f1e2..0000000000
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneReplayRecording.cs
+++ /dev/null
@@ -1,228 +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 osu.Framework.Allocation;
-using osu.Framework.Graphics;
-using osu.Framework.Graphics.Containers;
-using osu.Framework.Graphics.Shapes;
-using osu.Framework.Input.Bindings;
-using osu.Framework.Input.Events;
-using osu.Framework.Input.StateChanges;
-using osu.Game.Beatmaps;
-using osu.Game.Graphics.Sprites;
-using osu.Game.Replays;
-using osu.Game.Rulesets;
-using osu.Game.Rulesets.Mods;
-using osu.Game.Rulesets.Osu;
-using osu.Game.Rulesets.Replays;
-using osu.Game.Rulesets.UI;
-using osu.Game.Scoring;
-using osu.Game.Screens.Play;
-using osu.Game.Tests.Visual.UserInterface;
-using osuTK;
-using osuTK.Graphics;
-
-namespace osu.Game.Tests.Visual.Gameplay
-{
-    public class TestSceneReplayRecording : OsuTestScene
-    {
-        private readonly TestRulesetInputManager playbackManager;
-
-        private readonly TestRulesetInputManager recordingManager;
-
-        [Cached]
-        private GameplayState gameplayState = new GameplayState(new Beatmap(), new OsuRuleset(), Array.Empty<Mod>());
-
-        public TestSceneReplayRecording()
-        {
-            Replay replay = new Replay();
-
-            Add(new GridContainer
-            {
-                RelativeSizeAxes = Axes.Both,
-                Content = new[]
-                {
-                    new Drawable[]
-                    {
-                        recordingManager = new TestRulesetInputManager(TestSceneModSettings.CreateTestRulesetInfo(), 0, SimultaneousBindingMode.Unique)
-                        {
-                            Recorder = new TestReplayRecorder(new Score
-                            {
-                                Replay = replay,
-                                ScoreInfo = { BeatmapInfo = gameplayState.Beatmap.BeatmapInfo }
-                            })
-                            {
-                                ScreenSpaceToGamefield = pos => recordingManager?.ToLocalSpace(pos) ?? Vector2.Zero,
-                            },
-                            Child = new Container
-                            {
-                                RelativeSizeAxes = Axes.Both,
-                                Children = new Drawable[]
-                                {
-                                    new Box
-                                    {
-                                        Colour = Color4.Brown,
-                                        RelativeSizeAxes = Axes.Both,
-                                    },
-                                    new OsuSpriteText
-                                    {
-                                        Text = "Recording",
-                                        Scale = new Vector2(3),
-                                        Anchor = Anchor.Centre,
-                                        Origin = Anchor.Centre,
-                                    },
-                                    new TestConsumer()
-                                }
-                            },
-                        }
-                    },
-                    new Drawable[]
-                    {
-                        playbackManager = new TestRulesetInputManager(TestSceneModSettings.CreateTestRulesetInfo(), 0, SimultaneousBindingMode.Unique)
-                        {
-                            ReplayInputHandler = new TestFramedReplayInputHandler(replay)
-                            {
-                                GamefieldToScreenSpace = pos => playbackManager?.ToScreenSpace(pos) ?? Vector2.Zero,
-                            },
-                            Child = new Container
-                            {
-                                RelativeSizeAxes = Axes.Both,
-                                Children = new Drawable[]
-                                {
-                                    new Box
-                                    {
-                                        Colour = Color4.DarkBlue,
-                                        RelativeSizeAxes = Axes.Both,
-                                    },
-                                    new OsuSpriteText
-                                    {
-                                        Text = "Playback",
-                                        Scale = new Vector2(3),
-                                        Anchor = Anchor.Centre,
-                                        Origin = Anchor.Centre,
-                                    },
-                                    new TestConsumer()
-                                }
-                            },
-                        }
-                    }
-                }
-            });
-        }
-
-        protected override void Update()
-        {
-            base.Update();
-
-            playbackManager.ReplayInputHandler.SetFrameFromTime(Time.Current - 500);
-        }
-    }
-
-    public class TestFramedReplayInputHandler : FramedReplayInputHandler<TestReplayFrame>
-    {
-        public TestFramedReplayInputHandler(Replay replay)
-            : base(replay)
-        {
-        }
-
-        public override void CollectPendingInputs(List<IInput> inputs)
-        {
-            inputs.Add(new MousePositionAbsoluteInput { Position = GamefieldToScreenSpace(CurrentFrame?.Position ?? Vector2.Zero) });
-            inputs.Add(new ReplayState<TestAction> { PressedActions = CurrentFrame?.Actions ?? new List<TestAction>() });
-        }
-    }
-
-    public class TestConsumer : CompositeDrawable, IKeyBindingHandler<TestAction>
-    {
-        public override bool ReceivePositionalInputAt(Vector2 screenSpacePos) => Parent.ReceivePositionalInputAt(screenSpacePos);
-
-        private readonly Box box;
-
-        public TestConsumer()
-        {
-            Size = new Vector2(30);
-
-            Origin = Anchor.Centre;
-
-            InternalChildren = new Drawable[]
-            {
-                box = new Box
-                {
-                    Colour = Color4.Black,
-                    RelativeSizeAxes = Axes.Both,
-                },
-            };
-        }
-
-        protected override bool OnMouseMove(MouseMoveEvent e)
-        {
-            Position = e.MousePosition;
-            return base.OnMouseMove(e);
-        }
-
-        public bool OnPressed(KeyBindingPressEvent<TestAction> e)
-        {
-            if (e.Repeat)
-                return false;
-
-            box.Colour = Color4.White;
-            return true;
-        }
-
-        public void OnReleased(KeyBindingReleaseEvent<TestAction> e)
-        {
-            box.Colour = Color4.Black;
-        }
-    }
-
-    public class TestRulesetInputManager : RulesetInputManager<TestAction>
-    {
-        public TestRulesetInputManager(RulesetInfo ruleset, int variant, SimultaneousBindingMode unique)
-            : base(ruleset, variant, unique)
-        {
-        }
-
-        protected override KeyBindingContainer<TestAction> CreateKeyBindingContainer(RulesetInfo ruleset, int variant, SimultaneousBindingMode unique)
-            => new TestKeyBindingContainer();
-
-        internal class TestKeyBindingContainer : KeyBindingContainer<TestAction>
-        {
-            public override IEnumerable<IKeyBinding> DefaultKeyBindings => new[]
-            {
-                new KeyBinding(InputKey.MouseLeft, TestAction.Down),
-            };
-        }
-    }
-
-    public class TestReplayFrame : ReplayFrame
-    {
-        public Vector2 Position;
-
-        public List<TestAction> Actions = new List<TestAction>();
-
-        public TestReplayFrame(double time, Vector2 position, params TestAction[] actions)
-            : base(time)
-        {
-            Position = position;
-            Actions.AddRange(actions);
-        }
-    }
-
-    public enum TestAction
-    {
-        Down,
-    }
-
-    internal class TestReplayRecorder : ReplayRecorder<TestAction>
-    {
-        public TestReplayRecorder(Score target)
-            : base(target)
-        {
-        }
-
-        protected override ReplayFrame HandleFrame(Vector2 mousePosition, List<TestAction> actions, ReplayFrame previousFrame) =>
-            new TestReplayFrame(Time.Current, mousePosition, actions.ToArray());
-    }
-}

From 0d3d22d3e1fdee1d40a375dc4941cb0014457ce0 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 6 Dec 2021 16:42:24 +0900
Subject: [PATCH 1532/5547] Update `TestSceneReplayReocorder` to be safer about
 disposal

---
 .../Gameplay/TestSceneReplayRecorder.cs       | 136 ++++++++++--------
 1 file changed, 74 insertions(+), 62 deletions(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneReplayRecorder.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneReplayRecorder.cs
index dcc193669b..e6361a15d7 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneReplayRecorder.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneReplayRecorder.cs
@@ -43,83 +43,88 @@ namespace osu.Game.Tests.Visual.Gameplay
         [Cached]
         private GameplayState gameplayState = new GameplayState(new Beatmap(), new OsuRuleset(), Array.Empty<Mod>());
 
-        [SetUp]
-        public void SetUp() => Schedule(() =>
+        [SetUpSteps]
+        public void SetUpSteps()
         {
-            replay = new Replay();
+            AddStep("Reset recorder state", cleanUpState);
 
-            Add(new GridContainer
+            AddStep("Setup containers", () =>
             {
-                RelativeSizeAxes = Axes.Both,
-                Content = new[]
+                replay = new Replay();
+
+                Add(new GridContainer
                 {
-                    new Drawable[]
+                    RelativeSizeAxes = Axes.Both,
+                    Content = new[]
                     {
-                        recordingManager = new TestRulesetInputManager(TestSceneModSettings.CreateTestRulesetInfo(), 0, SimultaneousBindingMode.Unique)
+                        new Drawable[]
                         {
-                            Recorder = recorder = new TestReplayRecorder(new Score
+                            recordingManager = new TestRulesetInputManager(TestSceneModSettings.CreateTestRulesetInfo(), 0, SimultaneousBindingMode.Unique)
                             {
-                                Replay = replay,
-                                ScoreInfo = { BeatmapInfo = gameplayState.Beatmap.BeatmapInfo }
-                            })
-                            {
-                                ScreenSpaceToGamefield = pos => recordingManager.ToLocalSpace(pos),
-                            },
-                            Child = new Container
-                            {
-                                RelativeSizeAxes = Axes.Both,
-                                Children = new Drawable[]
+                                Recorder = recorder = new TestReplayRecorder(new Score
                                 {
-                                    new Box
+                                    Replay = replay,
+                                    ScoreInfo = { BeatmapInfo = gameplayState.Beatmap.BeatmapInfo }
+                                })
+                                {
+                                    ScreenSpaceToGamefield = pos => recordingManager.ToLocalSpace(pos),
+                                },
+                                Child = new Container
+                                {
+                                    RelativeSizeAxes = Axes.Both,
+                                    Children = new Drawable[]
                                     {
-                                        Colour = Color4.Brown,
-                                        RelativeSizeAxes = Axes.Both,
-                                    },
-                                    new OsuSpriteText
-                                    {
-                                        Text = "Recording",
-                                        Scale = new Vector2(3),
-                                        Anchor = Anchor.Centre,
-                                        Origin = Anchor.Centre,
-                                    },
-                                    new TestInputConsumer()
-                                }
-                            },
-                        }
-                    },
-                    new Drawable[]
-                    {
-                        playbackManager = new TestRulesetInputManager(TestSceneModSettings.CreateTestRulesetInfo(), 0, SimultaneousBindingMode.Unique)
+                                        new Box
+                                        {
+                                            Colour = Color4.Brown,
+                                            RelativeSizeAxes = Axes.Both,
+                                        },
+                                        new OsuSpriteText
+                                        {
+                                            Text = "Recording",
+                                            Scale = new Vector2(3),
+                                            Anchor = Anchor.Centre,
+                                            Origin = Anchor.Centre,
+                                        },
+                                        new TestInputConsumer()
+                                    }
+                                },
+                            }
+                        },
+                        new Drawable[]
                         {
-                            ReplayInputHandler = new TestFramedReplayInputHandler(replay)
+                            playbackManager = new TestRulesetInputManager(TestSceneModSettings.CreateTestRulesetInfo(), 0, SimultaneousBindingMode.Unique)
                             {
-                                GamefieldToScreenSpace = pos => playbackManager.ToScreenSpace(pos),
-                            },
-                            Child = new Container
-                            {
-                                RelativeSizeAxes = Axes.Both,
-                                Children = new Drawable[]
+                                ReplayInputHandler = new TestFramedReplayInputHandler(replay)
                                 {
-                                    new Box
+                                    GamefieldToScreenSpace = pos => playbackManager.ToScreenSpace(pos),
+                                },
+                                Child = new Container
+                                {
+                                    RelativeSizeAxes = Axes.Both,
+                                    Children = new Drawable[]
                                     {
-                                        Colour = Color4.DarkBlue,
-                                        RelativeSizeAxes = Axes.Both,
-                                    },
-                                    new OsuSpriteText
-                                    {
-                                        Text = "Playback",
-                                        Scale = new Vector2(3),
-                                        Anchor = Anchor.Centre,
-                                        Origin = Anchor.Centre,
-                                    },
-                                    new TestInputConsumer()
-                                }
-                            },
+                                        new Box
+                                        {
+                                            Colour = Color4.DarkBlue,
+                                            RelativeSizeAxes = Axes.Both,
+                                        },
+                                        new OsuSpriteText
+                                        {
+                                            Text = "Playback",
+                                            Scale = new Vector2(3),
+                                            Anchor = Anchor.Centre,
+                                            Origin = Anchor.Centre,
+                                        },
+                                        new TestInputConsumer()
+                                    }
+                                },
+                            }
                         }
                     }
-                }
+                });
             });
-        });
+        }
 
         [Test]
         public void TestBasic()
@@ -184,7 +189,14 @@ namespace osu.Game.Tests.Visual.Gameplay
         [TearDownSteps]
         public void TearDown()
         {
-            AddStep("stop recorder", () => recorder.Expire());
+            AddStep("stop recorder", cleanUpState);
+        }
+
+        private void cleanUpState()
+        {
+            // Ensure previous recorder is disposed else it may affect the global playing state of `SpectatorClient`.
+            recorder?.RemoveAndDisposeImmediately();
+            recorder = null;
         }
 
         public class TestFramedReplayInputHandler : FramedReplayInputHandler<TestReplayFrame>

From 568364b604cbffcfe3ed94bf9dbb9a014130cd98 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Mon, 6 Dec 2021 17:38:57 +0900
Subject: [PATCH 1533/5547] Fix indentation

---
 .../Visual/Gameplay/TestSceneSpectatorPlayback.cs         | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorPlayback.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorPlayback.cs
index 4836cf8ecd..f7e9a1fe16 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorPlayback.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorPlayback.cs
@@ -246,10 +246,10 @@ namespace osu.Game.Tests.Visual.Gameplay
 
         private void cleanUpState()
         {
-                // Ensure previous recorder is disposed else it may affect the global playing state of `SpectatorClient`.
-                recorder?.RemoveAndDisposeImmediately();
-                recorder = null;
-                spectatorClient.OnNewFrames -= onNewFrames;
+            // Ensure previous recorder is disposed else it may affect the global playing state of `SpectatorClient`.
+            recorder?.RemoveAndDisposeImmediately();
+            recorder = null;
+            spectatorClient.OnNewFrames -= onNewFrames;
         }
 
         public class TestFramedReplayInputHandler : FramedReplayInputHandler<TestReplayFrame>

From 3e27859e4f7f3b02ddc7551b9e7033bedf4cc1f7 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 6 Dec 2021 22:47:07 +0900
Subject: [PATCH 1534/5547] Update framework

---
 osu.Android.props        | 2 +-
 osu.Game/osu.Game.csproj | 2 +-
 osu.iOS.props            | 4 ++--
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Android.props b/osu.Android.props
index 17b5cb67e9..ce23d36faa 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -52,7 +52,7 @@
   </ItemGroup>
   <ItemGroup>
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1203.0" />
-    <PackageReference Include="ppy.osu.Framework.Android" Version="2021.1203.0" />
+    <PackageReference Include="ppy.osu.Framework.Android" Version="2021.1206.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
     <!-- Realm needs to be directly referenced in all Xamarin projects, as it will not pull in its transitive dependencies otherwise. -->
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 53a3337c9d..788a5113ad 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="10.7.1" />
-    <PackageReference Include="ppy.osu.Framework" Version="2021.1203.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2021.1206.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1203.0" />
     <PackageReference Include="Sentry" Version="3.11.1" />
     <PackageReference Include="SharpCompress" Version="0.30.0" />
diff --git a/osu.iOS.props b/osu.iOS.props
index f3dc163a67..2aa9821e8f 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -60,7 +60,7 @@
     <Reference Include="System.Net.Http" />
   </ItemGroup>
   <ItemGroup Label="Package References">
-    <PackageReference Include="ppy.osu.Framework.iOS" Version="2021.1203.0" />
+    <PackageReference Include="ppy.osu.Framework.iOS" Version="2021.1206.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1203.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net5.0 / net6.0) -->
@@ -83,7 +83,7 @@
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="2.2.6" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.Core" Version="2.2.6" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
-    <PackageReference Include="ppy.osu.Framework" Version="2021.1203.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2021.1206.0" />
     <PackageReference Include="SharpCompress" Version="0.30.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
     <PackageReference Include="SharpRaven" Version="2.4.0" />

From d5cdb1bb8786d41a896ce4b57293a144d9998bbf Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 7 Dec 2021 00:01:07 +0900
Subject: [PATCH 1535/5547] Update test multiplayer client implementation

---
 .../Multiplayer/TestMultiplayerClient.cs      | 40 +++++++++----------
 1 file changed, 18 insertions(+), 22 deletions(-)

diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
index 2510ddb432..b3ea5bdc4a 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
@@ -464,32 +464,28 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     break;
 
                 case QueueMode.AllPlayersRoundRobin:
-                    orderedActiveItems = new List<MultiplayerPlaylistItem>();
+                    var itemsByPriority = new List<(MultiplayerPlaylistItem item, int priority)>();
 
-                    // Todo: This could probably be more efficient, likely at the cost of increased complexity.
-                    // Number of "expired" or "used" items per player.
-                    Dictionary<int, int> perUserCounts = serverSidePlaylist
-                                                         .GroupBy(item => item.OwnerID)
-                                                         .ToDictionary(group => group.Key, group => group.Count(item => item.Expired));
-
-                    // We'll run a simulation over all items which are not expired ("unprocessed"). Expired items will not have their ordering updated.
-                    List<MultiplayerPlaylistItem> unprocessedItems = serverSidePlaylist.Where(item => !item.Expired).ToList();
-
-                    // In every iteration of the simulation, pick the first available item from the user with the lowest number of items in the queue to add to the result set.
-                    // If multiple users have the same number of items in the queue, then the item with the lowest ID is chosen.
-                    while (unprocessedItems.Count > 0)
+                    // Assign a priority for items from each user, starting from 0 and increasing in order which the user added the items.
+                    foreach (var group in room.Playlist.Where(item => !item.Expired).OrderBy(item => item.ID).GroupBy(item => item.OwnerID))
                     {
-                        MultiplayerPlaylistItem candidateItem = unprocessedItems
-                                                                .OrderBy(item => perUserCounts[item.OwnerID])
-                                                                .ThenBy(item => item.ID)
-                                                                .First();
-
-                        unprocessedItems.Remove(candidateItem);
-                        orderedActiveItems.Add(candidateItem);
-
-                        perUserCounts[candidateItem.OwnerID]++;
+                        int priority = 0;
+                        itemsByPriority.AddRange(group.Select(item => (item, priority++)));
                     }
 
+                    orderedActiveItems = itemsByPriority
+                                         // Order by each user's priority.
+                                         .OrderBy(i => i.priority)
+                                         // Many users will have the same priority of items, so attempt to break the tie by maintaining previous ordering.
+                                         // Suppose there are two users: User1 and User2. User1 adds two items, and then User2 adds a third. If the previous order is not maintained,
+                                         // then after playing the first item by User1, their second item will become priority=0 and jump to the front of the queue (because it was added first).
+                                         .ThenBy(i => i.item.PlaylistOrder)
+                                         // If there are still ties (normally shouldn't happen), break ties by making items added earlier go first.
+                                         // This could happen if e.g. the item orders get reset.
+                                         .ThenBy(i => i.item.ID)
+                                         .Select(i => i.item)
+                                         .ToList();
+
                     break;
             }
 

From 4278a320e46042c47de929500b559ed079dc20b7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 6 Dec 2021 20:12:02 +0100
Subject: [PATCH 1536/5547] Fix skin setting resetting every launch

The reason this was happening was an unfortunate oversight in the
migration logic. The code that was attempting to parse the skin settings
as `int` was firing regardless of whether a skin migration from EF to
realm had already occurred. If it had occurred, the skin setting would
contain a GUID rather than an integer, and therefore fail to parse, and
therefore implicitly fallback to a EF skin ID of 0 which would be the
default skin.

Fix by not running the setting migrating logic at all when there are no
EF skins to migrate.
---
 osu.Game/Database/EFToRealmMigrator.cs | 20 ++++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/osu.Game/Database/EFToRealmMigrator.cs b/osu.Game/Database/EFToRealmMigrator.cs
index 3790dc8ae9..b79a982460 100644
--- a/osu.Game/Database/EFToRealmMigrator.cs
+++ b/osu.Game/Database/EFToRealmMigrator.cs
@@ -35,6 +35,16 @@ namespace osu.Game.Database
 
         private void migrateSkins(DatabaseWriteUsage db)
         {
+            // can be removed 20220530.
+            var existingSkins = db.Context.SkinInfo
+                                  .Include(s => s.Files)
+                                  .ThenInclude(f => f.FileInfo)
+                                  .ToList();
+
+            // previous entries in EF are removed post migration.
+            if (!existingSkins.Any())
+                return;
+
             var userSkinChoice = config.GetBindable<string>(OsuSetting.Skin);
             int.TryParse(userSkinChoice.Value, out int userSkinInt);
 
@@ -49,16 +59,6 @@ namespace osu.Game.Database
                     break;
             }
 
-            // migrate ruleset settings. can be removed 20220530.
-            var existingSkins = db.Context.SkinInfo
-                                  .Include(s => s.Files)
-                                  .ThenInclude(f => f.FileInfo)
-                                  .ToList();
-
-            // previous entries in EF are removed post migration.
-            if (!existingSkins.Any())
-                return;
-
             using (var realm = realmContextFactory.CreateContext())
             using (var transaction = realm.BeginWrite())
             {

From ccfc361626415fe5993fae093bcfb35abcf980e1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 6 Dec 2021 20:49:29 +0100
Subject: [PATCH 1537/5547] Apply naming suggestions

---
 osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs   | 12 ++++++------
 ...eatmapCardDropdown.cs => BeatmapCardContent.cs} | 14 +++++++-------
 2 files changed, 13 insertions(+), 13 deletions(-)
 rename osu.Game/Beatmaps/Drawables/Cards/{BeatmapCardDropdown.cs => BeatmapCardContent.cs} (94%)

diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
index 2ab77539b3..9031d6df1a 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
@@ -44,7 +44,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
 
         private readonly BeatmapDownloadTracker downloadTracker;
 
-        private BeatmapCardDropdown dropdown = null!;
+        private BeatmapCardContent content = null!;
 
         private BeatmapCardThumbnail thumbnail = null!;
 
@@ -82,9 +82,9 @@ namespace osu.Game.Beatmaps.Drawables.Cards
             GridContainer titleContainer;
             GridContainer artistContainer;
 
-            InternalChild = dropdown = new BeatmapCardDropdown(height)
+            InternalChild = content = new BeatmapCardContent(height)
             {
-                Body = new Container
+                MainContent = new Container
                 {
                     RelativeSizeAxes = Axes.Both,
                     Children = new Drawable[]
@@ -282,10 +282,10 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                                                 {
                                                     Hovered = _ =>
                                                     {
-                                                        dropdown.ScheduleShow();
+                                                        content.ScheduleShow();
                                                         return false;
                                                     },
-                                                    Unhovered = _ => dropdown.ScheduleHide()
+                                                    Unhovered = _ => content.ScheduleHide()
                                                 }
                                             }
                                         },
@@ -304,7 +304,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                         }
                     }
                 },
-                Dropdown = new Container
+                ExpandedContent = new Container
                 {
                     RelativeSizeAxes = Axes.X,
                     AutoSizeAxes = Axes.Y,
diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardDropdown.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardContent.cs
similarity index 94%
rename from osu.Game/Beatmaps/Drawables/Cards/BeatmapCardDropdown.cs
rename to osu.Game/Beatmaps/Drawables/Cards/BeatmapCardContent.cs
index a24f09a9b5..7f94d0e3b7 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardDropdown.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardContent.cs
@@ -19,14 +19,14 @@ using osuTK;
 
 namespace osu.Game.Beatmaps.Drawables.Cards
 {
-    public class BeatmapCardDropdown : CompositeDrawable
+    public class BeatmapCardContent : CompositeDrawable
     {
-        public Drawable Body
+        public Drawable MainContent
         {
             set => bodyContent.Child = value;
         }
 
-        public Drawable Dropdown
+        public Drawable ExpandedContent
         {
             set => dropdownScroll.Child = value;
         }
@@ -40,7 +40,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
         private readonly OsuScrollContainer dropdownScroll;
         private readonly Container borderContainer;
 
-        public BeatmapCardDropdown(float height)
+        public BeatmapCardContent(float height)
         {
             RelativeSizeAxes = Axes.X;
             Height = height;
@@ -77,7 +77,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                             return true;
                         },
                         Unhovered = _ => checkForHide(),
-                        Child = dropdownScroll = new DropdownScrollContainer
+                        Child = dropdownScroll = new ExpandedContentScrollContainer
                         {
                             RelativeSizeAxes = Axes.X,
                             ScrollbarVisible = false
@@ -179,9 +179,9 @@ namespace osu.Game.Beatmaps.Drawables.Cards
             }, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
         }
 
-        private class DropdownScrollContainer : OsuScrollContainer
+        private class ExpandedContentScrollContainer : OsuScrollContainer
         {
-            public DropdownScrollContainer()
+            public ExpandedContentScrollContainer()
             {
                 ScrollbarVisible = false;
             }

From 82ed8eae6bfa4f42ecb274f1138f414ad42f7d04 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 6 Dec 2021 20:52:06 +0100
Subject: [PATCH 1538/5547] Ensure hover handling container always calls base
 on hover events

---
 .../Drawables/Cards/HoverHandlingContainer.cs        | 12 +++++++-----
 1 file changed, 7 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Beatmaps/Drawables/Cards/HoverHandlingContainer.cs b/osu.Game/Beatmaps/Drawables/Cards/HoverHandlingContainer.cs
index 1e2c616332..fe37616755 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/HoverHandlingContainer.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/HoverHandlingContainer.cs
@@ -14,14 +14,16 @@ namespace osu.Game.Beatmaps.Drawables.Cards
         public Func<HoverEvent, bool>? Hovered { get; set; }
         public Action<HoverLostEvent>? Unhovered { get; set; }
 
-        protected override bool OnHover(HoverEvent e) => Hovered?.Invoke(e) ?? base.OnHover(e);
+        protected override bool OnHover(HoverEvent e)
+        {
+            bool handledByBase = base.OnHover(e);
+            return Hovered?.Invoke(e) ?? handledByBase;
+        }
 
         protected override void OnHoverLost(HoverLostEvent e)
         {
-            if (Unhovered != null)
-                Unhovered?.Invoke(e);
-            else
-                base.OnHoverLost(e);
+            base.OnHoverLost(e);
+            Unhovered?.Invoke(e);
         }
     }
 }

From 999bba439f98bb31741acbfadd4b7a834be3a7a6 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 6 Dec 2021 21:00:26 +0100
Subject: [PATCH 1539/5547] Clarify usages of reverse child ID flow with inline
 comments

---
 osu.Game/Overlays/BeatmapListingOverlay.cs                     | 1 +
 osu.Game/Overlays/Profile/ProfileSection.cs                    | 2 ++
 .../Overlays/Profile/Sections/PaginatedProfileSubsection.cs    | 3 +++
 osu.Game/Overlays/Rankings/SpotlightsLayout.cs                 | 1 +
 4 files changed, 7 insertions(+)

diff --git a/osu.Game/Overlays/BeatmapListingOverlay.cs b/osu.Game/Overlays/BeatmapListingOverlay.cs
index a454af00c4..6b27dbf847 100644
--- a/osu.Game/Overlays/BeatmapListingOverlay.cs
+++ b/osu.Game/Overlays/BeatmapListingOverlay.cs
@@ -151,6 +151,7 @@ namespace osu.Game.Overlays
                 }
 
                 // spawn new children with the contained so we only clear old content at the last moment.
+                // reverse ID flow is required for correct Z-ordering of the cards' expandable content (last card should be front-most).
                 var content = new ReverseChildIDFillFlowContainer<BeatmapCard>
                 {
                     RelativeSizeAxes = Axes.X,
diff --git a/osu.Game/Overlays/Profile/ProfileSection.cs b/osu.Game/Overlays/Profile/ProfileSection.cs
index fdf3077bf0..fc6fce0d8e 100644
--- a/osu.Game/Overlays/Profile/ProfileSection.cs
+++ b/osu.Game/Overlays/Profile/ProfileSection.cs
@@ -80,6 +80,8 @@ namespace osu.Game.Overlays.Profile
                                 }
                             }
                         },
+                        // reverse ID flow is required for correct Z-ordering of the content (last item should be front-most).
+                        // particularly important in BeatmapsSection, as it uses beatmap cards, which have expandable overhanging content.
                         content = new ReverseChildIDFillFlowContainer<Drawable>
                         {
                             Direction = FillDirection.Vertical,
diff --git a/osu.Game/Overlays/Profile/Sections/PaginatedProfileSubsection.cs b/osu.Game/Overlays/Profile/Sections/PaginatedProfileSubsection.cs
index e7053ec4fa..9dcbf6142d 100644
--- a/osu.Game/Overlays/Profile/Sections/PaginatedProfileSubsection.cs
+++ b/osu.Game/Overlays/Profile/Sections/PaginatedProfileSubsection.cs
@@ -49,11 +49,14 @@ namespace osu.Game.Overlays.Profile.Sections
             Direction = FillDirection.Vertical,
             Children = new Drawable[]
             {
+                // reverse ID flow is required for correct Z-ordering of the items (last item should be front-most).
+                // particularly important in PaginatedBeatmapContainer, as it uses beatmap cards, which have expandable overhanging content.
                 ItemsContainer = new ReverseChildIDFillFlowContainer<Drawable>
                 {
                     AutoSizeAxes = Axes.Y,
                     RelativeSizeAxes = Axes.X,
                     Spacing = new Vector2(0, 2),
+                    // ensure the container and its contents are in front of the "more" button.
                     Depth = float.MinValue
                 },
                 moreButton = new ShowMoreButton
diff --git a/osu.Game/Overlays/Rankings/SpotlightsLayout.cs b/osu.Game/Overlays/Rankings/SpotlightsLayout.cs
index 61d68b7d29..bcfc2499b9 100644
--- a/osu.Game/Overlays/Rankings/SpotlightsLayout.cs
+++ b/osu.Game/Overlays/Rankings/SpotlightsLayout.cs
@@ -135,6 +135,7 @@ namespace osu.Game.Overlays.Rankings
             Children = new Drawable[]
             {
                 new ScoresTable(1, response.Users),
+                // reverse ID flow is required for correct Z-ordering of the cards' expandable content (last card should be front-most).
                 new ReverseChildIDFillFlowContainer<BeatmapCard>
                 {
                     AutoSizeAxes = Axes.Y,

From 0a6c221de4dda5d3f41c504974f204b79be4f0ab Mon Sep 17 00:00:00 2001
From: tbrose <tbrose@uni-bremen.de>
Date: Mon, 6 Dec 2021 22:07:47 +0100
Subject: [PATCH 1540/5547] Adds tests for checkContainsUsername function of
 MessageNotifier component

---
 .../Online/Chat/MessageNotifierTest.cs        | 66 +++++++++++++++++++
 osu.Game/Online/Chat/MessageNotifier.cs       |  2 +-
 2 files changed, 67 insertions(+), 1 deletion(-)
 create mode 100644 osu.Game.Tests/Online/Chat/MessageNotifierTest.cs

diff --git a/osu.Game.Tests/Online/Chat/MessageNotifierTest.cs b/osu.Game.Tests/Online/Chat/MessageNotifierTest.cs
new file mode 100644
index 0000000000..9fed72d249
--- /dev/null
+++ b/osu.Game.Tests/Online/Chat/MessageNotifierTest.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.Online.Chat;
+
+namespace osu.Game.Tests.Online.Chat
+{
+    [TestFixture]
+    public class TestCheckUsername
+    {
+        [Test]
+        public void TestContainsUsernameMidlinePositive()
+        {
+            Assert.IsTrue(MessageNotifier.checkContainsUsername("This is a test message", "Test"));
+        }
+
+        [Test]
+        public void TestContainsUsernameStartOfLinePositive()
+        {
+            Assert.IsTrue(MessageNotifier.checkContainsUsername("Test message", "Test"));
+        }
+
+        [Test]
+        public void TestContainsUsernameEndOfLinePositive()
+        {
+            Assert.IsTrue(MessageNotifier.checkContainsUsername("This is a test", "Test"));
+        }
+
+        [Test]
+        public void TestContainsUsernameMidlineNegative()
+        {
+            Assert.IsFalse(MessageNotifier.checkContainsUsername("This is a testmessage for notifications", "Test"));
+        }
+
+        [Test]
+        public void TestContainsUsernameStartOfLineNegative()
+        {
+            Assert.IsFalse(MessageNotifier.checkContainsUsername("Testmessage", "Test"));
+        }
+
+        [Test]
+        public void TestContainsUsernameEndOfLineNegative()
+        {
+            Assert.IsFalse(MessageNotifier.checkContainsUsername("This is a notificationtest", "Test"));
+        }
+
+        [Test]
+        public void TestContainsUsernameBetweenInterpunction()
+        {
+            Assert.IsTrue(MessageNotifier.checkContainsUsername("Hello 'test'-message", "Test"));
+        }
+
+        [Test]
+        public void TestContainsUsernameUnicode()
+        {
+            Assert.IsTrue(MessageNotifier.checkContainsUsername("Test \u0460\u0460 message", "\u0460\u0460"));
+        }
+
+        [Test]
+        public void TestContainsUsernameUnicodeNegative()
+        {
+            Assert.IsFalse(MessageNotifier.checkContainsUsername("Test ha\u0460\u0460o message", "\u0460\u0460"));
+        }
+    }
+}
diff --git a/osu.Game/Online/Chat/MessageNotifier.cs b/osu.Game/Online/Chat/MessageNotifier.cs
index ca6317566f..69b3b18b3e 100644
--- a/osu.Game/Online/Chat/MessageNotifier.cs
+++ b/osu.Game/Online/Chat/MessageNotifier.cs
@@ -129,7 +129,7 @@ namespace osu.Game.Online.Chat
         /// Checks if <paramref name="message"/> contains <paramref name="username"/>.
         /// This will match against the case where underscores are used instead of spaces (which is how osu-stable handles usernames with spaces).
         /// </summary>
-        private static bool checkContainsUsername(string message, string username) => message.Contains(username, StringComparison.OrdinalIgnoreCase) || message.Contains(username.Replace(' ', '_'), StringComparison.OrdinalIgnoreCase);
+        public static bool checkContainsUsername(string message, string username) => message.Contains(username, StringComparison.OrdinalIgnoreCase) || message.Contains(username.Replace(' ', '_'), StringComparison.OrdinalIgnoreCase);
 
         public class PrivateMessageNotification : OpenChannelNotification
         {

From 39594b7362747b329bb9486ab7b53019d15671fe Mon Sep 17 00:00:00 2001
From: tbrose <tbrose@uni-bremen.de>
Date: Mon, 6 Dec 2021 23:32:21 +0100
Subject: [PATCH 1541/5547] Fixes detection of mentioning of user falsely
 detects messages where the username is coincidentally contained in words of a
 message.

---
 osu.Game/Online/Chat/MessageNotifier.cs | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Online/Chat/MessageNotifier.cs b/osu.Game/Online/Chat/MessageNotifier.cs
index 69b3b18b3e..aca9df0600 100644
--- a/osu.Game/Online/Chat/MessageNotifier.cs
+++ b/osu.Game/Online/Chat/MessageNotifier.cs
@@ -5,6 +5,7 @@ using System;
 using System.Collections.Generic;
 using System.Collections.Specialized;
 using System.Linq;
+using System.Text.RegularExpressions;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
@@ -126,10 +127,14 @@ namespace osu.Game.Online.Chat
         }
 
         /// <summary>
-        /// Checks if <paramref name="message"/> contains <paramref name="username"/>.
+        /// Checks if <paramref name="message"/> mentions <paramref name="username"/>.
         /// This will match against the case where underscores are used instead of spaces (which is how osu-stable handles usernames with spaces).
         /// </summary>
-        public static bool checkContainsUsername(string message, string username) => message.Contains(username, StringComparison.OrdinalIgnoreCase) || message.Contains(username.Replace(' ', '_'), StringComparison.OrdinalIgnoreCase);
+        public static bool checkContainsUsername(string message, string username) {
+            string fullName = Regex.Escape(username);
+            string underscoreName = Regex.Escape(username.Replace(' ', '_'));
+            return new Regex($"\\b({fullName}|{underscoreName})\\b", RegexOptions.IgnoreCase).Matches(message).Count > 0;
+        }
 
         public class PrivateMessageNotification : OpenChannelNotification
         {

From f02e44d552495823285f23f5e9af8138b70ec2eb Mon Sep 17 00:00:00 2001
From: tbrose <tbrose@uni-bremen.de>
Date: Tue, 7 Dec 2021 01:38:37 +0100
Subject: [PATCH 1542/5547] Fixes not matching coding style

---
 osu.Game.Tests/Online/Chat/MessageNotifierTest.cs | 2 +-
 osu.Game/Online/Chat/MessageNotifier.cs           | 3 ++-
 2 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Online/Chat/MessageNotifierTest.cs b/osu.Game.Tests/Online/Chat/MessageNotifierTest.cs
index 9fed72d249..81baaef2d2 100644
--- a/osu.Game.Tests/Online/Chat/MessageNotifierTest.cs
+++ b/osu.Game.Tests/Online/Chat/MessageNotifierTest.cs
@@ -7,7 +7,7 @@ using osu.Game.Online.Chat;
 namespace osu.Game.Tests.Online.Chat
 {
     [TestFixture]
-    public class TestCheckUsername
+    public class MessageNotifierTest
     {
         [Test]
         public void TestContainsUsernameMidlinePositive()
diff --git a/osu.Game/Online/Chat/MessageNotifier.cs b/osu.Game/Online/Chat/MessageNotifier.cs
index aca9df0600..fbbf8fff38 100644
--- a/osu.Game/Online/Chat/MessageNotifier.cs
+++ b/osu.Game/Online/Chat/MessageNotifier.cs
@@ -130,7 +130,8 @@ namespace osu.Game.Online.Chat
         /// Checks if <paramref name="message"/> mentions <paramref name="username"/>.
         /// This will match against the case where underscores are used instead of spaces (which is how osu-stable handles usernames with spaces).
         /// </summary>
-        public static bool checkContainsUsername(string message, string username) {
+        public static bool checkContainsUsername(string message, string username)
+        {
             string fullName = Regex.Escape(username);
             string underscoreName = Regex.Escape(username.Replace(' ', '_'));
             return new Regex($"\\b({fullName}|{underscoreName})\\b", RegexOptions.IgnoreCase).Matches(message).Count > 0;

From 7a0d4fca17fd22f72a721bb18f20ab387dbb260d Mon Sep 17 00:00:00 2001
From: tbrose <tbrose@uni-bremen.de>
Date: Tue, 7 Dec 2021 01:41:21 +0100
Subject: [PATCH 1543/5547] Fixes using Matches+Count instead of IsMatch
 negatively affecting performance

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

diff --git a/osu.Game/Online/Chat/MessageNotifier.cs b/osu.Game/Online/Chat/MessageNotifier.cs
index fbbf8fff38..4ae4e64855 100644
--- a/osu.Game/Online/Chat/MessageNotifier.cs
+++ b/osu.Game/Online/Chat/MessageNotifier.cs
@@ -134,7 +134,7 @@ namespace osu.Game.Online.Chat
         {
             string fullName = Regex.Escape(username);
             string underscoreName = Regex.Escape(username.Replace(' ', '_'));
-            return new Regex($"\\b({fullName}|{underscoreName})\\b", RegexOptions.IgnoreCase).Matches(message).Count > 0;
+            return new Regex($"\\b({fullName}|{underscoreName})\\b", RegexOptions.IgnoreCase).IsMatch(message);
         }
 
         public class PrivateMessageNotification : OpenChannelNotification

From 0a8c4f4cecfa4e483f97decf6a6383102aadf228 Mon Sep 17 00:00:00 2001
From: tbrose <tbrose@uni-bremen.de>
Date: Tue, 7 Dec 2021 01:55:45 +0100
Subject: [PATCH 1544/5547] Adds test cases for usernames with special
 characters

---
 osu.Game.Tests/Online/Chat/MessageNotifierTest.cs | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/osu.Game.Tests/Online/Chat/MessageNotifierTest.cs b/osu.Game.Tests/Online/Chat/MessageNotifierTest.cs
index 81baaef2d2..25dbdb9ea2 100644
--- a/osu.Game.Tests/Online/Chat/MessageNotifierTest.cs
+++ b/osu.Game.Tests/Online/Chat/MessageNotifierTest.cs
@@ -62,5 +62,17 @@ namespace osu.Game.Tests.Online.Chat
         {
             Assert.IsFalse(MessageNotifier.checkContainsUsername("Test ha\u0460\u0460o message", "\u0460\u0460"));
         }
+
+        [Test]
+        public void TestContainsUsernameSpecialCharactersPositive()
+        {
+            Assert.IsTrue(MessageNotifier.checkContainsUsername("Test [#^-^#] message", "[#^-^#]"));
+        }
+
+        [Test]
+        public void TestContainsUsernameSpecialCharactersNegative()
+        {
+            Assert.IsFalse(MessageNotifier.checkContainsUsername("Test pad[#^-^#]oru message", "[#^-^#]"));
+        }
     }
 }

From 974987550ff53d9a628f6d6dbf6d9c265147e677 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Tue, 7 Dec 2021 04:01:53 +0300
Subject: [PATCH 1545/5547] Move API request response size log to correct
 logging target

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

diff --git a/osu.Game/Online/API/APIRequest.cs b/osu.Game/Online/API/APIRequest.cs
index efb0b102d0..91148c177f 100644
--- a/osu.Game/Online/API/APIRequest.cs
+++ b/osu.Game/Online/API/APIRequest.cs
@@ -42,7 +42,7 @@ namespace osu.Game.Online.API
             if (WebRequest != null)
             {
                 Response = ((OsuJsonWebRequest<T>)WebRequest).ResponseObject;
-                Logger.Log($"{GetType()} finished with response size of {WebRequest.ResponseStream.Length:#,0} bytes");
+                Logger.Log($"{GetType()} finished with response size of {WebRequest.ResponseStream.Length:#,0} bytes", LoggingTarget.Network);
             }
         }
 

From b6d47a41f411959a4fe2105f7fa25eff76f46dc2 Mon Sep 17 00:00:00 2001
From: tbrose <tbrose@uni-bremen.de>
Date: Tue, 7 Dec 2021 02:14:40 +0100
Subject: [PATCH 1546/5547] Adjusted RegEx pattern to also take special
 characters into account

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

diff --git a/osu.Game/Online/Chat/MessageNotifier.cs b/osu.Game/Online/Chat/MessageNotifier.cs
index 4ae4e64855..883f6a7284 100644
--- a/osu.Game/Online/Chat/MessageNotifier.cs
+++ b/osu.Game/Online/Chat/MessageNotifier.cs
@@ -134,7 +134,7 @@ namespace osu.Game.Online.Chat
         {
             string fullName = Regex.Escape(username);
             string underscoreName = Regex.Escape(username.Replace(' ', '_'));
-            return new Regex($"\\b({fullName}|{underscoreName})\\b", RegexOptions.IgnoreCase).IsMatch(message);
+            return new Regex($"(^|^\\W|\\W|\\w\\W)({fullName}|{underscoreName})($|$\\W|\\W|\\w\\W)", RegexOptions.IgnoreCase).IsMatch(message);
         }
 
         public class PrivateMessageNotification : OpenChannelNotification

From be86ca582cc114788c28e44fcb487e99e1c32dbf Mon Sep 17 00:00:00 2001
From: tbrose <tbrose@uni-bremen.de>
Date: Tue, 7 Dec 2021 02:34:35 +0100
Subject: [PATCH 1547/5547] Adds test cases for at-sign and colon adjacent to
 the username

---
 osu.Game.Tests/Online/Chat/MessageNotifierTest.cs | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/osu.Game.Tests/Online/Chat/MessageNotifierTest.cs b/osu.Game.Tests/Online/Chat/MessageNotifierTest.cs
index 25dbdb9ea2..b885299d1f 100644
--- a/osu.Game.Tests/Online/Chat/MessageNotifierTest.cs
+++ b/osu.Game.Tests/Online/Chat/MessageNotifierTest.cs
@@ -74,5 +74,17 @@ namespace osu.Game.Tests.Online.Chat
         {
             Assert.IsFalse(MessageNotifier.checkContainsUsername("Test pad[#^-^#]oru message", "[#^-^#]"));
         }
+
+        [Test]
+        public void TestContainsUsernameAtSign()
+        {
+            Assert.IsTrue(MessageNotifier.checkContainsUsername("@username hi", "username"));
+        }
+
+        [Test]
+        public void TestContainsUsernameColon()
+        {
+            Assert.IsTrue(MessageNotifier.checkContainsUsername("username: hi", "username"));
+        }
     }
 }

From 882223b27f684cbc9c02b4365f4f3728862a808a Mon Sep 17 00:00:00 2001
From: tbrose <tbrose@uni-bremen.de>
Date: Tue, 7 Dec 2021 02:38:10 +0100
Subject: [PATCH 1548/5547] Using static call and verbatim symbol and optimizes
 regex pattern for username check

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

diff --git a/osu.Game/Online/Chat/MessageNotifier.cs b/osu.Game/Online/Chat/MessageNotifier.cs
index 883f6a7284..db7c5e47f5 100644
--- a/osu.Game/Online/Chat/MessageNotifier.cs
+++ b/osu.Game/Online/Chat/MessageNotifier.cs
@@ -134,7 +134,7 @@ namespace osu.Game.Online.Chat
         {
             string fullName = Regex.Escape(username);
             string underscoreName = Regex.Escape(username.Replace(' ', '_'));
-            return new Regex($"(^|^\\W|\\W|\\w\\W)({fullName}|{underscoreName})($|$\\W|\\W|\\w\\W)", RegexOptions.IgnoreCase).IsMatch(message);
+            return Regex.IsMatch(message, $@"(^|\W)({fullName}|{underscoreName})($|\W)", RegexOptions.IgnoreCase);
         }
 
         public class PrivateMessageNotification : OpenChannelNotification

From f3e9fb76fcf98e7da97687b64846878af8bfc0b7 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 7 Dec 2021 13:32:35 +0900
Subject: [PATCH 1549/5547] Add the ability to pass a `CancellationToken`
 through `DifficultyCalculator.CalculateAll`

Was weirdly missing from this one method.
---
 osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs b/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs
index 01b4150030..6b6ea6fed5 100644
--- a/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs
+++ b/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs
@@ -120,14 +120,14 @@ namespace osu.Game.Rulesets.Difficulty
         /// Calculates the difficulty of the beatmap using all mod combinations applicable to the beatmap.
         /// </summary>
         /// <returns>A collection of structures describing the difficulty of the beatmap for each mod combination.</returns>
-        public IEnumerable<DifficultyAttributes> CalculateAll()
+        public IEnumerable<DifficultyAttributes> CalculateAll(CancellationToken cancellationToken = default)
         {
             foreach (var combination in CreateDifficultyAdjustmentModCombinations())
             {
                 if (combination is MultiMod multi)
-                    yield return Calculate(multi.Mods);
+                    yield return Calculate(multi.Mods, cancellationToken);
                 else
-                    yield return Calculate(combination.Yield());
+                    yield return Calculate(combination.Yield(), cancellationToken);
             }
         }
 

From cfa712473d471862634941f559d5bbd614a15086 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 7 Dec 2021 13:33:41 +0900
Subject: [PATCH 1550/5547] Use default timeout in `GetPlayableBeatmap` when
 provided `CancellationToken` is `default`

---
 osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs b/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs
index 6b6ea6fed5..6b61dd3efb 100644
--- a/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs
+++ b/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs
@@ -145,7 +145,11 @@ namespace osu.Game.Rulesets.Difficulty
         {
             playableMods = mods.Select(m => m.DeepClone()).ToArray();
 
-            Beatmap = beatmap.GetPlayableBeatmap(ruleset, playableMods, cancellationToken);
+            // Only pass through the cancellation token if it's non-default.
+            // This allows for the default timeout to be applied for playable beatmap construction.
+            Beatmap = cancellationToken == default
+                ? beatmap.GetPlayableBeatmap(ruleset, playableMods)
+                : beatmap.GetPlayableBeatmap(ruleset, playableMods, cancellationToken);
 
             var track = new TrackVirtual(10000);
             playableMods.OfType<IApplicableToTrack>().ForEach(m => m.ApplyToTrack(track));

From dea7f2308c00f673ce16d42a51d346d2d5dead5c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 7 Dec 2021 17:24:03 +0900
Subject: [PATCH 1551/5547] Fix participant panels potentially keeping a
 reference to an old user

If a user leave and then rejoins a multiplayer match while another user
is not at the lobby screen, there is a potential the `ParticipantPanel`
tracking the user will not correctly be recreated to reference the new
instance of the `MultiplayerUser`.

This happens because the `OnRoomUpdated` call is scheduled, which means
it is not running in the background, coupled with the local logic that
relies on `IEquatable(MultiplayerRoomUser)` (which in turn falls back to
a UserID comparison).

Changing this to a reference comparison is the easiest way to resolve
this. Whether we change the `IEquatable` implementation is up for
discussion.

Closes https://github.com/ppy/osu/issues/15970.
---
 .../Multiplayer/Participants/ParticipantsList.cs           | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantsList.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantsList.cs
index 2ad64e115e..d36c556fac 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantsList.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantsList.cs
@@ -77,7 +77,12 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Participants
             else
             {
                 // Remove panels for users no longer in the room.
-                panels.RemoveAll(p => !Room.Users.Contains(p.User));
+                foreach (var p in panels)
+                {
+                    // Note that we *must* use reference equality here, as this call is scheduled and a user may have left and joined since it was last run.
+                    if (Room.Users.All(u => !ReferenceEquals(p.User, u)))
+                        p.Expire();
+                }
 
                 // Add panels for all users new to the room.
                 foreach (var user in Room.Users.Except(panels.Select(p => p.User)))

From 9978caab127c3ce89ee7a77433ac2685c7f1fe55 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 7 Dec 2021 18:37:30 +0900
Subject: [PATCH 1552/5547] Update framework

---
 osu.Android.props        | 2 +-
 osu.Game/osu.Game.csproj | 2 +-
 osu.iOS.props            | 4 ++--
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Android.props b/osu.Android.props
index ce23d36faa..0c922c09ac 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -52,7 +52,7 @@
   </ItemGroup>
   <ItemGroup>
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1203.0" />
-    <PackageReference Include="ppy.osu.Framework.Android" Version="2021.1206.0" />
+    <PackageReference Include="ppy.osu.Framework.Android" Version="2021.1207.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
     <!-- Realm needs to be directly referenced in all Xamarin projects, as it will not pull in its transitive dependencies otherwise. -->
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 788a5113ad..adb25f46fe 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="10.7.1" />
-    <PackageReference Include="ppy.osu.Framework" Version="2021.1206.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2021.1207.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1203.0" />
     <PackageReference Include="Sentry" Version="3.11.1" />
     <PackageReference Include="SharpCompress" Version="0.30.0" />
diff --git a/osu.iOS.props b/osu.iOS.props
index 2aa9821e8f..db5d9af865 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -60,7 +60,7 @@
     <Reference Include="System.Net.Http" />
   </ItemGroup>
   <ItemGroup Label="Package References">
-    <PackageReference Include="ppy.osu.Framework.iOS" Version="2021.1206.0" />
+    <PackageReference Include="ppy.osu.Framework.iOS" Version="2021.1207.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1203.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net5.0 / net6.0) -->
@@ -83,7 +83,7 @@
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="2.2.6" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.Core" Version="2.2.6" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
-    <PackageReference Include="ppy.osu.Framework" Version="2021.1206.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2021.1207.0" />
     <PackageReference Include="SharpCompress" Version="0.30.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
     <PackageReference Include="SharpRaven" Version="2.4.0" />

From 5ffe702dd67e5e9444cd1f8fd9a19771011a70f3 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 7 Dec 2021 18:53:08 +0900
Subject: [PATCH 1553/5547] Add match type and queue mode to multiplayer room
 panels

---
 .../Multiplayer/TestSceneDrawableRoom.cs      | 35 +++++++++++++
 .../Lounge/Components/DrawableRoom.cs         | 31 ++++++------
 .../Lounge/Components/MatchTypePill.cs        | 50 +++++++++++++++++++
 .../Lounge/Components/QueueModePill.cs        | 50 +++++++++++++++++++
 .../OnlinePlay/Lounge/DrawableLoungeRoom.cs   | 13 +++++
 .../OnlinePlay/Match/DrawableMatchRoom.cs     |  8 +++
 6 files changed, 173 insertions(+), 14 deletions(-)
 create mode 100644 osu.Game/Screens/OnlinePlay/Lounge/Components/MatchTypePill.cs
 create mode 100644 osu.Game/Screens/OnlinePlay/Lounge/Components/QueueModePill.cs

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoom.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoom.cs
index 2c28a1752e..423822cbe4 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoom.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoom.cs
@@ -11,12 +11,14 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Testing;
 using osu.Framework.Utils;
 using osu.Game.Online.API.Requests.Responses;
+using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Rooms;
 using osu.Game.Online.Rooms.RoomStatuses;
 using osu.Game.Overlays;
 using osu.Game.Rulesets.Osu;
 using osu.Game.Screens.OnlinePlay.Lounge;
 using osu.Game.Screens.OnlinePlay.Lounge.Components;
+using osu.Game.Screens.OnlinePlay.Match;
 using osu.Game.Tests.Beatmaps;
 using osuTK;
 
@@ -172,6 +174,39 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddAssert("password icon hidden", () => Precision.AlmostEquals(0, drawableRoom.ChildrenOfType<DrawableRoom.PasswordProtectedIcon>().Single().Alpha));
         }
 
+        [Test]
+        public void TestMultiplayerRooms()
+        {
+            AddStep("create rooms", () => Child = new FillFlowContainer
+            {
+                AutoSizeAxes = Axes.Y,
+                RelativeSizeAxes = Axes.X,
+                Direction = FillDirection.Vertical,
+                Spacing = new Vector2(5),
+                Children = new[]
+                {
+                    new DrawableMatchRoom(new Room
+                    {
+                        Name = { Value = "A host-only room" },
+                        QueueMode = { Value = QueueMode.HostOnly },
+                        Type = { Value = MatchType.HeadToHead }
+                    }),
+                    new DrawableMatchRoom(new Room
+                    {
+                        Name = { Value = "An all-players, team-versus room" },
+                        QueueMode = { Value = QueueMode.AllPlayers },
+                        Type = { Value = MatchType.TeamVersus }
+                    }),
+                    new DrawableMatchRoom(new Room
+                    {
+                        Name = { Value = "A round-robin room" },
+                        QueueMode = { Value = QueueMode.AllPlayersRoundRobin },
+                        Type = { Value = MatchType.HeadToHead }
+                    }),
+                }
+            });
+        }
+
         private DrawableRoom createLoungeRoom(Room room)
         {
             room.Host.Value ??= new APIUser { Username = "peppy", Id = 2 };
diff --git a/osu.Game/Screens/OnlinePlay/Lounge/Components/DrawableRoom.cs b/osu.Game/Screens/OnlinePlay/Lounge/Components/DrawableRoom.cs
index 0502c4abe6..ba3866d734 100644
--- a/osu.Game/Screens/OnlinePlay/Lounge/Components/DrawableRoom.cs
+++ b/osu.Game/Screens/OnlinePlay/Lounge/Components/DrawableRoom.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.Extensions.Color4Extensions;
@@ -184,20 +185,7 @@ namespace osu.Game.Screens.OnlinePlay.Lounge.Components
                                             AutoSizeAxes = Axes.Both,
                                             Direction = FillDirection.Horizontal,
                                             Spacing = new Vector2(5),
-                                            Children = new Drawable[]
-                                            {
-                                                new PlaylistCountPill
-                                                {
-                                                    Anchor = Anchor.CentreLeft,
-                                                    Origin = Anchor.CentreLeft,
-                                                },
-                                                new StarRatingRangeDisplay
-                                                {
-                                                    Anchor = Anchor.CentreLeft,
-                                                    Origin = Anchor.CentreLeft,
-                                                    Scale = new Vector2(0.8f)
-                                                }
-                                            }
+                                            ChildrenEnumerable = CreateBottomDetails()
                                         }
                                     }
                                 },
@@ -287,6 +275,21 @@ namespace osu.Game.Screens.OnlinePlay.Lounge.Components
 
         protected virtual Drawable CreateBackground() => new OnlinePlayBackgroundSprite();
 
+        protected virtual IEnumerable<Drawable> CreateBottomDetails() => new Drawable[]
+        {
+            new PlaylistCountPill
+            {
+                Anchor = Anchor.CentreLeft,
+                Origin = Anchor.CentreLeft,
+            },
+            new StarRatingRangeDisplay
+            {
+                Anchor = Anchor.CentreLeft,
+                Origin = Anchor.CentreLeft,
+                Scale = new Vector2(0.8f)
+            }
+        };
+
         private class RoomNameText : OsuSpriteText
         {
             [Resolved(typeof(Room), nameof(Online.Rooms.Room.Name))]
diff --git a/osu.Game/Screens/OnlinePlay/Lounge/Components/MatchTypePill.cs b/osu.Game/Screens/OnlinePlay/Lounge/Components/MatchTypePill.cs
new file mode 100644
index 0000000000..d104ede8f7
--- /dev/null
+++ b/osu.Game/Screens/OnlinePlay/Lounge/Components/MatchTypePill.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 osu.Framework.Allocation;
+using osu.Framework.Bindables;
+using osu.Framework.Extensions;
+using osu.Framework.Graphics;
+using osu.Game.Graphics;
+using osu.Game.Graphics.Containers;
+using osu.Game.Online.Rooms;
+
+namespace osu.Game.Screens.OnlinePlay.Lounge.Components
+{
+    public class MatchTypePill : OnlinePlayComposite
+    {
+        private OsuTextFlowContainer textFlow;
+
+        public MatchTypePill()
+        {
+            AutoSizeAxes = Axes.Both;
+        }
+
+        [BackgroundDependencyLoader]
+        private void load()
+        {
+            InternalChild = new PillContainer
+            {
+                Child = textFlow = new OsuTextFlowContainer(s => s.Font = OsuFont.GetFont(size: 12))
+                {
+                    Anchor = Anchor.CentreLeft,
+                    Origin = Anchor.CentreLeft,
+                    AutoSizeAxes = Axes.Both,
+                }
+            };
+        }
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            Type.BindValueChanged(onMatchTypeChanged, true);
+        }
+
+        private void onMatchTypeChanged(ValueChangedEvent<MatchType> type)
+        {
+            textFlow.Clear();
+            textFlow.AddText(type.NewValue.GetLocalisableDescription());
+        }
+    }
+}
diff --git a/osu.Game/Screens/OnlinePlay/Lounge/Components/QueueModePill.cs b/osu.Game/Screens/OnlinePlay/Lounge/Components/QueueModePill.cs
new file mode 100644
index 0000000000..7501f0237b
--- /dev/null
+++ b/osu.Game/Screens/OnlinePlay/Lounge/Components/QueueModePill.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 osu.Framework.Allocation;
+using osu.Framework.Bindables;
+using osu.Framework.Extensions;
+using osu.Framework.Graphics;
+using osu.Game.Graphics;
+using osu.Game.Graphics.Containers;
+using osu.Game.Online.Multiplayer;
+
+namespace osu.Game.Screens.OnlinePlay.Lounge.Components
+{
+    public class QueueModePill : OnlinePlayComposite
+    {
+        private OsuTextFlowContainer textFlow;
+
+        public QueueModePill()
+        {
+            AutoSizeAxes = Axes.Both;
+        }
+
+        [BackgroundDependencyLoader]
+        private void load()
+        {
+            InternalChild = new PillContainer
+            {
+                Child = textFlow = new OsuTextFlowContainer(s => s.Font = OsuFont.GetFont(size: 12))
+                {
+                    Anchor = Anchor.CentreLeft,
+                    Origin = Anchor.CentreLeft,
+                    AutoSizeAxes = Axes.Both,
+                }
+            };
+        }
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            QueueMode.BindValueChanged(onQueueModeChanged, true);
+        }
+
+        private void onQueueModeChanged(ValueChangedEvent<QueueMode> mode)
+        {
+            textFlow.Clear();
+            textFlow.AddText(mode.NewValue.GetLocalisableDescription());
+        }
+    }
+}
diff --git a/osu.Game/Screens/OnlinePlay/Lounge/DrawableLoungeRoom.cs b/osu.Game/Screens/OnlinePlay/Lounge/DrawableLoungeRoom.cs
index 0d2b2249ef..529c056f4f 100644
--- a/osu.Game/Screens/OnlinePlay/Lounge/DrawableLoungeRoom.cs
+++ b/osu.Game/Screens/OnlinePlay/Lounge/DrawableLoungeRoom.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 osu.Framework.Allocation;
 using osu.Framework.Audio;
 using osu.Framework.Audio.Sample;
@@ -177,6 +178,18 @@ namespace osu.Game.Screens.OnlinePlay.Lounge
             return true;
         }
 
+        protected override IEnumerable<Drawable> CreateBottomDetails()
+        {
+            if (Room.Type.Value == MatchType.Playlists)
+                return base.CreateBottomDetails();
+
+            return new Drawable[]
+            {
+                new MatchTypePill(),
+                new QueueModePill(),
+            }.Concat(base.CreateBottomDetails());
+        }
+
         public class PasswordEntryPopover : OsuPopover
         {
             private readonly Room room;
diff --git a/osu.Game/Screens/OnlinePlay/Match/DrawableMatchRoom.cs b/osu.Game/Screens/OnlinePlay/Match/DrawableMatchRoom.cs
index a7b907c7d2..ed457967e7 100644
--- a/osu.Game/Screens/OnlinePlay/Match/DrawableMatchRoom.cs
+++ b/osu.Game/Screens/OnlinePlay/Match/DrawableMatchRoom.cs
@@ -2,6 +2,8 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
+using System.Collections.Generic;
+using System.Linq;
 using JetBrains.Annotations;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
@@ -67,6 +69,12 @@ namespace osu.Game.Screens.OnlinePlay.Match
 
         protected override Drawable CreateBackground() => background = new BackgroundSprite();
 
+        protected override IEnumerable<Drawable> CreateBottomDetails() => new Drawable[]
+        {
+            new MatchTypePill(),
+            new QueueModePill(),
+        }.Concat(base.CreateBottomDetails());
+
         private class BackgroundSprite : UpdateableBeatmapBackgroundSprite
         {
             protected override double LoadDelay => 0;

From 4683193f098fcf640eb80514ecee3280514cc104 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 7 Dec 2021 20:36:39 +0900
Subject: [PATCH 1554/5547] Move implementation to base class

---
 .../Lounge/Components/DrawableRoom.cs         | 38 +++++++++++++------
 .../OnlinePlay/Lounge/DrawableLoungeRoom.cs   | 13 -------
 .../OnlinePlay/Match/DrawableMatchRoom.cs     |  8 ----
 3 files changed, 27 insertions(+), 32 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Lounge/Components/DrawableRoom.cs b/osu.Game/Screens/OnlinePlay/Lounge/Components/DrawableRoom.cs
index ba3866d734..a87f21630c 100644
--- a/osu.Game/Screens/OnlinePlay/Lounge/Components/DrawableRoom.cs
+++ b/osu.Game/Screens/OnlinePlay/Lounge/Components/DrawableRoom.cs
@@ -275,20 +275,36 @@ namespace osu.Game.Screens.OnlinePlay.Lounge.Components
 
         protected virtual Drawable CreateBackground() => new OnlinePlayBackgroundSprite();
 
-        protected virtual IEnumerable<Drawable> CreateBottomDetails() => new Drawable[]
+        protected virtual IEnumerable<Drawable> CreateBottomDetails()
         {
-            new PlaylistCountPill
+            var pills = new List<Drawable>();
+
+            if (Room.Type.Value != MatchType.Playlists)
             {
-                Anchor = Anchor.CentreLeft,
-                Origin = Anchor.CentreLeft,
-            },
-            new StarRatingRangeDisplay
-            {
-                Anchor = Anchor.CentreLeft,
-                Origin = Anchor.CentreLeft,
-                Scale = new Vector2(0.8f)
+                pills.AddRange(new OnlinePlayComposite[]
+                {
+                    new MatchTypePill(),
+                    new QueueModePill(),
+                });
             }
-        };
+
+            pills.AddRange(new Drawable[]
+            {
+                new PlaylistCountPill
+                {
+                    Anchor = Anchor.CentreLeft,
+                    Origin = Anchor.CentreLeft,
+                },
+                new StarRatingRangeDisplay
+                {
+                    Anchor = Anchor.CentreLeft,
+                    Origin = Anchor.CentreLeft,
+                    Scale = new Vector2(0.8f)
+                }
+            });
+
+            return pills;
+        }
 
         private class RoomNameText : OsuSpriteText
         {
diff --git a/osu.Game/Screens/OnlinePlay/Lounge/DrawableLoungeRoom.cs b/osu.Game/Screens/OnlinePlay/Lounge/DrawableLoungeRoom.cs
index 529c056f4f..0d2b2249ef 100644
--- a/osu.Game/Screens/OnlinePlay/Lounge/DrawableLoungeRoom.cs
+++ b/osu.Game/Screens/OnlinePlay/Lounge/DrawableLoungeRoom.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.Audio;
 using osu.Framework.Audio.Sample;
@@ -178,18 +177,6 @@ namespace osu.Game.Screens.OnlinePlay.Lounge
             return true;
         }
 
-        protected override IEnumerable<Drawable> CreateBottomDetails()
-        {
-            if (Room.Type.Value == MatchType.Playlists)
-                return base.CreateBottomDetails();
-
-            return new Drawable[]
-            {
-                new MatchTypePill(),
-                new QueueModePill(),
-            }.Concat(base.CreateBottomDetails());
-        }
-
         public class PasswordEntryPopover : OsuPopover
         {
             private readonly Room room;
diff --git a/osu.Game/Screens/OnlinePlay/Match/DrawableMatchRoom.cs b/osu.Game/Screens/OnlinePlay/Match/DrawableMatchRoom.cs
index ed457967e7..a7b907c7d2 100644
--- a/osu.Game/Screens/OnlinePlay/Match/DrawableMatchRoom.cs
+++ b/osu.Game/Screens/OnlinePlay/Match/DrawableMatchRoom.cs
@@ -2,8 +2,6 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
-using System.Collections.Generic;
-using System.Linq;
 using JetBrains.Annotations;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
@@ -69,12 +67,6 @@ namespace osu.Game.Screens.OnlinePlay.Match
 
         protected override Drawable CreateBackground() => background = new BackgroundSprite();
 
-        protected override IEnumerable<Drawable> CreateBottomDetails() => new Drawable[]
-        {
-            new MatchTypePill(),
-            new QueueModePill(),
-        }.Concat(base.CreateBottomDetails());
-
         private class BackgroundSprite : UpdateableBeatmapBackgroundSprite
         {
             protected override double LoadDelay => 0;

From ded86282c1b44574b8f1fe1711766640b77b17b4 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 7 Dec 2021 23:14:35 +0900
Subject: [PATCH 1555/5547] Rename + better documentation

---
 .../Preprocessing/OsuDifficultyHitObject.cs   | 37 +++++++++++++------
 .../Difficulty/Skills/Aim.cs                  | 16 ++++----
 .../Difficulty/Skills/Flashlight.cs           |  2 +-
 .../Difficulty/Skills/Speed.cs                |  2 +-
 4 files changed, 35 insertions(+), 22 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
index f1f246359a..8ecba7375c 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
@@ -24,22 +24,35 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
         public readonly double StrainTime;
 
         /// <summary>
-        /// Normalised distance from the end position of the previous <see cref="OsuDifficultyHitObject"/> to the start position of this <see cref="OsuDifficultyHitObject"/>.
+        /// Normalised distance from the "lazy" end position of the previous <see cref="OsuDifficultyHitObject"/> to the start position of this <see cref="OsuDifficultyHitObject"/>.
+        /// <para>
+        /// The "lazy" end position is the position at which the cursor ends up if the previous hitobject is followed with as minimal movement as possible (i.e. on the edge of slider follow circles).
+        /// </para>
         /// </summary>
-        public double JumpDistance { get; private set; }
+        public double LazyJumpDistance { get; private set; }
 
         /// <summary>
-        /// Normalised minimum distance from the end position of the previous <see cref="OsuDifficultyHitObject"/> to the start position of this <see cref="OsuDifficultyHitObject"/>.
+        /// Normalised shortest distance to consider for a jump between the previous <see cref="OsuDifficultyHitObject"/> and this <see cref="OsuDifficultyHitObject"/>.
         /// </summary>
         /// <remarks>
-        /// This is bounded by <see cref="JumpDistance"/>, but may be smaller if a more natural path is able to be taken through a preceding slider.
+        /// This is bounded from above by <see cref="LazyJumpDistance"/>, and is smaller than the former if a more natural path is able to be taken through the previous <see cref="OsuDifficultyHitObject"/>.
         /// </remarks>
-        public double MovementDistance { get; private set; }
+        /// <example>
+        /// Suppose a linear slider - circle pattern.
+        /// <br />
+        /// Following the slider lazily (see: <see cref="LazyJumpDistance"/>) will result in underestimating the true end position of the slider as being closer towards the start position.
+        /// As a result, <see cref="LazyJumpDistance"/> overestimates the jump distance because the player is able to take a more natural path by following through the slider to its end,
+        /// such that the jump is felt as only starting from the slider's true end position.
+        /// <br />
+        /// Now consider a slider - circle pattern where the circle is stacked along the path inside the slider.
+        /// In this case, the lazy end position correctly estimates the true end position of the slider and provides the more natural movement path.
+        /// </example>
+        public double MinimumJumpDistance { get; private set; }
 
         /// <summary>
-        /// The time taken to travel through <see cref="MovementDistance"/>, with a minimum value of 25ms.
+        /// The time taken to travel through <see cref="MinimumJumpDistance"/>, with a minimum value of 25ms.
         /// </summary>
-        public double MovementTime { get; private set; }
+        public double MinimumJumpTime { get; private set; }
 
         /// <summary>
         /// Normalised distance between the start and end position of this <see cref="OsuDifficultyHitObject"/>.
@@ -96,14 +109,14 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
 
             Vector2 lastCursorPosition = getEndCursorPosition(lastObject);
 
-            JumpDistance = (BaseObject.StackedPosition * scalingFactor - lastCursorPosition * scalingFactor).Length;
-            MovementTime = StrainTime;
-            MovementDistance = JumpDistance;
+            LazyJumpDistance = (BaseObject.StackedPosition * scalingFactor - lastCursorPosition * scalingFactor).Length;
+            MinimumJumpTime = StrainTime;
+            MinimumJumpDistance = LazyJumpDistance;
 
             if (lastObject is Slider lastSlider)
             {
                 double lastTravelTime = Math.Max(lastSlider.LazyTravelTime / clockRate, min_delta_time);
-                MovementTime = Math.Max(StrainTime - lastTravelTime, min_delta_time);
+                MinimumJumpTime = Math.Max(StrainTime - lastTravelTime, min_delta_time);
 
                 //
                 // We'll try to better approximate the real movements a player will take in patterns following on from sliders. Consider the following slider-to-object patterns:
@@ -127,7 +140,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
                 //
 
                 float tailJumpDistance = Vector2.Subtract(lastSlider.TailCircle.StackedPosition, BaseObject.StackedPosition).Length * scalingFactor;
-                MovementDistance = Math.Max(0, Math.Min(JumpDistance - (maximum_slider_radius - assumed_slider_radius), tailJumpDistance - maximum_slider_radius));
+                MinimumJumpDistance = Math.Max(0, Math.Min(LazyJumpDistance - (maximum_slider_radius - assumed_slider_radius), tailJumpDistance - maximum_slider_radius));
             }
 
             if (lastLastObject != null && !(lastLastObject is Spinner))
diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
index d2a1083f29..a6301aed6d 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
@@ -44,24 +44,24 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
             var osuLastLastObj = (OsuDifficultyHitObject)Previous[1];
 
             // Calculate the velocity to the current hitobject, which starts with a base distance / time assuming the last object is a hitcircle.
-            double currVelocity = osuCurrObj.JumpDistance / osuCurrObj.StrainTime;
+            double currVelocity = osuCurrObj.LazyJumpDistance / osuCurrObj.StrainTime;
 
             // But if the last object is a slider, then we extend the travel velocity through the slider into the current object.
             if (osuLastObj.BaseObject is Slider && withSliders)
             {
                 double travelVelocity = osuLastObj.TravelDistance / osuLastObj.TravelTime; // calculate the slider velocity from slider head to slider end.
-                double movementVelocity = osuCurrObj.MovementDistance / osuCurrObj.MovementTime; // calculate the movement velocity from slider end to current object
+                double movementVelocity = osuCurrObj.MinimumJumpDistance / osuCurrObj.MinimumJumpTime; // calculate the movement velocity from slider end to current object
 
                 currVelocity = Math.Max(currVelocity, movementVelocity + travelVelocity); // take the larger total combined velocity.
             }
 
             // As above, do the same for the previous hitobject.
-            double prevVelocity = osuLastObj.JumpDistance / osuLastObj.StrainTime;
+            double prevVelocity = osuLastObj.LazyJumpDistance / osuLastObj.StrainTime;
 
             if (osuLastLastObj.BaseObject is Slider && withSliders)
             {
                 double travelVelocity = osuLastLastObj.TravelDistance / osuLastLastObj.TravelTime;
-                double movementVelocity = osuLastObj.MovementDistance / osuLastObj.MovementTime;
+                double movementVelocity = osuLastObj.MinimumJumpDistance / osuLastObj.MinimumJumpTime;
 
                 prevVelocity = Math.Max(prevVelocity, movementVelocity + travelVelocity);
             }
@@ -94,7 +94,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
                         acuteAngleBonus *= calcAcuteAngleBonus(lastAngle) // Multiply by previous angle, we don't want to buff unless this is a wiggle type pattern.
                                            * Math.Min(angleBonus, 125 / osuCurrObj.StrainTime) // The maximum velocity we buff is equal to 125 / strainTime
                                            * Math.Pow(Math.Sin(Math.PI / 2 * Math.Min(1, (100 - osuCurrObj.StrainTime) / 25)), 2) // scale buff from 150 bpm 1/4 to 200 bpm 1/4
-                                           * Math.Pow(Math.Sin(Math.PI / 2 * (Math.Clamp(osuCurrObj.JumpDistance, 50, 100) - 50) / 50), 2); // Buff distance exceeding 50 (radius) up to 100 (diameter).
+                                           * Math.Pow(Math.Sin(Math.PI / 2 * (Math.Clamp(osuCurrObj.LazyJumpDistance, 50, 100) - 50) / 50), 2); // Buff distance exceeding 50 (radius) up to 100 (diameter).
                     }
 
                     // Penalize wide angles if they're repeated, reducing the penalty as the lastAngle gets more acute.
@@ -107,8 +107,8 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
             if (Math.Max(prevVelocity, currVelocity) != 0)
             {
                 // We want to use the average velocity over the whole object when awarding differences, not the individual jump and slider path velocities.
-                prevVelocity = (osuLastObj.JumpDistance + osuLastLastObj.TravelDistance) / osuLastObj.StrainTime;
-                currVelocity = (osuCurrObj.JumpDistance + osuLastObj.TravelDistance) / osuCurrObj.StrainTime;
+                prevVelocity = (osuLastObj.LazyJumpDistance + osuLastLastObj.TravelDistance) / osuLastObj.StrainTime;
+                currVelocity = (osuCurrObj.LazyJumpDistance + osuLastObj.TravelDistance) / osuCurrObj.StrainTime;
 
                 // Scale with ratio of difference compared to 0.5 * max dist.
                 double distRatio = Math.Pow(Math.Sin(Math.PI / 2 * Math.Abs(prevVelocity - currVelocity) / Math.Max(prevVelocity, currVelocity)), 2);
@@ -119,7 +119,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
                 // Reward for % distance slowed down compared to previous, paying attention to not award overlap
                 double nonOverlapVelocityBuff = Math.Abs(prevVelocity - currVelocity)
                                                 // do not award overlap
-                                                * Math.Pow(Math.Sin(Math.PI / 2 * Math.Min(1, Math.Min(osuCurrObj.JumpDistance, osuLastObj.JumpDistance) / 100)), 2);
+                                                * Math.Pow(Math.Sin(Math.PI / 2 * Math.Min(1, Math.Min(osuCurrObj.LazyJumpDistance, osuLastObj.LazyJumpDistance) / 100)), 2);
 
                 // Choose the largest bonus, multiplied by ratio.
                 velocityChangeBonus = Math.Max(overlapVelocityBuff, nonOverlapVelocityBuff) * distRatio;
diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
index 466f0556ab..44ba0e2057 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
@@ -56,7 +56,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
                         smallDistNerf = Math.Min(1.0, jumpDistance / 75.0);
 
                     // We also want to nerf stacks so that only the first object of the stack is accounted for.
-                    double stackNerf = Math.Min(1.0, (osuPrevious.JumpDistance / scalingFactor) / 25.0);
+                    double stackNerf = Math.Min(1.0, (osuPrevious.LazyJumpDistance / scalingFactor) / 25.0);
 
                     result += Math.Pow(0.8, i) * stackNerf * scalingFactor * jumpDistance / cumulativeStrainTime;
                 }
diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Speed.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Speed.cs
index b53d287ee6..75a9b13bdf 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Speed.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Speed.cs
@@ -155,7 +155,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
                 speedBonus = 1 + 0.75 * Math.Pow((min_speed_bonus - strainTime) / speed_balancing_factor, 2);
 
             double travelDistance = osuPrevObj?.TravelDistance ?? 0;
-            double distance = Math.Min(single_spacing_threshold, travelDistance + osuCurrObj.JumpDistance);
+            double distance = Math.Min(single_spacing_threshold, travelDistance + osuCurrObj.LazyJumpDistance);
 
             return (speedBonus + speedBonus * Math.Pow(distance / single_spacing_threshold, 3.5)) / strainTime;
         }

From 7e236c3a4140f0023628dfe00e5b8966f2425827 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 7 Dec 2021 23:36:48 +0900
Subject: [PATCH 1556/5547] Remove unused dependency

---
 osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
index de82c463b3..c291bddeeb 100644
--- a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
+++ b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
@@ -25,7 +25,6 @@ using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Online;
 using osu.Game.Online.Chat;
-using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Rooms;
 using osu.Game.Overlays.BeatmapSet;
 using osu.Game.Rulesets;
@@ -72,9 +71,6 @@ namespace osu.Game.Screens.OnlinePlay
         [Resolved]
         private BeatmapLookupCache beatmapLookupCache { get; set; }
 
-        [Resolved]
-        private MultiplayerClient multiplayerClient { get; set; }
-
         private PanelBackground panelBackground;
 
         private readonly DelayedLoadWrapper onScreenLoader = new DelayedLoadWrapper(Empty) { RelativeSizeAxes = Axes.Both };

From 25a0505c97df49a825d874551afc69daf0972c47 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 6 Dec 2021 14:26:11 +0900
Subject: [PATCH 1557/5547] Scale card when expanding to better distinguish
 hovered card from other cards in listing

---
 osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs   | 14 +++++++++++++-
 .../Beatmaps/Drawables/Cards/BeatmapCardContent.cs |  3 +++
 2 files changed, 16 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
index 9031d6df1a..d93ac841ab 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
@@ -285,7 +285,13 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                                                         content.ScheduleShow();
                                                         return false;
                                                     },
-                                                    Unhovered = _ => content.ScheduleHide()
+                                                    Unhovered = _ =>
+                                                    {
+                                                        // This hide should only trigger if the expanded content has not shown yet.
+                                                        // ie. if the user has not shown intent to want to see it (quickly moved over the info row area).
+                                                        if (!Expanded.Value)
+                                                            content.ScheduleHide();
+                                                    }
                                                 }
                                             }
                                         },
@@ -360,6 +366,8 @@ namespace osu.Game.Beatmaps.Drawables.Cards
 
         protected override void OnHoverLost(HoverLostEvent e)
         {
+            content.ScheduleHide();
+
             updateState();
             base.OnHoverLost(e);
         }
@@ -398,6 +406,10 @@ namespace osu.Game.Beatmaps.Drawables.Cards
 
             thumbnail.Dimmed.Value = showDetails;
 
+            // Scale value is intentionally chosen to fit in the spacing of listing displays, as to not overlap horizontally with adjacent cards.
+            // This avoids depth issues where a hovered (scaled) card to the right of another card would be beneath the card to the left.
+            content.ScaleTo(Expanded.Value ? 1.03f : 1, 500, Easing.OutQuint);
+
             mainContent.ResizeWidthTo(targetWidth, TRANSITION_DURATION, Easing.OutQuint);
             mainContentBackground.Dimmed.Value = showDetails;
 
diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardContent.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardContent.cs
index 7f94d0e3b7..681f09c658 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardContent.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardContent.cs
@@ -45,6 +45,9 @@ namespace osu.Game.Beatmaps.Drawables.Cards
             RelativeSizeAxes = Axes.X;
             Height = height;
 
+            Anchor = Anchor.Centre;
+            Origin = Anchor.Centre;
+
             InternalChild = content = new HoverHandlingContainer
             {
                 RelativeSizeAxes = Axes.X,

From 0b0ff361542521ea066c06d2bad6955c2905873a Mon Sep 17 00:00:00 2001
From: Susko3 <16479013+Susko3@users.noreply.github.com>
Date: Tue, 7 Dec 2021 20:06:22 +0100
Subject: [PATCH 1558/5547] Allow only number characters parseable by
 `int.TryParse`

char.IsNumber() is too broad, allowing full width and other numbers.
---
 osu.Game/Overlays/Settings/SettingsNumberBox.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/Settings/SettingsNumberBox.cs b/osu.Game/Overlays/Settings/SettingsNumberBox.cs
index cbe9f7fc64..0a4949f8b6 100644
--- a/osu.Game/Overlays/Settings/SettingsNumberBox.cs
+++ b/osu.Game/Overlays/Settings/SettingsNumberBox.cs
@@ -67,7 +67,7 @@ namespace osu.Game.Overlays.Settings
 
         private class OutlinedNumberBox : OutlinedTextBox
         {
-            protected override bool CanAddCharacter(char character) => char.IsNumber(character);
+            protected override bool CanAddCharacter(char character) => character >= '0' && character <= '9';
 
             public new void NotifyInputError() => base.NotifyInputError();
         }

From e9694dc74e0514dae02e0ba65538ac2f8e76f613 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 7 Dec 2021 20:40:10 +0100
Subject: [PATCH 1559/5547] Wait for match type changes in team versus test

---
 osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs
index 981989c28a..ccce26ad31 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs
@@ -77,7 +77,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 }
             });
 
-            AddAssert("room type is team vs", () => client.Room?.Settings.MatchType == MatchType.TeamVersus);
+            AddUntilStep("room type is team vs", () => client.Room?.Settings.MatchType == MatchType.TeamVersus);
             AddAssert("user state arrived", () => client.Room?.Users.FirstOrDefault()?.MatchState is TeamVersusUserState);
         }
 
@@ -162,13 +162,13 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 }
             });
 
-            AddAssert("room type is head to head", () => client.Room?.Settings.MatchType == MatchType.HeadToHead);
+            AddUntilStep("room type is head to head", () => client.Room?.Settings.MatchType == MatchType.HeadToHead);
 
             AddUntilStep("team displays are not displaying teams", () => multiplayerScreenStack.ChildrenOfType<TeamDisplay>().All(d => d.DisplayedTeam == null));
 
             AddStep("change to team vs", () => client.ChangeSettings(matchType: MatchType.TeamVersus));
 
-            AddAssert("room type is team vs", () => client.Room?.Settings.MatchType == MatchType.TeamVersus);
+            AddUntilStep("room type is team vs", () => client.Room?.Settings.MatchType == MatchType.TeamVersus);
 
             AddUntilStep("team displays are displaying teams", () => multiplayerScreenStack.ChildrenOfType<TeamDisplay>().All(d => d.DisplayedTeam != null));
         }

From 10dd64e07c89165ee5b437f13c36cab09c9eec2b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 7 Dec 2021 21:00:25 +0100
Subject: [PATCH 1560/5547] Fix being able to paste objects while composer is
 loading

Would lead to exceptions due to modification of `Beatmap.HitObjects`
during its enumeration by `DrawableRuleset`, which was happening as an
async load via `EditorScreenWithTimeline.CreateMainContent()`.
---
 osu.Game/Screens/Edit/Compose/ComposeScreen.cs | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/Edit/Compose/ComposeScreen.cs b/osu.Game/Screens/Edit/Compose/ComposeScreen.cs
index 3b02d42b41..9386538a78 100644
--- a/osu.Game/Screens/Edit/Compose/ComposeScreen.cs
+++ b/osu.Game/Screens/Edit/Compose/ComposeScreen.cs
@@ -83,7 +83,9 @@ namespace osu.Game.Screens.Edit.Compose
         {
             base.LoadComplete();
             EditorBeatmap.SelectedHitObjects.BindCollectionChanged((_, __) => updateClipboardActionAvailability());
-            clipboard.BindValueChanged(_ => updateClipboardActionAvailability(), true);
+            clipboard.BindValueChanged(_ => updateClipboardActionAvailability());
+            composer.OnLoadComplete += _ => updateClipboardActionAvailability();
+            updateClipboardActionAvailability();
         }
 
         #region Clipboard operations
@@ -131,7 +133,7 @@ namespace osu.Game.Screens.Edit.Compose
         private void updateClipboardActionAvailability()
         {
             CanCut.Value = CanCopy.Value = EditorBeatmap.SelectedHitObjects.Any();
-            CanPaste.Value = !string.IsNullOrEmpty(clipboard.Value);
+            CanPaste.Value = composer.IsLoaded && !string.IsNullOrEmpty(clipboard.Value);
         }
 
         private string formatSelectionAsString()

From 7720a1b69b87f85b09440d1f5e62a4b8ab14fda7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 7 Dec 2021 21:10:45 +0100
Subject: [PATCH 1561/5547] Fix test to wait for drawable ruleset load before
 attempting paste

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

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneDifficultySwitching.cs b/osu.Game.Tests/Visual/Editing/TestSceneDifficultySwitching.cs
index c81a1abfbc..c23db5e440 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneDifficultySwitching.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneDifficultySwitching.cs
@@ -10,6 +10,7 @@ using osu.Game.Beatmaps;
 using osu.Game.Overlays.Dialog;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Osu;
+using osu.Game.Rulesets.UI;
 using osu.Game.Screens.Edit;
 using osu.Game.Tests.Beatmaps.IO;
 
@@ -89,6 +90,7 @@ namespace osu.Game.Tests.Visual.Editing
             confirmEditingBeatmap(() => targetDifficulty);
 
             AddAssert("no objects selected", () => !EditorBeatmap.SelectedHitObjects.Any());
+            AddUntilStep("wait for drawable ruleset", () => Editor.ChildrenOfType<DrawableRuleset>().SingleOrDefault()?.IsLoaded == true);
             AddStep("paste object", () => Editor.Paste());
 
             if (sameRuleset)

From fea3b9d7a9c1a0cc87e3473dec0af49c25007fb1 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 8 Dec 2021 04:43:01 +0300
Subject: [PATCH 1562/5547] Disable minimum frame durations on osu! for iOS

---
 osu.Game.Rulesets.Catch.Tests.iOS/Info.plist | 2 ++
 osu.Game.Rulesets.Mania.Tests.iOS/Info.plist | 2 ++
 osu.Game.Rulesets.Osu.Tests.iOS/Info.plist   | 2 ++
 osu.Game.Rulesets.Taiko.Tests.iOS/Info.plist | 2 ++
 osu.Game.Tests.iOS/Info.plist                | 2 ++
 osu.iOS/Info.plist                           | 2 ++
 6 files changed, 12 insertions(+)

diff --git a/osu.Game.Rulesets.Catch.Tests.iOS/Info.plist b/osu.Game.Rulesets.Catch.Tests.iOS/Info.plist
index 5115746cbb..3ba1886d98 100644
--- a/osu.Game.Rulesets.Catch.Tests.iOS/Info.plist
+++ b/osu.Game.Rulesets.Catch.Tests.iOS/Info.plist
@@ -32,5 +32,7 @@
 	</array>
 	<key>XSAppIconAssets</key>
 	<string>Assets.xcassets/AppIcon.appiconset</string>
+	<key>CADisableMinimumFrameDurationOnPhone</key>
+	<true/>
 </dict>
 </plist>
diff --git a/osu.Game.Rulesets.Mania.Tests.iOS/Info.plist b/osu.Game.Rulesets.Mania.Tests.iOS/Info.plist
index 8780204d5b..09ed2dd007 100644
--- a/osu.Game.Rulesets.Mania.Tests.iOS/Info.plist
+++ b/osu.Game.Rulesets.Mania.Tests.iOS/Info.plist
@@ -32,5 +32,7 @@
 	</array>
 	<key>XSAppIconAssets</key>
 	<string>Assets.xcassets/AppIcon.appiconset</string>
+	<key>CADisableMinimumFrameDurationOnPhone</key>
+	<true/>
 </dict>
 </plist>
diff --git a/osu.Game.Rulesets.Osu.Tests.iOS/Info.plist b/osu.Game.Rulesets.Osu.Tests.iOS/Info.plist
index f79215cf54..dd032ef1c1 100644
--- a/osu.Game.Rulesets.Osu.Tests.iOS/Info.plist
+++ b/osu.Game.Rulesets.Osu.Tests.iOS/Info.plist
@@ -32,5 +32,7 @@
 	</array>
 	<key>XSAppIconAssets</key>
 	<string>Assets.xcassets/AppIcon.appiconset</string>
+	<key>CADisableMinimumFrameDurationOnPhone</key>
+	<true/>
 </dict>
 </plist>
diff --git a/osu.Game.Rulesets.Taiko.Tests.iOS/Info.plist b/osu.Game.Rulesets.Taiko.Tests.iOS/Info.plist
index 5fe822946a..ac658cd14e 100644
--- a/osu.Game.Rulesets.Taiko.Tests.iOS/Info.plist
+++ b/osu.Game.Rulesets.Taiko.Tests.iOS/Info.plist
@@ -32,5 +32,7 @@
 	</array>
 	<key>XSAppIconAssets</key>
 	<string>Assets.xcassets/AppIcon.appiconset</string>
+	<key>CADisableMinimumFrameDurationOnPhone</key>
+	<true/>
 </dict>
 </plist>
diff --git a/osu.Game.Tests.iOS/Info.plist b/osu.Game.Tests.iOS/Info.plist
index 98a4223116..1a89345bc5 100644
--- a/osu.Game.Tests.iOS/Info.plist
+++ b/osu.Game.Tests.iOS/Info.plist
@@ -32,5 +32,7 @@
 	</array>
 	<key>XSAppIconAssets</key>
 	<string>Assets.xcassets/AppIcon.appiconset</string>
+	<key>CADisableMinimumFrameDurationOnPhone</key>
+	<true/>
 </dict>
 </plist>
diff --git a/osu.iOS/Info.plist b/osu.iOS/Info.plist
index 249474b1d7..2592f909ce 100644
--- a/osu.iOS/Info.plist
+++ b/osu.iOS/Info.plist
@@ -33,6 +33,8 @@
 	<true/>
 	<key>UIStatusBarHidden</key>
 	<true/>
+	<key>CADisableMinimumFrameDurationOnPhone</key>
+	<true/>
 	<key>NSCameraUsageDescription</key>
 	<string>We don&apos;t really use the camera.</string>
 	<key>NSMicrophoneUsageDescription</key>

From a969fe3ef811a64c0e05a70342645782dd9d4f77 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 8 Dec 2021 13:37:46 +0900
Subject: [PATCH 1563/5547] Add test coverage showing intended UX of user's
 volume levels being retained when unmuting

---
 osu.Game.Tests/Visual/Gameplay/TestScenePlayerLoader.cs | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestScenePlayerLoader.cs b/osu.Game.Tests/Visual/Gameplay/TestScenePlayerLoader.cs
index 06eaa726c9..958d617d63 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestScenePlayerLoader.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestScenePlayerLoader.cs
@@ -251,7 +251,12 @@ namespace osu.Game.Tests.Visual.Gameplay
         [Test]
         public void TestMutedNotificationMuteButton()
         {
-            addVolumeSteps("mute button", () => volumeOverlay.IsMuted.Value = true, () => !volumeOverlay.IsMuted.Value);
+            addVolumeSteps("mute button", () =>
+            {
+                // Importantly, in the case the volume is muted but the user has a volume level set, it should be retained.
+                audioManager.VolumeTrack.Value = 0.5f;
+                volumeOverlay.IsMuted.Value = true;
+            }, () => !volumeOverlay.IsMuted.Value && audioManager.VolumeTrack.Value == 0.5f);
         }
 
         /// <remarks>

From 0775053a18a711c8eb9fff57a26ff80c8b98caca Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 8 Dec 2021 13:38:13 +0900
Subject: [PATCH 1564/5547] Fix the unmute notification potentially overwriting
 user's volume levels unnecessarily

I've also changed the cutoffs to 5% rather than zero, as this seems like
a saner method of showing this dialog. With levels 5% or less, the game
is basically inaudible.

Arguably, the cutoff can be increased to 10%.
---
 osu.Game/Screens/Play/PlayerLoader.cs | 14 ++++++++++----
 1 file changed, 10 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Screens/Play/PlayerLoader.cs b/osu.Game/Screens/Play/PlayerLoader.cs
index 57db411571..dfc3c2b61d 100644
--- a/osu.Game/Screens/Play/PlayerLoader.cs
+++ b/osu.Game/Screens/Play/PlayerLoader.cs
@@ -468,12 +468,14 @@ namespace osu.Game.Screens.Play
 
         private int restartCount;
 
+        private const double volume_requirement = 0.05;
+
         private void showMuteWarningIfNeeded()
         {
             if (!muteWarningShownOnce.Value)
             {
                 // Checks if the notification has not been shown yet and also if master volume is muted, track/music volume is muted or if the whole game is muted.
-                if (volumeOverlay?.IsMuted.Value == true || audioManager.Volume.Value <= audioManager.Volume.MinValue || audioManager.VolumeTrack.Value <= audioManager.VolumeTrack.MinValue)
+                if (volumeOverlay?.IsMuted.Value == true || audioManager.Volume.Value <= volume_requirement || audioManager.VolumeTrack.Value <= volume_requirement)
                 {
                     notificationOverlay?.Post(new MutedNotification());
                     muteWarningShownOnce.Value = true;
@@ -487,7 +489,7 @@ namespace osu.Game.Screens.Play
 
             public MutedNotification()
             {
-                Text = "Your music volume is set to 0%! Click here to restore it.";
+                Text = "Your game volume is too low to hear anything! Click here to restore it.";
             }
 
             [BackgroundDependencyLoader]
@@ -501,8 +503,12 @@ namespace osu.Game.Screens.Play
                     notificationOverlay.Hide();
 
                     volumeOverlay.IsMuted.Value = false;
-                    audioManager.Volume.SetDefault();
-                    audioManager.VolumeTrack.SetDefault();
+
+                    // Check values before resetting, as the user may have only had mute enabled, in which case we might not need to adjust volumes.
+                    if (audioManager.Volume.Value < volume_requirement)
+                        audioManager.Volume.SetDefault();
+                    if (audioManager.VolumeTrack.Value < volume_requirement)
+                        audioManager.VolumeTrack.SetDefault();
 
                     return true;
                 };

From 7c0f7b1baac4fbc16791f2208605f7a77ec78920 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 8 Dec 2021 14:57:21 +0900
Subject: [PATCH 1565/5547] Use "x" for cursor position in diagrams

---
 .../Preprocessing/OsuDifficultyHitObject.cs      | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
index 8ecba7375c..1b6914bfaf 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
@@ -121,20 +121,20 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
                 //
                 // We'll try to better approximate the real movements a player will take in patterns following on from sliders. Consider the following slider-to-object patterns:
                 //
-                // 1.  <======o==>
+                // 1.  <======x==>
                 //            | /
-                //            o
+                //            x
                 //
-                // 2.  <======o==>---o
+                // 2.  <======x==>---x
                 //            |______|
                 //
-                // Where "<==>" represents a slider, and "o" represents where the cursor needs to be for either hitobject (for a slider, this is the lazy cursor position).
+                // Where "<==>" represents a slider, and "x" represents where the cursor needs to be for either hitobject (for a slider, this is the lazy cursor position).
                 //
-                // The pattern (o--o) has distance JumpDistance.
-                // The pattern (>--o) is a new distance we'll call "tailJumpDistance".
+                // The pattern (x--x) has distance JumpDistance.
+                // The pattern (>--x) is a new distance we'll call "tailJumpDistance".
                 //
-                // Case (1) is an anti-flow pattern, where players will cut the slider short in order to move to the next object. The most natural jump pattern is (o--o).
-                // Case (2) is a flow pattern, where players will follow the slider through to its visual extent. The most natural jump pattern is (>--o).
+                // Case (1) is an anti-flow pattern, where players will cut the slider short in order to move to the next object. The most natural jump pattern is (x--x).
+                // Case (2) is a flow pattern, where players will follow the slider through to its visual extent. The most natural jump pattern is (>--x).
                 //
                 // A lenience is applied by assuming that the player jumps the minimum of these two distances in all cases.
                 //

From 6ec3f41839a6c8a3a6cca8c75162d7c100336605 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 8 Dec 2021 14:56:38 +0900
Subject: [PATCH 1566/5547] Fix `LegacyComboCounter` not handling non-default
 anchor/origin specifications correctly

---
 .../Screens/Play/HUD/LegacyComboCounter.cs    | 43 ++++++++++---------
 1 file changed, 23 insertions(+), 20 deletions(-)

diff --git a/osu.Game/Screens/Play/HUD/LegacyComboCounter.cs b/osu.Game/Screens/Play/HUD/LegacyComboCounter.cs
index 4859f1b977..f1078c5d55 100644
--- a/osu.Game/Screens/Play/HUD/LegacyComboCounter.cs
+++ b/osu.Game/Screens/Play/HUD/LegacyComboCounter.cs
@@ -67,22 +67,32 @@ namespace osu.Game.Screens.Play.HUD
 
             Scale = new Vector2(1.2f);
 
-            InternalChild = counterContainer = new Container
+            InternalChildren = new[]
             {
-                AutoSizeAxes = Axes.Both,
-                AlwaysPresent = true,
-                Children = new[]
+                popOutCount = new LegacySpriteText(LegacyFont.Combo)
                 {
-                    popOutCount = new LegacySpriteText(LegacyFont.Combo)
+                    Alpha = 0,
+                    Margin = new MarginPadding(0.05f),
+                    Blending = BlendingParameters.Additive,
+                    Anchor = Anchor.BottomLeft,
+                    Origin = Anchor.BottomLeft,
+                    BypassAutoSizeAxes = Axes.Both,
+                },
+                counterContainer = new Container
+                {
+                    AutoSizeAxes = Axes.Both,
+                    AlwaysPresent = true,
+                    Children = new[]
                     {
-                        Alpha = 0,
-                        Margin = new MarginPadding(0.05f),
-                        Blending = BlendingParameters.Additive,
-                    },
-                    displayedCountSpriteText = new LegacySpriteText(LegacyFont.Combo)
-                    {
-                        Alpha = 0,
-                    },
+                        displayedCountSpriteText = new LegacySpriteText(LegacyFont.Combo)
+                        {
+                            // Initial text and AlwaysPresent allow the counter to have a size before it first displays a combo.
+                            // This is useful for display in the skin editor.
+                            Text = formatCount(0),
+                            AlwaysPresent = true,
+                            Alpha = 0,
+                        },
+                    }
                 }
             };
         }
@@ -121,13 +131,6 @@ namespace osu.Game.Screens.Play.HUD
 
             ((IHasText)displayedCountSpriteText).Text = formatCount(Current.Value);
 
-            counterContainer.Anchor = Anchor;
-            counterContainer.Origin = Origin;
-            displayedCountSpriteText.Anchor = Anchor;
-            displayedCountSpriteText.Origin = Origin;
-            popOutCount.Anchor = Anchor;
-            popOutCount.Origin = Origin;
-
             Current.BindValueChanged(combo => updateCount(combo.NewValue == 0), true);
         }
 

From 814f072767f52ceb576eb8d7ecfdeceb14340ae7 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 8 Dec 2021 15:17:56 +0900
Subject: [PATCH 1567/5547] Use new LazyJumpDistance terminology in
 documentation

---
 .../Difficulty/Preprocessing/OsuDifficultyHitObject.cs          | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
index 1b6914bfaf..6c354cfa99 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
@@ -130,7 +130,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
                 //
                 // Where "<==>" represents a slider, and "x" represents where the cursor needs to be for either hitobject (for a slider, this is the lazy cursor position).
                 //
-                // The pattern (x--x) has distance JumpDistance.
+                // The pattern (x--x) has distance LazyJumpDistance.
                 // The pattern (>--x) is a new distance we'll call "tailJumpDistance".
                 //
                 // Case (1) is an anti-flow pattern, where players will cut the slider short in order to move to the next object. The most natural jump pattern is (x--x).

From 872e0884c0a0997a16c23fcb1b394688409d5803 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 8 Dec 2021 15:22:02 +0900
Subject: [PATCH 1568/5547] Fix the local user's rank not showing on
 multiplayer/playlist results screen

Applying the simple solution for now. Not sure how this will evolve over
time, but seems sane enough.
---
 osu.Game/Screens/Play/SubmittingPlayer.cs | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/osu.Game/Screens/Play/SubmittingPlayer.cs b/osu.Game/Screens/Play/SubmittingPlayer.cs
index 76411c8c6b..c07cfa9c4d 100644
--- a/osu.Game/Screens/Play/SubmittingPlayer.cs
+++ b/osu.Game/Screens/Play/SubmittingPlayer.cs
@@ -157,6 +157,8 @@ namespace osu.Game.Screens.Play
             request.Success += s =>
             {
                 score.ScoreInfo.OnlineScoreID = s.ID;
+                score.ScoreInfo.Position = s.Position;
+
                 scoreSubmissionSource.SetResult(true);
             };
 

From 11104124f1f923fa4c1f6bf06ac2441a7ac3cc0c Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 8 Dec 2021 15:52:59 +0900
Subject: [PATCH 1569/5547] Restructure doc for easier readability

---
 .../Preprocessing/OsuDifficultyHitObject.cs   | 25 ++++++++++---------
 1 file changed, 13 insertions(+), 12 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
index 6c354cfa99..2c81b42e6c 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
@@ -119,24 +119,25 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
                 MinimumJumpTime = Math.Max(StrainTime - lastTravelTime, min_delta_time);
 
                 //
-                // We'll try to better approximate the real movements a player will take in patterns following on from sliders. Consider the following slider-to-object patterns:
+                // There are two types of slider-to-object patterns to consider in order to better approximate the real movements a player will take.
                 //
-                // 1.  <======x==>
-                //            | /
-                //            x
+                // 1. The anti-flow pattern, where players cut the slider short in order to move to the next hitobject.
                 //
-                // 2.  <======x==>---x
-                //            |______|
+                //      <======o==>  ← slider
+                //             |     ← most natural jump path
+                //             o     ← a follow-up hitcircle
                 //
-                // Where "<==>" represents a slider, and "x" represents where the cursor needs to be for either hitobject (for a slider, this is the lazy cursor position).
+                // In this case the most natural jump path (o--o) is approximated by LazyJumpDistance.
                 //
-                // The pattern (x--x) has distance LazyJumpDistance.
-                // The pattern (>--x) is a new distance we'll call "tailJumpDistance".
+                // 2. The flow pattern, where players follow through the slider to its visual extent into the next hitobject.
                 //
-                // Case (1) is an anti-flow pattern, where players will cut the slider short in order to move to the next object. The most natural jump pattern is (x--x).
-                // Case (2) is a flow pattern, where players will follow the slider through to its visual extent. The most natural jump pattern is (>--x).
+                //      <======o==>---o
+                //                  ↑
+                //        most natural jump path
                 //
-                // A lenience is applied by assuming that the player jumps the minimum of these two distances in all cases.
+                // In this case the most natural movement path is better approximated by a new distance called "tailJumpDistance" - the distance between the slider's tail and the next hitobject.
+                //
+                // Thus, the player is assumed to jump the minimum of these two distances in all cases.
                 //
 
                 float tailJumpDistance = Vector2.Subtract(lastSlider.TailCircle.StackedPosition, BaseObject.StackedPosition).Length * scalingFactor;

From 99991a6703887ffa1b95b4217005bf81db15be4d Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 8 Dec 2021 15:59:15 +0900
Subject: [PATCH 1570/5547] Minor cleanups, unifying wording a bit more

---
 .../Difficulty/Preprocessing/OsuDifficultyHitObject.cs      | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
index 2c81b42e6c..4df8ff0b12 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
@@ -119,7 +119,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
                 MinimumJumpTime = Math.Max(StrainTime - lastTravelTime, min_delta_time);
 
                 //
-                // There are two types of slider-to-object patterns to consider in order to better approximate the real movements a player will take.
+                // There are two types of slider-to-object patterns to consider in order to better approximate the real movement a player will take to jump between the hitobjects.
                 //
                 // 1. The anti-flow pattern, where players cut the slider short in order to move to the next hitobject.
                 //
@@ -127,7 +127,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
                 //             |     ← most natural jump path
                 //             o     ← a follow-up hitcircle
                 //
-                // In this case the most natural jump path (o--o) is approximated by LazyJumpDistance.
+                // In this case the most natural jump path is approximated by LazyJumpDistance.
                 //
                 // 2. The flow pattern, where players follow through the slider to its visual extent into the next hitobject.
                 //
@@ -135,7 +135,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
                 //                  ↑
                 //        most natural jump path
                 //
-                // In this case the most natural movement path is better approximated by a new distance called "tailJumpDistance" - the distance between the slider's tail and the next hitobject.
+                // In this case the most natural jump path is better approximated by a new distance called "tailJumpDistance" - the distance between the slider's tail and the next hitobject.
                 //
                 // Thus, the player is assumed to jump the minimum of these two distances in all cases.
                 //

From af1e97b7c73fb476c9208051d8f47fa9aa579837 Mon Sep 17 00:00:00 2001
From: Susko3 <16479013+Susko3@users.noreply.github.com>
Date: Wed, 8 Dec 2021 09:49:36 +0100
Subject: [PATCH 1571/5547] Move playing text added samples to private helper
 and fix it never playing the last sample

`RNG.Next` is exclusive of the upper bound, meaning that the last sample would never be played.
---
 osu.Game/Graphics/UserInterface/OsuTextBox.cs | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Graphics/UserInterface/OsuTextBox.cs b/osu.Game/Graphics/UserInterface/OsuTextBox.cs
index 96319b9fdd..145e51b05a 100644
--- a/osu.Game/Graphics/UserInterface/OsuTextBox.cs
+++ b/osu.Game/Graphics/UserInterface/OsuTextBox.cs
@@ -86,6 +86,8 @@ namespace osu.Game.Graphics.UserInterface
 
         protected override Color4 SelectionColour => selectionColour;
 
+        private void playTextAddedSample() => textAddedSamples[RNG.Next(0, textAddedSamples.Length)]?.Play();
+
         protected override void OnUserTextAdded(string added)
         {
             base.OnUserTextAdded(added);
@@ -93,7 +95,7 @@ namespace osu.Game.Graphics.UserInterface
             if (added.Any(char.IsUpper) && AllowUniqueCharacterSamples)
                 capsTextAddedSample?.Play();
             else
-                textAddedSamples[RNG.Next(0, 3)]?.Play();
+                playTextAddedSample();
         }
 
         protected override void OnUserTextRemoved(string removed)

From de89e321c8e57d3b914bbbbdb05c774e5cc43ed1 Mon Sep 17 00:00:00 2001
From: Susko3 <16479013+Susko3@users.noreply.github.com>
Date: Wed, 8 Dec 2021 09:57:53 +0100
Subject: [PATCH 1572/5547] Add sounds for IME composition

---
 osu.Game/Graphics/UserInterface/OsuTextBox.cs | 64 +++++++++++++++++++
 1 file changed, 64 insertions(+)

diff --git a/osu.Game/Graphics/UserInterface/OsuTextBox.cs b/osu.Game/Graphics/UserInterface/OsuTextBox.cs
index 145e51b05a..709f64d16d 100644
--- a/osu.Game/Graphics/UserInterface/OsuTextBox.cs
+++ b/osu.Game/Graphics/UserInterface/OsuTextBox.cs
@@ -119,6 +119,70 @@ namespace osu.Game.Graphics.UserInterface
             caretMovedSample?.Play();
         }
 
+        protected override void OnImeComposition(string newComposition, int removedTextLength, int addedTextLength, bool caretMoved)
+        {
+            base.OnImeComposition(newComposition, removedTextLength, addedTextLength, caretMoved);
+
+            if (string.IsNullOrEmpty(newComposition))
+            {
+                switch (removedTextLength)
+                {
+                    case 0:
+                        // empty composition event, composition wasn't changed, don't play anything.
+                        return;
+
+                    case 1:
+                        // composition probably ended by pressing backspace, or was cancelled.
+                        textRemovedSample?.Play();
+                        return;
+
+                    default:
+                        // longer text removed, composition ended because it was cancelled.
+                        // could be a different sample if desired.
+                        textRemovedSample?.Play();
+                        return;
+                }
+            }
+
+            if (addedTextLength > 0)
+            {
+                // some text was added, probably due to typing new text or by changing the candidate.
+                playTextAddedSample();
+                return;
+            }
+
+            if (removedTextLength > 0)
+            {
+                // text was probably removed by backspacing.
+                // it's also possible that a candidate that only removed text was changed to.
+                textRemovedSample?.Play();
+                return;
+            }
+
+            if (caretMoved)
+            {
+                // only the caret/selection was moved.
+                caretMovedSample?.Play();
+            }
+        }
+
+        protected override void OnImeResult(string result, bool successful)
+        {
+            base.OnImeResult(result, successful);
+
+            if (successful)
+            {
+                // composition was successfully completed, usually by pressing the enter key.
+                textCommittedSample?.Play();
+            }
+            else
+            {
+                // composition was prematurely ended, eg. by clicking inside the textbox.
+                // could be a different sample if desired.
+                textCommittedSample?.Play();
+            }
+        }
+
         protected override void OnFocus(FocusEvent e)
         {
             BorderThickness = 3;

From 8fa73fcbf695c21911c8c9afda25fe9ee49e1928 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 8 Dec 2021 18:30:08 +0900
Subject: [PATCH 1573/5547] Move helper method to end of class

---
 osu.Game/Graphics/UserInterface/OsuTextBox.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Graphics/UserInterface/OsuTextBox.cs b/osu.Game/Graphics/UserInterface/OsuTextBox.cs
index 709f64d16d..6db3068d84 100644
--- a/osu.Game/Graphics/UserInterface/OsuTextBox.cs
+++ b/osu.Game/Graphics/UserInterface/OsuTextBox.cs
@@ -86,8 +86,6 @@ namespace osu.Game.Graphics.UserInterface
 
         protected override Color4 SelectionColour => selectionColour;
 
-        private void playTextAddedSample() => textAddedSamples[RNG.Next(0, textAddedSamples.Length)]?.Play();
-
         protected override void OnUserTextAdded(string added)
         {
             base.OnUserTextAdded(added);
@@ -208,6 +206,8 @@ namespace osu.Game.Graphics.UserInterface
             SelectionColour = SelectionColour,
         };
 
+        private void playTextAddedSample() => textAddedSamples[RNG.Next(0, textAddedSamples.Length)]?.Play();
+
         private class OsuCaret : Caret
         {
             private const float caret_move_time = 60;

From beb5d61a42cc69841cfdbb1c8de0cc36d5973535 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 8 Dec 2021 20:38:18 +0900
Subject: [PATCH 1574/5547] Separate playlist item deletion to
 Playlists-specific class

---
 .../TestSceneDrawableRoomPlaylist.cs          |  97 +--------
 .../TestScenePlaylistsRoomPlaylist.cs         | 188 ++++++++++++++++++
 .../Components/MatchBeatmapDetailArea.cs      |   3 +-
 .../OnlinePlay/DrawableRoomPlaylist.cs        |  40 +---
 .../DrawableRoomPlaylistWithResults.cs        |   2 +-
 .../Playlists/PlaylistsRoomPlaylist.cs        |  24 +++
 .../Playlists/PlaylistsRoomSettingsOverlay.cs |   5 +-
 7 files changed, 227 insertions(+), 132 deletions(-)
 create mode 100644 osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsRoomPlaylist.cs
 create mode 100644 osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomPlaylist.cs

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
index 55aa665ff1..c60b55d7e8 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
@@ -128,95 +128,6 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddAssert("item 1 is selected", () => playlist.SelectedItem.Value == playlist.Items[1]);
         }
 
-        [Test]
-        public void TestItemRemovedOnDeletion()
-        {
-            PlaylistItem selectedItem = null;
-
-            createPlaylist(true, true);
-
-            moveToItem(0);
-            AddStep("click", () => InputManager.Click(MouseButton.Left));
-            AddStep("retrieve selection", () => selectedItem = playlist.SelectedItem.Value);
-
-            moveToDeleteButton(0);
-            AddStep("click delete button", () => InputManager.Click(MouseButton.Left));
-
-            AddAssert("item removed", () => !playlist.Items.Contains(selectedItem));
-        }
-
-        [Test]
-        public void TestNextItemSelectedAfterDeletion()
-        {
-            createPlaylist(true, true);
-
-            moveToItem(0);
-            AddStep("click", () => InputManager.Click(MouseButton.Left));
-
-            moveToDeleteButton(0);
-            AddStep("click delete button", () => InputManager.Click(MouseButton.Left));
-
-            AddAssert("item 0 is selected", () => playlist.SelectedItem.Value == playlist.Items[0]);
-        }
-
-        [Test]
-        public void TestLastItemSelectedAfterLastItemDeleted()
-        {
-            createPlaylist(true, true);
-
-            AddWaitStep("wait for flow", 5); // Items may take 1 update frame to flow. A wait count of 5 is guaranteed to result in the flow being updated as desired.
-            AddStep("scroll to bottom", () => playlist.ChildrenOfType<ScrollContainer<Drawable>>().First().ScrollToEnd(false));
-
-            moveToItem(19);
-            AddStep("click", () => InputManager.Click(MouseButton.Left));
-
-            moveToDeleteButton(19);
-            AddStep("click delete button", () => InputManager.Click(MouseButton.Left));
-
-            AddAssert("item 18 is selected", () => playlist.SelectedItem.Value == playlist.Items[18]);
-        }
-
-        [Test]
-        public void TestSelectionResetWhenAllItemsDeleted()
-        {
-            createPlaylist(true, true);
-
-            AddStep("remove all but one item", () =>
-            {
-                playlist.Items.RemoveRange(1, playlist.Items.Count - 1);
-            });
-
-            moveToItem(0);
-            AddStep("click", () => InputManager.Click(MouseButton.Left));
-            moveToDeleteButton(0);
-            AddStep("click delete button", () => InputManager.Click(MouseButton.Left));
-
-            AddAssert("no item selected", () => playlist.SelectedItem.Value == null);
-        }
-
-        // Todo: currently not possible due to bindable list shortcomings (https://github.com/ppy/osu-framework/issues/3081)
-        // [Test]
-        public void TestNextItemSelectedAfterExternalDeletion()
-        {
-            createPlaylist(true, true);
-
-            moveToItem(0);
-            AddStep("click", () => InputManager.Click(MouseButton.Left));
-            AddStep("remove item 0", () => playlist.Items.RemoveAt(0));
-
-            AddAssert("item 0 is selected", () => playlist.SelectedItem.Value == playlist.Items[0]);
-        }
-
-        [Test]
-        public void TestChangeBeatmapAndRemove()
-        {
-            createPlaylist(true, true);
-
-            AddStep("change beatmap of first item", () => playlist.Items[0].BeatmapID = 30);
-            moveToDeleteButton(0);
-            AddStep("click delete button", () => InputManager.Click(MouseButton.Left));
-        }
-
         [Test]
         public void TestDownloadButtonHiddenWhenBeatmapExists()
         {
@@ -326,12 +237,6 @@ namespace osu.Game.Tests.Visual.Multiplayer
             InputManager.MoveMouseTo(item.ChildrenOfType<OsuRearrangeableListItem<PlaylistItem>.PlaylistItemHandle>().Single(), offset);
         });
 
-        private void moveToDeleteButton(int index, Vector2? offset = null) => AddStep($"move mouse to delete button {index}", () =>
-        {
-            var item = playlist.ChildrenOfType<OsuRearrangeableListItem<PlaylistItem>>().ElementAt(index);
-            InputManager.MoveMouseTo(item.ChildrenOfType<DrawableRoomPlaylistItem.PlaylistRemoveButton>().ElementAt(0), offset);
-        });
-
         private void assertHandleVisibility(int index, bool visible)
             => AddAssert($"handle {index} {(visible ? "is" : "is not")} visible",
                 () => (playlist.ChildrenOfType<OsuRearrangeableListItem<PlaylistItem>.PlaylistItemHandle>().ElementAt(index).Alpha > 0) == visible);
@@ -425,7 +330,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             public new IReadOnlyDictionary<PlaylistItem, RearrangeableListItem<PlaylistItem>> ItemMap => base.ItemMap;
 
             public TestPlaylist(bool allowEdit, bool allowSelection, bool showItemOwner = false)
-                : base(allowEdit, allowSelection, showItemOwner: showItemOwner)
+                : base(allowEdit, allowSelection, showItemOwner)
             {
             }
         }
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsRoomPlaylist.cs b/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsRoomPlaylist.cs
new file mode 100644
index 0000000000..5b0c7c7d55
--- /dev/null
+++ b/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsRoomPlaylist.cs
@@ -0,0 +1,188 @@
+// 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.Framework.Allocation;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
+using osu.Framework.Testing;
+using osu.Game.Beatmaps;
+using osu.Game.Beatmaps.Drawables;
+using osu.Game.Database;
+using osu.Game.Graphics.Containers;
+using osu.Game.Online.API.Requests.Responses;
+using osu.Game.Online.Rooms;
+using osu.Game.Rulesets.Osu;
+using osu.Game.Rulesets.Osu.Mods;
+using osu.Game.Screens.OnlinePlay;
+using osu.Game.Screens.OnlinePlay.Playlists;
+using osu.Game.Tests.Beatmaps;
+using osuTK;
+using osuTK.Input;
+
+namespace osu.Game.Tests.Visual.Multiplayer
+{
+    public class TestScenePlaylistsRoomPlaylist : OsuManualInputManagerTestScene
+    {
+        private TestPlaylist playlist;
+
+        [Cached(typeof(UserLookupCache))]
+        private readonly TestUserLookupCache userLookupCache = new TestUserLookupCache();
+
+        [Test]
+        public void TestItemRemovedOnDeletion()
+        {
+            PlaylistItem selectedItem = null;
+
+            createPlaylist(true, true);
+
+            moveToItem(0);
+            AddStep("click", () => InputManager.Click(MouseButton.Left));
+            AddStep("retrieve selection", () => selectedItem = playlist.SelectedItem.Value);
+
+            moveToDeleteButton(0);
+            AddStep("click delete button", () => InputManager.Click(MouseButton.Left));
+
+            AddAssert("item removed", () => !playlist.Items.Contains(selectedItem));
+        }
+
+        [Test]
+        public void TestNextItemSelectedAfterDeletion()
+        {
+            createPlaylist(true, true);
+
+            moveToItem(0);
+            AddStep("click", () => InputManager.Click(MouseButton.Left));
+
+            moveToDeleteButton(0);
+            AddStep("click delete button", () => InputManager.Click(MouseButton.Left));
+
+            AddAssert("item 0 is selected", () => playlist.SelectedItem.Value == playlist.Items[0]);
+        }
+
+        [Test]
+        public void TestLastItemSelectedAfterLastItemDeleted()
+        {
+            createPlaylist(true, true);
+
+            AddWaitStep("wait for flow", 5); // Items may take 1 update frame to flow. A wait count of 5 is guaranteed to result in the flow being updated as desired.
+            AddStep("scroll to bottom", () => playlist.ChildrenOfType<ScrollContainer<Drawable>>().First().ScrollToEnd(false));
+
+            moveToItem(19);
+            AddStep("click", () => InputManager.Click(MouseButton.Left));
+
+            moveToDeleteButton(19);
+            AddStep("click delete button", () => InputManager.Click(MouseButton.Left));
+
+            AddAssert("item 18 is selected", () => playlist.SelectedItem.Value == playlist.Items[18]);
+        }
+
+        [Test]
+        public void TestSelectionResetWhenAllItemsDeleted()
+        {
+            createPlaylist(true, true);
+
+            AddStep("remove all but one item", () =>
+            {
+                playlist.Items.RemoveRange(1, playlist.Items.Count - 1);
+            });
+
+            moveToItem(0);
+            AddStep("click", () => InputManager.Click(MouseButton.Left));
+            moveToDeleteButton(0);
+            AddStep("click delete button", () => InputManager.Click(MouseButton.Left));
+
+            AddAssert("no item selected", () => playlist.SelectedItem.Value == null);
+        }
+
+        // Todo: currently not possible due to bindable list shortcomings (https://github.com/ppy/osu-framework/issues/3081)
+        // [Test]
+        public void TestNextItemSelectedAfterExternalDeletion()
+        {
+            createPlaylist(true, true);
+
+            moveToItem(0);
+            AddStep("click", () => InputManager.Click(MouseButton.Left));
+            AddStep("remove item 0", () => playlist.Items.RemoveAt(0));
+
+            AddAssert("item 0 is selected", () => playlist.SelectedItem.Value == playlist.Items[0]);
+        }
+
+        [Test]
+        public void TestChangeBeatmapAndRemove()
+        {
+            createPlaylist(true, true);
+
+            AddStep("change beatmap of first item", () => playlist.Items[0].BeatmapID = 30);
+            moveToDeleteButton(0);
+            AddStep("click delete button", () => InputManager.Click(MouseButton.Left));
+        }
+
+        private void moveToItem(int index, Vector2? offset = null)
+            => AddStep($"move mouse to item {index}", () => InputManager.MoveMouseTo(playlist.ChildrenOfType<DifficultyIcon>().ElementAt(index), offset));
+
+        private void moveToDeleteButton(int index, Vector2? offset = null) => AddStep($"move mouse to delete button {index}", () =>
+        {
+            var item = playlist.ChildrenOfType<OsuRearrangeableListItem<PlaylistItem>>().ElementAt(index);
+            InputManager.MoveMouseTo(item.ChildrenOfType<DrawableRoomPlaylistItem.PlaylistRemoveButton>().ElementAt(0), offset);
+        });
+
+        private void createPlaylist(bool allowEdit, bool allowSelection, bool showItemOwner = false)
+        {
+            AddStep("create playlist", () =>
+            {
+                Child = playlist = new TestPlaylist(allowEdit, allowSelection, showItemOwner)
+                {
+                    Anchor = Anchor.Centre,
+                    Origin = Anchor.Centre,
+                    Size = new Vector2(500, 300)
+                };
+
+                for (int i = 0; i < 20; i++)
+                {
+                    playlist.Items.Add(new PlaylistItem
+                    {
+                        ID = i,
+                        OwnerID = 2,
+                        Beatmap =
+                        {
+                            Value = i % 2 == 1
+                                ? new TestBeatmap(new OsuRuleset().RulesetInfo).BeatmapInfo
+                                : new BeatmapInfo
+                                {
+                                    Metadata = new BeatmapMetadata
+                                    {
+                                        Artist = "Artist",
+                                        Author = new APIUser { Username = "Creator name here" },
+                                        Title = "Long title used to check background colour",
+                                    },
+                                    BeatmapSet = new BeatmapSetInfo()
+                                }
+                        },
+                        Ruleset = { Value = new OsuRuleset().RulesetInfo },
+                        RequiredMods =
+                        {
+                            new OsuModHardRock(),
+                            new OsuModDoubleTime(),
+                            new OsuModAutoplay()
+                        }
+                    });
+                }
+            });
+
+            AddUntilStep("wait for items to load", () => playlist.ItemMap.Values.All(i => i.IsLoaded));
+        }
+
+        private class TestPlaylist : PlaylistsRoomPlaylist
+        {
+            public new IReadOnlyDictionary<PlaylistItem, RearrangeableListItem<PlaylistItem>> ItemMap => base.ItemMap;
+
+            public TestPlaylist(bool allowEdit, bool allowSelection, bool showItemOwner = false)
+                : base(allowEdit, allowSelection, showItemOwner)
+            {
+            }
+        }
+    }
+}
diff --git a/osu.Game/Screens/OnlinePlay/Components/MatchBeatmapDetailArea.cs b/osu.Game/Screens/OnlinePlay/Components/MatchBeatmapDetailArea.cs
index b013cbafd8..7afebb04af 100644
--- a/osu.Game/Screens/OnlinePlay/Components/MatchBeatmapDetailArea.cs
+++ b/osu.Game/Screens/OnlinePlay/Components/MatchBeatmapDetailArea.cs
@@ -9,6 +9,7 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Online.Rooms;
+using osu.Game.Screens.OnlinePlay.Playlists;
 using osu.Game.Screens.Select;
 using osuTK;
 
@@ -43,7 +44,7 @@ namespace osu.Game.Screens.OnlinePlay.Components
                             {
                                 RelativeSizeAxes = Axes.Both,
                                 Padding = new MarginPadding { Bottom = 10 },
-                                Child = playlist = new DrawableRoomPlaylist(true, false)
+                                Child = playlist = new PlaylistsRoomPlaylist(true, false)
                                 {
                                     RelativeSizeAxes = Axes.Both,
                                 }
diff --git a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs
index f2d31c8e67..35d1fb33ad 100644
--- a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs
+++ b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs
@@ -1,9 +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.Collections.Specialized;
+using System;
 using osu.Framework.Bindables;
-using osu.Framework.Extensions.IEnumerableExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Graphics.Containers;
@@ -16,6 +15,11 @@ namespace osu.Game.Screens.OnlinePlay
     {
         public readonly Bindable<PlaylistItem> SelectedItem = new Bindable<PlaylistItem>();
 
+        /// <summary>
+        /// Invoked when an item is requested to be deleted.
+        /// </summary>
+        public Action<PlaylistItem> DeletionRequested;
+
         private readonly bool allowEdit;
         private readonly bool allowSelection;
         private readonly bool showItemOwner;
@@ -27,23 +31,6 @@ namespace osu.Game.Screens.OnlinePlay
             this.showItemOwner = showItemOwner;
         }
 
-        protected override void LoadComplete()
-        {
-            base.LoadComplete();
-
-            // Scheduled since items are removed and re-added upon rearrangement
-            Items.CollectionChanged += (_, args) => Schedule(() =>
-            {
-                switch (args.Action)
-                {
-                    case NotifyCollectionChangedAction.Remove:
-                        if (allowSelection && args.OldItems.Contains(SelectedItem))
-                            SelectedItem.Value = null;
-                        break;
-                }
-            });
-        }
-
         protected override ScrollContainer<Drawable> CreateScrollContainer() => base.CreateScrollContainer().With(d =>
         {
             d.ScrollbarVisible = false;
@@ -57,20 +44,7 @@ namespace osu.Game.Screens.OnlinePlay
         protected override OsuRearrangeableListItem<PlaylistItem> CreateOsuDrawable(PlaylistItem item) => new DrawableRoomPlaylistItem(item, allowEdit, allowSelection, showItemOwner)
         {
             SelectedItem = { BindTarget = SelectedItem },
-            RequestDeletion = requestDeletion
+            RequestDeletion = i => DeletionRequested?.Invoke(i)
         };
-
-        private void requestDeletion(PlaylistItem item)
-        {
-            if (allowSelection && SelectedItem.Value == item)
-            {
-                if (Items.Count == 1)
-                    SelectedItem.Value = null;
-                else
-                    SelectedItem.Value = Items.GetNext(item) ?? Items[^2];
-            }
-
-            Items.Remove(item);
-        }
     }
 }
diff --git a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistWithResults.cs b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistWithResults.cs
index 8b1bb7abc1..1acd239fc8 100644
--- a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistWithResults.cs
+++ b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistWithResults.cs
@@ -22,7 +22,7 @@ namespace osu.Game.Screens.OnlinePlay
         private readonly bool showItemOwner;
 
         public DrawableRoomPlaylistWithResults(bool showItemOwner = false)
-            : base(false, true, showItemOwner: showItemOwner)
+            : base(false, true, showItemOwner)
         {
             this.showItemOwner = showItemOwner;
         }
diff --git a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomPlaylist.cs b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomPlaylist.cs
new file mode 100644
index 0000000000..de0960940d
--- /dev/null
+++ b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomPlaylist.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.Linq;
+using osu.Framework.Extensions.IEnumerableExtensions;
+
+namespace osu.Game.Screens.OnlinePlay.Playlists
+{
+    public class PlaylistsRoomPlaylist : DrawableRoomPlaylist
+    {
+        public PlaylistsRoomPlaylist(bool allowEdit, bool allowSelection, bool showItemOwner = false)
+            : base(allowEdit, allowSelection, showItemOwner)
+        {
+            DeletionRequested = item =>
+            {
+                var nextItem = Items.GetNext(item);
+
+                Items.Remove(item);
+
+                SelectedItem.Value = nextItem ?? Items.LastOrDefault();
+            };
+        }
+    }
+}
diff --git a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSettingsOverlay.cs b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSettingsOverlay.cs
index 27c8dc1120..b903e9cb7b 100644
--- a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSettingsOverlay.cs
+++ b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSettingsOverlay.cs
@@ -205,7 +205,10 @@ namespace osu.Game.Screens.OnlinePlay.Playlists
                                                                 {
                                                                     new Drawable[]
                                                                     {
-                                                                        playlist = new DrawableRoomPlaylist(true, false) { RelativeSizeAxes = Axes.Both }
+                                                                        playlist = new PlaylistsRoomPlaylist(true, false)
+                                                                        {
+                                                                            RelativeSizeAxes = Axes.Both
+                                                                        }
                                                                     },
                                                                     new Drawable[]
                                                                     {

From 3be4d8b68de9ac9c5286917dd85be79470849920 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 9 Dec 2021 01:04:28 +0900
Subject: [PATCH 1575/5547] Remove ctor params from
 DrawableRoomPlaylist/DrawablePlaylistItem

---
 .../TestSceneDrawableRoomPlaylist.cs          | 18 ++++-
 .../TestScenePlaylistsRoomPlaylist.cs         | 20 +++---
 .../Components/MatchBeatmapDetailArea.cs      |  2 +-
 .../OnlinePlay/DrawableRoomPlaylist.cs        | 14 +---
 .../OnlinePlay/DrawableRoomPlaylistItem.cs    | 66 ++++++++++++-------
 .../Match/MultiplayerMatchSettingsOverlay.cs  |  2 +-
 .../Match/Playlist/MultiplayerHistoryList.cs  |  9 ++-
 .../Match/Playlist/MultiplayerQueueList.cs    |  9 ++-
 .../Playlists/PlaylistsRoomPlaylist.cs        | 23 ++++++-
 .../Playlists/PlaylistsRoomSettingsOverlay.cs |  2 +-
 10 files changed, 105 insertions(+), 60 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
index c60b55d7e8..449fdaf0aa 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
@@ -329,10 +329,26 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             public new IReadOnlyDictionary<PlaylistItem, RearrangeableListItem<PlaylistItem>> ItemMap => base.ItemMap;
 
+            private readonly bool allowEdit;
+            private readonly bool allowSelection;
+            private readonly bool showItemOwner;
+
             public TestPlaylist(bool allowEdit, bool allowSelection, bool showItemOwner = false)
-                : base(allowEdit, allowSelection, showItemOwner)
             {
+                this.allowEdit = allowEdit;
+                this.allowSelection = allowSelection;
+                this.showItemOwner = showItemOwner;
             }
+
+            protected override OsuRearrangeableListItem<PlaylistItem> CreateOsuDrawable(PlaylistItem item) => base.CreateOsuDrawable(item).With(d =>
+            {
+                var drawablePlaylistItem = (DrawableRoomPlaylistItem)d;
+
+                drawablePlaylistItem.AllowReordering = allowEdit;
+                drawablePlaylistItem.AllowDeletion = allowEdit;
+                drawablePlaylistItem.AllowSelection = allowSelection;
+                drawablePlaylistItem.ShowItemOwner = showItemOwner;
+            });
         }
     }
 }
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsRoomPlaylist.cs b/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsRoomPlaylist.cs
index 5b0c7c7d55..8312964b50 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsRoomPlaylist.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsRoomPlaylist.cs
@@ -36,7 +36,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             PlaylistItem selectedItem = null;
 
-            createPlaylist(true, true);
+            createPlaylist();
 
             moveToItem(0);
             AddStep("click", () => InputManager.Click(MouseButton.Left));
@@ -51,7 +51,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [Test]
         public void TestNextItemSelectedAfterDeletion()
         {
-            createPlaylist(true, true);
+            createPlaylist();
 
             moveToItem(0);
             AddStep("click", () => InputManager.Click(MouseButton.Left));
@@ -65,7 +65,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [Test]
         public void TestLastItemSelectedAfterLastItemDeleted()
         {
-            createPlaylist(true, true);
+            createPlaylist();
 
             AddWaitStep("wait for flow", 5); // Items may take 1 update frame to flow. A wait count of 5 is guaranteed to result in the flow being updated as desired.
             AddStep("scroll to bottom", () => playlist.ChildrenOfType<ScrollContainer<Drawable>>().First().ScrollToEnd(false));
@@ -82,7 +82,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [Test]
         public void TestSelectionResetWhenAllItemsDeleted()
         {
-            createPlaylist(true, true);
+            createPlaylist();
 
             AddStep("remove all but one item", () =>
             {
@@ -101,7 +101,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         // [Test]
         public void TestNextItemSelectedAfterExternalDeletion()
         {
-            createPlaylist(true, true);
+            createPlaylist();
 
             moveToItem(0);
             AddStep("click", () => InputManager.Click(MouseButton.Left));
@@ -113,7 +113,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [Test]
         public void TestChangeBeatmapAndRemove()
         {
-            createPlaylist(true, true);
+            createPlaylist();
 
             AddStep("change beatmap of first item", () => playlist.Items[0].BeatmapID = 30);
             moveToDeleteButton(0);
@@ -129,11 +129,11 @@ namespace osu.Game.Tests.Visual.Multiplayer
             InputManager.MoveMouseTo(item.ChildrenOfType<DrawableRoomPlaylistItem.PlaylistRemoveButton>().ElementAt(0), offset);
         });
 
-        private void createPlaylist(bool allowEdit, bool allowSelection, bool showItemOwner = false)
+        private void createPlaylist()
         {
             AddStep("create playlist", () =>
             {
-                Child = playlist = new TestPlaylist(allowEdit, allowSelection, showItemOwner)
+                Child = playlist = new TestPlaylist
                 {
                     Anchor = Anchor.Centre,
                     Origin = Anchor.Centre,
@@ -179,8 +179,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             public new IReadOnlyDictionary<PlaylistItem, RearrangeableListItem<PlaylistItem>> ItemMap => base.ItemMap;
 
-            public TestPlaylist(bool allowEdit, bool allowSelection, bool showItemOwner = false)
-                : base(allowEdit, allowSelection, showItemOwner)
+            public TestPlaylist()
+                : base(true, true, true)
             {
             }
         }
diff --git a/osu.Game/Screens/OnlinePlay/Components/MatchBeatmapDetailArea.cs b/osu.Game/Screens/OnlinePlay/Components/MatchBeatmapDetailArea.cs
index 7afebb04af..761f4818e0 100644
--- a/osu.Game/Screens/OnlinePlay/Components/MatchBeatmapDetailArea.cs
+++ b/osu.Game/Screens/OnlinePlay/Components/MatchBeatmapDetailArea.cs
@@ -44,7 +44,7 @@ namespace osu.Game.Screens.OnlinePlay.Components
                             {
                                 RelativeSizeAxes = Axes.Both,
                                 Padding = new MarginPadding { Bottom = 10 },
-                                Child = playlist = new PlaylistsRoomPlaylist(true, false)
+                                Child = playlist = new PlaylistsRoomPlaylist(true, true, true)
                                 {
                                     RelativeSizeAxes = Axes.Both,
                                 }
diff --git a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs
index 35d1fb33ad..2eb8cd8997 100644
--- a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs
+++ b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs
@@ -20,16 +20,6 @@ namespace osu.Game.Screens.OnlinePlay
         /// </summary>
         public Action<PlaylistItem> DeletionRequested;
 
-        private readonly bool allowEdit;
-        private readonly bool allowSelection;
-        private readonly bool showItemOwner;
-
-        public DrawableRoomPlaylist(bool allowEdit, bool allowSelection, bool showItemOwner = false)
-        {
-            this.allowEdit = allowEdit;
-            this.allowSelection = allowSelection;
-            this.showItemOwner = showItemOwner;
-        }
 
         protected override ScrollContainer<Drawable> CreateScrollContainer() => base.CreateScrollContainer().With(d =>
         {
@@ -41,10 +31,10 @@ namespace osu.Game.Screens.OnlinePlay
             Spacing = new Vector2(0, 2)
         };
 
-        protected override OsuRearrangeableListItem<PlaylistItem> CreateOsuDrawable(PlaylistItem item) => new DrawableRoomPlaylistItem(item, allowEdit, allowSelection, showItemOwner)
+        protected override OsuRearrangeableListItem<PlaylistItem> CreateOsuDrawable(PlaylistItem item) => new DrawableRoomPlaylistItem(item)
         {
             SelectedItem = { BindTarget = SelectedItem },
-            RequestDeletion = i => DeletionRequested?.Invoke(i)
+            RequestDeletion = i => DeletionRequested?.Invoke(i),
         };
     }
 }
diff --git a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
index c291bddeeb..1814e172df 100644
--- a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
+++ b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
@@ -7,7 +7,6 @@ using System.Linq;
 using System.Threading.Tasks;
 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;
@@ -53,6 +52,7 @@ namespace osu.Game.Screens.OnlinePlay
         private ModDisplay modDisplay;
         private FillFlowContainer buttonsFlow;
         private UpdateableAvatar ownerAvatar;
+        private Drawable removeButton;
 
         private readonly IBindable<bool> valid = new Bindable<bool>();
 
@@ -75,31 +75,20 @@ namespace osu.Game.Screens.OnlinePlay
 
         private readonly DelayedLoadWrapper onScreenLoader = new DelayedLoadWrapper(Empty) { RelativeSizeAxes = Axes.Both };
 
-        private readonly bool allowEdit;
-        private readonly bool allowSelection;
-        private readonly bool showItemOwner;
-
         private FillFlowContainer mainFillFlow;
 
-        protected override bool ShouldBeConsideredForInput(Drawable child) => allowEdit || !allowSelection || SelectedItem.Value == Model;
+        protected override bool ShouldBeConsideredForInput(Drawable child) => AllowReordering || AllowDeletion || !AllowSelection || SelectedItem.Value == Model;
 
-        public DrawableRoomPlaylistItem(PlaylistItem item, bool allowEdit, bool allowSelection, bool showItemOwner)
+        public DrawableRoomPlaylistItem(PlaylistItem item)
             : base(item)
         {
             Item = item;
 
-            // TODO: edit support should be moved out into a derived class
-            this.allowEdit = allowEdit;
-            this.allowSelection = allowSelection;
-            this.showItemOwner = showItemOwner;
-
             beatmap.BindTo(item.Beatmap);
             valid.BindTo(item.Valid);
             ruleset.BindTo(item.Ruleset);
             requiredMods.BindTo(item.RequiredMods);
 
-            ShowDragHandle.Value = allowEdit;
-
             if (item.Expired)
                 Colour = OsuColour.Gray(0.5f);
         }
@@ -107,9 +96,6 @@ namespace osu.Game.Screens.OnlinePlay
         [BackgroundDependencyLoader]
         private void load()
         {
-            if (!allowEdit)
-                HandleColour = HandleColour.Opacity(0);
-
             maskingContainer.BorderColour = colours.Yellow;
         }
 
@@ -169,6 +155,42 @@ namespace osu.Game.Screens.OnlinePlay
             refresh();
         }
 
+        public bool AllowSelection { get; set; }
+
+        public bool AllowReordering
+        {
+            get => ShowDragHandle.Value;
+            set => ShowDragHandle.Value = value;
+        }
+
+        private bool allowDeletion;
+
+        public bool AllowDeletion
+        {
+            get => allowDeletion;
+            set
+            {
+                allowDeletion = value;
+
+                if (removeButton != null)
+                    removeButton.Alpha = value ? 1 : 0;
+            }
+        }
+
+        private bool showItemOwner;
+
+        public bool ShowItemOwner
+        {
+            get => showItemOwner;
+            set
+            {
+                showItemOwner = value;
+
+                if (ownerAvatar != null)
+                    ownerAvatar.Alpha = value ? 1 : 0;
+            }
+        }
+
         private void refresh()
         {
             if (!valid.Value)
@@ -336,7 +358,7 @@ namespace osu.Game.Screens.OnlinePlay
                                     Margin = new MarginPadding { Right = 8 },
                                     Masking = true,
                                     CornerRadius = 4,
-                                    Alpha = showItemOwner ? 1 : 0
+                                    Alpha = ShowItemOwner ? 1 : 0
                                 },
                             }
                         }
@@ -349,11 +371,11 @@ namespace osu.Game.Screens.OnlinePlay
             new[]
             {
                 Item.Beatmap.Value == null ? Empty() : new PlaylistDownloadButton(Item),
-                new PlaylistRemoveButton
+                removeButton = new PlaylistRemoveButton
                 {
                     Size = new Vector2(30, 30),
-                    Alpha = allowEdit ? 1 : 0,
-                    Action = () => RequestDeletion?.Invoke(Model),
+                    Alpha = AllowDeletion ? 1 : 0,
+                    Action = () => RequestDeletion?.Invoke(Item),
                 },
             };
 
@@ -374,7 +396,7 @@ namespace osu.Game.Screens.OnlinePlay
 
         protected override bool OnClick(ClickEvent e)
         {
-            if (allowSelection && valid.Value)
+            if (AllowSelection && valid.Value)
                 SelectedItem.Value = Model;
             return true;
         }
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs
index 39d60a0b05..7f1db733b3 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs
@@ -248,7 +248,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
                                                     Spacing = new Vector2(5),
                                                     Children = new Drawable[]
                                                     {
-                                                        drawablePlaylist = new DrawableRoomPlaylist(false, false)
+                                                        drawablePlaylist = new DrawableRoomPlaylist
                                                         {
                                                             RelativeSizeAxes = Axes.X,
                                                             Height = DrawableRoomPlaylistItem.HEIGHT
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerHistoryList.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerHistoryList.cs
index d708b39898..7102738271 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerHistoryList.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerHistoryList.cs
@@ -5,6 +5,7 @@ using System.Collections.Generic;
 using System.Linq;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
+using osu.Game.Graphics.Containers;
 using osu.Game.Online.Rooms;
 using osuTK;
 
@@ -15,16 +16,14 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist
     /// </summary>
     public class MultiplayerHistoryList : DrawableRoomPlaylist
     {
-        public MultiplayerHistoryList()
-            : base(false, false, true)
-        {
-        }
-
         protected override FillFlowContainer<RearrangeableListItem<PlaylistItem>> CreateListFillFlowContainer() => new HistoryFillFlowContainer
         {
             Spacing = new Vector2(0, 2)
         };
 
+        protected override OsuRearrangeableListItem<PlaylistItem> CreateOsuDrawable(PlaylistItem item)
+            => base.CreateOsuDrawable(item).With(d => ((DrawableRoomPlaylistItem)d).ShowItemOwner = true);
+
         private class HistoryFillFlowContainer : FillFlowContainer<RearrangeableListItem<PlaylistItem>>
         {
             public override IEnumerable<Drawable> FlowingChildren => base.FlowingChildren.OfType<RearrangeableListItem<PlaylistItem>>().OrderByDescending(item => item.Model.PlayedAt);
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerQueueList.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerQueueList.cs
index 1b1b66273f..814ea48646 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerQueueList.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerQueueList.cs
@@ -7,6 +7,7 @@ using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
+using osu.Game.Graphics.Containers;
 using osu.Game.Online.Rooms;
 using osuTK;
 
@@ -17,16 +18,14 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist
     /// </summary>
     public class MultiplayerQueueList : DrawableRoomPlaylist
     {
-        public MultiplayerQueueList()
-            : base(false, false, true)
-        {
-        }
-
         protected override FillFlowContainer<RearrangeableListItem<PlaylistItem>> CreateListFillFlowContainer() => new QueueFillFlowContainer
         {
             Spacing = new Vector2(0, 2)
         };
 
+        protected override OsuRearrangeableListItem<PlaylistItem> CreateOsuDrawable(PlaylistItem item)
+            => base.CreateOsuDrawable(item).With(d => ((DrawableRoomPlaylistItem)d).ShowItemOwner = true);
+
         private class QueueFillFlowContainer : FillFlowContainer<RearrangeableListItem<PlaylistItem>>
         {
             [Resolved(typeof(Room), nameof(Room.Playlist))]
diff --git a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomPlaylist.cs b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomPlaylist.cs
index de0960940d..f4df9c4406 100644
--- a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomPlaylist.cs
+++ b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomPlaylist.cs
@@ -3,14 +3,24 @@
 
 using System.Linq;
 using osu.Framework.Extensions.IEnumerableExtensions;
+using osu.Framework.Graphics;
+using osu.Game.Graphics.Containers;
+using osu.Game.Online.Rooms;
 
 namespace osu.Game.Screens.OnlinePlay.Playlists
 {
     public class PlaylistsRoomPlaylist : DrawableRoomPlaylist
     {
-        public PlaylistsRoomPlaylist(bool allowEdit, bool allowSelection, bool showItemOwner = false)
-            : base(allowEdit, allowSelection, showItemOwner)
+        private readonly bool allowReordering;
+        private readonly bool allowDeletion;
+        private readonly bool allowSelection;
+
+        public PlaylistsRoomPlaylist(bool allowReordering, bool allowDeletion, bool allowSelection)
         {
+            this.allowReordering = allowReordering;
+            this.allowDeletion = allowDeletion;
+            this.allowSelection = allowSelection;
+
             DeletionRequested = item =>
             {
                 var nextItem = Items.GetNext(item);
@@ -20,5 +30,14 @@ namespace osu.Game.Screens.OnlinePlay.Playlists
                 SelectedItem.Value = nextItem ?? Items.LastOrDefault();
             };
         }
+
+        protected override OsuRearrangeableListItem<PlaylistItem> CreateOsuDrawable(PlaylistItem item) => base.CreateOsuDrawable(item).With(d =>
+        {
+            var drawablePlaylistItem = (DrawableRoomPlaylistItem)d;
+
+            drawablePlaylistItem.AllowReordering = allowReordering;
+            drawablePlaylistItem.AllowDeletion = allowDeletion;
+            drawablePlaylistItem.AllowSelection = allowSelection;
+        });
     }
 }
diff --git a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSettingsOverlay.cs b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSettingsOverlay.cs
index b903e9cb7b..40b0bc7571 100644
--- a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSettingsOverlay.cs
+++ b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSettingsOverlay.cs
@@ -205,7 +205,7 @@ namespace osu.Game.Screens.OnlinePlay.Playlists
                                                                 {
                                                                     new Drawable[]
                                                                     {
-                                                                        playlist = new PlaylistsRoomPlaylist(true, false)
+                                                                        playlist = new PlaylistsRoomPlaylist(true, true, false)
                                                                         {
                                                                             RelativeSizeAxes = Axes.Both
                                                                         }

From 26f6c5e5a5571469a810b54a68049da8a74461e2 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 9 Dec 2021 01:16:37 +0900
Subject: [PATCH 1576/5547] Remove ctor params from PlaylistsRoomPlaylist

---
 .../TestSceneDrawableRoomPlaylist.cs          | 44 ++++----------
 .../TestScenePlaylistsRoomPlaylist.cs         |  2 +-
 .../Components/MatchBeatmapDetailArea.cs      |  3 +-
 .../OnlinePlay/DrawableRoomPlaylist.cs        | 60 +++++++++++++++++++
 .../Playlists/PlaylistsRoomPlaylist.cs        | 23 +------
 .../Playlists/PlaylistsRoomSettingsOverlay.cs |  4 +-
 6 files changed, 80 insertions(+), 56 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
index 449fdaf0aa..269cd15a0f 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.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.Diagnostics;
 using System.Linq;
@@ -48,7 +49,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [Test]
         public void TestNonEditableNonSelectable()
         {
-            createPlaylist(false, false);
+            createPlaylist();
 
             moveToItem(0);
             assertHandleVisibility(0, false);
@@ -61,7 +62,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [Test]
         public void TestEditable()
         {
-            createPlaylist(true, false);
+            createPlaylist(p => p.AllowReordering = p.AllowDeletion = true);
 
             moveToItem(0);
             assertHandleVisibility(0, true);
@@ -74,7 +75,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [Test]
         public void TestMarkInvalid()
         {
-            createPlaylist(true, true);
+            createPlaylist(p => p.AllowReordering = p.AllowDeletion = p.AllowSelection = true);
 
             AddStep("mark item 0 as invalid", () => playlist.Items[0].MarkInvalid());
 
@@ -87,7 +88,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [Test]
         public void TestSelectable()
         {
-            createPlaylist(false, true);
+            createPlaylist(p => p.AllowSelection = true);
 
             moveToItem(0);
             assertHandleVisibility(0, false);
@@ -101,7 +102,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [Test]
         public void TestEditableSelectable()
         {
-            createPlaylist(true, true);
+            createPlaylist(p => p.AllowReordering = p.AllowDeletion = p.AllowSelection = true);
 
             moveToItem(0);
             assertHandleVisibility(0, true);
@@ -115,7 +116,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [Test]
         public void TestSelectionNotLostAfterRearrangement()
         {
-            createPlaylist(true, true);
+            createPlaylist(p => p.AllowReordering = p.AllowDeletion = p.AllowSelection = true);
 
             moveToItem(0);
             AddStep("click", () => InputManager.Click(MouseButton.Left));
@@ -180,7 +181,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             AddStep("create playlist", () =>
             {
-                Child = playlist = new TestPlaylist(false, false)
+                Child = playlist = new TestPlaylist
                 {
                     Anchor = Anchor.Centre,
                     Origin = Anchor.Centre,
@@ -223,7 +224,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [TestCase(true)]
         public void TestWithOwner(bool withOwner)
         {
-            createPlaylist(false, false, withOwner);
+            createPlaylist(p => p.ShowItemOwners = withOwner);
 
             AddAssert("owner visible", () => playlist.ChildrenOfType<UpdateableAvatar>().All(a => a.IsPresent == withOwner));
         }
@@ -245,11 +246,11 @@ namespace osu.Game.Tests.Visual.Multiplayer
             => AddAssert($"delete button {index} {(visible ? "is" : "is not")} visible",
                 () => (playlist.ChildrenOfType<DrawableRoomPlaylistItem.PlaylistRemoveButton>().ElementAt(2 + index * 2).Alpha > 0) == visible);
 
-        private void createPlaylist(bool allowEdit, bool allowSelection, bool showItemOwner = false)
+        private void createPlaylist(Action<TestPlaylist> setupPlaylist)
         {
             AddStep("create playlist", () =>
             {
-                Child = playlist = new TestPlaylist(allowEdit, allowSelection, showItemOwner)
+                Child = playlist = new TestPlaylist
                 {
                     Anchor = Anchor.Centre,
                     Origin = Anchor.Centre,
@@ -295,7 +296,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             AddStep("create playlist", () =>
             {
-                Child = playlist = new TestPlaylist(false, false)
+                Child = playlist = new TestPlaylist
                 {
                     Anchor = Anchor.Centre,
                     Origin = Anchor.Centre,
@@ -328,27 +329,6 @@ namespace osu.Game.Tests.Visual.Multiplayer
         private class TestPlaylist : DrawableRoomPlaylist
         {
             public new IReadOnlyDictionary<PlaylistItem, RearrangeableListItem<PlaylistItem>> ItemMap => base.ItemMap;
-
-            private readonly bool allowEdit;
-            private readonly bool allowSelection;
-            private readonly bool showItemOwner;
-
-            public TestPlaylist(bool allowEdit, bool allowSelection, bool showItemOwner = false)
-            {
-                this.allowEdit = allowEdit;
-                this.allowSelection = allowSelection;
-                this.showItemOwner = showItemOwner;
-            }
-
-            protected override OsuRearrangeableListItem<PlaylistItem> CreateOsuDrawable(PlaylistItem item) => base.CreateOsuDrawable(item).With(d =>
-            {
-                var drawablePlaylistItem = (DrawableRoomPlaylistItem)d;
-
-                drawablePlaylistItem.AllowReordering = allowEdit;
-                drawablePlaylistItem.AllowDeletion = allowEdit;
-                drawablePlaylistItem.AllowSelection = allowSelection;
-                drawablePlaylistItem.ShowItemOwner = showItemOwner;
-            });
         }
     }
 }
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsRoomPlaylist.cs b/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsRoomPlaylist.cs
index 8312964b50..264f6aa2c5 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsRoomPlaylist.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsRoomPlaylist.cs
@@ -180,8 +180,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
             public new IReadOnlyDictionary<PlaylistItem, RearrangeableListItem<PlaylistItem>> ItemMap => base.ItemMap;
 
             public TestPlaylist()
-                : base(true, true, true)
             {
+                AllowSelection = true;
             }
         }
     }
diff --git a/osu.Game/Screens/OnlinePlay/Components/MatchBeatmapDetailArea.cs b/osu.Game/Screens/OnlinePlay/Components/MatchBeatmapDetailArea.cs
index 761f4818e0..d56acff8c7 100644
--- a/osu.Game/Screens/OnlinePlay/Components/MatchBeatmapDetailArea.cs
+++ b/osu.Game/Screens/OnlinePlay/Components/MatchBeatmapDetailArea.cs
@@ -44,9 +44,10 @@ namespace osu.Game.Screens.OnlinePlay.Components
                             {
                                 RelativeSizeAxes = Axes.Both,
                                 Padding = new MarginPadding { Bottom = 10 },
-                                Child = playlist = new PlaylistsRoomPlaylist(true, true, true)
+                                Child = playlist = new PlaylistsRoomPlaylist
                                 {
                                     RelativeSizeAxes = Axes.Both,
+                                    AllowSelection = true,
                                 }
                             }
                         },
diff --git a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs
index 2eb8cd8997..4389f40afc 100644
--- a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs
+++ b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs
@@ -2,6 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
+using System.Linq;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
@@ -20,6 +21,61 @@ namespace osu.Game.Screens.OnlinePlay
         /// </summary>
         public Action<PlaylistItem> DeletionRequested;
 
+        private bool allowReordering;
+
+        public bool AllowReordering
+        {
+            get => allowReordering;
+            set
+            {
+                allowReordering = value;
+
+                foreach (var item in ListContainer.OfType<DrawableRoomPlaylistItem>())
+                    item.AllowReordering = value;
+            }
+        }
+
+        private bool allowDeletion;
+
+        public bool AllowDeletion
+        {
+            get => allowDeletion;
+            set
+            {
+                allowDeletion = value;
+
+                foreach (var item in ListContainer.OfType<DrawableRoomPlaylistItem>())
+                    item.AllowDeletion = value;
+            }
+        }
+
+        private bool allowSelection;
+
+        public bool AllowSelection
+        {
+            get => allowSelection;
+            set
+            {
+                allowSelection = value;
+
+                foreach (var item in ListContainer.OfType<DrawableRoomPlaylistItem>())
+                    item.AllowSelection = value;
+            }
+        }
+
+        private bool showItemOwners;
+
+        public bool ShowItemOwners
+        {
+            get => showItemOwners;
+            set
+            {
+                showItemOwners = value;
+
+                foreach (var item in ListContainer.OfType<DrawableRoomPlaylistItem>())
+                    item.ShowItemOwner = value;
+            }
+        }
 
         protected override ScrollContainer<Drawable> CreateScrollContainer() => base.CreateScrollContainer().With(d =>
         {
@@ -35,6 +91,10 @@ namespace osu.Game.Screens.OnlinePlay
         {
             SelectedItem = { BindTarget = SelectedItem },
             RequestDeletion = i => DeletionRequested?.Invoke(i),
+            AllowReordering = AllowReordering,
+            AllowDeletion = AllowDeletion,
+            AllowSelection = AllowSelection,
+            ShowItemOwner = ShowItemOwners,
         };
     }
 }
diff --git a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomPlaylist.cs b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomPlaylist.cs
index f4df9c4406..d8c316b642 100644
--- a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomPlaylist.cs
+++ b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomPlaylist.cs
@@ -3,23 +3,15 @@
 
 using System.Linq;
 using osu.Framework.Extensions.IEnumerableExtensions;
-using osu.Framework.Graphics;
-using osu.Game.Graphics.Containers;
-using osu.Game.Online.Rooms;
 
 namespace osu.Game.Screens.OnlinePlay.Playlists
 {
     public class PlaylistsRoomPlaylist : DrawableRoomPlaylist
     {
-        private readonly bool allowReordering;
-        private readonly bool allowDeletion;
-        private readonly bool allowSelection;
-
-        public PlaylistsRoomPlaylist(bool allowReordering, bool allowDeletion, bool allowSelection)
+        public PlaylistsRoomPlaylist()
         {
-            this.allowReordering = allowReordering;
-            this.allowDeletion = allowDeletion;
-            this.allowSelection = allowSelection;
+            AllowReordering = true;
+            AllowDeletion = true;
 
             DeletionRequested = item =>
             {
@@ -30,14 +22,5 @@ namespace osu.Game.Screens.OnlinePlay.Playlists
                 SelectedItem.Value = nextItem ?? Items.LastOrDefault();
             };
         }
-
-        protected override OsuRearrangeableListItem<PlaylistItem> CreateOsuDrawable(PlaylistItem item) => base.CreateOsuDrawable(item).With(d =>
-        {
-            var drawablePlaylistItem = (DrawableRoomPlaylistItem)d;
-
-            drawablePlaylistItem.AllowReordering = allowReordering;
-            drawablePlaylistItem.AllowDeletion = allowDeletion;
-            drawablePlaylistItem.AllowSelection = allowSelection;
-        });
     }
 }
diff --git a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSettingsOverlay.cs b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSettingsOverlay.cs
index 40b0bc7571..915ec356d5 100644
--- a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSettingsOverlay.cs
+++ b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSettingsOverlay.cs
@@ -205,9 +205,9 @@ namespace osu.Game.Screens.OnlinePlay.Playlists
                                                                 {
                                                                     new Drawable[]
                                                                     {
-                                                                        playlist = new PlaylistsRoomPlaylist(true, true, false)
+                                                                        playlist = new PlaylistsRoomPlaylist
                                                                         {
-                                                                            RelativeSizeAxes = Axes.Both
+                                                                            RelativeSizeAxes = Axes.Both,
                                                                         }
                                                                     },
                                                                     new Drawable[]

From be2dbf42c3a0f69b1487522676a8a0ba29c3e987 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 9 Dec 2021 01:17:25 +0900
Subject: [PATCH 1577/5547] Flatten DrawableRoomPlaylistWithResults into base
 class

---
 .../OnlinePlay/DrawableRoomPlaylist.cs        | 21 ++++++
 .../OnlinePlay/DrawableRoomPlaylistItem.cs    | 44 +++++++++++-
 .../DrawableRoomPlaylistWithResults.cs        | 69 -------------------
 .../Playlists/PlaylistsRoomSubScreen.cs       |  6 +-
 4 files changed, 66 insertions(+), 74 deletions(-)
 delete mode 100644 osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistWithResults.cs

diff --git a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs
index 4389f40afc..e76d905849 100644
--- a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs
+++ b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs
@@ -21,6 +21,11 @@ namespace osu.Game.Screens.OnlinePlay
         /// </summary>
         public Action<PlaylistItem> DeletionRequested;
 
+        /// <summary>
+        /// Invoked to request showing the results for an item.
+        /// </summary>
+        public Action<PlaylistItem> ShowResultsRequested;
+
         private bool allowReordering;
 
         public bool AllowReordering
@@ -63,6 +68,20 @@ namespace osu.Game.Screens.OnlinePlay
             }
         }
 
+        private bool allowShowingResults;
+
+        public bool AllowShowingResults
+        {
+            get => allowShowingResults;
+            set
+            {
+                allowShowingResults = value;
+
+                foreach (var item in ListContainer.OfType<DrawableRoomPlaylistItem>())
+                    item.AllowShowingResults = value;
+            }
+        }
+
         private bool showItemOwners;
 
         public bool ShowItemOwners
@@ -94,7 +113,9 @@ namespace osu.Game.Screens.OnlinePlay
             AllowReordering = AllowReordering,
             AllowDeletion = AllowDeletion,
             AllowSelection = AllowSelection,
+            AllowShowingResults = AllowShowingResults,
             ShowItemOwner = ShowItemOwners,
+            ShowResultsRequested = i => ShowResultsRequested?.Invoke(i)
         };
     }
 }
diff --git a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
index 1814e172df..28b4997b63 100644
--- a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
+++ b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
@@ -41,6 +41,7 @@ namespace osu.Game.Screens.OnlinePlay
         public const float ICON_HEIGHT = 34;
 
         public Action<PlaylistItem> RequestDeletion;
+        public Action<PlaylistItem> ShowResultsRequested;
 
         public readonly Bindable<PlaylistItem> SelectedItem = new Bindable<PlaylistItem>();
 
@@ -53,6 +54,7 @@ namespace osu.Game.Screens.OnlinePlay
         private FillFlowContainer buttonsFlow;
         private UpdateableAvatar ownerAvatar;
         private Drawable removeButton;
+        private Drawable showResultsButton;
 
         private readonly IBindable<bool> valid = new Bindable<bool>();
 
@@ -177,6 +179,20 @@ namespace osu.Game.Screens.OnlinePlay
             }
         }
 
+        private bool allowShowingResults;
+
+        public bool AllowShowingResults
+        {
+            get => allowShowingResults;
+            set
+            {
+                allowShowingResults = value;
+
+                if (showResultsButton != null)
+                    showResultsButton.Alpha = value ? 1 : 0;
+            }
+        }
+
         private bool showItemOwner;
 
         public bool ShowItemOwner
@@ -230,7 +246,7 @@ namespace osu.Game.Screens.OnlinePlay
             modDisplay.Current.Value = requiredMods.ToArray();
 
             buttonsFlow.Clear();
-            buttonsFlow.ChildrenEnumerable = CreateButtons();
+            buttonsFlow.ChildrenEnumerable = createButtons();
 
             difficultyIconContainer.FadeInFromZero(500, Easing.OutQuint);
             mainFillFlow.FadeInFromZero(500, Easing.OutQuint);
@@ -344,7 +360,7 @@ namespace osu.Game.Screens.OnlinePlay
                                     Margin = new MarginPadding { Horizontal = 8 },
                                     AutoSizeAxes = Axes.Both,
                                     Spacing = new Vector2(5),
-                                    ChildrenEnumerable = CreateButtons().Select(button => button.With(b =>
+                                    ChildrenEnumerable = createButtons().Select(button => button.With(b =>
                                     {
                                         b.Anchor = Anchor.Centre;
                                         b.Origin = Anchor.Centre;
@@ -367,9 +383,14 @@ namespace osu.Game.Screens.OnlinePlay
             };
         }
 
-        protected virtual IEnumerable<Drawable> CreateButtons() =>
+        private IEnumerable<Drawable> createButtons() =>
             new[]
             {
+                showResultsButton = new ShowResultsButton
+                {
+                    Action = () => ShowResultsRequested?.Invoke(Item),
+                    Alpha = AllowShowingResults ? 1 : 0,
+                },
                 Item.Beatmap.Value == null ? Empty() : new PlaylistDownloadButton(Item),
                 removeButton = new PlaylistRemoveButton
                 {
@@ -454,6 +475,23 @@ namespace osu.Game.Screens.OnlinePlay
             }
         }
 
+        private class ShowResultsButton : IconButton
+        {
+            [BackgroundDependencyLoader]
+            private void load(OsuColour colours)
+            {
+                Icon = FontAwesome.Solid.ChartPie;
+                TooltipText = "View results";
+
+                Add(new Box
+                {
+                    RelativeSizeAxes = Axes.Both,
+                    Depth = float.MaxValue,
+                    Colour = colours.Gray4,
+                });
+            }
+        }
+
         // For now, this is the same implementation as in PanelBackground, but supports a beatmap info rather than a working beatmap
         private class PanelBackground : Container // todo: should be a buffered container (https://github.com/ppy/osu-framework/issues/3222)
         {
diff --git a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistWithResults.cs b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistWithResults.cs
deleted file mode 100644
index 1acd239fc8..0000000000
--- a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistWithResults.cs
+++ /dev/null
@@ -1,69 +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.Allocation;
-using osu.Framework.Graphics;
-using osu.Framework.Graphics.Shapes;
-using osu.Framework.Graphics.Sprites;
-using osu.Game.Graphics;
-using osu.Game.Graphics.Containers;
-using osu.Game.Graphics.UserInterface;
-using osu.Game.Online.Rooms;
-
-namespace osu.Game.Screens.OnlinePlay
-{
-    public class DrawableRoomPlaylistWithResults : DrawableRoomPlaylist
-    {
-        public Action<PlaylistItem> RequestShowResults;
-
-        private readonly bool showItemOwner;
-
-        public DrawableRoomPlaylistWithResults(bool showItemOwner = false)
-            : base(false, true, showItemOwner)
-        {
-            this.showItemOwner = showItemOwner;
-        }
-
-        protected override OsuRearrangeableListItem<PlaylistItem> CreateOsuDrawable(PlaylistItem item) =>
-            new DrawableRoomPlaylistItemWithResults(item, false, true, showItemOwner)
-            {
-                RequestShowResults = () => RequestShowResults(item),
-                SelectedItem = { BindTarget = SelectedItem },
-            };
-
-        private class DrawableRoomPlaylistItemWithResults : DrawableRoomPlaylistItem
-        {
-            public Action RequestShowResults;
-
-            public DrawableRoomPlaylistItemWithResults(PlaylistItem item, bool allowEdit, bool allowSelection, bool showItemOwner)
-                : base(item, allowEdit, allowSelection, showItemOwner)
-            {
-            }
-
-            protected override IEnumerable<Drawable> CreateButtons() =>
-                base.CreateButtons().Prepend(new FilledIconButton
-                {
-                    Icon = FontAwesome.Solid.ChartPie,
-                    Action = () => RequestShowResults?.Invoke(),
-                    TooltipText = "View results"
-                });
-
-            private class FilledIconButton : IconButton
-            {
-                [BackgroundDependencyLoader]
-                private void load(OsuColour colours)
-                {
-                    Add(new Box
-                    {
-                        RelativeSizeAxes = Axes.Both,
-                        Depth = float.MaxValue,
-                        Colour = colours.Gray4,
-                    });
-                }
-            }
-        }
-    }
-}
diff --git a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSubScreen.cs b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSubScreen.cs
index 7e045802f7..dd2d22b742 100644
--- a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSubScreen.cs
@@ -88,12 +88,14 @@ namespace osu.Game.Screens.OnlinePlay.Playlists
                                 new Drawable[] { new OverlinedPlaylistHeader(), },
                                 new Drawable[]
                                 {
-                                    new DrawableRoomPlaylistWithResults
+                                    new DrawableRoomPlaylist
                                     {
                                         RelativeSizeAxes = Axes.Both,
                                         Items = { BindTarget = Room.Playlist },
                                         SelectedItem = { BindTarget = SelectedItem },
-                                        RequestShowResults = item =>
+                                        AllowSelection = true,
+                                        AllowShowingResults = true,
+                                        ShowResultsRequested = item =>
                                         {
                                             Debug.Assert(RoomId.Value != null);
                                             ParentScreen?.Push(new PlaylistsResultsScreen(null, RoomId.Value.Value, item, false));

From 3b4833ca8eba289957601cab070d86703a74d1ae Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 9 Dec 2021 01:29:45 +0900
Subject: [PATCH 1578/5547] A bit of cleanup + xmldocs on classes/members

---
 ...TestScenePlaylistsRoomSettingsPlaylist.cs} |  4 +-
 .../Components/MatchBeatmapDetailArea.cs      |  2 +-
 .../OnlinePlay/DrawableRoomPlaylist.cs        | 27 +++++++++-
 .../OnlinePlay/DrawableRoomPlaylistItem.cs    | 50 +++++++++++++------
 .../Playlists/PlaylistsRoomSettingsOverlay.cs |  2 +-
 ...st.cs => PlaylistsRoomSettingsPlaylist.cs} |  7 ++-
 6 files changed, 71 insertions(+), 21 deletions(-)
 rename osu.Game.Tests/Visual/Multiplayer/{TestScenePlaylistsRoomPlaylist.cs => TestScenePlaylistsRoomSettingsPlaylist.cs} (97%)
 rename osu.Game/Screens/OnlinePlay/Playlists/{PlaylistsRoomPlaylist.cs => PlaylistsRoomSettingsPlaylist.cs} (69%)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsRoomPlaylist.cs b/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsRoomSettingsPlaylist.cs
similarity index 97%
rename from osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsRoomPlaylist.cs
rename to osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsRoomSettingsPlaylist.cs
index 264f6aa2c5..93ccd5f1e1 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsRoomPlaylist.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsRoomSettingsPlaylist.cs
@@ -24,7 +24,7 @@ using osuTK.Input;
 
 namespace osu.Game.Tests.Visual.Multiplayer
 {
-    public class TestScenePlaylistsRoomPlaylist : OsuManualInputManagerTestScene
+    public class TestScenePlaylistsRoomSettingsPlaylist : OsuManualInputManagerTestScene
     {
         private TestPlaylist playlist;
 
@@ -175,7 +175,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddUntilStep("wait for items to load", () => playlist.ItemMap.Values.All(i => i.IsLoaded));
         }
 
-        private class TestPlaylist : PlaylistsRoomPlaylist
+        private class TestPlaylist : PlaylistsRoomSettingsPlaylist
         {
             public new IReadOnlyDictionary<PlaylistItem, RearrangeableListItem<PlaylistItem>> ItemMap => base.ItemMap;
 
diff --git a/osu.Game/Screens/OnlinePlay/Components/MatchBeatmapDetailArea.cs b/osu.Game/Screens/OnlinePlay/Components/MatchBeatmapDetailArea.cs
index d56acff8c7..c29b8db26c 100644
--- a/osu.Game/Screens/OnlinePlay/Components/MatchBeatmapDetailArea.cs
+++ b/osu.Game/Screens/OnlinePlay/Components/MatchBeatmapDetailArea.cs
@@ -44,7 +44,7 @@ namespace osu.Game.Screens.OnlinePlay.Components
                             {
                                 RelativeSizeAxes = Axes.Both,
                                 Padding = new MarginPadding { Bottom = 10 },
-                                Child = playlist = new PlaylistsRoomPlaylist
+                                Child = playlist = new PlaylistsRoomSettingsPlaylist
                                 {
                                     RelativeSizeAxes = Axes.Both,
                                     AllowSelection = true,
diff --git a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs
index e76d905849..5e58514705 100644
--- a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs
+++ b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs
@@ -12,8 +12,15 @@ using osuTK;
 
 namespace osu.Game.Screens.OnlinePlay
 {
+    /// <summary>
+    /// A list scrollable list which displays the <see cref="PlaylistItem"/>s in a <see cref="Room"/>.
+    /// </summary>
     public class DrawableRoomPlaylist : OsuRearrangeableListContainer<PlaylistItem>
     {
+        /// <summary>
+        /// The currently-selected item, used to show a border around items.
+        /// May be updated by playlist items if <see cref="AllowSelection"/> is <c>true</c>.
+        /// </summary>
         public readonly Bindable<PlaylistItem> SelectedItem = new Bindable<PlaylistItem>();
 
         /// <summary>
@@ -22,12 +29,15 @@ namespace osu.Game.Screens.OnlinePlay
         public Action<PlaylistItem> DeletionRequested;
 
         /// <summary>
-        /// Invoked to request showing the results for an item.
+        /// Invoked when an item requests its results to be shown.
         /// </summary>
         public Action<PlaylistItem> ShowResultsRequested;
 
         private bool allowReordering;
 
+        /// <summary>
+        /// Whether to allow reordering items in the playlist.
+        /// </summary>
         public bool AllowReordering
         {
             get => allowReordering;
@@ -42,6 +52,10 @@ namespace osu.Game.Screens.OnlinePlay
 
         private bool allowDeletion;
 
+        /// <summary>
+        /// Whether to allow deleting items from the playlist.
+        /// If <c>true</c>, requests to delete items may be satisfied via <see cref="DeletionRequested"/>.
+        /// </summary>
         public bool AllowDeletion
         {
             get => allowDeletion;
@@ -56,6 +70,10 @@ namespace osu.Game.Screens.OnlinePlay
 
         private bool allowSelection;
 
+        /// <summary>
+        /// Whether to allow selecting items from the playlist.
+        /// If <c>true</c>, clicking on items in the playlist will change the value of <see cref="SelectedItem"/>.
+        /// </summary>
         public bool AllowSelection
         {
             get => allowSelection;
@@ -70,6 +88,10 @@ namespace osu.Game.Screens.OnlinePlay
 
         private bool allowShowingResults;
 
+        /// <summary>
+        /// Whether to allow items to request their results to be shown.
+        /// If <c>true</c>, requests to show the results may be satisfied via <see cref="ShowResultsRequested"/>.
+        /// </summary>
         public bool AllowShowingResults
         {
             get => allowShowingResults;
@@ -84,6 +106,9 @@ namespace osu.Game.Screens.OnlinePlay
 
         private bool showItemOwners;
 
+        /// <summary>
+        /// Whether to show the avatar of users which own each playlist item.
+        /// </summary>
         public bool ShowItemOwners
         {
             get => showItemOwners;
diff --git a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
index 28b4997b63..fca944e9b6 100644
--- a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
+++ b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
@@ -40,11 +40,30 @@ namespace osu.Game.Screens.OnlinePlay
         public const float HEIGHT = 50;
         public const float ICON_HEIGHT = 34;
 
+        /// <summary>
+        /// Invoked when this item requests to be deleted.
+        /// </summary>
         public Action<PlaylistItem> RequestDeletion;
+
+        /// <summary>
+        /// Invoked when this item requests its results to be shown.
+        /// </summary>
         public Action<PlaylistItem> ShowResultsRequested;
 
+        /// <summary>
+        /// The currently-selected item, used to show a border around this item.
+        /// May be updated by this item if <see cref="AllowSelection"/> is <c>true</c>.
+        /// </summary>
         public readonly Bindable<PlaylistItem> SelectedItem = new Bindable<PlaylistItem>();
 
+        public readonly PlaylistItem Item;
+
+        private readonly DelayedLoadWrapper onScreenLoader = new DelayedLoadWrapper(Empty) { RelativeSizeAxes = Axes.Both };
+        private readonly IBindable<bool> valid = new Bindable<bool>();
+        private readonly Bindable<IBeatmapInfo> beatmap = new Bindable<IBeatmapInfo>();
+        private readonly Bindable<IRulesetInfo> ruleset = new Bindable<IRulesetInfo>();
+        private readonly BindableList<Mod> requiredMods = new BindableList<Mod>();
+
         private Container maskingContainer;
         private Container difficultyIconContainer;
         private LinkFlowContainer beatmapText;
@@ -55,14 +74,8 @@ namespace osu.Game.Screens.OnlinePlay
         private UpdateableAvatar ownerAvatar;
         private Drawable removeButton;
         private Drawable showResultsButton;
-
-        private readonly IBindable<bool> valid = new Bindable<bool>();
-
-        private readonly Bindable<IBeatmapInfo> beatmap = new Bindable<IBeatmapInfo>();
-        private readonly Bindable<IRulesetInfo> ruleset = new Bindable<IRulesetInfo>();
-        private readonly BindableList<Mod> requiredMods = new BindableList<Mod>();
-
-        public readonly PlaylistItem Item;
+        private PanelBackground panelBackground;
+        private FillFlowContainer mainFillFlow;
 
         [Resolved]
         private OsuColour colours { get; set; }
@@ -73,12 +86,6 @@ namespace osu.Game.Screens.OnlinePlay
         [Resolved]
         private BeatmapLookupCache beatmapLookupCache { get; set; }
 
-        private PanelBackground panelBackground;
-
-        private readonly DelayedLoadWrapper onScreenLoader = new DelayedLoadWrapper(Empty) { RelativeSizeAxes = Axes.Both };
-
-        private FillFlowContainer mainFillFlow;
-
         protected override bool ShouldBeConsideredForInput(Drawable child) => AllowReordering || AllowDeletion || !AllowSelection || SelectedItem.Value == Model;
 
         public DrawableRoomPlaylistItem(PlaylistItem item)
@@ -157,8 +164,14 @@ namespace osu.Game.Screens.OnlinePlay
             refresh();
         }
 
+        /// <summary>
+        /// Whether this item can be selected.
+        /// </summary>
         public bool AllowSelection { get; set; }
 
+        /// <summary>
+        /// Whether this item can be reordered in the playlist.
+        /// </summary>
         public bool AllowReordering
         {
             get => ShowDragHandle.Value;
@@ -167,6 +180,9 @@ namespace osu.Game.Screens.OnlinePlay
 
         private bool allowDeletion;
 
+        /// <summary>
+        /// Whether this item can be deleted.
+        /// </summary>
         public bool AllowDeletion
         {
             get => allowDeletion;
@@ -181,6 +197,9 @@ namespace osu.Game.Screens.OnlinePlay
 
         private bool allowShowingResults;
 
+        /// <summary>
+        /// Whether this item can have results shown.
+        /// </summary>
         public bool AllowShowingResults
         {
             get => allowShowingResults;
@@ -195,6 +214,9 @@ namespace osu.Game.Screens.OnlinePlay
 
         private bool showItemOwner;
 
+        /// <summary>
+        /// Whether to display the avatar of the user which owns this playlist item.
+        /// </summary>
         public bool ShowItemOwner
         {
             get => showItemOwner;
diff --git a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSettingsOverlay.cs b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSettingsOverlay.cs
index 915ec356d5..8f31422add 100644
--- a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSettingsOverlay.cs
+++ b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSettingsOverlay.cs
@@ -205,7 +205,7 @@ namespace osu.Game.Screens.OnlinePlay.Playlists
                                                                 {
                                                                     new Drawable[]
                                                                     {
-                                                                        playlist = new PlaylistsRoomPlaylist
+                                                                        playlist = new PlaylistsRoomSettingsPlaylist
                                                                         {
                                                                             RelativeSizeAxes = Axes.Both,
                                                                         }
diff --git a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomPlaylist.cs b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSettingsPlaylist.cs
similarity index 69%
rename from osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomPlaylist.cs
rename to osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSettingsPlaylist.cs
index d8c316b642..bbe67e76e3 100644
--- a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomPlaylist.cs
+++ b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSettingsPlaylist.cs
@@ -6,9 +6,12 @@ using osu.Framework.Extensions.IEnumerableExtensions;
 
 namespace osu.Game.Screens.OnlinePlay.Playlists
 {
-    public class PlaylistsRoomPlaylist : DrawableRoomPlaylist
+    /// <summary>
+    /// A <see cref="DrawableRoomPlaylist"/> which is displayed during the setup stage of a playlists room.
+    /// </summary>
+    public class PlaylistsRoomSettingsPlaylist : DrawableRoomPlaylist
     {
-        public PlaylistsRoomPlaylist()
+        public PlaylistsRoomSettingsPlaylist()
         {
             AllowReordering = true;
             AllowDeletion = true;

From 273042aa16882993f553e9eb43fa44d2bdf25faa Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 9 Dec 2021 01:47:46 +0900
Subject: [PATCH 1579/5547] Add virtual method for creating different
 DrawablePlaylistItem types

---
 .../OnlinePlay/DrawableRoomPlaylist.cs        | 22 ++++++++++---------
 .../Match/Playlist/MultiplayerHistoryList.cs  |  9 ++++----
 .../Match/Playlist/MultiplayerQueueList.cs    |  9 ++++----
 3 files changed, 22 insertions(+), 18 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs
index 5e58514705..1abc7c47d6 100644
--- a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs
+++ b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs
@@ -131,16 +131,18 @@ namespace osu.Game.Screens.OnlinePlay
             Spacing = new Vector2(0, 2)
         };
 
-        protected override OsuRearrangeableListItem<PlaylistItem> CreateOsuDrawable(PlaylistItem item) => new DrawableRoomPlaylistItem(item)
+        protected sealed override OsuRearrangeableListItem<PlaylistItem> CreateOsuDrawable(PlaylistItem item) => CreateDrawablePlaylistItem(item).With(d =>
         {
-            SelectedItem = { BindTarget = SelectedItem },
-            RequestDeletion = i => DeletionRequested?.Invoke(i),
-            AllowReordering = AllowReordering,
-            AllowDeletion = AllowDeletion,
-            AllowSelection = AllowSelection,
-            AllowShowingResults = AllowShowingResults,
-            ShowItemOwner = ShowItemOwners,
-            ShowResultsRequested = i => ShowResultsRequested?.Invoke(i)
-        };
+            d.SelectedItem.BindTarget = SelectedItem;
+            d.RequestDeletion = i => DeletionRequested?.Invoke(i);
+            d.AllowReordering = AllowReordering;
+            d.AllowDeletion = AllowDeletion;
+            d.AllowSelection = AllowSelection;
+            d.AllowShowingResults = AllowShowingResults;
+            d.ShowItemOwner = ShowItemOwners;
+            d.ShowResultsRequested = i => ShowResultsRequested?.Invoke(i);
+        });
+
+        protected virtual DrawableRoomPlaylistItem CreateDrawablePlaylistItem(PlaylistItem item) => new DrawableRoomPlaylistItem(item);
     }
 }
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerHistoryList.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerHistoryList.cs
index 7102738271..32d355d149 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerHistoryList.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerHistoryList.cs
@@ -5,7 +5,6 @@ using System.Collections.Generic;
 using System.Linq;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
-using osu.Game.Graphics.Containers;
 using osu.Game.Online.Rooms;
 using osuTK;
 
@@ -16,14 +15,16 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist
     /// </summary>
     public class MultiplayerHistoryList : DrawableRoomPlaylist
     {
+        public MultiplayerHistoryList()
+        {
+            ShowItemOwners = true;
+        }
+
         protected override FillFlowContainer<RearrangeableListItem<PlaylistItem>> CreateListFillFlowContainer() => new HistoryFillFlowContainer
         {
             Spacing = new Vector2(0, 2)
         };
 
-        protected override OsuRearrangeableListItem<PlaylistItem> CreateOsuDrawable(PlaylistItem item)
-            => base.CreateOsuDrawable(item).With(d => ((DrawableRoomPlaylistItem)d).ShowItemOwner = true);
-
         private class HistoryFillFlowContainer : FillFlowContainer<RearrangeableListItem<PlaylistItem>>
         {
             public override IEnumerable<Drawable> FlowingChildren => base.FlowingChildren.OfType<RearrangeableListItem<PlaylistItem>>().OrderByDescending(item => item.Model.PlayedAt);
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerQueueList.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerQueueList.cs
index 814ea48646..7dfee36895 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerQueueList.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerQueueList.cs
@@ -7,7 +7,6 @@ using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
-using osu.Game.Graphics.Containers;
 using osu.Game.Online.Rooms;
 using osuTK;
 
@@ -18,14 +17,16 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist
     /// </summary>
     public class MultiplayerQueueList : DrawableRoomPlaylist
     {
+        public MultiplayerQueueList()
+        {
+            ShowItemOwners = true;
+        }
+
         protected override FillFlowContainer<RearrangeableListItem<PlaylistItem>> CreateListFillFlowContainer() => new QueueFillFlowContainer
         {
             Spacing = new Vector2(0, 2)
         };
 
-        protected override OsuRearrangeableListItem<PlaylistItem> CreateOsuDrawable(PlaylistItem item)
-            => base.CreateOsuDrawable(item).With(d => ((DrawableRoomPlaylistItem)d).ShowItemOwner = true);
-
         private class QueueFillFlowContainer : FillFlowContainer<RearrangeableListItem<PlaylistItem>>
         {
             [Resolved(typeof(Room), nameof(Room.Playlist))]

From 23332995d133672ec63e3c29e8859d58c5d8625a Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 9 Dec 2021 01:52:59 +0900
Subject: [PATCH 1580/5547] Invert naming of exposed actions

---
 osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs  | 12 ++++++------
 .../Screens/OnlinePlay/DrawableRoomPlaylistItem.cs   |  4 ++--
 .../Playlists/PlaylistsRoomSettingsPlaylist.cs       |  2 +-
 .../OnlinePlay/Playlists/PlaylistsRoomSubScreen.cs   |  2 +-
 4 files changed, 10 insertions(+), 10 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs
index 1abc7c47d6..8bd2daa2c3 100644
--- a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs
+++ b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs
@@ -26,12 +26,12 @@ namespace osu.Game.Screens.OnlinePlay
         /// <summary>
         /// Invoked when an item is requested to be deleted.
         /// </summary>
-        public Action<PlaylistItem> DeletionRequested;
+        public Action<PlaylistItem> RequestDeletion;
 
         /// <summary>
         /// Invoked when an item requests its results to be shown.
         /// </summary>
-        public Action<PlaylistItem> ShowResultsRequested;
+        public Action<PlaylistItem> RequestResults;
 
         private bool allowReordering;
 
@@ -54,7 +54,7 @@ namespace osu.Game.Screens.OnlinePlay
 
         /// <summary>
         /// Whether to allow deleting items from the playlist.
-        /// If <c>true</c>, requests to delete items may be satisfied via <see cref="DeletionRequested"/>.
+        /// If <c>true</c>, requests to delete items may be satisfied via <see cref="RequestDeletion"/>.
         /// </summary>
         public bool AllowDeletion
         {
@@ -90,7 +90,7 @@ namespace osu.Game.Screens.OnlinePlay
 
         /// <summary>
         /// Whether to allow items to request their results to be shown.
-        /// If <c>true</c>, requests to show the results may be satisfied via <see cref="ShowResultsRequested"/>.
+        /// If <c>true</c>, requests to show the results may be satisfied via <see cref="RequestResults"/>.
         /// </summary>
         public bool AllowShowingResults
         {
@@ -134,13 +134,13 @@ namespace osu.Game.Screens.OnlinePlay
         protected sealed override OsuRearrangeableListItem<PlaylistItem> CreateOsuDrawable(PlaylistItem item) => CreateDrawablePlaylistItem(item).With(d =>
         {
             d.SelectedItem.BindTarget = SelectedItem;
-            d.RequestDeletion = i => DeletionRequested?.Invoke(i);
+            d.RequestDeletion = i => RequestDeletion?.Invoke(i);
             d.AllowReordering = AllowReordering;
             d.AllowDeletion = AllowDeletion;
             d.AllowSelection = AllowSelection;
             d.AllowShowingResults = AllowShowingResults;
             d.ShowItemOwner = ShowItemOwners;
-            d.ShowResultsRequested = i => ShowResultsRequested?.Invoke(i);
+            d.RequestResults = i => RequestResults?.Invoke(i);
         });
 
         protected virtual DrawableRoomPlaylistItem CreateDrawablePlaylistItem(PlaylistItem item) => new DrawableRoomPlaylistItem(item);
diff --git a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
index fca944e9b6..7a1c069df3 100644
--- a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
+++ b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
@@ -48,7 +48,7 @@ namespace osu.Game.Screens.OnlinePlay
         /// <summary>
         /// Invoked when this item requests its results to be shown.
         /// </summary>
-        public Action<PlaylistItem> ShowResultsRequested;
+        public Action<PlaylistItem> RequestResults;
 
         /// <summary>
         /// The currently-selected item, used to show a border around this item.
@@ -410,7 +410,7 @@ namespace osu.Game.Screens.OnlinePlay
             {
                 showResultsButton = new ShowResultsButton
                 {
-                    Action = () => ShowResultsRequested?.Invoke(Item),
+                    Action = () => RequestResults?.Invoke(Item),
                     Alpha = AllowShowingResults ? 1 : 0,
                 },
                 Item.Beatmap.Value == null ? Empty() : new PlaylistDownloadButton(Item),
diff --git a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSettingsPlaylist.cs b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSettingsPlaylist.cs
index bbe67e76e3..2fe215eef2 100644
--- a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSettingsPlaylist.cs
+++ b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSettingsPlaylist.cs
@@ -16,7 +16,7 @@ namespace osu.Game.Screens.OnlinePlay.Playlists
             AllowReordering = true;
             AllowDeletion = true;
 
-            DeletionRequested = item =>
+            RequestDeletion = item =>
             {
                 var nextItem = Items.GetNext(item);
 
diff --git a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSubScreen.cs b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSubScreen.cs
index dd2d22b742..4114a5e9a0 100644
--- a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSubScreen.cs
@@ -95,7 +95,7 @@ namespace osu.Game.Screens.OnlinePlay.Playlists
                                         SelectedItem = { BindTarget = SelectedItem },
                                         AllowSelection = true,
                                         AllowShowingResults = true,
-                                        ShowResultsRequested = item =>
+                                        RequestResults = item =>
                                         {
                                             Debug.Assert(RoomId.Value != null);
                                             ParentScreen?.Push(new PlaylistsResultsScreen(null, RoomId.Value.Value, item, false));

From ce081c4acc6e02f8d22fac4d100050c1d40f0cac Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 9 Dec 2021 02:01:11 +0900
Subject: [PATCH 1581/5547] Fix missing propagation of OwnerId in tests

---
 osu.Game/Online/Rooms/MultiplayerPlaylistItem.cs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Game/Online/Rooms/MultiplayerPlaylistItem.cs b/osu.Game/Online/Rooms/MultiplayerPlaylistItem.cs
index cee6d8fe41..8ec073ff1e 100644
--- a/osu.Game/Online/Rooms/MultiplayerPlaylistItem.cs
+++ b/osu.Game/Online/Rooms/MultiplayerPlaylistItem.cs
@@ -62,6 +62,7 @@ namespace osu.Game.Online.Rooms
         public MultiplayerPlaylistItem(PlaylistItem item)
         {
             ID = item.ID;
+            OwnerID = item.OwnerID;
             BeatmapID = item.BeatmapID;
             BeatmapChecksum = item.Beatmap.Value?.MD5Hash ?? string.Empty;
             RulesetID = item.RulesetID;

From c34c580ad4a7da49bfe3cc7a5f6bc44fc9e750fb Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 9 Dec 2021 02:12:33 +0900
Subject: [PATCH 1582/5547] Add client-side + interface implementation

---
 .../Online/TestSceneMultiplayerQueueList.cs   | 177 ++++++++++++++++++
 .../Multiplayer/IMultiplayerRoomServer.cs     |   6 +
 .../Online/Multiplayer/MultiplayerClient.cs   |   2 +
 .../Multiplayer/OnlineMultiplayerClient.cs    |   8 +
 .../Match/Playlist/MultiplayerQueueList.cs    |  43 +++++
 .../Multiplayer/TestMultiplayerClient.cs      |  30 +++
 6 files changed, 266 insertions(+)
 create mode 100644 osu.Game.Tests/Visual/Online/TestSceneMultiplayerQueueList.cs

diff --git a/osu.Game.Tests/Visual/Online/TestSceneMultiplayerQueueList.cs b/osu.Game.Tests/Visual/Online/TestSceneMultiplayerQueueList.cs
new file mode 100644
index 0000000000..d693ee60f0
--- /dev/null
+++ b/osu.Game.Tests/Visual/Online/TestSceneMultiplayerQueueList.cs
@@ -0,0 +1,177 @@
+// 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.Allocation;
+using osu.Framework.Audio;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
+using osu.Framework.Platform;
+using osu.Framework.Testing;
+using osu.Game.Beatmaps;
+using osu.Game.Database;
+using osu.Game.Graphics.Containers;
+using osu.Game.Online.Multiplayer;
+using osu.Game.Online.Rooms;
+using osu.Game.Rulesets;
+using osu.Game.Screens.OnlinePlay;
+using osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist;
+using osu.Game.Tests.Resources;
+using osu.Game.Tests.Visual.Multiplayer;
+using osuTK;
+using osuTK.Input;
+
+namespace osu.Game.Tests.Visual.Online
+{
+    public class TestSceneMultiplayerQueueList : MultiplayerTestScene
+    {
+        private MultiplayerQueueList playlist;
+
+        [Cached(typeof(UserLookupCache))]
+        private readonly TestUserLookupCache userLookupCache = new TestUserLookupCache();
+
+        private BeatmapManager beatmaps;
+        private RulesetStore rulesets;
+        private BeatmapSetInfo importedSet;
+        private BeatmapInfo importedBeatmap;
+
+        [BackgroundDependencyLoader]
+        private void load(GameHost host, AudioManager audio)
+        {
+            Dependencies.Cache(rulesets = new RulesetStore(ContextFactory));
+            Dependencies.Cache(beatmaps = new BeatmapManager(LocalStorage, ContextFactory, rulesets, null, audio, Resources, host, Beatmap.Default));
+        }
+
+        public override void SetUpSteps()
+        {
+            base.SetUpSteps();
+
+            AddStep("create playlist", () =>
+            {
+                Child = playlist = new MultiplayerQueueList
+                {
+                    Anchor = Anchor.Centre,
+                    Origin = Anchor.Centre,
+                    Size = new Vector2(500, 300),
+                    Items = { BindTarget = Client.APIRoom!.Playlist }
+                };
+            });
+
+            AddStep("import beatmap", () =>
+            {
+                beatmaps.Import(TestResources.GetQuickTestBeatmapForImport()).Wait();
+                importedSet = beatmaps.GetAllUsableBeatmapSetsEnumerable(IncludedDetails.All).First();
+                importedBeatmap = importedSet.Beatmaps.First(b => b.RulesetID == 0);
+            });
+
+            AddStep("change to all players mode", () => Client.ChangeSettings(new MultiplayerRoomSettings { QueueMode = QueueMode.AllPlayers }));
+        }
+
+        [Test]
+        public void TestDeleteButtonHiddenWithSingleItem()
+        {
+            AddStep("set all players queue mode", () => Client.ChangeSettings(new MultiplayerRoomSettings { QueueMode = QueueMode.AllPlayers }));
+            AddUntilStep("wait for queue mode change", () => Client.APIRoom?.QueueMode.Value == QueueMode.AllPlayers);
+
+            assertDeleteButtonVisibility(0, false);
+
+            addPlaylistItem(() => API.LocalUser.Value.OnlineID);
+            assertDeleteButtonVisibility(0, true);
+
+            deleteItem(1);
+            assertDeleteButtonVisibility(0, false);
+        }
+
+        [Test]
+        public void TestDeleteButtonHiddenInHostOnlyMode()
+        {
+            AddStep("set all players queue mode", () => Client.ChangeSettings(new MultiplayerRoomSettings { QueueMode = QueueMode.AllPlayers }));
+            AddUntilStep("wait for queue mode change", () => Client.APIRoom?.QueueMode.Value == QueueMode.AllPlayers);
+            addPlaylistItem(() => 1234);
+
+            AddStep("set host-only queue mode", () => Client.ChangeSettings(new MultiplayerRoomSettings { QueueMode = QueueMode.HostOnly }));
+            AddUntilStep("wait for queue mode change", () => Client.APIRoom?.QueueMode.Value == QueueMode.HostOnly);
+
+            assertDeleteButtonVisibility(0, false);
+        }
+
+        [Test]
+        public void TestOnlyItemOwnerHasDeleteButton()
+        {
+            AddStep("set all players queue mode", () => Client.ChangeSettings(new MultiplayerRoomSettings { QueueMode = QueueMode.AllPlayers }));
+            AddUntilStep("wait for queue mode change", () => Client.APIRoom?.QueueMode.Value == QueueMode.AllPlayers);
+
+            addPlaylistItem(() => API.LocalUser.Value.OnlineID);
+            assertDeleteButtonVisibility(0, true);
+            assertDeleteButtonVisibility(1, true);
+
+            addPlaylistItem(() => 1234);
+            assertDeleteButtonVisibility(2, false);
+        }
+
+        [Test]
+        public void TestNonOwnerDoesNotHaveDeleteButton()
+        {
+            AddStep("set all players queue mode", () => Client.ChangeSettings(new MultiplayerRoomSettings { QueueMode = QueueMode.AllPlayers }));
+            AddUntilStep("wait for queue mode change", () => Client.APIRoom?.QueueMode.Value == QueueMode.AllPlayers);
+
+            addPlaylistItem(() => 1234);
+            assertDeleteButtonVisibility(0, true);
+            assertDeleteButtonVisibility(1, false);
+        }
+
+        [Test]
+        public void TestSelectedItemDoesNotHaveDeleteButton()
+        {
+            AddStep("set all players queue mode", () => Client.ChangeSettings(new MultiplayerRoomSettings { QueueMode = QueueMode.AllPlayers }));
+            AddUntilStep("wait for queue mode change", () => Client.APIRoom?.QueueMode.Value == QueueMode.AllPlayers);
+
+            addPlaylistItem(() => API.LocalUser.Value.OnlineID);
+            assertDeleteButtonVisibility(0, true);
+
+            AddStep("set first playlist item as selected", () => playlist.SelectedItem.Value = playlist.Items[0]);
+            assertDeleteButtonVisibility(0, false);
+        }
+
+        private void addPlaylistItem(Func<int> userId)
+        {
+            long itemId = -1;
+
+            AddStep("add playlist item", () =>
+            {
+                MultiplayerPlaylistItem item = new MultiplayerPlaylistItem(new PlaylistItem
+                {
+                    Beatmap = { Value = importedBeatmap },
+                    BeatmapID = importedBeatmap.OnlineID ?? -1,
+                });
+
+                Client.AddUserPlaylistItem(userId(), item);
+
+                itemId = item.ID;
+            });
+
+            AddUntilStep("item arrived in playlist", () => playlist.ChildrenOfType<RearrangeableListItem<PlaylistItem>>().Any(i => i.Model.ID == itemId));
+        }
+
+        private void deleteItem(int index)
+        {
+            OsuRearrangeableListItem<PlaylistItem> item = null;
+
+            AddStep($"move mouse to delete button {index}", () =>
+            {
+                item = playlist.ChildrenOfType<OsuRearrangeableListItem<PlaylistItem>>().ElementAt(index);
+                InputManager.MoveMouseTo(item.ChildrenOfType<DrawableRoomPlaylistItem.PlaylistRemoveButton>().ElementAt(0));
+            });
+
+            AddStep("click", () => InputManager.Click(MouseButton.Left));
+
+            AddUntilStep("item removed from playlist", () => !playlist.ChildrenOfType<RearrangeableListItem<PlaylistItem>>().Contains(item));
+        }
+
+        private void assertDeleteButtonVisibility(int index, bool visible)
+            => AddUntilStep($"delete button {index} {(visible ? "is" : "is not")} visible",
+                () => (playlist.ChildrenOfType<DrawableRoomPlaylistItem.PlaylistRemoveButton>().ElementAt(index).Alpha > 0) == visible);
+    }
+}
diff --git a/osu.Game/Online/Multiplayer/IMultiplayerRoomServer.cs b/osu.Game/Online/Multiplayer/IMultiplayerRoomServer.cs
index 3e84e4b904..65467e6ba9 100644
--- a/osu.Game/Online/Multiplayer/IMultiplayerRoomServer.cs
+++ b/osu.Game/Online/Multiplayer/IMultiplayerRoomServer.cs
@@ -82,5 +82,11 @@ namespace osu.Game.Online.Multiplayer
         /// </summary>
         /// <param name="item">The item to add.</param>
         Task AddPlaylistItem(MultiplayerPlaylistItem item);
+
+        /// <summary>
+        /// Removes an item from the playlist.
+        /// </summary>
+        /// <param name="playlistItemId">The item to remove.</param>
+        Task RemovePlaylistItem(long playlistItemId);
     }
 }
diff --git a/osu.Game/Online/Multiplayer/MultiplayerClient.cs b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
index 7e874495c8..34dc7ea5ea 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
@@ -335,6 +335,8 @@ namespace osu.Game.Online.Multiplayer
 
         public abstract Task AddPlaylistItem(MultiplayerPlaylistItem item);
 
+        public abstract Task RemovePlaylistItem(long playlistItemId);
+
         Task IMultiplayerClient.RoomStateChanged(MultiplayerRoomState state)
         {
             if (Room == null)
diff --git a/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs b/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs
index 41687b54b0..7314603603 100644
--- a/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs
@@ -162,6 +162,14 @@ namespace osu.Game.Online.Multiplayer
             return connection.InvokeAsync(nameof(IMultiplayerServer.AddPlaylistItem), item);
         }
 
+        public override Task RemovePlaylistItem(long playlistItemId)
+        {
+            if (!IsConnected.Value)
+                return Task.CompletedTask;
+
+            return connection.InvokeAsync(nameof(IMultiplayerServer.RemovePlaylistItem), playlistItemId);
+        }
+
         protected override Task<APIBeatmap> GetAPIBeatmap(int beatmapId, CancellationToken cancellationToken = default)
         {
             return beatmapLookupCache.GetBeatmapAsync(beatmapId, cancellationToken);
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerQueueList.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerQueueList.cs
index 7dfee36895..e74b2e8384 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerQueueList.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerQueueList.cs
@@ -7,6 +7,8 @@ using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
+using osu.Game.Online.API;
+using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Rooms;
 using osuTK;
 
@@ -27,6 +29,8 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist
             Spacing = new Vector2(0, 2)
         };
 
+        protected override DrawableRoomPlaylistItem CreateDrawablePlaylistItem(PlaylistItem item) => new QueuePlaylistItem(item);
+
         private class QueueFillFlowContainer : FillFlowContainer<RearrangeableListItem<PlaylistItem>>
         {
             [Resolved(typeof(Room), nameof(Room.Playlist))]
@@ -40,5 +44,44 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist
 
             public override IEnumerable<Drawable> FlowingChildren => base.FlowingChildren.OfType<RearrangeableListItem<PlaylistItem>>().OrderBy(item => item.Model.PlaylistOrder);
         }
+
+        private class QueuePlaylistItem : DrawableRoomPlaylistItem
+        {
+            [Resolved]
+            private IAPIProvider api { get; set; }
+
+            [Resolved]
+            private MultiplayerClient multiplayerClient { get; set; }
+
+            [Resolved(typeof(Room), nameof(Room.QueueMode))]
+            private Bindable<QueueMode> queueMode { get; set; }
+
+            [Resolved(typeof(Room), nameof(Room.Playlist))]
+            private BindableList<PlaylistItem> playlist { get; set; }
+
+            public QueuePlaylistItem(PlaylistItem item)
+                : base(item)
+            {
+            }
+
+            protected override void LoadComplete()
+            {
+                base.LoadComplete();
+
+                RequestDeletion = item => multiplayerClient.RemovePlaylistItem(item.ID);
+
+                playlist.BindCollectionChanged((_, __) => updateDeleteButtonVisibility());
+                queueMode.BindValueChanged(_ => updateDeleteButtonVisibility());
+                SelectedItem.BindValueChanged(_ => updateDeleteButtonVisibility(), true);
+            }
+
+            private void updateDeleteButtonVisibility()
+            {
+                AllowDeletion = queueMode.Value != QueueMode.HostOnly
+                                && playlist.Count > 1
+                                && Item.OwnerID == api.LocalUser.Value.OnlineID
+                                && SelectedItem.Value != Item;
+            }
+        }
     }
 }
diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
index b3ea5bdc4a..1f4e031b40 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
@@ -339,6 +339,36 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
         public override Task AddPlaylistItem(MultiplayerPlaylistItem item) => AddUserPlaylistItem(api.LocalUser.Value.OnlineID, item);
 
+        public async Task RemoveUserPlaylistItem(int userId, long playlistItemId)
+        {
+            Debug.Assert(Room != null);
+            Debug.Assert(APIRoom != null);
+
+            if (Room.Settings.QueueMode == QueueMode.HostOnly)
+                throw new InvalidOperationException("Items cannot be removed in host-only mode.");
+
+            if (Room.Playlist.Count == 1)
+                throw new InvalidOperationException("The singular item in the room cannot be removed.");
+
+            var item = serverSidePlaylist.Find(i => i.ID == playlistItemId);
+
+            if (item == null)
+                throw new InvalidOperationException("Item does not exist in the room.");
+
+            if (item == currentItem)
+                throw new InvalidOperationException("The room's current item cannot be removed.");
+
+            if (item.OwnerID != userId)
+                throw new InvalidOperationException("Attempted to remove an item which is not owned by the user.");
+
+            serverSidePlaylist.Remove(item);
+            await ((IMultiplayerClient)this).PlaylistItemRemoved(playlistItemId).ConfigureAwait(false);
+
+            await updateCurrentItem(Room).ConfigureAwait(false);
+        }
+
+        public override Task RemovePlaylistItem(long playlistItemId) => RemoveUserPlaylistItem(api.LocalUser.Value.OnlineID, playlistItemId);
+
         protected override Task<APIBeatmap> GetAPIBeatmap(int beatmapId, CancellationToken cancellationToken = default)
         {
             IBeatmapSetInfo? set = roomManager.ServerSideRooms.SelectMany(r => r.Playlist)

From 8398f86440ae0f941ea07e9dc51366d6e135db16 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 9 Dec 2021 04:02:16 +0900
Subject: [PATCH 1583/5547] Don't consider expired items in visibility check

---
 .../Match/Playlist/MultiplayerQueueList.cs         | 14 ++++++++------
 1 file changed, 8 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerQueueList.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerQueueList.cs
index e74b2e8384..72bcf7d343 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerQueueList.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerQueueList.cs
@@ -29,7 +29,10 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist
             Spacing = new Vector2(0, 2)
         };
 
-        protected override DrawableRoomPlaylistItem CreateDrawablePlaylistItem(PlaylistItem item) => new QueuePlaylistItem(item);
+        protected override DrawableRoomPlaylistItem CreateDrawablePlaylistItem(PlaylistItem item) => new QueuePlaylistItem(item)
+        {
+            Items = { BindTarget = Items }
+        };
 
         private class QueueFillFlowContainer : FillFlowContainer<RearrangeableListItem<PlaylistItem>>
         {
@@ -47,6 +50,8 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist
 
         private class QueuePlaylistItem : DrawableRoomPlaylistItem
         {
+            public readonly IBindableList<PlaylistItem> Items = new BindableList<PlaylistItem>();
+
             [Resolved]
             private IAPIProvider api { get; set; }
 
@@ -56,9 +61,6 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist
             [Resolved(typeof(Room), nameof(Room.QueueMode))]
             private Bindable<QueueMode> queueMode { get; set; }
 
-            [Resolved(typeof(Room), nameof(Room.Playlist))]
-            private BindableList<PlaylistItem> playlist { get; set; }
-
             public QueuePlaylistItem(PlaylistItem item)
                 : base(item)
             {
@@ -70,7 +72,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist
 
                 RequestDeletion = item => multiplayerClient.RemovePlaylistItem(item.ID);
 
-                playlist.BindCollectionChanged((_, __) => updateDeleteButtonVisibility());
+                Items.BindCollectionChanged((_, __) => updateDeleteButtonVisibility());
                 queueMode.BindValueChanged(_ => updateDeleteButtonVisibility());
                 SelectedItem.BindValueChanged(_ => updateDeleteButtonVisibility(), true);
             }
@@ -78,7 +80,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist
             private void updateDeleteButtonVisibility()
             {
                 AllowDeletion = queueMode.Value != QueueMode.HostOnly
-                                && playlist.Count > 1
+                                && Items.Count > 1
                                 && Item.OwnerID == api.LocalUser.Value.OnlineID
                                 && SelectedItem.Value != Item;
             }

From 4df2047a581d70687e5854209285ebdfadf2ca3f Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 9 Dec 2021 04:12:24 +0900
Subject: [PATCH 1584/5547] Prevent removal of expired items in
 TestMultiplayerClient

---
 osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
index 1f4e031b40..c82b748a2b 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
@@ -361,6 +361,9 @@ namespace osu.Game.Tests.Visual.Multiplayer
             if (item.OwnerID != userId)
                 throw new InvalidOperationException("Attempted to remove an item which is not owned by the user.");
 
+            if (item.Expired)
+                throw new InvalidOperationException("Attempted to remove an item which has already been played");
+
             serverSidePlaylist.Remove(item);
             await ((IMultiplayerClient)this).PlaylistItemRemoved(playlistItemId).ConfigureAwait(false);
 

From 80b2768a5f6c2d18cdd6225becc9a55cf8172210 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 9 Dec 2021 04:18:53 +0900
Subject: [PATCH 1585/5547] Mirror recent server-side changes

---
 .../Tests/Visual/Multiplayer/TestMultiplayerClient.cs  | 10 ++++------
 1 file changed, 4 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
index c82b748a2b..f151add430 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
@@ -347,9 +347,6 @@ namespace osu.Game.Tests.Visual.Multiplayer
             if (Room.Settings.QueueMode == QueueMode.HostOnly)
                 throw new InvalidOperationException("Items cannot be removed in host-only mode.");
 
-            if (Room.Playlist.Count == 1)
-                throw new InvalidOperationException("The singular item in the room cannot be removed.");
-
             var item = serverSidePlaylist.Find(i => i.ID == playlistItemId);
 
             if (item == null)
@@ -362,7 +359,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 throw new InvalidOperationException("Attempted to remove an item which is not owned by the user.");
 
             if (item.Expired)
-                throw new InvalidOperationException("Attempted to remove an item which has already been played");
+                throw new InvalidOperationException("Attempted to remove an item which has already been played.");
 
             serverSidePlaylist.Remove(item);
             await ((IMultiplayerClient)this).PlaylistItemRemoved(playlistItemId).ConfigureAwait(false);
@@ -471,11 +468,12 @@ namespace osu.Game.Tests.Visual.Multiplayer
             await updatePlaylistOrder(Room).ConfigureAwait(false);
         }
 
+        private IEnumerable<MultiplayerPlaylistItem> upcomingItems => serverSidePlaylist.Where(i => !i.Expired).OrderBy(i => i.PlaylistOrder);
+
         private async Task updateCurrentItem(MultiplayerRoom room, bool notify = true)
         {
             // Pick the next non-expired playlist item by playlist order, or default to the most-recently-expired item.
-            MultiplayerPlaylistItem nextItem = serverSidePlaylist.Where(i => !i.Expired).OrderBy(i => i.PlaylistOrder).FirstOrDefault()
-                                               ?? serverSidePlaylist.OrderByDescending(i => i.PlayedAt).First();
+            MultiplayerPlaylistItem nextItem = upcomingItems.FirstOrDefault() ?? serverSidePlaylist.OrderByDescending(i => i.PlayedAt).First();
 
             currentIndex = serverSidePlaylist.IndexOf(nextItem);
 

From aec36adf6ce2fff49265a6ca3cc6bfb50714b518 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 9 Dec 2021 04:20:23 +0900
Subject: [PATCH 1586/5547] Fix test failures

---
 .../Multiplayer/TestSceneDrawableRoomPlaylist.cs     | 12 +++++++-----
 1 file changed, 7 insertions(+), 5 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
index 269cd15a0f..c9a5552f39 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
@@ -136,7 +136,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             AddStep("import beatmap", () => manager.Import(beatmap.BeatmapSet).Wait());
 
-            createPlaylist(beatmap);
+            createPlaylistWithBeatmaps(beatmap);
 
             assertDownloadButtonVisible(false);
 
@@ -159,7 +159,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             var byChecksum = CreateAPIBeatmap();
             byChecksum.Checksum = "1337"; // Some random checksum that does not exist locally.
 
-            createPlaylist(byOnlineId, byChecksum);
+            createPlaylistWithBeatmaps(byOnlineId, byChecksum);
 
             AddAssert("download buttons shown", () => playlist.ChildrenOfType<BeatmapDownloadButton>().All(d => d.IsPresent));
         }
@@ -173,7 +173,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             beatmap.BeatmapSet.HasExplicitContent = true;
 
-            createPlaylist(beatmap);
+            createPlaylistWithBeatmaps(beatmap);
         }
 
         [Test]
@@ -246,7 +246,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             => AddAssert($"delete button {index} {(visible ? "is" : "is not")} visible",
                 () => (playlist.ChildrenOfType<DrawableRoomPlaylistItem.PlaylistRemoveButton>().ElementAt(2 + index * 2).Alpha > 0) == visible);
 
-        private void createPlaylist(Action<TestPlaylist> setupPlaylist)
+        private void createPlaylist(Action<TestPlaylist> setupPlaylist = null)
         {
             AddStep("create playlist", () =>
             {
@@ -257,6 +257,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     Size = new Vector2(500, 300)
                 };
 
+                setupPlaylist?.Invoke(playlist);
+
                 for (int i = 0; i < 20; i++)
                 {
                     playlist.Items.Add(new PlaylistItem
@@ -292,7 +294,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddUntilStep("wait for items to load", () => playlist.ItemMap.Values.All(i => i.IsLoaded));
         }
 
-        private void createPlaylist(params IBeatmapInfo[] beatmaps)
+        private void createPlaylistWithBeatmaps(params IBeatmapInfo[] beatmaps)
         {
             AddStep("create playlist", () =>
             {

From a32492cdd5614f9d88c4d3e04b5222a10002b0ff Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 27 Nov 2021 15:27:41 +0100
Subject: [PATCH 1587/5547] Duplicate `BeatmapCard{-> Extra}` as blueprint for
 extra card size

---
 .../Visual/Beatmaps/TestSceneBeatmapCard.cs   |  14 +
 .../Drawables/Cards/BeatmapCardExtra.cs       | 430 ++++++++++++++++++
 2 files changed, 444 insertions(+)
 create mode 100644 osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtra.cs

diff --git a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs
index f835d21603..04aea4ac9c 100644
--- a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs
+++ b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs
@@ -262,5 +262,19 @@ namespace osu.Game.Tests.Visual.Beatmaps
             });
             AddToggleStep("disable/enable expansion", disabled => this.ChildrenOfType<BeatmapCard>().ForEach(card => card.Expanded.Disabled = disabled));
         }
+
+        [Test]
+        public void TestExtra()
+        {
+            createTestCase(beatmapSetInfo => new BeatmapCardExtra(beatmapSetInfo));
+
+            AddToggleStep("toggle expanded state", expanded =>
+            {
+                var card = this.ChildrenOfType<BeatmapCardExtra>().Last();
+                if (!card.Expanded.Disabled)
+                    card.Expanded.Value = expanded;
+            });
+            AddToggleStep("disable/enable expansion", disabled => this.ChildrenOfType<BeatmapCardExtra>().ForEach(card => card.Expanded.Disabled = disabled));
+        }
     }
 }
diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtra.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtra.cs
new file mode 100644
index 0000000000..f244e912a1
--- /dev/null
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtra.cs
@@ -0,0 +1,430 @@
+// 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 enable
+
+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.Graphics.Sprites;
+using osu.Framework.Input.Events;
+using osu.Framework.Localisation;
+using osu.Game.Beatmaps.Drawables.Cards.Buttons;
+using osu.Game.Beatmaps.Drawables.Cards.Statistics;
+using osu.Game.Graphics;
+using osu.Game.Graphics.Containers;
+using osu.Game.Graphics.Sprites;
+using osu.Game.Graphics.UserInterface;
+using osu.Game.Online;
+using osu.Game.Online.API.Requests.Responses;
+using osu.Game.Overlays;
+using osu.Game.Overlays.BeatmapSet;
+using osuTK;
+using osu.Game.Resources.Localisation.Web;
+using DownloadButton = osu.Game.Beatmaps.Drawables.Cards.Buttons.DownloadButton;
+
+namespace osu.Game.Beatmaps.Drawables.Cards
+{
+    public class BeatmapCardExtra : OsuClickableContainer
+    {
+        private const float width = 408;
+        private const float height = 100;
+        private const float icon_area_width = 30;
+
+        public Bindable<bool> Expanded { get; } = new BindableBool();
+
+        private readonly APIBeatmapSet beatmapSet;
+        private readonly Bindable<BeatmapSetFavouriteState> favouriteState;
+
+        private readonly BeatmapDownloadTracker downloadTracker;
+
+        private BeatmapCardContent content = null!;
+
+        private BeatmapCardThumbnail thumbnail = null!;
+
+        private Container rightAreaBackground = null!;
+        private Container<BeatmapCardIconButton> rightAreaButtons = null!;
+
+        private Container mainContent = null!;
+        private BeatmapCardContentBackground mainContentBackground = null!;
+        private FillFlowContainer<BeatmapCardStatistic> statisticsContainer = null!;
+
+        private FillFlowContainer idleBottomContent = null!;
+        private BeatmapCardDownloadProgressBar downloadProgressBar = null!;
+
+        [Resolved]
+        private OsuColour colours { get; set; } = null!;
+
+        [Resolved]
+        private OverlayColourProvider colourProvider { get; set; } = null!;
+
+        public BeatmapCardExtra(APIBeatmapSet beatmapSet)
+            : base(HoverSampleSet.Submit)
+        {
+            this.beatmapSet = beatmapSet;
+            favouriteState = new Bindable<BeatmapSetFavouriteState>(new BeatmapSetFavouriteState(beatmapSet.HasFavourited, beatmapSet.FavouriteCount));
+            downloadTracker = new BeatmapDownloadTracker(beatmapSet);
+        }
+
+        [BackgroundDependencyLoader(true)]
+        private void load(BeatmapSetOverlay? beatmapSetOverlay)
+        {
+            Width = width;
+            Height = height;
+
+            FillFlowContainer leftIconArea;
+            GridContainer titleContainer;
+            GridContainer artistContainer;
+
+            InternalChild = content = new BeatmapCardContent(height)
+            {
+                MainContent = new Container
+                {
+                    RelativeSizeAxes = Axes.Both,
+                    Children = new Drawable[]
+                    {
+                        downloadTracker,
+                        rightAreaBackground = new Container
+                        {
+                            RelativeSizeAxes = Axes.Y,
+                            Width = icon_area_width + 2 * BeatmapCard.CORNER_RADIUS,
+                            Anchor = Anchor.CentreRight,
+                            Origin = Anchor.CentreRight,
+                            // workaround for masking artifacts at the top & bottom of card,
+                            // which become especially visible on downloaded beatmaps (when the icon area has a lime background).
+                            Padding = new MarginPadding { Vertical = 1 },
+                            Child = new Box
+                            {
+                                RelativeSizeAxes = Axes.Both,
+                                Colour = Colour4.White
+                            },
+                        },
+                        thumbnail = new BeatmapCardThumbnail(beatmapSet)
+                        {
+                            Name = @"Left (icon) area",
+                            Size = new Vector2(height),
+                            Padding = new MarginPadding { Right = BeatmapCard.CORNER_RADIUS },
+                            Child = leftIconArea = new FillFlowContainer
+                            {
+                                Margin = new MarginPadding(5),
+                                AutoSizeAxes = Axes.Both,
+                                Direction = FillDirection.Horizontal,
+                                Spacing = new Vector2(1)
+                            }
+                        },
+                        new Container
+                        {
+                            Name = @"Right (button) area",
+                            Width = 30,
+                            RelativeSizeAxes = Axes.Y,
+                            Origin = Anchor.TopRight,
+                            Anchor = Anchor.TopRight,
+                            Padding = new MarginPadding { Vertical = 17.5f },
+                            Child = rightAreaButtons = new Container<BeatmapCardIconButton>
+                            {
+                                RelativeSizeAxes = Axes.Both,
+                                Children = new BeatmapCardIconButton[]
+                                {
+                                    new FavouriteButton(beatmapSet)
+                                    {
+                                        Current = favouriteState,
+                                        Anchor = Anchor.TopCentre,
+                                        Origin = Anchor.TopCentre
+                                    },
+                                    new DownloadButton(beatmapSet)
+                                    {
+                                        Anchor = Anchor.BottomCentre,
+                                        Origin = Anchor.BottomCentre,
+                                        State = { BindTarget = downloadTracker.State }
+                                    },
+                                    new GoToBeatmapButton(beatmapSet)
+                                    {
+                                        Anchor = Anchor.BottomCentre,
+                                        Origin = Anchor.BottomCentre,
+                                        State = { BindTarget = downloadTracker.State }
+                                    }
+                                }
+                            }
+                        },
+                        mainContent = new Container
+                        {
+                            Name = @"Main content",
+                            X = height - BeatmapCard.CORNER_RADIUS,
+                            Height = height,
+                            CornerRadius = BeatmapCard.CORNER_RADIUS,
+                            Masking = true,
+                            Children = new Drawable[]
+                            {
+                                mainContentBackground = new BeatmapCardContentBackground(beatmapSet)
+                                {
+                                    RelativeSizeAxes = Axes.Both,
+                                },
+                                new FillFlowContainer
+                                {
+                                    RelativeSizeAxes = Axes.Both,
+                                    Padding = new MarginPadding
+                                    {
+                                        Horizontal = 10,
+                                        Vertical = 4
+                                    },
+                                    Direction = FillDirection.Vertical,
+                                    Children = new Drawable[]
+                                    {
+                                        titleContainer = new GridContainer
+                                        {
+                                            RelativeSizeAxes = Axes.X,
+                                            AutoSizeAxes = Axes.Y,
+                                            ColumnDimensions = new[]
+                                            {
+                                                new Dimension(),
+                                                new Dimension(GridSizeMode.AutoSize)
+                                            },
+                                            RowDimensions = new[]
+                                            {
+                                                new Dimension(GridSizeMode.AutoSize)
+                                            },
+                                            Content = new[]
+                                            {
+                                                new[]
+                                                {
+                                                    new OsuSpriteText
+                                                    {
+                                                        Text = new RomanisableString(beatmapSet.TitleUnicode, beatmapSet.Title),
+                                                        Font = OsuFont.Default.With(size: 22.5f, weight: FontWeight.SemiBold),
+                                                        RelativeSizeAxes = Axes.X,
+                                                        Truncate = true
+                                                    },
+                                                    Empty()
+                                                }
+                                            }
+                                        },
+                                        artistContainer = new GridContainer
+                                        {
+                                            RelativeSizeAxes = Axes.X,
+                                            AutoSizeAxes = Axes.Y,
+                                            ColumnDimensions = new[]
+                                            {
+                                                new Dimension(),
+                                                new Dimension(GridSizeMode.AutoSize)
+                                            },
+                                            RowDimensions = new[]
+                                            {
+                                                new Dimension(GridSizeMode.AutoSize)
+                                            },
+                                            Content = new[]
+                                            {
+                                                new[]
+                                                {
+                                                    new OsuSpriteText
+                                                    {
+                                                        Text = createArtistText(),
+                                                        Font = OsuFont.Default.With(size: 17.5f, weight: FontWeight.SemiBold),
+                                                        RelativeSizeAxes = Axes.X,
+                                                        Truncate = true
+                                                    },
+                                                    Empty()
+                                                },
+                                            }
+                                        },
+                                        new LinkFlowContainer(s =>
+                                        {
+                                            s.Shadow = false;
+                                            s.Font = OsuFont.GetFont(size: 14, weight: FontWeight.SemiBold);
+                                        }).With(d =>
+                                        {
+                                            d.AutoSizeAxes = Axes.Both;
+                                            d.Margin = new MarginPadding { Top = 2 };
+                                            d.AddText("mapped by ", t => t.Colour = colourProvider.Content2);
+                                            d.AddUserLink(beatmapSet.Author);
+                                        }),
+                                    }
+                                },
+                                new Container
+                                {
+                                    Name = @"Bottom content",
+                                    RelativeSizeAxes = Axes.X,
+                                    AutoSizeAxes = Axes.Y,
+                                    Anchor = Anchor.BottomLeft,
+                                    Origin = Anchor.BottomLeft,
+                                    Padding = new MarginPadding
+                                    {
+                                        Horizontal = 10,
+                                        Vertical = 4
+                                    },
+                                    Children = new Drawable[]
+                                    {
+                                        idleBottomContent = new FillFlowContainer
+                                        {
+                                            RelativeSizeAxes = Axes.X,
+                                            AutoSizeAxes = Axes.Y,
+                                            Direction = FillDirection.Vertical,
+                                            Spacing = new Vector2(0, 3),
+                                            AlwaysPresent = true,
+                                            Children = new Drawable[]
+                                            {
+                                                statisticsContainer = new FillFlowContainer<BeatmapCardStatistic>
+                                                {
+                                                    RelativeSizeAxes = Axes.X,
+                                                    AutoSizeAxes = Axes.Y,
+                                                    Direction = FillDirection.Horizontal,
+                                                    Spacing = new Vector2(10, 0),
+                                                    Alpha = 0,
+                                                    AlwaysPresent = true,
+                                                    ChildrenEnumerable = createStatistics()
+                                                },
+                                                new BeatmapCardExtraInfoRow(beatmapSet)
+                                                {
+                                                    Hovered = _ =>
+                                                    {
+                                                        content.ScheduleShow();
+                                                        return false;
+                                                    },
+                                                    Unhovered = _ =>
+                                                    {
+                                                        // This hide should only trigger if the expanded content has not shown yet.
+                                                        // ie. if the user has not shown intent to want to see it (quickly moved over the info row area).
+                                                        if (!Expanded.Value)
+                                                            content.ScheduleHide();
+                                                    }
+                                                }
+                                            }
+                                        },
+                                        downloadProgressBar = new BeatmapCardDownloadProgressBar
+                                        {
+                                            RelativeSizeAxes = Axes.X,
+                                            Height = 6,
+                                            Anchor = Anchor.Centre,
+                                            Origin = Anchor.Centre,
+                                            State = { BindTarget = downloadTracker.State },
+                                            Progress = { BindTarget = downloadTracker.Progress }
+                                        }
+                                    }
+                                }
+                            }
+                        }
+                    }
+                },
+                ExpandedContent = new Container
+                {
+                    RelativeSizeAxes = Axes.X,
+                    AutoSizeAxes = Axes.Y,
+                    Padding = new MarginPadding { Horizontal = 10, Vertical = 13 },
+                    Child = new BeatmapCardDifficultyList(beatmapSet)
+                },
+                Expanded = { BindTarget = Expanded }
+            };
+
+            if (beatmapSet.HasVideo)
+                leftIconArea.Add(new IconPill(FontAwesome.Solid.Film) { IconSize = new Vector2(20) });
+
+            if (beatmapSet.HasStoryboard)
+                leftIconArea.Add(new IconPill(FontAwesome.Solid.Image) { IconSize = new Vector2(20) });
+
+            if (beatmapSet.HasExplicitContent)
+            {
+                titleContainer.Content[0][1] = new ExplicitContentBeatmapPill
+                {
+                    Anchor = Anchor.BottomRight,
+                    Origin = Anchor.BottomRight,
+                    Margin = new MarginPadding { Left = 5 }
+                };
+            }
+
+            if (beatmapSet.TrackId != null)
+            {
+                artistContainer.Content[0][1] = new FeaturedArtistBeatmapPill
+                {
+                    Anchor = Anchor.BottomRight,
+                    Origin = Anchor.BottomRight,
+                    Margin = new MarginPadding { Left = 5 }
+                };
+            }
+
+            Action = () => beatmapSetOverlay?.FetchAndShowBeatmapSet(beatmapSet.OnlineID);
+        }
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            downloadTracker.State.BindValueChanged(_ => updateState());
+            Expanded.BindValueChanged(_ => updateState(), true);
+            FinishTransforms(true);
+        }
+
+        protected override bool OnHover(HoverEvent e)
+        {
+            updateState();
+            return base.OnHover(e);
+        }
+
+        protected override void OnHoverLost(HoverLostEvent e)
+        {
+            content.ScheduleHide();
+
+            updateState();
+            base.OnHoverLost(e);
+        }
+
+        private LocalisableString createArtistText()
+        {
+            var romanisableArtist = new RomanisableString(beatmapSet.ArtistUnicode, beatmapSet.Artist);
+            return BeatmapsetsStrings.ShowDetailsByArtist(romanisableArtist);
+        }
+
+        private IEnumerable<BeatmapCardStatistic> createStatistics()
+        {
+            if (beatmapSet.HypeStatus != null)
+                yield return new HypesStatistic(beatmapSet.HypeStatus);
+
+            // web does not show nominations unless hypes are also present.
+            // see: https://github.com/ppy/osu-web/blob/8ed7d071fd1d3eaa7e43cf0e4ff55ca2fef9c07c/resources/assets/lib/beatmapset-panel.tsx#L443
+            if (beatmapSet.HypeStatus != null && beatmapSet.NominationStatus != null)
+                yield return new NominationsStatistic(beatmapSet.NominationStatus);
+
+            yield return new FavouritesStatistic(beatmapSet) { Current = favouriteState };
+            yield return new PlayCountStatistic(beatmapSet);
+
+            var dateStatistic = BeatmapCardDateStatistic.CreateFor(beatmapSet);
+            if (dateStatistic != null)
+                yield return dateStatistic;
+        }
+
+        private void updateState()
+        {
+            bool showDetails = IsHovered || Expanded.Value;
+
+            float targetWidth = width - height;
+            if (showDetails)
+                targetWidth = targetWidth - icon_area_width + BeatmapCard.CORNER_RADIUS;
+
+            thumbnail.Dimmed.Value = showDetails;
+
+            // Scale value is intentionally chosen to fit in the spacing of listing displays, as to not overlap horizontally with adjacent cards.
+            // This avoids depth issues where a hovered (scaled) card to the right of another card would be beneath the card to the left.
+            content.ScaleTo(Expanded.Value ? 1.03f : 1, 500, Easing.OutQuint);
+
+            mainContent.ResizeWidthTo(targetWidth, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
+            mainContentBackground.Dimmed.Value = showDetails;
+
+            statisticsContainer.FadeTo(showDetails ? 1 : 0, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
+
+            rightAreaBackground.FadeColour(downloadTracker.State.Value == DownloadState.LocallyAvailable ? colours.Lime0 : colourProvider.Background3, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
+            rightAreaButtons.FadeTo(showDetails ? 1 : 0, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
+
+            foreach (var button in rightAreaButtons)
+            {
+                button.IdleColour = downloadTracker.State.Value != DownloadState.LocallyAvailable ? colourProvider.Light1 : colourProvider.Background3;
+                button.HoverColour = downloadTracker.State.Value != DownloadState.LocallyAvailable ? colourProvider.Content1 : colourProvider.Foreground1;
+            }
+
+            bool showProgress = downloadTracker.State.Value == DownloadState.Downloading || downloadTracker.State.Value == DownloadState.Importing;
+
+            idleBottomContent.FadeTo(showProgress ? 0 : 1, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
+            downloadProgressBar.FadeTo(showProgress ? 1 : 0, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
+        }
+    }
+}

From 61e04f75cc7ad4c5966e605525679e7b28f23ebb Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 27 Nov 2021 15:41:09 +0100
Subject: [PATCH 1588/5547] Resize extra card to design size

---
 osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtra.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtra.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtra.cs
index f244e912a1..7e79bded5d 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtra.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtra.cs
@@ -30,8 +30,8 @@ namespace osu.Game.Beatmaps.Drawables.Cards
 {
     public class BeatmapCardExtra : OsuClickableContainer
     {
-        private const float width = 408;
-        private const float height = 100;
+        private const float width = 475;
+        private const float height = 140;
         private const float icon_area_width = 30;
 
         public Bindable<bool> Expanded { get; } = new BindableBool();

From 419fee1380ad94e068b417e7ea3fc1a5244c078e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 27 Nov 2021 15:46:01 +0100
Subject: [PATCH 1589/5547] Move mapper link to bottom content

---
 .../Drawables/Cards/BeatmapCardExtra.cs       | 22 +++++++++----------
 1 file changed, 11 insertions(+), 11 deletions(-)

diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtra.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtra.cs
index 7e79bded5d..f42c96be7c 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtra.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtra.cs
@@ -229,17 +229,6 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                                                 },
                                             }
                                         },
-                                        new LinkFlowContainer(s =>
-                                        {
-                                            s.Shadow = false;
-                                            s.Font = OsuFont.GetFont(size: 14, weight: FontWeight.SemiBold);
-                                        }).With(d =>
-                                        {
-                                            d.AutoSizeAxes = Axes.Both;
-                                            d.Margin = new MarginPadding { Top = 2 };
-                                            d.AddText("mapped by ", t => t.Colour = colourProvider.Content2);
-                                            d.AddUserLink(beatmapSet.Author);
-                                        }),
                                     }
                                 },
                                 new Container
@@ -265,6 +254,17 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                                             AlwaysPresent = true,
                                             Children = new Drawable[]
                                             {
+                                                new LinkFlowContainer(s =>
+                                                {
+                                                    s.Shadow = false;
+                                                    s.Font = OsuFont.GetFont(size: 14, weight: FontWeight.SemiBold);
+                                                }).With(d =>
+                                                {
+                                                    d.AutoSizeAxes = Axes.Both;
+                                                    d.Margin = new MarginPadding { Top = 2 };
+                                                    d.AddText("mapped by ", t => t.Colour = colourProvider.Content2);
+                                                    d.AddUserLink(beatmapSet.Author);
+                                                }),
                                                 statisticsContainer = new FillFlowContainer<BeatmapCardStatistic>
                                                 {
                                                     RelativeSizeAxes = Axes.X,

From 3ecfaa532cb270e36e96344b7f88488105e6b15c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 27 Nov 2021 15:47:52 +0100
Subject: [PATCH 1590/5547] Add source field to extra beatmap card

---
 osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs | 1 +
 osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtra.cs  | 9 +++++++++
 2 files changed, 10 insertions(+)

diff --git a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs
index 04aea4ac9c..2a308dd0d4 100644
--- a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs
+++ b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs
@@ -97,6 +97,7 @@ namespace osu.Game.Tests.Visual.Beatmaps
             var longName = CreateAPIBeatmapSet(Ruleset.Value);
             longName.Title = longName.TitleUnicode = "this track has an incredibly and implausibly long title";
             longName.Artist = longName.ArtistUnicode = "and this artist! who would have thunk it. it's really such a long name.";
+            longName.Source = "wow. even the source field has an impossibly long string in it. this really takes the cake, doesn't it?";
             longName.HasExplicitContent = true;
             longName.TrackId = 444;
 
diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtra.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtra.cs
index f42c96be7c..1926614c8f 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtra.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtra.cs
@@ -229,6 +229,15 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                                                 },
                                             }
                                         },
+                                        new OsuSpriteText
+                                        {
+                                            RelativeSizeAxes = Axes.X,
+                                            Truncate = true,
+                                            Text = beatmapSet.Source,
+                                            Shadow = false,
+                                            Font = OsuFont.GetFont(size: 14, weight: FontWeight.SemiBold),
+                                            Colour = colourProvider.Content2
+                                        },
                                     }
                                 },
                                 new Container

From 2d739c95ea133a9b0068a283a7296700a6377f54 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 27 Nov 2021 16:01:35 +0100
Subject: [PATCH 1591/5547] Lay out extra card statistics in grid as per design

---
 .../Drawables/Cards/BeatmapCardExtra.cs       | 54 +++++++++++++------
 1 file changed, 37 insertions(+), 17 deletions(-)

diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtra.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtra.cs
index 1926614c8f..663bb26919 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtra.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtra.cs
@@ -3,7 +3,6 @@
 
 #nullable enable
 
-using System.Collections.Generic;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
@@ -50,7 +49,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
 
         private Container mainContent = null!;
         private BeatmapCardContentBackground mainContentBackground = null!;
-        private FillFlowContainer<BeatmapCardStatistic> statisticsContainer = null!;
+        private GridContainer statisticsContainer = null!;
 
         private FillFlowContainer idleBottomContent = null!;
         private BeatmapCardDownloadProgressBar downloadProgressBar = null!;
@@ -274,15 +273,26 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                                                     d.AddText("mapped by ", t => t.Colour = colourProvider.Content2);
                                                     d.AddUserLink(beatmapSet.Author);
                                                 }),
-                                                statisticsContainer = new FillFlowContainer<BeatmapCardStatistic>
+                                                statisticsContainer = new GridContainer
                                                 {
                                                     RelativeSizeAxes = Axes.X,
                                                     AutoSizeAxes = Axes.Y,
-                                                    Direction = FillDirection.Horizontal,
-                                                    Spacing = new Vector2(10, 0),
-                                                    Alpha = 0,
-                                                    AlwaysPresent = true,
-                                                    ChildrenEnumerable = createStatistics()
+                                                    RowDimensions = new[]
+                                                    {
+                                                        new Dimension(GridSizeMode.AutoSize),
+                                                        new Dimension(GridSizeMode.AutoSize)
+                                                    },
+                                                    ColumnDimensions = new[]
+                                                    {
+                                                        new Dimension(GridSizeMode.AutoSize),
+                                                        new Dimension(GridSizeMode.AutoSize),
+                                                        new Dimension()
+                                                    },
+                                                    Content = new[]
+                                                    {
+                                                        new Drawable[3],
+                                                        new Drawable[3]
+                                                    }
                                                 },
                                                 new BeatmapCardExtraInfoRow(beatmapSet)
                                                 {
@@ -352,6 +362,8 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                 };
             }
 
+            createStatistics();
+
             Action = () => beatmapSetOverlay?.FetchAndShowBeatmapSet(beatmapSet.OnlineID);
         }
 
@@ -384,22 +396,32 @@ namespace osu.Game.Beatmaps.Drawables.Cards
             return BeatmapsetsStrings.ShowDetailsByArtist(romanisableArtist);
         }
 
-        private IEnumerable<BeatmapCardStatistic> createStatistics()
+        private void createStatistics()
         {
+            BeatmapCardStatistic withMargin(BeatmapCardStatistic original)
+            {
+                original.Margin = new MarginPadding { Right = 10 };
+                return original;
+            }
+
+            statisticsContainer.Content[0][0] = withMargin(new FavouritesStatistic(beatmapSet)
+            {
+                Current = favouriteState,
+            });
+
+            statisticsContainer.Content[1][0] = withMargin(new PlayCountStatistic(beatmapSet));
+
             if (beatmapSet.HypeStatus != null)
-                yield return new HypesStatistic(beatmapSet.HypeStatus);
+                statisticsContainer.Content[0][1] = withMargin(new HypesStatistic(beatmapSet.HypeStatus));
 
             // web does not show nominations unless hypes are also present.
             // see: https://github.com/ppy/osu-web/blob/8ed7d071fd1d3eaa7e43cf0e4ff55ca2fef9c07c/resources/assets/lib/beatmapset-panel.tsx#L443
             if (beatmapSet.HypeStatus != null && beatmapSet.NominationStatus != null)
-                yield return new NominationsStatistic(beatmapSet.NominationStatus);
-
-            yield return new FavouritesStatistic(beatmapSet) { Current = favouriteState };
-            yield return new PlayCountStatistic(beatmapSet);
+                statisticsContainer.Content[1][1] = withMargin(new NominationsStatistic(beatmapSet.NominationStatus));
 
             var dateStatistic = BeatmapCardDateStatistic.CreateFor(beatmapSet);
             if (dateStatistic != null)
-                yield return dateStatistic;
+                statisticsContainer.Content[0][2] = withMargin(dateStatistic);
         }
 
         private void updateState()
@@ -419,8 +441,6 @@ namespace osu.Game.Beatmaps.Drawables.Cards
             mainContent.ResizeWidthTo(targetWidth, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
             mainContentBackground.Dimmed.Value = showDetails;
 
-            statisticsContainer.FadeTo(showDetails ? 1 : 0, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
-
             rightAreaBackground.FadeColour(downloadTracker.State.Value == DownloadState.LocallyAvailable ? colours.Lime0 : colourProvider.Background3, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
             rightAreaButtons.FadeTo(showDetails ? 1 : 0, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
 

From 083ee92deea8f018032fcaa9d111f2192dd76a43 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 27 Nov 2021 16:09:00 +0100
Subject: [PATCH 1592/5547] Adjust button vertical padding

---
 osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtra.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtra.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtra.cs
index 663bb26919..f47e1a7eab 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtra.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtra.cs
@@ -121,7 +121,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                             RelativeSizeAxes = Axes.Y,
                             Origin = Anchor.TopRight,
                             Anchor = Anchor.TopRight,
-                            Padding = new MarginPadding { Vertical = 17.5f },
+                            Padding = new MarginPadding { Vertical = 35 },
                             Child = rightAreaButtons = new Container<BeatmapCardIconButton>
                             {
                                 RelativeSizeAxes = Axes.Both,

From 1a0945dabadbe14990004cd8dfbbb02a8d8271eb Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 9 Dec 2021 14:11:29 +0900
Subject: [PATCH 1593/5547] Siplify condition, allow host to always remove
 items

---
 .../Online/TestSceneMultiplayerQueueList.cs   | 80 +++++++++----------
 .../Match/Playlist/MultiplayerQueueList.cs    | 17 ++--
 2 files changed, 43 insertions(+), 54 deletions(-)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneMultiplayerQueueList.cs b/osu.Game.Tests/Visual/Online/TestSceneMultiplayerQueueList.cs
index d693ee60f0..19e5624a04 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneMultiplayerQueueList.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneMultiplayerQueueList.cs
@@ -13,6 +13,7 @@ using osu.Framework.Testing;
 using osu.Game.Beatmaps;
 using osu.Game.Database;
 using osu.Game.Graphics.Containers;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Rooms;
 using osu.Game.Rulesets;
@@ -55,6 +56,7 @@ namespace osu.Game.Tests.Visual.Online
                     Anchor = Anchor.Centre,
                     Origin = Anchor.Centre,
                     Size = new Vector2(500, 300),
+                    SelectedItem = { BindTarget = Client.CurrentMatchPlayingItem },
                     Items = { BindTarget = Client.APIRoom!.Playlist }
                 };
             });
@@ -70,69 +72,59 @@ namespace osu.Game.Tests.Visual.Online
         }
 
         [Test]
-        public void TestDeleteButtonHiddenWithSingleItem()
-        {
-            AddStep("set all players queue mode", () => Client.ChangeSettings(new MultiplayerRoomSettings { QueueMode = QueueMode.AllPlayers }));
-            AddUntilStep("wait for queue mode change", () => Client.APIRoom?.QueueMode.Value == QueueMode.AllPlayers);
-
-            assertDeleteButtonVisibility(0, false);
-
-            addPlaylistItem(() => API.LocalUser.Value.OnlineID);
-            assertDeleteButtonVisibility(0, true);
-
-            deleteItem(1);
-            assertDeleteButtonVisibility(0, false);
-        }
-
-        [Test]
-        public void TestDeleteButtonHiddenInHostOnlyMode()
-        {
-            AddStep("set all players queue mode", () => Client.ChangeSettings(new MultiplayerRoomSettings { QueueMode = QueueMode.AllPlayers }));
-            AddUntilStep("wait for queue mode change", () => Client.APIRoom?.QueueMode.Value == QueueMode.AllPlayers);
-            addPlaylistItem(() => 1234);
-
-            AddStep("set host-only queue mode", () => Client.ChangeSettings(new MultiplayerRoomSettings { QueueMode = QueueMode.HostOnly }));
-            AddUntilStep("wait for queue mode change", () => Client.APIRoom?.QueueMode.Value == QueueMode.HostOnly);
-
-            assertDeleteButtonVisibility(0, false);
-        }
-
-        [Test]
-        public void TestOnlyItemOwnerHasDeleteButton()
+        public void TestDeleteButtonAlwaysVisibleForHost()
         {
             AddStep("set all players queue mode", () => Client.ChangeSettings(new MultiplayerRoomSettings { QueueMode = QueueMode.AllPlayers }));
             AddUntilStep("wait for queue mode change", () => Client.APIRoom?.QueueMode.Value == QueueMode.AllPlayers);
 
             addPlaylistItem(() => API.LocalUser.Value.OnlineID);
-            assertDeleteButtonVisibility(0, true);
             assertDeleteButtonVisibility(1, true);
+            addPlaylistItem(() => 1234);
+            assertDeleteButtonVisibility(2, true);
+        }
 
+        [Test]
+        public void TestDeleteButtonOnlyVisibleForItemOwnerIfNotHost()
+        {
+            AddStep("set all players queue mode", () => Client.ChangeSettings(new MultiplayerRoomSettings { QueueMode = QueueMode.AllPlayers }));
+            AddUntilStep("wait for queue mode change", () => Client.APIRoom?.QueueMode.Value == QueueMode.AllPlayers);
+
+            AddStep("join other user", () => Client.AddUser(new APIUser { Id = 1234 }));
+            AddStep("set other user as host", () => Client.TransferHost(1234));
+
+            addPlaylistItem(() => API.LocalUser.Value.OnlineID);
+            assertDeleteButtonVisibility(1, true);
             addPlaylistItem(() => 1234);
             assertDeleteButtonVisibility(2, false);
+
+            AddStep("set local user as host", () => Client.TransferHost(API.LocalUser.Value.OnlineID));
+            assertDeleteButtonVisibility(1, true);
+            assertDeleteButtonVisibility(2, true);
         }
 
         [Test]
-        public void TestNonOwnerDoesNotHaveDeleteButton()
+        public void TestCurrentItemDoesNotHaveDeleteButton()
         {
             AddStep("set all players queue mode", () => Client.ChangeSettings(new MultiplayerRoomSettings { QueueMode = QueueMode.AllPlayers }));
             AddUntilStep("wait for queue mode change", () => Client.APIRoom?.QueueMode.Value == QueueMode.AllPlayers);
 
-            addPlaylistItem(() => 1234);
-            assertDeleteButtonVisibility(0, true);
-            assertDeleteButtonVisibility(1, false);
-        }
-
-        [Test]
-        public void TestSelectedItemDoesNotHaveDeleteButton()
-        {
-            AddStep("set all players queue mode", () => Client.ChangeSettings(new MultiplayerRoomSettings { QueueMode = QueueMode.AllPlayers }));
-            AddUntilStep("wait for queue mode change", () => Client.APIRoom?.QueueMode.Value == QueueMode.AllPlayers);
+            assertDeleteButtonVisibility(0, false);
 
             addPlaylistItem(() => API.LocalUser.Value.OnlineID);
-            assertDeleteButtonVisibility(0, true);
-
-            AddStep("set first playlist item as selected", () => playlist.SelectedItem.Value = playlist.Items[0]);
             assertDeleteButtonVisibility(0, false);
+            assertDeleteButtonVisibility(1, true);
+
+            // Run through gameplay.
+            AddStep("set state to ready", () => Client.ChangeUserState(API.LocalUser.Value.Id, MultiplayerUserState.Ready));
+            AddUntilStep("local state is ready", () => Client.LocalUser?.State == MultiplayerUserState.Ready);
+            AddStep("start match", () => Client.StartMatch());
+            AddUntilStep("match started", () => Client.LocalUser?.State == MultiplayerUserState.WaitingForLoad);
+            AddStep("set state to loaded", () => Client.ChangeUserState(API.LocalUser.Value.Id, MultiplayerUserState.Loaded));
+            AddUntilStep("local state is playing", () => Client.LocalUser?.State == MultiplayerUserState.Playing);
+            AddStep("set state to finished play", () => Client.ChangeUserState(API.LocalUser.Value.Id, MultiplayerUserState.FinishedPlay));
+            AddUntilStep("local state is results", () => Client.LocalUser?.State == MultiplayerUserState.Results);
+
+            assertDeleteButtonVisibility(1, false);
         }
 
         private void addPlaylistItem(Func<int> userId)
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerQueueList.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerQueueList.cs
index 72bcf7d343..8832c9bd60 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerQueueList.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerQueueList.cs
@@ -8,6 +8,7 @@ using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Online.API;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Rooms;
 using osuTK;
@@ -29,10 +30,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist
             Spacing = new Vector2(0, 2)
         };
 
-        protected override DrawableRoomPlaylistItem CreateDrawablePlaylistItem(PlaylistItem item) => new QueuePlaylistItem(item)
-        {
-            Items = { BindTarget = Items }
-        };
+        protected override DrawableRoomPlaylistItem CreateDrawablePlaylistItem(PlaylistItem item) => new QueuePlaylistItem(item);
 
         private class QueueFillFlowContainer : FillFlowContainer<RearrangeableListItem<PlaylistItem>>
         {
@@ -50,14 +48,15 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist
 
         private class QueuePlaylistItem : DrawableRoomPlaylistItem
         {
-            public readonly IBindableList<PlaylistItem> Items = new BindableList<PlaylistItem>();
-
             [Resolved]
             private IAPIProvider api { get; set; }
 
             [Resolved]
             private MultiplayerClient multiplayerClient { get; set; }
 
+            [Resolved(typeof(Room), nameof(Room.Host))]
+            private Bindable<APIUser> host { get; set; }
+
             [Resolved(typeof(Room), nameof(Room.QueueMode))]
             private Bindable<QueueMode> queueMode { get; set; }
 
@@ -72,16 +71,14 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist
 
                 RequestDeletion = item => multiplayerClient.RemovePlaylistItem(item.ID);
 
-                Items.BindCollectionChanged((_, __) => updateDeleteButtonVisibility());
+                host.BindValueChanged(_ => updateDeleteButtonVisibility());
                 queueMode.BindValueChanged(_ => updateDeleteButtonVisibility());
                 SelectedItem.BindValueChanged(_ => updateDeleteButtonVisibility(), true);
             }
 
             private void updateDeleteButtonVisibility()
             {
-                AllowDeletion = queueMode.Value != QueueMode.HostOnly
-                                && Items.Count > 1
-                                && Item.OwnerID == api.LocalUser.Value.OnlineID
+                AllowDeletion = (Item.OwnerID == api.LocalUser.Value.OnlineID || multiplayerClient.IsHost)
                                 && SelectedItem.Value != Item;
             }
         }

From 17d676200bd2ce4c35d2a5642632b59169dc69fb Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 9 Dec 2021 17:33:36 +0900
Subject: [PATCH 1594/5547] Xmldoc fixes from code review
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/Screens/OnlinePlay/DrawableRoomPlaylist.cs | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs
index 8bd2daa2c3..5e180afcf9 100644
--- a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs
+++ b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs
@@ -13,13 +13,13 @@ using osuTK;
 namespace osu.Game.Screens.OnlinePlay
 {
     /// <summary>
-    /// A list scrollable list which displays the <see cref="PlaylistItem"/>s in a <see cref="Room"/>.
+    /// A scrollable list which displays the <see cref="PlaylistItem"/>s in a <see cref="Room"/>.
     /// </summary>
     public class DrawableRoomPlaylist : OsuRearrangeableListContainer<PlaylistItem>
     {
         /// <summary>
-        /// The currently-selected item, used to show a border around items.
-        /// May be updated by playlist items if <see cref="AllowSelection"/> is <c>true</c>.
+        /// The currently-selected item. Selection is visually represented with a border.
+        /// May be updated by clicking playlist items if <see cref="AllowSelection"/> is <c>true</c>.
         /// </summary>
         public readonly Bindable<PlaylistItem> SelectedItem = new Bindable<PlaylistItem>();
 

From 0963b0045303887db0e11e0ef01728ac709adddc Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 9 Dec 2021 17:33:59 +0900
Subject: [PATCH 1595/5547] Disallow item selection in playlists song select

---
 .../Screens/OnlinePlay/Components/MatchBeatmapDetailArea.cs    | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Components/MatchBeatmapDetailArea.cs b/osu.Game/Screens/OnlinePlay/Components/MatchBeatmapDetailArea.cs
index c29b8db26c..89842e933b 100644
--- a/osu.Game/Screens/OnlinePlay/Components/MatchBeatmapDetailArea.cs
+++ b/osu.Game/Screens/OnlinePlay/Components/MatchBeatmapDetailArea.cs
@@ -46,8 +46,7 @@ namespace osu.Game.Screens.OnlinePlay.Components
                                 Padding = new MarginPadding { Bottom = 10 },
                                 Child = playlist = new PlaylistsRoomSettingsPlaylist
                                 {
-                                    RelativeSizeAxes = Axes.Both,
-                                    AllowSelection = true,
+                                    RelativeSizeAxes = Axes.Both
                                 }
                             }
                         },

From dfe19f350968d3cbf490690261ea940ccb80fa80 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 9 Dec 2021 17:48:09 +0900
Subject: [PATCH 1596/5547] Minor code reformatting

---
 .../TestSceneDrawableRoomPlaylist.cs          | 27 +++++++++++---
 .../OnlinePlay/DrawableRoomPlaylistItem.cs    | 36 +++++++++----------
 2 files changed, 41 insertions(+), 22 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
index c9a5552f39..f6c15f314e 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
@@ -62,7 +62,11 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [Test]
         public void TestEditable()
         {
-            createPlaylist(p => p.AllowReordering = p.AllowDeletion = true);
+            createPlaylist(p =>
+            {
+                p.AllowReordering = true;
+                p.AllowDeletion = true;
+            });
 
             moveToItem(0);
             assertHandleVisibility(0, true);
@@ -75,7 +79,12 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [Test]
         public void TestMarkInvalid()
         {
-            createPlaylist(p => p.AllowReordering = p.AllowDeletion = p.AllowSelection = true);
+            createPlaylist(p =>
+            {
+                p.AllowReordering = true;
+                p.AllowDeletion = true;
+                p.AllowSelection = true;
+            });
 
             AddStep("mark item 0 as invalid", () => playlist.Items[0].MarkInvalid());
 
@@ -102,7 +111,12 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [Test]
         public void TestEditableSelectable()
         {
-            createPlaylist(p => p.AllowReordering = p.AllowDeletion = p.AllowSelection = true);
+            createPlaylist(p =>
+            {
+                p.AllowReordering = true;
+                p.AllowDeletion = true;
+                p.AllowSelection = true;
+            });
 
             moveToItem(0);
             assertHandleVisibility(0, true);
@@ -116,7 +130,12 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [Test]
         public void TestSelectionNotLostAfterRearrangement()
         {
-            createPlaylist(p => p.AllowReordering = p.AllowDeletion = p.AllowSelection = true);
+            createPlaylist(p =>
+            {
+                p.AllowReordering = true;
+                p.AllowDeletion = true;
+                p.AllowSelection = true;
+            });
 
             moveToItem(0);
             AddStep("click", () => InputManager.Click(MouseButton.Left));
diff --git a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
index 7a1c069df3..9ad43fced5 100644
--- a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
+++ b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
@@ -38,7 +38,8 @@ namespace osu.Game.Screens.OnlinePlay
     public class DrawableRoomPlaylistItem : OsuRearrangeableListItem<PlaylistItem>
     {
         public const float HEIGHT = 50;
-        public const float ICON_HEIGHT = 34;
+
+        private const float icon_height = 34;
 
         /// <summary>
         /// Invoked when this item requests to be deleted.
@@ -238,7 +239,7 @@ namespace osu.Game.Screens.OnlinePlay
             }
 
             if (Item.Beatmap.Value != null)
-                difficultyIconContainer.Child = new DifficultyIcon(Item.Beatmap.Value, ruleset.Value, requiredMods, performBackgroundDifficultyLookup: false) { Size = new Vector2(ICON_HEIGHT) };
+                difficultyIconContainer.Child = new DifficultyIcon(Item.Beatmap.Value, ruleset.Value, requiredMods, performBackgroundDifficultyLookup: false) { Size = new Vector2(icon_height) };
             else
                 difficultyIconContainer.Clear();
 
@@ -392,7 +393,7 @@ namespace osu.Game.Screens.OnlinePlay
                                 {
                                     Anchor = Anchor.Centre,
                                     Origin = Anchor.Centre,
-                                    Size = new Vector2(ICON_HEIGHT),
+                                    Size = new Vector2(icon_height),
                                     Margin = new MarginPadding { Right = 8 },
                                     Masking = true,
                                     CornerRadius = 4,
@@ -405,22 +406,21 @@ namespace osu.Game.Screens.OnlinePlay
             };
         }
 
-        private IEnumerable<Drawable> createButtons() =>
-            new[]
+        private IEnumerable<Drawable> createButtons() => new[]
+        {
+            showResultsButton = new ShowResultsButton
             {
-                showResultsButton = new ShowResultsButton
-                {
-                    Action = () => RequestResults?.Invoke(Item),
-                    Alpha = AllowShowingResults ? 1 : 0,
-                },
-                Item.Beatmap.Value == null ? Empty() : new PlaylistDownloadButton(Item),
-                removeButton = new PlaylistRemoveButton
-                {
-                    Size = new Vector2(30, 30),
-                    Alpha = AllowDeletion ? 1 : 0,
-                    Action = () => RequestDeletion?.Invoke(Item),
-                },
-            };
+                Action = () => RequestResults?.Invoke(Item),
+                Alpha = AllowShowingResults ? 1 : 0,
+            },
+            Item.Beatmap.Value == null ? Empty() : new PlaylistDownloadButton(Item),
+            removeButton = new PlaylistRemoveButton
+            {
+                Size = new Vector2(30, 30),
+                Alpha = AllowDeletion ? 1 : 0,
+                Action = () => RequestDeletion?.Invoke(Item),
+            },
+        };
 
         public class PlaylistRemoveButton : GrayButton
         {

From e7e61cd9ab8b882ccb99325960e2b6677b972548 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 9 Dec 2021 18:50:53 +0900
Subject: [PATCH 1597/5547] Fix potential crash due to children being mutated
 after disposal

This is a bit of an unfortunate edge case where the unbind-on-disposal
doesn't help, since the binding is happening in BDL, and the usage is in
a nested `LoadComponentAsync` call. Combine those and you have a recipe
for disaster.
---
 osu.Game/Screens/Select/BeatmapInfoWedge.cs | 25 ++++++++++++---------
 1 file changed, 15 insertions(+), 10 deletions(-)

diff --git a/osu.Game/Screens/Select/BeatmapInfoWedge.cs b/osu.Game/Screens/Select/BeatmapInfoWedge.cs
index e4cf9bd868..d292b7114f 100644
--- a/osu.Game/Screens/Select/BeatmapInfoWedge.cs
+++ b/osu.Game/Screens/Select/BeatmapInfoWedge.cs
@@ -330,6 +330,21 @@ namespace osu.Game.Screens.Select
                 addInfoLabels();
             }
 
+            protected override void LoadComplete()
+            {
+                base.LoadComplete();
+
+                mods.BindValueChanged(m =>
+                {
+                    settingChangeTracker?.Dispose();
+
+                    refreshBPMLabel();
+
+                    settingChangeTracker = new ModSettingChangeTracker(m.NewValue);
+                    settingChangeTracker.SettingChanged += _ => refreshBPMLabel();
+                }, true);
+            }
+
             private void setMetadata(string source)
             {
                 ArtistLabel.Text = artistBinding.Value;
@@ -360,16 +375,6 @@ namespace osu.Game.Screens.Select
                         Children = getRulesetInfoLabels()
                     }
                 };
-
-                mods.BindValueChanged(m =>
-                {
-                    settingChangeTracker?.Dispose();
-
-                    refreshBPMLabel();
-
-                    settingChangeTracker = new ModSettingChangeTracker(m.NewValue);
-                    settingChangeTracker.SettingChanged += _ => refreshBPMLabel();
-                }, true);
             }
 
             private InfoLabel[] getRulesetInfoLabels()

From a3b53ac2f68a176f8406740b6fe486ac420a6ac4 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 9 Dec 2021 18:58:47 +0900
Subject: [PATCH 1598/5547] Change comparison to match in all locations

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

diff --git a/osu.Game/Screens/Play/PlayerLoader.cs b/osu.Game/Screens/Play/PlayerLoader.cs
index dfc3c2b61d..60843acb4f 100644
--- a/osu.Game/Screens/Play/PlayerLoader.cs
+++ b/osu.Game/Screens/Play/PlayerLoader.cs
@@ -505,9 +505,9 @@ namespace osu.Game.Screens.Play
                     volumeOverlay.IsMuted.Value = false;
 
                     // Check values before resetting, as the user may have only had mute enabled, in which case we might not need to adjust volumes.
-                    if (audioManager.Volume.Value < volume_requirement)
+                    if (audioManager.Volume.Value <= volume_requirement)
                         audioManager.Volume.SetDefault();
-                    if (audioManager.VolumeTrack.Value < volume_requirement)
+                    if (audioManager.VolumeTrack.Value <= volume_requirement)
                         audioManager.VolumeTrack.SetDefault();
 
                     return true;

From f9af239ed95153275b66310f3caf67215a5ae73e Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 9 Dec 2021 23:46:03 +0900
Subject: [PATCH 1599/5547] Cleanup duplicated classes in
 DrawableRoomPlaylistItem

---
 .../TestSceneDrawableRoomPlaylist.cs          | 12 ++++-
 .../TestScenePlaylistsRoomSettingsPlaylist.cs |  2 +-
 .../Online/TestSceneMultiplayerQueueList.cs   |  4 +-
 .../OnlinePlay/DrawableRoomPlaylistItem.cs    | 46 ++++---------------
 4 files changed, 23 insertions(+), 41 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
index f6c15f314e..d0cf17db1f 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
@@ -248,6 +248,16 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddAssert("owner visible", () => playlist.ChildrenOfType<UpdateableAvatar>().All(a => a.IsPresent == withOwner));
         }
 
+        [Test]
+        public void TestWithAllButtonsEnabled()
+        {
+            createPlaylist(p =>
+            {
+                p.AllowDeletion = true;
+                p.AllowShowingResults = true;
+            });
+        }
+
         private void moveToItem(int index, Vector2? offset = null)
             => AddStep($"move mouse to item {index}", () => InputManager.MoveMouseTo(playlist.ChildrenOfType<DifficultyIcon>().ElementAt(index), offset));
 
@@ -263,7 +273,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
         private void assertDeleteButtonVisibility(int index, bool visible)
             => AddAssert($"delete button {index} {(visible ? "is" : "is not")} visible",
-                () => (playlist.ChildrenOfType<DrawableRoomPlaylistItem.PlaylistRemoveButton>().ElementAt(2 + index * 2).Alpha > 0) == visible);
+                () => (playlist.ChildrenOfType<DrawableRoomPlaylistItem>().ElementAt(2 + index * 2).RemoveButton.Alpha > 0) == visible);
 
         private void createPlaylist(Action<TestPlaylist> setupPlaylist = null)
         {
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsRoomSettingsPlaylist.cs b/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsRoomSettingsPlaylist.cs
index 93ccd5f1e1..c61b99c2c2 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsRoomSettingsPlaylist.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsRoomSettingsPlaylist.cs
@@ -126,7 +126,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         private void moveToDeleteButton(int index, Vector2? offset = null) => AddStep($"move mouse to delete button {index}", () =>
         {
             var item = playlist.ChildrenOfType<OsuRearrangeableListItem<PlaylistItem>>().ElementAt(index);
-            InputManager.MoveMouseTo(item.ChildrenOfType<DrawableRoomPlaylistItem.PlaylistRemoveButton>().ElementAt(0), offset);
+            InputManager.MoveMouseTo(item.ChildrenOfType<DrawableRoomPlaylistItem>().ElementAt(0).RemoveButton, offset);
         });
 
         private void createPlaylist()
diff --git a/osu.Game.Tests/Visual/Online/TestSceneMultiplayerQueueList.cs b/osu.Game.Tests/Visual/Online/TestSceneMultiplayerQueueList.cs
index 19e5624a04..95cef391f1 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneMultiplayerQueueList.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneMultiplayerQueueList.cs
@@ -154,7 +154,7 @@ namespace osu.Game.Tests.Visual.Online
             AddStep($"move mouse to delete button {index}", () =>
             {
                 item = playlist.ChildrenOfType<OsuRearrangeableListItem<PlaylistItem>>().ElementAt(index);
-                InputManager.MoveMouseTo(item.ChildrenOfType<DrawableRoomPlaylistItem.PlaylistRemoveButton>().ElementAt(0));
+                InputManager.MoveMouseTo(item.ChildrenOfType<DrawableRoomPlaylistItem>().ElementAt(0).RemoveButton);
             });
 
             AddStep("click", () => InputManager.Click(MouseButton.Left));
@@ -164,6 +164,6 @@ namespace osu.Game.Tests.Visual.Online
 
         private void assertDeleteButtonVisibility(int index, bool visible)
             => AddUntilStep($"delete button {index} {(visible ? "is" : "is not")} visible",
-                () => (playlist.ChildrenOfType<DrawableRoomPlaylistItem.PlaylistRemoveButton>().ElementAt(index).Alpha > 0) == visible);
+                () => (playlist.ChildrenOfType<DrawableRoomPlaylistItem>().ElementAt(index).RemoveButton.Alpha > 0) == visible);
     }
 }
diff --git a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
index 9ad43fced5..ac5f77a72b 100644
--- a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
+++ b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
@@ -59,6 +59,8 @@ namespace osu.Game.Screens.OnlinePlay
 
         public readonly PlaylistItem Item;
 
+        public Drawable RemoveButton { get; private set; }
+
         private readonly DelayedLoadWrapper onScreenLoader = new DelayedLoadWrapper(Empty) { RelativeSizeAxes = Axes.Both };
         private readonly IBindable<bool> valid = new Bindable<bool>();
         private readonly Bindable<IBeatmapInfo> beatmap = new Bindable<IBeatmapInfo>();
@@ -73,7 +75,6 @@ namespace osu.Game.Screens.OnlinePlay
         private ModDisplay modDisplay;
         private FillFlowContainer buttonsFlow;
         private UpdateableAvatar ownerAvatar;
-        private Drawable removeButton;
         private Drawable showResultsButton;
         private PanelBackground panelBackground;
         private FillFlowContainer mainFillFlow;
@@ -191,8 +192,8 @@ namespace osu.Game.Screens.OnlinePlay
             {
                 allowDeletion = value;
 
-                if (removeButton != null)
-                    removeButton.Alpha = value ? 1 : 0;
+                if (RemoveButton != null)
+                    RemoveButton.Alpha = value ? 1 : 0;
             }
         }
 
@@ -408,35 +409,23 @@ namespace osu.Game.Screens.OnlinePlay
 
         private IEnumerable<Drawable> createButtons() => new[]
         {
-            showResultsButton = new ShowResultsButton
+            showResultsButton = new GrayButton(FontAwesome.Solid.ChartPie)
             {
+                Size = new Vector2(30, 30),
                 Action = () => RequestResults?.Invoke(Item),
                 Alpha = AllowShowingResults ? 1 : 0,
+                TooltipText = "View results"
             },
             Item.Beatmap.Value == null ? Empty() : new PlaylistDownloadButton(Item),
-            removeButton = new PlaylistRemoveButton
+            RemoveButton = new GrayButton(FontAwesome.Solid.MinusSquare)
             {
                 Size = new Vector2(30, 30),
                 Alpha = AllowDeletion ? 1 : 0,
                 Action = () => RequestDeletion?.Invoke(Item),
+                TooltipText = "Remove from playlist"
             },
         };
 
-        public class PlaylistRemoveButton : GrayButton
-        {
-            public PlaylistRemoveButton()
-                : base(FontAwesome.Solid.MinusSquare)
-            {
-                TooltipText = "Remove from playlist";
-            }
-
-            [BackgroundDependencyLoader]
-            private void load()
-            {
-                Icon.Scale = new Vector2(0.8f);
-            }
-        }
-
         protected override bool OnClick(ClickEvent e)
         {
             if (AllowSelection && valid.Value)
@@ -497,23 +486,6 @@ namespace osu.Game.Screens.OnlinePlay
             }
         }
 
-        private class ShowResultsButton : IconButton
-        {
-            [BackgroundDependencyLoader]
-            private void load(OsuColour colours)
-            {
-                Icon = FontAwesome.Solid.ChartPie;
-                TooltipText = "View results";
-
-                Add(new Box
-                {
-                    RelativeSizeAxes = Axes.Both,
-                    Depth = float.MaxValue,
-                    Colour = colours.Gray4,
-                });
-            }
-        }
-
         // For now, this is the same implementation as in PanelBackground, but supports a beatmap info rather than a working beatmap
         private class PanelBackground : Container // todo: should be a buffered container (https://github.com/ppy/osu-framework/issues/3222)
         {

From 05aa9635a8cee0503e30a5200a37ccd3c80114c9 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 10 Dec 2021 00:38:18 +0900
Subject: [PATCH 1600/5547] Privatise button again

---
 .../TestSceneDrawableRoomPlaylist.cs            |  2 +-
 .../TestScenePlaylistsRoomSettingsPlaylist.cs   |  2 +-
 .../Online/TestSceneMultiplayerQueueList.cs     |  4 ++--
 .../OnlinePlay/DrawableRoomPlaylistItem.cs      | 17 ++++++++++++-----
 4 files changed, 16 insertions(+), 9 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
index d0cf17db1f..24d7d62aa3 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
@@ -273,7 +273,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
         private void assertDeleteButtonVisibility(int index, bool visible)
             => AddAssert($"delete button {index} {(visible ? "is" : "is not")} visible",
-                () => (playlist.ChildrenOfType<DrawableRoomPlaylistItem>().ElementAt(2 + index * 2).RemoveButton.Alpha > 0) == visible);
+                () => (playlist.ChildrenOfType<DrawableRoomPlaylistItem.PlaylistRemoveButton>().ElementAt(2 + index * 2).Alpha > 0) == visible);
 
         private void createPlaylist(Action<TestPlaylist> setupPlaylist = null)
         {
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsRoomSettingsPlaylist.cs b/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsRoomSettingsPlaylist.cs
index c61b99c2c2..93ccd5f1e1 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsRoomSettingsPlaylist.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsRoomSettingsPlaylist.cs
@@ -126,7 +126,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         private void moveToDeleteButton(int index, Vector2? offset = null) => AddStep($"move mouse to delete button {index}", () =>
         {
             var item = playlist.ChildrenOfType<OsuRearrangeableListItem<PlaylistItem>>().ElementAt(index);
-            InputManager.MoveMouseTo(item.ChildrenOfType<DrawableRoomPlaylistItem>().ElementAt(0).RemoveButton, offset);
+            InputManager.MoveMouseTo(item.ChildrenOfType<DrawableRoomPlaylistItem.PlaylistRemoveButton>().ElementAt(0), offset);
         });
 
         private void createPlaylist()
diff --git a/osu.Game.Tests/Visual/Online/TestSceneMultiplayerQueueList.cs b/osu.Game.Tests/Visual/Online/TestSceneMultiplayerQueueList.cs
index 95cef391f1..19e5624a04 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneMultiplayerQueueList.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneMultiplayerQueueList.cs
@@ -154,7 +154,7 @@ namespace osu.Game.Tests.Visual.Online
             AddStep($"move mouse to delete button {index}", () =>
             {
                 item = playlist.ChildrenOfType<OsuRearrangeableListItem<PlaylistItem>>().ElementAt(index);
-                InputManager.MoveMouseTo(item.ChildrenOfType<DrawableRoomPlaylistItem>().ElementAt(0).RemoveButton);
+                InputManager.MoveMouseTo(item.ChildrenOfType<DrawableRoomPlaylistItem.PlaylistRemoveButton>().ElementAt(0));
             });
 
             AddStep("click", () => InputManager.Click(MouseButton.Left));
@@ -164,6 +164,6 @@ namespace osu.Game.Tests.Visual.Online
 
         private void assertDeleteButtonVisibility(int index, bool visible)
             => AddUntilStep($"delete button {index} {(visible ? "is" : "is not")} visible",
-                () => (playlist.ChildrenOfType<DrawableRoomPlaylistItem>().ElementAt(index).RemoveButton.Alpha > 0) == visible);
+                () => (playlist.ChildrenOfType<DrawableRoomPlaylistItem.PlaylistRemoveButton>().ElementAt(index).Alpha > 0) == visible);
     }
 }
diff --git a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
index ac5f77a72b..9640d9db46 100644
--- a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
+++ b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
@@ -59,8 +59,6 @@ namespace osu.Game.Screens.OnlinePlay
 
         public readonly PlaylistItem Item;
 
-        public Drawable RemoveButton { get; private set; }
-
         private readonly DelayedLoadWrapper onScreenLoader = new DelayedLoadWrapper(Empty) { RelativeSizeAxes = Axes.Both };
         private readonly IBindable<bool> valid = new Bindable<bool>();
         private readonly Bindable<IBeatmapInfo> beatmap = new Bindable<IBeatmapInfo>();
@@ -76,6 +74,7 @@ namespace osu.Game.Screens.OnlinePlay
         private FillFlowContainer buttonsFlow;
         private UpdateableAvatar ownerAvatar;
         private Drawable showResultsButton;
+        private Drawable removeButton;
         private PanelBackground panelBackground;
         private FillFlowContainer mainFillFlow;
 
@@ -192,8 +191,8 @@ namespace osu.Game.Screens.OnlinePlay
             {
                 allowDeletion = value;
 
-                if (RemoveButton != null)
-                    RemoveButton.Alpha = value ? 1 : 0;
+                if (removeButton != null)
+                    removeButton.Alpha = value ? 1 : 0;
             }
         }
 
@@ -417,7 +416,7 @@ namespace osu.Game.Screens.OnlinePlay
                 TooltipText = "View results"
             },
             Item.Beatmap.Value == null ? Empty() : new PlaylistDownloadButton(Item),
-            RemoveButton = new GrayButton(FontAwesome.Solid.MinusSquare)
+            removeButton = new PlaylistRemoveButton
             {
                 Size = new Vector2(30, 30),
                 Alpha = AllowDeletion ? 1 : 0,
@@ -433,6 +432,14 @@ namespace osu.Game.Screens.OnlinePlay
             return true;
         }
 
+        public class PlaylistRemoveButton : GrayButton
+        {
+            public PlaylistRemoveButton()
+                : base(FontAwesome.Solid.MinusSquare)
+            {
+            }
+        }
+
         private sealed class PlaylistDownloadButton : BeatmapDownloadButton
         {
             private readonly PlaylistItem playlistItem;

From 4d1c06c0612a76d527d6458d04e1bb87486482be Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 10 Dec 2021 01:03:36 +0900
Subject: [PATCH 1601/5547] Add support for host enqueueing in
 TestMultiplayerClient

---
 .../Multiplayer/TestMultiplayerClient.cs      | 35 +++++++++++--------
 1 file changed, 20 insertions(+), 15 deletions(-)

diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
index f151add430..1516d0e473 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
@@ -309,31 +309,36 @@ namespace osu.Game.Tests.Visual.Multiplayer
             Debug.Assert(APIRoom != null);
             Debug.Assert(currentItem != null);
 
+            bool isNewAddition = item.ID == 0;
+
             if (Room.Settings.QueueMode == QueueMode.HostOnly && Room.Host?.UserID != LocalUser?.UserID)
                 throw new InvalidOperationException("Local user is not the room host.");
 
             item.OwnerID = userId;
 
-            switch (Room.Settings.QueueMode)
+            if (isNewAddition)
             {
-                case QueueMode.HostOnly:
-                    // In host-only mode, the current item is re-used.
-                    item.ID = currentItem.ID;
-                    item.PlaylistOrder = currentItem.PlaylistOrder;
+                await addItem(item).ConfigureAwait(false);
+                await updateCurrentItem(Room).ConfigureAwait(false);
+            }
+            else
+            {
+                var existingItem = serverSidePlaylist.SingleOrDefault(i => i.ID == item.ID);
 
-                    serverSidePlaylist[currentIndex] = item;
-                    await ((IMultiplayerClient)this).PlaylistItemChanged(item).ConfigureAwait(false);
+                if (existingItem == null)
+                    throw new InvalidOperationException("Attempted to change an item that doesn't exist.");
 
-                    // Note: Unlike the server, this is the easiest way to update the current item at this point.
-                    await updateCurrentItem(Room, false).ConfigureAwait(false);
-                    break;
+                if (existingItem.OwnerID != userId && Room.Host?.UserID != LocalUser?.UserID)
+                    throw new InvalidOperationException("Attempted to change an item which is not owned by the user.");
 
-                default:
-                    await addItem(item).ConfigureAwait(false);
+                if (existingItem.Expired)
+                    throw new InvalidOperationException("Attempted to change an item which has already been played.");
 
-                    // The current item can change as a result of an item being added. For example, if all items earlier in the queue were expired.
-                    await updateCurrentItem(Room).ConfigureAwait(false);
-                    break;
+                // Ensure the playlist order doesn't change.
+                item.PlaylistOrder = existingItem.PlaylistOrder;
+
+                serverSidePlaylist[serverSidePlaylist.IndexOf(existingItem)] = item;
+                await ((IMultiplayerClient)this).PlaylistItemChanged(item).ConfigureAwait(false);
             }
         }
 

From 048a4951156593ae4c2a45d019fe15210228ca2c Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 10 Dec 2021 01:08:54 +0900
Subject: [PATCH 1602/5547] Add edit button to DrawableRoomPlaylistItem

---
 .../TestSceneDrawableRoomPlaylist.cs          |  1 +
 .../OnlinePlay/DrawableRoomPlaylist.cs        | 27 ++++++++++++-
 .../OnlinePlay/DrawableRoomPlaylistItem.cs    | 38 +++++++++++++++++++
 3 files changed, 65 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
index 24d7d62aa3..f9784384fd 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
@@ -255,6 +255,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             {
                 p.AllowDeletion = true;
                 p.AllowShowingResults = true;
+                p.AllowEditing = true;
             });
         }
 
diff --git a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs
index 5e180afcf9..57bb4253cb 100644
--- a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs
+++ b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs
@@ -33,6 +33,11 @@ namespace osu.Game.Screens.OnlinePlay
         /// </summary>
         public Action<PlaylistItem> RequestResults;
 
+        /// <summary>
+        /// Invoked when an item requests to be edited.
+        /// </summary>
+        public Action<PlaylistItem> RequestEdit;
+
         private bool allowReordering;
 
         /// <summary>
@@ -104,6 +109,24 @@ namespace osu.Game.Screens.OnlinePlay
             }
         }
 
+        private bool allowEditing;
+
+        /// <summary>
+        /// Whether to allow items to be edited.
+        /// If <c>true</c>, requests to edit items may be satisfied via <see cref="RequestEdit"/>.
+        /// </summary>
+        public bool AllowEditing
+        {
+            get => allowEditing;
+            set
+            {
+                allowEditing = value;
+
+                foreach (var item in ListContainer.OfType<DrawableRoomPlaylistItem>())
+                    item.AllowEditing = value;
+            }
+        }
+
         private bool showItemOwners;
 
         /// <summary>
@@ -135,12 +158,14 @@ namespace osu.Game.Screens.OnlinePlay
         {
             d.SelectedItem.BindTarget = SelectedItem;
             d.RequestDeletion = i => RequestDeletion?.Invoke(i);
+            d.RequestResults = i => RequestResults?.Invoke(i);
+            d.RequestEdit = i => RequestEdit?.Invoke(i);
             d.AllowReordering = AllowReordering;
             d.AllowDeletion = AllowDeletion;
             d.AllowSelection = AllowSelection;
             d.AllowShowingResults = AllowShowingResults;
+            d.AllowEditing = AllowEditing;
             d.ShowItemOwner = ShowItemOwners;
-            d.RequestResults = i => RequestResults?.Invoke(i);
         });
 
         protected virtual DrawableRoomPlaylistItem CreateDrawablePlaylistItem(PlaylistItem item) => new DrawableRoomPlaylistItem(item);
diff --git a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
index 9640d9db46..8042f7d772 100644
--- a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
+++ b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
@@ -51,6 +51,11 @@ namespace osu.Game.Screens.OnlinePlay
         /// </summary>
         public Action<PlaylistItem> RequestResults;
 
+        /// <summary>
+        /// Invoked when this item requests to be edited.
+        /// </summary>
+        public Action<PlaylistItem> RequestEdit;
+
         /// <summary>
         /// The currently-selected item, used to show a border around this item.
         /// May be updated by this item if <see cref="AllowSelection"/> is <c>true</c>.
@@ -74,6 +79,7 @@ namespace osu.Game.Screens.OnlinePlay
         private FillFlowContainer buttonsFlow;
         private UpdateableAvatar ownerAvatar;
         private Drawable showResultsButton;
+        private Drawable editButton;
         private Drawable removeButton;
         private PanelBackground panelBackground;
         private FillFlowContainer mainFillFlow;
@@ -213,6 +219,23 @@ namespace osu.Game.Screens.OnlinePlay
             }
         }
 
+        private bool allowEditing;
+
+        /// <summary>
+        /// Whether this item can be edited.
+        /// </summary>
+        public bool AllowEditing
+        {
+            get => allowEditing;
+            set
+            {
+                allowEditing = value;
+
+                if (editButton != null)
+                    editButton.Alpha = value ? 1 : 0;
+            }
+        }
+
         private bool showItemOwner;
 
         /// <summary>
@@ -416,6 +439,13 @@ namespace osu.Game.Screens.OnlinePlay
                 TooltipText = "View results"
             },
             Item.Beatmap.Value == null ? Empty() : new PlaylistDownloadButton(Item),
+            editButton = new PlaylistEditButton
+            {
+                Size = new Vector2(30, 30),
+                Alpha = AllowEditing ? 1 : 0,
+                Action = () => RequestEdit?.Invoke(Item),
+                TooltipText = "Edit"
+            },
             removeButton = new PlaylistRemoveButton
             {
                 Size = new Vector2(30, 30),
@@ -432,6 +462,14 @@ namespace osu.Game.Screens.OnlinePlay
             return true;
         }
 
+        public class PlaylistEditButton : GrayButton
+        {
+            public PlaylistEditButton()
+                : base(FontAwesome.Solid.Edit)
+            {
+            }
+        }
+
         public class PlaylistRemoveButton : GrayButton
         {
             public PlaylistRemoveButton()

From 671582a9255706334c67f75a0cece57a454be14a Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 10 Dec 2021 01:15:15 +0900
Subject: [PATCH 1603/5547] Allow host to enqeue items and items to be edited

---
 .../TestSceneAllPlayersQueueMode.cs           |  4 +-
 .../Multiplayer/TestSceneHostOnlyQueueMode.cs | 24 ++++++++++-
 .../Multiplayer/TestSceneMultiplayer.cs       |  3 +-
 .../TestSceneMultiplayerMatchSongSelect.cs    |  2 +-
 .../Match/Playlist/MultiplayerPlaylist.cs     |  9 +++-
 .../Match/Playlist/MultiplayerQueueList.cs    |  6 ++-
 .../Multiplayer/MultiplayerMatchSongSelect.cs |  8 +++-
 .../Multiplayer/MultiplayerMatchSubScreen.cs  | 42 +++++++------------
 .../OnlinePlay/OnlinePlaySongSelect.cs        | 12 +++---
 9 files changed, 67 insertions(+), 43 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneAllPlayersQueueMode.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneAllPlayersQueueMode.cs
index ccfae1deef..8373979308 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneAllPlayersQueueMode.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneAllPlayersQueueMode.cs
@@ -87,9 +87,9 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
         private void addItem(Func<BeatmapInfo> beatmap)
         {
-            AddStep("click edit button", () =>
+            AddStep("click add button", () =>
             {
-                InputManager.MoveMouseTo(this.ChildrenOfType<MultiplayerMatchSubScreen>().Single().AddOrEditPlaylistButton);
+                InputManager.MoveMouseTo(this.ChildrenOfType<MultiplayerMatchSubScreen.AddItemButton>().Single());
                 InputManager.Click(MouseButton.Left);
             });
 
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneHostOnlyQueueMode.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneHostOnlyQueueMode.cs
index 1de7289446..ccac3de304 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneHostOnlyQueueMode.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneHostOnlyQueueMode.cs
@@ -7,6 +7,7 @@ using NUnit.Framework;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
 using osu.Game.Online.Multiplayer;
+using osu.Game.Screens.OnlinePlay;
 using osu.Game.Screens.OnlinePlay.Multiplayer;
 using osuTK.Input;
 
@@ -74,11 +75,19 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddUntilStep("api room updated", () => Client.APIRoom?.QueueMode.Value == QueueMode.AllPlayers);
         }
 
+        [Test]
+        public void TestAddItemsAsHost()
+        {
+            addItem(() => OtherBeatmap);
+
+            AddAssert("playlist contains two items", () => Client.APIRoom?.Playlist.Count == 2);
+        }
+
         private void selectNewItem(Func<BeatmapInfo> beatmap)
         {
             AddStep("click edit button", () =>
             {
-                InputManager.MoveMouseTo(this.ChildrenOfType<MultiplayerMatchSubScreen>().Single().AddOrEditPlaylistButton);
+                InputManager.MoveMouseTo(this.ChildrenOfType<DrawableRoomPlaylistItem.PlaylistEditButton>().First());
                 InputManager.Click(MouseButton.Left);
             });
 
@@ -90,5 +99,18 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddUntilStep("wait for return to match", () => CurrentSubScreen is MultiplayerMatchSubScreen);
             AddUntilStep("selected item is new beatmap", () => Client.CurrentMatchPlayingItem.Value?.Beatmap.Value?.OnlineID == otherBeatmap.OnlineID);
         }
+
+        private void addItem(Func<BeatmapInfo> beatmap)
+        {
+            AddStep("click add button", () =>
+            {
+                InputManager.MoveMouseTo(this.ChildrenOfType<MultiplayerMatchSubScreen.AddItemButton>().Single());
+                InputManager.Click(MouseButton.Left);
+            });
+
+            AddUntilStep("wait for song select", () => CurrentSubScreen is Screens.Select.SongSelect select && select.BeatmapSetsLoaded);
+            AddStep("select other beatmap", () => ((Screens.Select.SongSelect)CurrentSubScreen).FinaliseSelection(beatmap()));
+            AddUntilStep("wait for return to match", () => CurrentSubScreen is MultiplayerMatchSubScreen);
+        }
     }
 }
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
index 2411f39ae3..5eb0abc830 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
@@ -416,8 +416,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddStep("Enter song select", () =>
             {
                 var currentSubScreen = ((Screens.OnlinePlay.Multiplayer.Multiplayer)multiplayerScreenStack.CurrentScreen).CurrentSubScreen;
-
-                ((MultiplayerMatchSubScreen)currentSubScreen).SelectBeatmap();
+                ((MultiplayerMatchSubScreen)currentSubScreen).OpenSongSelection(client.CurrentMatchPlayingItem.Value);
             });
 
             AddUntilStep("wait for song select", () => this.ChildrenOfType<MultiplayerMatchSongSelect>().FirstOrDefault()?.BeatmapSetsLoaded == true);
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs
index a5229702a8..d671673d3c 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs
@@ -179,7 +179,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             public new BeatmapCarousel Carousel => base.Carousel;
 
             public TestMultiplayerMatchSongSelect(Room room, WorkingBeatmap beatmap = null, RulesetInfo ruleset = null)
-                : base(room, beatmap, ruleset)
+                : base(room, null, beatmap, ruleset)
             {
             }
         }
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylist.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylist.cs
index c3245b550f..4971489769 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylist.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylist.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 osu.Framework.Allocation;
 using osu.Framework.Bindables;
@@ -19,6 +20,11 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist
     {
         public readonly Bindable<MultiplayerPlaylistDisplayMode> DisplayMode = new Bindable<MultiplayerPlaylistDisplayMode>();
 
+        /// <summary>
+        /// Invoked when an item requests to be edited.
+        /// </summary>
+        public Action<PlaylistItem> RequestEdit;
+
         private MultiplayerQueueList queueList;
         private MultiplayerHistoryList historyList;
         private bool firstPopulation = true;
@@ -46,7 +52,8 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist
                         queueList = new MultiplayerQueueList
                         {
                             RelativeSizeAxes = Axes.Both,
-                            SelectedItem = { BindTarget = SelectedItem }
+                            SelectedItem = { BindTarget = SelectedItem },
+                            RequestEdit = item => RequestEdit?.Invoke(item)
                         },
                         historyList = new MultiplayerHistoryList
                         {
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerQueueList.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerQueueList.cs
index 8832c9bd60..3e0f663d42 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerQueueList.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerQueueList.cs
@@ -78,8 +78,10 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist
 
             private void updateDeleteButtonVisibility()
             {
-                AllowDeletion = (Item.OwnerID == api.LocalUser.Value.OnlineID || multiplayerClient.IsHost)
-                                && SelectedItem.Value != Item;
+                bool isItemOwner = Item.OwnerID == api.LocalUser.Value.OnlineID || multiplayerClient.IsHost;
+
+                AllowDeletion = isItemOwner && SelectedItem.Value != Item;
+                AllowEditing = isItemOwner;
             }
         }
     }
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs
index 44efef53f5..80a0289ba9 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs
@@ -24,17 +24,22 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
         [Resolved]
         private MultiplayerClient client { get; set; }
 
+        private readonly PlaylistItem itemToEdit;
+
         private LoadingLayer loadingLayer;
 
         /// <summary>
         /// Construct a new instance of multiplayer song select.
         /// </summary>
         /// <param name="room">The room.</param>
+        /// <param name="itemToEdit">The item to be edited. May be null, in which case a new item will be added to the playlist.</param>
         /// <param name="beatmap">An optional initial beatmap selection to perform.</param>
         /// <param name="ruleset">An optional initial ruleset selection to perform.</param>
-        public MultiplayerMatchSongSelect(Room room, WorkingBeatmap beatmap = null, RulesetInfo ruleset = null)
+        public MultiplayerMatchSongSelect(Room room, PlaylistItem itemToEdit = null, WorkingBeatmap beatmap = null, RulesetInfo ruleset = null)
             : base(room)
         {
+            this.itemToEdit = itemToEdit;
+
             if (beatmap != null || ruleset != null)
             {
                 Schedule(() =>
@@ -61,6 +66,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
 
                 client.AddPlaylistItem(new MultiplayerPlaylistItem
                 {
+                    ID = itemToEdit?.ID ?? 0,
                     BeatmapID = item.BeatmapID,
                     BeatmapChecksum = item.Beatmap.Value.MD5Hash,
                     RulesetID = item.RulesetID,
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
index 3a25bd7b06..96a9804067 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
@@ -14,7 +14,6 @@ using osu.Framework.Screens;
 using osu.Framework.Threading;
 using osu.Game.Beatmaps;
 using osu.Game.Configuration;
-using osu.Game.Graphics.UserInterface;
 using osu.Game.Online;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Rooms;
@@ -44,8 +43,6 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
 
         public override string ShortTitle => "room";
 
-        public OsuButton AddOrEditPlaylistButton { get; private set; }
-
         [Resolved]
         private MultiplayerClient client { get; set; }
 
@@ -57,6 +54,8 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
         [CanBeNull]
         private IDisposable readyClickOperation;
 
+        private AddItemButton addItemButton;
+
         public MultiplayerMatchSubScreen(Room room)
             : base(room)
         {
@@ -134,12 +133,12 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
                                 new Drawable[] { new OverlinedHeader("Beatmap") },
                                 new Drawable[]
                                 {
-                                    AddOrEditPlaylistButton = new PurpleTriangleButton
+                                    addItemButton = new AddItemButton
                                     {
                                         RelativeSizeAxes = Axes.X,
                                         Height = 40,
-                                        Action = SelectBeatmap,
-                                        Alpha = 0
+                                        Text = "Add item",
+                                        Action = () => OpenSongSelection(null)
                                     },
                                 },
                                 null,
@@ -147,7 +146,8 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
                                 {
                                     new MultiplayerPlaylist
                                     {
-                                        RelativeSizeAxes = Axes.Both
+                                        RelativeSizeAxes = Axes.Both,
+                                        RequestEdit = OpenSongSelection
                                     }
                                 },
                                 new[]
@@ -220,12 +220,12 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
             }
         };
 
-        internal void SelectBeatmap()
+        internal void OpenSongSelection(PlaylistItem itemToEdit)
         {
             if (!this.IsCurrentScreen())
                 return;
 
-            this.Push(new MultiplayerMatchSongSelect(Room));
+            this.Push(new MultiplayerMatchSongSelect(Room, itemToEdit));
         }
 
         protected override Drawable CreateFooter() => new MultiplayerMatchFooter
@@ -385,23 +385,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
                 return;
             }
 
-            switch (client.Room.Settings.QueueMode)
-            {
-                case QueueMode.HostOnly:
-                    AddOrEditPlaylistButton.Text = "Edit beatmap";
-                    AddOrEditPlaylistButton.Alpha = client.IsHost ? 1 : 0;
-                    break;
-
-                case QueueMode.AllPlayers:
-                case QueueMode.AllPlayersRoundRobin:
-                    AddOrEditPlaylistButton.Text = "Add beatmap";
-                    AddOrEditPlaylistButton.Alpha = 1;
-                    break;
-
-                default:
-                    AddOrEditPlaylistButton.Alpha = 0;
-                    break;
-            }
+            addItemButton.Alpha = client.IsHost || Room.QueueMode.Value != QueueMode.HostOnly ? 1 : 0;
 
             Scheduler.AddOnce(UpdateMods);
         }
@@ -466,7 +450,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
                 return;
             }
 
-            this.Push(new MultiplayerMatchSongSelect(Room, beatmap, ruleset));
+            this.Push(new MultiplayerMatchSongSelect(Room, SelectedItem.Value, beatmap, ruleset));
         }
 
         protected override void Dispose(bool isDisposing)
@@ -481,5 +465,9 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
 
             modSettingChangeTracker?.Dispose();
         }
+
+        public class AddItemButton : PurpleTriangleButton
+        {
+        }
     }
 }
diff --git a/osu.Game/Screens/OnlinePlay/OnlinePlaySongSelect.cs b/osu.Game/Screens/OnlinePlay/OnlinePlaySongSelect.cs
index 4bc0b55433..63957caee3 100644
--- a/osu.Game/Screens/OnlinePlay/OnlinePlaySongSelect.cs
+++ b/osu.Game/Screens/OnlinePlay/OnlinePlaySongSelect.cs
@@ -33,14 +33,14 @@ namespace osu.Game.Screens.OnlinePlay
         [Resolved(typeof(Room), nameof(Room.Playlist))]
         protected BindableList<PlaylistItem> Playlist { get; private set; }
 
+        [CanBeNull]
+        [Resolved(CanBeNull = true)]
+        protected IBindable<PlaylistItem> SelectedItem { get; private set; }
+
         protected override UserActivity InitialActivity => new UserActivity.InLobby(room);
 
         protected readonly Bindable<IReadOnlyList<Mod>> FreeMods = new Bindable<IReadOnlyList<Mod>>(Array.Empty<Mod>());
 
-        [CanBeNull]
-        [Resolved(CanBeNull = true)]
-        private IBindable<PlaylistItem> selectedItem { get; set; }
-
         private readonly FreeModSelectOverlay freeModSelectOverlay;
         private readonly Room room;
 
@@ -80,8 +80,8 @@ namespace osu.Game.Screens.OnlinePlay
 
             // At this point, Mods contains both the required and allowed mods. For selection purposes, it should only contain the required mods.
             // Similarly, freeMods is currently empty but should only contain the allowed mods.
-            Mods.Value = selectedItem?.Value?.RequiredMods.Select(m => m.DeepClone()).ToArray() ?? Array.Empty<Mod>();
-            FreeMods.Value = selectedItem?.Value?.AllowedMods.Select(m => m.DeepClone()).ToArray() ?? Array.Empty<Mod>();
+            Mods.Value = SelectedItem?.Value?.RequiredMods.Select(m => m.DeepClone()).ToArray() ?? Array.Empty<Mod>();
+            FreeMods.Value = SelectedItem?.Value?.AllowedMods.Select(m => m.DeepClone()).ToArray() ?? Array.Empty<Mod>();
 
             Mods.BindValueChanged(onModsChanged);
             Ruleset.BindValueChanged(onRulesetChanged);

From a445dcd2c60a0f5456884f8346de75b37717ea2e Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 10 Dec 2021 02:09:31 +0900
Subject: [PATCH 1604/5547] Fix incorrect test namespace

---
 .../{Online => Multiplayer}/TestSceneMultiplayerQueueList.cs   | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)
 rename osu.Game.Tests/Visual/{Online => Multiplayer}/TestSceneMultiplayerQueueList.cs (98%)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneMultiplayerQueueList.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs
similarity index 98%
rename from osu.Game.Tests/Visual/Online/TestSceneMultiplayerQueueList.cs
rename to osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs
index 19e5624a04..a2b2da0aec 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneMultiplayerQueueList.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs
@@ -20,11 +20,10 @@ using osu.Game.Rulesets;
 using osu.Game.Screens.OnlinePlay;
 using osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist;
 using osu.Game.Tests.Resources;
-using osu.Game.Tests.Visual.Multiplayer;
 using osuTK;
 using osuTK.Input;
 
-namespace osu.Game.Tests.Visual.Online
+namespace osu.Game.Tests.Visual.Multiplayer
 {
     public class TestSceneMultiplayerQueueList : MultiplayerTestScene
     {

From 612f47bb9ff7eaf565def5970fc24daf80f7007d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 10 Dec 2021 13:45:29 +0900
Subject: [PATCH 1605/5547] Add the ability to create playlists of 2 weeks ~ 3
 months in duration

---
 .../Playlists/PlaylistsRoomSettingsOverlay.cs | 52 ++++++++++++++-----
 1 file changed, 38 insertions(+), 14 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSettingsOverlay.cs b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSettingsOverlay.cs
index 8f31422add..6c8ab52d22 100644
--- a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSettingsOverlay.cs
+++ b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSettingsOverlay.cs
@@ -5,7 +5,9 @@ using System;
 using System.Collections.Specialized;
 using System.Linq;
 using Humanizer;
+using Humanizer.Localisation;
 using osu.Framework.Allocation;
+using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
@@ -14,6 +16,8 @@ using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.UserInterface;
+using osu.Game.Online.API;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Rooms;
 using osu.Game.Overlays;
 using osu.Game.Screens.OnlinePlay.Match.Components;
@@ -69,6 +73,9 @@ namespace osu.Game.Screens.OnlinePlay.Playlists
             [Resolved(CanBeNull = true)]
             private IRoomManager manager { get; set; }
 
+            [Resolved]
+            private IAPIProvider api { get; set; }
+
             private readonly Room room;
 
             public MatchSettings(Room room)
@@ -134,19 +141,6 @@ namespace osu.Game.Screens.OnlinePlay.Playlists
                                                             Child = DurationField = new DurationDropdown
                                                             {
                                                                 RelativeSizeAxes = Axes.X,
-                                                                Items = new[]
-                                                                {
-                                                                    TimeSpan.FromMinutes(30),
-                                                                    TimeSpan.FromHours(1),
-                                                                    TimeSpan.FromHours(2),
-                                                                    TimeSpan.FromHours(4),
-                                                                    TimeSpan.FromHours(8),
-                                                                    TimeSpan.FromHours(12),
-                                                                    //TimeSpan.FromHours(16),
-                                                                    TimeSpan.FromHours(24),
-                                                                    TimeSpan.FromDays(3),
-                                                                    TimeSpan.FromDays(7)
-                                                                }
                                                             }
                                                         },
                                                         new Section("Allowed attempts (across all playlist items)")
@@ -303,10 +297,40 @@ namespace osu.Game.Screens.OnlinePlay.Playlists
                 MaxAttempts.BindValueChanged(count => MaxAttemptsField.Text = count.NewValue?.ToString(), true);
                 Duration.BindValueChanged(duration => DurationField.Current.Value = duration.NewValue ?? TimeSpan.FromMinutes(30), true);
 
+                api.LocalUser.BindValueChanged(populateDurations, true);
+
                 playlist.Items.BindTo(Playlist);
                 Playlist.BindCollectionChanged(onPlaylistChanged, true);
             }
 
+            private void populateDurations(ValueChangedEvent<APIUser> user)
+            {
+                DurationField.Items = new[]
+                {
+                    TimeSpan.FromMinutes(30),
+                    TimeSpan.FromHours(1),
+                    TimeSpan.FromHours(2),
+                    TimeSpan.FromHours(4),
+                    TimeSpan.FromHours(8),
+                    TimeSpan.FromHours(12),
+                    TimeSpan.FromHours(24),
+                    TimeSpan.FromDays(3),
+                    TimeSpan.FromDays(7),
+                    TimeSpan.FromDays(14),
+                };
+
+                // TODO: show these in the interface at all times.
+                if (user.NewValue.IsSupporter)
+                {
+                    // roughly correct (see https://github.com/Humanizr/Humanizer/blob/18167e56c082449cc4fe805b8429e3127a7b7f93/readme.md?plain=1#L427)
+                    // if we want this to be more accurate we might consider sending an actual end time, not a time span. probably not required though.
+                    const int days_in_month = 31;
+
+                    DurationField.AddDropdownItem(TimeSpan.FromDays(days_in_month));
+                    DurationField.AddDropdownItem(TimeSpan.FromDays(days_in_month * 3));
+                }
+            }
+
             protected override void Update()
             {
                 base.Update();
@@ -405,7 +429,7 @@ namespace osu.Game.Screens.OnlinePlay.Playlists
                 Menu.MaxHeight = 100;
             }
 
-            protected override LocalisableString GenerateItemText(TimeSpan item) => item.Humanize();
+            protected override LocalisableString GenerateItemText(TimeSpan item) => item.Humanize(maxUnit: TimeUnit.Month);
         }
     }
 }

From 9ac8e6c81cfa391b757168f9621f5766a2ea4078 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 10 Dec 2021 13:53:48 +0900
Subject: [PATCH 1606/5547] Add missing null check before attempting to
 populate bpm info

---
 osu.Game/Screens/Select/BeatmapInfoWedge.cs | 31 +++++++++++----------
 1 file changed, 16 insertions(+), 15 deletions(-)

diff --git a/osu.Game/Screens/Select/BeatmapInfoWedge.cs b/osu.Game/Screens/Select/BeatmapInfoWedge.cs
index d292b7114f..6791565828 100644
--- a/osu.Game/Screens/Select/BeatmapInfoWedge.cs
+++ b/osu.Game/Screens/Select/BeatmapInfoWedge.cs
@@ -163,7 +163,7 @@ namespace osu.Game.Screens.Select
             private FillFlowContainer infoLabelContainer;
             private Container bpmLabelContainer;
 
-            private readonly WorkingBeatmap beatmap;
+            private readonly WorkingBeatmap working;
             private readonly RulesetInfo ruleset;
 
             [Resolved]
@@ -171,10 +171,10 @@ namespace osu.Game.Screens.Select
 
             private ModSettingChangeTracker settingChangeTracker;
 
-            public WedgeInfoText(WorkingBeatmap beatmap, RulesetInfo userRuleset)
+            public WedgeInfoText(WorkingBeatmap working, RulesetInfo userRuleset)
             {
-                this.beatmap = beatmap;
-                ruleset = userRuleset ?? beatmap.BeatmapInfo.Ruleset;
+                this.working = working;
+                ruleset = userRuleset ?? working.BeatmapInfo.Ruleset;
             }
 
             private CancellationTokenSource cancellationSource;
@@ -183,8 +183,8 @@ namespace osu.Game.Screens.Select
             [BackgroundDependencyLoader]
             private void load(OsuColour colours, LocalisationManager localisation, BeatmapDifficultyCache difficultyCache)
             {
-                var beatmapInfo = beatmap.BeatmapInfo;
-                var metadata = beatmapInfo.Metadata ?? beatmap.BeatmapSetInfo?.Metadata ?? new BeatmapMetadata();
+                var beatmapInfo = working.BeatmapInfo;
+                var metadata = beatmapInfo.Metadata ?? working.BeatmapSetInfo?.Metadata ?? new BeatmapMetadata();
 
                 RelativeSizeAxes = Axes.Both;
 
@@ -353,7 +353,7 @@ namespace osu.Game.Screens.Select
 
             private void addInfoLabels()
             {
-                if (beatmap.Beatmap?.HitObjects?.Any() != true)
+                if (working.Beatmap?.HitObjects?.Any() != true)
                     return;
 
                 infoLabelContainer.Children = new Drawable[]
@@ -362,7 +362,7 @@ namespace osu.Game.Screens.Select
                     {
                         Name = "Length",
                         CreateIcon = () => new BeatmapStatisticIcon(BeatmapStatisticsIconType.Length),
-                        Content = beatmap.BeatmapInfo.Length.ToFormattedDuration().ToString(),
+                        Content = working.BeatmapInfo.Length.ToFormattedDuration().ToString(),
                     }),
                     bpmLabelContainer = new Container
                     {
@@ -386,12 +386,12 @@ namespace osu.Game.Screens.Select
                     try
                     {
                         // Try to get the beatmap with the user's ruleset
-                        playableBeatmap = beatmap.GetPlayableBeatmap(ruleset, Array.Empty<Mod>());
+                        playableBeatmap = working.GetPlayableBeatmap(ruleset, Array.Empty<Mod>());
                     }
                     catch (BeatmapInvalidForRulesetException)
                     {
                         // Can't be converted to the user's ruleset, so use the beatmap's own ruleset
-                        playableBeatmap = beatmap.GetPlayableBeatmap(beatmap.BeatmapInfo.Ruleset, Array.Empty<Mod>());
+                        playableBeatmap = working.GetPlayableBeatmap(working.BeatmapInfo.Ruleset, Array.Empty<Mod>());
                     }
 
                     return playableBeatmap.GetStatistics().Select(s => new InfoLabel(s)).ToArray();
@@ -406,8 +406,9 @@ namespace osu.Game.Screens.Select
 
             private void refreshBPMLabel()
             {
-                var b = beatmap.Beatmap;
-                if (b == null)
+                var beatmap = working.Beatmap;
+
+                if (beatmap == null || bpmLabelContainer == null)
                     return;
 
                 // this doesn't consider mods which apply variable rates, yet.
@@ -415,9 +416,9 @@ namespace osu.Game.Screens.Select
                 foreach (var mod in mods.Value.OfType<IApplicableToRate>())
                     rate = mod.ApplyToRate(0, rate);
 
-                double bpmMax = b.ControlPointInfo.BPMMaximum * rate;
-                double bpmMin = b.ControlPointInfo.BPMMinimum * rate;
-                double mostCommonBPM = 60000 / b.GetMostCommonBeatLength() * rate;
+                double bpmMax = beatmap.ControlPointInfo.BPMMaximum * rate;
+                double bpmMin = beatmap.ControlPointInfo.BPMMinimum * rate;
+                double mostCommonBPM = 60000 / beatmap.GetMostCommonBeatLength() * rate;
 
                 string labelText = Precision.AlmostEquals(bpmMin, bpmMax)
                     ? $"{bpmMin:0}"

From 88670c3b014ce53d805dc51fd5426ef8540824bb Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 10 Dec 2021 14:14:22 +0900
Subject: [PATCH 1607/5547] Document `OpenSongSelection` and mark null param

---
 .../OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs   | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
index 96a9804067..946c749db3 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
@@ -138,7 +138,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
                                         RelativeSizeAxes = Axes.X,
                                         Height = 40,
                                         Text = "Add item",
-                                        Action = () => OpenSongSelection(null)
+                                        Action = () => OpenSongSelection()
                                     },
                                 },
                                 null,
@@ -220,7 +220,11 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
             }
         };
 
-        internal void OpenSongSelection(PlaylistItem itemToEdit)
+        /// <summary>
+        /// Opens the song selection screen to add or edit an item.
+        /// </summary>
+        /// <param name="itemToEdit">An optional playlist item to edit. If null, a new item will be added instead.</param>
+        internal void OpenSongSelection([CanBeNull] PlaylistItem itemToEdit = null)
         {
             if (!this.IsCurrentScreen())
                 return;

From de0f37b08d60477048a9015d1dcd8bb96e019996 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 10 Dec 2021 14:44:35 +0900
Subject: [PATCH 1608/5547] Separate editing and adding playlist items

---
 .../Multiplayer/IMultiplayerRoomServer.cs     |  6 ++
 .../Online/Multiplayer/MultiplayerClient.cs   |  2 +
 .../Multiplayer/OnlineMultiplayerClient.cs    |  8 +++
 .../Multiplayer/MultiplayerMatchSongSelect.cs |  9 ++-
 .../Multiplayer/TestMultiplayerClient.cs      | 60 ++++++++++---------
 5 files changed, 54 insertions(+), 31 deletions(-)

diff --git a/osu.Game/Online/Multiplayer/IMultiplayerRoomServer.cs b/osu.Game/Online/Multiplayer/IMultiplayerRoomServer.cs
index 65467e6ba9..73fda78d00 100644
--- a/osu.Game/Online/Multiplayer/IMultiplayerRoomServer.cs
+++ b/osu.Game/Online/Multiplayer/IMultiplayerRoomServer.cs
@@ -83,6 +83,12 @@ namespace osu.Game.Online.Multiplayer
         /// <param name="item">The item to add.</param>
         Task AddPlaylistItem(MultiplayerPlaylistItem item);
 
+        /// <summary>
+        /// Edits an existing playlist item with new values.
+        /// </summary>
+        /// <param name="item">The item to edit, containing new properties. Must have an ID.</param>
+        Task EditPlaylistItem(MultiplayerPlaylistItem item);
+
         /// <summary>
         /// Removes an item from the playlist.
         /// </summary>
diff --git a/osu.Game/Online/Multiplayer/MultiplayerClient.cs b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
index 34dc7ea5ea..55b4def908 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
@@ -335,6 +335,8 @@ namespace osu.Game.Online.Multiplayer
 
         public abstract Task AddPlaylistItem(MultiplayerPlaylistItem item);
 
+        public abstract Task EditPlaylistItem(MultiplayerPlaylistItem item);
+
         public abstract Task RemovePlaylistItem(long playlistItemId);
 
         Task IMultiplayerClient.RoomStateChanged(MultiplayerRoomState state)
diff --git a/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs b/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs
index 7314603603..d268d2bf69 100644
--- a/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs
@@ -162,6 +162,14 @@ namespace osu.Game.Online.Multiplayer
             return connection.InvokeAsync(nameof(IMultiplayerServer.AddPlaylistItem), item);
         }
 
+        public override Task EditPlaylistItem(MultiplayerPlaylistItem item)
+        {
+            if (!IsConnected.Value)
+                return Task.CompletedTask;
+
+            return connection.InvokeAsync(nameof(IMultiplayerServer.EditPlaylistItem), item);
+        }
+
         public override Task RemovePlaylistItem(long playlistItemId)
         {
             if (!IsConnected.Value)
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs
index 80a0289ba9..8d3686dd6d 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs
@@ -4,6 +4,7 @@
 using System;
 using System.Diagnostics;
 using System.Linq;
+using System.Threading.Tasks;
 using Microsoft.AspNetCore.SignalR;
 using osu.Framework.Allocation;
 using osu.Framework.Logging;
@@ -64,7 +65,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
             {
                 loadingLayer.Show();
 
-                client.AddPlaylistItem(new MultiplayerPlaylistItem
+                var multiplayerItem = new MultiplayerPlaylistItem
                 {
                     ID = itemToEdit?.ID ?? 0,
                     BeatmapID = item.BeatmapID,
@@ -72,7 +73,11 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
                     RulesetID = item.RulesetID,
                     RequiredMods = item.RequiredMods.Select(m => new APIMod(m)).ToArray(),
                     AllowedMods = item.AllowedMods.Select(m => new APIMod(m)).ToArray()
-                }).ContinueWith(t =>
+                };
+
+                Task task = itemToEdit != null ? client.EditPlaylistItem(multiplayerItem) : client.AddPlaylistItem(multiplayerItem);
+
+                task.ContinueWith(t =>
                 {
                     Schedule(() =>
                     {
diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
index 1516d0e473..d22f0415e6 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
@@ -309,49 +309,51 @@ namespace osu.Game.Tests.Visual.Multiplayer
             Debug.Assert(APIRoom != null);
             Debug.Assert(currentItem != null);
 
-            bool isNewAddition = item.ID == 0;
-
             if (Room.Settings.QueueMode == QueueMode.HostOnly && Room.Host?.UserID != LocalUser?.UserID)
                 throw new InvalidOperationException("Local user is not the room host.");
 
             item.OwnerID = userId;
 
-            if (isNewAddition)
-            {
-                await addItem(item).ConfigureAwait(false);
-                await updateCurrentItem(Room).ConfigureAwait(false);
-            }
-            else
-            {
-                var existingItem = serverSidePlaylist.SingleOrDefault(i => i.ID == item.ID);
-
-                if (existingItem == null)
-                    throw new InvalidOperationException("Attempted to change an item that doesn't exist.");
-
-                if (existingItem.OwnerID != userId && Room.Host?.UserID != LocalUser?.UserID)
-                    throw new InvalidOperationException("Attempted to change an item which is not owned by the user.");
-
-                if (existingItem.Expired)
-                    throw new InvalidOperationException("Attempted to change an item which has already been played.");
-
-                // Ensure the playlist order doesn't change.
-                item.PlaylistOrder = existingItem.PlaylistOrder;
-
-                serverSidePlaylist[serverSidePlaylist.IndexOf(existingItem)] = item;
-                await ((IMultiplayerClient)this).PlaylistItemChanged(item).ConfigureAwait(false);
-            }
+            await addItem(item).ConfigureAwait(false);
+            await updateCurrentItem(Room).ConfigureAwait(false);
         }
 
         public override Task AddPlaylistItem(MultiplayerPlaylistItem item) => AddUserPlaylistItem(api.LocalUser.Value.OnlineID, item);
 
+        public async Task EditUserPlaylistItem(int userId, MultiplayerPlaylistItem item)
+        {
+            Debug.Assert(Room != null);
+            Debug.Assert(APIRoom != null);
+            Debug.Assert(currentItem != null);
+
+            item.OwnerID = userId;
+
+            var existingItem = serverSidePlaylist.SingleOrDefault(i => i.ID == item.ID);
+
+            if (existingItem == null)
+                throw new InvalidOperationException("Attempted to change an item that doesn't exist.");
+
+            if (existingItem.OwnerID != userId && Room.Host?.UserID != LocalUser?.UserID)
+                throw new InvalidOperationException("Attempted to change an item which is not owned by the user.");
+
+            if (existingItem.Expired)
+                throw new InvalidOperationException("Attempted to change an item which has already been played.");
+
+            // Ensure the playlist order doesn't change.
+            item.PlaylistOrder = existingItem.PlaylistOrder;
+
+            serverSidePlaylist[serverSidePlaylist.IndexOf(existingItem)] = item;
+
+            await ((IMultiplayerClient)this).PlaylistItemChanged(item).ConfigureAwait(false);
+        }
+
+        public override Task EditPlaylistItem(MultiplayerPlaylistItem item) => EditUserPlaylistItem(api.LocalUser.Value.OnlineID, item);
+
         public async Task RemoveUserPlaylistItem(int userId, long playlistItemId)
         {
             Debug.Assert(Room != null);
             Debug.Assert(APIRoom != null);
 
-            if (Room.Settings.QueueMode == QueueMode.HostOnly)
-                throw new InvalidOperationException("Items cannot be removed in host-only mode.");
-
             var item = serverSidePlaylist.Find(i => i.ID == playlistItemId);
 
             if (item == null)

From 261847bbec333933dd4f848976f78ba3b58fdd35 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 10 Dec 2021 15:29:31 +0900
Subject: [PATCH 1609/5547] Avoid touching `ScoreInfo.User` directly

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

diff --git a/osu.Game.Tests/Visual/Ranking/TestSceneScorePanelList.cs b/osu.Game.Tests/Visual/Ranking/TestSceneScorePanelList.cs
index b7b7407428..2f9652d354 100644
--- a/osu.Game.Tests/Visual/Ranking/TestSceneScorePanelList.cs
+++ b/osu.Game.Tests/Visual/Ranking/TestSceneScorePanelList.cs
@@ -159,8 +159,8 @@ namespace osu.Game.Tests.Visual.Ranking
             var firstScore = new TestScoreInfo(new OsuRuleset().RulesetInfo);
             var secondScore = new TestScoreInfo(new OsuRuleset().RulesetInfo);
 
-            firstScore.User.Username = "A";
-            secondScore.User.Username = "B";
+            firstScore.UserString = "A";
+            secondScore.UserString = "B";
 
             createListStep(() => new ScorePanelList());
 

From bf1418bafc6a3d61ad03ccaa6c00f4f9e125b4d9 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 10 Dec 2021 15:28:41 +0900
Subject: [PATCH 1610/5547] Use `OnlineID` instead of legacy IDs for equality
 and lookups

---
 osu.Game.Tests/Scores/IO/ImportScoreTest.cs              | 2 +-
 .../Visual/Playlists/TestScenePlaylistsResultsScreen.cs  | 9 +++++----
 .../Visual/UserInterface/TestSceneDeleteLocalScore.cs    | 4 ++--
 osu.Game/Online/Leaderboards/LeaderboardScore.cs         | 2 +-
 osu.Game/OsuGame.cs                                      | 4 ++--
 osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.cs   | 2 +-
 osu.Game/Scoring/Legacy/LegacyScoreDecoder.cs            | 2 +-
 osu.Game/Scoring/ScoreInfo.cs                            | 4 ++--
 osu.Game/Scoring/ScoreManager.cs                         | 2 +-
 osu.Game/Scoring/ScoreModelManager.cs                    | 2 +-
 .../OnlinePlay/Playlists/PlaylistsResultsScreen.cs       | 4 ++--
 osu.Game/Screens/Play/SpectatorPlayer.cs                 | 2 +-
 osu.Game/Screens/Ranking/ScorePanelList.cs               | 2 +-
 osu.Game/Screens/Ranking/SoloResultsScreen.cs            | 2 +-
 14 files changed, 22 insertions(+), 21 deletions(-)

diff --git a/osu.Game.Tests/Scores/IO/ImportScoreTest.cs b/osu.Game.Tests/Scores/IO/ImportScoreTest.cs
index 0dee0f89ea..4a01117031 100644
--- a/osu.Game.Tests/Scores/IO/ImportScoreTest.cs
+++ b/osu.Game.Tests/Scores/IO/ImportScoreTest.cs
@@ -52,7 +52,7 @@ namespace osu.Game.Tests.Scores.IO
                     Assert.AreEqual(toImport.Combo, imported.Combo);
                     Assert.AreEqual(toImport.User.Username, imported.User.Username);
                     Assert.AreEqual(toImport.Date, imported.Date);
-                    Assert.AreEqual(toImport.OnlineScoreID, imported.OnlineScoreID);
+                    Assert.AreEqual(toImport.OnlineID, imported.OnlineID);
                 }
                 finally
                 {
diff --git a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsResultsScreen.cs b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsResultsScreen.cs
index 4284bc6358..38dd507e00 100644
--- a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsResultsScreen.cs
+++ b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsResultsScreen.cs
@@ -30,6 +30,7 @@ namespace osu.Game.Tests.Visual.Playlists
         private const int scores_per_result = 10;
 
         private TestResultsScreen resultsScreen;
+
         private int currentScoreId;
         private bool requestComplete;
         private int totalCount;
@@ -37,7 +38,7 @@ namespace osu.Game.Tests.Visual.Playlists
         [SetUp]
         public void Setup() => Schedule(() =>
         {
-            currentScoreId = 0;
+            currentScoreId = 1;
             requestComplete = false;
             totalCount = 0;
             bindHandler();
@@ -56,7 +57,7 @@ namespace osu.Game.Tests.Visual.Playlists
 
             createResults(() => userScore);
 
-            AddAssert("user score selected", () => this.ChildrenOfType<ScorePanel>().Single(p => p.Score.OnlineScoreID == userScore.OnlineScoreID).State == PanelState.Expanded);
+            AddAssert("user score selected", () => this.ChildrenOfType<ScorePanel>().Single(p => p.Score.OnlineID == userScore.OnlineScoreID).State == PanelState.Expanded);
         }
 
         [Test]
@@ -81,7 +82,7 @@ namespace osu.Game.Tests.Visual.Playlists
             createResults(() => userScore);
 
             AddAssert("more than 1 panel displayed", () => this.ChildrenOfType<ScorePanel>().Count() > 1);
-            AddAssert("user score selected", () => this.ChildrenOfType<ScorePanel>().Single(p => p.Score.OnlineScoreID == userScore.OnlineScoreID).State == PanelState.Expanded);
+            AddAssert("user score selected", () => this.ChildrenOfType<ScorePanel>().Single(p => p.Score.OnlineID == userScore.OnlineScoreID).State == PanelState.Expanded);
         }
 
         [Test]
@@ -230,7 +231,7 @@ namespace osu.Game.Tests.Visual.Playlists
         {
             var multiplayerUserScore = new MultiplayerScore
             {
-                ID = (int)(userScore.OnlineScoreID ?? currentScoreId++),
+                ID = (int)(userScore.OnlineID > 0 ? userScore.OnlineID : currentScoreId++),
                 Accuracy = userScore.Accuracy,
                 EndedAt = userScore.Date,
                 Passed = userScore.Passed,
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
index 9f0f4a6b8b..d22eff9e75 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
@@ -163,7 +163,7 @@ namespace osu.Game.Tests.Visual.UserInterface
             });
 
             AddUntilStep("wait for fetch", () => leaderboard.Scores != null);
-            AddUntilStep("score removed from leaderboard", () => leaderboard.Scores.All(s => s.OnlineScoreID != scoreBeingDeleted.OnlineScoreID));
+            AddUntilStep("score removed from leaderboard", () => leaderboard.Scores.All(s => s.OnlineID != scoreBeingDeleted.OnlineID));
         }
 
         [Test]
@@ -171,7 +171,7 @@ namespace osu.Game.Tests.Visual.UserInterface
         {
             AddStep("delete top score", () => scoreManager.Delete(importedScores[0]));
             AddUntilStep("wait for fetch", () => leaderboard.Scores != null);
-            AddUntilStep("score removed from leaderboard", () => leaderboard.Scores.All(s => s.OnlineScoreID != importedScores[0].OnlineScoreID));
+            AddUntilStep("score removed from leaderboard", () => leaderboard.Scores.All(s => s.OnlineID != importedScores[0].OnlineID));
         }
     }
 }
diff --git a/osu.Game/Online/Leaderboards/LeaderboardScore.cs b/osu.Game/Online/Leaderboards/LeaderboardScore.cs
index 644c2e2a99..14eec8b388 100644
--- a/osu.Game/Online/Leaderboards/LeaderboardScore.cs
+++ b/osu.Game/Online/Leaderboards/LeaderboardScore.cs
@@ -111,7 +111,7 @@ namespace osu.Game.Online.Leaderboards
                                 background = new Box
                                 {
                                     RelativeSizeAxes = Axes.Both,
-                                    Colour = user.Id == api.LocalUser.Value.Id && allowHighlight ? colour.Green : Color4.Black,
+                                    Colour = user.OnlineID == api.LocalUser.Value.Id && allowHighlight ? colour.Green : Color4.Black,
                                     Alpha = background_alpha,
                                 },
                             },
diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index 047c3b4225..565ee7e71d 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -487,8 +487,8 @@ namespace osu.Game
             // to ensure all the required data for presenting a replay are present.
             ScoreInfo databasedScoreInfo = null;
 
-            if (score.OnlineScoreID != null)
-                databasedScoreInfo = ScoreManager.Query(s => s.OnlineScoreID == score.OnlineScoreID);
+            if (score.OnlineID > 0)
+                databasedScoreInfo = ScoreManager.Query(s => s.OnlineID == score.OnlineID);
 
             databasedScoreInfo ??= ScoreManager.Query(s => s.Hash == score.Hash);
 
diff --git a/osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.cs b/osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.cs
index 2fcdc9402d..695661d5c9 100644
--- a/osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.cs
+++ b/osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.cs
@@ -94,7 +94,7 @@ namespace osu.Game.Overlays.BeatmapSet.Scores
 
                                 topScoresContainer.Add(new DrawableTopScore(topScore));
 
-                                if (userScoreInfo != null && userScoreInfo.OnlineScoreID != topScore.OnlineScoreID)
+                                if (userScoreInfo != null && userScoreInfo.OnlineID != topScore.OnlineID)
                                     topScoresContainer.Add(new DrawableTopScore(userScoreInfo, userScore.Position));
                             }), TaskContinuationOptions.OnlyOnRanToCompletion);
             });
diff --git a/osu.Game/Scoring/Legacy/LegacyScoreDecoder.cs b/osu.Game/Scoring/Legacy/LegacyScoreDecoder.cs
index f943422389..b46c1a27ed 100644
--- a/osu.Game/Scoring/Legacy/LegacyScoreDecoder.cs
+++ b/osu.Game/Scoring/Legacy/LegacyScoreDecoder.cs
@@ -84,7 +84,7 @@ namespace osu.Game.Scoring.Legacy
                 else if (version >= 20121008)
                     scoreInfo.OnlineScoreID = sr.ReadInt32();
 
-                if (scoreInfo.OnlineScoreID <= 0)
+                if (scoreInfo.OnlineID <= 0)
                     scoreInfo.OnlineScoreID = null;
 
                 if (compressedReplay?.Length > 0)
diff --git a/osu.Game/Scoring/ScoreInfo.cs b/osu.Game/Scoring/ScoreInfo.cs
index 5dc88d7644..ba20ec030a 100644
--- a/osu.Game/Scoring/ScoreInfo.cs
+++ b/osu.Game/Scoring/ScoreInfo.cs
@@ -237,8 +237,8 @@ namespace osu.Game.Scoring
             if (ID != 0 && other.ID != 0)
                 return ID == other.ID;
 
-            if (OnlineScoreID.HasValue && other.OnlineScoreID.HasValue)
-                return OnlineScoreID == other.OnlineScoreID;
+            if (OnlineID > 0)
+                return OnlineID == other.OnlineID;
 
             if (!string.IsNullOrEmpty(Hash) && !string.IsNullOrEmpty(other.Hash))
                 return Hash == other.Hash;
diff --git a/osu.Game/Scoring/ScoreManager.cs b/osu.Game/Scoring/ScoreManager.cs
index e9cd44ae83..6de6b57066 100644
--- a/osu.Game/Scoring/ScoreManager.cs
+++ b/osu.Game/Scoring/ScoreManager.cs
@@ -71,7 +71,7 @@ namespace osu.Game.Scoring
 
             return scores.Select((score, index) => (score, totalScore: totalScores[index]))
                          .OrderByDescending(g => g.totalScore)
-                         .ThenBy(g => g.score.OnlineScoreID)
+                         .ThenBy(g => g.score.OnlineID)
                          .Select(g => g.score)
                          .ToArray();
         }
diff --git a/osu.Game/Scoring/ScoreModelManager.cs b/osu.Game/Scoring/ScoreModelManager.cs
index 2cbd3aded7..44f0fe4fdf 100644
--- a/osu.Game/Scoring/ScoreModelManager.cs
+++ b/osu.Game/Scoring/ScoreModelManager.cs
@@ -66,6 +66,6 @@ namespace osu.Game.Scoring
 
         protected override bool CheckLocalAvailability(ScoreInfo model, IQueryable<ScoreInfo> items)
             => base.CheckLocalAvailability(model, items)
-               || (model.OnlineScoreID != null && items.Any(i => i.OnlineScoreID == model.OnlineScoreID));
+               || (model.OnlineID > 0 && items.Any(i => i.OnlineID == model.OnlineID));
     }
 }
diff --git a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsResultsScreen.cs b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsResultsScreen.cs
index aed3635cbc..67727ef784 100644
--- a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsResultsScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsResultsScreen.cs
@@ -186,12 +186,12 @@ namespace osu.Game.Screens.OnlinePlay.Playlists
                     Schedule(() =>
                     {
                         // Prefer selecting the local user's score, or otherwise default to the first visible score.
-                        SelectedScore.Value = scoreInfos.FirstOrDefault(s => s.User.Id == api.LocalUser.Value.Id) ?? scoreInfos.FirstOrDefault();
+                        SelectedScore.Value = scoreInfos.FirstOrDefault(s => s.User.OnlineID == api.LocalUser.Value.Id) ?? scoreInfos.FirstOrDefault();
                     });
                 }
 
                 // Invoke callback to add the scores. Exclude the user's current score which was added previously.
-                callback.Invoke(scoreInfos.Where(s => s.OnlineScoreID != Score?.OnlineScoreID));
+                callback.Invoke(scoreInfos.Where(s => s.OnlineID != Score?.OnlineID));
 
                 hideLoadingSpinners(pivot);
             }));
diff --git a/osu.Game/Screens/Play/SpectatorPlayer.cs b/osu.Game/Screens/Play/SpectatorPlayer.cs
index f6a89e7fa9..d42643c416 100644
--- a/osu.Game/Screens/Play/SpectatorPlayer.cs
+++ b/osu.Game/Screens/Play/SpectatorPlayer.cs
@@ -54,7 +54,7 @@ namespace osu.Game.Screens.Play
 
         private void userSentFrames(int userId, FrameDataBundle bundle)
         {
-            if (userId != score.ScoreInfo.User.Id)
+            if (userId != score.ScoreInfo.User.OnlineID)
                 return;
 
             if (!LoadedBeatmapSuccessfully)
diff --git a/osu.Game/Screens/Ranking/ScorePanelList.cs b/osu.Game/Screens/Ranking/ScorePanelList.cs
index 22be91b974..f3de48dcf0 100644
--- a/osu.Game/Screens/Ranking/ScorePanelList.cs
+++ b/osu.Game/Screens/Ranking/ScorePanelList.cs
@@ -341,7 +341,7 @@ namespace osu.Game.Screens.Ranking
 
             private IEnumerable<ScorePanelTrackingContainer> applySorting(IEnumerable<Drawable> drawables) => drawables.OfType<ScorePanelTrackingContainer>()
                                                                                                                        .OrderByDescending(GetLayoutPosition)
-                                                                                                                       .ThenBy(s => s.Panel.Score.OnlineScoreID);
+                                                                                                                       .ThenBy(s => s.Panel.Score.OnlineID);
         }
 
         private class Scroll : OsuScrollContainer
diff --git a/osu.Game/Screens/Ranking/SoloResultsScreen.cs b/osu.Game/Screens/Ranking/SoloResultsScreen.cs
index 929bda6508..afebc728b4 100644
--- a/osu.Game/Screens/Ranking/SoloResultsScreen.cs
+++ b/osu.Game/Screens/Ranking/SoloResultsScreen.cs
@@ -31,7 +31,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.OnlineID != Score.OnlineScoreID).Select(s => s.CreateScoreInfo(rulesets, Beatmap.Value.BeatmapInfo)));
+            getScoreRequest.Success += r => scoresCallback?.Invoke(r.Scores.Where(s => s.OnlineID != Score.OnlineID).Select(s => s.CreateScoreInfo(rulesets, Beatmap.Value.BeatmapInfo)));
             return getScoreRequest;
         }
 

From 7ac63485ef03d40ae987ae27eb7d25832ed3d97d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 10 Dec 2021 15:31:35 +0900
Subject: [PATCH 1611/5547] Add setter for `ScoreInfo.OnlineID`

---
 osu.Game/Scoring/ScoreInfo.cs | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Scoring/ScoreInfo.cs b/osu.Game/Scoring/ScoreInfo.cs
index ba20ec030a..d6b7b2712b 100644
--- a/osu.Game/Scoring/ScoreInfo.cs
+++ b/osu.Game/Scoring/ScoreInfo.cs
@@ -248,7 +248,12 @@ namespace osu.Game.Scoring
 
         #region Implementation of IHasOnlineID
 
-        public long OnlineID => OnlineScoreID ?? -1;
+        [NotMapped]
+        public long OnlineID
+        {
+            get => OnlineScoreID ?? -1;
+            set => OnlineScoreID = value;
+        }
 
         #endregion
 

From dbb08f7d463aca7cb0d6e8206766f4aaf53821c2 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 10 Dec 2021 15:37:12 +0900
Subject: [PATCH 1612/5547] Use `OnlineID` for set operations

---
 osu.Game.Tests/Beatmaps/IO/ImportBeatmapTest.cs        |  2 +-
 osu.Game.Tests/Database/BeatmapImporterTests.cs        |  2 +-
 osu.Game.Tests/Scores/IO/ImportScoreTest.cs            |  6 +++---
 .../Visual/Multiplayer/TestSceneMultiplayerResults.cs  |  2 +-
 .../Multiplayer/TestSceneMultiplayerTeamResults.cs     |  2 +-
 .../Visual/Navigation/TestScenePresentScore.cs         |  2 +-
 .../Playlists/TestScenePlaylistsResultsScreen.cs       | 10 +++++-----
 .../Visual/UserInterface/TestSceneDeleteLocalScore.cs  |  2 +-
 osu.Game/Online/API/Requests/Responses/APIScoreInfo.cs |  2 +-
 osu.Game/Online/Rooms/MultiplayerScore.cs              |  2 +-
 osu.Game/Online/ScoreDownloadTracker.cs                |  2 +-
 osu.Game/Scoring/Legacy/LegacyScoreDecoder.cs          |  7 ++-----
 osu.Game/Screens/Play/Player.cs                        |  6 +++---
 osu.Game/Screens/Play/SubmittingPlayer.cs              |  2 +-
 14 files changed, 23 insertions(+), 26 deletions(-)

diff --git a/osu.Game.Tests/Beatmaps/IO/ImportBeatmapTest.cs b/osu.Game.Tests/Beatmaps/IO/ImportBeatmapTest.cs
index 6e2b9d20a8..6d0d5702e9 100644
--- a/osu.Game.Tests/Beatmaps/IO/ImportBeatmapTest.cs
+++ b/osu.Game.Tests/Beatmaps/IO/ImportBeatmapTest.cs
@@ -1022,7 +1022,7 @@ namespace osu.Game.Tests.Beatmaps.IO
         {
             return ImportScoreTest.LoadScoreIntoOsu(osu, new ScoreInfo
             {
-                OnlineScoreID = 2,
+                OnlineID = 2,
                 BeatmapInfo = beatmapInfo,
                 BeatmapInfoID = beatmapInfo.ID
             }, new ImportScoreTest.TestArchiveReader());
diff --git a/osu.Game.Tests/Database/BeatmapImporterTests.cs b/osu.Game.Tests/Database/BeatmapImporterTests.cs
index a6edd6cb5f..e47e24021f 100644
--- a/osu.Game.Tests/Database/BeatmapImporterTests.cs
+++ b/osu.Game.Tests/Database/BeatmapImporterTests.cs
@@ -809,7 +809,7 @@ namespace osu.Game.Tests.Database
             // TODO: reimplement when we have score support in realm.
             // return ImportScoreTest.LoadScoreIntoOsu(osu, new ScoreInfo
             // {
-            //     OnlineScoreID = 2,
+            //     OnlineID = 2,
             //     Beatmap = beatmap,
             //     BeatmapInfoID = beatmap.ID
             // }, new ImportScoreTest.TestArchiveReader());
diff --git a/osu.Game.Tests/Scores/IO/ImportScoreTest.cs b/osu.Game.Tests/Scores/IO/ImportScoreTest.cs
index 4a01117031..bbc92b7817 100644
--- a/osu.Game.Tests/Scores/IO/ImportScoreTest.cs
+++ b/osu.Game.Tests/Scores/IO/ImportScoreTest.cs
@@ -40,7 +40,7 @@ namespace osu.Game.Tests.Scores.IO
                         Combo = 250,
                         User = new APIUser { Username = "Test user" },
                         Date = DateTimeOffset.Now,
-                        OnlineScoreID = 12345,
+                        OnlineID = 12345,
                     };
 
                     var imported = await LoadScoreIntoOsu(osu, toImport);
@@ -163,12 +163,12 @@ namespace osu.Game.Tests.Scores.IO
                 {
                     var osu = LoadOsuIntoHost(host, true);
 
-                    await LoadScoreIntoOsu(osu, new ScoreInfo { OnlineScoreID = 2 }, new TestArchiveReader());
+                    await LoadScoreIntoOsu(osu, new ScoreInfo { OnlineID = 2 }, new TestArchiveReader());
 
                     var scoreManager = osu.Dependencies.Get<ScoreManager>();
 
                     // Note: A new score reference is used here since the import process mutates the original object to set an ID
-                    Assert.That(scoreManager.IsAvailableLocally(new ScoreInfo { OnlineScoreID = 2 }));
+                    Assert.That(scoreManager.IsAvailableLocally(new ScoreInfo { OnlineID = 2 }));
                 }
                 finally
                 {
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerResults.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerResults.cs
index 80f807e7d3..744a2d187d 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerResults.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerResults.cs
@@ -33,7 +33,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     BeatmapInfo = beatmapInfo,
                     User = new APIUser { Username = "Test user" },
                     Date = DateTimeOffset.Now,
-                    OnlineScoreID = 12345,
+                    OnlineID = 12345,
                     Ruleset = rulesetInfo,
                 };
 
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerTeamResults.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerTeamResults.cs
index da1fa226e1..99b6edc3b6 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerTeamResults.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerTeamResults.cs
@@ -37,7 +37,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     BeatmapInfo = beatmapInfo,
                     User = new APIUser { Username = "Test user" },
                     Date = DateTimeOffset.Now,
-                    OnlineScoreID = 12345,
+                    OnlineID = 12345,
                     Ruleset = rulesetInfo,
                 };
 
diff --git a/osu.Game.Tests/Visual/Navigation/TestScenePresentScore.cs b/osu.Game.Tests/Visual/Navigation/TestScenePresentScore.cs
index c9dec25ad3..1653247570 100644
--- a/osu.Game.Tests/Visual/Navigation/TestScenePresentScore.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestScenePresentScore.cs
@@ -128,7 +128,7 @@ namespace osu.Game.Tests.Visual.Navigation
                 imported = Game.ScoreManager.Import(new ScoreInfo
                 {
                     Hash = Guid.NewGuid().ToString(),
-                    OnlineScoreID = i,
+                    OnlineID = i,
                     BeatmapInfo = beatmap.Beatmaps.First(),
                     Ruleset = ruleset ?? new OsuRuleset().RulesetInfo
                 }).Result.Value;
diff --git a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsResultsScreen.cs b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsResultsScreen.cs
index 38dd507e00..4ac3b7c733 100644
--- a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsResultsScreen.cs
+++ b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsResultsScreen.cs
@@ -51,13 +51,13 @@ namespace osu.Game.Tests.Visual.Playlists
 
             AddStep("bind user score info handler", () =>
             {
-                userScore = new TestScoreInfo(new OsuRuleset().RulesetInfo) { OnlineScoreID = currentScoreId++ };
+                userScore = new TestScoreInfo(new OsuRuleset().RulesetInfo) { OnlineID = currentScoreId++ };
                 bindHandler(userScore: userScore);
             });
 
             createResults(() => userScore);
 
-            AddAssert("user score selected", () => this.ChildrenOfType<ScorePanel>().Single(p => p.Score.OnlineID == userScore.OnlineScoreID).State == PanelState.Expanded);
+            AddAssert("user score selected", () => this.ChildrenOfType<ScorePanel>().Single(p => p.Score.OnlineID == userScore.OnlineID).State == PanelState.Expanded);
         }
 
         [Test]
@@ -75,14 +75,14 @@ namespace osu.Game.Tests.Visual.Playlists
 
             AddStep("bind user score info handler", () =>
             {
-                userScore = new TestScoreInfo(new OsuRuleset().RulesetInfo) { OnlineScoreID = currentScoreId++ };
+                userScore = new TestScoreInfo(new OsuRuleset().RulesetInfo) { OnlineID = currentScoreId++ };
                 bindHandler(true, userScore);
             });
 
             createResults(() => userScore);
 
             AddAssert("more than 1 panel displayed", () => this.ChildrenOfType<ScorePanel>().Count() > 1);
-            AddAssert("user score selected", () => this.ChildrenOfType<ScorePanel>().Single(p => p.Score.OnlineID == userScore.OnlineScoreID).State == PanelState.Expanded);
+            AddAssert("user score selected", () => this.ChildrenOfType<ScorePanel>().Single(p => p.Score.OnlineID == userScore.OnlineID).State == PanelState.Expanded);
         }
 
         [Test]
@@ -124,7 +124,7 @@ namespace osu.Game.Tests.Visual.Playlists
 
             AddStep("bind user score info handler", () =>
             {
-                userScore = new TestScoreInfo(new OsuRuleset().RulesetInfo) { OnlineScoreID = currentScoreId++ };
+                userScore = new TestScoreInfo(new OsuRuleset().RulesetInfo) { OnlineID = currentScoreId++ };
                 bindHandler(userScore: userScore);
             });
 
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
index d22eff9e75..2363bbbfcf 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
@@ -91,7 +91,7 @@ namespace osu.Game.Tests.Visual.UserInterface
             {
                 var score = new ScoreInfo
                 {
-                    OnlineScoreID = i,
+                    OnlineID = i,
                     BeatmapInfo = beatmapInfo,
                     BeatmapInfoID = beatmapInfo.ID,
                     Accuracy = RNG.NextDouble(),
diff --git a/osu.Game/Online/API/Requests/Responses/APIScoreInfo.cs b/osu.Game/Online/API/Requests/Responses/APIScoreInfo.cs
index 467d5a9f23..057e98c421 100644
--- a/osu.Game/Online/API/Requests/Responses/APIScoreInfo.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIScoreInfo.cs
@@ -101,7 +101,7 @@ namespace osu.Game.Online.API.Requests.Responses
                 BeatmapInfo = beatmap,
                 User = User,
                 Accuracy = Accuracy,
-                OnlineScoreID = OnlineID,
+                OnlineID = OnlineID,
                 Date = Date,
                 PP = PP,
                 RulesetID = RulesetID,
diff --git a/osu.Game/Online/Rooms/MultiplayerScore.cs b/osu.Game/Online/Rooms/MultiplayerScore.cs
index 7bc3377ad9..05c9a1b6cf 100644
--- a/osu.Game/Online/Rooms/MultiplayerScore.cs
+++ b/osu.Game/Online/Rooms/MultiplayerScore.cs
@@ -69,7 +69,7 @@ namespace osu.Game.Online.Rooms
 
             var scoreInfo = new ScoreInfo
             {
-                OnlineScoreID = ID,
+                OnlineID = ID,
                 TotalScore = TotalScore,
                 MaxCombo = MaxCombo,
                 BeatmapInfo = beatmap,
diff --git a/osu.Game/Online/ScoreDownloadTracker.cs b/osu.Game/Online/ScoreDownloadTracker.cs
index e09cc7c9cd..6320b7ff97 100644
--- a/osu.Game/Online/ScoreDownloadTracker.cs
+++ b/osu.Game/Online/ScoreDownloadTracker.cs
@@ -35,7 +35,7 @@ namespace osu.Game.Online
             var scoreInfo = new ScoreInfo
             {
                 ID = TrackedItem.ID,
-                OnlineScoreID = TrackedItem.OnlineScoreID
+                OnlineID = TrackedItem.OnlineID
             };
 
             if (Manager.IsAvailableLocally(scoreInfo))
diff --git a/osu.Game/Scoring/Legacy/LegacyScoreDecoder.cs b/osu.Game/Scoring/Legacy/LegacyScoreDecoder.cs
index b46c1a27ed..fefee370b9 100644
--- a/osu.Game/Scoring/Legacy/LegacyScoreDecoder.cs
+++ b/osu.Game/Scoring/Legacy/LegacyScoreDecoder.cs
@@ -80,12 +80,9 @@ namespace osu.Game.Scoring.Legacy
                 byte[] compressedReplay = sr.ReadByteArray();
 
                 if (version >= 20140721)
-                    scoreInfo.OnlineScoreID = sr.ReadInt64();
+                    scoreInfo.OnlineID = sr.ReadInt64();
                 else if (version >= 20121008)
-                    scoreInfo.OnlineScoreID = sr.ReadInt32();
-
-                if (scoreInfo.OnlineID <= 0)
-                    scoreInfo.OnlineScoreID = null;
+                    scoreInfo.OnlineID = sr.ReadInt32();
 
                 if (compressedReplay?.Length > 0)
                 {
diff --git a/osu.Game/Screens/Play/Player.cs b/osu.Game/Screens/Play/Player.cs
index a0e9428cff..521cf7d1e9 100644
--- a/osu.Game/Screens/Play/Player.cs
+++ b/osu.Game/Screens/Play/Player.cs
@@ -1031,13 +1031,13 @@ namespace osu.Game.Screens.Play
             //
             // Until we better define the server-side logic behind this, let's not store the online ID to avoid potential unique constraint
             // conflicts across various systems (ie. solo and multiplayer).
-            long? onlineScoreId = score.ScoreInfo.OnlineScoreID;
-            score.ScoreInfo.OnlineScoreID = null;
+            long onlineScoreId = score.ScoreInfo.OnlineID;
+            score.ScoreInfo.OnlineID = -1;
 
             await scoreManager.Import(score.ScoreInfo, replayReader).ConfigureAwait(false);
 
             // ... And restore the online ID for other processes to handle correctly (e.g. de-duplication for the results screen).
-            score.ScoreInfo.OnlineScoreID = onlineScoreId;
+            score.ScoreInfo.OnlineID = onlineScoreId;
         }
 
         /// <summary>
diff --git a/osu.Game/Screens/Play/SubmittingPlayer.cs b/osu.Game/Screens/Play/SubmittingPlayer.cs
index c07cfa9c4d..c613167908 100644
--- a/osu.Game/Screens/Play/SubmittingPlayer.cs
+++ b/osu.Game/Screens/Play/SubmittingPlayer.cs
@@ -156,7 +156,7 @@ namespace osu.Game.Screens.Play
 
             request.Success += s =>
             {
-                score.ScoreInfo.OnlineScoreID = s.ID;
+                score.ScoreInfo.OnlineID = s.ID;
                 score.ScoreInfo.Position = s.Position;
 
                 scoreSubmissionSource.SetResult(true);

From bff02bedbfc28a94cab1f87a8e423c2fd653c29f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 10 Dec 2021 16:01:41 +0900
Subject: [PATCH 1613/5547] Rename `APIScoreInfo` to `APIScore`

---
 .../Gameplay/TestSceneReplayDownloadButton.cs |  2 +-
 .../Visual/Online/TestSceneScoresContainer.cs | 20 +++++++++----------
 .../Online/TestSceneUserProfileScores.cs      |  8 ++++----
 .../API/Requests/GetUserScoresRequest.cs      |  2 +-
 .../{APIScoreInfo.cs => APIScore.cs}          |  2 +-
 .../Responses/APIScoreWithPosition.cs         |  2 +-
 .../Requests/Responses/APIScoresCollection.cs |  2 +-
 osu.Game/Online/Solo/SubmittableScore.cs      |  2 +-
 .../Sections/Ranks/DrawableProfileScore.cs    |  4 ++--
 .../Ranks/DrawableProfileWeightedScore.cs     |  2 +-
 .../Sections/Ranks/PaginatedScoreContainer.cs |  8 ++++----
 11 files changed, 27 insertions(+), 27 deletions(-)
 rename osu.Game/Online/API/Requests/Responses/{APIScoreInfo.cs => APIScore.cs} (99%)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneReplayDownloadButton.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneReplayDownloadButton.cs
index f47fae33ca..42c4f89e9d 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneReplayDownloadButton.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneReplayDownloadButton.cs
@@ -164,7 +164,7 @@ namespace osu.Game.Tests.Visual.Gameplay
 
         private ScoreInfo getScoreInfo(bool replayAvailable)
         {
-            return new APIScoreInfo
+            return new APIScore
             {
                 OnlineID = 2553163309,
                 RulesetID = 0,
diff --git a/osu.Game.Tests/Visual/Online/TestSceneScoresContainer.cs b/osu.Game.Tests/Visual/Online/TestSceneScoresContainer.cs
index 50969aad9b..be2db9a8a0 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneScoresContainer.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneScoresContainer.cs
@@ -47,9 +47,9 @@ namespace osu.Game.Tests.Visual.Online
 
             var allScores = new APIScoresCollection
             {
-                Scores = new List<APIScoreInfo>
+                Scores = new List<APIScore>
                 {
-                    new APIScoreInfo
+                    new APIScore
                     {
                         User = new APIUser
                         {
@@ -74,7 +74,7 @@ namespace osu.Game.Tests.Visual.Online
                         TotalScore = 1234567890,
                         Accuracy = 1,
                     },
-                    new APIScoreInfo
+                    new APIScore
                     {
                         User = new APIUser
                         {
@@ -98,7 +98,7 @@ namespace osu.Game.Tests.Visual.Online
                         TotalScore = 1234789,
                         Accuracy = 0.9997,
                     },
-                    new APIScoreInfo
+                    new APIScore
                     {
                         User = new APIUser
                         {
@@ -121,7 +121,7 @@ namespace osu.Game.Tests.Visual.Online
                         TotalScore = 12345678,
                         Accuracy = 0.9854,
                     },
-                    new APIScoreInfo
+                    new APIScore
                     {
                         User = new APIUser
                         {
@@ -143,7 +143,7 @@ namespace osu.Game.Tests.Visual.Online
                         TotalScore = 1234567,
                         Accuracy = 0.8765,
                     },
-                    new APIScoreInfo
+                    new APIScore
                     {
                         User = new APIUser
                         {
@@ -166,7 +166,7 @@ namespace osu.Game.Tests.Visual.Online
 
             var myBestScore = new APIScoreWithPosition
             {
-                Score = new APIScoreInfo
+                Score = new APIScore
                 {
                     User = new APIUser
                     {
@@ -189,7 +189,7 @@ namespace osu.Game.Tests.Visual.Online
 
             var myBestScoreWithNullPosition = new APIScoreWithPosition
             {
-                Score = new APIScoreInfo
+                Score = new APIScore
                 {
                     User = new APIUser
                     {
@@ -212,9 +212,9 @@ namespace osu.Game.Tests.Visual.Online
 
             var oneScore = new APIScoresCollection
             {
-                Scores = new List<APIScoreInfo>
+                Scores = new List<APIScore>
                 {
-                    new APIScoreInfo
+                    new APIScore
                     {
                         User = new APIUser
                         {
diff --git a/osu.Game.Tests/Visual/Online/TestSceneUserProfileScores.cs b/osu.Game.Tests/Visual/Online/TestSceneUserProfileScores.cs
index 9c2cc13416..7dfdca8276 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneUserProfileScores.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneUserProfileScores.cs
@@ -19,7 +19,7 @@ namespace osu.Game.Tests.Visual.Online
     {
         public TestSceneUserProfileScores()
         {
-            var firstScore = new APIScoreInfo
+            var firstScore = new APIScore
             {
                 PP = 1047.21,
                 Rank = ScoreRank.SH,
@@ -42,7 +42,7 @@ namespace osu.Game.Tests.Visual.Online
                 Accuracy = 0.9813
             };
 
-            var secondScore = new APIScoreInfo
+            var secondScore = new APIScore
             {
                 PP = 134.32,
                 Rank = ScoreRank.A,
@@ -64,7 +64,7 @@ namespace osu.Game.Tests.Visual.Online
                 Accuracy = 0.998546
             };
 
-            var thirdScore = new APIScoreInfo
+            var thirdScore = new APIScore
             {
                 PP = 96.83,
                 Rank = ScoreRank.S,
@@ -81,7 +81,7 @@ namespace osu.Game.Tests.Visual.Online
                 Accuracy = 0.9726
             };
 
-            var noPPScore = new APIScoreInfo
+            var noPPScore = new APIScore
             {
                 Rank = ScoreRank.B,
                 Beatmap = new APIBeatmap
diff --git a/osu.Game/Online/API/Requests/GetUserScoresRequest.cs b/osu.Game/Online/API/Requests/GetUserScoresRequest.cs
index e13ac8e539..653abf7427 100644
--- a/osu.Game/Online/API/Requests/GetUserScoresRequest.cs
+++ b/osu.Game/Online/API/Requests/GetUserScoresRequest.cs
@@ -8,7 +8,7 @@ using osu.Game.Rulesets;
 
 namespace osu.Game.Online.API.Requests
 {
-    public class GetUserScoresRequest : PaginatedAPIRequest<List<APIScoreInfo>>
+    public class GetUserScoresRequest : PaginatedAPIRequest<List<APIScore>>
     {
         private readonly long userId;
         private readonly ScoreType type;
diff --git a/osu.Game/Online/API/Requests/Responses/APIScoreInfo.cs b/osu.Game/Online/API/Requests/Responses/APIScore.cs
similarity index 99%
rename from osu.Game/Online/API/Requests/Responses/APIScoreInfo.cs
rename to osu.Game/Online/API/Requests/Responses/APIScore.cs
index 057e98c421..bd99a05a88 100644
--- a/osu.Game/Online/API/Requests/Responses/APIScoreInfo.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIScore.cs
@@ -16,7 +16,7 @@ using osu.Game.Scoring.Legacy;
 
 namespace osu.Game.Online.API.Requests.Responses
 {
-    public class APIScoreInfo : IScoreInfo
+    public class APIScore : IScoreInfo
     {
         [JsonProperty(@"score")]
         public long TotalScore { get; set; }
diff --git a/osu.Game/Online/API/Requests/Responses/APIScoreWithPosition.cs b/osu.Game/Online/API/Requests/Responses/APIScoreWithPosition.cs
index 48b7134901..d3c9ba0c7e 100644
--- a/osu.Game/Online/API/Requests/Responses/APIScoreWithPosition.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIScoreWithPosition.cs
@@ -14,7 +14,7 @@ namespace osu.Game.Online.API.Requests.Responses
         public int? Position;
 
         [JsonProperty(@"score")]
-        public APIScoreInfo Score;
+        public APIScore Score;
 
         public ScoreInfo CreateScoreInfo(RulesetStore rulesets, BeatmapInfo beatmap = null)
         {
diff --git a/osu.Game/Online/API/Requests/Responses/APIScoresCollection.cs b/osu.Game/Online/API/Requests/Responses/APIScoresCollection.cs
index 5304664bf8..283ebf2411 100644
--- a/osu.Game/Online/API/Requests/Responses/APIScoresCollection.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIScoresCollection.cs
@@ -9,7 +9,7 @@ namespace osu.Game.Online.API.Requests.Responses
     public class APIScoresCollection
     {
         [JsonProperty(@"scores")]
-        public List<APIScoreInfo> Scores;
+        public List<APIScore> Scores;
 
         [JsonProperty(@"userScore")]
         public APIScoreWithPosition UserScore;
diff --git a/osu.Game/Online/Solo/SubmittableScore.cs b/osu.Game/Online/Solo/SubmittableScore.cs
index 373c302844..5ca5ad9619 100644
--- a/osu.Game/Online/Solo/SubmittableScore.cs
+++ b/osu.Game/Online/Solo/SubmittableScore.cs
@@ -16,7 +16,7 @@ namespace osu.Game.Online.Solo
 {
     /// <summary>
     /// A class specifically for sending scores to the API during score submission.
-    /// This is used instead of <see cref="APIScoreInfo"/> due to marginally different serialisation naming requirements.
+    /// This is used instead of <see cref="APIScore"/> due to marginally different serialisation naming requirements.
     /// </summary>
     [Serializable]
     public class SubmittableScore
diff --git a/osu.Game/Overlays/Profile/Sections/Ranks/DrawableProfileScore.cs b/osu.Game/Overlays/Profile/Sections/Ranks/DrawableProfileScore.cs
index fb464e1b41..562be0403e 100644
--- a/osu.Game/Overlays/Profile/Sections/Ranks/DrawableProfileScore.cs
+++ b/osu.Game/Overlays/Profile/Sections/Ranks/DrawableProfileScore.cs
@@ -28,7 +28,7 @@ namespace osu.Game.Overlays.Profile.Sections.Ranks
 
         private const float performance_background_shear = 0.45f;
 
-        protected readonly APIScoreInfo Score;
+        protected readonly APIScore Score;
 
         [Resolved]
         private OsuColour colours { get; set; }
@@ -36,7 +36,7 @@ namespace osu.Game.Overlays.Profile.Sections.Ranks
         [Resolved]
         private OverlayColourProvider colourProvider { get; set; }
 
-        public DrawableProfileScore(APIScoreInfo score)
+        public DrawableProfileScore(APIScore score)
         {
             Score = score;
 
diff --git a/osu.Game/Overlays/Profile/Sections/Ranks/DrawableProfileWeightedScore.cs b/osu.Game/Overlays/Profile/Sections/Ranks/DrawableProfileWeightedScore.cs
index e653be5cfa..78ae0a5634 100644
--- a/osu.Game/Overlays/Profile/Sections/Ranks/DrawableProfileWeightedScore.cs
+++ b/osu.Game/Overlays/Profile/Sections/Ranks/DrawableProfileWeightedScore.cs
@@ -16,7 +16,7 @@ namespace osu.Game.Overlays.Profile.Sections.Ranks
     {
         private readonly double weight;
 
-        public DrawableProfileWeightedScore(APIScoreInfo score, double weight)
+        public DrawableProfileWeightedScore(APIScore score, double weight)
             : base(score)
         {
             this.weight = weight;
diff --git a/osu.Game/Overlays/Profile/Sections/Ranks/PaginatedScoreContainer.cs b/osu.Game/Overlays/Profile/Sections/Ranks/PaginatedScoreContainer.cs
index c3f10587a9..5532e35cc5 100644
--- a/osu.Game/Overlays/Profile/Sections/Ranks/PaginatedScoreContainer.cs
+++ b/osu.Game/Overlays/Profile/Sections/Ranks/PaginatedScoreContainer.cs
@@ -15,7 +15,7 @@ using APIUser = osu.Game.Online.API.Requests.Responses.APIUser;
 
 namespace osu.Game.Overlays.Profile.Sections.Ranks
 {
-    public class PaginatedScoreContainer : PaginatedProfileSubsection<APIScoreInfo>
+    public class PaginatedScoreContainer : PaginatedProfileSubsection<APIScore>
     {
         private readonly ScoreType type;
 
@@ -51,7 +51,7 @@ namespace osu.Game.Overlays.Profile.Sections.Ranks
             }
         }
 
-        protected override void OnItemsReceived(List<APIScoreInfo> items)
+        protected override void OnItemsReceived(List<APIScore> items)
         {
             if (VisiblePages == 0)
                 drawableItemIndex = 0;
@@ -59,12 +59,12 @@ namespace osu.Game.Overlays.Profile.Sections.Ranks
             base.OnItemsReceived(items);
         }
 
-        protected override APIRequest<List<APIScoreInfo>> CreateRequest() =>
+        protected override APIRequest<List<APIScore>> CreateRequest() =>
             new GetUserScoresRequest(User.Value.Id, type, VisiblePages++, ItemsPerPage);
 
         private int drawableItemIndex;
 
-        protected override Drawable CreateDrawableItem(APIScoreInfo model)
+        protected override Drawable CreateDrawableItem(APIScore model)
         {
             switch (type)
             {

From c6d0d6451d463767f60400143c6e195ed1c8f363 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 11 Nov 2021 23:18:31 +0900
Subject: [PATCH 1614/5547] Change `IScoreInfo.User` to an interface type

---
 osu.Game/Online/API/Requests/Responses/APIScore.cs | 6 ++++++
 osu.Game/Scoring/IScoreInfo.cs                     | 4 ++--
 osu.Game/Scoring/ScoreInfo.cs                      | 2 ++
 3 files changed, 10 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Online/API/Requests/Responses/APIScore.cs b/osu.Game/Online/API/Requests/Responses/APIScore.cs
index bd99a05a88..4f795bee6c 100644
--- a/osu.Game/Online/API/Requests/Responses/APIScore.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIScore.cs
@@ -13,6 +13,7 @@ using osu.Game.Rulesets;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Scoring;
 using osu.Game.Scoring.Legacy;
+using osu.Game.Users;
 
 namespace osu.Game.Online.API.Requests.Responses
 {
@@ -150,6 +151,11 @@ namespace osu.Game.Online.API.Requests.Responses
         public IRulesetInfo Ruleset => new RulesetInfo { OnlineID = RulesetID };
         IEnumerable<INamedFileUsage> IHasNamedFiles.Files => throw new NotImplementedException();
 
+        #region Implementation of IScoreInfo
+
         IBeatmapInfo IScoreInfo.Beatmap => Beatmap;
+        IUser IScoreInfo.User => User;
+
+        #endregion
     }
 }
diff --git a/osu.Game/Scoring/IScoreInfo.cs b/osu.Game/Scoring/IScoreInfo.cs
index 8b5b228632..b4ad183cd3 100644
--- a/osu.Game/Scoring/IScoreInfo.cs
+++ b/osu.Game/Scoring/IScoreInfo.cs
@@ -4,14 +4,14 @@
 using System;
 using osu.Game.Beatmaps;
 using osu.Game.Database;
-using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets;
+using osu.Game.Users;
 
 namespace osu.Game.Scoring
 {
     public interface IScoreInfo : IHasOnlineID<long>, IHasNamedFiles
     {
-        APIUser User { get; }
+        IUser User { get; }
 
         long TotalScore { get; }
 
diff --git a/osu.Game/Scoring/ScoreInfo.cs b/osu.Game/Scoring/ScoreInfo.cs
index d6b7b2712b..7729e01389 100644
--- a/osu.Game/Scoring/ScoreInfo.cs
+++ b/osu.Game/Scoring/ScoreInfo.cs
@@ -14,6 +14,7 @@ using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Scoring;
+using osu.Game.Users;
 using osu.Game.Utils;
 
 namespace osu.Game.Scoring
@@ -261,6 +262,7 @@ namespace osu.Game.Scoring
 
         IBeatmapInfo IScoreInfo.Beatmap => BeatmapInfo;
         IRulesetInfo IScoreInfo.Ruleset => Ruleset;
+        IUser IScoreInfo.User => User;
         bool IScoreInfo.HasReplay => Files.Any();
 
         #endregion

From 970a9ae0748d8d6f99fd6035c5f96673702665a3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 10 Dec 2021 17:22:24 +0900
Subject: [PATCH 1615/5547] Add update thread asserts to `RoomManager` methods

---
 osu.Game/Screens/OnlinePlay/Components/RoomManager.cs | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/osu.Game/Screens/OnlinePlay/Components/RoomManager.cs b/osu.Game/Screens/OnlinePlay/Components/RoomManager.cs
index 02565c6ebe..6979b5bc30 100644
--- a/osu.Game/Screens/OnlinePlay/Components/RoomManager.cs
+++ b/osu.Game/Screens/OnlinePlay/Components/RoomManager.cs
@@ -7,11 +7,13 @@ using System.Diagnostics;
 using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
+using osu.Framework.Development;
 using osu.Framework.Graphics;
 using osu.Framework.Logging;
 using osu.Game.Online.API;
 using osu.Game.Online.Rooms;
 using osu.Game.Rulesets;
+using osu.Game.Utils;
 
 namespace osu.Game.Screens.OnlinePlay.Components
 {
@@ -107,6 +109,7 @@ namespace osu.Game.Screens.OnlinePlay.Components
 
         public void AddOrUpdateRoom(Room room)
         {
+            Debug.Assert(ThreadSafety.IsUpdateThread);
             Debug.Assert(room.RoomID.Value != null);
 
             if (ignoredRooms.Contains(room.RoomID.Value.Value))
@@ -136,12 +139,16 @@ namespace osu.Game.Screens.OnlinePlay.Components
 
         public void RemoveRoom(Room room)
         {
+            Debug.Assert(ThreadSafety.IsUpdateThread);
+
             rooms.Remove(room);
             notifyRoomsUpdated();
         }
 
         public void ClearRooms()
         {
+            Debug.Assert(ThreadSafety.IsUpdateThread);
+
             rooms.Clear();
             notifyRoomsUpdated();
         }

From 73227c084e380d893bad1bb9a1d6e0fefcecccb2 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 10 Dec 2021 17:42:40 +0900
Subject: [PATCH 1616/5547] Update framework

---
 osu.Android.props        | 2 +-
 osu.Game/osu.Game.csproj | 2 +-
 osu.iOS.props            | 4 ++--
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Android.props b/osu.Android.props
index 0c922c09ac..5cf59decec 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -52,7 +52,7 @@
   </ItemGroup>
   <ItemGroup>
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1203.0" />
-    <PackageReference Include="ppy.osu.Framework.Android" Version="2021.1207.0" />
+    <PackageReference Include="ppy.osu.Framework.Android" Version="2021.1210.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
     <!-- Realm needs to be directly referenced in all Xamarin projects, as it will not pull in its transitive dependencies otherwise. -->
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index adb25f46fe..6f01cc65fe 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="10.7.1" />
-    <PackageReference Include="ppy.osu.Framework" Version="2021.1207.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2021.1210.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1203.0" />
     <PackageReference Include="Sentry" Version="3.11.1" />
     <PackageReference Include="SharpCompress" Version="0.30.0" />
diff --git a/osu.iOS.props b/osu.iOS.props
index db5d9af865..fdb63a19d3 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -60,7 +60,7 @@
     <Reference Include="System.Net.Http" />
   </ItemGroup>
   <ItemGroup Label="Package References">
-    <PackageReference Include="ppy.osu.Framework.iOS" Version="2021.1207.0" />
+    <PackageReference Include="ppy.osu.Framework.iOS" Version="2021.1210.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1203.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net5.0 / net6.0) -->
@@ -83,7 +83,7 @@
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="2.2.6" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.Core" Version="2.2.6" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
-    <PackageReference Include="ppy.osu.Framework" Version="2021.1207.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2021.1210.0" />
     <PackageReference Include="SharpCompress" Version="0.30.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
     <PackageReference Include="SharpRaven" Version="2.4.0" />

From e98060ac37571471fa1477bd0038b64d219525db Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 10 Dec 2021 17:55:18 +0900
Subject: [PATCH 1617/5547] Remove unused using

---
 osu.Game/Screens/OnlinePlay/Components/RoomManager.cs | 1 -
 1 file changed, 1 deletion(-)

diff --git a/osu.Game/Screens/OnlinePlay/Components/RoomManager.cs b/osu.Game/Screens/OnlinePlay/Components/RoomManager.cs
index 6979b5bc30..238aa4059d 100644
--- a/osu.Game/Screens/OnlinePlay/Components/RoomManager.cs
+++ b/osu.Game/Screens/OnlinePlay/Components/RoomManager.cs
@@ -13,7 +13,6 @@ using osu.Framework.Logging;
 using osu.Game.Online.API;
 using osu.Game.Online.Rooms;
 using osu.Game.Rulesets;
-using osu.Game.Utils;
 
 namespace osu.Game.Screens.OnlinePlay.Components
 {

From 5f6e887be71bc8ebd5894f07669958d3e4445dd0 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 10 Dec 2021 18:11:52 +0900
Subject: [PATCH 1618/5547] Remove `OnlineID` comparison from
 `ScoreInfo.Equals`

This matches the implementation we have for `BeatmapInfo` and
`BeatmapSetInfo`. All comparisons of `OnlineID` should be done directly
using them (ie. how it's done in `ScoreModelDownloader`).
---
 osu.Game.Tests/Scores/IO/TestScoreEquality.cs | 18 ------------------
 osu.Game/Scoring/ScoreInfo.cs                 | 12 +++---------
 2 files changed, 3 insertions(+), 27 deletions(-)

diff --git a/osu.Game.Tests/Scores/IO/TestScoreEquality.cs b/osu.Game.Tests/Scores/IO/TestScoreEquality.cs
index d1374eb6e5..42fcb3acab 100644
--- a/osu.Game.Tests/Scores/IO/TestScoreEquality.cs
+++ b/osu.Game.Tests/Scores/IO/TestScoreEquality.cs
@@ -44,24 +44,6 @@ namespace osu.Game.Tests.Scores.IO
             Assert.That(score1, Is.EqualTo(score2));
         }
 
-        [Test]
-        public void TestNonMatchingByHash()
-        {
-            ScoreInfo score1 = new ScoreInfo { Hash = "a" };
-            ScoreInfo score2 = new ScoreInfo { Hash = "b" };
-
-            Assert.That(score1, Is.Not.EqualTo(score2));
-        }
-
-        [Test]
-        public void TestMatchingByHash()
-        {
-            ScoreInfo score1 = new ScoreInfo { Hash = "a" };
-            ScoreInfo score2 = new ScoreInfo { Hash = "a" };
-
-            Assert.That(score1, Is.EqualTo(score2));
-        }
-
         [Test]
         public void TestNonMatchingByNull()
         {
diff --git a/osu.Game/Scoring/ScoreInfo.cs b/osu.Game/Scoring/ScoreInfo.cs
index 7729e01389..7c2d882f91 100644
--- a/osu.Game/Scoring/ScoreInfo.cs
+++ b/osu.Game/Scoring/ScoreInfo.cs
@@ -232,19 +232,13 @@ namespace osu.Game.Scoring
 
         public bool Equals(ScoreInfo other)
         {
-            if (other == null)
-                return false;
+            if (ReferenceEquals(this, other)) return true;
+            if (other == null) return false;
 
             if (ID != 0 && other.ID != 0)
                 return ID == other.ID;
 
-            if (OnlineID > 0)
-                return OnlineID == other.OnlineID;
-
-            if (!string.IsNullOrEmpty(Hash) && !string.IsNullOrEmpty(other.Hash))
-                return Hash == other.Hash;
-
-            return ReferenceEquals(this, other);
+            return false;
         }
 
         #region Implementation of IHasOnlineID

From c9f6c5c673aaff4ae53d4cce9ffb2832e49c31b4 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 10 Dec 2021 18:32:06 +0900
Subject: [PATCH 1619/5547] Add `MatchesOnlineID` implementation for
 `IScoreInfo`

---
 osu.Game/Extensions/ModelExtensions.cs   | 8 ++++++++
 osu.Game/Online/ScoreDownloadTracker.cs  | 3 ++-
 osu.Game/Scoring/ScoreModelDownloader.cs | 3 ++-
 3 files changed, 12 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Extensions/ModelExtensions.cs b/osu.Game/Extensions/ModelExtensions.cs
index 2274da0fd4..f178a5c97b 100644
--- a/osu.Game/Extensions/ModelExtensions.cs
+++ b/osu.Game/Extensions/ModelExtensions.cs
@@ -104,6 +104,14 @@ namespace osu.Game.Extensions
         /// <returns>Whether online IDs match. If either instance is missing an online ID, this will return false.</returns>
         public static bool MatchesOnlineID(this APIUser? instance, APIUser? other) => matchesOnlineID(instance, other);
 
+        /// <summary>
+        /// Check whether the online ID of two <see cref="IScoreInfo"/>s match.
+        /// </summary>
+        /// <param name="instance">The instance to compare.</param>
+        /// <param name="other">The other instance to compare against.</param>
+        /// <returns>Whether online IDs match. If either instance is missing an online ID, this will return false.</returns>
+        public static bool MatchesOnlineID(this IScoreInfo? instance, IScoreInfo? other) => matchesOnlineID(instance, other);
+
         private static bool matchesOnlineID(this IHasOnlineID<long>? instance, IHasOnlineID<long>? other)
         {
             if (instance == null || other == null)
diff --git a/osu.Game/Online/ScoreDownloadTracker.cs b/osu.Game/Online/ScoreDownloadTracker.cs
index 6320b7ff97..68932cc388 100644
--- a/osu.Game/Online/ScoreDownloadTracker.cs
+++ b/osu.Game/Online/ScoreDownloadTracker.cs
@@ -3,6 +3,7 @@
 
 using System;
 using osu.Framework.Allocation;
+using osu.Game.Extensions;
 using osu.Game.Online.API;
 using osu.Game.Scoring;
 
@@ -113,7 +114,7 @@ namespace osu.Game.Online
                 UpdateState(DownloadState.NotDownloaded);
         });
 
-        private bool checkEquality(IScoreInfo x, IScoreInfo y) => x.OnlineID == y.OnlineID;
+        private bool checkEquality(IScoreInfo x, IScoreInfo y) => x.MatchesOnlineID(y);
 
         #region Disposal
 
diff --git a/osu.Game/Scoring/ScoreModelDownloader.cs b/osu.Game/Scoring/ScoreModelDownloader.cs
index 038a4bc351..514b7a57de 100644
--- a/osu.Game/Scoring/ScoreModelDownloader.cs
+++ b/osu.Game/Scoring/ScoreModelDownloader.cs
@@ -2,6 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using osu.Game.Database;
+using osu.Game.Extensions;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests;
 
@@ -17,6 +18,6 @@ namespace osu.Game.Scoring
         protected override ArchiveDownloadRequest<IScoreInfo> CreateDownloadRequest(IScoreInfo score, bool minimiseDownload) => new DownloadReplayRequest(score);
 
         public override ArchiveDownloadRequest<IScoreInfo> GetExistingDownload(IScoreInfo model)
-            => CurrentDownloads.Find(r => r.Model.OnlineID == model.OnlineID);
+            => CurrentDownloads.Find(r => r.Model.MatchesOnlineID(model));
     }
 }

From f7c5a3f506815eee95fc36e62fb88e411319f8ca Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 10 Dec 2021 18:32:32 +0900
Subject: [PATCH 1620/5547] Use similar method of consuming `OnlineID` as done
 in beatmap classes

---
 osu.Game/Database/OsuDbContext.cs |  2 +-
 osu.Game/Scoring/ScoreInfo.cs     | 16 +++++++++-------
 osu.Game/Screens/Play/Player.cs   |  2 +-
 3 files changed, 11 insertions(+), 9 deletions(-)

diff --git a/osu.Game/Database/OsuDbContext.cs b/osu.Game/Database/OsuDbContext.cs
index 13d362e0be..7cd9ae2885 100644
--- a/osu.Game/Database/OsuDbContext.cs
+++ b/osu.Game/Database/OsuDbContext.cs
@@ -147,7 +147,7 @@ namespace osu.Game.Database
 
             modelBuilder.Entity<BeatmapInfo>().HasOne(b => b.BaseDifficulty);
 
-            modelBuilder.Entity<ScoreInfo>().HasIndex(b => b.OnlineScoreID).IsUnique();
+            modelBuilder.Entity<ScoreInfo>().HasIndex(b => b.OnlineID).IsUnique();
         }
 
         private class OsuDbLoggerFactory : ILoggerFactory
diff --git a/osu.Game/Scoring/ScoreInfo.cs b/osu.Game/Scoring/ScoreInfo.cs
index 7c2d882f91..7acc7bd055 100644
--- a/osu.Game/Scoring/ScoreInfo.cs
+++ b/osu.Game/Scoring/ScoreInfo.cs
@@ -137,7 +137,14 @@ namespace osu.Game.Scoring
         [Column("Beatmap")]
         public BeatmapInfo BeatmapInfo { get; set; }
 
-        public long? OnlineScoreID { get; set; }
+        private long? onlineID;
+
+        [Column("OnlineScoreID")]
+        public long? OnlineID
+        {
+            get => onlineID;
+            set => onlineID = value > 0 ? value : null;
+        }
 
         public DateTimeOffset Date { get; set; }
 
@@ -243,12 +250,7 @@ namespace osu.Game.Scoring
 
         #region Implementation of IHasOnlineID
 
-        [NotMapped]
-        public long OnlineID
-        {
-            get => OnlineScoreID ?? -1;
-            set => OnlineScoreID = value;
-        }
+        long IHasOnlineID<long>.OnlineID => OnlineID ?? -1;
 
         #endregion
 
diff --git a/osu.Game/Screens/Play/Player.cs b/osu.Game/Screens/Play/Player.cs
index 521cf7d1e9..e2896c174f 100644
--- a/osu.Game/Screens/Play/Player.cs
+++ b/osu.Game/Screens/Play/Player.cs
@@ -1031,7 +1031,7 @@ namespace osu.Game.Screens.Play
             //
             // Until we better define the server-side logic behind this, let's not store the online ID to avoid potential unique constraint
             // conflicts across various systems (ie. solo and multiplayer).
-            long onlineScoreId = score.ScoreInfo.OnlineID;
+            long? onlineScoreId = score.ScoreInfo.OnlineID;
             score.ScoreInfo.OnlineID = -1;
 
             await scoreManager.Import(score.ScoreInfo, replayReader).ConfigureAwait(false);

From 3b899af061f2e3f450bbec9913c32c6167681b53 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 10 Dec 2021 18:37:57 +0900
Subject: [PATCH 1621/5547] Update libraries

---
 .config/dotnet-tools.json | 4 ++--
 osu.Game/osu.Game.csproj  | 8 ++++----
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/.config/dotnet-tools.json b/.config/dotnet-tools.json
index 6444127594..985fc09df3 100644
--- a/.config/dotnet-tools.json
+++ b/.config/dotnet-tools.json
@@ -27,10 +27,10 @@
       ]
     },
     "ppy.localisationanalyser.tools": {
-      "version": "2021.725.0",
+      "version": "2021.1210.0",
       "commands": [
         "localisation"
       ]
     }
   }
-}
\ No newline at end of file
+}
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 6f01cc65fe..46064e320b 100644
--- a/osu.Game/osu.Game.csproj
+++ b/osu.Game/osu.Game.csproj
@@ -20,7 +20,7 @@
   <ItemGroup Label="Package References">
     <PackageReference Include="AutoMapper" Version="10.1.1" />
     <PackageReference Include="DiffPlex" Version="1.7.0" />
-    <PackageReference Include="HtmlAgilityPack" Version="1.11.38" />
+    <PackageReference Include="HtmlAgilityPack" Version="1.11.39" />
     <PackageReference Include="Humanizer" Version="2.13.14" />
     <PackageReference Include="MessagePack" Version="2.3.85" />
     <PackageReference Include="Microsoft.AspNetCore.SignalR.Client" Version="5.0.11" />
@@ -31,15 +31,15 @@
     <PackageReference Include="Microsoft.Extensions.Configuration.Abstractions" Version="5.0.0" />
     <PackageReference Include="Microsoft.NETCore.Targets" Version="3.1.0" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
-    <PackageReference Include="ppy.LocalisationAnalyser" Version="2021.725.0">
+    <PackageReference Include="ppy.LocalisationAnalyser" Version="2021.1210.0">
       <PrivateAssets>all</PrivateAssets>
       <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
     </PackageReference>
     <PackageReference Include="Realm" Version="10.7.1" />
     <PackageReference Include="ppy.osu.Framework" Version="2021.1210.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1203.0" />
-    <PackageReference Include="Sentry" Version="3.11.1" />
-    <PackageReference Include="SharpCompress" Version="0.30.0" />
+    <PackageReference Include="Sentry" Version="3.12.1" />
+    <PackageReference Include="SharpCompress" Version="0.30.1" />
     <PackageReference Include="NUnit" Version="3.13.2" />
     <PackageReference Include="System.ComponentModel.Annotations" Version="5.0.0" />
     <PackageReference Include="TagLibSharp" Version="2.2.0" />

From 5e9510be3608a3718c9b0d109cc8ae80f6b44add Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 10 Dec 2021 18:57:33 +0900
Subject: [PATCH 1622/5547] Add test coverage of editor resetting mods on
 entering

---
 osu.Game.Tests/Visual/Editing/TestSceneEditorTestGameplay.cs | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneEditorTestGameplay.cs b/osu.Game.Tests/Visual/Editing/TestSceneEditorTestGameplay.cs
index 160af47a6d..50794f15ed 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneEditorTestGameplay.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneEditorTestGameplay.cs
@@ -9,6 +9,7 @@ using osu.Framework.Screens;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets;
+using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Osu;
 using osu.Game.Screens.Backgrounds;
 using osu.Game.Screens.Edit;
@@ -44,6 +45,7 @@ namespace osu.Game.Tests.Visual.Editing
         protected override void LoadEditor()
         {
             Beatmap.Value = beatmaps.GetWorkingBeatmap(importedBeatmapSet.Beatmaps.First(b => b.RulesetID == 0));
+            SelectedMods.Value = new[] { new ModCinema() };
             base.LoadEditor();
         }
 
@@ -67,6 +69,7 @@ namespace osu.Game.Tests.Visual.Editing
                 var background = this.ChildrenOfType<BackgroundScreenBeatmap>().Single();
                 return background.Colour == Color4.DarkGray && background.BlurAmount.Value == 0;
             });
+            AddAssert("no mods selected", () => SelectedMods.Value.Count == 0);
         }
 
         [Test]

From c1b3ee6bb23765a540708dd5af9f13064f310786 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 10 Dec 2021 18:57:43 +0900
Subject: [PATCH 1623/5547] Fix editor not resetting mods when entering

Would leave the user potentially in a test mode that is in a weird
state (ie. if cinema mod was enabled). Eventually we'll add the ability
to choose mods for test play, but that will be done in a saner way.

Closes #15870.
---
 osu.Game/Screens/Edit/EditorLoader.cs | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/osu.Game/Screens/Edit/EditorLoader.cs b/osu.Game/Screens/Edit/EditorLoader.cs
index 2a01a5b6b2..27ae8ae497 100644
--- a/osu.Game/Screens/Edit/EditorLoader.cs
+++ b/osu.Game/Screens/Edit/EditorLoader.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 JetBrains.Annotations;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
@@ -9,6 +10,7 @@ using osu.Framework.Screens;
 using osu.Framework.Threading;
 using osu.Game.Beatmaps;
 using osu.Game.Graphics.UserInterface;
+using osu.Game.Rulesets.Mods;
 using osu.Game.Screens.Menu;
 using osu.Game.Screens.Play;
 
@@ -53,6 +55,14 @@ namespace osu.Game.Screens.Edit
             });
         }
 
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            // will be restored via lease, see `DisallowExternalBeatmapRulesetChanges`.
+            Mods.Value = ArraySegment<Mod>.Empty;
+        }
+
         protected virtual Editor CreateEditor() => new Editor(this);
 
         protected override void LogoArriving(OsuLogo logo, bool resuming)

From 5a953f38119cdca4a3a6a214110b2d2f934ab013 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 10 Dec 2021 19:14:33 +0900
Subject: [PATCH 1624/5547] Fix autopilot not working as expected on touch
 devices

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

I haven't tested this, but quite confident it should work. Will test
later today unless someone else beats me.
---
 osu.Game.Rulesets.Osu/OsuInputManager.cs | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/osu.Game.Rulesets.Osu/OsuInputManager.cs b/osu.Game.Rulesets.Osu/OsuInputManager.cs
index 7314021a14..f5fc3de381 100644
--- a/osu.Game.Rulesets.Osu/OsuInputManager.cs
+++ b/osu.Game.Rulesets.Osu/OsuInputManager.cs
@@ -5,6 +5,7 @@ using System.Collections.Generic;
 using System.ComponentModel;
 using osu.Framework.Input.Bindings;
 using osu.Framework.Input.Events;
+using osu.Framework.Input.StateChanges.Events;
 using osu.Game.Rulesets.UI;
 
 namespace osu.Game.Rulesets.Osu
@@ -39,6 +40,17 @@ namespace osu.Game.Rulesets.Osu
             return base.Handle(e);
         }
 
+        protected override bool HandleMouseTouchStateChange(TouchStateChangeEvent e)
+        {
+            if (!AllowUserCursorMovement)
+            {
+                // Still allow for forwarding of the "touch" part, but block the positional data.
+                e = new TouchStateChangeEvent(e.State, e.Input, e.Touch, false, null);
+            }
+
+            return base.HandleMouseTouchStateChange(e);
+        }
+
         private class OsuKeyBindingContainer : RulesetKeyBindingContainer
         {
             public bool AllowUserPresses = true;

From 6057037e355b06eb763609200c06adefa99e31c2 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 10 Dec 2021 20:08:59 +0900
Subject: [PATCH 1625/5547] Move playlist item beatmap population to
 MatchSubScreen

---
 .../StatefulMultiplayerClientTest.cs          |  4 --
 .../TestSceneAllPlayersQueueMode.cs           | 16 ++---
 .../Multiplayer/TestSceneHostOnlyQueueMode.cs | 10 +--
 .../Multiplayer/TestSceneMultiplayer.cs       |  2 +-
 .../Multiplayer/TestSceneMultiplayerPlayer.cs |  7 +-
 .../TestSceneMultiplayerQueueList.cs          | 24 +++----
 .../Online/Multiplayer/MultiplayerClient.cs   | 65 +++++--------------
 .../Multiplayer/OnlineMultiplayerClient.cs    |  2 +-
 .../Screens/OnlinePlay/Match/RoomSubScreen.cs |  2 +-
 .../Match/MultiplayerReadyButton.cs           | 10 ++-
 .../Multiplayer/MultiplayerMatchSongSelect.cs |  6 +-
 .../Multiplayer/MultiplayerMatchSubScreen.cs  | 49 ++++++++++++--
 .../Multiplayer/TestMultiplayerClient.cs      |  2 +-
 13 files changed, 103 insertions(+), 96 deletions(-)

diff --git a/osu.Game.Tests/NonVisual/Multiplayer/StatefulMultiplayerClientTest.cs b/osu.Game.Tests/NonVisual/Multiplayer/StatefulMultiplayerClientTest.cs
index 42305ccd81..bc0041e2c2 100644
--- a/osu.Game.Tests/NonVisual/Multiplayer/StatefulMultiplayerClientTest.cs
+++ b/osu.Game.Tests/NonVisual/Multiplayer/StatefulMultiplayerClientTest.cs
@@ -45,8 +45,6 @@ namespace osu.Game.Tests.NonVisual.Multiplayer
             AddRepeatStep("add some users", () => Client.AddUser(new APIUser { Id = id++ }), 5);
             checkPlayingUserCount(0);
 
-            AddAssert("playlist item is available", () => Client.CurrentMatchPlayingItem.Value != null);
-
             changeState(3, MultiplayerUserState.WaitingForLoad);
             checkPlayingUserCount(3);
 
@@ -64,8 +62,6 @@ namespace osu.Game.Tests.NonVisual.Multiplayer
 
             AddStep("leave room", () => Client.LeaveRoom());
             checkPlayingUserCount(0);
-
-            AddAssert("playlist item is null", () => Client.CurrentMatchPlayingItem.Value == null);
         }
 
         [Test]
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneAllPlayersQueueMode.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneAllPlayersQueueMode.cs
index 8373979308..4bf38c9ff8 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneAllPlayersQueueMode.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneAllPlayersQueueMode.cs
@@ -19,7 +19,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [Test]
         public void TestFirstItemSelectedByDefault()
         {
-            AddAssert("first item selected", () => Client.CurrentMatchPlayingItem.Value?.ID == Client.APIRoom?.Playlist[0].ID);
+            AddAssert("first item selected", () => Client.Room?.Settings.PlaylistItemId == Client.APIRoom?.Playlist[0].ID);
         }
 
         [Test]
@@ -27,13 +27,11 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             addItem(() => OtherBeatmap);
             AddAssert("playlist has 2 items", () => Client.APIRoom?.Playlist.Count == 2);
-            AddAssert("last playlist item is different", () => Client.APIRoom?.Playlist[1].Beatmap.Value.OnlineID == OtherBeatmap.OnlineID);
 
             addItem(() => InitialBeatmap);
             AddAssert("playlist has 3 items", () => Client.APIRoom?.Playlist.Count == 3);
-            AddAssert("last playlist item is different", () => Client.APIRoom?.Playlist[2].Beatmap.Value.OnlineID == InitialBeatmap.OnlineID);
 
-            AddAssert("first item still selected", () => Client.CurrentMatchPlayingItem.Value?.ID == Client.APIRoom?.Playlist[0].ID);
+            AddAssert("first item still selected", () => Client.Room?.Settings.PlaylistItemId == Client.APIRoom?.Playlist[0].ID);
         }
 
         [Test]
@@ -43,7 +41,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             AddAssert("playlist has only one item", () => Client.APIRoom?.Playlist.Count == 1);
             AddAssert("playlist item is expired", () => Client.APIRoom?.Playlist[0].Expired == true);
-            AddAssert("last item selected", () => Client.CurrentMatchPlayingItem.Value?.ID == Client.APIRoom?.Playlist[0].ID);
+            AddAssert("last item selected", () => Client.Room?.Settings.PlaylistItemId == Client.APIRoom?.Playlist[0].ID);
         }
 
         [Test]
@@ -55,12 +53,12 @@ namespace osu.Game.Tests.Visual.Multiplayer
             RunGameplay();
 
             AddAssert("first item expired", () => Client.APIRoom?.Playlist[0].Expired == true);
-            AddAssert("next item selected", () => Client.CurrentMatchPlayingItem.Value?.ID == Client.APIRoom?.Playlist[1].ID);
+            AddAssert("next item selected", () => Client.Room?.Settings.PlaylistItemId == Client.APIRoom?.Playlist[1].ID);
 
             RunGameplay();
 
             AddAssert("second item expired", () => Client.APIRoom?.Playlist[1].Expired == true);
-            AddAssert("next item selected", () => Client.CurrentMatchPlayingItem.Value?.ID == Client.APIRoom?.Playlist[2].ID);
+            AddAssert("next item selected", () => Client.Room?.Settings.PlaylistItemId == Client.APIRoom?.Playlist[2].ID);
         }
 
         [Test]
@@ -74,8 +72,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             AddStep("change queue mode", () => Client.ChangeSettings(queueMode: QueueMode.HostOnly));
             AddAssert("playlist has 3 items", () => Client.APIRoom?.Playlist.Count == 3);
-            AddAssert("playlist item is the other beatmap", () => Client.CurrentMatchPlayingItem.Value?.BeatmapID == OtherBeatmap.OnlineID);
-            AddAssert("playlist item is not expired", () => Client.APIRoom?.Playlist[1].Expired == false);
+            AddAssert("item 2 is not expired", () => Client.APIRoom?.Playlist[1].Expired == false);
+            AddAssert("current item is the other beatmap", () => Client.Room?.Settings.PlaylistItemId == 2);
         }
 
         [Test]
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneHostOnlyQueueMode.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneHostOnlyQueueMode.cs
index ccac3de304..c06bd8fdbe 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneHostOnlyQueueMode.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneHostOnlyQueueMode.cs
@@ -20,7 +20,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [Test]
         public void TestFirstItemSelectedByDefault()
         {
-            AddAssert("first item selected", () => Client.CurrentMatchPlayingItem.Value?.ID == Client.APIRoom?.Playlist[0].ID);
+            AddAssert("first item selected", () => Client.Room?.Settings.PlaylistItemId == Client.APIRoom?.Playlist[0].ID);
         }
 
         [Test]
@@ -28,7 +28,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             selectNewItem(() => InitialBeatmap);
 
-            AddAssert("playlist item still selected", () => Client.CurrentMatchPlayingItem.Value?.ID == Client.APIRoom?.Playlist[0].ID);
+            AddAssert("playlist item still selected", () => Client.Room?.Settings.PlaylistItemId == Client.APIRoom?.Playlist[0].ID);
         }
 
         [Test]
@@ -36,7 +36,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             selectNewItem(() => OtherBeatmap);
 
-            AddAssert("playlist item still selected", () => Client.CurrentMatchPlayingItem.Value?.ID == Client.APIRoom?.Playlist[0].ID);
+            AddAssert("playlist item still selected", () => Client.Room?.Settings.PlaylistItemId == Client.APIRoom?.Playlist[0].ID);
         }
 
         [Test]
@@ -47,7 +47,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddAssert("playlist contains two items", () => Client.APIRoom?.Playlist.Count == 2);
             AddAssert("first playlist item expired", () => Client.APIRoom?.Playlist[0].Expired == true);
             AddAssert("second playlist item not expired", () => Client.APIRoom?.Playlist[1].Expired == false);
-            AddAssert("second playlist item selected", () => Client.CurrentMatchPlayingItem.Value?.ID == Client.APIRoom?.Playlist[1].ID);
+            AddAssert("second playlist item selected", () => Client.Room?.Settings.PlaylistItemId == Client.APIRoom?.Playlist[1].ID);
         }
 
         [Test]
@@ -97,7 +97,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddStep("select other beatmap", () => ((Screens.Select.SongSelect)CurrentSubScreen).FinaliseSelection(otherBeatmap = beatmap()));
 
             AddUntilStep("wait for return to match", () => CurrentSubScreen is MultiplayerMatchSubScreen);
-            AddUntilStep("selected item is new beatmap", () => Client.CurrentMatchPlayingItem.Value?.Beatmap.Value?.OnlineID == otherBeatmap.OnlineID);
+            AddUntilStep("selected item is new beatmap", () => (CurrentSubScreen as MultiplayerMatchSubScreen)?.SelectedItem.Value.BeatmapID == otherBeatmap.OnlineID);
         }
 
         private void addItem(Func<BeatmapInfo> beatmap)
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
index 5eb0abc830..f20ab914e2 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
@@ -416,7 +416,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddStep("Enter song select", () =>
             {
                 var currentSubScreen = ((Screens.OnlinePlay.Multiplayer.Multiplayer)multiplayerScreenStack.CurrentScreen).CurrentSubScreen;
-                ((MultiplayerMatchSubScreen)currentSubScreen).OpenSongSelection(client.CurrentMatchPlayingItem.Value);
+                ((MultiplayerMatchSubScreen)currentSubScreen).OpenSongSelection(client.Room?.Settings.PlaylistItemId);
             });
 
             AddUntilStep("wait for song select", () => this.ChildrenOfType<MultiplayerMatchSongSelect>().FirstOrDefault()?.BeatmapSetsLoaded == true);
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlayer.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlayer.cs
index 5708b2f789..73f2ed5b39 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlayer.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlayer.cs
@@ -6,6 +6,7 @@ using NUnit.Framework;
 using osu.Framework.Screens;
 using osu.Framework.Testing;
 using osu.Game.Online.Multiplayer;
+using osu.Game.Online.Rooms;
 using osu.Game.Rulesets.Osu;
 using osu.Game.Screens.OnlinePlay.Multiplayer;
 
@@ -27,7 +28,11 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             AddStep("initialise gameplay", () =>
             {
-                Stack.Push(player = new MultiplayerPlayer(Client.APIRoom, Client.CurrentMatchPlayingItem.Value, Client.Room?.Users.ToArray()));
+                Stack.Push(player = new MultiplayerPlayer(Client.APIRoom, new PlaylistItem
+                {
+                    Beatmap = { Value = Beatmap.Value.BeatmapInfo },
+                    Ruleset = { Value = Beatmap.Value.BeatmapInfo.Ruleset }
+                }, Client.Room?.Users.ToArray()));
             });
 
             AddUntilStep("wait for player to be current", () => player.IsCurrentScreen() && player.IsLoaded);
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs
index a2b2da0aec..61a92c32a4 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs
@@ -6,6 +6,7 @@ using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
+using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Platform;
@@ -27,11 +28,12 @@ namespace osu.Game.Tests.Visual.Multiplayer
 {
     public class TestSceneMultiplayerQueueList : MultiplayerTestScene
     {
-        private MultiplayerQueueList playlist;
+        private readonly Bindable<PlaylistItem> selectedItem = new Bindable<PlaylistItem>();
 
         [Cached(typeof(UserLookupCache))]
         private readonly TestUserLookupCache userLookupCache = new TestUserLookupCache();
 
+        private MultiplayerQueueList playlist;
         private BeatmapManager beatmaps;
         private RulesetStore rulesets;
         private BeatmapSetInfo importedSet;
@@ -50,12 +52,14 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             AddStep("create playlist", () =>
             {
+                selectedItem.Value = null;
+
                 Child = playlist = new MultiplayerQueueList
                 {
                     Anchor = Anchor.Centre,
                     Origin = Anchor.Centre,
                     Size = new Vector2(500, 300),
-                    SelectedItem = { BindTarget = Client.CurrentMatchPlayingItem },
+                    SelectedItem = { BindTarget = selectedItem },
                     Items = { BindTarget = Client.APIRoom!.Playlist }
                 };
             });
@@ -107,22 +111,14 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddStep("set all players queue mode", () => Client.ChangeSettings(new MultiplayerRoomSettings { QueueMode = QueueMode.AllPlayers }));
             AddUntilStep("wait for queue mode change", () => Client.APIRoom?.QueueMode.Value == QueueMode.AllPlayers);
 
-            assertDeleteButtonVisibility(0, false);
-
             addPlaylistItem(() => API.LocalUser.Value.OnlineID);
+
+            AddStep("select item 0", () => selectedItem.Value = playlist.ChildrenOfType<RearrangeableListItem<PlaylistItem>>().ElementAt(0).Model);
             assertDeleteButtonVisibility(0, false);
             assertDeleteButtonVisibility(1, true);
 
-            // Run through gameplay.
-            AddStep("set state to ready", () => Client.ChangeUserState(API.LocalUser.Value.Id, MultiplayerUserState.Ready));
-            AddUntilStep("local state is ready", () => Client.LocalUser?.State == MultiplayerUserState.Ready);
-            AddStep("start match", () => Client.StartMatch());
-            AddUntilStep("match started", () => Client.LocalUser?.State == MultiplayerUserState.WaitingForLoad);
-            AddStep("set state to loaded", () => Client.ChangeUserState(API.LocalUser.Value.Id, MultiplayerUserState.Loaded));
-            AddUntilStep("local state is playing", () => Client.LocalUser?.State == MultiplayerUserState.Playing);
-            AddStep("set state to finished play", () => Client.ChangeUserState(API.LocalUser.Value.Id, MultiplayerUserState.FinishedPlay));
-            AddUntilStep("local state is results", () => Client.LocalUser?.State == MultiplayerUserState.Results);
-
+            AddStep("select item 1", () => selectedItem.Value = playlist.ChildrenOfType<RearrangeableListItem<PlaylistItem>>().ElementAt(1).Model);
+            assertDeleteButtonVisibility(0, true);
             assertDeleteButtonVisibility(1, false);
         }
 
diff --git a/osu.Game/Online/Multiplayer/MultiplayerClient.cs b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
index 55b4def908..f366de557f 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
@@ -95,8 +95,6 @@ namespace osu.Game.Online.Multiplayer
 
         protected readonly BindableList<int> PlayingUserIds = new BindableList<int>();
 
-        public readonly Bindable<PlaylistItem?> CurrentMatchPlayingItem = new Bindable<PlaylistItem?>();
-
         /// <summary>
         /// The <see cref="MultiplayerRoomUser"/> corresponding to the local player, if available.
         /// </summary>
@@ -162,9 +160,6 @@ namespace osu.Game.Online.Multiplayer
                 var joinedRoom = await JoinRoom(room.RoomID.Value.Value, password ?? room.Password.Value).ConfigureAwait(false);
                 Debug.Assert(joinedRoom != null);
 
-                // Populate playlist items.
-                var playlistItems = await Task.WhenAll(joinedRoom.Playlist.Select(item => createPlaylistItem(item, item.ID == joinedRoom.Settings.PlaylistItemId))).ConfigureAwait(false);
-
                 // Populate users.
                 Debug.Assert(joinedRoom.Users != null);
                 await Task.WhenAll(joinedRoom.Users.Select(PopulateUser)).ConfigureAwait(false);
@@ -176,7 +171,7 @@ namespace osu.Game.Online.Multiplayer
                     APIRoom = room;
 
                     APIRoom.Playlist.Clear();
-                    APIRoom.Playlist.AddRange(playlistItems);
+                    APIRoom.Playlist.AddRange(joinedRoom.Playlist.Select(createPlaylistItem));
 
                     Debug.Assert(LocalUser != null);
                     addUserToAPIRoom(LocalUser);
@@ -219,7 +214,6 @@ namespace osu.Game.Online.Multiplayer
             {
                 APIRoom = null;
                 Room = null;
-                CurrentMatchPlayingItem.Value = null;
                 PlayingUserIds.Clear();
 
                 RoomUpdated?.Invoke();
@@ -477,28 +471,7 @@ namespace osu.Game.Online.Multiplayer
             Debug.Assert(APIRoom != null);
             Debug.Assert(Room != null);
 
-            Scheduler.Add(() =>
-            {
-                // ensure the new selected item is populated immediately.
-                var playlistItem = APIRoom.Playlist.Single(p => p.ID == newSettings.PlaylistItemId);
-
-                if (playlistItem != null)
-                {
-                    GetAPIBeatmap(playlistItem.BeatmapID).ContinueWith(b =>
-                    {
-                        // Should be called outside of the `Scheduler` logic (and specifically accessing `Exception`) to suppress an exception from firing outwards.
-                        bool success = b.Exception == null;
-
-                        Scheduler.Add(() =>
-                        {
-                            if (success)
-                                playlistItem.Beatmap.Value = b.Result;
-
-                            updateLocalRoomSettings(newSettings);
-                        });
-                    });
-                }
-            });
+            Scheduler.Add(() => updateLocalRoomSettings(newSettings));
 
             return Task.CompletedTask;
         }
@@ -653,12 +626,10 @@ namespace osu.Game.Online.Multiplayer
             return Task.CompletedTask;
         }
 
-        public async Task PlaylistItemAdded(MultiplayerPlaylistItem item)
+        public Task PlaylistItemAdded(MultiplayerPlaylistItem item)
         {
             if (Room == null)
-                return;
-
-            var playlistItem = await createPlaylistItem(item, true).ConfigureAwait(false);
+                return Task.CompletedTask;
 
             Scheduler.Add(() =>
             {
@@ -668,11 +639,13 @@ namespace osu.Game.Online.Multiplayer
                 Debug.Assert(APIRoom != null);
 
                 Room.Playlist.Add(item);
-                APIRoom.Playlist.Add(playlistItem);
+                APIRoom.Playlist.Add(createPlaylistItem(item));
 
                 ItemAdded?.Invoke(item);
                 RoomUpdated?.Invoke();
             });
+
+            return Task.CompletedTask;
         }
 
         public Task PlaylistItemRemoved(long playlistItemId)
@@ -697,12 +670,10 @@ namespace osu.Game.Online.Multiplayer
             return Task.CompletedTask;
         }
 
-        public async Task PlaylistItemChanged(MultiplayerPlaylistItem item)
+        public Task PlaylistItemChanged(MultiplayerPlaylistItem item)
         {
             if (Room == null)
-                return;
-
-            var playlistItem = await createPlaylistItem(item, true).ConfigureAwait(false);
+                return Task.CompletedTask;
 
             Scheduler.Add(() =>
             {
@@ -715,15 +686,13 @@ namespace osu.Game.Online.Multiplayer
 
                 int existingIndex = APIRoom.Playlist.IndexOf(APIRoom.Playlist.Single(existing => existing.ID == item.ID));
                 APIRoom.Playlist.RemoveAt(existingIndex);
-                APIRoom.Playlist.Insert(existingIndex, playlistItem);
-
-                // If the currently-selected item was the one that got replaced, update the selected item to the new one.
-                if (CurrentMatchPlayingItem.Value?.ID == playlistItem.ID)
-                    CurrentMatchPlayingItem.Value = playlistItem;
+                APIRoom.Playlist.Insert(existingIndex, createPlaylistItem(item));
 
                 ItemChanged?.Invoke(item);
                 RoomUpdated?.Invoke();
             });
+
+            return Task.CompletedTask;
         }
 
         /// <summary>
@@ -752,12 +721,11 @@ namespace osu.Game.Online.Multiplayer
             APIRoom.Password.Value = Room.Settings.Password;
             APIRoom.Type.Value = Room.Settings.MatchType;
             APIRoom.QueueMode.Value = Room.Settings.QueueMode;
-            RoomUpdated?.Invoke();
 
-            CurrentMatchPlayingItem.Value = APIRoom.Playlist.SingleOrDefault(p => p.ID == settings.PlaylistItemId);
+            RoomUpdated?.Invoke();
         }
 
-        private async Task<PlaylistItem> createPlaylistItem(MultiplayerPlaylistItem item, bool populateBeatmapImmediately)
+        private PlaylistItem createPlaylistItem(MultiplayerPlaylistItem item)
         {
             var ruleset = Rulesets.GetRuleset(item.RulesetID);
 
@@ -779,9 +747,6 @@ namespace osu.Game.Online.Multiplayer
             playlistItem.RequiredMods.AddRange(item.RequiredMods.Select(m => m.ToMod(rulesetInstance)));
             playlistItem.AllowedMods.AddRange(item.AllowedMods.Select(m => m.ToMod(rulesetInstance)));
 
-            if (populateBeatmapImmediately)
-                playlistItem.Beatmap.Value = await GetAPIBeatmap(item.BeatmapID).ConfigureAwait(false);
-
             return playlistItem;
         }
 
@@ -791,7 +756,7 @@ namespace osu.Game.Online.Multiplayer
         /// <param name="beatmapId">The beatmap ID.</param>
         /// <param name="cancellationToken">A token to cancel the request.</param>
         /// <returns>The <see cref="APIBeatmap"/> retrieval task.</returns>
-        protected abstract Task<APIBeatmap> GetAPIBeatmap(int beatmapId, CancellationToken cancellationToken = default);
+        public abstract Task<APIBeatmap> GetAPIBeatmap(int beatmapId, CancellationToken cancellationToken = default);
 
         /// <summary>
         /// For the provided user ID, update whether the user is included in <see cref="CurrentMatchPlayingUserIds"/>.
diff --git a/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs b/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs
index d268d2bf69..f911ef3121 100644
--- a/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs
@@ -178,7 +178,7 @@ namespace osu.Game.Online.Multiplayer
             return connection.InvokeAsync(nameof(IMultiplayerServer.RemovePlaylistItem), playlistItemId);
         }
 
-        protected override Task<APIBeatmap> GetAPIBeatmap(int beatmapId, CancellationToken cancellationToken = default)
+        public override Task<APIBeatmap> GetAPIBeatmap(int beatmapId, CancellationToken cancellationToken = default)
         {
             return beatmapLookupCache.GetBeatmapAsync(beatmapId, cancellationToken);
         }
diff --git a/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs b/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
index 184ac2c563..55f5622afd 100644
--- a/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
@@ -28,7 +28,7 @@ namespace osu.Game.Screens.OnlinePlay.Match
     public abstract class RoomSubScreen : OnlinePlaySubScreen, IPreviewTrackOwner
     {
         [Cached(typeof(IBindable<PlaylistItem>))]
-        protected readonly Bindable<PlaylistItem> SelectedItem = new Bindable<PlaylistItem>();
+        public readonly Bindable<PlaylistItem> SelectedItem = new Bindable<PlaylistItem>();
 
         public override bool? AllowTrackAdjustments => true;
 
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
index 874113d859..06959d942f 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
@@ -63,6 +63,13 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
             sampleUnready = audio.Samples.Get(@"Multiplayer/player-unready");
         }
 
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            SelectedItem.BindValueChanged(_ => updateState());
+        }
+
         protected override void OnRoomUpdated()
         {
             base.OnRoomUpdated();
@@ -104,7 +111,8 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
 
             bool enableButton =
                 Room?.State == MultiplayerRoomState.Open
-                && Client.CurrentMatchPlayingItem.Value?.Expired == false
+                && SelectedItem.Value?.ID == Room.Settings.PlaylistItemId
+                && !Room.Playlist.Single(i => i.ID == Room.Settings.PlaylistItemId).Expired
                 && !operationInProgress.Value;
 
             // When the local user is the host and spectating the match, the "start match" state should be enabled if any users are ready.
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs
index 8d3686dd6d..073497e1ce 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs
@@ -25,7 +25,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
         [Resolved]
         private MultiplayerClient client { get; set; }
 
-        private readonly PlaylistItem itemToEdit;
+        private readonly long? itemToEdit;
 
         private LoadingLayer loadingLayer;
 
@@ -36,7 +36,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
         /// <param name="itemToEdit">The item to be edited. May be null, in which case a new item will be added to the playlist.</param>
         /// <param name="beatmap">An optional initial beatmap selection to perform.</param>
         /// <param name="ruleset">An optional initial ruleset selection to perform.</param>
-        public MultiplayerMatchSongSelect(Room room, PlaylistItem itemToEdit = null, WorkingBeatmap beatmap = null, RulesetInfo ruleset = null)
+        public MultiplayerMatchSongSelect(Room room, long? itemToEdit = null, WorkingBeatmap beatmap = null, RulesetInfo ruleset = null)
             : base(room)
         {
             this.itemToEdit = itemToEdit;
@@ -67,7 +67,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
 
                 var multiplayerItem = new MultiplayerPlaylistItem
                 {
-                    ID = itemToEdit?.ID ?? 0,
+                    ID = itemToEdit ?? 0,
                     BeatmapID = item.BeatmapID,
                     BeatmapChecksum = item.Beatmap.Value.MD5Hash,
                     RulesetID = item.RulesetID,
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
index 946c749db3..3543836d8d 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
@@ -5,6 +5,7 @@ using System;
 using System.Collections.Generic;
 using System.Diagnostics;
 using System.Linq;
+using System.Threading.Tasks;
 using JetBrains.Annotations;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
@@ -67,8 +68,6 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
         {
             base.LoadComplete();
 
-            SelectedItem.BindTo(client.CurrentMatchPlayingItem);
-
             BeatmapAvailability.BindValueChanged(updateBeatmapAvailability, true);
             UserMods.BindValueChanged(onUserModsChanged);
 
@@ -147,7 +146,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
                                     new MultiplayerPlaylist
                                     {
                                         RelativeSizeAxes = Axes.Both,
-                                        RequestEdit = OpenSongSelection
+                                        RequestEdit = item => OpenSongSelection(item.ID)
                                     }
                                 },
                                 new[]
@@ -224,7 +223,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
         /// Opens the song selection screen to add or edit an item.
         /// </summary>
         /// <param name="itemToEdit">An optional playlist item to edit. If null, a new item will be added instead.</param>
-        internal void OpenSongSelection([CanBeNull] PlaylistItem itemToEdit = null)
+        internal void OpenSongSelection(long? itemToEdit = null)
         {
             if (!this.IsCurrentScreen())
                 return;
@@ -389,11 +388,48 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
                 return;
             }
 
+            updateCurrentItem();
+
             addItemButton.Alpha = client.IsHost || Room.QueueMode.Value != QueueMode.HostOnly ? 1 : 0;
 
             Scheduler.AddOnce(UpdateMods);
         }
 
+        private void updateCurrentItem()
+        {
+            Debug.Assert(client.Room != null);
+
+            var expectedSelectedItem = Room.Playlist.SingleOrDefault(i => i.ID == client.Room.Settings.PlaylistItemId);
+
+            if (expectedSelectedItem == null)
+                return;
+
+            if (SelectedItem.Value?.Equals(expectedSelectedItem) == true && expectedSelectedItem.Beatmap.Value != null)
+                return;
+
+            SelectedItem.Value = null;
+
+            if (expectedSelectedItem.Beatmap.Value == null)
+            {
+                Task.Run(async () =>
+                {
+                    var beatmap = await client.GetAPIBeatmap(expectedSelectedItem.BeatmapID).ConfigureAwait(false);
+
+                    Schedule(() =>
+                    {
+                        expectedSelectedItem.Beatmap.Value = beatmap;
+
+                        if (Room.Playlist.SingleOrDefault(i => i.ID == client.Room?.Settings.PlaylistItemId)?.Equals(expectedSelectedItem) == true)
+                            applyCurrentItem();
+                    });
+                });
+            }
+            else
+                applyCurrentItem();
+
+            void applyCurrentItem() => SelectedItem.Value = expectedSelectedItem;
+        }
+
         private void handleRoomLost() => Schedule(() =>
         {
             if (this.IsCurrentScreen())
@@ -446,6 +482,9 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
             if (!this.IsCurrentScreen())
                 return;
 
+            if (client.Room == null)
+                return;
+
             if (!client.IsHost)
             {
                 // todo: should handle this when the request queue is implemented.
@@ -454,7 +493,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
                 return;
             }
 
-            this.Push(new MultiplayerMatchSongSelect(Room, SelectedItem.Value, beatmap, ruleset));
+            this.Push(new MultiplayerMatchSongSelect(Room, client.Room.Settings.PlaylistItemId, beatmap, ruleset));
         }
 
         protected override void Dispose(bool isDisposing)
diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
index d22f0415e6..d20d6b1d37 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
@@ -376,7 +376,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
         public override Task RemovePlaylistItem(long playlistItemId) => RemoveUserPlaylistItem(api.LocalUser.Value.OnlineID, playlistItemId);
 
-        protected override Task<APIBeatmap> GetAPIBeatmap(int beatmapId, CancellationToken cancellationToken = default)
+        public override Task<APIBeatmap> GetAPIBeatmap(int beatmapId, CancellationToken cancellationToken = default)
         {
             IBeatmapSetInfo? set = roomManager.ServerSideRooms.SelectMany(r => r.Playlist)
                                               .FirstOrDefault(p => p.BeatmapID == beatmapId)?.Beatmap.Value.BeatmapSet

From bc1f1f35b5a73dde39bfaab211300df330f5f7f3 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 10 Dec 2021 16:40:51 +0300
Subject: [PATCH 1626/5547] Remove now redundant inclusion of `TouchMoveEvent`
 in `OsuInputManager.Handle`

Now it's handled separately via the `HandleMouseTouchStateChange` override.
---
 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 f5fc3de381..57704b3bd8 100644
--- a/osu.Game.Rulesets.Osu/OsuInputManager.cs
+++ b/osu.Game.Rulesets.Osu/OsuInputManager.cs
@@ -35,7 +35,7 @@ namespace osu.Game.Rulesets.Osu
 
         protected override bool Handle(UIEvent e)
         {
-            if ((e is MouseMoveEvent || e is TouchMoveEvent) && !AllowUserCursorMovement) return false;
+            if (e is MouseMoveEvent && !AllowUserCursorMovement) return false;
 
             return base.Handle(e);
         }

From cf3041128888b4be5993728e8604c90df1cdd49b Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 10 Dec 2021 17:13:13 +0300
Subject: [PATCH 1627/5547] Revert "Remove now redundant inclusion of
 `TouchMoveEvent` in `OsuInputManager.Handle`"

This reverts commit bc1f1f35b5a73dde39bfaab211300df330f5f7f3.
---
 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 57704b3bd8..f5fc3de381 100644
--- a/osu.Game.Rulesets.Osu/OsuInputManager.cs
+++ b/osu.Game.Rulesets.Osu/OsuInputManager.cs
@@ -35,7 +35,7 @@ namespace osu.Game.Rulesets.Osu
 
         protected override bool Handle(UIEvent e)
         {
-            if (e is MouseMoveEvent && !AllowUserCursorMovement) return false;
+            if ((e is MouseMoveEvent || e is TouchMoveEvent) && !AllowUserCursorMovement) return false;
 
             return base.Handle(e);
         }

From 63a017bc8e43bbdc61db396047e100eaf9814d80 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Sat, 11 Dec 2021 19:33:37 +0900
Subject: [PATCH 1628/5547] Use Array.Empty instead

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

diff --git a/osu.Game/Screens/Edit/EditorLoader.cs b/osu.Game/Screens/Edit/EditorLoader.cs
index 27ae8ae497..15d70e28b6 100644
--- a/osu.Game/Screens/Edit/EditorLoader.cs
+++ b/osu.Game/Screens/Edit/EditorLoader.cs
@@ -60,7 +60,7 @@ namespace osu.Game.Screens.Edit
             base.LoadComplete();
 
             // will be restored via lease, see `DisallowExternalBeatmapRulesetChanges`.
-            Mods.Value = ArraySegment<Mod>.Empty;
+            Mods.Value = Array.Empty<Mod>();
         }
 
         protected virtual Editor CreateEditor() => new Editor(this);

From 25b274c323737c73de6d45d55a57096eec2faca8 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Sat, 11 Dec 2021 22:47:08 +0900
Subject: [PATCH 1629/5547] Fix starting gameplay too early after import

---
 .../Multiplayer/TestSceneMultiplayer.cs       | 40 +++++++++++--------
 .../Screens/OnlinePlay/Match/RoomSubScreen.cs |  8 ++--
 .../Multiplayer/MultiplayerMatchSubScreen.cs  | 21 ++++++++--
 3 files changed, 46 insertions(+), 23 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
index f20ab914e2..bc2902480d 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
@@ -391,9 +391,9 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 }
             });
 
-            AddStep("set user ready", () => client.ChangeState(MultiplayerUserState.Ready));
-            AddStep("delete beatmap", () => beatmaps.Delete(importedSet));
+            pressReadyButton();
 
+            AddStep("delete beatmap", () => beatmaps.Delete(importedSet));
             AddUntilStep("user state is idle", () => client.LocalUser?.State == MultiplayerUserState.Idle);
         }
 
@@ -413,6 +413,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 }
             });
 
+            pressReadyButton();
+
             AddStep("Enter song select", () =>
             {
                 var currentSubScreen = ((Screens.OnlinePlay.Multiplayer.Multiplayer)multiplayerScreenStack.CurrentScreen).CurrentSubScreen;
@@ -592,19 +594,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 }
             });
 
-            AddUntilStep("wait for ready button to be enabled", () => readyButton.ChildrenOfType<OsuButton>().Single().Enabled.Value);
-
-            AddStep("click ready button", () =>
-            {
-                InputManager.MoveMouseTo(readyButton);
-                InputManager.Click(MouseButton.Left);
-            });
-
-            AddUntilStep("wait for player to be ready", () => client.Room?.Users[0].State == MultiplayerUserState.Ready);
-            AddUntilStep("wait for ready button to be enabled", () => readyButton.ChildrenOfType<OsuButton>().Single().Enabled.Value);
-
-            AddStep("click start button", () => InputManager.Click(MouseButton.Left));
-
+            pressReadyButton();
+            pressReadyButton();
             AddUntilStep("wait for player", () => multiplayerScreenStack.CurrentScreen is Player);
 
             // Gameplay runs in real-time, so we need to incrementally check if gameplay has finished in order to not time out.
@@ -665,7 +656,24 @@ namespace osu.Game.Tests.Visual.Multiplayer
             });
         }
 
-        private MultiplayerReadyButton readyButton => this.ChildrenOfType<MultiplayerReadyButton>().Single();
+        private ReadyButton readyButton => this.ChildrenOfType<ReadyButton>().Single();
+
+        private void pressReadyButton()
+        {
+            AddUntilStep("wait for ready button to be enabled", () => readyButton.Enabled.Value);
+
+            MultiplayerUserState lastState = MultiplayerUserState.Idle;
+
+            AddStep("click ready button", () =>
+            {
+                lastState = client.LocalUser?.State ?? MultiplayerUserState.Idle;
+
+                InputManager.MoveMouseTo(readyButton);
+                InputManager.Click(MouseButton.Left);
+            });
+
+            AddUntilStep("wait for state change", () => client.LocalUser?.State != lastState);
+        }
 
         private void createRoom(Func<Room> room)
         {
diff --git a/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs b/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
index 55f5622afd..e5a6915ca3 100644
--- a/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
@@ -302,7 +302,7 @@ namespace osu.Game.Screens.OnlinePlay.Match
         public override void OnResuming(IScreen last)
         {
             base.OnResuming(last);
-            updateWorkingBeatmap();
+            UpdateWorkingBeatmap();
             beginHandlingTrack();
             Scheduler.AddOnce(UpdateMods);
         }
@@ -345,7 +345,7 @@ namespace osu.Game.Screens.OnlinePlay.Match
 
         private void selectedItemChanged()
         {
-            updateWorkingBeatmap();
+            UpdateWorkingBeatmap();
 
             var selected = SelectedItem.Value;
 
@@ -374,9 +374,9 @@ namespace osu.Game.Screens.OnlinePlay.Match
             }
         }
 
-        private void beatmapUpdated(BeatmapSetInfo set) => Schedule(updateWorkingBeatmap);
+        private void beatmapUpdated(BeatmapSetInfo set) => Schedule(UpdateWorkingBeatmap);
 
-        private void updateWorkingBeatmap()
+        protected virtual void UpdateWorkingBeatmap()
         {
             var beatmap = SelectedItem.Value?.Beatmap.Value;
 
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
index 3543836d8d..b517142069 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
@@ -15,6 +15,7 @@ using osu.Framework.Screens;
 using osu.Framework.Threading;
 using osu.Game.Beatmaps;
 using osu.Game.Configuration;
+using osu.Game.Extensions;
 using osu.Game.Online;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Rooms;
@@ -326,10 +327,24 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
                 if (client.LocalUser?.State == MultiplayerUserState.Ready)
                     client.ChangeState(MultiplayerUserState.Idle);
             }
-            else
+        }
+
+        protected override void UpdateWorkingBeatmap()
+        {
+            var lastBeatmap = Beatmap.Value;
+
+            base.UpdateWorkingBeatmap();
+
+            if (Beatmap.Value.BeatmapInfo.MatchesOnlineID(lastBeatmap.BeatmapInfo))
+                return;
+
+            if (!Beatmap.Value.BeatmapInfo.MatchesOnlineID(SelectedItem.Value?.Beatmap.Value))
+                return;
+
+            if (client.LocalUser?.State == MultiplayerUserState.Spectating
+                && (client.Room?.State == MultiplayerRoomState.WaitingForLoad || client.Room?.State == MultiplayerRoomState.Playing))
             {
-                if (client.LocalUser?.State == MultiplayerUserState.Spectating && (client.Room?.State == MultiplayerRoomState.WaitingForLoad || client.Room?.State == MultiplayerRoomState.Playing))
-                    onLoadRequested();
+                onLoadRequested();
             }
         }
 

From ece2cddb7fd11171450b336bcf049efff3b28d38 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Sat, 11 Dec 2021 22:51:20 +0900
Subject: [PATCH 1630/5547] Fix DrawableRoomPlaylistItem lookup interfering
 with tests

---
 .../Screens/OnlinePlay/DrawableRoomPlaylistItem.cs | 14 +++++++++++++-
 1 file changed, 13 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
index 8042f7d772..a877c6aca9 100644
--- a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
+++ b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
@@ -5,6 +5,7 @@ using System;
 using System.Collections.Generic;
 using System.Linq;
 using System.Threading.Tasks;
+using JetBrains.Annotations;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
@@ -24,6 +25,7 @@ using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Online;
 using osu.Game.Online.Chat;
+using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Rooms;
 using osu.Game.Overlays.BeatmapSet;
 using osu.Game.Rulesets;
@@ -90,6 +92,10 @@ namespace osu.Game.Screens.OnlinePlay
         [Resolved]
         private UserLookupCache userLookupCache { get; set; }
 
+        [CanBeNull]
+        [Resolved(CanBeNull = true)]
+        private MultiplayerClient multiplayerClient { get; set; }
+
         [Resolved]
         private BeatmapLookupCache beatmapLookupCache { get; set; }
 
@@ -157,7 +163,13 @@ namespace osu.Game.Screens.OnlinePlay
 
                         if (Item.Beatmap.Value == null)
                         {
-                            var foundBeatmap = await beatmapLookupCache.GetBeatmapAsync(Item.BeatmapID).ConfigureAwait(false);
+                            IBeatmapInfo foundBeatmap;
+
+                            if (multiplayerClient != null)
+                                foundBeatmap = await multiplayerClient.GetAPIBeatmap(Item.BeatmapID).ConfigureAwait(false);
+                            else
+                                foundBeatmap = await beatmapLookupCache.GetBeatmapAsync(Item.BeatmapID).ConfigureAwait(false);
+
                             Schedule(() => Item.Beatmap.Value = foundBeatmap);
                         }
                     }

From 99cd36d2f611eea89ae74591b6ba37fb16cac9f9 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Sat, 11 Dec 2021 22:52:06 +0900
Subject: [PATCH 1631/5547] Resolve some test failures due to async population

---
 .../Visual/Multiplayer/TestSceneAllPlayersQueueMode.cs          | 2 +-
 osu.Game.Tests/Visual/Multiplayer/TestSceneHostOnlyQueueMode.cs | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneAllPlayersQueueMode.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneAllPlayersQueueMode.cs
index 4bf38c9ff8..a5744f9986 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneAllPlayersQueueMode.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneAllPlayersQueueMode.cs
@@ -80,7 +80,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         public void TestCorrectItemSelectedAfterNewItemAdded()
         {
             addItem(() => OtherBeatmap);
-            AddAssert("selected beatmap is initial beatmap", () => Beatmap.Value.BeatmapInfo.OnlineID == InitialBeatmap.OnlineID);
+            AddUntilStep("selected beatmap is initial beatmap", () => Beatmap.Value.BeatmapInfo.OnlineID == InitialBeatmap.OnlineID);
         }
 
         private void addItem(Func<BeatmapInfo> beatmap)
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneHostOnlyQueueMode.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneHostOnlyQueueMode.cs
index c06bd8fdbe..ac1efdda4a 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneHostOnlyQueueMode.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneHostOnlyQueueMode.cs
@@ -97,7 +97,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddStep("select other beatmap", () => ((Screens.Select.SongSelect)CurrentSubScreen).FinaliseSelection(otherBeatmap = beatmap()));
 
             AddUntilStep("wait for return to match", () => CurrentSubScreen is MultiplayerMatchSubScreen);
-            AddUntilStep("selected item is new beatmap", () => (CurrentSubScreen as MultiplayerMatchSubScreen)?.SelectedItem.Value.BeatmapID == otherBeatmap.OnlineID);
+            AddUntilStep("selected item is new beatmap", () => (CurrentSubScreen as MultiplayerMatchSubScreen)?.SelectedItem.Value?.BeatmapID == otherBeatmap.OnlineID);
         }
 
         private void addItem(Func<BeatmapInfo> beatmap)

From d6c08fae48dccfd80d2bd003f3b8119130a171ca Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Sat, 11 Dec 2021 23:08:17 +0900
Subject: [PATCH 1632/5547] Fix incorrect global beatmap with availability
 changes

---
 osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs         | 7 +++++++
 .../OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs    | 2 ++
 2 files changed, 9 insertions(+)

diff --git a/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs b/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
index e5a6915ca3..6b395058fa 100644
--- a/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
@@ -15,6 +15,7 @@ using osu.Framework.Graphics.Shapes;
 using osu.Framework.Screens;
 using osu.Game.Audio;
 using osu.Game.Beatmaps;
+using osu.Game.Online;
 using osu.Game.Online.Rooms;
 using osu.Game.Overlays;
 using osu.Game.Overlays.Mods;
@@ -378,6 +379,12 @@ namespace osu.Game.Screens.OnlinePlay.Match
 
         protected virtual void UpdateWorkingBeatmap()
         {
+            if (BeatmapAvailability.Value.State != DownloadState.LocallyAvailable)
+            {
+                Beatmap.Value = beatmapManager.GetWorkingBeatmap(null);
+                return;
+            }
+
             var beatmap = SelectedItem.Value?.Beatmap.Value;
 
             // Retrieve the corresponding local beatmap, since we can't directly use the playlist's beatmap info
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
index b517142069..65190101b8 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
@@ -327,6 +327,8 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
                 if (client.LocalUser?.State == MultiplayerUserState.Ready)
                     client.ChangeState(MultiplayerUserState.Idle);
             }
+
+            UpdateWorkingBeatmap();
         }
 
         protected override void UpdateWorkingBeatmap()

From 9f792fec49366e8ac3cc9d31a4f8c0bc214d50c6 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Sun, 12 Dec 2021 16:11:48 +0900
Subject: [PATCH 1633/5547] Fix test failures from async item loading

---
 .../Visual/Multiplayer/TestSceneHostOnlyQueueMode.cs       | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneHostOnlyQueueMode.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneHostOnlyQueueMode.cs
index ac1efdda4a..c7eeff81fe 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneHostOnlyQueueMode.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneHostOnlyQueueMode.cs
@@ -9,6 +9,7 @@ using osu.Game.Beatmaps;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Screens.OnlinePlay;
 using osu.Game.Screens.OnlinePlay.Multiplayer;
+using osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist;
 using osuTK.Input;
 
 namespace osu.Game.Tests.Visual.Multiplayer
@@ -85,6 +86,12 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
         private void selectNewItem(Func<BeatmapInfo> beatmap)
         {
+            AddUntilStep("wait for playlist panels to load", () =>
+            {
+                var queueList = this.ChildrenOfType<MultiplayerQueueList>().Single();
+                return queueList.ChildrenOfType<DrawableRoomPlaylistItem>().Count() == queueList.Items.Count;
+            });
+
             AddStep("click edit button", () =>
             {
                 InputManager.MoveMouseTo(this.ChildrenOfType<DrawableRoomPlaylistItem.PlaylistEditButton>().First());

From a6e77f172d30e4f4f0126f20f0ad95197549906a Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Sun, 12 Dec 2021 16:30:37 +0900
Subject: [PATCH 1634/5547] Add some comments

---
 .../OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs      | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
index 65190101b8..4fa21cb847 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
@@ -337,9 +337,12 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
 
             base.UpdateWorkingBeatmap();
 
+            // Nothing to do if the beatmap hasn't changed.
             if (Beatmap.Value.BeatmapInfo.MatchesOnlineID(lastBeatmap.BeatmapInfo))
                 return;
 
+            // The selected item is nulled during the beatmap query. During this, the working beatmap will be the dummy beatmap.
+            // We don't want to enter spectate mode with the dummy beatmap.
             if (!Beatmap.Value.BeatmapInfo.MatchesOnlineID(SelectedItem.Value?.Beatmap.Value))
                 return;
 
@@ -421,9 +424,11 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
             if (expectedSelectedItem == null)
                 return;
 
+            // There's no reason to renew the selected item if its content hasn't changed.
             if (SelectedItem.Value?.Equals(expectedSelectedItem) == true && expectedSelectedItem.Beatmap.Value != null)
                 return;
 
+            // Clear the selected item while the lookup is performed, so components like the ready button can enter their disabled states.
             SelectedItem.Value = null;
 
             if (expectedSelectedItem.Beatmap.Value == null)

From 2cd2b10ce1b1fd705a5d63fe007aba821745a5d4 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Mon, 13 Dec 2021 06:54:57 +0900
Subject: [PATCH 1635/5547] Fix results sometimes showing incorrect score
 position

---
 .../TestScenePlaylistsResultsScreen.cs        |  5 ++++-
 .../Playlists/PlaylistsResultsScreen.cs       |  7 +++++++
 .../Contracted/ContractedPanelTopContent.cs   | 20 +++++++++++-------
 osu.Game/Screens/Ranking/ScorePanel.cs        | 21 +++++++++++++++----
 4 files changed, 41 insertions(+), 12 deletions(-)

diff --git a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsResultsScreen.cs b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsResultsScreen.cs
index 4ac3b7c733..64fc4797a0 100644
--- a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsResultsScreen.cs
+++ b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsResultsScreen.cs
@@ -28,6 +28,7 @@ namespace osu.Game.Tests.Visual.Playlists
     public class TestScenePlaylistsResultsScreen : ScreenTestScene
     {
         private const int scores_per_result = 10;
+        private const int real_user_position = 200;
 
         private TestResultsScreen resultsScreen;
 
@@ -58,6 +59,8 @@ namespace osu.Game.Tests.Visual.Playlists
             createResults(() => userScore);
 
             AddAssert("user score selected", () => this.ChildrenOfType<ScorePanel>().Single(p => p.Score.OnlineID == userScore.OnlineID).State == PanelState.Expanded);
+            AddAssert($"score panel position is {real_user_position}",
+                () => this.ChildrenOfType<ScorePanel>().Single(p => p.Score.OnlineID == userScore.OnlineID).ScorePosition.Value == real_user_position);
         }
 
         [Test]
@@ -236,7 +239,7 @@ namespace osu.Game.Tests.Visual.Playlists
                 EndedAt = userScore.Date,
                 Passed = userScore.Passed,
                 Rank = userScore.Rank,
-                Position = 200,
+                Position = real_user_position,
                 MaxCombo = userScore.MaxCombo,
                 TotalScore = userScore.TotalScore,
                 User = userScore.User,
diff --git a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsResultsScreen.cs b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsResultsScreen.cs
index 67727ef784..1e6722d51e 100644
--- a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsResultsScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsResultsScreen.cs
@@ -87,6 +87,13 @@ namespace osu.Game.Screens.OnlinePlay.Playlists
             {
                 var allScores = new List<MultiplayerScore> { userScore };
 
+                // Other scores could have arrived between score submission and entering the results screen. Ensure the local player score position is up to date.
+                if (Score != null)
+                {
+                    Score.Position = userScore.Position;
+                    ScorePanelList.GetPanelForScore(Score).ScorePosition.Value = userScore.Position;
+                }
+
                 if (userScore.ScoresAround?.Higher != null)
                 {
                     allScores.AddRange(userScore.ScoresAround.Higher.Scores);
diff --git a/osu.Game/Screens/Ranking/Contracted/ContractedPanelTopContent.cs b/osu.Game/Screens/Ranking/Contracted/ContractedPanelTopContent.cs
index 0935ee7fb2..beff509dc6 100644
--- a/osu.Game/Screens/Ranking/Contracted/ContractedPanelTopContent.cs
+++ b/osu.Game/Screens/Ranking/Contracted/ContractedPanelTopContent.cs
@@ -2,36 +2,42 @@
 // 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.Game.Graphics;
 using osu.Game.Graphics.Sprites;
-using osu.Game.Scoring;
 
 namespace osu.Game.Screens.Ranking.Contracted
 {
     public class ContractedPanelTopContent : CompositeDrawable
     {
-        private readonly ScoreInfo score;
+        public readonly Bindable<int?> ScorePosition = new Bindable<int?>();
 
-        public ContractedPanelTopContent(ScoreInfo score)
+        private OsuSpriteText text;
+
+        public ContractedPanelTopContent()
         {
-            this.score = score;
-
             RelativeSizeAxes = Axes.Both;
         }
 
         [BackgroundDependencyLoader]
         private void load()
         {
-            InternalChild = new OsuSpriteText
+            InternalChild = text = new OsuSpriteText
             {
                 Anchor = Anchor.TopCentre,
                 Origin = Anchor.TopCentre,
                 Y = 6,
-                Text = score.Position != null ? $"#{score.Position}" : string.Empty,
                 Font = OsuFont.GetFont(size: 18, weight: FontWeight.Bold)
             };
         }
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            ScorePosition.BindValueChanged(pos => text.Text = pos.NewValue != null ? $"#{pos.NewValue}" : string.Empty, true);
+        }
     }
 }
diff --git a/osu.Game/Screens/Ranking/ScorePanel.cs b/osu.Game/Screens/Ranking/ScorePanel.cs
index 6ddecf8297..bc6eb9e366 100644
--- a/osu.Game/Screens/Ranking/ScorePanel.cs
+++ b/osu.Game/Screens/Ranking/ScorePanel.cs
@@ -4,6 +4,7 @@
 using System;
 using osu.Framework;
 using osu.Framework.Allocation;
+using osu.Framework.Bindables;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Colour;
@@ -78,6 +79,11 @@ namespace osu.Game.Screens.Ranking
 
         public event Action<PanelState> StateChanged;
 
+        /// <summary>
+        /// The position of the score in the rankings.
+        /// </summary>
+        public readonly Bindable<int?> ScorePosition = new Bindable<int?>();
+
         /// <summary>
         /// An action to be invoked if this <see cref="ScorePanel"/> is clicked while in an expanded state.
         /// </summary>
@@ -103,6 +109,8 @@ namespace osu.Game.Screens.Ranking
         {
             Score = score;
             displayWithFlair = isNewLocalScore;
+
+            ScorePosition.Value = score.Position;
         }
 
         [BackgroundDependencyLoader]
@@ -211,8 +219,8 @@ namespace osu.Game.Screens.Ranking
                     topLayerBackground.FadeColour(expanded_top_layer_colour, RESIZE_DURATION, Easing.OutQuint);
                     middleLayerBackground.FadeColour(expanded_middle_layer_colour, RESIZE_DURATION, Easing.OutQuint);
 
-                    topLayerContentContainer.Add(topLayerContent = new ExpandedPanelTopContent(Score.User).With(d => d.Alpha = 0));
-                    middleLayerContentContainer.Add(middleLayerContent = new ExpandedPanelMiddleContent(Score, displayWithFlair).With(d => d.Alpha = 0));
+                    topLayerContentContainer.Add(topLayerContent = new ExpandedPanelTopContent(Score.User) { Alpha = 0 });
+                    middleLayerContentContainer.Add(middleLayerContent = new ExpandedPanelMiddleContent(Score, displayWithFlair) { Alpha = 0 });
 
                     // only the first expanded display should happen with flair.
                     displayWithFlair = false;
@@ -224,8 +232,13 @@ namespace osu.Game.Screens.Ranking
                     topLayerBackground.FadeColour(contracted_top_layer_colour, RESIZE_DURATION, Easing.OutQuint);
                     middleLayerBackground.FadeColour(contracted_middle_layer_colour, RESIZE_DURATION, Easing.OutQuint);
 
-                    topLayerContentContainer.Add(topLayerContent = new ContractedPanelTopContent(Score).With(d => d.Alpha = 0));
-                    middleLayerContentContainer.Add(middleLayerContent = new ContractedPanelMiddleContent(Score).With(d => d.Alpha = 0));
+                    topLayerContentContainer.Add(topLayerContent = new ContractedPanelTopContent
+                    {
+                        ScorePosition = { BindTarget = ScorePosition },
+                        Alpha = 0
+                    });
+
+                    middleLayerContentContainer.Add(middleLayerContent = new ContractedPanelMiddleContent(Score) { Alpha = 0 });
                     break;
             }
 

From fd979a52fef9597b7e732bc8a1750723168fc520 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Mon, 13 Dec 2021 07:15:21 +0900
Subject: [PATCH 1636/5547] Increase score submission request timeout to 60s

---
 osu.Game/Online/Rooms/SubmitRoomScoreRequest.cs | 1 +
 osu.Game/Online/Solo/SubmitSoloScoreRequest.cs  | 1 +
 2 files changed, 2 insertions(+)

diff --git a/osu.Game/Online/Rooms/SubmitRoomScoreRequest.cs b/osu.Game/Online/Rooms/SubmitRoomScoreRequest.cs
index d5da6c401c..4ee4be6164 100644
--- a/osu.Game/Online/Rooms/SubmitRoomScoreRequest.cs
+++ b/osu.Game/Online/Rooms/SubmitRoomScoreRequest.cs
@@ -31,6 +31,7 @@ namespace osu.Game.Online.Rooms
 
             req.ContentType = "application/json";
             req.Method = HttpMethod.Put;
+            req.Timeout = 60000;
 
             req.AddRaw(JsonConvert.SerializeObject(score, new JsonSerializerSettings
             {
diff --git a/osu.Game/Online/Solo/SubmitSoloScoreRequest.cs b/osu.Game/Online/Solo/SubmitSoloScoreRequest.cs
index 25c2e5a61f..763fcf3f20 100644
--- a/osu.Game/Online/Solo/SubmitSoloScoreRequest.cs
+++ b/osu.Game/Online/Solo/SubmitSoloScoreRequest.cs
@@ -31,6 +31,7 @@ namespace osu.Game.Online.Solo
 
             req.ContentType = "application/json";
             req.Method = HttpMethod.Put;
+            req.Timeout = 60000;
 
             req.AddRaw(JsonConvert.SerializeObject(score, new JsonSerializerSettings
             {

From d0fbbf110b74761e210937b94fd2f8bffd6bb5b9 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Mon, 13 Dec 2021 06:48:15 +0300
Subject: [PATCH 1637/5547] Expose `ScreenContainer` for access in
 `OsuGameDesktop`

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

diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index 565ee7e71d..a35191613c 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -103,7 +103,7 @@ namespace osu.Game
 
         private Container topMostOverlayContent;
 
-        private ScalingContainer screenContainer;
+        protected ScalingContainer ScreenContainer { get; private set; }
 
         protected Container ScreenOffsetContainer { get; private set; }
 
@@ -179,7 +179,7 @@ namespace osu.Game
         }
 
         private void updateBlockingOverlayFade() =>
-            screenContainer.FadeColour(visibleBlockingOverlays.Any() ? OsuColour.Gray(0.5f) : Color4.White, 500, Easing.OutQuint);
+            ScreenContainer.FadeColour(visibleBlockingOverlays.Any() ? OsuColour.Gray(0.5f) : Color4.White, 500, Easing.OutQuint);
 
         public void AddBlockingOverlay(OverlayContainer overlay)
         {
@@ -698,7 +698,7 @@ namespace osu.Game
                     RelativeSizeAxes = Axes.Both,
                     Children = new Drawable[]
                     {
-                        screenContainer = new ScalingContainer(ScalingMode.ExcludeOverlays)
+                        ScreenContainer = new ScalingContainer(ScalingMode.ExcludeOverlays)
                         {
                             RelativeSizeAxes = Axes.Both,
                             Anchor = Anchor.Centre,
@@ -801,7 +801,7 @@ namespace osu.Game
             loadComponentSingleFile(userProfile = new UserProfileOverlay(), overlayContent.Add, true);
             loadComponentSingleFile(beatmapSetOverlay = new BeatmapSetOverlay(), overlayContent.Add, true);
             loadComponentSingleFile(wikiOverlay = new WikiOverlay(), overlayContent.Add, true);
-            loadComponentSingleFile(skinEditor = new SkinEditorOverlay(screenContainer), overlayContent.Add, true);
+            loadComponentSingleFile(skinEditor = new SkinEditorOverlay(ScreenContainer), overlayContent.Add, true);
 
             loadComponentSingleFile(new LoginOverlay
             {

From d92f5039cd78edf204e9b40ede9f72869191019f Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Mon, 13 Dec 2021 06:48:40 +0300
Subject: [PATCH 1638/5547] Reorder version overlay to display behind game-wide
 overlays

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

diff --git a/osu.Desktop/OsuGameDesktop.cs b/osu.Desktop/OsuGameDesktop.cs
index 645ea66654..b234207848 100644
--- a/osu.Desktop/OsuGameDesktop.cs
+++ b/osu.Desktop/OsuGameDesktop.cs
@@ -70,7 +70,9 @@ namespace osu.Desktop
                     if (!string.IsNullOrEmpty(stableInstallPath) && checkExists(stableInstallPath))
                         return stableInstallPath;
                 }
-                catch { }
+                catch
+                {
+                }
             }
 
             stableInstallPath = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.LocalApplicationData), @"osu!");
@@ -113,7 +115,7 @@ namespace osu.Desktop
             base.LoadComplete();
 
             if (!noVersionOverlay)
-                LoadComponentAsync(versionManager = new VersionManager { Depth = int.MinValue }, Add);
+                LoadComponentAsync(versionManager = new VersionManager { Depth = int.MinValue }, ScreenContainer.Add);
 
             LoadComponentAsync(new DiscordRichPresence(), Add);
 

From c097dc80488ff45357b33eb907c12bb8a34629db Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 13 Dec 2021 13:39:32 +0900
Subject: [PATCH 1639/5547] Add note about reasoning behind
 `MultiplayerClient.GetAPIBeatmap` call

---
 osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
index a877c6aca9..e1f7ea5e92 100644
--- a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
+++ b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
@@ -166,6 +166,8 @@ namespace osu.Game.Screens.OnlinePlay
                             IBeatmapInfo foundBeatmap;
 
                             if (multiplayerClient != null)
+                                // This call can eventually go away (and use the else case below).
+                                // Currently required only due to the method being overridden to provide special behaviour in tests.
                                 foundBeatmap = await multiplayerClient.GetAPIBeatmap(Item.BeatmapID).ConfigureAwait(false);
                             else
                                 foundBeatmap = await beatmapLookupCache.GetBeatmapAsync(Item.BeatmapID).ConfigureAwait(false);

From cac684c0448d69f5a3d427c7b0a375e5266dd93a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 13 Dec 2021 14:46:49 +0900
Subject: [PATCH 1640/5547] Improve appearance of player-wide background after
 failing with low background dim

---
 osu.Game/Screens/Play/FailAnimation.cs | 10 ++++++++++
 osu.Game/Screens/Play/Player.cs        |  2 ++
 2 files changed, 12 insertions(+)

diff --git a/osu.Game/Screens/Play/FailAnimation.cs b/osu.Game/Screens/Play/FailAnimation.cs
index 193e1e4129..aa777f18a8 100644
--- a/osu.Game/Screens/Play/FailAnimation.cs
+++ b/osu.Game/Screens/Play/FailAnimation.cs
@@ -6,6 +6,7 @@ using osu.Framework.Bindables;
 using osu.Game.Rulesets.UI;
 using System;
 using System.Collections.Generic;
+using JetBrains.Annotations;
 using ManagedBass.Fx;
 using osu.Framework.Allocation;
 using osu.Framework.Audio.Sample;
@@ -18,6 +19,7 @@ using osu.Framework.Utils;
 using osu.Game.Audio.Effects;
 using osu.Game.Beatmaps;
 using osu.Game.Configuration;
+using osu.Game.Graphics;
 using osu.Game.Rulesets.Objects.Drawables;
 using osuTK;
 using osuTK.Graphics;
@@ -58,6 +60,12 @@ namespace osu.Game.Screens.Play
             RelativeSizeAxes = Axes.Both,
         };
 
+        /// <summary>
+        /// The player screen background, used to adjust appearance on failing.
+        /// </summary>
+        [CanBeNull]
+        public BackgroundScreen Background { private get; set; }
+
         public FailAnimation(DrawableRuleset drawableRuleset)
         {
             this.drawableRuleset = drawableRuleset;
@@ -136,6 +144,8 @@ namespace osu.Game.Screens.Play
             Content.ScaleTo(0.85f, duration, Easing.OutQuart);
             Content.RotateTo(1, duration, Easing.OutQuart);
             Content.FadeColour(Color4.Gray, duration);
+
+            Background?.FadeColour(OsuColour.Gray(0.3f), 60);
         }
 
         public void RemoveFilters(bool resetTrackFrequency = true)
diff --git a/osu.Game/Screens/Play/Player.cs b/osu.Game/Screens/Play/Player.cs
index e2896c174f..745e1f9e7c 100644
--- a/osu.Game/Screens/Play/Player.cs
+++ b/osu.Game/Screens/Play/Player.cs
@@ -921,6 +921,8 @@ namespace osu.Game.Screens.Play
                 b.IsBreakTime.BindTo(breakTracker.IsBreakTime);
 
                 b.StoryboardReplacesBackground.BindTo(storyboardReplacesBackground);
+
+                failAnimationLayer.Background = b;
             });
 
             HUDOverlay.IsBreakTime.BindTo(breakTracker.IsBreakTime);

From 4cac87e93323a46752fb2353ed41488ba0f332b7 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 13 Dec 2021 15:26:32 +0900
Subject: [PATCH 1641/5547] Add test coverage showing that `KeyBindingStore`
 won't remove excess key bindings

---
 .../Database/TestRealmKeyBindingStore.cs      | 39 +++++++++++++++++++
 1 file changed, 39 insertions(+)

diff --git a/osu.Game.Tests/Database/TestRealmKeyBindingStore.cs b/osu.Game.Tests/Database/TestRealmKeyBindingStore.cs
index 860828ae81..f05d9ab3dc 100644
--- a/osu.Game.Tests/Database/TestRealmKeyBindingStore.cs
+++ b/osu.Game.Tests/Database/TestRealmKeyBindingStore.cs
@@ -52,6 +52,45 @@ namespace osu.Game.Tests.Database
             Assert.That(queryCount(GlobalAction.Select), Is.EqualTo(2));
         }
 
+        [Test]
+        public void TestDefaultsPopulationRemovesExcess()
+        {
+            Assert.That(queryCount(), Is.EqualTo(0));
+
+            KeyBindingContainer testContainer = new TestKeyBindingContainer();
+
+            // Add some excess bindings for an action which only supports 1.
+            using (var realm = realmContextFactory.CreateContext())
+            using (var transaction = realm.BeginWrite())
+            {
+                realm.Add(new RealmKeyBinding
+                {
+                    Action = GlobalAction.Back,
+                    KeyCombination = new KeyCombination(InputKey.A)
+                });
+
+                realm.Add(new RealmKeyBinding
+                {
+                    Action = GlobalAction.Back,
+                    KeyCombination = new KeyCombination(InputKey.S)
+                });
+
+                realm.Add(new RealmKeyBinding
+                {
+                    Action = GlobalAction.Back,
+                    KeyCombination = new KeyCombination(InputKey.D)
+                });
+
+                transaction.Commit();
+            }
+
+            Assert.That(queryCount(GlobalAction.Back), Is.EqualTo(3));
+
+            keyBindingStore.Register(testContainer, Enumerable.Empty<RulesetInfo>());
+
+            Assert.That(queryCount(GlobalAction.Back), Is.EqualTo(1));
+        }
+
         private int queryCount(GlobalAction? match = null)
         {
             using (var realm = realmContextFactory.CreateContext())

From 7318ff3f98cee2e689d1f20ea736a8ec6b4fdd3d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 13 Dec 2021 15:26:49 +0900
Subject: [PATCH 1642/5547] Refactor `KeyBindingStore` to clean up any excess
 bindings for individual actions

While this isn't strictly required (outside of rulesets, potentially),
I think it's best that we keep these counts in a sane state.

Right now, it will remove any excess. Arguably, in the case an entry is
found with too many, we should wipe all entries and re-populate the
defaults. Interested in opinions on that before merging. See
https://github.com/ppy/osu/discussions/15925 for an example where wiping
may be the more appropriate behaviour.
---
 osu.Game/Input/RealmKeyBindingStore.cs | 39 ++++++++++++++++++--------
 1 file changed, 28 insertions(+), 11 deletions(-)

diff --git a/osu.Game/Input/RealmKeyBindingStore.cs b/osu.Game/Input/RealmKeyBindingStore.cs
index 3bdb0a180d..cb51797685 100644
--- a/osu.Game/Input/RealmKeyBindingStore.cs
+++ b/osu.Game/Input/RealmKeyBindingStore.cs
@@ -81,20 +81,37 @@ namespace osu.Game.Input
             // compare counts in database vs defaults for each action type.
             foreach (var defaultsForAction in defaults.GroupBy(k => k.Action))
             {
-                // avoid performing redundant queries when the database is empty and needs to be re-filled.
-                int existingCount = existingBindings.Count(k => k.RulesetName == rulesetName && k.Variant == variant && k.ActionInt == (int)defaultsForAction.Key);
+                IEnumerable<RealmKeyBinding> existing = existingBindings.Where(k =>
+                    k.RulesetName == rulesetName
+                    && k.Variant == variant
+                    && k.ActionInt == (int)defaultsForAction.Key);
 
-                if (defaultsForAction.Count() <= existingCount)
-                    continue;
+                int defaultsCount = defaultsForAction.Count();
+                int existingCount = existing.Count();
 
-                // insert any defaults which are missing.
-                realm.Add(defaultsForAction.Skip(existingCount).Select(k => new RealmKeyBinding
+                if (defaultsCount > existingCount)
                 {
-                    KeyCombinationString = k.KeyCombination.ToString(),
-                    ActionInt = (int)k.Action,
-                    RulesetName = rulesetName,
-                    Variant = variant
-                }));
+                    // insert any defaults which are missing.
+                    realm.Add(defaultsForAction.Skip(existingCount).Select(k => new RealmKeyBinding
+                    {
+                        KeyCombinationString = k.KeyCombination.ToString(),
+                        ActionInt = (int)k.Action,
+                        RulesetName = rulesetName,
+                        Variant = variant
+                    }));
+                }
+                else if (defaultsCount < existingCount)
+                {
+                    // generally this shouldn't happen, but if the user has more key bindings for an action than we expect,
+                    // remove the last entries until the count matches for sanity.
+                    foreach (var k in existing.TakeLast(existingCount - defaultsCount).ToArray())
+                    {
+                        realm.Remove(k);
+
+                        // Remove from the local flattened/cached list so future lookups don't query now deleted rows.
+                        existingBindings.Remove(k);
+                    }
+                }
             }
         }
 

From 70045494babd97eec564f624e3a5a38a1019ebdc Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Mon, 13 Dec 2021 16:09:53 +0900
Subject: [PATCH 1643/5547] Re-simplify code by removing BeatmapManager event
 instead

---
 .../Screens/OnlinePlay/Match/RoomSubScreen.cs | 36 ++++---------------
 .../Multiplayer/MultiplayerMatchSubScreen.cs  | 24 ++-----------
 2 files changed, 9 insertions(+), 51 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs b/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
index 6b395058fa..a560d85b7d 100644
--- a/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
@@ -15,7 +15,6 @@ using osu.Framework.Graphics.Shapes;
 using osu.Framework.Screens;
 using osu.Game.Audio;
 using osu.Game.Beatmaps;
-using osu.Game.Online;
 using osu.Game.Online.Rooms;
 using osu.Game.Overlays;
 using osu.Game.Overlays.Mods;
@@ -68,7 +67,7 @@ namespace osu.Game.Screens.OnlinePlay.Match
         protected OnlinePlayScreen ParentScreen { get; private set; }
 
         [Cached]
-        private OnlinePlayBeatmapAvailabilityTracker beatmapAvailabilityTracker { get; set; }
+        private readonly OnlinePlayBeatmapAvailabilityTracker beatmapAvailabilityTracker = new OnlinePlayBeatmapAvailabilityTracker();
 
         protected IBindable<BeatmapAvailability> BeatmapAvailability => beatmapAvailabilityTracker.Availability;
 
@@ -91,11 +90,6 @@ namespace osu.Game.Screens.OnlinePlay.Match
 
             Padding = new MarginPadding { Top = Header.HEIGHT };
 
-            beatmapAvailabilityTracker = new OnlinePlayBeatmapAvailabilityTracker
-            {
-                SelectedItem = { BindTarget = SelectedItem }
-            };
-
             RoomId.BindTo(room.RoomID);
         }
 
@@ -248,10 +242,10 @@ namespace osu.Game.Screens.OnlinePlay.Match
             }, true);
 
             SelectedItem.BindValueChanged(_ => Scheduler.AddOnce(selectedItemChanged));
-
-            beatmapManager.ItemUpdated += beatmapUpdated;
-
             UserMods.BindValueChanged(_ => Scheduler.AddOnce(UpdateMods));
+
+            beatmapAvailabilityTracker.SelectedItem.BindTo(SelectedItem);
+            beatmapAvailabilityTracker.Availability.BindValueChanged(_ => updateWorkingBeatmap());
         }
 
         protected override IReadOnlyDependencyContainer CreateChildDependencies(IReadOnlyDependencyContainer parent)
@@ -303,7 +297,7 @@ namespace osu.Game.Screens.OnlinePlay.Match
         public override void OnResuming(IScreen last)
         {
             base.OnResuming(last);
-            UpdateWorkingBeatmap();
+            updateWorkingBeatmap();
             beginHandlingTrack();
             Scheduler.AddOnce(UpdateMods);
         }
@@ -346,7 +340,7 @@ namespace osu.Game.Screens.OnlinePlay.Match
 
         private void selectedItemChanged()
         {
-            UpdateWorkingBeatmap();
+            updateWorkingBeatmap();
 
             var selected = SelectedItem.Value;
 
@@ -375,16 +369,8 @@ namespace osu.Game.Screens.OnlinePlay.Match
             }
         }
 
-        private void beatmapUpdated(BeatmapSetInfo set) => Schedule(UpdateWorkingBeatmap);
-
-        protected virtual void UpdateWorkingBeatmap()
+        private void updateWorkingBeatmap()
         {
-            if (BeatmapAvailability.Value.State != DownloadState.LocallyAvailable)
-            {
-                Beatmap.Value = beatmapManager.GetWorkingBeatmap(null);
-                return;
-            }
-
             var beatmap = SelectedItem.Value?.Beatmap.Value;
 
             // Retrieve the corresponding local beatmap, since we can't directly use the playlist's beatmap info
@@ -450,14 +436,6 @@ namespace osu.Game.Screens.OnlinePlay.Match
         /// <param name="room">The room to change the settings of.</param>
         protected abstract RoomSettingsOverlay CreateRoomSettingsOverlay(Room room);
 
-        protected override void Dispose(bool isDisposing)
-        {
-            base.Dispose(isDisposing);
-
-            if (beatmapManager != null)
-                beatmapManager.ItemUpdated -= beatmapUpdated;
-        }
-
         public class UserModSelectButton : PurpleTriangleButton
         {
         }
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
index 4fa21cb847..6895608c8e 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
@@ -15,7 +15,6 @@ using osu.Framework.Screens;
 using osu.Framework.Threading;
 using osu.Game.Beatmaps;
 using osu.Game.Configuration;
-using osu.Game.Extensions;
 using osu.Game.Online;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Rooms;
@@ -327,27 +326,8 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
                 if (client.LocalUser?.State == MultiplayerUserState.Ready)
                     client.ChangeState(MultiplayerUserState.Idle);
             }
-
-            UpdateWorkingBeatmap();
-        }
-
-        protected override void UpdateWorkingBeatmap()
-        {
-            var lastBeatmap = Beatmap.Value;
-
-            base.UpdateWorkingBeatmap();
-
-            // Nothing to do if the beatmap hasn't changed.
-            if (Beatmap.Value.BeatmapInfo.MatchesOnlineID(lastBeatmap.BeatmapInfo))
-                return;
-
-            // The selected item is nulled during the beatmap query. During this, the working beatmap will be the dummy beatmap.
-            // We don't want to enter spectate mode with the dummy beatmap.
-            if (!Beatmap.Value.BeatmapInfo.MatchesOnlineID(SelectedItem.Value?.Beatmap.Value))
-                return;
-
-            if (client.LocalUser?.State == MultiplayerUserState.Spectating
-                && (client.Room?.State == MultiplayerRoomState.WaitingForLoad || client.Room?.State == MultiplayerRoomState.Playing))
+            else if (client.LocalUser?.State == MultiplayerUserState.Spectating
+                     && (client.Room?.State == MultiplayerRoomState.WaitingForLoad || client.Room?.State == MultiplayerRoomState.Playing))
             {
                 onLoadRequested();
             }

From b0d14526eac084234a7b4c2e1d30f63a36262f35 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 13 Dec 2021 16:34:48 +0900
Subject: [PATCH 1644/5547] Move test `ScoreInfo` creation to `TestResources`

The main goal here is to remove the inheritance, since realm doesn't
like that. Unfortunate that we can't use object initialisers in a few of
these places, but no real way around that.
---
 .../Formats/LegacyScoreDecoderTest.cs         |  2 +-
 osu.Game.Tests/Resources/TestResources.cs     | 67 +++++++++++++++++++
 .../TestScenePlaylistsResultsScreen.cs        | 13 +++-
 .../TestSceneContractedPanelMiddleContent.cs  |  5 +-
 .../TestSceneExpandedPanelMiddleContent.cs    | 28 +++-----
 .../TestSceneExpandedPanelTopContent.cs       |  4 +-
 .../Visual/Ranking/TestSceneResultsScreen.cs  | 20 +++---
 .../Visual/Ranking/TestSceneScorePanel.cs     | 42 +++++++++---
 .../Visual/Ranking/TestSceneScorePanelList.cs | 47 ++++++++-----
 .../Ranking/TestSceneStatisticsPanel.cs       | 15 ++---
 osu.Game/Tests/TestScoreInfo.cs               | 66 ------------------
 11 files changed, 170 insertions(+), 139 deletions(-)
 delete mode 100644 osu.Game/Tests/TestScoreInfo.cs

diff --git a/osu.Game.Tests/Beatmaps/Formats/LegacyScoreDecoderTest.cs b/osu.Game.Tests/Beatmaps/Formats/LegacyScoreDecoderTest.cs
index a73ae9dcdb..81d89359e0 100644
--- a/osu.Game.Tests/Beatmaps/Formats/LegacyScoreDecoderTest.cs
+++ b/osu.Game.Tests/Beatmaps/Formats/LegacyScoreDecoderTest.cs
@@ -62,7 +62,7 @@ namespace osu.Game.Tests.Beatmaps.Formats
         public void TestCultureInvariance()
         {
             var ruleset = new OsuRuleset().RulesetInfo;
-            var scoreInfo = new TestScoreInfo(ruleset);
+            var scoreInfo = TestResources.CreateTestScoreInfo(ruleset);
             var beatmap = new TestBeatmap(ruleset);
             var score = new Score
             {
diff --git a/osu.Game.Tests/Resources/TestResources.cs b/osu.Game.Tests/Resources/TestResources.cs
index 440d5e701f..7535f6769f 100644
--- a/osu.Game.Tests/Resources/TestResources.cs
+++ b/osu.Game.Tests/Resources/TestResources.cs
@@ -4,6 +4,7 @@
 using System;
 using System.Collections.Generic;
 using System.IO;
+using System.Linq;
 using System.Text;
 using System.Threading;
 using NUnit.Framework;
@@ -12,8 +13,12 @@ using osu.Framework.IO.Stores;
 using osu.Framework.Testing;
 using osu.Framework.Utils;
 using osu.Game.Beatmaps;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets;
+using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Osu;
+using osu.Game.Rulesets.Scoring;
+using osu.Game.Scoring;
 
 namespace osu.Game.Tests.Resources
 {
@@ -137,5 +142,67 @@ namespace osu.Game.Tests.Resources
                 }
             }
         }
+
+        /// <summary>
+        /// Create a test score model.
+        /// </summary>
+        /// <param name="ruleset">The ruleset for which the score was set against.</param>
+        /// <param name="excessMods">Whether to include an excessive number of mods. If <c>false</c>, only two will be added.</param>
+        /// <returns></returns>
+        public static ScoreInfo CreateTestScoreInfo(RulesetInfo ruleset = null, bool excessMods = false) =>
+            CreateTestScoreInfo(CreateTestBeatmapSetInfo(1, new[] { ruleset ?? new OsuRuleset().RulesetInfo }).Beatmaps.First(), excessMods);
+
+        /// <summary>
+        /// Create a test score model.
+        /// </summary>
+        /// <param name="beatmap">The beatmap for which the score was set against.</param>
+        /// <param name="excessMods">Whether to include an excessive number of mods. If <c>false</c>, only two will be added.</param>
+        /// <returns></returns>
+        public static ScoreInfo CreateTestScoreInfo(BeatmapInfo beatmap, bool excessMods = false) => new ScoreInfo
+        {
+            User = new APIUser
+            {
+                Id = 2,
+                Username = "peppy",
+                CoverUrl = "https://osu.ppy.sh/images/headers/profile-covers/c3.jpg",
+            },
+            BeatmapInfo = beatmap,
+            Ruleset = beatmap.Ruleset,
+            RulesetID = beatmap.Ruleset.ID ?? 0,
+            Mods = excessMods
+                ? beatmap.Ruleset.CreateInstance().CreateAllMods().ToArray()
+                : new Mod[] { new TestModHardRock(), new TestModDoubleTime() },
+            TotalScore = 2845370,
+            Accuracy = 0.95,
+            MaxCombo = 999,
+            Position = 1,
+            Rank = ScoreRank.S,
+            Date = DateTimeOffset.Now,
+            Statistics = new Dictionary<HitResult, int>
+            {
+                [HitResult.Miss] = 1,
+                [HitResult.Meh] = 50,
+                [HitResult.Ok] = 100,
+                [HitResult.Good] = 200,
+                [HitResult.Great] = 300,
+                [HitResult.Perfect] = 320,
+                [HitResult.SmallTickHit] = 50,
+                [HitResult.SmallTickMiss] = 25,
+                [HitResult.LargeTickHit] = 100,
+                [HitResult.LargeTickMiss] = 50,
+                [HitResult.SmallBonus] = 10,
+                [HitResult.SmallBonus] = 50
+            },
+        };
+
+        private class TestModHardRock : ModHardRock
+        {
+            public override double ScoreMultiplier => 1;
+        }
+
+        private class TestModDoubleTime : ModDoubleTime
+        {
+            public override double ScoreMultiplier => 1;
+        }
     }
 }
diff --git a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsResultsScreen.cs b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsResultsScreen.cs
index 64fc4797a0..faa0ce2bdc 100644
--- a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsResultsScreen.cs
+++ b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsResultsScreen.cs
@@ -22,6 +22,7 @@ using osu.Game.Scoring;
 using osu.Game.Screens.OnlinePlay.Playlists;
 using osu.Game.Screens.Ranking;
 using osu.Game.Tests.Beatmaps;
+using osu.Game.Tests.Resources;
 
 namespace osu.Game.Tests.Visual.Playlists
 {
@@ -52,7 +53,9 @@ namespace osu.Game.Tests.Visual.Playlists
 
             AddStep("bind user score info handler", () =>
             {
-                userScore = new TestScoreInfo(new OsuRuleset().RulesetInfo) { OnlineID = currentScoreId++ };
+                userScore = TestResources.CreateTestScoreInfo(new OsuRuleset().RulesetInfo);
+                userScore.OnlineID = currentScoreId++;
+
                 bindHandler(userScore: userScore);
             });
 
@@ -78,7 +81,9 @@ namespace osu.Game.Tests.Visual.Playlists
 
             AddStep("bind user score info handler", () =>
             {
-                userScore = new TestScoreInfo(new OsuRuleset().RulesetInfo) { OnlineID = currentScoreId++ };
+                userScore = TestResources.CreateTestScoreInfo(new OsuRuleset().RulesetInfo);
+                userScore.OnlineID = currentScoreId++;
+
                 bindHandler(true, userScore);
             });
 
@@ -127,7 +132,9 @@ namespace osu.Game.Tests.Visual.Playlists
 
             AddStep("bind user score info handler", () =>
             {
-                userScore = new TestScoreInfo(new OsuRuleset().RulesetInfo) { OnlineID = currentScoreId++ };
+                userScore = TestResources.CreateTestScoreInfo(new OsuRuleset().RulesetInfo);
+                userScore.OnlineID = currentScoreId++;
+
                 bindHandler(userScore: userScore);
             });
 
diff --git a/osu.Game.Tests/Visual/Ranking/TestSceneContractedPanelMiddleContent.cs b/osu.Game.Tests/Visual/Ranking/TestSceneContractedPanelMiddleContent.cs
index f246560c82..04ddc5d7f0 100644
--- a/osu.Game.Tests/Visual/Ranking/TestSceneContractedPanelMiddleContent.cs
+++ b/osu.Game.Tests/Visual/Ranking/TestSceneContractedPanelMiddleContent.cs
@@ -13,6 +13,7 @@ using osu.Game.Rulesets.Osu;
 using osu.Game.Scoring;
 using osu.Game.Screens.Ranking;
 using osu.Game.Screens.Ranking.Contracted;
+using osu.Game.Tests.Resources;
 using osuTK;
 
 namespace osu.Game.Tests.Visual.Ranking
@@ -22,13 +23,13 @@ namespace osu.Game.Tests.Visual.Ranking
         [Test]
         public void TestShowPanel()
         {
-            AddStep("show example score", () => showPanel(CreateWorkingBeatmap(CreateBeatmap(new OsuRuleset().RulesetInfo)), new TestScoreInfo(new OsuRuleset().RulesetInfo)));
+            AddStep("show example score", () => showPanel(CreateWorkingBeatmap(CreateBeatmap(new OsuRuleset().RulesetInfo)), TestResources.CreateTestScoreInfo(new OsuRuleset().RulesetInfo)));
         }
 
         [Test]
         public void TestExcessMods()
         {
-            AddStep("show excess mods score", () => showPanel(CreateWorkingBeatmap(CreateBeatmap(new OsuRuleset().RulesetInfo)), new TestScoreInfo(new OsuRuleset().RulesetInfo, true)));
+            AddStep("show excess mods score", () => showPanel(CreateWorkingBeatmap(CreateBeatmap(new OsuRuleset().RulesetInfo)), TestResources.CreateTestScoreInfo(new OsuRuleset().RulesetInfo, true)));
         }
 
         private void showPanel(WorkingBeatmap workingBeatmap, ScoreInfo score)
diff --git a/osu.Game.Tests/Visual/Ranking/TestSceneExpandedPanelMiddleContent.cs b/osu.Game.Tests/Visual/Ranking/TestSceneExpandedPanelMiddleContent.cs
index 9983993d9c..1f34606fcb 100644
--- a/osu.Game.Tests/Visual/Ranking/TestSceneExpandedPanelMiddleContent.cs
+++ b/osu.Game.Tests/Visual/Ranking/TestSceneExpandedPanelMiddleContent.cs
@@ -20,6 +20,7 @@ using osu.Game.Scoring;
 using osu.Game.Screens.Ranking;
 using osu.Game.Screens.Ranking.Expanded;
 using osu.Game.Tests.Beatmaps;
+using osu.Game.Tests.Resources;
 using osuTK;
 
 namespace osu.Game.Tests.Visual.Ranking
@@ -34,10 +35,7 @@ namespace osu.Game.Tests.Visual.Ranking
         {
             var author = new APIUser { Username = "mapper_name" };
 
-            AddStep("show example score", () => showPanel(new TestScoreInfo(new OsuRuleset().RulesetInfo)
-            {
-                BeatmapInfo = createTestBeatmap(author)
-            }));
+            AddStep("show example score", () => showPanel(TestResources.CreateTestScoreInfo(createTestBeatmap(author))));
         }
 
         [Test]
@@ -45,10 +43,7 @@ namespace osu.Game.Tests.Visual.Ranking
         {
             var author = new APIUser { Username = "mapper_name" };
 
-            AddStep("show excess mods score", () => showPanel(new TestScoreInfo(new OsuRuleset().RulesetInfo, true)
-            {
-                BeatmapInfo = createTestBeatmap(author)
-            }));
+            AddStep("show excess mods score", () => showPanel(TestResources.CreateTestScoreInfo(createTestBeatmap(author), true)));
 
             AddAssert("mapper name present", () => this.ChildrenOfType<OsuSpriteText>().Any(spriteText => spriteText.Current.Value == "mapper_name"));
         }
@@ -56,10 +51,7 @@ namespace osu.Game.Tests.Visual.Ranking
         [Test]
         public void TestMapWithUnknownMapper()
         {
-            AddStep("show example score", () => showPanel(new TestScoreInfo(new OsuRuleset().RulesetInfo)
-            {
-                BeatmapInfo = createTestBeatmap(new APIUser())
-            }));
+            AddStep("show example score", () => showPanel(TestResources.CreateTestScoreInfo(createTestBeatmap(new APIUser()))));
 
             AddAssert("mapped by text not present", () =>
                 this.ChildrenOfType<OsuSpriteText>().All(spriteText => !containsAny(spriteText.Text.ToString(), "mapped", "by")));
@@ -77,12 +69,12 @@ namespace osu.Game.Tests.Visual.Ranking
                 var mods = new Mod[] { ruleset.GetAutoplayMod() };
                 var beatmap = createTestBeatmap(new APIUser());
 
-                showPanel(new TestScoreInfo(ruleset.RulesetInfo)
-                {
-                    Mods = mods,
-                    BeatmapInfo = beatmap,
-                    Date = default,
-                });
+                var score = TestResources.CreateTestScoreInfo(beatmap);
+
+                score.Mods = mods;
+                score.Date = default;
+
+                showPanel(score);
             });
 
             AddAssert("play time not displayed", () => !this.ChildrenOfType<ExpandedPanelMiddleContent.PlayedOnText>().Any());
diff --git a/osu.Game.Tests/Visual/Ranking/TestSceneExpandedPanelTopContent.cs b/osu.Game.Tests/Visual/Ranking/TestSceneExpandedPanelTopContent.cs
index a32bcbe7f0..a2fa142896 100644
--- a/osu.Game.Tests/Visual/Ranking/TestSceneExpandedPanelTopContent.cs
+++ b/osu.Game.Tests/Visual/Ranking/TestSceneExpandedPanelTopContent.cs
@@ -5,8 +5,8 @@ using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
-using osu.Game.Rulesets.Osu;
 using osu.Game.Screens.Ranking.Expanded;
+using osu.Game.Tests.Resources;
 using osuTK;
 
 namespace osu.Game.Tests.Visual.Ranking
@@ -27,7 +27,7 @@ namespace osu.Game.Tests.Visual.Ranking
                         RelativeSizeAxes = Axes.Both,
                         Colour = Color4Extensions.FromHex("#444"),
                     },
-                    new ExpandedPanelTopContent(new TestScoreInfo(new OsuRuleset().RulesetInfo).User),
+                    new ExpandedPanelTopContent(TestResources.CreateTestScoreInfo().User),
                 }
             };
         }
diff --git a/osu.Game.Tests/Visual/Ranking/TestSceneResultsScreen.cs b/osu.Game.Tests/Visual/Ranking/TestSceneResultsScreen.cs
index 94700bac6a..809f513a83 100644
--- a/osu.Game.Tests/Visual/Ranking/TestSceneResultsScreen.cs
+++ b/osu.Game.Tests/Visual/Ranking/TestSceneResultsScreen.cs
@@ -21,6 +21,7 @@ using osu.Game.Screens;
 using osu.Game.Screens.Play;
 using osu.Game.Screens.Ranking;
 using osu.Game.Screens.Ranking.Statistics;
+using osu.Game.Tests.Resources;
 using osuTK;
 using osuTK.Input;
 
@@ -72,11 +73,10 @@ namespace osu.Game.Tests.Visual.Ranking
         {
             TestResultsScreen screen = null;
 
-            var score = new TestScoreInfo(new OsuRuleset().RulesetInfo)
-            {
-                Accuracy = accuracy,
-                Rank = rank
-            };
+            var score = TestResources.CreateTestScoreInfo();
+
+            score.Accuracy = accuracy;
+            score.Rank = rank;
 
             AddStep("load results", () => Child = new TestResultsContainer(screen = createResultsScreen(score)));
             AddUntilStep("wait for loaded", () => screen.IsLoaded);
@@ -204,7 +204,7 @@ namespace osu.Game.Tests.Visual.Ranking
         {
             DelayedFetchResultsScreen screen = null;
 
-            AddStep("load results", () => Child = new TestResultsContainer(screen = new DelayedFetchResultsScreen(new TestScoreInfo(new OsuRuleset().RulesetInfo), 3000)));
+            AddStep("load results", () => Child = new TestResultsContainer(screen = new DelayedFetchResultsScreen(TestResources.CreateTestScoreInfo(new OsuRuleset().RulesetInfo), 3000)));
             AddUntilStep("wait for loaded", () => screen.IsLoaded);
             AddStep("click expanded panel", () =>
             {
@@ -237,9 +237,9 @@ namespace osu.Game.Tests.Visual.Ranking
             AddAssert("download button is enabled", () => screen.ChildrenOfType<DownloadButton>().Last().Enabled.Value);
         }
 
-        private TestResultsScreen createResultsScreen(ScoreInfo score = null) => new TestResultsScreen(score ?? new TestScoreInfo(new OsuRuleset().RulesetInfo));
+        private TestResultsScreen createResultsScreen(ScoreInfo score = null) => new TestResultsScreen(score ?? TestResources.CreateTestScoreInfo(new OsuRuleset().RulesetInfo));
 
-        private UnrankedSoloResultsScreen createUnrankedSoloResultsScreen() => new UnrankedSoloResultsScreen(new TestScoreInfo(new OsuRuleset().RulesetInfo));
+        private UnrankedSoloResultsScreen createUnrankedSoloResultsScreen() => new UnrankedSoloResultsScreen(TestResources.CreateTestScoreInfo(new OsuRuleset().RulesetInfo));
 
         private class TestResultsContainer : Container
         {
@@ -282,7 +282,7 @@ namespace osu.Game.Tests.Visual.Ranking
 
                 for (int i = 0; i < 20; i++)
                 {
-                    var score = new TestScoreInfo(new OsuRuleset().RulesetInfo);
+                    var score = TestResources.CreateTestScoreInfo(new OsuRuleset().RulesetInfo);
                     score.TotalScore += 10 - i;
                     score.Hash = $"test{i}";
                     scores.Add(score);
@@ -316,7 +316,7 @@ namespace osu.Game.Tests.Visual.Ranking
 
                     for (int i = 0; i < 20; i++)
                     {
-                        var score = new TestScoreInfo(new OsuRuleset().RulesetInfo);
+                        var score = TestResources.CreateTestScoreInfo();
                         score.TotalScore += 10 - i;
                         scores.Add(score);
                     }
diff --git a/osu.Game.Tests/Visual/Ranking/TestSceneScorePanel.cs b/osu.Game.Tests/Visual/Ranking/TestSceneScorePanel.cs
index 5af55e99f8..5dbeefd390 100644
--- a/osu.Game.Tests/Visual/Ranking/TestSceneScorePanel.cs
+++ b/osu.Game.Tests/Visual/Ranking/TestSceneScorePanel.cs
@@ -3,10 +3,10 @@
 
 using NUnit.Framework;
 using osu.Framework.Graphics;
-using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Scoring;
 using osu.Game.Scoring;
 using osu.Game.Screens.Ranking;
+using osu.Game.Tests.Resources;
 
 namespace osu.Game.Tests.Visual.Ranking
 {
@@ -17,7 +17,9 @@ namespace osu.Game.Tests.Visual.Ranking
         [Test]
         public void TestDRank()
         {
-            var score = new TestScoreInfo(new OsuRuleset().RulesetInfo) { Accuracy = 0.5, Rank = ScoreRank.D };
+            var score = TestResources.CreateTestScoreInfo();
+            score.Accuracy = 0.5;
+            score.Rank = ScoreRank.D;
 
             addPanelStep(score);
         }
@@ -25,7 +27,9 @@ namespace osu.Game.Tests.Visual.Ranking
         [Test]
         public void TestCRank()
         {
-            var score = new TestScoreInfo(new OsuRuleset().RulesetInfo) { Accuracy = 0.75, Rank = ScoreRank.C };
+            var score = TestResources.CreateTestScoreInfo();
+            score.Accuracy = 0.75;
+            score.Rank = ScoreRank.C;
 
             addPanelStep(score);
         }
@@ -33,7 +37,9 @@ namespace osu.Game.Tests.Visual.Ranking
         [Test]
         public void TestBRank()
         {
-            var score = new TestScoreInfo(new OsuRuleset().RulesetInfo) { Accuracy = 0.85, Rank = ScoreRank.B };
+            var score = TestResources.CreateTestScoreInfo();
+            score.Accuracy = 0.85;
+            score.Rank = ScoreRank.B;
 
             addPanelStep(score);
         }
@@ -41,7 +47,9 @@ namespace osu.Game.Tests.Visual.Ranking
         [Test]
         public void TestARank()
         {
-            var score = new TestScoreInfo(new OsuRuleset().RulesetInfo) { Accuracy = 0.925, Rank = ScoreRank.A };
+            var score = TestResources.CreateTestScoreInfo();
+            score.Accuracy = 0.925;
+            score.Rank = ScoreRank.A;
 
             addPanelStep(score);
         }
@@ -49,7 +57,9 @@ namespace osu.Game.Tests.Visual.Ranking
         [Test]
         public void TestSRank()
         {
-            var score = new TestScoreInfo(new OsuRuleset().RulesetInfo) { Accuracy = 0.975, Rank = ScoreRank.S };
+            var score = TestResources.CreateTestScoreInfo();
+            score.Accuracy = 0.975;
+            score.Rank = ScoreRank.S;
 
             addPanelStep(score);
         }
@@ -57,7 +67,9 @@ namespace osu.Game.Tests.Visual.Ranking
         [Test]
         public void TestAlmostSSRank()
         {
-            var score = new TestScoreInfo(new OsuRuleset().RulesetInfo) { Accuracy = 0.9999, Rank = ScoreRank.S };
+            var score = TestResources.CreateTestScoreInfo();
+            score.Accuracy = 0.9999;
+            score.Rank = ScoreRank.S;
 
             addPanelStep(score);
         }
@@ -65,7 +77,9 @@ namespace osu.Game.Tests.Visual.Ranking
         [Test]
         public void TestSSRank()
         {
-            var score = new TestScoreInfo(new OsuRuleset().RulesetInfo) { Accuracy = 1, Rank = ScoreRank.X };
+            var score = TestResources.CreateTestScoreInfo();
+            score.Accuracy = 1;
+            score.Rank = ScoreRank.X;
 
             addPanelStep(score);
         }
@@ -73,7 +87,9 @@ namespace osu.Game.Tests.Visual.Ranking
         [Test]
         public void TestAllHitResults()
         {
-            var score = new TestScoreInfo(new OsuRuleset().RulesetInfo) { Statistics = { [HitResult.Perfect] = 350, [HitResult.Ok] = 200 } };
+            var score = TestResources.CreateTestScoreInfo();
+            score.Statistics[HitResult.Perfect] = 350;
+            score.Statistics[HitResult.Ok] = 200;
 
             addPanelStep(score);
         }
@@ -81,7 +97,9 @@ namespace osu.Game.Tests.Visual.Ranking
         [Test]
         public void TestContractedPanel()
         {
-            var score = new TestScoreInfo(new OsuRuleset().RulesetInfo) { Accuracy = 0.925, Rank = ScoreRank.A };
+            var score = TestResources.CreateTestScoreInfo();
+            score.Accuracy = 0.925;
+            score.Rank = ScoreRank.A;
 
             addPanelStep(score, PanelState.Contracted);
         }
@@ -89,7 +107,9 @@ namespace osu.Game.Tests.Visual.Ranking
         [Test]
         public void TestExpandAndContract()
         {
-            var score = new TestScoreInfo(new OsuRuleset().RulesetInfo) { Accuracy = 0.925, Rank = ScoreRank.A };
+            var score = TestResources.CreateTestScoreInfo();
+            score.Accuracy = 0.925;
+            score.Rank = ScoreRank.A;
 
             addPanelStep(score, PanelState.Contracted);
             AddWaitStep("wait for transition", 10);
diff --git a/osu.Game.Tests/Visual/Ranking/TestSceneScorePanelList.cs b/osu.Game.Tests/Visual/Ranking/TestSceneScorePanelList.cs
index 2f9652d354..f963be5d81 100644
--- a/osu.Game.Tests/Visual/Ranking/TestSceneScorePanelList.cs
+++ b/osu.Game.Tests/Visual/Ranking/TestSceneScorePanelList.cs
@@ -10,6 +10,7 @@ using osu.Framework.Utils;
 using osu.Game.Rulesets.Osu;
 using osu.Game.Scoring;
 using osu.Game.Screens.Ranking;
+using osu.Game.Tests.Resources;
 using osuTK.Input;
 
 namespace osu.Game.Tests.Visual.Ranking
@@ -29,14 +30,14 @@ namespace osu.Game.Tests.Visual.Ranking
         {
             createListStep(() => new ScorePanelList
             {
-                SelectedScore = { Value = new TestScoreInfo(new OsuRuleset().RulesetInfo) }
+                SelectedScore = { Value = TestResources.CreateTestScoreInfo(new OsuRuleset().RulesetInfo) }
             });
         }
 
         [Test]
         public void TestAddPanelAfterSelectingScore()
         {
-            var score = new TestScoreInfo(new OsuRuleset().RulesetInfo);
+            var score = TestResources.CreateTestScoreInfo(new OsuRuleset().RulesetInfo);
 
             createListStep(() => new ScorePanelList
             {
@@ -52,7 +53,7 @@ namespace osu.Game.Tests.Visual.Ranking
         [Test]
         public void TestAddPanelBeforeSelectingScore()
         {
-            var score = new TestScoreInfo(new OsuRuleset().RulesetInfo);
+            var score = TestResources.CreateTestScoreInfo(new OsuRuleset().RulesetInfo);
 
             createListStep(() => new ScorePanelList());
 
@@ -75,7 +76,7 @@ namespace osu.Game.Tests.Visual.Ranking
             AddStep("add many scores", () =>
             {
                 for (int i = 0; i < 20; i++)
-                    list.AddScore(new TestScoreInfo(new OsuRuleset().RulesetInfo));
+                    list.AddScore(TestResources.CreateTestScoreInfo(new OsuRuleset().RulesetInfo));
             });
 
             assertFirstPanelCentred();
@@ -84,7 +85,7 @@ namespace osu.Game.Tests.Visual.Ranking
         [Test]
         public void TestAddManyScoresAfterExpandedPanel()
         {
-            var initialScore = new TestScoreInfo(new OsuRuleset().RulesetInfo);
+            var initialScore = TestResources.CreateTestScoreInfo(new OsuRuleset().RulesetInfo);
 
             createListStep(() => new ScorePanelList());
 
@@ -97,7 +98,7 @@ namespace osu.Game.Tests.Visual.Ranking
             AddStep("add many scores", () =>
             {
                 for (int i = 0; i < 20; i++)
-                    list.AddScore(new TestScoreInfo(new OsuRuleset().RulesetInfo) { TotalScore = initialScore.TotalScore - i - 1 });
+                    list.AddScore(createScoreForTotalScore(initialScore.TotalScore - i - 1));
             });
 
             assertScoreState(initialScore, true);
@@ -107,7 +108,7 @@ namespace osu.Game.Tests.Visual.Ranking
         [Test]
         public void TestAddManyScoresBeforeExpandedPanel()
         {
-            var initialScore = new TestScoreInfo(new OsuRuleset().RulesetInfo);
+            var initialScore = TestResources.CreateTestScoreInfo(new OsuRuleset().RulesetInfo);
 
             createListStep(() => new ScorePanelList());
 
@@ -120,7 +121,7 @@ namespace osu.Game.Tests.Visual.Ranking
             AddStep("add scores", () =>
             {
                 for (int i = 0; i < 20; i++)
-                    list.AddScore(new TestScoreInfo(new OsuRuleset().RulesetInfo) { TotalScore = initialScore.TotalScore + i + 1 });
+                    list.AddScore(createScoreForTotalScore(initialScore.TotalScore + i + 1));
             });
 
             assertScoreState(initialScore, true);
@@ -130,7 +131,7 @@ namespace osu.Game.Tests.Visual.Ranking
         [Test]
         public void TestAddManyPanelsOnBothSidesOfExpandedPanel()
         {
-            var initialScore = new TestScoreInfo(new OsuRuleset().RulesetInfo);
+            var initialScore = TestResources.CreateTestScoreInfo(new OsuRuleset().RulesetInfo);
 
             createListStep(() => new ScorePanelList());
 
@@ -143,10 +144,10 @@ namespace osu.Game.Tests.Visual.Ranking
             AddStep("add scores after", () =>
             {
                 for (int i = 0; i < 20; i++)
-                    list.AddScore(new TestScoreInfo(new OsuRuleset().RulesetInfo) { TotalScore = initialScore.TotalScore - i - 1 });
+                    list.AddScore(createScoreForTotalScore(initialScore.TotalScore - i - 1));
 
                 for (int i = 0; i < 20; i++)
-                    list.AddScore(new TestScoreInfo(new OsuRuleset().RulesetInfo) { TotalScore = initialScore.TotalScore + i + 1 });
+                    list.AddScore(createScoreForTotalScore(initialScore.TotalScore + i + 1));
             });
 
             assertScoreState(initialScore, true);
@@ -156,8 +157,8 @@ namespace osu.Game.Tests.Visual.Ranking
         [Test]
         public void TestSelectMultipleScores()
         {
-            var firstScore = new TestScoreInfo(new OsuRuleset().RulesetInfo);
-            var secondScore = new TestScoreInfo(new OsuRuleset().RulesetInfo);
+            var firstScore = TestResources.CreateTestScoreInfo(new OsuRuleset().RulesetInfo);
+            var secondScore = TestResources.CreateTestScoreInfo(new OsuRuleset().RulesetInfo);
 
             firstScore.UserString = "A";
             secondScore.UserString = "B";
@@ -190,7 +191,7 @@ namespace osu.Game.Tests.Visual.Ranking
         [Test]
         public void TestAddScoreImmediately()
         {
-            var score = new TestScoreInfo(new OsuRuleset().RulesetInfo);
+            var score = TestResources.CreateTestScoreInfo(new OsuRuleset().RulesetInfo);
 
             createListStep(() =>
             {
@@ -206,9 +207,14 @@ namespace osu.Game.Tests.Visual.Ranking
         [Test]
         public void TestKeyboardNavigation()
         {
-            var lowestScore = new TestScoreInfo(new OsuRuleset().RulesetInfo) { MaxCombo = 100 };
-            var middleScore = new TestScoreInfo(new OsuRuleset().RulesetInfo) { MaxCombo = 200 };
-            var highestScore = new TestScoreInfo(new OsuRuleset().RulesetInfo) { MaxCombo = 300 };
+            var lowestScore = TestResources.CreateTestScoreInfo();
+            lowestScore.MaxCombo = 100;
+
+            var middleScore = TestResources.CreateTestScoreInfo();
+            middleScore.MaxCombo = 200;
+
+            var highestScore = TestResources.CreateTestScoreInfo();
+            highestScore.MaxCombo = 300;
 
             createListStep(() => new ScorePanelList());
 
@@ -270,6 +276,13 @@ namespace osu.Game.Tests.Visual.Ranking
             assertExpandedPanelCentred();
         }
 
+        private ScoreInfo createScoreForTotalScore(long totalScore)
+        {
+            var score = TestResources.CreateTestScoreInfo();
+            score.TotalScore = totalScore;
+            return score;
+        }
+
         private void createListStep(Func<ScorePanelList> creationFunc)
         {
             AddStep("create list", () => Child = list = creationFunc().With(d =>
diff --git a/osu.Game.Tests/Visual/Ranking/TestSceneStatisticsPanel.cs b/osu.Game.Tests/Visual/Ranking/TestSceneStatisticsPanel.cs
index d91aec753c..ebea523b9e 100644
--- a/osu.Game.Tests/Visual/Ranking/TestSceneStatisticsPanel.cs
+++ b/osu.Game.Tests/Visual/Ranking/TestSceneStatisticsPanel.cs
@@ -11,6 +11,7 @@ using osu.Game.Scoring;
 using osu.Game.Screens.Ranking.Statistics;
 using osu.Game.Rulesets.Osu.Objects;
 using osu.Game.Rulesets.Scoring;
+using osu.Game.Tests.Resources;
 using osuTK;
 
 namespace osu.Game.Tests.Visual.Ranking
@@ -20,10 +21,8 @@ namespace osu.Game.Tests.Visual.Ranking
         [Test]
         public void TestScoreWithTimeStatistics()
         {
-            var score = new TestScoreInfo(new OsuRuleset().RulesetInfo)
-            {
-                HitEvents = TestSceneHitEventTimingDistributionGraph.CreateDistributedHitEvents()
-            };
+            var score = TestResources.CreateTestScoreInfo();
+            score.HitEvents = TestSceneHitEventTimingDistributionGraph.CreateDistributedHitEvents();
 
             loadPanel(score);
         }
@@ -31,10 +30,8 @@ namespace osu.Game.Tests.Visual.Ranking
         [Test]
         public void TestScoreWithPositionStatistics()
         {
-            var score = new TestScoreInfo(new OsuRuleset().RulesetInfo)
-            {
-                HitEvents = createPositionDistributedHitEvents()
-            };
+            var score = TestResources.CreateTestScoreInfo();
+            score.HitEvents = createPositionDistributedHitEvents();
 
             loadPanel(score);
         }
@@ -42,7 +39,7 @@ namespace osu.Game.Tests.Visual.Ranking
         [Test]
         public void TestScoreWithoutStatistics()
         {
-            loadPanel(new TestScoreInfo(new OsuRuleset().RulesetInfo));
+            loadPanel(TestResources.CreateTestScoreInfo(new OsuRuleset().RulesetInfo));
         }
 
         [Test]
diff --git a/osu.Game/Tests/TestScoreInfo.cs b/osu.Game/Tests/TestScoreInfo.cs
deleted file mode 100644
index a53cb0ae78..0000000000
--- a/osu.Game/Tests/TestScoreInfo.cs
+++ /dev/null
@@ -1,66 +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.Linq;
-using osu.Game.Online.API.Requests.Responses;
-using osu.Game.Rulesets;
-using osu.Game.Rulesets.Mods;
-using osu.Game.Rulesets.Scoring;
-using osu.Game.Scoring;
-using osu.Game.Tests.Beatmaps;
-
-namespace osu.Game.Tests
-{
-    public class TestScoreInfo : ScoreInfo
-    {
-        public TestScoreInfo(RulesetInfo ruleset, bool excessMods = false)
-        {
-            User = new APIUser
-            {
-                Id = 2,
-                Username = "peppy",
-                CoverUrl = "https://osu.ppy.sh/images/headers/profile-covers/c3.jpg",
-            };
-
-            BeatmapInfo = new TestBeatmap(ruleset).BeatmapInfo;
-            Ruleset = ruleset;
-            RulesetID = ruleset.ID ?? 0;
-
-            Mods = excessMods
-                ? ruleset.CreateInstance().CreateAllMods().ToArray()
-                : new Mod[] { new TestModHardRock(), new TestModDoubleTime() };
-
-            TotalScore = 2845370;
-            Accuracy = 0.95;
-            MaxCombo = 999;
-            Rank = ScoreRank.S;
-            Date = DateTimeOffset.Now;
-
-            Statistics[HitResult.Miss] = 1;
-            Statistics[HitResult.Meh] = 50;
-            Statistics[HitResult.Ok] = 100;
-            Statistics[HitResult.Good] = 200;
-            Statistics[HitResult.Great] = 300;
-            Statistics[HitResult.Perfect] = 320;
-            Statistics[HitResult.SmallTickHit] = 50;
-            Statistics[HitResult.SmallTickMiss] = 25;
-            Statistics[HitResult.LargeTickHit] = 100;
-            Statistics[HitResult.LargeTickMiss] = 50;
-            Statistics[HitResult.SmallBonus] = 10;
-            Statistics[HitResult.SmallBonus] = 50;
-
-            Position = 1;
-        }
-
-        private class TestModHardRock : ModHardRock
-        {
-            public override double ScoreMultiplier => 1;
-        }
-
-        private class TestModDoubleTime : ModDoubleTime
-        {
-            public override double ScoreMultiplier => 1;
-        }
-    }
-}

From 99ac71c1fe9b109c064b2deac88aadd10b290544 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 13 Dec 2021 16:37:20 +0900
Subject: [PATCH 1645/5547] Simplify usages where the ruleset being used is
 osu! ruleset

---
 .../TestScenePlaylistsResultsScreen.cs        |  6 +++---
 .../TestSceneContractedPanelMiddleContent.cs  |  4 ++--
 .../Visual/Ranking/TestSceneResultsScreen.cs  |  9 ++++----
 .../Visual/Ranking/TestSceneScorePanelList.cs | 21 +++++++++----------
 .../Ranking/TestSceneStatisticsPanel.cs       |  3 +--
 5 files changed, 20 insertions(+), 23 deletions(-)

diff --git a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsResultsScreen.cs b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsResultsScreen.cs
index faa0ce2bdc..25ca1299ef 100644
--- a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsResultsScreen.cs
+++ b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsResultsScreen.cs
@@ -53,7 +53,7 @@ namespace osu.Game.Tests.Visual.Playlists
 
             AddStep("bind user score info handler", () =>
             {
-                userScore = TestResources.CreateTestScoreInfo(new OsuRuleset().RulesetInfo);
+                userScore = TestResources.CreateTestScoreInfo();
                 userScore.OnlineID = currentScoreId++;
 
                 bindHandler(userScore: userScore);
@@ -81,7 +81,7 @@ namespace osu.Game.Tests.Visual.Playlists
 
             AddStep("bind user score info handler", () =>
             {
-                userScore = TestResources.CreateTestScoreInfo(new OsuRuleset().RulesetInfo);
+                userScore = TestResources.CreateTestScoreInfo();
                 userScore.OnlineID = currentScoreId++;
 
                 bindHandler(true, userScore);
@@ -132,7 +132,7 @@ namespace osu.Game.Tests.Visual.Playlists
 
             AddStep("bind user score info handler", () =>
             {
-                userScore = TestResources.CreateTestScoreInfo(new OsuRuleset().RulesetInfo);
+                userScore = TestResources.CreateTestScoreInfo();
                 userScore.OnlineID = currentScoreId++;
 
                 bindHandler(userScore: userScore);
diff --git a/osu.Game.Tests/Visual/Ranking/TestSceneContractedPanelMiddleContent.cs b/osu.Game.Tests/Visual/Ranking/TestSceneContractedPanelMiddleContent.cs
index 04ddc5d7f0..a84a7b3993 100644
--- a/osu.Game.Tests/Visual/Ranking/TestSceneContractedPanelMiddleContent.cs
+++ b/osu.Game.Tests/Visual/Ranking/TestSceneContractedPanelMiddleContent.cs
@@ -23,13 +23,13 @@ namespace osu.Game.Tests.Visual.Ranking
         [Test]
         public void TestShowPanel()
         {
-            AddStep("show example score", () => showPanel(CreateWorkingBeatmap(CreateBeatmap(new OsuRuleset().RulesetInfo)), TestResources.CreateTestScoreInfo(new OsuRuleset().RulesetInfo)));
+            AddStep("show example score", () => showPanel(CreateWorkingBeatmap(CreateBeatmap(new OsuRuleset().RulesetInfo)), TestResources.CreateTestScoreInfo()));
         }
 
         [Test]
         public void TestExcessMods()
         {
-            AddStep("show excess mods score", () => showPanel(CreateWorkingBeatmap(CreateBeatmap(new OsuRuleset().RulesetInfo)), TestResources.CreateTestScoreInfo(new OsuRuleset().RulesetInfo, true)));
+            AddStep("show excess mods score", () => showPanel(CreateWorkingBeatmap(CreateBeatmap(new OsuRuleset().RulesetInfo)), TestResources.CreateTestScoreInfo(excessMods: true)));
         }
 
         private void showPanel(WorkingBeatmap workingBeatmap, ScoreInfo score)
diff --git a/osu.Game.Tests/Visual/Ranking/TestSceneResultsScreen.cs b/osu.Game.Tests/Visual/Ranking/TestSceneResultsScreen.cs
index 809f513a83..d0bd5a6e66 100644
--- a/osu.Game.Tests/Visual/Ranking/TestSceneResultsScreen.cs
+++ b/osu.Game.Tests/Visual/Ranking/TestSceneResultsScreen.cs
@@ -15,7 +15,6 @@ using osu.Framework.Utils;
 using osu.Game.Beatmaps;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Online.API;
-using osu.Game.Rulesets.Osu;
 using osu.Game.Scoring;
 using osu.Game.Screens;
 using osu.Game.Screens.Play;
@@ -204,7 +203,7 @@ namespace osu.Game.Tests.Visual.Ranking
         {
             DelayedFetchResultsScreen screen = null;
 
-            AddStep("load results", () => Child = new TestResultsContainer(screen = new DelayedFetchResultsScreen(TestResources.CreateTestScoreInfo(new OsuRuleset().RulesetInfo), 3000)));
+            AddStep("load results", () => Child = new TestResultsContainer(screen = new DelayedFetchResultsScreen(TestResources.CreateTestScoreInfo(), 3000)));
             AddUntilStep("wait for loaded", () => screen.IsLoaded);
             AddStep("click expanded panel", () =>
             {
@@ -237,9 +236,9 @@ namespace osu.Game.Tests.Visual.Ranking
             AddAssert("download button is enabled", () => screen.ChildrenOfType<DownloadButton>().Last().Enabled.Value);
         }
 
-        private TestResultsScreen createResultsScreen(ScoreInfo score = null) => new TestResultsScreen(score ?? TestResources.CreateTestScoreInfo(new OsuRuleset().RulesetInfo));
+        private TestResultsScreen createResultsScreen(ScoreInfo score = null) => new TestResultsScreen(score ?? TestResources.CreateTestScoreInfo());
 
-        private UnrankedSoloResultsScreen createUnrankedSoloResultsScreen() => new UnrankedSoloResultsScreen(TestResources.CreateTestScoreInfo(new OsuRuleset().RulesetInfo));
+        private UnrankedSoloResultsScreen createUnrankedSoloResultsScreen() => new UnrankedSoloResultsScreen(TestResources.CreateTestScoreInfo());
 
         private class TestResultsContainer : Container
         {
@@ -282,7 +281,7 @@ namespace osu.Game.Tests.Visual.Ranking
 
                 for (int i = 0; i < 20; i++)
                 {
-                    var score = TestResources.CreateTestScoreInfo(new OsuRuleset().RulesetInfo);
+                    var score = TestResources.CreateTestScoreInfo();
                     score.TotalScore += 10 - i;
                     score.Hash = $"test{i}";
                     scores.Add(score);
diff --git a/osu.Game.Tests/Visual/Ranking/TestSceneScorePanelList.cs b/osu.Game.Tests/Visual/Ranking/TestSceneScorePanelList.cs
index f963be5d81..f5ad352b9c 100644
--- a/osu.Game.Tests/Visual/Ranking/TestSceneScorePanelList.cs
+++ b/osu.Game.Tests/Visual/Ranking/TestSceneScorePanelList.cs
@@ -7,7 +7,6 @@ using NUnit.Framework;
 using osu.Framework.Graphics;
 using osu.Framework.Testing;
 using osu.Framework.Utils;
-using osu.Game.Rulesets.Osu;
 using osu.Game.Scoring;
 using osu.Game.Screens.Ranking;
 using osu.Game.Tests.Resources;
@@ -30,14 +29,14 @@ namespace osu.Game.Tests.Visual.Ranking
         {
             createListStep(() => new ScorePanelList
             {
-                SelectedScore = { Value = TestResources.CreateTestScoreInfo(new OsuRuleset().RulesetInfo) }
+                SelectedScore = { Value = TestResources.CreateTestScoreInfo() }
             });
         }
 
         [Test]
         public void TestAddPanelAfterSelectingScore()
         {
-            var score = TestResources.CreateTestScoreInfo(new OsuRuleset().RulesetInfo);
+            var score = TestResources.CreateTestScoreInfo();
 
             createListStep(() => new ScorePanelList
             {
@@ -53,7 +52,7 @@ namespace osu.Game.Tests.Visual.Ranking
         [Test]
         public void TestAddPanelBeforeSelectingScore()
         {
-            var score = TestResources.CreateTestScoreInfo(new OsuRuleset().RulesetInfo);
+            var score = TestResources.CreateTestScoreInfo();
 
             createListStep(() => new ScorePanelList());
 
@@ -76,7 +75,7 @@ namespace osu.Game.Tests.Visual.Ranking
             AddStep("add many scores", () =>
             {
                 for (int i = 0; i < 20; i++)
-                    list.AddScore(TestResources.CreateTestScoreInfo(new OsuRuleset().RulesetInfo));
+                    list.AddScore(TestResources.CreateTestScoreInfo());
             });
 
             assertFirstPanelCentred();
@@ -85,7 +84,7 @@ namespace osu.Game.Tests.Visual.Ranking
         [Test]
         public void TestAddManyScoresAfterExpandedPanel()
         {
-            var initialScore = TestResources.CreateTestScoreInfo(new OsuRuleset().RulesetInfo);
+            var initialScore = TestResources.CreateTestScoreInfo();
 
             createListStep(() => new ScorePanelList());
 
@@ -108,7 +107,7 @@ namespace osu.Game.Tests.Visual.Ranking
         [Test]
         public void TestAddManyScoresBeforeExpandedPanel()
         {
-            var initialScore = TestResources.CreateTestScoreInfo(new OsuRuleset().RulesetInfo);
+            var initialScore = TestResources.CreateTestScoreInfo();
 
             createListStep(() => new ScorePanelList());
 
@@ -131,7 +130,7 @@ namespace osu.Game.Tests.Visual.Ranking
         [Test]
         public void TestAddManyPanelsOnBothSidesOfExpandedPanel()
         {
-            var initialScore = TestResources.CreateTestScoreInfo(new OsuRuleset().RulesetInfo);
+            var initialScore = TestResources.CreateTestScoreInfo();
 
             createListStep(() => new ScorePanelList());
 
@@ -157,8 +156,8 @@ namespace osu.Game.Tests.Visual.Ranking
         [Test]
         public void TestSelectMultipleScores()
         {
-            var firstScore = TestResources.CreateTestScoreInfo(new OsuRuleset().RulesetInfo);
-            var secondScore = TestResources.CreateTestScoreInfo(new OsuRuleset().RulesetInfo);
+            var firstScore = TestResources.CreateTestScoreInfo();
+            var secondScore = TestResources.CreateTestScoreInfo();
 
             firstScore.UserString = "A";
             secondScore.UserString = "B";
@@ -191,7 +190,7 @@ namespace osu.Game.Tests.Visual.Ranking
         [Test]
         public void TestAddScoreImmediately()
         {
-            var score = TestResources.CreateTestScoreInfo(new OsuRuleset().RulesetInfo);
+            var score = TestResources.CreateTestScoreInfo();
 
             createListStep(() =>
             {
diff --git a/osu.Game.Tests/Visual/Ranking/TestSceneStatisticsPanel.cs b/osu.Game.Tests/Visual/Ranking/TestSceneStatisticsPanel.cs
index ebea523b9e..f64b7b2b65 100644
--- a/osu.Game.Tests/Visual/Ranking/TestSceneStatisticsPanel.cs
+++ b/osu.Game.Tests/Visual/Ranking/TestSceneStatisticsPanel.cs
@@ -6,7 +6,6 @@ using System.Collections.Generic;
 using NUnit.Framework;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
-using osu.Game.Rulesets.Osu;
 using osu.Game.Scoring;
 using osu.Game.Screens.Ranking.Statistics;
 using osu.Game.Rulesets.Osu.Objects;
@@ -39,7 +38,7 @@ namespace osu.Game.Tests.Visual.Ranking
         [Test]
         public void TestScoreWithoutStatistics()
         {
-            loadPanel(TestResources.CreateTestScoreInfo(new OsuRuleset().RulesetInfo));
+            loadPanel(TestResources.CreateTestScoreInfo());
         }
 
         [Test]

From 654b47c7ecd67272038672a9f468059f667b0247 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 13 Dec 2021 16:41:29 +0900
Subject: [PATCH 1646/5547] Move "excess mods" test behaviour to local usages

There were only two of these, so it doesn't make sense to add extra
complexity in the test resources class.
---
 osu.Game.Tests/Resources/TestResources.cs            | 12 ++++--------
 .../Ranking/TestSceneContractedPanelMiddleContent.cs |  8 +++++++-
 .../Ranking/TestSceneExpandedPanelMiddleContent.cs   | 10 ++++++++--
 3 files changed, 19 insertions(+), 11 deletions(-)

diff --git a/osu.Game.Tests/Resources/TestResources.cs b/osu.Game.Tests/Resources/TestResources.cs
index 7535f6769f..445394fc77 100644
--- a/osu.Game.Tests/Resources/TestResources.cs
+++ b/osu.Game.Tests/Resources/TestResources.cs
@@ -147,18 +147,16 @@ namespace osu.Game.Tests.Resources
         /// Create a test score model.
         /// </summary>
         /// <param name="ruleset">The ruleset for which the score was set against.</param>
-        /// <param name="excessMods">Whether to include an excessive number of mods. If <c>false</c>, only two will be added.</param>
         /// <returns></returns>
-        public static ScoreInfo CreateTestScoreInfo(RulesetInfo ruleset = null, bool excessMods = false) =>
-            CreateTestScoreInfo(CreateTestBeatmapSetInfo(1, new[] { ruleset ?? new OsuRuleset().RulesetInfo }).Beatmaps.First(), excessMods);
+        public static ScoreInfo CreateTestScoreInfo(RulesetInfo ruleset = null) =>
+            CreateTestScoreInfo(CreateTestBeatmapSetInfo(1, new[] { ruleset ?? new OsuRuleset().RulesetInfo }).Beatmaps.First());
 
         /// <summary>
         /// Create a test score model.
         /// </summary>
         /// <param name="beatmap">The beatmap for which the score was set against.</param>
-        /// <param name="excessMods">Whether to include an excessive number of mods. If <c>false</c>, only two will be added.</param>
         /// <returns></returns>
-        public static ScoreInfo CreateTestScoreInfo(BeatmapInfo beatmap, bool excessMods = false) => new ScoreInfo
+        public static ScoreInfo CreateTestScoreInfo(BeatmapInfo beatmap) => new ScoreInfo
         {
             User = new APIUser
             {
@@ -169,9 +167,7 @@ namespace osu.Game.Tests.Resources
             BeatmapInfo = beatmap,
             Ruleset = beatmap.Ruleset,
             RulesetID = beatmap.Ruleset.ID ?? 0,
-            Mods = excessMods
-                ? beatmap.Ruleset.CreateInstance().CreateAllMods().ToArray()
-                : new Mod[] { new TestModHardRock(), new TestModDoubleTime() },
+            Mods = new Mod[] { new TestModHardRock(), new TestModDoubleTime() },
             TotalScore = 2845370,
             Accuracy = 0.95,
             MaxCombo = 999,
diff --git a/osu.Game.Tests/Visual/Ranking/TestSceneContractedPanelMiddleContent.cs b/osu.Game.Tests/Visual/Ranking/TestSceneContractedPanelMiddleContent.cs
index a84a7b3993..85306b9354 100644
--- a/osu.Game.Tests/Visual/Ranking/TestSceneContractedPanelMiddleContent.cs
+++ b/osu.Game.Tests/Visual/Ranking/TestSceneContractedPanelMiddleContent.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.Bindables;
@@ -29,7 +30,12 @@ namespace osu.Game.Tests.Visual.Ranking
         [Test]
         public void TestExcessMods()
         {
-            AddStep("show excess mods score", () => showPanel(CreateWorkingBeatmap(CreateBeatmap(new OsuRuleset().RulesetInfo)), TestResources.CreateTestScoreInfo(excessMods: true)));
+            AddStep("show excess mods score", () =>
+            {
+                var score = TestResources.CreateTestScoreInfo();
+                score.Mods = score.BeatmapInfo.Ruleset.CreateInstance().CreateAllMods().ToArray();
+                showPanel(CreateWorkingBeatmap(CreateBeatmap(new OsuRuleset().RulesetInfo)), score);
+            });
         }
 
         private void showPanel(WorkingBeatmap workingBeatmap, ScoreInfo score)
diff --git a/osu.Game.Tests/Visual/Ranking/TestSceneExpandedPanelMiddleContent.cs b/osu.Game.Tests/Visual/Ranking/TestSceneExpandedPanelMiddleContent.cs
index 1f34606fcb..2cb4fb6b6b 100644
--- a/osu.Game.Tests/Visual/Ranking/TestSceneExpandedPanelMiddleContent.cs
+++ b/osu.Game.Tests/Visual/Ranking/TestSceneExpandedPanelMiddleContent.cs
@@ -41,9 +41,15 @@ namespace osu.Game.Tests.Visual.Ranking
         [Test]
         public void TestExcessMods()
         {
-            var author = new APIUser { Username = "mapper_name" };
+            AddStep("show excess mods score", () =>
+            {
+                var author = new APIUser { Username = "mapper_name" };
 
-            AddStep("show excess mods score", () => showPanel(TestResources.CreateTestScoreInfo(createTestBeatmap(author), true)));
+                var score = TestResources.CreateTestScoreInfo(createTestBeatmap(author));
+                score.Mods = score.BeatmapInfo.Ruleset.CreateInstance().CreateAllMods().ToArray();
+
+                showPanel(score);
+            });
 
             AddAssert("mapper name present", () => this.ChildrenOfType<OsuSpriteText>().Any(spriteText => spriteText.Current.Value == "mapper_name"));
         }

From 309290a3c9b92e40d88328720b23e544de7c892b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 13 Dec 2021 16:50:29 +0900
Subject: [PATCH 1647/5547] Use new method in more places that can benefit from
 it

---
 .../Online/TestAPIModJsonSerialization.cs     |  3 +--
 .../Background/TestSceneUserDimBackgrounds.cs |  9 +--------
 .../Visual/Gameplay/TestSceneFailJudgement.cs |  1 +
 .../TestSceneMultiplayerResults.cs            | 19 ++-----------------
 .../TestSceneMultiplayerTeamResults.cs        | 19 ++-----------------
 .../SongSelect/TestScenePlaySongSelect.cs     |  7 +------
 6 files changed, 8 insertions(+), 50 deletions(-)

diff --git a/osu.Game.Tests/Online/TestAPIModJsonSerialization.cs b/osu.Game.Tests/Online/TestAPIModJsonSerialization.cs
index 8378b33b3d..8b8954a1d0 100644
--- a/osu.Game.Tests/Online/TestAPIModJsonSerialization.cs
+++ b/osu.Game.Tests/Online/TestAPIModJsonSerialization.cs
@@ -94,7 +94,7 @@ namespace osu.Game.Tests.Online
         [Test]
         public void TestDeserialiseSubmittableScoreWithEmptyMods()
         {
-            var score = new SubmittableScore(new ScoreInfo { Ruleset = new OsuRuleset().RulesetInfo });
+            var score = new SubmittableScore(new ScoreInfo());
 
             var deserialised = JsonConvert.DeserializeObject<SubmittableScore>(JsonConvert.SerializeObject(score));
 
@@ -106,7 +106,6 @@ namespace osu.Game.Tests.Online
         {
             var score = new SubmittableScore(new ScoreInfo
             {
-                Ruleset = new OsuRuleset().RulesetInfo,
                 Mods = new Mod[] { new OsuModDoubleTime { SpeedChange = { Value = 2 } } }
             });
 
diff --git a/osu.Game.Tests/Visual/Background/TestSceneUserDimBackgrounds.cs b/osu.Game.Tests/Visual/Background/TestSceneUserDimBackgrounds.cs
index 194341d1ab..33b1d9a67d 100644
--- a/osu.Game.Tests/Visual/Background/TestSceneUserDimBackgrounds.cs
+++ b/osu.Game.Tests/Visual/Background/TestSceneUserDimBackgrounds.cs
@@ -18,7 +18,6 @@ using osu.Game.Configuration;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
-using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Osu.Mods;
 using osu.Game.Scoring;
@@ -28,7 +27,6 @@ using osu.Game.Screens.Play;
 using osu.Game.Screens.Play.PlayerSettings;
 using osu.Game.Screens.Ranking;
 using osu.Game.Screens.Select;
-using osu.Game.Tests.Beatmaps;
 using osu.Game.Tests.Resources;
 using osuTK;
 using osuTK.Graphics;
@@ -229,12 +227,7 @@ namespace osu.Game.Tests.Visual.Background
 
             FadeAccessibleResults results = null;
 
-            AddStep("Transition to Results", () => player.Push(results = new FadeAccessibleResults(new ScoreInfo
-            {
-                User = new APIUser { Username = "osu!" },
-                BeatmapInfo = new TestBeatmap(Ruleset.Value).BeatmapInfo,
-                Ruleset = Ruleset.Value,
-            })));
+            AddStep("Transition to Results", () => player.Push(results = new FadeAccessibleResults(TestResources.CreateTestScoreInfo())));
 
             AddUntilStep("Wait for results is current", () => results.IsCurrentScreen());
 
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneFailJudgement.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneFailJudgement.cs
index 745932315c..fa27e1abdd 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneFailJudgement.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneFailJudgement.cs
@@ -26,6 +26,7 @@ namespace osu.Game.Tests.Visual.Gameplay
             AddAssert("total number of results == 1", () =>
             {
                 var score = new ScoreInfo();
+
                 ((FailPlayer)Player).ScoreProcessor.PopulateScore(score);
 
                 return score.Statistics.Values.Sum() == 1;
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerResults.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerResults.cs
index 744a2d187d..4674601f28 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerResults.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerResults.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 NUnit.Framework;
-using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Rooms;
 using osu.Game.Rulesets.Osu;
-using osu.Game.Scoring;
 using osu.Game.Screens.OnlinePlay.Multiplayer;
+using osu.Game.Tests.Resources;
 
 namespace osu.Game.Tests.Visual.Multiplayer
 {
@@ -22,20 +20,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             {
                 var rulesetInfo = new OsuRuleset().RulesetInfo;
                 var beatmapInfo = CreateBeatmap(rulesetInfo).BeatmapInfo;
-
-                var score = new ScoreInfo
-                {
-                    Rank = ScoreRank.B,
-                    TotalScore = 987654,
-                    Accuracy = 0.8,
-                    MaxCombo = 500,
-                    Combo = 250,
-                    BeatmapInfo = beatmapInfo,
-                    User = new APIUser { Username = "Test user" },
-                    Date = DateTimeOffset.Now,
-                    OnlineID = 12345,
-                    Ruleset = rulesetInfo,
-                };
+                var score = TestResources.CreateTestScoreInfo(beatmapInfo);
 
                 PlaylistItem playlistItem = new PlaylistItem
                 {
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerTeamResults.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerTeamResults.cs
index 99b6edc3b6..f5df8d7507 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerTeamResults.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerTeamResults.cs
@@ -1,15 +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 System.Collections.Generic;
 using NUnit.Framework;
 using osu.Framework.Bindables;
-using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Rooms;
 using osu.Game.Rulesets.Osu;
-using osu.Game.Scoring;
 using osu.Game.Screens.OnlinePlay.Multiplayer;
+using osu.Game.Tests.Resources;
 
 namespace osu.Game.Tests.Visual.Multiplayer
 {
@@ -26,20 +24,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             {
                 var rulesetInfo = new OsuRuleset().RulesetInfo;
                 var beatmapInfo = CreateBeatmap(rulesetInfo).BeatmapInfo;
-
-                var score = new ScoreInfo
-                {
-                    Rank = ScoreRank.B,
-                    TotalScore = 987654,
-                    Accuracy = 0.8,
-                    MaxCombo = 500,
-                    Combo = 250,
-                    BeatmapInfo = beatmapInfo,
-                    User = new APIUser { Username = "Test user" },
-                    Date = DateTimeOffset.Now,
-                    OnlineID = 12345,
-                    Ruleset = rulesetInfo,
-                };
+                var score = TestResources.CreateTestScoreInfo(beatmapInfo);
 
                 PlaylistItem playlistItem = new PlaylistItem
                 {
diff --git a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
index 0494d1de3c..be390742ea 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
@@ -835,12 +835,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                 // this beatmap change should be overridden by the present.
                 Beatmap.Value = manager.GetWorkingBeatmap(getSwitchBeatmap());
 
-                songSelect.PresentScore(new ScoreInfo
-                {
-                    User = new APIUser { Username = "woo" },
-                    BeatmapInfo = getPresentBeatmap(),
-                    Ruleset = getPresentBeatmap().Ruleset
-                });
+                songSelect.PresentScore(TestResources.CreateTestScoreInfo(getPresentBeatmap()));
             });
 
             AddUntilStep("wait for results screen presented", () => !songSelect.IsCurrentScreen());

From 9e9341597d3ba0ecc05b36f88fbf8dcad59f1d1b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 13 Dec 2021 17:59:04 +0900
Subject: [PATCH 1648/5547] Remove unused using statement

---
 osu.Game.Tests/Online/TestAPIModJsonSerialization.cs | 1 -
 1 file changed, 1 deletion(-)

diff --git a/osu.Game.Tests/Online/TestAPIModJsonSerialization.cs b/osu.Game.Tests/Online/TestAPIModJsonSerialization.cs
index 8b8954a1d0..4b160e1d67 100644
--- a/osu.Game.Tests/Online/TestAPIModJsonSerialization.cs
+++ b/osu.Game.Tests/Online/TestAPIModJsonSerialization.cs
@@ -13,7 +13,6 @@ using osu.Game.Online.Solo;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Difficulty;
 using osu.Game.Rulesets.Mods;
-using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Osu.Mods;
 using osu.Game.Rulesets.UI;
 using osu.Game.Scoring;

From c87ff82c1cde3af45c173fcb264de999340b743c Mon Sep 17 00:00:00 2001
From: rumoi <rumooe@gmail.com>
Date: Tue, 14 Dec 2021 09:25:29 +1300
Subject: [PATCH 1649/5547] calculateRhythmBonus performance fix.

---
 osu.Game.Rulesets.Osu/Difficulty/Skills/Speed.cs | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Speed.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Speed.cs
index d00d89a577..30d989cfba 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Speed.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Speed.cs
@@ -55,7 +55,12 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
 
             bool firstDeltaSwitch = false;
 
-            for (int i = Previous.Count - 2; i > 0; i--)
+            int rhythmStart = Math.Min(Previous.Count - 2, 0);
+
+            while (rhythmStart < Previous.Count - 2 && current.StartTime - Previous[rhythmStart].StartTime < history_time_max)
+                rhythmStart++;
+
+            for (int i = rhythmStart; i > 0; i--)
             {
                 OsuDifficultyHitObject currObj = (OsuDifficultyHitObject)Previous[i - 1];
                 OsuDifficultyHitObject prevObj = (OsuDifficultyHitObject)Previous[i];

From 6e3558b2226d834bd57146dec9bcd197ab441c30 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 14 Dec 2021 06:38:57 +0900
Subject: [PATCH 1650/5547] Remove weird test

---
 .../TestScenePlaylistsRoomCreation.cs         | 36 -------------------
 1 file changed, 36 deletions(-)

diff --git a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs
index c5287d4257..450e821ba6 100644
--- a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs
+++ b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs
@@ -109,42 +109,6 @@ namespace osu.Game.Tests.Visual.Playlists
             AddAssert("first playlist item selected", () => match.SelectedItem.Value == SelectedRoom.Value.Playlist[0]);
         }
 
-        [Test]
-        public void TestBeatmapUpdatedOnReImport()
-        {
-            BeatmapSetInfo importedSet = null;
-
-            AddStep("import altered beatmap", () =>
-            {
-                IBeatmap beatmap = CreateBeatmap(new OsuRuleset().RulesetInfo);
-
-                beatmap.BeatmapInfo.BaseDifficulty.CircleSize = 1;
-
-                // intentionally increment online IDs to clash with import below.
-                beatmap.BeatmapInfo.OnlineID++;
-                beatmap.BeatmapInfo.BeatmapSet.OnlineID++;
-
-                importedSet = manager.Import(beatmap.BeatmapInfo.BeatmapSet).Result.Value;
-            });
-
-            setupAndCreateRoom(room =>
-            {
-                room.Name.Value = "my awesome room";
-                room.Host.Value = API.LocalUser.Value;
-                room.Playlist.Add(new PlaylistItem
-                {
-                    Beatmap = { Value = importedSet.Beatmaps[0] },
-                    Ruleset = { Value = new OsuRuleset().RulesetInfo }
-                });
-            });
-
-            AddAssert("match has altered beatmap", () => match.Beatmap.Value.Beatmap.Difficulty.CircleSize == 1);
-
-            importBeatmap();
-
-            AddAssert("match has original beatmap", () => match.Beatmap.Value.Beatmap.Difficulty.CircleSize != 1);
-        }
-
         private void setupAndCreateRoom(Action<Room> room)
         {
             AddStep("setup room", () => room(SelectedRoom.Value));

From 7564658b5e01c780feadd62dccabbf1f8a051d31 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 14 Dec 2021 06:40:45 +0900
Subject: [PATCH 1651/5547] Reduce to 30s

---
 osu.Game/Online/Rooms/SubmitRoomScoreRequest.cs | 2 +-
 osu.Game/Online/Solo/SubmitSoloScoreRequest.cs  | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Online/Rooms/SubmitRoomScoreRequest.cs b/osu.Game/Online/Rooms/SubmitRoomScoreRequest.cs
index 4ee4be6164..e24d113822 100644
--- a/osu.Game/Online/Rooms/SubmitRoomScoreRequest.cs
+++ b/osu.Game/Online/Rooms/SubmitRoomScoreRequest.cs
@@ -31,7 +31,7 @@ namespace osu.Game.Online.Rooms
 
             req.ContentType = "application/json";
             req.Method = HttpMethod.Put;
-            req.Timeout = 60000;
+            req.Timeout = 30000;
 
             req.AddRaw(JsonConvert.SerializeObject(score, new JsonSerializerSettings
             {
diff --git a/osu.Game/Online/Solo/SubmitSoloScoreRequest.cs b/osu.Game/Online/Solo/SubmitSoloScoreRequest.cs
index 763fcf3f20..99cf5ceff5 100644
--- a/osu.Game/Online/Solo/SubmitSoloScoreRequest.cs
+++ b/osu.Game/Online/Solo/SubmitSoloScoreRequest.cs
@@ -31,7 +31,7 @@ namespace osu.Game.Online.Solo
 
             req.ContentType = "application/json";
             req.Method = HttpMethod.Put;
-            req.Timeout = 60000;
+            req.Timeout = 30000;
 
             req.AddRaw(JsonConvert.SerializeObject(score, new JsonSerializerSettings
             {

From 2f1dc912117f91443d912961e3f16df71ee11529 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 14 Dec 2021 11:30:42 +0900
Subject: [PATCH 1652/5547] Add AbortLoad() method to abort gameplay loads

---
 .../Multiplayer/IMultiplayerRoomServer.cs     |  5 +++++
 .../Online/Multiplayer/MultiplayerClient.cs   |  2 ++
 .../Multiplayer/OnlineMultiplayerClient.cs    |  8 +++++++
 .../OnlinePlay/Multiplayer/Multiplayer.cs     | 21 +++++++++++++++++--
 .../Multiplayer/TestMultiplayerClient.cs      | 15 +++++++++++++
 5 files changed, 49 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Online/Multiplayer/IMultiplayerRoomServer.cs b/osu.Game/Online/Multiplayer/IMultiplayerRoomServer.cs
index 73fda78d00..200539def7 100644
--- a/osu.Game/Online/Multiplayer/IMultiplayerRoomServer.cs
+++ b/osu.Game/Online/Multiplayer/IMultiplayerRoomServer.cs
@@ -77,6 +77,11 @@ namespace osu.Game.Online.Multiplayer
         /// <exception cref="InvalidStateException">If an attempt to start the game occurs when the game's (or users') state disallows it.</exception>
         Task StartMatch();
 
+        /// <summary>
+        /// Aborts an ongoing gameplay load.
+        /// </summary>
+        Task AbortLoad();
+
         /// <summary>
         /// Adds an item to the playlist.
         /// </summary>
diff --git a/osu.Game/Online/Multiplayer/MultiplayerClient.cs b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
index 55b4def908..78d8362170 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
@@ -333,6 +333,8 @@ namespace osu.Game.Online.Multiplayer
 
         public abstract Task StartMatch();
 
+        public abstract Task AbortLoad();
+
         public abstract Task AddPlaylistItem(MultiplayerPlaylistItem item);
 
         public abstract Task EditPlaylistItem(MultiplayerPlaylistItem item);
diff --git a/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs b/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs
index d268d2bf69..3062cf8b99 100644
--- a/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs
@@ -154,6 +154,14 @@ namespace osu.Game.Online.Multiplayer
             return connection.InvokeAsync(nameof(IMultiplayerServer.StartMatch));
         }
 
+        public override Task AbortLoad()
+        {
+            if (!IsConnected.Value)
+                return Task.CompletedTask;
+
+            return connection.InvokeAsync(nameof(IMultiplayerServer.AbortLoad));
+        }
+
         public override Task AddPlaylistItem(MultiplayerPlaylistItem item)
         {
             if (!IsConnected.Value)
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Multiplayer.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Multiplayer.cs
index 58b5b7bbeb..c299fd285a 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Multiplayer.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Multiplayer.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.Diagnostics;
 using osu.Framework.Allocation;
 using osu.Framework.Screens;
 using osu.Game.Online.Multiplayer;
@@ -18,8 +19,24 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
         {
             base.OnResuming(last);
 
-            if (client.Room != null && client.LocalUser?.State != MultiplayerUserState.Spectating)
-                client.ChangeState(MultiplayerUserState.Idle);
+            if (client.Room == null)
+                return;
+
+            Debug.Assert(client.LocalUser != null);
+
+            switch (client.LocalUser.State)
+            {
+                case MultiplayerUserState.Spectating:
+                    break;
+
+                case MultiplayerUserState.WaitingForLoad:
+                    client.AbortLoad();
+                    break;
+
+                default:
+                    client.ChangeState(MultiplayerUserState.Idle);
+                    break;
+            }
         }
 
         protected override string ScreenTitle => "Multiplayer";
diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
index d22f0415e6..c928cfd137 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
@@ -242,6 +242,11 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
         public override Task ChangeState(MultiplayerUserState newState)
         {
+            Debug.Assert(Room != null);
+
+            if (newState == MultiplayerUserState.Idle && LocalUser?.State == MultiplayerUserState.WaitingForLoad)
+                return Task.CompletedTask;
+
             ChangeUserState(api.LocalUser.Value.Id, newState);
             return Task.CompletedTask;
         }
@@ -303,6 +308,16 @@ namespace osu.Game.Tests.Visual.Multiplayer
             return ((IMultiplayerClient)this).LoadRequested();
         }
 
+        public override Task AbortLoad()
+        {
+            Debug.Assert(Room != null);
+            Debug.Assert(LocalUser != null);
+
+            ChangeUserState(LocalUser.UserID, MultiplayerUserState.Idle);
+
+            return Task.CompletedTask;
+        }
+
         public async Task AddUserPlaylistItem(int userId, MultiplayerPlaylistItem item)
         {
             Debug.Assert(Room != null);

From 750bfae9092095881432f0ab35eee1bbcbf068a5 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 14 Dec 2021 11:35:56 +0900
Subject: [PATCH 1653/5547] Fix TestMultiplayerClient not handling all users
 bailing from gameplay

---
 .../Tests/Visual/Multiplayer/TestMultiplayerClient.cs | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
index c928cfd137..4c69f8f9d2 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
@@ -128,6 +128,15 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     case MultiplayerRoomState.WaitingForLoad:
                         if (Room.Users.All(u => u.State != MultiplayerUserState.WaitingForLoad))
                         {
+                            var loadedUsers = Room.Users.Where(u => u.State == MultiplayerUserState.Loaded).ToArray();
+
+                            if (loadedUsers.Length == 0)
+                            {
+                                // all users have bailed from the load sequence. cancel the game start.
+                                ChangeRoomState(MultiplayerRoomState.Open);
+                                return;
+                            }
+
                             foreach (var u in Room.Users.Where(u => u.State == MultiplayerUserState.Loaded))
                                 ChangeUserState(u.UserID, MultiplayerUserState.Playing);
 
@@ -143,8 +152,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
                         {
                             foreach (var u in Room.Users.Where(u => u.State == MultiplayerUserState.FinishedPlay))
                                 ChangeUserState(u.UserID, MultiplayerUserState.Results);
-                            ChangeRoomState(MultiplayerRoomState.Open);
 
+                            ChangeRoomState(MultiplayerRoomState.Open);
                             ((IMultiplayerClient)this).ResultsReady();
 
                             FinishCurrentItem().Wait();

From 357a6613790bf82f6bb1fccd0742317bcbd96e70 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 14 Dec 2021 13:13:12 +0900
Subject: [PATCH 1654/5547] Fix storyboard sprites sometimes starting too early

---
 osu.Game/Storyboards/StoryboardSprite.cs | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Storyboards/StoryboardSprite.cs b/osu.Game/Storyboards/StoryboardSprite.cs
index 6fb2f5994b..f941cec20c 100644
--- a/osu.Game/Storyboards/StoryboardSprite.cs
+++ b/osu.Game/Storyboards/StoryboardSprite.cs
@@ -33,10 +33,8 @@ namespace osu.Game.Storyboards
 
                 foreach (var l in loops)
                 {
-                    if (!(l.EarliestDisplayedTime is double lEarliest))
-                        continue;
-
-                    earliestStartTime = Math.Min(earliestStartTime, lEarliest);
+                    if (l.EarliestDisplayedTime != null)
+                        earliestStartTime = Math.Min(earliestStartTime, l.StartTime);
                 }
 
                 if (earliestStartTime < double.MaxValue)

From 7e576ae9d3adc3133c03437e705a9a8879997205 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 14 Dec 2021 13:25:19 +0900
Subject: [PATCH 1655/5547] Add note about how the background colour is
 restored

---
 osu.Game/Screens/Play/FailAnimation.cs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Game/Screens/Play/FailAnimation.cs b/osu.Game/Screens/Play/FailAnimation.cs
index aa777f18a8..cfbfdc9966 100644
--- a/osu.Game/Screens/Play/FailAnimation.cs
+++ b/osu.Game/Screens/Play/FailAnimation.cs
@@ -145,6 +145,7 @@ namespace osu.Game.Screens.Play
             Content.RotateTo(1, duration, Easing.OutQuart);
             Content.FadeColour(Color4.Gray, duration);
 
+            // Will be restored by `ApplyToBackground` logic in `SongSelect`.
             Background?.FadeColour(OsuColour.Gray(0.3f), 60);
         }
 

From 8e6c7eb030fa523a6fe64273e4480b24fa6e49bc Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 14 Dec 2021 13:52:27 +0900
Subject: [PATCH 1656/5547] Use `OsuStorage` in realm tests to allow for
 migration

Also changes the realm filename to use `client` to match the ignore
rules in `OsuStorage`. Without doing this, migration will fail in an
indefinite mutex wait when attempting to delete the realm `.note` file.
---
 osu.Game.Tests/Database/RealmTest.cs | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Tests/Database/RealmTest.cs b/osu.Game.Tests/Database/RealmTest.cs
index 04c9f2577a..6904464485 100644
--- a/osu.Game.Tests/Database/RealmTest.cs
+++ b/osu.Game.Tests/Database/RealmTest.cs
@@ -10,6 +10,7 @@ using osu.Framework.Logging;
 using osu.Framework.Platform;
 using osu.Framework.Testing;
 using osu.Game.Database;
+using osu.Game.IO;
 using osu.Game.Models;
 
 #nullable enable
@@ -27,15 +28,16 @@ namespace osu.Game.Tests.Database
             storage.DeleteDirectory(string.Empty);
         }
 
-        protected void RunTestWithRealm(Action<RealmContextFactory, Storage> testAction, [CallerMemberName] string caller = "")
+        protected void RunTestWithRealm(Action<RealmContextFactory, OsuStorage> testAction, [CallerMemberName] string caller = "")
         {
             using (HeadlessGameHost host = new CleanRunHeadlessGameHost(caller))
             {
                 host.Run(new RealmTestGame(() =>
                 {
-                    var testStorage = storage.GetStorageForDirectory(caller);
+                    // ReSharper disable once AccessToDisposedClosure
+                    var testStorage = new OsuStorage(host, storage.GetStorageForDirectory(caller));
 
-                    using (var realmFactory = new RealmContextFactory(testStorage, caller))
+                    using (var realmFactory = new RealmContextFactory(testStorage, "client"))
                     {
                         Logger.Log($"Running test using realm file {testStorage.GetFullPath(realmFactory.Filename)}");
                         testAction(realmFactory, testStorage);
@@ -58,7 +60,7 @@ namespace osu.Game.Tests.Database
                 {
                     var testStorage = storage.GetStorageForDirectory(caller);
 
-                    using (var realmFactory = new RealmContextFactory(testStorage, caller))
+                    using (var realmFactory = new RealmContextFactory(testStorage, "client"))
                     {
                         Logger.Log($"Running test using realm file {testStorage.GetFullPath(realmFactory.Filename)}");
                         await testAction(realmFactory, testStorage);

From be337b4acea61c1bfea6b05442ad5d0201d63d3d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 14 Dec 2021 13:53:23 +0900
Subject: [PATCH 1657/5547] Add failing test coverage of `RealmLive` failing
 post storage migration

---
 osu.Game.Tests/Database/RealmLiveTests.cs | 28 +++++++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/osu.Game.Tests/Database/RealmLiveTests.cs b/osu.Game.Tests/Database/RealmLiveTests.cs
index 9b6769b788..1d197791a4 100644
--- a/osu.Game.Tests/Database/RealmLiveTests.cs
+++ b/osu.Game.Tests/Database/RealmLiveTests.cs
@@ -6,6 +6,7 @@ using System.Diagnostics;
 using System.Linq;
 using System.Threading.Tasks;
 using NUnit.Framework;
+using osu.Framework.Testing;
 using osu.Game.Database;
 using osu.Game.Models;
 using Realms;
@@ -29,6 +30,33 @@ namespace osu.Game.Tests.Database
             });
         }
 
+        [Test]
+        public void TestAccessAfterStorageMigrate()
+        {
+            RunTestWithRealm((realmFactory, storage) =>
+            {
+                var beatmap = new RealmBeatmap(CreateRuleset(), new RealmBeatmapDifficulty(), new RealmBeatmapMetadata());
+
+                ILive<RealmBeatmap> liveBeatmap;
+
+                using (var context = realmFactory.CreateContext())
+                {
+                    context.Write(r => r.Add(beatmap));
+
+                    liveBeatmap = beatmap.ToLive();
+                }
+
+                using (var migratedStorage = new TemporaryNativeStorage("realm-test-migration-target"))
+                {
+                    migratedStorage.DeleteDirectory(string.Empty);
+
+                    storage.Migrate(migratedStorage);
+
+                    Assert.IsFalse(liveBeatmap.PerformRead(l => l.Hidden));
+                }
+            });
+        }
+
         [Test]
         public void TestAccessAfterAttach()
         {

From f9a2db5ec6dbf7e87b0cf2c578d7f81be0aa0138 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 14 Dec 2021 14:19:43 +0900
Subject: [PATCH 1658/5547] Add accessibility to realm factory via
 `IStorageResourceProvider`

We might need to rename this class..
---
 osu.Game.Tests/Gameplay/TestSceneStoryboardSamples.cs | 2 ++
 osu.Game/Beatmaps/WorkingBeatmapCache.cs              | 2 ++
 osu.Game/IO/IStorageResourceProvider.cs               | 6 ++++++
 osu.Game/Tests/Beatmaps/HitObjectSampleTest.cs        | 2 ++
 osu.Game/Tests/Visual/SkinnableTestScene.cs           | 2 ++
 5 files changed, 14 insertions(+)

diff --git a/osu.Game.Tests/Gameplay/TestSceneStoryboardSamples.cs b/osu.Game.Tests/Gameplay/TestSceneStoryboardSamples.cs
index 88f35976ad..3aab28886e 100644
--- a/osu.Game.Tests/Gameplay/TestSceneStoryboardSamples.cs
+++ b/osu.Game.Tests/Gameplay/TestSceneStoryboardSamples.cs
@@ -15,6 +15,7 @@ using osu.Framework.IO.Stores;
 using osu.Framework.Testing;
 using osu.Framework.Utils;
 using osu.Game.Audio;
+using osu.Game.Database;
 using osu.Game.IO;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Mods;
@@ -220,6 +221,7 @@ namespace osu.Game.Tests.Gameplay
         public AudioManager AudioManager => Audio;
         public IResourceStore<byte[]> Files => null;
         public new IResourceStore<byte[]> Resources => base.Resources;
+        public RealmContextFactory RealmContextFactory => null;
         public IResourceStore<TextureUpload> CreateTextureLoaderStore(IResourceStore<byte[]> underlyingStore) => null;
 
         #endregion
diff --git a/osu.Game/Beatmaps/WorkingBeatmapCache.cs b/osu.Game/Beatmaps/WorkingBeatmapCache.cs
index 559685d3c4..449406eadf 100644
--- a/osu.Game/Beatmaps/WorkingBeatmapCache.cs
+++ b/osu.Game/Beatmaps/WorkingBeatmapCache.cs
@@ -15,6 +15,7 @@ using osu.Framework.Platform;
 using osu.Framework.Statistics;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps.Formats;
+using osu.Game.Database;
 using osu.Game.IO;
 using osu.Game.Skinning;
 using osu.Game.Storyboards;
@@ -108,6 +109,7 @@ namespace osu.Game.Beatmaps
         TextureStore IBeatmapResourceProvider.LargeTextureStore => largeTextureStore;
         ITrackStore IBeatmapResourceProvider.Tracks => trackStore;
         AudioManager IStorageResourceProvider.AudioManager => audioManager;
+        RealmContextFactory IStorageResourceProvider.RealmContextFactory => null;
         IResourceStore<byte[]> IStorageResourceProvider.Files => files;
         IResourceStore<byte[]> IStorageResourceProvider.Resources => resources;
         IResourceStore<TextureUpload> IStorageResourceProvider.CreateTextureLoaderStore(IResourceStore<byte[]> underlyingStore) => host?.CreateTextureLoaderStore(underlyingStore);
diff --git a/osu.Game/IO/IStorageResourceProvider.cs b/osu.Game/IO/IStorageResourceProvider.cs
index e4c97e18fa..950b5aae09 100644
--- a/osu.Game/IO/IStorageResourceProvider.cs
+++ b/osu.Game/IO/IStorageResourceProvider.cs
@@ -4,6 +4,7 @@
 using osu.Framework.Audio;
 using osu.Framework.Graphics.Textures;
 using osu.Framework.IO.Stores;
+using osu.Game.Database;
 
 namespace osu.Game.IO
 {
@@ -24,6 +25,11 @@ namespace osu.Game.IO
         /// </summary>
         IResourceStore<byte[]> Resources { get; }
 
+        /// <summary>
+        /// Access realm.
+        /// </summary>
+        RealmContextFactory RealmContextFactory { get; }
+
         /// <summary>
         /// Create a texture loader store based on an underlying data store.
         /// </summary>
diff --git a/osu.Game/Tests/Beatmaps/HitObjectSampleTest.cs b/osu.Game/Tests/Beatmaps/HitObjectSampleTest.cs
index 31a2071249..f919edecf7 100644
--- a/osu.Game/Tests/Beatmaps/HitObjectSampleTest.cs
+++ b/osu.Game/Tests/Beatmaps/HitObjectSampleTest.cs
@@ -14,6 +14,7 @@ using osu.Framework.Testing;
 using osu.Framework.Timing;
 using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.Formats;
+using osu.Game.Database;
 using osu.Game.IO;
 using osu.Game.Models;
 using osu.Game.Rulesets;
@@ -118,6 +119,7 @@ namespace osu.Game.Tests.Beatmaps
         public IResourceStore<byte[]> Files => userSkinResourceStore;
         public new IResourceStore<byte[]> Resources => base.Resources;
         public IResourceStore<TextureUpload> CreateTextureLoaderStore(IResourceStore<byte[]> underlyingStore) => null;
+        RealmContextFactory IStorageResourceProvider.RealmContextFactory => null;
 
         #endregion
 
diff --git a/osu.Game/Tests/Visual/SkinnableTestScene.cs b/osu.Game/Tests/Visual/SkinnableTestScene.cs
index cdd3e47930..22aac79056 100644
--- a/osu.Game/Tests/Visual/SkinnableTestScene.cs
+++ b/osu.Game/Tests/Visual/SkinnableTestScene.cs
@@ -15,6 +15,7 @@ using osu.Framework.Graphics.Textures;
 using osu.Framework.IO.Stores;
 using osu.Framework.Platform;
 using osu.Game.Beatmaps;
+using osu.Game.Database;
 using osu.Game.Graphics.Sprites;
 using osu.Game.IO;
 using osu.Game.Rulesets;
@@ -158,6 +159,7 @@ namespace osu.Game.Tests.Visual
         public IResourceStore<byte[]> Files => null;
         public new IResourceStore<byte[]> Resources => base.Resources;
         public IResourceStore<TextureUpload> CreateTextureLoaderStore(IResourceStore<byte[]> underlyingStore) => host.CreateTextureLoaderStore(underlyingStore);
+        RealmContextFactory IStorageResourceProvider.RealmContextFactory => null;
 
         #endregion
 

From 441b7baa93225658fd82ed78420fd597bcd8bb62 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 14 Dec 2021 14:21:23 +0900
Subject: [PATCH 1659/5547] Provide a realm factory to usages of
 `ToLive`/`RealmLive`

---
 .../Editor/TestSceneManiaComposeScreen.cs     |  4 +--
 osu.Game.Tests/Database/RealmLiveTests.cs     | 22 +++++++-------
 .../TestSceneBackgroundScreenDefault.cs       |  2 +-
 .../Gameplay/TestSceneBeatmapSkinFallbacks.cs |  2 +-
 osu.Game/Database/RealmLive.cs                | 30 ++++++++++++-------
 osu.Game/Database/RealmObjectExtensions.cs    | 20 ++++++++++---
 osu.Game/OsuGame.cs                           |  4 +--
 .../Overlays/Settings/Sections/SkinSection.cs |  6 ++--
 osu.Game/Skinning/Skin.cs                     |  2 +-
 osu.Game/Skinning/SkinManager.cs              | 13 ++++----
 osu.Game/Stores/RealmArchiveModelImporter.cs  |  6 ++--
 11 files changed, 67 insertions(+), 44 deletions(-)

diff --git a/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneManiaComposeScreen.cs b/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneManiaComposeScreen.cs
index 91f5f93905..a30e09cd29 100644
--- a/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneManiaComposeScreen.cs
+++ b/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneManiaComposeScreen.cs
@@ -56,13 +56,13 @@ namespace osu.Game.Rulesets.Mania.Tests.Editor
         [Test]
         public void TestDefaultSkin()
         {
-            AddStep("set default skin", () => skins.CurrentSkinInfo.Value = DefaultSkin.CreateInfo().ToLive());
+            AddStep("set default skin", () => skins.CurrentSkinInfo.Value = DefaultSkin.CreateInfo().ToLiveUnmanaged());
         }
 
         [Test]
         public void TestLegacySkin()
         {
-            AddStep("set legacy skin", () => skins.CurrentSkinInfo.Value = DefaultLegacySkin.CreateInfo().ToLive());
+            AddStep("set legacy skin", () => skins.CurrentSkinInfo.Value = DefaultLegacySkin.CreateInfo().ToLiveUnmanaged());
         }
     }
 }
diff --git a/osu.Game.Tests/Database/RealmLiveTests.cs b/osu.Game.Tests/Database/RealmLiveTests.cs
index 1d197791a4..06cb5a3607 100644
--- a/osu.Game.Tests/Database/RealmLiveTests.cs
+++ b/osu.Game.Tests/Database/RealmLiveTests.cs
@@ -22,9 +22,9 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealm((realmFactory, _) =>
             {
-                ILive<RealmBeatmap> beatmap = realmFactory.CreateContext().Write(r => r.Add(new RealmBeatmap(CreateRuleset(), new RealmBeatmapDifficulty(), new RealmBeatmapMetadata()))).ToLive();
+                ILive<RealmBeatmap> beatmap = realmFactory.CreateContext().Write(r => r.Add(new RealmBeatmap(CreateRuleset(), new RealmBeatmapDifficulty(), new RealmBeatmapMetadata()))).ToLive(realmFactory);
 
-                ILive<RealmBeatmap> beatmap2 = realmFactory.CreateContext().All<RealmBeatmap>().First().ToLive();
+                ILive<RealmBeatmap> beatmap2 = realmFactory.CreateContext().All<RealmBeatmap>().First().ToLive(realmFactory);
 
                 Assert.AreEqual(beatmap, beatmap2);
             });
@@ -43,7 +43,7 @@ namespace osu.Game.Tests.Database
                 {
                     context.Write(r => r.Add(beatmap));
 
-                    liveBeatmap = beatmap.ToLive();
+                    liveBeatmap = beatmap.ToLive(realmFactory);
                 }
 
                 using (var migratedStorage = new TemporaryNativeStorage("realm-test-migration-target"))
@@ -64,7 +64,7 @@ namespace osu.Game.Tests.Database
             {
                 var beatmap = new RealmBeatmap(CreateRuleset(), new RealmBeatmapDifficulty(), new RealmBeatmapMetadata());
 
-                var liveBeatmap = beatmap.ToLive();
+                var liveBeatmap = beatmap.ToLive(realmFactory);
 
                 using (var context = realmFactory.CreateContext())
                     context.Write(r => r.Add(beatmap));
@@ -77,7 +77,7 @@ namespace osu.Game.Tests.Database
         public void TestAccessNonManaged()
         {
             var beatmap = new RealmBeatmap(CreateRuleset(), new RealmBeatmapDifficulty(), new RealmBeatmapMetadata());
-            var liveBeatmap = beatmap.ToLive();
+            var liveBeatmap = beatmap.ToLiveUnmanaged();
 
             Assert.IsFalse(beatmap.Hidden);
             Assert.IsFalse(liveBeatmap.Value.Hidden);
@@ -102,7 +102,7 @@ namespace osu.Game.Tests.Database
                     {
                         var beatmap = threadContext.Write(r => r.Add(new RealmBeatmap(CreateRuleset(), new RealmBeatmapDifficulty(), new RealmBeatmapMetadata())));
 
-                        liveBeatmap = beatmap.ToLive();
+                        liveBeatmap = beatmap.ToLive(realmFactory);
                     }
                 }, TaskCreationOptions.LongRunning | TaskCreationOptions.HideScheduler).Wait();
 
@@ -131,7 +131,7 @@ namespace osu.Game.Tests.Database
                     {
                         var beatmap = threadContext.Write(r => r.Add(new RealmBeatmap(CreateRuleset(), new RealmBeatmapDifficulty(), new RealmBeatmapMetadata())));
 
-                        liveBeatmap = beatmap.ToLive();
+                        liveBeatmap = beatmap.ToLive(realmFactory);
                     }
                 }, TaskCreationOptions.LongRunning | TaskCreationOptions.HideScheduler).Wait();
 
@@ -151,7 +151,7 @@ namespace osu.Game.Tests.Database
             RunTestWithRealm((realmFactory, _) =>
             {
                 var beatmap = new RealmBeatmap(CreateRuleset(), new RealmBeatmapDifficulty(), new RealmBeatmapMetadata());
-                var liveBeatmap = beatmap.ToLive();
+                var liveBeatmap = beatmap.ToLive(realmFactory);
 
                 Assert.DoesNotThrow(() =>
                 {
@@ -173,7 +173,7 @@ namespace osu.Game.Tests.Database
                     {
                         var beatmap = threadContext.Write(r => r.Add(new RealmBeatmap(CreateRuleset(), new RealmBeatmapDifficulty(), new RealmBeatmapMetadata())));
 
-                        liveBeatmap = beatmap.ToLive();
+                        liveBeatmap = beatmap.ToLive(realmFactory);
                     }
                 }, TaskCreationOptions.LongRunning | TaskCreationOptions.HideScheduler).Wait();
 
@@ -211,7 +211,7 @@ namespace osu.Game.Tests.Database
                     {
                         var beatmap = threadContext.Write(r => r.Add(new RealmBeatmap(CreateRuleset(), new RealmBeatmapDifficulty(), new RealmBeatmapMetadata())));
 
-                        liveBeatmap = beatmap.ToLive();
+                        liveBeatmap = beatmap.ToLive(realmFactory);
                     }
                 }, TaskCreationOptions.LongRunning | TaskCreationOptions.HideScheduler).Wait();
 
@@ -250,7 +250,7 @@ namespace osu.Game.Tests.Database
                             // not just a refresh from the resolved Live.
                             threadContext.Write(r => r.Add(new RealmBeatmap(ruleset, new RealmBeatmapDifficulty(), new RealmBeatmapMetadata())));
 
-                            liveBeatmap = beatmap.ToLive();
+                            liveBeatmap = beatmap.ToLive(realmFactory);
                         }
                     }, TaskCreationOptions.LongRunning | TaskCreationOptions.HideScheduler).Wait();
 
diff --git a/osu.Game.Tests/Visual/Background/TestSceneBackgroundScreenDefault.cs b/osu.Game.Tests/Visual/Background/TestSceneBackgroundScreenDefault.cs
index bdd1b92c8d..4762d3cded 100644
--- a/osu.Game.Tests/Visual/Background/TestSceneBackgroundScreenDefault.cs
+++ b/osu.Game.Tests/Visual/Background/TestSceneBackgroundScreenDefault.cs
@@ -123,7 +123,7 @@ namespace osu.Game.Tests.Visual.Background
         private void setCustomSkin()
         {
             // feign a skin switch. this doesn't do anything except force CurrentSkin to become a LegacySkin.
-            AddStep("set custom skin", () => skins.CurrentSkinInfo.Value = new SkinInfo().ToLive());
+            AddStep("set custom skin", () => skins.CurrentSkinInfo.Value = new SkinInfo().ToLiveUnmanaged());
         }
 
         private void setDefaultSkin() => AddStep("set default skin", () => skins.CurrentSkinInfo.SetDefault());
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneBeatmapSkinFallbacks.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneBeatmapSkinFallbacks.cs
index cccc962a3f..c5f56cae9e 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneBeatmapSkinFallbacks.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneBeatmapSkinFallbacks.cs
@@ -53,7 +53,7 @@ namespace osu.Game.Tests.Visual.Gameplay
             {
                 AddStep("setup skins", () =>
                 {
-                    skinManager.CurrentSkinInfo.Value = gameCurrentSkin.ToLive();
+                    skinManager.CurrentSkinInfo.Value = gameCurrentSkin.ToLiveUnmanaged();
                     currentBeatmapSkin = getBeatmapSkin();
                 });
             });
diff --git a/osu.Game/Database/RealmLive.cs b/osu.Game/Database/RealmLive.cs
index c376d5d503..4f7bdf93e4 100644
--- a/osu.Game/Database/RealmLive.cs
+++ b/osu.Game/Database/RealmLive.cs
@@ -24,14 +24,22 @@ namespace osu.Game.Database
         /// </summary>
         private readonly T data;
 
+        private readonly RealmContextFactory? realmFactory;
+
         /// <summary>
         /// Construct a new instance of live realm data.
         /// </summary>
         /// <param name="data">The realm data.</param>
-        public RealmLive(T data)
+        /// <param name="realmFactory">The realm factory the data was sourced from. May be null for an unmanaged object.</param>
+        public RealmLive(T data, RealmContextFactory? realmFactory)
         {
             this.data = data;
 
+            if (IsManaged && realmFactory == null)
+                throw new ArgumentException(@"Realm factory must be provided for a managed instance", nameof(realmFactory));
+
+            this.realmFactory = realmFactory;
+
             ID = data.ID;
         }
 
@@ -47,7 +55,10 @@ namespace osu.Game.Database
                 return;
             }
 
-            using (var realm = Realm.GetInstance(data.Realm.Config))
+            if (realmFactory == null)
+                throw new ArgumentException(@"Realm factory must be provided for a managed instance", nameof(realmFactory));
+
+            using (var realm = realmFactory.CreateContext())
                 perform(realm.Find<T>(ID));
         }
 
@@ -58,12 +69,15 @@ namespace osu.Game.Database
         public TReturn PerformRead<TReturn>(Func<T, TReturn> perform)
         {
             if (typeof(RealmObjectBase).IsAssignableFrom(typeof(TReturn)))
-                throw new InvalidOperationException($"Realm live objects should not exit the scope of {nameof(PerformRead)}.");
+                throw new InvalidOperationException(@$"Realm live objects should not exit the scope of {nameof(PerformRead)}.");
 
             if (!IsManaged)
                 return perform(data);
 
-            using (var realm = Realm.GetInstance(data.Realm.Config))
+            if (realmFactory == null)
+                throw new ArgumentException(@"Realm factory must be provided for a managed instance", nameof(realmFactory));
+
+            using (var realm = realmFactory.CreateContext())
                 return perform(realm.Find<T>(ID));
         }
 
@@ -74,7 +88,7 @@ namespace osu.Game.Database
         public void PerformWrite(Action<T> perform)
         {
             if (!IsManaged)
-                throw new InvalidOperationException("Can't perform writes on a non-managed underlying value");
+                throw new InvalidOperationException(@"Can't perform writes on a non-managed underlying value");
 
             PerformRead(t =>
             {
@@ -94,11 +108,7 @@ namespace osu.Game.Database
                 if (!ThreadSafety.IsUpdateThread)
                     throw new InvalidOperationException($"Can't use {nameof(Value)} on managed objects from non-update threads");
 
-                // When using Value, we rely on garbage collection for the realm instance used to retrieve the instance.
-                // As we are sure that this is on the update thread, there should always be an open and constantly refreshing realm instance to ensure file size growth is a non-issue.
-                var realm = Realm.GetInstance(data.Realm.Config);
-
-                return realm.Find<T>(ID);
+                return realmFactory!.Context.Find<T>(ID);
             }
         }
 
diff --git a/osu.Game/Database/RealmObjectExtensions.cs b/osu.Game/Database/RealmObjectExtensions.cs
index b38e21453c..c546a70fae 100644
--- a/osu.Game/Database/RealmObjectExtensions.cs
+++ b/osu.Game/Database/RealmObjectExtensions.cs
@@ -53,16 +53,28 @@ namespace osu.Game.Database
             return mapper.Map<T>(item);
         }
 
-        public static List<ILive<T>> ToLive<T>(this IEnumerable<T> realmList)
+        public static List<ILive<T>> ToLiveUnmanaged<T>(this IEnumerable<T> realmList)
             where T : RealmObject, IHasGuidPrimaryKey
         {
-            return realmList.Select(l => new RealmLive<T>(l)).Cast<ILive<T>>().ToList();
+            return realmList.Select(l => new RealmLive<T>(l, null)).Cast<ILive<T>>().ToList();
         }
 
-        public static ILive<T> ToLive<T>(this T realmObject)
+        public static ILive<T> ToLiveUnmanaged<T>(this T realmObject)
             where T : RealmObject, IHasGuidPrimaryKey
         {
-            return new RealmLive<T>(realmObject);
+            return new RealmLive<T>(realmObject, null);
+        }
+
+        public static List<ILive<T>> ToLive<T>(this IEnumerable<T> realmList, RealmContextFactory realmContextFactory)
+            where T : RealmObject, IHasGuidPrimaryKey
+        {
+            return realmList.Select(l => new RealmLive<T>(l, realmContextFactory)).Cast<ILive<T>>().ToList();
+        }
+
+        public static ILive<T> ToLive<T>(this T realmObject, RealmContextFactory realmContextFactory)
+            where T : RealmObject, IHasGuidPrimaryKey
+        {
+            return new RealmLive<T>(realmObject, realmContextFactory);
         }
 
         /// <summary>
diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index a35191613c..9c379de683 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -255,10 +255,10 @@ namespace osu.Game
                 if (skinInfo == null)
                 {
                     if (guid == SkinInfo.CLASSIC_SKIN)
-                        skinInfo = DefaultLegacySkin.CreateInfo().ToLive();
+                        skinInfo = DefaultLegacySkin.CreateInfo().ToLiveUnmanaged();
                 }
 
-                SkinManager.CurrentSkinInfo.Value = skinInfo ?? DefaultSkin.CreateInfo().ToLive();
+                SkinManager.CurrentSkinInfo.Value = skinInfo ?? DefaultSkin.CreateInfo().ToLiveUnmanaged();
             };
             configSkin.TriggerChange();
 
diff --git a/osu.Game/Overlays/Settings/Sections/SkinSection.cs b/osu.Game/Overlays/Settings/Sections/SkinSection.cs
index b1582d7bee..0fa6d78d4b 100644
--- a/osu.Game/Overlays/Settings/Sections/SkinSection.cs
+++ b/osu.Game/Overlays/Settings/Sections/SkinSection.cs
@@ -32,14 +32,14 @@ namespace osu.Game.Overlays.Settings.Sections
             Icon = FontAwesome.Solid.PaintBrush
         };
 
-        private readonly Bindable<ILive<SkinInfo>> dropdownBindable = new Bindable<ILive<SkinInfo>> { Default = DefaultSkin.CreateInfo().ToLive() };
+        private readonly Bindable<ILive<SkinInfo>> dropdownBindable = new Bindable<ILive<SkinInfo>> { Default = DefaultSkin.CreateInfo().ToLiveUnmanaged() };
         private readonly Bindable<string> configBindable = new Bindable<string>();
 
         private static readonly ILive<SkinInfo> random_skin_info = new SkinInfo
         {
             ID = SkinInfo.RANDOM_SKIN,
             Name = "<Random Skin>",
-        }.ToLive();
+        }.ToLiveUnmanaged();
 
         private List<ILive<SkinInfo>> skinItems;
 
@@ -133,7 +133,7 @@ namespace osu.Game.Overlays.Settings.Sections
         {
             int protectedCount = realmSkins.Count(s => s.Protected);
 
-            skinItems = realmSkins.ToLive();
+            skinItems = realmSkins.ToLive(realmFactory);
 
             skinItems.Insert(protectedCount, random_skin_info);
 
diff --git a/osu.Game/Skinning/Skin.cs b/osu.Game/Skinning/Skin.cs
index 54fc2340f1..ee92b6b40a 100644
--- a/osu.Game/Skinning/Skin.cs
+++ b/osu.Game/Skinning/Skin.cs
@@ -43,7 +43,7 @@ namespace osu.Game.Skinning
 
         protected Skin(SkinInfo skin, IStorageResourceProvider resources, [CanBeNull] Stream configurationStream = null)
         {
-            SkinInfo = skin.ToLive();
+            SkinInfo = skin.ToLive(resources.RealmContextFactory);
             this.resources = resources;
 
             configurationStream ??= getConfigurationStream();
diff --git a/osu.Game/Skinning/SkinManager.cs b/osu.Game/Skinning/SkinManager.cs
index 5134632fb1..bb2f0a37b4 100644
--- a/osu.Game/Skinning/SkinManager.cs
+++ b/osu.Game/Skinning/SkinManager.cs
@@ -47,9 +47,9 @@ namespace osu.Game.Skinning
 
         public readonly Bindable<Skin> CurrentSkin = new Bindable<Skin>();
 
-        public readonly Bindable<ILive<SkinInfo>> CurrentSkinInfo = new Bindable<ILive<SkinInfo>>(Skinning.DefaultSkin.CreateInfo().ToLive())
+        public readonly Bindable<ILive<SkinInfo>> CurrentSkinInfo = new Bindable<ILive<SkinInfo>>(Skinning.DefaultSkin.CreateInfo().ToLiveUnmanaged())
         {
-            Default = Skinning.DefaultSkin.CreateInfo().ToLive()
+            Default = Skinning.DefaultSkin.CreateInfo().ToLiveUnmanaged()
         };
 
         private readonly SkinModelManager skinModelManager;
@@ -119,13 +119,13 @@ namespace osu.Game.Skinning
 
                 if (randomChoices.Length == 0)
                 {
-                    CurrentSkinInfo.Value = Skinning.DefaultSkin.CreateInfo().ToLive();
+                    CurrentSkinInfo.Value = Skinning.DefaultSkin.CreateInfo().ToLiveUnmanaged();
                     return;
                 }
 
                 var chosen = randomChoices.ElementAt(RNG.Next(0, randomChoices.Length));
 
-                CurrentSkinInfo.Value = chosen.ToLive();
+                CurrentSkinInfo.Value = chosen.ToLive(contextFactory);
             }
         }
 
@@ -182,7 +182,7 @@ namespace osu.Game.Skinning
         public ILive<SkinInfo> Query(Expression<Func<SkinInfo, bool>> query)
         {
             using (var context = contextFactory.CreateContext())
-                return context.All<SkinInfo>().FirstOrDefault(query)?.ToLive();
+                return context.All<SkinInfo>().FirstOrDefault(query)?.ToLive(contextFactory);
         }
 
         public event Action SourceChanged;
@@ -237,6 +237,7 @@ namespace osu.Game.Skinning
         AudioManager IStorageResourceProvider.AudioManager => audio;
         IResourceStore<byte[]> IStorageResourceProvider.Resources => resources;
         IResourceStore<byte[]> IStorageResourceProvider.Files => userFiles;
+        RealmContextFactory IStorageResourceProvider.RealmContextFactory => contextFactory;
         IResourceStore<TextureUpload> IStorageResourceProvider.CreateTextureLoaderStore(IResourceStore<byte[]> underlyingStore) => host.CreateTextureLoaderStore(underlyingStore);
 
         #endregion
@@ -302,7 +303,7 @@ namespace osu.Game.Skinning
                 Guid currentUserSkin = CurrentSkinInfo.Value.ID;
 
                 if (items.Any(s => s.ID == currentUserSkin))
-                    scheduler.Add(() => CurrentSkinInfo.Value = Skinning.DefaultSkin.CreateInfo().ToLive());
+                    scheduler.Add(() => CurrentSkinInfo.Value = Skinning.DefaultSkin.CreateInfo().ToLiveUnmanaged());
 
                 skinModelManager.Delete(items.ToList(), silent);
             }
diff --git a/osu.Game/Stores/RealmArchiveModelImporter.cs b/osu.Game/Stores/RealmArchiveModelImporter.cs
index 1681dad750..4aca079e2e 100644
--- a/osu.Game/Stores/RealmArchiveModelImporter.cs
+++ b/osu.Game/Stores/RealmArchiveModelImporter.cs
@@ -352,7 +352,7 @@ namespace osu.Game.Stores
                                 transaction.Commit();
                             }
 
-                            return existing.ToLive();
+                            return existing.ToLive(ContextFactory);
                         }
 
                         LogForModel(item, @"Found existing (optimised) but failed pre-check.");
@@ -387,7 +387,7 @@ namespace osu.Game.Stores
                                 existing.DeletePending = false;
                                 transaction.Commit();
 
-                                return existing.ToLive();
+                                return existing.ToLive(ContextFactory);
                             }
 
                             LogForModel(item, @"Found existing but failed re-use check.");
@@ -416,7 +416,7 @@ namespace osu.Game.Stores
                     throw;
                 }
 
-                return item.ToLive();
+                return item.ToLive(ContextFactory);
             }
         }
 

From eb3050b2ac9fd4245d9006eb300e844ed90c3178 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 14 Dec 2021 15:08:00 +0900
Subject: [PATCH 1660/5547] Fix incorrect test

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

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneLeadIn.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneLeadIn.cs
index f5f17a0bc1..e03c8d7561 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneLeadIn.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneLeadIn.cs
@@ -85,11 +85,12 @@ namespace osu.Game.Tests.Visual.Gameplay
             loopGroup.Scale.Add(Easing.None, -20000, -18000, 0, 1);
 
             var target = addEventToLoop ? loopGroup : sprite.TimelineGroup;
-            target.Alpha.Add(Easing.None, firstStoryboardEvent, firstStoryboardEvent + 500, 0, 1);
+            double targetTime = addEventToLoop ? 20000 : 0;
+            target.Alpha.Add(Easing.None, targetTime + firstStoryboardEvent, targetTime + firstStoryboardEvent + 500, 0, 1);
 
             // 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, 18000, 20000, 0, 1);
+            loopGroup.Alpha.Add(Easing.None, 38000, 40000, 0, 1);
 
             storyboard.GetLayer("Background").Add(sprite);
 

From b6a272e31a0fe8300761532c5688b3b0320d6e4a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 14 Dec 2021 16:10:53 +0900
Subject: [PATCH 1661/5547] Add failing test coverage of
 `BackgroundScreeNDefault`'s beatmap background tracking when
 active/non-active

---
 .../TestSceneBackgroundScreenDefault.cs       | 134 +++++++++++++++++-
 .../Backgrounds/BackgroundScreenDefault.cs    |   2 +-
 2 files changed, 129 insertions(+), 7 deletions(-)

diff --git a/osu.Game.Tests/Visual/Background/TestSceneBackgroundScreenDefault.cs b/osu.Game.Tests/Visual/Background/TestSceneBackgroundScreenDefault.cs
index bdd1b92c8d..476eadf9bb 100644
--- a/osu.Game.Tests/Visual/Background/TestSceneBackgroundScreenDefault.cs
+++ b/osu.Game.Tests/Visual/Background/TestSceneBackgroundScreenDefault.cs
@@ -5,8 +5,11 @@ using System;
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
+using osu.Framework.Audio;
+using osu.Framework.Graphics.Textures;
 using osu.Framework.Screens;
 using osu.Framework.Testing;
+using osu.Game.Beatmaps;
 using osu.Game.Configuration;
 using osu.Game.Database;
 using osu.Game.Graphics.Backgrounds;
@@ -15,6 +18,7 @@ using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Screens;
 using osu.Game.Screens.Backgrounds;
 using osu.Game.Skinning;
+using osu.Game.Tests.Beatmaps;
 
 namespace osu.Game.Tests.Visual.Background
 {
@@ -22,8 +26,7 @@ namespace osu.Game.Tests.Visual.Background
     public class TestSceneBackgroundScreenDefault : OsuTestScene
     {
         private BackgroundScreenStack stack;
-        private BackgroundScreenDefault screen;
-
+        private TestBackgroundScreenDefault screen;
         private Graphics.Backgrounds.Background getCurrentBackground() => screen.ChildrenOfType<Graphics.Backgrounds.Background>().FirstOrDefault();
 
         [Resolved]
@@ -36,10 +39,95 @@ namespace osu.Game.Tests.Visual.Background
         public void SetUpSteps()
         {
             AddStep("create background stack", () => Child = stack = new BackgroundScreenStack());
-            AddStep("push default screen", () => stack.Push(screen = new BackgroundScreenDefault(false)));
+            AddStep("push default screen", () => stack.Push(screen = new TestBackgroundScreenDefault()));
             AddUntilStep("wait for screen to load", () => screen.IsCurrentScreen());
         }
 
+        [Test]
+        public void TestBeatmapBackgroundTracksBeatmap()
+        {
+            setSupporter(true);
+            setSourceMode(BackgroundSource.Beatmap);
+
+            AddStep("change beatmap", () => Beatmap.Value = createTestWorkingBeatmapWithUniqueBackground());
+            AddAssert("background changed", () => screen.CheckLastLoadChange() == true);
+
+            Graphics.Backgrounds.Background last = null;
+
+            AddUntilStep("wait for beatmap background to be loaded", () => getCurrentBackground()?.GetType() == typeof(BeatmapBackground));
+            AddStep("store background", () => last = getCurrentBackground());
+
+            AddStep("change beatmap", () => Beatmap.Value = createTestWorkingBeatmapWithUniqueBackground());
+
+            AddUntilStep("wait for beatmap background to change", () => screen.CheckLastLoadChange() == true);
+
+            AddUntilStep("background is new beatmap background", () => last != getCurrentBackground());
+            AddStep("store background", () => last = getCurrentBackground());
+
+            AddStep("change beatmap", () => Beatmap.Value = createTestWorkingBeatmapWithUniqueBackground());
+
+            AddUntilStep("wait for beatmap background to change", () => screen.CheckLastLoadChange() == true);
+            AddUntilStep("background is new beatmap background", () => last != getCurrentBackground());
+        }
+
+        [Test]
+        public void TestBeatmapBackgroundTracksBeatmapWhenSuspended()
+        {
+            setSupporter(true);
+            setSourceMode(BackgroundSource.Beatmap);
+
+            AddStep("change beatmap", () => Beatmap.Value = createTestWorkingBeatmapWithUniqueBackground());
+            AddAssert("background changed", () => screen.CheckLastLoadChange() == true);
+            AddUntilStep("wait for beatmap background to be loaded", () => getCurrentBackground()?.GetType() == typeof(BeatmapBackground));
+
+            BackgroundScreenBeatmap nestedScreen = null;
+
+            // of note, this needs to be a type that doesn't match BackgroundScreenDefault else it is silently not pushed by the background stack.
+            AddStep("push new background to stack", () => stack.Push(nestedScreen = new BackgroundScreenBeatmap(Beatmap.Value)));
+            AddUntilStep("wait for screen to load", () => nestedScreen.IsLoaded && nestedScreen.IsCurrentScreen());
+
+            AddAssert("top level background hasn't changed yet", () => screen.CheckLastLoadChange() == null);
+
+            AddStep("change beatmap", () => Beatmap.Value = createTestWorkingBeatmapWithUniqueBackground());
+
+            AddAssert("top level background hasn't changed yet", () => screen.CheckLastLoadChange() == null);
+
+            AddStep("pop screen back to top level", () => screen.MakeCurrent());
+
+            AddAssert("top level background changed", () => screen.CheckLastLoadChange() == true);
+        }
+
+        [Test]
+        public void TestBeatmapBackgroundIgnoresNoChangeWhenSuspended()
+        {
+            BackgroundScreenBeatmap nestedScreen = null;
+            WorkingBeatmap originalWorking = null;
+
+            setSupporter(true);
+            setSourceMode(BackgroundSource.Beatmap);
+
+            AddStep("change beatmap", () => originalWorking = Beatmap.Value = createTestWorkingBeatmapWithUniqueBackground());
+            AddAssert("background changed", () => screen.CheckLastLoadChange() == true);
+            AddUntilStep("wait for beatmap background to be loaded", () => getCurrentBackground()?.GetType() == typeof(BeatmapBackground));
+
+            // of note, this needs to be a type that doesn't match BackgroundScreenDefault else it is silently not pushed by the background stack.
+            AddStep("push new background to stack", () => stack.Push(nestedScreen = new BackgroundScreenBeatmap(Beatmap.Value)));
+            AddUntilStep("wait for screen to load", () => nestedScreen.IsLoaded && nestedScreen.IsCurrentScreen());
+
+            // we're testing a case where scheduling may be used to avoid issues, so ensure the scheduler is no longer running.
+            AddUntilStep("wait for top level not alive", () => !screen.IsAlive);
+
+            AddStep("change beatmap", () => Beatmap.Value = createTestWorkingBeatmapWithUniqueBackground());
+            AddStep("change beatmap back", () => Beatmap.Value = originalWorking);
+
+            AddAssert("top level background hasn't changed yet", () => screen.CheckLastLoadChange() == null);
+
+            AddStep("pop screen back to top level", () => screen.MakeCurrent());
+
+            AddStep("top level screen is current", () => screen.IsCurrentScreen());
+            AddAssert("top level background reused existing", () => screen.CheckLastLoadChange() == false);
+        }
+
         [Test]
         public void TestBackgroundTypeSwitch()
         {
@@ -96,13 +184,11 @@ namespace osu.Game.Tests.Visual.Background
         [Test]
         public void TestBackgroundCyclingOnDefaultSkin([Values] bool supporter)
         {
-            Graphics.Backgrounds.Background last = null;
-
             setSourceMode(BackgroundSource.Skin);
             setSupporter(supporter);
             setDefaultSkin();
 
-            AddUntilStep("wait for beatmap background to be loaded", () => (last = getCurrentBackground())?.GetType() == typeof(Graphics.Backgrounds.Background));
+            AddUntilStep("wait for beatmap background to be loaded", () => (getCurrentBackground())?.GetType() == typeof(Graphics.Backgrounds.Background));
             AddAssert("next cycles background", () => screen.Next());
 
             // doesn't really need to be checked but might as well.
@@ -120,6 +206,42 @@ namespace osu.Game.Tests.Visual.Background
                 Id = API.LocalUser.Value.Id + 1,
             });
 
+        private WorkingBeatmap createTestWorkingBeatmapWithUniqueBackground() => new UniqueBackgroundTestWorkingBeatmap(Audio);
+
+        private class TestBackgroundScreenDefault : BackgroundScreenDefault
+        {
+            private bool? lastLoadTriggerCausedChange;
+
+            public TestBackgroundScreenDefault()
+                : base(false)
+            {
+            }
+
+            public override bool Next()
+            {
+                bool didChange = base.Next();
+                lastLoadTriggerCausedChange = didChange;
+                return didChange;
+            }
+
+            public bool? CheckLastLoadChange()
+            {
+                bool? lastChange = lastLoadTriggerCausedChange;
+                lastLoadTriggerCausedChange = null;
+                return lastChange;
+            }
+        }
+
+        private class UniqueBackgroundTestWorkingBeatmap : TestWorkingBeatmap
+        {
+            public UniqueBackgroundTestWorkingBeatmap(AudioManager audioManager)
+                : base(new Beatmap(), null, audioManager)
+            {
+            }
+
+            protected override Texture GetBackground() => new Texture(1, 1);
+        }
+
         private void setCustomSkin()
         {
             // feign a skin switch. this doesn't do anything except force CurrentSkin to become a LegacySkin.
diff --git a/osu.Game/Screens/Backgrounds/BackgroundScreenDefault.cs b/osu.Game/Screens/Backgrounds/BackgroundScreenDefault.cs
index 4a922c45b9..a1b1b52c14 100644
--- a/osu.Game/Screens/Backgrounds/BackgroundScreenDefault.cs
+++ b/osu.Game/Screens/Backgrounds/BackgroundScreenDefault.cs
@@ -67,7 +67,7 @@ namespace osu.Game.Screens.Backgrounds
         /// Request loading the next background.
         /// </summary>
         /// <returns>Whether a new background was queued for load. May return false if the current background is still valid.</returns>
-        public bool Next()
+        public virtual bool Next()
         {
             var nextBackground = createBackground();
 

From 25a056dfad45269be89e509a6554ad3c61ca02f1 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 14 Dec 2021 16:35:18 +0900
Subject: [PATCH 1662/5547] Remove pointless/broken test steps

These aren't accurate and are tested via a more accurate means directly
above.
---
 .../Background/TestSceneBackgroundScreenDefault.cs   | 12 +-----------
 1 file changed, 1 insertion(+), 11 deletions(-)

diff --git a/osu.Game.Tests/Visual/Background/TestSceneBackgroundScreenDefault.cs b/osu.Game.Tests/Visual/Background/TestSceneBackgroundScreenDefault.cs
index 476eadf9bb..1d3dd35e1d 100644
--- a/osu.Game.Tests/Visual/Background/TestSceneBackgroundScreenDefault.cs
+++ b/osu.Game.Tests/Visual/Background/TestSceneBackgroundScreenDefault.cs
@@ -166,19 +166,13 @@ namespace osu.Game.Tests.Visual.Background
         [TestCase(BackgroundSource.Skin, typeof(SkinBackground))]
         public void TestBackgroundDoesntReloadOnNoChange(BackgroundSource source, Type backgroundType)
         {
-            Graphics.Backgrounds.Background last = null;
-
             setSourceMode(source);
             setSupporter(true);
             if (source == BackgroundSource.Skin)
                 setCustomSkin();
 
-            AddUntilStep("wait for beatmap background to be loaded", () => (last = getCurrentBackground())?.GetType() == backgroundType);
+            AddUntilStep("wait for beatmap background to be loaded", () => (getCurrentBackground())?.GetType() == backgroundType);
             AddAssert("next doesn't load new background", () => screen.Next() == false);
-
-            // doesn't really need to be checked but might as well.
-            AddWaitStep("wait a bit", 5);
-            AddUntilStep("ensure same background instance", () => last == getCurrentBackground());
         }
 
         [Test]
@@ -190,10 +184,6 @@ namespace osu.Game.Tests.Visual.Background
 
             AddUntilStep("wait for beatmap background to be loaded", () => (getCurrentBackground())?.GetType() == typeof(Graphics.Backgrounds.Background));
             AddAssert("next cycles background", () => screen.Next());
-
-            // doesn't really need to be checked but might as well.
-            AddWaitStep("wait a bit", 5);
-            AddUntilStep("ensure different background instance", () => last != getCurrentBackground());
         }
 
         private void setSourceMode(BackgroundSource source) =>

From 8c6f50ddb1b3f7993485a06129803e442b6061fd Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 14 Dec 2021 15:17:01 +0900
Subject: [PATCH 1663/5547] Fix `BackgroundScreenDefault` incorrectly updating
 current background after being inactive

If the beatmap was changed but then reverted to the previously displayed
map, the background may have displayed incorrectly on resuming.

Closes #15804.
---
 .../Backgrounds/BackgroundScreenDefault.cs        | 15 +++++++++------
 1 file changed, 9 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Screens/Backgrounds/BackgroundScreenDefault.cs b/osu.Game/Screens/Backgrounds/BackgroundScreenDefault.cs
index a1b1b52c14..452f033dcc 100644
--- a/osu.Game/Screens/Backgrounds/BackgroundScreenDefault.cs
+++ b/osu.Game/Screens/Backgrounds/BackgroundScreenDefault.cs
@@ -48,16 +48,19 @@ namespace osu.Game.Screens.Backgrounds
 
             AddInternal(seasonalBackgroundLoader);
 
-            user.ValueChanged += _ => Next();
-            skin.ValueChanged += _ => Next();
-            mode.ValueChanged += _ => Next();
-            beatmap.ValueChanged += _ => Next();
-            introSequence.ValueChanged += _ => Next();
-            seasonalBackgroundLoader.SeasonalBackgroundChanged += () => Next();
+            user.ValueChanged += _ => Scheduler.AddOnce(loadNextIfRequired);
+            skin.ValueChanged += _ => Scheduler.AddOnce(loadNextIfRequired);
+            mode.ValueChanged += _ => Scheduler.AddOnce(loadNextIfRequired);
+            beatmap.ValueChanged += _ => Scheduler.AddOnce(loadNextIfRequired);
+            introSequence.ValueChanged += _ => Scheduler.AddOnce(loadNextIfRequired);
+            seasonalBackgroundLoader.SeasonalBackgroundChanged += () => Scheduler.AddOnce(loadNextIfRequired);
 
             currentDisplay = RNG.Next(0, background_count);
 
             Next();
+
+            // helper function required for AddOnce usage.
+            void loadNextIfRequired() => Next();
         }
 
         private ScheduledDelegate nextTask;

From 79dd9674fc5a580a10d3005d272a1b94b4aaff4c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 14 Dec 2021 17:41:02 +0900
Subject: [PATCH 1664/5547] Use longer form to read better

Using `l.StartTime` reads like a coding issue, even though if you go
down the call chain looks to be correct.
---
 osu.Game/Storyboards/StoryboardSprite.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Storyboards/StoryboardSprite.cs b/osu.Game/Storyboards/StoryboardSprite.cs
index f941cec20c..ebd1a941a8 100644
--- a/osu.Game/Storyboards/StoryboardSprite.cs
+++ b/osu.Game/Storyboards/StoryboardSprite.cs
@@ -33,8 +33,8 @@ namespace osu.Game.Storyboards
 
                 foreach (var l in loops)
                 {
-                    if (l.EarliestDisplayedTime != null)
-                        earliestStartTime = Math.Min(earliestStartTime, l.StartTime);
+                    if (l.EarliestDisplayedTime is double loopEarliestDisplayTime)
+                        earliestStartTime = Math.Min(earliestStartTime, l.LoopStartTime + loopEarliestDisplayTime);
                 }
 
                 if (earliestStartTime < double.MaxValue)

From 3bc2de4889cb0874c9a3d4adb0392ab06523f10a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 14 Dec 2021 19:11:23 +0900
Subject: [PATCH 1665/5547] Add failing test coverage of modified beatmap
 import breaking online availability state

---
 .../TestSceneOnlinePlayBeatmapAvailabilityTracker.cs       | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs b/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
index 24824b1e23..239c787349 100644
--- a/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
+++ b/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
@@ -114,18 +114,23 @@ namespace osu.Game.Tests.Online
         public void TestTrackerRespectsChecksum()
         {
             AddStep("allow importing", () => beatmaps.AllowImport.SetResult(true));
+            AddStep("import beatmap", () => beatmaps.Import(testBeatmapFile).Wait());
+            addAvailabilityCheckStep("initially locally available", BeatmapAvailability.LocallyAvailable);
 
             AddStep("import altered beatmap", () =>
             {
                 beatmaps.Import(TestResources.GetTestBeatmapForImport(true)).Wait();
             });
-            addAvailabilityCheckStep("state still not downloaded", BeatmapAvailability.NotDownloaded);
+            addAvailabilityCheckStep("state not downloaded", BeatmapAvailability.NotDownloaded);
 
             AddStep("recreate tracker", () => Child = availabilityTracker = new OnlinePlayBeatmapAvailabilityTracker
             {
                 SelectedItem = { BindTarget = selectedItem }
             });
             addAvailabilityCheckStep("state not downloaded as well", BeatmapAvailability.NotDownloaded);
+
+            AddStep("reimport original beatmap", () => beatmaps.Import(TestResources.GetQuickTestBeatmapForImport()).Wait());
+            addAvailabilityCheckStep("locally available after re-import", BeatmapAvailability.LocallyAvailable);
         }
 
         private void addAvailabilityCheckStep(string description, Func<BeatmapAvailability> expected)

From 453ecd21b32b552947ee1141f793e26d88774113 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 14 Dec 2021 19:11:56 +0900
Subject: [PATCH 1666/5547] Fix `OnlinePlayBeatmapAvailabilityTracker`
 potentially in incorrect state

Adter an import of a modified version of a beatmap (that was already
present in the local database), it's feasible that one of these trackers
would not see the state change due to the nuances of the import process.
---
 .../OnlinePlayBeatmapAvailabilityTracker.cs   | 45 +++++++++++++++++--
 1 file changed, 42 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs b/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs
index aa0e37363b..a32f069470 100644
--- a/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs
+++ b/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs
@@ -40,6 +40,11 @@ namespace osu.Game.Online.Rooms
 
         private BeatmapDownloadTracker downloadTracker;
 
+        /// <summary>
+        /// The beatmap matching the required hash (and providing a final <see cref="BeatmapAvailability.LocallyAvailable"/> state).
+        /// </summary>
+        private BeatmapInfo matchingHash;
+
         protected override void LoadComplete()
         {
             base.LoadComplete();
@@ -71,13 +76,34 @@ namespace osu.Game.Online.Rooms
                         progressUpdate = Scheduler.AddDelayed(updateAvailability, progressUpdate == null ? 0 : 500);
                 }, true);
             }, true);
+
+            // These events are needed for a fringe case where a modified/altered beatmap is imported with matching OnlineIDs.
+            // During the import process this will cause the existing beatmap set to be silently deleted and replaced with the new one.
+            // This is not exposed to us via `BeatmapDownloadTracker` so we have to take it into our own hands (as we care about the hash matching).
+            beatmapManager.ItemUpdated += itemUpdated;
+            beatmapManager.ItemRemoved += itemRemoved;
         }
 
+        private void itemUpdated(BeatmapSetInfo item) => Schedule(() =>
+        {
+            if (matchingHash?.BeatmapSet.ID == item.ID || SelectedItem.Value?.Beatmap.Value.BeatmapSet?.OnlineID == item.OnlineID)
+                updateAvailability();
+        });
+
+        private void itemRemoved(BeatmapSetInfo item) => Schedule(() =>
+        {
+            if (matchingHash?.BeatmapSet.ID == item.ID)
+                updateAvailability();
+        });
+
         private void updateAvailability()
         {
             if (downloadTracker == null)
                 return;
 
+            // will be repopulated below if still valid.
+            matchingHash = null;
+
             switch (downloadTracker.State.Value)
             {
                 case DownloadState.NotDownloaded:
@@ -93,7 +119,9 @@ namespace osu.Game.Online.Rooms
                     break;
 
                 case DownloadState.LocallyAvailable:
-                    bool hashMatches = checkHashValidity();
+                    matchingHash = findMatchingHash();
+
+                    bool hashMatches = matchingHash != null;
 
                     availability.Value = hashMatches ? BeatmapAvailability.LocallyAvailable() : BeatmapAvailability.NotDownloaded();
 
@@ -108,12 +136,23 @@ namespace osu.Game.Online.Rooms
             }
         }
 
-        private bool checkHashValidity()
+        private BeatmapInfo findMatchingHash()
         {
             int onlineId = SelectedItem.Value.Beatmap.Value.OnlineID;
             string checksum = SelectedItem.Value.Beatmap.Value.MD5Hash;
 
-            return beatmapManager.QueryBeatmap(b => b.OnlineID == onlineId && b.MD5Hash == checksum && !b.BeatmapSet.DeletePending) != null;
+            return beatmapManager.QueryBeatmap(b => b.OnlineID == onlineId && b.MD5Hash == checksum && !b.BeatmapSet.DeletePending);
+        }
+
+        protected override void Dispose(bool isDisposing)
+        {
+            base.Dispose(isDisposing);
+
+            if (beatmapManager != null)
+            {
+                beatmapManager.ItemUpdated -= itemUpdated;
+                beatmapManager.ItemRemoved -= itemRemoved;
+            }
         }
     }
 }

From 0950d8d327eb9d8a85564c917826461dd83b4c6f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 14 Dec 2021 19:16:51 +0900
Subject: [PATCH 1667/5547] Add back `PlaylistRoomCreation` test

Was spiritually removed in https://github.com/ppy/osu/pull/16045.

This implementation is mostly taken from that PR's comment thread
verbatim, and now works due to the associated changes to
`OnlinePlayBeatmapAvailabilityTracker`.
---
 .../TestScenePlaylistsRoomCreation.cs         | 82 +++++++++++++++++++
 1 file changed, 82 insertions(+)

diff --git a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs
index 450e821ba6..9dd8b41dcd 100644
--- a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs
+++ b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs
@@ -15,9 +15,11 @@ using osu.Game.Database;
 using osu.Game.Online.Rooms;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Osu;
+using osu.Game.Rulesets.Osu.Objects;
 using osu.Game.Screens.OnlinePlay.Components;
 using osu.Game.Screens.OnlinePlay.Playlists;
 using osu.Game.Screens.Play;
+using osu.Game.Tests.Beatmaps;
 using osu.Game.Tests.Visual.OnlinePlay;
 using osuTK.Input;
 
@@ -109,7 +111,87 @@ namespace osu.Game.Tests.Visual.Playlists
             AddAssert("first playlist item selected", () => match.SelectedItem.Value == SelectedRoom.Value.Playlist[0]);
         }
 
+        [Test]
+        public void TestBeatmapUpdatedOnReImport()
+        {
+            string realHash = null;
+            int realOnlineId = 0;
+            int realOnlineSetId = 0;
+
+            AddStep("store real beatmap values", () =>
+            {
+                realHash = importedBeatmap.Value.Beatmaps[0].MD5Hash;
+                realOnlineId = importedBeatmap.Value.Beatmaps[0].OnlineID ?? -1;
+                realOnlineSetId = importedBeatmap.Value.OnlineID ?? -1;
+            });
+
+            AddStep("import modified beatmap", () =>
+            {
+                var modifiedBeatmap = new TestBeatmap(new OsuRuleset().RulesetInfo)
+                {
+                    BeatmapInfo =
+                    {
+                        OnlineID = realOnlineId,
+                        BeatmapSet =
+                        {
+                            OnlineID = realOnlineSetId
+                        }
+                    },
+                };
+
+                modifiedBeatmap.HitObjects.Clear();
+                modifiedBeatmap.HitObjects.Add(new HitCircle { StartTime = 5000 });
+
+                manager.Import(modifiedBeatmap.BeatmapInfo.BeatmapSet).Wait();
+            });
+
+            // Create the room using the real beatmap values.
+            setupAndCreateRoom(room =>
+            {
+                room.Name.Value = "my awesome room";
+                room.Host.Value = API.LocalUser.Value;
+                room.Playlist.Add(new PlaylistItem
+                {
+                    Beatmap =
+                    {
+                        Value = new BeatmapInfo
+                        {
+                            MD5Hash = realHash,
+                            OnlineID = realOnlineId,
+                            BeatmapSet = new BeatmapSetInfo
+                            {
+                                OnlineID = realOnlineSetId,
+                            }
+                        }
+                    },
+                    Ruleset = { Value = new OsuRuleset().RulesetInfo }
+                });
+            });
+
+            AddAssert("match has default beatmap", () => match.Beatmap.IsDefault);
+
+            AddStep("reimport original beatmap", () =>
+            {
+                var originalBeatmap = new TestBeatmap(new OsuRuleset().RulesetInfo)
+                {
+                    BeatmapInfo =
+                    {
+                        OnlineID = realOnlineId,
+                        BeatmapSet =
+                        {
+                            OnlineID = realOnlineSetId
+                        }
+                    },
+                };
+
+                manager.Import(originalBeatmap.BeatmapInfo.BeatmapSet).Wait();
+            });
+
+            AddUntilStep("match has correct beatmap", () => realHash == match.Beatmap.Value.BeatmapInfo.MD5Hash);
+        }
+
         private void setupAndCreateRoom(Action<Room> room)
+
         {
             AddStep("setup room", () => room(SelectedRoom.Value));
 

From 8e79fac389d5f5ad5b90a15c2da7d19dc7219f70 Mon Sep 17 00:00:00 2001
From: tbrose <tbrose@uni-bremen.de>
Date: Tue, 14 Dec 2021 16:23:51 +0100
Subject: [PATCH 1668/5547] Fixes code quality check failed

---
 .../Online/Chat/MessageNotifierTest.cs        | 26 +++++++++----------
 osu.Game/Online/Chat/MessageNotifier.cs       |  5 ++--
 2 files changed, 15 insertions(+), 16 deletions(-)

diff --git a/osu.Game.Tests/Online/Chat/MessageNotifierTest.cs b/osu.Game.Tests/Online/Chat/MessageNotifierTest.cs
index b885299d1f..2ec5b778d1 100644
--- a/osu.Game.Tests/Online/Chat/MessageNotifierTest.cs
+++ b/osu.Game.Tests/Online/Chat/MessageNotifierTest.cs
@@ -12,79 +12,79 @@ namespace osu.Game.Tests.Online.Chat
         [Test]
         public void TestContainsUsernameMidlinePositive()
         {
-            Assert.IsTrue(MessageNotifier.checkContainsUsername("This is a test message", "Test"));
+            Assert.IsTrue(MessageNotifier.CheckContainsUsername("This is a test message", "Test"));
         }
 
         [Test]
         public void TestContainsUsernameStartOfLinePositive()
         {
-            Assert.IsTrue(MessageNotifier.checkContainsUsername("Test message", "Test"));
+            Assert.IsTrue(MessageNotifier.CheckContainsUsername("Test message", "Test"));
         }
 
         [Test]
         public void TestContainsUsernameEndOfLinePositive()
         {
-            Assert.IsTrue(MessageNotifier.checkContainsUsername("This is a test", "Test"));
+            Assert.IsTrue(MessageNotifier.CheckContainsUsername("This is a test", "Test"));
         }
 
         [Test]
         public void TestContainsUsernameMidlineNegative()
         {
-            Assert.IsFalse(MessageNotifier.checkContainsUsername("This is a testmessage for notifications", "Test"));
+            Assert.IsFalse(MessageNotifier.CheckContainsUsername("This is a testmessage for notifications", "Test"));
         }
 
         [Test]
         public void TestContainsUsernameStartOfLineNegative()
         {
-            Assert.IsFalse(MessageNotifier.checkContainsUsername("Testmessage", "Test"));
+            Assert.IsFalse(MessageNotifier.CheckContainsUsername("Testmessage", "Test"));
         }
 
         [Test]
         public void TestContainsUsernameEndOfLineNegative()
         {
-            Assert.IsFalse(MessageNotifier.checkContainsUsername("This is a notificationtest", "Test"));
+            Assert.IsFalse(MessageNotifier.CheckContainsUsername("This is a notificationtest", "Test"));
         }
 
         [Test]
         public void TestContainsUsernameBetweenInterpunction()
         {
-            Assert.IsTrue(MessageNotifier.checkContainsUsername("Hello 'test'-message", "Test"));
+            Assert.IsTrue(MessageNotifier.CheckContainsUsername("Hello 'test'-message", "Test"));
         }
 
         [Test]
         public void TestContainsUsernameUnicode()
         {
-            Assert.IsTrue(MessageNotifier.checkContainsUsername("Test \u0460\u0460 message", "\u0460\u0460"));
+            Assert.IsTrue(MessageNotifier.CheckContainsUsername("Test \u0460\u0460 message", "\u0460\u0460"));
         }
 
         [Test]
         public void TestContainsUsernameUnicodeNegative()
         {
-            Assert.IsFalse(MessageNotifier.checkContainsUsername("Test ha\u0460\u0460o message", "\u0460\u0460"));
+            Assert.IsFalse(MessageNotifier.CheckContainsUsername("Test ha\u0460\u0460o message", "\u0460\u0460"));
         }
 
         [Test]
         public void TestContainsUsernameSpecialCharactersPositive()
         {
-            Assert.IsTrue(MessageNotifier.checkContainsUsername("Test [#^-^#] message", "[#^-^#]"));
+            Assert.IsTrue(MessageNotifier.CheckContainsUsername("Test [#^-^#] message", "[#^-^#]"));
         }
 
         [Test]
         public void TestContainsUsernameSpecialCharactersNegative()
         {
-            Assert.IsFalse(MessageNotifier.checkContainsUsername("Test pad[#^-^#]oru message", "[#^-^#]"));
+            Assert.IsFalse(MessageNotifier.CheckContainsUsername("Test pad[#^-^#]oru message", "[#^-^#]"));
         }
 
         [Test]
         public void TestContainsUsernameAtSign()
         {
-            Assert.IsTrue(MessageNotifier.checkContainsUsername("@username hi", "username"));
+            Assert.IsTrue(MessageNotifier.CheckContainsUsername("@username hi", "username"));
         }
 
         [Test]
         public void TestContainsUsernameColon()
         {
-            Assert.IsTrue(MessageNotifier.checkContainsUsername("username: hi", "username"));
+            Assert.IsTrue(MessageNotifier.CheckContainsUsername("username: hi", "username"));
         }
     }
 }
diff --git a/osu.Game/Online/Chat/MessageNotifier.cs b/osu.Game/Online/Chat/MessageNotifier.cs
index db7c5e47f5..a11af7b305 100644
--- a/osu.Game/Online/Chat/MessageNotifier.cs
+++ b/osu.Game/Online/Chat/MessageNotifier.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.Collections.Specialized;
 using System.Linq;
@@ -121,7 +120,7 @@ namespace osu.Game.Online.Chat
 
         private void checkForMentions(Channel channel, Message message)
         {
-            if (!notifyOnUsername.Value || !checkContainsUsername(message.Content, localUser.Value.Username)) return;
+            if (!notifyOnUsername.Value || !CheckContainsUsername(message.Content, localUser.Value.Username)) return;
 
             notifications.Post(new MentionNotification(message.Sender.Username, channel));
         }
@@ -130,7 +129,7 @@ namespace osu.Game.Online.Chat
         /// Checks if <paramref name="message"/> mentions <paramref name="username"/>.
         /// This will match against the case where underscores are used instead of spaces (which is how osu-stable handles usernames with spaces).
         /// </summary>
-        public static bool checkContainsUsername(string message, string username)
+        public static bool CheckContainsUsername(string message, string username)
         {
             string fullName = Regex.Escape(username);
             string underscoreName = Regex.Escape(username.Replace(' ', '_'));

From 4664bb1d29ad5d8d442f97f94e12d5bdc7e57bc0 Mon Sep 17 00:00:00 2001
From: rumoi <rumooe@gmail.com>
Date: Wed, 15 Dec 2021 05:16:10 +1300
Subject: [PATCH 1669/5547] Remove uneeded complexity

---
 osu.Game.Rulesets.Osu/Difficulty/Skills/Speed.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Speed.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Speed.cs
index 30d989cfba..d26808bf04 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Speed.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Speed.cs
@@ -55,7 +55,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
 
             bool firstDeltaSwitch = false;
 
-            int rhythmStart = Math.Min(Previous.Count - 2, 0);
+            int rhythmStart = 0;
 
             while (rhythmStart < Previous.Count - 2 && current.StartTime - Previous[rhythmStart].StartTime < history_time_max)
                 rhythmStart++;

From 9ade8069a1b7ded46328c023eeb119e26900d1ce Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 14 Dec 2021 16:52:57 +0900
Subject: [PATCH 1670/5547] Rename to AbortGameplay() and handle additional
 states

---
 osu.Game/Online/Multiplayer/IMultiplayerRoomServer.cs      | 2 +-
 osu.Game/Online/Multiplayer/MultiplayerClient.cs           | 2 +-
 osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs     | 4 ++--
 osu.Game/Screens/OnlinePlay/Multiplayer/Multiplayer.cs     | 4 +++-
 osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs | 2 +-
 5 files changed, 8 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Online/Multiplayer/IMultiplayerRoomServer.cs b/osu.Game/Online/Multiplayer/IMultiplayerRoomServer.cs
index 200539def7..073d512f90 100644
--- a/osu.Game/Online/Multiplayer/IMultiplayerRoomServer.cs
+++ b/osu.Game/Online/Multiplayer/IMultiplayerRoomServer.cs
@@ -80,7 +80,7 @@ namespace osu.Game.Online.Multiplayer
         /// <summary>
         /// Aborts an ongoing gameplay load.
         /// </summary>
-        Task AbortLoad();
+        Task AbortGameplay();
 
         /// <summary>
         /// Adds an item to the playlist.
diff --git a/osu.Game/Online/Multiplayer/MultiplayerClient.cs b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
index 78d8362170..ffb9e193d4 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
@@ -333,7 +333,7 @@ namespace osu.Game.Online.Multiplayer
 
         public abstract Task StartMatch();
 
-        public abstract Task AbortLoad();
+        public abstract Task AbortGameplay();
 
         public abstract Task AddPlaylistItem(MultiplayerPlaylistItem item);
 
diff --git a/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs b/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs
index 3062cf8b99..73b87190b1 100644
--- a/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs
@@ -154,12 +154,12 @@ namespace osu.Game.Online.Multiplayer
             return connection.InvokeAsync(nameof(IMultiplayerServer.StartMatch));
         }
 
-        public override Task AbortLoad()
+        public override Task AbortGameplay()
         {
             if (!IsConnected.Value)
                 return Task.CompletedTask;
 
-            return connection.InvokeAsync(nameof(IMultiplayerServer.AbortLoad));
+            return connection.InvokeAsync(nameof(IMultiplayerServer.AbortGameplay));
         }
 
         public override Task AddPlaylistItem(MultiplayerPlaylistItem item)
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Multiplayer.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Multiplayer.cs
index c299fd285a..e136627d43 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Multiplayer.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Multiplayer.cs
@@ -30,7 +30,9 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
                     break;
 
                 case MultiplayerUserState.WaitingForLoad:
-                    client.AbortLoad();
+                case MultiplayerUserState.Loaded:
+                case MultiplayerUserState.Playing:
+                    client.AbortGameplay();
                     break;
 
                 default:
diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
index 4c69f8f9d2..767751a808 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
@@ -317,7 +317,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             return ((IMultiplayerClient)this).LoadRequested();
         }
 
-        public override Task AbortLoad()
+        public override Task AbortGameplay()
         {
             Debug.Assert(Room != null);
             Debug.Assert(LocalUser != null);

From da00c020be8cd32aa1ee870d242337fb3cc60a9c Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 15 Dec 2021 07:33:49 +0900
Subject: [PATCH 1671/5547] Remove whitespace

---
 .../Visual/Playlists/TestScenePlaylistsRoomCreation.cs           | 1 -
 1 file changed, 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs
index 9dd8b41dcd..a426f075e1 100644
--- a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs
+++ b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs
@@ -191,7 +191,6 @@ namespace osu.Game.Tests.Visual.Playlists
         }
 
         private void setupAndCreateRoom(Action<Room> room)
-
         {
             AddStep("setup room", () => room(SelectedRoom.Value));
 

From e662a9f0c44bd5b9dab876f60a90919f5c53e44b Mon Sep 17 00:00:00 2001
From: rumoi <rumooe@gmail.com>
Date: Wed, 15 Dec 2021 12:36:45 +1300
Subject: [PATCH 1672/5547] Remove redundant code.

---
 .../Difficulty/Skills/Speed.cs                | 101 +++++++++---------
 1 file changed, 49 insertions(+), 52 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Speed.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Speed.cs
index d26808bf04..06d1ef7346 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Speed.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Speed.cs
@@ -66,67 +66,64 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
                 OsuDifficultyHitObject prevObj = (OsuDifficultyHitObject)Previous[i];
                 OsuDifficultyHitObject lastObj = (OsuDifficultyHitObject)Previous[i + 1];
 
-                double currHistoricalDecay = Math.Max(0, (history_time_max - (current.StartTime - currObj.StartTime))) / history_time_max; // scales note 0 to 1 from history to now
+                double currHistoricalDecay = (history_time_max - (current.StartTime - currObj.StartTime)) / history_time_max; // scales note 0 to 1 from history to now
 
-                if (currHistoricalDecay != 0)
+                currHistoricalDecay = Math.Min((double)(Previous.Count - i) / Previous.Count, currHistoricalDecay); // either we're limited by time or limited by object count.
+
+                double currDelta = currObj.StrainTime;
+                double prevDelta = prevObj.StrainTime;
+                double lastDelta = lastObj.StrainTime;
+                double currRatio = 1.0 + 6.0 * Math.Min(0.5, Math.Pow(Math.Sin(Math.PI / (Math.Min(prevDelta, currDelta) / Math.Max(prevDelta, currDelta))), 2)); // fancy function to calculate rhythmbonuses.
+
+                double windowPenalty = Math.Min(1, Math.Max(0, Math.Abs(prevDelta - currDelta) - greatWindow * 0.6) / (greatWindow * 0.6));
+
+                windowPenalty = Math.Min(1, windowPenalty);
+
+                double effectiveRatio = windowPenalty * currRatio;
+
+                if (firstDeltaSwitch)
                 {
-                    currHistoricalDecay = Math.Min((double)(Previous.Count - i) / Previous.Count, currHistoricalDecay); // either we're limited by time or limited by object count.
-
-                    double currDelta = currObj.StrainTime;
-                    double prevDelta = prevObj.StrainTime;
-                    double lastDelta = lastObj.StrainTime;
-                    double currRatio = 1.0 + 6.0 * Math.Min(0.5, Math.Pow(Math.Sin(Math.PI / (Math.Min(prevDelta, currDelta) / Math.Max(prevDelta, currDelta))), 2)); // fancy function to calculate rhythmbonuses.
-
-                    double windowPenalty = Math.Min(1, Math.Max(0, Math.Abs(prevDelta - currDelta) - greatWindow * 0.6) / (greatWindow * 0.6));
-
-                    windowPenalty = Math.Min(1, windowPenalty);
-
-                    double effectiveRatio = windowPenalty * currRatio;
-
-                    if (firstDeltaSwitch)
+                    if (!(prevDelta > 1.25 * currDelta || prevDelta * 1.25 < currDelta))
                     {
-                        if (!(prevDelta > 1.25 * currDelta || prevDelta * 1.25 < currDelta))
-                        {
-                            if (islandSize < 7)
-                                islandSize++; // island is still progressing, count size.
-                        }
-                        else
-                        {
-                            if (Previous[i - 1].BaseObject is Slider) // bpm change is into slider, this is easy acc window
-                                effectiveRatio *= 0.125;
-
-                            if (Previous[i].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)
-                                effectiveRatio *= 0.25;
-
-                            if (previousIslandSize % 2 == islandSize % 2) // repeated island polartiy (2 -> 4, 3 -> 5)
-                                effectiveRatio *= 0.50;
-
-                            if (lastDelta > prevDelta + 10 && prevDelta > currDelta + 10) // previous increase happened a note ago, 1/1->1/2-1/4, dont want to buff this.
-                                effectiveRatio *= 0.125;
-
-                            rhythmComplexitySum += Math.Sqrt(effectiveRatio * startRatio) * currHistoricalDecay * Math.Sqrt(4 + islandSize) / 2 * Math.Sqrt(4 + previousIslandSize) / 2;
-
-                            startRatio = effectiveRatio;
-
-                            previousIslandSize = islandSize; // log the last island size.
-
-                            if (prevDelta * 1.25 < currDelta) // we're slowing down, stop counting
-                                firstDeltaSwitch = false; // if we're speeding up, this stays true and  we keep counting island size.
-
-                            islandSize = 1;
-                        }
+                        if (islandSize < 7)
+                            islandSize++; // island is still progressing, count size.
                     }
-                    else if (prevDelta > 1.25 * currDelta) // we want to be speeding up.
+                    else
                     {
-                        // Begin counting island until we change speed again.
-                        firstDeltaSwitch = true;
+                        if (Previous[i - 1].BaseObject is Slider) // bpm change is into slider, this is easy acc window
+                            effectiveRatio *= 0.125;
+
+                        if (Previous[i].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)
+                            effectiveRatio *= 0.25;
+
+                        if (previousIslandSize % 2 == islandSize % 2) // repeated island polartiy (2 -> 4, 3 -> 5)
+                            effectiveRatio *= 0.50;
+
+                        if (lastDelta > prevDelta + 10 && prevDelta > currDelta + 10) // previous increase happened a note ago, 1/1->1/2-1/4, dont want to buff this.
+                            effectiveRatio *= 0.125;
+
+                        rhythmComplexitySum += Math.Sqrt(effectiveRatio * startRatio) * currHistoricalDecay * Math.Sqrt(4 + islandSize) / 2 * Math.Sqrt(4 + previousIslandSize) / 2;
+
                         startRatio = effectiveRatio;
+
+                        previousIslandSize = islandSize; // log the last island size.
+
+                        if (prevDelta * 1.25 < currDelta) // we're slowing down, stop counting
+                            firstDeltaSwitch = false; // if we're speeding up, this stays true and  we keep counting island size.
+
                         islandSize = 1;
                     }
                 }
+                else if (prevDelta > 1.25 * currDelta) // we want to be speeding up.
+                {
+                    // Begin counting island until we change speed again.
+                    firstDeltaSwitch = true;
+                    startRatio = effectiveRatio;
+                    islandSize = 1;
+                }
             }
 
             return Math.Sqrt(4 + rhythmComplexitySum * rhythm_multiplier) / 2; //produces multiplier that can be applied to strain. range [1, infinity) (not really though)

From 9d85beddbe5c45fa3985a6994f9dab05267eab9f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 15 Dec 2021 11:16:37 +0900
Subject: [PATCH 1673/5547] Fix null reference in some tests due to missing
 realm context factory

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

diff --git a/osu.Game/Skinning/Skin.cs b/osu.Game/Skinning/Skin.cs
index ee92b6b40a..d606d94b97 100644
--- a/osu.Game/Skinning/Skin.cs
+++ b/osu.Game/Skinning/Skin.cs
@@ -43,7 +43,11 @@ namespace osu.Game.Skinning
 
         protected Skin(SkinInfo skin, IStorageResourceProvider resources, [CanBeNull] Stream configurationStream = null)
         {
-            SkinInfo = skin.ToLive(resources.RealmContextFactory);
+            SkinInfo = resources?.RealmContextFactory != null
+                ? skin.ToLive(resources.RealmContextFactory)
+                // This path should only be used in some tests.
+                : skin.ToLiveUnmanaged();
+
             this.resources = resources;
 
             configurationStream ??= getConfigurationStream();

From 0c11fe741309f8b990f4d85b69080dd9beb53f55 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 15 Dec 2021 12:45:09 +0900
Subject: [PATCH 1674/5547] Fix toast popups spamming samples when adjusting
 osu!mania scroll speed during gameplay

Not the most robust of fixes, but as per the reasoning described in the
issue thread, a proper fix will take considerably more effort. This
intends to fix the issue first and foremost, as it sounds so bad I'd
want to mute my sound before adjusting currently.

Closes #15718.
---
 osu.Game/Overlays/OSD/TrackedSettingToast.cs | 24 ++++++++++++++++++++
 osu.Game/Overlays/OnScreenDisplay.cs         |  2 +-
 2 files changed, 25 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/OSD/TrackedSettingToast.cs b/osu.Game/Overlays/OSD/TrackedSettingToast.cs
index 51214fe460..9939ba024e 100644
--- a/osu.Game/Overlays/OSD/TrackedSettingToast.cs
+++ b/osu.Game/Overlays/OSD/TrackedSettingToast.cs
@@ -5,12 +5,14 @@ using System;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
 using osu.Framework.Audio.Sample;
+using osu.Framework.Bindables;
 using osu.Framework.Configuration.Tracking;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Effects;
 using osu.Framework.Graphics.Shapes;
+using osu.Game.Configuration;
 using osu.Game.Graphics;
 using osuTK;
 using osuTK.Graphics;
@@ -28,6 +30,8 @@ namespace osu.Game.Overlays.OSD
         private Sample sampleOff;
         private Sample sampleChange;
 
+        private Bindable<double?> lastPlaybackTime;
+
         public TrackedSettingToast(SettingDescription description)
             : base(description.Name, description.Value, description.Shortcut)
         {
@@ -75,10 +79,28 @@ namespace osu.Game.Overlays.OSD
                 optionLights.Add(new OptionLight { Glowing = i == selectedOption });
         }
 
+        [Resolved]
+        private SessionStatics statics { get; set; }
+
         protected override void LoadComplete()
         {
             base.LoadComplete();
 
+            playSound();
+        }
+
+        private void playSound()
+        {
+            // This debounce code roughly follows what we're using in HoverSampleDebounceComponent.
+            // We're sharing the existing static for hover sounds because it doesn't really matter if they block each other.
+            // This is a simple solution, but if this ever becomes a problem (or other performance issues arise),
+            // the whole toast system should be rewritten to avoid recreating this drawable each time a value changes.
+            lastPlaybackTime = statics.GetBindable<double?>(Static.LastHoverSoundPlaybackTime);
+
+            bool enoughTimePassedSinceLastPlayback = !lastPlaybackTime.Value.HasValue || Time.Current - lastPlaybackTime.Value >= OsuGameBase.SAMPLE_DEBOUNCE_TIME;
+
+            if (!enoughTimePassedSinceLastPlayback) return;
+
             if (optionCount == 1)
             {
                 if (selectedOption == 0)
@@ -93,6 +115,8 @@ namespace osu.Game.Overlays.OSD
                 sampleChange.Frequency.Value = 1 + (double)selectedOption / (optionCount - 1) * 0.25f;
                 sampleChange.Play();
             }
+
+            lastPlaybackTime.Value = Time.Current;
         }
 
         [BackgroundDependencyLoader]
diff --git a/osu.Game/Overlays/OnScreenDisplay.cs b/osu.Game/Overlays/OnScreenDisplay.cs
index be9d3cd794..6b3696ced9 100644
--- a/osu.Game/Overlays/OnScreenDisplay.cs
+++ b/osu.Game/Overlays/OnScreenDisplay.cs
@@ -101,7 +101,7 @@ namespace osu.Game.Overlays
             DisplayTemporarily(box);
         });
 
-        private void displayTrackedSettingChange(SettingDescription description) => Display(new TrackedSettingToast(description));
+        private void displayTrackedSettingChange(SettingDescription description) => Scheduler.AddOnce(Display, new TrackedSettingToast(description));
 
         private TransformSequence<Drawable> fadeIn;
         private ScheduledDelegate fadeOut;

From 828072bceaad5cb10ae39abdec82148136707fa0 Mon Sep 17 00:00:00 2001
From: JamesTheGeek <radjame52004@gmail.com>
Date: Tue, 14 Dec 2021 23:23:11 -0500
Subject: [PATCH 1675/5547] Fix issue #15869

The taiko-slider is not included in  `Playfield`, so it doesn't get hidden when calling `drawableRuleSet.Playfield.Hide()`.   Calling `drawableRuleSet.Hide()` hides the taiko-slider, in addition to the rest of the `Playfield`.
---
 osu.Game/Rulesets/Mods/ModCinema.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Rulesets/Mods/ModCinema.cs b/osu.Game/Rulesets/Mods/ModCinema.cs
index c78088ba2d..f28ef1edeb 100644
--- a/osu.Game/Rulesets/Mods/ModCinema.cs
+++ b/osu.Game/Rulesets/Mods/ModCinema.cs
@@ -17,8 +17,8 @@ namespace osu.Game.Rulesets.Mods
             drawableRuleset.SetReplayScore(CreateReplayScore(drawableRuleset.Beatmap, drawableRuleset.Mods));
 
             // AlwaysPresent required for hitsounds
-            drawableRuleset.Playfield.AlwaysPresent = true;
-            drawableRuleset.Playfield.Hide();
+            drawableRuleset.AlwaysPresent = true;
+            drawableRuleset.Hide();
         }
     }
 

From b326ccc1968f5ff757ece4dd2806c878a2724a38 Mon Sep 17 00:00:00 2001
From: Susko3 <16479013+Susko3@users.noreply.github.com>
Date: Wed, 15 Dec 2021 07:13:24 +0100
Subject: [PATCH 1676/5547] Move logic to framework and update all usages

---
 osu.Game/Graphics/UserInterface/OsuNumberBox.cs | 4 +++-
 osu.Game/Overlays/Settings/SettingsNumberBox.cs | 3 ++-
 2 files changed, 5 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Graphics/UserInterface/OsuNumberBox.cs b/osu.Game/Graphics/UserInterface/OsuNumberBox.cs
index 36288c745a..3d565a4464 100644
--- a/osu.Game/Graphics/UserInterface/OsuNumberBox.cs
+++ b/osu.Game/Graphics/UserInterface/OsuNumberBox.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 osu.Framework.Extensions;
+
 namespace osu.Game.Graphics.UserInterface
 {
     public class OsuNumberBox : OsuTextBox
     {
-        protected override bool CanAddCharacter(char character) => char.IsNumber(character);
+        protected override bool CanAddCharacter(char character) => character.IsAsciiDigit();
     }
 }
diff --git a/osu.Game/Overlays/Settings/SettingsNumberBox.cs b/osu.Game/Overlays/Settings/SettingsNumberBox.cs
index 0a4949f8b6..cc4446033a 100644
--- a/osu.Game/Overlays/Settings/SettingsNumberBox.cs
+++ b/osu.Game/Overlays/Settings/SettingsNumberBox.cs
@@ -2,6 +2,7 @@
 // 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;
@@ -67,7 +68,7 @@ namespace osu.Game.Overlays.Settings
 
         private class OutlinedNumberBox : OutlinedTextBox
         {
-            protected override bool CanAddCharacter(char character) => character >= '0' && character <= '9';
+            protected override bool CanAddCharacter(char character) => character.IsAsciiDigit();
 
             public new void NotifyInputError() => base.NotifyInputError();
         }

From e9187cc3cf3192b3559b23b7c4cf5a60d4b1832a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 15 Dec 2021 16:13:12 +0900
Subject: [PATCH 1677/5547] Add failing test showing expanded state being
 unexpectedly lost

---
 .../Visual/Beatmaps/TestSceneBeatmapCard.cs   | 37 ++++++++++++++-----
 1 file changed, 27 insertions(+), 10 deletions(-)

diff --git a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs
index f835d21603..0b9857486a 100644
--- a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs
+++ b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs
@@ -6,12 +6,12 @@ using System.Collections.Generic;
 using System.Linq;
 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.Shapes;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
+using osu.Game.Beatmaps.Drawables;
 using osu.Game.Beatmaps.Drawables.Cards;
 using osu.Game.Graphics.Containers;
 using osu.Game.Online.API;
@@ -19,11 +19,10 @@ using osu.Game.Online.API.Requests;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays;
 using osuTK;
-using APIUser = osu.Game.Online.API.Requests.Responses.APIUser;
 
 namespace osu.Game.Tests.Visual.Beatmaps
 {
-    public class TestSceneBeatmapCard : OsuTestScene
+    public class TestSceneBeatmapCard : OsuManualInputManagerTestScene
     {
         /// <summary>
         /// All cards on this scene use a common online ID to ensure that map download, preview tracks, etc. can be tested manually with online sources.
@@ -253,14 +252,32 @@ namespace osu.Game.Tests.Visual.Beatmaps
         public void TestNormal()
         {
             createTestCase(beatmapSetInfo => new BeatmapCard(beatmapSetInfo));
+        }
 
-            AddToggleStep("toggle expanded state", expanded =>
-            {
-                var card = this.ChildrenOfType<BeatmapCard>().Last();
-                if (!card.Expanded.Disabled)
-                    card.Expanded.Value = expanded;
-            });
-            AddToggleStep("disable/enable expansion", disabled => this.ChildrenOfType<BeatmapCard>().ForEach(card => card.Expanded.Disabled = disabled));
+        [Test]
+        public void TestHoverState()
+        {
+            AddStep("create cards", () => Child = createContent(OverlayColourScheme.Blue, s => new BeatmapCard(s)));
+
+            AddStep("Hover card", () => InputManager.MoveMouseTo(firstCard()));
+            AddWaitStep("wait for potential state change", 5);
+            AddAssert("card is not expanded", () => !firstCard().Expanded.Value);
+
+            AddStep("Hover spectrum display", () => InputManager.MoveMouseTo(firstCard().ChildrenOfType<DifficultySpectrumDisplay>().Single()));
+            AddUntilStep("card is expanded", () => firstCard().Expanded.Value);
+
+            AddStep("Hover difficulty content", () => InputManager.MoveMouseTo(firstCard().ChildrenOfType<BeatmapCardDifficultyList>().Single()));
+            AddWaitStep("wait for potential state change", 5);
+            AddAssert("card is still expanded", () => firstCard().Expanded.Value);
+
+            AddStep("Hover main content again", () => InputManager.MoveMouseTo(firstCard()));
+            AddWaitStep("wait for potential state change", 5);
+            AddAssert("card is still expanded", () => firstCard().Expanded.Value);
+
+            AddStep("Hover away", () => InputManager.MoveMouseTo(this.ChildrenOfType<BeatmapCard>().Last()));
+            AddUntilStep("card is not expanded", () => !firstCard().Expanded.Value);
+
+            BeatmapCard firstCard() => this.ChildrenOfType<BeatmapCard>().First();
         }
     }
 }

From 41e6c24dad8750edd2115c12ecd6857252036b46 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 15 Dec 2021 15:51:47 +0900
Subject: [PATCH 1678/5547] Expose `Expanded` state of `BeatmapCardContent` as
 read-only bindable

This is just to reduce complexity of these interactions by ensuring that
the expanded state can only be changed by the class itself.
---
 .../Beatmaps/Drawables/Cards/BeatmapCardContent.cs   | 12 +++++++-----
 1 file changed, 7 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardContent.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardContent.cs
index 681f09c658..e353e61b71 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardContent.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardContent.cs
@@ -31,7 +31,9 @@ namespace osu.Game.Beatmaps.Drawables.Cards
             set => dropdownScroll.Child = value;
         }
 
-        public Bindable<bool> Expanded { get; } = new BindableBool();
+        public IBindable<bool> Expanded => expanded;
+
+        private readonly BindableBool expanded = new BindableBool();
 
         private readonly Box background;
         private readonly Container content;
@@ -128,7 +130,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
             scheduledExpandedChange = Scheduler.AddDelayed(() =>
             {
                 if (!Expanded.Disabled)
-                    Expanded.Value = true;
+                    expanded.Value = true;
             }, 100);
         }
 
@@ -141,7 +143,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
             scheduledExpandedChange = Scheduler.AddDelayed(() =>
             {
                 if (!Expanded.Disabled)
-                    Expanded.Value = false;
+                    expanded.Value = false;
             }, 500);
         }
 
@@ -154,7 +156,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                 return;
 
             scheduledExpandedChange?.Cancel();
-            Expanded.Value = false;
+            expanded.Value = false;
         }
 
         private void keep()
@@ -163,7 +165,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                 return;
 
             scheduledExpandedChange?.Cancel();
-            Expanded.Value = true;
+            expanded.Value = true;
         }
 
         private void updateState()

From ef4ab74565a843d23da2e05bc01a7ace7478a353 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 15 Dec 2021 16:19:47 +0900
Subject: [PATCH 1679/5547] Also only expose `Expanded` state of `BeatmapCard`
 as read-only

---
 osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs | 6 ++++--
 osu.Game/Screens/Play/SoloSpectator.cs           | 5 +----
 2 files changed, 5 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
index d93ac841ab..435a8227bd 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
@@ -33,7 +33,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
         public const float TRANSITION_DURATION = 400;
         public const float CORNER_RADIUS = 10;
 
-        public Bindable<bool> Expanded { get; } = new BindableBool();
+        public IBindable<bool> Expanded { get; }
 
         private const float width = 408;
         private const float height = 100;
@@ -64,9 +64,11 @@ namespace osu.Game.Beatmaps.Drawables.Cards
         [Resolved]
         private OverlayColourProvider colourProvider { get; set; } = null!;
 
-        public BeatmapCard(APIBeatmapSet beatmapSet)
+        public BeatmapCard(APIBeatmapSet beatmapSet, bool allowExpansion = true)
             : base(HoverSampleSet.Submit)
         {
+            Expanded = new BindableBool { Disabled = !allowExpansion };
+
             this.beatmapSet = beatmapSet;
             favouriteState = new Bindable<BeatmapSetFavouriteState>(new BeatmapSetFavouriteState(beatmapSet.HasFavourited, beatmapSet.FavouriteCount));
             downloadTracker = new BeatmapDownloadTracker(beatmapSet);
diff --git a/osu.Game/Screens/Play/SoloSpectator.cs b/osu.Game/Screens/Play/SoloSpectator.cs
index 3918dbe8fc..ba5663bfa3 100644
--- a/osu.Game/Screens/Play/SoloSpectator.cs
+++ b/osu.Game/Screens/Play/SoloSpectator.cs
@@ -228,10 +228,7 @@ namespace osu.Game.Screens.Play
             onlineBeatmapRequest.Success += beatmapSet => Schedule(() =>
             {
                 this.beatmapSet = beatmapSet;
-                beatmapPanelContainer.Child = new BeatmapCard(this.beatmapSet)
-                {
-                    Expanded = { Disabled = true }
-                };
+                beatmapPanelContainer.Child = new BeatmapCard(this.beatmapSet, allowExpansion: false);
                 checkForAutomaticDownload();
             });
 

From 7a9db22c5240a600b87a40b74cc6416cc0d9122f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 15 Dec 2021 16:02:43 +0900
Subject: [PATCH 1680/5547] Tidy up method naming and structure for expanded
 state changes

---
 .../Beatmaps/Drawables/Cards/BeatmapCard.cs   |  6 +--
 .../Drawables/Cards/BeatmapCardContent.cs     | 52 +++++--------------
 2 files changed, 15 insertions(+), 43 deletions(-)

diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
index 435a8227bd..2e39fafa05 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
@@ -284,7 +284,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                                                 {
                                                     Hovered = _ =>
                                                     {
-                                                        content.ScheduleShow();
+                                                        content.ExpandAfterDelay();
                                                         return false;
                                                     },
                                                     Unhovered = _ =>
@@ -292,7 +292,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                                                         // This hide should only trigger if the expanded content has not shown yet.
                                                         // ie. if the user has not shown intent to want to see it (quickly moved over the info row area).
                                                         if (!Expanded.Value)
-                                                            content.ScheduleHide();
+                                                            content.CollapseAfterDelay();
                                                     }
                                                 }
                                             }
@@ -368,7 +368,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
 
         protected override void OnHoverLost(HoverLostEvent e)
         {
-            content.ScheduleHide();
+            content.CollapseAfterDelay();
 
             updateState();
             base.OnHoverLost(e);
diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardContent.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardContent.cs
index e353e61b71..148372786a 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardContent.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardContent.cs
@@ -56,7 +56,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                 AutoSizeAxes = Axes.Y,
                 CornerRadius = BeatmapCard.CORNER_RADIUS,
                 Masking = true,
-                Unhovered = _ => checkForHide(),
+                Unhovered = _ => collapseIfNotHovered(),
                 Children = new Drawable[]
                 {
                     background = new Box
@@ -78,10 +78,10 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                         Alpha = 0,
                         Hovered = _ =>
                         {
-                            keep();
+                            queueExpandedStateChange(true);
                             return true;
                         },
-                        Unhovered = _ => checkForHide(),
+                        Unhovered = _ => collapseIfNotHovered(),
                         Child = dropdownScroll = new ExpandedContentScrollContainer
                         {
                             RelativeSizeAxes = Axes.X,
@@ -121,51 +121,23 @@ namespace osu.Game.Beatmaps.Drawables.Cards
 
         private ScheduledDelegate? scheduledExpandedChange;
 
-        public void ScheduleShow()
-        {
-            scheduledExpandedChange?.Cancel();
-            if (Expanded.Disabled || Expanded.Value)
-                return;
+        public void ExpandAfterDelay() => queueExpandedStateChange(true, 100);
 
-            scheduledExpandedChange = Scheduler.AddDelayed(() =>
-            {
-                if (!Expanded.Disabled)
-                    expanded.Value = true;
-            }, 100);
+        public void CollapseAfterDelay() => queueExpandedStateChange(false, 500);
+
+        private void collapseIfNotHovered()
+        {
+            if (!content.IsHovered && !dropdownContent.IsHovered)
+                queueExpandedStateChange(false);
         }
 
-        public void ScheduleHide()
-        {
-            scheduledExpandedChange?.Cancel();
-            if (Expanded.Disabled || !Expanded.Value)
-                return;
-
-            scheduledExpandedChange = Scheduler.AddDelayed(() =>
-            {
-                if (!Expanded.Disabled)
-                    expanded.Value = false;
-            }, 500);
-        }
-
-        private void checkForHide()
-        {
-            if (Expanded.Disabled)
-                return;
-
-            if (content.IsHovered || dropdownContent.IsHovered)
-                return;
-
-            scheduledExpandedChange?.Cancel();
-            expanded.Value = false;
-        }
-
-        private void keep()
+        private void queueExpandedStateChange(bool newState, int delay = 0)
         {
             if (Expanded.Disabled)
                 return;
 
             scheduledExpandedChange?.Cancel();
-            expanded.Value = true;
+            scheduledExpandedChange = Scheduler.AddDelayed(() => expanded.Value = newState, delay);
         }
 
         private void updateState()

From 94d1a2aacae0a6472e06eeb004004a984feb69c4 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 15 Dec 2021 16:37:44 +0900
Subject: [PATCH 1681/5547] Remove unnecessary collapse call from `BeatmapCard`

This is already handled at the `BeatmapCardContent` level. This call
actually causes the buggy behaviour reported in
https://github.com/ppy/osu/discussions/16085.
---
 osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs | 2 --
 1 file changed, 2 deletions(-)

diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
index 2e39fafa05..be7119be36 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
@@ -368,8 +368,6 @@ namespace osu.Game.Beatmaps.Drawables.Cards
 
         protected override void OnHoverLost(HoverLostEvent e)
         {
-            content.CollapseAfterDelay();
-
             updateState();
             base.OnHoverLost(e);
         }

From 6a1f535257c49720f9f81ca80d9942d44889456d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 15 Dec 2021 16:38:19 +0900
Subject: [PATCH 1682/5547] Refactor cancellation of expand to be more explicit

---
 osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs        | 6 +++---
 osu.Game/Beatmaps/Drawables/Cards/BeatmapCardContent.cs | 2 +-
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
index be7119be36..1e24501426 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
@@ -289,10 +289,10 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                                                     },
                                                     Unhovered = _ =>
                                                     {
-                                                        // This hide should only trigger if the expanded content has not shown yet.
-                                                        // ie. if the user has not shown intent to want to see it (quickly moved over the info row area).
+                                                        // Handles the case where a user has not shown explicit intent to view expanded info.
+                                                        // ie. quickly moved over the info row area but didn't remain within it.
                                                         if (!Expanded.Value)
-                                                            content.CollapseAfterDelay();
+                                                            content.CancelExpand();
                                                     }
                                                 }
                                             }
diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardContent.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardContent.cs
index 148372786a..0739f7328f 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardContent.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardContent.cs
@@ -123,7 +123,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
 
         public void ExpandAfterDelay() => queueExpandedStateChange(true, 100);
 
-        public void CollapseAfterDelay() => queueExpandedStateChange(false, 500);
+        public void CancelExpand() => scheduledExpandedChange?.Cancel();
 
         private void collapseIfNotHovered()
         {

From ad430a627701afa2fcd7c538b99e232d4f54a693 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 15 Dec 2021 16:44:58 +0900
Subject: [PATCH 1683/5547] Centralise hover state handling (and fix
 back-to-front conditionals)

---
 .../Beatmaps/Drawables/Cards/BeatmapCardContent.cs  | 13 +++++--------
 1 file changed, 5 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardContent.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardContent.cs
index 0739f7328f..286e03e700 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardContent.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardContent.cs
@@ -56,7 +56,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                 AutoSizeAxes = Axes.Y,
                 CornerRadius = BeatmapCard.CORNER_RADIUS,
                 Masking = true,
-                Unhovered = _ => collapseIfNotHovered(),
+                Unhovered = _ => updateFromHoverChange(),
                 Children = new Drawable[]
                 {
                     background = new Box
@@ -78,10 +78,10 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                         Alpha = 0,
                         Hovered = _ =>
                         {
-                            queueExpandedStateChange(true);
+                            updateFromHoverChange();
                             return true;
                         },
-                        Unhovered = _ => collapseIfNotHovered(),
+                        Unhovered = _ => updateFromHoverChange(),
                         Child = dropdownScroll = new ExpandedContentScrollContainer
                         {
                             RelativeSizeAxes = Axes.X,
@@ -125,11 +125,8 @@ namespace osu.Game.Beatmaps.Drawables.Cards
 
         public void CancelExpand() => scheduledExpandedChange?.Cancel();
 
-        private void collapseIfNotHovered()
-        {
-            if (!content.IsHovered && !dropdownContent.IsHovered)
-                queueExpandedStateChange(false);
-        }
+        private void updateFromHoverChange() =>
+            queueExpandedStateChange(content.IsHovered || dropdownContent.IsHovered, 100);
 
         private void queueExpandedStateChange(bool newState, int delay = 0)
         {

From 42f14667a360a16e95197cd2d2635bb9e4026479 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 15 Dec 2021 16:50:55 +0900
Subject: [PATCH 1684/5547] Update framework

---
 osu.Android.props        | 2 +-
 osu.Game/osu.Game.csproj | 2 +-
 osu.iOS.props            | 4 ++--
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Android.props b/osu.Android.props
index 0c922c09ac..5e5e110dfb 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -52,7 +52,7 @@
   </ItemGroup>
   <ItemGroup>
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1203.0" />
-    <PackageReference Include="ppy.osu.Framework.Android" Version="2021.1207.0" />
+    <PackageReference Include="ppy.osu.Framework.Android" Version="2021.1215.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
     <!-- Realm needs to be directly referenced in all Xamarin projects, as it will not pull in its transitive dependencies otherwise. -->
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index adb25f46fe..bc429f9af1 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="10.7.1" />
-    <PackageReference Include="ppy.osu.Framework" Version="2021.1207.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2021.1215.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1203.0" />
     <PackageReference Include="Sentry" Version="3.11.1" />
     <PackageReference Include="SharpCompress" Version="0.30.0" />
diff --git a/osu.iOS.props b/osu.iOS.props
index db5d9af865..1ae9aa3dc5 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -60,7 +60,7 @@
     <Reference Include="System.Net.Http" />
   </ItemGroup>
   <ItemGroup Label="Package References">
-    <PackageReference Include="ppy.osu.Framework.iOS" Version="2021.1207.0" />
+    <PackageReference Include="ppy.osu.Framework.iOS" Version="2021.1215.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1203.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net5.0 / net6.0) -->
@@ -83,7 +83,7 @@
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="2.2.6" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.Core" Version="2.2.6" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
-    <PackageReference Include="ppy.osu.Framework" Version="2021.1207.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2021.1215.0" />
     <PackageReference Include="SharpCompress" Version="0.30.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
     <PackageReference Include="SharpRaven" Version="2.4.0" />

From 740a6f16c79a606652649fc9e71cb607bfb343d9 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 15 Dec 2021 16:52:50 +0900
Subject: [PATCH 1685/5547] Fix exception when updating the room's visual
 playlist

---
 .../Multiplayer/TestSceneMultiplayer.cs       | 43 +++++++++++++++++--
 .../Match/Playlist/MultiplayerPlaylist.cs     |  6 ++-
 2 files changed, 45 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
index bc2902480d..2ea7f2541f 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
@@ -30,6 +30,7 @@ using osu.Game.Screens.OnlinePlay.Lounge.Components;
 using osu.Game.Screens.OnlinePlay.Match;
 using osu.Game.Screens.OnlinePlay.Multiplayer;
 using osu.Game.Screens.OnlinePlay.Multiplayer.Match;
+using osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist;
 using osu.Game.Screens.Play;
 using osu.Game.Screens.Ranking;
 using osu.Game.Screens.Spectate;
@@ -594,9 +595,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 }
             });
 
-            pressReadyButton();
-            pressReadyButton();
-            AddUntilStep("wait for player", () => multiplayerScreenStack.CurrentScreen is Player);
+            enterGameplay();
 
             // Gameplay runs in real-time, so we need to incrementally check if gameplay has finished in order to not time out.
             for (double i = 1000; i < TestResources.QUICK_BEATMAP_LENGTH; i += 1000)
@@ -656,6 +655,44 @@ namespace osu.Game.Tests.Visual.Multiplayer
             });
         }
 
+        [Test]
+        public void TestItemAddedAndDeletedByOtherUserDuringGameplay()
+        {
+            createRoom(() => new Room
+            {
+                Name = { Value = "Test Room" },
+                QueueMode = { Value = QueueMode.AllPlayers },
+                Playlist =
+                {
+                    new PlaylistItem
+                    {
+                        Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.RulesetID == 0)).BeatmapInfo },
+                        Ruleset = { Value = new OsuRuleset().RulesetInfo },
+                    }
+                }
+            });
+
+            enterGameplay();
+
+            AddStep("join other user", () => client.AddUser(new APIUser { Id = 1234 }));
+            AddStep("add item as other user", () => client.AddUserPlaylistItem(1234, new MultiplayerPlaylistItem(new PlaylistItem
+            {
+                BeatmapID = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.RulesetID == 0)).BeatmapInfo.OnlineID ?? -1
+            })));
+            AddStep("delete item as other user", () => client.RemoveUserPlaylistItem(1234, 2));
+
+            AddUntilStep("wait for item to be deleted", () => client.Room?.Playlist.Count == 1);
+            AddStep("exit gameplay as initial user", () => multiplayerScreenStack.MultiplayerScreen.MakeCurrent());
+            AddUntilStep("queue is empty", () => this.ChildrenOfType<MultiplayerQueueList>().Single().Items.Count == 0);
+        }
+
+        private void enterGameplay()
+        {
+            pressReadyButton();
+            pressReadyButton();
+            AddUntilStep("wait for player", () => multiplayerScreenStack.CurrentScreen is Player);
+        }
+
         private ReadyButton readyButton => this.ChildrenOfType<ReadyButton>().Single();
 
         private void pressReadyButton()
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylist.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylist.cs
index 4971489769..7b90532cce 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylist.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylist.cs
@@ -121,7 +121,11 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist
 
         private void addItemToLists(MultiplayerPlaylistItem item)
         {
-            var apiItem = Playlist.Single(i => i.ID == item.ID);
+            var apiItem = Playlist.SingleOrDefault(i => i.ID == item.ID);
+
+            // Item could have been removed from the playlist while the local player was in gameplay.
+            if (apiItem == null)
+                return;
 
             if (item.Expired)
                 historyList.Items.Add(apiItem);

From 694ee687250b3c910154ab2d83a927d6c061bdf3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 15 Dec 2021 16:59:33 +0900
Subject: [PATCH 1686/5547] Update resources

---
 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 5e5e110dfb..1131203a95 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -51,7 +51,7 @@
     <Reference Include="Java.Interop" />
   </ItemGroup>
   <ItemGroup>
-    <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1203.0" />
+    <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1215.0" />
     <PackageReference Include="ppy.osu.Framework.Android" Version="2021.1215.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index bc429f9af1..5a0c999fb0 100644
--- a/osu.Game/osu.Game.csproj
+++ b/osu.Game/osu.Game.csproj
@@ -37,7 +37,7 @@
     </PackageReference>
     <PackageReference Include="Realm" Version="10.7.1" />
     <PackageReference Include="ppy.osu.Framework" Version="2021.1215.0" />
-    <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1203.0" />
+    <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1215.0" />
     <PackageReference Include="Sentry" Version="3.11.1" />
     <PackageReference Include="SharpCompress" Version="0.30.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
diff --git a/osu.iOS.props b/osu.iOS.props
index 1ae9aa3dc5..27ac1bf647 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -61,7 +61,7 @@
   </ItemGroup>
   <ItemGroup Label="Package References">
     <PackageReference Include="ppy.osu.Framework.iOS" Version="2021.1215.0" />
-    <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1203.0" />
+    <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1215.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net5.0 / net6.0) -->
   <PropertyGroup>

From d22e1b90010ea570f03f4aad8450f72bce2d02e9 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 15 Dec 2021 16:59:34 +0900
Subject: [PATCH 1687/5547] Add another until step to guard against async test
 issues

---
 osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
index 2ea7f2541f..1d951c257c 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
@@ -679,9 +679,12 @@ namespace osu.Game.Tests.Visual.Multiplayer
             {
                 BeatmapID = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.RulesetID == 0)).BeatmapInfo.OnlineID ?? -1
             })));
-            AddStep("delete item as other user", () => client.RemoveUserPlaylistItem(1234, 2));
 
-            AddUntilStep("wait for item to be deleted", () => client.Room?.Playlist.Count == 1);
+            AddUntilStep("item arrived in playlist", () => client.Room?.Playlist.Count == 2);
+
+            AddStep("delete item as other user", () => client.RemoveUserPlaylistItem(1234, 2));
+            AddUntilStep("item removed from playlist", () => client.Room?.Playlist.Count == 1);
+
             AddStep("exit gameplay as initial user", () => multiplayerScreenStack.MultiplayerScreen.MakeCurrent());
             AddUntilStep("queue is empty", () => this.ChildrenOfType<MultiplayerQueueList>().Single().Items.Count == 0);
         }

From 39a0a2113219ef3319da9dd4e6e0c023b5f0ce52 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 15 Dec 2021 17:30:09 +0900
Subject: [PATCH 1688/5547] Add test coverage of same scenario without deletion

---
 .../Multiplayer/TestSceneMultiplayer.cs       | 31 +++++++++++++++++++
 1 file changed, 31 insertions(+)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
index 1d951c257c..ed8d50589f 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
@@ -655,6 +655,37 @@ namespace osu.Game.Tests.Visual.Multiplayer
             });
         }
 
+        [Test]
+        public void TestItemAddedByOtherUserDuringGameplay()
+        {
+            createRoom(() => new Room
+            {
+                Name = { Value = "Test Room" },
+                QueueMode = { Value = QueueMode.AllPlayers },
+                Playlist =
+                {
+                    new PlaylistItem
+                    {
+                        Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.RulesetID == 0)).BeatmapInfo },
+                        Ruleset = { Value = new OsuRuleset().RulesetInfo },
+                    }
+                }
+            });
+
+            enterGameplay();
+
+            AddStep("join other user", () => client.AddUser(new APIUser { Id = 1234 }));
+            AddStep("add item as other user", () => client.AddUserPlaylistItem(1234, new MultiplayerPlaylistItem(new PlaylistItem
+            {
+                BeatmapID = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.RulesetID == 0)).BeatmapInfo.OnlineID ?? -1
+            })));
+
+            AddUntilStep("item arrived in playlist", () => client.Room?.Playlist.Count == 2);
+
+            AddStep("exit gameplay as initial user", () => multiplayerScreenStack.MultiplayerScreen.MakeCurrent());
+            AddUntilStep("queue contains item", () => this.ChildrenOfType<MultiplayerQueueList>().Single().Items.Single().ID == 2);
+        }
+
         [Test]
         public void TestItemAddedAndDeletedByOtherUserDuringGameplay()
         {

From 18d7b7920798bec5097f30b1ff85f413a4adf098 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 15 Dec 2021 17:37:39 +0900
Subject: [PATCH 1689/5547] Don't reset spectating state if gameplay is
 finished

---
 .../Multiplayer/TestSceneMultiplayer.cs       | 91 ++++++++++++++++++-
 .../Visual/TestMultiplayerScreenStack.cs      |  2 +-
 .../Spectate/MultiSpectatorScreen.cs          |  9 +-
 3 files changed, 96 insertions(+), 6 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
index bc2902480d..a2de391aec 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
@@ -30,6 +30,7 @@ using osu.Game.Screens.OnlinePlay.Lounge.Components;
 using osu.Game.Screens.OnlinePlay.Match;
 using osu.Game.Screens.OnlinePlay.Multiplayer;
 using osu.Game.Screens.OnlinePlay.Multiplayer.Match;
+using osu.Game.Screens.OnlinePlay.Multiplayer.Spectate;
 using osu.Game.Screens.Play;
 using osu.Game.Screens.Ranking;
 using osu.Game.Screens.Spectate;
@@ -656,23 +657,107 @@ namespace osu.Game.Tests.Visual.Multiplayer
             });
         }
 
+        [Test]
+        public void TestSpectatingStateResetOnBackButtonDuringGameplay()
+        {
+            createRoom(() => new Room
+            {
+                Name = { Value = "Test Room" },
+                QueueMode = { Value = QueueMode.AllPlayers },
+                Playlist =
+                {
+                    new PlaylistItem
+                    {
+                        Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.RulesetID == 0)).BeatmapInfo },
+                        Ruleset = { Value = new OsuRuleset().RulesetInfo },
+                    }
+                }
+            });
+
+            AddStep("set spectating state", () => client.ChangeUserState(API.LocalUser.Value.OnlineID, MultiplayerUserState.Spectating));
+            AddUntilStep("state set to spectating", () => client.LocalUser?.State == MultiplayerUserState.Spectating);
+
+            AddStep("join other user", () => client.AddUser(new APIUser { Id = 1234 }));
+            AddStep("set other user ready", () => client.ChangeUserState(1234, MultiplayerUserState.Ready));
+
+            pressReadyButton(1234);
+            AddUntilStep("wait for gameplay", () => (multiplayerScreenStack.CurrentScreen as MultiSpectatorScreen)?.IsLoaded == true);
+
+            AddStep("press back button and exit", () =>
+            {
+                multiplayerScreenStack.OnBackButton();
+                multiplayerScreenStack.Exit();
+            });
+
+            AddUntilStep("wait for return to match subscreen", () => multiplayerScreenStack.MultiplayerScreen.IsCurrentScreen());
+            AddUntilStep("user state is idle", () => client.LocalUser?.State == MultiplayerUserState.Idle);
+        }
+
+        [Test]
+        public void TestSpectatingStateNotResetOnBackButtonOutsideOfGameplay()
+        {
+            createRoom(() => new Room
+            {
+                Name = { Value = "Test Room" },
+                QueueMode = { Value = QueueMode.AllPlayers },
+                Playlist =
+                {
+                    new PlaylistItem
+                    {
+                        Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.RulesetID == 0)).BeatmapInfo },
+                        Ruleset = { Value = new OsuRuleset().RulesetInfo },
+                    }
+                }
+            });
+
+            AddStep("set spectating state", () => client.ChangeUserState(API.LocalUser.Value.OnlineID, MultiplayerUserState.Spectating));
+            AddUntilStep("state set to spectating", () => client.LocalUser?.State == MultiplayerUserState.Spectating);
+
+            AddStep("join other user", () => client.AddUser(new APIUser { Id = 1234 }));
+            AddStep("set other user ready", () => client.ChangeUserState(1234, MultiplayerUserState.Ready));
+
+            pressReadyButton(1234);
+            AddUntilStep("wait for gameplay", () => (multiplayerScreenStack.CurrentScreen as MultiSpectatorScreen)?.IsLoaded == true);
+            AddStep("set other user loaded", () => client.ChangeUserState(1234, MultiplayerUserState.Loaded));
+            AddStep("set other user finished play", () => client.ChangeUserState(1234, MultiplayerUserState.FinishedPlay));
+
+            AddStep("press back button and exit", () =>
+            {
+                multiplayerScreenStack.OnBackButton();
+                multiplayerScreenStack.Exit();
+            });
+
+            AddUntilStep("wait for return to match subscreen", () => multiplayerScreenStack.MultiplayerScreen.IsCurrentScreen());
+            AddWaitStep("wait for possible state change", 5);
+            AddUntilStep("user state is spectating", () => client.LocalUser?.State == MultiplayerUserState.Spectating);
+        }
+
+        private void enterGameplay()
+        {
+            pressReadyButton();
+            pressReadyButton();
+            AddUntilStep("wait for player", () => multiplayerScreenStack.CurrentScreen is Player);
+        }
+
         private ReadyButton readyButton => this.ChildrenOfType<ReadyButton>().Single();
 
-        private void pressReadyButton()
+        private void pressReadyButton(int? playingUserId = null)
         {
             AddUntilStep("wait for ready button to be enabled", () => readyButton.Enabled.Value);
 
             MultiplayerUserState lastState = MultiplayerUserState.Idle;
+            MultiplayerRoomUser user = null;
 
             AddStep("click ready button", () =>
             {
-                lastState = client.LocalUser?.State ?? MultiplayerUserState.Idle;
+                user = playingUserId == null ? client.LocalUser : client.Room?.Users.Single(u => u.UserID == playingUserId);
+                lastState = user?.State ?? MultiplayerUserState.Idle;
 
                 InputManager.MoveMouseTo(readyButton);
                 InputManager.Click(MouseButton.Left);
             });
 
-            AddUntilStep("wait for state change", () => client.LocalUser?.State != lastState);
+            AddUntilStep("wait for state change", () => user?.State != lastState);
         }
 
         private void createRoom(Func<Room> room)
diff --git a/osu.Game.Tests/Visual/TestMultiplayerScreenStack.cs b/osu.Game.Tests/Visual/TestMultiplayerScreenStack.cs
index 7f1171db1f..370f3bd0ae 100644
--- a/osu.Game.Tests/Visual/TestMultiplayerScreenStack.cs
+++ b/osu.Game.Tests/Visual/TestMultiplayerScreenStack.cs
@@ -61,7 +61,7 @@ namespace osu.Game.Tests.Visual
             ((DummyAPIAccess)api).HandleRequest = request => multiplayerScreen.RequestsHandler.HandleRequest(request, api.LocalUser.Value, game);
         }
 
-        public override bool OnBackButton() => multiplayerScreen.OnBackButton();
+        public override bool OnBackButton() => (screenStack.CurrentScreen as OsuScreen)?.OnBackButton() ?? base.OnBackButton();
 
         public override bool OnExiting(IScreen next)
         {
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorScreen.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorScreen.cs
index 9ac64add9a..7350408eba 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorScreen.cs
@@ -2,6 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
+using System.Diagnostics;
 using System.Linq;
 using JetBrains.Annotations;
 using osu.Framework.Allocation;
@@ -226,8 +227,12 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Spectate
 
         public override bool OnBackButton()
         {
-            // On a manual exit, set the player state back to idle.
-            multiplayerClient.ChangeState(MultiplayerUserState.Idle);
+            Debug.Assert(multiplayerClient.Room != null);
+
+            // On a manual exit, set the player back to idle unless gameplay has finished.
+            if (multiplayerClient.Room.State != MultiplayerRoomState.Open)
+                multiplayerClient.ChangeState(MultiplayerUserState.Idle);
+
             return base.OnBackButton();
         }
     }

From c50206e25e285994df75c1927d5aa2889ce9d100 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 16 Dec 2021 14:11:38 +0900
Subject: [PATCH 1690/5547] Update a few more public facing usages of "lazer"

---
 CONTRIBUTING.md | 8 ++++----
 README.md       | 2 +-
 2 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index e14be20642..ae2bdd2e82 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -1,6 +1,6 @@
 # Contributing Guidelines
 
-Thank you for showing interest in the development of osu!lazer! We aim to provide a good collaborating environment for everyone involved, and as such have decided to list some of the most important things to keep in mind in the process. The guidelines below have been chosen based on past experience.
+Thank you for showing interest in the development of osu!. We aim to provide a good collaborating environment for everyone involved, and as such have decided to list some of the most important things to keep in mind in the process. The guidelines below have been chosen based on past experience.
 
 These are not "official rules" *per se*, but following them will help everyone deal with things in the most efficient manner.
 
@@ -32,7 +32,7 @@ Issues, bug reports and feature suggestions are welcomed, though please keep in
 
 * **Provide more information when asked to do so.**
 
-  Sometimes when a bug is more elusive or complicated, none of the information listed above will pinpoint a concrete cause of the problem. In this case we will most likely ask you for additional info, such as a Windows Event Log dump or a copy of your local lazer database (`client.db`). Providing that information is beneficial to both parties - we can track down the problem better, and hopefully fix it for you at some point once we know where it is!
+  Sometimes when a bug is more elusive or complicated, none of the information listed above will pinpoint a concrete cause of the problem. In this case we will most likely ask you for additional info, such as a Windows Event Log dump or a copy of your local osu! database (`client.db`). Providing that information is beneficial to both parties - we can track down the problem better, and hopefully fix it for you at some point once we know where it is!
 
 * **When submitting a feature proposal, please describe it in the most understandable way you can.**
 
@@ -54,7 +54,7 @@ Issues, bug reports and feature suggestions are welcomed, though please keep in
 
 We also welcome pull requests from unaffiliated contributors. The [issue tracker](https://github.com/ppy/osu/issues) should provide plenty of issues that you can work on; we also mark issues that we think would be good for newcomers with the [`good-first-issue`](https://github.com/ppy/osu/issues?q=is%3Aissue+is%3Aopen+label%3Agood-first-issue) label.
 
-However, do keep in mind that the core team is committed to bringing osu!lazer up to par with stable first and foremost, so depending on what your contribution concerns, it might not be merged and released right away. Our approach to managing issues and their priorities is described [in the wiki](https://github.com/ppy/osu/wiki/Project-management).
+However, do keep in mind that the core team is committed to bringing osu!(lazer) up to par with osu!(stable) first and foremost, so depending on what your contribution concerns, it might not be merged and released right away. Our approach to managing issues and their priorities is described [in the wiki](https://github.com/ppy/osu/wiki/Project-management).
 
 Here are some key things to note before jumping in:
 
@@ -128,7 +128,7 @@ Here are some key things to note before jumping in:
 
 * **Don't mistake criticism of code for criticism of your person.**
 
-  As mentioned before, we are highly committed to quality when it comes to the lazer project. This means that contributions from less experienced community members can take multiple rounds of review to get to a mergeable state. We try our utmost best to never conflate a person with the code they authored, and to keep the discussion focused on the code at all times. Please consider our comments and requests a learning experience, and don't treat it as a personal attack.
+  As mentioned before, we are highly committed to quality when it comes to the osu! project. This means that contributions from less experienced community members can take multiple rounds of review to get to a mergeable state. We try our utmost best to never conflate a person with the code they authored, and to keep the discussion focused on the code at all times. Please consider our comments and requests a learning experience, and don't treat it as a personal attack.
 
 * **Feel free to reach out for help.**
 
diff --git a/README.md b/README.md
index 786ce2589d..24b70b2de6 100644
--- a/README.md
+++ b/README.md
@@ -11,7 +11,7 @@
 
 A free-to-win rhythm game. Rhythm is just a *click* away!
 
-The future of [osu!](https://osu.ppy.sh) and the beginning of an open era! Currently known by and released under the codename "*lazer*". As in sharper than cutting-edge.
+The future of [osu!](https://osu.ppy.sh) and the beginning of an open era! Currently known by and released under the release codename "*lazer*". As in sharper than cutting-edge.
 
 ## Status
 

From b3e83a47a4651442ddd499d66f63a7b96c6173bf Mon Sep 17 00:00:00 2001
From: Imad Dodin <imad.dodin@mail.mcgill.ca>
Date: Wed, 15 Dec 2021 21:34:59 -0800
Subject: [PATCH 1691/5547] Convert to Local Time in Date Tooltip

---
 osu.Game/Graphics/DateTooltip.cs  | 6 ++++--
 osu.Game/Graphics/DrawableDate.cs | 2 +-
 2 files changed, 5 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Graphics/DateTooltip.cs b/osu.Game/Graphics/DateTooltip.cs
index 3094f9cc2b..d5768b259a 100644
--- a/osu.Game/Graphics/DateTooltip.cs
+++ b/osu.Game/Graphics/DateTooltip.cs
@@ -65,8 +65,10 @@ namespace osu.Game.Graphics
 
         public void SetContent(DateTimeOffset date)
         {
-            dateText.Text = $"{date:d MMMM yyyy} ";
-            timeText.Text = $"{date:HH:mm:ss \"UTC\"z}";
+            DateTimeOffset localDate = date.ToLocalTime();
+
+            dateText.Text = $"{localDate:d MMMM yyyy} ";
+            timeText.Text = $"{localDate:HH:mm:ss \"UTC\"z}";
         }
 
         public void Move(Vector2 pos) => Position = pos;
diff --git a/osu.Game/Graphics/DrawableDate.cs b/osu.Game/Graphics/DrawableDate.cs
index 567a39b4f4..4605976692 100644
--- a/osu.Game/Graphics/DrawableDate.cs
+++ b/osu.Game/Graphics/DrawableDate.cs
@@ -22,7 +22,7 @@ namespace osu.Game.Graphics
                 if (date == value)
                     return;
 
-                date = value.ToLocalTime();
+                date = value;
 
                 if (LoadState >= LoadState.Ready)
                     updateTime();

From a9dbcd92a1fc05a8bbb800f1f0c5a4c7c2f147f5 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 16 Dec 2021 15:11:48 +0900
Subject: [PATCH 1692/5547] Split out unmanaged implementation of `RealmLive`
 into its own class

---
 osu.Game/Database/RealmLive.cs             | 16 ++------
 osu.Game/Database/RealmLiveUnmanaged.cs    | 44 ++++++++++++++++++++++
 osu.Game/Database/RealmObjectExtensions.cs |  4 +-
 3 files changed, 49 insertions(+), 15 deletions(-)
 create mode 100644 osu.Game/Database/RealmLiveUnmanaged.cs

diff --git a/osu.Game/Database/RealmLive.cs b/osu.Game/Database/RealmLive.cs
index 4f7bdf93e4..90b8814c24 100644
--- a/osu.Game/Database/RealmLive.cs
+++ b/osu.Game/Database/RealmLive.cs
@@ -24,20 +24,16 @@ namespace osu.Game.Database
         /// </summary>
         private readonly T data;
 
-        private readonly RealmContextFactory? realmFactory;
+        private readonly RealmContextFactory realmFactory;
 
         /// <summary>
         /// Construct a new instance of live realm data.
         /// </summary>
         /// <param name="data">The realm data.</param>
         /// <param name="realmFactory">The realm factory the data was sourced from. May be null for an unmanaged object.</param>
-        public RealmLive(T data, RealmContextFactory? realmFactory)
+        public RealmLive(T data, RealmContextFactory realmFactory)
         {
             this.data = data;
-
-            if (IsManaged && realmFactory == null)
-                throw new ArgumentException(@"Realm factory must be provided for a managed instance", nameof(realmFactory));
-
             this.realmFactory = realmFactory;
 
             ID = data.ID;
@@ -55,9 +51,6 @@ namespace osu.Game.Database
                 return;
             }
 
-            if (realmFactory == null)
-                throw new ArgumentException(@"Realm factory must be provided for a managed instance", nameof(realmFactory));
-
             using (var realm = realmFactory.CreateContext())
                 perform(realm.Find<T>(ID));
         }
@@ -74,9 +67,6 @@ namespace osu.Game.Database
             if (!IsManaged)
                 return perform(data);
 
-            if (realmFactory == null)
-                throw new ArgumentException(@"Realm factory must be provided for a managed instance", nameof(realmFactory));
-
             using (var realm = realmFactory.CreateContext())
                 return perform(realm.Find<T>(ID));
         }
@@ -108,7 +98,7 @@ namespace osu.Game.Database
                 if (!ThreadSafety.IsUpdateThread)
                     throw new InvalidOperationException($"Can't use {nameof(Value)} on managed objects from non-update threads");
 
-                return realmFactory!.Context.Find<T>(ID);
+                return realmFactory.Context.Find<T>(ID);
             }
         }
 
diff --git a/osu.Game/Database/RealmLiveUnmanaged.cs b/osu.Game/Database/RealmLiveUnmanaged.cs
new file mode 100644
index 0000000000..5a69898206
--- /dev/null
+++ b/osu.Game/Database/RealmLiveUnmanaged.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 System;
+using Realms;
+
+#nullable enable
+
+namespace osu.Game.Database
+{
+    /// <summary>
+    /// Provides a method of working with unmanaged realm objects.
+    /// Usually used for testing purposes where the instance is never required to be managed.
+    /// </summary>
+    /// <typeparam name="T">The underlying object type.</typeparam>
+    public class RealmLiveUnmanaged<T> : ILive<T> where T : RealmObjectBase, IHasGuidPrimaryKey
+    {
+        /// <summary>
+        /// Construct a new instance of live realm data.
+        /// </summary>
+        /// <param name="data">The realm data.</param>
+        public RealmLiveUnmanaged(T data)
+        {
+            Value = data;
+        }
+
+        public bool Equals(ILive<T>? other) => ID == other?.ID;
+
+        public Guid ID => Value.ID;
+
+        public void PerformRead(Action<T> perform) => perform(Value);
+
+        public TReturn PerformRead<TReturn>(Func<T, TReturn> perform) => perform(Value);
+
+        public void PerformWrite(Action<T> perform) => throw new InvalidOperationException(@"Can't perform writes on a non-managed underlying value");
+
+        public bool IsManaged => false;
+
+        /// <summary>
+        /// The original live data used to create this instance.
+        /// </summary>
+        public T Value { get; }
+    }
+}
diff --git a/osu.Game/Database/RealmObjectExtensions.cs b/osu.Game/Database/RealmObjectExtensions.cs
index c546a70fae..e5177823ba 100644
--- a/osu.Game/Database/RealmObjectExtensions.cs
+++ b/osu.Game/Database/RealmObjectExtensions.cs
@@ -56,13 +56,13 @@ namespace osu.Game.Database
         public static List<ILive<T>> ToLiveUnmanaged<T>(this IEnumerable<T> realmList)
             where T : RealmObject, IHasGuidPrimaryKey
         {
-            return realmList.Select(l => new RealmLive<T>(l, null)).Cast<ILive<T>>().ToList();
+            return realmList.Select(l => new RealmLiveUnmanaged<T>(l)).Cast<ILive<T>>().ToList();
         }
 
         public static ILive<T> ToLiveUnmanaged<T>(this T realmObject)
             where T : RealmObject, IHasGuidPrimaryKey
         {
-            return new RealmLive<T>(realmObject, null);
+            return new RealmLiveUnmanaged<T>(realmObject);
         }
 
         public static List<ILive<T>> ToLive<T>(this IEnumerable<T> realmList, RealmContextFactory realmContextFactory)

From 488374b4a27c56b0f26061d55e3f7648236e3354 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 16 Dec 2021 16:41:47 +0900
Subject: [PATCH 1693/5547] Don't show multiplayer channels in chat overlay

---
 .../Visual/Online/TestSceneChatOverlay.cs     | 19 +++++++++++++++++++
 osu.Game/Overlays/ChatOverlay.cs              | 14 +++++++++-----
 2 files changed, 28 insertions(+), 5 deletions(-)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneChatOverlay.cs b/osu.Game.Tests/Visual/Online/TestSceneChatOverlay.cs
index 9c65b2dc51..14f32df653 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneChatOverlay.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneChatOverlay.cs
@@ -393,6 +393,25 @@ namespace osu.Game.Tests.Visual.Online
                 channelManager.CurrentChannel.Value.Type == ChannelType.PM && channelManager.CurrentChannel.Value.Users.Single().Username == "some body");
         }
 
+        [Test]
+        public void TestMultiplayerChannelIsNotShown()
+        {
+            Channel multiplayerChannel = null;
+
+            AddStep("join multiplayer channel", () => channelManager.JoinChannel(multiplayerChannel = new Channel(new APIUser())
+            {
+                Name = "#mp_1",
+                Type = ChannelType.Multiplayer,
+            }));
+
+            AddAssert("channel joined", () => channelManager.JoinedChannels.Contains(multiplayerChannel));
+            AddAssert("channel not present in overlay", () => !chatOverlay.TabMap.ContainsKey(multiplayerChannel));
+            AddAssert("multiplayer channel is not current", () => channelManager.CurrentChannel.Value != multiplayerChannel);
+
+            AddStep("leave channel", () => channelManager.LeaveChannel(multiplayerChannel));
+            AddAssert("channel left", () => !channelManager.JoinedChannels.Contains(multiplayerChannel));
+        }
+
         private void pressChannelHotkey(int number)
         {
             var channelKey = Key.Number0 + number;
diff --git a/osu.Game/Overlays/ChatOverlay.cs b/osu.Game/Overlays/ChatOverlay.cs
index cc3ce63bf7..72473d5750 100644
--- a/osu.Game/Overlays/ChatOverlay.cs
+++ b/osu.Game/Overlays/ChatOverlay.cs
@@ -237,10 +237,7 @@ namespace osu.Game.Overlays
             Schedule(() =>
             {
                 // TODO: consider scheduling bindable callbacks to not perform when overlay is not present.
-                channelManager.JoinedChannels.CollectionChanged += joinedChannelsChanged;
-
-                foreach (Channel channel in channelManager.JoinedChannels)
-                    ChannelTabControl.AddChannel(channel);
+                channelManager.JoinedChannels.BindCollectionChanged(joinedChannelsChanged, true);
 
                 channelManager.AvailableChannels.CollectionChanged += availableChannelsChanged;
                 availableChannelsChanged(null, null);
@@ -436,12 +433,19 @@ namespace osu.Game.Overlays
             {
                 case NotifyCollectionChangedAction.Add:
                     foreach (Channel channel in args.NewItems.Cast<Channel>())
-                        ChannelTabControl.AddChannel(channel);
+                    {
+                        if (channel.Type != ChannelType.Multiplayer)
+                            ChannelTabControl.AddChannel(channel);
+                    }
+
                     break;
 
                 case NotifyCollectionChangedAction.Remove:
                     foreach (Channel channel in args.OldItems.Cast<Channel>())
                     {
+                        if (!ChannelTabControl.Items.Contains(channel))
+                            continue;
+
                         ChannelTabControl.RemoveChannel(channel);
 
                         var loaded = loadedChannels.Find(c => c.Channel == channel);

From 0eac655cff09722b5077ff48cc09702d541c0326 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 16 Dec 2021 18:21:48 +0900
Subject: [PATCH 1694/5547] Remove local screen change logging

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

diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index a35191613c..d2d6dad0c6 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -1149,16 +1149,11 @@ namespace osu.Game
             }
         }
 
-        private void screenPushed(IScreen lastScreen, IScreen newScreen)
-        {
-            ScreenChanged(lastScreen, newScreen);
-            Logger.Log($"Screen changed → {newScreen}");
-        }
+        private void screenPushed(IScreen lastScreen, IScreen newScreen) => ScreenChanged(lastScreen, newScreen);
 
         private void screenExited(IScreen lastScreen, IScreen newScreen)
         {
             ScreenChanged(lastScreen, newScreen);
-            Logger.Log($"Screen changed ← {newScreen}");
 
             if (newScreen == null)
                 Exit();

From 434aa0367f4c58349bbc05258a02a99d233ef54f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 16 Dec 2021 18:25:28 +0900
Subject: [PATCH 1695/5547] Add back `.ToLocalTime()` call to `DrawableDate`

This is required because the class is used in many other places that
don't locally call it.
---
 osu.Game/Graphics/DrawableDate.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Graphics/DrawableDate.cs b/osu.Game/Graphics/DrawableDate.cs
index 4605976692..567a39b4f4 100644
--- a/osu.Game/Graphics/DrawableDate.cs
+++ b/osu.Game/Graphics/DrawableDate.cs
@@ -22,7 +22,7 @@ namespace osu.Game.Graphics
                 if (date == value)
                     return;
 
-                date = value;
+                date = value.ToLocalTime();
 
                 if (LoadState >= LoadState.Ready)
                     updateTime();

From 5ea081e89908e35993d29553218fe2254bda2c7b Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 16 Dec 2021 19:04:42 +0900
Subject: [PATCH 1696/5547] Test hyperdash generation in catch conversion tests

---
 .../CatchBeatmapConversionTest.cs             |  12 +-
 .../Beatmaps/basic-expected-conversion.json   | 921 ++++++++++++------
 ...ock-repeat-slider-expected-conversion.json | 108 +-
 .../hardrock-spinner-expected-conversion.json |  51 +-
 .../hardrock-stream-expected-conversion.json  |  99 +-
 ...t-bound-hr-offset-expected-conversion.json |   6 +-
 .../Beatmaps/slider-expected-conversion.json  |  72 +-
 ...inner-and-circles-expected-conversion.json |  30 +-
 .../Beatmaps/spinner-expected-conversion.json |  51 +-
 9 files changed, 926 insertions(+), 424 deletions(-)

diff --git a/osu.Game.Rulesets.Catch.Tests/CatchBeatmapConversionTest.cs b/osu.Game.Rulesets.Catch.Tests/CatchBeatmapConversionTest.cs
index 33fdcdaf1e..3352982c20 100644
--- a/osu.Game.Rulesets.Catch.Tests/CatchBeatmapConversionTest.cs
+++ b/osu.Game.Rulesets.Catch.Tests/CatchBeatmapConversionTest.cs
@@ -70,6 +70,7 @@ namespace osu.Game.Rulesets.Catch.Tests
             HitObject = hitObject;
             startTime = 0;
             position = 0;
+            hyperDash = false;
         }
 
         private double startTime;
@@ -88,8 +89,17 @@ namespace osu.Game.Rulesets.Catch.Tests
             set => position = value;
         }
 
+        private bool hyperDash;
+
+        public bool HyperDash
+        {
+            get => (HitObject as PalpableCatchHitObject)?.HyperDash ?? hyperDash;
+            set => hyperDash = value;
+        }
+
         public bool Equals(ConvertValue other)
             => Precision.AlmostEquals(StartTime, other.StartTime, conversion_lenience)
-               && Precision.AlmostEquals(Position, other.Position, conversion_lenience);
+               && Precision.AlmostEquals(Position, other.Position, conversion_lenience)
+               && HyperDash == other.hyperDash;
     }
 }
diff --git a/osu.Game.Rulesets.Catch/Resources/Testing/Beatmaps/basic-expected-conversion.json b/osu.Game.Rulesets.Catch/Resources/Testing/Beatmaps/basic-expected-conversion.json
index b65d54a565..07ceb199bd 100644
--- a/osu.Game.Rulesets.Catch/Resources/Testing/Beatmaps/basic-expected-conversion.json
+++ b/osu.Game.Rulesets.Catch/Resources/Testing/Beatmaps/basic-expected-conversion.json
@@ -3,135 +3,168 @@
             "StartTime": 500,
             "Objects": [{
                     "StartTime": 500,
-                    "Position": 96
+                    "Position": 96,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 562,
-                    "Position": 100.84
+                    "Position": 100.84,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 625,
-                    "Position": 125
+                    "Position": 125,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 687,
-                    "Position": 152.84
+                    "Position": 152.84,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 750,
-                    "Position": 191
+                    "Position": 191,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 812,
-                    "Position": 212.84
+                    "Position": 212.84,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 875,
-                    "Position": 217
+                    "Position": 217,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 937,
-                    "Position": 234.84
+                    "Position": 234.84,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 1000,
-                    "Position": 256
+                    "Position": 256,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 1062,
-                    "Position": 267.84
+                    "Position": 267.84,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 1125,
-                    "Position": 284
+                    "Position": 284,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 1187,
-                    "Position": 311.84
+                    "Position": 311.84,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 1250,
-                    "Position": 350
+                    "Position": 350,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 1312,
-                    "Position": 359.84
+                    "Position": 359.84,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 1375,
-                    "Position": 367
+                    "Position": 367,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 1437,
-                    "Position": 400.84
+                    "Position": 400.84,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 1500,
-                    "Position": 416
+                    "Position": 416,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 1562,
-                    "Position": 377.159973
+                    "Position": 377.159973,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 1625,
-                    "Position": 367
+                    "Position": 367,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 1687,
-                    "Position": 374.159973
+                    "Position": 374.159973,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 1750,
-                    "Position": 353
+                    "Position": 353,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 1812,
-                    "Position": 329.159973
+                    "Position": 329.159973,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 1875,
-                    "Position": 288
+                    "Position": 288,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 1937,
-                    "Position": 259.159973
+                    "Position": 259.159973,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 2000,
-                    "Position": 256
+                    "Position": 256,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 2058,
-                    "Position": 232.44
+                    "Position": 232.44,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 2116,
-                    "Position": 222.879974
+                    "Position": 222.879974,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 2174,
-                    "Position": 185.319992
+                    "Position": 185.319992,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 2232,
-                    "Position": 177.76001
+                    "Position": 177.76001,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 2290,
-                    "Position": 162.200012
+                    "Position": 162.200012,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 2348,
-                    "Position": 158.639984
+                    "Position": 158.639984,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 2406,
-                    "Position": 111.079994
+                    "Position": 111.079994,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 2500,
-                    "Position": 96
+                    "Position": 96,
+                    "HyperDash": false
                 }
             ]
         },
@@ -139,71 +172,88 @@
             "StartTime": 3000,
             "Objects": [{
                     "StartTime": 3000,
-                    "Position": 18
+                    "Position": 18,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 3062,
-                    "Position": 249
+                    "Position": 249,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 3125,
-                    "Position": 184
+                    "Position": 184,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 3187,
-                    "Position": 477
+                    "Position": 477,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 3250,
-                    "Position": 43
+                    "Position": 43,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 3312,
-                    "Position": 494
+                    "Position": 494,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 3375,
-                    "Position": 135
+                    "Position": 135,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 3437,
-                    "Position": 30
+                    "Position": 30,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 3500,
-                    "Position": 11
+                    "Position": 11,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 3562,
-                    "Position": 239
+                    "Position": 239,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 3625,
-                    "Position": 505
+                    "Position": 505,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 3687,
-                    "Position": 353
+                    "Position": 353,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 3750,
-                    "Position": 136
+                    "Position": 136,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 3812,
-                    "Position": 135
+                    "Position": 135,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 3875,
-                    "Position": 346
+                    "Position": 346,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 3937,
-                    "Position": 39
+                    "Position": 39,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 4000,
-                    "Position": 300
+                    "Position": 300,
+                    "HyperDash": false
                 }
             ]
         },
@@ -211,71 +261,88 @@
             "StartTime": 4500,
             "Objects": [{
                     "StartTime": 4500,
-                    "Position": 398
+                    "Position": 398,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 4562,
-                    "Position": 151
+                    "Position": 151,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 4625,
-                    "Position": 73
+                    "Position": 73,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 4687,
-                    "Position": 311
+                    "Position": 311,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 4750,
-                    "Position": 90
+                    "Position": 90,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 4812,
-                    "Position": 264
+                    "Position": 264,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 4875,
-                    "Position": 477
+                    "Position": 477,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 4937,
-                    "Position": 473
+                    "Position": 473,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 5000,
-                    "Position": 120
+                    "Position": 120,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 5062,
-                    "Position": 115
+                    "Position": 115,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 5125,
-                    "Position": 163
+                    "Position": 163,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 5187,
-                    "Position": 447
+                    "Position": 447,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 5250,
-                    "Position": 72
+                    "Position": 72,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 5312,
-                    "Position": 257
+                    "Position": 257,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 5375,
-                    "Position": 153
+                    "Position": 153,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 5437,
-                    "Position": 388
+                    "Position": 388,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 5500,
-                    "Position": 336
+                    "Position": 336,
+                    "HyperDash": false
                 }
             ]
         },
@@ -283,39 +350,48 @@
             "StartTime": 6000,
             "Objects": [{
                     "StartTime": 6000,
-                    "Position": 13
+                    "Position": 13,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 6062,
-                    "Position": 429
+                    "Position": 429,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 6125,
-                    "Position": 381
+                    "Position": 381,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 6187,
-                    "Position": 186
+                    "Position": 186,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 6250,
-                    "Position": 267
+                    "Position": 267,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 6312,
-                    "Position": 305
+                    "Position": 305,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 6375,
-                    "Position": 456
+                    "Position": 456,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 6437,
-                    "Position": 26
+                    "Position": 26,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 6500,
-                    "Position": 238
+                    "Position": 238,
+                    "HyperDash": false
                 }
             ]
         },
@@ -323,71 +399,88 @@
             "StartTime": 7000,
             "Objects": [{
                     "StartTime": 7000,
-                    "Position": 256
+                    "Position": 256,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 7062,
-                    "Position": 262.84
+                    "Position": 262.84,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 7125,
-                    "Position": 295
+                    "Position": 295,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 7187,
-                    "Position": 303.84
+                    "Position": 303.84,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 7250,
-                    "Position": 336
+                    "Position": 336,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 7312,
-                    "Position": 319.16
+                    "Position": 319.16,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 7375,
-                    "Position": 306
+                    "Position": 306,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 7437,
-                    "Position": 272.16
+                    "Position": 272.16,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 7500,
-                    "Position": 256
+                    "Position": 256,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 7562,
-                    "Position": 255.84
+                    "Position": 255.84,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 7625,
-                    "Position": 300
+                    "Position": 300,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 7687,
-                    "Position": 320.84
+                    "Position": 320.84,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 7750,
-                    "Position": 336
+                    "Position": 336,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 7803,
-                    "Position": 319.04
+                    "Position": 319.04,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 7857,
-                    "Position": 283.76
+                    "Position": 283.76,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 7910,
-                    "Position": 265.8
+                    "Position": 265.8,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 8000,
-                    "Position": 256
+                    "Position": 256,
+                    "HyperDash": false
                 }
             ]
         },
@@ -395,167 +488,208 @@
             "StartTime": 8500,
             "Objects": [{
                     "StartTime": 8500,
-                    "Position": 32
+                    "Position": 32,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 8562,
-                    "Position": 21.8515015
+                    "Position": 21.8515015,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 8625,
-                    "Position": 44.5659637
+                    "Position": 44.5659637,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 8687,
-                    "Position": 33.3433228
+                    "Position": 33.3433228,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 8750,
-                    "Position": 63.58974
+                    "Position": 63.58974,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 8812,
-                    "Position": 71.23422
+                    "Position": 71.23422,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 8875,
-                    "Position": 62.7117844
+                    "Position": 62.7117844,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 8937,
-                    "Position": 65.52607
+                    "Position": 65.52607,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 9000,
-                    "Position": 101.81015
+                    "Position": 101.81015,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 9062,
-                    "Position": 134.47818
+                    "Position": 134.47818,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 9125,
-                    "Position": 141.414444
+                    "Position": 141.414444,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 9187,
-                    "Position": 164.1861
+                    "Position": 164.1861,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 9250,
-                    "Position": 176.600418
+                    "Position": 176.600418,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 9312,
-                    "Position": 184.293015
+                    "Position": 184.293015,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 9375,
-                    "Position": 212.2076
+                    "Position": 212.2076,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 9437,
-                    "Position": 236.438324
+                    "Position": 236.438324,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 9500,
-                    "Position": 237.2304
+                    "Position": 237.2304,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 9562,
-                    "Position": 241.253983
+                    "Position": 241.253983,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 9625,
-                    "Position": 233.950623
+                    "Position": 233.950623,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 9687,
-                    "Position": 265.3786
+                    "Position": 265.3786,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 9750,
-                    "Position": 236.8865
+                    "Position": 236.8865,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 9812,
-                    "Position": 273.38974
+                    "Position": 273.38974,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 9875,
-                    "Position": 267.701874
+                    "Position": 267.701874,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 9937,
-                    "Position": 263.2331
+                    "Position": 263.2331,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 10000,
-                    "Position": 270.339874
+                    "Position": 270.339874,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 10062,
-                    "Position": 291.9349
+                    "Position": 291.9349,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 10125,
-                    "Position": 294.2969
+                    "Position": 294.2969,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 10187,
-                    "Position": 307.834137
+                    "Position": 307.834137,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 10250,
-                    "Position": 310.6449
+                    "Position": 310.6449,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 10312,
-                    "Position": 344.746338
+                    "Position": 344.746338,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 10375,
-                    "Position": 349.21875
+                    "Position": 349.21875,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 10437,
-                    "Position": 373.943
+                    "Position": 373.943,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 10500,
-                    "Position": 401.0588
+                    "Position": 401.0588,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 10558,
-                    "Position": 421.21347
+                    "Position": 421.21347,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 10616,
-                    "Position": 431.6034
+                    "Position": 431.6034,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 10674,
-                    "Position": 433.835754
+                    "Position": 433.835754,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 10732,
-                    "Position": 452.5042
+                    "Position": 452.5042,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 10790,
-                    "Position": 486.290955
+                    "Position": 486.290955,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 10848,
-                    "Position": 488.943237
+                    "Position": 488.943237,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 10906,
-                    "Position": 493.3372
+                    "Position": 493.3372,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 10999,
-                    "Position": 508.166229
+                    "Position": 508.166229,
+                    "HyperDash": false
                 }
             ]
         },
@@ -563,39 +697,48 @@
             "StartTime": 11500,
             "Objects": [{
                     "StartTime": 11500,
-                    "Position": 97
+                    "Position": 97,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 11562,
-                    "Position": 267
+                    "Position": 267,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 11625,
-                    "Position": 116
+                    "Position": 116,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 11687,
-                    "Position": 451
+                    "Position": 451,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 11750,
-                    "Position": 414
+                    "Position": 414,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 11812,
-                    "Position": 88
+                    "Position": 88,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 11875,
-                    "Position": 257
+                    "Position": 257,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 11937,
-                    "Position": 175
+                    "Position": 175,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 12000,
-                    "Position": 38
+                    "Position": 38,
+                    "HyperDash": false
                 }
             ]
         },
@@ -603,263 +746,328 @@
             "StartTime": 12500,
             "Objects": [{
                     "StartTime": 12500,
-                    "Position": 512
+                    "Position": 512,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 12562,
-                    "Position": 494.3132
+                    "Position": 494.3132,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 12625,
-                    "Position": 461.3089
+                    "Position": 461.3089,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 12687,
-                    "Position": 469.6221
+                    "Position": 469.6221,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 12750,
-                    "Position": 441.617767
+                    "Position": 441.617767,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 12812,
-                    "Position": 402.930969
+                    "Position": 402.930969,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 12875,
-                    "Position": 407.926666
+                    "Position": 407.926666,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 12937,
-                    "Position": 364.239868
+                    "Position": 364.239868,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 13000,
-                    "Position": 353.235535
+                    "Position": 353.235535,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 13062,
-                    "Position": 320.548767
+                    "Position": 320.548767,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 13125,
-                    "Position": 303.544434
+                    "Position": 303.544434,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 13187,
-                    "Position": 295.857635
+                    "Position": 295.857635,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 13250,
-                    "Position": 265.853333
+                    "Position": 265.853333,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 13312,
-                    "Position": 272.166534
+                    "Position": 272.166534,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 13375,
-                    "Position": 240.1622
+                    "Position": 240.1622,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 13437,
-                    "Position": 229.4754
+                    "Position": 229.4754,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 13500,
-                    "Position": 194.471069
+                    "Position": 194.471069,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 13562,
-                    "Position": 158.784271
+                    "Position": 158.784271,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 13625,
-                    "Position": 137.779968
+                    "Position": 137.779968,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 13687,
-                    "Position": 147.09314
+                    "Position": 147.09314,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 13750,
-                    "Position": 122.088837
+                    "Position": 122.088837,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 13812,
-                    "Position": 77.40204
+                    "Position": 77.40204,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 13875,
-                    "Position": 79.3977356
+                    "Position": 79.3977356,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 13937,
-                    "Position": 56.710907
+                    "Position": 56.710907,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 14000,
-                    "Position": 35.7066345
+                    "Position": 35.7066345,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 14062,
-                    "Position": 1.01980591
+                    "Position": 1.01980591,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 14125,
-                    "Position": 0
+                    "Position": 0,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 14187,
-                    "Position": 21.7696266
+                    "Position": 21.7696266,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 14250,
-                    "Position": 49.0119171
+                    "Position": 49.0119171,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 14312,
-                    "Position": 48.9488258
+                    "Position": 48.9488258,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 14375,
-                    "Position": 87.19112
+                    "Position": 87.19112,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 14437,
-                    "Position": 97.12803
+                    "Position": 97.12803,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 14500,
-                    "Position": 118.370323
+                    "Position": 118.370323,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 14562,
-                    "Position": 130.307236
+                    "Position": 130.307236,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 14625,
-                    "Position": 154.549515
+                    "Position": 154.549515,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 14687,
-                    "Position": 190.486435
+                    "Position": 190.486435,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 14750,
-                    "Position": 211.728714
+                    "Position": 211.728714,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 14812,
-                    "Position": 197.665634
+                    "Position": 197.665634,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 14875,
-                    "Position": 214.907928
+                    "Position": 214.907928,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 14937,
-                    "Position": 263.844849
+                    "Position": 263.844849,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 15000,
-                    "Position": 271.087128
+                    "Position": 271.087128,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 15062,
-                    "Position": 270.024017
+                    "Position": 270.024017,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 15125,
-                    "Position": 308.266327
+                    "Position": 308.266327,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 15187,
-                    "Position": 313.203247
+                    "Position": 313.203247,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 15250,
-                    "Position": 328.445526
+                    "Position": 328.445526,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 15312,
-                    "Position": 370.382446
+                    "Position": 370.382446,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 15375,
-                    "Position": 387.624725
+                    "Position": 387.624725,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 15437,
-                    "Position": 421.561646
+                    "Position": 421.561646,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 15500,
-                    "Position": 423.803925
+                    "Position": 423.803925,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 15562,
-                    "Position": 444.740845
+                    "Position": 444.740845,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 15625,
-                    "Position": 469.983124
+                    "Position": 469.983124,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 15687,
-                    "Position": 473.920044
+                    "Position": 473.920044,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 15750,
-                    "Position": 501.162323
+                    "Position": 501.162323,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 15812,
-                    "Position": 488.784332
+                    "Position": 488.784332,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 15875,
-                    "Position": 466.226227
+                    "Position": 466.226227,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 15937,
-                    "Position": 445.978638
+                    "Position": 445.978638,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 16000,
-                    "Position": 446.420532
+                    "Position": 446.420532,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 16058,
-                    "Position": 428.4146
+                    "Position": 428.4146,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 16116,
-                    "Position": 420.408844
+                    "Position": 420.408844,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 16174,
-                    "Position": 374.402924
+                    "Position": 374.402924,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 16232,
-                    "Position": 371.397156
+                    "Position": 371.397156,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 16290,
-                    "Position": 350.391235
+                    "Position": 350.391235,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 16348,
-                    "Position": 340.385468
+                    "Position": 340.385468,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 16406,
-                    "Position": 337.3797
+                    "Position": 337.3797,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 16500,
-                    "Position": 291.1977
+                    "Position": 291.1977,
+                    "HyperDash": false
                 }
             ]
         },
@@ -867,71 +1075,88 @@
             "StartTime": 17000,
             "Objects": [{
                     "StartTime": 17000,
-                    "Position": 256
+                    "Position": 256,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 17062,
-                    "Position": 247.16
+                    "Position": 247.16,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 17125,
-                    "Position": 211
+                    "Position": 211,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 17187,
-                    "Position": 183.16
+                    "Position": 183.16,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 17250,
-                    "Position": 176
+                    "Position": 176,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 17312,
-                    "Position": 204.84
+                    "Position": 204.84,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 17375,
-                    "Position": 218
+                    "Position": 218,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 17437,
-                    "Position": 231.84
+                    "Position": 231.84,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 17500,
-                    "Position": 256
+                    "Position": 256,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 17562,
-                    "Position": 229.16
+                    "Position": 229.16,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 17625,
-                    "Position": 227
+                    "Position": 227,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 17687,
-                    "Position": 186.16
+                    "Position": 186.16,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 17750,
-                    "Position": 176
+                    "Position": 176,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 17803,
-                    "Position": 211.959991
+                    "Position": 211.959991,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 17857,
-                    "Position": 197.23999
+                    "Position": 197.23999,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 17910,
-                    "Position": 225.200012
+                    "Position": 225.200012,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 18000,
-                    "Position": 256
+                    "Position": 256,
+                    "HyperDash": false
                 }
             ]
         },
@@ -939,71 +1164,88 @@
             "StartTime": 18500,
             "Objects": [{
                     "StartTime": 18500,
-                    "Position": 437
+                    "Position": 437,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 18559,
-                    "Position": 289
+                    "Position": 289,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 18618,
-                    "Position": 464
+                    "Position": 464,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 18678,
-                    "Position": 36
+                    "Position": 36,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 18737,
-                    "Position": 378
+                    "Position": 378,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 18796,
-                    "Position": 297
+                    "Position": 297,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 18856,
-                    "Position": 418
+                    "Position": 418,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 18915,
-                    "Position": 329
+                    "Position": 329,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 18975,
-                    "Position": 338
+                    "Position": 338,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 19034,
-                    "Position": 394
+                    "Position": 394,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 19093,
-                    "Position": 40
+                    "Position": 40,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 19153,
-                    "Position": 13
+                    "Position": 13,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 19212,
-                    "Position": 80
+                    "Position": 80,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 19271,
-                    "Position": 138
+                    "Position": 138,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 19331,
-                    "Position": 311
+                    "Position": 311,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 19390,
-                    "Position": 216
+                    "Position": 216,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 19450,
-                    "Position": 310
+                    "Position": 310,
+                    "HyperDash": false
                 }
             ]
         },
@@ -1011,263 +1253,328 @@
             "StartTime": 19875,
             "Objects": [{
                     "StartTime": 19875,
-                    "Position": 216
+                    "Position": 216,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 19937,
-                    "Position": 228.307053
+                    "Position": 228.307053,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 20000,
-                    "Position": 214.036865
+                    "Position": 214.036865,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 20062,
-                    "Position": 224.312088
+                    "Position": 224.312088,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 20125,
-                    "Position": 253.838928
+                    "Position": 253.838928,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 20187,
-                    "Position": 259.9743
+                    "Position": 259.9743,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 20250,
-                    "Position": 299.999146
+                    "Position": 299.999146,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 20312,
-                    "Position": 289.669067
+                    "Position": 289.669067,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 20375,
-                    "Position": 317.446747
+                    "Position": 317.446747,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 20437,
-                    "Position": 344.750275
+                    "Position": 344.750275,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 20500,
-                    "Position": 328.0156
+                    "Position": 328.0156,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 20562,
-                    "Position": 331.472168
+                    "Position": 331.472168,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 20625,
-                    "Position": 302.165466
+                    "Position": 302.165466,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 20687,
-                    "Position": 303.044617
+                    "Position": 303.044617,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 20750,
-                    "Position": 306.457367
+                    "Position": 306.457367,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 20812,
-                    "Position": 265.220581
+                    "Position": 265.220581,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 20875,
-                    "Position": 270.3294
+                    "Position": 270.3294,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 20937,
-                    "Position": 257.57605
+                    "Position": 257.57605,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 21000,
-                    "Position": 247.803329
+                    "Position": 247.803329,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 21062,
-                    "Position": 225.958359
+                    "Position": 225.958359,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 21125,
-                    "Position": 201.79332
+                    "Position": 201.79332,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 21187,
-                    "Position": 170.948349
+                    "Position": 170.948349,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 21250,
-                    "Position": 146.78334
+                    "Position": 146.78334,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 21312,
-                    "Position": 149.93837
+                    "Position": 149.93837,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 21375,
-                    "Position": 119.121056
+                    "Position": 119.121056,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 21437,
-                    "Position": 133.387573
+                    "Position": 133.387573,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 21500,
-                    "Position": 117.503014
+                    "Position": 117.503014,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 21562,
-                    "Position": 103.749374
+                    "Position": 103.749374,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 21625,
-                    "Position": 127.165535
+                    "Position": 127.165535,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 21687,
-                    "Position": 113.029991
+                    "Position": 113.029991,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 21750,
-                    "Position": 101.547928
+                    "Position": 101.547928,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 21812,
-                    "Position": 133.856232
+                    "Position": 133.856232,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 21875,
-                    "Position": 124.28746
+                    "Position": 124.28746,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 21937,
-                    "Position": 121.754929
+                    "Position": 121.754929,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 22000,
-                    "Position": 155.528732
+                    "Position": 155.528732,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 22062,
-                    "Position": 142.1691
+                    "Position": 142.1691,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 22125,
-                    "Position": 186.802155
+                    "Position": 186.802155,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 22187,
-                    "Position": 198.6452
+                    "Position": 198.6452,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 22250,
-                    "Position": 191.892181
+                    "Position": 191.892181,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 22312,
-                    "Position": 232.713028
+                    "Position": 232.713028,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 22375,
-                    "Position": 240.4715
+                    "Position": 240.4715,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 22437,
-                    "Position": 278.3719
+                    "Position": 278.3719,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 22500,
-                    "Position": 288.907257
+                    "Position": 288.907257,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 22562,
-                    "Position": 297.353119
+                    "Position": 297.353119,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 22625,
-                    "Position": 301.273376
+                    "Position": 301.273376,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 22687,
-                    "Position": 339.98288
+                    "Position": 339.98288,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 22750,
-                    "Position": 353.078552
+                    "Position": 353.078552,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 22812,
-                    "Position": 363.8958
+                    "Position": 363.8958,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 22875,
-                    "Position": 398.054047
+                    "Position": 398.054047,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 22937,
-                    "Position": 419.739441
+                    "Position": 419.739441,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 23000,
-                    "Position": 435.178467
+                    "Position": 435.178467,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 23062,
-                    "Position": 420.8687
+                    "Position": 420.8687,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 23125,
-                    "Position": 448.069977
+                    "Position": 448.069977,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 23187,
-                    "Position": 425.688477
+                    "Position": 425.688477,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 23250,
-                    "Position": 426.9612
+                    "Position": 426.9612,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 23312,
-                    "Position": 454.92807
+                    "Position": 454.92807,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 23375,
-                    "Position": 439.749878
+                    "Position": 439.749878,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 23433,
-                    "Position": 440.644684
+                    "Position": 440.644684,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 23491,
-                    "Position": 445.7359
+                    "Position": 445.7359,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 23549,
-                    "Position": 432.0944
+                    "Position": 432.0944,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 23607,
-                    "Position": 415.796173
+                    "Position": 415.796173,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 23665,
-                    "Position": 407.897461
+                    "Position": 407.897461,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 23723,
-                    "Position": 409.462555
+                    "Position": 409.462555,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 23781,
-                    "Position": 406.53775
+                    "Position": 406.53775,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 23874,
-                    "Position": 408.720825
+                    "Position": 408.720825,
+                    "HyperDash": false
                 }
             ]
         }
diff --git a/osu.Game.Rulesets.Catch/Resources/Testing/Beatmaps/hardrock-repeat-slider-expected-conversion.json b/osu.Game.Rulesets.Catch/Resources/Testing/Beatmaps/hardrock-repeat-slider-expected-conversion.json
index 83f9e30800..081b574c5b 100644
--- a/osu.Game.Rulesets.Catch/Resources/Testing/Beatmaps/hardrock-repeat-slider-expected-conversion.json
+++ b/osu.Game.Rulesets.Catch/Resources/Testing/Beatmaps/hardrock-repeat-slider-expected-conversion.json
@@ -3,147 +3,183 @@
         "StartTime": 369,
         "Objects": [{
                 "StartTime": 369,
-                "Position": 177
+                "Position": 177,
+                "HyperDash": false
             },
             {
                 "StartTime": 450,
-                "Position": 216.539276
+                "Position": 216.539276,
+                "HyperDash": false
             },
             {
                 "StartTime": 532,
-                "Position": 256.5667
+                "Position": 256.5667,
+                "HyperDash": false
             },
             {
                 "StartTime": 614,
-                "Position": 296.594116
+                "Position": 296.594116,
+                "HyperDash": false
             },
             {
                 "StartTime": 696,
-                "Position": 336.621521
+                "Position": 336.621521,
+                "HyperDash": false
             },
             {
                 "StartTime": 778,
-                "Position": 376.99762
+                "Position": 376.99762,
+                "HyperDash": false
             },
             {
                 "StartTime": 860,
-                "Position": 337.318878
+                "Position": 337.318878,
+                "HyperDash": false
             },
             {
                 "StartTime": 942,
-                "Position": 297.291443
+                "Position": 297.291443,
+                "HyperDash": false
             },
             {
                 "StartTime": 1024,
-                "Position": 257.264038
+                "Position": 257.264038,
+                "HyperDash": false
             },
             {
                 "StartTime": 1106,
-                "Position": 217.2366
+                "Position": 217.2366,
+                "HyperDash": false
             },
             {
                 "StartTime": 1188,
-                "Position": 177
+                "Position": 177,
+                "HyperDash": false
             },
             {
                 "StartTime": 1270,
-                "Position": 216.818192
+                "Position": 216.818192,
+                "HyperDash": false
             },
             {
                 "StartTime": 1352,
-                "Position": 256.8456
+                "Position": 256.8456,
+                "HyperDash": false
             },
             {
                 "StartTime": 1434,
-                "Position": 296.873047
+                "Position": 296.873047,
+                "HyperDash": false
             },
             {
                 "StartTime": 1516,
-                "Position": 336.900452
+                "Position": 336.900452,
+                "HyperDash": false
             },
             {
                 "StartTime": 1598,
-                "Position": 376.99762
+                "Position": 376.99762,
+                "HyperDash": false
             },
             {
                 "StartTime": 1680,
-                "Position": 337.039948
+                "Position": 337.039948,
+                "HyperDash": false
             },
             {
                 "StartTime": 1762,
-                "Position": 297.0125
+                "Position": 297.0125,
+                "HyperDash": false
             },
             {
                 "StartTime": 1844,
-                "Position": 256.9851
+                "Position": 256.9851,
+                "HyperDash": false
             },
             {
                 "StartTime": 1926,
-                "Position": 216.957672
+                "Position": 216.957672,
+                "HyperDash": false
             },
             {
                 "StartTime": 2008,
-                "Position": 177
+                "Position": 177,
+                "HyperDash": false
             },
             {
                 "StartTime": 2090,
-                "Position": 217.097137
+                "Position": 217.097137,
+                "HyperDash": false
             },
             {
                 "StartTime": 2172,
-                "Position": 257.124573
+                "Position": 257.124573,
+                "HyperDash": false
             },
             {
                 "StartTime": 2254,
-                "Position": 297.152
+                "Position": 297.152,
+                "HyperDash": false
             },
             {
                 "StartTime": 2336,
-                "Position": 337.179443
+                "Position": 337.179443,
+                "HyperDash": false
             },
             {
                 "StartTime": 2418,
-                "Position": 376.99762
+                "Position": 376.99762,
+                "HyperDash": false
             },
             {
                 "StartTime": 2500,
-                "Position": 336.760956
+                "Position": 336.760956,
+                "HyperDash": false
             },
             {
                 "StartTime": 2582,
-                "Position": 296.733643
+                "Position": 296.733643,
+                "HyperDash": false
             },
             {
                 "StartTime": 2664,
-                "Position": 256.7062
+                "Position": 256.7062,
+                "HyperDash": false
             },
             {
                 "StartTime": 2746,
-                "Position": 216.678772
+                "Position": 216.678772,
+                "HyperDash": false
             },
             {
                 "StartTime": 2828,
-                "Position": 177
+                "Position": 177,
+                "HyperDash": false
             },
             {
                 "StartTime": 2909,
-                "Position": 216.887909
+                "Position": 216.887909,
+                "HyperDash": false
             },
             {
                 "StartTime": 2991,
-                "Position": 256.915344
+                "Position": 256.915344,
+                "HyperDash": false
             },
             {
                 "StartTime": 3073,
-                "Position": 296.942749
+                "Position": 296.942749,
+                "HyperDash": false
             },
             {
                 "StartTime": 3155,
-                "Position": 336.970184
+                "Position": 336.970184,
+                "HyperDash": false
             },
             {
                 "StartTime": 3237,
-                "Position": 376.99762
+                "Position": 376.99762,
+                "HyperDash": false
             }
         ]
     }]
diff --git a/osu.Game.Rulesets.Catch/Resources/Testing/Beatmaps/hardrock-spinner-expected-conversion.json b/osu.Game.Rulesets.Catch/Resources/Testing/Beatmaps/hardrock-spinner-expected-conversion.json
index 7333b600fb..01f474c149 100644
--- a/osu.Game.Rulesets.Catch/Resources/Testing/Beatmaps/hardrock-spinner-expected-conversion.json
+++ b/osu.Game.Rulesets.Catch/Resources/Testing/Beatmaps/hardrock-spinner-expected-conversion.json
@@ -3,71 +3,88 @@
         "StartTime": 369,
         "Objects": [{
                 "StartTime": 369,
-                "Position": 65
+                "Position": 65,
+                "HyperDash": false
             },
             {
                 "StartTime": 450,
-                "Position": 482
+                "Position": 482,
+                "HyperDash": false
             },
             {
                 "StartTime": 532,
-                "Position": 164
+                "Position": 164,
+                "HyperDash": false
             },
             {
                 "StartTime": 614,
-                "Position": 315
+                "Position": 315,
+                "HyperDash": false
             },
             {
                 "StartTime": 696,
-                "Position": 145
+                "Position": 145,
+                "HyperDash": false
             },
             {
                 "StartTime": 778,
-                "Position": 159
+                "Position": 159,
+                "HyperDash": false
             },
             {
                 "StartTime": 860,
-                "Position": 310
+                "Position": 310,
+                "HyperDash": false
             },
             {
                 "StartTime": 942,
-                "Position": 441
+                "Position": 441,
+                "HyperDash": false
             },
             {
                 "StartTime": 1024,
-                "Position": 428
+                "Position": 428,
+                "HyperDash": false
             },
             {
                 "StartTime": 1106,
-                "Position": 243
+                "Position": 243,
+                "HyperDash": false
             },
             {
                 "StartTime": 1188,
-                "Position": 422
+                "Position": 422,
+                "HyperDash": false
             },
             {
                 "StartTime": 1270,
-                "Position": 481
+                "Position": 481,
+                "HyperDash": false
             },
             {
                 "StartTime": 1352,
-                "Position": 104
+                "Position": 104,
+                "HyperDash": false
             },
             {
                 "StartTime": 1434,
-                "Position": 473
+                "Position": 473,
+                "HyperDash": false
             },
             {
                 "StartTime": 1516,
-                "Position": 135
+                "Position": 135,
+                "HyperDash": false
             },
             {
                 "StartTime": 1598,
-                "Position": 360
+                "Position": 360,
+                "HyperDash": false
             },
             {
                 "StartTime": 1680,
-                "Position": 123
+                "Position": 123,
+                "HyperDash": false
             }
         ]
     }]
diff --git a/osu.Game.Rulesets.Catch/Resources/Testing/Beatmaps/hardrock-stream-expected-conversion.json b/osu.Game.Rulesets.Catch/Resources/Testing/Beatmaps/hardrock-stream-expected-conversion.json
index bbc16ab912..8eaaf3bb90 100644
--- a/osu.Game.Rulesets.Catch/Resources/Testing/Beatmaps/hardrock-stream-expected-conversion.json
+++ b/osu.Game.Rulesets.Catch/Resources/Testing/Beatmaps/hardrock-stream-expected-conversion.json
@@ -3,231 +3,264 @@
             "StartTime": 369,
             "Objects": [{
                 "StartTime": 369,
-                "Position": 258
+                "Position": 258,
+                "HyperDash": false
             }]
         },
         {
             "StartTime": 450,
             "Objects": [{
                 "StartTime": 450,
-                "Position": 254
+                "Position": 254,
+                "HyperDash": false
             }]
         },
         {
             "StartTime": 532,
             "Objects": [{
                 "StartTime": 532,
-                "Position": 241
+                "Position": 241,
+                "HyperDash": false
             }]
         },
         {
             "StartTime": 614,
             "Objects": [{
                 "StartTime": 614,
-                "Position": 238
+                "Position": 238,
+                "HyperDash": false
             }]
         },
         {
             "StartTime": 696,
             "Objects": [{
                 "StartTime": 696,
-                "Position": 238
+                "Position": 238,
+                "HyperDash": false
             }]
         },
         {
             "StartTime": 778,
             "Objects": [{
                 "StartTime": 778,
-                "Position": 278
+                "Position": 278,
+                "HyperDash": false
             }]
         },
         {
             "StartTime": 860,
             "Objects": [{
                 "StartTime": 860,
-                "Position": 238
+                "Position": 238,
+                "HyperDash": false
             }]
         },
         {
             "StartTime": 942,
             "Objects": [{
                 "StartTime": 942,
-                "Position": 278
+                "Position": 278,
+                "HyperDash": false
             }]
         },
         {
             "StartTime": 1024,
             "Objects": [{
                 "StartTime": 1024,
-                "Position": 238
+                "Position": 238,
+                "HyperDash": false
             }]
         },
         {
             "StartTime": 1106,
             "Objects": [{
                 "StartTime": 1106,
-                "Position": 278
+                "Position": 278,
+                "HyperDash": false
             }]
         },
         {
             "StartTime": 1188,
             "Objects": [{
                 "StartTime": 1188,
-                "Position": 278
+                "Position": 278,
+                "HyperDash": false
             }]
         },
         {
             "StartTime": 1270,
             "Objects": [{
                 "StartTime": 1270,
-                "Position": 278
+                "Position": 278,
+                "HyperDash": false
             }]
         },
         {
             "StartTime": 1352,
             "Objects": [{
                 "StartTime": 1352,
-                "Position": 238
+                "Position": 238,
+                "HyperDash": false
             }]
         },
         {
             "StartTime": 1434,
             "Objects": [{
                 "StartTime": 1434,
-                "Position": 258
+                "Position": 258,
+                "HyperDash": false
             }]
         },
         {
             "StartTime": 1516,
             "Objects": [{
                 "StartTime": 1516,
-                "Position": 253
+                "Position": 253,
+                "HyperDash": false
             }]
         },
         {
             "StartTime": 1598,
             "Objects": [{
                 "StartTime": 1598,
-                "Position": 238
+                "Position": 238,
+                "HyperDash": false
             }]
         },
         {
             "StartTime": 1680,
             "Objects": [{
                 "StartTime": 1680,
-                "Position": 260
+                "Position": 260,
+                "HyperDash": false
             }]
         },
         {
             "StartTime": 1762,
             "Objects": [{
                 "StartTime": 1762,
-                "Position": 238
+                "Position": 238,
+                "HyperDash": false
             }]
         },
         {
             "StartTime": 1844,
             "Objects": [{
                 "StartTime": 1844,
-                "Position": 278
+                "Position": 278,
+                "HyperDash": false
             }]
         },
         {
             "StartTime": 1926,
             "Objects": [{
                 "StartTime": 1926,
-                "Position": 278
+                "Position": 278,
+                "HyperDash": false
             }]
         },
         {
             "StartTime": 2008,
             "Objects": [{
                 "StartTime": 2008,
-                "Position": 238
+                "Position": 238,
+                "HyperDash": false
             }]
         },
         {
             "StartTime": 2090,
             "Objects": [{
                 "StartTime": 2090,
-                "Position": 238
+                "Position": 238,
+                "HyperDash": false
             }]
         },
         {
             "StartTime": 2172,
             "Objects": [{
                 "StartTime": 2172,
-                "Position": 243
+                "Position": 243,
+                "HyperDash": false
             }]
         },
         {
             "StartTime": 2254,
             "Objects": [{
                 "StartTime": 2254,
-                "Position": 278
+                "Position": 278,
+                "HyperDash": false
             }]
         },
         {
             "StartTime": 2336,
             "Objects": [{
                 "StartTime": 2336,
-                "Position": 278
+                "Position": 278,
+                "HyperDash": false
             }]
         },
         {
             "StartTime": 2418,
             "Objects": [{
                 "StartTime": 2418,
-                "Position": 238
+                "Position": 238,
+                "HyperDash": false
             }]
         },
         {
             "StartTime": 2500,
             "Objects": [{
                 "StartTime": 2500,
-                "Position": 258
+                "Position": 258,
+                "HyperDash": false
             }]
         },
         {
             "StartTime": 2582,
             "Objects": [{
                 "StartTime": 2582,
-                "Position": 256
+                "Position": 256,
+                "HyperDash": false
             }]
         },
         {
             "StartTime": 2664,
             "Objects": [{
                 "StartTime": 2664,
-                "Position": 242
+                "Position": 242,
+                "HyperDash": false
             }]
         },
         {
             "StartTime": 2746,
             "Objects": [{
                 "StartTime": 2746,
-                "Position": 238
+                "Position": 238,
+                "HyperDash": false
             }]
         },
         {
             "StartTime": 2828,
             "Objects": [{
                 "StartTime": 2828,
-                "Position": 238
+                "Position": 238,
+                "HyperDash": false
             }]
         },
         {
             "StartTime": 2909,
             "Objects": [{
                 "StartTime": 2909,
-                "Position": 271
+                "Position": 271,
+                "HyperDash": false
             }]
         },
         {
             "StartTime": 2991,
             "Objects": [{
                 "StartTime": 2991,
-                "Position": 254
+                "Position": 254,
+                "HyperDash": false
             }]
         }
     ]
diff --git a/osu.Game.Rulesets.Catch/Resources/Testing/Beatmaps/right-bound-hr-offset-expected-conversion.json b/osu.Game.Rulesets.Catch/Resources/Testing/Beatmaps/right-bound-hr-offset-expected-conversion.json
index 3bde97070c..5060389ad8 100644
--- a/osu.Game.Rulesets.Catch/Resources/Testing/Beatmaps/right-bound-hr-offset-expected-conversion.json
+++ b/osu.Game.Rulesets.Catch/Resources/Testing/Beatmaps/right-bound-hr-offset-expected-conversion.json
@@ -3,14 +3,16 @@
             "StartTime": 3368,
             "Objects": [{
                 "StartTime": 3368,
-                "Position": 374
+                "Position": 374,
+                "HyperDash": false
             }]
         },
         {
             "StartTime": 3501,
             "Objects": [{
                 "StartTime": 3501,
-                "Position": 446
+                "Position": 446,
+                "HyperDash": false
             }]
         }
     ]
diff --git a/osu.Game.Rulesets.Catch/Resources/Testing/Beatmaps/slider-expected-conversion.json b/osu.Game.Rulesets.Catch/Resources/Testing/Beatmaps/slider-expected-conversion.json
index 58c52b6867..2378ba5511 100644
--- a/osu.Game.Rulesets.Catch/Resources/Testing/Beatmaps/slider-expected-conversion.json
+++ b/osu.Game.Rulesets.Catch/Resources/Testing/Beatmaps/slider-expected-conversion.json
@@ -1 +1,71 @@
-{"Mappings":[{"StartTime":19184.0,"Objects":[{"StartTime":19184.0,"Position":320.0},{"StartTime":19263.0,"Position":311.730255},{"StartTime":19343.0,"Position":324.6205},{"StartTime":19423.0,"Position":343.0907},{"StartTime":19503.0,"Position":372.2917},{"StartTime":19582.0,"Position":385.194733},{"StartTime":19662.0,"Position":379.0426},{"StartTime":19742.0,"Position":385.1066},{"StartTime":19822.0,"Position":391.624664},{"StartTime":19919.0,"Position":386.27832},{"StartTime":20016.0,"Position":380.117035},{"StartTime":20113.0,"Position":381.664154},{"StartTime":20247.0,"Position":370.872864}]}]}
\ No newline at end of file
+{
+    "Mappings": [{
+        "StartTime": 19184,
+        "Objects": [{
+                "StartTime": 19184,
+                "Position": 320,
+                "HyperDash": false
+            },
+            {
+                "StartTime": 19263,
+                "Position": 311.730255,
+                "HyperDash": false
+            },
+            {
+                "StartTime": 19343,
+                "Position": 324.6205,
+                "HyperDash": false
+            },
+            {
+                "StartTime": 19423,
+                "Position": 343.0907,
+                "HyperDash": false
+            },
+            {
+                "StartTime": 19503,
+                "Position": 372.2917,
+                "HyperDash": false
+            },
+            {
+                "StartTime": 19582,
+                "Position": 385.194733,
+                "HyperDash": false
+            },
+            {
+                "StartTime": 19662,
+                "Position": 379.0426,
+                "HyperDash": false
+            },
+            {
+                "StartTime": 19742,
+                "Position": 385.1066,
+                "HyperDash": false
+            },
+            {
+                "StartTime": 19822,
+                "Position": 391.624664,
+                "HyperDash": false
+            },
+            {
+                "StartTime": 19919,
+                "Position": 386.27832,
+                "HyperDash": false
+            },
+            {
+                "StartTime": 20016,
+                "Position": 380.117035,
+                "HyperDash": false
+            },
+            {
+                "StartTime": 20113,
+                "Position": 381.664154,
+                "HyperDash": false
+            },
+            {
+                "StartTime": 20247,
+                "Position": 370.872864,
+                "HyperDash": false
+            }
+        ]
+    }]
+}
\ No newline at end of file
diff --git a/osu.Game.Rulesets.Catch/Resources/Testing/Beatmaps/spinner-and-circles-expected-conversion.json b/osu.Game.Rulesets.Catch/Resources/Testing/Beatmaps/spinner-and-circles-expected-conversion.json
index dd81947f1c..abd5b2afd1 100644
--- a/osu.Game.Rulesets.Catch/Resources/Testing/Beatmaps/spinner-and-circles-expected-conversion.json
+++ b/osu.Game.Rulesets.Catch/Resources/Testing/Beatmaps/spinner-and-circles-expected-conversion.json
@@ -3,18 +3,21 @@
             "StartTime": 2589,
             "Objects": [{
                 "StartTime": 2589,
-                "Position": 256
+                "Position": 256,
+                "HyperDash": false
             }]
         },
         {
             "StartTime": 2915,
             "Objects": [{
                     "StartTime": 2915,
-                    "Position": 65
+                    "Position": 65,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 2916,
-                    "Position": 482
+                    "Position": 482,
+                    "HyperDash": false
                 }
             ]
         },
@@ -22,11 +25,13 @@
             "StartTime": 3078,
             "Objects": [{
                     "StartTime": 3078,
-                    "Position": 164
+                    "Position": 164,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 3079,
-                    "Position": 315
+                    "Position": 315,
+                    "HyperDash": false
                 }
             ]
         },
@@ -34,11 +39,13 @@
             "StartTime": 3241,
             "Objects": [{
                     "StartTime": 3241,
-                    "Position": 145
+                    "Position": 145,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 3242,
-                    "Position": 159
+                    "Position": 159,
+                    "HyperDash": false
                 }
             ]
         },
@@ -46,11 +53,13 @@
             "StartTime": 3404,
             "Objects": [{
                     "StartTime": 3404,
-                    "Position": 310
+                    "Position": 310,
+                    "HyperDash": false
                 },
                 {
                     "StartTime": 3405,
-                    "Position": 441
+                    "Position": 441,
+                    "HyperDash": false
                 }
             ]
         },
@@ -58,7 +67,8 @@
             "StartTime": 5197,
             "Objects": [{
                 "StartTime": 5197,
-                "Position": 256
+                "Position": 256,
+                "HyperDash": false
             }]
         }
     ]
diff --git a/osu.Game.Rulesets.Catch/Resources/Testing/Beatmaps/spinner-expected-conversion.json b/osu.Game.Rulesets.Catch/Resources/Testing/Beatmaps/spinner-expected-conversion.json
index b69b1ae056..8a7847e065 100644
--- a/osu.Game.Rulesets.Catch/Resources/Testing/Beatmaps/spinner-expected-conversion.json
+++ b/osu.Game.Rulesets.Catch/Resources/Testing/Beatmaps/spinner-expected-conversion.json
@@ -3,71 +3,88 @@
         "StartTime": 18500,
         "Objects": [{
                 "StartTime": 18500,
-                "Position": 65
+                "Position": 65,
+                "HyperDash": false
             },
             {
                 "StartTime": 18559,
-                "Position": 482
+                "Position": 482,
+                "HyperDash": false
             },
             {
                 "StartTime": 18618,
-                "Position": 164
+                "Position": 164,
+                "HyperDash": false
             },
             {
                 "StartTime": 18678,
-                "Position": 315
+                "Position": 315,
+                "HyperDash": false
             },
             {
                 "StartTime": 18737,
-                "Position": 145
+                "Position": 145,
+                "HyperDash": false
             },
             {
                 "StartTime": 18796,
-                "Position": 159
+                "Position": 159,
+                "HyperDash": false
             },
             {
                 "StartTime": 18856,
-                "Position": 310
+                "Position": 310,
+                "HyperDash": false
             },
             {
                 "StartTime": 18915,
-                "Position": 441
+                "Position": 441,
+                "HyperDash": false
             },
             {
                 "StartTime": 18975,
-                "Position": 428
+                "Position": 428,
+                "HyperDash": false
             },
             {
                 "StartTime": 19034,
-                "Position": 243
+                "Position": 243,
+                "HyperDash": false
             },
             {
                 "StartTime": 19093,
-                "Position": 422
+                "Position": 422,
+                "HyperDash": false
             },
             {
                 "StartTime": 19153,
-                "Position": 481
+                "Position": 481,
+                "HyperDash": false
             },
             {
                 "StartTime": 19212,
-                "Position": 104
+                "Position": 104,
+                "HyperDash": false
             },
             {
                 "StartTime": 19271,
-                "Position": 473
+                "Position": 473,
+                "HyperDash": false
             },
             {
                 "StartTime": 19331,
-                "Position": 135
+                "Position": 135,
+                "HyperDash": false
             },
             {
                 "StartTime": 19390,
-                "Position": 360
+                "Position": 360,
+                "HyperDash": false
             },
             {
                 "StartTime": 19450,
-                "Position": 123
+                "Position": 123,
+                "HyperDash": false
             }
         ]
     }]

From 8a81392d2babc053a12a96139282cad63cf9ffbe Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 16 Dec 2021 19:26:36 +0900
Subject: [PATCH 1697/5547] Fix use of incorrect variable, add test

---
 .../CatchBeatmapConversionTest.cs             |  3 ++-
 .../basic-hyperdash-expected-conversion.json  | 19 +++++++++++++++++
 .../Testing/Beatmaps/basic-hyperdash.osu      | 21 +++++++++++++++++++
 3 files changed, 42 insertions(+), 1 deletion(-)
 create mode 100644 osu.Game.Rulesets.Catch/Resources/Testing/Beatmaps/basic-hyperdash-expected-conversion.json
 create mode 100644 osu.Game.Rulesets.Catch/Resources/Testing/Beatmaps/basic-hyperdash.osu

diff --git a/osu.Game.Rulesets.Catch.Tests/CatchBeatmapConversionTest.cs b/osu.Game.Rulesets.Catch.Tests/CatchBeatmapConversionTest.cs
index 3352982c20..be1885cfa6 100644
--- a/osu.Game.Rulesets.Catch.Tests/CatchBeatmapConversionTest.cs
+++ b/osu.Game.Rulesets.Catch.Tests/CatchBeatmapConversionTest.cs
@@ -27,6 +27,7 @@ namespace osu.Game.Rulesets.Catch.Tests
         [TestCase("hardrock-repeat-slider", new[] { typeof(CatchModHardRock) })]
         [TestCase("hardrock-spinner", new[] { typeof(CatchModHardRock) })]
         [TestCase("right-bound-hr-offset", new[] { typeof(CatchModHardRock) })]
+        [TestCase("basic-hyperdash")]
         public new void Test(string name, params Type[] mods) => base.Test(name, mods);
 
         protected override IEnumerable<ConvertValue> CreateConvertValue(HitObject hitObject)
@@ -100,6 +101,6 @@ namespace osu.Game.Rulesets.Catch.Tests
         public bool Equals(ConvertValue other)
             => Precision.AlmostEquals(StartTime, other.StartTime, conversion_lenience)
                && Precision.AlmostEquals(Position, other.Position, conversion_lenience)
-               && HyperDash == other.hyperDash;
+               && HyperDash == other.HyperDash;
     }
 }
diff --git a/osu.Game.Rulesets.Catch/Resources/Testing/Beatmaps/basic-hyperdash-expected-conversion.json b/osu.Game.Rulesets.Catch/Resources/Testing/Beatmaps/basic-hyperdash-expected-conversion.json
new file mode 100644
index 0000000000..b2e9431f13
--- /dev/null
+++ b/osu.Game.Rulesets.Catch/Resources/Testing/Beatmaps/basic-hyperdash-expected-conversion.json
@@ -0,0 +1,19 @@
+{
+    "Mappings": [{
+            "StartTime": 369,
+            "Objects": [{
+                "StartTime": 369,
+                "Position": 0,
+                "HyperDash": true
+            }]
+        },
+        {
+            "StartTime": 450,
+            "Objects": [{
+                "StartTime": 450,
+                "Position": 512,
+                "HyperDash": false
+            }]
+        }
+    ]
+}
\ No newline at end of file
diff --git a/osu.Game.Rulesets.Catch/Resources/Testing/Beatmaps/basic-hyperdash.osu b/osu.Game.Rulesets.Catch/Resources/Testing/Beatmaps/basic-hyperdash.osu
new file mode 100644
index 0000000000..db07f8c30e
--- /dev/null
+++ b/osu.Game.Rulesets.Catch/Resources/Testing/Beatmaps/basic-hyperdash.osu
@@ -0,0 +1,21 @@
+osu file format v14
+
+[General]
+StackLeniency: 0.7
+Mode: 2
+
+[Difficulty]
+HPDrainRate:6
+CircleSize:4
+OverallDifficulty:9.6
+ApproachRate:9.6
+SliderMultiplier:1.9
+SliderTickRate:1
+
+[TimingPoints]
+2169,266.666666666667,4,2,1,70,1,0
+
+
+[HitObjects]
+0,192,369,1,0,0:0:0:0:
+512,192,450,1,0,0:0:0:0:

From c08b6cf16050b73abfa8b290aec93ad95503f863 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 16 Dec 2021 19:53:22 +0900
Subject: [PATCH 1698/5547] Remove unnecessary `StartAsync` call on
 `TcpIpcProvider`

---
 osu.Desktop/Program.cs | 1 -
 1 file changed, 1 deletion(-)

diff --git a/osu.Desktop/Program.cs b/osu.Desktop/Program.cs
index a9e3575a49..7ec7d53a7e 100644
--- a/osu.Desktop/Program.cs
+++ b/osu.Desktop/Program.cs
@@ -90,7 +90,6 @@ namespace osu.Desktop
                         Logger.Log("Starting legacy IPC provider...");
                         legacyIpc = new LegacyTcpIpcProvider();
                         legacyIpc.Bind();
-                        legacyIpc.StartAsync();
                     }
                     catch (Exception ex)
                     {

From abb617a3df76c0ed685f9b84ae4abd4b3ea8be79 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 16 Dec 2021 19:57:24 +0900
Subject: [PATCH 1699/5547] Avoid blocking `Active` state propagation

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

diff --git a/osu.Game.Rulesets.Osu/OsuInputManager.cs b/osu.Game.Rulesets.Osu/OsuInputManager.cs
index f5fc3de381..5c6b907e42 100644
--- a/osu.Game.Rulesets.Osu/OsuInputManager.cs
+++ b/osu.Game.Rulesets.Osu/OsuInputManager.cs
@@ -3,6 +3,7 @@
 
 using System.Collections.Generic;
 using System.ComponentModel;
+using osu.Framework.Input;
 using osu.Framework.Input.Bindings;
 using osu.Framework.Input.Events;
 using osu.Framework.Input.StateChanges.Events;
@@ -44,8 +45,10 @@ namespace osu.Game.Rulesets.Osu
         {
             if (!AllowUserCursorMovement)
             {
-                // Still allow for forwarding of the "touch" part, but block the positional data.
-                e = new TouchStateChangeEvent(e.State, e.Input, e.Touch, false, null);
+                // Still allow for forwarding of the "touch" part, but replace the positional data with that of the mouse.
+                // Primarily relied upon by the "autopilot" osu! mod.
+                var touch = new Touch(e.Touch.Source, CurrentState.Mouse.Position);
+                e = new TouchStateChangeEvent(e.State, e.Input, touch, e.IsActive, null);
             }
 
             return base.HandleMouseTouchStateChange(e);

From eecb1ce9f55084d19eea03378b9cf6c34cfe9706 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 16 Dec 2021 20:20:02 +0900
Subject: [PATCH 1700/5547] Avoid applying mouse down effects to menu cursor
 when it isn't visible

Closes #16114.
---
 osu.Game/Graphics/Cursor/MenuCursor.cs | 25 ++++++++++++++-----------
 1 file changed, 14 insertions(+), 11 deletions(-)

diff --git a/osu.Game/Graphics/Cursor/MenuCursor.cs b/osu.Game/Graphics/Cursor/MenuCursor.cs
index 3fa90e2330..8e272f637f 100644
--- a/osu.Game/Graphics/Cursor/MenuCursor.cs
+++ b/osu.Game/Graphics/Cursor/MenuCursor.cs
@@ -72,18 +72,21 @@ namespace osu.Game.Graphics.Cursor
 
         protected override bool OnMouseDown(MouseDownEvent e)
         {
-            // only trigger animation for main mouse buttons
-            activeCursor.Scale = new Vector2(1);
-            activeCursor.ScaleTo(0.90f, 800, Easing.OutQuint);
-
-            activeCursor.AdditiveLayer.Alpha = 0;
-            activeCursor.AdditiveLayer.FadeInFromZero(800, Easing.OutQuint);
-
-            if (cursorRotate.Value && dragRotationState != DragRotationState.Rotating)
+            if (State.Value == Visibility.Visible)
             {
-                // if cursor is already rotating don't reset its rotate origin
-                dragRotationState = DragRotationState.DragStarted;
-                positionMouseDown = e.MousePosition;
+                // only trigger animation for main mouse buttons
+                activeCursor.Scale = new Vector2(1);
+                activeCursor.ScaleTo(0.90f, 800, Easing.OutQuint);
+
+                activeCursor.AdditiveLayer.Alpha = 0;
+                activeCursor.AdditiveLayer.FadeInFromZero(800, Easing.OutQuint);
+
+                if (cursorRotate.Value && dragRotationState != DragRotationState.Rotating)
+                {
+                    // if cursor is already rotating don't reset its rotate origin
+                    dragRotationState = DragRotationState.DragStarted;
+                    positionMouseDown = e.MousePosition;
+                }
             }
 
             return base.OnMouseDown(e);

From 6bfe973fe5a17a75186ff8e2dad30f3d2d5dac26 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 17 Dec 2021 13:44:52 +0900
Subject: [PATCH 1701/5547] Update framework

---
 osu.Android.props        | 2 +-
 osu.Game/osu.Game.csproj | 2 +-
 osu.iOS.props            | 4 ++--
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Android.props b/osu.Android.props
index 1131203a95..563836d29b 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -52,7 +52,7 @@
   </ItemGroup>
   <ItemGroup>
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1215.0" />
-    <PackageReference Include="ppy.osu.Framework.Android" Version="2021.1215.0" />
+    <PackageReference Include="ppy.osu.Framework.Android" Version="2021.1217.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
     <!-- Realm needs to be directly referenced in all Xamarin projects, as it will not pull in its transitive dependencies otherwise. -->
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index feae990df7..0e8486cabc 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="10.7.1" />
-    <PackageReference Include="ppy.osu.Framework" Version="2021.1215.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2021.1217.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1215.0" />
     <PackageReference Include="Sentry" Version="3.12.1" />
     <PackageReference Include="SharpCompress" Version="0.30.1" />
diff --git a/osu.iOS.props b/osu.iOS.props
index 27ac1bf647..42d8962c14 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -60,7 +60,7 @@
     <Reference Include="System.Net.Http" />
   </ItemGroup>
   <ItemGroup Label="Package References">
-    <PackageReference Include="ppy.osu.Framework.iOS" Version="2021.1215.0" />
+    <PackageReference Include="ppy.osu.Framework.iOS" Version="2021.1217.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1215.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net5.0 / net6.0) -->
@@ -83,7 +83,7 @@
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="2.2.6" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.Core" Version="2.2.6" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
-    <PackageReference Include="ppy.osu.Framework" Version="2021.1215.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2021.1217.0" />
     <PackageReference Include="SharpCompress" Version="0.30.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
     <PackageReference Include="SharpRaven" Version="2.4.0" />

From 81603a064529d8356a0c3fff86ad603ae7c6e032 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 17 Dec 2021 19:32:58 +0900
Subject: [PATCH 1702/5547] Update framework

---
 osu.Android.props        | 2 +-
 osu.Game/osu.Game.csproj | 2 +-
 osu.iOS.props            | 4 ++--
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Android.props b/osu.Android.props
index 563836d29b..209b8cd63e 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -52,7 +52,7 @@
   </ItemGroup>
   <ItemGroup>
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1215.0" />
-    <PackageReference Include="ppy.osu.Framework.Android" Version="2021.1217.0" />
+    <PackageReference Include="ppy.osu.Framework.Android" Version="2021.1217.1" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
     <!-- Realm needs to be directly referenced in all Xamarin projects, as it will not pull in its transitive dependencies otherwise. -->
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 0e8486cabc..97bdf00f69 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="10.7.1" />
-    <PackageReference Include="ppy.osu.Framework" Version="2021.1217.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2021.1217.1" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1215.0" />
     <PackageReference Include="Sentry" Version="3.12.1" />
     <PackageReference Include="SharpCompress" Version="0.30.1" />
diff --git a/osu.iOS.props b/osu.iOS.props
index 42d8962c14..d4b7339900 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -60,7 +60,7 @@
     <Reference Include="System.Net.Http" />
   </ItemGroup>
   <ItemGroup Label="Package References">
-    <PackageReference Include="ppy.osu.Framework.iOS" Version="2021.1217.0" />
+    <PackageReference Include="ppy.osu.Framework.iOS" Version="2021.1217.1" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1215.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net5.0 / net6.0) -->
@@ -83,7 +83,7 @@
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="2.2.6" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.Core" Version="2.2.6" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
-    <PackageReference Include="ppy.osu.Framework" Version="2021.1217.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2021.1217.1" />
     <PackageReference Include="SharpCompress" Version="0.30.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
     <PackageReference Include="SharpRaven" Version="2.4.0" />

From 883fcf26044bef614e4d6d08d9e4719acb537ea9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 17 Dec 2021 11:44:36 +0100
Subject: [PATCH 1703/5547] Fix tests

---
 .../Visual/Beatmaps/TestSceneBeatmapCard.cs   | 20 ++++++-------------
 1 file changed, 6 insertions(+), 14 deletions(-)

diff --git a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs
index 55dbf89334..2b98c61e9b 100644
--- a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs
+++ b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs
@@ -255,6 +255,12 @@ namespace osu.Game.Tests.Visual.Beatmaps
             createTestCase(beatmapSetInfo => new BeatmapCard(beatmapSetInfo));
         }
 
+        [Test]
+        public void TestExtra()
+        {
+            createTestCase(beatmapSetInfo => new BeatmapCardExtra(beatmapSetInfo));
+        }
+
         [Test]
         public void TestHoverState()
         {
@@ -280,19 +286,5 @@ namespace osu.Game.Tests.Visual.Beatmaps
 
             BeatmapCard firstCard() => this.ChildrenOfType<BeatmapCard>().First();
         }
-
-        [Test]
-        public void TestExtra()
-        {
-            createTestCase(beatmapSetInfo => new BeatmapCardExtra(beatmapSetInfo));
-
-            AddToggleStep("toggle expanded state", expanded =>
-            {
-                var card = this.ChildrenOfType<BeatmapCardExtra>().Last();
-                if (!card.Expanded.Disabled)
-                    card.Expanded.Value = expanded;
-            });
-            AddToggleStep("disable/enable expansion", disabled => this.ChildrenOfType<BeatmapCardExtra>().ForEach(card => card.Expanded.Disabled = disabled));
-        }
     }
 }

From 3fa45479b0cc3c5d0dbd9e024f22cf5b954d29a6 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 17 Dec 2021 11:13:07 +0100
Subject: [PATCH 1704/5547] Share hype/nomination statistic show logic

---
 osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs     | 12 ++++++------
 .../Beatmaps/Drawables/Cards/BeatmapCardExtra.cs     | 12 ++++++------
 .../Drawables/Cards/Statistics/HypesStatistic.cs     |  7 ++++++-
 .../Cards/Statistics/NominationsStatistic.cs         |  9 ++++++++-
 4 files changed, 26 insertions(+), 14 deletions(-)

diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
index 1e24501426..14c29f8e99 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
@@ -380,13 +380,13 @@ namespace osu.Game.Beatmaps.Drawables.Cards
 
         private IEnumerable<BeatmapCardStatistic> createStatistics()
         {
-            if (beatmapSet.HypeStatus != null)
-                yield return new HypesStatistic(beatmapSet.HypeStatus);
+            var hypesStatistic = HypesStatistic.CreateFor(beatmapSet);
+            if (hypesStatistic != null)
+                yield return hypesStatistic;
 
-            // web does not show nominations unless hypes are also present.
-            // see: https://github.com/ppy/osu-web/blob/8ed7d071fd1d3eaa7e43cf0e4ff55ca2fef9c07c/resources/assets/lib/beatmapset-panel.tsx#L443
-            if (beatmapSet.HypeStatus != null && beatmapSet.NominationStatus != null)
-                yield return new NominationsStatistic(beatmapSet.NominationStatus);
+            var nominationsStatistic = NominationsStatistic.CreateFor(beatmapSet);
+            if (nominationsStatistic != null)
+                yield return nominationsStatistic;
 
             yield return new FavouritesStatistic(beatmapSet) { Current = favouriteState };
             yield return new PlayCountStatistic(beatmapSet);
diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtra.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtra.cs
index 8d3c606d76..2ccc732119 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtra.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtra.cs
@@ -409,13 +409,13 @@ namespace osu.Game.Beatmaps.Drawables.Cards
 
             statisticsContainer.Content[1][0] = withMargin(new PlayCountStatistic(beatmapSet));
 
-            if (beatmapSet.HypeStatus != null)
-                statisticsContainer.Content[0][1] = withMargin(new HypesStatistic(beatmapSet.HypeStatus));
+            var hypesStatistic = HypesStatistic.CreateFor(beatmapSet);
+            if (hypesStatistic != null)
+                statisticsContainer.Content[0][1] = withMargin(hypesStatistic);
 
-            // web does not show nominations unless hypes are also present.
-            // see: https://github.com/ppy/osu-web/blob/8ed7d071fd1d3eaa7e43cf0e4ff55ca2fef9c07c/resources/assets/lib/beatmapset-panel.tsx#L443
-            if (beatmapSet.HypeStatus != null && beatmapSet.NominationStatus != null)
-                statisticsContainer.Content[1][1] = withMargin(new NominationsStatistic(beatmapSet.NominationStatus));
+            var nominationsStatistic = NominationsStatistic.CreateFor(beatmapSet);
+            if (nominationsStatistic != null)
+                statisticsContainer.Content[1][1] = withMargin(nominationsStatistic);
 
             var dateStatistic = BeatmapCardDateStatistic.CreateFor(beatmapSet);
             if (dateStatistic != null)
diff --git a/osu.Game/Beatmaps/Drawables/Cards/Statistics/HypesStatistic.cs b/osu.Game/Beatmaps/Drawables/Cards/Statistics/HypesStatistic.cs
index 3fe31c7a41..521d1a5f21 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/Statistics/HypesStatistic.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/Statistics/HypesStatistic.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.
 
+#nullable enable
+
 using osu.Framework.Extensions.LocalisationExtensions;
 using osu.Framework.Graphics.Sprites;
 using osu.Game.Resources.Localisation.Web;
@@ -12,11 +14,14 @@ namespace osu.Game.Beatmaps.Drawables.Cards.Statistics
     /// </summary>
     public class HypesStatistic : BeatmapCardStatistic
     {
-        public HypesStatistic(BeatmapSetHypeStatus hypeStatus)
+        private HypesStatistic(BeatmapSetHypeStatus hypeStatus)
         {
             Icon = FontAwesome.Solid.Bullhorn;
             Text = hypeStatus.Current.ToLocalisableString();
             TooltipText = BeatmapsStrings.HypeRequiredText(hypeStatus.Current.ToLocalisableString(), hypeStatus.Required.ToLocalisableString());
         }
+
+        public static HypesStatistic? CreateFor(IBeatmapSetOnlineInfo beatmapSetOnlineInfo)
+            => beatmapSetOnlineInfo.HypeStatus == null ? null : new HypesStatistic(beatmapSetOnlineInfo.HypeStatus);
     }
 }
diff --git a/osu.Game/Beatmaps/Drawables/Cards/Statistics/NominationsStatistic.cs b/osu.Game/Beatmaps/Drawables/Cards/Statistics/NominationsStatistic.cs
index f09269a615..23bd6ef0a9 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/Statistics/NominationsStatistic.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/Statistics/NominationsStatistic.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.
 
+#nullable enable
+
 using osu.Framework.Extensions.LocalisationExtensions;
 using osu.Framework.Graphics.Sprites;
 using osu.Game.Resources.Localisation.Web;
@@ -12,11 +14,16 @@ namespace osu.Game.Beatmaps.Drawables.Cards.Statistics
     /// </summary>
     public class NominationsStatistic : BeatmapCardStatistic
     {
-        public NominationsStatistic(BeatmapSetNominationStatus nominationStatus)
+        private NominationsStatistic(BeatmapSetNominationStatus nominationStatus)
         {
             Icon = FontAwesome.Solid.ThumbsUp;
             Text = nominationStatus.Current.ToLocalisableString();
             TooltipText = BeatmapsStrings.NominationsRequiredText(nominationStatus.Current.ToLocalisableString(), nominationStatus.Required.ToLocalisableString());
         }
+
+        public static NominationsStatistic? CreateFor(IBeatmapSetOnlineInfo beatmapSetOnlineInfo)
+            // web does not show nominations unless hypes are also present.
+            // see: https://github.com/ppy/osu-web/blob/8ed7d071fd1d3eaa7e43cf0e4ff55ca2fef9c07c/resources/assets/lib/beatmapset-panel.tsx#L443
+            => beatmapSetOnlineInfo.HypeStatus == null || beatmapSetOnlineInfo.NominationStatus == null ? null : new NominationsStatistic(beatmapSetOnlineInfo.NominationStatus);
     }
 }

From 7aab12d4b061d6621e5c3b5e5bc36be8a75e8c06 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 17 Dec 2021 11:27:38 +0100
Subject: [PATCH 1705/5547] Share extra row dropdown show/cancel show logic

---
 .../Beatmaps/Drawables/Cards/BeatmapCard.cs   | 38 +++++++------------
 .../Drawables/Cards/BeatmapCardExtra.cs       | 38 +++++++------------
 .../Cards/BeatmapCardExtraInfoRow.cs          | 25 +++++++++++-
 3 files changed, 49 insertions(+), 52 deletions(-)

diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
index 14c29f8e99..4892abc846 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
@@ -44,7 +44,8 @@ namespace osu.Game.Beatmaps.Drawables.Cards
 
         private readonly BeatmapDownloadTracker downloadTracker;
 
-        private BeatmapCardContent content = null!;
+        [Cached]
+        private readonly BeatmapCardContent content;
 
         private BeatmapCardThumbnail thumbnail = null!;
 
@@ -72,6 +73,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
             this.beatmapSet = beatmapSet;
             favouriteState = new Bindable<BeatmapSetFavouriteState>(new BeatmapSetFavouriteState(beatmapSet.HasFavourited, beatmapSet.FavouriteCount));
             downloadTracker = new BeatmapDownloadTracker(beatmapSet);
+            content = new BeatmapCardContent(height);
         }
 
         [BackgroundDependencyLoader(true)]
@@ -80,13 +82,13 @@ namespace osu.Game.Beatmaps.Drawables.Cards
             Width = width;
             Height = height;
 
-            FillFlowContainer leftIconArea;
-            GridContainer titleContainer;
-            GridContainer artistContainer;
+            FillFlowContainer leftIconArea = null!;
+            GridContainer titleContainer = null!;
+            GridContainer artistContainer = null!;
 
-            InternalChild = content = new BeatmapCardContent(height)
+            InternalChild = content.With(c =>
             {
-                MainContent = new Container
+                c.MainContent = new Container
                 {
                     RelativeSizeAxes = Axes.Both,
                     Children = new Drawable[]
@@ -281,20 +283,6 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                                                     ChildrenEnumerable = createStatistics()
                                                 },
                                                 new BeatmapCardExtraInfoRow(beatmapSet)
-                                                {
-                                                    Hovered = _ =>
-                                                    {
-                                                        content.ExpandAfterDelay();
-                                                        return false;
-                                                    },
-                                                    Unhovered = _ =>
-                                                    {
-                                                        // Handles the case where a user has not shown explicit intent to view expanded info.
-                                                        // ie. quickly moved over the info row area but didn't remain within it.
-                                                        if (!Expanded.Value)
-                                                            content.CancelExpand();
-                                                    }
-                                                }
                                             }
                                         },
                                         downloadProgressBar = new BeatmapCardDownloadProgressBar
@@ -311,16 +299,16 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                             }
                         }
                     }
-                },
-                ExpandedContent = new Container
+                };
+                c.ExpandedContent = new Container
                 {
                     RelativeSizeAxes = Axes.X,
                     AutoSizeAxes = Axes.Y,
                     Padding = new MarginPadding { Horizontal = 10, Vertical = 13 },
                     Child = new BeatmapCardDifficultyList(beatmapSet)
-                },
-                Expanded = { BindTarget = Expanded }
-            };
+                };
+                c.Expanded.BindTarget = Expanded;
+            });
 
             if (beatmapSet.HasVideo)
                 leftIconArea.Add(new IconPill(FontAwesome.Solid.Film) { IconSize = new Vector2(20) });
diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtra.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtra.cs
index 2ccc732119..328294a323 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtra.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtra.cs
@@ -40,7 +40,8 @@ namespace osu.Game.Beatmaps.Drawables.Cards
 
         private readonly BeatmapDownloadTracker downloadTracker;
 
-        private BeatmapCardContent content = null!;
+        [Cached]
+        private readonly BeatmapCardContent content;
 
         private BeatmapCardThumbnail thumbnail = null!;
 
@@ -66,6 +67,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
             this.beatmapSet = beatmapSet;
             favouriteState = new Bindable<BeatmapSetFavouriteState>(new BeatmapSetFavouriteState(beatmapSet.HasFavourited, beatmapSet.FavouriteCount));
             downloadTracker = new BeatmapDownloadTracker(beatmapSet);
+            content = new BeatmapCardContent(height);
         }
 
         [BackgroundDependencyLoader(true)]
@@ -74,13 +76,13 @@ namespace osu.Game.Beatmaps.Drawables.Cards
             Width = width;
             Height = height;
 
-            FillFlowContainer leftIconArea;
-            GridContainer titleContainer;
-            GridContainer artistContainer;
+            FillFlowContainer leftIconArea = null!;
+            GridContainer titleContainer = null!;
+            GridContainer artistContainer = null!;
 
-            InternalChild = content = new BeatmapCardContent(height)
+            InternalChild = content.With(c =>
             {
-                MainContent = new Container
+                c.MainContent = new Container
                 {
                     RelativeSizeAxes = Axes.Both,
                     Children = new Drawable[]
@@ -295,20 +297,6 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                                                     }
                                                 },
                                                 new BeatmapCardExtraInfoRow(beatmapSet)
-                                                {
-                                                    Hovered = _ =>
-                                                    {
-                                                        content.ExpandAfterDelay();
-                                                        return false;
-                                                    },
-                                                    Unhovered = _ =>
-                                                    {
-                                                        // This hide should only trigger if the expanded content has not shown yet.
-                                                        // ie. if the user has not shown intent to want to see it (quickly moved over the info row area).
-                                                        if (!Expanded.Value)
-                                                            content.CancelExpand();
-                                                    }
-                                                }
                                             }
                                         },
                                         downloadProgressBar = new BeatmapCardDownloadProgressBar
@@ -325,16 +313,16 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                             }
                         }
                     }
-                },
-                ExpandedContent = new Container
+                };
+                c.ExpandedContent = new Container
                 {
                     RelativeSizeAxes = Axes.X,
                     AutoSizeAxes = Axes.Y,
                     Padding = new MarginPadding { Horizontal = 10, Vertical = 13 },
                     Child = new BeatmapCardDifficultyList(beatmapSet)
-                },
-                Expanded = { BindTarget = Expanded }
-            };
+                };
+                c.Expanded.BindTarget = Expanded;
+            });
 
             if (beatmapSet.HasVideo)
                 leftIconArea.Add(new IconPill(FontAwesome.Solid.Film) { IconSize = new Vector2(20) });
diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtraInfoRow.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtraInfoRow.cs
index 0a9d98e621..2d411ad344 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtraInfoRow.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtraInfoRow.cs
@@ -1,21 +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.
 
+#nullable enable
+
+using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
+using osu.Framework.Input.Events;
 using osu.Game.Online.API.Requests.Responses;
 using osuTK;
 
 namespace osu.Game.Beatmaps.Drawables.Cards
 {
-    public class BeatmapCardExtraInfoRow : HoverHandlingContainer
+    public class BeatmapCardExtraInfoRow : CompositeDrawable
     {
+        [Resolved(CanBeNull = true)]
+        private BeatmapCardContent? content { get; set; }
+
         public BeatmapCardExtraInfoRow(APIBeatmapSet beatmapSet)
         {
             RelativeSizeAxes = Axes.X;
             AutoSizeAxes = Axes.Y;
 
-            Child = new FillFlowContainer
+            InternalChild = new FillFlowContainer
             {
                 RelativeSizeAxes = Axes.X,
                 AutoSizeAxes = Axes.Y,
@@ -39,5 +46,19 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                 }
             };
         }
+
+        protected override bool OnHover(HoverEvent e)
+        {
+            content?.ExpandAfterDelay();
+            return base.OnHover(e);
+        }
+
+        protected override void OnHoverLost(HoverLostEvent e)
+        {
+            if (content?.Expanded.Value == false)
+                content.CancelExpand();
+
+            base.OnHoverLost(e);
+        }
     }
 }

From f052b47d873cbe41277295a6ac75525a72fe996e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 17 Dec 2021 12:58:05 +0100
Subject: [PATCH 1706/5547] Extract collapsible button container for card usage

---
 .../Beatmaps/Drawables/Cards/BeatmapCard.cs   | 104 +---------
 .../Drawables/Cards/BeatmapCardExtra.cs       | 104 +---------
 .../Cards/CollapsibleButtonContainer.cs       | 184 ++++++++++++++++++
 3 files changed, 200 insertions(+), 192 deletions(-)
 create mode 100644 osu.Game/Beatmaps/Drawables/Cards/CollapsibleButtonContainer.cs

diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
index 4892abc846..13c4cfe207 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
@@ -8,11 +8,9 @@ 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.Graphics.Sprites;
 using osu.Framework.Input.Events;
 using osu.Framework.Localisation;
-using osu.Game.Beatmaps.Drawables.Cards.Buttons;
 using osu.Game.Beatmaps.Drawables.Cards.Statistics;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
@@ -24,7 +22,6 @@ using osu.Game.Overlays;
 using osu.Game.Overlays.BeatmapSet;
 using osuTK;
 using osu.Game.Resources.Localisation.Web;
-using DownloadButton = osu.Game.Beatmaps.Drawables.Cards.Buttons.DownloadButton;
 
 namespace osu.Game.Beatmaps.Drawables.Cards
 {
@@ -37,7 +34,6 @@ namespace osu.Game.Beatmaps.Drawables.Cards
 
         private const float width = 408;
         private const float height = 100;
-        private const float icon_area_width = 30;
 
         private readonly APIBeatmapSet beatmapSet;
         private readonly Bindable<BeatmapSetFavouriteState> favouriteState;
@@ -48,20 +44,13 @@ namespace osu.Game.Beatmaps.Drawables.Cards
         private readonly BeatmapCardContent content;
 
         private BeatmapCardThumbnail thumbnail = null!;
+        private CollapsibleButtonContainer buttonContainer = null!;
 
-        private Container rightAreaBackground = null!;
-        private Container<BeatmapCardIconButton> rightAreaButtons = null!;
-
-        private Container mainContent = null!;
-        private BeatmapCardContentBackground mainContentBackground = null!;
         private FillFlowContainer<BeatmapCardStatistic> statisticsContainer = null!;
 
         private FillFlowContainer idleBottomContent = null!;
         private BeatmapCardDownloadProgressBar downloadProgressBar = null!;
 
-        [Resolved]
-        private OsuColour colours { get; set; } = null!;
-
         [Resolved]
         private OverlayColourProvider colourProvider { get; set; } = null!;
 
@@ -94,21 +83,6 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                     Children = new Drawable[]
                     {
                         downloadTracker,
-                        rightAreaBackground = new Container
-                        {
-                            RelativeSizeAxes = Axes.Y,
-                            Width = icon_area_width + 2 * CORNER_RADIUS,
-                            Anchor = Anchor.CentreRight,
-                            Origin = Anchor.CentreRight,
-                            // workaround for masking artifacts at the top & bottom of card,
-                            // which become especially visible on downloaded beatmaps (when the icon area has a lime background).
-                            Padding = new MarginPadding { Vertical = 1 },
-                            Child = new Box
-                            {
-                                RelativeSizeAxes = Axes.Both,
-                                Colour = Colour4.White
-                            },
-                        },
                         thumbnail = new BeatmapCardThumbnail(beatmapSet)
                         {
                             Name = @"Left (icon) area",
@@ -122,61 +96,19 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                                 Spacing = new Vector2(1)
                             }
                         },
-                        new Container
+                        buttonContainer = new CollapsibleButtonContainer(beatmapSet)
                         {
-                            Name = @"Right (button) area",
-                            Width = 30,
-                            RelativeSizeAxes = Axes.Y,
-                            Origin = Anchor.TopRight,
-                            Anchor = Anchor.TopRight,
-                            Padding = new MarginPadding { Vertical = 17.5f },
-                            Child = rightAreaButtons = new Container<BeatmapCardIconButton>
-                            {
-                                RelativeSizeAxes = Axes.Both,
-                                Children = new BeatmapCardIconButton[]
-                                {
-                                    new FavouriteButton(beatmapSet)
-                                    {
-                                        Current = favouriteState,
-                                        Anchor = Anchor.TopCentre,
-                                        Origin = Anchor.TopCentre
-                                    },
-                                    new DownloadButton(beatmapSet)
-                                    {
-                                        Anchor = Anchor.BottomCentre,
-                                        Origin = Anchor.BottomCentre,
-                                        State = { BindTarget = downloadTracker.State }
-                                    },
-                                    new GoToBeatmapButton(beatmapSet)
-                                    {
-                                        Anchor = Anchor.BottomCentre,
-                                        Origin = Anchor.BottomCentre,
-                                        State = { BindTarget = downloadTracker.State }
-                                    }
-                                }
-                            }
-                        },
-                        mainContent = new Container
-                        {
-                            Name = @"Main content",
                             X = height - CORNER_RADIUS,
-                            Height = height,
-                            CornerRadius = CORNER_RADIUS,
-                            Masking = true,
+                            Width = width - height + CORNER_RADIUS,
+                            FavouriteState = { BindTarget = favouriteState },
+                            ButtonsCollapsedWidth = CORNER_RADIUS,
+                            ButtonsExpandedWidth = 30,
+                            ButtonsPadding = new MarginPadding { Vertical = 17.5f },
                             Children = new Drawable[]
                             {
-                                mainContentBackground = new BeatmapCardContentBackground(beatmapSet)
-                                {
-                                    RelativeSizeAxes = Axes.Both,
-                                },
                                 new FillFlowContainer
                                 {
                                     RelativeSizeAxes = Axes.Both,
-                                    Padding = new MarginPadding
-                                    {
-                                        Horizontal = 10,
-                                        Vertical = 4
-                                    },
                                     Direction = FillDirection.Vertical,
                                     Children = new Drawable[]
                                     {
@@ -256,11 +188,6 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                                     AutoSizeAxes = Axes.Y,
                                     Anchor = Anchor.BottomLeft,
                                     Origin = Anchor.BottomLeft,
-                                    Padding = new MarginPadding
-                                    {
-                                        Horizontal = 10,
-                                        Vertical = 4
-                                    },
                                     Children = new Drawable[]
                                     {
                                         idleBottomContent = new FillFlowContainer
@@ -388,30 +315,15 @@ namespace osu.Game.Beatmaps.Drawables.Cards
         {
             bool showDetails = IsHovered || Expanded.Value;
 
-            float targetWidth = width - height;
-            if (showDetails)
-                targetWidth = targetWidth - icon_area_width + CORNER_RADIUS;
-
+            buttonContainer.ShowDetails.Value = showDetails;
             thumbnail.Dimmed.Value = showDetails;
 
             // Scale value is intentionally chosen to fit in the spacing of listing displays, as to not overlap horizontally with adjacent cards.
             // This avoids depth issues where a hovered (scaled) card to the right of another card would be beneath the card to the left.
             content.ScaleTo(Expanded.Value ? 1.03f : 1, 500, Easing.OutQuint);
 
-            mainContent.ResizeWidthTo(targetWidth, TRANSITION_DURATION, Easing.OutQuint);
-            mainContentBackground.Dimmed.Value = showDetails;
-
             statisticsContainer.FadeTo(showDetails ? 1 : 0, TRANSITION_DURATION, Easing.OutQuint);
 
-            rightAreaBackground.FadeColour(downloadTracker.State.Value == DownloadState.LocallyAvailable ? colours.Lime0 : colourProvider.Background3, TRANSITION_DURATION, Easing.OutQuint);
-            rightAreaButtons.FadeTo(showDetails ? 1 : 0, TRANSITION_DURATION, Easing.OutQuint);
-
-            foreach (var button in rightAreaButtons)
-            {
-                button.IdleColour = downloadTracker.State.Value != DownloadState.LocallyAvailable ? colourProvider.Light1 : colourProvider.Background3;
-                button.HoverColour = downloadTracker.State.Value != DownloadState.LocallyAvailable ? colourProvider.Content1 : colourProvider.Foreground1;
-            }
-
             bool showProgress = downloadTracker.State.Value == DownloadState.Downloading || downloadTracker.State.Value == DownloadState.Importing;
 
             idleBottomContent.FadeTo(showProgress ? 0 : 1, TRANSITION_DURATION, Easing.OutQuint);
diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtra.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtra.cs
index 328294a323..fb498d643a 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtra.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtra.cs
@@ -7,11 +7,9 @@ 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.Graphics.Sprites;
 using osu.Framework.Input.Events;
 using osu.Framework.Localisation;
-using osu.Game.Beatmaps.Drawables.Cards.Buttons;
 using osu.Game.Beatmaps.Drawables.Cards.Statistics;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
@@ -23,7 +21,6 @@ using osu.Game.Overlays;
 using osu.Game.Overlays.BeatmapSet;
 using osuTK;
 using osu.Game.Resources.Localisation.Web;
-using DownloadButton = osu.Game.Beatmaps.Drawables.Cards.Buttons.DownloadButton;
 
 namespace osu.Game.Beatmaps.Drawables.Cards
 {
@@ -31,7 +28,6 @@ namespace osu.Game.Beatmaps.Drawables.Cards
     {
         private const float width = 475;
         private const float height = 140;
-        private const float icon_area_width = 30;
 
         public Bindable<bool> Expanded { get; } = new BindableBool();
 
@@ -44,20 +40,13 @@ namespace osu.Game.Beatmaps.Drawables.Cards
         private readonly BeatmapCardContent content;
 
         private BeatmapCardThumbnail thumbnail = null!;
+        private CollapsibleButtonContainer buttonContainer = null!;
 
-        private Container rightAreaBackground = null!;
-        private Container<BeatmapCardIconButton> rightAreaButtons = null!;
-
-        private Container mainContent = null!;
-        private BeatmapCardContentBackground mainContentBackground = null!;
         private GridContainer statisticsContainer = null!;
 
         private FillFlowContainer idleBottomContent = null!;
         private BeatmapCardDownloadProgressBar downloadProgressBar = null!;
 
-        [Resolved]
-        private OsuColour colours { get; set; } = null!;
-
         [Resolved]
         private OverlayColourProvider colourProvider { get; set; } = null!;
 
@@ -88,21 +77,6 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                     Children = new Drawable[]
                     {
                         downloadTracker,
-                        rightAreaBackground = new Container
-                        {
-                            RelativeSizeAxes = Axes.Y,
-                            Width = icon_area_width + 2 * BeatmapCard.CORNER_RADIUS,
-                            Anchor = Anchor.CentreRight,
-                            Origin = Anchor.CentreRight,
-                            // workaround for masking artifacts at the top & bottom of card,
-                            // which become especially visible on downloaded beatmaps (when the icon area has a lime background).
-                            Padding = new MarginPadding { Vertical = 1 },
-                            Child = new Box
-                            {
-                                RelativeSizeAxes = Axes.Both,
-                                Colour = Colour4.White
-                            },
-                        },
                         thumbnail = new BeatmapCardThumbnail(beatmapSet)
                         {
                             Name = @"Left (icon) area",
@@ -116,61 +90,19 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                                 Spacing = new Vector2(1)
                             }
                         },
-                        new Container
+                        buttonContainer = new CollapsibleButtonContainer(beatmapSet)
                         {
-                            Name = @"Right (button) area",
-                            Width = 30,
-                            RelativeSizeAxes = Axes.Y,
-                            Origin = Anchor.TopRight,
-                            Anchor = Anchor.TopRight,
-                            Padding = new MarginPadding { Vertical = 35 },
-                            Child = rightAreaButtons = new Container<BeatmapCardIconButton>
-                            {
-                                RelativeSizeAxes = Axes.Both,
-                                Children = new BeatmapCardIconButton[]
-                                {
-                                    new FavouriteButton(beatmapSet)
-                                    {
-                                        Current = favouriteState,
-                                        Anchor = Anchor.TopCentre,
-                                        Origin = Anchor.TopCentre
-                                    },
-                                    new DownloadButton(beatmapSet)
-                                    {
-                                        Anchor = Anchor.BottomCentre,
-                                        Origin = Anchor.BottomCentre,
-                                        State = { BindTarget = downloadTracker.State }
-                                    },
-                                    new GoToBeatmapButton(beatmapSet)
-                                    {
-                                        Anchor = Anchor.BottomCentre,
-                                        Origin = Anchor.BottomCentre,
-                                        State = { BindTarget = downloadTracker.State }
-                                    }
-                                }
-                            }
-                        },
-                        mainContent = new Container
-                        {
-                            Name = @"Main content",
                             X = height - BeatmapCard.CORNER_RADIUS,
-                            Height = height,
-                            CornerRadius = BeatmapCard.CORNER_RADIUS,
-                            Masking = true,
+                            Width = width - height + BeatmapCard.CORNER_RADIUS,
+                            FavouriteState = { BindTarget = favouriteState },
+                            ButtonsCollapsedWidth = BeatmapCard.CORNER_RADIUS,
+                            ButtonsExpandedWidth = 30,
+                            ButtonsPadding = new MarginPadding { Vertical = 35 },
                             Children = new Drawable[]
                             {
-                                mainContentBackground = new BeatmapCardContentBackground(beatmapSet)
-                                {
-                                    RelativeSizeAxes = Axes.Both,
-                                },
                                 new FillFlowContainer
                                 {
                                     RelativeSizeAxes = Axes.Both,
-                                    Padding = new MarginPadding
-                                    {
-                                        Horizontal = 10,
-                                        Vertical = 4
-                                    },
                                     Direction = FillDirection.Vertical,
                                     Children = new Drawable[]
                                     {
@@ -248,11 +180,6 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                                     AutoSizeAxes = Axes.Y,
                                     Anchor = Anchor.BottomLeft,
                                     Origin = Anchor.BottomLeft,
-                                    Padding = new MarginPadding
-                                    {
-                                        Horizontal = 10,
-                                        Vertical = 4
-                                    },
                                     Children = new Drawable[]
                                     {
                                         idleBottomContent = new FillFlowContainer
@@ -414,28 +341,13 @@ namespace osu.Game.Beatmaps.Drawables.Cards
         {
             bool showDetails = IsHovered || Expanded.Value;
 
-            float targetWidth = width - height;
-            if (showDetails)
-                targetWidth = targetWidth - icon_area_width + BeatmapCard.CORNER_RADIUS;
-
+            buttonContainer.ShowDetails.Value = showDetails;
             thumbnail.Dimmed.Value = showDetails;
 
             // Scale value is intentionally chosen to fit in the spacing of listing displays, as to not overlap horizontally with adjacent cards.
             // This avoids depth issues where a hovered (scaled) card to the right of another card would be beneath the card to the left.
             content.ScaleTo(Expanded.Value ? 1.03f : 1, 500, Easing.OutQuint);
 
-            mainContent.ResizeWidthTo(targetWidth, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
-            mainContentBackground.Dimmed.Value = showDetails;
-
-            rightAreaBackground.FadeColour(downloadTracker.State.Value == DownloadState.LocallyAvailable ? colours.Lime0 : colourProvider.Background3, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
-            rightAreaButtons.FadeTo(showDetails ? 1 : 0, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
-
-            foreach (var button in rightAreaButtons)
-            {
-                button.IdleColour = downloadTracker.State.Value != DownloadState.LocallyAvailable ? colourProvider.Light1 : colourProvider.Background3;
-                button.HoverColour = downloadTracker.State.Value != DownloadState.LocallyAvailable ? colourProvider.Content1 : colourProvider.Foreground1;
-            }
-
             bool showProgress = downloadTracker.State.Value == DownloadState.Downloading || downloadTracker.State.Value == DownloadState.Importing;
 
             idleBottomContent.FadeTo(showProgress ? 0 : 1, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
diff --git a/osu.Game/Beatmaps/Drawables/Cards/CollapsibleButtonContainer.cs b/osu.Game/Beatmaps/Drawables/Cards/CollapsibleButtonContainer.cs
new file mode 100644
index 0000000000..3a2cb80a8d
--- /dev/null
+++ b/osu.Game/Beatmaps/Drawables/Cards/CollapsibleButtonContainer.cs
@@ -0,0 +1,184 @@
+// 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 enable
+
+using osu.Framework.Allocation;
+using osu.Framework.Bindables;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.Shapes;
+using osu.Game.Beatmaps.Drawables.Cards.Buttons;
+using osu.Game.Graphics;
+using osu.Game.Online;
+using osu.Game.Online.API.Requests.Responses;
+using osu.Game.Overlays;
+
+namespace osu.Game.Beatmaps.Drawables.Cards
+{
+    public class CollapsibleButtonContainer : Container
+    {
+        public Bindable<bool> ShowDetails = new Bindable<bool>();
+        public Bindable<BeatmapSetFavouriteState> FavouriteState = new Bindable<BeatmapSetFavouriteState>();
+
+        private readonly BeatmapDownloadTracker downloadTracker;
+
+        private float buttonsExpandedWidth;
+
+        public float ButtonsExpandedWidth
+        {
+            get => buttonsExpandedWidth;
+            set
+            {
+                buttonsExpandedWidth = value;
+                buttonArea.Width = value;
+                if (IsLoaded)
+                    updateState();
+            }
+        }
+
+        private float buttonsCollapsedWidth;
+
+        public float ButtonsCollapsedWidth
+        {
+            get => buttonsCollapsedWidth;
+            set
+            {
+                buttonsCollapsedWidth = value;
+                if (IsLoaded)
+                    updateState();
+            }
+        }
+
+        public MarginPadding ButtonsPadding
+        {
+            get => buttons.Padding;
+            set => buttons.Padding = value;
+        }
+
+        protected override Container<Drawable> Content => mainContent;
+
+        private readonly Container background;
+
+        private readonly Container buttonArea;
+        private readonly Container<BeatmapCardIconButton> buttons;
+
+        private readonly Container mainArea;
+        private readonly Container mainContent;
+
+        [Resolved]
+        private OsuColour colours { get; set; } = null!;
+
+        [Resolved]
+        private OverlayColourProvider colourProvider { get; set; } = null!;
+
+        public CollapsibleButtonContainer(APIBeatmapSet beatmapSet)
+        {
+            downloadTracker = new BeatmapDownloadTracker(beatmapSet);
+
+            RelativeSizeAxes = Axes.Y;
+            Masking = true;
+            CornerRadius = BeatmapCard.CORNER_RADIUS;
+
+            InternalChildren = new Drawable[]
+            {
+                downloadTracker,
+                background = new Container
+                {
+                    RelativeSizeAxes = Axes.Both,
+                    Anchor = Anchor.CentreRight,
+                    Origin = Anchor.CentreRight,
+                    // workaround for masking artifacts at the top & bottom of card,
+                    // which become especially visible on downloaded beatmaps (when the icon area has a lime background).
+                    Padding = new MarginPadding { Vertical = 1 },
+                    Child = new Box
+                    {
+                        RelativeSizeAxes = Axes.Both,
+                        Colour = Colour4.White
+                    },
+                },
+                buttonArea = new Container
+                {
+                    Name = @"Right (button) area",
+                    RelativeSizeAxes = Axes.Y,
+                    Origin = Anchor.TopRight,
+                    Anchor = Anchor.TopRight,
+                    Child = buttons = new Container<BeatmapCardIconButton>
+                    {
+                        RelativeSizeAxes = Axes.Both,
+                        Children = new BeatmapCardIconButton[]
+                        {
+                            new FavouriteButton(beatmapSet)
+                            {
+                                Current = FavouriteState,
+                                Anchor = Anchor.TopCentre,
+                                Origin = Anchor.TopCentre
+                            },
+                            new DownloadButton(beatmapSet)
+                            {
+                                Anchor = Anchor.BottomCentre,
+                                Origin = Anchor.BottomCentre,
+                                State = { BindTarget = downloadTracker.State }
+                            },
+                            new GoToBeatmapButton(beatmapSet)
+                            {
+                                Anchor = Anchor.BottomCentre,
+                                Origin = Anchor.BottomCentre,
+                                State = { BindTarget = downloadTracker.State }
+                            }
+                        }
+                    }
+                },
+                mainArea = new Container
+                {
+                    Name = @"Main content",
+                    RelativeSizeAxes = Axes.Y,
+                    CornerRadius = BeatmapCard.CORNER_RADIUS,
+                    Masking = true,
+                    Children = new Drawable[]
+                    {
+                        new BeatmapCardContentBackground(beatmapSet)
+                        {
+                            RelativeSizeAxes = Axes.Both,
+                            Dimmed = { BindTarget = ShowDetails }
+                        },
+                        mainContent = new Container
+                        {
+                            RelativeSizeAxes = Axes.Both,
+                            Padding = new MarginPadding
+                            {
+                                Horizontal = 10,
+                                Vertical = 4
+                            },
+                        }
+                    }
+                }
+            };
+        }
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            downloadTracker.State.BindValueChanged(_ => updateState());
+            ShowDetails.BindValueChanged(_ => updateState(), true);
+            FinishTransforms(true);
+        }
+
+        private void updateState()
+        {
+            float targetWidth = Width - (ShowDetails.Value ? ButtonsExpandedWidth : ButtonsCollapsedWidth);
+
+            mainArea.ResizeWidthTo(targetWidth, 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);
+
+            foreach (var button in buttons)
+            {
+                button.IdleColour = downloadTracker.State.Value != DownloadState.LocallyAvailable ? colourProvider.Light1 : colourProvider.Background3;
+                button.HoverColour = downloadTracker.State.Value != DownloadState.LocallyAvailable ? colourProvider.Content1 : colourProvider.Foreground1;
+            }
+        }
+    }
+}

From fd5af1fbe7e0f776d7b5ff5bd5ac7b4e3479fd70 Mon Sep 17 00:00:00 2001
From: mk-56 <darioheadleysilva@gmail.com>
Date: Fri, 17 Dec 2021 13:16:06 +0100
Subject: [PATCH 1707/5547] Code refactor and name changes

cleaned code up with Jetbrains i hope it suffices
---
 osu.Game/Localisation/AudioSettingsStrings.cs         |  2 +-
 .../Settings/Sections/Gameplay/AudioSettings.cs       | 10 +++++-----
 .../Rulesets/Objects/Drawables/DrawableHitObject.cs   | 11 ++++-------
 3 files changed, 10 insertions(+), 13 deletions(-)

diff --git a/osu.Game/Localisation/AudioSettingsStrings.cs b/osu.Game/Localisation/AudioSettingsStrings.cs
index ba48c412c4..f298717c99 100644
--- a/osu.Game/Localisation/AudioSettingsStrings.cs
+++ b/osu.Game/Localisation/AudioSettingsStrings.cs
@@ -32,7 +32,7 @@ namespace osu.Game.Localisation
         /// <summary>
         /// "Master"
         /// </summary>
-        public static LocalisableString PositionalLevel => new TranslatableString(getKey(@"positional_hitsound_audio_level"), @"Positional hitsound audio level");
+        public static LocalisableString PositionalLevel => new TranslatableString(getKey(@"positional_hitsound_audio_level"), @"Hitsound stereo separation");
 
         /// <summary>
         /// "Level"
diff --git a/osu.Game/Overlays/Settings/Sections/Gameplay/AudioSettings.cs b/osu.Game/Overlays/Settings/Sections/Gameplay/AudioSettings.cs
index a5c5399e98..4238ad1605 100644
--- a/osu.Game/Overlays/Settings/Sections/Gameplay/AudioSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Gameplay/AudioSettings.cs
@@ -20,11 +20,11 @@ namespace osu.Game.Overlays.Settings.Sections.Gameplay
         private FillFlowContainer<SettingsSlider<float>> positionalHitsoundsSettings;
 
         [BackgroundDependencyLoader]
-        private void load(OsuConfigManager config,OsuConfigManager osuConfig)
+        private void load(OsuConfigManager config, OsuConfigManager osuConfig)
         {
             positionalHitsoundsLevel = osuConfig.GetBindable<float>(OsuSetting.PositionalHitsoundsLevel);
             Children = new Drawable[]
-            {                
+            {
                 positionalHitsoundsSettings = new FillFlowContainer<SettingsSlider<float>>
                 {
                     Direction = FillDirection.Vertical,
@@ -38,15 +38,15 @@ namespace osu.Game.Overlays.Settings.Sections.Gameplay
                             LabelText = AudioSettingsStrings.PositionalLevel,
                             Current = positionalHitsoundsLevel,
                             KeyboardStep = 0.01f,
-                            DisplayAsPercentage = true,
-                        },
+                            DisplayAsPercentage = true
+                        }
                     }
                 },
                 new SettingsCheckbox
                 {
                     LabelText = GameplaySettingsStrings.AlwaysPlayFirstComboBreak,
                     Current = config.GetBindable<bool>(OsuSetting.AlwaysPlayFirstComboBreak)
-                },
+                }
             };
         }
     }
diff --git a/osu.Game/Rulesets/Objects/Drawables/DrawableHitObject.cs b/osu.Game/Rulesets/Objects/Drawables/DrawableHitObject.cs
index 56e02e3ddd..4ab513bf19 100644
--- a/osu.Game/Rulesets/Objects/Drawables/DrawableHitObject.cs
+++ b/osu.Game/Rulesets/Objects/Drawables/DrawableHitObject.cs
@@ -22,7 +22,6 @@ using osu.Game.Rulesets.Scoring;
 using osu.Game.Rulesets.UI;
 using osu.Game.Skinning;
 using osuTK.Graphics;
-using osu.Game.Overlays.Settings.Sections.Gameplay;
 
 namespace osu.Game.Rulesets.Objects.Drawables
 {
@@ -126,8 +125,7 @@ namespace osu.Game.Rulesets.Objects.Drawables
         private readonly BindableList<HitSampleInfo> samplesBindable = new BindableList<HitSampleInfo>();
         private readonly Bindable<int> comboIndexBindable = new Bindable<int>();
 
-        private readonly Bindable<float> positionalHitsoundsLevel = new Bindable<float>();        
-        private readonly Bindable<int> comboIndexBindable = new Bindable<int>();
+        private readonly Bindable<float> positionalHitsoundsLevel = new Bindable<float>();
         private readonly Bindable<int> comboIndexWithOffsetsBindable = new Bindable<int>();
 
         protected override bool RequiresChildrenUpdate => true;
@@ -534,10 +532,9 @@ namespace osu.Game.Rulesets.Objects.Drawables
         /// <param name="position">The lookup X position. Generally should be <see cref="SamplePlaybackPosition"/>.</param>
         protected double CalculateSamplePlaybackBalance(double position)
         {
-            double returnedvalue;
-            float balance_adjust_amount = positionalHitsoundsLevel.Value*2;
-            returnedvalue = balance_adjust_amount *(position - 0.5f );
-            
+            float balanceAdjustAmount = positionalHitsoundsLevel.Value * 2;
+            double returnedvalue = balanceAdjustAmount * (position - 0.5f);
+
             return returnedvalue;
         }
 

From d6f60399342512250fb0c92b90d0c8e13d853eb9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 17 Dec 2021 13:27:11 +0100
Subject: [PATCH 1708/5547] Extract base class for beatmap cards

---
 .../Beatmaps/Drawables/Cards/BeatmapCard.cs   | 101 +++++-----------
 .../Drawables/Cards/BeatmapCardBase.cs        |  80 +++++++++++++
 .../Drawables/Cards/BeatmapCardContent.cs     |  14 +--
 .../Cards/BeatmapCardContentBackground.cs     |   4 +-
 .../Cards/BeatmapCardDownloadProgressBar.cs   |   4 +-
 .../Drawables/Cards/BeatmapCardExtra.cs       | 108 ++++++------------
 .../Drawables/Cards/BeatmapCardThumbnail.cs   |   4 +-
 .../Cards/Buttons/BeatmapCardIconButton.cs    |   2 +-
 .../Drawables/Cards/Buttons/DownloadButton.cs |   4 +-
 .../Cards/Buttons/GoToBeatmapButton.cs        |   2 +-
 .../Drawables/Cards/Buttons/PlayButton.cs     |   2 +-
 .../Cards/CollapsibleButtonContainer.cs       |  10 +-
 12 files changed, 168 insertions(+), 167 deletions(-)
 create mode 100644 osu.Game/Beatmaps/Drawables/Cards/BeatmapCardBase.cs

diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
index 13c4cfe207..b0df2e40d3 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
@@ -5,18 +5,14 @@
 
 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.Sprites;
-using osu.Framework.Input.Events;
 using osu.Framework.Localisation;
 using osu.Game.Beatmaps.Drawables.Cards.Statistics;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
-using osu.Game.Graphics.UserInterface;
-using osu.Game.Online;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays;
 using osu.Game.Overlays.BeatmapSet;
@@ -25,21 +21,14 @@ using osu.Game.Resources.Localisation.Web;
 
 namespace osu.Game.Beatmaps.Drawables.Cards
 {
-    public class BeatmapCard : OsuClickableContainer
+    public class BeatmapCard : BeatmapCardBase
     {
-        public const float TRANSITION_DURATION = 400;
-        public const float CORNER_RADIUS = 10;
-
-        public IBindable<bool> Expanded { get; }
+        protected override Drawable IdleContent => idleBottomContent;
+        protected override Drawable DownloadInProgressContent => downloadProgressBar;
 
         private const float width = 408;
         private const float height = 100;
 
-        private readonly APIBeatmapSet beatmapSet;
-        private readonly Bindable<BeatmapSetFavouriteState> favouriteState;
-
-        private readonly BeatmapDownloadTracker downloadTracker;
-
         [Cached]
         private readonly BeatmapCardContent content;
 
@@ -55,18 +44,13 @@ namespace osu.Game.Beatmaps.Drawables.Cards
         private OverlayColourProvider colourProvider { get; set; } = null!;
 
         public BeatmapCard(APIBeatmapSet beatmapSet, bool allowExpansion = true)
-            : base(HoverSampleSet.Submit)
+            : base(beatmapSet, allowExpansion)
         {
-            Expanded = new BindableBool { Disabled = !allowExpansion };
-
-            this.beatmapSet = beatmapSet;
-            favouriteState = new Bindable<BeatmapSetFavouriteState>(new BeatmapSetFavouriteState(beatmapSet.HasFavourited, beatmapSet.FavouriteCount));
-            downloadTracker = new BeatmapDownloadTracker(beatmapSet);
             content = new BeatmapCardContent(height);
         }
 
-        [BackgroundDependencyLoader(true)]
-        private void load(BeatmapSetOverlay? beatmapSetOverlay)
+        [BackgroundDependencyLoader]
+        private void load()
         {
             Width = width;
             Height = height;
@@ -75,15 +59,14 @@ namespace osu.Game.Beatmaps.Drawables.Cards
             GridContainer titleContainer = null!;
             GridContainer artistContainer = null!;
 
-            InternalChild = content.With(c =>
+            Child = content.With(c =>
             {
                 c.MainContent = new Container
                 {
                     RelativeSizeAxes = Axes.Both,
                     Children = new Drawable[]
                     {
-                        downloadTracker,
-                        thumbnail = new BeatmapCardThumbnail(beatmapSet)
+                        thumbnail = new BeatmapCardThumbnail(BeatmapSet)
                         {
                             Name = @"Left (icon) area",
                             Size = new Vector2(height),
@@ -96,11 +79,11 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                                 Spacing = new Vector2(1)
                             }
                         },
-                        buttonContainer = new CollapsibleButtonContainer(beatmapSet)
+                        buttonContainer = new CollapsibleButtonContainer(BeatmapSet)
                         {
                             X = height - CORNER_RADIUS,
                             Width = width - height + CORNER_RADIUS,
-                            FavouriteState = { BindTarget = favouriteState },
+                            FavouriteState = { BindTarget = FavouriteState },
                             ButtonsCollapsedWidth = CORNER_RADIUS,
                             ButtonsExpandedWidth = 30,
                             ButtonsPadding = new MarginPadding { Vertical = 17.5f },
@@ -131,7 +114,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                                                 {
                                                     new OsuSpriteText
                                                     {
-                                                        Text = new RomanisableString(beatmapSet.TitleUnicode, beatmapSet.Title),
+                                                        Text = new RomanisableString(BeatmapSet.TitleUnicode, BeatmapSet.Title),
                                                         Font = OsuFont.Default.With(size: 22.5f, weight: FontWeight.SemiBold),
                                                         RelativeSizeAxes = Axes.X,
                                                         Truncate = true
@@ -177,7 +160,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                                             d.AutoSizeAxes = Axes.Both;
                                             d.Margin = new MarginPadding { Top = 2 };
                                             d.AddText("mapped by ", t => t.Colour = colourProvider.Content2);
-                                            d.AddUserLink(beatmapSet.Author);
+                                            d.AddUserLink(BeatmapSet.Author);
                                         }),
                                     }
                                 },
@@ -209,7 +192,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                                                     AlwaysPresent = true,
                                                     ChildrenEnumerable = createStatistics()
                                                 },
-                                                new BeatmapCardExtraInfoRow(beatmapSet)
+                                                new BeatmapCardExtraInfoRow(BeatmapSet)
                                             }
                                         },
                                         downloadProgressBar = new BeatmapCardDownloadProgressBar
@@ -218,8 +201,8 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                                             Height = 6,
                                             Anchor = Anchor.Centre,
                                             Origin = Anchor.Centre,
-                                            State = { BindTarget = downloadTracker.State },
-                                            Progress = { BindTarget = downloadTracker.Progress }
+                                            State = { BindTarget = DownloadTracker.State },
+                                            Progress = { BindTarget = DownloadTracker.Progress }
                                         }
                                     }
                                 }
@@ -232,18 +215,18 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                     RelativeSizeAxes = Axes.X,
                     AutoSizeAxes = Axes.Y,
                     Padding = new MarginPadding { Horizontal = 10, Vertical = 13 },
-                    Child = new BeatmapCardDifficultyList(beatmapSet)
+                    Child = new BeatmapCardDifficultyList(BeatmapSet)
                 };
                 c.Expanded.BindTarget = Expanded;
             });
 
-            if (beatmapSet.HasVideo)
+            if (BeatmapSet.HasVideo)
                 leftIconArea.Add(new IconPill(FontAwesome.Solid.Film) { IconSize = new Vector2(20) });
 
-            if (beatmapSet.HasStoryboard)
+            if (BeatmapSet.HasStoryboard)
                 leftIconArea.Add(new IconPill(FontAwesome.Solid.Image) { IconSize = new Vector2(20) });
 
-            if (beatmapSet.HasExplicitContent)
+            if (BeatmapSet.HasExplicitContent)
             {
                 titleContainer.Content[0][1] = new ExplicitContentBeatmapPill
                 {
@@ -253,7 +236,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                 };
             }
 
-            if (beatmapSet.TrackId != null)
+            if (BeatmapSet.TrackId != null)
             {
                 artistContainer.Content[0][1] = new FeaturedArtistBeatmapPill
                 {
@@ -262,57 +245,36 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                     Margin = new MarginPadding { Left = 5 }
                 };
             }
-
-            Action = () => beatmapSetOverlay?.FetchAndShowBeatmapSet(beatmapSet.OnlineID);
-        }
-
-        protected override void LoadComplete()
-        {
-            base.LoadComplete();
-
-            downloadTracker.State.BindValueChanged(_ => updateState());
-            Expanded.BindValueChanged(_ => updateState(), true);
-            FinishTransforms(true);
-        }
-
-        protected override bool OnHover(HoverEvent e)
-        {
-            updateState();
-            return base.OnHover(e);
-        }
-
-        protected override void OnHoverLost(HoverLostEvent e)
-        {
-            updateState();
-            base.OnHoverLost(e);
         }
 
         private LocalisableString createArtistText()
         {
-            var romanisableArtist = new RomanisableString(beatmapSet.ArtistUnicode, beatmapSet.Artist);
+            var romanisableArtist = new RomanisableString(BeatmapSet.ArtistUnicode, BeatmapSet.Artist);
             return BeatmapsetsStrings.ShowDetailsByArtist(romanisableArtist);
         }
 
         private IEnumerable<BeatmapCardStatistic> createStatistics()
         {
-            var hypesStatistic = HypesStatistic.CreateFor(beatmapSet);
+            var hypesStatistic = HypesStatistic.CreateFor(BeatmapSet);
             if (hypesStatistic != null)
                 yield return hypesStatistic;
 
-            var nominationsStatistic = NominationsStatistic.CreateFor(beatmapSet);
+            var nominationsStatistic = NominationsStatistic.CreateFor(BeatmapSet);
             if (nominationsStatistic != null)
                 yield return nominationsStatistic;
 
-            yield return new FavouritesStatistic(beatmapSet) { Current = favouriteState };
-            yield return new PlayCountStatistic(beatmapSet);
+            yield return new FavouritesStatistic(BeatmapSet) { Current = FavouriteState };
+            yield return new PlayCountStatistic(BeatmapSet);
 
-            var dateStatistic = BeatmapCardDateStatistic.CreateFor(beatmapSet);
+            var dateStatistic = BeatmapCardDateStatistic.CreateFor(BeatmapSet);
             if (dateStatistic != null)
                 yield return dateStatistic;
         }
 
-        private void updateState()
+        protected override void UpdateState()
         {
+            base.UpdateState();
+
             bool showDetails = IsHovered || Expanded.Value;
 
             buttonContainer.ShowDetails.Value = showDetails;
@@ -323,11 +285,6 @@ namespace osu.Game.Beatmaps.Drawables.Cards
             content.ScaleTo(Expanded.Value ? 1.03f : 1, 500, Easing.OutQuint);
 
             statisticsContainer.FadeTo(showDetails ? 1 : 0, TRANSITION_DURATION, Easing.OutQuint);
-
-            bool showProgress = downloadTracker.State.Value == DownloadState.Downloading || downloadTracker.State.Value == DownloadState.Importing;
-
-            idleBottomContent.FadeTo(showProgress ? 0 : 1, TRANSITION_DURATION, Easing.OutQuint);
-            downloadProgressBar.FadeTo(showProgress ? 1 : 0, TRANSITION_DURATION, Easing.OutQuint);
         }
     }
 }
diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardBase.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardBase.cs
new file mode 100644
index 0000000000..77df0809bc
--- /dev/null
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardBase.cs
@@ -0,0 +1,80 @@
+// 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 enable
+
+using osu.Framework.Allocation;
+using osu.Framework.Bindables;
+using osu.Framework.Graphics;
+using osu.Framework.Input.Events;
+using osu.Game.Graphics.Containers;
+using osu.Game.Graphics.UserInterface;
+using osu.Game.Online;
+using osu.Game.Online.API.Requests.Responses;
+using osu.Game.Overlays;
+
+namespace osu.Game.Beatmaps.Drawables.Cards
+{
+    public abstract class BeatmapCardBase : OsuClickableContainer
+    {
+        public const float TRANSITION_DURATION = 400;
+        public const float CORNER_RADIUS = 10;
+
+        public IBindable<bool> Expanded { get; }
+
+        protected readonly APIBeatmapSet BeatmapSet;
+        protected readonly Bindable<BeatmapSetFavouriteState> FavouriteState;
+
+        protected abstract Drawable IdleContent { get; }
+        protected abstract Drawable DownloadInProgressContent { get; }
+
+        protected readonly BeatmapDownloadTracker DownloadTracker;
+
+        protected BeatmapCardBase(APIBeatmapSet beatmapSet, bool allowExpansion = true)
+            : base(HoverSampleSet.Submit)
+        {
+            Expanded = new BindableBool { Disabled = !allowExpansion };
+
+            BeatmapSet = beatmapSet;
+            FavouriteState = new Bindable<BeatmapSetFavouriteState>(new BeatmapSetFavouriteState(beatmapSet.HasFavourited, beatmapSet.FavouriteCount));
+            DownloadTracker = new BeatmapDownloadTracker(beatmapSet);
+        }
+
+        [BackgroundDependencyLoader(true)]
+        private void load(BeatmapSetOverlay? beatmapSetOverlay)
+        {
+            Action = () => beatmapSetOverlay?.FetchAndShowBeatmapSet(BeatmapSet.OnlineID);
+
+            AddInternal(DownloadTracker);
+        }
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            DownloadTracker.State.BindValueChanged(_ => UpdateState());
+            Expanded.BindValueChanged(_ => UpdateState(), true);
+            FinishTransforms(true);
+        }
+
+        protected override bool OnHover(HoverEvent e)
+        {
+            UpdateState();
+            return base.OnHover(e);
+        }
+
+        protected override void OnHoverLost(HoverLostEvent e)
+        {
+            UpdateState();
+            base.OnHoverLost(e);
+        }
+
+        protected virtual void UpdateState()
+        {
+            bool showProgress = DownloadTracker.State.Value == DownloadState.Downloading || DownloadTracker.State.Value == DownloadState.Importing;
+
+            IdleContent.FadeTo(showProgress ? 0 : 1, TRANSITION_DURATION, Easing.OutQuint);
+            DownloadInProgressContent.FadeTo(showProgress ? 1 : 0, TRANSITION_DURATION, Easing.OutQuint);
+        }
+    }
+}
diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardContent.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardContent.cs
index 286e03e700..e16421503c 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardContent.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardContent.cs
@@ -54,7 +54,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
             {
                 RelativeSizeAxes = Axes.X,
                 AutoSizeAxes = Axes.Y,
-                CornerRadius = BeatmapCard.CORNER_RADIUS,
+                CornerRadius = BeatmapCardBase.CORNER_RADIUS,
                 Masking = true,
                 Unhovered = _ => updateFromHoverChange(),
                 Children = new Drawable[]
@@ -67,7 +67,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                     {
                         RelativeSizeAxes = Axes.X,
                         Height = height,
-                        CornerRadius = BeatmapCard.CORNER_RADIUS,
+                        CornerRadius = BeatmapCardBase.CORNER_RADIUS,
                         Masking = true,
                     },
                     dropdownContent = new HoverHandlingContainer
@@ -91,7 +91,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                     borderContainer = new Container
                     {
                         RelativeSizeAxes = Axes.Both,
-                        CornerRadius = BeatmapCard.CORNER_RADIUS,
+                        CornerRadius = BeatmapCardBase.CORNER_RADIUS,
                         Masking = true,
                         BorderThickness = 3,
                         Child = new Box
@@ -139,9 +139,9 @@ namespace osu.Game.Beatmaps.Drawables.Cards
 
         private void updateState()
         {
-            background.FadeTo(Expanded.Value ? 1 : 0, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
-            dropdownContent.FadeTo(Expanded.Value ? 1 : 0, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
-            borderContainer.FadeTo(Expanded.Value ? 1 : 0, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
+            background.FadeTo(Expanded.Value ? 1 : 0, BeatmapCardBase.TRANSITION_DURATION, Easing.OutQuint);
+            dropdownContent.FadeTo(Expanded.Value ? 1 : 0, BeatmapCardBase.TRANSITION_DURATION, Easing.OutQuint);
+            borderContainer.FadeTo(Expanded.Value ? 1 : 0, BeatmapCardBase.TRANSITION_DURATION, Easing.OutQuint);
 
             content.TweenEdgeEffectTo(new EdgeEffectParameters
             {
@@ -150,7 +150,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                 Radius = 10,
                 Colour = Colour4.Black.Opacity(Expanded.Value ? 0.3f : 0f),
                 Hollow = true,
-            }, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
+            }, BeatmapCardBase.TRANSITION_DURATION, Easing.OutQuint);
         }
 
         private class ExpandedContentScrollContainer : OsuScrollContainer
diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardContentBackground.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardContentBackground.cs
index 392f5d1bfa..6388e1698c 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardContentBackground.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardContentBackground.cs
@@ -62,10 +62,10 @@ namespace osu.Game.Beatmaps.Drawables.Cards
 
         private void updateState() => Schedule(() =>
         {
-            background.FadeColour(Dimmed.Value ? colourProvider.Background4 : colourProvider.Background2, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
+            background.FadeColour(Dimmed.Value ? colourProvider.Background4 : colourProvider.Background2, BeatmapCardBase.TRANSITION_DURATION, Easing.OutQuint);
 
             var gradient = ColourInfo.GradientHorizontal(Colour4.White.Opacity(0), Colour4.White.Opacity(0.2f));
-            cover.FadeColour(gradient, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
+            cover.FadeColour(gradient, BeatmapCardBase.TRANSITION_DURATION, Easing.OutQuint);
         });
     }
 }
diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardDownloadProgressBar.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardDownloadProgressBar.cs
index ffb4e0c540..b80c5221ab 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardDownloadProgressBar.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardDownloadProgressBar.cs
@@ -82,14 +82,14 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                     break;
 
                 case DownloadState.Importing:
-                    foregroundFill.FadeColour(colours.Yellow, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
+                    foregroundFill.FadeColour(colours.Yellow, BeatmapCardBase.TRANSITION_DURATION, Easing.OutQuint);
                     break;
             }
         }
 
         private void progressChanged()
         {
-            foreground.ResizeWidthTo((float)progress.Value, progress.Value > 0 ? BeatmapCard.TRANSITION_DURATION : 0, Easing.OutQuint);
+            foreground.ResizeWidthTo((float)progress.Value, progress.Value > 0 ? BeatmapCardBase.TRANSITION_DURATION : 0, Easing.OutQuint);
         }
     }
 }
diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtra.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtra.cs
index fb498d643a..39acbb352d 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtra.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtra.cs
@@ -4,18 +4,14 @@
 #nullable enable
 
 using osu.Framework.Allocation;
-using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Sprites;
-using osu.Framework.Input.Events;
 using osu.Framework.Localisation;
 using osu.Game.Beatmaps.Drawables.Cards.Statistics;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
-using osu.Game.Graphics.UserInterface;
-using osu.Game.Online;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays;
 using osu.Game.Overlays.BeatmapSet;
@@ -24,18 +20,14 @@ using osu.Game.Resources.Localisation.Web;
 
 namespace osu.Game.Beatmaps.Drawables.Cards
 {
-    public class BeatmapCardExtra : OsuClickableContainer
+    public class BeatmapCardExtra : BeatmapCardBase
     {
+        protected override Drawable IdleContent => idleBottomContent;
+        protected override Drawable DownloadInProgressContent => downloadProgressBar;
+
         private const float width = 475;
         private const float height = 140;
 
-        public Bindable<bool> Expanded { get; } = new BindableBool();
-
-        private readonly APIBeatmapSet beatmapSet;
-        private readonly Bindable<BeatmapSetFavouriteState> favouriteState;
-
-        private readonly BeatmapDownloadTracker downloadTracker;
-
         [Cached]
         private readonly BeatmapCardContent content;
 
@@ -50,12 +42,9 @@ namespace osu.Game.Beatmaps.Drawables.Cards
         [Resolved]
         private OverlayColourProvider colourProvider { get; set; } = null!;
 
-        public BeatmapCardExtra(APIBeatmapSet beatmapSet)
-            : base(HoverSampleSet.Submit)
+        public BeatmapCardExtra(APIBeatmapSet beatmapSet, bool allowExpansion = true)
+            : base(beatmapSet, allowExpansion)
         {
-            this.beatmapSet = beatmapSet;
-            favouriteState = new Bindable<BeatmapSetFavouriteState>(new BeatmapSetFavouriteState(beatmapSet.HasFavourited, beatmapSet.FavouriteCount));
-            downloadTracker = new BeatmapDownloadTracker(beatmapSet);
             content = new BeatmapCardContent(height);
         }
 
@@ -69,19 +58,18 @@ namespace osu.Game.Beatmaps.Drawables.Cards
             GridContainer titleContainer = null!;
             GridContainer artistContainer = null!;
 
-            InternalChild = content.With(c =>
+            Child = content.With(c =>
             {
                 c.MainContent = new Container
                 {
                     RelativeSizeAxes = Axes.Both,
                     Children = new Drawable[]
                     {
-                        downloadTracker,
-                        thumbnail = new BeatmapCardThumbnail(beatmapSet)
+                        thumbnail = new BeatmapCardThumbnail(BeatmapSet)
                         {
                             Name = @"Left (icon) area",
                             Size = new Vector2(height),
-                            Padding = new MarginPadding { Right = BeatmapCard.CORNER_RADIUS },
+                            Padding = new MarginPadding { Right = CORNER_RADIUS },
                             Child = leftIconArea = new FillFlowContainer
                             {
                                 Margin = new MarginPadding(5),
@@ -90,12 +78,12 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                                 Spacing = new Vector2(1)
                             }
                         },
-                        buttonContainer = new CollapsibleButtonContainer(beatmapSet)
+                        buttonContainer = new CollapsibleButtonContainer(BeatmapSet)
                         {
-                            X = height - BeatmapCard.CORNER_RADIUS,
-                            Width = width - height + BeatmapCard.CORNER_RADIUS,
-                            FavouriteState = { BindTarget = favouriteState },
-                            ButtonsCollapsedWidth = BeatmapCard.CORNER_RADIUS,
+                            X = height - CORNER_RADIUS,
+                            Width = width - height + CORNER_RADIUS,
+                            FavouriteState = { BindTarget = FavouriteState },
+                            ButtonsCollapsedWidth = CORNER_RADIUS,
                             ButtonsExpandedWidth = 30,
                             ButtonsPadding = new MarginPadding { Vertical = 35 },
                             Children = new Drawable[]
@@ -125,7 +113,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                                                 {
                                                     new OsuSpriteText
                                                     {
-                                                        Text = new RomanisableString(beatmapSet.TitleUnicode, beatmapSet.Title),
+                                                        Text = new RomanisableString(BeatmapSet.TitleUnicode, BeatmapSet.Title),
                                                         Font = OsuFont.Default.With(size: 22.5f, weight: FontWeight.SemiBold),
                                                         RelativeSizeAxes = Axes.X,
                                                         Truncate = true
@@ -166,7 +154,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                                         {
                                             RelativeSizeAxes = Axes.X,
                                             Truncate = true,
-                                            Text = beatmapSet.Source,
+                                            Text = BeatmapSet.Source,
                                             Shadow = false,
                                             Font = OsuFont.GetFont(size: 14, weight: FontWeight.SemiBold),
                                             Colour = colourProvider.Content2
@@ -200,7 +188,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                                                     d.AutoSizeAxes = Axes.Both;
                                                     d.Margin = new MarginPadding { Top = 2 };
                                                     d.AddText("mapped by ", t => t.Colour = colourProvider.Content2);
-                                                    d.AddUserLink(beatmapSet.Author);
+                                                    d.AddUserLink(BeatmapSet.Author);
                                                 }),
                                                 statisticsContainer = new GridContainer
                                                 {
@@ -223,7 +211,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                                                         new Drawable[3]
                                                     }
                                                 },
-                                                new BeatmapCardExtraInfoRow(beatmapSet)
+                                                new BeatmapCardExtraInfoRow(BeatmapSet)
                                             }
                                         },
                                         downloadProgressBar = new BeatmapCardDownloadProgressBar
@@ -232,8 +220,8 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                                             Height = 6,
                                             Anchor = Anchor.Centre,
                                             Origin = Anchor.Centre,
-                                            State = { BindTarget = downloadTracker.State },
-                                            Progress = { BindTarget = downloadTracker.Progress }
+                                            State = { BindTarget = DownloadTracker.State },
+                                            Progress = { BindTarget = DownloadTracker.Progress }
                                         }
                                     }
                                 }
@@ -246,18 +234,18 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                     RelativeSizeAxes = Axes.X,
                     AutoSizeAxes = Axes.Y,
                     Padding = new MarginPadding { Horizontal = 10, Vertical = 13 },
-                    Child = new BeatmapCardDifficultyList(beatmapSet)
+                    Child = new BeatmapCardDifficultyList(BeatmapSet)
                 };
                 c.Expanded.BindTarget = Expanded;
             });
 
-            if (beatmapSet.HasVideo)
+            if (BeatmapSet.HasVideo)
                 leftIconArea.Add(new IconPill(FontAwesome.Solid.Film) { IconSize = new Vector2(20) });
 
-            if (beatmapSet.HasStoryboard)
+            if (BeatmapSet.HasStoryboard)
                 leftIconArea.Add(new IconPill(FontAwesome.Solid.Image) { IconSize = new Vector2(20) });
 
-            if (beatmapSet.HasExplicitContent)
+            if (BeatmapSet.HasExplicitContent)
             {
                 titleContainer.Content[0][1] = new ExplicitContentBeatmapPill
                 {
@@ -267,7 +255,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                 };
             }
 
-            if (beatmapSet.TrackId != null)
+            if (BeatmapSet.TrackId != null)
             {
                 artistContainer.Content[0][1] = new FeaturedArtistBeatmapPill
                 {
@@ -279,33 +267,12 @@ namespace osu.Game.Beatmaps.Drawables.Cards
 
             createStatistics();
 
-            Action = () => beatmapSetOverlay?.FetchAndShowBeatmapSet(beatmapSet.OnlineID);
-        }
-
-        protected override void LoadComplete()
-        {
-            base.LoadComplete();
-
-            downloadTracker.State.BindValueChanged(_ => updateState());
-            Expanded.BindValueChanged(_ => updateState(), true);
-            FinishTransforms(true);
-        }
-
-        protected override bool OnHover(HoverEvent e)
-        {
-            updateState();
-            return base.OnHover(e);
-        }
-
-        protected override void OnHoverLost(HoverLostEvent e)
-        {
-            updateState();
-            base.OnHoverLost(e);
+            Action = () => beatmapSetOverlay?.FetchAndShowBeatmapSet(BeatmapSet.OnlineID);
         }
 
         private LocalisableString createArtistText()
         {
-            var romanisableArtist = new RomanisableString(beatmapSet.ArtistUnicode, beatmapSet.Artist);
+            var romanisableArtist = new RomanisableString(BeatmapSet.ArtistUnicode, BeatmapSet.Artist);
             return BeatmapsetsStrings.ShowDetailsByArtist(romanisableArtist);
         }
 
@@ -317,28 +284,30 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                 return original;
             }
 
-            statisticsContainer.Content[0][0] = withMargin(new FavouritesStatistic(beatmapSet)
+            statisticsContainer.Content[0][0] = withMargin(new FavouritesStatistic(BeatmapSet)
             {
-                Current = favouriteState,
+                Current = FavouriteState,
             });
 
-            statisticsContainer.Content[1][0] = withMargin(new PlayCountStatistic(beatmapSet));
+            statisticsContainer.Content[1][0] = withMargin(new PlayCountStatistic(BeatmapSet));
 
-            var hypesStatistic = HypesStatistic.CreateFor(beatmapSet);
+            var hypesStatistic = HypesStatistic.CreateFor(BeatmapSet);
             if (hypesStatistic != null)
                 statisticsContainer.Content[0][1] = withMargin(hypesStatistic);
 
-            var nominationsStatistic = NominationsStatistic.CreateFor(beatmapSet);
+            var nominationsStatistic = NominationsStatistic.CreateFor(BeatmapSet);
             if (nominationsStatistic != null)
                 statisticsContainer.Content[1][1] = withMargin(nominationsStatistic);
 
-            var dateStatistic = BeatmapCardDateStatistic.CreateFor(beatmapSet);
+            var dateStatistic = BeatmapCardDateStatistic.CreateFor(BeatmapSet);
             if (dateStatistic != null)
                 statisticsContainer.Content[0][2] = withMargin(dateStatistic);
         }
 
-        private void updateState()
+        protected override void UpdateState()
         {
+            base.UpdateState();
+
             bool showDetails = IsHovered || Expanded.Value;
 
             buttonContainer.ShowDetails.Value = showDetails;
@@ -347,11 +316,6 @@ namespace osu.Game.Beatmaps.Drawables.Cards
             // Scale value is intentionally chosen to fit in the spacing of listing displays, as to not overlap horizontally with adjacent cards.
             // This avoids depth issues where a hovered (scaled) card to the right of another card would be beneath the card to the left.
             content.ScaleTo(Expanded.Value ? 1.03f : 1, 500, Easing.OutQuint);
-
-            bool showProgress = downloadTracker.State.Value == DownloadState.Downloading || downloadTracker.State.Value == DownloadState.Importing;
-
-            idleBottomContent.FadeTo(showProgress ? 0 : 1, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
-            downloadProgressBar.FadeTo(showProgress ? 1 : 0, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
         }
     }
 }
diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardThumbnail.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardThumbnail.cs
index f11a5916e1..e6b305552a 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardThumbnail.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardThumbnail.cs
@@ -88,8 +88,8 @@ namespace osu.Game.Beatmaps.Drawables.Cards
         {
             bool shouldDim = Dimmed.Value || playButton.Playing.Value;
 
-            playButton.FadeTo(shouldDim ? 1 : 0, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
-            cover.FadeColour(shouldDim ? OsuColour.Gray(0.2f) : Color4.White, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
+            playButton.FadeTo(shouldDim ? 1 : 0, BeatmapCardBase.TRANSITION_DURATION, Easing.OutQuint);
+            cover.FadeColour(shouldDim ? OsuColour.Gray(0.2f) : Color4.White, BeatmapCardBase.TRANSITION_DURATION, Easing.OutQuint);
         }
     }
 }
diff --git a/osu.Game/Beatmaps/Drawables/Cards/Buttons/BeatmapCardIconButton.cs b/osu.Game/Beatmaps/Drawables/Cards/Buttons/BeatmapCardIconButton.cs
index e362e3abeb..02c9ea640a 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/Buttons/BeatmapCardIconButton.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/Buttons/BeatmapCardIconButton.cs
@@ -115,7 +115,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards.Buttons
             bool isHovered = IsHovered && Enabled.Value;
 
             content.ScaleTo(isHovered ? 1.2f : 1, 500, Easing.OutQuint);
-            content.FadeColour(isHovered ? HoverColour : IdleColour, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
+            content.FadeColour(isHovered ? HoverColour : IdleColour, BeatmapCardBase.TRANSITION_DURATION, Easing.OutQuint);
         }
     }
 }
diff --git a/osu.Game/Beatmaps/Drawables/Cards/Buttons/DownloadButton.cs b/osu.Game/Beatmaps/Drawables/Cards/Buttons/DownloadButton.cs
index c94e335e8f..d7ba4af21e 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/Buttons/DownloadButton.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/Buttons/DownloadButton.cs
@@ -69,7 +69,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards.Buttons
                 case DownloadState.LocallyAvailable:
                     Action = null;
                     TooltipText = string.Empty;
-                    this.FadeOut(BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
+                    this.FadeOut(BeatmapCardBase.TRANSITION_DURATION, Easing.OutQuint);
                     break;
 
                 case DownloadState.NotDownloaded:
@@ -81,7 +81,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards.Buttons
                     }
 
                     Action = () => beatmaps.Download(beatmapSet, preferNoVideo.Value);
-                    this.FadeIn(BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
+                    this.FadeIn(BeatmapCardBase.TRANSITION_DURATION, Easing.OutQuint);
                     spinner.Hide();
                     Icon.Show();
 
diff --git a/osu.Game/Beatmaps/Drawables/Cards/Buttons/GoToBeatmapButton.cs b/osu.Game/Beatmaps/Drawables/Cards/Buttons/GoToBeatmapButton.cs
index 9a6a3c01b7..b039eb6f10 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/Buttons/GoToBeatmapButton.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/Buttons/GoToBeatmapButton.cs
@@ -43,7 +43,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards.Buttons
 
         private void updateState()
         {
-            this.FadeTo(state.Value == DownloadState.LocallyAvailable ? 1 : 0, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
+            this.FadeTo(state.Value == DownloadState.LocallyAvailable ? 1 : 0, BeatmapCardBase.TRANSITION_DURATION, Easing.OutQuint);
         }
     }
 }
diff --git a/osu.Game/Beatmaps/Drawables/Cards/Buttons/PlayButton.cs b/osu.Game/Beatmaps/Drawables/Cards/Buttons/PlayButton.cs
index f7bab26666..6d66d5001a 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/Buttons/PlayButton.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/Buttons/PlayButton.cs
@@ -141,7 +141,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards.Buttons
         private void toggleLoading(bool loading)
         {
             Enabled.Value = !loading;
-            icon.FadeTo(loading ? 0 : 1, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
+            icon.FadeTo(loading ? 0 : 1, BeatmapCardBase.TRANSITION_DURATION, Easing.OutQuint);
             loadingSpinner.State.Value = loading ? Visibility.Visible : Visibility.Hidden;
         }
     }
diff --git a/osu.Game/Beatmaps/Drawables/Cards/CollapsibleButtonContainer.cs b/osu.Game/Beatmaps/Drawables/Cards/CollapsibleButtonContainer.cs
index 3a2cb80a8d..e1a630182f 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/CollapsibleButtonContainer.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/CollapsibleButtonContainer.cs
@@ -78,7 +78,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
 
             RelativeSizeAxes = Axes.Y;
             Masking = true;
-            CornerRadius = BeatmapCard.CORNER_RADIUS;
+            CornerRadius = BeatmapCardBase.CORNER_RADIUS;
 
             InternalChildren = new Drawable[]
             {
@@ -133,7 +133,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                 {
                     Name = @"Main content",
                     RelativeSizeAxes = Axes.Y,
-                    CornerRadius = BeatmapCard.CORNER_RADIUS,
+                    CornerRadius = BeatmapCardBase.CORNER_RADIUS,
                     Masking = true,
                     Children = new Drawable[]
                     {
@@ -169,10 +169,10 @@ namespace osu.Game.Beatmaps.Drawables.Cards
         {
             float targetWidth = Width - (ShowDetails.Value ? ButtonsExpandedWidth : ButtonsCollapsedWidth);
 
-            mainArea.ResizeWidthTo(targetWidth, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
+            mainArea.ResizeWidthTo(targetWidth, BeatmapCardBase.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);
+            background.FadeColour(downloadTracker.State.Value == DownloadState.LocallyAvailable ? colours.Lime0 : colourProvider.Background3, BeatmapCardBase.TRANSITION_DURATION, Easing.OutQuint);
+            buttons.FadeTo(ShowDetails.Value ? 1 : 0, BeatmapCardBase.TRANSITION_DURATION, Easing.OutQuint);
 
             foreach (var button in buttons)
             {

From 33e930f47786c5edad0d003fdee13aaf10f079cc Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 17 Dec 2021 13:29:20 +0100
Subject: [PATCH 1709/5547] Move scale-on-expand logic to `BeatmapCardContent`

---
 osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs        | 4 ----
 osu.Game/Beatmaps/Drawables/Cards/BeatmapCardContent.cs | 4 ++++
 osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtra.cs   | 4 ----
 3 files changed, 4 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
index b0df2e40d3..a3b4c4c86c 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
@@ -280,10 +280,6 @@ namespace osu.Game.Beatmaps.Drawables.Cards
             buttonContainer.ShowDetails.Value = showDetails;
             thumbnail.Dimmed.Value = showDetails;
 
-            // Scale value is intentionally chosen to fit in the spacing of listing displays, as to not overlap horizontally with adjacent cards.
-            // This avoids depth issues where a hovered (scaled) card to the right of another card would be beneath the card to the left.
-            content.ScaleTo(Expanded.Value ? 1.03f : 1, 500, Easing.OutQuint);
-
             statisticsContainer.FadeTo(showDetails ? 1 : 0, TRANSITION_DURATION, Easing.OutQuint);
         }
     }
diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardContent.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardContent.cs
index e16421503c..9c43c16100 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardContent.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardContent.cs
@@ -139,6 +139,10 @@ namespace osu.Game.Beatmaps.Drawables.Cards
 
         private void updateState()
         {
+            // Scale value is intentionally chosen to fit in the spacing of listing displays, as to not overlap horizontally with adjacent cards.
+            // This avoids depth issues where a hovered (scaled) card to the right of another card would be beneath the card to the left.
+            this.ScaleTo(Expanded.Value ? 1.03f : 1, 500, Easing.OutQuint);
+
             background.FadeTo(Expanded.Value ? 1 : 0, BeatmapCardBase.TRANSITION_DURATION, Easing.OutQuint);
             dropdownContent.FadeTo(Expanded.Value ? 1 : 0, BeatmapCardBase.TRANSITION_DURATION, Easing.OutQuint);
             borderContainer.FadeTo(Expanded.Value ? 1 : 0, BeatmapCardBase.TRANSITION_DURATION, Easing.OutQuint);
diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtra.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtra.cs
index 39acbb352d..308cba9f0f 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtra.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtra.cs
@@ -312,10 +312,6 @@ namespace osu.Game.Beatmaps.Drawables.Cards
 
             buttonContainer.ShowDetails.Value = showDetails;
             thumbnail.Dimmed.Value = showDetails;
-
-            // Scale value is intentionally chosen to fit in the spacing of listing displays, as to not overlap horizontally with adjacent cards.
-            // This avoids depth issues where a hovered (scaled) card to the right of another card would be beneath the card to the left.
-            content.ScaleTo(Expanded.Value ? 1.03f : 1, 500, Easing.OutQuint);
         }
     }
 }

From 2f2006715eab49d36b0205ea72f6fa75f4d6c69f Mon Sep 17 00:00:00 2001
From: StanR <hi@stanr.info>
Date: Fri, 17 Dec 2021 23:39:03 +0300
Subject: [PATCH 1710/5547] Slightly refactor difficulty and pp calculators

---
 .../Difficulty/CatchPerformanceCalculator.cs  |  6 +++
 .../Difficulty/ManiaDifficultyAttributes.cs   |  4 +-
 .../Difficulty/ManiaPerformanceCalculator.cs  | 39 ++++++++++---------
 .../Difficulty/OsuDifficultyAttributes.cs     | 28 ++++++-------
 .../Difficulty/OsuDifficultyCalculator.cs     |  6 +--
 .../Difficulty/OsuPerformanceCalculator.cs    | 25 ++++++------
 .../Difficulty/TaikoDifficultyAttributes.cs   | 16 ++++----
 .../Difficulty/TaikoDifficultyCalculator.cs   |  6 +--
 .../Difficulty/TaikoPerformanceCalculator.cs  | 25 ++++++------
 .../Difficulty/DifficultyAttributes.cs        |  2 +-
 10 files changed, 85 insertions(+), 72 deletions(-)

diff --git a/osu.Game.Rulesets.Catch/Difficulty/CatchPerformanceCalculator.cs b/osu.Game.Rulesets.Catch/Difficulty/CatchPerformanceCalculator.cs
index 439890dac2..d3f3445ff1 100644
--- a/osu.Game.Rulesets.Catch/Difficulty/CatchPerformanceCalculator.cs
+++ b/osu.Game.Rulesets.Catch/Difficulty/CatchPerformanceCalculator.cs
@@ -90,6 +90,12 @@ namespace osu.Game.Rulesets.Catch.Difficulty
             if (mods.Any(m => m is ModNoFail))
                 value *= 0.90;
 
+            if (categoryDifficulty != null)
+            {
+                categoryDifficulty.Add("AR", Attributes.ApproachRate);
+                categoryDifficulty.Add("Max Combo", Attributes.MaxCombo);
+            }
+
             return value;
         }
 
diff --git a/osu.Game.Rulesets.Mania/Difficulty/ManiaDifficultyAttributes.cs b/osu.Game.Rulesets.Mania/Difficulty/ManiaDifficultyAttributes.cs
index bfdef893e9..979a04ddf8 100644
--- a/osu.Game.Rulesets.Mania/Difficulty/ManiaDifficultyAttributes.cs
+++ b/osu.Game.Rulesets.Mania/Difficulty/ManiaDifficultyAttributes.cs
@@ -21,7 +21,7 @@ namespace osu.Game.Rulesets.Mania.Difficulty
                 yield return v;
 
             // Todo: osu!mania doesn't output MaxCombo attribute for some reason.
-            yield return (ATTRIB_ID_STRAIN, StarRating);
+            yield return (ATTRIB_ID_DIFFICULTY, StarRating);
             yield return (ATTRIB_ID_GREAT_HIT_WINDOW, GreatHitWindow);
             yield return (ATTRIB_ID_SCORE_MULTIPLIER, ScoreMultiplier);
         }
@@ -30,7 +30,7 @@ namespace osu.Game.Rulesets.Mania.Difficulty
         {
             base.FromDatabaseAttributes(values);
 
-            StarRating = values[ATTRIB_ID_STRAIN];
+            StarRating = values[ATTRIB_ID_DIFFICULTY];
             GreatHitWindow = values[ATTRIB_ID_GREAT_HIT_WINDOW];
             ScoreMultiplier = values[ATTRIB_ID_SCORE_MULTIPLIER];
         }
diff --git a/osu.Game.Rulesets.Mania/Difficulty/ManiaPerformanceCalculator.cs b/osu.Game.Rulesets.Mania/Difficulty/ManiaPerformanceCalculator.cs
index b04ff3548f..6bf0a5acb4 100644
--- a/osu.Game.Rulesets.Mania/Difficulty/ManiaPerformanceCalculator.cs
+++ b/osu.Game.Rulesets.Mania/Difficulty/ManiaPerformanceCalculator.cs
@@ -61,48 +61,51 @@ namespace osu.Game.Rulesets.Mania.Difficulty
             if (mods.Any(m => m is ModEasy))
                 multiplier *= 0.5;
 
-            double strainValue = computeStrainValue();
-            double accValue = computeAccuracyValue(strainValue);
+            double difficultyValue = computeDifficultyValue();
+            double accValue = computeAccuracyValue(difficultyValue);
             double totalValue =
                 Math.Pow(
-                    Math.Pow(strainValue, 1.1) +
+                    Math.Pow(difficultyValue, 1.1) +
                     Math.Pow(accValue, 1.1), 1.0 / 1.1
                 ) * multiplier;
 
             if (categoryDifficulty != null)
             {
-                categoryDifficulty["Strain"] = strainValue;
-                categoryDifficulty["Accuracy"] = accValue;
+                categoryDifficulty.Add("Difficulty", difficultyValue);
+                categoryDifficulty.Add("Accuracy", accValue);
+                categoryDifficulty.Add("Scaled Score", scaledScore);
+                categoryDifficulty.Add("Great Hit Window", Attributes.GreatHitWindow);
+                categoryDifficulty.Add("Max Combo", Attributes.MaxCombo);
             }
 
             return totalValue;
         }
 
-        private double computeStrainValue()
+        private double computeDifficultyValue()
         {
-            // Obtain strain difficulty
-            double strainValue = Math.Pow(5 * Math.Max(1, Attributes.StarRating / 0.2) - 4.0, 2.2) / 135.0;
+            // Obtain difficulty
+            double difficultyValue = Math.Pow(5 * Math.Max(1, Attributes.StarRating / 0.2) - 4.0, 2.2) / 135.0;
 
             // Longer maps are worth more
-            strainValue *= 1.0 + 0.1 * Math.Min(1.0, totalHits / 1500.0);
+            difficultyValue *= 1.0 + 0.1 * Math.Min(1.0, totalHits / 1500.0);
 
             if (scaledScore <= 500000)
-                strainValue = 0;
+                difficultyValue = 0;
             else if (scaledScore <= 600000)
-                strainValue *= (scaledScore - 500000) / 100000 * 0.3;
+                difficultyValue *= (scaledScore - 500000) / 100000 * 0.3;
             else if (scaledScore <= 700000)
-                strainValue *= 0.3 + (scaledScore - 600000) / 100000 * 0.25;
+                difficultyValue *= 0.3 + (scaledScore - 600000) / 100000 * 0.25;
             else if (scaledScore <= 800000)
-                strainValue *= 0.55 + (scaledScore - 700000) / 100000 * 0.20;
+                difficultyValue *= 0.55 + (scaledScore - 700000) / 100000 * 0.20;
             else if (scaledScore <= 900000)
-                strainValue *= 0.75 + (scaledScore - 800000) / 100000 * 0.15;
+                difficultyValue *= 0.75 + (scaledScore - 800000) / 100000 * 0.15;
             else
-                strainValue *= 0.90 + (scaledScore - 900000) / 100000 * 0.1;
+                difficultyValue *= 0.90 + (scaledScore - 900000) / 100000 * 0.1;
 
-            return strainValue;
+            return difficultyValue;
         }
 
-        private double computeAccuracyValue(double strainValue)
+        private double computeAccuracyValue(double difficultyValue)
         {
             if (Attributes.GreatHitWindow <= 0)
                 return 0;
@@ -110,7 +113,7 @@ namespace osu.Game.Rulesets.Mania.Difficulty
             // Lots of arbitrary values from testing.
             // Considering to use derivation from perfect accuracy in a probabilistic manner - assume normal distribution
             double accuracyValue = Math.Max(0.0, 0.2 - (Attributes.GreatHitWindow - 34) * 0.006667)
-                                   * strainValue
+                                   * difficultyValue
                                    * Math.Pow(Math.Max(0.0, scaledScore - 960000) / 40000, 1.1);
 
             // Bonus for many hitcircles - it's harder to keep good accuracy up for longer
diff --git a/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyAttributes.cs b/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyAttributes.cs
index 4b2e54da17..128ff772fd 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyAttributes.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyAttributes.cs
@@ -12,14 +12,14 @@ namespace osu.Game.Rulesets.Osu.Difficulty
 {
     public class OsuDifficultyAttributes : DifficultyAttributes
     {
-        [JsonProperty("aim_strain")]
-        public double AimStrain { get; set; }
+        [JsonProperty("aim_difficulty")]
+        public double AimDifficulty { get; set; }
 
-        [JsonProperty("speed_strain")]
-        public double SpeedStrain { get; set; }
+        [JsonProperty("speed_difficulty")]
+        public double SpeedDifficulty { get; set; }
 
-        [JsonProperty("flashlight_rating")]
-        public double FlashlightRating { get; set; }
+        [JsonProperty("flashlight_difficulty")]
+        public double FlashlightDifficulty { get; set; }
 
         [JsonProperty("slider_factor")]
         public double SliderFactor { get; set; }
@@ -43,15 +43,15 @@ namespace osu.Game.Rulesets.Osu.Difficulty
             foreach (var v in base.ToDatabaseAttributes())
                 yield return v;
 
-            yield return (ATTRIB_ID_AIM, AimStrain);
-            yield return (ATTRIB_ID_SPEED, SpeedStrain);
+            yield return (ATTRIB_ID_AIM, AimDifficulty);
+            yield return (ATTRIB_ID_SPEED, SpeedDifficulty);
             yield return (ATTRIB_ID_OVERALL_DIFFICULTY, OverallDifficulty);
             yield return (ATTRIB_ID_APPROACH_RATE, ApproachRate);
             yield return (ATTRIB_ID_MAX_COMBO, MaxCombo);
-            yield return (ATTRIB_ID_STRAIN, StarRating);
+            yield return (ATTRIB_ID_DIFFICULTY, StarRating);
 
             if (ShouldSerializeFlashlightRating())
-                yield return (ATTRIB_ID_FLASHLIGHT, FlashlightRating);
+                yield return (ATTRIB_ID_FLASHLIGHT, FlashlightDifficulty);
 
             yield return (ATTRIB_ID_SLIDER_FACTOR, SliderFactor);
         }
@@ -60,13 +60,13 @@ namespace osu.Game.Rulesets.Osu.Difficulty
         {
             base.FromDatabaseAttributes(values);
 
-            AimStrain = values[ATTRIB_ID_AIM];
-            SpeedStrain = values[ATTRIB_ID_SPEED];
+            AimDifficulty = values[ATTRIB_ID_AIM];
+            SpeedDifficulty = values[ATTRIB_ID_SPEED];
             OverallDifficulty = values[ATTRIB_ID_OVERALL_DIFFICULTY];
             ApproachRate = values[ATTRIB_ID_APPROACH_RATE];
             MaxCombo = (int)values[ATTRIB_ID_MAX_COMBO];
-            StarRating = values[ATTRIB_ID_STRAIN];
-            FlashlightRating = values.GetValueOrDefault(ATTRIB_ID_FLASHLIGHT);
+            StarRating = values[ATTRIB_ID_DIFFICULTY];
+            FlashlightDifficulty = values.GetValueOrDefault(ATTRIB_ID_FLASHLIGHT);
             SliderFactor = values[ATTRIB_ID_SLIDER_FACTOR];
         }
 
diff --git a/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs b/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs
index ed42f333c0..c5b1baaad1 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs
@@ -74,9 +74,9 @@ namespace osu.Game.Rulesets.Osu.Difficulty
             {
                 StarRating = starRating,
                 Mods = mods,
-                AimStrain = aimRating,
-                SpeedStrain = speedRating,
-                FlashlightRating = flashlightRating,
+                AimDifficulty = aimRating,
+                SpeedDifficulty = speedRating,
+                FlashlightDifficulty = flashlightRating,
                 SliderFactor = sliderFactor,
                 ApproachRate = preempt > 1200 ? (1800 - preempt) / 120 : (1200 - preempt) / 150 + 5,
                 OverallDifficulty = (80 - hitWindowGreat) / 6,
diff --git a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
index 8d45c7a8cc..96c92bdb0d 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
@@ -32,7 +32,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty
         {
         }
 
-        public override double Calculate(Dictionary<string, double> categoryRatings = null)
+        public override double Calculate(Dictionary<string, double> categoryDifficulty = null)
         {
             mods = Score.Mods;
             accuracy = Score.Accuracy;
@@ -72,15 +72,16 @@ namespace osu.Game.Rulesets.Osu.Difficulty
                     Math.Pow(flashlightValue, 1.1), 1.0 / 1.1
                 ) * multiplier;
 
-            if (categoryRatings != null)
+            if (categoryDifficulty != null)
             {
-                categoryRatings.Add("Aim", aimValue);
-                categoryRatings.Add("Speed", speedValue);
-                categoryRatings.Add("Accuracy", accuracyValue);
-                categoryRatings.Add("Flashlight", flashlightValue);
-                categoryRatings.Add("OD", Attributes.OverallDifficulty);
-                categoryRatings.Add("AR", Attributes.ApproachRate);
-                categoryRatings.Add("Max Combo", Attributes.MaxCombo);
+                categoryDifficulty.Add("Aim", aimValue);
+                categoryDifficulty.Add("Speed", speedValue);
+                categoryDifficulty.Add("Accuracy", accuracyValue);
+                categoryDifficulty.Add("Flashlight", flashlightValue);
+                categoryDifficulty.Add("OD", Attributes.OverallDifficulty);
+                categoryDifficulty.Add("AR", Attributes.ApproachRate);
+                categoryDifficulty.Add("Max Combo", Attributes.MaxCombo);
+                categoryDifficulty.Add("Effective Miss Count", effectiveMissCount);
             }
 
             return totalValue;
@@ -88,7 +89,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty
 
         private double computeAimValue()
         {
-            double rawAim = Attributes.AimStrain;
+            double rawAim = Attributes.AimDifficulty;
 
             if (mods.Any(m => m is OsuModTouchDevice))
                 rawAim = Math.Pow(rawAim, 0.8);
@@ -144,7 +145,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty
 
         private double computeSpeedValue()
         {
-            double speedValue = Math.Pow(5.0 * Math.Max(1.0, Attributes.SpeedStrain / 0.0675) - 4.0, 3.0) / 100000.0;
+            double speedValue = Math.Pow(5.0 * Math.Max(1.0, Attributes.SpeedDifficulty / 0.0675) - 4.0, 3.0) / 100000.0;
 
             // Longer maps are worth more.
             double lengthBonus = 0.95 + 0.4 * Math.Min(1.0, totalHits / 2000.0) +
@@ -227,7 +228,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty
             if (!mods.Any(h => h is OsuModFlashlight))
                 return 0.0;
 
-            double rawFlashlight = Attributes.FlashlightRating;
+            double rawFlashlight = Attributes.FlashlightDifficulty;
 
             if (mods.Any(m => m is OsuModTouchDevice))
                 rawFlashlight = Math.Pow(rawFlashlight, 0.8);
diff --git a/osu.Game.Rulesets.Taiko/Difficulty/TaikoDifficultyAttributes.cs b/osu.Game.Rulesets.Taiko/Difficulty/TaikoDifficultyAttributes.cs
index b2b5d056c3..31f5a6f570 100644
--- a/osu.Game.Rulesets.Taiko/Difficulty/TaikoDifficultyAttributes.cs
+++ b/osu.Game.Rulesets.Taiko/Difficulty/TaikoDifficultyAttributes.cs
@@ -9,14 +9,14 @@ namespace osu.Game.Rulesets.Taiko.Difficulty
 {
     public class TaikoDifficultyAttributes : DifficultyAttributes
     {
-        [JsonProperty("stamina_strain")]
-        public double StaminaStrain { get; set; }
+        [JsonProperty("stamina_difficulty")]
+        public double StaminaDifficulty { get; set; }
 
-        [JsonProperty("rhythm_strain")]
-        public double RhythmStrain { get; set; }
+        [JsonProperty("rhythm_difficulty")]
+        public double RhythmDifficulty { get; set; }
 
-        [JsonProperty("colour_strain")]
-        public double ColourStrain { get; set; }
+        [JsonProperty("colour_difficulty")]
+        public double ColourDifficulty { get; set; }
 
         [JsonProperty("approach_rate")]
         public double ApproachRate { get; set; }
@@ -30,7 +30,7 @@ namespace osu.Game.Rulesets.Taiko.Difficulty
                 yield return v;
 
             yield return (ATTRIB_ID_MAX_COMBO, MaxCombo);
-            yield return (ATTRIB_ID_STRAIN, StarRating);
+            yield return (ATTRIB_ID_DIFFICULTY, StarRating);
             yield return (ATTRIB_ID_GREAT_HIT_WINDOW, GreatHitWindow);
         }
 
@@ -39,7 +39,7 @@ namespace osu.Game.Rulesets.Taiko.Difficulty
             base.FromDatabaseAttributes(values);
 
             MaxCombo = (int)values[ATTRIB_ID_MAX_COMBO];
-            StarRating = values[ATTRIB_ID_STRAIN];
+            StarRating = values[ATTRIB_ID_DIFFICULTY];
             GreatHitWindow = values[ATTRIB_ID_GREAT_HIT_WINDOW];
         }
     }
diff --git a/osu.Game.Rulesets.Taiko/Difficulty/TaikoDifficultyCalculator.cs b/osu.Game.Rulesets.Taiko/Difficulty/TaikoDifficultyCalculator.cs
index e84bee3d28..6afdef3f3c 100644
--- a/osu.Game.Rulesets.Taiko/Difficulty/TaikoDifficultyCalculator.cs
+++ b/osu.Game.Rulesets.Taiko/Difficulty/TaikoDifficultyCalculator.cs
@@ -91,9 +91,9 @@ namespace osu.Game.Rulesets.Taiko.Difficulty
             {
                 StarRating = starRating,
                 Mods = mods,
-                StaminaStrain = staminaRating,
-                RhythmStrain = rhythmRating,
-                ColourStrain = colourRating,
+                StaminaDifficulty = staminaRating,
+                RhythmDifficulty = rhythmRating,
+                ColourDifficulty = colourRating,
                 GreatHitWindow = hitWindows.WindowFor(HitResult.Great) / clockRate,
                 MaxCombo = beatmap.HitObjects.Count(h => h is Hit),
             };
diff --git a/osu.Game.Rulesets.Taiko/Difficulty/TaikoPerformanceCalculator.cs b/osu.Game.Rulesets.Taiko/Difficulty/TaikoPerformanceCalculator.cs
index 90dd733dfd..d287998f3b 100644
--- a/osu.Game.Rulesets.Taiko/Difficulty/TaikoPerformanceCalculator.cs
+++ b/osu.Game.Rulesets.Taiko/Difficulty/TaikoPerformanceCalculator.cs
@@ -44,43 +44,46 @@ namespace osu.Game.Rulesets.Taiko.Difficulty
             if (mods.Any(m => m is ModHidden))
                 multiplier *= 1.10;
 
-            double strainValue = computeStrainValue();
+            double difficultyValue = computeDifficultyValue();
             double accuracyValue = computeAccuracyValue();
             double totalValue =
                 Math.Pow(
-                    Math.Pow(strainValue, 1.1) +
+                    Math.Pow(difficultyValue, 1.1) +
                     Math.Pow(accuracyValue, 1.1), 1.0 / 1.1
                 ) * multiplier;
 
             if (categoryDifficulty != null)
             {
-                categoryDifficulty["Strain"] = strainValue;
-                categoryDifficulty["Accuracy"] = accuracyValue;
+                categoryDifficulty.Add("Difficulty", difficultyValue);
+                categoryDifficulty.Add("Accuracy", accuracyValue);
+                categoryDifficulty.Add("AR", Attributes.ApproachRate);
+                categoryDifficulty.Add("Great Hit Window", Attributes.GreatHitWindow);
+                categoryDifficulty.Add("Max Combo", Attributes.MaxCombo);
             }
 
             return totalValue;
         }
 
-        private double computeStrainValue()
+        private double computeDifficultyValue()
         {
-            double strainValue = Math.Pow(5.0 * Math.Max(1.0, Attributes.StarRating / 0.0075) - 4.0, 2.0) / 100000.0;
+            double difficultyValue = Math.Pow(5.0 * Math.Max(1.0, Attributes.StarRating / 0.0075) - 4.0, 2.0) / 100000.0;
 
             // Longer maps are worth more
             double lengthBonus = 1 + 0.1 * Math.Min(1.0, totalHits / 1500.0);
-            strainValue *= lengthBonus;
+            difficultyValue *= lengthBonus;
 
             // Penalize misses exponentially. This mainly fixes tag4 maps and the likes until a per-hitobject solution is available
-            strainValue *= Math.Pow(0.985, countMiss);
+            difficultyValue *= Math.Pow(0.985, countMiss);
 
             if (mods.Any(m => m is ModHidden))
-                strainValue *= 1.025;
+                difficultyValue *= 1.025;
 
             if (mods.Any(m => m is ModFlashlight<TaikoHitObject>))
                 // Apply length bonus again if flashlight is on simply because it becomes a lot harder on longer maps.
-                strainValue *= 1.05 * lengthBonus;
+                difficultyValue *= 1.05 * lengthBonus;
 
             // Scale the speed value with accuracy _slightly_
-            return strainValue * Score.Accuracy;
+            return difficultyValue * Score.Accuracy;
         }
 
         private double computeAccuracyValue()
diff --git a/osu.Game/Rulesets/Difficulty/DifficultyAttributes.cs b/osu.Game/Rulesets/Difficulty/DifficultyAttributes.cs
index 47736ee033..991b567f57 100644
--- a/osu.Game/Rulesets/Difficulty/DifficultyAttributes.cs
+++ b/osu.Game/Rulesets/Difficulty/DifficultyAttributes.cs
@@ -19,7 +19,7 @@ namespace osu.Game.Rulesets.Difficulty
         protected const int ATTRIB_ID_OVERALL_DIFFICULTY = 5;
         protected const int ATTRIB_ID_APPROACH_RATE = 7;
         protected const int ATTRIB_ID_MAX_COMBO = 9;
-        protected const int ATTRIB_ID_STRAIN = 11;
+        protected const int ATTRIB_ID_DIFFICULTY = 11;
         protected const int ATTRIB_ID_GREAT_HIT_WINDOW = 13;
         protected const int ATTRIB_ID_SCORE_MULTIPLIER = 15;
         protected const int ATTRIB_ID_FLASHLIGHT = 17;

From 04cfae9bdeb525855a34527a217e8b2cba34b115 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 18 Dec 2021 16:26:15 +0900
Subject: [PATCH 1711/5547] Fix "Random Skin" text not showing up correctly

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

diff --git a/osu.Game/Database/RealmLiveUnmanaged.cs b/osu.Game/Database/RealmLiveUnmanaged.cs
index 5a69898206..ea50ccc1ff 100644
--- a/osu.Game/Database/RealmLiveUnmanaged.cs
+++ b/osu.Game/Database/RealmLiveUnmanaged.cs
@@ -26,6 +26,8 @@ namespace osu.Game.Database
 
         public bool Equals(ILive<T>? other) => ID == other?.ID;
 
+        public override string ToString() => Value.ToString();
+
         public Guid ID => Value.ID;
 
         public void PerformRead(Action<T> perform) => perform(Value);

From c11217755987abbe9ca0c63ad832f6839463647e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 19 Dec 2021 12:48:09 +0100
Subject: [PATCH 1712/5547] Bring profile header test in line with modern
 conventions

- Removed online code that didn't work anyway after the introduction of
  the development web instance.

- Removed some weird test steps.

- Fixed online/offline test steps not working at all due to identical
  user ID.
---
 .../Online/TestSceneUserProfileHeader.cs      | 73 +++++--------------
 1 file changed, 20 insertions(+), 53 deletions(-)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneUserProfileHeader.cs b/osu.Game.Tests/Visual/Online/TestSceneUserProfileHeader.cs
index 76997bded7..c319d2f7de 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneUserProfileHeader.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneUserProfileHeader.cs
@@ -2,85 +2,52 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
+using NUnit.Framework;
 using osu.Framework.Allocation;
-using osu.Game.Online.API;
-using osu.Game.Online.API.Requests;
+using osu.Framework.Testing;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays;
 using osu.Game.Overlays.Profile;
-using osu.Game.Users;
 
 namespace osu.Game.Tests.Visual.Online
 {
     public class TestSceneUserProfileHeader : OsuTestScene
     {
-        protected override bool UseOnlineAPI => true;
-
         [Cached]
         private readonly OverlayColourProvider colourProvider = new OverlayColourProvider(OverlayColourScheme.Green);
 
-        [Resolved]
-        private IAPIProvider api { get; set; }
+        private ProfileHeader header;
 
-        private readonly ProfileHeader header;
-
-        public TestSceneUserProfileHeader()
+        [SetUpSteps]
+        public void SetUpSteps()
         {
-            header = new ProfileHeader();
-            Add(header);
+            AddStep("create header", () => Child = header = new ProfileHeader());
+        }
 
-            AddStep("Show test dummy", () => header.User.Value = TestSceneUserProfileOverlay.TEST_USER);
+        [Test]
+        public void TestBasic()
+        {
+            AddStep("Show example user", () => header.User.Value = TestSceneUserProfileOverlay.TEST_USER);
+        }
 
-            AddStep("Show null dummy", () => header.User.Value = new APIUser
-            {
-                Username = "Null"
-            });
-
-            AddStep("Show online dummy", () => header.User.Value = new APIUser
+        [Test]
+        public void TestOnlineState()
+        {
+            AddStep("Show online user", () => header.User.Value = new APIUser
             {
+                Id = 1001,
                 Username = "IAmOnline",
                 LastVisit = DateTimeOffset.Now,
                 IsOnline = true,
             });
 
-            AddStep("Show offline dummy", () => header.User.Value = new APIUser
+            AddStep("Show offline user", () => header.User.Value = new APIUser
             {
+                Id = 1002,
                 Username = "IAmOffline",
-                LastVisit = DateTimeOffset.Now,
+                LastVisit = DateTimeOffset.Now.AddDays(-10),
                 IsOnline = false,
             });
-
-            addOnlineStep("Show ppy", new APIUser
-            {
-                Username = @"peppy",
-                Id = 2,
-                IsSupporter = true,
-                Country = new Country { FullName = @"Australia", FlagName = @"AU" },
-                CoverUrl = @"https://osu.ppy.sh/images/headers/profile-covers/c3.jpg"
-            });
-
-            addOnlineStep("Show flyte", new APIUser
-            {
-                Username = @"flyte",
-                Id = 3103765,
-                Country = new Country { FullName = @"Japan", FlagName = @"JP" },
-                CoverUrl = @"https://osu.ppy.sh/images/headers/profile-covers/c6.jpg"
-            });
-        }
-
-        private void addOnlineStep(string name, APIUser fallback)
-        {
-            AddStep(name, () =>
-            {
-                if (api.IsLoggedIn)
-                {
-                    var request = new GetUserRequest(fallback.Id);
-                    request.Success += user => header.User.Value = user;
-                    api.Queue(request);
-                }
-                else
-                    header.User.Value = fallback;
-            });
         }
     }
 }

From 097402677d131f96aca3031c13876a5d927bcfb4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 19 Dec 2021 12:55:24 +0100
Subject: [PATCH 1713/5547] Add test for ranked/unranked user display

---
 .../Online/TestSceneUserProfileHeader.cs      | 39 +++++++++++++++++++
 .../Online/TestSceneUserProfileOverlay.cs     |  1 +
 osu.Game/Users/UserStatistics.cs              |  3 ++
 3 files changed, 43 insertions(+)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneUserProfileHeader.cs b/osu.Game.Tests/Visual/Online/TestSceneUserProfileHeader.cs
index c319d2f7de..dda9543159 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneUserProfileHeader.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneUserProfileHeader.cs
@@ -2,12 +2,14 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
+using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Testing;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays;
 using osu.Game.Overlays.Profile;
+using osu.Game.Users;
 
 namespace osu.Game.Tests.Visual.Online
 {
@@ -49,5 +51,42 @@ namespace osu.Game.Tests.Visual.Online
                 IsOnline = false,
             });
         }
+
+        [Test]
+        public void TestRankedState()
+        {
+            AddStep("Show ranked user", () => header.User.Value = new APIUser
+            {
+                Id = 2001,
+                Username = "RankedUser",
+                Statistics = new UserStatistics
+                {
+                    IsRanked = true,
+                    GlobalRank = 15000,
+                    CountryRank = 1500,
+                    RankHistory = new APIRankHistory
+                    {
+                        Mode = @"osu",
+                        Data = Enumerable.Range(2345, 45).Concat(Enumerable.Range(2109, 40)).ToArray()
+                    },
+                }
+            });
+
+            AddStep("Show unranked user", () => header.User.Value = new APIUser
+            {
+                Id = 2002,
+                Username = "UnrankedUser",
+                Statistics = new UserStatistics
+                {
+                    IsRanked = false,
+                    // web will sometimes return non-empty rank history even for unranked users.
+                    RankHistory = new APIRankHistory
+                    {
+                        Mode = @"osu",
+                        Data = Enumerable.Range(2345, 85).ToArray()
+                    },
+                }
+            });
+        }
     }
 }
diff --git a/osu.Game.Tests/Visual/Online/TestSceneUserProfileOverlay.cs b/osu.Game.Tests/Visual/Online/TestSceneUserProfileOverlay.cs
index 1c92bb1e38..78e2ceb45b 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneUserProfileOverlay.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneUserProfileOverlay.cs
@@ -29,6 +29,7 @@ namespace osu.Game.Tests.Visual.Online
             ProfileOrder = new[] { "me" },
             Statistics = new UserStatistics
             {
+                IsRanked = true,
                 GlobalRank = 2148,
                 CountryRank = 1,
                 PP = 4567.89m,
diff --git a/osu.Game/Users/UserStatistics.cs b/osu.Game/Users/UserStatistics.cs
index c690447256..f8d26fe421 100644
--- a/osu.Game/Users/UserStatistics.cs
+++ b/osu.Game/Users/UserStatistics.cs
@@ -27,6 +27,9 @@ namespace osu.Game.Users
             public int Progress;
         }
 
+        [JsonProperty(@"is_ranked")]
+        public bool IsRanked;
+
         [JsonProperty(@"global_rank")]
         public int? GlobalRank;
 

From a6ccbafc77ead8416a8ea6f10407bd30db186046 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 19 Dec 2021 13:19:00 +0100
Subject: [PATCH 1714/5547] Fix rank graph showing for unranked users

---
 osu.Game/Overlays/Profile/Header/Components/RankGraph.cs | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/Profile/Header/Components/RankGraph.cs b/osu.Game/Overlays/Profile/Header/Components/RankGraph.cs
index d6e515d8a1..d195babcbf 100644
--- a/osu.Game/Overlays/Profile/Header/Components/RankGraph.cs
+++ b/osu.Game/Overlays/Profile/Header/Components/RankGraph.cs
@@ -42,7 +42,9 @@ namespace osu.Game.Overlays.Profile.Header.Components
 
         private void updateStatistics(UserStatistics statistics)
         {
-            int[] userRanks = statistics?.RankHistory?.Data;
+            // checking both IsRanked and RankHistory is required.
+            // see https://github.com/ppy/osu-web/blob/154ceafba0f35a1dd935df53ec98ae2ea5615f9f/resources/assets/lib/profile-page/rank-chart.tsx#L46
+            int[] userRanks = statistics?.IsRanked == true ? statistics.RankHistory?.Data : null;
             Data = userRanks?.Select((x, index) => new KeyValuePair<int, int>(index, x)).Where(x => x.Value != 0).ToArray();
         }
 

From 1203ae5984ca1c399f5c876a2cee6b4900466e5f Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Mon, 20 Dec 2021 11:49:39 +0900
Subject: [PATCH 1715/5547] Require installing .NET 5 in README

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 24b70b2de6..f18c5e76f9 100644
--- a/README.md
+++ b/README.md
@@ -48,7 +48,7 @@ You can see some examples of custom rulesets by visiting the [custom ruleset dir
 
 Please make sure you have the following prerequisites:
 
-- A desktop platform with the [.NET 5.0 SDK](https://dotnet.microsoft.com/download) or higher installed.
+- A desktop platform with the [.NET 5.0 SDK](https://dotnet.microsoft.com/download) installed.
 - When developing with mobile, [Xamarin](https://docs.microsoft.com/en-us/xamarin/) is required, which is shipped together with Visual Studio or [Visual Studio for Mac](https://visualstudio.microsoft.com/vs/mac/).
 - When working with the codebase, we recommend using an IDE with intelligent code completion and syntax highlighting, such as [Visual Studio 2019+](https://visualstudio.microsoft.com/vs/), [JetBrains Rider](https://www.jetbrains.com/rider/) or [Visual Studio Code](https://code.visualstudio.com/).
 - When running on Linux, please have a system-wide FFmpeg installation available to support video decoding.

From 11f3ec0cb5821311ae5b5f8df1231925c3bd7efe Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Mon, 20 Dec 2021 12:44:22 +0900
Subject: [PATCH 1716/5547] Wait for previous screen to be hidden in test

---
 .../Visual/Background/TestSceneBackgroundScreenDefault.cs        | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Game.Tests/Visual/Background/TestSceneBackgroundScreenDefault.cs b/osu.Game.Tests/Visual/Background/TestSceneBackgroundScreenDefault.cs
index 3211405670..844fe7705a 100644
--- a/osu.Game.Tests/Visual/Background/TestSceneBackgroundScreenDefault.cs
+++ b/osu.Game.Tests/Visual/Background/TestSceneBackgroundScreenDefault.cs
@@ -85,6 +85,7 @@ namespace osu.Game.Tests.Visual.Background
             // of note, this needs to be a type that doesn't match BackgroundScreenDefault else it is silently not pushed by the background stack.
             AddStep("push new background to stack", () => stack.Push(nestedScreen = new BackgroundScreenBeatmap(Beatmap.Value)));
             AddUntilStep("wait for screen to load", () => nestedScreen.IsLoaded && nestedScreen.IsCurrentScreen());
+            AddUntilStep("previous background hidden", () => !screen.IsAlive);
 
             AddAssert("top level background hasn't changed yet", () => screen.CheckLastLoadChange() == null);
 

From 9316abc2786dded8078cccb977d21a7058c5faa4 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Mon, 20 Dec 2021 13:10:13 +0900
Subject: [PATCH 1717/5547] Better fix for intermittent multiplayer tests

---
 .../Visual/Multiplayer/QueueModeTestScene.cs  |  3 +--
 .../Multiplayer/TestSceneMultiplayer.cs       | 10 ++++----
 .../Visual/Multiplayer/TestSceneTeamVersus.cs |  2 +-
 .../Multiplayer/MultiplayerTestScene.cs       |  2 +-
 .../Multiplayer/TestMultiplayerClient.cs      | 12 +++++++---
 .../Multiplayer/TestMultiplayerRoomManager.cs | 24 ++-----------------
 6 files changed, 19 insertions(+), 34 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs b/osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs
index 357db16e2c..83292c36bf 100644
--- a/osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs
@@ -41,7 +41,6 @@ namespace osu.Game.Tests.Visual.Multiplayer
         private TestMultiplayerScreenStack multiplayerScreenStack;
 
         protected TestMultiplayerClient Client => multiplayerScreenStack.Client;
-        protected TestMultiplayerRoomManager RoomManager => multiplayerScreenStack.RoomManager;
 
         [Cached(typeof(UserLookupCache))]
         private UserLookupCache lookupCache = new TestUserLookupCache();
@@ -93,7 +92,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 InputManager.Click(MouseButton.Left);
             });
 
-            AddUntilStep("wait for join", () => RoomManager.RoomJoined);
+            AddUntilStep("wait for join", () => Client.RoomJoined);
         }
 
         [Test]
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
index 710855a605..99411254a7 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
@@ -216,7 +216,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddStep("Press select", () => InputManager.Key(Key.Enter));
 
             AddUntilStep("wait for room open", () => this.ChildrenOfType<MultiplayerMatchSubScreen>().FirstOrDefault()?.IsLoaded == true);
-            AddUntilStep("wait for join", () => roomManager.RoomJoined);
+            AddUntilStep("wait for join", () => client.RoomJoined);
         }
 
         [Test]
@@ -295,7 +295,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddStep("join room", () => InputManager.Key(Key.Enter));
 
             AddUntilStep("wait for room open", () => this.ChildrenOfType<MultiplayerMatchSubScreen>().FirstOrDefault()?.IsLoaded == true);
-            AddUntilStep("wait for join", () => roomManager.RoomJoined);
+            AddUntilStep("wait for join", () => client.RoomJoined);
 
             AddAssert("Check participant count correct", () => client.APIRoom?.ParticipantCount.Value == 1);
             AddAssert("Check participant list contains user", () => client.APIRoom?.RecentParticipants.Count(u => u.Id == API.LocalUser.Value.Id) == 1);
@@ -353,7 +353,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddStep("press join room button", () => passwordEntryPopover.ChildrenOfType<OsuButton>().First().TriggerClick());
 
             AddUntilStep("wait for room open", () => this.ChildrenOfType<MultiplayerMatchSubScreen>().FirstOrDefault()?.IsLoaded == true);
-            AddUntilStep("wait for join", () => roomManager.RoomJoined);
+            AddUntilStep("wait for join", () => client.RoomJoined);
         }
 
         [Test]
@@ -646,7 +646,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             AddStep("join room", () => InputManager.Key(Key.Enter));
             AddUntilStep("wait for room open", () => this.ChildrenOfType<MultiplayerMatchSubScreen>().FirstOrDefault()?.IsLoaded == true);
-            AddUntilStep("wait for join", () => roomManager.RoomJoined);
+            AddUntilStep("wait for join", () => client.RoomJoined);
 
             AddAssert("local room has correct settings", () =>
             {
@@ -838,7 +838,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 InputManager.Click(MouseButton.Left);
             });
 
-            AddUntilStep("wait for join", () => roomManager.RoomJoined);
+            AddUntilStep("wait for join", () => client.RoomJoined);
         }
     }
 }
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs
index ccce26ad31..4ecbc30d76 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs
@@ -187,7 +187,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 InputManager.Click(MouseButton.Left);
             });
 
-            AddUntilStep("wait for join", () => multiplayerScreenStack.RoomManager.RoomJoined);
+            AddUntilStep("wait for join", () => client.RoomJoined);
         }
     }
 }
diff --git a/osu.Game/Tests/Visual/Multiplayer/MultiplayerTestScene.cs b/osu.Game/Tests/Visual/Multiplayer/MultiplayerTestScene.cs
index 5656704abf..7607122ef0 100644
--- a/osu.Game/Tests/Visual/Multiplayer/MultiplayerTestScene.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/MultiplayerTestScene.cs
@@ -24,7 +24,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
         protected new MultiplayerTestSceneDependencies OnlinePlayDependencies => (MultiplayerTestSceneDependencies)base.OnlinePlayDependencies;
 
-        public bool RoomJoined => RoomManager.RoomJoined;
+        public bool RoomJoined => Client.RoomJoined;
 
         private readonly bool joinRoom;
 
diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
index 4e0cfe405e..5b08b6b835 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
@@ -31,9 +31,10 @@ namespace osu.Game.Tests.Visual.Multiplayer
         private readonly Bindable<bool> isConnected = new Bindable<bool>(true);
 
         public new Room? APIRoom => base.APIRoom;
-
         public Action<MultiplayerRoom>? RoomSetupAction;
 
+        public bool RoomJoined { get; private set; }
+
         [Resolved]
         private IAPIProvider api { get; set; } = null!;
 
@@ -49,7 +50,6 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
         private MultiplayerPlaylistItem? currentItem => Room?.Playlist[currentIndex];
         private int currentIndex;
-
         private long lastPlaylistItemId;
 
         public TestMultiplayerClient(TestMultiplayerRoomManager roomManager)
@@ -217,9 +217,15 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             // emulate the server sending this after the join room. scheduler required to make sure the join room event is fired first (in Join).
             changeMatchType(Room.Settings.MatchType).Wait();
+
+            RoomJoined = true;
         }
 
-        protected override Task LeaveRoomInternal() => Task.CompletedTask;
+        protected override Task LeaveRoomInternal()
+        {
+            RoomJoined = false;
+            return Task.CompletedTask;
+        }
 
         public override Task TransferHost(int userId) => ((IMultiplayerClient)this).HostChanged(userId);
 
diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerRoomManager.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerRoomManager.cs
index a1f010f082..296db3152d 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerRoomManager.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerRoomManager.cs
@@ -17,8 +17,6 @@ namespace osu.Game.Tests.Visual.Multiplayer
     /// </summary>
     public class TestMultiplayerRoomManager : MultiplayerRoomManager
     {
-        public bool RoomJoined { get; private set; }
-
         private readonly TestRoomRequestsHandler requestsHandler;
 
         public TestMultiplayerRoomManager(TestRoomRequestsHandler requestsHandler)
@@ -29,28 +27,10 @@ namespace osu.Game.Tests.Visual.Multiplayer
         public IReadOnlyList<Room> ServerSideRooms => requestsHandler.ServerSideRooms;
 
         public override void CreateRoom(Room room, Action<Room> onSuccess = null, Action<string> onError = null)
-        {
-            base.CreateRoom(room, r =>
-            {
-                onSuccess?.Invoke(r);
-                RoomJoined = true;
-            }, onError);
-        }
+            => base.CreateRoom(room, r => onSuccess?.Invoke(r), onError);
 
         public override void JoinRoom(Room room, string password = null, Action<Room> onSuccess = null, Action<string> onError = null)
-        {
-            base.JoinRoom(room, password, r =>
-            {
-                onSuccess?.Invoke(r);
-                RoomJoined = true;
-            }, onError);
-        }
-
-        public override void PartRoom()
-        {
-            base.PartRoom();
-            RoomJoined = false;
-        }
+            => base.JoinRoom(room, password, r => onSuccess?.Invoke(r), onError);
 
         /// <summary>
         /// Adds a room to a local "server-side" list that's returned when a <see cref="GetRoomsRequest"/> is fired.

From d79602a9127ffcff60597dcbb8291da70566ffe2 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 20 Dec 2021 16:58:16 +0900
Subject: [PATCH 1718/5547] Add wait step to `TestScenePlaylistResultScreen`
 explicitly for screen load

---
 .../Visual/Playlists/TestScenePlaylistsResultsScreen.cs        | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsResultsScreen.cs b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsResultsScreen.cs
index 25ca1299ef..e9210496ca 100644
--- a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsResultsScreen.cs
+++ b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsResultsScreen.cs
@@ -168,12 +168,13 @@ namespace osu.Game.Tests.Visual.Playlists
                 }));
             });
 
+            AddUntilStep("wait for screen to load", () => resultsScreen.IsLoaded);
             waitForDisplay();
         }
 
         private void waitForDisplay()
         {
-            AddUntilStep("wait for load to complete", () =>
+            AddUntilStep("wait for scores loaded", () =>
                 requestComplete
                 && resultsScreen.ScorePanelList.GetScorePanels().Count() == totalCount
                 && resultsScreen.ScorePanelList.AllPanelsVisible);

From af78a3e99d9126d6bd47219b4fe6a1b6625376d4 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 20 Dec 2021 17:09:08 +0900
Subject: [PATCH 1719/5547] Fix weird loop logic

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

diff --git a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
index be390742ea..01692ebc80 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
@@ -883,7 +883,7 @@ namespace osu.Game.Tests.Visual.SongSelect
             {
                 var usableRulesets = rulesets.AvailableRulesets.Where(r => r.OnlineID != 2).ToArray();
 
-                for (int i = 0; i < 100; i += 10)
+                for (int i = 0; i < 10; i++)
                     manager.Import(TestResources.CreateTestBeatmapSetInfo(rulesets: usableRulesets)).Wait();
             });
         }

From 5c8e317a6e7b647b40e1f92a9d0d6eb17dbafda5 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 20 Dec 2021 17:11:15 +0900
Subject: [PATCH 1720/5547] Chooser earlier items in song select tests to avoid
 potentially not having enough

---
 .../Visual/SongSelect/TestScenePlaySongSelect.cs      | 11 +++++++----
 1 file changed, 7 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
index 01692ebc80..dcc34d2eaa 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
@@ -488,8 +488,9 @@ namespace osu.Game.Tests.Visual.SongSelect
             AddStep("select beatmap externally", () =>
             {
                 target = manager.GetAllUsableBeatmapSets()
-                                .Where(b => b.Beatmaps.Any(bi => bi.RulesetID == targetRuleset))
-                                .ElementAt(5).Beatmaps.First(bi => bi.RulesetID == targetRuleset);
+                                .First(b => b.Beatmaps.Any(bi => bi.RulesetID == targetRuleset))
+                                .Beatmaps
+                                .First(bi => bi.RulesetID == targetRuleset);
 
                 Beatmap.Value = manager.GetWorkingBeatmap(target);
             });
@@ -534,8 +535,10 @@ namespace osu.Game.Tests.Visual.SongSelect
 
             AddStep("select beatmap externally", () =>
             {
-                target = manager.GetAllUsableBeatmapSets().Where(b => b.Beatmaps.Any(bi => bi.RulesetID == 1))
-                                .ElementAt(5).Beatmaps.First();
+                target = manager
+                         .GetAllUsableBeatmapSets()
+                         .First(b => b.Beatmaps.Any(bi => bi.RulesetID == 1))
+                         .Beatmaps.First();
 
                 Beatmap.Value = manager.GetWorkingBeatmap(target);
             });

From 6caa950c44aba65eb9aef5aa2895d79e6ee0ddda Mon Sep 17 00:00:00 2001
From: MBmasher <mbmasher@gmail.com>
Date: Mon, 20 Dec 2021 19:16:41 +1100
Subject: [PATCH 1721/5547] Rename `osuPrevious` to `osuLoop`

---
 .../Difficulty/Skills/Flashlight.cs            | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
index 9c539d5e4b..cb1ccf949e 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
@@ -42,27 +42,27 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
 
             for (int i = 0; i < Previous.Count; i++)
             {
-                var osuPrevious = (OsuDifficultyHitObject)Previous[i];
-                var osuPreviousHitObject = (OsuHitObject)(osuPrevious.BaseObject);
+                var osuLoop = (OsuDifficultyHitObject)Previous[i];
+                var osuLoopHitObject = (OsuHitObject)(osuLoop.BaseObject);
 
-                OsuDifficultyHitObject osuLastPrevious;
+                OsuDifficultyHitObject osuLoopNext;
                 if (i == 0)
-                    osuLastPrevious = osuCurrent;
+                    osuLoopNext = osuCurrent;
                 else
-                    osuLastPrevious = (OsuDifficultyHitObject)Previous[i - 1];
+                    osuLoopNext = (OsuDifficultyHitObject)Previous[i - 1];
 
-                if (!(osuPrevious.BaseObject is Spinner))
+                if (!(osuLoop.BaseObject is Spinner))
                 {
-                    double jumpDistance = (osuHitObject.StackedPosition - osuPreviousHitObject.EndPosition).Length;
+                    double jumpDistance = (osuHitObject.StackedPosition - osuLoopHitObject.EndPosition).Length;
 
-                    cumulativeStrainTime += osuLastPrevious.StrainTime;
+                    cumulativeStrainTime += osuLoopNext.StrainTime;
 
                     // We want to nerf objects that can be easily seen within the Flashlight circle radius.
                     if (i == 0)
                         smallDistNerf = Math.Min(1.0, jumpDistance / 75.0);
 
                     // We also want to nerf stacks so that only the first object of the stack is accounted for.
-                    double stackNerf = Math.Min(1.0, (osuPrevious.JumpDistance / scalingFactor) / 25.0);
+                    double stackNerf = Math.Min(1.0, (osuLoop.JumpDistance / scalingFactor) / 25.0);
 
                     result += Math.Pow(0.8, i) * stackNerf * scalingFactor * jumpDistance / cumulativeStrainTime;
                 }

From 090c3e84e7004e544f7c57374865c87ceac41109 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 20 Dec 2021 17:38:14 +0900
Subject: [PATCH 1722/5547] Avoid blocking windows key usage when the osu!
 window is not active

As discussed in https://github.com/ppy/osu/discussions/16147.
---
 osu.Desktop/Windows/GameplayWinKeyBlocker.cs | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/osu.Desktop/Windows/GameplayWinKeyBlocker.cs b/osu.Desktop/Windows/GameplayWinKeyBlocker.cs
index dbfd170ea1..4acaf61cea 100644
--- a/osu.Desktop/Windows/GameplayWinKeyBlocker.cs
+++ b/osu.Desktop/Windows/GameplayWinKeyBlocker.cs
@@ -14,6 +14,7 @@ namespace osu.Desktop.Windows
     {
         private Bindable<bool> disableWinKey;
         private IBindable<bool> localUserPlaying;
+        private IBindable<bool> isActive;
 
         [Resolved]
         private GameHost host { get; set; }
@@ -24,13 +25,16 @@ namespace osu.Desktop.Windows
             localUserPlaying = localUserInfo.IsPlaying.GetBoundCopy();
             localUserPlaying.BindValueChanged(_ => updateBlocking());
 
+            isActive = host.IsActive.GetBoundCopy();
+            isActive.BindValueChanged(_ => updateBlocking());
+
             disableWinKey = config.GetBindable<bool>(OsuSetting.GameplayDisableWinKey);
             disableWinKey.BindValueChanged(_ => updateBlocking(), true);
         }
 
         private void updateBlocking()
         {
-            bool shouldDisable = disableWinKey.Value && localUserPlaying.Value;
+            bool shouldDisable = isActive.Value && disableWinKey.Value && localUserPlaying.Value;
 
             if (shouldDisable)
                 host.InputThread.Scheduler.Add(WindowsKey.Disable);

From 87051d5d61c71c8045c668686fe5b3020cb548a6 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 20 Dec 2021 17:46:20 +0900
Subject: [PATCH 1723/5547] Add better defined steps to
 `TestLoseHostWhileReady` ready button test

Not 100% sure this will solve the issue but it's worth a try. The button
state checks are using `Until` everywhere else so this brings the test
in line with the standards.

As seen
https://github.com/ppy/osu/runs/4579641456?check_suite_focus=true.
---
 .../Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs    | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs
index 84b63a5733..81220e2527 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs
@@ -163,10 +163,13 @@ namespace osu.Game.Tests.Visual.Multiplayer
             });
 
             addClickButtonStep();
+            AddUntilStep("user is ready", () => Client.Room?.Users[0].State == MultiplayerUserState.Ready);
+
             AddStep("transfer host", () => Client.TransferHost(Client.Room?.Users[1].UserID ?? 0));
 
             addClickButtonStep();
-            AddAssert("match not started", () => Client.Room?.Users[0].State == MultiplayerUserState.Idle);
+            AddUntilStep("user is idle (match not started)", () => Client.Room?.Users[0].State == MultiplayerUserState.Idle);
+            AddAssert("ready button enabled", () => button.ChildrenOfType<OsuButton>().Single().Enabled.Value);
         }
 
         [TestCase(true)]

From 1533aefce5015d03083501d5bb6547bb77e7b5c4 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 20 Dec 2021 18:22:19 +0900
Subject: [PATCH 1724/5547] Update framework

---
 osu.Android.props        | 2 +-
 osu.Game/osu.Game.csproj | 2 +-
 osu.iOS.props            | 4 ++--
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Android.props b/osu.Android.props
index 209b8cd63e..1532d4ce23 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -52,7 +52,7 @@
   </ItemGroup>
   <ItemGroup>
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1215.0" />
-    <PackageReference Include="ppy.osu.Framework.Android" Version="2021.1217.1" />
+    <PackageReference Include="ppy.osu.Framework.Android" Version="2021.1220.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
     <!-- Realm needs to be directly referenced in all Xamarin projects, as it will not pull in its transitive dependencies otherwise. -->
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 97bdf00f69..6e6002bc8e 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="10.7.1" />
-    <PackageReference Include="ppy.osu.Framework" Version="2021.1217.1" />
+    <PackageReference Include="ppy.osu.Framework" Version="2021.1220.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1215.0" />
     <PackageReference Include="Sentry" Version="3.12.1" />
     <PackageReference Include="SharpCompress" Version="0.30.1" />
diff --git a/osu.iOS.props b/osu.iOS.props
index d4b7339900..de359245d1 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -60,7 +60,7 @@
     <Reference Include="System.Net.Http" />
   </ItemGroup>
   <ItemGroup Label="Package References">
-    <PackageReference Include="ppy.osu.Framework.iOS" Version="2021.1217.1" />
+    <PackageReference Include="ppy.osu.Framework.iOS" Version="2021.1220.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1215.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net5.0 / net6.0) -->
@@ -83,7 +83,7 @@
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="2.2.6" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.Core" Version="2.2.6" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
-    <PackageReference Include="ppy.osu.Framework" Version="2021.1217.1" />
+    <PackageReference Include="ppy.osu.Framework" Version="2021.1220.0" />
     <PackageReference Include="SharpCompress" Version="0.30.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
     <PackageReference Include="SharpRaven" Version="2.4.0" />

From 6907a9a3ccb5ef46863b5eb4bd6231f678fc606c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 20 Dec 2021 18:24:14 +0900
Subject: [PATCH 1725/5547] Name some screen stacks for better logging context

---
 osu.Game.Tests/Visual/TestMultiplayerScreenStack.cs         | 6 +++++-
 .../Screens/OnlinePlay/Multiplayer/Spectate/PlayerArea.cs   | 5 ++++-
 osu.Game/Tests/Visual/ScreenTestScene.cs                    | 6 +++++-
 3 files changed, 14 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Tests/Visual/TestMultiplayerScreenStack.cs b/osu.Game.Tests/Visual/TestMultiplayerScreenStack.cs
index 370f3bd0ae..88502b7074 100644
--- a/osu.Game.Tests/Visual/TestMultiplayerScreenStack.cs
+++ b/osu.Game.Tests/Visual/TestMultiplayerScreenStack.cs
@@ -49,7 +49,11 @@ namespace osu.Game.Tests.Visual
             InternalChildren = new Drawable[]
             {
                 Client = new TestMultiplayerClient(RoomManager),
-                screenStack = new OsuScreenStack { RelativeSizeAxes = Axes.Both }
+                screenStack = new OsuScreenStack
+                {
+                    Name = nameof(TestMultiplayerScreenStack),
+                    RelativeSizeAxes = Axes.Both
+                }
             };
 
             screenStack.Push(multiplayerScreen);
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/PlayerArea.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/PlayerArea.cs
index c3190cd845..48f153ecbe 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/PlayerArea.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/PlayerArea.cs
@@ -87,7 +87,10 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Spectate
             gameplayContent.Child = new PlayerIsolationContainer(beatmapManager.GetWorkingBeatmap(Score.ScoreInfo.BeatmapInfo), Score.ScoreInfo.Ruleset, Score.ScoreInfo.Mods)
             {
                 RelativeSizeAxes = Axes.Both,
-                Child = stack = new OsuScreenStack()
+                Child = stack = new OsuScreenStack
+                {
+                    Name = nameof(PlayerArea),
+                }
             };
 
             stack.Push(new MultiSpectatorPlayerLoader(Score, () => new MultiSpectatorPlayer(Score, GameplayClock)));
diff --git a/osu.Game/Tests/Visual/ScreenTestScene.cs b/osu.Game/Tests/Visual/ScreenTestScene.cs
index aa46b516bf..c44a848275 100644
--- a/osu.Game/Tests/Visual/ScreenTestScene.cs
+++ b/osu.Game/Tests/Visual/ScreenTestScene.cs
@@ -29,7 +29,11 @@ namespace osu.Game.Tests.Visual
         {
             base.Content.AddRange(new Drawable[]
             {
-                Stack = new OsuScreenStack { RelativeSizeAxes = Axes.Both },
+                Stack = new OsuScreenStack
+                {
+                    Name = nameof(ScreenTestScene),
+                    RelativeSizeAxes = Axes.Both
+                },
                 content = new Container { RelativeSizeAxes = Axes.Both },
                 DialogOverlay = new DialogOverlay()
             });

From ec0a6735eb519272f85413c0017e9dcf95ed11e5 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 20 Dec 2021 18:24:59 +0900
Subject: [PATCH 1726/5547] Rename `TestMultiplayerScreenStack` to
 `TestMultiplayerComponents`

---
 .../Visual/Multiplayer/QueueModeTestScene.cs  | 20 +++----
 .../Multiplayer/TestSceneMultiplayer.cs       | 52 +++++++++----------
 .../Visual/Multiplayer/TestSceneTeamVersus.cs | 18 +++----
 .../Navigation/TestSceneScreenNavigation.cs   |  8 +--
 ...nStack.cs => TestMultiplayerComponents.cs} |  6 +--
 5 files changed, 52 insertions(+), 52 deletions(-)
 rename osu.Game.Tests/Visual/{TestMultiplayerScreenStack.cs => TestMultiplayerComponents.cs} (95%)

diff --git a/osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs b/osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs
index 83292c36bf..5acb44ac45 100644
--- a/osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs
@@ -31,16 +31,16 @@ namespace osu.Game.Tests.Visual.Multiplayer
         protected BeatmapInfo InitialBeatmap { get; private set; }
         protected BeatmapInfo OtherBeatmap { get; private set; }
 
-        protected IScreen CurrentScreen => multiplayerScreenStack.CurrentScreen;
-        protected IScreen CurrentSubScreen => multiplayerScreenStack.MultiplayerScreen.CurrentSubScreen;
+        protected IScreen CurrentScreen => multiplayerComponents.CurrentScreen;
+        protected IScreen CurrentSubScreen => multiplayerComponents.MultiplayerScreen.CurrentSubScreen;
 
         private BeatmapManager beatmaps;
         private RulesetStore rulesets;
         private BeatmapSetInfo importedSet;
 
-        private TestMultiplayerScreenStack multiplayerScreenStack;
+        private TestMultiplayerComponents multiplayerComponents;
 
-        protected TestMultiplayerClient Client => multiplayerScreenStack.Client;
+        protected TestMultiplayerClient Client => multiplayerComponents.Client;
 
         [Cached(typeof(UserLookupCache))]
         private UserLookupCache lookupCache = new TestUserLookupCache();
@@ -64,12 +64,12 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 OtherBeatmap = importedSet.Beatmaps.Last(b => b.RulesetID == 0);
             });
 
-            AddStep("load multiplayer", () => LoadScreen(multiplayerScreenStack = new TestMultiplayerScreenStack()));
-            AddUntilStep("wait for multiplayer to load", () => multiplayerScreenStack.IsLoaded);
+            AddStep("load multiplayer", () => LoadScreen(multiplayerComponents = new TestMultiplayerComponents()));
+            AddUntilStep("wait for multiplayer to load", () => multiplayerComponents.IsLoaded);
             AddUntilStep("wait for lounge to load", () => this.ChildrenOfType<MultiplayerLoungeSubScreen>().FirstOrDefault()?.IsLoaded == true);
 
-            AddUntilStep("wait for lounge", () => multiplayerScreenStack.ChildrenOfType<LoungeSubScreen>().SingleOrDefault()?.IsLoaded == true);
-            AddStep("open room", () => multiplayerScreenStack.ChildrenOfType<LoungeSubScreen>().Single().Open(new Room
+            AddUntilStep("wait for lounge", () => multiplayerComponents.ChildrenOfType<LoungeSubScreen>().SingleOrDefault()?.IsLoaded == true);
+            AddStep("open room", () => multiplayerComponents.ChildrenOfType<LoungeSubScreen>().Single().Open(new Room
             {
                 Name = { Value = "Test Room" },
                 QueueMode = { Value = Mode },
@@ -109,8 +109,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddUntilStep("wait for ready", () => Client.LocalUser?.State == MultiplayerUserState.Ready);
             clickReadyButton();
 
-            AddUntilStep("wait for player", () => multiplayerScreenStack.CurrentScreen is Player player && player.IsLoaded);
-            AddStep("exit player", () => multiplayerScreenStack.MultiplayerScreen.MakeCurrent());
+            AddUntilStep("wait for player", () => multiplayerComponents.CurrentScreen is Player player && player.IsLoaded);
+            AddStep("exit player", () => multiplayerComponents.MultiplayerScreen.MakeCurrent());
         }
 
         private void clickReadyButton()
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
index 99411254a7..bd0e5c4eb9 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
@@ -46,10 +46,10 @@ namespace osu.Game.Tests.Visual.Multiplayer
         private RulesetStore rulesets;
         private BeatmapSetInfo importedSet;
 
-        private TestMultiplayerScreenStack multiplayerScreenStack;
+        private TestMultiplayerComponents multiplayerComponents;
 
-        private TestMultiplayerClient client => multiplayerScreenStack.Client;
-        private TestMultiplayerRoomManager roomManager => multiplayerScreenStack.RoomManager;
+        private TestMultiplayerClient client => multiplayerComponents.Client;
+        private TestMultiplayerRoomManager roomManager => multiplayerComponents.RoomManager;
 
         [Cached(typeof(UserLookupCache))]
         private UserLookupCache lookupCache = new TestUserLookupCache();
@@ -71,8 +71,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 importedSet = beatmaps.GetAllUsableBeatmapSetsEnumerable(IncludedDetails.All).First();
             });
 
-            AddStep("load multiplayer", () => LoadScreen(multiplayerScreenStack = new TestMultiplayerScreenStack()));
-            AddUntilStep("wait for multiplayer to load", () => multiplayerScreenStack.IsLoaded);
+            AddStep("load multiplayer", () => LoadScreen(multiplayerComponents = new TestMultiplayerComponents()));
+            AddUntilStep("wait for multiplayer to load", () => multiplayerComponents.IsLoaded);
             AddUntilStep("wait for lounge to load", () => this.ChildrenOfType<MultiplayerLoungeSubScreen>().FirstOrDefault()?.IsLoaded == true);
         }
 
@@ -419,7 +419,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             AddStep("Enter song select", () =>
             {
-                var currentSubScreen = ((Screens.OnlinePlay.Multiplayer.Multiplayer)multiplayerScreenStack.CurrentScreen).CurrentSubScreen;
+                var currentSubScreen = ((Screens.OnlinePlay.Multiplayer.Multiplayer)multiplayerComponents.CurrentScreen).CurrentSubScreen;
                 ((MultiplayerMatchSubScreen)currentSubScreen).OpenSongSelection(client.Room?.Settings.PlaylistItemId);
             });
 
@@ -433,7 +433,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             AddStep("start match externally", () => client.StartMatch());
 
-            AddUntilStep("play started", () => multiplayerScreenStack.CurrentScreen is Player);
+            AddUntilStep("play started", () => multiplayerComponents.CurrentScreen is Player);
 
             AddAssert("Beatmap matches current item", () => Beatmap.Value.BeatmapInfo.OnlineID == client.Room?.Playlist.First().BeatmapID);
         }
@@ -473,7 +473,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             AddStep("start match externally", () => client.StartMatch());
 
-            AddAssert("play not started", () => multiplayerScreenStack.IsCurrentScreen());
+            AddAssert("play not started", () => multiplayerComponents.IsCurrentScreen());
         }
 
         [Test]
@@ -517,7 +517,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 importedSet = beatmaps.GetAllUsableBeatmapSetsEnumerable(IncludedDetails.All).First();
             });
 
-            AddUntilStep("play started", () => multiplayerScreenStack.CurrentScreen is SpectatorScreen);
+            AddUntilStep("play started", () => multiplayerComponents.CurrentScreen is SpectatorScreen);
         }
 
         [Test]
@@ -559,16 +559,16 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             AddStep("open mod overlay", () => this.ChildrenOfType<RoomSubScreen.UserModSelectButton>().Single().TriggerClick());
 
-            AddStep("invoke on back button", () => multiplayerScreenStack.OnBackButton());
+            AddStep("invoke on back button", () => multiplayerComponents.OnBackButton());
 
             AddAssert("mod overlay is hidden", () => this.ChildrenOfType<UserModSelectOverlay>().Single().State.Value == Visibility.Hidden);
 
             AddAssert("dialog overlay is hidden", () => DialogOverlay.State.Value == Visibility.Hidden);
 
-            testLeave("back button", () => multiplayerScreenStack.OnBackButton());
+            testLeave("back button", () => multiplayerComponents.OnBackButton());
 
             // mimics home button and OS window close
-            testLeave("forced exit", () => multiplayerScreenStack.Exit());
+            testLeave("forced exit", () => multiplayerComponents.Exit());
 
             void testLeave(string actionName, Action action)
             {
@@ -605,7 +605,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 AddUntilStep($"wait for time > {i}", () => this.ChildrenOfType<GameplayClockContainer>().SingleOrDefault()?.GameplayClock.CurrentTime > time);
             }
 
-            AddUntilStep("wait for results", () => multiplayerScreenStack.CurrentScreen is ResultsScreen);
+            AddUntilStep("wait for results", () => multiplayerComponents.CurrentScreen is ResultsScreen);
         }
 
         [Test]
@@ -680,15 +680,15 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddStep("set other user ready", () => client.ChangeUserState(1234, MultiplayerUserState.Ready));
 
             pressReadyButton(1234);
-            AddUntilStep("wait for gameplay", () => (multiplayerScreenStack.CurrentScreen as MultiSpectatorScreen)?.IsLoaded == true);
+            AddUntilStep("wait for gameplay", () => (multiplayerComponents.CurrentScreen as MultiSpectatorScreen)?.IsLoaded == true);
 
             AddStep("press back button and exit", () =>
             {
-                multiplayerScreenStack.OnBackButton();
-                multiplayerScreenStack.Exit();
+                multiplayerComponents.OnBackButton();
+                multiplayerComponents.Exit();
             });
 
-            AddUntilStep("wait for return to match subscreen", () => multiplayerScreenStack.MultiplayerScreen.IsCurrentScreen());
+            AddUntilStep("wait for return to match subscreen", () => multiplayerComponents.MultiplayerScreen.IsCurrentScreen());
             AddUntilStep("user state is idle", () => client.LocalUser?.State == MultiplayerUserState.Idle);
         }
 
@@ -716,17 +716,17 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddStep("set other user ready", () => client.ChangeUserState(1234, MultiplayerUserState.Ready));
 
             pressReadyButton(1234);
-            AddUntilStep("wait for gameplay", () => (multiplayerScreenStack.CurrentScreen as MultiSpectatorScreen)?.IsLoaded == true);
+            AddUntilStep("wait for gameplay", () => (multiplayerComponents.CurrentScreen as MultiSpectatorScreen)?.IsLoaded == true);
             AddStep("set other user loaded", () => client.ChangeUserState(1234, MultiplayerUserState.Loaded));
             AddStep("set other user finished play", () => client.ChangeUserState(1234, MultiplayerUserState.FinishedPlay));
 
             AddStep("press back button and exit", () =>
             {
-                multiplayerScreenStack.OnBackButton();
-                multiplayerScreenStack.Exit();
+                multiplayerComponents.OnBackButton();
+                multiplayerComponents.Exit();
             });
 
-            AddUntilStep("wait for return to match subscreen", () => multiplayerScreenStack.MultiplayerScreen.IsCurrentScreen());
+            AddUntilStep("wait for return to match subscreen", () => multiplayerComponents.MultiplayerScreen.IsCurrentScreen());
             AddWaitStep("wait for possible state change", 5);
             AddUntilStep("user state is spectating", () => client.LocalUser?.State == MultiplayerUserState.Spectating);
         }
@@ -758,7 +758,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             AddUntilStep("item arrived in playlist", () => client.Room?.Playlist.Count == 2);
 
-            AddStep("exit gameplay as initial user", () => multiplayerScreenStack.MultiplayerScreen.MakeCurrent());
+            AddStep("exit gameplay as initial user", () => multiplayerComponents.MultiplayerScreen.MakeCurrent());
             AddUntilStep("queue contains item", () => this.ChildrenOfType<MultiplayerQueueList>().Single().Items.Single().ID == 2);
         }
 
@@ -792,7 +792,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddStep("delete item as other user", () => client.RemoveUserPlaylistItem(1234, 2));
             AddUntilStep("item removed from playlist", () => client.Room?.Playlist.Count == 1);
 
-            AddStep("exit gameplay as initial user", () => multiplayerScreenStack.MultiplayerScreen.MakeCurrent());
+            AddStep("exit gameplay as initial user", () => multiplayerComponents.MultiplayerScreen.MakeCurrent());
             AddUntilStep("queue is empty", () => this.ChildrenOfType<MultiplayerQueueList>().Single().Items.Count == 0);
         }
 
@@ -800,7 +800,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             pressReadyButton();
             pressReadyButton();
-            AddUntilStep("wait for player", () => multiplayerScreenStack.CurrentScreen is Player);
+            AddUntilStep("wait for player", () => multiplayerComponents.CurrentScreen is Player);
         }
 
         private ReadyButton readyButton => this.ChildrenOfType<ReadyButton>().Single();
@@ -826,8 +826,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
         private void createRoom(Func<Room> room)
         {
-            AddUntilStep("wait for lounge", () => multiplayerScreenStack.ChildrenOfType<LoungeSubScreen>().SingleOrDefault()?.IsLoaded == true);
-            AddStep("open room", () => multiplayerScreenStack.ChildrenOfType<LoungeSubScreen>().Single().Open(room()));
+            AddUntilStep("wait for lounge", () => multiplayerComponents.ChildrenOfType<LoungeSubScreen>().SingleOrDefault()?.IsLoaded == true);
+            AddStep("open room", () => multiplayerComponents.ChildrenOfType<LoungeSubScreen>().Single().Open(room()));
 
             AddUntilStep("wait for room open", () => this.ChildrenOfType<MultiplayerMatchSubScreen>().FirstOrDefault()?.IsLoaded == true);
             AddWaitStep("wait for transition", 2);
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs
index 4ecbc30d76..81c59b90f5 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs
@@ -31,9 +31,9 @@ namespace osu.Game.Tests.Visual.Multiplayer
         private RulesetStore rulesets;
         private BeatmapSetInfo importedSet;
 
-        private TestMultiplayerScreenStack multiplayerScreenStack;
+        private TestMultiplayerComponents multiplayerComponents;
 
-        private TestMultiplayerClient client => multiplayerScreenStack.Client;
+        private TestMultiplayerClient client => multiplayerComponents.Client;
 
         [Cached(typeof(UserLookupCache))]
         private UserLookupCache lookupCache = new TestUserLookupCache();
@@ -55,8 +55,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 importedSet = beatmaps.GetAllUsableBeatmapSetsEnumerable(IncludedDetails.All).First();
             });
 
-            AddStep("load multiplayer", () => LoadScreen(multiplayerScreenStack = new TestMultiplayerScreenStack()));
-            AddUntilStep("wait for multiplayer to load", () => multiplayerScreenStack.IsLoaded);
+            AddStep("load multiplayer", () => LoadScreen(multiplayerComponents = new TestMultiplayerComponents()));
+            AddUntilStep("wait for multiplayer to load", () => multiplayerComponents.IsLoaded);
             AddUntilStep("wait for lounge to load", () => this.ChildrenOfType<MultiplayerLoungeSubScreen>().FirstOrDefault()?.IsLoaded == true);
         }
 
@@ -103,7 +103,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             AddStep("press own button", () =>
             {
-                InputManager.MoveMouseTo(multiplayerScreenStack.ChildrenOfType<TeamDisplay>().First());
+                InputManager.MoveMouseTo(multiplayerComponents.ChildrenOfType<TeamDisplay>().First());
                 InputManager.Click(MouseButton.Left);
             });
             AddAssert("user on team 1", () => (client.Room?.Users.FirstOrDefault()?.MatchState as TeamVersusUserState)?.TeamID == 1);
@@ -113,7 +113,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             AddStep("press other user's button", () =>
             {
-                InputManager.MoveMouseTo(multiplayerScreenStack.ChildrenOfType<TeamDisplay>().ElementAt(1));
+                InputManager.MoveMouseTo(multiplayerComponents.ChildrenOfType<TeamDisplay>().ElementAt(1));
                 InputManager.Click(MouseButton.Left);
             });
             AddAssert("user still on team 0", () => (client.Room?.Users.FirstOrDefault()?.MatchState as TeamVersusUserState)?.TeamID == 0);
@@ -164,18 +164,18 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             AddUntilStep("room type is head to head", () => client.Room?.Settings.MatchType == MatchType.HeadToHead);
 
-            AddUntilStep("team displays are not displaying teams", () => multiplayerScreenStack.ChildrenOfType<TeamDisplay>().All(d => d.DisplayedTeam == null));
+            AddUntilStep("team displays are not displaying teams", () => multiplayerComponents.ChildrenOfType<TeamDisplay>().All(d => d.DisplayedTeam == null));
 
             AddStep("change to team vs", () => client.ChangeSettings(matchType: MatchType.TeamVersus));
 
             AddUntilStep("room type is team vs", () => client.Room?.Settings.MatchType == MatchType.TeamVersus);
 
-            AddUntilStep("team displays are displaying teams", () => multiplayerScreenStack.ChildrenOfType<TeamDisplay>().All(d => d.DisplayedTeam != null));
+            AddUntilStep("team displays are displaying teams", () => multiplayerComponents.ChildrenOfType<TeamDisplay>().All(d => d.DisplayedTeam != null));
         }
 
         private void createRoom(Func<Room> room)
         {
-            AddStep("open room", () => multiplayerScreenStack.ChildrenOfType<LoungeSubScreen>().Single().Open(room()));
+            AddStep("open room", () => multiplayerComponents.ChildrenOfType<LoungeSubScreen>().Single().Open(room()));
 
             AddUntilStep("wait for room open", () => this.ChildrenOfType<MultiplayerMatchSubScreen>().FirstOrDefault()?.IsLoaded == true);
             AddWaitStep("wait for transition", 2);
diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs b/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
index 664c186cf8..48ab643992 100644
--- a/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
@@ -336,12 +336,12 @@ namespace osu.Game.Tests.Visual.Navigation
         [Test]
         public void TestPushMatchSubScreenAndPressBackButtonImmediately()
         {
-            TestMultiplayerScreenStack multiplayerScreenStack = null;
+            TestMultiplayerComponents multiplayerComponents = null;
 
-            PushAndConfirm(() => multiplayerScreenStack = new TestMultiplayerScreenStack());
+            PushAndConfirm(() => multiplayerComponents = new TestMultiplayerComponents());
 
-            AddUntilStep("wait for lounge", () => multiplayerScreenStack.ChildrenOfType<LoungeSubScreen>().SingleOrDefault()?.IsLoaded == true);
-            AddStep("open room", () => multiplayerScreenStack.ChildrenOfType<LoungeSubScreen>().Single().Open());
+            AddUntilStep("wait for lounge", () => multiplayerComponents.ChildrenOfType<LoungeSubScreen>().SingleOrDefault()?.IsLoaded == true);
+            AddStep("open room", () => multiplayerComponents.ChildrenOfType<LoungeSubScreen>().Single().Open());
             AddStep("press back button", () => Game.ChildrenOfType<BackButton>().First().Action());
             AddWaitStep("wait two frames", 2);
         }
diff --git a/osu.Game.Tests/Visual/TestMultiplayerScreenStack.cs b/osu.Game.Tests/Visual/TestMultiplayerComponents.cs
similarity index 95%
rename from osu.Game.Tests/Visual/TestMultiplayerScreenStack.cs
rename to osu.Game.Tests/Visual/TestMultiplayerComponents.cs
index 88502b7074..cd7a936778 100644
--- a/osu.Game.Tests/Visual/TestMultiplayerScreenStack.cs
+++ b/osu.Game.Tests/Visual/TestMultiplayerComponents.cs
@@ -26,7 +26,7 @@ namespace osu.Game.Tests.Visual
     /// </list>
     /// </p>
     /// </summary>
-    public class TestMultiplayerScreenStack : OsuScreen
+    public class TestMultiplayerComponents : OsuScreen
     {
         public Screens.OnlinePlay.Multiplayer.Multiplayer MultiplayerScreen => multiplayerScreen;
 
@@ -42,7 +42,7 @@ namespace osu.Game.Tests.Visual
         private readonly OsuScreenStack screenStack;
         private readonly TestMultiplayer multiplayerScreen;
 
-        public TestMultiplayerScreenStack()
+        public TestMultiplayerComponents()
         {
             multiplayerScreen = new TestMultiplayer();
 
@@ -51,7 +51,7 @@ namespace osu.Game.Tests.Visual
                 Client = new TestMultiplayerClient(RoomManager),
                 screenStack = new OsuScreenStack
                 {
-                    Name = nameof(TestMultiplayerScreenStack),
+                    Name = nameof(TestMultiplayerComponents),
                     RelativeSizeAxes = Axes.Both
                 }
             };

From f492cf84d9d83d8ea9a39e5c1c511471d5bd7f29 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 20 Dec 2021 11:24:40 +0100
Subject: [PATCH 1727/5547] Ensure presence of at least 1 difficulty for each
 ruleset

---
 .../SongSelect/TestScenePlaySongSelect.cs     | 19 +++++++++++++++----
 1 file changed, 15 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
index dcc34d2eaa..912d3f838c 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
@@ -466,7 +466,9 @@ namespace osu.Game.Tests.Visual.SongSelect
         public void TestExternalBeatmapChangeWhileFiltered(bool differentRuleset)
         {
             createSongSelect();
-            addManyTestMaps();
+            // ensure there is at least 1 difficulty for each of the rulesets
+            // (catch is excluded inside of addManyTestMaps).
+            addManyTestMaps(3);
 
             changeRuleset(0);
 
@@ -519,7 +521,9 @@ namespace osu.Game.Tests.Visual.SongSelect
         public void TestExternalBeatmapChangeWhileFilteredThenRefilter()
         {
             createSongSelect();
-            addManyTestMaps();
+            // ensure there is at least 1 difficulty for each of the rulesets
+            // (catch is excluded inside of addManyTestMaps).
+            addManyTestMaps(3);
 
             changeRuleset(0);
 
@@ -880,14 +884,21 @@ namespace osu.Game.Tests.Visual.SongSelect
             AddUntilStep("wait for carousel loaded", () => songSelect.Carousel.IsAlive);
         }
 
-        private void addManyTestMaps()
+        /// <summary>
+        /// Imports test beatmap sets to show in the carousel.
+        /// </summary>
+        /// <param name="difficultyCountPerSet">
+        /// The exact count of difficulties to create for each beatmap set.
+        /// A <see langword="null"/> value causes the count of difficulties to be selected randomly.
+        /// </param>
+        private void addManyTestMaps(int? difficultyCountPerSet = null)
         {
             AddStep("import test maps", () =>
             {
                 var usableRulesets = rulesets.AvailableRulesets.Where(r => r.OnlineID != 2).ToArray();
 
                 for (int i = 0; i < 10; i++)
-                    manager.Import(TestResources.CreateTestBeatmapSetInfo(rulesets: usableRulesets)).Wait();
+                    manager.Import(TestResources.CreateTestBeatmapSetInfo(difficultyCountPerSet, usableRulesets)).Wait();
             });
         }
 

From a59583ee0901c3086059cd38b44ffcb86c7729b5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 20 Dec 2021 13:18:02 +0100
Subject: [PATCH 1728/5547] Add extension method for returning next playlist
 item

---
 .../OnlinePlay/PlaylistExtensionsTest.cs      | 72 +++++++++++++++++++
 osu.Game/Online/Rooms/PlaylistExtensions.cs   | 10 +++
 2 files changed, 82 insertions(+)
 create mode 100644 osu.Game.Tests/OnlinePlay/PlaylistExtensionsTest.cs

diff --git a/osu.Game.Tests/OnlinePlay/PlaylistExtensionsTest.cs b/osu.Game.Tests/OnlinePlay/PlaylistExtensionsTest.cs
new file mode 100644
index 0000000000..d2ee47bc23
--- /dev/null
+++ b/osu.Game.Tests/OnlinePlay/PlaylistExtensionsTest.cs
@@ -0,0 +1,72 @@
+// 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.Online.Rooms;
+
+namespace osu.Game.Tests.OnlinePlay
+{
+    [TestFixture]
+    public class PlaylistExtensionsTest
+    {
+        [Test]
+        public void TestPlaylistItemsInOrder()
+        {
+            var items = new[]
+            {
+                new PlaylistItem { ID = 1, BeatmapID = 1001, PlaylistOrder = 1 },
+                new PlaylistItem { ID = 2, BeatmapID = 1002, PlaylistOrder = 2 },
+                new PlaylistItem { ID = 3, BeatmapID = 1003, PlaylistOrder = 3 },
+            };
+
+            var nextItem = items.GetNextItem();
+
+            Assert.That(nextItem, Is.EqualTo(items[0]));
+        }
+
+        [Test]
+        public void TestPlaylistItemsOutOfOrder()
+        {
+            var items = new[]
+            {
+                new PlaylistItem { ID = 2, BeatmapID = 1002, PlaylistOrder = 2 },
+                new PlaylistItem { ID = 1, BeatmapID = 1001, PlaylistOrder = 1 },
+                new PlaylistItem { ID = 3, BeatmapID = 1003, PlaylistOrder = 3 },
+            };
+
+            var nextItem = items.GetNextItem();
+
+            Assert.That(nextItem, Is.EqualTo(items[1]));
+        }
+
+        [Test]
+        public void TestExpiredPlaylistItemsSkipped()
+        {
+            var items = new[]
+            {
+                new PlaylistItem { ID = 2, BeatmapID = 1002, PlaylistOrder = 2, Expired = true },
+                new PlaylistItem { ID = 1, BeatmapID = 1001, PlaylistOrder = 1, Expired = true },
+                new PlaylistItem { ID = 3, BeatmapID = 1003, PlaylistOrder = 3 },
+            };
+
+            var nextItem = items.GetNextItem();
+
+            Assert.That(nextItem, Is.EqualTo(items[2]));
+        }
+
+        [Test]
+        public void TestAllItemsExpired()
+        {
+            var items = new[]
+            {
+                new PlaylistItem { ID = 2, BeatmapID = 1002, PlaylistOrder = 2, Expired = true },
+                new PlaylistItem { ID = 1, BeatmapID = 1001, PlaylistOrder = 1, Expired = true },
+                new PlaylistItem { ID = 3, BeatmapID = 1003, PlaylistOrder = 3, Expired = true },
+            };
+
+            var nextItem = items.GetNextItem();
+
+            Assert.That(nextItem, Is.Null);
+        }
+    }
+}
diff --git a/osu.Game/Online/Rooms/PlaylistExtensions.cs b/osu.Game/Online/Rooms/PlaylistExtensions.cs
index 992011da3c..e900dc53ef 100644
--- a/osu.Game/Online/Rooms/PlaylistExtensions.cs
+++ b/osu.Game/Online/Rooms/PlaylistExtensions.cs
@@ -1,6 +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 enable
+
+using System.Collections.Generic;
 using System.Linq;
 using Humanizer;
 using Humanizer.Localisation;
@@ -10,6 +13,13 @@ namespace osu.Game.Online.Rooms
 {
     public static class PlaylistExtensions
     {
+        /// <summary>
+        /// Returns the next <see cref="PlaylistItem"/> to be played from the supplied <paramref name="playlist"/>,
+        /// or <see langword="null"/> if all items are expired.
+        /// </summary>
+        public static PlaylistItem? GetNextItem(this IEnumerable<PlaylistItem> playlist) =>
+            playlist.OrderBy(item => item.PlaylistOrder).FirstOrDefault(item => !item.Expired);
+
         public static string GetTotalDuration(this BindableList<PlaylistItem> playlist) =>
             playlist.Select(p => p.Beatmap.Value.Length).Sum().Milliseconds().Humanize(minUnit: TimeUnit.Second, maxUnit: TimeUnit.Hour, precision: 2);
     }

From a5a9922f81529f46d2efe46e11af0c6822512bf7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 20 Dec 2021 13:19:00 +0100
Subject: [PATCH 1729/5547] Fix lounge screen content not matching current room
 playlist item

---
 osu.Game.Tests/OnlinePlay/PlaylistExtensionsTest.cs       | 8 ++++----
 osu.Game/Online/Rooms/PlaylistExtensions.cs               | 4 ++--
 .../OnlinePlay/Components/OnlinePlayBackgroundSprite.cs   | 4 ++--
 .../Screens/OnlinePlay/Lounge/LoungeBackgroundScreen.cs   | 3 +--
 osu.Game/Screens/OnlinePlay/OnlinePlayComposite.cs        | 5 ++---
 5 files changed, 11 insertions(+), 13 deletions(-)

diff --git a/osu.Game.Tests/OnlinePlay/PlaylistExtensionsTest.cs b/osu.Game.Tests/OnlinePlay/PlaylistExtensionsTest.cs
index d2ee47bc23..001513be1f 100644
--- a/osu.Game.Tests/OnlinePlay/PlaylistExtensionsTest.cs
+++ b/osu.Game.Tests/OnlinePlay/PlaylistExtensionsTest.cs
@@ -19,7 +19,7 @@ namespace osu.Game.Tests.OnlinePlay
                 new PlaylistItem { ID = 3, BeatmapID = 1003, PlaylistOrder = 3 },
             };
 
-            var nextItem = items.GetNextItem();
+            var nextItem = items.GetCurrentItem();
 
             Assert.That(nextItem, Is.EqualTo(items[0]));
         }
@@ -34,7 +34,7 @@ namespace osu.Game.Tests.OnlinePlay
                 new PlaylistItem { ID = 3, BeatmapID = 1003, PlaylistOrder = 3 },
             };
 
-            var nextItem = items.GetNextItem();
+            var nextItem = items.GetCurrentItem();
 
             Assert.That(nextItem, Is.EqualTo(items[1]));
         }
@@ -49,7 +49,7 @@ namespace osu.Game.Tests.OnlinePlay
                 new PlaylistItem { ID = 3, BeatmapID = 1003, PlaylistOrder = 3 },
             };
 
-            var nextItem = items.GetNextItem();
+            var nextItem = items.GetCurrentItem();
 
             Assert.That(nextItem, Is.EqualTo(items[2]));
         }
@@ -64,7 +64,7 @@ namespace osu.Game.Tests.OnlinePlay
                 new PlaylistItem { ID = 3, BeatmapID = 1003, PlaylistOrder = 3, Expired = true },
             };
 
-            var nextItem = items.GetNextItem();
+            var nextItem = items.GetCurrentItem();
 
             Assert.That(nextItem, Is.Null);
         }
diff --git a/osu.Game/Online/Rooms/PlaylistExtensions.cs b/osu.Game/Online/Rooms/PlaylistExtensions.cs
index e900dc53ef..46cb218910 100644
--- a/osu.Game/Online/Rooms/PlaylistExtensions.cs
+++ b/osu.Game/Online/Rooms/PlaylistExtensions.cs
@@ -14,10 +14,10 @@ namespace osu.Game.Online.Rooms
     public static class PlaylistExtensions
     {
         /// <summary>
-        /// Returns the next <see cref="PlaylistItem"/> to be played from the supplied <paramref name="playlist"/>,
+        /// Returns the first non-expired <see cref="PlaylistItem"/> in playlist order from the supplied <paramref name="playlist"/>,
         /// or <see langword="null"/> if all items are expired.
         /// </summary>
-        public static PlaylistItem? GetNextItem(this IEnumerable<PlaylistItem> playlist) =>
+        public static PlaylistItem? GetCurrentItem(this IEnumerable<PlaylistItem> playlist) =>
             playlist.OrderBy(item => item.PlaylistOrder).FirstOrDefault(item => !item.Expired);
 
         public static string GetTotalDuration(this BindableList<PlaylistItem> playlist) =>
diff --git a/osu.Game/Screens/OnlinePlay/Components/OnlinePlayBackgroundSprite.cs b/osu.Game/Screens/OnlinePlay/Components/OnlinePlayBackgroundSprite.cs
index e2ba0b03b0..d144e1e3a9 100644
--- a/osu.Game/Screens/OnlinePlay/Components/OnlinePlayBackgroundSprite.cs
+++ b/osu.Game/Screens/OnlinePlay/Components/OnlinePlayBackgroundSprite.cs
@@ -1,10 +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.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Game.Beatmaps.Drawables;
+using osu.Game.Online.Rooms;
 
 namespace osu.Game.Screens.OnlinePlay.Components
 {
@@ -30,7 +30,7 @@ namespace osu.Game.Screens.OnlinePlay.Components
 
         private void updateBeatmap()
         {
-            sprite.Beatmap.Value = Playlist.FirstOrDefault()?.Beatmap.Value;
+            sprite.Beatmap.Value = Playlist.GetCurrentItem()?.Beatmap.Value;
         }
 
         protected virtual UpdateableBeatmapBackgroundSprite CreateBackgroundSprite() => new UpdateableBeatmapBackgroundSprite(BeatmapSetCoverType) { RelativeSizeAxes = Axes.Both };
diff --git a/osu.Game/Screens/OnlinePlay/Lounge/LoungeBackgroundScreen.cs b/osu.Game/Screens/OnlinePlay/Lounge/LoungeBackgroundScreen.cs
index 6c00ca2e81..926c35c5da 100644
--- a/osu.Game/Screens/OnlinePlay/Lounge/LoungeBackgroundScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Lounge/LoungeBackgroundScreen.cs
@@ -3,7 +3,6 @@
 
 #nullable enable
 
-using System.Linq;
 using osu.Framework.Bindables;
 using osu.Framework.Screens;
 using osu.Game.Online.Rooms;
@@ -20,7 +19,7 @@ namespace osu.Game.Screens.OnlinePlay.Lounge
         public LoungeBackgroundScreen()
         {
             SelectedRoom.BindValueChanged(onSelectedRoomChanged);
-            playlist.BindCollectionChanged((_, __) => PlaylistItem = playlist.FirstOrDefault());
+            playlist.BindCollectionChanged((_, __) => PlaylistItem = playlist.GetCurrentItem());
         }
 
         private void onSelectedRoomChanged(ValueChangedEvent<Room> room)
diff --git a/osu.Game/Screens/OnlinePlay/OnlinePlayComposite.cs b/osu.Game/Screens/OnlinePlay/OnlinePlayComposite.cs
index 6b111d76a5..c833621fbc 100644
--- a/osu.Game/Screens/OnlinePlay/OnlinePlayComposite.cs
+++ b/osu.Game/Screens/OnlinePlay/OnlinePlayComposite.cs
@@ -2,7 +2,6 @@
 // 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.Graphics.Containers;
@@ -73,7 +72,7 @@ namespace osu.Game.Screens.OnlinePlay
         private IBindable<PlaylistItem> subScreenSelectedItem { get; set; }
 
         /// <summary>
-        /// The currently selected item in the <see cref="RoomSubScreen"/>, or the last item from <see cref="Playlist"/>
+        /// The currently selected item in the <see cref="RoomSubScreen"/>, or the current item from <see cref="Playlist"/>
         /// if this <see cref="OnlinePlayComposite"/> is not within a <see cref="RoomSubScreen"/>.
         /// </summary>
         protected readonly Bindable<PlaylistItem> SelectedItem = new Bindable<PlaylistItem>();
@@ -88,7 +87,7 @@ namespace osu.Game.Screens.OnlinePlay
 
         protected virtual void UpdateSelectedItem()
             => SelectedItem.Value = RoomID.Value == null || subScreenSelectedItem == null
-                ? Playlist.LastOrDefault()
+                ? Playlist.GetCurrentItem()
                 : subScreenSelectedItem.Value;
     }
 }

From 0975f570ba2bdf82dd4aee1bd36412b94cb0b31e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 20 Dec 2021 13:42:49 +0100
Subject: [PATCH 1730/5547] Return last playlist item if all expired

---
 .../OnlinePlay/PlaylistExtensionsTest.cs      | 29 ++++++++++++++-----
 osu.Game/Online/Rooms/PlaylistExtensions.cs   | 14 +++++++--
 2 files changed, 32 insertions(+), 11 deletions(-)

diff --git a/osu.Game.Tests/OnlinePlay/PlaylistExtensionsTest.cs b/osu.Game.Tests/OnlinePlay/PlaylistExtensionsTest.cs
index 001513be1f..5913cb0f29 100644
--- a/osu.Game.Tests/OnlinePlay/PlaylistExtensionsTest.cs
+++ b/osu.Game.Tests/OnlinePlay/PlaylistExtensionsTest.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 NUnit.Framework;
 using osu.Game.Online.Rooms;
 
@@ -9,6 +10,17 @@ namespace osu.Game.Tests.OnlinePlay
     [TestFixture]
     public class PlaylistExtensionsTest
     {
+        [Test]
+        public void TestEmpty()
+        {
+            // mostly an extreme edge case, i.e. during room creation.
+            var items = Array.Empty<PlaylistItem>();
+
+            var currentItem = items.GetCurrentItem();
+
+            Assert.That(currentItem, Is.Null);
+        }
+
         [Test]
         public void TestPlaylistItemsInOrder()
         {
@@ -19,9 +31,9 @@ namespace osu.Game.Tests.OnlinePlay
                 new PlaylistItem { ID = 3, BeatmapID = 1003, PlaylistOrder = 3 },
             };
 
-            var nextItem = items.GetCurrentItem();
+            var currentItem = items.GetCurrentItem();
 
-            Assert.That(nextItem, Is.EqualTo(items[0]));
+            Assert.That(currentItem, Is.EqualTo(items[0]));
         }
 
         [Test]
@@ -34,9 +46,9 @@ namespace osu.Game.Tests.OnlinePlay
                 new PlaylistItem { ID = 3, BeatmapID = 1003, PlaylistOrder = 3 },
             };
 
-            var nextItem = items.GetCurrentItem();
+            var currentItem = items.GetCurrentItem();
 
-            Assert.That(nextItem, Is.EqualTo(items[1]));
+            Assert.That(currentItem, Is.EqualTo(items[1]));
         }
 
         [Test]
@@ -49,9 +61,9 @@ namespace osu.Game.Tests.OnlinePlay
                 new PlaylistItem { ID = 3, BeatmapID = 1003, PlaylistOrder = 3 },
             };
 
-            var nextItem = items.GetCurrentItem();
+            var currentItem = items.GetCurrentItem();
 
-            Assert.That(nextItem, Is.EqualTo(items[2]));
+            Assert.That(currentItem, Is.EqualTo(items[2]));
         }
 
         [Test]
@@ -64,9 +76,10 @@ namespace osu.Game.Tests.OnlinePlay
                 new PlaylistItem { ID = 3, BeatmapID = 1003, PlaylistOrder = 3, Expired = true },
             };
 
-            var nextItem = items.GetCurrentItem();
+            var currentItem = items.GetCurrentItem();
 
-            Assert.That(nextItem, Is.Null);
+            // if all items are expired, the last-played item is expected to be returned.
+            Assert.That(currentItem, Is.EqualTo(items[2]));
         }
     }
 }
diff --git a/osu.Game/Online/Rooms/PlaylistExtensions.cs b/osu.Game/Online/Rooms/PlaylistExtensions.cs
index 46cb218910..355ae6188d 100644
--- a/osu.Game/Online/Rooms/PlaylistExtensions.cs
+++ b/osu.Game/Online/Rooms/PlaylistExtensions.cs
@@ -15,10 +15,18 @@ namespace osu.Game.Online.Rooms
     {
         /// <summary>
         /// Returns the first non-expired <see cref="PlaylistItem"/> in playlist order from the supplied <paramref name="playlist"/>,
-        /// or <see langword="null"/> if all items are expired.
+        /// or the last-played <see cref="PlaylistItem"/> if all items are expired,
+        /// or <see langword="null"/> if <paramref name="playlist"/> was empty.
         /// </summary>
-        public static PlaylistItem? GetCurrentItem(this IEnumerable<PlaylistItem> playlist) =>
-            playlist.OrderBy(item => item.PlaylistOrder).FirstOrDefault(item => !item.Expired);
+        public static PlaylistItem? GetCurrentItem(this ICollection<PlaylistItem> playlist)
+        {
+            if (playlist.Count == 0)
+                return null;
+
+            return playlist.All(item => item.Expired)
+                ? playlist.OrderByDescending(item => item.PlaylistOrder).First()
+                : playlist.OrderBy(item => item.PlaylistOrder).First(item => !item.Expired);
+        }
 
         public static string GetTotalDuration(this BindableList<PlaylistItem> playlist) =>
             playlist.Select(p => p.Beatmap.Value.Length).Sum().Milliseconds().Humanize(minUnit: TimeUnit.Second, maxUnit: TimeUnit.Hour, precision: 2);

From 9344897542ff6b6463d8377d61f63b3ec0c8b5b3 Mon Sep 17 00:00:00 2001
From: dekrain <dawidkrainski8@gmail.com>
Date: Mon, 20 Dec 2021 16:51:51 +0100
Subject: [PATCH 1731/5547] Split session statics reset method to prevent
 unloading seasonal backgrounds while idle

---
 osu.Game/Configuration/SessionStatics.cs | 16 +++++++++++++---
 1 file changed, 13 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Configuration/SessionStatics.cs b/osu.Game/Configuration/SessionStatics.cs
index ac94c39bd2..99f1e5a8b2 100644
--- a/osu.Game/Configuration/SessionStatics.cs
+++ b/osu.Game/Configuration/SessionStatics.cs
@@ -13,9 +13,7 @@ namespace osu.Game.Configuration
     /// </summary>
     public class SessionStatics : InMemoryConfigManager<Static>
     {
-        protected override void InitialiseDefaults() => ResetValues();
-
-        public void ResetValues()
+        protected override void InitialiseDefaults()
         {
             ensureDefault(SetDefault(Static.LoginOverlayDisplayed, false));
             ensureDefault(SetDefault(Static.MutedAudioNotificationShownOnce, false));
@@ -24,6 +22,18 @@ namespace osu.Game.Configuration
             ensureDefault(SetDefault<APISeasonalBackgrounds>(Static.SeasonalBackgrounds, null));
         }
 
+        /// <summary>
+        /// Used to revert statics to their defaults after being idle for appropiate amount of time.
+        /// Does not affect loaded seasonal backgrounds.
+        /// </summary>
+        public void ResetValues()
+        {
+            ensureDefault(GetBindable<bool>(Static.LoginOverlayDisplayed));
+            ensureDefault(GetBindable<bool>(Static.MutedAudioNotificationShownOnce));
+            ensureDefault(GetBindable<bool>(Static.LowBatteryNotificationShownOnce));
+            ensureDefault(GetBindable<double?>(Static.LastHoverSoundPlaybackTime));
+        }
+
         private void ensureDefault<T>(Bindable<T> bindable) => bindable.SetDefault();
     }
 

From b0ca82e1e530c73a31324586da2d42bd505db547 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 20 Dec 2021 20:56:06 +0100
Subject: [PATCH 1732/5547] Move slider path point drag handling to visualiser

---
 .../Components/PathControlPointPiece.cs       | 60 +++---------------
 .../Components/PathControlPointVisualiser.cs  | 62 +++++++++++++++++++
 2 files changed, 70 insertions(+), 52 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 b3e0566a98..dd1a2d69fb 100644
--- a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointPiece.cs
+++ b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointPiece.cs
@@ -16,11 +16,9 @@ using osu.Framework.Input.Events;
 using osu.Framework.Localisation;
 using osu.Framework.Utils;
 using osu.Game.Graphics;
-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.Screens.Edit;
 using osuTK;
 using osuTK.Graphics;
 using osuTK.Input;
@@ -33,6 +31,11 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders.Components
     public class PathControlPointPiece : BlueprintPiece<Slider>, IHasTooltip
     {
         public Action<PathControlPointPiece, MouseButtonEvent> RequestSelection;
+
+        public Action<PathControlPoint> DragStarted;
+        public Action<PathControlPoint, DragEvent> DragInProgress;
+        public Action DragEnded;
+
         public List<PathControlPoint> PointsInSegment;
 
         public readonly BindableBool IsSelected = new BindableBool();
@@ -42,12 +45,6 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders.Components
         private readonly Container marker;
         private readonly Drawable markerRing;
 
-        [Resolved(CanBeNull = true)]
-        private IEditorChangeHandler changeHandler { get; set; }
-
-        [Resolved(CanBeNull = true)]
-        private IPositionSnapProvider snapProvider { get; set; }
-
         [Resolved]
         private OsuColour colours { get; set; }
 
@@ -160,9 +157,6 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders.Components
 
         protected override bool OnClick(ClickEvent e) => RequestSelection != null;
 
-        private Vector2 dragStartPosition;
-        private PathType? dragPathType;
-
         protected override bool OnDragStart(DragStartEvent e)
         {
             if (RequestSelection == null)
@@ -170,54 +164,16 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders.Components
 
             if (e.Button == MouseButton.Left)
             {
-                dragStartPosition = ControlPoint.Position;
-                dragPathType = PointsInSegment[0].Type;
-
-                changeHandler?.BeginChange();
+                DragStarted?.Invoke(ControlPoint);
                 return true;
             }
 
             return false;
         }
 
-        protected override void OnDrag(DragEvent e)
-        {
-            Vector2[] oldControlPoints = slider.Path.ControlPoints.Select(cp => cp.Position).ToArray();
-            var oldPosition = slider.Position;
-            double oldStartTime = slider.StartTime;
+        protected override void OnDrag(DragEvent e) => DragInProgress?.Invoke(ControlPoint, e);
 
-            if (ControlPoint == slider.Path.ControlPoints[0])
-            {
-                // Special handling for the head control point - the position of the slider changes which means the snapped position and time have to be taken into account
-                var result = snapProvider?.SnapScreenSpacePositionToValidTime(e.ScreenSpaceMousePosition);
-
-                Vector2 movementDelta = Parent.ToLocalSpace(result?.ScreenSpacePosition ?? e.ScreenSpaceMousePosition) - slider.Position;
-
-                slider.Position += movementDelta;
-                slider.StartTime = result?.Time ?? slider.StartTime;
-
-                // Since control points are relative to the position of the slider, they all need to be offset backwards by the delta
-                for (int i = 1; i < slider.Path.ControlPoints.Count; i++)
-                    slider.Path.ControlPoints[i].Position -= movementDelta;
-            }
-            else
-                ControlPoint.Position = dragStartPosition + (e.MousePosition - e.MouseDownPosition);
-
-            if (!slider.Path.HasValidLength)
-            {
-                for (int i = 0; i < slider.Path.ControlPoints.Count; i++)
-                    slider.Path.ControlPoints[i].Position = oldControlPoints[i];
-
-                slider.Position = oldPosition;
-                slider.StartTime = oldStartTime;
-                return;
-            }
-
-            // Maintain the path type in case it got defaulted to bezier at some point during the drag.
-            PointsInSegment[0].Type = dragPathType;
-        }
-
-        protected override void OnDragEnd(DragEndEvent e) => changeHandler?.EndChange();
+        protected override void OnDragEnd(DragEndEvent e) => DragEnded?.Invoke();
 
         private void cachePoints(Slider slider) => PointsInSegment = slider.Path.PointsInSegment(ControlPoint);
 
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 1be9b5bf2e..017bc395f0 100644
--- a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointVisualiser.cs
+++ b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointVisualiser.cs
@@ -16,6 +16,7 @@ using osu.Framework.Input;
 using osu.Framework.Input.Bindings;
 using osu.Framework.Input.Events;
 using osu.Game.Graphics.UserInterface;
+using osu.Game.Rulesets.Edit;
 using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Objects.Types;
 using osu.Game.Rulesets.Osu.Objects;
@@ -40,6 +41,9 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders.Components
 
         public Action<List<PathControlPoint>> RemoveControlPointsRequested;
 
+        [Resolved(CanBeNull = true)]
+        private IPositionSnapProvider snapProvider { get; set; }
+
         public PathControlPointVisualiser(Slider slider, bool allowSelection)
         {
             this.slider = slider;
@@ -88,6 +92,10 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders.Components
                         {
                             if (allowSelection)
                                 d.RequestSelection = selectPiece;
+
+                            d.DragStarted = dragStarted;
+                            d.DragInProgress = dragInProgress;
+                            d.DragEnded = dragEnded;
                         }));
 
                         Connections.Add(new PathControlPointConnectionPiece(slider, e.NewStartingIndex + i));
@@ -203,6 +211,60 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders.Components
             return true;
         }
 
+        #region Drag handling
+
+        private Vector2 dragStartPosition;
+        private PathType? dragPathType;
+
+        private void dragStarted(PathControlPoint controlPoint)
+        {
+            dragStartPosition = controlPoint.Position;
+            dragPathType = slider.Path.PointsInSegment(controlPoint).First().Type;
+
+            changeHandler?.BeginChange();
+        }
+
+        private void dragInProgress(PathControlPoint controlPoint, DragEvent e)
+        {
+            Vector2[] oldControlPoints = slider.Path.ControlPoints.Select(cp => cp.Position).ToArray();
+            var oldPosition = slider.Position;
+            double oldStartTime = slider.StartTime;
+
+            if (controlPoint == slider.Path.ControlPoints[0])
+            {
+                // Special handling for the head control point - the position of the slider changes which means the snapped position and time have to be taken into account
+                var result = snapProvider?.SnapScreenSpacePositionToValidTime(e.ScreenSpaceMousePosition);
+
+                Vector2 movementDelta = Parent.ToLocalSpace(result?.ScreenSpacePosition ?? e.ScreenSpaceMousePosition) - slider.Position;
+
+                slider.Position += movementDelta;
+                slider.StartTime = result?.Time ?? slider.StartTime;
+
+                // Since control points are relative to the position of the slider, they all need to be offset backwards by the delta
+                for (int i = 1; i < slider.Path.ControlPoints.Count; i++)
+                    slider.Path.ControlPoints[i].Position -= movementDelta;
+            }
+            else
+                controlPoint.Position = dragStartPosition + (e.MousePosition - e.MouseDownPosition);
+
+            if (!slider.Path.HasValidLength)
+            {
+                for (int i = 0; i < slider.Path.ControlPoints.Count; i++)
+                    slider.Path.ControlPoints[i].Position = oldControlPoints[i];
+
+                slider.Position = oldPosition;
+                slider.StartTime = oldStartTime;
+                return;
+            }
+
+            // Maintain the path type in case it got defaulted to bezier at some point during the drag.
+            slider.Path.PointsInSegment(controlPoint).First().Type = dragPathType;
+        }
+
+        private void dragEnded() => changeHandler?.EndChange();
+
+        #endregion
+
         public MenuItem[] ContextMenuItems
         {
             get

From fbba8293c76965b49a1db3cc4e6853cd1df7be89 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 20 Dec 2021 21:01:11 +0100
Subject: [PATCH 1733/5547] Add failing test for expected multiple path drag UX

---
 .../TestSceneSliderControlPointPiece.cs       | 28 +++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderControlPointPiece.cs b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderControlPointPiece.cs
index 6bfe7f892b..282e7a479e 100644
--- a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderControlPointPiece.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderControlPointPiece.cs
@@ -60,6 +60,34 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
             assertControlPointType(0, PathType.PerfectCurve);
         }
 
+        [Test]
+        public void TestDragMultipleControlPoints()
+        {
+            moveMouseToControlPoint(2);
+            AddStep("click", () => InputManager.Click(MouseButton.Left));
+
+            AddStep("hold control", () => InputManager.PressKey(Key.LControl));
+
+            moveMouseToControlPoint(3);
+            AddStep("click", () => InputManager.Click(MouseButton.Left));
+
+            moveMouseToControlPoint(4);
+            AddStep("click", () => InputManager.Click(MouseButton.Left));
+
+            moveMouseToControlPoint(2);
+            addMovementStep(new Vector2(450, 50));
+            AddStep("release", () => InputManager.ReleaseButton(MouseButton.Left));
+
+            assertControlPointPosition(2, new Vector2(450, 50));
+            assertControlPointType(2, PathType.PerfectCurve);
+
+            assertControlPointPosition(3, new Vector2(550, 50));
+
+            assertControlPointPosition(4, new Vector2(550, 200));
+
+            AddStep("release control", () => InputManager.ReleaseKey(Key.LControl));
+        }
+
         [Test]
         public void TestDragControlPointAlmostLinearlyExterior()
         {

From a9408485cc9fc00f5d85d7a835fb260834ea1426 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 20 Dec 2021 21:18:38 +0100
Subject: [PATCH 1734/5547] Change control point piece selection logic to allow
 dragging multiple

---
 .../Components/PathControlPointPiece.cs       | 23 ++++++++++++++++++-
 1 file changed, 22 insertions(+), 1 deletion(-)

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 dd1a2d69fb..d219fb0b2d 100644
--- a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointPiece.cs
+++ b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointPiece.cs
@@ -135,6 +135,10 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders.Components
             updateMarkerDisplay();
         }
 
+        // Used to pair up mouse down events which caused this piece to be selected
+        // with their corresponding mouse up events.
+        private bool selectionPerformed;
+
         protected override bool OnMouseDown(MouseDownEvent e)
         {
             if (RequestSelection == null)
@@ -143,7 +147,12 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders.Components
             switch (e.Button)
             {
                 case MouseButton.Left:
-                    RequestSelection.Invoke(this, e);
+                    if (!IsSelected.Value)
+                    {
+                        RequestSelection.Invoke(this, e);
+                        selectionPerformed = true;
+                    }
+
                     return true;
 
                 case MouseButton.Right:
@@ -155,6 +164,18 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders.Components
             return false;
         }
 
+        protected override void OnMouseUp(MouseUpEvent e)
+        {
+            base.OnMouseUp(e);
+
+            // ctrl+click deselects this piece, but only if this event
+            // wasn't immediately preceded by a matching mouse down.
+            if (IsSelected.Value && e.ControlPressed && !selectionPerformed)
+                IsSelected.Value = false;
+
+            selectionPerformed = false;
+        }
+
         protected override bool OnClick(ClickEvent e) => RequestSelection != null;
 
         protected override bool OnDragStart(DragStartEvent e)

From d2417beeacc82da7802ce0b2499114a4c8d615a7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 20 Dec 2021 21:29:57 +0100
Subject: [PATCH 1735/5547] Implement drag operation for multiple path control
 points

---
 .../TestSceneSliderControlPointPiece.cs       |  9 ++--
 .../Components/PathControlPointPiece.cs       |  8 ++--
 .../Components/PathControlPointVisualiser.cs  | 43 +++++++++++++------
 3 files changed, 39 insertions(+), 21 deletions(-)

diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderControlPointPiece.cs b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderControlPointPiece.cs
index 282e7a479e..91c75c376d 100644
--- a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderControlPointPiece.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderControlPointPiece.cs
@@ -64,19 +64,20 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
         public void TestDragMultipleControlPoints()
         {
             moveMouseToControlPoint(2);
-            AddStep("click", () => InputManager.Click(MouseButton.Left));
+            AddStep("click left mouse", () => InputManager.Click(MouseButton.Left));
 
             AddStep("hold control", () => InputManager.PressKey(Key.LControl));
 
             moveMouseToControlPoint(3);
-            AddStep("click", () => InputManager.Click(MouseButton.Left));
+            AddStep("click left mouse", () => InputManager.Click(MouseButton.Left));
 
             moveMouseToControlPoint(4);
-            AddStep("click", () => InputManager.Click(MouseButton.Left));
+            AddStep("click left mouse", () => InputManager.Click(MouseButton.Left));
 
             moveMouseToControlPoint(2);
+            AddStep("hold left mouse", () => InputManager.PressButton(MouseButton.Left));
             addMovementStep(new Vector2(450, 50));
-            AddStep("release", () => InputManager.ReleaseButton(MouseButton.Left));
+            AddStep("release left mouse", () => InputManager.ReleaseButton(MouseButton.Left));
 
             assertControlPointPosition(2, new Vector2(450, 50));
             assertControlPointType(2, PathType.PerfectCurve);
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 d219fb0b2d..da9b8ec9e4 100644
--- a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointPiece.cs
+++ b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointPiece.cs
@@ -32,8 +32,8 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders.Components
     {
         public Action<PathControlPointPiece, MouseButtonEvent> RequestSelection;
 
-        public Action<PathControlPoint> DragStarted;
-        public Action<PathControlPoint, DragEvent> DragInProgress;
+        public Action DragStarted;
+        public Action<DragEvent> DragInProgress;
         public Action DragEnded;
 
         public List<PathControlPoint> PointsInSegment;
@@ -185,14 +185,14 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders.Components
 
             if (e.Button == MouseButton.Left)
             {
-                DragStarted?.Invoke(ControlPoint);
+                DragStarted?.Invoke();
                 return true;
             }
 
             return false;
         }
 
-        protected override void OnDrag(DragEvent e) => DragInProgress?.Invoke(ControlPoint, e);
+        protected override void OnDrag(DragEvent e) => DragInProgress?.Invoke(e);
 
         protected override void OnDragEnd(DragEndEvent e) => DragEnded?.Invoke();
 
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 017bc395f0..97775d8122 100644
--- a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointVisualiser.cs
+++ b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointVisualiser.cs
@@ -213,26 +213,28 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders.Components
 
         #region Drag handling
 
-        private Vector2 dragStartPosition;
-        private PathType? dragPathType;
+        private Vector2[] dragStartPositions;
+        private PathType?[] dragPathTypes;
+        private HashSet<PathControlPoint> draggedControlPoints;
 
-        private void dragStarted(PathControlPoint controlPoint)
+        private void dragStarted()
         {
-            dragStartPosition = controlPoint.Position;
-            dragPathType = slider.Path.PointsInSegment(controlPoint).First().Type;
+            dragStartPositions = slider.Path.ControlPoints.Select(point => point.Position).ToArray();
+            dragPathTypes = slider.Path.ControlPoints.Select(point => point.Type).ToArray();
+            draggedControlPoints = new HashSet<PathControlPoint>(Pieces.Where(piece => piece.IsSelected.Value).Select(piece => piece.ControlPoint));
 
             changeHandler?.BeginChange();
         }
 
-        private void dragInProgress(PathControlPoint controlPoint, DragEvent e)
+        private void dragInProgress(DragEvent e)
         {
             Vector2[] oldControlPoints = slider.Path.ControlPoints.Select(cp => cp.Position).ToArray();
             var oldPosition = slider.Position;
             double oldStartTime = slider.StartTime;
 
-            if (controlPoint == slider.Path.ControlPoints[0])
+            if (draggedControlPoints.Contains(slider.Path.ControlPoints[0]))
             {
-                // Special handling for the head control point - the position of the slider changes which means the snapped position and time have to be taken into account
+                // Special handling for selections containing head control point - the position of the slider changes which means the snapped position and time have to be taken into account
                 var result = snapProvider?.SnapScreenSpacePositionToValidTime(e.ScreenSpaceMousePosition);
 
                 Vector2 movementDelta = Parent.ToLocalSpace(result?.ScreenSpacePosition ?? e.ScreenSpaceMousePosition) - slider.Position;
@@ -240,12 +242,26 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders.Components
                 slider.Position += movementDelta;
                 slider.StartTime = result?.Time ?? slider.StartTime;
 
-                // Since control points are relative to the position of the slider, they all need to be offset backwards by the delta
                 for (int i = 1; i < slider.Path.ControlPoints.Count; i++)
-                    slider.Path.ControlPoints[i].Position -= movementDelta;
+                {
+                    var controlPoint = slider.Path.ControlPoints[i];
+                    // Since control points are relative to the position of the slider, all points that are _not_ selected
+                    // need to be offset _back_ by the delta corresponding to the movement of the head point.
+                    // All other selected control points (if any) will move together with the head point
+                    // (and so they will not move at all, relative to each other).
+                    if (!draggedControlPoints.Contains(controlPoint))
+                        controlPoint.Position -= movementDelta;
+                }
             }
             else
-                controlPoint.Position = dragStartPosition + (e.MousePosition - e.MouseDownPosition);
+            {
+                for (int i = 0; i < controlPoints.Count; ++i)
+                {
+                    var controlPoint = controlPoints[i];
+                    if (draggedControlPoints.Contains(controlPoint))
+                        controlPoint.Position = dragStartPositions[i] + (e.MousePosition - e.MouseDownPosition);
+                }
+            }
 
             if (!slider.Path.HasValidLength)
             {
@@ -257,8 +273,9 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders.Components
                 return;
             }
 
-            // Maintain the path type in case it got defaulted to bezier at some point during the drag.
-            slider.Path.PointsInSegment(controlPoint).First().Type = dragPathType;
+            // Maintain the path types in case they got defaulted to bezier at some point during the drag.
+            for (int i = 0; i < slider.Path.ControlPoints.Count; i++)
+                slider.Path.ControlPoints[i].Type = dragPathTypes[i];
         }
 
         private void dragEnded() => changeHandler?.EndChange();

From cdb587d9562aa484707dfad642559b0eeb55c7b8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 20 Dec 2021 21:51:56 +0100
Subject: [PATCH 1736/5547] Add more test steps for input handling edge cases

---
 .../Editor/TestSceneSliderControlPointPiece.cs        | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderControlPointPiece.cs b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderControlPointPiece.cs
index 91c75c376d..7afe9d91e0 100644
--- a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderControlPointPiece.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderControlPointPiece.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.Linq;
 using NUnit.Framework;
+using osu.Framework.Testing;
 using osu.Framework.Utils;
 using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.ControlPoints;
@@ -76,9 +78,14 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
 
             moveMouseToControlPoint(2);
             AddStep("hold left mouse", () => InputManager.PressButton(MouseButton.Left));
+
+            AddAssert("three control point pieces selected", () => this.ChildrenOfType<PathControlPointPiece>().Count(piece => piece.IsSelected.Value) == 3);
+
             addMovementStep(new Vector2(450, 50));
             AddStep("release left mouse", () => InputManager.ReleaseButton(MouseButton.Left));
 
+            AddAssert("three control point pieces selected", () => this.ChildrenOfType<PathControlPointPiece>().Count(piece => piece.IsSelected.Value) == 3);
+
             assertControlPointPosition(2, new Vector2(450, 50));
             assertControlPointType(2, PathType.PerfectCurve);
 
@@ -87,6 +94,10 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
             assertControlPointPosition(4, new Vector2(550, 200));
 
             AddStep("release control", () => InputManager.ReleaseKey(Key.LControl));
+
+            moveMouseToControlPoint(3);
+            AddStep("click left mouse", () => InputManager.Click(MouseButton.Left));
+            AddAssert("only one control point piece selected", () => this.ChildrenOfType<PathControlPointPiece>().Count(piece => piece.IsSelected.Value) == 1);
         }
 
         [Test]

From bf8c87e9b7295e0d47e8166150867d6232c1df25 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 20 Dec 2021 21:53:51 +0100
Subject: [PATCH 1737/5547] Fix releasing mouse after drag deselecting dragged
 point

---
 .../Sliders/Components/PathControlPointPiece.cs   | 15 ++++++++-------
 1 file changed, 8 insertions(+), 7 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 da9b8ec9e4..57a65a84e3 100644
--- a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointPiece.cs
+++ b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointPiece.cs
@@ -135,9 +135,9 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders.Components
             updateMarkerDisplay();
         }
 
-        // Used to pair up mouse down events which caused this piece to be selected
-        // with their corresponding mouse up events.
-        private bool selectionPerformed;
+        // Used to pair up mouse down/drag events with their corresponding mouse up events,
+        // to avoid deselecting the piece by accident when the mouse up corresponding to the mouse down/drag fires.
+        private bool keepSelection;
 
         protected override bool OnMouseDown(MouseDownEvent e)
         {
@@ -150,7 +150,7 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders.Components
                     if (!IsSelected.Value)
                     {
                         RequestSelection.Invoke(this, e);
-                        selectionPerformed = true;
+                        keepSelection = true;
                     }
 
                     return true;
@@ -169,11 +169,11 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders.Components
             base.OnMouseUp(e);
 
             // ctrl+click deselects this piece, but only if this event
-            // wasn't immediately preceded by a matching mouse down.
-            if (IsSelected.Value && e.ControlPressed && !selectionPerformed)
+            // wasn't immediately preceded by a matching mouse down or drag.
+            if (IsSelected.Value && e.ControlPressed && !keepSelection)
                 IsSelected.Value = false;
 
-            selectionPerformed = false;
+            keepSelection = false;
         }
 
         protected override bool OnClick(ClickEvent e) => RequestSelection != null;
@@ -186,6 +186,7 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders.Components
             if (e.Button == MouseButton.Left)
             {
                 DragStarted?.Invoke();
+                keepSelection = true;
                 return true;
             }
 

From 5ef4e2333573408c5fc73475d289e6bae5b2e94f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 20 Dec 2021 21:56:06 +0100
Subject: [PATCH 1738/5547] Fix selecting control points without control not
 deselecting other selected points

---
 .../Sliders/Components/PathControlPointPiece.cs     | 13 ++++++++-----
 1 file changed, 8 insertions(+), 5 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 57a65a84e3..7b9b6cb976 100644
--- a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointPiece.cs
+++ b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointPiece.cs
@@ -147,11 +147,14 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders.Components
             switch (e.Button)
             {
                 case MouseButton.Left:
-                    if (!IsSelected.Value)
-                    {
-                        RequestSelection.Invoke(this, e);
-                        keepSelection = true;
-                    }
+                    // if control is pressed, do not do anything as the user may be adding to current selection
+                    // or dragging all currently selected control points.
+                    // if it isn't and the user's intent is to deselect, deselection will happen on mouse up.
+                    if (e.ControlPressed && IsSelected.Value)
+                        return true;
+
+                    RequestSelection.Invoke(this, e);
+                    keepSelection = true;
 
                     return true;
 

From b311308ada7bd524a0557323eaa8a4f3c197d6b2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 20 Dec 2021 22:09:01 +0100
Subject: [PATCH 1739/5547] Add more comprehensive test of multiple selection

---
 .../TestSceneSliderControlPointPiece.cs       | 45 +++++++++++++++++--
 1 file changed, 41 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderControlPointPiece.cs b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderControlPointPiece.cs
index 7afe9d91e0..7ae66b7ba7 100644
--- a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderControlPointPiece.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderControlPointPiece.cs
@@ -2,6 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System.Linq;
+using Humanizer;
 using NUnit.Framework;
 using osu.Framework.Testing;
 using osu.Framework.Utils;
@@ -49,6 +50,46 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
             AddBlueprint(new TestSliderBlueprint(slider), drawableObject);
         });
 
+        [Test]
+        public void TestSelection()
+        {
+            moveMouseToControlPoint(0);
+            AddStep("click left mouse", () => InputManager.Click(MouseButton.Left));
+            assertSelectionCount(1);
+            assertSelected(0);
+
+            moveMouseToControlPoint(3);
+            AddStep("click left mouse", () => InputManager.Click(MouseButton.Left));
+            assertSelectionCount(1);
+            assertSelected(3);
+
+            AddStep("press control", () => InputManager.PressKey(Key.ControlLeft));
+            moveMouseToControlPoint(2);
+            AddStep("click left mouse", () => InputManager.Click(MouseButton.Left));
+            assertSelectionCount(2);
+            assertSelected(2);
+            assertSelected(3);
+
+            moveMouseToControlPoint(0);
+            AddStep("click left mouse", () => InputManager.Click(MouseButton.Left));
+            assertSelectionCount(3);
+            assertSelected(0);
+            assertSelected(2);
+            assertSelected(3);
+
+            AddStep("release control", () => InputManager.ReleaseKey(Key.ControlLeft));
+            AddStep("click left mouse", () => InputManager.Click(MouseButton.Left));
+            assertSelectionCount(1);
+            assertSelected(0);
+
+            void assertSelectionCount(int count) =>
+                AddAssert($"{count} control point pieces selected", () => this.ChildrenOfType<PathControlPointPiece>().Count(piece => piece.IsSelected.Value) == count);
+
+            void assertSelected(int index) =>
+                AddAssert($"{(index + 1).ToOrdinalWords()} control point piece selected",
+                    () => this.ChildrenOfType<PathControlPointPiece>().Single(piece => piece.ControlPoint == slider.Path.ControlPoints[index]).IsSelected.Value);
+        }
+
         [Test]
         public void TestDragControlPoint()
         {
@@ -94,10 +135,6 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
             assertControlPointPosition(4, new Vector2(550, 200));
 
             AddStep("release control", () => InputManager.ReleaseKey(Key.LControl));
-
-            moveMouseToControlPoint(3);
-            AddStep("click left mouse", () => InputManager.Click(MouseButton.Left));
-            AddAssert("only one control point piece selected", () => this.ChildrenOfType<PathControlPointPiece>().Count(piece => piece.IsSelected.Value) == 1);
         }
 
         [Test]

From e21dbf10ff7734be7b0493d488f311e1a1657f1b Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 21 Dec 2021 12:25:32 +0900
Subject: [PATCH 1740/5547] Refactor further to remove indexing confusion

---
 .../Difficulty/Skills/Flashlight.cs           | 23 ++++++++++---------
 1 file changed, 12 insertions(+), 11 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
index 21a2fc2252..ad7464244e 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
@@ -40,32 +40,33 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
 
             double result = 0.0;
 
+            OsuDifficultyHitObject lastObj = null;
+
+            // This is iterating backwards in time from the current object.
             for (int i = 0; i < Previous.Count; i++)
             {
-                var osuLoop = (OsuDifficultyHitObject)Previous[i];
-                var osuLoopHitObject = (OsuHitObject)(osuLoop.BaseObject);
+                var currentObj = (OsuDifficultyHitObject)Previous[i];
+                var currentHitObject = (OsuHitObject)(currentObj.BaseObject);
 
-                OsuDifficultyHitObject osuLoopNext;
-                if (i == 0)
-                    osuLoopNext = osuCurrent;
-                else
-                    osuLoopNext = (OsuDifficultyHitObject)Previous[i - 1];
+                lastObj ??= currentObj;
 
-                if (!(osuLoop.BaseObject is Spinner))
+                if (!(currentObj.BaseObject is Spinner))
                 {
-                    double jumpDistance = (osuHitObject.StackedPosition - osuLoopHitObject.EndPosition).Length;
+                    double jumpDistance = (osuHitObject.StackedPosition - currentHitObject.EndPosition).Length;
 
-                    cumulativeStrainTime += osuLoopNext.StrainTime;
+                    cumulativeStrainTime += lastObj.StrainTime;
 
                     // We want to nerf objects that can be easily seen within the Flashlight circle radius.
                     if (i == 0)
                         smallDistNerf = Math.Min(1.0, jumpDistance / 75.0);
 
                     // We also want to nerf stacks so that only the first object of the stack is accounted for.
-                    double stackNerf = Math.Min(1.0, (osuLoop.LazyJumpDistance / scalingFactor) / 25.0);
+                    double stackNerf = Math.Min(1.0, (currentObj.LazyJumpDistance / scalingFactor) / 25.0);
 
                     result += Math.Pow(0.8, i) * stackNerf * scalingFactor * jumpDistance / cumulativeStrainTime;
                 }
+
+                lastObj = currentObj;
             }
 
             return Math.Pow(smallDistNerf * result, 2.0);

From 28d6ff5d9c8bac9390e7576829623798934fc61a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 21 Dec 2021 12:36:01 +0900
Subject: [PATCH 1741/5547] Fix potential wrong thread mutation in
 `ColourHitErrorMeter`

---
 .../Screens/Play/HUD/HitErrorMeters/ColourHitErrorMeter.cs    | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/Play/HUD/HitErrorMeters/ColourHitErrorMeter.cs b/osu.Game/Screens/Play/HUD/HitErrorMeters/ColourHitErrorMeter.cs
index 5012be7249..00e6059541 100644
--- a/osu.Game/Screens/Play/HUD/HitErrorMeters/ColourHitErrorMeter.cs
+++ b/osu.Game/Screens/Play/HUD/HitErrorMeters/ColourHitErrorMeter.cs
@@ -53,13 +53,13 @@ namespace osu.Game.Screens.Play.HUD.HitErrorMeters
                 LayoutEasing = Easing.OutQuint;
             }
 
-            public void Push(Color4 colour)
+            public void Push(Color4 colour) => Schedule(() =>
             {
                 Add(new HitErrorCircle(colour, drawable_judgement_size));
 
                 if (Children.Count > max_available_judgements)
                     Children.FirstOrDefault(c => !c.IsRemoved)?.Remove();
-            }
+            });
         }
 
         internal class HitErrorCircle : Container

From c21b2d166223d2305a0f3d7ce8d9fc77c3bc4a66 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 21 Dec 2021 12:39:07 +0900
Subject: [PATCH 1742/5547] Fix incorrect variable

---
 osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
index ad7464244e..bdf7032521 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
@@ -48,7 +48,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
                 var currentObj = (OsuDifficultyHitObject)Previous[i];
                 var currentHitObject = (OsuHitObject)(currentObj.BaseObject);
 
-                lastObj ??= currentObj;
+                lastObj ??= osuCurrent;
 
                 if (!(currentObj.BaseObject is Spinner))
                 {

From f366cdc73eabbaff9224e3c7010e3f641a079158 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 21 Dec 2021 12:39:34 +0900
Subject: [PATCH 1743/5547] Extract initial set out of loop

---
 osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
index bdf7032521..ff0780be85 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
@@ -40,7 +40,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
 
             double result = 0.0;
 
-            OsuDifficultyHitObject lastObj = null;
+            OsuDifficultyHitObject lastObj = osuCurrent;
 
             // This is iterating backwards in time from the current object.
             for (int i = 0; i < Previous.Count; i++)
@@ -48,8 +48,6 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
                 var currentObj = (OsuDifficultyHitObject)Previous[i];
                 var currentHitObject = (OsuHitObject)(currentObj.BaseObject);
 
-                lastObj ??= osuCurrent;
-
                 if (!(currentObj.BaseObject is Spinner))
                 {
                     double jumpDistance = (osuHitObject.StackedPosition - currentHitObject.EndPosition).Length;

From 52db7b36fc44a66d64a5b68d5a266ece48a2cebc Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 21 Dec 2021 12:55:21 +0900
Subject: [PATCH 1744/5547] Move `Schedule` call to base implementation of
 error meter for extra safety

---
 .../Screens/Play/HUD/HitErrorMeters/ColourHitErrorMeter.cs | 4 ++--
 osu.Game/Screens/Play/HUD/HitErrorMeters/HitErrorMeter.cs  | 7 ++++++-
 2 files changed, 8 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Screens/Play/HUD/HitErrorMeters/ColourHitErrorMeter.cs b/osu.Game/Screens/Play/HUD/HitErrorMeters/ColourHitErrorMeter.cs
index 00e6059541..5012be7249 100644
--- a/osu.Game/Screens/Play/HUD/HitErrorMeters/ColourHitErrorMeter.cs
+++ b/osu.Game/Screens/Play/HUD/HitErrorMeters/ColourHitErrorMeter.cs
@@ -53,13 +53,13 @@ namespace osu.Game.Screens.Play.HUD.HitErrorMeters
                 LayoutEasing = Easing.OutQuint;
             }
 
-            public void Push(Color4 colour) => Schedule(() =>
+            public void Push(Color4 colour)
             {
                 Add(new HitErrorCircle(colour, drawable_judgement_size));
 
                 if (Children.Count > max_available_judgements)
                     Children.FirstOrDefault(c => !c.IsRemoved)?.Remove();
-            });
+            }
         }
 
         internal class HitErrorCircle : Container
diff --git a/osu.Game/Screens/Play/HUD/HitErrorMeters/HitErrorMeter.cs b/osu.Game/Screens/Play/HUD/HitErrorMeters/HitErrorMeter.cs
index c7b06a3a2c..16c23f07f5 100644
--- a/osu.Game/Screens/Play/HUD/HitErrorMeters/HitErrorMeter.cs
+++ b/osu.Game/Screens/Play/HUD/HitErrorMeters/HitErrorMeter.cs
@@ -40,9 +40,14 @@ namespace osu.Game.Screens.Play.HUD.HitErrorMeters
             if (gameplayClockContainer != null)
                 gameplayClockContainer.OnSeek += Clear;
 
-            processor.NewJudgement += OnNewJudgement;
+            // Scheduled as meter implementations are likely going to change/add drawables when reacting to this.
+            processor.NewJudgement += j => Schedule(() => OnNewJudgement(j));
         }
 
+        /// <summary>
+        /// Fired when a new judgement arrives.
+        /// </summary>
+        /// <param name="judgement">The new judgement.</param>
         protected abstract void OnNewJudgement(JudgementResult judgement);
 
         protected Color4 GetColourForHitResult(HitResult result)

From edcbd4de6d27cd9788523064207e4111d2d99f80 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 21 Dec 2021 13:05:26 +0900
Subject: [PATCH 1745/5547] Fix incorrect event unbind logic

---
 osu.Game/Screens/Play/HUD/HitErrorMeters/HitErrorMeter.cs | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Screens/Play/HUD/HitErrorMeters/HitErrorMeter.cs b/osu.Game/Screens/Play/HUD/HitErrorMeters/HitErrorMeter.cs
index 16c23f07f5..1f08cb8aa7 100644
--- a/osu.Game/Screens/Play/HUD/HitErrorMeters/HitErrorMeter.cs
+++ b/osu.Game/Screens/Play/HUD/HitErrorMeters/HitErrorMeter.cs
@@ -40,10 +40,12 @@ namespace osu.Game.Screens.Play.HUD.HitErrorMeters
             if (gameplayClockContainer != null)
                 gameplayClockContainer.OnSeek += Clear;
 
-            // Scheduled as meter implementations are likely going to change/add drawables when reacting to this.
-            processor.NewJudgement += j => Schedule(() => OnNewJudgement(j));
+            processor.NewJudgement += processorNewJudgement;
         }
 
+        // Scheduled as meter implementations are likely going to change/add drawables when reacting to this.
+        private void processorNewJudgement(JudgementResult j) => Schedule(() => OnNewJudgement(j));
+
         /// <summary>
         /// Fired when a new judgement arrives.
         /// </summary>
@@ -89,7 +91,7 @@ namespace osu.Game.Screens.Play.HUD.HitErrorMeters
             base.Dispose(isDisposing);
 
             if (processor != null)
-                processor.NewJudgement -= OnNewJudgement;
+                processor.NewJudgement -= processorNewJudgement;
 
             if (gameplayClockContainer != null)
                 gameplayClockContainer.OnSeek -= Clear;

From 9aff646ff49ac0194b194621b9c90e1af9ab2cc9 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 21 Dec 2021 13:20:12 +0900
Subject: [PATCH 1746/5547] Centralise all multiplayer button clicking test
 logic

This adds the "wait for enabled" check in a way that can be easily
reused, as it keeps getting missed in test implementations.

This particular commit hopefully fixes
https://github.com/ppy/osu/runs/4583845033?check_suite_focus=true.
---
 .../Visual/Multiplayer/QueueModeTestScene.cs  | 23 ++-----------
 .../Multiplayer/TestSceneMultiplayer.cs       | 18 ++--------
 .../TestSceneMultiplayerMatchSubScreen.cs     | 33 ++++---------------
 .../TestSceneMultiplayerReadyButton.cs        | 28 +++++-----------
 .../TestSceneMultiplayerSpectateButton.cs     | 17 +++-------
 .../Visual/OsuManualInputManagerTestScene.cs  | 23 +++++++++++++
 6 files changed, 48 insertions(+), 94 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs b/osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs
index 5acb44ac45..88c54eb2bb 100644
--- a/osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs
@@ -5,7 +5,6 @@ using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
-using osu.Framework.Graphics.UserInterface;
 using osu.Framework.Platform;
 using osu.Framework.Screens;
 using osu.Framework.Testing;
@@ -20,7 +19,6 @@ using osu.Game.Screens.OnlinePlay.Multiplayer;
 using osu.Game.Screens.OnlinePlay.Multiplayer.Match;
 using osu.Game.Screens.Play;
 using osu.Game.Tests.Resources;
-using osuTK.Input;
 
 namespace osu.Game.Tests.Visual.Multiplayer
 {
@@ -86,11 +84,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddUntilStep("wait for room open", () => this.ChildrenOfType<MultiplayerMatchSubScreen>().FirstOrDefault()?.IsLoaded == true);
             AddWaitStep("wait for transition", 2);
 
-            AddStep("create room", () =>
-            {
-                InputManager.MoveMouseTo(this.ChildrenOfType<MultiplayerMatchSettingsOverlay.CreateOrUpdateButton>().Single());
-                InputManager.Click(MouseButton.Left);
-            });
+            ClickButtonWhenEnabled<MultiplayerMatchSettingsOverlay.CreateOrUpdateButton>();
 
             AddUntilStep("wait for join", () => Client.RoomJoined);
         }
@@ -104,24 +98,13 @@ namespace osu.Game.Tests.Visual.Multiplayer
         protected void RunGameplay()
         {
             AddUntilStep("wait for idle", () => Client.LocalUser?.State == MultiplayerUserState.Idle);
-            clickReadyButton();
+            ClickButtonWhenEnabled<MultiplayerReadyButton>();
 
             AddUntilStep("wait for ready", () => Client.LocalUser?.State == MultiplayerUserState.Ready);
-            clickReadyButton();
+            ClickButtonWhenEnabled<MultiplayerReadyButton>();
 
             AddUntilStep("wait for player", () => multiplayerComponents.CurrentScreen is Player player && player.IsLoaded);
             AddStep("exit player", () => multiplayerComponents.MultiplayerScreen.MakeCurrent());
         }
-
-        private void clickReadyButton()
-        {
-            AddUntilStep("wait for ready button to be enabled", () => this.ChildrenOfType<MultiplayerReadyButton>().Single().ChildrenOfType<Button>().Single().Enabled.Value);
-
-            AddStep("click ready button", () =>
-            {
-                InputManager.MoveMouseTo(this.ChildrenOfType<MultiplayerReadyButton>().Single());
-                InputManager.Click(MouseButton.Left);
-            });
-        }
     }
 }
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
index bd0e5c4eb9..21e2f937a3 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
@@ -463,11 +463,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             AddStep("delete beatmap", () => beatmaps.Delete(importedSet));
 
-            AddStep("click spectate button", () =>
-            {
-                InputManager.MoveMouseTo(this.ChildrenOfType<MultiplayerSpectateButton>().Single());
-                InputManager.Click(MouseButton.Left);
-            });
+            ClickButtonWhenEnabled<MultiplayerSpectateButton>();
 
             AddUntilStep("wait for spectating user state", () => client.LocalUser?.State == MultiplayerUserState.Spectating);
 
@@ -501,11 +497,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 client.ChangeUserState(MultiplayerTestScene.PLAYER_1_ID, MultiplayerUserState.Ready);
             });
 
-            AddStep("click spectate button", () =>
-            {
-                InputManager.MoveMouseTo(this.ChildrenOfType<MultiplayerSpectateButton>().Single());
-                InputManager.Click(MouseButton.Left);
-            });
+            ClickButtonWhenEnabled<MultiplayerSpectateButton>();
 
             AddUntilStep("wait for spectating user state", () => client.LocalUser?.State == MultiplayerUserState.Spectating);
 
@@ -832,11 +824,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddUntilStep("wait for room open", () => this.ChildrenOfType<MultiplayerMatchSubScreen>().FirstOrDefault()?.IsLoaded == true);
             AddWaitStep("wait for transition", 2);
 
-            AddStep("create room", () =>
-            {
-                InputManager.MoveMouseTo(this.ChildrenOfType<MultiplayerMatchSettingsOverlay.CreateOrUpdateButton>().Single());
-                InputManager.Click(MouseButton.Left);
-            });
+            ClickButtonWhenEnabled<MultiplayerMatchSettingsOverlay.CreateOrUpdateButton>();
 
             AddUntilStep("wait for join", () => client.RoomJoined);
         }
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs
index bd230864df..55430fbb41 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs
@@ -14,12 +14,10 @@ using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Rooms;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Osu;
-using osu.Game.Screens.OnlinePlay.Components;
 using osu.Game.Screens.OnlinePlay.Multiplayer;
 using osu.Game.Screens.OnlinePlay.Multiplayer.Match;
 using osu.Game.Tests.Beatmaps;
 using osu.Game.Tests.Resources;
-using osuTK.Input;
 
 namespace osu.Game.Tests.Visual.Multiplayer
 {
@@ -62,22 +60,17 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [Test]
         public void TestCreatedRoom()
         {
-            AddStep("create room", () =>
+            AddStep("add playlist item", () =>
             {
                 SelectedRoom.Value.Playlist.Add(new PlaylistItem
                 {
                     Beatmap = { Value = new TestBeatmap(new OsuRuleset().RulesetInfo).BeatmapInfo },
                     Ruleset = { Value = new OsuRuleset().RulesetInfo },
                 });
-
-                // Needs to run after components update with the playlist item.
-                Schedule(() =>
-                {
-                    InputManager.MoveMouseTo(this.ChildrenOfType<MultiplayerMatchSettingsOverlay.CreateOrUpdateButton>().Single());
-                    InputManager.Click(MouseButton.Left);
-                });
             });
 
+            ClickButtonWhenEnabled<MultiplayerMatchSettingsOverlay.CreateOrUpdateButton>();
+
             AddUntilStep("wait for join", () => RoomJoined);
         }
 
@@ -110,11 +103,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 });
             });
 
-            AddStep("click create button", () =>
-            {
-                InputManager.MoveMouseTo(this.ChildrenOfType<MultiplayerMatchSettingsOverlay.CreateOrUpdateButton>().Single());
-                InputManager.Click(MouseButton.Left);
-            });
+            ClickButtonWhenEnabled<MultiplayerMatchSettingsOverlay.CreateOrUpdateButton>();
 
             AddUntilStep("wait for room join", () => RoomJoined);
 
@@ -124,21 +113,11 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 Client.ChangeUserState(PLAYER_1_ID, MultiplayerUserState.Ready);
             });
 
-            AddStep("click spectate button", () =>
-            {
-                InputManager.MoveMouseTo(this.ChildrenOfType<MultiplayerSpectateButton>().Single());
-                InputManager.Click(MouseButton.Left);
-            });
+            ClickButtonWhenEnabled<MultiplayerSpectateButton>();
 
             AddUntilStep("wait for spectating user state", () => Client.LocalUser?.State == MultiplayerUserState.Spectating);
 
-            AddUntilStep("wait for ready button to be enabled", () => this.ChildrenOfType<MultiplayerReadyButton>().Single().ChildrenOfType<ReadyButton>().Single().Enabled.Value);
-
-            AddStep("click ready button", () =>
-            {
-                InputManager.MoveMouseTo(this.ChildrenOfType<MultiplayerReadyButton>().Single());
-                InputManager.Click(MouseButton.Left);
-            });
+            ClickButtonWhenEnabled<MultiplayerReadyButton>();
 
             AddUntilStep("match started", () => Client.Room?.State == MultiplayerRoomState.WaitingForLoad);
         }
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs
index 81220e2527..93be28ad90 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs
@@ -9,7 +9,6 @@ using osu.Framework.Allocation;
 using osu.Framework.Audio;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
-using osu.Framework.Graphics.UserInterface;
 using osu.Framework.Platform;
 using osu.Framework.Testing;
 using osu.Framework.Utils;
@@ -22,7 +21,6 @@ using osu.Game.Rulesets;
 using osu.Game.Screens.OnlinePlay.Multiplayer.Match;
 using osu.Game.Tests.Resources;
 using osuTK;
-using osuTK.Input;
 
 namespace osu.Game.Tests.Visual.Multiplayer
 {
@@ -113,10 +111,10 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 Client.TransferHost(2);
             });
 
-            addClickButtonStep();
+            ClickButtonWhenEnabled<MultiplayerReadyButton>();
             AddUntilStep("user is ready", () => Client.Room?.Users[0].State == MultiplayerUserState.Ready);
 
-            addClickButtonStep();
+            ClickButtonWhenEnabled<MultiplayerReadyButton>();
             AddUntilStep("user is idle", () => Client.Room?.Users[0].State == MultiplayerUserState.Idle);
         }
 
@@ -132,7 +130,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     Client.AddUser(new APIUser { Id = 2, Username = "Another user" });
             });
 
-            addClickButtonStep();
+            ClickButtonWhenEnabled<MultiplayerReadyButton>();
             AddUntilStep("user is ready", () => Client.Room?.Users[0].State == MultiplayerUserState.Ready);
 
             verifyGameplayStartFlow();
@@ -147,7 +145,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 Client.TransferHost(2);
             });
 
-            addClickButtonStep();
+            ClickButtonWhenEnabled<MultiplayerReadyButton>();
             AddStep("make user host", () => Client.TransferHost(Client.Room?.Users[0].UserID ?? 0));
 
             verifyGameplayStartFlow();
@@ -162,12 +160,12 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 Client.AddUser(new APIUser { Id = 2, Username = "Another user" });
             });
 
-            addClickButtonStep();
+            ClickButtonWhenEnabled<MultiplayerReadyButton>();
             AddUntilStep("user is ready", () => Client.Room?.Users[0].State == MultiplayerUserState.Ready);
 
             AddStep("transfer host", () => Client.TransferHost(Client.Room?.Users[1].UserID ?? 0));
 
-            addClickButtonStep();
+            ClickButtonWhenEnabled<MultiplayerReadyButton>();
             AddUntilStep("user is idle (match not started)", () => Client.Room?.Users[0].State == MultiplayerUserState.Idle);
             AddAssert("ready button enabled", () => button.ChildrenOfType<OsuButton>().Single().Enabled.Value);
         }
@@ -187,7 +185,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             if (!isHost)
                 AddStep("transfer host", () => Client.TransferHost(2));
 
-            addClickButtonStep();
+            ClickButtonWhenEnabled<MultiplayerReadyButton>();
 
             AddRepeatStep("change user ready state", () =>
             {
@@ -202,20 +200,10 @@ namespace osu.Game.Tests.Visual.Multiplayer
             }, users);
         }
 
-        private void addClickButtonStep()
-        {
-            AddUntilStep("wait for button to be ready", () => button.ChildrenOfType<Button>().Single().Enabled.Value);
-            AddStep("click button", () =>
-            {
-                InputManager.MoveMouseTo(button);
-                InputManager.Click(MouseButton.Left);
-            });
-        }
-
         private void verifyGameplayStartFlow()
         {
             AddUntilStep("user is ready", () => Client.Room?.Users[0].State == MultiplayerUserState.Ready);
-            addClickButtonStep();
+            ClickButtonWhenEnabled<MultiplayerReadyButton>();
             AddUntilStep("user waiting for load", () => Client.Room?.Users[0].State == MultiplayerUserState.WaitingForLoad);
 
             AddAssert("ready button disabled", () => !button.ChildrenOfType<OsuButton>().Single().Enabled.Value);
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerSpectateButton.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerSpectateButton.cs
index 76c8de93c7..eecf0dff9f 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerSpectateButton.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerSpectateButton.cs
@@ -21,7 +21,6 @@ using osu.Game.Rulesets;
 using osu.Game.Screens.OnlinePlay.Multiplayer.Match;
 using osu.Game.Tests.Resources;
 using osuTK;
-using osuTK.Input;
 
 namespace osu.Game.Tests.Visual.Multiplayer
 {
@@ -121,10 +120,10 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [TestCase(MultiplayerUserState.Ready)]
         public void TestToggleWhenIdle(MultiplayerUserState initialState)
         {
-            addClickSpectateButtonStep();
+            ClickButtonWhenEnabled<MultiplayerSpectateButton>();
             AddUntilStep("user is spectating", () => Client.Room?.Users[0].State == MultiplayerUserState.Spectating);
 
-            addClickSpectateButtonStep();
+            ClickButtonWhenEnabled<MultiplayerSpectateButton>();
             AddUntilStep("user is idle", () => Client.Room?.Users[0].State == MultiplayerUserState.Idle);
         }
 
@@ -138,7 +137,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [Test]
         public void TestReadyButtonDisabledWhenHostAndNoReadyUsers()
         {
-            addClickSpectateButtonStep();
+            ClickButtonWhenEnabled<MultiplayerSpectateButton>();
             assertReadyButtonEnablement(false);
         }
 
@@ -148,7 +147,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddStep("add user", () => Client.AddUser(new APIUser { Id = PLAYER_1_ID }));
             AddStep("set user ready", () => Client.ChangeUserState(PLAYER_1_ID, MultiplayerUserState.Ready));
 
-            addClickSpectateButtonStep();
+            ClickButtonWhenEnabled<MultiplayerSpectateButton>();
             assertReadyButtonEnablement(true);
         }
 
@@ -163,16 +162,10 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             AddStep("set user ready", () => Client.ChangeUserState(PLAYER_1_ID, MultiplayerUserState.Ready));
 
-            addClickSpectateButtonStep();
+            ClickButtonWhenEnabled<MultiplayerSpectateButton>();
             assertReadyButtonEnablement(false);
         }
 
-        private void addClickSpectateButtonStep() => AddStep("click spectate button", () =>
-        {
-            InputManager.MoveMouseTo(spectateButton);
-            InputManager.Click(MouseButton.Left);
-        });
-
         private void assertSpectateButtonEnablement(bool shouldBeEnabled)
             => AddUntilStep($"spectate button {(shouldBeEnabled ? "is" : "is not")} enabled", () => spectateButton.ChildrenOfType<OsuButton>().Single().Enabled.Value == shouldBeEnabled);
 
diff --git a/osu.Game/Tests/Visual/OsuManualInputManagerTestScene.cs b/osu.Game/Tests/Visual/OsuManualInputManagerTestScene.cs
index 752794d25a..b7aa8af4aa 100644
--- a/osu.Game/Tests/Visual/OsuManualInputManagerTestScene.cs
+++ b/osu.Game/Tests/Visual/OsuManualInputManagerTestScene.cs
@@ -1,9 +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.Linq;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
+using osu.Framework.Graphics.UserInterface;
+using osu.Framework.Testing;
 using osu.Framework.Testing.Input;
 using osu.Game.Graphics.Cursor;
 using osu.Game.Graphics.Sprites;
@@ -11,6 +14,7 @@ using osu.Game.Graphics.UserInterface;
 using osu.Game.Input.Bindings;
 using osuTK;
 using osuTK.Graphics;
+using osuTK.Input;
 
 namespace osu.Game.Tests.Visual
 {
@@ -115,6 +119,25 @@ namespace osu.Game.Tests.Visual
             });
         }
 
+        /// <summary>
+        /// Wait for a button to become enabled, then click it.
+        /// </summary>
+        /// <typeparam name="T"></typeparam>
+        protected void ClickButtonWhenEnabled<T>()
+            where T : Drawable
+        {
+            if (typeof(T) == typeof(Button))
+                AddUntilStep($"wait for {typeof(T).Name} enabled", () => (this.ChildrenOfType<T>().Single() as Button)?.Enabled.Value == true);
+            else
+                AddUntilStep($"wait for {typeof(T).Name} enabled", () => this.ChildrenOfType<T>().Single().ChildrenOfType<Button>().Single().Enabled.Value);
+
+            AddStep($"click {typeof(T).Name}", () =>
+            {
+                InputManager.MoveMouseTo(this.ChildrenOfType<T>().Single());
+                InputManager.Click(MouseButton.Left);
+            });
+        }
+
         protected override void Update()
         {
             base.Update();

From aad55ef89e355a641b7f84a870e68c27036397f0 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 21 Dec 2021 13:21:22 +0900
Subject: [PATCH 1747/5547] Remove unused method in
 `TestSceneMultiplayerQueueList`

---
 .../TestSceneMultiplayerQueueList.cs            | 17 -----------------
 1 file changed, 17 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs
index 61a92c32a4..ef71dfe772 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs
@@ -13,7 +13,6 @@ using osu.Framework.Platform;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
 using osu.Game.Database;
-using osu.Game.Graphics.Containers;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Rooms;
@@ -22,7 +21,6 @@ using osu.Game.Screens.OnlinePlay;
 using osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist;
 using osu.Game.Tests.Resources;
 using osuTK;
-using osuTK.Input;
 
 namespace osu.Game.Tests.Visual.Multiplayer
 {
@@ -142,21 +140,6 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddUntilStep("item arrived in playlist", () => playlist.ChildrenOfType<RearrangeableListItem<PlaylistItem>>().Any(i => i.Model.ID == itemId));
         }
 
-        private void deleteItem(int index)
-        {
-            OsuRearrangeableListItem<PlaylistItem> item = null;
-
-            AddStep($"move mouse to delete button {index}", () =>
-            {
-                item = playlist.ChildrenOfType<OsuRearrangeableListItem<PlaylistItem>>().ElementAt(index);
-                InputManager.MoveMouseTo(item.ChildrenOfType<DrawableRoomPlaylistItem.PlaylistRemoveButton>().ElementAt(0));
-            });
-
-            AddStep("click", () => InputManager.Click(MouseButton.Left));
-
-            AddUntilStep("item removed from playlist", () => !playlist.ChildrenOfType<RearrangeableListItem<PlaylistItem>>().Contains(item));
-        }
-
         private void assertDeleteButtonVisibility(int index, bool visible)
             => AddUntilStep($"delete button {index} {(visible ? "is" : "is not")} visible",
                 () => (playlist.ChildrenOfType<DrawableRoomPlaylistItem.PlaylistRemoveButton>().ElementAt(index).Alpha > 0) == visible);

From bb3f37595872c870909e96bbf1bba3cf60cc4102 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 21 Dec 2021 13:47:37 +0900
Subject: [PATCH 1748/5547] Add note about local button clicking usage

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

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
index 21e2f937a3..4eebda94e9 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
@@ -799,6 +799,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
         private void pressReadyButton(int? playingUserId = null)
         {
+            // Can't use ClickButtonWhenEnabled<> due to needing to store the state after the button is enabled.
+
             AddUntilStep("wait for ready button to be enabled", () => readyButton.Enabled.Value);
 
             MultiplayerUserState lastState = MultiplayerUserState.Idle;

From 0f8a6a3f64d3ebae4351b44b3c75a76277eea74e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 21 Dec 2021 14:10:38 +0900
Subject: [PATCH 1749/5547] Fix intermittent failures on
 `TestSceneBeatmapListingOverlay`

In the specific method, there was no wait step after the initial fetch
(unlike all of the rest), meaning the fetch may not have finished in
time for the follow-up steps.

As seen at
https://github.com/ppy/osu/runs/4588058438?check_suite_focus=true.
---
 .../Visual/Online/TestSceneBeatmapListingOverlay.cs  | 12 +++++++++---
 1 file changed, 9 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneBeatmapListingOverlay.cs b/osu.Game.Tests/Visual/Online/TestSceneBeatmapListingOverlay.cs
index cbb6dce4d6..80f7d0ca29 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneBeatmapListingOverlay.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneBeatmapListingOverlay.cs
@@ -127,6 +127,7 @@ namespace osu.Game.Tests.Visual.Online
         public void TestUserWithoutSupporterUsesSupporterOnlyFiltersWithoutResults()
         {
             AddStep("fetch for 0 beatmaps", () => fetchFor());
+
             AddStep("set dummy as non-supporter", () => ((DummyAPIAccess)API).LocalUser.Value.IsSupporter = false);
 
             // only Rank Achieved filter
@@ -187,6 +188,9 @@ namespace osu.Game.Tests.Visual.Online
         public void TestUserWithoutSupporterUsesSupporterOnlyFiltersWithResults()
         {
             AddStep("fetch for 1 beatmap", () => fetchFor(CreateAPIBeatmapSet(Ruleset.Value)));
+
+            noPlaceholderShown();
+
             AddStep("set dummy as non-supporter", () => ((DummyAPIAccess)API).LocalUser.Value.IsSupporter = false);
 
             // only Rank Achieved filter
@@ -217,6 +221,9 @@ namespace osu.Game.Tests.Visual.Online
         public void TestUserWithSupporterUsesSupporterOnlyFiltersWithResults()
         {
             AddStep("fetch for 1 beatmap", () => fetchFor(CreateAPIBeatmapSet(Ruleset.Value)));
+
+            noPlaceholderShown();
+
             AddStep("set dummy as supporter", () => ((DummyAPIAccess)API).LocalUser.Value.IsSupporter = true);
 
             // only Rank Achieved filter
@@ -280,9 +287,8 @@ namespace osu.Game.Tests.Visual.Online
 
         private void noPlaceholderShown()
         {
-            AddUntilStep("no placeholder shown", () =>
-                !overlay.ChildrenOfType<BeatmapListingOverlay.SupporterRequiredDrawable>().Any(d => d.IsPresent)
-                && !overlay.ChildrenOfType<BeatmapListingOverlay.NotFoundDrawable>().Any(d => d.IsPresent));
+            AddUntilStep("\"supporter required\" placeholder not shown", () => !overlay.ChildrenOfType<BeatmapListingOverlay.SupporterRequiredDrawable>().Any(d => d.IsPresent));
+            AddUntilStep("\"no maps found\" placeholder not shown", () => !overlay.ChildrenOfType<BeatmapListingOverlay.NotFoundDrawable>().Any(d => d.IsPresent));
         }
     }
 }

From ddadf3c4b5ecc2306cf99b9882ef5ba92dcb88b9 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 21 Dec 2021 14:37:23 +0900
Subject: [PATCH 1750/5547] Add logging of `MultiplayerMatchSubScreen` exiting
 from room loss

---
 .../OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs        | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
index 6895608c8e..ad332dd33a 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
@@ -11,6 +11,7 @@ using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
+using osu.Framework.Logging;
 using osu.Framework.Screens;
 using osu.Framework.Threading;
 using osu.Game.Beatmaps;
@@ -434,6 +435,8 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
 
         private void handleRoomLost() => Schedule(() =>
         {
+            Logger.Log($"{nameof(MultiplayerMatchSubScreen)} exiting due to loss of room or connection");
+
             if (this.IsCurrentScreen())
                 this.Exit();
             else

From d08b66a5ffa261731a001b540a903e37fc07c1b6 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 21 Dec 2021 15:07:06 +0900
Subject: [PATCH 1751/5547] Also add logging to `OnlinePlayScreen`

---
 .../Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs | 2 +-
 osu.Game/Screens/OnlinePlay/OnlinePlayScreen.cs                 | 2 ++
 2 files changed, 3 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
index ad332dd33a..af83543b16 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
@@ -435,7 +435,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
 
         private void handleRoomLost() => Schedule(() =>
         {
-            Logger.Log($"{nameof(MultiplayerMatchSubScreen)} exiting due to loss of room or connection");
+            Logger.Log($"{this} exiting due to loss of room or connection");
 
             if (this.IsCurrentScreen())
                 this.Exit();
diff --git a/osu.Game/Screens/OnlinePlay/OnlinePlayScreen.cs b/osu.Game/Screens/OnlinePlay/OnlinePlayScreen.cs
index 19153521cd..bf1699dca0 100644
--- a/osu.Game/Screens/OnlinePlay/OnlinePlayScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/OnlinePlayScreen.cs
@@ -95,6 +95,8 @@ namespace osu.Game.Screens.OnlinePlay
 
         private void forcefullyExit()
         {
+            Logger.Log($"{this} forcefully exiting due to loss of API connection");
+
             // This is temporary since we don't currently have a way to force screens to be exited
             if (this.IsCurrentScreen())
             {

From c0a8758839b1dd81cd4ae92f18c1034a3f94e548 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 21 Dec 2021 15:14:49 +0900
Subject: [PATCH 1752/5547] Fix intermittent test failures on
 `TestSceneResultsScreen` due to long delay step

Using real time delays of 3 seconds doesn't play well with headless runs.
---
 .../Visual/Ranking/TestSceneResultsScreen.cs  | 20 +++++++++++++------
 1 file changed, 14 insertions(+), 6 deletions(-)

diff --git a/osu.Game.Tests/Visual/Ranking/TestSceneResultsScreen.cs b/osu.Game.Tests/Visual/Ranking/TestSceneResultsScreen.cs
index d0bd5a6e66..666cbf02b5 100644
--- a/osu.Game.Tests/Visual/Ranking/TestSceneResultsScreen.cs
+++ b/osu.Game.Tests/Visual/Ranking/TestSceneResultsScreen.cs
@@ -203,8 +203,12 @@ namespace osu.Game.Tests.Visual.Ranking
         {
             DelayedFetchResultsScreen screen = null;
 
-            AddStep("load results", () => Child = new TestResultsContainer(screen = new DelayedFetchResultsScreen(TestResources.CreateTestScoreInfo(), 3000)));
+            var tcs = new TaskCompletionSource();
+
+            AddStep("load results", () => Child = new TestResultsContainer(screen = new DelayedFetchResultsScreen(TestResources.CreateTestScoreInfo(), tcs.Task)));
+
             AddUntilStep("wait for loaded", () => screen.IsLoaded);
+
             AddStep("click expanded panel", () =>
             {
                 var expandedPanel = this.ChildrenOfType<ScorePanel>().Single(p => p.State == PanelState.Expanded);
@@ -212,6 +216,10 @@ namespace osu.Game.Tests.Visual.Ranking
                 InputManager.Click(MouseButton.Left);
             });
 
+            AddAssert("no fetch yet", () => !screen.FetchCompleted);
+
+            AddStep("allow fetch", () => tcs.SetResult());
+
             AddUntilStep("wait for fetch", () => screen.FetchCompleted);
             AddAssert("expanded panel still on screen", () => this.ChildrenOfType<ScorePanel>().Single(p => p.State == PanelState.Expanded).ScreenSpaceDrawQuad.TopLeft.X > 0);
         }
@@ -295,21 +303,21 @@ namespace osu.Game.Tests.Visual.Ranking
 
         private class DelayedFetchResultsScreen : TestResultsScreen
         {
+            private readonly Task fetchWaitTask;
+
             public bool FetchCompleted { get; private set; }
 
-            private readonly double delay;
-
-            public DelayedFetchResultsScreen(ScoreInfo score, double delay)
+            public DelayedFetchResultsScreen(ScoreInfo score, Task fetchWaitTask = null)
                 : base(score)
             {
-                this.delay = delay;
+                this.fetchWaitTask = fetchWaitTask ?? Task.CompletedTask;
             }
 
             protected override APIRequest FetchScores(Action<IEnumerable<ScoreInfo>> scoresCallback)
             {
                 Task.Run(async () =>
                 {
-                    await Task.Delay(TimeSpan.FromMilliseconds(delay));
+                    await fetchWaitTask;
 
                     var scores = new List<ScoreInfo>();
 

From 981158ed88f5bc508a90329ad5fb1bf481ef27a3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 21 Dec 2021 15:34:32 +0900
Subject: [PATCH 1753/5547] Rename method and simplify `SetDefault` calling
 code

---
 .../NonVisual/SessionStaticsTest.cs           |  2 +-
 osu.Game/Configuration/SessionStatics.cs      | 26 ++++++++++---------
 osu.Game/OsuGame.cs                           |  2 +-
 3 files changed, 16 insertions(+), 14 deletions(-)

diff --git a/osu.Game.Tests/NonVisual/SessionStaticsTest.cs b/osu.Game.Tests/NonVisual/SessionStaticsTest.cs
index d5fd803986..fbb0eed4fc 100644
--- a/osu.Game.Tests/NonVisual/SessionStaticsTest.cs
+++ b/osu.Game.Tests/NonVisual/SessionStaticsTest.cs
@@ -27,7 +27,7 @@ namespace osu.Game.Tests.NonVisual
             sessionIdleTracker.IsIdle.BindValueChanged(e =>
             {
                 if (e.NewValue)
-                    sessionStatics.ResetValues();
+                    sessionStatics.ResetAfterInactivity();
             });
         }
 
diff --git a/osu.Game/Configuration/SessionStatics.cs b/osu.Game/Configuration/SessionStatics.cs
index 99f1e5a8b2..fca0ad9641 100644
--- a/osu.Game/Configuration/SessionStatics.cs
+++ b/osu.Game/Configuration/SessionStatics.cs
@@ -15,23 +15,25 @@ namespace osu.Game.Configuration
     {
         protected override void InitialiseDefaults()
         {
-            ensureDefault(SetDefault(Static.LoginOverlayDisplayed, false));
-            ensureDefault(SetDefault(Static.MutedAudioNotificationShownOnce, false));
-            ensureDefault(SetDefault(Static.LowBatteryNotificationShownOnce, false));
-            ensureDefault(SetDefault(Static.LastHoverSoundPlaybackTime, (double?)null));
-            ensureDefault(SetDefault<APISeasonalBackgrounds>(Static.SeasonalBackgrounds, null));
+            SetDefault(Static.LoginOverlayDisplayed, false);
+            SetDefault(Static.MutedAudioNotificationShownOnce, false);
+            SetDefault(Static.LowBatteryNotificationShownOnce, false);
+            SetDefault(Static.LastHoverSoundPlaybackTime, (double?)null);
+            SetDefault<APISeasonalBackgrounds>(Static.SeasonalBackgrounds, null);
         }
 
         /// <summary>
-        /// Used to revert statics to their defaults after being idle for appropiate amount of time.
-        /// Does not affect loaded seasonal backgrounds.
+        /// Revert statics to their defaults after being idle for appropriate amount of time.
         /// </summary>
-        public void ResetValues()
+        /// <remarks>
+        /// This only affects a subset of statics which the user would expect to have reset after a break.
+        /// </remarks>
+        public void ResetAfterInactivity()
         {
-            ensureDefault(GetBindable<bool>(Static.LoginOverlayDisplayed));
-            ensureDefault(GetBindable<bool>(Static.MutedAudioNotificationShownOnce));
-            ensureDefault(GetBindable<bool>(Static.LowBatteryNotificationShownOnce));
-            ensureDefault(GetBindable<double?>(Static.LastHoverSoundPlaybackTime));
+            GetBindable<bool>(Static.LoginOverlayDisplayed).SetDefault();
+            GetBindable<bool>(Static.MutedAudioNotificationShownOnce).SetDefault();
+            GetBindable<bool>(Static.LowBatteryNotificationShownOnce).SetDefault();
+            GetBindable<double?>(Static.LastHoverSoundPlaybackTime).SetDefault();
         }
 
         private void ensureDefault<T>(Bindable<T> bindable) => bindable.SetDefault();
diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index a4471b56b9..c5a465ae96 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -680,7 +680,7 @@ namespace osu.Game
             sessionIdleTracker.IsIdle.BindValueChanged(idle =>
             {
                 if (idle.NewValue)
-                    SessionStatics.ResetValues();
+                    SessionStatics.ResetAfterInactivity();
             });
 
             Add(sessionIdleTracker);

From 16fe0e4f893a4c1d424af0a50f8f9ae3df250644 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 21 Dec 2021 15:39:04 +0900
Subject: [PATCH 1754/5547] Fix `SessionStaticsTest` never working

In headless operation, the test would complete before ever reaching an
idle state. And this test only ran headless..
---
 .../NonVisual/SessionStaticsTest.cs           | 34 +++++++------------
 1 file changed, 12 insertions(+), 22 deletions(-)

diff --git a/osu.Game.Tests/NonVisual/SessionStaticsTest.cs b/osu.Game.Tests/NonVisual/SessionStaticsTest.cs
index fbb0eed4fc..013cdc30b4 100644
--- a/osu.Game.Tests/NonVisual/SessionStaticsTest.cs
+++ b/osu.Game.Tests/NonVisual/SessionStaticsTest.cs
@@ -3,7 +3,6 @@
 
 using NUnit.Framework;
 using osu.Game.Configuration;
-using osu.Game.Input;
 
 namespace osu.Game.Tests.NonVisual
 {
@@ -11,37 +10,28 @@ namespace osu.Game.Tests.NonVisual
     public class SessionStaticsTest
     {
         private SessionStatics sessionStatics;
-        private IdleTracker sessionIdleTracker;
 
-        [SetUp]
-        public void SetUp()
+        [Test]
+        public void TestSessionStaticsReset()
         {
             sessionStatics = new SessionStatics();
-            sessionIdleTracker = new GameIdleTracker(1000);
 
             sessionStatics.SetValue(Static.LoginOverlayDisplayed, true);
             sessionStatics.SetValue(Static.MutedAudioNotificationShownOnce, true);
             sessionStatics.SetValue(Static.LowBatteryNotificationShownOnce, true);
             sessionStatics.SetValue(Static.LastHoverSoundPlaybackTime, (double?)1d);
 
-            sessionIdleTracker.IsIdle.BindValueChanged(e =>
-            {
-                if (e.NewValue)
-                    sessionStatics.ResetAfterInactivity();
-            });
-        }
+            Assert.IsFalse(sessionStatics.GetBindable<bool>(Static.LoginOverlayDisplayed).IsDefault);
+            Assert.IsFalse(sessionStatics.GetBindable<bool>(Static.MutedAudioNotificationShownOnce).IsDefault);
+            Assert.IsFalse(sessionStatics.GetBindable<bool>(Static.LowBatteryNotificationShownOnce).IsDefault);
+            Assert.IsFalse(sessionStatics.GetBindable<double?>(Static.LastHoverSoundPlaybackTime).IsDefault);
 
-        [Test]
-        [Timeout(2000)]
-        public void TestSessionStaticsReset()
-        {
-            sessionIdleTracker.IsIdle.BindValueChanged(e =>
-            {
-                Assert.IsTrue(sessionStatics.GetBindable<bool>(Static.LoginOverlayDisplayed).IsDefault);
-                Assert.IsTrue(sessionStatics.GetBindable<bool>(Static.MutedAudioNotificationShownOnce).IsDefault);
-                Assert.IsTrue(sessionStatics.GetBindable<bool>(Static.LowBatteryNotificationShownOnce).IsDefault);
-                Assert.IsTrue(sessionStatics.GetBindable<double?>(Static.LastHoverSoundPlaybackTime).IsDefault);
-            });
+            sessionStatics.ResetAfterInactivity();
+
+            Assert.IsTrue(sessionStatics.GetBindable<bool>(Static.LoginOverlayDisplayed).IsDefault);
+            Assert.IsTrue(sessionStatics.GetBindable<bool>(Static.MutedAudioNotificationShownOnce).IsDefault);
+            Assert.IsTrue(sessionStatics.GetBindable<bool>(Static.LowBatteryNotificationShownOnce).IsDefault);
+            Assert.IsTrue(sessionStatics.GetBindable<double?>(Static.LastHoverSoundPlaybackTime).IsDefault);
         }
     }
 }

From bd1fb33ad6386414d1b3afb5fa423c9bb5a60d46 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 21 Dec 2021 08:01:04 +0100
Subject: [PATCH 1755/5547] Add and use separate extensions for historical and
 upcoming playlist items

---
 .../OnlinePlay/PlaylistExtensionsTest.cs      | 57 ++++++++++++-------
 osu.Game/Online/Rooms/PlaylistExtensions.cs   | 16 +++++-
 2 files changed, 50 insertions(+), 23 deletions(-)

diff --git a/osu.Game.Tests/OnlinePlay/PlaylistExtensionsTest.cs b/osu.Game.Tests/OnlinePlay/PlaylistExtensionsTest.cs
index 5913cb0f29..d33081662d 100644
--- a/osu.Game.Tests/OnlinePlay/PlaylistExtensionsTest.cs
+++ b/osu.Game.Tests/OnlinePlay/PlaylistExtensionsTest.cs
@@ -16,9 +16,12 @@ namespace osu.Game.Tests.OnlinePlay
             // mostly an extreme edge case, i.e. during room creation.
             var items = Array.Empty<PlaylistItem>();
 
-            var currentItem = items.GetCurrentItem();
-
-            Assert.That(currentItem, Is.Null);
+            Assert.Multiple(() =>
+            {
+                Assert.That(items.GetHistoricalItems(), Is.Empty);
+                Assert.That(items.GetCurrentItem(), Is.Null);
+                Assert.That(items.GetUpcomingItems(), Is.Empty);
+            });
         }
 
         [Test]
@@ -31,9 +34,12 @@ namespace osu.Game.Tests.OnlinePlay
                 new PlaylistItem { ID = 3, BeatmapID = 1003, PlaylistOrder = 3 },
             };
 
-            var currentItem = items.GetCurrentItem();
-
-            Assert.That(currentItem, Is.EqualTo(items[0]));
+            Assert.Multiple(() =>
+            {
+                Assert.That(items.GetHistoricalItems(), Is.Empty);
+                Assert.That(items.GetCurrentItem(), Is.EqualTo(items[0]));
+                Assert.That(items.GetUpcomingItems(), Is.EquivalentTo(items));
+            });
         }
 
         [Test]
@@ -46,9 +52,12 @@ namespace osu.Game.Tests.OnlinePlay
                 new PlaylistItem { ID = 3, BeatmapID = 1003, PlaylistOrder = 3 },
             };
 
-            var currentItem = items.GetCurrentItem();
-
-            Assert.That(currentItem, Is.EqualTo(items[1]));
+            Assert.Multiple(() =>
+            {
+                Assert.That(items.GetHistoricalItems(), Is.Empty);
+                Assert.That(items.GetCurrentItem(), Is.EqualTo(items[1]));
+                Assert.That(items.GetUpcomingItems(), Is.EquivalentTo(new[] { items[1], items[0], items[2] }));
+            });
         }
 
         [Test]
@@ -56,14 +65,17 @@ namespace osu.Game.Tests.OnlinePlay
         {
             var items = new[]
             {
-                new PlaylistItem { ID = 2, BeatmapID = 1002, PlaylistOrder = 2, Expired = true },
-                new PlaylistItem { ID = 1, BeatmapID = 1001, PlaylistOrder = 1, Expired = true },
+                new PlaylistItem { ID = 1, BeatmapID = 1001, Expired = true, PlayedAt = new DateTimeOffset(2021, 12, 21, 7, 55, 0, TimeSpan.Zero) },
+                new PlaylistItem { ID = 2, BeatmapID = 1002, Expired = true, PlayedAt = new DateTimeOffset(2021, 12, 21, 7, 53, 0, TimeSpan.Zero) },
                 new PlaylistItem { ID = 3, BeatmapID = 1003, PlaylistOrder = 3 },
             };
 
-            var currentItem = items.GetCurrentItem();
-
-            Assert.That(currentItem, Is.EqualTo(items[2]));
+            Assert.Multiple(() =>
+            {
+                Assert.That(items.GetHistoricalItems(), Is.EquivalentTo(new[] { items[1], items[0] }));
+                Assert.That(items.GetCurrentItem(), Is.EqualTo(items[2]));
+                Assert.That(items.GetUpcomingItems(), Is.EquivalentTo(new[] { items[2] }));
+            });
         }
 
         [Test]
@@ -71,15 +83,18 @@ namespace osu.Game.Tests.OnlinePlay
         {
             var items = new[]
             {
-                new PlaylistItem { ID = 2, BeatmapID = 1002, PlaylistOrder = 2, Expired = true },
-                new PlaylistItem { ID = 1, BeatmapID = 1001, PlaylistOrder = 1, Expired = true },
-                new PlaylistItem { ID = 3, BeatmapID = 1003, PlaylistOrder = 3, Expired = true },
+                new PlaylistItem { ID = 1, BeatmapID = 1001, Expired = true, PlayedAt = new DateTimeOffset(2021, 12, 21, 7, 55, 0, TimeSpan.Zero) },
+                new PlaylistItem { ID = 2, BeatmapID = 1002, Expired = true, PlayedAt = new DateTimeOffset(2021, 12, 21, 7, 53, 0, TimeSpan.Zero) },
+                new PlaylistItem { ID = 3, BeatmapID = 1002, Expired = true, PlayedAt = new DateTimeOffset(2021, 12, 21, 7, 57, 0, TimeSpan.Zero) },
             };
 
-            var currentItem = items.GetCurrentItem();
-
-            // if all items are expired, the last-played item is expected to be returned.
-            Assert.That(currentItem, Is.EqualTo(items[2]));
+            Assert.Multiple(() =>
+            {
+                Assert.That(items.GetHistoricalItems(), Is.EquivalentTo(new[] { items[1], items[0], items[2] }));
+                // if all items are expired, the last-played item is expected to be returned.
+                Assert.That(items.GetCurrentItem(), Is.EqualTo(items[2]));
+                Assert.That(items.GetUpcomingItems(), Is.Empty);
+            });
         }
     }
 }
diff --git a/osu.Game/Online/Rooms/PlaylistExtensions.cs b/osu.Game/Online/Rooms/PlaylistExtensions.cs
index 355ae6188d..e78f91f20b 100644
--- a/osu.Game/Online/Rooms/PlaylistExtensions.cs
+++ b/osu.Game/Online/Rooms/PlaylistExtensions.cs
@@ -13,6 +13,18 @@ namespace osu.Game.Online.Rooms
 {
     public static class PlaylistExtensions
     {
+        /// <summary>
+        /// Returns all historical/expired items from the <paramref name="playlist"/>, in the order in which they were played.
+        /// </summary>
+        public static IEnumerable<PlaylistItem> GetHistoricalItems(this IEnumerable<PlaylistItem> playlist)
+            => playlist.Where(item => item.Expired).OrderBy(item => item.PlayedAt);
+
+        /// <summary>
+        /// Returns all non-expired items from the <paramref name="playlist"/>, in the order in which they are to be played.
+        /// </summary>
+        public static IEnumerable<PlaylistItem> GetUpcomingItems(this IEnumerable<PlaylistItem> playlist)
+            => playlist.Where(item => !item.Expired).OrderBy(item => item.PlaylistOrder);
+
         /// <summary>
         /// Returns the first non-expired <see cref="PlaylistItem"/> in playlist order from the supplied <paramref name="playlist"/>,
         /// or the last-played <see cref="PlaylistItem"/> if all items are expired,
@@ -24,8 +36,8 @@ namespace osu.Game.Online.Rooms
                 return null;
 
             return playlist.All(item => item.Expired)
-                ? playlist.OrderByDescending(item => item.PlaylistOrder).First()
-                : playlist.OrderBy(item => item.PlaylistOrder).First(item => !item.Expired);
+                ? GetHistoricalItems(playlist).Last()
+                : GetUpcomingItems(playlist).First();
         }
 
         public static string GetTotalDuration(this BindableList<PlaylistItem> playlist) =>

From 88d4e95ad8cadfafba6f38596f5f4d7f493ae2de Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 21 Dec 2021 08:25:52 +0100
Subject: [PATCH 1756/5547] Rename `BeatmapCard{ => Normal}`

---
 osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs    | 8 ++++----
 .../Cards/{BeatmapCard.cs => BeatmapCardNormal.cs}        | 4 ++--
 osu.Game/Overlays/BeatmapListingOverlay.cs                | 8 ++++----
 .../Sections/Beatmaps/PaginatedBeatmapContainer.cs        | 2 +-
 osu.Game/Overlays/Rankings/SpotlightsLayout.cs            | 4 ++--
 osu.Game/Screens/Play/SoloSpectator.cs                    | 2 +-
 6 files changed, 14 insertions(+), 14 deletions(-)
 rename osu.Game/Beatmaps/Drawables/Cards/{BeatmapCard.cs => BeatmapCardNormal.cs} (98%)

diff --git a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs
index 2b98c61e9b..7b5e1f4ec7 100644
--- a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs
+++ b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs
@@ -252,7 +252,7 @@ namespace osu.Game.Tests.Visual.Beatmaps
         [Test]
         public void TestNormal()
         {
-            createTestCase(beatmapSetInfo => new BeatmapCard(beatmapSetInfo));
+            createTestCase(beatmapSetInfo => new BeatmapCardNormal(beatmapSetInfo));
         }
 
         [Test]
@@ -264,7 +264,7 @@ namespace osu.Game.Tests.Visual.Beatmaps
         [Test]
         public void TestHoverState()
         {
-            AddStep("create cards", () => Child = createContent(OverlayColourScheme.Blue, s => new BeatmapCard(s)));
+            AddStep("create cards", () => Child = createContent(OverlayColourScheme.Blue, s => new BeatmapCardNormal(s)));
 
             AddStep("Hover card", () => InputManager.MoveMouseTo(firstCard()));
             AddWaitStep("wait for potential state change", 5);
@@ -281,10 +281,10 @@ namespace osu.Game.Tests.Visual.Beatmaps
             AddWaitStep("wait for potential state change", 5);
             AddAssert("card is still expanded", () => firstCard().Expanded.Value);
 
-            AddStep("Hover away", () => InputManager.MoveMouseTo(this.ChildrenOfType<BeatmapCard>().Last()));
+            AddStep("Hover away", () => InputManager.MoveMouseTo(this.ChildrenOfType<BeatmapCardNormal>().Last()));
             AddUntilStep("card is not expanded", () => !firstCard().Expanded.Value);
 
-            BeatmapCard firstCard() => this.ChildrenOfType<BeatmapCard>().First();
+            BeatmapCardNormal firstCard() => this.ChildrenOfType<BeatmapCardNormal>().First();
         }
     }
 }
diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardNormal.cs
similarity index 98%
rename from osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
rename to osu.Game/Beatmaps/Drawables/Cards/BeatmapCardNormal.cs
index a3b4c4c86c..c70d903d50 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardNormal.cs
@@ -21,7 +21,7 @@ using osu.Game.Resources.Localisation.Web;
 
 namespace osu.Game.Beatmaps.Drawables.Cards
 {
-    public class BeatmapCard : BeatmapCardBase
+    public class BeatmapCardNormal : BeatmapCardBase
     {
         protected override Drawable IdleContent => idleBottomContent;
         protected override Drawable DownloadInProgressContent => downloadProgressBar;
@@ -43,7 +43,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
         [Resolved]
         private OverlayColourProvider colourProvider { get; set; } = null!;
 
-        public BeatmapCard(APIBeatmapSet beatmapSet, bool allowExpansion = true)
+        public BeatmapCardNormal(APIBeatmapSet beatmapSet, bool allowExpansion = true)
             : base(beatmapSet, allowExpansion)
         {
             content = new BeatmapCardContent(height);
diff --git a/osu.Game/Overlays/BeatmapListingOverlay.cs b/osu.Game/Overlays/BeatmapListingOverlay.cs
index 6b27dbf847..c4d1d62250 100644
--- a/osu.Game/Overlays/BeatmapListingOverlay.cs
+++ b/osu.Game/Overlays/BeatmapListingOverlay.cs
@@ -33,7 +33,7 @@ namespace osu.Game.Overlays
 
         private Drawable currentContent;
         private Container panelTarget;
-        private FillFlowContainer<BeatmapCard> foundContent;
+        private FillFlowContainer<BeatmapCardNormal> foundContent;
         private NotFoundDrawable notFoundContent;
         private SupporterRequiredDrawable supporterRequiredContent;
         private BeatmapListingFilterControl filterControl;
@@ -78,7 +78,7 @@ namespace osu.Game.Overlays
                                 Padding = new MarginPadding { Horizontal = 20 },
                                 Children = new Drawable[]
                                 {
-                                    foundContent = new FillFlowContainer<BeatmapCard>(),
+                                    foundContent = new FillFlowContainer<BeatmapCardNormal>(),
                                     notFoundContent = new NotFoundDrawable(),
                                     supporterRequiredContent = new SupporterRequiredDrawable(),
                                 }
@@ -135,7 +135,7 @@ namespace osu.Game.Overlays
                 return;
             }
 
-            var newPanels = searchResult.Results.Select(b => new BeatmapCard(b)
+            var newPanels = searchResult.Results.Select(b => new BeatmapCardNormal(b)
             {
                 Anchor = Anchor.TopCentre,
                 Origin = Anchor.TopCentre,
@@ -152,7 +152,7 @@ namespace osu.Game.Overlays
 
                 // spawn new children with the contained so we only clear old content at the last moment.
                 // reverse ID flow is required for correct Z-ordering of the cards' expandable content (last card should be front-most).
-                var content = new ReverseChildIDFillFlowContainer<BeatmapCard>
+                var content = new ReverseChildIDFillFlowContainer<BeatmapCardNormal>
                 {
                     RelativeSizeAxes = Axes.X,
                     AutoSizeAxes = Axes.Y,
diff --git a/osu.Game/Overlays/Profile/Sections/Beatmaps/PaginatedBeatmapContainer.cs b/osu.Game/Overlays/Profile/Sections/Beatmaps/PaginatedBeatmapContainer.cs
index e46e503dfa..d39074bd49 100644
--- a/osu.Game/Overlays/Profile/Sections/Beatmaps/PaginatedBeatmapContainer.cs
+++ b/osu.Game/Overlays/Profile/Sections/Beatmaps/PaginatedBeatmapContainer.cs
@@ -61,7 +61,7 @@ namespace osu.Game.Overlays.Profile.Sections.Beatmaps
             new GetUserBeatmapsRequest(User.Value.Id, type, VisiblePages++, ItemsPerPage);
 
         protected override Drawable CreateDrawableItem(APIBeatmapSet model) => model.OnlineID > 0
-            ? new BeatmapCard(model)
+            ? new BeatmapCardNormal(model)
             {
                 Anchor = Anchor.TopCentre,
                 Origin = Anchor.TopCentre,
diff --git a/osu.Game/Overlays/Rankings/SpotlightsLayout.cs b/osu.Game/Overlays/Rankings/SpotlightsLayout.cs
index bcfc2499b9..fb01656c24 100644
--- a/osu.Game/Overlays/Rankings/SpotlightsLayout.cs
+++ b/osu.Game/Overlays/Rankings/SpotlightsLayout.cs
@@ -136,12 +136,12 @@ namespace osu.Game.Overlays.Rankings
             {
                 new ScoresTable(1, response.Users),
                 // reverse ID flow is required for correct Z-ordering of the cards' expandable content (last card should be front-most).
-                new ReverseChildIDFillFlowContainer<BeatmapCard>
+                new ReverseChildIDFillFlowContainer<BeatmapCardNormal>
                 {
                     AutoSizeAxes = Axes.Y,
                     RelativeSizeAxes = Axes.X,
                     Spacing = new Vector2(10),
-                    Children = response.BeatmapSets.Select(b => new BeatmapCard(b)
+                    Children = response.BeatmapSets.Select(b => new BeatmapCardNormal(b)
                     {
                         Anchor = Anchor.TopCentre,
                         Origin = Anchor.TopCentre,
diff --git a/osu.Game/Screens/Play/SoloSpectator.cs b/osu.Game/Screens/Play/SoloSpectator.cs
index ba5663bfa3..b530965269 100644
--- a/osu.Game/Screens/Play/SoloSpectator.cs
+++ b/osu.Game/Screens/Play/SoloSpectator.cs
@@ -228,7 +228,7 @@ namespace osu.Game.Screens.Play
             onlineBeatmapRequest.Success += beatmapSet => Schedule(() =>
             {
                 this.beatmapSet = beatmapSet;
-                beatmapPanelContainer.Child = new BeatmapCard(this.beatmapSet, allowExpansion: false);
+                beatmapPanelContainer.Child = new BeatmapCardNormal(this.beatmapSet, allowExpansion: false);
                 checkForAutomaticDownload();
             });
 

From c7b9b176c61d9a9065814d7088f04d5215899fe7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 21 Dec 2021 08:26:19 +0100
Subject: [PATCH 1757/5547] Rename `BeatmapCard{Base => }`

---
 .../Cards/{BeatmapCardBase.cs => BeatmapCard.cs}   |  4 ++--
 .../Beatmaps/Drawables/Cards/BeatmapCardContent.cs | 14 +++++++-------
 .../Cards/BeatmapCardContentBackground.cs          |  4 ++--
 .../Cards/BeatmapCardDownloadProgressBar.cs        |  4 ++--
 .../Beatmaps/Drawables/Cards/BeatmapCardExtra.cs   |  2 +-
 .../Beatmaps/Drawables/Cards/BeatmapCardNormal.cs  |  2 +-
 .../Drawables/Cards/BeatmapCardThumbnail.cs        |  4 ++--
 .../Cards/Buttons/BeatmapCardIconButton.cs         |  2 +-
 .../Drawables/Cards/Buttons/DownloadButton.cs      |  4 ++--
 .../Drawables/Cards/Buttons/GoToBeatmapButton.cs   |  2 +-
 .../Beatmaps/Drawables/Cards/Buttons/PlayButton.cs |  2 +-
 .../Drawables/Cards/CollapsibleButtonContainer.cs  | 10 +++++-----
 12 files changed, 27 insertions(+), 27 deletions(-)
 rename osu.Game/Beatmaps/Drawables/Cards/{BeatmapCardBase.cs => BeatmapCard.cs} (94%)

diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardBase.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
similarity index 94%
rename from osu.Game/Beatmaps/Drawables/Cards/BeatmapCardBase.cs
rename to osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
index 77df0809bc..6adcdcfcb2 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardBase.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
@@ -15,7 +15,7 @@ using osu.Game.Overlays;
 
 namespace osu.Game.Beatmaps.Drawables.Cards
 {
-    public abstract class BeatmapCardBase : OsuClickableContainer
+    public abstract class BeatmapCard : OsuClickableContainer
     {
         public const float TRANSITION_DURATION = 400;
         public const float CORNER_RADIUS = 10;
@@ -30,7 +30,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
 
         protected readonly BeatmapDownloadTracker DownloadTracker;
 
-        protected BeatmapCardBase(APIBeatmapSet beatmapSet, bool allowExpansion = true)
+        protected BeatmapCard(APIBeatmapSet beatmapSet, bool allowExpansion = true)
             : base(HoverSampleSet.Submit)
         {
             Expanded = new BindableBool { Disabled = !allowExpansion };
diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardContent.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardContent.cs
index 9c43c16100..497283bc64 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardContent.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardContent.cs
@@ -54,7 +54,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
             {
                 RelativeSizeAxes = Axes.X,
                 AutoSizeAxes = Axes.Y,
-                CornerRadius = BeatmapCardBase.CORNER_RADIUS,
+                CornerRadius = BeatmapCard.CORNER_RADIUS,
                 Masking = true,
                 Unhovered = _ => updateFromHoverChange(),
                 Children = new Drawable[]
@@ -67,7 +67,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                     {
                         RelativeSizeAxes = Axes.X,
                         Height = height,
-                        CornerRadius = BeatmapCardBase.CORNER_RADIUS,
+                        CornerRadius = BeatmapCard.CORNER_RADIUS,
                         Masking = true,
                     },
                     dropdownContent = new HoverHandlingContainer
@@ -91,7 +91,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                     borderContainer = new Container
                     {
                         RelativeSizeAxes = Axes.Both,
-                        CornerRadius = BeatmapCardBase.CORNER_RADIUS,
+                        CornerRadius = BeatmapCard.CORNER_RADIUS,
                         Masking = true,
                         BorderThickness = 3,
                         Child = new Box
@@ -143,9 +143,9 @@ namespace osu.Game.Beatmaps.Drawables.Cards
             // This avoids depth issues where a hovered (scaled) card to the right of another card would be beneath the card to the left.
             this.ScaleTo(Expanded.Value ? 1.03f : 1, 500, Easing.OutQuint);
 
-            background.FadeTo(Expanded.Value ? 1 : 0, BeatmapCardBase.TRANSITION_DURATION, Easing.OutQuint);
-            dropdownContent.FadeTo(Expanded.Value ? 1 : 0, BeatmapCardBase.TRANSITION_DURATION, Easing.OutQuint);
-            borderContainer.FadeTo(Expanded.Value ? 1 : 0, BeatmapCardBase.TRANSITION_DURATION, Easing.OutQuint);
+            background.FadeTo(Expanded.Value ? 1 : 0, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
+            dropdownContent.FadeTo(Expanded.Value ? 1 : 0, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
+            borderContainer.FadeTo(Expanded.Value ? 1 : 0, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
 
             content.TweenEdgeEffectTo(new EdgeEffectParameters
             {
@@ -154,7 +154,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                 Radius = 10,
                 Colour = Colour4.Black.Opacity(Expanded.Value ? 0.3f : 0f),
                 Hollow = true,
-            }, BeatmapCardBase.TRANSITION_DURATION, Easing.OutQuint);
+            }, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
         }
 
         private class ExpandedContentScrollContainer : OsuScrollContainer
diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardContentBackground.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardContentBackground.cs
index 6388e1698c..392f5d1bfa 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardContentBackground.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardContentBackground.cs
@@ -62,10 +62,10 @@ namespace osu.Game.Beatmaps.Drawables.Cards
 
         private void updateState() => Schedule(() =>
         {
-            background.FadeColour(Dimmed.Value ? colourProvider.Background4 : colourProvider.Background2, BeatmapCardBase.TRANSITION_DURATION, Easing.OutQuint);
+            background.FadeColour(Dimmed.Value ? colourProvider.Background4 : colourProvider.Background2, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
 
             var gradient = ColourInfo.GradientHorizontal(Colour4.White.Opacity(0), Colour4.White.Opacity(0.2f));
-            cover.FadeColour(gradient, BeatmapCardBase.TRANSITION_DURATION, Easing.OutQuint);
+            cover.FadeColour(gradient, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
         });
     }
 }
diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardDownloadProgressBar.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardDownloadProgressBar.cs
index b80c5221ab..ffb4e0c540 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardDownloadProgressBar.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardDownloadProgressBar.cs
@@ -82,14 +82,14 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                     break;
 
                 case DownloadState.Importing:
-                    foregroundFill.FadeColour(colours.Yellow, BeatmapCardBase.TRANSITION_DURATION, Easing.OutQuint);
+                    foregroundFill.FadeColour(colours.Yellow, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
                     break;
             }
         }
 
         private void progressChanged()
         {
-            foreground.ResizeWidthTo((float)progress.Value, progress.Value > 0 ? BeatmapCardBase.TRANSITION_DURATION : 0, Easing.OutQuint);
+            foreground.ResizeWidthTo((float)progress.Value, progress.Value > 0 ? BeatmapCard.TRANSITION_DURATION : 0, Easing.OutQuint);
         }
     }
 }
diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtra.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtra.cs
index 308cba9f0f..7f70423ff9 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtra.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtra.cs
@@ -20,7 +20,7 @@ using osu.Game.Resources.Localisation.Web;
 
 namespace osu.Game.Beatmaps.Drawables.Cards
 {
-    public class BeatmapCardExtra : BeatmapCardBase
+    public class BeatmapCardExtra : BeatmapCard
     {
         protected override Drawable IdleContent => idleBottomContent;
         protected override Drawable DownloadInProgressContent => downloadProgressBar;
diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardNormal.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardNormal.cs
index c70d903d50..edca310db9 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardNormal.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardNormal.cs
@@ -21,7 +21,7 @@ using osu.Game.Resources.Localisation.Web;
 
 namespace osu.Game.Beatmaps.Drawables.Cards
 {
-    public class BeatmapCardNormal : BeatmapCardBase
+    public class BeatmapCardNormal : BeatmapCard
     {
         protected override Drawable IdleContent => idleBottomContent;
         protected override Drawable DownloadInProgressContent => downloadProgressBar;
diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardThumbnail.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardThumbnail.cs
index e6b305552a..f11a5916e1 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardThumbnail.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardThumbnail.cs
@@ -88,8 +88,8 @@ namespace osu.Game.Beatmaps.Drawables.Cards
         {
             bool shouldDim = Dimmed.Value || playButton.Playing.Value;
 
-            playButton.FadeTo(shouldDim ? 1 : 0, BeatmapCardBase.TRANSITION_DURATION, Easing.OutQuint);
-            cover.FadeColour(shouldDim ? OsuColour.Gray(0.2f) : Color4.White, BeatmapCardBase.TRANSITION_DURATION, Easing.OutQuint);
+            playButton.FadeTo(shouldDim ? 1 : 0, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
+            cover.FadeColour(shouldDim ? OsuColour.Gray(0.2f) : Color4.White, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
         }
     }
 }
diff --git a/osu.Game/Beatmaps/Drawables/Cards/Buttons/BeatmapCardIconButton.cs b/osu.Game/Beatmaps/Drawables/Cards/Buttons/BeatmapCardIconButton.cs
index 02c9ea640a..e362e3abeb 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/Buttons/BeatmapCardIconButton.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/Buttons/BeatmapCardIconButton.cs
@@ -115,7 +115,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards.Buttons
             bool isHovered = IsHovered && Enabled.Value;
 
             content.ScaleTo(isHovered ? 1.2f : 1, 500, Easing.OutQuint);
-            content.FadeColour(isHovered ? HoverColour : IdleColour, BeatmapCardBase.TRANSITION_DURATION, Easing.OutQuint);
+            content.FadeColour(isHovered ? HoverColour : IdleColour, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
         }
     }
 }
diff --git a/osu.Game/Beatmaps/Drawables/Cards/Buttons/DownloadButton.cs b/osu.Game/Beatmaps/Drawables/Cards/Buttons/DownloadButton.cs
index d7ba4af21e..c94e335e8f 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/Buttons/DownloadButton.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/Buttons/DownloadButton.cs
@@ -69,7 +69,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards.Buttons
                 case DownloadState.LocallyAvailable:
                     Action = null;
                     TooltipText = string.Empty;
-                    this.FadeOut(BeatmapCardBase.TRANSITION_DURATION, Easing.OutQuint);
+                    this.FadeOut(BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
                     break;
 
                 case DownloadState.NotDownloaded:
@@ -81,7 +81,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards.Buttons
                     }
 
                     Action = () => beatmaps.Download(beatmapSet, preferNoVideo.Value);
-                    this.FadeIn(BeatmapCardBase.TRANSITION_DURATION, Easing.OutQuint);
+                    this.FadeIn(BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
                     spinner.Hide();
                     Icon.Show();
 
diff --git a/osu.Game/Beatmaps/Drawables/Cards/Buttons/GoToBeatmapButton.cs b/osu.Game/Beatmaps/Drawables/Cards/Buttons/GoToBeatmapButton.cs
index b039eb6f10..9a6a3c01b7 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/Buttons/GoToBeatmapButton.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/Buttons/GoToBeatmapButton.cs
@@ -43,7 +43,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards.Buttons
 
         private void updateState()
         {
-            this.FadeTo(state.Value == DownloadState.LocallyAvailable ? 1 : 0, BeatmapCardBase.TRANSITION_DURATION, Easing.OutQuint);
+            this.FadeTo(state.Value == DownloadState.LocallyAvailable ? 1 : 0, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
         }
     }
 }
diff --git a/osu.Game/Beatmaps/Drawables/Cards/Buttons/PlayButton.cs b/osu.Game/Beatmaps/Drawables/Cards/Buttons/PlayButton.cs
index 6d66d5001a..f7bab26666 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/Buttons/PlayButton.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/Buttons/PlayButton.cs
@@ -141,7 +141,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards.Buttons
         private void toggleLoading(bool loading)
         {
             Enabled.Value = !loading;
-            icon.FadeTo(loading ? 0 : 1, BeatmapCardBase.TRANSITION_DURATION, Easing.OutQuint);
+            icon.FadeTo(loading ? 0 : 1, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
             loadingSpinner.State.Value = loading ? Visibility.Visible : Visibility.Hidden;
         }
     }
diff --git a/osu.Game/Beatmaps/Drawables/Cards/CollapsibleButtonContainer.cs b/osu.Game/Beatmaps/Drawables/Cards/CollapsibleButtonContainer.cs
index e1a630182f..3a2cb80a8d 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/CollapsibleButtonContainer.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/CollapsibleButtonContainer.cs
@@ -78,7 +78,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
 
             RelativeSizeAxes = Axes.Y;
             Masking = true;
-            CornerRadius = BeatmapCardBase.CORNER_RADIUS;
+            CornerRadius = BeatmapCard.CORNER_RADIUS;
 
             InternalChildren = new Drawable[]
             {
@@ -133,7 +133,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                 {
                     Name = @"Main content",
                     RelativeSizeAxes = Axes.Y,
-                    CornerRadius = BeatmapCardBase.CORNER_RADIUS,
+                    CornerRadius = BeatmapCard.CORNER_RADIUS,
                     Masking = true,
                     Children = new Drawable[]
                     {
@@ -169,10 +169,10 @@ namespace osu.Game.Beatmaps.Drawables.Cards
         {
             float targetWidth = Width - (ShowDetails.Value ? ButtonsExpandedWidth : ButtonsCollapsedWidth);
 
-            mainArea.ResizeWidthTo(targetWidth, BeatmapCardBase.TRANSITION_DURATION, Easing.OutQuint);
+            mainArea.ResizeWidthTo(targetWidth, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
 
-            background.FadeColour(downloadTracker.State.Value == DownloadState.LocallyAvailable ? colours.Lime0 : colourProvider.Background3, BeatmapCardBase.TRANSITION_DURATION, Easing.OutQuint);
-            buttons.FadeTo(ShowDetails.Value ? 1 : 0, BeatmapCardBase.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);
 
             foreach (var button in buttons)
             {

From 0198d49a3a8a016a3474c28d4b14108e033fe410 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 21 Dec 2021 16:38:03 +0900
Subject: [PATCH 1758/5547] Update framework

---
 osu.Android.props        | 2 +-
 osu.Game/osu.Game.csproj | 2 +-
 osu.iOS.props            | 4 ++--
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Android.props b/osu.Android.props
index 1532d4ce23..ca4d88a8a7 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -52,7 +52,7 @@
   </ItemGroup>
   <ItemGroup>
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1215.0" />
-    <PackageReference Include="ppy.osu.Framework.Android" Version="2021.1220.0" />
+    <PackageReference Include="ppy.osu.Framework.Android" Version="2021.1221.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
     <!-- Realm needs to be directly referenced in all Xamarin projects, as it will not pull in its transitive dependencies otherwise. -->
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 6e6002bc8e..c538f55e89 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="10.7.1" />
-    <PackageReference Include="ppy.osu.Framework" Version="2021.1220.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2021.1221.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1215.0" />
     <PackageReference Include="Sentry" Version="3.12.1" />
     <PackageReference Include="SharpCompress" Version="0.30.1" />
diff --git a/osu.iOS.props b/osu.iOS.props
index de359245d1..5cc1857dfe 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -60,7 +60,7 @@
     <Reference Include="System.Net.Http" />
   </ItemGroup>
   <ItemGroup Label="Package References">
-    <PackageReference Include="ppy.osu.Framework.iOS" Version="2021.1220.0" />
+    <PackageReference Include="ppy.osu.Framework.iOS" Version="2021.1221.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1215.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net5.0 / net6.0) -->
@@ -83,7 +83,7 @@
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="2.2.6" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.Core" Version="2.2.6" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
-    <PackageReference Include="ppy.osu.Framework" Version="2021.1220.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2021.1221.0" />
     <PackageReference Include="SharpCompress" Version="0.30.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
     <PackageReference Include="SharpRaven" Version="2.4.0" />

From cd10af633cdab398e9cf443c1677d087288ae769 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 21 Dec 2021 08:46:00 +0100
Subject: [PATCH 1759/5547] Remove unused private method

---
 osu.Game/Configuration/SessionStatics.cs | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/osu.Game/Configuration/SessionStatics.cs b/osu.Game/Configuration/SessionStatics.cs
index fca0ad9641..d41fce8747 100644
--- a/osu.Game/Configuration/SessionStatics.cs
+++ b/osu.Game/Configuration/SessionStatics.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.Bindables;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays;
@@ -35,8 +34,6 @@ namespace osu.Game.Configuration
             GetBindable<bool>(Static.LowBatteryNotificationShownOnce).SetDefault();
             GetBindable<double?>(Static.LastHoverSoundPlaybackTime).SetDefault();
         }
-
-        private void ensureDefault<T>(Bindable<T> bindable) => bindable.SetDefault();
     }
 
     public enum Static

From 979624160ff2a33fc60c93975b5a7edbb56d93b6 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 21 Dec 2021 08:47:41 +0100
Subject: [PATCH 1760/5547] Do not reset last hover sound playback time on
 inactivity

---
 osu.Game.Tests/NonVisual/SessionStaticsTest.cs | 3 ++-
 osu.Game/Configuration/SessionStatics.cs       | 1 -
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/NonVisual/SessionStaticsTest.cs b/osu.Game.Tests/NonVisual/SessionStaticsTest.cs
index 013cdc30b4..a7831b4870 100644
--- a/osu.Game.Tests/NonVisual/SessionStaticsTest.cs
+++ b/osu.Game.Tests/NonVisual/SessionStaticsTest.cs
@@ -31,7 +31,8 @@ namespace osu.Game.Tests.NonVisual
             Assert.IsTrue(sessionStatics.GetBindable<bool>(Static.LoginOverlayDisplayed).IsDefault);
             Assert.IsTrue(sessionStatics.GetBindable<bool>(Static.MutedAudioNotificationShownOnce).IsDefault);
             Assert.IsTrue(sessionStatics.GetBindable<bool>(Static.LowBatteryNotificationShownOnce).IsDefault);
-            Assert.IsTrue(sessionStatics.GetBindable<double?>(Static.LastHoverSoundPlaybackTime).IsDefault);
+            // some statics should not reset despite inactivity.
+            Assert.IsFalse(sessionStatics.GetBindable<double?>(Static.LastHoverSoundPlaybackTime).IsDefault);
         }
     }
 }
diff --git a/osu.Game/Configuration/SessionStatics.cs b/osu.Game/Configuration/SessionStatics.cs
index d41fce8747..837ee7e634 100644
--- a/osu.Game/Configuration/SessionStatics.cs
+++ b/osu.Game/Configuration/SessionStatics.cs
@@ -32,7 +32,6 @@ namespace osu.Game.Configuration
             GetBindable<bool>(Static.LoginOverlayDisplayed).SetDefault();
             GetBindable<bool>(Static.MutedAudioNotificationShownOnce).SetDefault();
             GetBindable<bool>(Static.LowBatteryNotificationShownOnce).SetDefault();
-            GetBindable<double?>(Static.LastHoverSoundPlaybackTime).SetDefault();
         }
     }
 

From b6a458a07ec9518fb011782f2cceb8560f82a273 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 21 Dec 2021 08:50:25 +0100
Subject: [PATCH 1761/5547] Cover seasonal backgrounds not resetting on
 inactivity in test

---
 osu.Game.Tests/NonVisual/SessionStaticsTest.cs | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/osu.Game.Tests/NonVisual/SessionStaticsTest.cs b/osu.Game.Tests/NonVisual/SessionStaticsTest.cs
index a7831b4870..cd02f15adf 100644
--- a/osu.Game.Tests/NonVisual/SessionStaticsTest.cs
+++ b/osu.Game.Tests/NonVisual/SessionStaticsTest.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 NUnit.Framework;
 using osu.Game.Configuration;
+using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Tests.NonVisual
 {
@@ -20,11 +22,13 @@ namespace osu.Game.Tests.NonVisual
             sessionStatics.SetValue(Static.MutedAudioNotificationShownOnce, true);
             sessionStatics.SetValue(Static.LowBatteryNotificationShownOnce, true);
             sessionStatics.SetValue(Static.LastHoverSoundPlaybackTime, (double?)1d);
+            sessionStatics.SetValue(Static.SeasonalBackgrounds, new APISeasonalBackgrounds { EndDate = new DateTimeOffset(2022, 1, 1, 0, 0, 0, TimeSpan.Zero) });
 
             Assert.IsFalse(sessionStatics.GetBindable<bool>(Static.LoginOverlayDisplayed).IsDefault);
             Assert.IsFalse(sessionStatics.GetBindable<bool>(Static.MutedAudioNotificationShownOnce).IsDefault);
             Assert.IsFalse(sessionStatics.GetBindable<bool>(Static.LowBatteryNotificationShownOnce).IsDefault);
             Assert.IsFalse(sessionStatics.GetBindable<double?>(Static.LastHoverSoundPlaybackTime).IsDefault);
+            Assert.IsFalse(sessionStatics.GetBindable<APISeasonalBackgrounds>(Static.SeasonalBackgrounds).IsDefault);
 
             sessionStatics.ResetAfterInactivity();
 
@@ -33,6 +37,7 @@ namespace osu.Game.Tests.NonVisual
             Assert.IsTrue(sessionStatics.GetBindable<bool>(Static.LowBatteryNotificationShownOnce).IsDefault);
             // some statics should not reset despite inactivity.
             Assert.IsFalse(sessionStatics.GetBindable<double?>(Static.LastHoverSoundPlaybackTime).IsDefault);
+            Assert.IsFalse(sessionStatics.GetBindable<APISeasonalBackgrounds>(Static.SeasonalBackgrounds).IsDefault);
         }
     }
 }

From 51b7e920c0971603b80cc00c81cdcfa3341a0efd Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 21 Dec 2021 16:57:56 +0900
Subject: [PATCH 1762/5547] Fix delete button being able to show on current
 item

---
 .../Multiplayer/Match/Playlist/MultiplayerQueueList.cs       | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerQueueList.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerQueueList.cs
index 3e0f663d42..70d01d41f0 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerQueueList.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerQueueList.cs
@@ -78,9 +78,12 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist
 
             private void updateDeleteButtonVisibility()
             {
+                if (multiplayerClient.Room == null)
+                    return;
+
                 bool isItemOwner = Item.OwnerID == api.LocalUser.Value.OnlineID || multiplayerClient.IsHost;
 
-                AllowDeletion = isItemOwner && SelectedItem.Value != Item;
+                AllowDeletion = isItemOwner && Item.ID != multiplayerClient.Room.Settings.PlaylistItemId;
                 AllowEditing = isItemOwner;
             }
         }

From a7aea49cb38be1108d91bcc884a25b9526019ee4 Mon Sep 17 00:00:00 2001
From: MBmasher <mbmasher@gmail.com>
Date: Tue, 21 Dec 2021 20:06:07 +1100
Subject: [PATCH 1763/5547] Rename `osuPreviousHitObject` to `currentHitObject`

---
 osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
index 76ce6dc057..1a707b26b5 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
@@ -73,7 +73,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
                     double stackNerf = Math.Min(1.0, (currentObj.LazyJumpDistance / scalingFactor) / 25.0);
 
                     // Bonus based on how visible the object is.
-                    double opacityBonus = 1.0 + max_opacity_bonus * (1.0 - osuCurrent.Opacity(osuPreviousHitObject.StartTime, hidden));
+                    double opacityBonus = 1.0 + max_opacity_bonus * (1.0 - osuCurrent.Opacity(currentHitObject.StartTime, hidden));
 
                     result += stackNerf * scalingFactor * jumpDistance / cumulativeStrainTime;
                 }

From 3d3de00581648712338aa5237926a143f8275710 Mon Sep 17 00:00:00 2001
From: MBmasher <mbmasher@gmail.com>
Date: Tue, 21 Dec 2021 20:06:53 +1100
Subject: [PATCH 1764/5547] Move `hidden` initialisation to Flashlight
 constructor

---
 osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
index 1a707b26b5..3b23ec505b 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
@@ -20,6 +20,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
             : base(mods)
         {
             this.mods = mods;
+            this.hidden = mods.Any(m => m is OsuModHidden);
         }
 
         private double skillMultiplier => 0.1;
@@ -40,8 +41,6 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
             if (current.BaseObject is Spinner)
                 return 0;
 
-            hidden = mods.Any(m => m is OsuModHidden);
-
             var osuCurrent = (OsuDifficultyHitObject)current;
             var osuHitObject = (OsuHitObject)(osuCurrent.BaseObject);
 

From 5d8968498cacbadfa704f4aa730652d6a6709228 Mon Sep 17 00:00:00 2001
From: MBmasher <mbmasher@gmail.com>
Date: Tue, 21 Dec 2021 20:08:57 +1100
Subject: [PATCH 1765/5547] Adjust `skillMultiplier` after merging #15728,
 #15867

---
 osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
index 3b23ec505b..266f4e8960 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
@@ -23,7 +23,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
             this.hidden = mods.Any(m => m is OsuModHidden);
         }
 
-        private double skillMultiplier => 0.1;
+        private double skillMultiplier => 0.05;
         private double strainDecayBase => 0.15;
         protected override double DecayWeight => 1.0;
         protected override int HistoryLength => 10; // Look back for 10 notes is added for the sake of flashlight calculations.

From c5de203aa5258b66a2b7067c6306c12b75e158f3 Mon Sep 17 00:00:00 2001
From: MBmasher <mbmasher@gmail.com>
Date: Tue, 21 Dec 2021 20:10:19 +1100
Subject: [PATCH 1766/5547] Multiply `opacityBonus` to base strain

---
 osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
index 266f4e8960..8b2e66e0a7 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
@@ -74,7 +74,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
                     // Bonus based on how visible the object is.
                     double opacityBonus = 1.0 + max_opacity_bonus * (1.0 - osuCurrent.Opacity(currentHitObject.StartTime, hidden));
 
-                    result += stackNerf * scalingFactor * jumpDistance / cumulativeStrainTime;
+                    result += stackNerf * opacityBonus * scalingFactor * jumpDistance / cumulativeStrainTime;
                 }
 
                 lastObj = currentObj;

From a34d24fb20bc57361e797debbe636bf6622f059f Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 21 Dec 2021 18:37:42 +0900
Subject: [PATCH 1767/5547] Disallow expired items from showing delete button

This isn't possible in practice since expired items are removed from the
queue list, but this helps out in tests.
---
 .../Multiplayer/Match/Playlist/MultiplayerQueueList.cs        | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerQueueList.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerQueueList.cs
index 70d01d41f0..4143ede949 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerQueueList.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerQueueList.cs
@@ -83,8 +83,8 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist
 
                 bool isItemOwner = Item.OwnerID == api.LocalUser.Value.OnlineID || multiplayerClient.IsHost;
 
-                AllowDeletion = isItemOwner && Item.ID != multiplayerClient.Room.Settings.PlaylistItemId;
-                AllowEditing = isItemOwner;
+                AllowDeletion = isItemOwner && !Item.Expired && Item.ID != multiplayerClient.Room.Settings.PlaylistItemId;
+                AllowEditing = isItemOwner && !Item.Expired;
             }
         }
     }

From e2f8c7108117cdffb28b70427e744fa5ae1eef52 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 21 Dec 2021 18:38:31 +0900
Subject: [PATCH 1768/5547] Fix test

---
 .../Multiplayer/TestSceneMultiplayerQueueList.cs    | 13 ++++---------
 1 file changed, 4 insertions(+), 9 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs
index ef71dfe772..33741e3aa2 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs
@@ -6,7 +6,6 @@ using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
-using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Platform;
@@ -26,8 +25,6 @@ namespace osu.Game.Tests.Visual.Multiplayer
 {
     public class TestSceneMultiplayerQueueList : MultiplayerTestScene
     {
-        private readonly Bindable<PlaylistItem> selectedItem = new Bindable<PlaylistItem>();
-
         [Cached(typeof(UserLookupCache))]
         private readonly TestUserLookupCache userLookupCache = new TestUserLookupCache();
 
@@ -50,14 +47,11 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             AddStep("create playlist", () =>
             {
-                selectedItem.Value = null;
-
                 Child = playlist = new MultiplayerQueueList
                 {
                     Anchor = Anchor.Centre,
                     Origin = Anchor.Centre,
                     Size = new Vector2(500, 300),
-                    SelectedItem = { BindTarget = selectedItem },
                     Items = { BindTarget = Client.APIRoom!.Playlist }
                 };
             });
@@ -111,12 +105,13 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             addPlaylistItem(() => API.LocalUser.Value.OnlineID);
 
-            AddStep("select item 0", () => selectedItem.Value = playlist.ChildrenOfType<RearrangeableListItem<PlaylistItem>>().ElementAt(0).Model);
             assertDeleteButtonVisibility(0, false);
             assertDeleteButtonVisibility(1, true);
 
-            AddStep("select item 1", () => selectedItem.Value = playlist.ChildrenOfType<RearrangeableListItem<PlaylistItem>>().ElementAt(1).Model);
-            assertDeleteButtonVisibility(0, true);
+            AddStep("finish current item", () => Client.FinishCurrentItem());
+            AddUntilStep("wait for next item to be selected", () => Client.Room?.Settings.PlaylistItemId == 2);
+
+            assertDeleteButtonVisibility(0, false);
             assertDeleteButtonVisibility(1, false);
         }
 

From 4ce61d426099b4f99f0be921d5290913b5c7c8be Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 21 Dec 2021 18:40:26 +0900
Subject: [PATCH 1769/5547] Directly bind to room updates

Currently doesn't really cause any difference, however it may in the
future if we decide the queueing algorithm shouldn't update PlaylistOrder
when an item has been played.
---
 .../Match/Playlist/MultiplayerQueueList.cs    | 22 ++++++++++---------
 1 file changed, 12 insertions(+), 10 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerQueueList.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerQueueList.cs
index 4143ede949..1653d416d8 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerQueueList.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerQueueList.cs
@@ -8,7 +8,6 @@ using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Online.API;
-using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Rooms;
 using osuTK;
@@ -54,12 +53,6 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist
             [Resolved]
             private MultiplayerClient multiplayerClient { get; set; }
 
-            [Resolved(typeof(Room), nameof(Room.Host))]
-            private Bindable<APIUser> host { get; set; }
-
-            [Resolved(typeof(Room), nameof(Room.QueueMode))]
-            private Bindable<QueueMode> queueMode { get; set; }
-
             public QueuePlaylistItem(PlaylistItem item)
                 : base(item)
             {
@@ -71,11 +64,12 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist
 
                 RequestDeletion = item => multiplayerClient.RemovePlaylistItem(item.ID);
 
-                host.BindValueChanged(_ => updateDeleteButtonVisibility());
-                queueMode.BindValueChanged(_ => updateDeleteButtonVisibility());
-                SelectedItem.BindValueChanged(_ => updateDeleteButtonVisibility(), true);
+                multiplayerClient.RoomUpdated += onRoomUpdated;
+                onRoomUpdated();
             }
 
+            private void onRoomUpdated() => Scheduler.AddOnce(updateDeleteButtonVisibility);
+
             private void updateDeleteButtonVisibility()
             {
                 if (multiplayerClient.Room == null)
@@ -86,6 +80,14 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist
                 AllowDeletion = isItemOwner && !Item.Expired && Item.ID != multiplayerClient.Room.Settings.PlaylistItemId;
                 AllowEditing = isItemOwner && !Item.Expired;
             }
+
+            protected override void Dispose(bool isDisposing)
+            {
+                base.Dispose(isDisposing);
+
+                if (multiplayerClient != null)
+                    multiplayerClient.RoomUpdated -= onRoomUpdated;
+            }
         }
     }
 }

From 4a3a5054fd397c0803231f02f27ad06c89db9793 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 21 Dec 2021 18:42:37 +0900
Subject: [PATCH 1770/5547] Ensure `CustomDataDirectoryTest` methods use a
 fresh directory to avoid IO errors

Resolves test failures like https://github.com/ppy/osu/runs/4592088736?check_suite_focus=true.
---
 .../NonVisual/CustomDataDirectoryTest.cs      | 30 +++++++++++++------
 1 file changed, 21 insertions(+), 9 deletions(-)

diff --git a/osu.Game.Tests/NonVisual/CustomDataDirectoryTest.cs b/osu.Game.Tests/NonVisual/CustomDataDirectoryTest.cs
index 8a063b3c6e..8d15be44fa 100644
--- a/osu.Game.Tests/NonVisual/CustomDataDirectoryTest.cs
+++ b/osu.Game.Tests/NonVisual/CustomDataDirectoryTest.cs
@@ -61,6 +61,7 @@ namespace osu.Game.Tests.NonVisual
                 finally
                 {
                     host.Exit();
+                    cleanupPath(customPath);
                 }
             }
         }
@@ -94,6 +95,7 @@ namespace osu.Game.Tests.NonVisual
                 finally
                 {
                     host.Exit();
+                    cleanupPath(customPath);
                 }
             }
         }
@@ -160,6 +162,7 @@ namespace osu.Game.Tests.NonVisual
                 finally
                 {
                     host.Exit();
+                    cleanupPath(customPath);
                 }
             }
         }
@@ -168,7 +171,7 @@ namespace osu.Game.Tests.NonVisual
         public void TestMigrationBetweenTwoTargets()
         {
             string customPath = prepareCustomPath();
-            string customPath2 = prepareCustomPath("-2");
+            string customPath2 = prepareCustomPath();
 
             using (var host = new CustomTestHeadlessGameHost())
             {
@@ -185,7 +188,7 @@ namespace osu.Game.Tests.NonVisual
                     Assert.That(File.Exists(Path.Combine(customPath2, database_filename)));
 
                     // some files may have been left behind for whatever reason, but that's not what we're testing here.
-                    customPath = prepareCustomPath();
+                    cleanupPath(customPath);
 
                     Assert.DoesNotThrow(() => osu.Migrate(customPath));
                     Assert.That(File.Exists(Path.Combine(customPath, database_filename)));
@@ -193,6 +196,8 @@ namespace osu.Game.Tests.NonVisual
                 finally
                 {
                     host.Exit();
+                    cleanupPath(customPath);
+                    cleanupPath(customPath2);
                 }
             }
         }
@@ -214,6 +219,7 @@ namespace osu.Game.Tests.NonVisual
                 finally
                 {
                     host.Exit();
+                    cleanupPath(customPath);
                 }
             }
         }
@@ -243,6 +249,7 @@ namespace osu.Game.Tests.NonVisual
                 finally
                 {
                     host.Exit();
+                    cleanupPath(customPath);
                 }
             }
         }
@@ -272,6 +279,7 @@ namespace osu.Game.Tests.NonVisual
                 finally
                 {
                     host.Exit();
+                    cleanupPath(customPath);
                 }
             }
         }
@@ -286,14 +294,18 @@ namespace osu.Game.Tests.NonVisual
             return path;
         }
 
-        private string prepareCustomPath(string suffix = "")
+        private static string prepareCustomPath() => Path.Combine(TestRunHeadlessGameHost.TemporaryTestDirectory, $"custom-path-{Guid.NewGuid()}");
+
+        private static void cleanupPath(string path)
         {
-            string path = Path.Combine(TestRunHeadlessGameHost.TemporaryTestDirectory, $"custom-path{suffix}");
-
-            if (Directory.Exists(path))
-                Directory.Delete(path, true);
-
-            return path;
+            try
+            {
+                if (Directory.Exists(path))
+                    Directory.Delete(path, true);
+            }
+            catch
+            {
+            }
         }
 
         public class CustomTestHeadlessGameHost : CleanRunHeadlessGameHost

From 2aafcd3628463ccd2c5c0c8c88b32495ebc8694c Mon Sep 17 00:00:00 2001
From: MBmasher <mbmasher@gmail.com>
Date: Tue, 21 Dec 2021 20:58:05 +1100
Subject: [PATCH 1771/5547] Refactor code regarding `hidden` boolean

---
 osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
index 8b2e66e0a7..5d2052046b 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
@@ -19,8 +19,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
         public Flashlight(Mod[] mods)
             : base(mods)
         {
-            this.mods = mods;
-            this.hidden = mods.Any(m => m is OsuModHidden);
+            hidden = mods.Any(m => m is OsuModHidden);
         }
 
         private double skillMultiplier => 0.05;
@@ -28,8 +27,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
         protected override double DecayWeight => 1.0;
         protected override int HistoryLength => 10; // Look back for 10 notes is added for the sake of flashlight calculations.
 
-        private readonly Mod[] mods;
-        private bool hidden;
+        private readonly bool hidden;
 
         private const double max_opacity_bonus = 0.4;
         private const double hidden_bonus = 0.2;

From cca02a8016088c645a64b6102f37120b83d0d300 Mon Sep 17 00:00:00 2001
From: StanR <hi@stanr.info>
Date: Tue, 21 Dec 2021 13:08:31 +0300
Subject: [PATCH 1772/5547] Create PerformanceAttributes

---
 .../Difficulty/CatchPerformanceAttributes.cs  | 11 ++++++++
 .../Difficulty/CatchPerformanceCalculator.cs  | 11 +++-----
 .../Difficulty/ManiaPerformanceAttributes.cs  | 20 ++++++++++++++
 .../Difficulty/ManiaPerformanceCalculator.cs  | 17 +++++-------
 .../Difficulty/OsuPerformanceAttributes.cs    | 26 +++++++++++++++++++
 .../Difficulty/OsuPerformanceCalculator.cs    | 22 +++++++---------
 .../Difficulty/TaikoPerformanceAttributes.cs  | 17 ++++++++++++
 .../Difficulty/TaikoPerformanceCalculator.cs  | 16 +++++-------
 .../Difficulty/PerformanceAttributes.cs       | 16 ++++++++++++
 .../Difficulty/PerformanceCalculator.cs       |  2 +-
 osu.Game/Scoring/ScorePerformanceCache.cs     |  2 +-
 .../Play/HUD/PerformancePointsCounter.cs      |  2 +-
 12 files changed, 119 insertions(+), 43 deletions(-)
 create mode 100644 osu.Game.Rulesets.Catch/Difficulty/CatchPerformanceAttributes.cs
 create mode 100644 osu.Game.Rulesets.Mania/Difficulty/ManiaPerformanceAttributes.cs
 create mode 100644 osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceAttributes.cs
 create mode 100644 osu.Game.Rulesets.Taiko/Difficulty/TaikoPerformanceAttributes.cs
 create mode 100644 osu.Game/Rulesets/Difficulty/PerformanceAttributes.cs

diff --git a/osu.Game.Rulesets.Catch/Difficulty/CatchPerformanceAttributes.cs b/osu.Game.Rulesets.Catch/Difficulty/CatchPerformanceAttributes.cs
new file mode 100644
index 0000000000..1335fc2d23
--- /dev/null
+++ b/osu.Game.Rulesets.Catch/Difficulty/CatchPerformanceAttributes.cs
@@ -0,0 +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 osu.Game.Rulesets.Difficulty;
+
+namespace osu.Game.Rulesets.Catch.Difficulty
+{
+    public class CatchPerformanceAttributes : PerformanceAttributes
+    {
+    }
+}
diff --git a/osu.Game.Rulesets.Catch/Difficulty/CatchPerformanceCalculator.cs b/osu.Game.Rulesets.Catch/Difficulty/CatchPerformanceCalculator.cs
index d3f3445ff1..e224675977 100644
--- a/osu.Game.Rulesets.Catch/Difficulty/CatchPerformanceCalculator.cs
+++ b/osu.Game.Rulesets.Catch/Difficulty/CatchPerformanceCalculator.cs
@@ -28,7 +28,7 @@ namespace osu.Game.Rulesets.Catch.Difficulty
         {
         }
 
-        public override double Calculate(Dictionary<string, double> categoryDifficulty = null)
+        public override PerformanceAttributes Calculate()
         {
             mods = Score.Mods;
 
@@ -90,13 +90,10 @@ namespace osu.Game.Rulesets.Catch.Difficulty
             if (mods.Any(m => m is ModNoFail))
                 value *= 0.90;
 
-            if (categoryDifficulty != null)
+            return new CatchPerformanceAttributes
             {
-                categoryDifficulty.Add("AR", Attributes.ApproachRate);
-                categoryDifficulty.Add("Max Combo", Attributes.MaxCombo);
-            }
-
-            return value;
+                Total = value
+            };
         }
 
         private double accuracy() => totalHits() == 0 ? 0 : Math.Clamp((double)totalSuccessfulHits() / totalHits(), 0, 1);
diff --git a/osu.Game.Rulesets.Mania/Difficulty/ManiaPerformanceAttributes.cs b/osu.Game.Rulesets.Mania/Difficulty/ManiaPerformanceAttributes.cs
new file mode 100644
index 0000000000..da9634ba47
--- /dev/null
+++ b/osu.Game.Rulesets.Mania/Difficulty/ManiaPerformanceAttributes.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 Newtonsoft.Json;
+using osu.Game.Rulesets.Difficulty;
+
+namespace osu.Game.Rulesets.Mania.Difficulty
+{
+    public class ManiaPerformanceAttributes : PerformanceAttributes
+    {
+        [JsonProperty("difficulty")]
+        public double Difficulty { get; set; }
+
+        [JsonProperty("accuracy")]
+        public double Accuracy { get; set; }
+
+        [JsonProperty("scaled_score")]
+        public double ScaledScore { get; set; }
+    }
+}
diff --git a/osu.Game.Rulesets.Mania/Difficulty/ManiaPerformanceCalculator.cs b/osu.Game.Rulesets.Mania/Difficulty/ManiaPerformanceCalculator.cs
index 6bf0a5acb4..cb4c3fffa4 100644
--- a/osu.Game.Rulesets.Mania/Difficulty/ManiaPerformanceCalculator.cs
+++ b/osu.Game.Rulesets.Mania/Difficulty/ManiaPerformanceCalculator.cs
@@ -32,7 +32,7 @@ namespace osu.Game.Rulesets.Mania.Difficulty
         {
         }
 
-        public override double Calculate(Dictionary<string, double> categoryDifficulty = null)
+        public override PerformanceAttributes Calculate()
         {
             mods = Score.Mods;
             scaledScore = Score.TotalScore;
@@ -69,16 +69,13 @@ namespace osu.Game.Rulesets.Mania.Difficulty
                     Math.Pow(accValue, 1.1), 1.0 / 1.1
                 ) * multiplier;
 
-            if (categoryDifficulty != null)
+            return new ManiaPerformanceAttributes
             {
-                categoryDifficulty.Add("Difficulty", difficultyValue);
-                categoryDifficulty.Add("Accuracy", accValue);
-                categoryDifficulty.Add("Scaled Score", scaledScore);
-                categoryDifficulty.Add("Great Hit Window", Attributes.GreatHitWindow);
-                categoryDifficulty.Add("Max Combo", Attributes.MaxCombo);
-            }
-
-            return totalValue;
+                Difficulty = difficultyValue,
+                Accuracy = accValue,
+                ScaledScore = scaledScore,
+                Total = totalValue
+            };
         }
 
         private double computeDifficultyValue()
diff --git a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceAttributes.cs b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceAttributes.cs
new file mode 100644
index 0000000000..6c7760d144
--- /dev/null
+++ b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceAttributes.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 Newtonsoft.Json;
+using osu.Game.Rulesets.Difficulty;
+
+namespace osu.Game.Rulesets.Osu.Difficulty
+{
+    public class OsuPerformanceAttributes : PerformanceAttributes
+    {
+        [JsonProperty("aim")]
+        public double Aim { get; set; }
+
+        [JsonProperty("speed")]
+        public double Speed { get; set; }
+
+        [JsonProperty("accuracy")]
+        public double Accuracy { get; set; }
+
+        [JsonProperty("flashlight")]
+        public double Flashlight { get; set; }
+
+        [JsonProperty("effective_miss_count")]
+        public double EffectiveMissCount { get; set; }
+    }
+}
diff --git a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
index 96c92bdb0d..53c0b68bcb 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
@@ -32,7 +32,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty
         {
         }
 
-        public override double Calculate(Dictionary<string, double> categoryDifficulty = null)
+        public override PerformanceAttributes Calculate()
         {
             mods = Score.Mods;
             accuracy = Score.Accuracy;
@@ -72,19 +72,15 @@ namespace osu.Game.Rulesets.Osu.Difficulty
                     Math.Pow(flashlightValue, 1.1), 1.0 / 1.1
                 ) * multiplier;
 
-            if (categoryDifficulty != null)
+            return new OsuPerformanceAttributes
             {
-                categoryDifficulty.Add("Aim", aimValue);
-                categoryDifficulty.Add("Speed", speedValue);
-                categoryDifficulty.Add("Accuracy", accuracyValue);
-                categoryDifficulty.Add("Flashlight", flashlightValue);
-                categoryDifficulty.Add("OD", Attributes.OverallDifficulty);
-                categoryDifficulty.Add("AR", Attributes.ApproachRate);
-                categoryDifficulty.Add("Max Combo", Attributes.MaxCombo);
-                categoryDifficulty.Add("Effective Miss Count", effectiveMissCount);
-            }
-
-            return totalValue;
+                Aim = aimValue,
+                Speed = speedValue,
+                Accuracy = accuracyValue,
+                Flashlight = flashlightValue,
+                EffectiveMissCount = effectiveMissCount,
+                Total = totalValue
+            };
         }
 
         private double computeAimValue()
diff --git a/osu.Game.Rulesets.Taiko/Difficulty/TaikoPerformanceAttributes.cs b/osu.Game.Rulesets.Taiko/Difficulty/TaikoPerformanceAttributes.cs
new file mode 100644
index 0000000000..80552880ea
--- /dev/null
+++ b/osu.Game.Rulesets.Taiko/Difficulty/TaikoPerformanceAttributes.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 Newtonsoft.Json;
+using osu.Game.Rulesets.Difficulty;
+
+namespace osu.Game.Rulesets.Taiko.Difficulty
+{
+    public class TaikoPerformanceAttributes : PerformanceAttributes
+    {
+        [JsonProperty("difficulty")]
+        public double Difficulty { get; set; }
+
+        [JsonProperty("accuracy")]
+        public double Accuracy { get; set; }
+    }
+}
diff --git a/osu.Game.Rulesets.Taiko/Difficulty/TaikoPerformanceCalculator.cs b/osu.Game.Rulesets.Taiko/Difficulty/TaikoPerformanceCalculator.cs
index d287998f3b..3df512e5db 100644
--- a/osu.Game.Rulesets.Taiko/Difficulty/TaikoPerformanceCalculator.cs
+++ b/osu.Game.Rulesets.Taiko/Difficulty/TaikoPerformanceCalculator.cs
@@ -27,7 +27,7 @@ namespace osu.Game.Rulesets.Taiko.Difficulty
         {
         }
 
-        public override double Calculate(Dictionary<string, double> categoryDifficulty = null)
+        public override PerformanceAttributes Calculate()
         {
             mods = Score.Mods;
             countGreat = Score.Statistics.GetValueOrDefault(HitResult.Great);
@@ -52,16 +52,12 @@ namespace osu.Game.Rulesets.Taiko.Difficulty
                     Math.Pow(accuracyValue, 1.1), 1.0 / 1.1
                 ) * multiplier;
 
-            if (categoryDifficulty != null)
+            return new TaikoPerformanceAttributes
             {
-                categoryDifficulty.Add("Difficulty", difficultyValue);
-                categoryDifficulty.Add("Accuracy", accuracyValue);
-                categoryDifficulty.Add("AR", Attributes.ApproachRate);
-                categoryDifficulty.Add("Great Hit Window", Attributes.GreatHitWindow);
-                categoryDifficulty.Add("Max Combo", Attributes.MaxCombo);
-            }
-
-            return totalValue;
+                Difficulty = difficultyValue,
+                Accuracy = accuracyValue,
+                Total = totalValue
+            };
         }
 
         private double computeDifficultyValue()
diff --git a/osu.Game/Rulesets/Difficulty/PerformanceAttributes.cs b/osu.Game/Rulesets/Difficulty/PerformanceAttributes.cs
new file mode 100644
index 0000000000..025b38257c
--- /dev/null
+++ b/osu.Game/Rulesets/Difficulty/PerformanceAttributes.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 Newtonsoft.Json;
+
+namespace osu.Game.Rulesets.Difficulty
+{
+    public class PerformanceAttributes
+    {
+        /// <summary>
+        /// Calculated score performance points.
+        /// </summary>
+        [JsonProperty("pp")]
+        public double Total { get; set; }
+    }
+}
diff --git a/osu.Game/Rulesets/Difficulty/PerformanceCalculator.cs b/osu.Game/Rulesets/Difficulty/PerformanceCalculator.cs
index 58427f6945..abfe8a6db1 100644
--- a/osu.Game/Rulesets/Difficulty/PerformanceCalculator.cs
+++ b/osu.Game/Rulesets/Difficulty/PerformanceCalculator.cs
@@ -37,6 +37,6 @@ namespace osu.Game.Rulesets.Difficulty
             TimeRate = track.Rate;
         }
 
-        public abstract double Calculate(Dictionary<string, double> categoryDifficulty = null);
+        public abstract PerformanceAttributes Calculate();
     }
 }
diff --git a/osu.Game/Scoring/ScorePerformanceCache.cs b/osu.Game/Scoring/ScorePerformanceCache.cs
index 79fb47f4b0..b855343505 100644
--- a/osu.Game/Scoring/ScorePerformanceCache.cs
+++ b/osu.Game/Scoring/ScorePerformanceCache.cs
@@ -44,7 +44,7 @@ namespace osu.Game.Scoring
 
             var calculator = score.Ruleset.CreateInstance().CreatePerformanceCalculator(attributes.Value.Attributes, score);
 
-            return calculator?.Calculate();
+            return calculator?.Calculate().Total;
         }
 
         public readonly struct PerformanceCacheLookup
diff --git a/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs b/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs
index 854f255269..908e6a27b8 100644
--- a/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs
+++ b/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs
@@ -129,7 +129,7 @@ namespace osu.Game.Screens.Play.HUD
 
             var calculator = gameplayState.Ruleset.CreatePerformanceCalculator(attrib, scoreInfo);
 
-            Current.Value = (int)Math.Round(calculator?.Calculate() ?? 0, MidpointRounding.AwayFromZero);
+            Current.Value = (int)Math.Round(calculator?.Calculate().Total ?? 0, MidpointRounding.AwayFromZero);
             IsValid = true;
         }
 

From ee89d8643e41626f37c6fd644ad03967a7e0ef94 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 21 Dec 2021 10:33:28 +0100
Subject: [PATCH 1773/5547] Extract abstract implementation of online lookup
 cache

---
 osu.Game/Database/BeatmapLookupCache.cs | 122 +-----------------
 osu.Game/Database/OnlineLookupCache.cs  | 162 ++++++++++++++++++++++++
 osu.Game/Database/UserLookupCache.cs    | 120 +-----------------
 3 files changed, 172 insertions(+), 232 deletions(-)
 create mode 100644 osu.Game/Database/OnlineLookupCache.cs

diff --git a/osu.Game/Database/BeatmapLookupCache.cs b/osu.Game/Database/BeatmapLookupCache.cs
index c6f8244494..06edc3e2da 100644
--- a/osu.Game/Database/BeatmapLookupCache.cs
+++ b/osu.Game/Database/BeatmapLookupCache.cs
@@ -6,20 +6,13 @@ using System.Linq;
 using System.Threading;
 using System.Threading.Tasks;
 using JetBrains.Annotations;
-using osu.Framework.Allocation;
-using osu.Game.Online.API;
 using osu.Game.Online.API.Requests;
 using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Database
 {
-    // This class is based on `UserLookupCache` which is well tested.
-    // If modifications are to be made here, a base abstract implementation should likely be created and shared between the two.
-    public class BeatmapLookupCache : MemoryCachingComponent<int, APIBeatmap>
+    public class BeatmapLookupCache : OnlineLookupCache<int, APIBeatmap, GetBeatmapsRequest>
     {
-        [Resolved]
-        private IAPIProvider api { get; set; }
-
         /// <summary>
         /// Perform an API lookup on the specified beatmap, populating a <see cref="APIBeatmap"/> model.
         /// </summary>
@@ -27,7 +20,7 @@ namespace osu.Game.Database
         /// <param name="token">An optional cancellation token.</param>
         /// <returns>The populated beatmap, or null if the beatmap does not exist or the request could not be satisfied.</returns>
         [ItemCanBeNull]
-        public Task<APIBeatmap> GetBeatmapAsync(int beatmapId, CancellationToken token = default) => GetAsync(beatmapId, token);
+        public Task<APIBeatmap> GetBeatmapAsync(int beatmapId, CancellationToken token = default) => LookupAsync(beatmapId, token);
 
         /// <summary>
         /// Perform an API lookup on the specified beatmaps, populating a <see cref="APIBeatmap"/> model.
@@ -35,115 +28,10 @@ namespace osu.Game.Database
         /// <param name="beatmapIds">The beatmaps to lookup.</param>
         /// <param name="token">An optional cancellation token.</param>
         /// <returns>The populated beatmaps. May include null results for failed retrievals.</returns>
-        public Task<APIBeatmap[]> GetBeatmapsAsync(int[] beatmapIds, CancellationToken token = default)
-        {
-            var beatmapLookupTasks = new List<Task<APIBeatmap>>();
+        public Task<APIBeatmap[]> GetBeatmapsAsync(int[] beatmapIds, CancellationToken token = default) => LookupAsync(beatmapIds, token);
 
-            foreach (int u in beatmapIds)
-            {
-                beatmapLookupTasks.Add(GetBeatmapAsync(u, token).ContinueWith(task =>
-                {
-                    if (!task.IsCompletedSuccessfully)
-                        return null;
+        protected override GetBeatmapsRequest CreateRequest(IEnumerable<int> ids) => new GetBeatmapsRequest(ids.ToArray());
 
-                    return task.Result;
-                }, token));
-            }
-
-            return Task.WhenAll(beatmapLookupTasks);
-        }
-
-        protected override async Task<APIBeatmap> ComputeValueAsync(int lookup, CancellationToken token = default)
-            => await queryBeatmap(lookup).ConfigureAwait(false);
-
-        private readonly Queue<(int id, TaskCompletionSource<APIBeatmap>)> pendingBeatmapTasks = new Queue<(int, TaskCompletionSource<APIBeatmap>)>();
-        private Task pendingRequestTask;
-        private readonly object taskAssignmentLock = new object();
-
-        private Task<APIBeatmap> queryBeatmap(int beatmapId)
-        {
-            lock (taskAssignmentLock)
-            {
-                var tcs = new TaskCompletionSource<APIBeatmap>();
-
-                // Add to the queue.
-                pendingBeatmapTasks.Enqueue((beatmapId, tcs));
-
-                // Create a request task if there's not already one.
-                if (pendingRequestTask == null)
-                    createNewTask();
-
-                return tcs.Task;
-            }
-        }
-
-        private void performLookup()
-        {
-            // contains at most 50 unique beatmap IDs from beatmapTasks, which is used to perform the lookup.
-            var beatmapTasks = new Dictionary<int, List<TaskCompletionSource<APIBeatmap>>>();
-
-            // Grab at most 50 unique beatmap IDs from the queue.
-            lock (taskAssignmentLock)
-            {
-                while (pendingBeatmapTasks.Count > 0 && beatmapTasks.Count < 50)
-                {
-                    (int id, TaskCompletionSource<APIBeatmap> task) next = pendingBeatmapTasks.Dequeue();
-
-                    // Perform a secondary check for existence, in case the beatmap was queried in a previous batch.
-                    if (CheckExists(next.id, out var existing))
-                        next.task.SetResult(existing);
-                    else
-                    {
-                        if (beatmapTasks.TryGetValue(next.id, out var tasks))
-                            tasks.Add(next.task);
-                        else
-                            beatmapTasks[next.id] = new List<TaskCompletionSource<APIBeatmap>> { next.task };
-                    }
-                }
-            }
-
-            if (beatmapTasks.Count == 0)
-                return;
-
-            // Query the beatmaps.
-            var request = new GetBeatmapsRequest(beatmapTasks.Keys.ToArray());
-
-            // rather than queueing, we maintain our own single-threaded request stream.
-            // todo: we probably want retry logic here.
-            api.Perform(request);
-
-            // Create a new request task if there's still more beatmaps to query.
-            lock (taskAssignmentLock)
-            {
-                pendingRequestTask = null;
-                if (pendingBeatmapTasks.Count > 0)
-                    createNewTask();
-            }
-
-            List<APIBeatmap> foundBeatmaps = request.Response?.Beatmaps;
-
-            if (foundBeatmaps != null)
-            {
-                foreach (var beatmap in foundBeatmaps)
-                {
-                    if (beatmapTasks.TryGetValue(beatmap.OnlineID, out var tasks))
-                    {
-                        foreach (var task in tasks)
-                            task.SetResult(beatmap);
-
-                        beatmapTasks.Remove(beatmap.OnlineID);
-                    }
-                }
-            }
-
-            // if any tasks remain which were not satisfied, return null.
-            foreach (var tasks in beatmapTasks.Values)
-            {
-                foreach (var task in tasks)
-                    task.SetResult(null);
-            }
-        }
-
-        private void createNewTask() => pendingRequestTask = Task.Run(performLookup);
+        protected override IEnumerable<APIBeatmap> RetrieveResults(GetBeatmapsRequest request) => request.Response?.Beatmaps;
     }
 }
diff --git a/osu.Game/Database/OnlineLookupCache.cs b/osu.Game/Database/OnlineLookupCache.cs
new file mode 100644
index 0000000000..8a50cc486f
--- /dev/null
+++ b/osu.Game/Database/OnlineLookupCache.cs
@@ -0,0 +1,162 @@
+// 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 System.Threading.Tasks;
+using JetBrains.Annotations;
+using osu.Framework.Allocation;
+using osu.Game.Online.API;
+
+namespace osu.Game.Database
+{
+    public abstract class OnlineLookupCache<TLookup, TValue, TRequest> : MemoryCachingComponent<TLookup, TValue>
+        where TLookup : IEquatable<TLookup>
+        where TValue : class, IHasOnlineID<TLookup>
+        where TRequest : APIRequest
+    {
+        [Resolved]
+        private IAPIProvider api { get; set; }
+
+        /// <summary>
+        /// Creates an <see cref="APIRequest"/> to retrieve the values for a given collection of <typeparamref name="TLookup"/>s.
+        /// </summary>
+        /// <param name="ids">The IDs to perform the lookup with.</param>
+        protected abstract TRequest CreateRequest(IEnumerable<TLookup> ids);
+
+        /// <summary>
+        /// Retrieves a list of <typeparamref name="TValue"/>s from a successful <typeparamref name="TRequest"/> created by <see cref="CreateRequest"/>.
+        /// </summary>
+        [CanBeNull]
+        protected abstract IEnumerable<TValue> RetrieveResults(TRequest request);
+
+        /// <summary>
+        /// Perform a lookup using the specified <paramref name="id"/>, populating a <typeparamref name="TValue"/>.
+        /// </summary>
+        /// <param name="id">The ID to lookup.</param>
+        /// <param name="token">An optional cancellation token.</param>
+        /// <returns>The populated <typeparamref name="TValue"/>, or null if the value does not exist or the request could not be satisfied.</returns>
+        [ItemCanBeNull]
+        protected Task<TValue> LookupAsync(TLookup id, CancellationToken token = default) => GetAsync(id, token);
+
+        /// <summary>
+        /// Perform an API lookup on the specified <paramref name="ids"/>, populating a <typeparamref name="TValue"/>.
+        /// </summary>
+        /// <param name="ids">The IDs to lookup.</param>
+        /// <param name="token">An optional cancellation token.</param>
+        /// <returns>The populated values. May include null results for failed retrievals.</returns>
+        protected Task<TValue[]> LookupAsync(TLookup[] ids, CancellationToken token = default)
+        {
+            var lookupTasks = new List<Task<TValue>>();
+
+            foreach (var id in ids)
+            {
+                lookupTasks.Add(LookupAsync(id, token).ContinueWith(task =>
+                {
+                    if (!task.IsCompletedSuccessfully)
+                        return null;
+
+                    return task.Result;
+                }, token));
+            }
+
+            return Task.WhenAll(lookupTasks);
+        }
+
+        // cannot be sealed due to test usages (see TestUserLookupCache).
+        protected override async Task<TValue> ComputeValueAsync(TLookup lookup, CancellationToken token = default)
+            => await queryValue(lookup).ConfigureAwait(false);
+
+        private readonly Queue<(TLookup id, TaskCompletionSource<TValue>)> pendingTasks = new Queue<(TLookup, TaskCompletionSource<TValue>)>();
+        private Task pendingRequestTask;
+        private readonly object taskAssignmentLock = new object();
+
+        private Task<TValue> queryValue(TLookup id)
+        {
+            lock (taskAssignmentLock)
+            {
+                var tcs = new TaskCompletionSource<TValue>();
+
+                // Add to the queue.
+                pendingTasks.Enqueue((id, tcs));
+
+                // Create a request task if there's not already one.
+                if (pendingRequestTask == null)
+                    createNewTask();
+
+                return tcs.Task;
+            }
+        }
+
+        private void performLookup()
+        {
+            // contains at most 50 unique IDs from tasks, which is used to perform the lookup.
+            var nextTaskBatch = new Dictionary<TLookup, List<TaskCompletionSource<TValue>>>();
+
+            // Grab at most 50 unique IDs from the queue.
+            lock (taskAssignmentLock)
+            {
+                while (pendingTasks.Count > 0 && nextTaskBatch.Count < 50)
+                {
+                    (TLookup id, TaskCompletionSource<TValue> task) next = pendingTasks.Dequeue();
+
+                    // Perform a secondary check for existence, in case the value was queried in a previous batch.
+                    if (CheckExists(next.id, out var existing))
+                        next.task.SetResult(existing);
+                    else
+                    {
+                        if (nextTaskBatch.TryGetValue(next.id, out var tasks))
+                            tasks.Add(next.task);
+                        else
+                            nextTaskBatch[next.id] = new List<TaskCompletionSource<TValue>> { next.task };
+                    }
+                }
+            }
+
+            if (nextTaskBatch.Count == 0)
+                return;
+
+            // Query the values.
+            var request = CreateRequest(nextTaskBatch.Keys.ToArray());
+
+            // rather than queueing, we maintain our own single-threaded request stream.
+            // todo: we probably want retry logic here.
+            api.Perform(request);
+
+            // Create a new request task if there's still more values to query.
+            lock (taskAssignmentLock)
+            {
+                pendingRequestTask = null;
+                if (pendingTasks.Count > 0)
+                    createNewTask();
+            }
+
+            var foundValues = RetrieveResults(request);
+
+            if (foundValues != null)
+            {
+                foreach (var value in foundValues)
+                {
+                    if (nextTaskBatch.TryGetValue(value.OnlineID, out var tasks))
+                    {
+                        foreach (var task in tasks)
+                            task.SetResult(value);
+
+                        nextTaskBatch.Remove(value.OnlineID);
+                    }
+                }
+            }
+
+            // if any tasks remain which were not satisfied, return null.
+            foreach (var tasks in nextTaskBatch.Values)
+            {
+                foreach (var task in tasks)
+                    task.SetResult(null);
+            }
+        }
+
+        private void createNewTask() => pendingRequestTask = Task.Run(performLookup);
+    }
+}
diff --git a/osu.Game/Database/UserLookupCache.cs b/osu.Game/Database/UserLookupCache.cs
index 26f4e9fb3b..5fdd80892d 100644
--- a/osu.Game/Database/UserLookupCache.cs
+++ b/osu.Game/Database/UserLookupCache.cs
@@ -6,18 +6,13 @@ using System.Linq;
 using System.Threading;
 using System.Threading.Tasks;
 using JetBrains.Annotations;
-using osu.Framework.Allocation;
-using osu.Game.Online.API;
 using osu.Game.Online.API.Requests;
 using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Database
 {
-    public class UserLookupCache : MemoryCachingComponent<int, APIUser>
+    public class UserLookupCache : OnlineLookupCache<int, APIUser, GetUsersRequest>
     {
-        [Resolved]
-        private IAPIProvider api { get; set; }
-
         /// <summary>
         /// Perform an API lookup on the specified user, populating a <see cref="APIUser"/> model.
         /// </summary>
@@ -25,7 +20,7 @@ namespace osu.Game.Database
         /// <param name="token">An optional cancellation token.</param>
         /// <returns>The populated user, or null if the user does not exist or the request could not be satisfied.</returns>
         [ItemCanBeNull]
-        public Task<APIUser> GetUserAsync(int userId, CancellationToken token = default) => GetAsync(userId, token);
+        public Task<APIUser> GetUserAsync(int userId, CancellationToken token = default) => LookupAsync(userId, token);
 
         /// <summary>
         /// Perform an API lookup on the specified users, populating a <see cref="APIUser"/> model.
@@ -33,115 +28,10 @@ namespace osu.Game.Database
         /// <param name="userIds">The users to lookup.</param>
         /// <param name="token">An optional cancellation token.</param>
         /// <returns>The populated users. May include null results for failed retrievals.</returns>
-        public Task<APIUser[]> GetUsersAsync(int[] userIds, CancellationToken token = default)
-        {
-            var userLookupTasks = new List<Task<APIUser>>();
+        public Task<APIUser[]> GetUsersAsync(int[] userIds, CancellationToken token = default) => LookupAsync(userIds, token);
 
-            foreach (int u in userIds)
-            {
-                userLookupTasks.Add(GetUserAsync(u, token).ContinueWith(task =>
-                {
-                    if (!task.IsCompletedSuccessfully)
-                        return null;
+        protected override GetUsersRequest CreateRequest(IEnumerable<int> ids) => new GetUsersRequest(ids.ToArray());
 
-                    return task.Result;
-                }, token));
-            }
-
-            return Task.WhenAll(userLookupTasks);
-        }
-
-        protected override async Task<APIUser> ComputeValueAsync(int lookup, CancellationToken token = default)
-            => await queryUser(lookup).ConfigureAwait(false);
-
-        private readonly Queue<(int id, TaskCompletionSource<APIUser>)> pendingUserTasks = new Queue<(int, TaskCompletionSource<APIUser>)>();
-        private Task pendingRequestTask;
-        private readonly object taskAssignmentLock = new object();
-
-        private Task<APIUser> queryUser(int userId)
-        {
-            lock (taskAssignmentLock)
-            {
-                var tcs = new TaskCompletionSource<APIUser>();
-
-                // Add to the queue.
-                pendingUserTasks.Enqueue((userId, tcs));
-
-                // Create a request task if there's not already one.
-                if (pendingRequestTask == null)
-                    createNewTask();
-
-                return tcs.Task;
-            }
-        }
-
-        private void performLookup()
-        {
-            // contains at most 50 unique user IDs from userTasks, which is used to perform the lookup.
-            var userTasks = new Dictionary<int, List<TaskCompletionSource<APIUser>>>();
-
-            // Grab at most 50 unique user IDs from the queue.
-            lock (taskAssignmentLock)
-            {
-                while (pendingUserTasks.Count > 0 && userTasks.Count < 50)
-                {
-                    (int id, TaskCompletionSource<APIUser> task) next = pendingUserTasks.Dequeue();
-
-                    // Perform a secondary check for existence, in case the user was queried in a previous batch.
-                    if (CheckExists(next.id, out var existing))
-                        next.task.SetResult(existing);
-                    else
-                    {
-                        if (userTasks.TryGetValue(next.id, out var tasks))
-                            tasks.Add(next.task);
-                        else
-                            userTasks[next.id] = new List<TaskCompletionSource<APIUser>> { next.task };
-                    }
-                }
-            }
-
-            if (userTasks.Count == 0)
-                return;
-
-            // Query the users.
-            var request = new GetUsersRequest(userTasks.Keys.ToArray());
-
-            // rather than queueing, we maintain our own single-threaded request stream.
-            // todo: we probably want retry logic here.
-            api.Perform(request);
-
-            // Create a new request task if there's still more users to query.
-            lock (taskAssignmentLock)
-            {
-                pendingRequestTask = null;
-                if (pendingUserTasks.Count > 0)
-                    createNewTask();
-            }
-
-            List<APIUser> foundUsers = request.Response?.Users;
-
-            if (foundUsers != null)
-            {
-                foreach (var user in foundUsers)
-                {
-                    if (userTasks.TryGetValue(user.Id, out var tasks))
-                    {
-                        foreach (var task in tasks)
-                            task.SetResult(user);
-
-                        userTasks.Remove(user.Id);
-                    }
-                }
-            }
-
-            // if any tasks remain which were not satisfied, return null.
-            foreach (var tasks in userTasks.Values)
-            {
-                foreach (var task in tasks)
-                    task.SetResult(null);
-            }
-        }
-
-        private void createNewTask() => pendingRequestTask = Task.Run(performLookup);
+        protected override IEnumerable<APIUser> RetrieveResults(GetUsersRequest request) => request.Response?.Users;
     }
 }

From ca7303a50a1111fe17c75af6d52ee940ac865039 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 21 Dec 2021 10:55:43 +0100
Subject: [PATCH 1774/5547] Fix online lookup cache not clearing completed task
 on early return

The task not being cleared in the early return path would cause
`pendingRequestTask` to become stuck as a completed task, and
`queryValue()` would not recreate it due to the null check there,
therefore stalling all lookups forevermore until a game restart.
---
 osu.Game/Database/OnlineLookupCache.cs | 22 +++++++++++++++-------
 1 file changed, 15 insertions(+), 7 deletions(-)

diff --git a/osu.Game/Database/OnlineLookupCache.cs b/osu.Game/Database/OnlineLookupCache.cs
index 8a50cc486f..5eb9fa24fa 100644
--- a/osu.Game/Database/OnlineLookupCache.cs
+++ b/osu.Game/Database/OnlineLookupCache.cs
@@ -116,7 +116,10 @@ namespace osu.Game.Database
             }
 
             if (nextTaskBatch.Count == 0)
+            {
+                finishPendingTask();
                 return;
+            }
 
             // Query the values.
             var request = CreateRequest(nextTaskBatch.Keys.ToArray());
@@ -125,13 +128,7 @@ namespace osu.Game.Database
             // todo: we probably want retry logic here.
             api.Perform(request);
 
-            // Create a new request task if there's still more values to query.
-            lock (taskAssignmentLock)
-            {
-                pendingRequestTask = null;
-                if (pendingTasks.Count > 0)
-                    createNewTask();
-            }
+            finishPendingTask();
 
             var foundValues = RetrieveResults(request);
 
@@ -157,6 +154,17 @@ namespace osu.Game.Database
             }
         }
 
+        private void finishPendingTask()
+        {
+            // Create a new request task if there's still more values to query.
+            lock (taskAssignmentLock)
+            {
+                pendingRequestTask = null;
+                if (pendingTasks.Count > 0)
+                    createNewTask();
+            }
+        }
+
         private void createNewTask() => pendingRequestTask = Task.Run(performLookup);
     }
 }

From 88436d51ae7060a2e680948f414cb146ec39de3c Mon Sep 17 00:00:00 2001
From: StanR <hi@stanr.info>
Date: Tue, 21 Dec 2021 13:44:20 +0300
Subject: [PATCH 1775/5547] Remove using

---
 osu.Game/Rulesets/Difficulty/PerformanceCalculator.cs | 1 -
 1 file changed, 1 deletion(-)

diff --git a/osu.Game/Rulesets/Difficulty/PerformanceCalculator.cs b/osu.Game/Rulesets/Difficulty/PerformanceCalculator.cs
index abfe8a6db1..6358ec18b7 100644
--- a/osu.Game/Rulesets/Difficulty/PerformanceCalculator.cs
+++ b/osu.Game/Rulesets/Difficulty/PerformanceCalculator.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 osu.Framework.Audio.Track;
 using osu.Framework.Extensions.IEnumerableExtensions;

From 40b3ce0ade379ce8b16cf05fd553923ae1d1209e Mon Sep 17 00:00:00 2001
From: StanR <hi@stanr.info>
Date: Tue, 21 Dec 2021 14:03:24 +0300
Subject: [PATCH 1776/5547] Clean up comments

---
 .../Difficulty/CatchPerformanceCalculator.cs  |  7 -------
 .../Difficulty/ManiaPerformanceCalculator.cs  |  5 -----
 .../Difficulty/OsuPerformanceCalculator.cs    | 20 +++++--------------
 .../Difficulty/TaikoPerformanceCalculator.cs  |  9 +--------
 4 files changed, 6 insertions(+), 35 deletions(-)

diff --git a/osu.Game.Rulesets.Catch/Difficulty/CatchPerformanceCalculator.cs b/osu.Game.Rulesets.Catch/Difficulty/CatchPerformanceCalculator.cs
index e224675977..8cdbe500f0 100644
--- a/osu.Game.Rulesets.Catch/Difficulty/CatchPerformanceCalculator.cs
+++ b/osu.Game.Rulesets.Catch/Difficulty/CatchPerformanceCalculator.cs
@@ -44,15 +44,11 @@ namespace osu.Game.Rulesets.Catch.Difficulty
             // Longer maps are worth more. "Longer" means how many hits there are which can contribute to combo
             int numTotalHits = totalComboHits();
 
-            // Longer maps are worth more
             double lengthBonus =
                 0.95 + 0.3 * Math.Min(1.0, numTotalHits / 2500.0) +
                 (numTotalHits > 2500 ? Math.Log10(numTotalHits / 2500.0) * 0.475 : 0.0);
-
-            // Longer maps are worth more
             value *= lengthBonus;
 
-            // Penalize misses exponentially. This mainly fixes tag4 maps and the likes until a per-hitobject solution is available
             value *= Math.Pow(0.97, misses);
 
             // Combo scaling
@@ -80,13 +76,10 @@ namespace osu.Game.Rulesets.Catch.Difficulty
             }
 
             if (mods.Any(m => m is ModFlashlight))
-                // Apply length bonus again if flashlight is on simply because it becomes a lot harder on longer maps.
                 value *= 1.35 * lengthBonus;
 
-            // Scale the aim value with accuracy _slightly_
             value *= Math.Pow(accuracy(), 5.5);
 
-            // Custom multipliers for NoFail. SpunOut is not applicable.
             if (mods.Any(m => m is ModNoFail))
                 value *= 0.90;
 
diff --git a/osu.Game.Rulesets.Mania/Difficulty/ManiaPerformanceCalculator.cs b/osu.Game.Rulesets.Mania/Difficulty/ManiaPerformanceCalculator.cs
index cb4c3fffa4..8a8c41bb8a 100644
--- a/osu.Game.Rulesets.Mania/Difficulty/ManiaPerformanceCalculator.cs
+++ b/osu.Game.Rulesets.Mania/Difficulty/ManiaPerformanceCalculator.cs
@@ -80,10 +80,8 @@ namespace osu.Game.Rulesets.Mania.Difficulty
 
         private double computeDifficultyValue()
         {
-            // Obtain difficulty
             double difficultyValue = Math.Pow(5 * Math.Max(1, Attributes.StarRating / 0.2) - 4.0, 2.2) / 135.0;
 
-            // Longer maps are worth more
             difficultyValue *= 1.0 + 0.1 * Math.Min(1.0, totalHits / 1500.0);
 
             if (scaledScore <= 500000)
@@ -113,9 +111,6 @@ namespace osu.Game.Rulesets.Mania.Difficulty
                                    * difficultyValue
                                    * Math.Pow(Math.Max(0.0, scaledScore - 960000) / 40000, 1.1);
 
-            // Bonus for many hitcircles - it's harder to keep good accuracy up for longer
-            // accuracyValue *= Math.Min(1.15, Math.Pow(totalHits / 1500.0, 0.3));
-
             return accuracyValue;
         }
 
diff --git a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
index 53c0b68bcb..067dc2f217 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
@@ -45,7 +45,6 @@ namespace osu.Game.Rulesets.Osu.Difficulty
 
             double multiplier = 1.12; // This is being adjusted to keep the final pp value scaled around what it used to be when changing things.
 
-            // Custom multipliers for NoFail and SpunOut.
             if (mods.Any(m => m is OsuModNoFail))
                 multiplier *= Math.Max(0.90, 1.0 - 0.02 * effectiveMissCount);
 
@@ -92,19 +91,15 @@ namespace osu.Game.Rulesets.Osu.Difficulty
 
             double aimValue = Math.Pow(5.0 * Math.Max(1.0, rawAim / 0.0675) - 4.0, 3.0) / 100000.0;
 
-            // Longer maps are worth more.
             double lengthBonus = 0.95 + 0.4 * Math.Min(1.0, totalHits / 2000.0) +
                                  (totalHits > 2000 ? Math.Log10(totalHits / 2000.0) * 0.5 : 0.0);
-
             aimValue *= lengthBonus;
 
             // Penalize misses by assessing # of misses relative to the total # of objects. Default a 3% reduction for any # of misses.
             if (effectiveMissCount > 0)
                 aimValue *= 0.97 * Math.Pow(1 - Math.Pow((double)effectiveMissCount / totalHits, 0.775), effectiveMissCount);
 
-            // Combo scaling.
-            if (Attributes.MaxCombo > 0)
-                aimValue *= Math.Min(Math.Pow(scoreMaxCombo, 0.8) / Math.Pow(Attributes.MaxCombo, 0.8), 1.0);
+            aimValue *= comboScaling();
 
             double approachRateFactor = 0.0;
             if (Attributes.ApproachRate > 10.33)
@@ -133,7 +128,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty
             }
 
             aimValue *= accuracy;
-            // It is important to also consider accuracy difficulty when doing that.
+            // It is important to consider accuracy difficulty when scaling with accuracy.
             aimValue *= 0.98 + Math.Pow(Attributes.OverallDifficulty, 2) / 2500;
 
             return aimValue;
@@ -143,7 +138,6 @@ namespace osu.Game.Rulesets.Osu.Difficulty
         {
             double speedValue = Math.Pow(5.0 * Math.Max(1.0, Attributes.SpeedDifficulty / 0.0675) - 4.0, 3.0) / 100000.0;
 
-            // Longer maps are worth more.
             double lengthBonus = 0.95 + 0.4 * Math.Min(1.0, totalHits / 2000.0) +
                                  (totalHits > 2000 ? Math.Log10(totalHits / 2000.0) * 0.5 : 0.0);
             speedValue *= lengthBonus;
@@ -152,9 +146,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty
             if (effectiveMissCount > 0)
                 speedValue *= 0.97 * Math.Pow(1 - Math.Pow((double)effectiveMissCount / totalHits, 0.775), Math.Pow(effectiveMissCount, .875));
 
-            // Combo scaling.
-            if (Attributes.MaxCombo > 0)
-                speedValue *= Math.Min(Math.Pow(scoreMaxCombo, 0.8) / Math.Pow(Attributes.MaxCombo, 0.8), 1.0);
+            speedValue *= comboScaling();
 
             double approachRateFactor = 0.0;
             if (Attributes.ApproachRate > 10.33)
@@ -231,7 +223,6 @@ namespace osu.Game.Rulesets.Osu.Difficulty
 
             double flashlightValue = Math.Pow(rawFlashlight, 2.0) * 25.0;
 
-            // Add an additional bonus for HDFL.
             if (mods.Any(h => h is OsuModHidden))
                 flashlightValue *= 1.3;
 
@@ -239,9 +230,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty
             if (effectiveMissCount > 0)
                 flashlightValue *= 0.97 * Math.Pow(1 - Math.Pow((double)effectiveMissCount / totalHits, 0.775), Math.Pow(effectiveMissCount, .875));
 
-            // Combo scaling.
-            if (Attributes.MaxCombo > 0)
-                flashlightValue *= Math.Min(Math.Pow(scoreMaxCombo, 0.8) / Math.Pow(Attributes.MaxCombo, 0.8), 1.0);
+            flashlightValue *= comboScaling();
 
             // Account for shorter maps having a higher ratio of 0 combo/100 combo flashlight radius.
             flashlightValue *= 0.7 + 0.1 * Math.Min(1.0, totalHits / 200.0) +
@@ -273,6 +262,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty
             return Math.Max(countMiss, (int)Math.Floor(comboBasedMissCount));
         }
 
+        private double comboScaling() => Attributes.MaxCombo <= 0 ? 1.0 : Math.Min(Math.Pow(scoreMaxCombo, 0.8) / Math.Pow(Attributes.MaxCombo, 0.8), 1.0);
         private int totalHits => countGreat + countOk + countMeh + countMiss;
         private int totalSuccessfulHits => countGreat + countOk + countMeh;
     }
diff --git a/osu.Game.Rulesets.Taiko/Difficulty/TaikoPerformanceCalculator.cs b/osu.Game.Rulesets.Taiko/Difficulty/TaikoPerformanceCalculator.cs
index 3df512e5db..bcd55f8fae 100644
--- a/osu.Game.Rulesets.Taiko/Difficulty/TaikoPerformanceCalculator.cs
+++ b/osu.Game.Rulesets.Taiko/Difficulty/TaikoPerformanceCalculator.cs
@@ -35,7 +35,6 @@ namespace osu.Game.Rulesets.Taiko.Difficulty
             countMeh = Score.Statistics.GetValueOrDefault(HitResult.Meh);
             countMiss = Score.Statistics.GetValueOrDefault(HitResult.Miss);
 
-            // Custom multipliers for NoFail and SpunOut.
             double multiplier = 1.1; // This is being adjusted to keep the final pp value scaled around what it used to be when changing things
 
             if (mods.Any(m => m is ModNoFail))
@@ -64,21 +63,17 @@ namespace osu.Game.Rulesets.Taiko.Difficulty
         {
             double difficultyValue = Math.Pow(5.0 * Math.Max(1.0, Attributes.StarRating / 0.0075) - 4.0, 2.0) / 100000.0;
 
-            // Longer maps are worth more
             double lengthBonus = 1 + 0.1 * Math.Min(1.0, totalHits / 1500.0);
             difficultyValue *= lengthBonus;
 
-            // Penalize misses exponentially. This mainly fixes tag4 maps and the likes until a per-hitobject solution is available
             difficultyValue *= Math.Pow(0.985, countMiss);
 
             if (mods.Any(m => m is ModHidden))
                 difficultyValue *= 1.025;
 
             if (mods.Any(m => m is ModFlashlight<TaikoHitObject>))
-                // Apply length bonus again if flashlight is on simply because it becomes a lot harder on longer maps.
                 difficultyValue *= 1.05 * lengthBonus;
 
-            // Scale the speed value with accuracy _slightly_
             return difficultyValue * Score.Accuracy;
         }
 
@@ -87,11 +82,9 @@ namespace osu.Game.Rulesets.Taiko.Difficulty
             if (Attributes.GreatHitWindow <= 0)
                 return 0;
 
-            // Lots of arbitrary values from testing.
-            // Considering to use derivation from perfect accuracy in a probabilistic manner - assume normal distribution
             double accValue = Math.Pow(150.0 / Attributes.GreatHitWindow, 1.1) * Math.Pow(Score.Accuracy, 15) * 22.0;
 
-            // Bonus for many hitcircles - it's harder to keep good accuracy up for longer
+            // Bonus for many objects - it's harder to keep good accuracy up for longer
             return accValue * Math.Min(1.15, Math.Pow(totalHits / 1500.0, 0.3));
         }
 

From adfadc13f7af4ca14d0b252ed05000d39c7330e0 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 21 Dec 2021 12:34:55 +0100
Subject: [PATCH 1777/5547] Add test case for dragging selection including
 slider head

---
 .../TestSceneSliderControlPointPiece.cs       | 43 +++++++++++++++++++
 1 file changed, 43 insertions(+)

diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderControlPointPiece.cs b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderControlPointPiece.cs
index 7ae66b7ba7..a0bdcb144f 100644
--- a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderControlPointPiece.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderControlPointPiece.cs
@@ -137,6 +137,49 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
             AddStep("release control", () => InputManager.ReleaseKey(Key.LControl));
         }
 
+        [Test]
+        public void TestDragMultipleControlPointsIncludingHead()
+        {
+            moveMouseToControlPoint(0);
+            AddStep("click left mouse", () => InputManager.Click(MouseButton.Left));
+
+            AddStep("hold control", () => InputManager.PressKey(Key.LControl));
+
+            moveMouseToControlPoint(3);
+            AddStep("click left mouse", () => InputManager.Click(MouseButton.Left));
+
+            moveMouseToControlPoint(4);
+            AddStep("click left mouse", () => InputManager.Click(MouseButton.Left));
+
+            moveMouseToControlPoint(3);
+            AddStep("hold left mouse", () => InputManager.PressButton(MouseButton.Left));
+
+            AddAssert("three control point pieces selected", () => this.ChildrenOfType<PathControlPointPiece>().Count(piece => piece.IsSelected.Value) == 3);
+
+            addMovementStep(new Vector2(550, 50));
+            AddStep("release left mouse", () => InputManager.ReleaseButton(MouseButton.Left));
+
+            AddAssert("three control point pieces selected", () => this.ChildrenOfType<PathControlPointPiece>().Count(piece => piece.IsSelected.Value) == 3);
+
+            // note: if the head is part of the selection being moved, the entire slider is moved.
+            // the unselected nodes will therefore change position relative to the slider head.
+
+            AddAssert("slider moved", () => Precision.AlmostEquals(slider.Position, new Vector2(256, 192) + new Vector2(150, 50)));
+
+            assertControlPointPosition(0, Vector2.Zero);
+            assertControlPointType(0, PathType.PerfectCurve);
+
+            assertControlPointPosition(1, new Vector2(0, 100));
+
+            assertControlPointPosition(2, new Vector2(150, -50));
+
+            assertControlPointPosition(3, new Vector2(400, 0));
+
+            assertControlPointPosition(4, new Vector2(400, 150));
+
+            AddStep("release control", () => InputManager.ReleaseKey(Key.LControl));
+        }
+
         [Test]
         public void TestDragControlPointAlmostLinearlyExterior()
         {

From e715bff535a3d2431db3a39adff28d33b6793f2f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 21 Dec 2021 12:35:48 +0100
Subject: [PATCH 1778/5547] Fix selections including head not correctly
 dragging if not started from head

---
 .../Components/PathControlPointPiece.cs       |  4 ++--
 .../Components/PathControlPointVisualiser.cs  | 22 ++++++++++++-------
 2 files changed, 16 insertions(+), 10 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 7b9b6cb976..3db3e85c11 100644
--- a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointPiece.cs
+++ b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointPiece.cs
@@ -32,7 +32,7 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders.Components
     {
         public Action<PathControlPointPiece, MouseButtonEvent> RequestSelection;
 
-        public Action DragStarted;
+        public Action<PathControlPoint> DragStarted;
         public Action<DragEvent> DragInProgress;
         public Action DragEnded;
 
@@ -188,7 +188,7 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders.Components
 
             if (e.Button == MouseButton.Left)
             {
-                DragStarted?.Invoke();
+                DragStarted?.Invoke(ControlPoint);
                 keepSelection = true;
                 return true;
             }
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 97775d8122..e06fc1510c 100644
--- a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointVisualiser.cs
+++ b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointVisualiser.cs
@@ -4,6 +4,7 @@
 using System;
 using System.Collections.Generic;
 using System.Collections.Specialized;
+using System.Diagnostics;
 using System.Linq;
 using Humanizer;
 using osu.Framework.Allocation;
@@ -215,13 +216,17 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders.Components
 
         private Vector2[] dragStartPositions;
         private PathType?[] dragPathTypes;
-        private HashSet<PathControlPoint> draggedControlPoints;
+        private int draggedControlPointIndex;
+        private HashSet<PathControlPoint> selectedControlPoints;
 
-        private void dragStarted()
+        private void dragStarted(PathControlPoint controlPoint)
         {
             dragStartPositions = slider.Path.ControlPoints.Select(point => point.Position).ToArray();
             dragPathTypes = slider.Path.ControlPoints.Select(point => point.Type).ToArray();
-            draggedControlPoints = new HashSet<PathControlPoint>(Pieces.Where(piece => piece.IsSelected.Value).Select(piece => piece.ControlPoint));
+            draggedControlPointIndex = slider.Path.ControlPoints.IndexOf(controlPoint);
+            selectedControlPoints = new HashSet<PathControlPoint>(Pieces.Where(piece => piece.IsSelected.Value).Select(piece => piece.ControlPoint));
+
+            Debug.Assert(draggedControlPointIndex >= 0);
 
             changeHandler?.BeginChange();
         }
@@ -232,12 +237,13 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders.Components
             var oldPosition = slider.Position;
             double oldStartTime = slider.StartTime;
 
-            if (draggedControlPoints.Contains(slider.Path.ControlPoints[0]))
+            if (selectedControlPoints.Contains(slider.Path.ControlPoints[0]))
             {
                 // Special handling for selections containing head control point - the position of the slider changes which means the snapped position and time have to be taken into account
-                var result = snapProvider?.SnapScreenSpacePositionToValidTime(e.ScreenSpaceMousePosition);
+                Vector2 newHeadPosition = Parent.ToScreenSpace(e.MousePosition + (dragStartPositions[0] - dragStartPositions[draggedControlPointIndex]));
+                var result = snapProvider?.SnapScreenSpacePositionToValidTime(newHeadPosition);
 
-                Vector2 movementDelta = Parent.ToLocalSpace(result?.ScreenSpacePosition ?? e.ScreenSpaceMousePosition) - slider.Position;
+                Vector2 movementDelta = Parent.ToLocalSpace(result?.ScreenSpacePosition ?? newHeadPosition) - slider.Position;
 
                 slider.Position += movementDelta;
                 slider.StartTime = result?.Time ?? slider.StartTime;
@@ -249,7 +255,7 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders.Components
                     // need to be offset _back_ by the delta corresponding to the movement of the head point.
                     // All other selected control points (if any) will move together with the head point
                     // (and so they will not move at all, relative to each other).
-                    if (!draggedControlPoints.Contains(controlPoint))
+                    if (!selectedControlPoints.Contains(controlPoint))
                         controlPoint.Position -= movementDelta;
                 }
             }
@@ -258,7 +264,7 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders.Components
                 for (int i = 0; i < controlPoints.Count; ++i)
                 {
                     var controlPoint = controlPoints[i];
-                    if (draggedControlPoints.Contains(controlPoint))
+                    if (selectedControlPoints.Contains(controlPoint))
                         controlPoint.Position = dragStartPositions[i] + (e.MousePosition - e.MouseDownPosition);
                 }
             }

From 7ab1c0c99d385bcedefa7feabaa53a3d984badb6 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 21 Dec 2021 12:54:17 +0100
Subject: [PATCH 1779/5547] Improve contrast of timeline blueprint foreground
 content for pastel combo colours

---
 .../Compose/Components/Timeline/TimelineHitObjectBlueprint.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineHitObjectBlueprint.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineHitObjectBlueprint.cs
index 1839b0507d..6426d33e99 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineHitObjectBlueprint.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineHitObjectBlueprint.cs
@@ -177,8 +177,8 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
             else
                 circle.Colour = colour;
 
-            var col = circle.Colour.TopLeft.Linear;
-            colouredComponents.Colour = OsuColour.ForegroundTextColourFor(col);
+            var averageColour = Interpolation.ValueAt(0.5, circle.Colour.TopLeft, circle.Colour.TopRight, 0, 1);
+            colouredComponents.Colour = OsuColour.ForegroundTextColourFor(averageColour);
         }
 
         private SamplePointPiece sampleOverrideDisplay;

From ee64ab638382c30dd42f16cd54e23d1bd4a2ec28 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 22 Dec 2021 09:55:16 +0900
Subject: [PATCH 1780/5547] Fix delete button test failures

Can be tested by adding a Thread.Sleep() in
DrawableRoomPlaylistItem.load().
---
 .../Visual/Multiplayer/TestSceneMultiplayerQueueList.cs   | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs
index 33741e3aa2..1a646d5e7e 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs
@@ -110,6 +110,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             AddStep("finish current item", () => Client.FinishCurrentItem());
             AddUntilStep("wait for next item to be selected", () => Client.Room?.Settings.PlaylistItemId == 2);
+            AddUntilStep("wait for two items in playlist", () => playlist.ChildrenOfType<DrawableRoomPlaylistItem>().Count() == 2);
 
             assertDeleteButtonVisibility(0, false);
             assertDeleteButtonVisibility(1, false);
@@ -136,7 +137,10 @@ namespace osu.Game.Tests.Visual.Multiplayer
         }
 
         private void assertDeleteButtonVisibility(int index, bool visible)
-            => AddUntilStep($"delete button {index} {(visible ? "is" : "is not")} visible",
-                () => (playlist.ChildrenOfType<DrawableRoomPlaylistItem.PlaylistRemoveButton>().ElementAt(index).Alpha > 0) == visible);
+            => AddUntilStep($"delete button {index} {(visible ? "is" : "is not")} visible", () =>
+            {
+                var button = playlist.ChildrenOfType<DrawableRoomPlaylistItem.PlaylistRemoveButton>().ElementAtOrDefault(index);
+                return (button?.Alpha > 0) == visible;
+            });
     }
 }

From e50609c54634edb9ced3d5507c9126fee1939f39 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 22 Dec 2021 12:28:07 +0900
Subject: [PATCH 1781/5547] Rename method

---
 .../Difficulty/OsuPerformanceCalculator.cs                | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
index 067dc2f217..d7d294df47 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
@@ -99,7 +99,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty
             if (effectiveMissCount > 0)
                 aimValue *= 0.97 * Math.Pow(1 - Math.Pow((double)effectiveMissCount / totalHits, 0.775), effectiveMissCount);
 
-            aimValue *= comboScaling();
+            aimValue *= getComboScalingFactor();
 
             double approachRateFactor = 0.0;
             if (Attributes.ApproachRate > 10.33)
@@ -146,7 +146,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty
             if (effectiveMissCount > 0)
                 speedValue *= 0.97 * Math.Pow(1 - Math.Pow((double)effectiveMissCount / totalHits, 0.775), Math.Pow(effectiveMissCount, .875));
 
-            speedValue *= comboScaling();
+            speedValue *= getComboScalingFactor();
 
             double approachRateFactor = 0.0;
             if (Attributes.ApproachRate > 10.33)
@@ -230,7 +230,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty
             if (effectiveMissCount > 0)
                 flashlightValue *= 0.97 * Math.Pow(1 - Math.Pow((double)effectiveMissCount / totalHits, 0.775), Math.Pow(effectiveMissCount, .875));
 
-            flashlightValue *= comboScaling();
+            flashlightValue *= getComboScalingFactor();
 
             // Account for shorter maps having a higher ratio of 0 combo/100 combo flashlight radius.
             flashlightValue *= 0.7 + 0.1 * Math.Min(1.0, totalHits / 200.0) +
@@ -262,7 +262,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty
             return Math.Max(countMiss, (int)Math.Floor(comboBasedMissCount));
         }
 
-        private double comboScaling() => Attributes.MaxCombo <= 0 ? 1.0 : Math.Min(Math.Pow(scoreMaxCombo, 0.8) / Math.Pow(Attributes.MaxCombo, 0.8), 1.0);
+        private double getComboScalingFactor() => Attributes.MaxCombo <= 0 ? 1.0 : Math.Min(Math.Pow(scoreMaxCombo, 0.8) / Math.Pow(Attributes.MaxCombo, 0.8), 1.0);
         private int totalHits => countGreat + countOk + countMeh + countMiss;
         private int totalSuccessfulHits => countGreat + countOk + countMeh;
     }

From 24c6f8fafa0bca62c1e4a8f9fa673f9269c56b73 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 22 Dec 2021 12:55:37 +0900
Subject: [PATCH 1782/5547] Fix multiplayer test failures when checking for
 parted room

---
 .../NonVisual/Multiplayer/StatefulMultiplayerClientTest.cs    | 2 +-
 .../Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs        | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Tests/NonVisual/Multiplayer/StatefulMultiplayerClientTest.cs b/osu.Game.Tests/NonVisual/Multiplayer/StatefulMultiplayerClientTest.cs
index bc0041e2c2..0c49a18c8f 100644
--- a/osu.Game.Tests/NonVisual/Multiplayer/StatefulMultiplayerClientTest.cs
+++ b/osu.Game.Tests/NonVisual/Multiplayer/StatefulMultiplayerClientTest.cs
@@ -68,7 +68,7 @@ namespace osu.Game.Tests.NonVisual.Multiplayer
         public void TestPlayingUsersUpdatedOnJoin()
         {
             AddStep("leave room", () => Client.LeaveRoom());
-            AddUntilStep("wait for room part", () => Client.Room == null);
+            AddUntilStep("wait for room part", () => !RoomJoined);
 
             AddStep("create room initially in gameplay", () =>
             {
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs
index 674ee0f186..7760661232 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs
@@ -121,7 +121,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddStep("finish current item", () => Client.FinishCurrentItem());
 
             AddStep("leave room", () => RoomManager.PartRoom());
-            AddUntilStep("wait for room part", () => Client.Room == null);
+            AddUntilStep("wait for room part", () => !RoomJoined);
 
             AddUntilStep("item 0 not in lists", () => !inHistoryList(0) && !inQueueList(0));
             AddUntilStep("item 1 not in lists", () => !inHistoryList(0) && !inQueueList(0));
@@ -132,7 +132,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         public void TestJoinRoomWithMixedItemsAddedInCorrectLists()
         {
             AddStep("leave room", () => RoomManager.PartRoom());
-            AddUntilStep("wait for room part", () => Client.Room == null);
+            AddUntilStep("wait for room part", () => !RoomJoined);
 
             AddStep("join room with items", () =>
             {

From f81e32149b70988e4cef48129d639c34a45b9eac Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 22 Dec 2021 13:38:20 +0900
Subject: [PATCH 1783/5547] Fix `ImportCollectionsTest.TestSaveAndReload` not
 cleaning up before/after run

---
 osu.Game.Tests/Collections/IO/ImportCollectionsTest.cs | 4 ++--
 osu.Game/Tests/CleanRunHeadlessGameHost.cs             | 5 +++--
 2 files changed, 5 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Tests/Collections/IO/ImportCollectionsTest.cs b/osu.Game.Tests/Collections/IO/ImportCollectionsTest.cs
index d87ac29d75..ef1c993a66 100644
--- a/osu.Game.Tests/Collections/IO/ImportCollectionsTest.cs
+++ b/osu.Game.Tests/Collections/IO/ImportCollectionsTest.cs
@@ -128,7 +128,7 @@ namespace osu.Game.Tests.Collections.IO
         [Test]
         public async Task TestSaveAndReload()
         {
-            using (HeadlessGameHost host = new TestRunHeadlessGameHost("TestSaveAndReload", bypassCleanup: true))
+            using (HeadlessGameHost host = new CleanRunHeadlessGameHost(bypassCleanup: true))
             {
                 try
                 {
@@ -149,7 +149,7 @@ namespace osu.Game.Tests.Collections.IO
                 }
             }
 
-            using (HeadlessGameHost host = new TestRunHeadlessGameHost("TestSaveAndReload"))
+            using (HeadlessGameHost host = new TestRunHeadlessGameHost(nameof(TestSaveAndReload)))
             {
                 try
                 {
diff --git a/osu.Game/Tests/CleanRunHeadlessGameHost.cs b/osu.Game/Tests/CleanRunHeadlessGameHost.cs
index d7ab769ac4..7d7f011f6a 100644
--- a/osu.Game/Tests/CleanRunHeadlessGameHost.cs
+++ b/osu.Game/Tests/CleanRunHeadlessGameHost.cs
@@ -17,9 +17,10 @@ namespace osu.Game.Tests
         /// <param name="gameSuffix">An optional suffix which will isolate this host from others called from the same method source.</param>
         /// <param name="bindIPC">Whether to bind IPC channels.</param>
         /// <param name="realtime">Whether the host should be forced to run in realtime, rather than accelerated test time.</param>
+        /// <param name="bypassCleanup">Whether to bypass directory cleanup on host disposal. Should be used only if a subsequent test relies on the files still existing.</param>
         /// <param name="callingMethodName">The name of the calling method, used for test file isolation and clean-up.</param>
-        public CleanRunHeadlessGameHost(string gameSuffix = @"", bool bindIPC = false, bool realtime = true, [CallerMemberName] string callingMethodName = @"")
-            : base(callingMethodName + gameSuffix, bindIPC, realtime)
+        public CleanRunHeadlessGameHost(string gameSuffix = @"", bool bindIPC = false, bool realtime = true, bool bypassCleanup = false, [CallerMemberName] string callingMethodName = @"")
+            : base(callingMethodName + gameSuffix, bindIPC, realtime, bypassCleanup: bypassCleanup)
         {
         }
 

From a866572ca86622c4f3555d74ca2a67a1d8ae3fa8 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 22 Dec 2021 15:44:47 +0900
Subject: [PATCH 1784/5547] Add comment regarding host name choice

---
 osu.Game.Tests/Collections/IO/ImportCollectionsTest.cs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Game.Tests/Collections/IO/ImportCollectionsTest.cs b/osu.Game.Tests/Collections/IO/ImportCollectionsTest.cs
index ef1c993a66..686e053246 100644
--- a/osu.Game.Tests/Collections/IO/ImportCollectionsTest.cs
+++ b/osu.Game.Tests/Collections/IO/ImportCollectionsTest.cs
@@ -149,6 +149,7 @@ namespace osu.Game.Tests.Collections.IO
                 }
             }
 
+            // Name matches the automatically chosen name from `CleanRunHeadlessGameHost` above, so we end up using the same storage location.
             using (HeadlessGameHost host = new TestRunHeadlessGameHost(nameof(TestSaveAndReload)))
             {
                 try

From 9973db3981327fb507a03cf270320b8637bbd81e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 22 Dec 2021 08:40:17 +0100
Subject: [PATCH 1785/5547] Add failing test steps for right click behaviour

---
 .../Editor/TestSceneSliderControlPointPiece.cs         | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderControlPointPiece.cs b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderControlPointPiece.cs
index a0bdcb144f..d8618ee289 100644
--- a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderControlPointPiece.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderControlPointPiece.cs
@@ -58,6 +58,10 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
             assertSelectionCount(1);
             assertSelected(0);
 
+            AddStep("click right mouse", () => InputManager.Click(MouseButton.Right));
+            assertSelectionCount(1);
+            assertSelected(0);
+
             moveMouseToControlPoint(3);
             AddStep("click left mouse", () => InputManager.Click(MouseButton.Left));
             assertSelectionCount(1);
@@ -77,6 +81,12 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
             assertSelected(2);
             assertSelected(3);
 
+            AddStep("click right mouse", () => InputManager.Click(MouseButton.Right));
+            assertSelectionCount(3);
+            assertSelected(0);
+            assertSelected(2);
+            assertSelected(3);
+
             AddStep("release control", () => InputManager.ReleaseKey(Key.ControlLeft));
             AddStep("click left mouse", () => InputManager.Click(MouseButton.Left));
             assertSelectionCount(1);

From e22745397dc0716636b7af6b9006e61d68ba64c9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 22 Dec 2021 08:55:26 +0100
Subject: [PATCH 1786/5547] Fix right click deselecting clicked path piece with
 control held

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

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 3db3e85c11..3709cd3a7d 100644
--- a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointPiece.cs
+++ b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointPiece.cs
@@ -161,6 +161,8 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders.Components
                 case MouseButton.Right:
                     if (!IsSelected.Value)
                         RequestSelection.Invoke(this, e);
+
+                    keepSelection = true;
                     return false; // Allow context menu to show
             }
 

From 5b3a154431e28c6b1ff974eb15f045edabbfada3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 22 Dec 2021 17:24:01 +0900
Subject: [PATCH 1787/5547] Fix potential errors thrown during beatmap
 leaderboard display due to incorrect beatmap reference

Specifically, the global `BeatmapInfo` is referenced inside the web
request's success callback, and used to attempt population via methods
which expect non-null beatmap inputs.

Closes #16211.
---
 .../Select/Leaderboards/BeatmapLeaderboard.cs      | 14 ++++++++------
 1 file changed, 8 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
index 872e630ba0..29c8907526 100644
--- a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
+++ b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
@@ -115,7 +115,9 @@ namespace osu.Game.Screens.Select.Leaderboards
 
             var cancellationToken = loadCancellationSource.Token;
 
-            if (BeatmapInfo == null)
+            var fetchBeatmapInfo = BeatmapInfo;
+
+            if (fetchBeatmapInfo == null)
             {
                 PlaceholderState = PlaceholderState.NoneSelected;
                 return null;
@@ -124,7 +126,7 @@ namespace osu.Game.Screens.Select.Leaderboards
             if (Scope == BeatmapLeaderboardScope.Local)
             {
                 var scores = scoreManager
-                    .QueryScores(s => !s.DeletePending && s.BeatmapInfo.ID == BeatmapInfo.ID && s.Ruleset.ID == ruleset.Value.ID);
+                    .QueryScores(s => !s.DeletePending && s.BeatmapInfo.ID == fetchBeatmapInfo.ID && s.Ruleset.ID == ruleset.Value.ID);
 
                 if (filterMods && !mods.Value.Any())
                 {
@@ -151,7 +153,7 @@ namespace osu.Game.Screens.Select.Leaderboards
                 return null;
             }
 
-            if (BeatmapInfo.OnlineID == null || BeatmapInfo?.Status <= BeatmapOnlineStatus.Pending)
+            if (fetchBeatmapInfo.OnlineID == null || fetchBeatmapInfo.Status <= BeatmapOnlineStatus.Pending)
             {
                 PlaceholderState = PlaceholderState.Unavailable;
                 return null;
@@ -171,18 +173,18 @@ namespace osu.Game.Screens.Select.Leaderboards
             else if (filterMods)
                 requestMods = mods.Value;
 
-            var req = new GetScoresRequest(BeatmapInfo, ruleset.Value ?? BeatmapInfo.Ruleset, Scope, requestMods);
+            var req = new GetScoresRequest(fetchBeatmapInfo, ruleset.Value ?? fetchBeatmapInfo.Ruleset, Scope, requestMods);
 
             req.Success += r =>
             {
-                scoreManager.OrderByTotalScoreAsync(r.Scores.Select(s => s.CreateScoreInfo(rulesets, BeatmapInfo)).ToArray(), cancellationToken)
+                scoreManager.OrderByTotalScoreAsync(r.Scores.Select(s => s.CreateScoreInfo(rulesets, fetchBeatmapInfo)).ToArray(), cancellationToken)
                             .ContinueWith(ordered => Schedule(() =>
                             {
                                 if (cancellationToken.IsCancellationRequested)
                                     return;
 
                                 scoresCallback?.Invoke(ordered.Result);
-                                TopScore = r.UserScore?.CreateScoreInfo(rulesets, BeatmapInfo);
+                                TopScore = r.UserScore?.CreateScoreInfo(rulesets, fetchBeatmapInfo);
                             }), TaskContinuationOptions.OnlyOnRanToCompletion);
             };
 

From 307d3709e06cea42cddfe80fc2219c4dcc12d33b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 22 Dec 2021 09:32:38 +0100
Subject: [PATCH 1788/5547] Add failing test steps for selection behaviour on
 new point creation

---
 .../Editor/TestSceneSliderControlPointPiece.cs    | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderControlPointPiece.cs b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderControlPointPiece.cs
index d8618ee289..74d6d23348 100644
--- a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderControlPointPiece.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderControlPointPiece.cs
@@ -92,6 +92,21 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
             assertSelectionCount(1);
             assertSelected(0);
 
+            AddStep("move mouse to new point position", () =>
+            {
+                Vector2 position = slider.Position + (slider.Path.ControlPoints[2].Position + slider.Path.ControlPoints[3].Position) / 2;
+                InputManager.MoveMouseTo(drawableObject.Parent.ToScreenSpace(position));
+            });
+            AddStep("ctrl+click to create new point", () =>
+            {
+                InputManager.PressKey(Key.ControlLeft);
+                InputManager.Click(MouseButton.Left);
+                InputManager.ReleaseKey(Key.ControlLeft);
+            });
+            AddAssert("slider has 6 control points", () => slider.Path.ControlPoints.Count == 6);
+            assertSelectionCount(1);
+            assertSelected(3);
+
             void assertSelectionCount(int count) =>
                 AddAssert($"{count} control point pieces selected", () => this.ChildrenOfType<PathControlPointPiece>().Count(piece => piece.IsSelected.Value) == count);
 

From b38b30015965a806bf1198d160fc3927bd46a8b4 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 22 Dec 2021 17:35:18 +0900
Subject: [PATCH 1789/5547] Convert `BeatmapMetadata` access to be via a
 computed property

---
 osu.Game/Beatmaps/WorkingBeatmap.cs | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Beatmaps/WorkingBeatmap.cs b/osu.Game/Beatmaps/WorkingBeatmap.cs
index a17f247d9b..172441bb25 100644
--- a/osu.Game/Beatmaps/WorkingBeatmap.cs
+++ b/osu.Game/Beatmaps/WorkingBeatmap.cs
@@ -28,7 +28,9 @@ namespace osu.Game.Beatmaps
     {
         public readonly BeatmapInfo BeatmapInfo;
         public readonly BeatmapSetInfo BeatmapSetInfo;
-        public readonly BeatmapMetadata Metadata;
+
+        // TODO: remove once the fallback lookup is not required (and access via `working.BeatmapInfo.Metadata` directly).
+        public BeatmapMetadata Metadata => BeatmapInfo.Metadata ?? BeatmapSetInfo?.Metadata ?? new BeatmapMetadata();
 
         protected AudioManager AudioManager { get; }
 
@@ -37,7 +39,6 @@ namespace osu.Game.Beatmaps
             AudioManager = audioManager;
             BeatmapInfo = beatmapInfo;
             BeatmapSetInfo = beatmapInfo.BeatmapSet;
-            Metadata = beatmapInfo.Metadata ?? BeatmapSetInfo?.Metadata ?? new BeatmapMetadata();
 
             background = new RecyclableLazy<Texture>(GetBackground, BackgroundStillValid);
             waveform = new RecyclableLazy<Waveform>(GetWaveform);

From 1b0af78831eb85ce68e8dbf65bfa063099062835 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 22 Dec 2021 17:39:13 +0900
Subject: [PATCH 1790/5547] Simplify `WorkingBeatmap` in multiple ways

Just a clean-up pass.
---
 osu.Game/Beatmaps/WorkingBeatmap.cs | 23 ++++++++++++-----------
 1 file changed, 12 insertions(+), 11 deletions(-)

diff --git a/osu.Game/Beatmaps/WorkingBeatmap.cs b/osu.Game/Beatmaps/WorkingBeatmap.cs
index 172441bb25..1e33219048 100644
--- a/osu.Game/Beatmaps/WorkingBeatmap.cs
+++ b/osu.Game/Beatmaps/WorkingBeatmap.cs
@@ -32,11 +32,16 @@ namespace osu.Game.Beatmaps
         // TODO: remove once the fallback lookup is not required (and access via `working.BeatmapInfo.Metadata` directly).
         public BeatmapMetadata Metadata => BeatmapInfo.Metadata ?? BeatmapSetInfo?.Metadata ?? new BeatmapMetadata();
 
-        protected AudioManager AudioManager { get; }
+        private AudioManager audioManager { get; }
+
+        private CancellationTokenSource loadCancellationSource = new CancellationTokenSource();
+
+        private readonly object beatmapFetchLock = new object();
 
         protected WorkingBeatmap(BeatmapInfo beatmapInfo, AudioManager audioManager)
         {
-            AudioManager = audioManager;
+            this.audioManager = audioManager;
+
             BeatmapInfo = beatmapInfo;
             BeatmapSetInfo = beatmapInfo.BeatmapSet;
 
@@ -46,7 +51,7 @@ namespace osu.Game.Beatmaps
             skin = new RecyclableLazy<ISkin>(GetSkin);
         }
 
-        protected virtual Track GetVirtualTrack(double emptyLength = 0)
+        protected Track GetVirtualTrack(double emptyLength = 0)
         {
             const double excess_length = 1000;
 
@@ -69,7 +74,7 @@ namespace osu.Game.Beatmaps
                     break;
             }
 
-            return AudioManager.Tracks.GetVirtual(length);
+            return audioManager.Tracks.GetVirtual(length);
         }
 
         /// <summary>
@@ -170,24 +175,20 @@ namespace osu.Game.Beatmaps
             return converted;
         }
 
-        private CancellationTokenSource loadCancellation = new CancellationTokenSource();
-
         public void BeginAsyncLoad() => loadBeatmapAsync();
 
         public void CancelAsyncLoad()
         {
             lock (beatmapFetchLock)
             {
-                loadCancellation?.Cancel();
-                loadCancellation = new CancellationTokenSource();
+                loadCancellationSource?.Cancel();
+                loadCancellationSource = new CancellationTokenSource();
 
                 if (beatmapLoadTask?.IsCompleted != true)
                     beatmapLoadTask = null;
             }
         }
 
-        private readonly object beatmapFetchLock = new object();
-
         private Task<IBeatmap> loadBeatmapAsync()
         {
             lock (beatmapFetchLock)
@@ -204,7 +205,7 @@ namespace osu.Game.Beatmaps
                     b.BeatmapInfo = BeatmapInfo;
 
                     return b;
-                }, loadCancellation.Token, TaskCreationOptions.LongRunning, TaskScheduler.Default);
+                }, loadCancellationSource.Token, TaskCreationOptions.LongRunning, TaskScheduler.Default);
             }
         }
 

From 967419c9ac8f63d58e32d0f485328fb67a948323 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 22 Dec 2021 17:44:22 +0900
Subject: [PATCH 1791/5547] Remove `BeatmapSetInfo` and `Metadata` from
 interface

There were very few accesses to this, and after realm they should all be
done via the `BeatmapInfo`, so let's remove this.
---
 .../Visual/Navigation/TestSceneScreenNavigation.cs         | 4 ++--
 osu.Game/Beatmaps/IWorkingBeatmap.cs                       | 7 +++----
 osu.Game/Beatmaps/WorkingBeatmap.cs                        | 2 --
 3 files changed, 5 insertions(+), 8 deletions(-)

diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs b/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
index 48ab643992..75d8e62ca7 100644
--- a/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
@@ -157,12 +157,12 @@ namespace osu.Game.Tests.Visual.Navigation
             AddUntilStep("wait for fail", () => player.HasFailed);
 
             AddUntilStep("wait for track stop", () => !Game.MusicController.IsPlaying);
-            AddAssert("Ensure time before preview point", () => Game.MusicController.CurrentTrack.CurrentTime < beatmap().Metadata.PreviewTime);
+            AddAssert("Ensure time before preview point", () => Game.MusicController.CurrentTrack.CurrentTime < beatmap().BeatmapInfo.Metadata.PreviewTime);
 
             pushEscape();
 
             AddUntilStep("wait for track playing", () => Game.MusicController.IsPlaying);
-            AddAssert("Ensure time wasn't reset to preview point", () => Game.MusicController.CurrentTrack.CurrentTime < beatmap().Metadata.PreviewTime);
+            AddAssert("Ensure time wasn't reset to preview point", () => Game.MusicController.CurrentTrack.CurrentTime < beatmap().BeatmapInfo.Metadata.PreviewTime);
         }
 
         [Test]
diff --git a/osu.Game/Beatmaps/IWorkingBeatmap.cs b/osu.Game/Beatmaps/IWorkingBeatmap.cs
index 717162fd7f..75b2ecff15 100644
--- a/osu.Game/Beatmaps/IWorkingBeatmap.cs
+++ b/osu.Game/Beatmaps/IWorkingBeatmap.cs
@@ -15,14 +15,13 @@ using osu.Game.Storyboards;
 
 namespace osu.Game.Beatmaps
 {
+    /// <summary>
+    /// Provides access to the multiple resources offered by a beatmap model (textures, skins, playable beatmaps etc.)
+    /// </summary>
     public interface IWorkingBeatmap
     {
         IBeatmapInfo BeatmapInfo { get; }
 
-        IBeatmapSetInfo BeatmapSetInfo { get; }
-
-        IBeatmapMetadataInfo Metadata { get; }
-
         /// <summary>
         /// Whether the Beatmap has finished loading.
         ///</summary>
diff --git a/osu.Game/Beatmaps/WorkingBeatmap.cs b/osu.Game/Beatmaps/WorkingBeatmap.cs
index 1e33219048..e3bb594858 100644
--- a/osu.Game/Beatmaps/WorkingBeatmap.cs
+++ b/osu.Game/Beatmaps/WorkingBeatmap.cs
@@ -214,8 +214,6 @@ namespace osu.Game.Beatmaps
         public virtual bool BeatmapLoaded => beatmapLoadTask?.IsCompleted ?? false;
 
         IBeatmapInfo IWorkingBeatmap.BeatmapInfo => BeatmapInfo;
-        IBeatmapMetadataInfo IWorkingBeatmap.Metadata => Metadata;
-        IBeatmapSetInfo IWorkingBeatmap.BeatmapSetInfo => BeatmapSetInfo;
 
         public IBeatmap Beatmap
         {

From e38e4c0adc10e04723c110fe0b4059599713641d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 22 Dec 2021 17:52:12 +0900
Subject: [PATCH 1792/5547] Enable NRT on `IWorkingBeatmap`

---
 osu.Game/Beatmaps/IWorkingBeatmap.cs | 4 +++-
 osu.Game/Beatmaps/WorkingBeatmap.cs  | 3 +--
 2 files changed, 4 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Beatmaps/IWorkingBeatmap.cs b/osu.Game/Beatmaps/IWorkingBeatmap.cs
index 75b2ecff15..0bd589aa7e 100644
--- a/osu.Game/Beatmaps/IWorkingBeatmap.cs
+++ b/osu.Game/Beatmaps/IWorkingBeatmap.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.
 
+#nullable enable
+
 using System.Collections.Generic;
 using System.IO;
 using System.Threading;
@@ -99,7 +101,7 @@ namespace osu.Game.Beatmaps
         /// <param name="mods">The <see cref="Mod"/>s to apply to the <see cref="IBeatmap"/>.</param>
         /// <returns>The converted <see cref="IBeatmap"/>.</returns>
         /// <exception cref="BeatmapInvalidForRulesetException">If <see cref="Beatmap"/> could not be converted to <paramref name="ruleset"/>.</exception>
-        IBeatmap GetPlayableBeatmap(IRulesetInfo ruleset, IReadOnlyList<Mod> mods = null);
+        IBeatmap GetPlayableBeatmap(IRulesetInfo ruleset, IReadOnlyList<Mod>? mods = null);
 
         /// <summary>
         /// Constructs a playable <see cref="IBeatmap"/> from <see cref="Beatmap"/> using the applicable converters for a specific <see cref="RulesetInfo"/>.
diff --git a/osu.Game/Beatmaps/WorkingBeatmap.cs b/osu.Game/Beatmaps/WorkingBeatmap.cs
index e3bb594858..2baac55c60 100644
--- a/osu.Game/Beatmaps/WorkingBeatmap.cs
+++ b/osu.Game/Beatmaps/WorkingBeatmap.cs
@@ -85,7 +85,7 @@ namespace osu.Game.Beatmaps
         /// <returns>The applicable <see cref="IBeatmapConverter"/>.</returns>
         protected virtual IBeatmapConverter CreateBeatmapConverter(IBeatmap beatmap, Ruleset ruleset) => ruleset.CreateBeatmapConverter(beatmap);
 
-        public IBeatmap GetPlayableBeatmap([NotNull] IRulesetInfo ruleset, IReadOnlyList<Mod> mods = null)
+        public IBeatmap GetPlayableBeatmap(IRulesetInfo ruleset, IReadOnlyList<Mod> mods = null)
         {
             try
             {
@@ -251,7 +251,6 @@ namespace osu.Game.Beatmaps
 
         private Track loadedTrack;
 
-        [NotNull]
         public Track LoadTrack() => loadedTrack = GetBeatmapTrack() ?? GetVirtualTrack(1000);
 
         public void PrepareTrackForPreviewLooping()

From 3c95497ed78fd2b8a0b38cf682ceb3ebfbfa2eba Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 22 Dec 2021 18:01:09 +0900
Subject: [PATCH 1793/5547] Reorder methods to hopefully make more sense

---
 osu.Game/Beatmaps/WorkingBeatmap.cs | 340 ++++++++++++++++------------
 1 file changed, 189 insertions(+), 151 deletions(-)

diff --git a/osu.Game/Beatmaps/WorkingBeatmap.cs b/osu.Game/Beatmaps/WorkingBeatmap.cs
index 2baac55c60..bdce60636b 100644
--- a/osu.Game/Beatmaps/WorkingBeatmap.cs
+++ b/osu.Game/Beatmaps/WorkingBeatmap.cs
@@ -51,6 +51,110 @@ namespace osu.Game.Beatmaps
             skin = new RecyclableLazy<ISkin>(GetSkin);
         }
 
+        #region Load checks
+
+        public virtual bool TrackLoaded => loadedTrack != null;
+        public bool WaveformLoaded => waveform.IsResultAvailable;
+        public bool StoryboardLoaded => storyboard.IsResultAvailable;
+        public bool SkinLoaded => skin.IsResultAvailable;
+        public bool BackgroundLoaded => background.IsResultAvailable;
+        public virtual bool BeatmapLoaded => beatmapLoadTask?.IsCompleted ?? false;
+
+        #endregion
+
+        #region Resource getters
+
+        protected virtual Waveform GetWaveform() => new Waveform(null);
+        protected virtual Storyboard GetStoryboard() => new Storyboard { BeatmapInfo = BeatmapInfo };
+
+        protected abstract IBeatmap GetBeatmap();
+        protected abstract Texture GetBackground();
+        protected abstract Track GetBeatmapTrack();
+
+        /// <summary>
+        /// Creates a new skin instance for this beatmap.
+        /// </summary>
+        /// <remarks>
+        /// This should only be called externally in scenarios where it is explicitly desired to get a new instance of a skin
+        /// (e.g. for editing purposes, to avoid state pollution).
+        /// For standard reading purposes, <see cref="Skin"/> should always be used directly.
+        /// </remarks>
+        protected internal abstract ISkin GetSkin();
+
+        #endregion
+
+        #region Async load control
+
+        public void BeginAsyncLoad() => loadBeatmapAsync();
+
+        public void CancelAsyncLoad()
+        {
+            lock (beatmapFetchLock)
+            {
+                loadCancellationSource?.Cancel();
+                loadCancellationSource = new CancellationTokenSource();
+
+                if (beatmapLoadTask?.IsCompleted != true)
+                    beatmapLoadTask = null;
+            }
+        }
+
+        #endregion
+
+        #region Background
+
+        public Texture Background => background.Value;
+        private readonly RecyclableLazy<Texture> background;
+
+        protected virtual bool BackgroundStillValid(Texture b) => b == null || b.Available;
+
+        #endregion
+
+        #region Track
+
+        private Track loadedTrack;
+
+        public Track LoadTrack() => loadedTrack = GetBeatmapTrack() ?? GetVirtualTrack(1000);
+
+        public void PrepareTrackForPreviewLooping()
+        {
+            Track.Looping = true;
+            Track.RestartPoint = Metadata.PreviewTime;
+
+            if (Track.RestartPoint == -1)
+            {
+                if (!Track.IsLoaded)
+                {
+                    // force length to be populated (https://github.com/ppy/osu-framework/issues/4202)
+                    Track.Seek(Track.CurrentTime);
+                }
+
+                Track.RestartPoint = 0.4f * Track.Length;
+            }
+        }
+
+        /// <summary>
+        /// Transfer a valid audio track into this working beatmap. Used as an optimisation to avoid reload / track swap
+        /// across difficulties in the same beatmap set.
+        /// </summary>
+        /// <param name="track">The track to transfer.</param>
+        public void TransferTrack([NotNull] Track track) => loadedTrack = track ?? throw new ArgumentNullException(nameof(track));
+
+        /// <summary>
+        /// Get the loaded audio track instance. <see cref="LoadTrack"/> must have first been called.
+        /// This generally happens via MusicController when changing the global beatmap.
+        /// </summary>
+        public Track Track
+        {
+            get
+            {
+                if (!TrackLoaded)
+                    throw new InvalidOperationException($"Cannot access {nameof(Track)} without first calling {nameof(LoadTrack)}.");
+
+                return loadedTrack;
+            }
+        }
+
         protected Track GetVirtualTrack(double emptyLength = 0)
         {
             const double excess_length = 1000;
@@ -77,13 +181,82 @@ namespace osu.Game.Beatmaps
             return audioManager.Tracks.GetVirtual(length);
         }
 
-        /// <summary>
-        /// Creates a <see cref="IBeatmapConverter"/> to convert a <see cref="IBeatmap"/> for a specified <see cref="Ruleset"/>.
-        /// </summary>
-        /// <param name="beatmap">The <see cref="IBeatmap"/> to be converted.</param>
-        /// <param name="ruleset">The <see cref="Ruleset"/> for which <paramref name="beatmap"/> should be converted.</param>
-        /// <returns>The applicable <see cref="IBeatmapConverter"/>.</returns>
-        protected virtual IBeatmapConverter CreateBeatmapConverter(IBeatmap beatmap, Ruleset ruleset) => ruleset.CreateBeatmapConverter(beatmap);
+        #endregion
+
+        #region Waveform
+
+        public Waveform Waveform => waveform.Value;
+        private readonly RecyclableLazy<Waveform> waveform;
+
+        #endregion
+
+        #region Storyboard
+
+        public Storyboard Storyboard => storyboard.Value;
+        private readonly RecyclableLazy<Storyboard> storyboard;
+
+        #endregion
+
+        #region Skin
+
+        private readonly RecyclableLazy<ISkin> skin;
+
+        public ISkin Skin => skin.Value;
+
+        #endregion
+
+        #region Beatmap
+
+        public IBeatmap Beatmap
+        {
+            get
+            {
+                try
+                {
+                    return loadBeatmapAsync().Result;
+                }
+                catch (AggregateException ae)
+                {
+                    // This is the exception that is generally expected here, which occurs via natural cancellation of the asynchronous load
+                    if (ae.InnerExceptions.FirstOrDefault() is TaskCanceledException)
+                        return null;
+
+                    Logger.Error(ae, "Beatmap failed to load");
+                    return null;
+                }
+                catch (Exception e)
+                {
+                    Logger.Error(e, "Beatmap failed to load");
+                    return null;
+                }
+            }
+        }
+
+        private Task<IBeatmap> beatmapLoadTask;
+
+        private Task<IBeatmap> loadBeatmapAsync()
+        {
+            lock (beatmapFetchLock)
+            {
+                return beatmapLoadTask ??= Task.Factory.StartNew(() =>
+                {
+                    // Todo: Handle cancellation during beatmap parsing
+                    var b = GetBeatmap() ?? new Beatmap();
+
+                    // The original beatmap version needs to be preserved as the database doesn't contain it
+                    BeatmapInfo.BeatmapVersion = b.BeatmapInfo.BeatmapVersion;
+
+                    // Use the database-backed info for more up-to-date values (beatmap id, ranked status, etc)
+                    b.BeatmapInfo = BeatmapInfo;
+
+                    return b;
+                }, loadCancellationSource.Token, TaskCreationOptions.LongRunning, TaskScheduler.Default);
+            }
+        }
+
+        #endregion
+
+        #region Playable beatmap
 
         public IBeatmap GetPlayableBeatmap(IRulesetInfo ruleset, IReadOnlyList<Mod> mods = null)
         {
@@ -101,7 +274,7 @@ namespace osu.Game.Beatmaps
             }
         }
 
-        public virtual IBeatmap GetPlayableBeatmap([NotNull] IRulesetInfo ruleset, [NotNull] IReadOnlyList<Mod> mods, CancellationToken token)
+        public virtual IBeatmap GetPlayableBeatmap(IRulesetInfo ruleset, IReadOnlyList<Mod> mods, CancellationToken token)
         {
             var rulesetInstance = ruleset.CreateInstance();
 
@@ -175,155 +348,20 @@ namespace osu.Game.Beatmaps
             return converted;
         }
 
-        public void BeginAsyncLoad() => loadBeatmapAsync();
+        /// <summary>
+        /// Creates a <see cref="IBeatmapConverter"/> to convert a <see cref="IBeatmap"/> for a specified <see cref="Ruleset"/>.
+        /// </summary>
+        /// <param name="beatmap">The <see cref="IBeatmap"/> to be converted.</param>
+        /// <param name="ruleset">The <see cref="Ruleset"/> for which <paramref name="beatmap"/> should be converted.</param>
+        /// <returns>The applicable <see cref="IBeatmapConverter"/>.</returns>
+        protected virtual IBeatmapConverter CreateBeatmapConverter(IBeatmap beatmap, Ruleset ruleset) => ruleset.CreateBeatmapConverter(beatmap);
 
-        public void CancelAsyncLoad()
-        {
-            lock (beatmapFetchLock)
-            {
-                loadCancellationSource?.Cancel();
-                loadCancellationSource = new CancellationTokenSource();
-
-                if (beatmapLoadTask?.IsCompleted != true)
-                    beatmapLoadTask = null;
-            }
-        }
-
-        private Task<IBeatmap> loadBeatmapAsync()
-        {
-            lock (beatmapFetchLock)
-            {
-                return beatmapLoadTask ??= Task.Factory.StartNew(() =>
-                {
-                    // Todo: Handle cancellation during beatmap parsing
-                    var b = GetBeatmap() ?? new Beatmap();
-
-                    // The original beatmap version needs to be preserved as the database doesn't contain it
-                    BeatmapInfo.BeatmapVersion = b.BeatmapInfo.BeatmapVersion;
-
-                    // Use the database-backed info for more up-to-date values (beatmap id, ranked status, etc)
-                    b.BeatmapInfo = BeatmapInfo;
-
-                    return b;
-                }, loadCancellationSource.Token, TaskCreationOptions.LongRunning, TaskScheduler.Default);
-            }
-        }
+        #endregion
 
         public override string ToString() => BeatmapInfo.ToString();
 
-        public virtual bool BeatmapLoaded => beatmapLoadTask?.IsCompleted ?? false;
-
         IBeatmapInfo IWorkingBeatmap.BeatmapInfo => BeatmapInfo;
 
-        public IBeatmap Beatmap
-        {
-            get
-            {
-                try
-                {
-                    return loadBeatmapAsync().Result;
-                }
-                catch (AggregateException ae)
-                {
-                    // This is the exception that is generally expected here, which occurs via natural cancellation of the asynchronous load
-                    if (ae.InnerExceptions.FirstOrDefault() is TaskCanceledException)
-                        return null;
-
-                    Logger.Error(ae, "Beatmap failed to load");
-                    return null;
-                }
-                catch (Exception e)
-                {
-                    Logger.Error(e, "Beatmap failed to load");
-                    return null;
-                }
-            }
-        }
-
-        protected abstract IBeatmap GetBeatmap();
-        private Task<IBeatmap> beatmapLoadTask;
-
-        public bool BackgroundLoaded => background.IsResultAvailable;
-        public Texture Background => background.Value;
-        protected virtual bool BackgroundStillValid(Texture b) => b == null || b.Available;
-        protected abstract Texture GetBackground();
-        private readonly RecyclableLazy<Texture> background;
-
-        private Track loadedTrack;
-
-        public Track LoadTrack() => loadedTrack = GetBeatmapTrack() ?? GetVirtualTrack(1000);
-
-        public void PrepareTrackForPreviewLooping()
-        {
-            Track.Looping = true;
-            Track.RestartPoint = Metadata.PreviewTime;
-
-            if (Track.RestartPoint == -1)
-            {
-                if (!Track.IsLoaded)
-                {
-                    // force length to be populated (https://github.com/ppy/osu-framework/issues/4202)
-                    Track.Seek(Track.CurrentTime);
-                }
-
-                Track.RestartPoint = 0.4f * Track.Length;
-            }
-        }
-
-        /// <summary>
-        /// Transfer a valid audio track into this working beatmap. Used as an optimisation to avoid reload / track swap
-        /// across difficulties in the same beatmap set.
-        /// </summary>
-        /// <param name="track">The track to transfer.</param>
-        public void TransferTrack([NotNull] Track track) => loadedTrack = track ?? throw new ArgumentNullException(nameof(track));
-
-        /// <summary>
-        /// Whether this beatmap's track has been loaded via <see cref="LoadTrack"/>.
-        /// </summary>
-        public virtual bool TrackLoaded => loadedTrack != null;
-
-        /// <summary>
-        /// Get the loaded audio track instance. <see cref="LoadTrack"/> must have first been called.
-        /// This generally happens via MusicController when changing the global beatmap.
-        /// </summary>
-        public Track Track
-        {
-            get
-            {
-                if (!TrackLoaded)
-                    throw new InvalidOperationException($"Cannot access {nameof(Track)} without first calling {nameof(LoadTrack)}.");
-
-                return loadedTrack;
-            }
-        }
-
-        protected abstract Track GetBeatmapTrack();
-
-        public bool WaveformLoaded => waveform.IsResultAvailable;
-        public Waveform Waveform => waveform.Value;
-        protected virtual Waveform GetWaveform() => new Waveform(null);
-        private readonly RecyclableLazy<Waveform> waveform;
-
-        public bool StoryboardLoaded => storyboard.IsResultAvailable;
-        public Storyboard Storyboard => storyboard.Value;
-        protected virtual Storyboard GetStoryboard() => new Storyboard { BeatmapInfo = BeatmapInfo };
-        private readonly RecyclableLazy<Storyboard> storyboard;
-
-        public bool SkinLoaded => skin.IsResultAvailable;
-        public ISkin Skin => skin.Value;
-
-        /// <summary>
-        /// Creates a new skin instance for this beatmap.
-        /// </summary>
-        /// <remarks>
-        /// This should only be called externally in scenarios where it is explicitly desired to get a new instance of a skin
-        /// (e.g. for editing purposes, to avoid state pollution).
-        /// For standard reading purposes, <see cref="Skin"/> should always be used directly.
-        /// </remarks>
-        protected internal abstract ISkin GetSkin();
-
-        private readonly RecyclableLazy<ISkin> skin;
-
         public abstract Stream GetStream(string storagePath);
 
         public class RecyclableLazy<T>

From f3f491374bf383bb53b2b6e521afab6b233855ca Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 22 Dec 2021 18:12:01 +0900
Subject: [PATCH 1794/5547] Remove unused load checks

---
 .../TestSceneStoryboardSamplePlayback.cs      |  2 +-
 osu.Game/Beatmaps/IWorkingBeatmap.cs          | 20 -------------------
 osu.Game/Beatmaps/WorkingBeatmap.cs           |  4 ----
 3 files changed, 1 insertion(+), 25 deletions(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboardSamplePlayback.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboardSamplePlayback.cs
index a718a98aa6..95603b5c04 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboardSamplePlayback.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboardSamplePlayback.cs
@@ -57,7 +57,7 @@ namespace osu.Game.Tests.Visual.Gameplay
 
         private void checkForFirstSamplePlayback()
         {
-            AddUntilStep("storyboard loaded", () => Player.Beatmap.Value.StoryboardLoaded);
+            AddAssert("storyboard loaded", () => Player.Beatmap.Value.Storyboard != null);
             AddUntilStep("any storyboard samples playing", () => allStoryboardSamples.Any(sound => sound.IsPlaying));
         }
 
diff --git a/osu.Game/Beatmaps/IWorkingBeatmap.cs b/osu.Game/Beatmaps/IWorkingBeatmap.cs
index 0bd589aa7e..3bfbbad714 100644
--- a/osu.Game/Beatmaps/IWorkingBeatmap.cs
+++ b/osu.Game/Beatmaps/IWorkingBeatmap.cs
@@ -29,26 +29,6 @@ namespace osu.Game.Beatmaps
         ///</summary>
         public bool BeatmapLoaded { get; }
 
-        /// <summary>
-        /// Whether the Background has finished loading.
-        ///</summary>
-        public bool BackgroundLoaded { get; }
-
-        /// <summary>
-        /// Whether the Waveform has finished loading.
-        ///</summary>
-        public bool WaveformLoaded { get; }
-
-        /// <summary>
-        /// Whether the Storyboard has finished loading.
-        ///</summary>
-        public bool StoryboardLoaded { get; }
-
-        /// <summary>
-        /// Whether the Skin has finished loading.
-        ///</summary>
-        public bool SkinLoaded { get; }
-
         /// <summary>
         /// Whether the Track has finished loading.
         ///</summary>
diff --git a/osu.Game/Beatmaps/WorkingBeatmap.cs b/osu.Game/Beatmaps/WorkingBeatmap.cs
index bdce60636b..c5b44c3cb4 100644
--- a/osu.Game/Beatmaps/WorkingBeatmap.cs
+++ b/osu.Game/Beatmaps/WorkingBeatmap.cs
@@ -54,10 +54,6 @@ namespace osu.Game.Beatmaps
         #region Load checks
 
         public virtual bool TrackLoaded => loadedTrack != null;
-        public bool WaveformLoaded => waveform.IsResultAvailable;
-        public bool StoryboardLoaded => storyboard.IsResultAvailable;
-        public bool SkinLoaded => skin.IsResultAvailable;
-        public bool BackgroundLoaded => background.IsResultAvailable;
         public virtual bool BeatmapLoaded => beatmapLoadTask?.IsCompleted ?? false;
 
         #endregion

From 7344c87b161b5b73fb2827322452f908831af53e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 22 Dec 2021 18:16:57 +0900
Subject: [PATCH 1795/5547] Remove `RecyclableLazy`

---
 osu.Game/Beatmaps/WorkingBeatmap.cs      | 93 ++++--------------------
 osu.Game/Beatmaps/WorkingBeatmapCache.cs |  2 -
 2 files changed, 13 insertions(+), 82 deletions(-)

diff --git a/osu.Game/Beatmaps/WorkingBeatmap.cs b/osu.Game/Beatmaps/WorkingBeatmap.cs
index c5b44c3cb4..cdd22e26ae 100644
--- a/osu.Game/Beatmaps/WorkingBeatmap.cs
+++ b/osu.Game/Beatmaps/WorkingBeatmap.cs
@@ -38,6 +38,10 @@ namespace osu.Game.Beatmaps
 
         private readonly object beatmapFetchLock = new object();
 
+        private readonly Lazy<Waveform> waveform;
+        private readonly Lazy<Storyboard> storyboard;
+        private readonly Lazy<ISkin> skin;
+
         protected WorkingBeatmap(BeatmapInfo beatmapInfo, AudioManager audioManager)
         {
             this.audioManager = audioManager;
@@ -45,12 +49,16 @@ namespace osu.Game.Beatmaps
             BeatmapInfo = beatmapInfo;
             BeatmapSetInfo = beatmapInfo.BeatmapSet;
 
-            background = new RecyclableLazy<Texture>(GetBackground, BackgroundStillValid);
-            waveform = new RecyclableLazy<Waveform>(GetWaveform);
-            storyboard = new RecyclableLazy<Storyboard>(GetStoryboard);
-            skin = new RecyclableLazy<ISkin>(GetSkin);
+            waveform = new Lazy<Waveform>(GetWaveform);
+            storyboard = new Lazy<Storyboard>(GetStoryboard);
+            skin = new Lazy<ISkin>(GetSkin);
         }
 
+        public Waveform Waveform => waveform.Value;
+        public Storyboard Storyboard => storyboard.Value;
+        public Texture Background => GetBackground(); // Texture uses ref counting, so we want to return a new instance every usage.
+        public ISkin Skin => skin.Value;
+
         #region Load checks
 
         public virtual bool TrackLoaded => loadedTrack != null;
@@ -97,15 +105,6 @@ namespace osu.Game.Beatmaps
 
         #endregion
 
-        #region Background
-
-        public Texture Background => background.Value;
-        private readonly RecyclableLazy<Texture> background;
-
-        protected virtual bool BackgroundStillValid(Texture b) => b == null || b.Available;
-
-        #endregion
-
         #region Track
 
         private Track loadedTrack;
@@ -179,28 +178,6 @@ namespace osu.Game.Beatmaps
 
         #endregion
 
-        #region Waveform
-
-        public Waveform Waveform => waveform.Value;
-        private readonly RecyclableLazy<Waveform> waveform;
-
-        #endregion
-
-        #region Storyboard
-
-        public Storyboard Storyboard => storyboard.Value;
-        private readonly RecyclableLazy<Storyboard> storyboard;
-
-        #endregion
-
-        #region Skin
-
-        private readonly RecyclableLazy<ISkin> skin;
-
-        public ISkin Skin => skin.Value;
-
-        #endregion
-
         #region Beatmap
 
         public IBeatmap Beatmap
@@ -356,53 +333,9 @@ namespace osu.Game.Beatmaps
 
         public override string ToString() => BeatmapInfo.ToString();
 
-        IBeatmapInfo IWorkingBeatmap.BeatmapInfo => BeatmapInfo;
-
         public abstract Stream GetStream(string storagePath);
 
-        public class RecyclableLazy<T>
-        {
-            private Lazy<T> lazy;
-            private readonly Func<T> valueFactory;
-            private readonly Func<T, bool> stillValidFunction;
-
-            private readonly object fetchLock = new object();
-
-            public RecyclableLazy(Func<T> valueFactory, Func<T, bool> stillValidFunction = null)
-            {
-                this.valueFactory = valueFactory;
-                this.stillValidFunction = stillValidFunction;
-
-                recreate();
-            }
-
-            public void Recycle()
-            {
-                if (!IsResultAvailable) return;
-
-                (lazy.Value as IDisposable)?.Dispose();
-                recreate();
-            }
-
-            public bool IsResultAvailable => stillValid;
-
-            public T Value
-            {
-                get
-                {
-                    lock (fetchLock)
-                    {
-                        if (!stillValid)
-                            recreate();
-                        return lazy.Value;
-                    }
-                }
-            }
-
-            private bool stillValid => lazy.IsValueCreated && (stillValidFunction?.Invoke(lazy.Value) ?? true);
-
-            private void recreate() => lazy = new Lazy<T>(valueFactory, LazyThreadSafetyMode.ExecutionAndPublication);
-        }
+        IBeatmapInfo IWorkingBeatmap.BeatmapInfo => BeatmapInfo;
 
         private class BeatmapLoadTimeoutException : TimeoutException
         {
diff --git a/osu.Game/Beatmaps/WorkingBeatmapCache.cs b/osu.Game/Beatmaps/WorkingBeatmapCache.cs
index 449406eadf..514551e184 100644
--- a/osu.Game/Beatmaps/WorkingBeatmapCache.cs
+++ b/osu.Game/Beatmaps/WorkingBeatmapCache.cs
@@ -145,8 +145,6 @@ namespace osu.Game.Beatmaps
                 }
             }
 
-            protected override bool BackgroundStillValid(Texture b) => false; // bypass lazy logic. we want to return a new background each time for refcounting purposes.
-
             protected override Texture GetBackground()
             {
                 if (string.IsNullOrEmpty(Metadata?.BackgroundFile))

From a5f77a86efa54e4bdecc3108618132dc9cde346c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 22 Dec 2021 18:23:11 +0900
Subject: [PATCH 1796/5547] Move load methods and rename `loadedTrack` to match
 other private fields

---
 osu.Game/Beatmaps/WorkingBeatmap.cs | 18 +++++++-----------
 1 file changed, 7 insertions(+), 11 deletions(-)

diff --git a/osu.Game/Beatmaps/WorkingBeatmap.cs b/osu.Game/Beatmaps/WorkingBeatmap.cs
index cdd22e26ae..e5e552eaab 100644
--- a/osu.Game/Beatmaps/WorkingBeatmap.cs
+++ b/osu.Game/Beatmaps/WorkingBeatmap.cs
@@ -41,6 +41,7 @@ namespace osu.Game.Beatmaps
         private readonly Lazy<Waveform> waveform;
         private readonly Lazy<Storyboard> storyboard;
         private readonly Lazy<ISkin> skin;
+        private Track track; // track is not Lazy as we allow transferring and loading multiple times.
 
         protected WorkingBeatmap(BeatmapInfo beatmapInfo, AudioManager audioManager)
         {
@@ -59,13 +60,6 @@ namespace osu.Game.Beatmaps
         public Texture Background => GetBackground(); // Texture uses ref counting, so we want to return a new instance every usage.
         public ISkin Skin => skin.Value;
 
-        #region Load checks
-
-        public virtual bool TrackLoaded => loadedTrack != null;
-        public virtual bool BeatmapLoaded => beatmapLoadTask?.IsCompleted ?? false;
-
-        #endregion
-
         #region Resource getters
 
         protected virtual Waveform GetWaveform() => new Waveform(null);
@@ -107,9 +101,9 @@ namespace osu.Game.Beatmaps
 
         #region Track
 
-        private Track loadedTrack;
+        public virtual bool TrackLoaded => track != null;
 
-        public Track LoadTrack() => loadedTrack = GetBeatmapTrack() ?? GetVirtualTrack(1000);
+        public Track LoadTrack() => track = GetBeatmapTrack() ?? GetVirtualTrack(1000);
 
         public void PrepareTrackForPreviewLooping()
         {
@@ -133,7 +127,7 @@ namespace osu.Game.Beatmaps
         /// across difficulties in the same beatmap set.
         /// </summary>
         /// <param name="track">The track to transfer.</param>
-        public void TransferTrack([NotNull] Track track) => loadedTrack = track ?? throw new ArgumentNullException(nameof(track));
+        public void TransferTrack([NotNull] Track track) => this.track = track ?? throw new ArgumentNullException(nameof(track));
 
         /// <summary>
         /// Get the loaded audio track instance. <see cref="LoadTrack"/> must have first been called.
@@ -146,7 +140,7 @@ namespace osu.Game.Beatmaps
                 if (!TrackLoaded)
                     throw new InvalidOperationException($"Cannot access {nameof(Track)} without first calling {nameof(LoadTrack)}.");
 
-                return loadedTrack;
+                return track;
             }
         }
 
@@ -180,6 +174,8 @@ namespace osu.Game.Beatmaps
 
         #region Beatmap
 
+        public virtual bool BeatmapLoaded => beatmapLoadTask?.IsCompleted ?? false;
+
         public IBeatmap Beatmap
         {
             get

From 53c0a6708f8847e915cab748449cc55c792ea51e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 22 Dec 2021 18:25:09 +0900
Subject: [PATCH 1797/5547] Move public accessor properties to top of file

---
 osu.Game/Beatmaps/WorkingBeatmap.cs | 13 ++++++++-----
 1 file changed, 8 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Beatmaps/WorkingBeatmap.cs b/osu.Game/Beatmaps/WorkingBeatmap.cs
index e5e552eaab..451b4ccac8 100644
--- a/osu.Game/Beatmaps/WorkingBeatmap.cs
+++ b/osu.Game/Beatmaps/WorkingBeatmap.cs
@@ -32,6 +32,14 @@ namespace osu.Game.Beatmaps
         // TODO: remove once the fallback lookup is not required (and access via `working.BeatmapInfo.Metadata` directly).
         public BeatmapMetadata Metadata => BeatmapInfo.Metadata ?? BeatmapSetInfo?.Metadata ?? new BeatmapMetadata();
 
+        public Waveform Waveform => waveform.Value;
+
+        public Storyboard Storyboard => storyboard.Value;
+
+        public Texture Background => GetBackground(); // Texture uses ref counting, so we want to return a new instance every usage.
+
+        public ISkin Skin => skin.Value;
+
         private AudioManager audioManager { get; }
 
         private CancellationTokenSource loadCancellationSource = new CancellationTokenSource();
@@ -55,11 +63,6 @@ namespace osu.Game.Beatmaps
             skin = new Lazy<ISkin>(GetSkin);
         }
 
-        public Waveform Waveform => waveform.Value;
-        public Storyboard Storyboard => storyboard.Value;
-        public Texture Background => GetBackground(); // Texture uses ref counting, so we want to return a new instance every usage.
-        public ISkin Skin => skin.Value;
-
         #region Resource getters
 
         protected virtual Waveform GetWaveform() => new Waveform(null);

From 6330fa5dc5f2300e2b48244a91e2d59ec79d202c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 22 Dec 2021 10:03:58 +0100
Subject: [PATCH 1798/5547] Select newly created control point

---
 .../Components/PathControlPointVisualiser.cs  | 22 +++++++++++-----
 .../Sliders/SliderSelectionBlueprint.cs       | 26 +++++++++++--------
 2 files changed, 31 insertions(+), 17 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 e06fc1510c..b72e2d786b 100644
--- a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointVisualiser.cs
+++ b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointVisualiser.cs
@@ -92,7 +92,7 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders.Components
                         Pieces.Add(new PathControlPointPiece(slider, point).With(d =>
                         {
                             if (allowSelection)
-                                d.RequestSelection = selectPiece;
+                                d.RequestSelection = selectionRequested;
 
                             d.DragStarted = dragStarted;
                             d.DragInProgress = dragInProgress;
@@ -128,6 +128,9 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders.Components
 
         protected override bool OnClick(ClickEvent e)
         {
+            if (Pieces.Any(piece => piece.IsHovered))
+                return false;
+
             foreach (var piece in Pieces)
             {
                 piece.IsSelected.Value = false;
@@ -151,15 +154,22 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders.Components
         {
         }
 
-        private void selectPiece(PathControlPointPiece piece, MouseButtonEvent e)
+        private void selectionRequested(PathControlPointPiece piece, MouseButtonEvent e)
         {
             if (e.Button == MouseButton.Left && inputManager.CurrentState.Keyboard.ControlPressed)
                 piece.IsSelected.Toggle();
             else
-            {
-                foreach (var p in Pieces)
-                    p.IsSelected.Value = p == piece;
-            }
+                SetSelectionTo(piece.ControlPoint);
+        }
+
+        /// <summary>
+        /// Selects the <see cref="PathControlPointPiece"/> corresponding to the given <paramref name="pathControlPoint"/>,
+        /// and deselects all other <see cref="PathControlPointPiece"/>s.
+        /// </summary>
+        public void SetSelectionTo(PathControlPoint pathControlPoint)
+        {
+            foreach (var p in Pieces)
+                p.IsSelected.Value = p.ControlPoint == pathControlPoint;
         }
 
         /// <summary>
diff --git a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/SliderSelectionBlueprint.cs b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/SliderSelectionBlueprint.cs
index 17a62fc61c..de8c0d3b78 100644
--- a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/SliderSelectionBlueprint.cs
+++ b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/SliderSelectionBlueprint.cs
@@ -140,7 +140,8 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders
                 case MouseButton.Left:
                     if (e.ControlPressed && IsSelected)
                     {
-                        placementControlPointIndex = addControlPoint(e.MousePosition);
+                        placementControlPoint = addControlPoint(e.MousePosition);
+                        ControlPointVisualiser?.SetSelectionTo(placementControlPoint);
                         return true; // Stop input from being handled and modifying the selection
                     }
 
@@ -150,11 +151,12 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders
             return false;
         }
 
-        private int? placementControlPointIndex;
+        [CanBeNull]
+        private PathControlPoint placementControlPoint;
 
         protected override bool OnDragStart(DragStartEvent e)
         {
-            if (placementControlPointIndex != null)
+            if (placementControlPoint != null)
             {
                 changeHandler?.BeginChange();
                 return true;
@@ -165,16 +167,16 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders
 
         protected override void OnDrag(DragEvent e)
         {
-            Debug.Assert(placementControlPointIndex != null);
+            Debug.Assert(placementControlPoint != null);
 
-            HitObject.Path.ControlPoints[placementControlPointIndex.Value].Position = e.MousePosition - HitObject.Position;
+            placementControlPoint.Position = e.MousePosition - HitObject.Position;
         }
 
         protected override void OnDragEnd(DragEndEvent e)
         {
-            if (placementControlPointIndex != null)
+            if (placementControlPoint != null)
             {
-                placementControlPointIndex = null;
+                placementControlPoint = null;
                 changeHandler?.EndChange();
             }
         }
@@ -193,7 +195,7 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders
             return false;
         }
 
-        private int addControlPoint(Vector2 position)
+        private PathControlPoint addControlPoint(Vector2 position)
         {
             position -= HitObject.Position;
 
@@ -211,10 +213,12 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders
                 }
             }
 
-            // Move the control points from the insertion index onwards to make room for the insertion
-            controlPoints.Insert(insertionIndex, new PathControlPoint { Position = position });
+            var pathControlPoint = new PathControlPoint { Position = position };
 
-            return insertionIndex;
+            // Move the control points from the insertion index onwards to make room for the insertion
+            controlPoints.Insert(insertionIndex, pathControlPoint);
+
+            return pathControlPoint;
         }
 
         private void removeControlPoints(List<PathControlPoint> toRemove)

From c3fada1926a2c0ca2c3d6352a1548e2a51fdcab1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 22 Dec 2021 10:28:35 +0100
Subject: [PATCH 1799/5547] Replace assertion with soft null check

Surrounding `OnDrag{Start,End}` methods did so already.
---
 .../Edit/Blueprints/Sliders/SliderSelectionBlueprint.cs     | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/SliderSelectionBlueprint.cs b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/SliderSelectionBlueprint.cs
index de8c0d3b78..9caed970b1 100644
--- a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/SliderSelectionBlueprint.cs
+++ b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/SliderSelectionBlueprint.cs
@@ -2,7 +2,6 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System.Collections.Generic;
-using System.Diagnostics;
 using System.Linq;
 using JetBrains.Annotations;
 using osu.Framework.Allocation;
@@ -167,9 +166,8 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders
 
         protected override void OnDrag(DragEvent e)
         {
-            Debug.Assert(placementControlPoint != null);
-
-            placementControlPoint.Position = e.MousePosition - HitObject.Position;
+            if (placementControlPoint != null)
+                placementControlPoint.Position = e.MousePosition - HitObject.Position;
         }
 
         protected override void OnDragEnd(DragEndEvent e)

From 9e17d7d4e312a884c013487d55f6ac049156aa98 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 22 Dec 2021 18:40:37 +0900
Subject: [PATCH 1800/5547] Apply NRT to `WorkingBeatmap`

---
 osu.Game/Beatmaps/IWorkingBeatmap.cs     | 10 ++---
 osu.Game/Beatmaps/WorkingBeatmap.cs      | 50 +++++++++++++-----------
 osu.Game/Beatmaps/WorkingBeatmapCache.cs |  6 +--
 osu.Game/Stores/BeatmapImporter.cs       |  2 +-
 4 files changed, 37 insertions(+), 31 deletions(-)

diff --git a/osu.Game/Beatmaps/IWorkingBeatmap.cs b/osu.Game/Beatmaps/IWorkingBeatmap.cs
index 3bfbbad714..5a8ae45226 100644
--- a/osu.Game/Beatmaps/IWorkingBeatmap.cs
+++ b/osu.Game/Beatmaps/IWorkingBeatmap.cs
@@ -37,12 +37,12 @@ namespace osu.Game.Beatmaps
         /// <summary>
         /// Retrieves the <see cref="IBeatmap"/> which this <see cref="IWorkingBeatmap"/> represents.
         /// </summary>
-        IBeatmap Beatmap { get; }
+        IBeatmap? Beatmap { get; }
 
         /// <summary>
         /// Retrieves the background for this <see cref="IWorkingBeatmap"/>.
         /// </summary>
-        Texture Background { get; }
+        Texture? Background { get; }
 
         /// <summary>
         /// Retrieves the <see cref="Waveform"/> for the <see cref="Track"/> of this <see cref="IWorkingBeatmap"/>.
@@ -57,12 +57,12 @@ namespace osu.Game.Beatmaps
         /// <summary>
         /// Retrieves the <see cref="Skin"/> which this <see cref="IWorkingBeatmap"/> provides.
         /// </summary>
-        ISkin Skin { get; }
+        ISkin? Skin { get; }
 
         /// <summary>
         /// Retrieves the <see cref="Track"/> which this <see cref="IWorkingBeatmap"/> has loaded.
         /// </summary>
-        Track Track { get; }
+        Track? Track { get; }
 
         /// <summary>
         /// Constructs a playable <see cref="IBeatmap"/> from <see cref="Beatmap"/> using the applicable converters for a specific <see cref="RulesetInfo"/>.
@@ -114,7 +114,7 @@ namespace osu.Game.Beatmaps
         /// Returns the stream of the file from the given storage path.
         /// </summary>
         /// <param name="storagePath">The storage path to the file.</param>
-        Stream GetStream(string storagePath);
+        Stream? GetStream(string storagePath);
 
         /// <summary>
         /// Beings loading the contents of this <see cref="IWorkingBeatmap"/> asynchronously.
diff --git a/osu.Game/Beatmaps/WorkingBeatmap.cs b/osu.Game/Beatmaps/WorkingBeatmap.cs
index 451b4ccac8..6d39a294c8 100644
--- a/osu.Game/Beatmaps/WorkingBeatmap.cs
+++ b/osu.Game/Beatmaps/WorkingBeatmap.cs
@@ -8,7 +8,6 @@ using System.IO;
 using System.Linq;
 using System.Threading;
 using System.Threading.Tasks;
-using JetBrains.Annotations;
 using osu.Framework.Audio;
 using osu.Framework.Audio.Track;
 using osu.Framework.Graphics.Textures;
@@ -21,6 +20,8 @@ using osu.Game.Rulesets.UI;
 using osu.Game.Skinning;
 using osu.Game.Storyboards;
 
+#nullable enable
+
 namespace osu.Game.Beatmaps
 {
     [ExcludeFromDynamicCompile]
@@ -30,28 +31,28 @@ namespace osu.Game.Beatmaps
         public readonly BeatmapSetInfo BeatmapSetInfo;
 
         // TODO: remove once the fallback lookup is not required (and access via `working.BeatmapInfo.Metadata` directly).
-        public BeatmapMetadata Metadata => BeatmapInfo.Metadata ?? BeatmapSetInfo?.Metadata ?? new BeatmapMetadata();
+        public BeatmapMetadata Metadata => BeatmapInfo.Metadata ?? BeatmapSetInfo.Metadata;
 
         public Waveform Waveform => waveform.Value;
 
         public Storyboard Storyboard => storyboard.Value;
 
-        public Texture Background => GetBackground(); // Texture uses ref counting, so we want to return a new instance every usage.
+        public Texture? Background => GetBackground(); // Texture uses ref counting, so we want to return a new instance every usage.
 
-        public ISkin Skin => skin.Value;
+        public ISkin? Skin => skin.Value;
 
-        private AudioManager audioManager { get; }
+        private AudioManager? audioManager { get; }
 
-        private CancellationTokenSource loadCancellationSource = new CancellationTokenSource();
+        private CancellationTokenSource? loadCancellationSource;
 
         private readonly object beatmapFetchLock = new object();
 
         private readonly Lazy<Waveform> waveform;
         private readonly Lazy<Storyboard> storyboard;
-        private readonly Lazy<ISkin> skin;
-        private Track track; // track is not Lazy as we allow transferring and loading multiple times.
+        private readonly Lazy<ISkin?> skin;
+        private Track? track; // track is not Lazy as we allow transferring and loading multiple times.
 
-        protected WorkingBeatmap(BeatmapInfo beatmapInfo, AudioManager audioManager)
+        protected WorkingBeatmap(BeatmapInfo beatmapInfo, AudioManager? audioManager)
         {
             this.audioManager = audioManager;
 
@@ -60,7 +61,7 @@ namespace osu.Game.Beatmaps
 
             waveform = new Lazy<Waveform>(GetWaveform);
             storyboard = new Lazy<Storyboard>(GetStoryboard);
-            skin = new Lazy<ISkin>(GetSkin);
+            skin = new Lazy<ISkin?>(GetSkin);
         }
 
         #region Resource getters
@@ -68,9 +69,9 @@ namespace osu.Game.Beatmaps
         protected virtual Waveform GetWaveform() => new Waveform(null);
         protected virtual Storyboard GetStoryboard() => new Storyboard { BeatmapInfo = BeatmapInfo };
 
-        protected abstract IBeatmap GetBeatmap();
-        protected abstract Texture GetBackground();
-        protected abstract Track GetBeatmapTrack();
+        protected abstract IBeatmap? GetBeatmap();
+        protected abstract Texture? GetBackground();
+        protected abstract Track? GetBeatmapTrack();
 
         /// <summary>
         /// Creates a new skin instance for this beatmap.
@@ -80,7 +81,7 @@ namespace osu.Game.Beatmaps
         /// (e.g. for editing purposes, to avoid state pollution).
         /// For standard reading purposes, <see cref="Skin"/> should always be used directly.
         /// </remarks>
-        protected internal abstract ISkin GetSkin();
+        protected internal abstract ISkin? GetSkin();
 
         #endregion
 
@@ -93,7 +94,6 @@ namespace osu.Game.Beatmaps
             lock (beatmapFetchLock)
             {
                 loadCancellationSource?.Cancel();
-                loadCancellationSource = new CancellationTokenSource();
 
                 if (beatmapLoadTask?.IsCompleted != true)
                     beatmapLoadTask = null;
@@ -130,7 +130,7 @@ namespace osu.Game.Beatmaps
         /// across difficulties in the same beatmap set.
         /// </summary>
         /// <param name="track">The track to transfer.</param>
-        public void TransferTrack([NotNull] Track track) => this.track = track ?? throw new ArgumentNullException(nameof(track));
+        public void TransferTrack(Track track) => this.track = track ?? throw new ArgumentNullException(nameof(track));
 
         /// <summary>
         /// Get the loaded audio track instance. <see cref="LoadTrack"/> must have first been called.
@@ -143,6 +143,9 @@ namespace osu.Game.Beatmaps
                 if (!TrackLoaded)
                     throw new InvalidOperationException($"Cannot access {nameof(Track)} without first calling {nameof(LoadTrack)}.");
 
+                // Covered by TrackLoaded call above.
+                Debug.Assert(track != null);
+
                 return track;
             }
         }
@@ -170,7 +173,7 @@ namespace osu.Game.Beatmaps
                     break;
             }
 
-            return audioManager.Tracks.GetVirtual(length);
+            return audioManager?.Tracks.GetVirtual(length) ?? throw new InvalidOperationException($"Attempted to get virtual track without providing an {nameof(AudioManager)}");
         }
 
         #endregion
@@ -179,7 +182,7 @@ namespace osu.Game.Beatmaps
 
         public virtual bool BeatmapLoaded => beatmapLoadTask?.IsCompleted ?? false;
 
-        public IBeatmap Beatmap
+        public IBeatmap? Beatmap
         {
             get
             {
@@ -204,7 +207,7 @@ namespace osu.Game.Beatmaps
             }
         }
 
-        private Task<IBeatmap> beatmapLoadTask;
+        private Task<IBeatmap>? beatmapLoadTask;
 
         private Task<IBeatmap> loadBeatmapAsync()
         {
@@ -222,7 +225,7 @@ namespace osu.Game.Beatmaps
                     b.BeatmapInfo = BeatmapInfo;
 
                     return b;
-                }, loadCancellationSource.Token, TaskCreationOptions.LongRunning, TaskScheduler.Default);
+                }, (loadCancellationSource = new CancellationTokenSource()).Token, TaskCreationOptions.LongRunning, TaskScheduler.Default);
             }
         }
 
@@ -230,7 +233,7 @@ namespace osu.Game.Beatmaps
 
         #region Playable beatmap
 
-        public IBeatmap GetPlayableBeatmap(IRulesetInfo ruleset, IReadOnlyList<Mod> mods = null)
+        public IBeatmap GetPlayableBeatmap(IRulesetInfo ruleset, IReadOnlyList<Mod>? mods = null)
         {
             try
             {
@@ -253,6 +256,9 @@ namespace osu.Game.Beatmaps
             if (rulesetInstance == null)
                 throw new RulesetLoadException("Creating ruleset instance failed when attempting to create playable beatmap.");
 
+            if (Beatmap == null)
+                throw new InvalidOperationException("Beatmap could not be loaded.");
+
             IBeatmapConverter converter = CreateBeatmapConverter(Beatmap, rulesetInstance);
 
             // Check if the beatmap can be converted
@@ -332,7 +338,7 @@ namespace osu.Game.Beatmaps
 
         public override string ToString() => BeatmapInfo.ToString();
 
-        public abstract Stream GetStream(string storagePath);
+        public abstract Stream? GetStream(string storagePath);
 
         IBeatmapInfo IWorkingBeatmap.BeatmapInfo => BeatmapInfo;
 
diff --git a/osu.Game/Beatmaps/WorkingBeatmapCache.cs b/osu.Game/Beatmaps/WorkingBeatmapCache.cs
index 514551e184..3174754b76 100644
--- a/osu.Game/Beatmaps/WorkingBeatmapCache.cs
+++ b/osu.Game/Beatmaps/WorkingBeatmapCache.cs
@@ -180,17 +180,17 @@ namespace osu.Game.Beatmaps
             protected override Waveform GetWaveform()
             {
                 if (string.IsNullOrEmpty(Metadata?.AudioFile))
-                    return null;
+                    return base.GetWaveform();
 
                 try
                 {
                     var trackData = GetStream(BeatmapSetInfo.GetPathForFile(Metadata.AudioFile));
-                    return trackData == null ? null : new Waveform(trackData);
+                    return trackData == null ? base.GetWaveform() : new Waveform(trackData);
                 }
                 catch (Exception e)
                 {
                     Logger.Error(e, "Waveform failed to load");
-                    return null;
+                    return base.GetWaveform();
                 }
             }
 
diff --git a/osu.Game/Stores/BeatmapImporter.cs b/osu.Game/Stores/BeatmapImporter.cs
index 8ab6941885..ec0db772de 100644
--- a/osu.Game/Stores/BeatmapImporter.cs
+++ b/osu.Game/Stores/BeatmapImporter.cs
@@ -324,7 +324,7 @@ namespace osu.Game.Stores
 
             protected override IBeatmap GetBeatmap() => beatmap;
             protected override Texture? GetBackground() => null;
-            protected override Track? GetBeatmapTrack() => null;
+            protected override Track GetBeatmapTrack() => null!;
             protected internal override ISkin? GetSkin() => null;
             public override Stream? GetStream(string storagePath) => null;
         }

From ef20182a34845d18b22a6e90648123c4465d6c4f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 22 Dec 2021 10:57:39 +0100
Subject: [PATCH 1801/5547] Rewrite test to check selection state during and
 after new control point placement

---
 .../Editor/TestSceneSliderControlPointPiece.cs        | 11 +++++++++--
 1 file changed, 9 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderControlPointPiece.cs b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderControlPointPiece.cs
index 74d6d23348..93ee9b515b 100644
--- a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderControlPointPiece.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderControlPointPiece.cs
@@ -100,13 +100,20 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
             AddStep("ctrl+click to create new point", () =>
             {
                 InputManager.PressKey(Key.ControlLeft);
-                InputManager.Click(MouseButton.Left);
-                InputManager.ReleaseKey(Key.ControlLeft);
+                InputManager.PressButton(MouseButton.Left);
             });
             AddAssert("slider has 6 control points", () => slider.Path.ControlPoints.Count == 6);
             assertSelectionCount(1);
             assertSelected(3);
 
+            AddStep("release ctrl+click", () =>
+            {
+                InputManager.ReleaseButton(MouseButton.Left);
+                InputManager.ReleaseKey(Key.ControlLeft);
+            });
+            assertSelectionCount(1);
+            assertSelected(3);
+
             void assertSelectionCount(int count) =>
                 AddAssert($"{count} control point pieces selected", () => this.ChildrenOfType<PathControlPointPiece>().Count(piece => piece.IsSelected.Value) == count);
 

From bc47801cbb45495def587d8ff05cda0c11c1d2e8 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 22 Dec 2021 19:14:18 +0900
Subject: [PATCH 1802/5547] Revert "Apply NRT to `WorkingBeatmap`"

This reverts commit 9e17d7d4e312a884c013487d55f6ac049156aa98.
---
 osu.Game/Beatmaps/IWorkingBeatmap.cs     | 10 ++---
 osu.Game/Beatmaps/WorkingBeatmap.cs      | 50 +++++++++++-------------
 osu.Game/Beatmaps/WorkingBeatmapCache.cs |  6 +--
 osu.Game/Stores/BeatmapImporter.cs       |  2 +-
 4 files changed, 31 insertions(+), 37 deletions(-)

diff --git a/osu.Game/Beatmaps/IWorkingBeatmap.cs b/osu.Game/Beatmaps/IWorkingBeatmap.cs
index 5a8ae45226..3bfbbad714 100644
--- a/osu.Game/Beatmaps/IWorkingBeatmap.cs
+++ b/osu.Game/Beatmaps/IWorkingBeatmap.cs
@@ -37,12 +37,12 @@ namespace osu.Game.Beatmaps
         /// <summary>
         /// Retrieves the <see cref="IBeatmap"/> which this <see cref="IWorkingBeatmap"/> represents.
         /// </summary>
-        IBeatmap? Beatmap { get; }
+        IBeatmap Beatmap { get; }
 
         /// <summary>
         /// Retrieves the background for this <see cref="IWorkingBeatmap"/>.
         /// </summary>
-        Texture? Background { get; }
+        Texture Background { get; }
 
         /// <summary>
         /// Retrieves the <see cref="Waveform"/> for the <see cref="Track"/> of this <see cref="IWorkingBeatmap"/>.
@@ -57,12 +57,12 @@ namespace osu.Game.Beatmaps
         /// <summary>
         /// Retrieves the <see cref="Skin"/> which this <see cref="IWorkingBeatmap"/> provides.
         /// </summary>
-        ISkin? Skin { get; }
+        ISkin Skin { get; }
 
         /// <summary>
         /// Retrieves the <see cref="Track"/> which this <see cref="IWorkingBeatmap"/> has loaded.
         /// </summary>
-        Track? Track { get; }
+        Track Track { get; }
 
         /// <summary>
         /// Constructs a playable <see cref="IBeatmap"/> from <see cref="Beatmap"/> using the applicable converters for a specific <see cref="RulesetInfo"/>.
@@ -114,7 +114,7 @@ namespace osu.Game.Beatmaps
         /// Returns the stream of the file from the given storage path.
         /// </summary>
         /// <param name="storagePath">The storage path to the file.</param>
-        Stream? GetStream(string storagePath);
+        Stream GetStream(string storagePath);
 
         /// <summary>
         /// Beings loading the contents of this <see cref="IWorkingBeatmap"/> asynchronously.
diff --git a/osu.Game/Beatmaps/WorkingBeatmap.cs b/osu.Game/Beatmaps/WorkingBeatmap.cs
index 6d39a294c8..451b4ccac8 100644
--- a/osu.Game/Beatmaps/WorkingBeatmap.cs
+++ b/osu.Game/Beatmaps/WorkingBeatmap.cs
@@ -8,6 +8,7 @@ using System.IO;
 using System.Linq;
 using System.Threading;
 using System.Threading.Tasks;
+using JetBrains.Annotations;
 using osu.Framework.Audio;
 using osu.Framework.Audio.Track;
 using osu.Framework.Graphics.Textures;
@@ -20,8 +21,6 @@ using osu.Game.Rulesets.UI;
 using osu.Game.Skinning;
 using osu.Game.Storyboards;
 
-#nullable enable
-
 namespace osu.Game.Beatmaps
 {
     [ExcludeFromDynamicCompile]
@@ -31,28 +30,28 @@ namespace osu.Game.Beatmaps
         public readonly BeatmapSetInfo BeatmapSetInfo;
 
         // TODO: remove once the fallback lookup is not required (and access via `working.BeatmapInfo.Metadata` directly).
-        public BeatmapMetadata Metadata => BeatmapInfo.Metadata ?? BeatmapSetInfo.Metadata;
+        public BeatmapMetadata Metadata => BeatmapInfo.Metadata ?? BeatmapSetInfo?.Metadata ?? new BeatmapMetadata();
 
         public Waveform Waveform => waveform.Value;
 
         public Storyboard Storyboard => storyboard.Value;
 
-        public Texture? Background => GetBackground(); // Texture uses ref counting, so we want to return a new instance every usage.
+        public Texture Background => GetBackground(); // Texture uses ref counting, so we want to return a new instance every usage.
 
-        public ISkin? Skin => skin.Value;
+        public ISkin Skin => skin.Value;
 
-        private AudioManager? audioManager { get; }
+        private AudioManager audioManager { get; }
 
-        private CancellationTokenSource? loadCancellationSource;
+        private CancellationTokenSource loadCancellationSource = new CancellationTokenSource();
 
         private readonly object beatmapFetchLock = new object();
 
         private readonly Lazy<Waveform> waveform;
         private readonly Lazy<Storyboard> storyboard;
-        private readonly Lazy<ISkin?> skin;
-        private Track? track; // track is not Lazy as we allow transferring and loading multiple times.
+        private readonly Lazy<ISkin> skin;
+        private Track track; // track is not Lazy as we allow transferring and loading multiple times.
 
-        protected WorkingBeatmap(BeatmapInfo beatmapInfo, AudioManager? audioManager)
+        protected WorkingBeatmap(BeatmapInfo beatmapInfo, AudioManager audioManager)
         {
             this.audioManager = audioManager;
 
@@ -61,7 +60,7 @@ namespace osu.Game.Beatmaps
 
             waveform = new Lazy<Waveform>(GetWaveform);
             storyboard = new Lazy<Storyboard>(GetStoryboard);
-            skin = new Lazy<ISkin?>(GetSkin);
+            skin = new Lazy<ISkin>(GetSkin);
         }
 
         #region Resource getters
@@ -69,9 +68,9 @@ namespace osu.Game.Beatmaps
         protected virtual Waveform GetWaveform() => new Waveform(null);
         protected virtual Storyboard GetStoryboard() => new Storyboard { BeatmapInfo = BeatmapInfo };
 
-        protected abstract IBeatmap? GetBeatmap();
-        protected abstract Texture? GetBackground();
-        protected abstract Track? GetBeatmapTrack();
+        protected abstract IBeatmap GetBeatmap();
+        protected abstract Texture GetBackground();
+        protected abstract Track GetBeatmapTrack();
 
         /// <summary>
         /// Creates a new skin instance for this beatmap.
@@ -81,7 +80,7 @@ namespace osu.Game.Beatmaps
         /// (e.g. for editing purposes, to avoid state pollution).
         /// For standard reading purposes, <see cref="Skin"/> should always be used directly.
         /// </remarks>
-        protected internal abstract ISkin? GetSkin();
+        protected internal abstract ISkin GetSkin();
 
         #endregion
 
@@ -94,6 +93,7 @@ namespace osu.Game.Beatmaps
             lock (beatmapFetchLock)
             {
                 loadCancellationSource?.Cancel();
+                loadCancellationSource = new CancellationTokenSource();
 
                 if (beatmapLoadTask?.IsCompleted != true)
                     beatmapLoadTask = null;
@@ -130,7 +130,7 @@ namespace osu.Game.Beatmaps
         /// across difficulties in the same beatmap set.
         /// </summary>
         /// <param name="track">The track to transfer.</param>
-        public void TransferTrack(Track track) => this.track = track ?? throw new ArgumentNullException(nameof(track));
+        public void TransferTrack([NotNull] Track track) => this.track = track ?? throw new ArgumentNullException(nameof(track));
 
         /// <summary>
         /// Get the loaded audio track instance. <see cref="LoadTrack"/> must have first been called.
@@ -143,9 +143,6 @@ namespace osu.Game.Beatmaps
                 if (!TrackLoaded)
                     throw new InvalidOperationException($"Cannot access {nameof(Track)} without first calling {nameof(LoadTrack)}.");
 
-                // Covered by TrackLoaded call above.
-                Debug.Assert(track != null);
-
                 return track;
             }
         }
@@ -173,7 +170,7 @@ namespace osu.Game.Beatmaps
                     break;
             }
 
-            return audioManager?.Tracks.GetVirtual(length) ?? throw new InvalidOperationException($"Attempted to get virtual track without providing an {nameof(AudioManager)}");
+            return audioManager.Tracks.GetVirtual(length);
         }
 
         #endregion
@@ -182,7 +179,7 @@ namespace osu.Game.Beatmaps
 
         public virtual bool BeatmapLoaded => beatmapLoadTask?.IsCompleted ?? false;
 
-        public IBeatmap? Beatmap
+        public IBeatmap Beatmap
         {
             get
             {
@@ -207,7 +204,7 @@ namespace osu.Game.Beatmaps
             }
         }
 
-        private Task<IBeatmap>? beatmapLoadTask;
+        private Task<IBeatmap> beatmapLoadTask;
 
         private Task<IBeatmap> loadBeatmapAsync()
         {
@@ -225,7 +222,7 @@ namespace osu.Game.Beatmaps
                     b.BeatmapInfo = BeatmapInfo;
 
                     return b;
-                }, (loadCancellationSource = new CancellationTokenSource()).Token, TaskCreationOptions.LongRunning, TaskScheduler.Default);
+                }, loadCancellationSource.Token, TaskCreationOptions.LongRunning, TaskScheduler.Default);
             }
         }
 
@@ -233,7 +230,7 @@ namespace osu.Game.Beatmaps
 
         #region Playable beatmap
 
-        public IBeatmap GetPlayableBeatmap(IRulesetInfo ruleset, IReadOnlyList<Mod>? mods = null)
+        public IBeatmap GetPlayableBeatmap(IRulesetInfo ruleset, IReadOnlyList<Mod> mods = null)
         {
             try
             {
@@ -256,9 +253,6 @@ namespace osu.Game.Beatmaps
             if (rulesetInstance == null)
                 throw new RulesetLoadException("Creating ruleset instance failed when attempting to create playable beatmap.");
 
-            if (Beatmap == null)
-                throw new InvalidOperationException("Beatmap could not be loaded.");
-
             IBeatmapConverter converter = CreateBeatmapConverter(Beatmap, rulesetInstance);
 
             // Check if the beatmap can be converted
@@ -338,7 +332,7 @@ namespace osu.Game.Beatmaps
 
         public override string ToString() => BeatmapInfo.ToString();
 
-        public abstract Stream? GetStream(string storagePath);
+        public abstract Stream GetStream(string storagePath);
 
         IBeatmapInfo IWorkingBeatmap.BeatmapInfo => BeatmapInfo;
 
diff --git a/osu.Game/Beatmaps/WorkingBeatmapCache.cs b/osu.Game/Beatmaps/WorkingBeatmapCache.cs
index 3174754b76..514551e184 100644
--- a/osu.Game/Beatmaps/WorkingBeatmapCache.cs
+++ b/osu.Game/Beatmaps/WorkingBeatmapCache.cs
@@ -180,17 +180,17 @@ namespace osu.Game.Beatmaps
             protected override Waveform GetWaveform()
             {
                 if (string.IsNullOrEmpty(Metadata?.AudioFile))
-                    return base.GetWaveform();
+                    return null;
 
                 try
                 {
                     var trackData = GetStream(BeatmapSetInfo.GetPathForFile(Metadata.AudioFile));
-                    return trackData == null ? base.GetWaveform() : new Waveform(trackData);
+                    return trackData == null ? null : new Waveform(trackData);
                 }
                 catch (Exception e)
                 {
                     Logger.Error(e, "Waveform failed to load");
-                    return base.GetWaveform();
+                    return null;
                 }
             }
 
diff --git a/osu.Game/Stores/BeatmapImporter.cs b/osu.Game/Stores/BeatmapImporter.cs
index ec0db772de..8ab6941885 100644
--- a/osu.Game/Stores/BeatmapImporter.cs
+++ b/osu.Game/Stores/BeatmapImporter.cs
@@ -324,7 +324,7 @@ namespace osu.Game.Stores
 
             protected override IBeatmap GetBeatmap() => beatmap;
             protected override Texture? GetBackground() => null;
-            protected override Track GetBeatmapTrack() => null!;
+            protected override Track? GetBeatmapTrack() => null;
             protected internal override ISkin? GetSkin() => null;
             public override Stream? GetStream(string storagePath) => null;
         }

From bb9877adab0b77202875ed74e1d8209ce46b4fea Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 22 Dec 2021 20:48:48 +0900
Subject: [PATCH 1803/5547] Reapply `IWorkingBeatmap` nullability fixed

---
 osu.Game/Beatmaps/IWorkingBeatmap.cs | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Beatmaps/IWorkingBeatmap.cs b/osu.Game/Beatmaps/IWorkingBeatmap.cs
index 3bfbbad714..5a8ae45226 100644
--- a/osu.Game/Beatmaps/IWorkingBeatmap.cs
+++ b/osu.Game/Beatmaps/IWorkingBeatmap.cs
@@ -37,12 +37,12 @@ namespace osu.Game.Beatmaps
         /// <summary>
         /// Retrieves the <see cref="IBeatmap"/> which this <see cref="IWorkingBeatmap"/> represents.
         /// </summary>
-        IBeatmap Beatmap { get; }
+        IBeatmap? Beatmap { get; }
 
         /// <summary>
         /// Retrieves the background for this <see cref="IWorkingBeatmap"/>.
         /// </summary>
-        Texture Background { get; }
+        Texture? Background { get; }
 
         /// <summary>
         /// Retrieves the <see cref="Waveform"/> for the <see cref="Track"/> of this <see cref="IWorkingBeatmap"/>.
@@ -57,12 +57,12 @@ namespace osu.Game.Beatmaps
         /// <summary>
         /// Retrieves the <see cref="Skin"/> which this <see cref="IWorkingBeatmap"/> provides.
         /// </summary>
-        ISkin Skin { get; }
+        ISkin? Skin { get; }
 
         /// <summary>
         /// Retrieves the <see cref="Track"/> which this <see cref="IWorkingBeatmap"/> has loaded.
         /// </summary>
-        Track Track { get; }
+        Track? Track { get; }
 
         /// <summary>
         /// Constructs a playable <see cref="IBeatmap"/> from <see cref="Beatmap"/> using the applicable converters for a specific <see cref="RulesetInfo"/>.
@@ -114,7 +114,7 @@ namespace osu.Game.Beatmaps
         /// Returns the stream of the file from the given storage path.
         /// </summary>
         /// <param name="storagePath">The storage path to the file.</param>
-        Stream GetStream(string storagePath);
+        Stream? GetStream(string storagePath);
 
         /// <summary>
         /// Beings loading the contents of this <see cref="IWorkingBeatmap"/> asynchronously.

From f179ff33c991e1122cbbb62e4e6bbb704d04c7ff Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 22 Dec 2021 21:01:33 +0900
Subject: [PATCH 1804/5547] Remove all NRT changes

This reverts commit bb9877adab0b77202875ed74e1d8209ce46b4fea.
---
 osu.Game/Beatmaps/IWorkingBeatmap.cs | 14 ++++++--------
 1 file changed, 6 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Beatmaps/IWorkingBeatmap.cs b/osu.Game/Beatmaps/IWorkingBeatmap.cs
index 5a8ae45226..3e2868470a 100644
--- a/osu.Game/Beatmaps/IWorkingBeatmap.cs
+++ b/osu.Game/Beatmaps/IWorkingBeatmap.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 enable
-
 using System.Collections.Generic;
 using System.IO;
 using System.Threading;
@@ -37,12 +35,12 @@ namespace osu.Game.Beatmaps
         /// <summary>
         /// Retrieves the <see cref="IBeatmap"/> which this <see cref="IWorkingBeatmap"/> represents.
         /// </summary>
-        IBeatmap? Beatmap { get; }
+        IBeatmap Beatmap { get; }
 
         /// <summary>
         /// Retrieves the background for this <see cref="IWorkingBeatmap"/>.
         /// </summary>
-        Texture? Background { get; }
+        Texture Background { get; }
 
         /// <summary>
         /// Retrieves the <see cref="Waveform"/> for the <see cref="Track"/> of this <see cref="IWorkingBeatmap"/>.
@@ -57,12 +55,12 @@ namespace osu.Game.Beatmaps
         /// <summary>
         /// Retrieves the <see cref="Skin"/> which this <see cref="IWorkingBeatmap"/> provides.
         /// </summary>
-        ISkin? Skin { get; }
+        ISkin Skin { get; }
 
         /// <summary>
         /// Retrieves the <see cref="Track"/> which this <see cref="IWorkingBeatmap"/> has loaded.
         /// </summary>
-        Track? Track { get; }
+        Track Track { get; }
 
         /// <summary>
         /// Constructs a playable <see cref="IBeatmap"/> from <see cref="Beatmap"/> using the applicable converters for a specific <see cref="RulesetInfo"/>.
@@ -81,7 +79,7 @@ namespace osu.Game.Beatmaps
         /// <param name="mods">The <see cref="Mod"/>s to apply to the <see cref="IBeatmap"/>.</param>
         /// <returns>The converted <see cref="IBeatmap"/>.</returns>
         /// <exception cref="BeatmapInvalidForRulesetException">If <see cref="Beatmap"/> could not be converted to <paramref name="ruleset"/>.</exception>
-        IBeatmap GetPlayableBeatmap(IRulesetInfo ruleset, IReadOnlyList<Mod>? mods = null);
+        IBeatmap GetPlayableBeatmap(IRulesetInfo ruleset, IReadOnlyList<Mod> mods = null);
 
         /// <summary>
         /// Constructs a playable <see cref="IBeatmap"/> from <see cref="Beatmap"/> using the applicable converters for a specific <see cref="RulesetInfo"/>.
@@ -114,7 +112,7 @@ namespace osu.Game.Beatmaps
         /// Returns the stream of the file from the given storage path.
         /// </summary>
         /// <param name="storagePath">The storage path to the file.</param>
-        Stream? GetStream(string storagePath);
+        Stream GetStream(string storagePath);
 
         /// <summary>
         /// Beings loading the contents of this <see cref="IWorkingBeatmap"/> asynchronously.

From 02fa1c21b74dc42a329839a119137f046ae69563 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 22 Dec 2021 15:02:59 +0100
Subject: [PATCH 1805/5547] Adjust existing placeholder test to demonstrate
 failure case

---
 .../Online/TestSceneBeatmapListingOverlay.cs    | 17 +++++++++++++----
 1 file changed, 13 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneBeatmapListingOverlay.cs b/osu.Game.Tests/Visual/Online/TestSceneBeatmapListingOverlay.cs
index 80f7d0ca29..966f2f3610 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneBeatmapListingOverlay.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneBeatmapListingOverlay.cs
@@ -7,6 +7,7 @@ using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Testing;
+using osu.Game.Beatmaps.Drawables.Cards;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests;
@@ -110,17 +111,25 @@ namespace osu.Game.Tests.Visual.Online
         public void TestNoBeatmapsPlaceholder()
         {
             AddStep("fetch for 0 beatmaps", () => fetchFor());
-            AddUntilStep("placeholder shown", () => overlay.ChildrenOfType<BeatmapListingOverlay.NotFoundDrawable>().SingleOrDefault()?.IsPresent == true);
+            placeholderShown();
 
-            AddStep("fetch for 1 beatmap", () => fetchFor(CreateAPIBeatmapSet(Ruleset.Value)));
+            AddStep("show many results", () => fetchFor(Enumerable.Repeat(CreateAPIBeatmapSet(Ruleset.Value), 100).ToArray()));
+            AddUntilStep("wait for loaded", () => this.ChildrenOfType<BeatmapCard>().Count() == 100);
             AddUntilStep("placeholder hidden", () => !overlay.ChildrenOfType<BeatmapListingOverlay.NotFoundDrawable>().Any(d => d.IsPresent));
 
             AddStep("fetch for 0 beatmaps", () => fetchFor());
-            AddUntilStep("placeholder shown", () => overlay.ChildrenOfType<BeatmapListingOverlay.NotFoundDrawable>().SingleOrDefault()?.IsPresent == true);
+            placeholderShown();
 
             // fetch once more to ensure nothing happens in displaying placeholder again when it already is present.
             AddStep("fetch for 0 beatmaps again", () => fetchFor());
-            AddUntilStep("placeholder shown", () => overlay.ChildrenOfType<BeatmapListingOverlay.NotFoundDrawable>().SingleOrDefault()?.IsPresent == true);
+            placeholderShown();
+
+            void placeholderShown() =>
+                AddUntilStep("placeholder shown", () =>
+                {
+                    var notFoundDrawable = overlay.ChildrenOfType<BeatmapListingOverlay.NotFoundDrawable>().SingleOrDefault();
+                    return notFoundDrawable != null && notFoundDrawable.IsPresent && notFoundDrawable.Parent.DrawHeight > 0;
+                });
         }
 
         [Test]

From 25e38560ce302889df60029473403ed5a9e91739 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 22 Dec 2021 15:05:23 +0100
Subject: [PATCH 1806/5547] Fix placeholder drawables on beatmap listing not
 always hiding correctly

`BeatmapListingOverlay.addContentToPlaceholder()`, in order to make
transitions between different beatmap listing content (whether it is
actual cards, or placeholders for no beatmaps found/supporter-specific
filters chosen), would set `BypassAutoSizeAxes = Y` on content as it is
fading out, to make the transition smoother. The property in question
was supposed to be getting restored to `None` on the next show.

In testing scenarios, it sometimes turned out that this wasn't the case,
therefore making the placeholders effectively not show - while they
were present and fully opaque, they would be the only child of
an auto-sized container with `BypassAutoSizeAxes = Y`, so the parent
auto-sized to a zero height, which logically follows from the premise,
but is not what was desired.

This in turn was caused by the fact that the `BypassAutoSizeAxes = Y`
set was scheduled, and sometimes it would be scheduled in such a way
that the drawable would cease to be present on the next frame due to its
alpha being past the cutoff point of 0.0001. Therefore the scheduled set
would not execute until the *next* time the placeholder was shown,
therefore causing the bug.

Fix by ensuring that the placeholder drawables are always present if
their schedulers have any tasks enqueued, on top of the usual checks of
alpha and scale performed via the base implementation.
---
 osu.Game/Overlays/BeatmapListingOverlay.cs | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/osu.Game/Overlays/BeatmapListingOverlay.cs b/osu.Game/Overlays/BeatmapListingOverlay.cs
index c4d1d62250..d07f7c8f8f 100644
--- a/osu.Game/Overlays/BeatmapListingOverlay.cs
+++ b/osu.Game/Overlays/BeatmapListingOverlay.cs
@@ -217,6 +217,10 @@ namespace osu.Game.Overlays
 
         public class NotFoundDrawable : CompositeDrawable
         {
+            // required for scheduled tasks to complete correctly
+            // (see `addContentToPlaceholder()` and the scheduled `BypassAutoSizeAxes` set during fade-out in outer class above)
+            public override bool IsPresent => base.IsPresent || Scheduler.HasPendingTasks;
+
             public NotFoundDrawable()
             {
                 RelativeSizeAxes = Axes.X;
@@ -261,6 +265,10 @@ namespace osu.Game.Overlays
         // (https://github.com/ppy/osu-framework/issues/4530)
         public class SupporterRequiredDrawable : CompositeDrawable
         {
+            // required for scheduled tasks to complete correctly
+            // (see `addContentToPlaceholder()` and the scheduled `BypassAutoSizeAxes` set during fade-out in outer class above)
+            public override bool IsPresent => base.IsPresent || Scheduler.HasPendingTasks;
+
             private LinkFlowContainer supporterRequiredText;
 
             public SupporterRequiredDrawable()

From d69552fbcf1d2e5b29a6112d4bef78c5b6f61e3e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 23 Dec 2021 13:21:10 +0900
Subject: [PATCH 1807/5547] Fix potential crash from cross-thread drawable
 mutation in collection management

As seen at https://github.com/peppy/osu/runs/4613800663?check_suite_focus=true.
---
 osu.Game/Collections/DrawableCollectionListItem.cs | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Collections/DrawableCollectionListItem.cs b/osu.Game/Collections/DrawableCollectionListItem.cs
index 988a3443c3..e2ec25337e 100644
--- a/osu.Game/Collections/DrawableCollectionListItem.cs
+++ b/osu.Game/Collections/DrawableCollectionListItem.cs
@@ -102,7 +102,6 @@ namespace osu.Game.Collections
                                 RelativeSizeAxes = Axes.Both,
                                 Size = Vector2.One,
                                 CornerRadius = item_height / 2,
-                                Current = collection.Name,
                                 PlaceholderText = IsCreated.Value ? string.Empty : "Create a new collection"
                             },
                         }
@@ -114,6 +113,9 @@ namespace osu.Game.Collections
             {
                 base.LoadComplete();
 
+                // Bind late, as the collection name may change externally while still loading.
+                textBox.Current = collection.Name;
+
                 collectionName.BindValueChanged(_ => createNewCollection(), true);
                 IsCreated.BindValueChanged(created => textBoxPaddingContainer.Padding = new MarginPadding { Right = created.NewValue ? button_width : 0 }, true);
             }

From d31c9db08bb021ca7761335e0607116ac3a5fd39 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 23 Dec 2021 13:25:23 +0900
Subject: [PATCH 1808/5547] Adjust testing methodology to improve reliability
 of mosue wheel volume adjust tests

There was previously a potential in headless runs for timing
discrepancies to cause the volume to never get adjusted.

As seen at https://github.com/peppy/osu/runs/4604610951?check_suite_focus=true.
---
 .../TestSceneMouseWheelVolumeAdjust.cs        | 22 ++++++++++++-------
 1 file changed, 14 insertions(+), 8 deletions(-)

diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneMouseWheelVolumeAdjust.cs b/osu.Game.Tests/Visual/Navigation/TestSceneMouseWheelVolumeAdjust.cs
index 9e684e4f10..b3b80147ca 100644
--- a/osu.Game.Tests/Visual/Navigation/TestSceneMouseWheelVolumeAdjust.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneMouseWheelVolumeAdjust.cs
@@ -25,8 +25,11 @@ namespace osu.Game.Tests.Visual.Navigation
         public void TestAdjustVolumeFromMainMenu()
         {
             // First scroll makes volume controls appear, second adjusts volume.
-            AddRepeatStep("Adjust volume using mouse wheel", () => InputManager.ScrollVerticalBy(5), 2);
-            AddUntilStep("Volume is above zero", () => Game.Audio.AggregateVolume.Value > 0);
+            AddUntilStep("Adjust volume using mouse wheel", () =>
+            {
+                InputManager.ScrollVerticalBy(5);
+                return Game.Audio.AggregateVolume.Value > 0;
+            });
         }
 
         [Test]
@@ -35,7 +38,11 @@ namespace osu.Game.Tests.Visual.Navigation
             loadToPlayerNonBreakTime();
 
             // First scroll makes volume controls appear, second adjusts volume.
-            AddRepeatStep("Adjust volume using mouse wheel", () => InputManager.ScrollVerticalBy(5), 2);
+            AddUntilStep("Adjust volume using mouse wheel", () =>
+            {
+                InputManager.ScrollVerticalBy(5);
+                return Game.Audio.AggregateVolume.Value > 0;
+            });
             AddAssert("Volume is above zero", () => Game.Audio.Volume.Value > 0);
         }
 
@@ -47,7 +54,7 @@ namespace osu.Game.Tests.Visual.Navigation
             loadToPlayerNonBreakTime();
 
             // First scroll makes volume controls appear, second adjusts volume.
-            AddRepeatStep("Adjust volume using mouse wheel", () => InputManager.ScrollVerticalBy(5), 2);
+            AddRepeatStep("Adjust volume using mouse wheel", () => InputManager.ScrollVerticalBy(5), 10);
             AddAssert("Volume is still zero", () => Game.Audio.Volume.Value == 0);
         }
 
@@ -59,14 +66,13 @@ namespace osu.Game.Tests.Visual.Navigation
             loadToPlayerNonBreakTime();
 
             // First scroll makes volume controls appear, second adjusts volume.
-            AddRepeatStep("Adjust volume using mouse wheel holding alt", () =>
+            AddUntilStep("Adjust volume using mouse wheel holding alt", () =>
             {
                 InputManager.PressKey(Key.AltLeft);
                 InputManager.ScrollVerticalBy(5);
                 InputManager.ReleaseKey(Key.AltLeft);
-            }, 2);
-
-            AddAssert("Volume is above zero", () => Game.Audio.Volume.Value > 0);
+                return Game.Audio.AggregateVolume.Value > 0;
+            });
         }
 
         private void loadToPlayerNonBreakTime()

From b0df787b1addc5b36f616e2ee19bb1fbb538ce04 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 23 Dec 2021 14:13:36 +0900
Subject: [PATCH 1809/5547] Move public method up and add xmldoc to second
 public method

---
 .../Components/PathControlPointVisualiser.cs  | 62 ++++++++++---------
 1 file changed, 33 insertions(+), 29 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 b72e2d786b..065d4737a5 100644
--- a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointVisualiser.cs
+++ b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointVisualiser.cs
@@ -69,6 +69,39 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders.Components
             controlPoints.BindTo(slider.Path.ControlPoints);
         }
 
+        /// <summary>
+        /// Selects the <see cref="PathControlPointPiece"/> corresponding to the given <paramref name="pathControlPoint"/>,
+        /// and deselects all other <see cref="PathControlPointPiece"/>s.
+        /// </summary>
+        public void SetSelectionTo(PathControlPoint pathControlPoint)
+        {
+            foreach (var p in Pieces)
+                p.IsSelected.Value = p.ControlPoint == pathControlPoint;
+        }
+
+        /// <summary>
+        /// Delete all visually selected <see cref="PathControlPoint"/>s.
+        /// </summary>
+        /// <returns></returns>
+        public bool DeleteSelected()
+        {
+            List<PathControlPoint> toRemove = Pieces.Where(p => p.IsSelected.Value).Select(p => p.ControlPoint).ToList();
+
+            // Ensure that there are any points to be deleted
+            if (toRemove.Count == 0)
+                return false;
+
+            changeHandler?.BeginChange();
+            RemoveControlPointsRequested?.Invoke(toRemove);
+            changeHandler?.EndChange();
+
+            // Since pieces are re-used, they will not point to the deleted control points while remaining selected
+            foreach (var piece in Pieces)
+                piece.IsSelected.Value = false;
+
+            return true;
+        }
+
         private void onControlPointsChanged(object sender, NotifyCollectionChangedEventArgs e)
         {
             switch (e.Action)
@@ -162,16 +195,6 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders.Components
                 SetSelectionTo(piece.ControlPoint);
         }
 
-        /// <summary>
-        /// Selects the <see cref="PathControlPointPiece"/> corresponding to the given <paramref name="pathControlPoint"/>,
-        /// and deselects all other <see cref="PathControlPointPiece"/>s.
-        /// </summary>
-        public void SetSelectionTo(PathControlPoint pathControlPoint)
-        {
-            foreach (var p in Pieces)
-                p.IsSelected.Value = p.ControlPoint == pathControlPoint;
-        }
-
         /// <summary>
         /// Attempts to set the given control point piece to the given path type.
         /// If that would fail, try to change the path such that it instead succeeds
@@ -203,25 +226,6 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders.Components
         [Resolved(CanBeNull = true)]
         private IEditorChangeHandler changeHandler { get; set; }
 
-        public bool DeleteSelected()
-        {
-            List<PathControlPoint> toRemove = Pieces.Where(p => p.IsSelected.Value).Select(p => p.ControlPoint).ToList();
-
-            // Ensure that there are any points to be deleted
-            if (toRemove.Count == 0)
-                return false;
-
-            changeHandler?.BeginChange();
-            RemoveControlPointsRequested?.Invoke(toRemove);
-            changeHandler?.EndChange();
-
-            // Since pieces are re-used, they will not point to the deleted control points while remaining selected
-            foreach (var piece in Pieces)
-                piece.IsSelected.Value = false;
-
-            return true;
-        }
-
         #region Drag handling
 
         private Vector2[] dragStartPositions;

From 29b42402a3e4c1eacbebec3699f37e93107c364e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 23 Dec 2021 09:06:03 +0100
Subject: [PATCH 1810/5547] Add failing test for drag after placement moving
 last placed point sometimes

---
 .../TestSceneSliderControlPointPiece.cs       | 74 +++++++++++++++----
 1 file changed, 61 insertions(+), 13 deletions(-)

diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderControlPointPiece.cs b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderControlPointPiece.cs
index 93ee9b515b..e7bcd2cadc 100644
--- a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderControlPointPiece.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderControlPointPiece.cs
@@ -92,17 +92,12 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
             assertSelectionCount(1);
             assertSelected(0);
 
-            AddStep("move mouse to new point position", () =>
-            {
-                Vector2 position = slider.Position + (slider.Path.ControlPoints[2].Position + slider.Path.ControlPoints[3].Position) / 2;
-                InputManager.MoveMouseTo(drawableObject.Parent.ToScreenSpace(position));
-            });
+            moveMouseToRelativePosition(new Vector2(350, 0));
             AddStep("ctrl+click to create new point", () =>
             {
                 InputManager.PressKey(Key.ControlLeft);
                 InputManager.PressButton(MouseButton.Left);
             });
-            AddAssert("slider has 6 control points", () => slider.Path.ControlPoints.Count == 6);
             assertSelectionCount(1);
             assertSelected(3);
 
@@ -113,15 +108,68 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
             });
             assertSelectionCount(1);
             assertSelected(3);
-
-            void assertSelectionCount(int count) =>
-                AddAssert($"{count} control point pieces selected", () => this.ChildrenOfType<PathControlPointPiece>().Count(piece => piece.IsSelected.Value) == count);
-
-            void assertSelected(int index) =>
-                AddAssert($"{(index + 1).ToOrdinalWords()} control point piece selected",
-                    () => this.ChildrenOfType<PathControlPointPiece>().Single(piece => piece.ControlPoint == slider.Path.ControlPoints[index]).IsSelected.Value);
         }
 
+        [Test]
+        public void TestNewControlPointCreation()
+        {
+            moveMouseToRelativePosition(new Vector2(350, 0));
+            AddStep("ctrl+click to create new point", () =>
+            {
+                InputManager.PressKey(Key.ControlLeft);
+                InputManager.PressButton(MouseButton.Left);
+            });
+            AddAssert("slider has 6 control points", () => slider.Path.ControlPoints.Count == 6);
+            AddStep("release ctrl+click", () =>
+            {
+                InputManager.ReleaseButton(MouseButton.Left);
+                InputManager.ReleaseKey(Key.ControlLeft);
+            });
+
+            // ensure that the next drag doesn't attempt to move the placement that just finished.
+            moveMouseToRelativePosition(new Vector2(0, 50));
+            AddStep("press left mouse", () => InputManager.PressButton(MouseButton.Left));
+            moveMouseToRelativePosition(new Vector2(0, 100));
+            AddStep("release left mouse", () => InputManager.ReleaseButton(MouseButton.Left));
+            assertControlPointPosition(3, new Vector2(350, 0));
+
+            moveMouseToRelativePosition(new Vector2(400, 75));
+            AddStep("ctrl+click to create new point", () =>
+            {
+                InputManager.PressKey(Key.ControlLeft);
+                InputManager.PressButton(MouseButton.Left);
+            });
+            AddAssert("slider has 7 control points", () => slider.Path.ControlPoints.Count == 7);
+            moveMouseToRelativePosition(new Vector2(350, 75));
+            AddStep("release ctrl+click", () =>
+            {
+                InputManager.ReleaseButton(MouseButton.Left);
+                InputManager.ReleaseKey(Key.ControlLeft);
+            });
+            assertControlPointPosition(5, new Vector2(350, 75));
+
+            // ensure that the next drag doesn't attempt to move the placement that just finished.
+            moveMouseToRelativePosition(new Vector2(0, 50));
+            AddStep("press left mouse", () => InputManager.PressButton(MouseButton.Left));
+            moveMouseToRelativePosition(new Vector2(0, 100));
+            AddStep("release left mouse", () => InputManager.ReleaseButton(MouseButton.Left));
+            assertControlPointPosition(5, new Vector2(350, 75));
+        }
+
+        private void assertSelectionCount(int count) =>
+            AddAssert($"{count} control point pieces selected", () => this.ChildrenOfType<PathControlPointPiece>().Count(piece => piece.IsSelected.Value) == count);
+
+        private void assertSelected(int index) =>
+            AddAssert($"{(index + 1).ToOrdinalWords()} control point piece selected",
+                () => this.ChildrenOfType<PathControlPointPiece>().Single(piece => piece.ControlPoint == slider.Path.ControlPoints[index]).IsSelected.Value);
+
+        private void moveMouseToRelativePosition(Vector2 relativePosition) =>
+            AddStep($"move mouse to {relativePosition}", () =>
+            {
+                Vector2 position = slider.Position + relativePosition;
+                InputManager.MoveMouseTo(drawableObject.Parent.ToScreenSpace(position));
+            });
+
         [Test]
         public void TestDragControlPoint()
         {

From cbda637d66be33dec4f2ccb574f3c1a8747c2da3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 23 Dec 2021 09:09:14 +0100
Subject: [PATCH 1811/5547] Fix drag after placement moving last placed point
 sometimes

More specifically, if the left mouse button was just pressed without a
drag, `OnDragEnd()` wouldn't fire, and the next drag would start moving
the last placed control point around regardless of where the mouse was.
---
 .../Edit/Blueprints/Sliders/SliderSelectionBlueprint.cs         | 2 +-
 1 file changed, 1 insertion(+), 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 9caed970b1..d5dd411600 100644
--- a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/SliderSelectionBlueprint.cs
+++ b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/SliderSelectionBlueprint.cs
@@ -170,7 +170,7 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders
                 placementControlPoint.Position = e.MousePosition - HitObject.Position;
         }
 
-        protected override void OnDragEnd(DragEndEvent e)
+        protected override void OnMouseUp(MouseUpEvent e)
         {
             if (placementControlPoint != null)
             {

From c6a5ac1c5f259391167d3f3eaf8bc37c8b05546c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 23 Dec 2021 09:19:21 +0100
Subject: [PATCH 1812/5547] Fix control point additions without a drag not
 being undoable

---
 .../Blueprints/Sliders/SliderSelectionBlueprint.cs   | 12 ++----------
 1 file changed, 2 insertions(+), 10 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/SliderSelectionBlueprint.cs b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/SliderSelectionBlueprint.cs
index d5dd411600..2aebe05c2f 100644
--- a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/SliderSelectionBlueprint.cs
+++ b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/SliderSelectionBlueprint.cs
@@ -139,6 +139,7 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders
                 case MouseButton.Left:
                     if (e.ControlPressed && IsSelected)
                     {
+                        changeHandler?.BeginChange();
                         placementControlPoint = addControlPoint(e.MousePosition);
                         ControlPointVisualiser?.SetSelectionTo(placementControlPoint);
                         return true; // Stop input from being handled and modifying the selection
@@ -153,16 +154,7 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders
         [CanBeNull]
         private PathControlPoint placementControlPoint;
 
-        protected override bool OnDragStart(DragStartEvent e)
-        {
-            if (placementControlPoint != null)
-            {
-                changeHandler?.BeginChange();
-                return true;
-            }
-
-            return false;
-        }
+        protected override bool OnDragStart(DragStartEvent e) => placementControlPoint != null;
 
         protected override void OnDrag(DragEvent e)
         {

From 0732a9e6da034b6121dc719c78d8177b6ff77897 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 23 Dec 2021 18:08:44 +0900
Subject: [PATCH 1813/5547] Update framework

---
 osu.Android.props        | 2 +-
 osu.Game/osu.Game.csproj | 2 +-
 osu.iOS.props            | 4 ++--
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Android.props b/osu.Android.props
index ca4d88a8a7..4f0125bed2 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -52,7 +52,7 @@
   </ItemGroup>
   <ItemGroup>
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1215.0" />
-    <PackageReference Include="ppy.osu.Framework.Android" Version="2021.1221.0" />
+    <PackageReference Include="ppy.osu.Framework.Android" Version="2021.1222.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
     <!-- Realm needs to be directly referenced in all Xamarin projects, as it will not pull in its transitive dependencies otherwise. -->
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index c538f55e89..565f78e2d4 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="10.7.1" />
-    <PackageReference Include="ppy.osu.Framework" Version="2021.1221.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2021.1222.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1215.0" />
     <PackageReference Include="Sentry" Version="3.12.1" />
     <PackageReference Include="SharpCompress" Version="0.30.1" />
diff --git a/osu.iOS.props b/osu.iOS.props
index 5cc1857dfe..bdb3b0b149 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -60,7 +60,7 @@
     <Reference Include="System.Net.Http" />
   </ItemGroup>
   <ItemGroup Label="Package References">
-    <PackageReference Include="ppy.osu.Framework.iOS" Version="2021.1221.0" />
+    <PackageReference Include="ppy.osu.Framework.iOS" Version="2021.1222.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1215.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net5.0 / net6.0) -->
@@ -83,7 +83,7 @@
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="2.2.6" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.Core" Version="2.2.6" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
-    <PackageReference Include="ppy.osu.Framework" Version="2021.1221.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2021.1222.0" />
     <PackageReference Include="SharpCompress" Version="0.30.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
     <PackageReference Include="SharpRaven" Version="2.4.0" />

From 10405908440576b576cc4c5063d3e6d190d1aa32 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 23 Dec 2021 10:33:17 +0100
Subject: [PATCH 1814/5547] Add cancellation support to game-side
 `IResourceStore`s

---
 osu.Game.Tests/Gameplay/TestSceneStoryboardSamples.cs        | 4 +++-
 .../Rulesets/TestSceneDrawableRulesetDependencies.cs         | 3 ++-
 osu.Game/IO/Archives/ArchiveReader.cs                        | 5 +++--
 osu.Game/Localisation/ResourceManagerLocalisationStore.cs    | 3 ++-
 osu.Game/Rulesets/UI/DrawableRulesetDependencies.cs          | 3 ++-
 osu.Game/Tests/Beatmaps/HitObjectSampleTest.cs               | 3 ++-
 osu.Game/Tests/Visual/OsuTestScene.cs                        | 3 ++-
 7 files changed, 16 insertions(+), 8 deletions(-)

diff --git a/osu.Game.Tests/Gameplay/TestSceneStoryboardSamples.cs b/osu.Game.Tests/Gameplay/TestSceneStoryboardSamples.cs
index 3aab28886e..28915b2c4a 100644
--- a/osu.Game.Tests/Gameplay/TestSceneStoryboardSamples.cs
+++ b/osu.Game.Tests/Gameplay/TestSceneStoryboardSamples.cs
@@ -5,6 +5,7 @@ using System;
 using System.Collections.Generic;
 using System.IO;
 using System.Linq;
+using System.Threading;
 using System.Threading.Tasks;
 using NUnit.Framework;
 using osu.Framework.Audio;
@@ -184,7 +185,8 @@ namespace osu.Game.Tests.Gameplay
 
             public byte[] Get(string name) => name == resourceName ? TestResources.GetStore().Get("Resources/Samples/test-sample.mp3") : null;
 
-            public Task<byte[]> GetAsync(string name) => name == resourceName ? TestResources.GetStore().GetAsync("Resources/Samples/test-sample.mp3") : null;
+            public Task<byte[]> GetAsync(string name, CancellationToken cancellationToken = default)
+                => name == resourceName ? TestResources.GetStore().GetAsync("Resources/Samples/test-sample.mp3", cancellationToken) : null;
 
             public Stream GetStream(string name) => name == resourceName ? TestResources.GetStore().GetStream("Resources/Samples/test-sample.mp3") : null;
 
diff --git a/osu.Game.Tests/Rulesets/TestSceneDrawableRulesetDependencies.cs b/osu.Game.Tests/Rulesets/TestSceneDrawableRulesetDependencies.cs
index c357fccd27..20439ac969 100644
--- a/osu.Game.Tests/Rulesets/TestSceneDrawableRulesetDependencies.cs
+++ b/osu.Game.Tests/Rulesets/TestSceneDrawableRulesetDependencies.cs
@@ -4,6 +4,7 @@
 using System;
 using System.Collections.Generic;
 using System.IO;
+using System.Threading;
 using System.Threading.Tasks;
 using NUnit.Framework;
 using osu.Framework.Allocation;
@@ -114,7 +115,7 @@ namespace osu.Game.Tests.Rulesets
 
             public Sample Get(string name) => null;
 
-            public Task<Sample> GetAsync(string name) => null;
+            public Task<Sample> GetAsync(string name, CancellationToken cancellationToken = default) => null;
 
             public Stream GetStream(string name) => null;
 
diff --git a/osu.Game/IO/Archives/ArchiveReader.cs b/osu.Game/IO/Archives/ArchiveReader.cs
index 679ab40402..f787534e2d 100644
--- a/osu.Game/IO/Archives/ArchiveReader.cs
+++ b/osu.Game/IO/Archives/ArchiveReader.cs
@@ -3,6 +3,7 @@
 
 using System.Collections.Generic;
 using System.IO;
+using System.Threading;
 using System.Threading.Tasks;
 using osu.Framework.IO.Stores;
 
@@ -33,7 +34,7 @@ namespace osu.Game.IO.Archives
 
         public virtual byte[] Get(string name) => GetAsync(name).Result;
 
-        public async Task<byte[]> GetAsync(string name)
+        public async Task<byte[]> GetAsync(string name, CancellationToken cancellationToken = default)
         {
             using (Stream input = GetStream(name))
             {
@@ -41,7 +42,7 @@ namespace osu.Game.IO.Archives
                     return null;
 
                 byte[] buffer = new byte[input.Length];
-                await input.ReadAsync(buffer).ConfigureAwait(false);
+                await input.ReadAsync(buffer, cancellationToken).ConfigureAwait(false);
                 return buffer;
             }
         }
diff --git a/osu.Game/Localisation/ResourceManagerLocalisationStore.cs b/osu.Game/Localisation/ResourceManagerLocalisationStore.cs
index 82dc0ad110..0fb85e4a19 100644
--- a/osu.Game/Localisation/ResourceManagerLocalisationStore.cs
+++ b/osu.Game/Localisation/ResourceManagerLocalisationStore.cs
@@ -7,6 +7,7 @@ using System.Globalization;
 using System.IO;
 using System.Linq;
 using System.Resources;
+using System.Threading;
 using System.Threading.Tasks;
 using osu.Framework.Localisation;
 
@@ -75,7 +76,7 @@ namespace osu.Game.Localisation
             }
         }
 
-        public Task<string> GetAsync(string lookup)
+        public Task<string> GetAsync(string lookup, CancellationToken cancellationToken = default)
         {
             return Task.FromResult(Get(lookup));
         }
diff --git a/osu.Game/Rulesets/UI/DrawableRulesetDependencies.cs b/osu.Game/Rulesets/UI/DrawableRulesetDependencies.cs
index e49e515d2e..aacb8dbe83 100644
--- a/osu.Game/Rulesets/UI/DrawableRulesetDependencies.cs
+++ b/osu.Game/Rulesets/UI/DrawableRulesetDependencies.cs
@@ -4,6 +4,7 @@
 using System;
 using System.Collections.Generic;
 using System.IO;
+using System.Threading;
 using System.Threading.Tasks;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
@@ -115,7 +116,7 @@ namespace osu.Game.Rulesets.UI
 
             public Sample Get(string name) => primary.Get(name) ?? fallback.Get(name);
 
-            public Task<Sample> GetAsync(string name) => primary.GetAsync(name) ?? fallback.GetAsync(name);
+            public Task<Sample> GetAsync(string name, CancellationToken cancellationToken = default) => primary.GetAsync(name, cancellationToken) ?? fallback.GetAsync(name, cancellationToken);
 
             public Stream GetStream(string name) => primary.GetStream(name) ?? fallback.GetStream(name);
 
diff --git a/osu.Game/Tests/Beatmaps/HitObjectSampleTest.cs b/osu.Game/Tests/Beatmaps/HitObjectSampleTest.cs
index f919edecf7..27d1de83ec 100644
--- a/osu.Game/Tests/Beatmaps/HitObjectSampleTest.cs
+++ b/osu.Game/Tests/Beatmaps/HitObjectSampleTest.cs
@@ -5,6 +5,7 @@ using System;
 using System.Collections.Generic;
 using System.IO;
 using System.Linq;
+using System.Threading;
 using System.Threading.Tasks;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
@@ -166,7 +167,7 @@ namespace osu.Game.Tests.Beatmaps
                 return Array.Empty<byte>();
             }
 
-            public Task<byte[]> GetAsync(string name)
+            public Task<byte[]> GetAsync(string name, CancellationToken cancellationToken = default)
             {
                 markLookup(name);
                 return Task.FromResult(Array.Empty<byte>());
diff --git a/osu.Game/Tests/Visual/OsuTestScene.cs b/osu.Game/Tests/Visual/OsuTestScene.cs
index 7bc63a8c26..1b2c1e72c4 100644
--- a/osu.Game/Tests/Visual/OsuTestScene.cs
+++ b/osu.Game/Tests/Visual/OsuTestScene.cs
@@ -6,6 +6,7 @@ using System.Collections.Generic;
 using System.Diagnostics;
 using System.IO;
 using System.Linq;
+using System.Threading;
 using System.Threading.Tasks;
 using JetBrains.Annotations;
 using osu.Framework.Allocation;
@@ -352,7 +353,7 @@ namespace osu.Game.Tests.Visual
 
                 public Track Get(string name) => throw new NotImplementedException();
 
-                public Task<Track> GetAsync(string name) => throw new NotImplementedException();
+                public Task<Track> GetAsync(string name, CancellationToken cancellationToken = default) => throw new NotImplementedException();
 
                 public Stream GetStream(string name) => throw new NotImplementedException();
 

From 998b07db902ba77a1ec01cb45a9f42d0d9edcfa9 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 23 Dec 2021 19:14:09 +0900
Subject: [PATCH 1815/5547] Fix TestMultiplayerClient referencing the wrong
 room

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

diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
index 5b08b6b835..571c3e759f 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
@@ -535,7 +535,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     var itemsByPriority = new List<(MultiplayerPlaylistItem item, int priority)>();
 
                     // Assign a priority for items from each user, starting from 0 and increasing in order which the user added the items.
-                    foreach (var group in room.Playlist.Where(item => !item.Expired).OrderBy(item => item.ID).GroupBy(item => item.OwnerID))
+                    foreach (var group in serverSidePlaylist.Where(item => !item.Expired).OrderBy(item => item.ID).GroupBy(item => item.OwnerID))
                     {
                         int priority = 0;
                         itemsByPriority.AddRange(group.Select(item => (item, priority++)));

From cd4c1bc678e9d36fb33b69bbc711df676bead5e0 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 27 Nov 2021 16:20:51 +0100
Subject: [PATCH 1816/5547] Add factory method for various card sizes

---
 .../Beatmaps/Drawables/Cards/BeatmapCard.cs   | 19 +++++++++++++++++++
 .../Drawables/Cards/BeatmapCardSize.cs        | 14 ++++++++++++++
 2 files changed, 33 insertions(+)
 create mode 100644 osu.Game/Beatmaps/Drawables/Cards/BeatmapCardSize.cs

diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
index 6adcdcfcb2..d6dfd8cb17 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
@@ -3,6 +3,7 @@
 
 #nullable enable
 
+using System;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
@@ -76,5 +77,23 @@ namespace osu.Game.Beatmaps.Drawables.Cards
             IdleContent.FadeTo(showProgress ? 0 : 1, TRANSITION_DURATION, Easing.OutQuint);
             DownloadInProgressContent.FadeTo(showProgress ? 1 : 0, TRANSITION_DURATION, Easing.OutQuint);
         }
+
+        /// <summary>
+        /// Creates a beatmap card of the given <paramref name="size"/> for the supplied <paramref name="beatmapSet"/>.
+        /// </summary>
+        public static BeatmapCard Create(APIBeatmapSet beatmapSet, BeatmapCardSize size, bool allowExpansion = true)
+        {
+            switch (size)
+            {
+                case BeatmapCardSize.Normal:
+                    return new BeatmapCardNormal(beatmapSet, allowExpansion);
+
+                case BeatmapCardSize.Extra:
+                    return new BeatmapCardExtra(beatmapSet, allowExpansion);
+
+                default:
+                    throw new ArgumentOutOfRangeException(nameof(size), size, @"Unsupported card size");
+            }
+        }
     }
 }
diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardSize.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardSize.cs
new file mode 100644
index 0000000000..098265506d
--- /dev/null
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardSize.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.
+
+namespace osu.Game.Beatmaps.Drawables.Cards
+{
+    /// <summary>
+    /// Enumeration for all available sizes of <see cref="BeatmapCard"/>.
+    /// </summary>
+    public enum BeatmapCardSize
+    {
+        Normal,
+        Extra
+    }
+}

From 1876617d8e1a030520feb075bc0b03004f160688 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 27 Nov 2021 17:25:54 +0100
Subject: [PATCH 1817/5547] Implement beatmap card size tab control

---
 ...stSceneBeatmapListingCardSizeTabControl.cs |  55 +++++++
 .../BeatmapListingCardSizeTabControl.cs       | 134 ++++++++++++++++++
 2 files changed, 189 insertions(+)
 create mode 100644 osu.Game.Tests/Visual/UserInterface/TestSceneBeatmapListingCardSizeTabControl.cs
 create mode 100644 osu.Game/Overlays/BeatmapListing/BeatmapListingCardSizeTabControl.cs

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneBeatmapListingCardSizeTabControl.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneBeatmapListingCardSizeTabControl.cs
new file mode 100644
index 0000000000..e3d47f08c6
--- /dev/null
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneBeatmapListingCardSizeTabControl.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 osu.Framework.Allocation;
+using osu.Framework.Bindables;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.Sprites;
+using osu.Game.Beatmaps.Drawables.Cards;
+using osu.Game.Graphics;
+using osu.Game.Graphics.Sprites;
+using osu.Game.Overlays;
+using osu.Game.Overlays.BeatmapListing;
+
+namespace osu.Game.Tests.Visual.UserInterface
+{
+    public class TestSceneBeatmapListingCardSizeTabControl : OsuTestScene
+    {
+        [Cached]
+        private readonly OverlayColourProvider colourProvider = new OverlayColourProvider(OverlayColourScheme.Blue);
+
+        private readonly Bindable<BeatmapCardSize> cardSize = new Bindable<BeatmapCardSize>();
+
+        private SpriteText cardSizeText;
+
+        [BackgroundDependencyLoader]
+        private void load()
+        {
+            Child = new Container
+            {
+                RelativeSizeAxes = Axes.Both,
+                Children = new Drawable[]
+                {
+                    cardSizeText = new OsuSpriteText
+                    {
+                        Font = OsuFont.Default.With(size: 24)
+                    },
+                    new BeatmapListingCardSizeTabControl
+                    {
+                        Current = cardSize,
+                        Anchor = Anchor.Centre,
+                        Origin = Anchor.Centre
+                    }
+                }
+            };
+        }
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            cardSize.BindValueChanged(size => cardSizeText.Text = $"Current size: {size.NewValue}", true);
+        }
+    }
+}
diff --git a/osu.Game/Overlays/BeatmapListing/BeatmapListingCardSizeTabControl.cs b/osu.Game/Overlays/BeatmapListing/BeatmapListingCardSizeTabControl.cs
new file mode 100644
index 0000000000..e4fda9d9c3
--- /dev/null
+++ b/osu.Game/Overlays/BeatmapListing/BeatmapListingCardSizeTabControl.cs
@@ -0,0 +1,134 @@
+// 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.Graphics.UserInterface;
+using osu.Framework.Input.Events;
+using osu.Game.Beatmaps.Drawables.Cards;
+using osu.Game.Graphics.UserInterface;
+using osuTK;
+
+namespace osu.Game.Overlays.BeatmapListing
+{
+    public class BeatmapListingCardSizeTabControl : OsuTabControl<BeatmapCardSize>
+    {
+        public BeatmapListingCardSizeTabControl()
+        {
+            AutoSizeAxes = Axes.Both;
+        }
+
+        protected override TabFillFlowContainer CreateTabFlow() => new TabFillFlowContainer
+        {
+            AutoSizeAxes = Axes.Both,
+            Direction = FillDirection.Horizontal,
+            Spacing = new Vector2(10, 0),
+        };
+
+        protected override Dropdown<BeatmapCardSize> CreateDropdown() => null;
+
+        protected override TabItem<BeatmapCardSize> CreateTabItem(BeatmapCardSize value) => new TabItem(value);
+
+        private class TabItem : TabItem<BeatmapCardSize>
+        {
+            private Box background;
+            private SpriteIcon icon;
+
+            [Resolved]
+            private OverlayColourProvider colourProvider { get; set; }
+
+            public TabItem(BeatmapCardSize value)
+                : base(value)
+            {
+            }
+
+            [BackgroundDependencyLoader]
+            private void load()
+            {
+                AutoSizeAxes = Axes.Both;
+                Masking = true;
+                CornerRadius = 4;
+                Children = new Drawable[]
+                {
+                    background = new Box
+                    {
+                        RelativeSizeAxes = Axes.Both,
+                        Colour = colourProvider.Background3
+                    },
+                    new Container
+                    {
+                        AutoSizeAxes = Axes.Both,
+                        Padding = new MarginPadding
+                        {
+                            Horizontal = 10,
+                            Vertical = 5,
+                        },
+                        Child = icon = new SpriteIcon
+                        {
+                            Size = new Vector2(12),
+                            Icon = getIconForCardSize(Value)
+                        }
+                    }
+                };
+            }
+
+            private static IconUsage getIconForCardSize(BeatmapCardSize cardSize)
+            {
+                switch (cardSize)
+                {
+                    case BeatmapCardSize.Normal:
+                        return FontAwesome.Solid.Th;
+
+                    case BeatmapCardSize.Extra:
+                        return FontAwesome.Solid.ThLarge;
+
+                    default:
+                        throw new ArgumentOutOfRangeException(nameof(cardSize), cardSize, "Unsupported card size");
+                }
+            }
+
+            protected override void LoadComplete()
+            {
+                base.LoadComplete();
+                updateState();
+                FinishTransforms(true);
+            }
+
+            protected override void OnActivated()
+            {
+                if (IsLoaded)
+                    updateState();
+            }
+
+            protected override void OnDeactivated()
+            {
+                if (IsLoaded)
+                    updateState();
+            }
+
+            protected override bool OnHover(HoverEvent e)
+            {
+                updateState();
+                return base.OnHover(e);
+            }
+
+            protected override void OnHoverLost(HoverLostEvent e)
+            {
+                updateState();
+                base.OnHoverLost(e);
+            }
+
+            private const double fade_time = 200;
+
+            private void updateState()
+            {
+                background.FadeTo(IsHovered || Active.Value ? 1 : 0, fade_time, Easing.OutQuint);
+                icon.FadeColour(Active.Value && !IsHovered ? colourProvider.Light1 : colourProvider.Content1, fade_time, Easing.OutQuint);
+            }
+        }
+    }
+}

From d0427ec85f93ab7276a7593153d0f8fd77ce2b7e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 27 Nov 2021 17:53:57 +0100
Subject: [PATCH 1818/5547] Add support card size tab control to beatmap
 listing

---
 .../BeatmapListingFilterControl.cs            | 22 ++++++++++++++++---
 osu.Game/Overlays/BeatmapListingOverlay.cs    | 14 ++++++------
 2 files changed, 26 insertions(+), 10 deletions(-)

diff --git a/osu.Game/Overlays/BeatmapListing/BeatmapListingFilterControl.cs b/osu.Game/Overlays/BeatmapListing/BeatmapListingFilterControl.cs
index f5b4785264..157753c09f 100644
--- a/osu.Game/Overlays/BeatmapListing/BeatmapListingFilterControl.cs
+++ b/osu.Game/Overlays/BeatmapListing/BeatmapListingFilterControl.cs
@@ -5,6 +5,7 @@ using System;
 using System.Collections.Generic;
 using System.Linq;
 using osu.Framework.Allocation;
+using osu.Framework.Bindables;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
@@ -12,6 +13,7 @@ using osu.Framework.Graphics.Effects;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Localisation;
 using osu.Framework.Threading;
+using osu.Game.Beatmaps.Drawables.Cards;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests;
 using osu.Game.Online.API.Requests.Responses;
@@ -48,6 +50,11 @@ namespace osu.Game.Overlays.BeatmapListing
         /// </summary>
         public int CurrentPage { get; private set; }
 
+        /// <summary>
+        /// The currently selected <see cref="BeatmapCardSize"/>.
+        /// </summary>
+        public IBindable<BeatmapCardSize> CardSize { get; } = new Bindable<BeatmapCardSize>();
+
         private readonly BeatmapListingSearchControl searchControl;
         private readonly BeatmapListingSortTabControl sortControl;
         private readonly Box sortControlBackground;
@@ -105,6 +112,13 @@ namespace osu.Game.Overlays.BeatmapListing
                                 Anchor = Anchor.CentreLeft,
                                 Origin = Anchor.CentreLeft,
                                 Margin = new MarginPadding { Left = 20 }
+                            },
+                            new BeatmapListingCardSizeTabControl
+                            {
+                                Anchor = Anchor.CentreRight,
+                                Origin = Anchor.CentreRight,
+                                Margin = new MarginPadding { Right = 20 },
+                                Current = { BindTarget = CardSize }
                             }
                         }
                     }
@@ -227,12 +241,14 @@ namespace osu.Game.Overlays.BeatmapListing
 
                     if (filters.Any())
                     {
-                        SearchFinished?.Invoke(SearchResult.SupporterOnlyFilters(filters));
+                        var supporterOnlyFilters = SearchResult.SupporterOnlyFilters(filters);
+                        SearchFinished?.Invoke(supporterOnlyFilters);
                         return;
                     }
                 }
 
-                SearchFinished?.Invoke(SearchResult.ResultsReturned(sets));
+                var resultsReturned = SearchResult.ResultsReturned(sets);
+                SearchFinished?.Invoke(resultsReturned);
             };
 
             api.Queue(getSetsRequest);
@@ -296,7 +312,7 @@ namespace osu.Game.Overlays.BeatmapListing
             public static SearchResult ResultsReturned(List<APIBeatmapSet> results) => new SearchResult
             {
                 Type = SearchResultType.ResultsReturned,
-                Results = results
+                Results = results,
             };
 
             public static SearchResult SupporterOnlyFilters(List<LocalisableString> filters) => new SearchResult
diff --git a/osu.Game/Overlays/BeatmapListingOverlay.cs b/osu.Game/Overlays/BeatmapListingOverlay.cs
index d07f7c8f8f..dd726ed010 100644
--- a/osu.Game/Overlays/BeatmapListingOverlay.cs
+++ b/osu.Game/Overlays/BeatmapListingOverlay.cs
@@ -33,7 +33,7 @@ namespace osu.Game.Overlays
 
         private Drawable currentContent;
         private Container panelTarget;
-        private FillFlowContainer<BeatmapCardNormal> foundContent;
+        private FillFlowContainer<BeatmapCard> foundContent;
         private NotFoundDrawable notFoundContent;
         private SupporterRequiredDrawable supporterRequiredContent;
         private BeatmapListingFilterControl filterControl;
@@ -78,7 +78,7 @@ namespace osu.Game.Overlays
                                 Padding = new MarginPadding { Horizontal = 20 },
                                 Children = new Drawable[]
                                 {
-                                    foundContent = new FillFlowContainer<BeatmapCardNormal>(),
+                                    foundContent = new FillFlowContainer<BeatmapCard>(),
                                     notFoundContent = new NotFoundDrawable(),
                                     supporterRequiredContent = new SupporterRequiredDrawable(),
                                 }
@@ -135,11 +135,11 @@ namespace osu.Game.Overlays
                 return;
             }
 
-            var newPanels = searchResult.Results.Select(b => new BeatmapCardNormal(b)
+            var newPanels = searchResult.Results.Select(b => BeatmapCard.Create(b, filterControl.CardSize.Value).With(card =>
             {
-                Anchor = Anchor.TopCentre,
-                Origin = Anchor.TopCentre,
-            });
+                card.Anchor = Anchor.TopCentre;
+                card.Origin = Anchor.TopCentre;
+            }));
 
             if (filterControl.CurrentPage == 0)
             {
@@ -152,7 +152,7 @@ namespace osu.Game.Overlays
 
                 // spawn new children with the contained so we only clear old content at the last moment.
                 // reverse ID flow is required for correct Z-ordering of the cards' expandable content (last card should be front-most).
-                var content = new ReverseChildIDFillFlowContainer<BeatmapCardNormal>
+                var content = new ReverseChildIDFillFlowContainer<BeatmapCard>
                 {
                     RelativeSizeAxes = Axes.X,
                     AutoSizeAxes = Axes.Y,

From a49a4329eef88c8b89b5cba38be989ad1aca2dd7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 22 Dec 2021 13:16:36 +0100
Subject: [PATCH 1819/5547] Add capability to switch between card sizes

---
 .../Beatmaps/Drawables/Cards/BeatmapCard.cs   |  3 +-
 osu.Game/Overlays/BeatmapListingOverlay.cs    | 78 ++++++++++++++-----
 2 files changed, 60 insertions(+), 21 deletions(-)

diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
index d6dfd8cb17..af537b9e44 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
@@ -23,7 +23,8 @@ namespace osu.Game.Beatmaps.Drawables.Cards
 
         public IBindable<bool> Expanded { get; }
 
-        protected readonly APIBeatmapSet BeatmapSet;
+        public readonly APIBeatmapSet BeatmapSet;
+
         protected readonly Bindable<BeatmapSetFavouriteState> FavouriteState;
 
         protected abstract Drawable IdleContent { get; }
diff --git a/osu.Game/Overlays/BeatmapListingOverlay.cs b/osu.Game/Overlays/BeatmapListingOverlay.cs
index dd726ed010..074db5cef9 100644
--- a/osu.Game/Overlays/BeatmapListingOverlay.cs
+++ b/osu.Game/Overlays/BeatmapListingOverlay.cs
@@ -19,6 +19,7 @@ using osu.Game.Beatmaps.Drawables.Cards;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.Containers;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays.BeatmapListing;
 using osu.Game.Resources.Localisation.Web;
 using osuTK;
@@ -89,6 +90,12 @@ namespace osu.Game.Overlays
             };
         }
 
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+            filterControl.CardSize.BindValueChanged(_ => onCardSizeChanged());
+        }
+
         public void ShowWithSearch(string query)
         {
             filterControl.Search(query);
@@ -135,38 +142,24 @@ namespace osu.Game.Overlays
                 return;
             }
 
-            var newPanels = searchResult.Results.Select(b => BeatmapCard.Create(b, filterControl.CardSize.Value).With(card =>
-            {
-                card.Anchor = Anchor.TopCentre;
-                card.Origin = Anchor.TopCentre;
-            }));
+            var newCards = createCardsFor(searchResult.Results);
 
             if (filterControl.CurrentPage == 0)
             {
                 //No matches case
-                if (!newPanels.Any())
+                if (!newCards.Any())
                 {
                     addContentToPlaceholder(notFoundContent);
                     return;
                 }
 
-                // spawn new children with the contained so we only clear old content at the last moment.
-                // reverse ID flow is required for correct Z-ordering of the cards' expandable content (last card should be front-most).
-                var content = new ReverseChildIDFillFlowContainer<BeatmapCard>
-                {
-                    RelativeSizeAxes = Axes.X,
-                    AutoSizeAxes = Axes.Y,
-                    Spacing = new Vector2(10),
-                    Alpha = 0,
-                    Margin = new MarginPadding { Vertical = 15 },
-                    ChildrenEnumerable = newPanels
-                };
+                var content = createCardContainerFor(newCards);
 
                 panelLoadDelegate = LoadComponentAsync(foundContent = content, addContentToPlaceholder, (cancellationToken = new CancellationTokenSource()).Token);
             }
             else
             {
-                panelLoadDelegate = LoadComponentsAsync(newPanels, loaded =>
+                panelLoadDelegate = LoadComponentsAsync(newCards, loaded =>
                 {
                     lastFetchDisplayedTime = Time.Current;
                     foundContent.AddRange(loaded);
@@ -175,6 +168,28 @@ namespace osu.Game.Overlays
             }
         }
 
+        private BeatmapCard[] createCardsFor(IEnumerable<APIBeatmapSet> beatmapSets) => beatmapSets.Select(set => BeatmapCard.Create(set, filterControl.CardSize.Value).With(c =>
+        {
+            c.Anchor = Anchor.TopCentre;
+            c.Origin = Anchor.TopCentre;
+        })).ToArray();
+
+        private static ReverseChildIDFillFlowContainer<BeatmapCard> createCardContainerFor(IEnumerable<BeatmapCard> newCards)
+        {
+            // spawn new children with the contained so we only clear old content at the last moment.
+            // reverse ID flow is required for correct Z-ordering of the cards' expandable content (last card should be front-most).
+            var content = new ReverseChildIDFillFlowContainer<BeatmapCard>
+            {
+                RelativeSizeAxes = Axes.X,
+                AutoSizeAxes = Axes.Y,
+                Spacing = new Vector2(10),
+                Alpha = 0,
+                Margin = new MarginPadding { Vertical = 15 },
+                ChildrenEnumerable = newCards
+            };
+            return content;
+        }
+
         private void addContentToPlaceholder(Drawable content)
         {
             Loading.Hide();
@@ -195,8 +210,14 @@ namespace osu.Game.Overlays
                 // To resolve both of these issues, the bypass is delayed until a point when the content transitions (fade-in and fade-out) overlap and it looks good to do so.
                 var sequence = lastContent.Delay(25).Schedule(() => lastContent.BypassAutoSizeAxes = Axes.Y);
 
-                if (lastContent != notFoundContent && lastContent != supporterRequiredContent)
-                    sequence.Then().Schedule(() => lastContent.Expire());
+                if (lastContent == foundContent)
+                {
+                    sequence.Then().Schedule(() =>
+                    {
+                        foundContent.Expire();
+                        foundContent = null;
+                    });
+                }
             }
 
             if (!content.IsAlive)
@@ -209,6 +230,23 @@ namespace osu.Game.Overlays
             currentContent.BypassAutoSizeAxes = Axes.None;
         }
 
+        private void onCardSizeChanged()
+        {
+            if (foundContent == null || !foundContent.Any())
+                return;
+
+            Loading.Show();
+
+            var newCards = createCardsFor(foundContent.Reverse().Select(card => card.BeatmapSet));
+
+            panelLoadDelegate = LoadComponentsAsync(newCards, cards =>
+            {
+                foundContent.Clear();
+                foundContent.AddRange(cards);
+                Loading.Hide();
+            }, (cancellationToken = new CancellationTokenSource()).Token);
+        }
+
         protected override void Dispose(bool isDisposing)
         {
             cancellationToken?.Cancel();

From 27c5cc5bd82dc79c86a558c9406e359ffe93e49e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 22 Dec 2021 14:27:11 +0100
Subject: [PATCH 1820/5547] Add testing for beatmap card size switching

---
 .../Online/TestSceneBeatmapListingOverlay.cs  | 32 +++++++++++++++++++
 1 file changed, 32 insertions(+)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneBeatmapListingOverlay.cs b/osu.Game.Tests/Visual/Online/TestSceneBeatmapListingOverlay.cs
index 966f2f3610..ee8794ae87 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneBeatmapListingOverlay.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneBeatmapListingOverlay.cs
@@ -107,6 +107,27 @@ namespace osu.Game.Tests.Visual.Online
             AddUntilStep("is hidden", () => overlay.State.Value == Visibility.Hidden);
         }
 
+        [Test]
+        public void TestCardSizeSwitching()
+        {
+            AddAssert("is visible", () => overlay.State.Value == Visibility.Visible);
+
+            AddStep("show many results", () => fetchFor(Enumerable.Repeat(CreateAPIBeatmapSet(Ruleset.Value), 100).ToArray()));
+            assertAllCardsOfType<BeatmapCardNormal>();
+
+            setCardSize(BeatmapCardSize.Extra);
+            assertAllCardsOfType<BeatmapCardExtra>();
+
+            setCardSize(BeatmapCardSize.Normal);
+            assertAllCardsOfType<BeatmapCardNormal>();
+
+            AddStep("fetch for 0 beatmaps", () => fetchFor());
+            AddUntilStep("placeholder shown", () => overlay.ChildrenOfType<BeatmapListingOverlay.NotFoundDrawable>().SingleOrDefault()?.IsPresent == true);
+
+            setCardSize(BeatmapCardSize.Extra);
+            AddAssert("placeholder shown", () => overlay.ChildrenOfType<BeatmapListingOverlay.NotFoundDrawable>().SingleOrDefault()?.IsPresent == true);
+        }
+
         [Test]
         public void TestNoBeatmapsPlaceholder()
         {
@@ -299,5 +320,16 @@ namespace osu.Game.Tests.Visual.Online
             AddUntilStep("\"supporter required\" placeholder not shown", () => !overlay.ChildrenOfType<BeatmapListingOverlay.SupporterRequiredDrawable>().Any(d => d.IsPresent));
             AddUntilStep("\"no maps found\" placeholder not shown", () => !overlay.ChildrenOfType<BeatmapListingOverlay.NotFoundDrawable>().Any(d => d.IsPresent));
         }
+
+        private void setCardSize(BeatmapCardSize cardSize) => AddStep($"set card size to {cardSize}", () => overlay.ChildrenOfType<BeatmapListingCardSizeTabControl>().Single().Current.Value = cardSize);
+
+        private void assertAllCardsOfType<T>()
+            where T : BeatmapCard =>
+            AddUntilStep($"all loaded beatmap cards are {typeof(T)}", () =>
+            {
+                int loadedCorrectCount = this.ChildrenOfType<BeatmapCard>().Count(card => card.IsLoaded && card.GetType() == typeof(T));
+                int totalCount = this.ChildrenOfType<BeatmapCard>().Count();
+                return loadedCorrectCount > 0 && loadedCorrectCount == totalCount;
+            });
     }
 }

From 0f65c4e960667785802e2ef9f102d683628da202 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 23 Dec 2021 18:59:02 +0100
Subject: [PATCH 1821/5547] Extract interface for ruleset config cache

---
 osu.Game/Rulesets/IRulesetConfigCache.cs | 23 +++++++++++++++++++++++
 osu.Game/Rulesets/RulesetConfigCache.cs  | 13 +------------
 2 files changed, 24 insertions(+), 12 deletions(-)
 create mode 100644 osu.Game/Rulesets/IRulesetConfigCache.cs

diff --git a/osu.Game/Rulesets/IRulesetConfigCache.cs b/osu.Game/Rulesets/IRulesetConfigCache.cs
new file mode 100644
index 0000000000..b946b43905
--- /dev/null
+++ b/osu.Game/Rulesets/IRulesetConfigCache.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.
+
+#nullable enable
+
+using osu.Game.Rulesets.Configuration;
+
+namespace osu.Game.Rulesets
+{
+    /// <summary>
+    /// A cache that provides a single <see cref="IRulesetConfigManager"/> per-ruleset.
+    /// This is done to support referring to and updating ruleset configs from multiple locations in the absence of inter-config bindings.
+    /// </summary>
+    public interface IRulesetConfigCache
+    {
+        /// <summary>
+        /// Retrieves the <see cref="IRulesetConfigManager"/> for a <see cref="Ruleset"/>.
+        /// </summary>
+        /// <param name="ruleset">The <see cref="Ruleset"/> to retrieve the <see cref="IRulesetConfigManager"/> for.</param>
+        /// <returns>The <see cref="IRulesetConfigManager"/> defined by <paramref name="ruleset"/>, null if <paramref name="ruleset"/> doesn't define one.</returns>
+        public IRulesetConfigManager? GetConfigFor(Ruleset ruleset);
+    }
+}
diff --git a/osu.Game/Rulesets/RulesetConfigCache.cs b/osu.Game/Rulesets/RulesetConfigCache.cs
index 262340b4ee..3d7560a99a 100644
--- a/osu.Game/Rulesets/RulesetConfigCache.cs
+++ b/osu.Game/Rulesets/RulesetConfigCache.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 osu.Framework.Graphics;
 using osu.Game.Configuration;
@@ -10,11 +9,7 @@ using osu.Game.Rulesets.Configuration;
 
 namespace osu.Game.Rulesets
 {
-    /// <summary>
-    /// A cache that provides a single <see cref="IRulesetConfigManager"/> per-ruleset.
-    /// This is done to support referring to and updating ruleset configs from multiple locations in the absence of inter-config bindings.
-    /// </summary>
-    public class RulesetConfigCache : Component
+    public class RulesetConfigCache : Component, IRulesetConfigCache
     {
         private readonly RealmContextFactory realmFactory;
         private readonly RulesetStore rulesets;
@@ -43,12 +38,6 @@ namespace osu.Game.Rulesets
             }
         }
 
-        /// <summary>
-        /// Retrieves the <see cref="IRulesetConfigManager"/> for a <see cref="Ruleset"/>.
-        /// </summary>
-        /// <param name="ruleset">The <see cref="Ruleset"/> to retrieve the <see cref="IRulesetConfigManager"/> for.</param>
-        /// <returns>The <see cref="IRulesetConfigManager"/> defined by <paramref name="ruleset"/>, null if <paramref name="ruleset"/> doesn't define one.</returns>
-        /// <exception cref="InvalidOperationException">If <paramref name="ruleset"/> doesn't have a valid <see cref="RulesetInfo.ID"/>.</exception>
         public IRulesetConfigManager GetConfigFor(Ruleset ruleset)
         {
             if (!configCache.TryGetValue(ruleset.RulesetInfo.ShortName, out var config))

From 5cbaa028eb739696df5fa0d00e7724c65aea15e2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 23 Dec 2021 19:02:10 +0100
Subject: [PATCH 1822/5547] Use extracted ruleset config cache implementation
 in DI

---
 osu.Game.Rulesets.Mania.Tests/Editor/TestSceneEditor.cs      | 5 +++--
 .../TestSceneTimingBasedNoteColouring.cs                     | 5 +++--
 osu.Game.Rulesets.Osu.Tests/TestSceneSliderSnaking.cs        | 5 +++--
 osu.Game.Tests/Visual/Navigation/TestSceneOsuGame.cs         | 2 +-
 osu.Game/OsuGameBase.cs                                      | 2 +-
 osu.Game/Overlays/Settings/RulesetSettingsSubsection.cs      | 2 +-
 osu.Game/Rulesets/Edit/HitObjectComposer.cs                  | 2 +-
 osu.Game/Rulesets/UI/DrawableRulesetDependencies.cs          | 2 +-
 8 files changed, 14 insertions(+), 11 deletions(-)

diff --git a/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneEditor.cs b/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneEditor.cs
index d3afbc63eb..f186537875 100644
--- a/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneEditor.cs
+++ b/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneEditor.cs
@@ -4,6 +4,7 @@
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
+using osu.Framework.Extensions.ObjectExtensions;
 using osu.Game.Rulesets.Mania.Configuration;
 using osu.Game.Rulesets.Mania.UI;
 using osu.Game.Tests.Visual;
@@ -24,9 +25,9 @@ namespace osu.Game.Rulesets.Mania.Tests.Editor
         }
 
         [BackgroundDependencyLoader]
-        private void load(RulesetConfigCache configCache)
+        private void load(IRulesetConfigCache configCache)
         {
-            var config = (ManiaRulesetConfigManager)configCache.GetConfigFor(Ruleset.Value.CreateInstance());
+            var config = (ManiaRulesetConfigManager)configCache.GetConfigFor(Ruleset.Value.CreateInstance()).AsNonNull();
             config.BindWith(ManiaRulesetSetting.ScrollDirection, direction);
         }
     }
diff --git a/osu.Game.Rulesets.Mania.Tests/TestSceneTimingBasedNoteColouring.cs b/osu.Game.Rulesets.Mania.Tests/TestSceneTimingBasedNoteColouring.cs
index 449a6ff23d..94b199c5d5 100644
--- a/osu.Game.Rulesets.Mania.Tests/TestSceneTimingBasedNoteColouring.cs
+++ b/osu.Game.Rulesets.Mania.Tests/TestSceneTimingBasedNoteColouring.cs
@@ -14,6 +14,7 @@ using osu.Game.Rulesets.Mania.Objects;
 using osu.Game.Rulesets.Mania.Beatmaps;
 using osu.Game.Rulesets.Mania.Configuration;
 using osu.Framework.Bindables;
+using osu.Framework.Extensions.ObjectExtensions;
 using osu.Framework.Testing;
 using osu.Framework.Utils;
 using osu.Game.Rulesets.Mania.Objects.Drawables;
@@ -25,7 +26,7 @@ namespace osu.Game.Rulesets.Mania.Tests
     public class TestSceneTimingBasedNoteColouring : OsuTestScene
     {
         [Resolved]
-        private RulesetConfigCache configCache { get; set; }
+        private IRulesetConfigCache configCache { get; set; }
 
         private Bindable<bool> configTimingBasedNoteColouring;
 
@@ -48,7 +49,7 @@ namespace osu.Game.Rulesets.Mania.Tests
             });
             AddStep("retrieve config bindable", () =>
             {
-                var config = (ManiaRulesetConfigManager)configCache.GetConfigFor(Ruleset.Value.CreateInstance());
+                var config = (ManiaRulesetConfigManager)configCache.GetConfigFor(Ruleset.Value.CreateInstance()).AsNonNull();
                 configTimingBasedNoteColouring = config.GetBindable<bool>(ManiaRulesetSetting.TimingBasedNoteColouring);
             });
         }
diff --git a/osu.Game.Rulesets.Osu.Tests/TestSceneSliderSnaking.cs b/osu.Game.Rulesets.Osu.Tests/TestSceneSliderSnaking.cs
index 3252e6d912..23d2d650bf 100644
--- a/osu.Game.Rulesets.Osu.Tests/TestSceneSliderSnaking.cs
+++ b/osu.Game.Rulesets.Osu.Tests/TestSceneSliderSnaking.cs
@@ -9,6 +9,7 @@ using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
 using osu.Framework.Bindables;
+using osu.Framework.Extensions.ObjectExtensions;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Testing;
 using osu.Framework.Timing;
@@ -46,9 +47,9 @@ namespace osu.Game.Rulesets.Osu.Tests
             => new ClockBackedTestWorkingBeatmap(this.beatmap = beatmap, storyboard, new FramedClock(new ManualClock { Rate = 1 }), audioManager);
 
         [BackgroundDependencyLoader]
-        private void load(RulesetConfigCache configCache)
+        private void load(IRulesetConfigCache configCache)
         {
-            var config = (OsuRulesetConfigManager)configCache.GetConfigFor(Ruleset.Value.CreateInstance());
+            var config = (OsuRulesetConfigManager)configCache.GetConfigFor(Ruleset.Value.CreateInstance()).AsNonNull();
             config.BindWith(OsuRulesetSetting.SnakingInSliders, snakingIn);
             config.BindWith(OsuRulesetSetting.SnakingOutSliders, snakingOut);
         }
diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneOsuGame.cs b/osu.Game.Tests/Visual/Navigation/TestSceneOsuGame.cs
index 4d1e279090..28ff776d5f 100644
--- a/osu.Game.Tests/Visual/Navigation/TestSceneOsuGame.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneOsuGame.cs
@@ -72,7 +72,7 @@ namespace osu.Game.Tests.Visual.Navigation
             typeof(FileStore),
             typeof(ScoreManager),
             typeof(BeatmapManager),
-            typeof(RulesetConfigCache),
+            typeof(IRulesetConfigCache),
             typeof(OsuColour),
             typeof(IBindable<WorkingBeatmap>),
             typeof(Bindable<WorkingBeatmap>),
diff --git a/osu.Game/OsuGameBase.cs b/osu.Game/OsuGameBase.cs
index 2e266e32ff..9256514a0a 100644
--- a/osu.Game/OsuGameBase.cs
+++ b/osu.Game/OsuGameBase.cs
@@ -268,7 +268,7 @@ namespace osu.Game
             dependencies.Cache(scorePerformanceManager);
             AddInternal(scorePerformanceManager);
 
-            dependencies.Cache(rulesetConfigCache = new RulesetConfigCache(realmFactory, RulesetStore));
+            dependencies.CacheAs<IRulesetConfigCache>(rulesetConfigCache = new RulesetConfigCache(realmFactory, RulesetStore));
 
             var powerStatus = CreateBatteryInfo();
             if (powerStatus != null)
diff --git a/osu.Game/Overlays/Settings/RulesetSettingsSubsection.cs b/osu.Game/Overlays/Settings/RulesetSettingsSubsection.cs
index 93b07fbac7..3945a410ab 100644
--- a/osu.Game/Overlays/Settings/RulesetSettingsSubsection.cs
+++ b/osu.Game/Overlays/Settings/RulesetSettingsSubsection.cs
@@ -29,7 +29,7 @@ namespace osu.Game.Overlays.Settings
         {
             dependencies = new DependencyContainer(base.CreateChildDependencies(parent));
 
-            Config = dependencies.Get<RulesetConfigCache>().GetConfigFor(ruleset);
+            Config = dependencies.Get<IRulesetConfigCache>().GetConfigFor(ruleset);
             if (Config != null)
                 dependencies.Cache(Config);
 
diff --git a/osu.Game/Rulesets/Edit/HitObjectComposer.cs b/osu.Game/Rulesets/Edit/HitObjectComposer.cs
index 8bad9aa11f..4bbfe26d7b 100644
--- a/osu.Game/Rulesets/Edit/HitObjectComposer.cs
+++ b/osu.Game/Rulesets/Edit/HitObjectComposer.cs
@@ -80,7 +80,7 @@ namespace osu.Game.Rulesets.Edit
         [BackgroundDependencyLoader]
         private void load()
         {
-            Config = Dependencies.Get<RulesetConfigCache>().GetConfigFor(Ruleset);
+            Config = Dependencies.Get<IRulesetConfigCache>().GetConfigFor(Ruleset);
 
             try
             {
diff --git a/osu.Game/Rulesets/UI/DrawableRulesetDependencies.cs b/osu.Game/Rulesets/UI/DrawableRulesetDependencies.cs
index aacb8dbe83..53996b6b84 100644
--- a/osu.Game/Rulesets/UI/DrawableRulesetDependencies.cs
+++ b/osu.Game/Rulesets/UI/DrawableRulesetDependencies.cs
@@ -64,7 +64,7 @@ namespace osu.Game.Rulesets.UI
                 CacheAs(ShaderManager = new FallbackShaderManager(ShaderManager, parent.Get<ShaderManager>()));
             }
 
-            RulesetConfigManager = parent.Get<RulesetConfigCache>().GetConfigFor(ruleset);
+            RulesetConfigManager = parent.Get<IRulesetConfigCache>().GetConfigFor(ruleset);
             if (RulesetConfigManager != null)
                 Cache(RulesetConfigManager);
         }

From 77da1e12d5be37a1eacd09182d2e7124c2a2eb90 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 23 Dec 2021 19:18:26 +0100
Subject: [PATCH 1823/5547] Add test implementation of the ruleset config cache

---
 .../Tests/Rulesets/TestRulesetConfigCache.cs  | 19 +++++++++++++++++++
 osu.Game/Tests/Visual/OsuTestScene.cs         |  8 ++++++++
 2 files changed, 27 insertions(+)
 create mode 100644 osu.Game/Tests/Rulesets/TestRulesetConfigCache.cs

diff --git a/osu.Game/Tests/Rulesets/TestRulesetConfigCache.cs b/osu.Game/Tests/Rulesets/TestRulesetConfigCache.cs
new file mode 100644
index 0000000000..537bee6824
--- /dev/null
+++ b/osu.Game/Tests/Rulesets/TestRulesetConfigCache.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 System.Collections.Concurrent;
+using osu.Game.Rulesets;
+using osu.Game.Rulesets.Configuration;
+
+namespace osu.Game.Tests.Rulesets
+{
+    /// <summary>
+    /// Test implementation of a <see cref="IRulesetConfigCache"/>, which ensures isolation between test scenes.
+    /// </summary>
+    public class TestRulesetConfigCache : IRulesetConfigCache
+    {
+        private readonly ConcurrentDictionary<string, IRulesetConfigManager> configCache = new ConcurrentDictionary<string, IRulesetConfigManager>();
+
+        public IRulesetConfigManager GetConfigFor(Ruleset ruleset) => configCache.GetOrAdd(ruleset.ShortName, _ => ruleset.CreateConfig(null));
+    }
+}
diff --git a/osu.Game/Tests/Visual/OsuTestScene.cs b/osu.Game/Tests/Visual/OsuTestScene.cs
index 1b2c1e72c4..df8c9f22db 100644
--- a/osu.Game/Tests/Visual/OsuTestScene.cs
+++ b/osu.Game/Tests/Visual/OsuTestScene.cs
@@ -31,6 +31,7 @@ using osu.Game.Rulesets.UI;
 using osu.Game.Screens;
 using osu.Game.Storyboards;
 using osu.Game.Tests.Beatmaps;
+using osu.Game.Tests.Rulesets;
 
 namespace osu.Game.Tests.Visual
 {
@@ -119,6 +120,13 @@ namespace osu.Game.Tests.Visual
 
             var baseDependencies = base.CreateChildDependencies(parent);
 
+            // to isolate ruleset configs in tests from the actual database and avoid state pollution problems,
+            // as well as problems due to the implementation details of the "real" implementation (the configs only being available at `LoadComplete()`),
+            // cache a test implementation of the ruleset config cache over the "real" one.
+            var isolatedBaseDependencies = new DependencyContainer(baseDependencies);
+            isolatedBaseDependencies.CacheAs<IRulesetConfigCache>(new TestRulesetConfigCache());
+            baseDependencies = isolatedBaseDependencies;
+
             var providedRuleset = CreateRuleset();
             if (providedRuleset != null)
                 baseDependencies = rulesetDependencies = new DrawableRulesetDependencies(providedRuleset, baseDependencies);

From 8094b502cb104dad68cb7b1df77e7c1841307e21 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 23 Dec 2021 19:27:27 +0100
Subject: [PATCH 1824/5547] Remove test-specific logic from
 `RulesetConfigCache`

---
 osu.Game/Rulesets/RulesetConfigCache.cs | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Rulesets/RulesetConfigCache.cs b/osu.Game/Rulesets/RulesetConfigCache.cs
index 3d7560a99a..dee13e74a5 100644
--- a/osu.Game/Rulesets/RulesetConfigCache.cs
+++ b/osu.Game/Rulesets/RulesetConfigCache.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.Graphics;
 using osu.Game.Configuration;
 using osu.Game.Database;
+using osu.Game.Extensions;
 using osu.Game.Rulesets.Configuration;
 
 namespace osu.Game.Rulesets
@@ -40,10 +42,11 @@ namespace osu.Game.Rulesets
 
         public IRulesetConfigManager GetConfigFor(Ruleset ruleset)
         {
+            if (!IsLoaded)
+                throw new InvalidOperationException($@"Cannot retrieve {nameof(IRulesetConfigManager)} before {nameof(RulesetConfigCache)} has loaded");
+
             if (!configCache.TryGetValue(ruleset.RulesetInfo.ShortName, out var config))
-                // any ruleset request which wasn't initialised on startup should not be stored to realm.
-                // this should only be used by tests.
-                return ruleset.CreateConfig(null);
+                throw new InvalidOperationException($@"Attempted to retrieve {nameof(IRulesetConfigManager)} for an unavailable ruleset {ruleset.GetDisplayString()}");
 
             return config;
         }

From c429c74d8984bc17001ad93d0521b0b662b4ff6e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 23 Dec 2021 19:34:41 +0100
Subject: [PATCH 1825/5547] Expose and use test ruleset config cache in test
 scenes

---
 .../Editor/TestSceneEditor.cs                        |  4 ++--
 .../TestSceneTimingBasedNoteColouring.cs             |  6 +-----
 .../TestSceneSliderSnaking.cs                        |  4 ++--
 osu.Game/Tests/Visual/OsuTestScene.cs                | 12 +++++++++++-
 4 files changed, 16 insertions(+), 10 deletions(-)

diff --git a/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneEditor.cs b/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneEditor.cs
index f186537875..5300747633 100644
--- a/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneEditor.cs
+++ b/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneEditor.cs
@@ -25,9 +25,9 @@ namespace osu.Game.Rulesets.Mania.Tests.Editor
         }
 
         [BackgroundDependencyLoader]
-        private void load(IRulesetConfigCache configCache)
+        private void load()
         {
-            var config = (ManiaRulesetConfigManager)configCache.GetConfigFor(Ruleset.Value.CreateInstance()).AsNonNull();
+            var config = (ManiaRulesetConfigManager)RulesetConfigs.GetConfigFor(Ruleset.Value.CreateInstance()).AsNonNull();
             config.BindWith(ManiaRulesetSetting.ScrollDirection, direction);
         }
     }
diff --git a/osu.Game.Rulesets.Mania.Tests/TestSceneTimingBasedNoteColouring.cs b/osu.Game.Rulesets.Mania.Tests/TestSceneTimingBasedNoteColouring.cs
index 94b199c5d5..4c688520ef 100644
--- a/osu.Game.Rulesets.Mania.Tests/TestSceneTimingBasedNoteColouring.cs
+++ b/osu.Game.Rulesets.Mania.Tests/TestSceneTimingBasedNoteColouring.cs
@@ -4,7 +4,6 @@
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Graphics;
-using osu.Framework.Allocation;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.ControlPoints;
@@ -25,9 +24,6 @@ namespace osu.Game.Rulesets.Mania.Tests
     [TestFixture]
     public class TestSceneTimingBasedNoteColouring : OsuTestScene
     {
-        [Resolved]
-        private IRulesetConfigCache configCache { get; set; }
-
         private Bindable<bool> configTimingBasedNoteColouring;
 
         private ManualClock clock;
@@ -49,7 +45,7 @@ namespace osu.Game.Rulesets.Mania.Tests
             });
             AddStep("retrieve config bindable", () =>
             {
-                var config = (ManiaRulesetConfigManager)configCache.GetConfigFor(Ruleset.Value.CreateInstance()).AsNonNull();
+                var config = (ManiaRulesetConfigManager)RulesetConfigs.GetConfigFor(Ruleset.Value.CreateInstance()).AsNonNull();
                 configTimingBasedNoteColouring = config.GetBindable<bool>(ManiaRulesetSetting.TimingBasedNoteColouring);
             });
         }
diff --git a/osu.Game.Rulesets.Osu.Tests/TestSceneSliderSnaking.cs b/osu.Game.Rulesets.Osu.Tests/TestSceneSliderSnaking.cs
index 23d2d650bf..a3aa84d0e7 100644
--- a/osu.Game.Rulesets.Osu.Tests/TestSceneSliderSnaking.cs
+++ b/osu.Game.Rulesets.Osu.Tests/TestSceneSliderSnaking.cs
@@ -47,9 +47,9 @@ namespace osu.Game.Rulesets.Osu.Tests
             => new ClockBackedTestWorkingBeatmap(this.beatmap = beatmap, storyboard, new FramedClock(new ManualClock { Rate = 1 }), audioManager);
 
         [BackgroundDependencyLoader]
-        private void load(IRulesetConfigCache configCache)
+        private void load()
         {
-            var config = (OsuRulesetConfigManager)configCache.GetConfigFor(Ruleset.Value.CreateInstance()).AsNonNull();
+            var config = (OsuRulesetConfigManager)RulesetConfigs.GetConfigFor(Ruleset.Value.CreateInstance()).AsNonNull();
             config.BindWith(OsuRulesetSetting.SnakingInSliders, snakingIn);
             config.BindWith(OsuRulesetSetting.SnakingOutSliders, snakingOut);
         }
diff --git a/osu.Game/Tests/Visual/OsuTestScene.cs b/osu.Game/Tests/Visual/OsuTestScene.cs
index df8c9f22db..6b029729ea 100644
--- a/osu.Game/Tests/Visual/OsuTestScene.cs
+++ b/osu.Game/Tests/Visual/OsuTestScene.cs
@@ -95,6 +95,16 @@ namespace osu.Game.Tests.Visual
         /// </remarks>
         protected Storage LocalStorage => localStorage.Value;
 
+        /// <summary>
+        /// A cache for ruleset configurations to be used in this test scene.
+        /// </summary>
+        /// <remarks>
+        /// This <see cref="IRulesetConfigCache"/> instance is provided to the children of this test scene via DI.
+        /// It is only exposed so that test scenes themselves can access the ruleset config cache in a safe manner
+        /// (<see cref="OsuTestScene"/>s cannot use DI themselves, as they will end up accessing the real cached instance from <see cref="OsuGameBase"/>).
+        /// </remarks>
+        protected IRulesetConfigCache RulesetConfigs { get; private set; }
+
         private Lazy<Storage> localStorage;
 
         private Storage headlessHostStorage;
@@ -124,7 +134,7 @@ namespace osu.Game.Tests.Visual
             // as well as problems due to the implementation details of the "real" implementation (the configs only being available at `LoadComplete()`),
             // cache a test implementation of the ruleset config cache over the "real" one.
             var isolatedBaseDependencies = new DependencyContainer(baseDependencies);
-            isolatedBaseDependencies.CacheAs<IRulesetConfigCache>(new TestRulesetConfigCache());
+            isolatedBaseDependencies.CacheAs(RulesetConfigs = new TestRulesetConfigCache());
             baseDependencies = isolatedBaseDependencies;
 
             var providedRuleset = CreateRuleset();

From 03d159d723b5c307c37bae796f38eade01ff0647 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 24 Dec 2021 11:28:36 +0900
Subject: [PATCH 1826/5547] Refactor OsuAnimatedButton test scene

---
 .../TestSceneOsuAnimatedButton.cs             | 76 +++++++++++++++----
 1 file changed, 63 insertions(+), 13 deletions(-)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneOsuAnimatedButton.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneOsuAnimatedButton.cs
index 6a41d08f01..2eb5a8014e 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneOsuAnimatedButton.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneOsuAnimatedButton.cs
@@ -2,6 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
+using NUnit.Framework;
 using osu.Framework.Graphics;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.UserInterface;
@@ -9,47 +10,96 @@ using osuTK;
 
 namespace osu.Game.Tests.Visual.UserInterface
 {
-    public class TestSceneOsuAnimatedButton : OsuGridTestScene
+    public class TestSceneOsuAnimatedButton : OsuTestScene
     {
-        public TestSceneOsuAnimatedButton()
-            : base(3, 2)
+        [Test]
+        public void TestRelativeSized()
         {
-            Cell(0).Add(new BaseContainer("relative sized")
+            AddStep("add button", () => Child = new BaseContainer("relative sized")
             {
                 RelativeSizeAxes = Axes.Both,
+                Action = () => { }
             });
+        }
 
-            Cell(1).Add(new BaseContainer("auto sized")
+        [Test]
+        public void TestAutoSized()
+        {
+            AddStep("add button", () => Child = new BaseContainer("auto sized")
             {
-                AutoSizeAxes = Axes.Both
+                AutoSizeAxes = Axes.Both,
+                Action = () => { }
             });
+        }
 
-            Cell(2).Add(new BaseContainer("relative Y auto X")
+        [Test]
+        public void TestRelativeYAutoX()
+        {
+            AddStep("add button", () => Child = new BaseContainer("relative Y auto X")
             {
                 RelativeSizeAxes = Axes.Y,
-                AutoSizeAxes = Axes.X
+                AutoSizeAxes = Axes.X,
+                Action = () => { }
             });
+        }
 
-            Cell(3).Add(new BaseContainer("relative X auto Y")
+        [Test]
+        public void TestRelativeXAutoY()
+        {
+            AddStep("add button", () => Child = new BaseContainer("relative X auto Y")
             {
                 RelativeSizeAxes = Axes.X,
-                AutoSizeAxes = Axes.Y
+                AutoSizeAxes = Axes.Y,
+                Action = () => { }
             });
+        }
 
-            Cell(4).Add(new BaseContainer("fixed")
+        [Test]
+        public void TestFixed1()
+        {
+            AddStep("add button", () => Child = new BaseContainer("fixed")
             {
                 Size = new Vector2(100),
+                Action = () => { }
             });
+        }
 
-            Cell(5).Add(new BaseContainer("fixed")
+        [Test]
+        public void TestFixed2()
+        {
+            AddStep("add button", () => Child = new BaseContainer("fixed")
             {
                 Size = new Vector2(100, 50),
+                Action = () => { }
+            });
+        }
+
+        [Test]
+        public void TestToggleEnabled()
+        {
+            BaseContainer button = null;
+
+            AddStep("add button", () => Child = button = new BaseContainer("fixed")
+            {
+                Size = new Vector2(200),
             });
 
             AddToggleStep("toggle enabled", toggle =>
             {
                 for (int i = 0; i < 6; i++)
-                    ((BaseContainer)Cell(i).Child).Action = toggle ? () => { } : (Action)null;
+                    button.Action = toggle ? () => { } : (Action)null;
+            });
+        }
+
+        [Test]
+        public void TestInitiallyDisabled()
+        {
+            AddStep("add disabled button", () =>
+            {
+                Child = new BaseContainer("disabled")
+                {
+                    Size = new Vector2(100)
+                };
             });
         }
 

From c8073000c5545891da3d5936fcb5cb5a48698a99 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 24 Dec 2021 11:42:41 +0900
Subject: [PATCH 1827/5547] Fix initally-disabled OsuAnimatedButton colour
 fading

---
 .../Graphics/UserInterface/OsuAnimatedButton.cs | 17 ++++++++++++++---
 1 file changed, 14 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Graphics/UserInterface/OsuAnimatedButton.cs b/osu.Game/Graphics/UserInterface/OsuAnimatedButton.cs
index 70a107ca04..fd6ef25648 100644
--- a/osu.Game/Graphics/UserInterface/OsuAnimatedButton.cs
+++ b/osu.Game/Graphics/UserInterface/OsuAnimatedButton.cs
@@ -38,6 +38,9 @@ namespace osu.Game.Graphics.UserInterface
             }
         }
 
+        [Resolved]
+        private OsuColour colours { get; set; }
+
         protected override Container<Drawable> Content => content;
 
         private readonly Container content;
@@ -73,17 +76,25 @@ namespace osu.Game.Graphics.UserInterface
         }
 
         [BackgroundDependencyLoader]
-        private void load(OsuColour colours)
+        private void load()
         {
             if (AutoSizeAxes != Axes.None)
             {
                 content.RelativeSizeAxes = (Axes.Both & ~AutoSizeAxes);
                 content.AutoSizeAxes = AutoSizeAxes;
             }
-
-            Enabled.BindValueChanged(enabled => this.FadeColour(enabled.NewValue ? Color4.White : colours.Gray9, 200, Easing.OutQuint), true);
         }
 
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            Colour = enablementColour;
+            Enabled.BindValueChanged(_ => this.FadeColour(enablementColour, 200, Easing.OutQuint));
+        }
+
+        private Color4 enablementColour => Enabled.Value ? Color4.White : colours.Gray9;
+
         protected override bool OnHover(HoverEvent e)
         {
             hover.FadeIn(500, Easing.OutQuint);

From c973739b084d14fa11767516c1c1987bd3c58c6b Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 24 Dec 2021 11:50:48 +0900
Subject: [PATCH 1828/5547] Fix OsuButton event binding + inital-enablement
 colour

---
 .../UserInterface/TestSceneOsuButton.cs       | 46 +++++++++++++++++++
 osu.Game/Graphics/UserInterface/OsuButton.cs  | 14 ++----
 2 files changed, 50 insertions(+), 10 deletions(-)
 create mode 100644 osu.Game.Tests/Visual/UserInterface/TestSceneOsuButton.cs

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneOsuButton.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneOsuButton.cs
new file mode 100644
index 0000000000..9d086cce5c
--- /dev/null
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneOsuButton.cs
@@ -0,0 +1,46 @@
+// 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.Graphics;
+using osu.Game.Graphics.UserInterface;
+using osuTK;
+
+namespace osu.Game.Tests.Visual.UserInterface
+{
+    public class TestSceneOsuButton : OsuTestScene
+    {
+        [Test]
+        public void TestToggleEnabled()
+        {
+            OsuButton button = null;
+
+            AddStep("add button", () => Child = button = new OsuButton
+            {
+                Anchor = Anchor.Centre,
+                Origin = Anchor.Centre,
+                Size = new Vector2(200),
+                Text = "Button"
+            });
+
+            AddToggleStep("toggle enabled", toggle =>
+            {
+                for (int i = 0; i < 6; i++)
+                    button.Action = toggle ? () => { } : (Action)null;
+            });
+        }
+
+        [Test]
+        public void TestInitiallyDisabled()
+        {
+            AddStep("add button", () => Child = new OsuButton
+            {
+                Anchor = Anchor.Centre,
+                Origin = Anchor.Centre,
+                Size = new Vector2(200),
+                Text = "Button"
+            });
+        }
+    }
+}
diff --git a/osu.Game/Graphics/UserInterface/OsuButton.cs b/osu.Game/Graphics/UserInterface/OsuButton.cs
index 82a3e73b84..b132f41335 100644
--- a/osu.Game/Graphics/UserInterface/OsuButton.cs
+++ b/osu.Game/Graphics/UserInterface/OsuButton.cs
@@ -3,7 +3,6 @@
 
 using System.Diagnostics;
 using osu.Framework.Allocation;
-using osu.Framework.Bindables;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
@@ -85,8 +84,6 @@ namespace osu.Game.Graphics.UserInterface
 
             if (hoverSounds.HasValue)
                 AddInternal(new HoverClickSounds(hoverSounds.Value));
-
-            Enabled.BindValueChanged(enabledChanged, true);
         }
 
         [BackgroundDependencyLoader]
@@ -95,10 +92,12 @@ namespace osu.Game.Graphics.UserInterface
             if (backgroundColour == null)
                 BackgroundColour = colours.BlueDark;
 
-            Enabled.ValueChanged += enabledChanged;
-            Enabled.TriggerChange();
+            Colour = enablementColour;
+            Enabled.BindValueChanged(_ => this.FadeColour(enablementColour, 200, Easing.OutQuint));
         }
 
+        private Color4 enablementColour => Enabled.Value ? Color4.White : Color4.Gray;
+
         protected override bool OnClick(ClickEvent e)
         {
             if (Enabled.Value)
@@ -144,10 +143,5 @@ namespace osu.Game.Graphics.UserInterface
             Anchor = Anchor.Centre,
             Font = OsuFont.GetFont(weight: FontWeight.Bold)
         };
-
-        private void enabledChanged(ValueChangedEvent<bool> e)
-        {
-            this.FadeColour(e.NewValue ? Color4.White : Color4.Gray, 200, Easing.OutQuint);
-        }
     }
 }

From 727335dcadfb4ae2d4c25b5ca41e9f56a346ef15 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 24 Dec 2021 14:23:09 +0900
Subject: [PATCH 1829/5547] Improve reliability of exiting gameplay

---
 .../OnlinePlay/Multiplayer/Multiplayer.cs     | 54 +++++++++++++------
 .../Multiplayer/MultiplayerMatchSubScreen.cs  |  3 +-
 .../Multiplayer/MultiplayerPlayerLoader.cs    | 27 ++++++++++
 osu.Game/Screens/Play/Player.cs               |  7 +++
 4 files changed, 74 insertions(+), 17 deletions(-)
 create mode 100644 osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayerLoader.cs

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Multiplayer.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Multiplayer.cs
index e136627d43..2663f4f05f 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Multiplayer.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Multiplayer.cs
@@ -15,6 +15,26 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
         [Resolved]
         private MultiplayerClient client { get; set; }
 
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            client.RoomUpdated += onRoomUpdated;
+            onRoomUpdated();
+        }
+
+        private void onRoomUpdated()
+        {
+            if (client.Room == null)
+                return;
+
+            Debug.Assert(client.LocalUser != null);
+
+            // If the user exits gameplay before score submission completes, we'll transition to idle when results has been prepared.
+            if (client.LocalUser.State == MultiplayerUserState.Results && this.IsCurrentScreen())
+                transitionFromResults();
+        }
+
         public override void OnResuming(IScreen last)
         {
             base.OnResuming(last);
@@ -22,23 +42,27 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
             if (client.Room == null)
                 return;
 
+            if (!(last is MultiplayerPlayerLoader playerLoader))
+                return;
+
+            // If gameplay wasn't finished, then we have a simple path back to the idle state by aborting gameplay.
+            if (!playerLoader.GameplayCompleted)
+            {
+                client.AbortGameplay();
+                return;
+            }
+
+            // If gameplay was completed and the user went all the way to results, we'll transition to idle here.
+            // Otherwise, the transition will happen in onRoomUpdated().
+            transitionFromResults();
+        }
+
+        private void transitionFromResults()
+        {
             Debug.Assert(client.LocalUser != null);
 
-            switch (client.LocalUser.State)
-            {
-                case MultiplayerUserState.Spectating:
-                    break;
-
-                case MultiplayerUserState.WaitingForLoad:
-                case MultiplayerUserState.Loaded:
-                case MultiplayerUserState.Playing:
-                    client.AbortGameplay();
-                    break;
-
-                default:
-                    client.ChangeState(MultiplayerUserState.Idle);
-                    break;
-            }
+            if (client.LocalUser.State == MultiplayerUserState.Results)
+                client.ChangeState(MultiplayerUserState.Idle);
         }
 
         protected override string ScreenTitle => "Multiplayer";
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
index af83543b16..c4dd200614 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
@@ -30,7 +30,6 @@ using osu.Game.Screens.OnlinePlay.Multiplayer.Match;
 using osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist;
 using osu.Game.Screens.OnlinePlay.Multiplayer.Participants;
 using osu.Game.Screens.OnlinePlay.Multiplayer.Spectate;
-using osu.Game.Screens.Play;
 using osu.Game.Screens.Play.HUD;
 using osu.Game.Users;
 using osuTK;
@@ -478,7 +477,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
                     return new MultiSpectatorScreen(users.Take(PlayerGrid.MAX_PLAYERS).ToArray());
 
                 default:
-                    return new PlayerLoader(() => new MultiplayerPlayer(Room, SelectedItem.Value, users));
+                    return new MultiplayerPlayerLoader(() => new MultiplayerPlayer(Room, SelectedItem.Value, users));
             }
         }
 
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayerLoader.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayerLoader.cs
new file mode 100644
index 0000000000..21459ae5fb
--- /dev/null
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayerLoader.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 System;
+using osu.Framework.Screens;
+using osu.Game.Screens.Play;
+
+namespace osu.Game.Screens.OnlinePlay.Multiplayer
+{
+    public class MultiplayerPlayerLoader : PlayerLoader
+    {
+        public bool GameplayCompleted => player?.GameplayCompleted == true;
+
+        private Player player;
+
+        public MultiplayerPlayerLoader(Func<Player> createPlayer)
+            : base(createPlayer)
+        {
+        }
+
+        public override void OnSuspending(IScreen next)
+        {
+            base.OnSuspending(next);
+            player = (Player)next;
+        }
+    }
+}
diff --git a/osu.Game/Screens/Play/Player.cs b/osu.Game/Screens/Play/Player.cs
index 745e1f9e7c..34db9d39b5 100644
--- a/osu.Game/Screens/Play/Player.cs
+++ b/osu.Game/Screens/Play/Player.cs
@@ -66,6 +66,11 @@ namespace osu.Game.Screens.Play
         /// </summary>
         protected virtual bool PauseOnFocusLost => true;
 
+        /// <summary>
+        /// Whether gameplay has completed without the user having failed.
+        /// </summary>
+        public bool GameplayCompleted { get; private set; }
+
         public Action RestartRequested;
 
         public bool HasFailed { get; private set; }
@@ -675,6 +680,8 @@ namespace osu.Game.Screens.Play
             if (HealthProcessor.HasFailed)
                 return;
 
+            GameplayCompleted = true;
+
             // Setting this early in the process means that even if something were to go wrong in the order of events following, there
             // is no chance that a user could return to the (already completed) Player instance from a child screen.
             ValidForResume = false;

From f44af1ad699263f1534875ad32bc8a8a4ce0ccf2 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 24 Dec 2021 17:00:57 +0900
Subject: [PATCH 1830/5547] Move bind to LoadComplete

---
 osu.Game/Graphics/UserInterface/OsuButton.cs | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/osu.Game/Graphics/UserInterface/OsuButton.cs b/osu.Game/Graphics/UserInterface/OsuButton.cs
index b132f41335..a59352ba16 100644
--- a/osu.Game/Graphics/UserInterface/OsuButton.cs
+++ b/osu.Game/Graphics/UserInterface/OsuButton.cs
@@ -91,6 +91,11 @@ namespace osu.Game.Graphics.UserInterface
         {
             if (backgroundColour == null)
                 BackgroundColour = colours.BlueDark;
+        }
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
 
             Colour = enablementColour;
             Enabled.BindValueChanged(_ => this.FadeColour(enablementColour, 200, Easing.OutQuint));

From 18c144395ae7644601b09da7a112d963a0bcb27c Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 24 Dec 2021 17:03:29 +0900
Subject: [PATCH 1831/5547] Rename to dimColour

---
 osu.Game/Graphics/UserInterface/OsuAnimatedButton.cs | 6 +++---
 osu.Game/Graphics/UserInterface/OsuButton.cs         | 6 +++---
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Graphics/UserInterface/OsuAnimatedButton.cs b/osu.Game/Graphics/UserInterface/OsuAnimatedButton.cs
index fd6ef25648..13b42c0f13 100644
--- a/osu.Game/Graphics/UserInterface/OsuAnimatedButton.cs
+++ b/osu.Game/Graphics/UserInterface/OsuAnimatedButton.cs
@@ -89,11 +89,11 @@ namespace osu.Game.Graphics.UserInterface
         {
             base.LoadComplete();
 
-            Colour = enablementColour;
-            Enabled.BindValueChanged(_ => this.FadeColour(enablementColour, 200, Easing.OutQuint));
+            Colour = dimColour;
+            Enabled.BindValueChanged(_ => this.FadeColour(dimColour, 200, Easing.OutQuint));
         }
 
-        private Color4 enablementColour => Enabled.Value ? Color4.White : colours.Gray9;
+        private Color4 dimColour => Enabled.Value ? Color4.White : colours.Gray9;
 
         protected override bool OnHover(HoverEvent e)
         {
diff --git a/osu.Game/Graphics/UserInterface/OsuButton.cs b/osu.Game/Graphics/UserInterface/OsuButton.cs
index a59352ba16..7c1e8d90a0 100644
--- a/osu.Game/Graphics/UserInterface/OsuButton.cs
+++ b/osu.Game/Graphics/UserInterface/OsuButton.cs
@@ -97,11 +97,11 @@ namespace osu.Game.Graphics.UserInterface
         {
             base.LoadComplete();
 
-            Colour = enablementColour;
-            Enabled.BindValueChanged(_ => this.FadeColour(enablementColour, 200, Easing.OutQuint));
+            Colour = dimColour;
+            Enabled.BindValueChanged(_ => this.FadeColour(dimColour, 200, Easing.OutQuint));
         }
 
-        private Color4 enablementColour => Enabled.Value ? Color4.White : Color4.Gray;
+        private Color4 dimColour => Enabled.Value ? Color4.White : Color4.Gray;
 
         protected override bool OnClick(ClickEvent e)
         {

From 3ca238825bef871a90e890df7c76b5c5c5797447 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 24 Dec 2021 09:17:07 +0100
Subject: [PATCH 1832/5547] Unify width of normal and extra card sizes

---
 osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs       | 2 ++
 osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtra.cs  | 5 ++---
 osu.Game/Beatmaps/Drawables/Cards/BeatmapCardNormal.cs | 5 ++---
 3 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
index af537b9e44..9a17d6dc9b 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
@@ -21,6 +21,8 @@ namespace osu.Game.Beatmaps.Drawables.Cards
         public const float TRANSITION_DURATION = 400;
         public const float CORNER_RADIUS = 10;
 
+        protected const float WIDTH = 430;
+
         public IBindable<bool> Expanded { get; }
 
         public readonly APIBeatmapSet BeatmapSet;
diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtra.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtra.cs
index 7f70423ff9..535f222228 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtra.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtra.cs
@@ -25,7 +25,6 @@ namespace osu.Game.Beatmaps.Drawables.Cards
         protected override Drawable IdleContent => idleBottomContent;
         protected override Drawable DownloadInProgressContent => downloadProgressBar;
 
-        private const float width = 475;
         private const float height = 140;
 
         [Cached]
@@ -51,7 +50,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
         [BackgroundDependencyLoader(true)]
         private void load(BeatmapSetOverlay? beatmapSetOverlay)
         {
-            Width = width;
+            Width = WIDTH;
             Height = height;
 
             FillFlowContainer leftIconArea = null!;
@@ -81,7 +80,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                         buttonContainer = new CollapsibleButtonContainer(BeatmapSet)
                         {
                             X = height - CORNER_RADIUS,
-                            Width = width - height + CORNER_RADIUS,
+                            Width = WIDTH - height + CORNER_RADIUS,
                             FavouriteState = { BindTarget = FavouriteState },
                             ButtonsCollapsedWidth = CORNER_RADIUS,
                             ButtonsExpandedWidth = 30,
diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardNormal.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardNormal.cs
index edca310db9..08befd5340 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardNormal.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardNormal.cs
@@ -26,7 +26,6 @@ namespace osu.Game.Beatmaps.Drawables.Cards
         protected override Drawable IdleContent => idleBottomContent;
         protected override Drawable DownloadInProgressContent => downloadProgressBar;
 
-        private const float width = 408;
         private const float height = 100;
 
         [Cached]
@@ -52,7 +51,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
         [BackgroundDependencyLoader]
         private void load()
         {
-            Width = width;
+            Width = WIDTH;
             Height = height;
 
             FillFlowContainer leftIconArea = null!;
@@ -82,7 +81,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                         buttonContainer = new CollapsibleButtonContainer(BeatmapSet)
                         {
                             X = height - CORNER_RADIUS,
-                            Width = width - height + CORNER_RADIUS,
+                            Width = WIDTH - height + CORNER_RADIUS,
                             FavouriteState = { BindTarget = FavouriteState },
                             ButtonsCollapsedWidth = CORNER_RADIUS,
                             ButtonsExpandedWidth = 30,

From 842d508aeeeecddeaef662ff6a2be7c2eb0fe8ec Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 24 Dec 2021 18:38:17 +0900
Subject: [PATCH 1833/5547] Fix incorrect delgate capture leading to slow leak
 of audio tracks

During profile, it was found that the `Completed` delegate was
incorrectly also capturing `lastTrack`, leading to an unexpected
reference chain that led to a memory leak over a long period of time.

This solves the issue by moving the delegate construction to its own
method, where it won't capture the other variables.
---
 osu.Game/Overlays/MusicController.cs | 15 +++++++++++----
 1 file changed, 11 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Overlays/MusicController.cs b/osu.Game/Overlays/MusicController.cs
index 76358fca3f..3346c6d97d 100644
--- a/osu.Game/Overlays/MusicController.cs
+++ b/osu.Game/Overlays/MusicController.cs
@@ -342,11 +342,9 @@ namespace osu.Game.Overlays
 
         private void changeTrack()
         {
+            var queuedTrack = getQueuedTrack();
+
             var lastTrack = CurrentTrack;
-
-            var queuedTrack = new DrawableTrack(current.LoadTrack());
-            queuedTrack.Completed += () => onTrackCompleted(current);
-
             CurrentTrack = queuedTrack;
 
             // At this point we may potentially be in an async context from tests. This is extremely dangerous but we have to make do for now.
@@ -370,6 +368,15 @@ namespace osu.Game.Overlays
             });
         }
 
+        private DrawableTrack getQueuedTrack()
+        {
+            // Important to keep this in its own method to avoid inadvertently capturing unnecessary variables in the callback.
+            // Can lead to leaks.
+            var queuedTrack = new DrawableTrack(current.LoadTrack());
+            queuedTrack.Completed += () => onTrackCompleted(current);
+            return queuedTrack;
+        }
+
         private void onTrackCompleted(WorkingBeatmap workingBeatmap)
         {
             // the source of track completion is the audio thread, so the beatmap may have changed before firing.

From d602aebebbf01c8952c5d27f1eaa9a90e441fb83 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 24 Dec 2021 18:58:31 +0900
Subject: [PATCH 1834/5547] Add missing cancellation token and rename load task
 variable to match purpose

---
 osu.Game/Overlays/BeatmapListingOverlay.cs | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Overlays/BeatmapListingOverlay.cs b/osu.Game/Overlays/BeatmapListingOverlay.cs
index 074db5cef9..ab4ff3edc2 100644
--- a/osu.Game/Overlays/BeatmapListingOverlay.cs
+++ b/osu.Game/Overlays/BeatmapListingOverlay.cs
@@ -131,7 +131,7 @@ namespace osu.Game.Overlays
                 Loading.Show();
         }
 
-        private Task panelLoadDelegate;
+        private Task panelLoadTask;
 
         private void onSearchFinished(BeatmapListingFilterControl.SearchResult searchResult)
         {
@@ -155,16 +155,16 @@ namespace osu.Game.Overlays
 
                 var content = createCardContainerFor(newCards);
 
-                panelLoadDelegate = LoadComponentAsync(foundContent = content, addContentToPlaceholder, (cancellationToken = new CancellationTokenSource()).Token);
+                panelLoadTask = LoadComponentAsync(foundContent = content, addContentToPlaceholder, (cancellationToken = new CancellationTokenSource()).Token);
             }
             else
             {
-                panelLoadDelegate = LoadComponentsAsync(newCards, loaded =>
+                panelLoadTask = LoadComponentsAsync(newCards, loaded =>
                 {
                     lastFetchDisplayedTime = Time.Current;
                     foundContent.AddRange(loaded);
                     loaded.ForEach(p => p.FadeIn(200, Easing.OutQuint));
-                });
+                }, (cancellationToken = new CancellationTokenSource()).Token);
             }
         }
 
@@ -239,7 +239,7 @@ namespace osu.Game.Overlays
 
             var newCards = createCardsFor(foundContent.Reverse().Select(card => card.BeatmapSet));
 
-            panelLoadDelegate = LoadComponentsAsync(newCards, cards =>
+            panelLoadTask = LoadComponentsAsync(newCards, cards =>
             {
                 foundContent.Clear();
                 foundContent.AddRange(cards);
@@ -374,7 +374,7 @@ namespace osu.Game.Overlays
 
             const int pagination_scroll_distance = 500;
 
-            bool shouldShowMore = panelLoadDelegate?.IsCompleted != false
+            bool shouldShowMore = panelLoadTask?.IsCompleted != false
                                   && Time.Current - lastFetchDisplayedTime > time_between_fetches
                                   && (ScrollFlow.ScrollableExtent > 0 && ScrollFlow.IsScrolledToEnd(pagination_scroll_distance));
 

From cc7089c3f4ce3706cdccd483ae0b2bf1911952ed Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 24 Dec 2021 19:00:09 +0900
Subject: [PATCH 1835/5547] Cancel more liberally

---
 osu.Game/Overlays/BeatmapListingOverlay.cs | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Overlays/BeatmapListingOverlay.cs b/osu.Game/Overlays/BeatmapListingOverlay.cs
index ab4ff3edc2..0c2bad95d6 100644
--- a/osu.Game/Overlays/BeatmapListingOverlay.cs
+++ b/osu.Game/Overlays/BeatmapListingOverlay.cs
@@ -121,6 +121,8 @@ namespace osu.Game.Overlays
 
         private CancellationTokenSource cancellationToken;
 
+        private Task panelLoadTask;
+
         private void onSearchStarted()
         {
             cancellationToken?.Cancel();
@@ -131,10 +133,10 @@ namespace osu.Game.Overlays
                 Loading.Show();
         }
 
-        private Task panelLoadTask;
-
         private void onSearchFinished(BeatmapListingFilterControl.SearchResult searchResult)
         {
+            cancellationToken?.Cancel();
+
             if (searchResult.Type == BeatmapListingFilterControl.SearchResultType.SupporterOnlyFilters)
             {
                 supporterRequiredContent.UpdateText(searchResult.SupporterOnlyFiltersUsed);
@@ -239,6 +241,8 @@ namespace osu.Game.Overlays
 
             var newCards = createCardsFor(foundContent.Reverse().Select(card => card.BeatmapSet));
 
+            cancellationToken?.Cancel();
+
             panelLoadTask = LoadComponentsAsync(newCards, cards =>
             {
                 foundContent.Clear();

From 8cdad5f4d9448613650ffc803ed50e39a895c066 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 24 Dec 2021 20:15:10 +0900
Subject: [PATCH 1836/5547] Remove incorrectly used `gameSuffix` from
 `CleanRunHeadlessGameHost`

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

diff --git a/osu.Game/Tests/CleanRunHeadlessGameHost.cs b/osu.Game/Tests/CleanRunHeadlessGameHost.cs
index 7d7f011f6a..1c341ea243 100644
--- a/osu.Game/Tests/CleanRunHeadlessGameHost.cs
+++ b/osu.Game/Tests/CleanRunHeadlessGameHost.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.Runtime.CompilerServices;
 using osu.Framework.Testing;
 
@@ -14,13 +15,12 @@ namespace osu.Game.Tests
         /// <summary>
         /// Create a new instance.
         /// </summary>
-        /// <param name="gameSuffix">An optional suffix which will isolate this host from others called from the same method source.</param>
         /// <param name="bindIPC">Whether to bind IPC channels.</param>
         /// <param name="realtime">Whether the host should be forced to run in realtime, rather than accelerated test time.</param>
         /// <param name="bypassCleanup">Whether to bypass directory cleanup on host disposal. Should be used only if a subsequent test relies on the files still existing.</param>
         /// <param name="callingMethodName">The name of the calling method, used for test file isolation and clean-up.</param>
-        public CleanRunHeadlessGameHost(string gameSuffix = @"", bool bindIPC = false, bool realtime = true, bool bypassCleanup = false, [CallerMemberName] string callingMethodName = @"")
-            : base(callingMethodName + gameSuffix, bindIPC, realtime, bypassCleanup: bypassCleanup)
+        public CleanRunHeadlessGameHost(bool bindIPC = false, bool realtime = true, bool bypassCleanup = false, [CallerMemberName] string callingMethodName = @"")
+            : base($"{callingMethodName}-{Guid.NewGuid()}", bindIPC, realtime, bypassCleanup: bypassCleanup)
         {
         }
 

From 4b88e257e57cdf76d8da3cc880871f691cf208a6 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 24 Dec 2021 20:17:20 +0900
Subject: [PATCH 1837/5547] Update usages of `CleanRunHeadlessGameHost` to
 match new signature

---
 .../Beatmaps/IO/ImportBeatmapTest.cs          | 50 +++++++++----------
 osu.Game.Tests/Database/RealmTest.cs          |  4 +-
 .../NonVisual/CustomDataDirectoryTest.cs      |  2 +-
 osu.Game.Tests/Skins/IO/ImportSkinTest.cs     |  2 +-
 .../NonVisual/CustomTourneyDirectoryTest.cs   |  2 +-
 .../NonVisual/DataLoadTest.cs                 |  2 +-
 6 files changed, 31 insertions(+), 31 deletions(-)

diff --git a/osu.Game.Tests/Beatmaps/IO/ImportBeatmapTest.cs b/osu.Game.Tests/Beatmaps/IO/ImportBeatmapTest.cs
index 6d0d5702e9..9f3709f7a3 100644
--- a/osu.Game.Tests/Beatmaps/IO/ImportBeatmapTest.cs
+++ b/osu.Game.Tests/Beatmaps/IO/ImportBeatmapTest.cs
@@ -40,7 +40,7 @@ namespace osu.Game.Tests.Beatmaps.IO
         public async Task TestImportWhenClosed()
         {
             // unfortunately for the time being we need to reference osu.Framework.Desktop for a game host here.
-            using (HeadlessGameHost host = new CleanRunHeadlessGameHost(nameof(ImportBeatmapTest)))
+            using (HeadlessGameHost host = new CleanRunHeadlessGameHost())
             {
                 try
                 {
@@ -57,7 +57,7 @@ namespace osu.Game.Tests.Beatmaps.IO
         public async Task TestImportThenDelete()
         {
             // unfortunately for the time being we need to reference osu.Framework.Desktop for a game host here.
-            using (HeadlessGameHost host = new CleanRunHeadlessGameHost(nameof(ImportBeatmapTest)))
+            using (HeadlessGameHost host = new CleanRunHeadlessGameHost())
             {
                 try
                 {
@@ -78,7 +78,7 @@ namespace osu.Game.Tests.Beatmaps.IO
         public async Task TestImportThenDeleteFromStream()
         {
             // unfortunately for the time being we need to reference osu.Framework.Desktop for a game host here.
-            using (HeadlessGameHost host = new CleanRunHeadlessGameHost(nameof(ImportBeatmapTest)))
+            using (HeadlessGameHost host = new CleanRunHeadlessGameHost())
             {
                 try
                 {
@@ -114,7 +114,7 @@ namespace osu.Game.Tests.Beatmaps.IO
         public async Task TestImportThenImport()
         {
             // unfortunately for the time being we need to reference osu.Framework.Desktop for a game host here.
-            using (HeadlessGameHost host = new CleanRunHeadlessGameHost(nameof(ImportBeatmapTest)))
+            using (HeadlessGameHost host = new CleanRunHeadlessGameHost())
             {
                 try
                 {
@@ -140,7 +140,7 @@ namespace osu.Game.Tests.Beatmaps.IO
         [Test]
         public async Task TestImportThenImportWithReZip()
         {
-            using (HeadlessGameHost host = new CleanRunHeadlessGameHost(nameof(ImportBeatmapTest)))
+            using (HeadlessGameHost host = new CleanRunHeadlessGameHost())
             {
                 try
                 {
@@ -192,7 +192,7 @@ namespace osu.Game.Tests.Beatmaps.IO
         [Test]
         public async Task TestImportThenImportWithChangedHashedFile()
         {
-            using (HeadlessGameHost host = new CleanRunHeadlessGameHost(nameof(ImportBeatmapTest)))
+            using (HeadlessGameHost host = new CleanRunHeadlessGameHost())
             {
                 try
                 {
@@ -247,7 +247,7 @@ namespace osu.Game.Tests.Beatmaps.IO
         [Ignore("intentionally broken by import optimisations")]
         public async Task TestImportThenImportWithChangedFile()
         {
-            using (HeadlessGameHost host = new CleanRunHeadlessGameHost(nameof(ImportBeatmapTest)))
+            using (HeadlessGameHost host = new CleanRunHeadlessGameHost())
             {
                 try
                 {
@@ -298,7 +298,7 @@ namespace osu.Game.Tests.Beatmaps.IO
         [Test]
         public async Task TestImportThenImportWithDifferentFilename()
         {
-            using (HeadlessGameHost host = new CleanRunHeadlessGameHost(nameof(ImportBeatmapTest)))
+            using (HeadlessGameHost host = new CleanRunHeadlessGameHost())
             {
                 try
                 {
@@ -351,7 +351,7 @@ namespace osu.Game.Tests.Beatmaps.IO
         public async Task TestImportCorruptThenImport()
         {
             // unfortunately for the time being we need to reference osu.Framework.Desktop for a game host here.
-            using (HeadlessGameHost host = new CleanRunHeadlessGameHost(nameof(ImportBeatmapTest)))
+            using (HeadlessGameHost host = new CleanRunHeadlessGameHost())
             {
                 try
                 {
@@ -392,7 +392,7 @@ namespace osu.Game.Tests.Beatmaps.IO
         [Test]
         public async Task TestModelCreationFailureDoesntReturn()
         {
-            using (HeadlessGameHost host = new CleanRunHeadlessGameHost(nameof(ImportBeatmapTest)))
+            using (HeadlessGameHost host = new CleanRunHeadlessGameHost())
             {
                 try
                 {
@@ -428,7 +428,7 @@ namespace osu.Game.Tests.Beatmaps.IO
         public async Task TestRollbackOnFailure()
         {
             // unfortunately for the time being we need to reference osu.Framework.Desktop for a game host here.
-            using (HeadlessGameHost host = new CleanRunHeadlessGameHost(nameof(ImportBeatmapTest)))
+            using (HeadlessGameHost host = new CleanRunHeadlessGameHost())
             {
                 try
                 {
@@ -507,7 +507,7 @@ namespace osu.Game.Tests.Beatmaps.IO
         public async Task TestImportThenDeleteThenImport()
         {
             // unfortunately for the time being we need to reference osu.Framework.Desktop for a game host here.
-            using (HeadlessGameHost host = new CleanRunHeadlessGameHost(nameof(ImportBeatmapTest)))
+            using (HeadlessGameHost host = new CleanRunHeadlessGameHost())
             {
                 try
                 {
@@ -534,7 +534,7 @@ namespace osu.Game.Tests.Beatmaps.IO
         public async Task TestImportThenDeleteThenImportWithOnlineIDsMissing()
         {
             // unfortunately for the time being we need to reference osu.Framework.Desktop for a game host here.
-            using (HeadlessGameHost host = new CleanRunHeadlessGameHost($"{nameof(ImportBeatmapTest)}"))
+            using (HeadlessGameHost host = new CleanRunHeadlessGameHost())
             {
                 try
                 {
@@ -566,7 +566,7 @@ namespace osu.Game.Tests.Beatmaps.IO
         public async Task TestImportWithDuplicateBeatmapIDs()
         {
             // unfortunately for the time being we need to reference osu.Framework.Desktop for a game host here.
-            using (HeadlessGameHost host = new CleanRunHeadlessGameHost(nameof(ImportBeatmapTest)))
+            using (HeadlessGameHost host = new CleanRunHeadlessGameHost())
             {
                 try
                 {
@@ -621,8 +621,8 @@ namespace osu.Game.Tests.Beatmaps.IO
         [NonParallelizable]
         public void TestImportOverIPC()
         {
-            using (HeadlessGameHost host = new CleanRunHeadlessGameHost($"{nameof(ImportBeatmapTest)}-host", true))
-            using (HeadlessGameHost client = new CleanRunHeadlessGameHost($"{nameof(ImportBeatmapTest)}-client", true))
+            using (HeadlessGameHost host = new CleanRunHeadlessGameHost(true))
+            using (HeadlessGameHost client = new CleanRunHeadlessGameHost(true))
             {
                 try
                 {
@@ -651,7 +651,7 @@ namespace osu.Game.Tests.Beatmaps.IO
         [Test]
         public async Task TestImportWhenFileOpen()
         {
-            using (HeadlessGameHost host = new CleanRunHeadlessGameHost(nameof(ImportBeatmapTest)))
+            using (HeadlessGameHost host = new CleanRunHeadlessGameHost())
             {
                 try
                 {
@@ -673,7 +673,7 @@ namespace osu.Game.Tests.Beatmaps.IO
         [Test]
         public async Task TestImportWithDuplicateHashes()
         {
-            using (HeadlessGameHost host = new CleanRunHeadlessGameHost(nameof(ImportBeatmapTest)))
+            using (HeadlessGameHost host = new CleanRunHeadlessGameHost())
             {
                 try
                 {
@@ -715,7 +715,7 @@ namespace osu.Game.Tests.Beatmaps.IO
         [Test]
         public async Task TestImportNestedStructure()
         {
-            using (HeadlessGameHost host = new CleanRunHeadlessGameHost(nameof(ImportBeatmapTest)))
+            using (HeadlessGameHost host = new CleanRunHeadlessGameHost())
             {
                 try
                 {
@@ -760,7 +760,7 @@ namespace osu.Game.Tests.Beatmaps.IO
         [Test]
         public async Task TestImportWithIgnoredDirectoryInArchive()
         {
-            using (HeadlessGameHost host = new CleanRunHeadlessGameHost(nameof(ImportBeatmapTest)))
+            using (HeadlessGameHost host = new CleanRunHeadlessGameHost())
             {
                 try
                 {
@@ -814,7 +814,7 @@ namespace osu.Game.Tests.Beatmaps.IO
         [Test]
         public async Task TestUpdateBeatmapInfo()
         {
-            using (HeadlessGameHost host = new CleanRunHeadlessGameHost(nameof(ImportBeatmapTest)))
+            using (HeadlessGameHost host = new CleanRunHeadlessGameHost())
             {
                 try
                 {
@@ -844,7 +844,7 @@ namespace osu.Game.Tests.Beatmaps.IO
         [Test]
         public async Task TestUpdateBeatmapFile()
         {
-            using (HeadlessGameHost host = new CleanRunHeadlessGameHost(nameof(ImportBeatmapTest)))
+            using (HeadlessGameHost host = new CleanRunHeadlessGameHost())
             {
                 try
                 {
@@ -888,7 +888,7 @@ namespace osu.Game.Tests.Beatmaps.IO
         public void TestSaveRemovesInvalidCharactersFromPath()
         {
             // unfortunately for the time being we need to reference osu.Framework.Desktop for a game host here.
-            using (HeadlessGameHost host = new CleanRunHeadlessGameHost(nameof(ImportBeatmapTest)))
+            using (HeadlessGameHost host = new CleanRunHeadlessGameHost())
             {
                 try
                 {
@@ -922,7 +922,7 @@ namespace osu.Game.Tests.Beatmaps.IO
         [Test]
         public void TestCreateNewEmptyBeatmap()
         {
-            using (HeadlessGameHost host = new CleanRunHeadlessGameHost(nameof(ImportBeatmapTest)))
+            using (HeadlessGameHost host = new CleanRunHeadlessGameHost())
             {
                 try
                 {
@@ -949,7 +949,7 @@ namespace osu.Game.Tests.Beatmaps.IO
         [Test]
         public void TestCreateNewBeatmapWithObject()
         {
-            using (HeadlessGameHost host = new CleanRunHeadlessGameHost(nameof(ImportBeatmapTest)))
+            using (HeadlessGameHost host = new CleanRunHeadlessGameHost())
             {
                 try
                 {
diff --git a/osu.Game.Tests/Database/RealmTest.cs b/osu.Game.Tests/Database/RealmTest.cs
index 6904464485..4e67f09dca 100644
--- a/osu.Game.Tests/Database/RealmTest.cs
+++ b/osu.Game.Tests/Database/RealmTest.cs
@@ -30,7 +30,7 @@ namespace osu.Game.Tests.Database
 
         protected void RunTestWithRealm(Action<RealmContextFactory, OsuStorage> testAction, [CallerMemberName] string caller = "")
         {
-            using (HeadlessGameHost host = new CleanRunHeadlessGameHost(caller))
+            using (HeadlessGameHost host = new CleanRunHeadlessGameHost(callingMethodName: caller))
             {
                 host.Run(new RealmTestGame(() =>
                 {
@@ -54,7 +54,7 @@ namespace osu.Game.Tests.Database
 
         protected void RunTestWithRealmAsync(Func<RealmContextFactory, Storage, Task> testAction, [CallerMemberName] string caller = "")
         {
-            using (HeadlessGameHost host = new CleanRunHeadlessGameHost(caller))
+            using (HeadlessGameHost host = new CleanRunHeadlessGameHost(callingMethodName: caller))
             {
                 host.Run(new RealmTestGame(async () =>
                 {
diff --git a/osu.Game.Tests/NonVisual/CustomDataDirectoryTest.cs b/osu.Game.Tests/NonVisual/CustomDataDirectoryTest.cs
index 8d15be44fa..999994cae0 100644
--- a/osu.Game.Tests/NonVisual/CustomDataDirectoryTest.cs
+++ b/osu.Game.Tests/NonVisual/CustomDataDirectoryTest.cs
@@ -315,7 +315,7 @@ namespace osu.Game.Tests.NonVisual
             public CustomTestHeadlessGameHost([CallerMemberName] string callingMethodName = @"")
                 : base(callingMethodName: callingMethodName)
             {
-                string defaultStorageLocation = getDefaultLocationFor(callingMethodName);
+                string defaultStorageLocation = getDefaultLocationFor(Name);
 
                 InitialStorage = new DesktopStorage(defaultStorageLocation, this);
                 InitialStorage.DeleteDirectory(string.Empty);
diff --git a/osu.Game.Tests/Skins/IO/ImportSkinTest.cs b/osu.Game.Tests/Skins/IO/ImportSkinTest.cs
index f2ce002650..40d2455106 100644
--- a/osu.Game.Tests/Skins/IO/ImportSkinTest.cs
+++ b/osu.Game.Tests/Skins/IO/ImportSkinTest.cs
@@ -319,7 +319,7 @@ namespace osu.Game.Tests.Skins.IO
 
         private async Task runSkinTest(Func<OsuGameBase, Task> action, [CallerMemberName] string callingMethodName = @"")
         {
-            using (HeadlessGameHost host = new CleanRunHeadlessGameHost(callingMethodName))
+            using (HeadlessGameHost host = new CleanRunHeadlessGameHost(callingMethodName: callingMethodName))
             {
                 try
                 {
diff --git a/osu.Game.Tournament.Tests/NonVisual/CustomTourneyDirectoryTest.cs b/osu.Game.Tournament.Tests/NonVisual/CustomTourneyDirectoryTest.cs
index 3619aae7e0..14cab63348 100644
--- a/osu.Game.Tournament.Tests/NonVisual/CustomTourneyDirectoryTest.cs
+++ b/osu.Game.Tournament.Tests/NonVisual/CustomTourneyDirectoryTest.cs
@@ -17,7 +17,7 @@ namespace osu.Game.Tournament.Tests.NonVisual
         [Test]
         public void TestDefaultDirectory()
         {
-            using (HeadlessGameHost host = new CleanRunHeadlessGameHost(nameof(TestDefaultDirectory)))
+            using (HeadlessGameHost host = new CleanRunHeadlessGameHost())
             {
                 try
                 {
diff --git a/osu.Game.Tournament.Tests/NonVisual/DataLoadTest.cs b/osu.Game.Tournament.Tests/NonVisual/DataLoadTest.cs
index 692cb3870c..db019f9242 100644
--- a/osu.Game.Tournament.Tests/NonVisual/DataLoadTest.cs
+++ b/osu.Game.Tournament.Tests/NonVisual/DataLoadTest.cs
@@ -15,7 +15,7 @@ namespace osu.Game.Tournament.Tests.NonVisual
         [Test]
         public void TestUnavailableRuleset()
         {
-            using (HeadlessGameHost host = new CleanRunHeadlessGameHost(nameof(TestUnavailableRuleset)))
+            using (HeadlessGameHost host = new CleanRunHeadlessGameHost())
             {
                 try
                 {

From be02c3f9f8bb8078913afb34342d753ce7f475c5 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 24 Dec 2021 20:17:47 +0900
Subject: [PATCH 1838/5547] Fix a couple of remaining cases of tests not using
 the new temporary file location for storage

---
 .../NonVisual/CustomTourneyDirectoryTest.cs   | 40 +++----------------
 .../NonVisual/IPCLocationTest.cs              | 15 ++-----
 2 files changed, 10 insertions(+), 45 deletions(-)

diff --git a/osu.Game.Tournament.Tests/NonVisual/CustomTourneyDirectoryTest.cs b/osu.Game.Tournament.Tests/NonVisual/CustomTourneyDirectoryTest.cs
index 14cab63348..fc5d3b652f 100644
--- a/osu.Game.Tournament.Tests/NonVisual/CustomTourneyDirectoryTest.cs
+++ b/osu.Game.Tournament.Tests/NonVisual/CustomTourneyDirectoryTest.cs
@@ -2,10 +2,11 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System.IO;
+using System.Linq;
 using NUnit.Framework;
-using osu.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Platform;
+using osu.Framework.Testing;
 using osu.Game.Tests;
 using osu.Game.Tournament.Configuration;
 
@@ -36,9 +37,9 @@ namespace osu.Game.Tournament.Tests.NonVisual
         [Test]
         public void TestCustomDirectory()
         {
-            using (HeadlessGameHost host = new HeadlessGameHost(nameof(TestCustomDirectory))) // don't use clean run as we are writing a config file.
+            using (HeadlessGameHost host = new TestRunHeadlessGameHost(nameof(TestCustomDirectory))) // don't use clean run as we are writing a config file.
             {
-                string osuDesktopStorage = PrepareBasePath(nameof(TestCustomDirectory));
+                string osuDesktopStorage = Path.Combine(host.UserStoragePaths.First(), nameof(TestCustomDirectory));
                 const string custom_tournament = "custom";
 
                 // need access before the game has constructed its own storage yet.
@@ -60,15 +61,6 @@ namespace osu.Game.Tournament.Tests.NonVisual
                 finally
                 {
                     host.Exit();
-
-                    try
-                    {
-                        if (Directory.Exists(osuDesktopStorage))
-                            Directory.Delete(osuDesktopStorage, true);
-                    }
-                    catch
-                    {
-                    }
                 }
             }
         }
@@ -76,9 +68,9 @@ namespace osu.Game.Tournament.Tests.NonVisual
         [Test]
         public void TestMigration()
         {
-            using (HeadlessGameHost host = new HeadlessGameHost(nameof(TestMigration))) // don't use clean run as we are writing test files for migration.
+            using (HeadlessGameHost host = new TestRunHeadlessGameHost(nameof(TestMigration))) // don't use clean run as we are writing test files for migration.
             {
-                string osuRoot = PrepareBasePath(nameof(TestMigration));
+                string osuRoot = Path.Combine(host.UserStoragePaths.First(), nameof(TestMigration));
                 string configFile = Path.Combine(osuRoot, "tournament.ini");
 
                 if (File.Exists(configFile))
@@ -146,28 +138,8 @@ namespace osu.Game.Tournament.Tests.NonVisual
                 finally
                 {
                     host.Exit();
-
-                    try
-                    {
-                        if (Directory.Exists(osuRoot))
-                            Directory.Delete(osuRoot, true);
-                    }
-                    catch
-                    {
-                    }
                 }
             }
         }
-
-        public static string PrepareBasePath(string testInstance)
-        {
-            string basePath = Path.Combine(RuntimeInfo.StartupDirectory, "headless", testInstance);
-
-            // manually clean before starting in case there are left-over files at the test site.
-            if (Directory.Exists(basePath))
-                Directory.Delete(basePath, true);
-
-            return basePath;
-        }
     }
 }
diff --git a/osu.Game.Tournament.Tests/NonVisual/IPCLocationTest.cs b/osu.Game.Tournament.Tests/NonVisual/IPCLocationTest.cs
index db89855db7..952eb72bf4 100644
--- a/osu.Game.Tournament.Tests/NonVisual/IPCLocationTest.cs
+++ b/osu.Game.Tournament.Tests/NonVisual/IPCLocationTest.cs
@@ -2,9 +2,11 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System.IO;
+using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Platform;
+using osu.Framework.Testing;
 using osu.Game.Tournament.IO;
 using osu.Game.Tournament.IPC;
 
@@ -17,9 +19,9 @@ namespace osu.Game.Tournament.Tests.NonVisual
         public void CheckIPCLocation()
         {
             // don't use clean run because files are being written before osu! launches.
-            using (HeadlessGameHost host = new HeadlessGameHost(nameof(CheckIPCLocation)))
+            using (var host = new TestRunHeadlessGameHost(nameof(CheckIPCLocation)))
             {
-                string basePath = CustomTourneyDirectoryTest.PrepareBasePath(nameof(CheckIPCLocation));
+                string basePath = Path.Combine(host.UserStoragePaths.First(), nameof(CheckIPCLocation));
 
                 // Set up a fake IPC client for the IPC Storage to switch to.
                 string testStableInstallDirectory = Path.Combine(basePath, "stable-ce");
@@ -42,15 +44,6 @@ namespace osu.Game.Tournament.Tests.NonVisual
                 finally
                 {
                     host.Exit();
-
-                    try
-                    {
-                        if (Directory.Exists(basePath))
-                            Directory.Delete(basePath, true);
-                    }
-                    catch
-                    {
-                    }
                 }
             }
         }

From 1c0dc204c4f01b3c634c6319a336b1df79d3c915 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 24 Dec 2021 20:24:37 +0900
Subject: [PATCH 1839/5547] Fix some regressing behaviour due to
 `CleanRunHeadlessGameHost`'s naming structure changing

---
 osu.Game.Tests/Collections/IO/ImportCollectionsTest.cs |  8 ++++++--
 osu.Game.Tests/NonVisual/CustomDataDirectoryTest.cs    | 10 +++++-----
 osu.Game/Tests/CleanRunHeadlessGameHost.cs             |  2 ++
 3 files changed, 13 insertions(+), 7 deletions(-)

diff --git a/osu.Game.Tests/Collections/IO/ImportCollectionsTest.cs b/osu.Game.Tests/Collections/IO/ImportCollectionsTest.cs
index 686e053246..d4ec5e897b 100644
--- a/osu.Game.Tests/Collections/IO/ImportCollectionsTest.cs
+++ b/osu.Game.Tests/Collections/IO/ImportCollectionsTest.cs
@@ -128,8 +128,12 @@ namespace osu.Game.Tests.Collections.IO
         [Test]
         public async Task TestSaveAndReload()
         {
-            using (HeadlessGameHost host = new CleanRunHeadlessGameHost(bypassCleanup: true))
+            string firstRunName;
+
+            using (var host = new CleanRunHeadlessGameHost(bypassCleanup: true))
             {
+                firstRunName = host.Name;
+
                 try
                 {
                     var osu = LoadOsuIntoHost(host, true);
@@ -150,7 +154,7 @@ namespace osu.Game.Tests.Collections.IO
             }
 
             // Name matches the automatically chosen name from `CleanRunHeadlessGameHost` above, so we end up using the same storage location.
-            using (HeadlessGameHost host = new TestRunHeadlessGameHost(nameof(TestSaveAndReload)))
+            using (HeadlessGameHost host = new TestRunHeadlessGameHost(firstRunName))
             {
                 try
                 {
diff --git a/osu.Game.Tests/NonVisual/CustomDataDirectoryTest.cs b/osu.Game.Tests/NonVisual/CustomDataDirectoryTest.cs
index 999994cae0..4bb54f1625 100644
--- a/osu.Game.Tests/NonVisual/CustomDataDirectoryTest.cs
+++ b/osu.Game.Tests/NonVisual/CustomDataDirectoryTest.cs
@@ -25,7 +25,7 @@ namespace osu.Game.Tests.NonVisual
             {
                 try
                 {
-                    string defaultStorageLocation = getDefaultLocationFor(nameof(TestDefaultDirectory));
+                    string defaultStorageLocation = getDefaultLocationFor(host);
 
                     var osu = LoadOsuIntoHost(host);
                     var storage = osu.Dependencies.Get<Storage>();
@@ -109,7 +109,7 @@ namespace osu.Game.Tests.NonVisual
             {
                 try
                 {
-                    string defaultStorageLocation = getDefaultLocationFor(nameof(TestMigration));
+                    string defaultStorageLocation = getDefaultLocationFor(host);
 
                     var osu = LoadOsuIntoHost(host);
                     var storage = osu.Dependencies.Get<Storage>();
@@ -284,9 +284,9 @@ namespace osu.Game.Tests.NonVisual
             }
         }
 
-        private static string getDefaultLocationFor(string testTypeName)
+        private static string getDefaultLocationFor(CustomTestHeadlessGameHost host)
         {
-            string path = Path.Combine(TestRunHeadlessGameHost.TemporaryTestDirectory, testTypeName);
+            string path = Path.Combine(TestRunHeadlessGameHost.TemporaryTestDirectory, host.Name);
 
             if (Directory.Exists(path))
                 Directory.Delete(path, true);
@@ -315,7 +315,7 @@ namespace osu.Game.Tests.NonVisual
             public CustomTestHeadlessGameHost([CallerMemberName] string callingMethodName = @"")
                 : base(callingMethodName: callingMethodName)
             {
-                string defaultStorageLocation = getDefaultLocationFor(Name);
+                string defaultStorageLocation = getDefaultLocationFor(this);
 
                 InitialStorage = new DesktopStorage(defaultStorageLocation, this);
                 InitialStorage.DeleteDirectory(string.Empty);
diff --git a/osu.Game/Tests/CleanRunHeadlessGameHost.cs b/osu.Game/Tests/CleanRunHeadlessGameHost.cs
index 1c341ea243..2be2f3cd65 100644
--- a/osu.Game/Tests/CleanRunHeadlessGameHost.cs
+++ b/osu.Game/Tests/CleanRunHeadlessGameHost.cs
@@ -12,6 +12,8 @@ namespace osu.Game.Tests
     /// </summary>
     public class CleanRunHeadlessGameHost : TestRunHeadlessGameHost
     {
+        public new string Name => base.Name;
+
         /// <summary>
         /// Create a new instance.
         /// </summary>

From 99481d2b77d900d80421099164f053d8e5b278b8 Mon Sep 17 00:00:00 2001
From: Susko3 <16479013+Susko3@users.noreply.github.com>
Date: Fri, 24 Dec 2021 12:51:11 +0100
Subject: [PATCH 1840/5547] Update `OsuGameActivity` and manifest in line with
 framework changes

---
 osu.Android/OsuGameActivity.cs             | 7 +------
 osu.Android/Properties/AndroidManifest.xml | 6 ------
 osu.Android/Properties/AssemblyInfo.cs     | 8 ++++++++
 osu.Android/osu.Android.csproj             | 1 +
 4 files changed, 10 insertions(+), 12 deletions(-)
 create mode 100644 osu.Android/Properties/AssemblyInfo.cs

diff --git a/osu.Android/OsuGameActivity.cs b/osu.Android/OsuGameActivity.cs
index fec96c9165..3f53381f7e 100644
--- a/osu.Android/OsuGameActivity.cs
+++ b/osu.Android/OsuGameActivity.cs
@@ -17,7 +17,7 @@ using osu.Game.Database;
 
 namespace osu.Android
 {
-    [Activity(Theme = "@android:style/Theme.NoTitleBar", MainLauncher = true, ScreenOrientation = ScreenOrientation.FullUser, SupportsPictureInPicture = false, ConfigurationChanges = ConfigChanges.Orientation | ConfigChanges.ScreenSize, HardwareAccelerated = false, LaunchMode = LaunchMode.SingleInstance, Exported = true)]
+    [Activity(ConfigurationChanges = DEFAULT_CONFIG_CHANGES, LaunchMode = DEFAULT_LAUNCH_MODE, MainLauncher = true, ScreenOrientation = ScreenOrientation.FullUser)]
     [IntentFilter(new[] { Intent.ActionView }, Categories = new[] { Intent.CategoryDefault }, DataScheme = "content", DataPathPattern = ".*\\\\.osz", DataHost = "*", DataMimeType = "*/*")]
     [IntentFilter(new[] { Intent.ActionView }, Categories = new[] { Intent.CategoryDefault }, DataScheme = "content", DataPathPattern = ".*\\\\.osk", DataHost = "*", DataMimeType = "*/*")]
     [IntentFilter(new[] { Intent.ActionView }, Categories = new[] { Intent.CategoryDefault }, DataScheme = "content", DataPathPattern = ".*\\\\.osr", DataHost = "*", DataMimeType = "*/*")]
@@ -47,11 +47,6 @@ namespace osu.Android
 
         protected override void OnCreate(Bundle savedInstanceState)
         {
-            // The default current directory on android is '/'.
-            // On some devices '/' maps to the app data directory. On others it maps to the root of the internal storage.
-            // In order to have a consistent current directory on all devices the full path of the app data directory is set as the current directory.
-            System.Environment.CurrentDirectory = System.Environment.GetFolderPath(System.Environment.SpecialFolder.Personal);
-
             base.OnCreate(savedInstanceState);
 
             // OnNewIntent() only fires for an activity if it's *re-launched* while it's on top of the activity stack.
diff --git a/osu.Android/Properties/AndroidManifest.xml b/osu.Android/Properties/AndroidManifest.xml
index e717bab310..165a64a424 100644
--- a/osu.Android/Properties/AndroidManifest.xml
+++ b/osu.Android/Properties/AndroidManifest.xml
@@ -1,11 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
 <manifest xmlns:android="http://schemas.android.com/apk/res/android" android:versionCode="1" package="sh.ppy.osulazer" android:installLocation="auto" android:versionName="0.1.0">
 	<uses-sdk android:minSdkVersion="21" android:targetSdkVersion="29" />
-	<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
-	<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
-	<uses-permission android:name="android.permission.WAKE_LOCK" />
-	<uses-permission android:name="android.permission.READ_FRAME_BUFFER" />
-	<uses-permission android:name="android.permission.INTERNET" />
-	<uses-permission android:name="android.permission.BATTERY_STATS" />
 	<application android:allowBackup="true" android:supportsRtl="true" android:label="osu!" android:icon="@drawable/lazer" />
 </manifest>
\ No newline at end of file
diff --git a/osu.Android/Properties/AssemblyInfo.cs b/osu.Android/Properties/AssemblyInfo.cs
new file mode 100644
index 0000000000..c0ba324d6e
--- /dev/null
+++ b/osu.Android/Properties/AssemblyInfo.cs
@@ -0,0 +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 Android;
+using Android.App;
+
+// used for AndroidBatteryInfo
+[assembly: UsesPermission(Manifest.Permission.BatteryStats)]
diff --git a/osu.Android/osu.Android.csproj b/osu.Android/osu.Android.csproj
index b2599535ae..fc50ca9fa1 100644
--- a/osu.Android/osu.Android.csproj
+++ b/osu.Android/osu.Android.csproj
@@ -29,6 +29,7 @@
     <Compile Include="GameplayScreenRotationLocker.cs" />
     <Compile Include="OsuGameActivity.cs" />
     <Compile Include="OsuGameAndroid.cs" />
+    <Compile Include="Properties\AssemblyInfo.cs" />
   </ItemGroup>
   <ItemGroup>
     <None Include="Properties\AndroidManifest.xml" />

From b220cc0723782e0f79c56d2e23177b3435195146 Mon Sep 17 00:00:00 2001
From: Susko3 <16479013+Susko3@users.noreply.github.com>
Date: Fri, 24 Dec 2021 13:15:27 +0100
Subject: [PATCH 1841/5547] Update tests' Activities

---
 osu.Game.Rulesets.Catch.Tests.Android/MainActivity.cs | 3 +--
 osu.Game.Rulesets.Mania.Tests.Android/MainActivity.cs | 3 +--
 osu.Game.Rulesets.Osu.Tests.Android/MainActivity.cs   | 3 +--
 osu.Game.Rulesets.Taiko.Tests.Android/MainActivity.cs | 3 +--
 osu.Game.Tests.Android/MainActivity.cs                | 3 +--
 5 files changed, 5 insertions(+), 10 deletions(-)

diff --git a/osu.Game.Rulesets.Catch.Tests.Android/MainActivity.cs b/osu.Game.Rulesets.Catch.Tests.Android/MainActivity.cs
index d918305f3d..596ac4e682 100644
--- a/osu.Game.Rulesets.Catch.Tests.Android/MainActivity.cs
+++ b/osu.Game.Rulesets.Catch.Tests.Android/MainActivity.cs
@@ -2,13 +2,12 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using Android.App;
-using Android.Content.PM;
 using osu.Framework.Android;
 using osu.Game.Tests;
 
 namespace osu.Game.Rulesets.Catch.Tests.Android
 {
-    [Activity(Theme = "@android:style/Theme.NoTitleBar", MainLauncher = true, ScreenOrientation = ScreenOrientation.SensorLandscape, SupportsPictureInPicture = false, ConfigurationChanges = ConfigChanges.Orientation | ConfigChanges.ScreenSize)]
+    [Activity(ConfigurationChanges = DEFAULT_CONFIG_CHANGES, LaunchMode = DEFAULT_LAUNCH_MODE, MainLauncher = true)]
     public class MainActivity : AndroidGameActivity
     {
         protected override Framework.Game CreateGame() => new OsuTestBrowser();
diff --git a/osu.Game.Rulesets.Mania.Tests.Android/MainActivity.cs b/osu.Game.Rulesets.Mania.Tests.Android/MainActivity.cs
index 0a3f05ae54..f59fa36fb9 100644
--- a/osu.Game.Rulesets.Mania.Tests.Android/MainActivity.cs
+++ b/osu.Game.Rulesets.Mania.Tests.Android/MainActivity.cs
@@ -2,13 +2,12 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using Android.App;
-using Android.Content.PM;
 using osu.Framework.Android;
 using osu.Game.Tests;
 
 namespace osu.Game.Rulesets.Mania.Tests.Android
 {
-    [Activity(Theme = "@android:style/Theme.NoTitleBar", MainLauncher = true, ScreenOrientation = ScreenOrientation.SensorLandscape, SupportsPictureInPicture = false, ConfigurationChanges = ConfigChanges.Orientation | ConfigChanges.ScreenSize)]
+    [Activity(ConfigurationChanges = DEFAULT_CONFIG_CHANGES, LaunchMode = DEFAULT_LAUNCH_MODE, MainLauncher = true)]
     public class MainActivity : AndroidGameActivity
     {
         protected override Framework.Game CreateGame() => new OsuTestBrowser();
diff --git a/osu.Game.Rulesets.Osu.Tests.Android/MainActivity.cs b/osu.Game.Rulesets.Osu.Tests.Android/MainActivity.cs
index e6c508d99e..c313329c14 100644
--- a/osu.Game.Rulesets.Osu.Tests.Android/MainActivity.cs
+++ b/osu.Game.Rulesets.Osu.Tests.Android/MainActivity.cs
@@ -2,13 +2,12 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using Android.App;
-using Android.Content.PM;
 using osu.Framework.Android;
 using osu.Game.Tests;
 
 namespace osu.Game.Rulesets.Osu.Tests.Android
 {
-    [Activity(Theme = "@android:style/Theme.NoTitleBar", MainLauncher = true, ScreenOrientation = ScreenOrientation.SensorLandscape, SupportsPictureInPicture = false, ConfigurationChanges = ConfigChanges.Orientation | ConfigChanges.ScreenSize)]
+    [Activity(ConfigurationChanges = DEFAULT_CONFIG_CHANGES, LaunchMode = DEFAULT_LAUNCH_MODE, MainLauncher = true)]
     public class MainActivity : AndroidGameActivity
     {
         protected override Framework.Game CreateGame() => new OsuTestBrowser();
diff --git a/osu.Game.Rulesets.Taiko.Tests.Android/MainActivity.cs b/osu.Game.Rulesets.Taiko.Tests.Android/MainActivity.cs
index 1128a0d37f..c05c932299 100644
--- a/osu.Game.Rulesets.Taiko.Tests.Android/MainActivity.cs
+++ b/osu.Game.Rulesets.Taiko.Tests.Android/MainActivity.cs
@@ -2,13 +2,12 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using Android.App;
-using Android.Content.PM;
 using osu.Framework.Android;
 using osu.Game.Tests;
 
 namespace osu.Game.Rulesets.Taiko.Tests.Android
 {
-    [Activity(Theme = "@android:style/Theme.NoTitleBar", MainLauncher = true, ScreenOrientation = ScreenOrientation.SensorLandscape, SupportsPictureInPicture = false, ConfigurationChanges = ConfigChanges.Orientation | ConfigChanges.ScreenSize)]
+    [Activity(ConfigurationChanges = DEFAULT_CONFIG_CHANGES, LaunchMode = DEFAULT_LAUNCH_MODE, MainLauncher = true)]
     public class MainActivity : AndroidGameActivity
     {
         protected override Framework.Game CreateGame() => new OsuTestBrowser();
diff --git a/osu.Game.Tests.Android/MainActivity.cs b/osu.Game.Tests.Android/MainActivity.cs
index 0695c8e37b..d59cefbdab 100644
--- a/osu.Game.Tests.Android/MainActivity.cs
+++ b/osu.Game.Tests.Android/MainActivity.cs
@@ -2,12 +2,11 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using Android.App;
-using Android.Content.PM;
 using osu.Framework.Android;
 
 namespace osu.Game.Tests.Android
 {
-    [Activity(Theme = "@android:style/Theme.NoTitleBar", MainLauncher = true, ScreenOrientation = ScreenOrientation.SensorLandscape, SupportsPictureInPicture = false, ConfigurationChanges = ConfigChanges.Orientation | ConfigChanges.ScreenSize, HardwareAccelerated = true)]
+    [Activity(ConfigurationChanges = DEFAULT_CONFIG_CHANGES, LaunchMode = DEFAULT_LAUNCH_MODE, MainLauncher = true)]
     public class MainActivity : AndroidGameActivity
     {
         protected override Framework.Game CreateGame() => new OsuTestBrowser();

From c6854b37c896fd57f91e7d86f73524a093407be5 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 24 Dec 2021 21:57:29 +0900
Subject: [PATCH 1842/5547] Unbind event on disposal

---
 osu.Game/Screens/OnlinePlay/Multiplayer/Multiplayer.cs | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Multiplayer.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Multiplayer.cs
index 2663f4f05f..609880a725 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Multiplayer.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Multiplayer.cs
@@ -70,5 +70,13 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
         protected override RoomManager CreateRoomManager() => new MultiplayerRoomManager();
 
         protected override LoungeSubScreen CreateLounge() => new MultiplayerLoungeSubScreen();
+
+        protected override void Dispose(bool isDisposing)
+        {
+            base.Dispose(isDisposing);
+
+            if (client != null)
+                client.RoomUpdated -= onRoomUpdated;
+        }
     }
 }

From a43cc20ae21cd9c2e3ff76ef9e70a1fdc094c9ef Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 24 Dec 2021 21:58:20 +0900
Subject: [PATCH 1843/5547] Apply changes to GameplayCompleted from reviews

---
 osu.Game/Screens/OnlinePlay/Multiplayer/Multiplayer.cs       | 2 +-
 .../OnlinePlay/Multiplayer/MultiplayerPlayerLoader.cs        | 2 +-
 osu.Game/Screens/Play/Player.cs                              | 5 +++--
 3 files changed, 5 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Multiplayer.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Multiplayer.cs
index 609880a725..28c9bef3f0 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Multiplayer.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Multiplayer.cs
@@ -46,7 +46,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
                 return;
 
             // If gameplay wasn't finished, then we have a simple path back to the idle state by aborting gameplay.
-            if (!playerLoader.GameplayCompleted)
+            if (!playerLoader.GameplayPassed)
             {
                 client.AbortGameplay();
                 return;
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayerLoader.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayerLoader.cs
index 21459ae5fb..470ba59a76 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayerLoader.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayerLoader.cs
@@ -9,7 +9,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
 {
     public class MultiplayerPlayerLoader : PlayerLoader
     {
-        public bool GameplayCompleted => player?.GameplayCompleted == true;
+        public bool GameplayPassed => player?.GameplayPassed == true;
 
         private Player player;
 
diff --git a/osu.Game/Screens/Play/Player.cs b/osu.Game/Screens/Play/Player.cs
index 34db9d39b5..77a6b27114 100644
--- a/osu.Game/Screens/Play/Player.cs
+++ b/osu.Game/Screens/Play/Player.cs
@@ -69,7 +69,7 @@ namespace osu.Game.Screens.Play
         /// <summary>
         /// Whether gameplay has completed without the user having failed.
         /// </summary>
-        public bool GameplayCompleted { get; private set; }
+        public bool GameplayPassed { get; private set; }
 
         public Action RestartRequested;
 
@@ -671,6 +671,7 @@ namespace osu.Game.Screens.Play
                 resultsDisplayDelegate?.Cancel();
                 resultsDisplayDelegate = null;
 
+                GameplayPassed = false;
                 ValidForResume = true;
                 skipOutroOverlay.Hide();
                 return;
@@ -680,7 +681,7 @@ namespace osu.Game.Screens.Play
             if (HealthProcessor.HasFailed)
                 return;
 
-            GameplayCompleted = true;
+            GameplayPassed = true;
 
             // Setting this early in the process means that even if something were to go wrong in the order of events following, there
             // is no chance that a user could return to the (already completed) Player instance from a child screen.

From a9a7a339741104ace46f6f4af009e3a4dda91ea1 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 25 Dec 2021 02:03:58 +0900
Subject: [PATCH 1844/5547] Update framework

---
 osu.Android.props                          | 2 +-
 osu.Game/Tests/CleanRunHeadlessGameHost.cs | 2 --
 osu.Game/osu.Game.csproj                   | 2 +-
 osu.iOS.props                              | 4 ++--
 4 files changed, 4 insertions(+), 6 deletions(-)

diff --git a/osu.Android.props b/osu.Android.props
index 4f0125bed2..31a3bc8c45 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -52,7 +52,7 @@
   </ItemGroup>
   <ItemGroup>
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1215.0" />
-    <PackageReference Include="ppy.osu.Framework.Android" Version="2021.1222.0" />
+    <PackageReference Include="ppy.osu.Framework.Android" Version="2021.1225.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
     <!-- Realm needs to be directly referenced in all Xamarin projects, as it will not pull in its transitive dependencies otherwise. -->
diff --git a/osu.Game/Tests/CleanRunHeadlessGameHost.cs b/osu.Game/Tests/CleanRunHeadlessGameHost.cs
index 2be2f3cd65..1c341ea243 100644
--- a/osu.Game/Tests/CleanRunHeadlessGameHost.cs
+++ b/osu.Game/Tests/CleanRunHeadlessGameHost.cs
@@ -12,8 +12,6 @@ namespace osu.Game.Tests
     /// </summary>
     public class CleanRunHeadlessGameHost : TestRunHeadlessGameHost
     {
-        public new string Name => base.Name;
-
         /// <summary>
         /// Create a new instance.
         /// </summary>
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 565f78e2d4..2c97bae360 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="10.7.1" />
-    <PackageReference Include="ppy.osu.Framework" Version="2021.1222.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2021.1225.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1215.0" />
     <PackageReference Include="Sentry" Version="3.12.1" />
     <PackageReference Include="SharpCompress" Version="0.30.1" />
diff --git a/osu.iOS.props b/osu.iOS.props
index bdb3b0b149..de084c0297 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -60,7 +60,7 @@
     <Reference Include="System.Net.Http" />
   </ItemGroup>
   <ItemGroup Label="Package References">
-    <PackageReference Include="ppy.osu.Framework.iOS" Version="2021.1222.0" />
+    <PackageReference Include="ppy.osu.Framework.iOS" Version="2021.1225.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1215.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net5.0 / net6.0) -->
@@ -83,7 +83,7 @@
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="2.2.6" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.Core" Version="2.2.6" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
-    <PackageReference Include="ppy.osu.Framework" Version="2021.1222.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2021.1225.0" />
     <PackageReference Include="SharpCompress" Version="0.30.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
     <PackageReference Include="SharpRaven" Version="2.4.0" />

From 7088471cad90a50998b594c48049ae0920cbe608 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 24 Dec 2021 23:55:08 +0900
Subject: [PATCH 1845/5547] Protect against test failures due to logger being
 set too early (and beginning logging)

---
 osu.Game/Tests/CleanRunHeadlessGameHost.cs | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Tests/CleanRunHeadlessGameHost.cs b/osu.Game/Tests/CleanRunHeadlessGameHost.cs
index 1c341ea243..754c9044e8 100644
--- a/osu.Game/Tests/CleanRunHeadlessGameHost.cs
+++ b/osu.Game/Tests/CleanRunHeadlessGameHost.cs
@@ -26,7 +26,14 @@ namespace osu.Game.Tests
 
         protected override void SetupForRun()
         {
-            Storage.DeleteDirectory(string.Empty);
+            try
+            {
+                Storage.DeleteDirectory(string.Empty);
+            }
+            catch
+            {
+                // May fail if a logging target has already been set via OsuStorage.ChangeTargetStorage.
+            }
 
             // base call needs to be run *after* storage is emptied, as it updates the (static) logger's storage and may start writing
             // log entries from another source if a unit test host is shared over multiple tests, causing a file access denied exception.

From 5b4ce7f11ba2a50c4b49e7b8c870c8b231d450bf Mon Sep 17 00:00:00 2001
From: Susko3 <16479013+Susko3@users.noreply.github.com>
Date: Fri, 24 Dec 2021 18:57:08 +0100
Subject: [PATCH 1846/5547] Add explicit `Exported = true`

---
 osu.Android/OsuGameActivity.cs                        | 2 +-
 osu.Game.Rulesets.Catch.Tests.Android/MainActivity.cs | 2 +-
 osu.Game.Rulesets.Mania.Tests.Android/MainActivity.cs | 2 +-
 osu.Game.Rulesets.Osu.Tests.Android/MainActivity.cs   | 2 +-
 osu.Game.Rulesets.Taiko.Tests.Android/MainActivity.cs | 2 +-
 osu.Game.Tests.Android/MainActivity.cs                | 2 +-
 6 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/osu.Android/OsuGameActivity.cs b/osu.Android/OsuGameActivity.cs
index 3f53381f7e..c9fb539d8a 100644
--- a/osu.Android/OsuGameActivity.cs
+++ b/osu.Android/OsuGameActivity.cs
@@ -17,7 +17,7 @@ using osu.Game.Database;
 
 namespace osu.Android
 {
-    [Activity(ConfigurationChanges = DEFAULT_CONFIG_CHANGES, LaunchMode = DEFAULT_LAUNCH_MODE, MainLauncher = true, ScreenOrientation = ScreenOrientation.FullUser)]
+    [Activity(ConfigurationChanges = DEFAULT_CONFIG_CHANGES, Exported = true, LaunchMode = DEFAULT_LAUNCH_MODE, MainLauncher = true, ScreenOrientation = ScreenOrientation.FullUser)]
     [IntentFilter(new[] { Intent.ActionView }, Categories = new[] { Intent.CategoryDefault }, DataScheme = "content", DataPathPattern = ".*\\\\.osz", DataHost = "*", DataMimeType = "*/*")]
     [IntentFilter(new[] { Intent.ActionView }, Categories = new[] { Intent.CategoryDefault }, DataScheme = "content", DataPathPattern = ".*\\\\.osk", DataHost = "*", DataMimeType = "*/*")]
     [IntentFilter(new[] { Intent.ActionView }, Categories = new[] { Intent.CategoryDefault }, DataScheme = "content", DataPathPattern = ".*\\\\.osr", DataHost = "*", DataMimeType = "*/*")]
diff --git a/osu.Game.Rulesets.Catch.Tests.Android/MainActivity.cs b/osu.Game.Rulesets.Catch.Tests.Android/MainActivity.cs
index 596ac4e682..d8b729576d 100644
--- a/osu.Game.Rulesets.Catch.Tests.Android/MainActivity.cs
+++ b/osu.Game.Rulesets.Catch.Tests.Android/MainActivity.cs
@@ -7,7 +7,7 @@ using osu.Game.Tests;
 
 namespace osu.Game.Rulesets.Catch.Tests.Android
 {
-    [Activity(ConfigurationChanges = DEFAULT_CONFIG_CHANGES, LaunchMode = DEFAULT_LAUNCH_MODE, MainLauncher = true)]
+    [Activity(ConfigurationChanges = DEFAULT_CONFIG_CHANGES, Exported = true, LaunchMode = DEFAULT_LAUNCH_MODE, MainLauncher = true)]
     public class MainActivity : AndroidGameActivity
     {
         protected override Framework.Game CreateGame() => new OsuTestBrowser();
diff --git a/osu.Game.Rulesets.Mania.Tests.Android/MainActivity.cs b/osu.Game.Rulesets.Mania.Tests.Android/MainActivity.cs
index f59fa36fb9..518071fd49 100644
--- a/osu.Game.Rulesets.Mania.Tests.Android/MainActivity.cs
+++ b/osu.Game.Rulesets.Mania.Tests.Android/MainActivity.cs
@@ -7,7 +7,7 @@ using osu.Game.Tests;
 
 namespace osu.Game.Rulesets.Mania.Tests.Android
 {
-    [Activity(ConfigurationChanges = DEFAULT_CONFIG_CHANGES, LaunchMode = DEFAULT_LAUNCH_MODE, MainLauncher = true)]
+    [Activity(ConfigurationChanges = DEFAULT_CONFIG_CHANGES, Exported = true, LaunchMode = DEFAULT_LAUNCH_MODE, MainLauncher = true)]
     public class MainActivity : AndroidGameActivity
     {
         protected override Framework.Game CreateGame() => new OsuTestBrowser();
diff --git a/osu.Game.Rulesets.Osu.Tests.Android/MainActivity.cs b/osu.Game.Rulesets.Osu.Tests.Android/MainActivity.cs
index c313329c14..46c60f06a5 100644
--- a/osu.Game.Rulesets.Osu.Tests.Android/MainActivity.cs
+++ b/osu.Game.Rulesets.Osu.Tests.Android/MainActivity.cs
@@ -7,7 +7,7 @@ using osu.Game.Tests;
 
 namespace osu.Game.Rulesets.Osu.Tests.Android
 {
-    [Activity(ConfigurationChanges = DEFAULT_CONFIG_CHANGES, LaunchMode = DEFAULT_LAUNCH_MODE, MainLauncher = true)]
+    [Activity(ConfigurationChanges = DEFAULT_CONFIG_CHANGES, Exported = true, LaunchMode = DEFAULT_LAUNCH_MODE, MainLauncher = true)]
     public class MainActivity : AndroidGameActivity
     {
         protected override Framework.Game CreateGame() => new OsuTestBrowser();
diff --git a/osu.Game.Rulesets.Taiko.Tests.Android/MainActivity.cs b/osu.Game.Rulesets.Taiko.Tests.Android/MainActivity.cs
index c05c932299..e4f4bbfd53 100644
--- a/osu.Game.Rulesets.Taiko.Tests.Android/MainActivity.cs
+++ b/osu.Game.Rulesets.Taiko.Tests.Android/MainActivity.cs
@@ -7,7 +7,7 @@ using osu.Game.Tests;
 
 namespace osu.Game.Rulesets.Taiko.Tests.Android
 {
-    [Activity(ConfigurationChanges = DEFAULT_CONFIG_CHANGES, LaunchMode = DEFAULT_LAUNCH_MODE, MainLauncher = true)]
+    [Activity(ConfigurationChanges = DEFAULT_CONFIG_CHANGES, Exported = true, LaunchMode = DEFAULT_LAUNCH_MODE, MainLauncher = true)]
     public class MainActivity : AndroidGameActivity
     {
         protected override Framework.Game CreateGame() => new OsuTestBrowser();
diff --git a/osu.Game.Tests.Android/MainActivity.cs b/osu.Game.Tests.Android/MainActivity.cs
index d59cefbdab..dbe74a10da 100644
--- a/osu.Game.Tests.Android/MainActivity.cs
+++ b/osu.Game.Tests.Android/MainActivity.cs
@@ -6,7 +6,7 @@ using osu.Framework.Android;
 
 namespace osu.Game.Tests.Android
 {
-    [Activity(ConfigurationChanges = DEFAULT_CONFIG_CHANGES, LaunchMode = DEFAULT_LAUNCH_MODE, MainLauncher = true)]
+    [Activity(ConfigurationChanges = DEFAULT_CONFIG_CHANGES, Exported = true, LaunchMode = DEFAULT_LAUNCH_MODE, MainLauncher = true)]
     public class MainActivity : AndroidGameActivity
     {
         protected override Framework.Game CreateGame() => new OsuTestBrowser();

From e448c28cade0b45e9660d5b76969e9951fbacd76 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 26 Dec 2021 16:26:33 +0900
Subject: [PATCH 1847/5547] Change `IdleHandler` to not consider mouse movement
 as active unless focused

---
 osu.Game/Input/IdleTracker.cs | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/osu.Game/Input/IdleTracker.cs b/osu.Game/Input/IdleTracker.cs
index bfe21f650a..4ef676b3b6 100644
--- a/osu.Game/Input/IdleTracker.cs
+++ b/osu.Game/Input/IdleTracker.cs
@@ -1,11 +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.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Input;
 using osu.Framework.Input.Bindings;
 using osu.Framework.Input.Events;
+using osu.Framework.Platform;
 using osu.Game.Input.Bindings;
 
 namespace osu.Game.Input
@@ -63,8 +65,14 @@ namespace osu.Game.Input
 
         public void OnReleased(KeyBindingReleaseEvent<GlobalAction> e) => updateLastInteractionTime();
 
+        [Resolved]
+        private GameHost host { get; set; }
+
         protected override bool Handle(UIEvent e)
         {
+            if (!host.IsActive.Value)
+                return base.Handle(e);
+
             switch (e)
             {
                 case KeyDownEvent _:

From 7c25ce81e16d8cd546c2b6eab562e6cf9acf63ce Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 26 Dec 2021 16:26:47 +0900
Subject: [PATCH 1848/5547] Further reduce chat poll rate when idle or not
 visible

---
 osu.Game/Online/Chat/ChannelManager.cs | 25 ++++++++++++++++++++++++-
 1 file changed, 24 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Online/Chat/ChannelManager.cs b/osu.Game/Online/Chat/ChannelManager.cs
index edaf135e93..4889ad0a3b 100644
--- a/osu.Game/Online/Chat/ChannelManager.cs
+++ b/osu.Game/Online/Chat/ChannelManager.cs
@@ -9,6 +9,7 @@ using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Logging;
 using osu.Game.Database;
+using osu.Game.Input;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests;
 using osu.Game.Online.API.Requests.Responses;
@@ -67,11 +68,33 @@ namespace osu.Game.Online.Chat
 
         public readonly BindableBool HighPollRate = new BindableBool();
 
+        private IBindable<bool> isIdle;
+
         public ChannelManager()
         {
             CurrentChannel.ValueChanged += currentChannelChanged;
+        }
 
-            HighPollRate.BindValueChanged(enabled => TimeBetweenPolls.Value = enabled.NewValue ? 1000 : 6000, true);
+        [BackgroundDependencyLoader]
+        private void load(IdleTracker idleTracker)
+        {
+            HighPollRate.BindValueChanged(updatePollRate);
+
+            isIdle = idleTracker.IsIdle.GetBoundCopy();
+            isIdle.BindValueChanged(updatePollRate, true);
+        }
+
+        private void updatePollRate(ValueChangedEvent<bool> valueChangedEvent)
+        {
+            // Polling will eventually be replaced with websocket, but let's avoid doing these background operations as much as possible for now.
+            // The only loss will be delayed PM/message highlight notifications.
+
+            if (HighPollRate.Value)
+                TimeBetweenPolls.Value = 1000;
+            else if (!isIdle.Value)
+                TimeBetweenPolls.Value = 60000;
+            else
+                TimeBetweenPolls.Value = 600000;
         }
 
         /// <summary>

From 2b4c2f7ff3a6a606a1c9bfb98089a061780e1360 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 26 Dec 2021 14:23:52 +0100
Subject: [PATCH 1849/5547] Add failing test for storyboard sample playback
 with beatmap hitsounds off

---
 .../Gameplay/TestSceneStoryboardSamples.cs    | 38 +++++++++++++++++++
 1 file changed, 38 insertions(+)

diff --git a/osu.Game.Tests/Gameplay/TestSceneStoryboardSamples.cs b/osu.Game.Tests/Gameplay/TestSceneStoryboardSamples.cs
index 28915b2c4a..f0ebd7a8cc 100644
--- a/osu.Game.Tests/Gameplay/TestSceneStoryboardSamples.cs
+++ b/osu.Game.Tests/Gameplay/TestSceneStoryboardSamples.cs
@@ -8,6 +8,7 @@ using System.Linq;
 using System.Threading;
 using System.Threading.Tasks;
 using NUnit.Framework;
+using osu.Framework.Allocation;
 using osu.Framework.Audio;
 using osu.Framework.Audio.Sample;
 using osu.Framework.Graphics.Audio;
@@ -16,6 +17,7 @@ using osu.Framework.IO.Stores;
 using osu.Framework.Testing;
 using osu.Framework.Utils;
 using osu.Game.Audio;
+using osu.Game.Configuration;
 using osu.Game.Database;
 using osu.Game.IO;
 using osu.Game.Rulesets;
@@ -35,6 +37,9 @@ namespace osu.Game.Tests.Gameplay
     [HeadlessTest]
     public class TestSceneStoryboardSamples : OsuTestScene, IStorageResourceProvider
     {
+        [Resolved]
+        private OsuConfigManager config { get; set; }
+
         [Test]
         public void TestRetrieveTopLevelSample()
         {
@@ -166,6 +171,39 @@ namespace osu.Game.Tests.Gameplay
                     ((IApplicableToRate)testedMod).ApplyToRate(sampleInfo.StartTime)));
         }
 
+        [Test]
+        public void TestSamplePlaybackWithBeatmapHitsoundsOff()
+        {
+            GameplayClockContainer gameplayContainer = null;
+            TestDrawableStoryboardSample sample = null;
+
+            AddStep("disable beatmap hitsounds", () => config.SetValue(OsuSetting.BeatmapHitsounds, false));
+
+            AddStep("setup storyboard sample", () =>
+            {
+                Beatmap.Value = new TestCustomSkinWorkingBeatmap(new OsuRuleset().RulesetInfo, this);
+
+                var beatmapSkinSourceContainer = new BeatmapSkinProvidingContainer(Beatmap.Value.Skin);
+
+                Add(gameplayContainer = new MasterGameplayClockContainer(Beatmap.Value, 0)
+                {
+                    Child = beatmapSkinSourceContainer
+                });
+
+                beatmapSkinSourceContainer.Add(sample = new TestDrawableStoryboardSample(new StoryboardSampleInfo("test-sample", 1, 1))
+                {
+                    Clock = gameplayContainer.GameplayClock
+                });
+            });
+
+            AddStep("start", () => gameplayContainer.Start());
+
+            AddUntilStep("sample played", () => sample.IsPlayed);
+            AddUntilStep("sample has lifetime end", () => sample.LifetimeEnd < double.MaxValue);
+
+            AddStep("restore default", () => config.GetBindable<bool>(OsuSetting.BeatmapHitsounds).SetDefault());
+        }
+
         private class TestSkin : LegacySkin
         {
             public TestSkin(string resourceName, IStorageResourceProvider resources)

From dc21c8901e6827edfda2ff9e43a3b90a361c8ec0 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 26 Dec 2021 14:25:28 +0100
Subject: [PATCH 1850/5547] Always allow looking up storyboard samples from
 beatmap skin

---
 osu.Game/Skinning/BeatmapSkinProvidingContainer.cs | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Skinning/BeatmapSkinProvidingContainer.cs b/osu.Game/Skinning/BeatmapSkinProvidingContainer.cs
index 57c08a903f..1f4e10916d 100644
--- a/osu.Game/Skinning/BeatmapSkinProvidingContainer.cs
+++ b/osu.Game/Skinning/BeatmapSkinProvidingContainer.cs
@@ -6,6 +6,7 @@ using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Game.Audio;
 using osu.Game.Configuration;
+using osu.Game.Storyboards;
 
 namespace osu.Game.Skinning
 {
@@ -61,7 +62,7 @@ namespace osu.Game.Skinning
             if (beatmapSkins == null)
                 throw new InvalidOperationException($"{nameof(BeatmapSkinProvidingContainer)} needs to be loaded before being consumed.");
 
-            return beatmapHitsounds.Value;
+            return componentName is StoryboardSampleInfo || beatmapHitsounds.Value;
         }
 
         public BeatmapSkinProvidingContainer(ISkin skin)

From 724b601d2ad71c763a2be29b7dd52a3e37bdc944 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 26 Dec 2021 14:29:07 +0100
Subject: [PATCH 1851/5547] Rename `AllowSampleLookup` argument to something
 saner

---
 osu.Game/Skinning/BeatmapSkinProvidingContainer.cs | 4 ++--
 osu.Game/Skinning/SkinProvidingContainer.cs        | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Skinning/BeatmapSkinProvidingContainer.cs b/osu.Game/Skinning/BeatmapSkinProvidingContainer.cs
index 1f4e10916d..2ba301deed 100644
--- a/osu.Game/Skinning/BeatmapSkinProvidingContainer.cs
+++ b/osu.Game/Skinning/BeatmapSkinProvidingContainer.cs
@@ -57,12 +57,12 @@ namespace osu.Game.Skinning
             return beatmapSkins.Value;
         }
 
-        protected override bool AllowSampleLookup(ISampleInfo componentName)
+        protected override bool AllowSampleLookup(ISampleInfo sampleInfo)
         {
             if (beatmapSkins == null)
                 throw new InvalidOperationException($"{nameof(BeatmapSkinProvidingContainer)} needs to be loaded before being consumed.");
 
-            return componentName is StoryboardSampleInfo || beatmapHitsounds.Value;
+            return sampleInfo is StoryboardSampleInfo || beatmapHitsounds.Value;
         }
 
         public BeatmapSkinProvidingContainer(ISkin skin)
diff --git a/osu.Game/Skinning/SkinProvidingContainer.cs b/osu.Game/Skinning/SkinProvidingContainer.cs
index c8e4c2c7b6..24198254a3 100644
--- a/osu.Game/Skinning/SkinProvidingContainer.cs
+++ b/osu.Game/Skinning/SkinProvidingContainer.cs
@@ -35,7 +35,7 @@ namespace osu.Game.Skinning
 
         protected virtual bool AllowTextureLookup(string componentName) => true;
 
-        protected virtual bool AllowSampleLookup(ISampleInfo componentName) => true;
+        protected virtual bool AllowSampleLookup(ISampleInfo sampleInfo) => true;
 
         protected virtual bool AllowConfigurationLookup => true;
 

From 34b0101ff4d5688c8ff08a4d433dcc1210a94b53 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 26 Dec 2021 16:44:39 +0100
Subject: [PATCH 1852/5547] Add visual test coverage of "hidden by ruleset"
 combo option

---
 .../Gameplay/TestSceneSkinnableComboCounter.cs      | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableComboCounter.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableComboCounter.cs
index 1c5a05dd1d..bd1fe050af 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableComboCounter.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableComboCounter.cs
@@ -4,6 +4,7 @@
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
+using osu.Framework.Testing;
 using osu.Game.Rulesets.Scoring;
 using osu.Game.Screens.Play.HUD;
 
@@ -24,5 +25,17 @@ namespace osu.Game.Tests.Visual.Gameplay
 
             AddStep("reset combo", () => scoreProcessor.Combo.Value = 0);
         }
+
+        [Test]
+        public void TestLegacyComboCounterHiddenByRulesetImplementation()
+        {
+            AddToggleStep("toggle legacy hidden by ruleset", visible =>
+            {
+                foreach (var legacyCounter in this.ChildrenOfType<LegacyComboCounter>())
+                    legacyCounter.HiddenByRulesetImplementation = visible;
+            });
+
+            AddRepeatStep("increase combo", () => scoreProcessor.Combo.Value++, 10);
+        }
     }
 }

From 5a591713aeddc1f2d955c6d551879ce7478aa32e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 26 Dec 2021 16:44:59 +0100
Subject: [PATCH 1853/5547] Fix legacy combo counter not fully hiding for
 rulesets that implement their own

---
 .../Screens/Play/HUD/LegacyComboCounter.cs     | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/osu.Game/Screens/Play/HUD/LegacyComboCounter.cs b/osu.Game/Screens/Play/HUD/LegacyComboCounter.cs
index f1078c5d55..567e4386c6 100644
--- a/osu.Game/Screens/Play/HUD/LegacyComboCounter.cs
+++ b/osu.Game/Screens/Play/HUD/LegacyComboCounter.cs
@@ -69,21 +69,21 @@ namespace osu.Game.Screens.Play.HUD
 
             InternalChildren = new[]
             {
-                popOutCount = new LegacySpriteText(LegacyFont.Combo)
-                {
-                    Alpha = 0,
-                    Margin = new MarginPadding(0.05f),
-                    Blending = BlendingParameters.Additive,
-                    Anchor = Anchor.BottomLeft,
-                    Origin = Anchor.BottomLeft,
-                    BypassAutoSizeAxes = Axes.Both,
-                },
                 counterContainer = new Container
                 {
                     AutoSizeAxes = Axes.Both,
                     AlwaysPresent = true,
                     Children = new[]
                     {
+                        popOutCount = new LegacySpriteText(LegacyFont.Combo)
+                        {
+                            Alpha = 0,
+                            Margin = new MarginPadding(0.05f),
+                            Blending = BlendingParameters.Additive,
+                            Anchor = Anchor.BottomLeft,
+                            Origin = Anchor.BottomLeft,
+                            BypassAutoSizeAxes = Axes.Both,
+                        },
                         displayedCountSpriteText = new LegacySpriteText(LegacyFont.Combo)
                         {
                             // Initial text and AlwaysPresent allow the counter to have a size before it first displays a combo.

From 8d927920cb89dae62a6dbee7b4ecf8442be610b7 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 27 Dec 2021 13:31:07 +0900
Subject: [PATCH 1854/5547] Add comment explainng why to block idle updates
 when host is not active

---
 osu.Game/Input/IdleTracker.cs | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/osu.Game/Input/IdleTracker.cs b/osu.Game/Input/IdleTracker.cs
index 4ef676b3b6..e2f13309cf 100644
--- a/osu.Game/Input/IdleTracker.cs
+++ b/osu.Game/Input/IdleTracker.cs
@@ -70,6 +70,9 @@ namespace osu.Game.Input
 
         protected override bool Handle(UIEvent e)
         {
+            // Even when not active, `MouseMoveEvent`s will arrive.
+            // We don't want these to trigger a non-idle state as it's quite often the user interacting
+            // with other windows while osu! is in the background.
             if (!host.IsActive.Value)
                 return base.Handle(e);
 

From 327822de5bb5e15098c53fce05ae0eddad495e58 Mon Sep 17 00:00:00 2001
From: pikokr <parangee9706@gmail.com>
Date: Mon, 27 Dec 2021 19:41:36 +0900
Subject: [PATCH 1855/5547] Add touchscreen support for osu!mania ruleset

---
 osu.Game.Rulesets.Mania/UI/Column.cs | 27 +++++++++++++++++++++++++++
 1 file changed, 27 insertions(+)

diff --git a/osu.Game.Rulesets.Mania/UI/Column.cs b/osu.Game.Rulesets.Mania/UI/Column.cs
index 9d060944cd..df39b5397b 100644
--- a/osu.Game.Rulesets.Mania/UI/Column.cs
+++ b/osu.Game.Rulesets.Mania/UI/Column.cs
@@ -136,6 +136,33 @@ namespace osu.Game.Rulesets.Mania.UI
         {
         }
 
+        // https://github.com/ppy/osu-framework/blob/49c954321c3686628b2c223670363438f88a0341/osu.Framework/Graphics/Drawable.cs#L1513-L1524
+        private T findClosestParent<T>() where T : class, IDrawable
+        {
+            Drawable cursor = this;
+
+            while ((cursor = cursor.Parent) != null)
+            {
+                if (cursor is T match)
+                    return match;
+            }
+
+            return default;
+        }
+
+        private ManiaInputManager.RulesetKeyBindingContainer keyBindingManager => findClosestParent<ManiaInputManager.RulesetKeyBindingContainer>();
+
+        protected override bool OnTouchDown(TouchDownEvent e)
+        {
+            keyBindingManager.TriggerPressed(Action.Value);
+            return base.OnTouchDown(e);
+        }
+
+        protected override void OnTouchUp(TouchUpEvent e)
+        {
+            keyBindingManager.TriggerReleased(Action.Value);
+        }
+
         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));

From ef763e9bd7f28ab95b3f5b742c08e84cd223eed9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 27 Dec 2021 10:59:05 +0100
Subject: [PATCH 1856/5547] Add failing test for storyboard not tracking
 current track

---
 .../TestSceneBackgroundScreenDefault.cs       | 92 +++++++++++++++++++
 1 file changed, 92 insertions(+)

diff --git a/osu.Game.Tests/Visual/Background/TestSceneBackgroundScreenDefault.cs b/osu.Game.Tests/Visual/Background/TestSceneBackgroundScreenDefault.cs
index 844fe7705a..884e74346b 100644
--- a/osu.Game.Tests/Visual/Background/TestSceneBackgroundScreenDefault.cs
+++ b/osu.Game.Tests/Visual/Background/TestSceneBackgroundScreenDefault.cs
@@ -6,18 +6,24 @@ using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
+using osu.Framework.Audio.Track;
+using osu.Framework.Graphics;
 using osu.Framework.Graphics.Textures;
 using osu.Framework.Screens;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
 using osu.Game.Configuration;
 using osu.Game.Database;
+using osu.Game.Graphics;
 using osu.Game.Graphics.Backgrounds;
+using osu.Game.Graphics.Sprites;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Screens;
 using osu.Game.Screens.Backgrounds;
 using osu.Game.Skinning;
+using osu.Game.Storyboards;
+using osu.Game.Storyboards.Drawables;
 using osu.Game.Tests.Beatmaps;
 
 namespace osu.Game.Tests.Visual.Background
@@ -129,6 +135,46 @@ namespace osu.Game.Tests.Visual.Background
             AddAssert("top level background reused existing", () => screen.CheckLastLoadChange() == false);
         }
 
+        [Test]
+        public void TestBeatmapBackgroundWithStoryboardClockAlwaysUsesCurrentTrack()
+        {
+            BackgroundScreenBeatmap nestedScreen = null;
+            WorkingBeatmap originalWorking = null;
+
+            setSupporter(true);
+            setSourceMode(BackgroundSource.BeatmapWithStoryboard);
+
+            AddStep("change beatmap", () => originalWorking = Beatmap.Value = createTestWorkingBeatmapWithStoryboard());
+            AddAssert("background changed", () => screen.CheckLastLoadChange() == true);
+            AddUntilStep("wait for beatmap background to be loaded", () => getCurrentBackground()?.GetType() == typeof(BeatmapBackgroundWithStoryboard));
+
+            AddStep("start music", () => MusicController.Play());
+            AddUntilStep("storyboard clock running", () => screen.ChildrenOfType<DrawableStoryboard>().SingleOrDefault()?.Clock.IsRunning == true);
+
+            // of note, this needs to be a type that doesn't match BackgroundScreenDefault else it is silently not pushed by the background stack.
+            AddStep("push new background to stack", () => stack.Push(nestedScreen = new BackgroundScreenBeatmap(Beatmap.Value)));
+            AddUntilStep("wait for screen to load", () => nestedScreen.IsLoaded && nestedScreen.IsCurrentScreen());
+
+            // we're testing a case where scheduling may be used to avoid issues, so ensure the scheduler is no longer running.
+            AddUntilStep("wait for top level not alive", () => !screen.IsAlive);
+
+            AddStep("stop music", () => MusicController.Stop());
+            AddStep("change beatmap", () => Beatmap.Value = createTestWorkingBeatmapWithStoryboard());
+            AddStep("change beatmap back", () => Beatmap.Value = originalWorking);
+            AddStep("restart music", () => MusicController.Play());
+
+            AddAssert("top level background hasn't changed yet", () => screen.CheckLastLoadChange() == null);
+
+            AddStep("pop screen back to top level", () => screen.MakeCurrent());
+
+            AddStep("top level screen is current", () => screen.IsCurrentScreen());
+            AddAssert("top level background reused existing", () => screen.CheckLastLoadChange() == false);
+            AddUntilStep("storyboard clock running", () => screen.ChildrenOfType<DrawableStoryboard>().Single().Clock.IsRunning);
+
+            AddStep("stop music", () => MusicController.Stop());
+            AddStep("restore default beatmap", () => Beatmap.SetDefault());
+        }
+
         [Test]
         public void TestBackgroundTypeSwitch()
         {
@@ -198,6 +244,7 @@ namespace osu.Game.Tests.Visual.Background
             });
 
         private WorkingBeatmap createTestWorkingBeatmapWithUniqueBackground() => new UniqueBackgroundTestWorkingBeatmap(Audio);
+        private WorkingBeatmap createTestWorkingBeatmapWithStoryboard() => new TestWorkingBeatmapWithStoryboard(Audio);
 
         private class TestBackgroundScreenDefault : BackgroundScreenDefault
         {
@@ -233,6 +280,51 @@ namespace osu.Game.Tests.Visual.Background
             protected override Texture GetBackground() => new Texture(1, 1);
         }
 
+        private class TestWorkingBeatmapWithStoryboard : TestWorkingBeatmap
+        {
+            public TestWorkingBeatmapWithStoryboard(AudioManager audioManager)
+                : base(new Beatmap(), createStoryboard(), audioManager)
+            {
+            }
+
+            protected override Track GetBeatmapTrack() => new TrackVirtual(100000);
+
+            private static Storyboard createStoryboard()
+            {
+                var storyboard = new Storyboard();
+                storyboard.Layers.Last().Add(new TestStoryboardElement());
+                return storyboard;
+            }
+
+            private class TestStoryboardElement : IStoryboardElementWithDuration
+            {
+                public string Path => string.Empty;
+                public bool IsDrawable => true;
+                public double StartTime => double.MinValue;
+                public double EndTime => double.MaxValue;
+
+                public Drawable CreateDrawable() => new DrawableTestStoryboardElement();
+            }
+
+            private class DrawableTestStoryboardElement : OsuSpriteText
+            {
+                public override bool RemoveWhenNotAlive => false;
+
+                public DrawableTestStoryboardElement()
+                {
+                    Anchor = Origin = Anchor.Centre;
+                    Font = OsuFont.Default.With(size: 32);
+                    Text = "(not started)";
+                }
+
+                protected override void Update()
+                {
+                    base.Update();
+                    Text = Time.Current.ToString("N2");
+                }
+            }
+        }
+
         private void setCustomSkin()
         {
             // feign a skin switch. this doesn't do anything except force CurrentSkin to become a LegacySkin.

From 9f8ad9f833f5057150297c455fee597dc6bc7db1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 27 Dec 2021 11:28:20 +0100
Subject: [PATCH 1857/5547] Fix menu background storyboard stopping after track
 reload

---
 .../BeatmapBackgroundWithStoryboard.cs        | 35 ++++++++++++++++++-
 1 file changed, 34 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Graphics/Backgrounds/BeatmapBackgroundWithStoryboard.cs b/osu.Game/Graphics/Backgrounds/BeatmapBackgroundWithStoryboard.cs
index 6a42e83305..71b1ef2c18 100644
--- a/osu.Game/Graphics/Backgrounds/BeatmapBackgroundWithStoryboard.cs
+++ b/osu.Game/Graphics/Backgrounds/BeatmapBackgroundWithStoryboard.cs
@@ -1,17 +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.
 
+#nullable enable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Timing;
 using osu.Game.Beatmaps;
+using osu.Game.Overlays;
 using osu.Game.Storyboards.Drawables;
 
 namespace osu.Game.Graphics.Backgrounds
 {
     public class BeatmapBackgroundWithStoryboard : BeatmapBackground
     {
+        private InterpolatingFramedClock storyboardClock = null!;
+
+        [Resolved(CanBeNull = true)]
+        private MusicController? musicController { get; set; }
+
         public BeatmapBackgroundWithStoryboard(WorkingBeatmap beatmap, string fallbackTextureName = "Backgrounds/bg1")
             : base(beatmap, fallbackTextureName)
         {
@@ -30,8 +38,33 @@ namespace osu.Game.Graphics.Backgrounds
             {
                 RelativeSizeAxes = Axes.Both,
                 Volume = { Value = 0 },
-                Child = new DrawableStoryboard(Beatmap.Storyboard) { Clock = new InterpolatingFramedClock(Beatmap.Track) }
+                Child = new DrawableStoryboard(Beatmap.Storyboard) { Clock = storyboardClock = new InterpolatingFramedClock(Beatmap.Track) }
             }, AddInternal);
         }
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+            if (musicController != null)
+                musicController.TrackChanged += onTrackChanged;
+        }
+
+        private void onTrackChanged(WorkingBeatmap newBeatmap, TrackChangeDirection _)
+        {
+            if (newBeatmap != Beatmap)
+                return;
+
+            // `MusicController` will sometimes reload the track, even when the working beatmap technically hasn't changed.
+            // ensure that the storyboard's clock is always using the latest track instance.
+            storyboardClock.ChangeSource(newBeatmap.Track);
+            storyboardClock.ProcessFrame();
+        }
+
+        protected override void Dispose(bool isDisposing)
+        {
+            base.Dispose(isDisposing);
+            if (musicController != null)
+                musicController.TrackChanged -= onTrackChanged;
+        }
     }
 }

From 58994b790c8e8a3c85fa5d82edc2835b648b8843 Mon Sep 17 00:00:00 2001
From: pikokr <parangee9706@gmail.com>
Date: Mon, 27 Dec 2021 21:20:52 +0900
Subject: [PATCH 1858/5547] Get key binding container once instead of getting
 on every touch

---
 osu.Game.Rulesets.Mania/ManiaInputManager.cs |  5 +++++
 osu.Game.Rulesets.Mania/UI/Column.cs         | 21 ++++++--------------
 osu.Game/Rulesets/UI/DrawableRuleset.cs      |  1 +
 3 files changed, 12 insertions(+), 15 deletions(-)

diff --git a/osu.Game.Rulesets.Mania/ManiaInputManager.cs b/osu.Game.Rulesets.Mania/ManiaInputManager.cs
index 186fc4b15d..bf94735077 100644
--- a/osu.Game.Rulesets.Mania/ManiaInputManager.cs
+++ b/osu.Game.Rulesets.Mania/ManiaInputManager.cs
@@ -13,6 +13,11 @@ namespace osu.Game.Rulesets.Mania
             : base(ruleset, variant, SimultaneousBindingMode.Unique)
         {
         }
+
+        public RulesetKeyBindingContainer GetKeyBindingContainer()
+        {
+            return (RulesetKeyBindingContainer)KeyBindingContainer;
+        }
     }
 
     public enum ManiaAction
diff --git a/osu.Game.Rulesets.Mania/UI/Column.cs b/osu.Game.Rulesets.Mania/UI/Column.cs
index df39b5397b..6be36619c7 100644
--- a/osu.Game.Rulesets.Mania/UI/Column.cs
+++ b/osu.Game.Rulesets.Mania/UI/Column.cs
@@ -136,31 +136,22 @@ namespace osu.Game.Rulesets.Mania.UI
         {
         }
 
-        // https://github.com/ppy/osu-framework/blob/49c954321c3686628b2c223670363438f88a0341/osu.Framework/Graphics/Drawable.cs#L1513-L1524
-        private T findClosestParent<T>() where T : class, IDrawable
+        private ManiaInputManager.RulesetKeyBindingContainer keyBindingContainer { get; set; }
+
+        private ManiaInputManager.RulesetKeyBindingContainer getKeyBindingManager()
         {
-            Drawable cursor = this;
-
-            while ((cursor = cursor.Parent) != null)
-            {
-                if (cursor is T match)
-                    return match;
-            }
-
-            return default;
+            return keyBindingContainer ??= ((ManiaInputManager)GetContainingInputManager()).GetKeyBindingContainer();
         }
 
-        private ManiaInputManager.RulesetKeyBindingContainer keyBindingManager => findClosestParent<ManiaInputManager.RulesetKeyBindingContainer>();
-
         protected override bool OnTouchDown(TouchDownEvent e)
         {
-            keyBindingManager.TriggerPressed(Action.Value);
+            getKeyBindingManager().TriggerPressed(Action.Value);
             return base.OnTouchDown(e);
         }
 
         protected override void OnTouchUp(TouchUpEvent e)
         {
-            keyBindingManager.TriggerReleased(Action.Value);
+            getKeyBindingManager().TriggerReleased(Action.Value);
         }
 
         public override bool ReceivePositionalInputAt(Vector2 screenSpacePos)
diff --git a/osu.Game/Rulesets/UI/DrawableRuleset.cs b/osu.Game/Rulesets/UI/DrawableRuleset.cs
index 29559f5036..30012784a3 100644
--- a/osu.Game/Rulesets/UI/DrawableRuleset.cs
+++ b/osu.Game/Rulesets/UI/DrawableRuleset.cs
@@ -50,6 +50,7 @@ namespace osu.Game.Rulesets.UI
         /// <summary>
         /// The key conversion input manager for this DrawableRuleset.
         /// </summary>
+        [Cached]
         public PassThroughInputManager KeyBindingInputManager;
 
         public override double GameplayStartTime => Objects.FirstOrDefault()?.StartTime - 2000 ?? 0;

From eb04cc9213fe3b8d6ce30a10b7f21cce743b1c44 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 27 Dec 2021 23:04:10 +0900
Subject: [PATCH 1859/5547] Update framework

---
 osu.Android.props        | 2 +-
 osu.Game/osu.Game.csproj | 2 +-
 osu.iOS.props            | 4 ++--
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Android.props b/osu.Android.props
index 31a3bc8c45..67a9cd41dd 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -52,7 +52,7 @@
   </ItemGroup>
   <ItemGroup>
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1215.0" />
-    <PackageReference Include="ppy.osu.Framework.Android" Version="2021.1225.0" />
+    <PackageReference Include="ppy.osu.Framework.Android" Version="2021.1227.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
     <!-- Realm needs to be directly referenced in all Xamarin projects, as it will not pull in its transitive dependencies otherwise. -->
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 2c97bae360..c7913cb71d 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="10.7.1" />
-    <PackageReference Include="ppy.osu.Framework" Version="2021.1225.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2021.1227.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1215.0" />
     <PackageReference Include="Sentry" Version="3.12.1" />
     <PackageReference Include="SharpCompress" Version="0.30.1" />
diff --git a/osu.iOS.props b/osu.iOS.props
index de084c0297..cccf974d42 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -60,7 +60,7 @@
     <Reference Include="System.Net.Http" />
   </ItemGroup>
   <ItemGroup Label="Package References">
-    <PackageReference Include="ppy.osu.Framework.iOS" Version="2021.1225.0" />
+    <PackageReference Include="ppy.osu.Framework.iOS" Version="2021.1227.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1215.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net5.0 / net6.0) -->
@@ -83,7 +83,7 @@
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="2.2.6" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.Core" Version="2.2.6" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
-    <PackageReference Include="ppy.osu.Framework" Version="2021.1225.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2021.1227.0" />
     <PackageReference Include="SharpCompress" Version="0.30.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
     <PackageReference Include="SharpRaven" Version="2.4.0" />

From 568cab68086792a3ed9cf863f63f25331ea13ae4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 27 Dec 2021 21:13:04 +0100
Subject: [PATCH 1860/5547] Add clarification comment about explicit
 `ProcessFrame()` call

---
 .../Graphics/Backgrounds/BeatmapBackgroundWithStoryboard.cs    | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/osu.Game/Graphics/Backgrounds/BeatmapBackgroundWithStoryboard.cs b/osu.Game/Graphics/Backgrounds/BeatmapBackgroundWithStoryboard.cs
index 71b1ef2c18..c5c8a25f4a 100644
--- a/osu.Game/Graphics/Backgrounds/BeatmapBackgroundWithStoryboard.cs
+++ b/osu.Game/Graphics/Backgrounds/BeatmapBackgroundWithStoryboard.cs
@@ -57,6 +57,9 @@ namespace osu.Game.Graphics.Backgrounds
             // `MusicController` will sometimes reload the track, even when the working beatmap technically hasn't changed.
             // ensure that the storyboard's clock is always using the latest track instance.
             storyboardClock.ChangeSource(newBeatmap.Track);
+            // more often than not, the previous source track's time will be in the future relative to the new source track.
+            // explicitly process a single frame so that `InterpolatingFramedClock`'s interpolation logic is bypassed
+            // and the storyboard clock is correctly rewound to the source track's time exactly.
             storyboardClock.ProcessFrame();
         }
 

From eed0ecf8c5bfbb2be0df576f7c0f606d2eb36bfc Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Thu, 9 Dec 2021 20:52:12 -0800
Subject: [PATCH 1861/5547] Add special prefixed/suffixed words to dictionary

---
 osu.sln.DotSettings | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/osu.sln.DotSettings b/osu.sln.DotSettings
index a96f64cdc3..4487ae2cde 100644
--- a/osu.sln.DotSettings
+++ b/osu.sln.DotSettings
@@ -926,20 +926,44 @@ private void load()
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=bindable/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=bindables/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Catmull/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Dimmable/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Disableable/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Drawables/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Failable/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=gameplay/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=hitobject/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=hitobjects/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Judgeable/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=keymods/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Kiai/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Leaderboard/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Leaderboards/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Migratable/@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/=Playfield/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=playfields/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Poolable/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Preclicked/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=purgeable/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Rearrangeable/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=refetch/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=refetched/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Refilter/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Reinstantiation/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=resampler/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=ruleset/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=rulesets/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=ruleset_0027s/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Scorable/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Snappable/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Spinnable/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Strongable/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Taiko/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=undim/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=undownloadable/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Unhover/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Unhovered/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Unplayed/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Unproxy/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Unranked/@EntryIndexedValue">True</s:Boolean></wpf:ResourceDictionary>

From 55768d8c1136d8ae6469656e6e46e85aa75c06e6 Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Thu, 9 Dec 2021 20:58:45 -0800
Subject: [PATCH 1862/5547] Add some osu! words to dictionary

---
 osu.sln.DotSettings | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/osu.sln.DotSettings b/osu.sln.DotSettings
index 4487ae2cde..90bf4f09eb 100644
--- a/osu.sln.DotSettings
+++ b/osu.sln.DotSettings
@@ -920,27 +920,40 @@ private void load()
 {
 	$END$
 };</s:String>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=antiflow/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Beatmap/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=beatmaps/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Beatmapset/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=beatmap_0027s/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=bindable/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=bindables/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Catmull/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Daycore/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Dimmable/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Disableable/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Drawables/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Failable/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Gamefield/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=gameplay/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Geki/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Hitnormal/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=hitobject/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=hitobjects/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Hitsound/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Hitsounded/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Hitsounds/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Judgeable/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Katu/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=keymods/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Kiai/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Kudosu/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Leaderboard/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Leaderboards/@EntryIndexedValue">True</s:Boolean>
 	<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/=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>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Playfield/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=playfields/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Poolable/@EntryIndexedValue">True</s:Boolean>
@@ -956,7 +969,9 @@ private void load()
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=rulesets/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=ruleset_0027s/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Scorable/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=seeya/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Snappable/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Soleily/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Spinnable/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Strongable/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Taiko/@EntryIndexedValue">True</s:Boolean>

From 98524d60a4a299ed10babd237515ca897c0b39fe Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Thu, 9 Dec 2021 21:04:31 -0800
Subject: [PATCH 1863/5547] Fix clear identifier typos

---
 osu.Desktop/Security/ElevatedPrivilegesChecker.cs    |  2 +-
 .../Skinning/Default/DefaultHitExplosion.cs          |  6 +++---
 osu.Game.Rulesets.Mania/UI/DefaultHitExplosion.cs    |  6 +++---
 osu.Game.Tests/Mods/ModSettingsEqualityComparison.cs | 12 ++++++------
 .../TestMultiplayerMessagePackSerialization.cs       |  2 +-
 .../Visual/Online/TestSceneBeatmapAvailability.cs    | 10 +++++-----
 .../TestScenePlaylistsMatchSettingsOverlay.cs        |  8 ++++----
 osu.Game/Online/API/APIException.cs                  |  4 ++--
 osu.Game/Online/Chat/ChannelManager.cs               |  4 ++--
 osu.Game/Online/Chat/MessageNotifier.cs              |  2 +-
 osu.Game/Overlays/Comments/DrawableComment.cs        | 12 ++++++------
 .../Notifications/ProgressCompletionNotification.cs  |  2 +-
 .../Overlays/Notifications/SimpleNotification.cs     |  4 ++--
 .../Edit/Compose/Components/SelectionBoxButton.cs    |  2 +-
 .../Edit/Compose/Components/SelectionBoxControl.cs   |  2 +-
 .../Compose/Components/SelectionBoxDragHandle.cs     |  2 +-
 osu.Game/Screens/Menu/LogoVisualisation.cs           |  4 ++--
 osu.Game/Screens/Play/PlayerLoader.cs                |  4 ++--
 osu.Game/Updater/UpdateManager.cs                    |  2 +-
 19 files changed, 45 insertions(+), 45 deletions(-)

diff --git a/osu.Desktop/Security/ElevatedPrivilegesChecker.cs b/osu.Desktop/Security/ElevatedPrivilegesChecker.cs
index 01458b4c37..62ea3e0399 100644
--- a/osu.Desktop/Security/ElevatedPrivilegesChecker.cs
+++ b/osu.Desktop/Security/ElevatedPrivilegesChecker.cs
@@ -76,7 +76,7 @@ namespace osu.Desktop.Security
             private void load(OsuColour colours, NotificationOverlay notificationOverlay)
             {
                 Icon = FontAwesome.Solid.ShieldAlt;
-                IconBackgound.Colour = colours.YellowDark;
+                IconBackground.Colour = colours.YellowDark;
             }
         }
     }
diff --git a/osu.Game.Rulesets.Catch/Skinning/Default/DefaultHitExplosion.cs b/osu.Game.Rulesets.Catch/Skinning/Default/DefaultHitExplosion.cs
index e1fad564a3..905eb059e3 100644
--- a/osu.Game.Rulesets.Catch/Skinning/Default/DefaultHitExplosion.cs
+++ b/osu.Game.Rulesets.Catch/Skinning/Default/DefaultHitExplosion.cs
@@ -90,9 +90,9 @@ namespace osu.Game.Rulesets.Catch.Skinning.Default
                 .ResizeTo(largeFaint.Size * new Vector2(5, 1), duration, Easing.OutQuint)
                 .FadeOut(duration * 2);
 
-            const float angle_variangle = 15; // should be less than 45
-            directionalGlow1.Rotation = StatelessRNG.NextSingle(-angle_variangle, angle_variangle, randomSeed, 4);
-            directionalGlow2.Rotation = StatelessRNG.NextSingle(-angle_variangle, angle_variangle, randomSeed, 5);
+            const float angle_variable = 15; // should be less than 45
+            directionalGlow1.Rotation = StatelessRNG.NextSingle(-angle_variable, angle_variable, randomSeed, 4);
+            directionalGlow2.Rotation = StatelessRNG.NextSingle(-angle_variable, angle_variable, randomSeed, 5);
 
             this.FadeInFromZero(50).Then().FadeOut(duration, Easing.Out);
         }
diff --git a/osu.Game.Rulesets.Mania/UI/DefaultHitExplosion.cs b/osu.Game.Rulesets.Mania/UI/DefaultHitExplosion.cs
index 69b81d6d5c..99dcce2da4 100644
--- a/osu.Game.Rulesets.Mania/UI/DefaultHitExplosion.cs
+++ b/osu.Game.Rulesets.Mania/UI/DefaultHitExplosion.cs
@@ -42,7 +42,7 @@ namespace osu.Game.Rulesets.Mania.UI
         [BackgroundDependencyLoader]
         private void load(IScrollingInfo scrollingInfo)
         {
-            const float angle_variangle = 15; // should be less than 45
+            const float angle_variable = 15; // should be less than 45
             const float roundness = 80;
             const float initial_height = 10;
 
@@ -90,7 +90,7 @@ namespace osu.Game.Rulesets.Mania.UI
                     Masking = true,
                     Size = new Vector2(0.01f, initial_height),
                     Blending = BlendingParameters.Additive,
-                    Rotation = RNG.NextSingle(-angle_variangle, angle_variangle),
+                    Rotation = RNG.NextSingle(-angle_variable, angle_variable),
                     EdgeEffect = new EdgeEffectParameters
                     {
                         Type = EdgeEffectType.Glow,
@@ -107,7 +107,7 @@ namespace osu.Game.Rulesets.Mania.UI
                     Masking = true,
                     Size = new Vector2(0.01f, initial_height),
                     Blending = BlendingParameters.Additive,
-                    Rotation = RNG.NextSingle(-angle_variangle, angle_variangle),
+                    Rotation = RNG.NextSingle(-angle_variable, angle_variable),
                     EdgeEffect = new EdgeEffectParameters
                     {
                         Type = EdgeEffectType.Glow,
diff --git a/osu.Game.Tests/Mods/ModSettingsEqualityComparison.cs b/osu.Game.Tests/Mods/ModSettingsEqualityComparison.cs
index ce6b3a68a5..cd6879cf01 100644
--- a/osu.Game.Tests/Mods/ModSettingsEqualityComparison.cs
+++ b/osu.Game.Tests/Mods/ModSettingsEqualityComparison.cs
@@ -34,20 +34,20 @@ namespace osu.Game.Tests.Mods
             var mod3 = new OsuModDoubleTime { SpeedChange = { Value = 1.26 } };
 
             var doubleConvertedMod1 = new APIMod(mod1).ToMod(ruleset);
-            var doulbeConvertedMod2 = new APIMod(mod2).ToMod(ruleset);
-            var doulbeConvertedMod3 = new APIMod(mod3).ToMod(ruleset);
+            var doubleConvertedMod2 = new APIMod(mod2).ToMod(ruleset);
+            var doubleConvertedMod3 = new APIMod(mod3).ToMod(ruleset);
 
             Assert.That(mod1, Is.Not.EqualTo(mod2));
-            Assert.That(doubleConvertedMod1, Is.Not.EqualTo(doulbeConvertedMod2));
+            Assert.That(doubleConvertedMod1, Is.Not.EqualTo(doubleConvertedMod2));
 
             Assert.That(mod2, Is.EqualTo(mod2));
-            Assert.That(doulbeConvertedMod2, Is.EqualTo(doulbeConvertedMod2));
+            Assert.That(doubleConvertedMod2, Is.EqualTo(doubleConvertedMod2));
 
             Assert.That(mod2, Is.EqualTo(mod3));
-            Assert.That(doulbeConvertedMod2, Is.EqualTo(doulbeConvertedMod3));
+            Assert.That(doubleConvertedMod2, Is.EqualTo(doubleConvertedMod3));
 
             Assert.That(mod3, Is.EqualTo(mod2));
-            Assert.That(doulbeConvertedMod3, Is.EqualTo(doulbeConvertedMod2));
+            Assert.That(doubleConvertedMod3, Is.EqualTo(doubleConvertedMod2));
         }
     }
 }
diff --git a/osu.Game.Tests/Online/TestMultiplayerMessagePackSerialization.cs b/osu.Game.Tests/Online/TestMultiplayerMessagePackSerialization.cs
index 1027b722d1..81475f2fbe 100644
--- a/osu.Game.Tests/Online/TestMultiplayerMessagePackSerialization.cs
+++ b/osu.Game.Tests/Online/TestMultiplayerMessagePackSerialization.cs
@@ -39,7 +39,7 @@ namespace osu.Game.Tests.Online
         }
 
         [Test]
-        public void TestSerialiseUnionFailsWithSingalR()
+        public void TestSerialiseUnionFailsWithSignalR()
         {
             var state = new TeamVersusUserState();
 
diff --git a/osu.Game.Tests/Visual/Online/TestSceneBeatmapAvailability.cs b/osu.Game.Tests/Visual/Online/TestSceneBeatmapAvailability.cs
index 176e0592ef..f94ae24a14 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneBeatmapAvailability.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneBeatmapAvailability.cs
@@ -30,7 +30,7 @@ namespace osu.Game.Tests.Visual.Online
                 },
             });
 
-            visiblityAssert(true);
+            visibilityAssert(true);
         }
 
         [Test]
@@ -44,7 +44,7 @@ namespace osu.Game.Tests.Visual.Online
                 },
             });
 
-            visiblityAssert(true);
+            visibilityAssert(true);
         }
 
         [Test]
@@ -59,7 +59,7 @@ namespace osu.Game.Tests.Visual.Online
                 },
             });
 
-            visiblityAssert(true);
+            visibilityAssert(true);
         }
 
         [Test]
@@ -73,10 +73,10 @@ namespace osu.Game.Tests.Visual.Online
                 },
             });
 
-            visiblityAssert(false);
+            visibilityAssert(false);
         }
 
-        private void visiblityAssert(bool shown)
+        private void visibilityAssert(bool shown)
         {
             AddAssert($"is container {(shown ? "visible" : "hidden")}", () => container.Alpha == (shown ? 1 : 0));
         }
diff --git a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsMatchSettingsOverlay.cs b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsMatchSettingsOverlay.cs
index 278379c692..ca3387392a 100644
--- a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsMatchSettingsOverlay.cs
+++ b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsMatchSettingsOverlay.cs
@@ -87,7 +87,7 @@ namespace osu.Game.Tests.Visual.Playlists
         {
             const string not_found_prefix = "beatmaps not found:";
 
-            string errorMesage = null;
+            string errorMessage = null;
 
             AddStep("setup", () =>
             {
@@ -96,9 +96,9 @@ namespace osu.Game.Tests.Visual.Playlists
                 SelectedRoom.Value.Name.Value = "Test Room";
                 SelectedRoom.Value.Playlist.Add(new PlaylistItem { Beatmap = { Value = beatmap } });
 
-                errorMesage = $"{not_found_prefix} {beatmap.OnlineID}";
+                errorMessage = $"{not_found_prefix} {beatmap.OnlineID}";
 
-                RoomManager.CreateRequested = _ => errorMesage;
+                RoomManager.CreateRequested = _ => errorMessage;
             });
 
             AddAssert("error not displayed", () => !settings.ErrorText.IsPresent);
@@ -107,7 +107,7 @@ namespace osu.Game.Tests.Visual.Playlists
             AddStep("create room", () => settings.ApplyButton.Action.Invoke());
 
             AddAssert("error displayed", () => settings.ErrorText.IsPresent);
-            AddAssert("error has custom text", () => settings.ErrorText.Text != errorMesage);
+            AddAssert("error has custom text", () => settings.ErrorText.Text != errorMessage);
             AddAssert("playlist item marked invalid", () => !SelectedRoom.Value.Playlist[0].Valid.Value);
         }
 
diff --git a/osu.Game/Online/API/APIException.cs b/osu.Game/Online/API/APIException.cs
index 97786bced9..54d68d8f0d 100644
--- a/osu.Game/Online/API/APIException.cs
+++ b/osu.Game/Online/API/APIException.cs
@@ -7,8 +7,8 @@ namespace osu.Game.Online.API
 {
     public class APIException : InvalidOperationException
     {
-        public APIException(string messsage, Exception innerException)
-            : base(messsage, innerException)
+        public APIException(string message, Exception innerException)
+            : base(message, innerException)
         {
         }
     }
diff --git a/osu.Game/Online/Chat/ChannelManager.cs b/osu.Game/Online/Chat/ChannelManager.cs
index edaf135e93..cc41511764 100644
--- a/osu.Game/Online/Chat/ChannelManager.cs
+++ b/osu.Game/Online/Chat/ChannelManager.cs
@@ -335,7 +335,7 @@ namespace osu.Game.Online.Chat
         /// right now it caps out at 50 messages and therefore only returns one channel's worth of content.
         /// </summary>
         /// <param name="channel">The channel </param>
-        private void fetchInitalMessages(Channel channel)
+        private void fetchInitialMessages(Channel channel)
         {
             if (channel.Id <= 0 || channel.MessagesLoaded) return;
 
@@ -441,7 +441,7 @@ namespace osu.Game.Online.Chat
             else
             {
                 if (fetchInitialMessages)
-                    fetchInitalMessages(channel);
+                    this.fetchInitialMessages(channel);
             }
 
             CurrentChannel.Value ??= channel;
diff --git a/osu.Game/Online/Chat/MessageNotifier.cs b/osu.Game/Online/Chat/MessageNotifier.cs
index a11af7b305..2c99e9f9b9 100644
--- a/osu.Game/Online/Chat/MessageNotifier.cs
+++ b/osu.Game/Online/Chat/MessageNotifier.cs
@@ -170,7 +170,7 @@ namespace osu.Game.Online.Chat
             [BackgroundDependencyLoader]
             private void load(OsuColour colours, ChatOverlay chatOverlay, NotificationOverlay notificationOverlay, ChannelManager channelManager)
             {
-                IconBackgound.Colour = colours.PurpleDark;
+                IconBackground.Colour = colours.PurpleDark;
 
                 Activated = delegate
                 {
diff --git a/osu.Game/Overlays/Comments/DrawableComment.cs b/osu.Game/Overlays/Comments/DrawableComment.cs
index 43f4177bd0..3286b6c5c0 100644
--- a/osu.Game/Overlays/Comments/DrawableComment.cs
+++ b/osu.Game/Overlays/Comments/DrawableComment.cs
@@ -362,15 +362,15 @@ namespace osu.Game.Overlays.Comments
 
         private void updateButtonsState()
         {
-            int loadedReplesCount = loadedReplies.Count;
-            bool hasUnloadedReplies = loadedReplesCount != Comment.RepliesCount;
+            int loadedRepliesCount = loadedReplies.Count;
+            bool hasUnloadedReplies = loadedRepliesCount != Comment.RepliesCount;
 
-            loadRepliesButton.FadeTo(hasUnloadedReplies && loadedReplesCount == 0 ? 1 : 0);
-            showMoreButton.FadeTo(hasUnloadedReplies && loadedReplesCount > 0 ? 1 : 0);
-            showRepliesButton.FadeTo(loadedReplesCount != 0 ? 1 : 0);
+            loadRepliesButton.FadeTo(hasUnloadedReplies && loadedRepliesCount == 0 ? 1 : 0);
+            showMoreButton.FadeTo(hasUnloadedReplies && loadedRepliesCount > 0 ? 1 : 0);
+            showRepliesButton.FadeTo(loadedRepliesCount != 0 ? 1 : 0);
 
             if (Comment.IsTopLevel)
-                chevronButton.FadeTo(loadedReplesCount != 0 ? 1 : 0);
+                chevronButton.FadeTo(loadedRepliesCount != 0 ? 1 : 0);
 
             showMoreButton.IsLoading = loadRepliesButton.IsLoading = false;
         }
diff --git a/osu.Game/Overlays/Notifications/ProgressCompletionNotification.cs b/osu.Game/Overlays/Notifications/ProgressCompletionNotification.cs
index feffb4fa66..754f9bd600 100644
--- a/osu.Game/Overlays/Notifications/ProgressCompletionNotification.cs
+++ b/osu.Game/Overlays/Notifications/ProgressCompletionNotification.cs
@@ -18,7 +18,7 @@ namespace osu.Game.Overlays.Notifications
         [BackgroundDependencyLoader]
         private void load(OsuColour colours)
         {
-            IconBackgound.Colour = ColourInfo.GradientVertical(colours.GreenDark, colours.GreenLight);
+            IconBackground.Colour = ColourInfo.GradientVertical(colours.GreenDark, colours.GreenLight);
         }
     }
 }
diff --git a/osu.Game/Overlays/Notifications/SimpleNotification.cs b/osu.Game/Overlays/Notifications/SimpleNotification.cs
index 17ec12a4ca..c32e40ffc8 100644
--- a/osu.Game/Overlays/Notifications/SimpleNotification.cs
+++ b/osu.Game/Overlays/Notifications/SimpleNotification.cs
@@ -43,13 +43,13 @@ namespace osu.Game.Overlays.Notifications
         private readonly TextFlowContainer textDrawable;
         private readonly SpriteIcon iconDrawable;
 
-        protected Box IconBackgound;
+        protected Box IconBackground;
 
         public SimpleNotification()
         {
             IconContent.AddRange(new Drawable[]
             {
-                IconBackgound = new Box
+                IconBackground = new Box
                 {
                     RelativeSizeAxes = Axes.Both,
                     Colour = ColourInfo.GradientVertical(OsuColour.Gray(0.2f), OsuColour.Gray(0.6f))
diff --git a/osu.Game/Screens/Edit/Compose/Components/SelectionBoxButton.cs b/osu.Game/Screens/Edit/Compose/Components/SelectionBoxButton.cs
index 3ac40fda0f..346bb2b508 100644
--- a/osu.Game/Screens/Edit/Compose/Components/SelectionBoxButton.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/SelectionBoxButton.cs
@@ -49,7 +49,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
         {
             TriggerOperationStarted();
             Action?.Invoke();
-            TriggerOperatoinEnded();
+            TriggerOperationEnded();
             return true;
         }
 
diff --git a/osu.Game/Screens/Edit/Compose/Components/SelectionBoxControl.cs b/osu.Game/Screens/Edit/Compose/Components/SelectionBoxControl.cs
index 40d367bb80..8f22e67922 100644
--- a/osu.Game/Screens/Edit/Compose/Components/SelectionBoxControl.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/SelectionBoxControl.cs
@@ -92,6 +92,6 @@ namespace osu.Game.Screens.Edit.Compose.Components
 
         protected void TriggerOperationStarted() => OperationStarted?.Invoke();
 
-        protected void TriggerOperatoinEnded() => OperationEnded?.Invoke();
+        protected void TriggerOperationEnded() => OperationEnded?.Invoke();
     }
 }
diff --git a/osu.Game/Screens/Edit/Compose/Components/SelectionBoxDragHandle.cs b/osu.Game/Screens/Edit/Compose/Components/SelectionBoxDragHandle.cs
index 65a95951cf..cac907ca5e 100644
--- a/osu.Game/Screens/Edit/Compose/Components/SelectionBoxDragHandle.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/SelectionBoxDragHandle.cs
@@ -24,7 +24,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
 
         protected override void OnDragEnd(DragEndEvent e)
         {
-            TriggerOperatoinEnded();
+            TriggerOperationEnded();
 
             UpdateHoverState();
             base.OnDragEnd(e);
diff --git a/osu.Game/Screens/Menu/LogoVisualisation.cs b/osu.Game/Screens/Menu/LogoVisualisation.cs
index 01b2a98c6e..4acd73bfa0 100644
--- a/osu.Game/Screens/Menu/LogoVisualisation.cs
+++ b/osu.Game/Screens/Menu/LogoVisualisation.cs
@@ -53,7 +53,7 @@ namespace osu.Game.Screens.Menu
         /// <summary>
         /// How much should each bar go down each millisecond (based on a full bar).
         /// </summary>
-        private const float decay_per_milisecond = 0.0024f;
+        private const float decay_per_millisecond = 0.0024f;
 
         /// <summary>
         /// Number of milliseconds between each amplitude update.
@@ -136,7 +136,7 @@ namespace osu.Game.Screens.Menu
         {
             base.Update();
 
-            float decayFactor = (float)Time.Elapsed * decay_per_milisecond;
+            float decayFactor = (float)Time.Elapsed * decay_per_millisecond;
 
             for (int i = 0; i < bars_per_visualiser; i++)
             {
diff --git a/osu.Game/Screens/Play/PlayerLoader.cs b/osu.Game/Screens/Play/PlayerLoader.cs
index 60843acb4f..6009c85583 100644
--- a/osu.Game/Screens/Play/PlayerLoader.cs
+++ b/osu.Game/Screens/Play/PlayerLoader.cs
@@ -496,7 +496,7 @@ namespace osu.Game.Screens.Play
             private void load(OsuColour colours, AudioManager audioManager, NotificationOverlay notificationOverlay, VolumeOverlay volumeOverlay)
             {
                 Icon = FontAwesome.Solid.VolumeMute;
-                IconBackgound.Colour = colours.RedDark;
+                IconBackground.Colour = colours.RedDark;
 
                 Activated = delegate
                 {
@@ -548,7 +548,7 @@ namespace osu.Game.Screens.Play
             private void load(OsuColour colours, NotificationOverlay notificationOverlay)
             {
                 Icon = FontAwesome.Solid.BatteryQuarter;
-                IconBackgound.Colour = colours.RedDark;
+                IconBackground.Colour = colours.RedDark;
 
                 Activated = delegate
                 {
diff --git a/osu.Game/Updater/UpdateManager.cs b/osu.Game/Updater/UpdateManager.cs
index 28b828804c..9b9f354d23 100644
--- a/osu.Game/Updater/UpdateManager.cs
+++ b/osu.Game/Updater/UpdateManager.cs
@@ -97,7 +97,7 @@ namespace osu.Game.Updater
             private void load(OsuColour colours, ChangelogOverlay changelog, NotificationOverlay notificationOverlay)
             {
                 Icon = FontAwesome.Solid.CheckSquare;
-                IconBackgound.Colour = colours.BlueDark;
+                IconBackground.Colour = colours.BlueDark;
 
                 Activated = delegate
                 {

From 7de43e3aba011374d6777f23b1f891e671c375cf Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Thu, 9 Dec 2021 21:15:00 -0800
Subject: [PATCH 1864/5547] Fix most open compound words in identifiers being
 closed

---
 .../TestSceneDrawableHitObjects.cs            |  2 +-
 .../TestSceneFruitObjects.cs                  |  8 ++---
 .../Skinning/TestSceneHitExplosion.cs         |  8 ++---
 .../Beatmaps/ManiaBeatmap.cs                  |  4 +--
 .../Legacy/ManiaLegacySkinTransformer.cs      | 10 +++---
 osu.Game.Rulesets.Mania/UI/ManiaPlayfield.cs  |  2 +-
 osu.Game.Rulesets.Mania/UI/Stage.cs           |  2 +-
 .../Components/PathControlPointPiece.cs       |  2 +-
 osu.Game.Rulesets.Osu/Mods/OsuModSpunOut.cs   |  2 +-
 .../Skinning/TestSceneDrawableBarLine.cs      |  6 ++--
 .../Beatmaps/TaikoBeatmap.cs                  |  4 +--
 .../Editing/Checks/CheckMutedObjectsTest.cs   | 36 +++++++++----------
 .../Navigation/TestScenePresentBeatmap.cs     | 28 +++++++--------
 .../Navigation/TestScenePresentScore.cs       | 16 ++++-----
 .../Visual/Online/TestSceneKudosuHistory.cs   |  2 +-
 .../Online/TestScenePlayHistorySubsection.cs  | 16 ++++-----
 .../Online/TestSceneStandAloneChatDisplay.cs  |  4 +--
 .../TestSceneRestoreDefaultValueButton.cs     |  2 +-
 .../Settings/TestSceneSettingsSource.cs       |  2 +-
 .../UserInterface/TestSceneOnScreenDisplay.cs | 32 ++++++++---------
 .../UserInterface/TestSceneOsuTextBox.cs      |  2 +-
 .../UserInterface/ThemeComparisonTestScene.cs |  2 +-
 .../Components/ScrollingTeamContainer.cs      |  6 ++--
 .../Screens/Setup/StablePathSelectScreen.cs   |  2 +-
 .../Drawables/BeatmapSetOnlineStatusPill.cs   |  4 +--
 .../Collections/DrawableCollectionListItem.cs |  4 +--
 .../Collections/ManageCollectionsDialog.cs    |  6 ++--
 osu.Game/Graphics/DateTooltip.cs              |  2 +-
 osu.Game/Graphics/OsuColour.cs                | 12 +++----
 osu.Game/Graphics/OsuIcon.cs                  | 18 +++++-----
 .../OsuDirectorySelectorDirectory.cs          |  2 +-
 .../UserInterfaceV2/OsuHSVColourPicker.cs     |  2 +-
 .../UserInterfaceV2/OsuHexColourPicker.cs     |  2 +-
 .../Graphics/UserInterfaceV2/OsuPopover.cs    |  2 +-
 .../Online/API/Requests/Responses/APIUser.cs  |  6 ++--
 osu.Game/Online/Chat/StandAloneChatDisplay.cs | 28 +++++++--------
 osu.Game/Online/Rooms/PlaylistItem.cs         |  2 +-
 .../Overlays/AccountCreation/ScreenEntry.cs   | 14 ++++----
 osu.Game/Overlays/ChatOverlay.cs              | 32 ++++++++---------
 .../Header/Components/PreviousUsernames.cs    |  2 +-
 .../PaginatedMostPlayedBeatmapContainer.cs    |  2 +-
 .../Historical/PlayHistorySubsection.cs       |  2 +-
 .../Kudosu/DrawableKudosuHistoryItem.cs       |  2 +-
 .../Maintenance/DirectorySelectScreen.cs      |  2 +-
 osu.Game/Rulesets/Mods/ModBlockFail.cs        |  2 +-
 osu.Game/Rulesets/Mods/ModDoubleTime.cs       |  2 +-
 osu.Game/Rulesets/Mods/ModHardRock.cs         |  2 +-
 osu.Game/Rulesets/Mods/ModNoFail.cs           |  2 +-
 osu.Game/Rulesets/Mods/ModSuddenDeath.cs      |  2 +-
 .../Objects/Legacy/ConvertHitObjectParser.cs  |  4 +--
 osu.Game/Rulesets/Objects/SliderPath.cs       |  6 ++--
 .../Edit/Setup/SetupScreenHeaderBackground.cs |  2 +-
 .../IndeterminateSliderWithTextBoxInput.cs    | 14 ++++----
 .../Edit/Timing/SliderWithTextBoxInput.cs     |  8 ++---
 osu.Game/Screens/Import/FileImportScreen.cs   |  4 +--
 .../OnlinePlay/Lounge/DrawableLoungeRoom.cs   | 16 ++++-----
 .../Multiplayer/GameplayChatDisplay.cs        | 24 ++++++-------
 osu.Game/Screens/Play/HUD/HealthDisplay.cs    |  6 ++--
 osu.Game/Screens/Play/HUDOverlay.cs           |  4 +--
 .../Play/PlayerSettings/PlayerSliderBar.cs    |  4 +--
 60 files changed, 224 insertions(+), 224 deletions(-)

diff --git a/osu.Game.Rulesets.Catch.Tests/TestSceneDrawableHitObjects.cs b/osu.Game.Rulesets.Catch.Tests/TestSceneDrawableHitObjects.cs
index 459b8e1f6f..23f6222eb6 100644
--- a/osu.Game.Rulesets.Catch.Tests/TestSceneDrawableHitObjects.cs
+++ b/osu.Game.Rulesets.Catch.Tests/TestSceneDrawableHitObjects.cs
@@ -72,7 +72,7 @@ namespace osu.Game.Rulesets.Catch.Tests
         }
 
         [Test]
-        public void TestJuicestream()
+        public void TestJuiceStream()
         {
             AddStep("hit juicestream", () => spawnJuiceStream(true));
             AddUntilStep("wait for completion", () => playfieldIsEmpty);
diff --git a/osu.Game.Rulesets.Catch.Tests/TestSceneFruitObjects.cs b/osu.Game.Rulesets.Catch.Tests/TestSceneFruitObjects.cs
index 943adbef52..12b98dc93c 100644
--- a/osu.Game.Rulesets.Catch.Tests/TestSceneFruitObjects.cs
+++ b/osu.Game.Rulesets.Catch.Tests/TestSceneFruitObjects.cs
@@ -37,20 +37,20 @@ namespace osu.Game.Rulesets.Catch.Tests
             AddStep("show hyperdash droplet", () => SetContents(_ => createDrawableDroplet(true)));
         }
 
-        private Drawable createDrawableFruit(int indexInBeatmap, bool hyperdash = false) =>
+        private Drawable createDrawableFruit(int indexInBeatmap, bool hyperDash = false) =>
             new TestDrawableCatchHitObjectSpecimen(new DrawableFruit(new Fruit
             {
                 IndexInBeatmap = indexInBeatmap,
-                HyperDashBindable = { Value = hyperdash }
+                HyperDashBindable = { Value = hyperDash }
             }));
 
         private Drawable createDrawableBanana() =>
             new TestDrawableCatchHitObjectSpecimen(new DrawableBanana(new Banana()));
 
-        private Drawable createDrawableDroplet(bool hyperdash = false) =>
+        private Drawable createDrawableDroplet(bool hyperDash = false) =>
             new TestDrawableCatchHitObjectSpecimen(new DrawableDroplet(new Droplet
             {
-                HyperDashBindable = { Value = hyperdash }
+                HyperDashBindable = { Value = hyperDash }
             }));
 
         private Drawable createDrawableTinyDroplet() => new TestDrawableCatchHitObjectSpecimen(new DrawableTinyDroplet(new TinyDroplet()));
diff --git a/osu.Game.Rulesets.Mania.Tests/Skinning/TestSceneHitExplosion.cs b/osu.Game.Rulesets.Mania.Tests/Skinning/TestSceneHitExplosion.cs
index 004793e1e5..9e6e0a7776 100644
--- a/osu.Game.Rulesets.Mania.Tests/Skinning/TestSceneHitExplosion.cs
+++ b/osu.Game.Rulesets.Mania.Tests/Skinning/TestSceneHitExplosion.cs
@@ -24,13 +24,13 @@ namespace osu.Game.Rulesets.Mania.Tests.Skinning
 
         public TestSceneHitExplosion()
         {
-            int runcount = 0;
+            int runCount = 0;
 
             AddRepeatStep("explode", () =>
             {
-                runcount++;
+                runCount++;
 
-                if (runcount % 15 > 12)
+                if (runCount % 15 > 12)
                     return;
 
                 int poolIndex = 0;
@@ -39,7 +39,7 @@ namespace osu.Game.Rulesets.Mania.Tests.Skinning
                 {
                     c.Add(hitExplosionPools[poolIndex].Get(e =>
                     {
-                        e.Apply(new JudgementResult(new HitObject(), runcount % 6 == 0 ? new HoldNoteTickJudgement() : new ManiaJudgement()));
+                        e.Apply(new JudgementResult(new HitObject(), runCount % 6 == 0 ? new HoldNoteTickJudgement() : new ManiaJudgement()));
 
                         e.Anchor = Anchor.Centre;
                         e.Origin = Anchor.Centre;
diff --git a/osu.Game.Rulesets.Mania/Beatmaps/ManiaBeatmap.cs b/osu.Game.Rulesets.Mania/Beatmaps/ManiaBeatmap.cs
index 93a9ce3dbd..0058f6f884 100644
--- a/osu.Game.Rulesets.Mania/Beatmaps/ManiaBeatmap.cs
+++ b/osu.Game.Rulesets.Mania/Beatmaps/ManiaBeatmap.cs
@@ -40,7 +40,7 @@ namespace osu.Game.Rulesets.Mania.Beatmaps
         public override IEnumerable<BeatmapStatistic> GetStatistics()
         {
             int notes = HitObjects.Count(s => s is Note);
-            int holdnotes = HitObjects.Count(s => s is HoldNote);
+            int holdNotes = HitObjects.Count(s => s is HoldNote);
 
             return new[]
             {
@@ -54,7 +54,7 @@ namespace osu.Game.Rulesets.Mania.Beatmaps
                 {
                     Name = @"Hold Note Count",
                     CreateIcon = () => new BeatmapStatisticIcon(BeatmapStatisticsIconType.Sliders),
-                    Content = holdnotes.ToString(),
+                    Content = holdNotes.ToString(),
                 },
             };
         }
diff --git a/osu.Game.Rulesets.Mania/Skinning/Legacy/ManiaLegacySkinTransformer.cs b/osu.Game.Rulesets.Mania/Skinning/Legacy/ManiaLegacySkinTransformer.cs
index 0588ae57d7..431bd77402 100644
--- a/osu.Game.Rulesets.Mania/Skinning/Legacy/ManiaLegacySkinTransformer.cs
+++ b/osu.Game.Rulesets.Mania/Skinning/Legacy/ManiaLegacySkinTransformer.cs
@@ -24,7 +24,7 @@ namespace osu.Game.Rulesets.Mania.Skinning.Legacy
         /// Mapping of <see cref="HitResult"/> to their corresponding
         /// <see cref="LegacyManiaSkinConfigurationLookups"/> value.
         /// </summary>
-        private static readonly IReadOnlyDictionary<HitResult, LegacyManiaSkinConfigurationLookups> hitresult_mapping
+        private static readonly IReadOnlyDictionary<HitResult, LegacyManiaSkinConfigurationLookups> hit_result_mapping
             = new Dictionary<HitResult, LegacyManiaSkinConfigurationLookups>
             {
                 { HitResult.Perfect, LegacyManiaSkinConfigurationLookups.Hit300g },
@@ -39,7 +39,7 @@ namespace osu.Game.Rulesets.Mania.Skinning.Legacy
         /// Mapping of <see cref="HitResult"/> to their corresponding
         /// default filenames.
         /// </summary>
-        private static readonly IReadOnlyDictionary<HitResult, string> default_hitresult_skin_filenames
+        private static readonly IReadOnlyDictionary<HitResult, string> default_hit_result_skin_filenames
             = new Dictionary<HitResult, string>
             {
                 { HitResult.Perfect, "mania-hit300g" },
@@ -126,11 +126,11 @@ namespace osu.Game.Rulesets.Mania.Skinning.Legacy
 
         private Drawable getResult(HitResult result)
         {
-            if (!hitresult_mapping.ContainsKey(result))
+            if (!hit_result_mapping.ContainsKey(result))
                 return null;
 
-            string filename = this.GetManiaSkinConfig<string>(hitresult_mapping[result])?.Value
-                              ?? default_hitresult_skin_filenames[result];
+            string filename = this.GetManiaSkinConfig<string>(hit_result_mapping[result])?.Value
+                              ?? default_hit_result_skin_filenames[result];
 
             var animation = this.GetAnimation(filename, true, true);
             return animation == null ? null : new LegacyManiaJudgementPiece(result, animation);
diff --git a/osu.Game.Rulesets.Mania/UI/ManiaPlayfield.cs b/osu.Game.Rulesets.Mania/UI/ManiaPlayfield.cs
index 8830c440c0..4cd6624ac6 100644
--- a/osu.Game.Rulesets.Mania/UI/ManiaPlayfield.cs
+++ b/osu.Game.Rulesets.Mania/UI/ManiaPlayfield.cs
@@ -65,7 +65,7 @@ namespace osu.Game.Rulesets.Mania.UI
 
         public override bool Remove(DrawableHitObject h) => getStageByColumn(((ManiaHitObject)h.HitObject).Column).Remove(h);
 
-        public void Add(BarLine barline) => stages.ForEach(s => s.Add(barline));
+        public void Add(BarLine barLine) => stages.ForEach(s => s.Add(barLine));
 
         /// <summary>
         /// Retrieves a column from a screen-space position.
diff --git a/osu.Game.Rulesets.Mania/UI/Stage.cs b/osu.Game.Rulesets.Mania/UI/Stage.cs
index 8c703e7a8a..94910bb410 100644
--- a/osu.Game.Rulesets.Mania/UI/Stage.cs
+++ b/osu.Game.Rulesets.Mania/UI/Stage.cs
@@ -147,7 +147,7 @@ namespace osu.Game.Rulesets.Mania.UI
 
         public override bool Remove(DrawableHitObject h) => Columns.ElementAt(((ManiaHitObject)h.HitObject).Column - firstColumnIndex).Remove(h);
 
-        public void Add(BarLine barline) => base.Add(new DrawableBarLine(barline));
+        public void Add(BarLine barLine) => base.Add(new DrawableBarLine(barLine));
 
         internal void OnNewResult(DrawableHitObject judgedObject, JudgementResult result)
         {
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 3709cd3a7d..09759aa118 100644
--- a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointPiece.cs
+++ b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointPiece.cs
@@ -250,7 +250,7 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders.Components
             switch (pathType)
             {
                 case PathType.Catmull:
-                    return colours.Seafoam;
+                    return colours.SeaFoam;
 
                 case PathType.Bezier:
                     return colours.Pink;
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModSpunOut.cs b/osu.Game.Rulesets.Osu/Mods/OsuModSpunOut.cs
index 31474e8fbb..098c639949 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModSpunOut.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModSpunOut.cs
@@ -16,7 +16,7 @@ namespace osu.Game.Rulesets.Osu.Mods
     {
         public override string Name => "Spun Out";
         public override string Acronym => "SO";
-        public override IconUsage? Icon => OsuIcon.ModSpunout;
+        public override IconUsage? Icon => OsuIcon.ModSpunOut;
         public override ModType Type => ModType.Automation;
         public override string Description => @"Spinners will be automatically completed.";
         public override double ScoreMultiplier => 0.9;
diff --git a/osu.Game.Rulesets.Taiko.Tests/Skinning/TestSceneDrawableBarLine.cs b/osu.Game.Rulesets.Taiko.Tests/Skinning/TestSceneDrawableBarLine.cs
index 269a855219..16c4148d15 100644
--- a/osu.Game.Rulesets.Taiko.Tests/Skinning/TestSceneDrawableBarLine.cs
+++ b/osu.Game.Rulesets.Taiko.Tests/Skinning/TestSceneDrawableBarLine.cs
@@ -83,7 +83,7 @@ namespace osu.Game.Rulesets.Taiko.Tests.Skinning
 
         private BarLine createBarLineAtCurrentTime(bool major = false)
         {
-            var barline = new BarLine
+            var barLine = new BarLine
             {
                 Major = major,
                 StartTime = Time.Current + 2000,
@@ -92,9 +92,9 @@ namespace osu.Game.Rulesets.Taiko.Tests.Skinning
             var cpi = new ControlPointInfo();
             cpi.Add(0, new TimingControlPoint { BeatLength = 500 });
 
-            barline.ApplyDefaults(cpi, new BeatmapDifficulty());
+            barLine.ApplyDefaults(cpi, new BeatmapDifficulty());
 
-            return barline;
+            return barLine;
         }
     }
 }
diff --git a/osu.Game.Rulesets.Taiko/Beatmaps/TaikoBeatmap.cs b/osu.Game.Rulesets.Taiko/Beatmaps/TaikoBeatmap.cs
index 16a0726c8c..41fe63a553 100644
--- a/osu.Game.Rulesets.Taiko/Beatmaps/TaikoBeatmap.cs
+++ b/osu.Game.Rulesets.Taiko/Beatmaps/TaikoBeatmap.cs
@@ -13,7 +13,7 @@ namespace osu.Game.Rulesets.Taiko.Beatmaps
         public override IEnumerable<BeatmapStatistic> GetStatistics()
         {
             int hits = HitObjects.Count(s => s is Hit);
-            int drumrolls = HitObjects.Count(s => s is DrumRoll);
+            int drumRolls = HitObjects.Count(s => s is DrumRoll);
             int swells = HitObjects.Count(s => s is Swell);
 
             return new[]
@@ -28,7 +28,7 @@ namespace osu.Game.Rulesets.Taiko.Beatmaps
                 {
                     Name = @"Drumroll Count",
                     CreateIcon = () => new BeatmapStatisticIcon(BeatmapStatisticsIconType.Sliders),
-                    Content = drumrolls.ToString(),
+                    Content = drumRolls.ToString(),
                 },
                 new BeatmapStatistic
                 {
diff --git a/osu.Game.Tests/Editing/Checks/CheckMutedObjectsTest.cs b/osu.Game.Tests/Editing/Checks/CheckMutedObjectsTest.cs
index 4ab6e5cef6..91d9a8753c 100644
--- a/osu.Game.Tests/Editing/Checks/CheckMutedObjectsTest.cs
+++ b/osu.Game.Tests/Editing/Checks/CheckMutedObjectsTest.cs
@@ -40,80 +40,80 @@ namespace osu.Game.Tests.Editing.Checks
         [Test]
         public void TestNormalControlPointVolume()
         {
-            var hitcircle = new HitCircle
+            var hitCircle = new HitCircle
             {
                 StartTime = 0,
                 Samples = new List<HitSampleInfo> { new HitSampleInfo(HitSampleInfo.HIT_NORMAL) }
             };
-            hitcircle.ApplyDefaults(cpi, new BeatmapDifficulty());
+            hitCircle.ApplyDefaults(cpi, new BeatmapDifficulty());
 
-            assertOk(new List<HitObject> { hitcircle });
+            assertOk(new List<HitObject> { hitCircle });
         }
 
         [Test]
         public void TestLowControlPointVolume()
         {
-            var hitcircle = new HitCircle
+            var hitCircle = new HitCircle
             {
                 StartTime = 1000,
                 Samples = new List<HitSampleInfo> { new HitSampleInfo(HitSampleInfo.HIT_NORMAL) }
             };
-            hitcircle.ApplyDefaults(cpi, new BeatmapDifficulty());
+            hitCircle.ApplyDefaults(cpi, new BeatmapDifficulty());
 
-            assertLowVolume(new List<HitObject> { hitcircle });
+            assertLowVolume(new List<HitObject> { hitCircle });
         }
 
         [Test]
         public void TestMutedControlPointVolume()
         {
-            var hitcircle = new HitCircle
+            var hitCircle = new HitCircle
             {
                 StartTime = 2000,
                 Samples = new List<HitSampleInfo> { new HitSampleInfo(HitSampleInfo.HIT_NORMAL) }
             };
-            hitcircle.ApplyDefaults(cpi, new BeatmapDifficulty());
+            hitCircle.ApplyDefaults(cpi, new BeatmapDifficulty());
 
-            assertMuted(new List<HitObject> { hitcircle });
+            assertMuted(new List<HitObject> { hitCircle });
         }
 
         [Test]
         public void TestNormalSampleVolume()
         {
             // The sample volume should take precedence over the control point volume.
-            var hitcircle = new HitCircle
+            var hitCircle = new HitCircle
             {
                 StartTime = 2000,
                 Samples = new List<HitSampleInfo> { new HitSampleInfo(HitSampleInfo.HIT_NORMAL, volume: volume_regular) }
             };
-            hitcircle.ApplyDefaults(cpi, new BeatmapDifficulty());
+            hitCircle.ApplyDefaults(cpi, new BeatmapDifficulty());
 
-            assertOk(new List<HitObject> { hitcircle });
+            assertOk(new List<HitObject> { hitCircle });
         }
 
         [Test]
         public void TestLowSampleVolume()
         {
-            var hitcircle = new HitCircle
+            var hitCircle = new HitCircle
             {
                 StartTime = 2000,
                 Samples = new List<HitSampleInfo> { new HitSampleInfo(HitSampleInfo.HIT_NORMAL, volume: volume_low) }
             };
-            hitcircle.ApplyDefaults(cpi, new BeatmapDifficulty());
+            hitCircle.ApplyDefaults(cpi, new BeatmapDifficulty());
 
-            assertLowVolume(new List<HitObject> { hitcircle });
+            assertLowVolume(new List<HitObject> { hitCircle });
         }
 
         [Test]
         public void TestMutedSampleVolume()
         {
-            var hitcircle = new HitCircle
+            var hitCircle = new HitCircle
             {
                 StartTime = 0,
                 Samples = new List<HitSampleInfo> { new HitSampleInfo(HitSampleInfo.HIT_NORMAL, volume: volume_muted) }
             };
-            hitcircle.ApplyDefaults(cpi, new BeatmapDifficulty());
+            hitCircle.ApplyDefaults(cpi, new BeatmapDifficulty());
 
-            assertMuted(new List<HitObject> { hitcircle });
+            assertMuted(new List<HitObject> { hitCircle });
         }
 
         [Test]
diff --git a/osu.Game.Tests/Visual/Navigation/TestScenePresentBeatmap.cs b/osu.Game.Tests/Visual/Navigation/TestScenePresentBeatmap.cs
index 0d0931f871..3cb1ea85a9 100644
--- a/osu.Game.Tests/Visual/Navigation/TestScenePresentBeatmap.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestScenePresentBeatmap.cs
@@ -20,30 +20,30 @@ namespace osu.Game.Tests.Visual.Navigation
         public void TestFromMainMenu()
         {
             var firstImport = importBeatmap(1);
-            var secondimport = importBeatmap(3);
+            var secondImport = importBeatmap(3);
 
             presentAndConfirm(firstImport);
             returnToMenu();
-            presentAndConfirm(secondimport);
+            presentAndConfirm(secondImport);
             returnToMenu();
             presentSecondDifficultyAndConfirm(firstImport, 1);
             returnToMenu();
-            presentSecondDifficultyAndConfirm(secondimport, 3);
+            presentSecondDifficultyAndConfirm(secondImport, 3);
         }
 
         [Test]
         public void TestFromMainMenuDifferentRuleset()
         {
             var firstImport = importBeatmap(1);
-            var secondimport = importBeatmap(3, new ManiaRuleset().RulesetInfo);
+            var secondImport = importBeatmap(3, new ManiaRuleset().RulesetInfo);
 
             presentAndConfirm(firstImport);
             returnToMenu();
-            presentAndConfirm(secondimport);
+            presentAndConfirm(secondImport);
             returnToMenu();
             presentSecondDifficultyAndConfirm(firstImport, 1);
             returnToMenu();
-            presentSecondDifficultyAndConfirm(secondimport, 3);
+            presentSecondDifficultyAndConfirm(secondImport, 3);
         }
 
         [Test]
@@ -52,17 +52,17 @@ namespace osu.Game.Tests.Visual.Navigation
             var firstImport = importBeatmap(1);
             presentAndConfirm(firstImport);
 
-            var secondimport = importBeatmap(3);
-            presentAndConfirm(secondimport);
+            var secondImport = importBeatmap(3);
+            presentAndConfirm(secondImport);
 
             // Test presenting same beatmap more than once
-            presentAndConfirm(secondimport);
+            presentAndConfirm(secondImport);
 
             presentSecondDifficultyAndConfirm(firstImport, 1);
-            presentSecondDifficultyAndConfirm(secondimport, 3);
+            presentSecondDifficultyAndConfirm(secondImport, 3);
 
             // Test presenting same beatmap more than once
-            presentSecondDifficultyAndConfirm(secondimport, 3);
+            presentSecondDifficultyAndConfirm(secondImport, 3);
         }
 
         [Test]
@@ -71,11 +71,11 @@ namespace osu.Game.Tests.Visual.Navigation
             var firstImport = importBeatmap(1);
             presentAndConfirm(firstImport);
 
-            var secondimport = importBeatmap(3, new ManiaRuleset().RulesetInfo);
-            presentAndConfirm(secondimport);
+            var secondImport = importBeatmap(3, new ManiaRuleset().RulesetInfo);
+            presentAndConfirm(secondImport);
 
             presentSecondDifficultyAndConfirm(firstImport, 1);
-            presentSecondDifficultyAndConfirm(secondimport, 3);
+            presentSecondDifficultyAndConfirm(secondImport, 3);
         }
 
         private void returnToMenu()
diff --git a/osu.Game.Tests/Visual/Navigation/TestScenePresentScore.cs b/osu.Game.Tests/Visual/Navigation/TestScenePresentScore.cs
index 1653247570..7ee593de00 100644
--- a/osu.Game.Tests/Visual/Navigation/TestScenePresentScore.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestScenePresentScore.cs
@@ -65,11 +65,11 @@ namespace osu.Game.Tests.Visual.Navigation
         public void TestFromMainMenu([Values] ScorePresentType type)
         {
             var firstImport = importScore(1);
-            var secondimport = importScore(3);
+            var secondImport = importScore(3);
 
             presentAndConfirm(firstImport, type);
             returnToMenu();
-            presentAndConfirm(secondimport, type);
+            presentAndConfirm(secondImport, type);
             returnToMenu();
             returnToMenu();
         }
@@ -78,11 +78,11 @@ namespace osu.Game.Tests.Visual.Navigation
         public void TestFromMainMenuDifferentRuleset([Values] ScorePresentType type)
         {
             var firstImport = importScore(1);
-            var secondimport = importScore(3, new ManiaRuleset().RulesetInfo);
+            var secondImport = importScore(3, new ManiaRuleset().RulesetInfo);
 
             presentAndConfirm(firstImport, type);
             returnToMenu();
-            presentAndConfirm(secondimport, type);
+            presentAndConfirm(secondImport, type);
             returnToMenu();
             returnToMenu();
         }
@@ -93,8 +93,8 @@ namespace osu.Game.Tests.Visual.Navigation
             var firstImport = importScore(1);
             presentAndConfirm(firstImport, type);
 
-            var secondimport = importScore(3);
-            presentAndConfirm(secondimport, type);
+            var secondImport = importScore(3);
+            presentAndConfirm(secondImport, type);
         }
 
         [Test]
@@ -103,8 +103,8 @@ namespace osu.Game.Tests.Visual.Navigation
             var firstImport = importScore(1);
             presentAndConfirm(firstImport, type);
 
-            var secondimport = importScore(3, new ManiaRuleset().RulesetInfo);
-            presentAndConfirm(secondimport, type);
+            var secondImport = importScore(3, new ManiaRuleset().RulesetInfo);
+            presentAndConfirm(secondImport, type);
         }
 
         private void returnToMenu()
diff --git a/osu.Game.Tests/Visual/Online/TestSceneKudosuHistory.cs b/osu.Game.Tests/Visual/Online/TestSceneKudosuHistory.cs
index 2231139856..8bf2ef34f2 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneKudosuHistory.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneKudosuHistory.cs
@@ -44,7 +44,7 @@ namespace osu.Game.Tests.Visual.Online
         [BackgroundDependencyLoader]
         private void load(OsuColour colours)
         {
-            background.Colour = colours.GreySeafoam;
+            background.Colour = colours.GreySeaFoam;
         }
 
         private readonly IEnumerable<APIKudosuHistory> items = new[]
diff --git a/osu.Game.Tests/Visual/Online/TestScenePlayHistorySubsection.cs b/osu.Game.Tests/Visual/Online/TestScenePlayHistorySubsection.cs
index fecc1af03c..a96fde6c20 100644
--- a/osu.Game.Tests/Visual/Online/TestScenePlayHistorySubsection.cs
+++ b/osu.Game.Tests/Visual/Online/TestScenePlayHistorySubsection.cs
@@ -87,7 +87,7 @@ namespace osu.Game.Tests.Visual.Online
         {
             AddStep("Load user", () => user.Value = user_with_filled_values);
             AddAssert("Section is visible", () => section.Alpha == 1);
-            AddAssert("Array length is the same", () => user_with_filled_values.MonthlyPlaycounts.Length == getChartValuesLength());
+            AddAssert("Array length is the same", () => user_with_filled_values.MonthlyPlayCounts.Length == getChartValuesLength());
         }
 
         [Test]
@@ -108,13 +108,13 @@ namespace osu.Game.Tests.Visual.Online
         private static readonly APIUser user_with_empty_values = new APIUser
         {
             Id = 2,
-            MonthlyPlaycounts = Array.Empty<APIUserHistoryCount>()
+            MonthlyPlayCounts = Array.Empty<APIUserHistoryCount>()
         };
 
         private static readonly APIUser user_with_one_value = new APIUser
         {
             Id = 3,
-            MonthlyPlaycounts = new[]
+            MonthlyPlayCounts = new[]
             {
                 new APIUserHistoryCount { Date = new DateTime(2010, 5, 1), Count = 100 }
             }
@@ -123,7 +123,7 @@ namespace osu.Game.Tests.Visual.Online
         private static readonly APIUser user_with_two_values = new APIUser
         {
             Id = 4,
-            MonthlyPlaycounts = new[]
+            MonthlyPlayCounts = new[]
             {
                 new APIUserHistoryCount { Date = new DateTime(2010, 5, 1), Count = 1 },
                 new APIUserHistoryCount { Date = new DateTime(2010, 6, 1), Count = 2 }
@@ -133,7 +133,7 @@ namespace osu.Game.Tests.Visual.Online
         private static readonly APIUser user_with_constant_values = new APIUser
         {
             Id = 5,
-            MonthlyPlaycounts = new[]
+            MonthlyPlayCounts = new[]
             {
                 new APIUserHistoryCount { Date = new DateTime(2010, 5, 1), Count = 5 },
                 new APIUserHistoryCount { Date = new DateTime(2010, 6, 1), Count = 5 },
@@ -144,7 +144,7 @@ namespace osu.Game.Tests.Visual.Online
         private static readonly APIUser user_with_zero_values = new APIUser
         {
             Id = 6,
-            MonthlyPlaycounts = new[]
+            MonthlyPlayCounts = new[]
             {
                 new APIUserHistoryCount { Date = new DateTime(2010, 5, 1), Count = 0 },
                 new APIUserHistoryCount { Date = new DateTime(2010, 6, 1), Count = 0 },
@@ -155,7 +155,7 @@ namespace osu.Game.Tests.Visual.Online
         private static readonly APIUser user_with_filled_values = new APIUser
         {
             Id = 7,
-            MonthlyPlaycounts = new[]
+            MonthlyPlayCounts = new[]
             {
                 new APIUserHistoryCount { Date = new DateTime(2010, 5, 1), Count = 1000 },
                 new APIUserHistoryCount { Date = new DateTime(2010, 6, 1), Count = 20 },
@@ -170,7 +170,7 @@ namespace osu.Game.Tests.Visual.Online
         private static readonly APIUser user_with_missing_values = new APIUser
         {
             Id = 8,
-            MonthlyPlaycounts = new[]
+            MonthlyPlayCounts = new[]
             {
                 new APIUserHistoryCount { Date = new DateTime(2020, 1, 1), Count = 100 },
                 new APIUserHistoryCount { Date = new DateTime(2020, 7, 1), Count = 200 }
diff --git a/osu.Game.Tests/Visual/Online/TestSceneStandAloneChatDisplay.cs b/osu.Game.Tests/Visual/Online/TestSceneStandAloneChatDisplay.cs
index b7bce012ce..779d72190d 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneStandAloneChatDisplay.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneStandAloneChatDisplay.cs
@@ -309,8 +309,8 @@ namespace osu.Game.Tests.Visual.Online
 
         private class TestStandAloneChatDisplay : StandAloneChatDisplay
         {
-            public TestStandAloneChatDisplay(bool textbox = false)
-                : base(textbox)
+            public TestStandAloneChatDisplay(bool textBox = false)
+                : base(textBox)
             {
             }
 
diff --git a/osu.Game.Tests/Visual/Settings/TestSceneRestoreDefaultValueButton.cs b/osu.Game.Tests/Visual/Settings/TestSceneRestoreDefaultValueButton.cs
index 3eb7a77600..0c46fa439a 100644
--- a/osu.Game.Tests/Visual/Settings/TestSceneRestoreDefaultValueButton.cs
+++ b/osu.Game.Tests/Visual/Settings/TestSceneRestoreDefaultValueButton.cs
@@ -39,7 +39,7 @@ namespace osu.Game.Tests.Visual.Settings
                     new Box
                     {
                         RelativeSizeAxes = Axes.Both,
-                        Colour = colours.GreySeafoam
+                        Colour = colours.GreySeaFoam
                     },
                     restoreDefaultValueButton = new RestoreDefaultValueButton<float>
                     {
diff --git a/osu.Game.Tests/Visual/Settings/TestSceneSettingsSource.cs b/osu.Game.Tests/Visual/Settings/TestSceneSettingsSource.cs
index fc81d9792e..ffaa038930 100644
--- a/osu.Game.Tests/Visual/Settings/TestSceneSettingsSource.cs
+++ b/osu.Game.Tests/Visual/Settings/TestSceneSettingsSource.cs
@@ -61,7 +61,7 @@ namespace osu.Game.Tests.Visual.Settings
             };
 
             [SettingSource("Sample number textbox", "Textbox number entry", SettingControlType = typeof(SettingsNumberBox))]
-            public Bindable<int?> IntTextboxBindable { get; } = new Bindable<int?>
+            public Bindable<int?> IntTextBoxBindable { get; } = new Bindable<int?>
             {
                 Default = null,
                 Value = null
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneOnScreenDisplay.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneOnScreenDisplay.cs
index 493e2f54e5..544581082e 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneOnScreenDisplay.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneOnScreenDisplay.cs
@@ -29,10 +29,10 @@ namespace osu.Game.Tests.Visual.UserInterface
             AddStep("Display toast with lengthy text", () => osd.Display(new LengthyToast()));
             AddAssert("Toast width is greater than 240", () => osd.Child.Width > 240);
 
-            AddRepeatStep("Change toggle (no bind)", () => config.ToggleSetting(TestConfigSetting.ToggleSettingNoKeybind), 2);
-            AddRepeatStep("Change toggle (with bind)", () => config.ToggleSetting(TestConfigSetting.ToggleSettingWithKeybind), 2);
-            AddRepeatStep("Change enum (no bind)", () => config.IncrementEnumSetting(TestConfigSetting.EnumSettingNoKeybind), 3);
-            AddRepeatStep("Change enum (with bind)", () => config.IncrementEnumSetting(TestConfigSetting.EnumSettingWithKeybind), 3);
+            AddRepeatStep("Change toggle (no bind)", () => config.ToggleSetting(TestConfigSetting.ToggleSettingNoKeyBind), 2);
+            AddRepeatStep("Change toggle (with bind)", () => config.ToggleSetting(TestConfigSetting.ToggleSettingWithKeyBind), 2);
+            AddRepeatStep("Change enum (no bind)", () => config.IncrementEnumSetting(TestConfigSetting.EnumSettingNoKeyBind), 3);
+            AddRepeatStep("Change enum (with bind)", () => config.IncrementEnumSetting(TestConfigSetting.EnumSettingWithKeyBind), 3);
         }
 
         private class TestConfigManager : ConfigManager<TestConfigSetting>
@@ -44,10 +44,10 @@ namespace osu.Game.Tests.Visual.UserInterface
 
             protected override void InitialiseDefaults()
             {
-                SetDefault(TestConfigSetting.ToggleSettingNoKeybind, false);
-                SetDefault(TestConfigSetting.EnumSettingNoKeybind, EnumSetting.Setting1);
-                SetDefault(TestConfigSetting.ToggleSettingWithKeybind, false);
-                SetDefault(TestConfigSetting.EnumSettingWithKeybind, EnumSetting.Setting1);
+                SetDefault(TestConfigSetting.ToggleSettingNoKeyBind, false);
+                SetDefault(TestConfigSetting.EnumSettingNoKeyBind, EnumSetting.Setting1);
+                SetDefault(TestConfigSetting.ToggleSettingWithKeyBind, false);
+                SetDefault(TestConfigSetting.EnumSettingWithKeyBind, EnumSetting.Setting1);
 
                 base.InitialiseDefaults();
             }
@@ -64,10 +64,10 @@ namespace osu.Game.Tests.Visual.UserInterface
 
             public override TrackedSettings CreateTrackedSettings() => new TrackedSettings
             {
-                new TrackedSetting<bool>(TestConfigSetting.ToggleSettingNoKeybind, b => new SettingDescription(b, "toggle setting with no keybind", b ? "enabled" : "disabled")),
-                new TrackedSetting<EnumSetting>(TestConfigSetting.EnumSettingNoKeybind, v => new SettingDescription(v, "enum setting with no keybind", v.ToString())),
-                new TrackedSetting<bool>(TestConfigSetting.ToggleSettingWithKeybind, b => new SettingDescription(b, "toggle setting with keybind", b ? "enabled" : "disabled", "fake keybind")),
-                new TrackedSetting<EnumSetting>(TestConfigSetting.EnumSettingWithKeybind, v => new SettingDescription(v, "enum setting with keybind", v.ToString(), "fake keybind")),
+                new TrackedSetting<bool>(TestConfigSetting.ToggleSettingNoKeyBind, b => new SettingDescription(b, "toggle setting with no keybind", b ? "enabled" : "disabled")),
+                new TrackedSetting<EnumSetting>(TestConfigSetting.EnumSettingNoKeyBind, v => new SettingDescription(v, "enum setting with no keybind", v.ToString())),
+                new TrackedSetting<bool>(TestConfigSetting.ToggleSettingWithKeyBind, b => new SettingDescription(b, "toggle setting with keybind", b ? "enabled" : "disabled", "fake keybind")),
+                new TrackedSetting<EnumSetting>(TestConfigSetting.EnumSettingWithKeyBind, v => new SettingDescription(v, "enum setting with keybind", v.ToString(), "fake keybind")),
             };
 
             protected override void PerformLoad()
@@ -79,10 +79,10 @@ namespace osu.Game.Tests.Visual.UserInterface
 
         private enum TestConfigSetting
         {
-            ToggleSettingNoKeybind,
-            EnumSettingNoKeybind,
-            ToggleSettingWithKeybind,
-            EnumSettingWithKeybind
+            ToggleSettingNoKeyBind,
+            EnumSettingNoKeyBind,
+            ToggleSettingWithKeyBind,
+            EnumSettingWithKeyBind
         }
 
         private enum EnumSetting
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneOsuTextBox.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneOsuTextBox.cs
index fc1866cdf3..353f84c546 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneOsuTextBox.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneOsuTextBox.cs
@@ -62,6 +62,6 @@ namespace osu.Game.Tests.Visual.UserInterface
         }
 
         private void clearTextboxes(IEnumerable<OsuTextBox> textBoxes) => AddStep("clear textbox", () => textBoxes.ForEach(textBox => textBox.Text = null));
-        private void expectedValue(IEnumerable<OsuTextBox> textBoxes, string value) => AddAssert("expected textbox value", () => textBoxes.All(textbox => textbox.Text == value));
+        private void expectedValue(IEnumerable<OsuTextBox> textBoxes, string value) => AddAssert("expected textbox value", () => textBoxes.All(textBox => textBox.Text == value));
     }
 }
diff --git a/osu.Game.Tests/Visual/UserInterface/ThemeComparisonTestScene.cs b/osu.Game.Tests/Visual/UserInterface/ThemeComparisonTestScene.cs
index db1c90f287..7986f14d1d 100644
--- a/osu.Game.Tests/Visual/UserInterface/ThemeComparisonTestScene.cs
+++ b/osu.Game.Tests/Visual/UserInterface/ThemeComparisonTestScene.cs
@@ -27,7 +27,7 @@ namespace osu.Game.Tests.Visual.UserInterface
                 new Box
                 {
                     RelativeSizeAxes = Axes.Both,
-                    Colour = colours.GreySeafoam
+                    Colour = colours.GreySeaFoam
                 },
                 CreateContent()
             });
diff --git a/osu.Game.Tournament/Screens/Drawings/Components/ScrollingTeamContainer.cs b/osu.Game.Tournament/Screens/Drawings/Components/ScrollingTeamContainer.cs
index c7060bd538..6fec74f95b 100644
--- a/osu.Game.Tournament/Screens/Drawings/Components/ScrollingTeamContainer.cs
+++ b/osu.Game.Tournament/Screens/Drawings/Components/ScrollingTeamContainer.cs
@@ -85,14 +85,14 @@ namespace osu.Game.Tournament.Screens.Drawings.Components
 
         private ScrollState scrollState;
 
-        private void setScrollState(ScrollState newstate)
+        private void setScrollState(ScrollState newState)
         {
-            if (scrollState == newstate)
+            if (scrollState == newState)
                 return;
 
             delayedStateChangeDelegate?.Cancel();
 
-            switch (scrollState = newstate)
+            switch (scrollState = newState)
             {
                 case ScrollState.Scrolling:
                     resetSelected();
diff --git a/osu.Game.Tournament/Screens/Setup/StablePathSelectScreen.cs b/osu.Game.Tournament/Screens/Setup/StablePathSelectScreen.cs
index 5a1ceecd01..fb9ca46c2d 100644
--- a/osu.Game.Tournament/Screens/Setup/StablePathSelectScreen.cs
+++ b/osu.Game.Tournament/Screens/Setup/StablePathSelectScreen.cs
@@ -50,7 +50,7 @@ namespace osu.Game.Tournament.Screens.Setup
                     {
                         new Box
                         {
-                            Colour = colours.GreySeafoamDark,
+                            Colour = colours.GreySeaFoamDark,
                             RelativeSizeAxes = Axes.Both,
                         },
                         new GridContainer
diff --git a/osu.Game/Beatmaps/Drawables/BeatmapSetOnlineStatusPill.cs b/osu.Game/Beatmaps/Drawables/BeatmapSetOnlineStatusPill.cs
index 6345085069..19026638ba 100644
--- a/osu.Game/Beatmaps/Drawables/BeatmapSetOnlineStatusPill.cs
+++ b/osu.Game/Beatmaps/Drawables/BeatmapSetOnlineStatusPill.cs
@@ -94,9 +94,9 @@ namespace osu.Game.Beatmaps.Drawables
             if (colourProvider != null)
                 statusText.Colour = status == BeatmapOnlineStatus.Graveyard ? colourProvider.Background1 : colourProvider.Background3;
             else
-                statusText.Colour = status == BeatmapOnlineStatus.Graveyard ? colours.GreySeafoamLight : Color4.Black;
+                statusText.Colour = status == BeatmapOnlineStatus.Graveyard ? colours.GreySeaFoamLight : Color4.Black;
 
-            background.Colour = OsuColour.ForBeatmapSetOnlineStatus(Status) ?? colourProvider?.Light1 ?? colours.GreySeafoamLighter;
+            background.Colour = OsuColour.ForBeatmapSetOnlineStatus(Status) ?? colourProvider?.Light1 ?? colours.GreySeaFoamLighter;
         }
     }
 }
diff --git a/osu.Game/Collections/DrawableCollectionListItem.cs b/osu.Game/Collections/DrawableCollectionListItem.cs
index e2ec25337e..909595bd1c 100644
--- a/osu.Game/Collections/DrawableCollectionListItem.cs
+++ b/osu.Game/Collections/DrawableCollectionListItem.cs
@@ -146,8 +146,8 @@ namespace osu.Game.Collections
             [BackgroundDependencyLoader]
             private void load(OsuColour colours)
             {
-                BackgroundUnfocused = colours.GreySeafoamDarker.Darken(0.5f);
-                BackgroundFocused = colours.GreySeafoam;
+                BackgroundUnfocused = colours.GreySeaFoamDarker.Darken(0.5f);
+                BackgroundFocused = colours.GreySeaFoam;
             }
         }
 
diff --git a/osu.Game/Collections/ManageCollectionsDialog.cs b/osu.Game/Collections/ManageCollectionsDialog.cs
index 95fbfa0f86..cb350bca33 100644
--- a/osu.Game/Collections/ManageCollectionsDialog.cs
+++ b/osu.Game/Collections/ManageCollectionsDialog.cs
@@ -46,7 +46,7 @@ namespace osu.Game.Collections
             {
                 new Box
                 {
-                    Colour = colours.GreySeafoamDark,
+                    Colour = colours.GreySeaFoamDark,
                     RelativeSizeAxes = Axes.Both,
                 },
                 new Container
@@ -82,7 +82,7 @@ namespace osu.Game.Collections
                                             Anchor = Anchor.CentreRight,
                                             Origin = Anchor.CentreRight,
                                             Icon = FontAwesome.Solid.Times,
-                                            Colour = colours.GreySeafoamDarker,
+                                            Colour = colours.GreySeaFoamDarker,
                                             Scale = new Vector2(0.8f),
                                             X = -10,
                                             Action = () => State.Value = Visibility.Hidden
@@ -100,7 +100,7 @@ namespace osu.Game.Collections
                                         new Box
                                         {
                                             RelativeSizeAxes = Axes.Both,
-                                            Colour = colours.GreySeafoamDarker
+                                            Colour = colours.GreySeaFoamDarker
                                         },
                                         new DrawableCollectionList
                                         {
diff --git a/osu.Game/Graphics/DateTooltip.cs b/osu.Game/Graphics/DateTooltip.cs
index d5768b259a..2dca8719e9 100644
--- a/osu.Game/Graphics/DateTooltip.cs
+++ b/osu.Game/Graphics/DateTooltip.cs
@@ -56,7 +56,7 @@ namespace osu.Game.Graphics
         [BackgroundDependencyLoader]
         private void load(OsuColour colours)
         {
-            background.Colour = colours.GreySeafoamDarker;
+            background.Colour = colours.GreySeaFoamDarker;
             timeText.Colour = colours.BlueLighter;
         }
 
diff --git a/osu.Game/Graphics/OsuColour.cs b/osu.Game/Graphics/OsuColour.cs
index 69dfd3a7a1..f63bd53549 100644
--- a/osu.Game/Graphics/OsuColour.cs
+++ b/osu.Game/Graphics/OsuColour.cs
@@ -212,12 +212,12 @@ namespace osu.Game.Graphics
         public readonly Color4 GreySkyDark = Color4Extensions.FromHex(@"303d47");
         public readonly Color4 GreySkyDarker = Color4Extensions.FromHex(@"21272c");
 
-        public readonly Color4 Seafoam = Color4Extensions.FromHex(@"05ffa2");
-        public readonly Color4 GreySeafoamLighter = Color4Extensions.FromHex(@"9ebab1");
-        public readonly Color4 GreySeafoamLight = Color4Extensions.FromHex(@"4d7365");
-        public readonly Color4 GreySeafoam = Color4Extensions.FromHex(@"33413c");
-        public readonly Color4 GreySeafoamDark = Color4Extensions.FromHex(@"2c3532");
-        public readonly Color4 GreySeafoamDarker = Color4Extensions.FromHex(@"1e2422");
+        public readonly Color4 SeaFoam = Color4Extensions.FromHex(@"05ffa2");
+        public readonly Color4 GreySeaFoamLighter = Color4Extensions.FromHex(@"9ebab1");
+        public readonly Color4 GreySeaFoamLight = Color4Extensions.FromHex(@"4d7365");
+        public readonly Color4 GreySeaFoam = Color4Extensions.FromHex(@"33413c");
+        public readonly Color4 GreySeaFoamDark = Color4Extensions.FromHex(@"2c3532");
+        public readonly Color4 GreySeaFoamDarker = Color4Extensions.FromHex(@"1e2422");
 
         public readonly Color4 Cyan = Color4Extensions.FromHex(@"05f4fd");
         public readonly Color4 GreyCyanLighter = Color4Extensions.FromHex(@"77b1b3");
diff --git a/osu.Game/Graphics/OsuIcon.cs b/osu.Game/Graphics/OsuIcon.cs
index 982e9dacab..e8267edab0 100644
--- a/osu.Game/Graphics/OsuIcon.cs
+++ b/osu.Game/Graphics/OsuIcon.cs
@@ -39,10 +39,10 @@ namespace osu.Game.Graphics
         public static IconUsage ListSearch => Get(0xe032);
 
         //osu! playstyles
-        public static IconUsage PlaystyleTablet => Get(0xe02a);
-        public static IconUsage PlaystyleMouse => Get(0xe029);
-        public static IconUsage PlaystyleKeyboard => Get(0xe02b);
-        public static IconUsage PlaystyleTouch => Get(0xe02c);
+        public static IconUsage PlayStyleTablet => Get(0xe02a);
+        public static IconUsage PlayStyleMouse => Get(0xe029);
+        public static IconUsage PlayStyleKeyboard => Get(0xe02b);
+        public static IconUsage PlayStyleTouch => Get(0xe02c);
 
         // osu! difficulties
         public static IconUsage EasyOsu => Get(0xe015);
@@ -77,17 +77,17 @@ namespace osu.Game.Graphics
         public static IconUsage ModAutopilot => Get(0xe03a);
         public static IconUsage ModAuto => Get(0xe03b);
         public static IconUsage ModCinema => Get(0xe03c);
-        public static IconUsage ModDoubletime => Get(0xe03d);
+        public static IconUsage ModDoubleTime => Get(0xe03d);
         public static IconUsage ModEasy => Get(0xe03e);
         public static IconUsage ModFlashlight => Get(0xe03f);
         public static IconUsage ModHalftime => Get(0xe040);
-        public static IconUsage ModHardrock => Get(0xe041);
+        public static IconUsage ModHardRock => Get(0xe041);
         public static IconUsage ModHidden => Get(0xe042);
         public static IconUsage ModNightcore => Get(0xe043);
-        public static IconUsage ModNofail => Get(0xe044);
+        public static IconUsage ModNoFail => Get(0xe044);
         public static IconUsage ModRelax => Get(0xe045);
-        public static IconUsage ModSpunout => Get(0xe046);
-        public static IconUsage ModSuddendeath => Get(0xe047);
+        public static IconUsage ModSpunOut => Get(0xe046);
+        public static IconUsage ModSuddenDeath => Get(0xe047);
         public static IconUsage ModTarget => Get(0xe048);
         public static IconUsage ModBg => Get(0xe04a);
     }
diff --git a/osu.Game/Graphics/UserInterfaceV2/OsuDirectorySelectorDirectory.cs b/osu.Game/Graphics/UserInterfaceV2/OsuDirectorySelectorDirectory.cs
index 618c7dabfa..ce2e7794a9 100644
--- a/osu.Game/Graphics/UserInterfaceV2/OsuDirectorySelectorDirectory.cs
+++ b/osu.Game/Graphics/UserInterfaceV2/OsuDirectorySelectorDirectory.cs
@@ -54,7 +54,7 @@ namespace osu.Game.Graphics.UserInterfaceV2
 
                 InternalChild = new Box
                 {
-                    Colour = colours.GreySeafoamDarker,
+                    Colour = colours.GreySeaFoamDarker,
                     RelativeSizeAxes = Axes.Both,
                 };
             }
diff --git a/osu.Game/Graphics/UserInterfaceV2/OsuHSVColourPicker.cs b/osu.Game/Graphics/UserInterfaceV2/OsuHSVColourPicker.cs
index 30e38e8938..0189b30aad 100644
--- a/osu.Game/Graphics/UserInterfaceV2/OsuHSVColourPicker.cs
+++ b/osu.Game/Graphics/UserInterfaceV2/OsuHSVColourPicker.cs
@@ -26,7 +26,7 @@ namespace osu.Game.Graphics.UserInterfaceV2
         [BackgroundDependencyLoader(true)]
         private void load([CanBeNull] OverlayColourProvider colourProvider, OsuColour osuColour)
         {
-            Background.Colour = colourProvider?.Dark5 ?? osuColour.GreySeafoamDark;
+            Background.Colour = colourProvider?.Dark5 ?? osuColour.GreySeaFoamDark;
 
             Content.Padding = new MarginPadding(spacing);
             Content.Spacing = new Vector2(0, spacing);
diff --git a/osu.Game/Graphics/UserInterfaceV2/OsuHexColourPicker.cs b/osu.Game/Graphics/UserInterfaceV2/OsuHexColourPicker.cs
index 331a1b67c9..5368a800bc 100644
--- a/osu.Game/Graphics/UserInterfaceV2/OsuHexColourPicker.cs
+++ b/osu.Game/Graphics/UserInterfaceV2/OsuHexColourPicker.cs
@@ -23,7 +23,7 @@ namespace osu.Game.Graphics.UserInterfaceV2
         [BackgroundDependencyLoader(true)]
         private void load([CanBeNull] OverlayColourProvider overlayColourProvider, OsuColour osuColour)
         {
-            Background.Colour = overlayColourProvider?.Dark6 ?? osuColour.GreySeafoamDarker;
+            Background.Colour = overlayColourProvider?.Dark6 ?? osuColour.GreySeaFoamDarker;
         }
 
         protected override TextBox CreateHexCodeTextBox() => new OsuTextBox();
diff --git a/osu.Game/Graphics/UserInterfaceV2/OsuPopover.cs b/osu.Game/Graphics/UserInterfaceV2/OsuPopover.cs
index d1857dd174..085541b3ef 100644
--- a/osu.Game/Graphics/UserInterfaceV2/OsuPopover.cs
+++ b/osu.Game/Graphics/UserInterfaceV2/OsuPopover.cs
@@ -39,7 +39,7 @@ namespace osu.Game.Graphics.UserInterfaceV2
         [BackgroundDependencyLoader(true)]
         private void load([CanBeNull] OverlayColourProvider colourProvider, OsuColour colours)
         {
-            Background.Colour = Arrow.Colour = colourProvider?.Background4 ?? colours.GreySeafoamDarker;
+            Background.Colour = Arrow.Colour = colourProvider?.Background4 ?? colours.GreySeaFoamDarker;
         }
 
         protected override Drawable CreateArrow() => Empty();
diff --git a/osu.Game/Online/API/Requests/Responses/APIUser.cs b/osu.Game/Online/API/Requests/Responses/APIUser.cs
index 50f5d67796..ed40e9b498 100644
--- a/osu.Game/Online/API/Requests/Responses/APIUser.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIUser.cs
@@ -152,10 +152,10 @@ namespace osu.Game.Online.API.Requests.Responses
         public int ScoresRecentCount;
 
         [JsonProperty(@"beatmap_playcounts_count")]
-        public int BeatmapPlaycountsCount;
+        public int BeatmapPlayCountsCount;
 
         [JsonProperty]
-        private string[] playstyle
+        private string[] playStyle
         {
             set => PlayStyles = value?.Select(str => Enum.Parse(typeof(APIPlayStyle), str, true)).Cast<APIPlayStyle>().ToArray();
         }
@@ -213,7 +213,7 @@ namespace osu.Game.Online.API.Requests.Responses
         public APIUserAchievement[] Achievements;
 
         [JsonProperty("monthly_playcounts")]
-        public APIUserHistoryCount[] MonthlyPlaycounts;
+        public APIUserHistoryCount[] MonthlyPlayCounts;
 
         [JsonProperty("replays_watched_counts")]
         public APIUserHistoryCount[] ReplaysWatchedCounts;
diff --git a/osu.Game/Online/Chat/StandAloneChatDisplay.cs b/osu.Game/Online/Chat/StandAloneChatDisplay.cs
index 1f8d05fcd1..81fd5ad98c 100644
--- a/osu.Game/Online/Chat/StandAloneChatDisplay.cs
+++ b/osu.Game/Online/Chat/StandAloneChatDisplay.cs
@@ -23,27 +23,27 @@ namespace osu.Game.Online.Chat
     {
         public readonly Bindable<Channel> Channel = new Bindable<Channel>();
 
-        protected readonly ChatTextBox Textbox;
+        protected readonly ChatTextBox TextBox;
 
         protected ChannelManager ChannelManager;
 
         private StandAloneDrawableChannel drawableChannel;
 
-        private readonly bool postingTextbox;
+        private readonly bool postingTextBox;
 
         protected readonly Box Background;
 
-        private const float textbox_height = 30;
+        private const float text_box_height = 30;
 
         /// <summary>
         /// Construct a new instance.
         /// </summary>
-        /// <param name="postingTextbox">Whether a textbox for posting new messages should be displayed.</param>
-        public StandAloneChatDisplay(bool postingTextbox = false)
+        /// <param name="postingTextBox">Whether a textbox for posting new messages should be displayed.</param>
+        public StandAloneChatDisplay(bool postingTextBox = false)
         {
             const float corner_radius = 10;
 
-            this.postingTextbox = postingTextbox;
+            this.postingTextBox = postingTextBox;
             CornerRadius = corner_radius;
             Masking = true;
 
@@ -57,12 +57,12 @@ namespace osu.Game.Online.Chat
                 },
             };
 
-            if (postingTextbox)
+            if (postingTextBox)
             {
-                AddInternal(Textbox = new ChatTextBox
+                AddInternal(TextBox = new ChatTextBox
                 {
                     RelativeSizeAxes = Axes.X,
-                    Height = textbox_height,
+                    Height = text_box_height,
                     PlaceholderText = "type your message",
                     CornerRadius = corner_radius,
                     ReleaseFocusOnCommit = false,
@@ -71,7 +71,7 @@ namespace osu.Game.Online.Chat
                     Origin = Anchor.BottomLeft,
                 });
 
-                Textbox.OnCommit += postMessage;
+                TextBox.OnCommit += postMessage;
             }
 
             Channel.BindValueChanged(channelChanged);
@@ -86,9 +86,9 @@ namespace osu.Game.Online.Chat
         protected virtual StandAloneDrawableChannel CreateDrawableChannel(Channel channel) =>
             new StandAloneDrawableChannel(channel);
 
-        private void postMessage(TextBox sender, bool newtext)
+        private void postMessage(TextBox sender, bool newText)
         {
-            string text = Textbox.Text.Trim();
+            string text = TextBox.Text.Trim();
 
             if (string.IsNullOrWhiteSpace(text))
                 return;
@@ -98,7 +98,7 @@ namespace osu.Game.Online.Chat
             else
                 ChannelManager?.PostMessage(text, target: Channel.Value);
 
-            Textbox.Text = string.Empty;
+            TextBox.Text = string.Empty;
         }
 
         protected virtual ChatLine CreateMessage(Message message) => new StandAloneMessage(message);
@@ -111,7 +111,7 @@ namespace osu.Game.Online.Chat
 
             drawableChannel = CreateDrawableChannel(e.NewValue);
             drawableChannel.CreateChatLineAction = CreateMessage;
-            drawableChannel.Padding = new MarginPadding { Bottom = postingTextbox ? textbox_height : 0 };
+            drawableChannel.Padding = new MarginPadding { Bottom = postingTextBox ? text_box_height : 0 };
 
             AddInternal(drawableChannel);
         }
diff --git a/osu.Game/Online/Rooms/PlaylistItem.cs b/osu.Game/Online/Rooms/PlaylistItem.cs
index b8700fd067..231e214ab9 100644
--- a/osu.Game/Online/Rooms/PlaylistItem.cs
+++ b/osu.Game/Online/Rooms/PlaylistItem.cs
@@ -113,7 +113,7 @@ namespace osu.Game.Online.Rooms
         }
 
         public bool ShouldSerializeID() => false;
-        public bool ShouldSerializeapiBeatmap() => false;
+        public bool ShouldSerializeAPIBeatmap() => false;
 
         public bool Equals(PlaylistItem other)
             => ID == other?.ID
diff --git a/osu.Game/Overlays/AccountCreation/ScreenEntry.cs b/osu.Game/Overlays/AccountCreation/ScreenEntry.cs
index 2ba8fc3ae2..a11b234cb1 100644
--- a/osu.Game/Overlays/AccountCreation/ScreenEntry.cs
+++ b/osu.Game/Overlays/AccountCreation/ScreenEntry.cs
@@ -152,12 +152,12 @@ namespace osu.Game.Overlays.AccountCreation
             loadingLayer.Hide();
 
             if (host?.OnScreenKeyboardOverlapsGameWindow != true)
-                focusNextTextbox();
+                focusNextTextBox();
         }
 
         private void performRegistration()
         {
-            if (focusNextTextbox())
+            if (focusNextTextBox())
             {
                 registerShake.Shake();
                 return;
@@ -209,19 +209,19 @@ namespace osu.Game.Overlays.AccountCreation
             });
         }
 
-        private bool focusNextTextbox()
+        private bool focusNextTextBox()
         {
-            var nextTextbox = nextUnfilledTextbox();
+            var nextTextBox = nextUnfilledTextBox();
 
-            if (nextTextbox != null)
+            if (nextTextBox != null)
             {
-                Schedule(() => GetContainingInputManager().ChangeFocus(nextTextbox));
+                Schedule(() => GetContainingInputManager().ChangeFocus(nextTextBox));
                 return true;
             }
 
             return false;
         }
 
-        private OsuTextBox nextUnfilledTextbox() => textboxes.FirstOrDefault(t => string.IsNullOrEmpty(t.Text));
+        private OsuTextBox nextUnfilledTextBox() => textboxes.FirstOrDefault(t => string.IsNullOrEmpty(t.Text));
     }
 }
diff --git a/osu.Game/Overlays/ChatOverlay.cs b/osu.Game/Overlays/ChatOverlay.cs
index 72473d5750..fde9d28b43 100644
--- a/osu.Game/Overlays/ChatOverlay.cs
+++ b/osu.Game/Overlays/ChatOverlay.cs
@@ -38,7 +38,7 @@ namespace osu.Game.Overlays
         public LocalisableString Title => ChatStrings.HeaderTitle;
         public LocalisableString Description => ChatStrings.HeaderDescription;
 
-        private const float textbox_height = 60;
+        private const float text_box_height = 60;
         private const float channel_selection_min_height = 0.3f;
 
         [Resolved]
@@ -50,7 +50,7 @@ namespace osu.Game.Overlays
 
         private LoadingSpinner loading;
 
-        private FocusedTextBox textbox;
+        private FocusedTextBox textBox;
 
         private const int transition_length = 500;
 
@@ -133,7 +133,7 @@ namespace osu.Game.Overlays
                                             RelativeSizeAxes = Axes.Both,
                                             Padding = new MarginPadding
                                             {
-                                                Bottom = textbox_height
+                                                Bottom = text_box_height
                                             },
                                         },
                                         new Container
@@ -141,7 +141,7 @@ namespace osu.Game.Overlays
                                             Anchor = Anchor.BottomLeft,
                                             Origin = Anchor.BottomLeft,
                                             RelativeSizeAxes = Axes.X,
-                                            Height = textbox_height,
+                                            Height = text_box_height,
                                             Padding = new MarginPadding
                                             {
                                                 Top = padding * 2,
@@ -151,7 +151,7 @@ namespace osu.Game.Overlays
                                             },
                                             Children = new Drawable[]
                                             {
-                                                textbox = new FocusedTextBox
+                                                textBox = new FocusedTextBox
                                                 {
                                                     RelativeSizeAxes = Axes.Both,
                                                     Height = 1,
@@ -197,7 +197,7 @@ namespace osu.Game.Overlays
                 },
             };
 
-            textbox.OnCommit += postMessage;
+            textBox.OnCommit += postMessage;
 
             ChannelTabControl.Current.ValueChanged += current => channelManager.CurrentChannel.Value = current.NewValue;
             ChannelTabControl.ChannelSelectorActive.ValueChanged += active => ChannelSelectionOverlay.State.Value = active.NewValue ? Visibility.Visible : Visibility.Hidden;
@@ -208,12 +208,12 @@ namespace osu.Game.Overlays
 
                 if (state.NewValue == Visibility.Visible)
                 {
-                    textbox.HoldFocus = false;
+                    textBox.HoldFocus = false;
                     if (1f - ChatHeight.Value < channel_selection_min_height)
                         this.TransformBindableTo(ChatHeight, 1f - channel_selection_min_height, 800, Easing.OutQuint);
                 }
                 else
-                    textbox.HoldFocus = true;
+                    textBox.HoldFocus = true;
             };
 
             ChannelSelectionOverlay.OnRequestJoin = channel => channelManager.JoinChannel(channel);
@@ -253,7 +253,7 @@ namespace osu.Game.Overlays
         {
             if (e.NewValue == null)
             {
-                textbox.Current.Disabled = true;
+                textBox.Current.Disabled = true;
                 currentChannelContainer.Clear(false);
                 ChannelSelectionOverlay.Show();
                 return;
@@ -262,7 +262,7 @@ namespace osu.Game.Overlays
             if (e.NewValue is ChannelSelectorTabItem.ChannelSelectorTabChannel)
                 return;
 
-            textbox.Current.Disabled = e.NewValue.ReadOnly;
+            textBox.Current.Disabled = e.NewValue.ReadOnly;
 
             if (ChannelTabControl.Current.Value != e.NewValue)
                 Scheduler.Add(() => ChannelTabControl.Current.Value = e.NewValue);
@@ -402,7 +402,7 @@ namespace osu.Game.Overlays
         protected override void OnFocus(FocusEvent e)
         {
             // this is necessary as textbox is masked away and therefore can't get focus :(
-            textbox.TakeFocus();
+            textBox.TakeFocus();
             base.OnFocus(e);
         }
 
@@ -411,7 +411,7 @@ namespace osu.Game.Overlays
             this.MoveToY(0, transition_length, Easing.OutQuint);
             this.FadeIn(transition_length, Easing.OutQuint);
 
-            textbox.HoldFocus = true;
+            textBox.HoldFocus = true;
 
             base.PopIn();
         }
@@ -423,7 +423,7 @@ namespace osu.Game.Overlays
 
             ChannelSelectionOverlay.Hide();
 
-            textbox.HoldFocus = false;
+            textBox.HoldFocus = false;
             base.PopOut();
         }
 
@@ -481,9 +481,9 @@ namespace osu.Game.Overlays
             }
         }
 
-        private void postMessage(TextBox textbox, bool newText)
+        private void postMessage(TextBox textBox, bool newText)
         {
-            string text = textbox.Text.Trim();
+            string text = textBox.Text.Trim();
 
             if (string.IsNullOrWhiteSpace(text))
                 return;
@@ -493,7 +493,7 @@ namespace osu.Game.Overlays
             else
                 channelManager.PostMessage(text);
 
-            textbox.Text = string.Empty;
+            textBox.Text = string.Empty;
         }
 
         private class TabsArea : Container
diff --git a/osu.Game/Overlays/Profile/Header/Components/PreviousUsernames.cs b/osu.Game/Overlays/Profile/Header/Components/PreviousUsernames.cs
index 229bbaef83..49744e885a 100644
--- a/osu.Game/Overlays/Profile/Header/Components/PreviousUsernames.cs
+++ b/osu.Game/Overlays/Profile/Header/Components/PreviousUsernames.cs
@@ -98,7 +98,7 @@ namespace osu.Game.Overlays.Profile.Header.Components
         [BackgroundDependencyLoader]
         private void load(OsuColour colours)
         {
-            background.Colour = colours.GreySeafoamDarker;
+            background.Colour = colours.GreySeaFoamDarker;
         }
 
         protected override void LoadComplete()
diff --git a/osu.Game/Overlays/Profile/Sections/Historical/PaginatedMostPlayedBeatmapContainer.cs b/osu.Game/Overlays/Profile/Sections/Historical/PaginatedMostPlayedBeatmapContainer.cs
index c943d129cc..ad1192a13a 100644
--- a/osu.Game/Overlays/Profile/Sections/Historical/PaginatedMostPlayedBeatmapContainer.cs
+++ b/osu.Game/Overlays/Profile/Sections/Historical/PaginatedMostPlayedBeatmapContainer.cs
@@ -28,7 +28,7 @@ namespace osu.Game.Overlays.Profile.Sections.Historical
             ItemsContainer.Direction = FillDirection.Vertical;
         }
 
-        protected override int GetCount(APIUser user) => user.BeatmapPlaycountsCount;
+        protected override int GetCount(APIUser user) => user.BeatmapPlayCountsCount;
 
         protected override APIRequest<List<APIUserMostPlayedBeatmap>> CreateRequest() =>
             new GetUserMostPlayedBeatmapsRequest(User.Value.Id, VisiblePages++, ItemsPerPage);
diff --git a/osu.Game/Overlays/Profile/Sections/Historical/PlayHistorySubsection.cs b/osu.Game/Overlays/Profile/Sections/Historical/PlayHistorySubsection.cs
index bca88318d5..51d704a6b0 100644
--- a/osu.Game/Overlays/Profile/Sections/Historical/PlayHistorySubsection.cs
+++ b/osu.Game/Overlays/Profile/Sections/Historical/PlayHistorySubsection.cs
@@ -17,6 +17,6 @@ namespace osu.Game.Overlays.Profile.Sections.Historical
         {
         }
 
-        protected override APIUserHistoryCount[] GetValues(APIUser user) => user?.MonthlyPlaycounts;
+        protected override APIUserHistoryCount[] GetValues(APIUser user) => user?.MonthlyPlayCounts;
     }
 }
diff --git a/osu.Game/Overlays/Profile/Sections/Kudosu/DrawableKudosuHistoryItem.cs b/osu.Game/Overlays/Profile/Sections/Kudosu/DrawableKudosuHistoryItem.cs
index d0cfe9fa54..ce05beffd1 100644
--- a/osu.Game/Overlays/Profile/Sections/Kudosu/DrawableKudosuHistoryItem.cs
+++ b/osu.Game/Overlays/Profile/Sections/Kudosu/DrawableKudosuHistoryItem.cs
@@ -50,7 +50,7 @@ namespace osu.Game.Overlays.Profile.Sections.Kudosu
         [BackgroundDependencyLoader]
         private void load()
         {
-            date.Colour = colours.GreySeafoamLighter;
+            date.Colour = colours.GreySeaFoamLighter;
             var formattedSource = MessageFormatter.FormatText(getString(historyItem));
             linkFlowContainer.AddLinks(formattedSource.Text, formattedSource.Links);
         }
diff --git a/osu.Game/Overlays/Settings/Sections/Maintenance/DirectorySelectScreen.cs b/osu.Game/Overlays/Settings/Sections/Maintenance/DirectorySelectScreen.cs
index 0814e3c824..98bc8d88be 100644
--- a/osu.Game/Overlays/Settings/Sections/Maintenance/DirectorySelectScreen.cs
+++ b/osu.Game/Overlays/Settings/Sections/Maintenance/DirectorySelectScreen.cs
@@ -63,7 +63,7 @@ namespace osu.Game.Overlays.Settings.Sections.Maintenance
                     new Box
                     {
                         RelativeSizeAxes = Axes.Both,
-                        Colour = colours.GreySeafoamDark
+                        Colour = colours.GreySeaFoamDark
                     },
                     new GridContainer
                     {
diff --git a/osu.Game/Rulesets/Mods/ModBlockFail.cs b/osu.Game/Rulesets/Mods/ModBlockFail.cs
index 1fde5abad4..8a9b0cddc8 100644
--- a/osu.Game/Rulesets/Mods/ModBlockFail.cs
+++ b/osu.Game/Rulesets/Mods/ModBlockFail.cs
@@ -25,7 +25,7 @@ namespace osu.Game.Rulesets.Mods
 
         public void ApplyToHUD(HUDOverlay overlay)
         {
-            overlay.ShowHealthbar.BindTo(showHealthBar);
+            overlay.ShowHealthBar.BindTo(showHealthBar);
         }
     }
 }
diff --git a/osu.Game/Rulesets/Mods/ModDoubleTime.cs b/osu.Game/Rulesets/Mods/ModDoubleTime.cs
index d12f48e973..d4c4dce0f5 100644
--- a/osu.Game/Rulesets/Mods/ModDoubleTime.cs
+++ b/osu.Game/Rulesets/Mods/ModDoubleTime.cs
@@ -14,7 +14,7 @@ namespace osu.Game.Rulesets.Mods
     {
         public override string Name => "Double Time";
         public override string Acronym => "DT";
-        public override IconUsage? Icon => OsuIcon.ModDoubletime;
+        public override IconUsage? Icon => OsuIcon.ModDoubleTime;
         public override ModType Type => ModType.DifficultyIncrease;
         public override string Description => "Zoooooooooom...";
 
diff --git a/osu.Game/Rulesets/Mods/ModHardRock.cs b/osu.Game/Rulesets/Mods/ModHardRock.cs
index da838f9ea6..0a5348a8cf 100644
--- a/osu.Game/Rulesets/Mods/ModHardRock.cs
+++ b/osu.Game/Rulesets/Mods/ModHardRock.cs
@@ -12,7 +12,7 @@ namespace osu.Game.Rulesets.Mods
     {
         public override string Name => "Hard Rock";
         public override string Acronym => "HR";
-        public override IconUsage? Icon => OsuIcon.ModHardrock;
+        public override IconUsage? Icon => OsuIcon.ModHardRock;
         public override ModType Type => ModType.DifficultyIncrease;
         public override string Description => "Everything just got a bit harder...";
         public override Type[] IncompatibleMods => new[] { typeof(ModEasy), typeof(ModDifficultyAdjust) };
diff --git a/osu.Game/Rulesets/Mods/ModNoFail.cs b/osu.Game/Rulesets/Mods/ModNoFail.cs
index abf67c2e2d..5ebae17228 100644
--- a/osu.Game/Rulesets/Mods/ModNoFail.cs
+++ b/osu.Game/Rulesets/Mods/ModNoFail.cs
@@ -11,7 +11,7 @@ namespace osu.Game.Rulesets.Mods
     {
         public override string Name => "No Fail";
         public override string Acronym => "NF";
-        public override IconUsage? Icon => OsuIcon.ModNofail;
+        public override IconUsage? Icon => OsuIcon.ModNoFail;
         public override ModType Type => ModType.DifficultyReduction;
         public override string Description => "You can't fail, no matter what.";
         public override double ScoreMultiplier => 0.5;
diff --git a/osu.Game/Rulesets/Mods/ModSuddenDeath.cs b/osu.Game/Rulesets/Mods/ModSuddenDeath.cs
index 1abd353d20..c8b835f78a 100644
--- a/osu.Game/Rulesets/Mods/ModSuddenDeath.cs
+++ b/osu.Game/Rulesets/Mods/ModSuddenDeath.cs
@@ -14,7 +14,7 @@ namespace osu.Game.Rulesets.Mods
     {
         public override string Name => "Sudden Death";
         public override string Acronym => "SD";
-        public override IconUsage? Icon => OsuIcon.ModSuddendeath;
+        public override IconUsage? Icon => OsuIcon.ModSuddenDeath;
         public override ModType Type => ModType.DifficultyIncrease;
         public override string Description => "Miss and fail.";
         public override double ScoreMultiplier => 1;
diff --git a/osu.Game/Rulesets/Objects/Legacy/ConvertHitObjectParser.cs b/osu.Game/Rulesets/Objects/Legacy/ConvertHitObjectParser.cs
index cf19d64080..b091803406 100644
--- a/osu.Game/Rulesets/Objects/Legacy/ConvertHitObjectParser.cs
+++ b/osu.Game/Rulesets/Objects/Legacy/ConvertHitObjectParser.cs
@@ -188,12 +188,12 @@ namespace osu.Game.Rulesets.Objects.Legacy
             string[] split = str.Split(':');
 
             var bank = (LegacySampleBank)Parsing.ParseInt(split[0]);
-            var addbank = (LegacySampleBank)Parsing.ParseInt(split[1]);
+            var addBank = (LegacySampleBank)Parsing.ParseInt(split[1]);
 
             string stringBank = bank.ToString().ToLowerInvariant();
             if (stringBank == @"none")
                 stringBank = null;
-            string stringAddBank = addbank.ToString().ToLowerInvariant();
+            string stringAddBank = addBank.ToString().ToLowerInvariant();
             if (stringAddBank == @"none")
                 stringAddBank = null;
 
diff --git a/osu.Game/Rulesets/Objects/SliderPath.cs b/osu.Game/Rulesets/Objects/SliderPath.cs
index 0dec0655b9..e0c62fe359 100644
--- a/osu.Game/Rulesets/Objects/SliderPath.cs
+++ b/osu.Game/Rulesets/Objects/SliderPath.cs
@@ -250,13 +250,13 @@ namespace osu.Game.Rulesets.Objects
                     if (subControlPoints.Length != 3)
                         break;
 
-                    List<Vector2> subpath = PathApproximator.ApproximateCircularArc(subControlPoints);
+                    List<Vector2> subPath = PathApproximator.ApproximateCircularArc(subControlPoints);
 
                     // If for some reason a circular arc could not be fit to the 3 given points, fall back to a numerically stable bezier approximation.
-                    if (subpath.Count == 0)
+                    if (subPath.Count == 0)
                         break;
 
-                    return subpath;
+                    return subPath;
 
                 case PathType.Catmull:
                     return PathApproximator.ApproximateCatmull(subControlPoints);
diff --git a/osu.Game/Screens/Edit/Setup/SetupScreenHeaderBackground.cs b/osu.Game/Screens/Edit/Setup/SetupScreenHeaderBackground.cs
index 7304323004..17fb97d41f 100644
--- a/osu.Game/Screens/Edit/Setup/SetupScreenHeaderBackground.cs
+++ b/osu.Game/Screens/Edit/Setup/SetupScreenHeaderBackground.cs
@@ -56,7 +56,7 @@ namespace osu.Game.Screens.Edit.Setup
                     {
                         new Box
                         {
-                            Colour = colours.GreySeafoamDarker,
+                            Colour = colours.GreySeaFoamDarker,
                             RelativeSizeAxes = Axes.Both,
                         },
                         new OsuTextFlowContainer(t => t.Font = OsuFont.Default.With(size: 24))
diff --git a/osu.Game/Screens/Edit/Timing/IndeterminateSliderWithTextBoxInput.cs b/osu.Game/Screens/Edit/Timing/IndeterminateSliderWithTextBoxInput.cs
index 14b8c4c9de..e25d83cfb0 100644
--- a/osu.Game/Screens/Edit/Timing/IndeterminateSliderWithTextBoxInput.cs
+++ b/osu.Game/Screens/Edit/Timing/IndeterminateSliderWithTextBoxInput.cs
@@ -41,7 +41,7 @@ namespace osu.Game.Screens.Edit.Timing
         }
 
         private readonly SettingsSlider<T> slider;
-        private readonly LabelledTextBox textbox;
+        private readonly LabelledTextBox textBox;
 
         /// <summary>
         /// Creates an <see cref="IndeterminateSliderWithTextBoxInput{T}"/>.
@@ -66,7 +66,7 @@ namespace osu.Game.Screens.Edit.Timing
                     Spacing = new Vector2(0, 5),
                     Children = new Drawable[]
                     {
-                        textbox = new LabelledTextBox
+                        textBox = new LabelledTextBox
                         {
                             Label = labelText,
                         },
@@ -80,7 +80,7 @@ namespace osu.Game.Screens.Edit.Timing
                 },
             };
 
-            textbox.OnCommit += (t, isNew) =>
+            textBox.OnCommit += (t, isNew) =>
             {
                 if (!isNew) return;
 
@@ -110,13 +110,13 @@ namespace osu.Game.Screens.Edit.Timing
 
                 // 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);
-                textbox.Text = decimalValue.ToString($@"N{FormatUtils.FindPrecision(decimalValue)}");
-                textbox.PlaceholderText = string.Empty;
+                textBox.Text = decimalValue.ToString($@"N{FormatUtils.FindPrecision(decimalValue)}");
+                textBox.PlaceholderText = string.Empty;
             }
             else
             {
-                textbox.Text = null;
-                textbox.PlaceholderText = "(multiple)";
+                textBox.Text = null;
+                textBox.PlaceholderText = "(multiple)";
             }
         }
     }
diff --git a/osu.Game/Screens/Edit/Timing/SliderWithTextBoxInput.cs b/osu.Game/Screens/Edit/Timing/SliderWithTextBoxInput.cs
index 6c004a7c8b..8738d36bf4 100644
--- a/osu.Game/Screens/Edit/Timing/SliderWithTextBoxInput.cs
+++ b/osu.Game/Screens/Edit/Timing/SliderWithTextBoxInput.cs
@@ -19,7 +19,7 @@ namespace osu.Game.Screens.Edit.Timing
 
         public SliderWithTextBoxInput(LocalisableString labelText)
         {
-            LabelledTextBox textbox;
+            LabelledTextBox textBox;
 
             RelativeSizeAxes = Axes.X;
             AutoSizeAxes = Axes.Y;
@@ -33,7 +33,7 @@ namespace osu.Game.Screens.Edit.Timing
                     Direction = FillDirection.Vertical,
                     Children = new Drawable[]
                     {
-                        textbox = new LabelledTextBox
+                        textBox = new LabelledTextBox
                         {
                             Label = labelText,
                         },
@@ -46,7 +46,7 @@ namespace osu.Game.Screens.Edit.Timing
                 },
             };
 
-            textbox.OnCommit += (t, isNew) =>
+            textBox.OnCommit += (t, isNew) =>
             {
                 if (!isNew) return;
 
@@ -66,7 +66,7 @@ namespace osu.Game.Screens.Edit.Timing
 
             Current.BindValueChanged(val =>
             {
-                textbox.Text = val.NewValue.ToString();
+                textBox.Text = val.NewValue.ToString();
             }, true);
         }
 
diff --git a/osu.Game/Screens/Import/FileImportScreen.cs b/osu.Game/Screens/Import/FileImportScreen.cs
index 7e1d55b3e2..c32e230e11 100644
--- a/osu.Game/Screens/Import/FileImportScreen.cs
+++ b/osu.Game/Screens/Import/FileImportScreen.cs
@@ -54,7 +54,7 @@ namespace osu.Game.Screens.Import
                 {
                     new Box
                     {
-                        Colour = colours.GreySeafoamDark,
+                        Colour = colours.GreySeaFoamDark,
                         RelativeSizeAxes = Axes.Both,
                     },
                     fileSelector = new OsuFileSelector(validFileExtensions: game.HandledExtensions.ToArray())
@@ -72,7 +72,7 @@ namespace osu.Game.Screens.Import
                         {
                             new Box
                             {
-                                Colour = colours.GreySeafoamDarker,
+                                Colour = colours.GreySeaFoamDarker,
                                 RelativeSizeAxes = Axes.Both
                             },
                             new Container
diff --git a/osu.Game/Screens/OnlinePlay/Lounge/DrawableLoungeRoom.cs b/osu.Game/Screens/OnlinePlay/Lounge/DrawableLoungeRoom.cs
index 0d2b2249ef..3fd56ece58 100644
--- a/osu.Game/Screens/OnlinePlay/Lounge/DrawableLoungeRoom.cs
+++ b/osu.Game/Screens/OnlinePlay/Lounge/DrawableLoungeRoom.cs
@@ -193,7 +193,7 @@ namespace osu.Game.Screens.OnlinePlay.Lounge
                 this.room = room;
             }
 
-            private OsuPasswordTextBox passwordTextbox;
+            private OsuPasswordTextBox passwordTextBox;
             private TriangleButton joinButton;
             private OsuSpriteText errorText;
             private Sample sampleJoinFail;
@@ -218,7 +218,7 @@ namespace osu.Game.Screens.OnlinePlay.Lounge
                             AutoSizeAxes = Axes.Both,
                             Children = new Drawable[]
                             {
-                                passwordTextbox = new OsuPasswordTextBox
+                                passwordTextBox = new OsuPasswordTextBox
                                 {
                                     Width = 200,
                                     PlaceholderText = "password",
@@ -246,21 +246,21 @@ namespace osu.Game.Screens.OnlinePlay.Lounge
             {
                 base.LoadComplete();
 
-                Schedule(() => GetContainingInputManager().ChangeFocus(passwordTextbox));
-                passwordTextbox.OnCommit += (_, __) => performJoin();
+                Schedule(() => GetContainingInputManager().ChangeFocus(passwordTextBox));
+                passwordTextBox.OnCommit += (_, __) => performJoin();
             }
 
             private void performJoin()
             {
-                lounge?.Join(room, passwordTextbox.Text, null, joinFailed);
-                GetContainingInputManager().TriggerFocusContention(passwordTextbox);
+                lounge?.Join(room, passwordTextBox.Text, null, joinFailed);
+                GetContainingInputManager().TriggerFocusContention(passwordTextBox);
             }
 
             private void joinFailed(string error) => Schedule(() =>
             {
-                passwordTextbox.Text = string.Empty;
+                passwordTextBox.Text = string.Empty;
 
-                GetContainingInputManager().ChangeFocus(passwordTextbox);
+                GetContainingInputManager().ChangeFocus(passwordTextBox);
 
                 errorText.Text = error;
                 errorText
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/GameplayChatDisplay.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/GameplayChatDisplay.cs
index 0e73f65f8b..53fd111c27 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/GameplayChatDisplay.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/GameplayChatDisplay.cs
@@ -24,7 +24,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
 
         public Bindable<bool> Expanded = new Bindable<bool>();
 
-        private readonly Bindable<bool> expandedFromTextboxFocus = new Bindable<bool>();
+        private readonly Bindable<bool> expandedFromTextBoxFocus = new Bindable<bool>();
 
         private const float height = 100;
 
@@ -37,7 +37,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
 
             Background.Alpha = 0.2f;
 
-            Textbox.FocusLost = () => expandedFromTextboxFocus.Value = false;
+            TextBox.FocusLost = () => expandedFromTextBoxFocus.Value = false;
         }
 
         protected override bool OnHover(HoverEvent e) => true; // use UI mouse cursor.
@@ -51,14 +51,14 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
             {
                 // for now let's never hold focus. this avoid misdirected gameplay keys entering chat.
                 // note that this is done within this callback as it triggers an un-focus as well.
-                Textbox.HoldFocus = false;
+                TextBox.HoldFocus = false;
 
                 // only hold focus (after sending a message) during breaks
-                Textbox.ReleaseFocusOnCommit = playing.NewValue;
+                TextBox.ReleaseFocusOnCommit = playing.NewValue;
             }, true);
 
             Expanded.BindValueChanged(_ => updateExpandedState(), true);
-            expandedFromTextboxFocus.BindValueChanged(focus =>
+            expandedFromTextBoxFocus.BindValueChanged(focus =>
             {
                 if (focus.NewValue)
                     updateExpandedState();
@@ -76,25 +76,25 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
             switch (e.Action)
             {
                 case GlobalAction.Back:
-                    if (Textbox.HasFocus)
+                    if (TextBox.HasFocus)
                     {
-                        Schedule(() => Textbox.KillFocus());
+                        Schedule(() => TextBox.KillFocus());
                         return true;
                     }
 
                     break;
 
                 case GlobalAction.ToggleChatFocus:
-                    if (Textbox.HasFocus)
+                    if (TextBox.HasFocus)
                     {
-                        Schedule(() => Textbox.KillFocus());
+                        Schedule(() => TextBox.KillFocus());
                     }
                     else
                     {
-                        expandedFromTextboxFocus.Value = true;
+                        expandedFromTextBoxFocus.Value = true;
 
                         // schedule required to ensure the textbox has become present from above bindable update.
-                        Schedule(() => Textbox.TakeFocus());
+                        Schedule(() => TextBox.TakeFocus());
                     }
 
                     return true;
@@ -109,7 +109,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
 
         private void updateExpandedState()
         {
-            if (Expanded.Value || expandedFromTextboxFocus.Value)
+            if (Expanded.Value || expandedFromTextBoxFocus.Value)
             {
                 this.FadeIn(300, Easing.OutQuint);
                 this.ResizeHeightTo(height, 500, Easing.OutQuint);
diff --git a/osu.Game/Screens/Play/HUD/HealthDisplay.cs b/osu.Game/Screens/Play/HUD/HealthDisplay.cs
index 1f0fafa636..94f1b99b37 100644
--- a/osu.Game/Screens/Play/HUD/HealthDisplay.cs
+++ b/osu.Game/Screens/Play/HUD/HealthDisplay.cs
@@ -17,7 +17,7 @@ namespace osu.Game.Screens.Play.HUD
     /// </summary>
     public abstract class HealthDisplay : CompositeDrawable
     {
-        private readonly Bindable<bool> showHealthbar = new Bindable<bool>(true);
+        private readonly Bindable<bool> showHealthBar = new Bindable<bool>(true);
 
         [Resolved]
         protected HealthProcessor HealthProcessor { get; private set; }
@@ -43,10 +43,10 @@ namespace osu.Game.Screens.Play.HUD
             HealthProcessor.NewJudgement += onNewJudgement;
 
             if (hudOverlay != null)
-                showHealthbar.BindTo(hudOverlay.ShowHealthbar);
+                showHealthBar.BindTo(hudOverlay.ShowHealthBar);
 
             // this probably shouldn't be operating on `this.`
-            showHealthbar.BindValueChanged(healthBar => this.FadeTo(healthBar.NewValue ? 1 : 0, HUDOverlay.FADE_DURATION, HUDOverlay.FADE_EASING), true);
+            showHealthBar.BindValueChanged(healthBar => this.FadeTo(healthBar.NewValue ? 1 : 0, HUDOverlay.FADE_DURATION, HUDOverlay.FADE_EASING), true);
         }
 
         private void onNewJudgement(JudgementResult judgement)
diff --git a/osu.Game/Screens/Play/HUDOverlay.cs b/osu.Game/Screens/Play/HUDOverlay.cs
index b5c4433719..fdb5d418f3 100644
--- a/osu.Game/Screens/Play/HUDOverlay.cs
+++ b/osu.Game/Screens/Play/HUDOverlay.cs
@@ -46,7 +46,7 @@ namespace osu.Game.Screens.Play
         public readonly HoldForMenuButton HoldToQuit;
         public readonly PlayerSettingsOverlay PlayerSettingsOverlay;
 
-        public Bindable<bool> ShowHealthbar = new Bindable<bool>(true);
+        public Bindable<bool> ShowHealthBar = new Bindable<bool>(true);
 
         private readonly DrawableRuleset drawableRuleset;
         private readonly IReadOnlyList<Mod> mods;
@@ -258,7 +258,7 @@ namespace osu.Game.Screens.Play
 
         protected FailingLayer CreateFailingLayer() => new FailingLayer
         {
-            ShowHealth = { BindTarget = ShowHealthbar }
+            ShowHealth = { BindTarget = ShowHealthBar }
         };
 
         protected KeyCounterDisplay CreateKeyCounter() => new KeyCounterDisplay
diff --git a/osu.Game/Screens/Play/PlayerSettings/PlayerSliderBar.cs b/osu.Game/Screens/Play/PlayerSettings/PlayerSliderBar.cs
index 9903a74043..57ffe16f76 100644
--- a/osu.Game/Screens/Play/PlayerSettings/PlayerSliderBar.cs
+++ b/osu.Game/Screens/Play/PlayerSettings/PlayerSliderBar.cs
@@ -15,12 +15,12 @@ namespace osu.Game.Screens.Play.PlayerSettings
     {
         public OsuSliderBar<T> Bar => (OsuSliderBar<T>)Control;
 
-        protected override Drawable CreateControl() => new Sliderbar
+        protected override Drawable CreateControl() => new SliderBar
         {
             RelativeSizeAxes = Axes.X
         };
 
-        private class Sliderbar : OsuSliderBar<T>
+        private class SliderBar : OsuSliderBar<T>
         {
             [BackgroundDependencyLoader]
             private void load(OsuColour colours)

From 5082b0e63f6adda82640d7be7ac944b00541e26d Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Thu, 9 Dec 2021 21:15:38 -0800
Subject: [PATCH 1865/5547] Fix some identifiers using shortened naming

---
 .../Screens/Ladder/Components/DrawableTournamentMatch.cs      | 4 ++--
 osu.Game/IO/Legacy/SerializationReader.cs                     | 4 ++--
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Tournament/Screens/Ladder/Components/DrawableTournamentMatch.cs b/osu.Game.Tournament/Screens/Ladder/Components/DrawableTournamentMatch.cs
index 3e950310cf..5729e779c4 100644
--- a/osu.Game.Tournament/Screens/Ladder/Components/DrawableTournamentMatch.cs
+++ b/osu.Game.Tournament/Screens/Ladder/Components/DrawableTournamentMatch.cs
@@ -208,10 +208,10 @@ namespace osu.Game.Tournament.Screens.Ladder.Components
         {
             if (Match.Round.Value == null) return;
 
-            int instaWinAmount = Match.Round.Value.BestOf.Value / 2;
+            int instantWinAmount = Match.Round.Value.BestOf.Value / 2;
 
             Match.Completed.Value = Match.Round.Value.BestOf.Value > 0
-                                    && (Match.Team1Score.Value + Match.Team2Score.Value >= Match.Round.Value.BestOf.Value || Match.Team1Score.Value > instaWinAmount || Match.Team2Score.Value > instaWinAmount);
+                                    && (Match.Team1Score.Value + Match.Team2Score.Value >= Match.Round.Value.BestOf.Value || Match.Team1Score.Value > instantWinAmount || Match.Team2Score.Value > instantWinAmount);
         }
 
         protected override void LoadComplete()
diff --git a/osu.Game/IO/Legacy/SerializationReader.cs b/osu.Game/IO/Legacy/SerializationReader.cs
index 00f90f78e3..f7b3f33e87 100644
--- a/osu.Game/IO/Legacy/SerializationReader.cs
+++ b/osu.Game/IO/Legacy/SerializationReader.cs
@@ -235,9 +235,9 @@ namespace osu.Game.IO.Legacy
 
                     if (typeName.Contains("System.Collections.Generic") && typeName.Contains("[["))
                     {
-                        string[] splitTyps = typeName.Split('[');
+                        string[] splitTypes = typeName.Split('[');
 
-                        foreach (string typ in splitTyps)
+                        foreach (string typ in splitTypes)
                         {
                             if (typ.Contains("Version"))
                             {

From 0bd928b5cdf66f20bc8abee69aad7df65a851098 Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Mon, 27 Dec 2021 21:44:19 -0800
Subject: [PATCH 1866/5547] Fix incorrect naming / apply review

---
 .../Skinning/Default/DefaultHitExplosion.cs                 | 6 +++---
 osu.Game.Rulesets.Mania/UI/DefaultHitExplosion.cs           | 6 +++---
 osu.Game/Online/API/Requests/Responses/APIUser.cs           | 2 +-
 3 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/osu.Game.Rulesets.Catch/Skinning/Default/DefaultHitExplosion.cs b/osu.Game.Rulesets.Catch/Skinning/Default/DefaultHitExplosion.cs
index 905eb059e3..f6b3c3d665 100644
--- a/osu.Game.Rulesets.Catch/Skinning/Default/DefaultHitExplosion.cs
+++ b/osu.Game.Rulesets.Catch/Skinning/Default/DefaultHitExplosion.cs
@@ -90,9 +90,9 @@ namespace osu.Game.Rulesets.Catch.Skinning.Default
                 .ResizeTo(largeFaint.Size * new Vector2(5, 1), duration, Easing.OutQuint)
                 .FadeOut(duration * 2);
 
-            const float angle_variable = 15; // should be less than 45
-            directionalGlow1.Rotation = StatelessRNG.NextSingle(-angle_variable, angle_variable, randomSeed, 4);
-            directionalGlow2.Rotation = StatelessRNG.NextSingle(-angle_variable, angle_variable, randomSeed, 5);
+            const float angle_variance = 15; // should be less than 45
+            directionalGlow1.Rotation = StatelessRNG.NextSingle(-angle_variance, angle_variance, randomSeed, 4);
+            directionalGlow2.Rotation = StatelessRNG.NextSingle(-angle_variance, angle_variance, randomSeed, 5);
 
             this.FadeInFromZero(50).Then().FadeOut(duration, Easing.Out);
         }
diff --git a/osu.Game.Rulesets.Mania/UI/DefaultHitExplosion.cs b/osu.Game.Rulesets.Mania/UI/DefaultHitExplosion.cs
index 99dcce2da4..562d7b04c4 100644
--- a/osu.Game.Rulesets.Mania/UI/DefaultHitExplosion.cs
+++ b/osu.Game.Rulesets.Mania/UI/DefaultHitExplosion.cs
@@ -42,7 +42,7 @@ namespace osu.Game.Rulesets.Mania.UI
         [BackgroundDependencyLoader]
         private void load(IScrollingInfo scrollingInfo)
         {
-            const float angle_variable = 15; // should be less than 45
+            const float angle_variance = 15; // should be less than 45
             const float roundness = 80;
             const float initial_height = 10;
 
@@ -90,7 +90,7 @@ namespace osu.Game.Rulesets.Mania.UI
                     Masking = true,
                     Size = new Vector2(0.01f, initial_height),
                     Blending = BlendingParameters.Additive,
-                    Rotation = RNG.NextSingle(-angle_variable, angle_variable),
+                    Rotation = RNG.NextSingle(-angle_variance, angle_variance),
                     EdgeEffect = new EdgeEffectParameters
                     {
                         Type = EdgeEffectType.Glow,
@@ -107,7 +107,7 @@ namespace osu.Game.Rulesets.Mania.UI
                     Masking = true,
                     Size = new Vector2(0.01f, initial_height),
                     Blending = BlendingParameters.Additive,
-                    Rotation = RNG.NextSingle(-angle_variable, angle_variable),
+                    Rotation = RNG.NextSingle(-angle_variance, angle_variance),
                     EdgeEffect = new EdgeEffectParameters
                     {
                         Type = EdgeEffectType.Glow,
diff --git a/osu.Game/Online/API/Requests/Responses/APIUser.cs b/osu.Game/Online/API/Requests/Responses/APIUser.cs
index ed40e9b498..e4a432b074 100644
--- a/osu.Game/Online/API/Requests/Responses/APIUser.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIUser.cs
@@ -154,7 +154,7 @@ namespace osu.Game.Online.API.Requests.Responses
         [JsonProperty(@"beatmap_playcounts_count")]
         public int BeatmapPlayCountsCount;
 
-        [JsonProperty]
+        [JsonProperty(@"playstyle")]
         private string[] playStyle
         {
             set => PlayStyles = value?.Select(str => Enum.Parse(typeof(APIPlayStyle), str, true)).Cast<APIPlayStyle>().ToArray();

From bc39c2a877500e744051c41c3f93432815453250 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 28 Dec 2021 08:31:27 +0100
Subject: [PATCH 1867/5547] Revert incorrect property rename

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

diff --git a/osu.Game/Online/Rooms/PlaylistItem.cs b/osu.Game/Online/Rooms/PlaylistItem.cs
index 231e214ab9..b8700fd067 100644
--- a/osu.Game/Online/Rooms/PlaylistItem.cs
+++ b/osu.Game/Online/Rooms/PlaylistItem.cs
@@ -113,7 +113,7 @@ namespace osu.Game.Online.Rooms
         }
 
         public bool ShouldSerializeID() => false;
-        public bool ShouldSerializeAPIBeatmap() => false;
+        public bool ShouldSerializeapiBeatmap() => false;
 
         public bool Equals(PlaylistItem other)
             => ID == other?.ID

From 63e0492725db617ec50dfbf5baa6428715bb3621 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 28 Dec 2021 08:37:16 +0100
Subject: [PATCH 1868/5547] Mark `ShouldSerialize()` methods as implicitly used

---
 .../Difficulty/OsuDifficultyAttributes.cs          |  9 ++++++++-
 osu.Game/Online/Rooms/PlaylistItem.cs              | 13 +++++++++++++
 osu.Game/Online/Rooms/Room.cs                      | 14 ++++++++++++++
 3 files changed, 35 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyAttributes.cs b/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyAttributes.cs
index 128ff772fd..126a9b0183 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyAttributes.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyAttributes.cs
@@ -70,8 +70,15 @@ namespace osu.Game.Rulesets.Osu.Difficulty
             SliderFactor = values[ATTRIB_ID_SLIDER_FACTOR];
         }
 
-        // Used implicitly by Newtonsoft.Json to not serialize flashlight property in some cases.
+        #region Newtonsoft.Json implicit ShouldSerialize() methods
+
+        // The properties in this region are used implicitly by Newtonsoft.Json to not serialise certain fields in some cases.
+        // They rely on being named exactly the same as the corresponding fields (casing included) and as such should NOT be renamed
+        // unless the fields are also renamed.
+
         [UsedImplicitly]
         public bool ShouldSerializeFlashlightRating() => Mods.Any(m => m is ModFlashlight);
+
+        #endregion
     }
 }
diff --git a/osu.Game/Online/Rooms/PlaylistItem.cs b/osu.Game/Online/Rooms/PlaylistItem.cs
index b8700fd067..83a70c405b 100644
--- a/osu.Game/Online/Rooms/PlaylistItem.cs
+++ b/osu.Game/Online/Rooms/PlaylistItem.cs
@@ -4,6 +4,7 @@
 using System;
 using System.Diagnostics;
 using System.Linq;
+using JetBrains.Annotations;
 using Newtonsoft.Json;
 using osu.Framework.Bindables;
 using osu.Game.Beatmaps;
@@ -112,9 +113,21 @@ namespace osu.Game.Online.Rooms
             }
         }
 
+        #region Newtonsoft.Json implicit ShouldSerialize() methods
+
+        // The properties in this region are used implicitly by Newtonsoft.Json to not serialise certain fields in some cases.
+        // They rely on being named exactly the same as the corresponding fields (casing included) and as such should NOT be renamed
+        // unless the fields are also renamed.
+
+        [UsedImplicitly]
         public bool ShouldSerializeID() => false;
+
+        // ReSharper disable once IdentifierTypo
+        [UsedImplicitly]
         public bool ShouldSerializeapiBeatmap() => false;
 
+        #endregion
+
         public bool Equals(PlaylistItem other)
             => ID == other?.ID
                && BeatmapID == other.BeatmapID
diff --git a/osu.Game/Online/Rooms/Room.cs b/osu.Game/Online/Rooms/Room.cs
index c87411c3c0..bbe854f2dd 100644
--- a/osu.Game/Online/Rooms/Room.cs
+++ b/osu.Game/Online/Rooms/Room.cs
@@ -3,6 +3,7 @@
 
 using System;
 using System.Linq;
+using JetBrains.Annotations;
 using Newtonsoft.Json;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
@@ -211,8 +212,21 @@ namespace osu.Game.Online.Rooms
                 Playlist.RemoveAll(i => i.Expired);
         }
 
+        #region Newtonsoft.Json implicit ShouldSerialize() methods
+
+        // The properties in this region are used implicitly by Newtonsoft.Json to not serialise certain fields in some cases.
+        // They rely on being named exactly the same as the corresponding fields (casing included) and as such should NOT be renamed
+        // unless the fields are also renamed.
+
+        [UsedImplicitly]
         public bool ShouldSerializeRoomID() => false;
+
+        [UsedImplicitly]
         public bool ShouldSerializeHost() => false;
+
+        [UsedImplicitly]
         public bool ShouldSerializeEndDate() => false;
+
+        #endregion
     }
 }

From d62930500298d23419b2f37b0376881f0e6bb573 Mon Sep 17 00:00:00 2001
From: pikokr <parangee9706@gmail.com>
Date: Tue, 28 Dec 2021 21:47:58 +0900
Subject: [PATCH 1869/5547] Remove `Cached` attribute from
 `DrawableRuleset.KeyBindingInputManager`

---
 osu.Game/Rulesets/UI/DrawableRuleset.cs | 1 -
 1 file changed, 1 deletion(-)

diff --git a/osu.Game/Rulesets/UI/DrawableRuleset.cs b/osu.Game/Rulesets/UI/DrawableRuleset.cs
index 30012784a3..29559f5036 100644
--- a/osu.Game/Rulesets/UI/DrawableRuleset.cs
+++ b/osu.Game/Rulesets/UI/DrawableRuleset.cs
@@ -50,7 +50,6 @@ namespace osu.Game.Rulesets.UI
         /// <summary>
         /// The key conversion input manager for this DrawableRuleset.
         /// </summary>
-        [Cached]
         public PassThroughInputManager KeyBindingInputManager;
 
         public override double GameplayStartTime => Objects.FirstOrDefault()?.StartTime - 2000 ?? 0;

From 59b4aea5f9dc22a3cf543bddae589e462a8be383 Mon Sep 17 00:00:00 2001
From: pikokr <parangee9706@gmail.com>
Date: Tue, 28 Dec 2021 21:52:46 +0900
Subject: [PATCH 1870/5547] Make method and property name to match class name

---
 osu.Game.Rulesets.Mania/UI/Column.cs | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/osu.Game.Rulesets.Mania/UI/Column.cs b/osu.Game.Rulesets.Mania/UI/Column.cs
index 6be36619c7..36473aa900 100644
--- a/osu.Game.Rulesets.Mania/UI/Column.cs
+++ b/osu.Game.Rulesets.Mania/UI/Column.cs
@@ -136,22 +136,22 @@ namespace osu.Game.Rulesets.Mania.UI
         {
         }
 
-        private ManiaInputManager.RulesetKeyBindingContainer keyBindingContainer { get; set; }
+        private ManiaInputManager.RulesetKeyBindingContainer rulesetKeyBindingContainer { get; set; }
 
-        private ManiaInputManager.RulesetKeyBindingContainer getKeyBindingManager()
+        private ManiaInputManager.RulesetKeyBindingContainer getRulesetKeyBindingContainer()
         {
-            return keyBindingContainer ??= ((ManiaInputManager)GetContainingInputManager()).GetKeyBindingContainer();
+            return rulesetKeyBindingContainer ??= ((ManiaInputManager)GetContainingInputManager()).GetKeyBindingContainer();
         }
 
         protected override bool OnTouchDown(TouchDownEvent e)
         {
-            getKeyBindingManager().TriggerPressed(Action.Value);
+            getRulesetKeyBindingContainer().TriggerPressed(Action.Value);
             return base.OnTouchDown(e);
         }
 
         protected override void OnTouchUp(TouchUpEvent e)
         {
-            getKeyBindingManager().TriggerReleased(Action.Value);
+            getRulesetKeyBindingContainer().TriggerReleased(Action.Value);
         }
 
         public override bool ReceivePositionalInputAt(Vector2 screenSpacePos)

From 62d6bb8c2e9c8a6e10a318599a7ad04974d55e76 Mon Sep 17 00:00:00 2001
From: pikokr <parangee9706@gmail.com>
Date: Tue, 28 Dec 2021 22:35:45 +0900
Subject: [PATCH 1871/5547] Trigger touch on click key area

---
 osu.Game.Rulesets.Mania/UI/Column.cs          | 18 -------------
 .../UI/Components/DefaultKeyArea.cs           | 25 +++++++++++++++++--
 2 files changed, 23 insertions(+), 20 deletions(-)

diff --git a/osu.Game.Rulesets.Mania/UI/Column.cs b/osu.Game.Rulesets.Mania/UI/Column.cs
index 36473aa900..9d060944cd 100644
--- a/osu.Game.Rulesets.Mania/UI/Column.cs
+++ b/osu.Game.Rulesets.Mania/UI/Column.cs
@@ -136,24 +136,6 @@ namespace osu.Game.Rulesets.Mania.UI
         {
         }
 
-        private ManiaInputManager.RulesetKeyBindingContainer rulesetKeyBindingContainer { get; set; }
-
-        private ManiaInputManager.RulesetKeyBindingContainer getRulesetKeyBindingContainer()
-        {
-            return rulesetKeyBindingContainer ??= ((ManiaInputManager)GetContainingInputManager()).GetKeyBindingContainer();
-        }
-
-        protected override bool OnTouchDown(TouchDownEvent e)
-        {
-            getRulesetKeyBindingContainer().TriggerPressed(Action.Value);
-            return base.OnTouchDown(e);
-        }
-
-        protected override void OnTouchUp(TouchUpEvent e)
-        {
-            getRulesetKeyBindingContainer().TriggerReleased(Action.Value);
-        }
-
         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));
diff --git a/osu.Game.Rulesets.Mania/UI/Components/DefaultKeyArea.cs b/osu.Game.Rulesets.Mania/UI/Components/DefaultKeyArea.cs
index 267ed1f5f4..4e0bb71514 100644
--- a/osu.Game.Rulesets.Mania/UI/Components/DefaultKeyArea.cs
+++ b/osu.Game.Rulesets.Mania/UI/Components/DefaultKeyArea.cs
@@ -36,10 +36,31 @@ namespace osu.Game.Rulesets.Mania.UI.Components
             RelativeSizeAxes = Axes.Both;
         }
 
+        public class ChildContainer : Container
+        {
+            private ManiaInputManager.RulesetKeyBindingContainer keyBindingContainer { get; set; }
+
+            private ManiaInputManager.RulesetKeyBindingContainer getKeyBindingContainer()
+            {
+                return keyBindingContainer ??= ((ManiaInputManager)GetContainingInputManager()).GetKeyBindingContainer();
+            }
+
+            protected override bool OnTouchDown(TouchDownEvent e)
+            {
+                getKeyBindingContainer().TriggerPressed(((DefaultKeyArea)Parent).column.Action.Value);
+                return base.OnTouchDown(e);
+            }
+
+            protected override void OnTouchUp(TouchUpEvent e)
+            {
+                getKeyBindingContainer().TriggerReleased(((DefaultKeyArea)Parent).column.Action.Value);
+            }
+        }
+
         [BackgroundDependencyLoader]
         private void load(IScrollingInfo scrollingInfo)
         {
-            InternalChild = directionContainer = new Container
+            InternalChild = directionContainer = new ChildContainer
             {
                 RelativeSizeAxes = Axes.X,
                 Height = Stage.HIT_TARGET_POSITION,
@@ -69,7 +90,7 @@ namespace osu.Game.Rulesets.Mania.UI.Components
                                 AlwaysPresent = true
                             }
                         }
-                    }
+                    },
                 }
             };
 

From dec1f317494c73bbb4313d7be2f1cadb5fde488c Mon Sep 17 00:00:00 2001
From: pikokr <parangee9706@gmail.com>
Date: Tue, 28 Dec 2021 22:43:07 +0900
Subject: [PATCH 1872/5547] Make `KeyBindingContainer` public

---
 osu.Game.Rulesets.Mania/ManiaInputManager.cs            | 5 -----
 osu.Game.Rulesets.Mania/UI/Components/DefaultKeyArea.cs | 2 +-
 osu.Game/Rulesets/UI/RulesetInputManager.cs             | 2 +-
 3 files changed, 2 insertions(+), 7 deletions(-)

diff --git a/osu.Game.Rulesets.Mania/ManiaInputManager.cs b/osu.Game.Rulesets.Mania/ManiaInputManager.cs
index bf94735077..186fc4b15d 100644
--- a/osu.Game.Rulesets.Mania/ManiaInputManager.cs
+++ b/osu.Game.Rulesets.Mania/ManiaInputManager.cs
@@ -13,11 +13,6 @@ namespace osu.Game.Rulesets.Mania
             : base(ruleset, variant, SimultaneousBindingMode.Unique)
         {
         }
-
-        public RulesetKeyBindingContainer GetKeyBindingContainer()
-        {
-            return (RulesetKeyBindingContainer)KeyBindingContainer;
-        }
     }
 
     public enum ManiaAction
diff --git a/osu.Game.Rulesets.Mania/UI/Components/DefaultKeyArea.cs b/osu.Game.Rulesets.Mania/UI/Components/DefaultKeyArea.cs
index 4e0bb71514..b3a2a97bf7 100644
--- a/osu.Game.Rulesets.Mania/UI/Components/DefaultKeyArea.cs
+++ b/osu.Game.Rulesets.Mania/UI/Components/DefaultKeyArea.cs
@@ -42,7 +42,7 @@ namespace osu.Game.Rulesets.Mania.UI.Components
 
             private ManiaInputManager.RulesetKeyBindingContainer getKeyBindingContainer()
             {
-                return keyBindingContainer ??= ((ManiaInputManager)GetContainingInputManager()).GetKeyBindingContainer();
+                return keyBindingContainer ??= (ManiaInputManager.RulesetKeyBindingContainer)((ManiaInputManager)GetContainingInputManager()).KeyBindingContainer;
             }
 
             protected override bool OnTouchDown(TouchDownEvent e)
diff --git a/osu.Game/Rulesets/UI/RulesetInputManager.cs b/osu.Game/Rulesets/UI/RulesetInputManager.cs
index 6564ff9e23..6ef99f8aae 100644
--- a/osu.Game/Rulesets/UI/RulesetInputManager.cs
+++ b/osu.Game/Rulesets/UI/RulesetInputManager.cs
@@ -43,7 +43,7 @@ namespace osu.Game.Rulesets.UI
 
         protected override InputState CreateInitialState() => new RulesetInputManagerInputState<T>(base.CreateInitialState());
 
-        protected readonly KeyBindingContainer<T> KeyBindingContainer;
+        public readonly KeyBindingContainer<T> KeyBindingContainer;
 
         protected override Container<Drawable> Content => content;
 

From d74e438f0a02fdb5705d33e92e4fdc24d58fba40 Mon Sep 17 00:00:00 2001
From: Berkan Diler <berkan.diler1@ingka.ikea.com>
Date: Tue, 28 Dec 2021 15:17:18 +0100
Subject: [PATCH 1873/5547] Remove unused SharpRaven package reference from
 osu.iOS.props

Seems like a leftover from #6824
---
 osu.iOS.props | 1 -
 1 file changed, 1 deletion(-)

diff --git a/osu.iOS.props b/osu.iOS.props
index cccf974d42..63dc889e3c 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -86,7 +86,6 @@
     <PackageReference Include="ppy.osu.Framework" Version="2021.1227.0" />
     <PackageReference Include="SharpCompress" Version="0.30.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
-    <PackageReference Include="SharpRaven" Version="2.4.0" />
     <PackageReference Include="System.ComponentModel.Annotations" Version="5.0.0" />
     <PackageReference Include="ppy.osu.Framework.NativeLibs" Version="2021.805.0" ExcludeAssets="all" />
     <PackageReference Include="Realm" Version="10.7.1" />

From 448c6ed515572a667524792761056b13889afe70 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 28 Dec 2021 15:50:43 +0100
Subject: [PATCH 1874/5547] Generalise `KiaiFlashingSprite` for arbitrary
 drawables

---
 .../Skinning/Legacy/KiaiFlashingDrawable.cs   | 50 +++++++++++++++
 .../Skinning/Legacy/KiaiFlashingSprite.cs     | 61 -------------------
 .../Skinning/Legacy/LegacyMainCirclePiece.cs  |  7 +--
 3 files changed, 53 insertions(+), 65 deletions(-)
 create mode 100644 osu.Game.Rulesets.Osu/Skinning/Legacy/KiaiFlashingDrawable.cs
 delete mode 100644 osu.Game.Rulesets.Osu/Skinning/Legacy/KiaiFlashingSprite.cs

diff --git a/osu.Game.Rulesets.Osu/Skinning/Legacy/KiaiFlashingDrawable.cs b/osu.Game.Rulesets.Osu/Skinning/Legacy/KiaiFlashingDrawable.cs
new file mode 100644
index 0000000000..cd1d05c985
--- /dev/null
+++ b/osu.Game.Rulesets.Osu/Skinning/Legacy/KiaiFlashingDrawable.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 osu.Framework.Audio.Track;
+using osu.Framework.Graphics;
+using osu.Game.Beatmaps.ControlPoints;
+using osu.Game.Graphics.Containers;
+
+namespace osu.Game.Rulesets.Osu.Skinning.Legacy
+{
+    internal class KiaiFlashingDrawable : BeatSyncedContainer
+    {
+        private readonly Drawable flashingDrawable;
+
+        private const float flash_opacity = 0.3f;
+
+        public KiaiFlashingDrawable(Func<Drawable> creationFunc)
+        {
+            AutoSizeAxes = Axes.Both;
+
+            Children = new[]
+            {
+                creationFunc.Invoke().With(d =>
+                {
+                    d.Anchor = Anchor.Centre;
+                    d.Origin = Anchor.Centre;
+                }),
+                flashingDrawable = creationFunc.Invoke().With(d =>
+                {
+                    d.Anchor = Anchor.Centre;
+                    d.Origin = Anchor.Centre;
+                    d.Alpha = 0;
+                    d.Blending = BlendingParameters.Additive;
+                })
+            };
+        }
+
+        protected override void OnNewBeat(int beatIndex, TimingControlPoint timingPoint, EffectControlPoint effectPoint, ChannelAmplitudes amplitudes)
+        {
+            if (!effectPoint.KiaiMode)
+                return;
+
+            flashingDrawable
+                .FadeTo(flash_opacity)
+                .Then()
+                .FadeOut(timingPoint.BeatLength * 0.75f);
+        }
+    }
+}
diff --git a/osu.Game.Rulesets.Osu/Skinning/Legacy/KiaiFlashingSprite.cs b/osu.Game.Rulesets.Osu/Skinning/Legacy/KiaiFlashingSprite.cs
deleted file mode 100644
index 4a1d69ad41..0000000000
--- a/osu.Game.Rulesets.Osu/Skinning/Legacy/KiaiFlashingSprite.cs
+++ /dev/null
@@ -1,61 +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.Audio.Track;
-using osu.Framework.Graphics;
-using osu.Framework.Graphics.Sprites;
-using osu.Framework.Graphics.Textures;
-using osu.Game.Beatmaps.ControlPoints;
-using osu.Game.Graphics.Containers;
-
-namespace osu.Game.Rulesets.Osu.Skinning.Legacy
-{
-    internal class KiaiFlashingSprite : BeatSyncedContainer
-    {
-        private readonly Sprite mainSprite;
-        private readonly Sprite flashingSprite;
-
-        public Texture Texture
-        {
-            set
-            {
-                mainSprite.Texture = value;
-                flashingSprite.Texture = value;
-            }
-        }
-
-        private const float flash_opacity = 0.3f;
-
-        public KiaiFlashingSprite()
-        {
-            AutoSizeAxes = Axes.Both;
-
-            Children = new Drawable[]
-            {
-                mainSprite = new Sprite
-                {
-                    Anchor = Anchor.Centre,
-                    Origin = Anchor.Centre,
-                },
-                flashingSprite = new Sprite
-                {
-                    Anchor = Anchor.Centre,
-                    Origin = Anchor.Centre,
-                    Alpha = 0,
-                    Blending = BlendingParameters.Additive,
-                }
-            };
-        }
-
-        protected override void OnNewBeat(int beatIndex, TimingControlPoint timingPoint, EffectControlPoint effectPoint, ChannelAmplitudes amplitudes)
-        {
-            if (!effectPoint.KiaiMode)
-                return;
-
-            flashingSprite
-                .FadeTo(flash_opacity)
-                .Then()
-                .FadeOut(timingPoint.BeatLength * 0.75f);
-        }
-    }
-}
diff --git a/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyMainCirclePiece.cs b/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyMainCirclePiece.cs
index d2f84dcf84..9cda85c20c 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyMainCirclePiece.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyMainCirclePiece.cs
@@ -5,6 +5,7 @@ using osu.Framework.Allocation;
 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.Game.Graphics;
 using osu.Game.Graphics.Sprites;
@@ -72,9 +73,8 @@ namespace osu.Game.Rulesets.Osu.Skinning.Legacy
 
             InternalChildren = new[]
             {
-                hitCircleSprite = new KiaiFlashingSprite
+                hitCircleSprite = new KiaiFlashingDrawable(() => new Sprite { Texture = baseTexture })
                 {
-                    Texture = baseTexture,
                     Anchor = Anchor.Centre,
                     Origin = Anchor.Centre,
                 },
@@ -82,9 +82,8 @@ namespace osu.Game.Rulesets.Osu.Skinning.Legacy
                 {
                     Anchor = Anchor.Centre,
                     Origin = Anchor.Centre,
-                    Child = hitCircleOverlay = new KiaiFlashingSprite
+                    Child = hitCircleOverlay = new KiaiFlashingDrawable(() => new Sprite { Texture = overlayTexture })
                     {
-                        Texture = overlayTexture,
                         Anchor = Anchor.Centre,
                         Origin = Anchor.Centre,
                     },

From b29c2bf9f317ea770d9dd60d066a3b08b914c1ca Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 28 Dec 2021 15:36:30 +0100
Subject: [PATCH 1875/5547] Add test resources for animated legacy hit circle
 overlay

---
 ...overlay@2x.png => hitcircleoverlay-0@2x.png} | Bin
 .../special-skin/hitcircleoverlay-1@2x.png      | Bin 0 -> 40858 bytes
 2 files changed, 0 insertions(+), 0 deletions(-)
 rename osu.Game.Rulesets.Osu.Tests/Resources/special-skin/{hitcircleoverlay@2x.png => hitcircleoverlay-0@2x.png} (100%)
 create mode 100755 osu.Game.Rulesets.Osu.Tests/Resources/special-skin/hitcircleoverlay-1@2x.png

diff --git a/osu.Game.Rulesets.Osu.Tests/Resources/special-skin/hitcircleoverlay@2x.png b/osu.Game.Rulesets.Osu.Tests/Resources/special-skin/hitcircleoverlay-0@2x.png
similarity index 100%
rename from osu.Game.Rulesets.Osu.Tests/Resources/special-skin/hitcircleoverlay@2x.png
rename to osu.Game.Rulesets.Osu.Tests/Resources/special-skin/hitcircleoverlay-0@2x.png
diff --git a/osu.Game.Rulesets.Osu.Tests/Resources/special-skin/hitcircleoverlay-1@2x.png b/osu.Game.Rulesets.Osu.Tests/Resources/special-skin/hitcircleoverlay-1@2x.png
new file mode 100755
index 0000000000000000000000000000000000000000..3b5e886933d2f7a8803a44304c5439058ef86fa2
GIT binary patch
literal 40858
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
U^GtX>4gf!<m#-R@=)2(m2kI%UfdBvi

literal 0
HcmV?d00001


From eea0fea69f85bb8cf31ab918722803f29282593c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 28 Dec 2021 15:53:54 +0100
Subject: [PATCH 1876/5547] Add support for animated legacy hit circle overlay

---
 .../Skinning/Legacy/LegacyMainCirclePiece.cs   | 18 ++++++++++++++++--
 1 file changed, 16 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyMainCirclePiece.cs b/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyMainCirclePiece.cs
index 9cda85c20c..c6007885be 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyMainCirclePiece.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyMainCirclePiece.cs
@@ -69,7 +69,6 @@ namespace osu.Game.Rulesets.Osu.Skinning.Legacy
             // at this point, any further texture fetches should be correctly using the priority source if the base texture was retrieved using it.
             // the flow above handles the case where a sliderendcircle.png is retrieved from the skin, but sliderendcircleoverlay.png doesn't exist.
             // expected behaviour in this scenario is not showing the overlay, rather than using hitcircleoverlay.png (potentially from the default/fall-through skin).
-            Texture overlayTexture = getTextureWithFallback("overlay");
 
             InternalChildren = new[]
             {
@@ -82,7 +81,7 @@ namespace osu.Game.Rulesets.Osu.Skinning.Legacy
                 {
                     Anchor = Anchor.Centre,
                     Origin = Anchor.Centre,
-                    Child = hitCircleOverlay = new KiaiFlashingDrawable(() => new Sprite { Texture = overlayTexture })
+                    Child = hitCircleOverlay = new KiaiFlashingDrawable(() => getAnimationWithFallback(@"overlay", 1000 / 2d))
                     {
                         Anchor = Anchor.Centre,
                         Origin = Anchor.Centre,
@@ -125,6 +124,21 @@ namespace osu.Game.Rulesets.Osu.Skinning.Legacy
 
                 return tex ?? skin.GetTexture($"hitcircle{name}");
             }
+
+            Drawable getAnimationWithFallback(string name, double frameLength)
+            {
+                Drawable animation = null;
+
+                if (!string.IsNullOrEmpty(priorityLookup))
+                {
+                    animation = skin.GetAnimation($"{priorityLookup}{name}", true, true, frameLength: frameLength);
+
+                    if (!allowFallback)
+                        return animation;
+                }
+
+                return animation ?? skin.GetAnimation($"hitcircle{name}", true, true, frameLength: frameLength);
+            }
         }
 
         protected override void LoadComplete()

From c22a07d9fc19f3598e6d3727c939c2f9443111bc Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Tue, 28 Dec 2021 11:21:59 -0800
Subject: [PATCH 1877/5547] Bump identifier typo inspection and fix remaining
 identifier names

---
 osu.Desktop/Windows/WindowsKey.cs                |  3 +++
 .../Skinning/OsuSkinConfiguration.cs             |  2 ++
 .../Online/Chat/MessageNotifierTest.cs           |  2 +-
 .../Requests/GetUserRecentActivitiesRequest.cs   |  2 ++
 osu.sln.DotSettings                              | 16 +++++++++++++++-
 5 files changed, 23 insertions(+), 2 deletions(-)

diff --git a/osu.Desktop/Windows/WindowsKey.cs b/osu.Desktop/Windows/WindowsKey.cs
index f19d741107..c9d94cd05c 100644
--- a/osu.Desktop/Windows/WindowsKey.cs
+++ b/osu.Desktop/Windows/WindowsKey.cs
@@ -14,6 +14,8 @@ namespace osu.Desktop.Windows
 
         private const int wh_keyboard_ll = 13;
         private const int wm_keydown = 256;
+
+        // ReSharper disable once IdentifierTypo
         private const int wm_syskeyup = 261;
 
         //Resharper disable once NotAccessedField.Local
@@ -69,6 +71,7 @@ namespace osu.Desktop.Windows
         }
 
         [DllImport(@"user32.dll", EntryPoint = @"SetWindowsHookExA")]
+        // ReSharper disable once IdentifierTypo
         private static extern IntPtr setWindowsHookEx(int idHook, LowLevelKeyboardProcDelegate lpfn, IntPtr hMod, int dwThreadId);
 
         [DllImport(@"user32.dll", EntryPoint = @"UnhookWindowsHookEx")]
diff --git a/osu.Game.Rulesets.Osu/Skinning/OsuSkinConfiguration.cs b/osu.Game.Rulesets.Osu/Skinning/OsuSkinConfiguration.cs
index 6953e66b5c..7b9cf8e1d1 100644
--- a/osu.Game.Rulesets.Osu/Skinning/OsuSkinConfiguration.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/OsuSkinConfiguration.cs
@@ -12,6 +12,8 @@ namespace osu.Game.Rulesets.Osu.Skinning
         CursorExpand,
         CursorRotate,
         HitCircleOverlayAboveNumber,
+
+        // ReSharper disable once IdentifierTypo
         HitCircleOverlayAboveNumer, // Some old skins will have this typo
         SpinnerFrequencyModulate,
         SpinnerNoBlink
diff --git a/osu.Game.Tests/Online/Chat/MessageNotifierTest.cs b/osu.Game.Tests/Online/Chat/MessageNotifierTest.cs
index 2ec5b778d1..855de9b656 100644
--- a/osu.Game.Tests/Online/Chat/MessageNotifierTest.cs
+++ b/osu.Game.Tests/Online/Chat/MessageNotifierTest.cs
@@ -46,7 +46,7 @@ namespace osu.Game.Tests.Online.Chat
         }
 
         [Test]
-        public void TestContainsUsernameBetweenInterpunction()
+        public void TestContainsUsernameBetweenPunctuation()
         {
             Assert.IsTrue(MessageNotifier.CheckContainsUsername("Hello 'test'-message", "Test"));
         }
diff --git a/osu.Game/Online/API/Requests/GetUserRecentActivitiesRequest.cs b/osu.Game/Online/API/Requests/GetUserRecentActivitiesRequest.cs
index 123624d333..f2fa51bde7 100644
--- a/osu.Game/Online/API/Requests/GetUserRecentActivitiesRequest.cs
+++ b/osu.Game/Online/API/Requests/GetUserRecentActivitiesRequest.cs
@@ -22,6 +22,8 @@ namespace osu.Game.Online.API.Requests
     public enum RecentActivityType
     {
         Achievement,
+
+        // ReSharper disable once IdentifierTypo
         BeatmapPlaycount,
         BeatmapsetApprove,
         BeatmapsetDelete,
diff --git a/osu.sln.DotSettings b/osu.sln.DotSettings
index 90bf4f09eb..5f3a38557d 100644
--- a/osu.sln.DotSettings
+++ b/osu.sln.DotSettings
@@ -90,7 +90,7 @@
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=FieldCanBeMadeReadOnly_002ELocal/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=ForCanBeConvertedToForeach/@EntryIndexedValue">HINT</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=ForStatementConditionIsTrue/@EntryIndexedValue">DO_NOT_SHOW</s:String>
-	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=IdentifierTypo/@EntryIndexedValue">HINT</s:String>
+	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=IdentifierTypo/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=ImpureMethodCallOnReadonlyValueField/@EntryIndexedValue">HINT</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=InconsistentNaming/@EntryIndexedValue">ERROR</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=IncorrectBlankLinesNearBraces/@EntryIndexedValue">WARNING</s:String>
@@ -928,11 +928,19 @@ private void load()
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=bindable/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=bindables/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Catmull/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Clickthrough/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Closedness/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=crosshair/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Daycore/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Deserialise/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=deserialised/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Dimmable/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Disableable/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Drawables/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=evast/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Failable/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=favourited/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=flyte/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Gamefield/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=gameplay/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Geki/@EntryIndexedValue">True</s:Boolean>
@@ -949,8 +957,11 @@ private void load()
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Kudosu/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Leaderboard/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Leaderboards/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=letterboxing/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=localisable/@EntryIndexedValue">True</s:Boolean>
 	<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/=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>
@@ -965,6 +976,9 @@ private void load()
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Refilter/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Reinstantiation/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=resampler/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=romanisable/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Romanisation/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Romanised/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=ruleset/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=rulesets/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=ruleset_0027s/@EntryIndexedValue">True</s:Boolean>

From 471eea750af41ec00b34fe4a22f928b2524d87e8 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 29 Dec 2021 21:17:44 +0900
Subject: [PATCH 1878/5547] Fix calling `SkinEditorOverlay.Show` before the
 overlay is loaded causing an exception

As seen at https://github.com/ppy/osu/runs/4652969942?check_suite_focus=true.
---
 osu.Game/Skinning/Editor/SkinEditorOverlay.cs | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Skinning/Editor/SkinEditorOverlay.cs b/osu.Game/Skinning/Editor/SkinEditorOverlay.cs
index 340c6ed931..6699e0f658 100644
--- a/osu.Game/Skinning/Editor/SkinEditorOverlay.cs
+++ b/osu.Game/Skinning/Editor/SkinEditorOverlay.cs
@@ -73,9 +73,13 @@ namespace osu.Game.Skinning.Editor
                 skinEditor = new SkinEditor(target);
                 skinEditor.State.BindValueChanged(editorVisibilityChanged);
 
-                Debug.Assert(skinEditor != null);
-
-                LoadComponentAsync(skinEditor, AddInternal);
+                // Schedule ensures that if `Show` is called before this overlay is loaded,
+                // it will not throw (LoadComponentAsync requires the load target to be in a loaded state).
+                Schedule(() =>
+                {
+                    Debug.Assert(skinEditor != null);
+                    LoadComponentAsync(skinEditor, AddInternal);
+                });
             }
             else
                 skinEditor.Show();

From b1a444180fda72619ae33667411d28989d674cda Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 29 Dec 2021 21:46:34 +0900
Subject: [PATCH 1879/5547] Fix `Show` then `Reset` potentially resulting in
 incorrect load target

---
 osu.Game/Skinning/Editor/SkinEditorOverlay.cs | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Skinning/Editor/SkinEditorOverlay.cs b/osu.Game/Skinning/Editor/SkinEditorOverlay.cs
index 6699e0f658..ebf0a1214e 100644
--- a/osu.Game/Skinning/Editor/SkinEditorOverlay.cs
+++ b/osu.Game/Skinning/Editor/SkinEditorOverlay.cs
@@ -70,16 +70,18 @@ namespace osu.Game.Skinning.Editor
             // base call intentionally omitted.
             if (skinEditor == null)
             {
-                skinEditor = new SkinEditor(target);
-                skinEditor.State.BindValueChanged(editorVisibilityChanged);
+                var editor = new SkinEditor(target);
+                editor.State.BindValueChanged(editorVisibilityChanged);
 
                 // Schedule ensures that if `Show` is called before this overlay is loaded,
                 // it will not throw (LoadComponentAsync requires the load target to be in a loaded state).
                 Schedule(() =>
                 {
-                    Debug.Assert(skinEditor != null);
-                    LoadComponentAsync(skinEditor, AddInternal);
+                    Debug.Assert(editor != null);
+                    LoadComponentAsync(editor, AddInternal);
                 });
+
+                skinEditor = editor;
             }
             else
                 skinEditor.Show();

From cdc148f78e08fe1929b4e1b8ddb59f8b683b194e Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Wed, 29 Dec 2021 14:07:36 -0800
Subject: [PATCH 1880/5547] Increase scope of identifier typo disables on
 special cases

---
 osu.Desktop/Windows/WindowsKey.cs                             | 4 ++--
 .../Online/API/Requests/GetUserRecentActivitiesRequest.cs     | 4 ++--
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Desktop/Windows/WindowsKey.cs b/osu.Desktop/Windows/WindowsKey.cs
index c9d94cd05c..ec4d3f5d74 100644
--- a/osu.Desktop/Windows/WindowsKey.cs
+++ b/osu.Desktop/Windows/WindowsKey.cs
@@ -2,10 +2,12 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
+using System.Diagnostics.CodeAnalysis;
 using System.Runtime.InteropServices;
 
 namespace osu.Desktop.Windows
 {
+    [SuppressMessage("ReSharper", "IdentifierTypo")]
     internal class WindowsKey
     {
         private delegate int LowLevelKeyboardProcDelegate(int nCode, int wParam, ref KdDllHookStruct lParam);
@@ -15,7 +17,6 @@ namespace osu.Desktop.Windows
         private const int wh_keyboard_ll = 13;
         private const int wm_keydown = 256;
 
-        // ReSharper disable once IdentifierTypo
         private const int wm_syskeyup = 261;
 
         //Resharper disable once NotAccessedField.Local
@@ -71,7 +72,6 @@ namespace osu.Desktop.Windows
         }
 
         [DllImport(@"user32.dll", EntryPoint = @"SetWindowsHookExA")]
-        // ReSharper disable once IdentifierTypo
         private static extern IntPtr setWindowsHookEx(int idHook, LowLevelKeyboardProcDelegate lpfn, IntPtr hMod, int dwThreadId);
 
         [DllImport(@"user32.dll", EntryPoint = @"UnhookWindowsHookEx")]
diff --git a/osu.Game/Online/API/Requests/GetUserRecentActivitiesRequest.cs b/osu.Game/Online/API/Requests/GetUserRecentActivitiesRequest.cs
index f2fa51bde7..62b27b31b4 100644
--- a/osu.Game/Online/API/Requests/GetUserRecentActivitiesRequest.cs
+++ b/osu.Game/Online/API/Requests/GetUserRecentActivitiesRequest.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.Online.API.Requests.Responses;
 
 namespace osu.Game.Online.API.Requests
@@ -19,11 +20,10 @@ namespace osu.Game.Online.API.Requests
         protected override string Target => $"users/{userId}/recent_activity";
     }
 
+    [SuppressMessage("ReSharper", "IdentifierTypo")]
     public enum RecentActivityType
     {
         Achievement,
-
-        // ReSharper disable once IdentifierTypo
         BeatmapPlaycount,
         BeatmapsetApprove,
         BeatmapsetDelete,

From ef49f2ed0e4835498d3d6b9b92431a59977d0700 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 30 Dec 2021 16:02:08 +0900
Subject: [PATCH 1881/5547] Add extra extra safety against attempting to load a
 previously expired editor

---
 osu.Game/Skinning/Editor/SkinEditorOverlay.cs | 16 ++++++++++++----
 1 file changed, 12 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Skinning/Editor/SkinEditorOverlay.cs b/osu.Game/Skinning/Editor/SkinEditorOverlay.cs
index ebf0a1214e..87da67dae0 100644
--- a/osu.Game/Skinning/Editor/SkinEditorOverlay.cs
+++ b/osu.Game/Skinning/Editor/SkinEditorOverlay.cs
@@ -73,15 +73,23 @@ namespace osu.Game.Skinning.Editor
                 var editor = new SkinEditor(target);
                 editor.State.BindValueChanged(editorVisibilityChanged);
 
+                skinEditor = editor;
+
                 // Schedule ensures that if `Show` is called before this overlay is loaded,
                 // it will not throw (LoadComponentAsync requires the load target to be in a loaded state).
                 Schedule(() =>
                 {
-                    Debug.Assert(editor != null);
-                    LoadComponentAsync(editor, AddInternal);
-                });
+                    if (editor != skinEditor)
+                        return;
 
-                skinEditor = editor;
+                    LoadComponentAsync(editor, _ =>
+                    {
+                        if (editor != skinEditor)
+                            return;
+
+                        AddInternal(editor);
+                    });
+                });
             }
             else
                 skinEditor.Show();

From 089b756f932b1b59a4b66380553a9d0254d8a121 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 30 Dec 2021 16:03:16 +0900
Subject: [PATCH 1882/5547] Invert logic to make reading easier

---
 osu.Game/Skinning/Editor/SkinEditorOverlay.cs | 39 ++++++++++---------
 1 file changed, 20 insertions(+), 19 deletions(-)

diff --git a/osu.Game/Skinning/Editor/SkinEditorOverlay.cs b/osu.Game/Skinning/Editor/SkinEditorOverlay.cs
index 87da67dae0..86854ab6ff 100644
--- a/osu.Game/Skinning/Editor/SkinEditorOverlay.cs
+++ b/osu.Game/Skinning/Editor/SkinEditorOverlay.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.Diagnostics;
 using JetBrains.Annotations;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
@@ -67,32 +66,34 @@ namespace osu.Game.Skinning.Editor
 
         public override void Show()
         {
-            // base call intentionally omitted.
-            if (skinEditor == null)
+            // base call intentionally omitted as we have custom behaviour.
+
+            if (skinEditor != null)
             {
-                var editor = new SkinEditor(target);
-                editor.State.BindValueChanged(editorVisibilityChanged);
+                skinEditor.Show();
+                return;
+            }
 
-                skinEditor = editor;
+            var editor = new SkinEditor(target);
+            editor.State.BindValueChanged(editorVisibilityChanged);
 
-                // Schedule ensures that if `Show` is called before this overlay is loaded,
-                // it will not throw (LoadComponentAsync requires the load target to be in a loaded state).
-                Schedule(() =>
+            skinEditor = editor;
+
+            // Schedule ensures that if `Show` is called before this overlay is loaded,
+            // it will not throw (LoadComponentAsync requires the load target to be in a loaded state).
+            Schedule(() =>
+            {
+                if (editor != skinEditor)
+                    return;
+
+                LoadComponentAsync(editor, _ =>
                 {
                     if (editor != skinEditor)
                         return;
 
-                    LoadComponentAsync(editor, _ =>
-                    {
-                        if (editor != skinEditor)
-                            return;
-
-                        AddInternal(editor);
-                    });
+                    AddInternal(editor);
                 });
-            }
-            else
-                skinEditor.Show();
+            });
         }
 
         private void editorVisibilityChanged(ValueChangedEvent<Visibility> visibility)

From 4cb8272d14369fb7a129d5ec3997b92a14e14867 Mon Sep 17 00:00:00 2001
From: pikokr <parangee9706@gmail.com>
Date: Thu, 30 Dec 2021 17:37:14 +0900
Subject: [PATCH 1883/5547] Column Touch area & highlighting on start

---
 osu.Game.Rulesets.Mania/UI/Column.cs          | 60 ++++++++++++++++++-
 .../UI/Components/DefaultKeyArea.cs           | 23 +------
 2 files changed, 60 insertions(+), 23 deletions(-)

diff --git a/osu.Game.Rulesets.Mania/UI/Column.cs b/osu.Game.Rulesets.Mania/UI/Column.cs
index 9d060944cd..1e07c84d9f 100644
--- a/osu.Game.Rulesets.Mania/UI/Column.cs
+++ b/osu.Game.Rulesets.Mania/UI/Column.cs
@@ -44,6 +44,63 @@ namespace osu.Game.Rulesets.Mania.UI
 
         private readonly GameplaySampleTriggerSource sampleTriggerSource;
 
+        public class ColumnTouchInputArea : Container
+        {
+            private Column column => (Column)Parent;
+
+            private Container hintContainer;
+
+            public ColumnTouchInputArea()
+            {
+                RelativeSizeAxes = Axes.X;
+                Anchor = Anchor.BottomCentre;
+                Origin = Anchor.BottomCentre;
+                Height = 100;
+                InternalChild = hintContainer = new Container
+                {
+                    RelativeSizeAxes = Axes.Both,
+                    BorderColour = Color4.Red,
+                    BorderThickness = 5,
+                    Masking = true,
+                };
+            }
+
+            protected override void LoadComplete()
+            {
+                hintContainer.Delay(1000).FadeOutFromOne(500, Easing.OutSine);
+            }
+
+            private ManiaInputManager.RulesetKeyBindingContainer keyBindingContainer { get; set; }
+
+            private ManiaInputManager.RulesetKeyBindingContainer getKeyBindingContainer()
+            {
+                return keyBindingContainer ??= (ManiaInputManager.RulesetKeyBindingContainer)((ManiaInputManager)GetContainingInputManager()).KeyBindingContainer;
+            }
+
+            protected override bool OnTouchDown(TouchDownEvent e)
+            {
+                getKeyBindingContainer().TriggerPressed(column.Action.Value);
+                return base.OnTouchDown(e);
+            }
+
+            protected override bool OnMouseDown(MouseDownEvent e)
+            {
+                getKeyBindingContainer().TriggerPressed(column.Action.Value);
+
+                return base.OnMouseDown(e);
+            }
+
+            protected override void OnMouseUp(MouseUpEvent e)
+            {
+                getKeyBindingContainer().TriggerReleased(column.Action.Value);
+            }
+
+            protected override void OnTouchUp(TouchUpEvent e)
+            {
+                getKeyBindingContainer().TriggerReleased(column.Action.Value);
+            }
+        }
+
         public Column(int index)
         {
             Index = index;
@@ -68,7 +125,8 @@ namespace osu.Game.Rulesets.Mania.UI
                     RelativeSizeAxes = Axes.Both
                 },
                 background,
-                TopLevelContainer = new Container { RelativeSizeAxes = Axes.Both }
+                TopLevelContainer = new Container { RelativeSizeAxes = Axes.Both },
+                new ColumnTouchInputArea()
             };
 
             hitPolicy = new OrderedHitPolicy(HitObjectContainer);
diff --git a/osu.Game.Rulesets.Mania/UI/Components/DefaultKeyArea.cs b/osu.Game.Rulesets.Mania/UI/Components/DefaultKeyArea.cs
index b3a2a97bf7..15018b464f 100644
--- a/osu.Game.Rulesets.Mania/UI/Components/DefaultKeyArea.cs
+++ b/osu.Game.Rulesets.Mania/UI/Components/DefaultKeyArea.cs
@@ -36,31 +36,10 @@ namespace osu.Game.Rulesets.Mania.UI.Components
             RelativeSizeAxes = Axes.Both;
         }
 
-        public class ChildContainer : Container
-        {
-            private ManiaInputManager.RulesetKeyBindingContainer keyBindingContainer { get; set; }
-
-            private ManiaInputManager.RulesetKeyBindingContainer getKeyBindingContainer()
-            {
-                return keyBindingContainer ??= (ManiaInputManager.RulesetKeyBindingContainer)((ManiaInputManager)GetContainingInputManager()).KeyBindingContainer;
-            }
-
-            protected override bool OnTouchDown(TouchDownEvent e)
-            {
-                getKeyBindingContainer().TriggerPressed(((DefaultKeyArea)Parent).column.Action.Value);
-                return base.OnTouchDown(e);
-            }
-
-            protected override void OnTouchUp(TouchUpEvent e)
-            {
-                getKeyBindingContainer().TriggerReleased(((DefaultKeyArea)Parent).column.Action.Value);
-            }
-        }
-
         [BackgroundDependencyLoader]
         private void load(IScrollingInfo scrollingInfo)
         {
-            InternalChild = directionContainer = new ChildContainer
+            InternalChild = directionContainer = new Container
             {
                 RelativeSizeAxes = Axes.X,
                 Height = Stage.HIT_TARGET_POSITION,

From 408e8d57109ed44498601f02c829d6b4faa8c05d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 30 Dec 2021 22:21:37 +0900
Subject: [PATCH 1884/5547] Fix null reference causing crash in
 `KiaiFlashingDrawable`

Can occur if there is no fallback graphics available. Previously would
work as it was only setting the `Texture`.

As reported in https://github.com/ppy/osu/discussions/16281.
---
 .../Skinning/Legacy/KiaiFlashingDrawable.cs               | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Skinning/Legacy/KiaiFlashingDrawable.cs b/osu.Game.Rulesets.Osu/Skinning/Legacy/KiaiFlashingDrawable.cs
index cd1d05c985..4ee28d05b5 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Legacy/KiaiFlashingDrawable.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Legacy/KiaiFlashingDrawable.cs
@@ -7,6 +7,8 @@ using osu.Framework.Graphics;
 using osu.Game.Beatmaps.ControlPoints;
 using osu.Game.Graphics.Containers;
 
+#nullable enable
+
 namespace osu.Game.Rulesets.Osu.Skinning.Legacy
 {
     internal class KiaiFlashingDrawable : BeatSyncedContainer
@@ -15,18 +17,18 @@ namespace osu.Game.Rulesets.Osu.Skinning.Legacy
 
         private const float flash_opacity = 0.3f;
 
-        public KiaiFlashingDrawable(Func<Drawable> creationFunc)
+        public KiaiFlashingDrawable(Func<Drawable?> creationFunc)
         {
             AutoSizeAxes = Axes.Both;
 
             Children = new[]
             {
-                creationFunc.Invoke().With(d =>
+                (creationFunc.Invoke() ?? Empty()).With(d =>
                 {
                     d.Anchor = Anchor.Centre;
                     d.Origin = Anchor.Centre;
                 }),
-                flashingDrawable = creationFunc.Invoke().With(d =>
+                flashingDrawable = (creationFunc.Invoke() ?? Empty()).With(d =>
                 {
                     d.Anchor = Anchor.Centre;
                     d.Origin = Anchor.Centre;

From f53a675ca3e9c04c1ba7378cbd8e1cab72e0e7a8 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 30 Dec 2021 23:35:18 +0900
Subject: [PATCH 1885/5547] Fix `TestSceneMultiSpectatorLeaderboard` not
 waiting for user population

---
 .../Visual/Multiplayer/TestSceneMultiSpectatorLeaderboard.cs     | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorLeaderboard.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorLeaderboard.cs
index a61e505970..543e6a91d0 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorLeaderboard.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorLeaderboard.cs
@@ -50,6 +50,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             });
 
             AddUntilStep("wait for load", () => leaderboard.IsLoaded);
+            AddUntilStep("wait for user population", () => leaderboard.ChildrenOfType<GameplayLeaderboardScore>().Count() == 2);
 
             AddStep("add clock sources", () =>
             {

From e38e1bb1d7edd5a20ff401309cc1e38eb2eb199d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 30 Dec 2021 13:22:49 +0900
Subject: [PATCH 1886/5547] Enable a couple of missing async related
 inspections

---
 osu.sln.DotSettings | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/osu.sln.DotSettings b/osu.sln.DotSettings
index 90bf4f09eb..44d75f265c 100644
--- a/osu.sln.DotSettings
+++ b/osu.sln.DotSettings
@@ -19,6 +19,7 @@
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=AssignedValueIsNeverUsed/@EntryIndexedValue">HINT</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=AssignmentIsFullyDiscarded/@EntryIndexedValue">DO_NOT_SHOW</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=AssignNullToNotNullAttribute/@EntryIndexedValue">WARNING</s:String>
+	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=AsyncVoidMethod/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=AutoPropertyCanBeMadeGetOnly_002EGlobal/@EntryIndexedValue">HINT</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=AutoPropertyCanBeMadeGetOnly_002ELocal/@EntryIndexedValue">HINT</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=BadAttributeBracketsSpaces/@EntryIndexedValue">WARNING</s:String>
@@ -231,6 +232,7 @@
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=UnusedType_002EGlobal/@EntryIndexedValue">HINT</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=UseAwaitUsing/@EntryIndexedValue">DO_NOT_SHOW</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=UseCollectionCountProperty/@EntryIndexedValue">WARNING</s:String>
+	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=UseConfigureAwaitFalseForAsyncDisposable/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=UseFormatSpecifierInFormatString/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=UseFormatSpecifierInInterpolation/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=UseIndexFromEndExpression/@EntryIndexedValue">WARNING</s:String>

From 670a30b64bdf1f315898c7a931c0dccc3da7af70 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 30 Dec 2021 23:08:05 +0900
Subject: [PATCH 1887/5547] Remove usage of `.Result` in `ArchiveReader`

---
 osu.Game/IO/Archives/ArchiveReader.cs | 13 ++++++++++++-
 1 file changed, 12 insertions(+), 1 deletion(-)

diff --git a/osu.Game/IO/Archives/ArchiveReader.cs b/osu.Game/IO/Archives/ArchiveReader.cs
index f787534e2d..1d8da16c72 100644
--- a/osu.Game/IO/Archives/ArchiveReader.cs
+++ b/osu.Game/IO/Archives/ArchiveReader.cs
@@ -32,7 +32,18 @@ namespace osu.Game.IO.Archives
 
         public abstract IEnumerable<string> Filenames { get; }
 
-        public virtual byte[] Get(string name) => GetAsync(name).Result;
+        public virtual byte[] Get(string name)
+        {
+            using (Stream input = GetStream(name))
+            {
+                if (input == null)
+                    return null;
+
+                byte[] buffer = new byte[input.Length];
+                input.Read(buffer);
+                return buffer;
+            }
+        }
 
         public async Task<byte[]> GetAsync(string name, CancellationToken cancellationToken = default)
         {

From 1262e76a584c4b1e748f9309ad1efcfaf6e8ee55 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 31 Dec 2021 23:18:03 +0900
Subject: [PATCH 1888/5547] Fix test failure due to missing DI cached
 `IdleTracker`

---
 osu.Game/Online/Chat/ChannelManager.cs | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Online/Chat/ChannelManager.cs b/osu.Game/Online/Chat/ChannelManager.cs
index 4889ad0a3b..e9e145e2ab 100644
--- a/osu.Game/Online/Chat/ChannelManager.cs
+++ b/osu.Game/Online/Chat/ChannelManager.cs
@@ -68,20 +68,21 @@ namespace osu.Game.Online.Chat
 
         public readonly BindableBool HighPollRate = new BindableBool();
 
-        private IBindable<bool> isIdle;
+        private readonly IBindable<bool> isIdle = new BindableBool();
 
         public ChannelManager()
         {
             CurrentChannel.ValueChanged += currentChannelChanged;
         }
 
-        [BackgroundDependencyLoader]
+        [BackgroundDependencyLoader(permitNulls: true)]
         private void load(IdleTracker idleTracker)
         {
             HighPollRate.BindValueChanged(updatePollRate);
-
-            isIdle = idleTracker.IsIdle.GetBoundCopy();
             isIdle.BindValueChanged(updatePollRate, true);
+
+            if (idleTracker != null)
+                isIdle.BindTo(idleTracker.IsIdle);
         }
 
         private void updatePollRate(ValueChangedEvent<bool> valueChangedEvent)

From 675bdd32138fb222889ab8a5d4590283f910c929 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 1 Jan 2022 12:08:49 +0900
Subject: [PATCH 1889/5547] Fix `MultiplayerMatchSubScreen` mutating mods
 outside of bindable lease

As seen at https://github.com/peppy/osu/runs/4674501626?check_suite_focus=true.
---
 osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs              | 2 +-
 .../Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs b/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
index a560d85b7d..a0e7e8de87 100644
--- a/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
@@ -381,7 +381,7 @@ namespace osu.Game.Screens.OnlinePlay.Match
 
         protected virtual void UpdateMods()
         {
-            if (SelectedItem.Value == null)
+            if (SelectedItem.Value == null || !this.IsCurrentScreen())
                 return;
 
             Mods.Value = UserMods.Value.Concat(SelectedItem.Value.RequiredMods).ToList();
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
index c4dd200614..4bd68f2034 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
@@ -241,7 +241,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
 
         protected override void UpdateMods()
         {
-            if (SelectedItem.Value == null || client.LocalUser == null)
+            if (SelectedItem.Value == null || client.LocalUser == null || !this.IsCurrentScreen())
                 return;
 
             // update local mods based on room's reported status for the local user (omitting the base call implementation).

From 04d8fd3a58f59909b5ee1800a61f41182c7d0197 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 1 Jan 2022 15:31:50 +0900
Subject: [PATCH 1890/5547] Improve reliability of `TestStoryboardSkipOutro`

Aims to resolve failures as seen at
https://github.com/peppy/osu/runs/4677353822?check_suite_focus=true.

Have run quite a lot locally with no failures (while removing the skip step 100% fails).
---
 osu.Game.Tests/Visual/Gameplay/TestSceneStoryboardWithOutro.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboardWithOutro.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboardWithOutro.cs
index 48a97d54f7..69798dcb82 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboardWithOutro.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboardWithOutro.cs
@@ -53,8 +53,8 @@ namespace osu.Game.Tests.Visual.Gameplay
             CreateTest(null);
             AddUntilStep("completion set by processor", () => Player.ScoreProcessor.HasCompleted.Value);
             AddStep("skip outro", () => InputManager.Key(osuTK.Input.Key.Space));
+            AddAssert("player is no longer current screen", () => !Player.IsCurrentScreen());
             AddUntilStep("wait for score shown", () => Player.IsScoreShown);
-            AddUntilStep("time less than storyboard duration", () => Player.GameplayClockContainer.GameplayClock.CurrentTime < currentStoryboardDuration);
         }
 
         [Test]

From 5dd024aab7d8add3a143725b1a21beab946da70e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 3 Jan 2022 12:46:02 +0900
Subject: [PATCH 1891/5547] Remove outdated settings migration

---
 osu.Game/Configuration/OsuConfigManager.cs | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/osu.Game/Configuration/OsuConfigManager.cs b/osu.Game/Configuration/OsuConfigManager.cs
index 616e749c9b..6efbaa4d36 100644
--- a/osu.Game/Configuration/OsuConfigManager.cs
+++ b/osu.Game/Configuration/OsuConfigManager.cs
@@ -174,11 +174,6 @@ namespace osu.Game.Configuration
             if (!int.TryParse(pieces[1], out int monthDay)) return;
 
             int combined = (year * 10000) + monthDay;
-
-            if (combined < 20210413)
-            {
-                SetValue(OsuSetting.EditorWaveformOpacity, 0.25f);
-            }
         }
 
         public override TrackedSettings CreateTrackedSettings()

From 623d6d6d2d0635b55da3d99d499b0ef5a085b618 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 3 Jan 2022 12:46:20 +0900
Subject: [PATCH 1892/5547] Add migration of positional hitsounds setting to
 new level based setting

---
 osu.Game/Configuration/OsuConfigManager.cs | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Configuration/OsuConfigManager.cs b/osu.Game/Configuration/OsuConfigManager.cs
index 6efbaa4d36..07d2026c65 100644
--- a/osu.Game/Configuration/OsuConfigManager.cs
+++ b/osu.Game/Configuration/OsuConfigManager.cs
@@ -98,6 +98,7 @@ namespace osu.Game.Configuration
             SetDefault(OsuSetting.MenuParallax, true);
 
             // Gameplay
+            SetDefault(OsuSetting.PositionalHitsounds, true); // replaced by level setting below, can be removed 20220703.
             SetDefault(OsuSetting.PositionalHitsoundsLevel, 0.2f, 0, 1);
             SetDefault(OsuSetting.DimLevel, 0.8, 0, 1, 0.01);
             SetDefault(OsuSetting.BlurLevel, 0, 0, 1, 0.01);
@@ -174,6 +175,13 @@ namespace osu.Game.Configuration
             if (!int.TryParse(pieces[1], out int monthDay)) return;
 
             int combined = (year * 10000) + monthDay;
+
+            if (combined < 20220103)
+            {
+                var positionalHitsoundsEnabled = GetBindable<bool>(OsuSetting.PositionalHitsounds);
+                if (!positionalHitsoundsEnabled.Value)
+                    SetValue(OsuSetting.PositionalHitsoundsLevel, 0);
+            }
         }
 
         public override TrackedSettings CreateTrackedSettings()
@@ -250,8 +258,9 @@ namespace osu.Game.Configuration
         BlurLevel,
         LightenDuringBreaks,
         ShowStoryboard,
-        PositionalHitsoundsLevel,
         KeyOverlay,
+        PositionalHitsounds,
+        PositionalHitsoundsLevel,
         AlwaysPlayFirstComboBreak,
         FloatingComments,
         HUDVisibilityMode,

From 6356180b6abd5a11ab32508ad3dcd2984c561aee Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 3 Jan 2022 12:53:58 +0900
Subject: [PATCH 1893/5547] Remove unnecessary code and fix double nesting
 causing filtering to not work

---
 .../Sections/Gameplay/AudioSettings.cs        | 28 ++++---------------
 1 file changed, 6 insertions(+), 22 deletions(-)

diff --git a/osu.Game/Overlays/Settings/Sections/Gameplay/AudioSettings.cs b/osu.Game/Overlays/Settings/Sections/Gameplay/AudioSettings.cs
index 4238ad1605..5029c6a617 100644
--- a/osu.Game/Overlays/Settings/Sections/Gameplay/AudioSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Gameplay/AudioSettings.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.Localisation;
 using osu.Game.Configuration;
 using osu.Game.Localisation;
-using osu.Framework.Graphics.Containers;
 
 namespace osu.Game.Overlays.Settings.Sections.Gameplay
 {
@@ -15,32 +13,18 @@ namespace osu.Game.Overlays.Settings.Sections.Gameplay
     {
         protected override LocalisableString Header => GameplaySettingsStrings.AudioHeader;
 
-        private Bindable<float> positionalHitsoundsLevel;
-
-        private FillFlowContainer<SettingsSlider<float>> positionalHitsoundsSettings;
-
         [BackgroundDependencyLoader]
         private void load(OsuConfigManager config, OsuConfigManager osuConfig)
         {
-            positionalHitsoundsLevel = osuConfig.GetBindable<float>(OsuSetting.PositionalHitsoundsLevel);
             Children = new Drawable[]
             {
-                positionalHitsoundsSettings = new FillFlowContainer<SettingsSlider<float>>
+                new SettingsSlider<float>
                 {
-                    Direction = FillDirection.Vertical,
-                    RelativeSizeAxes = Axes.X,
-                    AutoSizeAxes = Axes.Y,
-                    Masking = true,
-                    Children = new[]
-                    {
-                        new SettingsSlider<float>
-                        {
-                            LabelText = AudioSettingsStrings.PositionalLevel,
-                            Current = positionalHitsoundsLevel,
-                            KeyboardStep = 0.01f,
-                            DisplayAsPercentage = true
-                        }
-                    }
+                    LabelText = AudioSettingsStrings.PositionalLevel,
+                    Keywords = new[] { @"positional", @"balance" },
+                    Current = osuConfig.GetBindable<float>(OsuSetting.PositionalHitsoundsLevel),
+                    KeyboardStep = 0.01f,
+                    DisplayAsPercentage = true
                 },
                 new SettingsCheckbox
                 {

From b9851b278d8711532087714bb9612d7e3c8e0b95 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 3 Jan 2022 13:18:27 +0900
Subject: [PATCH 1894/5547] Add padding to the bottom of the beatmap listing
 overlay to avoid hovered panels exceeding visible bounds

Closes https://github.com/ppy/osu/issues/16120.
---
 .../Drawables/Cards/BeatmapCardContent.cs     | 51 ----------------
 .../Cards/ExpandedContentScrollContainer.cs   | 61 +++++++++++++++++++
 osu.Game/Overlays/BeatmapListingOverlay.cs    |  6 +-
 3 files changed, 66 insertions(+), 52 deletions(-)
 create mode 100644 osu.Game/Beatmaps/Drawables/Cards/ExpandedContentScrollContainer.cs

diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardContent.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardContent.cs
index 497283bc64..d43b3291be 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardContent.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardContent.cs
@@ -3,16 +3,13 @@
 
 #nullable enable
 
-using System;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Effects;
 using osu.Framework.Graphics.Shapes;
-using osu.Framework.Input.Events;
 using osu.Framework.Threading;
-using osu.Framework.Utils;
 using osu.Game.Graphics.Containers;
 using osu.Game.Overlays;
 using osuTK;
@@ -157,53 +154,5 @@ namespace osu.Game.Beatmaps.Drawables.Cards
             }, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
         }
 
-        private class ExpandedContentScrollContainer : OsuScrollContainer
-        {
-            public ExpandedContentScrollContainer()
-            {
-                ScrollbarVisible = false;
-            }
-
-            protected override void Update()
-            {
-                base.Update();
-
-                Height = Math.Min(Content.DrawHeight, 400);
-            }
-
-            private bool allowScroll => !Precision.AlmostEquals(DrawSize, Content.DrawSize);
-
-            protected override bool OnDragStart(DragStartEvent e)
-            {
-                if (!allowScroll)
-                    return false;
-
-                return base.OnDragStart(e);
-            }
-
-            protected override void OnDrag(DragEvent e)
-            {
-                if (!allowScroll)
-                    return;
-
-                base.OnDrag(e);
-            }
-
-            protected override void OnDragEnd(DragEndEvent e)
-            {
-                if (!allowScroll)
-                    return;
-
-                base.OnDragEnd(e);
-            }
-
-            protected override bool OnScroll(ScrollEvent e)
-            {
-                if (!allowScroll)
-                    return false;
-
-                return base.OnScroll(e);
-            }
-        }
     }
 }
diff --git a/osu.Game/Beatmaps/Drawables/Cards/ExpandedContentScrollContainer.cs b/osu.Game/Beatmaps/Drawables/Cards/ExpandedContentScrollContainer.cs
new file mode 100644
index 0000000000..7c3fbdaf1c
--- /dev/null
+++ b/osu.Game/Beatmaps/Drawables/Cards/ExpandedContentScrollContainer.cs
@@ -0,0 +1,61 @@
+// 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.Input.Events;
+using osu.Framework.Utils;
+using osu.Game.Graphics.Containers;
+
+namespace osu.Game.Beatmaps.Drawables.Cards
+{
+    public class ExpandedContentScrollContainer : OsuScrollContainer
+    {
+        public const float HEIGHT = 400;
+
+        public ExpandedContentScrollContainer()
+        {
+            ScrollbarVisible = false;
+        }
+
+        protected override void Update()
+        {
+            base.Update();
+
+            Height = Math.Min(Content.DrawHeight, HEIGHT);
+        }
+
+        private bool allowScroll => !Precision.AlmostEquals(DrawSize, Content.DrawSize);
+
+        protected override bool OnDragStart(DragStartEvent e)
+        {
+            if (!allowScroll)
+                return false;
+
+            return base.OnDragStart(e);
+        }
+
+        protected override void OnDrag(DragEvent e)
+        {
+            if (!allowScroll)
+                return;
+
+            base.OnDrag(e);
+        }
+
+        protected override void OnDragEnd(DragEndEvent e)
+        {
+            if (!allowScroll)
+                return;
+
+            base.OnDragEnd(e);
+        }
+
+        protected override bool OnScroll(ScrollEvent e)
+        {
+            if (!allowScroll)
+                return false;
+
+            return base.OnScroll(e);
+        }
+    }
+}
diff --git a/osu.Game/Overlays/BeatmapListingOverlay.cs b/osu.Game/Overlays/BeatmapListingOverlay.cs
index 0c2bad95d6..f06945d85b 100644
--- a/osu.Game/Overlays/BeatmapListingOverlay.cs
+++ b/osu.Game/Overlays/BeatmapListingOverlay.cs
@@ -186,7 +186,11 @@ namespace osu.Game.Overlays
                 AutoSizeAxes = Axes.Y,
                 Spacing = new Vector2(10),
                 Alpha = 0,
-                Margin = new MarginPadding { Vertical = 15 },
+                Margin = new MarginPadding
+                {
+                    Vertical = 15,
+                    Bottom = ExpandedContentScrollContainer.HEIGHT
+                },
                 ChildrenEnumerable = newCards
             };
             return content;

From 0ad555e9f7821181a00b9aaeba77f0c9fad309c2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 3 Jan 2022 18:33:32 +0100
Subject: [PATCH 1895/5547] Remove surplus blank line

---
 osu.Game/Beatmaps/Drawables/Cards/BeatmapCardContent.cs | 1 -
 1 file changed, 1 deletion(-)

diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardContent.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardContent.cs
index d43b3291be..1aaa72f5f0 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardContent.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardContent.cs
@@ -153,6 +153,5 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                 Hollow = true,
             }, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
         }
-
     }
 }

From 7c246670b450cb3daa312d5017e3b1b8c71821c2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 3 Jan 2022 18:43:20 +0100
Subject: [PATCH 1896/5547] Add padding to bottom of spotlights ranking view to
 avoid hovered panels exceeding visible bounds

---
 osu.Game/Overlays/Rankings/SpotlightsLayout.cs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Game/Overlays/Rankings/SpotlightsLayout.cs b/osu.Game/Overlays/Rankings/SpotlightsLayout.cs
index fb01656c24..7f5d096fe2 100644
--- a/osu.Game/Overlays/Rankings/SpotlightsLayout.cs
+++ b/osu.Game/Overlays/Rankings/SpotlightsLayout.cs
@@ -140,6 +140,7 @@ namespace osu.Game.Overlays.Rankings
                 {
                     AutoSizeAxes = Axes.Y,
                     RelativeSizeAxes = Axes.X,
+                    Margin = new MarginPadding { Bottom = ExpandedContentScrollContainer.HEIGHT },
                     Spacing = new Vector2(10),
                     Children = response.BeatmapSets.Select(b => new BeatmapCardNormal(b)
                     {

From 2660f413391a8b5934f918c332c1c6370bba0c93 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 3 Jan 2022 19:27:46 +0100
Subject: [PATCH 1897/5547] Add failing test case for old cards not expiring
 correctly

---
 .../Online/TestSceneBeatmapListingOverlay.cs  | 23 ++++++++++++++-----
 1 file changed, 17 insertions(+), 6 deletions(-)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneBeatmapListingOverlay.cs b/osu.Game.Tests/Visual/Online/TestSceneBeatmapListingOverlay.cs
index ee8794ae87..d0e3340f2a 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneBeatmapListingOverlay.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneBeatmapListingOverlay.cs
@@ -107,19 +107,31 @@ namespace osu.Game.Tests.Visual.Online
             AddUntilStep("is hidden", () => overlay.State.Value == Visibility.Hidden);
         }
 
+        [Test]
+        public void TestCorrectOldContentExpiration()
+        {
+            AddAssert("is visible", () => overlay.State.Value == Visibility.Visible);
+
+            AddStep("show many results", () => fetchFor(Enumerable.Repeat(CreateAPIBeatmapSet(Ruleset.Value), 100).ToArray()));
+            assertAllCardsOfType<BeatmapCardNormal>(100);
+
+            AddStep("show more results", () => fetchFor(Enumerable.Repeat(CreateAPIBeatmapSet(Ruleset.Value), 30).ToArray()));
+            assertAllCardsOfType<BeatmapCardNormal>(30);
+        }
+
         [Test]
         public void TestCardSizeSwitching()
         {
             AddAssert("is visible", () => overlay.State.Value == Visibility.Visible);
 
             AddStep("show many results", () => fetchFor(Enumerable.Repeat(CreateAPIBeatmapSet(Ruleset.Value), 100).ToArray()));
-            assertAllCardsOfType<BeatmapCardNormal>();
+            assertAllCardsOfType<BeatmapCardNormal>(100);
 
             setCardSize(BeatmapCardSize.Extra);
-            assertAllCardsOfType<BeatmapCardExtra>();
+            assertAllCardsOfType<BeatmapCardExtra>(100);
 
             setCardSize(BeatmapCardSize.Normal);
-            assertAllCardsOfType<BeatmapCardNormal>();
+            assertAllCardsOfType<BeatmapCardNormal>(100);
 
             AddStep("fetch for 0 beatmaps", () => fetchFor());
             AddUntilStep("placeholder shown", () => overlay.ChildrenOfType<BeatmapListingOverlay.NotFoundDrawable>().SingleOrDefault()?.IsPresent == true);
@@ -323,13 +335,12 @@ namespace osu.Game.Tests.Visual.Online
 
         private void setCardSize(BeatmapCardSize cardSize) => AddStep($"set card size to {cardSize}", () => overlay.ChildrenOfType<BeatmapListingCardSizeTabControl>().Single().Current.Value = cardSize);
 
-        private void assertAllCardsOfType<T>()
+        private void assertAllCardsOfType<T>(int expectedCount)
             where T : BeatmapCard =>
             AddUntilStep($"all loaded beatmap cards are {typeof(T)}", () =>
             {
                 int loadedCorrectCount = this.ChildrenOfType<BeatmapCard>().Count(card => card.IsLoaded && card.GetType() == typeof(T));
-                int totalCount = this.ChildrenOfType<BeatmapCard>().Count();
-                return loadedCorrectCount > 0 && loadedCorrectCount == totalCount;
+                return loadedCorrectCount > 0 && loadedCorrectCount == expectedCount;
             });
     }
 }

From 97439c3df15879e29163e8b5f3b7861f7a1b6d09 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 3 Jan 2022 19:30:17 +0100
Subject: [PATCH 1898/5547] Rename method to reflect what it actually does

---
 osu.Game/Overlays/BeatmapListingOverlay.cs | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Overlays/BeatmapListingOverlay.cs b/osu.Game/Overlays/BeatmapListingOverlay.cs
index 0c2bad95d6..d9c2d90e05 100644
--- a/osu.Game/Overlays/BeatmapListingOverlay.cs
+++ b/osu.Game/Overlays/BeatmapListingOverlay.cs
@@ -140,7 +140,7 @@ namespace osu.Game.Overlays
             if (searchResult.Type == BeatmapListingFilterControl.SearchResultType.SupporterOnlyFilters)
             {
                 supporterRequiredContent.UpdateText(searchResult.SupporterOnlyFiltersUsed);
-                addContentToPlaceholder(supporterRequiredContent);
+                addContentToResultsArea(supporterRequiredContent);
                 return;
             }
 
@@ -151,13 +151,13 @@ namespace osu.Game.Overlays
                 //No matches case
                 if (!newCards.Any())
                 {
-                    addContentToPlaceholder(notFoundContent);
+                    addContentToResultsArea(notFoundContent);
                     return;
                 }
 
                 var content = createCardContainerFor(newCards);
 
-                panelLoadTask = LoadComponentAsync(foundContent = content, addContentToPlaceholder, (cancellationToken = new CancellationTokenSource()).Token);
+                panelLoadTask = LoadComponentAsync(foundContent = content, addContentToResultsArea, (cancellationToken = new CancellationTokenSource()).Token);
             }
             else
             {
@@ -192,7 +192,7 @@ namespace osu.Game.Overlays
             return content;
         }
 
-        private void addContentToPlaceholder(Drawable content)
+        private void addContentToResultsArea(Drawable content)
         {
             Loading.Hide();
             lastFetchDisplayedTime = Time.Current;

From ef9f56e5850b2d76fc960b7b070a0c9b08601140 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 3 Jan 2022 19:33:01 +0100
Subject: [PATCH 1899/5547] Fix bad check if content is placeholder

The `lastContent == foundContent` check, last touched in a49a4329, is
terminally broken, as it would always be false. `foundContent` is
mutated when a new card load task is started in `onSearchFinished()`,
which is *before* the aforementioned check.

The code prior to a49a4329 was checking against the two static reused
placeholder drawables which was the correct check to apply, and this
commit reverts to using a variant of that check.
---
 osu.Game/Overlays/BeatmapListingOverlay.cs | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/BeatmapListingOverlay.cs b/osu.Game/Overlays/BeatmapListingOverlay.cs
index d9c2d90e05..ea3c08ea61 100644
--- a/osu.Game/Overlays/BeatmapListingOverlay.cs
+++ b/osu.Game/Overlays/BeatmapListingOverlay.cs
@@ -212,7 +212,7 @@ namespace osu.Game.Overlays
                 // To resolve both of these issues, the bypass is delayed until a point when the content transitions (fade-in and fade-out) overlap and it looks good to do so.
                 var sequence = lastContent.Delay(25).Schedule(() => lastContent.BypassAutoSizeAxes = Axes.Y);
 
-                if (lastContent == foundContent)
+                if (!isPlaceholderContent(lastContent))
                 {
                     sequence.Then().Schedule(() =>
                     {
@@ -232,6 +232,12 @@ namespace osu.Game.Overlays
             currentContent.BypassAutoSizeAxes = Axes.None;
         }
 
+        /// <summary>
+        /// Whether <paramref name="drawable"/> is a static placeholder reused multiple times by this overlay.
+        /// </summary>
+        private bool isPlaceholderContent(Drawable drawable)
+            => drawable == notFoundContent || drawable == supporterRequiredContent;
+
         private void onCardSizeChanged()
         {
             if (foundContent == null || !foundContent.Any())

From 6650a468e0d7d7a010c16093ce5450d5ae08d6a2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 3 Jan 2022 19:39:07 +0100
Subject: [PATCH 1900/5547] Fix and simplify very broken beatmap listing
 content swap-out logic

The beatmap listing content swap-out logic was already a source of
several problems, and several attempts of fixing it were made. But as it
turns out it was terminally broken in several aspects.

* The `BypassAutoSizeAxes` juggling was finicky and ugly, and didn't
  really look much different than an instant fade. Therefore, all fade
  durations and manipulations of `BypassAutoSizeAxes` are removed.

* The transform sequence juggling the `BypassAutoSizeAxes` manipulations
  was enqueued on the content which is being in the process of fading
  out. That was partially fixed in 25e38560, but as it turns out, that
  only works if `lastContent` is one of the two placeholder drawables
  (results not found / supporter required to use filter).

  It would not work if `lastContent` is a
  `ReverseChildIDFillFlowContainer` with cards from a previous search in
  it.
---
 osu.Game/Overlays/BeatmapListingOverlay.cs | 30 +++-------------------
 1 file changed, 3 insertions(+), 27 deletions(-)

diff --git a/osu.Game/Overlays/BeatmapListingOverlay.cs b/osu.Game/Overlays/BeatmapListingOverlay.cs
index ea3c08ea61..55a99d21ef 100644
--- a/osu.Game/Overlays/BeatmapListingOverlay.cs
+++ b/osu.Game/Overlays/BeatmapListingOverlay.cs
@@ -204,32 +204,16 @@ namespace osu.Game.Overlays
 
             if (lastContent != null)
             {
-                lastContent.FadeOut(100, Easing.OutQuint);
-
-                // Consider the case when the new content is smaller than the last content.
-                // If the auto-size computation is delayed until fade out completes, the background remain high for too long making the resulting transition to the smaller height look weird.
-                // At the same time, if the last content's height is bypassed immediately, there is a period where the new content is at Alpha = 0 when the auto-sized height will be 0.
-                // To resolve both of these issues, the bypass is delayed until a point when the content transitions (fade-in and fade-out) overlap and it looks good to do so.
-                var sequence = lastContent.Delay(25).Schedule(() => lastContent.BypassAutoSizeAxes = Axes.Y);
-
+                lastContent.FadeOut();
                 if (!isPlaceholderContent(lastContent))
-                {
-                    sequence.Then().Schedule(() =>
-                    {
-                        foundContent.Expire();
-                        foundContent = null;
-                    });
-                }
+                    lastContent.Expire();
             }
 
             if (!content.IsAlive)
                 panelTarget.Add(content);
 
-            content.FadeInFromZero(200, Easing.OutQuint);
+            content.FadeInFromZero();
             currentContent = content;
-            // currentContent may be one of the placeholders, and still have BypassAutoSizeAxes set to Y from the last fade-out.
-            // restore to the initial state.
-            currentContent.BypassAutoSizeAxes = Axes.None;
         }
 
         /// <summary>
@@ -265,10 +249,6 @@ namespace osu.Game.Overlays
 
         public class NotFoundDrawable : CompositeDrawable
         {
-            // required for scheduled tasks to complete correctly
-            // (see `addContentToPlaceholder()` and the scheduled `BypassAutoSizeAxes` set during fade-out in outer class above)
-            public override bool IsPresent => base.IsPresent || Scheduler.HasPendingTasks;
-
             public NotFoundDrawable()
             {
                 RelativeSizeAxes = Axes.X;
@@ -313,10 +293,6 @@ namespace osu.Game.Overlays
         // (https://github.com/ppy/osu-framework/issues/4530)
         public class SupporterRequiredDrawable : CompositeDrawable
         {
-            // required for scheduled tasks to complete correctly
-            // (see `addContentToPlaceholder()` and the scheduled `BypassAutoSizeAxes` set during fade-out in outer class above)
-            public override bool IsPresent => base.IsPresent || Scheduler.HasPendingTasks;
-
             private LinkFlowContainer supporterRequiredText;
 
             public SupporterRequiredDrawable()

From 586f158920b011233fba348d500cfb7c0265da11 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 3 Jan 2022 19:52:42 +0100
Subject: [PATCH 1901/5547] Remove initial `foundContent` value

It always is replaced on the first search anyway, and just remains
forever in the overlay otherwise.
---
 osu.Game/Overlays/BeatmapListingOverlay.cs | 1 -
 1 file changed, 1 deletion(-)

diff --git a/osu.Game/Overlays/BeatmapListingOverlay.cs b/osu.Game/Overlays/BeatmapListingOverlay.cs
index 55a99d21ef..c2f2c1dec2 100644
--- a/osu.Game/Overlays/BeatmapListingOverlay.cs
+++ b/osu.Game/Overlays/BeatmapListingOverlay.cs
@@ -79,7 +79,6 @@ namespace osu.Game.Overlays
                                 Padding = new MarginPadding { Horizontal = 20 },
                                 Children = new Drawable[]
                                 {
-                                    foundContent = new FillFlowContainer<BeatmapCard>(),
                                     notFoundContent = new NotFoundDrawable(),
                                     supporterRequiredContent = new SupporterRequiredDrawable(),
                                 }

From de33b420abb157bf7c6e62edbc18d1a720bea82f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 3 Jan 2022 20:02:46 +0100
Subject: [PATCH 1902/5547] Add safety against performing operation on
 non-alive `foundContent`

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

diff --git a/osu.Game/Overlays/BeatmapListingOverlay.cs b/osu.Game/Overlays/BeatmapListingOverlay.cs
index c2f2c1dec2..b5b12391e8 100644
--- a/osu.Game/Overlays/BeatmapListingOverlay.cs
+++ b/osu.Game/Overlays/BeatmapListingOverlay.cs
@@ -223,7 +223,7 @@ namespace osu.Game.Overlays
 
         private void onCardSizeChanged()
         {
-            if (foundContent == null || !foundContent.Any())
+            if (foundContent?.IsAlive != true || !foundContent.Any())
                 return;
 
             Loading.Show();

From 7cdba2f7c3a915f8f8d8c9996d8689c1ecb4d399 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 3 Jan 2022 21:50:00 +0100
Subject: [PATCH 1903/5547] Add test coverage of score submission if player is
 exited during import

---
 .../TestScenePlayerScoreSubmission.cs         | 44 ++++++++++++++++---
 1 file changed, 38 insertions(+), 6 deletions(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestScenePlayerScoreSubmission.cs b/osu.Game.Tests/Visual/Gameplay/TestScenePlayerScoreSubmission.cs
index 324a132120..25808d307d 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestScenePlayerScoreSubmission.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestScenePlayerScoreSubmission.cs
@@ -3,6 +3,7 @@
 
 using System;
 using System.Linq;
+using System.Threading;
 using System.Threading.Tasks;
 using NUnit.Framework;
 using osu.Framework.Screens;
@@ -36,7 +37,9 @@ namespace osu.Game.Tests.Visual.Gameplay
 
         protected override bool HasCustomSteps => true;
 
-        protected override TestPlayer CreatePlayer(Ruleset ruleset) => new NonImportingPlayer(false);
+        protected override TestPlayer CreatePlayer(Ruleset ruleset) => new FakeImportingPlayer(false);
+
+        protected new FakeImportingPlayer Player => (FakeImportingPlayer)base.Player;
 
         protected override Ruleset CreatePlayerRuleset() => createCustomRuleset?.Invoke() ?? new OsuRuleset();
 
@@ -207,6 +210,25 @@ namespace osu.Game.Tests.Visual.Gameplay
             AddAssert("ensure failing submission", () => Player.SubmittedScore?.ScoreInfo.Passed == false);
         }
 
+        [Test]
+        public void TestSubmissionOnExitDuringImport()
+        {
+            prepareTokenResponse(true);
+
+            createPlayerTest();
+            AddStep("block imports", () => Player.AllowImportCompletion.Wait());
+
+            AddUntilStep("wait for token request", () => Player.TokenCreationRequested);
+
+            addFakeHit();
+
+            AddUntilStep("wait for import to start", () => Player.ScoreImportStarted);
+
+            AddStep("exit", () => Player.Exit());
+            AddStep("allow import to proceed", () => Player.AllowImportCompletion.Release(1));
+            AddAssert("ensure submission", () => Player.SubmittedScore != null && Player.ImportedScore != null);
+        }
+
         [Test]
         public void TestNoSubmissionOnLocalBeatmap()
         {
@@ -288,15 +310,26 @@ namespace osu.Game.Tests.Visual.Gameplay
             });
         }
 
-        private class NonImportingPlayer : TestPlayer
+        protected class FakeImportingPlayer : TestPlayer
         {
-            public NonImportingPlayer(bool allowPause = true, bool showResults = true, bool pauseOnFocusLost = false)
+            public bool ScoreImportStarted { get; set; }
+            public SemaphoreSlim AllowImportCompletion { get; }
+            public Score ImportedScore { get; private set; }
+
+            public FakeImportingPlayer(bool allowPause = true, bool showResults = true, bool pauseOnFocusLost = false)
                 : base(allowPause, showResults, pauseOnFocusLost)
             {
+                AllowImportCompletion = new SemaphoreSlim(1);
             }
 
-            protected override Task ImportScore(Score score)
+            protected override async Task ImportScore(Score score)
             {
+                ScoreImportStarted = true;
+
+                await AllowImportCompletion.WaitAsync().ConfigureAwait(false);
+
+                ImportedScore = score;
+
                 // It was discovered that Score members could sometimes be half-populated.
                 // In particular, the RulesetID property could be set to 0 even on non-osu! maps.
                 // We want to test that the state of that property is consistent in this test.
@@ -311,8 +344,7 @@ namespace osu.Game.Tests.Visual.Gameplay
                 // In the above instance, if a ScoreInfo with Ruleset = {mania} and RulesetID = 0 is attached to an EF context,
                 // RulesetID WILL BE SILENTLY SET TO THE CORRECT VALUE of 3.
                 //
-                // For the above reasons, importing is disabled in this test.
-                return Task.CompletedTask;
+                // For the above reasons, actual importing is disabled in this test.
             }
         }
     }

From 031a40af6af42db5f3876e2a369c054590c9a563 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 3 Jan 2022 17:02:15 +0900
Subject: [PATCH 1904/5547] Replace usages of `Wait` with `WaitSafely`

---
 CodeAnalysis/BannedSymbols.txt                |  1 +
 .../Collections/IO/ImportCollectionsTest.cs   |  3 ++-
 osu.Game.Tests/Database/RealmLiveTests.cs     | 19 ++++++++++---------
 osu.Game.Tests/ImportTest.cs                  |  3 ++-
 ...eneOnlinePlayBeatmapAvailabilityTracker.cs |  8 ++++----
 .../Background/TestSceneUserDimBackgrounds.cs |  3 ++-
 .../TestSceneManageCollectionsDialog.cs       |  3 ++-
 .../Menus/TestSceneMusicActionHandling.cs     |  3 ++-
 .../Visual/Multiplayer/QueueModeTestScene.cs  |  3 ++-
 .../TestSceneDrawableRoomPlaylist.cs          |  3 ++-
 .../Multiplayer/TestSceneMultiplayer.cs       |  5 +++--
 .../TestSceneMultiplayerMatchSongSelect.cs    |  2 +-
 .../TestSceneMultiplayerMatchSubScreen.cs     |  3 ++-
 .../TestSceneMultiplayerPlaylist.cs           |  3 ++-
 .../TestSceneMultiplayerQueueList.cs          |  3 ++-
 .../TestSceneMultiplayerReadyButton.cs        |  3 ++-
 .../TestSceneMultiplayerSpectateButton.cs     |  3 ++-
 .../TestScenePlaylistsSongSelect.cs           |  3 ++-
 .../Visual/Multiplayer/TestSceneTeamVersus.cs |  3 ++-
 .../TestSceneMouseWheelVolumeAdjust.cs        |  3 ++-
 .../Navigation/TestScenePerformFromScreen.cs  |  3 ++-
 .../Navigation/TestSceneScreenNavigation.cs   |  7 ++++---
 .../TestScenePlaylistsRoomCreation.cs         |  5 +++--
 .../SongSelect/TestSceneBeatmapLeaderboard.cs |  5 +++--
 .../SongSelect/TestSceneFilterControl.cs      |  3 ++-
 .../SongSelect/TestScenePlaySongSelect.cs     | 11 ++++++-----
 osu.Game/Screens/Play/SubmittingPlayer.cs     |  3 ++-
 .../Multiplayer/TestMultiplayerClient.cs      |  9 +++++----
 28 files changed, 76 insertions(+), 50 deletions(-)

diff --git a/CodeAnalysis/BannedSymbols.txt b/CodeAnalysis/BannedSymbols.txt
index c567adc0ae..2048714cb3 100644
--- a/CodeAnalysis/BannedSymbols.txt
+++ b/CodeAnalysis/BannedSymbols.txt
@@ -13,3 +13,4 @@ M:System.Enum.HasFlag(System.Enum);Use osu.Framework.Extensions.EnumExtensions.H
 M:Realms.IRealmCollection`1.SubscribeForNotifications`1(Realms.NotificationCallbackDelegate{``0});Use osu.Game.Database.RealmObjectExtensions.QueryAsyncWithNotifications(IRealmCollection<T>,NotificationCallbackDelegate<T>) instead.
 M:Realms.CollectionExtensions.SubscribeForNotifications`1(System.Linq.IQueryable{``0},Realms.NotificationCallbackDelegate{``0});Use osu.Game.Database.RealmObjectExtensions.QueryAsyncWithNotifications(IQueryable<T>,NotificationCallbackDelegate<T>) instead.
 M:Realms.CollectionExtensions.SubscribeForNotifications`1(System.Collections.Generic.IList{``0},Realms.NotificationCallbackDelegate{``0});Use osu.Game.Database.RealmObjectExtensions.QueryAsyncWithNotifications(IList<T>,NotificationCallbackDelegate<T>) instead.
+M:System.Threading.Tasks.Task.Wait();Don't use Task.Wait. Use Task.WaitSafely() to ensure we avoid deadlocks.
diff --git a/osu.Game.Tests/Collections/IO/ImportCollectionsTest.cs b/osu.Game.Tests/Collections/IO/ImportCollectionsTest.cs
index d4ec5e897b..53e4ef07e7 100644
--- a/osu.Game.Tests/Collections/IO/ImportCollectionsTest.cs
+++ b/osu.Game.Tests/Collections/IO/ImportCollectionsTest.cs
@@ -6,6 +6,7 @@ using System.IO;
 using System.Text;
 using System.Threading.Tasks;
 using NUnit.Framework;
+using osu.Framework.Extensions;
 using osu.Framework.Platform;
 using osu.Framework.Testing;
 using osu.Game.Tests.Resources;
@@ -179,7 +180,7 @@ namespace osu.Game.Tests.Collections.IO
         {
             // intentionally spin this up on a separate task to avoid disposal deadlocks.
             // see https://github.com/EventStore/EventStore/issues/1179
-            await Task.Run(() => osu.CollectionManager.Import(stream).Wait());
+            await Task.Factory.StartNew(() => osu.CollectionManager.Import(stream).WaitSafely(), TaskCreationOptions.LongRunning);
         }
     }
 }
diff --git a/osu.Game.Tests/Database/RealmLiveTests.cs b/osu.Game.Tests/Database/RealmLiveTests.cs
index 06cb5a3607..9432a56741 100644
--- a/osu.Game.Tests/Database/RealmLiveTests.cs
+++ b/osu.Game.Tests/Database/RealmLiveTests.cs
@@ -6,6 +6,7 @@ using System.Diagnostics;
 using System.Linq;
 using System.Threading.Tasks;
 using NUnit.Framework;
+using osu.Framework.Extensions;
 using osu.Framework.Testing;
 using osu.Game.Database;
 using osu.Game.Models;
@@ -104,7 +105,7 @@ namespace osu.Game.Tests.Database
 
                         liveBeatmap = beatmap.ToLive(realmFactory);
                     }
-                }, TaskCreationOptions.LongRunning | TaskCreationOptions.HideScheduler).Wait();
+                }, TaskCreationOptions.LongRunning | TaskCreationOptions.HideScheduler).WaitSafely();
 
                 Debug.Assert(liveBeatmap != null);
 
@@ -115,7 +116,7 @@ namespace osu.Game.Tests.Database
                         Assert.IsTrue(beatmap.IsValid);
                         Assert.IsFalse(beatmap.Hidden);
                     });
-                }, TaskCreationOptions.LongRunning | TaskCreationOptions.HideScheduler).Wait();
+                }, TaskCreationOptions.LongRunning | TaskCreationOptions.HideScheduler).WaitSafely();
             });
         }
 
@@ -133,7 +134,7 @@ namespace osu.Game.Tests.Database
 
                         liveBeatmap = beatmap.ToLive(realmFactory);
                     }
-                }, TaskCreationOptions.LongRunning | TaskCreationOptions.HideScheduler).Wait();
+                }, TaskCreationOptions.LongRunning | TaskCreationOptions.HideScheduler).WaitSafely();
 
                 Debug.Assert(liveBeatmap != null);
 
@@ -141,7 +142,7 @@ namespace osu.Game.Tests.Database
                 {
                     liveBeatmap.PerformWrite(beatmap => { beatmap.Hidden = true; });
                     liveBeatmap.PerformRead(beatmap => { Assert.IsTrue(beatmap.Hidden); });
-                }, TaskCreationOptions.LongRunning | TaskCreationOptions.HideScheduler).Wait();
+                }, TaskCreationOptions.LongRunning | TaskCreationOptions.HideScheduler).WaitSafely();
             });
         }
 
@@ -175,7 +176,7 @@ namespace osu.Game.Tests.Database
 
                         liveBeatmap = beatmap.ToLive(realmFactory);
                     }
-                }, TaskCreationOptions.LongRunning | TaskCreationOptions.HideScheduler).Wait();
+                }, TaskCreationOptions.LongRunning | TaskCreationOptions.HideScheduler).WaitSafely();
 
                 Debug.Assert(liveBeatmap != null);
 
@@ -195,7 +196,7 @@ namespace osu.Game.Tests.Database
                             var __ = liveBeatmap.Value;
                         });
                     }
-                }, TaskCreationOptions.LongRunning | TaskCreationOptions.HideScheduler).Wait();
+                }, TaskCreationOptions.LongRunning | TaskCreationOptions.HideScheduler).WaitSafely();
             });
         }
 
@@ -213,7 +214,7 @@ namespace osu.Game.Tests.Database
 
                         liveBeatmap = beatmap.ToLive(realmFactory);
                     }
-                }, TaskCreationOptions.LongRunning | TaskCreationOptions.HideScheduler).Wait();
+                }, TaskCreationOptions.LongRunning | TaskCreationOptions.HideScheduler).WaitSafely();
 
                 Debug.Assert(liveBeatmap != null);
 
@@ -223,7 +224,7 @@ namespace osu.Game.Tests.Database
                     {
                         var unused = liveBeatmap.Value;
                     });
-                }, TaskCreationOptions.LongRunning | TaskCreationOptions.HideScheduler).Wait();
+                }, TaskCreationOptions.LongRunning | TaskCreationOptions.HideScheduler).WaitSafely();
             });
         }
 
@@ -252,7 +253,7 @@ namespace osu.Game.Tests.Database
 
                             liveBeatmap = beatmap.ToLive(realmFactory);
                         }
-                    }, TaskCreationOptions.LongRunning | TaskCreationOptions.HideScheduler).Wait();
+                    }, TaskCreationOptions.LongRunning | TaskCreationOptions.HideScheduler).WaitSafely();
 
                     Debug.Assert(liveBeatmap != null);
 
diff --git a/osu.Game.Tests/ImportTest.cs b/osu.Game.Tests/ImportTest.cs
index dbeb453d4d..a658a0eaeb 100644
--- a/osu.Game.Tests/ImportTest.cs
+++ b/osu.Game.Tests/ImportTest.cs
@@ -6,6 +6,7 @@ using System.Threading;
 using System.Threading.Tasks;
 using NUnit.Framework;
 using osu.Framework.Allocation;
+using osu.Framework.Extensions;
 using osu.Framework.Platform;
 using osu.Game.Collections;
 using osu.Game.Tests.Resources;
@@ -58,7 +59,7 @@ namespace osu.Game.Tests
             {
                 // Beatmap must be imported before the collection manager is loaded.
                 if (withBeatmap)
-                    BeatmapManager.Import(TestResources.GetTestBeatmapForImport()).Wait();
+                    BeatmapManager.Import(TestResources.GetTestBeatmapForImport()).WaitSafely();
 
                 AddInternal(CollectionManager = new CollectionManager(Storage));
             }
diff --git a/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs b/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
index 239c787349..a7b431fb6e 100644
--- a/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
+++ b/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
@@ -100,7 +100,7 @@ namespace osu.Game.Tests.Online
         public void TestTrackerRespectsSoftDeleting()
         {
             AddStep("allow importing", () => beatmaps.AllowImport.SetResult(true));
-            AddStep("import beatmap", () => beatmaps.Import(testBeatmapFile).Wait());
+            AddStep("import beatmap", () => beatmaps.Import(testBeatmapFile).WaitSafely());
             addAvailabilityCheckStep("state locally available", BeatmapAvailability.LocallyAvailable);
 
             AddStep("delete beatmap", () => beatmaps.Delete(beatmaps.QueryBeatmapSet(b => b.OnlineID == testBeatmapSet.OnlineID)));
@@ -114,12 +114,12 @@ namespace osu.Game.Tests.Online
         public void TestTrackerRespectsChecksum()
         {
             AddStep("allow importing", () => beatmaps.AllowImport.SetResult(true));
-            AddStep("import beatmap", () => beatmaps.Import(testBeatmapFile).Wait());
+            AddStep("import beatmap", () => beatmaps.Import(testBeatmapFile).WaitSafely());
             addAvailabilityCheckStep("initially locally available", BeatmapAvailability.LocallyAvailable);
 
             AddStep("import altered beatmap", () =>
             {
-                beatmaps.Import(TestResources.GetTestBeatmapForImport(true)).Wait();
+                beatmaps.Import(TestResources.GetTestBeatmapForImport(true)).WaitSafely();
             });
             addAvailabilityCheckStep("state not downloaded", BeatmapAvailability.NotDownloaded);
 
@@ -129,7 +129,7 @@ namespace osu.Game.Tests.Online
             });
             addAvailabilityCheckStep("state not downloaded as well", BeatmapAvailability.NotDownloaded);
 
-            AddStep("reimport original beatmap", () => beatmaps.Import(TestResources.GetQuickTestBeatmapForImport()).Wait());
+            AddStep("reimport original beatmap", () => beatmaps.Import(TestResources.GetQuickTestBeatmapForImport()).WaitSafely());
             addAvailabilityCheckStep("locally available after re-import", BeatmapAvailability.LocallyAvailable);
         }
 
diff --git a/osu.Game.Tests/Visual/Background/TestSceneUserDimBackgrounds.cs b/osu.Game.Tests/Visual/Background/TestSceneUserDimBackgrounds.cs
index 33b1d9a67d..54c5c252c0 100644
--- a/osu.Game.Tests/Visual/Background/TestSceneUserDimBackgrounds.cs
+++ b/osu.Game.Tests/Visual/Background/TestSceneUserDimBackgrounds.cs
@@ -7,6 +7,7 @@ using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
 using osu.Framework.Bindables;
+using osu.Framework.Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Input.Events;
@@ -49,7 +50,7 @@ namespace osu.Game.Tests.Visual.Background
             Dependencies.Cache(manager = new BeatmapManager(LocalStorage, ContextFactory, rulesets, null, audio, Resources, host, Beatmap.Default));
             Dependencies.Cache(new OsuConfigManager(LocalStorage));
 
-            manager.Import(TestResources.GetQuickTestBeatmapForImport()).Wait();
+            manager.Import(TestResources.GetQuickTestBeatmapForImport()).WaitSafely();
 
             Beatmap.SetDefault();
         }
diff --git a/osu.Game.Tests/Visual/Collections/TestSceneManageCollectionsDialog.cs b/osu.Game.Tests/Visual/Collections/TestSceneManageCollectionsDialog.cs
index 28218ea220..d2b0f7324b 100644
--- a/osu.Game.Tests/Visual/Collections/TestSceneManageCollectionsDialog.cs
+++ b/osu.Game.Tests/Visual/Collections/TestSceneManageCollectionsDialog.cs
@@ -4,6 +4,7 @@
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
+using osu.Framework.Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.UserInterface;
@@ -38,7 +39,7 @@ namespace osu.Game.Tests.Visual.Collections
             Dependencies.Cache(rulesets = new RulesetStore(ContextFactory));
             Dependencies.Cache(beatmapManager = new BeatmapManager(LocalStorage, ContextFactory, rulesets, null, Audio, Resources, host, Beatmap.Default));
 
-            beatmapManager.Import(TestResources.GetQuickTestBeatmapForImport()).Wait();
+            beatmapManager.Import(TestResources.GetQuickTestBeatmapForImport()).WaitSafely();
 
             base.Content.AddRange(new Drawable[]
             {
diff --git a/osu.Game.Tests/Visual/Menus/TestSceneMusicActionHandling.cs b/osu.Game.Tests/Visual/Menus/TestSceneMusicActionHandling.cs
index 55e453c3d3..425e7718dc 100644
--- a/osu.Game.Tests/Visual/Menus/TestSceneMusicActionHandling.cs
+++ b/osu.Game.Tests/Visual/Menus/TestSceneMusicActionHandling.cs
@@ -4,6 +4,7 @@
 using System.Collections.Generic;
 using System.Linq;
 using NUnit.Framework;
+using osu.Framework.Extensions;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
 using osu.Game.Database;
@@ -33,7 +34,7 @@ namespace osu.Game.Tests.Visual.Menus
             Queue<(IWorkingBeatmap working, TrackChangeDirection changeDirection)> trackChangeQueue = null;
 
             // ensure we have at least two beatmaps available to identify the direction the music controller navigated to.
-            AddRepeatStep("import beatmap", () => Game.BeatmapManager.Import(TestResources.CreateTestBeatmapSetInfo()).Wait(), 5);
+            AddRepeatStep("import beatmap", () => Game.BeatmapManager.Import(TestResources.CreateTestBeatmapSetInfo()).WaitSafely(), 5);
 
             AddStep("import beatmap with track", () =>
             {
diff --git a/osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs b/osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs
index 88c54eb2bb..c4d7bd7e6a 100644
--- a/osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs
@@ -5,6 +5,7 @@ using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
+using osu.Framework.Extensions;
 using osu.Framework.Platform;
 using osu.Framework.Screens;
 using osu.Framework.Testing;
@@ -56,7 +57,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             AddStep("import beatmap", () =>
             {
-                beatmaps.Import(TestResources.GetQuickTestBeatmapForImport()).Wait();
+                beatmaps.Import(TestResources.GetQuickTestBeatmapForImport()).WaitSafely();
                 importedSet = beatmaps.GetAllUsableBeatmapSetsEnumerable(IncludedDetails.All).First();
                 InitialBeatmap = importedSet.Beatmaps.First(b => b.RulesetID == 0);
                 OtherBeatmap = importedSet.Beatmaps.Last(b => b.RulesetID == 0);
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
index f9784384fd..147bbf2626 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
@@ -8,6 +8,7 @@ using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
+using osu.Framework.Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Platform;
@@ -153,7 +154,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             var beatmap = new TestBeatmap(new OsuRuleset().RulesetInfo).BeatmapInfo;
 
-            AddStep("import beatmap", () => manager.Import(beatmap.BeatmapSet).Wait());
+            AddStep("import beatmap", () => manager.Import(beatmap.BeatmapSet).WaitSafely());
 
             createPlaylistWithBeatmaps(beatmap);
 
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
index 4eebda94e9..24fc3ac5b9 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
@@ -7,6 +7,7 @@ using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
+using osu.Framework.Extensions;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.UserInterface;
 using osu.Framework.Input;
@@ -67,7 +68,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             AddStep("import beatmap", () =>
             {
-                beatmaps.Import(TestResources.GetQuickTestBeatmapForImport()).Wait();
+                beatmaps.Import(TestResources.GetQuickTestBeatmapForImport()).WaitSafely();
                 importedSet = beatmaps.GetAllUsableBeatmapSetsEnumerable(IncludedDetails.All).First();
             });
 
@@ -505,7 +506,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             AddStep("restore beatmap", () =>
             {
-                beatmaps.Import(TestResources.GetQuickTestBeatmapForImport()).Wait();
+                beatmaps.Import(TestResources.GetQuickTestBeatmapForImport()).WaitSafely();
                 importedSet = beatmaps.GetAllUsableBeatmapSetsEnumerable(IncludedDetails.All).First();
             });
 
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs
index d671673d3c..bd4b38b9c0 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs
@@ -83,7 +83,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 beatmapSetInfo.Beatmaps.Add(beatmap);
             }
 
-            manager.Import(beatmapSetInfo).Wait();
+            manager.Import(beatmapSetInfo).WaitSafely();
         }
 
         public override void SetUpSteps()
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs
index 55430fbb41..52e46ef5af 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs
@@ -5,6 +5,7 @@ using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
+using osu.Framework.Extensions;
 using osu.Framework.Platform;
 using osu.Framework.Screens;
 using osu.Framework.Testing;
@@ -39,7 +40,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             Dependencies.Cache(rulesets = new RulesetStore(ContextFactory));
             Dependencies.Cache(beatmaps = new BeatmapManager(LocalStorage, ContextFactory, rulesets, null, audio, Resources, host, Beatmap.Default));
-            beatmaps.Import(TestResources.GetQuickTestBeatmapForImport()).Wait();
+            beatmaps.Import(TestResources.GetQuickTestBeatmapForImport()).WaitSafely();
 
             importedSet = beatmaps.GetAllUsableBeatmapSetsEnumerable(IncludedDetails.All).First();
         }
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs
index 7760661232..464c0ea5b6 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs
@@ -6,6 +6,7 @@ using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
+using osu.Framework.Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Platform;
 using osu.Framework.Testing;
@@ -53,7 +54,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             AddStep("import beatmap", () =>
             {
-                beatmaps.Import(TestResources.GetQuickTestBeatmapForImport()).Wait();
+                beatmaps.Import(TestResources.GetQuickTestBeatmapForImport()).WaitSafely();
                 importedSet = beatmaps.GetAllUsableBeatmapSetsEnumerable(IncludedDetails.All).First();
                 importedBeatmap = importedSet.Beatmaps.First(b => b.RulesetID == 0);
             });
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs
index 1a646d5e7e..29daff546d 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs
@@ -6,6 +6,7 @@ using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
+using osu.Framework.Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Platform;
@@ -58,7 +59,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             AddStep("import beatmap", () =>
             {
-                beatmaps.Import(TestResources.GetQuickTestBeatmapForImport()).Wait();
+                beatmaps.Import(TestResources.GetQuickTestBeatmapForImport()).WaitSafely();
                 importedSet = beatmaps.GetAllUsableBeatmapSetsEnumerable(IncludedDetails.All).First();
                 importedBeatmap = importedSet.Beatmaps.First(b => b.RulesetID == 0);
             });
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs
index 93be28ad90..8f51b1e381 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs
@@ -8,6 +8,7 @@ using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
 using osu.Framework.Bindables;
+using osu.Framework.Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Platform;
 using osu.Framework.Testing;
@@ -41,7 +42,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             Dependencies.Cache(rulesets = new RulesetStore(ContextFactory));
             Dependencies.Cache(beatmaps = new BeatmapManager(LocalStorage, ContextFactory, rulesets, null, audio, Resources, host, Beatmap.Default));
-            beatmaps.Import(TestResources.GetQuickTestBeatmapForImport()).Wait();
+            beatmaps.Import(TestResources.GetQuickTestBeatmapForImport()).WaitSafely();
         }
 
         [SetUp]
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerSpectateButton.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerSpectateButton.cs
index eecf0dff9f..d4ff9f8c41 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerSpectateButton.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerSpectateButton.cs
@@ -8,6 +8,7 @@ using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
 using osu.Framework.Bindables;
+using osu.Framework.Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Platform;
@@ -42,7 +43,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             Dependencies.Cache(rulesets = new RulesetStore(ContextFactory));
             Dependencies.Cache(beatmaps = new BeatmapManager(LocalStorage, ContextFactory, rulesets, null, audio, Resources, host, Beatmap.Default));
-            beatmaps.Import(TestResources.GetQuickTestBeatmapForImport()).Wait();
+            beatmaps.Import(TestResources.GetQuickTestBeatmapForImport()).WaitSafely();
         }
 
         [SetUp]
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsSongSelect.cs b/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsSongSelect.cs
index 5aac228f4b..08fcac125d 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsSongSelect.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsSongSelect.cs
@@ -6,6 +6,7 @@ using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
+using osu.Framework.Extensions;
 using osu.Framework.Platform;
 using osu.Framework.Screens;
 using osu.Framework.Utils;
@@ -38,7 +39,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             var beatmapSet = TestResources.CreateTestBeatmapSetInfo();
 
-            manager.Import(beatmapSet).Wait();
+            manager.Import(beatmapSet).WaitSafely();
         }
 
         public override void SetUpSteps()
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs
index 81c59b90f5..d20fbd3539 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs
@@ -6,6 +6,7 @@ using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
+using osu.Framework.Extensions;
 using osu.Framework.Platform;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
@@ -51,7 +52,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             AddStep("import beatmap", () =>
             {
-                beatmaps.Import(TestResources.GetQuickTestBeatmapForImport()).Wait();
+                beatmaps.Import(TestResources.GetQuickTestBeatmapForImport()).WaitSafely();
                 importedSet = beatmaps.GetAllUsableBeatmapSetsEnumerable(IncludedDetails.All).First();
             });
 
diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneMouseWheelVolumeAdjust.cs b/osu.Game.Tests/Visual/Navigation/TestSceneMouseWheelVolumeAdjust.cs
index b3b80147ca..701ab480f6 100644
--- a/osu.Game.Tests/Visual/Navigation/TestSceneMouseWheelVolumeAdjust.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneMouseWheelVolumeAdjust.cs
@@ -2,6 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using NUnit.Framework;
+using osu.Framework.Extensions;
 using osu.Game.Configuration;
 using osu.Game.Screens.Play;
 using osu.Game.Tests.Beatmaps.IO;
@@ -82,7 +83,7 @@ namespace osu.Game.Tests.Visual.Navigation
             PushAndConfirm(() => songSelect = new TestSceneScreenNavigation.TestPlaySongSelect());
             AddUntilStep("wait for song select", () => songSelect.BeatmapSetsLoaded);
 
-            AddStep("import beatmap", () => ImportBeatmapTest.LoadOszIntoOsu(Game, virtualTrack: true).Wait());
+            AddStep("import beatmap", () => ImportBeatmapTest.LoadOszIntoOsu(Game, virtualTrack: true).WaitSafely());
             AddUntilStep("wait for selected", () => !Game.Beatmap.IsDefault);
             AddStep("press enter", () => InputManager.Key(Key.Enter));
 
diff --git a/osu.Game.Tests/Visual/Navigation/TestScenePerformFromScreen.cs b/osu.Game.Tests/Visual/Navigation/TestScenePerformFromScreen.cs
index 4e1b3bb9bf..24f5808961 100644
--- a/osu.Game.Tests/Visual/Navigation/TestScenePerformFromScreen.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestScenePerformFromScreen.cs
@@ -4,6 +4,7 @@
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
+using osu.Framework.Extensions;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Screens;
 using osu.Framework.Testing;
@@ -172,7 +173,7 @@ namespace osu.Game.Tests.Visual.Navigation
 
         private void importAndWaitForSongSelect()
         {
-            AddStep("import beatmap", () => ImportBeatmapTest.LoadQuickOszIntoOsu(Game).Wait());
+            AddStep("import beatmap", () => ImportBeatmapTest.LoadQuickOszIntoOsu(Game).WaitSafely());
             PushAndConfirm(() => new TestPlaySongSelect());
             AddUntilStep("beatmap updated", () => Game.Beatmap.Value.BeatmapSetInfo.OnlineID == 241526);
         }
diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs b/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
index 75d8e62ca7..d094d8b688 100644
--- a/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
@@ -4,6 +4,7 @@
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
+using osu.Framework.Extensions;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Screens;
 using osu.Framework.Testing;
@@ -70,7 +71,7 @@ namespace osu.Game.Tests.Visual.Navigation
             PushAndConfirm(() => songSelect = new TestPlaySongSelect());
             AddUntilStep("wait for song select", () => songSelect.BeatmapSetsLoaded);
 
-            AddStep("import beatmap", () => ImportBeatmapTest.LoadQuickOszIntoOsu(Game).Wait());
+            AddStep("import beatmap", () => ImportBeatmapTest.LoadQuickOszIntoOsu(Game).WaitSafely());
 
             AddUntilStep("wait for selected", () => !Game.Beatmap.IsDefault);
 
@@ -104,7 +105,7 @@ namespace osu.Game.Tests.Visual.Navigation
             PushAndConfirm(() => songSelect = new TestPlaySongSelect());
             AddUntilStep("wait for song select", () => songSelect.BeatmapSetsLoaded);
 
-            AddStep("import beatmap", () => ImportBeatmapTest.LoadQuickOszIntoOsu(Game).Wait());
+            AddStep("import beatmap", () => ImportBeatmapTest.LoadQuickOszIntoOsu(Game).WaitSafely());
 
             AddUntilStep("wait for selected", () => !Game.Beatmap.IsDefault);
 
@@ -138,7 +139,7 @@ namespace osu.Game.Tests.Visual.Navigation
             PushAndConfirm(() => songSelect = new TestPlaySongSelect());
             AddUntilStep("wait for song select", () => songSelect.BeatmapSetsLoaded);
 
-            AddStep("import beatmap", () => ImportBeatmapTest.LoadOszIntoOsu(Game, virtualTrack: true).Wait());
+            AddStep("import beatmap", () => ImportBeatmapTest.LoadOszIntoOsu(Game, virtualTrack: true).WaitSafely());
 
             AddUntilStep("wait for selected", () => !Game.Beatmap.IsDefault);
 
diff --git a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs
index a426f075e1..f3d00dc076 100644
--- a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs
+++ b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs
@@ -7,6 +7,7 @@ using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
 using osu.Framework.Bindables;
+using osu.Framework.Extensions;
 using osu.Framework.Platform;
 using osu.Framework.Screens;
 using osu.Framework.Testing;
@@ -142,7 +143,7 @@ namespace osu.Game.Tests.Visual.Playlists
                 modifiedBeatmap.HitObjects.Clear();
                 modifiedBeatmap.HitObjects.Add(new HitCircle { StartTime = 5000 });
 
-                manager.Import(modifiedBeatmap.BeatmapInfo.BeatmapSet).Wait();
+                manager.Import(modifiedBeatmap.BeatmapInfo.BeatmapSet).WaitSafely();
             });
 
             // Create the room using the real beatmap values.
@@ -184,7 +185,7 @@ namespace osu.Game.Tests.Visual.Playlists
                     },
                 };
 
-                manager.Import(originalBeatmap.BeatmapInfo.BeatmapSet).Wait();
+                manager.Import(originalBeatmap.BeatmapInfo.BeatmapSet).WaitSafely();
             });
 
             AddUntilStep("match has correct beatmap", () => realHash == match.Beatmap.Value.BeatmapInfo.MD5Hash);
diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
index aa36bde030..605e03564d 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
@@ -6,6 +6,7 @@ using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
+using osu.Framework.Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Platform;
 using osu.Framework.Testing;
@@ -74,7 +75,7 @@ namespace osu.Game.Tests.Visual.SongSelect
 
             AddStep(@"Set beatmap", () =>
             {
-                beatmapManager.Import(TestResources.GetQuickTestBeatmapForImport()).Wait();
+                beatmapManager.Import(TestResources.GetQuickTestBeatmapForImport()).WaitSafely();
                 beatmapInfo = beatmapManager.GetAllUsableBeatmapSets().First().Beatmaps.First();
 
                 leaderboard.BeatmapInfo = beatmapInfo;
@@ -175,7 +176,7 @@ namespace osu.Game.Tests.Visual.SongSelect
             AddStep(@"Load new scores via manager", () =>
             {
                 foreach (var score in generateSampleScores(beatmapInfo()))
-                    scoreManager.Import(score).Wait();
+                    scoreManager.Import(score).WaitSafely();
             });
         }
 
diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneFilterControl.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneFilterControl.cs
index 0ae4e0c5dc..1ee59eccc7 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneFilterControl.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneFilterControl.cs
@@ -5,6 +5,7 @@ using System.Collections.Generic;
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
+using osu.Framework.Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Sprites;
@@ -38,7 +39,7 @@ namespace osu.Game.Tests.Visual.SongSelect
             Dependencies.Cache(rulesets = new RulesetStore(ContextFactory));
             Dependencies.Cache(beatmapManager = new BeatmapManager(LocalStorage, ContextFactory, rulesets, null, Audio, Resources, host, Beatmap.Default));
 
-            beatmapManager.Import(TestResources.GetQuickTestBeatmapForImport()).Wait();
+            beatmapManager.Import(TestResources.GetQuickTestBeatmapForImport()).WaitSafely();
 
             base.Content.AddRange(new Drawable[]
             {
diff --git a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
index 912d3f838c..bd5aeb7e08 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
@@ -8,6 +8,7 @@ using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
 using osu.Framework.Bindables;
+using osu.Framework.Extensions;
 using osu.Framework.Platform;
 using osu.Framework.Screens;
 using osu.Framework.Testing;
@@ -256,7 +257,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                 AddStep("import multi-ruleset map", () =>
                 {
                     var usableRulesets = rulesets.AvailableRulesets.Where(r => r.OnlineID != 2).ToArray();
-                    manager.Import(TestResources.CreateTestBeatmapSetInfo(rulesets: usableRulesets)).Wait();
+                    manager.Import(TestResources.CreateTestBeatmapSetInfo(rulesets: usableRulesets)).WaitSafely();
                 });
             }
             else
@@ -670,7 +671,7 @@ namespace osu.Game.Tests.Visual.SongSelect
             AddStep("import multi-ruleset map", () =>
             {
                 var usableRulesets = rulesets.AvailableRulesets.Where(r => r.OnlineID != 2).ToArray();
-                manager.Import(TestResources.CreateTestBeatmapSetInfo(3, usableRulesets)).Wait();
+                manager.Import(TestResources.CreateTestBeatmapSetInfo(3, usableRulesets)).WaitSafely();
             });
 
             int previousSetID = 0;
@@ -710,7 +711,7 @@ namespace osu.Game.Tests.Visual.SongSelect
             AddStep("import multi-ruleset map", () =>
             {
                 var usableRulesets = rulesets.AvailableRulesets.Where(r => r.OnlineID != 2).ToArray();
-                manager.Import(TestResources.CreateTestBeatmapSetInfo(3, usableRulesets)).Wait();
+                manager.Import(TestResources.CreateTestBeatmapSetInfo(3, usableRulesets)).WaitSafely();
             });
 
             DrawableCarouselBeatmapSet set = null;
@@ -868,7 +869,7 @@ namespace osu.Game.Tests.Visual.SongSelect
 
         private void addRulesetImportStep(int id) => AddStep($"import test map for ruleset {id}", () => importForRuleset(id));
 
-        private void importForRuleset(int id) => manager.Import(TestResources.CreateTestBeatmapSetInfo(3, rulesets.AvailableRulesets.Where(r => r.OnlineID == id).ToArray())).Wait();
+        private void importForRuleset(int id) => manager.Import(TestResources.CreateTestBeatmapSetInfo(3, rulesets.AvailableRulesets.Where(r => r.OnlineID == id).ToArray())).WaitSafely();
 
         private void checkMusicPlaying(bool playing) =>
             AddUntilStep($"music {(playing ? "" : "not ")}playing", () => music.IsPlaying == playing);
@@ -898,7 +899,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                 var usableRulesets = rulesets.AvailableRulesets.Where(r => r.OnlineID != 2).ToArray();
 
                 for (int i = 0; i < 10; i++)
-                    manager.Import(TestResources.CreateTestBeatmapSetInfo(difficultyCountPerSet, usableRulesets)).Wait();
+                    manager.Import(TestResources.CreateTestBeatmapSetInfo(difficultyCountPerSet, usableRulesets)).WaitSafely();
             });
         }
 
diff --git a/osu.Game/Screens/Play/SubmittingPlayer.cs b/osu.Game/Screens/Play/SubmittingPlayer.cs
index c613167908..2cf56be659 100644
--- a/osu.Game/Screens/Play/SubmittingPlayer.cs
+++ b/osu.Game/Screens/Play/SubmittingPlayer.cs
@@ -6,6 +6,7 @@ using System.Linq;
 using System.Threading.Tasks;
 using JetBrains.Annotations;
 using osu.Framework.Allocation;
+using osu.Framework.Extensions;
 using osu.Framework.Logging;
 using osu.Framework.Screens;
 using osu.Game.Online.API;
@@ -75,7 +76,7 @@ namespace osu.Game.Screens.Play
 
             api.Queue(req);
 
-            tcs.Task.Wait();
+            tcs.Task.WaitSafely();
             return true;
 
             void handleTokenFailure(Exception exception)
diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
index 571c3e759f..76acac3f8b 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
@@ -11,6 +11,7 @@ using System.Threading;
 using System.Threading.Tasks;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
+using osu.Framework.Extensions;
 using osu.Game.Beatmaps;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests.Responses;
@@ -77,7 +78,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
         private void addUser(MultiplayerRoomUser user)
         {
-            ((IMultiplayerClient)this).UserJoined(user).Wait();
+            ((IMultiplayerClient)this).UserJoined(user).WaitSafely();
 
             // We want the user to be immediately available for testing, so force a scheduler update to run the update-bound continuation.
             Scheduler.Update();
@@ -93,7 +94,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                                              .Select(team => (teamID: team.ID, userCount: Room.Users.Count(u => (u.MatchState as TeamVersusUserState)?.TeamID == team.ID)))
                                              .OrderBy(pair => pair.userCount)
                                              .First().teamID;
-                    ((IMultiplayerClient)this).MatchUserStateChanged(user.UserID, new TeamVersusUserState { TeamID = bestTeam }).Wait();
+                    ((IMultiplayerClient)this).MatchUserStateChanged(user.UserID, new TeamVersusUserState { TeamID = bestTeam }).WaitSafely();
                     break;
             }
         }
@@ -156,7 +157,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                             ChangeRoomState(MultiplayerRoomState.Open);
                             ((IMultiplayerClient)this).ResultsReady();
 
-                            FinishCurrentItem().Wait();
+                            FinishCurrentItem().WaitSafely();
                         }
 
                         break;
@@ -216,7 +217,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             Debug.Assert(Room != null);
 
             // emulate the server sending this after the join room. scheduler required to make sure the join room event is fired first (in Join).
-            changeMatchType(Room.Settings.MatchType).Wait();
+            changeMatchType(Room.Settings.MatchType).WaitSafely();
 
             RoomJoined = true;
         }

From 73b40e68337dd791c2c9bffc8c60521dd3c32958 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 3 Jan 2022 17:31:12 +0900
Subject: [PATCH 1905/5547] Replace usage of `.Result` with
 `.WaitSafelyForResult`

---
 CodeAnalysis/BannedSymbols.txt                     |  1 +
 .../Beatmaps/TestSceneBeatmapDifficultyCache.cs    |  3 ++-
 osu.Game.Tests/NonVisual/TaskChainTest.cs          | 11 ++++++-----
 osu.Game.Tests/Skins/IO/ImportSkinTest.cs          |  5 +++--
 .../Skins/TestSceneBeatmapSkinResources.cs         |  3 ++-
 osu.Game.Tests/Skins/TestSceneSkinResources.cs     |  3 ++-
 .../Visual/Editing/TestSceneDifficultySwitching.cs |  3 ++-
 .../Visual/Editing/TestSceneEditorTestGameplay.cs  |  3 ++-
 .../Gameplay/TestSceneReplayDownloadButton.cs      |  3 ++-
 .../Visual/Gameplay/TestSceneSpectator.cs          |  3 ++-
 .../Visual/Menus/TestSceneMusicActionHandling.cs   |  2 +-
 .../Multiplayer/TestSceneMultiSpectatorScreen.cs   |  3 ++-
 .../TestSceneMultiplayerGameplayLeaderboard.cs     |  5 +++--
 ...TestSceneMultiplayerGameplayLeaderboardTeams.cs |  3 ++-
 .../Visual/Navigation/TestScenePresentBeatmap.cs   |  3 ++-
 .../Visual/Navigation/TestScenePresentScore.cs     |  5 +++--
 .../Playlists/TestScenePlaylistsRoomCreation.cs    |  2 +-
 .../SongSelect/TestSceneBeatmapRecommendations.cs  |  3 ++-
 .../Visual/SongSelect/TestScenePlaySongSelect.cs   |  2 +-
 .../UserInterface/TestSceneDeleteLocalScore.cs     |  5 +++--
 .../TestSceneUpdateableBeatmapBackgroundSprite.cs  |  3 ++-
 osu.Game/Beatmaps/BeatmapDifficultyCache.cs        |  8 ++++++--
 osu.Game/Beatmaps/BeatmapManager.cs                |  3 ++-
 osu.Game/Beatmaps/WorkingBeatmap.cs                |  3 ++-
 osu.Game/Database/OnlineLookupCache.cs             |  3 ++-
 osu.Game/Online/Chat/ChannelManager.cs             |  8 ++++----
 .../Overlays/BeatmapSet/Scores/ScoresContainer.cs  |  9 ++++++---
 .../Overlays/Dashboard/CurrentlyPlayingDisplay.cs  | 11 +++++++----
 .../Settings/Sections/General/UpdateSettings.cs    |  5 +++--
 osu.Game/Scoring/ScoreManager.cs                   |  3 ++-
 osu.Game/Screens/Menu/IntroScreen.cs               |  3 ++-
 .../Play/HUD/MultiplayerGameplayLeaderboard.cs     |  7 +++++--
 .../Screens/Play/HUD/PerformancePointsCounter.cs   |  7 +++++--
 osu.Game/Screens/Play/Player.cs                    |  3 ++-
 .../Ranking/Expanded/ExpandedPanelMiddleContent.cs |  3 ++-
 .../Expanded/Statistics/PerformanceStatistic.cs    |  3 ++-
 osu.Game/Screens/Ranking/ScorePanelList.cs         |  5 +++--
 osu.Game/Screens/Select/Details/AdvancedStats.cs   | 14 +++++++++-----
 .../Select/Leaderboards/BeatmapLeaderboard.cs      |  7 ++++---
 osu.Game/Screens/Spectate/SpectatorScreen.cs       |  7 +++++--
 osu.Game/Skinning/SkinManager.cs                   |  3 ++-
 41 files changed, 121 insertions(+), 68 deletions(-)

diff --git a/CodeAnalysis/BannedSymbols.txt b/CodeAnalysis/BannedSymbols.txt
index 2048714cb3..4428656301 100644
--- a/CodeAnalysis/BannedSymbols.txt
+++ b/CodeAnalysis/BannedSymbols.txt
@@ -14,3 +14,4 @@ M:Realms.IRealmCollection`1.SubscribeForNotifications`1(Realms.NotificationCallb
 M:Realms.CollectionExtensions.SubscribeForNotifications`1(System.Linq.IQueryable{``0},Realms.NotificationCallbackDelegate{``0});Use osu.Game.Database.RealmObjectExtensions.QueryAsyncWithNotifications(IQueryable<T>,NotificationCallbackDelegate<T>) instead.
 M:Realms.CollectionExtensions.SubscribeForNotifications`1(System.Collections.Generic.IList{``0},Realms.NotificationCallbackDelegate{``0});Use osu.Game.Database.RealmObjectExtensions.QueryAsyncWithNotifications(IList<T>,NotificationCallbackDelegate<T>) instead.
 M:System.Threading.Tasks.Task.Wait();Don't use Task.Wait. Use Task.WaitSafely() to ensure we avoid deadlocks.
+P:System.Threading.Tasks.Task`1.Result;Don't use Task.Result. Use Task.WaitSafelyForResult() to ensure we avoid deadlocks.
diff --git a/osu.Game.Tests/Beatmaps/TestSceneBeatmapDifficultyCache.cs b/osu.Game.Tests/Beatmaps/TestSceneBeatmapDifficultyCache.cs
index 3a82cbc785..a97b372db0 100644
--- a/osu.Game.Tests/Beatmaps/TestSceneBeatmapDifficultyCache.cs
+++ b/osu.Game.Tests/Beatmaps/TestSceneBeatmapDifficultyCache.cs
@@ -8,6 +8,7 @@ using System.Threading.Tasks;
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
+using osu.Framework.Extensions;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets;
@@ -32,7 +33,7 @@ namespace osu.Game.Tests.Beatmaps
         [BackgroundDependencyLoader]
         private void load(OsuGameBase osu)
         {
-            importedSet = ImportBeatmapTest.LoadQuickOszIntoOsu(osu).Result;
+            importedSet = ImportBeatmapTest.LoadQuickOszIntoOsu(osu).WaitSafelyForResult();
         }
 
         [SetUpSteps]
diff --git a/osu.Game.Tests/NonVisual/TaskChainTest.cs b/osu.Game.Tests/NonVisual/TaskChainTest.cs
index d83eaafe20..db3cecf8ea 100644
--- a/osu.Game.Tests/NonVisual/TaskChainTest.cs
+++ b/osu.Game.Tests/NonVisual/TaskChainTest.cs
@@ -4,6 +4,7 @@
 using System.Threading;
 using System.Threading.Tasks;
 using NUnit.Framework;
+using osu.Framework.Extensions;
 using osu.Game.Utils;
 
 namespace osu.Game.Tests.NonVisual
@@ -42,9 +43,9 @@ namespace osu.Game.Tests.NonVisual
 
             await Task.WhenAll(task1.task, task2.task, task3.task);
 
-            Assert.That(task1.task.Result, Is.EqualTo(1));
-            Assert.That(task2.task.Result, Is.EqualTo(2));
-            Assert.That(task3.task.Result, Is.EqualTo(3));
+            Assert.That(task1.task.WaitSafelyForResult(), Is.EqualTo(1));
+            Assert.That(task2.task.WaitSafelyForResult(), Is.EqualTo(2));
+            Assert.That(task3.task.WaitSafelyForResult(), Is.EqualTo(3));
         }
 
         [Test]
@@ -68,9 +69,9 @@ namespace osu.Game.Tests.NonVisual
             // Wait on both tasks.
             await Task.WhenAll(task1.task, task3.task);
 
-            Assert.That(task1.task.Result, Is.EqualTo(1));
+            Assert.That(task1.task.WaitSafelyForResult(), Is.EqualTo(1));
             Assert.That(task2.task.IsCompleted, Is.False);
-            Assert.That(task3.task.Result, Is.EqualTo(2));
+            Assert.That(task3.task.WaitSafelyForResult(), Is.EqualTo(2));
         }
 
         [Test]
diff --git a/osu.Game.Tests/Skins/IO/ImportSkinTest.cs b/osu.Game.Tests/Skins/IO/ImportSkinTest.cs
index 40d2455106..55a50fb825 100644
--- a/osu.Game.Tests/Skins/IO/ImportSkinTest.cs
+++ b/osu.Game.Tests/Skins/IO/ImportSkinTest.cs
@@ -8,6 +8,7 @@ using System.Runtime.CompilerServices;
 using System.Threading.Tasks;
 using NUnit.Framework;
 using osu.Framework.Allocation;
+using osu.Framework.Extensions;
 using osu.Framework.Platform;
 using osu.Game.Database;
 using osu.Game.IO;
@@ -187,7 +188,7 @@ namespace osu.Game.Tests.Skins.IO
 
             var imported = skinManager.Import(new ImportTask(exportStream, "exported.osk"));
 
-            imported.Result.PerformRead(s =>
+            imported.WaitSafelyForResult().PerformRead(s =>
             {
                 Assert.IsFalse(s.Protected);
                 Assert.AreNotEqual(originalSkinId, s.ID);
@@ -222,7 +223,7 @@ namespace osu.Game.Tests.Skins.IO
 
             var imported = skinManager.Import(new ImportTask(exportStream, "exported.osk"));
 
-            imported.Result.PerformRead(s =>
+            imported.WaitSafelyForResult().PerformRead(s =>
             {
                 Assert.IsFalse(s.Protected);
                 Assert.AreNotEqual(originalSkinId, s.ID);
diff --git a/osu.Game.Tests/Skins/TestSceneBeatmapSkinResources.cs b/osu.Game.Tests/Skins/TestSceneBeatmapSkinResources.cs
index 1d8b754837..a4c2ec3b34 100644
--- a/osu.Game.Tests/Skins/TestSceneBeatmapSkinResources.cs
+++ b/osu.Game.Tests/Skins/TestSceneBeatmapSkinResources.cs
@@ -4,6 +4,7 @@
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Audio.Track;
+using osu.Framework.Extensions;
 using osu.Framework.Testing;
 using osu.Game.Audio;
 using osu.Game.Beatmaps;
@@ -24,7 +25,7 @@ namespace osu.Game.Tests.Skins
         [BackgroundDependencyLoader]
         private void load()
         {
-            var imported = beatmaps.Import(new ZipArchiveReader(TestResources.OpenResource("Archives/ogg-beatmap.osz"))).Result;
+            var imported = beatmaps.Import(new ZipArchiveReader(TestResources.OpenResource("Archives/ogg-beatmap.osz"))).WaitSafelyForResult();
             beatmap = beatmaps.GetWorkingBeatmap(imported.Value.Beatmaps[0]);
             beatmap.LoadTrack();
         }
diff --git a/osu.Game.Tests/Skins/TestSceneSkinResources.cs b/osu.Game.Tests/Skins/TestSceneSkinResources.cs
index 09535b76e3..a10e2436d6 100644
--- a/osu.Game.Tests/Skins/TestSceneSkinResources.cs
+++ b/osu.Game.Tests/Skins/TestSceneSkinResources.cs
@@ -3,6 +3,7 @@
 
 using NUnit.Framework;
 using osu.Framework.Allocation;
+using osu.Framework.Extensions;
 using osu.Framework.Testing;
 using osu.Game.Audio;
 using osu.Game.IO.Archives;
@@ -23,7 +24,7 @@ namespace osu.Game.Tests.Skins
         [BackgroundDependencyLoader]
         private void load()
         {
-            var imported = skins.Import(new ZipArchiveReader(TestResources.OpenResource("Archives/ogg-skin.osk"))).Result;
+            var imported = skins.Import(new ZipArchiveReader(TestResources.OpenResource("Archives/ogg-skin.osk"))).WaitSafelyForResult();
             skin = imported.PerformRead(skinInfo => skins.GetSkin(skinInfo));
         }
 
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneDifficultySwitching.cs b/osu.Game.Tests/Visual/Editing/TestSceneDifficultySwitching.cs
index c23db5e440..5dd5bad0d2 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneDifficultySwitching.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneDifficultySwitching.cs
@@ -5,6 +5,7 @@ using System;
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
+using osu.Framework.Extensions;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
 using osu.Game.Overlays.Dialog;
@@ -32,7 +33,7 @@ namespace osu.Game.Tests.Visual.Editing
 
         public override void SetUpSteps()
         {
-            AddStep("import test beatmap", () => importedBeatmapSet = ImportBeatmapTest.LoadOszIntoOsu(game, virtualTrack: true).Result);
+            AddStep("import test beatmap", () => importedBeatmapSet = ImportBeatmapTest.LoadOszIntoOsu(game, virtualTrack: true).WaitSafelyForResult());
             base.SetUpSteps();
         }
 
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneEditorTestGameplay.cs b/osu.Game.Tests/Visual/Editing/TestSceneEditorTestGameplay.cs
index 50794f15ed..fcbae44c76 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneEditorTestGameplay.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneEditorTestGameplay.cs
@@ -5,6 +5,7 @@ using System;
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
+using osu.Framework.Extensions;
 using osu.Framework.Screens;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
@@ -38,7 +39,7 @@ namespace osu.Game.Tests.Visual.Editing
 
         public override void SetUpSteps()
         {
-            AddStep("import test beatmap", () => importedBeatmapSet = ImportBeatmapTest.LoadOszIntoOsu(game).Result);
+            AddStep("import test beatmap", () => importedBeatmapSet = ImportBeatmapTest.LoadOszIntoOsu(game).WaitSafelyForResult());
             base.SetUpSteps();
         }
 
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneReplayDownloadButton.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneReplayDownloadButton.cs
index 42c4f89e9d..7f5ac5cf48 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneReplayDownloadButton.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneReplayDownloadButton.cs
@@ -9,6 +9,7 @@ using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Scoring;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
+using osu.Framework.Extensions;
 using osu.Framework.Testing;
 using osu.Game.Database;
 using osu.Game.Graphics.UserInterface;
@@ -135,7 +136,7 @@ namespace osu.Game.Tests.Visual.Gameplay
 
             AddUntilStep("state is not downloaded", () => downloadButton.State.Value == DownloadState.NotDownloaded);
 
-            AddStep("import score", () => imported = scoreManager.Import(getScoreInfo(true)).Result);
+            AddStep("import score", () => imported = scoreManager.Import(getScoreInfo(true)).WaitSafelyForResult());
 
             AddUntilStep("state is available", () => downloadButton.State.Value == DownloadState.LocallyAvailable);
 
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs
index 9fadbe02bd..90065e3b51 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs
@@ -4,6 +4,7 @@
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
+using osu.Framework.Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Screens;
 using osu.Framework.Testing;
@@ -60,7 +61,7 @@ namespace osu.Game.Tests.Visual.Gameplay
 
             AddStep("import beatmap", () =>
             {
-                importedBeatmap = ImportBeatmapTest.LoadOszIntoOsu(game, virtualTrack: true).Result;
+                importedBeatmap = ImportBeatmapTest.LoadOszIntoOsu(game, virtualTrack: true).WaitSafelyForResult();
                 importedBeatmapId = importedBeatmap.Beatmaps.First(b => b.RulesetID == 0).OnlineID ?? -1;
             });
         }
diff --git a/osu.Game.Tests/Visual/Menus/TestSceneMusicActionHandling.cs b/osu.Game.Tests/Visual/Menus/TestSceneMusicActionHandling.cs
index 425e7718dc..c82bde3444 100644
--- a/osu.Game.Tests/Visual/Menus/TestSceneMusicActionHandling.cs
+++ b/osu.Game.Tests/Visual/Menus/TestSceneMusicActionHandling.cs
@@ -38,7 +38,7 @@ namespace osu.Game.Tests.Visual.Menus
 
             AddStep("import beatmap with track", () =>
             {
-                var setWithTrack = Game.BeatmapManager.Import(new ImportTask(TestResources.GetTestBeatmapForImport())).Result;
+                var setWithTrack = Game.BeatmapManager.Import(new ImportTask(TestResources.GetTestBeatmapForImport())).WaitSafelyForResult();
                 Beatmap.Value = Game.BeatmapManager.GetWorkingBeatmap(setWithTrack.Value.Beatmaps.First());
             });
 
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs
index b10856b704..3f24da2c9e 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs
@@ -5,6 +5,7 @@ using System.Collections.Generic;
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
+using osu.Framework.Extensions;
 using osu.Framework.Extensions.ObjectExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
@@ -46,7 +47,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [BackgroundDependencyLoader]
         private void load()
         {
-            importedSet = ImportBeatmapTest.LoadOszIntoOsu(game, virtualTrack: true).Result;
+            importedSet = ImportBeatmapTest.LoadOszIntoOsu(game, virtualTrack: true).WaitSafelyForResult();
             importedBeatmap = importedSet.Beatmaps.First(b => b.RulesetID == 0);
             importedBeatmapId = importedBeatmap.OnlineID ?? -1;
         }
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs
index 25200560e4..6b40a4fc9a 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs
@@ -6,6 +6,7 @@ using System.Collections.Generic;
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
+using osu.Framework.Extensions;
 using osu.Framework.Extensions.ObjectExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Utils;
@@ -43,7 +44,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             base.SetUpSteps();
 
-            AddStep("set local user", () => ((DummyAPIAccess)API).LocalUser.Value = LookupCache.GetUserAsync(1).Result);
+            AddStep("set local user", () => ((DummyAPIAccess)API).LocalUser.Value = LookupCache.GetUserAsync(1).WaitSafelyForResult());
 
             AddStep("create leaderboard", () =>
             {
@@ -90,7 +91,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         public void TestUserQuit()
         {
             foreach (int user in users)
-                AddStep($"mark user {user} quit", () => Client.RemoveUser(LookupCache.GetUserAsync(user).Result.AsNonNull()));
+                AddStep($"mark user {user} quit", () => Client.RemoveUser(LookupCache.GetUserAsync(user).WaitSafelyForResult().AsNonNull()));
         }
 
         [Test]
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboardTeams.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboardTeams.cs
index 16a342df8c..f5c079573d 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboardTeams.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboardTeams.cs
@@ -4,6 +4,7 @@
 using System.Collections.Generic;
 using System.Linq;
 using NUnit.Framework;
+using osu.Framework.Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Utils;
 using osu.Game.Online.API;
@@ -47,7 +48,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             base.SetUpSteps();
 
-            AddStep("set local user", () => ((DummyAPIAccess)API).LocalUser.Value = LookupCache.GetUserAsync(1).Result);
+            AddStep("set local user", () => ((DummyAPIAccess)API).LocalUser.Value = LookupCache.GetUserAsync(1).WaitSafelyForResult());
 
             AddStep("create leaderboard", () =>
             {
diff --git a/osu.Game.Tests/Visual/Navigation/TestScenePresentBeatmap.cs b/osu.Game.Tests/Visual/Navigation/TestScenePresentBeatmap.cs
index 3cb1ea85a9..9d495f7d05 100644
--- a/osu.Game.Tests/Visual/Navigation/TestScenePresentBeatmap.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestScenePresentBeatmap.cs
@@ -4,6 +4,7 @@
 using System;
 using System.Linq;
 using NUnit.Framework;
+using osu.Framework.Extensions;
 using osu.Framework.Screens;
 using osu.Game.Beatmaps;
 using osu.Game.Extensions;
@@ -126,7 +127,7 @@ namespace osu.Game.Tests.Visual.Navigation
                             Ruleset = ruleset ?? new OsuRuleset().RulesetInfo
                         },
                     }
-                }).Result.Value;
+                }).WaitSafelyForResult().Value;
             });
 
             AddAssert($"import {i} succeeded", () => imported != null);
diff --git a/osu.Game.Tests/Visual/Navigation/TestScenePresentScore.cs b/osu.Game.Tests/Visual/Navigation/TestScenePresentScore.cs
index 7ee593de00..16c416fedc 100644
--- a/osu.Game.Tests/Visual/Navigation/TestScenePresentScore.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestScenePresentScore.cs
@@ -4,6 +4,7 @@
 using System;
 using System.Linq;
 using NUnit.Framework;
+using osu.Framework.Extensions;
 using osu.Framework.Screens;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
@@ -57,7 +58,7 @@ namespace osu.Game.Tests.Visual.Navigation
                             Ruleset = new OsuRuleset().RulesetInfo
                         },
                     }
-                }).Result.Value;
+                }).WaitSafelyForResult().Value;
             });
         }
 
@@ -131,7 +132,7 @@ namespace osu.Game.Tests.Visual.Navigation
                     OnlineID = i,
                     BeatmapInfo = beatmap.Beatmaps.First(),
                     Ruleset = ruleset ?? new OsuRuleset().RulesetInfo
-                }).Result.Value;
+                }).WaitSafelyForResult().Value;
             });
 
             AddAssert($"import {i} succeeded", () => imported != null);
diff --git a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs
index f3d00dc076..0c5985ad67 100644
--- a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs
+++ b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs
@@ -202,7 +202,7 @@ namespace osu.Game.Tests.Visual.Playlists
             });
         }
 
-        private void importBeatmap() => AddStep("import beatmap", () => importedBeatmap = manager.Import(CreateBeatmap(new OsuRuleset().RulesetInfo).BeatmapInfo.BeatmapSet).Result);
+        private void importBeatmap() => AddStep("import beatmap", () => importedBeatmap = manager.Import(CreateBeatmap(new OsuRuleset().RulesetInfo).BeatmapInfo.BeatmapSet).WaitSafelyForResult());
 
         private class TestPlaylistsRoomSubScreen : PlaylistsRoomSubScreen
         {
diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapRecommendations.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapRecommendations.cs
index ef11ad4153..071e3225f0 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapRecommendations.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapRecommendations.cs
@@ -5,6 +5,7 @@ using System;
 using System.Collections.Generic;
 using System.Linq;
 using NUnit.Framework;
+using osu.Framework.Extensions;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
 using osu.Game.Extensions;
@@ -181,7 +182,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                 beatmap.DifficultyName = $"SR{i + 1}";
             }
 
-            return Game.BeatmapManager.Import(beatmapSet).Result.Value;
+            return Game.BeatmapManager.Import(beatmapSet).WaitSafelyForResult().Value;
         }
 
         private bool ensureAllBeatmapSetsImported(IEnumerable<BeatmapSetInfo> beatmapSets) => beatmapSets.All(set => set != null);
diff --git a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
index bd5aeb7e08..ea667d02f3 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
@@ -760,7 +760,7 @@ namespace osu.Game.Tests.Visual.SongSelect
             AddStep("import huge difficulty count map", () =>
             {
                 var usableRulesets = rulesets.AvailableRulesets.Where(r => r.OnlineID != 2).ToArray();
-                imported = manager.Import(TestResources.CreateTestBeatmapSetInfo(50, usableRulesets)).Result.Value;
+                imported = manager.Import(TestResources.CreateTestBeatmapSetInfo(50, usableRulesets)).WaitSafelyForResult().Value;
             });
 
             AddStep("select the first beatmap of import", () => Beatmap.Value = manager.GetWorkingBeatmap(imported.Beatmaps.First()));
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
index 2363bbbfcf..bca396b46b 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
@@ -7,6 +7,7 @@ using NUnit.Framework;
 using osu.Framework.Graphics;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
+using osu.Framework.Extensions;
 using osu.Framework.Graphics.Cursor;
 using osu.Framework.Platform;
 using osu.Framework.Testing;
@@ -85,7 +86,7 @@ namespace osu.Game.Tests.Visual.UserInterface
             dependencies.Cache(beatmapManager = new BeatmapManager(LocalStorage, ContextFactory, rulesetStore, null, dependencies.Get<AudioManager>(), Resources, dependencies.Get<GameHost>(), Beatmap.Default));
             dependencies.Cache(scoreManager = new ScoreManager(rulesetStore, () => beatmapManager, LocalStorage, ContextFactory, Scheduler));
 
-            beatmapInfo = beatmapManager.Import(new ImportTask(TestResources.GetQuickTestBeatmapForImport())).Result.Value.Beatmaps[0];
+            beatmapInfo = beatmapManager.Import(new ImportTask(TestResources.GetQuickTestBeatmapForImport())).WaitSafelyForResult().Value.Beatmaps[0];
 
             for (int i = 0; i < 50; i++)
             {
@@ -101,7 +102,7 @@ namespace osu.Game.Tests.Visual.UserInterface
                     User = new APIUser { Username = "TestUser" },
                 };
 
-                importedScores.Add(scoreManager.Import(score).Result.Value);
+                importedScores.Add(scoreManager.Import(score).WaitSafelyForResult().Value);
             }
 
             return dependencies;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneUpdateableBeatmapBackgroundSprite.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneUpdateableBeatmapBackgroundSprite.cs
index 3fa9b8b877..f78cbdffc1 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneUpdateableBeatmapBackgroundSprite.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneUpdateableBeatmapBackgroundSprite.cs
@@ -5,6 +5,7 @@ using System.Collections.Generic;
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
+using osu.Framework.Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Beatmaps;
@@ -31,7 +32,7 @@ namespace osu.Game.Tests.Visual.UserInterface
         {
             this.api = api;
 
-            testBeatmap = ImportBeatmapTest.LoadOszIntoOsu(osu).Result;
+            testBeatmap = ImportBeatmapTest.LoadOszIntoOsu(osu).WaitSafelyForResult();
         }
 
         [Test]
diff --git a/osu.Game/Beatmaps/BeatmapDifficultyCache.cs b/osu.Game/Beatmaps/BeatmapDifficultyCache.cs
index 119906cadc..0e4dab2b96 100644
--- a/osu.Game/Beatmaps/BeatmapDifficultyCache.cs
+++ b/osu.Game/Beatmaps/BeatmapDifficultyCache.cs
@@ -10,6 +10,7 @@ using System.Threading.Tasks;
 using JetBrains.Annotations;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
+using osu.Framework.Extensions;
 using osu.Framework.Lists;
 using osu.Framework.Logging;
 using osu.Framework.Threading;
@@ -266,8 +267,11 @@ namespace osu.Game.Beatmaps
                     // We're on a threadpool thread, but we should exit back to the update thread so consumers can safely handle value-changed events.
                     Schedule(() =>
                     {
-                        if (!cancellationToken.IsCancellationRequested && t.Result != null)
-                            bindable.Value = t.Result;
+                        if (cancellationToken.IsCancellationRequested)
+                            return;
+
+                        if (t.WaitSafelyForResult() is StarDifficulty sd)
+                            bindable.Value = sd;
                     });
                 }, cancellationToken);
         }
diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index 8502b91096..c461135266 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -11,6 +11,7 @@ using System.Threading.Tasks;
 using JetBrains.Annotations;
 using osu.Framework.Audio;
 using osu.Framework.Audio.Track;
+using osu.Framework.Extensions;
 using osu.Framework.IO.Stores;
 using osu.Framework.Platform;
 using osu.Framework.Testing;
@@ -91,7 +92,7 @@ namespace osu.Game.Beatmaps
                 }
             };
 
-            var imported = beatmapModelManager.Import(set).Result.Value;
+            var imported = beatmapModelManager.Import(set).WaitSafelyForResult().Value;
 
             return GetWorkingBeatmap(imported.Beatmaps.First());
         }
diff --git a/osu.Game/Beatmaps/WorkingBeatmap.cs b/osu.Game/Beatmaps/WorkingBeatmap.cs
index 451b4ccac8..85e30b6e3d 100644
--- a/osu.Game/Beatmaps/WorkingBeatmap.cs
+++ b/osu.Game/Beatmaps/WorkingBeatmap.cs
@@ -11,6 +11,7 @@ using System.Threading.Tasks;
 using JetBrains.Annotations;
 using osu.Framework.Audio;
 using osu.Framework.Audio.Track;
+using osu.Framework.Extensions;
 using osu.Framework.Graphics.Textures;
 using osu.Framework.Logging;
 using osu.Framework.Testing;
@@ -185,7 +186,7 @@ namespace osu.Game.Beatmaps
             {
                 try
                 {
-                    return loadBeatmapAsync().Result;
+                    return loadBeatmapAsync().WaitSafelyForResult();
                 }
                 catch (AggregateException ae)
                 {
diff --git a/osu.Game/Database/OnlineLookupCache.cs b/osu.Game/Database/OnlineLookupCache.cs
index 5eb9fa24fa..b392336bb4 100644
--- a/osu.Game/Database/OnlineLookupCache.cs
+++ b/osu.Game/Database/OnlineLookupCache.cs
@@ -8,6 +8,7 @@ using System.Threading;
 using System.Threading.Tasks;
 using JetBrains.Annotations;
 using osu.Framework.Allocation;
+using osu.Framework.Extensions;
 using osu.Game.Online.API;
 
 namespace osu.Game.Database
@@ -58,7 +59,7 @@ namespace osu.Game.Database
                     if (!task.IsCompletedSuccessfully)
                         return null;
 
-                    return task.Result;
+                    return task.WaitSafelyForResult();
                 }, token));
             }
 
diff --git a/osu.Game/Online/Chat/ChannelManager.cs b/osu.Game/Online/Chat/ChannelManager.cs
index 2d7a0bc9fc..3b27dd5c5d 100644
--- a/osu.Game/Online/Chat/ChannelManager.cs
+++ b/osu.Game/Online/Chat/ChannelManager.cs
@@ -7,6 +7,7 @@ using System.Linq;
 using System.Threading.Tasks;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
+using osu.Framework.Extensions;
 using osu.Framework.Logging;
 using osu.Game.Database;
 using osu.Game.Input;
@@ -533,11 +534,10 @@ namespace osu.Game.Online.Chat
                 else if (lastClosedChannel.Type == ChannelType.PM)
                 {
                     // Try to get user in order to open PM chat
-                    users.GetUserAsync((int)lastClosedChannel.Id).ContinueWith(u =>
+                    users.GetUserAsync((int)lastClosedChannel.Id).ContinueWith(task =>
                     {
-                        if (u.Result == null) return;
-
-                        Schedule(() => CurrentChannel.Value = JoinChannel(new Channel(u.Result)));
+                        if (task.WaitSafelyForResult() is APIUser u)
+                            Schedule(() => CurrentChannel.Value = JoinChannel(new Channel(u)));
                     });
                 }
 
diff --git a/osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.cs b/osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.cs
index 695661d5c9..adb1adeed4 100644
--- a/osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.cs
+++ b/osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.cs
@@ -7,6 +7,7 @@ using System.Threading;
 using System.Threading.Tasks;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
+using osu.Framework.Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
@@ -79,14 +80,16 @@ namespace osu.Game.Overlays.BeatmapSet.Scores
                 };
 
                 scoreManager.OrderByTotalScoreAsync(value.Scores.Select(s => s.CreateScoreInfo(rulesets, beatmapInfo)).ToArray(), loadCancellationSource.Token)
-                            .ContinueWith(ordered => Schedule(() =>
+                            .ContinueWith(task => Schedule(() =>
                             {
                                 if (loadCancellationSource.IsCancellationRequested)
                                     return;
 
-                                var topScore = ordered.Result.First();
+                                var scores = task.WaitSafelyForResult();
 
-                                scoreTable.DisplayScores(ordered.Result, apiBeatmap.Status.GrantsPerformancePoints());
+                                var topScore = scores.First();
+
+                                scoreTable.DisplayScores(scores, apiBeatmap.Status.GrantsPerformancePoints());
                                 scoreTable.Show();
 
                                 var userScore = value.UserScore;
diff --git a/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs b/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs
index 0844975906..b7d236c263 100644
--- a/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs
+++ b/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs
@@ -5,6 +5,7 @@ using System.Collections.Specialized;
 using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
+using osu.Framework.Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Screens;
@@ -61,17 +62,19 @@ namespace osu.Game.Overlays.Dashboard
                 case NotifyCollectionChangedAction.Add:
                     foreach (int id in e.NewItems.OfType<int>().ToArray())
                     {
-                        users.GetUserAsync(id).ContinueWith(u =>
+                        users.GetUserAsync(id).ContinueWith(task =>
                         {
-                            if (u.Result == null) return;
+                            var user = task.WaitSafelyForResult();
+
+                            if (user == null) return;
 
                             Schedule(() =>
                             {
                                 // user may no longer be playing.
-                                if (!playingUsers.Contains(u.Result.Id))
+                                if (!playingUsers.Contains(user.Id))
                                     return;
 
-                                userFlow.Add(createUserPanel(u.Result));
+                                userFlow.Add(createUserPanel(user));
                             });
                         });
                     }
diff --git a/osu.Game/Overlays/Settings/Sections/General/UpdateSettings.cs b/osu.Game/Overlays/Settings/Sections/General/UpdateSettings.cs
index 6bcb5ef715..49eb80d993 100644
--- a/osu.Game/Overlays/Settings/Sections/General/UpdateSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/General/UpdateSettings.cs
@@ -4,6 +4,7 @@
 using System.Threading.Tasks;
 using osu.Framework;
 using osu.Framework.Allocation;
+using osu.Framework.Extensions;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Localisation;
 using osu.Framework.Platform;
@@ -45,9 +46,9 @@ namespace osu.Game.Overlays.Settings.Sections.General
                     Action = () =>
                     {
                         checkForUpdatesButton.Enabled.Value = false;
-                        Task.Run(updateManager.CheckForUpdateAsync).ContinueWith(t => Schedule(() =>
+                        Task.Run(updateManager.CheckForUpdateAsync).ContinueWith(task => Schedule(() =>
                         {
-                            if (!t.Result)
+                            if (!task.WaitSafelyForResult())
                             {
                                 notifications?.Post(new SimpleNotification
                                 {
diff --git a/osu.Game/Scoring/ScoreManager.cs b/osu.Game/Scoring/ScoreManager.cs
index 6de6b57066..9715cd64a7 100644
--- a/osu.Game/Scoring/ScoreManager.cs
+++ b/osu.Game/Scoring/ScoreManager.cs
@@ -9,6 +9,7 @@ using System.Threading;
 using System.Threading.Tasks;
 using JetBrains.Annotations;
 using osu.Framework.Bindables;
+using osu.Framework.Extensions;
 using osu.Framework.Platform;
 using osu.Framework.Threading;
 using osu.Game.Beatmaps;
@@ -112,7 +113,7 @@ namespace osu.Game.Scoring
         public void GetTotalScore([NotNull] ScoreInfo score, [NotNull] Action<long> callback, ScoringMode mode = ScoringMode.Standardised, CancellationToken cancellationToken = default)
         {
             GetTotalScoreAsync(score, mode, cancellationToken)
-                .ContinueWith(s => scheduler.Add(() => callback(s.Result)), TaskContinuationOptions.OnlyOnRanToCompletion);
+                .ContinueWith(task => scheduler.Add(() => callback(task.WaitSafelyForResult())), TaskContinuationOptions.OnlyOnRanToCompletion);
         }
 
         /// <summary>
diff --git a/osu.Game/Screens/Menu/IntroScreen.cs b/osu.Game/Screens/Menu/IntroScreen.cs
index eb8d3dfea6..e7731631ff 100644
--- a/osu.Game/Screens/Menu/IntroScreen.cs
+++ b/osu.Game/Screens/Menu/IntroScreen.cs
@@ -9,6 +9,7 @@ using osu.Framework.Audio;
 using osu.Framework.Audio.Sample;
 using osu.Framework.Audio.Track;
 using osu.Framework.Bindables;
+using osu.Framework.Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Screens;
 using osu.Framework.Utils;
@@ -110,7 +111,7 @@ namespace osu.Game.Screens.Menu
                 {
                     // if we detect that the theme track or beatmap is unavailable this is either first startup or things are in a bad state.
                     // this could happen if a user has nuked their files store. for now, reimport to repair this.
-                    var import = beatmaps.Import(new ZipArchiveReader(game.Resources.GetStream($"Tracks/{BeatmapFile}"), BeatmapFile)).Result;
+                    var import = beatmaps.Import(new ZipArchiveReader(game.Resources.GetStream($"Tracks/{BeatmapFile}"), BeatmapFile)).WaitSafelyForResult();
 
                     import.PerformWrite(b =>
                     {
diff --git a/osu.Game/Screens/Play/HUD/MultiplayerGameplayLeaderboard.cs b/osu.Game/Screens/Play/HUD/MultiplayerGameplayLeaderboard.cs
index e019ee9a3d..6f2a76b3cb 100644
--- a/osu.Game/Screens/Play/HUD/MultiplayerGameplayLeaderboard.cs
+++ b/osu.Game/Screens/Play/HUD/MultiplayerGameplayLeaderboard.cs
@@ -7,6 +7,7 @@ using System.Collections.Specialized;
 using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
+using osu.Framework.Extensions;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Game.Configuration;
 using osu.Game.Database;
@@ -76,9 +77,11 @@ namespace osu.Game.Screens.Play.HUD
                     TeamScores.Add(team, new BindableInt());
             }
 
-            userLookupCache.GetUsersAsync(playingUsers.Select(u => u.UserID).ToArray()).ContinueWith(users => Schedule(() =>
+            userLookupCache.GetUsersAsync(playingUsers.Select(u => u.UserID).ToArray()).ContinueWith(task => Schedule(() =>
             {
-                foreach (var user in users.Result)
+                var users = task.WaitSafelyForResult();
+
+                foreach (var user in users)
                 {
                     if (user == null)
                         continue;
diff --git a/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs b/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs
index 908e6a27b8..f543cea15c 100644
--- a/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs
+++ b/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs
@@ -10,6 +10,7 @@ using System.Threading.Tasks;
 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;
@@ -73,10 +74,12 @@ namespace osu.Game.Screens.Play.HUD
 
                 var gameplayWorkingBeatmap = new GameplayWorkingBeatmap(gameplayState.Beatmap);
                 difficultyCache.GetTimedDifficultyAttributesAsync(gameplayWorkingBeatmap, gameplayState.Ruleset, clonedMods, loadCancellationSource.Token)
-                               .ContinueWith(r => Schedule(() =>
+                               .ContinueWith(task => Schedule(() =>
                                {
-                                   timedAttributes = r.Result;
+                                   timedAttributes = task.WaitSafelyForResult();
+
                                    IsValid = true;
+
                                    if (lastJudgement != null)
                                        onJudgementChanged(lastJudgement);
                                }), TaskContinuationOptions.OnlyOnRanToCompletion);
diff --git a/osu.Game/Screens/Play/Player.cs b/osu.Game/Screens/Play/Player.cs
index 77a6b27114..262424258a 100644
--- a/osu.Game/Screens/Play/Player.cs
+++ b/osu.Game/Screens/Play/Player.cs
@@ -9,6 +9,7 @@ using osu.Framework.Allocation;
 using osu.Framework.Audio;
 using osu.Framework.Audio.Sample;
 using osu.Framework.Bindables;
+using osu.Framework.Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Input.Events;
@@ -770,7 +771,7 @@ namespace osu.Game.Screens.Play
                     // This player instance may already be in the process of exiting.
                     return;
 
-                this.Push(CreateResults(prepareScoreForDisplayTask.Result));
+                this.Push(CreateResults(prepareScoreForDisplayTask.WaitSafelyForResult()));
             }, Time.Current + delay, 50);
 
             Scheduler.Add(resultsDisplayDelegate);
diff --git a/osu.Game/Screens/Ranking/Expanded/ExpandedPanelMiddleContent.cs b/osu.Game/Screens/Ranking/Expanded/ExpandedPanelMiddleContent.cs
index 3ab2658f97..87940c61aa 100644
--- a/osu.Game/Screens/Ranking/Expanded/ExpandedPanelMiddleContent.cs
+++ b/osu.Game/Screens/Ranking/Expanded/ExpandedPanelMiddleContent.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.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Localisation;
@@ -79,7 +80,7 @@ namespace osu.Game.Screens.Ranking.Expanded
             statisticDisplays.AddRange(topStatistics);
             statisticDisplays.AddRange(bottomStatistics);
 
-            var starDifficulty = beatmapDifficultyCache.GetDifficultyAsync(beatmap, score.Ruleset, score.Mods).Result;
+            var starDifficulty = beatmapDifficultyCache.GetDifficultyAsync(beatmap, score.Ruleset, score.Mods).WaitSafelyForResult();
 
             AddInternal(new FillFlowContainer
             {
diff --git a/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatistic.cs b/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatistic.cs
index 68da4ec724..90ecd3642b 100644
--- a/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatistic.cs
+++ b/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatistic.cs
@@ -5,6 +5,7 @@ using System;
 using System.Threading;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
+using osu.Framework.Extensions;
 using osu.Framework.Graphics;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Scoring;
@@ -37,7 +38,7 @@ namespace osu.Game.Screens.Ranking.Expanded.Statistics
             else
             {
                 performanceCache.CalculatePerformanceAsync(score, cancellationTokenSource.Token)
-                                .ContinueWith(t => Schedule(() => setPerformanceValue(t.Result)), cancellationTokenSource.Token);
+                                .ContinueWith(t => Schedule(() => setPerformanceValue(t.WaitSafelyForResult())), cancellationTokenSource.Token);
             }
         }
 
diff --git a/osu.Game/Screens/Ranking/ScorePanelList.cs b/osu.Game/Screens/Ranking/ScorePanelList.cs
index f3de48dcf0..b29f2302d5 100644
--- a/osu.Game/Screens/Ranking/ScorePanelList.cs
+++ b/osu.Game/Screens/Ranking/ScorePanelList.cs
@@ -10,6 +10,7 @@ using System.Threading.Tasks;
 using JetBrains.Annotations;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
+using osu.Framework.Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Input.Events;
@@ -151,9 +152,9 @@ namespace osu.Game.Screens.Ranking
 
             // Calculating score can take a while in extreme scenarios, so only display scores after the process completes.
             scoreManager.GetTotalScoreAsync(score)
-                        .ContinueWith(totalScore => Schedule(() =>
+                        .ContinueWith(task => Schedule(() =>
                         {
-                            flow.SetLayoutPosition(trackingContainer, totalScore.Result);
+                            flow.SetLayoutPosition(trackingContainer, task.WaitSafelyForResult());
 
                             trackingContainer.Show();
 
diff --git a/osu.Game/Screens/Select/Details/AdvancedStats.cs b/osu.Game/Screens/Select/Details/AdvancedStats.cs
index edbaba40bc..e7764b23be 100644
--- a/osu.Game/Screens/Select/Details/AdvancedStats.cs
+++ b/osu.Game/Screens/Select/Details/AdvancedStats.cs
@@ -16,6 +16,7 @@ using osu.Game.Rulesets.Mods;
 using System.Linq;
 using System.Threading;
 using System.Threading.Tasks;
+using osu.Framework.Extensions;
 using osu.Framework.Localisation;
 using osu.Framework.Threading;
 using osu.Framework.Utils;
@@ -147,15 +148,18 @@ namespace osu.Game.Screens.Select.Details
 
             starDifficultyCancellationSource = new CancellationTokenSource();
 
-            var normalStarDifficulty = difficultyCache.GetDifficultyAsync(BeatmapInfo, ruleset.Value, null, starDifficultyCancellationSource.Token);
-            var moddedStarDifficulty = difficultyCache.GetDifficultyAsync(BeatmapInfo, ruleset.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(normalStarDifficulty, moddedStarDifficulty).ContinueWith(_ => Schedule(() =>
+            Task.WhenAll(normalStarDifficultyTask, moddedStarDifficultyTask).ContinueWith(_ => Schedule(() =>
             {
-                if (normalStarDifficulty.Result == null || moddedStarDifficulty.Result == null)
+                var normalDifficulty = normalStarDifficultyTask.WaitSafelyForResult();
+                var moddeDifficulty = moddedStarDifficultyTask.WaitSafelyForResult();
+
+                if (normalDifficulty == null || moddeDifficulty == null)
                     return;
 
-                starDifficulty.Value = ((float)normalStarDifficulty.Result.Value.Stars, (float)moddedStarDifficulty.Result.Value.Stars);
+                starDifficulty.Value = ((float)normalDifficulty.Value.Stars, (float)moddeDifficulty.Value.Stars);
             }), starDifficultyCancellationSource.Token, TaskContinuationOptions.OnlyOnRanToCompletion, TaskScheduler.Current);
         }
 
diff --git a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
index 29c8907526..6943f2a3b6 100644
--- a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
+++ b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
@@ -8,6 +8,7 @@ using System.Threading;
 using System.Threading.Tasks;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
+using osu.Framework.Extensions;
 using osu.Game.Beatmaps;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests;
@@ -142,7 +143,7 @@ namespace osu.Game.Screens.Select.Leaderboards
                 }
 
                 scoreManager.OrderByTotalScoreAsync(scores.ToArray(), cancellationToken)
-                            .ContinueWith(ordered => scoresCallback?.Invoke(ordered.Result), TaskContinuationOptions.OnlyOnRanToCompletion);
+                            .ContinueWith(ordered => scoresCallback?.Invoke(ordered.WaitSafelyForResult()), TaskContinuationOptions.OnlyOnRanToCompletion);
 
                 return null;
             }
@@ -178,12 +179,12 @@ namespace osu.Game.Screens.Select.Leaderboards
             req.Success += r =>
             {
                 scoreManager.OrderByTotalScoreAsync(r.Scores.Select(s => s.CreateScoreInfo(rulesets, fetchBeatmapInfo)).ToArray(), cancellationToken)
-                            .ContinueWith(ordered => Schedule(() =>
+                            .ContinueWith(task => Schedule(() =>
                             {
                                 if (cancellationToken.IsCancellationRequested)
                                     return;
 
-                                scoresCallback?.Invoke(ordered.Result);
+                                scoresCallback?.Invoke(task.WaitSafelyForResult());
                                 TopScore = r.UserScore?.CreateScoreInfo(rulesets, fetchBeatmapInfo);
                             }), TaskContinuationOptions.OnlyOnRanToCompletion);
             };
diff --git a/osu.Game/Screens/Spectate/SpectatorScreen.cs b/osu.Game/Screens/Spectate/SpectatorScreen.cs
index ca56366927..f361b0cee4 100644
--- a/osu.Game/Screens/Spectate/SpectatorScreen.cs
+++ b/osu.Game/Screens/Spectate/SpectatorScreen.cs
@@ -7,6 +7,7 @@ using System.Linq;
 using JetBrains.Annotations;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
+using osu.Framework.Extensions;
 using osu.Framework.Extensions.ObjectExtensions;
 using osu.Game.Beatmaps;
 using osu.Game.Database;
@@ -57,9 +58,11 @@ namespace osu.Game.Screens.Spectate
         {
             base.LoadComplete();
 
-            userLookupCache.GetUsersAsync(users.ToArray()).ContinueWith(users => Schedule(() =>
+            userLookupCache.GetUsersAsync(users.ToArray()).ContinueWith(task => Schedule(() =>
             {
-                foreach (var u in users.Result)
+                var foundUsers = task.WaitSafelyForResult();
+
+                foreach (var u in foundUsers)
                 {
                     if (u == null)
                         continue;
diff --git a/osu.Game/Skinning/SkinManager.cs b/osu.Game/Skinning/SkinManager.cs
index bb2f0a37b4..a55cc332c5 100644
--- a/osu.Game/Skinning/SkinManager.cs
+++ b/osu.Game/Skinning/SkinManager.cs
@@ -11,6 +11,7 @@ using JetBrains.Annotations;
 using osu.Framework.Audio;
 using osu.Framework.Audio.Sample;
 using osu.Framework.Bindables;
+using osu.Framework.Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.OpenGL.Textures;
 using osu.Framework.Graphics.Textures;
@@ -153,7 +154,7 @@ namespace osu.Game.Skinning
                     Name = s.Name + @" (modified)",
                     Creator = s.Creator,
                     InstantiationInfo = s.InstantiationInfo,
-                }).Result;
+                }).WaitSafelyForResult();
 
                 if (result != null)
                 {

From f3e889d0f612ca15db77853bf283087f77b9389c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 3 Jan 2022 17:51:56 +0900
Subject: [PATCH 1906/5547] Fix incorrect nested result retrieval in
 `ImportBeatmapTest`

---
 .../Beatmaps/IO/ImportBeatmapTest.cs          | 54 ++++++++++---------
 1 file changed, 28 insertions(+), 26 deletions(-)

diff --git a/osu.Game.Tests/Beatmaps/IO/ImportBeatmapTest.cs b/osu.Game.Tests/Beatmaps/IO/ImportBeatmapTest.cs
index 9f3709f7a3..2a2cc2e086 100644
--- a/osu.Game.Tests/Beatmaps/IO/ImportBeatmapTest.cs
+++ b/osu.Game.Tests/Beatmaps/IO/ImportBeatmapTest.cs
@@ -93,7 +93,7 @@ namespace osu.Game.Tests.Beatmaps.IO
                     using (var stream = File.OpenRead(tempPath))
                     {
                         importedSet = await manager.Import(new ImportTask(stream, Path.GetFileName(tempPath)));
-                        ensureLoaded(osu);
+                        await ensureLoaded(osu);
                     }
 
                     Assert.IsTrue(File.Exists(tempPath), "Stream source file somehow went missing");
@@ -171,7 +171,7 @@ namespace osu.Game.Tests.Beatmaps.IO
 
                         var importedSecondTime = await osu.Dependencies.Get<BeatmapManager>().Import(new ImportTask(temp));
 
-                        ensureLoaded(osu);
+                        await ensureLoaded(osu);
 
                         // but contents doesn't, so existing should still be used.
                         Assert.IsTrue(imported.ID == importedSecondTime.Value.ID);
@@ -225,7 +225,7 @@ namespace osu.Game.Tests.Beatmaps.IO
 
                         var importedSecondTime = await osu.Dependencies.Get<BeatmapManager>().Import(new ImportTask(temp));
 
-                        ensureLoaded(osu);
+                        await ensureLoaded(osu);
 
                         // check the newly "imported" beatmap is not the original.
                         Assert.IsTrue(imported.ID != importedSecondTime.Value.ID);
@@ -277,7 +277,7 @@ namespace osu.Game.Tests.Beatmaps.IO
 
                         var importedSecondTime = await osu.Dependencies.Get<BeatmapManager>().Import(new ImportTask(temp));
 
-                        ensureLoaded(osu);
+                        await ensureLoaded(osu);
 
                         // check the newly "imported" beatmap is not the original.
                         Assert.IsTrue(imported.ID != importedSecondTime.Value.ID);
@@ -328,7 +328,7 @@ namespace osu.Game.Tests.Beatmaps.IO
 
                         var importedSecondTime = await osu.Dependencies.Get<BeatmapManager>().Import(new ImportTask(temp));
 
-                        ensureLoaded(osu);
+                        await ensureLoaded(osu);
 
                         // check the newly "imported" beatmap is not the original.
                         Assert.IsTrue(imported.ID != importedSecondTime.Value.ID);
@@ -637,7 +637,7 @@ namespace osu.Game.Tests.Beatmaps.IO
                     if (!importer.ImportAsync(temp).Wait(10000))
                         Assert.Fail(@"IPC took too long to send");
 
-                    ensureLoaded(osu);
+                    ensureLoaded(osu).WaitSafely();
 
                     waitForOrAssert(() => !File.Exists(temp), "Temporary still exists after IPC import", 5000);
                 }
@@ -659,7 +659,7 @@ namespace osu.Game.Tests.Beatmaps.IO
                     string temp = TestResources.GetTestBeatmapForImport();
                     using (File.OpenRead(temp))
                         await osu.Dependencies.Get<BeatmapManager>().Import(temp);
-                    ensureLoaded(osu);
+                    await ensureLoaded(osu);
                     File.Delete(temp);
                     Assert.IsFalse(File.Exists(temp), "We likely held a read lock on the file when we shouldn't");
                 }
@@ -698,7 +698,7 @@ namespace osu.Game.Tests.Beatmaps.IO
 
                         await osu.Dependencies.Get<BeatmapManager>().Import(temp);
 
-                        ensureLoaded(osu);
+                        await ensureLoaded(osu);
                     }
                     finally
                     {
@@ -741,7 +741,7 @@ namespace osu.Game.Tests.Beatmaps.IO
 
                         var imported = await osu.Dependencies.Get<BeatmapManager>().Import(new ImportTask(temp));
 
-                        ensureLoaded(osu);
+                        await ensureLoaded(osu);
 
                         Assert.IsFalse(imported.Value.Files.Any(f => f.Filename.Contains("subfolder")), "Files contain common subfolder");
                     }
@@ -794,7 +794,7 @@ namespace osu.Game.Tests.Beatmaps.IO
 
                         var imported = await osu.Dependencies.Get<BeatmapManager>().Import(new ImportTask(temp));
 
-                        ensureLoaded(osu);
+                        await ensureLoaded(osu);
 
                         Assert.IsFalse(imported.Value.Files.Any(f => f.Filename.Contains("__MACOSX")), "Files contain resource fork folder, which should be ignored");
                         Assert.IsFalse(imported.Value.Files.Any(f => f.Filename.Contains("actual_data")), "Files contain common subfolder");
@@ -812,7 +812,7 @@ namespace osu.Game.Tests.Beatmaps.IO
         }
 
         [Test]
-        public async Task TestUpdateBeatmapInfo()
+        public void TestUpdateBeatmapInfo()
         {
             using (HeadlessGameHost host = new CleanRunHeadlessGameHost())
             {
@@ -822,7 +822,8 @@ namespace osu.Game.Tests.Beatmaps.IO
                     var manager = osu.Dependencies.Get<BeatmapManager>();
 
                     string temp = TestResources.GetTestBeatmapForImport();
-                    await osu.Dependencies.Get<BeatmapManager>().Import(temp);
+
+                    osu.Dependencies.Get<BeatmapManager>().Import(temp).WaitSafely();
 
                     // Update via the beatmap, not the beatmap info, to ensure correct linking
                     BeatmapSetInfo setToUpdate = manager.GetAllUsableBeatmapSets()[0];
@@ -842,7 +843,7 @@ namespace osu.Game.Tests.Beatmaps.IO
         }
 
         [Test]
-        public async Task TestUpdateBeatmapFile()
+        public void TestUpdateBeatmapFile()
         {
             using (HeadlessGameHost host = new CleanRunHeadlessGameHost())
             {
@@ -852,7 +853,8 @@ namespace osu.Game.Tests.Beatmaps.IO
                     var manager = osu.Dependencies.Get<BeatmapManager>();
 
                     string temp = TestResources.GetTestBeatmapForImport();
-                    await osu.Dependencies.Get<BeatmapManager>().Import(temp);
+
+                    osu.Dependencies.Get<BeatmapManager>().Import(temp).WaitSafely();
 
                     BeatmapSetInfo setToUpdate = manager.GetAllUsableBeatmapSets()[0];
 
@@ -976,35 +978,35 @@ namespace osu.Game.Tests.Beatmaps.IO
             }
         }
 
-        public static async Task<BeatmapSetInfo> LoadQuickOszIntoOsu(OsuGameBase osu)
+        public static Task<BeatmapSetInfo> LoadQuickOszIntoOsu(OsuGameBase osu) => Task.Factory.StartNew(() =>
         {
             string temp = TestResources.GetQuickTestBeatmapForImport();
 
             var manager = osu.Dependencies.Get<BeatmapManager>();
 
-            var importedSet = await manager.Import(new ImportTask(temp)).ConfigureAwait(false);
+            var importedSet = manager.Import(new ImportTask(temp)).WaitSafelyForResult();
 
-            ensureLoaded(osu);
+            ensureLoaded(osu).WaitSafely();
 
             waitForOrAssert(() => !File.Exists(temp), "Temporary file still exists after standard import", 5000);
 
             return manager.GetAllUsableBeatmapSets().Find(beatmapSet => beatmapSet.ID == importedSet.Value.ID);
-        }
+        }, TaskCreationOptions.LongRunning);
 
-        public static async Task<BeatmapSetInfo> LoadOszIntoOsu(OsuGameBase osu, string path = null, bool virtualTrack = false)
+        public static Task<BeatmapSetInfo> LoadOszIntoOsu(OsuGameBase osu, string path = null, bool virtualTrack = false) => Task.Factory.StartNew(() =>
         {
             string temp = path ?? TestResources.GetTestBeatmapForImport(virtualTrack);
 
             var manager = osu.Dependencies.Get<BeatmapManager>();
 
-            var importedSet = await manager.Import(new ImportTask(temp)).ConfigureAwait(false);
+            var importedSet = manager.Import(new ImportTask(temp)).WaitSafelyForResult();
 
-            ensureLoaded(osu);
+            ensureLoaded(osu).WaitSafely();
 
             waitForOrAssert(() => !File.Exists(temp), "Temporary file still exists after standard import", 5000);
 
             return manager.GetAllUsableBeatmapSets().Find(beatmapSet => beatmapSet.ID == importedSet.Value.ID);
-        }
+        }, TaskCreationOptions.LongRunning);
 
         private void deleteBeatmapSet(BeatmapSetInfo imported, OsuGameBase osu)
         {
@@ -1053,7 +1055,7 @@ namespace osu.Game.Tests.Beatmaps.IO
             Assert.AreEqual(expected, osu.Dependencies.Get<DatabaseContextFactory>().Get().FileInfo.Count(f => f.ReferenceCount == 1));
         }
 
-        private static void ensureLoaded(OsuGameBase osu, int timeout = 60000)
+        private static Task ensureLoaded(OsuGameBase osu, int timeout = 60000) => Task.Factory.StartNew(() =>
         {
             IEnumerable<BeatmapSetInfo> resultSets = null;
             var store = osu.Dependencies.Get<BeatmapManager>();
@@ -1089,14 +1091,14 @@ namespace osu.Game.Tests.Beatmaps.IO
             Assert.IsTrue(beatmap?.HitObjects.Any() == true);
             beatmap = store.GetWorkingBeatmap(set.Beatmaps.First(b => b.RulesetID == 3))?.Beatmap;
             Assert.IsTrue(beatmap?.HitObjects.Any() == true);
-        }
+        }, TaskCreationOptions.LongRunning);
 
         private static void waitForOrAssert(Func<bool> result, string failureMessage, int timeout = 60000)
         {
-            Task task = Task.Run(() =>
+            Task task = Task.Factory.StartNew(() =>
             {
                 while (!result()) Thread.Sleep(200);
-            });
+            }, TaskCreationOptions.LongRunning);
 
             Assert.IsTrue(task.Wait(timeout), failureMessage);
         }

From f9713b8895595c06b35f98a80859904ba7683739 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 3 Jan 2022 18:00:28 +0900
Subject: [PATCH 1907/5547] Replace usage of `TimeoutAttribute` to fix beatmap
 conversion test failures

---
 .../CatchBeatmapConversionTest.cs             |  1 -
 .../ManiaBeatmapConversionTest.cs             |  1 -
 .../OsuBeatmapConversionTest.cs               |  1 -
 .../TaikoBeatmapConversionTest.cs             |  1 -
 .../Tests/Beatmaps/BeatmapConversionTest.cs   | 58 +++++++++++--------
 5 files changed, 34 insertions(+), 28 deletions(-)

diff --git a/osu.Game.Rulesets.Catch.Tests/CatchBeatmapConversionTest.cs b/osu.Game.Rulesets.Catch.Tests/CatchBeatmapConversionTest.cs
index be1885cfa6..baca8166d1 100644
--- a/osu.Game.Rulesets.Catch.Tests/CatchBeatmapConversionTest.cs
+++ b/osu.Game.Rulesets.Catch.Tests/CatchBeatmapConversionTest.cs
@@ -14,7 +14,6 @@ using osu.Game.Tests.Beatmaps;
 namespace osu.Game.Rulesets.Catch.Tests
 {
     [TestFixture]
-    [Timeout(10000)]
     public class CatchBeatmapConversionTest : BeatmapConversionTest<ConvertValue>
     {
         protected override string ResourceAssembly => "osu.Game.Rulesets.Catch";
diff --git a/osu.Game.Rulesets.Mania.Tests/ManiaBeatmapConversionTest.cs b/osu.Game.Rulesets.Mania.Tests/ManiaBeatmapConversionTest.cs
index 948f088b4e..837474ad9e 100644
--- a/osu.Game.Rulesets.Mania.Tests/ManiaBeatmapConversionTest.cs
+++ b/osu.Game.Rulesets.Mania.Tests/ManiaBeatmapConversionTest.cs
@@ -14,7 +14,6 @@ using osu.Game.Tests.Beatmaps;
 namespace osu.Game.Rulesets.Mania.Tests
 {
     [TestFixture]
-    [Timeout(10000)]
     public class ManiaBeatmapConversionTest : BeatmapConversionTest<ManiaConvertMapping, ConvertValue>
     {
         protected override string ResourceAssembly => "osu.Game.Rulesets.Mania";
diff --git a/osu.Game.Rulesets.Osu.Tests/OsuBeatmapConversionTest.cs b/osu.Game.Rulesets.Osu.Tests/OsuBeatmapConversionTest.cs
index 5f44e1b6b6..4c11efcc7c 100644
--- a/osu.Game.Rulesets.Osu.Tests/OsuBeatmapConversionTest.cs
+++ b/osu.Game.Rulesets.Osu.Tests/OsuBeatmapConversionTest.cs
@@ -12,7 +12,6 @@ using osu.Game.Tests.Beatmaps;
 namespace osu.Game.Rulesets.Osu.Tests
 {
     [TestFixture]
-    [Timeout(10000)]
     public class OsuBeatmapConversionTest : BeatmapConversionTest<ConvertValue>
     {
         protected override string ResourceAssembly => "osu.Game.Rulesets.Osu";
diff --git a/osu.Game.Rulesets.Taiko.Tests/TaikoBeatmapConversionTest.cs b/osu.Game.Rulesets.Taiko.Tests/TaikoBeatmapConversionTest.cs
index b6db333dc9..b3f6a733d3 100644
--- a/osu.Game.Rulesets.Taiko.Tests/TaikoBeatmapConversionTest.cs
+++ b/osu.Game.Rulesets.Taiko.Tests/TaikoBeatmapConversionTest.cs
@@ -12,7 +12,6 @@ using osu.Game.Tests.Beatmaps;
 namespace osu.Game.Rulesets.Taiko.Tests
 {
     [TestFixture]
-    [Timeout(10000)]
     public class TaikoBeatmapConversionTest : BeatmapConversionTest<ConvertValue>
     {
         protected override string ResourceAssembly => "osu.Game.Rulesets.Taiko";
diff --git a/osu.Game/Tests/Beatmaps/BeatmapConversionTest.cs b/osu.Game/Tests/Beatmaps/BeatmapConversionTest.cs
index 651874e4de..1b3e49de37 100644
--- a/osu.Game/Tests/Beatmaps/BeatmapConversionTest.cs
+++ b/osu.Game/Tests/Beatmaps/BeatmapConversionTest.cs
@@ -6,9 +6,11 @@ using System.Collections.Generic;
 using System.IO;
 using System.Linq;
 using System.Reflection;
+using System.Threading.Tasks;
 using Newtonsoft.Json;
 using NUnit.Framework;
 using osu.Framework.Audio.Track;
+using osu.Framework.Extensions;
 using osu.Framework.Extensions.ObjectExtensions;
 using osu.Framework.Graphics.Textures;
 using osu.Game.Beatmaps;
@@ -108,37 +110,45 @@ namespace osu.Game.Tests.Beatmaps
 
         private ConvertResult convert(string name, Mod[] mods)
         {
-            var beatmap = GetBeatmap(name);
-
-            string beforeConversion = beatmap.Serialize();
-
-            var converterResult = new Dictionary<HitObject, IEnumerable<HitObject>>();
-
-            var working = new ConversionWorkingBeatmap(beatmap)
+            var conversionTask = Task.Factory.StartNew(() =>
             {
-                ConversionGenerated = (o, r, c) =>
+                var beatmap = GetBeatmap(name);
+
+                string beforeConversion = beatmap.Serialize();
+
+                var converterResult = new Dictionary<HitObject, IEnumerable<HitObject>>();
+
+                var working = new ConversionWorkingBeatmap(beatmap)
                 {
-                    converterResult[o] = r;
-                    OnConversionGenerated(o, r, c);
-                }
-            };
+                    ConversionGenerated = (o, r, c) =>
+                    {
+                        converterResult[o] = r;
+                        OnConversionGenerated(o, r, c);
+                    }
+                };
 
-            working.GetPlayableBeatmap(CreateRuleset().RulesetInfo, mods);
+                working.GetPlayableBeatmap(CreateRuleset().RulesetInfo, mods);
 
-            string afterConversion = beatmap.Serialize();
+                string afterConversion = beatmap.Serialize();
 
-            Assert.AreEqual(beforeConversion, afterConversion, "Conversion altered original beatmap");
+                Assert.AreEqual(beforeConversion, afterConversion, "Conversion altered original beatmap");
 
-            return new ConvertResult
-            {
-                Mappings = converterResult.Select(r =>
+                return new ConvertResult
                 {
-                    var mapping = CreateConvertMapping(r.Key);
-                    mapping.StartTime = r.Key.StartTime;
-                    mapping.Objects.AddRange(r.Value.SelectMany(CreateConvertValue));
-                    return mapping;
-                }).ToList()
-            };
+                    Mappings = converterResult.Select(r =>
+                    {
+                        var mapping = CreateConvertMapping(r.Key);
+                        mapping.StartTime = r.Key.StartTime;
+                        mapping.Objects.AddRange(r.Value.SelectMany(CreateConvertValue));
+                        return mapping;
+                    }).ToList()
+                };
+            }, TaskCreationOptions.LongRunning);
+
+            if (!conversionTask.Wait(10000))
+                Assert.Fail("Conversion timed out");
+
+            return conversionTask.WaitSafelyForResult();
         }
 
         protected virtual void OnConversionGenerated(HitObject original, IEnumerable<HitObject> result, IBeatmapConverter beatmapConverter)

From 374dac57f2b3c4ea34a24929700119fa9a4eb52a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 4 Jan 2022 13:22:00 +0900
Subject: [PATCH 1908/5547] Change expanded card content height to 200

---
 .../Beatmaps/Drawables/Cards/ExpandedContentScrollContainer.cs  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Beatmaps/Drawables/Cards/ExpandedContentScrollContainer.cs b/osu.Game/Beatmaps/Drawables/Cards/ExpandedContentScrollContainer.cs
index 7c3fbdaf1c..edf4c5328c 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/ExpandedContentScrollContainer.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/ExpandedContentScrollContainer.cs
@@ -10,7 +10,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
 {
     public class ExpandedContentScrollContainer : OsuScrollContainer
     {
-        public const float HEIGHT = 400;
+        public const float HEIGHT = 200;
 
         public ExpandedContentScrollContainer()
         {

From 1c899e4402bcc891f3e5a46126fae65151372928 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 4 Jan 2022 16:46:42 +0900
Subject: [PATCH 1909/5547] Fix post-merge issues

---
 .../Visual/UserInterface/TestScenePageSelector.cs      | 10 ----------
 .../UserInterface/PageSelector/DrawablePage.cs         |  2 +-
 .../UserInterface/PageSelector/PageSelector.cs         |  1 +
 .../UserInterface/PageSelector/PageSelectorButton.cs   |  4 ++--
 4 files changed, 4 insertions(+), 13 deletions(-)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestScenePageSelector.cs b/osu.Game.Tests/Visual/UserInterface/TestScenePageSelector.cs
index 6494486d4e..8a15dd9b46 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestScenePageSelector.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestScenePageSelector.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.Collections.Generic;
 using NUnit.Framework;
 using osu.Framework.Graphics;
 using osu.Game.Graphics.UserInterface.PageSelector;
@@ -11,14 +9,6 @@ namespace osu.Game.Tests.Visual.UserInterface
 {
     public class TestScenePageSelector : OsuTestScene
     {
-        public override IReadOnlyList<Type> RequiredTypes => new[]
-        {
-            typeof(PageSelector),
-            typeof(DrawablePage),
-            typeof(PageSelectorButton),
-            typeof(PageSelectorItem)
-        };
-
         private readonly PageSelector pageSelector;
         private readonly DrawablePage drawablePage;
 
diff --git a/osu.Game/Graphics/UserInterface/PageSelector/DrawablePage.cs b/osu.Game/Graphics/UserInterface/PageSelector/DrawablePage.cs
index 20f418085d..4ea610bd89 100644
--- a/osu.Game/Graphics/UserInterface/PageSelector/DrawablePage.cs
+++ b/osu.Game/Graphics/UserInterface/PageSelector/DrawablePage.cs
@@ -57,7 +57,7 @@ namespace osu.Game.Graphics.UserInterface.PageSelector
         private void onSelectedChanged(ValueChangedEvent<bool> selected)
         {
             Background.FadeTo(selected.NewValue ? 1 : 0, DURATION, Easing.OutQuint);
-            text.FadeColour(selected.NewValue ? Colours.GreySeafoamDarker : Colours.Lime, DURATION, Easing.OutQuint);
+            text.FadeColour(selected.NewValue ? Colours.GreySeaFoamDarker : Colours.Lime, DURATION, Easing.OutQuint);
         }
 
         protected override void UpdateHoverState()
diff --git a/osu.Game/Graphics/UserInterface/PageSelector/PageSelector.cs b/osu.Game/Graphics/UserInterface/PageSelector/PageSelector.cs
index 8e055faea3..612cf82b9f 100644
--- a/osu.Game/Graphics/UserInterface/PageSelector/PageSelector.cs
+++ b/osu.Game/Graphics/UserInterface/PageSelector/PageSelector.cs
@@ -21,6 +21,7 @@ namespace osu.Game.Graphics.UserInterface.PageSelector
         public PageSelector()
         {
             AutoSizeAxes = Axes.Both;
+
             InternalChild = new FillFlowContainer
             {
                 AutoSizeAxes = Axes.Both,
diff --git a/osu.Game/Graphics/UserInterface/PageSelector/PageSelectorButton.cs b/osu.Game/Graphics/UserInterface/PageSelector/PageSelectorButton.cs
index e81ce20d27..4eba549dc3 100644
--- a/osu.Game/Graphics/UserInterface/PageSelector/PageSelectorButton.cs
+++ b/osu.Game/Graphics/UserInterface/PageSelector/PageSelectorButton.cs
@@ -63,7 +63,7 @@ namespace osu.Game.Graphics.UserInterface.PageSelector
         [BackgroundDependencyLoader]
         private void load()
         {
-            Background.Colour = Colours.GreySeafoamDark;
+            Background.Colour = Colours.GreySeaFoamDark;
             name.Colour = icon.Colour = Colours.Lime;
         }
 
@@ -73,6 +73,6 @@ namespace osu.Game.Graphics.UserInterface.PageSelector
             Enabled.BindValueChanged(enabled => fadeBox.FadeTo(enabled.NewValue ? 0 : 1, DURATION), true);
         }
 
-        protected override void UpdateHoverState() => Background.FadeColour(IsHovered ? Colours.GreySeafoam : Colours.GreySeafoamDark, DURATION, Easing.OutQuint);
+        protected override void UpdateHoverState() => Background.FadeColour(IsHovered ? Colours.GreySeaFoam : Colours.GreySeaFoamDark, DURATION, Easing.OutQuint);
     }
 }

From 5736b7d978521ebc2010f295ee238f55b1d78356 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 4 Jan 2022 17:12:34 +0900
Subject: [PATCH 1910/5547] Fix cursors sent to osu-web being potentially
 string formatted in incorrect culture

Fixed as per solution at https://github.com/JamesNK/Newtonsoft.Json/issues/874.

Note that due to the use of `JsonExtensionDataAttribute` it's not
feasible to change the actual specification to `JValue` in the
`Dictionary`.

In discussion with the osu-web team, it may be worthwhile to change the cursor
to a string format where parsing is not required at our end. We could already
do this in fact, but there are tests that rely on it being a `JToken` so the
switch to `JValue` seems like the easier path right now.
---
 osu.Game/Extensions/WebRequestExtensions.cs | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Extensions/WebRequestExtensions.cs b/osu.Game/Extensions/WebRequestExtensions.cs
index b940c7498b..50837a648d 100644
--- a/osu.Game/Extensions/WebRequestExtensions.cs
+++ b/osu.Game/Extensions/WebRequestExtensions.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.Globalization;
+using Newtonsoft.Json.Linq;
 using osu.Framework.IO.Network;
 using osu.Framework.Extensions.IEnumerableExtensions;
 using osu.Game.Online.API.Requests;
@@ -16,7 +18,7 @@ namespace osu.Game.Extensions
         {
             cursor?.Properties.ForEach(x =>
             {
-                webRequest.AddParameter("cursor[" + x.Key + "]", x.Value.ToString());
+                webRequest.AddParameter("cursor[" + x.Key + "]", (x.Value as JValue)?.ToString(CultureInfo.InvariantCulture) ?? x.Value.ToString());
             });
         }
     }

From db58f5de8e6ea8c6dd14695b59a39aed33c82c9d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 4 Jan 2022 16:58:32 +0900
Subject: [PATCH 1911/5547] Clean up unnecessary complexity

---
 .../PageSelector/DrawablePage.cs              |  8 +-
 .../PageSelector/PageSelectorButton.cs        | 80 +++++++++++--------
 .../PageSelector/PageSelectorItem.cs          | 12 ++-
 3 files changed, 56 insertions(+), 44 deletions(-)

diff --git a/osu.Game/Graphics/UserInterface/PageSelector/DrawablePage.cs b/osu.Game/Graphics/UserInterface/PageSelector/DrawablePage.cs
index 4ea610bd89..2610ae7571 100644
--- a/osu.Game/Graphics/UserInterface/PageSelector/DrawablePage.cs
+++ b/osu.Game/Graphics/UserInterface/PageSelector/DrawablePage.cs
@@ -15,20 +15,16 @@ namespace osu.Game.Graphics.UserInterface.PageSelector
 
         public bool Selected
         {
-            get => selected.Value;
             set => selected.Value = value;
         }
 
-        public int Page { get; private set; }
+        public int Page { get; }
 
         private OsuSpriteText text;
 
         public DrawablePage(int page)
         {
             Page = page;
-            text.Text = page.ToString();
-
-            Background.Alpha = 0;
 
             Action = () =>
             {
@@ -40,12 +36,14 @@ namespace osu.Game.Graphics.UserInterface.PageSelector
         protected override Drawable CreateContent() => text = new OsuSpriteText
         {
             Font = OsuFont.GetFont(size: 12),
+            Text = Page.ToString(),
         };
 
         [BackgroundDependencyLoader]
         private void load()
         {
             Background.Colour = Colours.Lime;
+            Background.Alpha = 0;
         }
 
         protected override void LoadComplete()
diff --git a/osu.Game/Graphics/UserInterface/PageSelector/PageSelectorButton.cs b/osu.Game/Graphics/UserInterface/PageSelector/PageSelectorButton.cs
index 4eba549dc3..1492319fc9 100644
--- a/osu.Game/Graphics/UserInterface/PageSelector/PageSelectorButton.cs
+++ b/osu.Game/Graphics/UserInterface/PageSelector/PageSelectorButton.cs
@@ -1,61 +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 osu.Framework.Graphics.Containers;
-using osu.Framework.Graphics;
 using osu.Framework.Allocation;
-using osu.Framework.Graphics.Shapes;
 using osu.Framework.Extensions.Color4Extensions;
-using osu.Game.Graphics.Sprites;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.Shapes;
 using osu.Framework.Graphics.Sprites;
-using osuTK.Graphics;
+using osu.Game.Graphics.Sprites;
 using osuTK;
-using osu.Framework.Extensions.IEnumerableExtensions;
+using osuTK.Graphics;
 
 namespace osu.Game.Graphics.UserInterface.PageSelector
 {
     public class PageSelectorButton : PageSelectorItem
     {
-        private readonly Box fadeBox;
+        private readonly string text;
+
+        private Box fadeBox;
         private SpriteIcon icon;
         private OsuSpriteText name;
-        private FillFlowContainer buttonContent;
+
+        private readonly Anchor alignment;
 
         public PageSelectorButton(bool rightAligned, string text)
         {
-            Add(fadeBox = new Box
-            {
-                RelativeSizeAxes = Axes.Both,
-                Colour = Color4.Black.Opacity(100)
-            });
-
-            var alignment = rightAligned ? Anchor.x0 : Anchor.x2;
-
-            buttonContent.ForEach(drawable =>
-            {
-                drawable.Anchor = Anchor.y1 | alignment;
-                drawable.Origin = Anchor.y1 | alignment;
-            });
-
-            icon.Icon = alignment == Anchor.x2 ? FontAwesome.Solid.ChevronLeft : FontAwesome.Solid.ChevronRight;
-
-            name.Text = text.ToUpper();
+            this.text = text;
+            alignment = rightAligned ? Anchor.x0 : Anchor.x2;
         }
 
-        protected override Drawable CreateContent() => buttonContent = new FillFlowContainer
+        protected override Drawable CreateContent() => new Container
         {
-            AutoSizeAxes = Axes.Both,
-            Direction = FillDirection.Horizontal,
-            Spacing = new Vector2(3, 0),
+            RelativeSizeAxes = Axes.Y,
+            AutoSizeAxes = Axes.X,
             Children = new Drawable[]
             {
-                name = new OsuSpriteText
+                new FillFlowContainer
                 {
-                    Font = OsuFont.GetFont(size: 12),
-                },
-                icon = new SpriteIcon
-                {
-                    Size = new Vector2(8),
+                    AutoSizeAxes = Axes.Both,
+                    Direction = FillDirection.Horizontal,
+                    Anchor = Anchor.Centre,
+                    Origin = Anchor.Centre,
+                    Spacing = new Vector2(3, 0),
+                    Children = new Drawable[]
+                    {
+                        name = new OsuSpriteText
+                        {
+                            Font = OsuFont.GetFont(size: 12),
+                            Anchor = Anchor.Centre,
+                            Origin = Anchor.Centre,
+                            Text = text.ToUpper(),
+                        },
+                        icon = new SpriteIcon
+                        {
+                            Icon = alignment == Anchor.x2 ? FontAwesome.Solid.ChevronLeft : FontAwesome.Solid.ChevronRight,
+                            Size = new Vector2(8),
+                            Anchor = Anchor.Centre,
+                            Origin = Anchor.Centre,
+                        },
+                    }
                 },
             }
         };
@@ -70,6 +73,13 @@ namespace osu.Game.Graphics.UserInterface.PageSelector
         protected override void LoadComplete()
         {
             base.LoadComplete();
+
+            CircularContent.Add(fadeBox = new Box
+            {
+                RelativeSizeAxes = Axes.Both,
+                Colour = Color4.Black.Opacity(100)
+            });
+
             Enabled.BindValueChanged(enabled => fadeBox.FadeTo(enabled.NewValue ? 0 : 1, DURATION), true);
         }
 
diff --git a/osu.Game/Graphics/UserInterface/PageSelector/PageSelectorItem.cs b/osu.Game/Graphics/UserInterface/PageSelector/PageSelectorItem.cs
index cd61961dbe..92bf958ca9 100644
--- a/osu.Game/Graphics/UserInterface/PageSelector/PageSelectorItem.cs
+++ b/osu.Game/Graphics/UserInterface/PageSelector/PageSelectorItem.cs
@@ -18,16 +18,20 @@ namespace osu.Game.Graphics.UserInterface.PageSelector
         [Resolved]
         protected OsuColour Colours { get; private set; }
 
-        protected override Container<Drawable> Content => content;
+        protected Box Background;
 
-        protected readonly Box Background;
-        private readonly CircularContainer content;
+        public CircularContainer CircularContent { get; private set; }
 
         protected PageSelectorItem()
         {
             AutoSizeAxes = Axes.X;
             Height = 20;
-            base.Content.Add(content = new CircularContainer
+        }
+
+        [BackgroundDependencyLoader]
+        private void load()
+        {
+            Add(CircularContent = new CircularContainer
             {
                 RelativeSizeAxes = Axes.Y,
                 AutoSizeAxes = Axes.X,

From ee4f5c0e79e11c2f8e9a9c574beddb16a2174652 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 4 Jan 2022 17:52:40 +0900
Subject: [PATCH 1912/5547] Rename button classes to make more sense

---
 .../UserInterface/TestScenePageSelector.cs    |   8 +-
 .../PageSelector/PageSelector.cs              |  14 +--
 .../PageSelector/PageSelectorButton.cs        | 112 ++++++++----------
 .../PageSelector/PageSelectorItem.cs          |  72 -----------
 ...wablePage.cs => PageSelectorPageButton.cs} |   4 +-
 .../PageSelectorPrevNextButton.cs             |  88 ++++++++++++++
 6 files changed, 149 insertions(+), 149 deletions(-)
 delete mode 100644 osu.Game/Graphics/UserInterface/PageSelector/PageSelectorItem.cs
 rename osu.Game/Graphics/UserInterface/PageSelector/{DrawablePage.cs => PageSelectorPageButton.cs} (94%)
 create mode 100644 osu.Game/Graphics/UserInterface/PageSelector/PageSelectorPrevNextButton.cs

diff --git a/osu.Game.Tests/Visual/UserInterface/TestScenePageSelector.cs b/osu.Game.Tests/Visual/UserInterface/TestScenePageSelector.cs
index 8a15dd9b46..000e75be31 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestScenePageSelector.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestScenePageSelector.cs
@@ -10,7 +10,7 @@ namespace osu.Game.Tests.Visual.UserInterface
     public class TestScenePageSelector : OsuTestScene
     {
         private readonly PageSelector pageSelector;
-        private readonly DrawablePage drawablePage;
+        private readonly PageSelectorPageButton pageSelectorPageButton;
 
         public TestScenePageSelector()
         {
@@ -21,7 +21,7 @@ namespace osu.Game.Tests.Visual.UserInterface
                     Anchor = Anchor.Centre,
                     Origin = Anchor.Centre,
                 },
-                drawablePage = new DrawablePage(1234)
+                pageSelectorPageButton = new PageSelectorPageButton(1234)
                 {
                     Anchor = Anchor.TopCentre,
                     Origin = Anchor.TopCentre,
@@ -61,8 +61,8 @@ namespace osu.Game.Tests.Visual.UserInterface
         [Test]
         public void TestDrawablePage()
         {
-            AddStep("Select", () => drawablePage.Selected = true);
-            AddStep("Deselect", () => drawablePage.Selected = false);
+            AddStep("Select", () => pageSelectorPageButton.Selected = true);
+            AddStep("Deselect", () => pageSelectorPageButton.Selected = false);
         }
 
         private void setMaxPages(int maxPages) => pageSelector.MaxPages.Value = maxPages;
diff --git a/osu.Game/Graphics/UserInterface/PageSelector/PageSelector.cs b/osu.Game/Graphics/UserInterface/PageSelector/PageSelector.cs
index 612cf82b9f..4089fb5511 100644
--- a/osu.Game/Graphics/UserInterface/PageSelector/PageSelector.cs
+++ b/osu.Game/Graphics/UserInterface/PageSelector/PageSelector.cs
@@ -13,10 +13,10 @@ namespace osu.Game.Graphics.UserInterface.PageSelector
         public readonly BindableInt CurrentPage = new BindableInt(1);
         public readonly BindableInt MaxPages = new BindableInt(1);
 
-        private readonly FillFlowContainer<DrawablePage> itemsFlow;
+        private readonly FillFlowContainer<PageSelectorPageButton> itemsFlow;
 
-        private readonly PageSelectorButton previousPageButton;
-        private readonly PageSelectorButton nextPageButton;
+        private readonly PageSelectorPrevNextButton previousPageButton;
+        private readonly PageSelectorPrevNextButton nextPageButton;
 
         public PageSelector()
         {
@@ -28,16 +28,16 @@ namespace osu.Game.Graphics.UserInterface.PageSelector
                 Direction = FillDirection.Horizontal,
                 Children = new Drawable[]
                 {
-                    previousPageButton = new PageSelectorButton(false, "prev")
+                    previousPageButton = new PageSelectorPrevNextButton(false, "prev")
                     {
                         Action = () => CurrentPage.Value -= 1,
                     },
-                    itemsFlow = new FillFlowContainer<DrawablePage>
+                    itemsFlow = new FillFlowContainer<PageSelectorPageButton>
                     {
                         AutoSizeAxes = Axes.Both,
                         Direction = FillDirection.Horizontal,
                     },
-                    nextPageButton = new PageSelectorButton(true, "next")
+                    nextPageButton = new PageSelectorPrevNextButton(true, "next")
                     {
                         Action = () => CurrentPage.Value += 1
                     }
@@ -100,7 +100,7 @@ namespace osu.Game.Graphics.UserInterface.PageSelector
             nextPageButton.Enabled.Value = newPage != maxPages;
         }
 
-        private void addDrawablePage(int page) => itemsFlow.Add(new DrawablePage(page)
+        private void addDrawablePage(int page) => itemsFlow.Add(new PageSelectorPageButton(page)
         {
             Action = () => CurrentPage.Value = page,
         });
diff --git a/osu.Game/Graphics/UserInterface/PageSelector/PageSelectorButton.cs b/osu.Game/Graphics/UserInterface/PageSelector/PageSelectorButton.cs
index 1492319fc9..bdfe66f1d0 100644
--- a/osu.Game/Graphics/UserInterface/PageSelector/PageSelectorButton.cs
+++ b/osu.Game/Graphics/UserInterface/PageSelector/PageSelectorButton.cs
@@ -1,88 +1,72 @@
 // 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.Extensions.Color4Extensions;
-using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics;
+using osu.Framework.Allocation;
 using osu.Framework.Graphics.Shapes;
-using osu.Framework.Graphics.Sprites;
-using osu.Game.Graphics.Sprites;
-using osuTK;
-using osuTK.Graphics;
+using osu.Game.Graphics.Containers;
+using osu.Framework.Input.Events;
+using JetBrains.Annotations;
 
 namespace osu.Game.Graphics.UserInterface.PageSelector
 {
-    public class PageSelectorButton : PageSelectorItem
+    public abstract class PageSelectorButton : OsuClickableContainer
     {
-        private readonly string text;
+        protected const int DURATION = 200;
 
-        private Box fadeBox;
-        private SpriteIcon icon;
-        private OsuSpriteText name;
+        [Resolved]
+        protected OsuColour Colours { get; private set; }
 
-        private readonly Anchor alignment;
+        protected Box Background;
 
-        public PageSelectorButton(bool rightAligned, string text)
+        public CircularContainer CircularContent { get; private set; }
+
+        protected PageSelectorButton()
         {
-            this.text = text;
-            alignment = rightAligned ? Anchor.x0 : Anchor.x2;
+            AutoSizeAxes = Axes.X;
+            Height = 20;
         }
 
-        protected override Drawable CreateContent() => new Container
-        {
-            RelativeSizeAxes = Axes.Y,
-            AutoSizeAxes = Axes.X,
-            Children = new Drawable[]
-            {
-                new FillFlowContainer
-                {
-                    AutoSizeAxes = Axes.Both,
-                    Direction = FillDirection.Horizontal,
-                    Anchor = Anchor.Centre,
-                    Origin = Anchor.Centre,
-                    Spacing = new Vector2(3, 0),
-                    Children = new Drawable[]
-                    {
-                        name = new OsuSpriteText
-                        {
-                            Font = OsuFont.GetFont(size: 12),
-                            Anchor = Anchor.Centre,
-                            Origin = Anchor.Centre,
-                            Text = text.ToUpper(),
-                        },
-                        icon = new SpriteIcon
-                        {
-                            Icon = alignment == Anchor.x2 ? FontAwesome.Solid.ChevronLeft : FontAwesome.Solid.ChevronRight,
-                            Size = new Vector2(8),
-                            Anchor = Anchor.Centre,
-                            Origin = Anchor.Centre,
-                        },
-                    }
-                },
-            }
-        };
-
         [BackgroundDependencyLoader]
         private void load()
         {
-            Background.Colour = Colours.GreySeaFoamDark;
-            name.Colour = icon.Colour = Colours.Lime;
-        }
-
-        protected override void LoadComplete()
-        {
-            base.LoadComplete();
-
-            CircularContent.Add(fadeBox = new Box
+            Add(CircularContent = new CircularContainer
             {
-                RelativeSizeAxes = Axes.Both,
-                Colour = Color4.Black.Opacity(100)
+                RelativeSizeAxes = Axes.Y,
+                AutoSizeAxes = Axes.X,
+                Masking = true,
+                Children = new[]
+                {
+                    Background = new Box
+                    {
+                        RelativeSizeAxes = Axes.Both
+                    },
+                    CreateContent().With(content =>
+                    {
+                        content.Anchor = Anchor.Centre;
+                        content.Origin = Anchor.Centre;
+                        content.Margin = new MarginPadding { Horizontal = 10 };
+                    })
+                }
             });
-
-            Enabled.BindValueChanged(enabled => fadeBox.FadeTo(enabled.NewValue ? 0 : 1, DURATION), true);
         }
 
-        protected override void UpdateHoverState() => Background.FadeColour(IsHovered ? Colours.GreySeaFoam : Colours.GreySeaFoamDark, DURATION, Easing.OutQuint);
+        [NotNull]
+        protected abstract Drawable CreateContent();
+
+        protected override bool OnHover(HoverEvent e)
+        {
+            UpdateHoverState();
+            return base.OnHover(e);
+        }
+
+        protected override void OnHoverLost(HoverLostEvent e)
+        {
+            base.OnHoverLost(e);
+            UpdateHoverState();
+        }
+
+        protected abstract void UpdateHoverState();
     }
 }
diff --git a/osu.Game/Graphics/UserInterface/PageSelector/PageSelectorItem.cs b/osu.Game/Graphics/UserInterface/PageSelector/PageSelectorItem.cs
deleted file mode 100644
index 92bf958ca9..0000000000
--- a/osu.Game/Graphics/UserInterface/PageSelector/PageSelectorItem.cs
+++ /dev/null
@@ -1,72 +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.Containers;
-using osu.Framework.Graphics;
-using osu.Framework.Allocation;
-using osu.Framework.Graphics.Shapes;
-using osu.Game.Graphics.Containers;
-using osu.Framework.Input.Events;
-using JetBrains.Annotations;
-
-namespace osu.Game.Graphics.UserInterface.PageSelector
-{
-    public abstract class PageSelectorItem : OsuClickableContainer
-    {
-        protected const int DURATION = 200;
-
-        [Resolved]
-        protected OsuColour Colours { get; private set; }
-
-        protected Box Background;
-
-        public CircularContainer CircularContent { get; private set; }
-
-        protected PageSelectorItem()
-        {
-            AutoSizeAxes = Axes.X;
-            Height = 20;
-        }
-
-        [BackgroundDependencyLoader]
-        private void load()
-        {
-            Add(CircularContent = new CircularContainer
-            {
-                RelativeSizeAxes = Axes.Y,
-                AutoSizeAxes = Axes.X,
-                Masking = true,
-                Children = new[]
-                {
-                    Background = new Box
-                    {
-                        RelativeSizeAxes = Axes.Both
-                    },
-                    CreateContent().With(content =>
-                    {
-                        content.Anchor = Anchor.Centre;
-                        content.Origin = Anchor.Centre;
-                        content.Margin = new MarginPadding { Horizontal = 10 };
-                    })
-                }
-            });
-        }
-
-        [NotNull]
-        protected abstract Drawable CreateContent();
-
-        protected override bool OnHover(HoverEvent e)
-        {
-            UpdateHoverState();
-            return base.OnHover(e);
-        }
-
-        protected override void OnHoverLost(HoverLostEvent e)
-        {
-            base.OnHoverLost(e);
-            UpdateHoverState();
-        }
-
-        protected abstract void UpdateHoverState();
-    }
-}
diff --git a/osu.Game/Graphics/UserInterface/PageSelector/DrawablePage.cs b/osu.Game/Graphics/UserInterface/PageSelector/PageSelectorPageButton.cs
similarity index 94%
rename from osu.Game/Graphics/UserInterface/PageSelector/DrawablePage.cs
rename to osu.Game/Graphics/UserInterface/PageSelector/PageSelectorPageButton.cs
index 2610ae7571..81ab7c7155 100644
--- a/osu.Game/Graphics/UserInterface/PageSelector/DrawablePage.cs
+++ b/osu.Game/Graphics/UserInterface/PageSelector/PageSelectorPageButton.cs
@@ -9,7 +9,7 @@ using osu.Game.Graphics.Sprites;
 
 namespace osu.Game.Graphics.UserInterface.PageSelector
 {
-    public class DrawablePage : PageSelectorItem
+    public class PageSelectorPageButton : PageSelectorButton
     {
         private readonly BindableBool selected = new BindableBool();
 
@@ -22,7 +22,7 @@ namespace osu.Game.Graphics.UserInterface.PageSelector
 
         private OsuSpriteText text;
 
-        public DrawablePage(int page)
+        public PageSelectorPageButton(int page)
         {
             Page = page;
 
diff --git a/osu.Game/Graphics/UserInterface/PageSelector/PageSelectorPrevNextButton.cs b/osu.Game/Graphics/UserInterface/PageSelector/PageSelectorPrevNextButton.cs
new file mode 100644
index 0000000000..eaa3714fea
--- /dev/null
+++ b/osu.Game/Graphics/UserInterface/PageSelector/PageSelectorPrevNextButton.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.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.Game.Graphics.Sprites;
+using osuTK;
+using osuTK.Graphics;
+
+namespace osu.Game.Graphics.UserInterface.PageSelector
+{
+    public class PageSelectorPrevNextButton : PageSelectorButton
+    {
+        private readonly string text;
+
+        private Box fadeBox;
+        private SpriteIcon icon;
+        private OsuSpriteText name;
+
+        private readonly Anchor alignment;
+
+        public PageSelectorPrevNextButton(bool rightAligned, string text)
+        {
+            this.text = text;
+            alignment = rightAligned ? Anchor.x0 : Anchor.x2;
+        }
+
+        protected override Drawable CreateContent() => new Container
+        {
+            RelativeSizeAxes = Axes.Y,
+            AutoSizeAxes = Axes.X,
+            Children = new Drawable[]
+            {
+                new FillFlowContainer
+                {
+                    AutoSizeAxes = Axes.Both,
+                    Direction = FillDirection.Horizontal,
+                    Anchor = Anchor.Centre,
+                    Origin = Anchor.Centre,
+                    Spacing = new Vector2(3, 0),
+                    Children = new Drawable[]
+                    {
+                        name = new OsuSpriteText
+                        {
+                            Font = OsuFont.GetFont(size: 12),
+                            Anchor = Anchor.Centre,
+                            Origin = Anchor.Centre,
+                            Text = text.ToUpper(),
+                        },
+                        icon = new SpriteIcon
+                        {
+                            Icon = alignment == Anchor.x2 ? FontAwesome.Solid.ChevronLeft : FontAwesome.Solid.ChevronRight,
+                            Size = new Vector2(8),
+                            Anchor = Anchor.Centre,
+                            Origin = Anchor.Centre,
+                        },
+                    }
+                },
+            }
+        };
+
+        [BackgroundDependencyLoader]
+        private void load()
+        {
+            Background.Colour = Colours.GreySeaFoamDark;
+            name.Colour = icon.Colour = Colours.Lime;
+        }
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            CircularContent.Add(fadeBox = new Box
+            {
+                RelativeSizeAxes = Axes.Both,
+                Colour = Color4.Black.Opacity(100)
+            });
+
+            Enabled.BindValueChanged(enabled => fadeBox.FadeTo(enabled.NewValue ? 0 : 1, DURATION), true);
+        }
+
+        protected override void UpdateHoverState() => Background.FadeColour(IsHovered ? Colours.GreySeaFoam : Colours.GreySeaFoamDark, DURATION, Easing.OutQuint);
+    }
+}

From d10b8c79b39682f144f7c117a7c8278822485bfb Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 4 Jan 2022 17:53:23 +0900
Subject: [PATCH 1913/5547] Remove pointless test coverage of `DrawablePage`

---
 .../Visual/UserInterface/TestScenePageSelector.cs  | 14 --------------
 1 file changed, 14 deletions(-)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestScenePageSelector.cs b/osu.Game.Tests/Visual/UserInterface/TestScenePageSelector.cs
index 000e75be31..b65af6b1f5 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestScenePageSelector.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestScenePageSelector.cs
@@ -10,7 +10,6 @@ namespace osu.Game.Tests.Visual.UserInterface
     public class TestScenePageSelector : OsuTestScene
     {
         private readonly PageSelector pageSelector;
-        private readonly PageSelectorPageButton pageSelectorPageButton;
 
         public TestScenePageSelector()
         {
@@ -21,12 +20,6 @@ namespace osu.Game.Tests.Visual.UserInterface
                     Anchor = Anchor.Centre,
                     Origin = Anchor.Centre,
                 },
-                pageSelectorPageButton = new PageSelectorPageButton(1234)
-                {
-                    Anchor = Anchor.TopCentre,
-                    Origin = Anchor.TopCentre,
-                    Margin = new MarginPadding { Top = 50 },
-                }
             });
         }
 
@@ -58,13 +51,6 @@ namespace osu.Game.Tests.Visual.UserInterface
             AddAssert("Max is 1", () => pageSelector.MaxPages.Value == 1);
         }
 
-        [Test]
-        public void TestDrawablePage()
-        {
-            AddStep("Select", () => pageSelectorPageButton.Selected = true);
-            AddStep("Deselect", () => pageSelectorPageButton.Selected = false);
-        }
-
         private void setMaxPages(int maxPages) => pageSelector.MaxPages.Value = maxPages;
 
         private void setCurrentPage(int currentPage) => pageSelector.CurrentPage.Value = currentPage;

From 5a11ee7810b705461360c2b3daa2e27b1e3b05ff Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 4 Jan 2022 18:14:42 +0900
Subject: [PATCH 1914/5547] Use `OverlayColourProvider` and fix font weight

---
 .../UserInterface/TestScenePageSelector.cs    |  5 +++
 .../PageSelector/PageSelectorButton.cs        |  7 ++--
 .../PageSelector/PageSelectorPageButton.cs    |  9 +++--
 .../PageSelectorPrevNextButton.cs             | 34 +++++++------------
 4 files changed, 24 insertions(+), 31 deletions(-)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestScenePageSelector.cs b/osu.Game.Tests/Visual/UserInterface/TestScenePageSelector.cs
index b65af6b1f5..1595a7f22d 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestScenePageSelector.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestScenePageSelector.cs
@@ -2,13 +2,18 @@
 // 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.Game.Graphics.UserInterface.PageSelector;
+using osu.Game.Overlays;
 
 namespace osu.Game.Tests.Visual.UserInterface
 {
     public class TestScenePageSelector : OsuTestScene
     {
+        [Cached]
+        private OverlayColourProvider provider { get; } = new OverlayColourProvider(OverlayColourScheme.Green);
+
         private readonly PageSelector pageSelector;
 
         public TestScenePageSelector()
diff --git a/osu.Game/Graphics/UserInterface/PageSelector/PageSelectorButton.cs b/osu.Game/Graphics/UserInterface/PageSelector/PageSelectorButton.cs
index bdfe66f1d0..a2c6e8532b 100644
--- a/osu.Game/Graphics/UserInterface/PageSelector/PageSelectorButton.cs
+++ b/osu.Game/Graphics/UserInterface/PageSelector/PageSelectorButton.cs
@@ -8,6 +8,7 @@ using osu.Framework.Graphics.Shapes;
 using osu.Game.Graphics.Containers;
 using osu.Framework.Input.Events;
 using JetBrains.Annotations;
+using osu.Game.Overlays;
 
 namespace osu.Game.Graphics.UserInterface.PageSelector
 {
@@ -16,12 +17,10 @@ namespace osu.Game.Graphics.UserInterface.PageSelector
         protected const int DURATION = 200;
 
         [Resolved]
-        protected OsuColour Colours { get; private set; }
+        protected OverlayColourProvider ColourProvider { get; private set; }
 
         protected Box Background;
 
-        public CircularContainer CircularContent { get; private set; }
-
         protected PageSelectorButton()
         {
             AutoSizeAxes = Axes.X;
@@ -31,7 +30,7 @@ namespace osu.Game.Graphics.UserInterface.PageSelector
         [BackgroundDependencyLoader]
         private void load()
         {
-            Add(CircularContent = new CircularContainer
+            Add(new CircularContainer
             {
                 RelativeSizeAxes = Axes.Y,
                 AutoSizeAxes = Axes.X,
diff --git a/osu.Game/Graphics/UserInterface/PageSelector/PageSelectorPageButton.cs b/osu.Game/Graphics/UserInterface/PageSelector/PageSelectorPageButton.cs
index 81ab7c7155..31aca0d2f2 100644
--- a/osu.Game/Graphics/UserInterface/PageSelector/PageSelectorPageButton.cs
+++ b/osu.Game/Graphics/UserInterface/PageSelector/PageSelectorPageButton.cs
@@ -4,7 +4,6 @@
 using osu.Framework.Graphics;
 using osu.Framework.Bindables;
 using osu.Framework.Allocation;
-using osu.Framework.Extensions.Color4Extensions;
 using osu.Game.Graphics.Sprites;
 
 namespace osu.Game.Graphics.UserInterface.PageSelector
@@ -35,14 +34,14 @@ namespace osu.Game.Graphics.UserInterface.PageSelector
 
         protected override Drawable CreateContent() => text = new OsuSpriteText
         {
-            Font = OsuFont.GetFont(size: 12),
+            Font = OsuFont.GetFont(size: 12, weight: FontWeight.SemiBold),
             Text = Page.ToString(),
         };
 
         [BackgroundDependencyLoader]
         private void load()
         {
-            Background.Colour = Colours.Lime;
+            Background.Colour = ColourProvider.Highlight1;
             Background.Alpha = 0;
         }
 
@@ -55,7 +54,7 @@ namespace osu.Game.Graphics.UserInterface.PageSelector
         private void onSelectedChanged(ValueChangedEvent<bool> selected)
         {
             Background.FadeTo(selected.NewValue ? 1 : 0, DURATION, Easing.OutQuint);
-            text.FadeColour(selected.NewValue ? Colours.GreySeaFoamDarker : Colours.Lime, DURATION, Easing.OutQuint);
+            text.FadeColour(selected.NewValue ? ColourProvider.Dark4 : ColourProvider.Light3, DURATION, Easing.OutQuint);
         }
 
         protected override void UpdateHoverState()
@@ -63,7 +62,7 @@ namespace osu.Game.Graphics.UserInterface.PageSelector
             if (selected.Value)
                 return;
 
-            text.FadeColour(IsHovered ? Colours.Lime.Lighten(20f) : Colours.Lime, DURATION, Easing.OutQuint);
+            text.FadeColour(IsHovered ? ColourProvider.Light2 : ColourProvider.Light1, DURATION, Easing.OutQuint);
         }
     }
 }
diff --git a/osu.Game/Graphics/UserInterface/PageSelector/PageSelectorPrevNextButton.cs b/osu.Game/Graphics/UserInterface/PageSelector/PageSelectorPrevNextButton.cs
index eaa3714fea..7503ab8135 100644
--- a/osu.Game/Graphics/UserInterface/PageSelector/PageSelectorPrevNextButton.cs
+++ b/osu.Game/Graphics/UserInterface/PageSelector/PageSelectorPrevNextButton.cs
@@ -2,31 +2,26 @@
 // See the LICENCE file in the repository root for full licence text.
 
 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.Game.Graphics.Sprites;
 using osuTK;
-using osuTK.Graphics;
 
 namespace osu.Game.Graphics.UserInterface.PageSelector
 {
     public class PageSelectorPrevNextButton : PageSelectorButton
     {
+        private readonly bool rightAligned;
         private readonly string text;
 
-        private Box fadeBox;
         private SpriteIcon icon;
         private OsuSpriteText name;
 
-        private readonly Anchor alignment;
-
         public PageSelectorPrevNextButton(bool rightAligned, string text)
         {
+            this.rightAligned = rightAligned;
             this.text = text;
-            alignment = rightAligned ? Anchor.x0 : Anchor.x2;
         }
 
         protected override Drawable CreateContent() => new Container
@@ -47,16 +42,16 @@ namespace osu.Game.Graphics.UserInterface.PageSelector
                         name = new OsuSpriteText
                         {
                             Font = OsuFont.GetFont(size: 12),
-                            Anchor = Anchor.Centre,
-                            Origin = Anchor.Centre,
+                            Anchor = rightAligned ? Anchor.CentreLeft : Anchor.CentreRight,
+                            Origin = rightAligned ? Anchor.CentreLeft : Anchor.CentreRight,
                             Text = text.ToUpper(),
                         },
                         icon = new SpriteIcon
                         {
-                            Icon = alignment == Anchor.x2 ? FontAwesome.Solid.ChevronLeft : FontAwesome.Solid.ChevronRight,
+                            Icon = rightAligned ? FontAwesome.Solid.ChevronRight : FontAwesome.Solid.ChevronLeft,
                             Size = new Vector2(8),
-                            Anchor = Anchor.Centre,
-                            Origin = Anchor.Centre,
+                            Anchor = rightAligned ? Anchor.CentreLeft : Anchor.CentreRight,
+                            Origin = rightAligned ? Anchor.CentreLeft : Anchor.CentreRight,
                         },
                     }
                 },
@@ -66,23 +61,18 @@ namespace osu.Game.Graphics.UserInterface.PageSelector
         [BackgroundDependencyLoader]
         private void load()
         {
-            Background.Colour = Colours.GreySeaFoamDark;
-            name.Colour = icon.Colour = Colours.Lime;
+            Background.Colour = ColourProvider.Dark4;
+            name.Colour = icon.Colour = ColourProvider.Light1;
         }
 
         protected override void LoadComplete()
         {
             base.LoadComplete();
 
-            CircularContent.Add(fadeBox = new Box
-            {
-                RelativeSizeAxes = Axes.Both,
-                Colour = Color4.Black.Opacity(100)
-            });
-
-            Enabled.BindValueChanged(enabled => fadeBox.FadeTo(enabled.NewValue ? 0 : 1, DURATION), true);
+            Enabled.BindValueChanged(enabled => Background.FadeTo(enabled.NewValue ? 1 : 0.5f, DURATION), true);
         }
 
-        protected override void UpdateHoverState() => Background.FadeColour(IsHovered ? Colours.GreySeaFoam : Colours.GreySeaFoamDark, DURATION, Easing.OutQuint);
+        protected override void UpdateHoverState() =>
+            Background.FadeColour(IsHovered ? ColourProvider.Dark3 : ColourProvider.Dark4, DURATION, Easing.OutQuint);
     }
 }

From e75c9519f32f8e44e1beac1e57b83798a1f8d547 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 4 Jan 2022 18:19:23 +0900
Subject: [PATCH 1915/5547] Adjust font weighting on selection

---
 .../UserInterface/PageSelector/PageSelectorPageButton.cs        | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/osu.Game/Graphics/UserInterface/PageSelector/PageSelectorPageButton.cs b/osu.Game/Graphics/UserInterface/PageSelector/PageSelectorPageButton.cs
index 31aca0d2f2..6aac75565e 100644
--- a/osu.Game/Graphics/UserInterface/PageSelector/PageSelectorPageButton.cs
+++ b/osu.Game/Graphics/UserInterface/PageSelector/PageSelectorPageButton.cs
@@ -54,7 +54,9 @@ namespace osu.Game.Graphics.UserInterface.PageSelector
         private void onSelectedChanged(ValueChangedEvent<bool> selected)
         {
             Background.FadeTo(selected.NewValue ? 1 : 0, DURATION, Easing.OutQuint);
+
             text.FadeColour(selected.NewValue ? ColourProvider.Dark4 : ColourProvider.Light3, DURATION, Easing.OutQuint);
+            text.Font = text.Font.With(weight: IsHovered ? FontWeight.SemiBold : FontWeight.Regular);
         }
 
         protected override void UpdateHoverState()

From 86f72b71b1229c165d30d419047165b00cdaafc7 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 4 Jan 2022 18:46:44 +0900
Subject: [PATCH 1916/5547] Prepare tests and general structure to support
 omission of pages

---
 .../UserInterface/TestScenePageSelector.cs    | 42 ++++++------
 .../PageSelector/PageSelector.cs              | 66 +++++++------------
 .../PageSelector/PageSelectorPageButton.cs    |  8 +--
 3 files changed, 52 insertions(+), 64 deletions(-)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestScenePageSelector.cs b/osu.Game.Tests/Visual/UserInterface/TestScenePageSelector.cs
index 1595a7f22d..3b32a2a0dc 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestScenePageSelector.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestScenePageSelector.cs
@@ -1,9 +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.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
+using osu.Framework.Testing;
 using osu.Game.Graphics.UserInterface.PageSelector;
 using osu.Game.Overlays;
 
@@ -28,36 +30,38 @@ namespace osu.Game.Tests.Visual.UserInterface
             });
         }
 
+        [Test]
+        public void TestOmittedPages()
+        {
+            setAvailablePages(100);
+
+            AddAssert("Correct page buttons", () => pageSelector.ChildrenOfType<PageSelectorPageButton>().Select(p => p.PageNumber).SequenceEqual(new[] { 1, 2, 3, 100 }));
+        }
+
         [Test]
         public void TestResetCurrentPage()
         {
-            AddStep("Set 10 pages", () => setMaxPages(10));
-            AddStep("Select page 5", () => setCurrentPage(5));
-            AddStep("Set 11 pages", () => setMaxPages(11));
-            AddAssert("Page 1 is current", () => pageSelector.CurrentPage.Value == 1);
+            setAvailablePages(10);
+            selectPage(6);
+            setAvailablePages(11);
+            AddAssert("Page 1 is current", () => pageSelector.CurrentPage.Value == 0);
         }
 
         [Test]
         public void TestOutOfBoundsSelection()
         {
-            AddStep("Set 10 pages", () => setMaxPages(10));
-            AddStep("Select page 11", () => setCurrentPage(11));
-            AddAssert("Page 10 is current", () => pageSelector.CurrentPage.Value == pageSelector.MaxPages.Value);
+            setAvailablePages(10);
+            selectPage(11);
+            AddAssert("Page 10 is current", () => pageSelector.CurrentPage.Value == pageSelector.AvailablePages.Value - 1);
 
-            AddStep("Select page -1", () => setCurrentPage(-1));
-            AddAssert("Page 1 is current", () => pageSelector.CurrentPage.Value == 1);
+            selectPage(-1);
+            AddAssert("Page 1 is current", () => pageSelector.CurrentPage.Value == 0);
         }
 
-        [Test]
-        public void TestNegativeMaxPages()
-        {
-            AddStep("Set -10 pages", () => setMaxPages(-10));
-            AddAssert("Page 1 is current", () => pageSelector.CurrentPage.Value == 1);
-            AddAssert("Max is 1", () => pageSelector.MaxPages.Value == 1);
-        }
+        private void selectPage(int pageIndex) =>
+            AddStep($"Select page {pageIndex}", () => pageSelector.CurrentPage.Value = pageIndex);
 
-        private void setMaxPages(int maxPages) => pageSelector.MaxPages.Value = maxPages;
-
-        private void setCurrentPage(int currentPage) => pageSelector.CurrentPage.Value = currentPage;
+        private void setAvailablePages(int availablePages) =>
+            AddStep($"Set available pages to {availablePages}", () => pageSelector.AvailablePages.Value = availablePages);
     }
 }
diff --git a/osu.Game/Graphics/UserInterface/PageSelector/PageSelector.cs b/osu.Game/Graphics/UserInterface/PageSelector/PageSelector.cs
index 4089fb5511..ae644bb852 100644
--- a/osu.Game/Graphics/UserInterface/PageSelector/PageSelector.cs
+++ b/osu.Game/Graphics/UserInterface/PageSelector/PageSelector.cs
@@ -1,19 +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.Linq;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics;
 using osu.Framework.Bindables;
-using osu.Framework.Extensions.IEnumerableExtensions;
 
 namespace osu.Game.Graphics.UserInterface.PageSelector
 {
     public class PageSelector : CompositeDrawable
     {
-        public readonly BindableInt CurrentPage = new BindableInt(1);
-        public readonly BindableInt MaxPages = new BindableInt(1);
+        public readonly BindableInt CurrentPage = new BindableInt { MinValue = 0, };
 
-        private readonly FillFlowContainer<PageSelectorPageButton> itemsFlow;
+        public readonly BindableInt AvailablePages = new BindableInt(1) { MinValue = 1, };
+
+        private readonly FillFlowContainer itemsFlow;
 
         private readonly PageSelectorPrevNextButton previousPageButton;
         private readonly PageSelectorPrevNextButton nextPageButton;
@@ -32,7 +33,7 @@ namespace osu.Game.Graphics.UserInterface.PageSelector
                     {
                         Action = () => CurrentPage.Value -= 1,
                     },
-                    itemsFlow = new FillFlowContainer<PageSelectorPageButton>
+                    itemsFlow = new FillFlowContainer
                     {
                         AutoSizeAxes = Axes.Both,
                         Direction = FillDirection.Horizontal,
@@ -49,60 +50,43 @@ namespace osu.Game.Graphics.UserInterface.PageSelector
         {
             base.LoadComplete();
 
-            MaxPages.BindValueChanged(_ => redraw());
-            CurrentPage.BindValueChanged(page => onCurrentPageChanged(page.NewValue));
-            redraw();
+            CurrentPage.BindValueChanged(onCurrentPageChanged);
+            AvailablePages.BindValueChanged(_ => redraw(), true);
         }
 
-        private void onCurrentPageChanged(int newPage)
+        private void onCurrentPageChanged(ValueChangedEvent<int> currentPage)
         {
-            if (newPage < 1)
+            if (currentPage.NewValue >= AvailablePages.Value)
             {
-                CurrentPage.Value = 1;
+                CurrentPage.Value = AvailablePages.Value - 1;
                 return;
             }
 
-            if (newPage > MaxPages.Value)
-            {
-                CurrentPage.Value = MaxPages.Value;
-                return;
-            }
+            foreach (var page in itemsFlow.OfType<PageSelectorPageButton>())
+                page.Selected = page.PageNumber == currentPage.NewValue + 1;
 
-            itemsFlow.ForEach(page => page.Selected = page.Page == newPage);
-            updateButtonsState();
+            previousPageButton.Enabled.Value = currentPage.NewValue != 0;
+            nextPageButton.Enabled.Value = currentPage.NewValue < AvailablePages.Value - 1;
         }
 
         private void redraw()
         {
             itemsFlow.Clear();
 
-            if (MaxPages.Value < 1)
+            for (int i = 0; i < AvailablePages.Value; i++)
             {
-                MaxPages.Value = 1;
-                return;
+                int pageIndex = i;
+
+                itemsFlow.Add(new PageSelectorPageButton(pageIndex + 1)
+                {
+                    Action = () => CurrentPage.Value = pageIndex,
+                });
             }
 
-            for (int i = 1; i <= MaxPages.Value; i++)
-                addDrawablePage(i);
-
-            if (CurrentPage.Value == 1)
-                CurrentPage.TriggerChange();
+            if (CurrentPage.Value != 0)
+                CurrentPage.Value = 0;
             else
-                CurrentPage.Value = 1;
+                CurrentPage.TriggerChange();
         }
-
-        private void updateButtonsState()
-        {
-            int newPage = CurrentPage.Value;
-            int maxPages = MaxPages.Value;
-
-            previousPageButton.Enabled.Value = newPage != 1;
-            nextPageButton.Enabled.Value = newPage != maxPages;
-        }
-
-        private void addDrawablePage(int page) => itemsFlow.Add(new PageSelectorPageButton(page)
-        {
-            Action = () => CurrentPage.Value = page,
-        });
     }
 }
diff --git a/osu.Game/Graphics/UserInterface/PageSelector/PageSelectorPageButton.cs b/osu.Game/Graphics/UserInterface/PageSelector/PageSelectorPageButton.cs
index 6aac75565e..247a003492 100644
--- a/osu.Game/Graphics/UserInterface/PageSelector/PageSelectorPageButton.cs
+++ b/osu.Game/Graphics/UserInterface/PageSelector/PageSelectorPageButton.cs
@@ -17,13 +17,13 @@ namespace osu.Game.Graphics.UserInterface.PageSelector
             set => selected.Value = value;
         }
 
-        public int Page { get; }
+        public int PageNumber { get; }
 
         private OsuSpriteText text;
 
-        public PageSelectorPageButton(int page)
+        public PageSelectorPageButton(int pageNumber)
         {
-            Page = page;
+            PageNumber = pageNumber;
 
             Action = () =>
             {
@@ -35,7 +35,7 @@ namespace osu.Game.Graphics.UserInterface.PageSelector
         protected override Drawable CreateContent() => text = new OsuSpriteText
         {
             Font = OsuFont.GetFont(size: 12, weight: FontWeight.SemiBold),
-            Text = Page.ToString(),
+            Text = PageNumber.ToString(),
         };
 
         [BackgroundDependencyLoader]

From 5ed69338a662165d7374e3de1940ad2997f35faa Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 4 Jan 2022 19:05:14 +0900
Subject: [PATCH 1917/5547] Add omission of pages when there are too many

---
 .../UserInterface/TestScenePageSelector.cs    | 22 +++++++--
 .../PageSelector/PageEllipsis.cs              | 33 +++++++++++++
 .../PageSelector/PageSelector.cs              | 48 ++++++++++---------
 3 files changed, 76 insertions(+), 27 deletions(-)
 create mode 100644 osu.Game/Graphics/UserInterface/PageSelector/PageEllipsis.cs

diff --git a/osu.Game.Tests/Visual/UserInterface/TestScenePageSelector.cs b/osu.Game.Tests/Visual/UserInterface/TestScenePageSelector.cs
index 3b32a2a0dc..c99ac52cb1 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestScenePageSelector.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestScenePageSelector.cs
@@ -35,14 +35,24 @@ namespace osu.Game.Tests.Visual.UserInterface
         {
             setAvailablePages(100);
 
-            AddAssert("Correct page buttons", () => pageSelector.ChildrenOfType<PageSelectorPageButton>().Select(p => p.PageNumber).SequenceEqual(new[] { 1, 2, 3, 100 }));
+            selectPageIndex(0);
+            checkVisiblePageNumbers(new[] { 1, 2, 3, 100 });
+
+            selectPageIndex(6);
+            checkVisiblePageNumbers(new[] { 1, 5, 6, 7, 8, 9, 100 });
+
+            selectPageIndex(49);
+            checkVisiblePageNumbers(new[] { 1, 48, 49, 50, 51, 52, 100 });
+
+            selectPageIndex(99);
+            checkVisiblePageNumbers(new[] { 1, 98, 99, 100 });
         }
 
         [Test]
         public void TestResetCurrentPage()
         {
             setAvailablePages(10);
-            selectPage(6);
+            selectPageIndex(6);
             setAvailablePages(11);
             AddAssert("Page 1 is current", () => pageSelector.CurrentPage.Value == 0);
         }
@@ -51,14 +61,16 @@ namespace osu.Game.Tests.Visual.UserInterface
         public void TestOutOfBoundsSelection()
         {
             setAvailablePages(10);
-            selectPage(11);
+            selectPageIndex(11);
             AddAssert("Page 10 is current", () => pageSelector.CurrentPage.Value == pageSelector.AvailablePages.Value - 1);
 
-            selectPage(-1);
+            selectPageIndex(-1);
             AddAssert("Page 1 is current", () => pageSelector.CurrentPage.Value == 0);
         }
 
-        private void selectPage(int pageIndex) =>
+        private void checkVisiblePageNumbers(int[] expected) => AddAssert($"Sequence is {string.Join(',', expected.Select(i => i.ToString()))}", () => pageSelector.ChildrenOfType<PageSelectorPageButton>().Select(p => p.PageNumber).SequenceEqual(expected));
+
+        private void selectPageIndex(int pageIndex) =>
             AddStep($"Select page {pageIndex}", () => pageSelector.CurrentPage.Value = pageIndex);
 
         private void setAvailablePages(int availablePages) =>
diff --git a/osu.Game/Graphics/UserInterface/PageSelector/PageEllipsis.cs b/osu.Game/Graphics/UserInterface/PageSelector/PageEllipsis.cs
new file mode 100644
index 0000000000..d73d9f5824
--- /dev/null
+++ b/osu.Game/Graphics/UserInterface/PageSelector/PageEllipsis.cs
@@ -0,0 +1,33 @@
+// 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.Game.Graphics.Sprites;
+using osu.Game.Overlays;
+
+namespace osu.Game.Graphics.UserInterface.PageSelector
+{
+    internal class PageEllipsis : CompositeDrawable
+    {
+        [BackgroundDependencyLoader]
+        private void load(OverlayColourProvider colourProvider)
+        {
+            RelativeSizeAxes = Axes.Y;
+            AutoSizeAxes = Axes.X;
+
+            InternalChildren = new Drawable[]
+            {
+                new OsuSpriteText
+                {
+                    Font = OsuFont.GetFont(size: 12, weight: FontWeight.SemiBold),
+                    Text = "...",
+                    Colour = colourProvider.Light3,
+                    Anchor = Anchor.Centre,
+                    Origin = Anchor.Centre,
+                }
+            };
+        }
+    }
+}
diff --git a/osu.Game/Graphics/UserInterface/PageSelector/PageSelector.cs b/osu.Game/Graphics/UserInterface/PageSelector/PageSelector.cs
index ae644bb852..ce74259289 100644
--- a/osu.Game/Graphics/UserInterface/PageSelector/PageSelector.cs
+++ b/osu.Game/Graphics/UserInterface/PageSelector/PageSelector.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.Linq;
+using System;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics;
 using osu.Framework.Bindables;
@@ -50,43 +50,47 @@ namespace osu.Game.Graphics.UserInterface.PageSelector
         {
             base.LoadComplete();
 
-            CurrentPage.BindValueChanged(onCurrentPageChanged);
+            CurrentPage.BindValueChanged(_ => redraw());
             AvailablePages.BindValueChanged(_ => redraw(), true);
         }
 
-        private void onCurrentPageChanged(ValueChangedEvent<int> currentPage)
+        private void redraw()
         {
-            if (currentPage.NewValue >= AvailablePages.Value)
+            if (CurrentPage.Value >= AvailablePages.Value)
             {
                 CurrentPage.Value = AvailablePages.Value - 1;
                 return;
             }
 
-            foreach (var page in itemsFlow.OfType<PageSelectorPageButton>())
-                page.Selected = page.PageNumber == currentPage.NewValue + 1;
+            previousPageButton.Enabled.Value = CurrentPage.Value != 0;
+            nextPageButton.Enabled.Value = CurrentPage.Value < AvailablePages.Value - 1;
 
-            previousPageButton.Enabled.Value = currentPage.NewValue != 0;
-            nextPageButton.Enabled.Value = currentPage.NewValue < AvailablePages.Value - 1;
-        }
-
-        private void redraw()
-        {
             itemsFlow.Clear();
 
-            for (int i = 0; i < AvailablePages.Value; i++)
+            int totalPages = AvailablePages.Value;
+            bool lastWasEllipsis = false;
+
+            for (int i = 0; i < totalPages; i++)
             {
                 int pageIndex = i;
 
-                itemsFlow.Add(new PageSelectorPageButton(pageIndex + 1)
-                {
-                    Action = () => CurrentPage.Value = pageIndex,
-                });
-            }
+                bool shouldShowPage = pageIndex == 0 || pageIndex == totalPages - 1 || Math.Abs(pageIndex - CurrentPage.Value) <= 2;
 
-            if (CurrentPage.Value != 0)
-                CurrentPage.Value = 0;
-            else
-                CurrentPage.TriggerChange();
+                if (shouldShowPage)
+                {
+                    lastWasEllipsis = false;
+                    itemsFlow.Add(new PageSelectorPageButton(pageIndex + 1)
+                    {
+                        Action = () => CurrentPage.Value = pageIndex,
+                        Selected = CurrentPage.Value == pageIndex,
+                    });
+                }
+                else if (!lastWasEllipsis)
+                {
+                    lastWasEllipsis = true;
+                    itemsFlow.Add(new PageEllipsis());
+                }
+            }
         }
     }
 }

From 612f69782b14e6d0397c9fd248b9f77ffd48e01e Mon Sep 17 00:00:00 2001
From: MaxOhn <ohn.m@hotmail.de>
Date: Tue, 4 Jan 2022 14:29:44 +0100
Subject: [PATCH 1918/5547] use Playfield.HitObjectContainer.AliveObjects

---
 osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs | 93 ++++++++++---------
 1 file changed, 49 insertions(+), 44 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs b/osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs
index f70ad2ac7c..1849b48073 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs
@@ -7,54 +7,55 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Sprites;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Objects.Drawables;
-using osu.Game.Rulesets.Objects.Types;
+using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Osu.Objects.Drawables;
 using osu.Game.Rulesets.UI;
 using osu.Game.Rulesets.Osu.UI;
 using osuTK;
+using System.Linq;
 
 namespace osu.Game.Rulesets.Osu.Mods
 {
-    internal class OsuModAimAssist : Mod, IApplicableToDrawableHitObjects, IUpdatableByPlayfield
+    internal class OsuModAimAssist : Mod, IUpdatableByPlayfield
     {
         public override string Name => "Aim Assist";
         public override string Acronym => "AA";
-        public override IconUsage Icon => FontAwesome.Solid.MousePointer;
+        public override IconUsage? Icon => FontAwesome.Solid.MousePointer;
         public override ModType Type => ModType.Fun;
         public override string Description => "No need to chase the circle, the circle chases you";
         public override double ScoreMultiplier => 1;
         public override Type[] IncompatibleMods => new[] { typeof(OsuModAutopilot), typeof(OsuModWiggle), typeof(OsuModTransform), typeof(ModAutoplay) };
 
-        private readonly List<DrawableOsuHitObject> movingObjects = new List<DrawableOsuHitObject>();
+        public const float SPIN_RADIUS = 50; // same as OsuAutoGeneratorBase.SPIN_RADIUS
+
         private DrawableSpinner activeSpinner;
-        private double spinnerAngle; // in radians
+        private float spinnerAngle; // in radians
 
         public void Update(Playfield playfield)
         {
             var cursorPos = playfield.Cursor.ActiveCursor.DrawPosition;
-            var currentTime = playfield.Clock.CurrentTime;
+            double currentTime = playfield.Clock.CurrentTime;
 
-            // Avoid relocating judgment displays and hide follow points
+            // Judgment displays would all be cramped onto the cursor
             playfield.DisplayJudgements.Value = false;
-            (playfield as OsuPlayfield)?.ConnectionLayer.Hide();
+
+            // FIXME: Hide follow points
+            //(playfield as OsuPlayfield)?.ConnectionLayer.Hide();
 
             // If object too old, remove from movingObjects list, otherwise move to new destination
-            movingObjects.RemoveAll(d =>
+            foreach (var drawable in playfield.HitObjectContainer.AliveObjects.OfType<DrawableOsuHitObject>())
             {
-                var h = d.HitObject;
-                var endTime = (h as IHasEndTime)?.EndTime ?? h.StartTime;
+                var h = drawable.HitObject;
+                double endTime = h.GetEndTime();
 
-                // Object no longer required to be moved -> remove from list
-                if (currentTime > endTime)
-                    return true;
-
-                switch (d)
+                switch (drawable)
                 {
                     case DrawableHitCircle circle:
 
                         // 10ms earlier on the note to reduce chance of missing when clicking early / cursor moves fast
                         circle.MoveTo(cursorPos, Math.Max(0, endTime - currentTime - 10));
-                        return false;
+
+                        break;
 
                     case DrawableSlider slider:
 
@@ -66,11 +67,12 @@ namespace osu.Game.Rulesets.Osu.Mods
                         // Move slider so that sliderball stays on the cursor
                         else
                         {
-                            slider.HeadCircle.Hide(); // temporary solution to supress HeadCircle's explosion, flash, ... at wrong location
+                            // FIXME: Hide flashes
+                            //slider.HeadCircle.Hide();
                             slider.MoveTo(cursorPos - slider.Ball.DrawPosition);
                         }
 
-                        return false;
+                        break;
 
                     case DrawableSpinner spinner:
 
@@ -78,23 +80,32 @@ namespace osu.Game.Rulesets.Osu.Mods
                         if (currentTime < h.StartTime)
                         {
                             spinner.MoveTo(cursorPos, Math.Max(0, h.StartTime - currentTime - 10));
-                            return false;
                         }
                         else
                         {
-                            spinnerAngle = 0;
-                            activeSpinner = spinner;
-                            return true;
+                            // TODO:
+                            //   - get current angle to cursor
+                            //   - move clockwise(?)
+                            //   - call spinner.RotationTracker.AddRotation
+
+                            // TODO: Remove
+                            //spinnerAngle = 0;
+                            //activeSpinner = spinner;
                         }
 
-                    default:
-                        return true;
-                }
-            });
+                        break;
 
+                    default:
+                        continue;
+                }
+            }
+
+            // Move active spinner around the cursor
             if (activeSpinner != null)
             {
-                if (currentTime > (activeSpinner.HitObject as IHasEndTime)?.EndTime)
+                double spinnerEndTime = activeSpinner.HitObject.GetEndTime();
+
+                if (currentTime > spinnerEndTime)
                 {
                     activeSpinner = null;
                     spinnerAngle = 0;
@@ -102,29 +113,23 @@ namespace osu.Game.Rulesets.Osu.Mods
                 else
                 {
                     const float additional_degrees = 4;
-                    const int dist_from_cursor = 30;
-                    spinnerAngle += additional_degrees * Math.PI / 180;
+                    float added_degrees = additional_degrees * (float)Math.PI / 180;
+                    spinnerAngle += added_degrees;
+
+                    //int spinsRequired = activeSpinner.HitObject.SpinsRequired;
+                    //float spunDegrees = activeSpinner.Result.RateAdjustedRotation;
+                    //double timeLeft = spinnerEndTime - currentTime;
 
                     // Visual progress
-                    activeSpinner.MoveTo(new Vector2((float)(dist_from_cursor * Math.Cos(spinnerAngle) + cursorPos.X), (float)(dist_from_cursor * Math.Sin(spinnerAngle) + cursorPos.Y)));
+                    activeSpinner.MoveTo(new Vector2((float)(SPIN_RADIUS * Math.Cos(spinnerAngle) + cursorPos.X), (float)(SPIN_RADIUS * Math.Sin(spinnerAngle) + cursorPos.Y)));
 
                     // Logical progress
-                    activeSpinner.Disc.RotationAbsolute += additional_degrees;
+                    activeSpinner.RotationTracker.AddRotation(added_degrees);
+                    Console.WriteLine($"added_degrees={added_degrees}");
+                    //activeSpinner.Disc.RotationAbsolute += additional_degrees;
                 }
             }
         }
-
-        public void ApplyToDrawableHitObjects(IEnumerable<DrawableHitObject> drawables)
-        {
-            foreach (var drawable in drawables)
-                drawable.ApplyCustomUpdateState += drawableOnApplyCustomUpdateState;
-        }
-
-        private void drawableOnApplyCustomUpdateState(DrawableHitObject drawable, ArmedState state)
-        {
-            if (drawable is DrawableOsuHitObject hitobject)
-                movingObjects.Add(hitobject);
-        }
     }
 
     /*

From 27a8bfa4968672c44c64e7beb1e842894755ecf5 Mon Sep 17 00:00:00 2001
From: MaxOhn <ohn.m@hotmail.de>
Date: Tue, 4 Jan 2022 22:17:50 +0100
Subject: [PATCH 1919/5547] handle spinners and follow points

---
 osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs | 80 +++++--------------
 osu.Game.Rulesets.Osu/UI/OsuPlayfield.cs      |  9 ++-
 2 files changed, 26 insertions(+), 63 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs b/osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs
index 1849b48073..306e7a8b24 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs
@@ -2,11 +2,9 @@
 // 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.Sprites;
 using osu.Game.Rulesets.Mods;
-using osu.Game.Rulesets.Objects.Drawables;
 using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Osu.Objects.Drawables;
 using osu.Game.Rulesets.UI;
@@ -26,23 +24,19 @@ namespace osu.Game.Rulesets.Osu.Mods
         public override double ScoreMultiplier => 1;
         public override Type[] IncompatibleMods => new[] { typeof(OsuModAutopilot), typeof(OsuModWiggle), typeof(OsuModTransform), typeof(ModAutoplay) };
 
-        public const float SPIN_RADIUS = 50; // same as OsuAutoGeneratorBase.SPIN_RADIUS
-
-        private DrawableSpinner activeSpinner;
-        private float spinnerAngle; // in radians
+        private const float spin_radius = 30;
+        private Vector2? prevCursorPos;
 
         public void Update(Playfield playfield)
         {
             var cursorPos = playfield.Cursor.ActiveCursor.DrawPosition;
             double currentTime = playfield.Clock.CurrentTime;
 
-            // Judgment displays would all be cramped onto the cursor
+            // Hide judgment displays and follow points
             playfield.DisplayJudgements.Value = false;
+            (playfield as OsuPlayfield)?.FollowPoints.Clear();
 
-            // FIXME: Hide follow points
-            //(playfield as OsuPlayfield)?.ConnectionLayer.Hide();
-
-            // If object too old, remove from movingObjects list, otherwise move to new destination
+            // Move all currently alive object to new destination
             foreach (var drawable in playfield.HitObjectContainer.AliveObjects.OfType<DrawableOsuHitObject>())
             {
                 var h = drawable.HitObject;
@@ -79,64 +73,32 @@ namespace osu.Game.Rulesets.Osu.Mods
                         // Move spinner to cursor
                         if (currentTime < h.StartTime)
                         {
-                            spinner.MoveTo(cursorPos, Math.Max(0, h.StartTime - currentTime - 10));
+                            spinner.MoveTo(cursorPos + new Vector2(0, -spin_radius), Math.Max(0, h.StartTime - currentTime - 10));
                         }
                         else
                         {
-                            // TODO:
-                            //   - get current angle to cursor
-                            //   - move clockwise(?)
-                            //   - call spinner.RotationTracker.AddRotation
+                            // Move spinner visually
+                            Vector2 delta = spin_radius * (spinner.Position - prevCursorPos ?? cursorPos).Normalized();
+                            const float angle = 3 * MathF.PI / 180; // radians per update, arbitrary value
 
-                            // TODO: Remove
-                            //spinnerAngle = 0;
-                            //activeSpinner = spinner;
+                            // Rotation matrix
+                            var targetPos = new Vector2(
+                                delta.X * MathF.Cos(angle) - delta.Y * MathF.Sin(angle) + cursorPos.X,
+                                delta.X * MathF.Sin(angle) + delta.Y * MathF.Cos(angle) + cursorPos.Y
+                            );
+
+                            spinner.MoveTo(targetPos);
+
+                            // Logically finish spinner immediatly, no need for the user to click.
+                            // Temporary workaround until spinner rotations are easier to handle, similar as Autopilot mod.
+                            spinner.Result.RateAdjustedRotation = spinner.HitObject.SpinsRequired * 360;
                         }
 
                         break;
-
-                    default:
-                        continue;
                 }
             }
 
-            // Move active spinner around the cursor
-            if (activeSpinner != null)
-            {
-                double spinnerEndTime = activeSpinner.HitObject.GetEndTime();
-
-                if (currentTime > spinnerEndTime)
-                {
-                    activeSpinner = null;
-                    spinnerAngle = 0;
-                }
-                else
-                {
-                    const float additional_degrees = 4;
-                    float added_degrees = additional_degrees * (float)Math.PI / 180;
-                    spinnerAngle += added_degrees;
-
-                    //int spinsRequired = activeSpinner.HitObject.SpinsRequired;
-                    //float spunDegrees = activeSpinner.Result.RateAdjustedRotation;
-                    //double timeLeft = spinnerEndTime - currentTime;
-
-                    // Visual progress
-                    activeSpinner.MoveTo(new Vector2((float)(SPIN_RADIUS * Math.Cos(spinnerAngle) + cursorPos.X), (float)(SPIN_RADIUS * Math.Sin(spinnerAngle) + cursorPos.Y)));
-
-                    // Logical progress
-                    activeSpinner.RotationTracker.AddRotation(added_degrees);
-                    Console.WriteLine($"added_degrees={added_degrees}");
-                    //activeSpinner.Disc.RotationAbsolute += additional_degrees;
-                }
-            }
+            prevCursorPos = cursorPos;
         }
     }
-
-    /*
-     * TODOs
-     *  - fix sliders reappearing at original position after their EndTime (see https://puu.sh/E7zT4/111cf9cdc8.gif)
-     *  - find nicer way to handle slider headcircle explosion, flash, ...
-     *  - add Aim Assist as incompatible mod for Autoplay (?)
-     *
-     */
 }
diff --git a/osu.Game.Rulesets.Osu/UI/OsuPlayfield.cs b/osu.Game.Rulesets.Osu/UI/OsuPlayfield.cs
index 2233a547b9..bc1e80cd12 100644
--- a/osu.Game.Rulesets.Osu/UI/OsuPlayfield.cs
+++ b/osu.Game.Rulesets.Osu/UI/OsuPlayfield.cs
@@ -31,7 +31,8 @@ namespace osu.Game.Rulesets.Osu.UI
         private readonly ProxyContainer approachCircles;
         private readonly ProxyContainer spinnerProxies;
         private readonly JudgementContainer<DrawableOsuJudgement> judgementLayer;
-        private readonly FollowPointRenderer followPoints;
+
+        public FollowPointRenderer FollowPoints { get; }
 
         public static readonly Vector2 BASE_SIZE = new Vector2(512, 384);
 
@@ -50,7 +51,7 @@ namespace osu.Game.Rulesets.Osu.UI
             {
                 playfieldBorder = new PlayfieldBorder { RelativeSizeAxes = Axes.Both },
                 spinnerProxies = new ProxyContainer { RelativeSizeAxes = Axes.Both },
-                followPoints = new FollowPointRenderer { RelativeSizeAxes = Axes.Both },
+                FollowPoints = new FollowPointRenderer { RelativeSizeAxes = Axes.Both },
                 judgementLayer = new JudgementContainer<DrawableOsuJudgement> { RelativeSizeAxes = Axes.Both },
                 HitObjectContainer,
                 judgementAboveHitObjectLayer = new Container { RelativeSizeAxes = Axes.Both },
@@ -131,13 +132,13 @@ namespace osu.Game.Rulesets.Osu.UI
         protected override void OnHitObjectAdded(HitObject hitObject)
         {
             base.OnHitObjectAdded(hitObject);
-            followPoints.AddFollowPoints((OsuHitObject)hitObject);
+            FollowPoints.AddFollowPoints((OsuHitObject)hitObject);
         }
 
         protected override void OnHitObjectRemoved(HitObject hitObject)
         {
             base.OnHitObjectRemoved(hitObject);
-            followPoints.RemoveFollowPoints((OsuHitObject)hitObject);
+            FollowPoints.RemoveFollowPoints((OsuHitObject)hitObject);
         }
 
         private void onNewResult(DrawableHitObject judgedObject, JudgementResult result)

From 2bf6b55b19a26add1ad4f3f6e19bc4b553025b95 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 5 Jan 2022 14:53:32 +0900
Subject: [PATCH 1920/5547] Fix failing test due to changed reset page logic

---
 .../UserInterface/PageSelector/PageSelector.cs         | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Graphics/UserInterface/PageSelector/PageSelector.cs b/osu.Game/Graphics/UserInterface/PageSelector/PageSelector.cs
index ce74259289..005729580c 100644
--- a/osu.Game/Graphics/UserInterface/PageSelector/PageSelector.cs
+++ b/osu.Game/Graphics/UserInterface/PageSelector/PageSelector.cs
@@ -50,8 +50,14 @@ namespace osu.Game.Graphics.UserInterface.PageSelector
         {
             base.LoadComplete();
 
-            CurrentPage.BindValueChanged(_ => redraw());
-            AvailablePages.BindValueChanged(_ => redraw(), true);
+            CurrentPage.BindValueChanged(_ => Scheduler.AddOnce(redraw));
+            AvailablePages.BindValueChanged(_ =>
+            {
+                CurrentPage.Value = 0;
+
+                // AddOnce as the reset of CurrentPage may also trigger a redraw.
+                Scheduler.AddOnce(redraw);
+            }, true);
         }
 
         private void redraw()

From ef2a4aed9a2600b3be2eb86215711c718030bde3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 5 Jan 2022 16:05:15 +0900
Subject: [PATCH 1921/5547] Fix editor playfield not being centered correctly

This has come up multiple times, with mappers citing that they have
muscle memory for mapping based on the centre of the playfield being in
the centre of the window.

The original plan was to have a second toolbar on the right hand side of
the screen to balance the padding, but we're not at that point yet.
Easiest solution is to do what stable does and allow the left-hand
toolbar items to overlap the playfield underneath it.

In edge cases where the user is running at an aspect ratio that causes
overlaps, they can choose to collapse the toolbars down. We can probably
work on this UI/UX a bit more as we update designs to be more friendly
to such cases.
---
 osu.Game/Rulesets/Edit/HitObjectComposer.cs | 1 -
 1 file changed, 1 deletion(-)

diff --git a/osu.Game/Rulesets/Edit/HitObjectComposer.cs b/osu.Game/Rulesets/Edit/HitObjectComposer.cs
index 4bbfe26d7b..cbc2415603 100644
--- a/osu.Game/Rulesets/Edit/HitObjectComposer.cs
+++ b/osu.Game/Rulesets/Edit/HitObjectComposer.cs
@@ -105,7 +105,6 @@ namespace osu.Game.Rulesets.Edit
                 new Container
                 {
                     Name = "Content",
-                    Padding = new MarginPadding { Left = toolbar_width },
                     RelativeSizeAxes = Axes.Both,
                     Children = new Drawable[]
                     {

From 13cce50fa74726c3dc016fe43e2c67e1fe630ba6 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 5 Jan 2022 16:30:42 +0900
Subject: [PATCH 1922/5547] Remove existing handling of flip hotkeys

---
 .../Screens/Edit/Compose/Components/SelectionBox.cs    | 10 ++--------
 1 file changed, 2 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Screens/Edit/Compose/Components/SelectionBox.cs b/osu.Game/Screens/Edit/Compose/Components/SelectionBox.cs
index be52a968bb..732c6a5dd4 100644
--- a/osu.Game/Screens/Edit/Compose/Components/SelectionBox.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/SelectionBox.cs
@@ -174,12 +174,6 @@ namespace osu.Game.Screens.Edit.Compose.Components
             {
                 case Key.G:
                     return CanReverse && runOperationFromHotkey(OnReverse);
-
-                case Key.H:
-                    return CanFlipX && runOperationFromHotkey(() => OnFlip?.Invoke(Direction.Horizontal) ?? false);
-
-                case Key.J:
-                    return CanFlipY && runOperationFromHotkey(() => OnFlip?.Invoke(Direction.Vertical) ?? false);
             }
 
             return base.OnKeyDown(e);
@@ -287,12 +281,12 @@ namespace osu.Game.Screens.Edit.Compose.Components
 
         private void addXFlipComponents()
         {
-            addButton(FontAwesome.Solid.ArrowsAltH, "Flip horizontally (Ctrl-H)", () => OnFlip?.Invoke(Direction.Horizontal));
+            addButton(FontAwesome.Solid.ArrowsAltH, "Flip horizontally", () => OnFlip?.Invoke(Direction.Horizontal));
         }
 
         private void addYFlipComponents()
         {
-            addButton(FontAwesome.Solid.ArrowsAltV, "Flip vertically (Ctrl-J)", () => OnFlip?.Invoke(Direction.Vertical));
+            addButton(FontAwesome.Solid.ArrowsAltV, "Flip vertically", () => OnFlip?.Invoke(Direction.Vertical));
         }
 
         private void addButton(IconUsage icon, string tooltip, Action action)

From 866ae3472bb654af5bde50f79ecb0ae2cbd884e5 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 5 Jan 2022 16:46:34 +0900
Subject: [PATCH 1923/5547] Add global flip hotkeys

---
 .../Edit/CatchSelectionHandler.cs             | 12 ++++---
 .../Edit/OsuSelectionHandler.cs               |  7 +++--
 .../Input/Bindings/GlobalActionContainer.cs   | 10 +++++-
 .../GlobalActionKeyBindingStrings.cs          | 10 ++++++
 .../Edit/Compose/Components/SelectionBox.cs   |  6 ++--
 .../Compose/Components/SelectionHandler.cs    | 31 +++++++++++++++++--
 .../Timeline/TimelineSelectionHandler.cs      | 12 +++----
 .../Skinning/Editor/SkinSelectionHandler.cs   |  4 +--
 8 files changed, 68 insertions(+), 24 deletions(-)

diff --git a/osu.Game.Rulesets.Catch/Edit/CatchSelectionHandler.cs b/osu.Game.Rulesets.Catch/Edit/CatchSelectionHandler.cs
index 8cb0804ab7..41a2584acc 100644
--- a/osu.Game.Rulesets.Catch/Edit/CatchSelectionHandler.cs
+++ b/osu.Game.Rulesets.Catch/Edit/CatchSelectionHandler.cs
@@ -52,7 +52,7 @@ namespace osu.Game.Rulesets.Catch.Edit
             return true;
         }
 
-        public override bool HandleFlip(Direction direction)
+        public override bool HandleFlip(Direction direction, bool flipOverOrigin)
         {
             var selectionRange = CatchHitObjectUtils.GetPositionRange(SelectedItems);
 
@@ -60,7 +60,7 @@ namespace osu.Game.Rulesets.Catch.Edit
             EditorBeatmap.PerformOnSelection(h =>
             {
                 if (h is CatchHitObject catchObject)
-                    changed |= handleFlip(selectionRange, catchObject);
+                    changed |= handleFlip(selectionRange, catchObject, flipOverOrigin);
             });
             return changed;
         }
@@ -116,7 +116,7 @@ namespace osu.Game.Rulesets.Catch.Edit
             return Math.Clamp(deltaX, lowerBound, upperBound);
         }
 
-        private bool handleFlip(PositionRange selectionRange, CatchHitObject hitObject)
+        private bool handleFlip(PositionRange selectionRange, CatchHitObject hitObject, bool flipOverOrigin)
         {
             switch (hitObject)
             {
@@ -124,7 +124,7 @@ namespace osu.Game.Rulesets.Catch.Edit
                     return false;
 
                 case JuiceStream juiceStream:
-                    juiceStream.OriginalX = selectionRange.GetFlippedPosition(juiceStream.OriginalX);
+                    juiceStream.OriginalX = getFlippedPosition(juiceStream.OriginalX);
 
                     foreach (var point in juiceStream.Path.ControlPoints)
                         point.Position *= new Vector2(-1, 1);
@@ -133,9 +133,11 @@ namespace osu.Game.Rulesets.Catch.Edit
                     return true;
 
                 default:
-                    hitObject.OriginalX = selectionRange.GetFlippedPosition(hitObject.OriginalX);
+                    hitObject.OriginalX = getFlippedPosition(hitObject.OriginalX);
                     return true;
             }
+
+            float getFlippedPosition(float original) => flipOverOrigin ? CatchPlayfield.WIDTH - original : selectionRange.GetFlippedPosition(original);
         }
     }
 }
diff --git a/osu.Game.Rulesets.Osu/Edit/OsuSelectionHandler.cs b/osu.Game.Rulesets.Osu/Edit/OsuSelectionHandler.cs
index 4a57d36eb4..d172fa5398 100644
--- a/osu.Game.Rulesets.Osu/Edit/OsuSelectionHandler.cs
+++ b/osu.Game.Rulesets.Osu/Edit/OsuSelectionHandler.cs
@@ -10,6 +10,7 @@ using osu.Game.Extensions;
 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.Compose.Components;
 using osuTK;
 
@@ -84,15 +85,15 @@ namespace osu.Game.Rulesets.Osu.Edit
             return true;
         }
 
-        public override bool HandleFlip(Direction direction)
+        public override bool HandleFlip(Direction direction, bool flipOverOrigin)
         {
             var hitObjects = selectedMovableObjects;
 
-            var selectedObjectsQuad = getSurroundingQuad(hitObjects);
+            var flipQuad = flipOverOrigin ? new Quad(0, 0, OsuPlayfield.BASE_SIZE.X, OsuPlayfield.BASE_SIZE.Y) : getSurroundingQuad(hitObjects);
 
             foreach (var h in hitObjects)
             {
-                h.Position = GetFlippedPosition(direction, selectedObjectsQuad, h.Position);
+                h.Position = GetFlippedPosition(direction, flipQuad, h.Position);
 
                 if (h is Slider slider)
                 {
diff --git a/osu.Game/Input/Bindings/GlobalActionContainer.cs b/osu.Game/Input/Bindings/GlobalActionContainer.cs
index c71cb6a00a..47cb7be2cf 100644
--- a/osu.Game/Input/Bindings/GlobalActionContainer.cs
+++ b/osu.Game/Input/Bindings/GlobalActionContainer.cs
@@ -77,6 +77,8 @@ namespace osu.Game.Input.Bindings
             new KeyBinding(new[] { InputKey.K }, GlobalAction.EditorNudgeRight),
             new KeyBinding(new[] { InputKey.G }, GlobalAction.EditorCycleGridDisplayMode),
             new KeyBinding(new[] { InputKey.F5 }, GlobalAction.EditorTestGameplay),
+            new KeyBinding(new[] { InputKey.Control, InputKey.H }, GlobalAction.EditorFlipHorizontally),
+            new KeyBinding(new[] { InputKey.Control, InputKey.J }, GlobalAction.EditorFlipVertically),
         };
 
         public IEnumerable<KeyBinding> InGameKeyBindings => new[]
@@ -292,6 +294,12 @@ namespace osu.Game.Input.Bindings
         EditorCycleGridDisplayMode,
 
         [LocalisableDescription(typeof(GlobalActionKeyBindingStrings), nameof(GlobalActionKeyBindingStrings.EditorTestGameplay))]
-        EditorTestGameplay
+        EditorTestGameplay,
+
+        [LocalisableDescription(typeof(GlobalActionKeyBindingStrings), nameof(GlobalActionKeyBindingStrings.EditorFlipHorizontally))]
+        EditorFlipHorizontally,
+
+        [LocalisableDescription(typeof(GlobalActionKeyBindingStrings), nameof(GlobalActionKeyBindingStrings.EditorFlipVertically))]
+        EditorFlipVertically,
     }
 }
diff --git a/osu.Game/Localisation/GlobalActionKeyBindingStrings.cs b/osu.Game/Localisation/GlobalActionKeyBindingStrings.cs
index 35a0c2ae74..777e97d1e3 100644
--- a/osu.Game/Localisation/GlobalActionKeyBindingStrings.cs
+++ b/osu.Game/Localisation/GlobalActionKeyBindingStrings.cs
@@ -229,6 +229,16 @@ namespace osu.Game.Localisation
         /// </summary>
         public static LocalisableString EditorNudgeRight => new TranslatableString(getKey(@"editor_nudge_right"), @"Nudge selection right");
 
+        /// <summary>
+        /// "Flip selection horizontally"
+        /// </summary>
+        public static LocalisableString EditorFlipHorizontally => new TranslatableString(getKey(@"editor_flip_horizontally"), @"Flip selection horizontally");
+
+        /// <summary>
+        /// "Flip selection vertically"
+        /// </summary>
+        public static LocalisableString EditorFlipVertically => new TranslatableString(getKey(@"editor_flip_vertically"), @"Flip selection vertically");
+
         /// <summary>
         /// "Toggle skin editor"
         /// </summary>
diff --git a/osu.Game/Screens/Edit/Compose/Components/SelectionBox.cs b/osu.Game/Screens/Edit/Compose/Components/SelectionBox.cs
index 732c6a5dd4..3a31f6ea8c 100644
--- a/osu.Game/Screens/Edit/Compose/Components/SelectionBox.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/SelectionBox.cs
@@ -21,7 +21,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
 
         public Func<float, bool> OnRotation;
         public Func<Vector2, Anchor, bool> OnScale;
-        public Func<Direction, bool> OnFlip;
+        public Func<Direction, bool, bool> OnFlip;
         public Func<bool> OnReverse;
 
         public Action OperationStarted;
@@ -281,12 +281,12 @@ namespace osu.Game.Screens.Edit.Compose.Components
 
         private void addXFlipComponents()
         {
-            addButton(FontAwesome.Solid.ArrowsAltH, "Flip horizontally", () => OnFlip?.Invoke(Direction.Horizontal));
+            addButton(FontAwesome.Solid.ArrowsAltH, "Flip horizontally", () => OnFlip?.Invoke(Direction.Horizontal, false));
         }
 
         private void addYFlipComponents()
         {
-            addButton(FontAwesome.Solid.ArrowsAltV, "Flip vertically", () => OnFlip?.Invoke(Direction.Vertical));
+            addButton(FontAwesome.Solid.ArrowsAltV, "Flip vertically", () => OnFlip?.Invoke(Direction.Vertical, false));
         }
 
         private void addButton(IconUsage icon, string tooltip, Action action)
diff --git a/osu.Game/Screens/Edit/Compose/Components/SelectionHandler.cs b/osu.Game/Screens/Edit/Compose/Components/SelectionHandler.cs
index ee35b6a47c..d9d310c72c 100644
--- a/osu.Game/Screens/Edit/Compose/Components/SelectionHandler.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/SelectionHandler.cs
@@ -17,6 +17,7 @@ using osu.Framework.Input.Events;
 using osu.Framework.Utils;
 using osu.Game.Graphics;
 using osu.Game.Graphics.UserInterface;
+using osu.Game.Input.Bindings;
 using osu.Game.Rulesets.Edit;
 using osuTK;
 using osuTK.Input;
@@ -26,7 +27,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
     /// <summary>
     /// A component which outlines items and handles movement of selections.
     /// </summary>
-    public abstract class SelectionHandler<T> : CompositeDrawable, IKeyBindingHandler<PlatformAction>, IHasContextMenu
+    public abstract class SelectionHandler<T> : CompositeDrawable, IKeyBindingHandler<PlatformAction>, IKeyBindingHandler<GlobalAction>, IHasContextMenu
     {
         /// <summary>
         /// The currently selected blueprints.
@@ -127,9 +128,10 @@ namespace osu.Game.Screens.Edit.Compose.Components
         /// <summary>
         /// Handles the selected items being flipped.
         /// </summary>
-        /// <param name="direction">The direction to flip</param>
+        /// <param name="direction">The direction to flip.</param>
+        /// <param name="flipOverOrigin">Whether the flip operation should be global to the playfield's origin or local to the selected pattern.</param>
         /// <returns>Whether any items could be flipped.</returns>
-        public virtual bool HandleFlip(Direction direction) => false;
+        public virtual bool HandleFlip(Direction direction, bool flipOverOrigin) => false;
 
         /// <summary>
         /// Handles the selected items being reversed pattern-wise.
@@ -137,6 +139,29 @@ namespace osu.Game.Screens.Edit.Compose.Components
         /// <returns>Whether any items could be reversed.</returns>
         public virtual bool HandleReverse() => false;
 
+        public virtual bool OnPressed(KeyBindingPressEvent<GlobalAction> e)
+        {
+            if (e.Repeat)
+                return false;
+
+            switch (e.Action)
+            {
+                case GlobalAction.EditorFlipHorizontally:
+                    HandleFlip(Direction.Horizontal, true);
+                    return true;
+
+                case GlobalAction.EditorFlipVertically:
+                    HandleFlip(Direction.Vertical, true);
+                    return true;
+            }
+
+            return false;
+        }
+
+        public void OnReleased(KeyBindingReleaseEvent<GlobalAction> e)
+        {
+        }
+
         public bool OnPressed(KeyBindingPressEvent<PlatformAction> e)
         {
             switch (e.Action)
diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineSelectionHandler.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineSelectionHandler.cs
index 845a671e2c..8b7ff45765 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineSelectionHandler.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineSelectionHandler.cs
@@ -7,7 +7,6 @@ using System.Diagnostics;
 using System.Linq;
 using JetBrains.Annotations;
 using osu.Framework.Allocation;
-using osu.Framework.Input.Bindings;
 using osu.Framework.Input.Events;
 using osu.Game.Input.Bindings;
 using osu.Game.Rulesets.Edit;
@@ -17,7 +16,7 @@ using osuTK.Input;
 
 namespace osu.Game.Screens.Edit.Compose.Components.Timeline
 {
-    internal class TimelineSelectionHandler : EditorSelectionHandler, IKeyBindingHandler<GlobalAction>
+    internal class TimelineSelectionHandler : EditorSelectionHandler
     {
         [Resolved]
         private Timeline timeline { get; set; }
@@ -27,8 +26,11 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
         // for now we always allow movement. snapping is provided by the Timeline's "distance" snap implementation
         public override bool HandleMovement(MoveSelectionEvent<HitObject> moveEvent) => true;
 
-        public bool OnPressed(KeyBindingPressEvent<GlobalAction> e)
+        public override bool OnPressed(KeyBindingPressEvent<GlobalAction> e)
         {
+            // Importantly, we block the base call here.
+            // Other key operations will be handled by the composer view's SelectionHandler instead.
+
             switch (e.Action)
             {
                 case GlobalAction.EditorNudgeLeft:
@@ -43,10 +45,6 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
             return false;
         }
 
-        public void OnReleased(KeyBindingReleaseEvent<GlobalAction> e)
-        {
-        }
-
         /// <summary>
         /// Nudge the current selection by the specified multiple of beat divisor lengths,
         /// based on the timing at the first object in the selection.
diff --git a/osu.Game/Skinning/Editor/SkinSelectionHandler.cs b/osu.Game/Skinning/Editor/SkinSelectionHandler.cs
index 01bd5e8196..a54590a0ea 100644
--- a/osu.Game/Skinning/Editor/SkinSelectionHandler.cs
+++ b/osu.Game/Skinning/Editor/SkinSelectionHandler.cs
@@ -126,9 +126,9 @@ namespace osu.Game.Skinning.Editor
             return true;
         }
 
-        public override bool HandleFlip(Direction direction)
+        public override bool HandleFlip(Direction direction, bool flipOverOrigin)
         {
-            var selectionQuad = getSelectionQuad();
+            var selectionQuad = flipOverOrigin ? ScreenSpaceDrawQuad : getSelectionQuad();
             Vector2 scaleFactor = direction == Direction.Horizontal ? new Vector2(-1, 1) : new Vector2(1, -1);
 
             foreach (var b in SelectedBlueprints)

From 6779503e574e717c571d27ddef15939b6255945f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 5 Jan 2022 16:56:54 +0900
Subject: [PATCH 1924/5547] Refactor logic to avoid `TimelineSelectionHandler`
 having to block base calls

---
 osu.Game.Rulesets.Catch/Edit/CatchSelectionHandler.cs       | 5 +++++
 osu.Game.Rulesets.Osu/Edit/OsuSelectionHandler.cs           | 3 +++
 .../Screens/Edit/Compose/Components/SelectionHandler.cs     | 6 ++----
 .../Compose/Components/Timeline/TimelineSelectionHandler.cs | 5 +----
 4 files changed, 11 insertions(+), 8 deletions(-)

diff --git a/osu.Game.Rulesets.Catch/Edit/CatchSelectionHandler.cs b/osu.Game.Rulesets.Catch/Edit/CatchSelectionHandler.cs
index 41a2584acc..d39f1d3c86 100644
--- a/osu.Game.Rulesets.Catch/Edit/CatchSelectionHandler.cs
+++ b/osu.Game.Rulesets.Catch/Edit/CatchSelectionHandler.cs
@@ -54,14 +54,19 @@ namespace osu.Game.Rulesets.Catch.Edit
 
         public override bool HandleFlip(Direction direction, bool flipOverOrigin)
         {
+            if (SelectedItems.Count == 0 && !flipOverOrigin)
+                return false;
+
             var selectionRange = CatchHitObjectUtils.GetPositionRange(SelectedItems);
 
             bool changed = false;
+
             EditorBeatmap.PerformOnSelection(h =>
             {
                 if (h is CatchHitObject catchObject)
                     changed |= handleFlip(selectionRange, catchObject, flipOverOrigin);
             });
+
             return changed;
         }
 
diff --git a/osu.Game.Rulesets.Osu/Edit/OsuSelectionHandler.cs b/osu.Game.Rulesets.Osu/Edit/OsuSelectionHandler.cs
index d172fa5398..d51f08ad68 100644
--- a/osu.Game.Rulesets.Osu/Edit/OsuSelectionHandler.cs
+++ b/osu.Game.Rulesets.Osu/Edit/OsuSelectionHandler.cs
@@ -89,6 +89,9 @@ namespace osu.Game.Rulesets.Osu.Edit
         {
             var hitObjects = selectedMovableObjects;
 
+            if (hitObjects.Length == 1 && !flipOverOrigin)
+                return false;
+
             var flipQuad = flipOverOrigin ? new Quad(0, 0, OsuPlayfield.BASE_SIZE.X, OsuPlayfield.BASE_SIZE.Y) : getSurroundingQuad(hitObjects);
 
             foreach (var h in hitObjects)
diff --git a/osu.Game/Screens/Edit/Compose/Components/SelectionHandler.cs b/osu.Game/Screens/Edit/Compose/Components/SelectionHandler.cs
index d9d310c72c..39de13899d 100644
--- a/osu.Game/Screens/Edit/Compose/Components/SelectionHandler.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/SelectionHandler.cs
@@ -147,12 +147,10 @@ namespace osu.Game.Screens.Edit.Compose.Components
             switch (e.Action)
             {
                 case GlobalAction.EditorFlipHorizontally:
-                    HandleFlip(Direction.Horizontal, true);
-                    return true;
+                    return HandleFlip(Direction.Horizontal, true);
 
                 case GlobalAction.EditorFlipVertically:
-                    HandleFlip(Direction.Vertical, true);
-                    return true;
+                    return HandleFlip(Direction.Vertical, true);
             }
 
             return false;
diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineSelectionHandler.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineSelectionHandler.cs
index 8b7ff45765..e98cf8332f 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineSelectionHandler.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineSelectionHandler.cs
@@ -28,9 +28,6 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
 
         public override bool OnPressed(KeyBindingPressEvent<GlobalAction> e)
         {
-            // Importantly, we block the base call here.
-            // Other key operations will be handled by the composer view's SelectionHandler instead.
-
             switch (e.Action)
             {
                 case GlobalAction.EditorNudgeLeft:
@@ -42,7 +39,7 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
                     return true;
             }
 
-            return false;
+            return base.OnPressed(e);
         }
 
         /// <summary>

From df6a755c3653a4c473c9031eea52198158cdf304 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 5 Jan 2022 18:29:09 +0900
Subject: [PATCH 1925/5547] Update player loader screen mouse disable text to
 use localised version

---
 osu.Game/Screens/Play/PlayerSettings/InputSettings.cs | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Play/PlayerSettings/InputSettings.cs b/osu.Game/Screens/Play/PlayerSettings/InputSettings.cs
index 725a6e86bf..b1063966da 100644
--- a/osu.Game/Screens/Play/PlayerSettings/InputSettings.cs
+++ b/osu.Game/Screens/Play/PlayerSettings/InputSettings.cs
@@ -4,6 +4,7 @@
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Game.Configuration;
+using osu.Game.Localisation;
 
 namespace osu.Game.Screens.Play.PlayerSettings
 {
@@ -18,7 +19,7 @@ namespace osu.Game.Screens.Play.PlayerSettings
             {
                 mouseButtonsCheckbox = new PlayerCheckbox
                 {
-                    LabelText = "Disable mouse buttons"
+                    LabelText = MouseSettingsStrings.DisableMouseButtons
                 }
             };
         }

From 88602ec1b4f26d7985e8990fd9ad54a8deb30674 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 5 Jan 2022 18:29:32 +0900
Subject: [PATCH 1926/5547] Fix mouse button disable not disabling touch input
 mappings

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

diff --git a/osu.Game/Rulesets/UI/RulesetInputManager.cs b/osu.Game/Rulesets/UI/RulesetInputManager.cs
index 6564ff9e23..370c99ffaf 100644
--- a/osu.Game/Rulesets/UI/RulesetInputManager.cs
+++ b/osu.Game/Rulesets/UI/RulesetInputManager.cs
@@ -127,6 +127,17 @@ namespace osu.Game.Rulesets.UI
             return base.Handle(e);
         }
 
+        protected override bool HandleMouseTouchStateChange(TouchStateChangeEvent e)
+        {
+            if (mouseDisabled.Value)
+            {
+                // Only propagate positional data when mouse buttons are disabled.
+                e = new TouchStateChangeEvent(e.State, e.Input, e.Touch, false, e.LastPosition);
+            }
+
+            return base.HandleMouseTouchStateChange(e);
+        }
+
         #endregion
 
         #region Key Counter Attachment

From b317a95fe1df3999b3071d62d8ad8ca51e854fd9 Mon Sep 17 00:00:00 2001
From: StanR <hi@stanr.info>
Date: Wed, 5 Jan 2022 14:36:07 +0300
Subject: [PATCH 1927/5547] Don't floor `effectiveMissCount`

---
 .../Difficulty/OsuPerformanceCalculator.cs                | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
index d7d294df47..a38d9299aa 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
@@ -25,7 +25,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty
         private int countMeh;
         private int countMiss;
 
-        private int effectiveMissCount;
+        private double effectiveMissCount;
 
         public OsuPerformanceCalculator(Ruleset ruleset, DifficultyAttributes attributes, ScoreInfo score)
             : base(ruleset, attributes, score)
@@ -244,7 +244,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty
             return flashlightValue;
         }
 
-        private int calculateEffectiveMissCount()
+        private double calculateEffectiveMissCount()
         {
             // Guess the number of misses + slider breaks from combo
             double comboBasedMissCount = 0.0;
@@ -256,10 +256,10 @@ namespace osu.Game.Rulesets.Osu.Difficulty
                     comboBasedMissCount = fullComboThreshold / Math.Max(1.0, scoreMaxCombo);
             }
 
-            // Clamp misscount since it's derived from combo and can be higher than total hits and that breaks some calculations
+            // Clamp miss count since it's derived from combo and can be higher than total hits and that breaks some calculations
             comboBasedMissCount = Math.Min(comboBasedMissCount, totalHits);
 
-            return Math.Max(countMiss, (int)Math.Floor(comboBasedMissCount));
+            return Math.Max(countMiss, comboBasedMissCount);
         }
 
         private double getComboScalingFactor() => Attributes.MaxCombo <= 0 ? 1.0 : Math.Min(Math.Pow(scoreMaxCombo, 0.8) / Math.Pow(Attributes.MaxCombo, 0.8), 1.0);

From 5a62760fe4f301d7f6a736f35feee14c847f5c96 Mon Sep 17 00:00:00 2001
From: MaxOhn <ohn.m@hotmail.de>
Date: Wed, 5 Jan 2022 13:05:22 +0100
Subject: [PATCH 1928/5547] hold spinners & minor adjustments

---
 osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs | 33 ++++++++++++-------
 1 file changed, 22 insertions(+), 11 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs b/osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs
index 306e7a8b24..cde86c8868 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs
@@ -5,16 +5,16 @@ using System;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Sprites;
 using osu.Game.Rulesets.Mods;
-using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Osu.Objects.Drawables;
 using osu.Game.Rulesets.UI;
 using osu.Game.Rulesets.Osu.UI;
 using osuTK;
 using System.Linq;
+using osu.Game.Rulesets.Osu.Objects;
 
 namespace osu.Game.Rulesets.Osu.Mods
 {
-    internal class OsuModAimAssist : Mod, IUpdatableByPlayfield
+    internal class OsuModAimAssist : Mod, IUpdatableByPlayfield, IApplicableToDrawableRuleset<OsuHitObject>
     {
         public override string Name => "Aim Assist";
         public override string Acronym => "AA";
@@ -25,7 +25,15 @@ namespace osu.Game.Rulesets.Osu.Mods
         public override Type[] IncompatibleMods => new[] { typeof(OsuModAutopilot), typeof(OsuModWiggle), typeof(OsuModTransform), typeof(ModAutoplay) };
 
         private const float spin_radius = 30;
+
         private Vector2? prevCursorPos;
+        private OsuInputManager inputManager;
+
+        public void ApplyToDrawableRuleset(DrawableRuleset<OsuHitObject> drawableRuleset)
+        {
+            // Grab the input manager for future use
+            inputManager = (OsuInputManager)drawableRuleset.KeyBindingInputManager;
+        }
 
         public void Update(Playfield playfield)
         {
@@ -34,20 +42,20 @@ namespace osu.Game.Rulesets.Osu.Mods
 
             // Hide judgment displays and follow points
             playfield.DisplayJudgements.Value = false;
-            (playfield as OsuPlayfield)?.FollowPoints.Clear();
+            (playfield as OsuPlayfield)?.FollowPoints.Hide();
 
             // Move all currently alive object to new destination
             foreach (var drawable in playfield.HitObjectContainer.AliveObjects.OfType<DrawableOsuHitObject>())
             {
                 var h = drawable.HitObject;
-                double endTime = h.GetEndTime();
 
                 switch (drawable)
                 {
                     case DrawableHitCircle circle:
 
                         // 10ms earlier on the note to reduce chance of missing when clicking early / cursor moves fast
-                        circle.MoveTo(cursorPos, Math.Max(0, endTime - currentTime - 10));
+                        circle.MoveTo(cursorPos, Math.Max(0, h.StartTime - currentTime - 10));
+                        // FIXME: some circles cause flash at original(?) position when clicked too early
 
                         break;
 
@@ -61,16 +69,16 @@ namespace osu.Game.Rulesets.Osu.Mods
                         // Move slider so that sliderball stays on the cursor
                         else
                         {
-                            // FIXME: Hide flashes
-                            //slider.HeadCircle.Hide();
+                            slider.HeadCircle.Hide(); // hide flash, triangles, ... so they don't move with slider
                             slider.MoveTo(cursorPos - slider.Ball.DrawPosition);
+                            // FIXME: some sliders re-appearing at their original position for a single frame when they're done
                         }
 
                         break;
 
                     case DrawableSpinner spinner:
 
-                        // Move spinner to cursor
+                        // Move spinner _next_ to cursor
                         if (currentTime < h.StartTime)
                         {
                             spinner.MoveTo(cursorPos + new Vector2(0, -spin_radius), Math.Max(0, h.StartTime - currentTime - 10));
@@ -89,9 +97,12 @@ namespace osu.Game.Rulesets.Osu.Mods
 
                             spinner.MoveTo(targetPos);
 
-                            // Logically finish spinner immediatly, no need for the user to click.
-                            // Temporary workaround until spinner rotations are easier to handle, similar as Autopilot mod.
-                            spinner.Result.RateAdjustedRotation = spinner.HitObject.SpinsRequired * 360;
+                            // Move spinner logically
+                            if (inputManager?.PressedActions.Any(x => x == OsuAction.LeftButton || x == OsuAction.RightButton) ?? false)
+                            {
+                                // Arbitrary value, might lead to some inconsistencies depending on clock rate, replay, ...
+                                spinner.RotationTracker.AddRotation(2 * MathF.PI);
+                            }
                         }
 
                         break;

From dc755f4a7fbb3e85d967e75bfa16361c07ef8898 Mon Sep 17 00:00:00 2001
From: StanR <hi@stanr.info>
Date: Wed, 5 Jan 2022 15:07:02 +0300
Subject: [PATCH 1929/5547] Remove redundant casts

---
 .../Difficulty/OsuPerformanceCalculator.cs                  | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
index a38d9299aa..31818d7d52 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
@@ -97,7 +97,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty
 
             // Penalize misses by assessing # of misses relative to the total # of objects. Default a 3% reduction for any # of misses.
             if (effectiveMissCount > 0)
-                aimValue *= 0.97 * Math.Pow(1 - Math.Pow((double)effectiveMissCount / totalHits, 0.775), effectiveMissCount);
+                aimValue *= 0.97 * Math.Pow(1 - Math.Pow(effectiveMissCount / totalHits, 0.775), effectiveMissCount);
 
             aimValue *= getComboScalingFactor();
 
@@ -144,7 +144,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty
 
             // Penalize misses by assessing # of misses relative to the total # of objects. Default a 3% reduction for any # of misses.
             if (effectiveMissCount > 0)
-                speedValue *= 0.97 * Math.Pow(1 - Math.Pow((double)effectiveMissCount / totalHits, 0.775), Math.Pow(effectiveMissCount, .875));
+                speedValue *= 0.97 * Math.Pow(1 - Math.Pow(effectiveMissCount / totalHits, 0.775), Math.Pow(effectiveMissCount, .875));
 
             speedValue *= getComboScalingFactor();
 
@@ -228,7 +228,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty
 
             // Penalize misses by assessing # of misses relative to the total # of objects. Default a 3% reduction for any # of misses.
             if (effectiveMissCount > 0)
-                flashlightValue *= 0.97 * Math.Pow(1 - Math.Pow((double)effectiveMissCount / totalHits, 0.775), Math.Pow(effectiveMissCount, .875));
+                flashlightValue *= 0.97 * Math.Pow(1 - Math.Pow(effectiveMissCount / totalHits, 0.775), Math.Pow(effectiveMissCount, .875));
 
             flashlightValue *= getComboScalingFactor();
 

From ee24713002d91838e4531428517de38e5251ec66 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 6 Jan 2022 14:37:13 +0900
Subject: [PATCH 1930/5547] Fix single sliders not being flippable due to
 incorrect precondition

---
 .../Edit/OsuSelectionHandler.cs                 | 17 ++++++++++++-----
 1 file changed, 12 insertions(+), 5 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Edit/OsuSelectionHandler.cs b/osu.Game.Rulesets.Osu/Edit/OsuSelectionHandler.cs
index d51f08ad68..071ecf6329 100644
--- a/osu.Game.Rulesets.Osu/Edit/OsuSelectionHandler.cs
+++ b/osu.Game.Rulesets.Osu/Edit/OsuSelectionHandler.cs
@@ -89,17 +89,24 @@ namespace osu.Game.Rulesets.Osu.Edit
         {
             var hitObjects = selectedMovableObjects;
 
-            if (hitObjects.Length == 1 && !flipOverOrigin)
-                return false;
-
             var flipQuad = flipOverOrigin ? new Quad(0, 0, OsuPlayfield.BASE_SIZE.X, OsuPlayfield.BASE_SIZE.Y) : getSurroundingQuad(hitObjects);
 
+            bool didFlip = false;
+
             foreach (var h in hitObjects)
             {
-                h.Position = GetFlippedPosition(direction, flipQuad, h.Position);
+                var flippedPosition = GetFlippedPosition(direction, flipQuad, h.Position);
+
+                if (!Precision.AlmostEquals(flippedPosition, h.Position))
+                {
+                    h.Position = flippedPosition;
+                    didFlip = true;
+                }
 
                 if (h is Slider slider)
                 {
+                    didFlip = true;
+
                     foreach (var point in slider.Path.ControlPoints)
                     {
                         point.Position = new Vector2(
@@ -110,7 +117,7 @@ namespace osu.Game.Rulesets.Osu.Edit
                 }
             }
 
-            return true;
+            return didFlip;
         }
 
         public override bool HandleScale(Vector2 scale, Anchor reference)

From 5c0494f3bae6468e0b7a2791f99c3e02b4a3216b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 6 Jan 2022 14:39:00 +0900
Subject: [PATCH 1931/5547] Remove unnecessary precondition check and disallow
 vertical catch flips for now

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

diff --git a/osu.Game.Rulesets.Catch/Edit/CatchSelectionHandler.cs b/osu.Game.Rulesets.Catch/Edit/CatchSelectionHandler.cs
index d39f1d3c86..dd5835b4ed 100644
--- a/osu.Game.Rulesets.Catch/Edit/CatchSelectionHandler.cs
+++ b/osu.Game.Rulesets.Catch/Edit/CatchSelectionHandler.cs
@@ -54,7 +54,11 @@ namespace osu.Game.Rulesets.Catch.Edit
 
         public override bool HandleFlip(Direction direction, bool flipOverOrigin)
         {
-            if (SelectedItems.Count == 0 && !flipOverOrigin)
+            if (SelectedItems.Count == 0)
+                return false;
+
+            // This could be implemented in the future if there's a requirement for it.
+            if (direction == Direction.Vertical)
                 return false;
 
             var selectionRange = CatchHitObjectUtils.GetPositionRange(SelectedItems);

From 243a1a3cf7ce26f11f6aea7305a04996be916dcc Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 6 Jan 2022 14:47:44 +0900
Subject: [PATCH 1932/5547] Fix incorrect origin specification for
 `SkinSelectionHandler` flips

---
 osu.Game/Skinning/Editor/SkinSelectionHandler.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Skinning/Editor/SkinSelectionHandler.cs b/osu.Game/Skinning/Editor/SkinSelectionHandler.cs
index a54590a0ea..bd6d097eb2 100644
--- a/osu.Game/Skinning/Editor/SkinSelectionHandler.cs
+++ b/osu.Game/Skinning/Editor/SkinSelectionHandler.cs
@@ -128,14 +128,14 @@ namespace osu.Game.Skinning.Editor
 
         public override bool HandleFlip(Direction direction, bool flipOverOrigin)
         {
-            var selectionQuad = flipOverOrigin ? ScreenSpaceDrawQuad : getSelectionQuad();
+            var selectionQuad = getSelectionQuad();
             Vector2 scaleFactor = direction == Direction.Horizontal ? new Vector2(-1, 1) : new Vector2(1, -1);
 
             foreach (var b in SelectedBlueprints)
             {
                 var drawableItem = (Drawable)b.Item;
 
-                var flippedPosition = GetFlippedPosition(direction, selectionQuad, b.ScreenSpaceSelectionPoint);
+                var flippedPosition = GetFlippedPosition(direction, flipOverOrigin ? drawableItem.Parent.ScreenSpaceDrawQuad : selectionQuad, b.ScreenSpaceSelectionPoint);
 
                 updateDrawablePosition(drawableItem, flippedPosition);
 

From 04d060aba3f95cb75899d642a964c168679524a4 Mon Sep 17 00:00:00 2001
From: MaxOhn <ohn.m@hotmail.de>
Date: Thu, 6 Jan 2022 10:38:30 +0100
Subject: [PATCH 1933/5547] update general playfield only once

---
 osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs b/osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs
index cde86c8868..f983ece71b 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs
@@ -33,6 +33,10 @@ namespace osu.Game.Rulesets.Osu.Mods
         {
             // Grab the input manager for future use
             inputManager = (OsuInputManager)drawableRuleset.KeyBindingInputManager;
+
+            // Hide judgment displays and follow points
+            drawableRuleset.Playfield.DisplayJudgements.Value = false;
+            (drawableRuleset.Playfield as OsuPlayfield)?.FollowPoints.Hide();
         }
 
         public void Update(Playfield playfield)
@@ -40,10 +44,6 @@ namespace osu.Game.Rulesets.Osu.Mods
             var cursorPos = playfield.Cursor.ActiveCursor.DrawPosition;
             double currentTime = playfield.Clock.CurrentTime;
 
-            // Hide judgment displays and follow points
-            playfield.DisplayJudgements.Value = false;
-            (playfield as OsuPlayfield)?.FollowPoints.Hide();
-
             // Move all currently alive object to new destination
             foreach (var drawable in playfield.HitObjectContainer.AliveObjects.OfType<DrawableOsuHitObject>())
             {

From 84765b99b36bb66f7aded738867593ad9cb5936b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 6 Jan 2022 12:57:26 +0100
Subject: [PATCH 1934/5547] Handle score submission request in submission test
 scene

Was previously not handled at all, therefore displaying request failures
in the test log output. While that was mostly a red herring and
shouldn't have caused any actual *test* failures, it is still better to
handle this explicitly in a realistic manner.
---
 .../TestScenePlayerScoreSubmission.cs         | 51 ++++++++++++++-----
 .../Online/Solo/SubmitSoloScoreRequest.cs     |  8 +--
 2 files changed, 42 insertions(+), 17 deletions(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestScenePlayerScoreSubmission.cs b/osu.Game.Tests/Visual/Gameplay/TestScenePlayerScoreSubmission.cs
index 25808d307d..5ee1f9dd8f 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestScenePlayerScoreSubmission.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestScenePlayerScoreSubmission.cs
@@ -57,7 +57,7 @@ namespace osu.Game.Tests.Visual.Gameplay
         [Test]
         public void TestNoSubmissionOnResultsWithNoToken()
         {
-            prepareTokenResponse(false);
+            prepareTestAPI(false);
 
             createPlayerTest();
 
@@ -77,7 +77,7 @@ namespace osu.Game.Tests.Visual.Gameplay
         [Test]
         public void TestSubmissionOnResults()
         {
-            prepareTokenResponse(true);
+            prepareTestAPI(true);
 
             createPlayerTest();
 
@@ -96,7 +96,7 @@ namespace osu.Game.Tests.Visual.Gameplay
         [Test]
         public void TestSubmissionForDifferentRuleset()
         {
-            prepareTokenResponse(true);
+            prepareTestAPI(true);
 
             createPlayerTest(createRuleset: () => new TaikoRuleset());
 
@@ -116,7 +116,7 @@ namespace osu.Game.Tests.Visual.Gameplay
         [Test]
         public void TestSubmissionForConvertedBeatmap()
         {
-            prepareTokenResponse(true);
+            prepareTestAPI(true);
 
             createPlayerTest(createRuleset: () => new ManiaRuleset(), createBeatmap: _ => createTestBeatmap(new OsuRuleset().RulesetInfo));
 
@@ -136,7 +136,7 @@ namespace osu.Game.Tests.Visual.Gameplay
         [Test]
         public void TestNoSubmissionOnExitWithNoToken()
         {
-            prepareTokenResponse(false);
+            prepareTestAPI(false);
 
             createPlayerTest();
 
@@ -153,7 +153,7 @@ namespace osu.Game.Tests.Visual.Gameplay
         [Test]
         public void TestNoSubmissionOnEmptyFail()
         {
-            prepareTokenResponse(true);
+            prepareTestAPI(true);
 
             createPlayerTest(true);
 
@@ -168,7 +168,7 @@ namespace osu.Game.Tests.Visual.Gameplay
         [Test]
         public void TestSubmissionOnFail()
         {
-            prepareTokenResponse(true);
+            prepareTestAPI(true);
 
             createPlayerTest(true);
 
@@ -185,7 +185,7 @@ namespace osu.Game.Tests.Visual.Gameplay
         [Test]
         public void TestNoSubmissionOnEmptyExit()
         {
-            prepareTokenResponse(true);
+            prepareTestAPI(true);
 
             createPlayerTest();
 
@@ -198,7 +198,7 @@ namespace osu.Game.Tests.Visual.Gameplay
         [Test]
         public void TestSubmissionOnExit()
         {
-            prepareTokenResponse(true);
+            prepareTestAPI(true);
 
             createPlayerTest();
 
@@ -213,7 +213,7 @@ namespace osu.Game.Tests.Visual.Gameplay
         [Test]
         public void TestSubmissionOnExitDuringImport()
         {
-            prepareTokenResponse(true);
+            prepareTestAPI(true);
 
             createPlayerTest();
             AddStep("block imports", () => Player.AllowImportCompletion.Wait());
@@ -232,7 +232,7 @@ namespace osu.Game.Tests.Visual.Gameplay
         [Test]
         public void TestNoSubmissionOnLocalBeatmap()
         {
-            prepareTokenResponse(true);
+            prepareTestAPI(true);
 
             createPlayerTest(false, r =>
             {
@@ -253,7 +253,7 @@ namespace osu.Game.Tests.Visual.Gameplay
         [TestCase(10)]
         public void TestNoSubmissionOnCustomRuleset(int? rulesetId)
         {
-            prepareTokenResponse(true);
+            prepareTestAPI(true);
 
             createPlayerTest(false, createRuleset: () => new OsuRuleset { RulesetInfo = { OnlineID = rulesetId ?? -1 } });
 
@@ -275,7 +275,7 @@ namespace osu.Game.Tests.Visual.Gameplay
             }));
         }
 
-        private void prepareTokenResponse(bool validToken)
+        private void prepareTestAPI(bool validToken)
         {
             AddStep("Prepare test API", () =>
             {
@@ -289,6 +289,31 @@ namespace osu.Game.Tests.Visual.Gameplay
                             else
                                 tokenRequest.TriggerFailure(new APIException("something went wrong!", null));
                             return true;
+
+                        case SubmitSoloScoreRequest submissionRequest:
+                            if (validToken)
+                            {
+                                var requestScore = submissionRequest.Score;
+
+                                submissionRequest.TriggerSuccess(new MultiplayerScore
+                                {
+                                    ID = 1234,
+                                    User = dummyAPI.LocalUser.Value,
+                                    Rank = requestScore.Rank,
+                                    TotalScore = requestScore.TotalScore,
+                                    Accuracy = requestScore.Accuracy,
+                                    MaxCombo = requestScore.MaxCombo,
+                                    Mods = requestScore.Mods,
+                                    Statistics = requestScore.Statistics,
+                                    Passed = requestScore.Passed,
+                                    EndedAt = DateTimeOffset.Now,
+                                    Position = 1
+                                });
+
+                                return true;
+                            }
+
+                            break;
                     }
 
                     return false;
diff --git a/osu.Game/Online/Solo/SubmitSoloScoreRequest.cs b/osu.Game/Online/Solo/SubmitSoloScoreRequest.cs
index 99cf5ceff5..78ebddb2e6 100644
--- a/osu.Game/Online/Solo/SubmitSoloScoreRequest.cs
+++ b/osu.Game/Online/Solo/SubmitSoloScoreRequest.cs
@@ -12,17 +12,17 @@ namespace osu.Game.Online.Solo
 {
     public class SubmitSoloScoreRequest : APIRequest<MultiplayerScore>
     {
+        public readonly SubmittableScore Score;
+
         private readonly long scoreId;
 
         private readonly int beatmapId;
 
-        private readonly SubmittableScore score;
-
         public SubmitSoloScoreRequest(int beatmapId, long scoreId, ScoreInfo scoreInfo)
         {
             this.beatmapId = beatmapId;
             this.scoreId = scoreId;
-            score = new SubmittableScore(scoreInfo);
+            Score = new SubmittableScore(scoreInfo);
         }
 
         protected override WebRequest CreateWebRequest()
@@ -33,7 +33,7 @@ namespace osu.Game.Online.Solo
             req.Method = HttpMethod.Put;
             req.Timeout = 30000;
 
-            req.AddRaw(JsonConvert.SerializeObject(score, new JsonSerializerSettings
+            req.AddRaw(JsonConvert.SerializeObject(Score, new JsonSerializerSettings
             {
                 ReferenceLoopHandling = ReferenceLoopHandling.Ignore
             }));

From 77980196c5e6473ae1c9ff70ac95f85050a107a0 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 6 Jan 2022 17:15:42 +0900
Subject: [PATCH 1935/5547] Split out expanding container logic from settings
 sidebar

---
 ...Sidebar.cs => ExpandingButtonContainer.cs} | 56 +++++++------------
 osu.Game/Overlays/Settings/SettingsSidebar.cs | 37 ++++++++++++
 .../Overlays/Settings/SidebarIconButton.cs    |  4 +-
 osu.Game/Overlays/SettingsPanel.cs            |  8 +--
 osu.Game/Overlays/SettingsSubPanel.cs         |  2 +-
 5 files changed, 65 insertions(+), 42 deletions(-)
 rename osu.Game/Overlays/{Settings/Sidebar.cs => ExpandingButtonContainer.cs} (67%)
 create mode 100644 osu.Game/Overlays/Settings/SettingsSidebar.cs

diff --git a/osu.Game/Overlays/Settings/Sidebar.cs b/osu.Game/Overlays/ExpandingButtonContainer.cs
similarity index 67%
rename from osu.Game/Overlays/Settings/Sidebar.cs
rename to osu.Game/Overlays/ExpandingButtonContainer.cs
index 93b1b19b17..a49f0493f6 100644
--- a/osu.Game/Overlays/Settings/Sidebar.cs
+++ b/osu.Game/Overlays/ExpandingButtonContainer.cs
@@ -1,47 +1,47 @@
-// 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;
 using System.Linq;
 using osu.Framework;
-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.Testing;
 using osu.Framework.Threading;
-using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
+using osu.Game.Graphics.UserInterface;
+using osu.Game.Overlays.Settings;
 using osuTK;
 
-namespace osu.Game.Overlays.Settings
+namespace osu.Game.Overlays
 {
-    public class Sidebar : Container<SidebarIconButton>, IStateful<ExpandedState>
+    public abstract class ExpandingButtonContainer : Container, IStateful<ExpandedState>
     {
-        private readonly Box background;
-        private readonly FillFlowContainer<SidebarIconButton> content;
-        public const float DEFAULT_WIDTH = 70;
-        public const int EXPANDED_WIDTH = 200;
+        private readonly float contractedWidth;
+        private readonly float expandedWidth;
 
         public event Action<ExpandedState> StateChanged;
 
-        protected override Container<SidebarIconButton> Content => content;
+        protected override Container<Drawable> Content => FillFlow;
 
-        public Sidebar()
+        protected FillFlowContainer FillFlow { get; }
+
+        protected ExpandingButtonContainer(float contractedWidth, float expandedWidth)
         {
+            this.contractedWidth = contractedWidth;
+            this.expandedWidth = expandedWidth;
+
             RelativeSizeAxes = Axes.Y;
+            Width = contractedWidth;
+
             InternalChildren = new Drawable[]
             {
-                background = new Box
-                {
-                    Colour = OsuColour.Gray(0.02f),
-                    RelativeSizeAxes = Axes.Both,
-                },
                 new SidebarScrollContainer
                 {
                     Children = new[]
                     {
-                        content = new FillFlowContainer<SidebarIconButton>
+                        FillFlow = new FillFlowContainer
                         {
                             Origin = Anchor.CentreLeft,
                             Anchor = Anchor.CentreLeft,
@@ -54,12 +54,6 @@ namespace osu.Game.Overlays.Settings
             };
         }
 
-        [BackgroundDependencyLoader]
-        private void load(OverlayColourProvider colourProvider)
-        {
-            background.Colour = colourProvider.Background5;
-        }
-
         private ScheduledDelegate expandEvent;
         private ExpandedState state;
 
@@ -107,11 +101,11 @@ namespace osu.Game.Overlays.Settings
                 switch (state)
                 {
                     default:
-                        this.ResizeTo(new Vector2(DEFAULT_WIDTH, Height), 500, Easing.OutQuint);
+                        this.ResizeTo(new Vector2(contractedWidth, Height), 500, Easing.OutQuint);
                         break;
 
                     case ExpandedState.Expanded:
-                        this.ResizeTo(new Vector2(EXPANDED_WIDTH, Height), 500, Easing.OutQuint);
+                        this.ResizeTo(new Vector2(expandedWidth, Height), 500, Easing.OutQuint);
                         break;
                 }
 
@@ -121,15 +115,13 @@ namespace osu.Game.Overlays.Settings
 
         private Drawable lastHoveredButton;
 
-        private Drawable hoveredButton => content.Children.FirstOrDefault(c => c.IsHovered);
+        private Drawable hoveredButton => FillFlow.ChildrenOfType<OsuButton>().FirstOrDefault(c => c.IsHovered);
 
         private void queueExpandIfHovering()
         {
             // only expand when we hover a different button.
             if (lastHoveredButton == hoveredButton) return;
 
-            if (!IsHovered) return;
-
             if (State != ExpandedState.Expanded)
             {
                 expandEvent?.Cancel();
@@ -139,10 +131,4 @@ namespace osu.Game.Overlays.Settings
             lastHoveredButton = hoveredButton;
         }
     }
-
-    public enum ExpandedState
-    {
-        Contracted,
-        Expanded,
-    }
 }
diff --git a/osu.Game/Overlays/Settings/SettingsSidebar.cs b/osu.Game/Overlays/Settings/SettingsSidebar.cs
new file mode 100644
index 0000000000..5aa2e61162
--- /dev/null
+++ b/osu.Game/Overlays/Settings/SettingsSidebar.cs
@@ -0,0 +1,37 @@
+// 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.Shapes;
+
+namespace osu.Game.Overlays.Settings
+{
+    public class SettingsSidebar : ExpandingButtonContainer
+    {
+        public const float DEFAULT_WIDTH = 70;
+        public const int EXPANDED_WIDTH = 200;
+
+        public SettingsSidebar()
+            : base(DEFAULT_WIDTH, EXPANDED_WIDTH)
+        {
+        }
+
+        [BackgroundDependencyLoader]
+        private void load(OverlayColourProvider colourProvider)
+        {
+            AddInternal(new Box
+            {
+                Colour = colourProvider.Background5,
+                RelativeSizeAxes = Axes.Both,
+                Depth = float.MaxValue
+            });
+        }
+    }
+
+    public enum ExpandedState
+    {
+        Contracted,
+        Expanded,
+    }
+}
diff --git a/osu.Game/Overlays/Settings/SidebarIconButton.cs b/osu.Game/Overlays/Settings/SidebarIconButton.cs
index fd57996b1b..6f3d3d5d52 100644
--- a/osu.Game/Overlays/Settings/SidebarIconButton.cs
+++ b/osu.Game/Overlays/Settings/SidebarIconButton.cs
@@ -62,14 +62,14 @@ namespace osu.Game.Overlays.Settings
             {
                 textIconContent = new Container
                 {
-                    Width = Sidebar.DEFAULT_WIDTH,
+                    Width = SettingsSidebar.DEFAULT_WIDTH,
                     RelativeSizeAxes = Axes.Y,
                     Colour = OsuColour.Gray(0.6f),
                     Children = new Drawable[]
                     {
                         headerText = new OsuSpriteText
                         {
-                            Position = new Vector2(Sidebar.DEFAULT_WIDTH + 10, 0),
+                            Position = new Vector2(SettingsSidebar.DEFAULT_WIDTH + 10, 0),
                             Anchor = Anchor.CentreLeft,
                             Origin = Anchor.CentreLeft,
                         },
diff --git a/osu.Game/Overlays/SettingsPanel.cs b/osu.Game/Overlays/SettingsPanel.cs
index 0ceb7fc50d..ba7118cffe 100644
--- a/osu.Game/Overlays/SettingsPanel.cs
+++ b/osu.Game/Overlays/SettingsPanel.cs
@@ -27,7 +27,7 @@ namespace osu.Game.Overlays
 
         public const float TRANSITION_LENGTH = 600;
 
-        private const float sidebar_width = Sidebar.DEFAULT_WIDTH;
+        private const float sidebar_width = SettingsSidebar.DEFAULT_WIDTH;
 
         /// <summary>
         /// The width of the settings panel content, excluding the sidebar.
@@ -43,7 +43,7 @@ namespace osu.Game.Overlays
 
         protected override Container<Drawable> Content => ContentContainer;
 
-        protected Sidebar Sidebar;
+        protected SettingsSidebar Sidebar;
         private SidebarIconButton selectedSidebarButton;
 
         public SettingsSectionsContainer SectionsContainer { get; private set; }
@@ -129,7 +129,7 @@ namespace osu.Game.Overlays
 
             if (showSidebar)
             {
-                AddInternal(Sidebar = new Sidebar { Width = sidebar_width });
+                AddInternal(Sidebar = new SettingsSidebar { Width = sidebar_width });
             }
 
             CreateSections()?.ForEach(AddSection);
@@ -244,7 +244,7 @@ namespace osu.Game.Overlays
                     if (selectedSidebarButton != null)
                         selectedSidebarButton.Selected = false;
 
-                    selectedSidebarButton = Sidebar.Children.FirstOrDefault(b => b.Section == section.NewValue);
+                    selectedSidebarButton = Sidebar.Children.OfType<SidebarIconButton>().FirstOrDefault(b => b.Section == section.NewValue);
 
                     if (selectedSidebarButton != null)
                         selectedSidebarButton.Selected = true;
diff --git a/osu.Game/Overlays/SettingsSubPanel.cs b/osu.Game/Overlays/SettingsSubPanel.cs
index a65d792a9f..da806c09d3 100644
--- a/osu.Game/Overlays/SettingsSubPanel.cs
+++ b/osu.Game/Overlays/SettingsSubPanel.cs
@@ -39,7 +39,7 @@ namespace osu.Game.Overlays
             [BackgroundDependencyLoader]
             private void load()
             {
-                Size = new Vector2(Sidebar.DEFAULT_WIDTH);
+                Size = new Vector2(SettingsSidebar.DEFAULT_WIDTH);
 
                 AddRange(new Drawable[]
                 {

From 5baaf356aac038145197dc8f5524a83ae5ad50d4 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 6 Jan 2022 21:05:00 +0900
Subject: [PATCH 1936/5547] Split out `SettingsToolboxGroup` from
 `PlayerSettingsGroup`

---
 osu.Game/Overlays/SettingsToolboxGroup.cs     | 165 ++++++++++++++++++
 .../PlayerSettings/PlayerSettingsGroup.cs     | 155 +---------------
 2 files changed, 172 insertions(+), 148 deletions(-)
 create mode 100644 osu.Game/Overlays/SettingsToolboxGroup.cs

diff --git a/osu.Game/Overlays/SettingsToolboxGroup.cs b/osu.Game/Overlays/SettingsToolboxGroup.cs
new file mode 100644
index 0000000000..c154284fb9
--- /dev/null
+++ b/osu.Game/Overlays/SettingsToolboxGroup.cs
@@ -0,0 +1,165 @@
+// 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.Graphics.Sprites;
+using osu.Framework.Input.Events;
+using osu.Game.Graphics;
+using osu.Game.Graphics.Sprites;
+using osu.Game.Graphics.UserInterface;
+using osuTK;
+using osuTK.Graphics;
+
+namespace osu.Game.Overlays
+{
+    public abstract class SettingsToolboxGroup : Container
+    {
+        private const float transition_duration = 250;
+        private const int container_width = 270;
+        private const int border_thickness = 2;
+        private const int header_height = 30;
+        private const int corner_radius = 5;
+
+        private readonly FillFlowContainer content;
+        private readonly IconButton button;
+
+        private bool expanded = true;
+
+        public bool Expanded
+        {
+            get => expanded;
+            set
+            {
+                if (expanded == value) return;
+
+                expanded = value;
+
+                content.ClearTransforms();
+
+                if (expanded)
+                    content.AutoSizeAxes = Axes.Y;
+                else
+                {
+                    content.AutoSizeAxes = Axes.None;
+                    content.ResizeHeightTo(0, transition_duration, Easing.OutQuint);
+                }
+
+                updateExpanded();
+            }
+        }
+
+        private Color4 expandedColour;
+
+        /// <summary>
+        /// Create a new instance.
+        /// </summary>
+        /// <param name="title">The title to be displayed in the header of this group.</param>
+        protected SettingsToolboxGroup(string title)
+        {
+            AutoSizeAxes = Axes.Y;
+            Width = container_width;
+            Masking = true;
+            CornerRadius = corner_radius;
+            BorderColour = Color4.Black;
+            BorderThickness = border_thickness;
+
+            InternalChildren = new Drawable[]
+            {
+                new Box
+                {
+                    RelativeSizeAxes = Axes.Both,
+                    Colour = Color4.Black,
+                    Alpha = 0.5f,
+                },
+                new FillFlowContainer
+                {
+                    Direction = FillDirection.Vertical,
+                    RelativeSizeAxes = Axes.X,
+                    AutoSizeAxes = Axes.Y,
+                    Children = new Drawable[]
+                    {
+                        new Container
+                        {
+                            Name = @"Header",
+                            Origin = Anchor.TopCentre,
+                            Anchor = Anchor.TopCentre,
+                            RelativeSizeAxes = Axes.X,
+                            Height = header_height,
+                            Children = new Drawable[]
+                            {
+                                new OsuSpriteText
+                                {
+                                    Origin = Anchor.CentreLeft,
+                                    Anchor = Anchor.CentreLeft,
+                                    Text = title.ToUpperInvariant(),
+                                    Font = OsuFont.GetFont(weight: FontWeight.Bold, size: 17),
+                                    Margin = new MarginPadding { Left = 10 },
+                                },
+                                button = new IconButton
+                                {
+                                    Origin = Anchor.Centre,
+                                    Anchor = Anchor.CentreRight,
+                                    Position = new Vector2(-15, 0),
+                                    Icon = FontAwesome.Solid.Bars,
+                                    Scale = new Vector2(0.75f),
+                                    Action = () => Expanded = !Expanded,
+                                },
+                            }
+                        },
+                        content = new FillFlowContainer
+                        {
+                            Name = @"Content",
+                            Origin = Anchor.TopCentre,
+                            Anchor = Anchor.TopCentre,
+                            Direction = FillDirection.Vertical,
+                            RelativeSizeAxes = Axes.X,
+                            AutoSizeDuration = transition_duration,
+                            AutoSizeEasing = Easing.OutQuint,
+                            AutoSizeAxes = Axes.Y,
+                            Padding = new MarginPadding(15),
+                            Spacing = new Vector2(0, 15),
+                        }
+                    }
+                },
+            };
+        }
+
+        private const float fade_duration = 800;
+        private const float inactive_alpha = 0.5f;
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+            this.Delay(600).FadeTo(inactive_alpha, fade_duration, Easing.OutQuint);
+        }
+
+        protected override bool OnHover(HoverEvent e)
+        {
+            this.FadeIn(fade_duration, Easing.OutQuint);
+            return false;
+        }
+
+        protected override void OnHoverLost(HoverLostEvent e)
+        {
+            this.FadeTo(inactive_alpha, fade_duration, Easing.OutQuint);
+            base.OnHoverLost(e);
+        }
+
+        [BackgroundDependencyLoader]
+        private void load(OsuColour colours)
+        {
+            expandedColour = colours.Yellow;
+
+            updateExpanded();
+        }
+
+        private void updateExpanded() => button.FadeColour(expanded ? expandedColour : Color4.White, 200, Easing.InOutQuint);
+
+        protected override Container<Drawable> Content => content;
+
+        protected override bool OnMouseDown(MouseDownEvent e) => true;
+    }
+}
diff --git a/osu.Game/Screens/Play/PlayerSettings/PlayerSettingsGroup.cs b/osu.Game/Screens/Play/PlayerSettings/PlayerSettingsGroup.cs
index 7928d41e3b..0bbe6902f4 100644
--- a/osu.Game/Screens/Play/PlayerSettings/PlayerSettingsGroup.cs
+++ b/osu.Game/Screens/Play/PlayerSettings/PlayerSettingsGroup.cs
@@ -1,165 +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.Allocation;
-using osu.Framework.Graphics;
-using osu.Framework.Graphics.Containers;
-using osu.Framework.Graphics.Shapes;
-using osu.Framework.Graphics.Sprites;
 using osu.Framework.Input.Events;
-using osu.Game.Graphics;
-using osu.Game.Graphics.Sprites;
-using osu.Game.Graphics.UserInterface;
-using osuTK;
-using osuTK.Graphics;
+using osu.Game.Overlays;
 
 namespace osu.Game.Screens.Play.PlayerSettings
 {
-    public abstract class PlayerSettingsGroup : Container
+    public class PlayerSettingsGroup : SettingsToolboxGroup
     {
-        private const float transition_duration = 250;
-        private const int container_width = 270;
-        private const int border_thickness = 2;
-        private const int header_height = 30;
-        private const int corner_radius = 5;
-
-        private readonly FillFlowContainer content;
-        private readonly IconButton button;
-
-        private bool expanded = true;
-
-        public bool Expanded
+        public PlayerSettingsGroup(string title)
+            : base(title)
         {
-            get => expanded;
-            set
-            {
-                if (expanded == value) return;
-
-                expanded = value;
-
-                content.ClearTransforms();
-
-                if (expanded)
-                    content.AutoSizeAxes = Axes.Y;
-                else
-                {
-                    content.AutoSizeAxes = Axes.None;
-                    content.ResizeHeightTo(0, transition_duration, Easing.OutQuint);
-                }
-
-                updateExpanded();
-            }
-        }
-
-        private Color4 expandedColour;
-
-        /// <summary>
-        /// Create a new instance.
-        /// </summary>
-        /// <param name="title">The title to be displayed in the header of this group.</param>
-        protected PlayerSettingsGroup(string title)
-        {
-            AutoSizeAxes = Axes.Y;
-            Width = container_width;
-            Masking = true;
-            CornerRadius = corner_radius;
-            BorderColour = Color4.Black;
-            BorderThickness = border_thickness;
-
-            InternalChildren = new Drawable[]
-            {
-                new Box
-                {
-                    RelativeSizeAxes = Axes.Both,
-                    Colour = Color4.Black,
-                    Alpha = 0.5f,
-                },
-                new FillFlowContainer
-                {
-                    Direction = FillDirection.Vertical,
-                    RelativeSizeAxes = Axes.X,
-                    AutoSizeAxes = Axes.Y,
-                    Children = new Drawable[]
-                    {
-                        new Container
-                        {
-                            Name = @"Header",
-                            Origin = Anchor.TopCentre,
-                            Anchor = Anchor.TopCentre,
-                            RelativeSizeAxes = Axes.X,
-                            Height = header_height,
-                            Children = new Drawable[]
-                            {
-                                new OsuSpriteText
-                                {
-                                    Origin = Anchor.CentreLeft,
-                                    Anchor = Anchor.CentreLeft,
-                                    Text = title.ToUpperInvariant(),
-                                    Font = OsuFont.GetFont(weight: FontWeight.Bold, size: 17),
-                                    Margin = new MarginPadding { Left = 10 },
-                                },
-                                button = new IconButton
-                                {
-                                    Origin = Anchor.Centre,
-                                    Anchor = Anchor.CentreRight,
-                                    Position = new Vector2(-15, 0),
-                                    Icon = FontAwesome.Solid.Bars,
-                                    Scale = new Vector2(0.75f),
-                                    Action = () => Expanded = !Expanded,
-                                },
-                            }
-                        },
-                        content = new FillFlowContainer
-                        {
-                            Name = @"Content",
-                            Origin = Anchor.TopCentre,
-                            Anchor = Anchor.TopCentre,
-                            Direction = FillDirection.Vertical,
-                            RelativeSizeAxes = Axes.X,
-                            AutoSizeDuration = transition_duration,
-                            AutoSizeEasing = Easing.OutQuint,
-                            AutoSizeAxes = Axes.Y,
-                            Padding = new MarginPadding(15),
-                            Spacing = new Vector2(0, 15),
-                        }
-                    }
-                },
-            };
-        }
-
-        private const float fade_duration = 800;
-        private const float inactive_alpha = 0.5f;
-
-        protected override void LoadComplete()
-        {
-            base.LoadComplete();
-            this.Delay(600).FadeTo(inactive_alpha, fade_duration, Easing.OutQuint);
         }
 
         protected override bool OnHover(HoverEvent e)
         {
-            this.FadeIn(fade_duration, Easing.OutQuint);
+            base.OnHover(e);
+
+            // Importantly, return true to correctly take focus away from PlayerLoader.
             return true;
         }
-
-        protected override void OnHoverLost(HoverLostEvent e)
-        {
-            this.FadeTo(inactive_alpha, fade_duration, Easing.OutQuint);
-            base.OnHoverLost(e);
-        }
-
-        [BackgroundDependencyLoader]
-        private void load(OsuColour colours)
-        {
-            expandedColour = colours.Yellow;
-
-            updateExpanded();
-        }
-
-        private void updateExpanded() => button.FadeColour(expanded ? expandedColour : Color4.White, 200, Easing.InOutQuint);
-
-        protected override Container<Drawable> Content => content;
-
-        protected override bool OnMouseDown(MouseDownEvent e) => true;
     }
 }

From 66613cbaa4551c055a5e756787cb36ab0fe9072c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 6 Jan 2022 13:09:25 +0100
Subject: [PATCH 1937/5547] Wait for async continuation in score submission
 test

The previous assert step was optimistically assuming that the async
continuation that writes the value of
`FakeImportingPlayer.ImportedScore` always completes before it, but
that's not necessarily true even if the continuation is instant (it is
still subject to things like task scheduling and TPL thread pool
limits).

To ensure no spurious failures, swap out the assert step for an until
step instead.
---
 .../Visual/Gameplay/TestScenePlayerScoreSubmission.cs           | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestScenePlayerScoreSubmission.cs b/osu.Game.Tests/Visual/Gameplay/TestScenePlayerScoreSubmission.cs
index 5ee1f9dd8f..cf5aadde6d 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestScenePlayerScoreSubmission.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestScenePlayerScoreSubmission.cs
@@ -226,7 +226,7 @@ namespace osu.Game.Tests.Visual.Gameplay
 
             AddStep("exit", () => Player.Exit());
             AddStep("allow import to proceed", () => Player.AllowImportCompletion.Release(1));
-            AddAssert("ensure submission", () => Player.SubmittedScore != null && Player.ImportedScore != null);
+            AddUntilStep("ensure submission", () => Player.SubmittedScore != null && Player.ImportedScore != null);
         }
 
         [Test]

From cea9cab4dcca4da45b98cb868e89a65e391869c9 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 6 Jan 2022 21:10:45 +0900
Subject: [PATCH 1938/5547] Use `ExpandingButtonContainer` in editor composer

---
 osu.Game/Overlays/SettingsToolboxGroup.cs     |  4 ++-
 ...{ToolboxGroup.cs => EditorToolboxGroup.cs} |  6 ++---
 osu.Game/Rulesets/Edit/HitObjectComposer.cs   | 26 ++++++++++++-------
 .../Rulesets/Edit/ScrollingToolboxGroup.cs    |  2 +-
 4 files changed, 23 insertions(+), 15 deletions(-)
 rename osu.Game/Rulesets/Edit/{ToolboxGroup.cs => EditorToolboxGroup.cs} (71%)

diff --git a/osu.Game/Overlays/SettingsToolboxGroup.cs b/osu.Game/Overlays/SettingsToolboxGroup.cs
index c154284fb9..02b5bdc1e1 100644
--- a/osu.Game/Overlays/SettingsToolboxGroup.cs
+++ b/osu.Game/Overlays/SettingsToolboxGroup.cs
@@ -94,9 +94,11 @@ namespace osu.Game.Overlays
                                 {
                                     Origin = Anchor.CentreLeft,
                                     Anchor = Anchor.CentreLeft,
+                                    RelativeSizeAxes = Axes.X,
+                                    Truncate = true,
                                     Text = title.ToUpperInvariant(),
                                     Font = OsuFont.GetFont(weight: FontWeight.Bold, size: 17),
-                                    Margin = new MarginPadding { Left = 10 },
+                                    Padding = new MarginPadding { Left = 10, Right = 30 },
                                 },
                                 button = new IconButton
                                 {
diff --git a/osu.Game/Rulesets/Edit/ToolboxGroup.cs b/osu.Game/Rulesets/Edit/EditorToolboxGroup.cs
similarity index 71%
rename from osu.Game/Rulesets/Edit/ToolboxGroup.cs
rename to osu.Game/Rulesets/Edit/EditorToolboxGroup.cs
index 22b2b05657..bde426f56a 100644
--- a/osu.Game/Rulesets/Edit/ToolboxGroup.cs
+++ b/osu.Game/Rulesets/Edit/EditorToolboxGroup.cs
@@ -2,13 +2,13 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using osu.Framework.Graphics;
-using osu.Game.Screens.Play.PlayerSettings;
+using osu.Game.Overlays;
 
 namespace osu.Game.Rulesets.Edit
 {
-    public class ToolboxGroup : PlayerSettingsGroup
+    public class EditorToolboxGroup : SettingsToolboxGroup
     {
-        public ToolboxGroup(string title)
+        public EditorToolboxGroup(string title)
             : base(title)
         {
             RelativeSizeAxes = Axes.X;
diff --git a/osu.Game/Rulesets/Edit/HitObjectComposer.cs b/osu.Game/Rulesets/Edit/HitObjectComposer.cs
index cbc2415603..92ea2db338 100644
--- a/osu.Game/Rulesets/Edit/HitObjectComposer.cs
+++ b/osu.Game/Rulesets/Edit/HitObjectComposer.cs
@@ -13,6 +13,7 @@ using osu.Framework.Input;
 using osu.Framework.Input.Events;
 using osu.Framework.Logging;
 using osu.Game.Beatmaps;
+using osu.Game.Overlays;
 using osu.Game.Rulesets.Configuration;
 using osu.Game.Rulesets.Edit.Tools;
 using osu.Game.Rulesets.Mods;
@@ -98,8 +99,6 @@ namespace osu.Game.Rulesets.Edit
 
             dependencies.CacheAs(Playfield);
 
-            const float toolbar_width = 200;
-
             InternalChildren = new Drawable[]
             {
                 new Container
@@ -116,20 +115,15 @@ namespace osu.Game.Rulesets.Edit
                                               .WithChild(BlueprintContainer = CreateBlueprintContainer())
                     }
                 },
-                new FillFlowContainer
+                new LeftToolboxFlow
                 {
-                    Name = "Sidebar",
-                    RelativeSizeAxes = Axes.Y,
-                    Width = toolbar_width,
-                    Padding = new MarginPadding { Right = 10 },
-                    Spacing = new Vector2(10),
                     Children = new Drawable[]
                     {
-                        new ToolboxGroup("toolbox (1-9)")
+                        new EditorToolboxGroup("toolbox (1-9)")
                         {
                             Child = toolboxCollection = new EditorRadioButtonCollection { RelativeSizeAxes = Axes.X }
                         },
-                        new ToolboxGroup("toggles (Q~P)")
+                        new EditorToolboxGroup("toggles (Q~P)")
                         {
                             Child = togglesCollection = new FillFlowContainer
                             {
@@ -426,6 +420,18 @@ namespace osu.Game.Rulesets.Edit
         }
 
         #endregion
+
+        private class LeftToolboxFlow : ExpandingButtonContainer
+        {
+            public LeftToolboxFlow()
+                : base(80, 200)
+            {
+                RelativeSizeAxes = Axes.Y;
+                Padding = new MarginPadding { Right = 10 };
+
+                FillFlow.Spacing = new Vector2(10);
+            }
+        }
     }
 
     /// <summary>
diff --git a/osu.Game/Rulesets/Edit/ScrollingToolboxGroup.cs b/osu.Game/Rulesets/Edit/ScrollingToolboxGroup.cs
index a54f574bff..9998a997b3 100644
--- a/osu.Game/Rulesets/Edit/ScrollingToolboxGroup.cs
+++ b/osu.Game/Rulesets/Edit/ScrollingToolboxGroup.cs
@@ -7,7 +7,7 @@ using osu.Game.Graphics.Containers;
 
 namespace osu.Game.Rulesets.Edit
 {
-    public class ScrollingToolboxGroup : ToolboxGroup
+    public class ScrollingToolboxGroup : EditorToolboxGroup
     {
         protected readonly OsuScrollContainer Scroll;
 

From 3ea7588a91261fce0969d56f4032ea217c34f925 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 5 Jan 2022 15:54:10 +0900
Subject: [PATCH 1939/5547] Update continuation usages to use
 `GetCompletedResult`

---
 osu.Game/Beatmaps/BeatmapDifficultyCache.cs               | 8 +++++---
 osu.Game/Database/OnlineLookupCache.cs                    | 2 +-
 osu.Game/Online/Chat/ChannelManager.cs                    | 6 ++++--
 osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.cs    | 2 +-
 osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs    | 2 +-
 .../Overlays/Settings/Sections/General/UpdateSettings.cs  | 2 +-
 osu.Game/Scoring/ScoreManager.cs                          | 2 +-
 .../Screens/Play/HUD/MultiplayerGameplayLeaderboard.cs    | 2 +-
 osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs     | 2 +-
 .../Ranking/Expanded/Statistics/PerformanceStatistic.cs   | 2 +-
 osu.Game/Screens/Ranking/ScorePanelList.cs                | 2 +-
 osu.Game/Screens/Select/Details/AdvancedStats.cs          | 4 ++--
 .../Screens/Select/Leaderboards/BeatmapLeaderboard.cs     | 4 ++--
 osu.Game/Screens/Spectate/SpectatorScreen.cs              | 2 +-
 osu.Game/Tests/Beatmaps/BeatmapConversionTest.cs          | 2 +-
 15 files changed, 24 insertions(+), 20 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapDifficultyCache.cs b/osu.Game/Beatmaps/BeatmapDifficultyCache.cs
index 0e4dab2b96..45dadc4e3f 100644
--- a/osu.Game/Beatmaps/BeatmapDifficultyCache.cs
+++ b/osu.Game/Beatmaps/BeatmapDifficultyCache.cs
@@ -262,7 +262,7 @@ namespace osu.Game.Beatmaps
             // GetDifficultyAsync will fall back to existing data from IBeatmapInfo if not locally available
             // (contrary to GetAsync)
             GetDifficultyAsync(bindable.BeatmapInfo, rulesetInfo, mods, cancellationToken)
-                .ContinueWith(t =>
+                .ContinueWith(task =>
                 {
                     // We're on a threadpool thread, but we should exit back to the update thread so consumers can safely handle value-changed events.
                     Schedule(() =>
@@ -270,8 +270,10 @@ namespace osu.Game.Beatmaps
                         if (cancellationToken.IsCancellationRequested)
                             return;
 
-                        if (t.WaitSafelyForResult() is StarDifficulty sd)
-                            bindable.Value = sd;
+                        var starDifficulty = task.GetCompletedResult();
+
+                        if (starDifficulty != null)
+                            bindable.Value = starDifficulty.Value;
                     });
                 }, cancellationToken);
         }
diff --git a/osu.Game/Database/OnlineLookupCache.cs b/osu.Game/Database/OnlineLookupCache.cs
index b392336bb4..f5847428ee 100644
--- a/osu.Game/Database/OnlineLookupCache.cs
+++ b/osu.Game/Database/OnlineLookupCache.cs
@@ -59,7 +59,7 @@ namespace osu.Game.Database
                     if (!task.IsCompletedSuccessfully)
                         return null;
 
-                    return task.WaitSafelyForResult();
+                    return task.GetCompletedResult();
                 }, token));
             }
 
diff --git a/osu.Game/Online/Chat/ChannelManager.cs b/osu.Game/Online/Chat/ChannelManager.cs
index 3b27dd5c5d..52d5fa1642 100644
--- a/osu.Game/Online/Chat/ChannelManager.cs
+++ b/osu.Game/Online/Chat/ChannelManager.cs
@@ -536,8 +536,10 @@ namespace osu.Game.Online.Chat
                     // Try to get user in order to open PM chat
                     users.GetUserAsync((int)lastClosedChannel.Id).ContinueWith(task =>
                     {
-                        if (task.WaitSafelyForResult() is APIUser u)
-                            Schedule(() => CurrentChannel.Value = JoinChannel(new Channel(u)));
+                        var user = task.GetCompletedResult();
+
+                        if (user != null)
+                            Schedule(() => CurrentChannel.Value = JoinChannel(new Channel(user)));
                     });
                 }
 
diff --git a/osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.cs b/osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.cs
index adb1adeed4..0f25be2d3c 100644
--- a/osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.cs
+++ b/osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.cs
@@ -85,7 +85,7 @@ namespace osu.Game.Overlays.BeatmapSet.Scores
                                 if (loadCancellationSource.IsCancellationRequested)
                                     return;
 
-                                var scores = task.WaitSafelyForResult();
+                                var scores = task.GetCompletedResult();
 
                                 var topScore = scores.First();
 
diff --git a/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs b/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs
index b7d236c263..73b199f159 100644
--- a/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs
+++ b/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs
@@ -64,7 +64,7 @@ namespace osu.Game.Overlays.Dashboard
                     {
                         users.GetUserAsync(id).ContinueWith(task =>
                         {
-                            var user = task.WaitSafelyForResult();
+                            var user = task.GetCompletedResult();
 
                             if (user == null) return;
 
diff --git a/osu.Game/Overlays/Settings/Sections/General/UpdateSettings.cs b/osu.Game/Overlays/Settings/Sections/General/UpdateSettings.cs
index 49eb80d993..8dbae420ac 100644
--- a/osu.Game/Overlays/Settings/Sections/General/UpdateSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/General/UpdateSettings.cs
@@ -48,7 +48,7 @@ namespace osu.Game.Overlays.Settings.Sections.General
                         checkForUpdatesButton.Enabled.Value = false;
                         Task.Run(updateManager.CheckForUpdateAsync).ContinueWith(task => Schedule(() =>
                         {
-                            if (!task.WaitSafelyForResult())
+                            if (!task.GetCompletedResult())
                             {
                                 notifications?.Post(new SimpleNotification
                                 {
diff --git a/osu.Game/Scoring/ScoreManager.cs b/osu.Game/Scoring/ScoreManager.cs
index 9715cd64a7..b4edb23689 100644
--- a/osu.Game/Scoring/ScoreManager.cs
+++ b/osu.Game/Scoring/ScoreManager.cs
@@ -113,7 +113,7 @@ namespace osu.Game.Scoring
         public void GetTotalScore([NotNull] ScoreInfo score, [NotNull] Action<long> callback, ScoringMode mode = ScoringMode.Standardised, CancellationToken cancellationToken = default)
         {
             GetTotalScoreAsync(score, mode, cancellationToken)
-                .ContinueWith(task => scheduler.Add(() => callback(task.WaitSafelyForResult())), TaskContinuationOptions.OnlyOnRanToCompletion);
+                .ContinueWith(task => scheduler.Add(() => callback(task.GetCompletedResult())), TaskContinuationOptions.OnlyOnRanToCompletion);
         }
 
         /// <summary>
diff --git a/osu.Game/Screens/Play/HUD/MultiplayerGameplayLeaderboard.cs b/osu.Game/Screens/Play/HUD/MultiplayerGameplayLeaderboard.cs
index 6f2a76b3cb..c384d97229 100644
--- a/osu.Game/Screens/Play/HUD/MultiplayerGameplayLeaderboard.cs
+++ b/osu.Game/Screens/Play/HUD/MultiplayerGameplayLeaderboard.cs
@@ -79,7 +79,7 @@ namespace osu.Game.Screens.Play.HUD
 
             userLookupCache.GetUsersAsync(playingUsers.Select(u => u.UserID).ToArray()).ContinueWith(task => Schedule(() =>
             {
-                var users = task.WaitSafelyForResult();
+                var users = task.GetCompletedResult();
 
                 foreach (var user in users)
                 {
diff --git a/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs b/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs
index f543cea15c..897678640f 100644
--- a/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs
+++ b/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs
@@ -76,7 +76,7 @@ namespace osu.Game.Screens.Play.HUD
                 difficultyCache.GetTimedDifficultyAttributesAsync(gameplayWorkingBeatmap, gameplayState.Ruleset, clonedMods, loadCancellationSource.Token)
                                .ContinueWith(task => Schedule(() =>
                                {
-                                   timedAttributes = task.WaitSafelyForResult();
+                                   timedAttributes = task.GetCompletedResult();
 
                                    IsValid = true;
 
diff --git a/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatistic.cs b/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatistic.cs
index 90ecd3642b..1d00043244 100644
--- a/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatistic.cs
+++ b/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatistic.cs
@@ -38,7 +38,7 @@ namespace osu.Game.Screens.Ranking.Expanded.Statistics
             else
             {
                 performanceCache.CalculatePerformanceAsync(score, cancellationTokenSource.Token)
-                                .ContinueWith(t => Schedule(() => setPerformanceValue(t.WaitSafelyForResult())), cancellationTokenSource.Token);
+                                .ContinueWith(t => Schedule(() => setPerformanceValue(t.GetCompletedResult())), cancellationTokenSource.Token);
             }
         }
 
diff --git a/osu.Game/Screens/Ranking/ScorePanelList.cs b/osu.Game/Screens/Ranking/ScorePanelList.cs
index b29f2302d5..5ae6b9d417 100644
--- a/osu.Game/Screens/Ranking/ScorePanelList.cs
+++ b/osu.Game/Screens/Ranking/ScorePanelList.cs
@@ -154,7 +154,7 @@ namespace osu.Game.Screens.Ranking
             scoreManager.GetTotalScoreAsync(score)
                         .ContinueWith(task => Schedule(() =>
                         {
-                            flow.SetLayoutPosition(trackingContainer, task.WaitSafelyForResult());
+                            flow.SetLayoutPosition(trackingContainer, task.GetCompletedResult());
 
                             trackingContainer.Show();
 
diff --git a/osu.Game/Screens/Select/Details/AdvancedStats.cs b/osu.Game/Screens/Select/Details/AdvancedStats.cs
index e7764b23be..dacc8c11e1 100644
--- a/osu.Game/Screens/Select/Details/AdvancedStats.cs
+++ b/osu.Game/Screens/Select/Details/AdvancedStats.cs
@@ -153,8 +153,8 @@ namespace osu.Game.Screens.Select.Details
 
             Task.WhenAll(normalStarDifficultyTask, moddedStarDifficultyTask).ContinueWith(_ => Schedule(() =>
             {
-                var normalDifficulty = normalStarDifficultyTask.WaitSafelyForResult();
-                var moddeDifficulty = moddedStarDifficultyTask.WaitSafelyForResult();
+                var normalDifficulty = normalStarDifficultyTask.GetCompletedResult();
+                var moddeDifficulty = moddedStarDifficultyTask.GetCompletedResult();
 
                 if (normalDifficulty == null || moddeDifficulty == null)
                     return;
diff --git a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
index 6943f2a3b6..fbfca130ba 100644
--- a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
+++ b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
@@ -143,7 +143,7 @@ namespace osu.Game.Screens.Select.Leaderboards
                 }
 
                 scoreManager.OrderByTotalScoreAsync(scores.ToArray(), cancellationToken)
-                            .ContinueWith(ordered => scoresCallback?.Invoke(ordered.WaitSafelyForResult()), TaskContinuationOptions.OnlyOnRanToCompletion);
+                            .ContinueWith(task => scoresCallback?.Invoke(task.GetCompletedResult()), TaskContinuationOptions.OnlyOnRanToCompletion);
 
                 return null;
             }
@@ -184,7 +184,7 @@ namespace osu.Game.Screens.Select.Leaderboards
                                 if (cancellationToken.IsCancellationRequested)
                                     return;
 
-                                scoresCallback?.Invoke(task.WaitSafelyForResult());
+                                scoresCallback?.Invoke(task.GetCompletedResult());
                                 TopScore = r.UserScore?.CreateScoreInfo(rulesets, fetchBeatmapInfo);
                             }), TaskContinuationOptions.OnlyOnRanToCompletion);
             };
diff --git a/osu.Game/Screens/Spectate/SpectatorScreen.cs b/osu.Game/Screens/Spectate/SpectatorScreen.cs
index f361b0cee4..44a31d89ed 100644
--- a/osu.Game/Screens/Spectate/SpectatorScreen.cs
+++ b/osu.Game/Screens/Spectate/SpectatorScreen.cs
@@ -60,7 +60,7 @@ namespace osu.Game.Screens.Spectate
 
             userLookupCache.GetUsersAsync(users.ToArray()).ContinueWith(task => Schedule(() =>
             {
-                var foundUsers = task.WaitSafelyForResult();
+                var foundUsers = task.GetCompletedResult();
 
                 foreach (var u in foundUsers)
                 {
diff --git a/osu.Game/Tests/Beatmaps/BeatmapConversionTest.cs b/osu.Game/Tests/Beatmaps/BeatmapConversionTest.cs
index 1b3e49de37..589857b458 100644
--- a/osu.Game/Tests/Beatmaps/BeatmapConversionTest.cs
+++ b/osu.Game/Tests/Beatmaps/BeatmapConversionTest.cs
@@ -148,7 +148,7 @@ namespace osu.Game.Tests.Beatmaps
             if (!conversionTask.Wait(10000))
                 Assert.Fail("Conversion timed out");
 
-            return conversionTask.WaitSafelyForResult();
+            return conversionTask.GetCompletedResult();
         }
 
         protected virtual void OnConversionGenerated(HitObject original, IEnumerable<HitObject> result, IBeatmapConverter beatmapConverter)

From 00177a3ae195130dcabe9657c76c78a4b809f481 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 6 Jan 2022 22:54:43 +0900
Subject: [PATCH 1940/5547] Update usages to new naming

---
 CodeAnalysis/BannedSymbols.txt                         |  2 +-
 osu.Game.Tests/Beatmaps/IO/ImportBeatmapTest.cs        |  4 ++--
 .../Beatmaps/TestSceneBeatmapDifficultyCache.cs        |  2 +-
 osu.Game.Tests/NonVisual/TaskChainTest.cs              | 10 +++++-----
 osu.Game.Tests/Skins/IO/ImportSkinTest.cs              |  4 ++--
 osu.Game.Tests/Skins/TestSceneBeatmapSkinResources.cs  |  2 +-
 osu.Game.Tests/Skins/TestSceneSkinResources.cs         |  2 +-
 .../Visual/Editing/TestSceneDifficultySwitching.cs     |  2 +-
 .../Visual/Editing/TestSceneEditorTestGameplay.cs      |  2 +-
 .../Visual/Gameplay/TestSceneReplayDownloadButton.cs   |  2 +-
 osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs   |  2 +-
 .../Visual/Menus/TestSceneMusicActionHandling.cs       |  2 +-
 .../Multiplayer/TestSceneMultiSpectatorScreen.cs       |  2 +-
 .../TestSceneMultiplayerGameplayLeaderboard.cs         |  4 ++--
 .../TestSceneMultiplayerGameplayLeaderboardTeams.cs    |  2 +-
 .../Visual/Navigation/TestScenePresentBeatmap.cs       |  2 +-
 .../Visual/Navigation/TestScenePresentScore.cs         |  4 ++--
 .../Visual/Playlists/TestScenePlaylistsRoomCreation.cs |  2 +-
 .../SongSelect/TestSceneBeatmapRecommendations.cs      |  2 +-
 .../Visual/SongSelect/TestScenePlaySongSelect.cs       |  2 +-
 .../Visual/UserInterface/TestSceneDeleteLocalScore.cs  |  4 ++--
 .../TestSceneUpdateableBeatmapBackgroundSprite.cs      |  2 +-
 osu.Game/Beatmaps/BeatmapDifficultyCache.cs            |  2 +-
 osu.Game/Beatmaps/BeatmapManager.cs                    |  2 +-
 osu.Game/Beatmaps/WorkingBeatmap.cs                    |  2 +-
 osu.Game/Database/OnlineLookupCache.cs                 |  2 +-
 osu.Game/Online/Chat/ChannelManager.cs                 |  2 +-
 osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.cs |  2 +-
 osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs |  2 +-
 .../Settings/Sections/General/UpdateSettings.cs        |  2 +-
 osu.Game/Scoring/ScoreManager.cs                       |  2 +-
 osu.Game/Screens/Menu/IntroScreen.cs                   |  2 +-
 .../Screens/Play/HUD/MultiplayerGameplayLeaderboard.cs |  2 +-
 osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs  |  2 +-
 osu.Game/Screens/Play/Player.cs                        |  2 +-
 .../Ranking/Expanded/ExpandedPanelMiddleContent.cs     |  2 +-
 .../Expanded/Statistics/PerformanceStatistic.cs        |  2 +-
 osu.Game/Screens/Select/Details/AdvancedStats.cs       |  4 ++--
 .../Screens/Select/Leaderboards/BeatmapLeaderboard.cs  |  4 ++--
 osu.Game/Screens/Spectate/SpectatorScreen.cs           |  2 +-
 osu.Game/Skinning/SkinManager.cs                       |  2 +-
 osu.Game/Tests/Beatmaps/BeatmapConversionTest.cs       |  2 +-
 42 files changed, 53 insertions(+), 53 deletions(-)

diff --git a/CodeAnalysis/BannedSymbols.txt b/CodeAnalysis/BannedSymbols.txt
index 4428656301..e96ad48325 100644
--- a/CodeAnalysis/BannedSymbols.txt
+++ b/CodeAnalysis/BannedSymbols.txt
@@ -14,4 +14,4 @@ M:Realms.IRealmCollection`1.SubscribeForNotifications`1(Realms.NotificationCallb
 M:Realms.CollectionExtensions.SubscribeForNotifications`1(System.Linq.IQueryable{``0},Realms.NotificationCallbackDelegate{``0});Use osu.Game.Database.RealmObjectExtensions.QueryAsyncWithNotifications(IQueryable<T>,NotificationCallbackDelegate<T>) instead.
 M:Realms.CollectionExtensions.SubscribeForNotifications`1(System.Collections.Generic.IList{``0},Realms.NotificationCallbackDelegate{``0});Use osu.Game.Database.RealmObjectExtensions.QueryAsyncWithNotifications(IList<T>,NotificationCallbackDelegate<T>) instead.
 M:System.Threading.Tasks.Task.Wait();Don't use Task.Wait. Use Task.WaitSafely() to ensure we avoid deadlocks.
-P:System.Threading.Tasks.Task`1.Result;Don't use Task.Result. Use Task.WaitSafelyForResult() to ensure we avoid deadlocks.
+P:System.Threading.Tasks.Task`1.Result;Don't use Task.Result. Use Task.GetResultSafely() to ensure we avoid deadlocks.
diff --git a/osu.Game.Tests/Beatmaps/IO/ImportBeatmapTest.cs b/osu.Game.Tests/Beatmaps/IO/ImportBeatmapTest.cs
index 2a2cc2e086..c02141bf9f 100644
--- a/osu.Game.Tests/Beatmaps/IO/ImportBeatmapTest.cs
+++ b/osu.Game.Tests/Beatmaps/IO/ImportBeatmapTest.cs
@@ -984,7 +984,7 @@ namespace osu.Game.Tests.Beatmaps.IO
 
             var manager = osu.Dependencies.Get<BeatmapManager>();
 
-            var importedSet = manager.Import(new ImportTask(temp)).WaitSafelyForResult();
+            var importedSet = manager.Import(new ImportTask(temp)).GetResultSafely();
 
             ensureLoaded(osu).WaitSafely();
 
@@ -999,7 +999,7 @@ namespace osu.Game.Tests.Beatmaps.IO
 
             var manager = osu.Dependencies.Get<BeatmapManager>();
 
-            var importedSet = manager.Import(new ImportTask(temp)).WaitSafelyForResult();
+            var importedSet = manager.Import(new ImportTask(temp)).GetResultSafely();
 
             ensureLoaded(osu).WaitSafely();
 
diff --git a/osu.Game.Tests/Beatmaps/TestSceneBeatmapDifficultyCache.cs b/osu.Game.Tests/Beatmaps/TestSceneBeatmapDifficultyCache.cs
index a97b372db0..26ab8808b9 100644
--- a/osu.Game.Tests/Beatmaps/TestSceneBeatmapDifficultyCache.cs
+++ b/osu.Game.Tests/Beatmaps/TestSceneBeatmapDifficultyCache.cs
@@ -33,7 +33,7 @@ namespace osu.Game.Tests.Beatmaps
         [BackgroundDependencyLoader]
         private void load(OsuGameBase osu)
         {
-            importedSet = ImportBeatmapTest.LoadQuickOszIntoOsu(osu).WaitSafelyForResult();
+            importedSet = ImportBeatmapTest.LoadQuickOszIntoOsu(osu).GetResultSafely();
         }
 
         [SetUpSteps]
diff --git a/osu.Game.Tests/NonVisual/TaskChainTest.cs b/osu.Game.Tests/NonVisual/TaskChainTest.cs
index db3cecf8ea..3678279035 100644
--- a/osu.Game.Tests/NonVisual/TaskChainTest.cs
+++ b/osu.Game.Tests/NonVisual/TaskChainTest.cs
@@ -43,9 +43,9 @@ namespace osu.Game.Tests.NonVisual
 
             await Task.WhenAll(task1.task, task2.task, task3.task);
 
-            Assert.That(task1.task.WaitSafelyForResult(), Is.EqualTo(1));
-            Assert.That(task2.task.WaitSafelyForResult(), Is.EqualTo(2));
-            Assert.That(task3.task.WaitSafelyForResult(), Is.EqualTo(3));
+            Assert.That(task1.task.GetResultSafely(), Is.EqualTo(1));
+            Assert.That(task2.task.GetResultSafely(), Is.EqualTo(2));
+            Assert.That(task3.task.GetResultSafely(), Is.EqualTo(3));
         }
 
         [Test]
@@ -69,9 +69,9 @@ namespace osu.Game.Tests.NonVisual
             // Wait on both tasks.
             await Task.WhenAll(task1.task, task3.task);
 
-            Assert.That(task1.task.WaitSafelyForResult(), Is.EqualTo(1));
+            Assert.That(task1.task.GetResultSafely(), Is.EqualTo(1));
             Assert.That(task2.task.IsCompleted, Is.False);
-            Assert.That(task3.task.WaitSafelyForResult(), Is.EqualTo(2));
+            Assert.That(task3.task.GetResultSafely(), Is.EqualTo(2));
         }
 
         [Test]
diff --git a/osu.Game.Tests/Skins/IO/ImportSkinTest.cs b/osu.Game.Tests/Skins/IO/ImportSkinTest.cs
index 55a50fb825..3f063264e0 100644
--- a/osu.Game.Tests/Skins/IO/ImportSkinTest.cs
+++ b/osu.Game.Tests/Skins/IO/ImportSkinTest.cs
@@ -188,7 +188,7 @@ namespace osu.Game.Tests.Skins.IO
 
             var imported = skinManager.Import(new ImportTask(exportStream, "exported.osk"));
 
-            imported.WaitSafelyForResult().PerformRead(s =>
+            imported.GetResultSafely().PerformRead(s =>
             {
                 Assert.IsFalse(s.Protected);
                 Assert.AreNotEqual(originalSkinId, s.ID);
@@ -223,7 +223,7 @@ namespace osu.Game.Tests.Skins.IO
 
             var imported = skinManager.Import(new ImportTask(exportStream, "exported.osk"));
 
-            imported.WaitSafelyForResult().PerformRead(s =>
+            imported.GetResultSafely().PerformRead(s =>
             {
                 Assert.IsFalse(s.Protected);
                 Assert.AreNotEqual(originalSkinId, s.ID);
diff --git a/osu.Game.Tests/Skins/TestSceneBeatmapSkinResources.cs b/osu.Game.Tests/Skins/TestSceneBeatmapSkinResources.cs
index a4c2ec3b34..c20ab84a68 100644
--- a/osu.Game.Tests/Skins/TestSceneBeatmapSkinResources.cs
+++ b/osu.Game.Tests/Skins/TestSceneBeatmapSkinResources.cs
@@ -25,7 +25,7 @@ namespace osu.Game.Tests.Skins
         [BackgroundDependencyLoader]
         private void load()
         {
-            var imported = beatmaps.Import(new ZipArchiveReader(TestResources.OpenResource("Archives/ogg-beatmap.osz"))).WaitSafelyForResult();
+            var imported = beatmaps.Import(new ZipArchiveReader(TestResources.OpenResource("Archives/ogg-beatmap.osz"))).GetResultSafely();
             beatmap = beatmaps.GetWorkingBeatmap(imported.Value.Beatmaps[0]);
             beatmap.LoadTrack();
         }
diff --git a/osu.Game.Tests/Skins/TestSceneSkinResources.cs b/osu.Game.Tests/Skins/TestSceneSkinResources.cs
index a10e2436d6..0271198049 100644
--- a/osu.Game.Tests/Skins/TestSceneSkinResources.cs
+++ b/osu.Game.Tests/Skins/TestSceneSkinResources.cs
@@ -24,7 +24,7 @@ namespace osu.Game.Tests.Skins
         [BackgroundDependencyLoader]
         private void load()
         {
-            var imported = skins.Import(new ZipArchiveReader(TestResources.OpenResource("Archives/ogg-skin.osk"))).WaitSafelyForResult();
+            var imported = skins.Import(new ZipArchiveReader(TestResources.OpenResource("Archives/ogg-skin.osk"))).GetResultSafely();
             skin = imported.PerformRead(skinInfo => skins.GetSkin(skinInfo));
         }
 
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneDifficultySwitching.cs b/osu.Game.Tests/Visual/Editing/TestSceneDifficultySwitching.cs
index 5dd5bad0d2..516305079b 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneDifficultySwitching.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneDifficultySwitching.cs
@@ -33,7 +33,7 @@ namespace osu.Game.Tests.Visual.Editing
 
         public override void SetUpSteps()
         {
-            AddStep("import test beatmap", () => importedBeatmapSet = ImportBeatmapTest.LoadOszIntoOsu(game, virtualTrack: true).WaitSafelyForResult());
+            AddStep("import test beatmap", () => importedBeatmapSet = ImportBeatmapTest.LoadOszIntoOsu(game, virtualTrack: true).GetResultSafely());
             base.SetUpSteps();
         }
 
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneEditorTestGameplay.cs b/osu.Game.Tests/Visual/Editing/TestSceneEditorTestGameplay.cs
index fcbae44c76..6d48ef3ba7 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneEditorTestGameplay.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneEditorTestGameplay.cs
@@ -39,7 +39,7 @@ namespace osu.Game.Tests.Visual.Editing
 
         public override void SetUpSteps()
         {
-            AddStep("import test beatmap", () => importedBeatmapSet = ImportBeatmapTest.LoadOszIntoOsu(game).WaitSafelyForResult());
+            AddStep("import test beatmap", () => importedBeatmapSet = ImportBeatmapTest.LoadOszIntoOsu(game).GetResultSafely());
             base.SetUpSteps();
         }
 
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneReplayDownloadButton.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneReplayDownloadButton.cs
index 7f5ac5cf48..3168c4b94e 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneReplayDownloadButton.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneReplayDownloadButton.cs
@@ -136,7 +136,7 @@ namespace osu.Game.Tests.Visual.Gameplay
 
             AddUntilStep("state is not downloaded", () => downloadButton.State.Value == DownloadState.NotDownloaded);
 
-            AddStep("import score", () => imported = scoreManager.Import(getScoreInfo(true)).WaitSafelyForResult());
+            AddStep("import score", () => imported = scoreManager.Import(getScoreInfo(true)).GetResultSafely());
 
             AddUntilStep("state is available", () => downloadButton.State.Value == DownloadState.LocallyAvailable);
 
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs
index 90065e3b51..242eca0bbc 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs
@@ -61,7 +61,7 @@ namespace osu.Game.Tests.Visual.Gameplay
 
             AddStep("import beatmap", () =>
             {
-                importedBeatmap = ImportBeatmapTest.LoadOszIntoOsu(game, virtualTrack: true).WaitSafelyForResult();
+                importedBeatmap = ImportBeatmapTest.LoadOszIntoOsu(game, virtualTrack: true).GetResultSafely();
                 importedBeatmapId = importedBeatmap.Beatmaps.First(b => b.RulesetID == 0).OnlineID ?? -1;
             });
         }
diff --git a/osu.Game.Tests/Visual/Menus/TestSceneMusicActionHandling.cs b/osu.Game.Tests/Visual/Menus/TestSceneMusicActionHandling.cs
index c82bde3444..ee9363fa12 100644
--- a/osu.Game.Tests/Visual/Menus/TestSceneMusicActionHandling.cs
+++ b/osu.Game.Tests/Visual/Menus/TestSceneMusicActionHandling.cs
@@ -38,7 +38,7 @@ namespace osu.Game.Tests.Visual.Menus
 
             AddStep("import beatmap with track", () =>
             {
-                var setWithTrack = Game.BeatmapManager.Import(new ImportTask(TestResources.GetTestBeatmapForImport())).WaitSafelyForResult();
+                var setWithTrack = Game.BeatmapManager.Import(new ImportTask(TestResources.GetTestBeatmapForImport())).GetResultSafely();
                 Beatmap.Value = Game.BeatmapManager.GetWorkingBeatmap(setWithTrack.Value.Beatmaps.First());
             });
 
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs
index 3f24da2c9e..61058bc87a 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs
@@ -47,7 +47,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [BackgroundDependencyLoader]
         private void load()
         {
-            importedSet = ImportBeatmapTest.LoadOszIntoOsu(game, virtualTrack: true).WaitSafelyForResult();
+            importedSet = ImportBeatmapTest.LoadOszIntoOsu(game, virtualTrack: true).GetResultSafely();
             importedBeatmap = importedSet.Beatmaps.First(b => b.RulesetID == 0);
             importedBeatmapId = importedBeatmap.OnlineID ?? -1;
         }
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs
index 6b40a4fc9a..07a8ef66e1 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs
@@ -44,7 +44,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             base.SetUpSteps();
 
-            AddStep("set local user", () => ((DummyAPIAccess)API).LocalUser.Value = LookupCache.GetUserAsync(1).WaitSafelyForResult());
+            AddStep("set local user", () => ((DummyAPIAccess)API).LocalUser.Value = LookupCache.GetUserAsync(1).GetResultSafely());
 
             AddStep("create leaderboard", () =>
             {
@@ -91,7 +91,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         public void TestUserQuit()
         {
             foreach (int user in users)
-                AddStep($"mark user {user} quit", () => Client.RemoveUser(LookupCache.GetUserAsync(user).WaitSafelyForResult().AsNonNull()));
+                AddStep($"mark user {user} quit", () => Client.RemoveUser(LookupCache.GetUserAsync(user).GetResultSafely().AsNonNull()));
         }
 
         [Test]
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboardTeams.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboardTeams.cs
index f5c079573d..1237a21e94 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboardTeams.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboardTeams.cs
@@ -48,7 +48,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             base.SetUpSteps();
 
-            AddStep("set local user", () => ((DummyAPIAccess)API).LocalUser.Value = LookupCache.GetUserAsync(1).WaitSafelyForResult());
+            AddStep("set local user", () => ((DummyAPIAccess)API).LocalUser.Value = LookupCache.GetUserAsync(1).GetResultSafely());
 
             AddStep("create leaderboard", () =>
             {
diff --git a/osu.Game.Tests/Visual/Navigation/TestScenePresentBeatmap.cs b/osu.Game.Tests/Visual/Navigation/TestScenePresentBeatmap.cs
index 9d495f7d05..6420e7b849 100644
--- a/osu.Game.Tests/Visual/Navigation/TestScenePresentBeatmap.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestScenePresentBeatmap.cs
@@ -127,7 +127,7 @@ namespace osu.Game.Tests.Visual.Navigation
                             Ruleset = ruleset ?? new OsuRuleset().RulesetInfo
                         },
                     }
-                }).WaitSafelyForResult().Value;
+                }).GetResultSafely().Value;
             });
 
             AddAssert($"import {i} succeeded", () => imported != null);
diff --git a/osu.Game.Tests/Visual/Navigation/TestScenePresentScore.cs b/osu.Game.Tests/Visual/Navigation/TestScenePresentScore.cs
index 16c416fedc..5dc1808c12 100644
--- a/osu.Game.Tests/Visual/Navigation/TestScenePresentScore.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestScenePresentScore.cs
@@ -58,7 +58,7 @@ namespace osu.Game.Tests.Visual.Navigation
                             Ruleset = new OsuRuleset().RulesetInfo
                         },
                     }
-                }).WaitSafelyForResult().Value;
+                }).GetResultSafely().Value;
             });
         }
 
@@ -132,7 +132,7 @@ namespace osu.Game.Tests.Visual.Navigation
                     OnlineID = i,
                     BeatmapInfo = beatmap.Beatmaps.First(),
                     Ruleset = ruleset ?? new OsuRuleset().RulesetInfo
-                }).WaitSafelyForResult().Value;
+                }).GetResultSafely().Value;
             });
 
             AddAssert($"import {i} succeeded", () => imported != null);
diff --git a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs
index 0c5985ad67..e59884f4f4 100644
--- a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs
+++ b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs
@@ -202,7 +202,7 @@ namespace osu.Game.Tests.Visual.Playlists
             });
         }
 
-        private void importBeatmap() => AddStep("import beatmap", () => importedBeatmap = manager.Import(CreateBeatmap(new OsuRuleset().RulesetInfo).BeatmapInfo.BeatmapSet).WaitSafelyForResult());
+        private void importBeatmap() => AddStep("import beatmap", () => importedBeatmap = manager.Import(CreateBeatmap(new OsuRuleset().RulesetInfo).BeatmapInfo.BeatmapSet).GetResultSafely());
 
         private class TestPlaylistsRoomSubScreen : PlaylistsRoomSubScreen
         {
diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapRecommendations.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapRecommendations.cs
index 071e3225f0..08b5802713 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapRecommendations.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapRecommendations.cs
@@ -182,7 +182,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                 beatmap.DifficultyName = $"SR{i + 1}";
             }
 
-            return Game.BeatmapManager.Import(beatmapSet).WaitSafelyForResult().Value;
+            return Game.BeatmapManager.Import(beatmapSet).GetResultSafely().Value;
         }
 
         private bool ensureAllBeatmapSetsImported(IEnumerable<BeatmapSetInfo> beatmapSets) => beatmapSets.All(set => set != null);
diff --git a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
index ea667d02f3..37f110e727 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
@@ -760,7 +760,7 @@ namespace osu.Game.Tests.Visual.SongSelect
             AddStep("import huge difficulty count map", () =>
             {
                 var usableRulesets = rulesets.AvailableRulesets.Where(r => r.OnlineID != 2).ToArray();
-                imported = manager.Import(TestResources.CreateTestBeatmapSetInfo(50, usableRulesets)).WaitSafelyForResult().Value;
+                imported = manager.Import(TestResources.CreateTestBeatmapSetInfo(50, usableRulesets)).GetResultSafely().Value;
             });
 
             AddStep("select the first beatmap of import", () => Beatmap.Value = manager.GetWorkingBeatmap(imported.Beatmaps.First()));
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
index bca396b46b..a436fc0bfa 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
@@ -86,7 +86,7 @@ namespace osu.Game.Tests.Visual.UserInterface
             dependencies.Cache(beatmapManager = new BeatmapManager(LocalStorage, ContextFactory, rulesetStore, null, dependencies.Get<AudioManager>(), Resources, dependencies.Get<GameHost>(), Beatmap.Default));
             dependencies.Cache(scoreManager = new ScoreManager(rulesetStore, () => beatmapManager, LocalStorage, ContextFactory, Scheduler));
 
-            beatmapInfo = beatmapManager.Import(new ImportTask(TestResources.GetQuickTestBeatmapForImport())).WaitSafelyForResult().Value.Beatmaps[0];
+            beatmapInfo = beatmapManager.Import(new ImportTask(TestResources.GetQuickTestBeatmapForImport())).GetResultSafely().Value.Beatmaps[0];
 
             for (int i = 0; i < 50; i++)
             {
@@ -102,7 +102,7 @@ namespace osu.Game.Tests.Visual.UserInterface
                     User = new APIUser { Username = "TestUser" },
                 };
 
-                importedScores.Add(scoreManager.Import(score).WaitSafelyForResult().Value);
+                importedScores.Add(scoreManager.Import(score).GetResultSafely().Value);
             }
 
             return dependencies;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneUpdateableBeatmapBackgroundSprite.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneUpdateableBeatmapBackgroundSprite.cs
index f78cbdffc1..6fe1ccc037 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneUpdateableBeatmapBackgroundSprite.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneUpdateableBeatmapBackgroundSprite.cs
@@ -32,7 +32,7 @@ namespace osu.Game.Tests.Visual.UserInterface
         {
             this.api = api;
 
-            testBeatmap = ImportBeatmapTest.LoadOszIntoOsu(osu).WaitSafelyForResult();
+            testBeatmap = ImportBeatmapTest.LoadOszIntoOsu(osu).GetResultSafely();
         }
 
         [Test]
diff --git a/osu.Game/Beatmaps/BeatmapDifficultyCache.cs b/osu.Game/Beatmaps/BeatmapDifficultyCache.cs
index 45dadc4e3f..f760c25170 100644
--- a/osu.Game/Beatmaps/BeatmapDifficultyCache.cs
+++ b/osu.Game/Beatmaps/BeatmapDifficultyCache.cs
@@ -270,7 +270,7 @@ namespace osu.Game.Beatmaps
                         if (cancellationToken.IsCancellationRequested)
                             return;
 
-                        var starDifficulty = task.GetCompletedResult();
+                        var starDifficulty = task.GetResultSafely();
 
                         if (starDifficulty != null)
                             bindable.Value = starDifficulty.Value;
diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index c461135266..ed7fe0bc91 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -92,7 +92,7 @@ namespace osu.Game.Beatmaps
                 }
             };
 
-            var imported = beatmapModelManager.Import(set).WaitSafelyForResult().Value;
+            var imported = beatmapModelManager.Import(set).GetResultSafely().Value;
 
             return GetWorkingBeatmap(imported.Beatmaps.First());
         }
diff --git a/osu.Game/Beatmaps/WorkingBeatmap.cs b/osu.Game/Beatmaps/WorkingBeatmap.cs
index 85e30b6e3d..8289b32d31 100644
--- a/osu.Game/Beatmaps/WorkingBeatmap.cs
+++ b/osu.Game/Beatmaps/WorkingBeatmap.cs
@@ -186,7 +186,7 @@ namespace osu.Game.Beatmaps
             {
                 try
                 {
-                    return loadBeatmapAsync().WaitSafelyForResult();
+                    return loadBeatmapAsync().GetResultSafely();
                 }
                 catch (AggregateException ae)
                 {
diff --git a/osu.Game/Database/OnlineLookupCache.cs b/osu.Game/Database/OnlineLookupCache.cs
index f5847428ee..2f98aef58a 100644
--- a/osu.Game/Database/OnlineLookupCache.cs
+++ b/osu.Game/Database/OnlineLookupCache.cs
@@ -59,7 +59,7 @@ namespace osu.Game.Database
                     if (!task.IsCompletedSuccessfully)
                         return null;
 
-                    return task.GetCompletedResult();
+                    return task.GetResultSafely();
                 }, token));
             }
 
diff --git a/osu.Game/Online/Chat/ChannelManager.cs b/osu.Game/Online/Chat/ChannelManager.cs
index 52d5fa1642..82e042ae4e 100644
--- a/osu.Game/Online/Chat/ChannelManager.cs
+++ b/osu.Game/Online/Chat/ChannelManager.cs
@@ -536,7 +536,7 @@ namespace osu.Game.Online.Chat
                     // Try to get user in order to open PM chat
                     users.GetUserAsync((int)lastClosedChannel.Id).ContinueWith(task =>
                     {
-                        var user = task.GetCompletedResult();
+                        var user = task.GetResultSafely();
 
                         if (user != null)
                             Schedule(() => CurrentChannel.Value = JoinChannel(new Channel(user)));
diff --git a/osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.cs b/osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.cs
index 0f25be2d3c..a40f29abf2 100644
--- a/osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.cs
+++ b/osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.cs
@@ -85,7 +85,7 @@ namespace osu.Game.Overlays.BeatmapSet.Scores
                                 if (loadCancellationSource.IsCancellationRequested)
                                     return;
 
-                                var scores = task.GetCompletedResult();
+                                var scores = task.GetResultSafely();
 
                                 var topScore = scores.First();
 
diff --git a/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs b/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs
index 73b199f159..fde20575fc 100644
--- a/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs
+++ b/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs
@@ -64,7 +64,7 @@ namespace osu.Game.Overlays.Dashboard
                     {
                         users.GetUserAsync(id).ContinueWith(task =>
                         {
-                            var user = task.GetCompletedResult();
+                            var user = task.GetResultSafely();
 
                             if (user == null) return;
 
diff --git a/osu.Game/Overlays/Settings/Sections/General/UpdateSettings.cs b/osu.Game/Overlays/Settings/Sections/General/UpdateSettings.cs
index 8dbae420ac..158d8811b5 100644
--- a/osu.Game/Overlays/Settings/Sections/General/UpdateSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/General/UpdateSettings.cs
@@ -48,7 +48,7 @@ namespace osu.Game.Overlays.Settings.Sections.General
                         checkForUpdatesButton.Enabled.Value = false;
                         Task.Run(updateManager.CheckForUpdateAsync).ContinueWith(task => Schedule(() =>
                         {
-                            if (!task.GetCompletedResult())
+                            if (!task.GetResultSafely())
                             {
                                 notifications?.Post(new SimpleNotification
                                 {
diff --git a/osu.Game/Scoring/ScoreManager.cs b/osu.Game/Scoring/ScoreManager.cs
index b4edb23689..39cd28cad2 100644
--- a/osu.Game/Scoring/ScoreManager.cs
+++ b/osu.Game/Scoring/ScoreManager.cs
@@ -113,7 +113,7 @@ namespace osu.Game.Scoring
         public void GetTotalScore([NotNull] ScoreInfo score, [NotNull] Action<long> callback, ScoringMode mode = ScoringMode.Standardised, CancellationToken cancellationToken = default)
         {
             GetTotalScoreAsync(score, mode, cancellationToken)
-                .ContinueWith(task => scheduler.Add(() => callback(task.GetCompletedResult())), TaskContinuationOptions.OnlyOnRanToCompletion);
+                .ContinueWith(task => scheduler.Add(() => callback(task.GetResultSafely())), TaskContinuationOptions.OnlyOnRanToCompletion);
         }
 
         /// <summary>
diff --git a/osu.Game/Screens/Menu/IntroScreen.cs b/osu.Game/Screens/Menu/IntroScreen.cs
index e7731631ff..948e3a7d88 100644
--- a/osu.Game/Screens/Menu/IntroScreen.cs
+++ b/osu.Game/Screens/Menu/IntroScreen.cs
@@ -111,7 +111,7 @@ namespace osu.Game.Screens.Menu
                 {
                     // if we detect that the theme track or beatmap is unavailable this is either first startup or things are in a bad state.
                     // this could happen if a user has nuked their files store. for now, reimport to repair this.
-                    var import = beatmaps.Import(new ZipArchiveReader(game.Resources.GetStream($"Tracks/{BeatmapFile}"), BeatmapFile)).WaitSafelyForResult();
+                    var import = beatmaps.Import(new ZipArchiveReader(game.Resources.GetStream($"Tracks/{BeatmapFile}"), BeatmapFile)).GetResultSafely();
 
                     import.PerformWrite(b =>
                     {
diff --git a/osu.Game/Screens/Play/HUD/MultiplayerGameplayLeaderboard.cs b/osu.Game/Screens/Play/HUD/MultiplayerGameplayLeaderboard.cs
index c384d97229..83c73e5a70 100644
--- a/osu.Game/Screens/Play/HUD/MultiplayerGameplayLeaderboard.cs
+++ b/osu.Game/Screens/Play/HUD/MultiplayerGameplayLeaderboard.cs
@@ -79,7 +79,7 @@ namespace osu.Game.Screens.Play.HUD
 
             userLookupCache.GetUsersAsync(playingUsers.Select(u => u.UserID).ToArray()).ContinueWith(task => Schedule(() =>
             {
-                var users = task.GetCompletedResult();
+                var users = task.GetResultSafely();
 
                 foreach (var user in users)
                 {
diff --git a/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs b/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs
index 897678640f..21a7698248 100644
--- a/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs
+++ b/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs
@@ -76,7 +76,7 @@ namespace osu.Game.Screens.Play.HUD
                 difficultyCache.GetTimedDifficultyAttributesAsync(gameplayWorkingBeatmap, gameplayState.Ruleset, clonedMods, loadCancellationSource.Token)
                                .ContinueWith(task => Schedule(() =>
                                {
-                                   timedAttributes = task.GetCompletedResult();
+                                   timedAttributes = task.GetResultSafely();
 
                                    IsValid = true;
 
diff --git a/osu.Game/Screens/Play/Player.cs b/osu.Game/Screens/Play/Player.cs
index 262424258a..2a6f5e2398 100644
--- a/osu.Game/Screens/Play/Player.cs
+++ b/osu.Game/Screens/Play/Player.cs
@@ -771,7 +771,7 @@ namespace osu.Game.Screens.Play
                     // This player instance may already be in the process of exiting.
                     return;
 
-                this.Push(CreateResults(prepareScoreForDisplayTask.WaitSafelyForResult()));
+                this.Push(CreateResults(prepareScoreForDisplayTask.GetResultSafely()));
             }, Time.Current + delay, 50);
 
             Scheduler.Add(resultsDisplayDelegate);
diff --git a/osu.Game/Screens/Ranking/Expanded/ExpandedPanelMiddleContent.cs b/osu.Game/Screens/Ranking/Expanded/ExpandedPanelMiddleContent.cs
index 87940c61aa..7e39708e65 100644
--- a/osu.Game/Screens/Ranking/Expanded/ExpandedPanelMiddleContent.cs
+++ b/osu.Game/Screens/Ranking/Expanded/ExpandedPanelMiddleContent.cs
@@ -80,7 +80,7 @@ namespace osu.Game.Screens.Ranking.Expanded
             statisticDisplays.AddRange(topStatistics);
             statisticDisplays.AddRange(bottomStatistics);
 
-            var starDifficulty = beatmapDifficultyCache.GetDifficultyAsync(beatmap, score.Ruleset, score.Mods).WaitSafelyForResult();
+            var starDifficulty = beatmapDifficultyCache.GetDifficultyAsync(beatmap, score.Ruleset, score.Mods).GetResultSafely();
 
             AddInternal(new FillFlowContainer
             {
diff --git a/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatistic.cs b/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatistic.cs
index 1d00043244..d6e4cfbe51 100644
--- a/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatistic.cs
+++ b/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatistic.cs
@@ -38,7 +38,7 @@ namespace osu.Game.Screens.Ranking.Expanded.Statistics
             else
             {
                 performanceCache.CalculatePerformanceAsync(score, cancellationTokenSource.Token)
-                                .ContinueWith(t => Schedule(() => setPerformanceValue(t.GetCompletedResult())), cancellationTokenSource.Token);
+                                .ContinueWith(t => Schedule(() => setPerformanceValue(t.GetResultSafely())), cancellationTokenSource.Token);
             }
         }
 
diff --git a/osu.Game/Screens/Select/Details/AdvancedStats.cs b/osu.Game/Screens/Select/Details/AdvancedStats.cs
index dacc8c11e1..354ee325d0 100644
--- a/osu.Game/Screens/Select/Details/AdvancedStats.cs
+++ b/osu.Game/Screens/Select/Details/AdvancedStats.cs
@@ -153,8 +153,8 @@ namespace osu.Game.Screens.Select.Details
 
             Task.WhenAll(normalStarDifficultyTask, moddedStarDifficultyTask).ContinueWith(_ => Schedule(() =>
             {
-                var normalDifficulty = normalStarDifficultyTask.GetCompletedResult();
-                var moddeDifficulty = moddedStarDifficultyTask.GetCompletedResult();
+                var normalDifficulty = normalStarDifficultyTask.GetResultSafely();
+                var moddeDifficulty = moddedStarDifficultyTask.GetResultSafely();
 
                 if (normalDifficulty == null || moddeDifficulty == null)
                     return;
diff --git a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
index fbfca130ba..0102986070 100644
--- a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
+++ b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
@@ -143,7 +143,7 @@ namespace osu.Game.Screens.Select.Leaderboards
                 }
 
                 scoreManager.OrderByTotalScoreAsync(scores.ToArray(), cancellationToken)
-                            .ContinueWith(task => scoresCallback?.Invoke(task.GetCompletedResult()), TaskContinuationOptions.OnlyOnRanToCompletion);
+                            .ContinueWith(task => scoresCallback?.Invoke(task.GetResultSafely()), TaskContinuationOptions.OnlyOnRanToCompletion);
 
                 return null;
             }
@@ -184,7 +184,7 @@ namespace osu.Game.Screens.Select.Leaderboards
                                 if (cancellationToken.IsCancellationRequested)
                                     return;
 
-                                scoresCallback?.Invoke(task.GetCompletedResult());
+                                scoresCallback?.Invoke(task.GetResultSafely());
                                 TopScore = r.UserScore?.CreateScoreInfo(rulesets, fetchBeatmapInfo);
                             }), TaskContinuationOptions.OnlyOnRanToCompletion);
             };
diff --git a/osu.Game/Screens/Spectate/SpectatorScreen.cs b/osu.Game/Screens/Spectate/SpectatorScreen.cs
index 44a31d89ed..c4e75cc413 100644
--- a/osu.Game/Screens/Spectate/SpectatorScreen.cs
+++ b/osu.Game/Screens/Spectate/SpectatorScreen.cs
@@ -60,7 +60,7 @@ namespace osu.Game.Screens.Spectate
 
             userLookupCache.GetUsersAsync(users.ToArray()).ContinueWith(task => Schedule(() =>
             {
-                var foundUsers = task.GetCompletedResult();
+                var foundUsers = task.GetResultSafely();
 
                 foreach (var u in foundUsers)
                 {
diff --git a/osu.Game/Skinning/SkinManager.cs b/osu.Game/Skinning/SkinManager.cs
index a55cc332c5..cde21b78c1 100644
--- a/osu.Game/Skinning/SkinManager.cs
+++ b/osu.Game/Skinning/SkinManager.cs
@@ -154,7 +154,7 @@ namespace osu.Game.Skinning
                     Name = s.Name + @" (modified)",
                     Creator = s.Creator,
                     InstantiationInfo = s.InstantiationInfo,
-                }).WaitSafelyForResult();
+                }).GetResultSafely();
 
                 if (result != null)
                 {
diff --git a/osu.Game/Tests/Beatmaps/BeatmapConversionTest.cs b/osu.Game/Tests/Beatmaps/BeatmapConversionTest.cs
index 589857b458..897d4363f1 100644
--- a/osu.Game/Tests/Beatmaps/BeatmapConversionTest.cs
+++ b/osu.Game/Tests/Beatmaps/BeatmapConversionTest.cs
@@ -148,7 +148,7 @@ namespace osu.Game.Tests.Beatmaps
             if (!conversionTask.Wait(10000))
                 Assert.Fail("Conversion timed out");
 
-            return conversionTask.GetCompletedResult();
+            return conversionTask.GetResultSafely();
         }
 
         protected virtual void OnConversionGenerated(HitObject original, IEnumerable<HitObject> result, IBeatmapConverter beatmapConverter)

From 690b425380cfb0c7e6bcb74066ccbf164fbc09da Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 6 Jan 2022 22:56:56 +0900
Subject: [PATCH 1941/5547] Move enum local to usage

---
 osu.Game/Overlays/ExpandingButtonContainer.cs | 7 ++++++-
 osu.Game/Overlays/Settings/SettingsSidebar.cs | 6 ------
 2 files changed, 6 insertions(+), 7 deletions(-)

diff --git a/osu.Game/Overlays/ExpandingButtonContainer.cs b/osu.Game/Overlays/ExpandingButtonContainer.cs
index a49f0493f6..5964f7f263 100644
--- a/osu.Game/Overlays/ExpandingButtonContainer.cs
+++ b/osu.Game/Overlays/ExpandingButtonContainer.cs
@@ -11,7 +11,6 @@ using osu.Framework.Testing;
 using osu.Framework.Threading;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.UserInterface;
-using osu.Game.Overlays.Settings;
 using osuTK;
 
 namespace osu.Game.Overlays
@@ -131,4 +130,10 @@ namespace osu.Game.Overlays
             lastHoveredButton = hoveredButton;
         }
     }
+
+    public enum ExpandedState
+    {
+        Contracted,
+        Expanded,
+    }
 }
diff --git a/osu.Game/Overlays/Settings/SettingsSidebar.cs b/osu.Game/Overlays/Settings/SettingsSidebar.cs
index 5aa2e61162..e6ce90c33e 100644
--- a/osu.Game/Overlays/Settings/SettingsSidebar.cs
+++ b/osu.Game/Overlays/Settings/SettingsSidebar.cs
@@ -28,10 +28,4 @@ namespace osu.Game.Overlays.Settings
             });
         }
     }
-
-    public enum ExpandedState
-    {
-        Contracted,
-        Expanded,
-    }
 }

From 5aca2dd4ce17a4d39375e6b6577490b7f67abe46 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 6 Jan 2022 23:08:50 +0900
Subject: [PATCH 1942/5547] Hide header text when it won't fit in the toolbox
 group

---
 osu.Game/Overlays/SettingsToolboxGroup.cs | 18 +++++++++++++++---
 1 file changed, 15 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Overlays/SettingsToolboxGroup.cs b/osu.Game/Overlays/SettingsToolboxGroup.cs
index 02b5bdc1e1..fcc7ff2504 100644
--- a/osu.Game/Overlays/SettingsToolboxGroup.cs
+++ b/osu.Game/Overlays/SettingsToolboxGroup.cs
@@ -2,11 +2,13 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using osu.Framework.Allocation;
+using osu.Framework.Extensions.EnumExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Input.Events;
+using osu.Framework.Layout;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.UserInterface;
@@ -53,6 +55,8 @@ namespace osu.Game.Overlays
 
         private Color4 expandedColour;
 
+        private readonly OsuSpriteText headerText;
+
         /// <summary>
         /// Create a new instance.
         /// </summary>
@@ -90,12 +94,10 @@ namespace osu.Game.Overlays
                             Height = header_height,
                             Children = new Drawable[]
                             {
-                                new OsuSpriteText
+                                headerText = new OsuSpriteText
                                 {
                                     Origin = Anchor.CentreLeft,
                                     Anchor = Anchor.CentreLeft,
-                                    RelativeSizeAxes = Axes.X,
-                                    Truncate = true,
                                     Text = title.ToUpperInvariant(),
                                     Font = OsuFont.GetFont(weight: FontWeight.Bold, size: 17),
                                     Padding = new MarginPadding { Left = 10, Right = 30 },
@@ -132,6 +134,16 @@ namespace osu.Game.Overlays
         private const float fade_duration = 800;
         private const float inactive_alpha = 0.5f;
 
+        protected override bool OnInvalidate(Invalidation invalidation, InvalidationSource source)
+        {
+            // These toolbox grouped may be contracted to only show icons.
+            // For now, let's hide the header to avoid text truncation weirdness in such cases.
+            if (invalidation.HasFlagFast(Invalidation.DrawSize))
+                headerText.FadeTo(headerText.DrawWidth < DrawWidth ? 1 : 0, 150, Easing.OutQuint);
+
+            return base.OnInvalidate(invalidation, source);
+        }
+
         protected override void LoadComplete()
         {
             base.LoadComplete();

From f703c5f03879f68a8996e7e30959f4cf0fa4f97f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 6 Jan 2022 23:38:54 +0900
Subject: [PATCH 1943/5547] Add comment and reduce how often `ChildrenOfType`
 is invoked in `ExpandingButtonContainer`

---
 osu.Game/Overlays/ExpandingButtonContainer.cs | 26 ++++++++++---------
 1 file changed, 14 insertions(+), 12 deletions(-)

diff --git a/osu.Game/Overlays/ExpandingButtonContainer.cs b/osu.Game/Overlays/ExpandingButtonContainer.cs
index 5964f7f263..4eb8c47a1f 100644
--- a/osu.Game/Overlays/ExpandingButtonContainer.cs
+++ b/osu.Game/Overlays/ExpandingButtonContainer.cs
@@ -65,7 +65,7 @@ namespace osu.Game.Overlays
         protected override void OnHoverLost(HoverLostEvent e)
         {
             expandEvent?.Cancel();
-            lastHoveredButton = null;
+            hoveredButton = null;
             State = ExpandedState.Contracted;
 
             base.OnHoverLost(e);
@@ -112,22 +112,24 @@ namespace osu.Game.Overlays
             }
         }
 
-        private Drawable lastHoveredButton;
-
-        private Drawable hoveredButton => FillFlow.ChildrenOfType<OsuButton>().FirstOrDefault(c => c.IsHovered);
+        private Drawable hoveredButton;
 
         private void queueExpandIfHovering()
         {
-            // only expand when we hover a different button.
-            if (lastHoveredButton == hoveredButton) return;
+            // if the same button is hovered, let the scheduled expand play out..
+            if (hoveredButton?.IsHovered == true)
+                return;
 
-            if (State != ExpandedState.Expanded)
-            {
-                expandEvent?.Cancel();
+            // ..otherwise check whether a new button is hovered, and if so, queue a new hover operation.
+
+            // usually we wouldn't use ChildrenOfType in implementations, but this is the simplest way
+            // to handle cases like the editor where the buttons may be nested within a child hierarchy.
+            hoveredButton = FillFlow.ChildrenOfType<OsuButton>().FirstOrDefault(c => c.IsHovered);
+
+            expandEvent?.Cancel();
+
+            if (hoveredButton?.IsHovered == true && State != ExpandedState.Expanded)
                 expandEvent = Scheduler.AddDelayed(() => State = ExpandedState.Expanded, 750);
-            }
-
-            lastHoveredButton = hoveredButton;
         }
     }
 

From b9d2a10530695421bf5eee2ddad792718624493d Mon Sep 17 00:00:00 2001
From: MaxOhn <ohn.m@hotmail.de>
Date: Thu, 6 Jan 2022 14:47:58 +0100
Subject: [PATCH 1944/5547] adjustable assist strength + dont update spinner &
 running slider

---
 osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs | 82 ++++---------------
 1 file changed, 16 insertions(+), 66 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs b/osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs
index f983ece71b..c7cabd7ab4 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs
@@ -11,6 +11,8 @@ using osu.Game.Rulesets.Osu.UI;
 using osuTK;
 using System.Linq;
 using osu.Game.Rulesets.Osu.Objects;
+using osu.Game.Configuration;
+using osu.Framework.Bindables;
 
 namespace osu.Game.Rulesets.Osu.Mods
 {
@@ -24,16 +26,16 @@ namespace osu.Game.Rulesets.Osu.Mods
         public override double ScoreMultiplier => 1;
         public override Type[] IncompatibleMods => new[] { typeof(OsuModAutopilot), typeof(OsuModWiggle), typeof(OsuModTransform), typeof(ModAutoplay) };
 
-        private const float spin_radius = 30;
-
-        private Vector2? prevCursorPos;
-        private OsuInputManager inputManager;
+        [SettingSource("Assist strength", "Change the distance notes should travel towards you.", 0)]
+        public BindableFloat AssistStrength { get; } = new BindableFloat(0.3f)
+        {
+            Precision = 0.05f,
+            MinValue = 0.0f,
+            MaxValue = 1.0f,
+        };
 
         public void ApplyToDrawableRuleset(DrawableRuleset<OsuHitObject> drawableRuleset)
         {
-            // Grab the input manager for future use
-            inputManager = (OsuInputManager)drawableRuleset.KeyBindingInputManager;
-
             // Hide judgment displays and follow points
             drawableRuleset.Playfield.DisplayJudgements.Value = false;
             (drawableRuleset.Playfield as OsuPlayfield)?.FollowPoints.Hide();
@@ -41,75 +43,23 @@ namespace osu.Game.Rulesets.Osu.Mods
 
         public void Update(Playfield playfield)
         {
-            var cursorPos = playfield.Cursor.ActiveCursor.DrawPosition;
+            Vector2 cursorPos = playfield.Cursor.ActiveCursor.DrawPosition;
             double currentTime = playfield.Clock.CurrentTime;
 
-            // Move all currently alive object to new destination
             foreach (var drawable in playfield.HitObjectContainer.AliveObjects.OfType<DrawableOsuHitObject>())
             {
                 var h = drawable.HitObject;
 
-                switch (drawable)
+                if (currentTime < h.StartTime && (drawable is DrawableHitCircle || drawable is DrawableSlider))
                 {
-                    case DrawableHitCircle circle:
+                    double timeMoving = currentTime - (h.StartTime - h.TimePreempt);
+                    float percentDoneMoving = (float)(timeMoving / h.TimePreempt);
+                    float percentDistLeft = Math.Clamp(AssistStrength.Value - percentDoneMoving + 0.1f, 0, 1);
 
-                        // 10ms earlier on the note to reduce chance of missing when clicking early / cursor moves fast
-                        circle.MoveTo(cursorPos, Math.Max(0, h.StartTime - currentTime - 10));
-                        // FIXME: some circles cause flash at original(?) position when clicked too early
-
-                        break;
-
-                    case DrawableSlider slider:
-
-                        // Move slider to cursor
-                        if (currentTime < h.StartTime)
-                        {
-                            slider.MoveTo(cursorPos, Math.Max(0, h.StartTime - currentTime - 10));
-                        }
-                        // Move slider so that sliderball stays on the cursor
-                        else
-                        {
-                            slider.HeadCircle.Hide(); // hide flash, triangles, ... so they don't move with slider
-                            slider.MoveTo(cursorPos - slider.Ball.DrawPosition);
-                            // FIXME: some sliders re-appearing at their original position for a single frame when they're done
-                        }
-
-                        break;
-
-                    case DrawableSpinner spinner:
-
-                        // Move spinner _next_ to cursor
-                        if (currentTime < h.StartTime)
-                        {
-                            spinner.MoveTo(cursorPos + new Vector2(0, -spin_radius), Math.Max(0, h.StartTime - currentTime - 10));
-                        }
-                        else
-                        {
-                            // Move spinner visually
-                            Vector2 delta = spin_radius * (spinner.Position - prevCursorPos ?? cursorPos).Normalized();
-                            const float angle = 3 * MathF.PI / 180; // radians per update, arbitrary value
-
-                            // Rotation matrix
-                            var targetPos = new Vector2(
-                                delta.X * MathF.Cos(angle) - delta.Y * MathF.Sin(angle) + cursorPos.X,
-                                delta.X * MathF.Sin(angle) + delta.Y * MathF.Cos(angle) + cursorPos.Y
-                            );
-
-                            spinner.MoveTo(targetPos);
-
-                            // Move spinner logically
-                            if (inputManager?.PressedActions.Any(x => x == OsuAction.LeftButton || x == OsuAction.RightButton) ?? false)
-                            {
-                                // Arbitrary value, might lead to some inconsistencies depending on clock rate, replay, ...
-                                spinner.RotationTracker.AddRotation(2 * MathF.PI);
-                            }
-                        }
-
-                        break;
+                    Vector2 targetPos = drawable.Position + percentDistLeft * (cursorPos - drawable.Position);
+                    drawable.MoveTo(targetPos, h.StartTime - currentTime);
                 }
             }
-
-            prevCursorPos = cursorPos;
         }
     }
 }

From 197ada1a8cf43c7fcb9db2fffa072e310be22b9e Mon Sep 17 00:00:00 2001
From: MaxOhn <ohn.m@hotmail.de>
Date: Thu, 6 Jan 2022 16:04:38 +0100
Subject: [PATCH 1945/5547] naive 10hz update

---
 osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs b/osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs
index c7cabd7ab4..89a385dbdc 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs
@@ -34,6 +34,8 @@ namespace osu.Game.Rulesets.Osu.Mods
             MaxValue = 1.0f,
         };
 
+        private DateTime? lastUpdate;
+
         public void ApplyToDrawableRuleset(DrawableRuleset<OsuHitObject> drawableRuleset)
         {
             // Hide judgment displays and follow points
@@ -43,6 +45,9 @@ namespace osu.Game.Rulesets.Osu.Mods
 
         public void Update(Playfield playfield)
         {
+            if (DateTime.Now - (lastUpdate ?? DateTime.MinValue) < TimeSpan.FromMilliseconds(100))
+                return;
+
             Vector2 cursorPos = playfield.Cursor.ActiveCursor.DrawPosition;
             double currentTime = playfield.Clock.CurrentTime;
 
@@ -60,6 +65,8 @@ namespace osu.Game.Rulesets.Osu.Mods
                     drawable.MoveTo(targetPos, h.StartTime - currentTime);
                 }
             }
+
+            lastUpdate = DateTime.Now;
         }
     }
 }

From b3230868cc88ca7ada83ea6c4c8f0542c333c569 Mon Sep 17 00:00:00 2001
From: MaxOhn <ohn.m@hotmail.de>
Date: Thu, 6 Jan 2022 16:31:30 +0100
Subject: [PATCH 1946/5547] use playfield clock

---
 osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs b/osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs
index 89a385dbdc..a383b533fd 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs
@@ -34,7 +34,7 @@ namespace osu.Game.Rulesets.Osu.Mods
             MaxValue = 1.0f,
         };
 
-        private DateTime? lastUpdate;
+        private double? lastUpdate;
 
         public void ApplyToDrawableRuleset(DrawableRuleset<OsuHitObject> drawableRuleset)
         {
@@ -45,11 +45,12 @@ namespace osu.Game.Rulesets.Osu.Mods
 
         public void Update(Playfield playfield)
         {
-            if (DateTime.Now - (lastUpdate ?? DateTime.MinValue) < TimeSpan.FromMilliseconds(100))
+            double currentTime = playfield.Clock.CurrentTime;
+
+            if (currentTime - (lastUpdate ?? double.MinValue) < 100)
                 return;
 
             Vector2 cursorPos = playfield.Cursor.ActiveCursor.DrawPosition;
-            double currentTime = playfield.Clock.CurrentTime;
 
             foreach (var drawable in playfield.HitObjectContainer.AliveObjects.OfType<DrawableOsuHitObject>())
             {
@@ -66,7 +67,7 @@ namespace osu.Game.Rulesets.Osu.Mods
                 }
             }
 
-            lastUpdate = DateTime.Now;
+            lastUpdate = currentTime;
         }
     }
 }

From e02863f7806e4ddeb49564aef48ac68bb537569b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 7 Jan 2022 01:24:30 +0900
Subject: [PATCH 1947/5547] Avoid accessing `DrawWidth` from invalidation

---
 osu.Game/Overlays/SettingsToolboxGroup.cs | 23 +++++++++++++++++------
 1 file changed, 17 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Overlays/SettingsToolboxGroup.cs b/osu.Game/Overlays/SettingsToolboxGroup.cs
index fcc7ff2504..ff8966d55f 100644
--- a/osu.Game/Overlays/SettingsToolboxGroup.cs
+++ b/osu.Game/Overlays/SettingsToolboxGroup.cs
@@ -2,6 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using osu.Framework.Allocation;
+using osu.Framework.Caching;
 using osu.Framework.Extensions.EnumExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
@@ -25,6 +26,11 @@ namespace osu.Game.Overlays
         private const int header_height = 30;
         private const int corner_radius = 5;
 
+        private const float fade_duration = 800;
+        private const float inactive_alpha = 0.5f;
+
+        private readonly Cached headerTextVisibilityCache = new Cached();
+
         private readonly FillFlowContainer content;
         private readonly IconButton button;
 
@@ -131,19 +137,24 @@ namespace osu.Game.Overlays
             };
         }
 
-        private const float fade_duration = 800;
-        private const float inactive_alpha = 0.5f;
-
         protected override bool OnInvalidate(Invalidation invalidation, InvalidationSource source)
         {
-            // These toolbox grouped may be contracted to only show icons.
-            // For now, let's hide the header to avoid text truncation weirdness in such cases.
             if (invalidation.HasFlagFast(Invalidation.DrawSize))
-                headerText.FadeTo(headerText.DrawWidth < DrawWidth ? 1 : 0, 150, Easing.OutQuint);
+                headerTextVisibilityCache.Invalidate();
 
             return base.OnInvalidate(invalidation, source);
         }
 
+        protected override void Update()
+        {
+            base.Update();
+
+            if (!headerTextVisibilityCache.IsValid)
+                // These toolbox grouped may be contracted to only show icons.
+                // For now, let's hide the header to avoid text truncation weirdness in such cases.
+                headerText.FadeTo(headerText.DrawWidth < DrawWidth ? 1 : 0, 150, Easing.OutQuint);
+        }
+
         protected override void LoadComplete()
         {
             base.LoadComplete();

From 8f744c99ee0647b5786ef971f08bc513d5d0ed6e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 6 Jan 2022 20:25:03 +0100
Subject: [PATCH 1948/5547] Fix settings toolbox toggle button starting in
 incorrect state

While displaying replays, the colour of the toolbox toggle button would
not match the actual state of the rest of the toolbox, i.e. both buttons
would be white, even though the "playback settings" section was expanded
and as such should have a yellow toggle button.

In the case of the replay player, the failure scenario was as follows:

1. `SettingsToolboxGroup` calls `updateExpanded()` in its BDL to update
   the initial state of the toolbox, including the toggle button
   colour, by adding a colour fade transform.

2. An ancestor of both the toolbox groups - `PlayerSettingsOverlay`,
   which is a `VisibilityContainer` - calls `FinishTransforms(true)` in
   its `LoadCompleteAsync()`, therefore instantly applying the colour
   from point (1) to the toggle button instantly.

3. However, `IconButton` inherits from `OsuAnimatedButton`. And
   `OsuAnimatedButton` changes its colour in `LoadComplete()`, therefore
   undoing the instant application from point (2).

This conjunction of circumstances is instrumental to reproducing the
bug, because if the `FinishTransforms(true)` call wasn't there, point
(3) wouldn't matter - the transform would get applied at some
indeterminate point in the future, ignoring the write from
`OsuAnimatedButton`.

As for the fix, move the `updateExpanded()` call in
`SettingsToolboxGroup` to `LoadComplete()` to avoid the above
unfortunate order. Applying initial visual state in `LoadComplete()` is
the idiomatic style of doing things these days anyhow.
---
 osu.Game/Overlays/SettingsToolboxGroup.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Overlays/SettingsToolboxGroup.cs b/osu.Game/Overlays/SettingsToolboxGroup.cs
index ff8966d55f..ca0980a9c9 100644
--- a/osu.Game/Overlays/SettingsToolboxGroup.cs
+++ b/osu.Game/Overlays/SettingsToolboxGroup.cs
@@ -158,7 +158,9 @@ namespace osu.Game.Overlays
         protected override void LoadComplete()
         {
             base.LoadComplete();
+
             this.Delay(600).FadeTo(inactive_alpha, fade_duration, Easing.OutQuint);
+            updateExpanded();
         }
 
         protected override bool OnHover(HoverEvent e)
@@ -177,8 +179,6 @@ namespace osu.Game.Overlays
         private void load(OsuColour colours)
         {
             expandedColour = colours.Yellow;
-
-            updateExpanded();
         }
 
         private void updateExpanded() => button.FadeColour(expanded ? expandedColour : Color4.White, 200, Easing.InOutQuint);

From b0d61a18b05424bdc5b39b248a36c5d139ad241c Mon Sep 17 00:00:00 2001
From: pikokr <parangee9706@gmail.com>
Date: Fri, 7 Jan 2022 15:57:30 +0900
Subject: [PATCH 1949/5547] Load keyBindingContainer once on LoadComplete() &
 make touch area height to const

---
 osu.Game.Rulesets.Mania/UI/Column.cs | 43 ++++++----------------------
 1 file changed, 9 insertions(+), 34 deletions(-)

diff --git a/osu.Game.Rulesets.Mania/UI/Column.cs b/osu.Game.Rulesets.Mania/UI/Column.cs
index 1e07c84d9f..cd5f3d2170 100644
--- a/osu.Game.Rulesets.Mania/UI/Column.cs
+++ b/osu.Game.Rulesets.Mania/UI/Column.cs
@@ -28,6 +28,7 @@ namespace osu.Game.Rulesets.Mania.UI
     {
         public const float COLUMN_WIDTH = 80;
         public const float SPECIAL_COLUMN_WIDTH = 70;
+        public const float TOUCH_AREA_HEIGHT = 100;
 
         /// <summary>
         /// The index of this column as part of the whole playfield.
@@ -44,60 +45,34 @@ namespace osu.Game.Rulesets.Mania.UI
 
         private readonly GameplaySampleTriggerSource sampleTriggerSource;
 
-        public class ColumnTouchInputArea : Container
+        public class ColumnTouchInputArea : Drawable
         {
-            private Column column => (Column)Parent;
-
-            private Container hintContainer;
-
             public ColumnTouchInputArea()
             {
                 RelativeSizeAxes = Axes.X;
                 Anchor = Anchor.BottomCentre;
                 Origin = Anchor.BottomCentre;
-                Height = 100;
-                InternalChild = hintContainer = new Container
-                {
-                    RelativeSizeAxes = Axes.Both,
-                    BorderColour = Color4.Red,
-                    BorderThickness = 5,
-                    Masking = true,
-                };
+                Height = TOUCH_AREA_HEIGHT;
             }
 
+            private Column column => (Column)Parent;
+
             protected override void LoadComplete()
             {
-                hintContainer.Delay(1000).FadeOutFromOne(500, Easing.OutSine);
+                keyBindingContainer = (ManiaInputManager.RulesetKeyBindingContainer)((ManiaInputManager)GetContainingInputManager()).KeyBindingContainer;
             }
 
             private ManiaInputManager.RulesetKeyBindingContainer keyBindingContainer { get; set; }
 
-            private ManiaInputManager.RulesetKeyBindingContainer getKeyBindingContainer()
-            {
-                return keyBindingContainer ??= (ManiaInputManager.RulesetKeyBindingContainer)((ManiaInputManager)GetContainingInputManager()).KeyBindingContainer;
-            }
-
             protected override bool OnTouchDown(TouchDownEvent e)
             {
-                getKeyBindingContainer().TriggerPressed(column.Action.Value);
-                return base.OnTouchDown(e);
-            }
-
-            protected override bool OnMouseDown(MouseDownEvent e)
-            {
-                getKeyBindingContainer().TriggerPressed(column.Action.Value);
-
-                return base.OnMouseDown(e);
-            }
-
-            protected override void OnMouseUp(MouseUpEvent e)
-            {
-                getKeyBindingContainer().TriggerReleased(column.Action.Value);
+                keyBindingContainer.TriggerPressed(column.Action.Value);
+                return false;
             }
 
             protected override void OnTouchUp(TouchUpEvent e)
             {
-                getKeyBindingContainer().TriggerReleased(column.Action.Value);
+                keyBindingContainer.TriggerReleased(column.Action.Value);
             }
         }
 

From 6a1e1d186f7294c869e76501b088f46cac4a3973 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 7 Jan 2022 17:29:09 +0900
Subject: [PATCH 1950/5547] Update framework

---
 osu.Android.props        | 2 +-
 osu.Game/osu.Game.csproj | 2 +-
 osu.iOS.props            | 4 ++--
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Android.props b/osu.Android.props
index 67a9cd41dd..3ec12089ad 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -52,7 +52,7 @@
   </ItemGroup>
   <ItemGroup>
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1215.0" />
-    <PackageReference Include="ppy.osu.Framework.Android" Version="2021.1227.0" />
+    <PackageReference Include="ppy.osu.Framework.Android" Version="2022.107.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
     <!-- Realm needs to be directly referenced in all Xamarin projects, as it will not pull in its transitive dependencies otherwise. -->
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index c7913cb71d..1b2b3318bd 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="10.7.1" />
-    <PackageReference Include="ppy.osu.Framework" Version="2021.1227.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2022.107.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1215.0" />
     <PackageReference Include="Sentry" Version="3.12.1" />
     <PackageReference Include="SharpCompress" Version="0.30.1" />
diff --git a/osu.iOS.props b/osu.iOS.props
index 63dc889e3c..833e0fbdb9 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -60,7 +60,7 @@
     <Reference Include="System.Net.Http" />
   </ItemGroup>
   <ItemGroup Label="Package References">
-    <PackageReference Include="ppy.osu.Framework.iOS" Version="2021.1227.0" />
+    <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.107.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1215.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net5.0 / net6.0) -->
@@ -83,7 +83,7 @@
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="2.2.6" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.Core" Version="2.2.6" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
-    <PackageReference Include="ppy.osu.Framework" Version="2021.1227.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2022.107.0" />
     <PackageReference Include="SharpCompress" Version="0.30.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
     <PackageReference Include="System.ComponentModel.Annotations" Version="5.0.0" />

From 2ef791069c67911d548c0da48886f32bd95b7634 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 7 Jan 2022 17:33:38 +0900
Subject: [PATCH 1951/5547] Fix typon on `AdvancedStats`

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

diff --git a/osu.Game/Screens/Select/Details/AdvancedStats.cs b/osu.Game/Screens/Select/Details/AdvancedStats.cs
index 354ee325d0..adaaa6425c 100644
--- a/osu.Game/Screens/Select/Details/AdvancedStats.cs
+++ b/osu.Game/Screens/Select/Details/AdvancedStats.cs
@@ -154,12 +154,12 @@ namespace osu.Game.Screens.Select.Details
             Task.WhenAll(normalStarDifficultyTask, moddedStarDifficultyTask).ContinueWith(_ => Schedule(() =>
             {
                 var normalDifficulty = normalStarDifficultyTask.GetResultSafely();
-                var moddeDifficulty = moddedStarDifficultyTask.GetResultSafely();
+                var moddedDifficulty = moddedStarDifficultyTask.GetResultSafely();
 
-                if (normalDifficulty == null || moddeDifficulty == null)
+                if (normalDifficulty == null || moddedDifficulty == null)
                     return;
 
-                starDifficulty.Value = ((float)normalDifficulty.Value.Stars, (float)moddeDifficulty.Value.Stars);
+                starDifficulty.Value = ((float)normalDifficulty.Value.Stars, (float)moddedDifficulty.Value.Stars);
             }), starDifficultyCancellationSource.Token, TaskContinuationOptions.OnlyOnRanToCompletion, TaskScheduler.Current);
         }
 

From 0698ef633038df18077b24da424fd30ed44f795b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 7 Jan 2022 17:36:29 +0900
Subject: [PATCH 1952/5547] Fix one missed rename

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

diff --git a/osu.Game/Screens/Ranking/ScorePanelList.cs b/osu.Game/Screens/Ranking/ScorePanelList.cs
index 5ae6b9d417..f8e9d08350 100644
--- a/osu.Game/Screens/Ranking/ScorePanelList.cs
+++ b/osu.Game/Screens/Ranking/ScorePanelList.cs
@@ -154,7 +154,7 @@ namespace osu.Game.Screens.Ranking
             scoreManager.GetTotalScoreAsync(score)
                         .ContinueWith(task => Schedule(() =>
                         {
-                            flow.SetLayoutPosition(trackingContainer, task.GetCompletedResult());
+                            flow.SetLayoutPosition(trackingContainer, task.GetResultSafely());
 
                             trackingContainer.Show();
 

From 12c3e56881d9dbc38ecec16c877397a8a7ea6a27 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 7 Jan 2022 19:01:05 +0900
Subject: [PATCH 1953/5547] Fix `IPCLocationTest` not waiting for load of
 component

As seen at
https://github.com/ppy/osu/runs/4731480384?check_suite_focus=true.
---
 osu.Game.Tournament.Tests/NonVisual/IPCLocationTest.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Tournament.Tests/NonVisual/IPCLocationTest.cs b/osu.Game.Tournament.Tests/NonVisual/IPCLocationTest.cs
index 952eb72bf4..03252e3be6 100644
--- a/osu.Game.Tournament.Tests/NonVisual/IPCLocationTest.cs
+++ b/osu.Game.Tournament.Tests/NonVisual/IPCLocationTest.cs
@@ -36,7 +36,7 @@ namespace osu.Game.Tournament.Tests.NonVisual
                     TournamentStorage storage = (TournamentStorage)osu.Dependencies.Get<Storage>();
                     FileBasedIPC ipc = null;
 
-                    WaitForOrAssert(() => (ipc = osu.Dependencies.Get<MatchIPCInfo>() as FileBasedIPC) != null, @"ipc could not be populated in a reasonable amount of time");
+                    WaitForOrAssert(() => (ipc = osu.Dependencies.Get<MatchIPCInfo>() as FileBasedIPC)?.IsLoaded == true, @"ipc could not be populated in a reasonable amount of time");
 
                     Assert.True(ipc.SetIPCLocation(testStableInstallDirectory));
                     Assert.True(storage.AllTournaments.Exists("stable.json"));

From 814b318a10fc584ae24bd3a4478724a3347502c1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 7 Jan 2022 14:00:22 +0100
Subject: [PATCH 1954/5547] Add test coverage of slider end snapping behaviour

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

diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderSnapping.cs b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderSnapping.cs
new file mode 100644
index 0000000000..4b4aedcff4
--- /dev/null
+++ b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderSnapping.cs
@@ -0,0 +1,183 @@
+// 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.Input.Events;
+using osu.Framework.Testing;
+using osu.Framework.Utils;
+using osu.Game.Beatmaps;
+using osu.Game.Beatmaps.ControlPoints;
+using osu.Game.Input.Bindings;
+using osu.Game.Rulesets.Objects;
+using osu.Game.Rulesets.Osu.Edit;
+using osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders.Components;
+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.Tests.Beatmaps;
+using osu.Game.Tests.Visual;
+using osuTK;
+using osuTK.Input;
+
+namespace osu.Game.Rulesets.Osu.Tests.Editor
+{
+    public class TestSceneSliderSnapping : EditorTestScene
+    {
+        private const double beat_length = 1000;
+
+        protected override Ruleset CreateEditorRuleset() => new OsuRuleset();
+
+        protected override IBeatmap CreateBeatmap(RulesetInfo ruleset)
+        {
+            var controlPointInfo = new ControlPointInfo();
+            controlPointInfo.Add(0, new TimingControlPoint { BeatLength = beat_length });
+            return new TestBeatmap(ruleset, false)
+            {
+                ControlPointInfo = controlPointInfo
+            };
+        }
+
+        private Slider slider;
+
+        public override void SetUpSteps()
+        {
+            base.SetUpSteps();
+
+            AddStep("add unsnapped slider", () => EditorBeatmap.Add(slider = new Slider
+            {
+                StartTime = 0,
+                Position = OsuPlayfield.BASE_SIZE / 5,
+                Path = new SliderPath
+                {
+                    ControlPoints =
+                    {
+                        new PathControlPoint(Vector2.Zero),
+                        new PathControlPoint(OsuPlayfield.BASE_SIZE * 3 / 5)
+                    }
+                }
+            }));
+            AddStep("set beat divisor to 1/1", () =>
+            {
+                var beatDivisor = (BindableBeatDivisor)Editor.Dependencies.Get(typeof(BindableBeatDivisor));
+                beatDivisor.Value = 1;
+            });
+        }
+
+        [Test]
+        public void TestMovingUnsnappedSliderNodesSnaps()
+        {
+            PathControlPointPiece sliderEnd = null;
+
+            assertSliderSnapped(false);
+
+            AddStep("select slider", () => EditorBeatmap.SelectedHitObjects.Add(slider));
+            AddStep("select slider end", () =>
+            {
+                sliderEnd = this.ChildrenOfType<PathControlPointPiece>().Single(piece => piece.ControlPoint.Position != Vector2.Zero);
+                InputManager.MoveMouseTo(sliderEnd.ScreenSpaceDrawQuad.Centre);
+            });
+            AddStep("move slider end", () =>
+            {
+                InputManager.PressButton(MouseButton.Left);
+                InputManager.MoveMouseTo(sliderEnd.ScreenSpaceDrawQuad.Centre - new Vector2(0, 20));
+                InputManager.ReleaseButton(MouseButton.Left);
+            });
+            assertSliderSnapped(true);
+        }
+
+        [Test]
+        public void TestResizingUnsnappedSliderSnaps()
+        {
+            SelectionBoxScaleHandle handle = null;
+
+            assertSliderSnapped(false);
+
+            AddStep("select slider", () => EditorBeatmap.SelectedHitObjects.Add(slider));
+            AddStep("move mouse to scale handle", () =>
+            {
+                handle = this.ChildrenOfType<SelectionBoxScaleHandle>().First();
+                InputManager.MoveMouseTo(handle.ScreenSpaceDrawQuad.Centre);
+            });
+            AddStep("scale slider", () =>
+            {
+                InputManager.PressButton(MouseButton.Left);
+                InputManager.MoveMouseTo(handle.ScreenSpaceDrawQuad.Centre + new Vector2(20, 20));
+                InputManager.ReleaseButton(MouseButton.Left);
+            });
+            assertSliderSnapped(true);
+        }
+
+        [Test]
+        public void TestRotatingUnsnappedSliderDoesNotSnap()
+        {
+            SelectionBoxRotationHandle handle = null;
+
+            assertSliderSnapped(false);
+
+            AddStep("select slider", () => EditorBeatmap.SelectedHitObjects.Add(slider));
+            AddStep("move mouse to rotate handle", () =>
+            {
+                handle = this.ChildrenOfType<SelectionBoxRotationHandle>().First();
+                InputManager.MoveMouseTo(handle.ScreenSpaceDrawQuad.Centre);
+            });
+            AddStep("scale slider", () =>
+            {
+                InputManager.PressButton(MouseButton.Left);
+                InputManager.MoveMouseTo(handle.ScreenSpaceDrawQuad.Centre + new Vector2(0, 20));
+                InputManager.ReleaseButton(MouseButton.Left);
+            });
+            assertSliderSnapped(false);
+        }
+
+        [Test]
+        public void TestFlippingSliderDoesNotSnap()
+        {
+            OsuSelectionHandler selectionHandler = null;
+
+            assertSliderSnapped(false);
+
+            AddStep("select slider", () => EditorBeatmap.SelectedHitObjects.Add(slider));
+            AddStep("flip slider horizontally", () =>
+            {
+                selectionHandler = this.ChildrenOfType<OsuSelectionHandler>().Single();
+                selectionHandler.OnPressed(new KeyBindingPressEvent<GlobalAction>(InputManager.CurrentState, GlobalAction.EditorFlipHorizontally));
+            });
+
+            assertSliderSnapped(false);
+
+            AddStep("flip slider vertically", () =>
+            {
+                selectionHandler = this.ChildrenOfType<OsuSelectionHandler>().Single();
+                selectionHandler.OnPressed(new KeyBindingPressEvent<GlobalAction>(InputManager.CurrentState, GlobalAction.EditorFlipVertically));
+            });
+
+            assertSliderSnapped(false);
+        }
+
+        [Test]
+        public void TestReversingSliderDoesNotSnap()
+        {
+            assertSliderSnapped(false);
+
+            AddStep("select slider", () => EditorBeatmap.SelectedHitObjects.Add(slider));
+            AddStep("reverse slider", () =>
+            {
+                InputManager.PressKey(Key.ControlLeft);
+                InputManager.Key(Key.G);
+                InputManager.ReleaseKey(Key.ControlLeft);
+            });
+
+            assertSliderSnapped(false);
+        }
+
+        private void assertSliderSnapped(bool snapped)
+            => AddAssert($"slider is {(snapped ? "" : "not ")}snapped", () =>
+            {
+                double durationInBeatLengths = slider.Duration / beat_length;
+                double fractionalPart = durationInBeatLengths - (int)durationInBeatLengths;
+                return Precision.AlmostEquals(fractionalPart, 0) == snapped;
+            });
+    }
+}

From d2f44813dd9aed366931123b3fca31a25673decb Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 7 Jan 2022 14:46:36 +0100
Subject: [PATCH 1955/5547] Add test coverage for slider snapping when
 adding/removing control points

---
 .../Editor/TestSceneSliderSnapping.cs         | 44 ++++++++++++++++++-
 1 file changed, 43 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderSnapping.cs b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderSnapping.cs
index 4b4aedcff4..b43b2b1461 100644
--- a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderSnapping.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderSnapping.cs
@@ -54,6 +54,7 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
                     ControlPoints =
                     {
                         new PathControlPoint(Vector2.Zero),
+                        new PathControlPoint(OsuPlayfield.BASE_SIZE * 2 / 5),
                         new PathControlPoint(OsuPlayfield.BASE_SIZE * 3 / 5)
                     }
                 }
@@ -75,7 +76,7 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
             AddStep("select slider", () => EditorBeatmap.SelectedHitObjects.Add(slider));
             AddStep("select slider end", () =>
             {
-                sliderEnd = this.ChildrenOfType<PathControlPointPiece>().Single(piece => piece.ControlPoint.Position != Vector2.Zero);
+                sliderEnd = this.ChildrenOfType<PathControlPointPiece>().Single(piece => piece.ControlPoint == slider.Path.ControlPoints.Last());
                 InputManager.MoveMouseTo(sliderEnd.ScreenSpaceDrawQuad.Centre);
             });
             AddStep("move slider end", () =>
@@ -87,6 +88,47 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
             assertSliderSnapped(true);
         }
 
+        [Test]
+        public void TestAddingControlPointToUnsnappedSliderNodesSnaps()
+        {
+            assertSliderSnapped(false);
+
+            AddStep("select slider", () => EditorBeatmap.SelectedHitObjects.Add(slider));
+            AddStep("move mouse to new point location", () =>
+            {
+                var firstPiece = this.ChildrenOfType<PathControlPointPiece>().Single(piece => piece.ControlPoint == slider.Path.ControlPoints[0]);
+                var secondPiece = this.ChildrenOfType<PathControlPointPiece>().Single(piece => piece.ControlPoint == slider.Path.ControlPoints[1]);
+                InputManager.MoveMouseTo((firstPiece.ScreenSpaceDrawQuad.Centre + secondPiece.ScreenSpaceDrawQuad.Centre) / 2);
+            });
+            AddStep("move slider end", () =>
+            {
+                InputManager.PressKey(Key.ControlLeft);
+                InputManager.Click(MouseButton.Left);
+                InputManager.ReleaseKey(Key.ControlLeft);
+            });
+            assertSliderSnapped(true);
+        }
+
+        [Test]
+        public void TestRemovingControlPointFromUnsnappedSliderNodesSnaps()
+        {
+            assertSliderSnapped(false);
+
+            AddStep("select slider", () => EditorBeatmap.SelectedHitObjects.Add(slider));
+            AddStep("move mouse to second control point", () =>
+            {
+                var secondPiece = this.ChildrenOfType<PathControlPointPiece>().Single(piece => piece.ControlPoint == slider.Path.ControlPoints[1]);
+                InputManager.MoveMouseTo(secondPiece);
+            });
+            AddStep("quick delete", () =>
+            {
+                InputManager.PressKey(Key.ShiftLeft);
+                InputManager.PressButton(MouseButton.Right);
+                InputManager.ReleaseKey(Key.ShiftLeft);
+            });
+            assertSliderSnapped(true);
+        }
+
         [Test]
         public void TestResizingUnsnappedSliderSnaps()
         {

From c09f6ee0522fa038d58810d010d02d8570e9f6bd Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 7 Jan 2022 15:11:38 +0100
Subject: [PATCH 1956/5547] Use slider snapping more liberally to match user
 expectations

Previously the slider path length would be snapped using the current
beat snap setting on *every* change of the slider path. As it turns out
this is unexpected behaviour in some situations (e.g. when reversing a
path, which is expected to preserve the previous duration, even though
the slider may be technically "unsnapped" at that point in time due to a
different beat snap setting being selected afterwards).
---
 .../Components/PathControlPointVisualiser.cs     |  5 +++++
 .../Sliders/SliderSelectionBlueprint.cs          | 15 +++++++--------
 .../Edit/OsuSelectionHandler.cs                  | 16 +++++++++++++++-
 .../Rulesets/Objects/SliderPathExtensions.cs     | 10 ++++++++++
 4 files changed, 37 insertions(+), 9 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 065d4737a5..ae4141073e 100644
--- a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointVisualiser.cs
+++ b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointVisualiser.cs
@@ -283,6 +283,9 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders.Components
                 }
             }
 
+            // Snap the path to the current beat divisor before checking length validity.
+            slider.SnapTo(snapProvider);
+
             if (!slider.Path.HasValidLength)
             {
                 for (int i = 0; i < slider.Path.ControlPoints.Count; i++)
@@ -290,6 +293,8 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders.Components
 
                 slider.Position = oldPosition;
                 slider.StartTime = oldStartTime;
+                // Snap the path length again to undo the invalid length.
+                slider.SnapTo(snapProvider);
                 return;
             }
 
diff --git a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/SliderSelectionBlueprint.cs b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/SliderSelectionBlueprint.cs
index 2aebe05c2f..6cf2a493a9 100644
--- a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/SliderSelectionBlueprint.cs
+++ b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/SliderSelectionBlueprint.cs
@@ -80,7 +80,7 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders
             controlPoints.BindTo(HitObject.Path.ControlPoints);
 
             pathVersion.BindTo(HitObject.Path.Version);
-            pathVersion.BindValueChanged(_ => updatePath());
+            pathVersion.BindValueChanged(_ => editorBeatmap?.Update(HitObject));
 
             BodyPiece.UpdateFrom(HitObject);
         }
@@ -208,6 +208,8 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders
             // Move the control points from the insertion index onwards to make room for the insertion
             controlPoints.Insert(insertionIndex, pathControlPoint);
 
+            HitObject.SnapTo(composer);
+
             return pathControlPoint;
         }
 
@@ -227,7 +229,10 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders
                 controlPoints.Remove(c);
             }
 
-            // If there are 0 or 1 remaining control points, the slider is in a degenerate (single point) form and should be deleted
+            // Snap the slider to the current beat divisor before checking length validity.
+            HitObject.SnapTo(composer);
+
+            // If there are 0 or 1 remaining control points, or the slider has an invalid length, it is in a degenerate form and should be deleted
             if (controlPoints.Count <= 1 || !HitObject.Path.HasValidLength)
             {
                 placementHandler?.Delete(HitObject);
@@ -242,12 +247,6 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders
             HitObject.Position += first;
         }
 
-        private void updatePath()
-        {
-            HitObject.Path.ExpectedDistance.Value = composer?.GetSnappedDistanceFromDistance(HitObject, (float)HitObject.Path.CalculatedDistance) ?? (float)HitObject.Path.CalculatedDistance;
-            editorBeatmap?.Update(HitObject);
-        }
-
         private void convertToStream()
         {
             if (editorBeatmap == null || changeHandler == null || beatDivisor == null)
diff --git a/osu.Game.Rulesets.Osu/Edit/OsuSelectionHandler.cs b/osu.Game.Rulesets.Osu/Edit/OsuSelectionHandler.cs
index 071ecf6329..efbac5439c 100644
--- a/osu.Game.Rulesets.Osu/Edit/OsuSelectionHandler.cs
+++ b/osu.Game.Rulesets.Osu/Edit/OsuSelectionHandler.cs
@@ -1,12 +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.
 
+#nullable enable
+
 using System.Collections.Generic;
 using System.Linq;
+using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Primitives;
 using osu.Framework.Utils;
 using osu.Game.Extensions;
+using osu.Game.Rulesets.Edit;
 using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Objects.Types;
 using osu.Game.Rulesets.Osu.Objects;
@@ -18,6 +22,9 @@ namespace osu.Game.Rulesets.Osu.Edit
 {
     public class OsuSelectionHandler : EditorSelectionHandler
     {
+        [Resolved(CanBeNull = true)]
+        private IPositionSnapProvider? positionSnapProvider { get; set; }
+
         /// <summary>
         /// During a transform, the initial origin is stored so it can be used throughout the operation.
         /// </summary>
@@ -27,7 +34,7 @@ namespace osu.Game.Rulesets.Osu.Edit
         /// 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;
+        private List<PathType?>? referencePathTypes;
 
         protected override void OnSelectionChanged()
         {
@@ -197,6 +204,10 @@ namespace osu.Game.Rulesets.Osu.Edit
             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(positionSnapProvider);
+
             //if sliderhead or sliderend end up outside playfield, revert scaling.
             Quad scaledQuad = getSurroundingQuad(new OsuHitObject[] { slider });
             (bool xInBounds, bool yInBounds) = isQuadInBounds(scaledQuad);
@@ -206,6 +217,9 @@ namespace osu.Game.Rulesets.Osu.Edit
 
             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(positionSnapProvider);
         }
 
         private void scaleHitObjects(OsuHitObject[] hitObjects, Anchor reference, Vector2 scale)
diff --git a/osu.Game/Rulesets/Objects/SliderPathExtensions.cs b/osu.Game/Rulesets/Objects/SliderPathExtensions.cs
index 1308fff7ae..ba614900c0 100644
--- a/osu.Game/Rulesets/Objects/SliderPathExtensions.cs
+++ b/osu.Game/Rulesets/Objects/SliderPathExtensions.cs
@@ -2,6 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System.Linq;
+using osu.Game.Rulesets.Edit;
 using osu.Game.Rulesets.Objects.Types;
 using osuTK;
 
@@ -11,6 +12,15 @@ namespace osu.Game.Rulesets.Objects
 {
     public static class SliderPathExtensions
     {
+        /// <summary>
+        /// Snaps the provided <paramref name="hitObject"/>'s duration using the <paramref name="snapProvider"/>.
+        /// </summary>
+        public static void SnapTo<THitObject>(this THitObject hitObject, IPositionSnapProvider? snapProvider)
+            where THitObject : HitObject, IHasPath
+        {
+            hitObject.Path.ExpectedDistance.Value = snapProvider?.GetSnappedDistanceFromDistance(hitObject, (float)hitObject.Path.CalculatedDistance) ?? hitObject.Path.CalculatedDistance;
+        }
+
         /// <summary>
         /// Reverse the direction of this path.
         /// </summary>

From 881fa2b86b17aa87119ce58d20fbc27011217c52 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 6 Jan 2022 14:49:56 +0100
Subject: [PATCH 1957/5547] Add basic test scene for scoreboard time

---
 .../Visual/Online/TestSceneScoreboardTime.cs  | 57 +++++++++++++++++++
 .../BeatmapSet/Scores/ScoreboardTime.cs       | 21 +++++++
 2 files changed, 78 insertions(+)
 create mode 100644 osu.Game.Tests/Visual/Online/TestSceneScoreboardTime.cs
 create mode 100644 osu.Game/Overlays/BeatmapSet/Scores/ScoreboardTime.cs

diff --git a/osu.Game.Tests/Visual/Online/TestSceneScoreboardTime.cs b/osu.Game.Tests/Visual/Online/TestSceneScoreboardTime.cs
new file mode 100644
index 0000000000..7e33b5240c
--- /dev/null
+++ b/osu.Game.Tests/Visual/Online/TestSceneScoreboardTime.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 System.Collections.Generic;
+using System.Linq;
+using NUnit.Framework;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
+using osu.Framework.Timing;
+using osu.Game.Overlays.BeatmapSet.Scores;
+
+namespace osu.Game.Tests.Visual.Online
+{
+    public class TestSceneScoreboardTime : OsuTestScene
+    {
+        private StopwatchClock stopwatch;
+
+        [Test]
+        public void TestVariousUnits()
+        {
+            AddStep("create various scoreboard times", () => Child = new FillFlowContainer
+            {
+                RelativeSizeAxes = Axes.X,
+                AutoSizeAxes = Axes.Y,
+                Anchor = Anchor.Centre,
+                Origin = Anchor.Centre,
+                Clock = new FramedClock(stopwatch = new StopwatchClock()), // prevent time from naturally elapsing.
+                Direction = FillDirection.Vertical,
+                ChildrenEnumerable = testCases.Select(dateTime => new ScoreboardTime(dateTime, 24).With(time => time.Anchor = time.Origin = Anchor.TopCentre))
+            });
+
+            AddStep("start stopwatch", () => stopwatch.Start());
+        }
+
+        private static IEnumerable<DateTimeOffset> testCases => new[]
+        {
+            DateTimeOffset.Now,
+            DateTimeOffset.Now.AddSeconds(-1),
+            DateTimeOffset.Now.AddSeconds(-25),
+            DateTimeOffset.Now.AddSeconds(-59),
+            DateTimeOffset.Now.AddMinutes(-1),
+            DateTimeOffset.Now.AddMinutes(-25),
+            DateTimeOffset.Now.AddMinutes(-59),
+            DateTimeOffset.Now.AddHours(-1),
+            DateTimeOffset.Now.AddHours(-13),
+            DateTimeOffset.Now.AddHours(-23),
+            DateTimeOffset.Now.AddDays(-1),
+            DateTimeOffset.Now.AddDays(-6),
+            DateTimeOffset.Now.AddDays(-16),
+            DateTimeOffset.Now.AddMonths(-1),
+            DateTimeOffset.Now.AddMonths(-11),
+            DateTimeOffset.Now.AddYears(-1),
+            DateTimeOffset.Now.AddYears(-5)
+        };
+    }
+}
diff --git a/osu.Game/Overlays/BeatmapSet/Scores/ScoreboardTime.cs b/osu.Game/Overlays/BeatmapSet/Scores/ScoreboardTime.cs
new file mode 100644
index 0000000000..db421ec6b7
--- /dev/null
+++ b/osu.Game/Overlays/BeatmapSet/Scores/ScoreboardTime.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;
+using osu.Game.Graphics;
+
+namespace osu.Game.Overlays.BeatmapSet.Scores
+{
+    public class ScoreboardTime : DrawableDate
+    {
+        public ScoreboardTime(DateTimeOffset date, float textSize = OsuFont.DEFAULT_FONT_SIZE, bool italic = true)
+            : base(date, textSize, italic)
+        {
+        }
+
+        protected override string Format()
+        {
+            return base.Format();
+        }
+    }
+}

From 87f7c7e6915757752a6b978cbf5ca859bc03368f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 6 Jan 2022 16:00:45 +0100
Subject: [PATCH 1958/5547] Implement scoreboard-specific time formatting

---
 .../BeatmapSet/Scores/ScoreboardTime.cs       | 37 ++++++++++++++++++-
 1 file changed, 36 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/BeatmapSet/Scores/ScoreboardTime.cs b/osu.Game/Overlays/BeatmapSet/Scores/ScoreboardTime.cs
index db421ec6b7..ff1d3490b4 100644
--- a/osu.Game/Overlays/BeatmapSet/Scores/ScoreboardTime.cs
+++ b/osu.Game/Overlays/BeatmapSet/Scores/ScoreboardTime.cs
@@ -2,7 +2,9 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
+using Humanizer;
 using osu.Game.Graphics;
+using osu.Game.Resources.Localisation.Web;
 
 namespace osu.Game.Overlays.BeatmapSet.Scores
 {
@@ -15,7 +17,40 @@ namespace osu.Game.Overlays.BeatmapSet.Scores
 
         protected override string Format()
         {
-            return base.Format();
+            var now = DateTime.Now;
+            var difference = now - Date;
+
+            // web uses momentjs's custom locales to format the date for the purposes of the scoreboard.
+            // this is intended to be a best-effort, more legible approximation of that.
+            // compare:
+            // * https://github.com/ppy/osu-web/blob/a8f5a68fb435cb19a4faa4c7c4bce08c4f096933/resources/assets/lib/scoreboard-time.tsx
+            // * https://momentjs.com/docs/#/customization/ (reference for the customisation format)
+
+            // TODO: support localisation (probably via `CommonStrings.CountHours()` etc.)
+            // requires pluralisable string support framework-side
+
+            if (difference.TotalHours < 1)
+                return CommonStrings.TimeNow.ToString();
+            if (difference.TotalDays < 1)
+                return "hr".ToQuantity((int)difference.TotalHours);
+
+            // this is where this gets more complicated because of how the calendar works.
+            // since there's no `TotalMonths` / `TotalYears`, we have to iteratively add months/years
+            // and test against cutoff dates to determine how many months/years to show.
+
+            if (Date > now.AddMonths(-1))
+                return difference.TotalDays < 2 ? "1dy" : $"{(int)difference.TotalDays}dys";
+
+            for (int months = 1; months <= 11; ++months)
+            {
+                if (Date > now.AddMonths(-(months + 1)))
+                    return months == 1 ? "1mo" : $"{months}mos";
+            }
+
+            int years = 1;
+            while (Date <= now.AddYears(-(years + 1)))
+                years += 1;
+            return years == 1 ? "1yr" : $"{years}yrs";
         }
     }
 }

From 9e84e31eacd3008ae518fee266de58007eb46357 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 6 Jan 2022 16:14:26 +0100
Subject: [PATCH 1959/5547] Add score time to beatmap set overlay scoreboard
 table

---
 osu.Game/Overlays/BeatmapSet/Scores/ScoreTable.cs | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/osu.Game/Overlays/BeatmapSet/Scores/ScoreTable.cs b/osu.Game/Overlays/BeatmapSet/Scores/ScoreTable.cs
index 018faf2011..2c78fa264e 100644
--- a/osu.Game/Overlays/BeatmapSet/Scores/ScoreTable.cs
+++ b/osu.Game/Overlays/BeatmapSet/Scores/ScoreTable.cs
@@ -128,6 +128,7 @@ namespace osu.Game.Overlays.BeatmapSet.Scores
             if (showPerformancePoints)
                 columns.Add(new TableColumn(BeatmapsetsStrings.ShowScoreboardHeaderspp, Anchor.CentreLeft, new Dimension(GridSizeMode.Absolute, 30)));
 
+            columns.Add(new TableColumn(BeatmapsetsStrings.ShowScoreboardHeadersTime, Anchor.CentreLeft, new Dimension(GridSizeMode.AutoSize)));
             columns.Add(new TableColumn(BeatmapsetsStrings.ShowScoreboardHeadersMods, Anchor.CentreLeft, new Dimension(GridSizeMode.AutoSize)));
 
             return columns.ToArray();
@@ -202,6 +203,11 @@ namespace osu.Game.Overlays.BeatmapSet.Scores
                 });
             }
 
+            content.Add(new ScoreboardTime(score.Date, text_size)
+            {
+                Margin = new MarginPadding { Right = 10 }
+            });
+
             content.Add(new FillFlowContainer
             {
                 Direction = FillDirection.Horizontal,

From f6f24220c2a0b9799d4eac60400ac3659ac400c5 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 8 Jan 2022 15:28:11 +0900
Subject: [PATCH 1960/5547] Fix `LegacyScoreDecoderTest` incorrectly comparing
 unset beatmap IDs

This has been wrong from the outside, but hidden by the fact that the
default values are equal. I've changed to MD5Hash which actually asserts
that the correct beatmap has likely arrived.

Found this in my realm changes, where it fails due to the beatmap ID
being a differing Guid in each case.
---
 osu.Game.Tests/Beatmaps/Formats/LegacyScoreDecoderTest.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Beatmaps/Formats/LegacyScoreDecoderTest.cs b/osu.Game.Tests/Beatmaps/Formats/LegacyScoreDecoderTest.cs
index 81d89359e0..b886a61c0f 100644
--- a/osu.Game.Tests/Beatmaps/Formats/LegacyScoreDecoderTest.cs
+++ b/osu.Game.Tests/Beatmaps/Formats/LegacyScoreDecoderTest.cs
@@ -95,7 +95,7 @@ namespace osu.Game.Tests.Beatmaps.Formats
                 Assert.That(decodedAfterEncode, Is.Not.Null);
 
                 Assert.That(decodedAfterEncode.ScoreInfo.User.Username, Is.EqualTo(scoreInfo.User.Username));
-                Assert.That(decodedAfterEncode.ScoreInfo.BeatmapInfoID, Is.EqualTo(scoreInfo.BeatmapInfoID));
+                Assert.That(decodedAfterEncode.ScoreInfo.BeatmapInfo.MD5Hash, Is.EqualTo(scoreInfo.BeatmapInfo.MD5Hash));
                 Assert.That(decodedAfterEncode.ScoreInfo.Ruleset, Is.EqualTo(scoreInfo.Ruleset));
                 Assert.That(decodedAfterEncode.ScoreInfo.TotalScore, Is.EqualTo(scoreInfo.TotalScore));
                 Assert.That(decodedAfterEncode.ScoreInfo.MaxCombo, Is.EqualTo(scoreInfo.MaxCombo));

From f026973b19316c828696f0e34a4cd8230215b741 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 8 Jan 2022 14:16:05 +0100
Subject: [PATCH 1961/5547] Add failing test for ruleset incorrectly applying
 from latest picked item

---
 .../TestSceneAllPlayersQueueMode.cs           | 33 ++++++++++++++++++-
 1 file changed, 32 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneAllPlayersQueueMode.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneAllPlayersQueueMode.cs
index a5744f9986..a06bf44d88 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneAllPlayersQueueMode.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneAllPlayersQueueMode.cs
@@ -1,13 +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.
 
+#nullable enable
+
 using System;
 using System.Linq;
 using NUnit.Framework;
+using osu.Framework.Screens;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
 using osu.Game.Online.Multiplayer;
+using osu.Game.Rulesets;
+using osu.Game.Rulesets.Catch;
+using osu.Game.Rulesets.Osu;
 using osu.Game.Screens.OnlinePlay.Multiplayer;
+using osu.Game.Screens.OnlinePlay.Multiplayer.Match;
+using osu.Game.Screens.Play;
 using osuTK.Input;
 
 namespace osu.Game.Tests.Visual.Multiplayer
@@ -83,7 +91,24 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddUntilStep("selected beatmap is initial beatmap", () => Beatmap.Value.BeatmapInfo.OnlineID == InitialBeatmap.OnlineID);
         }
 
-        private void addItem(Func<BeatmapInfo> beatmap)
+        [Test]
+        public void TestCorrectRulesetSelectedAfterNewItemAdded()
+        {
+            addItem(() => OtherBeatmap, new CatchRuleset().RulesetInfo);
+            AddUntilStep("selected beatmap is initial beatmap", () => Beatmap.Value.BeatmapInfo.OnlineID == InitialBeatmap.OnlineID);
+
+            AddUntilStep("wait for idle", () => Client.LocalUser?.State == MultiplayerUserState.Idle);
+            ClickButtonWhenEnabled<MultiplayerReadyButton>();
+
+            AddUntilStep("wait for ready", () => Client.LocalUser?.State == MultiplayerUserState.Ready);
+            ClickButtonWhenEnabled<MultiplayerReadyButton>();
+
+            AddUntilStep("wait for player", () => CurrentScreen is Player player && player.IsLoaded);
+            AddAssert("ruleset is correct", () => ((Player)CurrentScreen).Ruleset.Value.Equals(new OsuRuleset().RulesetInfo));
+            AddStep("exit player", () => CurrentScreen.Exit());
+        }
+
+        private void addItem(Func<BeatmapInfo> beatmap, RulesetInfo? ruleset = null)
         {
             AddStep("click add button", () =>
             {
@@ -92,6 +117,12 @@ namespace osu.Game.Tests.Visual.Multiplayer
             });
 
             AddUntilStep("wait for song select", () => CurrentSubScreen is Screens.Select.SongSelect select && select.BeatmapSetsLoaded);
+
+            if (ruleset != null)
+            {
+                AddStep($"set {ruleset.Name} ruleset", () => ((Screens.Select.SongSelect)CurrentSubScreen).Ruleset.Value = ruleset);
+            }
+
             AddStep("select other beatmap", () => ((Screens.Select.SongSelect)CurrentSubScreen).FinaliseSelection(beatmap()));
             AddUntilStep("wait for return to match", () => CurrentSubScreen is MultiplayerMatchSubScreen);
         }

From 50077f05bdb07468a93a0ba844b1ea00ec1823d9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 8 Jan 2022 14:39:22 +0100
Subject: [PATCH 1962/5547] Add test coverage for correct revert of ruleset
 when play starts at song select

---
 .../Multiplayer/TestSceneMultiplayer.cs       | 40 +++++++++++++++++++
 1 file changed, 40 insertions(+)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
index 4eebda94e9..1221a9f080 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
@@ -22,6 +22,7 @@ using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Rooms;
 using osu.Game.Overlays.Mods;
 using osu.Game.Rulesets;
+using osu.Game.Rulesets.Catch;
 using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Osu.Mods;
 using osu.Game.Screens.OnlinePlay.Components;
@@ -438,6 +439,45 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddAssert("Beatmap matches current item", () => Beatmap.Value.BeatmapInfo.OnlineID == client.Room?.Playlist.First().BeatmapID);
         }
 
+        [Test]
+        public void TestPlayStartsWithCorrectRulesetWhileAtSongSelect()
+        {
+            createRoom(() => new Room
+            {
+                Name = { Value = "Test Room" },
+                Playlist =
+                {
+                    new PlaylistItem
+                    {
+                        Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.RulesetID == 0)).BeatmapInfo },
+                        Ruleset = { Value = new OsuRuleset().RulesetInfo },
+                    }
+                }
+            });
+
+            pressReadyButton();
+
+            AddStep("Enter song select", () =>
+            {
+                var currentSubScreen = ((Screens.OnlinePlay.Multiplayer.Multiplayer)multiplayerComponents.CurrentScreen).CurrentSubScreen;
+                ((MultiplayerMatchSubScreen)currentSubScreen).OpenSongSelection(client.Room?.Settings.PlaylistItemId);
+            });
+
+            AddUntilStep("wait for song select", () => this.ChildrenOfType<MultiplayerMatchSongSelect>().FirstOrDefault()?.BeatmapSetsLoaded == true);
+
+            AddAssert("Ruleset matches current item", () => Ruleset.Value.OnlineID == client.Room?.Playlist.First().RulesetID);
+
+            AddStep("Switch ruleset", () => ((MultiplayerMatchSongSelect)multiplayerComponents.MultiplayerScreen.CurrentSubScreen).Ruleset.Value = new CatchRuleset().RulesetInfo);
+
+            AddUntilStep("Ruleset doesn't match current item", () => Ruleset.Value.OnlineID != client.Room?.Playlist.First().RulesetID);
+
+            AddStep("start match externally", () => client.StartMatch());
+
+            AddUntilStep("play started", () => multiplayerComponents.CurrentScreen is Player);
+
+            AddAssert("Ruleset matches current item", () => Ruleset.Value.OnlineID == client.Room?.Playlist.First().RulesetID);
+        }
+
         [Test]
         public void TestLocalPlayDoesNotStartWhileSpectatingWithNoBeatmap()
         {

From 3dd5705a810d8f1f68e3bf8c9accb5cda865d6f2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 8 Jan 2022 14:46:41 +0100
Subject: [PATCH 1963/5547] Add test coverage for correct revert of mods after
 new item is queued

---
 .../TestSceneAllPlayersQueueMode.cs           | 37 ++++++++++++++++---
 1 file changed, 31 insertions(+), 6 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneAllPlayersQueueMode.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneAllPlayersQueueMode.cs
index a06bf44d88..ad60ac824d 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneAllPlayersQueueMode.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneAllPlayersQueueMode.cs
@@ -4,15 +4,19 @@
 #nullable enable
 
 using System;
+using System.Collections.Generic;
 using System.Linq;
 using NUnit.Framework;
+using osu.Framework.Extensions.ObjectExtensions;
 using osu.Framework.Screens;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Catch;
+using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Osu;
+using osu.Game.Rulesets.Osu.Mods;
 using osu.Game.Screens.OnlinePlay.Multiplayer;
 using osu.Game.Screens.OnlinePlay.Multiplayer.Match;
 using osu.Game.Screens.Play;
@@ -108,22 +112,43 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddStep("exit player", () => CurrentScreen.Exit());
         }
 
-        private void addItem(Func<BeatmapInfo> beatmap, RulesetInfo? ruleset = null)
+        [Test]
+        public void TestCorrectModsSelectedAfterNewItemAdded()
         {
+            addItem(() => OtherBeatmap, mods: new Mod[] { new OsuModDoubleTime() });
+            AddUntilStep("selected beatmap is initial beatmap", () => Beatmap.Value.BeatmapInfo.OnlineID == InitialBeatmap.OnlineID);
+
+            AddUntilStep("wait for idle", () => Client.LocalUser?.State == MultiplayerUserState.Idle);
+            ClickButtonWhenEnabled<MultiplayerReadyButton>();
+
+            AddUntilStep("wait for ready", () => Client.LocalUser?.State == MultiplayerUserState.Ready);
+            ClickButtonWhenEnabled<MultiplayerReadyButton>();
+
+            AddUntilStep("wait for player", () => CurrentScreen is Player player && player.IsLoaded);
+            AddAssert("mods are correct", () => !((Player)CurrentScreen).Mods.Value.Any());
+            AddStep("exit player", () => CurrentScreen.Exit());
+        }
+
+        private void addItem(Func<BeatmapInfo> beatmap, RulesetInfo? ruleset = null, IReadOnlyList<Mod>? mods = null)
+        {
+            Screens.Select.SongSelect? songSelect = null;
+
             AddStep("click add button", () =>
             {
                 InputManager.MoveMouseTo(this.ChildrenOfType<MultiplayerMatchSubScreen.AddItemButton>().Single());
                 InputManager.Click(MouseButton.Left);
             });
 
-            AddUntilStep("wait for song select", () => CurrentSubScreen is Screens.Select.SongSelect select && select.BeatmapSetsLoaded);
+            AddUntilStep("wait for song select", () => (songSelect = CurrentSubScreen as Screens.Select.SongSelect) != null);
+            AddUntilStep("wait for loaded", () => songSelect.AsNonNull().BeatmapSetsLoaded);
 
             if (ruleset != null)
-            {
-                AddStep($"set {ruleset.Name} ruleset", () => ((Screens.Select.SongSelect)CurrentSubScreen).Ruleset.Value = ruleset);
-            }
+                AddStep($"set {ruleset.Name} ruleset", () => songSelect.AsNonNull().Ruleset.Value = ruleset);
 
-            AddStep("select other beatmap", () => ((Screens.Select.SongSelect)CurrentSubScreen).FinaliseSelection(beatmap()));
+            if (mods != null)
+                AddStep($"set mods to {string.Join(",", mods.Select(m => m.Acronym))}", () => songSelect.AsNonNull().Mods.Value = mods);
+
+            AddStep("select other beatmap", () => songSelect.AsNonNull().FinaliseSelection(beatmap()));
             AddUntilStep("wait for return to match", () => CurrentSubScreen is MultiplayerMatchSubScreen);
         }
     }

From 446962446ea3e8970a2da3712d1ceca493396d6e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 8 Jan 2022 14:50:49 +0100
Subject: [PATCH 1964/5547] Add test coverage for correct revert of mods when
 play starts at song select

---
 .../Multiplayer/TestSceneMultiplayer.cs       | 41 +++++++++++++++++++
 1 file changed, 41 insertions(+)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
index 1221a9f080..43f9b6636a 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
@@ -7,6 +7,7 @@ using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
+using osu.Framework.Extensions.ObjectExtensions;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.UserInterface;
 using osu.Framework.Input;
@@ -23,6 +24,7 @@ using osu.Game.Online.Rooms;
 using osu.Game.Overlays.Mods;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Catch;
+using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Osu.Mods;
 using osu.Game.Screens.OnlinePlay.Components;
@@ -478,6 +480,45 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddAssert("Ruleset matches current item", () => Ruleset.Value.OnlineID == client.Room?.Playlist.First().RulesetID);
         }
 
+        [Test]
+        public void TestPlayStartsWithCorrectModsWhileAtSongSelect()
+        {
+            createRoom(() => new Room
+            {
+                Name = { Value = "Test Room" },
+                Playlist =
+                {
+                    new PlaylistItem
+                    {
+                        Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.RulesetID == 0)).BeatmapInfo },
+                        Ruleset = { Value = new OsuRuleset().RulesetInfo },
+                    }
+                }
+            });
+
+            pressReadyButton();
+
+            AddStep("Enter song select", () =>
+            {
+                var currentSubScreen = ((Screens.OnlinePlay.Multiplayer.Multiplayer)multiplayerComponents.CurrentScreen).CurrentSubScreen;
+                ((MultiplayerMatchSubScreen)currentSubScreen).OpenSongSelection(client.Room?.Settings.PlaylistItemId);
+            });
+
+            AddUntilStep("wait for song select", () => this.ChildrenOfType<MultiplayerMatchSongSelect>().FirstOrDefault()?.BeatmapSetsLoaded == true);
+
+            AddAssert("Mods match current item", () => SelectedMods.Value.Select(m => m.Acronym).SequenceEqual(client.Room.AsNonNull().Playlist.First().RequiredMods.Select(m => m.Acronym)));
+
+            AddStep("Switch required mods", () => ((MultiplayerMatchSongSelect)multiplayerComponents.MultiplayerScreen.CurrentSubScreen).Mods.Value = new Mod[] { new OsuModDoubleTime() });
+
+            AddAssert("Mods don't match current item", () => !SelectedMods.Value.Select(m => m.Acronym).SequenceEqual(client.Room.AsNonNull().Playlist.First().RequiredMods.Select(m => m.Acronym)));
+
+            AddStep("start match externally", () => client.StartMatch());
+
+            AddUntilStep("play started", () => multiplayerComponents.CurrentScreen is Player);
+
+            AddAssert("Mods match current item", () => SelectedMods.Value.Select(m => m.Acronym).SequenceEqual(client.Room.AsNonNull().Playlist.First().RequiredMods.Select(m => m.Acronym)));
+        }
+
         [Test]
         public void TestLocalPlayDoesNotStartWhileSpectatingWithNoBeatmap()
         {

From c5ac996e3f73ee45ee07a21e1de04fe550c5f966 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 8 Jan 2022 14:55:40 +0100
Subject: [PATCH 1965/5547] Restore ruleset using current playlist item on
 resuming room sub screen

Ensures that the ruleset selected at the multiplayer song selection
screen does not overwrite the current playlist item's ruleset.
---
 osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs | 12 ++++++++++--
 1 file changed, 10 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs b/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
index a0e7e8de87..c31239616c 100644
--- a/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
@@ -300,6 +300,7 @@ namespace osu.Game.Screens.OnlinePlay.Match
             updateWorkingBeatmap();
             beginHandlingTrack();
             Scheduler.AddOnce(UpdateMods);
+            Scheduler.AddOnce(updateRuleset);
         }
 
         public override bool OnExiting(IScreen next)
@@ -353,8 +354,7 @@ namespace osu.Game.Screens.OnlinePlay.Match
                                      .ToList();
 
             UpdateMods();
-
-            Ruleset.Value = rulesets.GetRuleset(selected.RulesetID);
+            updateRuleset();
 
             if (!selected.AllowedMods.Any())
             {
@@ -387,6 +387,14 @@ namespace osu.Game.Screens.OnlinePlay.Match
             Mods.Value = UserMods.Value.Concat(SelectedItem.Value.RequiredMods).ToList();
         }
 
+        private void updateRuleset()
+        {
+            if (SelectedItem.Value == null || !this.IsCurrentScreen())
+                return;
+
+            Ruleset.Value = rulesets.GetRuleset(SelectedItem.Value.RulesetID);
+        }
+
         private void beginHandlingTrack()
         {
             Beatmap.BindValueChanged(applyLoopingToTrack, true);

From 9370e8446047af81f1fa1ae3cec83456462d923d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 8 Jan 2022 16:12:52 +0100
Subject: [PATCH 1966/5547] Fix effect point multiplier text box displaying too
 much decimal digits

---
 osu.Game/Screens/Edit/Timing/SliderWithTextBoxInput.cs | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Edit/Timing/SliderWithTextBoxInput.cs b/osu.Game/Screens/Edit/Timing/SliderWithTextBoxInput.cs
index 8738d36bf4..67f1dacec4 100644
--- a/osu.Game/Screens/Edit/Timing/SliderWithTextBoxInput.cs
+++ b/osu.Game/Screens/Edit/Timing/SliderWithTextBoxInput.cs
@@ -2,6 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
+using System.Globalization;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
@@ -9,6 +10,7 @@ using osu.Framework.Graphics.UserInterface;
 using osu.Framework.Localisation;
 using osu.Game.Graphics.UserInterfaceV2;
 using osu.Game.Overlays.Settings;
+using osu.Game.Utils;
 
 namespace osu.Game.Screens.Edit.Timing
 {
@@ -66,7 +68,8 @@ namespace osu.Game.Screens.Edit.Timing
 
             Current.BindValueChanged(val =>
             {
-                textBox.Text = val.NewValue.ToString();
+                decimal decimalValue = slider.Current.Value.ToDecimal(NumberFormatInfo.InvariantInfo);
+                textBox.Text = decimalValue.ToString($@"N{FormatUtils.FindPrecision(decimalValue)}");
             }, true);
         }
 

From 24d377fddb18f60bb72c3da0aca6ae449ffccb7e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 8 Jan 2022 17:19:52 +0100
Subject: [PATCH 1967/5547] Move implementation of drag handle operations to
 concrete classes

---
 .../Edit/Compose/Components/SelectionBox.cs   |  5 +++--
 .../Components/SelectionBoxDragHandle.cs      |  8 -------
 .../Components/SelectionBoxRotationHandle.cs  | 22 +++++++++++++++++++
 .../Components/SelectionBoxScaleHandle.cs     | 11 ++++++++++
 4 files changed, 36 insertions(+), 10 deletions(-)

diff --git a/osu.Game/Screens/Edit/Compose/Components/SelectionBox.cs b/osu.Game/Screens/Edit/Compose/Components/SelectionBox.cs
index 3a31f6ea8c..cda986c7cd 100644
--- a/osu.Game/Screens/Edit/Compose/Components/SelectionBox.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/SelectionBox.cs
@@ -15,6 +15,7 @@ using osuTK.Input;
 
 namespace osu.Game.Screens.Edit.Compose.Components
 {
+    [Cached]
     public class SelectionBox : CompositeDrawable
     {
         public const float BORDER_RADIUS = 3;
@@ -306,7 +307,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
             var handle = new SelectionBoxScaleHandle
             {
                 Anchor = anchor,
-                HandleDrag = e => OnScale?.Invoke(e.Delta, anchor)
+                HandleScale = (delta, a) => OnScale?.Invoke(delta, a)
             };
 
             handle.OperationStarted += operationStarted;
@@ -319,7 +320,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
             var handle = new SelectionBoxRotationHandle
             {
                 Anchor = anchor,
-                HandleDrag = e => OnRotation?.Invoke(convertDragEventToAngleOfRotation(e))
+                HandleRotate = angle => OnRotation?.Invoke(angle)
             };
 
             handle.OperationStarted += operationStarted;
diff --git a/osu.Game/Screens/Edit/Compose/Components/SelectionBoxDragHandle.cs b/osu.Game/Screens/Edit/Compose/Components/SelectionBoxDragHandle.cs
index cac907ca5e..c37fefeed4 100644
--- a/osu.Game/Screens/Edit/Compose/Components/SelectionBoxDragHandle.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/SelectionBoxDragHandle.cs
@@ -8,20 +8,12 @@ namespace osu.Game.Screens.Edit.Compose.Components
 {
     public abstract class SelectionBoxDragHandle : SelectionBoxControl
     {
-        public Action<DragEvent> HandleDrag { get; set; }
-
         protected override bool OnDragStart(DragStartEvent e)
         {
             TriggerOperationStarted();
             return true;
         }
 
-        protected override void OnDrag(DragEvent e)
-        {
-            HandleDrag?.Invoke(e);
-            base.OnDrag(e);
-        }
-
         protected override void OnDragEnd(DragEndEvent e)
         {
             TriggerOperationEnded();
diff --git a/osu.Game/Screens/Edit/Compose/Components/SelectionBoxRotationHandle.cs b/osu.Game/Screens/Edit/Compose/Components/SelectionBoxRotationHandle.cs
index 65a54292ab..0db36d8902 100644
--- a/osu.Game/Screens/Edit/Compose/Components/SelectionBoxRotationHandle.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/SelectionBoxRotationHandle.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 osu.Framework.Allocation;
 using osu.Framework.Extensions.EnumExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Sprites;
+using osu.Framework.Input.Events;
 using osuTK;
 using osuTK.Graphics;
 
@@ -12,8 +14,13 @@ namespace osu.Game.Screens.Edit.Compose.Components
 {
     public class SelectionBoxRotationHandle : SelectionBoxDragHandle
     {
+        public Action<float> HandleRotate { get; set; }
+
         private SpriteIcon icon;
 
+        [Resolved]
+        private SelectionBox selectionBox { get; set; }
+
         [BackgroundDependencyLoader]
         private void load()
         {
@@ -38,5 +45,20 @@ namespace osu.Game.Screens.Edit.Compose.Components
             base.UpdateHoverState();
             icon.FadeColour(!IsHeld && IsHovered ? Color4.White : Color4.Black, TRANSFORM_DURATION, Easing.OutQuint);
         }
+
+        protected override void OnDrag(DragEvent e)
+        {
+            base.OnDrag(e);
+            HandleRotate?.Invoke(convertDragEventToAngleOfRotation(e));
+        }
+
+        private float convertDragEventToAngleOfRotation(DragEvent e)
+        {
+            // Adjust coordinate system to the center of SelectionBox
+            float startAngle = MathF.Atan2(e.LastMousePosition.Y - selectionBox.DrawHeight / 2, e.LastMousePosition.X - selectionBox.DrawWidth / 2);
+            float endAngle = MathF.Atan2(e.MousePosition.Y - selectionBox.DrawHeight / 2, e.MousePosition.X - selectionBox.DrawWidth / 2);
+
+            return (endAngle - startAngle) * 180 / MathF.PI;
+        }
     }
 }
diff --git a/osu.Game/Screens/Edit/Compose/Components/SelectionBoxScaleHandle.cs b/osu.Game/Screens/Edit/Compose/Components/SelectionBoxScaleHandle.cs
index a87c661f45..1f82f28380 100644
--- a/osu.Game/Screens/Edit/Compose/Components/SelectionBoxScaleHandle.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/SelectionBoxScaleHandle.cs
@@ -1,17 +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 System;
 using osu.Framework.Allocation;
+using osu.Framework.Graphics;
+using osu.Framework.Input.Events;
 using osuTK;
 
 namespace osu.Game.Screens.Edit.Compose.Components
 {
     public class SelectionBoxScaleHandle : SelectionBoxDragHandle
     {
+        public Action<Vector2, Anchor> HandleScale { get; set; }
+
         [BackgroundDependencyLoader]
         private void load()
         {
             Size = new Vector2(10);
         }
+
+        protected override void OnDrag(DragEvent e)
+        {
+            HandleScale?.Invoke(e.Delta, Anchor);
+            base.OnDrag(e);
+        }
     }
 }

From d76c674abc569c383bc8adbc7c4d9986a2029de4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 8 Jan 2022 17:42:58 +0100
Subject: [PATCH 1968/5547] Add tooltip with relative rotation in degrees to
 rotation handles

---
 .../Components/SelectionBoxRotationHandle.cs  | 46 ++++++++++++++++++-
 1 file changed, 44 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/Edit/Compose/Components/SelectionBoxRotationHandle.cs b/osu.Game/Screens/Edit/Compose/Components/SelectionBoxRotationHandle.cs
index 0db36d8902..22479bd9b3 100644
--- a/osu.Game/Screens/Edit/Compose/Components/SelectionBoxRotationHandle.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/SelectionBoxRotationHandle.cs
@@ -3,21 +3,29 @@
 
 using System;
 using osu.Framework.Allocation;
+using osu.Framework.Bindables;
 using osu.Framework.Extensions.EnumExtensions;
+using osu.Framework.Extensions.LocalisationExtensions;
 using osu.Framework.Graphics;
+using osu.Framework.Graphics.Cursor;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Input.Events;
+using osu.Framework.Localisation;
 using osuTK;
 using osuTK.Graphics;
 
 namespace osu.Game.Screens.Edit.Compose.Components
 {
-    public class SelectionBoxRotationHandle : SelectionBoxDragHandle
+    public class SelectionBoxRotationHandle : SelectionBoxDragHandle, IHasTooltip
     {
         public Action<float> HandleRotate { get; set; }
 
+        public LocalisableString TooltipText { get; private set; }
+
         private SpriteIcon icon;
 
+        private readonly Bindable<float?> cumulativeRotation = new Bindable<float?>();
+
         [Resolved]
         private SelectionBox selectionBox { get; set; }
 
@@ -40,16 +48,45 @@ namespace osu.Game.Screens.Edit.Compose.Components
             });
         }
 
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+            cumulativeRotation.BindValueChanged(_ => updateTooltipText(), true);
+        }
+
         protected override void UpdateHoverState()
         {
             base.UpdateHoverState();
             icon.FadeColour(!IsHeld && IsHovered ? Color4.White : Color4.Black, TRANSFORM_DURATION, Easing.OutQuint);
         }
 
+        protected override bool OnDragStart(DragStartEvent e)
+        {
+            bool handle = base.OnDragStart(e);
+            if (handle)
+                cumulativeRotation.Value = 0;
+            return handle;
+        }
+
         protected override void OnDrag(DragEvent e)
         {
             base.OnDrag(e);
-            HandleRotate?.Invoke(convertDragEventToAngleOfRotation(e));
+
+            float instantaneousAngle = convertDragEventToAngleOfRotation(e);
+            cumulativeRotation.Value += instantaneousAngle;
+
+            if (cumulativeRotation.Value < -180)
+                cumulativeRotation.Value += 360;
+            else if (cumulativeRotation.Value > 180)
+                cumulativeRotation.Value -= 360;
+
+            HandleRotate?.Invoke(instantaneousAngle);
+        }
+
+        protected override void OnDragEnd(DragEndEvent e)
+        {
+            base.OnDragEnd(e);
+            cumulativeRotation.Value = null;
         }
 
         private float convertDragEventToAngleOfRotation(DragEvent e)
@@ -60,5 +97,10 @@ namespace osu.Game.Screens.Edit.Compose.Components
 
             return (endAngle - startAngle) * 180 / MathF.PI;
         }
+
+        private void updateTooltipText()
+        {
+            TooltipText = cumulativeRotation.Value?.ToLocalisableString("0.0°") ?? default(LocalisableString);
+        }
     }
 }

From 82d6639a3b3e8c576e036f95b50367b7c97e8d2f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 9 Jan 2022 14:31:37 +0100
Subject: [PATCH 1969/5547] Decouple rankings table test from online API

---
 .../Visual/Online/TestSceneRankingsTables.cs  | 158 +++++++++++-------
 1 file changed, 97 insertions(+), 61 deletions(-)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneRankingsTables.cs b/osu.Game.Tests/Visual/Online/TestSceneRankingsTables.cs
index ee109189c7..35e219f839 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneRankingsTables.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneRankingsTables.cs
@@ -1,38 +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 System.Collections.Generic;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Overlays.Rankings.Tables;
 using osu.Framework.Graphics;
-using osu.Game.Online.API.Requests;
-using osu.Game.Rulesets;
 using System.Threading;
-using osu.Game.Online.API;
-using osu.Game.Rulesets.Osu;
-using osu.Game.Rulesets.Mania;
-using osu.Game.Rulesets.Taiko;
-using osu.Game.Rulesets.Catch;
 using osu.Framework.Allocation;
 using osu.Game.Graphics.UserInterface;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays;
-using osu.Game.Overlays.Rankings;
+using osu.Game.Users;
 
 namespace osu.Game.Tests.Visual.Online
 {
     public class TestSceneRankingsTables : OsuTestScene
     {
-        protected override bool UseOnlineAPI => true;
-
-        [Resolved]
-        private IAPIProvider api { get; set; }
-
         [Cached]
         private readonly OverlayColourProvider colourProvider = new OverlayColourProvider(OverlayColourScheme.Green);
 
         private readonly BasicScrollContainer scrollFlow;
         private readonly LoadingLayer loading;
         private CancellationTokenSource cancellationToken;
-        private APIRequest request;
 
         public TestSceneRankingsTables()
         {
@@ -53,73 +42,120 @@ namespace osu.Game.Tests.Visual.Online
         {
             base.LoadComplete();
 
-            AddStep("Osu performance", () => createPerformanceTable(new OsuRuleset().RulesetInfo, null));
-            AddStep("Mania scores", () => createScoreTable(new ManiaRuleset().RulesetInfo));
-            AddStep("Taiko country scores", () => createCountryTable(new TaikoRuleset().RulesetInfo));
-            AddStep("Catch US performance page 10", () => createPerformanceTable(new CatchRuleset().RulesetInfo, "US", 10));
-            AddStep("Osu spotlight table (chart 271)", () => createSpotlightTable(new OsuRuleset().RulesetInfo, 271));
+            AddStep("User performance", createPerformanceTable);
+            AddStep("User scores", createScoreTable);
+            AddStep("Country scores", createCountryTable);
         }
 
-        private void createCountryTable(RulesetInfo ruleset, int page = 1)
+        private void createCountryTable()
         {
             onLoadStarted();
 
-            request = new GetCountryRankingsRequest(ruleset, page);
-            ((GetCountryRankingsRequest)request).Success += rankings => Schedule(() =>
+            var countries = new List<CountryStatistics>
             {
-                var table = new CountriesTable(page, rankings.Countries);
-                loadTable(table);
-            });
+                new CountryStatistics
+                {
+                    Country = new Country { FlagName = "US", FullName = "United States" },
+                    FlagName = "US",
+                    ActiveUsers = 2_972_623,
+                    PlayCount = 3_086_515_743,
+                    RankedScore = 449_407_643_332_546,
+                    Performance = 371_974_024
+                },
+                new CountryStatistics
+                {
+                    Country = new Country { FlagName = "RU", FullName = "Russian Federation" },
+                    FlagName = "RU",
+                    ActiveUsers = 1_609_989,
+                    PlayCount = 1_637_052_841,
+                    RankedScore = 221_660_827_473_004,
+                    Performance = 163_426_476
+                }
+            };
 
-            api.Queue(request);
+            var table = new CountriesTable(1, countries);
+            loadTable(table);
         }
 
-        private void createPerformanceTable(RulesetInfo ruleset, string country, int page = 1)
+        private static List<UserStatistics> createUserStatistics() => new List<UserStatistics>
+        {
+            new UserStatistics
+            {
+                User = new APIUser
+                {
+                    Username = "first active user",
+                    Country = new Country { FlagName = "JP" },
+                    Active = true,
+                },
+                Accuracy = 0.9972,
+                PlayCount = 233_215,
+                TotalScore = 983_231_234_656,
+                RankedScore = 593_231_345_897,
+                PP = 23_934,
+                GradesCount = new UserStatistics.Grades
+                {
+                    SS = 35_132,
+                    S = 23_345,
+                    A = 12_234
+                }
+            },
+            new UserStatistics
+            {
+                User = new APIUser
+                {
+                    Username = "inactive user",
+                    Country = new Country { FlagName = "AU" },
+                    Active = false,
+                },
+                Accuracy = 0.9831,
+                PlayCount = 195_342,
+                TotalScore = 683_231_234_656,
+                RankedScore = 393_231_345_897,
+                PP = 20_934,
+                GradesCount = new UserStatistics.Grades
+                {
+                    SS = 32_132,
+                    S = 20_345,
+                    A = 9_234
+                }
+            },
+            new UserStatistics
+            {
+                User = new APIUser
+                {
+                    Username = "second active user",
+                    Country = new Country { FlagName = "PL" },
+                    Active = true,
+                },
+                Accuracy = 0.9584,
+                PlayCount = 100_903,
+                TotalScore = 97_242_983_434,
+                RankedScore = 3_156_345_897,
+                PP = 9_568,
+                GradesCount = new UserStatistics.Grades
+                {
+                    SS = 13_152,
+                    S = 24_375,
+                    A = 9_960
+                }
+            },
+        };
+
+        private void createPerformanceTable()
         {
             onLoadStarted();
-
-            request = new GetUserRankingsRequest(ruleset, country: country, page: page);
-            ((GetUserRankingsRequest)request).Success += rankings => Schedule(() =>
-            {
-                var table = new PerformanceTable(page, rankings.Users);
-                loadTable(table);
-            });
-
-            api.Queue(request);
+            loadTable(new PerformanceTable(1, createUserStatistics()));
         }
 
-        private void createScoreTable(RulesetInfo ruleset, int page = 1)
+        private void createScoreTable()
         {
             onLoadStarted();
-
-            request = new GetUserRankingsRequest(ruleset, UserRankingsType.Score, page);
-            ((GetUserRankingsRequest)request).Success += rankings => Schedule(() =>
-            {
-                var table = new ScoresTable(page, rankings.Users);
-                loadTable(table);
-            });
-
-            api.Queue(request);
-        }
-
-        private void createSpotlightTable(RulesetInfo ruleset, int spotlight)
-        {
-            onLoadStarted();
-
-            request = new GetSpotlightRankingsRequest(ruleset, spotlight, RankingsSortCriteria.All);
-            ((GetSpotlightRankingsRequest)request).Success += rankings => Schedule(() =>
-            {
-                var table = new ScoresTable(1, rankings.Users);
-                loadTable(table);
-            });
-
-            api.Queue(request);
+            loadTable(new ScoresTable(1, createUserStatistics()));
         }
 
         private void onLoadStarted()
         {
             loading.Show();
-            request?.Cancel();
             cancellationToken?.Cancel();
             cancellationToken = new CancellationTokenSource();
         }

From 12c8243a9b55b6ed2c1509852c191fb7b13a8898 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 9 Jan 2022 14:32:33 +0100
Subject: [PATCH 1970/5547] Fade out inactive player rows on user ranking table

---
 .../Overlays/Rankings/Tables/RankingsTable.cs |  8 ++++---
 .../Rankings/Tables/UserBasedTable.cs         | 23 +++++++++++++++++++
 2 files changed, 28 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Overlays/Rankings/Tables/RankingsTable.cs b/osu.Game/Overlays/Rankings/Tables/RankingsTable.cs
index 6e6230f958..fd69b6c80a 100644
--- a/osu.Game/Overlays/Rankings/Tables/RankingsTable.cs
+++ b/osu.Game/Overlays/Rankings/Tables/RankingsTable.cs
@@ -54,13 +54,15 @@ namespace osu.Game.Overlays.Rankings.Tables
                 Spacing = new Vector2(0, row_spacing),
             });
 
-            rankings.ForEach(_ => backgroundFlow.Add(new TableRowBackground { Height = row_height }));
+            rankings.ForEach(s => backgroundFlow.Add(CreateRowBackground(s)));
 
             Columns = mainHeaders.Concat(CreateAdditionalHeaders()).Cast<TableColumn>().ToArray();
-            Content = rankings.Select((s, i) => createContent((page - 1) * items_per_page + i, s)).ToArray().ToRectangular();
+            Content = rankings.Select((s, i) => CreateRowContent((page - 1) * items_per_page + i, s)).ToArray().ToRectangular();
         }
 
-        private Drawable[] createContent(int index, TModel item) => new Drawable[] { createIndexDrawable(index), createMainContent(item) }.Concat(CreateAdditionalContent(item)).ToArray();
+        protected virtual Drawable CreateRowBackground(TModel item) => new TableRowBackground { Height = row_height };
+
+        protected virtual Drawable[] CreateRowContent(int index, TModel item) => new Drawable[] { createIndexDrawable(index), createMainContent(item) }.Concat(CreateAdditionalContent(item)).ToArray();
 
         private static RankingsTableColumn[] mainHeaders => new[]
         {
diff --git a/osu.Game/Overlays/Rankings/Tables/UserBasedTable.cs b/osu.Game/Overlays/Rankings/Tables/UserBasedTable.cs
index cc2ef55a2b..c403d734d3 100644
--- a/osu.Game/Overlays/Rankings/Tables/UserBasedTable.cs
+++ b/osu.Game/Overlays/Rankings/Tables/UserBasedTable.cs
@@ -24,6 +24,29 @@ namespace osu.Game.Overlays.Rankings.Tables
 
         protected virtual IEnumerable<LocalisableString> GradeColumns => new List<LocalisableString> { RankingsStrings.Statss, RankingsStrings.Stats, RankingsStrings.Stata };
 
+        protected override Drawable CreateRowBackground(UserStatistics item)
+        {
+            var background = base.CreateRowBackground(item);
+
+            if (!item.User.Active)
+                background.Alpha = 0.5f;
+
+            return background;
+        }
+
+        protected override Drawable[] CreateRowContent(int index, UserStatistics item)
+        {
+            var content = base.CreateRowContent(index, item);
+
+            if (!item.User.Active)
+            {
+                foreach (var d in content)
+                    d.Alpha = 0.5f;
+            }
+
+            return content;
+        }
+
         protected override RankingsTableColumn[] CreateAdditionalHeaders() => new[]
             {
                 new RankingsTableColumn(RankingsStrings.StatAccuracy, Anchor.Centre, new Dimension(GridSizeMode.AutoSize)),

From 2e9ba40ae27fb3b177e8e86038a4328b8f2bb02c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 9 Jan 2022 14:46:15 +0100
Subject: [PATCH 1971/5547] Add references to web implementation wrt property
 used

---
 osu.Game/Overlays/Rankings/Tables/UserBasedTable.cs | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/osu.Game/Overlays/Rankings/Tables/UserBasedTable.cs b/osu.Game/Overlays/Rankings/Tables/UserBasedTable.cs
index c403d734d3..5d150c9535 100644
--- a/osu.Game/Overlays/Rankings/Tables/UserBasedTable.cs
+++ b/osu.Game/Overlays/Rankings/Tables/UserBasedTable.cs
@@ -28,6 +28,7 @@ namespace osu.Game.Overlays.Rankings.Tables
         {
             var background = base.CreateRowBackground(item);
 
+            // see: https://github.com/ppy/osu-web/blob/9de00a0b874c56893d98261d558d78d76259d81b/resources/views/multiplayer/rooms/_rankings_table.blade.php#L23
             if (!item.User.Active)
                 background.Alpha = 0.5f;
 
@@ -38,6 +39,7 @@ namespace osu.Game.Overlays.Rankings.Tables
         {
             var content = base.CreateRowContent(index, item);
 
+            // see: https://github.com/ppy/osu-web/blob/9de00a0b874c56893d98261d558d78d76259d81b/resources/views/multiplayer/rooms/_rankings_table.blade.php#L23
             if (!item.User.Active)
             {
                 foreach (var d in content)

From ca162ed09a68693cbef2c0bc2c1ae3b1ae3e7c44 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 10 Jan 2022 11:36:26 +0900
Subject: [PATCH 1972/5547] Update resources

---
 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 67a9cd41dd..3b75014aad 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -51,7 +51,7 @@
     <Reference Include="Java.Interop" />
   </ItemGroup>
   <ItemGroup>
-    <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1215.0" />
+    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.109.0" />
     <PackageReference Include="ppy.osu.Framework.Android" Version="2021.1227.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index c7913cb71d..24e5858cb0 100644
--- a/osu.Game/osu.Game.csproj
+++ b/osu.Game/osu.Game.csproj
@@ -37,7 +37,7 @@
     </PackageReference>
     <PackageReference Include="Realm" Version="10.7.1" />
     <PackageReference Include="ppy.osu.Framework" Version="2021.1227.0" />
-    <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1215.0" />
+    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.109.0" />
     <PackageReference Include="Sentry" Version="3.12.1" />
     <PackageReference Include="SharpCompress" Version="0.30.1" />
     <PackageReference Include="NUnit" Version="3.13.2" />
diff --git a/osu.iOS.props b/osu.iOS.props
index 63dc889e3c..b0dafa1daa 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -61,7 +61,7 @@
   </ItemGroup>
   <ItemGroup Label="Package References">
     <PackageReference Include="ppy.osu.Framework.iOS" Version="2021.1227.0" />
-    <PackageReference Include="ppy.osu.Game.Resources" Version="2021.1215.0" />
+    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.109.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net5.0 / net6.0) -->
   <PropertyGroup>

From 3d14511286f8badd817e4543c4f07123d4deb5d6 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 10 Jan 2022 12:17:32 +0900
Subject: [PATCH 1973/5547] Remove MD5 comparison also

---
 osu.Game.Tests/Beatmaps/Formats/LegacyScoreDecoderTest.cs | 1 -
 1 file changed, 1 deletion(-)

diff --git a/osu.Game.Tests/Beatmaps/Formats/LegacyScoreDecoderTest.cs b/osu.Game.Tests/Beatmaps/Formats/LegacyScoreDecoderTest.cs
index b886a61c0f..9ac7838821 100644
--- a/osu.Game.Tests/Beatmaps/Formats/LegacyScoreDecoderTest.cs
+++ b/osu.Game.Tests/Beatmaps/Formats/LegacyScoreDecoderTest.cs
@@ -95,7 +95,6 @@ namespace osu.Game.Tests.Beatmaps.Formats
                 Assert.That(decodedAfterEncode, Is.Not.Null);
 
                 Assert.That(decodedAfterEncode.ScoreInfo.User.Username, Is.EqualTo(scoreInfo.User.Username));
-                Assert.That(decodedAfterEncode.ScoreInfo.BeatmapInfo.MD5Hash, Is.EqualTo(scoreInfo.BeatmapInfo.MD5Hash));
                 Assert.That(decodedAfterEncode.ScoreInfo.Ruleset, Is.EqualTo(scoreInfo.Ruleset));
                 Assert.That(decodedAfterEncode.ScoreInfo.TotalScore, Is.EqualTo(scoreInfo.TotalScore));
                 Assert.That(decodedAfterEncode.ScoreInfo.MaxCombo, Is.EqualTo(scoreInfo.MaxCombo));

From 02d8a6359a98a3c8ed393eda5c26376079d8cd79 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 10 Jan 2022 12:28:09 +0900
Subject: [PATCH 1974/5547] Update `FilterMatchingTest` and filter code to use
 ruleset's `OnlineID`

The tests were relying on the `RulesetID` being set to 0 in the example
beatmap, even though the ruleset *instance* was set to ID 5.

This explicitly adds that 0 value to show intent, and also removes the
incorrect specification of 5 (which would cause the convert filter tests
to fail).

Also updates the filter code to use `OnlineID`, which is required in
realm changes.
---
 osu.Game.Tests/NonVisual/Filtering/FilterMatchingTest.cs | 3 ++-
 osu.Game/Screens/Select/Carousel/CarouselBeatmap.cs      | 4 ++--
 2 files changed, 4 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Tests/NonVisual/Filtering/FilterMatchingTest.cs b/osu.Game.Tests/NonVisual/Filtering/FilterMatchingTest.cs
index 55378043e6..8ba3d1a6c7 100644
--- a/osu.Game.Tests/NonVisual/Filtering/FilterMatchingTest.cs
+++ b/osu.Game.Tests/NonVisual/Filtering/FilterMatchingTest.cs
@@ -16,7 +16,8 @@ namespace osu.Game.Tests.NonVisual.Filtering
     {
         private BeatmapInfo getExampleBeatmap() => new BeatmapInfo
         {
-            Ruleset = new RulesetInfo { OnlineID = 5 },
+            Ruleset = new RulesetInfo { OnlineID = 0 },
+            RulesetID = 0,
             StarRating = 4.0d,
             BaseDifficulty = new BeatmapDifficulty
             {
diff --git a/osu.Game/Screens/Select/Carousel/CarouselBeatmap.cs b/osu.Game/Screens/Select/Carousel/CarouselBeatmap.cs
index cc2db6ed31..d2c7c75da8 100644
--- a/osu.Game/Screens/Select/Carousel/CarouselBeatmap.cs
+++ b/osu.Game/Screens/Select/Carousel/CarouselBeatmap.cs
@@ -28,8 +28,8 @@ namespace osu.Game.Screens.Select.Carousel
 
             bool match =
                 criteria.Ruleset == null ||
-                BeatmapInfo.RulesetID == criteria.Ruleset.ID ||
-                (BeatmapInfo.RulesetID == 0 && criteria.Ruleset.ID > 0 && criteria.AllowConvertedBeatmaps);
+                BeatmapInfo.RulesetID == criteria.Ruleset.OnlineID ||
+                (BeatmapInfo.RulesetID == 0 && criteria.Ruleset.OnlineID > 0 && criteria.AllowConvertedBeatmaps);
 
             if (BeatmapInfo.BeatmapSet?.Equals(criteria.SelectedBeatmapSet) == true)
             {

From d072f1d08d2e045e7546edc20df60959a4193032 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 10 Jan 2022 12:54:24 +0900
Subject: [PATCH 1975/5547] Add mention to detach methods of only running once

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

diff --git a/osu.Game/Database/RealmObjectExtensions.cs b/osu.Game/Database/RealmObjectExtensions.cs
index e5177823ba..e09f046421 100644
--- a/osu.Game/Database/RealmObjectExtensions.cs
+++ b/osu.Game/Database/RealmObjectExtensions.cs
@@ -26,6 +26,9 @@ namespace osu.Game.Database
         /// <summary>
         /// Create a detached copy of the each item in the collection.
         /// </summary>
+        /// <remarks>
+        /// Items which are already detached (ie. not managed by realm) will not be modified.
+        /// </remarks>
         /// <param name="items">A list of managed <see cref="RealmObject"/>s to detach.</param>
         /// <typeparam name="T">The type of object.</typeparam>
         /// <returns>A list containing non-managed copies of provided items.</returns>
@@ -42,6 +45,9 @@ namespace osu.Game.Database
         /// <summary>
         /// Create a detached copy of the item.
         /// </summary>
+        /// <remarks>
+        /// If the item if already detached (ie. not managed by realm) it will not be detached again and the original instance will be returned. This allows this method to be potentially called at multiple levels while only incurring the clone overhead once.
+        /// </remarks>
         /// <param name="item">The managed <see cref="RealmObject"/> to detach.</param>
         /// <typeparam name="T">The type of object.</typeparam>
         /// <returns>A non-managed copy of provided item. Will return the provided item if already detached.</returns>

From b88a65166eb8cff24a1f4e9558de34721fd934fd Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 11 Jan 2022 10:22:16 +0900
Subject: [PATCH 1976/5547] Fix pp counter underflow with SpunOut mod

---
 osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
index d7d294df47..fdf646ef85 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
@@ -48,7 +48,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty
             if (mods.Any(m => m is OsuModNoFail))
                 multiplier *= Math.Max(0.90, 1.0 - 0.02 * effectiveMissCount);
 
-            if (mods.Any(m => m is OsuModSpunOut))
+            if (mods.Any(m => m is OsuModSpunOut) && totalHits > 0)
                 multiplier *= 1.0 - Math.Pow((double)Attributes.SpinnerCount / totalHits, 0.85);
 
             if (mods.Any(h => h is OsuModRelax))

From a09563a7d9ea559ad179d5997c0d0ae3c3265235 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 11 Jan 2022 11:00:30 +0900
Subject: [PATCH 1977/5547] Fix calculation of most common beat length for
 mania scroll speed

---
 .../UI/Scrolling/DrawableScrollingRuleset.cs  | 22 ++++---------------
 1 file changed, 4 insertions(+), 18 deletions(-)

diff --git a/osu.Game/Rulesets/UI/Scrolling/DrawableScrollingRuleset.cs b/osu.Game/Rulesets/UI/Scrolling/DrawableScrollingRuleset.cs
index 1f3a937311..926f2fd539 100644
--- a/osu.Game/Rulesets/UI/Scrolling/DrawableScrollingRuleset.cs
+++ b/osu.Game/Rulesets/UI/Scrolling/DrawableScrollingRuleset.cs
@@ -116,25 +116,11 @@ namespace osu.Game.Rulesets.UI.Scrolling
 
             if (RelativeScaleBeatLengths)
             {
-                IReadOnlyList<TimingControlPoint> timingPoints = Beatmap.ControlPointInfo.TimingPoints;
-                double maxDuration = 0;
+                baseBeatLength = Beatmap.GetMostCommonBeatLength();
 
-                for (int i = 0; i < timingPoints.Count; i++)
-                {
-                    if (timingPoints[i].Time > lastObjectTime)
-                        break;
-
-                    double endTime = i < timingPoints.Count - 1 ? timingPoints[i + 1].Time : lastObjectTime;
-                    double duration = endTime - timingPoints[i].Time;
-
-                    if (duration > maxDuration)
-                    {
-                        maxDuration = duration;
-                        // The slider multiplier is post-multiplied to determine the final velocity, but for relative scale beat lengths
-                        // the multiplier should not affect the effective timing point (the longest in the beatmap), so it is factored out here
-                        baseBeatLength = timingPoints[i].BeatLength / Beatmap.Difficulty.SliderMultiplier;
-                    }
-                }
+                // The slider multiplier is post-multiplied to determine the final velocity, but for relative scale beat lengths
+                // the multiplier should not affect the effective timing point (the longest in the beatmap), so it is factored out here
+                baseBeatLength /= Beatmap.Difficulty.SliderMultiplier;
             }
 
             // Merge sequences of timing and difficulty control points to create the aggregate "multiplier" control point

From 81fed4c6bfed04d3a6ede5bbc685320a91ddcdd7 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 11 Jan 2022 12:55:12 +0900
Subject: [PATCH 1978/5547] Use time=0 as for the first control point

---
 osu.Game/Beatmaps/Beatmap.cs | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Beatmaps/Beatmap.cs b/osu.Game/Beatmaps/Beatmap.cs
index f69a10f000..133a22d8f7 100644
--- a/osu.Game/Beatmaps/Beatmap.cs
+++ b/osu.Game/Beatmaps/Beatmap.cs
@@ -93,8 +93,10 @@ namespace osu.Game.Beatmaps
                                     if (t.Time > lastTime)
                                         return (beatLength: t.BeatLength, 0);
 
+                                    double currentTime = i == 0 ? 0 : t.Time;
                                     double nextTime = i == ControlPointInfo.TimingPoints.Count - 1 ? lastTime : ControlPointInfo.TimingPoints[i + 1].Time;
-                                    return (beatLength: t.BeatLength, duration: nextTime - t.Time);
+
+                                    return (beatLength: t.BeatLength, duration: nextTime - currentTime);
                                 })
                                 // Aggregate durations into a set of (beatLength, duration) tuples for each beat length
                                 .GroupBy(t => Math.Round(t.beatLength * 1000) / 1000)

From 38a51b9ce014fd210a02e8d499ec58295d16ec2b Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 11 Jan 2022 13:53:51 +0900
Subject: [PATCH 1979/5547] Add comment

---
 osu.Game/Beatmaps/Beatmap.cs | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/osu.Game/Beatmaps/Beatmap.cs b/osu.Game/Beatmaps/Beatmap.cs
index 133a22d8f7..435183fe92 100644
--- a/osu.Game/Beatmaps/Beatmap.cs
+++ b/osu.Game/Beatmaps/Beatmap.cs
@@ -93,6 +93,8 @@ namespace osu.Game.Beatmaps
                                     if (t.Time > lastTime)
                                         return (beatLength: t.BeatLength, 0);
 
+                                    // osu-stable forced the first control point to start at 0.
+                                    // This is reproduced here to maintain compatibility around osu!mania scroll speed and song select display.
                                     double currentTime = i == 0 ? 0 : t.Time;
                                     double nextTime = i == ControlPointInfo.TimingPoints.Count - 1 ? lastTime : ControlPointInfo.TimingPoints[i + 1].Time;
 

From 797d3f5d65e9880c613375903532b70897fb6693 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 11 Jan 2022 15:09:51 +0900
Subject: [PATCH 1980/5547] Update framework

---
 osu.Android.props        | 2 +-
 osu.Game/osu.Game.csproj | 2 +-
 osu.iOS.props            | 4 ++--
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Android.props b/osu.Android.props
index f19a33ba75..92adbebf5a 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -52,7 +52,7 @@
   </ItemGroup>
   <ItemGroup>
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.109.0" />
-    <PackageReference Include="ppy.osu.Framework.Android" Version="2022.107.0" />
+    <PackageReference Include="ppy.osu.Framework.Android" Version="2022.111.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
     <!-- Realm needs to be directly referenced in all Xamarin projects, as it will not pull in its transitive dependencies otherwise. -->
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 43bb0cdb88..1430320c87 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="10.7.1" />
-    <PackageReference Include="ppy.osu.Framework" Version="2022.107.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2022.111.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.109.0" />
     <PackageReference Include="Sentry" Version="3.12.1" />
     <PackageReference Include="SharpCompress" Version="0.30.1" />
diff --git a/osu.iOS.props b/osu.iOS.props
index 49301fc329..3cef888447 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -60,7 +60,7 @@
     <Reference Include="System.Net.Http" />
   </ItemGroup>
   <ItemGroup Label="Package References">
-    <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.107.0" />
+    <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.111.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.109.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net5.0 / net6.0) -->
@@ -83,7 +83,7 @@
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="2.2.6" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.Core" Version="2.2.6" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
-    <PackageReference Include="ppy.osu.Framework" Version="2022.107.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2022.111.0" />
     <PackageReference Include="SharpCompress" Version="0.30.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
     <PackageReference Include="System.ComponentModel.Annotations" Version="5.0.0" />

From 269df08fc9453b0ce2eaa9c24bd4a224e82fc9b1 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 11 Jan 2022 17:42:02 +0900
Subject: [PATCH 1981/5547] Make ChatLink tests into proper unit test methods

---
 .../Visual/Online/TestSceneChatLink.cs        | 118 ++++++++++--------
 1 file changed, 65 insertions(+), 53 deletions(-)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneChatLink.cs b/osu.Game.Tests/Visual/Online/TestSceneChatLink.cs
index a03c00eb58..ce5c38d33f 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneChatLink.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneChatLink.cs
@@ -50,58 +50,19 @@ namespace osu.Game.Tests.Visual.Online
 
             Dependencies.Cache(new ChatOverlay());
             Dependencies.Cache(dialogOverlay);
-
-            testLinksGeneral();
-            testEcho();
         }
 
-        private void clear() => AddStep("clear messages", textContainer.Clear);
-
-        private void addMessageWithChecks(string text, int linkAmount = 0, bool isAction = false, bool isImportant = false, params LinkAction[] expectedActions)
+        [SetUp]
+        public void Setup() => Schedule(() =>
         {
-            int index = textContainer.Count + 1;
-            var newLine = new ChatLine(new DummyMessage(text, isAction, isImportant, index));
-            textContainer.Add(newLine);
+            textContainer.Clear();
+        });
 
-            AddAssert($"msg #{index} has {linkAmount} link(s)", () => newLine.Message.Links.Count == linkAmount);
-            AddAssert($"msg #{index} has the right action", hasExpectedActions);
-            //AddAssert($"msg #{index} is " + (isAction ? "italic" : "not italic"), () => newLine.ContentFlow.Any() && isAction == isItalic());
-            AddAssert($"msg #{index} shows {linkAmount} link(s)", isShowingLinks);
-
-            bool hasExpectedActions()
-            {
-                var expectedActionsList = expectedActions.ToList();
-
-                if (expectedActionsList.Count != newLine.Message.Links.Count)
-                    return false;
-
-                for (int i = 0; i < newLine.Message.Links.Count; i++)
-                {
-                    var action = newLine.Message.Links[i].Action;
-                    if (action != expectedActions[i]) return false;
-                }
-
-                return true;
-            }
-
-            //bool isItalic() => newLine.ContentFlow.Where(d => d is OsuSpriteText).Cast<OsuSpriteText>().All(sprite => sprite.Font.Italics);
-
-            bool isShowingLinks()
-            {
-                bool hasBackground = !string.IsNullOrEmpty(newLine.Message.Sender.Colour);
-
-                Color4 textColour = isAction && hasBackground ? Color4Extensions.FromHex(newLine.Message.Sender.Colour) : Color4.White;
-
-                var linkCompilers = newLine.ContentFlow.Where(d => d is DrawableLinkCompiler).ToList();
-                var linkSprites = linkCompilers.SelectMany(comp => ((DrawableLinkCompiler)comp).Parts);
-
-                return linkSprites.All(d => d.Colour == linkColour)
-                       && newLine.ContentFlow.Except(linkSprites.Concat(linkCompilers)).All(d => d.Colour == textColour);
-            }
-        }
-
-        private void testLinksGeneral()
+        [Test]
+        public void TestLinksGeneral()
         {
+            int messageIndex = 0;
+
             addMessageWithChecks("test!");
             addMessageWithChecks("dev.ppy.sh!");
             addMessageWithChecks("https://dev.ppy.sh!", 1, expectedActions: LinkAction.External);
@@ -117,7 +78,8 @@ namespace osu.Game.Tests.Visual.Online
                 expectedActions: new[] { LinkAction.External, LinkAction.OpenBeatmap, LinkAction.External });
             addMessageWithChecks("[https://dev.ppy.sh/home New link format with escaped [and \\[ paired] braces]", 1, expectedActions: LinkAction.External);
             addMessageWithChecks("[Markdown link format with escaped [and \\[ paired] braces](https://dev.ppy.sh/home)", 1, expectedActions: LinkAction.External);
-            addMessageWithChecks("(Old link format with escaped (and \\( paired) parentheses)[https://dev.ppy.sh/home] and [[also a rogue wiki link]]", 2, expectedActions: new[] { LinkAction.External, LinkAction.External });
+            addMessageWithChecks("(Old link format with escaped (and \\( paired) parentheses)[https://dev.ppy.sh/home] and [[also a rogue wiki link]]", 2,
+                expectedActions: new[] { LinkAction.External, LinkAction.External });
             // note that there's 0 links here (they get removed if a channel is not found)
             addMessageWithChecks("#lobby or #osu would be blue (and work) in the ChatDisplay test (when a proper ChatOverlay is present).");
             addMessageWithChecks("I am important!", 0, false, true);
@@ -129,11 +91,60 @@ namespace osu.Game.Tests.Visual.Online
             addMessageWithChecks("Join my osu://chan/#english.", 1, expectedActions: LinkAction.OpenChannel);
             addMessageWithChecks("Join my #english or #japanese channels.", 2, expectedActions: new[] { LinkAction.OpenChannel, LinkAction.OpenChannel });
             addMessageWithChecks("Join my #english or #nonexistent #hashtag channels.", 1, expectedActions: LinkAction.OpenChannel);
+
+            void addMessageWithChecks(string text, int linkAmount = 0, bool isAction = false, bool isImportant = false, params LinkAction[] expectedActions)
+            {
+                ChatLine newLine = null;
+                int index = messageIndex++;
+
+                AddStep("add message", () =>
+                {
+                    newLine = new ChatLine(new DummyMessage(text, isAction, isImportant, index));
+                    textContainer.Add(newLine);
+                });
+
+                AddAssert($"msg #{index} has {linkAmount} link(s)", () => newLine.Message.Links.Count == linkAmount);
+                AddAssert($"msg #{index} has the right action", hasExpectedActions);
+                //AddAssert($"msg #{index} is " + (isAction ? "italic" : "not italic"), () => newLine.ContentFlow.Any() && isAction == isItalic());
+                AddAssert($"msg #{index} shows {linkAmount} link(s)", isShowingLinks);
+
+                bool hasExpectedActions()
+                {
+                    var expectedActionsList = expectedActions.ToList();
+
+                    if (expectedActionsList.Count != newLine.Message.Links.Count)
+                        return false;
+
+                    for (int i = 0; i < newLine.Message.Links.Count; i++)
+                    {
+                        var action = newLine.Message.Links[i].Action;
+                        if (action != expectedActions[i]) return false;
+                    }
+
+                    return true;
+                }
+
+                //bool isItalic() => newLine.ContentFlow.Where(d => d is OsuSpriteText).Cast<OsuSpriteText>().All(sprite => sprite.Font.Italics);
+
+                bool isShowingLinks()
+                {
+                    bool hasBackground = !string.IsNullOrEmpty(newLine.Message.Sender.Colour);
+
+                    Color4 textColour = isAction && hasBackground ? Color4Extensions.FromHex(newLine.Message.Sender.Colour) : Color4.White;
+
+                    var linkCompilers = newLine.ContentFlow.Where(d => d is DrawableLinkCompiler).ToList();
+                    var linkSprites = linkCompilers.SelectMany(comp => ((DrawableLinkCompiler)comp).Parts);
+
+                    return linkSprites.All(d => d.Colour == linkColour)
+                           && newLine.ContentFlow.Except(linkSprites.Concat(linkCompilers)).All(d => d.Colour == textColour);
+                }
+            }
         }
 
-        private void testEcho()
+        [Test]
+        public void TestEcho()
         {
-            int echoCounter = 0;
+            int messageIndex = 0;
 
             addEchoWithWait("sent!", "received!");
             addEchoWithWait("https://dev.ppy.sh/home", null, 500);
@@ -142,15 +153,16 @@ namespace osu.Game.Tests.Visual.Online
 
             void addEchoWithWait(string text, string completeText = null, double delay = 250)
             {
-                var newLine = new ChatLine(new DummyEchoMessage(text));
+                int index = messageIndex++;
 
-                AddStep($"send msg #{++echoCounter} after {delay}ms", () =>
+                AddStep($"send msg #{index} after {delay}ms", () =>
                 {
+                    ChatLine newLine = new ChatLine(new DummyEchoMessage(text));
                     textContainer.Add(newLine);
                     Scheduler.AddDelayed(() => newLine.Message = new DummyMessage(completeText ?? text), delay);
                 });
 
-                AddUntilStep($"wait for msg #{echoCounter}", () => textContainer.All(line => line.Message is DummyMessage));
+                AddUntilStep($"wait for msg #{index}", () => textContainer.All(line => line.Message is DummyMessage));
             }
         }
 

From 3cb5f43f775e4aa2e15c94b8d635aac7d7fca823 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 11 Jan 2022 17:45:31 +0900
Subject: [PATCH 1982/5547] Fix incorrect action returned for wiki links in
 DEBUG mode

---
 osu.Game.Tests/Visual/Online/TestSceneChatLink.cs | 4 ++--
 osu.Game/Online/Chat/MessageFormatter.cs          | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneChatLink.cs b/osu.Game.Tests/Visual/Online/TestSceneChatLink.cs
index ce5c38d33f..12b5f64559 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneChatLink.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneChatLink.cs
@@ -67,7 +67,7 @@ namespace osu.Game.Tests.Visual.Online
             addMessageWithChecks("dev.ppy.sh!");
             addMessageWithChecks("https://dev.ppy.sh!", 1, expectedActions: LinkAction.External);
             addMessageWithChecks("00:12:345 (1,2) - Test?", 1, expectedActions: LinkAction.OpenEditorTimestamp);
-            addMessageWithChecks("Wiki link for tasty [[Performance Points]]", 1, expectedActions: LinkAction.External);
+            addMessageWithChecks("Wiki link for tasty [[Performance Points]]", 1, expectedActions: LinkAction.OpenWiki);
             addMessageWithChecks("(osu forums)[https://dev.ppy.sh/forum] (old link format)", 1, expectedActions: LinkAction.External);
             addMessageWithChecks("[https://dev.ppy.sh/home New site] (new link format)", 1, expectedActions: LinkAction.External);
             addMessageWithChecks("[osu forums](https://dev.ppy.sh/forum) (new link format 2)", 1, expectedActions: LinkAction.External);
@@ -79,7 +79,7 @@ namespace osu.Game.Tests.Visual.Online
             addMessageWithChecks("[https://dev.ppy.sh/home New link format with escaped [and \\[ paired] braces]", 1, expectedActions: LinkAction.External);
             addMessageWithChecks("[Markdown link format with escaped [and \\[ paired] braces](https://dev.ppy.sh/home)", 1, expectedActions: LinkAction.External);
             addMessageWithChecks("(Old link format with escaped (and \\( paired) parentheses)[https://dev.ppy.sh/home] and [[also a rogue wiki link]]", 2,
-                expectedActions: new[] { LinkAction.External, LinkAction.External });
+                expectedActions: new[] { LinkAction.External, LinkAction.OpenWiki });
             // note that there's 0 links here (they get removed if a channel is not found)
             addMessageWithChecks("#lobby or #osu would be blue (and work) in the ChatDisplay test (when a proper ChatOverlay is present).");
             addMessageWithChecks("I am important!", 0, false, true);
diff --git a/osu.Game/Online/Chat/MessageFormatter.cs b/osu.Game/Online/Chat/MessageFormatter.cs
index 92911f0f51..0543c08308 100644
--- a/osu.Game/Online/Chat/MessageFormatter.cs
+++ b/osu.Game/Online/Chat/MessageFormatter.cs
@@ -262,7 +262,7 @@ namespace osu.Game.Online.Chat
             handleMatches(old_link_regex, "{1}", "{2}", result, startIndex, escapeChars: new[] { '(', ')' });
 
             // handle wiki links
-            handleMatches(wiki_regex, "{1}", "https://osu.ppy.sh/wiki/{1}", result, startIndex);
+            handleMatches(wiki_regex, "{1}", $"https://{websiteRootUrl}/wiki/{{1}}", result, startIndex);
 
             // handle bare links
             handleAdvanced(advanced_link_regex, result, startIndex);

From ef66ec462297f3680de43df9d7c2de3974ad3268 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 11 Jan 2022 17:53:15 +0900
Subject: [PATCH 1983/5547] Also fix MessageFormatter tests

---
 osu.Game.Tests/Chat/MessageFormatterTests.cs | 39 ++++++++++++++------
 osu.Game/Online/Chat/MessageFormatter.cs     |  5 ++-
 2 files changed, 31 insertions(+), 13 deletions(-)

diff --git a/osu.Game.Tests/Chat/MessageFormatterTests.cs b/osu.Game.Tests/Chat/MessageFormatterTests.cs
index af87fc17ad..8def8005f1 100644
--- a/osu.Game.Tests/Chat/MessageFormatterTests.cs
+++ b/osu.Game.Tests/Chat/MessageFormatterTests.cs
@@ -9,6 +9,21 @@ namespace osu.Game.Tests.Chat
     [TestFixture]
     public class MessageFormatterTests
     {
+        private string originalWebsiteRootUrl;
+
+        [OneTimeSetUp]
+        public void OneTimeSetUp()
+        {
+            originalWebsiteRootUrl = MessageFormatter.WebsiteRootUrl;
+            MessageFormatter.WebsiteRootUrl = "dev.ppy.sh";
+        }
+
+        [OneTimeTearDown]
+        public void OneTimeTearDown()
+        {
+            MessageFormatter.WebsiteRootUrl = originalWebsiteRootUrl;
+        }
+
         [Test]
         public void TestBareLink()
         {
@@ -32,8 +47,6 @@ namespace osu.Game.Tests.Chat
         [TestCase(LinkAction.External, "https://dev.ppy.sh/beatmapsets/discussions/123", "https://dev.ppy.sh/beatmapsets/discussions/123")]
         public void TestBeatmapLinks(LinkAction expectedAction, string expectedArg, string link)
         {
-            MessageFormatter.WebsiteRootUrl = "dev.ppy.sh";
-
             Message result = MessageFormatter.FormatMessage(new Message { Content = link });
 
             Assert.AreEqual(result.Content, result.DisplayContent);
@@ -47,7 +60,10 @@ namespace osu.Game.Tests.Chat
         [Test]
         public void TestMultipleComplexLinks()
         {
-            Message result = MessageFormatter.FormatMessage(new Message { Content = "This is a http://test.io/link#fragment. (see https://twitter.com). Also, This string should not be altered. http://example.com/" });
+            Message result = MessageFormatter.FormatMessage(new Message
+            {
+                Content = "This is a http://test.io/link#fragment. (see https://twitter.com). Also, This string should not be altered. http://example.com/"
+            });
 
             Assert.AreEqual(result.Content, result.DisplayContent);
             Assert.AreEqual(3, result.Links.Count);
@@ -104,7 +120,7 @@ namespace osu.Game.Tests.Chat
 
             Assert.AreEqual("This is a Wiki Link.", result.DisplayContent);
             Assert.AreEqual(1, result.Links.Count);
-            Assert.AreEqual("https://osu.ppy.sh/wiki/Wiki Link", result.Links[0].Url);
+            Assert.AreEqual("https://dev.ppy.sh/wiki/Wiki Link", result.Links[0].Url);
             Assert.AreEqual(10, result.Links[0].Index);
             Assert.AreEqual(9, result.Links[0].Length);
         }
@@ -117,15 +133,15 @@ namespace osu.Game.Tests.Chat
             Assert.AreEqual("This is a Wiki Link Wiki:LinkWiki.Link.", result.DisplayContent);
             Assert.AreEqual(3, result.Links.Count);
 
-            Assert.AreEqual("https://osu.ppy.sh/wiki/Wiki Link", result.Links[0].Url);
+            Assert.AreEqual("https://dev.ppy.sh/wiki/Wiki Link", result.Links[0].Url);
             Assert.AreEqual(10, result.Links[0].Index);
             Assert.AreEqual(9, result.Links[0].Length);
 
-            Assert.AreEqual("https://osu.ppy.sh/wiki/Wiki:Link", result.Links[1].Url);
+            Assert.AreEqual("https://dev.ppy.sh/wiki/Wiki:Link", result.Links[1].Url);
             Assert.AreEqual(20, result.Links[1].Index);
             Assert.AreEqual(9, result.Links[1].Length);
 
-            Assert.AreEqual("https://osu.ppy.sh/wiki/Wiki.Link", result.Links[2].Url);
+            Assert.AreEqual("https://dev.ppy.sh/wiki/Wiki.Link", result.Links[2].Url);
             Assert.AreEqual(29, result.Links[2].Index);
             Assert.AreEqual(9, result.Links[2].Length);
         }
@@ -445,12 +461,15 @@ namespace osu.Game.Tests.Chat
         [Test]
         public void TestLinkComplex()
         {
-            Message result = MessageFormatter.FormatMessage(new Message { Content = "This is a [http://www.simple-test.com simple test] with some [traps] and [[wiki links]]. Don't forget to visit https://osu.ppy.sh (now!)[http://google.com]\uD83D\uDE12" });
+            Message result = MessageFormatter.FormatMessage(new Message
+            {
+                Content = "This is a [http://www.simple-test.com simple test] with some [traps] and [[wiki links]]. Don't forget to visit https://osu.ppy.sh (now!)[http://google.com]\uD83D\uDE12"
+            });
 
             Assert.AreEqual("This is a simple test with some [traps] and wiki links. Don't forget to visit https://osu.ppy.sh now!\0\0\0", result.DisplayContent);
             Assert.AreEqual(5, result.Links.Count);
 
-            Link f = result.Links.Find(l => l.Url == "https://osu.ppy.sh/wiki/wiki links");
+            Link f = result.Links.Find(l => l.Url == "https://dev.ppy.sh/wiki/wiki links");
             Assert.That(f, Is.Not.Null);
             Assert.AreEqual(44, f.Index);
             Assert.AreEqual(10, f.Length);
@@ -514,8 +533,6 @@ namespace osu.Game.Tests.Chat
         [TestCase("https://dev.ppy.sh/home/changelog/lazer/2021.1012", "lazer/2021.1012")]
         public void TestChangelogLinks(string link, string expectedArg)
         {
-            MessageFormatter.WebsiteRootUrl = "dev.ppy.sh";
-
             LinkDetails result = MessageFormatter.GetLinkDetails(link);
 
             Assert.AreEqual(LinkAction.OpenChangelog, result.Action);
diff --git a/osu.Game/Online/Chat/MessageFormatter.cs b/osu.Game/Online/Chat/MessageFormatter.cs
index 0543c08308..d7974004b1 100644
--- a/osu.Game/Online/Chat/MessageFormatter.cs
+++ b/osu.Game/Online/Chat/MessageFormatter.cs
@@ -57,6 +57,7 @@ namespace osu.Game.Online.Chat
         /// </summary>
         public static string WebsiteRootUrl
         {
+            get => websiteRootUrl;
             set => websiteRootUrl = value
                                     .Trim('/') // trim potential trailing slash/
                                     .Split('/').Last(); // only keep domain name, ignoring protocol.
@@ -134,7 +135,7 @@ namespace osu.Game.Online.Chat
                 case "http":
                 case "https":
                     // length > 3 since all these links need another argument to work
-                    if (args.Length > 3 && args[1].EndsWith(websiteRootUrl, StringComparison.OrdinalIgnoreCase))
+                    if (args.Length > 3 && args[1].EndsWith(WebsiteRootUrl, StringComparison.OrdinalIgnoreCase))
                     {
                         string mainArg = args[3];
 
@@ -262,7 +263,7 @@ namespace osu.Game.Online.Chat
             handleMatches(old_link_regex, "{1}", "{2}", result, startIndex, escapeChars: new[] { '(', ')' });
 
             // handle wiki links
-            handleMatches(wiki_regex, "{1}", $"https://{websiteRootUrl}/wiki/{{1}}", result, startIndex);
+            handleMatches(wiki_regex, "{1}", $"https://{WebsiteRootUrl}/wiki/{{1}}", result, startIndex);
 
             // handle bare links
             handleAdvanced(advanced_link_regex, result, startIndex);

From 906e700b60900e41809d8e0334e12201b667074f Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 11 Jan 2022 21:22:16 +0900
Subject: [PATCH 1984/5547] Improve quality of beatmap background blurs

---
 osu.Game/Graphics/Backgrounds/Background.cs | 48 ++++++++++++++++++---
 1 file changed, 43 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Graphics/Backgrounds/Background.cs b/osu.Game/Graphics/Backgrounds/Background.cs
index 353054a1f1..b09ec1d9b9 100644
--- a/osu.Game/Graphics/Backgrounds/Background.cs
+++ b/osu.Game/Graphics/Backgrounds/Background.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.Graphics;
 using osu.Framework.Graphics.Containers;
@@ -17,8 +18,6 @@ namespace osu.Game.Graphics.Backgrounds
     /// </summary>
     public class Background : CompositeDrawable, IEquatable<Background>
     {
-        private const float blur_scale = 0.5f;
-
         public readonly Sprite Sprite;
 
         private readonly string textureName;
@@ -46,7 +45,7 @@ namespace osu.Game.Graphics.Backgrounds
                 Sprite.Texture = textures.Get(textureName);
         }
 
-        public Vector2 BlurSigma => bufferedContainer?.BlurSigma / blur_scale ?? Vector2.Zero;
+        public Vector2 BlurSigma => Vector2.Divide(bufferedContainer?.BlurSigma ?? Vector2.Zero, blurScale);
 
         /// <summary>
         /// Smoothly adjusts <see cref="IBufferedContainer.BlurSigma"/> over time.
@@ -67,9 +66,48 @@ namespace osu.Game.Graphics.Backgrounds
             }
 
             if (bufferedContainer != null)
-                bufferedContainer.FrameBufferScale = newBlurSigma == Vector2.Zero ? Vector2.One : new Vector2(blur_scale);
+                transformBlurSigma(newBlurSigma, duration, easing);
+        }
 
-            bufferedContainer?.BlurTo(newBlurSigma * blur_scale, duration, easing);
+        private void transformBlurSigma(Vector2 newBlurSigma, double duration, Easing easing)
+            => this.TransformTo(nameof(blurSigma), newBlurSigma, duration, easing);
+
+        private Vector2 blurSigmaBacking = Vector2.Zero;
+        private Vector2 blurScale = Vector2.One;
+
+        private Vector2 blurSigma
+        {
+            get => blurSigmaBacking;
+            set
+            {
+                Debug.Assert(bufferedContainer != null);
+
+                blurSigmaBacking = value;
+                blurScale = new Vector2(calculateBlurDownscale(value.X), calculateBlurDownscale(value.Y));
+
+                bufferedContainer.FrameBufferScale = blurScale;
+                bufferedContainer.BlurSigma = value * blurScale; // If the image is scaled down, the blur radius also needs to be reduced to cover the same pixel block.
+            }
+        }
+
+        /// <summary>
+        /// Determines a factor to downscale the background based on a given blur sigma, in order to reduce the computational complexity of blurs.
+        /// </summary>
+        /// <param name="sigma">The blur sigma.</param>
+        /// <returns>The scale-down factor.</returns>
+        private float calculateBlurDownscale(float sigma)
+        {
+            // If we're blurring within one pixel, scaling down will always result in an undesirable loss of quality.
+            // The algorithm below would also cause this value to go above 1, which is likewise undesirable.
+            if (sigma <= 1)
+                return 1;
+
+            // A good value is one where the loss in quality as a result of downscaling the image is not easily perceivable.
+            // The constants here have been experimentally chosen to yield nice transitions by approximating a log curve through the points {{ 1, 1 }, { 4, 0.75 }, { 16, 0.5 }, { 32, 0.25 }}.
+            float scale = -0.18f * MathF.Log(0.004f * sigma);
+
+            // To reduce shimmering, the scaling transitions are limited to happen only in increments of 0.2.
+            return MathF.Round(scale / 0.2f, MidpointRounding.AwayFromZero) * 0.2f;
         }
 
         public virtual bool Equals(Background other)

From 60e42bf45eac844f656602b3074a8fdcc2f995b7 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 11 Jan 2022 23:01:17 +0900
Subject: [PATCH 1985/5547] Add lenience to fix test failures

---
 .../Visual/Background/TestSceneUserDimBackgrounds.cs       | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Tests/Visual/Background/TestSceneUserDimBackgrounds.cs b/osu.Game.Tests/Visual/Background/TestSceneUserDimBackgrounds.cs
index 54c5c252c0..b1f642b909 100644
--- a/osu.Game.Tests/Visual/Background/TestSceneUserDimBackgrounds.cs
+++ b/osu.Game.Tests/Visual/Background/TestSceneUserDimBackgrounds.cs
@@ -14,6 +14,7 @@ using osu.Framework.Input.Events;
 using osu.Framework.Input.States;
 using osu.Framework.Platform;
 using osu.Framework.Screens;
+using osu.Framework.Utils;
 using osu.Game.Beatmaps;
 using osu.Game.Configuration;
 using osu.Game.Graphics;
@@ -323,7 +324,7 @@ namespace osu.Game.Tests.Visual.Background
 
             public bool IsBackgroundUndimmed() => background.CurrentColour == Color4.White;
 
-            public bool IsUserBlurApplied() => background.CurrentBlur == new Vector2((float)BlurLevel.Value * BackgroundScreenBeatmap.USER_BLUR_FACTOR);
+            public bool IsUserBlurApplied() => Precision.AlmostEquals(background.CurrentBlur, new Vector2((float)BlurLevel.Value * BackgroundScreenBeatmap.USER_BLUR_FACTOR), 0.1f);
 
             public bool IsUserBlurDisabled() => background.CurrentBlur == new Vector2(0);
 
@@ -331,9 +332,9 @@ namespace osu.Game.Tests.Visual.Background
 
             public bool IsBackgroundVisible() => background.CurrentAlpha == 1;
 
-            public bool IsBackgroundBlur() => background.CurrentBlur == new Vector2(BACKGROUND_BLUR);
+            public bool IsBackgroundBlur() => Precision.AlmostEquals(background.CurrentBlur, new Vector2(BACKGROUND_BLUR), 0.1f);
 
-            public bool CheckBackgroundBlur(Vector2 expected) => background.CurrentBlur == expected;
+            public bool CheckBackgroundBlur(Vector2 expected) => Precision.AlmostEquals(background.CurrentBlur, expected, 0.1f);
 
             /// <summary>
             /// Make sure every time a screen gets pushed, the background doesn't get replaced

From a8c3fdd3835e53cf131f4e7667bb06d3d7930c50 Mon Sep 17 00:00:00 2001
From: r00ster <r00ster91@protonmail.com>
Date: Tue, 11 Jan 2022 16:11:07 +0100
Subject: [PATCH 1986/5547] Update outdated OpenTabletDriver FAQ links

---
 osu.Game/Overlays/Settings/Sections/Input/TabletSettings.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Overlays/Settings/Sections/Input/TabletSettings.cs b/osu.Game/Overlays/Settings/Sections/Input/TabletSettings.cs
index c94b418331..802d442ced 100644
--- a/osu.Game/Overlays/Settings/Sections/Input/TabletSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Input/TabletSettings.cs
@@ -107,8 +107,8 @@ namespace osu.Game.Overlays.Settings.Sections.Input
                                 t.NewLine();
                                 t.AddText("If your tablet is not detected, please read ");
                                 t.AddLink("this FAQ", LinkAction.External, RuntimeInfo.OS == RuntimeInfo.Platform.Windows
-                                    ? @"https://github.com/OpenTabletDriver/OpenTabletDriver/wiki/Windows-FAQ"
-                                    : @"https://github.com/OpenTabletDriver/OpenTabletDriver/wiki/Linux-FAQ");
+                                    ? @"https://opentabletdriver.net/Wiki/FAQ/Windows"
+                                    : @"https://opentabletdriver.net/Wiki/FAQ/Linux");
                                 t.AddText(" for troubleshooting steps.");
                             }
                         }),

From e91d3dd8b4b5dfaba5adf41f649dcb0fd4802949 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 11 Jan 2022 21:21:04 +0100
Subject: [PATCH 1987/5547] Add failing test for incorrect sample control point
 time after paste

---
 .../Visual/Editing/TestSceneEditorClipboard.cs           | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneEditorClipboard.cs b/osu.Game.Tests/Visual/Editing/TestSceneEditorClipboard.cs
index 3aff74a0a8..e41f8372b4 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneEditorClipboard.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneEditorClipboard.cs
@@ -4,6 +4,7 @@
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Testing;
+using osu.Framework.Utils;
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Edit;
@@ -85,11 +86,17 @@ namespace osu.Game.Tests.Visual.Editing
 
             AddAssert("is one object", () => EditorBeatmap.HitObjects.Count == 1);
 
+            Slider slider = null;
+            AddStep("retrieve slider", () => slider = (Slider)EditorBeatmap.HitObjects.Single());
             AddAssert("path matches", () =>
             {
-                var path = ((Slider)EditorBeatmap.HitObjects.Single()).Path;
+                var path = slider.Path;
                 return path.ControlPoints.Count == 2 && path.ControlPoints.SequenceEqual(addedObject.Path.ControlPoints);
             });
+
+            // see `HitObject.control_point_leniency`.
+            AddAssert("sample control point has correct time", () => Precision.AlmostEquals(slider.SampleControlPoint.Time, slider.GetEndTime(), 1));
+            AddAssert("difficulty control point has correct time", () => slider.DifficultyControlPoint.Time == slider.StartTime);
         }
 
         [Test]

From 7a25fe79b71c8c6ca7f08d9934ca4107a1b0fb36 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 11 Jan 2022 21:27:22 +0100
Subject: [PATCH 1988/5547] Fix sample control point time being calculated
 before defaults applied

In editor contexts, the `StartTimeBindable` subscription in `HitObject`
was firing before defaults were applied, which in the case of sliders
manifested in an infinite end time. `ApplyDefaults()` also did not
always set the time of the control point to the correct value, which
matters when the beatmap is encoded.

Ensure that the control points receive the correct time values during
default application, and only register the `StartTimeBindable` change
callback after defaults have been successfully applied.
---
 osu.Game/Rulesets/Objects/HitObject.cs | 44 ++++++++++++--------------
 1 file changed, 21 insertions(+), 23 deletions(-)

diff --git a/osu.Game/Rulesets/Objects/HitObject.cs b/osu.Game/Rulesets/Objects/HitObject.cs
index a80b3d0fa5..e63ccbc0d3 100644
--- a/osu.Game/Rulesets/Objects/HitObject.cs
+++ b/osu.Game/Rulesets/Objects/HitObject.cs
@@ -87,23 +87,6 @@ namespace osu.Game.Rulesets.Objects
         [JsonIgnore]
         public SlimReadOnlyListWrapper<HitObject> NestedHitObjects => nestedHitObjects.AsSlimReadOnly();
 
-        public HitObject()
-        {
-            StartTimeBindable.ValueChanged += time =>
-            {
-                double offset = time.NewValue - time.OldValue;
-
-                foreach (var nested in nestedHitObjects)
-                    nested.StartTime += offset;
-
-                if (DifficultyControlPoint != DifficultyControlPoint.DEFAULT)
-                    DifficultyControlPoint.Time = time.NewValue;
-
-                if (SampleControlPoint != SampleControlPoint.DEFAULT)
-                    SampleControlPoint.Time = this.GetEndTime() + control_point_leniency;
-            };
-        }
-
         /// <summary>
         /// Applies default values to this HitObject.
         /// </summary>
@@ -115,24 +98,22 @@ namespace osu.Game.Rulesets.Objects
             var legacyInfo = controlPointInfo as LegacyControlPointInfo;
 
             if (legacyInfo != null)
-            {
                 DifficultyControlPoint = (DifficultyControlPoint)legacyInfo.DifficultyPointAt(StartTime).DeepClone();
-                DifficultyControlPoint.Time = StartTime;
-            }
             else if (DifficultyControlPoint == DifficultyControlPoint.DEFAULT)
                 DifficultyControlPoint = new DifficultyControlPoint();
 
+            DifficultyControlPoint.Time = StartTime;
+
             ApplyDefaultsToSelf(controlPointInfo, difficulty);
 
             // This is done here after ApplyDefaultsToSelf as we may require custom defaults to be applied to have an accurate end time.
             if (legacyInfo != null)
-            {
                 SampleControlPoint = (SampleControlPoint)legacyInfo.SamplePointAt(this.GetEndTime() + control_point_leniency).DeepClone();
-                SampleControlPoint.Time = this.GetEndTime() + control_point_leniency;
-            }
             else if (SampleControlPoint == SampleControlPoint.DEFAULT)
                 SampleControlPoint = new SampleControlPoint();
 
+            SampleControlPoint.Time = this.GetEndTime() + control_point_leniency;
+
             nestedHitObjects.Clear();
 
             CreateNestedHitObjects(cancellationToken);
@@ -155,6 +136,23 @@ namespace osu.Game.Rulesets.Objects
             foreach (var h in nestedHitObjects)
                 h.ApplyDefaults(controlPointInfo, difficulty, cancellationToken);
 
+            // importantly, this callback is only registered after default application
+            // to ensure that the read of `this.GetEndTime()` within doesn't return an invalid value
+            // if `StartTimeBindable` is changed prior to default application.
+            StartTimeBindable.ValueChanged += time =>
+            {
+                double offset = time.NewValue - time.OldValue;
+
+                foreach (var nested in nestedHitObjects)
+                    nested.StartTime += offset;
+
+                if (DifficultyControlPoint != DifficultyControlPoint.DEFAULT)
+                    DifficultyControlPoint.Time = time.NewValue;
+
+                if (SampleControlPoint != SampleControlPoint.DEFAULT)
+                    SampleControlPoint.Time = this.GetEndTime() + control_point_leniency;
+            };
+
             DefaultsApplied?.Invoke(this);
         }
 

From 76d5225bb9ee9bfcc599bf9ec6f769c3658a4b3c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 11 Jan 2022 22:00:04 +0100
Subject: [PATCH 1989/5547] Rewrite storyboard clock management in slightly
 different way

---
 .../Backgrounds/BeatmapBackgroundWithStoryboard.cs    | 11 ++++++++---
 1 file changed, 8 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Graphics/Backgrounds/BeatmapBackgroundWithStoryboard.cs b/osu.Game/Graphics/Backgrounds/BeatmapBackgroundWithStoryboard.cs
index c5c8a25f4a..56ef87c1f4 100644
--- a/osu.Game/Graphics/Backgrounds/BeatmapBackgroundWithStoryboard.cs
+++ b/osu.Game/Graphics/Backgrounds/BeatmapBackgroundWithStoryboard.cs
@@ -15,7 +15,7 @@ namespace osu.Game.Graphics.Backgrounds
 {
     public class BeatmapBackgroundWithStoryboard : BeatmapBackground
     {
-        private InterpolatingFramedClock storyboardClock = null!;
+        private readonly InterpolatingFramedClock storyboardClock;
 
         [Resolved(CanBeNull = true)]
         private MusicController? musicController { get; set; }
@@ -23,6 +23,7 @@ namespace osu.Game.Graphics.Backgrounds
         public BeatmapBackgroundWithStoryboard(WorkingBeatmap beatmap, string fallbackTextureName = "Backgrounds/bg1")
             : base(beatmap, fallbackTextureName)
         {
+            storyboardClock = new InterpolatingFramedClock();
         }
 
         [BackgroundDependencyLoader]
@@ -38,7 +39,7 @@ namespace osu.Game.Graphics.Backgrounds
             {
                 RelativeSizeAxes = Axes.Both,
                 Volume = { Value = 0 },
-                Child = new DrawableStoryboard(Beatmap.Storyboard) { Clock = storyboardClock = new InterpolatingFramedClock(Beatmap.Track) }
+                Child = new DrawableStoryboard(Beatmap.Storyboard) { Clock = storyboardClock }
             }, AddInternal);
         }
 
@@ -47,9 +48,13 @@ namespace osu.Game.Graphics.Backgrounds
             base.LoadComplete();
             if (musicController != null)
                 musicController.TrackChanged += onTrackChanged;
+
+            updateStoryboardClockSource(Beatmap);
         }
 
-        private void onTrackChanged(WorkingBeatmap newBeatmap, TrackChangeDirection _)
+        private void onTrackChanged(WorkingBeatmap newBeatmap, TrackChangeDirection _) => updateStoryboardClockSource(newBeatmap);
+
+        private void updateStoryboardClockSource(WorkingBeatmap newBeatmap)
         {
             if (newBeatmap != Beatmap)
                 return;

From 80ccff90689601ce449ac574ab777666ae953678 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 11 Jan 2022 22:12:23 +0100
Subject: [PATCH 1990/5547] Remove no longer necessary guards against default
 control points

The subscription in which the guards were present was moved from
constructor to `ApplyDefaults()`, and at that point neither the sample
control point or the difficulty point can be the default point, because
there are explicit paths that overwrite those with blank points in the
same methods, prior to the subscription's registration.

The only worry would be that someone would set the default point on the
object themselves, but at that point that is most likely programmer
error anyhow.
---
 osu.Game/Rulesets/Objects/HitObject.cs | 7 ++-----
 1 file changed, 2 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Rulesets/Objects/HitObject.cs b/osu.Game/Rulesets/Objects/HitObject.cs
index e63ccbc0d3..7d08261035 100644
--- a/osu.Game/Rulesets/Objects/HitObject.cs
+++ b/osu.Game/Rulesets/Objects/HitObject.cs
@@ -146,11 +146,8 @@ namespace osu.Game.Rulesets.Objects
                 foreach (var nested in nestedHitObjects)
                     nested.StartTime += offset;
 
-                if (DifficultyControlPoint != DifficultyControlPoint.DEFAULT)
-                    DifficultyControlPoint.Time = time.NewValue;
-
-                if (SampleControlPoint != SampleControlPoint.DEFAULT)
-                    SampleControlPoint.Time = this.GetEndTime() + control_point_leniency;
+                DifficultyControlPoint.Time = time.NewValue;
+                SampleControlPoint.Time = this.GetEndTime() + control_point_leniency;
             };
 
             DefaultsApplied?.Invoke(this);

From a0842838e7aa880a8ce34621b2a0e77178457667 Mon Sep 17 00:00:00 2001
From: Susko3 <16479013+Susko3@users.noreply.github.com>
Date: Wed, 12 Jan 2022 00:15:17 +0100
Subject: [PATCH 1991/5547] Add `AllowIme => false` where applicable

Also adds `AllowWordNavigation => false` to password text box.
---
 osu.Game/Graphics/UserInterface/OsuNumberBox.cs         | 2 ++
 osu.Game/Graphics/UserInterface/OsuPasswordTextBox.cs   | 4 ++++
 osu.Game/Overlays/Settings/SettingsNumberBox.cs         | 2 ++
 osu.Game/Screens/Edit/Setup/LabelledRomanisedTextBox.cs | 2 ++
 4 files changed, 10 insertions(+)

diff --git a/osu.Game/Graphics/UserInterface/OsuNumberBox.cs b/osu.Game/Graphics/UserInterface/OsuNumberBox.cs
index 3d565a4464..8a3b77d3c2 100644
--- a/osu.Game/Graphics/UserInterface/OsuNumberBox.cs
+++ b/osu.Game/Graphics/UserInterface/OsuNumberBox.cs
@@ -7,6 +7,8 @@ namespace osu.Game.Graphics.UserInterface
 {
     public class OsuNumberBox : OsuTextBox
     {
+        protected override bool AllowIme => false;
+
         protected override bool CanAddCharacter(char character) => character.IsAsciiDigit();
     }
 }
diff --git a/osu.Game/Graphics/UserInterface/OsuPasswordTextBox.cs b/osu.Game/Graphics/UserInterface/OsuPasswordTextBox.cs
index 8e82f4a7c1..b276159558 100644
--- a/osu.Game/Graphics/UserInterface/OsuPasswordTextBox.cs
+++ b/osu.Game/Graphics/UserInterface/OsuPasswordTextBox.cs
@@ -29,6 +29,10 @@ namespace osu.Game.Graphics.UserInterface
 
         protected override bool AllowClipboardExport => false;
 
+        protected override bool AllowWordNavigation => false;
+
+        protected override bool AllowIme => false;
+
         private readonly CapsWarning warning;
 
         [Resolved]
diff --git a/osu.Game/Overlays/Settings/SettingsNumberBox.cs b/osu.Game/Overlays/Settings/SettingsNumberBox.cs
index cc4446033a..d931c53e73 100644
--- a/osu.Game/Overlays/Settings/SettingsNumberBox.cs
+++ b/osu.Game/Overlays/Settings/SettingsNumberBox.cs
@@ -68,6 +68,8 @@ namespace osu.Game.Overlays.Settings
 
         private class OutlinedNumberBox : OutlinedTextBox
         {
+            protected override bool AllowIme => false;
+
             protected override bool CanAddCharacter(char character) => character.IsAsciiDigit();
 
             public new void NotifyInputError() => base.NotifyInputError();
diff --git a/osu.Game/Screens/Edit/Setup/LabelledRomanisedTextBox.cs b/osu.Game/Screens/Edit/Setup/LabelledRomanisedTextBox.cs
index ee9d86029e..c39b4d6f41 100644
--- a/osu.Game/Screens/Edit/Setup/LabelledRomanisedTextBox.cs
+++ b/osu.Game/Screens/Edit/Setup/LabelledRomanisedTextBox.cs
@@ -13,6 +13,8 @@ namespace osu.Game.Screens.Edit.Setup
 
         private class RomanisedTextBox : OsuTextBox
         {
+            protected override bool AllowIme => false;
+
             protected override bool CanAddCharacter(char character)
                 => MetadataUtils.IsRomanised(character);
         }

From 11e07c1137303f0e9c132b5ee684c356d8bac3f7 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 12 Jan 2022 15:20:48 +0900
Subject: [PATCH 1992/5547] Add button to compact realm on demand

In general we're doing things correctly so the realm file shouldn't
expand (unless mass deletions are made from it), but this is a nice way
to manually confirm the behaviour.

Sometimes if using realm studio with osu! running, for instance, the
realm file size can blow out of proportion. This will recover from such
cases.

Note that calling `RealmFactory.Compact` itself is not enough, as it
will fail unless all instances of the realm have been closed.
---
 osu.Game/Localisation/DebugSettingsStrings.cs      |  5 +++++
 .../Sections/DebugSettings/MemorySettings.cs       | 14 +++++++++++++-
 2 files changed, 18 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Localisation/DebugSettingsStrings.cs b/osu.Game/Localisation/DebugSettingsStrings.cs
index dd21739096..74b2c8d892 100644
--- a/osu.Game/Localisation/DebugSettingsStrings.cs
+++ b/osu.Game/Localisation/DebugSettingsStrings.cs
@@ -44,6 +44,11 @@ namespace osu.Game.Localisation
         /// </summary>
         public static LocalisableString ClearAllCaches => new TranslatableString(getKey(@"clear_all_caches"), @"Clear all caches");
 
+        /// <summary>
+        /// "Compact realm"
+        /// </summary>
+        public static LocalisableString CompactRealm => new TranslatableString(getKey(@"compact_realm"), @"Compact realm");
+
         private static string getKey(string key) => $"{prefix}:{key}";
     }
 }
diff --git a/osu.Game/Overlays/Settings/Sections/DebugSettings/MemorySettings.cs b/osu.Game/Overlays/Settings/Sections/DebugSettings/MemorySettings.cs
index 6f48768dcd..eb6e48dfbf 100644
--- a/osu.Game/Overlays/Settings/Sections/DebugSettings/MemorySettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/DebugSettings/MemorySettings.cs
@@ -6,6 +6,7 @@ using osu.Framework.Configuration;
 using osu.Framework.Graphics;
 using osu.Framework.Localisation;
 using osu.Framework.Platform;
+using osu.Game.Database;
 using osu.Game.Localisation;
 
 namespace osu.Game.Overlays.Settings.Sections.DebugSettings
@@ -15,7 +16,7 @@ namespace osu.Game.Overlays.Settings.Sections.DebugSettings
         protected override LocalisableString Header => DebugSettingsStrings.MemoryHeader;
 
         [BackgroundDependencyLoader]
-        private void load(FrameworkDebugConfigManager config, GameHost host)
+        private void load(FrameworkDebugConfigManager config, GameHost host, RealmContextFactory realmFactory)
         {
             Children = new Drawable[]
             {
@@ -24,6 +25,17 @@ namespace osu.Game.Overlays.Settings.Sections.DebugSettings
                     Text = DebugSettingsStrings.ClearAllCaches,
                     Action = host.Collect
                 },
+                new SettingsButton
+                {
+                    Text = DebugSettingsStrings.CompactRealm,
+                    Action = () =>
+                    {
+                        // Blocking operations implicitly causes a Compact().
+                        using (realmFactory.BlockAllOperations())
+                        {
+                        }
+                    }
+                },
             };
         }
     }

From c383f26729e3632a9d1e0567234435249652facc Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 22 Nov 2021 15:59:12 +0900
Subject: [PATCH 1993/5547] Remove EF specific tests that have since been
 replaced

---
 .../Beatmaps/IO/ImportBeatmapTest.cs          | 975 +-----------------
 1 file changed, 3 insertions(+), 972 deletions(-)

diff --git a/osu.Game.Tests/Beatmaps/IO/ImportBeatmapTest.cs b/osu.Game.Tests/Beatmaps/IO/ImportBeatmapTest.cs
index c02141bf9f..da414dcf8d 100644
--- a/osu.Game.Tests/Beatmaps/IO/ImportBeatmapTest.cs
+++ b/osu.Game.Tests/Beatmaps/IO/ImportBeatmapTest.cs
@@ -2,983 +2,24 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
-using System.IO;
 using System.Collections.Generic;
+using System.IO;
 using System.Linq;
 using System.Threading;
 using System.Threading.Tasks;
 using NUnit.Framework;
-using osu.Framework.Platform;
-using osu.Game.IPC;
 using osu.Framework.Allocation;
 using osu.Framework.Extensions;
-using osu.Framework.Extensions.ObjectExtensions;
-using osu.Framework.Logging;
 using osu.Game.Beatmaps;
 using osu.Game.Database;
-using osu.Game.Extensions;
-using osu.Game.IO;
-using osu.Game.Online.API.Requests.Responses;
-using osu.Game.Overlays.Notifications;
-using osu.Game.Rulesets.Osu;
-using osu.Game.Rulesets.Osu.Objects;
-using osu.Game.Scoring;
 using osu.Game.Tests.Resources;
-using osu.Game.Tests.Scores.IO;
-using SharpCompress.Archives;
-using SharpCompress.Archives.Zip;
-using SharpCompress.Common;
-using SharpCompress.Writers.Zip;
-using FileInfo = System.IO.FileInfo;
 
 namespace osu.Game.Tests.Beatmaps.IO
 {
     [TestFixture]
     public class ImportBeatmapTest : ImportTest
     {
-        [Test]
-        public async Task TestImportWhenClosed()
-        {
-            // unfortunately for the time being we need to reference osu.Framework.Desktop for a game host here.
-            using (HeadlessGameHost host = new CleanRunHeadlessGameHost())
-            {
-                try
-                {
-                    await LoadOszIntoOsu(LoadOsuIntoHost(host));
-                }
-                finally
-                {
-                    host.Exit();
-                }
-            }
-        }
-
-        [Test]
-        public async Task TestImportThenDelete()
-        {
-            // unfortunately for the time being we need to reference osu.Framework.Desktop for a game host here.
-            using (HeadlessGameHost host = new CleanRunHeadlessGameHost())
-            {
-                try
-                {
-                    var osu = LoadOsuIntoHost(host);
-
-                    var imported = await LoadOszIntoOsu(osu);
-
-                    deleteBeatmapSet(imported, osu);
-                }
-                finally
-                {
-                    host.Exit();
-                }
-            }
-        }
-
-        [Test]
-        public async Task TestImportThenDeleteFromStream()
-        {
-            // unfortunately for the time being we need to reference osu.Framework.Desktop for a game host here.
-            using (HeadlessGameHost host = new CleanRunHeadlessGameHost())
-            {
-                try
-                {
-                    var osu = LoadOsuIntoHost(host);
-
-                    string tempPath = TestResources.GetTestBeatmapForImport();
-
-                    var manager = osu.Dependencies.Get<BeatmapManager>();
-
-                    ILive<BeatmapSetInfo> importedSet;
-
-                    using (var stream = File.OpenRead(tempPath))
-                    {
-                        importedSet = await manager.Import(new ImportTask(stream, Path.GetFileName(tempPath)));
-                        await ensureLoaded(osu);
-                    }
-
-                    Assert.IsTrue(File.Exists(tempPath), "Stream source file somehow went missing");
-                    File.Delete(tempPath);
-
-                    var imported = manager.GetAllUsableBeatmapSets().Find(beatmapSet => beatmapSet.ID == importedSet.Value.ID);
-
-                    deleteBeatmapSet(imported, osu);
-                }
-                finally
-                {
-                    host.Exit();
-                }
-            }
-        }
-
-        [Test]
-        public async Task TestImportThenImport()
-        {
-            // unfortunately for the time being we need to reference osu.Framework.Desktop for a game host here.
-            using (HeadlessGameHost host = new CleanRunHeadlessGameHost())
-            {
-                try
-                {
-                    var osu = LoadOsuIntoHost(host);
-
-                    var imported = await LoadOszIntoOsu(osu);
-                    var importedSecondTime = await LoadOszIntoOsu(osu);
-
-                    // check the newly "imported" beatmap is actually just the restored previous import. since it matches hash.
-                    Assert.IsTrue(imported.ID == importedSecondTime.ID);
-                    Assert.IsTrue(imported.Beatmaps.First().ID == importedSecondTime.Beatmaps.First().ID);
-
-                    checkBeatmapSetCount(osu, 1);
-                    checkSingleReferencedFileCount(osu, 18);
-                }
-                finally
-                {
-                    host.Exit();
-                }
-            }
-        }
-
-        [Test]
-        public async Task TestImportThenImportWithReZip()
-        {
-            using (HeadlessGameHost host = new CleanRunHeadlessGameHost())
-            {
-                try
-                {
-                    var osu = LoadOsuIntoHost(host);
-
-                    string temp = TestResources.GetTestBeatmapForImport();
-
-                    string extractedFolder = $"{temp}_extracted";
-                    Directory.CreateDirectory(extractedFolder);
-
-                    try
-                    {
-                        var imported = await LoadOszIntoOsu(osu);
-
-                        string hashBefore = hashFile(temp);
-
-                        using (var zip = ZipArchive.Open(temp))
-                            zip.WriteToDirectory(extractedFolder);
-
-                        using (var zip = ZipArchive.Create())
-                        {
-                            zip.AddAllFromDirectory(extractedFolder);
-                            zip.SaveTo(temp, new ZipWriterOptions(CompressionType.Deflate));
-                        }
-
-                        // zip files differ because different compression or encoder.
-                        Assert.AreNotEqual(hashBefore, hashFile(temp));
-
-                        var importedSecondTime = await osu.Dependencies.Get<BeatmapManager>().Import(new ImportTask(temp));
-
-                        await ensureLoaded(osu);
-
-                        // but contents doesn't, so existing should still be used.
-                        Assert.IsTrue(imported.ID == importedSecondTime.Value.ID);
-                        Assert.IsTrue(imported.Beatmaps.First().ID == importedSecondTime.Value.Beatmaps.First().ID);
-                    }
-                    finally
-                    {
-                        Directory.Delete(extractedFolder, true);
-                    }
-                }
-                finally
-                {
-                    host.Exit();
-                }
-            }
-        }
-
-        [Test]
-        public async Task TestImportThenImportWithChangedHashedFile()
-        {
-            using (HeadlessGameHost host = new CleanRunHeadlessGameHost())
-            {
-                try
-                {
-                    var osu = LoadOsuIntoHost(host);
-
-                    string temp = TestResources.GetTestBeatmapForImport();
-
-                    string extractedFolder = $"{temp}_extracted";
-                    Directory.CreateDirectory(extractedFolder);
-
-                    try
-                    {
-                        var imported = await LoadOszIntoOsu(osu);
-
-                        await createScoreForBeatmap(osu, imported.Beatmaps.First());
-
-                        using (var zip = ZipArchive.Open(temp))
-                            zip.WriteToDirectory(extractedFolder);
-
-                        // arbitrary write to hashed file
-                        // this triggers the special BeatmapManager.PreImport deletion/replacement flow.
-                        using (var sw = new FileInfo(Directory.GetFiles(extractedFolder, "*.osu").First()).AppendText())
-                            await sw.WriteLineAsync("// changed");
-
-                        using (var zip = ZipArchive.Create())
-                        {
-                            zip.AddAllFromDirectory(extractedFolder);
-                            zip.SaveTo(temp, new ZipWriterOptions(CompressionType.Deflate));
-                        }
-
-                        var importedSecondTime = await osu.Dependencies.Get<BeatmapManager>().Import(new ImportTask(temp));
-
-                        await ensureLoaded(osu);
-
-                        // check the newly "imported" beatmap is not the original.
-                        Assert.IsTrue(imported.ID != importedSecondTime.Value.ID);
-                        Assert.IsTrue(imported.Beatmaps.First().ID != importedSecondTime.Value.Beatmaps.First().ID);
-                    }
-                    finally
-                    {
-                        Directory.Delete(extractedFolder, true);
-                    }
-                }
-                finally
-                {
-                    host.Exit();
-                }
-            }
-        }
-
-        [Test]
-        [Ignore("intentionally broken by import optimisations")]
-        public async Task TestImportThenImportWithChangedFile()
-        {
-            using (HeadlessGameHost host = new CleanRunHeadlessGameHost())
-            {
-                try
-                {
-                    var osu = LoadOsuIntoHost(host);
-
-                    string temp = TestResources.GetTestBeatmapForImport();
-
-                    string extractedFolder = $"{temp}_extracted";
-                    Directory.CreateDirectory(extractedFolder);
-
-                    try
-                    {
-                        var imported = await LoadOszIntoOsu(osu);
-
-                        using (var zip = ZipArchive.Open(temp))
-                            zip.WriteToDirectory(extractedFolder);
-
-                        // arbitrary write to non-hashed file
-                        using (var sw = new FileInfo(Directory.GetFiles(extractedFolder, "*.mp3").First()).AppendText())
-                            await sw.WriteLineAsync("text");
-
-                        using (var zip = ZipArchive.Create())
-                        {
-                            zip.AddAllFromDirectory(extractedFolder);
-                            zip.SaveTo(temp, new ZipWriterOptions(CompressionType.Deflate));
-                        }
-
-                        var importedSecondTime = await osu.Dependencies.Get<BeatmapManager>().Import(new ImportTask(temp));
-
-                        await ensureLoaded(osu);
-
-                        // check the newly "imported" beatmap is not the original.
-                        Assert.IsTrue(imported.ID != importedSecondTime.Value.ID);
-                        Assert.IsTrue(imported.Beatmaps.First().ID != importedSecondTime.Value.Beatmaps.First().ID);
-                    }
-                    finally
-                    {
-                        Directory.Delete(extractedFolder, true);
-                    }
-                }
-                finally
-                {
-                    host.Exit();
-                }
-            }
-        }
-
-        [Test]
-        public async Task TestImportThenImportWithDifferentFilename()
-        {
-            using (HeadlessGameHost host = new CleanRunHeadlessGameHost())
-            {
-                try
-                {
-                    var osu = LoadOsuIntoHost(host);
-
-                    string temp = TestResources.GetTestBeatmapForImport();
-
-                    string extractedFolder = $"{temp}_extracted";
-                    Directory.CreateDirectory(extractedFolder);
-
-                    try
-                    {
-                        var imported = await LoadOszIntoOsu(osu);
-
-                        using (var zip = ZipArchive.Open(temp))
-                            zip.WriteToDirectory(extractedFolder);
-
-                        // change filename
-                        var firstFile = new FileInfo(Directory.GetFiles(extractedFolder).First());
-                        firstFile.MoveTo(Path.Combine(firstFile.DirectoryName.AsNonNull(), $"{firstFile.Name}-changed{firstFile.Extension}"));
-
-                        using (var zip = ZipArchive.Create())
-                        {
-                            zip.AddAllFromDirectory(extractedFolder);
-                            zip.SaveTo(temp, new ZipWriterOptions(CompressionType.Deflate));
-                        }
-
-                        var importedSecondTime = await osu.Dependencies.Get<BeatmapManager>().Import(new ImportTask(temp));
-
-                        await ensureLoaded(osu);
-
-                        // check the newly "imported" beatmap is not the original.
-                        Assert.IsTrue(imported.ID != importedSecondTime.Value.ID);
-                        Assert.IsTrue(imported.Beatmaps.First().ID != importedSecondTime.Value.Beatmaps.First().ID);
-                    }
-                    finally
-                    {
-                        Directory.Delete(extractedFolder, true);
-                    }
-                }
-                finally
-                {
-                    host.Exit();
-                }
-            }
-        }
-
-        [Test]
-        [Ignore("intentionally broken by import optimisations")]
-        public async Task TestImportCorruptThenImport()
-        {
-            // unfortunately for the time being we need to reference osu.Framework.Desktop for a game host here.
-            using (HeadlessGameHost host = new CleanRunHeadlessGameHost())
-            {
-                try
-                {
-                    var osu = LoadOsuIntoHost(host);
-
-                    var imported = await LoadOszIntoOsu(osu);
-
-                    var firstFile = imported.Files.First();
-
-                    var files = osu.Dependencies.Get<FileStore>();
-
-                    long originalLength;
-                    using (var stream = files.Storage.GetStream(firstFile.FileInfo.GetStoragePath()))
-                        originalLength = stream.Length;
-
-                    using (var stream = files.Storage.GetStream(firstFile.FileInfo.GetStoragePath(), FileAccess.Write, FileMode.Create))
-                        stream.WriteByte(0);
-
-                    var importedSecondTime = await LoadOszIntoOsu(osu);
-
-                    using (var stream = files.Storage.GetStream(firstFile.FileInfo.GetStoragePath()))
-                        Assert.AreEqual(stream.Length, originalLength, "Corruption was not fixed on second import");
-
-                    // check the newly "imported" beatmap is actually just the restored previous import. since it matches hash.
-                    Assert.IsTrue(imported.ID == importedSecondTime.ID);
-                    Assert.IsTrue(imported.Beatmaps.First().ID == importedSecondTime.Beatmaps.First().ID);
-
-                    checkBeatmapSetCount(osu, 1);
-                    checkSingleReferencedFileCount(osu, 18);
-                }
-                finally
-                {
-                    host.Exit();
-                }
-            }
-        }
-
-        [Test]
-        public async Task TestModelCreationFailureDoesntReturn()
-        {
-            using (HeadlessGameHost host = new CleanRunHeadlessGameHost())
-            {
-                try
-                {
-                    var osu = LoadOsuIntoHost(host);
-                    var importer = osu.Dependencies.Get<BeatmapManager>();
-
-                    var progressNotification = new ImportProgressNotification();
-
-                    var zipStream = new MemoryStream();
-
-                    using (var zip = ZipArchive.Create())
-                        zip.SaveTo(zipStream, new ZipWriterOptions(CompressionType.Deflate));
-
-                    var imported = await importer.Import(
-                        progressNotification,
-                        new ImportTask(zipStream, string.Empty)
-                    );
-
-                    checkBeatmapSetCount(osu, 0);
-                    checkBeatmapCount(osu, 0);
-
-                    Assert.IsEmpty(imported);
-                    Assert.AreEqual(ProgressNotificationState.Cancelled, progressNotification.State);
-                }
-                finally
-                {
-                    host.Exit();
-                }
-            }
-        }
-
-        [Test]
-        public async Task TestRollbackOnFailure()
-        {
-            // unfortunately for the time being we need to reference osu.Framework.Desktop for a game host here.
-            using (HeadlessGameHost host = new CleanRunHeadlessGameHost())
-            {
-                try
-                {
-                    int itemAddRemoveFireCount = 0;
-                    int loggedExceptionCount = 0;
-
-                    Logger.NewEntry += l =>
-                    {
-                        if (l.Target == LoggingTarget.Database && l.Exception != null)
-                            Interlocked.Increment(ref loggedExceptionCount);
-                    };
-
-                    var osu = LoadOsuIntoHost(host);
-                    var manager = osu.Dependencies.Get<BeatmapManager>();
-
-                    // ReSharper disable once AccessToModifiedClosure
-                    manager.ItemUpdated += _ => Interlocked.Increment(ref itemAddRemoveFireCount);
-                    manager.ItemRemoved += _ => Interlocked.Increment(ref itemAddRemoveFireCount);
-
-                    var imported = await LoadOszIntoOsu(osu);
-
-                    Assert.AreEqual(0, itemAddRemoveFireCount -= 1);
-
-                    imported.Hash += "-changed";
-                    manager.Update(imported);
-
-                    Assert.AreEqual(0, itemAddRemoveFireCount -= 1);
-
-                    checkBeatmapSetCount(osu, 1);
-                    checkBeatmapCount(osu, 12);
-                    checkSingleReferencedFileCount(osu, 18);
-
-                    string brokenTempFilename = TestResources.GetTestBeatmapForImport();
-
-                    MemoryStream brokenOsu = new MemoryStream();
-                    MemoryStream brokenOsz = new MemoryStream(await File.ReadAllBytesAsync(brokenTempFilename));
-
-                    File.Delete(brokenTempFilename);
-
-                    using (var outStream = File.Open(brokenTempFilename, FileMode.CreateNew))
-                    using (var zip = ZipArchive.Open(brokenOsz))
-                    {
-                        zip.AddEntry("broken.osu", brokenOsu, false);
-                        zip.SaveTo(outStream, CompressionType.Deflate);
-                    }
-
-                    // this will trigger purging of the existing beatmap (online set id match) but should rollback due to broken osu.
-                    try
-                    {
-                        await manager.Import(new ImportTask(brokenTempFilename));
-                    }
-                    catch
-                    {
-                    }
-
-                    // no events should be fired in the case of a rollback.
-                    Assert.AreEqual(0, itemAddRemoveFireCount);
-
-                    checkBeatmapSetCount(osu, 1);
-                    checkBeatmapCount(osu, 12);
-
-                    checkSingleReferencedFileCount(osu, 18);
-
-                    Assert.AreEqual(1, loggedExceptionCount);
-
-                    File.Delete(brokenTempFilename);
-                }
-                finally
-                {
-                    host.Exit();
-                }
-            }
-        }
-
-        [Test]
-        public async Task TestImportThenDeleteThenImport()
-        {
-            // unfortunately for the time being we need to reference osu.Framework.Desktop for a game host here.
-            using (HeadlessGameHost host = new CleanRunHeadlessGameHost())
-            {
-                try
-                {
-                    var osu = LoadOsuIntoHost(host);
-
-                    var imported = await LoadOszIntoOsu(osu);
-
-                    deleteBeatmapSet(imported, osu);
-
-                    var importedSecondTime = await LoadOszIntoOsu(osu);
-
-                    // check the newly "imported" beatmap is actually just the restored previous import. since it matches hash.
-                    Assert.IsTrue(imported.ID == importedSecondTime.ID);
-                    Assert.IsTrue(imported.Beatmaps.First().ID == importedSecondTime.Beatmaps.First().ID);
-                }
-                finally
-                {
-                    host.Exit();
-                }
-            }
-        }
-
-        [Test]
-        public async Task TestImportThenDeleteThenImportWithOnlineIDsMissing()
-        {
-            // unfortunately for the time being we need to reference osu.Framework.Desktop for a game host here.
-            using (HeadlessGameHost host = new CleanRunHeadlessGameHost())
-            {
-                try
-                {
-                    var osu = LoadOsuIntoHost(host);
-
-                    var imported = await LoadOszIntoOsu(osu);
-
-                    foreach (var b in imported.Beatmaps)
-                        b.OnlineID = null;
-
-                    osu.Dependencies.Get<BeatmapManager>().Update(imported);
-
-                    deleteBeatmapSet(imported, osu);
-
-                    var importedSecondTime = await LoadOszIntoOsu(osu);
-
-                    // check the newly "imported" beatmap has been reimported due to mismatch (even though hashes matched)
-                    Assert.IsTrue(imported.ID != importedSecondTime.ID);
-                    Assert.IsTrue(imported.Beatmaps.First().ID != importedSecondTime.Beatmaps.First().ID);
-                }
-                finally
-                {
-                    host.Exit();
-                }
-            }
-        }
-
-        [Test]
-        public async Task TestImportWithDuplicateBeatmapIDs()
-        {
-            // unfortunately for the time being we need to reference osu.Framework.Desktop for a game host here.
-            using (HeadlessGameHost host = new CleanRunHeadlessGameHost())
-            {
-                try
-                {
-                    var osu = LoadOsuIntoHost(host);
-
-                    var metadata = new BeatmapMetadata
-                    {
-                        Artist = "SomeArtist",
-                        AuthorString = "SomeAuthor"
-                    };
-
-                    var difficulty = new BeatmapDifficulty();
-
-                    var toImport = new BeatmapSetInfo
-                    {
-                        OnlineID = 1,
-                        Metadata = metadata,
-                        Beatmaps =
-                        {
-                            new BeatmapInfo
-                            {
-                                OnlineID = 2,
-                                Metadata = metadata,
-                                BaseDifficulty = difficulty
-                            },
-                            new BeatmapInfo
-                            {
-                                OnlineID = 2,
-                                Metadata = metadata,
-                                Status = BeatmapOnlineStatus.Loved,
-                                BaseDifficulty = difficulty
-                            }
-                        }
-                    };
-
-                    var manager = osu.Dependencies.Get<BeatmapManager>();
-
-                    var imported = await manager.Import(toImport);
-
-                    Assert.NotNull(imported);
-                    Assert.AreEqual(null, imported.Value.Beatmaps[0].OnlineID);
-                    Assert.AreEqual(null, imported.Value.Beatmaps[1].OnlineID);
-                }
-                finally
-                {
-                    host.Exit();
-                }
-            }
-        }
-
-        [Test]
-        [NonParallelizable]
-        public void TestImportOverIPC()
-        {
-            using (HeadlessGameHost host = new CleanRunHeadlessGameHost(true))
-            using (HeadlessGameHost client = new CleanRunHeadlessGameHost(true))
-            {
-                try
-                {
-                    Assert.IsTrue(host.IsPrimaryInstance);
-                    Assert.IsFalse(client.IsPrimaryInstance);
-
-                    var osu = LoadOsuIntoHost(host);
-
-                    string temp = TestResources.GetTestBeatmapForImport();
-
-                    var importer = new ArchiveImportIPCChannel(client);
-                    if (!importer.ImportAsync(temp).Wait(10000))
-                        Assert.Fail(@"IPC took too long to send");
-
-                    ensureLoaded(osu).WaitSafely();
-
-                    waitForOrAssert(() => !File.Exists(temp), "Temporary still exists after IPC import", 5000);
-                }
-                finally
-                {
-                    host.Exit();
-                }
-            }
-        }
-
-        [Test]
-        public async Task TestImportWhenFileOpen()
-        {
-            using (HeadlessGameHost host = new CleanRunHeadlessGameHost())
-            {
-                try
-                {
-                    var osu = LoadOsuIntoHost(host);
-                    string temp = TestResources.GetTestBeatmapForImport();
-                    using (File.OpenRead(temp))
-                        await osu.Dependencies.Get<BeatmapManager>().Import(temp);
-                    await ensureLoaded(osu);
-                    File.Delete(temp);
-                    Assert.IsFalse(File.Exists(temp), "We likely held a read lock on the file when we shouldn't");
-                }
-                finally
-                {
-                    host.Exit();
-                }
-            }
-        }
-
-        [Test]
-        public async Task TestImportWithDuplicateHashes()
-        {
-            using (HeadlessGameHost host = new CleanRunHeadlessGameHost())
-            {
-                try
-                {
-                    var osu = LoadOsuIntoHost(host);
-
-                    string temp = TestResources.GetTestBeatmapForImport();
-
-                    string extractedFolder = $"{temp}_extracted";
-                    Directory.CreateDirectory(extractedFolder);
-
-                    try
-                    {
-                        using (var zip = ZipArchive.Open(temp))
-                            zip.WriteToDirectory(extractedFolder);
-
-                        using (var zip = ZipArchive.Create())
-                        {
-                            zip.AddAllFromDirectory(extractedFolder);
-                            zip.AddEntry("duplicate.osu", Directory.GetFiles(extractedFolder, "*.osu").First());
-                            zip.SaveTo(temp, new ZipWriterOptions(CompressionType.Deflate));
-                        }
-
-                        await osu.Dependencies.Get<BeatmapManager>().Import(temp);
-
-                        await ensureLoaded(osu);
-                    }
-                    finally
-                    {
-                        Directory.Delete(extractedFolder, true);
-                    }
-                }
-                finally
-                {
-                    host.Exit();
-                }
-            }
-        }
-
-        [Test]
-        public async Task TestImportNestedStructure()
-        {
-            using (HeadlessGameHost host = new CleanRunHeadlessGameHost())
-            {
-                try
-                {
-                    var osu = LoadOsuIntoHost(host);
-
-                    string temp = TestResources.GetTestBeatmapForImport();
-
-                    string extractedFolder = $"{temp}_extracted";
-                    string subfolder = Path.Combine(extractedFolder, "subfolder");
-
-                    Directory.CreateDirectory(subfolder);
-
-                    try
-                    {
-                        using (var zip = ZipArchive.Open(temp))
-                            zip.WriteToDirectory(subfolder);
-
-                        using (var zip = ZipArchive.Create())
-                        {
-                            zip.AddAllFromDirectory(extractedFolder);
-                            zip.SaveTo(temp, new ZipWriterOptions(CompressionType.Deflate));
-                        }
-
-                        var imported = await osu.Dependencies.Get<BeatmapManager>().Import(new ImportTask(temp));
-
-                        await ensureLoaded(osu);
-
-                        Assert.IsFalse(imported.Value.Files.Any(f => f.Filename.Contains("subfolder")), "Files contain common subfolder");
-                    }
-                    finally
-                    {
-                        Directory.Delete(extractedFolder, true);
-                    }
-                }
-                finally
-                {
-                    host.Exit();
-                }
-            }
-        }
-
-        [Test]
-        public async Task TestImportWithIgnoredDirectoryInArchive()
-        {
-            using (HeadlessGameHost host = new CleanRunHeadlessGameHost())
-            {
-                try
-                {
-                    var osu = LoadOsuIntoHost(host);
-
-                    string temp = TestResources.GetTestBeatmapForImport();
-
-                    string extractedFolder = $"{temp}_extracted";
-                    string dataFolder = Path.Combine(extractedFolder, "actual_data");
-                    string resourceForkFolder = Path.Combine(extractedFolder, "__MACOSX");
-                    string resourceForkFilePath = Path.Combine(resourceForkFolder, ".extracted");
-
-                    Directory.CreateDirectory(dataFolder);
-                    Directory.CreateDirectory(resourceForkFolder);
-
-                    using (var resourceForkFile = File.CreateText(resourceForkFilePath))
-                    {
-                        await resourceForkFile.WriteLineAsync("adding content so that it's not empty");
-                    }
-
-                    try
-                    {
-                        using (var zip = ZipArchive.Open(temp))
-                            zip.WriteToDirectory(dataFolder);
-
-                        using (var zip = ZipArchive.Create())
-                        {
-                            zip.AddAllFromDirectory(extractedFolder);
-                            zip.SaveTo(temp, new ZipWriterOptions(CompressionType.Deflate));
-                        }
-
-                        var imported = await osu.Dependencies.Get<BeatmapManager>().Import(new ImportTask(temp));
-
-                        await ensureLoaded(osu);
-
-                        Assert.IsFalse(imported.Value.Files.Any(f => f.Filename.Contains("__MACOSX")), "Files contain resource fork folder, which should be ignored");
-                        Assert.IsFalse(imported.Value.Files.Any(f => f.Filename.Contains("actual_data")), "Files contain common subfolder");
-                    }
-                    finally
-                    {
-                        Directory.Delete(extractedFolder, true);
-                    }
-                }
-                finally
-                {
-                    host.Exit();
-                }
-            }
-        }
-
-        [Test]
-        public void TestUpdateBeatmapInfo()
-        {
-            using (HeadlessGameHost host = new CleanRunHeadlessGameHost())
-            {
-                try
-                {
-                    var osu = LoadOsuIntoHost(host);
-                    var manager = osu.Dependencies.Get<BeatmapManager>();
-
-                    string temp = TestResources.GetTestBeatmapForImport();
-
-                    osu.Dependencies.Get<BeatmapManager>().Import(temp).WaitSafely();
-
-                    // Update via the beatmap, not the beatmap info, to ensure correct linking
-                    BeatmapSetInfo setToUpdate = manager.GetAllUsableBeatmapSets()[0];
-                    Beatmap beatmapToUpdate = (Beatmap)manager.GetWorkingBeatmap(setToUpdate.Beatmaps.First(b => b.RulesetID == 0)).Beatmap;
-                    beatmapToUpdate.BeatmapInfo.DifficultyName = "updated";
-
-                    manager.Update(setToUpdate);
-
-                    BeatmapInfo updatedInfo = manager.QueryBeatmap(b => b.ID == beatmapToUpdate.BeatmapInfo.ID);
-                    Assert.That(updatedInfo.DifficultyName, Is.EqualTo("updated"));
-                }
-                finally
-                {
-                    host.Exit();
-                }
-            }
-        }
-
-        [Test]
-        public void TestUpdateBeatmapFile()
-        {
-            using (HeadlessGameHost host = new CleanRunHeadlessGameHost())
-            {
-                try
-                {
-                    var osu = LoadOsuIntoHost(host);
-                    var manager = osu.Dependencies.Get<BeatmapManager>();
-
-                    string temp = TestResources.GetTestBeatmapForImport();
-
-                    osu.Dependencies.Get<BeatmapManager>().Import(temp).WaitSafely();
-
-                    BeatmapSetInfo setToUpdate = manager.GetAllUsableBeatmapSets()[0];
-
-                    var beatmapInfo = setToUpdate.Beatmaps.First(b => b.RulesetID == 0);
-                    Beatmap beatmapToUpdate = (Beatmap)manager.GetWorkingBeatmap(setToUpdate.Beatmaps.First(b => b.RulesetID == 0)).Beatmap;
-                    BeatmapSetFileInfo fileToUpdate = setToUpdate.Files.First(f => beatmapToUpdate.BeatmapInfo.Path.Contains(f.Filename));
-
-                    string oldMd5Hash = beatmapToUpdate.BeatmapInfo.MD5Hash;
-
-                    beatmapToUpdate.HitObjects.Clear();
-                    beatmapToUpdate.HitObjects.Add(new HitCircle { StartTime = 5000 });
-
-                    manager.Save(beatmapInfo, beatmapToUpdate);
-
-                    // Check that the old file reference has been removed
-                    Assert.That(manager.QueryBeatmapSet(s => s.ID == setToUpdate.ID).Files.All(f => f.ID != fileToUpdate.ID));
-
-                    // Check that the new file is referenced correctly by attempting a retrieval
-                    Beatmap updatedBeatmap = (Beatmap)manager.GetWorkingBeatmap(manager.QueryBeatmap(b => b.ID == beatmapToUpdate.BeatmapInfo.ID)).Beatmap;
-                    Assert.That(updatedBeatmap.HitObjects.Count, Is.EqualTo(1));
-                    Assert.That(updatedBeatmap.HitObjects[0].StartTime, Is.EqualTo(5000));
-                    Assert.That(updatedBeatmap.BeatmapInfo.MD5Hash, Is.Not.EqualTo(oldMd5Hash));
-                }
-                finally
-                {
-                    host.Exit();
-                }
-            }
-        }
-
-        // TODO: needs to be pulled across to realm implementation when this file is nuked.
-        [Test]
-        public void TestSaveRemovesInvalidCharactersFromPath()
-        {
-            // unfortunately for the time being we need to reference osu.Framework.Desktop for a game host here.
-            using (HeadlessGameHost host = new CleanRunHeadlessGameHost())
-            {
-                try
-                {
-                    var osu = LoadOsuIntoHost(host);
-
-                    var manager = osu.Dependencies.Get<BeatmapManager>();
-
-                    var working = manager.CreateNew(new OsuRuleset().RulesetInfo, APIUser.SYSTEM_USER);
-
-                    var beatmap = working.Beatmap;
-
-                    beatmap.BeatmapInfo.DifficultyName = "difficulty";
-                    beatmap.BeatmapInfo.Metadata = new BeatmapMetadata
-                    {
-                        Artist = "Artist/With\\Slashes",
-                        Title = "Title",
-                        AuthorString = "mapper",
-                    };
-
-                    manager.Save(beatmap.BeatmapInfo, working.Beatmap);
-
-                    Assert.AreEqual("Artist_With_Slashes - Title (mapper) [difficulty].osu", beatmap.BeatmapInfo.Path);
-                }
-                finally
-                {
-                    host.Exit();
-                }
-            }
-        }
-
-        [Test]
-        public void TestCreateNewEmptyBeatmap()
-        {
-            using (HeadlessGameHost host = new CleanRunHeadlessGameHost())
-            {
-                try
-                {
-                    var osu = LoadOsuIntoHost(host);
-                    var manager = osu.Dependencies.Get<BeatmapManager>();
-
-                    var working = manager.CreateNew(new OsuRuleset().RulesetInfo, APIUser.SYSTEM_USER);
-
-                    manager.Save(working.BeatmapInfo, working.Beatmap);
-
-                    var retrievedSet = manager.GetAllUsableBeatmapSets()[0];
-
-                    // Check that the new file is referenced correctly by attempting a retrieval
-                    Beatmap updatedBeatmap = (Beatmap)manager.GetWorkingBeatmap(retrievedSet.Beatmaps[0]).Beatmap;
-                    Assert.That(updatedBeatmap.HitObjects.Count, Is.EqualTo(0));
-                }
-                finally
-                {
-                    host.Exit();
-                }
-            }
-        }
-
-        [Test]
-        public void TestCreateNewBeatmapWithObject()
-        {
-            using (HeadlessGameHost host = new CleanRunHeadlessGameHost())
-            {
-                try
-                {
-                    var osu = LoadOsuIntoHost(host);
-                    var manager = osu.Dependencies.Get<BeatmapManager>();
-
-                    var working = manager.CreateNew(new OsuRuleset().RulesetInfo, APIUser.SYSTEM_USER);
-
-                    ((Beatmap)working.Beatmap).HitObjects.Add(new HitCircle { StartTime = 5000 });
-
-                    manager.Save(working.BeatmapInfo, working.Beatmap);
-
-                    var retrievedSet = manager.GetAllUsableBeatmapSets()[0];
-
-                    // Check that the new file is referenced correctly by attempting a retrieval
-                    Beatmap updatedBeatmap = (Beatmap)manager.GetWorkingBeatmap(retrievedSet.Beatmaps[0]).Beatmap;
-                    Assert.That(updatedBeatmap.HitObjects.Count, Is.EqualTo(1));
-                    Assert.That(updatedBeatmap.HitObjects[0].StartTime, Is.EqualTo(5000));
-                }
-                finally
-                {
-                    host.Exit();
-                }
-            }
-        }
-
-        public static Task<BeatmapSetInfo> LoadQuickOszIntoOsu(OsuGameBase osu) => Task.Factory.StartNew(() =>
+        public static async Task<BeatmapSetInfo> LoadQuickOszIntoOsu(OsuGameBase osu)
         {
             string temp = TestResources.GetQuickTestBeatmapForImport();
 
@@ -1020,16 +61,6 @@ namespace osu.Game.Tests.Beatmaps.IO
             Assert.IsTrue(manager.QueryBeatmapSets(_ => true).First().DeletePending);
         }
 
-        private static Task createScoreForBeatmap(OsuGameBase osu, BeatmapInfo beatmapInfo)
-        {
-            return ImportScoreTest.LoadScoreIntoOsu(osu, new ScoreInfo
-            {
-                OnlineID = 2,
-                BeatmapInfo = beatmapInfo,
-                BeatmapInfoID = beatmapInfo.ID
-            }, new ImportScoreTest.TestArchiveReader());
-        }
-
         private static void checkBeatmapSetCount(OsuGameBase osu, int expected, bool includeDeletePending = false)
         {
             var manager = osu.Dependencies.Get<BeatmapManager>();
@@ -1064,7 +95,7 @@ namespace osu.Game.Tests.Beatmaps.IO
 
             // ensure we were stored to beatmap database backing...
             Assert.IsTrue(resultSets.Count() == 1, $@"Incorrect result count found ({resultSets.Count()} but should be 1).");
-            IEnumerable<BeatmapInfo> queryBeatmaps() => store.QueryBeatmaps(s => s.BeatmapSet.OnlineID == 241526 && s.BaseDifficultyID > 0);
+            IEnumerable<BeatmapInfo> queryBeatmaps() => store.QueryBeatmaps(s => s.BeatmapSet.OnlineID == 241526);
             IEnumerable<BeatmapSetInfo> queryBeatmapSets() => store.QueryBeatmapSets(s => s.OnlineID == 241526);
 
             // if we don't re-check here, the set will be inserted but the beatmaps won't be present yet.

From 0b6c4497bd0a9f74d4153a218afb603b88d9b46c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 19 Nov 2021 18:59:14 +0900
Subject: [PATCH 1994/5547] Rename EF classes to allow for shit to hit the fan

---
 ...apDifficulty.cs => EFBeatmapDifficulty.cs} | 14 ++++----
 .../{BeatmapInfo.cs => EFBeatmapInfo.cs}      | 32 +++++++++----------
 ...eatmapMetadata.cs => EFBeatmapMetadata.cs} |  8 ++---
 ...{BeatmapSetInfo.cs => EFBeatmapSetInfo.cs} |  8 ++---
 osu.Game/Database/OsuDbContext.cs             | 28 ++++++++--------
 .../{RulesetInfo.cs => EFRulesetInfo.cs}      |  6 ++--
 osu.sln.DotSettings                           |  2 +-
 7 files changed, 49 insertions(+), 49 deletions(-)
 rename osu.Game/Beatmaps/{BeatmapDifficulty.cs => EFBeatmapDifficulty.cs} (81%)
 rename osu.Game/Beatmaps/{BeatmapInfo.cs => EFBeatmapInfo.cs} (76%)
 rename osu.Game/Beatmaps/{BeatmapMetadata.cs => EFBeatmapMetadata.cs} (86%)
 rename osu.Game/Beatmaps/{BeatmapSetInfo.cs => EFBeatmapSetInfo.cs} (90%)
 rename osu.Game/Rulesets/{RulesetInfo.cs => EFRulesetInfo.cs} (86%)

diff --git a/osu.Game/Beatmaps/BeatmapDifficulty.cs b/osu.Game/Beatmaps/EFBeatmapDifficulty.cs
similarity index 81%
rename from osu.Game/Beatmaps/BeatmapDifficulty.cs
rename to osu.Game/Beatmaps/EFBeatmapDifficulty.cs
index 65d1fb8286..843c6ac6bf 100644
--- a/osu.Game/Beatmaps/BeatmapDifficulty.cs
+++ b/osu.Game/Beatmaps/EFBeatmapDifficulty.cs
@@ -6,7 +6,7 @@ using osu.Game.Database;
 
 namespace osu.Game.Beatmaps
 {
-    public class BeatmapDifficulty : IHasPrimaryKey, IBeatmapDifficultyInfo
+    public class EFBeatmapDifficulty : IHasPrimaryKey, IBeatmapDifficultyInfo
     {
         /// <summary>
         /// The default value used for all difficulty settings except <see cref="SliderMultiplier"/> and <see cref="SliderTickRate"/>.
@@ -23,11 +23,11 @@ namespace osu.Game.Beatmaps
 
         private float? approachRate;
 
-        public BeatmapDifficulty()
+        public EFBeatmapDifficulty()
         {
         }
 
-        public BeatmapDifficulty(IBeatmapDifficultyInfo source)
+        public EFBeatmapDifficulty(IBeatmapDifficultyInfo source)
         {
             CopyFrom(source);
         }
@@ -42,11 +42,11 @@ namespace osu.Game.Beatmaps
         public double SliderTickRate { get; set; } = 1;
 
         /// <summary>
-        /// Returns a shallow-clone of this <see cref="BeatmapDifficulty"/>.
+        /// Returns a shallow-clone of this <see cref="EFBeatmapDifficulty"/>.
         /// </summary>
-        public BeatmapDifficulty Clone()
+        public EFBeatmapDifficulty Clone()
         {
-            var diff = (BeatmapDifficulty)Activator.CreateInstance(GetType());
+            var diff = (EFBeatmapDifficulty)Activator.CreateInstance(GetType());
             CopyTo(diff);
             return diff;
         }
@@ -62,7 +62,7 @@ namespace osu.Game.Beatmaps
             SliderTickRate = other.SliderTickRate;
         }
 
-        public virtual void CopyTo(BeatmapDifficulty other)
+        public virtual void CopyTo(EFBeatmapDifficulty other)
         {
             other.ApproachRate = ApproachRate;
             other.DrainRate = DrainRate;
diff --git a/osu.Game/Beatmaps/BeatmapInfo.cs b/osu.Game/Beatmaps/EFBeatmapInfo.cs
similarity index 76%
rename from osu.Game/Beatmaps/BeatmapInfo.cs
rename to osu.Game/Beatmaps/EFBeatmapInfo.cs
index 4175d7ff6b..2336eeb456 100644
--- a/osu.Game/Beatmaps/BeatmapInfo.cs
+++ b/osu.Game/Beatmaps/EFBeatmapInfo.cs
@@ -16,7 +16,7 @@ namespace osu.Game.Beatmaps
 {
     [ExcludeFromDynamicCompile]
     [Serializable]
-    public class BeatmapInfo : IEquatable<BeatmapInfo>, IHasPrimaryKey, IBeatmapInfo
+    public class EFBeatmapInfo : IEquatable<EFBeatmapInfo>, IHasPrimaryKey, IBeatmapInfo
     {
         public int ID { get; set; }
 
@@ -40,14 +40,14 @@ namespace osu.Game.Beatmaps
         public BeatmapOnlineStatus Status { get; set; } = BeatmapOnlineStatus.None;
 
         [Required]
-        public BeatmapSetInfo BeatmapSet { get; set; }
+        public EFBeatmapSetInfo BeatmapSet { get; set; }
 
-        public BeatmapMetadata Metadata { get; set; }
+        public EFBeatmapMetadata Metadata { get; set; }
 
         [JsonIgnore]
         public int BaseDifficultyID { get; set; }
 
-        public BeatmapDifficulty BaseDifficulty { get; set; }
+        public EFBeatmapDifficulty BaseDifficulty { get; set; }
 
         [NotMapped]
         public APIBeatmap OnlineInfo { get; set; }
@@ -86,7 +86,7 @@ namespace osu.Game.Beatmaps
 
         public int RulesetID { get; set; }
 
-        public RulesetInfo Ruleset { get; set; }
+        public EFRulesetInfo Ruleset { get; set; }
 
         public bool LetterboxInBreaks { get; set; }
         public bool WidescreenStoryboard { get; set; }
@@ -131,7 +131,7 @@ namespace osu.Game.Beatmaps
 
         public override string ToString() => this.GetDisplayTitle();
 
-        public bool Equals(BeatmapInfo other)
+        public bool Equals(EFBeatmapInfo other)
         {
             if (ReferenceEquals(this, other)) return true;
             if (other == null) return false;
@@ -142,20 +142,20 @@ namespace osu.Game.Beatmaps
             return false;
         }
 
-        public bool Equals(IBeatmapInfo other) => other is BeatmapInfo b && Equals(b);
+        public bool Equals(IBeatmapInfo other) => other is EFBeatmapInfo b && Equals(b);
 
-        public bool AudioEquals(BeatmapInfo other) => other != null && BeatmapSet != null && other.BeatmapSet != null &&
-                                                      BeatmapSet.Hash == other.BeatmapSet.Hash &&
-                                                      (Metadata ?? BeatmapSet.Metadata).AudioFile == (other.Metadata ?? other.BeatmapSet.Metadata).AudioFile;
+        public bool AudioEquals(EFBeatmapInfo other) => other != null && BeatmapSet != null && other.BeatmapSet != null &&
+                                                        BeatmapSet.Hash == other.BeatmapSet.Hash &&
+                                                        (Metadata ?? BeatmapSet.Metadata).AudioFile == (other.Metadata ?? other.BeatmapSet.Metadata).AudioFile;
 
-        public bool BackgroundEquals(BeatmapInfo other) => other != null && BeatmapSet != null && other.BeatmapSet != null &&
-                                                           BeatmapSet.Hash == other.BeatmapSet.Hash &&
-                                                           (Metadata ?? BeatmapSet.Metadata).BackgroundFile == (other.Metadata ?? other.BeatmapSet.Metadata).BackgroundFile;
+        public bool BackgroundEquals(EFBeatmapInfo other) => other != null && BeatmapSet != null && other.BeatmapSet != null &&
+                                                             BeatmapSet.Hash == other.BeatmapSet.Hash &&
+                                                             (Metadata ?? BeatmapSet.Metadata).BackgroundFile == (other.Metadata ?? other.BeatmapSet.Metadata).BackgroundFile;
 
         /// <summary>
-        /// Returns a shallow-clone of this <see cref="BeatmapInfo"/>.
+        /// Returns a shallow-clone of this <see cref="EFBeatmapInfo"/>.
         /// </summary>
-        public BeatmapInfo Clone() => (BeatmapInfo)MemberwiseClone();
+        public EFBeatmapInfo Clone() => (EFBeatmapInfo)MemberwiseClone();
 
         #region Implementation of IHasOnlineID
 
@@ -166,7 +166,7 @@ namespace osu.Game.Beatmaps
         #region Implementation of IBeatmapInfo
 
         [JsonIgnore]
-        IBeatmapMetadataInfo IBeatmapInfo.Metadata => Metadata ?? BeatmapSet?.Metadata ?? new BeatmapMetadata();
+        IBeatmapMetadataInfo IBeatmapInfo.Metadata => Metadata ?? BeatmapSet?.Metadata ?? new EFBeatmapMetadata();
 
         [JsonIgnore]
         IBeatmapDifficultyInfo IBeatmapInfo.Difficulty => BaseDifficulty;
diff --git a/osu.Game/Beatmaps/BeatmapMetadata.cs b/osu.Game/Beatmaps/EFBeatmapMetadata.cs
similarity index 86%
rename from osu.Game/Beatmaps/BeatmapMetadata.cs
rename to osu.Game/Beatmaps/EFBeatmapMetadata.cs
index 5da0264893..6c192088dc 100644
--- a/osu.Game/Beatmaps/BeatmapMetadata.cs
+++ b/osu.Game/Beatmaps/EFBeatmapMetadata.cs
@@ -16,7 +16,7 @@ namespace osu.Game.Beatmaps
 {
     [ExcludeFromDynamicCompile]
     [Serializable]
-    public class BeatmapMetadata : IEquatable<BeatmapMetadata>, IHasPrimaryKey, IBeatmapMetadataInfo
+    public class EFBeatmapMetadata : IEquatable<EFBeatmapMetadata>, IHasPrimaryKey, IBeatmapMetadataInfo
     {
         public int ID { get; set; }
 
@@ -33,10 +33,10 @@ namespace osu.Game.Beatmaps
         public string ArtistUnicode { get; set; } = string.Empty;
 
         [JsonIgnore]
-        public List<BeatmapInfo> Beatmaps { get; set; } = new List<BeatmapInfo>();
+        public List<EFBeatmapInfo> Beatmaps { get; set; } = new List<EFBeatmapInfo>();
 
         [JsonIgnore]
-        public List<BeatmapSetInfo> BeatmapSets { get; set; } = new List<BeatmapSetInfo>();
+        public List<EFBeatmapSetInfo> BeatmapSets { get; set; } = new List<EFBeatmapSetInfo>();
 
         /// <summary>
         /// The author of the beatmaps in this set.
@@ -81,7 +81,7 @@ namespace osu.Game.Beatmaps
 
         public string BackgroundFile { get; set; } = string.Empty;
 
-        public bool Equals(BeatmapMetadata other) => ((IBeatmapMetadataInfo)this).Equals(other);
+        public bool Equals(EFBeatmapMetadata other) => ((IBeatmapMetadataInfo)this).Equals(other);
 
         public override string ToString() => this.GetDisplayTitle();
 
diff --git a/osu.Game/Beatmaps/BeatmapSetInfo.cs b/osu.Game/Beatmaps/EFBeatmapSetInfo.cs
similarity index 90%
rename from osu.Game/Beatmaps/BeatmapSetInfo.cs
rename to osu.Game/Beatmaps/EFBeatmapSetInfo.cs
index a3a8f8555f..c0310f5a76 100644
--- a/osu.Game/Beatmaps/BeatmapSetInfo.cs
+++ b/osu.Game/Beatmaps/EFBeatmapSetInfo.cs
@@ -14,7 +14,7 @@ using osu.Game.Extensions;
 namespace osu.Game.Beatmaps
 {
     [ExcludeFromDynamicCompile]
-    public class BeatmapSetInfo : IHasPrimaryKey, IHasFiles<BeatmapSetFileInfo>, ISoftDelete, IEquatable<BeatmapSetInfo>, IBeatmapSetInfo
+    public class EFBeatmapSetInfo : IHasPrimaryKey, IHasFiles<BeatmapSetFileInfo>, ISoftDelete, IEquatable<EFBeatmapSetInfo>, IBeatmapSetInfo
     {
         public int ID { get; set; }
 
@@ -31,7 +31,7 @@ namespace osu.Game.Beatmaps
 
         public DateTimeOffset DateAdded { get; set; }
 
-        public BeatmapMetadata Metadata { get; set; }
+        public EFBeatmapMetadata Metadata { get; set; }
 
         [NotNull]
         public List<BeatmapInfo> Beatmaps { get; } = new List<BeatmapInfo>();
@@ -74,7 +74,7 @@ namespace osu.Game.Beatmaps
 
         public bool Protected { get; set; }
 
-        public bool Equals(BeatmapSetInfo other)
+        public bool Equals(EFBeatmapSetInfo other)
         {
             if (ReferenceEquals(this, other)) return true;
             if (other == null) return false;
@@ -85,7 +85,7 @@ namespace osu.Game.Beatmaps
             return false;
         }
 
-        public bool Equals(IBeatmapSetInfo other) => other is BeatmapSetInfo b && Equals(b);
+        public bool Equals(IBeatmapSetInfo other) => other is EFBeatmapSetInfo b && Equals(b);
 
         #region Implementation of IHasOnlineID
 
diff --git a/osu.Game/Database/OsuDbContext.cs b/osu.Game/Database/OsuDbContext.cs
index 7cd9ae2885..9f0bae4a66 100644
--- a/osu.Game/Database/OsuDbContext.cs
+++ b/osu.Game/Database/OsuDbContext.cs
@@ -19,12 +19,12 @@ namespace osu.Game.Database
 {
     public class OsuDbContext : DbContext
     {
-        public DbSet<BeatmapInfo> BeatmapInfo { get; set; }
-        public DbSet<BeatmapDifficulty> BeatmapDifficulty { get; set; }
-        public DbSet<BeatmapMetadata> BeatmapMetadata { get; set; }
-        public DbSet<BeatmapSetInfo> BeatmapSetInfo { get; set; }
+        public DbSet<EFBeatmapInfo> EFBeatmapInfo { get; set; }
+        public DbSet<EFBeatmapDifficulty> BeatmapDifficulty { get; set; }
+        public DbSet<EFBeatmapMetadata> BeatmapMetadata { get; set; }
+        public DbSet<EFBeatmapSetInfo> EFBeatmapSetInfo { get; set; }
         public DbSet<FileInfo> FileInfo { get; set; }
-        public DbSet<RulesetInfo> RulesetInfo { get; set; }
+        public DbSet<EFRulesetInfo> RulesetInfo { get; set; }
         public DbSet<EFSkinInfo> SkinInfo { get; set; }
         public DbSet<ScoreInfo> ScoreInfo { get; set; }
 
@@ -125,13 +125,13 @@ namespace osu.Game.Database
         {
             base.OnModelCreating(modelBuilder);
 
-            modelBuilder.Entity<BeatmapInfo>().HasIndex(b => b.OnlineID).IsUnique();
-            modelBuilder.Entity<BeatmapInfo>().HasIndex(b => b.MD5Hash);
-            modelBuilder.Entity<BeatmapInfo>().HasIndex(b => b.Hash);
+            modelBuilder.Entity<EFBeatmapInfo>().HasIndex(b => b.OnlineID).IsUnique();
+            modelBuilder.Entity<EFBeatmapInfo>().HasIndex(b => b.MD5Hash);
+            modelBuilder.Entity<EFBeatmapInfo>().HasIndex(b => b.Hash);
 
-            modelBuilder.Entity<BeatmapSetInfo>().HasIndex(b => b.OnlineID).IsUnique();
-            modelBuilder.Entity<BeatmapSetInfo>().HasIndex(b => b.DeletePending);
-            modelBuilder.Entity<BeatmapSetInfo>().HasIndex(b => b.Hash).IsUnique();
+            modelBuilder.Entity<EFBeatmapSetInfo>().HasIndex(b => b.OnlineID).IsUnique();
+            modelBuilder.Entity<EFBeatmapSetInfo>().HasIndex(b => b.DeletePending);
+            modelBuilder.Entity<EFBeatmapSetInfo>().HasIndex(b => b.Hash).IsUnique();
 
             modelBuilder.Entity<EFSkinInfo>().HasIndex(b => b.Hash).IsUnique();
             modelBuilder.Entity<EFSkinInfo>().HasIndex(b => b.DeletePending);
@@ -142,10 +142,10 @@ namespace osu.Game.Database
             modelBuilder.Entity<FileInfo>().HasIndex(b => b.Hash).IsUnique();
             modelBuilder.Entity<FileInfo>().HasIndex(b => b.ReferenceCount);
 
-            modelBuilder.Entity<RulesetInfo>().HasIndex(b => b.Available);
-            modelBuilder.Entity<RulesetInfo>().HasIndex(b => b.ShortName).IsUnique();
+            modelBuilder.Entity<EFRulesetInfo>().HasIndex(b => b.Available);
+            modelBuilder.Entity<EFRulesetInfo>().HasIndex(b => b.ShortName).IsUnique();
 
-            modelBuilder.Entity<BeatmapInfo>().HasOne(b => b.BaseDifficulty);
+            modelBuilder.Entity<EFBeatmapInfo>().HasOne(b => b.BaseDifficulty);
 
             modelBuilder.Entity<ScoreInfo>().HasIndex(b => b.OnlineID).IsUnique();
         }
diff --git a/osu.Game/Rulesets/RulesetInfo.cs b/osu.Game/Rulesets/EFRulesetInfo.cs
similarity index 86%
rename from osu.Game/Rulesets/RulesetInfo.cs
rename to osu.Game/Rulesets/EFRulesetInfo.cs
index d018cc4194..36e2add557 100644
--- a/osu.Game/Rulesets/RulesetInfo.cs
+++ b/osu.Game/Rulesets/EFRulesetInfo.cs
@@ -10,7 +10,7 @@ using osu.Framework.Testing;
 namespace osu.Game.Rulesets
 {
     [ExcludeFromDynamicCompile]
-    public sealed class RulesetInfo : IEquatable<RulesetInfo>, IRulesetInfo
+    public sealed class EFRulesetInfo : IEquatable<EFRulesetInfo>, IRulesetInfo
     {
         public int? ID { get; set; }
 
@@ -45,9 +45,9 @@ namespace osu.Game.Rulesets
             return ruleset;
         }
 
-        public bool Equals(RulesetInfo other) => other != null && ID == other.ID && Available == other.Available && Name == other.Name && InstantiationInfo == other.InstantiationInfo;
+        public bool Equals(EFRulesetInfo other) => other != null && ID == other.ID && Available == other.Available && Name == other.Name && InstantiationInfo == other.InstantiationInfo;
 
-        public override bool Equals(object obj) => obj is RulesetInfo rulesetInfo && Equals(rulesetInfo);
+        public override bool Equals(object obj) => obj is EFRulesetInfo rulesetInfo && Equals(rulesetInfo);
 
         public bool Equals(IRulesetInfo other) => other is RulesetInfo b && Equals(b);
 
diff --git a/osu.sln.DotSettings b/osu.sln.DotSettings
index 44d75f265c..0da109ae7c 100644
--- a/osu.sln.DotSettings
+++ b/osu.sln.DotSettings
@@ -789,7 +789,7 @@ See the LICENCE file in the repository root for full licence text.&#xD;
 	<s:String x:Key="/Default/CodeStyle/Naming/XamlNaming/UserRules/=XAML_005FFIELD/@EntryIndexedValue">&lt;Policy Inspect="True" Prefix="" Suffix="" Style="AaBb" /&gt;</s:String>
 	<s:String x:Key="/Default/CodeStyle/Naming/XamlNaming/UserRules/=XAML_005FRESOURCE/@EntryIndexedValue">&lt;Policy Inspect="True" Prefix="" Suffix="" Style="AaBb" /&gt;</s:String>
 	<s:String x:Key="/Default/CustomTools/CustomToolsData/@EntryValue"></s:String>
-	<s:Boolean x:Key="/Default/Environment/SettingsMigration/IsMigratorApplied/=JetBrains_002EReSharper_002EFeature_002EServices_002EDaemon_002ESettings_002EMigration_002ESwaWarningsModeSettingsMigrate/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/Environment/SettingsMigration/IsMigratorApplied/=JetBrains_002EReSharper_002EFBeature_002EServices_002EDaemon_002ESettings_002EMigration_002ESwaWarningsModeSettingsMigrate/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/Environment/SettingsMigration/IsMigratorApplied/=JetBrains_002EReSharper_002EPsi_002ECSharp_002ECodeStyle_002ECSharpAttributeForSingleLineMethodUpgrade/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/Environment/SettingsMigration/IsMigratorApplied/=JetBrains_002EReSharper_002EPsi_002ECSharp_002ECodeStyle_002ECSharpKeepExistingMigration/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/Environment/SettingsMigration/IsMigratorApplied/=JetBrains_002EReSharper_002EPsi_002ECSharp_002ECodeStyle_002ECSharpPlaceEmbeddedOnSameLineMigration/@EntryIndexedValue">True</s:Boolean>

From 618903c2178b0ce4ae322de5f417938dc35f97b5 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 19 Nov 2021 19:07:21 +0900
Subject: [PATCH 1995/5547] Rename realm to become imposter classes

---
 .../Database/BeatmapImporterTests.cs          | 64 +++++++++----------
 osu.Game.Tests/Database/GeneralUsageTests.cs  |  4 +-
 osu.Game.Tests/Database/RealmLiveTests.cs     | 46 ++++++-------
 osu.Game.Tests/Database/RealmTest.cs          | 20 +++---
 osu.Game.Tests/Database/RulesetStoreTests.cs  |  6 +-
 .../BeatmapDifficulty.cs}                     | 13 ++--
 .../BeatmapInfo.cs}                           | 26 ++++----
 .../BeatmapMetadata.cs}                       |  6 +-
 .../BeatmapSetInfo.cs}                        | 14 ++--
 osu.Game/Database/RealmContextFactory.cs      | 13 ++--
 .../RulesetInfo.cs}                           | 17 +++--
 osu.Game/Stores/BeatmapImporter.cs            | 40 ++++++------
 osu.Game/Stores/RealmRulesetStore.cs          | 11 ++--
 13 files changed, 140 insertions(+), 140 deletions(-)
 rename osu.Game/{Models/RealmBeatmapDifficulty.cs => Beatmaps/BeatmapDifficulty.cs} (76%)
 rename osu.Game/{Models/RealmBeatmap.cs => Beatmaps/BeatmapInfo.cs} (80%)
 rename osu.Game/{Models/RealmBeatmapMetadata.cs => Beatmaps/BeatmapMetadata.cs} (91%)
 rename osu.Game/{Models/RealmBeatmapSet.cs => Beatmaps/BeatmapSetInfo.cs} (84%)
 rename osu.Game/{Models/RealmRuleset.cs => Rulesets/RulesetInfo.cs} (74%)

diff --git a/osu.Game.Tests/Database/BeatmapImporterTests.cs b/osu.Game.Tests/Database/BeatmapImporterTests.cs
index e47e24021f..37c2007681 100644
--- a/osu.Game.Tests/Database/BeatmapImporterTests.cs
+++ b/osu.Game.Tests/Database/BeatmapImporterTests.cs
@@ -19,6 +19,7 @@ using osu.Game.Extensions;
 using osu.Game.IO.Archives;
 using osu.Game.Models;
 using osu.Game.Overlays.Notifications;
+using osu.Game.Rulesets;
 using osu.Game.Stores;
 using osu.Game.Tests.Resources;
 using Realms;
@@ -42,25 +43,25 @@ namespace osu.Game.Tests.Database
                 using (var importer = new BeatmapImporter(realmFactory, storage))
                 using (new RealmRulesetStore(realmFactory, storage))
                 {
-                    ILive<RealmBeatmapSet>? imported;
+                    ILive<BeatmapSetInfo>? imported;
 
                     using (var reader = new ZipArchiveReader(TestResources.GetTestBeatmapStream()))
                         imported = await importer.Import(reader);
 
-                    Assert.AreEqual(1, realmFactory.Context.All<RealmBeatmapSet>().Count());
+                    Assert.AreEqual(1, realmFactory.Context.All<BeatmapSetInfo>().Count());
 
                     Assert.NotNull(imported);
                     Debug.Assert(imported != null);
 
                     imported.PerformWrite(s => s.DeletePending = true);
 
-                    Assert.AreEqual(1, realmFactory.Context.All<RealmBeatmapSet>().Count(s => s.DeletePending));
+                    Assert.AreEqual(1, realmFactory.Context.All<BeatmapSetInfo>().Count(s => s.DeletePending));
                 }
             });
 
             Logger.Log("Running with no work to purge pending deletions");
 
-            RunTestWithRealm((realmFactory, _) => { Assert.AreEqual(0, realmFactory.Context.All<RealmBeatmapSet>().Count()); });
+            RunTestWithRealm((realmFactory, _) => { Assert.AreEqual(0, realmFactory.Context.All<BeatmapSetInfo>().Count()); });
         }
 
         [Test]
@@ -117,7 +118,7 @@ namespace osu.Game.Tests.Database
 
                 string? tempPath = TestResources.GetTestBeatmapForImport();
 
-                ILive<RealmBeatmapSet>? importedSet;
+                ILive<BeatmapSetInfo>? importedSet;
 
                 using (var stream = File.OpenRead(tempPath))
                 {
@@ -131,7 +132,7 @@ namespace osu.Game.Tests.Database
                 Assert.IsTrue(File.Exists(tempPath), "Stream source file somehow went missing");
                 File.Delete(tempPath);
 
-                var imported = realmFactory.Context.All<RealmBeatmapSet>().First(beatmapSet => beatmapSet.ID == importedSet.ID);
+                var imported = realmFactory.Context.All<BeatmapSetInfo>().First(beatmapSet => beatmapSet.ID == importedSet.ID);
 
                 deleteBeatmapSet(imported, realmFactory.Context);
             });
@@ -556,7 +557,7 @@ namespace osu.Game.Tests.Database
                 using var importer = new BeatmapImporter(realmFactory, storage);
                 using var store = new RealmRulesetStore(realmFactory, storage);
 
-                var metadata = new RealmBeatmapMetadata
+                var metadata = new BeatmapMetadata
                 {
                     Artist = "SomeArtist",
                     Author =
@@ -565,18 +566,18 @@ namespace osu.Game.Tests.Database
                     }
                 };
 
-                var ruleset = realmFactory.Context.All<RealmRuleset>().First();
+                var ruleset = realmFactory.Context.All<RulesetInfo>().First();
 
-                var toImport = new RealmBeatmapSet
+                var toImport = new BeatmapSetInfo
                 {
                     OnlineID = 1,
                     Beatmaps =
                     {
-                        new RealmBeatmap(ruleset, new RealmBeatmapDifficulty(), metadata)
+                        new BeatmapInfo(ruleset, new BeatmapDifficulty(), metadata)
                         {
                             OnlineID = 2,
                         },
-                        new RealmBeatmap(ruleset, new RealmBeatmapDifficulty(), metadata)
+                        new BeatmapInfo(ruleset, new BeatmapDifficulty(), metadata)
                         {
                             OnlineID = 2,
                             Status = BeatmapOnlineStatus.Loved,
@@ -752,18 +753,18 @@ namespace osu.Game.Tests.Database
                 await importer.Import(temp);
 
                 // Update via the beatmap, not the beatmap info, to ensure correct linking
-                RealmBeatmapSet setToUpdate = realmFactory.Context.All<RealmBeatmapSet>().First();
+                BeatmapSetInfo setToUpdate = realmFactory.Context.All<BeatmapSetInfo>().First();
 
                 var beatmapToUpdate = setToUpdate.Beatmaps.First();
 
                 realmFactory.Context.Write(() => beatmapToUpdate.DifficultyName = "updated");
 
-                RealmBeatmap updatedInfo = realmFactory.Context.All<RealmBeatmap>().First(b => b.ID == beatmapToUpdate.ID);
+                BeatmapInfo updatedInfo = realmFactory.Context.All<BeatmapInfo>().First(b => b.ID == beatmapToUpdate.ID);
                 Assert.That(updatedInfo.DifficultyName, Is.EqualTo("updated"));
             });
         }
 
-        public static async Task<RealmBeatmapSet?> LoadQuickOszIntoOsu(BeatmapImporter importer, Realm realm)
+        public static async Task<BeatmapSetInfo?> LoadQuickOszIntoOsu(BeatmapImporter importer, Realm realm)
         {
             string? temp = TestResources.GetQuickTestBeatmapForImport();
 
@@ -775,10 +776,10 @@ namespace osu.Game.Tests.Database
 
             waitForOrAssert(() => !File.Exists(temp), "Temporary file still exists after standard import", 5000);
 
-            return realm.All<RealmBeatmapSet>().FirstOrDefault(beatmapSet => beatmapSet.ID == importedSet!.ID);
+            return realm.All<BeatmapSetInfo>().FirstOrDefault(beatmapSet => beatmapSet.ID == importedSet!.ID);
         }
 
-        public static async Task<RealmBeatmapSet> LoadOszIntoStore(BeatmapImporter importer, Realm realm, string? path = null, bool virtualTrack = false)
+        public static async Task<BeatmapSetInfo> LoadOszIntoStore(BeatmapImporter importer, Realm realm, string? path = null, bool virtualTrack = false)
         {
             string? temp = path ?? TestResources.GetTestBeatmapForImport(virtualTrack);
 
@@ -791,20 +792,20 @@ namespace osu.Game.Tests.Database
 
             waitForOrAssert(() => !File.Exists(temp), "Temporary file still exists after standard import", 5000);
 
-            return realm.All<RealmBeatmapSet>().First(beatmapSet => beatmapSet.ID == importedSet.ID);
+            return realm.All<BeatmapSetInfo>().First(beatmapSet => beatmapSet.ID == importedSet.ID);
         }
 
-        private void deleteBeatmapSet(RealmBeatmapSet imported, Realm realm)
+        private void deleteBeatmapSet(BeatmapSetInfo imported, Realm realm)
         {
             realm.Write(() => imported.DeletePending = true);
 
             checkBeatmapSetCount(realm, 0);
             checkBeatmapSetCount(realm, 1, true);
 
-            Assert.IsTrue(realm.All<RealmBeatmapSet>().First(_ => true).DeletePending);
+            Assert.IsTrue(realm.All<BeatmapSetInfo>().First(_ => true).DeletePending);
         }
 
-        private static Task createScoreForBeatmap(Realm realm, RealmBeatmap beatmap)
+        private static Task createScoreForBeatmap(Realm realm, BeatmapInfo beatmap)
         {
             // TODO: reimplement when we have score support in realm.
             // return ImportScoreTest.LoadScoreIntoOsu(osu, new ScoreInfo
@@ -820,8 +821,8 @@ namespace osu.Game.Tests.Database
         private static void checkBeatmapSetCount(Realm realm, int expected, bool includeDeletePending = false)
         {
             Assert.AreEqual(expected, includeDeletePending
-                ? realm.All<RealmBeatmapSet>().Count()
-                : realm.All<RealmBeatmapSet>().Count(s => !s.DeletePending));
+                ? realm.All<BeatmapSetInfo>().Count()
+                : realm.All<BeatmapSetInfo>().Count(s => !s.DeletePending));
         }
 
         private static string hashFile(string filename)
@@ -832,7 +833,7 @@ namespace osu.Game.Tests.Database
 
         private static void checkBeatmapCount(Realm realm, int expected)
         {
-            Assert.AreEqual(expected, realm.All<RealmBeatmap>().Where(_ => true).ToList().Count);
+            Assert.AreEqual(expected, realm.All<BeatmapInfo>().Where(_ => true).ToList().Count);
         }
 
         private static void checkSingleReferencedFileCount(Realm realm, int expected)
@@ -850,24 +851,23 @@ namespace osu.Game.Tests.Database
 
         private static void ensureLoaded(Realm realm, int timeout = 60000)
         {
-            IQueryable<RealmBeatmapSet>? resultSets = null;
+            IQueryable<BeatmapSetInfo>? resultSets = null;
 
             waitForOrAssert(() =>
-                {
-                    realm.Refresh();
-                    return (resultSets = realm.All<RealmBeatmapSet>().Where(s => !s.DeletePending && s.OnlineID == 241526)).Any();
-                },
-                @"BeatmapSet did not import to the database in allocated time.", timeout);
+            {
+                realm.Refresh();
+                return (resultSets = realm.All<BeatmapSetInfo>().Where(s => !s.DeletePending && s.OnlineID == 241526)).Any();
+            }, @"BeatmapSet did not import to the database in allocated time.", timeout);
 
             // ensure we were stored to beatmap database backing...
             Assert.IsTrue(resultSets?.Count() == 1, $@"Incorrect result count found ({resultSets?.Count()} but should be 1).");
 
-            IEnumerable<RealmBeatmapSet> queryBeatmapSets() => realm.All<RealmBeatmapSet>().Where(s => !s.DeletePending && s.OnlineID == 241526);
+            IEnumerable<BeatmapSetInfo> queryBeatmapSets() => realm.All<BeatmapSetInfo>().Where(s => !s.DeletePending && s.OnlineID == 241526);
 
             var set = queryBeatmapSets().First();
 
             // ReSharper disable once PossibleUnintendedReferenceComparison
-            IEnumerable<RealmBeatmap> queryBeatmaps() => realm.All<RealmBeatmap>().Where(s => s.BeatmapSet != null && s.BeatmapSet == set);
+            IEnumerable<BeatmapInfo> queryBeatmaps() => realm.All<BeatmapInfo>().Where(s => s.BeatmapSet != null && s.BeatmapSet == set);
 
             Assert.AreEqual(12, queryBeatmaps().Count(), @"Beatmap count was not correct");
             Assert.AreEqual(1, queryBeatmapSets().Count(), @"Beatmapset count was not correct");
@@ -880,7 +880,7 @@ namespace osu.Game.Tests.Database
                 countBeatmaps = queryBeatmaps().Count(),
                 $@"Incorrect database beatmap count post-import ({countBeatmaps} but should be {countBeatmapSetBeatmaps}).");
 
-            foreach (RealmBeatmap b in set.Beatmaps)
+            foreach (BeatmapInfo b in set.Beatmaps)
                 Assert.IsTrue(set.Beatmaps.Any(c => c.OnlineID == b.OnlineID));
             Assert.IsTrue(set.Beatmaps.Count > 0);
         }
diff --git a/osu.Game.Tests/Database/GeneralUsageTests.cs b/osu.Game.Tests/Database/GeneralUsageTests.cs
index 2285b22a3a..0961ad71e4 100644
--- a/osu.Game.Tests/Database/GeneralUsageTests.cs
+++ b/osu.Game.Tests/Database/GeneralUsageTests.cs
@@ -5,8 +5,8 @@ using System;
 using System.Threading;
 using System.Threading.Tasks;
 using NUnit.Framework;
+using osu.Game.Beatmaps;
 using osu.Game.Database;
-using osu.Game.Models;
 
 #nullable enable
 
@@ -48,7 +48,7 @@ namespace osu.Game.Tests.Database
 
                 using (var context = realmFactory.CreateContext())
                 {
-                    var subscription = context.All<RealmBeatmap>().QueryAsyncWithNotifications((sender, changes, error) =>
+                    var subscription = context.All<BeatmapInfo>().QueryAsyncWithNotifications((sender, changes, error) =>
                     {
                         using (realmFactory.CreateContext())
                         {
diff --git a/osu.Game.Tests/Database/RealmLiveTests.cs b/osu.Game.Tests/Database/RealmLiveTests.cs
index 9432a56741..187fcd3ca7 100644
--- a/osu.Game.Tests/Database/RealmLiveTests.cs
+++ b/osu.Game.Tests/Database/RealmLiveTests.cs
@@ -8,8 +8,8 @@ using System.Threading.Tasks;
 using NUnit.Framework;
 using osu.Framework.Extensions;
 using osu.Framework.Testing;
+using osu.Game.Beatmaps;
 using osu.Game.Database;
-using osu.Game.Models;
 using Realms;
 
 #nullable enable
@@ -23,9 +23,9 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealm((realmFactory, _) =>
             {
-                ILive<RealmBeatmap> beatmap = realmFactory.CreateContext().Write(r => r.Add(new RealmBeatmap(CreateRuleset(), new RealmBeatmapDifficulty(), new RealmBeatmapMetadata()))).ToLive(realmFactory);
+                ILive<BeatmapInfo> beatmap = realmFactory.CreateContext().Write(r => r.Add(new BeatmapInfo(CreateRuleset(), new BeatmapDifficulty(), new BeatmapMetadata()))).ToLive(realmFactory);
 
-                ILive<RealmBeatmap> beatmap2 = realmFactory.CreateContext().All<RealmBeatmap>().First().ToLive(realmFactory);
+                ILive<BeatmapInfo> beatmap2 = realmFactory.CreateContext().All<BeatmapInfo>().First().ToLive(realmFactory);
 
                 Assert.AreEqual(beatmap, beatmap2);
             });
@@ -36,9 +36,9 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealm((realmFactory, storage) =>
             {
-                var beatmap = new RealmBeatmap(CreateRuleset(), new RealmBeatmapDifficulty(), new RealmBeatmapMetadata());
+                var beatmap = new BeatmapInfo(CreateRuleset(), new BeatmapDifficulty(), new BeatmapMetadata());
 
-                ILive<RealmBeatmap> liveBeatmap;
+                ILive<BeatmapInfo> liveBeatmap;
 
                 using (var context = realmFactory.CreateContext())
                 {
@@ -63,7 +63,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealm((realmFactory, _) =>
             {
-                var beatmap = new RealmBeatmap(CreateRuleset(), new RealmBeatmapDifficulty(), new RealmBeatmapMetadata());
+                var beatmap = new BeatmapInfo(CreateRuleset(), new BeatmapDifficulty(), new BeatmapMetadata());
 
                 var liveBeatmap = beatmap.ToLive(realmFactory);
 
@@ -77,7 +77,7 @@ namespace osu.Game.Tests.Database
         [Test]
         public void TestAccessNonManaged()
         {
-            var beatmap = new RealmBeatmap(CreateRuleset(), new RealmBeatmapDifficulty(), new RealmBeatmapMetadata());
+            var beatmap = new BeatmapInfo(CreateRuleset(), new BeatmapDifficulty(), new BeatmapMetadata());
             var liveBeatmap = beatmap.ToLiveUnmanaged();
 
             Assert.IsFalse(beatmap.Hidden);
@@ -96,12 +96,12 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealm((realmFactory, _) =>
             {
-                ILive<RealmBeatmap>? liveBeatmap = null;
+                ILive<BeatmapInfo>? liveBeatmap = null;
                 Task.Factory.StartNew(() =>
                 {
                     using (var threadContext = realmFactory.CreateContext())
                     {
-                        var beatmap = threadContext.Write(r => r.Add(new RealmBeatmap(CreateRuleset(), new RealmBeatmapDifficulty(), new RealmBeatmapMetadata())));
+                        var beatmap = threadContext.Write(r => r.Add(new BeatmapInfo(CreateRuleset(), new BeatmapDifficulty(), new BeatmapMetadata())));
 
                         liveBeatmap = beatmap.ToLive(realmFactory);
                     }
@@ -125,12 +125,12 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealm((realmFactory, _) =>
             {
-                ILive<RealmBeatmap>? liveBeatmap = null;
+                ILive<BeatmapInfo>? liveBeatmap = null;
                 Task.Factory.StartNew(() =>
                 {
                     using (var threadContext = realmFactory.CreateContext())
                     {
-                        var beatmap = threadContext.Write(r => r.Add(new RealmBeatmap(CreateRuleset(), new RealmBeatmapDifficulty(), new RealmBeatmapMetadata())));
+                        var beatmap = threadContext.Write(r => r.Add(new BeatmapInfo(CreateRuleset(), new BeatmapDifficulty(), new BeatmapMetadata())));
 
                         liveBeatmap = beatmap.ToLive(realmFactory);
                     }
@@ -151,7 +151,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealm((realmFactory, _) =>
             {
-                var beatmap = new RealmBeatmap(CreateRuleset(), new RealmBeatmapDifficulty(), new RealmBeatmapMetadata());
+                var beatmap = new BeatmapInfo(CreateRuleset(), new BeatmapDifficulty(), new BeatmapMetadata());
                 var liveBeatmap = beatmap.ToLive(realmFactory);
 
                 Assert.DoesNotThrow(() =>
@@ -166,13 +166,13 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealm((realmFactory, _) =>
             {
-                ILive<RealmBeatmap>? liveBeatmap = null;
+                ILive<BeatmapInfo>? liveBeatmap = null;
 
                 Task.Factory.StartNew(() =>
                 {
                     using (var threadContext = realmFactory.CreateContext())
                     {
-                        var beatmap = threadContext.Write(r => r.Add(new RealmBeatmap(CreateRuleset(), new RealmBeatmapDifficulty(), new RealmBeatmapMetadata())));
+                        var beatmap = threadContext.Write(r => r.Add(new BeatmapInfo(CreateRuleset(), new BeatmapDifficulty(), new BeatmapMetadata())));
 
                         liveBeatmap = beatmap.ToLive(realmFactory);
                     }
@@ -205,12 +205,12 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealm((realmFactory, _) =>
             {
-                ILive<RealmBeatmap>? liveBeatmap = null;
+                ILive<BeatmapInfo>? liveBeatmap = null;
                 Task.Factory.StartNew(() =>
                 {
                     using (var threadContext = realmFactory.CreateContext())
                     {
-                        var beatmap = threadContext.Write(r => r.Add(new RealmBeatmap(CreateRuleset(), new RealmBeatmapDifficulty(), new RealmBeatmapMetadata())));
+                        var beatmap = threadContext.Write(r => r.Add(new BeatmapInfo(CreateRuleset(), new BeatmapDifficulty(), new BeatmapMetadata())));
 
                         liveBeatmap = beatmap.ToLive(realmFactory);
                     }
@@ -237,19 +237,19 @@ namespace osu.Game.Tests.Database
 
                 using (var updateThreadContext = realmFactory.CreateContext())
                 {
-                    updateThreadContext.All<RealmBeatmap>().QueryAsyncWithNotifications(gotChange);
-                    ILive<RealmBeatmap>? liveBeatmap = null;
+                    updateThreadContext.All<BeatmapInfo>().QueryAsyncWithNotifications(gotChange);
+                    ILive<BeatmapInfo>? liveBeatmap = null;
 
                     Task.Factory.StartNew(() =>
                     {
                         using (var threadContext = realmFactory.CreateContext())
                         {
                             var ruleset = CreateRuleset();
-                            var beatmap = threadContext.Write(r => r.Add(new RealmBeatmap(ruleset, new RealmBeatmapDifficulty(), new RealmBeatmapMetadata())));
+                            var beatmap = threadContext.Write(r => r.Add(new BeatmapInfo(ruleset, new BeatmapDifficulty(), new BeatmapMetadata())));
 
                             // add a second beatmap to ensure that a full refresh occurs below.
                             // not just a refresh from the resolved Live.
-                            threadContext.Write(r => r.Add(new RealmBeatmap(ruleset, new RealmBeatmapDifficulty(), new RealmBeatmapMetadata())));
+                            threadContext.Write(r => r.Add(new BeatmapInfo(ruleset, new BeatmapDifficulty(), new BeatmapMetadata())));
 
                             liveBeatmap = beatmap.ToLive(realmFactory);
                         }
@@ -258,14 +258,14 @@ namespace osu.Game.Tests.Database
                     Debug.Assert(liveBeatmap != null);
 
                     // not yet seen by main context
-                    Assert.AreEqual(0, updateThreadContext.All<RealmBeatmap>().Count());
+                    Assert.AreEqual(0, updateThreadContext.All<BeatmapInfo>().Count());
                     Assert.AreEqual(0, changesTriggered);
 
                     liveBeatmap.PerformRead(resolved =>
                     {
                         // retrieval causes an implicit refresh. even changes that aren't related to the retrieval are fired at this point.
                         // ReSharper disable once AccessToDisposedClosure
-                        Assert.AreEqual(2, updateThreadContext.All<RealmBeatmap>().Count());
+                        Assert.AreEqual(2, updateThreadContext.All<BeatmapInfo>().Count());
                         Assert.AreEqual(1, changesTriggered);
 
                         // can access properties without a crash.
@@ -280,7 +280,7 @@ namespace osu.Game.Tests.Database
                     });
                 }
 
-                void gotChange(IRealmCollection<RealmBeatmap> sender, ChangeSet changes, Exception error)
+                void gotChange(IRealmCollection<BeatmapInfo> sender, ChangeSet changes, Exception error)
                 {
                     changesTriggered++;
                 }
diff --git a/osu.Game.Tests/Database/RealmTest.cs b/osu.Game.Tests/Database/RealmTest.cs
index 4e67f09dca..0cee165f75 100644
--- a/osu.Game.Tests/Database/RealmTest.cs
+++ b/osu.Game.Tests/Database/RealmTest.cs
@@ -9,9 +9,11 @@ using osu.Framework.Extensions;
 using osu.Framework.Logging;
 using osu.Framework.Platform;
 using osu.Framework.Testing;
+using osu.Game.Beatmaps;
 using osu.Game.Database;
 using osu.Game.IO;
 using osu.Game.Models;
+using osu.Game.Rulesets;
 
 #nullable enable
 
@@ -74,24 +76,24 @@ namespace osu.Game.Tests.Database
             }
         }
 
-        protected static RealmBeatmapSet CreateBeatmapSet(RealmRuleset ruleset)
+        protected static BeatmapSetInfo CreateBeatmapSet(RulesetInfo ruleset)
         {
             RealmFile createRealmFile() => new RealmFile { Hash = Guid.NewGuid().ToString().ComputeSHA2Hash() };
 
-            var metadata = new RealmBeatmapMetadata
+            var metadata = new BeatmapMetadata
             {
                 Title = "My Love",
                 Artist = "Kuba Oms"
             };
 
-            var beatmapSet = new RealmBeatmapSet
+            var beatmapSet = new BeatmapSetInfo
             {
                 Beatmaps =
                 {
-                    new RealmBeatmap(ruleset, new RealmBeatmapDifficulty(), metadata) { DifficultyName = "Easy", },
-                    new RealmBeatmap(ruleset, new RealmBeatmapDifficulty(), metadata) { DifficultyName = "Normal", },
-                    new RealmBeatmap(ruleset, new RealmBeatmapDifficulty(), metadata) { DifficultyName = "Hard", },
-                    new RealmBeatmap(ruleset, new RealmBeatmapDifficulty(), metadata) { DifficultyName = "Insane", }
+                    new BeatmapInfo(ruleset, new BeatmapDifficulty(), metadata) { DifficultyName = "Easy", },
+                    new BeatmapInfo(ruleset, new BeatmapDifficulty(), metadata) { DifficultyName = "Normal", },
+                    new BeatmapInfo(ruleset, new BeatmapDifficulty(), metadata) { DifficultyName = "Hard", },
+                    new BeatmapInfo(ruleset, new BeatmapDifficulty(), metadata) { DifficultyName = "Insane", }
                 },
                 Files =
                 {
@@ -111,8 +113,8 @@ namespace osu.Game.Tests.Database
             return beatmapSet;
         }
 
-        protected static RealmRuleset CreateRuleset() =>
-            new RealmRuleset(0, "osu!", "osu", true);
+        protected static RulesetInfo CreateRuleset() =>
+            new RulesetInfo(0, "osu!", "osu", true);
 
         private class RealmTestGame : Framework.Game
         {
diff --git a/osu.Game.Tests/Database/RulesetStoreTests.cs b/osu.Game.Tests/Database/RulesetStoreTests.cs
index cc7e8a0c97..d2de31d11a 100644
--- a/osu.Game.Tests/Database/RulesetStoreTests.cs
+++ b/osu.Game.Tests/Database/RulesetStoreTests.cs
@@ -3,7 +3,7 @@
 
 using System.Linq;
 using NUnit.Framework;
-using osu.Game.Models;
+using osu.Game.Rulesets;
 using osu.Game.Stores;
 
 namespace osu.Game.Tests.Database
@@ -18,7 +18,7 @@ namespace osu.Game.Tests.Database
                 var rulesets = new RealmRulesetStore(realmFactory, storage);
 
                 Assert.AreEqual(4, rulesets.AvailableRulesets.Count());
-                Assert.AreEqual(4, realmFactory.Context.All<RealmRuleset>().Count());
+                Assert.AreEqual(4, realmFactory.Context.All<RulesetInfo>().Count());
             });
         }
 
@@ -34,7 +34,7 @@ namespace osu.Game.Tests.Database
                 Assert.AreEqual(4, rulesets2.AvailableRulesets.Count());
 
                 Assert.AreEqual(rulesets.AvailableRulesets.First(), rulesets2.AvailableRulesets.First());
-                Assert.AreEqual(4, realmFactory.Context.All<RealmRuleset>().Count());
+                Assert.AreEqual(4, realmFactory.Context.All<RulesetInfo>().Count());
             });
         }
 
diff --git a/osu.Game/Models/RealmBeatmapDifficulty.cs b/osu.Game/Beatmaps/BeatmapDifficulty.cs
similarity index 76%
rename from osu.Game/Models/RealmBeatmapDifficulty.cs
rename to osu.Game/Beatmaps/BeatmapDifficulty.cs
index 3c1dad69e4..6425c7b291 100644
--- a/osu.Game/Models/RealmBeatmapDifficulty.cs
+++ b/osu.Game/Beatmaps/BeatmapDifficulty.cs
@@ -2,16 +2,15 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using osu.Framework.Testing;
-using osu.Game.Beatmaps;
 using Realms;
 
 #nullable enable
 
-namespace osu.Game.Models
+namespace osu.Game.Beatmaps
 {
     [ExcludeFromDynamicCompile]
     [MapTo("BeatmapDifficulty")]
-    public class RealmBeatmapDifficulty : EmbeddedObject, IBeatmapDifficultyInfo
+    public class BeatmapDifficulty : EmbeddedObject, IBeatmapDifficultyInfo
     {
         public float DrainRate { get; set; } = IBeatmapDifficultyInfo.DEFAULT_DIFFICULTY;
         public float CircleSize { get; set; } = IBeatmapDifficultyInfo.DEFAULT_DIFFICULTY;
@@ -22,16 +21,16 @@ namespace osu.Game.Models
         public double SliderTickRate { get; set; } = 1;
 
         /// <summary>
-        /// Returns a shallow-clone of this <see cref="RealmBeatmapDifficulty"/>.
+        /// Returns a shallow-clone of this <see cref="BeatmapDifficulty"/>.
         /// </summary>
-        public RealmBeatmapDifficulty Clone()
+        public BeatmapDifficulty Clone()
         {
-            var diff = new RealmBeatmapDifficulty();
+            var diff = new BeatmapDifficulty();
             CopyTo(diff);
             return diff;
         }
 
-        public void CopyTo(RealmBeatmapDifficulty difficulty)
+        public void CopyTo(BeatmapDifficulty difficulty)
         {
             difficulty.ApproachRate = ApproachRate;
             difficulty.DrainRate = DrainRate;
diff --git a/osu.Game/Models/RealmBeatmap.cs b/osu.Game/Beatmaps/BeatmapInfo.cs
similarity index 80%
rename from osu.Game/Models/RealmBeatmap.cs
rename to osu.Game/Beatmaps/BeatmapInfo.cs
index 8e132687f7..b000862457 100644
--- a/osu.Game/Models/RealmBeatmap.cs
+++ b/osu.Game/Beatmaps/BeatmapInfo.cs
@@ -6,14 +6,14 @@ using System.Linq;
 using JetBrains.Annotations;
 using Newtonsoft.Json;
 using osu.Framework.Testing;
-using osu.Game.Beatmaps;
 using osu.Game.Database;
+using osu.Game.Models;
 using osu.Game.Rulesets;
 using Realms;
 
 #nullable enable
 
-namespace osu.Game.Models
+namespace osu.Game.Beatmaps
 {
     /// <summary>
     /// A single beatmap difficulty.
@@ -21,20 +21,20 @@ namespace osu.Game.Models
     [ExcludeFromDynamicCompile]
     [Serializable]
     [MapTo("Beatmap")]
-    public class RealmBeatmap : RealmObject, IHasGuidPrimaryKey, IBeatmapInfo, IEquatable<RealmBeatmap>
+    public class BeatmapInfo : RealmObject, IHasGuidPrimaryKey, IBeatmapInfo, IEquatable<BeatmapInfo>
     {
         [PrimaryKey]
         public Guid ID { get; set; } = Guid.NewGuid();
 
         public string DifficultyName { get; set; } = string.Empty;
 
-        public RealmRuleset Ruleset { get; set; } = null!;
+        public RulesetInfo Ruleset { get; set; } = null!;
 
-        public RealmBeatmapDifficulty Difficulty { get; set; } = null!;
+        public BeatmapDifficulty Difficulty { get; set; } = null!;
 
-        public RealmBeatmapMetadata Metadata { get; set; } = null!;
+        public BeatmapMetadata Metadata { get; set; } = null!;
 
-        public RealmBeatmapSet? BeatmapSet { get; set; }
+        public BeatmapSetInfo? BeatmapSet { get; set; }
 
         [Ignored]
         public RealmNamedFileUsage? File => BeatmapSet?.Files.First(f => f.File.Hash == Hash);
@@ -64,7 +64,7 @@ namespace osu.Game.Models
         [JsonIgnore]
         public bool Hidden { get; set; }
 
-        public RealmBeatmap(RealmRuleset ruleset, RealmBeatmapDifficulty difficulty, RealmBeatmapMetadata metadata)
+        public BeatmapInfo(RulesetInfo ruleset, BeatmapDifficulty difficulty, BeatmapMetadata metadata)
         {
             Ruleset = ruleset;
             Difficulty = difficulty;
@@ -72,7 +72,7 @@ namespace osu.Game.Models
         }
 
         [UsedImplicitly]
-        private RealmBeatmap()
+        private BeatmapInfo()
         {
         }
 
@@ -102,7 +102,7 @@ namespace osu.Game.Models
 
         #endregion
 
-        public bool Equals(RealmBeatmap? other)
+        public bool Equals(BeatmapInfo? other)
         {
             if (ReferenceEquals(this, other)) return true;
             if (other == null) return false;
@@ -110,15 +110,15 @@ namespace osu.Game.Models
             return ID == other.ID;
         }
 
-        public bool Equals(IBeatmapInfo? other) => other is RealmBeatmap b && Equals(b);
+        public bool Equals(IBeatmapInfo? other) => other is BeatmapInfo b && Equals(b);
 
-        public bool AudioEquals(RealmBeatmap? other) => other != null
+        public bool AudioEquals(BeatmapInfo? other) => other != null
                                                         && BeatmapSet != null
                                                         && other.BeatmapSet != null
                                                         && BeatmapSet.Hash == other.BeatmapSet.Hash
                                                         && Metadata.AudioFile == other.Metadata.AudioFile;
 
-        public bool BackgroundEquals(RealmBeatmap? other) => other != null
+        public bool BackgroundEquals(BeatmapInfo? other) => other != null
                                                              && BeatmapSet != null
                                                              && other.BeatmapSet != null
                                                              && BeatmapSet.Hash == other.BeatmapSet.Hash
diff --git a/osu.Game/Models/RealmBeatmapMetadata.cs b/osu.Game/Beatmaps/BeatmapMetadata.cs
similarity index 91%
rename from osu.Game/Models/RealmBeatmapMetadata.cs
rename to osu.Game/Beatmaps/BeatmapMetadata.cs
index db1b09e6ad..387641db40 100644
--- a/osu.Game/Models/RealmBeatmapMetadata.cs
+++ b/osu.Game/Beatmaps/BeatmapMetadata.cs
@@ -4,18 +4,18 @@
 using System;
 using Newtonsoft.Json;
 using osu.Framework.Testing;
-using osu.Game.Beatmaps;
+using osu.Game.Models;
 using osu.Game.Users;
 using Realms;
 
 #nullable enable
 
-namespace osu.Game.Models
+namespace osu.Game.Beatmaps
 {
     [ExcludeFromDynamicCompile]
     [Serializable]
     [MapTo("BeatmapMetadata")]
-    public class RealmBeatmapMetadata : RealmObject, IBeatmapMetadataInfo
+    public class BeatmapMetadata : RealmObject, IBeatmapMetadataInfo
     {
         public string Title { get; set; } = string.Empty;
 
diff --git a/osu.Game/Models/RealmBeatmapSet.cs b/osu.Game/Beatmaps/BeatmapSetInfo.cs
similarity index 84%
rename from osu.Game/Models/RealmBeatmapSet.cs
rename to osu.Game/Beatmaps/BeatmapSetInfo.cs
index 3566ff5321..4aea0c6ce8 100644
--- a/osu.Game/Models/RealmBeatmapSet.cs
+++ b/osu.Game/Beatmaps/BeatmapSetInfo.cs
@@ -5,18 +5,18 @@ using System;
 using System.Collections.Generic;
 using System.Linq;
 using osu.Framework.Testing;
-using osu.Game.Beatmaps;
 using osu.Game.Database;
 using osu.Game.Extensions;
+using osu.Game.Models;
 using Realms;
 
 #nullable enable
 
-namespace osu.Game.Models
+namespace osu.Game.Beatmaps
 {
     [ExcludeFromDynamicCompile]
     [MapTo("BeatmapSet")]
-    public class RealmBeatmapSet : RealmObject, IHasGuidPrimaryKey, IHasRealmFiles, ISoftDelete, IEquatable<RealmBeatmapSet>, IBeatmapSetInfo
+    public class BeatmapSetInfo : RealmObject, IHasGuidPrimaryKey, IHasRealmFiles, ISoftDelete, IEquatable<BeatmapSetInfo>, IBeatmapSetInfo
     {
         [PrimaryKey]
         public Guid ID { get; set; } = Guid.NewGuid();
@@ -26,9 +26,9 @@ namespace osu.Game.Models
 
         public DateTimeOffset DateAdded { get; set; }
 
-        public IBeatmapMetadataInfo Metadata => Beatmaps.FirstOrDefault()?.Metadata ?? new RealmBeatmapMetadata();
+        public IBeatmapMetadataInfo Metadata => Beatmaps.FirstOrDefault()?.Metadata ?? new BeatmapMetadata();
 
-        public IList<RealmBeatmap> Beatmaps { get; } = null!;
+        public IList<BeatmapInfo> Beatmaps { get; } = null!;
 
         public IList<RealmNamedFileUsage> Files { get; } = null!;
 
@@ -63,7 +63,7 @@ namespace osu.Game.Models
         /// <param name="filename">The name of the file to get the storage path of.</param>
         public string? GetPathForFile(string filename) => Files.SingleOrDefault(f => string.Equals(f.Filename, filename, StringComparison.OrdinalIgnoreCase))?.File.GetStoragePath();
 
-        public bool Equals(RealmBeatmapSet? other)
+        public bool Equals(BeatmapSetInfo? other)
         {
             if (ReferenceEquals(this, other)) return true;
             if (other == null) return false;
@@ -73,7 +73,7 @@ namespace osu.Game.Models
 
         public override string ToString() => Metadata.GetDisplayString();
 
-        public bool Equals(IBeatmapSetInfo? other) => other is RealmBeatmapSet b && Equals(b);
+        public bool Equals(IBeatmapSetInfo? other) => other is BeatmapSetInfo b && Equals(b);
 
         IEnumerable<IBeatmapInfo> IBeatmapSetInfo.Beatmaps => Beatmaps;
         IEnumerable<INamedFileUsage> IHasNamedFiles.Files => Files;
diff --git a/osu.Game/Database/RealmContextFactory.cs b/osu.Game/Database/RealmContextFactory.cs
index 96c24837a1..946dda1f39 100644
--- a/osu.Game/Database/RealmContextFactory.cs
+++ b/osu.Game/Database/RealmContextFactory.cs
@@ -12,6 +12,7 @@ using osu.Framework.Logging;
 using osu.Framework.Platform;
 using osu.Framework.Statistics;
 using osu.Game.Configuration;
+using osu.Game.Beatmaps;
 using osu.Game.Input.Bindings;
 using osu.Game.Models;
 using osu.Game.Skinning;
@@ -109,7 +110,7 @@ namespace osu.Game.Database
             using (var realm = CreateContext())
             using (var transaction = realm.BeginWrite())
             {
-                var pendingDeleteSets = realm.All<RealmBeatmapSet>().Where(s => s.DeletePending);
+                var pendingDeleteSets = realm.All<BeatmapSetInfo>().Where(s => s.DeletePending);
 
                 foreach (var s in pendingDeleteSets)
                 {
@@ -206,9 +207,9 @@ namespace osu.Game.Database
             switch (targetVersion)
             {
                 case 7:
-                    convertOnlineIDs<RealmBeatmap>();
-                    convertOnlineIDs<RealmBeatmapSet>();
-                    convertOnlineIDs<RealmRuleset>();
+                    convertOnlineIDs<BeatmapInfo>();
+                    convertOnlineIDs<BeatmapSetInfo>();
+                    convertOnlineIDs<RulesetInfo>();
 
                     void convertOnlineIDs<T>() where T : RealmObject
                     {
@@ -253,14 +254,14 @@ namespace osu.Game.Database
 
                 case 9:
                     // Pretty pointless to do this as beatmaps aren't really loaded via realm yet, but oh well.
-                    string metadataClassName = getMappedOrOriginalName(typeof(RealmBeatmapMetadata));
+                    string metadataClassName = getMappedOrOriginalName(typeof(BeatmapMetadata));
 
                     // May be coming from a version before `RealmBeatmapMetadata` existed.
                     if (!migration.OldRealm.Schema.TryFindObjectSchema(metadataClassName, out _))
                         return;
 
                     var oldMetadata = migration.OldRealm.DynamicApi.All(metadataClassName);
-                    var newMetadata = migration.NewRealm.All<RealmBeatmapMetadata>();
+                    var newMetadata = migration.NewRealm.All<BeatmapMetadata>();
 
                     int metadataCount = newMetadata.Count();
 
diff --git a/osu.Game/Models/RealmRuleset.cs b/osu.Game/Rulesets/RulesetInfo.cs
similarity index 74%
rename from osu.Game/Models/RealmRuleset.cs
rename to osu.Game/Rulesets/RulesetInfo.cs
index b959d0b4dc..91a3d181f8 100644
--- a/osu.Game/Models/RealmRuleset.cs
+++ b/osu.Game/Rulesets/RulesetInfo.cs
@@ -4,16 +4,15 @@
 using System;
 using JetBrains.Annotations;
 using osu.Framework.Testing;
-using osu.Game.Rulesets;
 using Realms;
 
 #nullable enable
 
-namespace osu.Game.Models
+namespace osu.Game.Rulesets
 {
     [ExcludeFromDynamicCompile]
     [MapTo("Ruleset")]
-    public class RealmRuleset : RealmObject, IEquatable<RealmRuleset>, IRulesetInfo
+    public class RulesetInfo : RealmObject, IEquatable<RulesetInfo>, IRulesetInfo
     {
         [PrimaryKey]
         public string ShortName { get; set; } = string.Empty;
@@ -25,7 +24,7 @@ namespace osu.Game.Models
 
         public string InstantiationInfo { get; set; } = string.Empty;
 
-        public RealmRuleset(string shortName, string name, string instantiationInfo, int onlineID)
+        public RulesetInfo(string shortName, string name, string instantiationInfo, int onlineID)
         {
             ShortName = shortName;
             Name = name;
@@ -34,11 +33,11 @@ namespace osu.Game.Models
         }
 
         [UsedImplicitly]
-        private RealmRuleset()
+        private RulesetInfo()
         {
         }
 
-        public RealmRuleset(int? onlineID, string name, string shortName, bool available)
+        public RulesetInfo(int? onlineID, string name, string shortName, bool available)
         {
             OnlineID = onlineID ?? -1;
             Name = name;
@@ -48,13 +47,13 @@ namespace osu.Game.Models
 
         public bool Available { get; set; }
 
-        public bool Equals(RealmRuleset? other) => other != null && OnlineID == other.OnlineID && Available == other.Available && Name == other.Name && InstantiationInfo == other.InstantiationInfo;
+        public bool Equals(RulesetInfo? other) => other != null && OnlineID == other.OnlineID && Available == other.Available && Name == other.Name && InstantiationInfo == other.InstantiationInfo;
 
-        public bool Equals(IRulesetInfo? other) => other is RealmRuleset b && Equals(b);
+        public bool Equals(IRulesetInfo? other) => other is RulesetInfo b && Equals(b);
 
         public override string ToString() => Name;
 
-        public RealmRuleset Clone() => new RealmRuleset
+        public RulesetInfo Clone() => new RulesetInfo
         {
             OnlineID = OnlineID,
             Name = Name,
diff --git a/osu.Game/Stores/BeatmapImporter.cs b/osu.Game/Stores/BeatmapImporter.cs
index 8ab6941885..69c136b51c 100644
--- a/osu.Game/Stores/BeatmapImporter.cs
+++ b/osu.Game/Stores/BeatmapImporter.cs
@@ -34,7 +34,7 @@ namespace osu.Game.Stores
     /// Handles the storage and retrieval of Beatmaps/WorkingBeatmaps.
     /// </summary>
     [ExcludeFromDynamicCompile]
-    public class BeatmapImporter : RealmArchiveModelImporter<RealmBeatmapSet>, IDisposable
+    public class BeatmapImporter : RealmArchiveModelImporter<BeatmapSetInfo>, IDisposable
     {
         public override IEnumerable<string> HandledExtensions => new[] { ".osz" };
 
@@ -53,12 +53,12 @@ namespace osu.Game.Stores
 
         protected override bool ShouldDeleteArchive(string path) => Path.GetExtension(path).ToLowerInvariant() == ".osz";
 
-        protected override Task Populate(RealmBeatmapSet beatmapSet, ArchiveReader? archive, Realm realm, CancellationToken cancellationToken = default)
+        protected override Task Populate(BeatmapSetInfo beatmapSet, ArchiveReader? archive, Realm realm, CancellationToken cancellationToken = default)
         {
             if (archive != null)
                 beatmapSet.Beatmaps.AddRange(createBeatmapDifficulties(beatmapSet.Files, realm));
 
-            foreach (RealmBeatmap b in beatmapSet.Beatmaps)
+            foreach (BeatmapInfo b in beatmapSet.Beatmaps)
                 b.BeatmapSet = beatmapSet;
 
             validateOnlineIds(beatmapSet, realm);
@@ -84,7 +84,7 @@ namespace osu.Game.Stores
             return Task.CompletedTask;
         }
 
-        protected override void PreImport(RealmBeatmapSet beatmapSet, Realm realm)
+        protected override void PreImport(BeatmapSetInfo beatmapSet, Realm realm)
         {
             // We are about to import a new beatmap. Before doing so, ensure that no other set shares the online IDs used by the new one.
             // Note that this means if the previous beatmap is restored by the user, it will no longer be linked to its online IDs.
@@ -93,7 +93,7 @@ namespace osu.Game.Stores
 
             if (beatmapSet.OnlineID > 0)
             {
-                var existingSetWithSameOnlineID = realm.All<RealmBeatmapSet>().SingleOrDefault(b => b.OnlineID == beatmapSet.OnlineID);
+                var existingSetWithSameOnlineID = realm.All<BeatmapSetInfo>().SingleOrDefault(b => b.OnlineID == beatmapSet.OnlineID);
 
                 if (existingSetWithSameOnlineID != null)
                 {
@@ -108,7 +108,7 @@ namespace osu.Game.Stores
             }
         }
 
-        private void validateOnlineIds(RealmBeatmapSet beatmapSet, Realm realm)
+        private void validateOnlineIds(BeatmapSetInfo beatmapSet, Realm realm)
         {
             var beatmapIds = beatmapSet.Beatmaps.Where(b => b.OnlineID > 0).Select(b => b.OnlineID).ToList();
 
@@ -121,10 +121,10 @@ namespace osu.Game.Stores
             }
 
             // find any existing beatmaps in the database that have matching online ids
-            List<RealmBeatmap> existingBeatmaps = new List<RealmBeatmap>();
+            List<BeatmapInfo> existingBeatmaps = new List<BeatmapInfo>();
 
             foreach (int id in beatmapIds)
-                existingBeatmaps.AddRange(realm.All<RealmBeatmap>().Where(b => b.OnlineID == id));
+                existingBeatmaps.AddRange(realm.All<BeatmapInfo>().Where(b => b.OnlineID == id));
 
             if (existingBeatmaps.Any())
             {
@@ -143,7 +143,7 @@ namespace osu.Game.Stores
             void resetIds() => beatmapSet.Beatmaps.ForEach(b => b.OnlineID = -1);
         }
 
-        protected override bool CanSkipImport(RealmBeatmapSet existing, RealmBeatmapSet import)
+        protected override bool CanSkipImport(BeatmapSetInfo existing, BeatmapSetInfo import)
         {
             if (!base.CanSkipImport(existing, import))
                 return false;
@@ -151,7 +151,7 @@ namespace osu.Game.Stores
             return existing.Beatmaps.Any(b => b.OnlineID > 0);
         }
 
-        protected override bool CanReuseExisting(RealmBeatmapSet existing, RealmBeatmapSet import)
+        protected override bool CanReuseExisting(BeatmapSetInfo existing, BeatmapSetInfo import)
         {
             if (!base.CanReuseExisting(existing, import))
                 return false;
@@ -165,7 +165,7 @@ namespace osu.Game.Stores
 
         public override string HumanisedModelName => "beatmap";
 
-        protected override RealmBeatmapSet? CreateModel(ArchiveReader reader)
+        protected override BeatmapSetInfo? CreateModel(ArchiveReader reader)
         {
             // let's make sure there are actually .osu files to import.
             string? mapName = reader.Filenames.FirstOrDefault(f => f.EndsWith(".osu", StringComparison.OrdinalIgnoreCase));
@@ -180,7 +180,7 @@ namespace osu.Game.Stores
             using (var stream = new LineBufferedReader(reader.GetStream(mapName)))
                 beatmap = Decoder.GetDecoder<Beatmap>(stream).Decode(stream);
 
-            return new RealmBeatmapSet
+            return new BeatmapSetInfo
             {
                 OnlineID = beatmap.BeatmapInfo.BeatmapSet?.OnlineID ?? -1,
                 // Metadata = beatmap.Metadata,
@@ -189,11 +189,11 @@ namespace osu.Game.Stores
         }
 
         /// <summary>
-        /// Create all required <see cref="RealmBeatmap"/>s for the provided archive.
+        /// Create all required <see cref="BeatmapInfo"/>s for the provided archive.
         /// </summary>
-        private List<RealmBeatmap> createBeatmapDifficulties(IList<RealmNamedFileUsage> files, Realm realm)
+        private List<BeatmapInfo> createBeatmapDifficulties(IList<RealmNamedFileUsage> files, Realm realm)
         {
-            var beatmaps = new List<RealmBeatmap>();
+            var beatmaps = new List<BeatmapInfo>();
 
             foreach (var file in files.Where(f => f.Filename.EndsWith(".osu", StringComparison.OrdinalIgnoreCase)))
             {
@@ -214,7 +214,7 @@ namespace osu.Game.Stores
                     var decodedInfo = decoded.BeatmapInfo;
                     var decodedDifficulty = decodedInfo.BaseDifficulty;
 
-                    var ruleset = realm.All<RealmRuleset>().FirstOrDefault(r => r.OnlineID == decodedInfo.RulesetID);
+                    var ruleset = realm.All<RulesetInfo>().FirstOrDefault(r => r.OnlineID == decodedInfo.RulesetID);
 
                     if (ruleset?.Available != true)
                     {
@@ -222,7 +222,7 @@ namespace osu.Game.Stores
                         continue;
                     }
 
-                    var difficulty = new RealmBeatmapDifficulty
+                    var difficulty = new BeatmapDifficulty
                     {
                         DrainRate = decodedDifficulty.DrainRate,
                         CircleSize = decodedDifficulty.CircleSize,
@@ -232,7 +232,7 @@ namespace osu.Game.Stores
                         SliderTickRate = decodedDifficulty.SliderTickRate,
                     };
 
-                    var metadata = new RealmBeatmapMetadata
+                    var metadata = new BeatmapMetadata
                     {
                         Title = decoded.Metadata.Title,
                         TitleUnicode = decoded.Metadata.TitleUnicode,
@@ -250,7 +250,7 @@ namespace osu.Game.Stores
                         BackgroundFile = decoded.Metadata.BackgroundFile,
                     };
 
-                    var beatmap = new RealmBeatmap(ruleset, difficulty, metadata)
+                    var beatmap = new BeatmapInfo(ruleset, difficulty, metadata)
                     {
                         Hash = hash,
                         DifficultyName = decodedInfo.DifficultyName,
@@ -278,7 +278,7 @@ namespace osu.Game.Stores
             return beatmaps;
         }
 
-        private void updateBeatmapStatistics(RealmBeatmap beatmap, IBeatmap decoded)
+        private void updateBeatmapStatistics(BeatmapInfo beatmap, IBeatmap decoded)
         {
             var rulesetInstance = ((IRulesetInfo)beatmap.Ruleset).CreateInstance();
 
diff --git a/osu.Game/Stores/RealmRulesetStore.cs b/osu.Game/Stores/RealmRulesetStore.cs
index 93b6d29e7d..f208b392cb 100644
--- a/osu.Game/Stores/RealmRulesetStore.cs
+++ b/osu.Game/Stores/RealmRulesetStore.cs
@@ -11,7 +11,6 @@ using osu.Framework.Extensions.ObjectExtensions;
 using osu.Framework.Logging;
 using osu.Framework.Platform;
 using osu.Game.Database;
-using osu.Game.Models;
 using osu.Game.Rulesets;
 
 #nullable enable
@@ -106,7 +105,7 @@ namespace osu.Game.Stores
             {
                 context.Write(realm =>
                 {
-                    var rulesets = realm.All<RealmRuleset>();
+                    var rulesets = realm.All<RulesetInfo>();
 
                     List<Ruleset> instances = loadedAssemblies.Values
                                                               .Select(r => Activator.CreateInstance(r) as Ruleset)
@@ -117,8 +116,8 @@ namespace osu.Game.Stores
                     // add all legacy rulesets first to ensure they have exclusive choice of primary key.
                     foreach (var r in instances.Where(r => r is ILegacyRuleset))
                     {
-                        if (realm.All<RealmRuleset>().FirstOrDefault(rr => rr.OnlineID == r.RulesetInfo.OnlineID) == null)
-                            realm.Add(new RealmRuleset(r.RulesetInfo.ShortName, r.RulesetInfo.Name, r.RulesetInfo.InstantiationInfo, r.RulesetInfo.OnlineID));
+                        if (realm.All<RulesetInfo>().FirstOrDefault(rr => rr.OnlineID == r.RulesetInfo.OnlineID) == null)
+                            realm.Add(new RulesetInfo(r.RulesetInfo.ShortName, r.RulesetInfo.Name, r.RulesetInfo.InstantiationInfo, r.RulesetInfo.OnlineID));
                     }
 
                     // add any other rulesets which have assemblies present but are not yet in the database.
@@ -136,11 +135,11 @@ namespace osu.Game.Stores
                                 existingSameShortName.InstantiationInfo = r.RulesetInfo.InstantiationInfo;
                             }
                             else
-                                realm.Add(new RealmRuleset(r.RulesetInfo.ShortName, r.RulesetInfo.Name, r.RulesetInfo.InstantiationInfo, r.RulesetInfo.OnlineID));
+                                realm.Add(new RulesetInfo(r.RulesetInfo.ShortName, r.RulesetInfo.Name, r.RulesetInfo.InstantiationInfo, r.RulesetInfo.OnlineID));
                         }
                     }
 
-                    List<RealmRuleset> detachedRulesets = new List<RealmRuleset>();
+                    List<RulesetInfo> detachedRulesets = new List<RulesetInfo>();
 
                     // perform a consistency check and detach final rulesets from realm for cross-thread runtime usage.
                     foreach (var r in rulesets)

From c3df58e01c741c9ed204b66fe666b6c87855b1e3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 19 Nov 2021 19:24:07 +0900
Subject: [PATCH 1996/5547] Add required properties to make realm models
 backwards compatible

---
 osu.Game/Beatmaps/BeatmapDifficulty.cs | 27 +++++++++++-
 osu.Game/Beatmaps/BeatmapInfo.cs       | 59 ++++++++++++++++++++++----
 osu.Game/Beatmaps/BeatmapMetadata.cs   | 10 +++++
 osu.Game/Models/RealmNamedFileUsage.cs | 10 +++++
 osu.Game/Rulesets/RulesetInfo.cs       |  8 +++-
 5 files changed, 103 insertions(+), 11 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapDifficulty.cs b/osu.Game/Beatmaps/BeatmapDifficulty.cs
index 6425c7b291..90a60c0f0c 100644
--- a/osu.Game/Beatmaps/BeatmapDifficulty.cs
+++ b/osu.Game/Beatmaps/BeatmapDifficulty.cs
@@ -12,6 +12,11 @@ namespace osu.Game.Beatmaps
     [MapTo("BeatmapDifficulty")]
     public class BeatmapDifficulty : EmbeddedObject, IBeatmapDifficultyInfo
     {
+        /// <summary>
+        /// The default value used for all difficulty settings except <see cref="SliderMultiplier"/> and <see cref="SliderTickRate"/>.
+        /// </summary>
+        public const float DEFAULT_DIFFICULTY = 5;
+
         public float DrainRate { get; set; } = IBeatmapDifficultyInfo.DEFAULT_DIFFICULTY;
         public float CircleSize { get; set; } = IBeatmapDifficultyInfo.DEFAULT_DIFFICULTY;
         public float OverallDifficulty { get; set; } = IBeatmapDifficultyInfo.DEFAULT_DIFFICULTY;
@@ -20,6 +25,15 @@ namespace osu.Game.Beatmaps
         public double SliderMultiplier { get; set; } = 1;
         public double SliderTickRate { get; set; } = 1;
 
+        public BeatmapDifficulty()
+        {
+        }
+
+        public BeatmapDifficulty(IBeatmapDifficultyInfo source)
+        {
+            CopyFrom(source);
+        }
+
         /// <summary>
         /// Returns a shallow-clone of this <see cref="BeatmapDifficulty"/>.
         /// </summary>
@@ -30,7 +44,7 @@ namespace osu.Game.Beatmaps
             return diff;
         }
 
-        public void CopyTo(BeatmapDifficulty difficulty)
+        public virtual void CopyTo(BeatmapDifficulty difficulty)
         {
             difficulty.ApproachRate = ApproachRate;
             difficulty.DrainRate = DrainRate;
@@ -40,5 +54,16 @@ namespace osu.Game.Beatmaps
             difficulty.SliderMultiplier = SliderMultiplier;
             difficulty.SliderTickRate = SliderTickRate;
         }
+
+        public virtual void CopyFrom(IBeatmapDifficultyInfo other)
+        {
+            ApproachRate = other.ApproachRate;
+            DrainRate = other.DrainRate;
+            CircleSize = other.CircleSize;
+            OverallDifficulty = other.OverallDifficulty;
+
+            SliderMultiplier = other.SliderMultiplier;
+            SliderTickRate = other.SliderTickRate;
+        }
     }
 }
diff --git a/osu.Game/Beatmaps/BeatmapInfo.cs b/osu.Game/Beatmaps/BeatmapInfo.cs
index b000862457..796c2b2e90 100644
--- a/osu.Game/Beatmaps/BeatmapInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapInfo.cs
@@ -8,6 +8,7 @@ using Newtonsoft.Json;
 using osu.Framework.Testing;
 using osu.Game.Database;
 using osu.Game.Models;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets;
 using Realms;
 
@@ -72,7 +73,7 @@ namespace osu.Game.Beatmaps
         }
 
         [UsedImplicitly]
-        private BeatmapInfo()
+        public BeatmapInfo()
         {
         }
 
@@ -100,6 +101,13 @@ namespace osu.Game.Beatmaps
 
         public double TimelineZoom { get; set; }
 
+        public CountdownType Countdown { get; set; } = CountdownType.Normal;
+
+        /// <summary>
+        /// The number of beats to move the countdown backwards (compared to its default location).
+        /// </summary>
+        public int CountdownOffset { get; set; }
+
         #endregion
 
         public bool Equals(BeatmapInfo? other)
@@ -113,20 +121,53 @@ namespace osu.Game.Beatmaps
         public bool Equals(IBeatmapInfo? other) => other is BeatmapInfo b && Equals(b);
 
         public bool AudioEquals(BeatmapInfo? other) => other != null
-                                                        && BeatmapSet != null
-                                                        && other.BeatmapSet != null
-                                                        && BeatmapSet.Hash == other.BeatmapSet.Hash
-                                                        && Metadata.AudioFile == other.Metadata.AudioFile;
+                                                       && BeatmapSet != null
+                                                       && other.BeatmapSet != null
+                                                       && BeatmapSet.Hash == other.BeatmapSet.Hash
+                                                       && Metadata.AudioFile == other.Metadata.AudioFile;
 
         public bool BackgroundEquals(BeatmapInfo? other) => other != null
-                                                             && BeatmapSet != null
-                                                             && other.BeatmapSet != null
-                                                             && BeatmapSet.Hash == other.BeatmapSet.Hash
-                                                             && Metadata.BackgroundFile == other.Metadata.BackgroundFile;
+                                                            && BeatmapSet != null
+                                                            && other.BeatmapSet != null
+                                                            && BeatmapSet.Hash == other.BeatmapSet.Hash
+                                                            && Metadata.BackgroundFile == other.Metadata.BackgroundFile;
 
         IBeatmapMetadataInfo IBeatmapInfo.Metadata => Metadata;
         IBeatmapSetInfo? IBeatmapInfo.BeatmapSet => BeatmapSet;
         IRulesetInfo IBeatmapInfo.Ruleset => Ruleset;
         IBeatmapDifficultyInfo IBeatmapInfo.Difficulty => Difficulty;
+
+        #region Compatibility properties
+
+        [Ignored]
+        public int RulesetID => Ruleset.OnlineID;
+
+        [Ignored]
+        public Guid BeatmapSetInfoID => BeatmapSet?.ID ?? Guid.Empty;
+
+        [Ignored]
+        public BeatmapDifficulty BaseDifficulty
+        {
+            get => Difficulty;
+            set => Difficulty = value;
+        }
+
+        [Ignored]
+        public string? Path => File?.Filename;
+
+        [Ignored]
+        public APIBeatmap? OnlineInfo { get; set; }
+
+        [Ignored]
+        public int? MaxCombo { get; set; }
+
+        [Ignored]
+        public int[] Bookmarks { get; set; } = Array.Empty<int>();
+
+        public int BeatmapVersion;
+
+        public BeatmapInfo Clone() => this.Detach();
+
+        #endregion
     }
 }
diff --git a/osu.Game/Beatmaps/BeatmapMetadata.cs b/osu.Game/Beatmaps/BeatmapMetadata.cs
index 387641db40..dc5517375d 100644
--- a/osu.Game/Beatmaps/BeatmapMetadata.cs
+++ b/osu.Game/Beatmaps/BeatmapMetadata.cs
@@ -44,5 +44,15 @@ namespace osu.Game.Beatmaps
         public string BackgroundFile { get; set; } = string.Empty;
 
         IUser IBeatmapMetadataInfo.Author => Author;
+
+        #region Compatibility properties
+
+        public string AuthorString
+        {
+            get => Author.Username;
+            set => Author.Username = value;
+        }
+
+        #endregion
     }
 }
diff --git a/osu.Game/Models/RealmNamedFileUsage.cs b/osu.Game/Models/RealmNamedFileUsage.cs
index 17e32510a8..801c826292 100644
--- a/osu.Game/Models/RealmNamedFileUsage.cs
+++ b/osu.Game/Models/RealmNamedFileUsage.cs
@@ -31,5 +31,15 @@ namespace osu.Game.Models
         }
 
         IFileInfo INamedFileUsage.File => File;
+
+        #region Compatibility properties
+
+        public RealmFile FileInfo
+        {
+            get => File;
+            set => File = value;
+        }
+
+        #endregion
     }
 }
diff --git a/osu.Game/Rulesets/RulesetInfo.cs b/osu.Game/Rulesets/RulesetInfo.cs
index 91a3d181f8..99b4f5915f 100644
--- a/osu.Game/Rulesets/RulesetInfo.cs
+++ b/osu.Game/Rulesets/RulesetInfo.cs
@@ -33,7 +33,7 @@ namespace osu.Game.Rulesets
         }
 
         [UsedImplicitly]
-        private RulesetInfo()
+        public RulesetInfo()
         {
         }
 
@@ -83,5 +83,11 @@ namespace osu.Game.Rulesets
 
             return ruleset;
         }
+
+        #region Compatibility properties
+
+        public int ID => OnlineID;
+
+        #endregion
     }
 }

From 4f66e8f88121cffadeab4e5df618cbb3642b35b3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 22 Nov 2021 14:24:17 +0900
Subject: [PATCH 1997/5547] Fix issues with editor check tests

---
 .../Editing/Checks/CheckAudioInVideoTest.cs           |  2 +-
 .../Editing/Checks/CheckFilePresenceTest.cs           |  2 +-
 osu.Game.Tests/Editing/Checks/CheckTestHelpers.cs     | 11 +++--------
 .../Editing/Checks/CheckTooShortAudioFilesTest.cs     |  3 +++
 4 files changed, 8 insertions(+), 10 deletions(-)

diff --git a/osu.Game.Tests/Editing/Checks/CheckAudioInVideoTest.cs b/osu.Game.Tests/Editing/Checks/CheckAudioInVideoTest.cs
index f9b7bfa586..614b9b4ac1 100644
--- a/osu.Game.Tests/Editing/Checks/CheckAudioInVideoTest.cs
+++ b/osu.Game.Tests/Editing/Checks/CheckAudioInVideoTest.cs
@@ -74,7 +74,7 @@ namespace osu.Game.Tests.Editing.Checks
         [Test]
         public void TestMissingFile()
         {
-            beatmap.BeatmapInfo.BeatmapSet.Files.Clear();
+            beatmap.BeatmapInfo.BeatmapSet?.Files.Clear();
 
             var issues = check.Run(getContext(null)).ToList();
 
diff --git a/osu.Game.Tests/Editing/Checks/CheckFilePresenceTest.cs b/osu.Game.Tests/Editing/Checks/CheckFilePresenceTest.cs
index f36454aa71..01baaadc7d 100644
--- a/osu.Game.Tests/Editing/Checks/CheckFilePresenceTest.cs
+++ b/osu.Game.Tests/Editing/Checks/CheckFilePresenceTest.cs
@@ -46,7 +46,7 @@ namespace osu.Game.Tests.Editing.Checks
         [Test]
         public void TestBackgroundSetAndNotInFiles()
         {
-            beatmap.BeatmapInfo.BeatmapSet.Files.Clear();
+            beatmap.BeatmapInfo.BeatmapSet?.Files.Clear();
 
             var context = new BeatmapVerifierContext(beatmap, new TestWorkingBeatmap(beatmap));
             var issues = check.Run(context).ToList();
diff --git a/osu.Game.Tests/Editing/Checks/CheckTestHelpers.cs b/osu.Game.Tests/Editing/Checks/CheckTestHelpers.cs
index f702921986..9067714ff9 100644
--- a/osu.Game.Tests/Editing/Checks/CheckTestHelpers.cs
+++ b/osu.Game.Tests/Editing/Checks/CheckTestHelpers.cs
@@ -1,18 +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.Game.Beatmaps;
-using osu.Game.IO;
+using osu.Game.Models;
 
 namespace osu.Game.Tests.Editing.Checks
 {
     public static class CheckTestHelpers
     {
-        public static BeatmapSetFileInfo CreateMockFile(string extension) =>
-            new BeatmapSetFileInfo
-            {
-                Filename = $"abc123.{extension}",
-                FileInfo = new FileInfo { Hash = "abcdef" }
-            };
+        public static RealmNamedFileUsage CreateMockFile(string extension) =>
+            new RealmNamedFileUsage(new RealmFile { Hash = "abcdef" }, $"abc123.{extension}");
     }
 }
diff --git a/osu.Game.Tests/Editing/Checks/CheckTooShortAudioFilesTest.cs b/osu.Game.Tests/Editing/Checks/CheckTooShortAudioFilesTest.cs
index 8adf0d3764..242fec2f68 100644
--- a/osu.Game.Tests/Editing/Checks/CheckTooShortAudioFilesTest.cs
+++ b/osu.Game.Tests/Editing/Checks/CheckTooShortAudioFilesTest.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.Diagnostics;
 using System.IO;
 using System.Linq;
 using ManagedBass;
@@ -45,6 +46,8 @@ namespace osu.Game.Tests.Editing.Checks
         [Test]
         public void TestDifferentExtension()
         {
+            Debug.Assert(beatmap.BeatmapInfo.BeatmapSet != null);
+
             beatmap.BeatmapInfo.BeatmapSet.Files.Clear();
             beatmap.BeatmapInfo.BeatmapSet.Files.Add(CheckTestHelpers.CreateMockFile("jpg"));
 

From e6f6558ddff8b02a4cbb002bce38259993de73a4 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 22 Nov 2021 14:26:51 +0900
Subject: [PATCH 1998/5547] Update mock model usage to set `GUID`s instead of
 `int`s

---
 .../TestSceneBeatmapDifficultyCache.cs         | 18 ++++++++++--------
 .../NonVisual/BeatmapSetInfoEqualityTest.cs    |  9 ++++++---
 .../SongSelect/TestSceneBeatmapCarousel.cs     |  2 +-
 .../SongSelect/TestScenePlaySongSelect.cs      |  2 +-
 .../UserInterface/TestSceneDeleteLocalScore.cs |  4 ++--
 5 files changed, 20 insertions(+), 15 deletions(-)

diff --git a/osu.Game.Tests/Beatmaps/TestSceneBeatmapDifficultyCache.cs b/osu.Game.Tests/Beatmaps/TestSceneBeatmapDifficultyCache.cs
index 26ab8808b9..298e474fd1 100644
--- a/osu.Game.Tests/Beatmaps/TestSceneBeatmapDifficultyCache.cs
+++ b/osu.Game.Tests/Beatmaps/TestSceneBeatmapDifficultyCache.cs
@@ -24,6 +24,8 @@ namespace osu.Game.Tests.Beatmaps
     {
         public const double BASE_STARS = 5.55;
 
+        private static readonly Guid guid = Guid.NewGuid();
+
         private BeatmapSetInfo importedSet;
 
         private TestBeatmapDifficultyCache difficultyCache;
@@ -98,8 +100,8 @@ namespace osu.Game.Tests.Beatmaps
         [Test]
         public void TestKeyEqualsWithDifferentModInstances()
         {
-            var key1 = new BeatmapDifficultyCache.DifficultyCacheLookup(new BeatmapInfo { ID = 1234 }, new RulesetInfo { OnlineID = 0 }, new Mod[] { new OsuModHardRock(), new OsuModHidden() });
-            var key2 = new BeatmapDifficultyCache.DifficultyCacheLookup(new BeatmapInfo { ID = 1234 }, new RulesetInfo { OnlineID = 0 }, new Mod[] { new OsuModHardRock(), new OsuModHidden() });
+            var key1 = new BeatmapDifficultyCache.DifficultyCacheLookup(new BeatmapInfo { ID = guid }, new RulesetInfo { OnlineID = 0 }, new Mod[] { new OsuModHardRock(), new OsuModHidden() });
+            var key2 = new BeatmapDifficultyCache.DifficultyCacheLookup(new BeatmapInfo { ID = guid }, new RulesetInfo { OnlineID = 0 }, new Mod[] { new OsuModHardRock(), new OsuModHidden() });
 
             Assert.That(key1, Is.EqualTo(key2));
             Assert.That(key1.GetHashCode(), Is.EqualTo(key2.GetHashCode()));
@@ -108,8 +110,8 @@ namespace osu.Game.Tests.Beatmaps
         [Test]
         public void TestKeyEqualsWithDifferentModOrder()
         {
-            var key1 = new BeatmapDifficultyCache.DifficultyCacheLookup(new BeatmapInfo { ID = 1234 }, new RulesetInfo { OnlineID = 0 }, new Mod[] { new OsuModHardRock(), new OsuModHidden() });
-            var key2 = new BeatmapDifficultyCache.DifficultyCacheLookup(new BeatmapInfo { ID = 1234 }, new RulesetInfo { OnlineID = 0 }, new Mod[] { new OsuModHidden(), new OsuModHardRock() });
+            var key1 = new BeatmapDifficultyCache.DifficultyCacheLookup(new BeatmapInfo { ID = guid }, new RulesetInfo { OnlineID = 0 }, new Mod[] { new OsuModHardRock(), new OsuModHidden() });
+            var key2 = new BeatmapDifficultyCache.DifficultyCacheLookup(new BeatmapInfo { ID = guid }, new RulesetInfo { OnlineID = 0 }, new Mod[] { new OsuModHidden(), new OsuModHardRock() });
 
             Assert.That(key1, Is.EqualTo(key2));
             Assert.That(key1.GetHashCode(), Is.EqualTo(key2.GetHashCode()));
@@ -118,8 +120,8 @@ namespace osu.Game.Tests.Beatmaps
         [Test]
         public void TestKeyDoesntEqualWithDifferentModSettings()
         {
-            var key1 = new BeatmapDifficultyCache.DifficultyCacheLookup(new BeatmapInfo { ID = 1234 }, new RulesetInfo { OnlineID = 0 }, new Mod[] { new OsuModDoubleTime { SpeedChange = { Value = 1.1 } } });
-            var key2 = new BeatmapDifficultyCache.DifficultyCacheLookup(new BeatmapInfo { ID = 1234 }, new RulesetInfo { OnlineID = 0 }, new Mod[] { new OsuModDoubleTime { SpeedChange = { Value = 1.9 } } });
+            var key1 = new BeatmapDifficultyCache.DifficultyCacheLookup(new BeatmapInfo { ID = guid }, new RulesetInfo { OnlineID = 0 }, new Mod[] { new OsuModDoubleTime { SpeedChange = { Value = 1.1 } } });
+            var key2 = new BeatmapDifficultyCache.DifficultyCacheLookup(new BeatmapInfo { ID = guid }, new RulesetInfo { OnlineID = 0 }, new Mod[] { new OsuModDoubleTime { SpeedChange = { Value = 1.9 } } });
 
             Assert.That(key1, Is.Not.EqualTo(key2));
             Assert.That(key1.GetHashCode(), Is.Not.EqualTo(key2.GetHashCode()));
@@ -128,8 +130,8 @@ namespace osu.Game.Tests.Beatmaps
         [Test]
         public void TestKeyEqualWithMatchingModSettings()
         {
-            var key1 = new BeatmapDifficultyCache.DifficultyCacheLookup(new BeatmapInfo { ID = 1234 }, new RulesetInfo { OnlineID = 0 }, new Mod[] { new OsuModDoubleTime { SpeedChange = { Value = 1.25 } } });
-            var key2 = new BeatmapDifficultyCache.DifficultyCacheLookup(new BeatmapInfo { ID = 1234 }, new RulesetInfo { OnlineID = 0 }, new Mod[] { new OsuModDoubleTime { SpeedChange = { Value = 1.25 } } });
+            var key1 = new BeatmapDifficultyCache.DifficultyCacheLookup(new BeatmapInfo { ID = guid }, new RulesetInfo { OnlineID = 0 }, new Mod[] { new OsuModDoubleTime { SpeedChange = { Value = 1.25 } } });
+            var key2 = new BeatmapDifficultyCache.DifficultyCacheLookup(new BeatmapInfo { ID = guid }, new RulesetInfo { OnlineID = 0 }, new Mod[] { new OsuModDoubleTime { SpeedChange = { Value = 1.25 } } });
 
             Assert.That(key1, Is.EqualTo(key2));
             Assert.That(key1.GetHashCode(), Is.EqualTo(key2.GetHashCode()));
diff --git a/osu.Game.Tests/NonVisual/BeatmapSetInfoEqualityTest.cs b/osu.Game.Tests/NonVisual/BeatmapSetInfoEqualityTest.cs
index 534983f869..1b6049fcb7 100644
--- a/osu.Game.Tests/NonVisual/BeatmapSetInfoEqualityTest.cs
+++ b/osu.Game.Tests/NonVisual/BeatmapSetInfoEqualityTest.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 NUnit.Framework;
 using osu.Game.Beatmaps;
 using osu.Game.Extensions;
@@ -23,8 +24,10 @@ namespace osu.Game.Tests.NonVisual
         [Test]
         public void TestDatabasedWithDatabased()
         {
-            var ourInfo = new BeatmapSetInfo { ID = 123 };
-            var otherInfo = new BeatmapSetInfo { ID = 123 };
+            var guid = Guid.NewGuid();
+
+            var ourInfo = new BeatmapSetInfo { ID = guid };
+            var otherInfo = new BeatmapSetInfo { ID = guid };
 
             Assert.AreEqual(ourInfo, otherInfo);
         }
@@ -32,7 +35,7 @@ namespace osu.Game.Tests.NonVisual
         [Test]
         public void TestDatabasedWithOnline()
         {
-            var ourInfo = new BeatmapSetInfo { ID = 123, OnlineID = 12 };
+            var ourInfo = new BeatmapSetInfo { ID = Guid.NewGuid(), OnlineID = 12 };
             var otherInfo = new BeatmapSetInfo { OnlineID = 12 };
 
             Assert.AreNotEqual(ourInfo, otherInfo);
diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs
index f637c715a1..06ef3278ab 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs
@@ -27,7 +27,7 @@ namespace osu.Game.Tests.Visual.SongSelect
         private RulesetStore rulesets;
 
         private readonly Stack<BeatmapSetInfo> selectedSets = new Stack<BeatmapSetInfo>();
-        private readonly HashSet<int> eagerSelectedIDs = new HashSet<int>();
+        private readonly HashSet<Guid> eagerSelectedIDs = new HashSet<Guid>();
 
         private BeatmapInfo currentSelection => carousel.SelectedBeatmapInfo;
 
diff --git a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
index 37f110e727..586cd273be 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
@@ -585,7 +585,7 @@ namespace osu.Game.Tests.Visual.SongSelect
         [Test]
         public void TestHideSetSelectsCorrectBeatmap()
         {
-            int? previousID = null;
+            Guid? previousID = null;
             createSongSelect();
             addRulesetImportStep(0);
             AddStep("Move to last difficulty", () => songSelect.Carousel.SelectBeatmap(songSelect.Carousel.BeatmapSets.First().Beatmaps.Last()));
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
index a436fc0bfa..d9ba443eca 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.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 NUnit.Framework;
@@ -59,10 +60,9 @@ namespace osu.Game.Tests.Visual.UserInterface
                         Scope = BeatmapLeaderboardScope.Local,
                         BeatmapInfo = new BeatmapInfo
                         {
-                            ID = 1,
+                            ID = Guid.NewGuid(),
                             Metadata = new BeatmapMetadata
                             {
-                                ID = 1,
                                 Title = "TestSong",
                                 Artist = "TestArtist",
                                 Author = new APIUser

From 37673f4cf84b4edd49703aebadf96680ac355a54 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 22 Nov 2021 14:29:46 +0900
Subject: [PATCH 1999/5547] Update sets of `BeatmapSet.Metadata` to instead
 create a `Beatmap`

---
 .../Online/TestSceneBeatmapDownloading.cs     | 17 ++++++++++++-----
 .../SongSelect/TestSceneBeatmapCarousel.cs    | 19 +++++++++++++------
 2 files changed, 25 insertions(+), 11 deletions(-)

diff --git a/osu.Game.Tests/Online/TestSceneBeatmapDownloading.cs b/osu.Game.Tests/Online/TestSceneBeatmapDownloading.cs
index 4e77973655..ad9ea79646 100644
--- a/osu.Game.Tests/Online/TestSceneBeatmapDownloading.cs
+++ b/osu.Game.Tests/Online/TestSceneBeatmapDownloading.cs
@@ -5,6 +5,7 @@ using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
+using osu.Game.Models;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays.Notifications;
 using osu.Game.Tests.Visual;
@@ -20,13 +21,19 @@ namespace osu.Game.Tests.Online
         private static readonly BeatmapSetInfo test_db_model = new BeatmapSetInfo
         {
             OnlineID = 1,
-            Metadata = new BeatmapMetadata
+            Beatmaps =
             {
-                Artist = "test author",
-                Title = "test title",
-                Author = new APIUser
+                new BeatmapInfo
                 {
-                    Username = "mapper"
+                    Metadata = new BeatmapMetadata
+                    {
+                        Artist = "test author",
+                        Title = "test title",
+                        Author = new RealmUser
+                        {
+                            Username = "mapper"
+                        }
+                    }
                 }
             }
         };
diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs
index 06ef3278ab..7db71fb21e 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs
@@ -6,6 +6,7 @@ using System.Collections.Generic;
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
+using osu.Framework.Extensions.IEnumerableExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Beatmaps;
@@ -409,10 +410,10 @@ namespace osu.Game.Tests.Visual.SongSelect
                 var set = TestResources.CreateTestBeatmapSetInfo();
 
                 if (i == 4)
-                    set.Metadata.Artist = zzz_string;
+                    set.Beatmaps.ForEach(b => b.Metadata.Artist = zzz_string);
 
                 if (i == 16)
-                    set.Metadata.AuthorString = zzz_string;
+                    set.Beatmaps.ForEach(b => b.Metadata.AuthorString = zzz_string);
 
                 sets.Add(set);
             }
@@ -432,13 +433,19 @@ namespace osu.Game.Tests.Visual.SongSelect
 
             for (int i = 0; i < 20; i++)
             {
+                // index + 1 because we are using OnlineID which should never be zero.
                 var set = TestResources.CreateTestBeatmapSetInfo();
-                set.Metadata.Artist = "same artist";
-                set.Metadata.Title = "same title";
+
+                // only need to set the first as they are a shared reference.
+                var beatmap = set.Beatmaps.First();
+
+                beatmap.Metadata.Artist = "same artist";
+                beatmap.Metadata.Title = "same title";
+
                 sets.Add(set);
             }
 
-            int idOffset = sets.First().OnlineID ?? 0;
+            int idOffset = sets.First().OnlineID;
 
             loadBeatmaps(sets);
 
@@ -674,7 +681,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                 AddStep("Restore different ruleset filter", () =>
                 {
                     carousel.Filter(new FilterCriteria { Ruleset = rulesets.GetRuleset(1) }, false);
-                    eagerSelectedIDs.Add(carousel.SelectedBeatmapSet.OnlineID ?? -1);
+                    eagerSelectedIDs.Add(carousel.SelectedBeatmapSet.ID);
                 });
 
                 AddAssert("selection changed", () => !carousel.SelectedBeatmapInfo.Equals(manySets.First().Beatmaps.First()));

From 213d89b479e83bcc03bdeb38c5dee944f8ee68a7 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 22 Nov 2021 14:55:41 +0900
Subject: [PATCH 2000/5547] Update null fallback cases involving `OnlineID`

---
 .../Visual/Gameplay/TestScenePlayerScoreSubmission.cs     | 2 +-
 osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs      | 2 +-
 .../Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs   | 2 +-
 .../TestSceneMultiplayerGameplayLeaderboard.cs            | 2 +-
 .../TestSceneMultiplayerGameplayLeaderboardTeams.cs       | 2 +-
 .../Visual/Multiplayer/TestSceneMultiplayerResults.cs     | 2 +-
 .../Visual/Multiplayer/TestSceneMultiplayerTeamResults.cs | 2 +-
 osu.Game/Beatmaps/BeatmapModelManager.cs                  | 8 ++++----
 osu.Game/Beatmaps/BeatmapOnlineLookupQueue.cs             | 6 +++---
 osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs         | 4 ++--
 .../Screens/Select/Carousel/DrawableCarouselBeatmap.cs    | 4 ++--
 osu.Game/Stores/BeatmapImporter.cs                        | 4 ++--
 12 files changed, 20 insertions(+), 20 deletions(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestScenePlayerScoreSubmission.cs b/osu.Game.Tests/Visual/Gameplay/TestScenePlayerScoreSubmission.cs
index cf5aadde6d..9f34931f54 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestScenePlayerScoreSubmission.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestScenePlayerScoreSubmission.cs
@@ -237,7 +237,7 @@ namespace osu.Game.Tests.Visual.Gameplay
             createPlayerTest(false, r =>
             {
                 var beatmap = createTestBeatmap(r);
-                beatmap.BeatmapInfo.OnlineID = null;
+                beatmap.BeatmapInfo.OnlineID = -1;
                 return beatmap;
             });
 
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs
index 242eca0bbc..d8964c531f 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs
@@ -62,7 +62,7 @@ namespace osu.Game.Tests.Visual.Gameplay
             AddStep("import beatmap", () =>
             {
                 importedBeatmap = ImportBeatmapTest.LoadOszIntoOsu(game, virtualTrack: true).GetResultSafely();
-                importedBeatmapId = importedBeatmap.Beatmaps.First(b => b.RulesetID == 0).OnlineID ?? -1;
+                importedBeatmapId = importedBeatmap.Beatmaps.First(b => b.RulesetID == 0).OnlineID;
             });
         }
 
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs
index 61058bc87a..c78d1a2f62 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs
@@ -49,7 +49,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             importedSet = ImportBeatmapTest.LoadOszIntoOsu(game, virtualTrack: true).GetResultSafely();
             importedBeatmap = importedSet.Beatmaps.First(b => b.RulesetID == 0);
-            importedBeatmapId = importedBeatmap.OnlineID ?? -1;
+            importedBeatmapId = importedBeatmap.OnlineID;
         }
 
         [SetUp]
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs
index 07a8ef66e1..9b8e67b07a 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs
@@ -58,7 +58,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
                 foreach (int user in users)
                 {
-                    SpectatorClient.StartPlay(user, Beatmap.Value.BeatmapInfo.OnlineID ?? 0);
+                    SpectatorClient.StartPlay(user, Beatmap.Value.BeatmapInfo.OnlineID);
                     multiplayerUsers.Add(OnlinePlayDependencies.Client.AddUser(new APIUser { Id = user }, true));
                 }
 
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboardTeams.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboardTeams.cs
index 1237a21e94..8a78c12042 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboardTeams.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboardTeams.cs
@@ -62,7 +62,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
                 foreach (int user in users)
                 {
-                    SpectatorClient.StartPlay(user, Beatmap.Value.BeatmapInfo.OnlineID ?? 0);
+                    SpectatorClient.StartPlay(user, Beatmap.Value.BeatmapInfo.OnlineID);
                     var roomUser = OnlinePlayDependencies.Client.AddUser(new APIUser { Id = user }, true);
 
                     roomUser.MatchState = new TeamVersusUserState
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerResults.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerResults.cs
index 4674601f28..44a1745eee 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerResults.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerResults.cs
@@ -24,7 +24,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
                 PlaylistItem playlistItem = new PlaylistItem
                 {
-                    BeatmapID = beatmapInfo.OnlineID ?? -1,
+                    BeatmapID = beatmapInfo.OnlineID,
                 };
 
                 Stack.Push(screen = new MultiplayerResultsScreen(score, 1, playlistItem));
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerTeamResults.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerTeamResults.cs
index f5df8d7507..dfc16c44f2 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerTeamResults.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerTeamResults.cs
@@ -28,7 +28,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
                 PlaylistItem playlistItem = new PlaylistItem
                 {
-                    BeatmapID = beatmapInfo.OnlineID ?? -1,
+                    BeatmapID = beatmapInfo.OnlineID,
                 };
 
                 SortedDictionary<int, BindableInt> teamScores = new SortedDictionary<int, BindableInt>
diff --git a/osu.Game/Beatmaps/BeatmapModelManager.cs b/osu.Game/Beatmaps/BeatmapModelManager.cs
index d0c41e0fb8..2a9b215f32 100644
--- a/osu.Game/Beatmaps/BeatmapModelManager.cs
+++ b/osu.Game/Beatmaps/BeatmapModelManager.cs
@@ -101,7 +101,7 @@ namespace osu.Game.Beatmaps
             {
                 if (beatmapSet.OnlineID != null)
                 {
-                    beatmapSet.OnlineID = null;
+                    beatmapSet.OnlineID = -1;
                     LogForModel(beatmapSet, "Disassociating beatmap set ID due to loss of all beatmap IDs");
                 }
             }
@@ -122,9 +122,9 @@ namespace osu.Game.Beatmaps
                     Delete(existingSetWithSameOnlineID);
 
                     // in order to avoid a unique key constraint, immediately remove the online ID from the previous set.
-                    existingSetWithSameOnlineID.OnlineID = null;
+                    existingSetWithSameOnlineID.OnlineID = -1;
                     foreach (var b in existingSetWithSameOnlineID.Beatmaps)
-                        b.OnlineID = null;
+                        b.OnlineID = -1;
 
                     LogForModel(beatmapSet, $"Found existing beatmap set with same OnlineBeatmapSetID ({beatmapSet.OnlineID}). It has been deleted.");
                 }
@@ -159,7 +159,7 @@ namespace osu.Game.Beatmaps
                 }
             }
 
-            void resetIds() => beatmapSet.Beatmaps.ForEach(b => b.OnlineID = null);
+            void resetIds() => beatmapSet.Beatmaps.ForEach(b => b.OnlineID = -1);
         }
 
         /// <summary>
diff --git a/osu.Game/Beatmaps/BeatmapOnlineLookupQueue.cs b/osu.Game/Beatmaps/BeatmapOnlineLookupQueue.cs
index 76232c2932..3c4da12833 100644
--- a/osu.Game/Beatmaps/BeatmapOnlineLookupQueue.cs
+++ b/osu.Game/Beatmaps/BeatmapOnlineLookupQueue.cs
@@ -103,7 +103,7 @@ namespace osu.Game.Beatmaps
 
             void fail(Exception e)
             {
-                beatmapInfo.OnlineID = null;
+                beatmapInfo.OnlineID = -1;
                 logForModel(set, $"Online retrieval failed for {beatmapInfo} ({e.Message})");
             }
         }
@@ -161,7 +161,7 @@ namespace osu.Game.Beatmaps
 
             if (string.IsNullOrEmpty(beatmapInfo.MD5Hash)
                 && string.IsNullOrEmpty(beatmapInfo.Path)
-                && beatmapInfo.OnlineID == null)
+                && beatmapInfo.OnlineID <= 0)
                 return false;
 
             try
@@ -175,7 +175,7 @@ namespace osu.Game.Beatmaps
                         cmd.CommandText = "SELECT beatmapset_id, beatmap_id, approved, user_id FROM osu_beatmaps WHERE checksum = @MD5Hash OR beatmap_id = @OnlineID OR filename = @Path";
 
                         cmd.Parameters.Add(new SqliteParameter("@MD5Hash", beatmapInfo.MD5Hash));
-                        cmd.Parameters.Add(new SqliteParameter("@OnlineID", beatmapInfo.OnlineID ?? (object)DBNull.Value));
+                        cmd.Parameters.Add(new SqliteParameter("@OnlineID", beatmapInfo.OnlineID));
                         cmd.Parameters.Add(new SqliteParameter("@Path", beatmapInfo.Path));
 
                         using (var reader = cmd.ExecuteReader())
diff --git a/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs b/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs
index 49853418d6..ebdc882d2f 100644
--- a/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs
+++ b/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs
@@ -133,8 +133,8 @@ namespace osu.Game.Beatmaps.Formats
             writer.WriteLine(FormattableString.Invariant($"Version: {beatmap.BeatmapInfo.DifficultyName}"));
             if (!string.IsNullOrEmpty(beatmap.Metadata.Source)) writer.WriteLine(FormattableString.Invariant($"Source: {beatmap.Metadata.Source}"));
             if (!string.IsNullOrEmpty(beatmap.Metadata.Tags)) writer.WriteLine(FormattableString.Invariant($"Tags: {beatmap.Metadata.Tags}"));
-            if (beatmap.BeatmapInfo.OnlineID != null) writer.WriteLine(FormattableString.Invariant($"BeatmapID: {beatmap.BeatmapInfo.OnlineID}"));
-            if (beatmap.BeatmapInfo.BeatmapSet?.OnlineID != null) writer.WriteLine(FormattableString.Invariant($"BeatmapSetID: {beatmap.BeatmapInfo.BeatmapSet.OnlineID}"));
+            if (beatmap.BeatmapInfo.OnlineID > 0) writer.WriteLine(FormattableString.Invariant($"BeatmapID: {beatmap.BeatmapInfo.OnlineID}"));
+            if (beatmap.BeatmapInfo.BeatmapSet?.OnlineID > 0) writer.WriteLine(FormattableString.Invariant($"BeatmapSetID: {beatmap.BeatmapInfo.BeatmapSet.OnlineID}"));
         }
 
         private void handleDifficulty(TextWriter writer)
diff --git a/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmap.cs b/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmap.cs
index d0f9d835fd..2eb226df70 100644
--- a/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmap.cs
+++ b/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmap.cs
@@ -238,8 +238,8 @@ namespace osu.Game.Screens.Select.Carousel
                 if (editRequested != null)
                     items.Add(new OsuMenuItem("Edit", MenuItemType.Standard, () => editRequested(beatmapInfo)));
 
-                if (beatmapInfo.OnlineID.HasValue && beatmapOverlay != null)
-                    items.Add(new OsuMenuItem("Details...", MenuItemType.Standard, () => beatmapOverlay.FetchAndShowBeatmap(beatmapInfo.OnlineID.Value)));
+                if (beatmapInfo.OnlineID > 0 && beatmapOverlay != null)
+                    items.Add(new OsuMenuItem("Details...", MenuItemType.Standard, () => beatmapOverlay.FetchAndShowBeatmap(beatmapInfo.OnlineID)));
 
                 if (collectionManager != null)
                 {
diff --git a/osu.Game/Stores/BeatmapImporter.cs b/osu.Game/Stores/BeatmapImporter.cs
index 69c136b51c..de92da394d 100644
--- a/osu.Game/Stores/BeatmapImporter.cs
+++ b/osu.Game/Stores/BeatmapImporter.cs
@@ -240,7 +240,7 @@ namespace osu.Game.Stores
                         ArtistUnicode = decoded.Metadata.ArtistUnicode,
                         Author =
                         {
-                            OnlineID = decoded.Metadata.Author.Id,
+                            OnlineID = decoded.Metadata.Author.OnlineID,
                             Username = decoded.Metadata.Author.Username
                         },
                         Source = decoded.Metadata.Source,
@@ -254,7 +254,7 @@ namespace osu.Game.Stores
                     {
                         Hash = hash,
                         DifficultyName = decodedInfo.DifficultyName,
-                        OnlineID = decodedInfo.OnlineID ?? -1,
+                        OnlineID = decodedInfo.OnlineID,
                         AudioLeadIn = decodedInfo.AudioLeadIn,
                         StackLeniency = decodedInfo.StackLeniency,
                         SpecialStyle = decodedInfo.SpecialStyle,

From fda529de2674be00a7b386c23df37f2e092ed762 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 22 Nov 2021 15:52:55 +0900
Subject: [PATCH 2001/5547] Update usages of `APIUser` to `RealmUser`

---
 osu.Game.Tests/Beatmaps/ToStringFormattingTest.cs    |  6 +++---
 .../Multiplayer/TestSceneDrawableRoomPlaylist.cs     |  4 ++--
 .../Ranking/TestSceneExpandedPanelMiddleContent.cs   | 12 ++++++------
 .../UserInterface/TestSceneDeleteLocalScore.cs       |  3 ++-
 osu.Game/Beatmaps/BeatmapManager.cs                  |  7 ++++++-
 .../Online/API/Requests/Responses/APIBeatmapSet.cs   |  8 ++++++--
 6 files changed, 25 insertions(+), 15 deletions(-)

diff --git a/osu.Game.Tests/Beatmaps/ToStringFormattingTest.cs b/osu.Game.Tests/Beatmaps/ToStringFormattingTest.cs
index 4a7d7505ad..10cac4ed9d 100644
--- a/osu.Game.Tests/Beatmaps/ToStringFormattingTest.cs
+++ b/osu.Game.Tests/Beatmaps/ToStringFormattingTest.cs
@@ -3,7 +3,7 @@
 
 using NUnit.Framework;
 using osu.Game.Beatmaps;
-using osu.Game.Online.API.Requests.Responses;
+using osu.Game.Models;
 
 namespace osu.Game.Tests.Beatmaps
 {
@@ -34,7 +34,7 @@ namespace osu.Game.Tests.Beatmaps
                 {
                     Artist = "artist",
                     Title = "title",
-                    Author = new APIUser { Username = "creator" }
+                    Author = new RealmUser { Username = "creator" }
                 }
             };
 
@@ -50,7 +50,7 @@ namespace osu.Game.Tests.Beatmaps
                 {
                     Artist = "artist",
                     Title = "title",
-                    Author = new APIUser { Username = "creator" }
+                    Author = new RealmUser { Username = "creator" }
                 },
                 DifficultyName = "difficulty"
             };
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
index 147bbf2626..1607750d15 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
@@ -17,7 +17,7 @@ using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.Drawables;
 using osu.Game.Database;
 using osu.Game.Graphics.Containers;
-using osu.Game.Online.API.Requests.Responses;
+using osu.Game.Models;
 using osu.Game.Online.Rooms;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Osu;
@@ -305,7 +305,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                                     Metadata = new BeatmapMetadata
                                     {
                                         Artist = "Artist",
-                                        Author = new APIUser { Username = "Creator name here" },
+                                        Author = new RealmUser { Username = "Creator name here" },
                                         Title = "Long title used to check background colour",
                                     },
                                     BeatmapSet = new BeatmapSetInfo()
diff --git a/osu.Game.Tests/Visual/Ranking/TestSceneExpandedPanelMiddleContent.cs b/osu.Game.Tests/Visual/Ranking/TestSceneExpandedPanelMiddleContent.cs
index 2cb4fb6b6b..8b646df362 100644
--- a/osu.Game.Tests/Visual/Ranking/TestSceneExpandedPanelMiddleContent.cs
+++ b/osu.Game.Tests/Visual/Ranking/TestSceneExpandedPanelMiddleContent.cs
@@ -12,7 +12,7 @@ using osu.Framework.Graphics.Shapes;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
 using osu.Game.Graphics.Sprites;
-using osu.Game.Online.API.Requests.Responses;
+using osu.Game.Models;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Osu;
@@ -33,7 +33,7 @@ namespace osu.Game.Tests.Visual.Ranking
         [Test]
         public void TestMapWithKnownMapper()
         {
-            var author = new APIUser { Username = "mapper_name" };
+            var author = new RealmUser { Username = "mapper_name" };
 
             AddStep("show example score", () => showPanel(TestResources.CreateTestScoreInfo(createTestBeatmap(author))));
         }
@@ -43,7 +43,7 @@ namespace osu.Game.Tests.Visual.Ranking
         {
             AddStep("show excess mods score", () =>
             {
-                var author = new APIUser { Username = "mapper_name" };
+                var author = new RealmUser { Username = "mapper_name" };
 
                 var score = TestResources.CreateTestScoreInfo(createTestBeatmap(author));
                 score.Mods = score.BeatmapInfo.Ruleset.CreateInstance().CreateAllMods().ToArray();
@@ -57,7 +57,7 @@ namespace osu.Game.Tests.Visual.Ranking
         [Test]
         public void TestMapWithUnknownMapper()
         {
-            AddStep("show example score", () => showPanel(TestResources.CreateTestScoreInfo(createTestBeatmap(new APIUser()))));
+            AddStep("show example score", () => showPanel(TestResources.CreateTestScoreInfo(createTestBeatmap(new RealmUser()))));
 
             AddAssert("mapped by text not present", () =>
                 this.ChildrenOfType<OsuSpriteText>().All(spriteText => !containsAny(spriteText.Text.ToString(), "mapped", "by")));
@@ -73,7 +73,7 @@ namespace osu.Game.Tests.Visual.Ranking
                 var ruleset = new OsuRuleset();
 
                 var mods = new Mod[] { ruleset.GetAutoplayMod() };
-                var beatmap = createTestBeatmap(new APIUser());
+                var beatmap = createTestBeatmap(new RealmUser());
 
                 var score = TestResources.CreateTestScoreInfo(beatmap);
 
@@ -89,7 +89,7 @@ namespace osu.Game.Tests.Visual.Ranking
         private void showPanel(ScoreInfo score) =>
             Child = new ExpandedPanelMiddleContentContainer(score);
 
-        private BeatmapInfo createTestBeatmap([NotNull] APIUser author)
+        private BeatmapInfo createTestBeatmap([NotNull] RealmUser author)
         {
             var beatmap = new TestBeatmap(rulesetStore.GetRuleset(0)).BeatmapInfo;
 
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
index d9ba443eca..ecc8f697c7 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
@@ -17,6 +17,7 @@ using osu.Game.Beatmaps;
 using osu.Game.Database;
 using osu.Game.Graphics.Cursor;
 using osu.Game.Graphics.UserInterface;
+using osu.Game.Models;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Leaderboards;
 using osu.Game.Overlays;
@@ -65,7 +66,7 @@ namespace osu.Game.Tests.Visual.UserInterface
                             {
                                 Title = "TestSong",
                                 Artist = "TestArtist",
-                                Author = new APIUser
+                                Author = new RealmUser
                                 {
                                     Username = "TestAuthor"
                                 },
diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index ed7fe0bc91..dc7b5c7f29 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -18,6 +18,7 @@ using osu.Framework.Testing;
 using osu.Game.Database;
 using osu.Game.IO;
 using osu.Game.IO.Archives;
+using osu.Game.Models;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays.Notifications;
@@ -73,7 +74,11 @@ namespace osu.Game.Beatmaps
         {
             var metadata = new BeatmapMetadata
             {
-                Author = user,
+                Author = new RealmUser
+                {
+                    OnlineID = user.OnlineID,
+                    Username = user.Username,
+                }
             };
 
             var set = new BeatmapSetInfo
diff --git a/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs b/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs
index 57c45faed3..d99c13b977 100644
--- a/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs
@@ -7,6 +7,7 @@ using Newtonsoft.Json;
 using osu.Game.Beatmaps;
 using osu.Game.Database;
 using osu.Game.Extensions;
+using osu.Game.Models;
 
 #nullable enable
 
@@ -123,8 +124,11 @@ namespace osu.Game.Online.API.Requests.Responses
             TitleUnicode = TitleUnicode,
             Artist = Artist,
             ArtistUnicode = ArtistUnicode,
-            AuthorID = AuthorID,
-            Author = Author,
+            Author = new RealmUser
+            {
+                OnlineID = Author.OnlineID,
+                Username = Author.Username
+            },
             Source = Source,
             Tags = Tags,
         };

From 6a671b0a52fb4e3656e83e2ab4e94d5fcf117155 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 22 Nov 2021 16:22:31 +0900
Subject: [PATCH 2002/5547] Remove unnecessary assigns of
 `BeatmapSetInfo.Metadata`

---
 .../Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs      | 1 -
 osu.Game.Tests/Resources/TestResources.cs                        | 1 -
 .../Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs    | 1 -
 osu.Game.Tests/Visual/Navigation/TestScenePresentBeatmap.cs      | 1 -
 osu.Game.Tests/Visual/Navigation/TestScenePresentScore.cs        | 1 -
 osu.Game/Beatmaps/BeatmapManager.cs                              | 1 -
 6 files changed, 6 deletions(-)

diff --git a/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs b/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
index a7b431fb6e..48b22788a7 100644
--- a/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
+++ b/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
@@ -154,7 +154,6 @@ namespace osu.Game.Tests.Online
                 Debug.Assert(info.BeatmapSet != null);
 
                 info.BeatmapSet.Beatmaps.Add(info);
-                info.BeatmapSet.Metadata = info.Metadata;
                 info.MD5Hash = stream.ComputeMD5Hash();
                 info.Hash = stream.ComputeSHA2Hash();
             }
diff --git a/osu.Game.Tests/Resources/TestResources.cs b/osu.Game.Tests/Resources/TestResources.cs
index 445394fc77..c16f71334f 100644
--- a/osu.Game.Tests/Resources/TestResources.cs
+++ b/osu.Game.Tests/Resources/TestResources.cs
@@ -97,7 +97,6 @@ namespace osu.Game.Tests.Resources
                 OnlineID = setId,
                 Hash = new MemoryStream(Encoding.UTF8.GetBytes(Guid.NewGuid().ToString())).ComputeMD5Hash(),
                 DateAdded = DateTimeOffset.UtcNow,
-                Metadata = metadata
             };
 
             foreach (var b in getBeatmaps(difficultyCount ?? RNG.Next(1, 20)))
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs
index bd4b38b9c0..7f7c97ac48 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs
@@ -58,7 +58,6 @@ namespace osu.Game.Tests.Visual.Multiplayer
             {
                 OnlineID = 10,
                 Hash = Guid.NewGuid().ToString().ComputeMD5Hash(),
-                Metadata = metadata,
                 DateAdded = DateTimeOffset.UtcNow
             };
 
diff --git a/osu.Game.Tests/Visual/Navigation/TestScenePresentBeatmap.cs b/osu.Game.Tests/Visual/Navigation/TestScenePresentBeatmap.cs
index 6420e7b849..81aacf61cd 100644
--- a/osu.Game.Tests/Visual/Navigation/TestScenePresentBeatmap.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestScenePresentBeatmap.cs
@@ -109,7 +109,6 @@ namespace osu.Game.Tests.Visual.Navigation
                 {
                     Hash = Guid.NewGuid().ToString(),
                     OnlineID = i,
-                    Metadata = metadata,
                     Beatmaps =
                     {
                         new BeatmapInfo
diff --git a/osu.Game.Tests/Visual/Navigation/TestScenePresentScore.cs b/osu.Game.Tests/Visual/Navigation/TestScenePresentScore.cs
index 5dc1808c12..dbff5964df 100644
--- a/osu.Game.Tests/Visual/Navigation/TestScenePresentScore.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestScenePresentScore.cs
@@ -40,7 +40,6 @@ namespace osu.Game.Tests.Visual.Navigation
                 {
                     Hash = Guid.NewGuid().ToString(),
                     OnlineID = 1,
-                    Metadata = metadata,
                     Beatmaps =
                     {
                         new BeatmapInfo
diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index dc7b5c7f29..c558a807e5 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -83,7 +83,6 @@ namespace osu.Game.Beatmaps
 
             var set = new BeatmapSetInfo
             {
-                Metadata = metadata,
                 Beatmaps =
                 {
                     new BeatmapInfo

From 2cb97dd5994ae887007e941409e92a495c5c9e10 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 22 Nov 2021 17:11:29 +0900
Subject: [PATCH 2003/5547] Remove unnecessary assigns of EF foreign `ID`
 fields in tests

---
 osu.Game.Tests/Resources/TestResources.cs                       | 1 -
 osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs    | 2 --
 .../Visual/UserInterface/TestSceneDeleteLocalScore.cs           | 1 -
 3 files changed, 4 deletions(-)

diff --git a/osu.Game.Tests/Resources/TestResources.cs b/osu.Game.Tests/Resources/TestResources.cs
index c16f71334f..cd8b031f64 100644
--- a/osu.Game.Tests/Resources/TestResources.cs
+++ b/osu.Game.Tests/Resources/TestResources.cs
@@ -131,7 +131,6 @@ namespace osu.Game.Tests.Resources
                         Length = length,
                         BPM = bpm,
                         Ruleset = rulesetInfo,
-                        RulesetID = rulesetInfo.ID ?? -1,
                         Metadata = metadata,
                         BaseDifficulty = new BeatmapDifficulty
                         {
diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs
index 7db71fb21e..87192badd6 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs
@@ -584,7 +584,6 @@ namespace osu.Game.Tests.Visual.SongSelect
                 for (int i = 0; i <= 2; i++)
                 {
                     testMixed.Beatmaps[i].Ruleset = rulesets.AvailableRulesets.ElementAt(i);
-                    testMixed.Beatmaps[i].RulesetID = i;
                 }
 
                 carousel.UpdateBeatmapSet(testMixed);
@@ -606,7 +605,6 @@ namespace osu.Game.Tests.Visual.SongSelect
                 testSingle.Beatmaps.ForEach(b =>
                 {
                     b.Ruleset = rulesets.AvailableRulesets.ElementAt(1);
-                    b.RulesetID = b.Ruleset.ID ?? 1;
                 });
 
                 carousel.UpdateBeatmapSet(testSingle);
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
index ecc8f697c7..cdb81f059b 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
@@ -95,7 +95,6 @@ namespace osu.Game.Tests.Visual.UserInterface
                 {
                     OnlineID = i,
                     BeatmapInfo = beatmapInfo,
-                    BeatmapInfoID = beatmapInfo.ID,
                     Accuracy = RNG.NextDouble(),
                     TotalScore = RNG.Next(1, 1000000),
                     MaxCombo = RNG.Next(1, 1000),

From df088f96f476b1e80fe9b66c60b83e72548edc83 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 22 Nov 2021 17:12:26 +0900
Subject: [PATCH 2004/5547] Fix incorrect `Metadata`-related null checks

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

diff --git a/osu.Game/Beatmaps/WorkingBeatmap.cs b/osu.Game/Beatmaps/WorkingBeatmap.cs
index 8289b32d31..397d47c389 100644
--- a/osu.Game/Beatmaps/WorkingBeatmap.cs
+++ b/osu.Game/Beatmaps/WorkingBeatmap.cs
@@ -31,7 +31,7 @@ namespace osu.Game.Beatmaps
         public readonly BeatmapSetInfo BeatmapSetInfo;
 
         // TODO: remove once the fallback lookup is not required (and access via `working.BeatmapInfo.Metadata` directly).
-        public BeatmapMetadata Metadata => BeatmapInfo.Metadata ?? BeatmapSetInfo?.Metadata ?? new BeatmapMetadata();
+        public BeatmapMetadata Metadata => BeatmapInfo.Metadata;
 
         public Waveform Waveform => waveform.Value;
 
@@ -57,7 +57,7 @@ namespace osu.Game.Beatmaps
             this.audioManager = audioManager;
 
             BeatmapInfo = beatmapInfo;
-            BeatmapSetInfo = beatmapInfo.BeatmapSet;
+            BeatmapSetInfo = beatmapInfo.BeatmapSet ?? new BeatmapSetInfo();
 
             waveform = new Lazy<Waveform>(GetWaveform);
             storyboard = new Lazy<Storyboard>(GetStoryboard);

From e6fdd0e9697146bf2aab7a90015ba6009d8dcde3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 22 Nov 2021 16:10:13 +0900
Subject: [PATCH 2005/5547] Miscellaneous fixes that don't fit elsewhere

---
 osu.Game.Tests/Visual/SongSelect/TestSceneAdvancedStats.cs  | 1 -
 .../Visual/SongSelect/TestSceneBeatmapCarousel.cs           | 6 +-----
 osu.Game/OsuGame.cs                                         | 2 +-
 osu.Game/Screens/Select/BeatmapInfoWedge.cs                 | 2 +-
 osu.Game/Storyboards/Storyboard.cs                          | 3 ++-
 5 files changed, 5 insertions(+), 9 deletions(-)

diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneAdvancedStats.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneAdvancedStats.cs
index d57b3dec5d..e916e8d9ac 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneAdvancedStats.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneAdvancedStats.cs
@@ -37,7 +37,6 @@ namespace osu.Game.Tests.Visual.SongSelect
 
         private BeatmapInfo exampleBeatmapInfo => new BeatmapInfo
         {
-            RulesetID = 0,
             Ruleset = rulesets.AvailableRulesets.First(),
             BaseDifficulty = new BeatmapDifficulty
             {
diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs
index 87192badd6..28f5c3ff60 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs
@@ -378,11 +378,7 @@ namespace osu.Game.Tests.Visual.SongSelect
 
                 var rulesetBeatmapSet = TestResources.CreateTestBeatmapSetInfo(1);
                 var taikoRuleset = rulesets.AvailableRulesets.ElementAt(1);
-                rulesetBeatmapSet.Beatmaps.ForEach(b =>
-                {
-                    b.Ruleset = taikoRuleset;
-                    b.RulesetID = 1;
-                });
+                rulesetBeatmapSet.Beatmaps.ForEach(b => b.Ruleset = taikoRuleset);
 
                 sets.Add(rulesetBeatmapSet);
             });
diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index c5a465ae96..0d0a572663 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -458,7 +458,7 @@ namespace osu.Game
 
                 // Use all beatmaps if predicate matched nothing
                 if (beatmaps.Count == 0)
-                    beatmaps = databasedSet.Beatmaps;
+                    beatmaps = databasedSet.Beatmaps.ToList();
 
                 // Prefer recommended beatmap if recommendations are available, else fallback to a sane selection.
                 var selection = difficultyRecommender.GetRecommendedBeatmap(beatmaps)
diff --git a/osu.Game/Screens/Select/BeatmapInfoWedge.cs b/osu.Game/Screens/Select/BeatmapInfoWedge.cs
index 6791565828..b37877b35f 100644
--- a/osu.Game/Screens/Select/BeatmapInfoWedge.cs
+++ b/osu.Game/Screens/Select/BeatmapInfoWedge.cs
@@ -184,7 +184,7 @@ namespace osu.Game.Screens.Select
             private void load(OsuColour colours, LocalisationManager localisation, BeatmapDifficultyCache difficultyCache)
             {
                 var beatmapInfo = working.BeatmapInfo;
-                var metadata = beatmapInfo.Metadata ?? working.BeatmapSetInfo?.Metadata ?? new BeatmapMetadata();
+                var metadata = beatmapInfo.Metadata;
 
                 RelativeSizeAxes = Axes.Both;
 
diff --git a/osu.Game/Storyboards/Storyboard.cs b/osu.Game/Storyboards/Storyboard.cs
index fa90a00f0d..9502dd8968 100644
--- a/osu.Game/Storyboards/Storyboard.cs
+++ b/osu.Game/Storyboards/Storyboard.cs
@@ -96,7 +96,8 @@ namespace osu.Game.Storyboards
         public Drawable CreateSpriteFromResourcePath(string path, TextureStore textureStore)
         {
             Drawable drawable = null;
-            string storyboardPath = BeatmapInfo.BeatmapSet?.Files.Find(f => f.Filename.Equals(path, StringComparison.OrdinalIgnoreCase))?.FileInfo.GetStoragePath();
+
+            string storyboardPath = BeatmapInfo.BeatmapSet?.Files.FirstOrDefault(f => f.Filename.Equals(path, StringComparison.OrdinalIgnoreCase))?.FileInfo.GetStoragePath();
 
             if (!string.IsNullOrEmpty(storyboardPath))
                 drawable = new Sprite { Texture = textureStore.Get(storyboardPath) };

From 83cbee39de86fe230967a7ec6b51eff991bcc241 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 22 Nov 2021 17:59:54 +0900
Subject: [PATCH 2006/5547] Mark cases where `BeatmapSet` is generally
 guaranteed to be non-null

---
 osu.Game/Screens/Edit/Editor.cs | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/osu.Game/Screens/Edit/Editor.cs b/osu.Game/Screens/Edit/Editor.cs
index 48489c60ab..7955464590 100644
--- a/osu.Game/Screens/Edit/Editor.cs
+++ b/osu.Game/Screens/Edit/Editor.cs
@@ -3,6 +3,7 @@
 
 using System;
 using System.Collections.Generic;
+using System.Diagnostics;
 using System.Linq;
 using JetBrains.Annotations;
 using osu.Framework;
@@ -777,6 +778,8 @@ namespace osu.Game.Screens.Edit
 
             var beatmapSet = beatmapManager.QueryBeatmapSet(bs => bs.ID == Beatmap.Value.BeatmapSetInfo.ID) ?? playableBeatmap.BeatmapInfo.BeatmapSet;
 
+            Debug.Assert(beatmapSet != null);
+
             var difficultyItems = new List<MenuItem>();
 
             foreach (var rulesetBeatmaps in beatmapSet.Beatmaps.GroupBy(b => b.RulesetID).OrderBy(group => group.Key))

From 89d6ffa7f384e333832a267b8f120580237cd4fb Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 23 Nov 2021 13:24:26 +0900
Subject: [PATCH 2007/5547] Use `RealmContextFactory` instead of EF

---
 ...ceneOnlinePlayBeatmapAvailabilityTracker.cs |  2 +-
 osu.Game/Beatmaps/BeatmapManager.cs            |  2 +-
 osu.Game/Scoring/ScoreManager.cs               |  2 +-
 osu.Game/Tests/Visual/OsuTestScene.cs          | 18 ++++++------------
 4 files changed, 9 insertions(+), 15 deletions(-)

diff --git a/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs b/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
index 48b22788a7..2cab823526 100644
--- a/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
+++ b/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
@@ -167,7 +167,7 @@ namespace osu.Game.Tests.Online
 
             public Task<ILive<BeatmapSetInfo>> CurrentImportTask { get; private set; }
 
-            public TestBeatmapManager(Storage storage, IDatabaseContextFactory contextFactory, RulesetStore rulesets, IAPIProvider api, [NotNull] AudioManager audioManager, IResourceStore<byte[]> resources, GameHost host = null, WorkingBeatmap defaultBeatmap = null)
+            public TestBeatmapManager(Storage storage, RealmContextFactory contextFactory, RulesetStore rulesets, IAPIProvider api, [NotNull] AudioManager audioManager, IResourceStore<byte[]> resources, GameHost host = null, WorkingBeatmap defaultBeatmap = null)
                 : base(storage, contextFactory, rulesets, api, audioManager, resources, host, defaultBeatmap)
             {
             }
diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index c558a807e5..59adcfca60 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -40,7 +40,7 @@ namespace osu.Game.Beatmaps
         private readonly WorkingBeatmapCache workingBeatmapCache;
         private readonly BeatmapOnlineLookupQueue onlineBeatmapLookupQueue;
 
-        public BeatmapManager(Storage storage, IDatabaseContextFactory contextFactory, RulesetStore rulesets, IAPIProvider api, [NotNull] AudioManager audioManager, IResourceStore<byte[]> gameResources, GameHost host = null, WorkingBeatmap defaultBeatmap = null, bool performOnlineLookups = false)
+        public BeatmapManager(Storage storage, RealmContextFactory contextFactory, RulesetStore rulesets, IAPIProvider api, [NotNull] AudioManager audioManager, IResourceStore<byte[]> gameResources, GameHost host = null, WorkingBeatmap defaultBeatmap = null, bool performOnlineLookups = false)
         {
             var userResources = new FileStore(contextFactory, storage).Store;
 
diff --git a/osu.Game/Scoring/ScoreManager.cs b/osu.Game/Scoring/ScoreManager.cs
index 39cd28cad2..9f248ffdca 100644
--- a/osu.Game/Scoring/ScoreManager.cs
+++ b/osu.Game/Scoring/ScoreManager.cs
@@ -30,7 +30,7 @@ namespace osu.Game.Scoring
         private readonly OsuConfigManager configManager;
         private readonly ScoreModelManager scoreModelManager;
 
-        public ScoreManager(RulesetStore rulesets, Func<BeatmapManager> beatmaps, Storage storage, IDatabaseContextFactory contextFactory, Scheduler scheduler,
+        public ScoreManager(RulesetStore rulesets, Func<BeatmapManager> beatmaps, Storage storage, RealmContextFactory contextFactory, Scheduler scheduler,
                             IIpcHost importHost = null, Func<BeatmapDifficultyCache> difficulties = null, OsuConfigManager configManager = null)
         {
             this.scheduler = scheduler;
diff --git a/osu.Game/Tests/Visual/OsuTestScene.cs b/osu.Game/Tests/Visual/OsuTestScene.cs
index 6b029729ea..c631286d11 100644
--- a/osu.Game/Tests/Visual/OsuTestScene.cs
+++ b/osu.Game/Tests/Visual/OsuTestScene.cs
@@ -73,9 +73,9 @@ namespace osu.Game.Tests.Visual
         /// <remarks>
         /// In interactive runs (ie. VisualTests) this will use the user's database if <see cref="UseFreshStoragePerRun"/> is not set to <c>true</c>.
         /// </remarks>
-        protected DatabaseContextFactory ContextFactory => contextFactory.Value;
+        protected RealmContextFactory ContextFactory => contextFactory.Value;
 
-        private Lazy<DatabaseContextFactory> contextFactory;
+        private Lazy<RealmContextFactory> contextFactory;
 
         /// <summary>
         /// Whether a fresh storage should be initialised per test (method) run.
@@ -117,14 +117,7 @@ namespace osu.Game.Tests.Visual
 
             Resources = parent.Get<OsuGameBase>().Resources;
 
-            contextFactory = new Lazy<DatabaseContextFactory>(() =>
-            {
-                var factory = new DatabaseContextFactory(LocalStorage);
-
-                using (var usage = factory.Get())
-                    usage.Migrate();
-                return factory;
-            });
+            contextFactory = new Lazy<RealmContextFactory>(() => new RealmContextFactory(LocalStorage, "client"));
 
             RecycleLocalStorage(false);
 
@@ -301,8 +294,9 @@ namespace osu.Game.Tests.Visual
             if (MusicController?.TrackLoaded == true)
                 MusicController.Stop();
 
-            if (contextFactory?.IsValueCreated == true)
-                contextFactory.Value.ResetDatabase();
+            // TODO: what should we do here, if anything? should we use an in-memory realm in this instance?
+            // if (contextFactory?.IsValueCreated == true)
+            //     contextFactory.Value.ResetDatabase();
 
             RecycleLocalStorage(true);
         }

From 3ecd889fef5f1b9a7882d40148795ac330ed4c2a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 23 Nov 2021 13:00:33 +0900
Subject: [PATCH 2008/5547] Replace EF `RulesetStore` with realm version

Pass full EF context factory to `RealmContextFactory` for migration purposes
---
 .../Database/BeatmapImporterTests.cs          |  42 +--
 osu.Game.Tests/Database/RulesetStoreTests.cs  |   9 +-
 osu.Game/Database/RealmContextFactory.cs      |   1 +
 osu.Game/OsuGameBase.cs                       |  10 +-
 .../Sections/Input/RulesetBindingsSection.cs  |   3 +
 osu.Game/Rulesets/RulesetStore.cs             | 164 ++++++-----
 osu.Game/Stores/RealmRulesetStore.cs          | 269 ------------------
 7 files changed, 123 insertions(+), 375 deletions(-)
 delete mode 100644 osu.Game/Stores/RealmRulesetStore.cs

diff --git a/osu.Game.Tests/Database/BeatmapImporterTests.cs b/osu.Game.Tests/Database/BeatmapImporterTests.cs
index 37c2007681..adee545c1d 100644
--- a/osu.Game.Tests/Database/BeatmapImporterTests.cs
+++ b/osu.Game.Tests/Database/BeatmapImporterTests.cs
@@ -41,7 +41,7 @@ namespace osu.Game.Tests.Database
             RunTestWithRealmAsync(async (realmFactory, storage) =>
             {
                 using (var importer = new BeatmapImporter(realmFactory, storage))
-                using (new RealmRulesetStore(realmFactory, storage))
+                using (new RulesetStore(realmFactory, storage))
                 {
                     ILive<BeatmapSetInfo>? imported;
 
@@ -70,7 +70,7 @@ namespace osu.Game.Tests.Database
             RunTestWithRealmAsync(async (realmFactory, storage) =>
             {
                 using var importer = new BeatmapImporter(realmFactory, storage);
-                using var store = new RealmRulesetStore(realmFactory, storage);
+                using var store = new RulesetStore(realmFactory, storage);
 
                 await LoadOszIntoStore(importer, realmFactory.Context);
             });
@@ -82,7 +82,7 @@ namespace osu.Game.Tests.Database
             RunTestWithRealmAsync(async (realmFactory, storage) =>
             {
                 using var importer = new BeatmapImporter(realmFactory, storage);
-                using var store = new RealmRulesetStore(realmFactory, storage);
+                using var store = new RulesetStore(realmFactory, storage);
 
                 var imported = await LoadOszIntoStore(importer, realmFactory.Context);
 
@@ -100,7 +100,7 @@ namespace osu.Game.Tests.Database
             RunTestWithRealmAsync(async (realmFactory, storage) =>
             {
                 using var importer = new BeatmapImporter(realmFactory, storage);
-                using var store = new RealmRulesetStore(realmFactory, storage);
+                using var store = new RulesetStore(realmFactory, storage);
 
                 var imported = await LoadOszIntoStore(importer, realmFactory.Context);
 
@@ -114,7 +114,7 @@ namespace osu.Game.Tests.Database
             RunTestWithRealmAsync(async (realmFactory, storage) =>
             {
                 using var importer = new BeatmapImporter(realmFactory, storage);
-                using var store = new RealmRulesetStore(realmFactory, storage);
+                using var store = new RulesetStore(realmFactory, storage);
 
                 string? tempPath = TestResources.GetTestBeatmapForImport();
 
@@ -144,7 +144,7 @@ namespace osu.Game.Tests.Database
             RunTestWithRealmAsync(async (realmFactory, storage) =>
             {
                 using var importer = new BeatmapImporter(realmFactory, storage);
-                using var store = new RealmRulesetStore(realmFactory, storage);
+                using var store = new RulesetStore(realmFactory, storage);
 
                 var imported = await LoadOszIntoStore(importer, realmFactory.Context);
                 var importedSecondTime = await LoadOszIntoStore(importer, realmFactory.Context);
@@ -164,7 +164,7 @@ namespace osu.Game.Tests.Database
             RunTestWithRealmAsync(async (realmFactory, storage) =>
             {
                 using var importer = new BeatmapImporter(realmFactory, storage);
-                using var store = new RealmRulesetStore(realmFactory, storage);
+                using var store = new RulesetStore(realmFactory, storage);
 
                 string? temp = TestResources.GetTestBeatmapForImport();
 
@@ -213,7 +213,7 @@ namespace osu.Game.Tests.Database
             RunTestWithRealmAsync(async (realmFactory, storage) =>
             {
                 using var importer = new BeatmapImporter(realmFactory, storage);
-                using var store = new RealmRulesetStore(realmFactory, storage);
+                using var store = new RulesetStore(realmFactory, storage);
 
                 string? temp = TestResources.GetTestBeatmapForImport();
 
@@ -265,7 +265,7 @@ namespace osu.Game.Tests.Database
             RunTestWithRealmAsync(async (realmFactory, storage) =>
             {
                 using var importer = new BeatmapImporter(realmFactory, storage);
-                using var store = new RealmRulesetStore(realmFactory, storage);
+                using var store = new RulesetStore(realmFactory, storage);
 
                 string? temp = TestResources.GetTestBeatmapForImport();
 
@@ -313,7 +313,7 @@ namespace osu.Game.Tests.Database
             RunTestWithRealmAsync(async (realmFactory, storage) =>
             {
                 using var importer = new BeatmapImporter(realmFactory, storage);
-                using var store = new RealmRulesetStore(realmFactory, storage);
+                using var store = new RulesetStore(realmFactory, storage);
 
                 string? temp = TestResources.GetTestBeatmapForImport();
 
@@ -362,7 +362,7 @@ namespace osu.Game.Tests.Database
             RunTestWithRealmAsync(async (realmFactory, storage) =>
             {
                 using var importer = new BeatmapImporter(realmFactory, storage);
-                using var store = new RealmRulesetStore(realmFactory, storage);
+                using var store = new RulesetStore(realmFactory, storage);
 
                 var imported = await LoadOszIntoStore(importer, realmFactory.Context);
 
@@ -395,7 +395,7 @@ namespace osu.Game.Tests.Database
             RunTestWithRealmAsync(async (realmFactory, storage) =>
             {
                 using var importer = new BeatmapImporter(realmFactory, storage);
-                using var store = new RealmRulesetStore(realmFactory, storage);
+                using var store = new RulesetStore(realmFactory, storage);
 
                 var progressNotification = new ImportProgressNotification();
 
@@ -431,7 +431,7 @@ namespace osu.Game.Tests.Database
                 };
 
                 using var importer = new BeatmapImporter(realmFactory, storage);
-                using var store = new RealmRulesetStore(realmFactory, storage);
+                using var store = new RulesetStore(realmFactory, storage);
 
                 var imported = await LoadOszIntoStore(importer, realmFactory.Context);
 
@@ -481,7 +481,7 @@ namespace osu.Game.Tests.Database
             RunTestWithRealmAsync(async (realmFactory, storage) =>
             {
                 using var importer = new BeatmapImporter(realmFactory, storage);
-                using var store = new RealmRulesetStore(realmFactory, storage);
+                using var store = new RulesetStore(realmFactory, storage);
 
                 var imported = await LoadOszIntoStore(importer, realmFactory.Context);
 
@@ -529,7 +529,7 @@ namespace osu.Game.Tests.Database
             RunTestWithRealmAsync(async (realmFactory, storage) =>
             {
                 using var importer = new BeatmapImporter(realmFactory, storage);
-                using var store = new RealmRulesetStore(realmFactory, storage);
+                using var store = new RulesetStore(realmFactory, storage);
 
                 var imported = await LoadOszIntoStore(importer, realmFactory.Context);
 
@@ -555,7 +555,7 @@ namespace osu.Game.Tests.Database
             RunTestWithRealmAsync(async (realmFactory, storage) =>
             {
                 using var importer = new BeatmapImporter(realmFactory, storage);
-                using var store = new RealmRulesetStore(realmFactory, storage);
+                using var store = new RulesetStore(realmFactory, storage);
 
                 var metadata = new BeatmapMetadata
                 {
@@ -601,7 +601,7 @@ namespace osu.Game.Tests.Database
             RunTestWithRealmAsync(async (realmFactory, storage) =>
             {
                 using var importer = new BeatmapImporter(realmFactory, storage);
-                using var store = new RealmRulesetStore(realmFactory, storage);
+                using var store = new RulesetStore(realmFactory, storage);
 
                 string? temp = TestResources.GetTestBeatmapForImport();
                 using (File.OpenRead(temp))
@@ -618,7 +618,7 @@ namespace osu.Game.Tests.Database
             RunTestWithRealmAsync(async (realmFactory, storage) =>
             {
                 using var importer = new BeatmapImporter(realmFactory, storage);
-                using var store = new RealmRulesetStore(realmFactory, storage);
+                using var store = new RulesetStore(realmFactory, storage);
 
                 string? temp = TestResources.GetTestBeatmapForImport();
 
@@ -654,7 +654,7 @@ namespace osu.Game.Tests.Database
             RunTestWithRealmAsync(async (realmFactory, storage) =>
             {
                 using var importer = new BeatmapImporter(realmFactory, storage);
-                using var store = new RealmRulesetStore(realmFactory, storage);
+                using var store = new RulesetStore(realmFactory, storage);
 
                 string? temp = TestResources.GetTestBeatmapForImport();
 
@@ -696,7 +696,7 @@ namespace osu.Game.Tests.Database
             RunTestWithRealmAsync(async (realmFactory, storage) =>
             {
                 using var importer = new BeatmapImporter(realmFactory, storage);
-                using var store = new RealmRulesetStore(realmFactory, storage);
+                using var store = new RulesetStore(realmFactory, storage);
 
                 string? temp = TestResources.GetTestBeatmapForImport();
 
@@ -747,7 +747,7 @@ namespace osu.Game.Tests.Database
             RunTestWithRealmAsync(async (realmFactory, storage) =>
             {
                 using var importer = new BeatmapImporter(realmFactory, storage);
-                using var store = new RealmRulesetStore(realmFactory, storage);
+                using var store = new RulesetStore(realmFactory, storage);
 
                 string? temp = TestResources.GetTestBeatmapForImport();
                 await importer.Import(temp);
diff --git a/osu.Game.Tests/Database/RulesetStoreTests.cs b/osu.Game.Tests/Database/RulesetStoreTests.cs
index d2de31d11a..4416da6f92 100644
--- a/osu.Game.Tests/Database/RulesetStoreTests.cs
+++ b/osu.Game.Tests/Database/RulesetStoreTests.cs
@@ -4,7 +4,6 @@
 using System.Linq;
 using NUnit.Framework;
 using osu.Game.Rulesets;
-using osu.Game.Stores;
 
 namespace osu.Game.Tests.Database
 {
@@ -15,7 +14,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealm((realmFactory, storage) =>
             {
-                var rulesets = new RealmRulesetStore(realmFactory, storage);
+                var rulesets = new RulesetStore(realmFactory, storage);
 
                 Assert.AreEqual(4, rulesets.AvailableRulesets.Count());
                 Assert.AreEqual(4, realmFactory.Context.All<RulesetInfo>().Count());
@@ -27,8 +26,8 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealm((realmFactory, storage) =>
             {
-                var rulesets = new RealmRulesetStore(realmFactory, storage);
-                var rulesets2 = new RealmRulesetStore(realmFactory, storage);
+                var rulesets = new RulesetStore(realmFactory, storage);
+                var rulesets2 = new RulesetStore(realmFactory, storage);
 
                 Assert.AreEqual(4, rulesets.AvailableRulesets.Count());
                 Assert.AreEqual(4, rulesets2.AvailableRulesets.Count());
@@ -43,7 +42,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealm((realmFactory, storage) =>
             {
-                var rulesets = new RealmRulesetStore(realmFactory, storage);
+                var rulesets = new RulesetStore(realmFactory, storage);
 
                 Assert.IsFalse(rulesets.AvailableRulesets.First().IsManaged);
                 Assert.IsFalse(rulesets.GetRuleset(0)?.IsManaged);
diff --git a/osu.Game/Database/RealmContextFactory.cs b/osu.Game/Database/RealmContextFactory.cs
index 946dda1f39..968caaa7ce 100644
--- a/osu.Game/Database/RealmContextFactory.cs
+++ b/osu.Game/Database/RealmContextFactory.cs
@@ -17,6 +17,7 @@ using osu.Game.Input.Bindings;
 using osu.Game.Models;
 using osu.Game.Skinning;
 using osu.Game.Stores;
+using osu.Game.Rulesets;
 using Realms;
 
 #nullable enable
diff --git a/osu.Game/OsuGameBase.cs b/osu.Game/OsuGameBase.cs
index 9256514a0a..144ee17c29 100644
--- a/osu.Game/OsuGameBase.cs
+++ b/osu.Game/OsuGameBase.cs
@@ -40,7 +40,6 @@ using osu.Game.Rulesets;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Scoring;
 using osu.Game.Skinning;
-using osu.Game.Stores;
 using osu.Game.Utils;
 using RuntimeInfo = osu.Framework.RuntimeInfo;
 
@@ -166,8 +165,6 @@ namespace osu.Game
 
         private readonly BindableNumber<double> globalTrackVolumeAdjust = new BindableNumber<double>(global_track_volume_adjust);
 
-        private RealmRulesetStore realmRulesetStore;
-
         public OsuGameBase()
         {
             UseDevelopmentServer = DebugUtils.IsDebugBuild;
@@ -231,6 +228,8 @@ namespace osu.Game
 
             dependencies.Cache(fileStore = new FileStore(contextFactory, Storage));
 
+            dependencies.Cache(RulesetStore = new RulesetStore(realmFactory, Storage));
+
             // ordering is important here to ensure foreign keys rules are not broken in ModelStore.Cleanup()
             dependencies.Cache(ScoreManager = new ScoreManager(RulesetStore, () => BeatmapManager, Storage, contextFactory, Scheduler, Host, () => difficultyCache, LocalConfig));
             dependencies.Cache(BeatmapManager = new BeatmapManager(Storage, contextFactory, RulesetStore, API, Audio, Resources, Host, defaultBeatmap, performOnlineLookups: true));
@@ -238,11 +237,6 @@ namespace osu.Game
             dependencies.Cache(BeatmapDownloader = new BeatmapModelDownloader(BeatmapManager, API));
             dependencies.Cache(ScoreDownloader = new ScoreModelDownloader(ScoreManager, API));
 
-            // the following realm components are not actively used yet, but initialised and kept up to date for initial testing.
-            realmRulesetStore = new RealmRulesetStore(realmFactory, Storage);
-
-            dependencies.Cache(realmRulesetStore);
-
             // this should likely be moved to ArchiveModelManager when another case appears where it is necessary
             // to have inter-dependent model managers. this could be obtained with an IHasForeign<T> interface to
             // allow lookups to be done on the child (ScoreManager in this case) to perform the cascading delete.
diff --git a/osu.Game/Overlays/Settings/Sections/Input/RulesetBindingsSection.cs b/osu.Game/Overlays/Settings/Sections/Input/RulesetBindingsSection.cs
index b5d26d4887..dae276c711 100644
--- a/osu.Game/Overlays/Settings/Sections/Input/RulesetBindingsSection.cs
+++ b/osu.Game/Overlays/Settings/Sections/Input/RulesetBindingsSection.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.Diagnostics;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Localisation;
@@ -26,6 +27,8 @@ namespace osu.Game.Overlays.Settings.Sections.Input
 
             var r = ruleset.CreateInstance();
 
+            Debug.Assert(r != null);
+
             foreach (int variant in r.AvailableVariants)
                 Add(new VariantBindingsSubsection(ruleset, variant));
         }
diff --git a/osu.Game/Rulesets/RulesetStore.cs b/osu.Game/Rulesets/RulesetStore.cs
index 5cc6a75f43..de3bb1ac34 100644
--- a/osu.Game/Rulesets/RulesetStore.cs
+++ b/osu.Game/Rulesets/RulesetStore.cs
@@ -7,24 +7,33 @@ using System.IO;
 using System.Linq;
 using System.Reflection;
 using osu.Framework;
+using osu.Framework.Extensions.ObjectExtensions;
 using osu.Framework.Logging;
 using osu.Framework.Platform;
 using osu.Game.Database;
 
+#nullable enable
+
 namespace osu.Game.Rulesets
 {
-    public class RulesetStore : DatabaseBackedStore, IRulesetStore, IDisposable
+    public class RulesetStore : IDisposable
     {
-        private const string ruleset_library_prefix = "osu.Game.Rulesets";
+        private readonly RealmContextFactory realmFactory;
+
+        private const string ruleset_library_prefix = @"osu.Game.Rulesets";
 
         private readonly Dictionary<Assembly, Type> loadedAssemblies = new Dictionary<Assembly, Type>();
 
-        private readonly Storage rulesetStorage;
+        /// <summary>
+        /// All available rulesets.
+        /// </summary>
+        public IEnumerable<RulesetInfo> AvailableRulesets => availableRulesets;
 
-        public RulesetStore(IDatabaseContextFactory factory, Storage storage = null)
-            : base(factory)
+        private readonly List<RulesetInfo> availableRulesets = new List<RulesetInfo>();
+
+        public RulesetStore(RealmContextFactory realmFactory, Storage? storage = null)
         {
-            rulesetStorage = storage?.GetStorageForDirectory("rulesets");
+            this.realmFactory = realmFactory;
 
             // On android in release configuration assemblies are loaded from the apk directly into memory.
             // We cannot read assemblies from cwd, so should check loaded assemblies instead.
@@ -40,7 +49,11 @@ namespace osu.Game.Rulesets
             // It needs to be attached to the assembly lookup event before the actual call to loadUserRulesets() else rulesets located out of the base game directory will fail
             // to load as unable to locate the game core assembly.
             AppDomain.CurrentDomain.AssemblyResolve += resolveRulesetDependencyAssembly;
-            loadUserRulesets();
+
+            var rulesetStorage = storage?.GetStorageForDirectory(@"rulesets");
+            if (rulesetStorage != null)
+                loadUserRulesets(rulesetStorage);
+
             addMissingRulesets();
         }
 
@@ -49,21 +62,16 @@ namespace osu.Game.Rulesets
         /// </summary>
         /// <param name="id">The ruleset's internal ID.</param>
         /// <returns>A ruleset, if available, else null.</returns>
-        public RulesetInfo GetRuleset(int id) => AvailableRulesets.FirstOrDefault(r => r.ID == id);
+        public RulesetInfo? GetRuleset(int id) => AvailableRulesets.FirstOrDefault(r => r.OnlineID == id);
 
         /// <summary>
         /// Retrieve a ruleset using a known short name.
         /// </summary>
         /// <param name="shortName">The ruleset's short name.</param>
         /// <returns>A ruleset, if available, else null.</returns>
-        public RulesetInfo GetRuleset(string shortName) => AvailableRulesets.FirstOrDefault(r => r.ShortName == shortName);
+        public RulesetInfo? GetRuleset(string shortName) => AvailableRulesets.FirstOrDefault(r => r.ShortName == shortName);
 
-        /// <summary>
-        /// All available rulesets.
-        /// </summary>
-        public IEnumerable<RulesetInfo> AvailableRulesets { get; private set; }
-
-        private Assembly resolveRulesetDependencyAssembly(object sender, ResolveEventArgs args)
+        private Assembly? resolveRulesetDependencyAssembly(object? sender, ResolveEventArgs args)
         {
             var asm = new AssemblyName(args.Name);
 
@@ -72,7 +80,14 @@ namespace osu.Game.Rulesets
             // already loaded in the AppDomain.
             var domainAssembly = AppDomain.CurrentDomain.GetAssemblies()
                                           // Given name is always going to be equally-or-more qualified than the assembly name.
-                                          .Where(a => args.Name.Contains(a.GetName().Name, StringComparison.Ordinal))
+                                          .Where(a =>
+                                          {
+                                              string? name = a.GetName().Name;
+                                              if (name == null)
+                                                  return false;
+
+                                              return args.Name.Contains(name, StringComparison.Ordinal);
+                                          })
                                           // Pick the greatest assembly version.
                                           .OrderByDescending(a => a.GetName().Version)
                                           .FirstOrDefault();
@@ -85,69 +100,73 @@ namespace osu.Game.Rulesets
 
         private void addMissingRulesets()
         {
-            using (var usage = ContextFactory.GetForWrite())
+            using (var context = realmFactory.CreateContext())
             {
-                var context = usage.Context;
-
-                var instances = loadedAssemblies.Values.Select(r => (Ruleset)Activator.CreateInstance(r)).ToList();
-
-                // add all legacy rulesets first to ensure they have exclusive choice of primary key.
-                foreach (var r in instances.Where(r => r is ILegacyRuleset))
+                context.Write(realm =>
                 {
-                    if (context.RulesetInfo.SingleOrDefault(dbRuleset => dbRuleset.ID == r.RulesetInfo.ID) == null)
-                        context.RulesetInfo.Add(r.RulesetInfo);
-                }
+                    var rulesets = realm.All<RulesetInfo>();
 
-                context.SaveChanges();
+                    List<Ruleset> instances = loadedAssemblies.Values
+                                                              .Select(r => Activator.CreateInstance(r) as Ruleset)
+                                                              .Where(r => r != null)
+                                                              .Select(r => r.AsNonNull())
+                                                              .ToList();
 
-                var existingRulesets = context.RulesetInfo.ToList();
-
-                // add any other rulesets which have assemblies present but are not yet in the database.
-                foreach (var r in instances.Where(r => !(r is ILegacyRuleset)))
-                {
-                    if (existingRulesets.FirstOrDefault(ri => ri.InstantiationInfo.Equals(r.RulesetInfo.InstantiationInfo, StringComparison.Ordinal)) == null)
+                    // add all legacy rulesets first to ensure they have exclusive choice of primary key.
+                    foreach (var r in instances.Where(r => r is ILegacyRuleset))
                     {
-                        var existingSameShortName = existingRulesets.FirstOrDefault(ri => ri.ShortName == r.RulesetInfo.ShortName);
+                        if (realm.All<RulesetInfo>().FirstOrDefault(rr => rr.OnlineID == r.RulesetInfo.OnlineID) == null)
+                            realm.Add(new RulesetInfo(r.RulesetInfo.ShortName, r.RulesetInfo.Name, r.RulesetInfo.InstantiationInfo, r.RulesetInfo.OnlineID));
+                    }
 
-                        if (existingSameShortName != null)
+                    // add any other rulesets which have assemblies present but are not yet in the database.
+                    foreach (var r in instances.Where(r => !(r is ILegacyRuleset)))
+                    {
+                        if (rulesets.FirstOrDefault(ri => ri.InstantiationInfo.Equals(r.RulesetInfo.InstantiationInfo, StringComparison.Ordinal)) == null)
                         {
-                            // even if a matching InstantiationInfo was not found, there may be an existing ruleset with the same ShortName.
-                            // this generally means the user or ruleset provider has renamed their dll but the underlying ruleset is *likely* the same one.
-                            // in such cases, update the instantiation info of the existing entry to point to the new one.
-                            existingSameShortName.InstantiationInfo = r.RulesetInfo.InstantiationInfo;
+                            var existingSameShortName = rulesets.FirstOrDefault(ri => ri.ShortName == r.RulesetInfo.ShortName);
+
+                            if (existingSameShortName != null)
+                            {
+                                // even if a matching InstantiationInfo was not found, there may be an existing ruleset with the same ShortName.
+                                // this generally means the user or ruleset provider has renamed their dll but the underlying ruleset is *likely* the same one.
+                                // in such cases, update the instantiation info of the existing entry to point to the new one.
+                                existingSameShortName.InstantiationInfo = r.RulesetInfo.InstantiationInfo;
+                            }
+                            else
+                                realm.Add(new RulesetInfo(r.RulesetInfo.ShortName, r.RulesetInfo.Name, r.RulesetInfo.InstantiationInfo, r.RulesetInfo.OnlineID));
                         }
-                        else
-                            context.RulesetInfo.Add(r.RulesetInfo);
                     }
-                }
 
-                context.SaveChanges();
+                    List<RulesetInfo> detachedRulesets = new List<RulesetInfo>();
 
-                // perform a consistency check
-                foreach (var r in context.RulesetInfo)
-                {
-                    try
+                    // perform a consistency check and detach final rulesets from realm for cross-thread runtime usage.
+                    foreach (var r in rulesets)
                     {
-                        var resolvedType = Type.GetType(r.InstantiationInfo)
-                                           ?? throw new RulesetLoadException(@"Type could not be resolved");
+                        try
+                        {
+                            var resolvedType = Type.GetType(r.InstantiationInfo)
+                                               ?? throw new RulesetLoadException(@"Type could not be resolved");
 
-                        var instanceInfo = (Activator.CreateInstance(resolvedType) as Ruleset)?.RulesetInfo
-                                           ?? throw new RulesetLoadException(@"Instantiation failure");
+                            var instanceInfo = (Activator.CreateInstance(resolvedType) as Ruleset)?.RulesetInfo
+                                               ?? throw new RulesetLoadException(@"Instantiation failure");
 
-                        r.Name = instanceInfo.Name;
-                        r.ShortName = instanceInfo.ShortName;
-                        r.InstantiationInfo = instanceInfo.InstantiationInfo;
-                        r.Available = true;
+                            r.Name = instanceInfo.Name;
+                            r.ShortName = instanceInfo.ShortName;
+                            r.InstantiationInfo = instanceInfo.InstantiationInfo;
+                            r.Available = true;
+
+                            detachedRulesets.Add(r.Clone());
+                        }
+                        catch (Exception ex)
+                        {
+                            r.Available = false;
+                            Logger.Log($"Could not load ruleset {r}: {ex.Message}");
+                        }
                     }
-                    catch
-                    {
-                        r.Available = false;
-                    }
-                }
 
-                context.SaveChanges();
-
-                AvailableRulesets = context.RulesetInfo.Where(r => r.Available).ToList();
+                    availableRulesets.AddRange(detachedRulesets);
+                });
             }
         }
 
@@ -155,22 +174,23 @@ namespace osu.Game.Rulesets
         {
             foreach (var ruleset in AppDomain.CurrentDomain.GetAssemblies())
             {
-                string rulesetName = ruleset.GetName().Name;
+                string? rulesetName = ruleset.GetName().Name;
 
-                if (!rulesetName.StartsWith(ruleset_library_prefix, StringComparison.InvariantCultureIgnoreCase) || ruleset.GetName().Name.Contains("Tests"))
+                if (rulesetName == null)
+                    continue;
+
+                if (!rulesetName.StartsWith(ruleset_library_prefix, StringComparison.InvariantCultureIgnoreCase) || rulesetName.Contains(@"Tests"))
                     continue;
 
                 addRuleset(ruleset);
             }
         }
 
-        private void loadUserRulesets()
+        private void loadUserRulesets(Storage rulesetStorage)
         {
-            if (rulesetStorage == null) return;
+            var rulesets = rulesetStorage.GetFiles(@".", @$"{ruleset_library_prefix}.*.dll");
 
-            var rulesets = rulesetStorage.GetFiles(".", $"{ruleset_library_prefix}.*.dll");
-
-            foreach (string ruleset in rulesets.Where(f => !f.Contains("Tests")))
+            foreach (string? ruleset in rulesets.Where(f => !f.Contains(@"Tests")))
                 loadRulesetFromFile(rulesetStorage.GetFullPath(ruleset));
         }
 
@@ -178,7 +198,7 @@ namespace osu.Game.Rulesets
         {
             try
             {
-                string[] files = Directory.GetFiles(RuntimeInfo.StartupDirectory, $"{ruleset_library_prefix}.*.dll");
+                string[] files = Directory.GetFiles(RuntimeInfo.StartupDirectory, @$"{ruleset_library_prefix}.*.dll");
 
                 foreach (string file in files.Where(f => !Path.GetFileName(f).Contains("Tests")))
                     loadRulesetFromFile(file);
@@ -191,7 +211,7 @@ namespace osu.Game.Rulesets
 
         private void loadRulesetFromFile(string file)
         {
-            string filename = Path.GetFileNameWithoutExtension(file);
+            string? filename = Path.GetFileNameWithoutExtension(file);
 
             if (loadedAssemblies.Values.Any(t => Path.GetFileNameWithoutExtension(t.Assembly.Location) == filename))
                 return;
diff --git a/osu.Game/Stores/RealmRulesetStore.cs b/osu.Game/Stores/RealmRulesetStore.cs
deleted file mode 100644
index f208b392cb..0000000000
--- a/osu.Game/Stores/RealmRulesetStore.cs
+++ /dev/null
@@ -1,269 +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.IO;
-using System.Linq;
-using System.Reflection;
-using osu.Framework;
-using osu.Framework.Extensions.ObjectExtensions;
-using osu.Framework.Logging;
-using osu.Framework.Platform;
-using osu.Game.Database;
-using osu.Game.Rulesets;
-
-#nullable enable
-
-namespace osu.Game.Stores
-{
-    public class RealmRulesetStore : IRulesetStore, IDisposable
-    {
-        private readonly RealmContextFactory realmFactory;
-
-        private const string ruleset_library_prefix = @"osu.Game.Rulesets";
-
-        private readonly Dictionary<Assembly, Type> loadedAssemblies = new Dictionary<Assembly, Type>();
-
-        /// <summary>
-        /// All available rulesets.
-        /// </summary>
-        public IEnumerable<RealmRuleset> AvailableRulesets => availableRulesets;
-
-        private readonly List<RealmRuleset> availableRulesets = new List<RealmRuleset>();
-
-        public RealmRulesetStore(RealmContextFactory realmFactory, Storage? storage = null)
-        {
-            this.realmFactory = realmFactory;
-
-            // On android in release configuration assemblies are loaded from the apk directly into memory.
-            // We cannot read assemblies from cwd, so should check loaded assemblies instead.
-            loadFromAppDomain();
-
-            // This null check prevents Android from attempting to load the rulesets from disk,
-            // as the underlying path "AppContext.BaseDirectory", despite being non-nullable, it returns null on android.
-            // See https://github.com/xamarin/xamarin-android/issues/3489.
-            if (RuntimeInfo.StartupDirectory != null)
-                loadFromDisk();
-
-            // the event handler contains code for resolving dependency on the game assembly for rulesets located outside the base game directory.
-            // It needs to be attached to the assembly lookup event before the actual call to loadUserRulesets() else rulesets located out of the base game directory will fail
-            // to load as unable to locate the game core assembly.
-            AppDomain.CurrentDomain.AssemblyResolve += resolveRulesetDependencyAssembly;
-
-            var rulesetStorage = storage?.GetStorageForDirectory(@"rulesets");
-            if (rulesetStorage != null)
-                loadUserRulesets(rulesetStorage);
-
-            addMissingRulesets();
-        }
-
-        /// <summary>
-        /// Retrieve a ruleset using a known ID.
-        /// </summary>
-        /// <param name="id">The ruleset's internal ID.</param>
-        /// <returns>A ruleset, if available, else null.</returns>
-        public RealmRuleset? GetRuleset(int id) => AvailableRulesets.FirstOrDefault(r => r.OnlineID == id);
-
-        /// <summary>
-        /// Retrieve a ruleset using a known short name.
-        /// </summary>
-        /// <param name="shortName">The ruleset's short name.</param>
-        /// <returns>A ruleset, if available, else null.</returns>
-        public RealmRuleset? GetRuleset(string shortName) => AvailableRulesets.FirstOrDefault(r => r.ShortName == shortName);
-
-        private Assembly? resolveRulesetDependencyAssembly(object? sender, ResolveEventArgs args)
-        {
-            var asm = new AssemblyName(args.Name);
-
-            // the requesting assembly may be located out of the executable's base directory, thus requiring manual resolving of its dependencies.
-            // this attempts resolving the ruleset dependencies on game core and framework assemblies by returning assemblies with the same assembly name
-            // already loaded in the AppDomain.
-            var domainAssembly = AppDomain.CurrentDomain.GetAssemblies()
-                                          // Given name is always going to be equally-or-more qualified than the assembly name.
-                                          .Where(a =>
-                                          {
-                                              string? name = a.GetName().Name;
-                                              if (name == null)
-                                                  return false;
-
-                                              return args.Name.Contains(name, StringComparison.Ordinal);
-                                          })
-                                          // Pick the greatest assembly version.
-                                          .OrderByDescending(a => a.GetName().Version)
-                                          .FirstOrDefault();
-
-            if (domainAssembly != null)
-                return domainAssembly;
-
-            return loadedAssemblies.Keys.FirstOrDefault(a => a.FullName == asm.FullName);
-        }
-
-        private void addMissingRulesets()
-        {
-            using (var context = realmFactory.CreateContext())
-            {
-                context.Write(realm =>
-                {
-                    var rulesets = realm.All<RulesetInfo>();
-
-                    List<Ruleset> instances = loadedAssemblies.Values
-                                                              .Select(r => Activator.CreateInstance(r) as Ruleset)
-                                                              .Where(r => r != null)
-                                                              .Select(r => r.AsNonNull())
-                                                              .ToList();
-
-                    // add all legacy rulesets first to ensure they have exclusive choice of primary key.
-                    foreach (var r in instances.Where(r => r is ILegacyRuleset))
-                    {
-                        if (realm.All<RulesetInfo>().FirstOrDefault(rr => rr.OnlineID == r.RulesetInfo.OnlineID) == null)
-                            realm.Add(new RulesetInfo(r.RulesetInfo.ShortName, r.RulesetInfo.Name, r.RulesetInfo.InstantiationInfo, r.RulesetInfo.OnlineID));
-                    }
-
-                    // add any other rulesets which have assemblies present but are not yet in the database.
-                    foreach (var r in instances.Where(r => !(r is ILegacyRuleset)))
-                    {
-                        if (rulesets.FirstOrDefault(ri => ri.InstantiationInfo.Equals(r.RulesetInfo.InstantiationInfo, StringComparison.Ordinal)) == null)
-                        {
-                            var existingSameShortName = rulesets.FirstOrDefault(ri => ri.ShortName == r.RulesetInfo.ShortName);
-
-                            if (existingSameShortName != null)
-                            {
-                                // even if a matching InstantiationInfo was not found, there may be an existing ruleset with the same ShortName.
-                                // this generally means the user or ruleset provider has renamed their dll but the underlying ruleset is *likely* the same one.
-                                // in such cases, update the instantiation info of the existing entry to point to the new one.
-                                existingSameShortName.InstantiationInfo = r.RulesetInfo.InstantiationInfo;
-                            }
-                            else
-                                realm.Add(new RulesetInfo(r.RulesetInfo.ShortName, r.RulesetInfo.Name, r.RulesetInfo.InstantiationInfo, r.RulesetInfo.OnlineID));
-                        }
-                    }
-
-                    List<RulesetInfo> detachedRulesets = new List<RulesetInfo>();
-
-                    // perform a consistency check and detach final rulesets from realm for cross-thread runtime usage.
-                    foreach (var r in rulesets)
-                    {
-                        try
-                        {
-                            var resolvedType = Type.GetType(r.InstantiationInfo)
-                                               ?? throw new RulesetLoadException(@"Type could not be resolved");
-
-                            var instanceInfo = (Activator.CreateInstance(resolvedType) as Ruleset)?.RulesetInfo
-                                               ?? throw new RulesetLoadException(@"Instantiation failure");
-
-                            r.Name = instanceInfo.Name;
-                            r.ShortName = instanceInfo.ShortName;
-                            r.InstantiationInfo = instanceInfo.InstantiationInfo;
-                            r.Available = true;
-
-                            detachedRulesets.Add(r.Clone());
-                        }
-                        catch (Exception ex)
-                        {
-                            r.Available = false;
-                            Logger.Log($"Could not load ruleset {r}: {ex.Message}");
-                        }
-                    }
-
-                    availableRulesets.AddRange(detachedRulesets);
-                });
-            }
-        }
-
-        private void loadFromAppDomain()
-        {
-            foreach (var ruleset in AppDomain.CurrentDomain.GetAssemblies())
-            {
-                string? rulesetName = ruleset.GetName().Name;
-
-                if (rulesetName == null)
-                    continue;
-
-                if (!rulesetName.StartsWith(ruleset_library_prefix, StringComparison.InvariantCultureIgnoreCase) || rulesetName.Contains(@"Tests"))
-                    continue;
-
-                addRuleset(ruleset);
-            }
-        }
-
-        private void loadUserRulesets(Storage rulesetStorage)
-        {
-            var rulesets = rulesetStorage.GetFiles(@".", @$"{ruleset_library_prefix}.*.dll");
-
-            foreach (string? ruleset in rulesets.Where(f => !f.Contains(@"Tests")))
-                loadRulesetFromFile(rulesetStorage.GetFullPath(ruleset));
-        }
-
-        private void loadFromDisk()
-        {
-            try
-            {
-                string[] files = Directory.GetFiles(RuntimeInfo.StartupDirectory, @$"{ruleset_library_prefix}.*.dll");
-
-                foreach (string file in files.Where(f => !Path.GetFileName(f).Contains("Tests")))
-                    loadRulesetFromFile(file);
-            }
-            catch (Exception e)
-            {
-                Logger.Error(e, $"Could not load rulesets from directory {RuntimeInfo.StartupDirectory}");
-            }
-        }
-
-        private void loadRulesetFromFile(string file)
-        {
-            string? filename = Path.GetFileNameWithoutExtension(file);
-
-            if (loadedAssemblies.Values.Any(t => Path.GetFileNameWithoutExtension(t.Assembly.Location) == filename))
-                return;
-
-            try
-            {
-                addRuleset(Assembly.LoadFrom(file));
-            }
-            catch (Exception e)
-            {
-                Logger.Error(e, $"Failed to load ruleset {filename}");
-            }
-        }
-
-        private void addRuleset(Assembly assembly)
-        {
-            if (loadedAssemblies.ContainsKey(assembly))
-                return;
-
-            // the same assembly may be loaded twice in the same AppDomain (currently a thing in certain Rider versions https://youtrack.jetbrains.com/issue/RIDER-48799).
-            // as a failsafe, also compare by FullName.
-            if (loadedAssemblies.Any(a => a.Key.FullName == assembly.FullName))
-                return;
-
-            try
-            {
-                loadedAssemblies[assembly] = assembly.GetTypes().First(t => t.IsPublic && t.IsSubclassOf(typeof(Ruleset)));
-            }
-            catch (Exception e)
-            {
-                Logger.Error(e, $"Failed to add ruleset {assembly}");
-            }
-        }
-
-        public void Dispose()
-        {
-            Dispose(true);
-            GC.SuppressFinalize(this);
-        }
-
-        protected virtual void Dispose(bool disposing)
-        {
-            AppDomain.CurrentDomain.AssemblyResolve -= resolveRulesetDependencyAssembly;
-        }
-
-        #region Implementation of IRulesetStore
-
-        IRulesetInfo? IRulesetStore.GetRuleset(int id) => GetRuleset(id);
-        IRulesetInfo? IRulesetStore.GetRuleset(string shortName) => GetRuleset(shortName);
-        IEnumerable<IRulesetInfo> IRulesetStore.AvailableRulesets => AvailableRulesets;
-
-        #endregion
-    }
-}

From 116f35c52ab361a2f3bc4802e656873696698524 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 1 Dec 2021 16:10:50 +0900
Subject: [PATCH 2009/5547] Remove EF `FileStore`

---
 .../Visual/Navigation/TestSceneOsuGame.cs     |   4 +-
 osu.Game/Beatmaps/BeatmapManager.cs           |   3 +-
 osu.Game/IO/FileStore.cs                      | 125 ------------------
 osu.Game/OsuGameBase.cs                       |   6 -
 4 files changed, 4 insertions(+), 134 deletions(-)
 delete mode 100644 osu.Game/IO/FileStore.cs

diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneOsuGame.cs b/osu.Game.Tests/Visual/Navigation/TestSceneOsuGame.cs
index 28ff776d5f..99904af42d 100644
--- a/osu.Game.Tests/Visual/Navigation/TestSceneOsuGame.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneOsuGame.cs
@@ -16,7 +16,6 @@ using osu.Game.Database;
 using osu.Game.Graphics;
 using osu.Game.Input;
 using osu.Game.Input.Bindings;
-using osu.Game.IO;
 using osu.Game.Online.API;
 using osu.Game.Online.Chat;
 using osu.Game.Overlays;
@@ -25,6 +24,7 @@ using osu.Game.Rulesets.Mods;
 using osu.Game.Scoring;
 using osu.Game.Screens.Menu;
 using osu.Game.Skinning;
+using osu.Game.Stores;
 using osu.Game.Utils;
 
 namespace osu.Game.Tests.Visual.Navigation
@@ -69,7 +69,7 @@ namespace osu.Game.Tests.Visual.Navigation
             typeof(ISkinSource),
             typeof(IAPIProvider),
             typeof(RulesetStore),
-            typeof(FileStore),
+            typeof(RealmFileStore),
             typeof(ScoreManager),
             typeof(BeatmapManager),
             typeof(IRulesetConfigCache),
diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index 59adcfca60..a8897adf04 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -24,6 +24,7 @@ using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays.Notifications;
 using osu.Game.Rulesets;
 using osu.Game.Skinning;
+using osu.Game.Stores;
 
 namespace osu.Game.Beatmaps
 {
@@ -42,7 +43,7 @@ namespace osu.Game.Beatmaps
 
         public BeatmapManager(Storage storage, RealmContextFactory contextFactory, RulesetStore rulesets, IAPIProvider api, [NotNull] AudioManager audioManager, IResourceStore<byte[]> gameResources, GameHost host = null, WorkingBeatmap defaultBeatmap = null, bool performOnlineLookups = false)
         {
-            var userResources = new FileStore(contextFactory, storage).Store;
+            var userResources = new RealmFileStore(contextFactory, storage).Store;
 
             BeatmapTrackStore = audioManager.GetTrackStore(userResources);
 
diff --git a/osu.Game/IO/FileStore.cs b/osu.Game/IO/FileStore.cs
deleted file mode 100644
index ebe1ebfe69..0000000000
--- a/osu.Game/IO/FileStore.cs
+++ /dev/null
@@ -1,125 +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.IO;
-using System.Linq;
-using osu.Framework.Extensions;
-using osu.Framework.IO.Stores;
-using osu.Framework.Logging;
-using osu.Framework.Platform;
-using osu.Game.Database;
-using osu.Game.Extensions;
-
-namespace osu.Game.IO
-{
-    /// <summary>
-    /// Handles the Store and retrieval of Files/FileSets to the database backing
-    /// </summary>
-    public class FileStore : DatabaseBackedStore
-    {
-        public readonly IResourceStore<byte[]> Store;
-
-        public new Storage Storage => base.Storage;
-
-        public FileStore(IDatabaseContextFactory contextFactory, Storage storage)
-            : base(contextFactory, storage.GetStorageForDirectory(@"files"))
-        {
-            Store = new StorageBackedResourceStore(Storage);
-        }
-
-        public FileInfo Add(Stream data, bool reference = true)
-        {
-            using (var usage = ContextFactory.GetForWrite())
-            {
-                string hash = data.ComputeSHA2Hash();
-
-                var existing = usage.Context.FileInfo.FirstOrDefault(f => f.Hash == hash);
-
-                var info = existing ?? new FileInfo { Hash = hash };
-
-                string path = info.GetStoragePath();
-
-                // we may be re-adding a file to fix missing store entries.
-                bool requiresCopy = !Storage.Exists(path);
-
-                if (!requiresCopy)
-                {
-                    // even if the file already exists, check the existing checksum for safety.
-                    using (var stream = Storage.GetStream(path))
-                        requiresCopy |= stream.ComputeSHA2Hash() != hash;
-                }
-
-                if (requiresCopy)
-                {
-                    data.Seek(0, SeekOrigin.Begin);
-
-                    using (var output = Storage.GetStream(path, FileAccess.Write))
-                        data.CopyTo(output);
-
-                    data.Seek(0, SeekOrigin.Begin);
-                }
-
-                if (reference || existing == null)
-                    Reference(info);
-
-                return info;
-            }
-        }
-
-        public void Reference(params FileInfo[] files)
-        {
-            if (files.Length == 0) return;
-
-            using (var usage = ContextFactory.GetForWrite())
-            {
-                var context = usage.Context;
-
-                foreach (var f in files.GroupBy(f => f.ID))
-                {
-                    var refetch = context.Find<FileInfo>(f.First().ID) ?? f.First();
-                    refetch.ReferenceCount += f.Count();
-                    context.FileInfo.Update(refetch);
-                }
-            }
-        }
-
-        public void Dereference(params FileInfo[] files)
-        {
-            if (files.Length == 0) return;
-
-            using (var usage = ContextFactory.GetForWrite())
-            {
-                var context = usage.Context;
-
-                foreach (var f in files.GroupBy(f => f.ID))
-                {
-                    var refetch = context.FileInfo.Find(f.Key);
-                    refetch.ReferenceCount -= f.Count();
-                    context.FileInfo.Update(refetch);
-                }
-            }
-        }
-
-        public override void Cleanup()
-        {
-            using (var usage = ContextFactory.GetForWrite())
-            {
-                var context = usage.Context;
-
-                foreach (var f in context.FileInfo.Where(f => f.ReferenceCount < 1))
-                {
-                    try
-                    {
-                        Storage.Delete(f.GetStoragePath());
-                        context.FileInfo.Remove(f);
-                    }
-                    catch (Exception e)
-                    {
-                        Logger.Error(e, $@"Could not delete beatmap {f}");
-                    }
-                }
-            }
-        }
-    }
-}
diff --git a/osu.Game/OsuGameBase.cs b/osu.Game/OsuGameBase.cs
index 144ee17c29..065cec0e97 100644
--- a/osu.Game/OsuGameBase.cs
+++ b/osu.Game/OsuGameBase.cs
@@ -143,8 +143,6 @@ namespace osu.Game
         private UserLookupCache userCache;
         private BeatmapLookupCache beatmapCache;
 
-        private FileStore fileStore;
-
         private RulesetConfigCache rulesetConfigCache;
 
         private SpectatorClient spectatorClient;
@@ -226,8 +224,6 @@ namespace osu.Game
 
             var defaultBeatmap = new DummyWorkingBeatmap(Audio, Textures);
 
-            dependencies.Cache(fileStore = new FileStore(contextFactory, Storage));
-
             dependencies.Cache(RulesetStore = new RulesetStore(realmFactory, Storage));
 
             // ordering is important here to ensure foreign keys rules are not broken in ModelStore.Cleanup()
@@ -285,8 +281,6 @@ namespace osu.Game
             dependencies.CacheAs<IBindable<WorkingBeatmap>>(Beatmap);
             dependencies.CacheAs(Beatmap);
 
-            fileStore.Cleanup();
-
             // add api components to hierarchy.
             if (API is APIAccess apiAccess)
                 AddInternal(apiAccess);

From 4763fe54d6341b1797634dbbdb588a44f1139c07 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 1 Dec 2021 16:17:53 +0900
Subject: [PATCH 2010/5547] Remove unused store classes

---
 osu.Game/Skinning/SkinStore.cs | 16 ----------------
 1 file changed, 16 deletions(-)
 delete mode 100644 osu.Game/Skinning/SkinStore.cs

diff --git a/osu.Game/Skinning/SkinStore.cs b/osu.Game/Skinning/SkinStore.cs
deleted file mode 100644
index 922d146259..0000000000
--- a/osu.Game/Skinning/SkinStore.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 osu.Framework.Platform;
-using osu.Game.Database;
-
-namespace osu.Game.Skinning
-{
-    public class SkinStore : MutableDatabaseBackedStoreWithFileIncludes<EFSkinInfo, SkinFileInfo>
-    {
-        public SkinStore(DatabaseContextFactory contextFactory, Storage storage = null)
-            : base(contextFactory, storage)
-        {
-        }
-    }
-}

From b77bb2f12b853bf4be1e18e149984fad747262e1 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 1 Dec 2021 16:19:38 +0900
Subject: [PATCH 2011/5547] Switch `BeatmapModelManager` to use
 `RealmArchiveModelManager` base class

---
 osu.Game/Beatmaps/BeatmapModelManager.cs | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Beatmaps/BeatmapModelManager.cs b/osu.Game/Beatmaps/BeatmapModelManager.cs
index 2a9b215f32..b909175d2d 100644
--- a/osu.Game/Beatmaps/BeatmapModelManager.cs
+++ b/osu.Game/Beatmaps/BeatmapModelManager.cs
@@ -24,6 +24,7 @@ using osu.Game.IO.Archives;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Objects;
 using osu.Game.Skinning;
+using osu.Game.Stores;
 using Decoder = osu.Game.Beatmaps.Formats.Decoder;
 
 namespace osu.Game.Beatmaps
@@ -32,7 +33,7 @@ namespace osu.Game.Beatmaps
     /// Handles ef-core storage of beatmaps.
     /// </summary>
     [ExcludeFromDynamicCompile]
-    public class BeatmapModelManager : ArchiveModelManager<BeatmapSetInfo, BeatmapSetFileInfo>
+    public class BeatmapModelManager : RealmArchiveModelManager<BeatmapSetInfo>
     {
         /// <summary>
         /// Fired when a single difficulty has been hidden.

From b8cd3cdbbc2f04b861a879201c828559a6b725ff Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 24 Nov 2021 12:16:08 +0900
Subject: [PATCH 2012/5547] Various updates to ruleset and primary key usages
 to move closer to realm support

---
 .../Database/BeatmapImporterTests.cs          |  2 +-
 .../UserInterface/TestScenePlaylistOverlay.cs |  2 +-
 osu.Game/Beatmaps/Beatmap.cs                  |  2 +-
 osu.Game/Beatmaps/BeatmapManager.cs           |  6 ++--
 osu.Game/Beatmaps/BeatmapOnlineLookupQueue.cs | 22 +++++++--------
 osu.Game/Beatmaps/WorkingBeatmapCache.cs      |  5 ++--
 osu.Game/Database/DatabaseBackedStore.cs      |  4 +--
 osu.Game/Database/ModelDownloader.cs          |  2 +-
 .../Bindings/DatabasedKeyBindingContainer.cs  |  2 +-
 osu.Game/OsuGameBase.cs                       | 28 ++++++-------------
 osu.Game/Rulesets/EFRulesetInfo.cs            |  2 +-
 osu.Game/Screens/Edit/Verify/VerifyScreen.cs  |  2 +-
 osu.Game/Screens/Play/Player.cs               |  7 +++--
 osu.Game/Screens/Play/SoloPlayer.cs           |  2 +-
 osu.Game/Screens/Select/BeatmapCarousel.cs    |  9 +++---
 .../Select/Carousel/CarouselBeatmapSet.cs     | 10 +++----
 .../Select/Carousel/SetPanelContent.cs        |  4 +--
 osu.Game/Screens/Select/FilterControl.cs      |  5 +---
 .../Select/Leaderboards/BeatmapLeaderboard.cs |  4 +--
 osu.Game/Screens/Select/SongSelect.cs         |  2 +-
 .../Tests/Beatmaps/HitObjectSampleTest.cs     | 13 +++++----
 osu.Game/Tests/Visual/EditorTestScene.cs      |  2 +-
 22 files changed, 64 insertions(+), 73 deletions(-)

diff --git a/osu.Game.Tests/Database/BeatmapImporterTests.cs b/osu.Game.Tests/Database/BeatmapImporterTests.cs
index adee545c1d..c5dbcf155c 100644
--- a/osu.Game.Tests/Database/BeatmapImporterTests.cs
+++ b/osu.Game.Tests/Database/BeatmapImporterTests.cs
@@ -505,7 +505,7 @@ namespace osu.Game.Tests.Database
             RunTestWithRealmAsync(async (realmFactory, storage) =>
             {
                 using var importer = new NonOptimisedBeatmapImporter(realmFactory, storage);
-                using var store = new RealmRulesetStore(realmFactory, storage);
+                using var store = new RulesetStore(realmFactory, storage);
 
                 var imported = await LoadOszIntoStore(importer, realmFactory.Context);
 
diff --git a/osu.Game.Tests/Visual/UserInterface/TestScenePlaylistOverlay.cs b/osu.Game.Tests/Visual/UserInterface/TestScenePlaylistOverlay.cs
index 39146d584c..62f3b63780 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestScenePlaylistOverlay.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestScenePlaylistOverlay.cs
@@ -71,7 +71,7 @@ namespace osu.Game.Tests.Visual.UserInterface
                 InputManager.MoveMouseTo(item.ScreenSpaceDrawQuad.Centre);
             });
 
-            AddAssert("song 1 is 5th", () => beatmapSets[4] == first);
+            AddAssert("song 1 is 5th", () => beatmapSets[4].Equals(first));
 
             AddStep("release handle", () => InputManager.ReleaseButton(MouseButton.Left));
         }
diff --git a/osu.Game/Beatmaps/Beatmap.cs b/osu.Game/Beatmaps/Beatmap.cs
index 435183fe92..ccecd69d21 100644
--- a/osu.Game/Beatmaps/Beatmap.cs
+++ b/osu.Game/Beatmaps/Beatmap.cs
@@ -62,7 +62,7 @@ namespace osu.Game.Beatmaps
         }
 
         [JsonIgnore]
-        public BeatmapMetadata Metadata => BeatmapInfo?.Metadata ?? BeatmapInfo?.BeatmapSet?.Metadata;
+        public BeatmapMetadata Metadata => BeatmapInfo.Metadata;
 
         public ControlPointInfo ControlPointInfo { get; set; } = new ControlPointInfo();
 
diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index a8897adf04..5c8cf38682 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -32,7 +32,7 @@ namespace osu.Game.Beatmaps
     /// Handles general operations related to global beatmap management.
     /// </summary>
     [ExcludeFromDynamicCompile]
-    public class BeatmapManager : IModelManager<BeatmapSetInfo>, IModelFileManager<BeatmapSetInfo, BeatmapSetFileInfo>, IModelImporter<BeatmapSetInfo>, IWorkingBeatmapCache, IDisposable
+    public class BeatmapManager : IModelManager<BeatmapSetInfo>, IModelFileManager<BeatmapSetInfo, RealmNamedFileUsage>, IModelImporter<BeatmapSetInfo>, IWorkingBeatmapCache, IDisposable
     {
         public ITrackStore BeatmapTrackStore { get; }
 
@@ -294,12 +294,12 @@ namespace osu.Game.Beatmaps
 
         #region Implementation of IModelFileManager<in BeatmapSetInfo,in BeatmapSetFileInfo>
 
-        public void ReplaceFile(BeatmapSetInfo model, BeatmapSetFileInfo file, Stream contents)
+        public void ReplaceFile(BeatmapSetInfo model, RealmNamedFileUsage file, Stream contents)
         {
             beatmapModelManager.ReplaceFile(model, file, contents);
         }
 
-        public void DeleteFile(BeatmapSetInfo model, BeatmapSetFileInfo file)
+        public void DeleteFile(BeatmapSetInfo model, RealmNamedFileUsage file)
         {
             beatmapModelManager.DeleteFile(model, file);
         }
diff --git a/osu.Game/Beatmaps/BeatmapOnlineLookupQueue.cs b/osu.Game/Beatmaps/BeatmapOnlineLookupQueue.cs
index 3c4da12833..444bf09487 100644
--- a/osu.Game/Beatmaps/BeatmapOnlineLookupQueue.cs
+++ b/osu.Game/Beatmaps/BeatmapOnlineLookupQueue.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.Linq;
 using System.Threading;
@@ -16,6 +17,7 @@ using osu.Framework.Threading;
 using osu.Game.Database;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests;
+using osu.Game.Stores;
 using SharpCompress.Compressors;
 using SharpCompress.Compressors.BZip2;
 
@@ -83,15 +85,14 @@ namespace osu.Game.Beatmaps
                 if (res != null)
                 {
                     beatmapInfo.Status = res.Status;
+
+                    Debug.Assert(beatmapInfo.BeatmapSet != null);
+
                     beatmapInfo.BeatmapSet.Status = res.BeatmapSet?.Status ?? BeatmapOnlineStatus.None;
                     beatmapInfo.BeatmapSet.OnlineID = res.OnlineBeatmapSetID;
                     beatmapInfo.OnlineID = res.OnlineID;
 
-                    if (beatmapInfo.Metadata != null)
-                        beatmapInfo.Metadata.AuthorID = res.AuthorID;
-
-                    if (beatmapInfo.BeatmapSet.Metadata != null)
-                        beatmapInfo.BeatmapSet.Metadata.AuthorID = res.AuthorID;
+                    beatmapInfo.Metadata.Author.OnlineID = res.AuthorID;
 
                     logForModel(set, $"Online retrieval mapped {beatmapInfo} to {res.OnlineBeatmapSetID} / {res.OnlineID}.");
                 }
@@ -185,15 +186,14 @@ namespace osu.Game.Beatmaps
                                 var status = (BeatmapOnlineStatus)reader.GetByte(2);
 
                                 beatmapInfo.Status = status;
+
+                                Debug.Assert(beatmapInfo.BeatmapSet != null);
+
                                 beatmapInfo.BeatmapSet.Status = status;
                                 beatmapInfo.BeatmapSet.OnlineID = reader.GetInt32(0);
                                 beatmapInfo.OnlineID = reader.GetInt32(1);
 
-                                if (beatmapInfo.Metadata != null)
-                                    beatmapInfo.Metadata.AuthorID = reader.GetInt32(3);
-
-                                if (beatmapInfo.BeatmapSet.Metadata != null)
-                                    beatmapInfo.BeatmapSet.Metadata.AuthorID = reader.GetInt32(3);
+                                beatmapInfo.Metadata.Author.OnlineID = reader.GetInt32(3);
 
                                 logForModel(set, $"Cached local retrieval for {beatmapInfo}.");
                                 return true;
@@ -211,7 +211,7 @@ namespace osu.Game.Beatmaps
         }
 
         private void logForModel(BeatmapSetInfo set, string message) =>
-            ArchiveModelManager<BeatmapSetInfo, BeatmapSetFileInfo>.LogForModel(set, $"[{nameof(BeatmapOnlineLookupQueue)}] {message}");
+            RealmArchiveModelImporter<BeatmapSetInfo>.LogForModel(set, $"[{nameof(BeatmapOnlineLookupQueue)}] {message}");
 
         public void Dispose()
         {
diff --git a/osu.Game/Beatmaps/WorkingBeatmapCache.cs b/osu.Game/Beatmaps/WorkingBeatmapCache.cs
index 514551e184..95983ae052 100644
--- a/osu.Game/Beatmaps/WorkingBeatmapCache.cs
+++ b/osu.Game/Beatmaps/WorkingBeatmapCache.cs
@@ -79,7 +79,7 @@ namespace osu.Game.Beatmaps
             // if there are no files, presume the full beatmap info has not yet been fetched from the database.
             if (beatmapInfo?.BeatmapSet?.Files.Count == 0)
             {
-                int lookupId = beatmapInfo.ID;
+                var lookupId = beatmapInfo.ID;
                 beatmapInfo = BeatmapManager.QueryBeatmap(b => b.ID == lookupId);
             }
 
@@ -93,7 +93,8 @@ namespace osu.Game.Beatmaps
                 if (working != null)
                     return working;
 
-                beatmapInfo.Metadata ??= beatmapInfo.BeatmapSet.Metadata;
+                // TODO: is this still required..?
+                //beatmapInfo.Metadata ??= beatmapInfo.BeatmapSet.Metadata;
 
                 workingCache.Add(working = new BeatmapManagerWorkingBeatmap(beatmapInfo, this));
 
diff --git a/osu.Game/Database/DatabaseBackedStore.cs b/osu.Game/Database/DatabaseBackedStore.cs
index 03e1c014b2..a37155ee62 100644
--- a/osu.Game/Database/DatabaseBackedStore.cs
+++ b/osu.Game/Database/DatabaseBackedStore.cs
@@ -11,7 +11,7 @@ namespace osu.Game.Database
     {
         protected readonly Storage Storage;
 
-        protected readonly IDatabaseContextFactory ContextFactory;
+        protected readonly RealmContextFactory ContextFactory;
 
         /// <summary>
         /// Refresh an instance potentially from a different thread with a local context-tracked instance.
@@ -36,7 +36,7 @@ namespace osu.Game.Database
             }
         }
 
-        protected DatabaseBackedStore(IDatabaseContextFactory contextFactory, Storage storage = null)
+        protected DatabaseBackedStore(RealmContextFactory contextFactory, Storage storage = null)
         {
             ContextFactory = contextFactory;
             Storage = storage;
diff --git a/osu.Game/Database/ModelDownloader.cs b/osu.Game/Database/ModelDownloader.cs
index 362bc68cc1..2fa3357b06 100644
--- a/osu.Game/Database/ModelDownloader.cs
+++ b/osu.Game/Database/ModelDownloader.cs
@@ -14,7 +14,7 @@ using osu.Game.Overlays.Notifications;
 namespace osu.Game.Database
 {
     public abstract class ModelDownloader<TModel, T> : IModelDownloader<T>
-        where TModel : class, IHasPrimaryKey, ISoftDelete, IEquatable<TModel>, T
+        where TModel : class, IHasGuidPrimaryKey, ISoftDelete, IEquatable<TModel>, T
         where T : class
     {
         public Action<Notification> PostNotification { protected get; set; }
diff --git a/osu.Game/Input/Bindings/DatabasedKeyBindingContainer.cs b/osu.Game/Input/Bindings/DatabasedKeyBindingContainer.cs
index f95c884fe5..9482f1c0d8 100644
--- a/osu.Game/Input/Bindings/DatabasedKeyBindingContainer.cs
+++ b/osu.Game/Input/Bindings/DatabasedKeyBindingContainer.cs
@@ -78,7 +78,7 @@ namespace osu.Game.Input.Bindings
         {
             var defaults = DefaultKeyBindings.ToList();
 
-            if (ruleset != null && !ruleset.ID.HasValue)
+            if (ruleset != null && !ruleset.IsManaged)
                 // some tests instantiate a ruleset which is not present in the database.
                 // in these cases we still want key bindings to work, but matching to database instances would result in none being present,
                 // so let's populate the defaults directly.
diff --git a/osu.Game/OsuGameBase.cs b/osu.Game/OsuGameBase.cs
index 065cec0e97..c4dcc35b8e 100644
--- a/osu.Game/OsuGameBase.cs
+++ b/osu.Game/OsuGameBase.cs
@@ -190,9 +190,6 @@ namespace osu.Game
 
             runMigrations();
 
-            dependencies.Cache(RulesetStore = new RulesetStore(contextFactory, Storage));
-            dependencies.CacheAs<IRulesetStore>(RulesetStore);
-
             dependencies.Cache(realmFactory = new RealmContextFactory(Storage, "client", contextFactory));
 
             new EFToRealmMigrator(contextFactory, realmFactory, LocalConfig).Run();
@@ -227,24 +224,12 @@ namespace osu.Game
             dependencies.Cache(RulesetStore = new RulesetStore(realmFactory, Storage));
 
             // ordering is important here to ensure foreign keys rules are not broken in ModelStore.Cleanup()
-            dependencies.Cache(ScoreManager = new ScoreManager(RulesetStore, () => BeatmapManager, Storage, contextFactory, Scheduler, Host, () => difficultyCache, LocalConfig));
-            dependencies.Cache(BeatmapManager = new BeatmapManager(Storage, contextFactory, RulesetStore, API, Audio, Resources, Host, defaultBeatmap, performOnlineLookups: true));
+            dependencies.Cache(ScoreManager = new ScoreManager(RulesetStore, () => BeatmapManager, Storage, API, realmFactory, Scheduler, Host, () => difficultyCache, LocalConfig));
+            dependencies.Cache(BeatmapManager = new BeatmapManager(Storage, realmFactory, RulesetStore, API, Audio, Resources, Host, defaultBeatmap, performOnlineLookups: true));
 
             dependencies.Cache(BeatmapDownloader = new BeatmapModelDownloader(BeatmapManager, API));
             dependencies.Cache(ScoreDownloader = new ScoreModelDownloader(ScoreManager, API));
 
-            // this should likely be moved to ArchiveModelManager when another case appears where it is necessary
-            // to have inter-dependent model managers. this could be obtained with an IHasForeign<T> interface to
-            // allow lookups to be done on the child (ScoreManager in this case) to perform the cascading delete.
-            List<ScoreInfo> getBeatmapScores(BeatmapSetInfo set)
-            {
-                var beatmapIds = BeatmapManager.QueryBeatmaps(b => b.BeatmapSetInfoID == set.ID).Select(b => b.ID).ToList();
-                return ScoreManager.QueryScores(s => beatmapIds.Contains(s.BeatmapInfo.ID)).ToList();
-            }
-
-            BeatmapManager.ItemRemoved += item => ScoreManager.Delete(getBeatmapScores(item), true);
-            BeatmapManager.ItemUpdated += item => ScoreManager.Undelete(getBeatmapScores(item), true);
-
             dependencies.Cache(difficultyCache = new BeatmapDifficultyCache());
             AddInternal(difficultyCache);
 
@@ -438,7 +423,9 @@ namespace osu.Game
 
         private void onRulesetChanged(ValueChangedEvent<RulesetInfo> r)
         {
-            if (r.NewValue?.Available != true)
+            Ruleset instance;
+
+            if (r.NewValue?.Available != true || (instance = r.NewValue.CreateInstance()) == null)
             {
                 // reject the change if the ruleset is not available.
                 Ruleset.Value = r.OldValue?.Available == true ? r.OldValue : RulesetStore.AvailableRulesets.First();
@@ -448,7 +435,9 @@ namespace osu.Game
             var dict = new Dictionary<ModType, IReadOnlyList<Mod>>();
 
             foreach (ModType type in Enum.GetValues(typeof(ModType)))
-                dict[type] = r.NewValue.CreateInstance().GetModsFor(type).ToList();
+            {
+                dict[type] = instance.GetModsFor(type).ToList();
+            }
 
             if (!SelectedMods.Disabled)
                 SelectedMods.Value = Array.Empty<Mod>();
@@ -489,7 +478,6 @@ namespace osu.Game
 
             contextFactory?.FlushConnections();
 
-            realmRulesetStore?.Dispose();
             realmFactory?.Dispose();
         }
     }
diff --git a/osu.Game/Rulesets/EFRulesetInfo.cs b/osu.Game/Rulesets/EFRulesetInfo.cs
index 36e2add557..a7070ad2b6 100644
--- a/osu.Game/Rulesets/EFRulesetInfo.cs
+++ b/osu.Game/Rulesets/EFRulesetInfo.cs
@@ -40,7 +40,7 @@ namespace osu.Game.Rulesets
                 throw new RulesetLoadException(@"Instantiation failure");
 
             // overwrite the pre-populated RulesetInfo with a potentially database attached copy.
-            ruleset.RulesetInfo = this;
+            // ruleset.RulesetInfo = this;
 
             return ruleset;
         }
diff --git a/osu.Game/Screens/Edit/Verify/VerifyScreen.cs b/osu.Game/Screens/Edit/Verify/VerifyScreen.cs
index 6d7a4a72e2..08643eb8c1 100644
--- a/osu.Game/Screens/Edit/Verify/VerifyScreen.cs
+++ b/osu.Game/Screens/Edit/Verify/VerifyScreen.cs
@@ -29,7 +29,7 @@ namespace osu.Game.Screens.Edit.Verify
         [BackgroundDependencyLoader]
         private void load()
         {
-            InterpretedDifficulty.Default = EditorBeatmap.BeatmapInfo.DifficultyRating;
+            InterpretedDifficulty.Default = BeatmapDifficultyCache.GetDifficultyRating(EditorBeatmap.BeatmapInfo.StarRating);
             InterpretedDifficulty.SetDefault();
 
             IssueList = new IssueList();
diff --git a/osu.Game/Screens/Play/Player.cs b/osu.Game/Screens/Play/Player.cs
index 2a6f5e2398..a66026b423 100644
--- a/osu.Game/Screens/Play/Player.cs
+++ b/osu.Game/Screens/Play/Player.cs
@@ -226,8 +226,8 @@ namespace osu.Game.Screens.Play
             // ensure the score is in a consistent state with the current player.
             Score.ScoreInfo.BeatmapInfo = Beatmap.Value.BeatmapInfo;
             Score.ScoreInfo.Ruleset = ruleset.RulesetInfo;
-            if (ruleset.RulesetInfo.ID != null)
-                Score.ScoreInfo.RulesetID = ruleset.RulesetInfo.ID.Value;
+            if (ruleset.RulesetInfo.OnlineID >= 0)
+                Score.ScoreInfo.RulesetID = ruleset.RulesetInfo.OnlineID;
             Score.ScoreInfo.Mods = gameplayMods;
 
             dependencies.CacheAs(GameplayState = new GameplayState(playableBeatmap, ruleset, gameplayMods, Score));
@@ -488,6 +488,9 @@ namespace osu.Game.Screens.Play
                 var rulesetInfo = Ruleset.Value ?? Beatmap.Value.BeatmapInfo.Ruleset;
                 ruleset = rulesetInfo.CreateInstance();
 
+                if (ruleset == null)
+                    throw new RulesetLoadException("Instantiation failure");
+
                 try
                 {
                     playable = Beatmap.Value.GetPlayableBeatmap(ruleset.RulesetInfo, gameplayMods);
diff --git a/osu.Game/Screens/Play/SoloPlayer.cs b/osu.Game/Screens/Play/SoloPlayer.cs
index c8d831ebe6..eced2d142b 100644
--- a/osu.Game/Screens/Play/SoloPlayer.cs
+++ b/osu.Game/Screens/Play/SoloPlayer.cs
@@ -26,7 +26,7 @@ namespace osu.Game.Screens.Play
 
         protected override APIRequest<APIScoreToken> CreateTokenRequest()
         {
-            int beatmapId = Beatmap.Value.BeatmapInfo.OnlineID ?? -1;
+            int beatmapId = Beatmap.Value.BeatmapInfo.OnlineID;
             int rulesetId = Ruleset.Value.OnlineID;
 
             if (beatmapId <= 0)
diff --git a/osu.Game/Screens/Select/BeatmapCarousel.cs b/osu.Game/Screens/Select/BeatmapCarousel.cs
index b0d0821ee9..7e292e2de7 100644
--- a/osu.Game/Screens/Select/BeatmapCarousel.cs
+++ b/osu.Game/Screens/Select/BeatmapCarousel.cs
@@ -197,7 +197,8 @@ namespace osu.Game.Screens.Select
 
         public void UpdateBeatmapSet(BeatmapSetInfo beatmapSet) => Schedule(() =>
         {
-            int? previouslySelectedID = null;
+            Guid? previouslySelectedID = null;
+
             CarouselBeatmapSet existingSet = beatmapSets.FirstOrDefault(b => b.BeatmapSet.Equals(beatmapSet));
 
             // If the selected beatmap is about to be removed, store its ID so it can be re-selected if required
@@ -626,9 +627,9 @@ namespace osu.Game.Screens.Select
             if (beatmapSet.Beatmaps.All(b => b.Hidden))
                 return null;
 
-            // todo: remove the need for this.
-            foreach (var b in beatmapSet.Beatmaps)
-                b.Metadata ??= beatmapSet.Metadata;
+            // todo: probably not required any more.
+            // foreach (var b in beatmapSet.Beatmaps)
+            //     b.Metadata ??= beatmapSet.Metadata;
 
             var set = new CarouselBeatmapSet(beatmapSet)
             {
diff --git a/osu.Game/Screens/Select/Carousel/CarouselBeatmapSet.cs b/osu.Game/Screens/Select/Carousel/CarouselBeatmapSet.cs
index 9e411d5daa..a1a8de04ae 100644
--- a/osu.Game/Screens/Select/Carousel/CarouselBeatmapSet.cs
+++ b/osu.Game/Screens/Select/Carousel/CarouselBeatmapSet.cs
@@ -48,7 +48,7 @@ namespace osu.Game.Screens.Select.Carousel
             if (LastSelected == null || LastSelected.Filtered.Value)
             {
                 if (GetRecommendedBeatmap?.Invoke(Children.OfType<CarouselBeatmap>().Where(b => !b.Filtered.Value).Select(b => b.BeatmapInfo)) is BeatmapInfo recommended)
-                    return Children.OfType<CarouselBeatmap>().First(b => b.BeatmapInfo == recommended);
+                    return Children.OfType<CarouselBeatmap>().First(b => b.BeatmapInfo.Equals(recommended));
             }
 
             return base.GetNextToSelect();
@@ -63,16 +63,16 @@ namespace osu.Game.Screens.Select.Carousel
             {
                 default:
                 case SortMode.Artist:
-                    return string.Compare(BeatmapSet.Metadata.Artist, otherSet.BeatmapSet.Metadata.Artist, StringComparison.OrdinalIgnoreCase);
+                    return string.Compare(BeatmapSet.Metadata?.Artist, otherSet.BeatmapSet.Metadata?.Artist, StringComparison.OrdinalIgnoreCase);
 
                 case SortMode.Title:
-                    return string.Compare(BeatmapSet.Metadata.Title, otherSet.BeatmapSet.Metadata.Title, StringComparison.OrdinalIgnoreCase);
+                    return string.Compare(BeatmapSet.Metadata?.Title, otherSet.BeatmapSet.Metadata?.Title, StringComparison.OrdinalIgnoreCase);
 
                 case SortMode.Author:
-                    return string.Compare(BeatmapSet.Metadata.Author.Username, otherSet.BeatmapSet.Metadata.Author.Username, StringComparison.OrdinalIgnoreCase);
+                    return string.Compare(BeatmapSet.Metadata?.Author.Username, otherSet.BeatmapSet.Metadata?.Author.Username, StringComparison.OrdinalIgnoreCase);
 
                 case SortMode.Source:
-                    return string.Compare(BeatmapSet.Metadata.Source, otherSet.BeatmapSet.Metadata.Source, StringComparison.OrdinalIgnoreCase);
+                    return string.Compare(BeatmapSet.Metadata?.Source, otherSet.BeatmapSet.Metadata?.Source, StringComparison.OrdinalIgnoreCase);
 
                 case SortMode.DateAdded:
                     return otherSet.BeatmapSet.DateAdded.CompareTo(BeatmapSet.DateAdded);
diff --git a/osu.Game/Screens/Select/Carousel/SetPanelContent.cs b/osu.Game/Screens/Select/Carousel/SetPanelContent.cs
index f2054677b0..9aa85c872e 100644
--- a/osu.Game/Screens/Select/Carousel/SetPanelContent.cs
+++ b/osu.Game/Screens/Select/Carousel/SetPanelContent.cs
@@ -41,13 +41,13 @@ namespace osu.Game.Screens.Select.Carousel
                 {
                     new OsuSpriteText
                     {
-                        Text = new RomanisableString(beatmapSet.Metadata.TitleUnicode, beatmapSet.Metadata.Title),
+                        Text = new RomanisableString(beatmapSet.Metadata?.TitleUnicode, beatmapSet.Metadata?.Title),
                         Font = OsuFont.GetFont(weight: FontWeight.Bold, size: 22, italics: true),
                         Shadow = true,
                     },
                     new OsuSpriteText
                     {
-                        Text = new RomanisableString(beatmapSet.Metadata.ArtistUnicode, beatmapSet.Metadata.Artist),
+                        Text = new RomanisableString(beatmapSet.Metadata?.ArtistUnicode, beatmapSet.Metadata?.Artist),
                         Font = OsuFont.GetFont(weight: FontWeight.SemiBold, size: 17, italics: true),
                         Shadow = true,
                     },
diff --git a/osu.Game/Screens/Select/FilterControl.cs b/osu.Game/Screens/Select/FilterControl.cs
index e95bd7f653..e54b25873b 100644
--- a/osu.Game/Screens/Select/FilterControl.cs
+++ b/osu.Game/Screens/Select/FilterControl.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.Bindables;
 using osu.Framework.Graphics;
@@ -37,8 +36,6 @@ namespace osu.Game.Screens.Select
 
         public FilterCriteria CreateCriteria()
         {
-            Debug.Assert(ruleset.Value.ID != null);
-
             string query = searchTextBox.Text;
 
             var criteria = new FilterCriteria
@@ -56,7 +53,7 @@ namespace osu.Game.Screens.Select
             if (!maximumStars.IsDefault)
                 criteria.UserStarDifficulty.Max = maximumStars.Value;
 
-            criteria.RulesetCriteria = ruleset.Value.CreateInstance().CreateRulesetFilterCriteria();
+            criteria.RulesetCriteria = ruleset.Value.CreateInstance()?.CreateRulesetFilterCriteria();
 
             FilterQueryParser.ApplyQueries(criteria, query);
             return criteria;
diff --git a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
index 0102986070..3b25d34aec 100644
--- a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
+++ b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
@@ -33,7 +33,7 @@ namespace osu.Game.Screens.Select.Leaderboards
             get => beatmapInfo;
             set
             {
-                if (beatmapInfo == value)
+                if (beatmapInfo.Equals(value))
                     return;
 
                 beatmapInfo = value;
@@ -154,7 +154,7 @@ namespace osu.Game.Screens.Select.Leaderboards
                 return null;
             }
 
-            if (fetchBeatmapInfo.OnlineID == null || fetchBeatmapInfo.Status <= BeatmapOnlineStatus.Pending)
+            if (fetchBeatmapInfo.OnlineID <= 0 || fetchBeatmapInfo.Status <= BeatmapOnlineStatus.Pending)
             {
                 PlaceholderState = PlaceholderState.Unavailable;
                 return null;
diff --git a/osu.Game/Screens/Select/SongSelect.cs b/osu.Game/Screens/Select/SongSelect.cs
index 08ad9f2ec0..a40e8e2bde 100644
--- a/osu.Game/Screens/Select/SongSelect.cs
+++ b/osu.Game/Screens/Select/SongSelect.cs
@@ -482,7 +482,7 @@ namespace osu.Game.Screens.Select
             else
                 selectionChangedDebounce = Scheduler.AddDelayed(run, 200);
 
-            if (beatmap != beatmapInfoPrevious)
+            if (!beatmap.Equals(beatmapInfoPrevious))
             {
                 if (beatmap != null && beatmapInfoPrevious != null && Time.Current - audioFeedbackLastPlaybackTime >= 50)
                 {
diff --git a/osu.Game/Tests/Beatmaps/HitObjectSampleTest.cs b/osu.Game/Tests/Beatmaps/HitObjectSampleTest.cs
index 27d1de83ec..4e955975a0 100644
--- a/osu.Game/Tests/Beatmaps/HitObjectSampleTest.cs
+++ b/osu.Game/Tests/Beatmaps/HitObjectSampleTest.cs
@@ -3,6 +3,7 @@
 
 using System;
 using System.Collections.Generic;
+using System.Diagnostics;
 using System.IO;
 using System.Linq;
 using System.Threading;
@@ -78,7 +79,11 @@ namespace osu.Game.Tests.Beatmaps
                         currentTestBeatmap = Decoder.GetDecoder<Beatmap>(reader).Decode(reader);
 
                     // populate ruleset for beatmap converters that require it to be present.
-                    currentTestBeatmap.BeatmapInfo.Ruleset = rulesetStore.GetRuleset(currentTestBeatmap.BeatmapInfo.RulesetID);
+                    var ruleset = rulesetStore.GetRuleset(currentTestBeatmap.BeatmapInfo.RulesetID);
+
+                    Debug.Assert(ruleset != null);
+
+                    currentTestBeatmap.BeatmapInfo.Ruleset = ruleset;
                 });
             });
 
@@ -94,11 +99,7 @@ namespace osu.Game.Tests.Beatmaps
                 userSkinInfo.Files.Add(new RealmNamedFileUsage(new RealmFile { Hash = userFile }, userFile));
 
                 beatmapInfo.BeatmapSet.Files.Clear();
-                beatmapInfo.BeatmapSet.Files.Add(new BeatmapSetFileInfo
-                {
-                    Filename = beatmapFile,
-                    FileInfo = new IO.FileInfo { Hash = beatmapFile }
-                });
+                beatmapInfo.BeatmapSet.Files.Add(new RealmNamedFileUsage(new RealmFile { Hash = beatmapFile }, beatmapFile));
 
                 // Need to refresh the cached skin source to refresh the skin resource store.
                 dependencies.SkinSource = new SkinProvidingContainer(Skin = new LegacySkin(userSkinInfo, this));
diff --git a/osu.Game/Tests/Visual/EditorTestScene.cs b/osu.Game/Tests/Visual/EditorTestScene.cs
index 07152b5a3e..a2f567f3b0 100644
--- a/osu.Game/Tests/Visual/EditorTestScene.cs
+++ b/osu.Game/Tests/Visual/EditorTestScene.cs
@@ -116,7 +116,7 @@ namespace osu.Game.Tests.Visual
         {
             private readonly WorkingBeatmap testBeatmap;
 
-            public TestBeatmapManager(Storage storage, IDatabaseContextFactory contextFactory, RulesetStore rulesets, IAPIProvider api, [NotNull] AudioManager audioManager, IResourceStore<byte[]> resources, GameHost host, WorkingBeatmap defaultBeatmap, WorkingBeatmap testBeatmap)
+            public TestBeatmapManager(Storage storage, RealmContextFactory contextFactory, RulesetStore rulesets, IAPIProvider api, [NotNull] AudioManager audioManager, IResourceStore<byte[]> resources, GameHost host, WorkingBeatmap defaultBeatmap, WorkingBeatmap testBeatmap)
                 : base(storage, contextFactory, rulesets, api, audioManager, resources, host, defaultBeatmap)
             {
                 this.testBeatmap = testBeatmap;

From 8c0db79ec1803485d74849e18551e4c06d4ee21f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 8 Dec 2021 15:59:04 +0900
Subject: [PATCH 2013/5547] Remove `BeatmapStore` and update surrounding code

---
 osu.Game/Beatmaps/BeatmapModelManager.cs |  17 ++--
 osu.Game/Beatmaps/BeatmapStore.cs        | 117 -----------------------
 2 files changed, 8 insertions(+), 126 deletions(-)
 delete mode 100644 osu.Game/Beatmaps/BeatmapStore.cs

diff --git a/osu.Game/Beatmaps/BeatmapModelManager.cs b/osu.Game/Beatmaps/BeatmapModelManager.cs
index b909175d2d..f6f2e16410 100644
--- a/osu.Game/Beatmaps/BeatmapModelManager.cs
+++ b/osu.Game/Beatmaps/BeatmapModelManager.cs
@@ -25,6 +25,7 @@ using osu.Game.Rulesets;
 using osu.Game.Rulesets.Objects;
 using osu.Game.Skinning;
 using osu.Game.Stores;
+using Realms;
 using Decoder = osu.Game.Beatmaps.Formats.Decoder;
 
 namespace osu.Game.Beatmaps
@@ -59,24 +60,22 @@ namespace osu.Game.Beatmaps
 
         protected override string[] HashableFileTypes => new[] { ".osu" };
 
-        private readonly BeatmapStore beatmaps;
         private readonly RulesetStore rulesets;
 
-        public BeatmapModelManager(Storage storage, IDatabaseContextFactory contextFactory, RulesetStore rulesets, GameHost host = null)
-            : base(storage, contextFactory, new BeatmapStore(contextFactory), host)
+        public BeatmapModelManager(Storage storage, RealmContextFactory contextFactory, RulesetStore rulesets, GameHost host = null)
+            : base(storage, contextFactory)
         {
             this.rulesets = rulesets;
 
-            beatmaps = (BeatmapStore)ModelStore;
-            beatmaps.BeatmapHidden += b => BeatmapHidden?.Invoke(b);
-            beatmaps.BeatmapRestored += b => BeatmapRestored?.Invoke(b);
-            beatmaps.ItemRemoved += b => WorkingBeatmapCache?.Invalidate(b);
-            beatmaps.ItemUpdated += obj => WorkingBeatmapCache?.Invalidate(obj);
+            // beatmaps.BeatmapHidden += b => BeatmapHidden?.Invoke(b);
+            // beatmaps.BeatmapRestored += b => BeatmapRestored?.Invoke(b);
+            // beatmaps.ItemRemoved += b => WorkingBeatmapCache?.Invalidate(b);
+            // beatmaps.ItemUpdated += obj => WorkingBeatmapCache?.Invalidate(obj);
         }
 
         protected override bool ShouldDeleteArchive(string path) => Path.GetExtension(path)?.ToLowerInvariant() == ".osz";
 
-        protected override async Task Populate(BeatmapSetInfo beatmapSet, ArchiveReader archive, CancellationToken cancellationToken = default)
+        protected override async Task Populate(BeatmapSetInfo beatmapSet, ArchiveReader? archive, Realm realm, CancellationToken cancellationToken)
         {
             if (archive != null)
                 beatmapSet.Beatmaps.AddRange(createBeatmapDifficulties(beatmapSet.Files));
diff --git a/osu.Game/Beatmaps/BeatmapStore.cs b/osu.Game/Beatmaps/BeatmapStore.cs
deleted file mode 100644
index 197581db88..0000000000
--- a/osu.Game/Beatmaps/BeatmapStore.cs
+++ /dev/null
@@ -1,117 +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 Microsoft.EntityFrameworkCore;
-using osu.Game.Database;
-
-namespace osu.Game.Beatmaps
-{
-    /// <summary>
-    /// Handles the storage and retrieval of Beatmaps/BeatmapSets to the database backing
-    /// </summary>
-    public class BeatmapStore : MutableDatabaseBackedStoreWithFileIncludes<BeatmapSetInfo, BeatmapSetFileInfo>
-    {
-        public event Action<BeatmapInfo> BeatmapHidden;
-        public event Action<BeatmapInfo> BeatmapRestored;
-
-        public BeatmapStore(IDatabaseContextFactory factory)
-            : base(factory)
-        {
-        }
-
-        /// <summary>
-        /// Hide a <see cref="BeatmapInfo"/> in the database.
-        /// </summary>
-        /// <param name="beatmapInfo">The beatmap to hide.</param>
-        /// <returns>Whether the beatmap's <see cref="BeatmapInfo.Hidden"/> was changed.</returns>
-        public bool Hide(BeatmapInfo beatmapInfo)
-        {
-            using (ContextFactory.GetForWrite())
-            {
-                Refresh(ref beatmapInfo, Beatmaps);
-
-                if (beatmapInfo.Hidden) return false;
-
-                beatmapInfo.Hidden = true;
-            }
-
-            BeatmapHidden?.Invoke(beatmapInfo);
-            return true;
-        }
-
-        /// <summary>
-        /// Restore a previously hidden <see cref="BeatmapInfo"/>.
-        /// </summary>
-        /// <param name="beatmapInfo">The beatmap to restore.</param>
-        /// <returns>Whether the beatmap's <see cref="BeatmapInfo.Hidden"/> was changed.</returns>
-        public bool Restore(BeatmapInfo beatmapInfo)
-        {
-            using (ContextFactory.GetForWrite())
-            {
-                Refresh(ref beatmapInfo, Beatmaps);
-
-                if (!beatmapInfo.Hidden) return false;
-
-                beatmapInfo.Hidden = false;
-            }
-
-            BeatmapRestored?.Invoke(beatmapInfo);
-            return true;
-        }
-
-        protected override IQueryable<BeatmapSetInfo> AddIncludesForDeletion(IQueryable<BeatmapSetInfo> query) =>
-            base.AddIncludesForDeletion(query)
-                .Include(s => s.Metadata)
-                .Include(s => s.Beatmaps).ThenInclude(b => b.BaseDifficulty)
-                .Include(s => s.Beatmaps).ThenInclude(b => b.Metadata);
-
-        protected override IQueryable<BeatmapSetInfo> AddIncludesForConsumption(IQueryable<BeatmapSetInfo> query) =>
-            base.AddIncludesForConsumption(query)
-                .Include(s => s.Metadata)
-                .Include(s => s.Beatmaps).ThenInclude(s => s.Ruleset)
-                .Include(s => s.Beatmaps).ThenInclude(b => b.BaseDifficulty)
-                .Include(s => s.Beatmaps).ThenInclude(b => b.Metadata);
-
-        protected override void Purge(List<BeatmapSetInfo> items, OsuDbContext context)
-        {
-            // metadata is M-N so we can't rely on cascades
-            context.BeatmapMetadata.RemoveRange(items.Select(s => s.Metadata));
-            context.BeatmapMetadata.RemoveRange(items.SelectMany(s => s.Beatmaps.Select(b => b.Metadata).Where(m => m != null)));
-
-            // todo: we can probably make cascades work here with a FK in BeatmapDifficulty. just make to make it work correctly.
-            context.BeatmapDifficulty.RemoveRange(items.SelectMany(s => s.Beatmaps.Select(b => b.BaseDifficulty)));
-
-            base.Purge(items, context);
-        }
-
-        public IQueryable<BeatmapSetInfo> BeatmapSetsOverview => ContextFactory.Get().BeatmapSetInfo
-                                                                               .Include(s => s.Metadata)
-                                                                               .Include(s => s.Beatmaps)
-                                                                               .AsNoTracking();
-
-        public IQueryable<BeatmapSetInfo> BeatmapSetsWithoutRuleset => ContextFactory.Get().BeatmapSetInfo
-                                                                                     .Include(s => s.Metadata)
-                                                                                     .Include(s => s.Files).ThenInclude(f => f.FileInfo)
-                                                                                     .Include(s => s.Beatmaps).ThenInclude(b => b.BaseDifficulty)
-                                                                                     .Include(s => s.Beatmaps).ThenInclude(b => b.Metadata)
-                                                                                     .AsNoTracking();
-
-        public IQueryable<BeatmapSetInfo> BeatmapSetsWithoutFiles => ContextFactory.Get().BeatmapSetInfo
-                                                                                   .Include(s => s.Metadata)
-                                                                                   .Include(s => s.Beatmaps).ThenInclude(s => s.Ruleset)
-                                                                                   .Include(s => s.Beatmaps).ThenInclude(b => b.BaseDifficulty)
-                                                                                   .Include(s => s.Beatmaps).ThenInclude(b => b.Metadata)
-                                                                                   .AsNoTracking();
-
-        public IQueryable<BeatmapInfo> Beatmaps =>
-            ContextFactory.Get().BeatmapInfo
-                          .Include(b => b.BeatmapSet).ThenInclude(s => s.Metadata)
-                          .Include(b => b.BeatmapSet).ThenInclude(s => s.Files).ThenInclude(f => f.FileInfo)
-                          .Include(b => b.Metadata)
-                          .Include(b => b.Ruleset)
-                          .Include(b => b.BaseDifficulty);
-    }
-}

From 0dd23c46b04caebae04a115ce6c7f1591ae21e6f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 11 Nov 2021 23:18:37 +0900
Subject: [PATCH 2014/5547] Add basic `RealmScore` implementation

---
 osu.Game/Models/RealmScore.cs | 68 +++++++++++++++++++++++++++++++++++
 1 file changed, 68 insertions(+)
 create mode 100644 osu.Game/Models/RealmScore.cs

diff --git a/osu.Game/Models/RealmScore.cs b/osu.Game/Models/RealmScore.cs
new file mode 100644
index 0000000000..323bd2393c
--- /dev/null
+++ b/osu.Game/Models/RealmScore.cs
@@ -0,0 +1,68 @@
+// 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.Testing;
+using osu.Game.Beatmaps;
+using osu.Game.Database;
+using osu.Game.Rulesets;
+using osu.Game.Scoring;
+using osu.Game.Users;
+using Realms;
+
+#nullable enable
+
+namespace osu.Game.Models
+{
+    [ExcludeFromDynamicCompile]
+    [MapTo("Score")]
+    public class RealmScore : RealmObject, IHasGuidPrimaryKey, IHasRealmFiles, ISoftDelete, IEquatable<RealmScore>, IScoreInfo
+    {
+        [PrimaryKey]
+        public Guid ID { get; set; } = Guid.NewGuid();
+
+        public IList<RealmNamedFileUsage> Files { get; } = null!;
+
+        public string Hash { get; set; } = string.Empty;
+
+        public bool DeletePending { get; set; }
+
+        public bool Equals(RealmScore other) => other.ID == ID;
+
+        [Indexed]
+        public long OnlineID { get; set; } = -1;
+
+        public RealmUser User { get; set; } = null!;
+
+        public long TotalScore { get; set; }
+
+        public int MaxCombo { get; set; }
+
+        public double Accuracy { get; set; }
+
+        public bool HasReplay { get; set; }
+
+        public DateTimeOffset Date { get; set; }
+
+        public double? PP { get; set; } = null;
+
+        public RealmBeatmap Beatmap { get; set; } = null!;
+
+        public RealmRuleset Ruleset { get; set; } = null!;
+
+        public ScoreRank Rank
+        {
+            get => (ScoreRank)RankInt;
+            set => RankInt = (int)value;
+        }
+
+        [MapTo(nameof(Rank))]
+        public int RankInt { get; set; }
+
+        IRulesetInfo IScoreInfo.Ruleset => Ruleset;
+        IBeatmapInfo IScoreInfo.Beatmap => Beatmap;
+        IUser IScoreInfo.User => User;
+        IEnumerable<INamedFileUsage> IHasNamedFiles.Files => Files;
+    }
+}

From a5df01ff47af0d44af5852a462628e3dab998236 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 12 Nov 2021 13:07:11 +0900
Subject: [PATCH 2015/5547] Add score importer

---
 osu.Game/Beatmaps/IBeatmapSetOnlineInfo.cs |  2 +-
 osu.Game/Stores/ScoreImporter.cs           | 64 ++++++++++++++++++++++
 2 files changed, 65 insertions(+), 1 deletion(-)
 create mode 100644 osu.Game/Stores/ScoreImporter.cs

diff --git a/osu.Game/Beatmaps/IBeatmapSetOnlineInfo.cs b/osu.Game/Beatmaps/IBeatmapSetOnlineInfo.cs
index 0510770d5b..33d8929008 100644
--- a/osu.Game/Beatmaps/IBeatmapSetOnlineInfo.cs
+++ b/osu.Game/Beatmaps/IBeatmapSetOnlineInfo.cs
@@ -28,7 +28,7 @@ namespace osu.Game.Beatmaps
         DateTimeOffset? LastUpdated { get; }
 
         /// <summary>
-        /// The status of this beatmap set.
+        /// The "ranked" status of this beatmap set.
         /// </summary>
         BeatmapOnlineStatus Status { get; }
 
diff --git a/osu.Game/Stores/ScoreImporter.cs b/osu.Game/Stores/ScoreImporter.cs
new file mode 100644
index 0000000000..b30dd88fbe
--- /dev/null
+++ b/osu.Game/Stores/ScoreImporter.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;
+using System.Collections.Generic;
+using System.Linq;
+using System.Threading;
+using System.Threading.Tasks;
+using osu.Framework.Logging;
+using osu.Framework.Platform;
+using osu.Framework.Testing;
+using osu.Game.Beatmaps;
+using osu.Game.Database;
+using osu.Game.IO.Archives;
+using osu.Game.Models;
+using osu.Game.Scoring.Legacy;
+using Realms;
+
+#nullable enable
+
+namespace osu.Game.Stores
+{
+    /// <summary>
+    /// Handles the storage and retrieval of Scores/WorkingScores.
+    /// </summary>
+    [ExcludeFromDynamicCompile]
+    public class ScoreImporter : RealmArchiveModelImporter<RealmScore>
+    {
+        private readonly RealmRulesetStore rulesets;
+        private readonly BeatmapManager beatmaps;
+
+        public override IEnumerable<string> HandledExtensions => new[] { ".osr" };
+
+        protected override string[] HashableFileTypes => new[] { ".osr" };
+
+        public ScoreImporter(RealmRulesetStore rulesets, RealmContextFactory contextFactory, Storage storage, BeatmapManager beatmaps)
+            : base(storage, contextFactory)
+        {
+            this.rulesets = rulesets;
+            this.beatmaps = beatmaps;
+        }
+
+        protected override RealmScore? CreateModel(ArchiveReader archive)
+        {
+            using (var stream = archive.GetStream(archive.Filenames.First(f => f.EndsWith(".osr", StringComparison.OrdinalIgnoreCase))))
+            {
+                try
+                {
+                    // TODO: make work.
+                    // return new DatabasedLegacyScoreDecoder(rulesets, beatmaps).Parse(stream).ScoreInfo;
+                    return new RealmScore();
+                }
+                catch (LegacyScoreDecoder.BeatmapNotFoundException e)
+                {
+                    Logger.Log(e.Message, LoggingTarget.Information, LogLevel.Error);
+                    return null;
+                }
+            }
+        }
+
+        protected override Task Populate(RealmScore model, ArchiveReader? archive, Realm realm, CancellationToken cancellationToken = default)
+            => Task.CompletedTask;
+    }
+}

From c5e401d6788bf7219b5118186b1c4b866c956deb Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 3 Dec 2021 17:50:40 +0900
Subject: [PATCH 2016/5547] Update usages to consume `IRulesetStore`

---
 osu.Game/Scoring/Legacy/DatabasedLegacyScoreDecoder.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Scoring/Legacy/DatabasedLegacyScoreDecoder.cs b/osu.Game/Scoring/Legacy/DatabasedLegacyScoreDecoder.cs
index 9b590f56dd..a49eb89ecc 100644
--- a/osu.Game/Scoring/Legacy/DatabasedLegacyScoreDecoder.cs
+++ b/osu.Game/Scoring/Legacy/DatabasedLegacyScoreDecoder.cs
@@ -12,10 +12,10 @@ namespace osu.Game.Scoring.Legacy
     /// </summary>
     public class DatabasedLegacyScoreDecoder : LegacyScoreDecoder
     {
-        private readonly RulesetStore rulesets;
+        private readonly IRulesetStore rulesets;
         private readonly BeatmapManager beatmaps;
 
-        public DatabasedLegacyScoreDecoder(RulesetStore rulesets, BeatmapManager beatmaps)
+        public DatabasedLegacyScoreDecoder(IRulesetStore rulesets, BeatmapManager beatmaps)
         {
             this.rulesets = rulesets;
             this.beatmaps = beatmaps;

From 3da762e1457ac3631c1d6a4830b7c8fe8129692f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 6 Dec 2021 15:31:40 +0900
Subject: [PATCH 2017/5547] Replace EF `ScoreInfo` with realm version

May contain errors.
---
 osu.Game/Database/OsuDbContext.cs |   2 +-
 osu.Game/Models/RealmScore.cs     |  68 --------
 osu.Game/Scoring/EFScoreInfo.cs   | 265 ++++++++++++++++++++++++++++
 osu.Game/Scoring/ScoreInfo.cs     | 278 +++++-------------------------
 osu.Game/Stores/ScoreImporter.cs  |   9 +-
 5 files changed, 310 insertions(+), 312 deletions(-)
 delete mode 100644 osu.Game/Models/RealmScore.cs
 create mode 100644 osu.Game/Scoring/EFScoreInfo.cs

diff --git a/osu.Game/Database/OsuDbContext.cs b/osu.Game/Database/OsuDbContext.cs
index 9f0bae4a66..fb83592c01 100644
--- a/osu.Game/Database/OsuDbContext.cs
+++ b/osu.Game/Database/OsuDbContext.cs
@@ -26,7 +26,7 @@ namespace osu.Game.Database
         public DbSet<FileInfo> FileInfo { get; set; }
         public DbSet<EFRulesetInfo> RulesetInfo { get; set; }
         public DbSet<EFSkinInfo> SkinInfo { get; set; }
-        public DbSet<ScoreInfo> ScoreInfo { get; set; }
+        public DbSet<EFScoreInfo> ScoreInfo { get; set; }
 
         // migrated to realm
         public DbSet<DatabasedSetting> DatabasedSetting { get; set; }
diff --git a/osu.Game/Models/RealmScore.cs b/osu.Game/Models/RealmScore.cs
deleted file mode 100644
index 323bd2393c..0000000000
--- a/osu.Game/Models/RealmScore.cs
+++ /dev/null
@@ -1,68 +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 osu.Framework.Testing;
-using osu.Game.Beatmaps;
-using osu.Game.Database;
-using osu.Game.Rulesets;
-using osu.Game.Scoring;
-using osu.Game.Users;
-using Realms;
-
-#nullable enable
-
-namespace osu.Game.Models
-{
-    [ExcludeFromDynamicCompile]
-    [MapTo("Score")]
-    public class RealmScore : RealmObject, IHasGuidPrimaryKey, IHasRealmFiles, ISoftDelete, IEquatable<RealmScore>, IScoreInfo
-    {
-        [PrimaryKey]
-        public Guid ID { get; set; } = Guid.NewGuid();
-
-        public IList<RealmNamedFileUsage> Files { get; } = null!;
-
-        public string Hash { get; set; } = string.Empty;
-
-        public bool DeletePending { get; set; }
-
-        public bool Equals(RealmScore other) => other.ID == ID;
-
-        [Indexed]
-        public long OnlineID { get; set; } = -1;
-
-        public RealmUser User { get; set; } = null!;
-
-        public long TotalScore { get; set; }
-
-        public int MaxCombo { get; set; }
-
-        public double Accuracy { get; set; }
-
-        public bool HasReplay { get; set; }
-
-        public DateTimeOffset Date { get; set; }
-
-        public double? PP { get; set; } = null;
-
-        public RealmBeatmap Beatmap { get; set; } = null!;
-
-        public RealmRuleset Ruleset { get; set; } = null!;
-
-        public ScoreRank Rank
-        {
-            get => (ScoreRank)RankInt;
-            set => RankInt = (int)value;
-        }
-
-        [MapTo(nameof(Rank))]
-        public int RankInt { get; set; }
-
-        IRulesetInfo IScoreInfo.Ruleset => Ruleset;
-        IBeatmapInfo IScoreInfo.Beatmap => Beatmap;
-        IUser IScoreInfo.User => User;
-        IEnumerable<INamedFileUsage> IHasNamedFiles.Files => Files;
-    }
-}
diff --git a/osu.Game/Scoring/EFScoreInfo.cs b/osu.Game/Scoring/EFScoreInfo.cs
new file mode 100644
index 0000000000..e23662f74d
--- /dev/null
+++ b/osu.Game/Scoring/EFScoreInfo.cs
@@ -0,0 +1,265 @@
+// 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.ComponentModel.DataAnnotations.Schema;
+using System.Linq;
+using Newtonsoft.Json;
+using osu.Framework.Localisation;
+using osu.Game.Beatmaps;
+using osu.Game.Database;
+using osu.Game.Online.API;
+using osu.Game.Online.API.Requests.Responses;
+using osu.Game.Rulesets;
+using osu.Game.Rulesets.Mods;
+using osu.Game.Rulesets.Scoring;
+using osu.Game.Users;
+using osu.Game.Utils;
+
+namespace osu.Game.Scoring
+{
+    public class EFScoreInfo : IScoreInfo, IHasFiles<ScoreFileInfo>, IHasPrimaryKey, ISoftDelete, IEquatable<EFScoreInfo>, IDeepCloneable<EFScoreInfo>
+    {
+        public int ID { get; set; }
+
+        public ScoreRank Rank { get; set; }
+
+        public long TotalScore { get; set; }
+
+        [Column(TypeName = "DECIMAL(1,4)")] // TODO: This data type is wrong (should contain more precision). But at the same time, we probably don't need to be storing this in the database.
+        public double Accuracy { get; set; }
+
+        public LocalisableString DisplayAccuracy => Accuracy.FormatAccuracy();
+
+        public double? PP { get; set; }
+
+        public int MaxCombo { get; set; }
+
+        public int Combo { get; set; } // Todo: Shouldn't exist in here
+
+        public int RulesetID { get; set; }
+
+        [NotMapped]
+        public bool Passed { get; set; } = true;
+
+        public RulesetInfo Ruleset { get; set; }
+
+        private APIMod[] localAPIMods;
+
+        private Mod[] mods;
+
+        [NotMapped]
+        public Mod[] Mods
+        {
+            get
+            {
+                var rulesetInstance = Ruleset?.CreateInstance();
+                if (rulesetInstance == null)
+                    return mods ?? Array.Empty<Mod>();
+
+                Mod[] scoreMods = Array.Empty<Mod>();
+
+                if (mods != null)
+                    scoreMods = mods;
+                else if (localAPIMods != null)
+                    scoreMods = APIMods.Select(m => m.ToMod(rulesetInstance)).ToArray();
+
+                return scoreMods;
+            }
+            set
+            {
+                localAPIMods = null;
+                mods = value;
+            }
+        }
+
+        // Used for API serialisation/deserialisation.
+        [NotMapped]
+        public APIMod[] APIMods
+        {
+            get
+            {
+                if (localAPIMods != null)
+                    return localAPIMods;
+
+                if (mods == null)
+                    return Array.Empty<APIMod>();
+
+                return localAPIMods = mods.Select(m => new APIMod(m)).ToArray();
+            }
+            set
+            {
+                localAPIMods = value;
+
+                // We potentially can't update this yet due to Ruleset being late-bound, so instead update on read as necessary.
+                mods = null;
+            }
+        }
+
+        // Used for database serialisation/deserialisation.
+        [Column("Mods")]
+        public string ModsJson
+        {
+            get => JsonConvert.SerializeObject(APIMods);
+            set => APIMods = JsonConvert.DeserializeObject<APIMod[]>(value);
+        }
+
+        [NotMapped]
+        public APIUser User { get; set; }
+
+        [Column("User")]
+        public string UserString
+        {
+            get => User?.Username;
+            set
+            {
+                User ??= new APIUser();
+                User.Username = value;
+            }
+        }
+
+        [Column("UserID")]
+        public int? UserID
+        {
+            get => User?.Id ?? 1;
+            set
+            {
+                User ??= new APIUser();
+                User.Id = value ?? 1;
+            }
+        }
+
+        public int BeatmapInfoID { get; set; }
+
+        [Column("Beatmap")]
+        public BeatmapInfo BeatmapInfo { get; set; }
+
+        public long? OnlineScoreID { get; set; }
+
+        public DateTimeOffset Date { get; set; }
+
+        [NotMapped]
+        public Dictionary<HitResult, int> Statistics { get; set; } = new Dictionary<HitResult, int>();
+
+        [Column("Statistics")]
+        public string StatisticsJson
+        {
+            get => JsonConvert.SerializeObject(Statistics);
+            set
+            {
+                if (value == null)
+                {
+                    Statistics.Clear();
+                    return;
+                }
+
+                Statistics = JsonConvert.DeserializeObject<Dictionary<HitResult, int>>(value);
+            }
+        }
+
+        [NotMapped]
+        public List<HitEvent> HitEvents { get; set; }
+
+        public List<ScoreFileInfo> Files { get; } = new List<ScoreFileInfo>();
+
+        public string Hash { get; set; }
+
+        public bool DeletePending { get; set; }
+
+        /// <summary>
+        /// The position of this score, starting at 1.
+        /// </summary>
+        [NotMapped]
+        public int? Position { get; set; } // TODO: remove after all calls to `CreateScoreInfo` are gone.
+
+        /// <summary>
+        /// Whether this <see cref="EFScoreInfo"/> represents a legacy (osu!stable) score.
+        /// </summary>
+        [NotMapped]
+        public bool IsLegacyScore => Mods.OfType<ModClassic>().Any();
+
+        public IEnumerable<HitResultDisplayStatistic> GetStatisticsForDisplay()
+        {
+            foreach (var r in Ruleset.CreateInstance().GetHitResults())
+            {
+                int value = Statistics.GetValueOrDefault(r.result);
+
+                switch (r.result)
+                {
+                    case HitResult.SmallTickHit:
+                    {
+                        int total = value + Statistics.GetValueOrDefault(HitResult.SmallTickMiss);
+                        if (total > 0)
+                            yield return new HitResultDisplayStatistic(r.result, value, total, r.displayName);
+
+                        break;
+                    }
+
+                    case HitResult.LargeTickHit:
+                    {
+                        int total = value + Statistics.GetValueOrDefault(HitResult.LargeTickMiss);
+                        if (total > 0)
+                            yield return new HitResultDisplayStatistic(r.result, value, total, r.displayName);
+
+                        break;
+                    }
+
+                    case HitResult.SmallTickMiss:
+                    case HitResult.LargeTickMiss:
+                        break;
+
+                    default:
+                        yield return new HitResultDisplayStatistic(r.result, value, null, r.displayName);
+
+                        break;
+                }
+            }
+        }
+
+        public EFScoreInfo DeepClone()
+        {
+            var clone = (EFScoreInfo)MemberwiseClone();
+
+            clone.Statistics = new Dictionary<HitResult, int>(clone.Statistics);
+
+            return clone;
+        }
+
+        public override string ToString() => this.GetDisplayTitle();
+
+        public bool Equals(EFScoreInfo other)
+        {
+            if (other == null)
+                return false;
+
+            if (ID != 0 && other.ID != 0)
+                return ID == other.ID;
+
+            if (OnlineScoreID.HasValue && other.OnlineScoreID.HasValue)
+                return OnlineScoreID == other.OnlineScoreID;
+
+            if (!string.IsNullOrEmpty(Hash) && !string.IsNullOrEmpty(other.Hash))
+                return Hash == other.Hash;
+
+            return ReferenceEquals(this, other);
+        }
+
+        #region Implementation of IHasOnlineID
+
+        public long OnlineID => OnlineScoreID ?? -1;
+
+        #endregion
+
+        #region Implementation of IScoreInfo
+
+        IBeatmapInfo IScoreInfo.Beatmap => BeatmapInfo;
+        IRulesetInfo IScoreInfo.Ruleset => Ruleset;
+        IUser IScoreInfo.User => User;
+        bool IScoreInfo.HasReplay => Files.Any();
+
+        #endregion
+
+        IEnumerable<INamedFileUsage> IHasNamedFiles.Files => Files;
+    }
+}
diff --git a/osu.Game/Scoring/ScoreInfo.cs b/osu.Game/Scoring/ScoreInfo.cs
index 7acc7bd055..0c097d1294 100644
--- a/osu.Game/Scoring/ScoreInfo.cs
+++ b/osu.Game/Scoring/ScoreInfo.cs
@@ -3,266 +3,66 @@
 
 using System;
 using System.Collections.Generic;
-using System.ComponentModel.DataAnnotations.Schema;
-using System.Linq;
-using Newtonsoft.Json;
-using osu.Framework.Localisation;
+using osu.Framework.Testing;
 using osu.Game.Beatmaps;
 using osu.Game.Database;
-using osu.Game.Online.API;
-using osu.Game.Online.API.Requests.Responses;
+using osu.Game.Models;
 using osu.Game.Rulesets;
-using osu.Game.Rulesets.Mods;
-using osu.Game.Rulesets.Scoring;
 using osu.Game.Users;
-using osu.Game.Utils;
+using Realms;
+
+#nullable enable
 
 namespace osu.Game.Scoring
 {
-    public class ScoreInfo : IScoreInfo, IHasFiles<ScoreFileInfo>, IHasPrimaryKey, ISoftDelete, IEquatable<ScoreInfo>, IDeepCloneable<ScoreInfo>
+    [ExcludeFromDynamicCompile]
+    [MapTo("Score")]
+    public class ScoreInfo : RealmObject, IHasGuidPrimaryKey, IHasRealmFiles, ISoftDelete, IEquatable<ScoreInfo>, IScoreInfo
     {
-        public int ID { get; set; }
+        [PrimaryKey]
+        public Guid ID { get; set; } = Guid.NewGuid();
 
-        public bool IsManaged => ID > 0;
+        public IList<RealmNamedFileUsage> Files { get; } = null!;
 
-        public ScoreRank Rank { get; set; }
-
-        public long TotalScore { get; set; }
-
-        [Column(TypeName = "DECIMAL(1,4)")] // TODO: This data type is wrong (should contain more precision). But at the same time, we probably don't need to be storing this in the database.
-        public double Accuracy { get; set; }
-
-        public LocalisableString DisplayAccuracy => Accuracy.FormatAccuracy();
-
-        public double? PP { get; set; }
-
-        public int MaxCombo { get; set; }
-
-        public int Combo { get; set; } // Todo: Shouldn't exist in here
-
-        public int RulesetID { get; set; }
-
-        [NotMapped]
-        public bool Passed { get; set; } = true;
-
-        public RulesetInfo Ruleset { get; set; }
-
-        private APIMod[] localAPIMods;
-
-        private Mod[] mods;
-
-        [NotMapped]
-        public Mod[] Mods
-        {
-            get
-            {
-                var rulesetInstance = Ruleset?.CreateInstance();
-                if (rulesetInstance == null)
-                    return mods ?? Array.Empty<Mod>();
-
-                Mod[] scoreMods = Array.Empty<Mod>();
-
-                if (mods != null)
-                    scoreMods = mods;
-                else if (localAPIMods != null)
-                    scoreMods = APIMods.Select(m => m.ToMod(rulesetInstance)).ToArray();
-
-                return scoreMods;
-            }
-            set
-            {
-                localAPIMods = null;
-                mods = value;
-            }
-        }
-
-        // Used for API serialisation/deserialisation.
-        [NotMapped]
-        public APIMod[] APIMods
-        {
-            get
-            {
-                if (localAPIMods != null)
-                    return localAPIMods;
-
-                if (mods == null)
-                    return Array.Empty<APIMod>();
-
-                return localAPIMods = mods.Select(m => new APIMod(m)).ToArray();
-            }
-            set
-            {
-                localAPIMods = value;
-
-                // We potentially can't update this yet due to Ruleset being late-bound, so instead update on read as necessary.
-                mods = null;
-            }
-        }
-
-        // Used for database serialisation/deserialisation.
-        [Column("Mods")]
-        public string ModsJson
-        {
-            get => JsonConvert.SerializeObject(APIMods);
-            set => APIMods = JsonConvert.DeserializeObject<APIMod[]>(value);
-        }
-
-        [NotMapped]
-        public APIUser User { get; set; }
-
-        [Column("User")]
-        public string UserString
-        {
-            get => User?.Username;
-            set
-            {
-                User ??= new APIUser();
-                User.Username = value;
-            }
-        }
-
-        [Column("UserID")]
-        public int? UserID
-        {
-            get => User?.Id ?? 1;
-            set
-            {
-                User ??= new APIUser();
-                User.Id = value ?? 1;
-            }
-        }
-
-        public int BeatmapInfoID { get; set; }
-
-        [Column("Beatmap")]
-        public BeatmapInfo BeatmapInfo { get; set; }
-
-        private long? onlineID;
-
-        [Column("OnlineScoreID")]
-        public long? OnlineID
-        {
-            get => onlineID;
-            set => onlineID = value > 0 ? value : null;
-        }
-
-        public DateTimeOffset Date { get; set; }
-
-        [NotMapped]
-        public Dictionary<HitResult, int> Statistics { get; set; } = new Dictionary<HitResult, int>();
-
-        [Column("Statistics")]
-        public string StatisticsJson
-        {
-            get => JsonConvert.SerializeObject(Statistics);
-            set
-            {
-                if (value == null)
-                {
-                    Statistics.Clear();
-                    return;
-                }
-
-                Statistics = JsonConvert.DeserializeObject<Dictionary<HitResult, int>>(value);
-            }
-        }
-
-        [NotMapped]
-        public List<HitEvent> HitEvents { get; set; }
-
-        public List<ScoreFileInfo> Files { get; } = new List<ScoreFileInfo>();
-
-        public string Hash { get; set; }
+        public string Hash { get; set; } = string.Empty;
 
         public bool DeletePending { get; set; }
 
-        /// <summary>
-        /// The position of this score, starting at 1.
-        /// </summary>
-        [NotMapped]
-        public int? Position { get; set; } // TODO: remove after all calls to `CreateScoreInfo` are gone.
+        public bool Equals(ScoreInfo other) => other.ID == ID;
 
-        /// <summary>
-        /// Whether this <see cref="ScoreInfo"/> represents a legacy (osu!stable) score.
-        /// </summary>
-        [NotMapped]
-        public bool IsLegacyScore => Mods.OfType<ModClassic>().Any();
+        [Indexed]
+        public long OnlineID { get; set; } = -1;
 
-        public IEnumerable<HitResultDisplayStatistic> GetStatisticsForDisplay()
+        public RealmUser User { get; set; } = null!;
+
+        public long TotalScore { get; set; }
+
+        public int MaxCombo { get; set; }
+
+        public double Accuracy { get; set; }
+
+        public bool HasReplay { get; set; }
+
+        public DateTimeOffset Date { get; set; }
+
+        public double? PP { get; set; }
+
+        public RealmBeatmap Beatmap { get; set; } = null!;
+
+        public RealmRuleset Ruleset { get; set; } = null!;
+
+        public ScoreRank Rank
         {
-            foreach (var r in Ruleset.CreateInstance().GetHitResults())
-            {
-                int value = Statistics.GetValueOrDefault(r.result);
-
-                switch (r.result)
-                {
-                    case HitResult.SmallTickHit:
-                    {
-                        int total = value + Statistics.GetValueOrDefault(HitResult.SmallTickMiss);
-                        if (total > 0)
-                            yield return new HitResultDisplayStatistic(r.result, value, total, r.displayName);
-
-                        break;
-                    }
-
-                    case HitResult.LargeTickHit:
-                    {
-                        int total = value + Statistics.GetValueOrDefault(HitResult.LargeTickMiss);
-                        if (total > 0)
-                            yield return new HitResultDisplayStatistic(r.result, value, total, r.displayName);
-
-                        break;
-                    }
-
-                    case HitResult.SmallTickMiss:
-                    case HitResult.LargeTickMiss:
-                        break;
-
-                    default:
-                        yield return new HitResultDisplayStatistic(r.result, value, null, r.displayName);
-
-                        break;
-                }
-            }
+            get => (ScoreRank)RankInt;
+            set => RankInt = (int)value;
         }
 
-        public ScoreInfo DeepClone()
-        {
-            var clone = (ScoreInfo)MemberwiseClone();
+        [MapTo(nameof(Rank))]
+        public int RankInt { get; set; }
 
-            clone.Statistics = new Dictionary<HitResult, int>(clone.Statistics);
-
-            return clone;
-        }
-
-        public override string ToString() => this.GetDisplayTitle();
-
-        public bool Equals(ScoreInfo other)
-        {
-            if (ReferenceEquals(this, other)) return true;
-            if (other == null) return false;
-
-            if (ID != 0 && other.ID != 0)
-                return ID == other.ID;
-
-            return false;
-        }
-
-        #region Implementation of IHasOnlineID
-
-        long IHasOnlineID<long>.OnlineID => OnlineID ?? -1;
-
-        #endregion
-
-        #region Implementation of IScoreInfo
-
-        IBeatmapInfo IScoreInfo.Beatmap => BeatmapInfo;
         IRulesetInfo IScoreInfo.Ruleset => Ruleset;
+        IBeatmapInfo IScoreInfo.Beatmap => Beatmap;
         IUser IScoreInfo.User => User;
-        bool IScoreInfo.HasReplay => Files.Any();
-
-        #endregion
-
         IEnumerable<INamedFileUsage> IHasNamedFiles.Files => Files;
     }
 }
diff --git a/osu.Game/Stores/ScoreImporter.cs b/osu.Game/Stores/ScoreImporter.cs
index b30dd88fbe..256f73d8e7 100644
--- a/osu.Game/Stores/ScoreImporter.cs
+++ b/osu.Game/Stores/ScoreImporter.cs
@@ -13,6 +13,7 @@ using osu.Game.Beatmaps;
 using osu.Game.Database;
 using osu.Game.IO.Archives;
 using osu.Game.Models;
+using osu.Game.Scoring;
 using osu.Game.Scoring.Legacy;
 using Realms;
 
@@ -24,7 +25,7 @@ namespace osu.Game.Stores
     /// Handles the storage and retrieval of Scores/WorkingScores.
     /// </summary>
     [ExcludeFromDynamicCompile]
-    public class ScoreImporter : RealmArchiveModelImporter<RealmScore>
+    public class ScoreImporter : RealmArchiveModelImporter<ScoreInfo>
     {
         private readonly RealmRulesetStore rulesets;
         private readonly BeatmapManager beatmaps;
@@ -40,7 +41,7 @@ namespace osu.Game.Stores
             this.beatmaps = beatmaps;
         }
 
-        protected override RealmScore? CreateModel(ArchiveReader archive)
+        protected override ScoreInfo? CreateModel(ArchiveReader archive)
         {
             using (var stream = archive.GetStream(archive.Filenames.First(f => f.EndsWith(".osr", StringComparison.OrdinalIgnoreCase))))
             {
@@ -48,7 +49,7 @@ namespace osu.Game.Stores
                 {
                     // TODO: make work.
                     // return new DatabasedLegacyScoreDecoder(rulesets, beatmaps).Parse(stream).ScoreInfo;
-                    return new RealmScore();
+                    return new ScoreInfo();
                 }
                 catch (LegacyScoreDecoder.BeatmapNotFoundException e)
                 {
@@ -58,7 +59,7 @@ namespace osu.Game.Stores
             }
         }
 
-        protected override Task Populate(RealmScore model, ArchiveReader? archive, Realm realm, CancellationToken cancellationToken = default)
+        protected override Task Populate(ScoreInfo model, ArchiveReader? archive, Realm realm, CancellationToken cancellationToken = default)
             => Task.CompletedTask;
     }
 }

From 638b3d91610dd3cf548f859ee704f9963aa5bc3f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 6 Dec 2021 15:32:02 +0900
Subject: [PATCH 2018/5547] Add statistics storage to realm model

---
 osu.Game/Scoring/ScoreInfo.cs | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/osu.Game/Scoring/ScoreInfo.cs b/osu.Game/Scoring/ScoreInfo.cs
index 0c097d1294..1938271989 100644
--- a/osu.Game/Scoring/ScoreInfo.cs
+++ b/osu.Game/Scoring/ScoreInfo.cs
@@ -51,6 +51,22 @@ namespace osu.Game.Scoring
 
         public RealmRuleset Ruleset { get; set; } = null!;
 
+        [Ignored]
+        public Dictionary<HitResult, int> Statistics
+        {
+            get
+            {
+                if (string.IsNullOrEmpty(StatisticsJson))
+                    return new Dictionary<HitResult, int>();
+
+                return JsonConvert.DeserializeObject<Dictionary<HitResult, int>>(StatisticsJson) ?? new Dictionary<HitResult, int>();
+            }
+            set => JsonConvert.SerializeObject(StatisticsJson);
+        }
+
+        [MapTo("Statistics")]
+        public string StatisticsJson { get; set; } = null!;
+
         public ScoreRank Rank
         {
             get => (ScoreRank)RankInt;

From e44751c275918bcf19da500e40dd57e7c1672591 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 6 Dec 2021 15:35:08 +0900
Subject: [PATCH 2019/5547] Add required properties for compatibility with
 existing code

---
 osu.Game/Scoring/ScoreInfo.cs | 133 ++++++++++++++++++++++++++++++++++
 1 file changed, 133 insertions(+)

diff --git a/osu.Game/Scoring/ScoreInfo.cs b/osu.Game/Scoring/ScoreInfo.cs
index 1938271989..11cd26dd3c 100644
--- a/osu.Game/Scoring/ScoreInfo.cs
+++ b/osu.Game/Scoring/ScoreInfo.cs
@@ -3,11 +3,17 @@
 
 using System;
 using System.Collections.Generic;
+using System.ComponentModel.DataAnnotations.Schema;
+using System.Linq;
+using Newtonsoft.Json;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
 using osu.Game.Database;
 using osu.Game.Models;
+using osu.Game.Online.API;
 using osu.Game.Rulesets;
+using osu.Game.Rulesets.Mods;
+using osu.Game.Rulesets.Scoring;
 using osu.Game.Users;
 using Realms;
 
@@ -80,5 +86,132 @@ namespace osu.Game.Scoring
         IBeatmapInfo IScoreInfo.Beatmap => Beatmap;
         IUser IScoreInfo.User => User;
         IEnumerable<INamedFileUsage> IHasNamedFiles.Files => Files;
+
+        #region Properties required to make things work with existing usages
+
+        private APIMod[]? localAPIMods;
+
+        private Mod[]? mods;
+
+        [Ignored]
+        public List<HitEvent> HitEvents { get; set; } = new List<HitEvent>();
+
+        public ScoreInfo DeepClone()
+        {
+            var clone = (ScoreInfo)MemberwiseClone();
+
+            clone.Statistics = new Dictionary<HitResult, int>(clone.Statistics);
+
+            return clone;
+        }
+
+        [Ignored]
+        public bool Passed { get; set; } = true;
+
+        /// <summary>
+        /// The position of this score, starting at 1.
+        /// </summary>
+        [Ignored]
+        public int? Position { get; set; } // TODO: remove after all calls to `CreateScoreInfo` are gone.
+
+        /// <summary>
+        /// Whether this <see cref="EFScoreInfo"/> represents a legacy (osu!stable) score.
+        /// </summary>
+        [Ignored]
+        public bool IsLegacyScore => Mods.OfType<ModClassic>().Any();
+
+        [Ignored]
+        public Mod[] Mods
+        {
+            get
+            {
+                var rulesetInstance = Ruleset.CreateInstance();
+
+                Mod[] scoreMods = Array.Empty<Mod>();
+
+                if (mods != null)
+                    scoreMods = mods;
+                else if (localAPIMods != null)
+                    scoreMods = APIMods.Select(m => m.ToMod(rulesetInstance)).ToArray();
+
+                return scoreMods;
+            }
+            set
+            {
+                localAPIMods = null;
+                mods = value;
+            }
+        }
+
+        // Used for API serialisation/deserialisation.
+        [Ignored]
+        public APIMod[] APIMods
+        {
+            get
+            {
+                if (localAPIMods != null)
+                    return localAPIMods;
+
+                if (mods == null)
+                    return Array.Empty<APIMod>();
+
+                return localAPIMods = mods.Select(m => new APIMod(m)).ToArray();
+            }
+            set
+            {
+                localAPIMods = value;
+
+                // We potentially can't update this yet due to Ruleset being late-bound, so instead update on read as necessary.
+                mods = null;
+            }
+        }
+
+        // Used for database serialisation/deserialisation.
+        [Column("Mods")]
+        public string ModsJson
+        {
+            get => JsonConvert.SerializeObject(APIMods);
+            set => APIMods = JsonConvert.DeserializeObject<APIMod[]>(value) ?? Array.Empty<APIMod>();
+        }
+
+        public IEnumerable<HitResultDisplayStatistic> GetStatisticsForDisplay()
+        {
+            foreach (var r in Ruleset.CreateInstance().GetHitResults())
+            {
+                int value = Statistics.GetValueOrDefault(r.result);
+
+                switch (r.result)
+                {
+                    case HitResult.SmallTickHit:
+                    {
+                        int total = value + Statistics.GetValueOrDefault(HitResult.SmallTickMiss);
+                        if (total > 0)
+                            yield return new HitResultDisplayStatistic(r.result, value, total, r.displayName);
+
+                        break;
+                    }
+
+                    case HitResult.LargeTickHit:
+                    {
+                        int total = value + Statistics.GetValueOrDefault(HitResult.LargeTickMiss);
+                        if (total > 0)
+                            yield return new HitResultDisplayStatistic(r.result, value, total, r.displayName);
+
+                        break;
+                    }
+
+                    case HitResult.SmallTickMiss:
+                    case HitResult.LargeTickMiss:
+                        break;
+
+                    default:
+                        yield return new HitResultDisplayStatistic(r.result, value, null, r.displayName);
+
+                        break;
+                }
+            }
+        }
+
+        #endregion
     }
 }

From 2a4bee61dde38d203dcaeca6da89fe904ab2e80d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 6 Dec 2021 22:47:00 +0900
Subject: [PATCH 2020/5547] Update many score-related classes to move closer to
 being able to persist to realm

---
 osu.Game/Database/LegacyScoreExporter.cs      |  2 +-
 .../Online/API/Requests/Responses/APIScore.cs |  1 -
 osu.Game/Online/Rooms/MultiplayerScore.cs     |  2 --
 osu.Game/Online/Solo/SubmittableScore.cs      |  3 +-
 osu.Game/OsuGame.cs                           |  2 +-
 osu.Game/Scoring/EFScoreInfo.cs               |  2 ++
 osu.Game/Scoring/LegacyDatabasedScore.cs      |  2 +-
 osu.Game/Scoring/ScoreInfo.cs                 | 36 ++++++++++++++++++-
 osu.Game/Scoring/ScoreManager.cs              | 10 +++---
 osu.Game/Scoring/ScoreModelManager.cs         | 29 +++++----------
 osu.Game/Scoring/ScoreStore.cs                | 25 -------------
 osu.Game/Screens/Ranking/ScorePanelList.cs    |  2 +-
 .../Select/Leaderboards/BeatmapLeaderboard.cs |  2 +-
 osu.Game/Stores/ScoreImporter.cs              |  1 -
 14 files changed, 58 insertions(+), 61 deletions(-)
 delete mode 100644 osu.Game/Scoring/ScoreStore.cs

diff --git a/osu.Game/Database/LegacyScoreExporter.cs b/osu.Game/Database/LegacyScoreExporter.cs
index 41f8516880..336f50bc3d 100644
--- a/osu.Game/Database/LegacyScoreExporter.cs
+++ b/osu.Game/Database/LegacyScoreExporter.cs
@@ -24,7 +24,7 @@ namespace osu.Game.Database
             if (file == null)
                 return;
 
-            using (var inputStream = UserFileStorage.GetStream(file.FileInfo.GetStoragePath()))
+            using (var inputStream = UserFileStorage.GetStream(file.File.GetStoragePath()))
                 inputStream.CopyTo(outputStream);
         }
     }
diff --git a/osu.Game/Online/API/Requests/Responses/APIScore.cs b/osu.Game/Online/API/Requests/Responses/APIScore.cs
index 4f795bee6c..71f277570d 100644
--- a/osu.Game/Online/API/Requests/Responses/APIScore.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIScore.cs
@@ -105,7 +105,6 @@ namespace osu.Game.Online.API.Requests.Responses
                 OnlineID = OnlineID,
                 Date = Date,
                 PP = PP,
-                RulesetID = RulesetID,
                 Hash = HasReplay ? "online" : string.Empty, // todo: temporary?
                 Rank = Rank,
                 Ruleset = ruleset,
diff --git a/osu.Game/Online/Rooms/MultiplayerScore.cs b/osu.Game/Online/Rooms/MultiplayerScore.cs
index 05c9a1b6cf..b90680a925 100644
--- a/osu.Game/Online/Rooms/MultiplayerScore.cs
+++ b/osu.Game/Online/Rooms/MultiplayerScore.cs
@@ -73,9 +73,7 @@ namespace osu.Game.Online.Rooms
                 TotalScore = TotalScore,
                 MaxCombo = MaxCombo,
                 BeatmapInfo = beatmap,
-                BeatmapInfoID = playlistItem.BeatmapID,
                 Ruleset = rulesets.GetRuleset(playlistItem.RulesetID),
-                RulesetID = playlistItem.RulesetID,
                 Statistics = Statistics,
                 User = User,
                 Accuracy = Accuracy,
diff --git a/osu.Game/Online/Solo/SubmittableScore.cs b/osu.Game/Online/Solo/SubmittableScore.cs
index 5ca5ad9619..52aef82c3b 100644
--- a/osu.Game/Online/Solo/SubmittableScore.cs
+++ b/osu.Game/Online/Solo/SubmittableScore.cs
@@ -10,6 +10,7 @@ using osu.Game.Online.API;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets.Scoring;
 using osu.Game.Scoring;
+using osu.Game.Users;
 using APIUser = osu.Game.Online.API.Requests.Responses.APIUser;
 
 namespace osu.Game.Online.Solo
@@ -48,7 +49,7 @@ namespace osu.Game.Online.Solo
         public APIMod[] Mods { get; set; }
 
         [JsonProperty("user")]
-        public APIUser User { get; set; }
+        public IUser User { get; set; }
 
         [JsonProperty("statistics")]
         public Dictionary<HitResult, int> Statistics { get; set; }
diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index 0d0a572663..544e8df425 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -481,7 +481,7 @@ namespace osu.Game
         /// Present a score's replay immediately.
         /// The user should have already requested this interactively.
         /// </summary>
-        public void PresentScore(ScoreInfo score, ScorePresentType presentType = ScorePresentType.Results)
+        public void PresentScore(IScoreInfo score, ScorePresentType presentType = ScorePresentType.Results)
         {
             // 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.
diff --git a/osu.Game/Scoring/EFScoreInfo.cs b/osu.Game/Scoring/EFScoreInfo.cs
index e23662f74d..84b41e40ef 100644
--- a/osu.Game/Scoring/EFScoreInfo.cs
+++ b/osu.Game/Scoring/EFScoreInfo.cs
@@ -23,6 +23,8 @@ namespace osu.Game.Scoring
     {
         public int ID { get; set; }
 
+        public bool IsManaged => ID > 0;
+
         public ScoreRank Rank { get; set; }
 
         public long TotalScore { get; set; }
diff --git a/osu.Game/Scoring/LegacyDatabasedScore.cs b/osu.Game/Scoring/LegacyDatabasedScore.cs
index 69360cacc7..ac444c1bf3 100644
--- a/osu.Game/Scoring/LegacyDatabasedScore.cs
+++ b/osu.Game/Scoring/LegacyDatabasedScore.cs
@@ -17,7 +17,7 @@ namespace osu.Game.Scoring
         {
             ScoreInfo = score;
 
-            string replayFilename = score.Files.FirstOrDefault(f => f.Filename.EndsWith(".osr", StringComparison.InvariantCultureIgnoreCase))?.FileInfo.GetStoragePath();
+            string replayFilename = score.Files.FirstOrDefault(f => f.Filename.EndsWith(".osr", StringComparison.InvariantCultureIgnoreCase))?.File.GetStoragePath();
 
             if (replayFilename == null)
                 return;
diff --git a/osu.Game/Scoring/ScoreInfo.cs b/osu.Game/Scoring/ScoreInfo.cs
index 11cd26dd3c..782fe0681b 100644
--- a/osu.Game/Scoring/ScoreInfo.cs
+++ b/osu.Game/Scoring/ScoreInfo.cs
@@ -6,6 +6,7 @@ using System.Collections.Generic;
 using System.ComponentModel.DataAnnotations.Schema;
 using System.Linq;
 using Newtonsoft.Json;
+using osu.Framework.Localisation;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
 using osu.Game.Database;
@@ -15,6 +16,7 @@ using osu.Game.Rulesets;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Scoring;
 using osu.Game.Users;
+using osu.Game.Utils;
 using Realms;
 
 #nullable enable
@@ -39,7 +41,18 @@ namespace osu.Game.Scoring
         [Indexed]
         public long OnlineID { get; set; } = -1;
 
-        public RealmUser User { get; set; } = null!;
+        [MapTo("User")]
+        public RealmUser RealmUser { get; set; } = null!;
+
+        public IUser User
+        {
+            get => RealmUser;
+            set => RealmUser = new RealmUser
+            {
+                OnlineID = value.OnlineID,
+                Username = value.Username
+            };
+        }
 
         public long TotalScore { get; set; }
 
@@ -55,11 +68,20 @@ namespace osu.Game.Scoring
 
         public RealmBeatmap Beatmap { get; set; } = null!;
 
+        public BeatmapInfo BeatmapInfo
+        {
+            get => new BeatmapInfo();
+            // .. todo
+            set => Beatmap = new RealmBeatmap(new RealmRuleset("osu", "osu!", "wangs", 0), new RealmBeatmapDifficulty(), new RealmBeatmapMetadata());
+        }
+
         public RealmRuleset Ruleset { get; set; } = null!;
 
         [Ignored]
         public Dictionary<HitResult, int> Statistics
         {
+            // TODO: this is dangerous. a get operation may then modify the dictionary, which would be a fresh copy that is not persisted with the model.
+            // this is already the case in multiple locations.
             get
             {
                 if (string.IsNullOrEmpty(StatisticsJson))
@@ -93,6 +115,12 @@ namespace osu.Game.Scoring
 
         private Mod[]? mods;
 
+        public int BeatmapInfoID => BeatmapInfo.ID;
+
+        public int UserID => RealmUser.OnlineID;
+
+        public int RulesetID => Ruleset.OnlineID;
+
         [Ignored]
         public List<HitEvent> HitEvents { get; set; } = new List<HitEvent>();
 
@@ -108,12 +136,18 @@ namespace osu.Game.Scoring
         [Ignored]
         public bool Passed { get; set; } = true;
 
+        [Ignored]
+        public int Combo { get; set; }
+
         /// <summary>
         /// The position of this score, starting at 1.
         /// </summary>
         [Ignored]
         public int? Position { get; set; } // TODO: remove after all calls to `CreateScoreInfo` are gone.
 
+        [Ignored]
+        public LocalisableString DisplayAccuracy => Accuracy.FormatAccuracy();
+
         /// <summary>
         /// Whether this <see cref="EFScoreInfo"/> represents a legacy (osu!stable) score.
         /// </summary>
diff --git a/osu.Game/Scoring/ScoreManager.cs b/osu.Game/Scoring/ScoreManager.cs
index 9f248ffdca..740c46387e 100644
--- a/osu.Game/Scoring/ScoreManager.cs
+++ b/osu.Game/Scoring/ScoreManager.cs
@@ -63,7 +63,7 @@ namespace osu.Game.Scoring
                 // Compute difficulties asynchronously first to prevent blocking via the GetTotalScore() call below.
                 foreach (var s in scores)
                 {
-                    await difficultyCache.GetDifficultyAsync(s.BeatmapInfo, s.Ruleset, s.Mods, cancellationToken).ConfigureAwait(false);
+                    await difficultyCache.GetDifficultyAsync(s.Beatmap, s.Ruleset, s.Mods, cancellationToken).ConfigureAwait(false);
                     cancellationToken.ThrowIfCancellationRequested();
                 }
             }
@@ -125,7 +125,7 @@ namespace osu.Game.Scoring
         /// <returns>The total score.</returns>
         public async Task<long> GetTotalScoreAsync([NotNull] ScoreInfo score, ScoringMode mode = ScoringMode.Standardised, CancellationToken cancellationToken = default)
         {
-            if (score.BeatmapInfo == null)
+            if (score.Beatmap == null)
                 return score.TotalScore;
 
             int beatmapMaxCombo;
@@ -146,11 +146,11 @@ namespace osu.Game.Scoring
 
                 // This score is guaranteed to be an osu!stable score.
                 // The combo must be determined through either the beatmap's max combo value or the difficulty calculator, as lazer's scoring has changed and the score statistics cannot be used.
-                if (score.BeatmapInfo.MaxCombo != null)
-                    beatmapMaxCombo = score.BeatmapInfo.MaxCombo.Value;
+                if (score.Beatmap.MaxCombo != null)
+                    beatmapMaxCombo = score.Beatmap.MaxCombo.Value;
                 else
                 {
-                    if (score.BeatmapInfo.ID == 0 || difficulties == null)
+                    if (score.Beatmap.ID == 0 || difficulties == null)
                     {
                         // We don't have enough information (max combo) to compute the score, so use the provided score.
                         return score.TotalScore;
diff --git a/osu.Game/Scoring/ScoreModelManager.cs b/osu.Game/Scoring/ScoreModelManager.cs
index 44f0fe4fdf..81f80df3ad 100644
--- a/osu.Game/Scoring/ScoreModelManager.cs
+++ b/osu.Game/Scoring/ScoreModelManager.cs
@@ -4,10 +4,8 @@
 using System;
 using System.Collections.Generic;
 using System.Linq;
-using System.Linq.Expressions;
 using System.Threading;
 using System.Threading.Tasks;
-using Microsoft.EntityFrameworkCore;
 using osu.Framework.Logging;
 using osu.Framework.Platform;
 using osu.Game.Beatmaps;
@@ -15,10 +13,14 @@ using osu.Game.Database;
 using osu.Game.IO.Archives;
 using osu.Game.Rulesets;
 using osu.Game.Scoring.Legacy;
+using osu.Game.Stores;
+using Realms;
+
+#nullable enable
 
 namespace osu.Game.Scoring
 {
-    public class ScoreModelManager : ArchiveModelManager<ScoreInfo, ScoreFileInfo>
+    public class ScoreModelManager : RealmArchiveModelManager<ScoreInfo>
     {
         public override IEnumerable<string> HandledExtensions => new[] { ".osr" };
 
@@ -27,18 +29,15 @@ namespace osu.Game.Scoring
         private readonly RulesetStore rulesets;
         private readonly Func<BeatmapManager> beatmaps;
 
-        public ScoreModelManager(RulesetStore rulesets, Func<BeatmapManager> beatmaps, Storage storage, IDatabaseContextFactory contextFactory, IIpcHost importHost = null)
-            : base(storage, contextFactory, new ScoreStore(contextFactory, storage), importHost)
+        public ScoreModelManager(RulesetStore rulesets, Func<BeatmapManager> beatmaps, Storage storage, RealmContextFactory contextFactory)
+            : base(storage, contextFactory)
         {
             this.rulesets = rulesets;
             this.beatmaps = beatmaps;
         }
 
-        protected override ScoreInfo CreateModel(ArchiveReader archive)
+        protected override ScoreInfo? CreateModel(ArchiveReader archive)
         {
-            if (archive == null)
-                return null;
-
             using (var stream = archive.GetStream(archive.Filenames.First(f => f.EndsWith(".osr", StringComparison.OrdinalIgnoreCase))))
             {
                 try
@@ -55,17 +54,7 @@ namespace osu.Game.Scoring
 
         public Score GetScore(ScoreInfo score) => new LegacyDatabasedScore(score, rulesets, beatmaps(), Files.Store);
 
-        public List<ScoreInfo> GetAllUsableScores() => ModelStore.ConsumableItems.Where(s => !s.DeletePending).ToList();
-
-        public IEnumerable<ScoreInfo> QueryScores(Expression<Func<ScoreInfo, bool>> query) => ModelStore.ConsumableItems.AsNoTracking().Where(query);
-
-        public ScoreInfo Query(Expression<Func<ScoreInfo, bool>> query) => ModelStore.ConsumableItems.AsNoTracking().FirstOrDefault(query);
-
-        protected override Task Populate(ScoreInfo model, ArchiveReader archive, CancellationToken cancellationToken = default)
+        protected override Task Populate(ScoreInfo model, ArchiveReader? archive, Realm realm, CancellationToken cancellationToken = default)
             => Task.CompletedTask;
-
-        protected override bool CheckLocalAvailability(ScoreInfo model, IQueryable<ScoreInfo> items)
-            => base.CheckLocalAvailability(model, items)
-               || (model.OnlineID > 0 && items.Any(i => i.OnlineID == model.OnlineID));
     }
 }
diff --git a/osu.Game/Scoring/ScoreStore.cs b/osu.Game/Scoring/ScoreStore.cs
deleted file mode 100644
index fd1f5ae3ec..0000000000
--- a/osu.Game/Scoring/ScoreStore.cs
+++ /dev/null
@@ -1,25 +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.Linq;
-using Microsoft.EntityFrameworkCore;
-using osu.Framework.Platform;
-using osu.Game.Database;
-
-namespace osu.Game.Scoring
-{
-    public class ScoreStore : MutableDatabaseBackedStoreWithFileIncludes<ScoreInfo, ScoreFileInfo>
-    {
-        public ScoreStore(IDatabaseContextFactory factory, Storage storage)
-            : base(factory, storage)
-        {
-        }
-
-        protected override IQueryable<ScoreInfo> AddIncludesForConsumption(IQueryable<ScoreInfo> query)
-            => base.AddIncludesForConsumption(query)
-                   .Include(s => s.BeatmapInfo)
-                   .Include(s => s.BeatmapInfo).ThenInclude(b => b.Metadata)
-                   .Include(s => s.BeatmapInfo).ThenInclude(b => b.BeatmapSet).ThenInclude(s => s.Metadata)
-                   .Include(s => s.Ruleset);
-    }
-}
diff --git a/osu.Game/Screens/Ranking/ScorePanelList.cs b/osu.Game/Screens/Ranking/ScorePanelList.cs
index f8e9d08350..eb91c256c7 100644
--- a/osu.Game/Screens/Ranking/ScorePanelList.cs
+++ b/osu.Game/Screens/Ranking/ScorePanelList.cs
@@ -196,7 +196,7 @@ namespace osu.Game.Screens.Ranking
             }
 
             // Find the panel corresponding to the new score.
-            var expandedTrackingComponent = flow.SingleOrDefault(t => t.Panel.Score == score.NewValue);
+            var expandedTrackingComponent = flow.SingleOrDefault(t => t.Panel.Score.Equals(score.NewValue));
             expandedPanel = expandedTrackingComponent?.Panel;
 
             if (expandedPanel == null)
diff --git a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
index 3b25d34aec..7026f240c8 100644
--- a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
+++ b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
@@ -127,7 +127,7 @@ namespace osu.Game.Screens.Select.Leaderboards
             if (Scope == BeatmapLeaderboardScope.Local)
             {
                 var scores = scoreManager
-                    .QueryScores(s => !s.DeletePending && s.BeatmapInfo.ID == fetchBeatmapInfo.ID && s.Ruleset.ID == ruleset.Value.ID);
+                    .QueryScores(s => !s.DeletePending && s.BeatmapInfo.ID == fetchBeatmapInfo.ID && s.Ruleset.OnlineID == ruleset.Value.ID);
 
                 if (filterMods && !mods.Value.Any())
                 {
diff --git a/osu.Game/Stores/ScoreImporter.cs b/osu.Game/Stores/ScoreImporter.cs
index 256f73d8e7..8b43f618cc 100644
--- a/osu.Game/Stores/ScoreImporter.cs
+++ b/osu.Game/Stores/ScoreImporter.cs
@@ -12,7 +12,6 @@ using osu.Framework.Testing;
 using osu.Game.Beatmaps;
 using osu.Game.Database;
 using osu.Game.IO.Archives;
-using osu.Game.Models;
 using osu.Game.Scoring;
 using osu.Game.Scoring.Legacy;
 using Realms;

From aac2aa341cf879c66e7b802d6d9a2ce1d1c3e890 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 13 Dec 2021 17:09:13 +0900
Subject: [PATCH 2021/5547] Update some more incorrect types for primary key
 access/set

---
 osu.Game.Tests/Scores/IO/TestScoreEquality.cs  | 11 +++++++----
 osu.Game/Online/Solo/SubmittableScore.cs       |  1 -
 osu.Game/OsuGame.cs                            |  3 ++-
 osu.Game/Scoring/Legacy/ScoreInfoExtensions.cs | 16 ++++++++--------
 4 files changed, 17 insertions(+), 14 deletions(-)

diff --git a/osu.Game.Tests/Scores/IO/TestScoreEquality.cs b/osu.Game.Tests/Scores/IO/TestScoreEquality.cs
index 42fcb3acab..f898774ce6 100644
--- a/osu.Game.Tests/Scores/IO/TestScoreEquality.cs
+++ b/osu.Game.Tests/Scores/IO/TestScoreEquality.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 NUnit.Framework;
 using osu.Game.Scoring;
 
@@ -29,8 +30,8 @@ namespace osu.Game.Tests.Scores.IO
         [Test]
         public void TestNonMatchingByPrimaryKey()
         {
-            ScoreInfo score1 = new ScoreInfo { ID = 1 };
-            ScoreInfo score2 = new ScoreInfo { ID = 2 };
+            ScoreInfo score1 = new ScoreInfo { ID = Guid.NewGuid() };
+            ScoreInfo score2 = new ScoreInfo { ID = Guid.NewGuid() };
 
             Assert.That(score1, Is.Not.EqualTo(score2));
         }
@@ -38,8 +39,10 @@ namespace osu.Game.Tests.Scores.IO
         [Test]
         public void TestMatchingByPrimaryKey()
         {
-            ScoreInfo score1 = new ScoreInfo { ID = 1 };
-            ScoreInfo score2 = new ScoreInfo { ID = 1 };
+            Guid id = Guid.NewGuid();
+
+            ScoreInfo score1 = new ScoreInfo { ID = id };
+            ScoreInfo score2 = new ScoreInfo { ID = id };
 
             Assert.That(score1, Is.EqualTo(score2));
         }
diff --git a/osu.Game/Online/Solo/SubmittableScore.cs b/osu.Game/Online/Solo/SubmittableScore.cs
index 52aef82c3b..327806f390 100644
--- a/osu.Game/Online/Solo/SubmittableScore.cs
+++ b/osu.Game/Online/Solo/SubmittableScore.cs
@@ -11,7 +11,6 @@ using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets.Scoring;
 using osu.Game.Scoring;
 using osu.Game.Users;
-using APIUser = osu.Game.Online.API.Requests.Responses.APIUser;
 
 namespace osu.Game.Online.Solo
 {
diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index 544e8df425..4539409d4c 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -490,7 +490,8 @@ namespace osu.Game
             if (score.OnlineID > 0)
                 databasedScoreInfo = ScoreManager.Query(s => s.OnlineID == score.OnlineID);
 
-            databasedScoreInfo ??= ScoreManager.Query(s => s.Hash == score.Hash);
+            if (score is ScoreInfo scoreInfo)
+                databasedScoreInfo ??= ScoreManager.Query(s => s.Hash == scoreInfo.Hash);
 
             if (databasedScoreInfo == null)
             {
diff --git a/osu.Game/Scoring/Legacy/ScoreInfoExtensions.cs b/osu.Game/Scoring/Legacy/ScoreInfoExtensions.cs
index fc27261225..a11cd5fcbd 100644
--- a/osu.Game/Scoring/Legacy/ScoreInfoExtensions.cs
+++ b/osu.Game/Scoring/Legacy/ScoreInfoExtensions.cs
@@ -9,7 +9,7 @@ namespace osu.Game.Scoring.Legacy
     {
         public static int? GetCountGeki(this ScoreInfo scoreInfo)
         {
-            switch (scoreInfo.Ruleset?.ID ?? scoreInfo.RulesetID)
+            switch (scoreInfo.Ruleset.OnlineID)
             {
                 case 3:
                     return getCount(scoreInfo, HitResult.Perfect);
@@ -20,7 +20,7 @@ namespace osu.Game.Scoring.Legacy
 
         public static void SetCountGeki(this ScoreInfo scoreInfo, int value)
         {
-            switch (scoreInfo.Ruleset?.ID ?? scoreInfo.RulesetID)
+            switch (scoreInfo.Ruleset.OnlineID)
             {
                 case 3:
                     scoreInfo.Statistics[HitResult.Perfect] = value;
@@ -34,7 +34,7 @@ namespace osu.Game.Scoring.Legacy
 
         public static int? GetCountKatu(this ScoreInfo scoreInfo)
         {
-            switch (scoreInfo.Ruleset?.ID ?? scoreInfo.RulesetID)
+            switch (scoreInfo.Ruleset.OnlineID)
             {
                 case 3:
                     return getCount(scoreInfo, HitResult.Good);
@@ -48,7 +48,7 @@ namespace osu.Game.Scoring.Legacy
 
         public static void SetCountKatu(this ScoreInfo scoreInfo, int value)
         {
-            switch (scoreInfo.Ruleset?.ID ?? scoreInfo.RulesetID)
+            switch (scoreInfo.Ruleset.OnlineID)
             {
                 case 3:
                     scoreInfo.Statistics[HitResult.Good] = value;
@@ -62,7 +62,7 @@ namespace osu.Game.Scoring.Legacy
 
         public static int? GetCount100(this ScoreInfo scoreInfo)
         {
-            switch (scoreInfo.Ruleset?.ID ?? scoreInfo.RulesetID)
+            switch (scoreInfo.Ruleset.OnlineID)
             {
                 case 0:
                 case 1:
@@ -78,7 +78,7 @@ namespace osu.Game.Scoring.Legacy
 
         public static void SetCount100(this ScoreInfo scoreInfo, int value)
         {
-            switch (scoreInfo.Ruleset?.ID ?? scoreInfo.RulesetID)
+            switch (scoreInfo.Ruleset.OnlineID)
             {
                 case 0:
                 case 1:
@@ -94,7 +94,7 @@ namespace osu.Game.Scoring.Legacy
 
         public static int? GetCount50(this ScoreInfo scoreInfo)
         {
-            switch (scoreInfo.Ruleset?.ID ?? scoreInfo.RulesetID)
+            switch (scoreInfo.Ruleset.OnlineID)
             {
                 case 0:
                 case 3:
@@ -109,7 +109,7 @@ namespace osu.Game.Scoring.Legacy
 
         public static void SetCount50(this ScoreInfo scoreInfo, int value)
         {
-            switch (scoreInfo.Ruleset?.ID ?? scoreInfo.RulesetID)
+            switch (scoreInfo.Ruleset.OnlineID)
             {
                 case 0:
                 case 3:

From e711a6d35598643c9a11ed6d895db09c4abd74f9 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 13 Dec 2021 17:37:17 +0900
Subject: [PATCH 2022/5547] Remove unused `ScoreImporter` class

---
 osu.Game/Stores/ScoreImporter.cs | 64 --------------------------------
 1 file changed, 64 deletions(-)
 delete mode 100644 osu.Game/Stores/ScoreImporter.cs

diff --git a/osu.Game/Stores/ScoreImporter.cs b/osu.Game/Stores/ScoreImporter.cs
deleted file mode 100644
index 8b43f618cc..0000000000
--- a/osu.Game/Stores/ScoreImporter.cs
+++ /dev/null
@@ -1,64 +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 System.Threading;
-using System.Threading.Tasks;
-using osu.Framework.Logging;
-using osu.Framework.Platform;
-using osu.Framework.Testing;
-using osu.Game.Beatmaps;
-using osu.Game.Database;
-using osu.Game.IO.Archives;
-using osu.Game.Scoring;
-using osu.Game.Scoring.Legacy;
-using Realms;
-
-#nullable enable
-
-namespace osu.Game.Stores
-{
-    /// <summary>
-    /// Handles the storage and retrieval of Scores/WorkingScores.
-    /// </summary>
-    [ExcludeFromDynamicCompile]
-    public class ScoreImporter : RealmArchiveModelImporter<ScoreInfo>
-    {
-        private readonly RealmRulesetStore rulesets;
-        private readonly BeatmapManager beatmaps;
-
-        public override IEnumerable<string> HandledExtensions => new[] { ".osr" };
-
-        protected override string[] HashableFileTypes => new[] { ".osr" };
-
-        public ScoreImporter(RealmRulesetStore rulesets, RealmContextFactory contextFactory, Storage storage, BeatmapManager beatmaps)
-            : base(storage, contextFactory)
-        {
-            this.rulesets = rulesets;
-            this.beatmaps = beatmaps;
-        }
-
-        protected override ScoreInfo? CreateModel(ArchiveReader archive)
-        {
-            using (var stream = archive.GetStream(archive.Filenames.First(f => f.EndsWith(".osr", StringComparison.OrdinalIgnoreCase))))
-            {
-                try
-                {
-                    // TODO: make work.
-                    // return new DatabasedLegacyScoreDecoder(rulesets, beatmaps).Parse(stream).ScoreInfo;
-                    return new ScoreInfo();
-                }
-                catch (LegacyScoreDecoder.BeatmapNotFoundException e)
-                {
-                    Logger.Log(e.Message, LoggingTarget.Information, LogLevel.Error);
-                    return null;
-                }
-            }
-        }
-
-        protected override Task Populate(ScoreInfo model, ArchiveReader? archive, Realm realm, CancellationToken cancellationToken = default)
-            => Task.CompletedTask;
-    }
-}

From 53792811b2648611844650934d8d24f265890597 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 13 Dec 2021 17:37:27 +0900
Subject: [PATCH 2023/5547] more fixes (almost compiles, except ruleset and
 manager)

---
 .../Beatmaps/IO/ImportBeatmapTest.cs          | 11 ++++++++
 osu.Game.Tests/Resources/TestResources.cs     |  1 -
 .../Visual/Ranking/TestSceneScorePanelList.cs | 11 ++++----
 .../SongSelect/TestSceneBeatmapLeaderboard.cs |  4 ++-
 .../TestSceneDeleteLocalScore.cs              |  3 ++-
 .../Online/Leaderboards/LeaderboardScore.cs   |  2 +-
 osu.Game/OsuGameBase.cs                       |  2 +-
 .../Scores/TopScoreStatisticsSection.cs       |  4 +--
 osu.Game/Scoring/Legacy/LegacyScoreEncoder.cs |  4 +--
 osu.Game/Scoring/LegacyDatabasedScore.cs      |  4 +--
 osu.Game/Scoring/ScoreInfo.cs                 | 27 +++++++++++++++----
 osu.Game/Scoring/ScoreManager.cs              | 10 ++++---
 osu.Game/Scoring/ScoreModelManager.cs         |  5 ++--
 osu.Game/Screens/Play/Player.cs               |  5 ++--
 .../ContractedPanelMiddleContent.cs           |  2 +-
 osu.Game/Screens/Ranking/ScorePanelList.cs    | 14 +++++-----
 .../Ranking/Statistics/StatisticsPanel.cs     |  2 +-
 17 files changed, 71 insertions(+), 40 deletions(-)

diff --git a/osu.Game.Tests/Beatmaps/IO/ImportBeatmapTest.cs b/osu.Game.Tests/Beatmaps/IO/ImportBeatmapTest.cs
index da414dcf8d..0d973c8aeb 100644
--- a/osu.Game.Tests/Beatmaps/IO/ImportBeatmapTest.cs
+++ b/osu.Game.Tests/Beatmaps/IO/ImportBeatmapTest.cs
@@ -12,7 +12,9 @@ using osu.Framework.Allocation;
 using osu.Framework.Extensions;
 using osu.Game.Beatmaps;
 using osu.Game.Database;
+using osu.Game.Scoring;
 using osu.Game.Tests.Resources;
+using osu.Game.Tests.Scores.IO;
 
 namespace osu.Game.Tests.Beatmaps.IO
 {
@@ -61,6 +63,15 @@ namespace osu.Game.Tests.Beatmaps.IO
             Assert.IsTrue(manager.QueryBeatmapSets(_ => true).First().DeletePending);
         }
 
+        private static Task createScoreForBeatmap(OsuGameBase osu, BeatmapInfo beatmapInfo)
+        {
+            return ImportScoreTest.LoadScoreIntoOsu(osu, new ScoreInfo
+            {
+                OnlineID = 2,
+                BeatmapInfo = beatmapInfo,
+            }, new ImportScoreTest.TestArchiveReader());
+        }
+
         private static void checkBeatmapSetCount(OsuGameBase osu, int expected, bool includeDeletePending = false)
         {
             var manager = osu.Dependencies.Get<BeatmapManager>();
diff --git a/osu.Game.Tests/Resources/TestResources.cs b/osu.Game.Tests/Resources/TestResources.cs
index cd8b031f64..d0ffb9c3db 100644
--- a/osu.Game.Tests/Resources/TestResources.cs
+++ b/osu.Game.Tests/Resources/TestResources.cs
@@ -164,7 +164,6 @@ namespace osu.Game.Tests.Resources
             },
             BeatmapInfo = beatmap,
             Ruleset = beatmap.Ruleset,
-            RulesetID = beatmap.Ruleset.ID ?? 0,
             Mods = new Mod[] { new TestModHardRock(), new TestModDoubleTime() },
             TotalScore = 2845370,
             Accuracy = 0.95,
diff --git a/osu.Game.Tests/Visual/Ranking/TestSceneScorePanelList.cs b/osu.Game.Tests/Visual/Ranking/TestSceneScorePanelList.cs
index f5ad352b9c..e786b85f78 100644
--- a/osu.Game.Tests/Visual/Ranking/TestSceneScorePanelList.cs
+++ b/osu.Game.Tests/Visual/Ranking/TestSceneScorePanelList.cs
@@ -7,6 +7,7 @@ using NUnit.Framework;
 using osu.Framework.Graphics;
 using osu.Framework.Testing;
 using osu.Framework.Utils;
+using osu.Game.Models;
 using osu.Game.Scoring;
 using osu.Game.Screens.Ranking;
 using osu.Game.Tests.Resources;
@@ -157,10 +158,10 @@ namespace osu.Game.Tests.Visual.Ranking
         public void TestSelectMultipleScores()
         {
             var firstScore = TestResources.CreateTestScoreInfo();
-            var secondScore = TestResources.CreateTestScoreInfo();
+            firstScore.RealmUser = new RealmUser { Username = "A" };
 
-            firstScore.UserString = "A";
-            secondScore.UserString = "B";
+            var secondScore = TestResources.CreateTestScoreInfo();
+            secondScore.RealmUser = new RealmUser { Username = "B" };
 
             createListStep(() => new ScorePanelList());
 
@@ -178,7 +179,7 @@ namespace osu.Game.Tests.Visual.Ranking
 
             AddStep("select second score", () =>
             {
-                InputManager.MoveMouseTo(list.ChildrenOfType<ScorePanel>().Single(p => p.Score == secondScore));
+                InputManager.MoveMouseTo(list.ChildrenOfType<ScorePanel>().Single(p => p.Score.Equals(secondScore)));
                 InputManager.Click(MouseButton.Left);
             });
 
@@ -303,6 +304,6 @@ namespace osu.Game.Tests.Visual.Ranking
             => AddUntilStep("first panel centred", () => Precision.AlmostEquals(list.ChildrenOfType<ScorePanel>().First().ScreenSpaceDrawQuad.Centre.X, list.ScreenSpaceDrawQuad.Centre.X, 1));
 
         private void assertScoreState(ScoreInfo score, bool expanded)
-            => AddUntilStep($"score expanded = {expanded}", () => (list.ChildrenOfType<ScorePanel>().Single(p => p.Score == score).State == PanelState.Expanded) == expanded);
+            => AddUntilStep($"score expanded = {expanded}", () => (list.ChildrenOfType<ScorePanel>().Single(p => p.Score.Equals(score)).State == PanelState.Expanded) == expanded);
     }
 }
diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
index 605e03564d..566ee52247 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
@@ -11,6 +11,7 @@ using osu.Framework.Graphics;
 using osu.Framework.Platform;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
+using osu.Game.Database;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Leaderboards;
 using osu.Game.Overlays;
@@ -19,6 +20,7 @@ using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Osu.Mods;
 using osu.Game.Scoring;
 using osu.Game.Screens.Select.Leaderboards;
+using osu.Game.Stores;
 using osu.Game.Tests.Resources;
 using osu.Game.Users;
 using osuTK;
@@ -43,7 +45,7 @@ namespace osu.Game.Tests.Visual.SongSelect
 
             dependencies.Cache(rulesetStore = new RulesetStore(ContextFactory));
             dependencies.Cache(beatmapManager = new BeatmapManager(LocalStorage, ContextFactory, rulesetStore, null, dependencies.Get<AudioManager>(), Resources, dependencies.Get<GameHost>(), Beatmap.Default));
-            dependencies.Cache(scoreManager = new ScoreManager(rulesetStore, () => beatmapManager, LocalStorage, ContextFactory, Scheduler));
+            dependencies.Cache(scoreManager = new ScoreManager(dependencies.Get<RealmRulesetStore>(), () => beatmapManager, LocalStorage, dependencies.Get<RealmContextFactory>(), Scheduler));
 
             return dependencies;
         }
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
index cdb81f059b..1c75ef1895 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
@@ -24,6 +24,7 @@ using osu.Game.Overlays;
 using osu.Game.Rulesets;
 using osu.Game.Scoring;
 using osu.Game.Screens.Select.Leaderboards;
+using osu.Game.Stores;
 using osu.Game.Tests.Resources;
 using osuTK;
 using osuTK.Input;
@@ -85,7 +86,7 @@ namespace osu.Game.Tests.Visual.UserInterface
 
             dependencies.Cache(rulesetStore = new RulesetStore(ContextFactory));
             dependencies.Cache(beatmapManager = new BeatmapManager(LocalStorage, ContextFactory, rulesetStore, null, dependencies.Get<AudioManager>(), Resources, dependencies.Get<GameHost>(), Beatmap.Default));
-            dependencies.Cache(scoreManager = new ScoreManager(rulesetStore, () => beatmapManager, LocalStorage, ContextFactory, Scheduler));
+            dependencies.Cache(scoreManager = new ScoreManager(dependencies.Get<RealmRulesetStore>(), () => beatmapManager, LocalStorage, dependencies.Get<RealmContextFactory>(), Scheduler));
 
             beatmapInfo = beatmapManager.Import(new ImportTask(TestResources.GetQuickTestBeatmapForImport())).GetResultSafely().Value.Beatmaps[0];
 
diff --git a/osu.Game/Online/Leaderboards/LeaderboardScore.cs b/osu.Game/Online/Leaderboards/LeaderboardScore.cs
index 14eec8b388..3eb9a02a5c 100644
--- a/osu.Game/Online/Leaderboards/LeaderboardScore.cs
+++ b/osu.Game/Online/Leaderboards/LeaderboardScore.cs
@@ -399,7 +399,7 @@ namespace osu.Game.Online.Leaderboards
                 if (Score.Files.Count > 0)
                     items.Add(new OsuMenuItem("Export", MenuItemType.Standard, () => new LegacyScoreExporter(storage).Export(Score)));
 
-                if (Score.ID != 0)
+                if (Score.IsManaged)
                     items.Add(new OsuMenuItem("Delete", MenuItemType.Destructive, () => dialogOverlay?.Push(new LocalScoreDeleteDialog(Score))));
 
                 return items.ToArray();
diff --git a/osu.Game/OsuGameBase.cs b/osu.Game/OsuGameBase.cs
index c4dcc35b8e..89e3fe5742 100644
--- a/osu.Game/OsuGameBase.cs
+++ b/osu.Game/OsuGameBase.cs
@@ -224,7 +224,7 @@ namespace osu.Game
             dependencies.Cache(RulesetStore = new RulesetStore(realmFactory, Storage));
 
             // ordering is important here to ensure foreign keys rules are not broken in ModelStore.Cleanup()
-            dependencies.Cache(ScoreManager = new ScoreManager(RulesetStore, () => BeatmapManager, Storage, API, realmFactory, Scheduler, Host, () => difficultyCache, LocalConfig));
+            dependencies.Cache(ScoreManager = new ScoreManager(RulesetStore, () => BeatmapManager, Storage, realmFactory, Scheduler, Host, () => difficultyCache, LocalConfig));
             dependencies.Cache(BeatmapManager = new BeatmapManager(Storage, realmFactory, RulesetStore, API, Audio, Resources, Host, defaultBeatmap, performOnlineLookups: true));
 
             dependencies.Cache(BeatmapDownloader = new BeatmapModelDownloader(BeatmapManager, API));
diff --git a/osu.Game/Overlays/BeatmapSet/Scores/TopScoreStatisticsSection.cs b/osu.Game/Overlays/BeatmapSet/Scores/TopScoreStatisticsSection.cs
index 630aa8fe53..d659df21c6 100644
--- a/osu.Game/Overlays/BeatmapSet/Scores/TopScoreStatisticsSection.cs
+++ b/osu.Game/Overlays/BeatmapSet/Scores/TopScoreStatisticsSection.cs
@@ -107,7 +107,7 @@ namespace osu.Game.Overlays.BeatmapSet.Scores
         {
             set
             {
-                if (score == value)
+                if (score.Equals(value))
                     return;
 
                 score = value;
@@ -115,7 +115,7 @@ namespace osu.Game.Overlays.BeatmapSet.Scores
                 accuracyColumn.Text = value.DisplayAccuracy;
                 maxComboColumn.Text = value.MaxCombo.ToLocalisableString(@"0\x");
 
-                ppColumn.Alpha = value.BeatmapInfo?.Status.GrantsPerformancePoints() == true ? 1 : 0;
+                ppColumn.Alpha = value.BeatmapInfo.Status.GrantsPerformancePoints() ? 1 : 0;
                 ppColumn.Text = value.PP?.ToLocalisableString(@"N0");
 
                 statisticsColumns.ChildrenEnumerable = value.GetStatisticsForDisplay().Select(createStatisticsColumn);
diff --git a/osu.Game/Scoring/Legacy/LegacyScoreEncoder.cs b/osu.Game/Scoring/Legacy/LegacyScoreEncoder.cs
index 3d67aa9558..2902ff7848 100644
--- a/osu.Game/Scoring/Legacy/LegacyScoreEncoder.cs
+++ b/osu.Game/Scoring/Legacy/LegacyScoreEncoder.cs
@@ -45,8 +45,8 @@ namespace osu.Game.Scoring.Legacy
                 sw.Write((byte)(score.ScoreInfo.Ruleset.OnlineID));
                 sw.Write(LATEST_VERSION);
                 sw.Write(score.ScoreInfo.BeatmapInfo.MD5Hash);
-                sw.Write(score.ScoreInfo.UserString);
-                sw.Write(FormattableString.Invariant($"lazer-{score.ScoreInfo.UserString}-{score.ScoreInfo.Date}").ComputeMD5Hash());
+                sw.Write(score.ScoreInfo.User.Username);
+                sw.Write(FormattableString.Invariant($"lazer-{score.ScoreInfo.User.Username}-{score.ScoreInfo.Date}").ComputeMD5Hash());
                 sw.Write((ushort)(score.ScoreInfo.GetCount300() ?? 0));
                 sw.Write((ushort)(score.ScoreInfo.GetCount100() ?? 0));
                 sw.Write((ushort)(score.ScoreInfo.GetCount50() ?? 0));
diff --git a/osu.Game/Scoring/LegacyDatabasedScore.cs b/osu.Game/Scoring/LegacyDatabasedScore.cs
index ac444c1bf3..6a8e5f8930 100644
--- a/osu.Game/Scoring/LegacyDatabasedScore.cs
+++ b/osu.Game/Scoring/LegacyDatabasedScore.cs
@@ -6,14 +6,14 @@ using System.Linq;
 using osu.Framework.IO.Stores;
 using osu.Game.Beatmaps;
 using osu.Game.Extensions;
-using osu.Game.Rulesets;
 using osu.Game.Scoring.Legacy;
+using osu.Game.Stores;
 
 namespace osu.Game.Scoring
 {
     public class LegacyDatabasedScore : Score
     {
-        public LegacyDatabasedScore(ScoreInfo score, RulesetStore rulesets, BeatmapManager beatmaps, IResourceStore<byte[]> store)
+        public LegacyDatabasedScore(ScoreInfo score, RealmRulesetStore rulesets, BeatmapManager beatmaps, IResourceStore<byte[]> store)
         {
             ScoreInfo = score;
 
diff --git a/osu.Game/Scoring/ScoreInfo.cs b/osu.Game/Scoring/ScoreInfo.cs
index 782fe0681b..21339acd22 100644
--- a/osu.Game/Scoring/ScoreInfo.cs
+++ b/osu.Game/Scoring/ScoreInfo.cs
@@ -12,6 +12,7 @@ using osu.Game.Beatmaps;
 using osu.Game.Database;
 using osu.Game.Models;
 using osu.Game.Online.API;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Scoring;
@@ -44,14 +45,27 @@ namespace osu.Game.Scoring
         [MapTo("User")]
         public RealmUser RealmUser { get; set; } = null!;
 
-        public IUser User
+        // TODO: this is a bit temporary to account for the fact that this class is used to ferry API user data to certain UI components.
+        // Eventually we should either persist enough information to realm to not require the API lookups, or perform the API lookups locally.
+        private APIUser? user;
+
+        public APIUser User
         {
-            get => RealmUser;
-            set => RealmUser = new RealmUser
+            get => user ??= new APIUser
             {
-                OnlineID = value.OnlineID,
-                Username = value.Username
+                Username = RealmUser.Username,
+                Id = RealmUser.OnlineID,
             };
+            set
+            {
+                user = value;
+
+                RealmUser = new RealmUser
+                {
+                    OnlineID = user.OnlineID,
+                    Username = user.Username
+                };
+            }
         }
 
         public long TotalScore { get; set; }
@@ -72,6 +86,7 @@ namespace osu.Game.Scoring
         {
             get => new BeatmapInfo();
             // .. todo
+            // ReSharper disable once ValueParameterNotUsed
             set => Beatmap = new RealmBeatmap(new RealmRuleset("osu", "osu!", "wangs", 0), new RealmBeatmapDifficulty(), new RealmBeatmapMetadata());
         }
 
@@ -89,6 +104,8 @@ namespace osu.Game.Scoring
 
                 return JsonConvert.DeserializeObject<Dictionary<HitResult, int>>(StatisticsJson) ?? new Dictionary<HitResult, int>();
             }
+            // .. todo
+            // ReSharper disable once ValueParameterNotUsed
             set => JsonConvert.SerializeObject(StatisticsJson);
         }
 
diff --git a/osu.Game/Scoring/ScoreManager.cs b/osu.Game/Scoring/ScoreManager.cs
index 740c46387e..7adc70dab0 100644
--- a/osu.Game/Scoring/ScoreManager.cs
+++ b/osu.Game/Scoring/ScoreManager.cs
@@ -20,6 +20,7 @@ using osu.Game.Overlays.Notifications;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Judgements;
 using osu.Game.Rulesets.Scoring;
+using osu.Game.Stores;
 
 namespace osu.Game.Scoring
 {
@@ -37,7 +38,7 @@ namespace osu.Game.Scoring
             this.difficulties = difficulties;
             this.configManager = configManager;
 
-            scoreModelManager = new ScoreModelManager(rulesets, beatmaps, storage, contextFactory, importHost);
+            scoreModelManager = new ScoreModelManager(rulesets, beatmaps, storage, contextFactory);
         }
 
         public Score GetScore(ScoreInfo score) => scoreModelManager.GetScore(score);
@@ -125,8 +126,9 @@ namespace osu.Game.Scoring
         /// <returns>The total score.</returns>
         public async Task<long> GetTotalScoreAsync([NotNull] ScoreInfo score, ScoringMode mode = ScoringMode.Standardised, CancellationToken cancellationToken = default)
         {
-            if (score.Beatmap == null)
-                return score.TotalScore;
+            // TODO: ??
+            // if (score.Beatmap == null)
+            //     return score.TotalScore;
 
             int beatmapMaxCombo;
             double accuracy = score.Accuracy;
@@ -150,7 +152,7 @@ namespace osu.Game.Scoring
                     beatmapMaxCombo = score.Beatmap.MaxCombo.Value;
                 else
                 {
-                    if (score.Beatmap.ID == 0 || difficulties == null)
+                    if (!score.Beatmap.IsManaged || difficulties == null)
                     {
                         // We don't have enough information (max combo) to compute the score, so use the provided score.
                         return score.TotalScore;
diff --git a/osu.Game/Scoring/ScoreModelManager.cs b/osu.Game/Scoring/ScoreModelManager.cs
index 81f80df3ad..dd0ac79873 100644
--- a/osu.Game/Scoring/ScoreModelManager.cs
+++ b/osu.Game/Scoring/ScoreModelManager.cs
@@ -11,7 +11,6 @@ using osu.Framework.Platform;
 using osu.Game.Beatmaps;
 using osu.Game.Database;
 using osu.Game.IO.Archives;
-using osu.Game.Rulesets;
 using osu.Game.Scoring.Legacy;
 using osu.Game.Stores;
 using Realms;
@@ -26,10 +25,10 @@ namespace osu.Game.Scoring
 
         protected override string[] HashableFileTypes => new[] { ".osr" };
 
-        private readonly RulesetStore rulesets;
+        private readonly RealmRulesetStore rulesets;
         private readonly Func<BeatmapManager> beatmaps;
 
-        public ScoreModelManager(RulesetStore rulesets, Func<BeatmapManager> beatmaps, Storage storage, RealmContextFactory contextFactory)
+        public ScoreModelManager(RealmRulesetStore rulesets, Func<BeatmapManager> beatmaps, Storage storage, RealmContextFactory contextFactory)
             : base(storage, contextFactory)
         {
             this.rulesets = rulesets;
diff --git a/osu.Game/Screens/Play/Player.cs b/osu.Game/Screens/Play/Player.cs
index a66026b423..5a443ec48e 100644
--- a/osu.Game/Screens/Play/Player.cs
+++ b/osu.Game/Screens/Play/Player.cs
@@ -226,8 +226,6 @@ namespace osu.Game.Screens.Play
             // ensure the score is in a consistent state with the current player.
             Score.ScoreInfo.BeatmapInfo = Beatmap.Value.BeatmapInfo;
             Score.ScoreInfo.Ruleset = ruleset.RulesetInfo;
-            if (ruleset.RulesetInfo.OnlineID >= 0)
-                Score.ScoreInfo.RulesetID = ruleset.RulesetInfo.OnlineID;
             Score.ScoreInfo.Mods = gameplayMods;
 
             dependencies.CacheAs(GameplayState = new GameplayState(playableBeatmap, ruleset, gameplayMods, Score));
@@ -1045,7 +1043,8 @@ namespace osu.Game.Screens.Play
             //
             // Until we better define the server-side logic behind this, let's not store the online ID to avoid potential unique constraint
             // conflicts across various systems (ie. solo and multiplayer).
-            long? onlineScoreId = score.ScoreInfo.OnlineID;
+            long onlineScoreId = score.ScoreInfo.OnlineID;
+
             score.ScoreInfo.OnlineID = -1;
 
             await scoreManager.Import(score.ScoreInfo, replayReader).ConfigureAwait(false);
diff --git a/osu.Game/Screens/Ranking/Contracted/ContractedPanelMiddleContent.cs b/osu.Game/Screens/Ranking/Contracted/ContractedPanelMiddleContent.cs
index 20c603295b..f9aff28bef 100644
--- a/osu.Game/Screens/Ranking/Contracted/ContractedPanelMiddleContent.cs
+++ b/osu.Game/Screens/Ranking/Contracted/ContractedPanelMiddleContent.cs
@@ -107,7 +107,7 @@ namespace osu.Game.Screens.Ranking.Contracted
                                         {
                                             Anchor = Anchor.TopCentre,
                                             Origin = Anchor.TopCentre,
-                                            Text = score.UserString,
+                                            Text = score.RealmUser.Username,
                                             Font = OsuFont.GetFont(size: 16, weight: FontWeight.SemiBold)
                                         },
                                         new FillFlowContainer
diff --git a/osu.Game/Screens/Ranking/ScorePanelList.cs b/osu.Game/Screens/Ranking/ScorePanelList.cs
index eb91c256c7..7f270b3a2a 100644
--- a/osu.Game/Screens/Ranking/ScorePanelList.cs
+++ b/osu.Game/Screens/Ranking/ScorePanelList.cs
@@ -158,7 +158,7 @@ namespace osu.Game.Screens.Ranking
 
                             trackingContainer.Show();
 
-                            if (SelectedScore.Value == score)
+                            if (SelectedScore.Value.Equals(score))
                             {
                                 SelectedScore.TriggerChange();
                             }
@@ -185,10 +185,10 @@ namespace osu.Game.Screens.Ranking
         private void selectedScoreChanged(ValueChangedEvent<ScoreInfo> score)
         {
             // avoid contracting panels unnecessarily when TriggerChange is fired manually.
-            if (score.OldValue != score.NewValue)
+            if (!score.OldValue.Equals(score.NewValue))
             {
                 // Contract the old panel.
-                foreach (var t in flow.Where(t => t.Panel.Score == score.OldValue))
+                foreach (var t in flow.Where(t => t.Panel.Score.Equals(score.OldValue)))
                 {
                     t.Panel.State = PanelState.Contracted;
                     t.Margin = new MarginPadding();
@@ -269,7 +269,7 @@ namespace osu.Game.Screens.Ranking
         /// </summary>
         /// <param name="score">The <see cref="ScoreInfo"/> to find the corresponding <see cref="ScorePanel"/> for.</param>
         /// <returns>The <see cref="ScorePanel"/>.</returns>
-        public ScorePanel GetPanelForScore(ScoreInfo score) => flow.Single(t => t.Panel.Score == score).Panel;
+        public ScorePanel GetPanelForScore(ScoreInfo score) => flow.Single(t => t.Panel.Score.Equals(score)).Panel;
 
         /// <summary>
         /// Detaches a <see cref="ScorePanel"/> from its <see cref="ScorePanelTrackingContainer"/>, allowing the panel to be moved elsewhere in the hierarchy.
@@ -332,13 +332,13 @@ namespace osu.Game.Screens.Ranking
         {
             public override IEnumerable<Drawable> FlowingChildren => applySorting(AliveInternalChildren);
 
-            public int GetPanelIndex(ScoreInfo score) => applySorting(Children).TakeWhile(s => s.Panel.Score != score).Count();
+            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 != 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 != 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)
diff --git a/osu.Game/Screens/Ranking/Statistics/StatisticsPanel.cs b/osu.Game/Screens/Ranking/Statistics/StatisticsPanel.cs
index 26dc3165f8..827e128467 100644
--- a/osu.Game/Screens/Ranking/Statistics/StatisticsPanel.cs
+++ b/osu.Game/Screens/Ranking/Statistics/StatisticsPanel.cs
@@ -142,7 +142,7 @@ namespace osu.Game.Screens.Ranking.Statistics
 
                     LoadComponentAsync(rows, d =>
                     {
-                        if (Score.Value != newScore)
+                        if (!Score.Value.Equals(newScore))
                             return;
 
                         spinner.Hide();

From 4f6a05ce3dff9a71275555b188e0b48eb664f149 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 13 Dec 2021 19:01:20 +0900
Subject: [PATCH 2024/5547] Reimplement all query methods

---
 osu.Game.Tests/Scores/IO/ImportScoreTest.cs   |  4 +-
 .../SongSelect/TestSceneBeatmapLeaderboard.cs |  2 +-
 .../TestSceneDeleteLocalScore.cs              | 10 ++++-
 osu.Game/OsuGame.cs                           |  4 +-
 .../Sections/Maintenance/GeneralSettings.cs   |  2 +-
 osu.Game/Scoring/ScoreManager.cs              | 31 +++++++++++---
 .../Select/BeatmapClearScoresDialog.cs        |  9 ++---
 .../Screens/Select/Carousel/TopLocalRank.cs   | 20 +++++++---
 .../Select/Leaderboards/BeatmapLeaderboard.cs | 40 +++++++++++--------
 9 files changed, 81 insertions(+), 41 deletions(-)

diff --git a/osu.Game.Tests/Scores/IO/ImportScoreTest.cs b/osu.Game.Tests/Scores/IO/ImportScoreTest.cs
index bbc92b7817..f00fb97dfa 100644
--- a/osu.Game.Tests/Scores/IO/ImportScoreTest.cs
+++ b/osu.Game.Tests/Scores/IO/ImportScoreTest.cs
@@ -142,7 +142,7 @@ namespace osu.Game.Tests.Scores.IO
                     var scoreManager = osu.Dependencies.Get<ScoreManager>();
 
                     beatmapManager.Delete(beatmapManager.QueryBeatmapSet(s => s.Beatmaps.Any(b => b.ID == imported.BeatmapInfo.ID)));
-                    Assert.That(scoreManager.Query(s => s.Equals(imported)).DeletePending, Is.EqualTo(true));
+                    Assert.That(scoreManager.Query(s => s.Equals(imported)).Value.DeletePending, Is.EqualTo(true));
 
                     var secondImport = await LoadScoreIntoOsu(osu, imported);
                     Assert.That(secondImport, Is.Null);
@@ -187,7 +187,7 @@ namespace osu.Game.Tests.Scores.IO
             var scoreManager = osu.Dependencies.Get<ScoreManager>();
             await scoreManager.Import(score, archive);
 
-            return scoreManager.GetAllUsableScores().FirstOrDefault();
+            return scoreManager.Query(_ => true).Value;
         }
 
         internal class TestArchiveReader : ArchiveReader
diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
index 566ee52247..62b0f10fd8 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
@@ -184,7 +184,7 @@ namespace osu.Game.Tests.Visual.SongSelect
 
         private void clearScores()
         {
-            AddStep("Clear all scores", () => scoreManager.Delete(scoreManager.GetAllUsableScores()));
+            AddStep("Clear all scores", () => scoreManager.Delete());
         }
 
         private void checkCount(int expected) =>
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
index 1c75ef1895..5c4759a466 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
@@ -44,6 +44,9 @@ namespace osu.Game.Tests.Visual.UserInterface
 
         private BeatmapInfo beatmapInfo;
 
+        [Resolved]
+        private RealmContextFactory realmFactory { get; set; }
+
         [Cached]
         private readonly DialogOverlay dialogOverlay;
 
@@ -112,8 +115,11 @@ namespace osu.Game.Tests.Visual.UserInterface
         [SetUp]
         public void Setup() => Schedule(() =>
         {
-            // Due to soft deletions, we can re-use deleted scores between test runs
-            scoreManager.Undelete(scoreManager.QueryScores(s => s.DeletePending).ToList());
+            using (var realm = realmFactory.CreateContext())
+            {
+                // Due to soft deletions, we can re-use deleted scores between test runs
+                scoreManager.Undelete(realm.All<ScoreInfo>().Where(s => s.DeletePending).ToList());
+            }
 
             leaderboard.Scores = null;
             leaderboard.FinishTransforms(true); // After setting scores, we may be waiting for transforms to expire drawables
diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index 4539409d4c..49893a6d36 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -488,10 +488,10 @@ namespace osu.Game
             ScoreInfo databasedScoreInfo = null;
 
             if (score.OnlineID > 0)
-                databasedScoreInfo = ScoreManager.Query(s => s.OnlineID == score.OnlineID);
+                databasedScoreInfo = ScoreManager.Query(s => s.OnlineID == score.OnlineID)?.Value;
 
             if (score is ScoreInfo scoreInfo)
-                databasedScoreInfo ??= ScoreManager.Query(s => s.Hash == scoreInfo.Hash);
+                databasedScoreInfo ??= ScoreManager.Query(s => s.Hash == scoreInfo.Hash)?.Value;
 
             if (databasedScoreInfo == null)
             {
diff --git a/osu.Game/Overlays/Settings/Sections/Maintenance/GeneralSettings.cs b/osu.Game/Overlays/Settings/Sections/Maintenance/GeneralSettings.cs
index 98ccbf85fd..51e4d61d2e 100644
--- a/osu.Game/Overlays/Settings/Sections/Maintenance/GeneralSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Maintenance/GeneralSettings.cs
@@ -80,7 +80,7 @@ namespace osu.Game.Overlays.Settings.Sections.Maintenance
                     dialogOverlay?.Push(new MassDeleteConfirmationDialog(() =>
                     {
                         deleteScoresButton.Enabled.Value = false;
-                        Task.Run(() => scores.Delete(scores.GetAllUsableScores())).ContinueWith(t => Schedule(() => deleteScoresButton.Enabled.Value = true));
+                        Task.Run(() => scores.Delete()).ContinueWith(t => Schedule(() => deleteScoresButton.Enabled.Value = true));
                     }));
                 }
             });
diff --git a/osu.Game/Scoring/ScoreManager.cs b/osu.Game/Scoring/ScoreManager.cs
index 7adc70dab0..d094e1f45c 100644
--- a/osu.Game/Scoring/ScoreManager.cs
+++ b/osu.Game/Scoring/ScoreManager.cs
@@ -26,6 +26,7 @@ namespace osu.Game.Scoring
 {
     public class ScoreManager : IModelManager<ScoreInfo>, IModelImporter<ScoreInfo>
     {
+        private readonly RealmContextFactory contextFactory;
         private readonly Scheduler scheduler;
         private readonly Func<BeatmapDifficultyCache> difficulties;
         private readonly OsuConfigManager configManager;
@@ -34,6 +35,7 @@ namespace osu.Game.Scoring
         public ScoreManager(RulesetStore rulesets, Func<BeatmapManager> beatmaps, Storage storage, RealmContextFactory contextFactory, Scheduler scheduler,
                             IIpcHost importHost = null, Func<BeatmapDifficultyCache> difficulties = null, OsuConfigManager configManager = null)
         {
+            this.contextFactory = contextFactory;
             this.scheduler = scheduler;
             this.difficulties = difficulties;
             this.configManager = configManager;
@@ -43,11 +45,16 @@ namespace osu.Game.Scoring
 
         public Score GetScore(ScoreInfo score) => scoreModelManager.GetScore(score);
 
-        public List<ScoreInfo> GetAllUsableScores() => scoreModelManager.GetAllUsableScores();
-
-        public IEnumerable<ScoreInfo> QueryScores(Expression<Func<ScoreInfo, bool>> query) => scoreModelManager.QueryScores(query);
-
-        public ScoreInfo Query(Expression<Func<ScoreInfo, bool>> query) => scoreModelManager.Query(query);
+        /// <summary>
+        /// Perform a lookup query on available <see cref="ScoreInfo"/>s.
+        /// </summary>
+        /// <param name="query">The query.</param>
+        /// <returns>The first result for the provided query, or null if no results were found.</returns>
+        public ILive<ScoreInfo> Query(Expression<Func<ScoreInfo, bool>> query)
+        {
+            using (var context = contextFactory.CreateContext())
+                return context.All<ScoreInfo>().FirstOrDefault(query)?.ToLive();
+        }
 
         /// <summary>
         /// Orders an array of <see cref="ScoreInfo"/>s by total score.
@@ -267,6 +274,20 @@ namespace osu.Game.Scoring
             return scoreModelManager.Delete(item);
         }
 
+        public void Delete([CanBeNull] Expression<Func<ScoreInfo, bool>> filter = null, bool silent = false)
+        {
+            using (var context = contextFactory.CreateContext())
+            {
+                var items = context.All<ScoreInfo>()
+                                   .Where(s => !s.DeletePending);
+
+                if (filter != null)
+                    items = items.Where(filter);
+
+                scoreModelManager.Delete(items.ToList(), silent);
+            }
+        }
+
         public void Delete(List<ScoreInfo> items, bool silent = false)
         {
             scoreModelManager.Delete(items, silent);
diff --git a/osu.Game/Screens/Select/BeatmapClearScoresDialog.cs b/osu.Game/Screens/Select/BeatmapClearScoresDialog.cs
index 4970db8955..afae858b46 100644
--- a/osu.Game/Screens/Select/BeatmapClearScoresDialog.cs
+++ b/osu.Game/Screens/Select/BeatmapClearScoresDialog.cs
@@ -1,14 +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 System.Threading.Tasks;
 using osu.Framework.Allocation;
+using osu.Framework.Graphics.Sprites;
 using osu.Game.Beatmaps;
 using osu.Game.Overlays.Dialog;
 using osu.Game.Scoring;
-using System;
-using System.Linq;
-using System.Threading.Tasks;
-using osu.Framework.Graphics.Sprites;
 
 namespace osu.Game.Screens.Select
 {
@@ -29,7 +28,7 @@ namespace osu.Game.Screens.Select
                     Text = @"Yes. Please.",
                     Action = () =>
                     {
-                        Task.Run(() => scoreManager.Delete(scoreManager.QueryScores(s => !s.DeletePending && s.BeatmapInfo.ID == beatmapInfo.ID).ToList()))
+                        Task.Run(() => scoreManager.Delete(s => !s.DeletePending && s.BeatmapInfo.ID == beatmapInfo.ID))
                             .ContinueWith(_ => onCompletion);
                     }
                 },
diff --git a/osu.Game/Screens/Select/Carousel/TopLocalRank.cs b/osu.Game/Screens/Select/Carousel/TopLocalRank.cs
index 34129f232c..a83cb08e1f 100644
--- a/osu.Game/Screens/Select/Carousel/TopLocalRank.cs
+++ b/osu.Game/Screens/Select/Carousel/TopLocalRank.cs
@@ -7,6 +7,7 @@ using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Threading;
 using osu.Game.Beatmaps;
+using osu.Game.Database;
 using osu.Game.Online.API;
 using osu.Game.Online.Leaderboards;
 using osu.Game.Rulesets;
@@ -24,6 +25,9 @@ namespace osu.Game.Screens.Select.Carousel
         [Resolved]
         private IBindable<RulesetInfo> ruleset { get; set; }
 
+        [Resolved]
+        private RealmContextFactory realmFactory { get; set; }
+
         [Resolved]
         private IAPIProvider api { get; set; }
 
@@ -54,7 +58,7 @@ namespace osu.Game.Screens.Select.Carousel
 
         private void fetchAndLoadTopScore()
         {
-            var rank = fetchTopScore()?.Rank;
+            var rank = fetchTopScoreRank();
             scheduledRankUpdate = Schedule(() =>
             {
                 Rank = rank;
@@ -67,14 +71,18 @@ namespace osu.Game.Screens.Select.Carousel
         // We're present if a rank is set, or if there is a pending rank update (IsPresent = true is required for the scheduler to run).
         public override bool IsPresent => base.IsPresent && (Rank != null || scheduledRankUpdate?.Completed == false);
 
-        private ScoreInfo fetchTopScore()
+        private ScoreRank? fetchTopScoreRank()
         {
-            if (scores == null || beatmapInfo == null || ruleset?.Value == null || api?.LocalUser.Value == null)
+            if (realmFactory == null || beatmapInfo == null || ruleset?.Value == null || api?.LocalUser.Value == null)
                 return null;
 
-            return scores.QueryScores(s => s.UserID == api.LocalUser.Value.Id && s.BeatmapInfoID == beatmapInfo.ID && s.RulesetID == ruleset.Value.ID && !s.DeletePending)
-                         .OrderByDescending(s => s.TotalScore)
-                         .FirstOrDefault();
+            using (var realm = realmFactory.CreateContext())
+            {
+                return realm.All<ScoreInfo>().Where(s => s.UserID == api.LocalUser.Value.Id && s.BeatmapInfoID == beatmapInfo.ID && s.RulesetID == ruleset.Value.ID && !s.DeletePending)
+                            .OrderByDescending(s => s.TotalScore)
+                            .FirstOrDefault()
+                            ?.Rank;
+            }
         }
 
         protected override void Dispose(bool isDisposing)
diff --git a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
index 7026f240c8..e47acc5ba7 100644
--- a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
+++ b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
@@ -10,6 +10,7 @@ using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Extensions;
 using osu.Game.Beatmaps;
+using osu.Game.Database;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests;
 using osu.Game.Online.Leaderboards;
@@ -26,6 +27,9 @@ namespace osu.Game.Screens.Select.Leaderboards
         [Resolved]
         private RulesetStore rulesets { get; set; }
 
+        [Resolved]
+        private RealmContextFactory realmFactory { get; set; }
+
         private BeatmapInfo beatmapInfo;
 
         public BeatmapInfo BeatmapInfo
@@ -126,26 +130,28 @@ namespace osu.Game.Screens.Select.Leaderboards
 
             if (Scope == BeatmapLeaderboardScope.Local)
             {
-                var scores = scoreManager
-                    .QueryScores(s => !s.DeletePending && s.BeatmapInfo.ID == fetchBeatmapInfo.ID && s.Ruleset.OnlineID == ruleset.Value.ID);
-
-                if (filterMods && !mods.Value.Any())
+                using (var realm = realmFactory.CreateContext())
                 {
-                    // we need to filter out all scores that have any mods to get all local nomod scores
-                    scores = scores.Where(s => !s.Mods.Any());
-                }
-                else if (filterMods)
-                {
-                    // otherwise find all the scores that have *any* of the currently selected mods (similar to how web applies mod filters)
-                    // we're creating and using a string list representation of selected mods so that it can be translated into the DB query itself
-                    var selectedMods = mods.Value.Select(m => m.Acronym);
-                    scores = scores.Where(s => s.Mods.Any(m => selectedMods.Contains(m.Acronym)));
-                }
+                    var scores = realm.All<ScoreInfo>().Where(s => !s.DeletePending && s.BeatmapInfo.ID == fetchBeatmapInfo.ID && s.Ruleset.OnlineID == ruleset.Value.ID);
 
-                scoreManager.OrderByTotalScoreAsync(scores.ToArray(), cancellationToken)
-                            .ContinueWith(task => scoresCallback?.Invoke(task.GetResultSafely()), TaskContinuationOptions.OnlyOnRanToCompletion);
+                    if (filterMods && !mods.Value.Any())
+                    {
+                        // we need to filter out all scores that have any mods to get all local nomod scores
+                        scores = scores.Where(s => !s.Mods.Any());
+                    }
+                    else if (filterMods)
+                    {
+                        // otherwise find all the scores that have *any* of the currently selected mods (similar to how web applies mod filters)
+                        // we're creating and using a string list representation of selected mods so that it can be translated into the DB query itself
+                        var selectedMods = mods.Value.Select(m => m.Acronym);
+                        scores = scores.Where(s => s.Mods.Any(m => selectedMods.Contains(m.Acronym)));
+                    }
 
-                return null;
+                    scoreManager.OrderByTotalScoreAsync(scores.ToArray(), cancellationToken)
+                                .ContinueWith(ordered => scoresCallback?.Invoke(ordered.Result), TaskContinuationOptions.OnlyOnRanToCompletion);
+
+                    return null;
+                }
             }
 
             if (api?.IsLoggedIn != true)

From d70e292828b80790d0282002cfec4ece06db38a0 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 14 Dec 2021 19:46:55 +0900
Subject: [PATCH 2025/5547] Remove old EF classes

---
 osu.Game/Database/ArchiveModelManager.cs      | 838 ------------------
 osu.Game/Database/DatabaseBackedStore.cs      |  52 --
 .../Database/MutableDatabaseBackedStore.cs    | 161 ----
 ...ableDatabaseBackedStoreWithFileIncludes.cs |  27 -
 osu.Game/Stores/RealmArchiveModelManager.cs   |   2 +-
 5 files changed, 1 insertion(+), 1079 deletions(-)
 delete mode 100644 osu.Game/Database/ArchiveModelManager.cs
 delete mode 100644 osu.Game/Database/DatabaseBackedStore.cs
 delete mode 100644 osu.Game/Database/MutableDatabaseBackedStore.cs
 delete mode 100644 osu.Game/Database/MutableDatabaseBackedStoreWithFileIncludes.cs

diff --git a/osu.Game/Database/ArchiveModelManager.cs b/osu.Game/Database/ArchiveModelManager.cs
deleted file mode 100644
index 9c26451d40..0000000000
--- a/osu.Game/Database/ArchiveModelManager.cs
+++ /dev/null
@@ -1,838 +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.IO;
-using System.Linq;
-using System.Threading;
-using System.Threading.Tasks;
-using Humanizer;
-using JetBrains.Annotations;
-using Microsoft.EntityFrameworkCore;
-using osu.Framework.Extensions;
-using osu.Framework.Extensions.IEnumerableExtensions;
-using osu.Framework.Logging;
-using osu.Framework.Platform;
-using osu.Framework.Threading;
-using osu.Game.Extensions;
-using osu.Game.IO;
-using osu.Game.IO.Archives;
-using osu.Game.IPC;
-using osu.Game.Overlays.Notifications;
-
-namespace osu.Game.Database
-{
-    /// <summary>
-    /// Encapsulates a model store class to give it import functionality.
-    /// Adds cross-functionality with <see cref="FileStore"/> to give access to the central file store for the provided model.
-    /// </summary>
-    /// <typeparam name="TModel">The model type.</typeparam>
-    /// <typeparam name="TFileModel">The associated file join type.</typeparam>
-    public abstract class ArchiveModelManager<TModel, TFileModel> : IModelImporter<TModel>, IModelManager<TModel>, IModelFileManager<TModel, TFileModel>
-        where TModel : class, IHasFiles<TFileModel>, IHasPrimaryKey, ISoftDelete
-        where TFileModel : class, INamedFileInfo, IHasPrimaryKey, new()
-    {
-        private const int import_queue_request_concurrency = 1;
-
-        /// <summary>
-        /// The size of a batch import operation before considering it a lower priority operation.
-        /// </summary>
-        private const int low_priority_import_batch_size = 1;
-
-        /// <summary>
-        /// A singleton scheduler shared by all <see cref="ArchiveModelManager{TModel,TFileModel}"/>.
-        /// </summary>
-        /// <remarks>
-        /// This scheduler generally performs IO and CPU intensive work so concurrency is limited harshly.
-        /// It is mainly being used as a queue mechanism for large imports.
-        /// </remarks>
-        private static readonly ThreadedTaskScheduler import_scheduler = new ThreadedTaskScheduler(import_queue_request_concurrency, nameof(ArchiveModelManager<TModel, TFileModel>));
-
-        /// <summary>
-        /// A second scheduler for lower priority imports.
-        /// For simplicity, these will just run in parallel with normal priority imports, but a future refactor would see this implemented via a custom scheduler/queue.
-        /// See https://gist.github.com/peppy/f0e118a14751fc832ca30dd48ba3876b for an incomplete version of this.
-        /// </summary>
-        private static readonly ThreadedTaskScheduler import_scheduler_low_priority = new ThreadedTaskScheduler(import_queue_request_concurrency, nameof(ArchiveModelManager<TModel, TFileModel>));
-
-        public Action<Notification> PostNotification { protected get; set; }
-
-        /// <summary>
-        /// Fired when a new or updated <typeparamref name="TModel"/> becomes available in the database.
-        /// This is not guaranteed to run on the update thread.
-        /// </summary>
-        public event Action<TModel> ItemUpdated;
-
-        /// <summary>
-        /// Fired when a <typeparamref name="TModel"/> is removed from the database.
-        /// This is not guaranteed to run on the update thread.
-        /// </summary>
-        public event Action<TModel> ItemRemoved;
-
-        public virtual IEnumerable<string> HandledExtensions => new[] { @".zip" };
-
-        protected readonly FileStore Files;
-
-        protected readonly IDatabaseContextFactory ContextFactory;
-
-        protected readonly MutableDatabaseBackedStore<TModel> ModelStore;
-
-        // ReSharper disable once NotAccessedField.Local (we should keep a reference to this so it is not finalised)
-        private ArchiveImportIPCChannel ipc;
-
-        protected ArchiveModelManager(Storage storage, IDatabaseContextFactory contextFactory, MutableDatabaseBackedStoreWithFileIncludes<TModel, TFileModel> modelStore, IIpcHost importHost = null)
-        {
-            ContextFactory = contextFactory;
-
-            ModelStore = modelStore;
-            ModelStore.ItemUpdated += item => handleEvent(() => ItemUpdated?.Invoke(item));
-            ModelStore.ItemRemoved += item => handleEvent(() => ItemRemoved?.Invoke(item));
-
-            Files = new FileStore(contextFactory, storage);
-
-            if (importHost != null)
-                ipc = new ArchiveImportIPCChannel(importHost, this);
-
-            ModelStore.Cleanup();
-        }
-
-        /// <summary>
-        /// Import one or more <typeparamref name="TModel"/> items from filesystem <paramref name="paths"/>.
-        /// </summary>
-        /// <remarks>
-        /// This will be treated as a low priority import if more than one path is specified; use <see cref="Import(ImportTask[])"/> to always import at standard priority.
-        /// This will post notifications tracking progress.
-        /// </remarks>
-        /// <param name="paths">One or more archive locations on disk.</param>
-        public Task Import(params string[] paths)
-        {
-            var notification = new ImportProgressNotification();
-
-            PostNotification?.Invoke(notification);
-
-            return Import(notification, paths.Select(p => new ImportTask(p)).ToArray());
-        }
-
-        public Task Import(params ImportTask[] tasks)
-        {
-            var notification = new ImportProgressNotification();
-
-            PostNotification?.Invoke(notification);
-
-            return Import(notification, tasks);
-        }
-
-        public async Task<IEnumerable<ILive<TModel>>> Import(ProgressNotification notification, params ImportTask[] tasks)
-        {
-            if (tasks.Length == 0)
-            {
-                notification.CompletionText = $"No {HumanisedModelName}s were found to import!";
-                notification.State = ProgressNotificationState.Completed;
-                return Enumerable.Empty<ILive<TModel>>();
-            }
-
-            notification.Progress = 0;
-            notification.Text = $"{HumanisedModelName.Humanize(LetterCasing.Title)} import is initialising...";
-
-            int current = 0;
-
-            var imported = new List<ILive<TModel>>();
-
-            bool isLowPriorityImport = tasks.Length > low_priority_import_batch_size;
-
-            try
-            {
-                await Task.WhenAll(tasks.Select(async task =>
-                {
-                    notification.CancellationToken.ThrowIfCancellationRequested();
-
-                    try
-                    {
-                        var model = await Import(task, isLowPriorityImport, notification.CancellationToken).ConfigureAwait(false);
-
-                        lock (imported)
-                        {
-                            if (model != null)
-                                imported.Add(model);
-                            current++;
-
-                            notification.Text = $"Imported {current} of {tasks.Length} {HumanisedModelName}s";
-                            notification.Progress = (float)current / tasks.Length;
-                        }
-                    }
-                    catch (TaskCanceledException)
-                    {
-                        throw;
-                    }
-                    catch (Exception e)
-                    {
-                        Logger.Error(e, $@"Could not import ({task})", LoggingTarget.Database);
-                    }
-                })).ConfigureAwait(false);
-            }
-            catch (OperationCanceledException)
-            {
-                if (imported.Count == 0)
-                {
-                    notification.State = ProgressNotificationState.Cancelled;
-                    return imported;
-                }
-            }
-
-            if (imported.Count == 0)
-            {
-                notification.Text = $"{HumanisedModelName.Humanize(LetterCasing.Title)} import failed!";
-                notification.State = ProgressNotificationState.Cancelled;
-            }
-            else
-            {
-                notification.CompletionText = imported.Count == 1
-                    ? $"Imported {imported.First().Value.GetDisplayString()}!"
-                    : $"Imported {imported.Count} {HumanisedModelName}s!";
-
-                if (imported.Count > 0 && PostImport != null)
-                {
-                    notification.CompletionText += " Click to view.";
-                    notification.CompletionClickAction = () =>
-                    {
-                        PostImport?.Invoke(imported);
-                        return true;
-                    };
-                }
-
-                notification.State = ProgressNotificationState.Completed;
-            }
-
-            return imported;
-        }
-
-        /// <summary>
-        /// Import one <typeparamref name="TModel"/> from the filesystem and delete the file on success.
-        /// Note that this bypasses the UI flow and should only be used for special cases or testing.
-        /// </summary>
-        /// <param name="task">The <see cref="ImportTask"/> containing data about the <typeparamref name="TModel"/> to import.</param>
-        /// <param name="lowPriority">Whether this is a low priority import.</param>
-        /// <param name="cancellationToken">An optional cancellation token.</param>
-        /// <returns>The imported model, if successful.</returns>
-        public async Task<ILive<TModel>> Import(ImportTask task, bool lowPriority = false, CancellationToken cancellationToken = default)
-        {
-            cancellationToken.ThrowIfCancellationRequested();
-
-            ILive<TModel> import;
-            using (ArchiveReader reader = task.GetReader())
-                import = await Import(reader, lowPriority, cancellationToken).ConfigureAwait(false);
-
-            // We may or may not want to delete the file depending on where it is stored.
-            //  e.g. reconstructing/repairing database with items from default storage.
-            // Also, not always a single file, i.e. for LegacyFilesystemReader
-            // TODO: Add a check to prevent files from storage to be deleted.
-            try
-            {
-                if (import != null && File.Exists(task.Path) && ShouldDeleteArchive(task.Path))
-                    File.Delete(task.Path);
-            }
-            catch (Exception e)
-            {
-                LogForModel(import?.Value, $@"Could not delete original file after import ({task})", e);
-            }
-
-            return import;
-        }
-
-        public Action<IEnumerable<ILive<TModel>>> PostImport { protected get; set; }
-
-        /// <summary>
-        /// Silently import an item from an <see cref="ArchiveReader"/>.
-        /// </summary>
-        /// <param name="archive">The archive to be imported.</param>
-        /// <param name="lowPriority">Whether this is a low priority import.</param>
-        /// <param name="cancellationToken">An optional cancellation token.</param>
-        public Task<ILive<TModel>> Import(ArchiveReader archive, bool lowPriority = false, CancellationToken cancellationToken = default)
-        {
-            cancellationToken.ThrowIfCancellationRequested();
-
-            TModel model = null;
-
-            try
-            {
-                model = CreateModel(archive);
-
-                if (model == null)
-                    return Task.FromResult<ILive<TModel>>(null);
-            }
-            catch (TaskCanceledException)
-            {
-                throw;
-            }
-            catch (Exception e)
-            {
-                LogForModel(model, @$"Model creation of {archive.Name} failed.", e);
-                return null;
-            }
-
-            return Import(model, archive, lowPriority, cancellationToken);
-        }
-
-        /// <summary>
-        /// Any file extensions which should be included in hash creation.
-        /// Generally should include all file types which determine the file's uniqueness.
-        /// Large files should be avoided if possible.
-        /// </summary>
-        /// <remarks>
-        /// This is only used by the default hash implementation. If <see cref="ComputeHash"/> is overridden, it will not be used.
-        /// </remarks>
-        protected abstract string[] HashableFileTypes { get; }
-
-        internal static void LogForModel(TModel model, string message, Exception e = null)
-        {
-            string prefix = $"[{(model?.Hash ?? "?????").Substring(0, 5)}]";
-
-            if (e != null)
-                Logger.Error(e, $"{prefix} {message}", LoggingTarget.Database);
-            else
-                Logger.Log($"{prefix} {message}", LoggingTarget.Database);
-        }
-
-        /// <summary>
-        /// Whether the implementation overrides <see cref="ComputeHash"/> with a custom implementation.
-        /// Custom hash implementations must bypass the early exit in the import flow (see <see cref="computeHashFast"/> usage).
-        /// </summary>
-        protected virtual bool HasCustomHashFunction => false;
-
-        /// <summary>
-        /// Create a SHA-2 hash from the provided archive based on file content of all files matching <see cref="HashableFileTypes"/>.
-        /// </summary>
-        /// <remarks>
-        ///  In the case of no matching files, a hash will be generated from the passed archive's <see cref="ArchiveReader.Name"/>.
-        /// </remarks>
-        protected virtual string ComputeHash(TModel item)
-        {
-            var hashableFiles = item.Files
-                                    .Where(f => HashableFileTypes.Any(ext => f.Filename.EndsWith(ext, StringComparison.OrdinalIgnoreCase)))
-                                    .OrderBy(f => f.Filename)
-                                    .ToArray();
-
-            if (hashableFiles.Length > 0)
-            {
-                // for now, concatenate all hashable files in the set to create a unique hash.
-                MemoryStream hashable = new MemoryStream();
-
-                foreach (TFileModel file in hashableFiles)
-                {
-                    using (Stream s = Files.Store.GetStream(file.FileInfo.GetStoragePath()))
-                        s.CopyTo(hashable);
-                }
-
-                if (hashable.Length > 0)
-                    return hashable.ComputeSHA2Hash();
-            }
-
-            return generateFallbackHash();
-        }
-
-        /// <summary>
-        /// Silently import an item from a <typeparamref name="TModel"/>.
-        /// </summary>
-        /// <param name="item">The model to be imported.</param>
-        /// <param name="archive">An optional archive to use for model population.</param>
-        /// <param name="lowPriority">Whether this is a low priority import.</param>
-        /// <param name="cancellationToken">An optional cancellation token.</param>
-        public virtual async Task<ILive<TModel>> Import(TModel item, ArchiveReader archive = null, bool lowPriority = false, CancellationToken cancellationToken = default) => await Task.Factory.StartNew(async () =>
-        {
-            cancellationToken.ThrowIfCancellationRequested();
-
-            bool checkedExisting = false;
-            TModel existing = null;
-
-            if (archive != null && !HasCustomHashFunction)
-            {
-                // this is a fast bail condition to improve large import performance.
-                item.Hash = computeHashFast(archive);
-
-                checkedExisting = true;
-                existing = CheckForExisting(item);
-
-                if (existing != null)
-                {
-                    // bare minimum comparisons
-                    //
-                    // note that this should really be checking filesizes on disk (of existing files) for some degree of sanity.
-                    // or alternatively doing a faster hash check. either of these require database changes and reprocessing of existing files.
-                    if (CanSkipImport(existing, item) &&
-                        getFilenames(existing.Files).SequenceEqual(getShortenedFilenames(archive).Select(p => p.shortened).OrderBy(f => f)))
-                    {
-                        LogForModel(item, @$"Found existing (optimised) {HumanisedModelName} for {item} (ID {existing.ID}) – skipping import.");
-                        Undelete(existing);
-                        return existing.ToEntityFrameworkLive();
-                    }
-
-                    LogForModel(item, @"Found existing (optimised) but failed pre-check.");
-                }
-            }
-
-            void rollback()
-            {
-                if (!Delete(item))
-                {
-                    // We may have not yet added the model to the underlying table, but should still clean up files.
-                    LogForModel(item, @"Dereferencing files for incomplete import.");
-                    Files.Dereference(item.Files.Select(f => f.FileInfo).ToArray());
-                }
-            }
-
-            delayEvents();
-
-            try
-            {
-                LogForModel(item, @"Beginning import...");
-
-                if (archive != null)
-                    item.Files.AddRange(createFileInfos(archive, Files));
-                item.Hash = ComputeHash(item);
-
-                await Populate(item, archive, cancellationToken).ConfigureAwait(false);
-
-                using (var write = ContextFactory.GetForWrite()) // used to share a context for full import. keep in mind this will block all writes.
-                {
-                    try
-                    {
-                        if (!write.IsTransactionLeader) throw new InvalidOperationException(@$"Ensure there is no parent transaction so errors can correctly be handled by {this}");
-
-                        if (!checkedExisting)
-                            existing = CheckForExisting(item);
-
-                        if (existing != null)
-                        {
-                            if (CanReuseExisting(existing, item))
-                            {
-                                Undelete(existing);
-                                LogForModel(item, @$"Found existing {HumanisedModelName} for {item} (ID {existing.ID}) – skipping import.");
-                                // existing item will be used; rollback new import and exit early.
-                                rollback();
-                                flushEvents(true);
-                                return existing.ToEntityFrameworkLive();
-                            }
-
-                            LogForModel(item, @"Found existing but failed re-use check.");
-                            Delete(existing);
-                            ModelStore.PurgeDeletable(s => s.ID == existing.ID);
-                        }
-
-                        PreImport(item);
-
-                        // import to store
-                        ModelStore.Add(item);
-                    }
-                    catch (Exception e)
-                    {
-                        write.Errors.Add(e);
-                        throw;
-                    }
-                }
-
-                LogForModel(item, @"Import successfully completed!");
-            }
-            catch (Exception e)
-            {
-                if (!(e is TaskCanceledException))
-                    LogForModel(item, @"Database import or population failed and has been rolled back.", e);
-
-                rollback();
-                flushEvents(false);
-                throw;
-            }
-
-            flushEvents(true);
-            return item.ToEntityFrameworkLive();
-        }, cancellationToken, TaskCreationOptions.HideScheduler, lowPriority ? import_scheduler_low_priority : import_scheduler).Unwrap().ConfigureAwait(false);
-
-        /// <summary>
-        /// Replace an existing file with a new version.
-        /// </summary>
-        /// <param name="model">The item to operate on.</param>
-        /// <param name="file">The existing file to be replaced.</param>
-        /// <param name="contents">The new file contents.</param>
-        public void ReplaceFile(TModel model, TFileModel file, Stream contents)
-        {
-            using (ContextFactory.GetForWrite())
-            {
-                DeleteFile(model, file);
-                AddFile(model, contents, file.Filename);
-            }
-        }
-
-        /// <summary>
-        /// Delete an existing file.
-        /// </summary>
-        /// <param name="model">The item to operate on.</param>
-        /// <param name="file">The existing file to be deleted.</param>
-        public void DeleteFile(TModel model, TFileModel file)
-        {
-            using (var usage = ContextFactory.GetForWrite())
-            {
-                // Dereference the existing file info, since the file model will be removed.
-                if (file.FileInfo != null)
-                {
-                    Files.Dereference(file.FileInfo);
-
-                    if (file.IsManaged)
-                    {
-                        // This shouldn't be required, but here for safety in case the provided TModel is not being change tracked
-                        // Definitely can be removed once we rework the database backend.
-                        usage.Context.Set<TFileModel>().Remove(file);
-                    }
-                }
-
-                model.Files.Remove(file);
-            }
-        }
-
-        /// <summary>
-        /// Add a new file.
-        /// </summary>
-        /// <param name="model">The item to operate on.</param>
-        /// <param name="contents">The new file contents.</param>
-        /// <param name="filename">The filename for the new file.</param>
-        public void AddFile(TModel model, Stream contents, string filename)
-        {
-            using (ContextFactory.GetForWrite())
-            {
-                model.Files.Add(new TFileModel
-                {
-                    Filename = filename,
-                    FileInfo = Files.Add(contents)
-                });
-            }
-
-            if (model.IsManaged)
-                Update(model);
-        }
-
-        /// <summary>
-        /// Perform an update of the specified item.
-        /// TODO: Support file additions/removals.
-        /// </summary>
-        /// <param name="item">The item to update.</param>
-        public void Update(TModel item)
-        {
-            using (ContextFactory.GetForWrite())
-            {
-                item.Hash = ComputeHash(item);
-                ModelStore.Update(item);
-            }
-        }
-
-        /// <summary>
-        /// Delete an item from the manager.
-        /// Is a no-op for already deleted items.
-        /// </summary>
-        /// <param name="item">The item to delete.</param>
-        /// <returns>false if no operation was performed</returns>
-        public bool Delete(TModel item)
-        {
-            using (ContextFactory.GetForWrite())
-            {
-                // re-fetch the model on the import context.
-                var foundModel = queryModel().Include(s => s.Files).ThenInclude(f => f.FileInfo).FirstOrDefault(s => s.ID == item.ID);
-
-                if (foundModel == null || foundModel.DeletePending) return false;
-
-                if (ModelStore.Delete(foundModel))
-                    Files.Dereference(foundModel.Files.Select(f => f.FileInfo).ToArray());
-                return true;
-            }
-        }
-
-        /// <summary>
-        /// Delete multiple items.
-        /// This will post notifications tracking progress.
-        /// </summary>
-        public void Delete(List<TModel> items, bool silent = false)
-        {
-            if (items.Count == 0) return;
-
-            var notification = new ProgressNotification
-            {
-                Progress = 0,
-                Text = $"Preparing to delete all {HumanisedModelName}s...",
-                CompletionText = $"Deleted all {HumanisedModelName}s!",
-                State = ProgressNotificationState.Active,
-            };
-
-            if (!silent)
-                PostNotification?.Invoke(notification);
-
-            int i = 0;
-
-            foreach (var b in items)
-            {
-                if (notification.State == ProgressNotificationState.Cancelled)
-                    // user requested abort
-                    return;
-
-                notification.Text = $"Deleting {HumanisedModelName}s ({++i} of {items.Count})";
-
-                Delete(b);
-
-                notification.Progress = (float)i / items.Count;
-            }
-
-            notification.State = ProgressNotificationState.Completed;
-        }
-
-        /// <summary>
-        /// Restore multiple items that were previously deleted.
-        /// This will post notifications tracking progress.
-        /// </summary>
-        public void Undelete(List<TModel> items, bool silent = false)
-        {
-            if (!items.Any()) return;
-
-            var notification = new ProgressNotification
-            {
-                CompletionText = "Restored all deleted items!",
-                Progress = 0,
-                State = ProgressNotificationState.Active,
-            };
-
-            if (!silent)
-                PostNotification?.Invoke(notification);
-
-            int i = 0;
-
-            foreach (var item in items)
-            {
-                if (notification.State == ProgressNotificationState.Cancelled)
-                    // user requested abort
-                    return;
-
-                notification.Text = $"Restoring ({++i} of {items.Count})";
-
-                Undelete(item);
-
-                notification.Progress = (float)i / items.Count;
-            }
-
-            notification.State = ProgressNotificationState.Completed;
-        }
-
-        /// <summary>
-        /// Restore an item that was previously deleted. Is a no-op if the item is not in a deleted state, or has its protected flag set.
-        /// </summary>
-        /// <param name="item">The item to restore</param>
-        public void Undelete(TModel item)
-        {
-            using (var usage = ContextFactory.GetForWrite())
-            {
-                usage.Context.ChangeTracker.AutoDetectChangesEnabled = false;
-
-                if (!ModelStore.Undelete(item)) return;
-
-                Files.Reference(item.Files.Select(f => f.FileInfo).ToArray());
-
-                usage.Context.ChangeTracker.AutoDetectChangesEnabled = true;
-            }
-        }
-
-        private string computeHashFast(ArchiveReader reader)
-        {
-            MemoryStream hashable = new MemoryStream();
-
-            foreach (string file in reader.Filenames.Where(f => HashableFileTypes.Any(ext => f.EndsWith(ext, StringComparison.OrdinalIgnoreCase))).OrderBy(f => f))
-            {
-                using (Stream s = reader.GetStream(file))
-                    s.CopyTo(hashable);
-            }
-
-            if (hashable.Length > 0)
-                return hashable.ComputeSHA2Hash();
-
-            return generateFallbackHash();
-        }
-
-        /// <summary>
-        /// Create all required <see cref="IO.FileInfo"/>s for the provided archive, adding them to the global file store.
-        /// </summary>
-        private List<TFileModel> createFileInfos(ArchiveReader reader, FileStore files)
-        {
-            var fileInfos = new List<TFileModel>();
-
-            // import files to manager
-            foreach (var filenames in getShortenedFilenames(reader))
-            {
-                using (Stream s = reader.GetStream(filenames.original))
-                {
-                    fileInfos.Add(new TFileModel
-                    {
-                        Filename = filenames.shortened,
-                        FileInfo = files.Add(s)
-                    });
-                }
-            }
-
-            return fileInfos;
-        }
-
-        private IEnumerable<(string original, string shortened)> getShortenedFilenames(ArchiveReader reader)
-        {
-            string prefix = reader.Filenames.GetCommonPrefix();
-            if (!(prefix.EndsWith('/') || prefix.EndsWith('\\')))
-                prefix = string.Empty;
-
-            // import files to manager
-            foreach (string file in reader.Filenames)
-                yield return (file, file.Substring(prefix.Length).ToStandardisedPath());
-        }
-
-        #region osu-stable import
-
-        /// <summary>
-        /// Whether this specified path should be removed after successful import.
-        /// </summary>
-        /// <param name="path">The path for consideration. May be a file or a directory.</param>
-        /// <returns>Whether to perform deletion.</returns>
-        protected virtual bool ShouldDeleteArchive(string path) => false;
-
-        #endregion
-
-        /// <summary>
-        /// Create a barebones model from the provided archive.
-        /// Actual expensive population should be done in <see cref="Populate"/>; this should just prepare for duplicate checking.
-        /// </summary>
-        /// <param name="archive">The archive to create the model for.</param>
-        /// <returns>A model populated with minimal information. Returning a null will abort importing silently.</returns>
-        protected abstract TModel CreateModel(ArchiveReader archive);
-
-        /// <summary>
-        /// Populate the provided model completely from the given archive.
-        /// After this method, the model should be in a state ready to commit to a store.
-        /// </summary>
-        /// <param name="model">The model to populate.</param>
-        /// <param name="archive">The archive to use as a reference for population. May be null.</param>
-        /// <param name="cancellationToken">An optional cancellation token.</param>
-        protected abstract Task Populate(TModel model, [CanBeNull] ArchiveReader archive, CancellationToken cancellationToken = default);
-
-        /// <summary>
-        /// Perform any final actions before the import to database executes.
-        /// </summary>
-        /// <param name="model">The model prepared for import.</param>
-        protected virtual void PreImport(TModel model)
-        {
-        }
-
-        /// <summary>
-        /// Check whether an existing model already exists for a new import item.
-        /// </summary>
-        /// <param name="model">The new model proposed for import.</param>
-        /// <returns>An existing model which matches the criteria to skip importing, else null.</returns>
-        protected TModel CheckForExisting(TModel model) => model.Hash == null ? null : ModelStore.ConsumableItems.FirstOrDefault(b => b.Hash == model.Hash);
-
-        public bool IsAvailableLocally(TModel model) => CheckLocalAvailability(model, ModelStore.ConsumableItems.Where(m => !m.DeletePending));
-
-        /// <summary>
-        /// Performs implementation specific comparisons to determine whether a given model is present in the local store.
-        /// </summary>
-        /// <param name="model">The <typeparamref name="TModel"/> whose existence needs to be checked.</param>
-        /// <param name="items">The usable items present in the store.</param>
-        /// <returns>Whether the <typeparamref name="TModel"/> exists.</returns>
-        protected virtual bool CheckLocalAvailability(TModel model, IQueryable<TModel> items)
-            => model.IsManaged && items.Any(i => i.ID == model.ID && i.Files.Any());
-
-        /// <summary>
-        /// Whether import can be skipped after finding an existing import early in the process.
-        /// Only valid when <see cref="ComputeHash"/> is not overridden.
-        /// </summary>
-        /// <param name="existing">The existing model.</param>
-        /// <param name="import">The newly imported model.</param>
-        /// <returns>Whether to skip this import completely.</returns>
-        protected virtual bool CanSkipImport(TModel existing, TModel import) => true;
-
-        /// <summary>
-        /// After an existing <typeparamref name="TModel"/> is found during an import process, the default behaviour is to use/restore the existing
-        /// item and skip the import. This method allows changing that behaviour.
-        /// </summary>
-        /// <param name="existing">The existing model.</param>
-        /// <param name="import">The newly imported model.</param>
-        /// <returns>Whether the existing model should be restored and used. Returning false will delete the existing and force a re-import.</returns>
-        protected virtual bool CanReuseExisting(TModel existing, TModel import) =>
-            // for the best or worst, we copy and import files of a new import before checking whether
-            // it is a duplicate. so to check if anything has changed, we can just compare all FileInfo IDs.
-            getIDs(existing.Files).SequenceEqual(getIDs(import.Files)) &&
-            getFilenames(existing.Files).SequenceEqual(getFilenames(import.Files));
-
-        private IEnumerable<long> getIDs(List<TFileModel> files)
-        {
-            foreach (var f in files.OrderBy(f => f.Filename))
-                yield return f.FileInfo.ID;
-        }
-
-        private IEnumerable<string> getFilenames(List<TFileModel> files)
-        {
-            foreach (var f in files.OrderBy(f => f.Filename))
-                yield return f.Filename;
-        }
-
-        private DbSet<TModel> queryModel() => ContextFactory.Get().Set<TModel>();
-
-        public virtual string HumanisedModelName => $"{typeof(TModel).Name.Replace(@"Info", "").ToLower()}";
-
-        #region Event handling / delaying
-
-        private readonly List<Action> queuedEvents = new List<Action>();
-
-        /// <summary>
-        /// Allows delaying of outwards events until an operation is confirmed (at a database level).
-        /// </summary>
-        private bool delayingEvents;
-
-        /// <summary>
-        /// Begin delaying outwards events.
-        /// </summary>
-        private void delayEvents() => delayingEvents = true;
-
-        /// <summary>
-        /// Flush delayed events and disable delaying.
-        /// </summary>
-        /// <param name="perform">Whether the flushed events should be performed.</param>
-        private void flushEvents(bool perform)
-        {
-            Action[] events;
-
-            lock (queuedEvents)
-            {
-                events = queuedEvents.ToArray();
-                queuedEvents.Clear();
-            }
-
-            if (perform)
-            {
-                foreach (var a in events)
-                    a.Invoke();
-            }
-
-            delayingEvents = false;
-        }
-
-        private void handleEvent(Action a)
-        {
-            if (delayingEvents)
-            {
-                lock (queuedEvents)
-                    queuedEvents.Add(a);
-            }
-            else
-                a.Invoke();
-        }
-
-        #endregion
-
-        private static string generateFallbackHash()
-        {
-            // if a hash could no be generated from file content, presume a unique / new import.
-            // therefore, let's use a guaranteed unique hash.
-            // this doesn't follow the SHA2 hashing schema intentionally, so such entries on the data store can be identified.
-            return Guid.NewGuid().ToString();
-        }
-    }
-}
diff --git a/osu.Game/Database/DatabaseBackedStore.cs b/osu.Game/Database/DatabaseBackedStore.cs
deleted file mode 100644
index a37155ee62..0000000000
--- a/osu.Game/Database/DatabaseBackedStore.cs
+++ /dev/null
@@ -1,52 +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.Linq;
-using Microsoft.EntityFrameworkCore;
-using osu.Framework.Platform;
-
-namespace osu.Game.Database
-{
-    public abstract class DatabaseBackedStore
-    {
-        protected readonly Storage Storage;
-
-        protected readonly RealmContextFactory ContextFactory;
-
-        /// <summary>
-        /// Refresh an instance potentially from a different thread with a local context-tracked instance.
-        /// </summary>
-        /// <param name="obj">The object to use as a reference when negotiating a local instance.</param>
-        /// <param name="lookupSource">An optional lookup source which will be used to query and populate a freshly retrieved replacement. If not provided, the refreshed object will still be returned but will not have any includes.</param>
-        /// <typeparam name="T">A valid EF-stored type.</typeparam>
-        protected void Refresh<T>(ref T obj, IQueryable<T> lookupSource = null) where T : class, IHasPrimaryKey
-        {
-            using (var usage = ContextFactory.GetForWrite())
-            {
-                var context = usage.Context;
-
-                if (context.Entry(obj).State != EntityState.Detached) return;
-
-                int id = obj.ID;
-                var foundObject = lookupSource?.SingleOrDefault(t => t.ID == id) ?? context.Find<T>(id);
-                if (foundObject != null)
-                    obj = foundObject;
-                else
-                    context.Add(obj);
-            }
-        }
-
-        protected DatabaseBackedStore(RealmContextFactory contextFactory, Storage storage = null)
-        {
-            ContextFactory = contextFactory;
-            Storage = storage;
-        }
-
-        /// <summary>
-        /// Perform any common clean-up tasks. Should be run when idle, or whenever necessary.
-        /// </summary>
-        public virtual void Cleanup()
-        {
-        }
-    }
-}
diff --git a/osu.Game/Database/MutableDatabaseBackedStore.cs b/osu.Game/Database/MutableDatabaseBackedStore.cs
deleted file mode 100644
index b0feb7bb78..0000000000
--- a/osu.Game/Database/MutableDatabaseBackedStore.cs
+++ /dev/null
@@ -1,161 +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 System.Linq.Expressions;
-using osu.Framework.Platform;
-
-namespace osu.Game.Database
-{
-    /// <summary>
-    /// A typed store which supports basic addition, deletion and updating for soft-deletable models.
-    /// </summary>
-    /// <typeparam name="T">The databased model.</typeparam>
-    public abstract class MutableDatabaseBackedStore<T> : DatabaseBackedStore
-        where T : class, IHasPrimaryKey, ISoftDelete
-    {
-        /// <summary>
-        /// Fired when an item was added or updated.
-        /// </summary>
-        public event Action<T> ItemUpdated;
-
-        /// <summary>
-        /// Fired when an item was removed.
-        /// </summary>
-        public event Action<T> ItemRemoved;
-
-        protected MutableDatabaseBackedStore(IDatabaseContextFactory contextFactory, Storage storage = null)
-            : base(contextFactory, storage)
-        {
-        }
-
-        /// <summary>
-        /// Access items pre-populated with includes for consumption.
-        /// </summary>
-        public IQueryable<T> ConsumableItems => AddIncludesForConsumption(ContextFactory.Get().Set<T>());
-
-        /// <summary>
-        /// Access barebones items with no includes.
-        /// </summary>
-        public IQueryable<T> Items => ContextFactory.Get().Set<T>();
-
-        /// <summary>
-        /// Add a <typeparamref name="T"/> to the database.
-        /// </summary>
-        /// <param name="item">The item to add.</param>
-        public void Add(T item)
-        {
-            using (var usage = ContextFactory.GetForWrite())
-            {
-                var context = usage.Context;
-                context.Attach(item);
-            }
-
-            ItemUpdated?.Invoke(item);
-        }
-
-        /// <summary>
-        /// Update a <typeparamref name="T"/> in the database.
-        /// </summary>
-        /// <param name="item">The item to update.</param>
-        public void Update(T item)
-        {
-            using (var usage = ContextFactory.GetForWrite())
-                usage.Context.Update(item);
-
-            ItemUpdated?.Invoke(item);
-        }
-
-        /// <summary>
-        /// Delete a <typeparamref name="T"/> from the database.
-        /// </summary>
-        /// <param name="item">The item to delete.</param>
-        public bool Delete(T item)
-        {
-            using (ContextFactory.GetForWrite())
-            {
-                Refresh(ref item);
-
-                if (item.DeletePending) return false;
-
-                item.DeletePending = true;
-            }
-
-            ItemRemoved?.Invoke(item);
-            return true;
-        }
-
-        /// <summary>
-        /// Restore a <typeparamref name="T"/> from a deleted state.
-        /// </summary>
-        /// <param name="item">The item to undelete.</param>
-        public bool Undelete(T item)
-        {
-            using (ContextFactory.GetForWrite())
-            {
-                Refresh(ref item, ConsumableItems);
-
-                if (!item.DeletePending) return false;
-
-                item.DeletePending = false;
-            }
-
-            ItemUpdated?.Invoke(item);
-            return true;
-        }
-
-        /// <summary>
-        /// Allow implementations to add database-side includes or constraints when querying for consumption of items.
-        /// </summary>
-        /// <param name="query">The input query.</param>
-        /// <returns>A potentially modified output query.</returns>
-        protected virtual IQueryable<T> AddIncludesForConsumption(IQueryable<T> query) => query;
-
-        /// <summary>
-        /// Allow implementations to add database-side includes or constraints when deleting items.
-        /// Included properties could then be subsequently deleted by overriding <see cref="Purge"/>.
-        /// </summary>
-        /// <param name="query">The input query.</param>
-        /// <returns>A potentially modified output query.</returns>
-        protected virtual IQueryable<T> AddIncludesForDeletion(IQueryable<T> query) => query;
-
-        /// <summary>
-        /// Called when removing an item completely from the database.
-        /// </summary>
-        /// <param name="items">The items to be purged.</param>
-        /// <param name="context">The write context which can be used to perform subsequent deletions.</param>
-        protected virtual void Purge(List<T> items, OsuDbContext context) => context.RemoveRange(items);
-
-        public override void Cleanup()
-        {
-            base.Cleanup();
-            PurgeDeletable();
-        }
-
-        /// <summary>
-        /// Purge items in a pending delete state.
-        /// </summary>
-        /// <param name="query">An optional query limiting the scope of the purge.</param>
-        public void PurgeDeletable(Expression<Func<T, bool>> query = null)
-        {
-            using (var usage = ContextFactory.GetForWrite())
-            {
-                var context = usage.Context;
-
-                var lookup = context.Set<T>().Where(s => s.DeletePending);
-
-                if (query != null) lookup = lookup.Where(query);
-
-                lookup = AddIncludesForDeletion(lookup);
-
-                var purgeable = lookup.ToList();
-
-                if (!purgeable.Any()) return;
-
-                Purge(purgeable, context);
-            }
-        }
-    }
-}
diff --git a/osu.Game/Database/MutableDatabaseBackedStoreWithFileIncludes.cs b/osu.Game/Database/MutableDatabaseBackedStoreWithFileIncludes.cs
deleted file mode 100644
index 102081cd65..0000000000
--- a/osu.Game/Database/MutableDatabaseBackedStoreWithFileIncludes.cs
+++ /dev/null
@@ -1,27 +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.Linq;
-using Microsoft.EntityFrameworkCore;
-using osu.Framework.Platform;
-
-namespace osu.Game.Database
-{
-    public abstract class MutableDatabaseBackedStoreWithFileIncludes<T, TFileInfo> : MutableDatabaseBackedStore<T>
-        where T : class, IHasPrimaryKey, ISoftDelete, IHasFiles<TFileInfo>
-        where TFileInfo : INamedFileInfo
-    {
-        protected MutableDatabaseBackedStoreWithFileIncludes(IDatabaseContextFactory contextFactory, Storage storage = null)
-            : base(contextFactory, storage)
-        {
-        }
-
-        protected override IQueryable<T> AddIncludesForConsumption(IQueryable<T> query) =>
-            base.AddIncludesForConsumption(query)
-                .Include(s => s.Files).ThenInclude(f => f.FileInfo);
-
-        protected override IQueryable<T> AddIncludesForDeletion(IQueryable<T> query) =>
-            base.AddIncludesForDeletion(query)
-                .Include(s => s.Files); // don't include FileInfo. these are handled by the FileStore itself.
-    }
-}
diff --git a/osu.Game/Stores/RealmArchiveModelManager.cs b/osu.Game/Stores/RealmArchiveModelManager.cs
index 87a27cbbbc..7fa8d16882 100644
--- a/osu.Game/Stores/RealmArchiveModelManager.cs
+++ b/osu.Game/Stores/RealmArchiveModelManager.cs
@@ -19,7 +19,7 @@ using Realms;
 namespace osu.Game.Stores
 {
     /// <summary>
-    /// Class which adds all the missing pieces bridging the gap between <see cref="RealmArchiveModelImporter{TModel}"/> and <see cref="ArchiveModelManager{TModel,TFileModel}"/>.
+    /// Class which adds all the missing pieces bridging the gap between <see cref="RealmArchiveModelImporter{TModel}"/> and (legacy) ArchiveModelManager.
     /// </summary>
     public abstract class RealmArchiveModelManager<TModel> : RealmArchiveModelImporter<TModel>, IModelManager<TModel>, IModelFileManager<TModel, RealmNamedFileUsage>
         where TModel : RealmObject, IHasRealmFiles, IHasGuidPrimaryKey, ISoftDelete

From a3da8dc49d416d4008b4a6dc0b4d75e74211d147 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 14 Dec 2021 19:52:54 +0900
Subject: [PATCH 2026/5547] Fix missing interface implementation of
 `IRulesetStore`

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

diff --git a/osu.Game/Rulesets/RulesetStore.cs b/osu.Game/Rulesets/RulesetStore.cs
index de3bb1ac34..6ec89f9dc5 100644
--- a/osu.Game/Rulesets/RulesetStore.cs
+++ b/osu.Game/Rulesets/RulesetStore.cs
@@ -16,7 +16,7 @@ using osu.Game.Database;
 
 namespace osu.Game.Rulesets
 {
-    public class RulesetStore : IDisposable
+    public class RulesetStore : IDisposable, IRulesetStore
     {
         private readonly RealmContextFactory realmFactory;
 
@@ -259,8 +259,8 @@ namespace osu.Game.Rulesets
 
         #region Implementation of IRulesetStore
 
-        IRulesetInfo IRulesetStore.GetRuleset(int id) => GetRuleset(id);
-        IRulesetInfo IRulesetStore.GetRuleset(string shortName) => GetRuleset(shortName);
+        IRulesetInfo? IRulesetStore.GetRuleset(int id) => GetRuleset(id);
+        IRulesetInfo? IRulesetStore.GetRuleset(string shortName) => GetRuleset(shortName);
         IEnumerable<IRulesetInfo> IRulesetStore.AvailableRulesets => AvailableRulesets;
 
         #endregion

From 00e3af3366e80214c7f0c956d144000a78cd0b56 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 14 Dec 2021 19:47:11 +0900
Subject: [PATCH 2027/5547] Update model manager and many related classes to
 get things compiling again

---
 .../Database/BeatmapImporterTests.cs          |  42 +-
 ...eneOnlinePlayBeatmapAvailabilityTracker.cs |   8 +-
 .../Visual/Multiplayer/QueueModeTestScene.cs  |   2 +-
 .../Multiplayer/TestSceneMultiplayer.cs       |   4 +-
 .../TestSceneMultiplayerMatchSubScreen.cs     |   2 +-
 .../TestSceneMultiplayerPlaylist.cs           |   4 +-
 .../TestSceneMultiplayerQueueList.cs          |   4 +-
 .../TestSceneMultiplayerReadyButton.cs        |   2 +-
 .../TestSceneMultiplayerSpectateButton.cs     |   2 +-
 .../TestScenePlaylistsRoomSettingsPlaylist.cs |   4 +-
 .../Visual/Multiplayer/TestSceneTeamVersus.cs |   2 +-
 .../SongSelect/TestSceneBeatmapLeaderboard.cs |   3 +-
 .../TestSceneBeatmapMetadataDisplay.cs        |   2 +-
 .../TestSceneDeleteLocalScore.cs              |   5 +-
 osu.Game/Beatmaps/BeatmapManager.cs           |  28 +-
 osu.Game/Beatmaps/BeatmapModelManager.cs      | 399 +++---------------
 osu.Game/Beatmaps/EFBeatmapSetInfo.cs         |   4 +-
 osu.Game/Beatmaps/FlatFileWorkingBeatmap.cs   |   2 +-
 .../Beatmaps/Formats/LegacyBeatmapDecoder.cs  |   4 +-
 osu.Game/Database/ImportTask.cs               |   3 +-
 osu.Game/Overlays/MusicController.cs          |   2 +-
 osu.Game/Scoring/LegacyDatabasedScore.cs      |   4 +-
 osu.Game/Scoring/ScoreInfo.cs                 |  20 +-
 osu.Game/Scoring/ScoreManager.cs              |   1 -
 osu.Game/Scoring/ScoreModelManager.cs         |   5 +-
 osu.Game/Screens/Menu/IntroScreen.cs          |   4 +-
 osu.Game/Screens/Ranking/SoloResultsScreen.cs |   2 +-
 osu.Game/Screens/Select/BeatmapCarousel.cs    |   2 +-
 .../Carousel/DrawableCarouselBeatmapSet.cs    |  10 +-
 osu.Game/Screens/Select/SongSelect.cs         |   2 +-
 osu.Game/Stores/BeatmapImporter.cs            |   4 +-
 .../Drawables/DrawableStoryboard.cs           |   4 +-
 osu.Game/Tests/Beatmaps/TestBeatmap.cs        |   2 -
 osu.Game/Tests/Visual/EditorTestScene.cs      |   8 +-
 34 files changed, 165 insertions(+), 431 deletions(-)

diff --git a/osu.Game.Tests/Database/BeatmapImporterTests.cs b/osu.Game.Tests/Database/BeatmapImporterTests.cs
index c5dbcf155c..e144f863b0 100644
--- a/osu.Game.Tests/Database/BeatmapImporterTests.cs
+++ b/osu.Game.Tests/Database/BeatmapImporterTests.cs
@@ -40,7 +40,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealmAsync(async (realmFactory, storage) =>
             {
-                using (var importer = new BeatmapImporter(realmFactory, storage))
+                using (var importer = new BeatmapModelManager(realmFactory, storage))
                 using (new RulesetStore(realmFactory, storage))
                 {
                     ILive<BeatmapSetInfo>? imported;
@@ -69,7 +69,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealmAsync(async (realmFactory, storage) =>
             {
-                using var importer = new BeatmapImporter(realmFactory, storage);
+                using var importer = new BeatmapModelManager(realmFactory, storage);
                 using var store = new RulesetStore(realmFactory, storage);
 
                 await LoadOszIntoStore(importer, realmFactory.Context);
@@ -81,7 +81,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealmAsync(async (realmFactory, storage) =>
             {
-                using var importer = new BeatmapImporter(realmFactory, storage);
+                using var importer = new BeatmapModelManager(realmFactory, storage);
                 using var store = new RulesetStore(realmFactory, storage);
 
                 var imported = await LoadOszIntoStore(importer, realmFactory.Context);
@@ -99,7 +99,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealmAsync(async (realmFactory, storage) =>
             {
-                using var importer = new BeatmapImporter(realmFactory, storage);
+                using var importer = new BeatmapModelManager(realmFactory, storage);
                 using var store = new RulesetStore(realmFactory, storage);
 
                 var imported = await LoadOszIntoStore(importer, realmFactory.Context);
@@ -113,7 +113,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealmAsync(async (realmFactory, storage) =>
             {
-                using var importer = new BeatmapImporter(realmFactory, storage);
+                using var importer = new BeatmapModelManager(realmFactory, storage);
                 using var store = new RulesetStore(realmFactory, storage);
 
                 string? tempPath = TestResources.GetTestBeatmapForImport();
@@ -143,7 +143,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealmAsync(async (realmFactory, storage) =>
             {
-                using var importer = new BeatmapImporter(realmFactory, storage);
+                using var importer = new BeatmapModelManager(realmFactory, storage);
                 using var store = new RulesetStore(realmFactory, storage);
 
                 var imported = await LoadOszIntoStore(importer, realmFactory.Context);
@@ -163,7 +163,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealmAsync(async (realmFactory, storage) =>
             {
-                using var importer = new BeatmapImporter(realmFactory, storage);
+                using var importer = new BeatmapModelManager(realmFactory, storage);
                 using var store = new RulesetStore(realmFactory, storage);
 
                 string? temp = TestResources.GetTestBeatmapForImport();
@@ -212,7 +212,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealmAsync(async (realmFactory, storage) =>
             {
-                using var importer = new BeatmapImporter(realmFactory, storage);
+                using var importer = new BeatmapModelManager(realmFactory, storage);
                 using var store = new RulesetStore(realmFactory, storage);
 
                 string? temp = TestResources.GetTestBeatmapForImport();
@@ -264,7 +264,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealmAsync(async (realmFactory, storage) =>
             {
-                using var importer = new BeatmapImporter(realmFactory, storage);
+                using var importer = new BeatmapModelManager(realmFactory, storage);
                 using var store = new RulesetStore(realmFactory, storage);
 
                 string? temp = TestResources.GetTestBeatmapForImport();
@@ -312,7 +312,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealmAsync(async (realmFactory, storage) =>
             {
-                using var importer = new BeatmapImporter(realmFactory, storage);
+                using var importer = new BeatmapModelManager(realmFactory, storage);
                 using var store = new RulesetStore(realmFactory, storage);
 
                 string? temp = TestResources.GetTestBeatmapForImport();
@@ -361,7 +361,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealmAsync(async (realmFactory, storage) =>
             {
-                using var importer = new BeatmapImporter(realmFactory, storage);
+                using var importer = new BeatmapModelManager(realmFactory, storage);
                 using var store = new RulesetStore(realmFactory, storage);
 
                 var imported = await LoadOszIntoStore(importer, realmFactory.Context);
@@ -394,7 +394,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealmAsync(async (realmFactory, storage) =>
             {
-                using var importer = new BeatmapImporter(realmFactory, storage);
+                using var importer = new BeatmapModelManager(realmFactory, storage);
                 using var store = new RulesetStore(realmFactory, storage);
 
                 var progressNotification = new ImportProgressNotification();
@@ -430,7 +430,7 @@ namespace osu.Game.Tests.Database
                         Interlocked.Increment(ref loggedExceptionCount);
                 };
 
-                using var importer = new BeatmapImporter(realmFactory, storage);
+                using var importer = new BeatmapModelManager(realmFactory, storage);
                 using var store = new RulesetStore(realmFactory, storage);
 
                 var imported = await LoadOszIntoStore(importer, realmFactory.Context);
@@ -480,7 +480,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealmAsync(async (realmFactory, storage) =>
             {
-                using var importer = new BeatmapImporter(realmFactory, storage);
+                using var importer = new BeatmapModelManager(realmFactory, storage);
                 using var store = new RulesetStore(realmFactory, storage);
 
                 var imported = await LoadOszIntoStore(importer, realmFactory.Context);
@@ -528,7 +528,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealmAsync(async (realmFactory, storage) =>
             {
-                using var importer = new BeatmapImporter(realmFactory, storage);
+                using var importer = new BeatmapModelManager(realmFactory, storage);
                 using var store = new RulesetStore(realmFactory, storage);
 
                 var imported = await LoadOszIntoStore(importer, realmFactory.Context);
@@ -554,7 +554,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealmAsync(async (realmFactory, storage) =>
             {
-                using var importer = new BeatmapImporter(realmFactory, storage);
+                using var importer = new BeatmapModelManager(realmFactory, storage);
                 using var store = new RulesetStore(realmFactory, storage);
 
                 var metadata = new BeatmapMetadata
@@ -600,7 +600,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealmAsync(async (realmFactory, storage) =>
             {
-                using var importer = new BeatmapImporter(realmFactory, storage);
+                using var importer = new BeatmapModelManager(realmFactory, storage);
                 using var store = new RulesetStore(realmFactory, storage);
 
                 string? temp = TestResources.GetTestBeatmapForImport();
@@ -617,7 +617,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealmAsync(async (realmFactory, storage) =>
             {
-                using var importer = new BeatmapImporter(realmFactory, storage);
+                using var importer = new BeatmapModelManager(realmFactory, storage);
                 using var store = new RulesetStore(realmFactory, storage);
 
                 string? temp = TestResources.GetTestBeatmapForImport();
@@ -653,7 +653,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealmAsync(async (realmFactory, storage) =>
             {
-                using var importer = new BeatmapImporter(realmFactory, storage);
+                using var importer = new BeatmapModelManager(realmFactory, storage);
                 using var store = new RulesetStore(realmFactory, storage);
 
                 string? temp = TestResources.GetTestBeatmapForImport();
@@ -695,7 +695,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealmAsync(async (realmFactory, storage) =>
             {
-                using var importer = new BeatmapImporter(realmFactory, storage);
+                using var importer = new BeatmapModelManager(realmFactory, storage);
                 using var store = new RulesetStore(realmFactory, storage);
 
                 string? temp = TestResources.GetTestBeatmapForImport();
@@ -746,7 +746,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealmAsync(async (realmFactory, storage) =>
             {
-                using var importer = new BeatmapImporter(realmFactory, storage);
+                using var importer = new BeatmapModelManager(realmFactory, storage);
                 using var store = new RulesetStore(realmFactory, storage);
 
                 string? temp = TestResources.GetTestBeatmapForImport();
diff --git a/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs b/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
index 2cab823526..5a2349e776 100644
--- a/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
+++ b/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
@@ -172,17 +172,17 @@ namespace osu.Game.Tests.Online
             {
             }
 
-            protected override BeatmapModelManager CreateBeatmapModelManager(Storage storage, IDatabaseContextFactory contextFactory, RulesetStore rulesets, IAPIProvider api, GameHost host)
+            protected override BeatmapModelManager CreateBeatmapModelManager(Storage storage, RealmContextFactory contextFactory, RulesetStore rulesets, BeatmapOnlineLookupQueue onlineLookupQueue)
             {
-                return new TestBeatmapModelManager(this, storage, contextFactory, rulesets, api, host);
+                return new TestBeatmapModelManager(this, storage, contextFactory, rulesets, onlineLookupQueue);
             }
 
             internal class TestBeatmapModelManager : BeatmapModelManager
             {
                 private readonly TestBeatmapManager testBeatmapManager;
 
-                public TestBeatmapModelManager(TestBeatmapManager testBeatmapManager, Storage storage, IDatabaseContextFactory databaseContextFactory, RulesetStore rulesetStore, IAPIProvider apiProvider, GameHost gameHost)
-                    : base(storage, databaseContextFactory, rulesetStore, gameHost)
+                public TestBeatmapModelManager(TestBeatmapManager testBeatmapManager, Storage storage, RealmContextFactory databaseContextFactory, RulesetStore rulesetStore, BeatmapOnlineLookupQueue beatmapOnlineLookupQueue)
+                    : base(databaseContextFactory, storage, beatmapOnlineLookupQueue)
                 {
                     this.testBeatmapManager = testBeatmapManager;
                 }
diff --git a/osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs b/osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs
index c4d7bd7e6a..a993190a67 100644
--- a/osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs
@@ -58,7 +58,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddStep("import beatmap", () =>
             {
                 beatmaps.Import(TestResources.GetQuickTestBeatmapForImport()).WaitSafely();
-                importedSet = beatmaps.GetAllUsableBeatmapSetsEnumerable(IncludedDetails.All).First();
+                importedSet = beatmaps.GetAllUsableBeatmapSetsEnumerable().First();
                 InitialBeatmap = importedSet.Beatmaps.First(b => b.RulesetID == 0);
                 OtherBeatmap = importedSet.Beatmaps.Last(b => b.RulesetID == 0);
             });
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
index 3d8c5298dc..18f45086f6 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
@@ -72,7 +72,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddStep("import beatmap", () =>
             {
                 beatmaps.Import(TestResources.GetQuickTestBeatmapForImport()).WaitSafely();
-                importedSet = beatmaps.GetAllUsableBeatmapSetsEnumerable(IncludedDetails.All).First();
+                importedSet = beatmaps.GetAllUsableBeatmapSetsEnumerable().First();
             });
 
             AddStep("load multiplayer", () => LoadScreen(multiplayerComponents = new TestMultiplayerComponents()));
@@ -588,7 +588,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddStep("restore beatmap", () =>
             {
                 beatmaps.Import(TestResources.GetQuickTestBeatmapForImport()).WaitSafely();
-                importedSet = beatmaps.GetAllUsableBeatmapSetsEnumerable(IncludedDetails.All).First();
+                importedSet = beatmaps.GetAllUsableBeatmapSetsEnumerable().First();
             });
 
             AddUntilStep("play started", () => multiplayerComponents.CurrentScreen is SpectatorScreen);
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs
index 52e46ef5af..6b6a02906e 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs
@@ -42,7 +42,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             Dependencies.Cache(beatmaps = new BeatmapManager(LocalStorage, ContextFactory, rulesets, null, audio, Resources, host, Beatmap.Default));
             beatmaps.Import(TestResources.GetQuickTestBeatmapForImport()).WaitSafely();
 
-            importedSet = beatmaps.GetAllUsableBeatmapSetsEnumerable(IncludedDetails.All).First();
+            importedSet = beatmaps.GetAllUsableBeatmapSetsEnumerable().First();
         }
 
         [SetUp]
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs
index 464c0ea5b6..251f407a85 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs
@@ -55,7 +55,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddStep("import beatmap", () =>
             {
                 beatmaps.Import(TestResources.GetQuickTestBeatmapForImport()).WaitSafely();
-                importedSet = beatmaps.GetAllUsableBeatmapSetsEnumerable(IncludedDetails.All).First();
+                importedSet = beatmaps.GetAllUsableBeatmapSetsEnumerable().First();
                 importedBeatmap = importedSet.Beatmaps.First(b => b.RulesetID == 0);
             });
 
@@ -169,7 +169,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         private void addItemStep(bool expired = false) => AddStep("add item", () => Client.AddPlaylistItem(new MultiplayerPlaylistItem(new PlaylistItem
         {
             Beatmap = { Value = importedBeatmap },
-            BeatmapID = importedBeatmap.OnlineID ?? -1,
+            BeatmapID = importedBeatmap.OnlineID,
             Expired = expired,
             PlayedAt = DateTimeOffset.Now
         })));
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs
index 29daff546d..ad47745642 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs
@@ -60,7 +60,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddStep("import beatmap", () =>
             {
                 beatmaps.Import(TestResources.GetQuickTestBeatmapForImport()).WaitSafely();
-                importedSet = beatmaps.GetAllUsableBeatmapSetsEnumerable(IncludedDetails.All).First();
+                importedSet = beatmaps.GetAllUsableBeatmapSetsEnumerable().First();
                 importedBeatmap = importedSet.Beatmaps.First(b => b.RulesetID == 0);
             });
 
@@ -126,7 +126,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 MultiplayerPlaylistItem item = new MultiplayerPlaylistItem(new PlaylistItem
                 {
                     Beatmap = { Value = importedBeatmap },
-                    BeatmapID = importedBeatmap.OnlineID ?? -1,
+                    BeatmapID = importedBeatmap.OnlineID,
                 });
 
                 Client.AddUserPlaylistItem(userId(), item);
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs
index 8f51b1e381..59e5318263 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs
@@ -50,7 +50,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             AvailabilityTracker.SelectedItem.BindTo(selectedItem);
 
-            importedSet = beatmaps.GetAllUsableBeatmapSetsEnumerable(IncludedDetails.All).First();
+            importedSet = beatmaps.GetAllUsableBeatmapSetsEnumerable().First();
             Beatmap.Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First());
             selectedItem.Value = new PlaylistItem
             {
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerSpectateButton.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerSpectateButton.cs
index d4ff9f8c41..5466a19657 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerSpectateButton.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerSpectateButton.cs
@@ -51,7 +51,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             AvailabilityTracker.SelectedItem.BindTo(selectedItem);
 
-            importedSet = beatmaps.GetAllUsableBeatmapSetsEnumerable(IncludedDetails.All).First();
+            importedSet = beatmaps.GetAllUsableBeatmapSetsEnumerable().First();
             Beatmap.Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First());
             selectedItem.Value = new PlaylistItem
             {
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsRoomSettingsPlaylist.cs b/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsRoomSettingsPlaylist.cs
index 93ccd5f1e1..e63e58824f 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsRoomSettingsPlaylist.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsRoomSettingsPlaylist.cs
@@ -12,7 +12,7 @@ using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.Drawables;
 using osu.Game.Database;
 using osu.Game.Graphics.Containers;
-using osu.Game.Online.API.Requests.Responses;
+using osu.Game.Models;
 using osu.Game.Online.Rooms;
 using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Osu.Mods;
@@ -155,7 +155,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                                     Metadata = new BeatmapMetadata
                                     {
                                         Artist = "Artist",
-                                        Author = new APIUser { Username = "Creator name here" },
+                                        Author = new RealmUser { Username = "Creator name here" },
                                         Title = "Long title used to check background colour",
                                     },
                                     BeatmapSet = new BeatmapSetInfo()
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs
index d20fbd3539..2140acb2e3 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs
@@ -53,7 +53,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddStep("import beatmap", () =>
             {
                 beatmaps.Import(TestResources.GetQuickTestBeatmapForImport()).WaitSafely();
-                importedSet = beatmaps.GetAllUsableBeatmapSetsEnumerable(IncludedDetails.All).First();
+                importedSet = beatmaps.GetAllUsableBeatmapSetsEnumerable().First();
             });
 
             AddStep("load multiplayer", () => LoadScreen(multiplayerComponents = new TestMultiplayerComponents()));
diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
index 62b0f10fd8..a5f42545c1 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
@@ -20,7 +20,6 @@ using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Osu.Mods;
 using osu.Game.Scoring;
 using osu.Game.Screens.Select.Leaderboards;
-using osu.Game.Stores;
 using osu.Game.Tests.Resources;
 using osu.Game.Users;
 using osuTK;
@@ -45,7 +44,7 @@ namespace osu.Game.Tests.Visual.SongSelect
 
             dependencies.Cache(rulesetStore = new RulesetStore(ContextFactory));
             dependencies.Cache(beatmapManager = new BeatmapManager(LocalStorage, ContextFactory, rulesetStore, null, dependencies.Get<AudioManager>(), Resources, dependencies.Get<GameHost>(), Beatmap.Default));
-            dependencies.Cache(scoreManager = new ScoreManager(dependencies.Get<RealmRulesetStore>(), () => beatmapManager, LocalStorage, dependencies.Get<RealmContextFactory>(), Scheduler));
+            dependencies.Cache(scoreManager = new ScoreManager(dependencies.Get<RulesetStore>(), () => beatmapManager, LocalStorage, dependencies.Get<RealmContextFactory>(), Scheduler));
 
             return dependencies;
         }
diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapMetadataDisplay.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapMetadataDisplay.cs
index e573c96ce9..fb6d9a0b4b 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapMetadataDisplay.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapMetadataDisplay.cs
@@ -77,7 +77,7 @@ namespace osu.Game.Tests.Visual.SongSelect
         {
             showMetadataForBeatmap(() =>
             {
-                var allBeatmapSets = manager.GetAllUsableBeatmapSets(IncludedDetails.Minimal);
+                var allBeatmapSets = manager.GetAllUsableBeatmapSets();
                 if (allBeatmapSets.Count == 0)
                     return manager.DefaultBeatmap;
 
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
index 5c4759a466..49200f6e1a 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
@@ -5,10 +5,10 @@ using System;
 using System.Collections.Generic;
 using System.Linq;
 using NUnit.Framework;
-using osu.Framework.Graphics;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
 using osu.Framework.Extensions;
+using osu.Framework.Graphics;
 using osu.Framework.Graphics.Cursor;
 using osu.Framework.Platform;
 using osu.Framework.Testing;
@@ -24,7 +24,6 @@ using osu.Game.Overlays;
 using osu.Game.Rulesets;
 using osu.Game.Scoring;
 using osu.Game.Screens.Select.Leaderboards;
-using osu.Game.Stores;
 using osu.Game.Tests.Resources;
 using osuTK;
 using osuTK.Input;
@@ -89,7 +88,7 @@ namespace osu.Game.Tests.Visual.UserInterface
 
             dependencies.Cache(rulesetStore = new RulesetStore(ContextFactory));
             dependencies.Cache(beatmapManager = new BeatmapManager(LocalStorage, ContextFactory, rulesetStore, null, dependencies.Get<AudioManager>(), Resources, dependencies.Get<GameHost>(), Beatmap.Default));
-            dependencies.Cache(scoreManager = new ScoreManager(dependencies.Get<RealmRulesetStore>(), () => beatmapManager, LocalStorage, dependencies.Get<RealmContextFactory>(), Scheduler));
+            dependencies.Cache(scoreManager = new ScoreManager(dependencies.Get<RulesetStore>(), () => beatmapManager, LocalStorage, dependencies.Get<RealmContextFactory>(), Scheduler));
 
             beatmapInfo = beatmapManager.Import(new ImportTask(TestResources.GetQuickTestBeatmapForImport())).GetResultSafely().Value.Beatmaps[0];
 
diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index 5c8cf38682..45ae69e4ba 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -16,7 +16,6 @@ using osu.Framework.IO.Stores;
 using osu.Framework.Platform;
 using osu.Framework.Testing;
 using osu.Game.Database;
-using osu.Game.IO;
 using osu.Game.IO.Archives;
 using osu.Game.Models;
 using osu.Game.Online.API;
@@ -43,21 +42,18 @@ namespace osu.Game.Beatmaps
 
         public BeatmapManager(Storage storage, RealmContextFactory contextFactory, RulesetStore rulesets, IAPIProvider api, [NotNull] AudioManager audioManager, IResourceStore<byte[]> gameResources, GameHost host = null, WorkingBeatmap defaultBeatmap = null, bool performOnlineLookups = false)
         {
+            if (performOnlineLookups)
+                onlineBeatmapLookupQueue = new BeatmapOnlineLookupQueue(api, storage);
+
             var userResources = new RealmFileStore(contextFactory, storage).Store;
 
             BeatmapTrackStore = audioManager.GetTrackStore(userResources);
 
-            beatmapModelManager = CreateBeatmapModelManager(storage, contextFactory, rulesets, api, host);
+            beatmapModelManager = CreateBeatmapModelManager(storage, contextFactory, rulesets, onlineBeatmapLookupQueue);
             workingBeatmapCache = CreateWorkingBeatmapCache(audioManager, gameResources, userResources, defaultBeatmap, host);
 
             workingBeatmapCache.BeatmapManager = beatmapModelManager;
             beatmapModelManager.WorkingBeatmapCache = workingBeatmapCache;
-
-            if (performOnlineLookups)
-            {
-                onlineBeatmapLookupQueue = new BeatmapOnlineLookupQueue(api, storage);
-                beatmapModelManager.OnlineLookupQueue = onlineBeatmapLookupQueue;
-            }
         }
 
         protected virtual WorkingBeatmapCache CreateWorkingBeatmapCache(AudioManager audioManager, IResourceStore<byte[]> resources, IResourceStore<byte[]> storage, WorkingBeatmap defaultBeatmap, GameHost host)
@@ -65,8 +61,8 @@ namespace osu.Game.Beatmaps
             return new WorkingBeatmapCache(BeatmapTrackStore, audioManager, resources, storage, defaultBeatmap, host);
         }
 
-        protected virtual BeatmapModelManager CreateBeatmapModelManager(Storage storage, IDatabaseContextFactory contextFactory, RulesetStore rulesets, IAPIProvider api, GameHost host) =>
-            new BeatmapModelManager(storage, contextFactory, rulesets, host);
+        protected virtual BeatmapModelManager CreateBeatmapModelManager(Storage storage, RealmContextFactory contextFactory, RulesetStore rulesets, [CanBeNull] BeatmapOnlineLookupQueue onlineLookupQueue) =>
+            new BeatmapModelManager(contextFactory, storage, onlineLookupQueue);
 
         /// <summary>
         /// Create a new <see cref="WorkingBeatmap"/>.
@@ -97,9 +93,9 @@ namespace osu.Game.Beatmaps
                 }
             };
 
-            var imported = beatmapModelManager.Import(set).GetResultSafely().Value;
+            var imported = beatmapModelManager.Import(set).GetResultSafely()?.Value;
 
-            return GetWorkingBeatmap(imported.Beatmaps.First());
+            return GetWorkingBeatmap(imported?.Beatmaps.First());
         }
 
         #region Delegation to BeatmapModelManager (methods which previously existed locally).
@@ -135,23 +131,21 @@ namespace osu.Game.Beatmaps
         /// Returns a list of all usable <see cref="BeatmapSetInfo"/>s.
         /// </summary>
         /// <returns>A list of available <see cref="BeatmapSetInfo"/>.</returns>
-        public List<BeatmapSetInfo> GetAllUsableBeatmapSets(IncludedDetails includes = IncludedDetails.All, bool includeProtected = false) => beatmapModelManager.GetAllUsableBeatmapSets(includes, includeProtected);
+        public List<BeatmapSetInfo> GetAllUsableBeatmapSets(bool includeProtected = false) => beatmapModelManager.GetAllUsableBeatmapSets(includeProtected);
 
         /// <summary>
         /// Returns a list of all usable <see cref="BeatmapSetInfo"/>s. Note that files are not populated.
         /// </summary>
-        /// <param name="includes">The level of detail to include in the returned objects.</param>
         /// <param name="includeProtected">Whether to include protected (system) beatmaps. These should not be included for gameplay playable use cases.</param>
         /// <returns>A list of available <see cref="BeatmapSetInfo"/>.</returns>
-        public IEnumerable<BeatmapSetInfo> GetAllUsableBeatmapSetsEnumerable(IncludedDetails includes, bool includeProtected = false) => beatmapModelManager.GetAllUsableBeatmapSetsEnumerable(includes, includeProtected);
+        public IEnumerable<BeatmapSetInfo> GetAllUsableBeatmapSetsEnumerable(bool includeProtected = false) => beatmapModelManager.GetAllUsableBeatmapSetsEnumerable(includeProtected);
 
         /// <summary>
         /// Perform a lookup query on available <see cref="BeatmapSetInfo"/>s.
         /// </summary>
         /// <param name="query">The query.</param>
-        /// <param name="includes">The level of detail to include in the returned objects.</param>
         /// <returns>Results from the provided query.</returns>
-        public IEnumerable<BeatmapSetInfo> QueryBeatmapSets(Expression<Func<BeatmapSetInfo, bool>> query, IncludedDetails includes = IncludedDetails.All) => beatmapModelManager.QueryBeatmapSets(query, includes);
+        public IEnumerable<BeatmapSetInfo> QueryBeatmapSets(Expression<Func<BeatmapSetInfo, bool>> query) => beatmapModelManager.QueryBeatmapSets(query);
 
         /// <summary>
         /// Perform a lookup query on available <see cref="BeatmapSetInfo"/>s.
diff --git a/osu.Game/Beatmaps/BeatmapModelManager.cs b/osu.Game/Beatmaps/BeatmapModelManager.cs
index f6f2e16410..100189bf09 100644
--- a/osu.Game/Beatmaps/BeatmapModelManager.cs
+++ b/osu.Game/Beatmaps/BeatmapModelManager.cs
@@ -3,30 +3,21 @@
 
 using System;
 using System.Collections.Generic;
+using System.Diagnostics;
 using System.IO;
 using System.Linq;
 using System.Linq.Expressions;
 using System.Text;
-using System.Threading;
-using System.Threading.Tasks;
-using Microsoft.EntityFrameworkCore;
-using osu.Framework.Audio.Track;
 using osu.Framework.Extensions;
-using osu.Framework.Graphics.Textures;
-using osu.Framework.Logging;
 using osu.Framework.Platform;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps.Formats;
 using osu.Game.Database;
 using osu.Game.Extensions;
-using osu.Game.IO;
-using osu.Game.IO.Archives;
-using osu.Game.Rulesets;
-using osu.Game.Rulesets.Objects;
 using osu.Game.Skinning;
 using osu.Game.Stores;
-using Realms;
-using Decoder = osu.Game.Beatmaps.Formats.Decoder;
+
+#nullable enable
 
 namespace osu.Game.Beatmaps
 {
@@ -34,145 +25,65 @@ namespace osu.Game.Beatmaps
     /// Handles ef-core storage of beatmaps.
     /// </summary>
     [ExcludeFromDynamicCompile]
-    public class BeatmapModelManager : RealmArchiveModelManager<BeatmapSetInfo>
+    public class BeatmapModelManager : BeatmapImporter
     {
         /// <summary>
         /// Fired when a single difficulty has been hidden.
         /// </summary>
-        public event Action<BeatmapInfo> BeatmapHidden;
+        public event Action<BeatmapInfo>? BeatmapHidden;
 
         /// <summary>
         /// Fired when a single difficulty has been restored.
         /// </summary>
-        public event Action<BeatmapInfo> BeatmapRestored;
-
-        /// <summary>
-        /// An online lookup queue component which handles populating online beatmap metadata.
-        /// </summary>
-        public BeatmapOnlineLookupQueue OnlineLookupQueue { private get; set; }
+        public event Action<BeatmapInfo>? BeatmapRestored;
 
         /// <summary>
         /// The game working beatmap cache, used to invalidate entries on changes.
         /// </summary>
-        public IWorkingBeatmapCache WorkingBeatmapCache { private get; set; }
+        public IWorkingBeatmapCache? WorkingBeatmapCache { private get; set; }
 
         public override IEnumerable<string> HandledExtensions => new[] { ".osz" };
 
         protected override string[] HashableFileTypes => new[] { ".osu" };
 
-        private readonly RulesetStore rulesets;
-
-        public BeatmapModelManager(Storage storage, RealmContextFactory contextFactory, RulesetStore rulesets, GameHost host = null)
-            : base(storage, contextFactory)
+        public BeatmapModelManager(RealmContextFactory contextFactory, Storage storage, BeatmapOnlineLookupQueue? onlineLookupQueue = null)
+            : base(contextFactory, storage, onlineLookupQueue)
         {
-            this.rulesets = rulesets;
-
-            // beatmaps.BeatmapHidden += b => BeatmapHidden?.Invoke(b);
-            // beatmaps.BeatmapRestored += b => BeatmapRestored?.Invoke(b);
-            // beatmaps.ItemRemoved += b => WorkingBeatmapCache?.Invalidate(b);
-            // beatmaps.ItemUpdated += obj => WorkingBeatmapCache?.Invalidate(obj);
         }
 
         protected override bool ShouldDeleteArchive(string path) => Path.GetExtension(path)?.ToLowerInvariant() == ".osz";
 
-        protected override async Task Populate(BeatmapSetInfo beatmapSet, ArchiveReader? archive, Realm realm, CancellationToken cancellationToken)
-        {
-            if (archive != null)
-                beatmapSet.Beatmaps.AddRange(createBeatmapDifficulties(beatmapSet.Files));
-
-            foreach (BeatmapInfo b in beatmapSet.Beatmaps)
-            {
-                // remove metadata from difficulties where it matches the set
-                if (beatmapSet.Metadata.Equals(b.Metadata))
-                    b.Metadata = null;
-
-                b.BeatmapSet = beatmapSet;
-            }
-
-            validateOnlineIds(beatmapSet);
-
-            bool hadOnlineIDs = beatmapSet.Beatmaps.Any(b => b.OnlineID > 0);
-
-            if (OnlineLookupQueue != null)
-                await OnlineLookupQueue.UpdateAsync(beatmapSet, cancellationToken).ConfigureAwait(false);
-
-            // ensure at least one beatmap was able to retrieve or keep an online ID, else drop the set ID.
-            if (hadOnlineIDs && !beatmapSet.Beatmaps.Any(b => b.OnlineID > 0))
-            {
-                if (beatmapSet.OnlineID != null)
-                {
-                    beatmapSet.OnlineID = -1;
-                    LogForModel(beatmapSet, "Disassociating beatmap set ID due to loss of all beatmap IDs");
-                }
-            }
-        }
-
-        protected override void PreImport(BeatmapSetInfo beatmapSet)
-        {
-            if (beatmapSet.Beatmaps.Any(b => b.BaseDifficulty == null))
-                throw new InvalidOperationException($"Cannot import {nameof(BeatmapInfo)} with null {nameof(BeatmapInfo.BaseDifficulty)}.");
-
-            // check if a set already exists with the same online id, delete if it does.
-            if (beatmapSet.OnlineID != null)
-            {
-                var existingSetWithSameOnlineID = beatmaps.ConsumableItems.FirstOrDefault(b => b.OnlineID == beatmapSet.OnlineID);
-
-                if (existingSetWithSameOnlineID != null)
-                {
-                    Delete(existingSetWithSameOnlineID);
-
-                    // in order to avoid a unique key constraint, immediately remove the online ID from the previous set.
-                    existingSetWithSameOnlineID.OnlineID = -1;
-                    foreach (var b in existingSetWithSameOnlineID.Beatmaps)
-                        b.OnlineID = -1;
-
-                    LogForModel(beatmapSet, $"Found existing beatmap set with same OnlineBeatmapSetID ({beatmapSet.OnlineID}). It has been deleted.");
-                }
-            }
-        }
-
-        private void validateOnlineIds(BeatmapSetInfo beatmapSet)
-        {
-            var beatmapIds = beatmapSet.Beatmaps.Where(b => b.OnlineID.HasValue).Select(b => b.OnlineID).ToList();
-
-            // ensure all IDs are unique
-            if (beatmapIds.GroupBy(b => b).Any(g => g.Count() > 1))
-            {
-                LogForModel(beatmapSet, "Found non-unique IDs, resetting...");
-                resetIds();
-                return;
-            }
-
-            // find any existing beatmaps in the database that have matching online ids
-            var existingBeatmaps = QueryBeatmaps(b => beatmapIds.Contains(b.OnlineID)).ToList();
-
-            if (existingBeatmaps.Count > 0)
-            {
-                // reset the import ids (to force a re-fetch) *unless* they match the candidate CheckForExisting set.
-                // we can ignore the case where the new ids are contained by the CheckForExisting set as it will either be used (import skipped) or deleted.
-                var existing = CheckForExisting(beatmapSet);
-
-                if (existing == null || existingBeatmaps.Any(b => !existing.Beatmaps.Contains(b)))
-                {
-                    LogForModel(beatmapSet, "Found existing import with IDs already, resetting...");
-                    resetIds();
-                }
-            }
-
-            void resetIds() => beatmapSet.Beatmaps.ForEach(b => b.OnlineID = -1);
-        }
-
         /// <summary>
         /// Delete a beatmap difficulty.
         /// </summary>
         /// <param name="beatmapInfo">The beatmap difficulty to hide.</param>
-        public void Hide(BeatmapInfo beatmapInfo) => beatmaps.Hide(beatmapInfo);
+        public void Hide(BeatmapInfo beatmapInfo)
+        {
+            using (var realm = ContextFactory.CreateContext())
+            using (var transaction = realm.BeginWrite())
+            {
+                beatmapInfo.Hidden = true;
+                transaction.Commit();
+
+                BeatmapHidden?.Invoke(beatmapInfo);
+            }
+        }
 
         /// <summary>
         /// Restore a beatmap difficulty.
         /// </summary>
         /// <param name="beatmapInfo">The beatmap difficulty to restore.</param>
-        public void Restore(BeatmapInfo beatmapInfo) => beatmaps.Restore(beatmapInfo);
+        public void Restore(BeatmapInfo beatmapInfo)
+        {
+            using (var realm = ContextFactory.CreateContext())
+            using (var transaction = realm.BeginWrite())
+            {
+                beatmapInfo.Hidden = false;
+                transaction.Commit();
+
+                BeatmapRestored?.Invoke(beatmapInfo);
+            }
+        }
 
         /// <summary>
         /// Saves an <see cref="IBeatmap"/> file against a given <see cref="BeatmapInfo"/>.
@@ -180,10 +91,12 @@ namespace osu.Game.Beatmaps
         /// <param name="beatmapInfo">The <see cref="BeatmapInfo"/> to save the content against. The file referenced by <see cref="BeatmapInfo.Path"/> will be replaced.</param>
         /// <param name="beatmapContent">The <see cref="IBeatmap"/> content to write.</param>
         /// <param name="beatmapSkin">The beatmap <see cref="ISkin"/> content to write, null if to be omitted.</param>
-        public virtual void Save(BeatmapInfo beatmapInfo, IBeatmap beatmapContent, ISkin beatmapSkin = null)
+        public virtual void Save(BeatmapInfo beatmapInfo, IBeatmap beatmapContent, ISkin? beatmapSkin = null)
         {
             var setInfo = beatmapInfo.BeatmapSet;
 
+            Debug.Assert(setInfo != null);
+
             // Difficulty settings must be copied first due to the clone in `Beatmap<>.BeatmapInfo_Set`.
             // This should hopefully be temporary, assuming said clone is eventually removed.
 
@@ -202,25 +115,29 @@ namespace osu.Game.Beatmaps
 
                 stream.Seek(0, SeekOrigin.Begin);
 
-                using (ContextFactory.GetForWrite())
+                using (var realm = ContextFactory.CreateContext())
+                using (var transaction = realm.BeginWrite())
                 {
                     beatmapInfo = setInfo.Beatmaps.Single(b => b.Equals(beatmapInfo));
 
-                    var metadata = beatmapInfo.Metadata ?? setInfo.Metadata;
-
                     // grab the original file (or create a new one if not found).
-                    var fileInfo = setInfo.Files.SingleOrDefault(f => string.Equals(f.Filename, beatmapInfo.Path, StringComparison.OrdinalIgnoreCase)) ?? new BeatmapSetFileInfo();
+                    var existingFileInfo = setInfo.Files.SingleOrDefault(f => string.Equals(f.Filename, beatmapInfo.Path, StringComparison.OrdinalIgnoreCase));
+
+                    if (existingFileInfo != null)
+                    {
+                        DeleteFile(setInfo, existingFileInfo);
+                    }
 
                     // metadata may have changed; update the path with the standard format.
-                    beatmapInfo.Path = $"{metadata.Artist} - {metadata.Title} ({metadata.Author}) [{beatmapInfo.DifficultyName}].osu".GetValidArchiveContentFilename();
+                    var metadata = beatmapInfo.Metadata;
+                    string filename = $"{metadata.Artist} - {metadata.Title} ({metadata.Author}) [{beatmapInfo.DifficultyName}].osu".GetValidArchiveContentFilename();
 
                     beatmapInfo.MD5Hash = stream.ComputeMD5Hash();
 
-                    // update existing or populate new file's filename.
-                    fileInfo.Filename = beatmapInfo.Path;
-
                     stream.Seek(0, SeekOrigin.Begin);
-                    ReplaceFile(setInfo, fileInfo, stream);
+                    AddFile(setInfo, stream, filename, realm);
+
+                    transaction.Commit();
                 }
             }
 
@@ -232,100 +149,43 @@ namespace osu.Game.Beatmaps
         /// </summary>
         /// <param name="query">The query.</param>
         /// <returns>The first result for the provided query, or null if no results were found.</returns>
-        public BeatmapSetInfo QueryBeatmapSet(Expression<Func<BeatmapSetInfo, bool>> query) => beatmaps.ConsumableItems.AsNoTracking().FirstOrDefault(query);
-
-        protected override bool CanSkipImport(BeatmapSetInfo existing, BeatmapSetInfo import)
+        public BeatmapSetInfo? QueryBeatmapSet(Expression<Func<BeatmapSetInfo, bool>> query)
         {
-            if (!base.CanSkipImport(existing, import))
-                return false;
-
-            return existing.Beatmaps.Any(b => b.OnlineID != null);
-        }
-
-        protected override bool CanReuseExisting(BeatmapSetInfo existing, BeatmapSetInfo import)
-        {
-            if (!base.CanReuseExisting(existing, import))
-                return false;
-
-            var existingIds = existing.Beatmaps.Select(b => b.OnlineID).OrderBy(i => i);
-            var importIds = import.Beatmaps.Select(b => b.OnlineID).OrderBy(i => i);
-
-            // force re-import if we are not in a sane state.
-            return existing.OnlineID == import.OnlineID && existingIds.SequenceEqual(importIds);
+            using (var context = ContextFactory.CreateContext())
+                return context.All<BeatmapSetInfo>().FirstOrDefault(query); // TODO: ?.ToLive();
         }
 
         /// <summary>
         /// Returns a list of all usable <see cref="BeatmapSetInfo"/>s.
         /// </summary>
         /// <returns>A list of available <see cref="BeatmapSetInfo"/>.</returns>
-        public List<BeatmapSetInfo> GetAllUsableBeatmapSets(IncludedDetails includes = IncludedDetails.All, bool includeProtected = false) =>
-            GetAllUsableBeatmapSetsEnumerable(includes, includeProtected).ToList();
+        public List<BeatmapSetInfo> GetAllUsableBeatmapSets(bool includeProtected = false) =>
+            GetAllUsableBeatmapSetsEnumerable(includeProtected).ToList();
 
         /// <summary>
         /// Returns a list of all usable <see cref="BeatmapSetInfo"/>s. Note that files are not populated.
         /// </summary>
-        /// <param name="includes">The level of detail to include in the returned objects.</param>
         /// <param name="includeProtected">Whether to include protected (system) beatmaps. These should not be included for gameplay playable use cases.</param>
         /// <returns>A list of available <see cref="BeatmapSetInfo"/>.</returns>
-        public IEnumerable<BeatmapSetInfo> GetAllUsableBeatmapSetsEnumerable(IncludedDetails includes, bool includeProtected = false)
+        public IEnumerable<BeatmapSetInfo> GetAllUsableBeatmapSetsEnumerable(bool includeProtected = false)
         {
-            IQueryable<BeatmapSetInfo> queryable;
-
-            switch (includes)
-            {
-                case IncludedDetails.Minimal:
-                    queryable = beatmaps.BeatmapSetsOverview;
-                    break;
-
-                case IncludedDetails.AllButRuleset:
-                    queryable = beatmaps.BeatmapSetsWithoutRuleset;
-                    break;
-
-                case IncludedDetails.AllButFiles:
-                    queryable = beatmaps.BeatmapSetsWithoutFiles;
-                    break;
-
-                default:
-                    queryable = beatmaps.ConsumableItems;
-                    break;
-            }
-
-            // AsEnumerable used here to avoid applying the WHERE in sql. When done so, ef core 2.x uses an incorrect ORDER BY
-            // clause which causes queries to take 5-10x longer.
-            // TODO: remove if upgrading to EF core 3.x.
-            return queryable.AsEnumerable().Where(s => !s.DeletePending && (includeProtected || !s.Protected));
+            using (var context = ContextFactory.CreateContext())
+                return context.All<BeatmapSetInfo>().Where(b => !b.DeletePending && (includeProtected || !b.Protected));
         }
 
         /// <summary>
         /// Perform a lookup query on available <see cref="BeatmapSetInfo"/>s.
         /// </summary>
         /// <param name="query">The query.</param>
-        /// <param name="includes">The level of detail to include in the returned objects.</param>
         /// <returns>Results from the provided query.</returns>
-        public IEnumerable<BeatmapSetInfo> QueryBeatmapSets(Expression<Func<BeatmapSetInfo, bool>> query, IncludedDetails includes = IncludedDetails.All)
+        public IEnumerable<BeatmapSetInfo> QueryBeatmapSets(Expression<Func<BeatmapSetInfo, bool>> query)
         {
-            IQueryable<BeatmapSetInfo> queryable;
-
-            switch (includes)
+            using (var context = ContextFactory.CreateContext())
             {
-                case IncludedDetails.Minimal:
-                    queryable = beatmaps.BeatmapSetsOverview;
-                    break;
-
-                case IncludedDetails.AllButRuleset:
-                    queryable = beatmaps.BeatmapSetsWithoutRuleset;
-                    break;
-
-                case IncludedDetails.AllButFiles:
-                    queryable = beatmaps.BeatmapSetsWithoutFiles;
-                    break;
-
-                default:
-                    queryable = beatmaps.ConsumableItems;
-                    break;
+                return context.All<BeatmapSetInfo>()
+                              .Where(b => !b.DeletePending)
+                              .Where(query);
             }
-
-            return queryable.AsNoTracking().Where(query);
         }
 
         /// <summary>
@@ -333,145 +193,24 @@ namespace osu.Game.Beatmaps
         /// </summary>
         /// <param name="query">The query.</param>
         /// <returns>The first result for the provided query, or null if no results were found.</returns>
-        public BeatmapInfo QueryBeatmap(Expression<Func<BeatmapInfo, bool>> query) => beatmaps.Beatmaps.AsNoTracking().FirstOrDefault(query);
+        public BeatmapInfo? QueryBeatmap(Expression<Func<BeatmapInfo, bool>> query)
+        {
+            using (var context = ContextFactory.CreateContext())
+                return context.All<BeatmapInfo>().FirstOrDefault(query); // TODO: ?.ToLive();
+        }
 
         /// <summary>
         /// Perform a lookup query on available <see cref="BeatmapInfo"/>s.
         /// </summary>
         /// <param name="query">The query.</param>
         /// <returns>Results from the provided query.</returns>
-        public IQueryable<BeatmapInfo> QueryBeatmaps(Expression<Func<BeatmapInfo, bool>> query) => beatmaps.Beatmaps.AsNoTracking().Where(query);
-
-        public override string HumanisedModelName => "beatmap";
-
-        protected override bool CheckLocalAvailability(BeatmapSetInfo model, IQueryable<BeatmapSetInfo> items)
-            => base.CheckLocalAvailability(model, items)
-               || (model.OnlineID != null && items.Any(b => b.OnlineID == model.OnlineID));
-
-        protected override BeatmapSetInfo CreateModel(ArchiveReader reader)
+        public IQueryable<BeatmapInfo> QueryBeatmaps(Expression<Func<BeatmapInfo, bool>> query)
         {
-            // let's make sure there are actually .osu files to import.
-            string mapName = reader.Filenames.FirstOrDefault(f => f.EndsWith(".osu", StringComparison.OrdinalIgnoreCase));
-
-            if (string.IsNullOrEmpty(mapName))
+            using (var context = ContextFactory.CreateContext())
             {
-                Logger.Log($"No beatmap files found in the beatmap archive ({reader.Name}).", LoggingTarget.Database);
-                return null;
+                return context.All<BeatmapInfo>()
+                              .Where(query);
             }
-
-            Beatmap beatmap;
-            using (var stream = new LineBufferedReader(reader.GetStream(mapName)))
-                beatmap = Decoder.GetDecoder<Beatmap>(stream).Decode(stream);
-
-            return new BeatmapSetInfo
-            {
-                OnlineID = beatmap.BeatmapInfo.BeatmapSet?.OnlineID,
-                Metadata = beatmap.Metadata,
-                DateAdded = DateTimeOffset.UtcNow
-            };
         }
-
-        /// <summary>
-        /// Create all required <see cref="BeatmapInfo"/>s for the provided archive.
-        /// </summary>
-        private List<BeatmapInfo> createBeatmapDifficulties(List<BeatmapSetFileInfo> files)
-        {
-            var beatmapInfos = new List<BeatmapInfo>();
-
-            foreach (var file in files.Where(f => f.Filename.EndsWith(".osu", StringComparison.OrdinalIgnoreCase)))
-            {
-                using (var raw = Files.Store.GetStream(file.FileInfo.GetStoragePath()))
-                using (var ms = new MemoryStream()) // we need a memory stream so we can seek
-                using (var sr = new LineBufferedReader(ms))
-                {
-                    raw.CopyTo(ms);
-                    ms.Position = 0;
-
-                    var decoder = Decoder.GetDecoder<Beatmap>(sr);
-                    IBeatmap beatmap = decoder.Decode(sr);
-
-                    string hash = ms.ComputeSHA2Hash();
-
-                    if (beatmapInfos.Any(b => b.Hash == hash))
-                        continue;
-
-                    beatmap.BeatmapInfo.Path = file.Filename;
-                    beatmap.BeatmapInfo.Hash = hash;
-                    beatmap.BeatmapInfo.MD5Hash = ms.ComputeMD5Hash();
-
-                    var ruleset = rulesets.GetRuleset(beatmap.BeatmapInfo.RulesetID);
-                    beatmap.BeatmapInfo.Ruleset = ruleset;
-
-                    // TODO: this should be done in a better place once we actually need to dynamically update it.
-                    beatmap.BeatmapInfo.StarRating = ruleset?.CreateInstance().CreateDifficultyCalculator(new DummyConversionBeatmap(beatmap)).Calculate().StarRating ?? 0;
-                    beatmap.BeatmapInfo.Length = calculateLength(beatmap);
-                    beatmap.BeatmapInfo.BPM = 60000 / beatmap.GetMostCommonBeatLength();
-
-                    beatmapInfos.Add(beatmap.BeatmapInfo);
-                }
-            }
-
-            return beatmapInfos;
-        }
-
-        private double calculateLength(IBeatmap b)
-        {
-            if (!b.HitObjects.Any())
-                return 0;
-
-            var lastObject = b.HitObjects.Last();
-
-            //TODO: this isn't always correct (consider mania where a non-last object may last for longer than the last in the list).
-            double endTime = lastObject.GetEndTime();
-            double startTime = b.HitObjects.First().StartTime;
-
-            return endTime - startTime;
-        }
-
-        /// <summary>
-        /// A dummy WorkingBeatmap for the purpose of retrieving a beatmap for star difficulty calculation.
-        /// </summary>
-        private class DummyConversionBeatmap : WorkingBeatmap
-        {
-            private readonly IBeatmap beatmap;
-
-            public DummyConversionBeatmap(IBeatmap beatmap)
-                : base(beatmap.BeatmapInfo, null)
-            {
-                this.beatmap = beatmap;
-            }
-
-            protected override IBeatmap GetBeatmap() => beatmap;
-            protected override Texture GetBackground() => null;
-            protected override Track GetBeatmapTrack() => null;
-            protected internal override ISkin GetSkin() => null;
-            public override Stream GetStream(string storagePath) => null;
-        }
-    }
-
-    /// <summary>
-    /// The level of detail to include in database results.
-    /// </summary>
-    public enum IncludedDetails
-    {
-        /// <summary>
-        /// Only include beatmap difficulties and set level metadata.
-        /// </summary>
-        Minimal,
-
-        /// <summary>
-        /// Include all difficulties, rulesets, difficulty metadata but no files.
-        /// </summary>
-        AllButFiles,
-
-        /// <summary>
-        /// Include everything except ruleset. Used for cases where we aren't sure the ruleset is present but still want to consume the beatmap.
-        /// </summary>
-        AllButRuleset,
-
-        /// <summary>
-        /// Include everything.
-        /// </summary>
-        All
     }
 }
diff --git a/osu.Game/Beatmaps/EFBeatmapSetInfo.cs b/osu.Game/Beatmaps/EFBeatmapSetInfo.cs
index c0310f5a76..10910d9817 100644
--- a/osu.Game/Beatmaps/EFBeatmapSetInfo.cs
+++ b/osu.Game/Beatmaps/EFBeatmapSetInfo.cs
@@ -34,7 +34,7 @@ namespace osu.Game.Beatmaps
         public EFBeatmapMetadata Metadata { get; set; }
 
         [NotNull]
-        public List<BeatmapInfo> Beatmaps { get; } = new List<BeatmapInfo>();
+        public List<EFBeatmapInfo> Beatmaps { get; } = new List<EFBeatmapInfo>();
 
         public BeatmapOnlineStatus Status { get; set; } = BeatmapOnlineStatus.None;
 
@@ -95,7 +95,7 @@ namespace osu.Game.Beatmaps
 
         #region Implementation of IBeatmapSetInfo
 
-        IBeatmapMetadataInfo IBeatmapSetInfo.Metadata => Metadata ?? Beatmaps.FirstOrDefault()?.Metadata ?? new BeatmapMetadata();
+        IBeatmapMetadataInfo IBeatmapSetInfo.Metadata => Metadata ?? Beatmaps.FirstOrDefault()?.Metadata ?? new EFBeatmapMetadata();
         IEnumerable<IBeatmapInfo> IBeatmapSetInfo.Beatmaps => Beatmaps;
         IEnumerable<INamedFileUsage> IHasNamedFiles.Files => Files;
 
diff --git a/osu.Game/Beatmaps/FlatFileWorkingBeatmap.cs b/osu.Game/Beatmaps/FlatFileWorkingBeatmap.cs
index 8c915e2872..dc8201a402 100644
--- a/osu.Game/Beatmaps/FlatFileWorkingBeatmap.cs
+++ b/osu.Game/Beatmaps/FlatFileWorkingBeatmap.cs
@@ -33,7 +33,7 @@ namespace osu.Game.Beatmaps
             beatmap.BeatmapInfo.Ruleset = rulesetProvider(beatmap.BeatmapInfo.RulesetID).RulesetInfo;
 
             if (beatmapId.HasValue)
-                beatmap.BeatmapInfo.OnlineID = beatmapId;
+                beatmap.BeatmapInfo.OnlineID = beatmapId.Value;
         }
 
         private static Beatmap readFromFile(string filename)
diff --git a/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs b/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
index e5db9d045a..5c61d302c2 100644
--- a/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
+++ b/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
@@ -11,6 +11,7 @@ using osu.Game.Beatmaps.ControlPoints;
 using osu.Game.Beatmaps.Legacy;
 using osu.Game.Beatmaps.Timing;
 using osu.Game.IO;
+using osu.Game.Rulesets;
 using osu.Game.Rulesets.Objects.Legacy;
 
 namespace osu.Game.Beatmaps.Formats
@@ -141,7 +142,8 @@ namespace osu.Game.Beatmaps.Formats
                     break;
 
                 case @"Mode":
-                    beatmap.BeatmapInfo.RulesetID = Parsing.ParseInt(pair.Value);
+                    // TODO: ha ha ha.
+                    beatmap.BeatmapInfo.Ruleset = new RulesetInfo(Parsing.ParseInt(pair.Value), "some ruleset", "wangs", true /* probably not */);
 
                     switch (beatmap.BeatmapInfo.RulesetID)
                     {
diff --git a/osu.Game/Database/ImportTask.cs b/osu.Game/Database/ImportTask.cs
index 1fb5a42630..cd9e396d13 100644
--- a/osu.Game/Database/ImportTask.cs
+++ b/osu.Game/Database/ImportTask.cs
@@ -5,13 +5,14 @@
 
 using System.IO;
 using osu.Game.IO.Archives;
+using osu.Game.Stores;
 using osu.Game.Utils;
 using SharpCompress.Common;
 
 namespace osu.Game.Database
 {
     /// <summary>
-    /// An encapsulated import task to be imported to an <see cref="ArchiveModelManager{TModel,TFileModel}"/>.
+    /// An encapsulated import task to be imported to an <see cref="RealmArchiveModelManager{TModel}"/>.
     /// </summary>
     public class ImportTask
     {
diff --git a/osu.Game/Overlays/MusicController.cs b/osu.Game/Overlays/MusicController.cs
index 3346c6d97d..310f4946f3 100644
--- a/osu.Game/Overlays/MusicController.cs
+++ b/osu.Game/Overlays/MusicController.cs
@@ -71,7 +71,7 @@ namespace osu.Game.Overlays
             beatmaps.ItemUpdated += beatmapUpdated;
             beatmaps.ItemRemoved += beatmapRemoved;
 
-            beatmapSets.AddRange(beatmaps.GetAllUsableBeatmapSets(IncludedDetails.Minimal, true).OrderBy(_ => RNG.Next()));
+            beatmapSets.AddRange(beatmaps.GetAllUsableBeatmapSets(true).OrderBy(_ => RNG.Next()));
 
             // Todo: These binds really shouldn't be here, but are unlikely to cause any issues for now.
             // They are placed here for now since some tests rely on setting the beatmap _and_ their hierarchies inside their load(), which runs before the MusicController's load().
diff --git a/osu.Game/Scoring/LegacyDatabasedScore.cs b/osu.Game/Scoring/LegacyDatabasedScore.cs
index 6a8e5f8930..ac444c1bf3 100644
--- a/osu.Game/Scoring/LegacyDatabasedScore.cs
+++ b/osu.Game/Scoring/LegacyDatabasedScore.cs
@@ -6,14 +6,14 @@ using System.Linq;
 using osu.Framework.IO.Stores;
 using osu.Game.Beatmaps;
 using osu.Game.Extensions;
+using osu.Game.Rulesets;
 using osu.Game.Scoring.Legacy;
-using osu.Game.Stores;
 
 namespace osu.Game.Scoring
 {
     public class LegacyDatabasedScore : Score
     {
-        public LegacyDatabasedScore(ScoreInfo score, RealmRulesetStore rulesets, BeatmapManager beatmaps, IResourceStore<byte[]> store)
+        public LegacyDatabasedScore(ScoreInfo score, RulesetStore rulesets, BeatmapManager beatmaps, IResourceStore<byte[]> store)
         {
             ScoreInfo = score;
 
diff --git a/osu.Game/Scoring/ScoreInfo.cs b/osu.Game/Scoring/ScoreInfo.cs
index 21339acd22..20b6ba7a93 100644
--- a/osu.Game/Scoring/ScoreInfo.cs
+++ b/osu.Game/Scoring/ScoreInfo.cs
@@ -80,17 +80,9 @@ namespace osu.Game.Scoring
 
         public double? PP { get; set; }
 
-        public RealmBeatmap Beatmap { get; set; } = null!;
+        public BeatmapInfo Beatmap { get; set; } = null!;
 
-        public BeatmapInfo BeatmapInfo
-        {
-            get => new BeatmapInfo();
-            // .. todo
-            // ReSharper disable once ValueParameterNotUsed
-            set => Beatmap = new RealmBeatmap(new RealmRuleset("osu", "osu!", "wangs", 0), new RealmBeatmapDifficulty(), new RealmBeatmapMetadata());
-        }
-
-        public RealmRuleset Ruleset { get; set; } = null!;
+        public RulesetInfo Ruleset { get; set; } = null!;
 
         [Ignored]
         public Dictionary<HitResult, int> Statistics
@@ -132,7 +124,13 @@ namespace osu.Game.Scoring
 
         private Mod[]? mods;
 
-        public int BeatmapInfoID => BeatmapInfo.ID;
+        public Guid BeatmapInfoID => Beatmap.ID;
+
+        public BeatmapInfo BeatmapInfo
+        {
+            get => Beatmap;
+            set => Beatmap = value;
+        }
 
         public int UserID => RealmUser.OnlineID;
 
diff --git a/osu.Game/Scoring/ScoreManager.cs b/osu.Game/Scoring/ScoreManager.cs
index d094e1f45c..0a1b616422 100644
--- a/osu.Game/Scoring/ScoreManager.cs
+++ b/osu.Game/Scoring/ScoreManager.cs
@@ -20,7 +20,6 @@ using osu.Game.Overlays.Notifications;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Judgements;
 using osu.Game.Rulesets.Scoring;
-using osu.Game.Stores;
 
 namespace osu.Game.Scoring
 {
diff --git a/osu.Game/Scoring/ScoreModelManager.cs b/osu.Game/Scoring/ScoreModelManager.cs
index dd0ac79873..81f80df3ad 100644
--- a/osu.Game/Scoring/ScoreModelManager.cs
+++ b/osu.Game/Scoring/ScoreModelManager.cs
@@ -11,6 +11,7 @@ using osu.Framework.Platform;
 using osu.Game.Beatmaps;
 using osu.Game.Database;
 using osu.Game.IO.Archives;
+using osu.Game.Rulesets;
 using osu.Game.Scoring.Legacy;
 using osu.Game.Stores;
 using Realms;
@@ -25,10 +26,10 @@ namespace osu.Game.Scoring
 
         protected override string[] HashableFileTypes => new[] { ".osr" };
 
-        private readonly RealmRulesetStore rulesets;
+        private readonly RulesetStore rulesets;
         private readonly Func<BeatmapManager> beatmaps;
 
-        public ScoreModelManager(RealmRulesetStore rulesets, Func<BeatmapManager> beatmaps, Storage storage, RealmContextFactory contextFactory)
+        public ScoreModelManager(RulesetStore rulesets, Func<BeatmapManager> beatmaps, Storage storage, RealmContextFactory contextFactory)
             : base(storage, contextFactory)
         {
             this.rulesets = rulesets;
diff --git a/osu.Game/Screens/Menu/IntroScreen.cs b/osu.Game/Screens/Menu/IntroScreen.cs
index 948e3a7d88..94c48f5251 100644
--- a/osu.Game/Screens/Menu/IntroScreen.cs
+++ b/osu.Game/Screens/Menu/IntroScreen.cs
@@ -95,7 +95,7 @@ namespace osu.Game.Screens.Menu
             // if the user has requested not to play theme music, we should attempt to find a random beatmap from their collection.
             if (!MenuMusic.Value)
             {
-                var sets = beatmaps.GetAllUsableBeatmapSets(IncludedDetails.Minimal);
+                var sets = beatmaps.GetAllUsableBeatmapSets();
 
                 if (sets.Count > 0)
                 {
@@ -125,7 +125,7 @@ namespace osu.Game.Screens.Menu
 
             bool loadThemedIntro()
             {
-                setInfo = beatmaps.QueryBeatmapSets(b => b.Hash == BeatmapHash, IncludedDetails.AllButRuleset).FirstOrDefault();
+                setInfo = beatmaps.QueryBeatmapSets(b => b.Hash == BeatmapHash).FirstOrDefault();
 
                 if (setInfo == null)
                     return false;
diff --git a/osu.Game/Screens/Ranking/SoloResultsScreen.cs b/osu.Game/Screens/Ranking/SoloResultsScreen.cs
index afebc728b4..2ec6c38287 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)
         {
-            if (Score.BeatmapInfo.OnlineID == null || Score.BeatmapInfo.Status <= BeatmapOnlineStatus.Pending)
+            if (Score.BeatmapInfo.OnlineID <= 0 || Score.BeatmapInfo.Status <= BeatmapOnlineStatus.Pending)
                 return null;
 
             getScoreRequest = new GetScoresRequest(Score.BeatmapInfo, Score.Ruleset);
diff --git a/osu.Game/Screens/Select/BeatmapCarousel.cs b/osu.Game/Screens/Select/BeatmapCarousel.cs
index 7e292e2de7..f8d2c3cb9b 100644
--- a/osu.Game/Screens/Select/BeatmapCarousel.cs
+++ b/osu.Game/Screens/Select/BeatmapCarousel.cs
@@ -182,7 +182,7 @@ namespace osu.Game.Screens.Select
                 loadBeatmapSets(GetLoadableBeatmaps());
         }
 
-        protected virtual IEnumerable<BeatmapSetInfo> GetLoadableBeatmaps() => beatmaps.GetAllUsableBeatmapSetsEnumerable(IncludedDetails.AllButFiles);
+        protected virtual IEnumerable<BeatmapSetInfo> GetLoadableBeatmaps() => beatmaps.GetAllUsableBeatmapSetsEnumerable();
 
         public void RemoveBeatmapSet(BeatmapSetInfo beatmapSet) => Schedule(() =>
         {
diff --git a/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmapSet.cs b/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmapSet.cs
index 619b1e0fd0..618c5cf5ec 100644
--- a/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmapSet.cs
+++ b/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmapSet.cs
@@ -61,7 +61,11 @@ namespace osu.Game.Screens.Select.Carousel
         [BackgroundDependencyLoader(true)]
         private void load(BeatmapSetOverlay beatmapOverlay)
         {
-            restoreHiddenRequested = s => s.Beatmaps.ForEach(manager.Restore);
+            restoreHiddenRequested = s =>
+            {
+                foreach (var b in s.Beatmaps)
+                    manager.Restore(b);
+            };
 
             if (beatmapOverlay != null)
                 viewDetails = beatmapOverlay.FetchAndShowBeatmapSet;
@@ -214,8 +218,8 @@ namespace osu.Game.Screens.Select.Carousel
                 if (Item.State.Value == CarouselItemState.NotSelected)
                     items.Add(new OsuMenuItem("Expand", MenuItemType.Highlighted, () => Item.State.Value = CarouselItemState.Selected));
 
-                if (beatmapSet.OnlineID != null && viewDetails != null)
-                    items.Add(new OsuMenuItem("Details...", MenuItemType.Standard, () => viewDetails(beatmapSet.OnlineID.Value)));
+                if (beatmapSet.OnlineID > 0 && viewDetails != null)
+                    items.Add(new OsuMenuItem("Details...", MenuItemType.Standard, () => viewDetails(beatmapSet.OnlineID)));
 
                 if (collectionManager != null)
                 {
diff --git a/osu.Game/Screens/Select/SongSelect.cs b/osu.Game/Screens/Select/SongSelect.cs
index a40e8e2bde..1aab84183a 100644
--- a/osu.Game/Screens/Select/SongSelect.cs
+++ b/osu.Game/Screens/Select/SongSelect.cs
@@ -295,7 +295,7 @@ namespace osu.Game.Screens.Select
                 Schedule(() =>
                 {
                     // if we have no beatmaps, let's prompt the user to import from over a stable install if he has one.
-                    if (!beatmaps.GetAllUsableBeatmapSetsEnumerable(IncludedDetails.Minimal).Any() && DisplayStableImportPrompt)
+                    if (!beatmaps.GetAllUsableBeatmapSetsEnumerable().Any() && DisplayStableImportPrompt)
                     {
                         dialogOverlay.Push(new ImportFromStablePopup(() =>
                         {
diff --git a/osu.Game/Stores/BeatmapImporter.cs b/osu.Game/Stores/BeatmapImporter.cs
index de92da394d..2c73bd22eb 100644
--- a/osu.Game/Stores/BeatmapImporter.cs
+++ b/osu.Game/Stores/BeatmapImporter.cs
@@ -34,7 +34,7 @@ namespace osu.Game.Stores
     /// Handles the storage and retrieval of Beatmaps/WorkingBeatmaps.
     /// </summary>
     [ExcludeFromDynamicCompile]
-    public class BeatmapImporter : RealmArchiveModelImporter<BeatmapSetInfo>, IDisposable
+    public abstract class BeatmapImporter : RealmArchiveModelManager<BeatmapSetInfo>, IDisposable
     {
         public override IEnumerable<string> HandledExtensions => new[] { ".osz" };
 
@@ -45,7 +45,7 @@ namespace osu.Game.Stores
 
         private readonly BeatmapOnlineLookupQueue? onlineLookupQueue;
 
-        public BeatmapImporter(RealmContextFactory contextFactory, Storage storage, BeatmapOnlineLookupQueue? onlineLookupQueue = null)
+        protected BeatmapImporter(RealmContextFactory contextFactory, Storage storage, BeatmapOnlineLookupQueue? onlineLookupQueue = null)
             : base(storage, contextFactory)
         {
             this.onlineLookupQueue = onlineLookupQueue;
diff --git a/osu.Game/Storyboards/Drawables/DrawableStoryboard.cs b/osu.Game/Storyboards/Drawables/DrawableStoryboard.cs
index 8a31e4576a..d21813d97f 100644
--- a/osu.Game/Storyboards/Drawables/DrawableStoryboard.cs
+++ b/osu.Game/Storyboards/Drawables/DrawableStoryboard.cs
@@ -10,8 +10,8 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Textures;
 using osu.Framework.Platform;
-using osu.Game.IO;
 using osu.Game.Screens.Play;
+using osu.Game.Stores;
 
 namespace osu.Game.Storyboards.Drawables
 {
@@ -76,7 +76,7 @@ namespace osu.Game.Storyboards.Drawables
         }
 
         [BackgroundDependencyLoader(true)]
-        private void load(FileStore fileStore, GameplayClock clock, CancellationToken? cancellationToken, GameHost host)
+        private void load(RealmFileStore fileStore, GameplayClock clock, CancellationToken? cancellationToken, GameHost host)
         {
             if (clock != null)
                 Clock = clock;
diff --git a/osu.Game/Tests/Beatmaps/TestBeatmap.cs b/osu.Game/Tests/Beatmaps/TestBeatmap.cs
index 99944bcf6d..3b4547cb49 100644
--- a/osu.Game/Tests/Beatmaps/TestBeatmap.cs
+++ b/osu.Game/Tests/Beatmaps/TestBeatmap.cs
@@ -32,14 +32,12 @@ namespace osu.Game.Tests.Beatmaps
                 HitObjects = baseBeatmap.HitObjects;
 
             BeatmapInfo.Ruleset = ruleset;
-            BeatmapInfo.RulesetID = ruleset.ID ?? 0;
             BeatmapInfo.Length = 75000;
             BeatmapInfo.OnlineInfo = new APIBeatmap();
             BeatmapInfo.OnlineID = Interlocked.Increment(ref onlineBeatmapID);
 
             Debug.Assert(BeatmapInfo.BeatmapSet != null);
 
-            BeatmapInfo.BeatmapSet.Metadata = BeatmapInfo.Metadata;
             BeatmapInfo.BeatmapSet.Beatmaps.Add(BeatmapInfo);
             BeatmapInfo.BeatmapSet.OnlineID = Interlocked.Increment(ref onlineSetID);
         }
diff --git a/osu.Game/Tests/Visual/EditorTestScene.cs b/osu.Game/Tests/Visual/EditorTestScene.cs
index a2f567f3b0..570e4c26b3 100644
--- a/osu.Game/Tests/Visual/EditorTestScene.cs
+++ b/osu.Game/Tests/Visual/EditorTestScene.cs
@@ -122,9 +122,9 @@ namespace osu.Game.Tests.Visual
                 this.testBeatmap = testBeatmap;
             }
 
-            protected override BeatmapModelManager CreateBeatmapModelManager(Storage storage, IDatabaseContextFactory contextFactory, RulesetStore rulesets, IAPIProvider api, GameHost host)
+            protected override BeatmapModelManager CreateBeatmapModelManager(Storage storage, RealmContextFactory contextFactory, RulesetStore rulesets, BeatmapOnlineLookupQueue onlineLookupQueue)
             {
-                return new TestBeatmapModelManager(storage, contextFactory, rulesets, api, host);
+                return new TestBeatmapModelManager(storage, contextFactory, rulesets, onlineLookupQueue);
             }
 
             protected override WorkingBeatmapCache CreateWorkingBeatmapCache(AudioManager audioManager, IResourceStore<byte[]> resources, IResourceStore<byte[]> storage, WorkingBeatmap defaultBeatmap, GameHost host)
@@ -148,8 +148,8 @@ namespace osu.Game.Tests.Visual
 
             internal class TestBeatmapModelManager : BeatmapModelManager
             {
-                public TestBeatmapModelManager(Storage storage, IDatabaseContextFactory databaseContextFactory, RulesetStore rulesetStore, IAPIProvider apiProvider, GameHost gameHost)
-                    : base(storage, databaseContextFactory, rulesetStore, gameHost)
+                public TestBeatmapModelManager(Storage storage, RealmContextFactory databaseContextFactory, RulesetStore rulesetStore, BeatmapOnlineLookupQueue beatmapOnlineLookupQueue)
+                    : base(databaseContextFactory, storage, beatmapOnlineLookupQueue)
                 {
                 }
 

From d7fe3584cde52011d776d26f1bcb95a651d56896 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 14 Dec 2021 21:00:19 +0900
Subject: [PATCH 2028/5547] Don't persist `Countdown` to realm for now

It's another enum which is a pain to handle, and not actually being
consumed anywhere.
---
 osu.Game/Beatmaps/BeatmapInfo.cs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Game/Beatmaps/BeatmapInfo.cs b/osu.Game/Beatmaps/BeatmapInfo.cs
index 796c2b2e90..fc0d007df4 100644
--- a/osu.Game/Beatmaps/BeatmapInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapInfo.cs
@@ -101,6 +101,7 @@ namespace osu.Game.Beatmaps
 
         public double TimelineZoom { get; set; }
 
+        [Ignored]
         public CountdownType Countdown { get; set; } = CountdownType.Normal;
 
         /// <summary>

From 8d943b57095cc17f172ba83086b50d05c86bed89 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 15 Dec 2021 00:31:35 +0900
Subject: [PATCH 2029/5547] Fix many shortcomings and compatibility issues with
 EF classes post-rename

---
 osu.Game/Beatmaps/BeatmapSetFileInfo.cs  |  4 +++-
 osu.Game/Beatmaps/EFBeatmapDifficulty.cs |  2 ++
 osu.Game/Beatmaps/EFBeatmapInfo.cs       |  3 ++-
 osu.Game/Beatmaps/EFBeatmapMetadata.cs   |  1 +
 osu.Game/Beatmaps/EFBeatmapSetInfo.cs    |  2 ++
 osu.Game/Database/OsuDbContext.cs        |  2 +-
 osu.Game/Rulesets/EFRulesetInfo.cs       |  1 +
 osu.Game/Scoring/EFScoreInfo.cs          | 29 +++++++++++++-----------
 osu.Game/Scoring/ScoreFileInfo.cs        |  4 ++++
 osu.Game/Scoring/ScoreInfo.cs            |  9 --------
 10 files changed, 32 insertions(+), 25 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapSetFileInfo.cs b/osu.Game/Beatmaps/BeatmapSetFileInfo.cs
index 29dcf4d6aa..3d41f59b3d 100644
--- a/osu.Game/Beatmaps/BeatmapSetFileInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapSetFileInfo.cs
@@ -15,6 +15,8 @@ namespace osu.Game.Beatmaps
 
         public int BeatmapSetInfoID { get; set; }
 
+        public EFBeatmapSetInfo BeatmapSetInfo { get; set; }
+
         public int FileInfoID { get; set; }
 
         public FileInfo FileInfo { get; set; }
@@ -22,6 +24,6 @@ namespace osu.Game.Beatmaps
         [Required]
         public string Filename { get; set; }
 
-        public IFileInfo File => FileInfo;
+        IFileInfo INamedFileUsage.File => FileInfo;
     }
 }
diff --git a/osu.Game/Beatmaps/EFBeatmapDifficulty.cs b/osu.Game/Beatmaps/EFBeatmapDifficulty.cs
index 843c6ac6bf..38371d3b38 100644
--- a/osu.Game/Beatmaps/EFBeatmapDifficulty.cs
+++ b/osu.Game/Beatmaps/EFBeatmapDifficulty.cs
@@ -2,10 +2,12 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
+using System.ComponentModel.DataAnnotations.Schema;
 using osu.Game.Database;
 
 namespace osu.Game.Beatmaps
 {
+    [Table(@"BeatmapDifficulty")]
     public class EFBeatmapDifficulty : IHasPrimaryKey, IBeatmapDifficultyInfo
     {
         /// <summary>
diff --git a/osu.Game/Beatmaps/EFBeatmapInfo.cs b/osu.Game/Beatmaps/EFBeatmapInfo.cs
index 2336eeb456..8257d0cf7d 100644
--- a/osu.Game/Beatmaps/EFBeatmapInfo.cs
+++ b/osu.Game/Beatmaps/EFBeatmapInfo.cs
@@ -16,6 +16,7 @@ namespace osu.Game.Beatmaps
 {
     [ExcludeFromDynamicCompile]
     [Serializable]
+    [Table(@"BeatmapInfo")]
     public class EFBeatmapInfo : IEquatable<EFBeatmapInfo>, IHasPrimaryKey, IBeatmapInfo
     {
         public int ID { get; set; }
@@ -124,7 +125,7 @@ namespace osu.Game.Beatmaps
         /// <summary>
         /// Currently only populated for beatmap deletion. Use <see cref="ScoreManager"/> to query scores.
         /// </summary>
-        public List<ScoreInfo> Scores { get; set; }
+        public List<EFScoreInfo> Scores { get; set; }
 
         [JsonIgnore]
         public DifficultyRating DifficultyRating => BeatmapDifficultyCache.GetDifficultyRating(StarRating);
diff --git a/osu.Game/Beatmaps/EFBeatmapMetadata.cs b/osu.Game/Beatmaps/EFBeatmapMetadata.cs
index 6c192088dc..7c27863a7f 100644
--- a/osu.Game/Beatmaps/EFBeatmapMetadata.cs
+++ b/osu.Game/Beatmaps/EFBeatmapMetadata.cs
@@ -16,6 +16,7 @@ namespace osu.Game.Beatmaps
 {
     [ExcludeFromDynamicCompile]
     [Serializable]
+    [Table(@"BeatmapMetadata")]
     public class EFBeatmapMetadata : IEquatable<EFBeatmapMetadata>, IHasPrimaryKey, IBeatmapMetadataInfo
     {
         public int ID { get; set; }
diff --git a/osu.Game/Beatmaps/EFBeatmapSetInfo.cs b/osu.Game/Beatmaps/EFBeatmapSetInfo.cs
index 10910d9817..12235abce0 100644
--- a/osu.Game/Beatmaps/EFBeatmapSetInfo.cs
+++ b/osu.Game/Beatmaps/EFBeatmapSetInfo.cs
@@ -14,6 +14,8 @@ using osu.Game.Extensions;
 namespace osu.Game.Beatmaps
 {
     [ExcludeFromDynamicCompile]
+    [Serializable]
+    [Table(@"BeatmapSetInfo")]
     public class EFBeatmapSetInfo : IHasPrimaryKey, IHasFiles<BeatmapSetFileInfo>, ISoftDelete, IEquatable<EFBeatmapSetInfo>, IBeatmapSetInfo
     {
         public int ID { get; set; }
diff --git a/osu.Game/Database/OsuDbContext.cs b/osu.Game/Database/OsuDbContext.cs
index fb83592c01..441b090a6e 100644
--- a/osu.Game/Database/OsuDbContext.cs
+++ b/osu.Game/Database/OsuDbContext.cs
@@ -147,7 +147,7 @@ namespace osu.Game.Database
 
             modelBuilder.Entity<EFBeatmapInfo>().HasOne(b => b.BaseDifficulty);
 
-            modelBuilder.Entity<ScoreInfo>().HasIndex(b => b.OnlineID).IsUnique();
+            modelBuilder.Entity<EFScoreInfo>().HasIndex(b => b.OnlineID).IsUnique();
         }
 
         private class OsuDbLoggerFactory : ILoggerFactory
diff --git a/osu.Game/Rulesets/EFRulesetInfo.cs b/osu.Game/Rulesets/EFRulesetInfo.cs
index a7070ad2b6..473b7c657e 100644
--- a/osu.Game/Rulesets/EFRulesetInfo.cs
+++ b/osu.Game/Rulesets/EFRulesetInfo.cs
@@ -10,6 +10,7 @@ using osu.Framework.Testing;
 namespace osu.Game.Rulesets
 {
     [ExcludeFromDynamicCompile]
+    [Table(@"RulesetInfo")]
     public sealed class EFRulesetInfo : IEquatable<EFRulesetInfo>, IRulesetInfo
     {
         public int? ID { get; set; }
diff --git a/osu.Game/Scoring/EFScoreInfo.cs b/osu.Game/Scoring/EFScoreInfo.cs
index 84b41e40ef..1dd4e3b6b3 100644
--- a/osu.Game/Scoring/EFScoreInfo.cs
+++ b/osu.Game/Scoring/EFScoreInfo.cs
@@ -19,6 +19,7 @@ using osu.Game.Utils;
 
 namespace osu.Game.Scoring
 {
+    [Table(@"ScoreInfo")]
     public class EFScoreInfo : IScoreInfo, IHasFiles<ScoreFileInfo>, IHasPrimaryKey, ISoftDelete, IEquatable<EFScoreInfo>, IDeepCloneable<EFScoreInfo>
     {
         public int ID { get; set; }
@@ -45,7 +46,7 @@ namespace osu.Game.Scoring
         [NotMapped]
         public bool Passed { get; set; } = true;
 
-        public RulesetInfo Ruleset { get; set; }
+        public EFRulesetInfo Ruleset { get; set; }
 
         private APIMod[] localAPIMods;
 
@@ -135,9 +136,17 @@ namespace osu.Game.Scoring
         public int BeatmapInfoID { get; set; }
 
         [Column("Beatmap")]
-        public BeatmapInfo BeatmapInfo { get; set; }
+        public EFBeatmapInfo BeatmapInfo { get; set; }
 
-        public long? OnlineScoreID { get; set; }
+        private long? onlineID;
+
+        [JsonProperty("id")]
+        [Column("OnlineScoreID")]
+        public long? OnlineID
+        {
+            get => onlineID;
+            set => onlineID = value > 0 ? value : null;
+        }
 
         public DateTimeOffset Date { get; set; }
 
@@ -232,24 +241,18 @@ namespace osu.Game.Scoring
 
         public bool Equals(EFScoreInfo other)
         {
-            if (other == null)
-                return false;
+            if (ReferenceEquals(this, other)) return true;
+            if (other == null) return false;
 
             if (ID != 0 && other.ID != 0)
                 return ID == other.ID;
 
-            if (OnlineScoreID.HasValue && other.OnlineScoreID.HasValue)
-                return OnlineScoreID == other.OnlineScoreID;
-
-            if (!string.IsNullOrEmpty(Hash) && !string.IsNullOrEmpty(other.Hash))
-                return Hash == other.Hash;
-
-            return ReferenceEquals(this, other);
+            return false;
         }
 
         #region Implementation of IHasOnlineID
 
-        public long OnlineID => OnlineScoreID ?? -1;
+        long IHasOnlineID<long>.OnlineID => OnlineID ?? -1;
 
         #endregion
 
diff --git a/osu.Game/Scoring/ScoreFileInfo.cs b/osu.Game/Scoring/ScoreFileInfo.cs
index 4c88cfa021..8acc98eff6 100644
--- a/osu.Game/Scoring/ScoreFileInfo.cs
+++ b/osu.Game/Scoring/ScoreFileInfo.cs
@@ -13,6 +13,10 @@ namespace osu.Game.Scoring
 
         public bool IsManaged => ID > 0;
 
+        public int ScoreInfoID { get; set; }
+
+        public EFScoreInfo ScoreInfo { get; set; }
+
         public int FileInfoID { get; set; }
 
         public FileInfo FileInfo { get; set; }
diff --git a/osu.Game/Scoring/ScoreInfo.cs b/osu.Game/Scoring/ScoreInfo.cs
index 20b6ba7a93..65c31951b8 100644
--- a/osu.Game/Scoring/ScoreInfo.cs
+++ b/osu.Game/Scoring/ScoreInfo.cs
@@ -3,7 +3,6 @@
 
 using System;
 using System.Collections.Generic;
-using System.ComponentModel.DataAnnotations.Schema;
 using System.Linq;
 using Newtonsoft.Json;
 using osu.Framework.Localisation;
@@ -215,14 +214,6 @@ namespace osu.Game.Scoring
             }
         }
 
-        // Used for database serialisation/deserialisation.
-        [Column("Mods")]
-        public string ModsJson
-        {
-            get => JsonConvert.SerializeObject(APIMods);
-            set => APIMods = JsonConvert.DeserializeObject<APIMod[]>(value) ?? Array.Empty<APIMod>();
-        }
-
         public IEnumerable<HitResultDisplayStatistic> GetStatisticsForDisplay()
         {
             foreach (var r in Ruleset.CreateInstance().GetHitResults())

From 3ecd535f6e7f49fb2484109d0d44377810a7e9bb Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 15 Dec 2021 00:33:00 +0900
Subject: [PATCH 2030/5547] Add back missing `IRulesetStore` cache

---
 osu.Game/OsuGameBase.cs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Game/OsuGameBase.cs b/osu.Game/OsuGameBase.cs
index 89e3fe5742..ac04be532a 100644
--- a/osu.Game/OsuGameBase.cs
+++ b/osu.Game/OsuGameBase.cs
@@ -222,6 +222,7 @@ namespace osu.Game
             var defaultBeatmap = new DummyWorkingBeatmap(Audio, Textures);
 
             dependencies.Cache(RulesetStore = new RulesetStore(realmFactory, Storage));
+            dependencies.CacheAs<IRulesetStore>(RulesetStore);
 
             // ordering is important here to ensure foreign keys rules are not broken in ModelStore.Cleanup()
             dependencies.Cache(ScoreManager = new ScoreManager(RulesetStore, () => BeatmapManager, Storage, realmFactory, Scheduler, Host, () => difficultyCache, LocalConfig));

From c4a9211179ed93cd287e67aa763e14dfae8ae54a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 15 Dec 2021 14:26:38 +0900
Subject: [PATCH 2031/5547] Apply NRT to `BeatmapManager` and move
 `Hide`/`Restore` methods across

---
 osu.Game/Beatmaps/BeatmapManager.cs      | 94 +++++++++++++-----------
 osu.Game/Beatmaps/BeatmapModelManager.cs | 45 ------------
 2 files changed, 51 insertions(+), 88 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index 45ae69e4ba..efe9c65f9f 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -8,7 +8,6 @@ using System.Linq;
 using System.Linq.Expressions;
 using System.Threading;
 using System.Threading.Tasks;
-using JetBrains.Annotations;
 using osu.Framework.Audio;
 using osu.Framework.Audio.Track;
 using osu.Framework.Extensions;
@@ -25,6 +24,8 @@ using osu.Game.Rulesets;
 using osu.Game.Skinning;
 using osu.Game.Stores;
 
+#nullable enable
+
 namespace osu.Game.Beatmaps
 {
     /// <summary>
@@ -38,10 +39,13 @@ namespace osu.Game.Beatmaps
         private readonly BeatmapModelManager beatmapModelManager;
 
         private readonly WorkingBeatmapCache workingBeatmapCache;
-        private readonly BeatmapOnlineLookupQueue onlineBeatmapLookupQueue;
+        private readonly BeatmapOnlineLookupQueue? onlineBeatmapLookupQueue;
 
-        public BeatmapManager(Storage storage, RealmContextFactory contextFactory, RulesetStore rulesets, IAPIProvider api, [NotNull] AudioManager audioManager, IResourceStore<byte[]> gameResources, GameHost host = null, WorkingBeatmap defaultBeatmap = null, bool performOnlineLookups = false)
+        private readonly RealmContextFactory contextFactory;
+
+        public BeatmapManager(Storage storage, RealmContextFactory contextFactory, RulesetStore rulesets, IAPIProvider api, AudioManager audioManager, IResourceStore<byte[]> gameResources, GameHost? host = null, WorkingBeatmap? defaultBeatmap = null, bool performOnlineLookups = false)
         {
+            this.contextFactory = contextFactory;
             if (performOnlineLookups)
                 onlineBeatmapLookupQueue = new BeatmapOnlineLookupQueue(api, storage);
 
@@ -56,12 +60,12 @@ namespace osu.Game.Beatmaps
             beatmapModelManager.WorkingBeatmapCache = workingBeatmapCache;
         }
 
-        protected virtual WorkingBeatmapCache CreateWorkingBeatmapCache(AudioManager audioManager, IResourceStore<byte[]> resources, IResourceStore<byte[]> storage, WorkingBeatmap defaultBeatmap, GameHost host)
+        protected virtual WorkingBeatmapCache CreateWorkingBeatmapCache(AudioManager audioManager, IResourceStore<byte[]> resources, IResourceStore<byte[]> storage, WorkingBeatmap? defaultBeatmap, GameHost? host)
         {
             return new WorkingBeatmapCache(BeatmapTrackStore, audioManager, resources, storage, defaultBeatmap, host);
         }
 
-        protected virtual BeatmapModelManager CreateBeatmapModelManager(Storage storage, RealmContextFactory contextFactory, RulesetStore rulesets, [CanBeNull] BeatmapOnlineLookupQueue onlineLookupQueue) =>
+        protected virtual BeatmapModelManager CreateBeatmapModelManager(Storage storage, RealmContextFactory contextFactory, RulesetStore rulesets, BeatmapOnlineLookupQueue? onlineLookupQueue) =>
             new BeatmapModelManager(contextFactory, storage, onlineLookupQueue);
 
         /// <summary>
@@ -103,19 +107,43 @@ namespace osu.Game.Beatmaps
         /// <summary>
         /// Fired when a single difficulty has been hidden.
         /// </summary>
-        public event Action<BeatmapInfo> BeatmapHidden
-        {
-            add => beatmapModelManager.BeatmapHidden += value;
-            remove => beatmapModelManager.BeatmapHidden -= value;
-        }
+        public event Action<BeatmapInfo>? BeatmapHidden;
 
         /// <summary>
         /// Fired when a single difficulty has been restored.
         /// </summary>
-        public event Action<BeatmapInfo> BeatmapRestored
+        public event Action<BeatmapInfo>? BeatmapRestored;
+
+        /// <summary>
+        /// Delete a beatmap difficulty.
+        /// </summary>
+        /// <param name="beatmapInfo">The beatmap difficulty to hide.</param>
+        public void Hide(BeatmapInfo beatmapInfo)
         {
-            add => beatmapModelManager.BeatmapRestored += value;
-            remove => beatmapModelManager.BeatmapRestored -= value;
+            using (var realm = contextFactory.CreateContext())
+            using (var transaction = realm.BeginWrite())
+            {
+                beatmapInfo.Hidden = true;
+                transaction.Commit();
+
+                BeatmapHidden?.Invoke(beatmapInfo);
+            }
+        }
+
+        /// <summary>
+        /// Restore a beatmap difficulty.
+        /// </summary>
+        /// <param name="beatmapInfo">The beatmap difficulty to restore.</param>
+        public void Restore(BeatmapInfo beatmapInfo)
+        {
+            using (var realm = contextFactory.CreateContext())
+            using (var transaction = realm.BeginWrite())
+            {
+                beatmapInfo.Hidden = false;
+                transaction.Commit();
+
+                BeatmapRestored?.Invoke(beatmapInfo);
+            }
         }
 
         /// <summary>
@@ -124,7 +152,7 @@ namespace osu.Game.Beatmaps
         /// <param name="info">The <see cref="BeatmapInfo"/> to save the content against. The file referenced by <see cref="BeatmapInfo.Path"/> will be replaced.</param>
         /// <param name="beatmapContent">The <see cref="IBeatmap"/> content to write.</param>
         /// <param name="beatmapSkin">The beatmap <see cref="ISkin"/> content to write, null if to be omitted.</param>
-        public virtual void Save(BeatmapInfo info, IBeatmap beatmapContent, ISkin beatmapSkin = null) =>
+        public virtual void Save(BeatmapInfo info, IBeatmap beatmapContent, ISkin? beatmapSkin = null) =>
             beatmapModelManager.Save(info, beatmapContent, beatmapSkin);
 
         /// <summary>
@@ -152,7 +180,7 @@ namespace osu.Game.Beatmaps
         /// </summary>
         /// <param name="query">The query.</param>
         /// <returns>The first result for the provided query, or null if no results were found.</returns>
-        public BeatmapSetInfo QueryBeatmapSet(Expression<Func<BeatmapSetInfo, bool>> query) => beatmapModelManager.QueryBeatmapSet(query);
+        public BeatmapSetInfo? QueryBeatmapSet(Expression<Func<BeatmapSetInfo, bool>> query) => beatmapModelManager.QueryBeatmapSet(query);
 
         /// <summary>
         /// Perform a lookup query on available <see cref="BeatmapInfo"/>s.
@@ -166,7 +194,7 @@ namespace osu.Game.Beatmaps
         /// </summary>
         /// <param name="query">The query.</param>
         /// <returns>The first result for the provided query, or null if no results were found.</returns>
-        public BeatmapInfo QueryBeatmap(Expression<Func<BeatmapInfo, bool>> query) => beatmapModelManager.QueryBeatmap(query);
+        public BeatmapInfo? QueryBeatmap(Expression<Func<BeatmapInfo, bool>> query) => beatmapModelManager.QueryBeatmap(query);
 
         /// <summary>
         /// A default representation of a WorkingBeatmap to use when no beatmap is available.
@@ -181,18 +209,6 @@ namespace osu.Game.Beatmaps
             set => beatmapModelManager.PostNotification = value;
         }
 
-        /// <summary>
-        /// Delete a beatmap difficulty.
-        /// </summary>
-        /// <param name="beatmapInfo">The beatmap difficulty to hide.</param>
-        public void Hide(BeatmapInfo beatmapInfo) => beatmapModelManager.Hide(beatmapInfo);
-
-        /// <summary>
-        /// Restore a beatmap difficulty.
-        /// </summary>
-        /// <param name="beatmapInfo">The beatmap difficulty to restore.</param>
-        public void Restore(BeatmapInfo beatmapInfo) => beatmapModelManager.Restore(beatmapInfo);
-
         #endregion
 
         #region Implementation of IModelManager<BeatmapSetInfo>
@@ -202,17 +218,9 @@ namespace osu.Game.Beatmaps
             return beatmapModelManager.IsAvailableLocally(model);
         }
 
-        public event Action<BeatmapSetInfo> ItemUpdated
-        {
-            add => beatmapModelManager.ItemUpdated += value;
-            remove => beatmapModelManager.ItemUpdated -= value;
-        }
+        public event Action<BeatmapSetInfo>? ItemUpdated;
 
-        public event Action<BeatmapSetInfo> ItemRemoved
-        {
-            add => beatmapModelManager.ItemRemoved += value;
-            remove => beatmapModelManager.ItemRemoved -= value;
-        }
+        public event Action<BeatmapSetInfo>? ItemRemoved;
 
         public void Update(BeatmapSetInfo item)
         {
@@ -258,17 +266,17 @@ namespace osu.Game.Beatmaps
             return beatmapModelManager.Import(notification, tasks);
         }
 
-        public Task<ILive<BeatmapSetInfo>> Import(ImportTask task, bool lowPriority = false, CancellationToken cancellationToken = default)
+        public Task<ILive<BeatmapSetInfo>?> Import(ImportTask task, bool lowPriority = false, CancellationToken cancellationToken = default)
         {
             return beatmapModelManager.Import(task, lowPriority, cancellationToken);
         }
 
-        public Task<ILive<BeatmapSetInfo>> Import(ArchiveReader archive, bool lowPriority = false, CancellationToken cancellationToken = default)
+        public Task<ILive<BeatmapSetInfo>?> Import(ArchiveReader archive, bool lowPriority = false, CancellationToken cancellationToken = default)
         {
             return beatmapModelManager.Import(archive, lowPriority, cancellationToken);
         }
 
-        public Task<ILive<BeatmapSetInfo>> Import(BeatmapSetInfo item, ArchiveReader archive = null, bool lowPriority = false, CancellationToken cancellationToken = default)
+        public Task<ILive<BeatmapSetInfo>?> Import(BeatmapSetInfo item, ArchiveReader? archive = null, bool lowPriority = false, CancellationToken cancellationToken = default)
         {
             return beatmapModelManager.Import(item, archive, lowPriority, cancellationToken);
         }
@@ -279,7 +287,7 @@ namespace osu.Game.Beatmaps
 
         #region Implementation of IWorkingBeatmapCache
 
-        public WorkingBeatmap GetWorkingBeatmap(BeatmapInfo importedBeatmap) => workingBeatmapCache.GetWorkingBeatmap(importedBeatmap);
+        public WorkingBeatmap GetWorkingBeatmap(BeatmapInfo? importedBeatmap) => workingBeatmapCache.GetWorkingBeatmap(importedBeatmap);
 
         void IWorkingBeatmapCache.Invalidate(BeatmapSetInfo beatmapSetInfo) => workingBeatmapCache.Invalidate(beatmapSetInfo);
         void IWorkingBeatmapCache.Invalidate(BeatmapInfo beatmapInfo) => workingBeatmapCache.Invalidate(beatmapInfo);
@@ -316,7 +324,7 @@ namespace osu.Game.Beatmaps
 
         #region Implementation of IPostImports<out BeatmapSetInfo>
 
-        public Action<IEnumerable<ILive<BeatmapSetInfo>>> PostImport
+        public Action<IEnumerable<ILive<BeatmapSetInfo>>>? PostImport
         {
             set => beatmapModelManager.PostImport = value;
         }
diff --git a/osu.Game/Beatmaps/BeatmapModelManager.cs b/osu.Game/Beatmaps/BeatmapModelManager.cs
index 100189bf09..1d1aa20a5b 100644
--- a/osu.Game/Beatmaps/BeatmapModelManager.cs
+++ b/osu.Game/Beatmaps/BeatmapModelManager.cs
@@ -21,22 +21,9 @@ using osu.Game.Stores;
 
 namespace osu.Game.Beatmaps
 {
-    /// <summary>
-    /// Handles ef-core storage of beatmaps.
-    /// </summary>
     [ExcludeFromDynamicCompile]
     public class BeatmapModelManager : BeatmapImporter
     {
-        /// <summary>
-        /// Fired when a single difficulty has been hidden.
-        /// </summary>
-        public event Action<BeatmapInfo>? BeatmapHidden;
-
-        /// <summary>
-        /// Fired when a single difficulty has been restored.
-        /// </summary>
-        public event Action<BeatmapInfo>? BeatmapRestored;
-
         /// <summary>
         /// The game working beatmap cache, used to invalidate entries on changes.
         /// </summary>
@@ -53,38 +40,6 @@ namespace osu.Game.Beatmaps
 
         protected override bool ShouldDeleteArchive(string path) => Path.GetExtension(path)?.ToLowerInvariant() == ".osz";
 
-        /// <summary>
-        /// Delete a beatmap difficulty.
-        /// </summary>
-        /// <param name="beatmapInfo">The beatmap difficulty to hide.</param>
-        public void Hide(BeatmapInfo beatmapInfo)
-        {
-            using (var realm = ContextFactory.CreateContext())
-            using (var transaction = realm.BeginWrite())
-            {
-                beatmapInfo.Hidden = true;
-                transaction.Commit();
-
-                BeatmapHidden?.Invoke(beatmapInfo);
-            }
-        }
-
-        /// <summary>
-        /// Restore a beatmap difficulty.
-        /// </summary>
-        /// <param name="beatmapInfo">The beatmap difficulty to restore.</param>
-        public void Restore(BeatmapInfo beatmapInfo)
-        {
-            using (var realm = ContextFactory.CreateContext())
-            using (var transaction = realm.BeginWrite())
-            {
-                beatmapInfo.Hidden = false;
-                transaction.Commit();
-
-                BeatmapRestored?.Invoke(beatmapInfo);
-            }
-        }
-
         /// <summary>
         /// Saves an <see cref="IBeatmap"/> file against a given <see cref="BeatmapInfo"/>.
         /// </summary>

From abd72c496ba470888ef84b7055fd6078967314a6 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 8 Nov 2021 17:59:23 +0900
Subject: [PATCH 2032/5547] "Update" `MusicController`

---
 osu.Game/Overlays/MusicController.cs | 46 +++++++++++++++++++---------
 1 file changed, 32 insertions(+), 14 deletions(-)

diff --git a/osu.Game/Overlays/MusicController.cs b/osu.Game/Overlays/MusicController.cs
index 310f4946f3..58707c3321 100644
--- a/osu.Game/Overlays/MusicController.cs
+++ b/osu.Game/Overlays/MusicController.cs
@@ -12,10 +12,11 @@ using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Audio;
 using osu.Framework.Graphics.Containers;
-using osu.Framework.Utils;
 using osu.Framework.Threading;
 using osu.Game.Beatmaps;
+using osu.Game.Database;
 using osu.Game.Rulesets.Mods;
+using Realms;
 
 namespace osu.Game.Overlays
 {
@@ -24,6 +25,8 @@ namespace osu.Game.Overlays
     /// </summary>
     public class MusicController : CompositeDrawable
     {
+        private IDisposable beatmapSubscription;
+
         [Resolved]
         private BeatmapManager beatmaps { get; set; }
 
@@ -65,13 +68,14 @@ namespace osu.Game.Overlays
         [NotNull]
         public DrawableTrack CurrentTrack { get; private set; } = new DrawableTrack(new TrackVirtual(1000));
 
-        [BackgroundDependencyLoader]
-        private void load()
-        {
-            beatmaps.ItemUpdated += beatmapUpdated;
-            beatmaps.ItemRemoved += beatmapRemoved;
+        [Resolved]
+        private RealmContextFactory realmFactory { get; set; }
 
-            beatmapSets.AddRange(beatmaps.GetAllUsableBeatmapSets(true).OrderBy(_ => RNG.Next()));
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            beatmapSubscription = realmFactory.Context.All<BeatmapSetInfo>().QueryAsyncWithNotifications(beatmapsChanged);
 
             // Todo: These binds really shouldn't be here, but are unlikely to cause any issues for now.
             // They are placed here for now since some tests rely on setting the beatmap _and_ their hierarchies inside their load(), which runs before the MusicController's load().
@@ -79,6 +83,24 @@ namespace osu.Game.Overlays
             mods.BindValueChanged(_ => ResetTrackAdjustments(), true);
         }
 
+        private void beatmapsChanged(IRealmCollection<BeatmapSetInfo> sender, ChangeSet changes, Exception error)
+        {
+            if (changes == null)
+            {
+                beatmapSets.AddRange(sender);
+                return;
+            }
+
+            // beatmaps.ItemUpdated += set => Schedule(() =>
+            // {
+            //     beatmapSets.Remove(set);
+            //     beatmapSets.Add(set);
+            // });
+            // beatmaps.ItemRemoved += set => Schedule(() => beatmapSets.RemoveAll(s => s.ID == set.ID));
+            //
+            // beatmapSets.AddRange(beatmaps.GetAllUsableBeatmapSets(IncludedDetails.Minimal, true).OrderBy(_ => RNG.Next()));
+        }
+
         /// <summary>
         /// Forcefully reload the current <see cref="WorkingBeatmap"/>'s track from disk.
         /// </summary>
@@ -111,7 +133,7 @@ namespace osu.Game.Overlays
             beatmapSets.Add(set);
         });
 
-        private void beatmapRemoved(BeatmapSetInfo set) => Schedule(() => beatmapSets.RemoveAll(s => s.Equals(set)));
+        private void beatmapRemoved(BeatmapSetInfo set) => Schedule(() => beatmapSets.RemoveAll(s => s.ID == set.ID));
 
         private ScheduledDelegate seekDelegate;
 
@@ -259,7 +281,7 @@ namespace osu.Game.Overlays
 
             queuedDirection = TrackChangeDirection.Next;
 
-            var playable = BeatmapSets.SkipWhile(i => !i.Equals(current.BeatmapSetInfo)).ElementAtOrDefault(1) ?? BeatmapSets.FirstOrDefault();
+            var playable = BeatmapSets.SkipWhile(i => i.ID != current.BeatmapSetInfo.ID).ElementAtOrDefault(1) ?? BeatmapSets.FirstOrDefault();
 
             if (playable != null)
             {
@@ -429,11 +451,7 @@ namespace osu.Game.Overlays
         {
             base.Dispose(isDisposing);
 
-            if (beatmaps != null)
-            {
-                beatmaps.ItemUpdated -= beatmapUpdated;
-                beatmaps.ItemRemoved -= beatmapRemoved;
-            }
+            beatmapSubscription?.Dispose();
         }
     }
 

From 8696f82627ea226831f1c245487a5ef1f2b3ef63 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 15 Dec 2021 14:36:11 +0900
Subject: [PATCH 2033/5547] Fix intro screen

Fix things
---
 osu.Game/Beatmaps/BeatmapManager.cs  | 2 +-
 osu.Game/Screens/Menu/IntroScreen.cs | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index efe9c65f9f..1d39873016 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -173,7 +173,7 @@ namespace osu.Game.Beatmaps
         /// </summary>
         /// <param name="query">The query.</param>
         /// <returns>Results from the provided query.</returns>
-        public IEnumerable<BeatmapSetInfo> QueryBeatmapSets(Expression<Func<BeatmapSetInfo, bool>> query) => beatmapModelManager.QueryBeatmapSets(query);
+        public ILive<IEnumerable<BeatmapSetInfo>> QueryBeatmapSets(Expression<Func<BeatmapSetInfo, bool>> query) => beatmapModelManager.QueryBeatmapSets(query).ToLive(contextFactory);
 
         /// <summary>
         /// Perform a lookup query on available <see cref="BeatmapSetInfo"/>s.
diff --git a/osu.Game/Screens/Menu/IntroScreen.cs b/osu.Game/Screens/Menu/IntroScreen.cs
index 94c48f5251..aa3fe9fd88 100644
--- a/osu.Game/Screens/Menu/IntroScreen.cs
+++ b/osu.Game/Screens/Menu/IntroScreen.cs
@@ -100,7 +100,7 @@ namespace osu.Game.Screens.Menu
                 if (sets.Count > 0)
                 {
                     setInfo = beatmaps.QueryBeatmapSet(s => s.ID == sets[RNG.Next(0, sets.Count - 1)].ID);
-                    initialBeatmap = beatmaps.GetWorkingBeatmap(setInfo.Beatmaps[0]);
+                    initialBeatmap = beatmaps.GetWorkingBeatmap(setInfo?.Beatmaps[0]);
                 }
             }
 
@@ -113,7 +113,7 @@ namespace osu.Game.Screens.Menu
                     // this could happen if a user has nuked their files store. for now, reimport to repair this.
                     var import = beatmaps.Import(new ZipArchiveReader(game.Resources.GetStream($"Tracks/{BeatmapFile}"), BeatmapFile)).GetResultSafely();
 
-                    import.PerformWrite(b =>
+                    import?.PerformWrite(b =>
                     {
                         b.Protected = true;
                         beatmaps.Update(b);

From 3152d2d8a02411fb690965065c03f12ca3f9f1fa Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 8 Nov 2021 17:41:42 +0900
Subject: [PATCH 2034/5547] "Update" `BeatmapCarousel`

---
 .../SongSelect/TestSceneBeatmapCarousel.cs    |  2 -
 osu.Game/Screens/Select/BeatmapCarousel.cs    | 67 ++++++++++++++-----
 2 files changed, 51 insertions(+), 18 deletions(-)

diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs
index 28f5c3ff60..b1414d5896 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs
@@ -873,8 +873,6 @@ namespace osu.Game.Tests.Visual.SongSelect
                     }
                 }
             }
-
-            protected override IEnumerable<BeatmapSetInfo> GetLoadableBeatmaps() => Enumerable.Empty<BeatmapSetInfo>();
         }
     }
 }
diff --git a/osu.Game/Screens/Select/BeatmapCarousel.cs b/osu.Game/Screens/Select/BeatmapCarousel.cs
index f8d2c3cb9b..94e7dc9241 100644
--- a/osu.Game/Screens/Select/BeatmapCarousel.cs
+++ b/osu.Game/Screens/Select/BeatmapCarousel.cs
@@ -18,12 +18,14 @@ using osu.Framework.Threading;
 using osu.Framework.Utils;
 using osu.Game.Beatmaps;
 using osu.Game.Configuration;
+using osu.Game.Database;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Cursor;
 using osu.Game.Input.Bindings;
 using osu.Game.Screens.Select.Carousel;
 using osuTK;
 using osuTK.Input;
+using Realms;
 
 namespace osu.Game.Screens.Select
 {
@@ -172,17 +174,57 @@ namespace osu.Game.Screens.Select
 
             RightClickScrollingEnabled.ValueChanged += enabled => Scroll.RightMouseScrollbar = enabled.NewValue;
             RightClickScrollingEnabled.TriggerChange();
-
-            beatmaps.ItemUpdated += beatmapUpdated;
-            beatmaps.ItemRemoved += beatmapRemoved;
-            beatmaps.BeatmapHidden += beatmapHidden;
-            beatmaps.BeatmapRestored += beatmapRestored;
-
-            if (!beatmapSets.Any())
-                loadBeatmapSets(GetLoadableBeatmaps());
         }
 
-        protected virtual IEnumerable<BeatmapSetInfo> GetLoadableBeatmaps() => beatmaps.GetAllUsableBeatmapSetsEnumerable();
+        [Resolved]
+        private RealmContextFactory realmFactory { get; set; }
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            realmFactory.Context.All<BeatmapSetInfo>().Where(s => !s.DeletePending).QueryAsyncWithNotifications(beatmapSetsChanged);
+            realmFactory.Context.All<BeatmapInfo>().Where(b => !b.Hidden).QueryAsyncWithNotifications(beatmapsChanged);
+        }
+
+        private void beatmapRemoved(BeatmapSetInfo item) => RemoveBeatmapSet(item);
+        private void beatmapUpdated(BeatmapSetInfo item) => UpdateBeatmapSet(item);
+
+        private void beatmapSetsChanged(IRealmCollection<BeatmapSetInfo> sender, ChangeSet changes, Exception error)
+        {
+            if (changes == null)
+            {
+                // initial load
+                loadBeatmapSets(sender);
+                return;
+            }
+
+            foreach (int i in changes.NewModifiedIndices)
+                UpdateBeatmapSet(sender[i]);
+
+            // moves also appear as deletes / inserts but aren't important to us.
+            if (!changes.Moves.Any())
+            {
+                foreach (int i in changes.InsertedIndices)
+                    UpdateBeatmapSet(sender[i]);
+
+                // TODO: This can not work, as we recently found out https://github.com/realm/realm-dotnet/discussions/2634#discussioncomment-1605595.
+                foreach (int i in changes.DeletedIndices)
+                    RemoveBeatmapSet(sender[i]);
+            }
+        }
+
+        private void beatmapsChanged(IRealmCollection<BeatmapInfo> sender, ChangeSet changes, Exception error)
+        {
+            // we only care about actual changes in hidden status.
+            if (changes == null)
+                return;
+
+            // TODO: we can probably handle hidden items at a per-panel level (ie. start a realm subscription from there)?
+            // might be cleaner than handling via reconstruction of the whole set's panels.
+            foreach (int i in changes.NewModifiedIndices)
+                UpdateBeatmapSet(sender[i].BeatmapSet);
+        }
 
         public void RemoveBeatmapSet(BeatmapSetInfo beatmapSet) => Schedule(() =>
         {
@@ -617,11 +659,6 @@ namespace osu.Game.Screens.Select
             return (firstIndex, lastIndex);
         }
 
-        private void beatmapRemoved(BeatmapSetInfo item) => RemoveBeatmapSet(item);
-        private void beatmapUpdated(BeatmapSetInfo item) => UpdateBeatmapSet(item);
-        private void beatmapRestored(BeatmapInfo b) => UpdateBeatmapSet(beatmaps.QueryBeatmapSet(s => s.ID == b.BeatmapSetInfoID));
-        private void beatmapHidden(BeatmapInfo b) => UpdateBeatmapSet(beatmaps.QueryBeatmapSet(s => s.ID == b.BeatmapSetInfoID));
-
         private CarouselBeatmapSet createCarouselSet(BeatmapSetInfo beatmapSet)
         {
             if (beatmapSet.Beatmaps.All(b => b.Hidden))
@@ -888,8 +925,6 @@ namespace osu.Game.Screens.Select
             {
                 beatmaps.ItemUpdated -= beatmapUpdated;
                 beatmaps.ItemRemoved -= beatmapRemoved;
-                beatmaps.BeatmapHidden -= beatmapHidden;
-                beatmaps.BeatmapRestored -= beatmapRestored;
             }
         }
     }

From 1d536fd0bc6bed1575503f7a5f7636cbc0079bc7 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 15 Dec 2021 15:03:06 +0900
Subject: [PATCH 2035/5547] Start introducing `ILive`

---
 osu.Game/Beatmaps/BeatmapManager.cs           |  4 +-
 osu.Game/Beatmaps/BeatmapModelManager.cs      |  4 +-
 osu.Game/OsuGame.cs                           | 45 ++++++++++---------
 osu.Game/Overlays/MusicController.cs          |  1 -
 .../Sections/Maintenance/GeneralSettings.cs   |  3 +-
 osu.Game/Screens/Menu/IntroScreen.cs          |  7 +--
 6 files changed, 34 insertions(+), 30 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index 1d39873016..7fb0729967 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -173,14 +173,14 @@ namespace osu.Game.Beatmaps
         /// </summary>
         /// <param name="query">The query.</param>
         /// <returns>Results from the provided query.</returns>
-        public ILive<IEnumerable<BeatmapSetInfo>> QueryBeatmapSets(Expression<Func<BeatmapSetInfo, bool>> query) => beatmapModelManager.QueryBeatmapSets(query).ToLive(contextFactory);
+        public List<ILive<BeatmapSetInfo>> QueryBeatmapSets(Expression<Func<BeatmapSetInfo, bool>> query) => beatmapModelManager.QueryBeatmapSets(query).ToLive();
 
         /// <summary>
         /// Perform a lookup query on available <see cref="BeatmapSetInfo"/>s.
         /// </summary>
         /// <param name="query">The query.</param>
         /// <returns>The first result for the provided query, or null if no results were found.</returns>
-        public BeatmapSetInfo? QueryBeatmapSet(Expression<Func<BeatmapSetInfo, bool>> query) => beatmapModelManager.QueryBeatmapSet(query);
+        public ILive<BeatmapSetInfo>? QueryBeatmapSet(Expression<Func<BeatmapSetInfo, bool>> query) => beatmapModelManager.QueryBeatmapSet(query);
 
         /// <summary>
         /// Perform a lookup query on available <see cref="BeatmapInfo"/>s.
diff --git a/osu.Game/Beatmaps/BeatmapModelManager.cs b/osu.Game/Beatmaps/BeatmapModelManager.cs
index 1d1aa20a5b..839d3df159 100644
--- a/osu.Game/Beatmaps/BeatmapModelManager.cs
+++ b/osu.Game/Beatmaps/BeatmapModelManager.cs
@@ -104,10 +104,10 @@ namespace osu.Game.Beatmaps
         /// </summary>
         /// <param name="query">The query.</param>
         /// <returns>The first result for the provided query, or null if no results were found.</returns>
-        public BeatmapSetInfo? QueryBeatmapSet(Expression<Func<BeatmapSetInfo, bool>> query)
+        public ILive<BeatmapSetInfo>? QueryBeatmapSet(Expression<Func<BeatmapSetInfo, bool>> query)
         {
             using (var context = ContextFactory.CreateContext())
-                return context.All<BeatmapSetInfo>().FirstOrDefault(query); // TODO: ?.ToLive();
+                return context.All<BeatmapSetInfo>().FirstOrDefault(query)?.ToLive();
         }
 
         /// <summary>
diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index 49893a6d36..8d1eccb7c1 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -437,7 +437,7 @@ namespace osu.Game
         /// </remarks>
         public void PresentBeatmap(IBeatmapSetInfo beatmap, Predicate<BeatmapInfo> difficultyCriteria = null)
         {
-            BeatmapSetInfo databasedSet = null;
+            ILive<BeatmapSetInfo> databasedSet = null;
 
             if (beatmap.OnlineID > 0)
                 databasedSet = BeatmapManager.QueryBeatmapSet(s => s.OnlineID == beatmap.OnlineID);
@@ -453,27 +453,30 @@ namespace osu.Game
 
             PerformFromScreen(screen =>
             {
-                // Find beatmaps that match our predicate.
-                var beatmaps = databasedSet.Beatmaps.Where(b => difficultyCriteria?.Invoke(b) ?? true).ToList();
-
-                // Use all beatmaps if predicate matched nothing
-                if (beatmaps.Count == 0)
-                    beatmaps = databasedSet.Beatmaps.ToList();
-
-                // Prefer recommended beatmap if recommendations are available, else fallback to a sane selection.
-                var selection = difficultyRecommender.GetRecommendedBeatmap(beatmaps)
-                                ?? beatmaps.FirstOrDefault(b => b.Ruleset.Equals(Ruleset.Value))
-                                ?? beatmaps.First();
-
-                if (screen is IHandlePresentBeatmap presentableScreen)
+                databasedSet.PerformRead(set =>
                 {
-                    presentableScreen.PresentBeatmap(BeatmapManager.GetWorkingBeatmap(selection), selection.Ruleset);
-                }
-                else
-                {
-                    Ruleset.Value = selection.Ruleset;
-                    Beatmap.Value = BeatmapManager.GetWorkingBeatmap(selection);
-                }
+                    // Find beatmaps that match our predicate.
+                    var beatmaps = set.Beatmaps.Where(b => difficultyCriteria?.Invoke(b) ?? true).ToList();
+
+                    // Use all beatmaps if predicate matched nothing
+                    if (beatmaps.Count == 0)
+                        beatmaps = set.Beatmaps.ToList();
+
+                    // Prefer recommended beatmap if recommendations are available, else fallback to a sane selection.
+                    var selection = difficultyRecommender.GetRecommendedBeatmap(beatmaps)
+                                    ?? beatmaps.FirstOrDefault(b => b.Ruleset.Equals(Ruleset.Value))
+                                    ?? beatmaps.First();
+
+                    if (screen is IHandlePresentBeatmap presentableScreen)
+                    {
+                        presentableScreen.PresentBeatmap(BeatmapManager.GetWorkingBeatmap(selection), selection.Ruleset);
+                    }
+                    else
+                    {
+                        Ruleset.Value = selection.Ruleset;
+                        Beatmap.Value = BeatmapManager.GetWorkingBeatmap(selection);
+                    }
+                });
             }, validScreens: new[] { typeof(SongSelect), typeof(IHandlePresentBeatmap) });
         }
 
diff --git a/osu.Game/Overlays/MusicController.cs b/osu.Game/Overlays/MusicController.cs
index 58707c3321..8c115c2c94 100644
--- a/osu.Game/Overlays/MusicController.cs
+++ b/osu.Game/Overlays/MusicController.cs
@@ -88,7 +88,6 @@ namespace osu.Game.Overlays
             if (changes == null)
             {
                 beatmapSets.AddRange(sender);
-                return;
             }
 
             // beatmaps.ItemUpdated += set => Schedule(() =>
diff --git a/osu.Game/Overlays/Settings/Sections/Maintenance/GeneralSettings.cs b/osu.Game/Overlays/Settings/Sections/Maintenance/GeneralSettings.cs
index 51e4d61d2e..93884812fe 100644
--- a/osu.Game/Overlays/Settings/Sections/Maintenance/GeneralSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Maintenance/GeneralSettings.cs
@@ -160,7 +160,8 @@ namespace osu.Game.Overlays.Settings.Sections.Maintenance
                     Action = () =>
                     {
                         undeleteButton.Enabled.Value = false;
-                        Task.Run(() => beatmaps.Undelete(beatmaps.QueryBeatmapSets(b => b.DeletePending).ToList())).ContinueWith(t => Schedule(() => undeleteButton.Enabled.Value = true));
+                        // TODO: reimplement similar to SkinManager?
+                        // Task.Run(() => beatmaps.Undelete(beatmaps.QueryBeatmapSets(b => b.DeletePending).ToList())).ContinueWith(t => Schedule(() => undeleteButton.Enabled.Value = true));
                     }
                 },
             });
diff --git a/osu.Game/Screens/Menu/IntroScreen.cs b/osu.Game/Screens/Menu/IntroScreen.cs
index aa3fe9fd88..bb8ddb8cd6 100644
--- a/osu.Game/Screens/Menu/IntroScreen.cs
+++ b/osu.Game/Screens/Menu/IntroScreen.cs
@@ -15,6 +15,7 @@ using osu.Framework.Screens;
 using osu.Framework.Utils;
 using osu.Game.Beatmaps;
 using osu.Game.Configuration;
+using osu.Game.Database;
 using osu.Game.IO.Archives;
 using osu.Game.Overlays;
 using osu.Game.Screens.Backgrounds;
@@ -90,7 +91,7 @@ namespace osu.Game.Screens.Menu
             MenuMusic = config.GetBindable<bool>(OsuSetting.MenuMusic);
             seeya = audio.Samples.Get(SeeyaSampleName);
 
-            BeatmapSetInfo setInfo = null;
+            ILive<BeatmapSetInfo> setInfo = null;
 
             // if the user has requested not to play theme music, we should attempt to find a random beatmap from their collection.
             if (!MenuMusic.Value)
@@ -100,7 +101,7 @@ namespace osu.Game.Screens.Menu
                 if (sets.Count > 0)
                 {
                     setInfo = beatmaps.QueryBeatmapSet(s => s.ID == sets[RNG.Next(0, sets.Count - 1)].ID);
-                    initialBeatmap = beatmaps.GetWorkingBeatmap(setInfo?.Beatmaps[0]);
+                    initialBeatmap = beatmaps.GetWorkingBeatmap(setInfo?.PerformRead(s => s.Beatmaps[0].ToLive()));
                 }
             }
 
@@ -130,7 +131,7 @@ namespace osu.Game.Screens.Menu
                 if (setInfo == null)
                     return false;
 
-                initialBeatmap = beatmaps.GetWorkingBeatmap(setInfo.Beatmaps[0]);
+                initialBeatmap = beatmaps.GetWorkingBeatmap(setInfo.PerformRead(s => s.Beatmaps[0].ToLive()));
 
                 return UsingThemedIntro = initialBeatmap != null;
             }

From b91f3098793c19a09554abb5b96e17ae8212a4f4 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 15 Dec 2021 15:24:26 +0900
Subject: [PATCH 2036/5547] Inline query methods from `BeatmapModelManager` to
 `BeatmapManager` where possible

---
 osu.Game/Beatmaps/BeatmapManager.cs      | 60 ++++++++++++++++++------
 osu.Game/Beatmaps/BeatmapModelManager.cs | 58 -----------------------
 2 files changed, 45 insertions(+), 73 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index 7fb0729967..22871bd332 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -146,48 +146,60 @@ namespace osu.Game.Beatmaps
             }
         }
 
-        /// <summary>
-        /// Saves an <see cref="IBeatmap"/> file against a given <see cref="BeatmapInfo"/>.
-        /// </summary>
-        /// <param name="info">The <see cref="BeatmapInfo"/> to save the content against. The file referenced by <see cref="BeatmapInfo.Path"/> will be replaced.</param>
-        /// <param name="beatmapContent">The <see cref="IBeatmap"/> content to write.</param>
-        /// <param name="beatmapSkin">The beatmap <see cref="ISkin"/> content to write, null if to be omitted.</param>
-        public virtual void Save(BeatmapInfo info, IBeatmap beatmapContent, ISkin? beatmapSkin = null) =>
-            beatmapModelManager.Save(info, beatmapContent, beatmapSkin);
-
         /// <summary>
         /// Returns a list of all usable <see cref="BeatmapSetInfo"/>s.
         /// </summary>
         /// <returns>A list of available <see cref="BeatmapSetInfo"/>.</returns>
-        public List<BeatmapSetInfo> GetAllUsableBeatmapSets(bool includeProtected = false) => beatmapModelManager.GetAllUsableBeatmapSets(includeProtected);
+        public List<BeatmapSetInfo> GetAllUsableBeatmapSets(bool includeProtected = false)
+        {
+            using (var context = contextFactory.CreateContext())
+                return context.All<BeatmapSetInfo>().Where(b => !b.DeletePending && (includeProtected || !b.Protected)).ToList();
+        }
 
         /// <summary>
-        /// Returns a list of all usable <see cref="BeatmapSetInfo"/>s. Note that files are not populated.
+        /// Returns a list of all usable <see cref="BeatmapSetInfo"/>s. Note that files are not populated. TODO: do we still need this? or rather, should we have the non-enumerable version in the first place?
         /// </summary>
         /// <param name="includeProtected">Whether to include protected (system) beatmaps. These should not be included for gameplay playable use cases.</param>
         /// <returns>A list of available <see cref="BeatmapSetInfo"/>.</returns>
-        public IEnumerable<BeatmapSetInfo> GetAllUsableBeatmapSetsEnumerable(bool includeProtected = false) => beatmapModelManager.GetAllUsableBeatmapSetsEnumerable(includeProtected);
+        public IEnumerable<BeatmapSetInfo> GetAllUsableBeatmapSetsEnumerable(bool includeProtected = false) => GetAllUsableBeatmapSets(includeProtected);
 
         /// <summary>
         /// Perform a lookup query on available <see cref="BeatmapSetInfo"/>s.
         /// </summary>
         /// <param name="query">The query.</param>
         /// <returns>Results from the provided query.</returns>
-        public List<ILive<BeatmapSetInfo>> QueryBeatmapSets(Expression<Func<BeatmapSetInfo, bool>> query) => beatmapModelManager.QueryBeatmapSets(query).ToLive();
+        public List<ILive<BeatmapSetInfo>> QueryBeatmapSets(Expression<Func<BeatmapSetInfo, bool>> query)
+        {
+            using (var context = contextFactory.CreateContext())
+            {
+                return context.All<BeatmapSetInfo>()
+                              .Where(b => !b.DeletePending)
+                              .Where(query)
+                              .ToLive();
+            }
+        }
 
         /// <summary>
         /// Perform a lookup query on available <see cref="BeatmapSetInfo"/>s.
         /// </summary>
         /// <param name="query">The query.</param>
         /// <returns>The first result for the provided query, or null if no results were found.</returns>
-        public ILive<BeatmapSetInfo>? QueryBeatmapSet(Expression<Func<BeatmapSetInfo, bool>> query) => beatmapModelManager.QueryBeatmapSet(query);
+        public ILive<BeatmapSetInfo>? QueryBeatmapSet(Expression<Func<BeatmapSetInfo, bool>> query)
+        {
+            using (var context = contextFactory.CreateContext())
+                return context.All<BeatmapSetInfo>().FirstOrDefault(query)?.ToLive();
+        }
 
         /// <summary>
         /// Perform a lookup query on available <see cref="BeatmapInfo"/>s.
         /// </summary>
         /// <param name="query">The query.</param>
         /// <returns>Results from the provided query.</returns>
-        public IQueryable<BeatmapInfo> QueryBeatmaps(Expression<Func<BeatmapInfo, bool>> query) => beatmapModelManager.QueryBeatmaps(query);
+        public IQueryable<BeatmapInfo> QueryBeatmaps(Expression<Func<BeatmapInfo, bool>> query)
+        {
+            using (var context = contextFactory.CreateContext())
+                return context.All<BeatmapInfo>().Where(query);
+        }
 
         /// <summary>
         /// Perform a lookup query on available <see cref="BeatmapInfo"/>s.
@@ -196,6 +208,15 @@ namespace osu.Game.Beatmaps
         /// <returns>The first result for the provided query, or null if no results were found.</returns>
         public BeatmapInfo? QueryBeatmap(Expression<Func<BeatmapInfo, bool>> query) => beatmapModelManager.QueryBeatmap(query);
 
+        /// <summary>
+        /// Saves an <see cref="IBeatmap"/> file against a given <see cref="BeatmapInfo"/>.
+        /// </summary>
+        /// <param name="info">The <see cref="BeatmapInfo"/> to save the content against. The file referenced by <see cref="BeatmapInfo.Path"/> will be replaced.</param>
+        /// <param name="beatmapContent">The <see cref="IBeatmap"/> content to write.</param>
+        /// <param name="beatmapSkin">The beatmap <see cref="ISkin"/> content to write, null if to be omitted.</param>
+        public virtual void Save(BeatmapInfo info, IBeatmap beatmapContent, ISkin? beatmapSkin = null) =>
+            beatmapModelManager.Save(info, beatmapContent, beatmapSkin);
+
         /// <summary>
         /// A default representation of a WorkingBeatmap to use when no beatmap is available.
         /// </summary>
@@ -289,6 +310,15 @@ namespace osu.Game.Beatmaps
 
         public WorkingBeatmap GetWorkingBeatmap(BeatmapInfo? importedBeatmap) => workingBeatmapCache.GetWorkingBeatmap(importedBeatmap);
 
+        public WorkingBeatmap GetWorkingBeatmap(ILive<BeatmapInfo>? importedBeatmap)
+        {
+            WorkingBeatmap working = workingBeatmapCache.GetWorkingBeatmap(null);
+
+            importedBeatmap?.PerformRead(b => working = workingBeatmapCache.GetWorkingBeatmap(b));
+
+            return working;
+        }
+
         void IWorkingBeatmapCache.Invalidate(BeatmapSetInfo beatmapSetInfo) => workingBeatmapCache.Invalidate(beatmapSetInfo);
         void IWorkingBeatmapCache.Invalidate(BeatmapInfo beatmapInfo) => workingBeatmapCache.Invalidate(beatmapInfo);
 
diff --git a/osu.Game/Beatmaps/BeatmapModelManager.cs b/osu.Game/Beatmaps/BeatmapModelManager.cs
index 839d3df159..387521ee1d 100644
--- a/osu.Game/Beatmaps/BeatmapModelManager.cs
+++ b/osu.Game/Beatmaps/BeatmapModelManager.cs
@@ -99,50 +99,6 @@ namespace osu.Game.Beatmaps
             WorkingBeatmapCache?.Invalidate(beatmapInfo);
         }
 
-        /// <summary>
-        /// Perform a lookup query on available <see cref="BeatmapSetInfo"/>s.
-        /// </summary>
-        /// <param name="query">The query.</param>
-        /// <returns>The first result for the provided query, or null if no results were found.</returns>
-        public ILive<BeatmapSetInfo>? QueryBeatmapSet(Expression<Func<BeatmapSetInfo, bool>> query)
-        {
-            using (var context = ContextFactory.CreateContext())
-                return context.All<BeatmapSetInfo>().FirstOrDefault(query)?.ToLive();
-        }
-
-        /// <summary>
-        /// Returns a list of all usable <see cref="BeatmapSetInfo"/>s.
-        /// </summary>
-        /// <returns>A list of available <see cref="BeatmapSetInfo"/>.</returns>
-        public List<BeatmapSetInfo> GetAllUsableBeatmapSets(bool includeProtected = false) =>
-            GetAllUsableBeatmapSetsEnumerable(includeProtected).ToList();
-
-        /// <summary>
-        /// Returns a list of all usable <see cref="BeatmapSetInfo"/>s. Note that files are not populated.
-        /// </summary>
-        /// <param name="includeProtected">Whether to include protected (system) beatmaps. These should not be included for gameplay playable use cases.</param>
-        /// <returns>A list of available <see cref="BeatmapSetInfo"/>.</returns>
-        public IEnumerable<BeatmapSetInfo> GetAllUsableBeatmapSetsEnumerable(bool includeProtected = false)
-        {
-            using (var context = ContextFactory.CreateContext())
-                return context.All<BeatmapSetInfo>().Where(b => !b.DeletePending && (includeProtected || !b.Protected));
-        }
-
-        /// <summary>
-        /// Perform a lookup query on available <see cref="BeatmapSetInfo"/>s.
-        /// </summary>
-        /// <param name="query">The query.</param>
-        /// <returns>Results from the provided query.</returns>
-        public IEnumerable<BeatmapSetInfo> QueryBeatmapSets(Expression<Func<BeatmapSetInfo, bool>> query)
-        {
-            using (var context = ContextFactory.CreateContext())
-            {
-                return context.All<BeatmapSetInfo>()
-                              .Where(b => !b.DeletePending)
-                              .Where(query);
-            }
-        }
-
         /// <summary>
         /// Perform a lookup query on available <see cref="BeatmapInfo"/>s.
         /// </summary>
@@ -153,19 +109,5 @@ namespace osu.Game.Beatmaps
             using (var context = ContextFactory.CreateContext())
                 return context.All<BeatmapInfo>().FirstOrDefault(query); // TODO: ?.ToLive();
         }
-
-        /// <summary>
-        /// Perform a lookup query on available <see cref="BeatmapInfo"/>s.
-        /// </summary>
-        /// <param name="query">The query.</param>
-        /// <returns>Results from the provided query.</returns>
-        public IQueryable<BeatmapInfo> QueryBeatmaps(Expression<Func<BeatmapInfo, bool>> query)
-        {
-            using (var context = ContextFactory.CreateContext())
-            {
-                return context.All<BeatmapInfo>()
-                              .Where(query);
-            }
-        }
     }
 }

From a3276758b8c8c121272b633df3d05b428e455d5a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 15 Dec 2021 15:26:48 +0900
Subject: [PATCH 2037/5547] Remove unnecessary re-query of beatmap set in
 editor menu construction

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

diff --git a/osu.Game/Screens/Edit/Editor.cs b/osu.Game/Screens/Edit/Editor.cs
index 7955464590..3a420f4994 100644
--- a/osu.Game/Screens/Edit/Editor.cs
+++ b/osu.Game/Screens/Edit/Editor.cs
@@ -776,7 +776,7 @@ namespace osu.Game.Screens.Edit
 
             fileMenuItems.Add(new EditorMenuItemSpacer());
 
-            var beatmapSet = beatmapManager.QueryBeatmapSet(bs => bs.ID == Beatmap.Value.BeatmapSetInfo.ID) ?? playableBeatmap.BeatmapInfo.BeatmapSet;
+            var beatmapSet = playableBeatmap.BeatmapInfo.BeatmapSet;
 
             Debug.Assert(beatmapSet != null);
 

From db05727ec49faf970578237cb1f36b00fa162b0b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 16 Dec 2021 20:11:45 +0900
Subject: [PATCH 2038/5547] Remove unused `includeProtected` parameter

---
 osu.Game/Beatmaps/BeatmapManager.cs   | 15 ++++-----------
 osu.Game/Screens/Select/SongSelect.cs |  4 ++--
 2 files changed, 6 insertions(+), 13 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index 22871bd332..706160bfb5 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -102,8 +102,6 @@ namespace osu.Game.Beatmaps
             return GetWorkingBeatmap(imported?.Beatmaps.First());
         }
 
-        #region Delegation to BeatmapModelManager (methods which previously existed locally).
-
         /// <summary>
         /// Fired when a single difficulty has been hidden.
         /// </summary>
@@ -150,19 +148,12 @@ namespace osu.Game.Beatmaps
         /// Returns a list of all usable <see cref="BeatmapSetInfo"/>s.
         /// </summary>
         /// <returns>A list of available <see cref="BeatmapSetInfo"/>.</returns>
-        public List<BeatmapSetInfo> GetAllUsableBeatmapSets(bool includeProtected = false)
+        public List<BeatmapSetInfo> GetAllUsableBeatmapSets()
         {
             using (var context = contextFactory.CreateContext())
-                return context.All<BeatmapSetInfo>().Where(b => !b.DeletePending && (includeProtected || !b.Protected)).ToList();
+                return context.All<BeatmapSetInfo>().Where(b => !b.DeletePending).ToList();
         }
 
-        /// <summary>
-        /// Returns a list of all usable <see cref="BeatmapSetInfo"/>s. Note that files are not populated. TODO: do we still need this? or rather, should we have the non-enumerable version in the first place?
-        /// </summary>
-        /// <param name="includeProtected">Whether to include protected (system) beatmaps. These should not be included for gameplay playable use cases.</param>
-        /// <returns>A list of available <see cref="BeatmapSetInfo"/>.</returns>
-        public IEnumerable<BeatmapSetInfo> GetAllUsableBeatmapSetsEnumerable(bool includeProtected = false) => GetAllUsableBeatmapSets(includeProtected);
-
         /// <summary>
         /// Perform a lookup query on available <see cref="BeatmapSetInfo"/>s.
         /// </summary>
@@ -201,6 +192,8 @@ namespace osu.Game.Beatmaps
                 return context.All<BeatmapInfo>().Where(query);
         }
 
+        #region Delegation to BeatmapModelManager (methods which previously existed locally).
+
         /// <summary>
         /// Perform a lookup query on available <see cref="BeatmapInfo"/>s.
         /// </summary>
diff --git a/osu.Game/Screens/Select/SongSelect.cs b/osu.Game/Screens/Select/SongSelect.cs
index 1aab84183a..54a4c3270d 100644
--- a/osu.Game/Screens/Select/SongSelect.cs
+++ b/osu.Game/Screens/Select/SongSelect.cs
@@ -295,7 +295,7 @@ namespace osu.Game.Screens.Select
                 Schedule(() =>
                 {
                     // if we have no beatmaps, let's prompt the user to import from over a stable install if he has one.
-                    if (!beatmaps.GetAllUsableBeatmapSetsEnumerable().Any() && DisplayStableImportPrompt)
+                    if (!beatmaps.GetAllUsableBeatmapSets().Any() && DisplayStableImportPrompt)
                     {
                         dialogOverlay.Push(new ImportFromStablePopup(() =>
                         {
@@ -421,7 +421,7 @@ namespace osu.Game.Screens.Select
                 // A selection may not have been possible with filters applied.
 
                 // There was possibly a ruleset mismatch. This is a case we can help things along by updating the game-wide ruleset to match.
-                if (e.NewValue.BeatmapInfo.Ruleset != null && !e.NewValue.BeatmapInfo.Ruleset.Equals(decoupledRuleset.Value))
+                if (!e.NewValue.BeatmapInfo.Ruleset.Equals(decoupledRuleset.Value))
                 {
                     Ruleset.Value = e.NewValue.BeatmapInfo.Ruleset;
                     transferRulesetValue();

From 31a3161189f7eb915708fbbeef05a27292f05b0c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 17 Dec 2021 18:26:12 +0900
Subject: [PATCH 2039/5547] Make tests compile again

---
 .../Beatmaps/IO/BeatmapImportHelper.cs        | 87 +++++++++++++++++++
 .../TestSceneBeatmapDifficultyCache.cs        |  2 +-
 .../Database/BeatmapImporterTests.cs          | 24 ++---
 ...eneOnlinePlayBeatmapAvailabilityTracker.cs |  6 +-
 osu.Game.Tests/Scores/IO/ImportScoreTest.cs   |  2 +-
 .../Visual/Beatmaps/TestSceneBeatmapCard.cs   |  2 +-
 .../Editing/TestSceneDifficultySwitching.cs   |  2 +-
 .../Editing/TestSceneEditorBeatmapCreation.cs |  4 +-
 .../Editing/TestSceneEditorTestGameplay.cs    |  2 +-
 .../Visual/Gameplay/TestSceneSpectator.cs     |  2 +-
 .../Visual/Multiplayer/QueueModeTestScene.cs  |  2 +-
 .../TestSceneDrawableRoomPlaylist.cs          |  6 +-
 .../TestSceneMultiSpectatorScreen.cs          |  2 +-
 .../Multiplayer/TestSceneMultiplayer.cs       |  4 +-
 .../TestSceneMultiplayerMatchSubScreen.cs     |  2 +-
 .../TestSceneMultiplayerPlaylist.cs           |  2 +-
 .../TestSceneMultiplayerQueueList.cs          |  4 +-
 .../TestSceneMultiplayerReadyButton.cs        |  2 +-
 .../TestSceneMultiplayerSpectateButton.cs     |  2 +-
 .../Visual/Multiplayer/TestSceneTeamVersus.cs |  2 +-
 .../TestSceneMouseWheelVolumeAdjust.cs        |  2 +-
 .../Navigation/TestScenePerformFromScreen.cs  |  2 +-
 .../Navigation/TestSceneScreenNavigation.cs   |  6 +-
 .../Online/TestSceneBeatmapDownloadButton.cs  |  2 +-
 .../TestScenePlaylistsRoomCreation.cs         | 18 +++-
 ...tSceneUpdateableBeatmapBackgroundSprite.cs |  2 +-
 26 files changed, 146 insertions(+), 47 deletions(-)
 create mode 100644 osu.Game.Tests/Beatmaps/IO/BeatmapImportHelper.cs

diff --git a/osu.Game.Tests/Beatmaps/IO/BeatmapImportHelper.cs b/osu.Game.Tests/Beatmaps/IO/BeatmapImportHelper.cs
new file mode 100644
index 0000000000..8e67ecd818
--- /dev/null
+++ b/osu.Game.Tests/Beatmaps/IO/BeatmapImportHelper.cs
@@ -0,0 +1,87 @@
+// 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.Threading;
+using System.Threading.Tasks;
+using NUnit.Framework;
+using osu.Framework.Allocation;
+using osu.Game.Beatmaps;
+using osu.Game.Database;
+using osu.Game.Tests.Database;
+using osu.Game.Tests.Resources;
+
+namespace osu.Game.Tests.Beatmaps.IO
+{
+    [TestFixture]
+    public static class BeatmapImportHelper
+    {
+        public static async Task<BeatmapSetInfo> LoadQuickOszIntoOsu(OsuGameBase osu)
+        {
+            string temp = TestResources.GetQuickTestBeatmapForImport();
+
+            var manager = osu.Dependencies.Get<BeatmapManager>();
+
+            var importedSet = await manager.Import(new ImportTask(temp)).ConfigureAwait(false);
+
+            Debug.Assert(importedSet != null);
+
+            ensureLoaded(osu);
+
+            waitForOrAssert(() => !File.Exists(temp), "Temporary file still exists after standard import", 5000);
+
+            return manager.GetAllUsableBeatmapSets().Find(beatmapSet => beatmapSet.ID == importedSet.ID);
+        }
+
+        public static async Task<BeatmapSetInfo> LoadOszIntoOsu(OsuGameBase osu, string path = null, bool virtualTrack = false)
+        {
+            string temp = path ?? TestResources.GetTestBeatmapForImport(virtualTrack);
+
+            var manager = osu.Dependencies.Get<BeatmapManager>();
+
+            var importedSet = await manager.Import(new ImportTask(temp)).ConfigureAwait(false);
+
+            Debug.Assert(importedSet != null);
+
+            ensureLoaded(osu);
+
+            waitForOrAssert(() => !File.Exists(temp), "Temporary file still exists after standard import", 5000);
+
+            return manager.GetAllUsableBeatmapSets().Find(beatmapSet => beatmapSet.ID == importedSet.ID);
+        }
+
+        private static void ensureLoaded(OsuGameBase osu, int timeout = 60000)
+        {
+            var realmContextFactory = osu.Dependencies.Get<RealmContextFactory>();
+
+            using (var realm = realmContextFactory.CreateContext())
+                BeatmapImporterTests.EnsureLoaded(realm, timeout);
+
+            // TODO: add back some extra checks outside of the realm ones?
+            // var set = queryBeatmapSets().First();
+            // foreach (BeatmapInfo b in set.Beatmaps)
+            //     Assert.IsTrue(set.Beatmaps.Any(c => c.OnlineID == b.OnlineID));
+            // Assert.IsTrue(set.Beatmaps.Count > 0);
+            // var beatmap = store.GetWorkingBeatmap(set.Beatmaps.First(b => b.RulesetID == 0))?.Beatmap;
+            // Assert.IsTrue(beatmap?.HitObjects.Any() == true);
+            // beatmap = store.GetWorkingBeatmap(set.Beatmaps.First(b => b.RulesetID == 1))?.Beatmap;
+            // Assert.IsTrue(beatmap?.HitObjects.Any() == true);
+            // beatmap = store.GetWorkingBeatmap(set.Beatmaps.First(b => b.RulesetID == 2))?.Beatmap;
+            // Assert.IsTrue(beatmap?.HitObjects.Any() == true);
+            // beatmap = store.GetWorkingBeatmap(set.Beatmaps.First(b => b.RulesetID == 3))?.Beatmap;
+            // Assert.IsTrue(beatmap?.HitObjects.Any() == true);
+        }
+
+        private static void waitForOrAssert(Func<bool> result, string failureMessage, int timeout = 60000)
+        {
+            Task task = Task.Run(() =>
+            {
+                while (!result()) Thread.Sleep(200);
+            });
+
+            Assert.IsTrue(task.Wait(timeout), failureMessage);
+        }
+    }
+}
diff --git a/osu.Game.Tests/Beatmaps/TestSceneBeatmapDifficultyCache.cs b/osu.Game.Tests/Beatmaps/TestSceneBeatmapDifficultyCache.cs
index 298e474fd1..f3456cf8e4 100644
--- a/osu.Game.Tests/Beatmaps/TestSceneBeatmapDifficultyCache.cs
+++ b/osu.Game.Tests/Beatmaps/TestSceneBeatmapDifficultyCache.cs
@@ -35,7 +35,7 @@ namespace osu.Game.Tests.Beatmaps
         [BackgroundDependencyLoader]
         private void load(OsuGameBase osu)
         {
-            importedSet = ImportBeatmapTest.LoadQuickOszIntoOsu(osu).GetResultSafely();
+            importedSet = BeatmapImportHelper.LoadQuickOszIntoOsu(osu).GetResultSafely();
         }
 
         [SetUpSteps]
diff --git a/osu.Game.Tests/Database/BeatmapImporterTests.cs b/osu.Game.Tests/Database/BeatmapImporterTests.cs
index e144f863b0..5b63db1972 100644
--- a/osu.Game.Tests/Database/BeatmapImporterTests.cs
+++ b/osu.Game.Tests/Database/BeatmapImporterTests.cs
@@ -123,7 +123,7 @@ namespace osu.Game.Tests.Database
                 using (var stream = File.OpenRead(tempPath))
                 {
                     importedSet = await importer.Import(new ImportTask(stream, Path.GetFileName(tempPath)));
-                    ensureLoaded(realmFactory.Context);
+                    EnsureLoaded(realmFactory.Context);
                 }
 
                 Assert.NotNull(importedSet);
@@ -191,7 +191,7 @@ namespace osu.Game.Tests.Database
 
                     var importedSecondTime = await importer.Import(new ImportTask(temp));
 
-                    ensureLoaded(realmFactory.Context);
+                    EnsureLoaded(realmFactory.Context);
 
                     Assert.NotNull(importedSecondTime);
                     Debug.Assert(importedSecondTime != null);
@@ -242,7 +242,7 @@ namespace osu.Game.Tests.Database
 
                     var importedSecondTime = await importer.Import(new ImportTask(temp));
 
-                    ensureLoaded(realmFactory.Context);
+                    EnsureLoaded(realmFactory.Context);
 
                     // check the newly "imported" beatmap is not the original.
                     Assert.NotNull(importedSecondTime);
@@ -291,7 +291,7 @@ namespace osu.Game.Tests.Database
 
                     var importedSecondTime = await importer.Import(new ImportTask(temp));
 
-                    ensureLoaded(realmFactory.Context);
+                    EnsureLoaded(realmFactory.Context);
 
                     Assert.NotNull(importedSecondTime);
                     Debug.Assert(importedSecondTime != null);
@@ -339,7 +339,7 @@ namespace osu.Game.Tests.Database
 
                     var importedSecondTime = await importer.Import(new ImportTask(temp));
 
-                    ensureLoaded(realmFactory.Context);
+                    EnsureLoaded(realmFactory.Context);
 
                     Assert.NotNull(importedSecondTime);
                     Debug.Assert(importedSecondTime != null);
@@ -606,7 +606,7 @@ namespace osu.Game.Tests.Database
                 string? temp = TestResources.GetTestBeatmapForImport();
                 using (File.OpenRead(temp))
                     await importer.Import(temp);
-                ensureLoaded(realmFactory.Context);
+                EnsureLoaded(realmFactory.Context);
                 File.Delete(temp);
                 Assert.IsFalse(File.Exists(temp), "We likely held a read lock on the file when we shouldn't");
             });
@@ -639,7 +639,7 @@ namespace osu.Game.Tests.Database
 
                     await importer.Import(temp);
 
-                    ensureLoaded(realmFactory.Context);
+                    EnsureLoaded(realmFactory.Context);
                 }
                 finally
                 {
@@ -679,7 +679,7 @@ namespace osu.Game.Tests.Database
                     Assert.NotNull(imported);
                     Debug.Assert(imported != null);
 
-                    ensureLoaded(realmFactory.Context);
+                    EnsureLoaded(realmFactory.Context);
 
                     Assert.IsFalse(imported.PerformRead(s => s.Files.Any(f => f.Filename.Contains("subfolder"))), "Files contain common subfolder");
                 }
@@ -729,7 +729,7 @@ namespace osu.Game.Tests.Database
                     Assert.NotNull(imported);
                     Debug.Assert(imported != null);
 
-                    ensureLoaded(realmFactory.Context);
+                    EnsureLoaded(realmFactory.Context);
 
                     Assert.IsFalse(imported.PerformRead(s => s.Files.Any(f => f.Filename.Contains("__MACOSX"))), "Files contain resource fork folder, which should be ignored");
                     Assert.IsFalse(imported.PerformRead(s => s.Files.Any(f => f.Filename.Contains("actual_data"))), "Files contain common subfolder");
@@ -772,7 +772,7 @@ namespace osu.Game.Tests.Database
 
             Assert.NotNull(importedSet);
 
-            ensureLoaded(realm);
+            EnsureLoaded(realm);
 
             waitForOrAssert(() => !File.Exists(temp), "Temporary file still exists after standard import", 5000);
 
@@ -788,7 +788,7 @@ namespace osu.Game.Tests.Database
             Assert.NotNull(importedSet);
             Debug.Assert(importedSet != null);
 
-            ensureLoaded(realm);
+            EnsureLoaded(realm);
 
             waitForOrAssert(() => !File.Exists(temp), "Temporary file still exists after standard import", 5000);
 
@@ -849,7 +849,7 @@ namespace osu.Game.Tests.Database
             Assert.AreEqual(expected, singleReferencedCount);
         }
 
-        private static void ensureLoaded(Realm realm, int timeout = 60000)
+        internal static void EnsureLoaded(Realm realm, int timeout = 60000)
         {
             IQueryable<BeatmapSetInfo>? resultSets = null;
 
diff --git a/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs b/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
index 5a2349e776..bdc2317ccd 100644
--- a/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
+++ b/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
@@ -62,7 +62,7 @@ namespace osu.Game.Tests.Online
 
             var existing = beatmaps.QueryBeatmapSet(s => s.OnlineID == testBeatmapSet.OnlineID);
             if (existing != null)
-                beatmaps.Delete(existing);
+                beatmaps.Delete(existing.Value);
 
             selectedItem.Value = new PlaylistItem
             {
@@ -103,10 +103,10 @@ namespace osu.Game.Tests.Online
             AddStep("import beatmap", () => beatmaps.Import(testBeatmapFile).WaitSafely());
             addAvailabilityCheckStep("state locally available", BeatmapAvailability.LocallyAvailable);
 
-            AddStep("delete beatmap", () => beatmaps.Delete(beatmaps.QueryBeatmapSet(b => b.OnlineID == testBeatmapSet.OnlineID)));
+            AddStep("delete beatmap", () => beatmaps.Delete(beatmaps.QueryBeatmapSet(b => b.OnlineID == testBeatmapSet.OnlineID)!.Value));
             addAvailabilityCheckStep("state not downloaded", BeatmapAvailability.NotDownloaded);
 
-            AddStep("undelete beatmap", () => beatmaps.Undelete(beatmaps.QueryBeatmapSet(b => b.OnlineID == testBeatmapSet.OnlineID)));
+            AddStep("undelete beatmap", () => beatmaps.Undelete(beatmaps.QueryBeatmapSet(b => b.OnlineID == testBeatmapSet.OnlineID)!.Value));
             addAvailabilityCheckStep("state locally available", BeatmapAvailability.LocallyAvailable);
         }
 
diff --git a/osu.Game.Tests/Scores/IO/ImportScoreTest.cs b/osu.Game.Tests/Scores/IO/ImportScoreTest.cs
index f00fb97dfa..3e6a877a35 100644
--- a/osu.Game.Tests/Scores/IO/ImportScoreTest.cs
+++ b/osu.Game.Tests/Scores/IO/ImportScoreTest.cs
@@ -141,7 +141,7 @@ namespace osu.Game.Tests.Scores.IO
                     var beatmapManager = osu.Dependencies.Get<BeatmapManager>();
                     var scoreManager = osu.Dependencies.Get<ScoreManager>();
 
-                    beatmapManager.Delete(beatmapManager.QueryBeatmapSet(s => s.Beatmaps.Any(b => b.ID == imported.BeatmapInfo.ID)));
+                    beatmapManager.Delete(beatmapManager.QueryBeatmapSet(s => s.Beatmaps.Any(b => b.ID == imported.BeatmapInfo.ID))!.Value);
                     Assert.That(scoreManager.Query(s => s.Equals(imported)).Value.DeletePending, Is.EqualTo(true));
 
                     var secondImport = await LoadScoreIntoOsu(osu, imported);
diff --git a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs
index 7b5e1f4ec7..94b693363a 100644
--- a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs
+++ b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs
@@ -204,7 +204,7 @@ namespace osu.Game.Tests.Visual.Beatmaps
             {
                 var beatmap = beatmaps.QueryBeatmapSet(b => b.OnlineID == online_id);
 
-                if (beatmap != null) beatmaps.Delete(beatmap);
+                if (beatmap != null) beatmaps.Delete(beatmap.Value);
             });
         }
 
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneDifficultySwitching.cs b/osu.Game.Tests/Visual/Editing/TestSceneDifficultySwitching.cs
index 516305079b..243bb71e26 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneDifficultySwitching.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneDifficultySwitching.cs
@@ -33,7 +33,7 @@ namespace osu.Game.Tests.Visual.Editing
 
         public override void SetUpSteps()
         {
-            AddStep("import test beatmap", () => importedBeatmapSet = ImportBeatmapTest.LoadOszIntoOsu(game, virtualTrack: true).GetResultSafely());
+            AddStep("import test beatmap", () => importedBeatmapSet = BeatmapImportHelper.LoadOszIntoOsu(game, virtualTrack: true).GetResultSafely());
             base.SetUpSteps();
         }
 
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneEditorBeatmapCreation.cs b/osu.Game.Tests/Visual/Editing/TestSceneEditorBeatmapCreation.cs
index db20d3c7ba..4cc6e2ca18 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneEditorBeatmapCreation.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneEditorBeatmapCreation.cs
@@ -50,7 +50,7 @@ namespace osu.Game.Tests.Visual.Editing
         {
             AddStep("save beatmap", () => Editor.Save());
             AddAssert("new beatmap persisted", () => EditorBeatmap.BeatmapInfo.IsManaged);
-            AddAssert("new beatmap in database", () => beatmapManager.QueryBeatmapSet(s => s.ID == EditorBeatmap.BeatmapInfo.BeatmapSet.ID)?.DeletePending == false);
+            AddAssert("new beatmap in database", () => beatmapManager.QueryBeatmapSet(s => s.ID == EditorBeatmap.BeatmapInfo.BeatmapSet.ID)?.Value.DeletePending == false);
         }
 
         [Test]
@@ -66,7 +66,7 @@ namespace osu.Game.Tests.Visual.Editing
             });
 
             AddUntilStep("wait for exit", () => !Editor.IsCurrentScreen());
-            AddAssert("new beatmap not persisted", () => beatmapManager.QueryBeatmapSet(s => s.ID == editorBeatmap.BeatmapInfo.BeatmapSet.ID)?.DeletePending == true);
+            AddAssert("new beatmap not persisted", () => beatmapManager.QueryBeatmapSet(s => s.ID == editorBeatmap.BeatmapInfo.BeatmapSet.ID)?.Value.DeletePending == true);
         }
 
         [Test]
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneEditorTestGameplay.cs b/osu.Game.Tests/Visual/Editing/TestSceneEditorTestGameplay.cs
index 6d48ef3ba7..bb630e5d5c 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneEditorTestGameplay.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneEditorTestGameplay.cs
@@ -39,7 +39,7 @@ namespace osu.Game.Tests.Visual.Editing
 
         public override void SetUpSteps()
         {
-            AddStep("import test beatmap", () => importedBeatmapSet = ImportBeatmapTest.LoadOszIntoOsu(game).GetResultSafely());
+            AddStep("import test beatmap", () => importedBeatmapSet = BeatmapImportHelper.LoadOszIntoOsu(game).GetResultSafely());
             base.SetUpSteps();
         }
 
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs
index d8964c531f..8b7e1a1d85 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs
@@ -61,7 +61,7 @@ namespace osu.Game.Tests.Visual.Gameplay
 
             AddStep("import beatmap", () =>
             {
-                importedBeatmap = ImportBeatmapTest.LoadOszIntoOsu(game, virtualTrack: true).GetResultSafely();
+                importedBeatmap = BeatmapImportHelper.LoadOszIntoOsu(game, virtualTrack: true).GetResultSafely();
                 importedBeatmapId = importedBeatmap.Beatmaps.First(b => b.RulesetID == 0).OnlineID;
             });
         }
diff --git a/osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs b/osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs
index a993190a67..dc826701d2 100644
--- a/osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs
@@ -58,7 +58,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddStep("import beatmap", () =>
             {
                 beatmaps.Import(TestResources.GetQuickTestBeatmapForImport()).WaitSafely();
-                importedSet = beatmaps.GetAllUsableBeatmapSetsEnumerable().First();
+                importedSet = beatmaps.GetAllUsableBeatmapSets().First();
                 InitialBeatmap = importedSet.Beatmaps.First(b => b.RulesetID == 0);
                 OtherBeatmap = importedSet.Beatmaps.Last(b => b.RulesetID == 0);
             });
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
index 1607750d15..d87a0a4a1c 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
@@ -154,16 +154,18 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             var beatmap = new TestBeatmap(new OsuRuleset().RulesetInfo).BeatmapInfo;
 
+            Debug.Assert(beatmap.BeatmapSet != null);
+
             AddStep("import beatmap", () => manager.Import(beatmap.BeatmapSet).WaitSafely());
 
             createPlaylistWithBeatmaps(beatmap);
 
             assertDownloadButtonVisible(false);
 
-            AddStep("delete beatmap set", () => manager.Delete(manager.QueryBeatmapSets(_ => true).Single()));
+            AddStep("delete beatmap set", () => manager.Delete(manager.QueryBeatmapSets(_ => true).Single().Value));
             assertDownloadButtonVisible(true);
 
-            AddStep("undelete beatmap set", () => manager.Undelete(manager.QueryBeatmapSets(_ => true).Single()));
+            AddStep("undelete beatmap set", () => manager.Undelete(manager.QueryBeatmapSets(_ => true).Single().Value));
             assertDownloadButtonVisible(false);
 
             void assertDownloadButtonVisible(bool visible) => AddUntilStep($"download button {(visible ? "shown" : "hidden")}",
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs
index c78d1a2f62..9d67742e4d 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs
@@ -47,7 +47,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [BackgroundDependencyLoader]
         private void load()
         {
-            importedSet = ImportBeatmapTest.LoadOszIntoOsu(game, virtualTrack: true).GetResultSafely();
+            importedSet = BeatmapImportHelper.LoadOszIntoOsu(game, virtualTrack: true).GetResultSafely();
             importedBeatmap = importedSet.Beatmaps.First(b => b.RulesetID == 0);
             importedBeatmapId = importedBeatmap.OnlineID;
         }
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
index 18f45086f6..471816edf8 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
@@ -72,7 +72,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddStep("import beatmap", () =>
             {
                 beatmaps.Import(TestResources.GetQuickTestBeatmapForImport()).WaitSafely();
-                importedSet = beatmaps.GetAllUsableBeatmapSetsEnumerable().First();
+                importedSet = beatmaps.GetAllUsableBeatmapSets().First();
             });
 
             AddStep("load multiplayer", () => LoadScreen(multiplayerComponents = new TestMultiplayerComponents()));
@@ -588,7 +588,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddStep("restore beatmap", () =>
             {
                 beatmaps.Import(TestResources.GetQuickTestBeatmapForImport()).WaitSafely();
-                importedSet = beatmaps.GetAllUsableBeatmapSetsEnumerable().First();
+                importedSet = beatmaps.GetAllUsableBeatmapSets().First();
             });
 
             AddUntilStep("play started", () => multiplayerComponents.CurrentScreen is SpectatorScreen);
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs
index 6b6a02906e..98b14fbddb 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs
@@ -42,7 +42,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             Dependencies.Cache(beatmaps = new BeatmapManager(LocalStorage, ContextFactory, rulesets, null, audio, Resources, host, Beatmap.Default));
             beatmaps.Import(TestResources.GetQuickTestBeatmapForImport()).WaitSafely();
 
-            importedSet = beatmaps.GetAllUsableBeatmapSetsEnumerable().First();
+            importedSet = beatmaps.GetAllUsableBeatmapSets().First();
         }
 
         [SetUp]
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs
index 251f407a85..813b62176b 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs
@@ -55,7 +55,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddStep("import beatmap", () =>
             {
                 beatmaps.Import(TestResources.GetQuickTestBeatmapForImport()).WaitSafely();
-                importedSet = beatmaps.GetAllUsableBeatmapSetsEnumerable().First();
+                importedSet = beatmaps.GetAllUsableBeatmapSets().First();
                 importedBeatmap = importedSet.Beatmaps.First(b => b.RulesetID == 0);
             });
 
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs
index ad47745642..b5d31c7ae9 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs
@@ -39,7 +39,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         private void load(GameHost host, AudioManager audio)
         {
             Dependencies.Cache(rulesets = new RulesetStore(ContextFactory));
-            Dependencies.Cache(beatmaps = new BeatmapManager(LocalStorage, ContextFactory, rulesets, null, audio, Resources, host, Beatmap.Default));
+            Dependencies.Cache(beatmaps = new BeatmapManager(LocalStorage, ContextFactory, rulesets, API, audio, Resources, host, Beatmap.Default));
         }
 
         public override void SetUpSteps()
@@ -60,7 +60,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddStep("import beatmap", () =>
             {
                 beatmaps.Import(TestResources.GetQuickTestBeatmapForImport()).WaitSafely();
-                importedSet = beatmaps.GetAllUsableBeatmapSetsEnumerable().First();
+                importedSet = beatmaps.GetAllUsableBeatmapSets().First();
                 importedBeatmap = importedSet.Beatmaps.First(b => b.RulesetID == 0);
             });
 
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs
index 59e5318263..0b2ab1aef3 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs
@@ -50,7 +50,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             AvailabilityTracker.SelectedItem.BindTo(selectedItem);
 
-            importedSet = beatmaps.GetAllUsableBeatmapSetsEnumerable().First();
+            importedSet = beatmaps.GetAllUsableBeatmapSets().First();
             Beatmap.Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First());
             selectedItem.Value = new PlaylistItem
             {
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerSpectateButton.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerSpectateButton.cs
index 5466a19657..6b1001f6b7 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerSpectateButton.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerSpectateButton.cs
@@ -51,7 +51,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             AvailabilityTracker.SelectedItem.BindTo(selectedItem);
 
-            importedSet = beatmaps.GetAllUsableBeatmapSetsEnumerable().First();
+            importedSet = beatmaps.GetAllUsableBeatmapSets().First();
             Beatmap.Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First());
             selectedItem.Value = new PlaylistItem
             {
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs
index 2140acb2e3..97d17ada71 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs
@@ -53,7 +53,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddStep("import beatmap", () =>
             {
                 beatmaps.Import(TestResources.GetQuickTestBeatmapForImport()).WaitSafely();
-                importedSet = beatmaps.GetAllUsableBeatmapSetsEnumerable().First();
+                importedSet = beatmaps.GetAllUsableBeatmapSets().First();
             });
 
             AddStep("load multiplayer", () => LoadScreen(multiplayerComponents = new TestMultiplayerComponents()));
diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneMouseWheelVolumeAdjust.cs b/osu.Game.Tests/Visual/Navigation/TestSceneMouseWheelVolumeAdjust.cs
index 701ab480f6..22a00a3e5a 100644
--- a/osu.Game.Tests/Visual/Navigation/TestSceneMouseWheelVolumeAdjust.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneMouseWheelVolumeAdjust.cs
@@ -83,7 +83,7 @@ namespace osu.Game.Tests.Visual.Navigation
             PushAndConfirm(() => songSelect = new TestSceneScreenNavigation.TestPlaySongSelect());
             AddUntilStep("wait for song select", () => songSelect.BeatmapSetsLoaded);
 
-            AddStep("import beatmap", () => ImportBeatmapTest.LoadOszIntoOsu(Game, virtualTrack: true).WaitSafely());
+            AddStep("import beatmap", () => BeatmapImportHelper.LoadOszIntoOsu(Game, virtualTrack: true).WaitSafely());
             AddUntilStep("wait for selected", () => !Game.Beatmap.IsDefault);
             AddStep("press enter", () => InputManager.Key(Key.Enter));
 
diff --git a/osu.Game.Tests/Visual/Navigation/TestScenePerformFromScreen.cs b/osu.Game.Tests/Visual/Navigation/TestScenePerformFromScreen.cs
index 24f5808961..1ebceed15d 100644
--- a/osu.Game.Tests/Visual/Navigation/TestScenePerformFromScreen.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestScenePerformFromScreen.cs
@@ -173,7 +173,7 @@ namespace osu.Game.Tests.Visual.Navigation
 
         private void importAndWaitForSongSelect()
         {
-            AddStep("import beatmap", () => ImportBeatmapTest.LoadQuickOszIntoOsu(Game).WaitSafely());
+            AddStep("import beatmap", () => BeatmapImportHelper.LoadQuickOszIntoOsu(Game).WaitSafely());
             PushAndConfirm(() => new TestPlaySongSelect());
             AddUntilStep("beatmap updated", () => Game.Beatmap.Value.BeatmapSetInfo.OnlineID == 241526);
         }
diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs b/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
index d094d8b688..0349961f75 100644
--- a/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
@@ -71,7 +71,7 @@ namespace osu.Game.Tests.Visual.Navigation
             PushAndConfirm(() => songSelect = new TestPlaySongSelect());
             AddUntilStep("wait for song select", () => songSelect.BeatmapSetsLoaded);
 
-            AddStep("import beatmap", () => ImportBeatmapTest.LoadQuickOszIntoOsu(Game).WaitSafely());
+            AddStep("import beatmap", () => BeatmapImportHelper.LoadQuickOszIntoOsu(Game).WaitSafely());
 
             AddUntilStep("wait for selected", () => !Game.Beatmap.IsDefault);
 
@@ -105,7 +105,7 @@ namespace osu.Game.Tests.Visual.Navigation
             PushAndConfirm(() => songSelect = new TestPlaySongSelect());
             AddUntilStep("wait for song select", () => songSelect.BeatmapSetsLoaded);
 
-            AddStep("import beatmap", () => ImportBeatmapTest.LoadQuickOszIntoOsu(Game).WaitSafely());
+            AddStep("import beatmap", () => BeatmapImportHelper.LoadQuickOszIntoOsu(Game).WaitSafely());
 
             AddUntilStep("wait for selected", () => !Game.Beatmap.IsDefault);
 
@@ -139,7 +139,7 @@ namespace osu.Game.Tests.Visual.Navigation
             PushAndConfirm(() => songSelect = new TestPlaySongSelect());
             AddUntilStep("wait for song select", () => songSelect.BeatmapSetsLoaded);
 
-            AddStep("import beatmap", () => ImportBeatmapTest.LoadOszIntoOsu(Game, virtualTrack: true).WaitSafely());
+            AddStep("import beatmap", () => BeatmapImportHelper.LoadOszIntoOsu(Game, virtualTrack: true).WaitSafely());
 
             AddUntilStep("wait for selected", () => !Game.Beatmap.IsDefault);
 
diff --git a/osu.Game.Tests/Visual/Online/TestSceneBeatmapDownloadButton.cs b/osu.Game.Tests/Visual/Online/TestSceneBeatmapDownloadButton.cs
index 21bf8d1c5a..d9f01622da 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneBeatmapDownloadButton.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneBeatmapDownloadButton.cs
@@ -59,7 +59,7 @@ namespace osu.Game.Tests.Visual.Online
             {
                 var beatmap = beatmaps.QueryBeatmapSet(b => b.OnlineID == 241526);
 
-                if (beatmap != null) beatmaps.Delete(beatmap);
+                if (beatmap != null) beatmaps.Delete(beatmap.Value);
             });
         }
 
diff --git a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs
index e59884f4f4..908e93dee2 100644
--- a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs
+++ b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs
@@ -2,6 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
+using System.Diagnostics;
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
@@ -39,7 +40,7 @@ namespace osu.Game.Tests.Visual.Playlists
         private void load(GameHost host, AudioManager audio)
         {
             Dependencies.Cache(rulesets = new RulesetStore(ContextFactory));
-            Dependencies.Cache(manager = new BeatmapManager(LocalStorage, ContextFactory, rulesets, null, audio, Resources, host, Beatmap.Default));
+            Dependencies.Cache(manager = new BeatmapManager(LocalStorage, ContextFactory, rulesets, API, audio, Resources, host, Beatmap.Default));
         }
 
         [SetUpSteps]
@@ -122,8 +123,8 @@ namespace osu.Game.Tests.Visual.Playlists
             AddStep("store real beatmap values", () =>
             {
                 realHash = importedBeatmap.Value.Beatmaps[0].MD5Hash;
-                realOnlineId = importedBeatmap.Value.Beatmaps[0].OnlineID ?? -1;
-                realOnlineSetId = importedBeatmap.Value.OnlineID ?? -1;
+                realOnlineId = importedBeatmap.Value.Beatmaps[0].OnlineID;
+                realOnlineSetId = importedBeatmap.Value.OnlineID;
             });
 
             AddStep("import modified beatmap", () =>
@@ -185,6 +186,8 @@ namespace osu.Game.Tests.Visual.Playlists
                     },
                 };
 
+                Debug.Assert(originalBeatmap.BeatmapInfo.BeatmapSet != null);
+
                 manager.Import(originalBeatmap.BeatmapInfo.BeatmapSet).WaitSafely();
             });
 
@@ -202,7 +205,14 @@ namespace osu.Game.Tests.Visual.Playlists
             });
         }
 
-        private void importBeatmap() => AddStep("import beatmap", () => importedBeatmap = manager.Import(CreateBeatmap(new OsuRuleset().RulesetInfo).BeatmapInfo.BeatmapSet).GetResultSafely());
+        private void importBeatmap() => AddStep("import beatmap", () =>
+        {
+            var beatmap = CreateBeatmap(new OsuRuleset().RulesetInfo);
+
+            Debug.Assert(beatmap.BeatmapInfo.BeatmapSet != null);
+
+            importedBeatmap = manager.Import(beatmap.BeatmapInfo.BeatmapSet).GetResultSafely();
+        });
 
         private class TestPlaylistsRoomSubScreen : PlaylistsRoomSubScreen
         {
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneUpdateableBeatmapBackgroundSprite.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneUpdateableBeatmapBackgroundSprite.cs
index 6fe1ccc037..4f22281818 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneUpdateableBeatmapBackgroundSprite.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneUpdateableBeatmapBackgroundSprite.cs
@@ -32,7 +32,7 @@ namespace osu.Game.Tests.Visual.UserInterface
         {
             this.api = api;
 
-            testBeatmap = ImportBeatmapTest.LoadOszIntoOsu(osu).GetResultSafely();
+            testBeatmap = BeatmapImportHelper.LoadOszIntoOsu(osu).GetResultSafely();
         }
 
         [Test]

From 1f9318265e6a7ee5a89b356d8a0e1418463ca066 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 17 Dec 2021 18:45:22 +0900
Subject: [PATCH 2040/5547] Update `ToLive` usages in line with recent changes

---
 osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs | 6 +++---
 osu.Game/Beatmaps/BeatmapManager.cs                       | 4 ++--
 osu.Game/Scoring/ScoreManager.cs                          | 2 +-
 osu.Game/Screens/Menu/IntroScreen.cs                      | 8 ++++----
 4 files changed, 10 insertions(+), 10 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
index 471816edf8..d55ca0b578 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
@@ -62,7 +62,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         private void load(GameHost host, AudioManager audio)
         {
             Dependencies.Cache(rulesets = new RulesetStore(ContextFactory));
-            Dependencies.Cache(beatmaps = new BeatmapManager(LocalStorage, ContextFactory, rulesets, null, audio, Resources, host, Beatmap.Default));
+            Dependencies.Cache(beatmaps = new BeatmapManager(LocalStorage, ContextFactory, rulesets, API, audio, Resources, host, Beatmap.Default));
         }
 
         public override void SetUpSteps()
@@ -827,7 +827,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddStep("join other user", () => client.AddUser(new APIUser { Id = 1234 }));
             AddStep("add item as other user", () => client.AddUserPlaylistItem(1234, new MultiplayerPlaylistItem(new PlaylistItem
             {
-                BeatmapID = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.RulesetID == 0)).BeatmapInfo.OnlineID ?? -1
+                BeatmapID = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.RulesetID == 0)).BeatmapInfo.OnlineID
             })));
 
             AddUntilStep("item arrived in playlist", () => client.Room?.Playlist.Count == 2);
@@ -858,7 +858,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddStep("join other user", () => client.AddUser(new APIUser { Id = 1234 }));
             AddStep("add item as other user", () => client.AddUserPlaylistItem(1234, new MultiplayerPlaylistItem(new PlaylistItem
             {
-                BeatmapID = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.RulesetID == 0)).BeatmapInfo.OnlineID ?? -1
+                BeatmapID = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.RulesetID == 0)).BeatmapInfo.OnlineID
             })));
 
             AddUntilStep("item arrived in playlist", () => client.Room?.Playlist.Count == 2);
diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index 706160bfb5..462980448a 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -166,7 +166,7 @@ namespace osu.Game.Beatmaps
                 return context.All<BeatmapSetInfo>()
                               .Where(b => !b.DeletePending)
                               .Where(query)
-                              .ToLive();
+                              .ToLive(contextFactory);
             }
         }
 
@@ -178,7 +178,7 @@ namespace osu.Game.Beatmaps
         public ILive<BeatmapSetInfo>? QueryBeatmapSet(Expression<Func<BeatmapSetInfo, bool>> query)
         {
             using (var context = contextFactory.CreateContext())
-                return context.All<BeatmapSetInfo>().FirstOrDefault(query)?.ToLive();
+                return context.All<BeatmapSetInfo>().FirstOrDefault(query)?.ToLive(contextFactory);
         }
 
         /// <summary>
diff --git a/osu.Game/Scoring/ScoreManager.cs b/osu.Game/Scoring/ScoreManager.cs
index 0a1b616422..c2a9675474 100644
--- a/osu.Game/Scoring/ScoreManager.cs
+++ b/osu.Game/Scoring/ScoreManager.cs
@@ -52,7 +52,7 @@ namespace osu.Game.Scoring
         public ILive<ScoreInfo> Query(Expression<Func<ScoreInfo, bool>> query)
         {
             using (var context = contextFactory.CreateContext())
-                return context.All<ScoreInfo>().FirstOrDefault(query)?.ToLive();
+                return context.All<ScoreInfo>().FirstOrDefault(query)?.ToLive(contextFactory);
         }
 
         /// <summary>
diff --git a/osu.Game/Screens/Menu/IntroScreen.cs b/osu.Game/Screens/Menu/IntroScreen.cs
index bb8ddb8cd6..f54228b441 100644
--- a/osu.Game/Screens/Menu/IntroScreen.cs
+++ b/osu.Game/Screens/Menu/IntroScreen.cs
@@ -82,9 +82,9 @@ namespace osu.Game.Screens.Menu
         }
 
         [BackgroundDependencyLoader]
-        private void load(OsuConfigManager config, SkinManager skinManager, BeatmapManager beatmaps, Framework.Game game)
+        private void load(OsuConfigManager config, SkinManager skinManager, BeatmapManager beatmaps, Framework.Game game, RealmContextFactory realmContextFactory)
         {
-            // prevent user from changing beatmap while the intro is still runnning.
+            // prevent user from changing beatmap while the intro is still running.
             beatmap = Beatmap.BeginLease(false);
 
             MenuVoice = config.GetBindable<bool>(OsuSetting.MenuVoice);
@@ -101,7 +101,7 @@ namespace osu.Game.Screens.Menu
                 if (sets.Count > 0)
                 {
                     setInfo = beatmaps.QueryBeatmapSet(s => s.ID == sets[RNG.Next(0, sets.Count - 1)].ID);
-                    initialBeatmap = beatmaps.GetWorkingBeatmap(setInfo?.PerformRead(s => s.Beatmaps[0].ToLive()));
+                    initialBeatmap = beatmaps.GetWorkingBeatmap(setInfo?.PerformRead(s => s.Beatmaps[0].ToLive(realmContextFactory)));
                 }
             }
 
@@ -131,7 +131,7 @@ namespace osu.Game.Screens.Menu
                 if (setInfo == null)
                     return false;
 
-                initialBeatmap = beatmaps.GetWorkingBeatmap(setInfo.PerformRead(s => s.Beatmaps[0].ToLive()));
+                initialBeatmap = beatmaps.GetWorkingBeatmap(setInfo.PerformRead(s => s.Beatmaps[0].ToLive(realmContextFactory)));
 
                 return UsingThemedIntro = initialBeatmap != null;
             }

From 5dc497e949cf813f57bc35f4ad8bfc8d488fb6a9 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 17 Dec 2021 18:37:28 +0900
Subject: [PATCH 2041/5547] Replace `BeatmapLeaderboard` event flow with realm
 subscriptions

---
 .../Select/Leaderboards/BeatmapLeaderboard.cs | 38 +++++++++++++++----
 1 file changed, 31 insertions(+), 7 deletions(-)

diff --git a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
index e47acc5ba7..869036ef68 100644
--- a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
+++ b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
@@ -44,6 +44,8 @@ namespace osu.Game.Screens.Select.Leaderboards
                 Scores = null;
 
                 UpdateScores();
+                if (IsLoaded)
+                    refreshRealmSubscription();
             }
         }
 
@@ -78,6 +80,9 @@ namespace osu.Game.Screens.Select.Leaderboards
         [Resolved]
         private IAPIProvider api { get; set; }
 
+        [Resolved]
+        private RealmContextFactory realmContextFactory { get; set; }
+
         [BackgroundDependencyLoader]
         private void load()
         {
@@ -87,9 +92,32 @@ namespace osu.Game.Screens.Select.Leaderboards
                 if (filterMods)
                     UpdateScores();
             };
+        }
 
-            scoreManager.ItemRemoved += scoreStoreChanged;
-            scoreManager.ItemUpdated += scoreStoreChanged;
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            refreshRealmSubscription();
+        }
+
+        private IDisposable scoreSubscription;
+
+        private void refreshRealmSubscription()
+        {
+            scoreSubscription?.Dispose();
+            scoreSubscription = null;
+
+            if (beatmapInfo == null)
+                return;
+
+            scoreSubscription = realmContextFactory.Context.All<ScoreInfo>().Where(s => s.BeatmapInfo.ID == beatmapInfo.ID).QueryAsyncWithNotifications((_, changes, ___) =>
+            {
+                if (changes == null)
+                    return;
+
+                RefreshScores();
+            });
         }
 
         protected override void Reset()
@@ -212,11 +240,7 @@ namespace osu.Game.Screens.Select.Leaderboards
         {
             base.Dispose(isDisposing);
 
-            if (scoreManager != null)
-            {
-                scoreManager.ItemRemoved -= scoreStoreChanged;
-                scoreManager.ItemUpdated -= scoreStoreChanged;
-            }
+            scoreSubscription?.Dispose();
         }
     }
 }

From 00e9f0d41ee90143a107b397a6fcd9c328ed2383 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 17 Dec 2021 18:53:46 +0900
Subject: [PATCH 2042/5547] Replace `BeatmapDownloadTracker` event flow with
 realm subscriptions

---
 osu.Game/Online/BeatmapDownloadTracker.cs   | 62 ++++++++++-----------
 osu.Game/Stores/RealmArchiveModelManager.cs |  1 +
 2 files changed, 30 insertions(+), 33 deletions(-)

diff --git a/osu.Game/Online/BeatmapDownloadTracker.cs b/osu.Game/Online/BeatmapDownloadTracker.cs
index 509d5c1b71..7a396ac7aa 100644
--- a/osu.Game/Online/BeatmapDownloadTracker.cs
+++ b/osu.Game/Online/BeatmapDownloadTracker.cs
@@ -2,8 +2,10 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
+using System.Linq;
 using osu.Framework.Allocation;
 using osu.Game.Beatmaps;
+using osu.Game.Database;
 using osu.Game.Online.API;
 
 #nullable enable
@@ -12,37 +14,47 @@ namespace osu.Game.Online
 {
     public class BeatmapDownloadTracker : DownloadTracker<IBeatmapSetInfo>
     {
-        [Resolved(CanBeNull = true)]
-        protected BeatmapManager? Manager { get; private set; }
-
         [Resolved(CanBeNull = true)]
         protected BeatmapModelDownloader? Downloader { get; private set; }
 
         private ArchiveDownloadRequest<IBeatmapSetInfo>? attachedRequest;
 
+        private IDisposable? realmSubscription;
+
+        [Resolved]
+        private RealmContextFactory realmContextFactory { get; set; } = null!;
+
         public BeatmapDownloadTracker(IBeatmapSetInfo trackedItem)
             : base(trackedItem)
         {
         }
 
-        [BackgroundDependencyLoader(true)]
-        private void load()
+        protected override void LoadComplete()
         {
-            if (Manager == null || Downloader == null)
+            base.LoadComplete();
+
+            if (Downloader == null)
                 return;
 
+            Downloader.DownloadBegan += downloadBegan;
+            Downloader.DownloadFailed += downloadFailed;
+
             // Used to interact with manager classes that don't support interface types. Will eventually be replaced.
             var beatmapSetInfo = new BeatmapSetInfo { OnlineID = TrackedItem.OnlineID };
 
-            if (Manager.IsAvailableLocally(beatmapSetInfo))
-                UpdateState(DownloadState.LocallyAvailable);
-            else
-                attachDownload(Downloader.GetExistingDownload(beatmapSetInfo));
-
-            Downloader.DownloadBegan += downloadBegan;
-            Downloader.DownloadFailed += downloadFailed;
-            Manager.ItemUpdated += itemUpdated;
-            Manager.ItemRemoved += itemRemoved;
+            realmSubscription = realmContextFactory.Context.All<BeatmapSetInfo>().Where(s => s.OnlineID == TrackedItem.OnlineID).QueryAsyncWithNotifications((items, changes, ___) =>
+            {
+                if (items.Any())
+                    Schedule(() => UpdateState(DownloadState.LocallyAvailable));
+                else
+                {
+                    Schedule(() =>
+                    {
+                        UpdateState(DownloadState.NotDownloaded);
+                        attachDownload(Downloader.GetExistingDownload(beatmapSetInfo));
+                    });
+                }
+            });
         }
 
         private void downloadBegan(ArchiveDownloadRequest<IBeatmapSetInfo> request) => Schedule(() =>
@@ -97,18 +109,6 @@ namespace osu.Game.Online
 
         private void onRequestFailure(Exception e) => Schedule(() => attachDownload(null));
 
-        private void itemUpdated(BeatmapSetInfo item) => Schedule(() =>
-        {
-            if (checkEquality(item, TrackedItem))
-                UpdateState(DownloadState.LocallyAvailable);
-        });
-
-        private void itemRemoved(BeatmapSetInfo item) => Schedule(() =>
-        {
-            if (checkEquality(item, TrackedItem))
-                UpdateState(DownloadState.NotDownloaded);
-        });
-
         private bool checkEquality(IBeatmapSetInfo x, IBeatmapSetInfo y) => x.OnlineID == y.OnlineID;
 
         #region Disposal
@@ -118,17 +118,13 @@ namespace osu.Game.Online
             base.Dispose(isDisposing);
             attachDownload(null);
 
+            realmSubscription?.Dispose();
+
             if (Downloader != null)
             {
                 Downloader.DownloadBegan -= downloadBegan;
                 Downloader.DownloadFailed -= downloadFailed;
             }
-
-            if (Manager != null)
-            {
-                Manager.ItemUpdated -= itemUpdated;
-                Manager.ItemRemoved -= itemRemoved;
-            }
         }
 
         #endregion
diff --git a/osu.Game/Stores/RealmArchiveModelManager.cs b/osu.Game/Stores/RealmArchiveModelManager.cs
index 7fa8d16882..d6bb01cedf 100644
--- a/osu.Game/Stores/RealmArchiveModelManager.cs
+++ b/osu.Game/Stores/RealmArchiveModelManager.cs
@@ -187,6 +187,7 @@ namespace osu.Game.Stores
             item.Realm.Write(r => item.DeletePending = false);
         }
 
+        // TODO: delete or abstract
         public virtual bool IsAvailableLocally(TModel model) => false; // Not relevant for skins since they can't be downloaded yet.
 
         public void Update(TModel skin)

From 8c4836e87d68cfeef0b2b51527e7364039b6f01a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 17 Dec 2021 18:58:21 +0900
Subject: [PATCH 2043/5547] Replace `ScoreDownloadTracker` event flow with
 realm subscriptions

---
 osu.Game/Online/ScoreDownloadTracker.cs | 58 ++++++++++++-------------
 1 file changed, 27 insertions(+), 31 deletions(-)

diff --git a/osu.Game/Online/ScoreDownloadTracker.cs b/osu.Game/Online/ScoreDownloadTracker.cs
index 68932cc388..946a751c31 100644
--- a/osu.Game/Online/ScoreDownloadTracker.cs
+++ b/osu.Game/Online/ScoreDownloadTracker.cs
@@ -2,7 +2,9 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
+using System.Linq;
 using osu.Framework.Allocation;
+using osu.Game.Database;
 using osu.Game.Extensions;
 using osu.Game.Online.API;
 using osu.Game.Scoring;
@@ -13,23 +15,26 @@ namespace osu.Game.Online
 {
     public class ScoreDownloadTracker : DownloadTracker<ScoreInfo>
     {
-        [Resolved(CanBeNull = true)]
-        protected ScoreManager? Manager { get; private set; }
-
         [Resolved(CanBeNull = true)]
         protected ScoreModelDownloader? Downloader { get; private set; }
 
         private ArchiveDownloadRequest<IScoreInfo>? attachedRequest;
 
+        private IDisposable? realmSubscription;
+
+        [Resolved]
+        private RealmContextFactory realmContextFactory { get; set; } = null!;
+
         public ScoreDownloadTracker(ScoreInfo trackedItem)
             : base(trackedItem)
         {
         }
 
-        [BackgroundDependencyLoader(true)]
-        private void load()
+        protected override void LoadComplete()
         {
-            if (Manager == null || Downloader == null)
+            base.LoadComplete();
+
+            if (Downloader == null)
                 return;
 
             // Used to interact with manager classes that don't support interface types. Will eventually be replaced.
@@ -39,15 +44,22 @@ namespace osu.Game.Online
                 OnlineID = TrackedItem.OnlineID
             };
 
-            if (Manager.IsAvailableLocally(scoreInfo))
-                UpdateState(DownloadState.LocallyAvailable);
-            else
-                attachDownload(Downloader.GetExistingDownload(scoreInfo));
-
             Downloader.DownloadBegan += downloadBegan;
             Downloader.DownloadFailed += downloadFailed;
-            Manager.ItemUpdated += itemUpdated;
-            Manager.ItemRemoved += itemRemoved;
+
+            realmSubscription = realmContextFactory.Context.All<ScoreInfo>().Where(s => s.OnlineID == TrackedItem.OnlineID).QueryAsyncWithNotifications((items, changes, ___) =>
+            {
+                if (items.Any())
+                    Schedule(() => UpdateState(DownloadState.LocallyAvailable));
+                else
+                {
+                    Schedule(() =>
+                    {
+                        UpdateState(DownloadState.NotDownloaded);
+                        attachDownload(Downloader.GetExistingDownload(scoreInfo));
+                    });
+                }
+            });
         }
 
         private void downloadBegan(ArchiveDownloadRequest<IScoreInfo> request) => Schedule(() =>
@@ -102,18 +114,6 @@ namespace osu.Game.Online
 
         private void onRequestFailure(Exception e) => Schedule(() => attachDownload(null));
 
-        private void itemUpdated(ScoreInfo item) => Schedule(() =>
-        {
-            if (checkEquality(item, TrackedItem))
-                UpdateState(DownloadState.LocallyAvailable);
-        });
-
-        private void itemRemoved(ScoreInfo item) => Schedule(() =>
-        {
-            if (checkEquality(item, TrackedItem))
-                UpdateState(DownloadState.NotDownloaded);
-        });
-
         private bool checkEquality(IScoreInfo x, IScoreInfo y) => x.MatchesOnlineID(y);
 
         #region Disposal
@@ -123,17 +123,13 @@ namespace osu.Game.Online
             base.Dispose(isDisposing);
             attachDownload(null);
 
+            realmSubscription?.Dispose();
+
             if (Downloader != null)
             {
                 Downloader.DownloadBegan -= downloadBegan;
                 Downloader.DownloadFailed -= downloadFailed;
             }
-
-            if (Manager != null)
-            {
-                Manager.ItemUpdated -= itemUpdated;
-                Manager.ItemRemoved -= itemRemoved;
-            }
         }
 
         #endregion

From c9257e9ecc34e484bebe1a70ec663268f729a915 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 17 Dec 2021 19:01:19 +0900
Subject: [PATCH 2044/5547] Fix missing disposal of realm subscriptions in
 `BeatmapCarousel`

---
 osu.Game/Screens/Select/BeatmapCarousel.cs | 23 +++++++++-------------
 1 file changed, 9 insertions(+), 14 deletions(-)

diff --git a/osu.Game/Screens/Select/BeatmapCarousel.cs b/osu.Game/Screens/Select/BeatmapCarousel.cs
index 94e7dc9241..78e416c64b 100644
--- a/osu.Game/Screens/Select/BeatmapCarousel.cs
+++ b/osu.Game/Screens/Select/BeatmapCarousel.cs
@@ -144,9 +144,13 @@ namespace osu.Game.Screens.Select
 
         private CarouselRoot root;
 
+        private IDisposable subscriptionSets;
+        private IDisposable subscriptionBeatmaps;
+
         private readonly DrawablePool<DrawableCarouselBeatmapSet> setPool = new DrawablePool<DrawableCarouselBeatmapSet>(100);
 
         public BeatmapCarousel()
+
         {
             root = new CarouselRoot(this);
             InternalChild = new OsuContextMenuContainer
@@ -163,10 +167,7 @@ namespace osu.Game.Screens.Select
             };
         }
 
-        [Resolved]
-        private BeatmapManager beatmaps { get; set; }
-
-        [BackgroundDependencyLoader(permitNulls: true)]
+        [BackgroundDependencyLoader]
         private void load(OsuConfigManager config)
         {
             config.BindWith(OsuSetting.RandomSelectAlgorithm, RandomAlgorithm);
@@ -183,13 +184,10 @@ namespace osu.Game.Screens.Select
         {
             base.LoadComplete();
 
-            realmFactory.Context.All<BeatmapSetInfo>().Where(s => !s.DeletePending).QueryAsyncWithNotifications(beatmapSetsChanged);
-            realmFactory.Context.All<BeatmapInfo>().Where(b => !b.Hidden).QueryAsyncWithNotifications(beatmapsChanged);
+            subscriptionSets = realmFactory.Context.All<BeatmapSetInfo>().Where(s => !s.DeletePending).QueryAsyncWithNotifications(beatmapSetsChanged);
+            subscriptionBeatmaps = realmFactory.Context.All<BeatmapInfo>().Where(b => !b.Hidden).QueryAsyncWithNotifications(beatmapsChanged);
         }
 
-        private void beatmapRemoved(BeatmapSetInfo item) => RemoveBeatmapSet(item);
-        private void beatmapUpdated(BeatmapSetInfo item) => UpdateBeatmapSet(item);
-
         private void beatmapSetsChanged(IRealmCollection<BeatmapSetInfo> sender, ChangeSet changes, Exception error)
         {
             if (changes == null)
@@ -921,11 +919,8 @@ namespace osu.Game.Screens.Select
         {
             base.Dispose(isDisposing);
 
-            if (beatmaps != null)
-            {
-                beatmaps.ItemUpdated -= beatmapUpdated;
-                beatmaps.ItemRemoved -= beatmapRemoved;
-            }
+            subscriptionSets?.Dispose();
+            subscriptionBeatmaps?.Dispose();
         }
     }
 }

From fe8a5e867d2cbaa19e95516c61084508ff57af2c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 17 Dec 2021 19:03:02 +0900
Subject: [PATCH 2045/5547] Remove updated/removed flow method mapping

---
 osu.Game/Beatmaps/BeatmapManager.cs         |  4 ----
 osu.Game/Database/IModelManager.cs          | 11 -----------
 osu.Game/Scoring/ScoreManager.cs            | 12 ------------
 osu.Game/Stores/RealmArchiveModelManager.cs | 16 ----------------
 4 files changed, 43 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index 462980448a..d9484a2880 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -232,10 +232,6 @@ namespace osu.Game.Beatmaps
             return beatmapModelManager.IsAvailableLocally(model);
         }
 
-        public event Action<BeatmapSetInfo>? ItemUpdated;
-
-        public event Action<BeatmapSetInfo>? ItemRemoved;
-
         public void Update(BeatmapSetInfo item)
         {
             beatmapModelManager.Update(item);
diff --git a/osu.Game/Database/IModelManager.cs b/osu.Game/Database/IModelManager.cs
index 779d0522f7..e7218b621c 100644
--- a/osu.Game/Database/IModelManager.cs
+++ b/osu.Game/Database/IModelManager.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;
 
 namespace osu.Game.Database
@@ -13,16 +12,6 @@ namespace osu.Game.Database
     public interface IModelManager<TModel>
         where TModel : class
     {
-        /// <summary>
-        /// Fired when an item is updated.
-        /// </summary>
-        event Action<TModel> ItemUpdated;
-
-        /// <summary>
-        /// Fired when an item is removed.
-        /// </summary>
-        event Action<TModel> ItemRemoved;
-
         /// <summary>
         /// Perform an update of the specified item.
         /// TODO: Support file additions/removals.
diff --git a/osu.Game/Scoring/ScoreManager.cs b/osu.Game/Scoring/ScoreManager.cs
index c2a9675474..159c3c2da0 100644
--- a/osu.Game/Scoring/ScoreManager.cs
+++ b/osu.Game/Scoring/ScoreManager.cs
@@ -251,18 +251,6 @@ namespace osu.Game.Scoring
 
         #region Implementation of IModelManager<ScoreInfo>
 
-        public event Action<ScoreInfo> ItemUpdated
-        {
-            add => scoreModelManager.ItemUpdated += value;
-            remove => scoreModelManager.ItemUpdated -= value;
-        }
-
-        public event Action<ScoreInfo> ItemRemoved
-        {
-            add => scoreModelManager.ItemRemoved += value;
-            remove => scoreModelManager.ItemRemoved -= value;
-        }
-
         public void Update(ScoreInfo item)
         {
             scoreModelManager.Update(item);
diff --git a/osu.Game/Stores/RealmArchiveModelManager.cs b/osu.Game/Stores/RealmArchiveModelManager.cs
index d6bb01cedf..8698799b4a 100644
--- a/osu.Game/Stores/RealmArchiveModelManager.cs
+++ b/osu.Game/Stores/RealmArchiveModelManager.cs
@@ -24,22 +24,6 @@ namespace osu.Game.Stores
     public abstract class RealmArchiveModelManager<TModel> : RealmArchiveModelImporter<TModel>, IModelManager<TModel>, IModelFileManager<TModel, RealmNamedFileUsage>
         where TModel : RealmObject, IHasRealmFiles, IHasGuidPrimaryKey, ISoftDelete
     {
-        public event Action<TModel>? ItemUpdated
-        {
-            // This may be brought back for beatmaps to ease integration.
-            // The eventual goal would be not requiring this and using realm subscriptions in its place.
-            add => throw new NotImplementedException();
-            remove => throw new NotImplementedException();
-        }
-
-        public event Action<TModel>? ItemRemoved
-        {
-            // This may be brought back for beatmaps to ease integration.
-            // The eventual goal would be not requiring this and using realm subscriptions in its place.
-            add => throw new NotImplementedException();
-            remove => throw new NotImplementedException();
-        }
-
         private readonly RealmFileStore realmFileStore;
 
         protected RealmArchiveModelManager(Storage storage, RealmContextFactory contextFactory)

From 6d60aa7d9cc45799c40c72f119db2c0936aa606f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 17 Dec 2021 19:09:35 +0900
Subject: [PATCH 2046/5547] Replace `TopLocalRank` event flow with realm
 subscriptions

---
 .../Screens/Select/Carousel/TopLocalRank.cs   | 32 ++++++++++---------
 1 file changed, 17 insertions(+), 15 deletions(-)

diff --git a/osu.Game/Screens/Select/Carousel/TopLocalRank.cs b/osu.Game/Screens/Select/Carousel/TopLocalRank.cs
index a83cb08e1f..2ade213e8b 100644
--- a/osu.Game/Screens/Select/Carousel/TopLocalRank.cs
+++ b/osu.Game/Screens/Select/Carousel/TopLocalRank.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 osu.Framework.Allocation;
 using osu.Framework.Bindables;
@@ -19,9 +20,6 @@ namespace osu.Game.Screens.Select.Carousel
     {
         private readonly BeatmapInfo beatmapInfo;
 
-        [Resolved]
-        private ScoreManager scores { get; set; }
-
         [Resolved]
         private IBindable<RulesetInfo> ruleset { get; set; }
 
@@ -40,26 +38,34 @@ namespace osu.Game.Screens.Select.Carousel
         [BackgroundDependencyLoader]
         private void load()
         {
-            scores.ItemUpdated += scoreChanged;
-            scores.ItemRemoved += scoreChanged;
-
             ruleset.ValueChanged += _ => fetchAndLoadTopScore();
 
             fetchAndLoadTopScore();
         }
 
-        private void scoreChanged(ScoreInfo score)
+        protected override void LoadComplete()
         {
-            if (score.BeatmapInfoID == beatmapInfo.ID)
-                fetchAndLoadTopScore();
+            base.LoadComplete();
+
+            scoreSubscription = realmFactory.Context.All<ScoreInfo>().Where(s => s.BeatmapInfo.ID == beatmapInfo.ID).QueryAsyncWithNotifications((_, changes, ___) =>
+            {
+                if (changes == null)
+                    return;
+
+                fetchTopScoreRank();
+            });
         }
 
+        private IDisposable scoreSubscription;
+
         private ScheduledDelegate scheduledRankUpdate;
 
         private void fetchAndLoadTopScore()
         {
+            // TODO: this lookup likely isn't required, we can use the results of the subscription directly.
             var rank = fetchTopScoreRank();
-            scheduledRankUpdate = Schedule(() =>
+
+            scheduledRankUpdate = Scheduler.Add(() =>
             {
                 Rank = rank;
 
@@ -89,11 +95,7 @@ namespace osu.Game.Screens.Select.Carousel
         {
             base.Dispose(isDisposing);
 
-            if (scores != null)
-            {
-                scores.ItemUpdated -= scoreChanged;
-                scores.ItemRemoved -= scoreChanged;
-            }
+            scoreSubscription?.Dispose();
         }
     }
 }

From 5c0d31ed2444ed5785584691a07e38caab2a931a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 17 Dec 2021 19:21:41 +0900
Subject: [PATCH 2047/5547] Replace `OnlinePlayBeatmapAvailabilityTracker`
 event flow with realm subscriptions

---
 .../OnlinePlayBeatmapAvailabilityTracker.cs   | 46 +++++++++----------
 1 file changed, 23 insertions(+), 23 deletions(-)

diff --git a/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs b/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs
index a32f069470..01999ba766 100644
--- a/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs
+++ b/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs
@@ -3,6 +3,7 @@
 
 using System;
 using System.Diagnostics;
+using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
@@ -10,6 +11,7 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Logging;
 using osu.Framework.Threading;
 using osu.Game.Beatmaps;
+using osu.Game.Database;
 
 namespace osu.Game.Online.Rooms
 {
@@ -29,6 +31,9 @@ namespace osu.Game.Online.Rooms
         [Resolved]
         private BeatmapManager beatmapManager { get; set; }
 
+        [Resolved]
+        private RealmContextFactory realmContextFactory { get; set; } = null!;
+
         /// <summary>
         /// The availability state of the currently selected playlist item.
         /// </summary>
@@ -45,6 +50,8 @@ namespace osu.Game.Online.Rooms
         /// </summary>
         private BeatmapInfo matchingHash;
 
+        private IDisposable realmSubscription;
+
         protected override void LoadComplete()
         {
             base.LoadComplete();
@@ -75,27 +82,24 @@ namespace osu.Game.Online.Rooms
                     if (progressUpdate?.Completed != false)
                         progressUpdate = Scheduler.AddDelayed(updateAvailability, progressUpdate == null ? 0 : 500);
                 }, true);
+
+                // These events are needed for a fringe case where a modified/altered beatmap is imported with matching OnlineIDs.
+                // During the import process this will cause the existing beatmap set to be silently deleted and replaced with the new one.
+                // This is not exposed to us via `BeatmapDownloadTracker` so we have to take it into our own hands (as we care about the hash matching).
+                realmSubscription?.Dispose();
+                realmSubscription = realmContextFactory.Context
+                                                       .All<BeatmapSetInfo>()
+                                                       .Where(s => s.OnlineID == SelectedItem.Value.BeatmapID || (matchingHash != null && s.ID == matchingHash.ID))
+                                                       .QueryAsyncWithNotifications((items, changes, ___) =>
+                                                       {
+                                                           if (changes == null)
+                                                               return;
+
+                                                           Schedule(updateAvailability);
+                                                       });
             }, true);
-
-            // These events are needed for a fringe case where a modified/altered beatmap is imported with matching OnlineIDs.
-            // During the import process this will cause the existing beatmap set to be silently deleted and replaced with the new one.
-            // This is not exposed to us via `BeatmapDownloadTracker` so we have to take it into our own hands (as we care about the hash matching).
-            beatmapManager.ItemUpdated += itemUpdated;
-            beatmapManager.ItemRemoved += itemRemoved;
         }
 
-        private void itemUpdated(BeatmapSetInfo item) => Schedule(() =>
-        {
-            if (matchingHash?.BeatmapSet.ID == item.ID || SelectedItem.Value?.Beatmap.Value.BeatmapSet?.OnlineID == item.OnlineID)
-                updateAvailability();
-        });
-
-        private void itemRemoved(BeatmapSetInfo item) => Schedule(() =>
-        {
-            if (matchingHash?.BeatmapSet.ID == item.ID)
-                updateAvailability();
-        });
-
         private void updateAvailability()
         {
             if (downloadTracker == null)
@@ -148,11 +152,7 @@ namespace osu.Game.Online.Rooms
         {
             base.Dispose(isDisposing);
 
-            if (beatmapManager != null)
-            {
-                beatmapManager.ItemUpdated -= itemUpdated;
-                beatmapManager.ItemRemoved -= itemRemoved;
-            }
+            realmSubscription?.Dispose();
         }
     }
 }

From 86ce2256be0a1619c81fca24618c145bb227933f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 17 Dec 2021 19:26:41 +0900
Subject: [PATCH 2048/5547] Replace `SpectatorScreen` event flow with realm
 subscriptions

---
 osu.Game/Screens/Spectate/SpectatorScreen.cs | 21 +++++++++++++++++---
 1 file changed, 18 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Screens/Spectate/SpectatorScreen.cs b/osu.Game/Screens/Spectate/SpectatorScreen.cs
index c4e75cc413..dd586bdd37 100644
--- a/osu.Game/Screens/Spectate/SpectatorScreen.cs
+++ b/osu.Game/Screens/Spectate/SpectatorScreen.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.Diagnostics;
 using System.Linq;
@@ -54,6 +55,11 @@ namespace osu.Game.Screens.Spectate
             this.users.AddRange(users);
         }
 
+        [Resolved]
+        private RealmContextFactory realmContextFactory { get; set; }
+
+        private IDisposable realmSubscription;
+
         protected override void LoadComplete()
         {
             base.LoadComplete();
@@ -73,7 +79,17 @@ namespace osu.Game.Screens.Spectate
                 playingUserStates.BindTo(spectatorClient.PlayingUserStates);
                 playingUserStates.BindCollectionChanged(onPlayingUserStatesChanged, true);
 
-                beatmaps.ItemUpdated += beatmapUpdated;
+                realmSubscription = realmContextFactory.Context
+                                                       .All<BeatmapSetInfo>()
+                                                       .Where(s => !s.DeletePending)
+                                                       .QueryAsyncWithNotifications((items, changes, ___) =>
+                                                       {
+                                                           if (changes?.InsertedIndices == null)
+                                                               return;
+
+                                                           foreach (int c in changes.InsertedIndices)
+                                                               beatmapUpdated(items[c]);
+                                                       });
 
                 foreach ((int id, var _) in userMap)
                     spectatorClient.WatchUser(id);
@@ -219,8 +235,7 @@ namespace osu.Game.Screens.Spectate
                     spectatorClient.StopWatchingUser(userId);
             }
 
-            if (beatmaps != null)
-                beatmaps.ItemUpdated -= beatmapUpdated;
+            realmSubscription?.Dispose();
         }
     }
 }

From 4295815c7d44800959c90b6284f85c419128058f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 17 Dec 2021 19:39:04 +0900
Subject: [PATCH 2049/5547] Fix invalid equality comparison in
 `BeatmapLeaderboard`

---
 osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
index 869036ef68..0bc93fc36e 100644
--- a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
+++ b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
@@ -37,7 +37,7 @@ namespace osu.Game.Screens.Select.Leaderboards
             get => beatmapInfo;
             set
             {
-                if (beatmapInfo.Equals(value))
+                if (beatmapInfo?.Equals(value) == true)
                     return;
 
                 beatmapInfo = value;

From 99e46cd26b30007f1f919840711814a58bbbc51d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 21 Dec 2021 16:09:00 +0900
Subject: [PATCH 2050/5547] Fix missing `BeatmapMetadata.ToString`

This is relied on by a few usages.
---
 osu.Game/Beatmaps/BeatmapMetadata.cs | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/osu.Game/Beatmaps/BeatmapMetadata.cs b/osu.Game/Beatmaps/BeatmapMetadata.cs
index dc5517375d..f729b55154 100644
--- a/osu.Game/Beatmaps/BeatmapMetadata.cs
+++ b/osu.Game/Beatmaps/BeatmapMetadata.cs
@@ -54,5 +54,7 @@ namespace osu.Game.Beatmaps
         }
 
         #endregion
+
+        public override string ToString() => this.GetDisplayTitle();
     }
 }

From 167c399e8ada3ce3d47870d14b4e70235099ed81 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 21 Dec 2021 16:09:19 +0900
Subject: [PATCH 2051/5547] Fix invalid DI resolution of `RealmFileStore`

---
 osu.Game/Storyboards/Drawables/DrawableStoryboard.cs | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Storyboards/Drawables/DrawableStoryboard.cs b/osu.Game/Storyboards/Drawables/DrawableStoryboard.cs
index d21813d97f..3d6240bc98 100644
--- a/osu.Game/Storyboards/Drawables/DrawableStoryboard.cs
+++ b/osu.Game/Storyboards/Drawables/DrawableStoryboard.cs
@@ -10,6 +10,7 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Textures;
 using osu.Framework.Platform;
+using osu.Game.Database;
 using osu.Game.Screens.Play;
 using osu.Game.Stores;
 
@@ -76,12 +77,12 @@ namespace osu.Game.Storyboards.Drawables
         }
 
         [BackgroundDependencyLoader(true)]
-        private void load(RealmFileStore fileStore, GameplayClock clock, CancellationToken? cancellationToken, GameHost host)
+        private void load(GameplayClock clock, CancellationToken? cancellationToken, GameHost host, RealmContextFactory realmContextFactory)
         {
             if (clock != null)
                 Clock = clock;
 
-            dependencies.Cache(new TextureStore(host.CreateTextureLoaderStore(fileStore.Store), false, scaleAdjust: 1));
+            dependencies.Cache(new TextureStore(host.CreateTextureLoaderStore(new RealmFileStore(realmContextFactory, host.Storage).Store), false, scaleAdjust: 1));
 
             foreach (var layer in Storyboard.Layers)
             {

From 2a980cc474a70993b160da4eb6c4ce80f0c8d634 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 21 Dec 2021 16:09:32 +0900
Subject: [PATCH 2052/5547] Fix `BeatmapInfo` file lookup not handling the case
 where no files exist

Quite common for test scenes.
---
 osu.Game/Beatmaps/BeatmapInfo.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Beatmaps/BeatmapInfo.cs b/osu.Game/Beatmaps/BeatmapInfo.cs
index fc0d007df4..16133ae362 100644
--- a/osu.Game/Beatmaps/BeatmapInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapInfo.cs
@@ -38,7 +38,7 @@ namespace osu.Game.Beatmaps
         public BeatmapSetInfo? BeatmapSet { get; set; }
 
         [Ignored]
-        public RealmNamedFileUsage? File => BeatmapSet?.Files.First(f => f.File.Hash == Hash);
+        public RealmNamedFileUsage? File => BeatmapSet?.Files.FirstOrDefault(f => f.File.Hash == Hash);
 
         public BeatmapOnlineStatus Status
         {

From dcd69e852eb0a516fc4d7bdfe27b23503f5d66b9 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 21 Dec 2021 16:30:34 +0900
Subject: [PATCH 2053/5547] Add back settable `RulesetID` for now

---
 osu.Game/Beatmaps/BeatmapInfo.cs                  | 15 ++++++++++++++-
 osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs |  4 +---
 2 files changed, 15 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapInfo.cs b/osu.Game/Beatmaps/BeatmapInfo.cs
index 16133ae362..ea2508032e 100644
--- a/osu.Game/Beatmaps/BeatmapInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapInfo.cs
@@ -140,8 +140,21 @@ namespace osu.Game.Beatmaps
 
         #region Compatibility properties
 
+        private int rulesetID;
+
         [Ignored]
-        public int RulesetID => Ruleset.OnlineID;
+        public int RulesetID
+        {
+            // ReSharper disable once ConstantConditionalAccessQualifier
+            get => Ruleset?.OnlineID ?? rulesetID;
+            set
+            {
+                if (Ruleset != null)
+                    throw new InvalidOperationException($"Cannot set a {nameof(RulesetID)} when {nameof(Ruleset)} is non-null");
+
+                rulesetID = value;
+            }
+        }
 
         [Ignored]
         public Guid BeatmapSetInfoID => BeatmapSet?.ID ?? Guid.Empty;
diff --git a/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs b/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
index 5c61d302c2..e5db9d045a 100644
--- a/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
+++ b/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
@@ -11,7 +11,6 @@ using osu.Game.Beatmaps.ControlPoints;
 using osu.Game.Beatmaps.Legacy;
 using osu.Game.Beatmaps.Timing;
 using osu.Game.IO;
-using osu.Game.Rulesets;
 using osu.Game.Rulesets.Objects.Legacy;
 
 namespace osu.Game.Beatmaps.Formats
@@ -142,8 +141,7 @@ namespace osu.Game.Beatmaps.Formats
                     break;
 
                 case @"Mode":
-                    // TODO: ha ha ha.
-                    beatmap.BeatmapInfo.Ruleset = new RulesetInfo(Parsing.ParseInt(pair.Value), "some ruleset", "wangs", true /* probably not */);
+                    beatmap.BeatmapInfo.RulesetID = Parsing.ParseInt(pair.Value);
 
                     switch (beatmap.BeatmapInfo.RulesetID)
                     {

From 0793b0f0abf827976f0b813170ff933d44ea31fa Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 21 Dec 2021 16:37:29 +0900
Subject: [PATCH 2054/5547] Fix `Max` lookup methods not checking for zero
 beatmap count

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

diff --git a/osu.Game/Beatmaps/BeatmapSetInfo.cs b/osu.Game/Beatmaps/BeatmapSetInfo.cs
index 4aea0c6ce8..ed16e3a965 100644
--- a/osu.Game/Beatmaps/BeatmapSetInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapSetInfo.cs
@@ -50,11 +50,11 @@ namespace osu.Game.Beatmaps
         /// </summary>
         public bool Protected { get; set; }
 
-        public double MaxStarDifficulty => Beatmaps.Max(b => b.StarRating);
+        public double MaxStarDifficulty => Beatmaps.Count == 0 ? 0 : Beatmaps.Max(b => b.StarRating);
 
-        public double MaxLength => Beatmaps.Max(b => b.Length);
+        public double MaxLength => Beatmaps.Count == 0 ? 0 : Beatmaps.Max(b => b.Length);
 
-        public double MaxBPM => Beatmaps.Max(b => b.BPM);
+        public double MaxBPM => Beatmaps.Count == 0 ? 0 : Beatmaps.Max(b => b.BPM);
 
         /// <summary>
         /// Returns the storage path for the file in this beatmapset with the given filename, if any exists, otherwise null.

From 33060990b7741ec2823a58fb590c4a4da554a8c3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 22 Dec 2021 17:05:00 +0900
Subject: [PATCH 2055/5547] Temporarily disable `WorkingBeatmapCache` and fix
 multiple invalid data flows

---
 osu.Game/Beatmaps/WorkingBeatmapCache.cs      | 19 ++--------
 osu.Game/Overlays/MusicController.cs          | 36 ++++++++++---------
 osu.Game/Screens/Menu/IntroScreen.cs          | 32 +++++++++++++++--
 .../Select/Leaderboards/BeatmapLeaderboard.cs | 11 ------
 .../Visual/RateAdjustedBeatmapTestScene.cs    |  7 ++--
 5 files changed, 57 insertions(+), 48 deletions(-)

diff --git a/osu.Game/Beatmaps/WorkingBeatmapCache.cs b/osu.Game/Beatmaps/WorkingBeatmapCache.cs
index 95983ae052..888851d1e8 100644
--- a/osu.Game/Beatmaps/WorkingBeatmapCache.cs
+++ b/osu.Game/Beatmaps/WorkingBeatmapCache.cs
@@ -12,7 +12,6 @@ using osu.Framework.IO.Stores;
 using osu.Framework.Lists;
 using osu.Framework.Logging;
 using osu.Framework.Platform;
-using osu.Framework.Statistics;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps.Formats;
 using osu.Game.Database;
@@ -86,23 +85,11 @@ namespace osu.Game.Beatmaps
             if (beatmapInfo?.BeatmapSet == null)
                 return DefaultBeatmap;
 
-            lock (workingCache)
-            {
-                var working = workingCache.FirstOrDefault(w => beatmapInfo.Equals(w.BeatmapInfo));
+            WorkingBeatmap working = null;
 
-                if (working != null)
-                    return working;
+            working = new BeatmapManagerWorkingBeatmap(beatmapInfo, this);
 
-                // TODO: is this still required..?
-                //beatmapInfo.Metadata ??= beatmapInfo.BeatmapSet.Metadata;
-
-                workingCache.Add(working = new BeatmapManagerWorkingBeatmap(beatmapInfo, this));
-
-                // best effort; may be higher than expected.
-                GlobalStatistics.Get<int>(nameof(Beatmaps), $"Cached {nameof(WorkingBeatmap)}s").Value = workingCache.Count();
-
-                return working;
-            }
+            return working;
         }
 
         #region IResourceStorageProvider
diff --git a/osu.Game/Overlays/MusicController.cs b/osu.Game/Overlays/MusicController.cs
index 8c115c2c94..2731096a00 100644
--- a/osu.Game/Overlays/MusicController.cs
+++ b/osu.Game/Overlays/MusicController.cs
@@ -71,33 +71,37 @@ namespace osu.Game.Overlays
         [Resolved]
         private RealmContextFactory realmFactory { get; set; }
 
-        protected override void LoadComplete()
+        [BackgroundDependencyLoader]
+        private void load()
         {
-            base.LoadComplete();
-
-            beatmapSubscription = realmFactory.Context.All<BeatmapSetInfo>().QueryAsyncWithNotifications(beatmapsChanged);
-
             // Todo: These binds really shouldn't be here, but are unlikely to cause any issues for now.
             // They are placed here for now since some tests rely on setting the beatmap _and_ their hierarchies inside their load(), which runs before the MusicController's load().
             beatmap.BindValueChanged(beatmapChanged, true);
             mods.BindValueChanged(_ => ResetTrackAdjustments(), true);
         }
 
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            // ensure we're ready before completing async load.
+            // probably not a good way of handling this (as there is a period we aren't watching for changes until the realm subscription finishes up.
+            foreach (var s in realmFactory.Context.All<BeatmapSetInfo>())
+                beatmapSets.Add(s);
+
+            beatmapSubscription = realmFactory.Context.All<BeatmapSetInfo>().QueryAsyncWithNotifications(beatmapsChanged);
+        }
+
         private void beatmapsChanged(IRealmCollection<BeatmapSetInfo> sender, ChangeSet changes, Exception error)
         {
             if (changes == null)
-            {
-                beatmapSets.AddRange(sender);
-            }
+                return;
 
-            // beatmaps.ItemUpdated += set => Schedule(() =>
-            // {
-            //     beatmapSets.Remove(set);
-            //     beatmapSets.Add(set);
-            // });
-            // beatmaps.ItemRemoved += set => Schedule(() => beatmapSets.RemoveAll(s => s.ID == set.ID));
-            //
-            // beatmapSets.AddRange(beatmaps.GetAllUsableBeatmapSets(IncludedDetails.Minimal, true).OrderBy(_ => RNG.Next()));
+            foreach (int i in changes.InsertedIndices)
+                beatmapSets.Insert(i, sender[i]);
+
+            foreach (int i in changes.DeletedIndices.OrderByDescending(i => i))
+                beatmapSets.RemoveAt(i);
         }
 
         /// <summary>
diff --git a/osu.Game/Screens/Menu/IntroScreen.cs b/osu.Game/Screens/Menu/IntroScreen.cs
index f54228b441..e02066560d 100644
--- a/osu.Game/Screens/Menu/IntroScreen.cs
+++ b/osu.Game/Screens/Menu/IntroScreen.cs
@@ -81,8 +81,11 @@ namespace osu.Game.Screens.Menu
             this.createNextScreen = createNextScreen;
         }
 
+        [Resolved]
+        private BeatmapManager beatmaps { get; set; }
+
         [BackgroundDependencyLoader]
-        private void load(OsuConfigManager config, SkinManager skinManager, BeatmapManager beatmaps, Framework.Game game, RealmContextFactory realmContextFactory)
+        private void load(OsuConfigManager config, SkinManager skinManager, Framework.Game game, RealmContextFactory realmContextFactory)
         {
             // prevent user from changing beatmap while the intro is still running.
             beatmap = Beatmap.BeginLease(false);
@@ -101,7 +104,13 @@ namespace osu.Game.Screens.Menu
                 if (sets.Count > 0)
                 {
                     setInfo = beatmaps.QueryBeatmapSet(s => s.ID == sets[RNG.Next(0, sets.Count - 1)].ID);
-                    initialBeatmap = beatmaps.GetWorkingBeatmap(setInfo?.PerformRead(s => s.Beatmaps[0].ToLive(realmContextFactory)));
+                    setInfo?.PerformRead(s =>
+                    {
+                        if (s.Beatmaps.Count == 0)
+                            return;
+
+                        initialBeatmap = beatmaps.GetWorkingBeatmap(s.Beatmaps[0].ToLive(realmContextFactory));
+                    });
                 }
             }
 
@@ -131,12 +140,29 @@ namespace osu.Game.Screens.Menu
                 if (setInfo == null)
                     return false;
 
-                initialBeatmap = beatmaps.GetWorkingBeatmap(setInfo.PerformRead(s => s.Beatmaps[0].ToLive(realmContextFactory)));
+                setInfo.PerformRead(s =>
+                {
+                    if (s.Beatmaps.Count == 0)
+                        return;
+
+                    initialBeatmap = beatmaps.GetWorkingBeatmap(s.Beatmaps[0].ToLive(realmContextFactory));
+                });
 
                 return UsingThemedIntro = initialBeatmap != null;
             }
         }
 
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            // TODO: This is temporary to get the setInfo on the update thread, to make things work "better" without using ILive everywhere.
+            var setInfo = beatmaps.QueryBeatmapSets(b => b.Hash == BeatmapHash).FirstOrDefault();
+
+            if (setInfo?.Value.Beatmaps.Count > 0)
+                initialBeatmap = beatmaps.GetWorkingBeatmap(setInfo.Value.Beatmaps.First());
+        }
+
         public override void OnResuming(IScreen last)
         {
             this.FadeIn(300);
diff --git a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
index 0bc93fc36e..c2ab930550 100644
--- a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
+++ b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
@@ -126,17 +126,6 @@ namespace osu.Game.Screens.Select.Leaderboards
             TopScore = null;
         }
 
-        private void scoreStoreChanged(ScoreInfo score)
-        {
-            if (Scope != BeatmapLeaderboardScope.Local)
-                return;
-
-            if (BeatmapInfo?.ID != score.BeatmapInfoID)
-                return;
-
-            RefreshScores();
-        }
-
         protected override bool IsOnlineScope => Scope != BeatmapLeaderboardScope.Local;
 
         private CancellationTokenSource loadCancellationSource;
diff --git a/osu.Game/Tests/Visual/RateAdjustedBeatmapTestScene.cs b/osu.Game/Tests/Visual/RateAdjustedBeatmapTestScene.cs
index ad24ffc7b8..5bac2635f5 100644
--- a/osu.Game/Tests/Visual/RateAdjustedBeatmapTestScene.cs
+++ b/osu.Game/Tests/Visual/RateAdjustedBeatmapTestScene.cs
@@ -12,8 +12,11 @@ namespace osu.Game.Tests.Visual
         {
             base.Update();
 
-            // note that this will override any mod rate application
-            Beatmap.Value.Track.Tempo.Value = Clock.Rate;
+            if (Beatmap.Value.TrackLoaded && Beatmap.Value.Track != null) // null check... wasn't required until now?
+            {
+                // note that this will override any mod rate application
+                Beatmap.Value.Track.Tempo.Value = Clock.Rate;
+            }
         }
     }
 }

From 667cdb2475279378beee6012ec59e7bc4018d636 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 23 Dec 2021 17:09:24 +0900
Subject: [PATCH 2056/5547] Fix skin lookup when there's no beatmap file
 available

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

diff --git a/osu.Game/Skinning/LegacySkin.cs b/osu.Game/Skinning/LegacySkin.cs
index e677e2c01b..81c695b8da 100644
--- a/osu.Game/Skinning/LegacySkin.cs
+++ b/osu.Game/Skinning/LegacySkin.cs
@@ -63,7 +63,7 @@ namespace osu.Game.Skinning
         /// <param name="resources">Access to raw game resources.</param>
         /// <param name="configurationFilename">The user-facing filename of the configuration file to be parsed. Can accept an .osu or skin.ini file.</param>
         protected LegacySkin(SkinInfo skin, [CanBeNull] IResourceStore<byte[]> storage, [CanBeNull] IStorageResourceProvider resources, string configurationFilename)
-            : this(skin, storage, resources, storage?.GetStream(configurationFilename))
+            : this(skin, storage, resources, string.IsNullOrEmpty(configurationFilename) ? null : storage?.GetStream(configurationFilename))
         {
         }
 

From 3811bd85208e3667b3e6da0aa40c2616673a6588 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 4 Jan 2022 14:35:18 +0900
Subject: [PATCH 2057/5547] Fix some null inspections

---
 .../Visual/SongSelect/TestScenePlaySongSelect.cs          | 4 ++--
 osu.Game/Beatmaps/WorkingBeatmapCache.cs                  | 6 +-----
 osu.Game/Overlays/BeatmapSet/Scores/ScoreTable.cs         | 2 +-
 osu.Game/Rulesets/Edit/Checks/CheckAudioInVideo.cs        | 2 +-
 osu.Game/Screens/Edit/Verify/IssueList.cs                 | 2 +-
 osu.Game/Screens/Select/BeatmapDeleteDialog.cs            | 2 +-
 osu.Game/Screens/Select/Carousel/CarouselBeatmapSet.cs    | 8 ++++----
 .../Screens/Select/Carousel/DrawableCarouselBeatmap.cs    | 2 +-
 osu.Game/Screens/Select/Carousel/SetPanelContent.cs       | 4 ++--
 9 files changed, 14 insertions(+), 18 deletions(-)

diff --git a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
index 586cd273be..7b81f330d0 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
@@ -744,7 +744,7 @@ namespace osu.Game.Tests.Visual.SongSelect
 
             AddUntilStep("Check ruleset changed to mania", () => Ruleset.Value.OnlineID == 3);
 
-            AddAssert("Selected beatmap still same set", () => songSelect.Carousel.SelectedBeatmapInfo.BeatmapSet.OnlineID == previousSetID);
+            AddAssert("Selected beatmap still same set", () => songSelect.Carousel.SelectedBeatmapInfo.BeatmapSet?.OnlineID == previousSetID);
             AddAssert("Selected beatmap is mania", () => Beatmap.Value.BeatmapInfo.Ruleset.OnlineID == 3);
         }
 
@@ -760,7 +760,7 @@ namespace osu.Game.Tests.Visual.SongSelect
             AddStep("import huge difficulty count map", () =>
             {
                 var usableRulesets = rulesets.AvailableRulesets.Where(r => r.OnlineID != 2).ToArray();
-                imported = manager.Import(TestResources.CreateTestBeatmapSetInfo(50, usableRulesets)).GetResultSafely().Value;
+                imported = manager.Import(TestResources.CreateTestBeatmapSetInfo(50, usableRulesets)).GetResultSafely()?.Value;
             });
 
             AddStep("select the first beatmap of import", () => Beatmap.Value = manager.GetWorkingBeatmap(imported.Beatmaps.First()));
diff --git a/osu.Game/Beatmaps/WorkingBeatmapCache.cs b/osu.Game/Beatmaps/WorkingBeatmapCache.cs
index 888851d1e8..beec48becd 100644
--- a/osu.Game/Beatmaps/WorkingBeatmapCache.cs
+++ b/osu.Game/Beatmaps/WorkingBeatmapCache.cs
@@ -85,11 +85,7 @@ namespace osu.Game.Beatmaps
             if (beatmapInfo?.BeatmapSet == null)
                 return DefaultBeatmap;
 
-            WorkingBeatmap working = null;
-
-            working = new BeatmapManagerWorkingBeatmap(beatmapInfo, this);
-
-            return working;
+            return new BeatmapManagerWorkingBeatmap(beatmapInfo, this);
         }
 
         #region IResourceStorageProvider
diff --git a/osu.Game/Overlays/BeatmapSet/Scores/ScoreTable.cs b/osu.Game/Overlays/BeatmapSet/Scores/ScoreTable.cs
index 2c78fa264e..5ef434c427 100644
--- a/osu.Game/Overlays/BeatmapSet/Scores/ScoreTable.cs
+++ b/osu.Game/Overlays/BeatmapSet/Scores/ScoreTable.cs
@@ -173,7 +173,7 @@ namespace osu.Game.Overlays.BeatmapSet.Scores
                 {
                     Text = score.MaxCombo.ToLocalisableString(@"0\x"),
                     Font = OsuFont.GetFont(size: text_size),
-                    Colour = score.MaxCombo == score.BeatmapInfo?.MaxCombo ? highAccuracyColour : Color4.White
+                    Colour = score.MaxCombo == score.BeatmapInfo.MaxCombo ? highAccuracyColour : Color4.White
                 }
             };
 
diff --git a/osu.Game/Rulesets/Edit/Checks/CheckAudioInVideo.cs b/osu.Game/Rulesets/Edit/Checks/CheckAudioInVideo.cs
index 255671c807..a285979fd2 100644
--- a/osu.Game/Rulesets/Edit/Checks/CheckAudioInVideo.cs
+++ b/osu.Game/Rulesets/Edit/Checks/CheckAudioInVideo.cs
@@ -42,7 +42,7 @@ namespace osu.Game.Rulesets.Edit.Checks
 
             foreach (string filename in videoPaths)
             {
-                string storagePath = beatmapSet.GetPathForFile(filename);
+                string storagePath = beatmapSet?.GetPathForFile(filename);
 
                 if (storagePath == null)
                 {
diff --git a/osu.Game/Screens/Edit/Verify/IssueList.cs b/osu.Game/Screens/Edit/Verify/IssueList.cs
index cadcdebc6e..5fe43199cc 100644
--- a/osu.Game/Screens/Edit/Verify/IssueList.cs
+++ b/osu.Game/Screens/Edit/Verify/IssueList.cs
@@ -40,7 +40,7 @@ namespace osu.Game.Screens.Edit.Verify
         private void load(OverlayColourProvider colours)
         {
             generalVerifier = new BeatmapVerifier();
-            rulesetVerifier = beatmap.BeatmapInfo.Ruleset?.CreateInstance().CreateBeatmapVerifier();
+            rulesetVerifier = beatmap.BeatmapInfo.Ruleset.CreateInstance().CreateBeatmapVerifier();
 
             context = new BeatmapVerifierContext(beatmap, workingBeatmap.Value, verify.InterpretedDifficulty.Value);
             verify.InterpretedDifficulty.BindValueChanged(difficulty => context.InterpretedDifficulty = difficulty.NewValue);
diff --git a/osu.Game/Screens/Select/BeatmapDeleteDialog.cs b/osu.Game/Screens/Select/BeatmapDeleteDialog.cs
index 307c2352e3..1ac278d045 100644
--- a/osu.Game/Screens/Select/BeatmapDeleteDialog.cs
+++ b/osu.Game/Screens/Select/BeatmapDeleteDialog.cs
@@ -20,7 +20,7 @@ namespace osu.Game.Screens.Select
 
         public BeatmapDeleteDialog(BeatmapSetInfo beatmap)
         {
-            BodyText = $@"{beatmap.Metadata?.Artist} - {beatmap.Metadata?.Title}";
+            BodyText = $@"{beatmap.Metadata.Artist} - {beatmap.Metadata.Title}";
 
             Icon = FontAwesome.Regular.TrashAlt;
             HeaderText = @"Confirm deletion of";
diff --git a/osu.Game/Screens/Select/Carousel/CarouselBeatmapSet.cs b/osu.Game/Screens/Select/Carousel/CarouselBeatmapSet.cs
index a1a8de04ae..f2700e9053 100644
--- a/osu.Game/Screens/Select/Carousel/CarouselBeatmapSet.cs
+++ b/osu.Game/Screens/Select/Carousel/CarouselBeatmapSet.cs
@@ -63,16 +63,16 @@ namespace osu.Game.Screens.Select.Carousel
             {
                 default:
                 case SortMode.Artist:
-                    return string.Compare(BeatmapSet.Metadata?.Artist, otherSet.BeatmapSet.Metadata?.Artist, StringComparison.OrdinalIgnoreCase);
+                    return string.Compare(BeatmapSet.Metadata.Artist, otherSet.BeatmapSet.Metadata.Artist, StringComparison.OrdinalIgnoreCase);
 
                 case SortMode.Title:
-                    return string.Compare(BeatmapSet.Metadata?.Title, otherSet.BeatmapSet.Metadata?.Title, StringComparison.OrdinalIgnoreCase);
+                    return string.Compare(BeatmapSet.Metadata.Title, otherSet.BeatmapSet.Metadata.Title, StringComparison.OrdinalIgnoreCase);
 
                 case SortMode.Author:
-                    return string.Compare(BeatmapSet.Metadata?.Author.Username, otherSet.BeatmapSet.Metadata?.Author.Username, StringComparison.OrdinalIgnoreCase);
+                    return string.Compare(BeatmapSet.Metadata.Author.Username, otherSet.BeatmapSet.Metadata.Author.Username, StringComparison.OrdinalIgnoreCase);
 
                 case SortMode.Source:
-                    return string.Compare(BeatmapSet.Metadata?.Source, otherSet.BeatmapSet.Metadata?.Source, StringComparison.OrdinalIgnoreCase);
+                    return string.Compare(BeatmapSet.Metadata.Source, otherSet.BeatmapSet.Metadata.Source, StringComparison.OrdinalIgnoreCase);
 
                 case SortMode.DateAdded:
                     return otherSet.BeatmapSet.DateAdded.CompareTo(BeatmapSet.DateAdded);
diff --git a/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmap.cs b/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmap.cs
index 2eb226df70..a5fabd9237 100644
--- a/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmap.cs
+++ b/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmap.cs
@@ -142,7 +142,7 @@ namespace osu.Game.Screens.Select.Carousel
                                         },
                                         new OsuSpriteText
                                         {
-                                            Text = $"{(beatmapInfo.Metadata ?? beatmapInfo.BeatmapSet.Metadata).Author.Username}",
+                                            Text = $"{beatmapInfo.Metadata.Author.Username}",
                                             Font = OsuFont.GetFont(italics: true),
                                             Anchor = Anchor.BottomLeft,
                                             Origin = Anchor.BottomLeft
diff --git a/osu.Game/Screens/Select/Carousel/SetPanelContent.cs b/osu.Game/Screens/Select/Carousel/SetPanelContent.cs
index 9aa85c872e..f2054677b0 100644
--- a/osu.Game/Screens/Select/Carousel/SetPanelContent.cs
+++ b/osu.Game/Screens/Select/Carousel/SetPanelContent.cs
@@ -41,13 +41,13 @@ namespace osu.Game.Screens.Select.Carousel
                 {
                     new OsuSpriteText
                     {
-                        Text = new RomanisableString(beatmapSet.Metadata?.TitleUnicode, beatmapSet.Metadata?.Title),
+                        Text = new RomanisableString(beatmapSet.Metadata.TitleUnicode, beatmapSet.Metadata.Title),
                         Font = OsuFont.GetFont(weight: FontWeight.Bold, size: 22, italics: true),
                         Shadow = true,
                     },
                     new OsuSpriteText
                     {
-                        Text = new RomanisableString(beatmapSet.Metadata?.ArtistUnicode, beatmapSet.Metadata?.Artist),
+                        Text = new RomanisableString(beatmapSet.Metadata.ArtistUnicode, beatmapSet.Metadata.Artist),
                         Font = OsuFont.GetFont(weight: FontWeight.SemiBold, size: 17, italics: true),
                         Shadow = true,
                     },

From de076678fe3120b32079f6356b87e4311e149256 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 4 Jan 2022 15:59:41 +0900
Subject: [PATCH 2058/5547] Fix some remaining test failures

---
 osu.Game.Tests/Online/TestAPIModJsonSerialization.cs | 12 ++++++++++--
 .../Visual/Ranking/TestSceneAccuracyCircle.cs        |  1 +
 osu.Game/Online/Solo/SubmittableScore.cs             |  3 +--
 osu.Game/Screens/Ranking/ScorePanelList.cs           |  4 ++--
 4 files changed, 14 insertions(+), 6 deletions(-)

diff --git a/osu.Game.Tests/Online/TestAPIModJsonSerialization.cs b/osu.Game.Tests/Online/TestAPIModJsonSerialization.cs
index 4b160e1d67..1b7a7656b5 100644
--- a/osu.Game.Tests/Online/TestAPIModJsonSerialization.cs
+++ b/osu.Game.Tests/Online/TestAPIModJsonSerialization.cs
@@ -9,10 +9,12 @@ using osu.Framework.Bindables;
 using osu.Game.Beatmaps;
 using osu.Game.Configuration;
 using osu.Game.Online.API;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Solo;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Difficulty;
 using osu.Game.Rulesets.Mods;
+using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Osu.Mods;
 using osu.Game.Rulesets.UI;
 using osu.Game.Scoring;
@@ -93,7 +95,11 @@ namespace osu.Game.Tests.Online
         [Test]
         public void TestDeserialiseSubmittableScoreWithEmptyMods()
         {
-            var score = new SubmittableScore(new ScoreInfo());
+            var score = new SubmittableScore(new ScoreInfo
+            {
+                User = new APIUser(),
+                Ruleset = new OsuRuleset().RulesetInfo,
+            });
 
             var deserialised = JsonConvert.DeserializeObject<SubmittableScore>(JsonConvert.SerializeObject(score));
 
@@ -105,7 +111,9 @@ namespace osu.Game.Tests.Online
         {
             var score = new SubmittableScore(new ScoreInfo
             {
-                Mods = new Mod[] { new OsuModDoubleTime { SpeedChange = { Value = 2 } } }
+                Mods = new Mod[] { new OsuModDoubleTime { SpeedChange = { Value = 2 } } },
+                User = new APIUser(),
+                Ruleset = new OsuRuleset().RulesetInfo,
             });
 
             var deserialised = JsonConvert.DeserializeObject<SubmittableScore>(JsonConvert.SerializeObject(score));
diff --git a/osu.Game.Tests/Visual/Ranking/TestSceneAccuracyCircle.cs b/osu.Game.Tests/Visual/Ranking/TestSceneAccuracyCircle.cs
index 944941723e..ac736086fd 100644
--- a/osu.Game.Tests/Visual/Ranking/TestSceneAccuracyCircle.cs
+++ b/osu.Game.Tests/Visual/Ranking/TestSceneAccuracyCircle.cs
@@ -72,6 +72,7 @@ namespace osu.Game.Tests.Visual.Ranking
                 Username = "peppy",
             },
             BeatmapInfo = new TestBeatmap(new OsuRuleset().RulesetInfo).BeatmapInfo,
+            Ruleset = new OsuRuleset().RulesetInfo,
             Mods = new Mod[] { new OsuModHardRock(), new OsuModDoubleTime() },
             TotalScore = 2845370,
             Accuracy = accuracy,
diff --git a/osu.Game/Online/Solo/SubmittableScore.cs b/osu.Game/Online/Solo/SubmittableScore.cs
index 327806f390..4e4dae5157 100644
--- a/osu.Game/Online/Solo/SubmittableScore.cs
+++ b/osu.Game/Online/Solo/SubmittableScore.cs
@@ -10,7 +10,6 @@ using osu.Game.Online.API;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets.Scoring;
 using osu.Game.Scoring;
-using osu.Game.Users;
 
 namespace osu.Game.Online.Solo
 {
@@ -48,7 +47,7 @@ namespace osu.Game.Online.Solo
         public APIMod[] Mods { get; set; }
 
         [JsonProperty("user")]
-        public IUser User { get; set; }
+        public APIUser User { get; set; }
 
         [JsonProperty("statistics")]
         public Dictionary<HitResult, int> Statistics { get; set; }
diff --git a/osu.Game/Screens/Ranking/ScorePanelList.cs b/osu.Game/Screens/Ranking/ScorePanelList.cs
index 7f270b3a2a..c2ef5529e8 100644
--- a/osu.Game/Screens/Ranking/ScorePanelList.cs
+++ b/osu.Game/Screens/Ranking/ScorePanelList.cs
@@ -158,7 +158,7 @@ namespace osu.Game.Screens.Ranking
 
                             trackingContainer.Show();
 
-                            if (SelectedScore.Value.Equals(score))
+                            if (SelectedScore.Value?.Equals(score) == true)
                             {
                                 SelectedScore.TriggerChange();
                             }
@@ -185,7 +185,7 @@ namespace osu.Game.Screens.Ranking
         private void selectedScoreChanged(ValueChangedEvent<ScoreInfo> score)
         {
             // avoid contracting panels unnecessarily when TriggerChange is fired manually.
-            if (!score.OldValue.Equals(score.NewValue))
+            if (score.OldValue != null && !score.OldValue.Equals(score.NewValue))
             {
                 // Contract the old panel.
                 foreach (var t in flow.Where(t => t.Panel.Score.Equals(score.OldValue)))

From 8461eaab46922fb44c937ef62b1469acd7315045 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 7 Jan 2022 14:17:22 +0900
Subject: [PATCH 2059/5547] `BeatmapSetInfo` detach support

---
 .../Database/BeatmapImporterTests.cs          | 45 +++++++++++++++++++
 osu.Game/Beatmaps/BeatmapInfo.cs              |  4 ++
 osu.Game/Beatmaps/BeatmapManager.cs           |  4 +-
 osu.Game/Beatmaps/BeatmapModelManager.cs      |  2 +-
 osu.Game/Beatmaps/BeatmapSetInfo.cs           |  4 ++
 osu.Game/Beatmaps/WorkingBeatmapCache.cs      |  4 ++
 osu.Game/Collections/CollectionManager.cs     |  2 +-
 osu.Game/Database/RealmLive.cs                |  5 ++-
 osu.Game/Database/RealmObjectExtensions.cs    | 26 +++++++++--
 osu.Game/Screens/Select/BeatmapCarousel.cs    |  4 ++
 10 files changed, 90 insertions(+), 10 deletions(-)

diff --git a/osu.Game.Tests/Database/BeatmapImporterTests.cs b/osu.Game.Tests/Database/BeatmapImporterTests.cs
index 5b63db1972..78b8628669 100644
--- a/osu.Game.Tests/Database/BeatmapImporterTests.cs
+++ b/osu.Game.Tests/Database/BeatmapImporterTests.cs
@@ -35,6 +35,51 @@ namespace osu.Game.Tests.Database
     [TestFixture]
     public class BeatmapImporterTests : RealmTest
     {
+        [Test]
+        public void TestDetach()
+        {
+            RunTestWithRealmAsync(async (realmFactory, storage) =>
+            {
+                using (var importer = new BeatmapModelManager(realmFactory, storage))
+                using (new RulesetStore(realmFactory, storage))
+                {
+                    ILive<BeatmapSetInfo>? imported;
+
+                    using (var reader = new ZipArchiveReader(TestResources.GetTestBeatmapStream()))
+                        imported = await importer.Import(reader);
+
+                    Assert.NotNull(imported);
+                    Debug.Assert(imported != null);
+
+                    BeatmapSetInfo? detached = null;
+
+                    imported.PerformRead(live =>
+                    {
+                        var timer = new Stopwatch();
+                        timer.Start();
+                        detached = live.Detach();
+                        Logger.Log($"Detach took {timer.ElapsedMilliseconds} ms");
+
+                        Logger.Log($"NamedFiles: {live.Files.Count} {detached.Files.Count}");
+                        Logger.Log($"Files: {live.Files.Select(f => f.File).Count()} {detached.Files.Select(f => f.File).Count()}");
+                        Logger.Log($"Difficulties: {live.Beatmaps.Count} {detached.Beatmaps.Count}");
+                        Logger.Log($"BeatmapDifficulties: {live.Beatmaps.Select(f => f.Difficulty).Count()} {detached.Beatmaps.Select(f => f.Difficulty).Count()}");
+                        Logger.Log($"Metadata: {live.Metadata} {detached.Metadata}");
+                    });
+
+                    Logger.Log("Testing detached-ness");
+
+                    Debug.Assert(detached != null);
+
+                    Logger.Log($"NamedFiles: {detached.Files.Count}");
+                    Logger.Log($"Files: {detached.Files.Select(f => f.File).Count()}");
+                    Logger.Log($"Difficulties: {detached.Beatmaps.Count}");
+                    Logger.Log($"BeatmapDifficulties: {detached.Beatmaps.Select(f => f.Difficulty).Count()}");
+                    Logger.Log($"Metadata: {detached.Metadata}");
+                }
+            });
+        }
+
         [Test]
         public void TestImportBeatmapThenCleanup()
         {
diff --git a/osu.Game/Beatmaps/BeatmapInfo.cs b/osu.Game/Beatmaps/BeatmapInfo.cs
index ea2508032e..153f40e39d 100644
--- a/osu.Game/Beatmaps/BeatmapInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapInfo.cs
@@ -3,6 +3,7 @@
 
 using System;
 using System.Linq;
+using AutoMapper;
 using JetBrains.Annotations;
 using Newtonsoft.Json;
 using osu.Framework.Testing;
@@ -143,6 +144,7 @@ namespace osu.Game.Beatmaps
         private int rulesetID;
 
         [Ignored]
+        [IgnoreMap]
         public int RulesetID
         {
             // ReSharper disable once ConstantConditionalAccessQualifier
@@ -182,6 +184,8 @@ namespace osu.Game.Beatmaps
 
         public BeatmapInfo Clone() => this.Detach();
 
+        public override string ToString() => Metadata?.ToString() ?? base.ToString();
+
         #endregion
     }
 }
diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index d9484a2880..2479390700 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -151,7 +151,7 @@ namespace osu.Game.Beatmaps
         public List<BeatmapSetInfo> GetAllUsableBeatmapSets()
         {
             using (var context = contextFactory.CreateContext())
-                return context.All<BeatmapSetInfo>().Where(b => !b.DeletePending).ToList();
+                return context.All<BeatmapSetInfo>().Where(b => !b.DeletePending).Detach();
         }
 
         /// <summary>
@@ -199,7 +199,7 @@ namespace osu.Game.Beatmaps
         /// </summary>
         /// <param name="query">The query.</param>
         /// <returns>The first result for the provided query, or null if no results were found.</returns>
-        public BeatmapInfo? QueryBeatmap(Expression<Func<BeatmapInfo, bool>> query) => beatmapModelManager.QueryBeatmap(query);
+        public BeatmapInfo? QueryBeatmap(Expression<Func<BeatmapInfo, bool>> query) => beatmapModelManager.QueryBeatmap(query)?.Detach();
 
         /// <summary>
         /// Saves an <see cref="IBeatmap"/> file against a given <see cref="BeatmapInfo"/>.
diff --git a/osu.Game/Beatmaps/BeatmapModelManager.cs b/osu.Game/Beatmaps/BeatmapModelManager.cs
index 387521ee1d..254babc3a1 100644
--- a/osu.Game/Beatmaps/BeatmapModelManager.cs
+++ b/osu.Game/Beatmaps/BeatmapModelManager.cs
@@ -107,7 +107,7 @@ namespace osu.Game.Beatmaps
         public BeatmapInfo? QueryBeatmap(Expression<Func<BeatmapInfo, bool>> query)
         {
             using (var context = ContextFactory.CreateContext())
-                return context.All<BeatmapInfo>().FirstOrDefault(query); // TODO: ?.ToLive();
+                return context.All<BeatmapInfo>().FirstOrDefault(query)?.Detach();
         }
     }
 }
diff --git a/osu.Game/Beatmaps/BeatmapSetInfo.cs b/osu.Game/Beatmaps/BeatmapSetInfo.cs
index ed16e3a965..1cc6a96f40 100644
--- a/osu.Game/Beatmaps/BeatmapSetInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapSetInfo.cs
@@ -4,6 +4,7 @@
 using System;
 using System.Collections.Generic;
 using System.Linq;
+using AutoMapper;
 using osu.Framework.Testing;
 using osu.Game.Database;
 using osu.Game.Extensions;
@@ -75,7 +76,10 @@ namespace osu.Game.Beatmaps
 
         public bool Equals(IBeatmapSetInfo? other) => other is BeatmapSetInfo b && Equals(b);
 
+        [IgnoreMap]
         IEnumerable<IBeatmapInfo> IBeatmapSetInfo.Beatmaps => Beatmaps;
+
+        [IgnoreMap]
         IEnumerable<INamedFileUsage> IHasNamedFiles.Files => Files;
     }
 }
diff --git a/osu.Game/Beatmaps/WorkingBeatmapCache.cs b/osu.Game/Beatmaps/WorkingBeatmapCache.cs
index beec48becd..6be69b5477 100644
--- a/osu.Game/Beatmaps/WorkingBeatmapCache.cs
+++ b/osu.Game/Beatmaps/WorkingBeatmapCache.cs
@@ -82,6 +82,10 @@ namespace osu.Game.Beatmaps
                 beatmapInfo = BeatmapManager.QueryBeatmap(b => b.ID == lookupId);
             }
 
+            // TODO: FUCK THE WORLD :D
+            if (beatmapInfo?.IsManaged == true)
+                beatmapInfo = beatmapInfo.Detach();
+
             if (beatmapInfo?.BeatmapSet == null)
                 return DefaultBeatmap;
 
diff --git a/osu.Game/Collections/CollectionManager.cs b/osu.Game/Collections/CollectionManager.cs
index c4f991094c..d230e649f7 100644
--- a/osu.Game/Collections/CollectionManager.cs
+++ b/osu.Game/Collections/CollectionManager.cs
@@ -209,7 +209,7 @@ namespace osu.Game.Collections
 
                             string checksum = sr.ReadString();
 
-                            var beatmap = beatmaps.QueryBeatmap(b => b.MD5Hash == checksum);
+                            var beatmap = beatmaps.QueryBeatmap(b => b.MD5Hash == checksum)?.Detach();
                             if (beatmap != null)
                                 collection.Beatmaps.Add(beatmap);
                         }
diff --git a/osu.Game/Database/RealmLive.cs b/osu.Game/Database/RealmLive.cs
index 90b8814c24..45bc0e4200 100644
--- a/osu.Game/Database/RealmLive.cs
+++ b/osu.Game/Database/RealmLive.cs
@@ -61,8 +61,9 @@ namespace osu.Game.Database
         /// <param name="perform">The action to perform.</param>
         public TReturn PerformRead<TReturn>(Func<T, TReturn> perform)
         {
-            if (typeof(RealmObjectBase).IsAssignableFrom(typeof(TReturn)))
-                throw new InvalidOperationException(@$"Realm live objects should not exit the scope of {nameof(PerformRead)}.");
+            // TODO: this is weird and kinda wrong... unmanaged objects should be allowed?
+            // if (typeof(RealmObjectBase).IsAssignableFrom(typeof(TReturn)))
+            //     throw new InvalidOperationException(@$"Realm live objects should not exit the scope of {nameof(PerformRead)}.");
 
             if (!IsManaged)
                 return perform(data);
diff --git a/osu.Game/Database/RealmObjectExtensions.cs b/osu.Game/Database/RealmObjectExtensions.cs
index e09f046421..9d7d08e106 100644
--- a/osu.Game/Database/RealmObjectExtensions.cs
+++ b/osu.Game/Database/RealmObjectExtensions.cs
@@ -6,7 +6,10 @@ using System.Collections.Generic;
 using System.Linq;
 using AutoMapper;
 using osu.Framework.Development;
+using osu.Game.Beatmaps;
 using osu.Game.Input.Bindings;
+using osu.Game.Models;
+using osu.Game.Rulesets;
 using Realms;
 
 #nullable enable
@@ -18,9 +21,23 @@ namespace osu.Game.Database
         private static readonly IMapper mapper = new MapperConfiguration(c =>
         {
             c.ShouldMapField = fi => false;
-            c.ShouldMapProperty = pi => pi.SetMethod != null && pi.SetMethod.IsPublic;
+            c.ShouldMapProperty = pi => true;
 
             c.CreateMap<RealmKeyBinding, RealmKeyBinding>();
+            c.CreateMap<BeatmapMetadata, BeatmapMetadata>();
+            c.CreateMap<BeatmapDifficulty, BeatmapDifficulty>();
+            c.CreateMap<RulesetInfo, RulesetInfo>();
+            c.CreateMap<RealmUser, RealmUser>();
+            c.CreateMap<RealmFile, RealmFile>();
+            c.CreateMap<RealmNamedFileUsage, RealmNamedFileUsage>();
+            c.CreateMap<BeatmapInfo, BeatmapInfo>();
+            c.CreateMap<BeatmapSetInfo, BeatmapSetInfo>();
+
+            c.ForAllMaps((a, b) =>
+            {
+                b.PreserveReferences();
+                b.MaxDepth(2);
+            });
         }).CreateMapper();
 
         /// <summary>
@@ -32,7 +49,7 @@ namespace osu.Game.Database
         /// <param name="items">A list of managed <see cref="RealmObject"/>s to detach.</param>
         /// <typeparam name="T">The type of object.</typeparam>
         /// <returns>A list containing non-managed copies of provided items.</returns>
-        public static List<T> Detach<T>(this IEnumerable<T> items) where T : RealmObject
+        public static List<T> Detach<T>(this IEnumerable<T> items) where T : RealmObjectBase
         {
             var list = new List<T>();
 
@@ -51,7 +68,7 @@ namespace osu.Game.Database
         /// <param name="item">The managed <see cref="RealmObject"/> to detach.</param>
         /// <typeparam name="T">The type of object.</typeparam>
         /// <returns>A non-managed copy of provided item. Will return the provided item if already detached.</returns>
-        public static T Detach<T>(this T item) where T : RealmObject
+        public static T Detach<T>(this T item) where T : RealmObjectBase
         {
             if (!item.IsManaged)
                 return item;
@@ -65,7 +82,8 @@ namespace osu.Game.Database
             return realmList.Select(l => new RealmLiveUnmanaged<T>(l)).Cast<ILive<T>>().ToList();
         }
 
-        public static ILive<T> ToLiveUnmanaged<T>(this T realmObject)
+        public static ILive<T> ToLiveUnmanaged<T>(this T realmObject
+        )
             where T : RealmObject, IHasGuidPrimaryKey
         {
             return new RealmLiveUnmanaged<T>(realmObject);
diff --git a/osu.Game/Screens/Select/BeatmapCarousel.cs b/osu.Game/Screens/Select/BeatmapCarousel.cs
index 78e416c64b..226d2df619 100644
--- a/osu.Game/Screens/Select/BeatmapCarousel.cs
+++ b/osu.Game/Screens/Select/BeatmapCarousel.cs
@@ -662,6 +662,10 @@ namespace osu.Game.Screens.Select
             if (beatmapSet.Beatmaps.All(b => b.Hidden))
                 return null;
 
+            // TODO: FUCK THE WORLD :D
+            if (beatmapSet?.IsManaged == true)
+                beatmapSet = beatmapSet.Detach();
+
             // todo: probably not required any more.
             // foreach (var b in beatmapSet.Beatmaps)
             //     b.Metadata ??= beatmapSet.Metadata;

From de3a338d02f2767a6051298790efdd7927262538 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 7 Jan 2022 14:47:03 +0900
Subject: [PATCH 2060/5547] Update realm queries to use `Filter` to allow for
 indirect property filtering

---
 .../Screens/Select/Carousel/TopLocalRank.cs   | 20 ++++++++++++-------
 .../Select/Leaderboards/BeatmapLeaderboard.cs | 18 ++++++++---------
 2 files changed, 22 insertions(+), 16 deletions(-)

diff --git a/osu.Game/Screens/Select/Carousel/TopLocalRank.cs b/osu.Game/Screens/Select/Carousel/TopLocalRank.cs
index 2ade213e8b..9a0085c62a 100644
--- a/osu.Game/Screens/Select/Carousel/TopLocalRank.cs
+++ b/osu.Game/Screens/Select/Carousel/TopLocalRank.cs
@@ -13,6 +13,7 @@ using osu.Game.Online.API;
 using osu.Game.Online.Leaderboards;
 using osu.Game.Rulesets;
 using osu.Game.Scoring;
+using Realms;
 
 namespace osu.Game.Screens.Select.Carousel
 {
@@ -47,13 +48,15 @@ namespace osu.Game.Screens.Select.Carousel
         {
             base.LoadComplete();
 
-            scoreSubscription = realmFactory.Context.All<ScoreInfo>().Where(s => s.BeatmapInfo.ID == beatmapInfo.ID).QueryAsyncWithNotifications((_, changes, ___) =>
-            {
-                if (changes == null)
-                    return;
+            scoreSubscription = realmFactory.Context.All<ScoreInfo>()
+                                            .Filter($"{nameof(ScoreInfo.Beatmap)}.{nameof(BeatmapInfo.ID)} = $0", beatmapInfo.ID)
+                                            .QueryAsyncWithNotifications((_, changes, ___) =>
+                                            {
+                                                if (changes == null)
+                                                    return;
 
-                fetchTopScoreRank();
-            });
+                                                fetchTopScoreRank();
+                                            });
         }
 
         private IDisposable scoreSubscription;
@@ -84,7 +87,10 @@ namespace osu.Game.Screens.Select.Carousel
 
             using (var realm = realmFactory.CreateContext())
             {
-                return realm.All<ScoreInfo>().Where(s => s.UserID == api.LocalUser.Value.Id && s.BeatmapInfoID == beatmapInfo.ID && s.RulesetID == ruleset.Value.ID && !s.DeletePending)
+                return realm.All<ScoreInfo>()
+                            .AsEnumerable()
+                            // TODO: update to use a realm filter directly (or at least figure out the beatmap part to reduce scope).
+                            .Where(s => s.UserID == api.LocalUser.Value.Id && s.BeatmapInfoID == beatmapInfo.ID && s.RulesetID == ruleset.Value.ID && !s.DeletePending)
                             .OrderByDescending(s => s.TotalScore)
                             .FirstOrDefault()
                             ?.Rank;
diff --git a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
index c2ab930550..f2654cbdee 100644
--- a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
+++ b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
@@ -17,6 +17,7 @@ using osu.Game.Online.Leaderboards;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Scoring;
+using Realms;
 
 namespace osu.Game.Screens.Select.Leaderboards
 {
@@ -80,9 +81,6 @@ namespace osu.Game.Screens.Select.Leaderboards
         [Resolved]
         private IAPIProvider api { get; set; }
 
-        [Resolved]
-        private RealmContextFactory realmContextFactory { get; set; }
-
         [BackgroundDependencyLoader]
         private void load()
         {
@@ -111,13 +109,15 @@ namespace osu.Game.Screens.Select.Leaderboards
             if (beatmapInfo == null)
                 return;
 
-            scoreSubscription = realmContextFactory.Context.All<ScoreInfo>().Where(s => s.BeatmapInfo.ID == beatmapInfo.ID).QueryAsyncWithNotifications((_, changes, ___) =>
-            {
-                if (changes == null)
-                    return;
+            scoreSubscription = realmFactory.Context.All<ScoreInfo>()
+                                            .Filter($"{nameof(ScoreInfo.Beatmap)}.{nameof(BeatmapInfo.ID)} = $0", beatmapInfo.ID)
+                                            .QueryAsyncWithNotifications((_, changes, ___) =>
+                                            {
+                                                if (changes == null)
+                                                    return;
 
-                RefreshScores();
-            });
+                                                RefreshScores();
+                                            });
         }
 
         protected override void Reset()

From e1f77b87def512748cf8cde40c2b82c606545654 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 7 Jan 2022 16:48:49 +0900
Subject: [PATCH 2061/5547] "Fix" OnlinePlayBeatmapAvailabilityTracker

---
 .../Rooms/OnlinePlayBeatmapAvailabilityTracker.cs   | 13 ++++++++-----
 1 file changed, 8 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs b/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs
index 01999ba766..d344846e5f 100644
--- a/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs
+++ b/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs
@@ -83,13 +83,10 @@ namespace osu.Game.Online.Rooms
                         progressUpdate = Scheduler.AddDelayed(updateAvailability, progressUpdate == null ? 0 : 500);
                 }, true);
 
-                // These events are needed for a fringe case where a modified/altered beatmap is imported with matching OnlineIDs.
-                // During the import process this will cause the existing beatmap set to be silently deleted and replaced with the new one.
-                // This is not exposed to us via `BeatmapDownloadTracker` so we have to take it into our own hands (as we care about the hash matching).
                 realmSubscription?.Dispose();
                 realmSubscription = realmContextFactory.Context
                                                        .All<BeatmapSetInfo>()
-                                                       .Where(s => s.OnlineID == SelectedItem.Value.BeatmapID || (matchingHash != null && s.ID == matchingHash.ID))
+                                                       .Where(s => s.OnlineID == SelectedItem.Value.BeatmapID) // TODO: figure out if we need this hash match in the subscription || s.ID == matchingHash?.ID)
                                                        .QueryAsyncWithNotifications((items, changes, ___) =>
                                                        {
                                                            if (changes == null)
@@ -145,7 +142,13 @@ namespace osu.Game.Online.Rooms
             int onlineId = SelectedItem.Value.Beatmap.Value.OnlineID;
             string checksum = SelectedItem.Value.Beatmap.Value.MD5Hash;
 
-            return beatmapManager.QueryBeatmap(b => b.OnlineID == onlineId && b.MD5Hash == checksum && !b.BeatmapSet.DeletePending);
+            var foundBeatmap = beatmapManager.QueryBeatmap(b => b.OnlineID == onlineId && b.MD5Hash == checksum);
+
+            // can't be included in the above query due to realm limitations.
+            if (foundBeatmap?.BeatmapSet?.DeletePending == true)
+                return null;
+
+            return foundBeatmap;
         }
 
         protected override void Dispose(bool isDisposing)

From 2d2faa72a96ca601888da4d55d28381ff382f2fc Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 7 Jan 2022 16:49:03 +0900
Subject: [PATCH 2062/5547] Fix rulesets being out of order

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

diff --git a/osu.Game/Rulesets/RulesetStore.cs b/osu.Game/Rulesets/RulesetStore.cs
index 6ec89f9dc5..c675fbbf63 100644
--- a/osu.Game/Rulesets/RulesetStore.cs
+++ b/osu.Game/Rulesets/RulesetStore.cs
@@ -141,7 +141,7 @@ namespace osu.Game.Rulesets
                     List<RulesetInfo> detachedRulesets = new List<RulesetInfo>();
 
                     // perform a consistency check and detach final rulesets from realm for cross-thread runtime usage.
-                    foreach (var r in rulesets)
+                    foreach (var r in rulesets.OrderBy(r => r.OnlineID))
                     {
                         try
                         {

From 60d2de8a3b486d3b9b85fa726784740732d5d4c5 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 7 Jan 2022 16:49:13 +0900
Subject: [PATCH 2063/5547] Fix potential nullref when song select filters to
 no results

---
 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 54a4c3270d..9ba5e77bbb 100644
--- a/osu.Game/Screens/Select/SongSelect.cs
+++ b/osu.Game/Screens/Select/SongSelect.cs
@@ -482,7 +482,7 @@ namespace osu.Game.Screens.Select
             else
                 selectionChangedDebounce = Scheduler.AddDelayed(run, 200);
 
-            if (!beatmap.Equals(beatmapInfoPrevious))
+            if (beatmap?.Equals(beatmapInfoPrevious) != true)
             {
                 if (beatmap != null && beatmapInfoPrevious != null && Time.Current - audioFeedbackLastPlaybackTime >= 50)
                 {

From 2b8706b6ce2762bf6d1130840308a4bb3f6dd905 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 7 Jan 2022 17:27:48 +0900
Subject: [PATCH 2064/5547] Detach and reattach scores to make work

---
 osu.Game/Database/RealmObjectExtensions.cs           |  2 ++
 osu.Game/OsuGame.cs                                  |  2 ++
 .../Scoring/Legacy/DatabasedLegacyScoreDecoder.cs    |  4 ++--
 osu.Game/Scoring/ScoreInfo.cs                        |  8 ++++++++
 osu.Game/Scoring/ScoreModelManager.cs                | 11 ++++++++++-
 osu.Game/Screens/Play/Player.cs                      | 12 +++++-------
 .../Select/Leaderboards/BeatmapLeaderboard.cs        |  7 ++++++-
 7 files changed, 35 insertions(+), 11 deletions(-)

diff --git a/osu.Game/Database/RealmObjectExtensions.cs b/osu.Game/Database/RealmObjectExtensions.cs
index 9d7d08e106..dfa3076448 100644
--- a/osu.Game/Database/RealmObjectExtensions.cs
+++ b/osu.Game/Database/RealmObjectExtensions.cs
@@ -10,6 +10,7 @@ using osu.Game.Beatmaps;
 using osu.Game.Input.Bindings;
 using osu.Game.Models;
 using osu.Game.Rulesets;
+using osu.Game.Scoring;
 using Realms;
 
 #nullable enable
@@ -27,6 +28,7 @@ namespace osu.Game.Database
             c.CreateMap<BeatmapMetadata, BeatmapMetadata>();
             c.CreateMap<BeatmapDifficulty, BeatmapDifficulty>();
             c.CreateMap<RulesetInfo, RulesetInfo>();
+            c.CreateMap<ScoreInfo, ScoreInfo>();
             c.CreateMap<RealmUser, RealmUser>();
             c.CreateMap<RealmFile, RealmFile>();
             c.CreateMap<RealmNamedFileUsage, RealmNamedFileUsage>();
diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index 8d1eccb7c1..149de9bc76 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -502,6 +502,8 @@ namespace osu.Game
                 return;
             }
 
+            databasedScoreInfo = databasedScoreInfo.Detach();
+
             var databasedScore = ScoreManager.GetScore(databasedScoreInfo);
 
             if (databasedScore.Replay == null)
diff --git a/osu.Game/Scoring/Legacy/DatabasedLegacyScoreDecoder.cs b/osu.Game/Scoring/Legacy/DatabasedLegacyScoreDecoder.cs
index a49eb89ecc..03e13455f0 100644
--- a/osu.Game/Scoring/Legacy/DatabasedLegacyScoreDecoder.cs
+++ b/osu.Game/Scoring/Legacy/DatabasedLegacyScoreDecoder.cs
@@ -21,7 +21,7 @@ namespace osu.Game.Scoring.Legacy
             this.beatmaps = beatmaps;
         }
 
-        protected override Ruleset GetRuleset(int rulesetId) => rulesets.GetRuleset(rulesetId).CreateInstance();
-        protected override WorkingBeatmap GetBeatmap(string md5Hash) => beatmaps.GetWorkingBeatmap(beatmaps.QueryBeatmap(b => !b.BeatmapSet.DeletePending && b.MD5Hash == md5Hash));
+        protected override Ruleset GetRuleset(int rulesetId) => rulesets.GetRuleset(rulesetId)?.CreateInstance();
+        protected override WorkingBeatmap GetBeatmap(string md5Hash) => beatmaps.GetWorkingBeatmap(beatmaps.QueryBeatmap(b => b.MD5Hash == md5Hash));
     }
 }
diff --git a/osu.Game/Scoring/ScoreInfo.cs b/osu.Game/Scoring/ScoreInfo.cs
index 65c31951b8..c07f4a4f87 100644
--- a/osu.Game/Scoring/ScoreInfo.cs
+++ b/osu.Game/Scoring/ScoreInfo.cs
@@ -4,6 +4,7 @@
 using System;
 using System.Collections.Generic;
 using System.Linq;
+using AutoMapper;
 using Newtonsoft.Json;
 using osu.Framework.Localisation;
 using osu.Framework.Testing;
@@ -112,9 +113,16 @@ namespace osu.Game.Scoring
         [MapTo(nameof(Rank))]
         public int RankInt { get; set; }
 
+        [IgnoreMap]
         IRulesetInfo IScoreInfo.Ruleset => Ruleset;
+
+        [IgnoreMap]
         IBeatmapInfo IScoreInfo.Beatmap => Beatmap;
+
+        [IgnoreMap]
         IUser IScoreInfo.User => User;
+
+        [IgnoreMap]
         IEnumerable<INamedFileUsage> IHasNamedFiles.Files => Files;
 
         #region Properties required to make things work with existing usages
diff --git a/osu.Game/Scoring/ScoreModelManager.cs b/osu.Game/Scoring/ScoreModelManager.cs
index 81f80df3ad..8f04e50f63 100644
--- a/osu.Game/Scoring/ScoreModelManager.cs
+++ b/osu.Game/Scoring/ScoreModelManager.cs
@@ -55,6 +55,15 @@ namespace osu.Game.Scoring
         public Score GetScore(ScoreInfo score) => new LegacyDatabasedScore(score, rulesets, beatmaps(), Files.Store);
 
         protected override Task Populate(ScoreInfo model, ArchiveReader? archive, Realm realm, CancellationToken cancellationToken = default)
-            => Task.CompletedTask;
+        {
+            // Ensure the beatmap is not detached.
+            if (!model.Beatmap.IsManaged)
+                model.Beatmap = realm.Find<BeatmapInfo>(model.Beatmap.ID);
+
+            if (!model.Ruleset.IsManaged)
+                model.Ruleset = realm.Find<RulesetInfo>(model.Ruleset.ShortName);
+
+            return Task.CompletedTask;
+        }
     }
 }
diff --git a/osu.Game/Screens/Play/Player.cs b/osu.Game/Screens/Play/Player.cs
index 5a443ec48e..9fc0d70cc0 100644
--- a/osu.Game/Screens/Play/Player.cs
+++ b/osu.Game/Screens/Play/Player.cs
@@ -1038,19 +1038,17 @@ namespace osu.Game.Screens.Play
                 replayReader = new LegacyByteArrayReader(stream.ToArray(), "replay.osr");
             }
 
+            // the import process will re-attach managed beatmap/rulesets to this score. we don't want this for now, so create a temporary copy to import.
+            var importableScore = score.ScoreInfo.DeepClone();
+
             // For the time being, online ID responses are not really useful for anything.
             // In addition, the IDs provided via new (lazer) endpoints are based on a different autoincrement from legacy (stable) scores.
             //
             // Until we better define the server-side logic behind this, let's not store the online ID to avoid potential unique constraint
             // conflicts across various systems (ie. solo and multiplayer).
-            long onlineScoreId = score.ScoreInfo.OnlineID;
+            importableScore.OnlineID = -1;
 
-            score.ScoreInfo.OnlineID = -1;
-
-            await scoreManager.Import(score.ScoreInfo, replayReader).ConfigureAwait(false);
-
-            // ... And restore the online ID for other processes to handle correctly (e.g. de-duplication for the results screen).
-            score.ScoreInfo.OnlineID = onlineScoreId;
+            await scoreManager.Import(importableScore, replayReader).ConfigureAwait(false);
         }
 
         /// <summary>
diff --git a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
index f2654cbdee..caa994a98b 100644
--- a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
+++ b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
@@ -149,7 +149,10 @@ namespace osu.Game.Screens.Select.Leaderboards
             {
                 using (var realm = realmFactory.CreateContext())
                 {
-                    var scores = realm.All<ScoreInfo>().Where(s => !s.DeletePending && s.BeatmapInfo.ID == fetchBeatmapInfo.ID && s.Ruleset.OnlineID == ruleset.Value.ID);
+                    var scores = realm.All<ScoreInfo>()
+                                      .AsEnumerable()
+                                      // TODO: update to use a realm filter directly (or at least figure out the beatmap part to reduce scope).
+                                      .Where(s => !s.DeletePending && s.BeatmapInfo.ID == fetchBeatmapInfo.ID && s.Ruleset.OnlineID == ruleset.Value.ID);
 
                     if (filterMods && !mods.Value.Any())
                     {
@@ -164,6 +167,8 @@ namespace osu.Game.Screens.Select.Leaderboards
                         scores = scores.Where(s => s.Mods.Any(m => selectedMods.Contains(m.Acronym)));
                     }
 
+                    scores = scores.Detach();
+
                     scoreManager.OrderByTotalScoreAsync(scores.ToArray(), cancellationToken)
                                 .ContinueWith(ordered => scoresCallback?.Invoke(ordered.Result), TaskContinuationOptions.OnlyOnRanToCompletion);
 

From aaefd72c6917a2f497b8883b81116406cd29fc5d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 7 Jan 2022 22:57:12 +0900
Subject: [PATCH 2065/5547] Handle ignored mappings locally in `Detach`
 configuration

---
 osu.Game/Beatmaps/BeatmapSetInfo.cs        | 3 ---
 osu.Game/Database/RealmObjectExtensions.cs | 4 +++-
 osu.Game/Scoring/ScoreInfo.cs              | 8 --------
 3 files changed, 3 insertions(+), 12 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapSetInfo.cs b/osu.Game/Beatmaps/BeatmapSetInfo.cs
index 1cc6a96f40..f6ca184ea3 100644
--- a/osu.Game/Beatmaps/BeatmapSetInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapSetInfo.cs
@@ -4,7 +4,6 @@
 using System;
 using System.Collections.Generic;
 using System.Linq;
-using AutoMapper;
 using osu.Framework.Testing;
 using osu.Game.Database;
 using osu.Game.Extensions;
@@ -76,10 +75,8 @@ namespace osu.Game.Beatmaps
 
         public bool Equals(IBeatmapSetInfo? other) => other is BeatmapSetInfo b && Equals(b);
 
-        [IgnoreMap]
         IEnumerable<IBeatmapInfo> IBeatmapSetInfo.Beatmaps => Beatmaps;
 
-        [IgnoreMap]
         IEnumerable<INamedFileUsage> IHasNamedFiles.Files => Files;
     }
 }
diff --git a/osu.Game/Database/RealmObjectExtensions.cs b/osu.Game/Database/RealmObjectExtensions.cs
index dfa3076448..9827ca6edd 100644
--- a/osu.Game/Database/RealmObjectExtensions.cs
+++ b/osu.Game/Database/RealmObjectExtensions.cs
@@ -22,7 +22,9 @@ namespace osu.Game.Database
         private static readonly IMapper mapper = new MapperConfiguration(c =>
         {
             c.ShouldMapField = fi => false;
-            c.ShouldMapProperty = pi => true;
+            // If we want to limit this further, we can avoid mapping properties with no setter that are not IList<>.
+            // Takes a bit of effort to determine whether this is the case though, see https://stackoverflow.com/questions/951536/how-do-i-tell-whether-a-type-implements-ilist
+            c.ShouldMapProperty = pi => pi.GetMethod?.IsPublic == true;
 
             c.CreateMap<RealmKeyBinding, RealmKeyBinding>();
             c.CreateMap<BeatmapMetadata, BeatmapMetadata>();
diff --git a/osu.Game/Scoring/ScoreInfo.cs b/osu.Game/Scoring/ScoreInfo.cs
index c07f4a4f87..65c31951b8 100644
--- a/osu.Game/Scoring/ScoreInfo.cs
+++ b/osu.Game/Scoring/ScoreInfo.cs
@@ -4,7 +4,6 @@
 using System;
 using System.Collections.Generic;
 using System.Linq;
-using AutoMapper;
 using Newtonsoft.Json;
 using osu.Framework.Localisation;
 using osu.Framework.Testing;
@@ -113,16 +112,9 @@ namespace osu.Game.Scoring
         [MapTo(nameof(Rank))]
         public int RankInt { get; set; }
 
-        [IgnoreMap]
         IRulesetInfo IScoreInfo.Ruleset => Ruleset;
-
-        [IgnoreMap]
         IBeatmapInfo IScoreInfo.Beatmap => Beatmap;
-
-        [IgnoreMap]
         IUser IScoreInfo.User => User;
-
-        [IgnoreMap]
         IEnumerable<INamedFileUsage> IHasNamedFiles.Files => Files;
 
         #region Properties required to make things work with existing usages

From 6919df18faf5d11a9ff2d05ea3d96c773b43f446 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 7 Jan 2022 22:57:22 +0900
Subject: [PATCH 2066/5547] Fix incorrect ordering and grouping of difficulties
 at song select

---
 osu.Game/Screens/Select/Carousel/CarouselBeatmapSet.cs | 2 ++
 osu.Game/Screens/Select/Carousel/SetPanelContent.cs    | 3 ++-
 2 files changed, 4 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Select/Carousel/CarouselBeatmapSet.cs b/osu.Game/Screens/Select/Carousel/CarouselBeatmapSet.cs
index f2700e9053..b2b3b5411c 100644
--- a/osu.Game/Screens/Select/Carousel/CarouselBeatmapSet.cs
+++ b/osu.Game/Screens/Select/Carousel/CarouselBeatmapSet.cs
@@ -39,6 +39,8 @@ namespace osu.Game.Screens.Select.Carousel
 
             beatmapSet.Beatmaps
                       .Where(b => !b.Hidden)
+                      .OrderBy(b => b.RulesetID)
+                      .ThenBy(b => b.StarRating)
                       .Select(b => new CarouselBeatmap(b))
                       .ForEach(AddChild);
         }
diff --git a/osu.Game/Screens/Select/Carousel/SetPanelContent.cs b/osu.Game/Screens/Select/Carousel/SetPanelContent.cs
index f2054677b0..619806f96e 100644
--- a/osu.Game/Screens/Select/Carousel/SetPanelContent.cs
+++ b/osu.Game/Screens/Select/Carousel/SetPanelContent.cs
@@ -87,7 +87,8 @@ namespace osu.Game.Screens.Select.Carousel
             var beatmaps = carouselSet.Beatmaps.ToList();
 
             return beatmaps.Count > maximum_difficulty_icons
-                ? (IEnumerable<DifficultyIcon>)beatmaps.GroupBy(b => b.BeatmapInfo.Ruleset).Select(group => new FilterableGroupedDifficultyIcon(group.ToList(), group.Key))
+                ? (IEnumerable<DifficultyIcon>)beatmaps.GroupBy(b => b.BeatmapInfo.RulesetID)
+                                                       .Select(group => new FilterableGroupedDifficultyIcon(group.ToList(), group.Last().BeatmapInfo.Ruleset))
                 : beatmaps.Select(b => new FilterableDifficultyIcon(b));
         }
     }

From 52ca6491594f7179c873ab782ea77802a9b5ae9d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 7 Jan 2022 23:55:53 +0900
Subject: [PATCH 2067/5547] Fix results screen test failures due to relation
 query

---
 .../Visual/Ranking/TestSceneResultsScreen.cs   | 18 +++++++++++++++---
 1 file changed, 15 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Tests/Visual/Ranking/TestSceneResultsScreen.cs b/osu.Game.Tests/Visual/Ranking/TestSceneResultsScreen.cs
index 666cbf02b5..14ceb8f4d4 100644
--- a/osu.Game.Tests/Visual/Ranking/TestSceneResultsScreen.cs
+++ b/osu.Game.Tests/Visual/Ranking/TestSceneResultsScreen.cs
@@ -13,8 +13,10 @@ using osu.Framework.Screens;
 using osu.Framework.Testing;
 using osu.Framework.Utils;
 using osu.Game.Beatmaps;
+using osu.Game.Database;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Online.API;
+using osu.Game.Rulesets;
 using osu.Game.Scoring;
 using osu.Game.Screens;
 using osu.Game.Screens.Play;
@@ -23,6 +25,7 @@ using osu.Game.Screens.Ranking.Statistics;
 using osu.Game.Tests.Resources;
 using osuTK;
 using osuTK.Input;
+using Realms;
 
 namespace osu.Game.Tests.Visual.Ranking
 {
@@ -32,13 +35,22 @@ namespace osu.Game.Tests.Visual.Ranking
         [Resolved]
         private BeatmapManager beatmaps { get; set; }
 
+        [Resolved]
+        private RealmContextFactory realmContextFactory { get; set; }
+
         protected override void LoadComplete()
         {
             base.LoadComplete();
 
-            var beatmapInfo = beatmaps.QueryBeatmap(b => b.RulesetID == 0);
-            if (beatmapInfo != null)
-                Beatmap.Value = beatmaps.GetWorkingBeatmap(beatmapInfo);
+            using (var realm = realmContextFactory.CreateContext())
+            {
+                var beatmapInfo = realm.All<BeatmapInfo>()
+                                       .Filter($"{nameof(BeatmapInfo.Ruleset)}.{nameof(RulesetInfo.OnlineID)} = $0", 0)
+                                       .FirstOrDefault();
+
+                if (beatmapInfo != null)
+                    Beatmap.Value = beatmaps.GetWorkingBeatmap(beatmapInfo);
+            }
         }
 
         [Test]

From 76670a8faa9c964920e4a6277f4f2dd0bad4281b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 7 Jan 2022 23:56:04 +0900
Subject: [PATCH 2068/5547] Fix `BeatmapDifficultyCache` not working with
 detached beatmaps

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

diff --git a/osu.Game/Beatmaps/BeatmapDifficultyCache.cs b/osu.Game/Beatmaps/BeatmapDifficultyCache.cs
index f760c25170..981120c5a8 100644
--- a/osu.Game/Beatmaps/BeatmapDifficultyCache.cs
+++ b/osu.Game/Beatmaps/BeatmapDifficultyCache.cs
@@ -136,7 +136,7 @@ namespace osu.Game.Beatmaps
             var localRulesetInfo = rulesetInfo as RulesetInfo;
 
             // Difficulty can only be computed if the beatmap and ruleset are locally available.
-            if (localBeatmapInfo?.IsManaged != true || localRulesetInfo == null)
+            if (localBeatmapInfo?.Ruleset == null || localRulesetInfo == null)
             {
                 // If not, fall back to the existing star difficulty (e.g. from an online source).
                 return Task.FromResult<StarDifficulty?>(new StarDifficulty(beatmapInfo.StarRating, (beatmapInfo as IBeatmapOnlineInfo)?.MaxCombo ?? 0));

From 13401a884667779bfb9da2b37e12163a551b6179 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 8 Jan 2022 00:39:39 +0900
Subject: [PATCH 2069/5547] Better handle Statistics to avoid losing data

---
 osu.Game/Scoring/ScoreInfo.cs | 17 +++++++++--------
 1 file changed, 9 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Scoring/ScoreInfo.cs b/osu.Game/Scoring/ScoreInfo.cs
index 65c31951b8..6a9805ba6a 100644
--- a/osu.Game/Scoring/ScoreInfo.cs
+++ b/osu.Game/Scoring/ScoreInfo.cs
@@ -83,21 +83,22 @@ namespace osu.Game.Scoring
 
         public RulesetInfo Ruleset { get; set; } = null!;
 
+        private Dictionary<HitResult, int>? statistics;
+
         [Ignored]
         public Dictionary<HitResult, int> Statistics
         {
-            // TODO: this is dangerous. a get operation may then modify the dictionary, which would be a fresh copy that is not persisted with the model.
-            // this is already the case in multiple locations.
             get
             {
-                if (string.IsNullOrEmpty(StatisticsJson))
-                    return new Dictionary<HitResult, int>();
+                if (statistics != null)
+                    return statistics;
 
-                return JsonConvert.DeserializeObject<Dictionary<HitResult, int>>(StatisticsJson) ?? new Dictionary<HitResult, int>();
+                if (!string.IsNullOrEmpty(StatisticsJson))
+                    statistics = JsonConvert.DeserializeObject<Dictionary<HitResult, int>>(StatisticsJson);
+
+                return statistics ??= new Dictionary<HitResult, int>();
             }
-            // .. todo
-            // ReSharper disable once ValueParameterNotUsed
-            set => JsonConvert.SerializeObject(StatisticsJson);
+            set => statistics = value;
         }
 
         [MapTo("Statistics")]

From e74a5022c99eb377e6c5010f3d7c7c0385a28c7a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 8 Jan 2022 00:40:14 +0900
Subject: [PATCH 2070/5547] Fix multiple tests via null checks and changing
 `ToLive` to `Detach` flow

---
 osu.Game.Tests/Scores/IO/ImportScoreTest.cs          |  5 +++--
 .../Skins/TestSceneBeatmapSkinResources.cs           |  2 +-
 .../Visual/Navigation/TestScenePresentBeatmap.cs     |  7 +++----
 .../Visual/SongSelect/TestSceneBeatmapCarousel.cs    |  2 +-
 osu.Game/Beatmaps/BeatmapManager.cs                  |  1 +
 osu.Game/OsuGame.cs                                  |  4 ++--
 osu.Game/Scoring/ScoreManager.cs                     |  4 ++--
 osu.Game/Scoring/ScoreModelManager.cs                |  4 ++++
 osu.Game/Screens/Select/BeatmapCarousel.cs           |  2 +-
 osu.Game/Stores/BeatmapImporter.cs                   |  7 +++++++
 .../Visual/Multiplayer/TestMultiplayerClient.cs      | 12 ++++++------
 11 files changed, 31 insertions(+), 19 deletions(-)

diff --git a/osu.Game.Tests/Scores/IO/ImportScoreTest.cs b/osu.Game.Tests/Scores/IO/ImportScoreTest.cs
index 3e6a877a35..fc7f3229df 100644
--- a/osu.Game.Tests/Scores/IO/ImportScoreTest.cs
+++ b/osu.Game.Tests/Scores/IO/ImportScoreTest.cs
@@ -10,6 +10,7 @@ using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Platform;
 using osu.Game.Beatmaps;
+using osu.Game.Database;
 using osu.Game.IO.Archives;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets.Mods;
@@ -142,7 +143,7 @@ namespace osu.Game.Tests.Scores.IO
                     var scoreManager = osu.Dependencies.Get<ScoreManager>();
 
                     beatmapManager.Delete(beatmapManager.QueryBeatmapSet(s => s.Beatmaps.Any(b => b.ID == imported.BeatmapInfo.ID))!.Value);
-                    Assert.That(scoreManager.Query(s => s.Equals(imported)).Value.DeletePending, Is.EqualTo(true));
+                    Assert.That(scoreManager.Query(s => s.Equals(imported)).DeletePending, Is.EqualTo(true));
 
                     var secondImport = await LoadScoreIntoOsu(osu, imported);
                     Assert.That(secondImport, Is.Null);
@@ -187,7 +188,7 @@ namespace osu.Game.Tests.Scores.IO
             var scoreManager = osu.Dependencies.Get<ScoreManager>();
             await scoreManager.Import(score, archive);
 
-            return scoreManager.Query(_ => true).Value;
+            return scoreManager.Query(_ => true).Detach();
         }
 
         internal class TestArchiveReader : ArchiveReader
diff --git a/osu.Game.Tests/Skins/TestSceneBeatmapSkinResources.cs b/osu.Game.Tests/Skins/TestSceneBeatmapSkinResources.cs
index c20ab84a68..98732bfb58 100644
--- a/osu.Game.Tests/Skins/TestSceneBeatmapSkinResources.cs
+++ b/osu.Game.Tests/Skins/TestSceneBeatmapSkinResources.cs
@@ -26,7 +26,7 @@ namespace osu.Game.Tests.Skins
         private void load()
         {
             var imported = beatmaps.Import(new ZipArchiveReader(TestResources.OpenResource("Archives/ogg-beatmap.osz"))).GetResultSafely();
-            beatmap = beatmaps.GetWorkingBeatmap(imported.Value.Beatmaps[0]);
+            beatmap = beatmaps.GetWorkingBeatmap(imported?.Value.Beatmaps[0]);
             beatmap.LoadTrack();
         }
 
diff --git a/osu.Game.Tests/Visual/Navigation/TestScenePresentBeatmap.cs b/osu.Game.Tests/Visual/Navigation/TestScenePresentBeatmap.cs
index 81aacf61cd..69b30ec6a0 100644
--- a/osu.Game.Tests/Visual/Navigation/TestScenePresentBeatmap.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestScenePresentBeatmap.cs
@@ -97,7 +97,6 @@ namespace osu.Game.Tests.Visual.Navigation
             BeatmapSetInfo imported = null;
             AddStep($"import beatmap {i}", () =>
             {
-                var difficulty = new BeatmapDifficulty();
                 var metadata = new BeatmapMetadata
                 {
                     Artist = "SomeArtist",
@@ -115,18 +114,18 @@ namespace osu.Game.Tests.Visual.Navigation
                         {
                             OnlineID = i * 1024,
                             Metadata = metadata,
-                            BaseDifficulty = difficulty,
+                            BaseDifficulty = new BeatmapDifficulty(),
                             Ruleset = ruleset ?? new OsuRuleset().RulesetInfo
                         },
                         new BeatmapInfo
                         {
                             OnlineID = i * 2048,
                             Metadata = metadata,
-                            BaseDifficulty = difficulty,
+                            BaseDifficulty = new BeatmapDifficulty(),
                             Ruleset = ruleset ?? new OsuRuleset().RulesetInfo
                         },
                     }
-                }).GetResultSafely().Value;
+                }).GetResultSafely()?.Value;
             });
 
             AddAssert($"import {i} succeeded", () => imported != null);
diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs
index b1414d5896..cbcfc07202 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs
@@ -76,7 +76,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                 {
                     AddStep("store selection", () => selection = carousel.SelectedBeatmapInfo);
                     if (isIterating)
-                        AddUntilStep("selection changed", () => !carousel.SelectedBeatmapInfo.Equals(selection));
+                        AddUntilStep("selection changed", () => !carousel.SelectedBeatmapInfo?.Equals(selection) == true);
                     else
                         AddUntilStep("selection not changed", () => carousel.SelectedBeatmapInfo.Equals(selection));
                 }
diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index 2479390700..4f6b74ba0a 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -200,6 +200,7 @@ namespace osu.Game.Beatmaps
         /// <param name="query">The query.</param>
         /// <returns>The first result for the provided query, or null if no results were found.</returns>
         public BeatmapInfo? QueryBeatmap(Expression<Func<BeatmapInfo, bool>> query) => beatmapModelManager.QueryBeatmap(query)?.Detach();
+        // TODO: move detach to usages?
 
         /// <summary>
         /// Saves an <see cref="IBeatmap"/> file against a given <see cref="BeatmapInfo"/>.
diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index 149de9bc76..b9e0aac6ef 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -491,10 +491,10 @@ namespace osu.Game
             ScoreInfo databasedScoreInfo = null;
 
             if (score.OnlineID > 0)
-                databasedScoreInfo = ScoreManager.Query(s => s.OnlineID == score.OnlineID)?.Value;
+                databasedScoreInfo = ScoreManager.Query(s => s.OnlineID == score.OnlineID);
 
             if (score is ScoreInfo scoreInfo)
-                databasedScoreInfo ??= ScoreManager.Query(s => s.Hash == scoreInfo.Hash)?.Value;
+                databasedScoreInfo ??= ScoreManager.Query(s => s.Hash == scoreInfo.Hash);
 
             if (databasedScoreInfo == null)
             {
diff --git a/osu.Game/Scoring/ScoreManager.cs b/osu.Game/Scoring/ScoreManager.cs
index 159c3c2da0..62e61d3a94 100644
--- a/osu.Game/Scoring/ScoreManager.cs
+++ b/osu.Game/Scoring/ScoreManager.cs
@@ -49,10 +49,10 @@ 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 ILive<ScoreInfo> Query(Expression<Func<ScoreInfo, bool>> query)
+        public ScoreInfo Query(Expression<Func<ScoreInfo, bool>> query)
         {
             using (var context = contextFactory.CreateContext())
-                return context.All<ScoreInfo>().FirstOrDefault(query)?.ToLive(contextFactory);
+                return context.All<ScoreInfo>().FirstOrDefault(query)?.Detach();
         }
 
         /// <summary>
diff --git a/osu.Game/Scoring/ScoreModelManager.cs b/osu.Game/Scoring/ScoreModelManager.cs
index 8f04e50f63..27b02fc2f0 100644
--- a/osu.Game/Scoring/ScoreModelManager.cs
+++ b/osu.Game/Scoring/ScoreModelManager.cs
@@ -6,6 +6,7 @@ using System.Collections.Generic;
 using System.Linq;
 using System.Threading;
 using System.Threading.Tasks;
+using Newtonsoft.Json;
 using osu.Framework.Logging;
 using osu.Framework.Platform;
 using osu.Game.Beatmaps;
@@ -63,6 +64,9 @@ namespace osu.Game.Scoring
             if (!model.Ruleset.IsManaged)
                 model.Ruleset = realm.Find<RulesetInfo>(model.Ruleset.ShortName);
 
+            if (string.IsNullOrEmpty(model.StatisticsJson))
+                model.StatisticsJson = JsonConvert.SerializeObject(model.Statistics);
+
             return Task.CompletedTask;
         }
     }
diff --git a/osu.Game/Screens/Select/BeatmapCarousel.cs b/osu.Game/Screens/Select/BeatmapCarousel.cs
index 226d2df619..ffb5c6a2a5 100644
--- a/osu.Game/Screens/Select/BeatmapCarousel.cs
+++ b/osu.Game/Screens/Select/BeatmapCarousel.cs
@@ -111,7 +111,7 @@ namespace osu.Game.Screens.Select
             newRoot.AddChildren(beatmapSets.Select(createCarouselSet).Where(g => g != null));
 
             root = newRoot;
-            if (selectedBeatmapSet != null && !beatmapSets.Contains(selectedBeatmapSet.BeatmapSet))
+            if (selectedBeatmapSet != null && (!selectedBeatmapSet.BeatmapSet.IsManaged || !beatmapSets.Contains(selectedBeatmapSet.BeatmapSet)))
                 selectedBeatmapSet = null;
 
             Scroll.Clear(false);
diff --git a/osu.Game/Stores/BeatmapImporter.cs b/osu.Game/Stores/BeatmapImporter.cs
index 2c73bd22eb..e0eee84456 100644
--- a/osu.Game/Stores/BeatmapImporter.cs
+++ b/osu.Game/Stores/BeatmapImporter.cs
@@ -59,8 +59,15 @@ namespace osu.Game.Stores
                 beatmapSet.Beatmaps.AddRange(createBeatmapDifficulties(beatmapSet.Files, realm));
 
             foreach (BeatmapInfo b in beatmapSet.Beatmaps)
+            {
                 b.BeatmapSet = beatmapSet;
 
+                // ensure we aren't trying to add a new ruleset to the database
+                // this can happen in tests, mostly
+                if (!b.Ruleset.IsManaged)
+                    b.Ruleset = realm.Find<RulesetInfo>(b.Ruleset.ShortName);
+            }
+
             validateOnlineIds(beatmapSet, realm);
 
             bool hadOnlineIDs = beatmapSet.Beatmaps.Any(b => b.OnlineID > 0);
diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
index 76acac3f8b..15ede6cc26 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
@@ -409,18 +409,18 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
         public override Task<APIBeatmap> GetAPIBeatmap(int beatmapId, CancellationToken cancellationToken = default)
         {
-            IBeatmapSetInfo? set = roomManager.ServerSideRooms.SelectMany(r => r.Playlist)
-                                              .FirstOrDefault(p => p.BeatmapID == beatmapId)?.Beatmap.Value.BeatmapSet
-                                   ?? beatmaps.QueryBeatmap(b => b.OnlineID == beatmapId)?.BeatmapSet;
+            IBeatmapInfo? beatmap = roomManager.ServerSideRooms.SelectMany(r => r.Playlist)
+                                               .FirstOrDefault(p => p.BeatmapID == beatmapId)?.Beatmap.Value
+                                    ?? beatmaps.QueryBeatmap(b => b.OnlineID == beatmapId);
 
-            if (set == null)
+            if (beatmap == null)
                 throw new InvalidOperationException("Beatmap not found.");
 
             return Task.FromResult(new APIBeatmap
             {
-                BeatmapSet = new APIBeatmapSet { OnlineID = set.OnlineID },
+                BeatmapSet = new APIBeatmapSet { OnlineID = beatmap.BeatmapSet?.OnlineID ?? -1 },
                 OnlineID = beatmapId,
-                Checksum = set.Beatmaps.First(b => b.OnlineID == beatmapId).MD5Hash
+                Checksum = beatmap.MD5Hash
             });
         }
 

From b619ff126434b0e37356b8608afb82b5cc5a478a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 8 Jan 2022 14:03:04 +0900
Subject: [PATCH 2071/5547] Reattach detached items on delete/undelete

---
 osu.Game/Stores/RealmArchiveModelManager.cs | 26 +++++++++++++++------
 1 file changed, 19 insertions(+), 7 deletions(-)

diff --git a/osu.Game/Stores/RealmArchiveModelManager.cs b/osu.Game/Stores/RealmArchiveModelManager.cs
index 8698799b4a..c53348fd92 100644
--- a/osu.Game/Stores/RealmArchiveModelManager.cs
+++ b/osu.Game/Stores/RealmArchiveModelManager.cs
@@ -156,19 +156,31 @@ namespace osu.Game.Stores
 
         public bool Delete(TModel item)
         {
-            if (item.DeletePending)
-                return false;
+            using (var realm = ContextFactory.CreateContext())
+            {
+                if (!item.IsManaged)
+                    item = realm.Find<TModel>(item.ID);
 
-            item.Realm.Write(r => item.DeletePending = true);
-            return true;
+                if (item?.DeletePending != false)
+                    return false;
+
+                realm.Write(r => item.DeletePending = true);
+                return true;
+            }
         }
 
         public void Undelete(TModel item)
         {
-            if (!item.DeletePending)
-                return;
+            using (var realm = ContextFactory.CreateContext())
+            {
+                if (!item.IsManaged)
+                    item = realm.Find<TModel>(item.ID);
 
-            item.Realm.Write(r => item.DeletePending = false);
+                if (item?.DeletePending != true)
+                    return;
+
+                realm.Write(r => item.DeletePending = false);
+            }
         }
 
         // TODO: delete or abstract

From a3c70ccdfc15b02e4db479ae06857d2be3133e8a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 8 Jan 2022 14:03:23 +0900
Subject: [PATCH 2072/5547] Fix OnlineAvailabilityTracker referencing a value
 in query that could potentially be null

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

diff --git a/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs b/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs
index d344846e5f..1832c116bc 100644
--- a/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs
+++ b/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs
@@ -86,7 +86,7 @@ namespace osu.Game.Online.Rooms
                 realmSubscription?.Dispose();
                 realmSubscription = realmContextFactory.Context
                                                        .All<BeatmapSetInfo>()
-                                                       .Where(s => s.OnlineID == SelectedItem.Value.BeatmapID) // TODO: figure out if we need this hash match in the subscription || s.ID == matchingHash?.ID)
+                                                       .Where(s => s.OnlineID == item.NewValue.BeatmapID) // TODO: figure out if we need this hash match in the subscription || s.ID == matchingHash?.ID)
                                                        .QueryAsyncWithNotifications((items, changes, ___) =>
                                                        {
                                                            if (changes == null)

From ba4ef0926fa21ebce350cc5689772be459d0584f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 8 Jan 2022 15:26:44 +0900
Subject: [PATCH 2073/5547] Remove incorrect test fixture specification

---
 osu.Game.Tests/Beatmaps/IO/BeatmapImportHelper.cs | 1 -
 1 file changed, 1 deletion(-)

diff --git a/osu.Game.Tests/Beatmaps/IO/BeatmapImportHelper.cs b/osu.Game.Tests/Beatmaps/IO/BeatmapImportHelper.cs
index 8e67ecd818..44f6943871 100644
--- a/osu.Game.Tests/Beatmaps/IO/BeatmapImportHelper.cs
+++ b/osu.Game.Tests/Beatmaps/IO/BeatmapImportHelper.cs
@@ -15,7 +15,6 @@ using osu.Game.Tests.Resources;
 
 namespace osu.Game.Tests.Beatmaps.IO
 {
-    [TestFixture]
     public static class BeatmapImportHelper
     {
         public static async Task<BeatmapSetInfo> LoadQuickOszIntoOsu(OsuGameBase osu)

From f2f1adb792c8931b30298b62199c3e439b8b5128 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 10 Jan 2022 12:28:09 +0900
Subject: [PATCH 2074/5547] Update `FilterMatchingTest` and filter code to use
 ruleset's `OnlineID`

---
 osu.Game.Tests/NonVisual/Filtering/FilterMatchingTest.cs | 1 -
 1 file changed, 1 deletion(-)

diff --git a/osu.Game.Tests/NonVisual/Filtering/FilterMatchingTest.cs b/osu.Game.Tests/NonVisual/Filtering/FilterMatchingTest.cs
index 8ba3d1a6c7..3d78043c73 100644
--- a/osu.Game.Tests/NonVisual/Filtering/FilterMatchingTest.cs
+++ b/osu.Game.Tests/NonVisual/Filtering/FilterMatchingTest.cs
@@ -17,7 +17,6 @@ namespace osu.Game.Tests.NonVisual.Filtering
         private BeatmapInfo getExampleBeatmap() => new BeatmapInfo
         {
             Ruleset = new RulesetInfo { OnlineID = 0 },
-            RulesetID = 0,
             StarRating = 4.0d,
             BaseDifficulty = new BeatmapDifficulty
             {

From e5af673b01866d6b197bb71817ef2eb1234d8af1 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 10 Jan 2022 12:36:11 +0900
Subject: [PATCH 2075/5547] Fix incorrect `BeatmapInfo.ToString` implementation

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

diff --git a/osu.Game/Beatmaps/BeatmapInfo.cs b/osu.Game/Beatmaps/BeatmapInfo.cs
index 153f40e39d..8bfcd947ac 100644
--- a/osu.Game/Beatmaps/BeatmapInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapInfo.cs
@@ -184,7 +184,7 @@ namespace osu.Game.Beatmaps
 
         public BeatmapInfo Clone() => this.Detach();
 
-        public override string ToString() => Metadata?.ToString() ?? base.ToString();
+        public override string ToString() => this.GetDisplayTitle();
 
         #endregion
     }

From 7e7784b78a616d5128f9e03e03e8c7473d74e155 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 10 Jan 2022 12:39:49 +0900
Subject: [PATCH 2076/5547] Fix incorrect access to `ILive` in
 `BeatmapSkinResources` tests

---
 osu.Game.Tests/Skins/TestSceneBeatmapSkinResources.cs | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Skins/TestSceneBeatmapSkinResources.cs b/osu.Game.Tests/Skins/TestSceneBeatmapSkinResources.cs
index 98732bfb58..fe0423dcfc 100644
--- a/osu.Game.Tests/Skins/TestSceneBeatmapSkinResources.cs
+++ b/osu.Game.Tests/Skins/TestSceneBeatmapSkinResources.cs
@@ -26,8 +26,12 @@ namespace osu.Game.Tests.Skins
         private void load()
         {
             var imported = beatmaps.Import(new ZipArchiveReader(TestResources.OpenResource("Archives/ogg-beatmap.osz"))).GetResultSafely();
-            beatmap = beatmaps.GetWorkingBeatmap(imported?.Value.Beatmaps[0]);
-            beatmap.LoadTrack();
+
+            imported?.PerformRead(s =>
+            {
+                beatmap = beatmaps.GetWorkingBeatmap(s.Beatmaps[0]);
+                beatmap.LoadTrack();
+            });
         }
 
         [Test]

From 62517137961b606739e46477bce55393105b1d1d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 10 Jan 2022 12:56:25 +0900
Subject: [PATCH 2077/5547] Add missing `Ruleset` in `ReplayRecorder` tests

---
 osu.Game.Tests/Visual/Gameplay/TestSceneReplayRecorder.cs | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneReplayRecorder.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneReplayRecorder.cs
index e6361a15d7..4eab1a21da 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneReplayRecorder.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneReplayRecorder.cs
@@ -64,7 +64,11 @@ namespace osu.Game.Tests.Visual.Gameplay
                                 Recorder = recorder = new TestReplayRecorder(new Score
                                 {
                                     Replay = replay,
-                                    ScoreInfo = { BeatmapInfo = gameplayState.Beatmap.BeatmapInfo }
+                                    ScoreInfo =
+                                    {
+                                        BeatmapInfo = gameplayState.Beatmap.BeatmapInfo,
+                                        Ruleset = new OsuRuleset().RulesetInfo,
+                                    }
                                 })
                                 {
                                     ScreenSpaceToGamefield = pos => recordingManager.ToLocalSpace(pos),

From fa7dddcf3c1e3af3d280a58d751b9c50e2ce3ff7 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 10 Jan 2022 13:03:25 +0900
Subject: [PATCH 2078/5547] Fix `TestScenePresentScore` sharing
 metadata/difficulty across multiple beatmaps

---
 .../Navigation/TestScenePresentScore.cs       | 32 +++++++++++--------
 1 file changed, 18 insertions(+), 14 deletions(-)

diff --git a/osu.Game.Tests/Visual/Navigation/TestScenePresentScore.cs b/osu.Game.Tests/Visual/Navigation/TestScenePresentScore.cs
index dbff5964df..f9649db135 100644
--- a/osu.Game.Tests/Visual/Navigation/TestScenePresentScore.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestScenePresentScore.cs
@@ -8,6 +8,7 @@ using osu.Framework.Extensions;
 using osu.Framework.Screens;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
+using osu.Game.Online.API;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Mania;
 using osu.Game.Rulesets.Osu;
@@ -28,14 +29,6 @@ namespace osu.Game.Tests.Visual.Navigation
         {
             AddStep("import beatmap", () =>
             {
-                var difficulty = new BeatmapDifficulty();
-                var metadata = new BeatmapMetadata
-                {
-                    Artist = "SomeArtist",
-                    AuthorString = "SomeAuthor",
-                    Title = "import"
-                };
-
                 beatmap = Game.BeatmapManager.Import(new BeatmapSetInfo
                 {
                     Hash = Guid.NewGuid().ToString(),
@@ -45,19 +38,29 @@ namespace osu.Game.Tests.Visual.Navigation
                         new BeatmapInfo
                         {
                             OnlineID = 1 * 1024,
-                            Metadata = metadata,
-                            BaseDifficulty = difficulty,
+                            Metadata = new BeatmapMetadata
+                            {
+                                Artist = "SomeArtist",
+                                AuthorString = "SomeAuthor",
+                                Title = "import"
+                            },
+                            BaseDifficulty = new BeatmapDifficulty(),
                             Ruleset = new OsuRuleset().RulesetInfo
                         },
                         new BeatmapInfo
                         {
                             OnlineID = 1 * 2048,
-                            Metadata = metadata,
-                            BaseDifficulty = difficulty,
+                            Metadata = new BeatmapMetadata
+                            {
+                                Artist = "SomeArtist",
+                                AuthorString = "SomeAuthor",
+                                Title = "import"
+                            },
+                            BaseDifficulty = new BeatmapDifficulty(),
                             Ruleset = new OsuRuleset().RulesetInfo
                         },
                     }
-                }).GetResultSafely().Value;
+                }).GetResultSafely()?.Value;
             });
         }
 
@@ -130,7 +133,8 @@ namespace osu.Game.Tests.Visual.Navigation
                     Hash = Guid.NewGuid().ToString(),
                     OnlineID = i,
                     BeatmapInfo = beatmap.Beatmaps.First(),
-                    Ruleset = ruleset ?? new OsuRuleset().RulesetInfo
+                    Ruleset = ruleset ?? new OsuRuleset().RulesetInfo,
+                    User = new GuestUser(),
                 }).GetResultSafely().Value;
             });
 

From 82259ee0720df42422ee42e21c2bd553d41c9038 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 10 Jan 2022 13:08:44 +0900
Subject: [PATCH 2079/5547] Improve legibility of `RulesetInfo.Equals`

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

diff --git a/osu.Game/Rulesets/RulesetInfo.cs b/osu.Game/Rulesets/RulesetInfo.cs
index 99b4f5915f..5d5cbe6328 100644
--- a/osu.Game/Rulesets/RulesetInfo.cs
+++ b/osu.Game/Rulesets/RulesetInfo.cs
@@ -47,7 +47,11 @@ namespace osu.Game.Rulesets
 
         public bool Available { get; set; }
 
-        public bool Equals(RulesetInfo? other) => other != null && OnlineID == other.OnlineID && Available == other.Available && Name == other.Name && InstantiationInfo == other.InstantiationInfo;
+        public bool Equals(RulesetInfo? other) => other != null
+                                                  && OnlineID == other.OnlineID
+                                                  && Available == other.Available
+                                                  && Name == other.Name
+                                                  && InstantiationInfo == other.InstantiationInfo;
 
         public bool Equals(IRulesetInfo? other) => other is RulesetInfo b && Equals(b);
 

From 5dd0bb12183dd065e01be932aca007e0faf503b4 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 10 Jan 2022 13:08:57 +0900
Subject: [PATCH 2080/5547] Ensure `Score` created by `GameplayState` has a
 valid ruleset

---
 osu.Game/Screens/Play/GameplayState.cs | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Play/GameplayState.cs b/osu.Game/Screens/Play/GameplayState.cs
index 44f72022f7..83881f739d 100644
--- a/osu.Game/Screens/Play/GameplayState.cs
+++ b/osu.Game/Screens/Play/GameplayState.cs
@@ -50,7 +50,13 @@ namespace osu.Game.Screens.Play
         {
             Beatmap = beatmap;
             Ruleset = ruleset;
-            Score = score ?? new Score();
+            Score = score ?? new Score
+            {
+                ScoreInfo =
+                {
+                    Ruleset = ruleset.RulesetInfo
+                }
+            };
             Mods = mods ?? ArraySegment<Mod>.Empty;
         }
 

From c831e9107a09472bce2f6f5e90b63901fd107df5 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 10 Jan 2022 13:16:39 +0900
Subject: [PATCH 2081/5547] Fix `BeatmapInfo.Clone` potentially not cloning if
 already detached

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

diff --git a/osu.Game/Beatmaps/BeatmapInfo.cs b/osu.Game/Beatmaps/BeatmapInfo.cs
index 8bfcd947ac..cea5f4531d 100644
--- a/osu.Game/Beatmaps/BeatmapInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapInfo.cs
@@ -182,7 +182,7 @@ namespace osu.Game.Beatmaps
 
         public int BeatmapVersion;
 
-        public BeatmapInfo Clone() => this.Detach();
+        public BeatmapInfo Clone() => (BeatmapInfo)this.Detach().MemberwiseClone();
 
         public override string ToString() => this.GetDisplayTitle();
 

From 83ccbc1d132aff271899922e2c69d80be97d24ec Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 10 Jan 2022 13:25:23 +0900
Subject: [PATCH 2082/5547] Mention safety failures of Beatmap/Score
 constructors

---
 osu.Game/Beatmaps/BeatmapInfo.cs |  2 +-
 osu.Game/Scoring/ScoreInfo.cs    | 13 +++++++++++++
 2 files changed, 14 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Beatmaps/BeatmapInfo.cs b/osu.Game/Beatmaps/BeatmapInfo.cs
index cea5f4531d..32eff68d5c 100644
--- a/osu.Game/Beatmaps/BeatmapInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapInfo.cs
@@ -74,7 +74,7 @@ namespace osu.Game.Beatmaps
         }
 
         [UsedImplicitly]
-        public BeatmapInfo()
+        public BeatmapInfo() // TODO: this bypasses null safeties. needs to be hidden from user api (only should be used by realm).
         {
         }
 
diff --git a/osu.Game/Scoring/ScoreInfo.cs b/osu.Game/Scoring/ScoreInfo.cs
index 6a9805ba6a..cb81901d0a 100644
--- a/osu.Game/Scoring/ScoreInfo.cs
+++ b/osu.Game/Scoring/ScoreInfo.cs
@@ -4,6 +4,7 @@
 using System;
 using System.Collections.Generic;
 using System.Linq;
+using JetBrains.Annotations;
 using Newtonsoft.Json;
 using osu.Framework.Localisation;
 using osu.Framework.Testing;
@@ -44,6 +45,18 @@ namespace osu.Game.Scoring
         [MapTo("User")]
         public RealmUser RealmUser { get; set; } = null!;
 
+        public ScoreInfo(BeatmapInfo beatmap, RulesetInfo ruleset, RealmUser user)
+        {
+            Ruleset = ruleset;
+            Beatmap = beatmap;
+            RealmUser = user;
+        }
+
+        [UsedImplicitly]
+        public ScoreInfo() // TODO: this bypasses null safeties. needs to be hidden from user api (only should be used by realm).
+        {
+        }
+
         // TODO: this is a bit temporary to account for the fact that this class is used to ferry API user data to certain UI components.
         // Eventually we should either persist enough information to realm to not require the API lookups, or perform the API lookups locally.
         private APIUser? user;

From d19a9a0ba32b6a0cf42455b6abbf227615aeaaf8 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 10 Jan 2022 13:37:53 +0900
Subject: [PATCH 2083/5547] Remove assertion of `ScoreInfo.Combo` being
 database persisted

---
 osu.Game.Tests/Scores/IO/ImportScoreTest.cs | 1 -
 1 file changed, 1 deletion(-)

diff --git a/osu.Game.Tests/Scores/IO/ImportScoreTest.cs b/osu.Game.Tests/Scores/IO/ImportScoreTest.cs
index fc7f3229df..a09acbc8a7 100644
--- a/osu.Game.Tests/Scores/IO/ImportScoreTest.cs
+++ b/osu.Game.Tests/Scores/IO/ImportScoreTest.cs
@@ -50,7 +50,6 @@ namespace osu.Game.Tests.Scores.IO
                     Assert.AreEqual(toImport.TotalScore, imported.TotalScore);
                     Assert.AreEqual(toImport.Accuracy, imported.Accuracy);
                     Assert.AreEqual(toImport.MaxCombo, imported.MaxCombo);
-                    Assert.AreEqual(toImport.Combo, imported.Combo);
                     Assert.AreEqual(toImport.User.Username, imported.User.Username);
                     Assert.AreEqual(toImport.Date, imported.Date);
                     Assert.AreEqual(toImport.OnlineID, imported.OnlineID);

From 463a185605be7dd03488ea3e844f7c1bbaacb5c6 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 10 Jan 2022 13:38:12 +0900
Subject: [PATCH 2084/5547] Fix many instances of `User` being null in score
 import tests

---
 osu.Game.Tests/Scores/IO/ImportScoreTest.cs | 15 +++++++++++++--
 1 file changed, 13 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Scores/IO/ImportScoreTest.cs b/osu.Game.Tests/Scores/IO/ImportScoreTest.cs
index a09acbc8a7..1fa2a363b9 100644
--- a/osu.Game.Tests/Scores/IO/ImportScoreTest.cs
+++ b/osu.Game.Tests/Scores/IO/ImportScoreTest.cs
@@ -72,6 +72,7 @@ namespace osu.Game.Tests.Scores.IO
 
                     var toImport = new ScoreInfo
                     {
+                        User = new APIUser { Username = "Test user" },
                         Mods = new Mod[] { new OsuModHardRock(), new OsuModDoubleTime() },
                     };
 
@@ -98,6 +99,7 @@ namespace osu.Game.Tests.Scores.IO
 
                     var toImport = new ScoreInfo
                     {
+                        User = new APIUser { Username = "Test user" },
                         Statistics = new Dictionary<HitResult, int>
                         {
                             { HitResult.Perfect, 100 },
@@ -128,6 +130,7 @@ namespace osu.Game.Tests.Scores.IO
 
                     var toImport = new ScoreInfo
                     {
+                        User = new APIUser { Username = "Test user" },
                         Hash = Guid.NewGuid().ToString(),
                         Statistics = new Dictionary<HitResult, int>
                         {
@@ -163,12 +166,20 @@ namespace osu.Game.Tests.Scores.IO
                 {
                     var osu = LoadOsuIntoHost(host, true);
 
-                    await LoadScoreIntoOsu(osu, new ScoreInfo { OnlineID = 2 }, new TestArchiveReader());
+                    await LoadScoreIntoOsu(osu, new ScoreInfo
+                    {
+                        User = new APIUser { Username = "Test user" },
+                        OnlineID = 2
+                    }, new TestArchiveReader());
 
                     var scoreManager = osu.Dependencies.Get<ScoreManager>();
 
                     // Note: A new score reference is used here since the import process mutates the original object to set an ID
-                    Assert.That(scoreManager.IsAvailableLocally(new ScoreInfo { OnlineID = 2 }));
+                    Assert.That(scoreManager.IsAvailableLocally(new ScoreInfo
+                    {
+                        User = new APIUser { Username = "Test user" },
+                        OnlineID = 2
+                    }));
                 }
                 finally
                 {

From 33b5fa347375e3285e2b9752aeae685e9ee98a50 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 10 Jan 2022 13:38:23 +0900
Subject: [PATCH 2085/5547] Detach score during import tests to ensure original
 object doesn't get managed

---
 osu.Game.Tests/Scores/IO/ImportScoreTest.cs | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/osu.Game.Tests/Scores/IO/ImportScoreTest.cs b/osu.Game.Tests/Scores/IO/ImportScoreTest.cs
index 1fa2a363b9..e14159da8e 100644
--- a/osu.Game.Tests/Scores/IO/ImportScoreTest.cs
+++ b/osu.Game.Tests/Scores/IO/ImportScoreTest.cs
@@ -192,6 +192,8 @@ namespace osu.Game.Tests.Scores.IO
         {
             var beatmapManager = osu.Dependencies.Get<BeatmapManager>();
 
+            // clone to avoid attaching the input score to realm.
+            score = score.DeepClone();
             score.BeatmapInfo ??= beatmapManager.GetAllUsableBeatmapSets().First().Beatmaps.First();
             score.Ruleset ??= new OsuRuleset().RulesetInfo;
 

From c8641389afc681a65b2c1e93e0baf1b1538579b4 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 12 Jan 2022 11:08:12 +0300
Subject: [PATCH 2086/5547] Update macOS minimum supported version in line with
 .NET 5

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index f18c5e76f9..b1dfcab416 100644
--- a/README.md
+++ b/README.md
@@ -31,7 +31,7 @@ If you are looking to install or test osu! without setting up a development envi
 
 **Latest build:**
 
-| [Windows 8.1+ (x64)](https://github.com/ppy/osu/releases/latest/download/install.exe) | [macOS 10.12+](https://github.com/ppy/osu/releases/latest/download/osu.app.zip) | [Linux (x64)](https://github.com/ppy/osu/releases/latest/download/osu.AppImage) | [iOS 10+](https://osu.ppy.sh/home/testflight) | [Android 5+](https://github.com/ppy/osu/releases/latest/download/sh.ppy.osulazer.apk)
+| [Windows 8.1+ (x64)](https://github.com/ppy/osu/releases/latest/download/install.exe) | [macOS 10.15+](https://github.com/ppy/osu/releases/latest/download/osu.app.zip) | [Linux (x64)](https://github.com/ppy/osu/releases/latest/download/osu.AppImage) | [iOS 10+](https://osu.ppy.sh/home/testflight) | [Android 5+](https://github.com/ppy/osu/releases/latest/download/sh.ppy.osulazer.apk)
 | ------------- | ------------- | ------------- | ------------- | ------------- |
 
 - The iOS testflight link may fill up (Apple has a hard limit of 10,000 users). We reset it occasionally when this happens. Please do not ask about this. Check back regularly for link resets or follow [peppy](https://twitter.com/ppy) on twitter for announcements of link resets.

From ba62d2c756168940154faa9c7a2beb68ba7ac98f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 10 Jan 2022 13:38:37 +0900
Subject: [PATCH 2087/5547] Fix `ScoreInfo` oversights causing automapper to
 fail

Parameter in ctor *has* to be named `realmUser` else automapper will try
to map to the `User` property.
---
 osu.Game/Scoring/ScoreInfo.cs | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Scoring/ScoreInfo.cs b/osu.Game/Scoring/ScoreInfo.cs
index cb81901d0a..28a6d67b6a 100644
--- a/osu.Game/Scoring/ScoreInfo.cs
+++ b/osu.Game/Scoring/ScoreInfo.cs
@@ -4,6 +4,7 @@
 using System;
 using System.Collections.Generic;
 using System.Linq;
+using AutoMapper;
 using JetBrains.Annotations;
 using Newtonsoft.Json;
 using osu.Framework.Localisation;
@@ -45,11 +46,11 @@ namespace osu.Game.Scoring
         [MapTo("User")]
         public RealmUser RealmUser { get; set; } = null!;
 
-        public ScoreInfo(BeatmapInfo beatmap, RulesetInfo ruleset, RealmUser user)
+        public ScoreInfo(BeatmapInfo beatmap, RulesetInfo ruleset, RealmUser realmUser)
         {
             Ruleset = ruleset;
             Beatmap = beatmap;
-            RealmUser = user;
+            RealmUser = realmUser;
         }
 
         [UsedImplicitly]
@@ -61,6 +62,7 @@ namespace osu.Game.Scoring
         // Eventually we should either persist enough information to realm to not require the API lookups, or perform the API lookups locally.
         private APIUser? user;
 
+        [IgnoreMap]
         public APIUser User
         {
             get => user ??= new APIUser
@@ -164,7 +166,6 @@ namespace osu.Game.Scoring
         [Ignored]
         public bool Passed { get; set; } = true;
 
-        [Ignored]
         public int Combo { get; set; }
 
         /// <summary>

From 43c7b0d2c8a31df449c1042bf721f8e79c0880e1 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 10 Jan 2022 13:53:38 +0900
Subject: [PATCH 2088/5547] Fix unsupported realm operations in multiple tests

---
 osu.Game.Tests/Scores/IO/ImportScoreTest.cs               | 4 ++--
 .../Visual/SongSelect/TestScenePlaySongSelect.cs          | 8 ++++----
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/osu.Game.Tests/Scores/IO/ImportScoreTest.cs b/osu.Game.Tests/Scores/IO/ImportScoreTest.cs
index e14159da8e..a1d47351dd 100644
--- a/osu.Game.Tests/Scores/IO/ImportScoreTest.cs
+++ b/osu.Game.Tests/Scores/IO/ImportScoreTest.cs
@@ -144,8 +144,8 @@ namespace osu.Game.Tests.Scores.IO
                     var beatmapManager = osu.Dependencies.Get<BeatmapManager>();
                     var scoreManager = osu.Dependencies.Get<ScoreManager>();
 
-                    beatmapManager.Delete(beatmapManager.QueryBeatmapSet(s => s.Beatmaps.Any(b => b.ID == imported.BeatmapInfo.ID))!.Value);
-                    Assert.That(scoreManager.Query(s => s.Equals(imported)).DeletePending, Is.EqualTo(true));
+                    beatmapManager.Delete(beatmapManager.GetAllUsableBeatmapSets().First(s => s.Beatmaps.Any(b => b.ID == imported.BeatmapInfo.ID)));
+                    Assert.That(scoreManager.Query(s => s.ID == imported.ID).DeletePending, Is.EqualTo(true));
 
                     var secondImport = await LoadScoreIntoOsu(osu, imported);
                     Assert.That(secondImport, Is.Null);
diff --git a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
index 7b81f330d0..396bbc3dc5 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
@@ -796,8 +796,8 @@ namespace osu.Game.Tests.Visual.SongSelect
         [Test]
         public void TestChangeRulesetWhilePresentingScore()
         {
-            BeatmapInfo getPresentBeatmap() => manager.QueryBeatmap(b => !b.BeatmapSet.DeletePending && b.RulesetID == 0);
-            BeatmapInfo getSwitchBeatmap() => manager.QueryBeatmap(b => !b.BeatmapSet.DeletePending && b.RulesetID == 1);
+            BeatmapInfo getPresentBeatmap() => manager.GetAllUsableBeatmapSets().Where(s => !s.DeletePending).SelectMany(s => s.Beatmaps).First(b => b.RulesetID == 0);
+            BeatmapInfo getSwitchBeatmap() => manager.GetAllUsableBeatmapSets().Where(s => !s.DeletePending).SelectMany(s => s.Beatmaps).First(b => b.RulesetID == 1);
 
             changeRuleset(0);
 
@@ -828,8 +828,8 @@ namespace osu.Game.Tests.Visual.SongSelect
         [Test]
         public void TestChangeBeatmapWhilePresentingScore()
         {
-            BeatmapInfo getPresentBeatmap() => manager.QueryBeatmap(b => !b.BeatmapSet.DeletePending && b.RulesetID == 0);
-            BeatmapInfo getSwitchBeatmap() => manager.QueryBeatmap(b => !b.BeatmapSet.DeletePending && b.RulesetID == 1);
+            BeatmapInfo getPresentBeatmap() => manager.GetAllUsableBeatmapSets().Where(s => !s.DeletePending).SelectMany(s => s.Beatmaps).First(b => b.RulesetID == 0);
+            BeatmapInfo getSwitchBeatmap() => manager.GetAllUsableBeatmapSets().Where(s => !s.DeletePending).SelectMany(s => s.Beatmaps).First(b => b.RulesetID == 1);
 
             changeRuleset(0);
 

From 47390d7ec32e8d58a4b32985172010ba2a74dad1 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 10 Jan 2022 13:59:33 +0900
Subject: [PATCH 2089/5547] Update handling of ruleset nullability when
 handling a game-wide change

---
 osu.Game/OsuGameBase.cs | 16 ++++++++++++++--
 1 file changed, 14 insertions(+), 2 deletions(-)

diff --git a/osu.Game/OsuGameBase.cs b/osu.Game/OsuGameBase.cs
index ac04be532a..d18ae6d2d8 100644
--- a/osu.Game/OsuGameBase.cs
+++ b/osu.Game/OsuGameBase.cs
@@ -424,9 +424,21 @@ namespace osu.Game
 
         private void onRulesetChanged(ValueChangedEvent<RulesetInfo> r)
         {
-            Ruleset instance;
+            Ruleset instance = null;
 
-            if (r.NewValue?.Available != true || (instance = r.NewValue.CreateInstance()) == null)
+            try
+            {
+                if (r.NewValue?.Available == true)
+                {
+                    instance = r.NewValue.CreateInstance();
+                }
+            }
+            catch (Exception e)
+            {
+                Logger.Error(e, "Ruleset load failed and has been rolled back");
+            }
+
+            if (instance == null)
             {
                 // reject the change if the ruleset is not available.
                 Ruleset.Value = r.OldValue?.Available == true ? r.OldValue : RulesetStore.AvailableRulesets.First();

From d8e75a9de49168249a0bd478043e2f3228d26cc8 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 10 Jan 2022 13:59:46 +0900
Subject: [PATCH 2090/5547] Reimplmeent `IsAvailableLocally` as an `abstract`
 method

---
 osu.Game/Scoring/ScoreModelManager.cs       | 6 ++++++
 osu.Game/Skinning/SkinModelManager.cs       | 2 ++
 osu.Game/Stores/BeatmapImporter.cs          | 6 ++++++
 osu.Game/Stores/RealmArchiveModelManager.cs | 3 +--
 4 files changed, 15 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Scoring/ScoreModelManager.cs b/osu.Game/Scoring/ScoreModelManager.cs
index 27b02fc2f0..1068aba231 100644
--- a/osu.Game/Scoring/ScoreModelManager.cs
+++ b/osu.Game/Scoring/ScoreModelManager.cs
@@ -69,5 +69,11 @@ namespace osu.Game.Scoring
 
             return Task.CompletedTask;
         }
+
+        public override bool IsAvailableLocally(ScoreInfo model)
+        {
+            using (var context = ContextFactory.CreateContext())
+                return context.All<ScoreInfo>().Any(b => b.OnlineID == model.OnlineID);
+        }
     }
 }
diff --git a/osu.Game/Skinning/SkinModelManager.cs b/osu.Game/Skinning/SkinModelManager.cs
index 822cb8efa0..66a1808dc1 100644
--- a/osu.Game/Skinning/SkinModelManager.cs
+++ b/osu.Game/Skinning/SkinModelManager.cs
@@ -262,5 +262,7 @@ namespace osu.Game.Skinning
                 s.Hash = ComputeHash(s);
             });
         }
+
+        public override bool IsAvailableLocally(SkinInfo model) => false;
     }
 }
diff --git a/osu.Game/Stores/BeatmapImporter.cs b/osu.Game/Stores/BeatmapImporter.cs
index e0eee84456..429d3951cf 100644
--- a/osu.Game/Stores/BeatmapImporter.cs
+++ b/osu.Game/Stores/BeatmapImporter.cs
@@ -170,6 +170,12 @@ namespace osu.Game.Stores
             return existing.OnlineID == import.OnlineID && existingIds.SequenceEqual(importIds);
         }
 
+        public override bool IsAvailableLocally(BeatmapSetInfo model)
+        {
+            using (var context = ContextFactory.CreateContext())
+                return context.All<BeatmapInfo>().Any(b => b.OnlineID == model.OnlineID);
+        }
+
         public override string HumanisedModelName => "beatmap";
 
         protected override BeatmapSetInfo? CreateModel(ArchiveReader reader)
diff --git a/osu.Game/Stores/RealmArchiveModelManager.cs b/osu.Game/Stores/RealmArchiveModelManager.cs
index c53348fd92..0b78071d16 100644
--- a/osu.Game/Stores/RealmArchiveModelManager.cs
+++ b/osu.Game/Stores/RealmArchiveModelManager.cs
@@ -183,8 +183,7 @@ namespace osu.Game.Stores
             }
         }
 
-        // TODO: delete or abstract
-        public virtual bool IsAvailableLocally(TModel model) => false; // Not relevant for skins since they can't be downloaded yet.
+        public abstract bool IsAvailableLocally(TModel model);
 
         public void Update(TModel skin)
         {

From af5d3af664a84e20967b80ca6fb1d446261b0730 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 10 Jan 2022 14:08:00 +0900
Subject: [PATCH 2091/5547] Remove test coverage of scores being deleted when
 beatmaps are

This is not supported in realm for now. Probably best suited to a
separate pass, similar to files, using backlink count.
---
 osu.Game.Tests/Scores/IO/ImportScoreTest.cs | 38 ---------------------
 1 file changed, 38 deletions(-)

diff --git a/osu.Game.Tests/Scores/IO/ImportScoreTest.cs b/osu.Game.Tests/Scores/IO/ImportScoreTest.cs
index a1d47351dd..22b792cee4 100644
--- a/osu.Game.Tests/Scores/IO/ImportScoreTest.cs
+++ b/osu.Game.Tests/Scores/IO/ImportScoreTest.cs
@@ -119,44 +119,6 @@ namespace osu.Game.Tests.Scores.IO
             }
         }
 
-        [Test]
-        public async Task TestImportWithDeletedBeatmapSet()
-        {
-            using (HeadlessGameHost host = new CleanRunHeadlessGameHost())
-            {
-                try
-                {
-                    var osu = LoadOsuIntoHost(host, true);
-
-                    var toImport = new ScoreInfo
-                    {
-                        User = new APIUser { Username = "Test user" },
-                        Hash = Guid.NewGuid().ToString(),
-                        Statistics = new Dictionary<HitResult, int>
-                        {
-                            { HitResult.Perfect, 100 },
-                            { HitResult.Miss, 50 }
-                        }
-                    };
-
-                    var imported = await LoadScoreIntoOsu(osu, toImport);
-
-                    var beatmapManager = osu.Dependencies.Get<BeatmapManager>();
-                    var scoreManager = osu.Dependencies.Get<ScoreManager>();
-
-                    beatmapManager.Delete(beatmapManager.GetAllUsableBeatmapSets().First(s => s.Beatmaps.Any(b => b.ID == imported.BeatmapInfo.ID)));
-                    Assert.That(scoreManager.Query(s => s.ID == imported.ID).DeletePending, Is.EqualTo(true));
-
-                    var secondImport = await LoadScoreIntoOsu(osu, imported);
-                    Assert.That(secondImport, Is.Null);
-                }
-                finally
-                {
-                    host.Exit();
-                }
-            }
-        }
-
         [Test]
         public async Task TestOnlineScoreIsAvailableLocally()
         {

From ae8f522c20682cb08ef04d8fdf5fc2e47b135082 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 10 Jan 2022 14:18:34 +0900
Subject: [PATCH 2092/5547] Add support for persisting score's mods to realm

---
 osu.Game/Scoring/ScoreInfo.cs | 21 ++++++++++++++++-----
 1 file changed, 16 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Scoring/ScoreInfo.cs b/osu.Game/Scoring/ScoreInfo.cs
index 28a6d67b6a..eb4a0d21d7 100644
--- a/osu.Game/Scoring/ScoreInfo.cs
+++ b/osu.Game/Scoring/ScoreInfo.cs
@@ -183,6 +183,10 @@ namespace osu.Game.Scoring
         [Ignored]
         public bool IsLegacyScore => Mods.OfType<ModClassic>().Any();
 
+        // Used for database serialisation/deserialisation.
+        [MapTo("Mods")]
+        public string ModsJson { get; set; } = string.Empty;
+
         [Ignored]
         public Mod[] Mods
         {
@@ -203,6 +207,7 @@ namespace osu.Game.Scoring
             {
                 localAPIMods = null;
                 mods = value;
+                ModsJson = JsonConvert.SerializeObject(APIMods);
             }
         }
 
@@ -212,13 +217,18 @@ namespace osu.Game.Scoring
         {
             get
             {
-                if (localAPIMods != null)
-                    return localAPIMods;
+                if (localAPIMods == null)
+                {
+                    // prioritise reading from realm backing
+                    if (!string.IsNullOrEmpty(ModsJson))
+                        localAPIMods = JsonConvert.DeserializeObject<APIMod[]>(ModsJson);
 
-                if (mods == null)
-                    return Array.Empty<APIMod>();
+                    // then check mods set via Mods property.
+                    if (mods != null)
+                        localAPIMods = mods.Select(m => new APIMod(m)).ToArray();
+                }
 
-                return localAPIMods = mods.Select(m => new APIMod(m)).ToArray();
+                return localAPIMods ?? Array.Empty<APIMod>();
             }
             set
             {
@@ -226,6 +236,7 @@ namespace osu.Game.Scoring
 
                 // We potentially can't update this yet due to Ruleset being late-bound, so instead update on read as necessary.
                 mods = null;
+                ModsJson = JsonConvert.SerializeObject(APIMods);
             }
         }
 

From f4a1fa85a12c5267f5443b7c780a153891276277 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 10 Jan 2022 14:36:05 +0900
Subject: [PATCH 2093/5547] Fix incorrect conditional for deciding whether
 scores can be deleted from UI

---
 osu.Game/Online/Leaderboards/LeaderboardScore.cs       | 10 +++++-----
 .../Match/Components/MatchLeaderboardScore.cs          |  4 ++--
 2 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/osu.Game/Online/Leaderboards/LeaderboardScore.cs b/osu.Game/Online/Leaderboards/LeaderboardScore.cs
index 3eb9a02a5c..247a509aa1 100644
--- a/osu.Game/Online/Leaderboards/LeaderboardScore.cs
+++ b/osu.Game/Online/Leaderboards/LeaderboardScore.cs
@@ -46,7 +46,7 @@ namespace osu.Game.Online.Leaderboards
         protected Container RankContainer { get; private set; }
 
         private readonly int? rank;
-        private readonly bool allowHighlight;
+        private readonly bool isOnlineScope;
 
         private Box background;
         private Container content;
@@ -68,12 +68,12 @@ namespace osu.Game.Online.Leaderboards
         [Resolved]
         private Storage storage { get; set; }
 
-        public LeaderboardScore(ScoreInfo score, int? rank, bool allowHighlight = true)
+        public LeaderboardScore(ScoreInfo score, int? rank, bool isOnlineScope = true)
         {
             Score = score;
 
             this.rank = rank;
-            this.allowHighlight = allowHighlight;
+            this.isOnlineScope = isOnlineScope;
 
             RelativeSizeAxes = Axes.X;
             Height = HEIGHT;
@@ -111,7 +111,7 @@ namespace osu.Game.Online.Leaderboards
                                 background = new Box
                                 {
                                     RelativeSizeAxes = Axes.Both,
-                                    Colour = user.OnlineID == api.LocalUser.Value.Id && allowHighlight ? colour.Green : Color4.Black,
+                                    Colour = user.OnlineID == api.LocalUser.Value.Id && isOnlineScope ? colour.Green : Color4.Black,
                                     Alpha = background_alpha,
                                 },
                             },
@@ -399,7 +399,7 @@ namespace osu.Game.Online.Leaderboards
                 if (Score.Files.Count > 0)
                     items.Add(new OsuMenuItem("Export", MenuItemType.Standard, () => new LegacyScoreExporter(storage).Export(Score)));
 
-                if (Score.IsManaged)
+                if (!isOnlineScope)
                     items.Add(new OsuMenuItem("Delete", MenuItemType.Destructive, () => dialogOverlay?.Push(new LocalScoreDeleteDialog(Score))));
 
                 return items.ToArray();
diff --git a/osu.Game/Screens/OnlinePlay/Match/Components/MatchLeaderboardScore.cs b/osu.Game/Screens/OnlinePlay/Match/Components/MatchLeaderboardScore.cs
index e8f5b1e826..799c44cc28 100644
--- a/osu.Game/Screens/OnlinePlay/Match/Components/MatchLeaderboardScore.cs
+++ b/osu.Game/Screens/OnlinePlay/Match/Components/MatchLeaderboardScore.cs
@@ -14,8 +14,8 @@ namespace osu.Game.Screens.OnlinePlay.Match.Components
     {
         private readonly APIUserScoreAggregate score;
 
-        public MatchLeaderboardScore(APIUserScoreAggregate score, int? rank, bool allowHighlight = true)
-            : base(score.CreateScoreInfo(), rank, allowHighlight)
+        public MatchLeaderboardScore(APIUserScoreAggregate score, int? rank, bool isOnlineScope = true)
+            : base(score.CreateScoreInfo(), rank, isOnlineScope)
         {
             this.score = score;
         }

From 8ecfb9172ef5d87703f2ee36bb91a5ac121927ca Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 10 Jan 2022 14:36:21 +0900
Subject: [PATCH 2094/5547] Fix multiple tests with incorrect access to beatmap
 imports

---
 .../Menus/TestSceneMusicActionHandling.cs     |  5 ++-
 .../TestSceneDeleteLocalScore.cs              | 35 +++++++++++--------
 2 files changed, 25 insertions(+), 15 deletions(-)

diff --git a/osu.Game.Tests/Visual/Menus/TestSceneMusicActionHandling.cs b/osu.Game.Tests/Visual/Menus/TestSceneMusicActionHandling.cs
index ee9363fa12..3ebc64cd0b 100644
--- a/osu.Game.Tests/Visual/Menus/TestSceneMusicActionHandling.cs
+++ b/osu.Game.Tests/Visual/Menus/TestSceneMusicActionHandling.cs
@@ -39,7 +39,10 @@ namespace osu.Game.Tests.Visual.Menus
             AddStep("import beatmap with track", () =>
             {
                 var setWithTrack = Game.BeatmapManager.Import(new ImportTask(TestResources.GetTestBeatmapForImport())).GetResultSafely();
-                Beatmap.Value = Game.BeatmapManager.GetWorkingBeatmap(setWithTrack.Value.Beatmaps.First());
+                setWithTrack?.PerformRead(s =>
+                {
+                    Beatmap.Value = Game.BeatmapManager.GetWorkingBeatmap(s.Beatmaps.First());
+                });
             });
 
             AddStep("bind to track change", () =>
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
index 49200f6e1a..17168bf07f 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
@@ -22,6 +22,7 @@ using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Leaderboards;
 using osu.Game.Overlays;
 using osu.Game.Rulesets;
+using osu.Game.Rulesets.Osu;
 using osu.Game.Scoring;
 using osu.Game.Screens.Select.Leaderboards;
 using osu.Game.Tests.Resources;
@@ -90,23 +91,29 @@ namespace osu.Game.Tests.Visual.UserInterface
             dependencies.Cache(beatmapManager = new BeatmapManager(LocalStorage, ContextFactory, rulesetStore, null, dependencies.Get<AudioManager>(), Resources, dependencies.Get<GameHost>(), Beatmap.Default));
             dependencies.Cache(scoreManager = new ScoreManager(dependencies.Get<RulesetStore>(), () => beatmapManager, LocalStorage, dependencies.Get<RealmContextFactory>(), Scheduler));
 
-            beatmapInfo = beatmapManager.Import(new ImportTask(TestResources.GetQuickTestBeatmapForImport())).GetResultSafely().Value.Beatmaps[0];
+            var imported = beatmapManager.Import(new ImportTask(TestResources.GetQuickTestBeatmapForImport())).GetResultSafely();
 
-            for (int i = 0; i < 50; i++)
+            imported?.PerformRead(s =>
             {
-                var score = new ScoreInfo
-                {
-                    OnlineID = i,
-                    BeatmapInfo = beatmapInfo,
-                    Accuracy = RNG.NextDouble(),
-                    TotalScore = RNG.Next(1, 1000000),
-                    MaxCombo = RNG.Next(1, 1000),
-                    Rank = ScoreRank.XH,
-                    User = new APIUser { Username = "TestUser" },
-                };
+                beatmapInfo = s.Beatmaps[0].Detach();
 
-                importedScores.Add(scoreManager.Import(score).GetResultSafely().Value);
-            }
+                for (int i = 0; i < 50; i++)
+                {
+                    var score = new ScoreInfo
+                    {
+                        OnlineID = i,
+                        BeatmapInfo = beatmapInfo,
+                        Accuracy = RNG.NextDouble(),
+                        TotalScore = RNG.Next(1, 1000000),
+                        MaxCombo = RNG.Next(1, 1000),
+                        Rank = ScoreRank.XH,
+                        User = new APIUser { Username = "TestUser" },
+                        Ruleset = new OsuRuleset().RulesetInfo,
+                    };
+
+                    importedScores.Add(scoreManager.Import(score).GetResultSafely().Value);
+                }
+            });
 
             return dependencies;
         }

From a0f8debafe909bb8aa8bbb6ab965d7eaa3b33e4f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 10 Jan 2022 14:40:41 +0900
Subject: [PATCH 2095/5547] Add note about `BeatmapMetadata.Author` being weird

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

diff --git a/osu.Game/Beatmaps/BeatmapMetadata.cs b/osu.Game/Beatmaps/BeatmapMetadata.cs
index f729b55154..6349476550 100644
--- a/osu.Game/Beatmaps/BeatmapMetadata.cs
+++ b/osu.Game/Beatmaps/BeatmapMetadata.cs
@@ -27,7 +27,7 @@ namespace osu.Game.Beatmaps
         [JsonProperty("artist_unicode")]
         public string ArtistUnicode { get; set; } = string.Empty;
 
-        public RealmUser Author { get; set; } = new RealmUser();
+        public RealmUser Author { get; set; } = new RealmUser(); // TODO: not sure we want to initialise this only to have it overwritten by retrieval.
 
         public string Source { get; set; } = string.Empty;
 

From 41d90cd0b5a2f1689d03263f9c44fd64693088ea Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 10 Jan 2022 14:52:59 +0900
Subject: [PATCH 2096/5547] Fix beatmap carousel test failures

---
 .../Visual/SongSelect/TestSceneBeatmapCarousel.cs    |  3 +--
 osu.Game/Screens/Select/BeatmapCarousel.cs           | 12 +++++++++++-
 2 files changed, 12 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs
index cbcfc07202..d7e3951ac2 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs
@@ -698,10 +698,9 @@ namespace osu.Game.Tests.Visual.SongSelect
 
                 for (int i = 1; i <= 15; i++)
                 {
-                    set.Beatmaps.Add(new BeatmapInfo
+                    set.Beatmaps.Add(new BeatmapInfo(new OsuRuleset().RulesetInfo, new BeatmapDifficulty(), new BeatmapMetadata())
                     {
                         DifficultyName = $"Stars: {i}",
-                        Ruleset = new OsuRuleset().RulesetInfo,
                         StarRating = i,
                     });
                 }
diff --git a/osu.Game/Screens/Select/BeatmapCarousel.cs b/osu.Game/Screens/Select/BeatmapCarousel.cs
index ffb5c6a2a5..25f48ae455 100644
--- a/osu.Game/Screens/Select/BeatmapCarousel.cs
+++ b/osu.Game/Screens/Select/BeatmapCarousel.cs
@@ -98,10 +98,16 @@ namespace osu.Game.Screens.Select
         private IEnumerable<CarouselBeatmapSet> beatmapSets => root.Children.OfType<CarouselBeatmapSet>();
 
         // todo: only used for testing, maybe remove.
+        private bool loadedTestBeatmaps;
+
         public IEnumerable<BeatmapSetInfo> BeatmapSets
         {
             get => beatmapSets.Select(g => g.BeatmapSet);
-            set => loadBeatmapSets(value);
+            set
+            {
+                loadedTestBeatmaps = true;
+                loadBeatmapSets(value);
+            }
         }
 
         private void loadBeatmapSets(IEnumerable<BeatmapSetInfo> beatmapSets)
@@ -190,6 +196,10 @@ namespace osu.Game.Screens.Select
 
         private void beatmapSetsChanged(IRealmCollection<BeatmapSetInfo> sender, ChangeSet changes, Exception error)
         {
+            // If loading test beatmaps, avoid overwriting with realm subscription callbacks.
+            if (loadedTestBeatmaps)
+                return;
+
             if (changes == null)
             {
                 // initial load

From 4b690703b3142b1db78c6296d8e60b4598fef294 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 10 Jan 2022 14:59:15 +0900
Subject: [PATCH 2097/5547] Remove unnecessary DI dependencies from cache test

---
 osu.Game.Tests/Visual/Navigation/TestSceneOsuGame.cs | 2 --
 1 file changed, 2 deletions(-)

diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneOsuGame.cs b/osu.Game.Tests/Visual/Navigation/TestSceneOsuGame.cs
index 99904af42d..e17e4a88da 100644
--- a/osu.Game.Tests/Visual/Navigation/TestSceneOsuGame.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneOsuGame.cs
@@ -24,7 +24,6 @@ using osu.Game.Rulesets.Mods;
 using osu.Game.Scoring;
 using osu.Game.Screens.Menu;
 using osu.Game.Skinning;
-using osu.Game.Stores;
 using osu.Game.Utils;
 
 namespace osu.Game.Tests.Visual.Navigation
@@ -69,7 +68,6 @@ namespace osu.Game.Tests.Visual.Navigation
             typeof(ISkinSource),
             typeof(IAPIProvider),
             typeof(RulesetStore),
-            typeof(RealmFileStore),
             typeof(ScoreManager),
             typeof(BeatmapManager),
             typeof(IRulesetConfigCache),

From 02d0ca274189e02a8e6da0eb277cbe860025fba7 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 10 Jan 2022 14:59:25 +0900
Subject: [PATCH 2098/5547] Fix protected beatmaps showing up in the song
 select carousel

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

diff --git a/osu.Game/Screens/Select/BeatmapCarousel.cs b/osu.Game/Screens/Select/BeatmapCarousel.cs
index 25f48ae455..f1ad7db9b5 100644
--- a/osu.Game/Screens/Select/BeatmapCarousel.cs
+++ b/osu.Game/Screens/Select/BeatmapCarousel.cs
@@ -190,7 +190,7 @@ namespace osu.Game.Screens.Select
         {
             base.LoadComplete();
 
-            subscriptionSets = realmFactory.Context.All<BeatmapSetInfo>().Where(s => !s.DeletePending).QueryAsyncWithNotifications(beatmapSetsChanged);
+            subscriptionSets = realmFactory.Context.All<BeatmapSetInfo>().Where(s => !s.DeletePending && !s.Protected).QueryAsyncWithNotifications(beatmapSetsChanged);
             subscriptionBeatmaps = realmFactory.Context.All<BeatmapInfo>().Where(b => !b.Hidden).QueryAsyncWithNotifications(beatmapsChanged);
         }
 

From 605898ec53c217e682450fb32e99a44d94d0aa6f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 10 Jan 2022 15:06:41 +0900
Subject: [PATCH 2099/5547] Add missing "non-null" elements missing from some
 tests

---
 .../Gameplay/TestSceneBeatmapSkinFallbacks.cs |  2 +-
 .../Gameplay/TestSceneSpectatorPlayback.cs    |  9 +++++++-
 .../SongSelect/TestSceneBeatmapLeaderboard.cs | 21 +++++++++++++++++++
 3 files changed, 30 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneBeatmapSkinFallbacks.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneBeatmapSkinFallbacks.cs
index c5f56cae9e..b6a08dd2ab 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneBeatmapSkinFallbacks.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneBeatmapSkinFallbacks.cs
@@ -42,7 +42,7 @@ namespace osu.Game.Tests.Visual.Gameplay
         [Test]
         public void TestEmptyLegacyBeatmapSkinFallsBack()
         {
-            CreateSkinTest(DefaultSkin.CreateInfo(), () => new LegacyBeatmapSkin(new BeatmapInfo(), null, null));
+            CreateSkinTest(DefaultSkin.CreateInfo(), () => new LegacyBeatmapSkin(new BeatmapInfo { Metadata = new BeatmapMetadata() }, null, null));
             AddUntilStep("wait for hud load", () => Player.ChildrenOfType<SkinnableTargetContainer>().All(c => c.ComponentsLoaded));
             AddAssert("hud from default skin", () => AssertComponentsFromExpectedSource(SkinnableTarget.MainHUDComponents, skinManager.CurrentSkin.Value));
         }
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorPlayback.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorPlayback.cs
index f7e9a1fe16..4790bd44db 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorPlayback.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorPlayback.cs
@@ -372,7 +372,14 @@ namespace osu.Game.Tests.Visual.Gameplay
         internal class TestReplayRecorder : ReplayRecorder<TestAction>
         {
             public TestReplayRecorder()
-                : base(new Score { ScoreInfo = { BeatmapInfo = new BeatmapInfo() } })
+                : base(new Score
+                {
+                    ScoreInfo =
+                    {
+                        BeatmapInfo = new BeatmapInfo(),
+                        Ruleset = new OsuRuleset().RulesetInfo,
+                    }
+                })
             {
             }
 
diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
index a5f42545c1..78df4d8d98 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
@@ -17,6 +17,7 @@ using osu.Game.Online.Leaderboards;
 using osu.Game.Overlays;
 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.Select.Leaderboards;
@@ -136,6 +137,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                 MaxCombo = 244,
                 TotalScore = 1707827,
                 Mods = new Mod[] { new OsuModHidden(), new OsuModHardRock() },
+                Ruleset = new OsuRuleset().RulesetInfo,
                 User = new APIUser
                 {
                     Id = 6602580,
@@ -158,6 +160,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                 Accuracy = 1,
                 MaxCombo = 244,
                 TotalScore = 1707827,
+                Ruleset = new OsuRuleset().RulesetInfo,
                 Mods = new Mod[] { new OsuModHidden(), new OsuModHardRock(), },
                 User = new APIUser
                 {
@@ -200,6 +203,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                     MaxCombo = 244,
                     TotalScore = 1707827,
                     //Mods = new Mod[] { new OsuModHidden(), new OsuModHardRock(), },
+                    Ruleset = new OsuRuleset().RulesetInfo,
                     BeatmapInfo = beatmapInfo,
                     User = new APIUser
                     {
@@ -220,6 +224,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                     TotalScore = 1707827,
                     //Mods = new Mod[] { new OsuModHidden(), new OsuModHardRock(), },
                     BeatmapInfo = beatmapInfo,
+                    Ruleset = new OsuRuleset().RulesetInfo,
                     User = new APIUser
                     {
                         Id = 4608074,
@@ -239,6 +244,8 @@ namespace osu.Game.Tests.Visual.SongSelect
                     TotalScore = 1707827,
                     //Mods = new Mod[] { new OsuModHidden(), new OsuModHardRock(), },
                     BeatmapInfo = beatmapInfo,
+                    Ruleset = new OsuRuleset().RulesetInfo,
+
                     User = new APIUser
                     {
                         Id = 1014222,
@@ -258,6 +265,8 @@ namespace osu.Game.Tests.Visual.SongSelect
                     TotalScore = 1707827,
                     //Mods = new Mod[] { new OsuModHidden(), new OsuModHardRock(), },
                     BeatmapInfo = beatmapInfo,
+                    Ruleset = new OsuRuleset().RulesetInfo,
+
                     User = new APIUser
                     {
                         Id = 1541390,
@@ -277,6 +286,8 @@ namespace osu.Game.Tests.Visual.SongSelect
                     TotalScore = 1707827,
                     //Mods = new Mod[] { new OsuModHidden(), new OsuModHardRock(), },
                     BeatmapInfo = beatmapInfo,
+                    Ruleset = new OsuRuleset().RulesetInfo,
+
                     User = new APIUser
                     {
                         Id = 2243452,
@@ -296,6 +307,8 @@ namespace osu.Game.Tests.Visual.SongSelect
                     TotalScore = 1707827,
                     //Mods = new Mod[] { new OsuModHidden(), new OsuModHardRock(), },
                     BeatmapInfo = beatmapInfo,
+                    Ruleset = new OsuRuleset().RulesetInfo,
+
                     User = new APIUser
                     {
                         Id = 2705430,
@@ -315,6 +328,8 @@ namespace osu.Game.Tests.Visual.SongSelect
                     TotalScore = 1707827,
                     //Mods = new Mod[] { new OsuModHidden(), new OsuModHardRock(), },
                     BeatmapInfo = beatmapInfo,
+                    Ruleset = new OsuRuleset().RulesetInfo,
+
                     User = new APIUser
                     {
                         Id = 7151382,
@@ -334,6 +349,8 @@ namespace osu.Game.Tests.Visual.SongSelect
                     TotalScore = 1707827,
                     //Mods = new Mod[] { new OsuModHidden(), new OsuModHardRock(), },
                     BeatmapInfo = beatmapInfo,
+                    Ruleset = new OsuRuleset().RulesetInfo,
+
                     User = new APIUser
                     {
                         Id = 2051389,
@@ -353,6 +370,8 @@ namespace osu.Game.Tests.Visual.SongSelect
                     TotalScore = 1707827,
                     //Mods = new Mod[] { new OsuModHidden(), new OsuModHardRock(), },
                     BeatmapInfo = beatmapInfo,
+                    Ruleset = new OsuRuleset().RulesetInfo,
+
                     User = new APIUser
                     {
                         Id = 6169483,
@@ -372,6 +391,8 @@ namespace osu.Game.Tests.Visual.SongSelect
                     TotalScore = 1707827,
                     //Mods = new Mod[] { new OsuModHidden(), new OsuModHardRock(), },
                     BeatmapInfo = beatmapInfo,
+                    Ruleset = new OsuRuleset().RulesetInfo,
+
                     User = new APIUser
                     {
                         Id = 6702666,

From c33e1631789ff4b04d334a2654279c2b3cdbff0c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 10 Jan 2022 16:31:28 +0900
Subject: [PATCH 2100/5547] Bind ruleset to toolbar later for safety

---
 osu.Game/Overlays/Toolbar/Toolbar.cs | 15 +++++++++++----
 1 file changed, 11 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Overlays/Toolbar/Toolbar.cs b/osu.Game/Overlays/Toolbar/Toolbar.cs
index dc0b06b255..776f7ad7b7 100644
--- a/osu.Game/Overlays/Toolbar/Toolbar.cs
+++ b/osu.Game/Overlays/Toolbar/Toolbar.cs
@@ -58,8 +58,11 @@ namespace osu.Game.Overlays.Toolbar
             AlwaysPresent = false;
         }
 
+        [Resolved]
+        private Bindable<RulesetInfo> ruleset { get; set; }
+
         [BackgroundDependencyLoader(true)]
-        private void load(OsuGame osuGame, Bindable<RulesetInfo> parentRuleset)
+        private void load(OsuGame osuGame)
         {
             Children = new Drawable[]
             {
@@ -106,13 +109,17 @@ namespace osu.Game.Overlays.Toolbar
                 }
             };
 
-            // Bound after the selector is added to the hierarchy to give it a chance to load the available rulesets
-            rulesetSelector.Current.BindTo(parentRuleset);
-
             if (osuGame != null)
                 OverlayActivationMode.BindTo(osuGame.OverlayActivationMode);
         }
 
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            rulesetSelector.Current.BindTo(ruleset);
+        }
+
         public class ToolbarBackground : Container
         {
             private readonly Box gradientBackground;

From 5cbd73186480ac7a9cb19d5c34cf20431dc201a3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 10 Jan 2022 16:31:50 +0900
Subject: [PATCH 2101/5547] Add `RulesetInfo` hashcode implementation and tidy
 up equality

---
 .../TestScenePlayerScoreSubmission.cs         | 10 ++++++++-
 osu.Game/Rulesets/RulesetInfo.cs              | 21 ++++++++++++++-----
 2 files changed, 25 insertions(+), 6 deletions(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestScenePlayerScoreSubmission.cs b/osu.Game.Tests/Visual/Gameplay/TestScenePlayerScoreSubmission.cs
index 9f34931f54..a4a4f351ec 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestScenePlayerScoreSubmission.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestScenePlayerScoreSubmission.cs
@@ -255,7 +255,15 @@ namespace osu.Game.Tests.Visual.Gameplay
         {
             prepareTestAPI(true);
 
-            createPlayerTest(false, createRuleset: () => new OsuRuleset { RulesetInfo = { OnlineID = rulesetId ?? -1 } });
+            createPlayerTest(false, createRuleset: () => new OsuRuleset
+            {
+                RulesetInfo =
+                {
+                    Name = "custom",
+                    ShortName = $"custom{rulesetId}",
+                    OnlineID = rulesetId ?? -1
+                }
+            });
 
             AddUntilStep("wait for token request", () => Player.TokenCreationRequested);
 
diff --git a/osu.Game/Rulesets/RulesetInfo.cs b/osu.Game/Rulesets/RulesetInfo.cs
index 5d5cbe6328..2e2ec5c024 100644
--- a/osu.Game/Rulesets/RulesetInfo.cs
+++ b/osu.Game/Rulesets/RulesetInfo.cs
@@ -47,14 +47,25 @@ namespace osu.Game.Rulesets
 
         public bool Available { get; set; }
 
-        public bool Equals(RulesetInfo? other) => other != null
-                                                  && OnlineID == other.OnlineID
-                                                  && Available == other.Available
-                                                  && Name == other.Name
-                                                  && InstantiationInfo == other.InstantiationInfo;
+        public bool Equals(RulesetInfo? other)
+        {
+            if (ReferenceEquals(this, other)) return true;
+            if (other == null) return false;
+
+            return ShortName == other.ShortName;
+        }
 
         public bool Equals(IRulesetInfo? other) => other is RulesetInfo b && Equals(b);
 
+        public override int GetHashCode()
+        {
+            // Importantly, ignore the underlying realm hash code, as it will usually not match.
+            var hashCode = new HashCode();
+            // ReSharper disable once NonReadonlyMemberInGetHashCode
+            hashCode.Add(ShortName);
+            return hashCode.ToHashCode();
+        }
+
         public override string ToString() => Name;
 
         public RulesetInfo Clone() => new RulesetInfo

From 8e79898e267c9b4870f2e4b8874dfa4834593f53 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 10 Jan 2022 16:34:16 +0900
Subject: [PATCH 2102/5547] Fix a couple of minor issues with
 `TestSceneBeatmapRecommendations`

---
 .../Visual/SongSelect/TestSceneBeatmapRecommendations.cs      | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapRecommendations.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapRecommendations.cs
index 08b5802713..b7bc0c37e1 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapRecommendations.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapRecommendations.cs
@@ -113,6 +113,8 @@ namespace osu.Game.Tests.Visual.SongSelect
             // Switch to catch
             presentAndConfirm(() => catchSet, 1);
 
+            AddAssert("game-wide ruleset changed", () => Game.Ruleset.Value.Equals(catchSet.Beatmaps.First().Ruleset));
+
             // Present mixed difficulty set, expect current ruleset to be selected
             presentAndConfirm(() => mixedSet, 2);
         }
@@ -182,7 +184,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                 beatmap.DifficultyName = $"SR{i + 1}";
             }
 
-            return Game.BeatmapManager.Import(beatmapSet).GetResultSafely().Value;
+            return Game.BeatmapManager.Import(beatmapSet).GetResultSafely()?.Value;
         }
 
         private bool ensureAllBeatmapSetsImported(IEnumerable<BeatmapSetInfo> beatmapSets) => beatmapSets.All(set => set != null);

From 902dc0eaec32ff49aa1893d611ccc68ee4fecb12 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 10 Jan 2022 16:34:32 +0900
Subject: [PATCH 2103/5547] Detach rather than consume live when presenting a
 beatmap

---
 osu.Game/OsuGame.cs | 45 ++++++++++++++++++++++-----------------------
 1 file changed, 22 insertions(+), 23 deletions(-)

diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index b9e0aac6ef..ad045d08d2 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -451,32 +451,31 @@ namespace osu.Game
                 return;
             }
 
+            var detachedSet = databasedSet.PerformRead(s => s.Detach());
+
             PerformFromScreen(screen =>
             {
-                databasedSet.PerformRead(set =>
+                // Find beatmaps that match our predicate.
+                var beatmaps = detachedSet.Beatmaps.Where(b => difficultyCriteria?.Invoke(b) ?? true).ToList();
+
+                // Use all beatmaps if predicate matched nothing
+                if (beatmaps.Count == 0)
+                    beatmaps = detachedSet.Beatmaps.ToList();
+
+                // Prefer recommended beatmap if recommendations are available, else fallback to a sane selection.
+                var selection = difficultyRecommender.GetRecommendedBeatmap(beatmaps)
+                                ?? beatmaps.FirstOrDefault(b => b.Ruleset.Equals(Ruleset.Value))
+                                ?? beatmaps.First();
+
+                if (screen is IHandlePresentBeatmap presentableScreen)
                 {
-                    // Find beatmaps that match our predicate.
-                    var beatmaps = set.Beatmaps.Where(b => difficultyCriteria?.Invoke(b) ?? true).ToList();
-
-                    // Use all beatmaps if predicate matched nothing
-                    if (beatmaps.Count == 0)
-                        beatmaps = set.Beatmaps.ToList();
-
-                    // Prefer recommended beatmap if recommendations are available, else fallback to a sane selection.
-                    var selection = difficultyRecommender.GetRecommendedBeatmap(beatmaps)
-                                    ?? beatmaps.FirstOrDefault(b => b.Ruleset.Equals(Ruleset.Value))
-                                    ?? beatmaps.First();
-
-                    if (screen is IHandlePresentBeatmap presentableScreen)
-                    {
-                        presentableScreen.PresentBeatmap(BeatmapManager.GetWorkingBeatmap(selection), selection.Ruleset);
-                    }
-                    else
-                    {
-                        Ruleset.Value = selection.Ruleset;
-                        Beatmap.Value = BeatmapManager.GetWorkingBeatmap(selection);
-                    }
-                });
+                    presentableScreen.PresentBeatmap(BeatmapManager.GetWorkingBeatmap(selection), selection.Ruleset);
+                }
+                else
+                {
+                    Ruleset.Value = selection.Ruleset;
+                    Beatmap.Value = BeatmapManager.GetWorkingBeatmap(selection);
+                }
             }, validScreens: new[] { typeof(SongSelect), typeof(IHandlePresentBeatmap) });
         }
 

From b531cd020750e220a8c1fd3914c2efc15af96e81 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 10 Jan 2022 16:54:07 +0900
Subject: [PATCH 2104/5547] Fix donwload trackers not considering deleted
 scores

---
 osu.Game/Online/BeatmapDownloadTracker.cs | 2 +-
 osu.Game/Online/ScoreDownloadTracker.cs   | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Online/BeatmapDownloadTracker.cs b/osu.Game/Online/BeatmapDownloadTracker.cs
index 7a396ac7aa..be5bdea6f1 100644
--- a/osu.Game/Online/BeatmapDownloadTracker.cs
+++ b/osu.Game/Online/BeatmapDownloadTracker.cs
@@ -42,7 +42,7 @@ namespace osu.Game.Online
             // Used to interact with manager classes that don't support interface types. Will eventually be replaced.
             var beatmapSetInfo = new BeatmapSetInfo { OnlineID = TrackedItem.OnlineID };
 
-            realmSubscription = realmContextFactory.Context.All<BeatmapSetInfo>().Where(s => s.OnlineID == TrackedItem.OnlineID).QueryAsyncWithNotifications((items, changes, ___) =>
+            realmSubscription = realmContextFactory.Context.All<BeatmapSetInfo>().Where(s => s.OnlineID == TrackedItem.OnlineID && !s.DeletePending).QueryAsyncWithNotifications((items, changes, ___) =>
             {
                 if (items.Any())
                     Schedule(() => UpdateState(DownloadState.LocallyAvailable));
diff --git a/osu.Game/Online/ScoreDownloadTracker.cs b/osu.Game/Online/ScoreDownloadTracker.cs
index 946a751c31..08362448a3 100644
--- a/osu.Game/Online/ScoreDownloadTracker.cs
+++ b/osu.Game/Online/ScoreDownloadTracker.cs
@@ -47,7 +47,7 @@ namespace osu.Game.Online
             Downloader.DownloadBegan += downloadBegan;
             Downloader.DownloadFailed += downloadFailed;
 
-            realmSubscription = realmContextFactory.Context.All<ScoreInfo>().Where(s => s.OnlineID == TrackedItem.OnlineID).QueryAsyncWithNotifications((items, changes, ___) =>
+            realmSubscription = realmContextFactory.Context.All<ScoreInfo>().Where(s => s.OnlineID == TrackedItem.OnlineID && !s.DeletePending).QueryAsyncWithNotifications((items, changes, ___) =>
             {
                 if (items.Any())
                     Schedule(() => UpdateState(DownloadState.LocallyAvailable));

From c15efaeff2256871327360bdb66767455571b99b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 10 Jan 2022 17:07:40 +0900
Subject: [PATCH 2105/5547] Fix `OnlinePlayBeatmapAvailabilityTracker` not
 correctly tracking beatmap import changes

---
 .../Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs  | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs b/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs
index 1832c116bc..caec944104 100644
--- a/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs
+++ b/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs
@@ -71,7 +71,7 @@ namespace osu.Game.Online.Rooms
 
                 AddInternal(downloadTracker);
 
-                downloadTracker.State.BindValueChanged(_ => updateAvailability(), true);
+                downloadTracker.State.BindValueChanged(_ => Scheduler.AddOnce(updateAvailability), true);
                 downloadTracker.Progress.BindValueChanged(_ =>
                 {
                     if (downloadTracker.State.Value != DownloadState.Downloading)
@@ -85,14 +85,14 @@ namespace osu.Game.Online.Rooms
 
                 realmSubscription?.Dispose();
                 realmSubscription = realmContextFactory.Context
-                                                       .All<BeatmapSetInfo>()
-                                                       .Where(s => s.OnlineID == item.NewValue.BeatmapID) // TODO: figure out if we need this hash match in the subscription || s.ID == matchingHash?.ID)
+                                                       .All<BeatmapInfo>()
+                                                       .Where(b => b.OnlineID == item.NewValue.BeatmapID && b.MD5Hash == item.NewValue.Beatmap.Value.MD5Hash)
                                                        .QueryAsyncWithNotifications((items, changes, ___) =>
                                                        {
                                                            if (changes == null)
                                                                return;
 
-                                                           Schedule(updateAvailability);
+                                                           Scheduler.AddOnce(updateAvailability);
                                                        });
             }, true);
         }

From ac3b7aa89364e1efca967118e189a0a7c9f1f6a7 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 10 Jan 2022 17:21:29 +0900
Subject: [PATCH 2106/5547] Fix more incorrect test access to `ILive`

---
 .../TestScenePlaylistsRoomCreation.cs          | 18 ++++++++++--------
 1 file changed, 10 insertions(+), 8 deletions(-)

diff --git a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs
index 908e93dee2..eacc3d5e31 100644
--- a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs
+++ b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs
@@ -34,7 +34,7 @@ namespace osu.Game.Tests.Visual.Playlists
 
         private TestPlaylistsRoomSubScreen match;
 
-        private ILive<BeatmapSetInfo> importedBeatmap;
+        private BeatmapSetInfo importedBeatmap;
 
         [BackgroundDependencyLoader]
         private void load(GameHost host, AudioManager audio)
@@ -65,7 +65,7 @@ namespace osu.Game.Tests.Visual.Playlists
                 room.EndDate.Value = DateTimeOffset.Now.AddMinutes(5);
                 room.Playlist.Add(new PlaylistItem
                 {
-                    Beatmap = { Value = importedBeatmap.Value.Beatmaps.First() },
+                    Beatmap = { Value = importedBeatmap.Beatmaps.First() },
                     Ruleset = { Value = new OsuRuleset().RulesetInfo }
                 });
             });
@@ -88,7 +88,7 @@ namespace osu.Game.Tests.Visual.Playlists
                 room.EndDate.Value = DateTimeOffset.Now.AddMinutes(5);
                 room.Playlist.Add(new PlaylistItem
                 {
-                    Beatmap = { Value = importedBeatmap.Value.Beatmaps.First() },
+                    Beatmap = { Value = importedBeatmap.Beatmaps.First() },
                     Ruleset = { Value = new OsuRuleset().RulesetInfo }
                 });
             });
@@ -105,7 +105,7 @@ namespace osu.Game.Tests.Visual.Playlists
                 room.Host.Value = API.LocalUser.Value;
                 room.Playlist.Add(new PlaylistItem
                 {
-                    Beatmap = { Value = importedBeatmap.Value.Beatmaps.First() },
+                    Beatmap = { Value = importedBeatmap.Beatmaps.First() },
                     Ruleset = { Value = new OsuRuleset().RulesetInfo }
                 });
             });
@@ -122,9 +122,9 @@ namespace osu.Game.Tests.Visual.Playlists
 
             AddStep("store real beatmap values", () =>
             {
-                realHash = importedBeatmap.Value.Beatmaps[0].MD5Hash;
-                realOnlineId = importedBeatmap.Value.Beatmaps[0].OnlineID;
-                realOnlineSetId = importedBeatmap.Value.OnlineID;
+                realHash = importedBeatmap.Beatmaps[0].MD5Hash;
+                realOnlineId = importedBeatmap.Beatmaps[0].OnlineID;
+                realOnlineSetId = importedBeatmap.OnlineID;
             });
 
             AddStep("import modified beatmap", () =>
@@ -134,6 +134,7 @@ namespace osu.Game.Tests.Visual.Playlists
                     BeatmapInfo =
                     {
                         OnlineID = realOnlineId,
+                        Metadata = new BeatmapMetadata(),
                         BeatmapSet =
                         {
                             OnlineID = realOnlineSetId
@@ -160,6 +161,7 @@ namespace osu.Game.Tests.Visual.Playlists
                         {
                             MD5Hash = realHash,
                             OnlineID = realOnlineId,
+                            Metadata = new BeatmapMetadata(),
                             BeatmapSet = new BeatmapSetInfo
                             {
                                 OnlineID = realOnlineSetId,
@@ -211,7 +213,7 @@ namespace osu.Game.Tests.Visual.Playlists
 
             Debug.Assert(beatmap.BeatmapInfo.BeatmapSet != null);
 
-            importedBeatmap = manager.Import(beatmap.BeatmapInfo.BeatmapSet).GetResultSafely();
+            importedBeatmap = manager.Import(beatmap.BeatmapInfo.BeatmapSet).GetResultSafely()?.Value.Detach();
         });
 
         private class TestPlaylistsRoomSubScreen : PlaylistsRoomSubScreen

From ca7e11057c871f3e108c172259ff1cbaa2970ec6 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 10 Jan 2022 18:19:47 +0900
Subject: [PATCH 2107/5547] Use better method to ensure online availability
 tracker is in a clean state

---
 .../Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs  | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs b/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
index bdc2317ccd..8c24b2eef8 100644
--- a/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
+++ b/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
@@ -60,9 +60,8 @@ namespace osu.Game.Tests.Online
             testBeatmapInfo = getTestBeatmapInfo(testBeatmapFile);
             testBeatmapSet = testBeatmapInfo.BeatmapSet;
 
-            var existing = beatmaps.QueryBeatmapSet(s => s.OnlineID == testBeatmapSet.OnlineID);
-            if (existing != null)
-                beatmaps.Delete(existing.Value);
+            ContextFactory.Context.Write(r => r.RemoveAll<BeatmapSetInfo>());
+            ContextFactory.Context.Write(r => r.RemoveAll<BeatmapInfo>());
 
             selectedItem.Value = new PlaylistItem
             {

From a7958b1d317228af103d0648c7de320e1384ab32 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 10 Jan 2022 18:26:49 +0900
Subject: [PATCH 2108/5547] Fix edge cases in online availability tracker and
 combine query code

---
 .../OnlinePlayBeatmapAvailabilityTracker.cs   | 44 ++++++-------------
 1 file changed, 13 insertions(+), 31 deletions(-)

diff --git a/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs b/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs
index caec944104..1fa5d15eb3 100644
--- a/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs
+++ b/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs
@@ -12,6 +12,7 @@ using osu.Framework.Logging;
 using osu.Framework.Threading;
 using osu.Game.Beatmaps;
 using osu.Game.Database;
+using Realms;
 
 namespace osu.Game.Online.Rooms
 {
@@ -28,9 +29,6 @@ namespace osu.Game.Online.Rooms
         // Required to allow child components to update. Can potentially be replaced with a `CompositeComponent` class if or when we make one.
         protected override bool RequiresChildrenUpdate => true;
 
-        [Resolved]
-        private BeatmapManager beatmapManager { get; set; }
-
         [Resolved]
         private RealmContextFactory realmContextFactory { get; set; } = null!;
 
@@ -45,11 +43,6 @@ namespace osu.Game.Online.Rooms
 
         private BeatmapDownloadTracker downloadTracker;
 
-        /// <summary>
-        /// The beatmap matching the required hash (and providing a final <see cref="BeatmapAvailability.LocallyAvailable"/> state).
-        /// </summary>
-        private BeatmapInfo matchingHash;
-
         private IDisposable realmSubscription;
 
         protected override void LoadComplete()
@@ -83,17 +76,15 @@ namespace osu.Game.Online.Rooms
                         progressUpdate = Scheduler.AddDelayed(updateAvailability, progressUpdate == null ? 0 : 500);
                 }, true);
 
+                // handles changes to hash that didn't occur from the import process (ie. a user editing the beatmap in the editor, somehow).
                 realmSubscription?.Dispose();
-                realmSubscription = realmContextFactory.Context
-                                                       .All<BeatmapInfo>()
-                                                       .Where(b => b.OnlineID == item.NewValue.BeatmapID && b.MD5Hash == item.NewValue.Beatmap.Value.MD5Hash)
-                                                       .QueryAsyncWithNotifications((items, changes, ___) =>
-                                                       {
-                                                           if (changes == null)
-                                                               return;
+                realmSubscription = filteredBeatmaps().QueryAsyncWithNotifications((items, changes, ___) =>
+                {
+                    if (changes == null)
+                        return;
 
-                                                           Scheduler.AddOnce(updateAvailability);
-                                                       });
+                    Scheduler.AddOnce(updateAvailability);
+                });
             }, true);
         }
 
@@ -102,9 +93,6 @@ namespace osu.Game.Online.Rooms
             if (downloadTracker == null)
                 return;
 
-            // will be repopulated below if still valid.
-            matchingHash = null;
-
             switch (downloadTracker.State.Value)
             {
                 case DownloadState.NotDownloaded:
@@ -120,9 +108,7 @@ namespace osu.Game.Online.Rooms
                     break;
 
                 case DownloadState.LocallyAvailable:
-                    matchingHash = findMatchingHash();
-
-                    bool hashMatches = matchingHash != null;
+                    bool hashMatches = filteredBeatmaps().Any();
 
                     availability.Value = hashMatches ? BeatmapAvailability.LocallyAvailable() : BeatmapAvailability.NotDownloaded();
 
@@ -137,18 +123,14 @@ namespace osu.Game.Online.Rooms
             }
         }
 
-        private BeatmapInfo findMatchingHash()
+        private IQueryable<BeatmapInfo> filteredBeatmaps()
         {
             int onlineId = SelectedItem.Value.Beatmap.Value.OnlineID;
             string checksum = SelectedItem.Value.Beatmap.Value.MD5Hash;
 
-            var foundBeatmap = beatmapManager.QueryBeatmap(b => b.OnlineID == onlineId && b.MD5Hash == checksum);
-
-            // can't be included in the above query due to realm limitations.
-            if (foundBeatmap?.BeatmapSet?.DeletePending == true)
-                return null;
-
-            return foundBeatmap;
+            return realmContextFactory.Context
+                                      .All<BeatmapInfo>()
+                                      .Filter("OnlineID == $0 && MD5Hash == $1 && BeatmapSet.DeletePending == false", onlineId, checksum);
         }
 
         protected override void Dispose(bool isDisposing)

From 6033a825ede119066ea24101d76dc6d86250757f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 10 Jan 2022 19:23:43 +0900
Subject: [PATCH 2109/5547] Ensure `BeatmapInfo` `Difficulty` and `Metadata` is
 non-null

---
 osu.Game/Beatmaps/BeatmapInfo.cs | 28 ++++++++++++++--------------
 1 file changed, 14 insertions(+), 14 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapInfo.cs b/osu.Game/Beatmaps/BeatmapInfo.cs
index 32eff68d5c..00d40dc513 100644
--- a/osu.Game/Beatmaps/BeatmapInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapInfo.cs
@@ -32,9 +32,21 @@ namespace osu.Game.Beatmaps
 
         public RulesetInfo Ruleset { get; set; } = null!;
 
-        public BeatmapDifficulty Difficulty { get; set; } = null!;
+        public BeatmapDifficulty Difficulty { get; set; } = new BeatmapDifficulty();
 
-        public BeatmapMetadata Metadata { get; set; } = null!;
+        public BeatmapMetadata Metadata { get; set; } = new BeatmapMetadata();
+
+        public BeatmapInfo(RulesetInfo ruleset, BeatmapDifficulty difficulty, BeatmapMetadata metadata)
+        {
+            Ruleset = ruleset;
+            Difficulty = difficulty;
+            Metadata = metadata;
+        }
+
+        [UsedImplicitly]
+        public BeatmapInfo() // TODO: this bypasses null safeties. needs to be hidden from user api (only should be used by realm).
+        {
+        }
 
         public BeatmapSetInfo? BeatmapSet { get; set; }
 
@@ -66,18 +78,6 @@ namespace osu.Game.Beatmaps
         [JsonIgnore]
         public bool Hidden { get; set; }
 
-        public BeatmapInfo(RulesetInfo ruleset, BeatmapDifficulty difficulty, BeatmapMetadata metadata)
-        {
-            Ruleset = ruleset;
-            Difficulty = difficulty;
-            Metadata = metadata;
-        }
-
-        [UsedImplicitly]
-        public BeatmapInfo() // TODO: this bypasses null safeties. needs to be hidden from user api (only should be used by realm).
-        {
-        }
-
         #region Properties we may not want persisted (but also maybe no harm?)
 
         public double AudioLeadIn { get; set; }

From f4515602036311f0413e5ff499ddc0eea65e42f9 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 10 Jan 2022 19:27:13 +0900
Subject: [PATCH 2110/5547] Update null allowances across beatmaps and scores

---
 osu.Game/Beatmaps/BeatmapInfo.cs | 2 +-
 osu.Game/Scoring/ScoreInfo.cs    | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapInfo.cs b/osu.Game/Beatmaps/BeatmapInfo.cs
index 00d40dc513..53aba67275 100644
--- a/osu.Game/Beatmaps/BeatmapInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapInfo.cs
@@ -44,7 +44,7 @@ namespace osu.Game.Beatmaps
         }
 
         [UsedImplicitly]
-        public BeatmapInfo() // TODO: this bypasses null safeties. needs to be hidden from user api (only should be used by realm).
+        public BeatmapInfo() // TODO: consider removing this and migrating all usages to ctor with parameters.
         {
         }
 
diff --git a/osu.Game/Scoring/ScoreInfo.cs b/osu.Game/Scoring/ScoreInfo.cs
index eb4a0d21d7..61df736a4a 100644
--- a/osu.Game/Scoring/ScoreInfo.cs
+++ b/osu.Game/Scoring/ScoreInfo.cs
@@ -44,7 +44,7 @@ namespace osu.Game.Scoring
         public long OnlineID { get; set; } = -1;
 
         [MapTo("User")]
-        public RealmUser RealmUser { get; set; } = null!;
+        public RealmUser RealmUser { get; set; } = new RealmUser();
 
         public ScoreInfo(BeatmapInfo beatmap, RulesetInfo ruleset, RealmUser realmUser)
         {
@@ -54,7 +54,7 @@ namespace osu.Game.Scoring
         }
 
         [UsedImplicitly]
-        public ScoreInfo() // TODO: this bypasses null safeties. needs to be hidden from user api (only should be used by realm).
+        public ScoreInfo() // TODO: consider removing this and migrating all usages to ctor with parameters.
         {
         }
 

From 58f8aae731f391c7845afefe7083aae770155dab Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 11 Jan 2022 13:34:24 +0900
Subject: [PATCH 2111/5547] Fix one missed instance of `GetResultSafely`

---
 osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
index caa994a98b..d03a8b645d 100644
--- a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
+++ b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
@@ -170,7 +170,7 @@ namespace osu.Game.Screens.Select.Leaderboards
                     scores = scores.Detach();
 
                     scoreManager.OrderByTotalScoreAsync(scores.ToArray(), cancellationToken)
-                                .ContinueWith(ordered => scoresCallback?.Invoke(ordered.Result), TaskContinuationOptions.OnlyOnRanToCompletion);
+                                .ContinueWith(ordered => scoresCallback?.Invoke(ordered.GetResultSafely()), TaskContinuationOptions.OnlyOnRanToCompletion);
 
                     return null;
                 }

From b5975eee3355a39e6988148245a758bb96d63e45 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 11 Jan 2022 13:36:58 +0900
Subject: [PATCH 2112/5547] This file should have been deleted in a previous
 commit (rebase failure)

---
 .../Beatmaps/IO/ImportBeatmapTest.cs          | 148 ------------------
 1 file changed, 148 deletions(-)
 delete mode 100644 osu.Game.Tests/Beatmaps/IO/ImportBeatmapTest.cs

diff --git a/osu.Game.Tests/Beatmaps/IO/ImportBeatmapTest.cs b/osu.Game.Tests/Beatmaps/IO/ImportBeatmapTest.cs
deleted file mode 100644
index 0d973c8aeb..0000000000
--- a/osu.Game.Tests/Beatmaps/IO/ImportBeatmapTest.cs
+++ /dev/null
@@ -1,148 +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.IO;
-using System.Linq;
-using System.Threading;
-using System.Threading.Tasks;
-using NUnit.Framework;
-using osu.Framework.Allocation;
-using osu.Framework.Extensions;
-using osu.Game.Beatmaps;
-using osu.Game.Database;
-using osu.Game.Scoring;
-using osu.Game.Tests.Resources;
-using osu.Game.Tests.Scores.IO;
-
-namespace osu.Game.Tests.Beatmaps.IO
-{
-    [TestFixture]
-    public class ImportBeatmapTest : ImportTest
-    {
-        public static async Task<BeatmapSetInfo> LoadQuickOszIntoOsu(OsuGameBase osu)
-        {
-            string temp = TestResources.GetQuickTestBeatmapForImport();
-
-            var manager = osu.Dependencies.Get<BeatmapManager>();
-
-            var importedSet = manager.Import(new ImportTask(temp)).GetResultSafely();
-
-            ensureLoaded(osu).WaitSafely();
-
-            waitForOrAssert(() => !File.Exists(temp), "Temporary file still exists after standard import", 5000);
-
-            return manager.GetAllUsableBeatmapSets().Find(beatmapSet => beatmapSet.ID == importedSet.Value.ID);
-        }, TaskCreationOptions.LongRunning);
-
-        public static Task<BeatmapSetInfo> LoadOszIntoOsu(OsuGameBase osu, string path = null, bool virtualTrack = false) => Task.Factory.StartNew(() =>
-        {
-            string temp = path ?? TestResources.GetTestBeatmapForImport(virtualTrack);
-
-            var manager = osu.Dependencies.Get<BeatmapManager>();
-
-            var importedSet = manager.Import(new ImportTask(temp)).GetResultSafely();
-
-            ensureLoaded(osu).WaitSafely();
-
-            waitForOrAssert(() => !File.Exists(temp), "Temporary file still exists after standard import", 5000);
-
-            return manager.GetAllUsableBeatmapSets().Find(beatmapSet => beatmapSet.ID == importedSet.Value.ID);
-        }, TaskCreationOptions.LongRunning);
-
-        private void deleteBeatmapSet(BeatmapSetInfo imported, OsuGameBase osu)
-        {
-            var manager = osu.Dependencies.Get<BeatmapManager>();
-            manager.Delete(imported);
-
-            checkBeatmapSetCount(osu, 0);
-            checkBeatmapSetCount(osu, 1, true);
-            checkSingleReferencedFileCount(osu, 0);
-
-            Assert.IsTrue(manager.QueryBeatmapSets(_ => true).First().DeletePending);
-        }
-
-        private static Task createScoreForBeatmap(OsuGameBase osu, BeatmapInfo beatmapInfo)
-        {
-            return ImportScoreTest.LoadScoreIntoOsu(osu, new ScoreInfo
-            {
-                OnlineID = 2,
-                BeatmapInfo = beatmapInfo,
-            }, new ImportScoreTest.TestArchiveReader());
-        }
-
-        private static void checkBeatmapSetCount(OsuGameBase osu, int expected, bool includeDeletePending = false)
-        {
-            var manager = osu.Dependencies.Get<BeatmapManager>();
-
-            Assert.AreEqual(expected, includeDeletePending
-                ? manager.QueryBeatmapSets(_ => true).ToList().Count
-                : manager.GetAllUsableBeatmapSets().Count);
-        }
-
-        private static string hashFile(string filename)
-        {
-            using (var s = File.OpenRead(filename))
-                return s.ComputeMD5Hash();
-        }
-
-        private static void checkBeatmapCount(OsuGameBase osu, int expected)
-        {
-            Assert.AreEqual(expected, osu.Dependencies.Get<BeatmapManager>().QueryBeatmaps(_ => true).ToList().Count);
-        }
-
-        private static void checkSingleReferencedFileCount(OsuGameBase osu, int expected)
-        {
-            Assert.AreEqual(expected, osu.Dependencies.Get<DatabaseContextFactory>().Get().FileInfo.Count(f => f.ReferenceCount == 1));
-        }
-
-        private static Task ensureLoaded(OsuGameBase osu, int timeout = 60000) => Task.Factory.StartNew(() =>
-        {
-            IEnumerable<BeatmapSetInfo> resultSets = null;
-            var store = osu.Dependencies.Get<BeatmapManager>();
-            waitForOrAssert(() => (resultSets = store.QueryBeatmapSets(s => s.OnlineID == 241526)).Any(),
-                @"BeatmapSet did not import to the database in allocated time.", timeout);
-
-            // ensure we were stored to beatmap database backing...
-            Assert.IsTrue(resultSets.Count() == 1, $@"Incorrect result count found ({resultSets.Count()} but should be 1).");
-            IEnumerable<BeatmapInfo> queryBeatmaps() => store.QueryBeatmaps(s => s.BeatmapSet.OnlineID == 241526);
-            IEnumerable<BeatmapSetInfo> queryBeatmapSets() => store.QueryBeatmapSets(s => s.OnlineID == 241526);
-
-            // if we don't re-check here, the set will be inserted but the beatmaps won't be present yet.
-            waitForOrAssert(() => queryBeatmaps().Count() == 12,
-                @"Beatmaps did not import to the database in allocated time", timeout);
-            waitForOrAssert(() => queryBeatmapSets().Count() == 1,
-                @"BeatmapSet did not import to the database in allocated time", timeout);
-            int countBeatmapSetBeatmaps = 0;
-            int countBeatmaps = 0;
-            waitForOrAssert(() =>
-                    (countBeatmapSetBeatmaps = queryBeatmapSets().First().Beatmaps.Count) ==
-                    (countBeatmaps = queryBeatmaps().Count()),
-                $@"Incorrect database beatmap count post-import ({countBeatmaps} but should be {countBeatmapSetBeatmaps}).", timeout);
-
-            var set = queryBeatmapSets().First();
-            foreach (BeatmapInfo b in set.Beatmaps)
-                Assert.IsTrue(set.Beatmaps.Any(c => c.OnlineID == b.OnlineID));
-            Assert.IsTrue(set.Beatmaps.Count > 0);
-            var beatmap = store.GetWorkingBeatmap(set.Beatmaps.First(b => b.RulesetID == 0))?.Beatmap;
-            Assert.IsTrue(beatmap?.HitObjects.Any() == true);
-            beatmap = store.GetWorkingBeatmap(set.Beatmaps.First(b => b.RulesetID == 1))?.Beatmap;
-            Assert.IsTrue(beatmap?.HitObjects.Any() == true);
-            beatmap = store.GetWorkingBeatmap(set.Beatmaps.First(b => b.RulesetID == 2))?.Beatmap;
-            Assert.IsTrue(beatmap?.HitObjects.Any() == true);
-            beatmap = store.GetWorkingBeatmap(set.Beatmaps.First(b => b.RulesetID == 3))?.Beatmap;
-            Assert.IsTrue(beatmap?.HitObjects.Any() == true);
-        }, TaskCreationOptions.LongRunning);
-
-        private static void waitForOrAssert(Func<bool> result, string failureMessage, int timeout = 60000)
-        {
-            Task task = Task.Factory.StartNew(() =>
-            {
-                while (!result()) Thread.Sleep(200);
-            }, TaskCreationOptions.LongRunning);
-
-            Assert.IsTrue(task.Wait(timeout), failureMessage);
-        }
-    }
-}

From 286994a808b5dc684000b20bdaf76c2f2aebc20f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 11 Jan 2022 14:19:35 +0900
Subject: [PATCH 2113/5547] Fix `BeatmapDifficulty` cloning regression

---
 osu.Game.Rulesets.Taiko/Beatmaps/TaikoBeatmapConverter.cs | 3 +++
 osu.Game/Beatmaps/BeatmapDifficulty.cs                    | 2 +-
 2 files changed, 4 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Taiko/Beatmaps/TaikoBeatmapConverter.cs b/osu.Game.Rulesets.Taiko/Beatmaps/TaikoBeatmapConverter.cs
index 9b2e9fedc5..61f932fd98 100644
--- a/osu.Game.Rulesets.Taiko/Beatmaps/TaikoBeatmapConverter.cs
+++ b/osu.Game.Rulesets.Taiko/Beatmaps/TaikoBeatmapConverter.cs
@@ -191,6 +191,9 @@ namespace osu.Game.Rulesets.Taiko.Beatmaps
 
         protected override Beatmap<TaikoHitObject> CreateBeatmap() => new TaikoBeatmap();
 
+        // Important to note that this is subclassing a realm object.
+        // Realm doesn't allow this, but for now this can work since we aren't (in theory?) persisting this to the database.
+        // It is only used during beatmap conversion and processing.
         internal class TaikoMultiplierAppliedDifficulty : BeatmapDifficulty
         {
             public TaikoMultiplierAppliedDifficulty(IBeatmapDifficultyInfo difficulty)
diff --git a/osu.Game/Beatmaps/BeatmapDifficulty.cs b/osu.Game/Beatmaps/BeatmapDifficulty.cs
index 90a60c0f0c..f6e8b8c57d 100644
--- a/osu.Game/Beatmaps/BeatmapDifficulty.cs
+++ b/osu.Game/Beatmaps/BeatmapDifficulty.cs
@@ -39,7 +39,7 @@ namespace osu.Game.Beatmaps
         /// </summary>
         public BeatmapDifficulty Clone()
         {
-            var diff = new BeatmapDifficulty();
+            var diff = (BeatmapDifficulty)MemberwiseClone();
             CopyTo(diff);
             return diff;
         }

From 2ce80cc0301b1cfb7da577f564a5d14349261521 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 11 Jan 2022 14:40:47 +0900
Subject: [PATCH 2114/5547] Add back caching in `WorkingBeatmapCache`

---
 osu.Game/Beatmaps/WorkingBeatmapCache.cs | 31 +++++++++++++++---------
 1 file changed, 19 insertions(+), 12 deletions(-)

diff --git a/osu.Game/Beatmaps/WorkingBeatmapCache.cs b/osu.Game/Beatmaps/WorkingBeatmapCache.cs
index 6be69b5477..f4324dcc81 100644
--- a/osu.Game/Beatmaps/WorkingBeatmapCache.cs
+++ b/osu.Game/Beatmaps/WorkingBeatmapCache.cs
@@ -12,6 +12,7 @@ using osu.Framework.IO.Stores;
 using osu.Framework.Lists;
 using osu.Framework.Logging;
 using osu.Framework.Platform;
+using osu.Framework.Statistics;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps.Formats;
 using osu.Game.Database;
@@ -75,21 +76,27 @@ namespace osu.Game.Beatmaps
 
         public virtual WorkingBeatmap GetWorkingBeatmap(BeatmapInfo beatmapInfo)
         {
-            // if there are no files, presume the full beatmap info has not yet been fetched from the database.
-            if (beatmapInfo?.BeatmapSet?.Files.Count == 0)
-            {
-                var lookupId = beatmapInfo.ID;
-                beatmapInfo = BeatmapManager.QueryBeatmap(b => b.ID == lookupId);
-            }
-
-            // TODO: FUCK THE WORLD :D
-            if (beatmapInfo?.IsManaged == true)
-                beatmapInfo = beatmapInfo.Detach();
-
             if (beatmapInfo?.BeatmapSet == null)
                 return DefaultBeatmap;
 
-            return new BeatmapManagerWorkingBeatmap(beatmapInfo, this);
+            lock (workingCache)
+            {
+                var working = workingCache.FirstOrDefault(w => beatmapInfo.Equals(w.BeatmapInfo));
+
+                if (working != null)
+                    return working;
+
+                // TODO: FUCK THE WORLD :D
+                if (beatmapInfo?.IsManaged == true)
+                    beatmapInfo = beatmapInfo.Detach();
+
+                workingCache.Add(working = new BeatmapManagerWorkingBeatmap(beatmapInfo, this));
+
+                // best effort; may be higher than expected.
+                GlobalStatistics.Get<int>("Beatmaps", $"Cached {nameof(WorkingBeatmap)}s").Value = workingCache.Count();
+
+                return working;
+            }
         }
 
         #region IResourceStorageProvider

From 9e2ca583a3aa5e04b5fa313fbc7288c00d2c7ae4 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 11 Jan 2022 15:33:54 +0900
Subject: [PATCH 2115/5547] Fix incorrect realm factory isolation in
 `TestScenePlaySongSelect`

---
 osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
index 396bbc3dc5..3db1d0b25b 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
@@ -45,7 +45,10 @@ namespace osu.Game.Tests.Visual.SongSelect
         [BackgroundDependencyLoader]
         private void load(GameHost host, AudioManager audio)
         {
+            // These DI caches are required to ensure for interactive runs this test scene doesn't nuke all user beatmaps in the local install.
+            // At a point we have isolated interactive test runs enough, this can likely be removed.
             Dependencies.Cache(rulesets = new RulesetStore(ContextFactory));
+            Dependencies.Cache(ContextFactory);
             Dependencies.Cache(manager = new BeatmapManager(LocalStorage, ContextFactory, rulesets, null, audio, Resources, host, defaultBeatmap = Beatmap.Default));
 
             Dependencies.Cache(music = new MusicController());

From cd88ccab4f7486416d25a1235a7ccdf266c4bcc3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 11 Jan 2022 15:40:18 +0900
Subject: [PATCH 2116/5547] Fix `TestScenePlaySongSelect` failure due to detach
 clone depth

---
 osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
index 3db1d0b25b..6295a52bdd 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
@@ -640,8 +640,9 @@ namespace osu.Game.Tests.Visual.SongSelect
 
             AddStep("Get filtered icon", () =>
             {
-                filteredBeatmap = songSelect.Carousel.SelectedBeatmapSet.Beatmaps.First(b => b.BPM < maxBPM);
-                int filteredBeatmapIndex = getBeatmapIndex(filteredBeatmap.BeatmapSet, filteredBeatmap);
+                var selectedSet = songSelect.Carousel.SelectedBeatmapSet;
+                filteredBeatmap = selectedSet.Beatmaps.First(b => b.BPM < maxBPM);
+                int filteredBeatmapIndex = getBeatmapIndex(selectedSet, filteredBeatmap);
                 filteredIcon = set.ChildrenOfType<FilterableDifficultyIcon>().ElementAt(filteredBeatmapIndex);
             });
 

From 6613a7e4aebb99a64f3f27bf154ba1605aacf01f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 11 Jan 2022 15:44:33 +0900
Subject: [PATCH 2117/5547] Fix another case of test ruleset without overriding
 `ShortName` primary key

---
 .../Visual/UserInterface/TestSceneModSelectOverlay.cs           | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectOverlay.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectOverlay.cs
index f196bbd76e..b429619044 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectOverlay.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectOverlay.cs
@@ -459,6 +459,8 @@ namespace osu.Game.Tests.Visual.UserInterface
 
         private class TestUnimplementedModOsuRuleset : OsuRuleset
         {
+            public override string ShortName => "unimplemented";
+
             public override IEnumerable<Mod> GetModsFor(ModType type)
             {
                 if (type == ModType.Conversion) return base.GetModsFor(type).Concat(new[] { new TestUnimplementedMod() });

From dd19487eb8eab9d13f0fc49e05bdf81ec924c7ab Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 11 Jan 2022 15:55:13 +0900
Subject: [PATCH 2118/5547] Fix custom import process in
 `TestSceneDrawableRoomPlaylist` not working with realm

---
 .../TestSceneDrawableRoomPlaylist.cs            | 17 +++++++++--------
 1 file changed, 9 insertions(+), 8 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
index d87a0a4a1c..5bad36c3dd 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
@@ -153,19 +153,20 @@ namespace osu.Game.Tests.Visual.Multiplayer
         public void TestDownloadButtonHiddenWhenBeatmapExists()
         {
             var beatmap = new TestBeatmap(new OsuRuleset().RulesetInfo).BeatmapInfo;
+            ILive<BeatmapSetInfo> imported = null;
 
             Debug.Assert(beatmap.BeatmapSet != null);
 
-            AddStep("import beatmap", () => manager.Import(beatmap.BeatmapSet).WaitSafely());
+            AddStep("import beatmap", () => imported = manager.Import(beatmap.BeatmapSet).GetResultSafely());
 
-            createPlaylistWithBeatmaps(beatmap);
+            createPlaylistWithBeatmaps(() => imported.PerformRead(s => s.Beatmaps.Detach()));
 
             assertDownloadButtonVisible(false);
 
-            AddStep("delete beatmap set", () => manager.Delete(manager.QueryBeatmapSets(_ => true).Single().Value));
+            AddStep("delete beatmap set", () => imported.PerformWrite(s => s.DeletePending = true));
             assertDownloadButtonVisible(true);
 
-            AddStep("undelete beatmap set", () => manager.Undelete(manager.QueryBeatmapSets(_ => true).Single().Value));
+            AddStep("undelete beatmap set", () => imported.PerformWrite(s => s.DeletePending = false));
             assertDownloadButtonVisible(false);
 
             void assertDownloadButtonVisible(bool visible) => AddUntilStep($"download button {(visible ? "shown" : "hidden")}",
@@ -181,7 +182,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             var byChecksum = CreateAPIBeatmap();
             byChecksum.Checksum = "1337"; // Some random checksum that does not exist locally.
 
-            createPlaylistWithBeatmaps(byOnlineId, byChecksum);
+            createPlaylistWithBeatmaps(() => new[] { byOnlineId, byChecksum });
 
             AddAssert("download buttons shown", () => playlist.ChildrenOfType<BeatmapDownloadButton>().All(d => d.IsPresent));
         }
@@ -195,7 +196,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             beatmap.BeatmapSet.HasExplicitContent = true;
 
-            createPlaylistWithBeatmaps(beatmap);
+            createPlaylistWithBeatmaps(() => new[] { beatmap });
         }
 
         [Test]
@@ -327,7 +328,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddUntilStep("wait for items to load", () => playlist.ItemMap.Values.All(i => i.IsLoaded));
         }
 
-        private void createPlaylistWithBeatmaps(params IBeatmapInfo[] beatmaps)
+        private void createPlaylistWithBeatmaps(Func<IEnumerable<IBeatmapInfo>> beatmaps)
         {
             AddStep("create playlist", () =>
             {
@@ -340,7 +341,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
                 int index = 0;
 
-                foreach (var b in beatmaps)
+                foreach (var b in beatmaps())
                 {
                     playlist.Items.Add(new PlaylistItem
                     {

From 64a47ff85066be41c54f58cd7bebff40a9fd0278 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 11 Jan 2022 16:30:35 +0900
Subject: [PATCH 2119/5547] Allow `RealmArchiveModelManager` file operations to
 be performed on detached instances

---
 osu.Game/Stores/RealmArchiveModelManager.cs | 27 +++++++++++++++++----
 1 file changed, 22 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Stores/RealmArchiveModelManager.cs b/osu.Game/Stores/RealmArchiveModelManager.cs
index 0b78071d16..00fc5bbb6f 100644
--- a/osu.Game/Stores/RealmArchiveModelManager.cs
+++ b/osu.Game/Stores/RealmArchiveModelManager.cs
@@ -9,6 +9,7 @@ using System.Threading;
 using System.Threading.Tasks;
 using osu.Framework.Platform;
 using osu.Game.Database;
+using osu.Game.Extensions;
 using osu.Game.IO.Archives;
 using osu.Game.Models;
 using osu.Game.Overlays.Notifications;
@@ -33,13 +34,29 @@ namespace osu.Game.Stores
         }
 
         public void DeleteFile(TModel item, RealmNamedFileUsage file) =>
-            item.Realm.Write(() => DeleteFile(item, file, item.Realm));
+            performFileOperation(item, managed => DeleteFile(managed, file, managed.Realm));
 
-        public void ReplaceFile(TModel item, RealmNamedFileUsage file, Stream contents)
-            => item.Realm.Write(() => ReplaceFile(file, contents, item.Realm));
+        public void ReplaceFile(TModel item, RealmNamedFileUsage file, Stream contents) =>
+            performFileOperation(item, managed => ReplaceFile(file, contents, managed.Realm));
 
-        public void AddFile(TModel item, Stream contents, string filename)
-            => item.Realm.Write(() => AddFile(item, contents, filename, item.Realm));
+        public void AddFile(TModel item, Stream contents, string filename) =>
+            performFileOperation(item, managed => AddFile(managed, contents, filename, managed.Realm));
+
+        private void performFileOperation(TModel item, Action<TModel> operation)
+        {
+            // While we are detaching so often, this seems like the easiest way to keep things in sync.
+            // This method should be removed as soon as all the surrounding pieces support non-detached operations.
+            if (!item.IsManaged)
+            {
+                var managed = ContextFactory.Context.Find<TModel>(item.ID);
+                managed.Realm.Write(() => operation(managed));
+
+                item.Files.Clear();
+                item.Files.AddRange(managed.Files.Detach());
+            }
+            else
+                operation(item);
+        }
 
         /// <summary>
         /// Delete a file from within an ongoing realm transaction.

From 8c3dc4333d5ccce809d645ce8817947bd4444920 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 11 Jan 2022 16:30:55 +0900
Subject: [PATCH 2120/5547] Fix incorrect realm access after new beatmap import

---
 osu.Game/Beatmaps/BeatmapManager.cs | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index 4f6b74ba0a..55f05bf05f 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -97,9 +97,12 @@ namespace osu.Game.Beatmaps
                 }
             };
 
-            var imported = beatmapModelManager.Import(set).GetResultSafely()?.Value;
+            var imported = beatmapModelManager.Import(set).GetResultSafely();
 
-            return GetWorkingBeatmap(imported?.Beatmaps.First());
+            if (imported == null)
+                throw new InvalidOperationException("Failed to import new beatmap");
+
+            return imported.PerformRead(s => GetWorkingBeatmap(s.Beatmaps.First()));
         }
 
         /// <summary>

From dc9ea4adeb2d1fbe75ce58c5b75ebb4fa9b86eb3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 11 Jan 2022 16:31:00 +0900
Subject: [PATCH 2121/5547] Remove incorrect test assertion

---
 osu.Game.Tests/Visual/Editing/TestSceneEditorBeatmapCreation.cs | 1 -
 1 file changed, 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneEditorBeatmapCreation.cs b/osu.Game.Tests/Visual/Editing/TestSceneEditorBeatmapCreation.cs
index 4cc6e2ca18..2386446e96 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneEditorBeatmapCreation.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneEditorBeatmapCreation.cs
@@ -49,7 +49,6 @@ namespace osu.Game.Tests.Visual.Editing
         public void TestCreateNewBeatmap()
         {
             AddStep("save beatmap", () => Editor.Save());
-            AddAssert("new beatmap persisted", () => EditorBeatmap.BeatmapInfo.IsManaged);
             AddAssert("new beatmap in database", () => beatmapManager.QueryBeatmapSet(s => s.ID == EditorBeatmap.BeatmapInfo.BeatmapSet.ID)?.Value.DeletePending == false);
         }
 

From 7509a9ff8f6d1a45182eea6fc096135bc89679f1 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 11 Jan 2022 18:17:13 +0900
Subject: [PATCH 2122/5547] Update `BeatmapModelManager.Save` to work for
 editor scenarios

---
 osu.Game/Beatmaps/BeatmapManager.cs      |  7 +++--
 osu.Game/Beatmaps/BeatmapModelManager.cs | 36 +++++++++---------------
 osu.Game/Screens/Edit/Editor.cs          |  3 --
 3 files changed, 19 insertions(+), 27 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index 55f05bf05f..c869fd1bad 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -82,7 +82,7 @@ namespace osu.Game.Beatmaps
                 }
             };
 
-            var set = new BeatmapSetInfo
+            var beatmapSet = new BeatmapSetInfo
             {
                 Beatmaps =
                 {
@@ -97,7 +97,10 @@ namespace osu.Game.Beatmaps
                 }
             };
 
-            var imported = beatmapModelManager.Import(set).GetResultSafely();
+            foreach (BeatmapInfo b in beatmapSet.Beatmaps)
+                b.BeatmapSet = beatmapSet;
+
+            var imported = beatmapModelManager.Import(beatmapSet).GetResultSafely();
 
             if (imported == null)
                 throw new InvalidOperationException("Failed to import new beatmap");
diff --git a/osu.Game/Beatmaps/BeatmapModelManager.cs b/osu.Game/Beatmaps/BeatmapModelManager.cs
index 254babc3a1..62d607c4f7 100644
--- a/osu.Game/Beatmaps/BeatmapModelManager.cs
+++ b/osu.Game/Beatmaps/BeatmapModelManager.cs
@@ -70,35 +70,27 @@ namespace osu.Game.Beatmaps
 
                 stream.Seek(0, SeekOrigin.Begin);
 
-                using (var realm = ContextFactory.CreateContext())
-                using (var transaction = realm.BeginWrite())
-                {
-                    beatmapInfo = setInfo.Beatmaps.Single(b => b.Equals(beatmapInfo));
+                // AddFile generally handles updating/replacing files, but this is a case where the filename may have also changed so let's delete for simplicity.
+                var existingFileInfo = setInfo.Files.SingleOrDefault(f => string.Equals(f.Filename, beatmapInfo.Path, StringComparison.OrdinalIgnoreCase));
+                if (existingFileInfo != null)
+                    DeleteFile(setInfo, existingFileInfo);
 
-                    // grab the original file (or create a new one if not found).
-                    var existingFileInfo = setInfo.Files.SingleOrDefault(f => string.Equals(f.Filename, beatmapInfo.Path, StringComparison.OrdinalIgnoreCase));
+                beatmapInfo.MD5Hash = stream.ComputeMD5Hash();
+                beatmapInfo.Hash = stream.ComputeSHA2Hash();
 
-                    if (existingFileInfo != null)
-                    {
-                        DeleteFile(setInfo, existingFileInfo);
-                    }
-
-                    // metadata may have changed; update the path with the standard format.
-                    var metadata = beatmapInfo.Metadata;
-                    string filename = $"{metadata.Artist} - {metadata.Title} ({metadata.Author}) [{beatmapInfo.DifficultyName}].osu".GetValidArchiveContentFilename();
-
-                    beatmapInfo.MD5Hash = stream.ComputeMD5Hash();
-
-                    stream.Seek(0, SeekOrigin.Begin);
-                    AddFile(setInfo, stream, filename, realm);
-
-                    transaction.Commit();
-                }
+                AddFile(setInfo, stream, getFilename(beatmapInfo));
+                Update(setInfo);
             }
 
             WorkingBeatmapCache?.Invalidate(beatmapInfo);
         }
 
+        private static string getFilename(BeatmapInfo beatmapInfo)
+        {
+            var metadata = beatmapInfo.Metadata;
+            return $"{metadata.Artist} - {metadata.Title} ({metadata.Author}) [{beatmapInfo.DifficultyName}].osu".GetValidArchiveContentFilename();
+        }
+
         /// <summary>
         /// Perform a lookup query on available <see cref="BeatmapInfo"/>s.
         /// </summary>
diff --git a/osu.Game/Screens/Edit/Editor.cs b/osu.Game/Screens/Edit/Editor.cs
index 3a420f4994..383b59dc01 100644
--- a/osu.Game/Screens/Edit/Editor.cs
+++ b/osu.Game/Screens/Edit/Editor.cs
@@ -356,9 +356,6 @@ namespace osu.Game.Screens.Edit
             // no longer new after first user-triggered save.
             isNewBeatmap = false;
 
-            // apply any set-level metadata changes.
-            beatmapManager.Update(editorBeatmap.BeatmapInfo.BeatmapSet);
-
             // save the loaded beatmap's data stream.
             beatmapManager.Save(editorBeatmap.BeatmapInfo, editorBeatmap.PlayableBeatmap, editorBeatmap.BeatmapSkin);
 

From 80eee6d7b031680a0437943172209e7362248ce5 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 11 Jan 2022 18:18:03 +0900
Subject: [PATCH 2123/5547] Make `RealmArchiveModelManager.Update` work using
 automapper

---
 osu.Game/Screens/Menu/IntroScreen.cs        | 6 +-----
 osu.Game/Stores/RealmArchiveModelManager.cs | 7 ++++++-
 2 files changed, 7 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Screens/Menu/IntroScreen.cs b/osu.Game/Screens/Menu/IntroScreen.cs
index e02066560d..159340a4d7 100644
--- a/osu.Game/Screens/Menu/IntroScreen.cs
+++ b/osu.Game/Screens/Menu/IntroScreen.cs
@@ -123,11 +123,7 @@ namespace osu.Game.Screens.Menu
                     // this could happen if a user has nuked their files store. for now, reimport to repair this.
                     var import = beatmaps.Import(new ZipArchiveReader(game.Resources.GetStream($"Tracks/{BeatmapFile}"), BeatmapFile)).GetResultSafely();
 
-                    import?.PerformWrite(b =>
-                    {
-                        b.Protected = true;
-                        beatmaps.Update(b);
-                    });
+                    import?.PerformWrite(b => b.Protected = true);
 
                     loadThemedIntro();
                 }
diff --git a/osu.Game/Stores/RealmArchiveModelManager.cs b/osu.Game/Stores/RealmArchiveModelManager.cs
index 00fc5bbb6f..7c6f25055f 100644
--- a/osu.Game/Stores/RealmArchiveModelManager.cs
+++ b/osu.Game/Stores/RealmArchiveModelManager.cs
@@ -202,8 +202,13 @@ namespace osu.Game.Stores
 
         public abstract bool IsAvailableLocally(TModel model);
 
-        public void Update(TModel skin)
+        public void Update(TModel model)
         {
+            using (var realm = ContextFactory.CreateContext())
+            {
+                var existing = realm.Find<TModel>(model.ID);
+                realm.Write(r => model.CopyChangesToRealm(existing));
+            }
         }
     }
 }

From f986c3ebd4b0728164e7ad6abf665109e1e4c372 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 11 Jan 2022 18:23:04 +0900
Subject: [PATCH 2124/5547] Add basic write support via automapper

---
 osu.Game/Database/RealmObjectExtensions.cs | 36 ++++++++++++++++++++--
 1 file changed, 34 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Database/RealmObjectExtensions.cs b/osu.Game/Database/RealmObjectExtensions.cs
index 9827ca6edd..180e372eba 100644
--- a/osu.Game/Database/RealmObjectExtensions.cs
+++ b/osu.Game/Database/RealmObjectExtensions.cs
@@ -19,7 +19,33 @@ namespace osu.Game.Database
 {
     public static class RealmObjectExtensions
     {
-        private static readonly IMapper mapper = new MapperConfiguration(c =>
+        private static readonly IMapper write_mapper = new MapperConfiguration(c =>
+        {
+            c.ShouldMapField = fi => false;
+            // If we want to limit this further, we can avoid mapping properties with no setter that are not IList<>.
+            // Takes a bit of effort to determine whether this is the case though, see https://stackoverflow.com/questions/951536/how-do-i-tell-whether-a-type-implements-ilist
+            c.ShouldMapProperty = pi => pi.SetMethod?.IsPublic == true;
+
+            c.CreateMap<RealmKeyBinding, RealmKeyBinding>();
+            c.CreateMap<BeatmapMetadata, BeatmapMetadata>();
+            c.CreateMap<BeatmapDifficulty, BeatmapDifficulty>();
+            c.CreateMap<RulesetInfo, RulesetInfo>();
+            c.CreateMap<ScoreInfo, ScoreInfo>();
+            c.CreateMap<RealmUser, RealmUser>();
+            c.CreateMap<RealmFile, RealmFile>();
+            c.CreateMap<RealmNamedFileUsage, RealmNamedFileUsage>();
+            c.CreateMap<BeatmapInfo, BeatmapInfo>();
+            c.CreateMap<BeatmapSetInfo, BeatmapSetInfo>();
+            c.AddGlobalIgnore(nameof(RealmObjectBase.ObjectSchema));
+
+            c.ForAllMaps((a, b) =>
+            {
+                b.PreserveReferences();
+                b.MaxDepth(2);
+            });
+        }).CreateMapper();
+
+        private static readonly IMapper read_mapper = new MapperConfiguration(c =>
         {
             c.ShouldMapField = fi => false;
             // If we want to limit this further, we can avoid mapping properties with no setter that are not IList<>.
@@ -36,6 +62,7 @@ namespace osu.Game.Database
             c.CreateMap<RealmNamedFileUsage, RealmNamedFileUsage>();
             c.CreateMap<BeatmapInfo, BeatmapInfo>();
             c.CreateMap<BeatmapSetInfo, BeatmapSetInfo>();
+            c.AddGlobalIgnore(nameof(RealmObjectBase.ObjectSchema));
 
             c.ForAllMaps((a, b) =>
             {
@@ -77,7 +104,12 @@ namespace osu.Game.Database
             if (!item.IsManaged)
                 return item;
 
-            return mapper.Map<T>(item);
+            return read_mapper.Map<T>(item);
+        }
+
+        public static void CopyChangesToRealm<T>(this T source, T destination) where T : RealmObjectBase
+        {
+            write_mapper.Map(source, destination);
         }
 
         public static List<ILive<T>> ToLiveUnmanaged<T>(this IEnumerable<T> realmList)

From b7ee6d186630be137d02074cb02bd24d7cadf012 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 11 Jan 2022 18:33:35 +0900
Subject: [PATCH 2125/5547] Add protections against test null refs when beatmap
 load fails

---
 .../Visual/Background/TestSceneUserDimBackgrounds.cs           | 3 +++
 osu.Game/Tests/Visual/TestPlayer.cs                            | 3 +++
 2 files changed, 6 insertions(+)

diff --git a/osu.Game.Tests/Visual/Background/TestSceneUserDimBackgrounds.cs b/osu.Game.Tests/Visual/Background/TestSceneUserDimBackgrounds.cs
index b1f642b909..f27043e5cb 100644
--- a/osu.Game.Tests/Visual/Background/TestSceneUserDimBackgrounds.cs
+++ b/osu.Game.Tests/Visual/Background/TestSceneUserDimBackgrounds.cs
@@ -389,6 +389,9 @@ namespace osu.Game.Tests.Visual.Background
                 while (BlockLoad && !token.IsCancellationRequested)
                     Thread.Sleep(1);
 
+                if (!LoadedBeatmapSuccessfully)
+                    return;
+
                 StoryboardEnabled = config.GetBindable<bool>(OsuSetting.ShowStoryboard);
                 DrawableRuleset.IsPaused.BindTo(IsPaused);
             }
diff --git a/osu.Game/Tests/Visual/TestPlayer.cs b/osu.Game/Tests/Visual/TestPlayer.cs
index d68984b144..368f792e28 100644
--- a/osu.Game/Tests/Visual/TestPlayer.cs
+++ b/osu.Game/Tests/Visual/TestPlayer.cs
@@ -94,6 +94,9 @@ namespace osu.Game.Tests.Visual
         [BackgroundDependencyLoader]
         private void load()
         {
+            if (!LoadedBeatmapSuccessfully)
+                return;
+
             ScoreProcessor.NewJudgement += r => Results.Add(r);
         }
     }

From 7dba3c35513d95d5089502f0a81d29a94f8be602 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 11 Jan 2022 19:25:50 +0900
Subject: [PATCH 2126/5547] Fix most remaining test issues

---
 .../Visual/Background/TestSceneUserDimBackgrounds.cs          | 1 +
 osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs       | 1 +
 osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs | 2 +-
 osu.Game/Screens/Menu/IntroScreen.cs                          | 2 +-
 osu.Game/Screens/Select/BeatmapCarousel.cs                    | 4 ----
 osu.Game/Stores/RealmArchiveModelManager.cs                   | 2 +-
 6 files changed, 5 insertions(+), 7 deletions(-)

diff --git a/osu.Game.Tests/Visual/Background/TestSceneUserDimBackgrounds.cs b/osu.Game.Tests/Visual/Background/TestSceneUserDimBackgrounds.cs
index f27043e5cb..3109fd1540 100644
--- a/osu.Game.Tests/Visual/Background/TestSceneUserDimBackgrounds.cs
+++ b/osu.Game.Tests/Visual/Background/TestSceneUserDimBackgrounds.cs
@@ -50,6 +50,7 @@ namespace osu.Game.Tests.Visual.Background
             Dependencies.Cache(rulesets = new RulesetStore(ContextFactory));
             Dependencies.Cache(manager = new BeatmapManager(LocalStorage, ContextFactory, rulesets, null, audio, Resources, host, Beatmap.Default));
             Dependencies.Cache(new OsuConfigManager(LocalStorage));
+            Dependencies.Cache(ContextFactory);
 
             manager.Import(TestResources.GetQuickTestBeatmapForImport()).WaitSafely();
 
diff --git a/osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs b/osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs
index dc826701d2..d4282ff21e 100644
--- a/osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs
@@ -49,6 +49,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             Dependencies.Cache(rulesets = new RulesetStore(ContextFactory));
             Dependencies.Cache(beatmaps = new BeatmapManager(LocalStorage, ContextFactory, rulesets, null, audio, Resources, host, Beatmap.Default));
+            Dependencies.Cache(ContextFactory);
         }
 
         public override void SetUpSteps()
diff --git a/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs b/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs
index 1fa5d15eb3..1f77b1d383 100644
--- a/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs
+++ b/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs
@@ -90,7 +90,7 @@ namespace osu.Game.Online.Rooms
 
         private void updateAvailability()
         {
-            if (downloadTracker == null)
+            if (downloadTracker == null || SelectedItem.Value == null)
                 return;
 
             switch (downloadTracker.State.Value)
diff --git a/osu.Game/Screens/Menu/IntroScreen.cs b/osu.Game/Screens/Menu/IntroScreen.cs
index 159340a4d7..afc5812039 100644
--- a/osu.Game/Screens/Menu/IntroScreen.cs
+++ b/osu.Game/Screens/Menu/IntroScreen.cs
@@ -223,7 +223,7 @@ namespace osu.Game.Screens.Menu
             if (!resuming)
             {
                 beatmap.Value = initialBeatmap;
-                Track = initialBeatmap.Track;
+                Track = beatmap.Value.Track;
 
                 // ensure the track starts at maximum volume
                 musicController.CurrentTrack.FinishTransforms();
diff --git a/osu.Game/Screens/Select/BeatmapCarousel.cs b/osu.Game/Screens/Select/BeatmapCarousel.cs
index f1ad7db9b5..b002b31c9e 100644
--- a/osu.Game/Screens/Select/BeatmapCarousel.cs
+++ b/osu.Game/Screens/Select/BeatmapCarousel.cs
@@ -676,10 +676,6 @@ namespace osu.Game.Screens.Select
             if (beatmapSet?.IsManaged == true)
                 beatmapSet = beatmapSet.Detach();
 
-            // todo: probably not required any more.
-            // foreach (var b in beatmapSet.Beatmaps)
-            //     b.Metadata ??= beatmapSet.Metadata;
-
             var set = new CarouselBeatmapSet(beatmapSet)
             {
                 GetRecommendedBeatmap = beatmaps => GetRecommendedBeatmap?.Invoke(beatmaps)
diff --git a/osu.Game/Stores/RealmArchiveModelManager.cs b/osu.Game/Stores/RealmArchiveModelManager.cs
index 7c6f25055f..3783b10a8c 100644
--- a/osu.Game/Stores/RealmArchiveModelManager.cs
+++ b/osu.Game/Stores/RealmArchiveModelManager.cs
@@ -34,7 +34,7 @@ namespace osu.Game.Stores
         }
 
         public void DeleteFile(TModel item, RealmNamedFileUsage file) =>
-            performFileOperation(item, managed => DeleteFile(managed, file, managed.Realm));
+            performFileOperation(item, managed => DeleteFile(managed, managed.Files.First(f => f.Filename == file.Filename), managed.Realm));
 
         public void ReplaceFile(TModel item, RealmNamedFileUsage file, Stream contents) =>
             performFileOperation(item, managed => ReplaceFile(file, contents, managed.Realm));

From e8dcbaf29ada1f918b57be38d24f1f273d9ea083 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 11 Jan 2022 21:32:01 +0900
Subject: [PATCH 2127/5547] Fix intro screen hitting null reference if intro
 beatmap is unavailable

---
 osu.Game/Overlays/MusicController.cs |  7 ++++---
 osu.Game/Screens/Menu/IntroScreen.cs | 18 +++++-------------
 2 files changed, 9 insertions(+), 16 deletions(-)

diff --git a/osu.Game/Overlays/MusicController.cs b/osu.Game/Overlays/MusicController.cs
index 2731096a00..2497f549b3 100644
--- a/osu.Game/Overlays/MusicController.cs
+++ b/osu.Game/Overlays/MusicController.cs
@@ -284,11 +284,12 @@ namespace osu.Game.Overlays
 
             queuedDirection = TrackChangeDirection.Next;
 
-            var playable = BeatmapSets.SkipWhile(i => i.ID != current.BeatmapSetInfo.ID).ElementAtOrDefault(1) ?? BeatmapSets.FirstOrDefault();
+            var playableSet = BeatmapSets.SkipWhile(i => i.ID != current.BeatmapSetInfo.ID).ElementAtOrDefault(1) ?? BeatmapSets.FirstOrDefault();
+            var playableBeatmap = playableSet?.Beatmaps?.FirstOrDefault();
 
-            if (playable != null)
+            if (playableBeatmap != null)
             {
-                changeBeatmap(beatmaps.GetWorkingBeatmap(playable.Beatmaps.First()));
+                changeBeatmap(beatmaps.GetWorkingBeatmap(playableBeatmap));
                 restartTrack();
                 return true;
             }
diff --git a/osu.Game/Screens/Menu/IntroScreen.cs b/osu.Game/Screens/Menu/IntroScreen.cs
index afc5812039..09a9f44558 100644
--- a/osu.Game/Screens/Menu/IntroScreen.cs
+++ b/osu.Game/Screens/Menu/IntroScreen.cs
@@ -141,24 +141,13 @@ namespace osu.Game.Screens.Menu
                     if (s.Beatmaps.Count == 0)
                         return;
 
-                    initialBeatmap = beatmaps.GetWorkingBeatmap(s.Beatmaps[0].ToLive(realmContextFactory));
+                    initialBeatmap = beatmaps.GetWorkingBeatmap(s.Beatmaps.First());
                 });
 
                 return UsingThemedIntro = initialBeatmap != null;
             }
         }
 
-        protected override void LoadComplete()
-        {
-            base.LoadComplete();
-
-            // TODO: This is temporary to get the setInfo on the update thread, to make things work "better" without using ILive everywhere.
-            var setInfo = beatmaps.QueryBeatmapSets(b => b.Hash == BeatmapHash).FirstOrDefault();
-
-            if (setInfo?.Value.Beatmaps.Count > 0)
-                initialBeatmap = beatmaps.GetWorkingBeatmap(setInfo.Value.Beatmaps.First());
-        }
-
         public override void OnResuming(IScreen last)
         {
             this.FadeIn(300);
@@ -222,7 +211,10 @@ namespace osu.Game.Screens.Menu
 
             if (!resuming)
             {
-                beatmap.Value = initialBeatmap;
+                // generally this can never be null
+                // an exception is running ruleset tests, where the osu! ruleset may not be prsent (causing importing the intro to fail).
+                if (initialBeatmap != null)
+                    beatmap.Value = initialBeatmap;
                 Track = beatmap.Value.Track;
 
                 // ensure the track starts at maximum volume

From c06b5951fd159a63b20a36be2367eb119a84f0b8 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 11 Jan 2022 21:36:34 +0900
Subject: [PATCH 2128/5547] Fix multiple remaining warnings

---
 osu.Game/Beatmaps/BeatmapManager.cs      | 9 +++++++--
 osu.Game/Beatmaps/WorkingBeatmapCache.cs | 8 ++++----
 2 files changed, 11 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index c869fd1bad..36dcd4f8e8 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -43,11 +43,17 @@ namespace osu.Game.Beatmaps
 
         private readonly RealmContextFactory contextFactory;
 
-        public BeatmapManager(Storage storage, RealmContextFactory contextFactory, RulesetStore rulesets, IAPIProvider api, AudioManager audioManager, IResourceStore<byte[]> gameResources, GameHost? host = null, WorkingBeatmap? defaultBeatmap = null, bool performOnlineLookups = false)
+        public BeatmapManager(Storage storage, RealmContextFactory contextFactory, RulesetStore rulesets, IAPIProvider? api, AudioManager audioManager, IResourceStore<byte[]> gameResources, GameHost? host = null, WorkingBeatmap? defaultBeatmap = null, bool performOnlineLookups = false)
         {
             this.contextFactory = contextFactory;
+
             if (performOnlineLookups)
+            {
+                if (api == null)
+                    throw new ArgumentNullException(nameof(api), "API must be provided if online lookups are required.");
+
                 onlineBeatmapLookupQueue = new BeatmapOnlineLookupQueue(api, storage);
+            }
 
             var userResources = new RealmFileStore(contextFactory, storage).Store;
 
@@ -56,7 +62,6 @@ namespace osu.Game.Beatmaps
             beatmapModelManager = CreateBeatmapModelManager(storage, contextFactory, rulesets, onlineBeatmapLookupQueue);
             workingBeatmapCache = CreateWorkingBeatmapCache(audioManager, gameResources, userResources, defaultBeatmap, host);
 
-            workingBeatmapCache.BeatmapManager = beatmapModelManager;
             beatmapModelManager.WorkingBeatmapCache = workingBeatmapCache;
         }
 
diff --git a/osu.Game/Beatmaps/WorkingBeatmapCache.cs b/osu.Game/Beatmaps/WorkingBeatmapCache.cs
index f4324dcc81..e1399c5272 100644
--- a/osu.Game/Beatmaps/WorkingBeatmapCache.cs
+++ b/osu.Game/Beatmaps/WorkingBeatmapCache.cs
@@ -31,8 +31,6 @@ namespace osu.Game.Beatmaps
         /// </summary>
         public readonly WorkingBeatmap DefaultBeatmap;
 
-        public BeatmapModelManager BeatmapManager { private get; set; }
-
         private readonly AudioManager audioManager;
         private readonly IResourceStore<byte[]> resources;
         private readonly LargeTextureStore largeTextureStore;
@@ -87,8 +85,7 @@ namespace osu.Game.Beatmaps
                     return working;
 
                 // TODO: FUCK THE WORLD :D
-                if (beatmapInfo?.IsManaged == true)
-                    beatmapInfo = beatmapInfo.Detach();
+                beatmapInfo = beatmapInfo.Detach();
 
                 workingCache.Add(working = new BeatmapManagerWorkingBeatmap(beatmapInfo, this));
 
@@ -193,6 +190,9 @@ namespace osu.Game.Beatmaps
             {
                 Storyboard storyboard;
 
+                if (BeatmapInfo.Path == null)
+                    return new Storyboard();
+
                 try
                 {
                     using (var stream = new LineBufferedReader(GetStream(BeatmapSetInfo.GetPathForFile(BeatmapInfo.Path))))

From 9beabad6a4c98898bae646683b63f07d13b5cf51 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 11 Jan 2022 21:41:10 +0900
Subject: [PATCH 2129/5547] Remove hide/restore event flow

---
 osu.Game/Beatmaps/BeatmapManager.cs | 14 --------------
 1 file changed, 14 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index 36dcd4f8e8..15dc0c9b61 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -113,16 +113,6 @@ namespace osu.Game.Beatmaps
             return imported.PerformRead(s => GetWorkingBeatmap(s.Beatmaps.First()));
         }
 
-        /// <summary>
-        /// Fired when a single difficulty has been hidden.
-        /// </summary>
-        public event Action<BeatmapInfo>? BeatmapHidden;
-
-        /// <summary>
-        /// Fired when a single difficulty has been restored.
-        /// </summary>
-        public event Action<BeatmapInfo>? BeatmapRestored;
-
         /// <summary>
         /// Delete a beatmap difficulty.
         /// </summary>
@@ -134,8 +124,6 @@ namespace osu.Game.Beatmaps
             {
                 beatmapInfo.Hidden = true;
                 transaction.Commit();
-
-                BeatmapHidden?.Invoke(beatmapInfo);
             }
         }
 
@@ -150,8 +138,6 @@ namespace osu.Game.Beatmaps
             {
                 beatmapInfo.Hidden = false;
                 transaction.Commit();
-
-                BeatmapRestored?.Invoke(beatmapInfo);
             }
         }
 

From 46e92c3b601a59d34c85275c74e9af347dd7f3a4 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 11 Jan 2022 21:44:18 +0900
Subject: [PATCH 2130/5547] Clean up `BeatmapManager` query methods

---
 osu.Game/Beatmaps/BeatmapManager.cs  | 17 -----------------
 osu.Game/Screens/Menu/IntroScreen.cs |  2 +-
 2 files changed, 1 insertion(+), 18 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index 15dc0c9b61..2cdae2b047 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -151,22 +151,6 @@ namespace osu.Game.Beatmaps
                 return context.All<BeatmapSetInfo>().Where(b => !b.DeletePending).Detach();
         }
 
-        /// <summary>
-        /// Perform a lookup query on available <see cref="BeatmapSetInfo"/>s.
-        /// </summary>
-        /// <param name="query">The query.</param>
-        /// <returns>Results from the provided query.</returns>
-        public List<ILive<BeatmapSetInfo>> QueryBeatmapSets(Expression<Func<BeatmapSetInfo, bool>> query)
-        {
-            using (var context = contextFactory.CreateContext())
-            {
-                return context.All<BeatmapSetInfo>()
-                              .Where(b => !b.DeletePending)
-                              .Where(query)
-                              .ToLive(contextFactory);
-            }
-        }
-
         /// <summary>
         /// Perform a lookup query on available <see cref="BeatmapSetInfo"/>s.
         /// </summary>
@@ -197,7 +181,6 @@ namespace osu.Game.Beatmaps
         /// <param name="query">The query.</param>
         /// <returns>The first result for the provided query, or null if no results were found.</returns>
         public BeatmapInfo? QueryBeatmap(Expression<Func<BeatmapInfo, bool>> query) => beatmapModelManager.QueryBeatmap(query)?.Detach();
-        // TODO: move detach to usages?
 
         /// <summary>
         /// Saves an <see cref="IBeatmap"/> file against a given <see cref="BeatmapInfo"/>.
diff --git a/osu.Game/Screens/Menu/IntroScreen.cs b/osu.Game/Screens/Menu/IntroScreen.cs
index 09a9f44558..c4343625ab 100644
--- a/osu.Game/Screens/Menu/IntroScreen.cs
+++ b/osu.Game/Screens/Menu/IntroScreen.cs
@@ -131,7 +131,7 @@ namespace osu.Game.Screens.Menu
 
             bool loadThemedIntro()
             {
-                setInfo = beatmaps.QueryBeatmapSets(b => b.Hash == BeatmapHash).FirstOrDefault();
+                setInfo = beatmaps.QueryBeatmapSet(b => b.Hash == BeatmapHash);
 
                 if (setInfo == null)
                     return false;

From bf4133021b590c43a142ca9555bc3dbc0982c7e8 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 11 Jan 2022 22:05:02 +0900
Subject: [PATCH 2131/5547] Update migration test to use realm file as test

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

diff --git a/osu.Game.Tests/NonVisual/CustomDataDirectoryTest.cs b/osu.Game.Tests/NonVisual/CustomDataDirectoryTest.cs
index 4bb54f1625..61ef31e07e 100644
--- a/osu.Game.Tests/NonVisual/CustomDataDirectoryTest.cs
+++ b/osu.Game.Tests/NonVisual/CustomDataDirectoryTest.cs
@@ -179,7 +179,7 @@ namespace osu.Game.Tests.NonVisual
                 {
                     var osu = LoadOsuIntoHost(host);
 
-                    const string database_filename = "client.db";
+                    const string database_filename = "client.realm";
 
                     Assert.DoesNotThrow(() => osu.Migrate(customPath));
                     Assert.That(File.Exists(Path.Combine(customPath, database_filename)));

From e0c59f4b3ccccb57f7d28488884668de479c7366 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 11 Jan 2022 22:16:06 +0900
Subject: [PATCH 2132/5547] Localise EF context factory usage to migration only

---
 .../Visual/Navigation/TestSceneOsuGame.cs     |  2 -
 osu.Game/Database/DatabaseContextFactory.cs   |  6 +--
 osu.Game/OsuGameBase.cs                       | 40 +++----------------
 3 files changed, 9 insertions(+), 39 deletions(-)

diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneOsuGame.cs b/osu.Game.Tests/Visual/Navigation/TestSceneOsuGame.cs
index e17e4a88da..b8d1636ea0 100644
--- a/osu.Game.Tests/Visual/Navigation/TestSceneOsuGame.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneOsuGame.cs
@@ -12,7 +12,6 @@ using osu.Framework.Platform;
 using osu.Game.Audio;
 using osu.Game.Beatmaps;
 using osu.Game.Configuration;
-using osu.Game.Database;
 using osu.Game.Graphics;
 using osu.Game.Input;
 using osu.Game.Input.Bindings;
@@ -57,7 +56,6 @@ namespace osu.Game.Tests.Visual.Navigation
         private IReadOnlyList<Type> requiredGameBaseDependencies => new[]
         {
             typeof(OsuGameBase),
-            typeof(DatabaseContextFactory),
             typeof(Bindable<RulesetInfo>),
             typeof(IBindable<RulesetInfo>),
             typeof(Bindable<IReadOnlyList<Mod>>),
diff --git a/osu.Game/Database/DatabaseContextFactory.cs b/osu.Game/Database/DatabaseContextFactory.cs
index 94fa967d72..f79505d7c5 100644
--- a/osu.Game/Database/DatabaseContextFactory.cs
+++ b/osu.Game/Database/DatabaseContextFactory.cs
@@ -13,7 +13,7 @@ namespace osu.Game.Database
     {
         private readonly Storage storage;
 
-        private const string database_name = @"client.db";
+        public const string DATABASE_NAME = @"client.db";
 
         private ThreadLocal<OsuDbContext> threadContexts;
 
@@ -139,7 +139,7 @@ namespace osu.Game.Database
             threadContexts = new ThreadLocal<OsuDbContext>(CreateContext, true);
         }
 
-        protected virtual OsuDbContext CreateContext() => new OsuDbContext(CreateDatabaseConnectionString(database_name, storage))
+        protected virtual OsuDbContext CreateContext() => new OsuDbContext(CreateDatabaseConnectionString(DATABASE_NAME, storage))
         {
             Database = { AutoTransactionsEnabled = false }
         };
@@ -152,7 +152,7 @@ namespace osu.Game.Database
 
                 try
                 {
-                    storage.Delete(database_name);
+                    storage.Delete(DATABASE_NAME);
                 }
                 catch
                 {
diff --git a/osu.Game/OsuGameBase.cs b/osu.Game/OsuGameBase.cs
index d18ae6d2d8..a003c6b8ab 100644
--- a/osu.Game/OsuGameBase.cs
+++ b/osu.Game/OsuGameBase.cs
@@ -149,8 +149,6 @@ namespace osu.Game
 
         private MultiplayerClient multiplayerClient;
 
-        private DatabaseContextFactory contextFactory;
-
         private RealmContextFactory realmFactory;
 
         protected override Container<Drawable> Content => content;
@@ -186,13 +184,13 @@ namespace osu.Game
 
             Resources.AddStore(new DllResourceStore(OsuResources.ResourceAssembly));
 
-            dependencies.Cache(contextFactory = new DatabaseContextFactory(Storage));
+            DatabaseContextFactory efContextFactory = Storage.Exists(DatabaseContextFactory.DATABASE_NAME)
+                ? new DatabaseContextFactory(Storage)
+                : null;
 
-            runMigrations();
-
-            dependencies.Cache(realmFactory = new RealmContextFactory(Storage, "client", contextFactory));
-
-            new EFToRealmMigrator(contextFactory, realmFactory, LocalConfig).Run();
+            dependencies.Cache(realmFactory = new RealmContextFactory(Storage, "client", efContextFactory));
+            if (efContextFactory != null)
+                new EFToRealmMigrator(efContextFactory, realmFactory, LocalConfig).Run();
 
             dependencies.CacheAs(Storage);
 
@@ -397,7 +395,6 @@ namespace osu.Game
                 Scheduler.Add(() =>
                 {
                     realmBlocker = realmFactory.BlockAllOperations();
-                    contextFactory.FlushConnections();
 
                     readyToRun.Set();
                 }, false);
@@ -458,29 +455,6 @@ namespace osu.Game
             AvailableMods.Value = dict;
         }
 
-        private void runMigrations()
-        {
-            try
-            {
-                using (var db = contextFactory.GetForWrite(false))
-                    db.Context.Migrate();
-            }
-            catch (Exception e)
-            {
-                Logger.Error(e.InnerException ?? e, "Migration failed! We'll be starting with a fresh database.", LoggingTarget.Database);
-
-                // if we failed, let's delete the database and start fresh.
-                // todo: we probably want a better (non-destructive) migrations/recovery process at a later point than this.
-                contextFactory.ResetDatabase();
-
-                Logger.Log("Database purged successfully.", LoggingTarget.Database);
-
-                // only run once more, then hard bail.
-                using (var db = contextFactory.GetForWrite(false))
-                    db.Context.Migrate();
-            }
-        }
-
         protected override void Dispose(bool isDisposing)
         {
             base.Dispose(isDisposing);
@@ -489,8 +463,6 @@ namespace osu.Game
             BeatmapManager?.Dispose();
             LocalConfig?.Dispose();
 
-            contextFactory?.FlushConnections();
-
             realmFactory?.Dispose();
         }
     }

From d5239d550a0a1952591c5cb57f091cf543eb26e8 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 11 Jan 2022 22:55:00 +0900
Subject: [PATCH 2133/5547] Add refetch for non-managed hide/restore attempts

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

diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index 2cdae2b047..b0c7efc9d9 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -122,6 +122,9 @@ namespace osu.Game.Beatmaps
             using (var realm = contextFactory.CreateContext())
             using (var transaction = realm.BeginWrite())
             {
+                if (!beatmapInfo.IsManaged)
+                    beatmapInfo = realm.Find<BeatmapInfo>(beatmapInfo.ID);
+
                 beatmapInfo.Hidden = true;
                 transaction.Commit();
             }
@@ -136,6 +139,9 @@ namespace osu.Game.Beatmaps
             using (var realm = contextFactory.CreateContext())
             using (var transaction = realm.BeginWrite())
             {
+                if (!beatmapInfo.IsManaged)
+                    beatmapInfo = realm.Find<BeatmapInfo>(beatmapInfo.ID);
+
                 beatmapInfo.Hidden = false;
                 transaction.Commit();
             }

From 46206f70d6a158b9f4c540cffef656300c5eb106 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 11 Jan 2022 22:57:47 +0900
Subject: [PATCH 2134/5547] Fix beatmap mass deletion flow

---
 osu.Game/Beatmaps/BeatmapManager.cs                 | 13 +++++++++++++
 .../Sections/Maintenance/GeneralSettings.cs         |  2 +-
 2 files changed, 14 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index b0c7efc9d9..6f5370a55a 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -234,6 +234,19 @@ namespace osu.Game.Beatmaps
             beatmapModelManager.Delete(items, silent);
         }
 
+        public void Delete(Expression<Func<BeatmapSetInfo, bool>>? filter = null, bool silent = false)
+        {
+            using (var context = contextFactory.CreateContext())
+            {
+                var items = context.All<BeatmapSetInfo>().Where(s => !s.DeletePending);
+
+                if (filter != null)
+                    items = items.Where(filter);
+
+                beatmapModelManager.Delete(items.ToList(), silent);
+            }
+        }
+
         public void Undelete(List<BeatmapSetInfo> items, bool silent = false)
         {
             beatmapModelManager.Undelete(items, silent);
diff --git a/osu.Game/Overlays/Settings/Sections/Maintenance/GeneralSettings.cs b/osu.Game/Overlays/Settings/Sections/Maintenance/GeneralSettings.cs
index 93884812fe..736ba04e51 100644
--- a/osu.Game/Overlays/Settings/Sections/Maintenance/GeneralSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Maintenance/GeneralSettings.cs
@@ -54,7 +54,7 @@ namespace osu.Game.Overlays.Settings.Sections.Maintenance
                     dialogOverlay?.Push(new MassDeleteConfirmationDialog(() =>
                     {
                         deleteBeatmapsButton.Enabled.Value = false;
-                        Task.Run(() => beatmaps.Delete(beatmaps.GetAllUsableBeatmapSets())).ContinueWith(t => Schedule(() => deleteBeatmapsButton.Enabled.Value = true));
+                        Task.Run(() => beatmaps.Delete()).ContinueWith(t => Schedule(() => deleteBeatmapsButton.Enabled.Value = true));
                     }));
                 }
             });

From 72656ae01e8cc108b5249538f36331d28c063305 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 11 Jan 2022 23:04:36 +0900
Subject: [PATCH 2135/5547] Fix beatmap restore/undelete flows

---
 osu.Game/Beatmaps/BeatmapManager.cs           | 29 ++++++++++++-------
 .../Sections/Maintenance/GeneralSettings.cs   | 15 ++--------
 2 files changed, 21 insertions(+), 23 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index 6f5370a55a..9b2b7c960d 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -147,6 +147,18 @@ namespace osu.Game.Beatmaps
             }
         }
 
+        public void RestoreAll()
+        {
+            using (var realm = contextFactory.CreateContext())
+            using (var transaction = realm.BeginWrite())
+            {
+                foreach (var beatmap in realm.All<BeatmapInfo>().Where(b => b.Hidden))
+                    beatmap.Hidden = false;
+
+                transaction.Commit();
+            }
+        }
+
         /// <summary>
         /// Returns a list of all usable <see cref="BeatmapSetInfo"/>s.
         /// </summary>
@@ -168,17 +180,6 @@ namespace osu.Game.Beatmaps
                 return context.All<BeatmapSetInfo>().FirstOrDefault(query)?.ToLive(contextFactory);
         }
 
-        /// <summary>
-        /// Perform a lookup query on available <see cref="BeatmapInfo"/>s.
-        /// </summary>
-        /// <param name="query">The query.</param>
-        /// <returns>Results from the provided query.</returns>
-        public IQueryable<BeatmapInfo> QueryBeatmaps(Expression<Func<BeatmapInfo, bool>> query)
-        {
-            using (var context = contextFactory.CreateContext())
-                return context.All<BeatmapInfo>().Where(query);
-        }
-
         #region Delegation to BeatmapModelManager (methods which previously existed locally).
 
         /// <summary>
@@ -247,6 +248,12 @@ namespace osu.Game.Beatmaps
             }
         }
 
+        public void UndeleteAll()
+        {
+            using (var context = contextFactory.CreateContext())
+                beatmapModelManager.Undelete(context.All<BeatmapSetInfo>().Where(s => s.DeletePending).ToList());
+        }
+
         public void Undelete(List<BeatmapSetInfo> items, bool silent = false)
         {
             beatmapModelManager.Undelete(items, silent);
diff --git a/osu.Game/Overlays/Settings/Sections/Maintenance/GeneralSettings.cs b/osu.Game/Overlays/Settings/Sections/Maintenance/GeneralSettings.cs
index 736ba04e51..aa02d086f4 100644
--- a/osu.Game/Overlays/Settings/Sections/Maintenance/GeneralSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Maintenance/GeneralSettings.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 System.Threading.Tasks;
 using JetBrains.Annotations;
 using osu.Framework.Allocation;
@@ -106,10 +105,7 @@ namespace osu.Game.Overlays.Settings.Sections.Maintenance
                     dialogOverlay?.Push(new MassDeleteConfirmationDialog(() =>
                     {
                         deleteSkinsButton.Enabled.Value = false;
-                        Task.Run(() =>
-                        {
-                            skins.Delete();
-                        }).ContinueWith(t => Schedule(() => deleteSkinsButton.Enabled.Value = true));
+                        Task.Run(() => skins.Delete()).ContinueWith(t => Schedule(() => deleteSkinsButton.Enabled.Value = true));
                     }));
                 }
             });
@@ -147,11 +143,7 @@ namespace osu.Game.Overlays.Settings.Sections.Maintenance
                     Action = () =>
                     {
                         restoreButton.Enabled.Value = false;
-                        Task.Run(() =>
-                        {
-                            foreach (var b in beatmaps.QueryBeatmaps(b => b.Hidden).ToList())
-                                beatmaps.Restore(b);
-                        }).ContinueWith(t => Schedule(() => restoreButton.Enabled.Value = true));
+                        Task.Run(beatmaps.RestoreAll).ContinueWith(t => Schedule(() => restoreButton.Enabled.Value = true));
                     }
                 },
                 undeleteButton = new SettingsButton
@@ -160,8 +152,7 @@ namespace osu.Game.Overlays.Settings.Sections.Maintenance
                     Action = () =>
                     {
                         undeleteButton.Enabled.Value = false;
-                        // TODO: reimplement similar to SkinManager?
-                        // Task.Run(() => beatmaps.Undelete(beatmaps.QueryBeatmapSets(b => b.DeletePending).ToList())).ContinueWith(t => Schedule(() => undeleteButton.Enabled.Value = true));
+                        Task.Run(beatmaps.UndeleteAll).ContinueWith(t => Schedule(() => undeleteButton.Enabled.Value = true));
                     }
                 },
             });

From 0aff1c232b9581244434410313da2a0d69993557 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 12 Jan 2022 01:03:59 +0900
Subject: [PATCH 2136/5547] Fix deleted/hidden carousel queries

---
 osu.Game/Screens/Select/BeatmapCarousel.cs | 40 ++++++++++++++--------
 1 file changed, 26 insertions(+), 14 deletions(-)

diff --git a/osu.Game/Screens/Select/BeatmapCarousel.cs b/osu.Game/Screens/Select/BeatmapCarousel.cs
index b002b31c9e..f355554482 100644
--- a/osu.Game/Screens/Select/BeatmapCarousel.cs
+++ b/osu.Game/Screens/Select/BeatmapCarousel.cs
@@ -151,7 +151,9 @@ namespace osu.Game.Screens.Select
         private CarouselRoot root;
 
         private IDisposable subscriptionSets;
+        private IDisposable subscriptionDeletedSets;
         private IDisposable subscriptionBeatmaps;
+        private IDisposable subscriptionHiddenBeatmaps;
 
         private readonly DrawablePool<DrawableCarouselBeatmapSet> setPool = new DrawablePool<DrawableCarouselBeatmapSet>(100);
 
@@ -192,6 +194,24 @@ namespace osu.Game.Screens.Select
 
             subscriptionSets = realmFactory.Context.All<BeatmapSetInfo>().Where(s => !s.DeletePending && !s.Protected).QueryAsyncWithNotifications(beatmapSetsChanged);
             subscriptionBeatmaps = realmFactory.Context.All<BeatmapInfo>().Where(b => !b.Hidden).QueryAsyncWithNotifications(beatmapsChanged);
+
+            // Can't use main subscriptions because we can't lookup deleted indices.
+            // https://github.com/realm/realm-dotnet/discussions/2634#discussioncomment-1605595.
+            subscriptionDeletedSets = realmFactory.Context.All<BeatmapSetInfo>().Where(s => s.DeletePending && !s.Protected).QueryAsyncWithNotifications(deletedBeatmapSetsChanged);
+            subscriptionHiddenBeatmaps = realmFactory.Context.All<BeatmapInfo>().Where(b => b.Hidden).QueryAsyncWithNotifications(beatmapsChanged);
+        }
+
+        private void deletedBeatmapSetsChanged(IRealmCollection<BeatmapSetInfo> sender, ChangeSet changes, Exception error)
+        {
+            // If loading test beatmaps, avoid overwriting with realm subscription callbacks.
+            if (loadedTestBeatmaps)
+                return;
+
+            if (changes == null)
+                return;
+
+            foreach (int i in changes.InsertedIndices)
+                RemoveBeatmapSet(sender[i]);
         }
 
         private void beatmapSetsChanged(IRealmCollection<BeatmapSetInfo> sender, ChangeSet changes, Exception error)
@@ -210,16 +230,8 @@ namespace osu.Game.Screens.Select
             foreach (int i in changes.NewModifiedIndices)
                 UpdateBeatmapSet(sender[i]);
 
-            // moves also appear as deletes / inserts but aren't important to us.
-            if (!changes.Moves.Any())
-            {
-                foreach (int i in changes.InsertedIndices)
-                    UpdateBeatmapSet(sender[i]);
-
-                // TODO: This can not work, as we recently found out https://github.com/realm/realm-dotnet/discussions/2634#discussioncomment-1605595.
-                foreach (int i in changes.DeletedIndices)
-                    RemoveBeatmapSet(sender[i]);
-            }
+            foreach (int i in changes.InsertedIndices)
+                UpdateBeatmapSet(sender[i]);
         }
 
         private void beatmapsChanged(IRealmCollection<BeatmapInfo> sender, ChangeSet changes, Exception error)
@@ -228,9 +240,7 @@ namespace osu.Game.Screens.Select
             if (changes == null)
                 return;
 
-            // TODO: we can probably handle hidden items at a per-panel level (ie. start a realm subscription from there)?
-            // might be cleaner than handling via reconstruction of the whole set's panels.
-            foreach (int i in changes.NewModifiedIndices)
+            foreach (int i in changes.InsertedIndices)
                 UpdateBeatmapSet(sender[i].BeatmapSet);
         }
 
@@ -673,7 +683,7 @@ namespace osu.Game.Screens.Select
                 return null;
 
             // TODO: FUCK THE WORLD :D
-            if (beatmapSet?.IsManaged == true)
+            if (beatmapSet.IsManaged)
                 beatmapSet = beatmapSet.Detach();
 
             var set = new CarouselBeatmapSet(beatmapSet)
@@ -930,7 +940,9 @@ namespace osu.Game.Screens.Select
             base.Dispose(isDisposing);
 
             subscriptionSets?.Dispose();
+            subscriptionDeletedSets?.Dispose();
             subscriptionBeatmaps?.Dispose();
+            subscriptionHiddenBeatmaps?.Dispose();
         }
     }
 }

From 157dfdaa825f72ea345a5d4c1463ac9639cba364 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 12 Jan 2022 01:18:11 +0900
Subject: [PATCH 2137/5547] Fix protected beatmap sets getting deleted

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

diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index 9b2b7c960d..21cda18c1a 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -239,7 +239,7 @@ namespace osu.Game.Beatmaps
         {
             using (var context = contextFactory.CreateContext())
             {
-                var items = context.All<BeatmapSetInfo>().Where(s => !s.DeletePending);
+                var items = context.All<BeatmapSetInfo>().Where(s => !s.DeletePending && !s.Protected);
 
                 if (filter != null)
                     items = items.Where(filter);

From 017285b694bc0ed45697f94d376077fdd0f73db1 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 12 Jan 2022 01:18:36 +0900
Subject: [PATCH 2138/5547] Update `MusicController` to handle deletions more
 correctly

---
 osu.Game/Overlays/MusicController.cs | 12 ++++++++----
 1 file changed, 8 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Overlays/MusicController.cs b/osu.Game/Overlays/MusicController.cs
index 2497f549b3..44c2916f12 100644
--- a/osu.Game/Overlays/MusicController.cs
+++ b/osu.Game/Overlays/MusicController.cs
@@ -84,12 +84,16 @@ namespace osu.Game.Overlays
         {
             base.LoadComplete();
 
+            var availableBeatmaps = realmFactory.Context
+                                                .All<BeatmapSetInfo>()
+                                                .Where(s => !s.DeletePending);
+
             // ensure we're ready before completing async load.
             // probably not a good way of handling this (as there is a period we aren't watching for changes until the realm subscription finishes up.
-            foreach (var s in realmFactory.Context.All<BeatmapSetInfo>())
+            foreach (var s in availableBeatmaps)
                 beatmapSets.Add(s);
 
-            beatmapSubscription = realmFactory.Context.All<BeatmapSetInfo>().QueryAsyncWithNotifications(beatmapsChanged);
+            beatmapSubscription = availableBeatmaps.QueryAsyncWithNotifications(beatmapsChanged);
         }
 
         private void beatmapsChanged(IRealmCollection<BeatmapSetInfo> sender, ChangeSet changes, Exception error)
@@ -98,7 +102,7 @@ namespace osu.Game.Overlays
                 return;
 
             foreach (int i in changes.InsertedIndices)
-                beatmapSets.Insert(i, sender[i]);
+                beatmapSets.Insert(i, sender[i].Detach());
 
             foreach (int i in changes.DeletedIndices.OrderByDescending(i => i))
                 beatmapSets.RemoveAt(i);
@@ -285,7 +289,7 @@ namespace osu.Game.Overlays
             queuedDirection = TrackChangeDirection.Next;
 
             var playableSet = BeatmapSets.SkipWhile(i => i.ID != current.BeatmapSetInfo.ID).ElementAtOrDefault(1) ?? BeatmapSets.FirstOrDefault();
-            var playableBeatmap = playableSet?.Beatmaps?.FirstOrDefault();
+            var playableBeatmap = playableSet?.Beatmaps.FirstOrDefault();
 
             if (playableBeatmap != null)
             {

From dc3730f33413b90789a1e8f5e7742b8ac2e627ff Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 12 Jan 2022 01:29:40 +0900
Subject: [PATCH 2139/5547] Fix song select import popup not always showing

---
 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 9ba5e77bbb..41700bec17 100644
--- a/osu.Game/Screens/Select/SongSelect.cs
+++ b/osu.Game/Screens/Select/SongSelect.cs
@@ -295,7 +295,7 @@ namespace osu.Game.Screens.Select
                 Schedule(() =>
                 {
                     // if we have no beatmaps, let's prompt the user to import from over a stable install if he has one.
-                    if (!beatmaps.GetAllUsableBeatmapSets().Any() && DisplayStableImportPrompt)
+                    if (beatmaps.QueryBeatmapSet(s => !s.Protected && !s.DeletePending) == null && DisplayStableImportPrompt)
                     {
                         dialogOverlay.Push(new ImportFromStablePopup(() =>
                         {

From 6db3c32dd1d81bcc774398fa627be04951d84bfe Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 12 Jan 2022 00:32:32 +0300
Subject: [PATCH 2140/5547] Handle automapper realm cyclic references via
 `AfterMap`s

This may not be the cleanest solution, but there don't seem to be any
way towards this either.

- `UseDestinationValue` has been inherited by default as noted in
https://docs.automapper.org/en/stable/10.0-Upgrade-Guide.html#usedestinationvalue-is-now-inherited-by-default, and its behaviour in this case would be using the nested **managed** realm object for the destination member rather than creating an unmanaged version.

- `MaxDepth` already sets `PreserveReferences` so there's no point of using it.

- `MaxDepth` should probably not be set for all maps, only for those with
cyclic references, to avoid the expensive overhead of `PreserveReferences`, as mentioned in https://docs.automapper.org/en/stable/5.0-Upgrade-Guide.html#circular-references.

That aside, `MaxDepth` should actually only be set to `1` for
`BeatmapSetInfo` mapping, because we don't want AutoMapper to create a
nested instance of `BeatmapSetInfo` in each mapped/detached beatmap, but
for some reason, doing that will cause automapper to not map any beatmap
inside the set and leave it with 0 beatmaps.

While on the other hand, using `MaxDepth(2)` for `BeatmapSetInfo` works,
but creates an unused instance of a `BeatmapSetInfo` inside each mapped
beatmap, which may not be ideal.

For `BeatmapInfo`, it has to be `MaxDepth(2)`, in which the first
`BeatmapInfo` depth would be itself (when detaching a beatmap), and the
second would be nested beatmaps inside the mapped/detached
`BeatmapSetInfo` within the beatmap. (note that when detaching a beatmap
set, the unused instance of `BeatmapSetInfo` within each beatmap of that
beatmap set doesn't also have a list of unused beatmaps as one might expect from the depth specification, it surprisingly has 0 beatmaps)

This causes it to create an unused instance of `BeatmapInfo` in the beatmap set resembling the root mapped/detached beatmap, but that one might be inevitable.
---
 osu.Game/Database/RealmObjectExtensions.cs | 44 +++++++++++++++-------
 1 file changed, 30 insertions(+), 14 deletions(-)

diff --git a/osu.Game/Database/RealmObjectExtensions.cs b/osu.Game/Database/RealmObjectExtensions.cs
index 180e372eba..83d23e2fc2 100644
--- a/osu.Game/Database/RealmObjectExtensions.cs
+++ b/osu.Game/Database/RealmObjectExtensions.cs
@@ -34,15 +34,23 @@ namespace osu.Game.Database
             c.CreateMap<RealmUser, RealmUser>();
             c.CreateMap<RealmFile, RealmFile>();
             c.CreateMap<RealmNamedFileUsage, RealmNamedFileUsage>();
-            c.CreateMap<BeatmapInfo, BeatmapInfo>();
-            c.CreateMap<BeatmapSetInfo, BeatmapSetInfo>();
-            c.AddGlobalIgnore(nameof(RealmObjectBase.ObjectSchema));
-
-            c.ForAllMaps((a, b) =>
+            c.CreateMap<BeatmapInfo, BeatmapInfo>().MaxDepth(2).AfterMap((s, d) =>
             {
-                b.PreserveReferences();
-                b.MaxDepth(2);
+                for (int i = 0; i < d.BeatmapSet?.Beatmaps.Count; i++)
+                {
+                    if (d.BeatmapSet.Beatmaps[i].Equals(d))
+                    {
+                        d.BeatmapSet.Beatmaps[i] = d;
+                        break;
+                    }
+                }
             });
+            c.CreateMap<BeatmapSetInfo, BeatmapSetInfo>().MaxDepth(2).AfterMap((s, d) =>
+            {
+                foreach (var beatmap in d.Beatmaps)
+                    beatmap.BeatmapSet = d;
+            });
+            c.AddGlobalIgnore(nameof(RealmObjectBase.ObjectSchema));
         }).CreateMapper();
 
         private static readonly IMapper read_mapper = new MapperConfiguration(c =>
@@ -60,15 +68,23 @@ namespace osu.Game.Database
             c.CreateMap<RealmUser, RealmUser>();
             c.CreateMap<RealmFile, RealmFile>();
             c.CreateMap<RealmNamedFileUsage, RealmNamedFileUsage>();
-            c.CreateMap<BeatmapInfo, BeatmapInfo>();
-            c.CreateMap<BeatmapSetInfo, BeatmapSetInfo>();
-            c.AddGlobalIgnore(nameof(RealmObjectBase.ObjectSchema));
-
-            c.ForAllMaps((a, b) =>
+            c.CreateMap<BeatmapInfo, BeatmapInfo>().MaxDepth(2).AfterMap((s, d) =>
             {
-                b.PreserveReferences();
-                b.MaxDepth(2);
+                for (int i = 0; i < d.BeatmapSet?.Beatmaps.Count; i++)
+                {
+                    if (d.BeatmapSet.Beatmaps[i].Equals(d))
+                    {
+                        d.BeatmapSet.Beatmaps[i] = d;
+                        break;
+                    }
+                }
             });
+            c.CreateMap<BeatmapSetInfo, BeatmapSetInfo>().MaxDepth(2).AfterMap((s, d) =>
+            {
+                foreach (var beatmap in d.Beatmaps)
+                    beatmap.BeatmapSet = d;
+            });
+            c.AddGlobalIgnore(nameof(RealmObjectBase.ObjectSchema));
         }).CreateMapper();
 
         /// <summary>

From 51d6db1bca65a02f1d66675f2e766125364d7f1e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 12 Jan 2022 12:39:40 +0900
Subject: [PATCH 2141/5547] Add equatable support to `IUser` and `RealmUser`

Not sure this will stick, but let's add it for now to make testing
detach support work nicely.
---
 osu.Game/Beatmaps/IBeatmapMetadataInfo.cs |  2 +-
 osu.Game/Models/RealmUser.cs              | 11 ++++++++++-
 osu.Game/Users/IUser.cs                   | 13 ++++++++++++-
 3 files changed, 23 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Beatmaps/IBeatmapMetadataInfo.cs b/osu.Game/Beatmaps/IBeatmapMetadataInfo.cs
index 968ad14928..61adc0ac34 100644
--- a/osu.Game/Beatmaps/IBeatmapMetadataInfo.cs
+++ b/osu.Game/Beatmaps/IBeatmapMetadataInfo.cs
@@ -73,7 +73,7 @@ namespace osu.Game.Beatmaps
                    && TitleUnicode == other.TitleUnicode
                    && Artist == other.Artist
                    && ArtistUnicode == other.ArtistUnicode
-                   && Author == other.Author
+                   && Author.Equals(other.Author)
                    && Source == other.Source
                    && Tags == other.Tags
                    && PreviewTime == other.PreviewTime
diff --git a/osu.Game/Models/RealmUser.cs b/osu.Game/Models/RealmUser.cs
index 154ece502f..ff35528827 100644
--- a/osu.Game/Models/RealmUser.cs
+++ b/osu.Game/Models/RealmUser.cs
@@ -1,17 +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;
 using osu.Game.Users;
 using Realms;
 
 namespace osu.Game.Models
 {
-    public class RealmUser : EmbeddedObject, IUser
+    public class RealmUser : EmbeddedObject, IUser, IEquatable<RealmUser>
     {
         public int OnlineID { get; set; } = 1;
 
         public string Username { get; set; }
 
         public bool IsBot => false;
+
+        public bool Equals(RealmUser other)
+        {
+            if (ReferenceEquals(null, other)) return false;
+            if (ReferenceEquals(this, other)) return true;
+
+            return OnlineID == other.OnlineID && Username == other.Username;
+        }
     }
 }
diff --git a/osu.Game/Users/IUser.cs b/osu.Game/Users/IUser.cs
index 3995531fd9..d9a352872f 100644
--- a/osu.Game/Users/IUser.cs
+++ b/osu.Game/Users/IUser.cs
@@ -1,14 +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 System;
 using osu.Game.Database;
 
+#nullable enable
+
 namespace osu.Game.Users
 {
-    public interface IUser : IHasOnlineID<int>
+    public interface IUser : IHasOnlineID<int>, IEquatable<IUser>
     {
         string Username { get; }
 
         bool IsBot { get; }
+
+        bool IEquatable<IUser>.Equals(IUser? other)
+        {
+            if (other == null)
+                return false;
+
+            return OnlineID == other.OnlineID && Username == other.Username;
+        }
     }
 }

From 509301d94f86aaa3ca4649bf2334417235b32b88 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 12 Jan 2022 12:40:09 +0900
Subject: [PATCH 2142/5547] Update detach test to assert correct behaviour

---
 .../Database/BeatmapImporterTests.cs          | 42 +++++++++----------
 1 file changed, 19 insertions(+), 23 deletions(-)

diff --git a/osu.Game.Tests/Database/BeatmapImporterTests.cs b/osu.Game.Tests/Database/BeatmapImporterTests.cs
index 78b8628669..49f992139c 100644
--- a/osu.Game.Tests/Database/BeatmapImporterTests.cs
+++ b/osu.Game.Tests/Database/BeatmapImporterTests.cs
@@ -43,39 +43,35 @@ namespace osu.Game.Tests.Database
                 using (var importer = new BeatmapModelManager(realmFactory, storage))
                 using (new RulesetStore(realmFactory, storage))
                 {
-                    ILive<BeatmapSetInfo>? imported;
+                    ILive<BeatmapSetInfo>? beatmapSet;
 
                     using (var reader = new ZipArchiveReader(TestResources.GetTestBeatmapStream()))
-                        imported = await importer.Import(reader);
+                        beatmapSet = await importer.Import(reader);
 
-                    Assert.NotNull(imported);
-                    Debug.Assert(imported != null);
+                    Assert.NotNull(beatmapSet);
+                    Debug.Assert(beatmapSet != null);
 
-                    BeatmapSetInfo? detached = null;
+                    BeatmapSetInfo? detachedBeatmapSet = null;
 
-                    imported.PerformRead(live =>
+                    beatmapSet.PerformRead(live =>
                     {
-                        var timer = new Stopwatch();
-                        timer.Start();
-                        detached = live.Detach();
-                        Logger.Log($"Detach took {timer.ElapsedMilliseconds} ms");
+                        detachedBeatmapSet = live.Detach();
 
-                        Logger.Log($"NamedFiles: {live.Files.Count} {detached.Files.Count}");
-                        Logger.Log($"Files: {live.Files.Select(f => f.File).Count()} {detached.Files.Select(f => f.File).Count()}");
-                        Logger.Log($"Difficulties: {live.Beatmaps.Count} {detached.Beatmaps.Count}");
-                        Logger.Log($"BeatmapDifficulties: {live.Beatmaps.Select(f => f.Difficulty).Count()} {detached.Beatmaps.Select(f => f.Difficulty).Count()}");
-                        Logger.Log($"Metadata: {live.Metadata} {detached.Metadata}");
+                        Assert.AreEqual(live.Files.Count, detachedBeatmapSet.Files.Count);
+                        Assert.AreEqual(live.Files.Select(f => f.File).Count(), detachedBeatmapSet.Files.Select(f => f.File).Count());
+                        Assert.AreEqual(live.Beatmaps.Count, detachedBeatmapSet.Beatmaps.Count);
+                        Assert.AreEqual(live.Beatmaps.Select(f => f.Difficulty).Count(), detachedBeatmapSet.Beatmaps.Select(f => f.Difficulty).Count());
+                        Assert.AreEqual(live.Metadata, detachedBeatmapSet.Metadata);
                     });
 
-                    Logger.Log("Testing detached-ness");
+                    Debug.Assert(detachedBeatmapSet != null);
 
-                    Debug.Assert(detached != null);
-
-                    Logger.Log($"NamedFiles: {detached.Files.Count}");
-                    Logger.Log($"Files: {detached.Files.Select(f => f.File).Count()}");
-                    Logger.Log($"Difficulties: {detached.Beatmaps.Count}");
-                    Logger.Log($"BeatmapDifficulties: {detached.Beatmaps.Select(f => f.Difficulty).Count()}");
-                    Logger.Log($"Metadata: {detached.Metadata}");
+                    // Check detached instances can all be accessed without throwing.
+                    Assert.NotNull(detachedBeatmapSet.Files.Count);
+                    Assert.NotZero(detachedBeatmapSet.Files.Select(f => f.File).Count());
+                    Assert.NotNull(detachedBeatmapSet.Beatmaps.Count);
+                    Assert.NotZero(detachedBeatmapSet.Beatmaps.Select(f => f.Difficulty).Count());
+                    Assert.NotNull(detachedBeatmapSet.Metadata);
                 }
             });
         }

From c92aff8d2b3ef101358943367bb8806f950ae3c1 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 12 Jan 2022 12:42:45 +0900
Subject: [PATCH 2143/5547] Add test of cyclic beatmap/beatmapset references

---
 osu.Game.Tests/Database/BeatmapImporterTests.cs | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Database/BeatmapImporterTests.cs b/osu.Game.Tests/Database/BeatmapImporterTests.cs
index 49f992139c..a4dd341226 100644
--- a/osu.Game.Tests/Database/BeatmapImporterTests.cs
+++ b/osu.Game.Tests/Database/BeatmapImporterTests.cs
@@ -36,7 +36,7 @@ namespace osu.Game.Tests.Database
     public class BeatmapImporterTests : RealmTest
     {
         [Test]
-        public void TestDetach()
+        public void TestDetachBeatmapSet()
         {
             RunTestWithRealmAsync(async (realmFactory, storage) =>
             {
@@ -71,7 +71,11 @@ namespace osu.Game.Tests.Database
                     Assert.NotZero(detachedBeatmapSet.Files.Select(f => f.File).Count());
                     Assert.NotNull(detachedBeatmapSet.Beatmaps.Count);
                     Assert.NotZero(detachedBeatmapSet.Beatmaps.Select(f => f.Difficulty).Count());
+                    Assert.NotNull(detachedBeatmapSet.Beatmaps.First().Path);
                     Assert.NotNull(detachedBeatmapSet.Metadata);
+
+                    // Check cyclic reference to beatmap set
+                    Assert.AreEqual(detachedBeatmapSet, detachedBeatmapSet.Beatmaps.First().BeatmapSet);
                 }
             });
         }

From 580ad03f8d66492f7cd0382dbb372a77e14b1247 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 12 Jan 2022 12:56:28 +0900
Subject: [PATCH 2144/5547] Combine mapper configurations and add more
 explanation about special cases

---
 osu.Game/Database/RealmObjectExtensions.cs | 41 +++-------------------
 1 file changed, 4 insertions(+), 37 deletions(-)

diff --git a/osu.Game/Database/RealmObjectExtensions.cs b/osu.Game/Database/RealmObjectExtensions.cs
index 83d23e2fc2..a5e5962a04 100644
--- a/osu.Game/Database/RealmObjectExtensions.cs
+++ b/osu.Game/Database/RealmObjectExtensions.cs
@@ -19,43 +19,11 @@ namespace osu.Game.Database
 {
     public static class RealmObjectExtensions
     {
-        private static readonly IMapper write_mapper = new MapperConfiguration(c =>
+        private static readonly IMapper mapper = new MapperConfiguration(c =>
         {
             c.ShouldMapField = fi => false;
-            // If we want to limit this further, we can avoid mapping properties with no setter that are not IList<>.
-            // Takes a bit of effort to determine whether this is the case though, see https://stackoverflow.com/questions/951536/how-do-i-tell-whether-a-type-implements-ilist
-            c.ShouldMapProperty = pi => pi.SetMethod?.IsPublic == true;
 
-            c.CreateMap<RealmKeyBinding, RealmKeyBinding>();
-            c.CreateMap<BeatmapMetadata, BeatmapMetadata>();
-            c.CreateMap<BeatmapDifficulty, BeatmapDifficulty>();
-            c.CreateMap<RulesetInfo, RulesetInfo>();
-            c.CreateMap<ScoreInfo, ScoreInfo>();
-            c.CreateMap<RealmUser, RealmUser>();
-            c.CreateMap<RealmFile, RealmFile>();
-            c.CreateMap<RealmNamedFileUsage, RealmNamedFileUsage>();
-            c.CreateMap<BeatmapInfo, BeatmapInfo>().MaxDepth(2).AfterMap((s, d) =>
-            {
-                for (int i = 0; i < d.BeatmapSet?.Beatmaps.Count; i++)
-                {
-                    if (d.BeatmapSet.Beatmaps[i].Equals(d))
-                    {
-                        d.BeatmapSet.Beatmaps[i] = d;
-                        break;
-                    }
-                }
-            });
-            c.CreateMap<BeatmapSetInfo, BeatmapSetInfo>().MaxDepth(2).AfterMap((s, d) =>
-            {
-                foreach (var beatmap in d.Beatmaps)
-                    beatmap.BeatmapSet = d;
-            });
-            c.AddGlobalIgnore(nameof(RealmObjectBase.ObjectSchema));
-        }).CreateMapper();
-
-        private static readonly IMapper read_mapper = new MapperConfiguration(c =>
-        {
-            c.ShouldMapField = fi => false;
+            // This is specifically to avoid mapping explicit interface implementations.
             // If we want to limit this further, we can avoid mapping properties with no setter that are not IList<>.
             // Takes a bit of effort to determine whether this is the case though, see https://stackoverflow.com/questions/951536/how-do-i-tell-whether-a-type-implements-ilist
             c.ShouldMapProperty = pi => pi.GetMethod?.IsPublic == true;
@@ -84,7 +52,6 @@ namespace osu.Game.Database
                 foreach (var beatmap in d.Beatmaps)
                     beatmap.BeatmapSet = d;
             });
-            c.AddGlobalIgnore(nameof(RealmObjectBase.ObjectSchema));
         }).CreateMapper();
 
         /// <summary>
@@ -120,12 +87,12 @@ namespace osu.Game.Database
             if (!item.IsManaged)
                 return item;
 
-            return read_mapper.Map<T>(item);
+            return mapper.Map<T>(item);
         }
 
         public static void CopyChangesToRealm<T>(this T source, T destination) where T : RealmObjectBase
         {
-            write_mapper.Map(source, destination);
+            mapper.Map(source, destination);
         }
 
         public static List<ILive<T>> ToLiveUnmanaged<T>(this IEnumerable<T> realmList)

From a307f7e90eb5cbf050b0fc0a2dff9f860a51c1c3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 12 Jan 2022 12:56:42 +0900
Subject: [PATCH 2145/5547] Add test coverage of updating via copying changes
 from detached instance

---
 .../Database/BeatmapImporterTests.cs          | 42 +++++++++++++++++++
 1 file changed, 42 insertions(+)

diff --git a/osu.Game.Tests/Database/BeatmapImporterTests.cs b/osu.Game.Tests/Database/BeatmapImporterTests.cs
index a4dd341226..0644313bf9 100644
--- a/osu.Game.Tests/Database/BeatmapImporterTests.cs
+++ b/osu.Game.Tests/Database/BeatmapImporterTests.cs
@@ -80,6 +80,48 @@ namespace osu.Game.Tests.Database
             });
         }
 
+        [Test]
+        public void TestUpdateDetachedBeatmapSet()
+        {
+            RunTestWithRealmAsync(async (realmFactory, storage) =>
+            {
+                using (var importer = new BeatmapModelManager(realmFactory, storage))
+                using (new RulesetStore(realmFactory, storage))
+                {
+                    ILive<BeatmapSetInfo>? beatmapSet;
+
+                    using (var reader = new ZipArchiveReader(TestResources.GetTestBeatmapStream()))
+                        beatmapSet = await importer.Import(reader);
+
+                    Assert.NotNull(beatmapSet);
+                    Debug.Assert(beatmapSet != null);
+
+                    BeatmapSetInfo? detachedBeatmapSet = null;
+
+                    beatmapSet.PerformRead(s => detachedBeatmapSet = s.Detach());
+
+                    Debug.Assert(detachedBeatmapSet != null);
+
+                    var newUser = new RealmUser { Username = "peppy", OnlineID = 2 };
+
+                    detachedBeatmapSet.Beatmaps.First().Metadata.Artist = "New Artist";
+                    detachedBeatmapSet.Beatmaps.First().Metadata.Author = newUser;
+
+                    Assert.AreNotEqual(detachedBeatmapSet.Status, BeatmapOnlineStatus.Ranked);
+                    detachedBeatmapSet.Status = BeatmapOnlineStatus.Ranked;
+
+                    beatmapSet.PerformWrite(s => detachedBeatmapSet.CopyChangesToRealm(s));
+
+                    beatmapSet.PerformRead(s =>
+                    {
+                        Assert.AreEqual(BeatmapOnlineStatus.Ranked, s.Status);
+                        Assert.AreEqual("New Artist", s.Beatmaps.First().Metadata.Artist);
+                        Assert.AreEqual(newUser, s.Beatmaps.First().Metadata.Author);
+                    });
+                }
+            });
+        }
+
         [Test]
         public void TestImportBeatmapThenCleanup()
         {

From a4de0f93fa1a813aa3b9e4782a0302c4a6b4390f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 12 Jan 2022 14:38:37 +0900
Subject: [PATCH 2146/5547] Move manager `Update` methods to be explicit to
 where they are still used by legacy code

Also fixes skin hash repopulation being completely broken.
---
 osu.Game/Beatmaps/BeatmapManager.cs         | 5 -----
 osu.Game/Beatmaps/BeatmapModelManager.cs    | 9 +++++++++
 osu.Game/Database/IModelManager.cs          | 7 -------
 osu.Game/Scoring/ScoreManager.cs            | 5 -----
 osu.Game/Skinning/SkinModelManager.cs       | 4 ++--
 osu.Game/Stores/RealmArchiveModelManager.cs | 9 ---------
 6 files changed, 11 insertions(+), 28 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index 21cda18c1a..f901b0fbc1 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -220,11 +220,6 @@ namespace osu.Game.Beatmaps
             return beatmapModelManager.IsAvailableLocally(model);
         }
 
-        public void Update(BeatmapSetInfo item)
-        {
-            beatmapModelManager.Update(item);
-        }
-
         public bool Delete(BeatmapSetInfo item)
         {
             return beatmapModelManager.Delete(item);
diff --git a/osu.Game/Beatmaps/BeatmapModelManager.cs b/osu.Game/Beatmaps/BeatmapModelManager.cs
index 62d607c4f7..73ada09ef6 100644
--- a/osu.Game/Beatmaps/BeatmapModelManager.cs
+++ b/osu.Game/Beatmaps/BeatmapModelManager.cs
@@ -101,5 +101,14 @@ namespace osu.Game.Beatmaps
             using (var context = ContextFactory.CreateContext())
                 return context.All<BeatmapInfo>().FirstOrDefault(query)?.Detach();
         }
+
+        public void Update(BeatmapSetInfo item)
+        {
+            using (var realm = ContextFactory.CreateContext())
+            {
+                var existing = realm.Find<BeatmapSetInfo>(item.ID);
+                realm.Write(r => item.CopyChangesToRealm(existing));
+            }
+        }
     }
 }
diff --git a/osu.Game/Database/IModelManager.cs b/osu.Game/Database/IModelManager.cs
index e7218b621c..187ac86a59 100644
--- a/osu.Game/Database/IModelManager.cs
+++ b/osu.Game/Database/IModelManager.cs
@@ -12,13 +12,6 @@ namespace osu.Game.Database
     public interface IModelManager<TModel>
         where TModel : class
     {
-        /// <summary>
-        /// Perform an update of the specified item.
-        /// TODO: Support file additions/removals.
-        /// </summary>
-        /// <param name="item">The item to update.</param>
-        void Update(TModel item);
-
         /// <summary>
         /// Delete an item from the manager.
         /// Is a no-op for already deleted items.
diff --git a/osu.Game/Scoring/ScoreManager.cs b/osu.Game/Scoring/ScoreManager.cs
index 62e61d3a94..ce5d2acc21 100644
--- a/osu.Game/Scoring/ScoreManager.cs
+++ b/osu.Game/Scoring/ScoreManager.cs
@@ -251,11 +251,6 @@ namespace osu.Game.Scoring
 
         #region Implementation of IModelManager<ScoreInfo>
 
-        public void Update(ScoreInfo item)
-        {
-            scoreModelManager.Update(item);
-        }
-
         public bool Delete(ScoreInfo item)
         {
             return scoreModelManager.Delete(item);
diff --git a/osu.Game/Skinning/SkinModelManager.cs b/osu.Game/Skinning/SkinModelManager.cs
index 66a1808dc1..1689a89b43 100644
--- a/osu.Game/Skinning/SkinModelManager.cs
+++ b/osu.Game/Skinning/SkinModelManager.cs
@@ -210,13 +210,13 @@ namespace osu.Game.Skinning
         {
             using (var realm = ContextFactory.CreateContext())
             {
-                var skinsWithoutHashes = realm.All<SkinInfo>().Where(i => string.IsNullOrEmpty(i.Hash)).ToArray();
+                var skinsWithoutHashes = realm.All<SkinInfo>().Where(i => !i.Protected && string.IsNullOrEmpty(i.Hash)).ToArray();
 
                 foreach (SkinInfo skin in skinsWithoutHashes)
                 {
                     try
                     {
-                        Update(skin);
+                        checkSkinIniMetadata(skin, realm);
                     }
                     catch (Exception e)
                     {
diff --git a/osu.Game/Stores/RealmArchiveModelManager.cs b/osu.Game/Stores/RealmArchiveModelManager.cs
index 3783b10a8c..4365fdab1e 100644
--- a/osu.Game/Stores/RealmArchiveModelManager.cs
+++ b/osu.Game/Stores/RealmArchiveModelManager.cs
@@ -201,14 +201,5 @@ namespace osu.Game.Stores
         }
 
         public abstract bool IsAvailableLocally(TModel model);
-
-        public void Update(TModel model)
-        {
-            using (var realm = ContextFactory.CreateContext())
-            {
-                var existing = realm.Find<TModel>(model.ID);
-                realm.Write(r => model.CopyChangesToRealm(existing));
-            }
-        }
     }
 }

From f24b2b1be3c408e035aef9dd13ded223cd0f0ac6 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 12 Jan 2022 14:38:58 +0900
Subject: [PATCH 2147/5547] Make copying detached changes to realm only exposed
 for `BeatmapSet`

Also fixes remaining issues with the copy process.
---
 .../Database/BeatmapImporterTests.cs          | 14 ++++-
 osu.Game/Beatmaps/BeatmapInfo.cs              |  1 +
 osu.Game/Database/RealmObjectExtensions.cs    | 61 +++++++++++++++++--
 3 files changed, 71 insertions(+), 5 deletions(-)

diff --git a/osu.Game.Tests/Database/BeatmapImporterTests.cs b/osu.Game.Tests/Database/BeatmapImporterTests.cs
index 0644313bf9..1bba73bea0 100644
--- a/osu.Game.Tests/Database/BeatmapImporterTests.cs
+++ b/osu.Game.Tests/Database/BeatmapImporterTests.cs
@@ -110,13 +110,25 @@ namespace osu.Game.Tests.Database
                     Assert.AreNotEqual(detachedBeatmapSet.Status, BeatmapOnlineStatus.Ranked);
                     detachedBeatmapSet.Status = BeatmapOnlineStatus.Ranked;
 
-                    beatmapSet.PerformWrite(s => detachedBeatmapSet.CopyChangesToRealm(s));
+                    beatmapSet.PerformWrite(s =>
+                    {
+                        detachedBeatmapSet.CopyChangesToRealm(s);
+                    });
 
                     beatmapSet.PerformRead(s =>
                     {
+                        // Check above changes explicitly.
                         Assert.AreEqual(BeatmapOnlineStatus.Ranked, s.Status);
                         Assert.AreEqual("New Artist", s.Beatmaps.First().Metadata.Artist);
                         Assert.AreEqual(newUser, s.Beatmaps.First().Metadata.Author);
+                        Assert.NotZero(s.Files.Count);
+
+                        // Check nothing was lost in the copy operation.
+                        Assert.AreEqual(s.Files.Count, detachedBeatmapSet.Files.Count);
+                        Assert.AreEqual(s.Files.Select(f => f.File).Count(), detachedBeatmapSet.Files.Select(f => f.File).Count());
+                        Assert.AreEqual(s.Beatmaps.Count, detachedBeatmapSet.Beatmaps.Count);
+                        Assert.AreEqual(s.Beatmaps.Select(f => f.Difficulty).Count(), detachedBeatmapSet.Beatmaps.Select(f => f.Difficulty).Count());
+                        Assert.AreEqual(s.Metadata, detachedBeatmapSet.Metadata);
                     });
                 }
             });
diff --git a/osu.Game/Beatmaps/BeatmapInfo.cs b/osu.Game/Beatmaps/BeatmapInfo.cs
index 53aba67275..1b732b3c8a 100644
--- a/osu.Game/Beatmaps/BeatmapInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapInfo.cs
@@ -162,6 +162,7 @@ namespace osu.Game.Beatmaps
         public Guid BeatmapSetInfoID => BeatmapSet?.ID ?? Guid.Empty;
 
         [Ignored]
+        [IgnoreMap]
         public BeatmapDifficulty BaseDifficulty
         {
             get => Difficulty;
diff --git a/osu.Game/Database/RealmObjectExtensions.cs b/osu.Game/Database/RealmObjectExtensions.cs
index a5e5962a04..188d619627 100644
--- a/osu.Game/Database/RealmObjectExtensions.cs
+++ b/osu.Game/Database/RealmObjectExtensions.cs
@@ -19,6 +19,50 @@ namespace osu.Game.Database
 {
     public static class RealmObjectExtensions
     {
+        private static readonly IMapper write_mapper = new MapperConfiguration(c =>
+        {
+            c.ShouldMapField = fi => false;
+            c.ShouldMapProperty = pi => pi.SetMethod?.IsPublic == true;
+
+            c.CreateMap<BeatmapMetadata, BeatmapMetadata>()
+             .ForMember(s => s.Author, cc => cc.Ignore())
+             .AfterMap((s, d) =>
+             {
+                 copyChangesToRealm(s.Author, d.Author);
+             });
+            c.CreateMap<BeatmapDifficulty, BeatmapDifficulty>();
+            c.CreateMap<RealmUser, RealmUser>();
+            c.CreateMap<RealmFile, RealmFile>();
+            c.CreateMap<RealmNamedFileUsage, RealmNamedFileUsage>();
+            c.CreateMap<BeatmapInfo, BeatmapInfo>()
+             .ForMember(s => s.Ruleset, cc => cc.Ignore())
+             .ForMember(s => s.Metadata, cc => cc.Ignore())
+             .ForMember(s => s.Difficulty, cc => cc.Ignore())
+             .ForMember(s => s.BeatmapSet, cc => cc.Ignore())
+             .AfterMap((s, d) =>
+             {
+                 d.Ruleset = d.Realm.Find<RulesetInfo>(s.Ruleset.ShortName);
+                 copyChangesToRealm(s.Difficulty, d.Difficulty);
+                 copyChangesToRealm(s.Metadata, d.Metadata);
+             });
+            c.CreateMap<BeatmapSetInfo, BeatmapSetInfo>()
+             .ForMember(s => s.Beatmaps, cc => cc.Ignore())
+             .AfterMap((s, d) =>
+             {
+                 foreach (var beatmap in s.Beatmaps)
+                 {
+                     var existing = d.Beatmaps.FirstOrDefault(b => b.ID == beatmap.ID);
+
+                     if (existing != null)
+                         copyChangesToRealm(beatmap, existing);
+                     else
+                         d.Beatmaps.Add(beatmap);
+                 }
+             });
+
+            c.AddGlobalIgnore(nameof(RealmObjectBase.ObjectSchema));
+        }).CreateMapper();
+
         private static readonly IMapper mapper = new MapperConfiguration(c =>
         {
             c.ShouldMapField = fi => false;
@@ -52,6 +96,8 @@ namespace osu.Game.Database
                 foreach (var beatmap in d.Beatmaps)
                     beatmap.BeatmapSet = d;
             });
+
+            c.AddGlobalIgnore(nameof(RealmObjectBase.ObjectSchema));
         }).CreateMapper();
 
         /// <summary>
@@ -90,10 +136,17 @@ namespace osu.Game.Database
             return mapper.Map<T>(item);
         }
 
-        public static void CopyChangesToRealm<T>(this T source, T destination) where T : RealmObjectBase
-        {
-            mapper.Map(source, destination);
-        }
+        /// <summary>
+        /// Copy changes in a detached beatmap back to realm.
+        /// This is a temporary method to handle existing flows only. It should not be used going forward if we can avoid it.
+        /// </summary>
+        /// <param name="source">The detached beatmap to copy from.</param>
+        /// <param name="destination">The live beatmap to copy to.</param>
+        public static void CopyChangesToRealm(this BeatmapSetInfo source, BeatmapSetInfo destination)
+            => copyChangesToRealm(source, destination);
+
+        private static void copyChangesToRealm<T>(T source, T destination) where T : RealmObjectBase
+            => write_mapper.Map(source, destination);
 
         public static List<ILive<T>> ToLiveUnmanaged<T>(this IEnumerable<T> realmList)
             where T : RealmObject, IHasGuidPrimaryKey

From 5f7365e8f39e510021a9d123c19892d09e2a65a8 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 12 Jan 2022 15:09:56 +0900
Subject: [PATCH 2148/5547] Ensure scores are cleaned up alongside beatmap so
 they don't have a null reference

---
 osu.Game/Beatmaps/BeatmapInfo.cs         |  5 +++++
 osu.Game/Database/RealmContextFactory.cs | 14 ++++++++++----
 2 files changed, 15 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapInfo.cs b/osu.Game/Beatmaps/BeatmapInfo.cs
index 1b732b3c8a..8a2ee95020 100644
--- a/osu.Game/Beatmaps/BeatmapInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapInfo.cs
@@ -11,6 +11,7 @@ using osu.Game.Database;
 using osu.Game.Models;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets;
+using osu.Game.Scoring;
 using Realms;
 
 #nullable enable
@@ -36,6 +37,10 @@ namespace osu.Game.Beatmaps
 
         public BeatmapMetadata Metadata { get; set; } = new BeatmapMetadata();
 
+        [IgnoreMap]
+        [Backlink(nameof(ScoreInfo.Beatmap))]
+        public IQueryable<ScoreInfo> Scores { get; } = null!;
+
         public BeatmapInfo(RulesetInfo ruleset, BeatmapDifficulty difficulty, BeatmapMetadata metadata)
         {
             Ruleset = ruleset;
diff --git a/osu.Game/Database/RealmContextFactory.cs b/osu.Game/Database/RealmContextFactory.cs
index 968caaa7ce..1aa6b2043c 100644
--- a/osu.Game/Database/RealmContextFactory.cs
+++ b/osu.Game/Database/RealmContextFactory.cs
@@ -113,12 +113,18 @@ namespace osu.Game.Database
             {
                 var pendingDeleteSets = realm.All<BeatmapSetInfo>().Where(s => s.DeletePending);
 
-                foreach (var s in pendingDeleteSets)
+                foreach (var beatmapSet in pendingDeleteSets)
                 {
-                    foreach (var b in s.Beatmaps)
-                        realm.Remove(b);
+                    foreach (var beatmap in beatmapSet.Beatmaps)
+                    {
+                        // Cascade delete related scores, else they will have a null beatmap against the model's spec.
+                        foreach (var score in beatmap.Scores)
+                            realm.Remove(score);
 
-                    realm.Remove(s);
+                        realm.Remove(beatmap);
+                    }
+
+                    realm.Remove(beatmapSet);
                 }
 
                 var pendingDeleteSkins = realm.All<SkinInfo>().Where(s => s.DeletePending);

From 34aa1bf21d46e404fb18e0e5ca6045967c2a7f2c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 12 Jan 2022 15:34:39 +0900
Subject: [PATCH 2149/5547] Sanitise and remove some usages of `Detach` which
 are no longer required

---
 osu.Game.Tests/Scores/IO/ImportScoreTest.cs                   | 3 +--
 .../Visual/UserInterface/TestSceneDeleteLocalScore.cs         | 2 +-
 osu.Game/Beatmaps/BeatmapInfo.cs                              | 2 +-
 osu.Game/Beatmaps/WorkingBeatmapCache.cs                      | 1 -
 osu.Game/Screens/Select/BeatmapCarousel.cs                    | 4 +---
 5 files changed, 4 insertions(+), 8 deletions(-)

diff --git a/osu.Game.Tests/Scores/IO/ImportScoreTest.cs b/osu.Game.Tests/Scores/IO/ImportScoreTest.cs
index 22b792cee4..9b583494cb 100644
--- a/osu.Game.Tests/Scores/IO/ImportScoreTest.cs
+++ b/osu.Game.Tests/Scores/IO/ImportScoreTest.cs
@@ -10,7 +10,6 @@ using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Platform;
 using osu.Game.Beatmaps;
-using osu.Game.Database;
 using osu.Game.IO.Archives;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets.Mods;
@@ -162,7 +161,7 @@ namespace osu.Game.Tests.Scores.IO
             var scoreManager = osu.Dependencies.Get<ScoreManager>();
             await scoreManager.Import(score, archive);
 
-            return scoreManager.Query(_ => true).Detach();
+            return scoreManager.Query(_ => true);
         }
 
         internal class TestArchiveReader : ArchiveReader
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
index 17168bf07f..63df6a6390 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
@@ -95,7 +95,7 @@ namespace osu.Game.Tests.Visual.UserInterface
 
             imported?.PerformRead(s =>
             {
-                beatmapInfo = s.Beatmaps[0].Detach();
+                beatmapInfo = s.Beatmaps[0];
 
                 for (int i = 0; i < 50; i++)
                 {
diff --git a/osu.Game/Beatmaps/BeatmapInfo.cs b/osu.Game/Beatmaps/BeatmapInfo.cs
index 8a2ee95020..fb32c11365 100644
--- a/osu.Game/Beatmaps/BeatmapInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapInfo.cs
@@ -188,7 +188,7 @@ namespace osu.Game.Beatmaps
 
         public int BeatmapVersion;
 
-        public BeatmapInfo Clone() => (BeatmapInfo)this.Detach().MemberwiseClone();
+        public BeatmapInfo Clone() => (BeatmapInfo)MemberwiseClone();
 
         public override string ToString() => this.GetDisplayTitle();
 
diff --git a/osu.Game/Beatmaps/WorkingBeatmapCache.cs b/osu.Game/Beatmaps/WorkingBeatmapCache.cs
index e1399c5272..6947752c47 100644
--- a/osu.Game/Beatmaps/WorkingBeatmapCache.cs
+++ b/osu.Game/Beatmaps/WorkingBeatmapCache.cs
@@ -84,7 +84,6 @@ namespace osu.Game.Beatmaps
                 if (working != null)
                     return working;
 
-                // TODO: FUCK THE WORLD :D
                 beatmapInfo = beatmapInfo.Detach();
 
                 workingCache.Add(working = new BeatmapManagerWorkingBeatmap(beatmapInfo, this));
diff --git a/osu.Game/Screens/Select/BeatmapCarousel.cs b/osu.Game/Screens/Select/BeatmapCarousel.cs
index f355554482..8b4de447e5 100644
--- a/osu.Game/Screens/Select/BeatmapCarousel.cs
+++ b/osu.Game/Screens/Select/BeatmapCarousel.cs
@@ -682,9 +682,7 @@ namespace osu.Game.Screens.Select
             if (beatmapSet.Beatmaps.All(b => b.Hidden))
                 return null;
 
-            // TODO: FUCK THE WORLD :D
-            if (beatmapSet.IsManaged)
-                beatmapSet = beatmapSet.Detach();
+            beatmapSet = beatmapSet.Detach();
 
             var set = new CarouselBeatmapSet(beatmapSet)
             {

From e12025dd48018cbdf4feb298026539b4878f2591 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 12 Jan 2022 16:17:11 +0900
Subject: [PATCH 2150/5547] Cascade delete metadata when beatmaps are deleted

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

diff --git a/osu.Game/Database/RealmContextFactory.cs b/osu.Game/Database/RealmContextFactory.cs
index 1aa6b2043c..0802641b06 100644
--- a/osu.Game/Database/RealmContextFactory.cs
+++ b/osu.Game/Database/RealmContextFactory.cs
@@ -121,6 +121,8 @@ namespace osu.Game.Database
                         foreach (var score in beatmap.Scores)
                             realm.Remove(score);
 
+                        realm.Remove(beatmap.Metadata);
+
                         realm.Remove(beatmap);
                     }
 

From eb70a1eeb70004c71e301ca9163eacd5bd351026 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 12 Jan 2022 18:05:25 +0900
Subject: [PATCH 2151/5547] Replace compatibility properties with direct
 references

---
 osu.Game/Beatmaps/BeatmapInfo.cs                   |  2 +-
 osu.Game/Models/RealmNamedFileUsage.cs             | 10 ----------
 .../Edit/Checks/CheckTooShortAudioFiles.cs         |  2 +-
 .../Rulesets/Edit/Checks/CheckZeroByteFiles.cs     |  2 +-
 osu.Game/Scoring/ScoreInfo.cs                      | 14 ++++----------
 osu.Game/Scoring/ScoreManager.cs                   |  8 ++++----
 osu.Game/Scoring/ScoreModelManager.cs              |  4 ++--
 osu.Game/Screens/Select/Carousel/TopLocalRank.cs   |  2 +-
 .../Select/Leaderboards/BeatmapLeaderboard.cs      |  2 +-
 osu.Game/Storyboards/Storyboard.cs                 |  2 +-
 10 files changed, 16 insertions(+), 32 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapInfo.cs b/osu.Game/Beatmaps/BeatmapInfo.cs
index fb32c11365..1c1f81f143 100644
--- a/osu.Game/Beatmaps/BeatmapInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapInfo.cs
@@ -38,7 +38,7 @@ namespace osu.Game.Beatmaps
         public BeatmapMetadata Metadata { get; set; } = new BeatmapMetadata();
 
         [IgnoreMap]
-        [Backlink(nameof(ScoreInfo.Beatmap))]
+        [Backlink(nameof(ScoreInfo.BeatmapInfo))]
         public IQueryable<ScoreInfo> Scores { get; } = null!;
 
         public BeatmapInfo(RulesetInfo ruleset, BeatmapDifficulty difficulty, BeatmapMetadata metadata)
diff --git a/osu.Game/Models/RealmNamedFileUsage.cs b/osu.Game/Models/RealmNamedFileUsage.cs
index 801c826292..17e32510a8 100644
--- a/osu.Game/Models/RealmNamedFileUsage.cs
+++ b/osu.Game/Models/RealmNamedFileUsage.cs
@@ -31,15 +31,5 @@ namespace osu.Game.Models
         }
 
         IFileInfo INamedFileUsage.File => File;
-
-        #region Compatibility properties
-
-        public RealmFile FileInfo
-        {
-            get => File;
-            set => File = value;
-        }
-
-        #endregion
     }
 }
diff --git a/osu.Game/Rulesets/Edit/Checks/CheckTooShortAudioFiles.cs b/osu.Game/Rulesets/Edit/Checks/CheckTooShortAudioFiles.cs
index 5cc98c5537..381ebd4af6 100644
--- a/osu.Game/Rulesets/Edit/Checks/CheckTooShortAudioFiles.cs
+++ b/osu.Game/Rulesets/Edit/Checks/CheckTooShortAudioFiles.cs
@@ -32,7 +32,7 @@ namespace osu.Game.Rulesets.Edit.Checks
 
             foreach (var file in beatmapSet.Files)
             {
-                using (Stream data = context.WorkingBeatmap.GetStream(file.FileInfo.GetStoragePath()))
+                using (Stream data = context.WorkingBeatmap.GetStream(file.File.GetStoragePath()))
                 {
                     if (data == null)
                         continue;
diff --git a/osu.Game/Rulesets/Edit/Checks/CheckZeroByteFiles.cs b/osu.Game/Rulesets/Edit/Checks/CheckZeroByteFiles.cs
index ab9959aec2..324ebe6b50 100644
--- a/osu.Game/Rulesets/Edit/Checks/CheckZeroByteFiles.cs
+++ b/osu.Game/Rulesets/Edit/Checks/CheckZeroByteFiles.cs
@@ -23,7 +23,7 @@ namespace osu.Game.Rulesets.Edit.Checks
 
             foreach (var file in beatmapSet.Files)
             {
-                using (Stream data = context.WorkingBeatmap.GetStream(file.FileInfo.GetStoragePath()))
+                using (Stream data = context.WorkingBeatmap.GetStream(file.File.GetStoragePath()))
                 {
                     if (data?.Length == 0)
                         yield return new IssueTemplateZeroBytes(this).Create(file.Filename);
diff --git a/osu.Game/Scoring/ScoreInfo.cs b/osu.Game/Scoring/ScoreInfo.cs
index 61df736a4a..ffec54aca7 100644
--- a/osu.Game/Scoring/ScoreInfo.cs
+++ b/osu.Game/Scoring/ScoreInfo.cs
@@ -49,7 +49,7 @@ namespace osu.Game.Scoring
         public ScoreInfo(BeatmapInfo beatmap, RulesetInfo ruleset, RealmUser realmUser)
         {
             Ruleset = ruleset;
-            Beatmap = beatmap;
+            BeatmapInfo = beatmap;
             RealmUser = realmUser;
         }
 
@@ -94,7 +94,7 @@ namespace osu.Game.Scoring
 
         public double? PP { get; set; }
 
-        public BeatmapInfo Beatmap { get; set; } = null!;
+        public BeatmapInfo BeatmapInfo { get; set; } = null!;
 
         public RulesetInfo Ruleset { get; set; } = null!;
 
@@ -129,7 +129,7 @@ namespace osu.Game.Scoring
         public int RankInt { get; set; }
 
         IRulesetInfo IScoreInfo.Ruleset => Ruleset;
-        IBeatmapInfo IScoreInfo.Beatmap => Beatmap;
+        IBeatmapInfo IScoreInfo.Beatmap => BeatmapInfo;
         IUser IScoreInfo.User => User;
         IEnumerable<INamedFileUsage> IHasNamedFiles.Files => Files;
 
@@ -139,13 +139,7 @@ namespace osu.Game.Scoring
 
         private Mod[]? mods;
 
-        public Guid BeatmapInfoID => Beatmap.ID;
-
-        public BeatmapInfo BeatmapInfo
-        {
-            get => Beatmap;
-            set => Beatmap = value;
-        }
+        public Guid BeatmapInfoID => BeatmapInfo.ID;
 
         public int UserID => RealmUser.OnlineID;
 
diff --git a/osu.Game/Scoring/ScoreManager.cs b/osu.Game/Scoring/ScoreManager.cs
index ce5d2acc21..ad2be7d813 100644
--- a/osu.Game/Scoring/ScoreManager.cs
+++ b/osu.Game/Scoring/ScoreManager.cs
@@ -70,7 +70,7 @@ namespace osu.Game.Scoring
                 // Compute difficulties asynchronously first to prevent blocking via the GetTotalScore() call below.
                 foreach (var s in scores)
                 {
-                    await difficultyCache.GetDifficultyAsync(s.Beatmap, s.Ruleset, s.Mods, cancellationToken).ConfigureAwait(false);
+                    await difficultyCache.GetDifficultyAsync(s.BeatmapInfo, s.Ruleset, s.Mods, cancellationToken).ConfigureAwait(false);
                     cancellationToken.ThrowIfCancellationRequested();
                 }
             }
@@ -154,11 +154,11 @@ namespace osu.Game.Scoring
 
                 // This score is guaranteed to be an osu!stable score.
                 // The combo must be determined through either the beatmap's max combo value or the difficulty calculator, as lazer's scoring has changed and the score statistics cannot be used.
-                if (score.Beatmap.MaxCombo != null)
-                    beatmapMaxCombo = score.Beatmap.MaxCombo.Value;
+                if (score.BeatmapInfo.MaxCombo != null)
+                    beatmapMaxCombo = score.BeatmapInfo.MaxCombo.Value;
                 else
                 {
-                    if (!score.Beatmap.IsManaged || difficulties == null)
+                    if (!score.BeatmapInfo.IsManaged || difficulties == null)
                     {
                         // We don't have enough information (max combo) to compute the score, so use the provided score.
                         return score.TotalScore;
diff --git a/osu.Game/Scoring/ScoreModelManager.cs b/osu.Game/Scoring/ScoreModelManager.cs
index 1068aba231..09a5919f12 100644
--- a/osu.Game/Scoring/ScoreModelManager.cs
+++ b/osu.Game/Scoring/ScoreModelManager.cs
@@ -58,8 +58,8 @@ namespace osu.Game.Scoring
         protected override Task Populate(ScoreInfo model, ArchiveReader? archive, Realm realm, CancellationToken cancellationToken = default)
         {
             // Ensure the beatmap is not detached.
-            if (!model.Beatmap.IsManaged)
-                model.Beatmap = realm.Find<BeatmapInfo>(model.Beatmap.ID);
+            if (!model.BeatmapInfo.IsManaged)
+                model.BeatmapInfo = realm.Find<BeatmapInfo>(model.BeatmapInfo.ID);
 
             if (!model.Ruleset.IsManaged)
                 model.Ruleset = realm.Find<RulesetInfo>(model.Ruleset.ShortName);
diff --git a/osu.Game/Screens/Select/Carousel/TopLocalRank.cs b/osu.Game/Screens/Select/Carousel/TopLocalRank.cs
index 9a0085c62a..fb1fa09253 100644
--- a/osu.Game/Screens/Select/Carousel/TopLocalRank.cs
+++ b/osu.Game/Screens/Select/Carousel/TopLocalRank.cs
@@ -49,7 +49,7 @@ namespace osu.Game.Screens.Select.Carousel
             base.LoadComplete();
 
             scoreSubscription = realmFactory.Context.All<ScoreInfo>()
-                                            .Filter($"{nameof(ScoreInfo.Beatmap)}.{nameof(BeatmapInfo.ID)} = $0", beatmapInfo.ID)
+                                            .Filter($"{nameof(ScoreInfo.BeatmapInfo)}.{nameof(BeatmapInfo.ID)} = $0", beatmapInfo.ID)
                                             .QueryAsyncWithNotifications((_, changes, ___) =>
                                             {
                                                 if (changes == null)
diff --git a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
index d03a8b645d..49f2ea5d64 100644
--- a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
+++ b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
@@ -110,7 +110,7 @@ namespace osu.Game.Screens.Select.Leaderboards
                 return;
 
             scoreSubscription = realmFactory.Context.All<ScoreInfo>()
-                                            .Filter($"{nameof(ScoreInfo.Beatmap)}.{nameof(BeatmapInfo.ID)} = $0", beatmapInfo.ID)
+                                            .Filter($"{nameof(ScoreInfo.BeatmapInfo)}.{nameof(BeatmapInfo.ID)} = $0", beatmapInfo.ID)
                                             .QueryAsyncWithNotifications((_, changes, ___) =>
                                             {
                                                 if (changes == null)
diff --git a/osu.Game/Storyboards/Storyboard.cs b/osu.Game/Storyboards/Storyboard.cs
index 9502dd8968..ff496aea36 100644
--- a/osu.Game/Storyboards/Storyboard.cs
+++ b/osu.Game/Storyboards/Storyboard.cs
@@ -97,7 +97,7 @@ namespace osu.Game.Storyboards
         {
             Drawable drawable = null;
 
-            string storyboardPath = BeatmapInfo.BeatmapSet?.Files.FirstOrDefault(f => f.Filename.Equals(path, StringComparison.OrdinalIgnoreCase))?.FileInfo.GetStoragePath();
+            string storyboardPath = BeatmapInfo.BeatmapSet?.Files.FirstOrDefault(f => f.Filename.Equals(path, StringComparison.OrdinalIgnoreCase))?.File.GetStoragePath();
 
             if (!string.IsNullOrEmpty(storyboardPath))
                 drawable = new Sprite { Texture = textureStore.Get(storyboardPath) };

From ef0f794fd61c61ec776380bfdc3a5479f765bf3c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 12 Jan 2022 18:08:26 +0900
Subject: [PATCH 2152/5547] Remove stay newline

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

diff --git a/osu.Game/Screens/Select/BeatmapCarousel.cs b/osu.Game/Screens/Select/BeatmapCarousel.cs
index 8b4de447e5..734d9bbde7 100644
--- a/osu.Game/Screens/Select/BeatmapCarousel.cs
+++ b/osu.Game/Screens/Select/BeatmapCarousel.cs
@@ -158,7 +158,6 @@ namespace osu.Game.Screens.Select
         private readonly DrawablePool<DrawableCarouselBeatmapSet> setPool = new DrawablePool<DrawableCarouselBeatmapSet>(100);
 
         public BeatmapCarousel()
-
         {
             root = new CarouselRoot(this);
             InternalChild = new OsuContextMenuContainer

From 4106ebf881190418427f27f370637eb319c8839f Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 12 Jan 2022 18:29:23 +0900
Subject: [PATCH 2153/5547] Fix mania requiring PERFECTs to maintain HP

---
 osu.Game.Rulesets.Mania/ManiaRuleset.cs       |  2 +-
 .../Scoring/ManiaHealthProcessor.cs           | 23 +++++++++++++++++++
 .../Rulesets/Scoring/JudgementProcessor.cs    |  9 +++++++-
 3 files changed, 32 insertions(+), 2 deletions(-)
 create mode 100644 osu.Game.Rulesets.Mania/Scoring/ManiaHealthProcessor.cs

diff --git a/osu.Game.Rulesets.Mania/ManiaRuleset.cs b/osu.Game.Rulesets.Mania/ManiaRuleset.cs
index b0e7545d3e..6fc7dc018b 100644
--- a/osu.Game.Rulesets.Mania/ManiaRuleset.cs
+++ b/osu.Game.Rulesets.Mania/ManiaRuleset.cs
@@ -49,7 +49,7 @@ namespace osu.Game.Rulesets.Mania
 
         public override ScoreProcessor CreateScoreProcessor() => new ManiaScoreProcessor();
 
-        public override HealthProcessor CreateHealthProcessor(double drainStartTime) => new DrainingHealthProcessor(drainStartTime, 0.5);
+        public override HealthProcessor CreateHealthProcessor(double drainStartTime) => new ManiaHealthProcessor(drainStartTime, 0.5);
 
         public override IBeatmapConverter CreateBeatmapConverter(IBeatmap beatmap) => new ManiaBeatmapConverter(beatmap, this);
 
diff --git a/osu.Game.Rulesets.Mania/Scoring/ManiaHealthProcessor.cs b/osu.Game.Rulesets.Mania/Scoring/ManiaHealthProcessor.cs
new file mode 100644
index 0000000000..57c2ba9c6d
--- /dev/null
+++ b/osu.Game.Rulesets.Mania/Scoring/ManiaHealthProcessor.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.Game.Rulesets.Judgements;
+using osu.Game.Rulesets.Scoring;
+
+namespace osu.Game.Rulesets.Mania.Scoring
+{
+    public class ManiaHealthProcessor : DrainingHealthProcessor
+    {
+        /// <inheritdoc/>
+        public ManiaHealthProcessor(double drainStartTime, double drainLenience = 0)
+            : base(drainStartTime, drainLenience)
+        {
+        }
+
+        protected override HitResult GetSimulatedHitResult(Judgement judgement)
+        {
+            // Users are not expected to attain perfect judgements for all notes due to the tighter hit window.
+            return judgement.MaxResult == HitResult.Perfect ? HitResult.Great : judgement.MaxResult;
+        }
+    }
+}
diff --git a/osu.Game/Rulesets/Scoring/JudgementProcessor.cs b/osu.Game/Rulesets/Scoring/JudgementProcessor.cs
index ed4a16f0e8..c3c4a2c949 100644
--- a/osu.Game/Rulesets/Scoring/JudgementProcessor.cs
+++ b/osu.Game/Rulesets/Scoring/JudgementProcessor.cs
@@ -135,7 +135,7 @@ namespace osu.Game.Rulesets.Scoring
                 if (result == null)
                     throw new InvalidOperationException($"{GetType().ReadableName()} must provide a {nameof(JudgementResult)} through {nameof(CreateResult)}.");
 
-                result.Type = judgement.MaxResult;
+                result.Type = GetSimulatedHitResult(judgement);
                 ApplyResult(result);
             }
         }
@@ -145,5 +145,12 @@ namespace osu.Game.Rulesets.Scoring
             base.Update();
             hasCompleted.Value = JudgedHits == MaxHits && (JudgedHits == 0 || lastAppliedResult.TimeAbsolute < Clock.CurrentTime);
         }
+
+        /// <summary>
+        /// Gets a simulated <see cref="HitResult"/> for a judgement. Used during <see cref="SimulateAutoplay"/> to simulate a "perfect" play.
+        /// </summary>
+        /// <param name="judgement">The judgement to simulate a <see cref="HitResult"/> for.</param>
+        /// <returns>The simulated <see cref="HitResult"/> for the judgement.</returns>
+        protected virtual HitResult GetSimulatedHitResult(Judgement judgement) => judgement.MaxResult;
     }
 }

From 8c8c5f4c3340b72846b02428936a8f7e485bf4a9 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 12 Jan 2022 14:38:37 +0900
Subject: [PATCH 2154/5547] Fix skin hash repopulation not working since realm
 migration

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

diff --git a/osu.Game/Skinning/SkinModelManager.cs b/osu.Game/Skinning/SkinModelManager.cs
index 822cb8efa0..964d99a2e5 100644
--- a/osu.Game/Skinning/SkinModelManager.cs
+++ b/osu.Game/Skinning/SkinModelManager.cs
@@ -210,13 +210,13 @@ namespace osu.Game.Skinning
         {
             using (var realm = ContextFactory.CreateContext())
             {
-                var skinsWithoutHashes = realm.All<SkinInfo>().Where(i => string.IsNullOrEmpty(i.Hash)).ToArray();
+                var skinsWithoutHashes = realm.All<SkinInfo>().Where(i => !i.Protected && string.IsNullOrEmpty(i.Hash)).ToArray();
 
                 foreach (SkinInfo skin in skinsWithoutHashes)
                 {
                     try
                     {
-                        Update(skin);
+                        realm.Write(r => skin.Hash = ComputeHash(skin));
                     }
                     catch (Exception e)
                     {

From 38cc1ce098c9e957a0d46106c2f8857177148f38 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 12 Jan 2022 18:51:30 +0900
Subject: [PATCH 2155/5547] Add missing ruleset in test scores

---
 .../Visual/SongSelect/TestSceneUserTopScoreContainer.cs       | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneUserTopScoreContainer.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneUserTopScoreContainer.cs
index 7af9e9eb40..dd7f9951bf 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneUserTopScoreContainer.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneUserTopScoreContainer.cs
@@ -10,6 +10,7 @@ using osuTK.Graphics;
 using osu.Game.Online.Leaderboards;
 using osu.Game.Overlays;
 using osu.Game.Rulesets.Mods;
+using osu.Game.Rulesets.Osu;
 using osu.Game.Scoring;
 using osu.Game.Rulesets.Osu.Mods;
 using osu.Game.Users;
@@ -61,6 +62,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                     MaxCombo = 244,
                     TotalScore = 1707827,
                     Mods = new Mod[] { new OsuModHidden(), new OsuModHardRock(), },
+                    Ruleset = new OsuRuleset().RulesetInfo,
                     User = new APIUser
                     {
                         Id = 6602580,
@@ -79,6 +81,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                     Accuracy = 1,
                     MaxCombo = 244,
                     TotalScore = 1707827,
+                    Ruleset = new OsuRuleset().RulesetInfo,
                     User = new APIUser
                     {
                         Id = 4608074,
@@ -97,6 +100,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                     Accuracy = 1,
                     MaxCombo = 244,
                     TotalScore = 1707827,
+                    Ruleset = new OsuRuleset().RulesetInfo,
                     User = new APIUser
                     {
                         Id = 1541390,

From 51251e3204aa4b5097eabecc0f312d244672022f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 12 Jan 2022 22:34:07 +0900
Subject: [PATCH 2156/5547] Fix CI reported warnings

---
 .../Statistics/AccuracyHeatmap.cs             |  2 +-
 .../Beatmaps/Formats/OsuJsonDecoderTest.cs    |  2 +-
 .../Beatmaps/IO/OszArchiveReaderTest.cs       |  2 +-
 .../Beatmaps/TestSceneEditorBeatmap.cs        | 68 +++++++++++++++++--
 osu.Game.Tests/Scores/IO/ImportScoreTest.cs   |  6 --
 .../TestSceneMultiplayerMatchSongSelect.cs    |  2 +-
 .../SongSelect/TestSceneAdvancedStats.cs      |  2 +-
 osu.Game.Tournament/TournamentGameBase.cs     |  2 +-
 .../Online/API/Requests/Responses/APIScore.cs |  4 +-
 osu.Game/Online/Rooms/MultiplayerScore.cs     |  2 +-
 .../Sections/Ranks/DrawableProfileScore.cs    | 10 ++-
 .../Edit/Checks/CheckBackgroundQuality.cs     |  2 +-
 .../Rulesets/Edit/Checks/CheckFilePresence.cs |  2 +-
 .../Edit/Checks/CheckTooShortAudioFiles.cs    | 45 ++++++------
 .../Edit/Checks/CheckZeroByteFiles.cs         | 11 +--
 .../Mods/DifficultyAdjustSettingsControl.cs   |  3 -
 .../Components/Menus/DifficultyMenuItem.cs    |  2 +-
 .../Screens/Edit/Compose/ComposeScreen.cs     |  2 +-
 osu.Game/Screens/Edit/Editor.cs               |  3 +-
 osu.Game/Screens/Edit/EditorBeatmap.cs        |  2 +-
 osu.Game/Screens/Edit/Setup/SetupScreen.cs    |  2 +-
 .../Ranking/Statistics/StatisticsPanel.cs     |  6 +-
 osu.Game/Screens/Select/BeatmapInfoWedge.cs   |  2 +-
 osu.Game/Screens/Select/FilterControl.cs      |  2 +-
 .../Tests/Beatmaps/HitObjectSampleTest.cs     |  2 +
 25 files changed, 123 insertions(+), 65 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Statistics/AccuracyHeatmap.cs b/osu.Game.Rulesets.Osu/Statistics/AccuracyHeatmap.cs
index db4a6eb50b..6c76da7925 100644
--- a/osu.Game.Rulesets.Osu/Statistics/AccuracyHeatmap.cs
+++ b/osu.Game.Rulesets.Osu/Statistics/AccuracyHeatmap.cs
@@ -174,7 +174,7 @@ namespace osu.Game.Rulesets.Osu.Statistics
 
             pointGrid.Content = points;
 
-            if (score.HitEvents == null || score.HitEvents.Count == 0)
+            if (score.HitEvents.Count == 0)
                 return;
 
             // Todo: This should probably not be done like this.
diff --git a/osu.Game.Tests/Beatmaps/Formats/OsuJsonDecoderTest.cs b/osu.Game.Tests/Beatmaps/Formats/OsuJsonDecoderTest.cs
index bfd6ff0314..06ed638e0a 100644
--- a/osu.Game.Tests/Beatmaps/Formats/OsuJsonDecoderTest.cs
+++ b/osu.Game.Tests/Beatmaps/Formats/OsuJsonDecoderTest.cs
@@ -31,7 +31,7 @@ namespace osu.Game.Tests.Beatmaps.Formats
         {
             var beatmap = decodeAsJson(normal);
             var meta = beatmap.BeatmapInfo.Metadata;
-            Assert.AreEqual(241526, beatmap.BeatmapInfo.BeatmapSet.OnlineID);
+            Assert.AreEqual(241526, beatmap.BeatmapInfo.BeatmapSet?.OnlineID);
             Assert.AreEqual("Soleily", meta.Artist);
             Assert.AreEqual("Soleily", meta.ArtistUnicode);
             Assert.AreEqual("03. Renatus - Soleily 192kbps.mp3", meta.AudioFile);
diff --git a/osu.Game.Tests/Beatmaps/IO/OszArchiveReaderTest.cs b/osu.Game.Tests/Beatmaps/IO/OszArchiveReaderTest.cs
index b2ab1eeaa6..810ea5dbd0 100644
--- a/osu.Game.Tests/Beatmaps/IO/OszArchiveReaderTest.cs
+++ b/osu.Game.Tests/Beatmaps/IO/OszArchiveReaderTest.cs
@@ -56,7 +56,7 @@ namespace osu.Game.Tests.Beatmaps.IO
 
                 var meta = beatmap.Metadata;
 
-                Assert.AreEqual(241526, beatmap.BeatmapInfo.BeatmapSet.OnlineID);
+                Assert.AreEqual(241526, beatmap.BeatmapInfo.BeatmapSet?.OnlineID);
                 Assert.AreEqual("Soleily", meta.Artist);
                 Assert.AreEqual("Soleily", meta.ArtistUnicode);
                 Assert.AreEqual("03. Renatus - Soleily 192kbps.mp3", meta.AudioFile);
diff --git a/osu.Game.Tests/Beatmaps/TestSceneEditorBeatmap.cs b/osu.Game.Tests/Beatmaps/TestSceneEditorBeatmap.cs
index bf5b517603..153788c2cf 100644
--- a/osu.Game.Tests/Beatmaps/TestSceneEditorBeatmap.cs
+++ b/osu.Game.Tests/Beatmaps/TestSceneEditorBeatmap.cs
@@ -7,6 +7,7 @@ using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Testing;
 using osu.Game.Rulesets.Objects;
+using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Osu.Beatmaps;
 using osu.Game.Rulesets.Osu.Objects;
 using osu.Game.Screens.Edit;
@@ -30,7 +31,13 @@ namespace osu.Game.Tests.Beatmaps
 
             AddStep("add beatmap", () =>
             {
-                Child = editorBeatmap = new EditorBeatmap(new OsuBeatmap());
+                Child = editorBeatmap = new EditorBeatmap(new OsuBeatmap
+                {
+                    BeatmapInfo =
+                    {
+                        Ruleset = new OsuRuleset().RulesetInfo,
+                    },
+                });
                 editorBeatmap.HitObjectAdded += h => addedObject = h;
             });
 
@@ -49,7 +56,14 @@ namespace osu.Game.Tests.Beatmaps
             EditorBeatmap editorBeatmap = null;
             AddStep("add beatmap", () =>
             {
-                Child = editorBeatmap = new EditorBeatmap(new OsuBeatmap { HitObjects = { hitCircle } });
+                Child = editorBeatmap = new EditorBeatmap(new OsuBeatmap
+                {
+                    BeatmapInfo =
+                    {
+                        Ruleset = new OsuRuleset().RulesetInfo,
+                    },
+                    HitObjects = { hitCircle }
+                });
                 editorBeatmap.HitObjectRemoved += h => removedObject = h;
             });
             AddStep("remove hitobject", () => editorBeatmap.Remove(editorBeatmap.HitObjects.First()));
@@ -71,7 +85,14 @@ namespace osu.Game.Tests.Beatmaps
             {
                 EditorBeatmap editorBeatmap;
 
-                Child = editorBeatmap = new EditorBeatmap(new OsuBeatmap { HitObjects = { hitCircle } });
+                Child = editorBeatmap = new EditorBeatmap(new OsuBeatmap
+                {
+                    BeatmapInfo =
+                    {
+                        Ruleset = new OsuRuleset().RulesetInfo,
+                    },
+                    HitObjects = { hitCircle }
+                });
                 editorBeatmap.HitObjectUpdated += h => changedObject = h;
             });
 
@@ -91,7 +112,13 @@ namespace osu.Game.Tests.Beatmaps
 
             AddStep("add beatmap", () =>
             {
-                Child = editorBeatmap = new EditorBeatmap(new OsuBeatmap());
+                Child = editorBeatmap = new EditorBeatmap(new OsuBeatmap
+                {
+                    BeatmapInfo =
+                    {
+                        Ruleset = new OsuRuleset().RulesetInfo,
+                    },
+                });
                 editorBeatmap.HitObjectUpdated += h => changedObject = h;
             });
 
@@ -111,7 +138,14 @@ namespace osu.Game.Tests.Beatmaps
         public void TestRemovedHitObjectStartTimeChangeEvent()
         {
             var hitCircle = new HitCircle();
-            var editorBeatmap = new EditorBeatmap(new OsuBeatmap { HitObjects = { hitCircle } });
+            var editorBeatmap = new EditorBeatmap(new OsuBeatmap
+            {
+                BeatmapInfo =
+                {
+                    Ruleset = new OsuRuleset().RulesetInfo,
+                },
+                HitObjects = { hitCircle }
+            });
 
             HitObject changedObject = null;
             editorBeatmap.HitObjectUpdated += h => changedObject = h;
@@ -131,6 +165,10 @@ namespace osu.Game.Tests.Beatmaps
         {
             var editorBeatmap = new EditorBeatmap(new OsuBeatmap
             {
+                BeatmapInfo =
+                {
+                    Ruleset = new OsuRuleset().RulesetInfo,
+                },
                 HitObjects =
                 {
                     new HitCircle(),
@@ -156,6 +194,10 @@ namespace osu.Game.Tests.Beatmaps
 
             var editorBeatmap = new EditorBeatmap(new OsuBeatmap
             {
+                BeatmapInfo =
+                {
+                    Ruleset = new OsuRuleset().RulesetInfo,
+                },
                 HitObjects =
                 {
                     new HitCircle(),
@@ -185,7 +227,13 @@ namespace osu.Game.Tests.Beatmaps
             {
                 updatedObjects.Clear();
 
-                Child = editorBeatmap = new EditorBeatmap(new OsuBeatmap());
+                Child = editorBeatmap = new EditorBeatmap(new OsuBeatmap
+                {
+                    BeatmapInfo =
+                    {
+                        Ruleset = new OsuRuleset().RulesetInfo,
+                    },
+                });
 
                 for (int i = 0; i < 10; i++)
                 {
@@ -220,7 +268,13 @@ namespace osu.Game.Tests.Beatmaps
             {
                 updatedObjects.Clear();
 
-                Child = editorBeatmap = new EditorBeatmap(new OsuBeatmap());
+                Child = editorBeatmap = new EditorBeatmap(new OsuBeatmap
+                {
+                    BeatmapInfo =
+                    {
+                        Ruleset = new OsuRuleset().RulesetInfo,
+                    },
+                });
                 editorBeatmap.Add(new HitCircle());
             });
 
diff --git a/osu.Game.Tests/Scores/IO/ImportScoreTest.cs b/osu.Game.Tests/Scores/IO/ImportScoreTest.cs
index 9b583494cb..2b6c9f76fc 100644
--- a/osu.Game.Tests/Scores/IO/ImportScoreTest.cs
+++ b/osu.Game.Tests/Scores/IO/ImportScoreTest.cs
@@ -9,11 +9,9 @@ using System.Threading.Tasks;
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Platform;
-using osu.Game.Beatmaps;
 using osu.Game.IO.Archives;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets.Mods;
-using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Osu.Mods;
 using osu.Game.Rulesets.Scoring;
 using osu.Game.Scoring;
@@ -151,12 +149,8 @@ namespace osu.Game.Tests.Scores.IO
 
         public static async Task<ScoreInfo> LoadScoreIntoOsu(OsuGameBase osu, ScoreInfo score, ArchiveReader archive = null)
         {
-            var beatmapManager = osu.Dependencies.Get<BeatmapManager>();
-
             // clone to avoid attaching the input score to realm.
             score = score.DeepClone();
-            score.BeatmapInfo ??= beatmapManager.GetAllUsableBeatmapSets().First().Beatmaps.First();
-            score.Ruleset ??= new OsuRuleset().RulesetInfo;
 
             var scoreManager = osu.Dependencies.Get<ScoreManager>();
             await scoreManager.Import(score, archive);
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs
index 7f7c97ac48..c6fb418a5b 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs
@@ -70,7 +70,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
                 var beatmap = new BeatmapInfo
                 {
-                    Ruleset = rulesets.GetRuleset(i % 4),
+                    Ruleset = rulesets.GetRuleset(i % 4) ?? throw new InvalidOperationException(),
                     OnlineID = beatmapId,
                     Length = length,
                     BPM = bpm,
diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneAdvancedStats.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneAdvancedStats.cs
index e916e8d9ac..bc3e8553f7 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneAdvancedStats.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneAdvancedStats.cs
@@ -67,7 +67,7 @@ namespace osu.Game.Tests.Visual.SongSelect
         {
             AddStep("set beatmap", () => advancedStats.BeatmapInfo = new BeatmapInfo
             {
-                Ruleset = rulesets.GetRuleset(3),
+                Ruleset = rulesets.GetRuleset(3) ?? throw new InvalidOperationException(),
                 BaseDifficulty = new BeatmapDifficulty
                 {
                     CircleSize = 5,
diff --git a/osu.Game.Tournament/TournamentGameBase.cs b/osu.Game.Tournament/TournamentGameBase.cs
index d08322a3e8..75b929273c 100644
--- a/osu.Game.Tournament/TournamentGameBase.cs
+++ b/osu.Game.Tournament/TournamentGameBase.cs
@@ -81,7 +81,7 @@ namespace osu.Game.Tournament
 
                 ladder ??= new LadderInfo();
 
-                ladder.Ruleset.Value = RulesetStore.GetRuleset(ladder.Ruleset.Value?.ShortName)
+                ladder.Ruleset.Value = RulesetStore.GetRuleset(ladder.Ruleset.Value.ShortName)
                                        ?? RulesetStore.AvailableRulesets.First();
 
                 bool addedInfo = false;
diff --git a/osu.Game/Online/API/Requests/Responses/APIScore.cs b/osu.Game/Online/API/Requests/Responses/APIScore.cs
index 71f277570d..d8f4ba835d 100644
--- a/osu.Game/Online/API/Requests/Responses/APIScore.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIScore.cs
@@ -86,7 +86,7 @@ namespace osu.Game.Online.API.Requests.Responses
         /// <returns></returns>
         public ScoreInfo CreateScoreInfo(RulesetStore rulesets, BeatmapInfo beatmap = null)
         {
-            var ruleset = rulesets.GetRuleset(RulesetID);
+            var ruleset = rulesets.GetRuleset(RulesetID) ?? throw new InvalidOperationException();
 
             var rulesetInstance = ruleset.CreateInstance();
 
@@ -99,7 +99,7 @@ namespace osu.Game.Online.API.Requests.Responses
             {
                 TotalScore = TotalScore,
                 MaxCombo = MaxCombo,
-                BeatmapInfo = beatmap,
+                BeatmapInfo = beatmap ?? new BeatmapInfo(),
                 User = User,
                 Accuracy = Accuracy,
                 OnlineID = OnlineID,
diff --git a/osu.Game/Online/Rooms/MultiplayerScore.cs b/osu.Game/Online/Rooms/MultiplayerScore.cs
index b90680a925..f1bb57bd9d 100644
--- a/osu.Game/Online/Rooms/MultiplayerScore.cs
+++ b/osu.Game/Online/Rooms/MultiplayerScore.cs
@@ -73,7 +73,7 @@ namespace osu.Game.Online.Rooms
                 TotalScore = TotalScore,
                 MaxCombo = MaxCombo,
                 BeatmapInfo = beatmap,
-                Ruleset = rulesets.GetRuleset(playlistItem.RulesetID),
+                Ruleset = rulesets.GetRuleset(playlistItem.RulesetID) ?? throw new InvalidOperationException(),
                 Statistics = Statistics,
                 User = User,
                 Accuracy = Accuracy,
diff --git a/osu.Game/Overlays/Profile/Sections/Ranks/DrawableProfileScore.cs b/osu.Game/Overlays/Profile/Sections/Ranks/DrawableProfileScore.cs
index 562be0403e..998f5d158e 100644
--- a/osu.Game/Overlays/Profile/Sections/Ranks/DrawableProfileScore.cs
+++ b/osu.Game/Overlays/Profile/Sections/Ranks/DrawableProfileScore.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.Diagnostics;
 using System.Linq;
 using JetBrains.Annotations;
@@ -131,9 +132,14 @@ namespace osu.Game.Overlays.Profile.Sections.Ranks
                                         Origin = Anchor.CentreRight,
                                         Direction = FillDirection.Horizontal,
                                         Spacing = new Vector2(2),
-                                        Children = Score.Mods.Select(mod => new ModIcon(rulesets.GetRuleset(Score.RulesetID).CreateInstance().CreateModFromAcronym(mod.Acronym))
+                                        Children = Score.Mods.Select(mod =>
                                         {
-                                            Scale = new Vector2(0.35f)
+                                            var ruleset = rulesets.GetRuleset(Score.RulesetID) ?? throw new InvalidOperationException();
+
+                                            return new ModIcon(ruleset.CreateInstance().CreateModFromAcronym(mod.Acronym))
+                                            {
+                                                Scale = new Vector2(0.35f)
+                                            };
                                         }).ToList(),
                                     }
                                 }
diff --git a/osu.Game/Rulesets/Edit/Checks/CheckBackgroundQuality.cs b/osu.Game/Rulesets/Edit/Checks/CheckBackgroundQuality.cs
index 7ce2ee802e..1f65752fa6 100644
--- a/osu.Game/Rulesets/Edit/Checks/CheckBackgroundQuality.cs
+++ b/osu.Game/Rulesets/Edit/Checks/CheckBackgroundQuality.cs
@@ -48,7 +48,7 @@ namespace osu.Game.Rulesets.Edit.Checks
             else if (texture.Width < low_width || texture.Height < low_height)
                 yield return new IssueTemplateLowResolution(this).Create(texture.Width, texture.Height);
 
-            string storagePath = context.Beatmap.BeatmapInfo.BeatmapSet.GetPathForFile(backgroundFile);
+            string storagePath = context.Beatmap.BeatmapInfo.BeatmapSet?.GetPathForFile(backgroundFile);
 
             using (Stream stream = context.WorkingBeatmap.GetStream(storagePath))
             {
diff --git a/osu.Game/Rulesets/Edit/Checks/CheckFilePresence.cs b/osu.Game/Rulesets/Edit/Checks/CheckFilePresence.cs
index 33bcac1e75..a1605a11d0 100644
--- a/osu.Game/Rulesets/Edit/Checks/CheckFilePresence.cs
+++ b/osu.Game/Rulesets/Edit/Checks/CheckFilePresence.cs
@@ -33,7 +33,7 @@ namespace osu.Game.Rulesets.Edit.Checks
             }
 
             // If the file is set, also make sure it still exists.
-            string storagePath = context.Beatmap.BeatmapInfo.BeatmapSet.GetPathForFile(filename);
+            string storagePath = context.Beatmap.BeatmapInfo.BeatmapSet?.GetPathForFile(filename);
             if (storagePath != null)
                 yield break;
 
diff --git a/osu.Game/Rulesets/Edit/Checks/CheckTooShortAudioFiles.cs b/osu.Game/Rulesets/Edit/Checks/CheckTooShortAudioFiles.cs
index 381ebd4af6..6015d0a1b2 100644
--- a/osu.Game/Rulesets/Edit/Checks/CheckTooShortAudioFiles.cs
+++ b/osu.Game/Rulesets/Edit/Checks/CheckTooShortAudioFiles.cs
@@ -30,32 +30,35 @@ namespace osu.Game.Rulesets.Edit.Checks
         {
             var beatmapSet = context.Beatmap.BeatmapInfo.BeatmapSet;
 
-            foreach (var file in beatmapSet.Files)
+            if (beatmapSet != null)
             {
-                using (Stream data = context.WorkingBeatmap.GetStream(file.File.GetStoragePath()))
+                foreach (var file in beatmapSet.Files)
                 {
-                    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 (decodeStream == 0)
+                    using (Stream data = context.WorkingBeatmap.GetStream(file.File.GetStoragePath()))
                     {
-                        // 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 (hasAudioExtension(file.Filename) && probablyHasAudioData(data))
-                            yield return new IssueTemplateBadFormat(this).Create(file.Filename);
+                        if (data == null)
+                            continue;
 
-                        continue;
+                        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 (hasAudioExtension(file.Filename) && probablyHasAudioData(data))
+                                yield return new IssueTemplateBadFormat(this).Create(file.Filename);
+
+                            continue;
+                        }
+
+                        long length = Bass.ChannelGetLength(decodeStream);
+                        double ms = Bass.ChannelBytes2Seconds(decodeStream, length) * 1000;
+
+                        // Extremely short audio files do not play on some soundcards, resulting in nothing being heard in-game for some users.
+                        if (ms > 0 && ms < ms_threshold)
+                            yield return new IssueTemplateTooShort(this).Create(file.Filename, ms);
                     }
-
-                    long length = Bass.ChannelGetLength(decodeStream);
-                    double ms = Bass.ChannelBytes2Seconds(decodeStream, length) * 1000;
-
-                    // Extremely short audio files do not play on some soundcards, resulting in nothing being heard in-game for some users.
-                    if (ms > 0 && ms < ms_threshold)
-                        yield return new IssueTemplateTooShort(this).Create(file.Filename, ms);
                 }
             }
         }
diff --git a/osu.Game/Rulesets/Edit/Checks/CheckZeroByteFiles.cs b/osu.Game/Rulesets/Edit/Checks/CheckZeroByteFiles.cs
index 324ebe6b50..75cb08002f 100644
--- a/osu.Game/Rulesets/Edit/Checks/CheckZeroByteFiles.cs
+++ b/osu.Game/Rulesets/Edit/Checks/CheckZeroByteFiles.cs
@@ -21,12 +21,15 @@ namespace osu.Game.Rulesets.Edit.Checks
         {
             var beatmapSet = context.Beatmap.BeatmapInfo.BeatmapSet;
 
-            foreach (var file in beatmapSet.Files)
+            if (beatmapSet != null)
             {
-                using (Stream data = context.WorkingBeatmap.GetStream(file.File.GetStoragePath()))
+                foreach (var file in beatmapSet.Files)
                 {
-                    if (data?.Length == 0)
-                        yield return new IssueTemplateZeroBytes(this).Create(file.Filename);
+                    using (Stream data = context.WorkingBeatmap.GetStream(file.File.GetStoragePath()))
+                    {
+                        if (data?.Length == 0)
+                            yield return new IssueTemplateZeroBytes(this).Create(file.Filename);
+                    }
                 }
             }
         }
diff --git a/osu.Game/Rulesets/Mods/DifficultyAdjustSettingsControl.cs b/osu.Game/Rulesets/Mods/DifficultyAdjustSettingsControl.cs
index 67b24d24d0..5d7565e56b 100644
--- a/osu.Game/Rulesets/Mods/DifficultyAdjustSettingsControl.cs
+++ b/osu.Game/Rulesets/Mods/DifficultyAdjustSettingsControl.cs
@@ -76,9 +76,6 @@ namespace osu.Game.Rulesets.Mods
 
             var difficulty = beatmap.Value.BeatmapInfo.BaseDifficulty;
 
-            if (difficulty == null)
-                return;
-
             // generally should always be implemented, else the slider will have a zero default.
             if (difficultyBindable.ReadCurrentFromDifficulty == null)
                 return;
diff --git a/osu.Game/Screens/Edit/Components/Menus/DifficultyMenuItem.cs b/osu.Game/Screens/Edit/Components/Menus/DifficultyMenuItem.cs
index 75dc479c25..f17fe4c3ce 100644
--- a/osu.Game/Screens/Edit/Components/Menus/DifficultyMenuItem.cs
+++ b/osu.Game/Screens/Edit/Components/Menus/DifficultyMenuItem.cs
@@ -13,7 +13,7 @@ namespace osu.Game.Screens.Edit.Components.Menus
         public BeatmapInfo BeatmapInfo { get; }
 
         public DifficultyMenuItem(BeatmapInfo beatmapInfo, bool selected, Action<BeatmapInfo> difficultyChangeFunc)
-            : base(beatmapInfo.DifficultyName ?? "(unnamed)", null)
+            : base(string.IsNullOrEmpty(beatmapInfo.DifficultyName) ? "(unnamed)" : beatmapInfo.DifficultyName, null)
         {
             BeatmapInfo = beatmapInfo;
             State.Value = selected;
diff --git a/osu.Game/Screens/Edit/Compose/ComposeScreen.cs b/osu.Game/Screens/Edit/Compose/ComposeScreen.cs
index 9386538a78..2bdf59b21c 100644
--- a/osu.Game/Screens/Edit/Compose/ComposeScreen.cs
+++ b/osu.Game/Screens/Edit/Compose/ComposeScreen.cs
@@ -40,7 +40,7 @@ namespace osu.Game.Screens.Edit.Compose
         {
             var dependencies = new DependencyContainer(base.CreateChildDependencies(parent));
 
-            ruleset = parent.Get<IBindable<WorkingBeatmap>>().Value.BeatmapInfo.Ruleset?.CreateInstance();
+            ruleset = parent.Get<IBindable<WorkingBeatmap>>().Value.BeatmapInfo.Ruleset.CreateInstance();
             composer = ruleset?.CreateHitObjectComposer();
 
             // make the composer available to the timeline and other components in this screen.
diff --git a/osu.Game/Screens/Edit/Editor.cs b/osu.Game/Screens/Edit/Editor.cs
index 383b59dc01..8c4b458534 100644
--- a/osu.Game/Screens/Edit/Editor.cs
+++ b/osu.Game/Screens/Edit/Editor.cs
@@ -599,7 +599,8 @@ namespace osu.Game.Screens.Edit
             if (isNewBeatmap)
             {
                 // confirming exit without save means we should delete the new beatmap completely.
-                beatmapManager.Delete(playableBeatmap.BeatmapInfo.BeatmapSet);
+                if (playableBeatmap.BeatmapInfo.BeatmapSet != null)
+                    beatmapManager.Delete(playableBeatmap.BeatmapInfo.BeatmapSet);
 
                 // eagerly clear contents before restoring default beatmap to prevent value change callbacks from firing.
                 ClearInternal();
diff --git a/osu.Game/Screens/Edit/EditorBeatmap.cs b/osu.Game/Screens/Edit/EditorBeatmap.cs
index 98fad09192..c9449f3259 100644
--- a/osu.Game/Screens/Edit/EditorBeatmap.cs
+++ b/osu.Game/Screens/Edit/EditorBeatmap.cs
@@ -102,7 +102,7 @@ namespace osu.Game.Screens.Edit
             if (beatmapSkin is Skin skin)
                 BeatmapSkin = new EditorBeatmapSkin(skin);
 
-            beatmapProcessor = playableBeatmap.BeatmapInfo.Ruleset?.CreateInstance().CreateBeatmapProcessor(PlayableBeatmap);
+            beatmapProcessor = playableBeatmap.BeatmapInfo.Ruleset.CreateInstance().CreateBeatmapProcessor(PlayableBeatmap);
 
             foreach (var obj in HitObjects)
                 trackStartTime(obj);
diff --git a/osu.Game/Screens/Edit/Setup/SetupScreen.cs b/osu.Game/Screens/Edit/Setup/SetupScreen.cs
index 8d726f7752..231d977aab 100644
--- a/osu.Game/Screens/Edit/Setup/SetupScreen.cs
+++ b/osu.Game/Screens/Edit/Setup/SetupScreen.cs
@@ -33,7 +33,7 @@ namespace osu.Game.Screens.Edit.Setup
                 new DesignSection(),
             };
 
-            var rulesetSpecificSection = beatmap.BeatmapInfo.Ruleset?.CreateInstance().CreateEditorSetupSection();
+            var rulesetSpecificSection = beatmap.BeatmapInfo.Ruleset.CreateInstance().CreateEditorSetupSection();
             if (rulesetSpecificSection != null)
                 sectionsEnumerable.Add(rulesetSpecificSection);
 
diff --git a/osu.Game/Screens/Ranking/Statistics/StatisticsPanel.cs b/osu.Game/Screens/Ranking/Statistics/StatisticsPanel.cs
index 827e128467..567a2307dd 100644
--- a/osu.Game/Screens/Ranking/Statistics/StatisticsPanel.cs
+++ b/osu.Game/Screens/Ranking/Statistics/StatisticsPanel.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.Linq;
 using System.Threading;
 using System.Threading.Tasks;
@@ -13,7 +12,6 @@ using osu.Framework.Input.Events;
 using osu.Game.Beatmaps;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Online.Placeholders;
-using osu.Game.Rulesets.Mods;
 using osu.Game.Scoring;
 using osuTK;
 
@@ -76,7 +74,7 @@ namespace osu.Game.Screens.Ranking.Statistics
             if (newScore == null)
                 return;
 
-            if (newScore.HitEvents == null || newScore.HitEvents.Count == 0)
+            if (newScore.HitEvents.Count == 0)
             {
                 content.Add(new FillFlowContainer
                 {
@@ -104,7 +102,7 @@ namespace osu.Game.Screens.Ranking.Statistics
                 // Todo: The placement of this is temporary. Eventually we'll both generate the playable beatmap _and_ run through it in a background task to generate the hit events.
                 Task.Run(() =>
                 {
-                    playableBeatmap = beatmapManager.GetWorkingBeatmap(newScore.BeatmapInfo).GetPlayableBeatmap(newScore.Ruleset, newScore.Mods ?? Array.Empty<Mod>());
+                    playableBeatmap = beatmapManager.GetWorkingBeatmap(newScore.BeatmapInfo).GetPlayableBeatmap(newScore.Ruleset, newScore.Mods);
                 }, loadCancellation.Token).ContinueWith(t => Schedule(() =>
                 {
                     var rows = new FillFlowContainer
diff --git a/osu.Game/Screens/Select/BeatmapInfoWedge.cs b/osu.Game/Screens/Select/BeatmapInfoWedge.cs
index b37877b35f..ea531e89c8 100644
--- a/osu.Game/Screens/Select/BeatmapInfoWedge.cs
+++ b/osu.Game/Screens/Select/BeatmapInfoWedge.cs
@@ -324,7 +324,7 @@ namespace osu.Game.Screens.Select
                 });
 
                 // no difficulty means it can't have a status to show
-                if (beatmapInfo.DifficultyName == null)
+                if (string.IsNullOrEmpty(beatmapInfo.DifficultyName))
                     StatusPill.Hide();
 
                 addInfoLabels();
diff --git a/osu.Game/Screens/Select/FilterControl.cs b/osu.Game/Screens/Select/FilterControl.cs
index e54b25873b..b53d64260a 100644
--- a/osu.Game/Screens/Select/FilterControl.cs
+++ b/osu.Game/Screens/Select/FilterControl.cs
@@ -53,7 +53,7 @@ namespace osu.Game.Screens.Select
             if (!maximumStars.IsDefault)
                 criteria.UserStarDifficulty.Max = maximumStars.Value;
 
-            criteria.RulesetCriteria = ruleset.Value.CreateInstance()?.CreateRulesetFilterCriteria();
+            criteria.RulesetCriteria = ruleset.Value.CreateInstance().CreateRulesetFilterCriteria();
 
             FilterQueryParser.ApplyQueries(criteria, query);
             return criteria;
diff --git a/osu.Game/Tests/Beatmaps/HitObjectSampleTest.cs b/osu.Game/Tests/Beatmaps/HitObjectSampleTest.cs
index 4e955975a0..10cb210f4d 100644
--- a/osu.Game/Tests/Beatmaps/HitObjectSampleTest.cs
+++ b/osu.Game/Tests/Beatmaps/HitObjectSampleTest.cs
@@ -98,6 +98,8 @@ namespace osu.Game.Tests.Beatmaps
                 userSkinInfo.Files.Clear();
                 userSkinInfo.Files.Add(new RealmNamedFileUsage(new RealmFile { Hash = userFile }, userFile));
 
+                Debug.Assert(beatmapInfo.BeatmapSet != null);
+
                 beatmapInfo.BeatmapSet.Files.Clear();
                 beatmapInfo.BeatmapSet.Files.Add(new RealmNamedFileUsage(new RealmFile { Hash = beatmapFile }, beatmapFile));
 

From b5f670cc5b2649b4b0dbecd2098588ca092444c2 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 12 Jan 2022 23:17:35 +0900
Subject: [PATCH 2157/5547] Add far too many fixes for ruleset non-nullable
 requirements

---
 .../Editor/CatchSelectionBlueprintTestScene.cs        |  8 +++++++-
 .../Editor/TestSceneManiaBeatSnapGrid.cs              |  8 +++++++-
 .../Editor/TestSceneManiaComposeScreen.cs             |  4 ++--
 .../Editor/TestSceneManiaHitObjectComposer.cs         |  4 ++--
 .../Editor/TestSceneOsuDistanceSnapGrid.cs            |  8 +++++++-
 .../Editor/TestSceneTaikoHitObjectComposer.cs         |  4 ++--
 osu.Game.Tests/Editing/EditorChangeHandlerTest.cs     | 11 +++++++++--
 .../TestSceneHitObjectComposerDistanceSnapping.cs     |  8 +++++++-
 osu.Game.Tests/Scores/IO/ImportScoreTest.cs           | 11 +++++++++++
 .../Visual/Editing/TestSceneDesignSection.cs          |  9 ++++++++-
 .../Visual/Editing/TestSceneDistanceSnapGrid.cs       |  9 ++++++++-
 .../Visual/Editing/TestSceneHitObjectComposer.cs      |  9 ++++++++-
 .../Visual/Editing/TestSceneMetadataSection.cs        |  9 ++++++++-
 osu.Game.Tests/Visual/Editing/TestSceneSetupScreen.cs |  8 +++++++-
 osu.Game.Tournament/TournamentGameBase.cs             |  5 +++--
 15 files changed, 96 insertions(+), 19 deletions(-)

diff --git a/osu.Game.Rulesets.Catch.Tests/Editor/CatchSelectionBlueprintTestScene.cs b/osu.Game.Rulesets.Catch.Tests/Editor/CatchSelectionBlueprintTestScene.cs
index d4c2c0f0af..e345e03c96 100644
--- a/osu.Game.Rulesets.Catch.Tests/Editor/CatchSelectionBlueprintTestScene.cs
+++ b/osu.Game.Rulesets.Catch.Tests/Editor/CatchSelectionBlueprintTestScene.cs
@@ -29,7 +29,13 @@ namespace osu.Game.Rulesets.Catch.Tests.Editor
 
         protected CatchSelectionBlueprintTestScene()
         {
-            EditorBeatmap = new EditorBeatmap(new CatchBeatmap()) { Difficulty = { CircleSize = 0 } };
+            EditorBeatmap = new EditorBeatmap(new CatchBeatmap
+            {
+                BeatmapInfo =
+                {
+                    Ruleset = new CatchRuleset().RulesetInfo,
+                }
+            }) { Difficulty = { CircleSize = 0 } };
             EditorBeatmap.ControlPointInfo.Add(0, new TimingControlPoint
             {
                 BeatLength = 100
diff --git a/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneManiaBeatSnapGrid.cs b/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneManiaBeatSnapGrid.cs
index 5ccb191a9b..50be13c4e0 100644
--- a/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneManiaBeatSnapGrid.cs
+++ b/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneManiaBeatSnapGrid.cs
@@ -29,7 +29,13 @@ namespace osu.Game.Rulesets.Mania.Tests.Editor
         private ScrollingTestContainer.TestScrollingInfo scrollingInfo = new ScrollingTestContainer.TestScrollingInfo();
 
         [Cached(typeof(EditorBeatmap))]
-        private EditorBeatmap editorBeatmap = new EditorBeatmap(new ManiaBeatmap(new StageDefinition()));
+        private EditorBeatmap editorBeatmap = new EditorBeatmap(new ManiaBeatmap(new StageDefinition())
+        {
+            BeatmapInfo =
+            {
+                Ruleset = new ManiaRuleset().RulesetInfo
+            }
+        });
 
         private readonly ManiaBeatSnapGrid beatSnapGrid;
 
diff --git a/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneManiaComposeScreen.cs b/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneManiaComposeScreen.cs
index a30e09cd29..5dd7c23ab6 100644
--- a/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneManiaComposeScreen.cs
+++ b/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneManiaComposeScreen.cs
@@ -31,10 +31,10 @@ namespace osu.Game.Rulesets.Mania.Tests.Editor
         {
             AddStep("setup compose screen", () =>
             {
-                var editorBeatmap = new EditorBeatmap(new ManiaBeatmap(new StageDefinition { Columns = 4 }))
+                var editorBeatmap = new EditorBeatmap(new ManiaBeatmap(new StageDefinition { Columns = 4 })
                 {
                     BeatmapInfo = { Ruleset = new ManiaRuleset().RulesetInfo },
-                };
+                });
 
                 Beatmap.Value = CreateWorkingBeatmap(editorBeatmap.PlayableBeatmap);
 
diff --git a/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneManiaHitObjectComposer.cs b/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneManiaHitObjectComposer.cs
index 01d80881fa..9788dfe844 100644
--- a/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneManiaHitObjectComposer.cs
+++ b/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneManiaHitObjectComposer.cs
@@ -203,10 +203,10 @@ namespace osu.Game.Rulesets.Mania.Tests.Editor
             {
                 InternalChildren = new Drawable[]
                 {
-                    EditorBeatmap = new EditorBeatmap(new ManiaBeatmap(new StageDefinition { Columns = 4 }))
+                    EditorBeatmap = new EditorBeatmap(new ManiaBeatmap(new StageDefinition { Columns = 4 })
                     {
                         BeatmapInfo = { Ruleset = new ManiaRuleset().RulesetInfo }
-                    },
+                    }),
                     Composer = new ManiaHitObjectComposer(new ManiaRuleset())
                 };
 
diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuDistanceSnapGrid.cs b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuDistanceSnapGrid.cs
index ef43c3a696..c770e2d96f 100644
--- a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuDistanceSnapGrid.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuDistanceSnapGrid.cs
@@ -40,7 +40,13 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
 
         public TestSceneOsuDistanceSnapGrid()
         {
-            editorBeatmap = new EditorBeatmap(new OsuBeatmap());
+            editorBeatmap = new EditorBeatmap(new OsuBeatmap
+            {
+                BeatmapInfo =
+                {
+                    Ruleset = new OsuRuleset().RulesetInfo
+                }
+            });
         }
 
         [SetUp]
diff --git a/osu.Game.Rulesets.Taiko.Tests/Editor/TestSceneTaikoHitObjectComposer.cs b/osu.Game.Rulesets.Taiko.Tests/Editor/TestSceneTaikoHitObjectComposer.cs
index 626537053a..55eb2fa66b 100644
--- a/osu.Game.Rulesets.Taiko.Tests/Editor/TestSceneTaikoHitObjectComposer.cs
+++ b/osu.Game.Rulesets.Taiko.Tests/Editor/TestSceneTaikoHitObjectComposer.cs
@@ -40,10 +40,10 @@ namespace osu.Game.Rulesets.Taiko.Tests.Editor
             {
                 InternalChildren = new Drawable[]
                 {
-                    EditorBeatmap = new EditorBeatmap(new TaikoBeatmap())
+                    EditorBeatmap = new EditorBeatmap(new TaikoBeatmap
                     {
                         BeatmapInfo = { Ruleset = new TaikoRuleset().RulesetInfo }
-                    },
+                    }),
                     new TaikoHitObjectComposer(new TaikoRuleset())
                 };
 
diff --git a/osu.Game.Tests/Editing/EditorChangeHandlerTest.cs b/osu.Game.Tests/Editing/EditorChangeHandlerTest.cs
index 481cb3230e..2d61948a2a 100644
--- a/osu.Game.Tests/Editing/EditorChangeHandlerTest.cs
+++ b/osu.Game.Tests/Editing/EditorChangeHandlerTest.cs
@@ -2,7 +2,8 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using NUnit.Framework;
-using osu.Game.Beatmaps;
+using osu.Game.Rulesets.Osu;
+using osu.Game.Rulesets.Osu.Beatmaps;
 using osu.Game.Rulesets.Osu.Objects;
 using osu.Game.Screens.Edit;
 
@@ -158,7 +159,13 @@ namespace osu.Game.Tests.Editing
 
         private (EditorChangeHandler, EditorBeatmap) createChangeHandler()
         {
-            var beatmap = new EditorBeatmap(new Beatmap());
+            var beatmap = new EditorBeatmap(new OsuBeatmap
+            {
+                BeatmapInfo =
+                {
+                    Ruleset = new OsuRuleset().RulesetInfo,
+                },
+            });
 
             var changeHandler = new EditorChangeHandler(beatmap);
 
diff --git a/osu.Game.Tests/Editing/TestSceneHitObjectComposerDistanceSnapping.cs b/osu.Game.Tests/Editing/TestSceneHitObjectComposerDistanceSnapping.cs
index 8eb9452736..43f22e4e90 100644
--- a/osu.Game.Tests/Editing/TestSceneHitObjectComposerDistanceSnapping.cs
+++ b/osu.Game.Tests/Editing/TestSceneHitObjectComposerDistanceSnapping.cs
@@ -35,7 +35,13 @@ namespace osu.Game.Tests.Editing
                 RelativeSizeAxes = Axes.Both,
                 Children = new Drawable[]
                 {
-                    editorBeatmap = new EditorBeatmap(new OsuBeatmap()),
+                    editorBeatmap = new EditorBeatmap(new OsuBeatmap
+                    {
+                        BeatmapInfo =
+                        {
+                            Ruleset = new OsuRuleset().RulesetInfo,
+                        },
+                    }),
                     Content = new Container
                     {
                         RelativeSizeAxes = Axes.Both,
diff --git a/osu.Game.Tests/Scores/IO/ImportScoreTest.cs b/osu.Game.Tests/Scores/IO/ImportScoreTest.cs
index 2b6c9f76fc..0e6d560167 100644
--- a/osu.Game.Tests/Scores/IO/ImportScoreTest.cs
+++ b/osu.Game.Tests/Scores/IO/ImportScoreTest.cs
@@ -9,9 +9,11 @@ using System.Threading.Tasks;
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Platform;
+using osu.Game.Beatmaps;
 using osu.Game.IO.Archives;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets.Mods;
+using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Osu.Mods;
 using osu.Game.Rulesets.Scoring;
 using osu.Game.Scoring;
@@ -39,6 +41,8 @@ namespace osu.Game.Tests.Scores.IO
                         User = new APIUser { Username = "Test user" },
                         Date = DateTimeOffset.Now,
                         OnlineID = 12345,
+                        Ruleset = new OsuRuleset().RulesetInfo,
+                        BeatmapInfo = new BeatmapInfo()
                     };
 
                     var imported = await LoadScoreIntoOsu(osu, toImport);
@@ -70,6 +74,8 @@ namespace osu.Game.Tests.Scores.IO
                     var toImport = new ScoreInfo
                     {
                         User = new APIUser { Username = "Test user" },
+                        BeatmapInfo = new BeatmapInfo(),
+                        Ruleset = new OsuRuleset().RulesetInfo,
                         Mods = new Mod[] { new OsuModHardRock(), new OsuModDoubleTime() },
                     };
 
@@ -97,6 +103,8 @@ namespace osu.Game.Tests.Scores.IO
                     var toImport = new ScoreInfo
                     {
                         User = new APIUser { Username = "Test user" },
+                        BeatmapInfo = new BeatmapInfo(),
+                        Ruleset = new OsuRuleset().RulesetInfo,
                         Statistics = new Dictionary<HitResult, int>
                         {
                             { HitResult.Perfect, 100 },
@@ -128,6 +136,8 @@ namespace osu.Game.Tests.Scores.IO
                     await LoadScoreIntoOsu(osu, new ScoreInfo
                     {
                         User = new APIUser { Username = "Test user" },
+                        BeatmapInfo = new BeatmapInfo(),
+                        Ruleset = new OsuRuleset().RulesetInfo,
                         OnlineID = 2
                     }, new TestArchiveReader());
 
@@ -137,6 +147,7 @@ namespace osu.Game.Tests.Scores.IO
                     Assert.That(scoreManager.IsAvailableLocally(new ScoreInfo
                     {
                         User = new APIUser { Username = "Test user" },
+                        BeatmapInfo = new BeatmapInfo(),
                         OnlineID = 2
                     }));
                 }
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneDesignSection.cs b/osu.Game.Tests/Visual/Editing/TestSceneDesignSection.cs
index 00f2979691..10917df075 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneDesignSection.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneDesignSection.cs
@@ -11,6 +11,7 @@ using osu.Framework.Graphics.UserInterface;
 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;
@@ -25,7 +26,13 @@ namespace osu.Game.Tests.Visual.Editing
         [SetUpSteps]
         public void SetUp()
         {
-            AddStep("create blank beatmap", () => editorBeatmap = new EditorBeatmap(new Beatmap()));
+            AddStep("create blank beatmap", () => editorBeatmap = new EditorBeatmap(new Beatmap
+            {
+                BeatmapInfo =
+                {
+                    Ruleset = new OsuRuleset().RulesetInfo
+                }
+            }));
             AddStep("create section", () => Child = new DependencyProvidingContainer
             {
                 RelativeSizeAxes = Axes.Both,
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneDistanceSnapGrid.cs b/osu.Game.Tests/Visual/Editing/TestSceneDistanceSnapGrid.cs
index d1efd22d6f..0d9e06e471 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneDistanceSnapGrid.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneDistanceSnapGrid.cs
@@ -8,6 +8,7 @@ using osu.Framework.Graphics.Shapes;
 using osu.Game.Beatmaps.ControlPoints;
 using osu.Game.Rulesets.Edit;
 using osu.Game.Rulesets.Objects;
+using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Osu.Beatmaps;
 using osu.Game.Screens.Edit;
 using osu.Game.Screens.Edit.Compose.Components;
@@ -29,7 +30,13 @@ namespace osu.Game.Tests.Visual.Editing
 
         public TestSceneDistanceSnapGrid()
         {
-            editorBeatmap = new EditorBeatmap(new OsuBeatmap());
+            editorBeatmap = new EditorBeatmap(new OsuBeatmap
+            {
+                BeatmapInfo =
+                {
+                    Ruleset = new OsuRuleset().RulesetInfo
+                }
+            });
             editorBeatmap.ControlPointInfo.Add(0, new TimingControlPoint { BeatLength = beat_length });
         }
 
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneHitObjectComposer.cs b/osu.Game.Tests/Visual/Editing/TestSceneHitObjectComposer.cs
index eee0d6672c..145d738f60 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneHitObjectComposer.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneHitObjectComposer.cs
@@ -39,9 +39,16 @@ namespace osu.Game.Tests.Visual.Editing
             {
                 Beatmap.Value = CreateWorkingBeatmap(new Beatmap
                 {
+                    BeatmapInfo =
+                    {
+                        Ruleset = new OsuRuleset().RulesetInfo
+                    },
                     HitObjects = new List<HitObject>
                     {
-                        new HitCircle { Position = new Vector2(256, 192), Scale = 0.5f },
+                        new HitCircle
+                        {
+                            Position = new Vector2(256, 192), Scale = 0.5f
+                        },
                         new HitCircle { Position = new Vector2(344, 148), Scale = 0.5f },
                         new Slider
                         {
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneMetadataSection.cs b/osu.Game.Tests/Visual/Editing/TestSceneMetadataSection.cs
index 4621436cc6..4ecfb0975b 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneMetadataSection.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneMetadataSection.cs
@@ -5,6 +5,7 @@ using NUnit.Framework;
 using osu.Framework.Allocation;
 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;
 
@@ -13,7 +14,13 @@ namespace osu.Game.Tests.Visual.Editing
     public class TestSceneMetadataSection : OsuTestScene
     {
         [Cached]
-        private EditorBeatmap editorBeatmap = new EditorBeatmap(new Beatmap());
+        private EditorBeatmap editorBeatmap = new EditorBeatmap(new Beatmap
+        {
+            BeatmapInfo =
+            {
+                Ruleset = new OsuRuleset().RulesetInfo
+            },
+        });
 
         private TestMetadataSection metadataSection;
 
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneSetupScreen.cs b/osu.Game.Tests/Visual/Editing/TestSceneSetupScreen.cs
index 03e78ce854..2f6cf46b21 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneSetupScreen.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneSetupScreen.cs
@@ -29,7 +29,13 @@ namespace osu.Game.Tests.Visual.Editing
 
         public TestSceneSetupScreen()
         {
-            editorBeatmap = new EditorBeatmap(new OsuBeatmap());
+            editorBeatmap = new EditorBeatmap(new OsuBeatmap
+            {
+                BeatmapInfo =
+                {
+                    Ruleset = new OsuRuleset().RulesetInfo
+                }
+            });
         }
 
         [Test]
diff --git a/osu.Game.Tournament/TournamentGameBase.cs b/osu.Game.Tournament/TournamentGameBase.cs
index 75b929273c..f318c8bd85 100644
--- a/osu.Game.Tournament/TournamentGameBase.cs
+++ b/osu.Game.Tournament/TournamentGameBase.cs
@@ -81,8 +81,9 @@ namespace osu.Game.Tournament
 
                 ladder ??= new LadderInfo();
 
-                ladder.Ruleset.Value = RulesetStore.GetRuleset(ladder.Ruleset.Value.ShortName)
-                                       ?? RulesetStore.AvailableRulesets.First();
+                ladder.Ruleset.Value = ladder.Ruleset.Value != null
+                    ? RulesetStore.GetRuleset(ladder.Ruleset.Value.ShortName)
+                    : RulesetStore.AvailableRulesets.First();
 
                 bool addedInfo = false;
 

From b2d09b7b10a577602c49f84f47eff3a5a5912a17 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 12 Jan 2022 23:42:12 +0900
Subject: [PATCH 2158/5547] Fix further warnings

---
 osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs     | 2 +-
 .../Visual/Playlists/TestScenePlaylistsRoomCreation.cs          | 2 ++
 osu.Game/Screens/Select/BeatmapClearScoresDialog.cs             | 2 +-
 osu.Game/Skinning/LegacyBeatmapSkin.cs                          | 2 +-
 osu.Game/Storyboards/Storyboard.cs                              | 2 +-
 5 files changed, 6 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs b/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs
index 677aaf6f78..6ec14e6351 100644
--- a/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs
+++ b/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs
@@ -117,7 +117,7 @@ namespace osu.Game.Tests.Beatmaps.Formats
                 Assert.AreEqual(string.Empty, metadata.Source);
                 Assert.AreEqual("MBC7 Unisphere 地球ヤバイEP Chikyu Yabai", metadata.Tags);
                 Assert.AreEqual(557821, beatmapInfo.OnlineID);
-                Assert.AreEqual(241526, beatmapInfo.BeatmapSet.OnlineID);
+                Assert.AreEqual(241526, beatmapInfo.BeatmapSet?.OnlineID);
             }
         }
 
diff --git a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs
index eacc3d5e31..2180f0f717 100644
--- a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs
+++ b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs
@@ -145,6 +145,8 @@ namespace osu.Game.Tests.Visual.Playlists
                 modifiedBeatmap.HitObjects.Clear();
                 modifiedBeatmap.HitObjects.Add(new HitCircle { StartTime = 5000 });
 
+                Debug.Assert(modifiedBeatmap.BeatmapInfo.BeatmapSet != null);
+
                 manager.Import(modifiedBeatmap.BeatmapInfo.BeatmapSet).WaitSafely();
             });
 
diff --git a/osu.Game/Screens/Select/BeatmapClearScoresDialog.cs b/osu.Game/Screens/Select/BeatmapClearScoresDialog.cs
index afae858b46..774d3b4b28 100644
--- a/osu.Game/Screens/Select/BeatmapClearScoresDialog.cs
+++ b/osu.Game/Screens/Select/BeatmapClearScoresDialog.cs
@@ -18,7 +18,7 @@ namespace osu.Game.Screens.Select
 
         public BeatmapClearScoresDialog(BeatmapInfo beatmapInfo, Action onCompletion)
         {
-            BodyText = $@"{beatmapInfo.Metadata?.Artist} - {beatmapInfo.Metadata?.Title}";
+            BodyText = beatmapInfo.GetDisplayTitle();
             Icon = FontAwesome.Solid.Eraser;
             HeaderText = @"Clearing all local scores. Are you sure?";
             Buttons = new PopupDialogButton[]
diff --git a/osu.Game/Skinning/LegacyBeatmapSkin.cs b/osu.Game/Skinning/LegacyBeatmapSkin.cs
index d44d3dce49..f80a980351 100644
--- a/osu.Game/Skinning/LegacyBeatmapSkin.cs
+++ b/osu.Game/Skinning/LegacyBeatmapSkin.cs
@@ -77,6 +77,6 @@ namespace osu.Game.Skinning
         }
 
         private static SkinInfo createSkinInfo(BeatmapInfo beatmapInfo) =>
-            new SkinInfo { Name = beatmapInfo.ToString(), Creator = beatmapInfo.Metadata?.Author.Username ?? string.Empty };
+            new SkinInfo { Name = beatmapInfo.ToString(), Creator = beatmapInfo.Metadata.Author.Username ?? string.Empty };
     }
 }
diff --git a/osu.Game/Storyboards/Storyboard.cs b/osu.Game/Storyboards/Storyboard.cs
index ff496aea36..b86deeab89 100644
--- a/osu.Game/Storyboards/Storyboard.cs
+++ b/osu.Game/Storyboards/Storyboard.cs
@@ -78,7 +78,7 @@ namespace osu.Game.Storyboards
         {
             get
             {
-                string backgroundPath = BeatmapInfo.BeatmapSet?.Metadata?.BackgroundFile;
+                string backgroundPath = BeatmapInfo.BeatmapSet?.Metadata.BackgroundFile;
 
                 if (string.IsNullOrEmpty(backgroundPath))
                     return false;

From 4c79145c11fc54f28ec9ef23f12520791f44df43 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 13 Jan 2022 00:28:16 +0900
Subject: [PATCH 2159/5547] Fix potential mod nullref in
 `APIUserScoreAggregate`'s `CreateScoreInfo` implementation

---
 .../Online/API/Requests/Responses/APIUserScoreAggregate.cs   | 5 ++++-
 osu.Game/Scoring/ScoreInfo.cs                                | 4 +---
 2 files changed, 5 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Online/API/Requests/Responses/APIUserScoreAggregate.cs b/osu.Game/Online/API/Requests/Responses/APIUserScoreAggregate.cs
index 9a7f0832a6..a298a8625a 100644
--- a/osu.Game/Online/API/Requests/Responses/APIUserScoreAggregate.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIUserScoreAggregate.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;
 using Newtonsoft.Json;
+using osu.Game.Rulesets.Mods;
 using osu.Game.Scoring;
 
 namespace osu.Game.Online.API.Requests.Responses
@@ -42,7 +44,8 @@ namespace osu.Game.Online.API.Requests.Responses
                 PP = PP,
                 TotalScore = TotalScore,
                 User = User,
-                Position = Position
+                Position = Position,
+                Mods = Array.Empty<Mod>()
             };
     }
 }
diff --git a/osu.Game/Scoring/ScoreInfo.cs b/osu.Game/Scoring/ScoreInfo.cs
index ffec54aca7..45e5b8f1a7 100644
--- a/osu.Game/Scoring/ScoreInfo.cs
+++ b/osu.Game/Scoring/ScoreInfo.cs
@@ -186,14 +186,12 @@ namespace osu.Game.Scoring
         {
             get
             {
-                var rulesetInstance = Ruleset.CreateInstance();
-
                 Mod[] scoreMods = Array.Empty<Mod>();
 
                 if (mods != null)
                     scoreMods = mods;
                 else if (localAPIMods != null)
-                    scoreMods = APIMods.Select(m => m.ToMod(rulesetInstance)).ToArray();
+                    scoreMods = APIMods.Select(m => m.ToMod(Ruleset.CreateInstance())).ToArray();
 
                 return scoreMods;
             }

From 2212bea17f46a36e21cb43a45978fcdde522636c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 13 Jan 2022 01:34:29 +0900
Subject: [PATCH 2160/5547] Fix test failures due to double `BeginPlaying`
 calls

---
 .../Visual/Background/TestSceneUserDimBackgrounds.cs | 12 +++++-------
 1 file changed, 5 insertions(+), 7 deletions(-)

diff --git a/osu.Game.Tests/Visual/Background/TestSceneUserDimBackgrounds.cs b/osu.Game.Tests/Visual/Background/TestSceneUserDimBackgrounds.cs
index b1f642b909..5b2cf877ba 100644
--- a/osu.Game.Tests/Visual/Background/TestSceneUserDimBackgrounds.cs
+++ b/osu.Game.Tests/Visual/Background/TestSceneUserDimBackgrounds.cs
@@ -36,7 +36,7 @@ using osuTK.Graphics;
 namespace osu.Game.Tests.Visual.Background
 {
     [TestFixture]
-    public class TestSceneUserDimBackgrounds : OsuManualInputManagerTestScene
+    public class TestSceneUserDimBackgrounds : ScreenTestScene
     {
         private DummySongSelect songSelect;
         private TestPlayerLoader playerLoader;
@@ -56,14 +56,12 @@ namespace osu.Game.Tests.Visual.Background
             Beatmap.SetDefault();
         }
 
-        [SetUp]
-        public virtual void SetUp() => Schedule(() =>
+        public override void SetUpSteps()
         {
-            var stack = new OsuScreenStack { RelativeSizeAxes = Axes.Both };
-            Child = stack;
+            base.SetUpSteps();
 
-            stack.Push(songSelect = new DummySongSelect());
-        });
+            AddStep("push song select", () => Stack.Push(songSelect = new DummySongSelect()));
+        }
 
         /// <summary>
         /// User settings should always be ignored on song select screen.

From afce976f086bc8aabe3b4d5f4ee6bcf63c91c5f7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 12 Jan 2022 19:24:59 +0100
Subject: [PATCH 2161/5547] Fix oversubscription to
 `StartTimeBindable.ValueChanged`

---
 osu.Game/Rulesets/Objects/HitObject.cs | 19 +++++++++++++------
 1 file changed, 13 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Rulesets/Objects/HitObject.cs b/osu.Game/Rulesets/Objects/HitObject.cs
index 7d08261035..c590cc302f 100644
--- a/osu.Game/Rulesets/Objects/HitObject.cs
+++ b/osu.Game/Rulesets/Objects/HitObject.cs
@@ -136,10 +136,19 @@ namespace osu.Game.Rulesets.Objects
             foreach (var h in nestedHitObjects)
                 h.ApplyDefaults(controlPointInfo, difficulty, cancellationToken);
 
-            // importantly, this callback is only registered after default application
-            // to ensure that the read of `this.GetEndTime()` within doesn't return an invalid value
+            // `ApplyDefaults()` may be called multiple times on a single hitobject.
+            // to prevent subscribing to `StartTimeBindable.ValueChanged` multiple times with the same callback,
+            // remove the previous subscription (if present) before (re-)registering.
+            StartTimeBindable.ValueChanged -= onStartTimeChanged;
+
+            // this callback must be (re-)registered after default application
+            // to ensure that the read of `this.GetEndTime()` within `onStartTimeChanged` doesn't return an invalid value
             // if `StartTimeBindable` is changed prior to default application.
-            StartTimeBindable.ValueChanged += time =>
+            StartTimeBindable.ValueChanged += onStartTimeChanged;
+
+            DefaultsApplied?.Invoke(this);
+
+            void onStartTimeChanged(ValueChangedEvent<double> time)
             {
                 double offset = time.NewValue - time.OldValue;
 
@@ -148,9 +157,7 @@ namespace osu.Game.Rulesets.Objects
 
                 DifficultyControlPoint.Time = time.NewValue;
                 SampleControlPoint.Time = this.GetEndTime() + control_point_leniency;
-            };
-
-            DefaultsApplied?.Invoke(this);
+            }
         }
 
         protected virtual void ApplyDefaultsToSelf(ControlPointInfo controlPointInfo, IBeatmapDifficultyInfo difficulty)

From 672c1d36dc29a7580c6fb8028ac95d1a120de5b4 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 13 Jan 2022 05:52:04 +0900
Subject: [PATCH 2162/5547] Fix intermitten screen navigation tests

---
 .../Visual/Navigation/TestSceneScreenNavigation.cs  | 13 +++++++++----
 1 file changed, 9 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs b/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
index d094d8b688..60aabf5639 100644
--- a/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
@@ -251,8 +251,9 @@ namespace osu.Game.Tests.Visual.Navigation
         [Test]
         public void TestModSelectInput()
         {
-            TestPlaySongSelect songSelect = null;
+            AddUntilStep("Wait for toolbar to load", () => Game.Toolbar.IsLoaded);
 
+            TestPlaySongSelect songSelect = null;
             PushAndConfirm(() => songSelect = new TestPlaySongSelect());
 
             AddStep("Show mods overlay", () => songSelect.ModSelectOverlay.Show());
@@ -272,8 +273,9 @@ namespace osu.Game.Tests.Visual.Navigation
         [Test]
         public void TestBeatmapOptionsInput()
         {
-            TestPlaySongSelect songSelect = null;
+            AddUntilStep("Wait for toolbar to load", () => Game.Toolbar.IsLoaded);
 
+            TestPlaySongSelect songSelect = null;
             PushAndConfirm(() => songSelect = new TestPlaySongSelect());
 
             AddStep("Show options overlay", () => songSelect.BeatmapOptionsOverlay.Show());
@@ -293,6 +295,8 @@ namespace osu.Game.Tests.Visual.Navigation
         [Test]
         public void TestSettingsViaHotkeyFromMainMenu()
         {
+            AddUntilStep("Wait for toolbar to load", () => Game.Toolbar.IsLoaded);
+
             AddAssert("toolbar not displayed", () => Game.Toolbar.State.Value == Visibility.Hidden);
 
             AddStep("press settings hotkey", () =>
@@ -308,10 +312,11 @@ namespace osu.Game.Tests.Visual.Navigation
         [Test]
         public void TestToolbarHiddenByUser()
         {
-            AddStep("Enter menu", () => InputManager.Key(Key.Enter));
-
             AddUntilStep("Wait for toolbar to load", () => Game.Toolbar.IsLoaded);
 
+            AddStep("Enter menu", () => InputManager.Key(Key.Enter));
+            AddUntilStep("Toolbar is visible", () => Game.Toolbar.State.Value == Visibility.Visible);
+
             AddStep("Hide toolbar", () =>
             {
                 InputManager.PressKey(Key.ControlLeft);

From 5185f6010e177c69b62f3a20de4bc73582c803b3 Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Wed, 12 Jan 2022 15:46:20 -0800
Subject: [PATCH 2163/5547] Fix missed identifier typos

---
 osu.Game/Rulesets/Objects/Drawables/DrawableHitObject.cs | 4 ++--
 osu.sln.DotSettings                                      | 7 ++++++-
 2 files changed, 8 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Rulesets/Objects/Drawables/DrawableHitObject.cs b/osu.Game/Rulesets/Objects/Drawables/DrawableHitObject.cs
index 4ab513bf19..5531bf8b5a 100644
--- a/osu.Game/Rulesets/Objects/Drawables/DrawableHitObject.cs
+++ b/osu.Game/Rulesets/Objects/Drawables/DrawableHitObject.cs
@@ -533,9 +533,9 @@ namespace osu.Game.Rulesets.Objects.Drawables
         protected double CalculateSamplePlaybackBalance(double position)
         {
             float balanceAdjustAmount = positionalHitsoundsLevel.Value * 2;
-            double returnedvalue = balanceAdjustAmount * (position - 0.5f);
+            double returnedValue = balanceAdjustAmount * (position - 0.5f);
 
-            return returnedvalue;
+            return returnedValue;
         }
 
         /// <summary>
diff --git a/osu.sln.DotSettings b/osu.sln.DotSettings
index a9b2a652f9..fcb35907a3 100644
--- a/osu.sln.DotSettings
+++ b/osu.sln.DotSettings
@@ -946,6 +946,7 @@ private void load()
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Gamefield/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=gameplay/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Geki/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Hashable/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Hitnormal/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=hitobject/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=hitobjects/@EntryIndexedValue">True</s:Boolean>
@@ -957,6 +958,7 @@ private void load()
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=keymods/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Kiai/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Kudosu/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Lazer/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Leaderboard/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Leaderboards/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=letterboxing/@EntryIndexedValue">True</s:Boolean>
@@ -986,6 +988,7 @@ private void load()
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=ruleset_0027s/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Scorable/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=seeya/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Skinnable/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Snappable/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Soleily/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Spinnable/@EntryIndexedValue">True</s:Boolean>
@@ -993,8 +996,10 @@ private void load()
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Taiko/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=undim/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=undownloadable/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Unescaping/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Unhover/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Unhovered/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Unplayed/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Unproxy/@EntryIndexedValue">True</s:Boolean>
-	<s:Boolean x:Key="/Default/UserDictionary/Words/=Unranked/@EntryIndexedValue">True</s:Boolean></wpf:ResourceDictionary>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Unranked/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Zoomable/@EntryIndexedValue">True</s:Boolean></wpf:ResourceDictionary>

From 66773f6d7d26436ac4b0c751f70c17f09cd1fb95 Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Wed, 12 Jan 2022 15:49:28 -0800
Subject: [PATCH 2164/5547] Use comments to disable identifier typos instead

---
 osu.Desktop/Windows/WindowsKey.cs                            | 5 ++---
 .../Online/API/Requests/GetUserRecentActivitiesRequest.cs    | 4 ++--
 2 files changed, 4 insertions(+), 5 deletions(-)

diff --git a/osu.Desktop/Windows/WindowsKey.cs b/osu.Desktop/Windows/WindowsKey.cs
index ec4d3f5d74..fdca2028d3 100644
--- a/osu.Desktop/Windows/WindowsKey.cs
+++ b/osu.Desktop/Windows/WindowsKey.cs
@@ -2,12 +2,12 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
-using System.Diagnostics.CodeAnalysis;
 using System.Runtime.InteropServices;
 
+// ReSharper disable IdentifierTypo
+
 namespace osu.Desktop.Windows
 {
-    [SuppressMessage("ReSharper", "IdentifierTypo")]
     internal class WindowsKey
     {
         private delegate int LowLevelKeyboardProcDelegate(int nCode, int wParam, ref KdDllHookStruct lParam);
@@ -16,7 +16,6 @@ namespace osu.Desktop.Windows
 
         private const int wh_keyboard_ll = 13;
         private const int wm_keydown = 256;
-
         private const int wm_syskeyup = 261;
 
         //Resharper disable once NotAccessedField.Local
diff --git a/osu.Game/Online/API/Requests/GetUserRecentActivitiesRequest.cs b/osu.Game/Online/API/Requests/GetUserRecentActivitiesRequest.cs
index 62b27b31b4..f2fa51bde7 100644
--- a/osu.Game/Online/API/Requests/GetUserRecentActivitiesRequest.cs
+++ b/osu.Game/Online/API/Requests/GetUserRecentActivitiesRequest.cs
@@ -2,7 +2,6 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System.Collections.Generic;
-using System.Diagnostics.CodeAnalysis;
 using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Online.API.Requests
@@ -20,10 +19,11 @@ namespace osu.Game.Online.API.Requests
         protected override string Target => $"users/{userId}/recent_activity";
     }
 
-    [SuppressMessage("ReSharper", "IdentifierTypo")]
     public enum RecentActivityType
     {
         Achievement,
+
+        // ReSharper disable once IdentifierTypo
         BeatmapPlaycount,
         BeatmapsetApprove,
         BeatmapsetDelete,

From a18b2836262d4fb2c925ccc9d6d726f78fc3af44 Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Wed, 12 Jan 2022 15:52:33 -0800
Subject: [PATCH 2165/5547] Revert identifier typo bump

---
 osu.sln.DotSettings | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.sln.DotSettings b/osu.sln.DotSettings
index fcb35907a3..c29d812fc5 100644
--- a/osu.sln.DotSettings
+++ b/osu.sln.DotSettings
@@ -91,7 +91,7 @@
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=FieldCanBeMadeReadOnly_002ELocal/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=ForCanBeConvertedToForeach/@EntryIndexedValue">HINT</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=ForStatementConditionIsTrue/@EntryIndexedValue">DO_NOT_SHOW</s:String>
-	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=IdentifierTypo/@EntryIndexedValue">WARNING</s:String>
+	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=IdentifierTypo/@EntryIndexedValue">HINT</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=ImpureMethodCallOnReadonlyValueField/@EntryIndexedValue">HINT</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=InconsistentNaming/@EntryIndexedValue">ERROR</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=IncorrectBlankLinesNearBraces/@EntryIndexedValue">WARNING</s:String>

From e1f5acd689c49fc2c5a100e2559a1c2d1b228fd2 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 13 Jan 2022 12:37:57 +0900
Subject: [PATCH 2166/5547] Remove names from user dictionary

---
 .../Visual/Online/TestSceneUserPanel.cs       | 33 +++++++++----------
 osu.sln.DotSettings                           |  2 --
 2 files changed, 15 insertions(+), 20 deletions(-)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneUserPanel.cs b/osu.Game.Tests/Visual/Online/TestSceneUserPanel.cs
index 52d5eb2c65..6c3678b0d2 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneUserPanel.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneUserPanel.cs
@@ -20,8 +20,8 @@ namespace osu.Game.Tests.Visual.Online
         private readonly Bindable<UserActivity> activity = new Bindable<UserActivity>();
         private readonly Bindable<UserStatus> status = new Bindable<UserStatus>();
 
-        private UserGridPanel peppy;
-        private TestUserListPanel evast;
+        private UserGridPanel boundPanel1;
+        private TestUserListPanel boundPanel2;
 
         [Resolved]
         private IRulesetStore rulesetStore { get; set; }
@@ -29,8 +29,6 @@ namespace osu.Game.Tests.Visual.Online
         [SetUp]
         public void SetUp() => Schedule(() =>
         {
-            UserGridPanel flyte;
-
             activity.Value = null;
             status.Value = null;
 
@@ -56,14 +54,15 @@ namespace osu.Game.Tests.Visual.Online
                         Colour = "99EB47",
                         CoverUrl = @"https://osu.ppy.sh/images/headers/profile-covers/c3.jpg",
                     }),
-                    flyte = new UserGridPanel(new APIUser
+                    new UserGridPanel(new APIUser
                     {
                         Username = @"flyte",
                         Id = 3103765,
                         Country = new Country { FlagName = @"JP" },
-                        CoverUrl = @"https://osu.ppy.sh/images/headers/profile-covers/c6.jpg"
+                        CoverUrl = @"https://osu.ppy.sh/images/headers/profile-covers/c6.jpg",
+                        Status = { Value = new UserStatusOnline() }
                     }) { Width = 300 },
-                    peppy = new UserGridPanel(new APIUser
+                    boundPanel1 = new UserGridPanel(new APIUser
                     {
                         Username = @"peppy",
                         Id = 2,
@@ -72,7 +71,7 @@ namespace osu.Game.Tests.Visual.Online
                         IsSupporter = true,
                         SupportLevel = 3,
                     }) { Width = 300 },
-                    evast = new TestUserListPanel(new APIUser
+                    boundPanel2 = new TestUserListPanel(new APIUser
                     {
                         Username = @"Evast",
                         Id = 8195163,
@@ -84,13 +83,11 @@ namespace osu.Game.Tests.Visual.Online
                 },
             };
 
-            flyte.Status.Value = new UserStatusOnline();
+            boundPanel1.Status.BindTo(status);
+            boundPanel1.Activity.BindTo(activity);
 
-            peppy.Status.BindTo(status);
-            peppy.Activity.BindTo(activity);
-
-            evast.Status.BindTo(status);
-            evast.Activity.BindTo(activity);
+            boundPanel2.Status.BindTo(status);
+            boundPanel2.Activity.BindTo(activity);
         });
 
         [Test]
@@ -121,14 +118,14 @@ namespace osu.Game.Tests.Visual.Online
         [Test]
         public void TestUserActivityChange()
         {
-            AddAssert("visit message is visible", () => evast.LastVisitMessage.IsPresent);
+            AddAssert("visit message is visible", () => boundPanel2.LastVisitMessage.IsPresent);
             AddStep("set online status", () => status.Value = new UserStatusOnline());
-            AddAssert("visit message is not visible", () => !evast.LastVisitMessage.IsPresent);
+            AddAssert("visit message is not visible", () => !boundPanel2.LastVisitMessage.IsPresent);
             AddStep("set choosing activity", () => activity.Value = new UserActivity.ChoosingBeatmap());
             AddStep("set offline status", () => status.Value = new UserStatusOffline());
-            AddAssert("visit message is visible", () => evast.LastVisitMessage.IsPresent);
+            AddAssert("visit message is visible", () => boundPanel2.LastVisitMessage.IsPresent);
             AddStep("set online status", () => status.Value = new UserStatusOnline());
-            AddAssert("visit message is not visible", () => !evast.LastVisitMessage.IsPresent);
+            AddAssert("visit message is not visible", () => !boundPanel2.LastVisitMessage.IsPresent);
         }
 
         private UserActivity soloGameStatusForRuleset(int rulesetId) => new UserActivity.InSoloGame(null, rulesetStore.GetRuleset(rulesetId));
diff --git a/osu.sln.DotSettings b/osu.sln.DotSettings
index c29d812fc5..2ff0f4d30b 100644
--- a/osu.sln.DotSettings
+++ b/osu.sln.DotSettings
@@ -939,10 +939,8 @@ private void load()
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Dimmable/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Disableable/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Drawables/@EntryIndexedValue">True</s:Boolean>
-	<s:Boolean x:Key="/Default/UserDictionary/Words/=evast/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Failable/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=favourited/@EntryIndexedValue">True</s:Boolean>
-	<s:Boolean x:Key="/Default/UserDictionary/Words/=flyte/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Gamefield/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=gameplay/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Geki/@EntryIndexedValue">True</s:Boolean>

From ebe8ba3c3c16289e5d824278fda1a7f110fda2b9 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 13 Jan 2022 12:47:11 +0900
Subject: [PATCH 2167/5547] Fix unintended change to dotsetting

---
 osu.sln.DotSettings | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.sln.DotSettings b/osu.sln.DotSettings
index 0da109ae7c..44d75f265c 100644
--- a/osu.sln.DotSettings
+++ b/osu.sln.DotSettings
@@ -789,7 +789,7 @@ See the LICENCE file in the repository root for full licence text.&#xD;
 	<s:String x:Key="/Default/CodeStyle/Naming/XamlNaming/UserRules/=XAML_005FFIELD/@EntryIndexedValue">&lt;Policy Inspect="True" Prefix="" Suffix="" Style="AaBb" /&gt;</s:String>
 	<s:String x:Key="/Default/CodeStyle/Naming/XamlNaming/UserRules/=XAML_005FRESOURCE/@EntryIndexedValue">&lt;Policy Inspect="True" Prefix="" Suffix="" Style="AaBb" /&gt;</s:String>
 	<s:String x:Key="/Default/CustomTools/CustomToolsData/@EntryValue"></s:String>
-	<s:Boolean x:Key="/Default/Environment/SettingsMigration/IsMigratorApplied/=JetBrains_002EReSharper_002EFBeature_002EServices_002EDaemon_002ESettings_002EMigration_002ESwaWarningsModeSettingsMigrate/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/Environment/SettingsMigration/IsMigratorApplied/=JetBrains_002EReSharper_002EFeature_002EServices_002EDaemon_002ESettings_002EMigration_002ESwaWarningsModeSettingsMigrate/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/Environment/SettingsMigration/IsMigratorApplied/=JetBrains_002EReSharper_002EPsi_002ECSharp_002ECodeStyle_002ECSharpAttributeForSingleLineMethodUpgrade/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/Environment/SettingsMigration/IsMigratorApplied/=JetBrains_002EReSharper_002EPsi_002ECSharp_002ECodeStyle_002ECSharpKeepExistingMigration/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/Environment/SettingsMigration/IsMigratorApplied/=JetBrains_002EReSharper_002EPsi_002ECSharp_002ECodeStyle_002ECSharpPlaceEmbeddedOnSameLineMigration/@EntryIndexedValue">True</s:Boolean>

From 1a29098f3b99a804c6c51cc8067455dfaf3c0959 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 13 Jan 2022 12:48:45 +0900
Subject: [PATCH 2168/5547] Change default value and add comment explaining why
 skins are never "locally available"

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

diff --git a/osu.Game/Skinning/SkinModelManager.cs b/osu.Game/Skinning/SkinModelManager.cs
index 2aa21c0629..dbd209e984 100644
--- a/osu.Game/Skinning/SkinModelManager.cs
+++ b/osu.Game/Skinning/SkinModelManager.cs
@@ -263,6 +263,6 @@ namespace osu.Game.Skinning
             });
         }
 
-        public override bool IsAvailableLocally(SkinInfo model) => false;
+        public override bool IsAvailableLocally(SkinInfo model) => true; // skins do not have online download support yet.
     }
 }

From 65dd80e6f63cb7523c687030d2f65b2084011c34 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 13 Jan 2022 12:59:16 +0900
Subject: [PATCH 2169/5547] Sanitise mods / statistics cache logic in
 `ScoreInfo`

---
 osu.Game/Scoring/ScoreInfo.cs | 101 +++++++++++++++++-----------------
 1 file changed, 52 insertions(+), 49 deletions(-)

diff --git a/osu.Game/Scoring/ScoreInfo.cs b/osu.Game/Scoring/ScoreInfo.cs
index 45e5b8f1a7..a10039bc72 100644
--- a/osu.Game/Scoring/ScoreInfo.cs
+++ b/osu.Game/Scoring/ScoreInfo.cs
@@ -46,6 +46,12 @@ namespace osu.Game.Scoring
         [MapTo("User")]
         public RealmUser RealmUser { get; set; } = new RealmUser();
 
+        [MapTo("Mods")]
+        public string ModsJson { get; set; } = string.Empty;
+
+        [MapTo("Statistics")]
+        public string StatisticsJson { get; set; } = string.Empty;
+
         public ScoreInfo(BeatmapInfo beatmap, RulesetInfo ruleset, RealmUser realmUser)
         {
             Ruleset = ruleset;
@@ -98,27 +104,6 @@ namespace osu.Game.Scoring
 
         public RulesetInfo Ruleset { get; set; } = null!;
 
-        private Dictionary<HitResult, int>? statistics;
-
-        [Ignored]
-        public Dictionary<HitResult, int> Statistics
-        {
-            get
-            {
-                if (statistics != null)
-                    return statistics;
-
-                if (!string.IsNullOrEmpty(StatisticsJson))
-                    statistics = JsonConvert.DeserializeObject<Dictionary<HitResult, int>>(StatisticsJson);
-
-                return statistics ??= new Dictionary<HitResult, int>();
-            }
-            set => statistics = value;
-        }
-
-        [MapTo("Statistics")]
-        public string StatisticsJson { get; set; } = null!;
-
         public ScoreRank Rank
         {
             get => (ScoreRank)RankInt;
@@ -135,10 +120,6 @@ namespace osu.Game.Scoring
 
         #region Properties required to make things work with existing usages
 
-        private APIMod[]? localAPIMods;
-
-        private Mod[]? mods;
-
         public Guid BeatmapInfoID => BeatmapInfo.ID;
 
         public int UserID => RealmUser.OnlineID;
@@ -177,61 +158,83 @@ namespace osu.Game.Scoring
         [Ignored]
         public bool IsLegacyScore => Mods.OfType<ModClassic>().Any();
 
-        // Used for database serialisation/deserialisation.
-        [MapTo("Mods")]
-        public string ModsJson { get; set; } = string.Empty;
+        private Dictionary<HitResult, int>? statistics;
+
+        [Ignored]
+        public Dictionary<HitResult, int> Statistics
+        {
+            get
+            {
+                if (statistics != null)
+                    return statistics;
+
+                if (!string.IsNullOrEmpty(StatisticsJson))
+                    statistics = JsonConvert.DeserializeObject<Dictionary<HitResult, int>>(StatisticsJson);
+
+                return statistics ??= new Dictionary<HitResult, int>();
+            }
+            set => statistics = value;
+        }
+
+        private Mod[]? mods;
 
         [Ignored]
         public Mod[] Mods
         {
             get
             {
-                Mod[] scoreMods = Array.Empty<Mod>();
-
                 if (mods != null)
-                    scoreMods = mods;
-                else if (localAPIMods != null)
-                    scoreMods = APIMods.Select(m => m.ToMod(Ruleset.CreateInstance())).ToArray();
+                    return mods;
 
-                return scoreMods;
+                if (apiMods != null)
+                    return APIMods.Select(m => m.ToMod(Ruleset.CreateInstance())).ToArray();
+
+                return Array.Empty<Mod>();
             }
             set
             {
-                localAPIMods = null;
+                apiMods = null;
                 mods = value;
-                ModsJson = JsonConvert.SerializeObject(APIMods);
+
+                updateModsJson();
             }
         }
 
+        private APIMod[]? apiMods;
+
         // Used for API serialisation/deserialisation.
         [Ignored]
         public APIMod[] APIMods
         {
             get
             {
-                if (localAPIMods == null)
-                {
-                    // prioritise reading from realm backing
-                    if (!string.IsNullOrEmpty(ModsJson))
-                        localAPIMods = JsonConvert.DeserializeObject<APIMod[]>(ModsJson);
+                if (apiMods != null) return apiMods;
 
-                    // then check mods set via Mods property.
-                    if (mods != null)
-                        localAPIMods = mods.Select(m => new APIMod(m)).ToArray();
-                }
+                // prioritise reading from realm backing
+                if (!string.IsNullOrEmpty(ModsJson))
+                    apiMods = JsonConvert.DeserializeObject<APIMod[]>(ModsJson);
 
-                return localAPIMods ?? Array.Empty<APIMod>();
+                // then check mods set via Mods property.
+                if (mods != null)
+                    apiMods = mods.Select(m => new APIMod(m)).ToArray();
+
+                return apiMods ?? Array.Empty<APIMod>();
             }
             set
             {
-                localAPIMods = value;
+                apiMods = value;
+                mods = null;
 
                 // We potentially can't update this yet due to Ruleset being late-bound, so instead update on read as necessary.
-                mods = null;
-                ModsJson = JsonConvert.SerializeObject(APIMods);
+                updateModsJson();
             }
         }
 
+        private void updateModsJson()
+        {
+            ModsJson = JsonConvert.SerializeObject(APIMods);
+        }
+
         public IEnumerable<HitResultDisplayStatistic> GetStatisticsForDisplay()
         {
             foreach (var r in Ruleset.CreateInstance().GetHitResults())

From 085893c9b41992b1a8ea74c77d58faf43b9d2d74 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 13 Jan 2022 13:03:57 +0900
Subject: [PATCH 2170/5547] Fix stray bracket

---
 osu.Game/Database/RealmObjectExtensions.cs | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/osu.Game/Database/RealmObjectExtensions.cs b/osu.Game/Database/RealmObjectExtensions.cs
index 188d619627..a162bd64d3 100644
--- a/osu.Game/Database/RealmObjectExtensions.cs
+++ b/osu.Game/Database/RealmObjectExtensions.cs
@@ -154,8 +154,7 @@ namespace osu.Game.Database
             return realmList.Select(l => new RealmLiveUnmanaged<T>(l)).Cast<ILive<T>>().ToList();
         }
 
-        public static ILive<T> ToLiveUnmanaged<T>(this T realmObject
-        )
+        public static ILive<T> ToLiveUnmanaged<T>(this T realmObject)
             where T : RealmObject, IHasGuidPrimaryKey
         {
             return new RealmLiveUnmanaged<T>(realmObject);

From 7baff18764322ddc8c674b0ab29105c996a24f7d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 13 Jan 2022 13:14:44 +0900
Subject: [PATCH 2171/5547] Add back `PerformRead` return safety by checking
 `IsManaged` status of returned data

---
 osu.Game/Database/RealmLive.cs | 13 ++++++++-----
 1 file changed, 8 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Database/RealmLive.cs b/osu.Game/Database/RealmLive.cs
index 45bc0e4200..6594224666 100644
--- a/osu.Game/Database/RealmLive.cs
+++ b/osu.Game/Database/RealmLive.cs
@@ -61,15 +61,18 @@ namespace osu.Game.Database
         /// <param name="perform">The action to perform.</param>
         public TReturn PerformRead<TReturn>(Func<T, TReturn> perform)
         {
-            // TODO: this is weird and kinda wrong... unmanaged objects should be allowed?
-            // if (typeof(RealmObjectBase).IsAssignableFrom(typeof(TReturn)))
-            //     throw new InvalidOperationException(@$"Realm live objects should not exit the scope of {nameof(PerformRead)}.");
-
             if (!IsManaged)
                 return perform(data);
 
             using (var realm = realmFactory.CreateContext())
-                return perform(realm.Find<T>(ID));
+            {
+                var returnData = perform(realm.Find<T>(ID));
+
+                if (returnData is RealmObjectBase realmObject && realmObject.IsManaged)
+                    throw new InvalidOperationException(@$"Managed realm objects should not exit the scope of {nameof(PerformRead)}.");
+
+                return returnData;
+            }
         }
 
         /// <summary>

From 86b2ac3217dde65e3f9ef6b9fb46c3e5be3f2ece Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 13 Jan 2022 13:19:49 +0900
Subject: [PATCH 2172/5547] Remove unnecessary `Ruleset` null check in
 `BeatmapDifficultyCache`

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

diff --git a/osu.Game/Beatmaps/BeatmapDifficultyCache.cs b/osu.Game/Beatmaps/BeatmapDifficultyCache.cs
index 981120c5a8..f102daeef5 100644
--- a/osu.Game/Beatmaps/BeatmapDifficultyCache.cs
+++ b/osu.Game/Beatmaps/BeatmapDifficultyCache.cs
@@ -136,7 +136,7 @@ namespace osu.Game.Beatmaps
             var localRulesetInfo = rulesetInfo as RulesetInfo;
 
             // Difficulty can only be computed if the beatmap and ruleset are locally available.
-            if (localBeatmapInfo?.Ruleset == null || localRulesetInfo == null)
+            if (localBeatmapInfo == null || localRulesetInfo == null)
             {
                 // If not, fall back to the existing star difficulty (e.g. from an online source).
                 return Task.FromResult<StarDifficulty?>(new StarDifficulty(beatmapInfo.StarRating, (beatmapInfo as IBeatmapOnlineInfo)?.MaxCombo ?? 0));

From b77cb344d56ee1d92eee8b6d9fefc269ad7b165a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 13 Jan 2022 13:23:41 +0900
Subject: [PATCH 2173/5547] Use `ctor` rather than `MemberwiseClone` to
 guarantee a safer clone of `BeatmapDifficulty`

---
 osu.Game.Rulesets.Taiko/Beatmaps/TaikoBeatmapConverter.cs | 2 ++
 osu.Game/Beatmaps/BeatmapDifficulty.cs                    | 7 +------
 2 files changed, 3 insertions(+), 6 deletions(-)

diff --git a/osu.Game.Rulesets.Taiko/Beatmaps/TaikoBeatmapConverter.cs b/osu.Game.Rulesets.Taiko/Beatmaps/TaikoBeatmapConverter.cs
index 61f932fd98..613874b7d6 100644
--- a/osu.Game.Rulesets.Taiko/Beatmaps/TaikoBeatmapConverter.cs
+++ b/osu.Game.Rulesets.Taiko/Beatmaps/TaikoBeatmapConverter.cs
@@ -208,6 +208,8 @@ namespace osu.Game.Rulesets.Taiko.Beatmaps
 
             #region Overrides of BeatmapDifficulty
 
+            public override BeatmapDifficulty Clone() => new TaikoMultiplierAppliedDifficulty(this);
+
             public override void CopyTo(BeatmapDifficulty other)
             {
                 base.CopyTo(other);
diff --git a/osu.Game/Beatmaps/BeatmapDifficulty.cs b/osu.Game/Beatmaps/BeatmapDifficulty.cs
index f6e8b8c57d..7e0462f1e8 100644
--- a/osu.Game/Beatmaps/BeatmapDifficulty.cs
+++ b/osu.Game/Beatmaps/BeatmapDifficulty.cs
@@ -37,12 +37,7 @@ namespace osu.Game.Beatmaps
         /// <summary>
         /// Returns a shallow-clone of this <see cref="BeatmapDifficulty"/>.
         /// </summary>
-        public BeatmapDifficulty Clone()
-        {
-            var diff = (BeatmapDifficulty)MemberwiseClone();
-            CopyTo(diff);
-            return diff;
-        }
+        public virtual BeatmapDifficulty Clone() => new BeatmapDifficulty(this);
 
         public virtual void CopyTo(BeatmapDifficulty difficulty)
         {

From 7a81fe19f6ba8ae6f266924cb8e8046f9aa0659c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 13 Jan 2022 13:28:46 +0900
Subject: [PATCH 2174/5547] Bump realm schema version to allow upgrades

---
 osu.Game/Database/RealmContextFactory.cs | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Database/RealmContextFactory.cs b/osu.Game/Database/RealmContextFactory.cs
index 0802641b06..5cdae15935 100644
--- a/osu.Game/Database/RealmContextFactory.cs
+++ b/osu.Game/Database/RealmContextFactory.cs
@@ -47,8 +47,9 @@ namespace osu.Game.Database
         /// 10   2021-11-22    Use ShortName instead of RulesetID for ruleset settings.
         /// 11   2021-11-22    Use ShortName instead of RulesetID for ruleset key bindings.
         /// 12   2021-11-24    Add Status to RealmBeatmapSet.
+        /// 13   2022-01-13    Final migration of beatmaps and scores to realm (multiple new storage fields).
         /// </summary>
-        private const int schema_version = 12;
+        private const int schema_version = 13;
 
         /// <summary>
         /// Lock object which is held during <see cref="BlockAllOperations"/> sections, blocking context creation during blocking periods.

From dcc354aa7c24640c8aceef89623c0efce472b273 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 13 Jan 2022 13:40:09 +0900
Subject: [PATCH 2175/5547] Fix deleted scores not being cleaned up on next
 startup

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

diff --git a/osu.Game/Database/RealmContextFactory.cs b/osu.Game/Database/RealmContextFactory.cs
index 5cdae15935..9307e06be0 100644
--- a/osu.Game/Database/RealmContextFactory.cs
+++ b/osu.Game/Database/RealmContextFactory.cs
@@ -18,6 +18,7 @@ using osu.Game.Models;
 using osu.Game.Skinning;
 using osu.Game.Stores;
 using osu.Game.Rulesets;
+using osu.Game.Scoring;
 using Realms;
 
 #nullable enable
@@ -112,6 +113,11 @@ namespace osu.Game.Database
             using (var realm = CreateContext())
             using (var transaction = realm.BeginWrite())
             {
+                var pendingDeleteScores = realm.All<ScoreInfo>().Where(s => s.DeletePending);
+
+                foreach (var score in pendingDeleteScores)
+                    realm.Remove(score);
+
                 var pendingDeleteSets = realm.All<BeatmapSetInfo>().Where(s => s.DeletePending);
 
                 foreach (var beatmapSet in pendingDeleteSets)

From 0a133c7e97c5184f2e8fe3c6edfc70bd254508b9 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 13 Jan 2022 13:47:23 +0900
Subject: [PATCH 2176/5547] Fix typo in comment in `IntroScreen`

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

diff --git a/osu.Game/Screens/Menu/IntroScreen.cs b/osu.Game/Screens/Menu/IntroScreen.cs
index c4343625ab..0f5dbb2842 100644
--- a/osu.Game/Screens/Menu/IntroScreen.cs
+++ b/osu.Game/Screens/Menu/IntroScreen.cs
@@ -212,7 +212,7 @@ namespace osu.Game.Screens.Menu
             if (!resuming)
             {
                 // generally this can never be null
-                // an exception is running ruleset tests, where the osu! ruleset may not be prsent (causing importing the intro to fail).
+                // an exception is running ruleset tests, where the osu! ruleset may not be present (causing importing the intro to fail).
                 if (initialBeatmap != null)
                     beatmap.Value = initialBeatmap;
                 Track = beatmap.Value.Track;

From 6025fe325df0d49e5526b697d514d86c0788259a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 13 Jan 2022 15:08:51 +0900
Subject: [PATCH 2177/5547] Fix filter criteria not being applied after
 carousel loads new beatmap sets

---
 osu.Game/Screens/Select/BeatmapCarousel.cs | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/osu.Game/Screens/Select/BeatmapCarousel.cs b/osu.Game/Screens/Select/BeatmapCarousel.cs
index 734d9bbde7..13ece08144 100644
--- a/osu.Game/Screens/Select/BeatmapCarousel.cs
+++ b/osu.Game/Screens/Select/BeatmapCarousel.cs
@@ -124,8 +124,7 @@ namespace osu.Game.Screens.Select
             itemsCache.Invalidate();
             ScrollToSelected();
 
-            // apply any pending filter operation that may have been delayed (see applyActiveCriteria's scheduling behaviour when BeatmapSetsLoaded is false).
-            FlushPendingFilterOperations();
+            applyActiveCriteria(false);
 
             // Run on late scheduler want to ensure this runs after all pending UpdateBeatmapSet / RemoveBeatmapSet operations are run.
             SchedulerAfterChildren.Add(() =>

From 88145dedf14bf0cedf13aabf6d7d1be29a050ac2 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 13 Jan 2022 15:27:43 +0900
Subject: [PATCH 2178/5547] Remove oudated comments

---
 osu.Game/Stores/RealmArchiveModelImporter.cs | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/osu.Game/Stores/RealmArchiveModelImporter.cs b/osu.Game/Stores/RealmArchiveModelImporter.cs
index 4aca079e2e..9927840c4e 100644
--- a/osu.Game/Stores/RealmArchiveModelImporter.cs
+++ b/osu.Game/Stores/RealmArchiveModelImporter.cs
@@ -393,9 +393,6 @@ namespace osu.Game.Stores
                             LogForModel(item, @"Found existing but failed re-use check.");
 
                             existing.DeletePending = true;
-
-                            // todo: actually delete? i don't think this is required...
-                            // ModelStore.PurgeDeletable(s => s.ID == existing.ID);
                         }
 
                         PreImport(item, realm);

From 70c107b434eeab82d57f71e34556347d59a7aff3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 13 Jan 2022 16:26:35 +0900
Subject: [PATCH 2179/5547] Remove pointless override method in
 `RealmArchiveModelManager`

---
 osu.Game/Stores/RealmArchiveModelManager.cs | 8 --------
 1 file changed, 8 deletions(-)

diff --git a/osu.Game/Stores/RealmArchiveModelManager.cs b/osu.Game/Stores/RealmArchiveModelManager.cs
index 4365fdab1e..b456dae343 100644
--- a/osu.Game/Stores/RealmArchiveModelManager.cs
+++ b/osu.Game/Stores/RealmArchiveModelManager.cs
@@ -5,12 +5,9 @@ using System;
 using System.Collections.Generic;
 using System.IO;
 using System.Linq;
-using System.Threading;
-using System.Threading.Tasks;
 using osu.Framework.Platform;
 using osu.Game.Database;
 using osu.Game.Extensions;
-using osu.Game.IO.Archives;
 using osu.Game.Models;
 using osu.Game.Overlays.Notifications;
 using Realms;
@@ -93,11 +90,6 @@ namespace osu.Game.Stores
             item.Files.Add(namedUsage);
         }
 
-        public override async Task<ILive<TModel>?> Import(TModel item, ArchiveReader? archive = null, bool lowPriority = false, CancellationToken cancellationToken = default)
-        {
-            return await base.Import(item, archive, lowPriority, cancellationToken).ConfigureAwait(false);
-        }
-
         /// <summary>
         /// Delete multiple items.
         /// This will post notifications tracking progress.

From bdb2979b2e895e0e85ef2137114f44ccf270ea48 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 13 Jan 2022 16:27:07 +0900
Subject: [PATCH 2180/5547] Remove `async` from `Populate` method

---
 osu.Game/Scoring/ScoreModelManager.cs        |  5 +----
 osu.Game/Skinning/SkinModelManager.cs        |  5 +----
 osu.Game/Stores/BeatmapImporter.cs           |  5 +----
 osu.Game/Stores/RealmArchiveModelImporter.cs | 12 ++++++------
 4 files changed, 9 insertions(+), 18 deletions(-)

diff --git a/osu.Game/Scoring/ScoreModelManager.cs b/osu.Game/Scoring/ScoreModelManager.cs
index 09a5919f12..fcf7244226 100644
--- a/osu.Game/Scoring/ScoreModelManager.cs
+++ b/osu.Game/Scoring/ScoreModelManager.cs
@@ -5,7 +5,6 @@ using System;
 using System.Collections.Generic;
 using System.Linq;
 using System.Threading;
-using System.Threading.Tasks;
 using Newtonsoft.Json;
 using osu.Framework.Logging;
 using osu.Framework.Platform;
@@ -55,7 +54,7 @@ namespace osu.Game.Scoring
 
         public Score GetScore(ScoreInfo score) => new LegacyDatabasedScore(score, rulesets, beatmaps(), Files.Store);
 
-        protected override Task Populate(ScoreInfo model, ArchiveReader? archive, Realm realm, CancellationToken cancellationToken = default)
+        protected override void Populate(ScoreInfo model, ArchiveReader? archive, Realm realm, CancellationToken cancellationToken = default)
         {
             // Ensure the beatmap is not detached.
             if (!model.BeatmapInfo.IsManaged)
@@ -66,8 +65,6 @@ namespace osu.Game.Scoring
 
             if (string.IsNullOrEmpty(model.StatisticsJson))
                 model.StatisticsJson = JsonConvert.SerializeObject(model.Statistics);
-
-            return Task.CompletedTask;
         }
 
         public override bool IsAvailableLocally(ScoreInfo model)
diff --git a/osu.Game/Skinning/SkinModelManager.cs b/osu.Game/Skinning/SkinModelManager.cs
index dbd209e984..b8313f63a3 100644
--- a/osu.Game/Skinning/SkinModelManager.cs
+++ b/osu.Game/Skinning/SkinModelManager.cs
@@ -7,7 +7,6 @@ using System.IO;
 using System.Linq;
 using System.Text;
 using System.Threading;
-using System.Threading.Tasks;
 using Newtonsoft.Json;
 using osu.Framework.Logging;
 using osu.Framework.Platform;
@@ -49,7 +48,7 @@ namespace osu.Game.Skinning
 
         protected override bool HasCustomHashFunction => true;
 
-        protected override Task Populate(SkinInfo model, ArchiveReader? archive, Realm realm, CancellationToken cancellationToken = default)
+        protected override void Populate(SkinInfo model, ArchiveReader? archive, Realm realm, CancellationToken cancellationToken = default)
         {
             var skinInfoFile = model.Files.SingleOrDefault(f => f.Filename == skin_info_file);
 
@@ -83,8 +82,6 @@ namespace osu.Game.Skinning
             model.InstantiationInfo = createInstance(model).GetType().GetInvariantInstantiationInfo();
 
             checkSkinIniMetadata(model, realm);
-
-            return Task.CompletedTask;
         }
 
         private void checkSkinIniMetadata(SkinInfo item, Realm realm)
diff --git a/osu.Game/Stores/BeatmapImporter.cs b/osu.Game/Stores/BeatmapImporter.cs
index 429d3951cf..53971b1d96 100644
--- a/osu.Game/Stores/BeatmapImporter.cs
+++ b/osu.Game/Stores/BeatmapImporter.cs
@@ -6,7 +6,6 @@ using System.Collections.Generic;
 using System.IO;
 using System.Linq;
 using System.Threading;
-using System.Threading.Tasks;
 using osu.Framework.Audio.Track;
 using osu.Framework.Extensions;
 using osu.Framework.Extensions.IEnumerableExtensions;
@@ -53,7 +52,7 @@ namespace osu.Game.Stores
 
         protected override bool ShouldDeleteArchive(string path) => Path.GetExtension(path).ToLowerInvariant() == ".osz";
 
-        protected override Task Populate(BeatmapSetInfo beatmapSet, ArchiveReader? archive, Realm realm, CancellationToken cancellationToken = default)
+        protected override void Populate(BeatmapSetInfo beatmapSet, ArchiveReader? archive, Realm realm, CancellationToken cancellationToken = default)
         {
             if (archive != null)
                 beatmapSet.Beatmaps.AddRange(createBeatmapDifficulties(beatmapSet.Files, realm));
@@ -87,8 +86,6 @@ namespace osu.Game.Stores
                     LogForModel(beatmapSet, "Disassociating beatmap set ID due to loss of all beatmap IDs");
                 }
             }
-
-            return Task.CompletedTask;
         }
 
         protected override void PreImport(BeatmapSetInfo beatmapSet, Realm realm)
diff --git a/osu.Game/Stores/RealmArchiveModelImporter.cs b/osu.Game/Stores/RealmArchiveModelImporter.cs
index 9927840c4e..bcae9f2451 100644
--- a/osu.Game/Stores/RealmArchiveModelImporter.cs
+++ b/osu.Game/Stores/RealmArchiveModelImporter.cs
@@ -318,7 +318,7 @@ namespace osu.Game.Stores
         /// <param name="archive">An optional archive to use for model population.</param>
         /// <param name="lowPriority">Whether this is a low priority import.</param>
         /// <param name="cancellationToken">An optional cancellation token.</param>
-        public virtual async Task<ILive<TModel>?> Import(TModel item, ArchiveReader? archive = null, bool lowPriority = false, CancellationToken cancellationToken = default)
+        public virtual Task<ILive<TModel>?> Import(TModel item, ArchiveReader? archive = null, bool lowPriority = false, CancellationToken cancellationToken = default)
         {
             using (var realm = ContextFactory.CreateContext())
             {
@@ -352,7 +352,7 @@ namespace osu.Game.Stores
                                 transaction.Commit();
                             }
 
-                            return existing.ToLive(ContextFactory);
+                            return Task.FromResult((ILive<TModel>?)existing.ToLive(ContextFactory));
                         }
 
                         LogForModel(item, @"Found existing (optimised) but failed pre-check.");
@@ -373,7 +373,7 @@ namespace osu.Game.Stores
                         item.Hash = ComputeHash(item);
 
                         // TODO: we may want to run this outside of the transaction.
-                        await Populate(item, archive, realm, cancellationToken).ConfigureAwait(false);
+                        Populate(item, archive, realm, cancellationToken);
 
                         if (!checkedExisting)
                             existing = CheckForExisting(item, realm);
@@ -387,7 +387,7 @@ namespace osu.Game.Stores
                                 existing.DeletePending = false;
                                 transaction.Commit();
 
-                                return existing.ToLive(ContextFactory);
+                                return Task.FromResult((ILive<TModel>?)existing.ToLive(ContextFactory));
                             }
 
                             LogForModel(item, @"Found existing but failed re-use check.");
@@ -413,7 +413,7 @@ namespace osu.Game.Stores
                     throw;
                 }
 
-                return item.ToLive(ContextFactory);
+                return Task.FromResult((ILive<TModel>?)item.ToLive(ContextFactory));
             }
         }
 
@@ -480,7 +480,7 @@ namespace osu.Game.Stores
         /// <param name="archive">The archive to use as a reference for population. May be null.</param>
         /// <param name="realm">The current realm context.</param>
         /// <param name="cancellationToken">An optional cancellation token.</param>
-        protected abstract Task Populate(TModel model, ArchiveReader? archive, Realm realm, CancellationToken cancellationToken = default);
+        protected abstract void Populate(TModel model, ArchiveReader? archive, Realm realm, CancellationToken cancellationToken = default);
 
         /// <summary>
         /// Perform any final actions before the import to database executes.

From 93c78253d65065ba649f382183d4e12b643ab44a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 13 Jan 2022 16:13:30 +0900
Subject: [PATCH 2181/5547] Add synchronous fetch flow to
 `BeatmapOnlineLookupQueue`

The async flow doesn't work great with the realm import process. We
might be able to improve on this going forward, but for the time being
adding a synchronous path seems safest.

After all, we are already an an asynchronous (dedicated) thread pool at
this point.
---
 osu.Game/Beatmaps/BeatmapOnlineLookupQueue.cs | 21 ++++++++++++-------
 osu.Game/Stores/BeatmapImporter.cs            |  6 +-----
 2 files changed, 14 insertions(+), 13 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapOnlineLookupQueue.cs b/osu.Game/Beatmaps/BeatmapOnlineLookupQueue.cs
index 444bf09487..aecbd6f6e2 100644
--- a/osu.Game/Beatmaps/BeatmapOnlineLookupQueue.cs
+++ b/osu.Game/Beatmaps/BeatmapOnlineLookupQueue.cs
@@ -54,6 +54,12 @@ namespace osu.Game.Beatmaps
                 prepareLocalCache();
         }
 
+        public void Update(BeatmapSetInfo beatmapSet, CancellationToken cancellationToken)
+        {
+            foreach (var b in beatmapSet.Beatmaps)
+                lookup(beatmapSet, b);
+        }
+
         public Task UpdateAsync(BeatmapSetInfo beatmapSet, CancellationToken cancellationToken)
         {
             return Task.WhenAll(beatmapSet.Beatmaps.Select(b => UpdateAsync(beatmapSet, b, cancellationToken)).ToArray());
@@ -73,13 +79,17 @@ namespace osu.Game.Beatmaps
 
             var req = new GetBeatmapRequest(beatmapInfo);
 
-            req.Failure += fail;
-
             try
             {
                 // intentionally blocking to limit web request concurrency
                 api.Perform(req);
 
+                if (req.CompletionState == APIRequestCompletionState.Failed)
+                {
+                    logForModel(set, $"Online retrieval failed for {beatmapInfo}");
+                    beatmapInfo.OnlineID = -1;
+                }
+
                 var res = req.Response;
 
                 if (res != null)
@@ -99,13 +109,8 @@ namespace osu.Game.Beatmaps
             }
             catch (Exception e)
             {
-                fail(e);
-            }
-
-            void fail(Exception e)
-            {
-                beatmapInfo.OnlineID = -1;
                 logForModel(set, $"Online retrieval failed for {beatmapInfo} ({e.Message})");
+                beatmapInfo.OnlineID = -1;
             }
         }
 
diff --git a/osu.Game/Stores/BeatmapImporter.cs b/osu.Game/Stores/BeatmapImporter.cs
index 53971b1d96..a9cb46ca29 100644
--- a/osu.Game/Stores/BeatmapImporter.cs
+++ b/osu.Game/Stores/BeatmapImporter.cs
@@ -71,11 +71,7 @@ namespace osu.Game.Stores
 
             bool hadOnlineIDs = beatmapSet.Beatmaps.Any(b => b.OnlineID > 0);
 
-            if (onlineLookupQueue != null)
-            {
-                // TODO: this required `BeatmapOnlineLookupQueue` to somehow support new types.
-                // await onlineLookupQueue.UpdateAsync(beatmapSet, cancellationToken).ConfigureAwait(false);
-            }
+            onlineLookupQueue?.Update(beatmapSet, cancellationToken);
 
             // ensure at least one beatmap was able to retrieve or keep an online ID, else drop the set ID.
             if (hadOnlineIDs && !beatmapSet.Beatmaps.Any(b => b.OnlineID > 0))

From c61419dfe5606b2749381b9a7eae275d4762e4bb Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 13 Jan 2022 16:56:09 +0900
Subject: [PATCH 2182/5547] Fix scores not using correct filename/display
 strings

I've updated all cases where we should have been using
`GetDisplayString()` anyway, but left the `ToString()` implementations
in place for safety. They should probably be removed in the future.
---
 osu.Game/Database/LegacyExporter.cs          | 2 +-
 osu.Game/Scoring/ScoreInfo.cs                | 2 ++
 osu.Game/Stores/RealmArchiveModelImporter.cs | 2 +-
 3 files changed, 4 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Database/LegacyExporter.cs b/osu.Game/Database/LegacyExporter.cs
index 802ccec6ed..ee960b6b30 100644
--- a/osu.Game/Database/LegacyExporter.cs
+++ b/osu.Game/Database/LegacyExporter.cs
@@ -35,7 +35,7 @@ namespace osu.Game.Database
         /// <param name="item">The item to export.</param>
         public void Export(TModel item)
         {
-            string filename = $"{item.ToString().GetValidArchiveContentFilename()}{FileExtension}";
+            string filename = $"{item.GetDisplayString().GetValidArchiveContentFilename()}{FileExtension}";
 
             using (var stream = exportStorage.GetStream(filename, FileAccess.Write, FileMode.Create))
                 ExportModelTo(item, stream);
diff --git a/osu.Game/Scoring/ScoreInfo.cs b/osu.Game/Scoring/ScoreInfo.cs
index a10039bc72..9b4f4bf784 100644
--- a/osu.Game/Scoring/ScoreInfo.cs
+++ b/osu.Game/Scoring/ScoreInfo.cs
@@ -274,5 +274,7 @@ namespace osu.Game.Scoring
         }
 
         #endregion
+
+        public override string ToString() => this.GetDisplayTitle();
     }
 }
diff --git a/osu.Game/Stores/RealmArchiveModelImporter.cs b/osu.Game/Stores/RealmArchiveModelImporter.cs
index bcae9f2451..2ea7aecc94 100644
--- a/osu.Game/Stores/RealmArchiveModelImporter.cs
+++ b/osu.Game/Stores/RealmArchiveModelImporter.cs
@@ -169,7 +169,7 @@ namespace osu.Game.Stores
             else
             {
                 notification.CompletionText = imported.Count == 1
-                    ? $"Imported {imported.First()}!"
+                    ? $"Imported {imported.First().GetDisplayString()}!"
                     : $"Imported {imported.Count} {HumanisedModelName}s!";
 
                 if (imported.Count > 0 && PostImport != null)

From 2de0c34bc9fa10ed728a599ae563172348fa7bf2 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 13 Jan 2022 17:10:48 +0900
Subject: [PATCH 2183/5547] Reduce exposure of `ChannelManager`

---
 osu.Game/Online/Chat/StandAloneChatDisplay.cs | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Online/Chat/StandAloneChatDisplay.cs b/osu.Game/Online/Chat/StandAloneChatDisplay.cs
index 81fd5ad98c..f83bf4877e 100644
--- a/osu.Game/Online/Chat/StandAloneChatDisplay.cs
+++ b/osu.Game/Online/Chat/StandAloneChatDisplay.cs
@@ -25,7 +25,7 @@ namespace osu.Game.Online.Chat
 
         protected readonly ChatTextBox TextBox;
 
-        protected ChannelManager ChannelManager;
+        private ChannelManager channelManager;
 
         private StandAloneDrawableChannel drawableChannel;
 
@@ -80,7 +80,7 @@ namespace osu.Game.Online.Chat
         [BackgroundDependencyLoader(true)]
         private void load(ChannelManager manager)
         {
-            ChannelManager ??= manager;
+            channelManager ??= manager;
         }
 
         protected virtual StandAloneDrawableChannel CreateDrawableChannel(Channel channel) =>
@@ -94,9 +94,9 @@ namespace osu.Game.Online.Chat
                 return;
 
             if (text[0] == '/')
-                ChannelManager?.PostCommand(text.Substring(1), Channel.Value);
+                channelManager?.PostCommand(text.Substring(1), Channel.Value);
             else
-                ChannelManager?.PostMessage(text, target: Channel.Value);
+                channelManager?.PostMessage(text, target: Channel.Value);
 
             TextBox.Text = string.Empty;
         }

From 0bd34253e7a4614014c69f386acc5e89b38725b7 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 13 Jan 2022 17:31:49 +0900
Subject: [PATCH 2184/5547] Increase chat polling rate during multiplayer lobby
 / games

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

diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index c5a465ae96..21d84a365b 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -820,7 +820,17 @@ namespace osu.Game
 
             loadComponentSingleFile(CreateHighPerformanceSession(), Add);
 
-            chatOverlay.State.ValueChanged += state => channelManager.HighPollRate.Value = state.NewValue == Visibility.Visible;
+            chatOverlay.State.BindValueChanged(_ => updateChatPollRate());
+            // Multiplayer modes need to increase poll rate temporarily.
+            API.Activity.BindValueChanged(_ => updateChatPollRate(), true);
+
+            void updateChatPollRate()
+            {
+                channelManager.HighPollRate.Value =
+                    chatOverlay.State.Value == Visibility.Visible
+                    || API.Activity.Value is UserActivity.InLobby
+                    || API.Activity.Value is UserActivity.InMultiplayerGame;
+            }
 
             Add(difficultyRecommender);
             Add(externalLinkOpener = new ExternalLinkOpener());

From 46d2f305b5967ec2098fe7305f8e65b9808c9e60 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 13 Jan 2022 17:31:55 +0900
Subject: [PATCH 2185/5547] Log chat polling rate changes

---
 osu.Game/Online/Chat/ChannelManager.cs | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Online/Chat/ChannelManager.cs b/osu.Game/Online/Chat/ChannelManager.cs
index 82e042ae4e..e5acda89f2 100644
--- a/osu.Game/Online/Chat/ChannelManager.cs
+++ b/osu.Game/Online/Chat/ChannelManager.cs
@@ -90,13 +90,14 @@ namespace osu.Game.Online.Chat
         {
             // Polling will eventually be replaced with websocket, but let's avoid doing these background operations as much as possible for now.
             // The only loss will be delayed PM/message highlight notifications.
-
             if (HighPollRate.Value)
                 TimeBetweenPolls.Value = 1000;
             else if (!isIdle.Value)
                 TimeBetweenPolls.Value = 60000;
             else
                 TimeBetweenPolls.Value = 600000;
+
+            Logger.Log($"Chat is now polling every {TimeBetweenPolls.Value} ms");
         }
 
         /// <summary>

From 4012ef7e7b583bf5f245462fd94420266bdafc07 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 13 Jan 2022 17:33:55 +0900
Subject: [PATCH 2186/5547] Reduce polling rate when idle even if
 `HighPollRate` is requested

---
 osu.Game/Online/Chat/ChannelManager.cs | 16 +++++++++-------
 1 file changed, 9 insertions(+), 7 deletions(-)

diff --git a/osu.Game/Online/Chat/ChannelManager.cs b/osu.Game/Online/Chat/ChannelManager.cs
index e5acda89f2..77b52c34d9 100644
--- a/osu.Game/Online/Chat/ChannelManager.cs
+++ b/osu.Game/Online/Chat/ChannelManager.cs
@@ -90,14 +90,16 @@ namespace osu.Game.Online.Chat
         {
             // Polling will eventually be replaced with websocket, but let's avoid doing these background operations as much as possible for now.
             // The only loss will be delayed PM/message highlight notifications.
-            if (HighPollRate.Value)
-                TimeBetweenPolls.Value = 1000;
-            else if (!isIdle.Value)
-                TimeBetweenPolls.Value = 60000;
-            else
-                TimeBetweenPolls.Value = 600000;
+            int millisecondsBetweenPolls = HighPollRate.Value ? 1000 : 60000;
 
-            Logger.Log($"Chat is now polling every {TimeBetweenPolls.Value} ms");
+            if (isIdle.Value)
+                millisecondsBetweenPolls *= 10;
+
+            if (TimeBetweenPolls.Value != millisecondsBetweenPolls)
+            {
+                TimeBetweenPolls.Value = millisecondsBetweenPolls;
+                Logger.Log($"Chat is now polling every {TimeBetweenPolls.Value} ms");
+            }
         }
 
         /// <summary>

From 069d6d2954a437080b2fb0f456ad7a033b296253 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 13 Jan 2022 18:02:02 +0900
Subject: [PATCH 2187/5547] Remove pointless compatibility parameter
 `BeatmapSetInfoID`

---
 osu.Game/Beatmaps/BeatmapInfo.cs      | 3 ---
 osu.Game/Screens/Select/SongSelect.cs | 2 +-
 2 files changed, 1 insertion(+), 4 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapInfo.cs b/osu.Game/Beatmaps/BeatmapInfo.cs
index 1c1f81f143..078a34e50d 100644
--- a/osu.Game/Beatmaps/BeatmapInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapInfo.cs
@@ -163,9 +163,6 @@ namespace osu.Game.Beatmaps
             }
         }
 
-        [Ignored]
-        public Guid BeatmapSetInfoID => BeatmapSet?.ID ?? Guid.Empty;
-
         [Ignored]
         [IgnoreMap]
         public BeatmapDifficulty BaseDifficulty
diff --git a/osu.Game/Screens/Select/SongSelect.cs b/osu.Game/Screens/Select/SongSelect.cs
index 41700bec17..b390cd225a 100644
--- a/osu.Game/Screens/Select/SongSelect.cs
+++ b/osu.Game/Screens/Select/SongSelect.cs
@@ -486,7 +486,7 @@ namespace osu.Game.Screens.Select
             {
                 if (beatmap != null && beatmapInfoPrevious != null && Time.Current - audioFeedbackLastPlaybackTime >= 50)
                 {
-                    if (beatmap.BeatmapSetInfoID == beatmapInfoPrevious.BeatmapSetInfoID)
+                    if (beatmap.BeatmapSet?.ID == beatmapInfoPrevious.BeatmapSet?.ID)
                         sampleChangeDifficulty.Play();
                     else
                         sampleChangeBeatmap.Play();

From ded1d87739543fa8370c10a94cd63dbcb09ecb79 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 13 Jan 2022 18:23:10 +0900
Subject: [PATCH 2188/5547] Move `RulesetStore` construction earlier in process
 so rulesets are available for EF migration

---
 osu.Game/OsuGameBase.cs | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/osu.Game/OsuGameBase.cs b/osu.Game/OsuGameBase.cs
index a003c6b8ab..a9538c1e8c 100644
--- a/osu.Game/OsuGameBase.cs
+++ b/osu.Game/OsuGameBase.cs
@@ -189,6 +189,10 @@ namespace osu.Game
                 : null;
 
             dependencies.Cache(realmFactory = new RealmContextFactory(Storage, "client", efContextFactory));
+
+            dependencies.Cache(RulesetStore = new RulesetStore(realmFactory, Storage));
+            dependencies.CacheAs<IRulesetStore>(RulesetStore);
+
             if (efContextFactory != null)
                 new EFToRealmMigrator(efContextFactory, realmFactory, LocalConfig).Run();
 
@@ -219,9 +223,6 @@ namespace osu.Game
 
             var defaultBeatmap = new DummyWorkingBeatmap(Audio, Textures);
 
-            dependencies.Cache(RulesetStore = new RulesetStore(realmFactory, Storage));
-            dependencies.CacheAs<IRulesetStore>(RulesetStore);
-
             // ordering is important here to ensure foreign keys rules are not broken in ModelStore.Cleanup()
             dependencies.Cache(ScoreManager = new ScoreManager(RulesetStore, () => BeatmapManager, Storage, realmFactory, Scheduler, Host, () => difficultyCache, LocalConfig));
             dependencies.Cache(BeatmapManager = new BeatmapManager(Storage, realmFactory, RulesetStore, API, Audio, Resources, Host, defaultBeatmap, performOnlineLookups: true));

From 45a23e5a43f90e897a4761774147540772c7d430 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 13 Jan 2022 17:51:23 +0900
Subject: [PATCH 2189/5547] Add EF to realm score migration

---
 osu.Game/Database/EFToRealmMigrator.cs | 91 +++++++++++++++++++++++---
 1 file changed, 82 insertions(+), 9 deletions(-)

diff --git a/osu.Game/Database/EFToRealmMigrator.cs b/osu.Game/Database/EFToRealmMigrator.cs
index b79a982460..1aa364ff8f 100644
--- a/osu.Game/Database/EFToRealmMigrator.cs
+++ b/osu.Game/Database/EFToRealmMigrator.cs
@@ -3,9 +3,13 @@
 
 using System.Linq;
 using Microsoft.EntityFrameworkCore;
+using osu.Game.Beatmaps;
 using osu.Game.Configuration;
 using osu.Game.Models;
+using osu.Game.Rulesets;
+using osu.Game.Scoring;
 using osu.Game.Skinning;
+using Realms;
 
 #nullable enable
 
@@ -30,6 +34,70 @@ namespace osu.Game.Database
             {
                 migrateSettings(db);
                 migrateSkins(db);
+
+                migrateScores(db);
+            }
+        }
+
+        private void migrateScores(DatabaseWriteUsage db)
+        {
+            // can be removed 20220730.
+            var existingScores = db.Context.ScoreInfo
+                                   .Include(s => s.Ruleset)
+                                   .Include(s => s.BeatmapInfo)
+                                   .Include(s => s.Files)
+                                   .ThenInclude(f => f.FileInfo)
+                                   .ToList();
+
+            // previous entries in EF are removed post migration.
+            if (!existingScores.Any())
+                return;
+
+            using (var realm = realmContextFactory.CreateContext())
+            using (var transaction = realm.BeginWrite())
+            {
+                // only migrate data if the realm database is empty.
+                // note that this cannot be written as: `realm.All<ScoreInfo>().All(s => s.Protected)`, because realm does not support `.All()`.
+                if (!realm.All<ScoreInfo>().Any())
+                {
+                    foreach (var score in existingScores)
+                    {
+                        var realmScore = new ScoreInfo
+                        {
+                            Hash = score.Hash,
+                            DeletePending = score.DeletePending,
+                            OnlineID = score.OnlineID ?? -1,
+                            ModsJson = score.ModsJson,
+                            StatisticsJson = score.StatisticsJson,
+                            User = score.User,
+                            TotalScore = score.TotalScore,
+                            MaxCombo = score.MaxCombo,
+                            Accuracy = score.Accuracy,
+                            HasReplay = ((IScoreInfo)score).HasReplay,
+                            Date = score.Date,
+                            PP = score.PP,
+                            BeatmapInfo = realm.All<BeatmapInfo>().First(b => b.Hash == score.BeatmapInfo.Hash),
+                            Ruleset = realm.Find<RulesetInfo>(score.Ruleset.ShortName),
+                            Rank = score.Rank,
+                            HitEvents = score.HitEvents,
+                            Passed = score.Passed,
+                            Combo = score.Combo,
+                            Position = score.Position,
+                            Statistics = score.Statistics,
+                            Mods = score.Mods,
+                            APIMods = score.APIMods,
+                        };
+
+                        migrateFiles(score, realm, realmScore);
+
+                        realm.Add(realmScore);
+                    }
+                }
+
+                db.Context.RemoveRange(existingScores);
+                // Intentionally don't clean up the files, so they don't get purged by EF.
+
+                transaction.Commit();
             }
         }
 
@@ -77,15 +145,7 @@ namespace osu.Game.Database
                             InstantiationInfo = skin.InstantiationInfo,
                         };
 
-                        foreach (var file in skin.Files)
-                        {
-                            var realmFile = realm.Find<RealmFile>(file.FileInfo.Hash);
-
-                            if (realmFile == null)
-                                realm.Add(realmFile = new RealmFile { Hash = file.FileInfo.Hash });
-
-                            realmSkin.Files.Add(new RealmNamedFileUsage(realmFile, file.Filename));
-                        }
+                        migrateFiles(skin, realm, realmSkin);
 
                         realm.Add(realmSkin);
 
@@ -101,6 +161,19 @@ namespace osu.Game.Database
             }
         }
 
+        private static void migrateFiles<T>(IHasFiles<T> fileSource, Realm realm, IHasRealmFiles realmObject) where T : INamedFileInfo
+        {
+            foreach (var file in fileSource.Files)
+            {
+                var realmFile = realm.Find<RealmFile>(file.FileInfo.Hash);
+
+                if (realmFile == null)
+                    realm.Add(realmFile = new RealmFile { Hash = file.FileInfo.Hash });
+
+                realmObject.Files.Add(new RealmNamedFileUsage(realmFile, file.Filename));
+            }
+        }
+
         private void migrateSettings(DatabaseWriteUsage db)
         {
             // migrate ruleset settings. can be removed 20220315.

From b610d2db124a580f233c94ff450ecef3e2fd6111 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 13 Jan 2022 18:02:08 +0900
Subject: [PATCH 2190/5547] Add EF to realm beatmap migration

---
 osu.Game/Beatmaps/EFBeatmapInfo.cs     |  25 +++---
 osu.Game/Database/EFToRealmMigrator.cs | 103 ++++++++++++++++++++++++-
 2 files changed, 115 insertions(+), 13 deletions(-)

diff --git a/osu.Game/Beatmaps/EFBeatmapInfo.cs b/osu.Game/Beatmaps/EFBeatmapInfo.cs
index 8257d0cf7d..8daeaa7030 100644
--- a/osu.Game/Beatmaps/EFBeatmapInfo.cs
+++ b/osu.Game/Beatmaps/EFBeatmapInfo.cs
@@ -41,7 +41,7 @@ namespace osu.Game.Beatmaps
         public BeatmapOnlineStatus Status { get; set; } = BeatmapOnlineStatus.None;
 
         [Required]
-        public EFBeatmapSetInfo BeatmapSet { get; set; }
+        public EFBeatmapSetInfo BeatmapSetInfo { get; set; }
 
         public EFBeatmapMetadata Metadata { get; set; }
 
@@ -85,9 +85,10 @@ namespace osu.Game.Beatmaps
         public float StackLeniency { get; set; } = 0.7f;
         public bool SpecialStyle { get; set; }
 
-        public int RulesetID { get; set; }
+        [Column("RulesetID")]
+        public int RulesetInfoID { get; set; }
 
-        public EFRulesetInfo Ruleset { get; set; }
+        public EFRulesetInfo RulesetInfo { get; set; }
 
         public bool LetterboxInBreaks { get; set; }
         public bool WidescreenStoryboard { get; set; }
@@ -145,13 +146,13 @@ namespace osu.Game.Beatmaps
 
         public bool Equals(IBeatmapInfo other) => other is EFBeatmapInfo b && Equals(b);
 
-        public bool AudioEquals(EFBeatmapInfo other) => other != null && BeatmapSet != null && other.BeatmapSet != null &&
-                                                        BeatmapSet.Hash == other.BeatmapSet.Hash &&
-                                                        (Metadata ?? BeatmapSet.Metadata).AudioFile == (other.Metadata ?? other.BeatmapSet.Metadata).AudioFile;
+        public bool AudioEquals(EFBeatmapInfo other) => other != null && BeatmapSetInfo != null && other.BeatmapSetInfo != null &&
+                                                        BeatmapSetInfo.Hash == other.BeatmapSetInfo.Hash &&
+                                                        (Metadata ?? BeatmapSetInfo.Metadata).AudioFile == (other.Metadata ?? other.BeatmapSetInfo.Metadata).AudioFile;
 
-        public bool BackgroundEquals(EFBeatmapInfo other) => other != null && BeatmapSet != null && other.BeatmapSet != null &&
-                                                             BeatmapSet.Hash == other.BeatmapSet.Hash &&
-                                                             (Metadata ?? BeatmapSet.Metadata).BackgroundFile == (other.Metadata ?? other.BeatmapSet.Metadata).BackgroundFile;
+        public bool BackgroundEquals(EFBeatmapInfo other) => other != null && BeatmapSetInfo != null && other.BeatmapSetInfo != null &&
+                                                             BeatmapSetInfo.Hash == other.BeatmapSetInfo.Hash &&
+                                                             (Metadata ?? BeatmapSetInfo.Metadata).BackgroundFile == (other.Metadata ?? other.BeatmapSetInfo.Metadata).BackgroundFile;
 
         /// <summary>
         /// Returns a shallow-clone of this <see cref="EFBeatmapInfo"/>.
@@ -167,16 +168,16 @@ namespace osu.Game.Beatmaps
         #region Implementation of IBeatmapInfo
 
         [JsonIgnore]
-        IBeatmapMetadataInfo IBeatmapInfo.Metadata => Metadata ?? BeatmapSet?.Metadata ?? new EFBeatmapMetadata();
+        IBeatmapMetadataInfo IBeatmapInfo.Metadata => Metadata ?? BeatmapSetInfo?.Metadata ?? new EFBeatmapMetadata();
 
         [JsonIgnore]
         IBeatmapDifficultyInfo IBeatmapInfo.Difficulty => BaseDifficulty;
 
         [JsonIgnore]
-        IBeatmapSetInfo IBeatmapInfo.BeatmapSet => BeatmapSet;
+        IBeatmapSetInfo IBeatmapInfo.BeatmapSet => BeatmapSetInfo;
 
         [JsonIgnore]
-        IRulesetInfo IBeatmapInfo.Ruleset => Ruleset;
+        IRulesetInfo IBeatmapInfo.Ruleset => RulesetInfo;
 
         #endregion
     }
diff --git a/osu.Game/Database/EFToRealmMigrator.cs b/osu.Game/Database/EFToRealmMigrator.cs
index 1aa364ff8f..02237b0ec0 100644
--- a/osu.Game/Database/EFToRealmMigrator.cs
+++ b/osu.Game/Database/EFToRealmMigrator.cs
@@ -35,10 +35,111 @@ namespace osu.Game.Database
                 migrateSettings(db);
                 migrateSkins(db);
 
+                migrateBeatmaps(db);
                 migrateScores(db);
             }
         }
 
+        private void migrateBeatmaps(DatabaseWriteUsage db)
+        {
+            // can be removed 20220730.
+            var existingBeatmapSets = db.Context.EFBeatmapSetInfo
+                                        .Include(s => s.Beatmaps).ThenInclude(b => b.RulesetInfo)
+                                        .Include(s => s.Beatmaps).ThenInclude(b => b.Metadata)
+                                        .Include(s => s.Beatmaps).ThenInclude(b => b.BaseDifficulty)
+                                        .Include(s => s.Files).ThenInclude(f => f.FileInfo)
+                                        .ToList();
+
+            // previous entries in EF are removed post migration.
+            if (!existingBeatmapSets.Any())
+                return;
+
+            using (var realm = realmContextFactory.CreateContext())
+            using (var transaction = realm.BeginWrite())
+            {
+                // only migrate data if the realm database is empty.
+                // note that this cannot be written as: `realm.All<BeatmapInfo>().All(s => s.Protected)`, because realm does not support `.All()`.
+                if (!realm.All<BeatmapSetInfo>().Any(s => !s.Protected))
+                {
+                    foreach (var beatmapSet in existingBeatmapSets)
+                    {
+                        var realmBeatmapSet = new BeatmapSetInfo
+                        {
+                            OnlineID = beatmapSet.OnlineID ?? -1,
+                            DateAdded = beatmapSet.DateAdded,
+                            Status = beatmapSet.Status,
+                            DeletePending = beatmapSet.DeletePending,
+                            Hash = beatmapSet.Hash,
+                            Protected = beatmapSet.Protected,
+                        };
+
+                        migrateFiles(beatmapSet, realm, realmBeatmapSet);
+
+                        foreach (var beatmap in beatmapSet.Beatmaps)
+                        {
+                            var realmBeatmap = new BeatmapInfo
+                            {
+                                DifficultyName = beatmap.DifficultyName,
+                                Status = beatmap.Status,
+                                OnlineID = beatmap.OnlineID ?? -1,
+                                Length = beatmap.Length,
+                                BPM = beatmap.BPM,
+                                Hash = beatmap.Hash,
+                                StarRating = beatmap.StarRating,
+                                MD5Hash = beatmap.MD5Hash,
+                                Hidden = beatmap.Hidden,
+                                AudioLeadIn = beatmap.AudioLeadIn,
+                                StackLeniency = beatmap.StackLeniency,
+                                SpecialStyle = beatmap.SpecialStyle,
+                                LetterboxInBreaks = beatmap.LetterboxInBreaks,
+                                WidescreenStoryboard = beatmap.WidescreenStoryboard,
+                                EpilepsyWarning = beatmap.EpilepsyWarning,
+                                SamplesMatchPlaybackRate = beatmap.SamplesMatchPlaybackRate,
+                                DistanceSpacing = beatmap.DistanceSpacing,
+                                BeatDivisor = beatmap.BeatDivisor,
+                                GridSize = beatmap.GridSize,
+                                TimelineZoom = beatmap.TimelineZoom,
+                                Countdown = beatmap.Countdown,
+                                CountdownOffset = beatmap.CountdownOffset,
+                                MaxCombo = beatmap.MaxCombo,
+                                Bookmarks = beatmap.Bookmarks,
+                                Ruleset = realm.Find<RulesetInfo>(beatmap.RulesetInfo.ShortName),
+                                Difficulty = new BeatmapDifficulty(beatmap.BaseDifficulty),
+                                Metadata = new BeatmapMetadata
+                                {
+                                    Title = beatmap.Metadata.Title,
+                                    TitleUnicode = beatmap.Metadata.TitleUnicode,
+                                    Artist = beatmap.Metadata.Artist,
+                                    ArtistUnicode = beatmap.Metadata.ArtistUnicode,
+                                    Author = new RealmUser
+                                    {
+                                        OnlineID = beatmap.Metadata.Author.Id,
+                                        Username = beatmap.Metadata.Author.Username,
+                                    },
+                                    Source = beatmap.Metadata.Source,
+                                    Tags = beatmap.Metadata.Tags,
+                                    PreviewTime = beatmap.Metadata.PreviewTime,
+                                    AudioFile = beatmap.Metadata.AudioFile,
+                                    BackgroundFile = beatmap.Metadata.BackgroundFile,
+                                    AuthorString = beatmap.Metadata.AuthorString,
+                                },
+                                BeatmapSet = realmBeatmapSet,
+                            };
+
+                            realmBeatmapSet.Beatmaps.Add(realmBeatmap);
+                        }
+
+                        realm.Add(realmBeatmapSet);
+                    }
+                }
+
+                // db.Context.RemoveRange(existingBeatmapSets);
+                // Intentionally don't clean up the files, so they don't get purged by EF.
+
+                transaction.Commit();
+            }
+        }
+
         private void migrateScores(DatabaseWriteUsage db)
         {
             // can be removed 20220730.
@@ -94,7 +195,7 @@ namespace osu.Game.Database
                     }
                 }
 
-                db.Context.RemoveRange(existingScores);
+                // db.Context.RemoveRange(existingScores);
                 // Intentionally don't clean up the files, so they don't get purged by EF.
 
                 transaction.Commit();

From 2840a71dda2f50b5c934b290e8f7ab676a227412 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 13 Jan 2022 18:28:00 +0900
Subject: [PATCH 2191/5547] Uncomment EF deletion lines in migrations

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

diff --git a/osu.Game/Database/EFToRealmMigrator.cs b/osu.Game/Database/EFToRealmMigrator.cs
index 02237b0ec0..ad0f2c5982 100644
--- a/osu.Game/Database/EFToRealmMigrator.cs
+++ b/osu.Game/Database/EFToRealmMigrator.cs
@@ -133,7 +133,7 @@ namespace osu.Game.Database
                     }
                 }
 
-                // db.Context.RemoveRange(existingBeatmapSets);
+                db.Context.RemoveRange(existingBeatmapSets);
                 // Intentionally don't clean up the files, so they don't get purged by EF.
 
                 transaction.Commit();
@@ -195,7 +195,7 @@ namespace osu.Game.Database
                     }
                 }
 
-                // db.Context.RemoveRange(existingScores);
+                db.Context.RemoveRange(existingScores);
                 // Intentionally don't clean up the files, so they don't get purged by EF.
 
                 transaction.Commit();

From c6ae255326a07da5fc73ab088b4e4560715600f5 Mon Sep 17 00:00:00 2001
From: Jamie Taylor <me@nekodex.net>
Date: Thu, 13 Jan 2022 18:31:32 +0900
Subject: [PATCH 2192/5547] Add volume dip to track during fail sequence

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

diff --git a/osu.Game/Screens/Play/FailAnimation.cs b/osu.Game/Screens/Play/FailAnimation.cs
index cfbfdc9966..17a3e5eb71 100644
--- a/osu.Game/Screens/Play/FailAnimation.cs
+++ b/osu.Game/Screens/Play/FailAnimation.cs
@@ -36,6 +36,7 @@ namespace osu.Game.Screens.Play
 
         private readonly DrawableRuleset drawableRuleset;
         private readonly BindableDouble trackFreq = new BindableDouble(1);
+        private readonly BindableDouble volumeAdjustment = new BindableDouble(0.5);
 
         private Container filters;
 
@@ -125,6 +126,7 @@ namespace osu.Game.Screens.Play
             failSample.Play();
 
             track.AddAdjustment(AdjustableProperty.Frequency, trackFreq);
+            track.AddAdjustment(AdjustableProperty.Volume, volumeAdjustment);
 
             applyToPlayfield(drawableRuleset.Playfield);
             drawableRuleset.Playfield.HitObjectContainer.FadeOut(duration / 2);
@@ -154,6 +156,8 @@ namespace osu.Game.Screens.Play
             if (resetTrackFrequency)
                 track?.RemoveAdjustment(AdjustableProperty.Frequency, trackFreq);
 
+            track?.RemoveAdjustment(AdjustableProperty.Volume, volumeAdjustment);
+
             if (filters.Parent == null)
                 return;
 

From c33fe7bcc6961ce24ba246e8c133a21864a6fd30 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 13 Jan 2022 18:32:59 +0900
Subject: [PATCH 2193/5547] Remove one more unnecessary `Detach` operation

---
 osu.Game/OsuGame.cs | 2 --
 1 file changed, 2 deletions(-)

diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index ad045d08d2..0be6a808d8 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -501,8 +501,6 @@ namespace osu.Game
                 return;
             }
 
-            databasedScoreInfo = databasedScoreInfo.Detach();
-
             var databasedScore = ScoreManager.GetScore(databasedScoreInfo);
 
             if (databasedScore.Replay == null)

From 54804ebfbdc1f39b30df11da48bb496f5c2766e6 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 13 Jan 2022 18:38:38 +0900
Subject: [PATCH 2194/5547] Fix delete/clear scores buttons not working

---
 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 b390cd225a..837f30eb2b 100644
--- a/osu.Game/Screens/Select/SongSelect.cs
+++ b/osu.Game/Screens/Select/SongSelect.cs
@@ -807,14 +807,14 @@ namespace osu.Game.Screens.Select
 
         private void delete(BeatmapSetInfo beatmap)
         {
-            if (beatmap == null || !beatmap.IsManaged) return;
+            if (beatmap == null) return;
 
             dialogOverlay?.Push(new BeatmapDeleteDialog(beatmap));
         }
 
         private void clearScores(BeatmapInfo beatmapInfo)
         {
-            if (beatmapInfo == null || !beatmapInfo.IsManaged) return;
+            if (beatmapInfo == null) return;
 
             dialogOverlay?.Push(new BeatmapClearScoresDialog(beatmapInfo, () =>
                 // schedule done here rather than inside the dialog as the dialog may fade out and never callback.

From 55b027228f31722d8ab84d9c292717c97c3206e6 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 14 Jan 2022 11:54:50 +0900
Subject: [PATCH 2195/5547] Update resources

---
 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 92adbebf5a..4198cf2bf4 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -51,7 +51,7 @@
     <Reference Include="Java.Interop" />
   </ItemGroup>
   <ItemGroup>
-    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.109.0" />
+    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.114.0" />
     <PackageReference Include="ppy.osu.Framework.Android" Version="2022.111.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 1430320c87..2609f17c73 100644
--- a/osu.Game/osu.Game.csproj
+++ b/osu.Game/osu.Game.csproj
@@ -37,7 +37,7 @@
     </PackageReference>
     <PackageReference Include="Realm" Version="10.7.1" />
     <PackageReference Include="ppy.osu.Framework" Version="2022.111.0" />
-    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.109.0" />
+    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.114.0" />
     <PackageReference Include="Sentry" Version="3.12.1" />
     <PackageReference Include="SharpCompress" Version="0.30.1" />
     <PackageReference Include="NUnit" Version="3.13.2" />
diff --git a/osu.iOS.props b/osu.iOS.props
index 3cef888447..0064a597fd 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -61,7 +61,7 @@
   </ItemGroup>
   <ItemGroup Label="Package References">
     <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.111.0" />
-    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.109.0" />
+    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.114.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net5.0 / net6.0) -->
   <PropertyGroup>

From 9b33fbbee52cff0d1af77cba8ac165b11c11d261 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 14 Jan 2022 13:08:20 +0900
Subject: [PATCH 2196/5547] Ensure detached when performing model `Clone`
 operations on `BeatmapInfo`/`ScoreInfo`

---
 osu.Game/Beatmaps/BeatmapInfo.cs | 2 +-
 osu.Game/Scoring/ScoreInfo.cs    | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapInfo.cs b/osu.Game/Beatmaps/BeatmapInfo.cs
index 078a34e50d..b9dd59cfe4 100644
--- a/osu.Game/Beatmaps/BeatmapInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapInfo.cs
@@ -185,7 +185,7 @@ namespace osu.Game.Beatmaps
 
         public int BeatmapVersion;
 
-        public BeatmapInfo Clone() => (BeatmapInfo)MemberwiseClone();
+        public BeatmapInfo Clone() => (BeatmapInfo)this.Detach().MemberwiseClone();
 
         public override string ToString() => this.GetDisplayTitle();
 
diff --git a/osu.Game/Scoring/ScoreInfo.cs b/osu.Game/Scoring/ScoreInfo.cs
index 9b4f4bf784..b168726283 100644
--- a/osu.Game/Scoring/ScoreInfo.cs
+++ b/osu.Game/Scoring/ScoreInfo.cs
@@ -131,7 +131,7 @@ namespace osu.Game.Scoring
 
         public ScoreInfo DeepClone()
         {
-            var clone = (ScoreInfo)MemberwiseClone();
+            var clone = (ScoreInfo)this.Detach().MemberwiseClone();
 
             clone.Statistics = new Dictionary<HitResult, int>(clone.Statistics);
 

From 8424d86e9afeec9670ffb7dd9203a588ec09ce4e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 14 Jan 2022 13:19:00 +0900
Subject: [PATCH 2197/5547] Remove unused `cancellationToken` parameter in
 synchronous `BeatmapOnlineLookupQueue` flow

---
 osu.Game/Beatmaps/BeatmapOnlineLookupQueue.cs | 2 +-
 osu.Game/Stores/BeatmapImporter.cs            | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapOnlineLookupQueue.cs b/osu.Game/Beatmaps/BeatmapOnlineLookupQueue.cs
index aecbd6f6e2..a5d7ce23ff 100644
--- a/osu.Game/Beatmaps/BeatmapOnlineLookupQueue.cs
+++ b/osu.Game/Beatmaps/BeatmapOnlineLookupQueue.cs
@@ -54,7 +54,7 @@ namespace osu.Game.Beatmaps
                 prepareLocalCache();
         }
 
-        public void Update(BeatmapSetInfo beatmapSet, CancellationToken cancellationToken)
+        public void Update(BeatmapSetInfo beatmapSet)
         {
             foreach (var b in beatmapSet.Beatmaps)
                 lookup(beatmapSet, b);
diff --git a/osu.Game/Stores/BeatmapImporter.cs b/osu.Game/Stores/BeatmapImporter.cs
index a9cb46ca29..3ebdcde296 100644
--- a/osu.Game/Stores/BeatmapImporter.cs
+++ b/osu.Game/Stores/BeatmapImporter.cs
@@ -71,7 +71,7 @@ namespace osu.Game.Stores
 
             bool hadOnlineIDs = beatmapSet.Beatmaps.Any(b => b.OnlineID > 0);
 
-            onlineLookupQueue?.Update(beatmapSet, cancellationToken);
+            onlineLookupQueue?.Update(beatmapSet);
 
             // ensure at least one beatmap was able to retrieve or keep an online ID, else drop the set ID.
             if (hadOnlineIDs && !beatmapSet.Beatmaps.Any(b => b.OnlineID > 0))

From dea2e1fac0215944b3c6b863158dedbe224aa2e0 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 14 Jan 2022 13:20:51 +0900
Subject: [PATCH 2198/5547] Return immediately on failed web request in
 synchronous `BeatmapOnlineLookupQueue` flow

---
 osu.Game/Beatmaps/BeatmapOnlineLookupQueue.cs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Game/Beatmaps/BeatmapOnlineLookupQueue.cs b/osu.Game/Beatmaps/BeatmapOnlineLookupQueue.cs
index a5d7ce23ff..a24b6b315a 100644
--- a/osu.Game/Beatmaps/BeatmapOnlineLookupQueue.cs
+++ b/osu.Game/Beatmaps/BeatmapOnlineLookupQueue.cs
@@ -88,6 +88,7 @@ namespace osu.Game.Beatmaps
                 {
                     logForModel(set, $"Online retrieval failed for {beatmapInfo}");
                     beatmapInfo.OnlineID = -1;
+                    return;
                 }
 
                 var res = req.Response;

From c64a919a9d29207061579e4400ae6f0244f4ac1d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 14 Jan 2022 16:29:26 +0900
Subject: [PATCH 2199/5547] Reduce number of redundant control points displayed
 on summary timeline

As pointed out in https://github.com/ppy/osu/discussions/16435, beatmaps
with too many control points (usually added via external automation
apps) could cause the lazer editor to grind to a halt.

The overheads here are mostly from the GL side. An eventual goal would
be to render this in a smarter way, rather than using thousands of
drawables. Until that, this optimisation should help reduce the overhead
by omitting control points in close proximity that are redundant for
display purposes.

I've tried to contain this in the display logic directly, with the goal
that it can be ripped out as fast as it was added. Certainly required
more changes than I hoped for, but I don't think it's too ugly.
---
 .../Summary/Parts/ControlPointPart.cs         | 24 ++++++++++++++++++-
 .../Parts/ControlPointVisualisation.cs        |  4 +++-
 .../Summary/Parts/EffectPointVisualisation.cs |  5 +++-
 .../Summary/Parts/GroupVisualisation.cs       | 15 ++++++++----
 .../IControlPointVisualisationRedundant.cs    | 12 ++++++++++
 5 files changed, 52 insertions(+), 8 deletions(-)
 create mode 100644 osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/IControlPointVisualisationRedundant.cs

diff --git a/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/ControlPointPart.cs b/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/ControlPointPart.cs
index 70afc1e308..f6a7353e13 100644
--- a/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/ControlPointPart.cs
+++ b/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/ControlPointPart.cs
@@ -31,7 +31,16 @@ namespace osu.Game.Screens.Edit.Components.Timelines.Summary.Parts
 
                     case NotifyCollectionChangedAction.Add:
                         foreach (var group in args.NewItems.OfType<ControlPointGroup>())
+                        {
+                            // as an optimisation, don't add a visualisation if there are already groups with the same types in close proximity.
+                            // for newly added control points (ie. lazer editor first where group is added empty) we always skip for simplicity.
+                            // that is fine, because cases where this is causing a performance issue are mostly where external tools were used to create an insane number of points.
+                            // if (Children.Any(g => Math.Abs(g.Group.Time - group.Time) < 1000 && g.IsRedundant(group)))
+                            //     continue;
+
                             Add(new GroupVisualisation(group));
+                        }
+
                         break;
 
                     case NotifyCollectionChangedAction.Remove:
@@ -39,7 +48,20 @@ namespace osu.Game.Screens.Edit.Components.Timelines.Summary.Parts
                         {
                             var matching = Children.SingleOrDefault(gv => gv.Group == group);
 
-                            matching?.Expire();
+                            if (matching != null)
+                                matching.Expire();
+                            else
+                            {
+                                // due to the add optimisation above, if a point is deleted which wasn't being displayed we need to recreate all points
+                                // to guarantee an accurate representation.
+                                //
+                                // note that the case where control point (type) is added or removed from a non-displayed group is not handled correctly.
+                                // this is an edge case which shouldn't affect the user too badly. we may flatted control point groups in the future
+                                // which would allow this to be handled better.
+                                Clear();
+                                foreach (var g in controlPointGroups)
+                                    Add(new GroupVisualisation(g));
+                            }
                         }
 
                         break;
diff --git a/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/ControlPointVisualisation.cs b/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/ControlPointVisualisation.cs
index a8e41d220a..96fce1dac5 100644
--- a/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/ControlPointVisualisation.cs
+++ b/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/ControlPointVisualisation.cs
@@ -9,7 +9,7 @@ using osu.Game.Screens.Edit.Components.Timelines.Summary.Visualisations;
 
 namespace osu.Game.Screens.Edit.Components.Timelines.Summary.Parts
 {
-    public class ControlPointVisualisation : PointVisualisation
+    public class ControlPointVisualisation : PointVisualisation, IControlPointVisualisationRedundant
     {
         protected readonly ControlPoint Point;
 
@@ -26,5 +26,7 @@ namespace osu.Game.Screens.Edit.Components.Timelines.Summary.Parts
         {
             Colour = Point.GetRepresentingColour(colours);
         }
+
+        public bool IsRedundant(ControlPoint other) => other.GetType() == Point.GetType();
     }
 }
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 801372305b..c08ab3728f 100644
--- a/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/EffectPointVisualisation.cs
+++ b/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/EffectPointVisualisation.cs
@@ -13,7 +13,7 @@ using osu.Game.Screens.Edit.Components.Timelines.Summary.Visualisations;
 
 namespace osu.Game.Screens.Edit.Components.Timelines.Summary.Parts
 {
-    public class EffectPointVisualisation : CompositeDrawable
+    public class EffectPointVisualisation : CompositeDrawable, IControlPointVisualisationRedundant
     {
         private readonly EffectControlPoint effect;
         private Bindable<bool> kiai;
@@ -68,5 +68,8 @@ namespace osu.Game.Screens.Edit.Components.Timelines.Summary.Parts
                 }
             }, true);
         }
+
+        // kiai sections display duration, so are required to be visualised.
+        public bool IsRedundant(ControlPoint other) => (other as EffectControlPoint)?.KiaiMode == effect.KiaiMode;
     }
 }
diff --git a/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/GroupVisualisation.cs b/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/GroupVisualisation.cs
index f0e643f805..b55df66a02 100644
--- a/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/GroupVisualisation.cs
+++ b/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/GroupVisualisation.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.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
@@ -23,12 +24,8 @@ namespace osu.Game.Screens.Edit.Components.Timelines.Summary.Parts
 
             Group = group;
             X = (float)group.Time;
-        }
-
-        protected override void LoadComplete()
-        {
-            base.LoadComplete();
 
+            // Run in constructor so IsRedundant calls can work correctly.
             controlPoints.BindTo(Group.ControlPoints);
             controlPoints.BindCollectionChanged((_, __) =>
             {
@@ -60,5 +57,13 @@ namespace osu.Game.Screens.Edit.Components.Timelines.Summary.Parts
                 }
             }, true);
         }
+
+        /// <summary>
+        /// For display purposes, check whether the proposed group is made redundant by this visualisation group.
+        /// </summary>
+        /// <param name="other"></param>
+        /// <returns></returns>
+        public bool IsRedundant(ControlPointGroup other) =>
+            other.ControlPoints.Any(c => InternalChildren.OfType<IControlPointVisualisationRedundant>().Any(c2 => c2.IsRedundant(c)));
     }
 }
diff --git a/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/IControlPointVisualisationRedundant.cs b/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/IControlPointVisualisationRedundant.cs
new file mode 100644
index 0000000000..e4d47e4cdc
--- /dev/null
+++ b/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/IControlPointVisualisationRedundant.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 osu.Game.Beatmaps.ControlPoints;
+
+namespace osu.Game.Screens.Edit.Components.Timelines.Summary.Parts
+{
+    public interface IControlPointVisualisationRedundant
+    {
+        bool IsRedundant(ControlPoint other);
+    }
+}

From 916b591b1b6bc7c3e00fa6e4511926ea6eee2259 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 14 Jan 2022 18:03:06 +0900
Subject: [PATCH 2200/5547] Fix watch replay button not working immediately
 after playing

---
 osu.Game/Online/ScoreDownloadTracker.cs |  2 +-
 osu.Game/Screens/Play/Player.cs         | 11 ++++++-----
 2 files changed, 7 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Online/ScoreDownloadTracker.cs b/osu.Game/Online/ScoreDownloadTracker.cs
index 08362448a3..b34586567d 100644
--- a/osu.Game/Online/ScoreDownloadTracker.cs
+++ b/osu.Game/Online/ScoreDownloadTracker.cs
@@ -47,7 +47,7 @@ namespace osu.Game.Online
             Downloader.DownloadBegan += downloadBegan;
             Downloader.DownloadFailed += downloadFailed;
 
-            realmSubscription = realmContextFactory.Context.All<ScoreInfo>().Where(s => s.OnlineID == TrackedItem.OnlineID && !s.DeletePending).QueryAsyncWithNotifications((items, changes, ___) =>
+            realmSubscription = realmContextFactory.Context.All<ScoreInfo>().Where(s => ((s.OnlineID > 0 && s.OnlineID == TrackedItem.OnlineID) || s.Hash == TrackedItem.Hash) && !s.DeletePending).QueryAsyncWithNotifications((items, changes, ___) =>
             {
                 if (items.Any())
                     Schedule(() => UpdateState(DownloadState.LocallyAvailable));
diff --git a/osu.Game/Screens/Play/Player.cs b/osu.Game/Screens/Play/Player.cs
index 9fc0d70cc0..ff3fea51cf 100644
--- a/osu.Game/Screens/Play/Player.cs
+++ b/osu.Game/Screens/Play/Player.cs
@@ -18,6 +18,7 @@ using osu.Framework.Screens;
 using osu.Framework.Threading;
 using osu.Game.Beatmaps;
 using osu.Game.Configuration;
+using osu.Game.Database;
 using osu.Game.Graphics.Containers;
 using osu.Game.IO.Archives;
 using osu.Game.Online.API;
@@ -1038,17 +1039,17 @@ namespace osu.Game.Screens.Play
                 replayReader = new LegacyByteArrayReader(stream.ToArray(), "replay.osr");
             }
 
-            // the import process will re-attach managed beatmap/rulesets to this score. we don't want this for now, so create a temporary copy to import.
-            var importableScore = score.ScoreInfo.DeepClone();
-
             // For the time being, online ID responses are not really useful for anything.
             // In addition, the IDs provided via new (lazer) endpoints are based on a different autoincrement from legacy (stable) scores.
             //
             // Until we better define the server-side logic behind this, let's not store the online ID to avoid potential unique constraint
             // conflicts across various systems (ie. solo and multiplayer).
-            importableScore.OnlineID = -1;
+            score.ScoreInfo.OnlineID = -1;
 
-            await scoreManager.Import(importableScore, replayReader).ConfigureAwait(false);
+            var imported = await scoreManager.Import(score.ScoreInfo, replayReader).ConfigureAwait(false);
+
+            // detach post-import as we want to keep using the score for display in results.
+            score.ScoreInfo = imported.PerformRead(s => s.Detach());
         }
 
         /// <summary>

From 7e9b5dd1506cf0f09cf4bd42a4c648dea244df20 Mon Sep 17 00:00:00 2001
From: Jamie Taylor <me@nekodex.net>
Date: Fri, 14 Jan 2022 18:06:19 +0900
Subject: [PATCH 2201/5547] Add audio feedback for host change in multiplayer

---
 .../Screens/OnlinePlay/Match/RoomSubScreen.cs |  2 +
 .../Multiplayer/MultiplayerRoomSounds.cs      | 66 +++++++++++++++++++
 .../Participants/ParticipantsList.cs          | 31 ---------
 3 files changed, 68 insertions(+), 31 deletions(-)
 create mode 100644 osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerRoomSounds.cs

diff --git a/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs b/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
index c31239616c..2d5225639f 100644
--- a/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
@@ -21,6 +21,7 @@ using osu.Game.Overlays.Mods;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Screens.OnlinePlay.Match.Components;
+using osu.Game.Screens.OnlinePlay.Multiplayer;
 
 namespace osu.Game.Screens.OnlinePlay.Match
 {
@@ -101,6 +102,7 @@ namespace osu.Game.Screens.OnlinePlay.Match
             InternalChildren = new Drawable[]
             {
                 beatmapAvailabilityTracker,
+                new MultiplayerRoomSounds(),
                 new GridContainer
                 {
                     RelativeSizeAxes = Axes.Both,
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerRoomSounds.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerRoomSounds.cs
new file mode 100644
index 0000000000..42e3716e5a
--- /dev/null
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerRoomSounds.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 osu.Framework.Allocation;
+using osu.Framework.Audio;
+using osu.Framework.Audio.Sample;
+using osu.Framework.Bindables;
+using osu.Game.Online.API.Requests.Responses;
+using osu.Game.Online.Multiplayer;
+
+namespace osu.Game.Screens.OnlinePlay.Multiplayer
+{
+    public class MultiplayerRoomSounds : MultiplayerRoomComposite
+    {
+        private Sample hostChangedSample;
+        private Sample userJoinedSample;
+        private Sample userLeftSample;
+        private Sample userKickedSample;
+
+        [BackgroundDependencyLoader]
+        private void load(AudioManager audio)
+        {
+            hostChangedSample = audio.Samples.Get(@"Multiplayer/host-changed");
+            userJoinedSample = audio.Samples.Get(@"Multiplayer/player-joined");
+            userLeftSample = audio.Samples.Get(@"Multiplayer/player-left");
+            userKickedSample = audio.Samples.Get(@"Multiplayer/player-kicked");
+
+            Host.ValueChanged += hostChanged;
+        }
+
+        private void hostChanged(ValueChangedEvent<APIUser> value)
+        {
+            if (value.OldValue == null) return;
+
+            hostChangedSample?.Play();
+        }
+
+        protected override void UserJoined(MultiplayerRoomUser user)
+        {
+            base.UserJoined(user);
+
+            userJoinedSample?.Play();
+        }
+
+        protected override void UserLeft(MultiplayerRoomUser user)
+        {
+            base.UserLeft(user);
+
+            userLeftSample?.Play();
+        }
+
+        protected override void UserKicked(MultiplayerRoomUser user)
+        {
+            base.UserKicked(user);
+
+            userKickedSample?.Play();
+        }
+
+        protected override void Dispose(bool isDisposing)
+        {
+            base.Dispose(isDisposing);
+
+            Host.ValueChanged -= hostChanged;
+        }
+    }
+}
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantsList.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantsList.cs
index d36c556fac..fe40a4bfe6 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantsList.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantsList.cs
@@ -4,12 +4,10 @@
 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.Game.Graphics.Containers;
 using osu.Game.Graphics.Cursor;
-using osu.Game.Online.Multiplayer;
 using osuTK;
 
 namespace osu.Game.Screens.OnlinePlay.Multiplayer.Participants
@@ -18,10 +16,6 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Participants
     {
         private FillFlowContainer<ParticipantPanel> panels;
 
-        private Sample userJoinSample;
-        private Sample userLeftSample;
-        private Sample userKickedSample;
-
         [BackgroundDependencyLoader]
         private void load(AudioManager audio)
         {
@@ -41,31 +35,6 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Participants
                     }
                 }
             };
-
-            userJoinSample = audio.Samples.Get(@"Multiplayer/player-joined");
-            userLeftSample = audio.Samples.Get(@"Multiplayer/player-left");
-            userKickedSample = audio.Samples.Get(@"Multiplayer/player-kicked");
-        }
-
-        protected override void UserJoined(MultiplayerRoomUser user)
-        {
-            base.UserJoined(user);
-
-            userJoinSample?.Play();
-        }
-
-        protected override void UserLeft(MultiplayerRoomUser user)
-        {
-            base.UserLeft(user);
-
-            userLeftSample?.Play();
-        }
-
-        protected override void UserKicked(MultiplayerRoomUser user)
-        {
-            base.UserKicked(user);
-
-            userKickedSample?.Play();
         }
 
         protected override void OnRoomUpdated()

From 34dbde6023512d654bc4a4ad823563165650b23f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 14 Jan 2022 18:22:52 +0900
Subject: [PATCH 2202/5547] Only copy across `Hash` and `ID` so statistics
 aren't lost

---
 osu.Game/Screens/Play/Player.cs | 16 +++++++++++-----
 1 file changed, 11 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Screens/Play/Player.cs b/osu.Game/Screens/Play/Player.cs
index ff3fea51cf..4d3201cd27 100644
--- a/osu.Game/Screens/Play/Player.cs
+++ b/osu.Game/Screens/Play/Player.cs
@@ -18,7 +18,6 @@ using osu.Framework.Screens;
 using osu.Framework.Threading;
 using osu.Game.Beatmaps;
 using osu.Game.Configuration;
-using osu.Game.Database;
 using osu.Game.Graphics.Containers;
 using osu.Game.IO.Archives;
 using osu.Game.Online.API;
@@ -1039,17 +1038,24 @@ namespace osu.Game.Screens.Play
                 replayReader = new LegacyByteArrayReader(stream.ToArray(), "replay.osr");
             }
 
+            // the import process will re-attach managed beatmap/rulesets to this score. we don't want this for now, so create a temporary copy to import.
+            var importableScore = score.ScoreInfo.DeepClone();
+
             // For the time being, online ID responses are not really useful for anything.
             // In addition, the IDs provided via new (lazer) endpoints are based on a different autoincrement from legacy (stable) scores.
             //
             // Until we better define the server-side logic behind this, let's not store the online ID to avoid potential unique constraint
             // conflicts across various systems (ie. solo and multiplayer).
-            score.ScoreInfo.OnlineID = -1;
+            importableScore.OnlineID = -1;
 
-            var imported = await scoreManager.Import(score.ScoreInfo, replayReader).ConfigureAwait(false);
+            var imported = await scoreManager.Import(importableScore, replayReader).ConfigureAwait(false);
 
-            // detach post-import as we want to keep using the score for display in results.
-            score.ScoreInfo = imported.PerformRead(s => s.Detach());
+            imported.PerformRead(s =>
+            {
+                // because of the clone above, it's required that we copy back the post-import hash/ID to use for availability matching.
+                score.ScoreInfo.Hash = s.Hash;
+                score.ScoreInfo.ID = s.ID;
+            });
         }
 
         /// <summary>

From 7acd1b545f748a07703a85eeeba7230c0eb9ded1 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 14 Jan 2022 19:55:09 +0900
Subject: [PATCH 2203/5547] Remove unnecessary `Live` conversion in
 `IntroScreen` (handled by `GetWorkingBeatmap`)

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

diff --git a/osu.Game/Screens/Menu/IntroScreen.cs b/osu.Game/Screens/Menu/IntroScreen.cs
index 0f5dbb2842..265ec41f96 100644
--- a/osu.Game/Screens/Menu/IntroScreen.cs
+++ b/osu.Game/Screens/Menu/IntroScreen.cs
@@ -109,7 +109,7 @@ namespace osu.Game.Screens.Menu
                         if (s.Beatmaps.Count == 0)
                             return;
 
-                        initialBeatmap = beatmaps.GetWorkingBeatmap(s.Beatmaps[0].ToLive(realmContextFactory));
+                        initialBeatmap = beatmaps.GetWorkingBeatmap(s.Beatmaps[0]);
                     });
                 }
             }

From 3a95425a9eeb2a14bd95411129baf30880a6ab10 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 14 Jan 2022 19:55:49 +0900
Subject: [PATCH 2204/5547] Remove left-over methods in `MusicController`

---
 osu.Game/Overlays/MusicController.cs | 8 --------
 1 file changed, 8 deletions(-)

diff --git a/osu.Game/Overlays/MusicController.cs b/osu.Game/Overlays/MusicController.cs
index 44c2916f12..70f8332295 100644
--- a/osu.Game/Overlays/MusicController.cs
+++ b/osu.Game/Overlays/MusicController.cs
@@ -134,14 +134,6 @@ namespace osu.Game.Overlays
         /// </summary>
         public bool TrackLoaded => CurrentTrack.TrackLoaded;
 
-        private void beatmapUpdated(BeatmapSetInfo set) => Schedule(() =>
-        {
-            beatmapSets.Remove(set);
-            beatmapSets.Add(set);
-        });
-
-        private void beatmapRemoved(BeatmapSetInfo set) => Schedule(() => beatmapSets.RemoveAll(s => s.ID == set.ID));
-
         private ScheduledDelegate seekDelegate;
 
         public void SeekTo(double position)

From a59dcccab7a4134081dfbc7351eab8b015981684 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 14 Jan 2022 19:59:21 +0900
Subject: [PATCH 2205/5547] Add local `ContextFactory` caching to all remaining
 test scenes that create local managers

---
 .../Visual/Collections/TestSceneManageCollectionsDialog.cs      | 1 +
 .../Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs         | 1 +
 osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs       | 1 +
 .../Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs   | 1 +
 .../Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs    | 2 ++
 .../Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs          | 1 +
 .../Visual/Multiplayer/TestSceneMultiplayerQueueList.cs         | 1 +
 .../Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs       | 2 ++
 .../Visual/Multiplayer/TestSceneMultiplayerSpectateButton.cs    | 2 ++
 .../Visual/Multiplayer/TestScenePlaylistsSongSelect.cs          | 1 +
 osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs        | 1 +
 .../Visual/Playlists/TestScenePlaylistsRoomCreation.cs          | 1 +
 osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs | 1 +
 osu.Game.Tests/Visual/SongSelect/TestSceneFilterControl.cs      | 1 +
 .../Visual/UserInterface/TestSceneDeleteLocalScore.cs           | 1 +
 15 files changed, 18 insertions(+)

diff --git a/osu.Game.Tests/Visual/Collections/TestSceneManageCollectionsDialog.cs b/osu.Game.Tests/Visual/Collections/TestSceneManageCollectionsDialog.cs
index d2b0f7324b..18572ac211 100644
--- a/osu.Game.Tests/Visual/Collections/TestSceneManageCollectionsDialog.cs
+++ b/osu.Game.Tests/Visual/Collections/TestSceneManageCollectionsDialog.cs
@@ -38,6 +38,7 @@ namespace osu.Game.Tests.Visual.Collections
         {
             Dependencies.Cache(rulesets = new RulesetStore(ContextFactory));
             Dependencies.Cache(beatmapManager = new BeatmapManager(LocalStorage, ContextFactory, rulesets, null, Audio, Resources, host, Beatmap.Default));
+            Dependencies.Cache(ContextFactory);
 
             beatmapManager.Import(TestResources.GetQuickTestBeatmapForImport()).WaitSafely();
 
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
index 5bad36c3dd..99c867b014 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
@@ -45,6 +45,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             Dependencies.Cache(rulesets = new RulesetStore(ContextFactory));
             Dependencies.Cache(manager = new BeatmapManager(LocalStorage, ContextFactory, rulesets, null, audio, Resources, host, Beatmap.Default));
+            Dependencies.Cache(ContextFactory);
         }
 
         [Test]
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
index d55ca0b578..373b165acc 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
@@ -63,6 +63,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             Dependencies.Cache(rulesets = new RulesetStore(ContextFactory));
             Dependencies.Cache(beatmaps = new BeatmapManager(LocalStorage, ContextFactory, rulesets, API, audio, Resources, host, Beatmap.Default));
+            Dependencies.Cache(ContextFactory);
         }
 
         public override void SetUpSteps()
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs
index c6fb418a5b..181b0c71f2 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs
@@ -44,6 +44,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             Dependencies.Cache(rulesets = new RulesetStore(ContextFactory));
             Dependencies.Cache(manager = new BeatmapManager(LocalStorage, ContextFactory, rulesets, null, audio, Resources, host, Beatmap.Default));
+            Dependencies.Cache(ContextFactory);
 
             beatmaps = new List<BeatmapInfo>();
 
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs
index 98b14fbddb..012a2fd960 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs
@@ -40,6 +40,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             Dependencies.Cache(rulesets = new RulesetStore(ContextFactory));
             Dependencies.Cache(beatmaps = new BeatmapManager(LocalStorage, ContextFactory, rulesets, null, audio, Resources, host, Beatmap.Default));
+            Dependencies.Cache(ContextFactory);
+
             beatmaps.Import(TestResources.GetQuickTestBeatmapForImport()).WaitSafely();
 
             importedSet = beatmaps.GetAllUsableBeatmapSets().First();
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs
index 813b62176b..d547b42891 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs
@@ -35,6 +35,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             Dependencies.Cache(rulesets = new RulesetStore(ContextFactory));
             Dependencies.Cache(beatmaps = new BeatmapManager(LocalStorage, ContextFactory, rulesets, null, audio, Resources, host, Beatmap.Default));
+            Dependencies.Cache(ContextFactory);
         }
 
         [SetUp]
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs
index b5d31c7ae9..965b142ed7 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs
@@ -40,6 +40,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             Dependencies.Cache(rulesets = new RulesetStore(ContextFactory));
             Dependencies.Cache(beatmaps = new BeatmapManager(LocalStorage, ContextFactory, rulesets, API, audio, Resources, host, Beatmap.Default));
+            Dependencies.Cache(ContextFactory);
         }
 
         public override void SetUpSteps()
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs
index 0b2ab1aef3..1c346e09d5 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs
@@ -42,6 +42,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             Dependencies.Cache(rulesets = new RulesetStore(ContextFactory));
             Dependencies.Cache(beatmaps = new BeatmapManager(LocalStorage, ContextFactory, rulesets, null, audio, Resources, host, Beatmap.Default));
+            Dependencies.Cache(ContextFactory);
+
             beatmaps.Import(TestResources.GetQuickTestBeatmapForImport()).WaitSafely();
         }
 
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerSpectateButton.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerSpectateButton.cs
index 6b1001f6b7..221732910b 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerSpectateButton.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerSpectateButton.cs
@@ -43,6 +43,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             Dependencies.Cache(rulesets = new RulesetStore(ContextFactory));
             Dependencies.Cache(beatmaps = new BeatmapManager(LocalStorage, ContextFactory, rulesets, null, audio, Resources, host, Beatmap.Default));
+            Dependencies.Cache(ContextFactory);
+
             beatmaps.Import(TestResources.GetQuickTestBeatmapForImport()).WaitSafely();
         }
 
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsSongSelect.cs b/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsSongSelect.cs
index 08fcac125d..0b0006e437 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsSongSelect.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsSongSelect.cs
@@ -36,6 +36,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             Dependencies.Cache(rulesets = new RulesetStore(ContextFactory));
             Dependencies.Cache(manager = new BeatmapManager(LocalStorage, ContextFactory, rulesets, null, audio, Resources, host, Beatmap.Default));
+            Dependencies.Cache(ContextFactory);
 
             var beatmapSet = TestResources.CreateTestBeatmapSetInfo();
 
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs
index 97d17ada71..39cde0ad87 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs
@@ -44,6 +44,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             Dependencies.Cache(rulesets = new RulesetStore(ContextFactory));
             Dependencies.Cache(beatmaps = new BeatmapManager(LocalStorage, ContextFactory, rulesets, null, audio, Resources, host, Beatmap.Default));
+            Dependencies.Cache(ContextFactory);
         }
 
         public override void SetUpSteps()
diff --git a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs
index 2180f0f717..dfcf657218 100644
--- a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs
+++ b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs
@@ -41,6 +41,7 @@ namespace osu.Game.Tests.Visual.Playlists
         {
             Dependencies.Cache(rulesets = new RulesetStore(ContextFactory));
             Dependencies.Cache(manager = new BeatmapManager(LocalStorage, ContextFactory, rulesets, API, audio, Resources, host, Beatmap.Default));
+            Dependencies.Cache(ContextFactory);
         }
 
         [SetUpSteps]
diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
index 78df4d8d98..a314ed8a6e 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
@@ -46,6 +46,7 @@ namespace osu.Game.Tests.Visual.SongSelect
             dependencies.Cache(rulesetStore = new RulesetStore(ContextFactory));
             dependencies.Cache(beatmapManager = new BeatmapManager(LocalStorage, ContextFactory, rulesetStore, null, dependencies.Get<AudioManager>(), Resources, dependencies.Get<GameHost>(), Beatmap.Default));
             dependencies.Cache(scoreManager = new ScoreManager(dependencies.Get<RulesetStore>(), () => beatmapManager, LocalStorage, dependencies.Get<RealmContextFactory>(), Scheduler));
+            Dependencies.Cache(ContextFactory);
 
             return dependencies;
         }
diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneFilterControl.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneFilterControl.cs
index 1ee59eccc7..ca8e9d2eff 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneFilterControl.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneFilterControl.cs
@@ -38,6 +38,7 @@ namespace osu.Game.Tests.Visual.SongSelect
         {
             Dependencies.Cache(rulesets = new RulesetStore(ContextFactory));
             Dependencies.Cache(beatmapManager = new BeatmapManager(LocalStorage, ContextFactory, rulesets, null, Audio, Resources, host, Beatmap.Default));
+            Dependencies.Cache(ContextFactory);
 
             beatmapManager.Import(TestResources.GetQuickTestBeatmapForImport()).WaitSafely();
 
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
index 63df6a6390..02746ee8e8 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
@@ -90,6 +90,7 @@ namespace osu.Game.Tests.Visual.UserInterface
             dependencies.Cache(rulesetStore = new RulesetStore(ContextFactory));
             dependencies.Cache(beatmapManager = new BeatmapManager(LocalStorage, ContextFactory, rulesetStore, null, dependencies.Get<AudioManager>(), Resources, dependencies.Get<GameHost>(), Beatmap.Default));
             dependencies.Cache(scoreManager = new ScoreManager(dependencies.Get<RulesetStore>(), () => beatmapManager, LocalStorage, dependencies.Get<RealmContextFactory>(), Scheduler));
+            Dependencies.Cache(ContextFactory);
 
             var imported = beatmapManager.Import(new ImportTask(TestResources.GetQuickTestBeatmapForImport())).GetResultSafely();
 

From 289ae7c72f18dd22f93925437b44acb5347550d1 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 14 Jan 2022 21:39:42 +0900
Subject: [PATCH 2206/5547] Update one more mismatched test implementation

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

diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
index a314ed8a6e..9ae15c387a 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
@@ -45,7 +45,7 @@ namespace osu.Game.Tests.Visual.SongSelect
 
             dependencies.Cache(rulesetStore = new RulesetStore(ContextFactory));
             dependencies.Cache(beatmapManager = new BeatmapManager(LocalStorage, ContextFactory, rulesetStore, null, dependencies.Get<AudioManager>(), Resources, dependencies.Get<GameHost>(), Beatmap.Default));
-            dependencies.Cache(scoreManager = new ScoreManager(dependencies.Get<RulesetStore>(), () => beatmapManager, LocalStorage, dependencies.Get<RealmContextFactory>(), Scheduler));
+            dependencies.Cache(scoreManager = new ScoreManager(rulesetStore, () => beatmapManager, LocalStorage, dependencies.Get<RealmContextFactory>(), Scheduler));
             Dependencies.Cache(ContextFactory);
 
             return dependencies;

From 9900a3f408b084dedca6cee885bebf7e2ac39073 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 14 Jan 2022 21:40:35 +0900
Subject: [PATCH 2207/5547] Remove outdated comment

---
 osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs | 1 -
 1 file changed, 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs
index d7e3951ac2..0f5bea10e8 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs
@@ -429,7 +429,6 @@ namespace osu.Game.Tests.Visual.SongSelect
 
             for (int i = 0; i < 20; i++)
             {
-                // index + 1 because we are using OnlineID which should never be zero.
                 var set = TestResources.CreateTestBeatmapSetInfo();
 
                 // only need to set the first as they are a shared reference.

From e558fd69d22fcf17dffce8e4b2d90b5c7042a513 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 14 Jan 2022 23:26:29 +0900
Subject: [PATCH 2208/5547] Remove unnecessary null check and associated
 comment

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

diff --git a/osu.Game/Tests/Visual/RateAdjustedBeatmapTestScene.cs b/osu.Game/Tests/Visual/RateAdjustedBeatmapTestScene.cs
index 5bac2635f5..1034f208a9 100644
--- a/osu.Game/Tests/Visual/RateAdjustedBeatmapTestScene.cs
+++ b/osu.Game/Tests/Visual/RateAdjustedBeatmapTestScene.cs
@@ -12,7 +12,7 @@ namespace osu.Game.Tests.Visual
         {
             base.Update();
 
-            if (Beatmap.Value.TrackLoaded && Beatmap.Value.Track != null) // null check... wasn't required until now?
+            if (Beatmap.Value.TrackLoaded)
             {
                 // note that this will override any mod rate application
                 Beatmap.Value.Track.Tempo.Value = Clock.Rate;

From 8d4a3cc56959aa0e07425bef9dd7b159a4c58d32 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 14 Jan 2022 23:27:33 +0900
Subject: [PATCH 2209/5547] Remove pointless `Metadata` set

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

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneBeatmapSkinFallbacks.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneBeatmapSkinFallbacks.cs
index b6a08dd2ab..c5f56cae9e 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneBeatmapSkinFallbacks.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneBeatmapSkinFallbacks.cs
@@ -42,7 +42,7 @@ namespace osu.Game.Tests.Visual.Gameplay
         [Test]
         public void TestEmptyLegacyBeatmapSkinFallsBack()
         {
-            CreateSkinTest(DefaultSkin.CreateInfo(), () => new LegacyBeatmapSkin(new BeatmapInfo { Metadata = new BeatmapMetadata() }, null, null));
+            CreateSkinTest(DefaultSkin.CreateInfo(), () => new LegacyBeatmapSkin(new BeatmapInfo(), null, null));
             AddUntilStep("wait for hud load", () => Player.ChildrenOfType<SkinnableTargetContainer>().All(c => c.ComponentsLoaded));
             AddAssert("hud from default skin", () => AssertComponentsFromExpectedSource(SkinnableTarget.MainHUDComponents, skinManager.CurrentSkin.Value));
         }

From 2f2c498477f4038315fcbcd0029bbc013ace3a60 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 14 Jan 2022 23:31:42 +0900
Subject: [PATCH 2210/5547] Fix importer not considering that some EF beatmaps
 have no local metadata

---
 osu.Game/Database/EFToRealmMigrator.cs | 44 +++++++++++++++-----------
 1 file changed, 26 insertions(+), 18 deletions(-)

diff --git a/osu.Game/Database/EFToRealmMigrator.cs b/osu.Game/Database/EFToRealmMigrator.cs
index ad0f2c5982..7683accc5c 100644
--- a/osu.Game/Database/EFToRealmMigrator.cs
+++ b/osu.Game/Database/EFToRealmMigrator.cs
@@ -48,6 +48,7 @@ namespace osu.Game.Database
                                         .Include(s => s.Beatmaps).ThenInclude(b => b.Metadata)
                                         .Include(s => s.Beatmaps).ThenInclude(b => b.BaseDifficulty)
                                         .Include(s => s.Files).ThenInclude(f => f.FileInfo)
+                                        .Include(s => s.Metadata)
                                         .ToList();
 
             // previous entries in EF are removed post migration.
@@ -105,24 +106,7 @@ namespace osu.Game.Database
                                 Bookmarks = beatmap.Bookmarks,
                                 Ruleset = realm.Find<RulesetInfo>(beatmap.RulesetInfo.ShortName),
                                 Difficulty = new BeatmapDifficulty(beatmap.BaseDifficulty),
-                                Metadata = new BeatmapMetadata
-                                {
-                                    Title = beatmap.Metadata.Title,
-                                    TitleUnicode = beatmap.Metadata.TitleUnicode,
-                                    Artist = beatmap.Metadata.Artist,
-                                    ArtistUnicode = beatmap.Metadata.ArtistUnicode,
-                                    Author = new RealmUser
-                                    {
-                                        OnlineID = beatmap.Metadata.Author.Id,
-                                        Username = beatmap.Metadata.Author.Username,
-                                    },
-                                    Source = beatmap.Metadata.Source,
-                                    Tags = beatmap.Metadata.Tags,
-                                    PreviewTime = beatmap.Metadata.PreviewTime,
-                                    AudioFile = beatmap.Metadata.AudioFile,
-                                    BackgroundFile = beatmap.Metadata.BackgroundFile,
-                                    AuthorString = beatmap.Metadata.AuthorString,
-                                },
+                                Metadata = getBestMetadata(beatmap.Metadata, beatmapSet.Metadata),
                                 BeatmapSet = realmBeatmapSet,
                             };
 
@@ -140,6 +124,30 @@ namespace osu.Game.Database
             }
         }
 
+        private BeatmapMetadata getBestMetadata(EFBeatmapMetadata? beatmapMetadata, EFBeatmapMetadata? beatmapSetMetadata)
+        {
+            var metadata = beatmapMetadata ?? beatmapSetMetadata ?? new EFBeatmapMetadata();
+
+            return new BeatmapMetadata
+            {
+                Title = metadata.Title,
+                TitleUnicode = metadata.TitleUnicode,
+                Artist = metadata.Artist,
+                ArtistUnicode = metadata.ArtistUnicode,
+                Author = new RealmUser
+                {
+                    OnlineID = metadata.Author.Id,
+                    Username = metadata.Author.Username,
+                },
+                Source = metadata.Source,
+                Tags = metadata.Tags,
+                PreviewTime = metadata.PreviewTime,
+                AudioFile = metadata.AudioFile,
+                BackgroundFile = metadata.BackgroundFile,
+                AuthorString = metadata.AuthorString,
+            };
+        }
+
         private void migrateScores(DatabaseWriteUsage db)
         {
             // can be removed 20220730.

From 2984f2f6c4e7abcf75cff17c7cc92b081e48ccb6 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 15 Jan 2022 01:15:09 +0900
Subject: [PATCH 2211/5547] Fix custom keybindings not working due to incorrect
 use of `IsManaged` flag

---
 .../Bindings/DatabasedKeyBindingContainer.cs  | 23 ++++++++++---------
 1 file changed, 12 insertions(+), 11 deletions(-)

diff --git a/osu.Game/Input/Bindings/DatabasedKeyBindingContainer.cs b/osu.Game/Input/Bindings/DatabasedKeyBindingContainer.cs
index 9482f1c0d8..03b069d431 100644
--- a/osu.Game/Input/Bindings/DatabasedKeyBindingContainer.cs
+++ b/osu.Game/Input/Bindings/DatabasedKeyBindingContainer.cs
@@ -78,19 +78,20 @@ namespace osu.Game.Input.Bindings
         {
             var defaults = DefaultKeyBindings.ToList();
 
-            if (ruleset != null && !ruleset.IsManaged)
-                // some tests instantiate a ruleset which is not present in the database.
-                // in these cases we still want key bindings to work, but matching to database instances would result in none being present,
-                // so let's populate the defaults directly.
+            List<RealmKeyBinding> newBindings = realmKeyBindings.Detach()
+                                                                // this ordering is important to ensure that we read entries from the database in the order
+                                                                // enforced by DefaultKeyBindings. allow for song select to handle actions that may otherwise
+                                                                // have been eaten by the music controller due to query order.
+                                                                .OrderBy(b => defaults.FindIndex(d => (int)d.Action == b.ActionInt)).ToList();
+
+            // In the case no bindings were found in the database, presume this usage is for a non-databased ruleset.
+            // This actually should never be required and can be removed if it is ever deemed to cause a problem.
+            // See https://github.com/ppy/osu/issues/8805 for original reasoning, which is no longer valid as we use ShortName
+            // for lookups these days.
+            if (newBindings.Count == 0)
                 KeyBindings = defaults;
             else
-            {
-                KeyBindings = realmKeyBindings.Detach()
-                                              // this ordering is important to ensure that we read entries from the database in the order
-                                              // enforced by DefaultKeyBindings. allow for song select to handle actions that may otherwise
-                                              // have been eaten by the music controller due to query order.
-                                              .OrderBy(b => defaults.FindIndex(d => (int)d.Action == b.ActionInt)).ToList();
-            }
+                KeyBindings = newBindings;
         }
     }
 }

From 9af9155e66beecc6c344f87f9563747f64e45e91 Mon Sep 17 00:00:00 2001
From: Susko3 <16479013+Susko3@users.noreply.github.com>
Date: Fri, 14 Jan 2022 17:37:58 +0100
Subject: [PATCH 2212/5547] Fix `osu.Game.Tests.Android` not building

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

diff --git a/osu.Game.Tests/Visual/Ranking/TestSceneResultsScreen.cs b/osu.Game.Tests/Visual/Ranking/TestSceneResultsScreen.cs
index 666cbf02b5..8a0ed2e108 100644
--- a/osu.Game.Tests/Visual/Ranking/TestSceneResultsScreen.cs
+++ b/osu.Game.Tests/Visual/Ranking/TestSceneResultsScreen.cs
@@ -203,7 +203,7 @@ namespace osu.Game.Tests.Visual.Ranking
         {
             DelayedFetchResultsScreen screen = null;
 
-            var tcs = new TaskCompletionSource();
+            var tcs = new TaskCompletionSource<bool>();
 
             AddStep("load results", () => Child = new TestResultsContainer(screen = new DelayedFetchResultsScreen(TestResources.CreateTestScoreInfo(), tcs.Task)));
 
@@ -218,7 +218,7 @@ namespace osu.Game.Tests.Visual.Ranking
 
             AddAssert("no fetch yet", () => !screen.FetchCompleted);
 
-            AddStep("allow fetch", () => tcs.SetResult());
+            AddStep("allow fetch", () => tcs.SetResult(true));
 
             AddUntilStep("wait for fetch", () => screen.FetchCompleted);
             AddAssert("expanded panel still on screen", () => this.ChildrenOfType<ScorePanel>().Single(p => p.State == PanelState.Expanded).ScreenSpaceDrawQuad.TopLeft.X > 0);

From 19467e58c1b65148984c2e38f467bfd240490bb1 Mon Sep 17 00:00:00 2001
From: Susko3 <16479013+Susko3@users.noreply.github.com>
Date: Sat, 15 Jan 2022 01:06:39 +0100
Subject: [PATCH 2213/5547] Remove unused params from BDL methods

---
 .../osu.Game.Rulesets.EmptyFreeform.Tests/TestSceneOsuGame.cs | 3 +--
 .../osu.Game.Rulesets.Pippidon.Tests/TestSceneOsuGame.cs      | 3 +--
 .../TestSceneOsuGame.cs                                       | 3 +--
 .../osu.Game.Rulesets.Pippidon.Tests/TestSceneOsuGame.cs      | 3 +--
 .../osu.Game.Rulesets.Pippidon/UI/PippidonPlayfield.cs        | 3 +--
 osu.Desktop/Security/ElevatedPrivilegesChecker.cs             | 2 +-
 .../Edit/Blueprints/HoldNoteSelectionBlueprint.cs             | 3 +--
 .../Edit/Blueprints/Sliders/SliderPlacementBlueprint.cs       | 3 +--
 osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSpinner.cs    | 3 +--
 .../Skinning/Default/SpinnerBackgroundLayer.cs                | 4 +---
 .../Skinning/Legacy/LegacyCursorParticles.cs                  | 2 +-
 osu.Game.Rulesets.Osu/UI/Cursor/OsuCursorContainer.cs         | 2 +-
 .../Skinning/Default/CentreHitCirclePiece.cs                  | 3 +--
 osu.Game.Rulesets.Taiko/Skinning/Default/RimHitCirclePiece.cs | 3 +--
 osu.Game.Rulesets.Taiko/UI/DrawableTaikoMascot.cs             | 3 +--
 .../Visual/Beatmaps/TestSceneBeatmapCardDifficultyList.cs     | 3 +--
 osu.Game.Tests/Visual/Gameplay/TestSceneAllRulesetPlayers.cs  | 2 +-
 .../TestSceneUpdateableBeatmapBackgroundSprite.cs             | 3 +--
 osu.Game.Tournament.Tests/TestSceneTournamentSceneManager.cs  | 3 +--
 osu.Game.Tournament/Components/DrawableTeamTitle.cs           | 3 +--
 osu.Game.Tournament/Components/DrawableTournamentTeam.cs      | 3 +--
 osu.Game.Tournament/Components/TournamentBeatmapPanel.cs      | 3 +--
 osu.Game.Tournament/Screens/Editors/RoundEditorScreen.cs      | 3 +--
 osu.Game.Tournament/Screens/Editors/SeedingEditorScreen.cs    | 3 +--
 .../Gameplay/Components/TournamentMatchScoreDisplay.cs        | 3 +--
 osu.Game.Tournament/Screens/Gameplay/GameplayScreen.cs        | 3 +--
 .../Screens/Ladder/Components/DrawableMatchTeam.cs            | 2 +-
 osu.Game.Tournament/Screens/Ladder/LadderScreen.cs            | 4 +---
 osu.Game.Tournament/Screens/Schedule/ScheduleScreen.cs        | 3 +--
 osu.Game.Tournament/Screens/TeamIntro/SeedingScreen.cs        | 3 +--
 osu.Game.Tournament/Screens/TeamIntro/TeamIntroScreen.cs      | 3 +--
 osu.Game.Tournament/Screens/TeamWin/TeamWinScreen.cs          | 3 +--
 osu.Game.Tournament/TournamentSceneManager.cs                 | 4 +---
 osu.Game/Collections/DrawableCollectionListItem.cs            | 2 +-
 osu.Game/Graphics/Sprites/LogoAnimation.cs                    | 3 +--
 osu.Game/Graphics/UserInterface/DrawableOsuMenuItem.cs        | 3 +--
 .../Graphics/UserInterface/HoverSampleDebounceComponent.cs    | 3 +--
 osu.Game/Graphics/UserInterface/OsuContextMenu.cs             | 3 +--
 osu.Game/Graphics/UserInterface/OsuContextMenuSamples.cs      | 2 +-
 osu.Game/Overlays/AccountCreation/ScreenEntry.cs              | 2 +-
 osu.Game/Overlays/AccountCreationOverlay.cs                   | 3 +--
 osu.Game/Overlays/Changelog/ChangelogBuild.cs                 | 2 +-
 osu.Game/Overlays/ChangelogOverlay.cs                         | 3 +--
 osu.Game/Overlays/Comments/CommentsContainer.cs               | 2 +-
 osu.Game/Overlays/Profile/Header/CentreHeaderContainer.cs     | 3 +--
 .../Settings/Sections/DebugSettings/MemorySettings.cs         | 3 +--
 osu.Game/Overlays/Settings/SettingsFooter.cs                  | 2 +-
 osu.Game/Overlays/Settings/SettingsSection.cs                 | 2 +-
 osu.Game/Rulesets/UI/FrameStabilityContainer.cs               | 2 +-
 osu.Game/Screens/Edit/Compose/Components/SelectionHandler.cs  | 3 +--
 .../Edit/Compose/Components/Timeline/SamplePointPiece.cs      | 3 +--
 .../Edit/Compose/Components/Timeline/TimingPointPiece.cs      | 3 +--
 osu.Game/Screens/Edit/EditorRoundedScreenSettingsSection.cs   | 3 +--
 osu.Game/Screens/Edit/Verify/VisibilitySection.cs             | 3 +--
 osu.Game/Screens/Import/FileImportScreen.cs                   | 3 +--
 osu.Game/Screens/Menu/ButtonSystem.cs                         | 3 +--
 osu.Game/Screens/Menu/IntroScreen.cs                          | 3 +--
 osu.Game/Screens/Menu/IntroTriangles.cs                       | 2 +-
 osu.Game/Screens/Menu/MainMenu.cs                             | 2 +-
 osu.Game/Screens/OsuScreen.cs                                 | 2 +-
 osu.Game/Screens/Play/EpilepsyWarning.cs                      | 4 +---
 osu.Game/Screens/Play/HUD/HoldForMenuButton.cs                | 2 +-
 osu.Game/Screens/Play/HUD/UnstableRateCounter.cs              | 3 +--
 osu.Game/Screens/Ranking/Expanded/Accuracy/AccuracyCircle.cs  | 3 +--
 osu.Game/Screens/Select/BeatmapDetailAreaTabControl.cs        | 3 +--
 osu.Game/Tests/Visual/SkinnableTestScene.cs                   | 2 +-
 osu.Game/Users/Drawables/ClickableAvatar.cs                   | 3 +--
 67 files changed, 67 insertions(+), 120 deletions(-)

diff --git a/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform.Tests/TestSceneOsuGame.cs b/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform.Tests/TestSceneOsuGame.cs
index 536fdfc6df..5973db908c 100644
--- a/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform.Tests/TestSceneOsuGame.cs
+++ b/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform.Tests/TestSceneOsuGame.cs
@@ -4,7 +4,6 @@
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Shapes;
-using osu.Framework.Platform;
 using osu.Game.Tests.Visual;
 using osuTK.Graphics;
 
@@ -13,7 +12,7 @@ namespace osu.Game.Rulesets.EmptyFreeform.Tests
     public class TestSceneOsuGame : OsuTestScene
     {
         [BackgroundDependencyLoader]
-        private void load(GameHost host, OsuGameBase gameBase)
+        private void load()
         {
             Children = new Drawable[]
             {
diff --git a/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon.Tests/TestSceneOsuGame.cs b/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon.Tests/TestSceneOsuGame.cs
index 3cdf44e6f1..b75a5ec187 100644
--- a/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon.Tests/TestSceneOsuGame.cs
+++ b/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon.Tests/TestSceneOsuGame.cs
@@ -4,7 +4,6 @@
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Shapes;
-using osu.Framework.Platform;
 using osu.Game.Tests.Visual;
 using osuTK.Graphics;
 
@@ -13,7 +12,7 @@ namespace osu.Game.Rulesets.Pippidon.Tests
     public class TestSceneOsuGame : OsuTestScene
     {
         [BackgroundDependencyLoader]
-        private void load(GameHost host, OsuGameBase gameBase)
+        private void load()
         {
             Children = new Drawable[]
             {
diff --git a/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling.Tests/TestSceneOsuGame.cs b/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling.Tests/TestSceneOsuGame.cs
index 4d3f5086d9..ffe921b54c 100644
--- a/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling.Tests/TestSceneOsuGame.cs
+++ b/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling.Tests/TestSceneOsuGame.cs
@@ -4,7 +4,6 @@
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Shapes;
-using osu.Framework.Platform;
 using osu.Game.Tests.Visual;
 using osuTK.Graphics;
 
@@ -13,7 +12,7 @@ namespace osu.Game.Rulesets.EmptyScrolling.Tests
     public class TestSceneOsuGame : OsuTestScene
     {
         [BackgroundDependencyLoader]
-        private void load(GameHost host, OsuGameBase gameBase)
+        private void load()
         {
             Children = new Drawable[]
             {
diff --git a/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon.Tests/TestSceneOsuGame.cs b/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon.Tests/TestSceneOsuGame.cs
index 3cdf44e6f1..b75a5ec187 100644
--- a/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon.Tests/TestSceneOsuGame.cs
+++ b/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon.Tests/TestSceneOsuGame.cs
@@ -4,7 +4,6 @@
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Shapes;
-using osu.Framework.Platform;
 using osu.Game.Tests.Visual;
 using osuTK.Graphics;
 
@@ -13,7 +12,7 @@ namespace osu.Game.Rulesets.Pippidon.Tests
     public class TestSceneOsuGame : OsuTestScene
     {
         [BackgroundDependencyLoader]
-        private void load(GameHost host, OsuGameBase gameBase)
+        private void load()
         {
             Children = new Drawable[]
             {
diff --git a/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon/UI/PippidonPlayfield.cs b/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon/UI/PippidonPlayfield.cs
index 0e50030162..ab8c6bb2e9 100644
--- a/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon/UI/PippidonPlayfield.cs
+++ b/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon/UI/PippidonPlayfield.cs
@@ -7,7 +7,6 @@ using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
-using osu.Framework.Graphics.Textures;
 using osu.Game.Beatmaps.ControlPoints;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
@@ -28,7 +27,7 @@ namespace osu.Game.Rulesets.Pippidon.UI
         private PippidonCharacter pippidon;
 
         [BackgroundDependencyLoader]
-        private void load(TextureStore textures)
+        private void load()
         {
             AddRangeInternal(new Drawable[]
             {
diff --git a/osu.Desktop/Security/ElevatedPrivilegesChecker.cs b/osu.Desktop/Security/ElevatedPrivilegesChecker.cs
index 62ea3e0399..8f3ad853dc 100644
--- a/osu.Desktop/Security/ElevatedPrivilegesChecker.cs
+++ b/osu.Desktop/Security/ElevatedPrivilegesChecker.cs
@@ -73,7 +73,7 @@ namespace osu.Desktop.Security
             }
 
             [BackgroundDependencyLoader]
-            private void load(OsuColour colours, NotificationOverlay notificationOverlay)
+            private void load(OsuColour colours)
             {
                 Icon = FontAwesome.Solid.ShieldAlt;
                 IconBackground.Colour = colours.YellowDark;
diff --git a/osu.Game.Rulesets.Mania/Edit/Blueprints/HoldNoteSelectionBlueprint.cs b/osu.Game.Rulesets.Mania/Edit/Blueprints/HoldNoteSelectionBlueprint.cs
index 5259fcbd5f..35889aea0c 100644
--- a/osu.Game.Rulesets.Mania/Edit/Blueprints/HoldNoteSelectionBlueprint.cs
+++ b/osu.Game.Rulesets.Mania/Edit/Blueprints/HoldNoteSelectionBlueprint.cs
@@ -9,7 +9,6 @@ using osu.Framework.Graphics.Shapes;
 using osu.Game.Graphics;
 using osu.Game.Rulesets.Mania.Edit.Blueprints.Components;
 using osu.Game.Rulesets.Mania.Objects;
-using osu.Game.Rulesets.UI.Scrolling;
 using osuTK;
 
 namespace osu.Game.Rulesets.Mania.Edit.Blueprints
@@ -28,7 +27,7 @@ namespace osu.Game.Rulesets.Mania.Edit.Blueprints
         }
 
         [BackgroundDependencyLoader]
-        private void load(IScrollingInfo scrollingInfo)
+        private void load()
         {
             InternalChildren = new Drawable[]
             {
diff --git a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/SliderPlacementBlueprint.cs b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/SliderPlacementBlueprint.cs
index 07b6a1bdc2..b868c9a7ee 100644
--- a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/SliderPlacementBlueprint.cs
+++ b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/SliderPlacementBlueprint.cs
@@ -9,7 +9,6 @@ using osu.Framework.Graphics;
 using osu.Framework.Input;
 using osu.Framework.Input.Events;
 using osu.Game.Beatmaps.ControlPoints;
-using osu.Game.Graphics;
 using osu.Game.Rulesets.Edit;
 using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Objects.Types;
@@ -50,7 +49,7 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders
         }
 
         [BackgroundDependencyLoader]
-        private void load(OsuColour colours)
+        private void load()
         {
             InternalChildren = new Drawable[]
             {
diff --git a/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSpinner.cs b/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSpinner.cs
index ec87d3bfdf..c6db02ee02 100644
--- a/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSpinner.cs
+++ b/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSpinner.cs
@@ -10,7 +10,6 @@ using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Audio;
-using osu.Game.Graphics;
 using osu.Game.Rulesets.Judgements;
 using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Objects.Drawables;
@@ -69,7 +68,7 @@ namespace osu.Game.Rulesets.Osu.Objects.Drawables
         }
 
         [BackgroundDependencyLoader]
-        private void load(OsuColour colours)
+        private void load()
         {
             Origin = Anchor.Centre;
             RelativeSizeAxes = Axes.Both;
diff --git a/osu.Game.Rulesets.Osu/Skinning/Default/SpinnerBackgroundLayer.cs b/osu.Game.Rulesets.Osu/Skinning/Default/SpinnerBackgroundLayer.cs
index f8a6e1d3c9..a1184a15cd 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Default/SpinnerBackgroundLayer.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Default/SpinnerBackgroundLayer.cs
@@ -3,15 +3,13 @@
 
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
-using osu.Game.Graphics;
-using osu.Game.Rulesets.Objects.Drawables;
 
 namespace osu.Game.Rulesets.Osu.Skinning.Default
 {
     public class SpinnerBackgroundLayer : SpinnerFill
     {
         [BackgroundDependencyLoader]
-        private void load(OsuColour colours, DrawableHitObject drawableHitObject)
+        private void load()
         {
             Disc.Alpha = 0;
             Anchor = Anchor.Centre;
diff --git a/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyCursorParticles.cs b/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyCursorParticles.cs
index 611ddd08eb..b511444c44 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyCursorParticles.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyCursorParticles.cs
@@ -40,7 +40,7 @@ namespace osu.Game.Rulesets.Osu.Skinning.Legacy
         private GameplayState gameplayState { get; set; }
 
         [BackgroundDependencyLoader]
-        private void load(ISkinSource skin, OsuColour colours)
+        private void load(ISkinSource skin)
         {
             var texture = skin.GetTexture("star2");
             var starBreakAdditive = skin.GetConfig<OsuSkinColour, Color4>(OsuSkinColour.StarBreakAdditive)?.Value ?? new Color4(255, 182, 193, 255);
diff --git a/osu.Game.Rulesets.Osu/UI/Cursor/OsuCursorContainer.cs b/osu.Game.Rulesets.Osu/UI/Cursor/OsuCursorContainer.cs
index d1d9ee9f4d..b60ea5da21 100644
--- a/osu.Game.Rulesets.Osu/UI/Cursor/OsuCursorContainer.cs
+++ b/osu.Game.Rulesets.Osu/UI/Cursor/OsuCursorContainer.cs
@@ -58,7 +58,7 @@ namespace osu.Game.Rulesets.Osu.UI.Cursor
         private OsuConfigManager config { get; set; }
 
         [BackgroundDependencyLoader(true)]
-        private void load(OsuConfigManager config, OsuRulesetConfigManager rulesetConfig)
+        private void load(OsuRulesetConfigManager rulesetConfig)
         {
             rulesetConfig?.BindWith(OsuRulesetSetting.ShowCursorTrail, showTrail);
         }
diff --git a/osu.Game.Rulesets.Taiko/Skinning/Default/CentreHitCirclePiece.cs b/osu.Game.Rulesets.Taiko/Skinning/Default/CentreHitCirclePiece.cs
index 455b2fc596..25f895708f 100644
--- a/osu.Game.Rulesets.Taiko/Skinning/Default/CentreHitCirclePiece.cs
+++ b/osu.Game.Rulesets.Taiko/Skinning/Default/CentreHitCirclePiece.cs
@@ -5,7 +5,6 @@ using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
-using osu.Game.Graphics;
 using osu.Game.Rulesets.Taiko.Objects;
 using osuTK;
 
@@ -19,7 +18,7 @@ namespace osu.Game.Rulesets.Taiko.Skinning.Default
         }
 
         [BackgroundDependencyLoader]
-        private void load(OsuColour colours)
+        private void load()
         {
             AccentColour = Hit.COLOUR_CENTRE;
         }
diff --git a/osu.Game.Rulesets.Taiko/Skinning/Default/RimHitCirclePiece.cs b/osu.Game.Rulesets.Taiko/Skinning/Default/RimHitCirclePiece.cs
index bd21d511b1..c6165495d8 100644
--- a/osu.Game.Rulesets.Taiko/Skinning/Default/RimHitCirclePiece.cs
+++ b/osu.Game.Rulesets.Taiko/Skinning/Default/RimHitCirclePiece.cs
@@ -5,7 +5,6 @@ using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
-using osu.Game.Graphics;
 using osu.Game.Rulesets.Taiko.Objects;
 using osuTK;
 using osuTK.Graphics;
@@ -20,7 +19,7 @@ namespace osu.Game.Rulesets.Taiko.Skinning.Default
         }
 
         [BackgroundDependencyLoader]
-        private void load(OsuColour colours)
+        private void load()
         {
             AccentColour = Hit.COLOUR_RIM;
         }
diff --git a/osu.Game.Rulesets.Taiko/UI/DrawableTaikoMascot.cs b/osu.Game.Rulesets.Taiko/UI/DrawableTaikoMascot.cs
index e1063e1071..7ba2618a63 100644
--- a/osu.Game.Rulesets.Taiko/UI/DrawableTaikoMascot.cs
+++ b/osu.Game.Rulesets.Taiko/UI/DrawableTaikoMascot.cs
@@ -7,7 +7,6 @@ using osu.Framework.Audio.Track;
 using osu.Framework.Bindables;
 using osu.Framework.Extensions.IEnumerableExtensions;
 using osu.Framework.Graphics;
-using osu.Framework.Graphics.Textures;
 using osu.Game.Beatmaps.ControlPoints;
 using osu.Game.Graphics.Containers;
 using osu.Game.Rulesets.Judgements;
@@ -39,7 +38,7 @@ namespace osu.Game.Rulesets.Taiko.UI
         }
 
         [BackgroundDependencyLoader(true)]
-        private void load(TextureStore textures, GameplayState gameplayState)
+        private void load(GameplayState gameplayState)
         {
             InternalChildren = new[]
             {
diff --git a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCardDifficultyList.cs b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCardDifficultyList.cs
index aec75884d6..e6fb4372ff 100644
--- a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCardDifficultyList.cs
+++ b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCardDifficultyList.cs
@@ -6,7 +6,6 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
 using osu.Game.Beatmaps.Drawables.Cards;
-using osu.Game.Graphics;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays;
 
@@ -18,7 +17,7 @@ namespace osu.Game.Tests.Visual.Beatmaps
         private OverlayColourProvider colourProvider = new OverlayColourProvider(OverlayColourScheme.Blue);
 
         [BackgroundDependencyLoader]
-        private void load(OsuColour colours)
+        private void load()
         {
             var beatmapSet = new APIBeatmapSet
             {
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneAllRulesetPlayers.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneAllRulesetPlayers.cs
index c5ab3974a4..e10ef57a25 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneAllRulesetPlayers.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneAllRulesetPlayers.cs
@@ -25,7 +25,7 @@ namespace osu.Game.Tests.Visual.Gameplay
         protected OsuConfigManager Config { get; private set; }
 
         [BackgroundDependencyLoader]
-        private void load(RulesetStore rulesets)
+        private void load()
         {
             Dependencies.Cache(Config = new OsuConfigManager(LocalStorage));
             Config.GetBindable<double>(OsuSetting.DimLevel).Value = 1.0;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneUpdateableBeatmapBackgroundSprite.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneUpdateableBeatmapBackgroundSprite.cs
index 6fe1ccc037..736df7dec1 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneUpdateableBeatmapBackgroundSprite.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneUpdateableBeatmapBackgroundSprite.cs
@@ -14,7 +14,6 @@ using osu.Game.Graphics.Containers;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests;
 using osu.Game.Online.API.Requests.Responses;
-using osu.Game.Rulesets;
 using osu.Game.Tests.Beatmaps.IO;
 using osuTK;
 
@@ -28,7 +27,7 @@ namespace osu.Game.Tests.Visual.UserInterface
         private IAPIProvider api;
 
         [BackgroundDependencyLoader]
-        private void load(OsuGameBase osu, IAPIProvider api, RulesetStore rulesets)
+        private void load(OsuGameBase osu, IAPIProvider api)
         {
             this.api = api;
 
diff --git a/osu.Game.Tournament.Tests/TestSceneTournamentSceneManager.cs b/osu.Game.Tournament.Tests/TestSceneTournamentSceneManager.cs
index 4d134ce4af..53591da07b 100644
--- a/osu.Game.Tournament.Tests/TestSceneTournamentSceneManager.cs
+++ b/osu.Game.Tournament.Tests/TestSceneTournamentSceneManager.cs
@@ -2,14 +2,13 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using osu.Framework.Allocation;
-using osu.Framework.Platform;
 
 namespace osu.Game.Tournament.Tests
 {
     public class TestSceneTournamentSceneManager : TournamentTestScene
     {
         [BackgroundDependencyLoader]
-        private void load(Storage storage)
+        private void load()
         {
             Add(new TournamentSceneManager());
         }
diff --git a/osu.Game.Tournament/Components/DrawableTeamTitle.cs b/osu.Game.Tournament/Components/DrawableTeamTitle.cs
index 5aac37259f..6732eb152f 100644
--- a/osu.Game.Tournament/Components/DrawableTeamTitle.cs
+++ b/osu.Game.Tournament/Components/DrawableTeamTitle.cs
@@ -4,7 +4,6 @@
 using JetBrains.Annotations;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
-using osu.Framework.Graphics.Textures;
 using osu.Game.Tournament.Models;
 
 namespace osu.Game.Tournament.Components
@@ -22,7 +21,7 @@ namespace osu.Game.Tournament.Components
         }
 
         [BackgroundDependencyLoader]
-        private void load(TextureStore textures)
+        private void load()
         {
             if (team == null) return;
 
diff --git a/osu.Game.Tournament/Components/DrawableTournamentTeam.cs b/osu.Game.Tournament/Components/DrawableTournamentTeam.cs
index b9442a67f5..367e447947 100644
--- a/osu.Game.Tournament/Components/DrawableTournamentTeam.cs
+++ b/osu.Game.Tournament/Components/DrawableTournamentTeam.cs
@@ -5,7 +5,6 @@ using JetBrains.Annotations;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics.Containers;
-using osu.Framework.Graphics.Textures;
 using osu.Game.Graphics;
 using osu.Game.Tournament.Models;
 
@@ -33,7 +32,7 @@ namespace osu.Game.Tournament.Components
         }
 
         [BackgroundDependencyLoader]
-        private void load(TextureStore textures)
+        private void load()
         {
             if (Team == null) return;
 
diff --git a/osu.Game.Tournament/Components/TournamentBeatmapPanel.cs b/osu.Game.Tournament/Components/TournamentBeatmapPanel.cs
index 364cccd076..4189f3ccb5 100644
--- a/osu.Game.Tournament/Components/TournamentBeatmapPanel.cs
+++ b/osu.Game.Tournament/Components/TournamentBeatmapPanel.cs
@@ -9,7 +9,6 @@ using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
-using osu.Framework.Graphics.Textures;
 using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.Drawables;
 using osu.Game.Graphics;
@@ -45,7 +44,7 @@ namespace osu.Game.Tournament.Components
         }
 
         [BackgroundDependencyLoader]
-        private void load(LadderInfo ladder, TextureStore textures)
+        private void load(LadderInfo ladder)
         {
             currentMatch.BindValueChanged(matchChanged);
             currentMatch.BindTo(ladder.CurrentMatch);
diff --git a/osu.Game.Tournament/Screens/Editors/RoundEditorScreen.cs b/osu.Game.Tournament/Screens/Editors/RoundEditorScreen.cs
index f6bc607447..5c12d83d1c 100644
--- a/osu.Game.Tournament/Screens/Editors/RoundEditorScreen.cs
+++ b/osu.Game.Tournament/Screens/Editors/RoundEditorScreen.cs
@@ -12,7 +12,6 @@ using osu.Game.Online.API;
 using osu.Game.Online.API.Requests;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays.Settings;
-using osu.Game.Rulesets;
 using osu.Game.Tournament.Components;
 using osu.Game.Tournament.Models;
 using osuTK;
@@ -218,7 +217,7 @@ namespace osu.Game.Tournament.Screens.Editors
                     }
 
                     [BackgroundDependencyLoader]
-                    private void load(RulesetStore rulesets)
+                    private void load()
                     {
                         beatmapId.Value = Model.ID;
                         beatmapId.BindValueChanged(id =>
diff --git a/osu.Game.Tournament/Screens/Editors/SeedingEditorScreen.cs b/osu.Game.Tournament/Screens/Editors/SeedingEditorScreen.cs
index 5d2fddffd9..5cdfe7dc08 100644
--- a/osu.Game.Tournament/Screens/Editors/SeedingEditorScreen.cs
+++ b/osu.Game.Tournament/Screens/Editors/SeedingEditorScreen.cs
@@ -12,7 +12,6 @@ using osu.Game.Online.API;
 using osu.Game.Online.API.Requests;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays.Settings;
-using osu.Game.Rulesets;
 using osu.Game.Tournament.Components;
 using osu.Game.Tournament.Models;
 using osuTK;
@@ -220,7 +219,7 @@ namespace osu.Game.Tournament.Screens.Editors
                     }
 
                     [BackgroundDependencyLoader]
-                    private void load(RulesetStore rulesets)
+                    private void load()
                     {
                         beatmapId.Value = Model.ID;
                         beatmapId.BindValueChanged(id =>
diff --git a/osu.Game.Tournament/Screens/Gameplay/Components/TournamentMatchScoreDisplay.cs b/osu.Game.Tournament/Screens/Gameplay/Components/TournamentMatchScoreDisplay.cs
index 813bed86ae..db15a46fc8 100644
--- a/osu.Game.Tournament/Screens/Gameplay/Components/TournamentMatchScoreDisplay.cs
+++ b/osu.Game.Tournament/Screens/Gameplay/Components/TournamentMatchScoreDisplay.cs
@@ -11,7 +11,6 @@ using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Tournament.IPC;
-using osu.Game.Tournament.Models;
 using osuTK;
 
 namespace osu.Game.Tournament.Screens.Gameplay.Components
@@ -91,7 +90,7 @@ namespace osu.Game.Tournament.Screens.Gameplay.Components
         }
 
         [BackgroundDependencyLoader]
-        private void load(LadderInfo ladder, MatchIPCInfo ipc)
+        private void load(MatchIPCInfo ipc)
         {
             score1.BindValueChanged(_ => updateScores());
             score1.BindTo(ipc.Score1);
diff --git a/osu.Game.Tournament/Screens/Gameplay/GameplayScreen.cs b/osu.Game.Tournament/Screens/Gameplay/GameplayScreen.cs
index 7e7c719152..f900dd7eac 100644
--- a/osu.Game.Tournament/Screens/Gameplay/GameplayScreen.cs
+++ b/osu.Game.Tournament/Screens/Gameplay/GameplayScreen.cs
@@ -6,7 +6,6 @@ using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
-using osu.Framework.Platform;
 using osu.Framework.Threading;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Overlays.Settings;
@@ -37,7 +36,7 @@ namespace osu.Game.Tournament.Screens.Gameplay
         private Drawable chroma;
 
         [BackgroundDependencyLoader]
-        private void load(LadderInfo ladder, MatchIPCInfo ipc, Storage storage)
+        private void load(LadderInfo ladder, MatchIPCInfo ipc)
         {
             this.ipc = ipc;
 
diff --git a/osu.Game.Tournament/Screens/Ladder/Components/DrawableMatchTeam.cs b/osu.Game.Tournament/Screens/Ladder/Components/DrawableMatchTeam.cs
index bb1e4d2eff..ea453a53ca 100644
--- a/osu.Game.Tournament/Screens/Ladder/Components/DrawableMatchTeam.cs
+++ b/osu.Game.Tournament/Screens/Ladder/Components/DrawableMatchTeam.cs
@@ -81,7 +81,7 @@ namespace osu.Game.Tournament.Screens.Ladder.Components
         }
 
         [BackgroundDependencyLoader(true)]
-        private void load(OsuColour colours, LadderEditorScreen ladderEditor)
+        private void load(LadderEditorScreen ladderEditor)
         {
             this.ladderEditor = ladderEditor;
 
diff --git a/osu.Game.Tournament/Screens/Ladder/LadderScreen.cs b/osu.Game.Tournament/Screens/Ladder/LadderScreen.cs
index 534c402f6c..ad6e304c80 100644
--- a/osu.Game.Tournament/Screens/Ladder/LadderScreen.cs
+++ b/osu.Game.Tournament/Screens/Ladder/LadderScreen.cs
@@ -9,8 +9,6 @@ using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Lines;
-using osu.Framework.Platform;
-using osu.Game.Graphics;
 using osu.Game.Tournament.Components;
 using osu.Game.Tournament.Models;
 using osu.Game.Tournament.Screens.Editors;
@@ -30,7 +28,7 @@ namespace osu.Game.Tournament.Screens.Ladder
         protected Container Content;
 
         [BackgroundDependencyLoader]
-        private void load(OsuColour colours, Storage storage)
+        private void load()
         {
             normalPathColour = Color4Extensions.FromHex("#66D1FF");
             losersPathColour = Color4Extensions.FromHex("#FFC700");
diff --git a/osu.Game.Tournament/Screens/Schedule/ScheduleScreen.cs b/osu.Game.Tournament/Screens/Schedule/ScheduleScreen.cs
index e08be65465..84f38170ea 100644
--- a/osu.Game.Tournament/Screens/Schedule/ScheduleScreen.cs
+++ b/osu.Game.Tournament/Screens/Schedule/ScheduleScreen.cs
@@ -8,7 +8,6 @@ using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
-using osu.Framework.Platform;
 using osu.Game.Graphics;
 using osu.Game.Tournament.Components;
 using osu.Game.Tournament.Models;
@@ -25,7 +24,7 @@ namespace osu.Game.Tournament.Screens.Schedule
         private LadderInfo ladder;
 
         [BackgroundDependencyLoader]
-        private void load(LadderInfo ladder, Storage storage)
+        private void load(LadderInfo ladder)
         {
             this.ladder = ladder;
 
diff --git a/osu.Game.Tournament/Screens/TeamIntro/SeedingScreen.cs b/osu.Game.Tournament/Screens/TeamIntro/SeedingScreen.cs
index cd74a75b10..0003e213e7 100644
--- a/osu.Game.Tournament/Screens/TeamIntro/SeedingScreen.cs
+++ b/osu.Game.Tournament/Screens/TeamIntro/SeedingScreen.cs
@@ -8,7 +8,6 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Graphics.Textures;
-using osu.Framework.Platform;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Tournament.Components;
@@ -25,7 +24,7 @@ namespace osu.Game.Tournament.Screens.TeamIntro
         private readonly Bindable<TournamentTeam> currentTeam = new Bindable<TournamentTeam>();
 
         [BackgroundDependencyLoader]
-        private void load(Storage storage)
+        private void load()
         {
             RelativeSizeAxes = Axes.Both;
 
diff --git a/osu.Game.Tournament/Screens/TeamIntro/TeamIntroScreen.cs b/osu.Game.Tournament/Screens/TeamIntro/TeamIntroScreen.cs
index 74957cbca5..ef6f0b32ff 100644
--- a/osu.Game.Tournament/Screens/TeamIntro/TeamIntroScreen.cs
+++ b/osu.Game.Tournament/Screens/TeamIntro/TeamIntroScreen.cs
@@ -5,7 +5,6 @@ using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
-using osu.Framework.Platform;
 using osu.Game.Tournament.Components;
 using osu.Game.Tournament.Models;
 using osuTK;
@@ -17,7 +16,7 @@ namespace osu.Game.Tournament.Screens.TeamIntro
         private Container mainContainer;
 
         [BackgroundDependencyLoader]
-        private void load(Storage storage)
+        private void load()
         {
             RelativeSizeAxes = Axes.Both;
 
diff --git a/osu.Game.Tournament/Screens/TeamWin/TeamWinScreen.cs b/osu.Game.Tournament/Screens/TeamWin/TeamWinScreen.cs
index ebe2908b74..11db7bfad9 100644
--- a/osu.Game.Tournament/Screens/TeamWin/TeamWinScreen.cs
+++ b/osu.Game.Tournament/Screens/TeamWin/TeamWinScreen.cs
@@ -5,7 +5,6 @@ using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
-using osu.Framework.Platform;
 using osu.Game.Graphics;
 using osu.Game.Tournament.Components;
 using osu.Game.Tournament.Models;
@@ -23,7 +22,7 @@ namespace osu.Game.Tournament.Screens.TeamWin
         private TourneyVideo redWinVideo;
 
         [BackgroundDependencyLoader]
-        private void load(LadderInfo ladder, Storage storage)
+        private void load()
         {
             RelativeSizeAxes = Axes.Both;
 
diff --git a/osu.Game.Tournament/TournamentSceneManager.cs b/osu.Game.Tournament/TournamentSceneManager.cs
index 914d1163ad..80a9c07cde 100644
--- a/osu.Game.Tournament/TournamentSceneManager.cs
+++ b/osu.Game.Tournament/TournamentSceneManager.cs
@@ -7,11 +7,9 @@ using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
-using osu.Framework.Platform;
 using osu.Framework.Threading;
 using osu.Game.Graphics;
 using osu.Game.Tournament.Components;
-using osu.Game.Tournament.Models;
 using osu.Game.Tournament.Screens;
 using osu.Game.Tournament.Screens.Drawings;
 using osu.Game.Tournament.Screens.Editors;
@@ -52,7 +50,7 @@ namespace osu.Game.Tournament
         }
 
         [BackgroundDependencyLoader]
-        private void load(LadderInfo ladder, Storage storage)
+        private void load()
         {
             InternalChildren = new Drawable[]
             {
diff --git a/osu.Game/Collections/DrawableCollectionListItem.cs b/osu.Game/Collections/DrawableCollectionListItem.cs
index 909595bd1c..c4cb040b52 100644
--- a/osu.Game/Collections/DrawableCollectionListItem.cs
+++ b/osu.Game/Collections/DrawableCollectionListItem.cs
@@ -80,7 +80,7 @@ namespace osu.Game.Collections
             }
 
             [BackgroundDependencyLoader]
-            private void load(OsuColour colours)
+            private void load()
             {
                 Children = new Drawable[]
                 {
diff --git a/osu.Game/Graphics/Sprites/LogoAnimation.cs b/osu.Game/Graphics/Sprites/LogoAnimation.cs
index b1383065fe..36fcd39b54 100644
--- a/osu.Game/Graphics/Sprites/LogoAnimation.cs
+++ b/osu.Game/Graphics/Sprites/LogoAnimation.cs
@@ -7,14 +7,13 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.OpenGL.Vertices;
 using osu.Framework.Graphics.Shaders;
 using osu.Framework.Graphics.Sprites;
-using osu.Framework.Graphics.Textures;
 
 namespace osu.Game.Graphics.Sprites
 {
     public class LogoAnimation : Sprite
     {
         [BackgroundDependencyLoader]
-        private void load(ShaderManager shaders, TextureStore textures)
+        private void load(ShaderManager shaders)
         {
             TextureShader = shaders.Load(VertexShaderDescriptor.TEXTURE_2, @"LogoAnimation");
             RoundedTextureShader = shaders.Load(VertexShaderDescriptor.TEXTURE_2, @"LogoAnimation"); // Masking isn't supported for now
diff --git a/osu.Game/Graphics/UserInterface/DrawableOsuMenuItem.cs b/osu.Game/Graphics/UserInterface/DrawableOsuMenuItem.cs
index fea84998cf..4267b82bb7 100644
--- a/osu.Game/Graphics/UserInterface/DrawableOsuMenuItem.cs
+++ b/osu.Game/Graphics/UserInterface/DrawableOsuMenuItem.cs
@@ -2,7 +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.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
@@ -30,7 +29,7 @@ namespace osu.Game.Graphics.UserInterface
         }
 
         [BackgroundDependencyLoader]
-        private void load(AudioManager audio)
+        private void load()
         {
             BackgroundColour = Color4.Transparent;
             BackgroundColourHover = Color4Extensions.FromHex(@"172023");
diff --git a/osu.Game/Graphics/UserInterface/HoverSampleDebounceComponent.cs b/osu.Game/Graphics/UserInterface/HoverSampleDebounceComponent.cs
index 1fd03a34e7..34ab7626c9 100644
--- a/osu.Game/Graphics/UserInterface/HoverSampleDebounceComponent.cs
+++ b/osu.Game/Graphics/UserInterface/HoverSampleDebounceComponent.cs
@@ -2,7 +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.Bindables;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Input.Events;
@@ -18,7 +17,7 @@ namespace osu.Game.Graphics.UserInterface
         private Bindable<double?> lastPlaybackTime;
 
         [BackgroundDependencyLoader]
-        private void load(AudioManager audio, SessionStatics statics)
+        private void load(SessionStatics statics)
         {
             lastPlaybackTime = statics.GetBindable<double?>(Static.LastHoverSoundPlaybackTime);
         }
diff --git a/osu.Game/Graphics/UserInterface/OsuContextMenu.cs b/osu.Game/Graphics/UserInterface/OsuContextMenu.cs
index cf201b18b4..e0946fd9e1 100644
--- a/osu.Game/Graphics/UserInterface/OsuContextMenu.cs
+++ b/osu.Game/Graphics/UserInterface/OsuContextMenu.cs
@@ -3,7 +3,6 @@
 
 using osuTK.Graphics;
 using osu.Framework.Allocation;
-using osu.Framework.Audio;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Effects;
@@ -41,7 +40,7 @@ namespace osu.Game.Graphics.UserInterface
         }
 
         [BackgroundDependencyLoader]
-        private void load(OsuColour colours, AudioManager audio)
+        private void load(OsuColour colours)
         {
             BackgroundColour = colours.ContextMenuGray;
         }
diff --git a/osu.Game/Graphics/UserInterface/OsuContextMenuSamples.cs b/osu.Game/Graphics/UserInterface/OsuContextMenuSamples.cs
index d67ea499e5..921fef7951 100644
--- a/osu.Game/Graphics/UserInterface/OsuContextMenuSamples.cs
+++ b/osu.Game/Graphics/UserInterface/OsuContextMenuSamples.cs
@@ -16,7 +16,7 @@ namespace osu.Game.Graphics.UserInterface
         private Sample sampleClose;
 
         [BackgroundDependencyLoader]
-        private void load(OsuColour colours, AudioManager audio)
+        private void load(AudioManager audio)
         {
             sampleClick = audio.Samples.Get($@"UI/{HoverSampleSet.Default.GetDescription()}-select");
             sampleOpen = audio.Samples.Get(@"UI/dropdown-open");
diff --git a/osu.Game/Overlays/AccountCreation/ScreenEntry.cs b/osu.Game/Overlays/AccountCreation/ScreenEntry.cs
index a11b234cb1..a2c04c6989 100644
--- a/osu.Game/Overlays/AccountCreation/ScreenEntry.cs
+++ b/osu.Game/Overlays/AccountCreation/ScreenEntry.cs
@@ -44,7 +44,7 @@ namespace osu.Game.Overlays.AccountCreation
         private GameHost host { get; set; }
 
         [BackgroundDependencyLoader]
-        private void load(OsuColour colours)
+        private void load()
         {
             InternalChildren = new Drawable[]
             {
diff --git a/osu.Game/Overlays/AccountCreationOverlay.cs b/osu.Game/Overlays/AccountCreationOverlay.cs
index 3084c7475a..a96aff2a5d 100644
--- a/osu.Game/Overlays/AccountCreationOverlay.cs
+++ b/osu.Game/Overlays/AccountCreationOverlay.cs
@@ -10,7 +10,6 @@ using osu.Framework.Graphics.Effects;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Screens;
 using osu.Framework.Threading;
-using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Online.API;
 using osu.Game.Overlays.AccountCreation;
@@ -35,7 +34,7 @@ namespace osu.Game.Overlays
         private readonly IBindable<APIState> apiState = new Bindable<APIState>();
 
         [BackgroundDependencyLoader]
-        private void load(OsuColour colours, IAPIProvider api)
+        private void load(IAPIProvider api)
         {
             apiState.BindTo(api.State);
             apiState.BindValueChanged(apiStateChanged, true);
diff --git a/osu.Game/Overlays/Changelog/ChangelogBuild.cs b/osu.Game/Overlays/Changelog/ChangelogBuild.cs
index 2d071b7345..c65eefdee4 100644
--- a/osu.Game/Overlays/Changelog/ChangelogBuild.cs
+++ b/osu.Game/Overlays/Changelog/ChangelogBuild.cs
@@ -46,7 +46,7 @@ namespace osu.Game.Overlays.Changelog
         }
 
         [BackgroundDependencyLoader]
-        private void load(OsuColour colours, OverlayColourProvider colourProvider)
+        private void load()
         {
             foreach (var categoryEntries in Build.ChangelogEntries.GroupBy(b => b.Category).OrderBy(c => c.Key))
             {
diff --git a/osu.Game/Overlays/ChangelogOverlay.cs b/osu.Game/Overlays/ChangelogOverlay.cs
index fe611d0134..ab97ae950d 100644
--- a/osu.Game/Overlays/ChangelogOverlay.cs
+++ b/osu.Game/Overlays/ChangelogOverlay.cs
@@ -7,7 +7,6 @@ using System.Threading;
 using System.Threading.Tasks;
 using JetBrains.Annotations;
 using osu.Framework.Allocation;
-using osu.Framework.Audio;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Input.Events;
@@ -35,7 +34,7 @@ namespace osu.Game.Overlays
         }
 
         [BackgroundDependencyLoader]
-        private void load(AudioManager audio)
+        private void load()
         {
             Header.Build.BindTarget = Current;
 
diff --git a/osu.Game/Overlays/Comments/CommentsContainer.cs b/osu.Game/Overlays/Comments/CommentsContainer.cs
index 970fc5ccef..6a5734b553 100644
--- a/osu.Game/Overlays/Comments/CommentsContainer.cs
+++ b/osu.Game/Overlays/Comments/CommentsContainer.cs
@@ -317,7 +317,7 @@ namespace osu.Game.Overlays.Comments
         private class NoCommentsPlaceholder : CompositeDrawable
         {
             [BackgroundDependencyLoader]
-            private void load(OverlayColourProvider colourProvider)
+            private void load()
             {
                 Height = 80;
                 RelativeSizeAxes = Axes.X;
diff --git a/osu.Game/Overlays/Profile/Header/CentreHeaderContainer.cs b/osu.Game/Overlays/Profile/Header/CentreHeaderContainer.cs
index a13f5ed6ce..00a866f1f4 100644
--- a/osu.Game/Overlays/Profile/Header/CentreHeaderContainer.cs
+++ b/osu.Game/Overlays/Profile/Header/CentreHeaderContainer.cs
@@ -7,7 +7,6 @@ using osu.Framework.Extensions.LocalisationExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
-using osu.Framework.Graphics.Textures;
 using osu.Framework.Localisation;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays.Profile.Header.Components;
@@ -30,7 +29,7 @@ namespace osu.Game.Overlays.Profile.Header
         }
 
         [BackgroundDependencyLoader]
-        private void load(OverlayColourProvider colourProvider, TextureStore textures)
+        private void load(OverlayColourProvider colourProvider)
         {
             Container<Drawable> hiddenDetailContainer;
             Container<Drawable> expandedDetailContainer;
diff --git a/osu.Game/Overlays/Settings/Sections/DebugSettings/MemorySettings.cs b/osu.Game/Overlays/Settings/Sections/DebugSettings/MemorySettings.cs
index eb6e48dfbf..8d4fc5fc9f 100644
--- a/osu.Game/Overlays/Settings/Sections/DebugSettings/MemorySettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/DebugSettings/MemorySettings.cs
@@ -2,7 +2,6 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using osu.Framework.Allocation;
-using osu.Framework.Configuration;
 using osu.Framework.Graphics;
 using osu.Framework.Localisation;
 using osu.Framework.Platform;
@@ -16,7 +15,7 @@ namespace osu.Game.Overlays.Settings.Sections.DebugSettings
         protected override LocalisableString Header => DebugSettingsStrings.MemoryHeader;
 
         [BackgroundDependencyLoader]
-        private void load(FrameworkDebugConfigManager config, GameHost host, RealmContextFactory realmFactory)
+        private void load(GameHost host, RealmContextFactory realmFactory)
         {
             Children = new Drawable[]
             {
diff --git a/osu.Game/Overlays/Settings/SettingsFooter.cs b/osu.Game/Overlays/Settings/SettingsFooter.cs
index ed49ce2b63..263f2f4829 100644
--- a/osu.Game/Overlays/Settings/SettingsFooter.cs
+++ b/osu.Game/Overlays/Settings/SettingsFooter.cs
@@ -19,7 +19,7 @@ namespace osu.Game.Overlays.Settings
     public class SettingsFooter : FillFlowContainer
     {
         [BackgroundDependencyLoader]
-        private void load(OsuGameBase game, OsuColour colours, RulesetStore rulesets)
+        private void load(OsuGameBase game, RulesetStore rulesets)
         {
             RelativeSizeAxes = Axes.X;
             AutoSizeAxes = Axes.Y;
diff --git a/osu.Game/Overlays/Settings/SettingsSection.cs b/osu.Game/Overlays/Settings/SettingsSection.cs
index 0ae353602e..2539c32806 100644
--- a/osu.Game/Overlays/Settings/SettingsSection.cs
+++ b/osu.Game/Overlays/Settings/SettingsSection.cs
@@ -65,7 +65,7 @@ namespace osu.Game.Overlays.Settings
         }
 
         [BackgroundDependencyLoader]
-        private void load(OverlayColourProvider colourProvider, OsuColour colours)
+        private void load(OverlayColourProvider colourProvider)
         {
             AddRangeInternal(new Drawable[]
             {
diff --git a/osu.Game/Rulesets/UI/FrameStabilityContainer.cs b/osu.Game/Rulesets/UI/FrameStabilityContainer.cs
index c0b339a231..f2dbb1a23f 100644
--- a/osu.Game/Rulesets/UI/FrameStabilityContainer.cs
+++ b/osu.Game/Rulesets/UI/FrameStabilityContainer.cs
@@ -61,7 +61,7 @@ namespace osu.Game.Rulesets.UI
         private int direction = 1;
 
         [BackgroundDependencyLoader(true)]
-        private void load(GameplayClock clock, ISamplePlaybackDisabler sampleDisabler)
+        private void load(GameplayClock clock)
         {
             if (clock != null)
             {
diff --git a/osu.Game/Screens/Edit/Compose/Components/SelectionHandler.cs b/osu.Game/Screens/Edit/Compose/Components/SelectionHandler.cs
index 39de13899d..9d5d8013b7 100644
--- a/osu.Game/Screens/Edit/Compose/Components/SelectionHandler.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/SelectionHandler.cs
@@ -15,7 +15,6 @@ using osu.Framework.Input;
 using osu.Framework.Input.Bindings;
 using osu.Framework.Input.Events;
 using osu.Framework.Utils;
-using osu.Game.Graphics;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Input.Bindings;
 using osu.Game.Rulesets.Edit;
@@ -57,7 +56,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
         }
 
         [BackgroundDependencyLoader]
-        private void load(OsuColour colours)
+        private void load()
         {
             InternalChild = SelectionBox = CreateSelectionBox();
 
diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/SamplePointPiece.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/SamplePointPiece.cs
index 2cbfe88519..7d52645aa1 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/SamplePointPiece.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/SamplePointPiece.cs
@@ -15,7 +15,6 @@ using osu.Framework.Graphics.Cursor;
 using osu.Framework.Graphics.UserInterface;
 using osu.Framework.Input.Events;
 using osu.Game.Beatmaps.ControlPoints;
-using osu.Game.Graphics;
 using osu.Game.Graphics.UserInterfaceV2;
 using osu.Game.Rulesets.Objects;
 using osu.Game.Screens.Edit.Timing;
@@ -39,7 +38,7 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
         }
 
         [BackgroundDependencyLoader]
-        private void load(OsuColour colours)
+        private void load()
         {
             volume.BindValueChanged(volume => updateText());
             bank.BindValueChanged(bank => updateText(), true);
diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimingPointPiece.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimingPointPiece.cs
index fa51281c55..2df4ef001c 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimingPointPiece.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimingPointPiece.cs
@@ -4,7 +4,6 @@
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Game.Beatmaps.ControlPoints;
-using osu.Game.Graphics;
 
 namespace osu.Game.Screens.Edit.Compose.Components.Timeline
 {
@@ -19,7 +18,7 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
         }
 
         [BackgroundDependencyLoader]
-        private void load(OsuColour colours)
+        private void load()
         {
             beatLength.BindValueChanged(beatLength =>
             {
diff --git a/osu.Game/Screens/Edit/EditorRoundedScreenSettingsSection.cs b/osu.Game/Screens/Edit/EditorRoundedScreenSettingsSection.cs
index e17114ebcb..25d7dfbb4a 100644
--- a/osu.Game/Screens/Edit/EditorRoundedScreenSettingsSection.cs
+++ b/osu.Game/Screens/Edit/EditorRoundedScreenSettingsSection.cs
@@ -6,7 +6,6 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Sprites;
 using osu.Game.Graphics.Sprites;
-using osu.Game.Overlays;
 using osuTK;
 
 namespace osu.Game.Screens.Edit
@@ -20,7 +19,7 @@ namespace osu.Game.Screens.Edit
         protected FillFlowContainer Flow { get; private set; }
 
         [BackgroundDependencyLoader]
-        private void load(OverlayColourProvider colours)
+        private void load()
         {
             RelativeSizeAxes = Axes.X;
             AutoSizeAxes = Axes.Y;
diff --git a/osu.Game/Screens/Edit/Verify/VisibilitySection.cs b/osu.Game/Screens/Edit/Verify/VisibilitySection.cs
index d049436376..0bdc8c0efd 100644
--- a/osu.Game/Screens/Edit/Verify/VisibilitySection.cs
+++ b/osu.Game/Screens/Edit/Verify/VisibilitySection.cs
@@ -4,7 +4,6 @@
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
-using osu.Game.Overlays;
 using osu.Game.Overlays.Settings;
 using osu.Game.Rulesets.Edit.Checks.Components;
 
@@ -24,7 +23,7 @@ namespace osu.Game.Screens.Edit.Verify
         protected override string HeaderText => "Visibility";
 
         [BackgroundDependencyLoader]
-        private void load(OverlayColourProvider colours, VerifyScreen verify)
+        private void load(VerifyScreen verify)
         {
             hiddenIssueTypes = verify.HiddenIssueTypes.GetBoundCopy();
 
diff --git a/osu.Game/Screens/Import/FileImportScreen.cs b/osu.Game/Screens/Import/FileImportScreen.cs
index c32e230e11..09870e0bab 100644
--- a/osu.Game/Screens/Import/FileImportScreen.cs
+++ b/osu.Game/Screens/Import/FileImportScreen.cs
@@ -9,7 +9,6 @@ using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
-using osu.Framework.Platform;
 using osu.Framework.Screens;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
@@ -40,7 +39,7 @@ namespace osu.Game.Screens.Import
         private OsuColour colours { get; set; }
 
         [BackgroundDependencyLoader(true)]
-        private void load(Storage storage)
+        private void load()
         {
             InternalChild = contentContainer = new Container
             {
diff --git a/osu.Game/Screens/Menu/ButtonSystem.cs b/osu.Game/Screens/Menu/ButtonSystem.cs
index feb6f6c92a..32731407fd 100644
--- a/osu.Game/Screens/Menu/ButtonSystem.cs
+++ b/osu.Game/Screens/Menu/ButtonSystem.cs
@@ -15,7 +15,6 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Input.Bindings;
 using osu.Framework.Input.Events;
-using osu.Framework.Localisation;
 using osu.Framework.Logging;
 using osu.Framework.Platform;
 using osu.Framework.Threading;
@@ -123,7 +122,7 @@ namespace osu.Game.Screens.Menu
         private LoginOverlay loginOverlay { get; set; }
 
         [BackgroundDependencyLoader(true)]
-        private void load(AudioManager audio, IdleTracker idleTracker, GameHost host, LocalisationManager strings)
+        private void load(AudioManager audio, IdleTracker idleTracker, GameHost host)
         {
             buttonsPlay.Add(new Button(ButtonSystemStrings.Solo, @"button-solo-select", FontAwesome.Solid.User, new Color4(102, 68, 204, 255), () => OnSolo?.Invoke(), WEDGE_WIDTH, Key.P));
             buttonsPlay.Add(new Button(ButtonSystemStrings.Multi, @"button-generic-select", FontAwesome.Solid.Users, new Color4(94, 63, 186, 255), onMultiplayer, 0, Key.M));
diff --git a/osu.Game/Screens/Menu/IntroScreen.cs b/osu.Game/Screens/Menu/IntroScreen.cs
index 948e3a7d88..59bf1785d5 100644
--- a/osu.Game/Screens/Menu/IntroScreen.cs
+++ b/osu.Game/Screens/Menu/IntroScreen.cs
@@ -18,7 +18,6 @@ using osu.Game.Configuration;
 using osu.Game.IO.Archives;
 using osu.Game.Overlays;
 using osu.Game.Screens.Backgrounds;
-using osu.Game.Skinning;
 using osuTK;
 using osuTK.Graphics;
 
@@ -81,7 +80,7 @@ namespace osu.Game.Screens.Menu
         }
 
         [BackgroundDependencyLoader]
-        private void load(OsuConfigManager config, SkinManager skinManager, BeatmapManager beatmaps, Framework.Game game)
+        private void load(OsuConfigManager config, BeatmapManager beatmaps, Framework.Game game)
         {
             // prevent user from changing beatmap while the intro is still runnning.
             beatmap = Beatmap.BeginLease(false);
diff --git a/osu.Game/Screens/Menu/IntroTriangles.cs b/osu.Game/Screens/Menu/IntroTriangles.cs
index d171e481b1..10f940e9de 100644
--- a/osu.Game/Screens/Menu/IntroTriangles.cs
+++ b/osu.Game/Screens/Menu/IntroTriangles.cs
@@ -133,7 +133,7 @@ namespace osu.Game.Screens.Menu
             private OsuGameBase game { get; set; }
 
             [BackgroundDependencyLoader]
-            private void load(TextureStore textures)
+            private void load()
             {
                 InternalChildren = new Drawable[]
                 {
diff --git a/osu.Game/Screens/Menu/MainMenu.cs b/osu.Game/Screens/Menu/MainMenu.cs
index 3da740b85d..8b1bab52b3 100644
--- a/osu.Game/Screens/Menu/MainMenu.cs
+++ b/osu.Game/Screens/Menu/MainMenu.cs
@@ -71,7 +71,7 @@ namespace osu.Game.Screens.Menu
         private SongTicker songTicker;
 
         [BackgroundDependencyLoader(true)]
-        private void load(BeatmapListingOverlay beatmapListing, SettingsOverlay settings, RankingsOverlay rankings, OsuConfigManager config, SessionStatics statics)
+        private void load(BeatmapListingOverlay beatmapListing, SettingsOverlay settings, OsuConfigManager config, SessionStatics statics)
         {
             holdDelay = config.GetBindable<float>(OsuSetting.UIHoldActivationDelay);
             loginDisplayed = statics.GetBindable<bool>(Static.LoginOverlayDisplayed);
diff --git a/osu.Game/Screens/OsuScreen.cs b/osu.Game/Screens/OsuScreen.cs
index ccc891d3bf..ed4901e1fa 100644
--- a/osu.Game/Screens/OsuScreen.cs
+++ b/osu.Game/Screens/OsuScreen.cs
@@ -145,7 +145,7 @@ namespace osu.Game.Screens
         }
 
         [BackgroundDependencyLoader(true)]
-        private void load(OsuGame osu, AudioManager audio)
+        private void load(AudioManager audio)
         {
             sampleExit = audio.Samples.Get(@"UI/screen-back");
         }
diff --git a/osu.Game/Screens/Play/EpilepsyWarning.cs b/osu.Game/Screens/Play/EpilepsyWarning.cs
index 89e25d849f..ccb2870d78 100644
--- a/osu.Game/Screens/Play/EpilepsyWarning.cs
+++ b/osu.Game/Screens/Play/EpilepsyWarning.cs
@@ -2,11 +2,9 @@
 // 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.Sprites;
-using osu.Game.Beatmaps;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Screens.Backgrounds;
@@ -39,7 +37,7 @@ namespace osu.Game.Screens.Play
         }
 
         [BackgroundDependencyLoader]
-        private void load(OsuColour colours, IBindable<WorkingBeatmap> beatmap)
+        private void load(OsuColour colours)
         {
             Children = new Drawable[]
             {
diff --git a/osu.Game/Screens/Play/HUD/HoldForMenuButton.cs b/osu.Game/Screens/Play/HUD/HoldForMenuButton.cs
index 8e0a38aa1f..5a7ef786d3 100644
--- a/osu.Game/Screens/Play/HUD/HoldForMenuButton.cs
+++ b/osu.Game/Screens/Play/HUD/HoldForMenuButton.cs
@@ -116,7 +116,7 @@ namespace osu.Game.Screens.Play.HUD
             public Action HoverLost;
 
             [BackgroundDependencyLoader]
-            private void load(OsuColour colours, Framework.Game game)
+            private void load(OsuColour colours)
             {
                 Size = new Vector2(60);
 
diff --git a/osu.Game/Screens/Play/HUD/UnstableRateCounter.cs b/osu.Game/Screens/Play/HUD/UnstableRateCounter.cs
index 235f0f01fd..a71b661965 100644
--- a/osu.Game/Screens/Play/HUD/UnstableRateCounter.cs
+++ b/osu.Game/Screens/Play/HUD/UnstableRateCounter.cs
@@ -8,7 +8,6 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Localisation;
-using osu.Game.Beatmaps;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.UserInterface;
@@ -37,7 +36,7 @@ namespace osu.Game.Screens.Play.HUD
         }
 
         [BackgroundDependencyLoader]
-        private void load(OsuColour colours, BeatmapDifficultyCache difficultyCache)
+        private void load(OsuColour colours)
         {
             Colour = colours.BlueLighter;
             valid.BindValueChanged(e =>
diff --git a/osu.Game/Screens/Ranking/Expanded/Accuracy/AccuracyCircle.cs b/osu.Game/Screens/Ranking/Expanded/Accuracy/AccuracyCircle.cs
index 635be60549..e50520e0ca 100644
--- a/osu.Game/Screens/Ranking/Expanded/Accuracy/AccuracyCircle.cs
+++ b/osu.Game/Screens/Ranking/Expanded/Accuracy/AccuracyCircle.cs
@@ -10,7 +10,6 @@ using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Colour;
 using osu.Framework.Graphics.Containers;
-using osu.Framework.Platform;
 using osu.Framework.Utils;
 using osu.Game.Audio;
 using osu.Game.Graphics;
@@ -104,7 +103,7 @@ namespace osu.Game.Screens.Ranking.Expanded.Accuracy
         }
 
         [BackgroundDependencyLoader]
-        private void load(GameHost host)
+        private void load()
         {
             InternalChildren = new Drawable[]
             {
diff --git a/osu.Game/Screens/Select/BeatmapDetailAreaTabControl.cs b/osu.Game/Screens/Select/BeatmapDetailAreaTabControl.cs
index df8c68a0dd..0fd39db97c 100644
--- a/osu.Game/Screens/Select/BeatmapDetailAreaTabControl.cs
+++ b/osu.Game/Screens/Select/BeatmapDetailAreaTabControl.cs
@@ -9,7 +9,6 @@ using osu.Framework.Bindables;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
-using osu.Game.Configuration;
 using osu.Game.Graphics;
 using osu.Game.Graphics.UserInterface;
 using osu.Framework.Graphics.Shapes;
@@ -83,7 +82,7 @@ namespace osu.Game.Screens.Select
         }
 
         [BackgroundDependencyLoader]
-        private void load(OsuColour colour, OsuConfigManager config)
+        private void load(OsuColour colour)
         {
             modsCheckbox.AccentColour = tabs.AccentColour = colour.YellowLight;
         }
diff --git a/osu.Game/Tests/Visual/SkinnableTestScene.cs b/osu.Game/Tests/Visual/SkinnableTestScene.cs
index 22aac79056..a080f47d66 100644
--- a/osu.Game/Tests/Visual/SkinnableTestScene.cs
+++ b/osu.Game/Tests/Visual/SkinnableTestScene.cs
@@ -41,7 +41,7 @@ namespace osu.Game.Tests.Visual
         }
 
         [BackgroundDependencyLoader]
-        private void load(AudioManager audio, SkinManager skinManager)
+        private void load()
         {
             var dllStore = new DllResourceStore(DynamicCompilationOriginal.GetType().Assembly);
 
diff --git a/osu.Game/Users/Drawables/ClickableAvatar.cs b/osu.Game/Users/Drawables/ClickableAvatar.cs
index 2825c41ef6..e3cfaf1d14 100644
--- a/osu.Game/Users/Drawables/ClickableAvatar.cs
+++ b/osu.Game/Users/Drawables/ClickableAvatar.cs
@@ -4,7 +4,6 @@
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
-using osu.Framework.Graphics.Textures;
 using osu.Framework.Input.Events;
 using osu.Framework.Localisation;
 using osu.Game.Graphics.Containers;
@@ -58,7 +57,7 @@ namespace osu.Game.Users.Drawables
         }
 
         [BackgroundDependencyLoader]
-        private void load(LargeTextureStore textures)
+        private void load()
         {
             LoadComponentAsync(new DrawableAvatar(user), clickableArea.Add);
         }

From 11580a2e716f9ac153b493e8acb21b6719e189e8 Mon Sep 17 00:00:00 2001
From: Susko3 <16479013+Susko3@users.noreply.github.com>
Date: Sat, 15 Jan 2022 01:24:59 +0100
Subject: [PATCH 2214/5547] Update rider .idea files for `osu.sln`

---
 .idea/.idea.osu/.idea/misc.xml                   | 6 ++++++
 .idea/.idea.osu/.idea/modules.xml                | 8 --------
 .idea/.idea.osu/.idea/projectSettingsUpdater.xml | 2 +-
 3 files changed, 7 insertions(+), 9 deletions(-)
 create mode 100644 .idea/.idea.osu/.idea/misc.xml
 delete mode 100644 .idea/.idea.osu/.idea/modules.xml

diff --git a/.idea/.idea.osu/.idea/misc.xml b/.idea/.idea.osu/.idea/misc.xml
new file mode 100644
index 0000000000..1d8c84d0af
--- /dev/null
+++ b/.idea/.idea.osu/.idea/misc.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="com.jetbrains.rider.android.RiderAndroidMiscFileCreationComponent">
+    <option name="ENSURE_MISC_FILE_EXISTS" value="true" />
+  </component>
+</project>
\ No newline at end of file
diff --git a/.idea/.idea.osu/.idea/modules.xml b/.idea/.idea.osu/.idea/modules.xml
deleted file mode 100644
index 0360fdbc5e..0000000000
--- a/.idea/.idea.osu/.idea/modules.xml
+++ /dev/null
@@ -1,8 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="ProjectModuleManager">
-    <modules>
-      <module fileurl="file://$PROJECT_DIR$/.idea/.idea.osu/riderModule.iml" filepath="$PROJECT_DIR$/.idea/.idea.osu/riderModule.iml" />
-    </modules>
-  </component>
-</project>
\ No newline at end of file
diff --git a/.idea/.idea.osu/.idea/projectSettingsUpdater.xml b/.idea/.idea.osu/.idea/projectSettingsUpdater.xml
index 7515e76054..4bb9f4d2a0 100644
--- a/.idea/.idea.osu/.idea/projectSettingsUpdater.xml
+++ b/.idea/.idea.osu/.idea/projectSettingsUpdater.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <project version="4">
   <component name="RiderProjectSettingsUpdater">
-    <option name="vcsConfiguration" value="1" />
+    <option name="vcsConfiguration" value="2" />
   </component>
 </project>
\ No newline at end of file

From 9e173f7fcd7f0861432ad56632d28e2aa494309e Mon Sep 17 00:00:00 2001
From: Susko3 <16479013+Susko3@users.noreply.github.com>
Date: Sat, 15 Jan 2022 01:28:11 +0100
Subject: [PATCH 2215/5547] Update rider .idea files for Android .slnf

---
 .idea/.idea.osu.Android/.idea/.name                      | 1 +
 .idea/.idea.osu.Android/.idea/indexLayout.xml            | 8 ++++++++
 .idea/.idea.osu.Android/.idea/misc.xml                   | 6 ++++++
 .idea/.idea.osu.Android/.idea/projectSettingsUpdater.xml | 6 ++++++
 4 files changed, 21 insertions(+)
 create mode 100644 .idea/.idea.osu.Android/.idea/.name
 create mode 100644 .idea/.idea.osu.Android/.idea/indexLayout.xml
 create mode 100644 .idea/.idea.osu.Android/.idea/misc.xml
 create mode 100644 .idea/.idea.osu.Android/.idea/projectSettingsUpdater.xml

diff --git a/.idea/.idea.osu.Android/.idea/.name b/.idea/.idea.osu.Android/.idea/.name
new file mode 100644
index 0000000000..86363b495c
--- /dev/null
+++ b/.idea/.idea.osu.Android/.idea/.name
@@ -0,0 +1 @@
+osu.Android
\ No newline at end of file
diff --git a/.idea/.idea.osu.Android/.idea/indexLayout.xml b/.idea/.idea.osu.Android/.idea/indexLayout.xml
new file mode 100644
index 0000000000..7b08163ceb
--- /dev/null
+++ b/.idea/.idea.osu.Android/.idea/indexLayout.xml
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="UserContentModel">
+    <attachedFolders />
+    <explicitIncludes />
+    <explicitExcludes />
+  </component>
+</project>
\ No newline at end of file
diff --git a/.idea/.idea.osu.Android/.idea/misc.xml b/.idea/.idea.osu.Android/.idea/misc.xml
new file mode 100644
index 0000000000..1d8c84d0af
--- /dev/null
+++ b/.idea/.idea.osu.Android/.idea/misc.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="com.jetbrains.rider.android.RiderAndroidMiscFileCreationComponent">
+    <option name="ENSURE_MISC_FILE_EXISTS" value="true" />
+  </component>
+</project>
\ No newline at end of file
diff --git a/.idea/.idea.osu.Android/.idea/projectSettingsUpdater.xml b/.idea/.idea.osu.Android/.idea/projectSettingsUpdater.xml
new file mode 100644
index 0000000000..4bb9f4d2a0
--- /dev/null
+++ b/.idea/.idea.osu.Android/.idea/projectSettingsUpdater.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="RiderProjectSettingsUpdater">
+    <option name="vcsConfiguration" value="2" />
+  </component>
+</project>
\ No newline at end of file

From bc64fd20786c5af87c3c9a4fdb0198664a224912 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sat, 15 Jan 2022 08:01:42 +0300
Subject: [PATCH 2216/5547] Add missing `vcs.xml` file to the android solution

Present in both `.idea.osu` and `.idea.osu.Desktop`.
---
 .idea/.idea.osu.Android/.idea/vcs.xml | 6 ++++++
 1 file changed, 6 insertions(+)
 create mode 100644 .idea/.idea.osu.Android/.idea/vcs.xml

diff --git a/.idea/.idea.osu.Android/.idea/vcs.xml b/.idea/.idea.osu.Android/.idea/vcs.xml
new file mode 100644
index 0000000000..94a25f7f4c
--- /dev/null
+++ b/.idea/.idea.osu.Android/.idea/vcs.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="VcsDirectoryMappings">
+    <mapping directory="$PROJECT_DIR$" vcs="Git" />
+  </component>
+</project>
\ No newline at end of file

From 64c499d9d6e6169e7f3984994288ddd9f759d6eb Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 15 Jan 2022 15:24:30 +0900
Subject: [PATCH 2217/5547] Revert unintended temporary commenting (was used
 during benchmarking)

---
 .../Components/Timelines/Summary/Parts/ControlPointPart.cs   | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/ControlPointPart.cs b/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/ControlPointPart.cs
index f6a7353e13..2dab3b0e59 100644
--- a/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/ControlPointPart.cs
+++ b/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/ControlPointPart.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.Specialized;
 using System.Linq;
 using osu.Framework.Bindables;
@@ -35,8 +36,8 @@ namespace osu.Game.Screens.Edit.Components.Timelines.Summary.Parts
                             // as an optimisation, don't add a visualisation if there are already groups with the same types in close proximity.
                             // for newly added control points (ie. lazer editor first where group is added empty) we always skip for simplicity.
                             // that is fine, because cases where this is causing a performance issue are mostly where external tools were used to create an insane number of points.
-                            // if (Children.Any(g => Math.Abs(g.Group.Time - group.Time) < 1000 && g.IsRedundant(group)))
-                            //     continue;
+                            if (Children.Any(g => Math.Abs(g.Group.Time - group.Time) < 1000 && g.IsRedundant(group)))
+                                continue;
 
                             Add(new GroupVisualisation(group));
                         }

From c4976e9db83fccd34534515523a77eb9168f6fa1 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 15 Jan 2022 20:08:08 +0900
Subject: [PATCH 2218/5547] Update resources

---
 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 4198cf2bf4..b2e3b32916 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -51,7 +51,7 @@
     <Reference Include="Java.Interop" />
   </ItemGroup>
   <ItemGroup>
-    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.114.0" />
+    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.115.0" />
     <PackageReference Include="ppy.osu.Framework.Android" Version="2022.111.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 2609f17c73..2e5c9f4548 100644
--- a/osu.Game/osu.Game.csproj
+++ b/osu.Game/osu.Game.csproj
@@ -37,7 +37,7 @@
     </PackageReference>
     <PackageReference Include="Realm" Version="10.7.1" />
     <PackageReference Include="ppy.osu.Framework" Version="2022.111.0" />
-    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.114.0" />
+    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.115.0" />
     <PackageReference Include="Sentry" Version="3.12.1" />
     <PackageReference Include="SharpCompress" Version="0.30.1" />
     <PackageReference Include="NUnit" Version="3.13.2" />
diff --git a/osu.iOS.props b/osu.iOS.props
index 0064a597fd..897be33c18 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -61,7 +61,7 @@
   </ItemGroup>
   <ItemGroup Label="Package References">
     <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.111.0" />
-    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.114.0" />
+    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.115.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net5.0 / net6.0) -->
   <PropertyGroup>

From 3ab13dd78c8330ade055a674725f9d3a5c04494c Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sat, 15 Jan 2022 14:24:52 +0300
Subject: [PATCH 2219/5547] Assign position to spinner ticks for correct
 positional playback

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

diff --git a/osu.Game.Rulesets.Osu/Objects/Spinner.cs b/osu.Game.Rulesets.Osu/Objects/Spinner.cs
index 0ad8e4ea68..1eddfb7fef 100644
--- a/osu.Game.Rulesets.Osu/Objects/Spinner.cs
+++ b/osu.Game.Rulesets.Osu/Objects/Spinner.cs
@@ -65,8 +65,8 @@ namespace osu.Game.Rulesets.Osu.Objects
                 double startTime = StartTime + (float)(i + 1) / totalSpins * Duration;
 
                 AddNested(i < SpinsRequired
-                    ? new SpinnerTick { StartTime = startTime }
-                    : new SpinnerBonusTick { StartTime = startTime });
+                    ? new SpinnerTick { StartTime = startTime, Position = Position }
+                    : new SpinnerBonusTick { StartTime = startTime, Position = Position });
             }
         }
 

From ea8e49c543ab5e516d2f41ff9de6185f7760c0f0 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 15 Jan 2022 21:19:02 +0900
Subject: [PATCH 2220/5547] Reorder private/protected methods

---
 .../Multiplayer/MultiplayerRoomSounds.cs          | 15 ++++++++-------
 1 file changed, 8 insertions(+), 7 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerRoomSounds.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerRoomSounds.cs
index 42e3716e5a..e673bbcc8c 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerRoomSounds.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerRoomSounds.cs
@@ -28,13 +28,6 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
             Host.ValueChanged += hostChanged;
         }
 
-        private void hostChanged(ValueChangedEvent<APIUser> value)
-        {
-            if (value.OldValue == null) return;
-
-            hostChangedSample?.Play();
-        }
-
         protected override void UserJoined(MultiplayerRoomUser user)
         {
             base.UserJoined(user);
@@ -56,6 +49,14 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
             userKickedSample?.Play();
         }
 
+        private void hostChanged(ValueChangedEvent<APIUser> value)
+        {
+            // only play sound when the host changes from an already-existing host.
+            if (value.OldValue == null) return;
+
+            hostChangedSample?.Play();
+        }
+
         protected override void Dispose(bool isDisposing)
         {
             base.Dispose(isDisposing);

From 671a3d47b8a131e97ebfd5800c3194667a0f956e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 15 Jan 2022 21:20:27 +0900
Subject: [PATCH 2221/5547] Move bindable binding to `LoadComplete` and remove
 unnecessary unbind

---
 .../Multiplayer/MultiplayerRoomSounds.cs           | 14 ++++++--------
 1 file changed, 6 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerRoomSounds.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerRoomSounds.cs
index e673bbcc8c..d467a32acb 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerRoomSounds.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerRoomSounds.cs
@@ -24,8 +24,13 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
             userJoinedSample = audio.Samples.Get(@"Multiplayer/player-joined");
             userLeftSample = audio.Samples.Get(@"Multiplayer/player-left");
             userKickedSample = audio.Samples.Get(@"Multiplayer/player-kicked");
+        }
 
-            Host.ValueChanged += hostChanged;
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            Host.BindValueChanged(hostChanged);
         }
 
         protected override void UserJoined(MultiplayerRoomUser user)
@@ -56,12 +61,5 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
 
             hostChangedSample?.Play();
         }
-
-        protected override void Dispose(bool isDisposing)
-        {
-            base.Dispose(isDisposing);
-
-            Host.ValueChanged -= hostChanged;
-        }
     }
 }

From e75d21507c238ff6a6f5b374a301a7ccbe1f7a9d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 15 Jan 2022 15:26:41 +0100
Subject: [PATCH 2222/5547] Fix `GetDisplayTitleRomanisable()` relying on
 `ToString()` implementation

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

diff --git a/osu.Game/Beatmaps/BeatmapMetadataInfoExtensions.cs b/osu.Game/Beatmaps/BeatmapMetadataInfoExtensions.cs
index 7aab6a7a9b..7e7d1babf0 100644
--- a/osu.Game/Beatmaps/BeatmapMetadataInfoExtensions.cs
+++ b/osu.Game/Beatmaps/BeatmapMetadataInfoExtensions.cs
@@ -40,7 +40,7 @@ namespace osu.Game.Beatmaps
         /// </summary>
         public static RomanisableString GetDisplayTitleRomanisable(this IBeatmapMetadataInfo metadataInfo, bool includeCreator = true)
         {
-            string author = !includeCreator || string.IsNullOrEmpty(metadataInfo.Author.Username) ? string.Empty : $"({metadataInfo.Author})";
+            string author = !includeCreator || string.IsNullOrEmpty(metadataInfo.Author.Username) ? string.Empty : $"({metadataInfo.Author.Username})";
             string artistUnicode = string.IsNullOrEmpty(metadataInfo.ArtistUnicode) ? metadataInfo.Artist : metadataInfo.ArtistUnicode;
             string titleUnicode = string.IsNullOrEmpty(metadataInfo.TitleUnicode) ? metadataInfo.Title : metadataInfo.TitleUnicode;
 

From c5cae4e3eebe1e6695c47e47d1e7f87d09646727 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 15 Jan 2022 23:55:11 +0900
Subject: [PATCH 2223/5547] Rename methods and add xmldoc

---
 .../Components/Timelines/Summary/Parts/ControlPointPart.cs  | 2 +-
 .../Timelines/Summary/Parts/ControlPointVisualisation.cs    | 2 +-
 .../Timelines/Summary/Parts/EffectPointVisualisation.cs     | 2 +-
 .../Timelines/Summary/Parts/GroupVisualisation.cs           | 6 ++----
 .../Summary/Parts/IControlPointVisualisationRedundant.cs    | 5 ++++-
 5 files changed, 9 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/ControlPointPart.cs b/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/ControlPointPart.cs
index 2dab3b0e59..b72ff18434 100644
--- a/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/ControlPointPart.cs
+++ b/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/ControlPointPart.cs
@@ -36,7 +36,7 @@ namespace osu.Game.Screens.Edit.Components.Timelines.Summary.Parts
                             // as an optimisation, don't add a visualisation if there are already groups with the same types in close proximity.
                             // for newly added control points (ie. lazer editor first where group is added empty) we always skip for simplicity.
                             // that is fine, because cases where this is causing a performance issue are mostly where external tools were used to create an insane number of points.
-                            if (Children.Any(g => Math.Abs(g.Group.Time - group.Time) < 1000 && g.IsRedundant(group)))
+                            if (Children.Any(g => Math.Abs(g.Group.Time - group.Time) < 1000 && g.IsVisuallyRedundant(group)))
                                 continue;
 
                             Add(new GroupVisualisation(group));
diff --git a/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/ControlPointVisualisation.cs b/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/ControlPointVisualisation.cs
index 96fce1dac5..aaa3838be5 100644
--- a/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/ControlPointVisualisation.cs
+++ b/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/ControlPointVisualisation.cs
@@ -27,6 +27,6 @@ namespace osu.Game.Screens.Edit.Components.Timelines.Summary.Parts
             Colour = Point.GetRepresentingColour(colours);
         }
 
-        public bool IsRedundant(ControlPoint other) => other.GetType() == Point.GetType();
+        public bool IsVisuallyRedundant(ControlPoint other) => other.GetType() == Point.GetType();
     }
 }
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 c08ab3728f..b4f048f29b 100644
--- a/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/EffectPointVisualisation.cs
+++ b/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/EffectPointVisualisation.cs
@@ -70,6 +70,6 @@ namespace osu.Game.Screens.Edit.Components.Timelines.Summary.Parts
         }
 
         // kiai sections display duration, so are required to be visualised.
-        public bool IsRedundant(ControlPoint other) => (other as EffectControlPoint)?.KiaiMode == effect.KiaiMode;
+        public bool IsVisuallyRedundant(ControlPoint other) => (other as EffectControlPoint)?.KiaiMode == effect.KiaiMode;
     }
 }
diff --git a/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/GroupVisualisation.cs b/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/GroupVisualisation.cs
index b55df66a02..fc39f83e6a 100644
--- a/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/GroupVisualisation.cs
+++ b/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/GroupVisualisation.cs
@@ -61,9 +61,7 @@ namespace osu.Game.Screens.Edit.Components.Timelines.Summary.Parts
         /// <summary>
         /// For display purposes, check whether the proposed group is made redundant by this visualisation group.
         /// </summary>
-        /// <param name="other"></param>
-        /// <returns></returns>
-        public bool IsRedundant(ControlPointGroup other) =>
-            other.ControlPoints.Any(c => InternalChildren.OfType<IControlPointVisualisationRedundant>().Any(c2 => c2.IsRedundant(c)));
+        public bool IsVisuallyRedundant(ControlPointGroup other) =>
+            other.ControlPoints.Any(c => InternalChildren.OfType<IControlPointVisualisationRedundant>().Any(c2 => c2.IsVisuallyRedundant(c)));
     }
 }
diff --git a/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/IControlPointVisualisationRedundant.cs b/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/IControlPointVisualisationRedundant.cs
index e4d47e4cdc..fc4facdd47 100644
--- a/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/IControlPointVisualisationRedundant.cs
+++ b/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/IControlPointVisualisationRedundant.cs
@@ -7,6 +7,9 @@ namespace osu.Game.Screens.Edit.Components.Timelines.Summary.Parts
 {
     public interface IControlPointVisualisationRedundant
     {
-        bool IsRedundant(ControlPoint other);
+        /// <summary>
+        /// For display purposes, check whether the proposed point is made redundant by this visualisation.
+        /// </summary>
+        bool IsVisuallyRedundant(ControlPoint other);
     }
 }

From 236fa6da7e4187a4112f39a26817d40801a7fc64 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 15 Jan 2022 23:56:00 +0900
Subject: [PATCH 2224/5547] Rename `ControlPointVisualisation` interface type
 to be less specific

---
 .../Timelines/Summary/Parts/ControlPointVisualisation.cs        | 2 +-
 .../Timelines/Summary/Parts/EffectPointVisualisation.cs         | 2 +-
 .../Components/Timelines/Summary/Parts/GroupVisualisation.cs    | 2 +-
 ...tVisualisationRedundant.cs => IControlPointVisualisation.cs} | 2 +-
 4 files changed, 4 insertions(+), 4 deletions(-)
 rename osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/{IControlPointVisualisationRedundant.cs => IControlPointVisualisation.cs} (89%)

diff --git a/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/ControlPointVisualisation.cs b/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/ControlPointVisualisation.cs
index aaa3838be5..41716f9c23 100644
--- a/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/ControlPointVisualisation.cs
+++ b/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/ControlPointVisualisation.cs
@@ -9,7 +9,7 @@ using osu.Game.Screens.Edit.Components.Timelines.Summary.Visualisations;
 
 namespace osu.Game.Screens.Edit.Components.Timelines.Summary.Parts
 {
-    public class ControlPointVisualisation : PointVisualisation, IControlPointVisualisationRedundant
+    public class ControlPointVisualisation : PointVisualisation, IControlPointVisualisation
     {
         protected readonly ControlPoint Point;
 
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 b4f048f29b..4db65c4250 100644
--- a/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/EffectPointVisualisation.cs
+++ b/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/EffectPointVisualisation.cs
@@ -13,7 +13,7 @@ using osu.Game.Screens.Edit.Components.Timelines.Summary.Visualisations;
 
 namespace osu.Game.Screens.Edit.Components.Timelines.Summary.Parts
 {
-    public class EffectPointVisualisation : CompositeDrawable, IControlPointVisualisationRedundant
+    public class EffectPointVisualisation : CompositeDrawable, IControlPointVisualisation
     {
         private readonly EffectControlPoint effect;
         private Bindable<bool> kiai;
diff --git a/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/GroupVisualisation.cs b/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/GroupVisualisation.cs
index fc39f83e6a..83759bbc2b 100644
--- a/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/GroupVisualisation.cs
+++ b/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/GroupVisualisation.cs
@@ -62,6 +62,6 @@ namespace osu.Game.Screens.Edit.Components.Timelines.Summary.Parts
         /// For display purposes, check whether the proposed group is made redundant by this visualisation group.
         /// </summary>
         public bool IsVisuallyRedundant(ControlPointGroup other) =>
-            other.ControlPoints.Any(c => InternalChildren.OfType<IControlPointVisualisationRedundant>().Any(c2 => c2.IsVisuallyRedundant(c)));
+            other.ControlPoints.Any(c => InternalChildren.OfType<IControlPointVisualisation>().Any(c2 => c2.IsVisuallyRedundant(c)));
     }
 }
diff --git a/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/IControlPointVisualisationRedundant.cs b/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/IControlPointVisualisation.cs
similarity index 89%
rename from osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/IControlPointVisualisationRedundant.cs
rename to osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/IControlPointVisualisation.cs
index fc4facdd47..c81f1828f7 100644
--- a/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/IControlPointVisualisationRedundant.cs
+++ b/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/IControlPointVisualisation.cs
@@ -5,7 +5,7 @@ using osu.Game.Beatmaps.ControlPoints;
 
 namespace osu.Game.Screens.Edit.Components.Timelines.Summary.Parts
 {
-    public interface IControlPointVisualisationRedundant
+    public interface IControlPointVisualisation
     {
         /// <summary>
         /// For display purposes, check whether the proposed point is made redundant by this visualisation.

From 565611ee00c16a86a2f9640682a346154431dc26 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 15 Jan 2022 23:57:20 +0900
Subject: [PATCH 2225/5547] Fix typo in inline comment

---
 .../Edit/Components/Timelines/Summary/Parts/ControlPointPart.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/ControlPointPart.cs b/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/ControlPointPart.cs
index b72ff18434..a33bb73681 100644
--- a/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/ControlPointPart.cs
+++ b/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/ControlPointPart.cs
@@ -57,7 +57,7 @@ namespace osu.Game.Screens.Edit.Components.Timelines.Summary.Parts
                                 // to guarantee an accurate representation.
                                 //
                                 // note that the case where control point (type) is added or removed from a non-displayed group is not handled correctly.
-                                // this is an edge case which shouldn't affect the user too badly. we may flatted control point groups in the future
+                                // this is an edge case which shouldn't affect the user too badly. we may flatten control point groups in the future
                                 // which would allow this to be handled better.
                                 Clear();
                                 foreach (var g in controlPointGroups)

From 6e4214de4d945bb17459d4708f303f018d87a623 Mon Sep 17 00:00:00 2001
From: Susko3 <16479013+Susko3@users.noreply.github.com>
Date: Sat, 15 Jan 2022 19:42:38 +0100
Subject: [PATCH 2226/5547] Move `VersionManager` from `osu.Desktop` to
 `osu.Game`

---
 osu.Desktop/OsuGameDesktop.cs                 | 27 -------------------
 osu.Game/OsuGame.cs                           | 11 ++++++++
 .../Overlays/VersionManager.cs                |  3 +--
 3 files changed, 12 insertions(+), 29 deletions(-)
 rename {osu.Desktop => osu.Game}/Overlays/VersionManager.cs (98%)

diff --git a/osu.Desktop/OsuGameDesktop.cs b/osu.Desktop/OsuGameDesktop.cs
index b234207848..cd3fb7eb61 100644
--- a/osu.Desktop/OsuGameDesktop.cs
+++ b/osu.Desktop/OsuGameDesktop.cs
@@ -10,14 +10,11 @@ using System.Runtime.Versioning;
 using System.Threading.Tasks;
 using Microsoft.Win32;
 using osu.Desktop.Security;
-using osu.Desktop.Overlays;
 using osu.Framework.Platform;
 using osu.Game;
 using osu.Desktop.Updater;
 using osu.Framework;
 using osu.Framework.Logging;
-using osu.Framework.Screens;
-using osu.Game.Screens.Menu;
 using osu.Game.Updater;
 using osu.Desktop.Windows;
 using osu.Framework.Threading;
@@ -27,13 +24,9 @@ namespace osu.Desktop
 {
     internal class OsuGameDesktop : OsuGame
     {
-        private readonly bool noVersionOverlay;
-        private VersionManager versionManager;
-
         public OsuGameDesktop(string[] args = null)
             : base(args)
         {
-            noVersionOverlay = args?.Any(a => a == "--no-version-overlay") ?? false;
         }
 
         public override StableStorage GetStorageForStableInstall()
@@ -114,9 +107,6 @@ namespace osu.Desktop
         {
             base.LoadComplete();
 
-            if (!noVersionOverlay)
-                LoadComponentAsync(versionManager = new VersionManager { Depth = int.MinValue }, ScreenContainer.Add);
-
             LoadComponentAsync(new DiscordRichPresence(), Add);
 
             if (RuntimeInfo.OS == RuntimeInfo.Platform.Windows)
@@ -125,23 +115,6 @@ namespace osu.Desktop
             LoadComponentAsync(new ElevatedPrivilegesChecker(), Add);
         }
 
-        protected override void ScreenChanged(IScreen lastScreen, IScreen newScreen)
-        {
-            base.ScreenChanged(lastScreen, newScreen);
-
-            switch (newScreen)
-            {
-                case IntroScreen _:
-                case MainMenu _:
-                    versionManager?.Show();
-                    break;
-
-                default:
-                    versionManager?.Hide();
-                    break;
-            }
-        }
-
         public override void SetHost(GameHost host)
         {
             base.SetHost(host);
diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index 21d84a365b..90af80e702 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -154,6 +154,8 @@ namespace osu.Game
 
         private MainMenu menuScreen;
 
+        private VersionManager versionManager;
+
         [CanBeNull]
         private IntroScreen introScreen;
 
@@ -803,6 +805,9 @@ namespace osu.Game
             loadComponentSingleFile(wikiOverlay = new WikiOverlay(), overlayContent.Add, true);
             loadComponentSingleFile(skinEditor = new SkinEditorOverlay(ScreenContainer), overlayContent.Add, true);
 
+            if (!args?.Any(a => a == @"--no-version-overlay") ?? true)
+                loadComponentSingleFile(versionManager = new VersionManager { Depth = int.MinValue }, ScreenContainer.Add);
+
             loadComponentSingleFile(new LoginOverlay
             {
                 Anchor = Anchor.TopRight,
@@ -1126,10 +1131,16 @@ namespace osu.Game
             {
                 case IntroScreen intro:
                     introScreen = intro;
+                    versionManager?.Show();
                     break;
 
                 case MainMenu menu:
                     menuScreen = menu;
+                    versionManager?.Show();
+                    break;
+
+                default:
+                    versionManager?.Hide();
                     break;
             }
 
diff --git a/osu.Desktop/Overlays/VersionManager.cs b/osu.Game/Overlays/VersionManager.cs
similarity index 98%
rename from osu.Desktop/Overlays/VersionManager.cs
rename to osu.Game/Overlays/VersionManager.cs
index e4a3451651..fe6613fba2 100644
--- a/osu.Desktop/Overlays/VersionManager.cs
+++ b/osu.Game/Overlays/VersionManager.cs
@@ -7,13 +7,12 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Graphics.Textures;
-using osu.Game;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
 using osuTK;
 using osuTK.Graphics;
 
-namespace osu.Desktop.Overlays
+namespace osu.Game.Overlays
 {
     public class VersionManager : VisibilityContainer
     {

From 2a59735525abb6d481fadc044808f497ace7f2a4 Mon Sep 17 00:00:00 2001
From: mk-56 <darioheadleysilva@gmail.com>
Date: Sat, 15 Jan 2022 21:43:28 +0100
Subject: [PATCH 2227/5547] Initial commit

---
 .../Mods/CatchModFlashlight.cs                | 21 +++-------
 .../Mods/ManiaModFlashlight.cs                | 13 ++++--
 .../Mods/OsuModFlashlight.cs                  | 42 ++++++++++---------
 .../Mods/TaikoModFlashlight.cs                | 20 ++++-----
 osu.Game/Rulesets/Mods/ModFlashlight.cs       | 42 +++++++++++++++++++
 5 files changed, 89 insertions(+), 49 deletions(-)

diff --git a/osu.Game.Rulesets.Catch/Mods/CatchModFlashlight.cs b/osu.Game.Rulesets.Catch/Mods/CatchModFlashlight.cs
index f399f48ebd..e5da168dc6 100644
--- a/osu.Game.Rulesets.Catch/Mods/CatchModFlashlight.cs
+++ b/osu.Game.Rulesets.Catch/Mods/CatchModFlashlight.cs
@@ -15,9 +15,10 @@ namespace osu.Game.Rulesets.Catch.Mods
     {
         public override double ScoreMultiplier => 1.12;
 
-        private const float default_flashlight_size = 350;
+        public override bool DefaultComboDependency => true;
+        public override float DefaultRadius => 350;
 
-        public override Flashlight CreateFlashlight() => new CatchFlashlight(playfield);
+        public override Flashlight CreateFlashlight() => new CatchFlashlight(playfield, ChangeRadius.Value, InitialRadius.Value);
 
         private CatchPlayfield playfield;
 
@@ -31,10 +32,10 @@ namespace osu.Game.Rulesets.Catch.Mods
         {
             private readonly CatchPlayfield playfield;
 
-            public CatchFlashlight(CatchPlayfield playfield)
+            public CatchFlashlight(CatchPlayfield playfield, bool isRadiusBasedOnCombo, float initialRadius) : base(isRadiusBasedOnCombo, initialRadius)
             {
                 this.playfield = playfield;
-                FlashlightSize = new Vector2(0, getSizeFor(0));
+                FlashlightSize = new Vector2(0, GetRadiusFor(0));
             }
 
             protected override void Update()
@@ -44,19 +45,9 @@ namespace osu.Game.Rulesets.Catch.Mods
                 FlashlightPosition = playfield.CatcherArea.ToSpaceOfOtherDrawable(playfield.Catcher.DrawPosition, this);
             }
 
-            private float getSizeFor(int combo)
-            {
-                if (combo > 200)
-                    return default_flashlight_size * 0.8f;
-                else if (combo > 100)
-                    return default_flashlight_size * 0.9f;
-                else
-                    return default_flashlight_size;
-            }
-
             protected override void OnComboChange(ValueChangedEvent<int> e)
             {
-                this.TransformTo(nameof(FlashlightSize), new Vector2(0, getSizeFor(e.NewValue)), FLASHLIGHT_FADE_DURATION);
+                this.TransformTo(nameof(FlashlightSize), new Vector2(0, GetRadiusFor(e.NewValue)), FLASHLIGHT_FADE_DURATION);
             }
 
             protected override string FragmentShader => "CircularFlashlight";
diff --git a/osu.Game.Rulesets.Mania/Mods/ManiaModFlashlight.cs b/osu.Game.Rulesets.Mania/Mods/ManiaModFlashlight.cs
index 86a00271e9..676b5f3842 100644
--- a/osu.Game.Rulesets.Mania/Mods/ManiaModFlashlight.cs
+++ b/osu.Game.Rulesets.Mania/Mods/ManiaModFlashlight.cs
@@ -16,17 +16,19 @@ namespace osu.Game.Rulesets.Mania.Mods
         public override double ScoreMultiplier => 1;
         public override Type[] IncompatibleMods => new[] { typeof(ModHidden) };
 
-        private const float default_flashlight_size = 180;
+        public override bool DefaultComboDependency => false;
+        public override float DefaultRadius => 180;
 
-        public override Flashlight CreateFlashlight() => new ManiaFlashlight();
+        public override Flashlight CreateFlashlight() => new ManiaFlashlight(ChangeRadius.Value, InitialRadius.Value);
 
         private class ManiaFlashlight : Flashlight
         {
             private readonly LayoutValue flashlightProperties = new LayoutValue(Invalidation.DrawSize);
 
-            public ManiaFlashlight()
+            public ManiaFlashlight(bool isRadiusBasedOnCombo, float initialRadius)
+                : base(isRadiusBasedOnCombo, initialRadius)
             {
-                FlashlightSize = new Vector2(0, default_flashlight_size);
+                FlashlightSize = new Vector2(DrawWidth, GetRadiusFor(0));
 
                 AddLayout(flashlightProperties);
             }
@@ -46,9 +48,12 @@ namespace osu.Game.Rulesets.Mania.Mods
 
             protected override void OnComboChange(ValueChangedEvent<int> e)
             {
+                this.TransformTo(nameof(FlashlightSize), new Vector2(DrawWidth, GetRadiusFor(e.NewValue)), FLASHLIGHT_FADE_DURATION);
             }
 
             protected override string FragmentShader => "RectangularFlashlight";
         }
     }
 }
+
+
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModFlashlight.cs b/osu.Game.Rulesets.Osu/Mods/OsuModFlashlight.cs
index 300a9d48aa..f15527460c 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModFlashlight.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModFlashlight.cs
@@ -12,7 +12,6 @@ using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Objects.Drawables;
 using osu.Game.Rulesets.Osu.Objects;
 using osu.Game.Rulesets.Osu.Objects.Drawables;
-using osu.Game.Rulesets.UI;
 using osuTK;
 
 namespace osu.Game.Rulesets.Osu.Mods
@@ -21,13 +20,16 @@ namespace osu.Game.Rulesets.Osu.Mods
     {
         public override double ScoreMultiplier => 1.12;
 
-        private const float default_flashlight_size = 180;
+        public override bool DefaultComboDependency => true;
+
+        //private const float default_flashlight_size = 180;
+        public override float DefaultRadius => 180;
 
         private const double default_follow_delay = 120;
 
         private OsuFlashlight flashlight;
 
-        public override Flashlight CreateFlashlight() => flashlight = new OsuFlashlight();
+        public override Flashlight CreateFlashlight() => flashlight = new OsuFlashlight(ChangeRadius.Value, InitialRadius.Value, FollowDelay.Value);
 
         public void ApplyToDrawableHitObject(DrawableHitObject drawable)
         {
@@ -35,13 +37,6 @@ namespace osu.Game.Rulesets.Osu.Mods
                 s.Tracking.ValueChanged += flashlight.OnSliderTrackingChange;
         }
 
-        public override void ApplyToDrawableRuleset(DrawableRuleset<OsuHitObject> drawableRuleset)
-        {
-            base.ApplyToDrawableRuleset(drawableRuleset);
-
-            flashlight.FollowDelay = FollowDelay.Value;
-        }
-
         [SettingSource("Follow delay", "Milliseconds until the flashlight reaches the cursor")]
         public BindableNumber<double> FollowDelay { get; } = new BindableDouble(default_follow_delay)
         {
@@ -54,9 +49,15 @@ namespace osu.Game.Rulesets.Osu.Mods
         {
             public double FollowDelay { private get; set; }
 
-            public OsuFlashlight()
+            //public float InitialRadius { private get; set; }
+            public bool ChangeRadius { private get; set; }
+
+            public OsuFlashlight(bool isRadiusBasedOnCombo, float initialRadius, double followDelay)
+                : base(isRadiusBasedOnCombo, initialRadius)
             {
-                FlashlightSize = new Vector2(0, getSizeFor(0));
+                FollowDelay = followDelay;
+
+                FlashlightSize = new Vector2(0, GetRadiusFor(0));
             }
 
             public void OnSliderTrackingChange(ValueChangedEvent<bool> e)
@@ -78,17 +79,20 @@ namespace osu.Game.Rulesets.Osu.Mods
 
             private float getSizeFor(int combo)
             {
-                if (combo > 200)
-                    return default_flashlight_size * 0.8f;
-                else if (combo > 100)
-                    return default_flashlight_size * 0.9f;
-                else
-                    return default_flashlight_size;
+                if (ChangeRadius)
+                {
+                    if (combo > 200)
+                        return InitialRadius * 0.8f;
+                    else if (combo > 100)
+                        return InitialRadius * 0.9f;
+                }
+
+                return InitialRadius;
             }
 
             protected override void OnComboChange(ValueChangedEvent<int> e)
             {
-                this.TransformTo(nameof(FlashlightSize), new Vector2(0, getSizeFor(e.NewValue)), FLASHLIGHT_FADE_DURATION);
+                this.TransformTo(nameof(FlashlightSize), new Vector2(0, GetRadiusFor(e.NewValue)), FLASHLIGHT_FADE_DURATION);
             }
 
             protected override string FragmentShader => "CircularFlashlight";
diff --git a/osu.Game.Rulesets.Taiko/Mods/TaikoModFlashlight.cs b/osu.Game.Rulesets.Taiko/Mods/TaikoModFlashlight.cs
index 0a325f174e..29f29863c0 100644
--- a/osu.Game.Rulesets.Taiko/Mods/TaikoModFlashlight.cs
+++ b/osu.Game.Rulesets.Taiko/Mods/TaikoModFlashlight.cs
@@ -16,9 +16,12 @@ namespace osu.Game.Rulesets.Taiko.Mods
     {
         public override double ScoreMultiplier => 1.12;
 
-        private const float default_flashlight_size = 250;
+        public override bool DefaultComboDependency => true;
 
-        public override Flashlight CreateFlashlight() => new TaikoFlashlight(playfield);
+        //private const float default_flashlight_size = 250;
+        public override float DefaultRadius => 250;
+
+        public override Flashlight CreateFlashlight() => new TaikoFlashlight(playfield, ChangeRadius.Value, InitialRadius.Value);
 
         private TaikoPlayfield playfield;
 
@@ -33,7 +36,8 @@ namespace osu.Game.Rulesets.Taiko.Mods
             private readonly LayoutValue flashlightProperties = new LayoutValue(Invalidation.DrawSize);
             private readonly TaikoPlayfield taikoPlayfield;
 
-            public TaikoFlashlight(TaikoPlayfield taikoPlayfield)
+            public TaikoFlashlight(TaikoPlayfield taikoPlayfield, bool isRadiusBasedOnCombo, float initialRadius)
+                : base(isRadiusBasedOnCombo, initialRadius)
             {
                 this.taikoPlayfield = taikoPlayfield;
                 FlashlightSize = getSizeFor(0);
@@ -43,15 +47,9 @@ namespace osu.Game.Rulesets.Taiko.Mods
 
             private Vector2 getSizeFor(int combo)
             {
-                float size = default_flashlight_size;
-
-                if (combo > 200)
-                    size *= 0.8f;
-                else if (combo > 100)
-                    size *= 0.9f;
-
                 // Preserve flashlight size through the playfield's aspect adjustment.
-                return new Vector2(0, size * taikoPlayfield.DrawHeight / TaikoPlayfield.DEFAULT_HEIGHT);
+                // return new Vector2(0, size * taikoPlayfield.DrawHeight / TaikoPlayfield.DEFAULT_HEIGHT);
+                return new Vector2(0, GetRadiusFor(combo) * taikoPlayfield.DrawHeight / TaikoPlayfield.DEFAULT_HEIGHT);
             }
 
             protected override void OnComboChange(ValueChangedEvent<int> e)
diff --git a/osu.Game/Rulesets/Mods/ModFlashlight.cs b/osu.Game/Rulesets/Mods/ModFlashlight.cs
index a77a83b36c..bff0e2f12d 100644
--- a/osu.Game/Rulesets/Mods/ModFlashlight.cs
+++ b/osu.Game/Rulesets/Mods/ModFlashlight.cs
@@ -13,6 +13,7 @@ using osu.Framework.Graphics.Shaders;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Graphics.Textures;
 using osu.Game.Beatmaps.Timing;
+using osu.Game.Configuration;
 using osu.Game.Graphics;
 using osu.Game.Graphics.OpenGL.Vertices;
 using osu.Game.Rulesets.Objects;
@@ -32,8 +33,26 @@ namespace osu.Game.Rulesets.Mods
         public override ModType Type => ModType.DifficultyIncrease;
         public override string Description => "Restricted view area.";
 
+        [SettingSource("Change radius based on combo", "Decrease the flashlight radius as combo increases.")]
+        public Bindable<bool> ChangeRadius { get; private set; }
+
+        [SettingSource("Initial radius", "Initial radius of the flashlight area.")]
+        public BindableNumber<float> InitialRadius { get; private set; }
+
+        public abstract float DefaultRadius { get; }
+
+        public abstract bool DefaultComboDependency { get; }
+
         internal ModFlashlight()
         {
+            InitialRadius = new BindableFloat
+            {
+                MinValue = 90f,
+                MaxValue = 250f,
+                Precision = 5f,
+            };
+
+            ChangeRadius = new BindableBool(DefaultComboDependency);
         }
     }
 
@@ -93,6 +112,16 @@ namespace osu.Game.Rulesets.Mods
 
             public List<BreakPeriod> Breaks;
 
+            public readonly bool IsRadiusBasedOnCombo;
+
+            public readonly float InitialRadius;
+
+            protected Flashlight(bool isRadiusBasedOnCombo, float initialRadius)
+            {
+                IsRadiusBasedOnCombo = isRadiusBasedOnCombo;
+                InitialRadius = initialRadius;
+            }
+
             [BackgroundDependencyLoader]
             private void load(ShaderManager shaderManager)
             {
@@ -124,6 +153,19 @@ namespace osu.Game.Rulesets.Mods
 
             protected abstract string FragmentShader { get; }
 
+            protected float GetRadiusFor(int combo)
+            {
+                if (IsRadiusBasedOnCombo)
+                {
+                    if (combo > 200)
+                        return InitialRadius * 0.8f;
+                    else if (combo > 100)
+                        return InitialRadius * 0.9f;
+                }
+
+                return InitialRadius;
+            }
+
             private Vector2 flashlightPosition;
 
             protected Vector2 FlashlightPosition

From 566d341b1e526184693cb80cc9113d80894ba8ba Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 16 Jan 2022 22:04:29 +0900
Subject: [PATCH 2228/5547] Split conditions out for readability

---
 .../Timelines/Summary/Parts/EffectPointVisualisation.cs         | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

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 4db65c4250..7c14152b3d 100644
--- a/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/EffectPointVisualisation.cs
+++ b/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/EffectPointVisualisation.cs
@@ -70,6 +70,6 @@ namespace osu.Game.Screens.Edit.Components.Timelines.Summary.Parts
         }
 
         // kiai sections display duration, so are required to be visualised.
-        public bool IsVisuallyRedundant(ControlPoint other) => (other as EffectControlPoint)?.KiaiMode == effect.KiaiMode;
+        public bool IsVisuallyRedundant(ControlPoint other) => other is EffectControlPoint otherEffect && effect.KiaiMode == otherEffect.KiaiMode;
     }
 }

From 57cc2f78933fb89c3226c7ab28bc1a3fe6c0e8da Mon Sep 17 00:00:00 2001
From: mk-56 <darioheadleysilva@gmail.com>
Date: Sun, 16 Jan 2022 14:26:26 +0100
Subject: [PATCH 2229/5547] Adjustment to size values of FL per mode

---
 osu.Game.Rulesets.Catch/Mods/CatchModFlashlight.cs | 3 ++-
 osu.Game/Rulesets/Mods/ModFlashlight.cs            | 6 +++---
 2 files changed, 5 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Rulesets.Catch/Mods/CatchModFlashlight.cs b/osu.Game.Rulesets.Catch/Mods/CatchModFlashlight.cs
index e5da168dc6..9d9fa5aed4 100644
--- a/osu.Game.Rulesets.Catch/Mods/CatchModFlashlight.cs
+++ b/osu.Game.Rulesets.Catch/Mods/CatchModFlashlight.cs
@@ -32,7 +32,8 @@ namespace osu.Game.Rulesets.Catch.Mods
         {
             private readonly CatchPlayfield playfield;
 
-            public CatchFlashlight(CatchPlayfield playfield, bool isRadiusBasedOnCombo, float initialRadius) : base(isRadiusBasedOnCombo, initialRadius)
+            public CatchFlashlight(CatchPlayfield playfield, bool isRadiusBasedOnCombo, float initialRadius)
+                : base(isRadiusBasedOnCombo, initialRadius)
             {
                 this.playfield = playfield;
                 FlashlightSize = new Vector2(0, GetRadiusFor(0));
diff --git a/osu.Game/Rulesets/Mods/ModFlashlight.cs b/osu.Game/Rulesets/Mods/ModFlashlight.cs
index bff0e2f12d..c218ab45fe 100644
--- a/osu.Game/Rulesets/Mods/ModFlashlight.cs
+++ b/osu.Game/Rulesets/Mods/ModFlashlight.cs
@@ -45,10 +45,10 @@ namespace osu.Game.Rulesets.Mods
 
         internal ModFlashlight()
         {
-            InitialRadius = new BindableFloat
+            InitialRadius = new BindableFloat(DefaultRadius)
             {
-                MinValue = 90f,
-                MaxValue = 250f,
+                MinValue = DefaultRadius * .5f,
+                MaxValue = DefaultRadius * 1.5f,
                 Precision = 5f,
             };
 

From 084b1fb4704b2bd2f7b30b60f766d507e3778594 Mon Sep 17 00:00:00 2001
From: Susko3 <16479013+Susko3@users.noreply.github.com>
Date: Sun, 16 Jan 2022 15:20:22 +0100
Subject: [PATCH 2230/5547] Load the VersionManager earlier

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

diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index 90af80e702..6730f2cf65 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -745,6 +745,9 @@ namespace osu.Game
             ScreenStack.ScreenPushed += screenPushed;
             ScreenStack.ScreenExited += screenExited;
 
+            if (!args?.Any(a => a == @"--no-version-overlay") ?? true)
+                loadComponentSingleFile(versionManager = new VersionManager { Depth = int.MinValue }, ScreenContainer.Add);
+
             loadComponentSingleFile(osuLogo, logo =>
             {
                 logoContainer.Add(logo);
@@ -805,9 +808,6 @@ namespace osu.Game
             loadComponentSingleFile(wikiOverlay = new WikiOverlay(), overlayContent.Add, true);
             loadComponentSingleFile(skinEditor = new SkinEditorOverlay(ScreenContainer), overlayContent.Add, true);
 
-            if (!args?.Any(a => a == @"--no-version-overlay") ?? true)
-                loadComponentSingleFile(versionManager = new VersionManager { Depth = int.MinValue }, ScreenContainer.Add);
-
             loadComponentSingleFile(new LoginOverlay
             {
                 Anchor = Anchor.TopRight,

From 632246a3b31eed8c7a52378268a9b814c69a00e7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 16 Jan 2022 17:04:59 +0100
Subject: [PATCH 2231/5547] Add failing test scene

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

diff --git a/osu.Game.Rulesets.Taiko.Tests/TestSceneDrumRollJudgements.cs b/osu.Game.Rulesets.Taiko.Tests/TestSceneDrumRollJudgements.cs
new file mode 100644
index 0000000000..fc4fd286f4
--- /dev/null
+++ b/osu.Game.Rulesets.Taiko.Tests/TestSceneDrumRollJudgements.cs
@@ -0,0 +1,36 @@
+// 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.Taiko.Objects;
+
+namespace osu.Game.Rulesets.Taiko.Tests
+{
+    public class TestSceneDrumRollJudgements : TestSceneTaikoPlayer
+    {
+        [Test]
+        public void TestStrongDrumRollFullyJudgedOnKilled()
+        {
+            AddUntilStep("gameplay finished", () => Player.ScoreProcessor.HasCompleted.Value);
+            AddAssert("all judgements are misses", () => Player.Results.All(r => r.Type == r.Judgement.MinResult));
+        }
+
+        protected override bool Autoplay => false;
+
+        protected override IBeatmap CreateBeatmap(RulesetInfo ruleset) => new Beatmap<TaikoHitObject>()
+        {
+            BeatmapInfo = { Ruleset = new TaikoRuleset().RulesetInfo },
+            HitObjects =
+            {
+                new DrumRoll
+                {
+                    StartTime = 1000,
+                    Duration = 1000,
+                    IsStrong = true
+                }
+            }
+        };
+    }
+}

From c6adbdd46f105071c344f48aa8ab997a6a8cad2d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 16 Jan 2022 17:15:01 +0100
Subject: [PATCH 2232/5547] Fix drum rolls nested objects not applying min
 result on kill

---
 .../Objects/Drawables/DrawableDrumRoll.cs       |  8 ++++++++
 .../Objects/Drawables/DrawableDrumRollTick.cs   | 17 +++++++++++++++++
 2 files changed, 25 insertions(+)

diff --git a/osu.Game.Rulesets.Taiko/Objects/Drawables/DrawableDrumRoll.cs b/osu.Game.Rulesets.Taiko/Objects/Drawables/DrawableDrumRoll.cs
index 521189d36c..b84db513f7 100644
--- a/osu.Game.Rulesets.Taiko/Objects/Drawables/DrawableDrumRoll.cs
+++ b/osu.Game.Rulesets.Taiko/Objects/Drawables/DrawableDrumRoll.cs
@@ -197,6 +197,14 @@ namespace osu.Game.Rulesets.Taiko.Objects.Drawables
                 ApplyResult(r => r.Type = ParentHitObject.IsHit ? r.Judgement.MaxResult : r.Judgement.MinResult);
             }
 
+            public override void OnKilled()
+            {
+                base.OnKilled();
+
+                if (Time.Current > ParentHitObject.HitObject.GetEndTime() && !Judged)
+                    ApplyResult(r => r.Type = r.Judgement.MinResult);
+            }
+
             public override bool OnPressed(KeyBindingPressEvent<TaikoAction> e) => false;
         }
     }
diff --git a/osu.Game.Rulesets.Taiko/Objects/Drawables/DrawableDrumRollTick.cs b/osu.Game.Rulesets.Taiko/Objects/Drawables/DrawableDrumRollTick.cs
index dc2ed200a1..e24923e482 100644
--- a/osu.Game.Rulesets.Taiko/Objects/Drawables/DrawableDrumRollTick.cs
+++ b/osu.Game.Rulesets.Taiko/Objects/Drawables/DrawableDrumRollTick.cs
@@ -5,6 +5,7 @@ using System;
 using JetBrains.Annotations;
 using osu.Framework.Graphics;
 using osu.Framework.Input.Events;
+using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Objects.Drawables;
 using osu.Game.Rulesets.Taiko.Skinning.Default;
 using osu.Game.Skinning;
@@ -52,6 +53,14 @@ namespace osu.Game.Rulesets.Taiko.Objects.Drawables
             ApplyResult(r => r.Type = r.Judgement.MaxResult);
         }
 
+        public override void OnKilled()
+        {
+            base.OnKilled();
+
+            if (Time.Current > HitObject.GetEndTime() && !Judged)
+                ApplyResult(r => r.Type = r.Judgement.MinResult);
+        }
+
         protected override void UpdateHitStateTransforms(ArmedState state)
         {
             switch (state)
@@ -92,6 +101,14 @@ namespace osu.Game.Rulesets.Taiko.Objects.Drawables
                 ApplyResult(r => r.Type = ParentHitObject.IsHit ? r.Judgement.MaxResult : r.Judgement.MinResult);
             }
 
+            public override void OnKilled()
+            {
+                base.OnKilled();
+
+                if (Time.Current > ParentHitObject.HitObject.GetEndTime() && !Judged)
+                    ApplyResult(r => r.Type = r.Judgement.MinResult);
+            }
+
             public override bool OnPressed(KeyBindingPressEvent<TaikoAction> e) => false;
         }
     }

From 093b76e0ff59662353cd04ee865ccd54f5ba755d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 16 Jan 2022 18:56:21 +0100
Subject: [PATCH 2233/5547] Fix drawable mania judgement scene looking broken

---
 .../Skinning/TestSceneDrawableJudgement.cs    | 29 +++++++++++++------
 1 file changed, 20 insertions(+), 9 deletions(-)

diff --git a/osu.Game.Rulesets.Mania.Tests/Skinning/TestSceneDrawableJudgement.cs b/osu.Game.Rulesets.Mania.Tests/Skinning/TestSceneDrawableJudgement.cs
index 75a5495078..d033676ec7 100644
--- a/osu.Game.Rulesets.Mania.Tests/Skinning/TestSceneDrawableJudgement.cs
+++ b/osu.Game.Rulesets.Mania.Tests/Skinning/TestSceneDrawableJudgement.cs
@@ -5,8 +5,10 @@ using System;
 using System.Linq;
 using osu.Framework.Extensions;
 using osu.Framework.Graphics;
+using osu.Framework.Testing;
 using osu.Game.Rulesets.Judgements;
 using osu.Game.Rulesets.Mania.Scoring;
+using osu.Game.Rulesets.Mania.Skinning.Legacy;
 using osu.Game.Rulesets.Mania.UI;
 using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Scoring;
@@ -23,15 +25,24 @@ namespace osu.Game.Rulesets.Mania.Tests.Skinning
             {
                 if (hitWindows.IsHitResultAllowed(result))
                 {
-                    AddStep("Show " + result.GetDescription(), () => SetContents(_ =>
-                        new DrawableManiaJudgement(new JudgementResult(new HitObject { StartTime = Time.Current }, new Judgement())
-                        {
-                            Type = result
-                        }, null)
-                        {
-                            Anchor = Anchor.Centre,
-                            Origin = Anchor.Centre,
-                        }));
+                    AddStep("Show " + result.GetDescription(), () =>
+                    {
+                        SetContents(_ =>
+                            new DrawableManiaJudgement(new JudgementResult(new HitObject { StartTime = Time.Current }, new Judgement())
+                            {
+                                Type = result
+                            }, null)
+                            {
+                                Anchor = Anchor.Centre,
+                                Origin = Anchor.Centre,
+                            });
+
+                        // for test purposes, undo the Y adjustment related to the `ScorePosition` legacy positioning config value
+                        // (see `LegacyManiaJudgementPiece.load()`).
+                        // this prevents the judgements showing somewhere below or above the bounding box of the judgement.
+                        foreach (var legacyPiece in this.ChildrenOfType<LegacyManiaJudgementPiece>())
+                            legacyPiece.Y = 0;
+                    });
                 }
             }
         }

From 8e5ff201a139e90fb37703b642a1042bb7ff3353 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 16 Jan 2022 18:59:26 +0100
Subject: [PATCH 2234/5547] Modify mania special skin to demonstrate failure
 case

---
 .../Resources/special-skin/skin.ini               | 15 +++++++++------
 1 file changed, 9 insertions(+), 6 deletions(-)

diff --git a/osu.Game.Rulesets.Mania.Tests/Resources/special-skin/skin.ini b/osu.Game.Rulesets.Mania.Tests/Resources/special-skin/skin.ini
index 36765d61bf..9c987efc60 100644
--- a/osu.Game.Rulesets.Mania.Tests/Resources/special-skin/skin.ini
+++ b/osu.Game.Rulesets.Mania.Tests/Resources/special-skin/skin.ini
@@ -4,11 +4,14 @@ Version: 2.5
 [Mania]
 Keys: 4
 ColumnLineWidth: 3,1,3,1,1
-Hit0: mania/hit0
-Hit50: mania/hit50
-Hit100: mania/hit100
-Hit200: mania/hit200
-Hit300: mania/hit300
-Hit300g: mania/hit300g
+// some skins found in the wild had configuration keys where the @2x suffix was included in the values.
+// the expected compatibility behaviour is that the presence of the @2x suffix shouldn't change anything
+// if @2x assets are present.
+Hit0: mania/hit0@2x
+Hit50: mania/hit50@2x
+Hit100: mania/hit100@2x
+Hit200: mania/hit200@2x
+Hit300: mania/hit300@2x
+Hit300g: mania/hit300g@2x
 StageLeft: mania/stage-left
 StageRight: mania/stage-right
\ No newline at end of file

From cbaa3de548736c6bfbc1f08c527f5ebceb3c7b32 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 16 Jan 2022 19:44:04 +0100
Subject: [PATCH 2235/5547] Strip `@2x` scale modifiers when looking up legacy
 skin textures

---
 osu.Game/Skinning/LegacySkin.cs | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Skinning/LegacySkin.cs b/osu.Game/Skinning/LegacySkin.cs
index e677e2c01b..e64011941f 100644
--- a/osu.Game/Skinning/LegacySkin.cs
+++ b/osu.Game/Skinning/LegacySkin.cs
@@ -474,13 +474,18 @@ namespace osu.Game.Skinning
         {
             foreach (string name in getFallbackNames(componentName))
             {
+                // some component names (especially user-controlled ones, like `HitX` in mania)
+                // may contain `@2x` scale specifications.
+                // stable happens to check for that and strip them, so do the same to match stable behaviour.
+                string lookupName = name.Replace(@"@2x", string.Empty);
+
                 float ratio = 2;
-                var texture = Textures?.Get($"{name}@2x", wrapModeS, wrapModeT);
+                var texture = Textures?.Get(@$"{lookupName}@2x", wrapModeS, wrapModeT);
 
                 if (texture == null)
                 {
                     ratio = 1;
-                    texture = Textures?.Get(name, wrapModeS, wrapModeT);
+                    texture = Textures?.Get(lookupName, wrapModeS, wrapModeT);
                 }
 
                 if (texture == null)

From 88bf406c225c3a074f2d9756b815338f42910bd9 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 17 Jan 2022 12:56:43 +0900
Subject: [PATCH 2236/5547] Fix null reference in equality comparison causing
 beatmap set overlay to crash

---
 .../Overlays/BeatmapSet/Scores/TopScoreStatisticsSection.cs     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/BeatmapSet/Scores/TopScoreStatisticsSection.cs b/osu.Game/Overlays/BeatmapSet/Scores/TopScoreStatisticsSection.cs
index d659df21c6..1f3f73a60a 100644
--- a/osu.Game/Overlays/BeatmapSet/Scores/TopScoreStatisticsSection.cs
+++ b/osu.Game/Overlays/BeatmapSet/Scores/TopScoreStatisticsSection.cs
@@ -107,7 +107,7 @@ namespace osu.Game.Overlays.BeatmapSet.Scores
         {
             set
             {
-                if (score.Equals(value))
+                if (score?.Equals(value) == true)
                     return;
 
                 score = value;

From a3806f44a51adb35ad97299aa2250d1138b6ce18 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 17 Jan 2022 13:11:43 +0900
Subject: [PATCH 2237/5547] Add back `null` beatmap allowance to
 `GetTotalScore` flow to fix playlist aggregate scores

---
 osu.Game/Scoring/ScoreManager.cs | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Scoring/ScoreManager.cs b/osu.Game/Scoring/ScoreManager.cs
index ad2be7d813..dc90e819d4 100644
--- a/osu.Game/Scoring/ScoreManager.cs
+++ b/osu.Game/Scoring/ScoreManager.cs
@@ -132,9 +132,10 @@ namespace osu.Game.Scoring
         /// <returns>The total score.</returns>
         public async Task<long> GetTotalScoreAsync([NotNull] ScoreInfo score, ScoringMode mode = ScoringMode.Standardised, CancellationToken cancellationToken = default)
         {
-            // TODO: ??
-            // if (score.Beatmap == null)
-            //     return score.TotalScore;
+            // TODO: This is required for playlist aggregate scores. They should likely not be getting here in the first place.
+            // ReSharper disable once ConditionIsAlwaysTrueOrFalse
+            if (score.BeatmapInfo == null)
+                return score.TotalScore;
 
             int beatmapMaxCombo;
             double accuracy = score.Accuracy;

From d27ee2c9fb62348c0bf24f52f7dd4b5608670080 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 17 Jan 2022 13:37:42 +0900
Subject: [PATCH 2238/5547] Remove incorrect `IsManaged` check in
 `ScoreManager`

---
 osu.Game/Scoring/ScoreManager.cs | 5 +----
 1 file changed, 1 insertion(+), 4 deletions(-)

diff --git a/osu.Game/Scoring/ScoreManager.cs b/osu.Game/Scoring/ScoreManager.cs
index dc90e819d4..52180d7ff2 100644
--- a/osu.Game/Scoring/ScoreManager.cs
+++ b/osu.Game/Scoring/ScoreManager.cs
@@ -159,11 +159,8 @@ namespace osu.Game.Scoring
                     beatmapMaxCombo = score.BeatmapInfo.MaxCombo.Value;
                 else
                 {
-                    if (!score.BeatmapInfo.IsManaged || difficulties == null)
-                    {
-                        // We don't have enough information (max combo) to compute the score, so use the provided score.
+                    if (difficulties == null)
                         return score.TotalScore;
-                    }
 
                     // We can compute the max combo locally after the async beatmap difficulty computation.
                     var difficulty = await difficulties().GetDifficultyAsync(score.BeatmapInfo, score.Ruleset, score.Mods, cancellationToken).ConfigureAwait(false);

From 11ca1b6e7b042f0fdf3c6c4d4691a19fe9d0ae84 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 17 Jan 2022 13:40:27 +0900
Subject: [PATCH 2239/5547] Remove one more usage of `IsManaged` which could
 potentially go wrong

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

diff --git a/osu.Game/Screens/Select/BeatmapCarousel.cs b/osu.Game/Screens/Select/BeatmapCarousel.cs
index 13ece08144..dc67a4eb45 100644
--- a/osu.Game/Screens/Select/BeatmapCarousel.cs
+++ b/osu.Game/Screens/Select/BeatmapCarousel.cs
@@ -117,7 +117,7 @@ namespace osu.Game.Screens.Select
             newRoot.AddChildren(beatmapSets.Select(createCarouselSet).Where(g => g != null));
 
             root = newRoot;
-            if (selectedBeatmapSet != null && (!selectedBeatmapSet.BeatmapSet.IsManaged || !beatmapSets.Contains(selectedBeatmapSet.BeatmapSet)))
+            if (selectedBeatmapSet != null && !beatmapSets.Contains(selectedBeatmapSet.BeatmapSet))
                 selectedBeatmapSet = null;
 
             Scroll.Clear(false);

From 744084b41870cb5238263dab0a10743d241034a9 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 17 Jan 2022 13:51:30 +0900
Subject: [PATCH 2240/5547] Initialise all parameters is paramaterless
 constructor for now for added safety

---
 osu.Game/Beatmaps/BeatmapInfo.cs |  9 +++++---
 osu.Game/Scoring/ScoreInfo.cs    | 39 +++++++++++++++++---------------
 2 files changed, 27 insertions(+), 21 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapInfo.cs b/osu.Game/Beatmaps/BeatmapInfo.cs
index b9dd59cfe4..e14e945865 100644
--- a/osu.Game/Beatmaps/BeatmapInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapInfo.cs
@@ -31,11 +31,11 @@ namespace osu.Game.Beatmaps
 
         public string DifficultyName { get; set; } = string.Empty;
 
-        public RulesetInfo Ruleset { get; set; } = null!;
+        public RulesetInfo Ruleset { get; set; }
 
-        public BeatmapDifficulty Difficulty { get; set; } = new BeatmapDifficulty();
+        public BeatmapDifficulty Difficulty { get; set; }
 
-        public BeatmapMetadata Metadata { get; set; } = new BeatmapMetadata();
+        public BeatmapMetadata Metadata { get; set; }
 
         [IgnoreMap]
         [Backlink(nameof(ScoreInfo.BeatmapInfo))]
@@ -51,6 +51,9 @@ namespace osu.Game.Beatmaps
         [UsedImplicitly]
         public BeatmapInfo() // TODO: consider removing this and migrating all usages to ctor with parameters.
         {
+            Ruleset = new RulesetInfo();
+            Difficulty = new BeatmapDifficulty();
+            Metadata = new BeatmapMetadata();
         }
 
         public BeatmapSetInfo? BeatmapSet { get; set; }
diff --git a/osu.Game/Scoring/ScoreInfo.cs b/osu.Game/Scoring/ScoreInfo.cs
index b168726283..fd0f14266a 100644
--- a/osu.Game/Scoring/ScoreInfo.cs
+++ b/osu.Game/Scoring/ScoreInfo.cs
@@ -32,19 +32,33 @@ namespace osu.Game.Scoring
         [PrimaryKey]
         public Guid ID { get; set; } = Guid.NewGuid();
 
+        public BeatmapInfo BeatmapInfo { get; set; }
+
+        public RulesetInfo Ruleset { get; set; }
+
         public IList<RealmNamedFileUsage> Files { get; } = null!;
 
         public string Hash { get; set; } = string.Empty;
 
         public bool DeletePending { get; set; }
 
-        public bool Equals(ScoreInfo other) => other.ID == ID;
+        public long TotalScore { get; set; }
+
+        public int MaxCombo { get; set; }
+
+        public double Accuracy { get; set; }
+
+        public bool HasReplay { get; set; }
+
+        public DateTimeOffset Date { get; set; }
+
+        public double? PP { get; set; }
 
         [Indexed]
         public long OnlineID { get; set; } = -1;
 
         [MapTo("User")]
-        public RealmUser RealmUser { get; set; } = new RealmUser();
+        public RealmUser RealmUser { get; set; }
 
         [MapTo("Mods")]
         public string ModsJson { get; set; } = string.Empty;
@@ -62,6 +76,9 @@ namespace osu.Game.Scoring
         [UsedImplicitly]
         public ScoreInfo() // TODO: consider removing this and migrating all usages to ctor with parameters.
         {
+            Ruleset = new RulesetInfo();
+            RealmUser = new RealmUser();
+            BeatmapInfo = new BeatmapInfo();
         }
 
         // TODO: this is a bit temporary to account for the fact that this class is used to ferry API user data to certain UI components.
@@ -88,22 +105,6 @@ namespace osu.Game.Scoring
             }
         }
 
-        public long TotalScore { get; set; }
-
-        public int MaxCombo { get; set; }
-
-        public double Accuracy { get; set; }
-
-        public bool HasReplay { get; set; }
-
-        public DateTimeOffset Date { get; set; }
-
-        public double? PP { get; set; }
-
-        public BeatmapInfo BeatmapInfo { get; set; } = null!;
-
-        public RulesetInfo Ruleset { get; set; } = null!;
-
         public ScoreRank Rank
         {
             get => (ScoreRank)RankInt;
@@ -275,6 +276,8 @@ namespace osu.Game.Scoring
 
         #endregion
 
+        public bool Equals(ScoreInfo other) => other.ID == ID;
+
         public override string ToString() => this.GetDisplayTitle();
     }
 }

From a0e210646863b0d72a443f45a691adcf0726bf88 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 17 Jan 2022 14:02:15 +0900
Subject: [PATCH 2241/5547] Guard against null values getting inserted into
 database during score/beatmap imports

---
 osu.Game/Scoring/ScoreModelManager.cs | 5 +++++
 osu.Game/Stores/BeatmapImporter.cs    | 2 +-
 2 files changed, 6 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Scoring/ScoreModelManager.cs b/osu.Game/Scoring/ScoreModelManager.cs
index fcf7244226..5ba152fad3 100644
--- a/osu.Game/Scoring/ScoreModelManager.cs
+++ b/osu.Game/Scoring/ScoreModelManager.cs
@@ -63,6 +63,11 @@ namespace osu.Game.Scoring
             if (!model.Ruleset.IsManaged)
                 model.Ruleset = realm.Find<RulesetInfo>(model.Ruleset.ShortName);
 
+            // These properties are known to be non-null, but these final checks ensure a null hasn't come from somewhere (or the refetch has failed).
+            // Under no circumstance do we want these to be written to realm as null.
+            if (model.BeatmapInfo == null) throw new ArgumentNullException(nameof(model.BeatmapInfo));
+            if (model.Ruleset == null) throw new ArgumentNullException(nameof(model.Ruleset));
+
             if (string.IsNullOrEmpty(model.StatisticsJson))
                 model.StatisticsJson = JsonConvert.SerializeObject(model.Statistics);
         }
diff --git a/osu.Game/Stores/BeatmapImporter.cs b/osu.Game/Stores/BeatmapImporter.cs
index 3ebdcde296..5303bd6fba 100644
--- a/osu.Game/Stores/BeatmapImporter.cs
+++ b/osu.Game/Stores/BeatmapImporter.cs
@@ -64,7 +64,7 @@ namespace osu.Game.Stores
                 // ensure we aren't trying to add a new ruleset to the database
                 // this can happen in tests, mostly
                 if (!b.Ruleset.IsManaged)
-                    b.Ruleset = realm.Find<RulesetInfo>(b.Ruleset.ShortName);
+                    b.Ruleset = realm.Find<RulesetInfo>(b.Ruleset.ShortName) ?? throw new ArgumentNullException(nameof(b.Ruleset));
             }
 
             validateOnlineIds(beatmapSet, realm);

From 34e99968d098d1a86deb3422bd34c754f1e20d02 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Mon, 17 Jan 2022 14:06:48 +0900
Subject: [PATCH 2242/5547] Resolve inspection

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

diff --git a/osu.Game.Rulesets.Taiko.Tests/TestSceneDrumRollJudgements.cs b/osu.Game.Rulesets.Taiko.Tests/TestSceneDrumRollJudgements.cs
index fc4fd286f4..060c3c9443 100644
--- a/osu.Game.Rulesets.Taiko.Tests/TestSceneDrumRollJudgements.cs
+++ b/osu.Game.Rulesets.Taiko.Tests/TestSceneDrumRollJudgements.cs
@@ -19,7 +19,7 @@ namespace osu.Game.Rulesets.Taiko.Tests
 
         protected override bool Autoplay => false;
 
-        protected override IBeatmap CreateBeatmap(RulesetInfo ruleset) => new Beatmap<TaikoHitObject>()
+        protected override IBeatmap CreateBeatmap(RulesetInfo ruleset) => new Beatmap<TaikoHitObject>
         {
             BeatmapInfo = { Ruleset = new TaikoRuleset().RulesetInfo },
             HitObjects =

From 381174e48248d13c241e0b9623c4a2eb199a8f4f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 17 Jan 2022 14:40:00 +0900
Subject: [PATCH 2243/5547] Give the placeholder ruleset better defaults to
 allow tests to work again

---
 osu.Game/Beatmaps/BeatmapInfo.cs | 18 ++++++++++--------
 1 file changed, 10 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapInfo.cs b/osu.Game/Beatmaps/BeatmapInfo.cs
index e14e945865..224cf60c49 100644
--- a/osu.Game/Beatmaps/BeatmapInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapInfo.cs
@@ -51,7 +51,12 @@ namespace osu.Game.Beatmaps
         [UsedImplicitly]
         public BeatmapInfo() // TODO: consider removing this and migrating all usages to ctor with parameters.
         {
-            Ruleset = new RulesetInfo();
+            Ruleset = new RulesetInfo
+            {
+                OnlineID = 0,
+                ShortName = @"osu",
+                Name = @"null placeholder ruleset"
+            };
             Difficulty = new BeatmapDifficulty();
             Metadata = new BeatmapMetadata();
         }
@@ -149,20 +154,17 @@ namespace osu.Game.Beatmaps
 
         #region Compatibility properties
 
-        private int rulesetID;
-
         [Ignored]
         [IgnoreMap]
         public int RulesetID
         {
-            // ReSharper disable once ConstantConditionalAccessQualifier
-            get => Ruleset?.OnlineID ?? rulesetID;
+            get => Ruleset.OnlineID;
             set
             {
-                if (Ruleset != null)
-                    throw new InvalidOperationException($"Cannot set a {nameof(RulesetID)} when {nameof(Ruleset)} is non-null");
+                if (!string.IsNullOrEmpty(Ruleset.InstantiationInfo))
+                    throw new InvalidOperationException($"Cannot set a {nameof(RulesetID)} when {nameof(Ruleset)} is already set to an actual ruleset.");
 
-                rulesetID = value;
+                Ruleset.OnlineID = value;
             }
         }
 

From 90166829c3d6128c8d91d24963d51a0cb011ecd8 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 17 Jan 2022 14:40:06 +0900
Subject: [PATCH 2244/5547] Update tests which were importing scores without a
 valid beatmap

---
 osu.Game.Tests/Scores/IO/ImportScoreTest.cs   | 22 ++++++++++++++-----
 .../Gameplay/TestSceneReplayDownloadButton.cs | 21 +++++++++++++-----
 2 files changed, 32 insertions(+), 11 deletions(-)

diff --git a/osu.Game.Tests/Scores/IO/ImportScoreTest.cs b/osu.Game.Tests/Scores/IO/ImportScoreTest.cs
index 0e6d560167..dd12c94855 100644
--- a/osu.Game.Tests/Scores/IO/ImportScoreTest.cs
+++ b/osu.Game.Tests/Scores/IO/ImportScoreTest.cs
@@ -8,8 +8,8 @@ using System.Linq;
 using System.Threading.Tasks;
 using NUnit.Framework;
 using osu.Framework.Allocation;
+using osu.Framework.Extensions;
 using osu.Framework.Platform;
-using osu.Game.Beatmaps;
 using osu.Game.IO.Archives;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets.Mods;
@@ -17,6 +17,8 @@ using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Osu.Mods;
 using osu.Game.Rulesets.Scoring;
 using osu.Game.Scoring;
+using osu.Game.Tests.Beatmaps.IO;
+using osu.Game.Tests.Resources;
 
 namespace osu.Game.Tests.Scores.IO
 {
@@ -31,6 +33,8 @@ namespace osu.Game.Tests.Scores.IO
                 {
                     var osu = LoadOsuIntoHost(host, true);
 
+                    var beatmap = BeatmapImportHelper.LoadOszIntoOsu(osu, TestResources.GetQuickTestBeatmapForImport()).GetResultSafely();
+
                     var toImport = new ScoreInfo
                     {
                         Rank = ScoreRank.B,
@@ -42,7 +46,7 @@ namespace osu.Game.Tests.Scores.IO
                         Date = DateTimeOffset.Now,
                         OnlineID = 12345,
                         Ruleset = new OsuRuleset().RulesetInfo,
-                        BeatmapInfo = new BeatmapInfo()
+                        BeatmapInfo = beatmap.Beatmaps.First()
                     };
 
                     var imported = await LoadScoreIntoOsu(osu, toImport);
@@ -71,10 +75,12 @@ namespace osu.Game.Tests.Scores.IO
                 {
                     var osu = LoadOsuIntoHost(host, true);
 
+                    var beatmap = BeatmapImportHelper.LoadOszIntoOsu(osu, TestResources.GetQuickTestBeatmapForImport()).GetResultSafely();
+
                     var toImport = new ScoreInfo
                     {
                         User = new APIUser { Username = "Test user" },
-                        BeatmapInfo = new BeatmapInfo(),
+                        BeatmapInfo = beatmap.Beatmaps.First(),
                         Ruleset = new OsuRuleset().RulesetInfo,
                         Mods = new Mod[] { new OsuModHardRock(), new OsuModDoubleTime() },
                     };
@@ -100,10 +106,12 @@ namespace osu.Game.Tests.Scores.IO
                 {
                     var osu = LoadOsuIntoHost(host, true);
 
+                    var beatmap = BeatmapImportHelper.LoadOszIntoOsu(osu, TestResources.GetQuickTestBeatmapForImport()).GetResultSafely();
+
                     var toImport = new ScoreInfo
                     {
                         User = new APIUser { Username = "Test user" },
-                        BeatmapInfo = new BeatmapInfo(),
+                        BeatmapInfo = beatmap.Beatmaps.First(),
                         Ruleset = new OsuRuleset().RulesetInfo,
                         Statistics = new Dictionary<HitResult, int>
                         {
@@ -133,10 +141,12 @@ namespace osu.Game.Tests.Scores.IO
                 {
                     var osu = LoadOsuIntoHost(host, true);
 
+                    var beatmap = BeatmapImportHelper.LoadOszIntoOsu(osu, TestResources.GetQuickTestBeatmapForImport()).GetResultSafely();
+
                     await LoadScoreIntoOsu(osu, new ScoreInfo
                     {
                         User = new APIUser { Username = "Test user" },
-                        BeatmapInfo = new BeatmapInfo(),
+                        BeatmapInfo = beatmap.Beatmaps.First(),
                         Ruleset = new OsuRuleset().RulesetInfo,
                         OnlineID = 2
                     }, new TestArchiveReader());
@@ -147,7 +157,7 @@ namespace osu.Game.Tests.Scores.IO
                     Assert.That(scoreManager.IsAvailableLocally(new ScoreInfo
                     {
                         User = new APIUser { Username = "Test user" },
-                        BeatmapInfo = new BeatmapInfo(),
+                        BeatmapInfo = beatmap.Beatmaps.First(),
                         OnlineID = 2
                     }));
                 }
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneReplayDownloadButton.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneReplayDownloadButton.cs
index 3168c4b94e..8199389b36 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneReplayDownloadButton.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneReplayDownloadButton.cs
@@ -6,16 +6,18 @@ using NUnit.Framework;
 using osu.Framework.Graphics;
 using osu.Game.Online;
 using osu.Game.Online.API.Requests.Responses;
-using osu.Game.Scoring;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Extensions;
 using osu.Framework.Testing;
+using osu.Game.Beatmaps;
 using osu.Game.Database;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Osu;
+using osu.Game.Scoring;
 using osu.Game.Screens.Ranking;
+using osu.Game.Tests.Resources;
 using osuTK.Input;
 using APIUser = osu.Game.Online.API.Requests.Responses.APIUser;
 
@@ -29,6 +31,18 @@ namespace osu.Game.Tests.Visual.Gameplay
 
         private TestReplayDownloadButton downloadButton;
 
+        [Resolved]
+        private BeatmapManager beatmapManager { get; set; }
+
+        [Resolved]
+        private ScoreManager scoreManager { get; set; }
+
+        [BackgroundDependencyLoader]
+        private void load()
+        {
+            beatmapManager.Import(TestResources.GetQuickTestBeatmapForImport()).WaitSafely();
+        }
+
         [Test]
         public void TestDisplayStates()
         {
@@ -115,9 +129,6 @@ namespace osu.Game.Tests.Visual.Gameplay
             AddAssert("button is not enabled", () => !downloadButton.ChildrenOfType<DownloadButton>().First().Enabled.Value);
         }
 
-        [Resolved]
-        private ScoreManager scoreManager { get; set; }
-
         [Test]
         public void TestScoreImportThenDelete()
         {
@@ -176,7 +187,7 @@ namespace osu.Game.Tests.Visual.Gameplay
                     Id = 39828,
                     Username = @"WubWoofWolf",
                 }
-            }.CreateScoreInfo(rulesets, CreateBeatmap(new OsuRuleset().RulesetInfo).BeatmapInfo);
+            }.CreateScoreInfo(rulesets, beatmapManager.GetAllUsableBeatmapSets().First().Beatmaps.First());
         }
 
         private class TestReplayDownloadButton : ReplayDownloadButton

From 5dc7425b2cd4c44802ee8b94002790c2a08befc6 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 17 Jan 2022 14:54:03 +0900
Subject: [PATCH 2245/5547] Fix incorrect realm (non-isolated instance) being
 used in two test scenes

---
 .../Visual/SongSelect/TestSceneBeatmapLeaderboard.cs           | 3 +--
 .../Visual/UserInterface/TestSceneDeleteLocalScore.cs          | 2 +-
 2 files changed, 2 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
index 9ae15c387a..2e1a66be5f 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
@@ -11,7 +11,6 @@ using osu.Framework.Graphics;
 using osu.Framework.Platform;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
-using osu.Game.Database;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Leaderboards;
 using osu.Game.Overlays;
@@ -45,7 +44,7 @@ namespace osu.Game.Tests.Visual.SongSelect
 
             dependencies.Cache(rulesetStore = new RulesetStore(ContextFactory));
             dependencies.Cache(beatmapManager = new BeatmapManager(LocalStorage, ContextFactory, rulesetStore, null, dependencies.Get<AudioManager>(), Resources, dependencies.Get<GameHost>(), Beatmap.Default));
-            dependencies.Cache(scoreManager = new ScoreManager(rulesetStore, () => beatmapManager, LocalStorage, dependencies.Get<RealmContextFactory>(), Scheduler));
+            dependencies.Cache(scoreManager = new ScoreManager(rulesetStore, () => beatmapManager, LocalStorage, ContextFactory, Scheduler));
             Dependencies.Cache(ContextFactory);
 
             return dependencies;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
index 02746ee8e8..1e14e4b3e5 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
@@ -89,7 +89,7 @@ namespace osu.Game.Tests.Visual.UserInterface
 
             dependencies.Cache(rulesetStore = new RulesetStore(ContextFactory));
             dependencies.Cache(beatmapManager = new BeatmapManager(LocalStorage, ContextFactory, rulesetStore, null, dependencies.Get<AudioManager>(), Resources, dependencies.Get<GameHost>(), Beatmap.Default));
-            dependencies.Cache(scoreManager = new ScoreManager(dependencies.Get<RulesetStore>(), () => beatmapManager, LocalStorage, dependencies.Get<RealmContextFactory>(), Scheduler));
+            dependencies.Cache(scoreManager = new ScoreManager(dependencies.Get<RulesetStore>(), () => beatmapManager, LocalStorage, ContextFactory, Scheduler));
             Dependencies.Cache(ContextFactory);
 
             var imported = beatmapManager.Import(new ImportTask(TestResources.GetQuickTestBeatmapForImport())).GetResultSafely();

From 51ade3251d68c9222a897852ce20e99b0d676077 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 17 Jan 2022 15:15:20 +0900
Subject: [PATCH 2246/5547] Improve `ScoresContainer` loading overlay logic to
 work better with tests

---
 osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.cs | 9 +++------
 1 file changed, 3 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.cs b/osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.cs
index a40f29abf2..00dedc892b 100644
--- a/osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.cs
+++ b/osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.cs
@@ -65,6 +65,9 @@ namespace osu.Game.Overlays.BeatmapSet.Scores
                 scoreTable.ClearScores();
                 scoreTable.Hide();
 
+                loading.Hide();
+                loading.FinishTransforms();
+
                 if (value?.Scores.Any() != true)
                     return;
 
@@ -258,9 +261,6 @@ namespace osu.Game.Overlays.BeatmapSet.Scores
             {
                 Scores = null;
                 notSupporterPlaceholder.Show();
-
-                loading.Hide();
-                loading.FinishTransforms();
                 return;
             }
 
@@ -272,9 +272,6 @@ namespace osu.Game.Overlays.BeatmapSet.Scores
             getScoresRequest = new GetScoresRequest(Beatmap.Value, Beatmap.Value.Ruleset, scope.Value, modSelector.SelectedMods);
             getScoresRequest.Success += scores =>
             {
-                loading.Hide();
-                loading.FinishTransforms();
-
                 Scores = scores;
 
                 if (!scores.Scores.Any())

From 6436b6186f6e3a1ad2262748138576b23334f750 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 17 Jan 2022 15:15:34 +0900
Subject: [PATCH 2247/5547] Rewrite `TestScenScoresContainer` to work again

---
 .../Visual/Online/TestSceneScoresContainer.cs | 440 +++++++++---------
 1 file changed, 231 insertions(+), 209 deletions(-)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneScoresContainer.cs b/osu.Game.Tests/Visual/Online/TestSceneScoresContainer.cs
index be2db9a8a0..71b60d8842 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneScoresContainer.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneScoresContainer.cs
@@ -1,11 +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.Collections.Generic;
+using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
+using osu.Framework.Testing;
 using osu.Framework.Utils;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests.Responses;
@@ -24,224 +27,38 @@ namespace osu.Game.Tests.Visual.Online
         [Cached]
         private readonly OverlayColourProvider colourProvider = new OverlayColourProvider(OverlayColourScheme.Blue);
 
-        public TestSceneScoresContainer()
+        private TestScoresContainer scoresContainer;
+
+        [SetUpSteps]
+        public void SetUpSteps()
         {
-            TestScoresContainer scoresContainer;
-
-            Child = new Container
+            AddStep("Create container", () =>
             {
-                Anchor = Anchor.TopCentre,
-                Origin = Anchor.TopCentre,
-                RelativeSizeAxes = Axes.Both,
-                Width = 0.8f,
-                Children = new Drawable[]
+                Child = new Container
                 {
-                    new Box
+                    Anchor = Anchor.TopCentre,
+                    Origin = Anchor.TopCentre,
+                    RelativeSizeAxes = Axes.Both,
+                    Width = 0.8f,
+                    Children = new Drawable[]
                     {
-                        RelativeSizeAxes = Axes.Both,
-                        Colour = Color4.Black,
-                    },
-                    scoresContainer = new TestScoresContainer(),
-                }
-            };
-
-            var allScores = new APIScoresCollection
-            {
-                Scores = new List<APIScore>
-                {
-                    new APIScore
-                    {
-                        User = new APIUser
+                        new Box
                         {
-                            Id = 6602580,
-                            Username = @"waaiiru",
-                            Country = new Country
-                            {
-                                FullName = @"Spain",
-                                FlagName = @"ES",
-                            },
+                            RelativeSizeAxes = Axes.Both,
+                            Colour = Color4.Black,
                         },
-                        Mods = new[]
+                        scoresContainer = new TestScoresContainer
                         {
-                            new APIMod { Acronym = new OsuModDoubleTime().Acronym },
-                            new APIMod { Acronym = new OsuModHidden().Acronym },
-                            new APIMod { Acronym = new OsuModFlashlight().Acronym },
-                            new APIMod { Acronym = new OsuModHardRock().Acronym },
-                        },
-                        Rank = ScoreRank.XH,
-                        PP = 200,
-                        MaxCombo = 1234,
-                        TotalScore = 1234567890,
-                        Accuracy = 1,
-                    },
-                    new APIScore
-                    {
-                        User = new APIUser
-                        {
-                            Id = 4608074,
-                            Username = @"Skycries",
-                            Country = new Country
-                            {
-                                FullName = @"Brazil",
-                                FlagName = @"BR",
-                            },
-                        },
-                        Mods = new[]
-                        {
-                            new APIMod { Acronym = new OsuModDoubleTime().Acronym },
-                            new APIMod { Acronym = new OsuModHidden().Acronym },
-                            new APIMod { Acronym = new OsuModFlashlight().Acronym },
-                        },
-                        Rank = ScoreRank.S,
-                        PP = 190,
-                        MaxCombo = 1234,
-                        TotalScore = 1234789,
-                        Accuracy = 0.9997,
-                    },
-                    new APIScore
-                    {
-                        User = new APIUser
-                        {
-                            Id = 1014222,
-                            Username = @"eLy",
-                            Country = new Country
-                            {
-                                FullName = @"Japan",
-                                FlagName = @"JP",
-                            },
-                        },
-                        Mods = new[]
-                        {
-                            new APIMod { Acronym = new OsuModDoubleTime().Acronym },
-                            new APIMod { Acronym = new OsuModHidden().Acronym },
-                        },
-                        Rank = ScoreRank.B,
-                        PP = 180,
-                        MaxCombo = 1234,
-                        TotalScore = 12345678,
-                        Accuracy = 0.9854,
-                    },
-                    new APIScore
-                    {
-                        User = new APIUser
-                        {
-                            Id = 1541390,
-                            Username = @"Toukai",
-                            Country = new Country
-                            {
-                                FullName = @"Canada",
-                                FlagName = @"CA",
-                            },
-                        },
-                        Mods = new[]
-                        {
-                            new APIMod { Acronym = new OsuModDoubleTime().Acronym },
-                        },
-                        Rank = ScoreRank.C,
-                        PP = 170,
-                        MaxCombo = 1234,
-                        TotalScore = 1234567,
-                        Accuracy = 0.8765,
-                    },
-                    new APIScore
-                    {
-                        User = new APIUser
-                        {
-                            Id = 7151382,
-                            Username = @"Mayuri Hana",
-                            Country = new Country
-                            {
-                                FullName = @"Thailand",
-                                FlagName = @"TH",
-                            },
-                        },
-                        Rank = ScoreRank.D,
-                        PP = 160,
-                        MaxCombo = 1234,
-                        TotalScore = 123456,
-                        Accuracy = 0.6543,
-                    },
-                }
-            };
-
-            var myBestScore = new APIScoreWithPosition
-            {
-                Score = new APIScore
-                {
-                    User = new APIUser
-                    {
-                        Id = 7151382,
-                        Username = @"Mayuri Hana",
-                        Country = new Country
-                        {
-                            FullName = @"Thailand",
-                            FlagName = @"TH",
-                        },
-                    },
-                    Rank = ScoreRank.D,
-                    PP = 160,
-                    MaxCombo = 1234,
-                    TotalScore = 123456,
-                    Accuracy = 0.6543,
-                },
-                Position = 1337,
-            };
-
-            var myBestScoreWithNullPosition = new APIScoreWithPosition
-            {
-                Score = new APIScore
-                {
-                    User = new APIUser
-                    {
-                        Id = 7151382,
-                        Username = @"Mayuri Hana",
-                        Country = new Country
-                        {
-                            FullName = @"Thailand",
-                            FlagName = @"TH",
-                        },
-                    },
-                    Rank = ScoreRank.D,
-                    PP = 160,
-                    MaxCombo = 1234,
-                    TotalScore = 123456,
-                    Accuracy = 0.6543,
-                },
-                Position = null,
-            };
-
-            var oneScore = new APIScoresCollection
-            {
-                Scores = new List<APIScore>
-                {
-                    new APIScore
-                    {
-                        User = new APIUser
-                        {
-                            Id = 6602580,
-                            Username = @"waaiiru",
-                            Country = new Country
-                            {
-                                FullName = @"Spain",
-                                FlagName = @"ES",
-                            },
-                        },
-                        Mods = new[]
-                        {
-                            new APIMod { Acronym = new OsuModDoubleTime().Acronym },
-                            new APIMod { Acronym = new OsuModHidden().Acronym },
-                            new APIMod { Acronym = new OsuModFlashlight().Acronym },
-                            new APIMod { Acronym = new OsuModHardRock().Acronym },
-                        },
-                        Rank = ScoreRank.XH,
-                        PP = 200,
-                        MaxCombo = 1234,
-                        TotalScore = 1234567890,
-                        Accuracy = 1,
+                            Beatmap = { Value = CreateAPIBeatmap() }
+                        }
                     }
-                }
-            };
+                };
+            });
+        }
 
+        [Test]
+        public void TestDisplay()
+        {
             foreach (var s in allScores.Scores)
             {
                 s.Statistics = new Dictionary<string, int>
@@ -273,6 +90,211 @@ namespace osu.Game.Tests.Visual.Online
             });
         }
 
+        private readonly APIScoresCollection allScores = new APIScoresCollection
+        {
+            Scores = new List<APIScore>
+            {
+                new APIScore
+                {
+                    Date = DateTimeOffset.Now,
+                    User = new APIUser
+                    {
+                        Id = 6602580,
+                        Username = @"waaiiru",
+                        Country = new Country
+                        {
+                            FullName = @"Spain",
+                            FlagName = @"ES",
+                        },
+                    },
+                    Mods = new[]
+                    {
+                        new APIMod { Acronym = new OsuModDoubleTime().Acronym },
+                        new APIMod { Acronym = new OsuModHidden().Acronym },
+                        new APIMod { Acronym = new OsuModFlashlight().Acronym },
+                        new APIMod { Acronym = new OsuModHardRock().Acronym },
+                    },
+                    Rank = ScoreRank.XH,
+                    PP = 200,
+                    MaxCombo = 1234,
+                    TotalScore = 1234567890,
+                    Accuracy = 1,
+                },
+                new APIScore
+                {
+                    Date = DateTimeOffset.Now,
+                    User = new APIUser
+                    {
+                        Id = 4608074,
+                        Username = @"Skycries",
+                        Country = new Country
+                        {
+                            FullName = @"Brazil",
+                            FlagName = @"BR",
+                        },
+                    },
+                    Mods = new[]
+                    {
+                        new APIMod { Acronym = new OsuModDoubleTime().Acronym },
+                        new APIMod { Acronym = new OsuModHidden().Acronym },
+                        new APIMod { Acronym = new OsuModFlashlight().Acronym },
+                    },
+                    Rank = ScoreRank.S,
+                    PP = 190,
+                    MaxCombo = 1234,
+                    TotalScore = 1234789,
+                    Accuracy = 0.9997,
+                },
+                new APIScore
+                {
+                    Date = DateTimeOffset.Now,
+                    User = new APIUser
+                    {
+                        Id = 1014222,
+                        Username = @"eLy",
+                        Country = new Country
+                        {
+                            FullName = @"Japan",
+                            FlagName = @"JP",
+                        },
+                    },
+                    Mods = new[]
+                    {
+                        new APIMod { Acronym = new OsuModDoubleTime().Acronym },
+                        new APIMod { Acronym = new OsuModHidden().Acronym },
+                    },
+                    Rank = ScoreRank.B,
+                    PP = 180,
+                    MaxCombo = 1234,
+                    TotalScore = 12345678,
+                    Accuracy = 0.9854,
+                },
+                new APIScore
+                {
+                    Date = DateTimeOffset.Now,
+                    User = new APIUser
+                    {
+                        Id = 1541390,
+                        Username = @"Toukai",
+                        Country = new Country
+                        {
+                            FullName = @"Canada",
+                            FlagName = @"CA",
+                        },
+                    },
+                    Mods = new[]
+                    {
+                        new APIMod { Acronym = new OsuModDoubleTime().Acronym },
+                    },
+                    Rank = ScoreRank.C,
+                    PP = 170,
+                    MaxCombo = 1234,
+                    TotalScore = 1234567,
+                    Accuracy = 0.8765,
+                },
+                new APIScore
+                {
+                    Date = DateTimeOffset.Now,
+                    User = new APIUser
+                    {
+                        Id = 7151382,
+                        Username = @"Mayuri Hana",
+                        Country = new Country
+                        {
+                            FullName = @"Thailand",
+                            FlagName = @"TH",
+                        },
+                    },
+                    Rank = ScoreRank.D,
+                    PP = 160,
+                    MaxCombo = 1234,
+                    TotalScore = 123456,
+                    Accuracy = 0.6543,
+                },
+            }
+        };
+
+        private readonly APIScoreWithPosition myBestScore = new APIScoreWithPosition
+        {
+            Score = new APIScore
+            {
+                Date = DateTimeOffset.Now,
+                User = new APIUser
+                {
+                    Id = 7151382,
+                    Username = @"Mayuri Hana",
+                    Country = new Country
+                    {
+                        FullName = @"Thailand",
+                        FlagName = @"TH",
+                    },
+                },
+                Rank = ScoreRank.D,
+                PP = 160,
+                MaxCombo = 1234,
+                TotalScore = 123456,
+                Accuracy = 0.6543,
+            },
+            Position = 1337,
+        };
+
+        private readonly APIScoreWithPosition myBestScoreWithNullPosition = new APIScoreWithPosition
+        {
+            Score = new APIScore
+            {
+                Date = DateTimeOffset.Now,
+                User = new APIUser
+                {
+                    Id = 7151382,
+                    Username = @"Mayuri Hana",
+                    Country = new Country
+                    {
+                        FullName = @"Thailand",
+                        FlagName = @"TH",
+                    },
+                },
+                Rank = ScoreRank.D,
+                PP = 160,
+                MaxCombo = 1234,
+                TotalScore = 123456,
+                Accuracy = 0.6543,
+            },
+            Position = null,
+        };
+
+        private readonly APIScoresCollection oneScore = new APIScoresCollection
+        {
+            Scores = new List<APIScore>
+            {
+                new APIScore
+                {
+                    Date = DateTimeOffset.Now,
+                    User = new APIUser
+                    {
+                        Id = 6602580,
+                        Username = @"waaiiru",
+                        Country = new Country
+                        {
+                            FullName = @"Spain",
+                            FlagName = @"ES",
+                        },
+                    },
+                    Mods = new[]
+                    {
+                        new APIMod { Acronym = new OsuModDoubleTime().Acronym },
+                        new APIMod { Acronym = new OsuModHidden().Acronym },
+                        new APIMod { Acronym = new OsuModFlashlight().Acronym },
+                        new APIMod { Acronym = new OsuModHardRock().Acronym },
+                    },
+                    Rank = ScoreRank.XH,
+                    PP = 200,
+                    MaxCombo = 1234,
+                    TotalScore = 1234567890,
+                    Accuracy = 1,
+                }
+            }
+        };
+
         private class TestScoresContainer : ScoresContainer
         {
             public new APIScoresCollection Scores

From 12fd279b7df1b3dbac8f1ede8fac3306a3320156 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 17 Jan 2022 15:59:14 +0900
Subject: [PATCH 2248/5547] Add test to check full flow of rebinding gameplay
 key bindings

Addresses a regression found in realm PR that was not covered by tests.
---
 .../TestSceneChangeAndUseGameplayBindings.cs  | 89 +++++++++++++++++++
 .../Sections/Input/KeyBindingsSubsection.cs   |  2 +-
 2 files changed, 90 insertions(+), 1 deletion(-)
 create mode 100644 osu.Game.Tests/Visual/Navigation/TestSceneChangeAndUseGameplayBindings.cs

diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneChangeAndUseGameplayBindings.cs b/osu.Game.Tests/Visual/Navigation/TestSceneChangeAndUseGameplayBindings.cs
new file mode 100644
index 0000000000..7dda158ee1
--- /dev/null
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneChangeAndUseGameplayBindings.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.Allocation;
+using osu.Framework.Extensions;
+using osu.Framework.Input.Bindings;
+using osu.Framework.Testing;
+using osu.Game.Database;
+using osu.Game.Graphics.UserInterface;
+using osu.Game.Input.Bindings;
+using osu.Game.Overlays.Settings.Sections.Input;
+using osu.Game.Screens.Play;
+using osu.Game.Screens.Select;
+using osu.Game.Tests.Beatmaps.IO;
+using osu.Game.Tests.Database;
+using osuTK.Input;
+
+namespace osu.Game.Tests.Visual.Navigation
+{
+    public class TestSceneChangeAndUseGameplayBindings : OsuGameTestScene
+    {
+        [Test]
+        public void TestGameplayKeyBindings()
+        {
+            AddAssert("databased key is default", () => firstOsuRulesetKeyBindings.KeyCombination.Keys.SequenceEqual(new[] { InputKey.Z }));
+
+            AddStep("open settings", () => { Game.Settings.Show(); });
+
+            // Until step requires as settings has a delayed load.
+            AddUntilStep("wait for button", () => configureBindingsButton?.Enabled.Value == true);
+            AddStep("scroll to section", () => Game.Settings.SectionsContainer.ScrollTo(configureBindingsButton));
+            AddStep("press button", () => configureBindingsButton.TriggerClick());
+            AddUntilStep("wait for panel", () => keyBindingPanel?.IsLoaded == true);
+            AddUntilStep("wait for osu subsection", () => osuBindingSubsection?.IsLoaded == true);
+            AddStep("scroll to section", () => keyBindingPanel.SectionsContainer.ScrollTo(osuBindingSubsection));
+            AddWaitStep("wait for scroll to end", 3);
+            AddStep("start rebinding first osu! key", () =>
+            {
+                var button = osuBindingSubsection.ChildrenOfType<KeyBindingRow>().First();
+
+                InputManager.MoveMouseTo(button);
+                InputManager.Click(MouseButton.Left);
+            });
+
+            AddStep("Press 's'", () => InputManager.Key(Key.S));
+
+            AddUntilStep("wait for database updated", () => firstOsuRulesetKeyBindings.KeyCombination.Keys.SequenceEqual(new[] { InputKey.S }));
+
+            AddStep("close settings", () => Game.Settings.Hide());
+
+            AddStep("import beatmap", () => ImportBeatmapTest.LoadQuickOszIntoOsu(Game).WaitSafely());
+            PushAndConfirm(() => new PlaySongSelect());
+
+            AddStep("enter gameplay", () => InputManager.Key(Key.Enter));
+
+            AddUntilStep("wait for gameplay", () => player?.IsBreakTime.Value == false);
+
+            AddStep("press 'z'", () => InputManager.Key(Key.Z));
+            AddAssert("key counter didn't increase", () => keyCounter.CountPresses == 0);
+
+            AddStep("press 's'", () => InputManager.Key(Key.S));
+            AddAssert("key counter did increase", () => keyCounter.CountPresses == 1);
+        }
+
+        private KeyBindingsSubsection osuBindingSubsection => keyBindingPanel
+                                                              .ChildrenOfType<VariantBindingsSubsection>()
+                                                              .FirstOrDefault(s => s.Ruleset.ShortName == "osu");
+
+        private OsuButton configureBindingsButton => Game.Settings
+                                                         .ChildrenOfType<BindingSettings>().SingleOrDefault()?
+                                                         .ChildrenOfType<OsuButton>()?
+                                                         .First(b => b.Text.ToString() == "Configure");
+
+        private KeyBindingPanel keyBindingPanel => Game.Settings
+                                                       .ChildrenOfType<KeyBindingPanel>().SingleOrDefault();
+
+        private RealmKeyBinding firstOsuRulesetKeyBindings => Game.Dependencies
+                                                                  .Get<RealmContextFactory>().Context
+                                                                  .All<RealmKeyBinding>()
+                                                                  .AsEnumerable()
+                                                                  .First(k => k.RulesetName == "osu" && k.ActionInt == 0);
+
+        private Player player => Game.ScreenStack.CurrentScreen as Player;
+
+        private KeyCounter keyCounter => player.ChildrenOfType<KeyCounter>().First();
+    }
+}
diff --git a/osu.Game/Overlays/Settings/Sections/Input/KeyBindingsSubsection.cs b/osu.Game/Overlays/Settings/Sections/Input/KeyBindingsSubsection.cs
index 115a7bdc79..94c7c66538 100644
--- a/osu.Game/Overlays/Settings/Sections/Input/KeyBindingsSubsection.cs
+++ b/osu.Game/Overlays/Settings/Sections/Input/KeyBindingsSubsection.cs
@@ -18,7 +18,7 @@ namespace osu.Game.Overlays.Settings.Sections.Input
     {
         protected IEnumerable<Framework.Input.Bindings.KeyBinding> Defaults;
 
-        protected RulesetInfo Ruleset;
+        public RulesetInfo Ruleset { get; protected set; }
 
         private readonly int? variant;
 

From a80e461000737994c24d84ea20fabe34494d5c6d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 17 Jan 2022 16:23:58 +0900
Subject: [PATCH 2249/5547] Add better test coverage of user top scores

---
 .../Visual/Online/TestSceneScoresContainer.cs | 455 +++++++++---------
 1 file changed, 235 insertions(+), 220 deletions(-)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneScoresContainer.cs b/osu.Game.Tests/Visual/Online/TestSceneScoresContainer.cs
index 71b60d8842..d4af01f772 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneScoresContainer.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneScoresContainer.cs
@@ -3,6 +3,7 @@
 
 using System;
 using System.Collections.Generic;
+using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
@@ -30,36 +31,247 @@ namespace osu.Game.Tests.Visual.Online
         private TestScoresContainer scoresContainer;
 
         [SetUpSteps]
-        public void SetUpSteps()
+        public void SetUp() => Schedule(() =>
         {
-            AddStep("Create container", () =>
+            Child = new Container
             {
-                Child = new Container
+                Anchor = Anchor.TopCentre,
+                Origin = Anchor.TopCentre,
+                RelativeSizeAxes = Axes.Both,
+                Width = 0.8f,
+                Children = new Drawable[]
                 {
-                    Anchor = Anchor.TopCentre,
-                    Origin = Anchor.TopCentre,
-                    RelativeSizeAxes = Axes.Both,
-                    Width = 0.8f,
-                    Children = new Drawable[]
+                    new Box
                     {
-                        new Box
-                        {
-                            RelativeSizeAxes = Axes.Both,
-                            Colour = Color4.Black,
-                        },
-                        scoresContainer = new TestScoresContainer
-                        {
-                            Beatmap = { Value = CreateAPIBeatmap() }
-                        }
+                        RelativeSizeAxes = Axes.Both,
+                        Colour = Color4.Black,
+                    },
+                    scoresContainer = new TestScoresContainer
+                    {
+                        Beatmap = { Value = CreateAPIBeatmap() }
                     }
-                };
+                }
+            };
+        });
+
+        [Test]
+        public void TestNoUserBest()
+        {
+            AddStep("Scores with no user best", () =>
+            {
+                var allScores = createScores();
+
+                allScores.UserScore = null;
+
+                scoresContainer.Scores = allScores;
             });
+
+            AddUntilStep("wait for scores displayed", () => scoresContainer.ChildrenOfType<ScoreTableRowBackground>().Any());
+            AddAssert("no user best displayed", () => scoresContainer.ChildrenOfType<DrawableTopScore>().Count() == 1);
+
+            AddStep("Load null scores", () => scoresContainer.Scores = null);
+
+            AddUntilStep("wait for scores not displayed", () => !scoresContainer.ChildrenOfType<ScoreTableRowBackground>().Any());
+            AddAssert("no best score displayed", () => !scoresContainer.ChildrenOfType<DrawableTopScore>().Any());
+
+            AddStep("Load only one score", () =>
+            {
+                var allScores = createScores();
+
+                allScores.Scores.RemoveRange(1, allScores.Scores.Count - 1);
+
+                scoresContainer.Scores = allScores;
+            });
+
+            AddUntilStep("wait for scores not displayed", () => scoresContainer.ChildrenOfType<ScoreTableRowBackground>().Count() == 1);
+            AddAssert("no best score displayed", () => scoresContainer.ChildrenOfType<DrawableTopScore>().Count() == 1);
         }
 
         [Test]
-        public void TestDisplay()
+        public void TestUserBest()
         {
-            foreach (var s in allScores.Scores)
+            AddStep("Load scores with personal best", () =>
+            {
+                var allScores = createScores();
+                allScores.UserScore = createUserBest();
+                scoresContainer.Scores = allScores;
+            });
+
+            AddUntilStep("wait for scores displayed", () => scoresContainer.ChildrenOfType<ScoreTableRowBackground>().Any());
+            AddAssert("best score displayed", () => scoresContainer.ChildrenOfType<DrawableTopScore>().Count() == 2);
+
+            AddStep("Load scores with personal best (null position)", () =>
+            {
+                var allScores = createScores();
+                var userBest = createUserBest();
+                userBest.Position = null;
+                allScores.UserScore = userBest;
+                scoresContainer.Scores = allScores;
+            });
+
+            AddUntilStep("wait for scores displayed", () => scoresContainer.ChildrenOfType<ScoreTableRowBackground>().Any());
+            AddAssert("best score displayed", () => scoresContainer.ChildrenOfType<DrawableTopScore>().Count() == 2);
+
+            AddStep("Load scores with personal best (first place)", () =>
+            {
+                var allScores = createScores();
+                allScores.UserScore = new APIScoreWithPosition
+                {
+                    Score = allScores.Scores.First(),
+                    Position = 1,
+                };
+                scoresContainer.Scores = allScores;
+            });
+
+            AddUntilStep("wait for scores displayed", () => scoresContainer.ChildrenOfType<ScoreTableRowBackground>().Any());
+            AddAssert("best score displayed", () => scoresContainer.ChildrenOfType<DrawableTopScore>().Count() == 1);
+
+            AddStep("Scores with no user best", () =>
+            {
+                var allScores = createScores();
+
+                allScores.UserScore = null;
+
+                scoresContainer.Scores = allScores;
+            });
+
+            AddAssert("best score not displayed", () => scoresContainer.ChildrenOfType<DrawableTopScore>().Count() == 1);
+        }
+
+        private int onlineID = 1;
+
+        private APIScoresCollection createScores()
+        {
+            var scores = new APIScoresCollection
+            {
+                Scores = new List<APIScore>
+                {
+                    new APIScore
+                    {
+                        Date = DateTimeOffset.Now,
+                        OnlineID = onlineID++,
+                        User = new APIUser
+                        {
+                            Id = 6602580,
+                            Username = @"waaiiru",
+                            Country = new Country
+                            {
+                                FullName = @"Spain",
+                                FlagName = @"ES",
+                            },
+                        },
+                        Mods = new[]
+                        {
+                            new APIMod { Acronym = new OsuModDoubleTime().Acronym },
+                            new APIMod { Acronym = new OsuModHidden().Acronym },
+                            new APIMod { Acronym = new OsuModFlashlight().Acronym },
+                            new APIMod { Acronym = new OsuModHardRock().Acronym },
+                        },
+                        Rank = ScoreRank.XH,
+                        PP = 200,
+                        MaxCombo = 1234,
+                        TotalScore = 1234567890,
+                        Accuracy = 1,
+                    },
+                    new APIScore
+                    {
+                        Date = DateTimeOffset.Now,
+                        OnlineID = onlineID++,
+                        User = new APIUser
+                        {
+                            Id = 4608074,
+                            Username = @"Skycries",
+                            Country = new Country
+                            {
+                                FullName = @"Brazil",
+                                FlagName = @"BR",
+                            },
+                        },
+                        Mods = new[]
+                        {
+                            new APIMod { Acronym = new OsuModDoubleTime().Acronym },
+                            new APIMod { Acronym = new OsuModHidden().Acronym },
+                            new APIMod { Acronym = new OsuModFlashlight().Acronym },
+                        },
+                        Rank = ScoreRank.S,
+                        PP = 190,
+                        MaxCombo = 1234,
+                        TotalScore = 1234789,
+                        Accuracy = 0.9997,
+                    },
+                    new APIScore
+                    {
+                        Date = DateTimeOffset.Now,
+                        OnlineID = onlineID++,
+                        User = new APIUser
+                        {
+                            Id = 1014222,
+                            Username = @"eLy",
+                            Country = new Country
+                            {
+                                FullName = @"Japan",
+                                FlagName = @"JP",
+                            },
+                        },
+                        Mods = new[]
+                        {
+                            new APIMod { Acronym = new OsuModDoubleTime().Acronym },
+                            new APIMod { Acronym = new OsuModHidden().Acronym },
+                        },
+                        Rank = ScoreRank.B,
+                        PP = 180,
+                        MaxCombo = 1234,
+                        TotalScore = 12345678,
+                        Accuracy = 0.9854,
+                    },
+                    new APIScore
+                    {
+                        Date = DateTimeOffset.Now,
+                        OnlineID = onlineID++,
+                        User = new APIUser
+                        {
+                            Id = 1541390,
+                            Username = @"Toukai",
+                            Country = new Country
+                            {
+                                FullName = @"Canada",
+                                FlagName = @"CA",
+                            },
+                        },
+                        Mods = new[]
+                        {
+                            new APIMod { Acronym = new OsuModDoubleTime().Acronym },
+                        },
+                        Rank = ScoreRank.C,
+                        PP = 170,
+                        MaxCombo = 1234,
+                        TotalScore = 1234567,
+                        Accuracy = 0.8765,
+                    },
+                    new APIScore
+                    {
+                        Date = DateTimeOffset.Now,
+                        OnlineID = onlineID++,
+                        User = new APIUser
+                        {
+                            Id = 7151382,
+                            Username = @"Mayuri Hana",
+                            Country = new Country
+                            {
+                                FullName = @"Thailand",
+                                FlagName = @"TH",
+                            },
+                        },
+                        Rank = ScoreRank.D,
+                        PP = 160,
+                        MaxCombo = 1234,
+                        TotalScore = 123456,
+                        Accuracy = 0.6543,
+                    },
+                }
+            };
+
+            foreach (var s in scores.Scores)
             {
                 s.Statistics = new Dictionary<string, int>
                 {
@@ -70,155 +282,15 @@ namespace osu.Game.Tests.Visual.Online
                 };
             }
 
-            AddStep("Load all scores", () =>
-            {
-                allScores.UserScore = null;
-                scoresContainer.Scores = allScores;
-            });
-            AddStep("Load null scores", () => scoresContainer.Scores = null);
-            AddStep("Load only one score", () => scoresContainer.Scores = oneScore);
-            AddStep("Load scores with my best", () =>
-            {
-                allScores.UserScore = myBestScore;
-                scoresContainer.Scores = allScores;
-            });
-
-            AddStep("Load scores with null my best position", () =>
-            {
-                allScores.UserScore = myBestScoreWithNullPosition;
-                scoresContainer.Scores = allScores;
-            });
+            return scores;
         }
 
-        private readonly APIScoresCollection allScores = new APIScoresCollection
-        {
-            Scores = new List<APIScore>
-            {
-                new APIScore
-                {
-                    Date = DateTimeOffset.Now,
-                    User = new APIUser
-                    {
-                        Id = 6602580,
-                        Username = @"waaiiru",
-                        Country = new Country
-                        {
-                            FullName = @"Spain",
-                            FlagName = @"ES",
-                        },
-                    },
-                    Mods = new[]
-                    {
-                        new APIMod { Acronym = new OsuModDoubleTime().Acronym },
-                        new APIMod { Acronym = new OsuModHidden().Acronym },
-                        new APIMod { Acronym = new OsuModFlashlight().Acronym },
-                        new APIMod { Acronym = new OsuModHardRock().Acronym },
-                    },
-                    Rank = ScoreRank.XH,
-                    PP = 200,
-                    MaxCombo = 1234,
-                    TotalScore = 1234567890,
-                    Accuracy = 1,
-                },
-                new APIScore
-                {
-                    Date = DateTimeOffset.Now,
-                    User = new APIUser
-                    {
-                        Id = 4608074,
-                        Username = @"Skycries",
-                        Country = new Country
-                        {
-                            FullName = @"Brazil",
-                            FlagName = @"BR",
-                        },
-                    },
-                    Mods = new[]
-                    {
-                        new APIMod { Acronym = new OsuModDoubleTime().Acronym },
-                        new APIMod { Acronym = new OsuModHidden().Acronym },
-                        new APIMod { Acronym = new OsuModFlashlight().Acronym },
-                    },
-                    Rank = ScoreRank.S,
-                    PP = 190,
-                    MaxCombo = 1234,
-                    TotalScore = 1234789,
-                    Accuracy = 0.9997,
-                },
-                new APIScore
-                {
-                    Date = DateTimeOffset.Now,
-                    User = new APIUser
-                    {
-                        Id = 1014222,
-                        Username = @"eLy",
-                        Country = new Country
-                        {
-                            FullName = @"Japan",
-                            FlagName = @"JP",
-                        },
-                    },
-                    Mods = new[]
-                    {
-                        new APIMod { Acronym = new OsuModDoubleTime().Acronym },
-                        new APIMod { Acronym = new OsuModHidden().Acronym },
-                    },
-                    Rank = ScoreRank.B,
-                    PP = 180,
-                    MaxCombo = 1234,
-                    TotalScore = 12345678,
-                    Accuracy = 0.9854,
-                },
-                new APIScore
-                {
-                    Date = DateTimeOffset.Now,
-                    User = new APIUser
-                    {
-                        Id = 1541390,
-                        Username = @"Toukai",
-                        Country = new Country
-                        {
-                            FullName = @"Canada",
-                            FlagName = @"CA",
-                        },
-                    },
-                    Mods = new[]
-                    {
-                        new APIMod { Acronym = new OsuModDoubleTime().Acronym },
-                    },
-                    Rank = ScoreRank.C,
-                    PP = 170,
-                    MaxCombo = 1234,
-                    TotalScore = 1234567,
-                    Accuracy = 0.8765,
-                },
-                new APIScore
-                {
-                    Date = DateTimeOffset.Now,
-                    User = new APIUser
-                    {
-                        Id = 7151382,
-                        Username = @"Mayuri Hana",
-                        Country = new Country
-                        {
-                            FullName = @"Thailand",
-                            FlagName = @"TH",
-                        },
-                    },
-                    Rank = ScoreRank.D,
-                    PP = 160,
-                    MaxCombo = 1234,
-                    TotalScore = 123456,
-                    Accuracy = 0.6543,
-                },
-            }
-        };
-
-        private readonly APIScoreWithPosition myBestScore = new APIScoreWithPosition
+        private APIScoreWithPosition createUserBest() => new APIScoreWithPosition
         {
             Score = new APIScore
             {
                 Date = DateTimeOffset.Now,
+                OnlineID = onlineID++,
                 User = new APIUser
                 {
                     Id = 7151382,
@@ -238,63 +310,6 @@ namespace osu.Game.Tests.Visual.Online
             Position = 1337,
         };
 
-        private readonly APIScoreWithPosition myBestScoreWithNullPosition = new APIScoreWithPosition
-        {
-            Score = new APIScore
-            {
-                Date = DateTimeOffset.Now,
-                User = new APIUser
-                {
-                    Id = 7151382,
-                    Username = @"Mayuri Hana",
-                    Country = new Country
-                    {
-                        FullName = @"Thailand",
-                        FlagName = @"TH",
-                    },
-                },
-                Rank = ScoreRank.D,
-                PP = 160,
-                MaxCombo = 1234,
-                TotalScore = 123456,
-                Accuracy = 0.6543,
-            },
-            Position = null,
-        };
-
-        private readonly APIScoresCollection oneScore = new APIScoresCollection
-        {
-            Scores = new List<APIScore>
-            {
-                new APIScore
-                {
-                    Date = DateTimeOffset.Now,
-                    User = new APIUser
-                    {
-                        Id = 6602580,
-                        Username = @"waaiiru",
-                        Country = new Country
-                        {
-                            FullName = @"Spain",
-                            FlagName = @"ES",
-                        },
-                    },
-                    Mods = new[]
-                    {
-                        new APIMod { Acronym = new OsuModDoubleTime().Acronym },
-                        new APIMod { Acronym = new OsuModHidden().Acronym },
-                        new APIMod { Acronym = new OsuModFlashlight().Acronym },
-                        new APIMod { Acronym = new OsuModHardRock().Acronym },
-                    },
-                    Rank = ScoreRank.XH,
-                    PP = 200,
-                    MaxCombo = 1234,
-                    TotalScore = 1234567890,
-                    Accuracy = 1,
-                }
-            }
-        };
-
         private class TestScoresContainer : ScoresContainer
         {
             public new APIScoresCollection Scores

From f6b9d36acffcbce19314e52bfb1eac45bbb1fc8a Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Mon, 17 Jan 2022 17:06:04 +0900
Subject: [PATCH 2250/5547] Remove unused using

---
 .../Visual/Navigation/TestSceneChangeAndUseGameplayBindings.cs   | 1 -
 1 file changed, 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneChangeAndUseGameplayBindings.cs b/osu.Game.Tests/Visual/Navigation/TestSceneChangeAndUseGameplayBindings.cs
index 7dda158ee1..7a44a7643d 100644
--- a/osu.Game.Tests/Visual/Navigation/TestSceneChangeAndUseGameplayBindings.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneChangeAndUseGameplayBindings.cs
@@ -14,7 +14,6 @@ using osu.Game.Overlays.Settings.Sections.Input;
 using osu.Game.Screens.Play;
 using osu.Game.Screens.Select;
 using osu.Game.Tests.Beatmaps.IO;
-using osu.Game.Tests.Database;
 using osuTK.Input;
 
 namespace osu.Game.Tests.Visual.Navigation

From 511a607599215e8981321e16df99c4a32918f67c Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Mon, 17 Jan 2022 18:28:17 +0800
Subject: [PATCH 2251/5547] Display performance breakdown in a tooltip

---
 .../Difficulty/ManiaPerformanceAttributes.cs  | 11 +++
 .../Difficulty/OsuPerformanceAttributes.cs    | 13 +++
 .../Difficulty/TaikoPerformanceAttributes.cs  | 10 +++
 .../Difficulty/PerformanceAttributes.cs       | 10 +++
 .../Difficulty/PerformanceDisplayAttribute.cs | 26 ++++++
 osu.Game/Scoring/ScorePerformanceCache.cs     |  9 ++-
 .../Statistics/PerformanceStatistic.cs        | 30 ++++---
 .../Statistics/PerformanceStatisticTooltip.cs | 80 +++++++++++++++++++
 8 files changed, 172 insertions(+), 17 deletions(-)
 create mode 100644 osu.Game/Rulesets/Difficulty/PerformanceDisplayAttribute.cs
 create mode 100644 osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatisticTooltip.cs

diff --git a/osu.Game.Rulesets.Mania/Difficulty/ManiaPerformanceAttributes.cs b/osu.Game.Rulesets.Mania/Difficulty/ManiaPerformanceAttributes.cs
index da9634ba47..0d3a53f3f3 100644
--- a/osu.Game.Rulesets.Mania/Difficulty/ManiaPerformanceAttributes.cs
+++ b/osu.Game.Rulesets.Mania/Difficulty/ManiaPerformanceAttributes.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 Newtonsoft.Json;
 using osu.Game.Rulesets.Difficulty;
 
@@ -16,5 +17,15 @@ namespace osu.Game.Rulesets.Mania.Difficulty
 
         [JsonProperty("scaled_score")]
         public double ScaledScore { get; set; }
+
+        public override IEnumerable<PerformanceDisplayAttribute> GetAttributesForDisplay()
+        {
+            foreach (var attribute in base.GetAttributesForDisplay())
+                yield return attribute;
+
+            yield return new PerformanceDisplayAttribute("Difficulty", Difficulty);
+            yield return new PerformanceDisplayAttribute("Accuracy", Accuracy);
+            yield return new PerformanceDisplayAttribute("Scaled Score", ScaledScore);
+        }
     }
 }
diff --git a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceAttributes.cs b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceAttributes.cs
index 6c7760d144..db7ca6af88 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceAttributes.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceAttributes.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 Newtonsoft.Json;
 using osu.Game.Rulesets.Difficulty;
 
@@ -22,5 +23,17 @@ namespace osu.Game.Rulesets.Osu.Difficulty
 
         [JsonProperty("effective_miss_count")]
         public double EffectiveMissCount { get; set; }
+
+        public override IEnumerable<PerformanceDisplayAttribute> GetAttributesForDisplay()
+        {
+            foreach (var attribute in base.GetAttributesForDisplay())
+                yield return attribute;
+
+            yield return new PerformanceDisplayAttribute("Aim", Aim);
+            yield return new PerformanceDisplayAttribute("Speed", Speed);
+            yield return new PerformanceDisplayAttribute("Accuracy", Accuracy);
+            yield return new PerformanceDisplayAttribute("Flashlight Bonus", Flashlight);
+            yield return new PerformanceDisplayAttribute("Effective Miss Count", EffectiveMissCount);
+        }
     }
 }
diff --git a/osu.Game.Rulesets.Taiko/Difficulty/TaikoPerformanceAttributes.cs b/osu.Game.Rulesets.Taiko/Difficulty/TaikoPerformanceAttributes.cs
index 80552880ea..efbcdd3703 100644
--- a/osu.Game.Rulesets.Taiko/Difficulty/TaikoPerformanceAttributes.cs
+++ b/osu.Game.Rulesets.Taiko/Difficulty/TaikoPerformanceAttributes.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 Newtonsoft.Json;
 using osu.Game.Rulesets.Difficulty;
 
@@ -13,5 +14,14 @@ namespace osu.Game.Rulesets.Taiko.Difficulty
 
         [JsonProperty("accuracy")]
         public double Accuracy { get; set; }
+
+        public override IEnumerable<PerformanceDisplayAttribute> GetAttributesForDisplay()
+        {
+            foreach (var attribute in base.GetAttributesForDisplay())
+                yield return attribute;
+
+            yield return new PerformanceDisplayAttribute("Difficulty", Difficulty);
+            yield return new PerformanceDisplayAttribute("Accuracy", Accuracy);
+        }
     }
 }
diff --git a/osu.Game/Rulesets/Difficulty/PerformanceAttributes.cs b/osu.Game/Rulesets/Difficulty/PerformanceAttributes.cs
index 025b38257c..98c6c75f6c 100644
--- a/osu.Game/Rulesets/Difficulty/PerformanceAttributes.cs
+++ b/osu.Game/Rulesets/Difficulty/PerformanceAttributes.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 Newtonsoft.Json;
 
 namespace osu.Game.Rulesets.Difficulty
@@ -12,5 +13,14 @@ namespace osu.Game.Rulesets.Difficulty
         /// </summary>
         [JsonProperty("pp")]
         public double Total { get; set; }
+
+        /// <summary>
+        /// Return a <see cref="PerformanceDisplayAttribute"/> for each attribute so that a performance breakdown can be displayed.
+        /// </summary>
+        /// <returns></returns>
+        public virtual IEnumerable<PerformanceDisplayAttribute> GetAttributesForDisplay()
+        {
+            yield return new PerformanceDisplayAttribute("Total", Total);
+        }
     }
 }
diff --git a/osu.Game/Rulesets/Difficulty/PerformanceDisplayAttribute.cs b/osu.Game/Rulesets/Difficulty/PerformanceDisplayAttribute.cs
new file mode 100644
index 0000000000..5bb505847e
--- /dev/null
+++ b/osu.Game/Rulesets/Difficulty/PerformanceDisplayAttribute.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.
+namespace osu.Game.Rulesets.Difficulty
+{
+    /// <summary>
+    /// Data for displaying a performance attribute to user. Includes a display name for clarity.
+    /// </summary>
+    public class PerformanceDisplayAttribute
+    {
+        /// <summary>
+        /// A custom display name for the attribute.
+        /// </summary>
+        public string DisplayName { get; }
+
+        /// <summary>
+        /// The associated attribute value.
+        /// </summary>
+        public double Value { get; }
+
+        public PerformanceDisplayAttribute(string displayName, double value)
+        {
+            DisplayName = displayName;
+            Value = value;
+        }
+    }
+}
diff --git a/osu.Game/Scoring/ScorePerformanceCache.cs b/osu.Game/Scoring/ScorePerformanceCache.cs
index b855343505..a428a66aae 100644
--- a/osu.Game/Scoring/ScorePerformanceCache.cs
+++ b/osu.Game/Scoring/ScorePerformanceCache.cs
@@ -8,6 +8,7 @@ using JetBrains.Annotations;
 using osu.Framework.Allocation;
 using osu.Game.Beatmaps;
 using osu.Game.Database;
+using osu.Game.Rulesets.Difficulty;
 
 namespace osu.Game.Scoring
 {
@@ -15,7 +16,7 @@ namespace osu.Game.Scoring
     /// A component which performs and acts as a central cache for performance calculations of locally databased scores.
     /// Currently not persisted between game sessions.
     /// </summary>
-    public class ScorePerformanceCache : MemoryCachingComponent<ScorePerformanceCache.PerformanceCacheLookup, double?>
+    public class ScorePerformanceCache : MemoryCachingComponent<ScorePerformanceCache.PerformanceCacheLookup, PerformanceAttributes>
     {
         [Resolved]
         private BeatmapDifficultyCache difficultyCache { get; set; }
@@ -27,10 +28,10 @@ namespace osu.Game.Scoring
         /// </summary>
         /// <param name="score">The score to do the calculation on. </param>
         /// <param name="token">An optional <see cref="CancellationToken"/> to cancel the operation.</param>
-        public Task<double?> CalculatePerformanceAsync([NotNull] ScoreInfo score, CancellationToken token = default) =>
+        public Task<PerformanceAttributes> CalculatePerformanceAsync([NotNull] ScoreInfo score, CancellationToken token = default) =>
             GetAsync(new PerformanceCacheLookup(score), token);
 
-        protected override async Task<double?> ComputeValueAsync(PerformanceCacheLookup lookup, CancellationToken token = default)
+        protected override async Task<PerformanceAttributes> ComputeValueAsync(PerformanceCacheLookup lookup, CancellationToken token = default)
         {
             var score = lookup.ScoreInfo;
 
@@ -44,7 +45,7 @@ namespace osu.Game.Scoring
 
             var calculator = score.Ruleset.CreateInstance().CreatePerformanceCalculator(attributes.Value.Attributes, score);
 
-            return calculator?.Calculate().Total;
+            return calculator?.Calculate();
         }
 
         public readonly struct PerformanceCacheLookup
diff --git a/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatistic.cs b/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatistic.cs
index d6e4cfbe51..888552e568 100644
--- a/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatistic.cs
+++ b/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatistic.cs
@@ -7,12 +7,14 @@ using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Extensions;
 using osu.Framework.Graphics;
+using osu.Framework.Graphics.Cursor;
 using osu.Game.Graphics.UserInterface;
+using osu.Game.Rulesets.Difficulty;
 using osu.Game.Scoring;
 
 namespace osu.Game.Screens.Ranking.Expanded.Statistics
 {
-    public class PerformanceStatistic : StatisticDisplay
+    public class PerformanceStatistic : StatisticDisplay, IHasCustomTooltip<PerformanceAttributes>
     {
         private readonly ScoreInfo score;
 
@@ -22,6 +24,8 @@ namespace osu.Game.Screens.Ranking.Expanded.Statistics
 
         private RollingCounter<int> counter;
 
+        private PerformanceAttributes attributes;
+
         public PerformanceStatistic(ScoreInfo score)
             : base("PP")
         {
@@ -31,21 +35,17 @@ namespace osu.Game.Screens.Ranking.Expanded.Statistics
         [BackgroundDependencyLoader]
         private void load(ScorePerformanceCache performanceCache)
         {
-            if (score.PP.HasValue)
-            {
-                setPerformanceValue(score.PP.Value);
-            }
-            else
-            {
-                performanceCache.CalculatePerformanceAsync(score, cancellationTokenSource.Token)
-                                .ContinueWith(t => Schedule(() => setPerformanceValue(t.GetResultSafely())), cancellationTokenSource.Token);
-            }
+            performanceCache.CalculatePerformanceAsync(score, cancellationTokenSource.Token)
+                            .ContinueWith(t => Schedule(() => setPerformanceValue(t.GetResultSafely())), cancellationTokenSource.Token);
         }
 
-        private void setPerformanceValue(double? pp)
+        private void setPerformanceValue(PerformanceAttributes pp)
         {
-            if (pp.HasValue)
-                performance.Value = (int)Math.Round(pp.Value, MidpointRounding.AwayFromZero);
+            if (pp != null)
+            {
+                attributes = pp;
+                performance.Value = (int)Math.Round(pp.Total, MidpointRounding.AwayFromZero);
+            }
         }
 
         public override void Appear()
@@ -65,5 +65,9 @@ namespace osu.Game.Screens.Ranking.Expanded.Statistics
             Anchor = Anchor.TopCentre,
             Origin = Anchor.TopCentre
         };
+
+        public ITooltip<PerformanceAttributes> GetCustomTooltip() => new PerformanceStatisticTooltip();
+
+        public PerformanceAttributes TooltipContent => attributes;
     }
 }
diff --git a/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatisticTooltip.cs b/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatisticTooltip.cs
new file mode 100644
index 0000000000..32ba231e42
--- /dev/null
+++ b/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatisticTooltip.cs
@@ -0,0 +1,80 @@
+// 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.Cursor;
+using osu.Framework.Graphics.Shapes;
+using osu.Game.Graphics;
+using osu.Game.Graphics.Sprites;
+using osu.Game.Rulesets.Difficulty;
+using osuTK;
+
+namespace osu.Game.Screens.Ranking.Expanded.Statistics
+{
+    public class PerformanceStatisticTooltip : VisibilityContainer, ITooltip<PerformanceAttributes>
+    {
+        private readonly Box background;
+
+        protected override Container<Drawable> Content { get; }
+
+        public PerformanceStatisticTooltip()
+        {
+            AutoSizeAxes = Axes.Both;
+            Masking = true;
+            CornerRadius = 5;
+
+            InternalChildren = new Drawable[]
+            {
+                background = new Box
+                {
+                    RelativeSizeAxes = Axes.Both
+                },
+                Content = new FillFlowContainer
+                {
+                    AutoSizeAxes = Axes.Both,
+                    Direction = FillDirection.Vertical,
+                    Padding = new MarginPadding { Left = 10, Right = 10, Top = 5, Bottom = 5 }
+                },
+            };
+        }
+
+        [BackgroundDependencyLoader]
+        private void load(OsuColour colours)
+        {
+            background.Colour = colours.Gray3;
+        }
+
+        protected override void PopIn() => this.FadeIn(200, Easing.OutQuint);
+        protected override void PopOut() => this.FadeOut(200, Easing.OutQuint);
+
+        private PerformanceAttributes lastAttributes;
+
+        public void SetContent(PerformanceAttributes attributes)
+        {
+            if (attributes == lastAttributes)
+                return;
+
+            lastAttributes = attributes;
+
+            UpdateDisplay(attributes);
+        }
+
+        protected virtual void UpdateDisplay(PerformanceAttributes attributes)
+        {
+            Content.Clear();
+
+            foreach (PerformanceDisplayAttribute attr in attributes.GetAttributesForDisplay())
+            {
+                Content.Add(new OsuSpriteText
+                {
+                    Font = OsuFont.GetFont(weight: FontWeight.Regular),
+                    Text = $"{attr.DisplayName}: {(int)Math.Round(attr.Value, MidpointRounding.AwayFromZero)}"
+                });
+            }
+        }
+
+        public void Move(Vector2 pos) => Position = pos;
+    }
+}

From 0ba0b5f11abb083bcdf29f41b8b229fc160b5e4b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 17 Jan 2022 19:45:32 +0900
Subject: [PATCH 2252/5547] Fix test step not being `until` when it needs to be

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

diff --git a/osu.Game.Tests/Visual/Online/TestSceneScoresContainer.cs b/osu.Game.Tests/Visual/Online/TestSceneScoresContainer.cs
index d4af01f772..8a304110dd 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneScoresContainer.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneScoresContainer.cs
@@ -135,7 +135,7 @@ namespace osu.Game.Tests.Visual.Online
                 scoresContainer.Scores = allScores;
             });
 
-            AddAssert("best score not displayed", () => scoresContainer.ChildrenOfType<DrawableTopScore>().Count() == 1);
+            AddUntilStep("best score not displayed", () => scoresContainer.ChildrenOfType<DrawableTopScore>().Count() == 1);
         }
 
         private int onlineID = 1;

From 85c60bfc2d50b1c5b27348c7a8e821fbeca3b340 Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Mon, 17 Jan 2022 20:36:18 +0800
Subject: [PATCH 2253/5547] Improve tooltip design

---
 .../Statistics/PerformanceStatisticTooltip.cs | 34 +++++++++++++++++--
 1 file changed, 31 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatisticTooltip.cs b/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatisticTooltip.cs
index 32ba231e42..618a94a309 100644
--- a/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatisticTooltip.cs
+++ b/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatisticTooltip.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.Globalization;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
@@ -16,6 +17,7 @@ namespace osu.Game.Screens.Ranking.Expanded.Statistics
     public class PerformanceStatisticTooltip : VisibilityContainer, ITooltip<PerformanceAttributes>
     {
         private readonly Box background;
+        private Colour4 textColor;
 
         protected override Container<Drawable> Content { get; }
 
@@ -44,6 +46,7 @@ namespace osu.Game.Screens.Ranking.Expanded.Statistics
         private void load(OsuColour colours)
         {
             background.Colour = colours.Gray3;
+            textColor = colours.BlueLighter;
         }
 
         protected override void PopIn() => this.FadeIn(200, Easing.OutQuint);
@@ -67,10 +70,35 @@ namespace osu.Game.Screens.Ranking.Expanded.Statistics
 
             foreach (PerformanceDisplayAttribute attr in attributes.GetAttributesForDisplay())
             {
-                Content.Add(new OsuSpriteText
+                Content.Add(new GridContainer
                 {
-                    Font = OsuFont.GetFont(weight: FontWeight.Regular),
-                    Text = $"{attr.DisplayName}: {(int)Math.Round(attr.Value, MidpointRounding.AwayFromZero)}"
+                    AutoSizeAxes = Axes.Both,
+                    ColumnDimensions = new[]
+                    {
+                        new Dimension(GridSizeMode.Absolute, 140),
+                        new Dimension(GridSizeMode.AutoSize)
+                    },
+                    RowDimensions = new[]
+                    {
+                        new Dimension(GridSizeMode.AutoSize)
+                    },
+                    Content = new[]
+                    {
+                        new Drawable[]
+                        {
+                            new OsuSpriteText
+                            {
+                                Font = OsuFont.GetFont(weight: FontWeight.Regular),
+                                Text = attr.DisplayName,
+                                Colour = textColor
+                            },
+                            new OsuSpriteText
+                            {
+                                Font = OsuFont.GetFont(weight: FontWeight.SemiBold),
+                                Text = ((int)Math.Round(attr.Value, MidpointRounding.AwayFromZero)).ToString(CultureInfo.CurrentCulture)
+                            }
+                        }
+                    }
                 });
             }
         }

From d014fef179a9248afc4f4b09237fa84fb16beeaf Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Mon, 17 Jan 2022 20:36:36 +0800
Subject: [PATCH 2254/5547] Hide confusing attributes

---
 osu.Game.Rulesets.Mania/Difficulty/ManiaPerformanceAttributes.cs | 1 -
 osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceAttributes.cs     | 1 -
 osu.Game/Rulesets/Difficulty/PerformanceAttributes.cs            | 1 +
 3 files changed, 1 insertion(+), 2 deletions(-)

diff --git a/osu.Game.Rulesets.Mania/Difficulty/ManiaPerformanceAttributes.cs b/osu.Game.Rulesets.Mania/Difficulty/ManiaPerformanceAttributes.cs
index 0d3a53f3f3..48895cd389 100644
--- a/osu.Game.Rulesets.Mania/Difficulty/ManiaPerformanceAttributes.cs
+++ b/osu.Game.Rulesets.Mania/Difficulty/ManiaPerformanceAttributes.cs
@@ -25,7 +25,6 @@ namespace osu.Game.Rulesets.Mania.Difficulty
 
             yield return new PerformanceDisplayAttribute("Difficulty", Difficulty);
             yield return new PerformanceDisplayAttribute("Accuracy", Accuracy);
-            yield return new PerformanceDisplayAttribute("Scaled Score", ScaledScore);
         }
     }
 }
diff --git a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceAttributes.cs b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceAttributes.cs
index db7ca6af88..0a685b7cd6 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceAttributes.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceAttributes.cs
@@ -33,7 +33,6 @@ namespace osu.Game.Rulesets.Osu.Difficulty
             yield return new PerformanceDisplayAttribute("Speed", Speed);
             yield return new PerformanceDisplayAttribute("Accuracy", Accuracy);
             yield return new PerformanceDisplayAttribute("Flashlight Bonus", Flashlight);
-            yield return new PerformanceDisplayAttribute("Effective Miss Count", EffectiveMissCount);
         }
     }
 }
diff --git a/osu.Game/Rulesets/Difficulty/PerformanceAttributes.cs b/osu.Game/Rulesets/Difficulty/PerformanceAttributes.cs
index 98c6c75f6c..ee1868ecff 100644
--- a/osu.Game/Rulesets/Difficulty/PerformanceAttributes.cs
+++ b/osu.Game/Rulesets/Difficulty/PerformanceAttributes.cs
@@ -16,6 +16,7 @@ namespace osu.Game.Rulesets.Difficulty
 
         /// <summary>
         /// Return a <see cref="PerformanceDisplayAttribute"/> for each attribute so that a performance breakdown can be displayed.
+        /// Some attributes may be omitted if they are not meant for display.
         /// </summary>
         /// <returns></returns>
         public virtual IEnumerable<PerformanceDisplayAttribute> GetAttributesForDisplay()

From b81fc675e89b6df6161e18a45f6ae392fdbd183a Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Mon, 17 Jan 2022 20:45:25 +0800
Subject: [PATCH 2255/5547] Include PropertyName in PerformanceDisplayAttribute

---
 .../Difficulty/ManiaPerformanceAttributes.cs              | 4 ++--
 .../Difficulty/OsuPerformanceAttributes.cs                | 8 ++++----
 .../Difficulty/TaikoPerformanceAttributes.cs              | 4 ++--
 osu.Game/Rulesets/Difficulty/PerformanceAttributes.cs     | 2 +-
 .../Rulesets/Difficulty/PerformanceDisplayAttribute.cs    | 8 +++++++-
 5 files changed, 16 insertions(+), 10 deletions(-)

diff --git a/osu.Game.Rulesets.Mania/Difficulty/ManiaPerformanceAttributes.cs b/osu.Game.Rulesets.Mania/Difficulty/ManiaPerformanceAttributes.cs
index 48895cd389..17c864a268 100644
--- a/osu.Game.Rulesets.Mania/Difficulty/ManiaPerformanceAttributes.cs
+++ b/osu.Game.Rulesets.Mania/Difficulty/ManiaPerformanceAttributes.cs
@@ -23,8 +23,8 @@ namespace osu.Game.Rulesets.Mania.Difficulty
             foreach (var attribute in base.GetAttributesForDisplay())
                 yield return attribute;
 
-            yield return new PerformanceDisplayAttribute("Difficulty", Difficulty);
-            yield return new PerformanceDisplayAttribute("Accuracy", Accuracy);
+            yield return new PerformanceDisplayAttribute(nameof(Difficulty), "Difficulty", Difficulty);
+            yield return new PerformanceDisplayAttribute(nameof(Accuracy), "Accuracy", Accuracy);
         }
     }
 }
diff --git a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceAttributes.cs b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceAttributes.cs
index 0a685b7cd6..0aeaf7669f 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceAttributes.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceAttributes.cs
@@ -29,10 +29,10 @@ namespace osu.Game.Rulesets.Osu.Difficulty
             foreach (var attribute in base.GetAttributesForDisplay())
                 yield return attribute;
 
-            yield return new PerformanceDisplayAttribute("Aim", Aim);
-            yield return new PerformanceDisplayAttribute("Speed", Speed);
-            yield return new PerformanceDisplayAttribute("Accuracy", Accuracy);
-            yield return new PerformanceDisplayAttribute("Flashlight Bonus", Flashlight);
+            yield return new PerformanceDisplayAttribute(nameof(Aim), "Aim", Aim);
+            yield return new PerformanceDisplayAttribute(nameof(Speed), "Speed", Speed);
+            yield return new PerformanceDisplayAttribute(nameof(Accuracy), "Accuracy", Accuracy);
+            yield return new PerformanceDisplayAttribute(nameof(Flashlight), "Flashlight Bonus", Flashlight);
         }
     }
 }
diff --git a/osu.Game.Rulesets.Taiko/Difficulty/TaikoPerformanceAttributes.cs b/osu.Game.Rulesets.Taiko/Difficulty/TaikoPerformanceAttributes.cs
index efbcdd3703..fa5c0202dd 100644
--- a/osu.Game.Rulesets.Taiko/Difficulty/TaikoPerformanceAttributes.cs
+++ b/osu.Game.Rulesets.Taiko/Difficulty/TaikoPerformanceAttributes.cs
@@ -20,8 +20,8 @@ namespace osu.Game.Rulesets.Taiko.Difficulty
             foreach (var attribute in base.GetAttributesForDisplay())
                 yield return attribute;
 
-            yield return new PerformanceDisplayAttribute("Difficulty", Difficulty);
-            yield return new PerformanceDisplayAttribute("Accuracy", Accuracy);
+            yield return new PerformanceDisplayAttribute(nameof(Difficulty), "Difficulty", Difficulty);
+            yield return new PerformanceDisplayAttribute(nameof(Accuracy), "Accuracy", Accuracy);
         }
     }
 }
diff --git a/osu.Game/Rulesets/Difficulty/PerformanceAttributes.cs b/osu.Game/Rulesets/Difficulty/PerformanceAttributes.cs
index ee1868ecff..9bdb5f8f6f 100644
--- a/osu.Game/Rulesets/Difficulty/PerformanceAttributes.cs
+++ b/osu.Game/Rulesets/Difficulty/PerformanceAttributes.cs
@@ -21,7 +21,7 @@ namespace osu.Game.Rulesets.Difficulty
         /// <returns></returns>
         public virtual IEnumerable<PerformanceDisplayAttribute> GetAttributesForDisplay()
         {
-            yield return new PerformanceDisplayAttribute("Total", Total);
+            yield return new PerformanceDisplayAttribute(nameof(Total), "Total", Total);
         }
     }
 }
diff --git a/osu.Game/Rulesets/Difficulty/PerformanceDisplayAttribute.cs b/osu.Game/Rulesets/Difficulty/PerformanceDisplayAttribute.cs
index 5bb505847e..e95cb03053 100644
--- a/osu.Game/Rulesets/Difficulty/PerformanceDisplayAttribute.cs
+++ b/osu.Game/Rulesets/Difficulty/PerformanceDisplayAttribute.cs
@@ -7,6 +7,11 @@ namespace osu.Game.Rulesets.Difficulty
     /// </summary>
     public class PerformanceDisplayAttribute
     {
+        /// <summary>
+        /// Name of the attribute property in <see cref="PerformanceAttributes"/>.
+        /// </summary>
+        public string PropertyName { get; }
+
         /// <summary>
         /// A custom display name for the attribute.
         /// </summary>
@@ -17,8 +22,9 @@ namespace osu.Game.Rulesets.Difficulty
         /// </summary>
         public double Value { get; }
 
-        public PerformanceDisplayAttribute(string displayName, double value)
+        public PerformanceDisplayAttribute(string propertyName, string displayName, double value)
         {
+            PropertyName = propertyName;
             DisplayName = displayName;
             Value = value;
         }

From c49cd60487584fd8c2d6e208bc9158942e6ce519 Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Mon, 17 Jan 2022 21:26:55 +0800
Subject: [PATCH 2256/5547] Add bar chart to tooltip

---
 .../Statistics/PerformanceStatisticTooltip.cs | 108 ++++++++++++------
 1 file changed, 74 insertions(+), 34 deletions(-)

diff --git a/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatisticTooltip.cs b/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatisticTooltip.cs
index 618a94a309..ab7156e0c5 100644
--- a/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatisticTooltip.cs
+++ b/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatisticTooltip.cs
@@ -2,22 +2,27 @@
 // See the LICENCE file in the repository root for full licence text.
 using System;
 using System.Globalization;
+using System.Linq;
 using osu.Framework.Allocation;
+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.Game.Graphics;
 using osu.Game.Graphics.Sprites;
+using osu.Game.Graphics.UserInterface;
 using osu.Game.Rulesets.Difficulty;
 using osuTK;
+using osuTK.Graphics;
 
 namespace osu.Game.Screens.Ranking.Expanded.Statistics
 {
     public class PerformanceStatisticTooltip : VisibilityContainer, ITooltip<PerformanceAttributes>
     {
         private readonly Box background;
-        private Colour4 textColor;
+        private Colour4 totalColour;
+        private Colour4 textColour;
 
         protected override Container<Drawable> Content { get; }
 
@@ -46,10 +51,16 @@ namespace osu.Game.Screens.Ranking.Expanded.Statistics
         private void load(OsuColour colours)
         {
             background.Colour = colours.Gray3;
-            textColor = colours.BlueLighter;
+            totalColour = colours.Blue;
+            textColour = colours.BlueLighter;
+        }
+
+        protected override void PopIn()
+        {
+            if (lastAttributes.GetAttributesForDisplay().Count() > 1)
+                this.FadeIn(200, Easing.OutQuint);
         }
 
-        protected override void PopIn() => this.FadeIn(200, Easing.OutQuint);
         protected override void PopOut() => this.FadeOut(200, Easing.OutQuint);
 
         private PerformanceAttributes lastAttributes;
@@ -64,42 +75,71 @@ namespace osu.Game.Screens.Ranking.Expanded.Statistics
             UpdateDisplay(attributes);
         }
 
+        private Drawable createAttributeItem(PerformanceDisplayAttribute attribute, double attributeSum)
+        {
+            bool isTotal = attribute.PropertyName == nameof(PerformanceAttributes.Total);
+            return new GridContainer
+            {
+                AutoSizeAxes = Axes.Both,
+                ColumnDimensions = new[]
+                {
+                    new Dimension(GridSizeMode.Absolute, 110),
+                    new Dimension(GridSizeMode.Absolute, 140),
+                    new Dimension(GridSizeMode.AutoSize)
+                },
+                RowDimensions = new[]
+                {
+                    new Dimension(GridSizeMode.AutoSize)
+                },
+                Content = new[]
+                {
+                    new Drawable[]
+                    {
+                        new OsuSpriteText
+                        {
+                            Origin = Anchor.CentreLeft,
+                            Anchor = Anchor.CentreLeft,
+                            Font = OsuFont.GetFont(weight: FontWeight.Regular),
+                            Text = attribute.DisplayName,
+                            Colour = isTotal ? totalColour : textColour
+                        },
+                        new Bar
+                        {
+                            Alpha = isTotal ? 0 : 1,
+                            Origin = Anchor.CentreLeft,
+                            Anchor = Anchor.CentreLeft,
+                            Width = 130,
+                            Height = 5,
+                            BackgroundColour = Color4.White.Opacity(0.5f),
+                            Length = (float)(attribute.Value / attributeSum),
+                            Margin = new MarginPadding { Left = 5, Right = 5 }
+                        },
+                        new OsuSpriteText
+                        {
+                            Origin = Anchor.CentreLeft,
+                            Anchor = Anchor.CentreLeft,
+                            Font = OsuFont.GetFont(weight: FontWeight.SemiBold),
+                            Text = ((int)Math.Round(attribute.Value, MidpointRounding.AwayFromZero)).ToString(CultureInfo.CurrentCulture),
+                            Colour = isTotal ? totalColour : textColour
+                        }
+                    }
+                }
+            };
+        }
+
         protected virtual void UpdateDisplay(PerformanceAttributes attributes)
         {
             Content.Clear();
 
-            foreach (PerformanceDisplayAttribute attr in attributes.GetAttributesForDisplay())
+            var displayAttributes = attributes.GetAttributesForDisplay();
+
+            double attributeSum = displayAttributes
+                                  .Where(attr => attr.PropertyName != nameof(PerformanceAttributes.Total))
+                                  .Sum(attr => attr.Value);
+
+            foreach (PerformanceDisplayAttribute attr in displayAttributes)
             {
-                Content.Add(new GridContainer
-                {
-                    AutoSizeAxes = Axes.Both,
-                    ColumnDimensions = new[]
-                    {
-                        new Dimension(GridSizeMode.Absolute, 140),
-                        new Dimension(GridSizeMode.AutoSize)
-                    },
-                    RowDimensions = new[]
-                    {
-                        new Dimension(GridSizeMode.AutoSize)
-                    },
-                    Content = new[]
-                    {
-                        new Drawable[]
-                        {
-                            new OsuSpriteText
-                            {
-                                Font = OsuFont.GetFont(weight: FontWeight.Regular),
-                                Text = attr.DisplayName,
-                                Colour = textColor
-                            },
-                            new OsuSpriteText
-                            {
-                                Font = OsuFont.GetFont(weight: FontWeight.SemiBold),
-                                Text = ((int)Math.Round(attr.Value, MidpointRounding.AwayFromZero)).ToString(CultureInfo.CurrentCulture)
-                            }
-                        }
-                    }
-                });
+                Content.Add(createAttributeItem(attr, attributeSum));
             }
         }
 

From eddf45329445f8b43cb37b65cbeaa3d3bce0f332 Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Mon, 17 Jan 2022 21:32:13 +0800
Subject: [PATCH 2257/5547] Fix code quality issues

---
 osu.Game/Rulesets/Difficulty/PerformanceDisplayAttribute.cs | 1 +
 .../Ranking/Expanded/Statistics/PerformanceStatistic.cs     | 6 ++----
 .../Expanded/Statistics/PerformanceStatisticTooltip.cs      | 1 +
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Rulesets/Difficulty/PerformanceDisplayAttribute.cs b/osu.Game/Rulesets/Difficulty/PerformanceDisplayAttribute.cs
index e95cb03053..7958bc174e 100644
--- a/osu.Game/Rulesets/Difficulty/PerformanceDisplayAttribute.cs
+++ b/osu.Game/Rulesets/Difficulty/PerformanceDisplayAttribute.cs
@@ -1,5 +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.
+
 namespace osu.Game.Rulesets.Difficulty
 {
     /// <summary>
diff --git a/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatistic.cs b/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatistic.cs
index 888552e568..4fd6964a68 100644
--- a/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatistic.cs
+++ b/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatistic.cs
@@ -24,8 +24,6 @@ namespace osu.Game.Screens.Ranking.Expanded.Statistics
 
         private RollingCounter<int> counter;
 
-        private PerformanceAttributes attributes;
-
         public PerformanceStatistic(ScoreInfo score)
             : base("PP")
         {
@@ -43,7 +41,7 @@ namespace osu.Game.Screens.Ranking.Expanded.Statistics
         {
             if (pp != null)
             {
-                attributes = pp;
+                TooltipContent = pp;
                 performance.Value = (int)Math.Round(pp.Total, MidpointRounding.AwayFromZero);
             }
         }
@@ -68,6 +66,6 @@ namespace osu.Game.Screens.Ranking.Expanded.Statistics
 
         public ITooltip<PerformanceAttributes> GetCustomTooltip() => new PerformanceStatisticTooltip();
 
-        public PerformanceAttributes TooltipContent => attributes;
+        public PerformanceAttributes TooltipContent { get; private set; }
     }
 }
diff --git a/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatisticTooltip.cs b/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatisticTooltip.cs
index ab7156e0c5..e0bbf91381 100644
--- a/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatisticTooltip.cs
+++ b/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatisticTooltip.cs
@@ -1,5 +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.Globalization;
 using System.Linq;

From 83387cb00bcb89b9974b8bcc223b56f78cb72f3e Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Mon, 17 Jan 2022 21:41:17 +0800
Subject: [PATCH 2258/5547] Add a comment

---
 .../Ranking/Expanded/Statistics/PerformanceStatisticTooltip.cs   | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatisticTooltip.cs b/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatisticTooltip.cs
index e0bbf91381..deef30124c 100644
--- a/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatisticTooltip.cs
+++ b/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatisticTooltip.cs
@@ -58,6 +58,7 @@ namespace osu.Game.Screens.Ranking.Expanded.Statistics
 
         protected override void PopIn()
         {
+            // Don't display the tooltip if "Total" is the only item
             if (lastAttributes.GetAttributesForDisplay().Count() > 1)
                 this.FadeIn(200, Easing.OutQuint);
         }

From bd308ca38c5afbddbc18cebaa4e8effa1d4cca90 Mon Sep 17 00:00:00 2001
From: mk-56 <darioheadleysilva@gmail.com>
Date: Mon, 17 Jan 2022 15:15:25 +0100
Subject: [PATCH 2259/5547] Cleanup

---
 .../Mods/ManiaModFlashlight.cs                    |  2 --
 osu.Game.Rulesets.Osu/Mods/OsuModFlashlight.cs    | 15 ++-------------
 .../Mods/TaikoModFlashlight.cs                    |  1 -
 3 files changed, 2 insertions(+), 16 deletions(-)

diff --git a/osu.Game.Rulesets.Mania/Mods/ManiaModFlashlight.cs b/osu.Game.Rulesets.Mania/Mods/ManiaModFlashlight.cs
index 676b5f3842..4fff736c57 100644
--- a/osu.Game.Rulesets.Mania/Mods/ManiaModFlashlight.cs
+++ b/osu.Game.Rulesets.Mania/Mods/ManiaModFlashlight.cs
@@ -55,5 +55,3 @@ namespace osu.Game.Rulesets.Mania.Mods
         }
     }
 }
-
-
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModFlashlight.cs b/osu.Game.Rulesets.Osu/Mods/OsuModFlashlight.cs
index f15527460c..f381d14ffe 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModFlashlight.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModFlashlight.cs
@@ -27,6 +27,8 @@ namespace osu.Game.Rulesets.Osu.Mods
 
         private const double default_follow_delay = 120;
 
+
+
         private OsuFlashlight flashlight;
 
         public override Flashlight CreateFlashlight() => flashlight = new OsuFlashlight(ChangeRadius.Value, InitialRadius.Value, FollowDelay.Value);
@@ -77,19 +79,6 @@ namespace osu.Game.Rulesets.Osu.Mods
                 return base.OnMouseMove(e);
             }
 
-            private float getSizeFor(int combo)
-            {
-                if (ChangeRadius)
-                {
-                    if (combo > 200)
-                        return InitialRadius * 0.8f;
-                    else if (combo > 100)
-                        return InitialRadius * 0.9f;
-                }
-
-                return InitialRadius;
-            }
-
             protected override void OnComboChange(ValueChangedEvent<int> e)
             {
                 this.TransformTo(nameof(FlashlightSize), new Vector2(0, GetRadiusFor(e.NewValue)), FLASHLIGHT_FADE_DURATION);
diff --git a/osu.Game.Rulesets.Taiko/Mods/TaikoModFlashlight.cs b/osu.Game.Rulesets.Taiko/Mods/TaikoModFlashlight.cs
index 29f29863c0..76f7c45b75 100644
--- a/osu.Game.Rulesets.Taiko/Mods/TaikoModFlashlight.cs
+++ b/osu.Game.Rulesets.Taiko/Mods/TaikoModFlashlight.cs
@@ -48,7 +48,6 @@ namespace osu.Game.Rulesets.Taiko.Mods
             private Vector2 getSizeFor(int combo)
             {
                 // Preserve flashlight size through the playfield's aspect adjustment.
-                // return new Vector2(0, size * taikoPlayfield.DrawHeight / TaikoPlayfield.DEFAULT_HEIGHT);
                 return new Vector2(0, GetRadiusFor(combo) * taikoPlayfield.DrawHeight / TaikoPlayfield.DEFAULT_HEIGHT);
             }
 

From 125439d17760b6ad2ecba6d5ac0a25d404cd5d9a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 18 Jan 2022 11:09:26 +0900
Subject: [PATCH 2260/5547] Update all (non-NET6) nuget packages

---
 .../osu.Game.Rulesets.EmptyFreeform.Tests.csproj          | 2 +-
 .../osu.Game.Rulesets.Pippidon.Tests.csproj               | 2 +-
 .../osu.Game.Rulesets.EmptyScrolling.Tests.csproj         | 2 +-
 .../osu.Game.Rulesets.Pippidon.Tests.csproj               | 2 +-
 osu.Game.Benchmarks/osu.Game.Benchmarks.csproj            | 2 +-
 .../osu.Game.Rulesets.Catch.Tests.csproj                  | 2 +-
 .../osu.Game.Rulesets.Mania.Tests.csproj                  | 2 +-
 .../osu.Game.Rulesets.Osu.Tests.csproj                    | 2 +-
 .../osu.Game.Rulesets.Taiko.Tests.csproj                  | 2 +-
 osu.Game.Tests/osu.Game.Tests.csproj                      | 2 +-
 .../osu.Game.Tournament.Tests.csproj                      | 2 +-
 osu.Game/osu.Game.csproj                                  | 8 ++++----
 12 files changed, 15 insertions(+), 15 deletions(-)

diff --git a/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform.Tests/osu.Game.Rulesets.EmptyFreeform.Tests.csproj b/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform.Tests/osu.Game.Rulesets.EmptyFreeform.Tests.csproj
index 3c6aaa39ca..a7078f1c09 100644
--- a/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform.Tests/osu.Game.Rulesets.EmptyFreeform.Tests.csproj
+++ b/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform.Tests/osu.Game.Rulesets.EmptyFreeform.Tests.csproj
@@ -12,7 +12,7 @@
     <PackageReference Include="Appveyor.TestLogger" Version="2.0.0" />
     <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.0.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
-    <PackageReference Include="NUnit3TestAdapter" Version="4.1.0" />
+    <PackageReference Include="NUnit3TestAdapter" Version="4.2.0" />
     <PackageReference Update="Microsoft.EntityFrameworkCore.Sqlite" Version="2.1.4" />
   </ItemGroup>
   <ItemGroup>
diff --git a/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon.Tests/osu.Game.Rulesets.Pippidon.Tests.csproj b/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon.Tests/osu.Game.Rulesets.Pippidon.Tests.csproj
index 0719dd30df..c133b0e3f8 100644
--- a/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon.Tests/osu.Game.Rulesets.Pippidon.Tests.csproj
+++ b/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon.Tests/osu.Game.Rulesets.Pippidon.Tests.csproj
@@ -12,7 +12,7 @@
     <PackageReference Include="Appveyor.TestLogger" Version="2.0.0" />
     <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.0.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
-    <PackageReference Include="NUnit3TestAdapter" Version="4.1.0" />
+    <PackageReference Include="NUnit3TestAdapter" Version="4.2.0" />
     <PackageReference Update="Microsoft.EntityFrameworkCore.Sqlite" Version="2.1.4" />
   </ItemGroup>
   <ItemGroup>
diff --git a/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling.Tests/osu.Game.Rulesets.EmptyScrolling.Tests.csproj b/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling.Tests/osu.Game.Rulesets.EmptyScrolling.Tests.csproj
index d0db43cc81..92b48470e8 100644
--- a/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling.Tests/osu.Game.Rulesets.EmptyScrolling.Tests.csproj
+++ b/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling.Tests/osu.Game.Rulesets.EmptyScrolling.Tests.csproj
@@ -12,7 +12,7 @@
     <PackageReference Include="Appveyor.TestLogger" Version="2.0.0" />
     <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.0.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
-    <PackageReference Include="NUnit3TestAdapter" Version="4.1.0" />
+    <PackageReference Include="NUnit3TestAdapter" Version="4.2.0" />
     <PackageReference Update="Microsoft.EntityFrameworkCore.Sqlite" Version="2.1.4" />
   </ItemGroup>
   <ItemGroup>
diff --git a/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon.Tests/osu.Game.Rulesets.Pippidon.Tests.csproj b/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon.Tests/osu.Game.Rulesets.Pippidon.Tests.csproj
index 0719dd30df..c133b0e3f8 100644
--- a/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon.Tests/osu.Game.Rulesets.Pippidon.Tests.csproj
+++ b/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon.Tests/osu.Game.Rulesets.Pippidon.Tests.csproj
@@ -12,7 +12,7 @@
     <PackageReference Include="Appveyor.TestLogger" Version="2.0.0" />
     <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.0.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
-    <PackageReference Include="NUnit3TestAdapter" Version="4.1.0" />
+    <PackageReference Include="NUnit3TestAdapter" Version="4.2.0" />
     <PackageReference Update="Microsoft.EntityFrameworkCore.Sqlite" Version="2.1.4" />
   </ItemGroup>
   <ItemGroup>
diff --git a/osu.Game.Benchmarks/osu.Game.Benchmarks.csproj b/osu.Game.Benchmarks/osu.Game.Benchmarks.csproj
index 57b914bee6..a8599f2cb6 100644
--- a/osu.Game.Benchmarks/osu.Game.Benchmarks.csproj
+++ b/osu.Game.Benchmarks/osu.Game.Benchmarks.csproj
@@ -9,7 +9,7 @@
   <ItemGroup>
     <PackageReference Include="BenchmarkDotNet" Version="0.13.1" />
     <PackageReference Include="nunit" Version="3.13.2" />
-    <PackageReference Include="NUnit3TestAdapter" Version="4.1.0" />
+    <PackageReference Include="NUnit3TestAdapter" Version="4.2.0" />
   </ItemGroup>
 
   <ItemGroup>
diff --git a/osu.Game.Rulesets.Catch.Tests/osu.Game.Rulesets.Catch.Tests.csproj b/osu.Game.Rulesets.Catch.Tests/osu.Game.Rulesets.Catch.Tests.csproj
index 13f2e25f05..d5496b7479 100644
--- a/osu.Game.Rulesets.Catch.Tests/osu.Game.Rulesets.Catch.Tests.csproj
+++ b/osu.Game.Rulesets.Catch.Tests/osu.Game.Rulesets.Catch.Tests.csproj
@@ -4,7 +4,7 @@
     <PackageReference Include="Appveyor.TestLogger" Version="2.0.0" />
     <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.0.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
-    <PackageReference Include="NUnit3TestAdapter" Version="4.1.0" />
+    <PackageReference Include="NUnit3TestAdapter" Version="4.2.0" />
     <PackageReference Update="Microsoft.EntityFrameworkCore.Sqlite" Version="2.1.4" />
   </ItemGroup>
   <PropertyGroup Label="Project">
diff --git a/osu.Game.Rulesets.Mania.Tests/osu.Game.Rulesets.Mania.Tests.csproj b/osu.Game.Rulesets.Mania.Tests/osu.Game.Rulesets.Mania.Tests.csproj
index d51a6da4f9..2f12b1535e 100644
--- a/osu.Game.Rulesets.Mania.Tests/osu.Game.Rulesets.Mania.Tests.csproj
+++ b/osu.Game.Rulesets.Mania.Tests/osu.Game.Rulesets.Mania.Tests.csproj
@@ -4,7 +4,7 @@
     <PackageReference Include="Appveyor.TestLogger" Version="2.0.0" />
     <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.0.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
-    <PackageReference Include="NUnit3TestAdapter" Version="4.1.0" />
+    <PackageReference Include="NUnit3TestAdapter" Version="4.2.0" />
     <PackageReference Update="Microsoft.EntityFrameworkCore.Sqlite" Version="2.1.4" />
   </ItemGroup>
   <PropertyGroup Label="Project">
diff --git a/osu.Game.Rulesets.Osu.Tests/osu.Game.Rulesets.Osu.Tests.csproj b/osu.Game.Rulesets.Osu.Tests/osu.Game.Rulesets.Osu.Tests.csproj
index fea2e408f6..e5b2e070d8 100644
--- a/osu.Game.Rulesets.Osu.Tests/osu.Game.Rulesets.Osu.Tests.csproj
+++ b/osu.Game.Rulesets.Osu.Tests/osu.Game.Rulesets.Osu.Tests.csproj
@@ -5,7 +5,7 @@
     <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.0.0" />
     <PackageReference Include="Moq" Version="4.16.1" />
     <PackageReference Include="NUnit" Version="3.13.2" />
-    <PackageReference Include="NUnit3TestAdapter" Version="4.1.0" />
+    <PackageReference Include="NUnit3TestAdapter" Version="4.2.0" />
     <PackageReference Update="Microsoft.EntityFrameworkCore.Sqlite" Version="2.1.4" />
   </ItemGroup>
   <PropertyGroup Label="Project">
diff --git a/osu.Game.Rulesets.Taiko.Tests/osu.Game.Rulesets.Taiko.Tests.csproj b/osu.Game.Rulesets.Taiko.Tests/osu.Game.Rulesets.Taiko.Tests.csproj
index ad3713e047..e48d80323a 100644
--- a/osu.Game.Rulesets.Taiko.Tests/osu.Game.Rulesets.Taiko.Tests.csproj
+++ b/osu.Game.Rulesets.Taiko.Tests/osu.Game.Rulesets.Taiko.Tests.csproj
@@ -4,7 +4,7 @@
     <PackageReference Include="Appveyor.TestLogger" Version="2.0.0" />
     <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.0.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
-    <PackageReference Include="NUnit3TestAdapter" Version="4.1.0" />
+    <PackageReference Include="NUnit3TestAdapter" Version="4.2.0" />
     <PackageReference Update="Microsoft.EntityFrameworkCore.Sqlite" Version="2.1.4" />
   </ItemGroup>
   <PropertyGroup Label="Project">
diff --git a/osu.Game.Tests/osu.Game.Tests.csproj b/osu.Game.Tests/osu.Game.Tests.csproj
index 3b115d43e5..c64ef918e3 100644
--- a/osu.Game.Tests/osu.Game.Tests.csproj
+++ b/osu.Game.Tests/osu.Game.Tests.csproj
@@ -6,7 +6,7 @@
     <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.0.0" />
     <PackageReference Include="Nito.AsyncEx" Version="5.1.2" />
     <PackageReference Include="NUnit" Version="3.13.2" />
-    <PackageReference Include="NUnit3TestAdapter" Version="4.1.0" />
+    <PackageReference Include="NUnit3TestAdapter" Version="4.2.0" />
     <PackageReference Update="Microsoft.EntityFrameworkCore.Sqlite" Version="2.1.4" />
     <PackageReference Include="Moq" Version="4.16.1" />
   </ItemGroup>
diff --git a/osu.Game.Tournament.Tests/osu.Game.Tournament.Tests.csproj b/osu.Game.Tournament.Tests/osu.Game.Tournament.Tests.csproj
index 130fcfaca1..fb09a7be1e 100644
--- a/osu.Game.Tournament.Tests/osu.Game.Tournament.Tests.csproj
+++ b/osu.Game.Tournament.Tests/osu.Game.Tournament.Tests.csproj
@@ -7,7 +7,7 @@
     <PackageReference Include="Appveyor.TestLogger" Version="2.0.0" />
     <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.0.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
-    <PackageReference Include="NUnit3TestAdapter" Version="4.1.0" />
+    <PackageReference Include="NUnit3TestAdapter" Version="4.2.0" />
   </ItemGroup>
   <PropertyGroup Label="Project">
     <OutputType>WinExe</OutputType>
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 2e5c9f4548..5508cac93e 100644
--- a/osu.Game/osu.Game.csproj
+++ b/osu.Game/osu.Game.csproj
@@ -18,9 +18,9 @@
     </None>
   </ItemGroup>
   <ItemGroup Label="Package References">
-    <PackageReference Include="AutoMapper" Version="10.1.1" />
+    <PackageReference Include="AutoMapper" Version="11.0.0" />
     <PackageReference Include="DiffPlex" Version="1.7.0" />
-    <PackageReference Include="HtmlAgilityPack" Version="1.11.39" />
+    <PackageReference Include="HtmlAgilityPack" Version="1.11.40" />
     <PackageReference Include="Humanizer" Version="2.13.14" />
     <PackageReference Include="MessagePack" Version="2.3.85" />
     <PackageReference Include="Microsoft.AspNetCore.SignalR.Client" Version="5.0.11" />
@@ -35,10 +35,10 @@
       <PrivateAssets>all</PrivateAssets>
       <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
     </PackageReference>
-    <PackageReference Include="Realm" Version="10.7.1" />
+    <PackageReference Include="Realm" Version="10.8.0" />
     <PackageReference Include="ppy.osu.Framework" Version="2022.111.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.115.0" />
-    <PackageReference Include="Sentry" Version="3.12.1" />
+    <PackageReference Include="Sentry" Version="3.13.0" />
     <PackageReference Include="SharpCompress" Version="0.30.1" />
     <PackageReference Include="NUnit" Version="3.13.2" />
     <PackageReference Include="System.ComponentModel.Annotations" Version="5.0.0" />

From 911a837f62b371ec7b4c119ff43af3f16c2658bb Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 18 Jan 2022 11:09:35 +0900
Subject: [PATCH 2261/5547] Update framework

---
 osu.Android.props        | 2 +-
 osu.Game/osu.Game.csproj | 2 +-
 osu.iOS.props            | 4 ++--
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Android.props b/osu.Android.props
index b2e3b32916..18e63bb219 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -52,7 +52,7 @@
   </ItemGroup>
   <ItemGroup>
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.115.0" />
-    <PackageReference Include="ppy.osu.Framework.Android" Version="2022.111.0" />
+    <PackageReference Include="ppy.osu.Framework.Android" Version="2022.118.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
     <!-- Realm needs to be directly referenced in all Xamarin projects, as it will not pull in its transitive dependencies otherwise. -->
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 5508cac93e..758575e74a 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="10.8.0" />
-    <PackageReference Include="ppy.osu.Framework" Version="2022.111.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2022.118.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.115.0" />
     <PackageReference Include="Sentry" Version="3.13.0" />
     <PackageReference Include="SharpCompress" Version="0.30.1" />
diff --git a/osu.iOS.props b/osu.iOS.props
index 897be33c18..d6c4533538 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -60,7 +60,7 @@
     <Reference Include="System.Net.Http" />
   </ItemGroup>
   <ItemGroup Label="Package References">
-    <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.111.0" />
+    <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.118.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.115.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net5.0 / net6.0) -->
@@ -83,7 +83,7 @@
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="2.2.6" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.Core" Version="2.2.6" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
-    <PackageReference Include="ppy.osu.Framework" Version="2022.111.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2022.118.0" />
     <PackageReference Include="SharpCompress" Version="0.30.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
     <PackageReference Include="System.ComponentModel.Annotations" Version="5.0.0" />

From f9c5000774d08c3f9c7e6f561205d0c082326590 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 18 Jan 2022 11:27:28 +0900
Subject: [PATCH 2262/5547] Remove obsoleted sentry disposal call and fix
 incorrectly unbound logger event

---
 osu.Game/Utils/SentryLogger.cs | 46 ++++++++++++++--------------------
 1 file changed, 19 insertions(+), 27 deletions(-)

diff --git a/osu.Game/Utils/SentryLogger.cs b/osu.Game/Utils/SentryLogger.cs
index 8f12760a6b..dbf04283b6 100644
--- a/osu.Game/Utils/SentryLogger.cs
+++ b/osu.Game/Utils/SentryLogger.cs
@@ -16,6 +16,7 @@ namespace osu.Game.Utils
     {
         private SentryClient sentry;
         private Scope sentryScope;
+        private Exception lastException;
 
         public SentryLogger(OsuGame game)
         {
@@ -30,30 +31,27 @@ namespace osu.Game.Utils
             sentry = new SentryClient(options);
             sentryScope = new Scope(options);
 
-            Exception lastException = null;
+            Logger.NewEntry += processLogEntry;
+        }
 
-            Logger.NewEntry += entry =>
+        private void processLogEntry(LogEntry entry)
+        {
+            if (entry.Level < LogLevel.Verbose) return;
+
+            var exception = entry.Exception;
+
+            if (exception != null)
             {
-                if (entry.Level < LogLevel.Verbose) return;
+                if (!shouldSubmitException(exception)) return;
 
-                var exception = entry.Exception;
+                // since we let unhandled exceptions go ignored at times, we want to ensure they don't get submitted on subsequent reports.
+                if (lastException != null && lastException.Message == exception.Message && exception.StackTrace.StartsWith(lastException.StackTrace, StringComparison.Ordinal)) return;
 
-                if (exception != null)
-                {
-                    if (!shouldSubmitException(exception))
-                        return;
-
-                    // since we let unhandled exceptions go ignored at times, we want to ensure they don't get submitted on subsequent reports.
-                    if (lastException != null &&
-                        lastException.Message == exception.Message && exception.StackTrace.StartsWith(lastException.StackTrace, StringComparison.Ordinal))
-                        return;
-
-                    lastException = exception;
-                    sentry.CaptureEvent(new SentryEvent(exception) { Message = entry.Message }, sentryScope);
-                }
-                else
-                    sentryScope.AddBreadcrumb(DateTimeOffset.Now, entry.Message, entry.Target.ToString(), "navigation");
-            };
+                lastException = exception;
+                sentry.CaptureEvent(new SentryEvent(exception) { Message = entry.Message }, sentryScope);
+            }
+            else
+                sentryScope.AddBreadcrumb(DateTimeOffset.Now, entry.Message, entry.Target.ToString(), "navigation");
         }
 
         private bool shouldSubmitException(Exception exception)
@@ -92,15 +90,9 @@ namespace osu.Game.Utils
             GC.SuppressFinalize(this);
         }
 
-        private bool isDisposed;
-
         protected virtual void Dispose(bool isDisposing)
         {
-            if (isDisposed)
-                return;
-
-            isDisposed = true;
-            sentry?.Dispose();
+            Logger.NewEntry -= processLogEntry;
             sentry = null;
             sentryScope = null;
         }

From c725548b9ec7b78ad08ec5beb823e70d6f4672bf Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 18 Jan 2022 11:42:50 +0900
Subject: [PATCH 2263/5547] Update stray realm reference in mobile projects

---
 osu.Android.props | 2 +-
 osu.iOS.props     | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Android.props b/osu.Android.props
index 18e63bb219..b296c114e9 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -56,6 +56,6 @@
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
     <!-- Realm needs to be directly referenced in all Xamarin projects, as it will not pull in its transitive dependencies otherwise. -->
-    <PackageReference Include="Realm" Version="10.7.1" />
+    <PackageReference Include="Realm" Version="10.8.0" />
   </ItemGroup>
 </Project>
diff --git a/osu.iOS.props b/osu.iOS.props
index d6c4533538..5925581e28 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -88,6 +88,6 @@
     <PackageReference Include="NUnit" Version="3.13.2" />
     <PackageReference Include="System.ComponentModel.Annotations" Version="5.0.0" />
     <PackageReference Include="ppy.osu.Framework.NativeLibs" Version="2021.805.0" ExcludeAssets="all" />
-    <PackageReference Include="Realm" Version="10.7.1" />
+    <PackageReference Include="Realm" Version="10.8.0" />
   </ItemGroup>
 </Project>

From a7db793d8c14f1923aeac26aeabda00a2f6aa60b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 18 Jan 2022 11:39:22 +0900
Subject: [PATCH 2264/5547] Specify realm pipe path location

I can't confirm this works yet, since I'm not sure what the
preconditions are for the `.note` file to be created. What I can confirm
is that a `.note` file hasn't appeared in my game data directory yet.
---
 osu.Game/Database/RealmContextFactory.cs | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/osu.Game/Database/RealmContextFactory.cs b/osu.Game/Database/RealmContextFactory.cs
index 96c24837a1..04253ade82 100644
--- a/osu.Game/Database/RealmContextFactory.cs
+++ b/osu.Game/Database/RealmContextFactory.cs
@@ -2,6 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
+using System.IO;
 using System.Linq;
 using System.Reflection;
 using System.Threading;
@@ -188,10 +189,17 @@ namespace osu.Game.Database
 
         private RealmConfiguration getConfiguration()
         {
+            // This is currently the only usage of temporary files at the osu! side.
+            // If we use the temporary folder in more situations in the future, this should be moved to a higher level (helper method or OsuGameBase).
+            string tempPathLocation = Path.Combine(Path.GetTempPath(), @"lazer");
+            if (!Directory.Exists(tempPathLocation))
+                Directory.CreateDirectory(tempPathLocation);
+
             return new RealmConfiguration(storage.GetFullPath(Filename, true))
             {
                 SchemaVersion = schema_version,
                 MigrationCallback = onMigration,
+                FallbackPipePath = tempPathLocation,
             };
         }
 

From ebc9d3a613e3e73b996f66302646de1be9ae74b0 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 18 Jan 2022 11:57:38 +0900
Subject: [PATCH 2265/5547] Fix playlist aggregate scores not displaying
 (again)

---
 osu.Game/Scoring/ScoreManager.cs | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/osu.Game/Scoring/ScoreManager.cs b/osu.Game/Scoring/ScoreManager.cs
index 52180d7ff2..ccf3226792 100644
--- a/osu.Game/Scoring/ScoreManager.cs
+++ b/osu.Game/Scoring/ScoreManager.cs
@@ -133,8 +133,7 @@ namespace osu.Game.Scoring
         public async Task<long> GetTotalScoreAsync([NotNull] ScoreInfo score, ScoringMode mode = ScoringMode.Standardised, CancellationToken cancellationToken = default)
         {
             // TODO: This is required for playlist aggregate scores. They should likely not be getting here in the first place.
-            // ReSharper disable once ConditionIsAlwaysTrueOrFalse
-            if (score.BeatmapInfo == null)
+            if (string.IsNullOrEmpty(score.BeatmapInfo.Hash))
                 return score.TotalScore;
 
             int beatmapMaxCombo;

From b9ec860cf2c7a5a3eae50cc06c6301e7ed5e5802 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 18 Jan 2022 12:20:52 +0900
Subject: [PATCH 2266/5547] Ensure global beatmap/ruleset are always mutated
 from the update thread

This came up while testing the new realm thread, where `MusicController`
would fall over when `OsuTestScene` changes the global beatmap from an
async load thread (causing a cross-thread realm access).

We don't want to have to schedule every usage of these bindables, so
this seems like a good constraint to put in place.
---
 osu.Game/OsuGameBase.cs | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/osu.Game/OsuGameBase.cs b/osu.Game/OsuGameBase.cs
index 9256514a0a..8126b74418 100644
--- a/osu.Game/OsuGameBase.cs
+++ b/osu.Game/OsuGameBase.cs
@@ -327,6 +327,7 @@ namespace osu.Game
             dependencies.CacheAs(MusicController);
 
             Ruleset.BindValueChanged(onRulesetChanged);
+            Beatmap.BindValueChanged(onBeatmapChanged);
         }
 
         protected virtual void InitialiseFonts()
@@ -448,8 +449,17 @@ namespace osu.Game
 
         protected override Storage CreateStorage(GameHost host, Storage defaultStorage) => new OsuStorage(host, defaultStorage);
 
+        private void onBeatmapChanged(ValueChangedEvent<WorkingBeatmap> valueChangedEvent)
+        {
+            if (!ThreadSafety.IsUpdateThread)
+                throw new InvalidOperationException("Global beatmap bindable must be changed from update thread.");
+        }
+
         private void onRulesetChanged(ValueChangedEvent<RulesetInfo> r)
         {
+            if (!ThreadSafety.IsUpdateThread)
+                throw new InvalidOperationException("Global ruleset bindable must be changed from update thread.");
+
             if (r.NewValue?.Available != true)
             {
                 // reject the change if the ruleset is not available.

From 014c840d807e00ff2b35bcce9d096c0396d309a9 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 18 Jan 2022 12:24:42 +0900
Subject: [PATCH 2267/5547] Fix incorrect thread usage of ruleset in tournament
 `DataLoadTest`

---
 osu.Game.Tournament.Tests/NonVisual/DataLoadTest.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tournament.Tests/NonVisual/DataLoadTest.cs b/osu.Game.Tournament.Tests/NonVisual/DataLoadTest.cs
index db019f9242..65753bfe00 100644
--- a/osu.Game.Tournament.Tests/NonVisual/DataLoadTest.cs
+++ b/osu.Game.Tournament.Tests/NonVisual/DataLoadTest.cs
@@ -35,9 +35,9 @@ namespace osu.Game.Tournament.Tests.NonVisual
 
         public class TestTournament : TournamentGameBase
         {
-            [BackgroundDependencyLoader]
-            private void load()
+            protected override void LoadComplete()
             {
+                base.LoadComplete();
                 Ruleset.Value = new RulesetInfo(); // not available
             }
         }

From b9aae5569f75ce9fd62d0cb187806f0917b009db Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 18 Jan 2022 13:22:37 +0900
Subject: [PATCH 2268/5547] Fix `OsuTestScene` potentially mutating global
 bindables

---
 osu.Game/Tests/Visual/OsuTestScene.cs | 45 +++++++++++++++++----------
 1 file changed, 28 insertions(+), 17 deletions(-)

diff --git a/osu.Game/Tests/Visual/OsuTestScene.cs b/osu.Game/Tests/Visual/OsuTestScene.cs
index 6b029729ea..be811dd54b 100644
--- a/osu.Game/Tests/Visual/OsuTestScene.cs
+++ b/osu.Game/Tests/Visual/OsuTestScene.cs
@@ -28,7 +28,6 @@ using osu.Game.Rulesets;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.UI;
-using osu.Game.Screens;
 using osu.Game.Storyboards;
 using osu.Game.Tests.Beatmaps;
 using osu.Game.Tests.Rulesets;
@@ -38,13 +37,16 @@ namespace osu.Game.Tests.Visual
     [ExcludeFromDynamicCompile]
     public abstract class OsuTestScene : TestScene
     {
-        protected Bindable<WorkingBeatmap> Beatmap { get; private set; }
+        [Cached]
+        protected Bindable<WorkingBeatmap> Beatmap { get; } = new Bindable<WorkingBeatmap>();
 
-        protected Bindable<RulesetInfo> Ruleset;
+        [Cached]
+        protected Bindable<RulesetInfo> Ruleset { get; } = new Bindable<RulesetInfo>();
 
-        protected Bindable<IReadOnlyList<Mod>> SelectedMods;
+        [Cached]
+        protected Bindable<IReadOnlyList<Mod>> SelectedMods { get; } = new Bindable<IReadOnlyList<Mod>>(Array.Empty<Mod>());
 
-        protected new OsuScreenDependencies Dependencies { get; private set; }
+        protected new DependencyContainer Dependencies { get; private set; }
 
         protected IResourceStore<byte[]> Resources;
 
@@ -139,17 +141,15 @@ namespace osu.Game.Tests.Visual
 
             var providedRuleset = CreateRuleset();
             if (providedRuleset != null)
-                baseDependencies = rulesetDependencies = new DrawableRulesetDependencies(providedRuleset, baseDependencies);
+                isolatedBaseDependencies = rulesetDependencies = new DrawableRulesetDependencies(providedRuleset, baseDependencies);
 
-            Dependencies = new OsuScreenDependencies(false, baseDependencies);
+            Dependencies = isolatedBaseDependencies;
 
-            Beatmap = Dependencies.Beatmap;
+            Beatmap.Default = parent.Get<Bindable<WorkingBeatmap>>().Default;
             Beatmap.SetDefault();
 
-            Ruleset = Dependencies.Ruleset;
-            Ruleset.SetDefault();
+            Ruleset.Value = CreateRuleset()?.RulesetInfo ?? parent.Get<RulesetStore>().AvailableRulesets.First();
 
-            SelectedMods = Dependencies.Mods;
             SelectedMods.SetDefault();
 
             if (!UseOnlineAPI)
@@ -162,6 +162,23 @@ namespace osu.Game.Tests.Visual
             return Dependencies;
         }
 
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            var parentBeatmap = Parent.Dependencies.Get<Bindable<WorkingBeatmap>>();
+            parentBeatmap.Value = Beatmap.Value;
+            Beatmap.BindTo(parentBeatmap);
+
+            var parentRuleset = Parent.Dependencies.Get<Bindable<RulesetInfo>>();
+            parentRuleset.Value = Ruleset.Value;
+            Ruleset.BindTo(parentRuleset);
+
+            var parentMods = Parent.Dependencies.Get<Bindable<IReadOnlyList<Mod>>>();
+            parentMods.Value = SelectedMods.Value;
+            SelectedMods.BindTo(parentMods);
+        }
+
         protected override Container<Drawable> Content => content ?? base.Content;
 
         private readonly Container content;
@@ -286,12 +303,6 @@ namespace osu.Game.Tests.Visual
         protected virtual WorkingBeatmap CreateWorkingBeatmap(IBeatmap beatmap, Storyboard storyboard = null) =>
             new ClockBackedTestWorkingBeatmap(beatmap, storyboard, Clock, Audio);
 
-        [BackgroundDependencyLoader]
-        private void load(RulesetStore rulesets)
-        {
-            Ruleset.Value = CreateRuleset()?.RulesetInfo ?? rulesets.AvailableRulesets.First();
-        }
-
         protected override void Dispose(bool isDisposing)
         {
             base.Dispose(isDisposing);

From da9a60a6954c5b194e9e1331fae92792fa9090c8 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 18 Jan 2022 13:22:55 +0900
Subject: [PATCH 2269/5547] Update broken test scenes to match new
 `OsuTestScene` logic

---
 .../Visual/Editing/TestSceneComposeScreen.cs  |  5 ++--
 .../Visual/Editing/TestSceneEditorClock.cs    |  6 ++---
 .../Editing/TestSceneEditorSeekSnapping.cs    |  6 ++---
 .../Visual/Editing/TestSceneTimingScreen.cs   |  5 ++--
 osu.Game/Tests/Visual/EditorClockTestScene.cs |  4 +--
 osu.Game/Tests/Visual/EditorTestScene.cs      | 25 +++++++++++++------
 6 files changed, 31 insertions(+), 20 deletions(-)

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneComposeScreen.cs b/osu.Game.Tests/Visual/Editing/TestSceneComposeScreen.cs
index 9b8567e853..d100fba8d6 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneComposeScreen.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneComposeScreen.cs
@@ -29,9 +29,10 @@ namespace osu.Game.Tests.Visual.Editing
         [Cached]
         private EditorClipboard clipboard = new EditorClipboard();
 
-        [BackgroundDependencyLoader]
-        private void load()
+        protected override void LoadComplete()
         {
+            base.LoadComplete();
+
             Beatmap.Value = CreateWorkingBeatmap(editorBeatmap.PlayableBeatmap);
 
             Child = new ComposeScreen
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneEditorClock.cs b/osu.Game.Tests/Visual/Editing/TestSceneEditorClock.cs
index 0abf0c47f8..4b9be77471 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneEditorClock.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneEditorClock.cs
@@ -2,7 +2,6 @@
 // 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.Game.Rulesets.Osu;
@@ -37,9 +36,10 @@ namespace osu.Game.Tests.Visual.Editing
             });
         }
 
-        [BackgroundDependencyLoader]
-        private void load()
+        protected override void LoadComplete()
         {
+            base.LoadComplete();
+
             Beatmap.Value = CreateWorkingBeatmap(new OsuRuleset().RulesetInfo);
             // ensure that music controller does not change this beatmap due to it
             // completing naturally as part of the test.
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneEditorSeekSnapping.cs b/osu.Game.Tests/Visual/Editing/TestSceneEditorSeekSnapping.cs
index 3a19eabe81..863f42520b 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneEditorSeekSnapping.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneEditorSeekSnapping.cs
@@ -2,7 +2,6 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using NUnit.Framework;
-using osu.Framework.Allocation;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
@@ -23,9 +22,10 @@ namespace osu.Game.Tests.Visual.Editing
             BeatDivisor.Value = 4;
         }
 
-        [BackgroundDependencyLoader]
-        private void load()
+        protected override void LoadComplete()
         {
+            base.LoadComplete();
+
             var testBeatmap = new Beatmap
             {
                 ControlPointInfo = new ControlPointInfo(),
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneTimingScreen.cs b/osu.Game.Tests/Visual/Editing/TestSceneTimingScreen.cs
index 4bbffbdc7a..17b8189fc7 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneTimingScreen.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneTimingScreen.cs
@@ -29,9 +29,10 @@ namespace osu.Game.Tests.Visual.Editing
             editorBeatmap = new EditorBeatmap(CreateBeatmap(new OsuRuleset().RulesetInfo));
         }
 
-        [BackgroundDependencyLoader]
-        private void load()
+        protected override void LoadComplete()
         {
+            base.LoadComplete();
+
             Beatmap.Value = CreateWorkingBeatmap(editorBeatmap.PlayableBeatmap);
             Beatmap.Disabled = true;
 
diff --git a/osu.Game/Tests/Visual/EditorClockTestScene.cs b/osu.Game/Tests/Visual/EditorClockTestScene.cs
index c2e9892735..66ab427565 100644
--- a/osu.Game/Tests/Visual/EditorClockTestScene.cs
+++ b/osu.Game/Tests/Visual/EditorClockTestScene.cs
@@ -35,9 +35,9 @@ namespace osu.Game.Tests.Visual
             return dependencies;
         }
 
-        [BackgroundDependencyLoader]
-        private void load()
+        protected override void LoadComplete()
         {
+            base.LoadComplete();
             Beatmap.BindValueChanged(beatmapChanged, true);
         }
 
diff --git a/osu.Game/Tests/Visual/EditorTestScene.cs b/osu.Game/Tests/Visual/EditorTestScene.cs
index 07152b5a3e..d9dd6e4fa8 100644
--- a/osu.Game/Tests/Visual/EditorTestScene.cs
+++ b/osu.Game/Tests/Visual/EditorTestScene.cs
@@ -42,17 +42,27 @@ namespace osu.Game.Tests.Visual
             Alpha = 0
         };
 
+        private TestBeatmapManager testBeatmapManager;
+        private WorkingBeatmap working;
+
         [BackgroundDependencyLoader]
         private void load(GameHost host, AudioManager audio, RulesetStore rulesets)
         {
             Add(logo);
 
-            var working = CreateWorkingBeatmap(Ruleset.Value);
-
-            Beatmap.Value = working;
+            working = CreateWorkingBeatmap(Ruleset.Value);
 
             if (IsolateSavingFromDatabase)
-                Dependencies.CacheAs<BeatmapManager>(new TestBeatmapManager(LocalStorage, ContextFactory, rulesets, null, audio, Resources, host, Beatmap.Default, working));
+                Dependencies.CacheAs<BeatmapManager>(testBeatmapManager = new TestBeatmapManager(LocalStorage, ContextFactory, rulesets, null, audio, Resources, host, Beatmap.Default));
+        }
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            Beatmap.Value = working;
+            if (testBeatmapManager != null)
+                testBeatmapManager.TestBeatmap = working;
         }
 
         protected virtual bool EditorComponentsReady => Editor.ChildrenOfType<HitObjectComposer>().FirstOrDefault()?.IsLoaded == true
@@ -114,12 +124,11 @@ namespace osu.Game.Tests.Visual
 
         private class TestBeatmapManager : BeatmapManager
         {
-            private readonly WorkingBeatmap testBeatmap;
+            public WorkingBeatmap TestBeatmap;
 
-            public TestBeatmapManager(Storage storage, IDatabaseContextFactory contextFactory, RulesetStore rulesets, IAPIProvider api, [NotNull] AudioManager audioManager, IResourceStore<byte[]> resources, GameHost host, WorkingBeatmap defaultBeatmap, WorkingBeatmap testBeatmap)
+            public TestBeatmapManager(Storage storage, IDatabaseContextFactory contextFactory, RulesetStore rulesets, IAPIProvider api, [NotNull] AudioManager audioManager, IResourceStore<byte[]> resources, GameHost host, WorkingBeatmap defaultBeatmap)
                 : base(storage, contextFactory, rulesets, api, audioManager, resources, host, defaultBeatmap)
             {
-                this.testBeatmap = testBeatmap;
             }
 
             protected override BeatmapModelManager CreateBeatmapModelManager(Storage storage, IDatabaseContextFactory contextFactory, RulesetStore rulesets, IAPIProvider api, GameHost host)
@@ -143,7 +152,7 @@ namespace osu.Game.Tests.Visual
                 }
 
                 public override WorkingBeatmap GetWorkingBeatmap(BeatmapInfo beatmapInfo)
-                    => testBeatmapManager.testBeatmap;
+                    => testBeatmapManager.TestBeatmap;
             }
 
             internal class TestBeatmapModelManager : BeatmapModelManager

From c3d3c03f0fad8b994bf99d8ee3c587654eff3a66 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 18 Jan 2022 12:15:40 +0900
Subject: [PATCH 2270/5547] Fix `TestScenePlaylistsScreen` crashing on entering
 room

---
 osu.Game.Tests/Visual/Playlists/TestScenePlaylistsScreen.cs | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsScreen.cs b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsScreen.cs
index e52f823f0b..63bd7c8068 100644
--- a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsScreen.cs
+++ b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsScreen.cs
@@ -2,8 +2,6 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using NUnit.Framework;
-using osu.Framework.Allocation;
-using osu.Game.Overlays;
 
 namespace osu.Game.Tests.Visual.Playlists
 {
@@ -12,9 +10,6 @@ namespace osu.Game.Tests.Visual.Playlists
     {
         protected override bool UseOnlineAPI => true;
 
-        [Cached]
-        private MusicController musicController { get; set; } = new MusicController();
-
         public TestScenePlaylistsScreen()
         {
             var multi = new Screens.OnlinePlay.Playlists.Playlists();

From d26f4d50bd92834f021e89ac56263e426e64e6e1 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 18 Jan 2022 13:58:12 +0900
Subject: [PATCH 2271/5547] Add test coverage of aggregate room scores
 displaying correctly

---
 .../TestScenePlaylistsRoomCreation.cs         |  3 +++
 .../Online/Leaderboards/LeaderboardScore.cs   | 10 ++++----
 .../OnlinePlay/TestRoomRequestsHandler.cs     | 23 +++++++++++++++++++
 3 files changed, 32 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs
index e59884f4f4..6efdd1b8b6 100644
--- a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs
+++ b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs
@@ -18,6 +18,7 @@ using osu.Game.Rulesets;
 using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Osu.Objects;
 using osu.Game.Screens.OnlinePlay.Components;
+using osu.Game.Screens.OnlinePlay.Match.Components;
 using osu.Game.Screens.OnlinePlay.Playlists;
 using osu.Game.Screens.Play;
 using osu.Game.Tests.Beatmaps;
@@ -71,6 +72,8 @@ namespace osu.Game.Tests.Visual.Playlists
 
             AddUntilStep("Progress details are hidden", () => match.ChildrenOfType<RoomLocalUserInfo>().FirstOrDefault()?.Parent.Alpha == 0);
 
+            AddUntilStep("Leaderboard shows two aggregate scores", () => match.ChildrenOfType<MatchLeaderboardScore>().Count(s => s.ScoreText.Text != "0") == 2);
+
             AddStep("start match", () => match.ChildrenOfType<PlaylistsReadyButton>().First().TriggerClick());
             AddUntilStep("player loader loaded", () => Stack.CurrentScreen is PlayerLoader);
         }
diff --git a/osu.Game/Online/Leaderboards/LeaderboardScore.cs b/osu.Game/Online/Leaderboards/LeaderboardScore.cs
index 14eec8b388..8f4a103513 100644
--- a/osu.Game/Online/Leaderboards/LeaderboardScore.cs
+++ b/osu.Game/Online/Leaderboards/LeaderboardScore.cs
@@ -53,7 +53,9 @@ namespace osu.Game.Online.Leaderboards
         private Drawable avatar;
         private Drawable scoreRank;
         private OsuSpriteText nameLabel;
-        private GlowingSpriteText scoreLabel;
+
+        public GlowingSpriteText ScoreText { get; private set; }
+
         private Container flagBadgeContainer;
         private FillFlowContainer<ModIcon> modsContainer;
 
@@ -198,7 +200,7 @@ namespace osu.Game.Online.Leaderboards
                                     Spacing = new Vector2(5f, 0f),
                                     Children = new Drawable[]
                                     {
-                                        scoreLabel = new GlowingSpriteText
+                                        ScoreText = new GlowingSpriteText
                                         {
                                             TextColour = Color4.White,
                                             GlowColour = Color4Extensions.FromHex(@"83ccfa"),
@@ -240,7 +242,7 @@ namespace osu.Game.Online.Leaderboards
 
         public override void Show()
         {
-            foreach (var d in new[] { avatar, nameLabel, scoreLabel, scoreRank, flagBadgeContainer, modsContainer }.Concat(statisticsLabels))
+            foreach (var d in new[] { avatar, nameLabel, ScoreText, scoreRank, flagBadgeContainer, modsContainer }.Concat(statisticsLabels))
                 d.FadeOut();
 
             Alpha = 0;
@@ -262,7 +264,7 @@ namespace osu.Game.Online.Leaderboards
 
                 using (BeginDelayedSequence(250))
                 {
-                    scoreLabel.FadeIn(200);
+                    ScoreText.FadeIn(200);
                     scoreRank.FadeIn(200);
 
                     using (BeginDelayedSequence(50))
diff --git a/osu.Game/Tests/Visual/OnlinePlay/TestRoomRequestsHandler.cs b/osu.Game/Tests/Visual/OnlinePlay/TestRoomRequestsHandler.cs
index 520f2c4585..5a0a7e71d4 100644
--- a/osu.Game/Tests/Visual/OnlinePlay/TestRoomRequestsHandler.cs
+++ b/osu.Game/Tests/Visual/OnlinePlay/TestRoomRequestsHandler.cs
@@ -70,6 +70,29 @@ namespace osu.Game.Tests.Visual.OnlinePlay
                     return true;
                 }
 
+                case GetRoomLeaderboardRequest roomLeaderboardRequest:
+                    roomLeaderboardRequest.TriggerSuccess(new APILeaderboard
+                    {
+                        Leaderboard = new List<APIUserScoreAggregate>
+                        {
+                            new APIUserScoreAggregate
+                            {
+                                TotalScore = 1000000,
+                                TotalAttempts = 5,
+                                CompletedBeatmaps = 2,
+                                User = new APIUser { Username = "best user" }
+                            },
+                            new APIUserScoreAggregate
+                            {
+                                TotalScore = 50,
+                                TotalAttempts = 1,
+                                CompletedBeatmaps = 1,
+                                User = new APIUser { Username = "worst user" }
+                            }
+                        }
+                    });
+                    return true;
+
                 case PartRoomRequest partRoomRequest:
                     partRoomRequest.TriggerSuccess();
                     return true;

From a714941f932cd07c0f1315a3a78a534a9e1101ae Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 18 Jan 2022 14:06:22 +0900
Subject: [PATCH 2272/5547] Rename EF variable to make reading code easier

---
 osu.Game/Database/EFToRealmMigrator.cs | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Database/EFToRealmMigrator.cs b/osu.Game/Database/EFToRealmMigrator.cs
index 7683accc5c..98037bb8a3 100644
--- a/osu.Game/Database/EFToRealmMigrator.cs
+++ b/osu.Game/Database/EFToRealmMigrator.cs
@@ -30,20 +30,20 @@ namespace osu.Game.Database
 
         public void Run()
         {
-            using (var db = efContextFactory.GetForWrite())
+            using (var ef = efContextFactory.GetForWrite())
             {
-                migrateSettings(db);
-                migrateSkins(db);
+                migrateSettings(ef);
+                migrateSkins(ef);
 
-                migrateBeatmaps(db);
-                migrateScores(db);
+                migrateBeatmaps(ef);
+                migrateScores(ef);
             }
         }
 
-        private void migrateBeatmaps(DatabaseWriteUsage db)
+        private void migrateBeatmaps(DatabaseWriteUsage ef)
         {
             // can be removed 20220730.
-            var existingBeatmapSets = db.Context.EFBeatmapSetInfo
+            var existingBeatmapSets = ef.Context.EFBeatmapSetInfo
                                         .Include(s => s.Beatmaps).ThenInclude(b => b.RulesetInfo)
                                         .Include(s => s.Beatmaps).ThenInclude(b => b.Metadata)
                                         .Include(s => s.Beatmaps).ThenInclude(b => b.BaseDifficulty)
@@ -117,7 +117,7 @@ namespace osu.Game.Database
                     }
                 }
 
-                db.Context.RemoveRange(existingBeatmapSets);
+                ef.Context.RemoveRange(existingBeatmapSets);
                 // Intentionally don't clean up the files, so they don't get purged by EF.
 
                 transaction.Commit();

From b1a75ce48098116ee14a6eb9db39cd1339cdf4dc Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 18 Jan 2022 14:17:43 +0900
Subject: [PATCH 2273/5547] Permanently delete `client.db` after migration
 completes

---
 osu.Game/Database/EFToRealmMigrator.cs | 4 ++++
 osu.Game/OsuGameBase.cs                | 1 +
 2 files changed, 5 insertions(+)

diff --git a/osu.Game/Database/EFToRealmMigrator.cs b/osu.Game/Database/EFToRealmMigrator.cs
index 98037bb8a3..7ad8e507bb 100644
--- a/osu.Game/Database/EFToRealmMigrator.cs
+++ b/osu.Game/Database/EFToRealmMigrator.cs
@@ -38,6 +38,10 @@ namespace osu.Game.Database
                 migrateBeatmaps(ef);
                 migrateScores(ef);
             }
+
+            // Delete the database permanently.
+            // Will cause future startups to not attempt migration.
+            efContextFactory.ResetDatabase();
         }
 
         private void migrateBeatmaps(DatabaseWriteUsage ef)
diff --git a/osu.Game/OsuGameBase.cs b/osu.Game/OsuGameBase.cs
index a9538c1e8c..18b22588a6 100644
--- a/osu.Game/OsuGameBase.cs
+++ b/osu.Game/OsuGameBase.cs
@@ -193,6 +193,7 @@ namespace osu.Game
             dependencies.Cache(RulesetStore = new RulesetStore(realmFactory, Storage));
             dependencies.CacheAs<IRulesetStore>(RulesetStore);
 
+            // A non-null context factory means there's still content to migrate.
             if (efContextFactory != null)
                 new EFToRealmMigrator(efContextFactory, realmFactory, LocalConfig).Run();
 

From 798482c94122eb9d23221e90e33ccc390a52380a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 18 Jan 2022 14:19:25 +0900
Subject: [PATCH 2274/5547] Create backups before deleting scores and beatmaps
 from EF database

---
 osu.Game/Database/DatabaseContextFactory.cs |  8 +++++++
 osu.Game/Database/EFToRealmMigrator.cs      | 25 +++++++++++++--------
 2 files changed, 24 insertions(+), 9 deletions(-)

diff --git a/osu.Game/Database/DatabaseContextFactory.cs b/osu.Game/Database/DatabaseContextFactory.cs
index f79505d7c5..c2a60122eb 100644
--- a/osu.Game/Database/DatabaseContextFactory.cs
+++ b/osu.Game/Database/DatabaseContextFactory.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 System.Linq;
 using System.Threading;
 using Microsoft.EntityFrameworkCore.Storage;
@@ -144,6 +145,13 @@ namespace osu.Game.Database
             Database = { AutoTransactionsEnabled = false }
         };
 
+        public void CreateBackup(string filename)
+        {
+            using (var source = storage.GetStream(DATABASE_NAME))
+            using (var destination = storage.GetStream(filename, FileAccess.Write, FileMode.CreateNew))
+                source.CopyTo(destination);
+        }
+
         public void ResetDatabase()
         {
             lock (writeLock)
diff --git a/osu.Game/Database/EFToRealmMigrator.cs b/osu.Game/Database/EFToRealmMigrator.cs
index 7ad8e507bb..3ecbd50b3e 100644
--- a/osu.Game/Database/EFToRealmMigrator.cs
+++ b/osu.Game/Database/EFToRealmMigrator.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 Microsoft.EntityFrameworkCore;
 using osu.Game.Beatmaps;
@@ -31,13 +33,16 @@ namespace osu.Game.Database
         public void Run()
         {
             using (var ef = efContextFactory.GetForWrite())
-            {
                 migrateSettings(ef);
+
+            using (var ef = efContextFactory.GetForWrite())
                 migrateSkins(ef);
 
+            using (var ef = efContextFactory.GetForWrite())
                 migrateBeatmaps(ef);
+
+            using (var ef = efContextFactory.GetForWrite())
                 migrateScores(ef);
-            }
 
             // Delete the database permanently.
             // Will cause future startups to not attempt migration.
@@ -47,13 +52,13 @@ namespace osu.Game.Database
         private void migrateBeatmaps(DatabaseWriteUsage ef)
         {
             // can be removed 20220730.
-            var existingBeatmapSets = ef.Context.EFBeatmapSetInfo
-                                        .Include(s => s.Beatmaps).ThenInclude(b => b.RulesetInfo)
-                                        .Include(s => s.Beatmaps).ThenInclude(b => b.Metadata)
-                                        .Include(s => s.Beatmaps).ThenInclude(b => b.BaseDifficulty)
-                                        .Include(s => s.Files).ThenInclude(f => f.FileInfo)
-                                        .Include(s => s.Metadata)
-                                        .ToList();
+            List<EFBeatmapSetInfo> existingBeatmapSets = ef.Context.EFBeatmapSetInfo
+                                                           .Include(s => s.Beatmaps).ThenInclude(b => b.RulesetInfo)
+                                                           .Include(s => s.Beatmaps).ThenInclude(b => b.Metadata)
+                                                           .Include(s => s.Beatmaps).ThenInclude(b => b.BaseDifficulty)
+                                                           .Include(s => s.Files).ThenInclude(f => f.FileInfo)
+                                                           .Include(s => s.Metadata)
+                                                           .ToList();
 
             // previous entries in EF are removed post migration.
             if (!existingBeatmapSets.Any())
@@ -121,6 +126,7 @@ namespace osu.Game.Database
                     }
                 }
 
+                efContextFactory.CreateBackup($"client.before_beatmap_migration_{DateTimeOffset.UtcNow.ToUnixTimeSeconds()}.db");
                 ef.Context.RemoveRange(existingBeatmapSets);
                 // Intentionally don't clean up the files, so they don't get purged by EF.
 
@@ -207,6 +213,7 @@ namespace osu.Game.Database
                     }
                 }
 
+                efContextFactory.CreateBackup($"client.before_scores_migration_{DateTimeOffset.UtcNow.ToUnixTimeSeconds()}.db");
                 db.Context.RemoveRange(existingScores);
                 // Intentionally don't clean up the files, so they don't get purged by EF.
 

From cf30d48721242567eb44d7d0e31fb6cb9e2d1b69 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 18 Jan 2022 14:19:31 +0900
Subject: [PATCH 2275/5547] Add more logging during migration process

---
 osu.Game/Database/EFToRealmMigrator.cs | 29 +++++++++++++++++++-------
 1 file changed, 22 insertions(+), 7 deletions(-)

diff --git a/osu.Game/Database/EFToRealmMigrator.cs b/osu.Game/Database/EFToRealmMigrator.cs
index 3ecbd50b3e..d8a3b66c7c 100644
--- a/osu.Game/Database/EFToRealmMigrator.cs
+++ b/osu.Game/Database/EFToRealmMigrator.cs
@@ -5,6 +5,7 @@ using System;
 using System.Collections.Generic;
 using System.Linq;
 using Microsoft.EntityFrameworkCore;
+using osu.Framework.Logging;
 using osu.Game.Beatmaps;
 using osu.Game.Configuration;
 using osu.Game.Models;
@@ -64,6 +65,8 @@ namespace osu.Game.Database
             if (!existingBeatmapSets.Any())
                 return;
 
+            Logger.Log("Beginning beatmaps migration to realm", LoggingTarget.Database);
+
             using (var realm = realmContextFactory.CreateContext())
             using (var transaction = realm.BeginWrite())
             {
@@ -71,6 +74,8 @@ namespace osu.Game.Database
                 // note that this cannot be written as: `realm.All<BeatmapInfo>().All(s => s.Protected)`, because realm does not support `.All()`.
                 if (!realm.All<BeatmapSetInfo>().Any(s => !s.Protected))
                 {
+                    Logger.Log($"Migrating {existingBeatmapSets.Count} beatmaps", LoggingTarget.Database);
+
                     foreach (var beatmapSet in existingBeatmapSets)
                     {
                         var realmBeatmapSet = new BeatmapSetInfo
@@ -161,17 +166,19 @@ namespace osu.Game.Database
         private void migrateScores(DatabaseWriteUsage db)
         {
             // can be removed 20220730.
-            var existingScores = db.Context.ScoreInfo
-                                   .Include(s => s.Ruleset)
-                                   .Include(s => s.BeatmapInfo)
-                                   .Include(s => s.Files)
-                                   .ThenInclude(f => f.FileInfo)
-                                   .ToList();
+            List<EFScoreInfo> existingScores = db.Context.ScoreInfo
+                                                 .Include(s => s.Ruleset)
+                                                 .Include(s => s.BeatmapInfo)
+                                                 .Include(s => s.Files)
+                                                 .ThenInclude(f => f.FileInfo)
+                                                 .ToList();
 
             // previous entries in EF are removed post migration.
             if (!existingScores.Any())
                 return;
 
+            Logger.Log("Beginning scores migration to realm", LoggingTarget.Database);
+
             using (var realm = realmContextFactory.CreateContext())
             using (var transaction = realm.BeginWrite())
             {
@@ -179,6 +186,8 @@ namespace osu.Game.Database
                 // note that this cannot be written as: `realm.All<ScoreInfo>().All(s => s.Protected)`, because realm does not support `.All()`.
                 if (!realm.All<ScoreInfo>().Any())
                 {
+                    Logger.Log($"Migrating {existingScores.Count} scores", LoggingTarget.Database);
+
                     foreach (var score in existingScores)
                     {
                         var realmScore = new ScoreInfo
@@ -254,6 +263,8 @@ namespace osu.Game.Database
                 // note that this cannot be written as: `realm.All<SkinInfo>().All(s => s.Protected)`, because realm does not support `.All()`.
                 if (!realm.All<SkinInfo>().Any(s => !s.Protected))
                 {
+                    Logger.Log($"Migrating {existingSkins.Count} skins", LoggingTarget.Database);
+
                     foreach (var skin in existingSkins)
                     {
                         var realmSkin = new SkinInfo
@@ -297,18 +308,22 @@ namespace osu.Game.Database
         private void migrateSettings(DatabaseWriteUsage db)
         {
             // migrate ruleset settings. can be removed 20220315.
-            var existingSettings = db.Context.DatabasedSetting;
+            var existingSettings = db.Context.DatabasedSetting.ToList();
 
             // previous entries in EF are removed post migration.
             if (!existingSettings.Any())
                 return;
 
+            Logger.Log("Beginning settings migration to realm", LoggingTarget.Database);
+
             using (var realm = realmContextFactory.CreateContext())
             using (var transaction = realm.BeginWrite())
             {
                 // only migrate data if the realm database is empty.
                 if (!realm.All<RealmRulesetSetting>().Any())
                 {
+                    Logger.Log($"Migrating {existingSettings.Count} settings", LoggingTarget.Database);
+
                     foreach (var dkb in existingSettings)
                     {
                         if (dkb.RulesetID == null)

From 2b1c15b6cc1b7a6f51157cb598e63b835322ea3c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 18 Jan 2022 14:30:32 +0900
Subject: [PATCH 2276/5547] Allow `BlockAllOperations` to be called from a
 non-update thread if update has never run

---
 osu.Game/Database/RealmContextFactory.cs | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Database/RealmContextFactory.cs b/osu.Game/Database/RealmContextFactory.cs
index 9307e06be0..01c54d6ee2 100644
--- a/osu.Game/Database/RealmContextFactory.cs
+++ b/osu.Game/Database/RealmContextFactory.cs
@@ -366,17 +366,17 @@ namespace osu.Game.Database
             if (isDisposed)
                 throw new ObjectDisposedException(nameof(RealmContextFactory));
 
-            if (!ThreadSafety.IsUpdateThread)
-                throw new InvalidOperationException(@$"{nameof(BlockAllOperations)} must be called from the update thread.");
-
-            Logger.Log(@"Blocking realm operations.", LoggingTarget.Database);
-
             try
             {
                 contextCreationLock.Wait();
 
                 lock (contextLock)
                 {
+                    if (!ThreadSafety.IsUpdateThread && context != null)
+                        throw new InvalidOperationException(@$"{nameof(BlockAllOperations)} must be called from the update thread.");
+
+                    Logger.Log(@"Blocking realm operations.", LoggingTarget.Database);
+
                     context?.Dispose();
                     context = null;
                 }

From bf50a9b8f8d92d0a23a498822513d65d9fade133 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 18 Jan 2022 14:30:41 +0900
Subject: [PATCH 2277/5547] Also backup the realm database before migration

---
 osu.Game/Database/EFToRealmMigrator.cs   |  8 ++++++--
 osu.Game/Database/RealmContextFactory.cs | 11 +++++++++++
 2 files changed, 17 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Database/EFToRealmMigrator.cs b/osu.Game/Database/EFToRealmMigrator.cs
index d8a3b66c7c..9fad29b3f4 100644
--- a/osu.Game/Database/EFToRealmMigrator.cs
+++ b/osu.Game/Database/EFToRealmMigrator.cs
@@ -75,6 +75,9 @@ namespace osu.Game.Database
                 if (!realm.All<BeatmapSetInfo>().Any(s => !s.Protected))
                 {
                     Logger.Log($"Migrating {existingBeatmapSets.Count} beatmaps", LoggingTarget.Database);
+                    string migration = $"before_beatmap_migration_{DateTimeOffset.UtcNow.ToUnixTimeSeconds()}";
+                    realmContextFactory.CreateBackup($"client.{migration}.realm");
+                    efContextFactory.CreateBackup($"client.{migration}.db");
 
                     foreach (var beatmapSet in existingBeatmapSets)
                     {
@@ -131,7 +134,6 @@ namespace osu.Game.Database
                     }
                 }
 
-                efContextFactory.CreateBackup($"client.before_beatmap_migration_{DateTimeOffset.UtcNow.ToUnixTimeSeconds()}.db");
                 ef.Context.RemoveRange(existingBeatmapSets);
                 // Intentionally don't clean up the files, so they don't get purged by EF.
 
@@ -187,6 +189,9 @@ namespace osu.Game.Database
                 if (!realm.All<ScoreInfo>().Any())
                 {
                     Logger.Log($"Migrating {existingScores.Count} scores", LoggingTarget.Database);
+                    string migration = $"before_score_migration_{DateTimeOffset.UtcNow.ToUnixTimeSeconds()}";
+                    realmContextFactory.CreateBackup($"client.{migration}.realm");
+                    efContextFactory.CreateBackup($"client.{migration}.db");
 
                     foreach (var score in existingScores)
                     {
@@ -222,7 +227,6 @@ namespace osu.Game.Database
                     }
                 }
 
-                efContextFactory.CreateBackup($"client.before_scores_migration_{DateTimeOffset.UtcNow.ToUnixTimeSeconds()}.db");
                 db.Context.RemoveRange(existingScores);
                 // Intentionally don't clean up the files, so they don't get purged by EF.
 
diff --git a/osu.Game/Database/RealmContextFactory.cs b/osu.Game/Database/RealmContextFactory.cs
index 01c54d6ee2..c86a9e54e1 100644
--- a/osu.Game/Database/RealmContextFactory.cs
+++ b/osu.Game/Database/RealmContextFactory.cs
@@ -2,6 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
+using System.IO;
 using System.Linq;
 using System.Reflection;
 using System.Threading;
@@ -353,6 +354,16 @@ namespace osu.Game.Database
         private string? getRulesetShortNameFromLegacyID(long rulesetId) =>
             efContextFactory?.Get().RulesetInfo.FirstOrDefault(r => r.ID == rulesetId)?.ShortName;
 
+        public void CreateBackup(string filename)
+        {
+            using (BlockAllOperations())
+            {
+                using (var source = storage.GetStream(Filename))
+                using (var destination = storage.GetStream(filename, FileAccess.Write, FileMode.CreateNew))
+                    source.CopyTo(destination);
+            }
+        }
+
         /// <summary>
         /// Flush any active contexts and block any further writes.
         /// </summary>

From 3429fd87681b928a52954b4a3b32ae38fd2bd794 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 18 Jan 2022 14:41:02 +0900
Subject: [PATCH 2278/5547] Fix transaction scope and add even more logging

---
 osu.Game/Database/DatabaseContextFactory.cs |   2 +
 osu.Game/Database/EFToRealmMigrator.cs      | 215 +++++++++++---------
 osu.Game/Database/RealmContextFactory.cs    |   1 +
 3 files changed, 122 insertions(+), 96 deletions(-)

diff --git a/osu.Game/Database/DatabaseContextFactory.cs b/osu.Game/Database/DatabaseContextFactory.cs
index c2a60122eb..cc690a9fda 100644
--- a/osu.Game/Database/DatabaseContextFactory.cs
+++ b/osu.Game/Database/DatabaseContextFactory.cs
@@ -5,6 +5,7 @@ using System.IO;
 using System.Linq;
 using System.Threading;
 using Microsoft.EntityFrameworkCore.Storage;
+using osu.Framework.Logging;
 using osu.Framework.Platform;
 using osu.Framework.Statistics;
 
@@ -147,6 +148,7 @@ namespace osu.Game.Database
 
         public void CreateBackup(string filename)
         {
+            Logger.Log($"Creating full EF database backup at {filename}", LoggingTarget.Database);
             using (var source = storage.GetStream(DATABASE_NAME))
             using (var destination = storage.GetStream(filename, FileAccess.Write, FileMode.CreateNew))
                 source.CopyTo(destination);
diff --git a/osu.Game/Database/EFToRealmMigrator.cs b/osu.Game/Database/EFToRealmMigrator.cs
index 9fad29b3f4..8f5de80e3b 100644
--- a/osu.Game/Database/EFToRealmMigrator.cs
+++ b/osu.Game/Database/EFToRealmMigrator.cs
@@ -47,6 +47,7 @@ namespace osu.Game.Database
 
             // Delete the database permanently.
             // Will cause future startups to not attempt migration.
+            Logger.Log("Migration successful, deleting EF database", LoggingTarget.Database);
             efContextFactory.ResetDatabase();
         }
 
@@ -61,83 +62,94 @@ namespace osu.Game.Database
                                                            .Include(s => s.Metadata)
                                                            .ToList();
 
-            // previous entries in EF are removed post migration.
-            if (!existingBeatmapSets.Any())
-                return;
-
             Logger.Log("Beginning beatmaps migration to realm", LoggingTarget.Database);
 
-            using (var realm = realmContextFactory.CreateContext())
-            using (var transaction = realm.BeginWrite())
+            // previous entries in EF are removed post migration.
+            if (!existingBeatmapSets.Any())
             {
+                Logger.Log("No beatmaps found to migrate", LoggingTarget.Database);
+                return;
+            }
+
+            using (var realm = realmContextFactory.CreateContext())
+            {
+                Logger.Log($"Found {existingBeatmapSets.Count} beatmaps in EF", LoggingTarget.Database);
+                string migration = $"before_beatmap_migration_{DateTimeOffset.UtcNow.ToUnixTimeSeconds()}";
+                efContextFactory.CreateBackup($"client.{migration}.db");
+
                 // only migrate data if the realm database is empty.
                 // note that this cannot be written as: `realm.All<BeatmapInfo>().All(s => s.Protected)`, because realm does not support `.All()`.
-                if (!realm.All<BeatmapSetInfo>().Any(s => !s.Protected))
+                if (realm.All<BeatmapSetInfo>().Any(s => !s.Protected))
+                {
+                    Logger.Log("Skipping migration as realm already has beatmaps loaded", LoggingTarget.Database);
+                }
+                else
                 {
-                    Logger.Log($"Migrating {existingBeatmapSets.Count} beatmaps", LoggingTarget.Database);
-                    string migration = $"before_beatmap_migration_{DateTimeOffset.UtcNow.ToUnixTimeSeconds()}";
                     realmContextFactory.CreateBackup($"client.{migration}.realm");
-                    efContextFactory.CreateBackup($"client.{migration}.db");
 
-                    foreach (var beatmapSet in existingBeatmapSets)
+                    using (var transaction = realm.BeginWrite())
                     {
-                        var realmBeatmapSet = new BeatmapSetInfo
+                        foreach (var beatmapSet in existingBeatmapSets)
                         {
-                            OnlineID = beatmapSet.OnlineID ?? -1,
-                            DateAdded = beatmapSet.DateAdded,
-                            Status = beatmapSet.Status,
-                            DeletePending = beatmapSet.DeletePending,
-                            Hash = beatmapSet.Hash,
-                            Protected = beatmapSet.Protected,
-                        };
-
-                        migrateFiles(beatmapSet, realm, realmBeatmapSet);
-
-                        foreach (var beatmap in beatmapSet.Beatmaps)
-                        {
-                            var realmBeatmap = new BeatmapInfo
+                            var realmBeatmapSet = new BeatmapSetInfo
                             {
-                                DifficultyName = beatmap.DifficultyName,
-                                Status = beatmap.Status,
-                                OnlineID = beatmap.OnlineID ?? -1,
-                                Length = beatmap.Length,
-                                BPM = beatmap.BPM,
-                                Hash = beatmap.Hash,
-                                StarRating = beatmap.StarRating,
-                                MD5Hash = beatmap.MD5Hash,
-                                Hidden = beatmap.Hidden,
-                                AudioLeadIn = beatmap.AudioLeadIn,
-                                StackLeniency = beatmap.StackLeniency,
-                                SpecialStyle = beatmap.SpecialStyle,
-                                LetterboxInBreaks = beatmap.LetterboxInBreaks,
-                                WidescreenStoryboard = beatmap.WidescreenStoryboard,
-                                EpilepsyWarning = beatmap.EpilepsyWarning,
-                                SamplesMatchPlaybackRate = beatmap.SamplesMatchPlaybackRate,
-                                DistanceSpacing = beatmap.DistanceSpacing,
-                                BeatDivisor = beatmap.BeatDivisor,
-                                GridSize = beatmap.GridSize,
-                                TimelineZoom = beatmap.TimelineZoom,
-                                Countdown = beatmap.Countdown,
-                                CountdownOffset = beatmap.CountdownOffset,
-                                MaxCombo = beatmap.MaxCombo,
-                                Bookmarks = beatmap.Bookmarks,
-                                Ruleset = realm.Find<RulesetInfo>(beatmap.RulesetInfo.ShortName),
-                                Difficulty = new BeatmapDifficulty(beatmap.BaseDifficulty),
-                                Metadata = getBestMetadata(beatmap.Metadata, beatmapSet.Metadata),
-                                BeatmapSet = realmBeatmapSet,
+                                OnlineID = beatmapSet.OnlineID ?? -1,
+                                DateAdded = beatmapSet.DateAdded,
+                                Status = beatmapSet.Status,
+                                DeletePending = beatmapSet.DeletePending,
+                                Hash = beatmapSet.Hash,
+                                Protected = beatmapSet.Protected,
                             };
 
-                            realmBeatmapSet.Beatmaps.Add(realmBeatmap);
+                            migrateFiles(beatmapSet, realm, realmBeatmapSet);
+
+                            foreach (var beatmap in beatmapSet.Beatmaps)
+                            {
+                                var realmBeatmap = new BeatmapInfo
+                                {
+                                    DifficultyName = beatmap.DifficultyName,
+                                    Status = beatmap.Status,
+                                    OnlineID = beatmap.OnlineID ?? -1,
+                                    Length = beatmap.Length,
+                                    BPM = beatmap.BPM,
+                                    Hash = beatmap.Hash,
+                                    StarRating = beatmap.StarRating,
+                                    MD5Hash = beatmap.MD5Hash,
+                                    Hidden = beatmap.Hidden,
+                                    AudioLeadIn = beatmap.AudioLeadIn,
+                                    StackLeniency = beatmap.StackLeniency,
+                                    SpecialStyle = beatmap.SpecialStyle,
+                                    LetterboxInBreaks = beatmap.LetterboxInBreaks,
+                                    WidescreenStoryboard = beatmap.WidescreenStoryboard,
+                                    EpilepsyWarning = beatmap.EpilepsyWarning,
+                                    SamplesMatchPlaybackRate = beatmap.SamplesMatchPlaybackRate,
+                                    DistanceSpacing = beatmap.DistanceSpacing,
+                                    BeatDivisor = beatmap.BeatDivisor,
+                                    GridSize = beatmap.GridSize,
+                                    TimelineZoom = beatmap.TimelineZoom,
+                                    Countdown = beatmap.Countdown,
+                                    CountdownOffset = beatmap.CountdownOffset,
+                                    MaxCombo = beatmap.MaxCombo,
+                                    Bookmarks = beatmap.Bookmarks,
+                                    Ruleset = realm.Find<RulesetInfo>(beatmap.RulesetInfo.ShortName),
+                                    Difficulty = new BeatmapDifficulty(beatmap.BaseDifficulty),
+                                    Metadata = getBestMetadata(beatmap.Metadata, beatmapSet.Metadata),
+                                    BeatmapSet = realmBeatmapSet,
+                                };
+
+                                realmBeatmapSet.Beatmaps.Add(realmBeatmap);
+                            }
+
+                            realm.Add(realmBeatmapSet);
                         }
 
-                        realm.Add(realmBeatmapSet);
+                        transaction.Commit();
                     }
                 }
 
+                Logger.Log($"Successfully migrated {existingBeatmapSets.Count} beatmaps to realm", LoggingTarget.Database);
                 ef.Context.RemoveRange(existingBeatmapSets);
                 // Intentionally don't clean up the files, so they don't get purged by EF.
-
-                transaction.Commit();
             }
         }
 
@@ -175,62 +187,73 @@ namespace osu.Game.Database
                                                  .ThenInclude(f => f.FileInfo)
                                                  .ToList();
 
-            // previous entries in EF are removed post migration.
-            if (!existingScores.Any())
-                return;
-
             Logger.Log("Beginning scores migration to realm", LoggingTarget.Database);
 
-            using (var realm = realmContextFactory.CreateContext())
-            using (var transaction = realm.BeginWrite())
+            // previous entries in EF are removed post migration.
+            if (!existingScores.Any())
             {
+                Logger.Log("No scores found to migrate", LoggingTarget.Database);
+                return;
+            }
+
+            using (var realm = realmContextFactory.CreateContext())
+            {
+                Logger.Log($"Found {existingScores.Count} scores in EF", LoggingTarget.Database);
+                string migration = $"before_score_migration_{DateTimeOffset.UtcNow.ToUnixTimeSeconds()}";
+                efContextFactory.CreateBackup($"client.{migration}.db");
+
                 // only migrate data if the realm database is empty.
                 // note that this cannot be written as: `realm.All<ScoreInfo>().All(s => s.Protected)`, because realm does not support `.All()`.
-                if (!realm.All<ScoreInfo>().Any())
+                if (realm.All<ScoreInfo>().Any())
+                {
+                    Logger.Log("Skipping migration as realm already has scores loaded", LoggingTarget.Database);
+                }
+                else
                 {
-                    Logger.Log($"Migrating {existingScores.Count} scores", LoggingTarget.Database);
-                    string migration = $"before_score_migration_{DateTimeOffset.UtcNow.ToUnixTimeSeconds()}";
                     realmContextFactory.CreateBackup($"client.{migration}.realm");
-                    efContextFactory.CreateBackup($"client.{migration}.db");
 
-                    foreach (var score in existingScores)
+                    using (var transaction = realm.BeginWrite())
                     {
-                        var realmScore = new ScoreInfo
+                        foreach (var score in existingScores)
                         {
-                            Hash = score.Hash,
-                            DeletePending = score.DeletePending,
-                            OnlineID = score.OnlineID ?? -1,
-                            ModsJson = score.ModsJson,
-                            StatisticsJson = score.StatisticsJson,
-                            User = score.User,
-                            TotalScore = score.TotalScore,
-                            MaxCombo = score.MaxCombo,
-                            Accuracy = score.Accuracy,
-                            HasReplay = ((IScoreInfo)score).HasReplay,
-                            Date = score.Date,
-                            PP = score.PP,
-                            BeatmapInfo = realm.All<BeatmapInfo>().First(b => b.Hash == score.BeatmapInfo.Hash),
-                            Ruleset = realm.Find<RulesetInfo>(score.Ruleset.ShortName),
-                            Rank = score.Rank,
-                            HitEvents = score.HitEvents,
-                            Passed = score.Passed,
-                            Combo = score.Combo,
-                            Position = score.Position,
-                            Statistics = score.Statistics,
-                            Mods = score.Mods,
-                            APIMods = score.APIMods,
-                        };
+                            var realmScore = new ScoreInfo
+                            {
+                                Hash = score.Hash,
+                                DeletePending = score.DeletePending,
+                                OnlineID = score.OnlineID ?? -1,
+                                ModsJson = score.ModsJson,
+                                StatisticsJson = score.StatisticsJson,
+                                User = score.User,
+                                TotalScore = score.TotalScore,
+                                MaxCombo = score.MaxCombo,
+                                Accuracy = score.Accuracy,
+                                HasReplay = ((IScoreInfo)score).HasReplay,
+                                Date = score.Date,
+                                PP = score.PP,
+                                BeatmapInfo = realm.All<BeatmapInfo>().First(b => b.Hash == score.BeatmapInfo.Hash),
+                                Ruleset = realm.Find<RulesetInfo>(score.Ruleset.ShortName),
+                                Rank = score.Rank,
+                                HitEvents = score.HitEvents,
+                                Passed = score.Passed,
+                                Combo = score.Combo,
+                                Position = score.Position,
+                                Statistics = score.Statistics,
+                                Mods = score.Mods,
+                                APIMods = score.APIMods,
+                            };
 
-                        migrateFiles(score, realm, realmScore);
+                            migrateFiles(score, realm, realmScore);
 
-                        realm.Add(realmScore);
+                            realm.Add(realmScore);
+                        }
+
+                        transaction.Commit();
                     }
                 }
 
+                Logger.Log($"Successfully migrated {existingScores.Count} scores to realm", LoggingTarget.Database);
                 db.Context.RemoveRange(existingScores);
                 // Intentionally don't clean up the files, so they don't get purged by EF.
-
-                transaction.Commit();
             }
         }
 
diff --git a/osu.Game/Database/RealmContextFactory.cs b/osu.Game/Database/RealmContextFactory.cs
index c86a9e54e1..8548e63e94 100644
--- a/osu.Game/Database/RealmContextFactory.cs
+++ b/osu.Game/Database/RealmContextFactory.cs
@@ -358,6 +358,7 @@ namespace osu.Game.Database
         {
             using (BlockAllOperations())
             {
+                Logger.Log($"Creating full realm database backup at {filename}", LoggingTarget.Database);
                 using (var source = storage.GetStream(Filename))
                 using (var destination = storage.GetStream(filename, FileAccess.Write, FileMode.CreateNew))
                     source.CopyTo(destination);

From 9a43ed742b0260b29dc28d9221676ffce938f3a8 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 18 Jan 2022 15:21:08 +0900
Subject: [PATCH 2279/5547] Update automapper spec in line with v11

See https://docs.automapper.org/en/latest/11.0-Upgrade-Guide.html for
 more details.
---
 osu.Game/Beatmaps/BeatmapInfo.cs           |  4 --
 osu.Game/Database/RealmObjectExtensions.cs | 56 +++++++++++++++-------
 osu.Game/Scoring/ScoreInfo.cs              |  3 +-
 3 files changed, 39 insertions(+), 24 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapInfo.cs b/osu.Game/Beatmaps/BeatmapInfo.cs
index 224cf60c49..b0e10c2c38 100644
--- a/osu.Game/Beatmaps/BeatmapInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapInfo.cs
@@ -3,7 +3,6 @@
 
 using System;
 using System.Linq;
-using AutoMapper;
 using JetBrains.Annotations;
 using Newtonsoft.Json;
 using osu.Framework.Testing;
@@ -37,7 +36,6 @@ namespace osu.Game.Beatmaps
 
         public BeatmapMetadata Metadata { get; set; }
 
-        [IgnoreMap]
         [Backlink(nameof(ScoreInfo.BeatmapInfo))]
         public IQueryable<ScoreInfo> Scores { get; } = null!;
 
@@ -155,7 +153,6 @@ namespace osu.Game.Beatmaps
         #region Compatibility properties
 
         [Ignored]
-        [IgnoreMap]
         public int RulesetID
         {
             get => Ruleset.OnlineID;
@@ -169,7 +166,6 @@ namespace osu.Game.Beatmaps
         }
 
         [Ignored]
-        [IgnoreMap]
         public BeatmapDifficulty BaseDifficulty
         {
             get => Difficulty;
diff --git a/osu.Game/Database/RealmObjectExtensions.cs b/osu.Game/Database/RealmObjectExtensions.cs
index a162bd64d3..4ddf0077ca 100644
--- a/osu.Game/Database/RealmObjectExtensions.cs
+++ b/osu.Game/Database/RealmObjectExtensions.cs
@@ -4,7 +4,9 @@
 using System;
 using System.Collections.Generic;
 using System.Linq;
+using System.Runtime.Serialization;
 using AutoMapper;
+using AutoMapper.Internal;
 using osu.Framework.Development;
 using osu.Game.Beatmaps;
 using osu.Game.Input.Bindings;
@@ -60,7 +62,14 @@ namespace osu.Game.Database
                  }
              });
 
-            c.AddGlobalIgnore(nameof(RealmObjectBase.ObjectSchema));
+            c.Internal().ForAllMaps((typeMap, expression) =>
+            {
+                expression.ForAllMembers(m =>
+                {
+                    if (m.DestinationMember.Has<IgnoredAttribute>() || m.DestinationMember.Has<BacklinkAttribute>() || m.DestinationMember.Has<IgnoreDataMemberAttribute>())
+                        m.Ignore();
+                });
+            });
         }).CreateMapper();
 
         private static readonly IMapper mapper = new MapperConfiguration(c =>
@@ -80,24 +89,35 @@ namespace osu.Game.Database
             c.CreateMap<RealmUser, RealmUser>();
             c.CreateMap<RealmFile, RealmFile>();
             c.CreateMap<RealmNamedFileUsage, RealmNamedFileUsage>();
-            c.CreateMap<BeatmapInfo, BeatmapInfo>().MaxDepth(2).AfterMap((s, d) =>
-            {
-                for (int i = 0; i < d.BeatmapSet?.Beatmaps.Count; i++)
-                {
-                    if (d.BeatmapSet.Beatmaps[i].Equals(d))
-                    {
-                        d.BeatmapSet.Beatmaps[i] = d;
-                        break;
-                    }
-                }
-            });
-            c.CreateMap<BeatmapSetInfo, BeatmapSetInfo>().MaxDepth(2).AfterMap((s, d) =>
-            {
-                foreach (var beatmap in d.Beatmaps)
-                    beatmap.BeatmapSet = d;
-            });
+            c.CreateMap<BeatmapInfo, BeatmapInfo>()
+             .MaxDepth(2)
+             .AfterMap((s, d) =>
+             {
+                 for (int i = 0; i < d.BeatmapSet?.Beatmaps.Count; i++)
+                 {
+                     if (d.BeatmapSet.Beatmaps[i].Equals(d))
+                     {
+                         d.BeatmapSet.Beatmaps[i] = d;
+                         break;
+                     }
+                 }
+             });
+            c.CreateMap<BeatmapSetInfo, BeatmapSetInfo>()
+             .MaxDepth(2)
+             .AfterMap((s, d) =>
+             {
+                 foreach (var beatmap in d.Beatmaps)
+                     beatmap.BeatmapSet = d;
+             });
 
-            c.AddGlobalIgnore(nameof(RealmObjectBase.ObjectSchema));
+            c.Internal().ForAllMaps((typeMap, expression) =>
+            {
+                expression.ForAllMembers(m =>
+                {
+                    if (m.DestinationMember.Has<IgnoredAttribute>() || m.DestinationMember.Has<BacklinkAttribute>() || m.DestinationMember.Has<IgnoreDataMemberAttribute>())
+                        m.Ignore();
+                });
+            });
         }).CreateMapper();
 
         /// <summary>
diff --git a/osu.Game/Scoring/ScoreInfo.cs b/osu.Game/Scoring/ScoreInfo.cs
index fd0f14266a..5614f34f3f 100644
--- a/osu.Game/Scoring/ScoreInfo.cs
+++ b/osu.Game/Scoring/ScoreInfo.cs
@@ -4,7 +4,6 @@
 using System;
 using System.Collections.Generic;
 using System.Linq;
-using AutoMapper;
 using JetBrains.Annotations;
 using Newtonsoft.Json;
 using osu.Framework.Localisation;
@@ -85,7 +84,7 @@ namespace osu.Game.Scoring
         // Eventually we should either persist enough information to realm to not require the API lookups, or perform the API lookups locally.
         private APIUser? user;
 
-        [IgnoreMap]
+        [Ignored]
         public APIUser User
         {
             get => user ??= new APIUser

From 7084183d6c3a3a126d0c5ddc2401df16e264fab8 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 18 Jan 2022 15:43:02 +0900
Subject: [PATCH 2280/5547] Fix test beatmaps created without hash being
 populated

---
 osu.Game.Tests/Resources/TestResources.cs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Game.Tests/Resources/TestResources.cs b/osu.Game.Tests/Resources/TestResources.cs
index d0ffb9c3db..1d99a5c20d 100644
--- a/osu.Game.Tests/Resources/TestResources.cs
+++ b/osu.Game.Tests/Resources/TestResources.cs
@@ -130,6 +130,7 @@ namespace osu.Game.Tests.Resources
                         StarRating = diff,
                         Length = length,
                         BPM = bpm,
+                        Hash = Guid.NewGuid().ToString().ComputeMD5Hash(),
                         Ruleset = rulesetInfo,
                         Metadata = metadata,
                         BaseDifficulty = new BeatmapDifficulty

From a5862ca00df2e6839abdb47e5dd64f9270d704c5 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 18 Jan 2022 15:46:27 +0900
Subject: [PATCH 2281/5547] Improve reliability of mod deserialisation

---
 osu.Game/Scoring/ScoreInfo.cs | 7 ++-----
 1 file changed, 2 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Scoring/ScoreInfo.cs b/osu.Game/Scoring/ScoreInfo.cs
index 5614f34f3f..e1328d8a06 100644
--- a/osu.Game/Scoring/ScoreInfo.cs
+++ b/osu.Game/Scoring/ScoreInfo.cs
@@ -186,10 +186,7 @@ namespace osu.Game.Scoring
                 if (mods != null)
                     return mods;
 
-                if (apiMods != null)
-                    return APIMods.Select(m => m.ToMod(Ruleset.CreateInstance())).ToArray();
-
-                return Array.Empty<Mod>();
+                return APIMods.Select(m => m.ToMod(Ruleset.CreateInstance())).ToArray();
             }
             set
             {
@@ -216,7 +213,7 @@ namespace osu.Game.Scoring
 
                 // then check mods set via Mods property.
                 if (mods != null)
-                    apiMods = mods.Select(m => new APIMod(m)).ToArray();
+                    apiMods ??= mods.Select(m => new APIMod(m)).ToArray();
 
                 return apiMods ?? Array.Empty<APIMod>();
             }

From 246a4a4bfe3abb8219965c55a9bd56c0317953d0 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 18 Jan 2022 16:05:12 +0900
Subject: [PATCH 2282/5547] Add support for starting with a fresh realm
 database if the existing one is not usable

The most common scenario is switching between schema versions when
testing. This should alleviate the manual overhead of that for the
majority of cases.

For users, this will show a notification on startup if their database
was purged, similar to what we had with EF.
---
 osu.Game/Database/RealmContextFactory.cs | 37 +++++++++++++++++++-----
 1 file changed, 29 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Database/RealmContextFactory.cs b/osu.Game/Database/RealmContextFactory.cs
index 8548e63e94..e6fe5dfc54 100644
--- a/osu.Game/Database/RealmContextFactory.cs
+++ b/osu.Game/Database/RealmContextFactory.cs
@@ -105,8 +105,20 @@ namespace osu.Game.Database
             if (!Filename.EndsWith(realm_extension, StringComparison.Ordinal))
                 Filename += realm_extension;
 
-            // This method triggers the first `CreateContext` call, which will implicitly run realm migrations and bring the schema up-to-date.
-            cleanupPendingDeletions();
+            try
+            {
+                // This method triggers the first `CreateContext` call, which will implicitly run realm migrations and bring the schema up-to-date.
+                cleanupPendingDeletions();
+            }
+            catch (Exception e)
+            {
+                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}");
+                storage.Delete(Filename);
+
+                cleanupPendingDeletions();
+            }
         }
 
         private void cleanupPendingDeletions()
@@ -396,14 +408,23 @@ namespace osu.Game.Database
                 const int sleep_length = 200;
                 int timeout = 5000;
 
-                // see https://github.com/realm/realm-dotnet/discussions/2657
-                while (!Compact())
+                try
                 {
-                    Thread.Sleep(sleep_length);
-                    timeout -= sleep_length;
+                    // see https://github.com/realm/realm-dotnet/discussions/2657
+                    while (!Compact())
+                    {
+                        Thread.Sleep(sleep_length);
+                        timeout -= sleep_length;
 
-                    if (timeout < 0)
-                        throw new TimeoutException(@"Took too long to acquire lock");
+                        if (timeout < 0)
+                            throw new TimeoutException(@"Took too long to acquire lock");
+                    }
+                }
+                catch (Exception e)
+                {
+                    // Compact may fail if the realm is in a bad state.
+                    // We still want to continue with the blocking operation, though.
+                    Logger.Log($"Realm compact failed with error {e}", LoggingTarget.Database);
                 }
             }
             catch

From 8978b88f69300d868635d295104d093b0aafe76b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 18 Jan 2022 16:22:11 +0900
Subject: [PATCH 2283/5547] Add test coverage of startup ruleset being
 non-default

---
 .../Navigation/TestSceneStartupRuleset.cs     | 32 +++++++++++++++++++
 1 file changed, 32 insertions(+)
 create mode 100644 osu.Game.Tests/Visual/Navigation/TestSceneStartupRuleset.cs

diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneStartupRuleset.cs b/osu.Game.Tests/Visual/Navigation/TestSceneStartupRuleset.cs
new file mode 100644
index 0000000000..85dd501fd3
--- /dev/null
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneStartupRuleset.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 NUnit.Framework;
+using osu.Framework.Development;
+using osu.Game.Configuration;
+
+namespace osu.Game.Tests.Visual.Navigation
+{
+    [TestFixture]
+    public class TestSceneStartupRuleset : OsuGameTestScene
+    {
+        protected override TestOsuGame CreateTestGame()
+        {
+            // Must be done in this function due to the RecycleLocalStorage call just before.
+            var config = DebugUtils.IsDebugBuild
+                ? new DevelopmentOsuConfigManager(LocalStorage)
+                : new OsuConfigManager(LocalStorage);
+
+            config.SetValue(OsuSetting.Ruleset, "mania");
+            config.Save();
+
+            return base.CreateTestGame();
+        }
+
+        [Test]
+        public void TestRulesetConsumed()
+        {
+            AddUntilStep("ruleset correct", () => Game.Ruleset.Value.ShortName == "mania");
+        }
+    }
+}

From 8b8940439e770184fe80ce0c87d4387850575cc1 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 18 Jan 2022 16:11:03 +0900
Subject: [PATCH 2284/5547] Fix starting game with non-default ruleset failing

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

diff --git a/osu.Game/OsuGameBase.cs b/osu.Game/OsuGameBase.cs
index 8126b74418..4c6e9689d3 100644
--- a/osu.Game/OsuGameBase.cs
+++ b/osu.Game/OsuGameBase.cs
@@ -451,13 +451,13 @@ namespace osu.Game
 
         private void onBeatmapChanged(ValueChangedEvent<WorkingBeatmap> valueChangedEvent)
         {
-            if (!ThreadSafety.IsUpdateThread)
+            if (IsLoaded && !ThreadSafety.IsUpdateThread)
                 throw new InvalidOperationException("Global beatmap bindable must be changed from update thread.");
         }
 
         private void onRulesetChanged(ValueChangedEvent<RulesetInfo> r)
         {
-            if (!ThreadSafety.IsUpdateThread)
+            if (IsLoaded && !ThreadSafety.IsUpdateThread)
                 throw new InvalidOperationException("Global ruleset bindable must be changed from update thread.");
 
             if (r.NewValue?.Available != true)

From 488f0449249951fd204b4551b6beae7e290e43e0 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 18 Jan 2022 16:46:14 +0900
Subject: [PATCH 2285/5547] Remove one more outdated comment

---
 osu.Game/Tests/Visual/OsuTestScene.cs | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/osu.Game/Tests/Visual/OsuTestScene.cs b/osu.Game/Tests/Visual/OsuTestScene.cs
index c631286d11..4af8ec3a99 100644
--- a/osu.Game/Tests/Visual/OsuTestScene.cs
+++ b/osu.Game/Tests/Visual/OsuTestScene.cs
@@ -294,10 +294,6 @@ namespace osu.Game.Tests.Visual
             if (MusicController?.TrackLoaded == true)
                 MusicController.Stop();
 
-            // TODO: what should we do here, if anything? should we use an in-memory realm in this instance?
-            // if (contextFactory?.IsValueCreated == true)
-            //     contextFactory.Value.ResetDatabase();
-
             RecycleLocalStorage(true);
         }
 

From 3e9e7a8fb61e6af4279b4ee405e9aa8c42674c95 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 18 Jan 2022 16:48:27 +0900
Subject: [PATCH 2286/5547] Fix `PLaylistsResultsScreen` tests falling over due
 to missing beatmap

---
 .../Visual/Playlists/TestScenePlaylistsResultsScreen.cs       | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsResultsScreen.cs b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsResultsScreen.cs
index e9210496ca..11df115b1a 100644
--- a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsResultsScreen.cs
+++ b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsResultsScreen.cs
@@ -44,6 +44,10 @@ namespace osu.Game.Tests.Visual.Playlists
             requestComplete = false;
             totalCount = 0;
             bindHandler();
+
+            // beatmap is required to be an actual beatmap so the scores can get their scores correctly calculated for standardised scoring.
+            // else the tests that rely on ordering will fall over.
+            Beatmap.Value = CreateWorkingBeatmap(Ruleset.Value);
         });
 
         [Test]

From 27ea37c6907cbfe67946bcc62f3f4796b94e8011 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 17 Jan 2022 18:48:11 +0900
Subject: [PATCH 2287/5547] Rewrite `TopLocalRank` to use realm subscriptions

This addresses the number one performance concern with realm (when
entering song select). Previous logic was causing instantiation and
property reads of every score in the database due to the `AsEnumerable`
specfication.
---
 .../Screens/Select/Carousel/TopLocalRank.cs   | 75 ++++++-------------
 1 file changed, 24 insertions(+), 51 deletions(-)

diff --git a/osu.Game/Screens/Select/Carousel/TopLocalRank.cs b/osu.Game/Screens/Select/Carousel/TopLocalRank.cs
index fb1fa09253..f12de8562d 100644
--- a/osu.Game/Screens/Select/Carousel/TopLocalRank.cs
+++ b/osu.Game/Screens/Select/Carousel/TopLocalRank.cs
@@ -6,9 +6,9 @@ using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
-using osu.Framework.Threading;
 using osu.Game.Beatmaps;
 using osu.Game.Database;
+using osu.Game.Models;
 using osu.Game.Online.API;
 using osu.Game.Online.Leaderboards;
 using osu.Game.Rulesets;
@@ -30,72 +30,45 @@ namespace osu.Game.Screens.Select.Carousel
         [Resolved]
         private IAPIProvider api { get; set; }
 
+        private IDisposable scoreSubscription;
+
+        private bool rankUpdatePending;
+
         public TopLocalRank(BeatmapInfo beatmapInfo)
             : base(null)
         {
             this.beatmapInfo = beatmapInfo;
         }
 
-        [BackgroundDependencyLoader]
-        private void load()
-        {
-            ruleset.ValueChanged += _ => fetchAndLoadTopScore();
-
-            fetchAndLoadTopScore();
-        }
-
         protected override void LoadComplete()
         {
             base.LoadComplete();
 
-            scoreSubscription = realmFactory.Context.All<ScoreInfo>()
-                                            .Filter($"{nameof(ScoreInfo.BeatmapInfo)}.{nameof(BeatmapInfo.ID)} = $0", beatmapInfo.ID)
-                                            .QueryAsyncWithNotifications((_, changes, ___) =>
-                                            {
-                                                if (changes == null)
-                                                    return;
-
-                                                fetchTopScoreRank();
-                                            });
-        }
-
-        private IDisposable scoreSubscription;
-
-        private ScheduledDelegate scheduledRankUpdate;
-
-        private void fetchAndLoadTopScore()
-        {
-            // TODO: this lookup likely isn't required, we can use the results of the subscription directly.
-            var rank = fetchTopScoreRank();
-
-            scheduledRankUpdate = Scheduler.Add(() =>
+            ruleset.BindValueChanged(_ =>
             {
-                Rank = rank;
-
+                rankUpdatePending = true;
                 // Required since presence is changed via IsPresent override
                 Invalidate(Invalidation.Presence);
-            });
+
+                scoreSubscription?.Dispose();
+                scoreSubscription = realmFactory.Context.All<ScoreInfo>()
+                                                .Filter($"{nameof(ScoreInfo.User)}.{nameof(RealmUser.OnlineID)} == $0"
+                                                        + $"&& {nameof(ScoreInfo.BeatmapInfo)}.{nameof(BeatmapInfo.ID)} == $1"
+                                                        + $"&& {nameof(ScoreInfo.Ruleset)}.{nameof(RulesetInfo.ShortName)} == $2"
+                                                        + $"&& {nameof(ScoreInfo.DeletePending)} == false", api.LocalUser.Value.Id, beatmapInfo.ID, ruleset.Value.ShortName)
+                                                .OrderByDescending(s => s.TotalScore)
+                                                .QueryAsyncWithNotifications((items, changes, ___) =>
+                                                {
+                                                    if (changes == null)
+                                                        rankUpdatePending = false;
+
+                                                    Rank = items.FirstOrDefault()?.Rank;
+                                                });
+            }, true);
         }
 
         // We're present if a rank is set, or if there is a pending rank update (IsPresent = true is required for the scheduler to run).
-        public override bool IsPresent => base.IsPresent && (Rank != null || scheduledRankUpdate?.Completed == false);
-
-        private ScoreRank? fetchTopScoreRank()
-        {
-            if (realmFactory == null || beatmapInfo == null || ruleset?.Value == null || api?.LocalUser.Value == null)
-                return null;
-
-            using (var realm = realmFactory.CreateContext())
-            {
-                return realm.All<ScoreInfo>()
-                            .AsEnumerable()
-                            // TODO: update to use a realm filter directly (or at least figure out the beatmap part to reduce scope).
-                            .Where(s => s.UserID == api.LocalUser.Value.Id && s.BeatmapInfoID == beatmapInfo.ID && s.RulesetID == ruleset.Value.ID && !s.DeletePending)
-                            .OrderByDescending(s => s.TotalScore)
-                            .FirstOrDefault()
-                            ?.Rank;
-            }
-        }
+        public override bool IsPresent => base.IsPresent && (Rank != null || rankUpdatePending);
 
         protected override void Dispose(bool isDisposing)
         {

From 3b0977903bcb7490dcc488a13ca6dc80f39d3dc0 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 18 Jan 2022 19:12:10 +0900
Subject: [PATCH 2288/5547] Use `IQueryable` directly to avoid insane overheads

---
 osu.Game/Database/EFToRealmMigrator.cs | 37 +++++++++++++-------------
 1 file changed, 19 insertions(+), 18 deletions(-)

diff --git a/osu.Game/Database/EFToRealmMigrator.cs b/osu.Game/Database/EFToRealmMigrator.cs
index 8f5de80e3b..fc75f73e4d 100644
--- a/osu.Game/Database/EFToRealmMigrator.cs
+++ b/osu.Game/Database/EFToRealmMigrator.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 Microsoft.EntityFrameworkCore;
 using osu.Framework.Logging;
@@ -54,13 +53,12 @@ namespace osu.Game.Database
         private void migrateBeatmaps(DatabaseWriteUsage ef)
         {
             // can be removed 20220730.
-            List<EFBeatmapSetInfo> existingBeatmapSets = ef.Context.EFBeatmapSetInfo
-                                                           .Include(s => s.Beatmaps).ThenInclude(b => b.RulesetInfo)
-                                                           .Include(s => s.Beatmaps).ThenInclude(b => b.Metadata)
-                                                           .Include(s => s.Beatmaps).ThenInclude(b => b.BaseDifficulty)
-                                                           .Include(s => s.Files).ThenInclude(f => f.FileInfo)
-                                                           .Include(s => s.Metadata)
-                                                           .ToList();
+            var existingBeatmapSets = ef.Context.EFBeatmapSetInfo
+                                        .Include(s => s.Beatmaps).ThenInclude(b => b.RulesetInfo)
+                                        .Include(s => s.Beatmaps).ThenInclude(b => b.Metadata)
+                                        .Include(s => s.Beatmaps).ThenInclude(b => b.BaseDifficulty)
+                                        .Include(s => s.Files).ThenInclude(f => f.FileInfo)
+                                        .Include(s => s.Metadata);
 
             Logger.Log("Beginning beatmaps migration to realm", LoggingTarget.Database);
 
@@ -71,9 +69,11 @@ namespace osu.Game.Database
                 return;
             }
 
+            int count = existingBeatmapSets.Count();
+
             using (var realm = realmContextFactory.CreateContext())
             {
-                Logger.Log($"Found {existingBeatmapSets.Count} beatmaps in EF", LoggingTarget.Database);
+                Logger.Log($"Found {count} beatmaps in EF", LoggingTarget.Database);
                 string migration = $"before_beatmap_migration_{DateTimeOffset.UtcNow.ToUnixTimeSeconds()}";
                 efContextFactory.CreateBackup($"client.{migration}.db");
 
@@ -147,7 +147,7 @@ namespace osu.Game.Database
                     }
                 }
 
-                Logger.Log($"Successfully migrated {existingBeatmapSets.Count} beatmaps to realm", LoggingTarget.Database);
+                Logger.Log($"Successfully migrated {count} beatmaps to realm", LoggingTarget.Database);
                 ef.Context.RemoveRange(existingBeatmapSets);
                 // Intentionally don't clean up the files, so they don't get purged by EF.
             }
@@ -180,12 +180,11 @@ namespace osu.Game.Database
         private void migrateScores(DatabaseWriteUsage db)
         {
             // can be removed 20220730.
-            List<EFScoreInfo> existingScores = db.Context.ScoreInfo
-                                                 .Include(s => s.Ruleset)
-                                                 .Include(s => s.BeatmapInfo)
-                                                 .Include(s => s.Files)
-                                                 .ThenInclude(f => f.FileInfo)
-                                                 .ToList();
+            var existingScores = db.Context.ScoreInfo
+                                   .Include(s => s.Ruleset)
+                                   .Include(s => s.BeatmapInfo)
+                                   .Include(s => s.Files)
+                                   .ThenInclude(f => f.FileInfo);
 
             Logger.Log("Beginning scores migration to realm", LoggingTarget.Database);
 
@@ -196,9 +195,11 @@ namespace osu.Game.Database
                 return;
             }
 
+            int count = existingScores.Count();
+
             using (var realm = realmContextFactory.CreateContext())
             {
-                Logger.Log($"Found {existingScores.Count} scores in EF", LoggingTarget.Database);
+                Logger.Log($"Found {count} scores in EF", LoggingTarget.Database);
                 string migration = $"before_score_migration_{DateTimeOffset.UtcNow.ToUnixTimeSeconds()}";
                 efContextFactory.CreateBackup($"client.{migration}.db");
 
@@ -251,7 +252,7 @@ namespace osu.Game.Database
                     }
                 }
 
-                Logger.Log($"Successfully migrated {existingScores.Count} scores to realm", LoggingTarget.Database);
+                Logger.Log($"Successfully migrated {count} scores to realm", LoggingTarget.Database);
                 db.Context.RemoveRange(existingScores);
                 // Intentionally don't clean up the files, so they don't get purged by EF.
             }

From 519f7e6ad2ba914bb79a7f44563294f70a2b4204 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 18 Jan 2022 19:14:27 +0900
Subject: [PATCH 2289/5547] Don't bother with removing from EF as the file is
 going to be deleted anyway

---
 osu.Game/Database/EFToRealmMigrator.cs | 9 ---------
 1 file changed, 9 deletions(-)

diff --git a/osu.Game/Database/EFToRealmMigrator.cs b/osu.Game/Database/EFToRealmMigrator.cs
index fc75f73e4d..1a8b312c6c 100644
--- a/osu.Game/Database/EFToRealmMigrator.cs
+++ b/osu.Game/Database/EFToRealmMigrator.cs
@@ -148,8 +148,6 @@ namespace osu.Game.Database
                 }
 
                 Logger.Log($"Successfully migrated {count} beatmaps to realm", LoggingTarget.Database);
-                ef.Context.RemoveRange(existingBeatmapSets);
-                // Intentionally don't clean up the files, so they don't get purged by EF.
             }
         }
 
@@ -253,8 +251,6 @@ namespace osu.Game.Database
                 }
 
                 Logger.Log($"Successfully migrated {count} scores to realm", LoggingTarget.Database);
-                db.Context.RemoveRange(existingScores);
-                // Intentionally don't clean up the files, so they don't get purged by EF.
             }
         }
 
@@ -313,9 +309,6 @@ namespace osu.Game.Database
                     }
                 }
 
-                db.Context.RemoveRange(existingSkins);
-                // Intentionally don't clean up the files, so they don't get purged by EF.
-
                 transaction.Commit();
             }
         }
@@ -372,8 +365,6 @@ namespace osu.Game.Database
                     }
                 }
 
-                db.Context.RemoveRange(existingSettings);
-
                 transaction.Commit();
             }
         }

From f5b8653491279056417a7676fcbf0b677bdbbe1b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 18 Jan 2022 19:28:09 +0900
Subject: [PATCH 2290/5547] Add spaces to query string

---
 osu.Game/Screens/Select/Carousel/TopLocalRank.cs | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Screens/Select/Carousel/TopLocalRank.cs b/osu.Game/Screens/Select/Carousel/TopLocalRank.cs
index f12de8562d..4542ab897b 100644
--- a/osu.Game/Screens/Select/Carousel/TopLocalRank.cs
+++ b/osu.Game/Screens/Select/Carousel/TopLocalRank.cs
@@ -53,9 +53,9 @@ namespace osu.Game.Screens.Select.Carousel
                 scoreSubscription?.Dispose();
                 scoreSubscription = realmFactory.Context.All<ScoreInfo>()
                                                 .Filter($"{nameof(ScoreInfo.User)}.{nameof(RealmUser.OnlineID)} == $0"
-                                                        + $"&& {nameof(ScoreInfo.BeatmapInfo)}.{nameof(BeatmapInfo.ID)} == $1"
-                                                        + $"&& {nameof(ScoreInfo.Ruleset)}.{nameof(RulesetInfo.ShortName)} == $2"
-                                                        + $"&& {nameof(ScoreInfo.DeletePending)} == false", api.LocalUser.Value.Id, beatmapInfo.ID, ruleset.Value.ShortName)
+                                                        + $" && {nameof(ScoreInfo.BeatmapInfo)}.{nameof(BeatmapInfo.ID)} == $1"
+                                                        + $" && {nameof(ScoreInfo.Ruleset)}.{nameof(RulesetInfo.ShortName)} == $2"
+                                                        + $" && {nameof(ScoreInfo.DeletePending)} == false", api.LocalUser.Value.Id, beatmapInfo.ID, ruleset.Value.ShortName)
                                                 .OrderByDescending(s => s.TotalScore)
                                                 .QueryAsyncWithNotifications((items, changes, ___) =>
                                                 {

From bb5b9458e8130a2a5f213e968f5590d00ede3d87 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 12 Jan 2022 17:03:23 +0900
Subject: [PATCH 2291/5547] Remove all EF migrations

---
 .../20171019041408_InitialCreate.Designer.cs  | 293 ----------
 .../20171019041408_InitialCreate.cs           | 311 -----------
 ...025071459_AddMissingIndexRules.Designer.cs | 299 ----------
 .../20171025071459_AddMissingIndexRules.cs    |  80 ---
 ...eatmapOnlineIDUniqueConstraint.Designer.cs | 302 ----------
 ...5731_AddBeatmapOnlineIDUniqueConstraint.cs |  23 -
 ...034410_AddRulesetInfoShortName.Designer.cs | 307 -----------
 .../20171209034410_AddRulesetInfoShortName.cs |  33 --
 .../20180125143340_Settings.Designer.cs       | 329 -----------
 .../Migrations/20180125143340_Settings.cs     |  55 --
 .../20180131154205_AddMuteBinding.cs          |  23 -
 .../20180219060912_AddSkins.Designer.cs       | 379 -------------
 .../Migrations/20180219060912_AddSkins.cs     |  71 ---
 ...54_RemoveUniqueHashConstraints.Designer.cs | 377 -------------
 ...80529055154_RemoveUniqueHashConstraints.cs |  51 --
 ...111_UpdateTaikoDefaultBindings.Designer.cs | 376 -------------
 ...180621044111_UpdateTaikoDefaultBindings.cs |  17 -
 ...628011956_RemoveNegativeSetIDs.Designer.cs | 376 -------------
 .../20180628011956_RemoveNegativeSetIDs.cs    |  18 -
 .../20180913080842_AddRankStatus.Designer.cs  | 380 -------------
 .../20180913080842_AddRankStatus.cs           |  33 --
 ...0181007180454_StandardizePaths.Designer.cs | 380 -------------
 .../20181007180454_StandardizePaths.cs        |  26 -
 ...20181128100659_AddSkinInfoHash.Designer.cs | 387 -------------
 .../20181128100659_AddSkinInfoHash.cs         |  41 --
 ...81130113755_AddScoreInfoTables.Designer.cs | 484 ----------------
 .../20181130113755_AddScoreInfoTables.cs      | 112 ----
 ...20190225062029_AddUserIDColumn.Designer.cs | 487 -----------------
 .../20190225062029_AddUserIDColumn.cs         |  22 -
 .../20190525060824_SkinSettings.Designer.cs   | 498 -----------------
 .../Migrations/20190525060824_SkinSettings.cs |  54 --
 ...AddDateAddedColumnToBeatmapSet.Designer.cs | 489 -----------------
 ...05091246_AddDateAddedColumnToBeatmapSet.cs |  24 -
 ...8070844_AddBPMAndLengthColumns.Designer.cs | 504 -----------------
 .../20190708070844_AddBPMAndLengthColumns.cs  |  33 --
 ...20190913104727_AddBeatmapVideo.Designer.cs | 506 -----------------
 .../20190913104727_AddBeatmapVideo.cs         |  22 -
 ...02094919_RefreshVolumeBindings.Designer.cs | 506 -----------------
 .../20200302094919_RefreshVolumeBindings.cs   |  16 -
 ...01019224408_AddEpilepsyWarning.Designer.cs | 508 -----------------
 .../20201019224408_AddEpilepsyWarning.cs      |  23 -
 ...700_RefreshVolumeBindingsAgain.Designer.cs | 506 -----------------
 ...210412045700_RefreshVolumeBindingsAgain.cs |  16 -
 ...60743_AddSkinInstantiationInfo.Designer.cs | 508 -----------------
 ...20210511060743_AddSkinInstantiationInfo.cs |  22 -
 ...9_AddAuthorIdToBeatmapMetadata.Designer.cs | 511 -----------------
 ...0514062639_AddAuthorIdToBeatmapMetadata.cs |  23 -
 ...824185035_AddCountdownSettings.Designer.cs | 513 -----------------
 .../20210824185035_AddCountdownSettings.cs    |  23 -
 ...11_AddSamplesMatchPlaybackRate.Designer.cs | 515 ------------------
 ...10912144011_AddSamplesMatchPlaybackRate.cs |  23 -
 .../20211020081609_ResetSkinHashes.cs         |  23 -
 .../Migrations/OsuDbContextModelSnapshot.cs   | 513 -----------------
 53 files changed, 12451 deletions(-)
 delete mode 100644 osu.Game/Migrations/20171019041408_InitialCreate.Designer.cs
 delete mode 100644 osu.Game/Migrations/20171019041408_InitialCreate.cs
 delete mode 100644 osu.Game/Migrations/20171025071459_AddMissingIndexRules.Designer.cs
 delete mode 100644 osu.Game/Migrations/20171025071459_AddMissingIndexRules.cs
 delete mode 100644 osu.Game/Migrations/20171119065731_AddBeatmapOnlineIDUniqueConstraint.Designer.cs
 delete mode 100644 osu.Game/Migrations/20171119065731_AddBeatmapOnlineIDUniqueConstraint.cs
 delete mode 100644 osu.Game/Migrations/20171209034410_AddRulesetInfoShortName.Designer.cs
 delete mode 100644 osu.Game/Migrations/20171209034410_AddRulesetInfoShortName.cs
 delete mode 100644 osu.Game/Migrations/20180125143340_Settings.Designer.cs
 delete mode 100644 osu.Game/Migrations/20180125143340_Settings.cs
 delete mode 100644 osu.Game/Migrations/20180131154205_AddMuteBinding.cs
 delete mode 100644 osu.Game/Migrations/20180219060912_AddSkins.Designer.cs
 delete mode 100644 osu.Game/Migrations/20180219060912_AddSkins.cs
 delete mode 100644 osu.Game/Migrations/20180529055154_RemoveUniqueHashConstraints.Designer.cs
 delete mode 100644 osu.Game/Migrations/20180529055154_RemoveUniqueHashConstraints.cs
 delete mode 100644 osu.Game/Migrations/20180621044111_UpdateTaikoDefaultBindings.Designer.cs
 delete mode 100644 osu.Game/Migrations/20180621044111_UpdateTaikoDefaultBindings.cs
 delete mode 100644 osu.Game/Migrations/20180628011956_RemoveNegativeSetIDs.Designer.cs
 delete mode 100644 osu.Game/Migrations/20180628011956_RemoveNegativeSetIDs.cs
 delete mode 100644 osu.Game/Migrations/20180913080842_AddRankStatus.Designer.cs
 delete mode 100644 osu.Game/Migrations/20180913080842_AddRankStatus.cs
 delete mode 100644 osu.Game/Migrations/20181007180454_StandardizePaths.Designer.cs
 delete mode 100644 osu.Game/Migrations/20181007180454_StandardizePaths.cs
 delete mode 100644 osu.Game/Migrations/20181128100659_AddSkinInfoHash.Designer.cs
 delete mode 100644 osu.Game/Migrations/20181128100659_AddSkinInfoHash.cs
 delete mode 100644 osu.Game/Migrations/20181130113755_AddScoreInfoTables.Designer.cs
 delete mode 100644 osu.Game/Migrations/20181130113755_AddScoreInfoTables.cs
 delete mode 100644 osu.Game/Migrations/20190225062029_AddUserIDColumn.Designer.cs
 delete mode 100644 osu.Game/Migrations/20190225062029_AddUserIDColumn.cs
 delete mode 100644 osu.Game/Migrations/20190525060824_SkinSettings.Designer.cs
 delete mode 100644 osu.Game/Migrations/20190525060824_SkinSettings.cs
 delete mode 100644 osu.Game/Migrations/20190605091246_AddDateAddedColumnToBeatmapSet.Designer.cs
 delete mode 100644 osu.Game/Migrations/20190605091246_AddDateAddedColumnToBeatmapSet.cs
 delete mode 100644 osu.Game/Migrations/20190708070844_AddBPMAndLengthColumns.Designer.cs
 delete mode 100644 osu.Game/Migrations/20190708070844_AddBPMAndLengthColumns.cs
 delete mode 100644 osu.Game/Migrations/20190913104727_AddBeatmapVideo.Designer.cs
 delete mode 100644 osu.Game/Migrations/20190913104727_AddBeatmapVideo.cs
 delete mode 100644 osu.Game/Migrations/20200302094919_RefreshVolumeBindings.Designer.cs
 delete mode 100644 osu.Game/Migrations/20200302094919_RefreshVolumeBindings.cs
 delete mode 100644 osu.Game/Migrations/20201019224408_AddEpilepsyWarning.Designer.cs
 delete mode 100644 osu.Game/Migrations/20201019224408_AddEpilepsyWarning.cs
 delete mode 100644 osu.Game/Migrations/20210412045700_RefreshVolumeBindingsAgain.Designer.cs
 delete mode 100644 osu.Game/Migrations/20210412045700_RefreshVolumeBindingsAgain.cs
 delete mode 100644 osu.Game/Migrations/20210511060743_AddSkinInstantiationInfo.Designer.cs
 delete mode 100644 osu.Game/Migrations/20210511060743_AddSkinInstantiationInfo.cs
 delete mode 100644 osu.Game/Migrations/20210514062639_AddAuthorIdToBeatmapMetadata.Designer.cs
 delete mode 100644 osu.Game/Migrations/20210514062639_AddAuthorIdToBeatmapMetadata.cs
 delete mode 100644 osu.Game/Migrations/20210824185035_AddCountdownSettings.Designer.cs
 delete mode 100644 osu.Game/Migrations/20210824185035_AddCountdownSettings.cs
 delete mode 100644 osu.Game/Migrations/20210912144011_AddSamplesMatchPlaybackRate.Designer.cs
 delete mode 100644 osu.Game/Migrations/20210912144011_AddSamplesMatchPlaybackRate.cs
 delete mode 100644 osu.Game/Migrations/20211020081609_ResetSkinHashes.cs
 delete mode 100644 osu.Game/Migrations/OsuDbContextModelSnapshot.cs

diff --git a/osu.Game/Migrations/20171019041408_InitialCreate.Designer.cs b/osu.Game/Migrations/20171019041408_InitialCreate.Designer.cs
deleted file mode 100644
index c751530bf4..0000000000
--- a/osu.Game/Migrations/20171019041408_InitialCreate.Designer.cs
+++ /dev/null
@@ -1,293 +0,0 @@
-// <auto-generated />
-using Microsoft.EntityFrameworkCore;
-using Microsoft.EntityFrameworkCore.Infrastructure;
-using Microsoft.EntityFrameworkCore.Metadata;
-using Microsoft.EntityFrameworkCore.Migrations;
-using Microsoft.EntityFrameworkCore.Storage;
-using osu.Game.Database;
-using System;
-
-namespace osu.Game.Migrations
-{
-    [DbContext(typeof(OsuDbContext))]
-    [Migration("20171019041408_InitialCreate")]
-    partial class InitialCreate
-    {
-        protected override void BuildTargetModel(ModelBuilder modelBuilder)
-        {
-#pragma warning disable 612, 618
-            modelBuilder
-                .HasAnnotation("ProductVersion", "2.0.0-rtm-26452");
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapDifficulty", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<float>("ApproachRate");
-
-                    b.Property<float>("CircleSize");
-
-                    b.Property<float>("DrainRate");
-
-                    b.Property<float>("OverallDifficulty");
-
-                    b.Property<float>("SliderMultiplier");
-
-                    b.Property<float>("SliderTickRate");
-
-                    b.HasKey("ID");
-
-                    b.ToTable("BeatmapDifficulty");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("AudioLeadIn");
-
-                    b.Property<int>("BaseDifficultyID");
-
-                    b.Property<int>("BeatDivisor");
-
-                    b.Property<int>("BeatmapSetInfoID");
-
-                    b.Property<bool>("Countdown");
-
-                    b.Property<double>("DistanceSpacing");
-
-                    b.Property<int>("GridSize");
-
-                    b.Property<string>("Hash");
-
-                    b.Property<bool>("Hidden");
-
-                    b.Property<bool>("LetterboxInBreaks");
-
-                    b.Property<string>("MD5Hash");
-
-                    b.Property<int?>("MetadataID");
-
-                    b.Property<int?>("OnlineBeatmapID");
-
-                    b.Property<string>("Path");
-
-                    b.Property<int>("RulesetID");
-
-                    b.Property<bool>("SpecialStyle");
-
-                    b.Property<float>("StackLeniency");
-
-                    b.Property<double>("StarDifficulty");
-
-                    b.Property<string>("StoredBookmarks");
-
-                    b.Property<double>("TimelineZoom");
-
-                    b.Property<string>("Version");
-
-                    b.Property<bool>("WidescreenStoryboard");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("BaseDifficultyID");
-
-                    b.HasIndex("BeatmapSetInfoID");
-
-                    b.HasIndex("Hash");
-
-                    b.HasIndex("MD5Hash");
-
-                    b.HasIndex("MetadataID");
-
-                    b.HasIndex("RulesetID");
-
-                    b.ToTable("BeatmapInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapMetadata", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Artist");
-
-                    b.Property<string>("ArtistUnicode");
-
-                    b.Property<string>("AudioFile");
-
-                    b.Property<string>("AuthorString")
-                        .HasColumnName("Author");
-
-                    b.Property<string>("BackgroundFile");
-
-                    b.Property<int>("PreviewTime");
-
-                    b.Property<string>("Source");
-
-                    b.Property<string>("Tags");
-
-                    b.Property<string>("Title");
-
-                    b.Property<string>("TitleUnicode");
-
-                    b.HasKey("ID");
-
-                    b.ToTable("BeatmapMetadata");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("BeatmapSetInfoID");
-
-                    b.Property<int>("FileInfoID");
-
-                    b.Property<string>("Filename")
-                        .IsRequired();
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("BeatmapSetInfoID");
-
-                    b.HasIndex("FileInfoID");
-
-                    b.ToTable("BeatmapSetFileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<bool>("DeletePending");
-
-                    b.Property<string>("Hash");
-
-                    b.Property<int?>("MetadataID");
-
-                    b.Property<int?>("OnlineBeatmapSetID");
-
-                    b.Property<bool>("Protected");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("DeletePending");
-
-                    b.HasIndex("Hash");
-
-                    b.HasIndex("MetadataID");
-
-                    b.ToTable("BeatmapSetInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Input.Bindings.DatabasedKeyBinding", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("IntAction")
-                        .HasColumnName("Action");
-
-                    b.Property<string>("KeysString")
-                        .HasColumnName("Keys");
-
-                    b.Property<int?>("RulesetID");
-
-                    b.Property<int?>("Variant");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("IntAction");
-
-                    b.HasIndex("Variant");
-
-                    b.ToTable("KeyBinding");
-                });
-
-            modelBuilder.Entity("osu.Game.IO.FileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Hash");
-
-                    b.Property<int>("ReferenceCount");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("Hash")
-                        .IsUnique();
-
-                    b.HasIndex("ReferenceCount");
-
-                    b.ToTable("FileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Rulesets.RulesetInfo", b =>
-                {
-                    b.Property<int?>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<bool>("Available");
-
-                    b.Property<string>("InstantiationInfo");
-
-                    b.Property<string>("Name");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("Available");
-
-                    b.ToTable("RulesetInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapDifficulty", "BaseDifficulty")
-                        .WithMany()
-                        .HasForeignKey("BaseDifficultyID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo", "BeatmapSet")
-                        .WithMany("Beatmaps")
-                        .HasForeignKey("BeatmapSetInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
-                        .WithMany("Beatmaps")
-                        .HasForeignKey("MetadataID");
-
-                    b.HasOne("osu.Game.Rulesets.RulesetInfo", "Ruleset")
-                        .WithMany()
-                        .HasForeignKey("RulesetID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo")
-                        .WithMany("Files")
-                        .HasForeignKey("BeatmapSetInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
-                        .WithMany()
-                        .HasForeignKey("FileInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
-                        .WithMany("BeatmapSets")
-                        .HasForeignKey("MetadataID");
-                });
-#pragma warning restore 612, 618
-        }
-    }
-}
diff --git a/osu.Game/Migrations/20171019041408_InitialCreate.cs b/osu.Game/Migrations/20171019041408_InitialCreate.cs
deleted file mode 100644
index 9b6881f98c..0000000000
--- a/osu.Game/Migrations/20171019041408_InitialCreate.cs
+++ /dev/null
@@ -1,311 +0,0 @@
-using Microsoft.EntityFrameworkCore.Migrations;
-
-namespace osu.Game.Migrations
-{
-    public partial class InitialCreate : Migration
-    {
-        protected override void Up(MigrationBuilder migrationBuilder)
-        {
-            migrationBuilder.CreateTable(
-                name: "BeatmapDifficulty",
-                columns: table => new
-                {
-                    ID = table.Column<int>(type: "INTEGER", nullable: false)
-                        .Annotation("Sqlite:Autoincrement", true),
-                    ApproachRate = table.Column<float>(type: "REAL", nullable: false),
-                    CircleSize = table.Column<float>(type: "REAL", nullable: false),
-                    DrainRate = table.Column<float>(type: "REAL", nullable: false),
-                    OverallDifficulty = table.Column<float>(type: "REAL", nullable: false),
-                    SliderMultiplier = table.Column<float>(type: "REAL", nullable: false),
-                    SliderTickRate = table.Column<float>(type: "REAL", nullable: false)
-                },
-                constraints: table =>
-                {
-                    table.PrimaryKey("PK_BeatmapDifficulty", x => x.ID);
-                });
-
-            migrationBuilder.CreateTable(
-                name: "BeatmapMetadata",
-                columns: table => new
-                {
-                    ID = table.Column<int>(type: "INTEGER", nullable: false)
-                        .Annotation("Sqlite:Autoincrement", true),
-                    Artist = table.Column<string>(type: "TEXT", nullable: true),
-                    ArtistUnicode = table.Column<string>(type: "TEXT", nullable: true),
-                    AudioFile = table.Column<string>(type: "TEXT", nullable: true),
-                    Author = table.Column<string>(type: "TEXT", nullable: true),
-                    BackgroundFile = table.Column<string>(type: "TEXT", nullable: true),
-                    PreviewTime = table.Column<int>(type: "INTEGER", nullable: false),
-                    Source = table.Column<string>(type: "TEXT", nullable: true),
-                    Tags = table.Column<string>(type: "TEXT", nullable: true),
-                    Title = table.Column<string>(type: "TEXT", nullable: true),
-                    TitleUnicode = table.Column<string>(type: "TEXT", nullable: true)
-                },
-                constraints: table =>
-                {
-                    table.PrimaryKey("PK_BeatmapMetadata", x => x.ID);
-                });
-
-            migrationBuilder.CreateTable(
-                name: "FileInfo",
-                columns: table => new
-                {
-                    ID = table.Column<int>(type: "INTEGER", nullable: false)
-                        .Annotation("Sqlite:Autoincrement", true),
-                    Hash = table.Column<string>(type: "TEXT", nullable: true),
-                    ReferenceCount = table.Column<int>(type: "INTEGER", nullable: false)
-                },
-                constraints: table =>
-                {
-                    table.PrimaryKey("PK_FileInfo", x => x.ID);
-                });
-
-            migrationBuilder.CreateTable(
-                name: "KeyBinding",
-                columns: table => new
-                {
-                    ID = table.Column<int>(type: "INTEGER", nullable: false)
-                        .Annotation("Sqlite:Autoincrement", true),
-                    Action = table.Column<int>(type: "INTEGER", nullable: false),
-                    Keys = table.Column<string>(type: "TEXT", nullable: true),
-                    RulesetID = table.Column<int>(type: "INTEGER", nullable: true),
-                    Variant = table.Column<int>(type: "INTEGER", nullable: true)
-                },
-                constraints: table =>
-                {
-                    table.PrimaryKey("PK_KeyBinding", x => x.ID);
-                });
-
-            migrationBuilder.CreateTable(
-                name: "RulesetInfo",
-                columns: table => new
-                {
-                    ID = table.Column<int>(type: "INTEGER", nullable: false)
-                        .Annotation("Sqlite:Autoincrement", true),
-                    Available = table.Column<bool>(type: "INTEGER", nullable: false),
-                    InstantiationInfo = table.Column<string>(type: "TEXT", nullable: true),
-                    Name = table.Column<string>(type: "TEXT", nullable: true)
-                },
-                constraints: table =>
-                {
-                    table.PrimaryKey("PK_RulesetInfo", x => x.ID);
-                });
-
-            migrationBuilder.CreateTable(
-                name: "BeatmapSetInfo",
-                columns: table => new
-                {
-                    ID = table.Column<int>(type: "INTEGER", nullable: false)
-                        .Annotation("Sqlite:Autoincrement", true),
-                    DeletePending = table.Column<bool>(type: "INTEGER", nullable: false),
-                    Hash = table.Column<string>(type: "TEXT", nullable: true),
-                    MetadataID = table.Column<int>(type: "INTEGER", nullable: true),
-                    OnlineBeatmapSetID = table.Column<int>(type: "INTEGER", nullable: true),
-                    Protected = table.Column<bool>(type: "INTEGER", nullable: false)
-                },
-                constraints: table =>
-                {
-                    table.PrimaryKey("PK_BeatmapSetInfo", x => x.ID);
-                    table.ForeignKey(
-                        name: "FK_BeatmapSetInfo_BeatmapMetadata_MetadataID",
-                        column: x => x.MetadataID,
-                        principalTable: "BeatmapMetadata",
-                        principalColumn: "ID",
-                        onDelete: ReferentialAction.Restrict);
-                });
-
-            migrationBuilder.CreateTable(
-                name: "BeatmapInfo",
-                columns: table => new
-                {
-                    ID = table.Column<int>(type: "INTEGER", nullable: false)
-                        .Annotation("Sqlite:Autoincrement", true),
-                    AudioLeadIn = table.Column<int>(type: "INTEGER", nullable: false),
-                    BaseDifficultyID = table.Column<int>(type: "INTEGER", nullable: false),
-                    BeatDivisor = table.Column<int>(type: "INTEGER", nullable: false),
-                    BeatmapSetInfoID = table.Column<int>(type: "INTEGER", nullable: false),
-                    Countdown = table.Column<bool>(type: "INTEGER", nullable: false),
-                    DistanceSpacing = table.Column<double>(type: "REAL", nullable: false),
-                    GridSize = table.Column<int>(type: "INTEGER", nullable: false),
-                    Hash = table.Column<string>(type: "TEXT", nullable: true),
-                    Hidden = table.Column<bool>(type: "INTEGER", nullable: false),
-                    LetterboxInBreaks = table.Column<bool>(type: "INTEGER", nullable: false),
-                    MD5Hash = table.Column<string>(type: "TEXT", nullable: true),
-                    MetadataID = table.Column<int>(type: "INTEGER", nullable: true),
-                    OnlineBeatmapID = table.Column<int>(type: "INTEGER", nullable: true),
-                    Path = table.Column<string>(type: "TEXT", nullable: true),
-                    RulesetID = table.Column<int>(type: "INTEGER", nullable: false),
-                    SpecialStyle = table.Column<bool>(type: "INTEGER", nullable: false),
-                    StackLeniency = table.Column<float>(type: "REAL", nullable: false),
-                    StarDifficulty = table.Column<double>(type: "REAL", nullable: false),
-                    StoredBookmarks = table.Column<string>(type: "TEXT", nullable: true),
-                    TimelineZoom = table.Column<double>(type: "REAL", nullable: false),
-                    Version = table.Column<string>(type: "TEXT", nullable: true),
-                    WidescreenStoryboard = table.Column<bool>(type: "INTEGER", nullable: false)
-                },
-                constraints: table =>
-                {
-                    table.PrimaryKey("PK_BeatmapInfo", x => x.ID);
-                    table.ForeignKey(
-                        name: "FK_BeatmapInfo_BeatmapDifficulty_BaseDifficultyID",
-                        column: x => x.BaseDifficultyID,
-                        principalTable: "BeatmapDifficulty",
-                        principalColumn: "ID",
-                        onDelete: ReferentialAction.Cascade);
-                    table.ForeignKey(
-                        name: "FK_BeatmapInfo_BeatmapSetInfo_BeatmapSetInfoID",
-                        column: x => x.BeatmapSetInfoID,
-                        principalTable: "BeatmapSetInfo",
-                        principalColumn: "ID",
-                        onDelete: ReferentialAction.Cascade);
-                    table.ForeignKey(
-                        name: "FK_BeatmapInfo_BeatmapMetadata_MetadataID",
-                        column: x => x.MetadataID,
-                        principalTable: "BeatmapMetadata",
-                        principalColumn: "ID",
-                        onDelete: ReferentialAction.Restrict);
-                    table.ForeignKey(
-                        name: "FK_BeatmapInfo_RulesetInfo_RulesetID",
-                        column: x => x.RulesetID,
-                        principalTable: "RulesetInfo",
-                        principalColumn: "ID",
-                        onDelete: ReferentialAction.Cascade);
-                });
-
-            migrationBuilder.CreateTable(
-                name: "BeatmapSetFileInfo",
-                columns: table => new
-                {
-                    ID = table.Column<int>(type: "INTEGER", nullable: false)
-                        .Annotation("Sqlite:Autoincrement", true),
-                    BeatmapSetInfoID = table.Column<int>(type: "INTEGER", nullable: false),
-                    FileInfoID = table.Column<int>(type: "INTEGER", nullable: false),
-                    Filename = table.Column<string>(type: "TEXT", nullable: false)
-                },
-                constraints: table =>
-                {
-                    table.PrimaryKey("PK_BeatmapSetFileInfo", x => x.ID);
-                    table.ForeignKey(
-                        name: "FK_BeatmapSetFileInfo_BeatmapSetInfo_BeatmapSetInfoID",
-                        column: x => x.BeatmapSetInfoID,
-                        principalTable: "BeatmapSetInfo",
-                        principalColumn: "ID",
-                        onDelete: ReferentialAction.Cascade);
-                    table.ForeignKey(
-                        name: "FK_BeatmapSetFileInfo_FileInfo_FileInfoID",
-                        column: x => x.FileInfoID,
-                        principalTable: "FileInfo",
-                        principalColumn: "ID",
-                        onDelete: ReferentialAction.Cascade);
-                });
-
-            migrationBuilder.CreateIndex(
-                name: "IX_BeatmapInfo_BaseDifficultyID",
-                table: "BeatmapInfo",
-                column: "BaseDifficultyID");
-
-            migrationBuilder.CreateIndex(
-                name: "IX_BeatmapInfo_BeatmapSetInfoID",
-                table: "BeatmapInfo",
-                column: "BeatmapSetInfoID");
-
-            migrationBuilder.CreateIndex(
-                name: "IX_BeatmapInfo_Hash",
-                table: "BeatmapInfo",
-                column: "Hash");
-
-            migrationBuilder.CreateIndex(
-                name: "IX_BeatmapInfo_MD5Hash",
-                table: "BeatmapInfo",
-                column: "MD5Hash");
-
-            migrationBuilder.CreateIndex(
-                name: "IX_BeatmapInfo_MetadataID",
-                table: "BeatmapInfo",
-                column: "MetadataID");
-
-            migrationBuilder.CreateIndex(
-                name: "IX_BeatmapInfo_RulesetID",
-                table: "BeatmapInfo",
-                column: "RulesetID");
-
-            migrationBuilder.CreateIndex(
-                name: "IX_BeatmapSetFileInfo_BeatmapSetInfoID",
-                table: "BeatmapSetFileInfo",
-                column: "BeatmapSetInfoID");
-
-            migrationBuilder.CreateIndex(
-                name: "IX_BeatmapSetFileInfo_FileInfoID",
-                table: "BeatmapSetFileInfo",
-                column: "FileInfoID");
-
-            migrationBuilder.CreateIndex(
-                name: "IX_BeatmapSetInfo_DeletePending",
-                table: "BeatmapSetInfo",
-                column: "DeletePending");
-
-            migrationBuilder.CreateIndex(
-                name: "IX_BeatmapSetInfo_Hash",
-                table: "BeatmapSetInfo",
-                column: "Hash");
-
-            migrationBuilder.CreateIndex(
-                name: "IX_BeatmapSetInfo_MetadataID",
-                table: "BeatmapSetInfo",
-                column: "MetadataID");
-
-            migrationBuilder.CreateIndex(
-                name: "IX_FileInfo_Hash",
-                table: "FileInfo",
-                column: "Hash",
-                unique: true);
-
-            migrationBuilder.CreateIndex(
-                name: "IX_FileInfo_ReferenceCount",
-                table: "FileInfo",
-                column: "ReferenceCount");
-
-            migrationBuilder.CreateIndex(
-                name: "IX_KeyBinding_Action",
-                table: "KeyBinding",
-                column: "Action");
-
-            migrationBuilder.CreateIndex(
-                name: "IX_KeyBinding_Variant",
-                table: "KeyBinding",
-                column: "Variant");
-
-            migrationBuilder.CreateIndex(
-                name: "IX_RulesetInfo_Available",
-                table: "RulesetInfo",
-                column: "Available");
-        }
-
-        protected override void Down(MigrationBuilder migrationBuilder)
-        {
-            migrationBuilder.DropTable(
-                name: "BeatmapInfo");
-
-            migrationBuilder.DropTable(
-                name: "BeatmapSetFileInfo");
-
-            migrationBuilder.DropTable(
-                name: "KeyBinding");
-
-            migrationBuilder.DropTable(
-                name: "BeatmapDifficulty");
-
-            migrationBuilder.DropTable(
-                name: "RulesetInfo");
-
-            migrationBuilder.DropTable(
-                name: "BeatmapSetInfo");
-
-            migrationBuilder.DropTable(
-                name: "FileInfo");
-
-            migrationBuilder.DropTable(
-                name: "BeatmapMetadata");
-        }
-    }
-}
diff --git a/osu.Game/Migrations/20171025071459_AddMissingIndexRules.Designer.cs b/osu.Game/Migrations/20171025071459_AddMissingIndexRules.Designer.cs
deleted file mode 100644
index 4cd234f2ef..0000000000
--- a/osu.Game/Migrations/20171025071459_AddMissingIndexRules.Designer.cs
+++ /dev/null
@@ -1,299 +0,0 @@
-// <auto-generated />
-using Microsoft.EntityFrameworkCore;
-using Microsoft.EntityFrameworkCore.Infrastructure;
-using Microsoft.EntityFrameworkCore.Metadata;
-using Microsoft.EntityFrameworkCore.Migrations;
-using Microsoft.EntityFrameworkCore.Storage;
-using osu.Game.Database;
-using System;
-
-namespace osu.Game.Migrations
-{
-    [DbContext(typeof(OsuDbContext))]
-    [Migration("20171025071459_AddMissingIndexRules")]
-    partial class AddMissingIndexRules
-    {
-        protected override void BuildTargetModel(ModelBuilder modelBuilder)
-        {
-#pragma warning disable 612, 618
-            modelBuilder
-                .HasAnnotation("ProductVersion", "2.0.0-rtm-26452");
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapDifficulty", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<float>("ApproachRate");
-
-                    b.Property<float>("CircleSize");
-
-                    b.Property<float>("DrainRate");
-
-                    b.Property<float>("OverallDifficulty");
-
-                    b.Property<float>("SliderMultiplier");
-
-                    b.Property<float>("SliderTickRate");
-
-                    b.HasKey("ID");
-
-                    b.ToTable("BeatmapDifficulty");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("AudioLeadIn");
-
-                    b.Property<int>("BaseDifficultyID");
-
-                    b.Property<int>("BeatDivisor");
-
-                    b.Property<int>("BeatmapSetInfoID");
-
-                    b.Property<bool>("Countdown");
-
-                    b.Property<double>("DistanceSpacing");
-
-                    b.Property<int>("GridSize");
-
-                    b.Property<string>("Hash");
-
-                    b.Property<bool>("Hidden");
-
-                    b.Property<bool>("LetterboxInBreaks");
-
-                    b.Property<string>("MD5Hash");
-
-                    b.Property<int?>("MetadataID");
-
-                    b.Property<int?>("OnlineBeatmapID");
-
-                    b.Property<string>("Path");
-
-                    b.Property<int>("RulesetID");
-
-                    b.Property<bool>("SpecialStyle");
-
-                    b.Property<float>("StackLeniency");
-
-                    b.Property<double>("StarDifficulty");
-
-                    b.Property<string>("StoredBookmarks");
-
-                    b.Property<double>("TimelineZoom");
-
-                    b.Property<string>("Version");
-
-                    b.Property<bool>("WidescreenStoryboard");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("BaseDifficultyID");
-
-                    b.HasIndex("BeatmapSetInfoID");
-
-                    b.HasIndex("Hash")
-                        .IsUnique();
-
-                    b.HasIndex("MD5Hash")
-                        .IsUnique();
-
-                    b.HasIndex("MetadataID");
-
-                    b.HasIndex("RulesetID");
-
-                    b.ToTable("BeatmapInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapMetadata", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Artist");
-
-                    b.Property<string>("ArtistUnicode");
-
-                    b.Property<string>("AudioFile");
-
-                    b.Property<string>("AuthorString")
-                        .HasColumnName("Author");
-
-                    b.Property<string>("BackgroundFile");
-
-                    b.Property<int>("PreviewTime");
-
-                    b.Property<string>("Source");
-
-                    b.Property<string>("Tags");
-
-                    b.Property<string>("Title");
-
-                    b.Property<string>("TitleUnicode");
-
-                    b.HasKey("ID");
-
-                    b.ToTable("BeatmapMetadata");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("BeatmapSetInfoID");
-
-                    b.Property<int>("FileInfoID");
-
-                    b.Property<string>("Filename")
-                        .IsRequired();
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("BeatmapSetInfoID");
-
-                    b.HasIndex("FileInfoID");
-
-                    b.ToTable("BeatmapSetFileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<bool>("DeletePending");
-
-                    b.Property<string>("Hash");
-
-                    b.Property<int?>("MetadataID");
-
-                    b.Property<int?>("OnlineBeatmapSetID");
-
-                    b.Property<bool>("Protected");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("DeletePending");
-
-                    b.HasIndex("Hash")
-                        .IsUnique();
-
-                    b.HasIndex("MetadataID");
-
-                    b.HasIndex("OnlineBeatmapSetID")
-                        .IsUnique();
-
-                    b.ToTable("BeatmapSetInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Input.Bindings.DatabasedKeyBinding", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("IntAction")
-                        .HasColumnName("Action");
-
-                    b.Property<string>("KeysString")
-                        .HasColumnName("Keys");
-
-                    b.Property<int?>("RulesetID");
-
-                    b.Property<int?>("Variant");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("IntAction");
-
-                    b.HasIndex("Variant");
-
-                    b.ToTable("KeyBinding");
-                });
-
-            modelBuilder.Entity("osu.Game.IO.FileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Hash");
-
-                    b.Property<int>("ReferenceCount");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("Hash")
-                        .IsUnique();
-
-                    b.HasIndex("ReferenceCount");
-
-                    b.ToTable("FileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Rulesets.RulesetInfo", b =>
-                {
-                    b.Property<int?>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<bool>("Available");
-
-                    b.Property<string>("InstantiationInfo");
-
-                    b.Property<string>("Name");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("Available");
-
-                    b.ToTable("RulesetInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapDifficulty", "BaseDifficulty")
-                        .WithMany()
-                        .HasForeignKey("BaseDifficultyID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo", "BeatmapSet")
-                        .WithMany("Beatmaps")
-                        .HasForeignKey("BeatmapSetInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
-                        .WithMany("Beatmaps")
-                        .HasForeignKey("MetadataID");
-
-                    b.HasOne("osu.Game.Rulesets.RulesetInfo", "Ruleset")
-                        .WithMany()
-                        .HasForeignKey("RulesetID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo")
-                        .WithMany("Files")
-                        .HasForeignKey("BeatmapSetInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
-                        .WithMany()
-                        .HasForeignKey("FileInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
-                        .WithMany("BeatmapSets")
-                        .HasForeignKey("MetadataID");
-                });
-#pragma warning restore 612, 618
-        }
-    }
-}
diff --git a/osu.Game/Migrations/20171025071459_AddMissingIndexRules.cs b/osu.Game/Migrations/20171025071459_AddMissingIndexRules.cs
deleted file mode 100644
index c9fc59c5a2..0000000000
--- a/osu.Game/Migrations/20171025071459_AddMissingIndexRules.cs
+++ /dev/null
@@ -1,80 +0,0 @@
-using Microsoft.EntityFrameworkCore.Migrations;
-
-namespace osu.Game.Migrations
-{
-    public partial class AddMissingIndexRules : Migration
-    {
-        protected override void Up(MigrationBuilder migrationBuilder)
-        {
-            migrationBuilder.DropIndex(
-                name: "IX_BeatmapSetInfo_Hash",
-                table: "BeatmapSetInfo");
-
-            migrationBuilder.DropIndex(
-                name: "IX_BeatmapInfo_Hash",
-                table: "BeatmapInfo");
-
-            migrationBuilder.DropIndex(
-                name: "IX_BeatmapInfo_MD5Hash",
-                table: "BeatmapInfo");
-
-            migrationBuilder.CreateIndex(
-                name: "IX_BeatmapSetInfo_Hash",
-                table: "BeatmapSetInfo",
-                column: "Hash",
-                unique: true);
-
-            migrationBuilder.CreateIndex(
-                name: "IX_BeatmapSetInfo_OnlineBeatmapSetID",
-                table: "BeatmapSetInfo",
-                column: "OnlineBeatmapSetID",
-                unique: true);
-
-            migrationBuilder.CreateIndex(
-                name: "IX_BeatmapInfo_Hash",
-                table: "BeatmapInfo",
-                column: "Hash",
-                unique: true);
-
-            migrationBuilder.CreateIndex(
-                name: "IX_BeatmapInfo_MD5Hash",
-                table: "BeatmapInfo",
-                column: "MD5Hash",
-                unique: true);
-        }
-
-        protected override void Down(MigrationBuilder migrationBuilder)
-        {
-            migrationBuilder.DropIndex(
-                name: "IX_BeatmapSetInfo_Hash",
-                table: "BeatmapSetInfo");
-
-            migrationBuilder.DropIndex(
-                name: "IX_BeatmapSetInfo_OnlineBeatmapSetID",
-                table: "BeatmapSetInfo");
-
-            migrationBuilder.DropIndex(
-                name: "IX_BeatmapInfo_Hash",
-                table: "BeatmapInfo");
-
-            migrationBuilder.DropIndex(
-                name: "IX_BeatmapInfo_MD5Hash",
-                table: "BeatmapInfo");
-
-            migrationBuilder.CreateIndex(
-                name: "IX_BeatmapSetInfo_Hash",
-                table: "BeatmapSetInfo",
-                column: "Hash");
-
-            migrationBuilder.CreateIndex(
-                name: "IX_BeatmapInfo_Hash",
-                table: "BeatmapInfo",
-                column: "Hash");
-
-            migrationBuilder.CreateIndex(
-                name: "IX_BeatmapInfo_MD5Hash",
-                table: "BeatmapInfo",
-                column: "MD5Hash");
-        }
-    }
-}
diff --git a/osu.Game/Migrations/20171119065731_AddBeatmapOnlineIDUniqueConstraint.Designer.cs b/osu.Game/Migrations/20171119065731_AddBeatmapOnlineIDUniqueConstraint.Designer.cs
deleted file mode 100644
index 006acf12cd..0000000000
--- a/osu.Game/Migrations/20171119065731_AddBeatmapOnlineIDUniqueConstraint.Designer.cs
+++ /dev/null
@@ -1,302 +0,0 @@
-// <auto-generated />
-using Microsoft.EntityFrameworkCore;
-using Microsoft.EntityFrameworkCore.Infrastructure;
-using Microsoft.EntityFrameworkCore.Metadata;
-using Microsoft.EntityFrameworkCore.Migrations;
-using Microsoft.EntityFrameworkCore.Storage;
-using osu.Game.Database;
-using System;
-
-namespace osu.Game.Migrations
-{
-    [DbContext(typeof(OsuDbContext))]
-    [Migration("20171119065731_AddBeatmapOnlineIDUniqueConstraint")]
-    partial class AddBeatmapOnlineIDUniqueConstraint
-    {
-        protected override void BuildTargetModel(ModelBuilder modelBuilder)
-        {
-#pragma warning disable 612, 618
-            modelBuilder
-                .HasAnnotation("ProductVersion", "2.0.0-rtm-26452");
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapDifficulty", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<float>("ApproachRate");
-
-                    b.Property<float>("CircleSize");
-
-                    b.Property<float>("DrainRate");
-
-                    b.Property<float>("OverallDifficulty");
-
-                    b.Property<float>("SliderMultiplier");
-
-                    b.Property<float>("SliderTickRate");
-
-                    b.HasKey("ID");
-
-                    b.ToTable("BeatmapDifficulty");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("AudioLeadIn");
-
-                    b.Property<int>("BaseDifficultyID");
-
-                    b.Property<int>("BeatDivisor");
-
-                    b.Property<int>("BeatmapSetInfoID");
-
-                    b.Property<bool>("Countdown");
-
-                    b.Property<double>("DistanceSpacing");
-
-                    b.Property<int>("GridSize");
-
-                    b.Property<string>("Hash");
-
-                    b.Property<bool>("Hidden");
-
-                    b.Property<bool>("LetterboxInBreaks");
-
-                    b.Property<string>("MD5Hash");
-
-                    b.Property<int?>("MetadataID");
-
-                    b.Property<int?>("OnlineBeatmapID");
-
-                    b.Property<string>("Path");
-
-                    b.Property<int>("RulesetID");
-
-                    b.Property<bool>("SpecialStyle");
-
-                    b.Property<float>("StackLeniency");
-
-                    b.Property<double>("StarDifficulty");
-
-                    b.Property<string>("StoredBookmarks");
-
-                    b.Property<double>("TimelineZoom");
-
-                    b.Property<string>("Version");
-
-                    b.Property<bool>("WidescreenStoryboard");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("BaseDifficultyID");
-
-                    b.HasIndex("BeatmapSetInfoID");
-
-                    b.HasIndex("Hash")
-                        .IsUnique();
-
-                    b.HasIndex("MD5Hash")
-                        .IsUnique();
-
-                    b.HasIndex("MetadataID");
-
-                    b.HasIndex("OnlineBeatmapID")
-                        .IsUnique();
-
-                    b.HasIndex("RulesetID");
-
-                    b.ToTable("BeatmapInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapMetadata", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Artist");
-
-                    b.Property<string>("ArtistUnicode");
-
-                    b.Property<string>("AudioFile");
-
-                    b.Property<string>("AuthorString")
-                        .HasColumnName("Author");
-
-                    b.Property<string>("BackgroundFile");
-
-                    b.Property<int>("PreviewTime");
-
-                    b.Property<string>("Source");
-
-                    b.Property<string>("Tags");
-
-                    b.Property<string>("Title");
-
-                    b.Property<string>("TitleUnicode");
-
-                    b.HasKey("ID");
-
-                    b.ToTable("BeatmapMetadata");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("BeatmapSetInfoID");
-
-                    b.Property<int>("FileInfoID");
-
-                    b.Property<string>("Filename")
-                        .IsRequired();
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("BeatmapSetInfoID");
-
-                    b.HasIndex("FileInfoID");
-
-                    b.ToTable("BeatmapSetFileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<bool>("DeletePending");
-
-                    b.Property<string>("Hash");
-
-                    b.Property<int?>("MetadataID");
-
-                    b.Property<int?>("OnlineBeatmapSetID");
-
-                    b.Property<bool>("Protected");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("DeletePending");
-
-                    b.HasIndex("Hash")
-                        .IsUnique();
-
-                    b.HasIndex("MetadataID");
-
-                    b.HasIndex("OnlineBeatmapSetID")
-                        .IsUnique();
-
-                    b.ToTable("BeatmapSetInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Input.Bindings.DatabasedKeyBinding", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("IntAction")
-                        .HasColumnName("Action");
-
-                    b.Property<string>("KeysString")
-                        .HasColumnName("Keys");
-
-                    b.Property<int?>("RulesetID");
-
-                    b.Property<int?>("Variant");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("IntAction");
-
-                    b.HasIndex("Variant");
-
-                    b.ToTable("KeyBinding");
-                });
-
-            modelBuilder.Entity("osu.Game.IO.FileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Hash");
-
-                    b.Property<int>("ReferenceCount");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("Hash")
-                        .IsUnique();
-
-                    b.HasIndex("ReferenceCount");
-
-                    b.ToTable("FileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Rulesets.RulesetInfo", b =>
-                {
-                    b.Property<int?>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<bool>("Available");
-
-                    b.Property<string>("InstantiationInfo");
-
-                    b.Property<string>("Name");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("Available");
-
-                    b.ToTable("RulesetInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapDifficulty", "BaseDifficulty")
-                        .WithMany()
-                        .HasForeignKey("BaseDifficultyID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo", "BeatmapSet")
-                        .WithMany("Beatmaps")
-                        .HasForeignKey("BeatmapSetInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
-                        .WithMany("Beatmaps")
-                        .HasForeignKey("MetadataID");
-
-                    b.HasOne("osu.Game.Rulesets.RulesetInfo", "Ruleset")
-                        .WithMany()
-                        .HasForeignKey("RulesetID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo")
-                        .WithMany("Files")
-                        .HasForeignKey("BeatmapSetInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
-                        .WithMany()
-                        .HasForeignKey("FileInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
-                        .WithMany("BeatmapSets")
-                        .HasForeignKey("MetadataID");
-                });
-#pragma warning restore 612, 618
-        }
-    }
-}
diff --git a/osu.Game/Migrations/20171119065731_AddBeatmapOnlineIDUniqueConstraint.cs b/osu.Game/Migrations/20171119065731_AddBeatmapOnlineIDUniqueConstraint.cs
deleted file mode 100644
index 084ae67940..0000000000
--- a/osu.Game/Migrations/20171119065731_AddBeatmapOnlineIDUniqueConstraint.cs
+++ /dev/null
@@ -1,23 +0,0 @@
-using Microsoft.EntityFrameworkCore.Migrations;
-
-namespace osu.Game.Migrations
-{
-    public partial class AddBeatmapOnlineIDUniqueConstraint : Migration
-    {
-        protected override void Up(MigrationBuilder migrationBuilder)
-        {
-            migrationBuilder.CreateIndex(
-                name: "IX_BeatmapInfo_OnlineBeatmapID",
-                table: "BeatmapInfo",
-                column: "OnlineBeatmapID",
-                unique: true);
-        }
-
-        protected override void Down(MigrationBuilder migrationBuilder)
-        {
-            migrationBuilder.DropIndex(
-                name: "IX_BeatmapInfo_OnlineBeatmapID",
-                table: "BeatmapInfo");
-        }
-    }
-}
diff --git a/osu.Game/Migrations/20171209034410_AddRulesetInfoShortName.Designer.cs b/osu.Game/Migrations/20171209034410_AddRulesetInfoShortName.Designer.cs
deleted file mode 100644
index fc2496bc24..0000000000
--- a/osu.Game/Migrations/20171209034410_AddRulesetInfoShortName.Designer.cs
+++ /dev/null
@@ -1,307 +0,0 @@
-// <auto-generated />
-using Microsoft.EntityFrameworkCore;
-using Microsoft.EntityFrameworkCore.Infrastructure;
-using Microsoft.EntityFrameworkCore.Metadata;
-using Microsoft.EntityFrameworkCore.Migrations;
-using Microsoft.EntityFrameworkCore.Storage;
-using osu.Game.Database;
-using System;
-
-namespace osu.Game.Migrations
-{
-    [DbContext(typeof(OsuDbContext))]
-    [Migration("20171209034410_AddRulesetInfoShortName")]
-    partial class AddRulesetInfoShortName
-    {
-        protected override void BuildTargetModel(ModelBuilder modelBuilder)
-        {
-#pragma warning disable 612, 618
-            modelBuilder
-                .HasAnnotation("ProductVersion", "2.0.0-rtm-26452");
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapDifficulty", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<float>("ApproachRate");
-
-                    b.Property<float>("CircleSize");
-
-                    b.Property<float>("DrainRate");
-
-                    b.Property<float>("OverallDifficulty");
-
-                    b.Property<float>("SliderMultiplier");
-
-                    b.Property<float>("SliderTickRate");
-
-                    b.HasKey("ID");
-
-                    b.ToTable("BeatmapDifficulty");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("AudioLeadIn");
-
-                    b.Property<int>("BaseDifficultyID");
-
-                    b.Property<int>("BeatDivisor");
-
-                    b.Property<int>("BeatmapSetInfoID");
-
-                    b.Property<bool>("Countdown");
-
-                    b.Property<double>("DistanceSpacing");
-
-                    b.Property<int>("GridSize");
-
-                    b.Property<string>("Hash");
-
-                    b.Property<bool>("Hidden");
-
-                    b.Property<bool>("LetterboxInBreaks");
-
-                    b.Property<string>("MD5Hash");
-
-                    b.Property<int?>("MetadataID");
-
-                    b.Property<int?>("OnlineBeatmapID");
-
-                    b.Property<string>("Path");
-
-                    b.Property<int>("RulesetID");
-
-                    b.Property<bool>("SpecialStyle");
-
-                    b.Property<float>("StackLeniency");
-
-                    b.Property<double>("StarDifficulty");
-
-                    b.Property<string>("StoredBookmarks");
-
-                    b.Property<double>("TimelineZoom");
-
-                    b.Property<string>("Version");
-
-                    b.Property<bool>("WidescreenStoryboard");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("BaseDifficultyID");
-
-                    b.HasIndex("BeatmapSetInfoID");
-
-                    b.HasIndex("Hash")
-                        .IsUnique();
-
-                    b.HasIndex("MD5Hash")
-                        .IsUnique();
-
-                    b.HasIndex("MetadataID");
-
-                    b.HasIndex("OnlineBeatmapID")
-                        .IsUnique();
-
-                    b.HasIndex("RulesetID");
-
-                    b.ToTable("BeatmapInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapMetadata", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Artist");
-
-                    b.Property<string>("ArtistUnicode");
-
-                    b.Property<string>("AudioFile");
-
-                    b.Property<string>("AuthorString")
-                        .HasColumnName("Author");
-
-                    b.Property<string>("BackgroundFile");
-
-                    b.Property<int>("PreviewTime");
-
-                    b.Property<string>("Source");
-
-                    b.Property<string>("Tags");
-
-                    b.Property<string>("Title");
-
-                    b.Property<string>("TitleUnicode");
-
-                    b.HasKey("ID");
-
-                    b.ToTable("BeatmapMetadata");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("BeatmapSetInfoID");
-
-                    b.Property<int>("FileInfoID");
-
-                    b.Property<string>("Filename")
-                        .IsRequired();
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("BeatmapSetInfoID");
-
-                    b.HasIndex("FileInfoID");
-
-                    b.ToTable("BeatmapSetFileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<bool>("DeletePending");
-
-                    b.Property<string>("Hash");
-
-                    b.Property<int?>("MetadataID");
-
-                    b.Property<int?>("OnlineBeatmapSetID");
-
-                    b.Property<bool>("Protected");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("DeletePending");
-
-                    b.HasIndex("Hash")
-                        .IsUnique();
-
-                    b.HasIndex("MetadataID");
-
-                    b.HasIndex("OnlineBeatmapSetID")
-                        .IsUnique();
-
-                    b.ToTable("BeatmapSetInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Input.Bindings.DatabasedKeyBinding", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("IntAction")
-                        .HasColumnName("Action");
-
-                    b.Property<string>("KeysString")
-                        .HasColumnName("Keys");
-
-                    b.Property<int?>("RulesetID");
-
-                    b.Property<int?>("Variant");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("IntAction");
-
-                    b.HasIndex("Variant");
-
-                    b.ToTable("KeyBinding");
-                });
-
-            modelBuilder.Entity("osu.Game.IO.FileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Hash");
-
-                    b.Property<int>("ReferenceCount");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("Hash")
-                        .IsUnique();
-
-                    b.HasIndex("ReferenceCount");
-
-                    b.ToTable("FileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Rulesets.RulesetInfo", b =>
-                {
-                    b.Property<int?>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<bool>("Available");
-
-                    b.Property<string>("InstantiationInfo");
-
-                    b.Property<string>("Name");
-
-                    b.Property<string>("ShortName");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("Available");
-
-                    b.HasIndex("ShortName")
-                        .IsUnique();
-
-                    b.ToTable("RulesetInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapDifficulty", "BaseDifficulty")
-                        .WithMany()
-                        .HasForeignKey("BaseDifficultyID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo", "BeatmapSet")
-                        .WithMany("Beatmaps")
-                        .HasForeignKey("BeatmapSetInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
-                        .WithMany("Beatmaps")
-                        .HasForeignKey("MetadataID");
-
-                    b.HasOne("osu.Game.Rulesets.RulesetInfo", "Ruleset")
-                        .WithMany()
-                        .HasForeignKey("RulesetID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo")
-                        .WithMany("Files")
-                        .HasForeignKey("BeatmapSetInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
-                        .WithMany()
-                        .HasForeignKey("FileInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
-                        .WithMany("BeatmapSets")
-                        .HasForeignKey("MetadataID");
-                });
-#pragma warning restore 612, 618
-        }
-    }
-}
diff --git a/osu.Game/Migrations/20171209034410_AddRulesetInfoShortName.cs b/osu.Game/Migrations/20171209034410_AddRulesetInfoShortName.cs
deleted file mode 100644
index 09cf0af89c..0000000000
--- a/osu.Game/Migrations/20171209034410_AddRulesetInfoShortName.cs
+++ /dev/null
@@ -1,33 +0,0 @@
-using Microsoft.EntityFrameworkCore.Migrations;
-
-namespace osu.Game.Migrations
-{
-    public partial class AddRulesetInfoShortName : Migration
-    {
-        protected override void Up(MigrationBuilder migrationBuilder)
-        {
-            migrationBuilder.AddColumn<string>(
-                name: "ShortName",
-                table: "RulesetInfo",
-                type: "TEXT",
-                nullable: true);
-
-            migrationBuilder.CreateIndex(
-                name: "IX_RulesetInfo_ShortName",
-                table: "RulesetInfo",
-                column: "ShortName",
-                unique: true);
-        }
-
-        protected override void Down(MigrationBuilder migrationBuilder)
-        {
-            migrationBuilder.DropIndex(
-                name: "IX_RulesetInfo_ShortName",
-                table: "RulesetInfo");
-
-            migrationBuilder.DropColumn(
-                name: "ShortName",
-                table: "RulesetInfo");
-        }
-    }
-}
diff --git a/osu.Game/Migrations/20180125143340_Settings.Designer.cs b/osu.Game/Migrations/20180125143340_Settings.Designer.cs
deleted file mode 100644
index 4bb599eec1..0000000000
--- a/osu.Game/Migrations/20180125143340_Settings.Designer.cs
+++ /dev/null
@@ -1,329 +0,0 @@
-// <auto-generated />
-using Microsoft.EntityFrameworkCore;
-using Microsoft.EntityFrameworkCore.Infrastructure;
-using Microsoft.EntityFrameworkCore.Metadata;
-using Microsoft.EntityFrameworkCore.Migrations;
-using Microsoft.EntityFrameworkCore.Storage;
-using osu.Game.Database;
-using System;
-
-namespace osu.Game.Migrations
-{
-    [DbContext(typeof(OsuDbContext))]
-    [Migration("20180125143340_Settings")]
-    partial class Settings
-    {
-        protected override void BuildTargetModel(ModelBuilder modelBuilder)
-        {
-#pragma warning disable 612, 618
-            modelBuilder
-                .HasAnnotation("ProductVersion", "2.0.0-rtm-26452");
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapDifficulty", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<float>("ApproachRate");
-
-                    b.Property<float>("CircleSize");
-
-                    b.Property<float>("DrainRate");
-
-                    b.Property<float>("OverallDifficulty");
-
-                    b.Property<float>("SliderMultiplier");
-
-                    b.Property<float>("SliderTickRate");
-
-                    b.HasKey("ID");
-
-                    b.ToTable("BeatmapDifficulty");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("AudioLeadIn");
-
-                    b.Property<int>("BaseDifficultyID");
-
-                    b.Property<int>("BeatDivisor");
-
-                    b.Property<int>("BeatmapSetInfoID");
-
-                    b.Property<bool>("Countdown");
-
-                    b.Property<double>("DistanceSpacing");
-
-                    b.Property<int>("GridSize");
-
-                    b.Property<string>("Hash");
-
-                    b.Property<bool>("Hidden");
-
-                    b.Property<bool>("LetterboxInBreaks");
-
-                    b.Property<string>("MD5Hash");
-
-                    b.Property<int?>("MetadataID");
-
-                    b.Property<int?>("OnlineBeatmapID");
-
-                    b.Property<string>("Path");
-
-                    b.Property<int>("RulesetID");
-
-                    b.Property<bool>("SpecialStyle");
-
-                    b.Property<float>("StackLeniency");
-
-                    b.Property<double>("StarDifficulty");
-
-                    b.Property<string>("StoredBookmarks");
-
-                    b.Property<double>("TimelineZoom");
-
-                    b.Property<string>("Version");
-
-                    b.Property<bool>("WidescreenStoryboard");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("BaseDifficultyID");
-
-                    b.HasIndex("BeatmapSetInfoID");
-
-                    b.HasIndex("Hash")
-                        .IsUnique();
-
-                    b.HasIndex("MD5Hash")
-                        .IsUnique();
-
-                    b.HasIndex("MetadataID");
-
-                    b.HasIndex("OnlineBeatmapID")
-                        .IsUnique();
-
-                    b.HasIndex("RulesetID");
-
-                    b.ToTable("BeatmapInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapMetadata", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Artist");
-
-                    b.Property<string>("ArtistUnicode");
-
-                    b.Property<string>("AudioFile");
-
-                    b.Property<string>("AuthorString")
-                        .HasColumnName("Author");
-
-                    b.Property<string>("BackgroundFile");
-
-                    b.Property<int>("PreviewTime");
-
-                    b.Property<string>("Source");
-
-                    b.Property<string>("Tags");
-
-                    b.Property<string>("Title");
-
-                    b.Property<string>("TitleUnicode");
-
-                    b.HasKey("ID");
-
-                    b.ToTable("BeatmapMetadata");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("BeatmapSetInfoID");
-
-                    b.Property<int>("FileInfoID");
-
-                    b.Property<string>("Filename")
-                        .IsRequired();
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("BeatmapSetInfoID");
-
-                    b.HasIndex("FileInfoID");
-
-                    b.ToTable("BeatmapSetFileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<bool>("DeletePending");
-
-                    b.Property<string>("Hash");
-
-                    b.Property<int?>("MetadataID");
-
-                    b.Property<int?>("OnlineBeatmapSetID");
-
-                    b.Property<bool>("Protected");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("DeletePending");
-
-                    b.HasIndex("Hash")
-                        .IsUnique();
-
-                    b.HasIndex("MetadataID");
-
-                    b.HasIndex("OnlineBeatmapSetID")
-                        .IsUnique();
-
-                    b.ToTable("BeatmapSetInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Configuration.DatabasedSetting", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("IntKey")
-                        .HasColumnName("Key");
-
-                    b.Property<int?>("RulesetID");
-
-                    b.Property<string>("StringValue")
-                        .HasColumnName("Value");
-
-                    b.Property<int?>("Variant");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("RulesetID", "Variant");
-
-                    b.ToTable("Settings");
-                });
-
-            modelBuilder.Entity("osu.Game.Input.Bindings.DatabasedKeyBinding", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("IntAction")
-                        .HasColumnName("Action");
-
-                    b.Property<string>("KeysString")
-                        .HasColumnName("Keys");
-
-                    b.Property<int?>("RulesetID");
-
-                    b.Property<int?>("Variant");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("IntAction");
-
-                    b.HasIndex("RulesetID", "Variant");
-
-                    b.ToTable("KeyBinding");
-                });
-
-            modelBuilder.Entity("osu.Game.IO.FileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Hash");
-
-                    b.Property<int>("ReferenceCount");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("Hash")
-                        .IsUnique();
-
-                    b.HasIndex("ReferenceCount");
-
-                    b.ToTable("FileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Rulesets.RulesetInfo", b =>
-                {
-                    b.Property<int?>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<bool>("Available");
-
-                    b.Property<string>("InstantiationInfo");
-
-                    b.Property<string>("Name");
-
-                    b.Property<string>("ShortName");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("Available");
-
-                    b.HasIndex("ShortName")
-                        .IsUnique();
-
-                    b.ToTable("RulesetInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapDifficulty", "BaseDifficulty")
-                        .WithMany()
-                        .HasForeignKey("BaseDifficultyID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo", "BeatmapSet")
-                        .WithMany("Beatmaps")
-                        .HasForeignKey("BeatmapSetInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
-                        .WithMany("Beatmaps")
-                        .HasForeignKey("MetadataID");
-
-                    b.HasOne("osu.Game.Rulesets.RulesetInfo", "Ruleset")
-                        .WithMany()
-                        .HasForeignKey("RulesetID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo")
-                        .WithMany("Files")
-                        .HasForeignKey("BeatmapSetInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
-                        .WithMany()
-                        .HasForeignKey("FileInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
-                        .WithMany("BeatmapSets")
-                        .HasForeignKey("MetadataID");
-                });
-#pragma warning restore 612, 618
-        }
-    }
-}
diff --git a/osu.Game/Migrations/20180125143340_Settings.cs b/osu.Game/Migrations/20180125143340_Settings.cs
deleted file mode 100644
index 166d3c086d..0000000000
--- a/osu.Game/Migrations/20180125143340_Settings.cs
+++ /dev/null
@@ -1,55 +0,0 @@
-using Microsoft.EntityFrameworkCore.Migrations;
-
-namespace osu.Game.Migrations
-{
-    public partial class Settings : Migration
-    {
-        protected override void Up(MigrationBuilder migrationBuilder)
-        {
-            migrationBuilder.DropIndex(
-                name: "IX_KeyBinding_Variant",
-                table: "KeyBinding");
-
-            migrationBuilder.CreateTable(
-                name: "Settings",
-                columns: table => new
-                {
-                    ID = table.Column<int>(type: "INTEGER", nullable: false)
-                        .Annotation("Sqlite:Autoincrement", true),
-                    Key = table.Column<int>(type: "TEXT", nullable: false),
-                    RulesetID = table.Column<int>(type: "INTEGER", nullable: true),
-                    Value = table.Column<string>(type: "TEXT", nullable: true),
-                    Variant = table.Column<int>(type: "INTEGER", nullable: true)
-                },
-                constraints: table =>
-                {
-                    table.PrimaryKey("PK_Settings", x => x.ID);
-                });
-
-            migrationBuilder.CreateIndex(
-                name: "IX_KeyBinding_RulesetID_Variant",
-                table: "KeyBinding",
-                columns: new[] { "RulesetID", "Variant" });
-
-            migrationBuilder.CreateIndex(
-                name: "IX_Settings_RulesetID_Variant",
-                table: "Settings",
-                columns: new[] { "RulesetID", "Variant" });
-        }
-
-        protected override void Down(MigrationBuilder migrationBuilder)
-        {
-            migrationBuilder.DropTable(
-                name: "Settings");
-
-            migrationBuilder.DropIndex(
-                name: "IX_KeyBinding_RulesetID_Variant",
-                table: "KeyBinding");
-
-            migrationBuilder.CreateIndex(
-                name: "IX_KeyBinding_Variant",
-                table: "KeyBinding",
-                column: "Variant");
-        }
-    }
-}
diff --git a/osu.Game/Migrations/20180131154205_AddMuteBinding.cs b/osu.Game/Migrations/20180131154205_AddMuteBinding.cs
deleted file mode 100644
index 5564a30bbf..0000000000
--- a/osu.Game/Migrations/20180131154205_AddMuteBinding.cs
+++ /dev/null
@@ -1,23 +0,0 @@
-using Microsoft.EntityFrameworkCore.Migrations;
-using Microsoft.EntityFrameworkCore.Infrastructure;
-using osu.Game.Database;
-using osu.Game.Input.Bindings;
-
-namespace osu.Game.Migrations
-{
-    [DbContext(typeof(OsuDbContext))]
-    [Migration("20180131154205_AddMuteBinding")]
-    public partial class AddMuteBinding : Migration
-    {
-        protected override void Up(MigrationBuilder migrationBuilder)
-        {
-            migrationBuilder.Sql($"UPDATE KeyBinding SET Action = Action + 1 WHERE RulesetID IS NULL AND Variant IS NULL AND Action >= {(int)GlobalAction.ToggleMute}");
-        }
-
-        protected override void Down(MigrationBuilder migrationBuilder)
-        {
-            migrationBuilder.Sql($"DELETE FROM KeyBinding WHERE RulesetID IS NULL AND Variant IS NULL AND Action = {(int)GlobalAction.ToggleMute}");
-            migrationBuilder.Sql($"UPDATE KeyBinding SET Action = Action - 1 WHERE RulesetID IS NULL AND Variant IS NULL AND Action > {(int)GlobalAction.ToggleMute}");
-        }
-    }
-}
diff --git a/osu.Game/Migrations/20180219060912_AddSkins.Designer.cs b/osu.Game/Migrations/20180219060912_AddSkins.Designer.cs
deleted file mode 100644
index cdc4ef2e66..0000000000
--- a/osu.Game/Migrations/20180219060912_AddSkins.Designer.cs
+++ /dev/null
@@ -1,379 +0,0 @@
-// <auto-generated />
-using Microsoft.EntityFrameworkCore;
-using Microsoft.EntityFrameworkCore.Infrastructure;
-using Microsoft.EntityFrameworkCore.Metadata;
-using Microsoft.EntityFrameworkCore.Migrations;
-using Microsoft.EntityFrameworkCore.Storage;
-using osu.Game.Database;
-using System;
-
-namespace osu.Game.Migrations
-{
-    [DbContext(typeof(OsuDbContext))]
-    [Migration("20180219060912_AddSkins")]
-    partial class AddSkins
-    {
-        protected override void BuildTargetModel(ModelBuilder modelBuilder)
-        {
-#pragma warning disable 612, 618
-            modelBuilder
-                .HasAnnotation("ProductVersion", "2.0.0-rtm-26452");
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapDifficulty", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<float>("ApproachRate");
-
-                    b.Property<float>("CircleSize");
-
-                    b.Property<float>("DrainRate");
-
-                    b.Property<float>("OverallDifficulty");
-
-                    b.Property<float>("SliderMultiplier");
-
-                    b.Property<float>("SliderTickRate");
-
-                    b.HasKey("ID");
-
-                    b.ToTable("BeatmapDifficulty");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("AudioLeadIn");
-
-                    b.Property<int>("BaseDifficultyID");
-
-                    b.Property<int>("BeatDivisor");
-
-                    b.Property<int>("BeatmapSetInfoID");
-
-                    b.Property<bool>("Countdown");
-
-                    b.Property<double>("DistanceSpacing");
-
-                    b.Property<int>("GridSize");
-
-                    b.Property<string>("Hash");
-
-                    b.Property<bool>("Hidden");
-
-                    b.Property<bool>("LetterboxInBreaks");
-
-                    b.Property<string>("MD5Hash");
-
-                    b.Property<int?>("MetadataID");
-
-                    b.Property<int?>("OnlineBeatmapID");
-
-                    b.Property<string>("Path");
-
-                    b.Property<int>("RulesetID");
-
-                    b.Property<bool>("SpecialStyle");
-
-                    b.Property<float>("StackLeniency");
-
-                    b.Property<double>("StarDifficulty");
-
-                    b.Property<string>("StoredBookmarks");
-
-                    b.Property<double>("TimelineZoom");
-
-                    b.Property<string>("Version");
-
-                    b.Property<bool>("WidescreenStoryboard");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("BaseDifficultyID");
-
-                    b.HasIndex("BeatmapSetInfoID");
-
-                    b.HasIndex("Hash")
-                        .IsUnique();
-
-                    b.HasIndex("MD5Hash")
-                        .IsUnique();
-
-                    b.HasIndex("MetadataID");
-
-                    b.HasIndex("OnlineBeatmapID")
-                        .IsUnique();
-
-                    b.HasIndex("RulesetID");
-
-                    b.ToTable("BeatmapInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapMetadata", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Artist");
-
-                    b.Property<string>("ArtistUnicode");
-
-                    b.Property<string>("AudioFile");
-
-                    b.Property<string>("AuthorString")
-                        .HasColumnName("Author");
-
-                    b.Property<string>("BackgroundFile");
-
-                    b.Property<int>("PreviewTime");
-
-                    b.Property<string>("Source");
-
-                    b.Property<string>("Tags");
-
-                    b.Property<string>("Title");
-
-                    b.Property<string>("TitleUnicode");
-
-                    b.HasKey("ID");
-
-                    b.ToTable("BeatmapMetadata");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("BeatmapSetInfoID");
-
-                    b.Property<int>("FileInfoID");
-
-                    b.Property<string>("Filename")
-                        .IsRequired();
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("BeatmapSetInfoID");
-
-                    b.HasIndex("FileInfoID");
-
-                    b.ToTable("BeatmapSetFileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<bool>("DeletePending");
-
-                    b.Property<string>("Hash");
-
-                    b.Property<int?>("MetadataID");
-
-                    b.Property<int?>("OnlineBeatmapSetID");
-
-                    b.Property<bool>("Protected");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("DeletePending");
-
-                    b.HasIndex("Hash")
-                        .IsUnique();
-
-                    b.HasIndex("MetadataID");
-
-                    b.HasIndex("OnlineBeatmapSetID")
-                        .IsUnique();
-
-                    b.ToTable("BeatmapSetInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Configuration.DatabasedSetting", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("IntKey")
-                        .HasColumnName("Key");
-
-                    b.Property<int?>("RulesetID");
-
-                    b.Property<string>("StringValue")
-                        .HasColumnName("Value");
-
-                    b.Property<int?>("Variant");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("RulesetID", "Variant");
-
-                    b.ToTable("Settings");
-                });
-
-            modelBuilder.Entity("osu.Game.Input.Bindings.DatabasedKeyBinding", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("IntAction")
-                        .HasColumnName("Action");
-
-                    b.Property<string>("KeysString")
-                        .HasColumnName("Keys");
-
-                    b.Property<int?>("RulesetID");
-
-                    b.Property<int?>("Variant");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("IntAction");
-
-                    b.HasIndex("RulesetID", "Variant");
-
-                    b.ToTable("KeyBinding");
-                });
-
-            modelBuilder.Entity("osu.Game.IO.FileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Hash");
-
-                    b.Property<int>("ReferenceCount");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("Hash")
-                        .IsUnique();
-
-                    b.HasIndex("ReferenceCount");
-
-                    b.ToTable("FileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Rulesets.RulesetInfo", b =>
-                {
-                    b.Property<int?>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<bool>("Available");
-
-                    b.Property<string>("InstantiationInfo");
-
-                    b.Property<string>("Name");
-
-                    b.Property<string>("ShortName");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("Available");
-
-                    b.HasIndex("ShortName")
-                        .IsUnique();
-
-                    b.ToTable("RulesetInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Skinning.SkinFileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("FileInfoID");
-
-                    b.Property<string>("Filename")
-                        .IsRequired();
-
-                    b.Property<int>("SkinInfoID");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("FileInfoID");
-
-                    b.HasIndex("SkinInfoID");
-
-                    b.ToTable("SkinFileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Skinning.SkinInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Creator");
-
-                    b.Property<bool>("DeletePending");
-
-                    b.Property<string>("Name");
-
-                    b.HasKey("ID");
-
-                    b.ToTable("SkinInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapDifficulty", "BaseDifficulty")
-                        .WithMany()
-                        .HasForeignKey("BaseDifficultyID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo", "BeatmapSet")
-                        .WithMany("Beatmaps")
-                        .HasForeignKey("BeatmapSetInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
-                        .WithMany("Beatmaps")
-                        .HasForeignKey("MetadataID");
-
-                    b.HasOne("osu.Game.Rulesets.RulesetInfo", "Ruleset")
-                        .WithMany()
-                        .HasForeignKey("RulesetID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo")
-                        .WithMany("Files")
-                        .HasForeignKey("BeatmapSetInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
-                        .WithMany()
-                        .HasForeignKey("FileInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
-                        .WithMany("BeatmapSets")
-                        .HasForeignKey("MetadataID");
-                });
-
-            modelBuilder.Entity("osu.Game.Skinning.SkinFileInfo", b =>
-                {
-                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
-                        .WithMany()
-                        .HasForeignKey("FileInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Skinning.SkinInfo")
-                        .WithMany("Files")
-                        .HasForeignKey("SkinInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-#pragma warning restore 612, 618
-        }
-    }
-}
diff --git a/osu.Game/Migrations/20180219060912_AddSkins.cs b/osu.Game/Migrations/20180219060912_AddSkins.cs
deleted file mode 100644
index a0270ab0fd..0000000000
--- a/osu.Game/Migrations/20180219060912_AddSkins.cs
+++ /dev/null
@@ -1,71 +0,0 @@
-using Microsoft.EntityFrameworkCore.Migrations;
-
-namespace osu.Game.Migrations
-{
-    public partial class AddSkins : Migration
-    {
-        protected override void Up(MigrationBuilder migrationBuilder)
-        {
-            migrationBuilder.CreateTable(
-                name: "SkinInfo",
-                columns: table => new
-                {
-                    ID = table.Column<int>(type: "INTEGER", nullable: false)
-                        .Annotation("Sqlite:Autoincrement", true),
-                    Creator = table.Column<string>(type: "TEXT", nullable: true),
-                    DeletePending = table.Column<bool>(type: "INTEGER", nullable: false),
-                    Name = table.Column<string>(type: "TEXT", nullable: true)
-                },
-                constraints: table =>
-                {
-                    table.PrimaryKey("PK_SkinInfo", x => x.ID);
-                });
-
-            migrationBuilder.CreateTable(
-                name: "SkinFileInfo",
-                columns: table => new
-                {
-                    ID = table.Column<int>(type: "INTEGER", nullable: false)
-                        .Annotation("Sqlite:Autoincrement", true),
-                    FileInfoID = table.Column<int>(type: "INTEGER", nullable: false),
-                    Filename = table.Column<string>(type: "TEXT", nullable: false),
-                    SkinInfoID = table.Column<int>(type: "INTEGER", nullable: false)
-                },
-                constraints: table =>
-                {
-                    table.PrimaryKey("PK_SkinFileInfo", x => x.ID);
-                    table.ForeignKey(
-                        name: "FK_SkinFileInfo_FileInfo_FileInfoID",
-                        column: x => x.FileInfoID,
-                        principalTable: "FileInfo",
-                        principalColumn: "ID",
-                        onDelete: ReferentialAction.Cascade);
-                    table.ForeignKey(
-                        name: "FK_SkinFileInfo_SkinInfo_SkinInfoID",
-                        column: x => x.SkinInfoID,
-                        principalTable: "SkinInfo",
-                        principalColumn: "ID",
-                        onDelete: ReferentialAction.Cascade);
-                });
-
-            migrationBuilder.CreateIndex(
-                name: "IX_SkinFileInfo_FileInfoID",
-                table: "SkinFileInfo",
-                column: "FileInfoID");
-
-            migrationBuilder.CreateIndex(
-                name: "IX_SkinFileInfo_SkinInfoID",
-                table: "SkinFileInfo",
-                column: "SkinInfoID");
-        }
-
-        protected override void Down(MigrationBuilder migrationBuilder)
-        {
-            migrationBuilder.DropTable(
-                name: "SkinFileInfo");
-
-            migrationBuilder.DropTable(
-                name: "SkinInfo");
-        }
-    }
-}
diff --git a/osu.Game/Migrations/20180529055154_RemoveUniqueHashConstraints.Designer.cs b/osu.Game/Migrations/20180529055154_RemoveUniqueHashConstraints.Designer.cs
deleted file mode 100644
index f28408bfb3..0000000000
--- a/osu.Game/Migrations/20180529055154_RemoveUniqueHashConstraints.Designer.cs
+++ /dev/null
@@ -1,377 +0,0 @@
-// <auto-generated />
-using Microsoft.EntityFrameworkCore;
-using Microsoft.EntityFrameworkCore.Infrastructure;
-using Microsoft.EntityFrameworkCore.Metadata;
-using Microsoft.EntityFrameworkCore.Migrations;
-using Microsoft.EntityFrameworkCore.Storage;
-using osu.Game.Database;
-using System;
-
-namespace osu.Game.Migrations
-{
-    [DbContext(typeof(OsuDbContext))]
-    [Migration("20180529055154_RemoveUniqueHashConstraints")]
-    partial class RemoveUniqueHashConstraints
-    {
-        protected override void BuildTargetModel(ModelBuilder modelBuilder)
-        {
-#pragma warning disable 612, 618
-            modelBuilder
-                .HasAnnotation("ProductVersion", "2.0.3-rtm-10026");
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapDifficulty", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<float>("ApproachRate");
-
-                    b.Property<float>("CircleSize");
-
-                    b.Property<float>("DrainRate");
-
-                    b.Property<float>("OverallDifficulty");
-
-                    b.Property<double>("SliderMultiplier");
-
-                    b.Property<double>("SliderTickRate");
-
-                    b.HasKey("ID");
-
-                    b.ToTable("BeatmapDifficulty");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("AudioLeadIn");
-
-                    b.Property<int>("BaseDifficultyID");
-
-                    b.Property<int>("BeatDivisor");
-
-                    b.Property<int>("BeatmapSetInfoID");
-
-                    b.Property<bool>("Countdown");
-
-                    b.Property<double>("DistanceSpacing");
-
-                    b.Property<int>("GridSize");
-
-                    b.Property<string>("Hash");
-
-                    b.Property<bool>("Hidden");
-
-                    b.Property<bool>("LetterboxInBreaks");
-
-                    b.Property<string>("MD5Hash");
-
-                    b.Property<int?>("MetadataID");
-
-                    b.Property<int?>("OnlineBeatmapID");
-
-                    b.Property<string>("Path");
-
-                    b.Property<int>("RulesetID");
-
-                    b.Property<bool>("SpecialStyle");
-
-                    b.Property<float>("StackLeniency");
-
-                    b.Property<double>("StarDifficulty");
-
-                    b.Property<string>("StoredBookmarks");
-
-                    b.Property<double>("TimelineZoom");
-
-                    b.Property<string>("Version");
-
-                    b.Property<bool>("WidescreenStoryboard");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("BaseDifficultyID");
-
-                    b.HasIndex("BeatmapSetInfoID");
-
-                    b.HasIndex("Hash");
-
-                    b.HasIndex("MD5Hash");
-
-                    b.HasIndex("MetadataID");
-
-                    b.HasIndex("OnlineBeatmapID")
-                        .IsUnique();
-
-                    b.HasIndex("RulesetID");
-
-                    b.ToTable("BeatmapInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapMetadata", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Artist");
-
-                    b.Property<string>("ArtistUnicode");
-
-                    b.Property<string>("AudioFile");
-
-                    b.Property<string>("AuthorString")
-                        .HasColumnName("Author");
-
-                    b.Property<string>("BackgroundFile");
-
-                    b.Property<int>("PreviewTime");
-
-                    b.Property<string>("Source");
-
-                    b.Property<string>("Tags");
-
-                    b.Property<string>("Title");
-
-                    b.Property<string>("TitleUnicode");
-
-                    b.HasKey("ID");
-
-                    b.ToTable("BeatmapMetadata");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("BeatmapSetInfoID");
-
-                    b.Property<int>("FileInfoID");
-
-                    b.Property<string>("Filename")
-                        .IsRequired();
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("BeatmapSetInfoID");
-
-                    b.HasIndex("FileInfoID");
-
-                    b.ToTable("BeatmapSetFileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<bool>("DeletePending");
-
-                    b.Property<string>("Hash");
-
-                    b.Property<int?>("MetadataID");
-
-                    b.Property<int?>("OnlineBeatmapSetID");
-
-                    b.Property<bool>("Protected");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("DeletePending");
-
-                    b.HasIndex("Hash")
-                        .IsUnique();
-
-                    b.HasIndex("MetadataID");
-
-                    b.HasIndex("OnlineBeatmapSetID")
-                        .IsUnique();
-
-                    b.ToTable("BeatmapSetInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Configuration.DatabasedSetting", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("IntKey")
-                        .HasColumnName("Key");
-
-                    b.Property<int?>("RulesetID");
-
-                    b.Property<string>("StringValue")
-                        .HasColumnName("Value");
-
-                    b.Property<int?>("Variant");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("RulesetID", "Variant");
-
-                    b.ToTable("Settings");
-                });
-
-            modelBuilder.Entity("osu.Game.Input.Bindings.DatabasedKeyBinding", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("IntAction")
-                        .HasColumnName("Action");
-
-                    b.Property<string>("KeysString")
-                        .HasColumnName("Keys");
-
-                    b.Property<int?>("RulesetID");
-
-                    b.Property<int?>("Variant");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("IntAction");
-
-                    b.HasIndex("RulesetID", "Variant");
-
-                    b.ToTable("KeyBinding");
-                });
-
-            modelBuilder.Entity("osu.Game.IO.FileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Hash");
-
-                    b.Property<int>("ReferenceCount");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("Hash")
-                        .IsUnique();
-
-                    b.HasIndex("ReferenceCount");
-
-                    b.ToTable("FileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Rulesets.RulesetInfo", b =>
-                {
-                    b.Property<int?>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<bool>("Available");
-
-                    b.Property<string>("InstantiationInfo");
-
-                    b.Property<string>("Name");
-
-                    b.Property<string>("ShortName");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("Available");
-
-                    b.HasIndex("ShortName")
-                        .IsUnique();
-
-                    b.ToTable("RulesetInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Skinning.SkinFileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("FileInfoID");
-
-                    b.Property<string>("Filename")
-                        .IsRequired();
-
-                    b.Property<int>("SkinInfoID");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("FileInfoID");
-
-                    b.HasIndex("SkinInfoID");
-
-                    b.ToTable("SkinFileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Skinning.SkinInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Creator");
-
-                    b.Property<bool>("DeletePending");
-
-                    b.Property<string>("Name");
-
-                    b.HasKey("ID");
-
-                    b.ToTable("SkinInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapDifficulty", "BaseDifficulty")
-                        .WithMany()
-                        .HasForeignKey("BaseDifficultyID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo", "BeatmapSet")
-                        .WithMany("Beatmaps")
-                        .HasForeignKey("BeatmapSetInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
-                        .WithMany("Beatmaps")
-                        .HasForeignKey("MetadataID");
-
-                    b.HasOne("osu.Game.Rulesets.RulesetInfo", "Ruleset")
-                        .WithMany()
-                        .HasForeignKey("RulesetID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo")
-                        .WithMany("Files")
-                        .HasForeignKey("BeatmapSetInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
-                        .WithMany()
-                        .HasForeignKey("FileInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
-                        .WithMany("BeatmapSets")
-                        .HasForeignKey("MetadataID");
-                });
-
-            modelBuilder.Entity("osu.Game.Skinning.SkinFileInfo", b =>
-                {
-                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
-                        .WithMany()
-                        .HasForeignKey("FileInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Skinning.SkinInfo")
-                        .WithMany("Files")
-                        .HasForeignKey("SkinInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-#pragma warning restore 612, 618
-        }
-    }
-}
diff --git a/osu.Game/Migrations/20180529055154_RemoveUniqueHashConstraints.cs b/osu.Game/Migrations/20180529055154_RemoveUniqueHashConstraints.cs
deleted file mode 100644
index 27269cc5fc..0000000000
--- a/osu.Game/Migrations/20180529055154_RemoveUniqueHashConstraints.cs
+++ /dev/null
@@ -1,51 +0,0 @@
-using Microsoft.EntityFrameworkCore.Migrations;
-
-namespace osu.Game.Migrations
-{
-    public partial class RemoveUniqueHashConstraints : Migration
-    {
-        protected override void Up(MigrationBuilder migrationBuilder)
-        {
-            migrationBuilder.DropIndex(
-                name: "IX_BeatmapInfo_Hash",
-                table: "BeatmapInfo");
-
-            migrationBuilder.DropIndex(
-                name: "IX_BeatmapInfo_MD5Hash",
-                table: "BeatmapInfo");
-
-            migrationBuilder.CreateIndex(
-                name: "IX_BeatmapInfo_Hash",
-                table: "BeatmapInfo",
-                column: "Hash");
-
-            migrationBuilder.CreateIndex(
-                name: "IX_BeatmapInfo_MD5Hash",
-                table: "BeatmapInfo",
-                column: "MD5Hash");
-        }
-
-        protected override void Down(MigrationBuilder migrationBuilder)
-        {
-            migrationBuilder.DropIndex(
-                name: "IX_BeatmapInfo_Hash",
-                table: "BeatmapInfo");
-
-            migrationBuilder.DropIndex(
-                name: "IX_BeatmapInfo_MD5Hash",
-                table: "BeatmapInfo");
-
-            migrationBuilder.CreateIndex(
-                name: "IX_BeatmapInfo_Hash",
-                table: "BeatmapInfo",
-                column: "Hash",
-                unique: true);
-
-            migrationBuilder.CreateIndex(
-                name: "IX_BeatmapInfo_MD5Hash",
-                table: "BeatmapInfo",
-                column: "MD5Hash",
-                unique: true);
-        }
-    }
-}
diff --git a/osu.Game/Migrations/20180621044111_UpdateTaikoDefaultBindings.Designer.cs b/osu.Game/Migrations/20180621044111_UpdateTaikoDefaultBindings.Designer.cs
deleted file mode 100644
index aaa11e88b6..0000000000
--- a/osu.Game/Migrations/20180621044111_UpdateTaikoDefaultBindings.Designer.cs
+++ /dev/null
@@ -1,376 +0,0 @@
-// <auto-generated />
-using System;
-using Microsoft.EntityFrameworkCore;
-using Microsoft.EntityFrameworkCore.Infrastructure;
-using Microsoft.EntityFrameworkCore.Migrations;
-using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
-using osu.Game.Database;
-
-namespace osu.Game.Migrations
-{
-    [DbContext(typeof(OsuDbContext))]
-    [Migration("20180621044111_UpdateTaikoDefaultBindings")]
-    partial class UpdateTaikoDefaultBindings
-    {
-        protected override void BuildTargetModel(ModelBuilder modelBuilder)
-        {
-#pragma warning disable 612, 618
-            modelBuilder
-                .HasAnnotation("ProductVersion", "2.1.1-rtm-30846");
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapDifficulty", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<float>("ApproachRate");
-
-                    b.Property<float>("CircleSize");
-
-                    b.Property<float>("DrainRate");
-
-                    b.Property<float>("OverallDifficulty");
-
-                    b.Property<double>("SliderMultiplier");
-
-                    b.Property<double>("SliderTickRate");
-
-                    b.HasKey("ID");
-
-                    b.ToTable("BeatmapDifficulty");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("AudioLeadIn");
-
-                    b.Property<int>("BaseDifficultyID");
-
-                    b.Property<int>("BeatDivisor");
-
-                    b.Property<int>("BeatmapSetInfoID");
-
-                    b.Property<bool>("Countdown");
-
-                    b.Property<double>("DistanceSpacing");
-
-                    b.Property<int>("GridSize");
-
-                    b.Property<string>("Hash");
-
-                    b.Property<bool>("Hidden");
-
-                    b.Property<bool>("LetterboxInBreaks");
-
-                    b.Property<string>("MD5Hash");
-
-                    b.Property<int?>("MetadataID");
-
-                    b.Property<int?>("OnlineBeatmapID");
-
-                    b.Property<string>("Path");
-
-                    b.Property<int>("RulesetID");
-
-                    b.Property<bool>("SpecialStyle");
-
-                    b.Property<float>("StackLeniency");
-
-                    b.Property<double>("StarDifficulty");
-
-                    b.Property<string>("StoredBookmarks");
-
-                    b.Property<double>("TimelineZoom");
-
-                    b.Property<string>("Version");
-
-                    b.Property<bool>("WidescreenStoryboard");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("BaseDifficultyID");
-
-                    b.HasIndex("BeatmapSetInfoID");
-
-                    b.HasIndex("Hash");
-
-                    b.HasIndex("MD5Hash");
-
-                    b.HasIndex("MetadataID");
-
-                    b.HasIndex("OnlineBeatmapID")
-                        .IsUnique();
-
-                    b.HasIndex("RulesetID");
-
-                    b.ToTable("BeatmapInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapMetadata", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Artist");
-
-                    b.Property<string>("ArtistUnicode");
-
-                    b.Property<string>("AudioFile");
-
-                    b.Property<string>("AuthorString")
-                        .HasColumnName("Author");
-
-                    b.Property<string>("BackgroundFile");
-
-                    b.Property<int>("PreviewTime");
-
-                    b.Property<string>("Source");
-
-                    b.Property<string>("Tags");
-
-                    b.Property<string>("Title");
-
-                    b.Property<string>("TitleUnicode");
-
-                    b.HasKey("ID");
-
-                    b.ToTable("BeatmapMetadata");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("BeatmapSetInfoID");
-
-                    b.Property<int>("FileInfoID");
-
-                    b.Property<string>("Filename")
-                        .IsRequired();
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("BeatmapSetInfoID");
-
-                    b.HasIndex("FileInfoID");
-
-                    b.ToTable("BeatmapSetFileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<bool>("DeletePending");
-
-                    b.Property<string>("Hash");
-
-                    b.Property<int?>("MetadataID");
-
-                    b.Property<int?>("OnlineBeatmapSetID");
-
-                    b.Property<bool>("Protected");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("DeletePending");
-
-                    b.HasIndex("Hash")
-                        .IsUnique();
-
-                    b.HasIndex("MetadataID");
-
-                    b.HasIndex("OnlineBeatmapSetID")
-                        .IsUnique();
-
-                    b.ToTable("BeatmapSetInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Configuration.DatabasedSetting", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("IntKey")
-                        .HasColumnName("Key");
-
-                    b.Property<int?>("RulesetID");
-
-                    b.Property<string>("StringValue")
-                        .HasColumnName("Value");
-
-                    b.Property<int?>("Variant");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("RulesetID", "Variant");
-
-                    b.ToTable("Settings");
-                });
-
-            modelBuilder.Entity("osu.Game.Input.Bindings.DatabasedKeyBinding", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("IntAction")
-                        .HasColumnName("Action");
-
-                    b.Property<string>("KeysString")
-                        .HasColumnName("Keys");
-
-                    b.Property<int?>("RulesetID");
-
-                    b.Property<int?>("Variant");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("IntAction");
-
-                    b.HasIndex("RulesetID", "Variant");
-
-                    b.ToTable("KeyBinding");
-                });
-
-            modelBuilder.Entity("osu.Game.IO.FileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Hash");
-
-                    b.Property<int>("ReferenceCount");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("Hash")
-                        .IsUnique();
-
-                    b.HasIndex("ReferenceCount");
-
-                    b.ToTable("FileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Rulesets.RulesetInfo", b =>
-                {
-                    b.Property<int?>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<bool>("Available");
-
-                    b.Property<string>("InstantiationInfo");
-
-                    b.Property<string>("Name");
-
-                    b.Property<string>("ShortName");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("Available");
-
-                    b.HasIndex("ShortName")
-                        .IsUnique();
-
-                    b.ToTable("RulesetInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Skinning.SkinFileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("FileInfoID");
-
-                    b.Property<string>("Filename")
-                        .IsRequired();
-
-                    b.Property<int>("SkinInfoID");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("FileInfoID");
-
-                    b.HasIndex("SkinInfoID");
-
-                    b.ToTable("SkinFileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Skinning.SkinInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Creator");
-
-                    b.Property<bool>("DeletePending");
-
-                    b.Property<string>("Name");
-
-                    b.HasKey("ID");
-
-                    b.ToTable("SkinInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapDifficulty", "BaseDifficulty")
-                        .WithMany()
-                        .HasForeignKey("BaseDifficultyID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo", "BeatmapSet")
-                        .WithMany("Beatmaps")
-                        .HasForeignKey("BeatmapSetInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
-                        .WithMany("Beatmaps")
-                        .HasForeignKey("MetadataID");
-
-                    b.HasOne("osu.Game.Rulesets.RulesetInfo", "Ruleset")
-                        .WithMany()
-                        .HasForeignKey("RulesetID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo")
-                        .WithMany("Files")
-                        .HasForeignKey("BeatmapSetInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
-                        .WithMany()
-                        .HasForeignKey("FileInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
-                        .WithMany("BeatmapSets")
-                        .HasForeignKey("MetadataID");
-                });
-
-            modelBuilder.Entity("osu.Game.Skinning.SkinFileInfo", b =>
-                {
-                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
-                        .WithMany()
-                        .HasForeignKey("FileInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Skinning.SkinInfo")
-                        .WithMany("Files")
-                        .HasForeignKey("SkinInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-#pragma warning restore 612, 618
-        }
-    }
-}
diff --git a/osu.Game/Migrations/20180621044111_UpdateTaikoDefaultBindings.cs b/osu.Game/Migrations/20180621044111_UpdateTaikoDefaultBindings.cs
deleted file mode 100644
index 71304ea979..0000000000
--- a/osu.Game/Migrations/20180621044111_UpdateTaikoDefaultBindings.cs
+++ /dev/null
@@ -1,17 +0,0 @@
-using Microsoft.EntityFrameworkCore.Migrations;
-
-namespace osu.Game.Migrations
-{
-    public partial class UpdateTaikoDefaultBindings : Migration
-    {
-        protected override void Up(MigrationBuilder migrationBuilder)
-        {
-            migrationBuilder.Sql("DELETE FROM KeyBinding WHERE RulesetID = 1");
-        }
-
-        protected override void Down(MigrationBuilder migrationBuilder)
-        {
-            // we can't really tell if these should be restored or not, so let's just not do so.
-        }
-    }
-}
diff --git a/osu.Game/Migrations/20180628011956_RemoveNegativeSetIDs.Designer.cs b/osu.Game/Migrations/20180628011956_RemoveNegativeSetIDs.Designer.cs
deleted file mode 100644
index 7eeacd56d7..0000000000
--- a/osu.Game/Migrations/20180628011956_RemoveNegativeSetIDs.Designer.cs
+++ /dev/null
@@ -1,376 +0,0 @@
-// <auto-generated />
-using System;
-using Microsoft.EntityFrameworkCore;
-using Microsoft.EntityFrameworkCore.Infrastructure;
-using Microsoft.EntityFrameworkCore.Migrations;
-using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
-using osu.Game.Database;
-
-namespace osu.Game.Migrations
-{
-    [DbContext(typeof(OsuDbContext))]
-    [Migration("20180628011956_RemoveNegativeSetIDs")]
-    partial class RemoveNegativeSetIDs
-    {
-        protected override void BuildTargetModel(ModelBuilder modelBuilder)
-        {
-#pragma warning disable 612, 618
-            modelBuilder
-                .HasAnnotation("ProductVersion", "2.1.1-rtm-30846");
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapDifficulty", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<float>("ApproachRate");
-
-                    b.Property<float>("CircleSize");
-
-                    b.Property<float>("DrainRate");
-
-                    b.Property<float>("OverallDifficulty");
-
-                    b.Property<double>("SliderMultiplier");
-
-                    b.Property<double>("SliderTickRate");
-
-                    b.HasKey("ID");
-
-                    b.ToTable("BeatmapDifficulty");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("AudioLeadIn");
-
-                    b.Property<int>("BaseDifficultyID");
-
-                    b.Property<int>("BeatDivisor");
-
-                    b.Property<int>("BeatmapSetInfoID");
-
-                    b.Property<bool>("Countdown");
-
-                    b.Property<double>("DistanceSpacing");
-
-                    b.Property<int>("GridSize");
-
-                    b.Property<string>("Hash");
-
-                    b.Property<bool>("Hidden");
-
-                    b.Property<bool>("LetterboxInBreaks");
-
-                    b.Property<string>("MD5Hash");
-
-                    b.Property<int?>("MetadataID");
-
-                    b.Property<int?>("OnlineBeatmapID");
-
-                    b.Property<string>("Path");
-
-                    b.Property<int>("RulesetID");
-
-                    b.Property<bool>("SpecialStyle");
-
-                    b.Property<float>("StackLeniency");
-
-                    b.Property<double>("StarDifficulty");
-
-                    b.Property<string>("StoredBookmarks");
-
-                    b.Property<double>("TimelineZoom");
-
-                    b.Property<string>("Version");
-
-                    b.Property<bool>("WidescreenStoryboard");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("BaseDifficultyID");
-
-                    b.HasIndex("BeatmapSetInfoID");
-
-                    b.HasIndex("Hash");
-
-                    b.HasIndex("MD5Hash");
-
-                    b.HasIndex("MetadataID");
-
-                    b.HasIndex("OnlineBeatmapID")
-                        .IsUnique();
-
-                    b.HasIndex("RulesetID");
-
-                    b.ToTable("BeatmapInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapMetadata", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Artist");
-
-                    b.Property<string>("ArtistUnicode");
-
-                    b.Property<string>("AudioFile");
-
-                    b.Property<string>("AuthorString")
-                        .HasColumnName("Author");
-
-                    b.Property<string>("BackgroundFile");
-
-                    b.Property<int>("PreviewTime");
-
-                    b.Property<string>("Source");
-
-                    b.Property<string>("Tags");
-
-                    b.Property<string>("Title");
-
-                    b.Property<string>("TitleUnicode");
-
-                    b.HasKey("ID");
-
-                    b.ToTable("BeatmapMetadata");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("BeatmapSetInfoID");
-
-                    b.Property<int>("FileInfoID");
-
-                    b.Property<string>("Filename")
-                        .IsRequired();
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("BeatmapSetInfoID");
-
-                    b.HasIndex("FileInfoID");
-
-                    b.ToTable("BeatmapSetFileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<bool>("DeletePending");
-
-                    b.Property<string>("Hash");
-
-                    b.Property<int?>("MetadataID");
-
-                    b.Property<int?>("OnlineBeatmapSetID");
-
-                    b.Property<bool>("Protected");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("DeletePending");
-
-                    b.HasIndex("Hash")
-                        .IsUnique();
-
-                    b.HasIndex("MetadataID");
-
-                    b.HasIndex("OnlineBeatmapSetID")
-                        .IsUnique();
-
-                    b.ToTable("BeatmapSetInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Configuration.DatabasedSetting", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("IntKey")
-                        .HasColumnName("Key");
-
-                    b.Property<int?>("RulesetID");
-
-                    b.Property<string>("StringValue")
-                        .HasColumnName("Value");
-
-                    b.Property<int?>("Variant");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("RulesetID", "Variant");
-
-                    b.ToTable("Settings");
-                });
-
-            modelBuilder.Entity("osu.Game.Input.Bindings.DatabasedKeyBinding", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("IntAction")
-                        .HasColumnName("Action");
-
-                    b.Property<string>("KeysString")
-                        .HasColumnName("Keys");
-
-                    b.Property<int?>("RulesetID");
-
-                    b.Property<int?>("Variant");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("IntAction");
-
-                    b.HasIndex("RulesetID", "Variant");
-
-                    b.ToTable("KeyBinding");
-                });
-
-            modelBuilder.Entity("osu.Game.IO.FileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Hash");
-
-                    b.Property<int>("ReferenceCount");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("Hash")
-                        .IsUnique();
-
-                    b.HasIndex("ReferenceCount");
-
-                    b.ToTable("FileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Rulesets.RulesetInfo", b =>
-                {
-                    b.Property<int?>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<bool>("Available");
-
-                    b.Property<string>("InstantiationInfo");
-
-                    b.Property<string>("Name");
-
-                    b.Property<string>("ShortName");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("Available");
-
-                    b.HasIndex("ShortName")
-                        .IsUnique();
-
-                    b.ToTable("RulesetInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Skinning.SkinFileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("FileInfoID");
-
-                    b.Property<string>("Filename")
-                        .IsRequired();
-
-                    b.Property<int>("SkinInfoID");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("FileInfoID");
-
-                    b.HasIndex("SkinInfoID");
-
-                    b.ToTable("SkinFileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Skinning.SkinInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Creator");
-
-                    b.Property<bool>("DeletePending");
-
-                    b.Property<string>("Name");
-
-                    b.HasKey("ID");
-
-                    b.ToTable("SkinInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapDifficulty", "BaseDifficulty")
-                        .WithMany()
-                        .HasForeignKey("BaseDifficultyID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo", "BeatmapSet")
-                        .WithMany("Beatmaps")
-                        .HasForeignKey("BeatmapSetInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
-                        .WithMany("Beatmaps")
-                        .HasForeignKey("MetadataID");
-
-                    b.HasOne("osu.Game.Rulesets.RulesetInfo", "Ruleset")
-                        .WithMany()
-                        .HasForeignKey("RulesetID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo")
-                        .WithMany("Files")
-                        .HasForeignKey("BeatmapSetInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
-                        .WithMany()
-                        .HasForeignKey("FileInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
-                        .WithMany("BeatmapSets")
-                        .HasForeignKey("MetadataID");
-                });
-
-            modelBuilder.Entity("osu.Game.Skinning.SkinFileInfo", b =>
-                {
-                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
-                        .WithMany()
-                        .HasForeignKey("FileInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Skinning.SkinInfo")
-                        .WithMany("Files")
-                        .HasForeignKey("SkinInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-#pragma warning restore 612, 618
-        }
-    }
-}
diff --git a/osu.Game/Migrations/20180628011956_RemoveNegativeSetIDs.cs b/osu.Game/Migrations/20180628011956_RemoveNegativeSetIDs.cs
deleted file mode 100644
index 506d65f761..0000000000
--- a/osu.Game/Migrations/20180628011956_RemoveNegativeSetIDs.cs
+++ /dev/null
@@ -1,18 +0,0 @@
-using Microsoft.EntityFrameworkCore.Migrations;
-
-namespace osu.Game.Migrations
-{
-    public partial class RemoveNegativeSetIDs : Migration
-    {
-        protected override void Up(MigrationBuilder migrationBuilder)
-        {
-            // There was a change that beatmaps were being loaded with "-1" online IDs, which is completely incorrect.
-            // This ensures there will not be unique key conflicts as a result of these incorrectly imported beatmaps.
-            migrationBuilder.Sql("UPDATE BeatmapSetInfo SET OnlineBeatmapSetID = null WHERE OnlineBeatmapSetID <= 0");
-        }
-
-        protected override void Down(MigrationBuilder migrationBuilder)
-        {
-        }
-    }
-}
diff --git a/osu.Game/Migrations/20180913080842_AddRankStatus.Designer.cs b/osu.Game/Migrations/20180913080842_AddRankStatus.Designer.cs
deleted file mode 100644
index 5ab43da046..0000000000
--- a/osu.Game/Migrations/20180913080842_AddRankStatus.Designer.cs
+++ /dev/null
@@ -1,380 +0,0 @@
-// <auto-generated />
-using System;
-using Microsoft.EntityFrameworkCore;
-using Microsoft.EntityFrameworkCore.Infrastructure;
-using Microsoft.EntityFrameworkCore.Migrations;
-using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
-using osu.Game.Database;
-
-namespace osu.Game.Migrations
-{
-    [DbContext(typeof(OsuDbContext))]
-    [Migration("20180913080842_AddRankStatus")]
-    partial class AddRankStatus
-    {
-        protected override void BuildTargetModel(ModelBuilder modelBuilder)
-        {
-#pragma warning disable 612, 618
-            modelBuilder
-                .HasAnnotation("ProductVersion", "2.1.2-rtm-30932");
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapDifficulty", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<float>("ApproachRate");
-
-                    b.Property<float>("CircleSize");
-
-                    b.Property<float>("DrainRate");
-
-                    b.Property<float>("OverallDifficulty");
-
-                    b.Property<double>("SliderMultiplier");
-
-                    b.Property<double>("SliderTickRate");
-
-                    b.HasKey("ID");
-
-                    b.ToTable("BeatmapDifficulty");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("AudioLeadIn");
-
-                    b.Property<int>("BaseDifficultyID");
-
-                    b.Property<int>("BeatDivisor");
-
-                    b.Property<int>("BeatmapSetInfoID");
-
-                    b.Property<bool>("Countdown");
-
-                    b.Property<double>("DistanceSpacing");
-
-                    b.Property<int>("GridSize");
-
-                    b.Property<string>("Hash");
-
-                    b.Property<bool>("Hidden");
-
-                    b.Property<bool>("LetterboxInBreaks");
-
-                    b.Property<string>("MD5Hash");
-
-                    b.Property<int?>("MetadataID");
-
-                    b.Property<int?>("OnlineBeatmapID");
-
-                    b.Property<string>("Path");
-
-                    b.Property<int>("RulesetID");
-
-                    b.Property<bool>("SpecialStyle");
-
-                    b.Property<float>("StackLeniency");
-
-                    b.Property<double>("StarDifficulty");
-
-                    b.Property<int>("Status");
-
-                    b.Property<string>("StoredBookmarks");
-
-                    b.Property<double>("TimelineZoom");
-
-                    b.Property<string>("Version");
-
-                    b.Property<bool>("WidescreenStoryboard");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("BaseDifficultyID");
-
-                    b.HasIndex("BeatmapSetInfoID");
-
-                    b.HasIndex("Hash");
-
-                    b.HasIndex("MD5Hash");
-
-                    b.HasIndex("MetadataID");
-
-                    b.HasIndex("OnlineBeatmapID")
-                        .IsUnique();
-
-                    b.HasIndex("RulesetID");
-
-                    b.ToTable("BeatmapInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapMetadata", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Artist");
-
-                    b.Property<string>("ArtistUnicode");
-
-                    b.Property<string>("AudioFile");
-
-                    b.Property<string>("AuthorString")
-                        .HasColumnName("Author");
-
-                    b.Property<string>("BackgroundFile");
-
-                    b.Property<int>("PreviewTime");
-
-                    b.Property<string>("Source");
-
-                    b.Property<string>("Tags");
-
-                    b.Property<string>("Title");
-
-                    b.Property<string>("TitleUnicode");
-
-                    b.HasKey("ID");
-
-                    b.ToTable("BeatmapMetadata");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("BeatmapSetInfoID");
-
-                    b.Property<int>("FileInfoID");
-
-                    b.Property<string>("Filename")
-                        .IsRequired();
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("BeatmapSetInfoID");
-
-                    b.HasIndex("FileInfoID");
-
-                    b.ToTable("BeatmapSetFileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<bool>("DeletePending");
-
-                    b.Property<string>("Hash");
-
-                    b.Property<int?>("MetadataID");
-
-                    b.Property<int?>("OnlineBeatmapSetID");
-
-                    b.Property<bool>("Protected");
-
-                    b.Property<int>("Status");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("DeletePending");
-
-                    b.HasIndex("Hash")
-                        .IsUnique();
-
-                    b.HasIndex("MetadataID");
-
-                    b.HasIndex("OnlineBeatmapSetID")
-                        .IsUnique();
-
-                    b.ToTable("BeatmapSetInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Configuration.DatabasedSetting", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("IntKey")
-                        .HasColumnName("Key");
-
-                    b.Property<int?>("RulesetID");
-
-                    b.Property<string>("StringValue")
-                        .HasColumnName("Value");
-
-                    b.Property<int?>("Variant");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("RulesetID", "Variant");
-
-                    b.ToTable("Settings");
-                });
-
-            modelBuilder.Entity("osu.Game.Input.Bindings.DatabasedKeyBinding", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("IntAction")
-                        .HasColumnName("Action");
-
-                    b.Property<string>("KeysString")
-                        .HasColumnName("Keys");
-
-                    b.Property<int?>("RulesetID");
-
-                    b.Property<int?>("Variant");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("IntAction");
-
-                    b.HasIndex("RulesetID", "Variant");
-
-                    b.ToTable("KeyBinding");
-                });
-
-            modelBuilder.Entity("osu.Game.IO.FileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Hash");
-
-                    b.Property<int>("ReferenceCount");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("Hash")
-                        .IsUnique();
-
-                    b.HasIndex("ReferenceCount");
-
-                    b.ToTable("FileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Rulesets.RulesetInfo", b =>
-                {
-                    b.Property<int?>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<bool>("Available");
-
-                    b.Property<string>("InstantiationInfo");
-
-                    b.Property<string>("Name");
-
-                    b.Property<string>("ShortName");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("Available");
-
-                    b.HasIndex("ShortName")
-                        .IsUnique();
-
-                    b.ToTable("RulesetInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Skinning.SkinFileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("FileInfoID");
-
-                    b.Property<string>("Filename")
-                        .IsRequired();
-
-                    b.Property<int>("SkinInfoID");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("FileInfoID");
-
-                    b.HasIndex("SkinInfoID");
-
-                    b.ToTable("SkinFileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Skinning.SkinInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Creator");
-
-                    b.Property<bool>("DeletePending");
-
-                    b.Property<string>("Name");
-
-                    b.HasKey("ID");
-
-                    b.ToTable("SkinInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapDifficulty", "BaseDifficulty")
-                        .WithMany()
-                        .HasForeignKey("BaseDifficultyID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo", "BeatmapSet")
-                        .WithMany("Beatmaps")
-                        .HasForeignKey("BeatmapSetInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
-                        .WithMany("Beatmaps")
-                        .HasForeignKey("MetadataID");
-
-                    b.HasOne("osu.Game.Rulesets.RulesetInfo", "Ruleset")
-                        .WithMany()
-                        .HasForeignKey("RulesetID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo")
-                        .WithMany("Files")
-                        .HasForeignKey("BeatmapSetInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
-                        .WithMany()
-                        .HasForeignKey("FileInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
-                        .WithMany("BeatmapSets")
-                        .HasForeignKey("MetadataID");
-                });
-
-            modelBuilder.Entity("osu.Game.Skinning.SkinFileInfo", b =>
-                {
-                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
-                        .WithMany()
-                        .HasForeignKey("FileInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Skinning.SkinInfo")
-                        .WithMany("Files")
-                        .HasForeignKey("SkinInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-#pragma warning restore 612, 618
-        }
-    }
-}
diff --git a/osu.Game/Migrations/20180913080842_AddRankStatus.cs b/osu.Game/Migrations/20180913080842_AddRankStatus.cs
deleted file mode 100644
index bba4944bb7..0000000000
--- a/osu.Game/Migrations/20180913080842_AddRankStatus.cs
+++ /dev/null
@@ -1,33 +0,0 @@
-using Microsoft.EntityFrameworkCore.Migrations;
-
-namespace osu.Game.Migrations
-{
-    public partial class AddRankStatus : Migration
-    {
-        protected override void Up(MigrationBuilder migrationBuilder)
-        {
-            migrationBuilder.AddColumn<int>(
-                name: "Status",
-                table: "BeatmapSetInfo",
-                nullable: false,
-                defaultValue: -3); // NONE
-
-            migrationBuilder.AddColumn<int>(
-                name: "Status",
-                table: "BeatmapInfo",
-                nullable: false,
-                defaultValue: -3); // NONE
-        }
-
-        protected override void Down(MigrationBuilder migrationBuilder)
-        {
-            migrationBuilder.DropColumn(
-                name: "Status",
-                table: "BeatmapSetInfo");
-
-            migrationBuilder.DropColumn(
-                name: "Status",
-                table: "BeatmapInfo");
-        }
-    }
-}
diff --git a/osu.Game/Migrations/20181007180454_StandardizePaths.Designer.cs b/osu.Game/Migrations/20181007180454_StandardizePaths.Designer.cs
deleted file mode 100644
index b387a45ecf..0000000000
--- a/osu.Game/Migrations/20181007180454_StandardizePaths.Designer.cs
+++ /dev/null
@@ -1,380 +0,0 @@
-// <auto-generated />
-using System;
-using Microsoft.EntityFrameworkCore;
-using Microsoft.EntityFrameworkCore.Infrastructure;
-using Microsoft.EntityFrameworkCore.Migrations;
-using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
-using osu.Game.Database;
-
-namespace osu.Game.Migrations
-{
-    [DbContext(typeof(OsuDbContext))]
-    [Migration("20181007180454_StandardizePaths")]
-    partial class StandardizePaths
-    {
-        protected override void BuildTargetModel(ModelBuilder modelBuilder)
-        {
-#pragma warning disable 612, 618
-            modelBuilder
-                .HasAnnotation("ProductVersion", "2.1.3-rtm-32065");
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapDifficulty", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<float>("ApproachRate");
-
-                    b.Property<float>("CircleSize");
-
-                    b.Property<float>("DrainRate");
-
-                    b.Property<float>("OverallDifficulty");
-
-                    b.Property<double>("SliderMultiplier");
-
-                    b.Property<double>("SliderTickRate");
-
-                    b.HasKey("ID");
-
-                    b.ToTable("BeatmapDifficulty");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("AudioLeadIn");
-
-                    b.Property<int>("BaseDifficultyID");
-
-                    b.Property<int>("BeatDivisor");
-
-                    b.Property<int>("BeatmapSetInfoID");
-
-                    b.Property<bool>("Countdown");
-
-                    b.Property<double>("DistanceSpacing");
-
-                    b.Property<int>("GridSize");
-
-                    b.Property<string>("Hash");
-
-                    b.Property<bool>("Hidden");
-
-                    b.Property<bool>("LetterboxInBreaks");
-
-                    b.Property<string>("MD5Hash");
-
-                    b.Property<int?>("MetadataID");
-
-                    b.Property<int?>("OnlineBeatmapID");
-
-                    b.Property<string>("Path");
-
-                    b.Property<int>("RulesetID");
-
-                    b.Property<bool>("SpecialStyle");
-
-                    b.Property<float>("StackLeniency");
-
-                    b.Property<double>("StarDifficulty");
-
-                    b.Property<int>("Status");
-
-                    b.Property<string>("StoredBookmarks");
-
-                    b.Property<double>("TimelineZoom");
-
-                    b.Property<string>("Version");
-
-                    b.Property<bool>("WidescreenStoryboard");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("BaseDifficultyID");
-
-                    b.HasIndex("BeatmapSetInfoID");
-
-                    b.HasIndex("Hash");
-
-                    b.HasIndex("MD5Hash");
-
-                    b.HasIndex("MetadataID");
-
-                    b.HasIndex("OnlineBeatmapID")
-                        .IsUnique();
-
-                    b.HasIndex("RulesetID");
-
-                    b.ToTable("BeatmapInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapMetadata", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Artist");
-
-                    b.Property<string>("ArtistUnicode");
-
-                    b.Property<string>("AudioFile");
-
-                    b.Property<string>("AuthorString")
-                        .HasColumnName("Author");
-
-                    b.Property<string>("BackgroundFile");
-
-                    b.Property<int>("PreviewTime");
-
-                    b.Property<string>("Source");
-
-                    b.Property<string>("Tags");
-
-                    b.Property<string>("Title");
-
-                    b.Property<string>("TitleUnicode");
-
-                    b.HasKey("ID");
-
-                    b.ToTable("BeatmapMetadata");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("BeatmapSetInfoID");
-
-                    b.Property<int>("FileInfoID");
-
-                    b.Property<string>("Filename")
-                        .IsRequired();
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("BeatmapSetInfoID");
-
-                    b.HasIndex("FileInfoID");
-
-                    b.ToTable("BeatmapSetFileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<bool>("DeletePending");
-
-                    b.Property<string>("Hash");
-
-                    b.Property<int?>("MetadataID");
-
-                    b.Property<int?>("OnlineBeatmapSetID");
-
-                    b.Property<bool>("Protected");
-
-                    b.Property<int>("Status");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("DeletePending");
-
-                    b.HasIndex("Hash")
-                        .IsUnique();
-
-                    b.HasIndex("MetadataID");
-
-                    b.HasIndex("OnlineBeatmapSetID")
-                        .IsUnique();
-
-                    b.ToTable("BeatmapSetInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Configuration.DatabasedSetting", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("IntKey")
-                        .HasColumnName("Key");
-
-                    b.Property<int?>("RulesetID");
-
-                    b.Property<string>("StringValue")
-                        .HasColumnName("Value");
-
-                    b.Property<int?>("Variant");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("RulesetID", "Variant");
-
-                    b.ToTable("Settings");
-                });
-
-            modelBuilder.Entity("osu.Game.Input.Bindings.DatabasedKeyBinding", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("IntAction")
-                        .HasColumnName("Action");
-
-                    b.Property<string>("KeysString")
-                        .HasColumnName("Keys");
-
-                    b.Property<int?>("RulesetID");
-
-                    b.Property<int?>("Variant");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("IntAction");
-
-                    b.HasIndex("RulesetID", "Variant");
-
-                    b.ToTable("KeyBinding");
-                });
-
-            modelBuilder.Entity("osu.Game.IO.FileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Hash");
-
-                    b.Property<int>("ReferenceCount");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("Hash")
-                        .IsUnique();
-
-                    b.HasIndex("ReferenceCount");
-
-                    b.ToTable("FileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Rulesets.RulesetInfo", b =>
-                {
-                    b.Property<int?>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<bool>("Available");
-
-                    b.Property<string>("InstantiationInfo");
-
-                    b.Property<string>("Name");
-
-                    b.Property<string>("ShortName");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("Available");
-
-                    b.HasIndex("ShortName")
-                        .IsUnique();
-
-                    b.ToTable("RulesetInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Skinning.SkinFileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("FileInfoID");
-
-                    b.Property<string>("Filename")
-                        .IsRequired();
-
-                    b.Property<int>("SkinInfoID");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("FileInfoID");
-
-                    b.HasIndex("SkinInfoID");
-
-                    b.ToTable("SkinFileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Skinning.SkinInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Creator");
-
-                    b.Property<bool>("DeletePending");
-
-                    b.Property<string>("Name");
-
-                    b.HasKey("ID");
-
-                    b.ToTable("SkinInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapDifficulty", "BaseDifficulty")
-                        .WithMany()
-                        .HasForeignKey("BaseDifficultyID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo", "BeatmapSet")
-                        .WithMany("Beatmaps")
-                        .HasForeignKey("BeatmapSetInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
-                        .WithMany("Beatmaps")
-                        .HasForeignKey("MetadataID");
-
-                    b.HasOne("osu.Game.Rulesets.RulesetInfo", "Ruleset")
-                        .WithMany()
-                        .HasForeignKey("RulesetID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo")
-                        .WithMany("Files")
-                        .HasForeignKey("BeatmapSetInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
-                        .WithMany()
-                        .HasForeignKey("FileInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
-                        .WithMany("BeatmapSets")
-                        .HasForeignKey("MetadataID");
-                });
-
-            modelBuilder.Entity("osu.Game.Skinning.SkinFileInfo", b =>
-                {
-                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
-                        .WithMany()
-                        .HasForeignKey("FileInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Skinning.SkinInfo")
-                        .WithMany("Files")
-                        .HasForeignKey("SkinInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-#pragma warning restore 612, 618
-        }
-    }
-}
diff --git a/osu.Game/Migrations/20181007180454_StandardizePaths.cs b/osu.Game/Migrations/20181007180454_StandardizePaths.cs
deleted file mode 100644
index 274b8030a9..0000000000
--- a/osu.Game/Migrations/20181007180454_StandardizePaths.cs
+++ /dev/null
@@ -1,26 +0,0 @@
-using System;
-using Microsoft.EntityFrameworkCore.Migrations;
-using System.IO;
-
-namespace osu.Game.Migrations
-{
-    public partial class StandardizePaths : Migration
-    {
-        protected override void Up(MigrationBuilder migrationBuilder)
-        {
-            string windowsStyle = @"\";
-            string standardized = "/";
-
-            // Escaping \ does not seem to be needed.
-            migrationBuilder.Sql($"UPDATE `BeatmapInfo` SET `Path` = REPLACE(`Path`, '{windowsStyle}', '{standardized}')");
-            migrationBuilder.Sql($"UPDATE `BeatmapMetadata` SET `AudioFile` = REPLACE(`AudioFile`, '{windowsStyle}', '{standardized}')");
-            migrationBuilder.Sql($"UPDATE `BeatmapMetadata` SET `BackgroundFile` = REPLACE(`BackgroundFile`, '{windowsStyle}', '{standardized}')");
-            migrationBuilder.Sql($"UPDATE `BeatmapSetFileInfo` SET `Filename` = REPLACE(`Filename`, '{windowsStyle}', '{standardized}')");
-            migrationBuilder.Sql($"UPDATE `SkinFileInfo` SET `Filename` = REPLACE(`Filename`, '{windowsStyle}', '{standardized}')");
-        }
-
-        protected override void Down(MigrationBuilder migrationBuilder)
-        {
-        }
-    }
-}
diff --git a/osu.Game/Migrations/20181128100659_AddSkinInfoHash.Designer.cs b/osu.Game/Migrations/20181128100659_AddSkinInfoHash.Designer.cs
deleted file mode 100644
index 120674671a..0000000000
--- a/osu.Game/Migrations/20181128100659_AddSkinInfoHash.Designer.cs
+++ /dev/null
@@ -1,387 +0,0 @@
-// <auto-generated />
-using System;
-using Microsoft.EntityFrameworkCore;
-using Microsoft.EntityFrameworkCore.Infrastructure;
-using Microsoft.EntityFrameworkCore.Migrations;
-using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
-using osu.Game.Database;
-
-namespace osu.Game.Migrations
-{
-    [DbContext(typeof(OsuDbContext))]
-    [Migration("20181128100659_AddSkinInfoHash")]
-    partial class AddSkinInfoHash
-    {
-        protected override void BuildTargetModel(ModelBuilder modelBuilder)
-        {
-#pragma warning disable 612, 618
-            modelBuilder
-                .HasAnnotation("ProductVersion", "2.1.4-rtm-31024");
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapDifficulty", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<float>("ApproachRate");
-
-                    b.Property<float>("CircleSize");
-
-                    b.Property<float>("DrainRate");
-
-                    b.Property<float>("OverallDifficulty");
-
-                    b.Property<double>("SliderMultiplier");
-
-                    b.Property<double>("SliderTickRate");
-
-                    b.HasKey("ID");
-
-                    b.ToTable("BeatmapDifficulty");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("AudioLeadIn");
-
-                    b.Property<int>("BaseDifficultyID");
-
-                    b.Property<int>("BeatDivisor");
-
-                    b.Property<int>("BeatmapSetInfoID");
-
-                    b.Property<bool>("Countdown");
-
-                    b.Property<double>("DistanceSpacing");
-
-                    b.Property<int>("GridSize");
-
-                    b.Property<string>("Hash");
-
-                    b.Property<bool>("Hidden");
-
-                    b.Property<bool>("LetterboxInBreaks");
-
-                    b.Property<string>("MD5Hash");
-
-                    b.Property<int?>("MetadataID");
-
-                    b.Property<int?>("OnlineBeatmapID");
-
-                    b.Property<string>("Path");
-
-                    b.Property<int>("RulesetID");
-
-                    b.Property<bool>("SpecialStyle");
-
-                    b.Property<float>("StackLeniency");
-
-                    b.Property<double>("StarDifficulty");
-
-                    b.Property<int>("Status");
-
-                    b.Property<string>("StoredBookmarks");
-
-                    b.Property<double>("TimelineZoom");
-
-                    b.Property<string>("Version");
-
-                    b.Property<bool>("WidescreenStoryboard");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("BaseDifficultyID");
-
-                    b.HasIndex("BeatmapSetInfoID");
-
-                    b.HasIndex("Hash");
-
-                    b.HasIndex("MD5Hash");
-
-                    b.HasIndex("MetadataID");
-
-                    b.HasIndex("OnlineBeatmapID")
-                        .IsUnique();
-
-                    b.HasIndex("RulesetID");
-
-                    b.ToTable("BeatmapInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapMetadata", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Artist");
-
-                    b.Property<string>("ArtistUnicode");
-
-                    b.Property<string>("AudioFile");
-
-                    b.Property<string>("AuthorString")
-                        .HasColumnName("Author");
-
-                    b.Property<string>("BackgroundFile");
-
-                    b.Property<int>("PreviewTime");
-
-                    b.Property<string>("Source");
-
-                    b.Property<string>("Tags");
-
-                    b.Property<string>("Title");
-
-                    b.Property<string>("TitleUnicode");
-
-                    b.HasKey("ID");
-
-                    b.ToTable("BeatmapMetadata");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("BeatmapSetInfoID");
-
-                    b.Property<int>("FileInfoID");
-
-                    b.Property<string>("Filename")
-                        .IsRequired();
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("BeatmapSetInfoID");
-
-                    b.HasIndex("FileInfoID");
-
-                    b.ToTable("BeatmapSetFileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<bool>("DeletePending");
-
-                    b.Property<string>("Hash");
-
-                    b.Property<int?>("MetadataID");
-
-                    b.Property<int?>("OnlineBeatmapSetID");
-
-                    b.Property<bool>("Protected");
-
-                    b.Property<int>("Status");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("DeletePending");
-
-                    b.HasIndex("Hash")
-                        .IsUnique();
-
-                    b.HasIndex("MetadataID");
-
-                    b.HasIndex("OnlineBeatmapSetID")
-                        .IsUnique();
-
-                    b.ToTable("BeatmapSetInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Configuration.DatabasedSetting", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("IntKey")
-                        .HasColumnName("Key");
-
-                    b.Property<int?>("RulesetID");
-
-                    b.Property<string>("StringValue")
-                        .HasColumnName("Value");
-
-                    b.Property<int?>("Variant");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("RulesetID", "Variant");
-
-                    b.ToTable("Settings");
-                });
-
-            modelBuilder.Entity("osu.Game.Input.Bindings.DatabasedKeyBinding", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("IntAction")
-                        .HasColumnName("Action");
-
-                    b.Property<string>("KeysString")
-                        .HasColumnName("Keys");
-
-                    b.Property<int?>("RulesetID");
-
-                    b.Property<int?>("Variant");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("IntAction");
-
-                    b.HasIndex("RulesetID", "Variant");
-
-                    b.ToTable("KeyBinding");
-                });
-
-            modelBuilder.Entity("osu.Game.IO.FileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Hash");
-
-                    b.Property<int>("ReferenceCount");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("Hash")
-                        .IsUnique();
-
-                    b.HasIndex("ReferenceCount");
-
-                    b.ToTable("FileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Rulesets.RulesetInfo", b =>
-                {
-                    b.Property<int?>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<bool>("Available");
-
-                    b.Property<string>("InstantiationInfo");
-
-                    b.Property<string>("Name");
-
-                    b.Property<string>("ShortName");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("Available");
-
-                    b.HasIndex("ShortName")
-                        .IsUnique();
-
-                    b.ToTable("RulesetInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Skinning.SkinFileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("FileInfoID");
-
-                    b.Property<string>("Filename")
-                        .IsRequired();
-
-                    b.Property<int>("SkinInfoID");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("FileInfoID");
-
-                    b.HasIndex("SkinInfoID");
-
-                    b.ToTable("SkinFileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Skinning.SkinInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Creator");
-
-                    b.Property<bool>("DeletePending");
-
-                    b.Property<string>("Hash");
-
-                    b.Property<string>("Name");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("DeletePending");
-
-                    b.HasIndex("Hash")
-                        .IsUnique();
-
-                    b.ToTable("SkinInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapDifficulty", "BaseDifficulty")
-                        .WithMany()
-                        .HasForeignKey("BaseDifficultyID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo", "BeatmapSet")
-                        .WithMany("Beatmaps")
-                        .HasForeignKey("BeatmapSetInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
-                        .WithMany("Beatmaps")
-                        .HasForeignKey("MetadataID");
-
-                    b.HasOne("osu.Game.Rulesets.RulesetInfo", "Ruleset")
-                        .WithMany()
-                        .HasForeignKey("RulesetID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo")
-                        .WithMany("Files")
-                        .HasForeignKey("BeatmapSetInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
-                        .WithMany()
-                        .HasForeignKey("FileInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
-                        .WithMany("BeatmapSets")
-                        .HasForeignKey("MetadataID");
-                });
-
-            modelBuilder.Entity("osu.Game.Skinning.SkinFileInfo", b =>
-                {
-                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
-                        .WithMany()
-                        .HasForeignKey("FileInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Skinning.SkinInfo")
-                        .WithMany("Files")
-                        .HasForeignKey("SkinInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-#pragma warning restore 612, 618
-        }
-    }
-}
diff --git a/osu.Game/Migrations/20181128100659_AddSkinInfoHash.cs b/osu.Game/Migrations/20181128100659_AddSkinInfoHash.cs
deleted file mode 100644
index 860264a7dd..0000000000
--- a/osu.Game/Migrations/20181128100659_AddSkinInfoHash.cs
+++ /dev/null
@@ -1,41 +0,0 @@
-using Microsoft.EntityFrameworkCore.Migrations;
-
-namespace osu.Game.Migrations
-{
-    public partial class AddSkinInfoHash : Migration
-    {
-        protected override void Up(MigrationBuilder migrationBuilder)
-        {
-            migrationBuilder.AddColumn<string>(
-                name: "Hash",
-                table: "SkinInfo",
-                nullable: true);
-
-            migrationBuilder.CreateIndex(
-                name: "IX_SkinInfo_DeletePending",
-                table: "SkinInfo",
-                column: "DeletePending");
-
-            migrationBuilder.CreateIndex(
-                name: "IX_SkinInfo_Hash",
-                table: "SkinInfo",
-                column: "Hash",
-                unique: true);
-        }
-
-        protected override void Down(MigrationBuilder migrationBuilder)
-        {
-            migrationBuilder.DropIndex(
-                name: "IX_SkinInfo_DeletePending",
-                table: "SkinInfo");
-
-            migrationBuilder.DropIndex(
-                name: "IX_SkinInfo_Hash",
-                table: "SkinInfo");
-
-            migrationBuilder.DropColumn(
-                name: "Hash",
-                table: "SkinInfo");
-        }
-    }
-}
diff --git a/osu.Game/Migrations/20181130113755_AddScoreInfoTables.Designer.cs b/osu.Game/Migrations/20181130113755_AddScoreInfoTables.Designer.cs
deleted file mode 100644
index eee53182ce..0000000000
--- a/osu.Game/Migrations/20181130113755_AddScoreInfoTables.Designer.cs
+++ /dev/null
@@ -1,484 +0,0 @@
-// <auto-generated />
-using System;
-using Microsoft.EntityFrameworkCore;
-using Microsoft.EntityFrameworkCore.Infrastructure;
-using Microsoft.EntityFrameworkCore.Migrations;
-using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
-using osu.Game.Database;
-
-namespace osu.Game.Migrations
-{
-    [DbContext(typeof(OsuDbContext))]
-    [Migration("20181130113755_AddScoreInfoTables")]
-    partial class AddScoreInfoTables
-    {
-        protected override void BuildTargetModel(ModelBuilder modelBuilder)
-        {
-#pragma warning disable 612, 618
-            modelBuilder
-                .HasAnnotation("ProductVersion", "2.1.4-rtm-31024");
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapDifficulty", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<float>("ApproachRate");
-
-                    b.Property<float>("CircleSize");
-
-                    b.Property<float>("DrainRate");
-
-                    b.Property<float>("OverallDifficulty");
-
-                    b.Property<double>("SliderMultiplier");
-
-                    b.Property<double>("SliderTickRate");
-
-                    b.HasKey("ID");
-
-                    b.ToTable("BeatmapDifficulty");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("AudioLeadIn");
-
-                    b.Property<int>("BaseDifficultyID");
-
-                    b.Property<int>("BeatDivisor");
-
-                    b.Property<int>("BeatmapSetInfoID");
-
-                    b.Property<bool>("Countdown");
-
-                    b.Property<double>("DistanceSpacing");
-
-                    b.Property<int>("GridSize");
-
-                    b.Property<string>("Hash");
-
-                    b.Property<bool>("Hidden");
-
-                    b.Property<bool>("LetterboxInBreaks");
-
-                    b.Property<string>("MD5Hash");
-
-                    b.Property<int?>("MetadataID");
-
-                    b.Property<int?>("OnlineBeatmapID");
-
-                    b.Property<string>("Path");
-
-                    b.Property<int>("RulesetID");
-
-                    b.Property<bool>("SpecialStyle");
-
-                    b.Property<float>("StackLeniency");
-
-                    b.Property<double>("StarDifficulty");
-
-                    b.Property<int>("Status");
-
-                    b.Property<string>("StoredBookmarks");
-
-                    b.Property<double>("TimelineZoom");
-
-                    b.Property<string>("Version");
-
-                    b.Property<bool>("WidescreenStoryboard");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("BaseDifficultyID");
-
-                    b.HasIndex("BeatmapSetInfoID");
-
-                    b.HasIndex("Hash");
-
-                    b.HasIndex("MD5Hash");
-
-                    b.HasIndex("MetadataID");
-
-                    b.HasIndex("OnlineBeatmapID")
-                        .IsUnique();
-
-                    b.HasIndex("RulesetID");
-
-                    b.ToTable("BeatmapInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapMetadata", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Artist");
-
-                    b.Property<string>("ArtistUnicode");
-
-                    b.Property<string>("AudioFile");
-
-                    b.Property<string>("AuthorString")
-                        .HasColumnName("Author");
-
-                    b.Property<string>("BackgroundFile");
-
-                    b.Property<int>("PreviewTime");
-
-                    b.Property<string>("Source");
-
-                    b.Property<string>("Tags");
-
-                    b.Property<string>("Title");
-
-                    b.Property<string>("TitleUnicode");
-
-                    b.HasKey("ID");
-
-                    b.ToTable("BeatmapMetadata");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("BeatmapSetInfoID");
-
-                    b.Property<int>("FileInfoID");
-
-                    b.Property<string>("Filename")
-                        .IsRequired();
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("BeatmapSetInfoID");
-
-                    b.HasIndex("FileInfoID");
-
-                    b.ToTable("BeatmapSetFileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<bool>("DeletePending");
-
-                    b.Property<string>("Hash");
-
-                    b.Property<int?>("MetadataID");
-
-                    b.Property<int?>("OnlineBeatmapSetID");
-
-                    b.Property<bool>("Protected");
-
-                    b.Property<int>("Status");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("DeletePending");
-
-                    b.HasIndex("Hash")
-                        .IsUnique();
-
-                    b.HasIndex("MetadataID");
-
-                    b.HasIndex("OnlineBeatmapSetID")
-                        .IsUnique();
-
-                    b.ToTable("BeatmapSetInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Configuration.DatabasedSetting", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("IntKey")
-                        .HasColumnName("Key");
-
-                    b.Property<int?>("RulesetID");
-
-                    b.Property<string>("StringValue")
-                        .HasColumnName("Value");
-
-                    b.Property<int?>("Variant");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("RulesetID", "Variant");
-
-                    b.ToTable("Settings");
-                });
-
-            modelBuilder.Entity("osu.Game.Input.Bindings.DatabasedKeyBinding", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("IntAction")
-                        .HasColumnName("Action");
-
-                    b.Property<string>("KeysString")
-                        .HasColumnName("Keys");
-
-                    b.Property<int?>("RulesetID");
-
-                    b.Property<int?>("Variant");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("IntAction");
-
-                    b.HasIndex("RulesetID", "Variant");
-
-                    b.ToTable("KeyBinding");
-                });
-
-            modelBuilder.Entity("osu.Game.IO.FileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Hash");
-
-                    b.Property<int>("ReferenceCount");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("Hash")
-                        .IsUnique();
-
-                    b.HasIndex("ReferenceCount");
-
-                    b.ToTable("FileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Rulesets.RulesetInfo", b =>
-                {
-                    b.Property<int?>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<bool>("Available");
-
-                    b.Property<string>("InstantiationInfo");
-
-                    b.Property<string>("Name");
-
-                    b.Property<string>("ShortName");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("Available");
-
-                    b.HasIndex("ShortName")
-                        .IsUnique();
-
-                    b.ToTable("RulesetInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Scoring.ScoreFileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("FileInfoID");
-
-                    b.Property<string>("Filename")
-                        .IsRequired();
-
-                    b.Property<int?>("ScoreInfoID");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("FileInfoID");
-
-                    b.HasIndex("ScoreInfoID");
-
-                    b.ToTable("ScoreFileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Scoring.ScoreInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<double>("Accuracy")
-                        .HasColumnType("DECIMAL(1,4)");
-
-                    b.Property<int>("BeatmapInfoID");
-
-                    b.Property<int>("Combo");
-
-                    b.Property<DateTimeOffset>("Date");
-
-                    b.Property<bool>("DeletePending");
-
-                    b.Property<string>("Hash");
-
-                    b.Property<int>("MaxCombo");
-
-                    b.Property<string>("ModsJson")
-                        .HasColumnName("Mods");
-
-                    b.Property<long?>("OnlineScoreID");
-
-                    b.Property<double?>("PP");
-
-                    b.Property<int>("Rank");
-
-                    b.Property<int>("RulesetID");
-
-                    b.Property<string>("StatisticsJson")
-                        .HasColumnName("Statistics");
-
-                    b.Property<int>("TotalScore");
-
-                    b.Property<string>("UserString")
-                        .HasColumnName("User");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("BeatmapInfoID");
-
-                    b.HasIndex("OnlineScoreID")
-                        .IsUnique();
-
-                    b.HasIndex("RulesetID");
-
-                    b.ToTable("ScoreInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Skinning.SkinFileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("FileInfoID");
-
-                    b.Property<string>("Filename")
-                        .IsRequired();
-
-                    b.Property<int>("SkinInfoID");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("FileInfoID");
-
-                    b.HasIndex("SkinInfoID");
-
-                    b.ToTable("SkinFileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Skinning.SkinInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Creator");
-
-                    b.Property<bool>("DeletePending");
-
-                    b.Property<string>("Hash");
-
-                    b.Property<string>("Name");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("DeletePending");
-
-                    b.HasIndex("Hash")
-                        .IsUnique();
-
-                    b.ToTable("SkinInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapDifficulty", "BaseDifficulty")
-                        .WithMany()
-                        .HasForeignKey("BaseDifficultyID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo", "BeatmapSet")
-                        .WithMany("Beatmaps")
-                        .HasForeignKey("BeatmapSetInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
-                        .WithMany("Beatmaps")
-                        .HasForeignKey("MetadataID");
-
-                    b.HasOne("osu.Game.Rulesets.RulesetInfo", "Ruleset")
-                        .WithMany()
-                        .HasForeignKey("RulesetID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo")
-                        .WithMany("Files")
-                        .HasForeignKey("BeatmapSetInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
-                        .WithMany()
-                        .HasForeignKey("FileInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
-                        .WithMany("BeatmapSets")
-                        .HasForeignKey("MetadataID");
-                });
-
-            modelBuilder.Entity("osu.Game.Scoring.ScoreFileInfo", b =>
-                {
-                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
-                        .WithMany()
-                        .HasForeignKey("FileInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Scoring.ScoreInfo")
-                        .WithMany("Files")
-                        .HasForeignKey("ScoreInfoID");
-                });
-
-            modelBuilder.Entity("osu.Game.Scoring.ScoreInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapInfo", "Beatmap")
-                        .WithMany()
-                        .HasForeignKey("BeatmapInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Rulesets.RulesetInfo", "Ruleset")
-                        .WithMany()
-                        .HasForeignKey("RulesetID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-
-            modelBuilder.Entity("osu.Game.Skinning.SkinFileInfo", b =>
-                {
-                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
-                        .WithMany()
-                        .HasForeignKey("FileInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Skinning.SkinInfo")
-                        .WithMany("Files")
-                        .HasForeignKey("SkinInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-#pragma warning restore 612, 618
-        }
-    }
-}
diff --git a/osu.Game/Migrations/20181130113755_AddScoreInfoTables.cs b/osu.Game/Migrations/20181130113755_AddScoreInfoTables.cs
deleted file mode 100644
index 2b6f94c5a4..0000000000
--- a/osu.Game/Migrations/20181130113755_AddScoreInfoTables.cs
+++ /dev/null
@@ -1,112 +0,0 @@
-using System;
-using Microsoft.EntityFrameworkCore.Migrations;
-
-namespace osu.Game.Migrations
-{
-    public partial class AddScoreInfoTables : Migration
-    {
-        protected override void Up(MigrationBuilder migrationBuilder)
-        {
-            migrationBuilder.CreateTable(
-                name: "ScoreInfo",
-                columns: table => new
-                {
-                    ID = table.Column<int>(nullable: false)
-                        .Annotation("Sqlite:Autoincrement", true),
-                    Rank = table.Column<int>(nullable: false),
-                    TotalScore = table.Column<int>(nullable: false),
-                    Accuracy = table.Column<double>(type: "DECIMAL(1,4)", nullable: false),
-                    PP = table.Column<double>(nullable: true),
-                    MaxCombo = table.Column<int>(nullable: false),
-                    Combo = table.Column<int>(nullable: false),
-                    RulesetID = table.Column<int>(nullable: false),
-                    Mods = table.Column<string>(nullable: true),
-                    User = table.Column<string>(nullable: true),
-                    BeatmapInfoID = table.Column<int>(nullable: false),
-                    OnlineScoreID = table.Column<long>(nullable: true),
-                    Date = table.Column<DateTimeOffset>(nullable: false),
-                    Statistics = table.Column<string>(nullable: true),
-                    Hash = table.Column<string>(nullable: true),
-                    DeletePending = table.Column<bool>(nullable: false)
-                },
-                constraints: table =>
-                {
-                    table.PrimaryKey("PK_ScoreInfo", x => x.ID);
-                    table.ForeignKey(
-                        name: "FK_ScoreInfo_BeatmapInfo_BeatmapInfoID",
-                        column: x => x.BeatmapInfoID,
-                        principalTable: "BeatmapInfo",
-                        principalColumn: "ID",
-                        onDelete: ReferentialAction.Cascade);
-                    table.ForeignKey(
-                        name: "FK_ScoreInfo_RulesetInfo_RulesetID",
-                        column: x => x.RulesetID,
-                        principalTable: "RulesetInfo",
-                        principalColumn: "ID",
-                        onDelete: ReferentialAction.Cascade);
-                });
-
-            migrationBuilder.CreateTable(
-                name: "ScoreFileInfo",
-                columns: table => new
-                {
-                    ID = table.Column<int>(nullable: false)
-                        .Annotation("Sqlite:Autoincrement", true),
-                    FileInfoID = table.Column<int>(nullable: false),
-                    Filename = table.Column<string>(nullable: false),
-                    ScoreInfoID = table.Column<int>(nullable: true)
-                },
-                constraints: table =>
-                {
-                    table.PrimaryKey("PK_ScoreFileInfo", x => x.ID);
-                    table.ForeignKey(
-                        name: "FK_ScoreFileInfo_FileInfo_FileInfoID",
-                        column: x => x.FileInfoID,
-                        principalTable: "FileInfo",
-                        principalColumn: "ID",
-                        onDelete: ReferentialAction.Cascade);
-                    table.ForeignKey(
-                        name: "FK_ScoreFileInfo_ScoreInfo_ScoreInfoID",
-                        column: x => x.ScoreInfoID,
-                        principalTable: "ScoreInfo",
-                        principalColumn: "ID",
-                        onDelete: ReferentialAction.Restrict);
-                });
-
-            migrationBuilder.CreateIndex(
-                name: "IX_ScoreFileInfo_FileInfoID",
-                table: "ScoreFileInfo",
-                column: "FileInfoID");
-
-            migrationBuilder.CreateIndex(
-                name: "IX_ScoreFileInfo_ScoreInfoID",
-                table: "ScoreFileInfo",
-                column: "ScoreInfoID");
-
-            migrationBuilder.CreateIndex(
-                name: "IX_ScoreInfo_BeatmapInfoID",
-                table: "ScoreInfo",
-                column: "BeatmapInfoID");
-
-            migrationBuilder.CreateIndex(
-                name: "IX_ScoreInfo_OnlineScoreID",
-                table: "ScoreInfo",
-                column: "OnlineScoreID",
-                unique: true);
-
-            migrationBuilder.CreateIndex(
-                name: "IX_ScoreInfo_RulesetID",
-                table: "ScoreInfo",
-                column: "RulesetID");
-        }
-
-        protected override void Down(MigrationBuilder migrationBuilder)
-        {
-            migrationBuilder.DropTable(
-                name: "ScoreFileInfo");
-
-            migrationBuilder.DropTable(
-                name: "ScoreInfo");
-        }
-    }
-}
diff --git a/osu.Game/Migrations/20190225062029_AddUserIDColumn.Designer.cs b/osu.Game/Migrations/20190225062029_AddUserIDColumn.Designer.cs
deleted file mode 100644
index 8e1e3a59f3..0000000000
--- a/osu.Game/Migrations/20190225062029_AddUserIDColumn.Designer.cs
+++ /dev/null
@@ -1,487 +0,0 @@
-// <auto-generated />
-using System;
-using Microsoft.EntityFrameworkCore;
-using Microsoft.EntityFrameworkCore.Infrastructure;
-using Microsoft.EntityFrameworkCore.Migrations;
-using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
-using osu.Game.Database;
-
-namespace osu.Game.Migrations
-{
-    [DbContext(typeof(OsuDbContext))]
-    [Migration("20190225062029_AddUserIDColumn")]
-    partial class AddUserIDColumn
-    {
-        protected override void BuildTargetModel(ModelBuilder modelBuilder)
-        {
-#pragma warning disable 612, 618
-            modelBuilder
-                .HasAnnotation("ProductVersion", "2.2.1-servicing-10028");
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapDifficulty", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<float>("ApproachRate");
-
-                    b.Property<float>("CircleSize");
-
-                    b.Property<float>("DrainRate");
-
-                    b.Property<float>("OverallDifficulty");
-
-                    b.Property<double>("SliderMultiplier");
-
-                    b.Property<double>("SliderTickRate");
-
-                    b.HasKey("ID");
-
-                    b.ToTable("BeatmapDifficulty");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("AudioLeadIn");
-
-                    b.Property<int>("BaseDifficultyID");
-
-                    b.Property<int>("BeatDivisor");
-
-                    b.Property<int>("BeatmapSetInfoID");
-
-                    b.Property<bool>("Countdown");
-
-                    b.Property<double>("DistanceSpacing");
-
-                    b.Property<int>("GridSize");
-
-                    b.Property<string>("Hash");
-
-                    b.Property<bool>("Hidden");
-
-                    b.Property<bool>("LetterboxInBreaks");
-
-                    b.Property<string>("MD5Hash");
-
-                    b.Property<int?>("MetadataID");
-
-                    b.Property<int?>("OnlineBeatmapID");
-
-                    b.Property<string>("Path");
-
-                    b.Property<int>("RulesetID");
-
-                    b.Property<bool>("SpecialStyle");
-
-                    b.Property<float>("StackLeniency");
-
-                    b.Property<double>("StarDifficulty");
-
-                    b.Property<int>("Status");
-
-                    b.Property<string>("StoredBookmarks");
-
-                    b.Property<double>("TimelineZoom");
-
-                    b.Property<string>("Version");
-
-                    b.Property<bool>("WidescreenStoryboard");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("BaseDifficultyID");
-
-                    b.HasIndex("BeatmapSetInfoID");
-
-                    b.HasIndex("Hash");
-
-                    b.HasIndex("MD5Hash");
-
-                    b.HasIndex("MetadataID");
-
-                    b.HasIndex("OnlineBeatmapID")
-                        .IsUnique();
-
-                    b.HasIndex("RulesetID");
-
-                    b.ToTable("BeatmapInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapMetadata", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Artist");
-
-                    b.Property<string>("ArtistUnicode");
-
-                    b.Property<string>("AudioFile");
-
-                    b.Property<string>("AuthorString")
-                        .HasColumnName("Author");
-
-                    b.Property<string>("BackgroundFile");
-
-                    b.Property<int>("PreviewTime");
-
-                    b.Property<string>("Source");
-
-                    b.Property<string>("Tags");
-
-                    b.Property<string>("Title");
-
-                    b.Property<string>("TitleUnicode");
-
-                    b.HasKey("ID");
-
-                    b.ToTable("BeatmapMetadata");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("BeatmapSetInfoID");
-
-                    b.Property<int>("FileInfoID");
-
-                    b.Property<string>("Filename")
-                        .IsRequired();
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("BeatmapSetInfoID");
-
-                    b.HasIndex("FileInfoID");
-
-                    b.ToTable("BeatmapSetFileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<bool>("DeletePending");
-
-                    b.Property<string>("Hash");
-
-                    b.Property<int?>("MetadataID");
-
-                    b.Property<int?>("OnlineBeatmapSetID");
-
-                    b.Property<bool>("Protected");
-
-                    b.Property<int>("Status");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("DeletePending");
-
-                    b.HasIndex("Hash")
-                        .IsUnique();
-
-                    b.HasIndex("MetadataID");
-
-                    b.HasIndex("OnlineBeatmapSetID")
-                        .IsUnique();
-
-                    b.ToTable("BeatmapSetInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Configuration.DatabasedSetting", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("IntKey")
-                        .HasColumnName("Key");
-
-                    b.Property<int?>("RulesetID");
-
-                    b.Property<string>("StringValue")
-                        .HasColumnName("Value");
-
-                    b.Property<int?>("Variant");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("RulesetID", "Variant");
-
-                    b.ToTable("Settings");
-                });
-
-            modelBuilder.Entity("osu.Game.IO.FileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Hash");
-
-                    b.Property<int>("ReferenceCount");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("Hash")
-                        .IsUnique();
-
-                    b.HasIndex("ReferenceCount");
-
-                    b.ToTable("FileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Input.Bindings.DatabasedKeyBinding", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("IntAction")
-                        .HasColumnName("Action");
-
-                    b.Property<string>("KeysString")
-                        .HasColumnName("Keys");
-
-                    b.Property<int?>("RulesetID");
-
-                    b.Property<int?>("Variant");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("IntAction");
-
-                    b.HasIndex("RulesetID", "Variant");
-
-                    b.ToTable("KeyBinding");
-                });
-
-            modelBuilder.Entity("osu.Game.Rulesets.RulesetInfo", b =>
-                {
-                    b.Property<int?>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<bool>("Available");
-
-                    b.Property<string>("InstantiationInfo");
-
-                    b.Property<string>("Name");
-
-                    b.Property<string>("ShortName");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("Available");
-
-                    b.HasIndex("ShortName")
-                        .IsUnique();
-
-                    b.ToTable("RulesetInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Scoring.ScoreFileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("FileInfoID");
-
-                    b.Property<string>("Filename")
-                        .IsRequired();
-
-                    b.Property<int?>("ScoreInfoID");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("FileInfoID");
-
-                    b.HasIndex("ScoreInfoID");
-
-                    b.ToTable("ScoreFileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Scoring.ScoreInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<double>("Accuracy")
-                        .HasColumnType("DECIMAL(1,4)");
-
-                    b.Property<int>("BeatmapInfoID");
-
-                    b.Property<int>("Combo");
-
-                    b.Property<DateTimeOffset>("Date");
-
-                    b.Property<bool>("DeletePending");
-
-                    b.Property<string>("Hash");
-
-                    b.Property<int>("MaxCombo");
-
-                    b.Property<string>("ModsJson")
-                        .HasColumnName("Mods");
-
-                    b.Property<long?>("OnlineScoreID");
-
-                    b.Property<double?>("PP");
-
-                    b.Property<int>("Rank");
-
-                    b.Property<int>("RulesetID");
-
-                    b.Property<string>("StatisticsJson")
-                        .HasColumnName("Statistics");
-
-                    b.Property<int>("TotalScore");
-
-                    b.Property<long?>("UserID")
-                        .HasColumnName("UserID");
-
-                    b.Property<string>("UserString")
-                        .HasColumnName("User");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("BeatmapInfoID");
-
-                    b.HasIndex("OnlineScoreID")
-                        .IsUnique();
-
-                    b.HasIndex("RulesetID");
-
-                    b.ToTable("ScoreInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Skinning.SkinFileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("FileInfoID");
-
-                    b.Property<string>("Filename")
-                        .IsRequired();
-
-                    b.Property<int>("SkinInfoID");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("FileInfoID");
-
-                    b.HasIndex("SkinInfoID");
-
-                    b.ToTable("SkinFileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Skinning.SkinInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Creator");
-
-                    b.Property<bool>("DeletePending");
-
-                    b.Property<string>("Hash");
-
-                    b.Property<string>("Name");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("DeletePending");
-
-                    b.HasIndex("Hash")
-                        .IsUnique();
-
-                    b.ToTable("SkinInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapDifficulty", "BaseDifficulty")
-                        .WithMany()
-                        .HasForeignKey("BaseDifficultyID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo", "BeatmapSet")
-                        .WithMany("Beatmaps")
-                        .HasForeignKey("BeatmapSetInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
-                        .WithMany("Beatmaps")
-                        .HasForeignKey("MetadataID");
-
-                    b.HasOne("osu.Game.Rulesets.RulesetInfo", "Ruleset")
-                        .WithMany()
-                        .HasForeignKey("RulesetID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo")
-                        .WithMany("Files")
-                        .HasForeignKey("BeatmapSetInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
-                        .WithMany()
-                        .HasForeignKey("FileInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
-                        .WithMany("BeatmapSets")
-                        .HasForeignKey("MetadataID");
-                });
-
-            modelBuilder.Entity("osu.Game.Scoring.ScoreFileInfo", b =>
-                {
-                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
-                        .WithMany()
-                        .HasForeignKey("FileInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Scoring.ScoreInfo")
-                        .WithMany("Files")
-                        .HasForeignKey("ScoreInfoID");
-                });
-
-            modelBuilder.Entity("osu.Game.Scoring.ScoreInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapInfo", "Beatmap")
-                        .WithMany("Scores")
-                        .HasForeignKey("BeatmapInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Rulesets.RulesetInfo", "Ruleset")
-                        .WithMany()
-                        .HasForeignKey("RulesetID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-
-            modelBuilder.Entity("osu.Game.Skinning.SkinFileInfo", b =>
-                {
-                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
-                        .WithMany()
-                        .HasForeignKey("FileInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Skinning.SkinInfo")
-                        .WithMany("Files")
-                        .HasForeignKey("SkinInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-#pragma warning restore 612, 618
-        }
-    }
-}
diff --git a/osu.Game/Migrations/20190225062029_AddUserIDColumn.cs b/osu.Game/Migrations/20190225062029_AddUserIDColumn.cs
deleted file mode 100644
index 0720e0eac7..0000000000
--- a/osu.Game/Migrations/20190225062029_AddUserIDColumn.cs
+++ /dev/null
@@ -1,22 +0,0 @@
-using Microsoft.EntityFrameworkCore.Migrations;
-
-namespace osu.Game.Migrations
-{
-    public partial class AddUserIDColumn : Migration
-    {
-        protected override void Up(MigrationBuilder migrationBuilder)
-        {
-            migrationBuilder.AddColumn<long>(
-                name: "UserID",
-                table: "ScoreInfo",
-                nullable: true);
-        }
-
-        protected override void Down(MigrationBuilder migrationBuilder)
-        {
-            migrationBuilder.DropColumn(
-                name: "UserID",
-                table: "ScoreInfo");
-        }
-    }
-}
diff --git a/osu.Game/Migrations/20190525060824_SkinSettings.Designer.cs b/osu.Game/Migrations/20190525060824_SkinSettings.Designer.cs
deleted file mode 100644
index 348c42adb9..0000000000
--- a/osu.Game/Migrations/20190525060824_SkinSettings.Designer.cs
+++ /dev/null
@@ -1,498 +0,0 @@
-// <auto-generated />
-using System;
-using Microsoft.EntityFrameworkCore;
-using Microsoft.EntityFrameworkCore.Infrastructure;
-using Microsoft.EntityFrameworkCore.Migrations;
-using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
-using osu.Game.Database;
-
-namespace osu.Game.Migrations
-{
-    [DbContext(typeof(OsuDbContext))]
-    [Migration("20190525060824_SkinSettings")]
-    partial class SkinSettings
-    {
-        protected override void BuildTargetModel(ModelBuilder modelBuilder)
-        {
-#pragma warning disable 612, 618
-            modelBuilder
-                .HasAnnotation("ProductVersion", "2.2.4-servicing-10062");
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapDifficulty", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<float>("ApproachRate");
-
-                    b.Property<float>("CircleSize");
-
-                    b.Property<float>("DrainRate");
-
-                    b.Property<float>("OverallDifficulty");
-
-                    b.Property<double>("SliderMultiplier");
-
-                    b.Property<double>("SliderTickRate");
-
-                    b.HasKey("ID");
-
-                    b.ToTable("BeatmapDifficulty");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("AudioLeadIn");
-
-                    b.Property<int>("BaseDifficultyID");
-
-                    b.Property<int>("BeatDivisor");
-
-                    b.Property<int>("BeatmapSetInfoID");
-
-                    b.Property<bool>("Countdown");
-
-                    b.Property<double>("DistanceSpacing");
-
-                    b.Property<int>("GridSize");
-
-                    b.Property<string>("Hash");
-
-                    b.Property<bool>("Hidden");
-
-                    b.Property<bool>("LetterboxInBreaks");
-
-                    b.Property<string>("MD5Hash");
-
-                    b.Property<int?>("MetadataID");
-
-                    b.Property<int?>("OnlineBeatmapID");
-
-                    b.Property<string>("Path");
-
-                    b.Property<int>("RulesetID");
-
-                    b.Property<bool>("SpecialStyle");
-
-                    b.Property<float>("StackLeniency");
-
-                    b.Property<double>("StarDifficulty");
-
-                    b.Property<int>("Status");
-
-                    b.Property<string>("StoredBookmarks");
-
-                    b.Property<double>("TimelineZoom");
-
-                    b.Property<string>("Version");
-
-                    b.Property<bool>("WidescreenStoryboard");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("BaseDifficultyID");
-
-                    b.HasIndex("BeatmapSetInfoID");
-
-                    b.HasIndex("Hash");
-
-                    b.HasIndex("MD5Hash");
-
-                    b.HasIndex("MetadataID");
-
-                    b.HasIndex("OnlineBeatmapID")
-                        .IsUnique();
-
-                    b.HasIndex("RulesetID");
-
-                    b.ToTable("BeatmapInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapMetadata", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Artist");
-
-                    b.Property<string>("ArtistUnicode");
-
-                    b.Property<string>("AudioFile");
-
-                    b.Property<string>("AuthorString")
-                        .HasColumnName("Author");
-
-                    b.Property<string>("BackgroundFile");
-
-                    b.Property<int>("PreviewTime");
-
-                    b.Property<string>("Source");
-
-                    b.Property<string>("Tags");
-
-                    b.Property<string>("Title");
-
-                    b.Property<string>("TitleUnicode");
-
-                    b.HasKey("ID");
-
-                    b.ToTable("BeatmapMetadata");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("BeatmapSetInfoID");
-
-                    b.Property<int>("FileInfoID");
-
-                    b.Property<string>("Filename")
-                        .IsRequired();
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("BeatmapSetInfoID");
-
-                    b.HasIndex("FileInfoID");
-
-                    b.ToTable("BeatmapSetFileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<bool>("DeletePending");
-
-                    b.Property<string>("Hash");
-
-                    b.Property<int?>("MetadataID");
-
-                    b.Property<int?>("OnlineBeatmapSetID");
-
-                    b.Property<bool>("Protected");
-
-                    b.Property<int>("Status");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("DeletePending");
-
-                    b.HasIndex("Hash")
-                        .IsUnique();
-
-                    b.HasIndex("MetadataID");
-
-                    b.HasIndex("OnlineBeatmapSetID")
-                        .IsUnique();
-
-                    b.ToTable("BeatmapSetInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Configuration.DatabasedSetting", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Key")
-                        .HasColumnName("Key");
-
-                    b.Property<int?>("RulesetID");
-
-                    b.Property<int?>("SkinInfoID");
-
-                    b.Property<string>("StringValue")
-                        .HasColumnName("Value");
-
-                    b.Property<int?>("Variant");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("SkinInfoID");
-
-                    b.HasIndex("RulesetID", "Variant");
-
-                    b.ToTable("Settings");
-                });
-
-            modelBuilder.Entity("osu.Game.IO.FileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Hash");
-
-                    b.Property<int>("ReferenceCount");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("Hash")
-                        .IsUnique();
-
-                    b.HasIndex("ReferenceCount");
-
-                    b.ToTable("FileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Input.Bindings.DatabasedKeyBinding", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("IntAction")
-                        .HasColumnName("Action");
-
-                    b.Property<string>("KeysString")
-                        .HasColumnName("Keys");
-
-                    b.Property<int?>("RulesetID");
-
-                    b.Property<int?>("Variant");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("IntAction");
-
-                    b.HasIndex("RulesetID", "Variant");
-
-                    b.ToTable("KeyBinding");
-                });
-
-            modelBuilder.Entity("osu.Game.Rulesets.RulesetInfo", b =>
-                {
-                    b.Property<int?>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<bool>("Available");
-
-                    b.Property<string>("InstantiationInfo");
-
-                    b.Property<string>("Name");
-
-                    b.Property<string>("ShortName");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("Available");
-
-                    b.HasIndex("ShortName")
-                        .IsUnique();
-
-                    b.ToTable("RulesetInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Scoring.ScoreFileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("FileInfoID");
-
-                    b.Property<string>("Filename")
-                        .IsRequired();
-
-                    b.Property<int?>("ScoreInfoID");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("FileInfoID");
-
-                    b.HasIndex("ScoreInfoID");
-
-                    b.ToTable("ScoreFileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Scoring.ScoreInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<double>("Accuracy")
-                        .HasColumnType("DECIMAL(1,4)");
-
-                    b.Property<int>("BeatmapInfoID");
-
-                    b.Property<int>("Combo");
-
-                    b.Property<DateTimeOffset>("Date");
-
-                    b.Property<bool>("DeletePending");
-
-                    b.Property<string>("Hash");
-
-                    b.Property<int>("MaxCombo");
-
-                    b.Property<string>("ModsJson")
-                        .HasColumnName("Mods");
-
-                    b.Property<long?>("OnlineScoreID");
-
-                    b.Property<double?>("PP");
-
-                    b.Property<int>("Rank");
-
-                    b.Property<int>("RulesetID");
-
-                    b.Property<string>("StatisticsJson")
-                        .HasColumnName("Statistics");
-
-                    b.Property<long>("TotalScore");
-
-                    b.Property<long?>("UserID")
-                        .HasColumnName("UserID");
-
-                    b.Property<string>("UserString")
-                        .HasColumnName("User");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("BeatmapInfoID");
-
-                    b.HasIndex("OnlineScoreID")
-                        .IsUnique();
-
-                    b.HasIndex("RulesetID");
-
-                    b.ToTable("ScoreInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Skinning.SkinFileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("FileInfoID");
-
-                    b.Property<string>("Filename")
-                        .IsRequired();
-
-                    b.Property<int>("SkinInfoID");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("FileInfoID");
-
-                    b.HasIndex("SkinInfoID");
-
-                    b.ToTable("SkinFileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Skinning.SkinInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Creator");
-
-                    b.Property<bool>("DeletePending");
-
-                    b.Property<string>("Hash");
-
-                    b.Property<string>("Name");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("DeletePending");
-
-                    b.HasIndex("Hash")
-                        .IsUnique();
-
-                    b.ToTable("SkinInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapDifficulty", "BaseDifficulty")
-                        .WithMany()
-                        .HasForeignKey("BaseDifficultyID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo", "BeatmapSet")
-                        .WithMany("Beatmaps")
-                        .HasForeignKey("BeatmapSetInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
-                        .WithMany("Beatmaps")
-                        .HasForeignKey("MetadataID");
-
-                    b.HasOne("osu.Game.Rulesets.RulesetInfo", "Ruleset")
-                        .WithMany()
-                        .HasForeignKey("RulesetID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo")
-                        .WithMany("Files")
-                        .HasForeignKey("BeatmapSetInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
-                        .WithMany()
-                        .HasForeignKey("FileInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
-                        .WithMany("BeatmapSets")
-                        .HasForeignKey("MetadataID");
-                });
-
-            modelBuilder.Entity("osu.Game.Configuration.DatabasedSetting", b =>
-                {
-                    b.HasOne("osu.Game.Skinning.SkinInfo")
-                        .WithMany("Settings")
-                        .HasForeignKey("SkinInfoID");
-                });
-
-            modelBuilder.Entity("osu.Game.Scoring.ScoreFileInfo", b =>
-                {
-                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
-                        .WithMany()
-                        .HasForeignKey("FileInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Scoring.ScoreInfo")
-                        .WithMany("Files")
-                        .HasForeignKey("ScoreInfoID");
-                });
-
-            modelBuilder.Entity("osu.Game.Scoring.ScoreInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapInfo", "Beatmap")
-                        .WithMany("Scores")
-                        .HasForeignKey("BeatmapInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Rulesets.RulesetInfo", "Ruleset")
-                        .WithMany()
-                        .HasForeignKey("RulesetID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-
-            modelBuilder.Entity("osu.Game.Skinning.SkinFileInfo", b =>
-                {
-                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
-                        .WithMany()
-                        .HasForeignKey("FileInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Skinning.SkinInfo")
-                        .WithMany("Files")
-                        .HasForeignKey("SkinInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-#pragma warning restore 612, 618
-        }
-    }
-}
diff --git a/osu.Game/Migrations/20190525060824_SkinSettings.cs b/osu.Game/Migrations/20190525060824_SkinSettings.cs
deleted file mode 100644
index 99237419b7..0000000000
--- a/osu.Game/Migrations/20190525060824_SkinSettings.cs
+++ /dev/null
@@ -1,54 +0,0 @@
-using Microsoft.EntityFrameworkCore.Migrations;
-
-namespace osu.Game.Migrations
-{
-    public partial class SkinSettings : Migration
-    {
-        protected override void Up(MigrationBuilder migrationBuilder)
-        {
-            migrationBuilder.Sql(@"create table Settings_dg_tmp
-            (
-	            ID INTEGER not null
-		            constraint PK_Settings
-			            primary key autoincrement,
-	            Key TEXT not null,
-	            RulesetID INTEGER,
-	            Value TEXT,
-	            Variant INTEGER,
-	            SkinInfoID int
-		            constraint Settings_SkinInfo_ID_fk
-			            references SkinInfo
-				            on delete restrict
-            );
-
-            insert into Settings_dg_tmp(ID, Key, RulesetID, Value, Variant) select ID, Key, RulesetID, Value, Variant from Settings;
-
-            drop table Settings;
-
-            alter table Settings_dg_tmp rename to Settings;
-
-            create index IX_Settings_RulesetID_Variant
-	            on Settings (RulesetID, Variant);
-
-            create index Settings_SkinInfoID_index
-	            on Settings (SkinInfoID);
-
-            ");
-        }
-
-        protected override void Down(MigrationBuilder migrationBuilder)
-        {
-            migrationBuilder.DropForeignKey(
-                name: "FK_Settings_SkinInfo_SkinInfoID",
-                table: "Settings");
-
-            migrationBuilder.DropIndex(
-                name: "IX_Settings_SkinInfoID",
-                table: "Settings");
-
-            migrationBuilder.DropColumn(
-                name: "SkinInfoID",
-                table: "Settings");
-        }
-    }
-}
diff --git a/osu.Game/Migrations/20190605091246_AddDateAddedColumnToBeatmapSet.Designer.cs b/osu.Game/Migrations/20190605091246_AddDateAddedColumnToBeatmapSet.Designer.cs
deleted file mode 100644
index 9477369aa0..0000000000
--- a/osu.Game/Migrations/20190605091246_AddDateAddedColumnToBeatmapSet.Designer.cs
+++ /dev/null
@@ -1,489 +0,0 @@
-// <auto-generated />
-using System;
-using Microsoft.EntityFrameworkCore;
-using Microsoft.EntityFrameworkCore.Infrastructure;
-using Microsoft.EntityFrameworkCore.Migrations;
-using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
-using osu.Game.Database;
-
-namespace osu.Game.Migrations
-{
-    [DbContext(typeof(OsuDbContext))]
-    [Migration("20190605091246_AddDateAddedColumnToBeatmapSet")]
-    partial class AddDateAddedColumnToBeatmapSet
-    {
-        protected override void BuildTargetModel(ModelBuilder modelBuilder)
-        {
-#pragma warning disable 612, 618
-            modelBuilder
-                .HasAnnotation("ProductVersion", "2.2.4-servicing-10062");
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapDifficulty", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<float>("ApproachRate");
-
-                    b.Property<float>("CircleSize");
-
-                    b.Property<float>("DrainRate");
-
-                    b.Property<float>("OverallDifficulty");
-
-                    b.Property<double>("SliderMultiplier");
-
-                    b.Property<double>("SliderTickRate");
-
-                    b.HasKey("ID");
-
-                    b.ToTable("BeatmapDifficulty");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("AudioLeadIn");
-
-                    b.Property<int>("BaseDifficultyID");
-
-                    b.Property<int>("BeatDivisor");
-
-                    b.Property<int>("BeatmapSetInfoID");
-
-                    b.Property<bool>("Countdown");
-
-                    b.Property<double>("DistanceSpacing");
-
-                    b.Property<int>("GridSize");
-
-                    b.Property<string>("Hash");
-
-                    b.Property<bool>("Hidden");
-
-                    b.Property<bool>("LetterboxInBreaks");
-
-                    b.Property<string>("MD5Hash");
-
-                    b.Property<int?>("MetadataID");
-
-                    b.Property<int?>("OnlineBeatmapID");
-
-                    b.Property<string>("Path");
-
-                    b.Property<int>("RulesetID");
-
-                    b.Property<bool>("SpecialStyle");
-
-                    b.Property<float>("StackLeniency");
-
-                    b.Property<double>("StarDifficulty");
-
-                    b.Property<int>("Status");
-
-                    b.Property<string>("StoredBookmarks");
-
-                    b.Property<double>("TimelineZoom");
-
-                    b.Property<string>("Version");
-
-                    b.Property<bool>("WidescreenStoryboard");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("BaseDifficultyID");
-
-                    b.HasIndex("BeatmapSetInfoID");
-
-                    b.HasIndex("Hash");
-
-                    b.HasIndex("MD5Hash");
-
-                    b.HasIndex("MetadataID");
-
-                    b.HasIndex("OnlineBeatmapID")
-                        .IsUnique();
-
-                    b.HasIndex("RulesetID");
-
-                    b.ToTable("BeatmapInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapMetadata", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Artist");
-
-                    b.Property<string>("ArtistUnicode");
-
-                    b.Property<string>("AudioFile");
-
-                    b.Property<string>("AuthorString")
-                        .HasColumnName("Author");
-
-                    b.Property<string>("BackgroundFile");
-
-                    b.Property<int>("PreviewTime");
-
-                    b.Property<string>("Source");
-
-                    b.Property<string>("Tags");
-
-                    b.Property<string>("Title");
-
-                    b.Property<string>("TitleUnicode");
-
-                    b.HasKey("ID");
-
-                    b.ToTable("BeatmapMetadata");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("BeatmapSetInfoID");
-
-                    b.Property<int>("FileInfoID");
-
-                    b.Property<string>("Filename")
-                        .IsRequired();
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("BeatmapSetInfoID");
-
-                    b.HasIndex("FileInfoID");
-
-                    b.ToTable("BeatmapSetFileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<DateTimeOffset>("DateAdded");
-
-                    b.Property<bool>("DeletePending");
-
-                    b.Property<string>("Hash");
-
-                    b.Property<int?>("MetadataID");
-
-                    b.Property<int?>("OnlineBeatmapSetID");
-
-                    b.Property<bool>("Protected");
-
-                    b.Property<int>("Status");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("DeletePending");
-
-                    b.HasIndex("Hash")
-                        .IsUnique();
-
-                    b.HasIndex("MetadataID");
-
-                    b.HasIndex("OnlineBeatmapSetID")
-                        .IsUnique();
-
-                    b.ToTable("BeatmapSetInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Configuration.DatabasedSetting", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Key")
-                        .HasColumnName("Key");
-
-                    b.Property<int?>("RulesetID");
-
-                    b.Property<string>("StringValue")
-                        .HasColumnName("Value");
-
-                    b.Property<int?>("Variant");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("RulesetID", "Variant");
-
-                    b.ToTable("Settings");
-                });
-
-            modelBuilder.Entity("osu.Game.IO.FileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Hash");
-
-                    b.Property<int>("ReferenceCount");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("Hash")
-                        .IsUnique();
-
-                    b.HasIndex("ReferenceCount");
-
-                    b.ToTable("FileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Input.Bindings.DatabasedKeyBinding", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("IntAction")
-                        .HasColumnName("Action");
-
-                    b.Property<string>("KeysString")
-                        .HasColumnName("Keys");
-
-                    b.Property<int?>("RulesetID");
-
-                    b.Property<int?>("Variant");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("IntAction");
-
-                    b.HasIndex("RulesetID", "Variant");
-
-                    b.ToTable("KeyBinding");
-                });
-
-            modelBuilder.Entity("osu.Game.Rulesets.RulesetInfo", b =>
-                {
-                    b.Property<int?>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<bool>("Available");
-
-                    b.Property<string>("InstantiationInfo");
-
-                    b.Property<string>("Name");
-
-                    b.Property<string>("ShortName");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("Available");
-
-                    b.HasIndex("ShortName")
-                        .IsUnique();
-
-                    b.ToTable("RulesetInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Scoring.ScoreFileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("FileInfoID");
-
-                    b.Property<string>("Filename")
-                        .IsRequired();
-
-                    b.Property<int?>("ScoreInfoID");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("FileInfoID");
-
-                    b.HasIndex("ScoreInfoID");
-
-                    b.ToTable("ScoreFileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Scoring.ScoreInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<double>("Accuracy")
-                        .HasColumnType("DECIMAL(1,4)");
-
-                    b.Property<int>("BeatmapInfoID");
-
-                    b.Property<int>("Combo");
-
-                    b.Property<DateTimeOffset>("Date");
-
-                    b.Property<bool>("DeletePending");
-
-                    b.Property<string>("Hash");
-
-                    b.Property<int>("MaxCombo");
-
-                    b.Property<string>("ModsJson")
-                        .HasColumnName("Mods");
-
-                    b.Property<long?>("OnlineScoreID");
-
-                    b.Property<double?>("PP");
-
-                    b.Property<int>("Rank");
-
-                    b.Property<int>("RulesetID");
-
-                    b.Property<string>("StatisticsJson")
-                        .HasColumnName("Statistics");
-
-                    b.Property<long>("TotalScore");
-
-                    b.Property<long?>("UserID")
-                        .HasColumnName("UserID");
-
-                    b.Property<string>("UserString")
-                        .HasColumnName("User");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("BeatmapInfoID");
-
-                    b.HasIndex("OnlineScoreID")
-                        .IsUnique();
-
-                    b.HasIndex("RulesetID");
-
-                    b.ToTable("ScoreInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Skinning.SkinFileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("FileInfoID");
-
-                    b.Property<string>("Filename")
-                        .IsRequired();
-
-                    b.Property<int>("SkinInfoID");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("FileInfoID");
-
-                    b.HasIndex("SkinInfoID");
-
-                    b.ToTable("SkinFileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Skinning.SkinInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Creator");
-
-                    b.Property<bool>("DeletePending");
-
-                    b.Property<string>("Hash");
-
-                    b.Property<string>("Name");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("DeletePending");
-
-                    b.HasIndex("Hash")
-                        .IsUnique();
-
-                    b.ToTable("SkinInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapDifficulty", "BaseDifficulty")
-                        .WithMany()
-                        .HasForeignKey("BaseDifficultyID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo", "BeatmapSet")
-                        .WithMany("Beatmaps")
-                        .HasForeignKey("BeatmapSetInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
-                        .WithMany("Beatmaps")
-                        .HasForeignKey("MetadataID");
-
-                    b.HasOne("osu.Game.Rulesets.RulesetInfo", "Ruleset")
-                        .WithMany()
-                        .HasForeignKey("RulesetID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo")
-                        .WithMany("Files")
-                        .HasForeignKey("BeatmapSetInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
-                        .WithMany()
-                        .HasForeignKey("FileInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
-                        .WithMany("BeatmapSets")
-                        .HasForeignKey("MetadataID");
-                });
-
-            modelBuilder.Entity("osu.Game.Scoring.ScoreFileInfo", b =>
-                {
-                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
-                        .WithMany()
-                        .HasForeignKey("FileInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Scoring.ScoreInfo")
-                        .WithMany("Files")
-                        .HasForeignKey("ScoreInfoID");
-                });
-
-            modelBuilder.Entity("osu.Game.Scoring.ScoreInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapInfo", "Beatmap")
-                        .WithMany("Scores")
-                        .HasForeignKey("BeatmapInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Rulesets.RulesetInfo", "Ruleset")
-                        .WithMany()
-                        .HasForeignKey("RulesetID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-
-            modelBuilder.Entity("osu.Game.Skinning.SkinFileInfo", b =>
-                {
-                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
-                        .WithMany()
-                        .HasForeignKey("FileInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Skinning.SkinInfo")
-                        .WithMany("Files")
-                        .HasForeignKey("SkinInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-#pragma warning restore 612, 618
-        }
-    }
-}
diff --git a/osu.Game/Migrations/20190605091246_AddDateAddedColumnToBeatmapSet.cs b/osu.Game/Migrations/20190605091246_AddDateAddedColumnToBeatmapSet.cs
deleted file mode 100644
index 55dc18b6a3..0000000000
--- a/osu.Game/Migrations/20190605091246_AddDateAddedColumnToBeatmapSet.cs
+++ /dev/null
@@ -1,24 +0,0 @@
-using System;
-using Microsoft.EntityFrameworkCore.Migrations;
-
-namespace osu.Game.Migrations
-{
-    public partial class AddDateAddedColumnToBeatmapSet : Migration
-    {
-        protected override void Up(MigrationBuilder migrationBuilder)
-        {
-            migrationBuilder.AddColumn<DateTimeOffset>(
-                name: "DateAdded",
-                table: "BeatmapSetInfo",
-                nullable: false,
-                defaultValue: new DateTimeOffset(new DateTime(1, 1, 1, 0, 0, 0, 0, DateTimeKind.Unspecified), new TimeSpan(0, 0, 0, 0, 0)));
-        }
-
-        protected override void Down(MigrationBuilder migrationBuilder)
-        {
-            migrationBuilder.DropColumn(
-                name: "DateAdded",
-                table: "BeatmapSetInfo");
-        }
-    }
-}
diff --git a/osu.Game/Migrations/20190708070844_AddBPMAndLengthColumns.Designer.cs b/osu.Game/Migrations/20190708070844_AddBPMAndLengthColumns.Designer.cs
deleted file mode 100644
index c5fcc16f84..0000000000
--- a/osu.Game/Migrations/20190708070844_AddBPMAndLengthColumns.Designer.cs
+++ /dev/null
@@ -1,504 +0,0 @@
-// <auto-generated />
-using System;
-using Microsoft.EntityFrameworkCore;
-using Microsoft.EntityFrameworkCore.Infrastructure;
-using Microsoft.EntityFrameworkCore.Migrations;
-using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
-using osu.Game.Database;
-
-namespace osu.Game.Migrations
-{
-    [DbContext(typeof(OsuDbContext))]
-    [Migration("20190708070844_AddBPMAndLengthColumns")]
-    partial class AddBPMAndLengthColumns
-    {
-        protected override void BuildTargetModel(ModelBuilder modelBuilder)
-        {
-#pragma warning disable 612, 618
-            modelBuilder
-                .HasAnnotation("ProductVersion", "2.2.4-servicing-10062");
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapDifficulty", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<float>("ApproachRate");
-
-                    b.Property<float>("CircleSize");
-
-                    b.Property<float>("DrainRate");
-
-                    b.Property<float>("OverallDifficulty");
-
-                    b.Property<double>("SliderMultiplier");
-
-                    b.Property<double>("SliderTickRate");
-
-                    b.HasKey("ID");
-
-                    b.ToTable("BeatmapDifficulty");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("AudioLeadIn");
-
-                    b.Property<double>("BPM");
-
-                    b.Property<int>("BaseDifficultyID");
-
-                    b.Property<int>("BeatDivisor");
-
-                    b.Property<int>("BeatmapSetInfoID");
-
-                    b.Property<bool>("Countdown");
-
-                    b.Property<double>("DistanceSpacing");
-
-                    b.Property<int>("GridSize");
-
-                    b.Property<string>("Hash");
-
-                    b.Property<bool>("Hidden");
-
-                    b.Property<double>("Length");
-
-                    b.Property<bool>("LetterboxInBreaks");
-
-                    b.Property<string>("MD5Hash");
-
-                    b.Property<int?>("MetadataID");
-
-                    b.Property<int?>("OnlineBeatmapID");
-
-                    b.Property<string>("Path");
-
-                    b.Property<int>("RulesetID");
-
-                    b.Property<bool>("SpecialStyle");
-
-                    b.Property<float>("StackLeniency");
-
-                    b.Property<double>("StarDifficulty");
-
-                    b.Property<int>("Status");
-
-                    b.Property<string>("StoredBookmarks");
-
-                    b.Property<double>("TimelineZoom");
-
-                    b.Property<string>("Version");
-
-                    b.Property<bool>("WidescreenStoryboard");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("BaseDifficultyID");
-
-                    b.HasIndex("BeatmapSetInfoID");
-
-                    b.HasIndex("Hash");
-
-                    b.HasIndex("MD5Hash");
-
-                    b.HasIndex("MetadataID");
-
-                    b.HasIndex("OnlineBeatmapID")
-                        .IsUnique();
-
-                    b.HasIndex("RulesetID");
-
-                    b.ToTable("BeatmapInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapMetadata", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Artist");
-
-                    b.Property<string>("ArtistUnicode");
-
-                    b.Property<string>("AudioFile");
-
-                    b.Property<string>("AuthorString")
-                        .HasColumnName("Author");
-
-                    b.Property<string>("BackgroundFile");
-
-                    b.Property<int>("PreviewTime");
-
-                    b.Property<string>("Source");
-
-                    b.Property<string>("Tags");
-
-                    b.Property<string>("Title");
-
-                    b.Property<string>("TitleUnicode");
-
-                    b.HasKey("ID");
-
-                    b.ToTable("BeatmapMetadata");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("BeatmapSetInfoID");
-
-                    b.Property<int>("FileInfoID");
-
-                    b.Property<string>("Filename")
-                        .IsRequired();
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("BeatmapSetInfoID");
-
-                    b.HasIndex("FileInfoID");
-
-                    b.ToTable("BeatmapSetFileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<DateTimeOffset>("DateAdded");
-
-                    b.Property<bool>("DeletePending");
-
-                    b.Property<string>("Hash");
-
-                    b.Property<int?>("MetadataID");
-
-                    b.Property<int?>("OnlineBeatmapSetID");
-
-                    b.Property<bool>("Protected");
-
-                    b.Property<int>("Status");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("DeletePending");
-
-                    b.HasIndex("Hash")
-                        .IsUnique();
-
-                    b.HasIndex("MetadataID");
-
-                    b.HasIndex("OnlineBeatmapSetID")
-                        .IsUnique();
-
-                    b.ToTable("BeatmapSetInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Configuration.DatabasedSetting", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Key")
-                        .HasColumnName("Key");
-
-                    b.Property<int?>("RulesetID");
-
-                    b.Property<int?>("SkinInfoID");
-
-                    b.Property<string>("StringValue")
-                        .HasColumnName("Value");
-
-                    b.Property<int?>("Variant");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("SkinInfoID");
-
-                    b.HasIndex("RulesetID", "Variant");
-
-                    b.ToTable("Settings");
-                });
-
-            modelBuilder.Entity("osu.Game.IO.FileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Hash");
-
-                    b.Property<int>("ReferenceCount");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("Hash")
-                        .IsUnique();
-
-                    b.HasIndex("ReferenceCount");
-
-                    b.ToTable("FileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Input.Bindings.DatabasedKeyBinding", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("IntAction")
-                        .HasColumnName("Action");
-
-                    b.Property<string>("KeysString")
-                        .HasColumnName("Keys");
-
-                    b.Property<int?>("RulesetID");
-
-                    b.Property<int?>("Variant");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("IntAction");
-
-                    b.HasIndex("RulesetID", "Variant");
-
-                    b.ToTable("KeyBinding");
-                });
-
-            modelBuilder.Entity("osu.Game.Rulesets.RulesetInfo", b =>
-                {
-                    b.Property<int?>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<bool>("Available");
-
-                    b.Property<string>("InstantiationInfo");
-
-                    b.Property<string>("Name");
-
-                    b.Property<string>("ShortName");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("Available");
-
-                    b.HasIndex("ShortName")
-                        .IsUnique();
-
-                    b.ToTable("RulesetInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Scoring.ScoreFileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("FileInfoID");
-
-                    b.Property<string>("Filename")
-                        .IsRequired();
-
-                    b.Property<int?>("ScoreInfoID");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("FileInfoID");
-
-                    b.HasIndex("ScoreInfoID");
-
-                    b.ToTable("ScoreFileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Scoring.ScoreInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<double>("Accuracy")
-                        .HasColumnType("DECIMAL(1,4)");
-
-                    b.Property<int>("BeatmapInfoID");
-
-                    b.Property<int>("Combo");
-
-                    b.Property<DateTimeOffset>("Date");
-
-                    b.Property<bool>("DeletePending");
-
-                    b.Property<string>("Hash");
-
-                    b.Property<int>("MaxCombo");
-
-                    b.Property<string>("ModsJson")
-                        .HasColumnName("Mods");
-
-                    b.Property<long?>("OnlineScoreID");
-
-                    b.Property<double?>("PP");
-
-                    b.Property<int>("Rank");
-
-                    b.Property<int>("RulesetID");
-
-                    b.Property<string>("StatisticsJson")
-                        .HasColumnName("Statistics");
-
-                    b.Property<long>("TotalScore");
-
-                    b.Property<long?>("UserID")
-                        .HasColumnName("UserID");
-
-                    b.Property<string>("UserString")
-                        .HasColumnName("User");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("BeatmapInfoID");
-
-                    b.HasIndex("OnlineScoreID")
-                        .IsUnique();
-
-                    b.HasIndex("RulesetID");
-
-                    b.ToTable("ScoreInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Skinning.SkinFileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("FileInfoID");
-
-                    b.Property<string>("Filename")
-                        .IsRequired();
-
-                    b.Property<int>("SkinInfoID");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("FileInfoID");
-
-                    b.HasIndex("SkinInfoID");
-
-                    b.ToTable("SkinFileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Skinning.SkinInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Creator");
-
-                    b.Property<bool>("DeletePending");
-
-                    b.Property<string>("Hash");
-
-                    b.Property<string>("Name");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("DeletePending");
-
-                    b.HasIndex("Hash")
-                        .IsUnique();
-
-                    b.ToTable("SkinInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapDifficulty", "BaseDifficulty")
-                        .WithMany()
-                        .HasForeignKey("BaseDifficultyID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo", "BeatmapSet")
-                        .WithMany("Beatmaps")
-                        .HasForeignKey("BeatmapSetInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
-                        .WithMany("Beatmaps")
-                        .HasForeignKey("MetadataID");
-
-                    b.HasOne("osu.Game.Rulesets.RulesetInfo", "Ruleset")
-                        .WithMany()
-                        .HasForeignKey("RulesetID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo")
-                        .WithMany("Files")
-                        .HasForeignKey("BeatmapSetInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
-                        .WithMany()
-                        .HasForeignKey("FileInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
-                        .WithMany("BeatmapSets")
-                        .HasForeignKey("MetadataID");
-                });
-
-            modelBuilder.Entity("osu.Game.Configuration.DatabasedSetting", b =>
-                {
-                    b.HasOne("osu.Game.Skinning.SkinInfo")
-                        .WithMany("Settings")
-                        .HasForeignKey("SkinInfoID");
-                });
-
-            modelBuilder.Entity("osu.Game.Scoring.ScoreFileInfo", b =>
-                {
-                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
-                        .WithMany()
-                        .HasForeignKey("FileInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Scoring.ScoreInfo")
-                        .WithMany("Files")
-                        .HasForeignKey("ScoreInfoID");
-                });
-
-            modelBuilder.Entity("osu.Game.Scoring.ScoreInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapInfo", "Beatmap")
-                        .WithMany("Scores")
-                        .HasForeignKey("BeatmapInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Rulesets.RulesetInfo", "Ruleset")
-                        .WithMany()
-                        .HasForeignKey("RulesetID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-
-            modelBuilder.Entity("osu.Game.Skinning.SkinFileInfo", b =>
-                {
-                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
-                        .WithMany()
-                        .HasForeignKey("FileInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Skinning.SkinInfo")
-                        .WithMany("Files")
-                        .HasForeignKey("SkinInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-#pragma warning restore 612, 618
-        }
-    }
-}
diff --git a/osu.Game/Migrations/20190708070844_AddBPMAndLengthColumns.cs b/osu.Game/Migrations/20190708070844_AddBPMAndLengthColumns.cs
deleted file mode 100644
index f5963ebf5e..0000000000
--- a/osu.Game/Migrations/20190708070844_AddBPMAndLengthColumns.cs
+++ /dev/null
@@ -1,33 +0,0 @@
-using Microsoft.EntityFrameworkCore.Migrations;
-
-namespace osu.Game.Migrations
-{
-    public partial class AddBPMAndLengthColumns : Migration
-    {
-        protected override void Up(MigrationBuilder migrationBuilder)
-        {
-            migrationBuilder.AddColumn<double>(
-                name: "BPM",
-                table: "BeatmapInfo",
-                nullable: false,
-                defaultValue: 0.0);
-
-            migrationBuilder.AddColumn<double>(
-                name: "Length",
-                table: "BeatmapInfo",
-                nullable: false,
-                defaultValue: 0.0);
-        }
-
-        protected override void Down(MigrationBuilder migrationBuilder)
-        {
-            migrationBuilder.DropColumn(
-                name: "BPM",
-                table: "BeatmapInfo");
-
-            migrationBuilder.DropColumn(
-                name: "Length",
-                table: "BeatmapInfo");
-        }
-    }
-}
diff --git a/osu.Game/Migrations/20190913104727_AddBeatmapVideo.Designer.cs b/osu.Game/Migrations/20190913104727_AddBeatmapVideo.Designer.cs
deleted file mode 100644
index 826233a2b0..0000000000
--- a/osu.Game/Migrations/20190913104727_AddBeatmapVideo.Designer.cs
+++ /dev/null
@@ -1,506 +0,0 @@
-// <auto-generated />
-using System;
-using Microsoft.EntityFrameworkCore;
-using Microsoft.EntityFrameworkCore.Infrastructure;
-using Microsoft.EntityFrameworkCore.Migrations;
-using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
-using osu.Game.Database;
-
-namespace osu.Game.Migrations
-{
-    [DbContext(typeof(OsuDbContext))]
-    [Migration("20190913104727_AddBeatmapVideo")]
-    partial class AddBeatmapVideo
-    {
-        protected override void BuildTargetModel(ModelBuilder modelBuilder)
-        {
-#pragma warning disable 612, 618
-            modelBuilder
-                .HasAnnotation("ProductVersion", "2.2.6-servicing-10079");
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapDifficulty", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<float>("ApproachRate");
-
-                    b.Property<float>("CircleSize");
-
-                    b.Property<float>("DrainRate");
-
-                    b.Property<float>("OverallDifficulty");
-
-                    b.Property<double>("SliderMultiplier");
-
-                    b.Property<double>("SliderTickRate");
-
-                    b.HasKey("ID");
-
-                    b.ToTable("BeatmapDifficulty");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("AudioLeadIn");
-
-                    b.Property<double>("BPM");
-
-                    b.Property<int>("BaseDifficultyID");
-
-                    b.Property<int>("BeatDivisor");
-
-                    b.Property<int>("BeatmapSetInfoID");
-
-                    b.Property<bool>("Countdown");
-
-                    b.Property<double>("DistanceSpacing");
-
-                    b.Property<int>("GridSize");
-
-                    b.Property<string>("Hash");
-
-                    b.Property<bool>("Hidden");
-
-                    b.Property<double>("Length");
-
-                    b.Property<bool>("LetterboxInBreaks");
-
-                    b.Property<string>("MD5Hash");
-
-                    b.Property<int?>("MetadataID");
-
-                    b.Property<int?>("OnlineBeatmapID");
-
-                    b.Property<string>("Path");
-
-                    b.Property<int>("RulesetID");
-
-                    b.Property<bool>("SpecialStyle");
-
-                    b.Property<float>("StackLeniency");
-
-                    b.Property<double>("StarDifficulty");
-
-                    b.Property<int>("Status");
-
-                    b.Property<string>("StoredBookmarks");
-
-                    b.Property<double>("TimelineZoom");
-
-                    b.Property<string>("Version");
-
-                    b.Property<bool>("WidescreenStoryboard");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("BaseDifficultyID");
-
-                    b.HasIndex("BeatmapSetInfoID");
-
-                    b.HasIndex("Hash");
-
-                    b.HasIndex("MD5Hash");
-
-                    b.HasIndex("MetadataID");
-
-                    b.HasIndex("OnlineBeatmapID")
-                        .IsUnique();
-
-                    b.HasIndex("RulesetID");
-
-                    b.ToTable("BeatmapInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapMetadata", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Artist");
-
-                    b.Property<string>("ArtistUnicode");
-
-                    b.Property<string>("AudioFile");
-
-                    b.Property<string>("AuthorString")
-                        .HasColumnName("Author");
-
-                    b.Property<string>("BackgroundFile");
-
-                    b.Property<int>("PreviewTime");
-
-                    b.Property<string>("Source");
-
-                    b.Property<string>("Tags");
-
-                    b.Property<string>("Title");
-
-                    b.Property<string>("TitleUnicode");
-
-                    b.Property<string>("VideoFile");
-
-                    b.HasKey("ID");
-
-                    b.ToTable("BeatmapMetadata");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("BeatmapSetInfoID");
-
-                    b.Property<int>("FileInfoID");
-
-                    b.Property<string>("Filename")
-                        .IsRequired();
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("BeatmapSetInfoID");
-
-                    b.HasIndex("FileInfoID");
-
-                    b.ToTable("BeatmapSetFileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<DateTimeOffset>("DateAdded");
-
-                    b.Property<bool>("DeletePending");
-
-                    b.Property<string>("Hash");
-
-                    b.Property<int?>("MetadataID");
-
-                    b.Property<int?>("OnlineBeatmapSetID");
-
-                    b.Property<bool>("Protected");
-
-                    b.Property<int>("Status");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("DeletePending");
-
-                    b.HasIndex("Hash")
-                        .IsUnique();
-
-                    b.HasIndex("MetadataID");
-
-                    b.HasIndex("OnlineBeatmapSetID")
-                        .IsUnique();
-
-                    b.ToTable("BeatmapSetInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Configuration.DatabasedSetting", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Key")
-                        .HasColumnName("Key");
-
-                    b.Property<int?>("RulesetID");
-
-                    b.Property<int?>("SkinInfoID");
-
-                    b.Property<string>("StringValue")
-                        .HasColumnName("Value");
-
-                    b.Property<int?>("Variant");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("SkinInfoID");
-
-                    b.HasIndex("RulesetID", "Variant");
-
-                    b.ToTable("Settings");
-                });
-
-            modelBuilder.Entity("osu.Game.IO.FileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Hash");
-
-                    b.Property<int>("ReferenceCount");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("Hash")
-                        .IsUnique();
-
-                    b.HasIndex("ReferenceCount");
-
-                    b.ToTable("FileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Input.Bindings.DatabasedKeyBinding", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("IntAction")
-                        .HasColumnName("Action");
-
-                    b.Property<string>("KeysString")
-                        .HasColumnName("Keys");
-
-                    b.Property<int?>("RulesetID");
-
-                    b.Property<int?>("Variant");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("IntAction");
-
-                    b.HasIndex("RulesetID", "Variant");
-
-                    b.ToTable("KeyBinding");
-                });
-
-            modelBuilder.Entity("osu.Game.Rulesets.RulesetInfo", b =>
-                {
-                    b.Property<int?>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<bool>("Available");
-
-                    b.Property<string>("InstantiationInfo");
-
-                    b.Property<string>("Name");
-
-                    b.Property<string>("ShortName");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("Available");
-
-                    b.HasIndex("ShortName")
-                        .IsUnique();
-
-                    b.ToTable("RulesetInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Scoring.ScoreFileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("FileInfoID");
-
-                    b.Property<string>("Filename")
-                        .IsRequired();
-
-                    b.Property<int?>("ScoreInfoID");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("FileInfoID");
-
-                    b.HasIndex("ScoreInfoID");
-
-                    b.ToTable("ScoreFileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Scoring.ScoreInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<double>("Accuracy")
-                        .HasColumnType("DECIMAL(1,4)");
-
-                    b.Property<int>("BeatmapInfoID");
-
-                    b.Property<int>("Combo");
-
-                    b.Property<DateTimeOffset>("Date");
-
-                    b.Property<bool>("DeletePending");
-
-                    b.Property<string>("Hash");
-
-                    b.Property<int>("MaxCombo");
-
-                    b.Property<string>("ModsJson")
-                        .HasColumnName("Mods");
-
-                    b.Property<long?>("OnlineScoreID");
-
-                    b.Property<double?>("PP");
-
-                    b.Property<int>("Rank");
-
-                    b.Property<int>("RulesetID");
-
-                    b.Property<string>("StatisticsJson")
-                        .HasColumnName("Statistics");
-
-                    b.Property<long>("TotalScore");
-
-                    b.Property<long?>("UserID")
-                        .HasColumnName("UserID");
-
-                    b.Property<string>("UserString")
-                        .HasColumnName("User");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("BeatmapInfoID");
-
-                    b.HasIndex("OnlineScoreID")
-                        .IsUnique();
-
-                    b.HasIndex("RulesetID");
-
-                    b.ToTable("ScoreInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Skinning.SkinFileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("FileInfoID");
-
-                    b.Property<string>("Filename")
-                        .IsRequired();
-
-                    b.Property<int>("SkinInfoID");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("FileInfoID");
-
-                    b.HasIndex("SkinInfoID");
-
-                    b.ToTable("SkinFileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Skinning.SkinInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Creator");
-
-                    b.Property<bool>("DeletePending");
-
-                    b.Property<string>("Hash");
-
-                    b.Property<string>("Name");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("DeletePending");
-
-                    b.HasIndex("Hash")
-                        .IsUnique();
-
-                    b.ToTable("SkinInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapDifficulty", "BaseDifficulty")
-                        .WithMany()
-                        .HasForeignKey("BaseDifficultyID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo", "BeatmapSet")
-                        .WithMany("Beatmaps")
-                        .HasForeignKey("BeatmapSetInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
-                        .WithMany("Beatmaps")
-                        .HasForeignKey("MetadataID");
-
-                    b.HasOne("osu.Game.Rulesets.RulesetInfo", "Ruleset")
-                        .WithMany()
-                        .HasForeignKey("RulesetID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo")
-                        .WithMany("Files")
-                        .HasForeignKey("BeatmapSetInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
-                        .WithMany()
-                        .HasForeignKey("FileInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
-                        .WithMany("BeatmapSets")
-                        .HasForeignKey("MetadataID");
-                });
-
-            modelBuilder.Entity("osu.Game.Configuration.DatabasedSetting", b =>
-                {
-                    b.HasOne("osu.Game.Skinning.SkinInfo")
-                        .WithMany("Settings")
-                        .HasForeignKey("SkinInfoID");
-                });
-
-            modelBuilder.Entity("osu.Game.Scoring.ScoreFileInfo", b =>
-                {
-                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
-                        .WithMany()
-                        .HasForeignKey("FileInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Scoring.ScoreInfo")
-                        .WithMany("Files")
-                        .HasForeignKey("ScoreInfoID");
-                });
-
-            modelBuilder.Entity("osu.Game.Scoring.ScoreInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapInfo", "Beatmap")
-                        .WithMany("Scores")
-                        .HasForeignKey("BeatmapInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Rulesets.RulesetInfo", "Ruleset")
-                        .WithMany()
-                        .HasForeignKey("RulesetID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-
-            modelBuilder.Entity("osu.Game.Skinning.SkinFileInfo", b =>
-                {
-                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
-                        .WithMany()
-                        .HasForeignKey("FileInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Skinning.SkinInfo")
-                        .WithMany("Files")
-                        .HasForeignKey("SkinInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-#pragma warning restore 612, 618
-        }
-    }
-}
diff --git a/osu.Game/Migrations/20190913104727_AddBeatmapVideo.cs b/osu.Game/Migrations/20190913104727_AddBeatmapVideo.cs
deleted file mode 100644
index 9ed0943acd..0000000000
--- a/osu.Game/Migrations/20190913104727_AddBeatmapVideo.cs
+++ /dev/null
@@ -1,22 +0,0 @@
-using Microsoft.EntityFrameworkCore.Migrations;
-
-namespace osu.Game.Migrations
-{
-    public partial class AddBeatmapVideo : Migration
-    {
-        protected override void Up(MigrationBuilder migrationBuilder)
-        {
-            migrationBuilder.AddColumn<string>(
-                name: "VideoFile",
-                table: "BeatmapMetadata",
-                nullable: true);
-        }
-
-        protected override void Down(MigrationBuilder migrationBuilder)
-        {
-            migrationBuilder.DropColumn(
-                name: "VideoFile",
-                table: "BeatmapMetadata");
-        }
-    }
-}
diff --git a/osu.Game/Migrations/20200302094919_RefreshVolumeBindings.Designer.cs b/osu.Game/Migrations/20200302094919_RefreshVolumeBindings.Designer.cs
deleted file mode 100644
index 22316b0380..0000000000
--- a/osu.Game/Migrations/20200302094919_RefreshVolumeBindings.Designer.cs
+++ /dev/null
@@ -1,506 +0,0 @@
-// <auto-generated />
-using System;
-using Microsoft.EntityFrameworkCore;
-using Microsoft.EntityFrameworkCore.Infrastructure;
-using Microsoft.EntityFrameworkCore.Migrations;
-using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
-using osu.Game.Database;
-
-namespace osu.Game.Migrations
-{
-    [DbContext(typeof(OsuDbContext))]
-    [Migration("20200302094919_RefreshVolumeBindings")]
-    partial class RefreshVolumeBindings
-    {
-        protected override void BuildTargetModel(ModelBuilder modelBuilder)
-        {
-#pragma warning disable 612, 618
-            modelBuilder
-                .HasAnnotation("ProductVersion", "2.2.6-servicing-10079");
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapDifficulty", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<float>("ApproachRate");
-
-                    b.Property<float>("CircleSize");
-
-                    b.Property<float>("DrainRate");
-
-                    b.Property<float>("OverallDifficulty");
-
-                    b.Property<double>("SliderMultiplier");
-
-                    b.Property<double>("SliderTickRate");
-
-                    b.HasKey("ID");
-
-                    b.ToTable("BeatmapDifficulty");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<double>("AudioLeadIn");
-
-                    b.Property<double>("BPM");
-
-                    b.Property<int>("BaseDifficultyID");
-
-                    b.Property<int>("BeatDivisor");
-
-                    b.Property<int>("BeatmapSetInfoID");
-
-                    b.Property<bool>("Countdown");
-
-                    b.Property<double>("DistanceSpacing");
-
-                    b.Property<int>("GridSize");
-
-                    b.Property<string>("Hash");
-
-                    b.Property<bool>("Hidden");
-
-                    b.Property<double>("Length");
-
-                    b.Property<bool>("LetterboxInBreaks");
-
-                    b.Property<string>("MD5Hash");
-
-                    b.Property<int?>("MetadataID");
-
-                    b.Property<int?>("OnlineBeatmapID");
-
-                    b.Property<string>("Path");
-
-                    b.Property<int>("RulesetID");
-
-                    b.Property<bool>("SpecialStyle");
-
-                    b.Property<float>("StackLeniency");
-
-                    b.Property<double>("StarDifficulty");
-
-                    b.Property<int>("Status");
-
-                    b.Property<string>("StoredBookmarks");
-
-                    b.Property<double>("TimelineZoom");
-
-                    b.Property<string>("Version");
-
-                    b.Property<bool>("WidescreenStoryboard");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("BaseDifficultyID");
-
-                    b.HasIndex("BeatmapSetInfoID");
-
-                    b.HasIndex("Hash");
-
-                    b.HasIndex("MD5Hash");
-
-                    b.HasIndex("MetadataID");
-
-                    b.HasIndex("OnlineBeatmapID")
-                        .IsUnique();
-
-                    b.HasIndex("RulesetID");
-
-                    b.ToTable("BeatmapInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapMetadata", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Artist");
-
-                    b.Property<string>("ArtistUnicode");
-
-                    b.Property<string>("AudioFile");
-
-                    b.Property<string>("AuthorString")
-                        .HasColumnName("Author");
-
-                    b.Property<string>("BackgroundFile");
-
-                    b.Property<int>("PreviewTime");
-
-                    b.Property<string>("Source");
-
-                    b.Property<string>("Tags");
-
-                    b.Property<string>("Title");
-
-                    b.Property<string>("TitleUnicode");
-
-                    b.Property<string>("VideoFile");
-
-                    b.HasKey("ID");
-
-                    b.ToTable("BeatmapMetadata");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("BeatmapSetInfoID");
-
-                    b.Property<int>("FileInfoID");
-
-                    b.Property<string>("Filename")
-                        .IsRequired();
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("BeatmapSetInfoID");
-
-                    b.HasIndex("FileInfoID");
-
-                    b.ToTable("BeatmapSetFileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<DateTimeOffset>("DateAdded");
-
-                    b.Property<bool>("DeletePending");
-
-                    b.Property<string>("Hash");
-
-                    b.Property<int?>("MetadataID");
-
-                    b.Property<int?>("OnlineBeatmapSetID");
-
-                    b.Property<bool>("Protected");
-
-                    b.Property<int>("Status");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("DeletePending");
-
-                    b.HasIndex("Hash")
-                        .IsUnique();
-
-                    b.HasIndex("MetadataID");
-
-                    b.HasIndex("OnlineBeatmapSetID")
-                        .IsUnique();
-
-                    b.ToTable("BeatmapSetInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Configuration.DatabasedSetting", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Key")
-                        .HasColumnName("Key");
-
-                    b.Property<int?>("RulesetID");
-
-                    b.Property<int?>("SkinInfoID");
-
-                    b.Property<string>("StringValue")
-                        .HasColumnName("Value");
-
-                    b.Property<int?>("Variant");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("SkinInfoID");
-
-                    b.HasIndex("RulesetID", "Variant");
-
-                    b.ToTable("Settings");
-                });
-
-            modelBuilder.Entity("osu.Game.IO.FileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Hash");
-
-                    b.Property<int>("ReferenceCount");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("Hash")
-                        .IsUnique();
-
-                    b.HasIndex("ReferenceCount");
-
-                    b.ToTable("FileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Input.Bindings.DatabasedKeyBinding", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("IntAction")
-                        .HasColumnName("Action");
-
-                    b.Property<string>("KeysString")
-                        .HasColumnName("Keys");
-
-                    b.Property<int?>("RulesetID");
-
-                    b.Property<int?>("Variant");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("IntAction");
-
-                    b.HasIndex("RulesetID", "Variant");
-
-                    b.ToTable("KeyBinding");
-                });
-
-            modelBuilder.Entity("osu.Game.Rulesets.RulesetInfo", b =>
-                {
-                    b.Property<int?>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<bool>("Available");
-
-                    b.Property<string>("InstantiationInfo");
-
-                    b.Property<string>("Name");
-
-                    b.Property<string>("ShortName");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("Available");
-
-                    b.HasIndex("ShortName")
-                        .IsUnique();
-
-                    b.ToTable("RulesetInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Scoring.ScoreFileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("FileInfoID");
-
-                    b.Property<string>("Filename")
-                        .IsRequired();
-
-                    b.Property<int?>("ScoreInfoID");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("FileInfoID");
-
-                    b.HasIndex("ScoreInfoID");
-
-                    b.ToTable("ScoreFileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Scoring.ScoreInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<double>("Accuracy")
-                        .HasColumnType("DECIMAL(1,4)");
-
-                    b.Property<int>("BeatmapInfoID");
-
-                    b.Property<int>("Combo");
-
-                    b.Property<DateTimeOffset>("Date");
-
-                    b.Property<bool>("DeletePending");
-
-                    b.Property<string>("Hash");
-
-                    b.Property<int>("MaxCombo");
-
-                    b.Property<string>("ModsJson")
-                        .HasColumnName("Mods");
-
-                    b.Property<long?>("OnlineScoreID");
-
-                    b.Property<double?>("PP");
-
-                    b.Property<int>("Rank");
-
-                    b.Property<int>("RulesetID");
-
-                    b.Property<string>("StatisticsJson")
-                        .HasColumnName("Statistics");
-
-                    b.Property<long>("TotalScore");
-
-                    b.Property<long?>("UserID")
-                        .HasColumnName("UserID");
-
-                    b.Property<string>("UserString")
-                        .HasColumnName("User");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("BeatmapInfoID");
-
-                    b.HasIndex("OnlineScoreID")
-                        .IsUnique();
-
-                    b.HasIndex("RulesetID");
-
-                    b.ToTable("ScoreInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Skinning.SkinFileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("FileInfoID");
-
-                    b.Property<string>("Filename")
-                        .IsRequired();
-
-                    b.Property<int>("SkinInfoID");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("FileInfoID");
-
-                    b.HasIndex("SkinInfoID");
-
-                    b.ToTable("SkinFileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Skinning.SkinInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Creator");
-
-                    b.Property<bool>("DeletePending");
-
-                    b.Property<string>("Hash");
-
-                    b.Property<string>("Name");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("DeletePending");
-
-                    b.HasIndex("Hash")
-                        .IsUnique();
-
-                    b.ToTable("SkinInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapDifficulty", "BaseDifficulty")
-                        .WithMany()
-                        .HasForeignKey("BaseDifficultyID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo", "BeatmapSet")
-                        .WithMany("Beatmaps")
-                        .HasForeignKey("BeatmapSetInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
-                        .WithMany("Beatmaps")
-                        .HasForeignKey("MetadataID");
-
-                    b.HasOne("osu.Game.Rulesets.RulesetInfo", "Ruleset")
-                        .WithMany()
-                        .HasForeignKey("RulesetID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo")
-                        .WithMany("Files")
-                        .HasForeignKey("BeatmapSetInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
-                        .WithMany()
-                        .HasForeignKey("FileInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
-                        .WithMany("BeatmapSets")
-                        .HasForeignKey("MetadataID");
-                });
-
-            modelBuilder.Entity("osu.Game.Configuration.DatabasedSetting", b =>
-                {
-                    b.HasOne("osu.Game.Skinning.SkinInfo")
-                        .WithMany("Settings")
-                        .HasForeignKey("SkinInfoID");
-                });
-
-            modelBuilder.Entity("osu.Game.Scoring.ScoreFileInfo", b =>
-                {
-                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
-                        .WithMany()
-                        .HasForeignKey("FileInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Scoring.ScoreInfo")
-                        .WithMany("Files")
-                        .HasForeignKey("ScoreInfoID");
-                });
-
-            modelBuilder.Entity("osu.Game.Scoring.ScoreInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapInfo", "Beatmap")
-                        .WithMany("Scores")
-                        .HasForeignKey("BeatmapInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Rulesets.RulesetInfo", "Ruleset")
-                        .WithMany()
-                        .HasForeignKey("RulesetID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-
-            modelBuilder.Entity("osu.Game.Skinning.SkinFileInfo", b =>
-                {
-                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
-                        .WithMany()
-                        .HasForeignKey("FileInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Skinning.SkinInfo")
-                        .WithMany("Files")
-                        .HasForeignKey("SkinInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-#pragma warning restore 612, 618
-        }
-    }
-}
diff --git a/osu.Game/Migrations/20200302094919_RefreshVolumeBindings.cs b/osu.Game/Migrations/20200302094919_RefreshVolumeBindings.cs
deleted file mode 100644
index ec4475971c..0000000000
--- a/osu.Game/Migrations/20200302094919_RefreshVolumeBindings.cs
+++ /dev/null
@@ -1,16 +0,0 @@
-using Microsoft.EntityFrameworkCore.Migrations;
-
-namespace osu.Game.Migrations
-{
-    public partial class RefreshVolumeBindings : Migration
-    {
-        protected override void Up(MigrationBuilder migrationBuilder)
-        {
-            migrationBuilder.Sql("DELETE FROM KeyBinding WHERE action in (6,7)");
-        }
-
-        protected override void Down(MigrationBuilder migrationBuilder)
-        {
-        }
-    }
-}
diff --git a/osu.Game/Migrations/20201019224408_AddEpilepsyWarning.Designer.cs b/osu.Game/Migrations/20201019224408_AddEpilepsyWarning.Designer.cs
deleted file mode 100644
index 1c05de832e..0000000000
--- a/osu.Game/Migrations/20201019224408_AddEpilepsyWarning.Designer.cs
+++ /dev/null
@@ -1,508 +0,0 @@
-// <auto-generated />
-using System;
-using Microsoft.EntityFrameworkCore;
-using Microsoft.EntityFrameworkCore.Infrastructure;
-using Microsoft.EntityFrameworkCore.Migrations;
-using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
-using osu.Game.Database;
-
-namespace osu.Game.Migrations
-{
-    [DbContext(typeof(OsuDbContext))]
-    [Migration("20201019224408_AddEpilepsyWarning")]
-    partial class AddEpilepsyWarning
-    {
-        protected override void BuildTargetModel(ModelBuilder modelBuilder)
-        {
-#pragma warning disable 612, 618
-            modelBuilder
-                .HasAnnotation("ProductVersion", "2.2.6-servicing-10079");
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapDifficulty", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<float>("ApproachRate");
-
-                    b.Property<float>("CircleSize");
-
-                    b.Property<float>("DrainRate");
-
-                    b.Property<float>("OverallDifficulty");
-
-                    b.Property<double>("SliderMultiplier");
-
-                    b.Property<double>("SliderTickRate");
-
-                    b.HasKey("ID");
-
-                    b.ToTable("BeatmapDifficulty");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<double>("AudioLeadIn");
-
-                    b.Property<double>("BPM");
-
-                    b.Property<int>("BaseDifficultyID");
-
-                    b.Property<int>("BeatDivisor");
-
-                    b.Property<int>("BeatmapSetInfoID");
-
-                    b.Property<bool>("Countdown");
-
-                    b.Property<double>("DistanceSpacing");
-
-                    b.Property<bool>("EpilepsyWarning");
-
-                    b.Property<int>("GridSize");
-
-                    b.Property<string>("Hash");
-
-                    b.Property<bool>("Hidden");
-
-                    b.Property<double>("Length");
-
-                    b.Property<bool>("LetterboxInBreaks");
-
-                    b.Property<string>("MD5Hash");
-
-                    b.Property<int?>("MetadataID");
-
-                    b.Property<int?>("OnlineBeatmapID");
-
-                    b.Property<string>("Path");
-
-                    b.Property<int>("RulesetID");
-
-                    b.Property<bool>("SpecialStyle");
-
-                    b.Property<float>("StackLeniency");
-
-                    b.Property<double>("StarDifficulty");
-
-                    b.Property<int>("Status");
-
-                    b.Property<string>("StoredBookmarks");
-
-                    b.Property<double>("TimelineZoom");
-
-                    b.Property<string>("Version");
-
-                    b.Property<bool>("WidescreenStoryboard");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("BaseDifficultyID");
-
-                    b.HasIndex("BeatmapSetInfoID");
-
-                    b.HasIndex("Hash");
-
-                    b.HasIndex("MD5Hash");
-
-                    b.HasIndex("MetadataID");
-
-                    b.HasIndex("OnlineBeatmapID")
-                        .IsUnique();
-
-                    b.HasIndex("RulesetID");
-
-                    b.ToTable("BeatmapInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapMetadata", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Artist");
-
-                    b.Property<string>("ArtistUnicode");
-
-                    b.Property<string>("AudioFile");
-
-                    b.Property<string>("AuthorString")
-                        .HasColumnName("Author");
-
-                    b.Property<string>("BackgroundFile");
-
-                    b.Property<int>("PreviewTime");
-
-                    b.Property<string>("Source");
-
-                    b.Property<string>("Tags");
-
-                    b.Property<string>("Title");
-
-                    b.Property<string>("TitleUnicode");
-
-                    b.Property<string>("VideoFile");
-
-                    b.HasKey("ID");
-
-                    b.ToTable("BeatmapMetadata");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("BeatmapSetInfoID");
-
-                    b.Property<int>("FileInfoID");
-
-                    b.Property<string>("Filename")
-                        .IsRequired();
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("BeatmapSetInfoID");
-
-                    b.HasIndex("FileInfoID");
-
-                    b.ToTable("BeatmapSetFileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<DateTimeOffset>("DateAdded");
-
-                    b.Property<bool>("DeletePending");
-
-                    b.Property<string>("Hash");
-
-                    b.Property<int?>("MetadataID");
-
-                    b.Property<int?>("OnlineBeatmapSetID");
-
-                    b.Property<bool>("Protected");
-
-                    b.Property<int>("Status");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("DeletePending");
-
-                    b.HasIndex("Hash")
-                        .IsUnique();
-
-                    b.HasIndex("MetadataID");
-
-                    b.HasIndex("OnlineBeatmapSetID")
-                        .IsUnique();
-
-                    b.ToTable("BeatmapSetInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Configuration.DatabasedSetting", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Key")
-                        .HasColumnName("Key");
-
-                    b.Property<int?>("RulesetID");
-
-                    b.Property<int?>("SkinInfoID");
-
-                    b.Property<string>("StringValue")
-                        .HasColumnName("Value");
-
-                    b.Property<int?>("Variant");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("SkinInfoID");
-
-                    b.HasIndex("RulesetID", "Variant");
-
-                    b.ToTable("Settings");
-                });
-
-            modelBuilder.Entity("osu.Game.IO.FileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Hash");
-
-                    b.Property<int>("ReferenceCount");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("Hash")
-                        .IsUnique();
-
-                    b.HasIndex("ReferenceCount");
-
-                    b.ToTable("FileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Input.Bindings.DatabasedKeyBinding", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("IntAction")
-                        .HasColumnName("Action");
-
-                    b.Property<string>("KeysString")
-                        .HasColumnName("Keys");
-
-                    b.Property<int?>("RulesetID");
-
-                    b.Property<int?>("Variant");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("IntAction");
-
-                    b.HasIndex("RulesetID", "Variant");
-
-                    b.ToTable("KeyBinding");
-                });
-
-            modelBuilder.Entity("osu.Game.Rulesets.RulesetInfo", b =>
-                {
-                    b.Property<int?>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<bool>("Available");
-
-                    b.Property<string>("InstantiationInfo");
-
-                    b.Property<string>("Name");
-
-                    b.Property<string>("ShortName");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("Available");
-
-                    b.HasIndex("ShortName")
-                        .IsUnique();
-
-                    b.ToTable("RulesetInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Scoring.ScoreFileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("FileInfoID");
-
-                    b.Property<string>("Filename")
-                        .IsRequired();
-
-                    b.Property<int?>("ScoreInfoID");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("FileInfoID");
-
-                    b.HasIndex("ScoreInfoID");
-
-                    b.ToTable("ScoreFileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Scoring.ScoreInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<double>("Accuracy")
-                        .HasColumnType("DECIMAL(1,4)");
-
-                    b.Property<int>("BeatmapInfoID");
-
-                    b.Property<int>("Combo");
-
-                    b.Property<DateTimeOffset>("Date");
-
-                    b.Property<bool>("DeletePending");
-
-                    b.Property<string>("Hash");
-
-                    b.Property<int>("MaxCombo");
-
-                    b.Property<string>("ModsJson")
-                        .HasColumnName("Mods");
-
-                    b.Property<long?>("OnlineScoreID");
-
-                    b.Property<double?>("PP");
-
-                    b.Property<int>("Rank");
-
-                    b.Property<int>("RulesetID");
-
-                    b.Property<string>("StatisticsJson")
-                        .HasColumnName("Statistics");
-
-                    b.Property<long>("TotalScore");
-
-                    b.Property<long?>("UserID")
-                        .HasColumnName("UserID");
-
-                    b.Property<string>("UserString")
-                        .HasColumnName("User");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("BeatmapInfoID");
-
-                    b.HasIndex("OnlineScoreID")
-                        .IsUnique();
-
-                    b.HasIndex("RulesetID");
-
-                    b.ToTable("ScoreInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Skinning.SkinFileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("FileInfoID");
-
-                    b.Property<string>("Filename")
-                        .IsRequired();
-
-                    b.Property<int>("SkinInfoID");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("FileInfoID");
-
-                    b.HasIndex("SkinInfoID");
-
-                    b.ToTable("SkinFileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Skinning.SkinInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Creator");
-
-                    b.Property<bool>("DeletePending");
-
-                    b.Property<string>("Hash");
-
-                    b.Property<string>("Name");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("DeletePending");
-
-                    b.HasIndex("Hash")
-                        .IsUnique();
-
-                    b.ToTable("SkinInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapDifficulty", "BaseDifficulty")
-                        .WithMany()
-                        .HasForeignKey("BaseDifficultyID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo", "BeatmapSet")
-                        .WithMany("Beatmaps")
-                        .HasForeignKey("BeatmapSetInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
-                        .WithMany("Beatmaps")
-                        .HasForeignKey("MetadataID");
-
-                    b.HasOne("osu.Game.Rulesets.RulesetInfo", "Ruleset")
-                        .WithMany()
-                        .HasForeignKey("RulesetID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo")
-                        .WithMany("Files")
-                        .HasForeignKey("BeatmapSetInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
-                        .WithMany()
-                        .HasForeignKey("FileInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
-                        .WithMany("BeatmapSets")
-                        .HasForeignKey("MetadataID");
-                });
-
-            modelBuilder.Entity("osu.Game.Configuration.DatabasedSetting", b =>
-                {
-                    b.HasOne("osu.Game.Skinning.SkinInfo")
-                        .WithMany("Settings")
-                        .HasForeignKey("SkinInfoID");
-                });
-
-            modelBuilder.Entity("osu.Game.Scoring.ScoreFileInfo", b =>
-                {
-                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
-                        .WithMany()
-                        .HasForeignKey("FileInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Scoring.ScoreInfo")
-                        .WithMany("Files")
-                        .HasForeignKey("ScoreInfoID");
-                });
-
-            modelBuilder.Entity("osu.Game.Scoring.ScoreInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapInfo", "Beatmap")
-                        .WithMany("Scores")
-                        .HasForeignKey("BeatmapInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Rulesets.RulesetInfo", "Ruleset")
-                        .WithMany()
-                        .HasForeignKey("RulesetID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-
-            modelBuilder.Entity("osu.Game.Skinning.SkinFileInfo", b =>
-                {
-                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
-                        .WithMany()
-                        .HasForeignKey("FileInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Skinning.SkinInfo")
-                        .WithMany("Files")
-                        .HasForeignKey("SkinInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-#pragma warning restore 612, 618
-        }
-    }
-}
diff --git a/osu.Game/Migrations/20201019224408_AddEpilepsyWarning.cs b/osu.Game/Migrations/20201019224408_AddEpilepsyWarning.cs
deleted file mode 100644
index be6968aa5d..0000000000
--- a/osu.Game/Migrations/20201019224408_AddEpilepsyWarning.cs
+++ /dev/null
@@ -1,23 +0,0 @@
-using Microsoft.EntityFrameworkCore.Migrations;
-
-namespace osu.Game.Migrations
-{
-    public partial class AddEpilepsyWarning : Migration
-    {
-        protected override void Up(MigrationBuilder migrationBuilder)
-        {
-            migrationBuilder.AddColumn<bool>(
-                name: "EpilepsyWarning",
-                table: "BeatmapInfo",
-                nullable: false,
-                defaultValue: false);
-        }
-
-        protected override void Down(MigrationBuilder migrationBuilder)
-        {
-            migrationBuilder.DropColumn(
-                name: "EpilepsyWarning",
-                table: "BeatmapInfo");
-        }
-    }
-}
diff --git a/osu.Game/Migrations/20210412045700_RefreshVolumeBindingsAgain.Designer.cs b/osu.Game/Migrations/20210412045700_RefreshVolumeBindingsAgain.Designer.cs
deleted file mode 100644
index 2c100d39b9..0000000000
--- a/osu.Game/Migrations/20210412045700_RefreshVolumeBindingsAgain.Designer.cs
+++ /dev/null
@@ -1,506 +0,0 @@
-// <auto-generated />
-using System;
-using Microsoft.EntityFrameworkCore;
-using Microsoft.EntityFrameworkCore.Infrastructure;
-using Microsoft.EntityFrameworkCore.Migrations;
-using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
-using osu.Game.Database;
-
-namespace osu.Game.Migrations
-{
-    [DbContext(typeof(OsuDbContext))]
-    [Migration("20210412045700_RefreshVolumeBindingsAgain")]
-    partial class RefreshVolumeBindingsAgain
-    {
-        protected override void BuildTargetModel(ModelBuilder modelBuilder)
-        {
-#pragma warning disable 612, 618
-            modelBuilder
-                .HasAnnotation("ProductVersion", "2.2.6-servicing-10079");
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapDifficulty", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<float>("ApproachRate");
-
-                    b.Property<float>("CircleSize");
-
-                    b.Property<float>("DrainRate");
-
-                    b.Property<float>("OverallDifficulty");
-
-                    b.Property<double>("SliderMultiplier");
-
-                    b.Property<double>("SliderTickRate");
-
-                    b.HasKey("ID");
-
-                    b.ToTable("BeatmapDifficulty");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<double>("AudioLeadIn");
-
-                    b.Property<double>("BPM");
-
-                    b.Property<int>("BaseDifficultyID");
-
-                    b.Property<int>("BeatDivisor");
-
-                    b.Property<int>("BeatmapSetInfoID");
-
-                    b.Property<bool>("Countdown");
-
-                    b.Property<double>("DistanceSpacing");
-
-                    b.Property<int>("GridSize");
-
-                    b.Property<string>("Hash");
-
-                    b.Property<bool>("Hidden");
-
-                    b.Property<double>("Length");
-
-                    b.Property<bool>("LetterboxInBreaks");
-
-                    b.Property<string>("MD5Hash");
-
-                    b.Property<int?>("MetadataID");
-
-                    b.Property<int?>("OnlineBeatmapID");
-
-                    b.Property<string>("Path");
-
-                    b.Property<int>("RulesetID");
-
-                    b.Property<bool>("SpecialStyle");
-
-                    b.Property<float>("StackLeniency");
-
-                    b.Property<double>("StarDifficulty");
-
-                    b.Property<int>("Status");
-
-                    b.Property<string>("StoredBookmarks");
-
-                    b.Property<double>("TimelineZoom");
-
-                    b.Property<string>("Version");
-
-                    b.Property<bool>("WidescreenStoryboard");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("BaseDifficultyID");
-
-                    b.HasIndex("BeatmapSetInfoID");
-
-                    b.HasIndex("Hash");
-
-                    b.HasIndex("MD5Hash");
-
-                    b.HasIndex("MetadataID");
-
-                    b.HasIndex("OnlineBeatmapID")
-                        .IsUnique();
-
-                    b.HasIndex("RulesetID");
-
-                    b.ToTable("BeatmapInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapMetadata", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Artist");
-
-                    b.Property<string>("ArtistUnicode");
-
-                    b.Property<string>("AudioFile");
-
-                    b.Property<string>("AuthorString")
-                        .HasColumnName("Author");
-
-                    b.Property<string>("BackgroundFile");
-
-                    b.Property<int>("PreviewTime");
-
-                    b.Property<string>("Source");
-
-                    b.Property<string>("Tags");
-
-                    b.Property<string>("Title");
-
-                    b.Property<string>("TitleUnicode");
-
-                    b.Property<string>("VideoFile");
-
-                    b.HasKey("ID");
-
-                    b.ToTable("BeatmapMetadata");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("BeatmapSetInfoID");
-
-                    b.Property<int>("FileInfoID");
-
-                    b.Property<string>("Filename")
-                        .IsRequired();
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("BeatmapSetInfoID");
-
-                    b.HasIndex("FileInfoID");
-
-                    b.ToTable("BeatmapSetFileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<DateTimeOffset>("DateAdded");
-
-                    b.Property<bool>("DeletePending");
-
-                    b.Property<string>("Hash");
-
-                    b.Property<int?>("MetadataID");
-
-                    b.Property<int?>("OnlineBeatmapSetID");
-
-                    b.Property<bool>("Protected");
-
-                    b.Property<int>("Status");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("DeletePending");
-
-                    b.HasIndex("Hash")
-                        .IsUnique();
-
-                    b.HasIndex("MetadataID");
-
-                    b.HasIndex("OnlineBeatmapSetID")
-                        .IsUnique();
-
-                    b.ToTable("BeatmapSetInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Configuration.DatabasedSetting", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Key")
-                        .HasColumnName("Key");
-
-                    b.Property<int?>("RulesetID");
-
-                    b.Property<int?>("SkinInfoID");
-
-                    b.Property<string>("StringValue")
-                        .HasColumnName("Value");
-
-                    b.Property<int?>("Variant");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("SkinInfoID");
-
-                    b.HasIndex("RulesetID", "Variant");
-
-                    b.ToTable("Settings");
-                });
-
-            modelBuilder.Entity("osu.Game.IO.FileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Hash");
-
-                    b.Property<int>("ReferenceCount");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("Hash")
-                        .IsUnique();
-
-                    b.HasIndex("ReferenceCount");
-
-                    b.ToTable("FileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Input.Bindings.DatabasedKeyBinding", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("IntAction")
-                        .HasColumnName("Action");
-
-                    b.Property<string>("KeysString")
-                        .HasColumnName("Keys");
-
-                    b.Property<int?>("RulesetID");
-
-                    b.Property<int?>("Variant");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("IntAction");
-
-                    b.HasIndex("RulesetID", "Variant");
-
-                    b.ToTable("KeyBinding");
-                });
-
-            modelBuilder.Entity("osu.Game.Rulesets.RulesetInfo", b =>
-                {
-                    b.Property<int?>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<bool>("Available");
-
-                    b.Property<string>("InstantiationInfo");
-
-                    b.Property<string>("Name");
-
-                    b.Property<string>("ShortName");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("Available");
-
-                    b.HasIndex("ShortName")
-                        .IsUnique();
-
-                    b.ToTable("RulesetInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Scoring.ScoreFileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("FileInfoID");
-
-                    b.Property<string>("Filename")
-                        .IsRequired();
-
-                    b.Property<int?>("ScoreInfoID");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("FileInfoID");
-
-                    b.HasIndex("ScoreInfoID");
-
-                    b.ToTable("ScoreFileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Scoring.ScoreInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<double>("Accuracy")
-                        .HasColumnType("DECIMAL(1,4)");
-
-                    b.Property<int>("BeatmapInfoID");
-
-                    b.Property<int>("Combo");
-
-                    b.Property<DateTimeOffset>("Date");
-
-                    b.Property<bool>("DeletePending");
-
-                    b.Property<string>("Hash");
-
-                    b.Property<int>("MaxCombo");
-
-                    b.Property<string>("ModsJson")
-                        .HasColumnName("Mods");
-
-                    b.Property<long?>("OnlineScoreID");
-
-                    b.Property<double?>("PP");
-
-                    b.Property<int>("Rank");
-
-                    b.Property<int>("RulesetID");
-
-                    b.Property<string>("StatisticsJson")
-                        .HasColumnName("Statistics");
-
-                    b.Property<long>("TotalScore");
-
-                    b.Property<long?>("UserID")
-                        .HasColumnName("UserID");
-
-                    b.Property<string>("UserString")
-                        .HasColumnName("User");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("BeatmapInfoID");
-
-                    b.HasIndex("OnlineScoreID")
-                        .IsUnique();
-
-                    b.HasIndex("RulesetID");
-
-                    b.ToTable("ScoreInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Skinning.SkinFileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("FileInfoID");
-
-                    b.Property<string>("Filename")
-                        .IsRequired();
-
-                    b.Property<int>("SkinInfoID");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("FileInfoID");
-
-                    b.HasIndex("SkinInfoID");
-
-                    b.ToTable("SkinFileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Skinning.SkinInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Creator");
-
-                    b.Property<bool>("DeletePending");
-
-                    b.Property<string>("Hash");
-
-                    b.Property<string>("Name");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("DeletePending");
-
-                    b.HasIndex("Hash")
-                        .IsUnique();
-
-                    b.ToTable("SkinInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapDifficulty", "BaseDifficulty")
-                        .WithMany()
-                        .HasForeignKey("BaseDifficultyID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo", "BeatmapSet")
-                        .WithMany("Beatmaps")
-                        .HasForeignKey("BeatmapSetInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
-                        .WithMany("Beatmaps")
-                        .HasForeignKey("MetadataID");
-
-                    b.HasOne("osu.Game.Rulesets.RulesetInfo", "Ruleset")
-                        .WithMany()
-                        .HasForeignKey("RulesetID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo")
-                        .WithMany("Files")
-                        .HasForeignKey("BeatmapSetInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
-                        .WithMany()
-                        .HasForeignKey("FileInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
-                        .WithMany("BeatmapSets")
-                        .HasForeignKey("MetadataID");
-                });
-
-            modelBuilder.Entity("osu.Game.Configuration.DatabasedSetting", b =>
-                {
-                    b.HasOne("osu.Game.Skinning.SkinInfo")
-                        .WithMany("Settings")
-                        .HasForeignKey("SkinInfoID");
-                });
-
-            modelBuilder.Entity("osu.Game.Scoring.ScoreFileInfo", b =>
-                {
-                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
-                        .WithMany()
-                        .HasForeignKey("FileInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Scoring.ScoreInfo")
-                        .WithMany("Files")
-                        .HasForeignKey("ScoreInfoID");
-                });
-
-            modelBuilder.Entity("osu.Game.Scoring.ScoreInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapInfo", "Beatmap")
-                        .WithMany("Scores")
-                        .HasForeignKey("BeatmapInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Rulesets.RulesetInfo", "Ruleset")
-                        .WithMany()
-                        .HasForeignKey("RulesetID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-
-            modelBuilder.Entity("osu.Game.Skinning.SkinFileInfo", b =>
-                {
-                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
-                        .WithMany()
-                        .HasForeignKey("FileInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Skinning.SkinInfo")
-                        .WithMany("Files")
-                        .HasForeignKey("SkinInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-#pragma warning restore 612, 618
-        }
-    }
-}
diff --git a/osu.Game/Migrations/20210412045700_RefreshVolumeBindingsAgain.cs b/osu.Game/Migrations/20210412045700_RefreshVolumeBindingsAgain.cs
deleted file mode 100644
index 155d6670a8..0000000000
--- a/osu.Game/Migrations/20210412045700_RefreshVolumeBindingsAgain.cs
+++ /dev/null
@@ -1,16 +0,0 @@
-using Microsoft.EntityFrameworkCore.Migrations;
-
-namespace osu.Game.Migrations
-{
-    public partial class RefreshVolumeBindingsAgain : Migration
-    {
-        protected override void Up(MigrationBuilder migrationBuilder)
-        {
-            migrationBuilder.Sql("DELETE FROM KeyBinding WHERE action in (6,7)");
-        }
-
-        protected override void Down(MigrationBuilder migrationBuilder)
-        {
-        }
-    }
-}
diff --git a/osu.Game/Migrations/20210511060743_AddSkinInstantiationInfo.Designer.cs b/osu.Game/Migrations/20210511060743_AddSkinInstantiationInfo.Designer.cs
deleted file mode 100644
index b808c648da..0000000000
--- a/osu.Game/Migrations/20210511060743_AddSkinInstantiationInfo.Designer.cs
+++ /dev/null
@@ -1,508 +0,0 @@
-// <auto-generated />
-using System;
-using Microsoft.EntityFrameworkCore;
-using Microsoft.EntityFrameworkCore.Infrastructure;
-using Microsoft.EntityFrameworkCore.Migrations;
-using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
-using osu.Game.Database;
-
-namespace osu.Game.Migrations
-{
-    [DbContext(typeof(OsuDbContext))]
-    [Migration("20210511060743_AddSkinInstantiationInfo")]
-    partial class AddSkinInstantiationInfo
-    {
-        protected override void BuildTargetModel(ModelBuilder modelBuilder)
-        {
-#pragma warning disable 612, 618
-            modelBuilder
-                .HasAnnotation("ProductVersion", "2.2.6-servicing-10079");
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapDifficulty", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<float>("ApproachRate");
-
-                    b.Property<float>("CircleSize");
-
-                    b.Property<float>("DrainRate");
-
-                    b.Property<float>("OverallDifficulty");
-
-                    b.Property<double>("SliderMultiplier");
-
-                    b.Property<double>("SliderTickRate");
-
-                    b.HasKey("ID");
-
-                    b.ToTable("BeatmapDifficulty");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<double>("AudioLeadIn");
-
-                    b.Property<double>("BPM");
-
-                    b.Property<int>("BaseDifficultyID");
-
-                    b.Property<int>("BeatDivisor");
-
-                    b.Property<int>("BeatmapSetInfoID");
-
-                    b.Property<bool>("Countdown");
-
-                    b.Property<double>("DistanceSpacing");
-
-                    b.Property<bool>("EpilepsyWarning");
-
-                    b.Property<int>("GridSize");
-
-                    b.Property<string>("Hash");
-
-                    b.Property<bool>("Hidden");
-
-                    b.Property<double>("Length");
-
-                    b.Property<bool>("LetterboxInBreaks");
-
-                    b.Property<string>("MD5Hash");
-
-                    b.Property<int?>("MetadataID");
-
-                    b.Property<int?>("OnlineBeatmapID");
-
-                    b.Property<string>("Path");
-
-                    b.Property<int>("RulesetID");
-
-                    b.Property<bool>("SpecialStyle");
-
-                    b.Property<float>("StackLeniency");
-
-                    b.Property<double>("StarDifficulty");
-
-                    b.Property<int>("Status");
-
-                    b.Property<string>("StoredBookmarks");
-
-                    b.Property<double>("TimelineZoom");
-
-                    b.Property<string>("Version");
-
-                    b.Property<bool>("WidescreenStoryboard");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("BaseDifficultyID");
-
-                    b.HasIndex("BeatmapSetInfoID");
-
-                    b.HasIndex("Hash");
-
-                    b.HasIndex("MD5Hash");
-
-                    b.HasIndex("MetadataID");
-
-                    b.HasIndex("OnlineBeatmapID")
-                        .IsUnique();
-
-                    b.HasIndex("RulesetID");
-
-                    b.ToTable("BeatmapInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapMetadata", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Artist");
-
-                    b.Property<string>("ArtistUnicode");
-
-                    b.Property<string>("AudioFile");
-
-                    b.Property<string>("AuthorString")
-                        .HasColumnName("Author");
-
-                    b.Property<string>("BackgroundFile");
-
-                    b.Property<int>("PreviewTime");
-
-                    b.Property<string>("Source");
-
-                    b.Property<string>("Tags");
-
-                    b.Property<string>("Title");
-
-                    b.Property<string>("TitleUnicode");
-
-                    b.HasKey("ID");
-
-                    b.ToTable("BeatmapMetadata");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("BeatmapSetInfoID");
-
-                    b.Property<int>("FileInfoID");
-
-                    b.Property<string>("Filename")
-                        .IsRequired();
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("BeatmapSetInfoID");
-
-                    b.HasIndex("FileInfoID");
-
-                    b.ToTable("BeatmapSetFileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<DateTimeOffset>("DateAdded");
-
-                    b.Property<bool>("DeletePending");
-
-                    b.Property<string>("Hash");
-
-                    b.Property<int?>("MetadataID");
-
-                    b.Property<int?>("OnlineBeatmapSetID");
-
-                    b.Property<bool>("Protected");
-
-                    b.Property<int>("Status");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("DeletePending");
-
-                    b.HasIndex("Hash")
-                        .IsUnique();
-
-                    b.HasIndex("MetadataID");
-
-                    b.HasIndex("OnlineBeatmapSetID")
-                        .IsUnique();
-
-                    b.ToTable("BeatmapSetInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Configuration.DatabasedSetting", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Key")
-                        .HasColumnName("Key");
-
-                    b.Property<int?>("RulesetID");
-
-                    b.Property<int?>("SkinInfoID");
-
-                    b.Property<string>("StringValue")
-                        .HasColumnName("Value");
-
-                    b.Property<int?>("Variant");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("SkinInfoID");
-
-                    b.HasIndex("RulesetID", "Variant");
-
-                    b.ToTable("Settings");
-                });
-
-            modelBuilder.Entity("osu.Game.IO.FileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Hash");
-
-                    b.Property<int>("ReferenceCount");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("Hash")
-                        .IsUnique();
-
-                    b.HasIndex("ReferenceCount");
-
-                    b.ToTable("FileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Input.Bindings.DatabasedKeyBinding", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("IntAction")
-                        .HasColumnName("Action");
-
-                    b.Property<string>("KeysString")
-                        .HasColumnName("Keys");
-
-                    b.Property<int?>("RulesetID");
-
-                    b.Property<int?>("Variant");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("IntAction");
-
-                    b.HasIndex("RulesetID", "Variant");
-
-                    b.ToTable("KeyBinding");
-                });
-
-            modelBuilder.Entity("osu.Game.Rulesets.RulesetInfo", b =>
-                {
-                    b.Property<int?>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<bool>("Available");
-
-                    b.Property<string>("InstantiationInfo");
-
-                    b.Property<string>("Name");
-
-                    b.Property<string>("ShortName");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("Available");
-
-                    b.HasIndex("ShortName")
-                        .IsUnique();
-
-                    b.ToTable("RulesetInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Scoring.ScoreFileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("FileInfoID");
-
-                    b.Property<string>("Filename")
-                        .IsRequired();
-
-                    b.Property<int?>("ScoreInfoID");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("FileInfoID");
-
-                    b.HasIndex("ScoreInfoID");
-
-                    b.ToTable("ScoreFileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Scoring.ScoreInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<double>("Accuracy")
-                        .HasColumnType("DECIMAL(1,4)");
-
-                    b.Property<int>("BeatmapInfoID");
-
-                    b.Property<int>("Combo");
-
-                    b.Property<DateTimeOffset>("Date");
-
-                    b.Property<bool>("DeletePending");
-
-                    b.Property<string>("Hash");
-
-                    b.Property<int>("MaxCombo");
-
-                    b.Property<string>("ModsJson")
-                        .HasColumnName("Mods");
-
-                    b.Property<long?>("OnlineScoreID");
-
-                    b.Property<double?>("PP");
-
-                    b.Property<int>("Rank");
-
-                    b.Property<int>("RulesetID");
-
-                    b.Property<string>("StatisticsJson")
-                        .HasColumnName("Statistics");
-
-                    b.Property<long>("TotalScore");
-
-                    b.Property<int?>("UserID")
-                        .HasColumnName("UserID");
-
-                    b.Property<string>("UserString")
-                        .HasColumnName("User");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("BeatmapInfoID");
-
-                    b.HasIndex("OnlineScoreID")
-                        .IsUnique();
-
-                    b.HasIndex("RulesetID");
-
-                    b.ToTable("ScoreInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Skinning.SkinFileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("FileInfoID");
-
-                    b.Property<string>("Filename")
-                        .IsRequired();
-
-                    b.Property<int>("SkinInfoID");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("FileInfoID");
-
-                    b.HasIndex("SkinInfoID");
-
-                    b.ToTable("SkinFileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Skinning.SkinInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Creator");
-
-                    b.Property<bool>("DeletePending");
-
-                    b.Property<string>("Hash");
-
-                    b.Property<string>("InstantiationInfo");
-
-                    b.Property<string>("Name");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("DeletePending");
-
-                    b.HasIndex("Hash")
-                        .IsUnique();
-
-                    b.ToTable("SkinInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapDifficulty", "BaseDifficulty")
-                        .WithMany()
-                        .HasForeignKey("BaseDifficultyID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo", "BeatmapSet")
-                        .WithMany("Beatmaps")
-                        .HasForeignKey("BeatmapSetInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
-                        .WithMany("Beatmaps")
-                        .HasForeignKey("MetadataID");
-
-                    b.HasOne("osu.Game.Rulesets.RulesetInfo", "Ruleset")
-                        .WithMany()
-                        .HasForeignKey("RulesetID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo")
-                        .WithMany("Files")
-                        .HasForeignKey("BeatmapSetInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
-                        .WithMany()
-                        .HasForeignKey("FileInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
-                        .WithMany("BeatmapSets")
-                        .HasForeignKey("MetadataID");
-                });
-
-            modelBuilder.Entity("osu.Game.Configuration.DatabasedSetting", b =>
-                {
-                    b.HasOne("osu.Game.Skinning.SkinInfo")
-                        .WithMany("Settings")
-                        .HasForeignKey("SkinInfoID");
-                });
-
-            modelBuilder.Entity("osu.Game.Scoring.ScoreFileInfo", b =>
-                {
-                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
-                        .WithMany()
-                        .HasForeignKey("FileInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Scoring.ScoreInfo")
-                        .WithMany("Files")
-                        .HasForeignKey("ScoreInfoID");
-                });
-
-            modelBuilder.Entity("osu.Game.Scoring.ScoreInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapInfo", "Beatmap")
-                        .WithMany("Scores")
-                        .HasForeignKey("BeatmapInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Rulesets.RulesetInfo", "Ruleset")
-                        .WithMany()
-                        .HasForeignKey("RulesetID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-
-            modelBuilder.Entity("osu.Game.Skinning.SkinFileInfo", b =>
-                {
-                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
-                        .WithMany()
-                        .HasForeignKey("FileInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Skinning.SkinInfo")
-                        .WithMany("Files")
-                        .HasForeignKey("SkinInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-#pragma warning restore 612, 618
-        }
-    }
-}
diff --git a/osu.Game/Migrations/20210511060743_AddSkinInstantiationInfo.cs b/osu.Game/Migrations/20210511060743_AddSkinInstantiationInfo.cs
deleted file mode 100644
index 1d5b0769a4..0000000000
--- a/osu.Game/Migrations/20210511060743_AddSkinInstantiationInfo.cs
+++ /dev/null
@@ -1,22 +0,0 @@
-using Microsoft.EntityFrameworkCore.Migrations;
-
-namespace osu.Game.Migrations
-{
-    public partial class AddSkinInstantiationInfo : Migration
-    {
-        protected override void Up(MigrationBuilder migrationBuilder)
-        {
-            migrationBuilder.AddColumn<string>(
-                name: "InstantiationInfo",
-                table: "SkinInfo",
-                nullable: true);
-        }
-
-        protected override void Down(MigrationBuilder migrationBuilder)
-        {
-            migrationBuilder.DropColumn(
-                name: "InstantiationInfo",
-                table: "SkinInfo");
-        }
-    }
-}
diff --git a/osu.Game/Migrations/20210514062639_AddAuthorIdToBeatmapMetadata.Designer.cs b/osu.Game/Migrations/20210514062639_AddAuthorIdToBeatmapMetadata.Designer.cs
deleted file mode 100644
index 89bab3a0fa..0000000000
--- a/osu.Game/Migrations/20210514062639_AddAuthorIdToBeatmapMetadata.Designer.cs
+++ /dev/null
@@ -1,511 +0,0 @@
-// <auto-generated />
-using System;
-using Microsoft.EntityFrameworkCore;
-using Microsoft.EntityFrameworkCore.Infrastructure;
-using Microsoft.EntityFrameworkCore.Migrations;
-using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
-using osu.Game.Database;
-
-namespace osu.Game.Migrations
-{
-    [DbContext(typeof(OsuDbContext))]
-    [Migration("20210514062639_AddAuthorIdToBeatmapMetadata")]
-    partial class AddAuthorIdToBeatmapMetadata
-    {
-        protected override void BuildTargetModel(ModelBuilder modelBuilder)
-        {
-#pragma warning disable 612, 618
-            modelBuilder
-                .HasAnnotation("ProductVersion", "2.2.6-servicing-10079");
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapDifficulty", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<float>("ApproachRate");
-
-                    b.Property<float>("CircleSize");
-
-                    b.Property<float>("DrainRate");
-
-                    b.Property<float>("OverallDifficulty");
-
-                    b.Property<double>("SliderMultiplier");
-
-                    b.Property<double>("SliderTickRate");
-
-                    b.HasKey("ID");
-
-                    b.ToTable("BeatmapDifficulty");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<double>("AudioLeadIn");
-
-                    b.Property<double>("BPM");
-
-                    b.Property<int>("BaseDifficultyID");
-
-                    b.Property<int>("BeatDivisor");
-
-                    b.Property<int>("BeatmapSetInfoID");
-
-                    b.Property<bool>("Countdown");
-
-                    b.Property<double>("DistanceSpacing");
-
-                    b.Property<bool>("EpilepsyWarning");
-
-                    b.Property<int>("GridSize");
-
-                    b.Property<string>("Hash");
-
-                    b.Property<bool>("Hidden");
-
-                    b.Property<double>("Length");
-
-                    b.Property<bool>("LetterboxInBreaks");
-
-                    b.Property<string>("MD5Hash");
-
-                    b.Property<int?>("MetadataID");
-
-                    b.Property<int?>("OnlineBeatmapID");
-
-                    b.Property<string>("Path");
-
-                    b.Property<int>("RulesetID");
-
-                    b.Property<bool>("SpecialStyle");
-
-                    b.Property<float>("StackLeniency");
-
-                    b.Property<double>("StarDifficulty");
-
-                    b.Property<int>("Status");
-
-                    b.Property<string>("StoredBookmarks");
-
-                    b.Property<double>("TimelineZoom");
-
-                    b.Property<string>("Version");
-
-                    b.Property<bool>("WidescreenStoryboard");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("BaseDifficultyID");
-
-                    b.HasIndex("BeatmapSetInfoID");
-
-                    b.HasIndex("Hash");
-
-                    b.HasIndex("MD5Hash");
-
-                    b.HasIndex("MetadataID");
-
-                    b.HasIndex("OnlineBeatmapID")
-                        .IsUnique();
-
-                    b.HasIndex("RulesetID");
-
-                    b.ToTable("BeatmapInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapMetadata", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Artist");
-
-                    b.Property<string>("ArtistUnicode");
-
-                    b.Property<string>("AudioFile");
-
-                    b.Property<int>("AuthorID")
-                        .HasColumnName("AuthorID");
-
-                    b.Property<string>("AuthorString")
-                        .HasColumnName("Author");
-
-                    b.Property<string>("BackgroundFile");
-
-                    b.Property<int>("PreviewTime");
-
-                    b.Property<string>("Source");
-
-                    b.Property<string>("Tags");
-
-                    b.Property<string>("Title");
-
-                    b.Property<string>("TitleUnicode");
-
-                    b.HasKey("ID");
-
-                    b.ToTable("BeatmapMetadata");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("BeatmapSetInfoID");
-
-                    b.Property<int>("FileInfoID");
-
-                    b.Property<string>("Filename")
-                        .IsRequired();
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("BeatmapSetInfoID");
-
-                    b.HasIndex("FileInfoID");
-
-                    b.ToTable("BeatmapSetFileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<DateTimeOffset>("DateAdded");
-
-                    b.Property<bool>("DeletePending");
-
-                    b.Property<string>("Hash");
-
-                    b.Property<int?>("MetadataID");
-
-                    b.Property<int?>("OnlineBeatmapSetID");
-
-                    b.Property<bool>("Protected");
-
-                    b.Property<int>("Status");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("DeletePending");
-
-                    b.HasIndex("Hash")
-                        .IsUnique();
-
-                    b.HasIndex("MetadataID");
-
-                    b.HasIndex("OnlineBeatmapSetID")
-                        .IsUnique();
-
-                    b.ToTable("BeatmapSetInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Configuration.DatabasedSetting", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Key")
-                        .HasColumnName("Key");
-
-                    b.Property<int?>("RulesetID");
-
-                    b.Property<int?>("SkinInfoID");
-
-                    b.Property<string>("StringValue")
-                        .HasColumnName("Value");
-
-                    b.Property<int?>("Variant");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("SkinInfoID");
-
-                    b.HasIndex("RulesetID", "Variant");
-
-                    b.ToTable("Settings");
-                });
-
-            modelBuilder.Entity("osu.Game.IO.FileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Hash");
-
-                    b.Property<int>("ReferenceCount");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("Hash")
-                        .IsUnique();
-
-                    b.HasIndex("ReferenceCount");
-
-                    b.ToTable("FileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Input.Bindings.DatabasedKeyBinding", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("IntAction")
-                        .HasColumnName("Action");
-
-                    b.Property<string>("KeysString")
-                        .HasColumnName("Keys");
-
-                    b.Property<int?>("RulesetID");
-
-                    b.Property<int?>("Variant");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("IntAction");
-
-                    b.HasIndex("RulesetID", "Variant");
-
-                    b.ToTable("KeyBinding");
-                });
-
-            modelBuilder.Entity("osu.Game.Rulesets.RulesetInfo", b =>
-                {
-                    b.Property<int?>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<bool>("Available");
-
-                    b.Property<string>("InstantiationInfo");
-
-                    b.Property<string>("Name");
-
-                    b.Property<string>("ShortName");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("Available");
-
-                    b.HasIndex("ShortName")
-                        .IsUnique();
-
-                    b.ToTable("RulesetInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Scoring.ScoreFileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("FileInfoID");
-
-                    b.Property<string>("Filename")
-                        .IsRequired();
-
-                    b.Property<int?>("ScoreInfoID");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("FileInfoID");
-
-                    b.HasIndex("ScoreInfoID");
-
-                    b.ToTable("ScoreFileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Scoring.ScoreInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<double>("Accuracy")
-                        .HasColumnType("DECIMAL(1,4)");
-
-                    b.Property<int>("BeatmapInfoID");
-
-                    b.Property<int>("Combo");
-
-                    b.Property<DateTimeOffset>("Date");
-
-                    b.Property<bool>("DeletePending");
-
-                    b.Property<string>("Hash");
-
-                    b.Property<int>("MaxCombo");
-
-                    b.Property<string>("ModsJson")
-                        .HasColumnName("Mods");
-
-                    b.Property<long?>("OnlineScoreID");
-
-                    b.Property<double?>("PP");
-
-                    b.Property<int>("Rank");
-
-                    b.Property<int>("RulesetID");
-
-                    b.Property<string>("StatisticsJson")
-                        .HasColumnName("Statistics");
-
-                    b.Property<long>("TotalScore");
-
-                    b.Property<int?>("UserID")
-                        .HasColumnName("UserID");
-
-                    b.Property<string>("UserString")
-                        .HasColumnName("User");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("BeatmapInfoID");
-
-                    b.HasIndex("OnlineScoreID")
-                        .IsUnique();
-
-                    b.HasIndex("RulesetID");
-
-                    b.ToTable("ScoreInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Skinning.SkinFileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("FileInfoID");
-
-                    b.Property<string>("Filename")
-                        .IsRequired();
-
-                    b.Property<int>("SkinInfoID");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("FileInfoID");
-
-                    b.HasIndex("SkinInfoID");
-
-                    b.ToTable("SkinFileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Skinning.SkinInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Creator");
-
-                    b.Property<bool>("DeletePending");
-
-                    b.Property<string>("Hash");
-
-                    b.Property<string>("InstantiationInfo");
-
-                    b.Property<string>("Name");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("DeletePending");
-
-                    b.HasIndex("Hash")
-                        .IsUnique();
-
-                    b.ToTable("SkinInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapDifficulty", "BaseDifficulty")
-                        .WithMany()
-                        .HasForeignKey("BaseDifficultyID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo", "BeatmapSet")
-                        .WithMany("Beatmaps")
-                        .HasForeignKey("BeatmapSetInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
-                        .WithMany("Beatmaps")
-                        .HasForeignKey("MetadataID");
-
-                    b.HasOne("osu.Game.Rulesets.RulesetInfo", "Ruleset")
-                        .WithMany()
-                        .HasForeignKey("RulesetID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo")
-                        .WithMany("Files")
-                        .HasForeignKey("BeatmapSetInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
-                        .WithMany()
-                        .HasForeignKey("FileInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
-                        .WithMany("BeatmapSets")
-                        .HasForeignKey("MetadataID");
-                });
-
-            modelBuilder.Entity("osu.Game.Configuration.DatabasedSetting", b =>
-                {
-                    b.HasOne("osu.Game.Skinning.SkinInfo")
-                        .WithMany("Settings")
-                        .HasForeignKey("SkinInfoID");
-                });
-
-            modelBuilder.Entity("osu.Game.Scoring.ScoreFileInfo", b =>
-                {
-                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
-                        .WithMany()
-                        .HasForeignKey("FileInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Scoring.ScoreInfo")
-                        .WithMany("Files")
-                        .HasForeignKey("ScoreInfoID");
-                });
-
-            modelBuilder.Entity("osu.Game.Scoring.ScoreInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapInfo", "Beatmap")
-                        .WithMany("Scores")
-                        .HasForeignKey("BeatmapInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Rulesets.RulesetInfo", "Ruleset")
-                        .WithMany()
-                        .HasForeignKey("RulesetID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-
-            modelBuilder.Entity("osu.Game.Skinning.SkinFileInfo", b =>
-                {
-                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
-                        .WithMany()
-                        .HasForeignKey("FileInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Skinning.SkinInfo")
-                        .WithMany("Files")
-                        .HasForeignKey("SkinInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-#pragma warning restore 612, 618
-        }
-    }
-}
diff --git a/osu.Game/Migrations/20210514062639_AddAuthorIdToBeatmapMetadata.cs b/osu.Game/Migrations/20210514062639_AddAuthorIdToBeatmapMetadata.cs
deleted file mode 100644
index 98fe9b5e13..0000000000
--- a/osu.Game/Migrations/20210514062639_AddAuthorIdToBeatmapMetadata.cs
+++ /dev/null
@@ -1,23 +0,0 @@
-using Microsoft.EntityFrameworkCore.Migrations;
-
-namespace osu.Game.Migrations
-{
-    public partial class AddAuthorIdToBeatmapMetadata : Migration
-    {
-        protected override void Up(MigrationBuilder migrationBuilder)
-        {
-            migrationBuilder.AddColumn<int>(
-                name: "AuthorID",
-                table: "BeatmapMetadata",
-                nullable: false,
-                defaultValue: 0);
-        }
-
-        protected override void Down(MigrationBuilder migrationBuilder)
-        {
-            migrationBuilder.DropColumn(
-                name: "AuthorID",
-                table: "BeatmapMetadata");
-        }
-    }
-}
diff --git a/osu.Game/Migrations/20210824185035_AddCountdownSettings.Designer.cs b/osu.Game/Migrations/20210824185035_AddCountdownSettings.Designer.cs
deleted file mode 100644
index afeb42130d..0000000000
--- a/osu.Game/Migrations/20210824185035_AddCountdownSettings.Designer.cs
+++ /dev/null
@@ -1,513 +0,0 @@
-// <auto-generated />
-using System;
-using Microsoft.EntityFrameworkCore;
-using Microsoft.EntityFrameworkCore.Infrastructure;
-using Microsoft.EntityFrameworkCore.Migrations;
-using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
-using osu.Game.Database;
-
-namespace osu.Game.Migrations
-{
-    [DbContext(typeof(OsuDbContext))]
-    [Migration("20210824185035_AddCountdownSettings")]
-    partial class AddCountdownSettings
-    {
-        protected override void BuildTargetModel(ModelBuilder modelBuilder)
-        {
-#pragma warning disable 612, 618
-            modelBuilder
-                .HasAnnotation("ProductVersion", "2.2.6-servicing-10079");
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapDifficulty", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<float>("ApproachRate");
-
-                    b.Property<float>("CircleSize");
-
-                    b.Property<float>("DrainRate");
-
-                    b.Property<float>("OverallDifficulty");
-
-                    b.Property<double>("SliderMultiplier");
-
-                    b.Property<double>("SliderTickRate");
-
-                    b.HasKey("ID");
-
-                    b.ToTable("BeatmapDifficulty");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<double>("AudioLeadIn");
-
-                    b.Property<double>("BPM");
-
-                    b.Property<int>("BaseDifficultyID");
-
-                    b.Property<int>("BeatDivisor");
-
-                    b.Property<int>("BeatmapSetInfoID");
-
-                    b.Property<int>("Countdown");
-
-                    b.Property<int>("CountdownOffset");
-
-                    b.Property<double>("DistanceSpacing");
-
-                    b.Property<bool>("EpilepsyWarning");
-
-                    b.Property<int>("GridSize");
-
-                    b.Property<string>("Hash");
-
-                    b.Property<bool>("Hidden");
-
-                    b.Property<double>("Length");
-
-                    b.Property<bool>("LetterboxInBreaks");
-
-                    b.Property<string>("MD5Hash");
-
-                    b.Property<int?>("MetadataID");
-
-                    b.Property<int?>("OnlineBeatmapID");
-
-                    b.Property<string>("Path");
-
-                    b.Property<int>("RulesetID");
-
-                    b.Property<bool>("SpecialStyle");
-
-                    b.Property<float>("StackLeniency");
-
-                    b.Property<double>("StarDifficulty");
-
-                    b.Property<int>("Status");
-
-                    b.Property<string>("StoredBookmarks");
-
-                    b.Property<double>("TimelineZoom");
-
-                    b.Property<string>("Version");
-
-                    b.Property<bool>("WidescreenStoryboard");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("BaseDifficultyID");
-
-                    b.HasIndex("BeatmapSetInfoID");
-
-                    b.HasIndex("Hash");
-
-                    b.HasIndex("MD5Hash");
-
-                    b.HasIndex("MetadataID");
-
-                    b.HasIndex("OnlineBeatmapID")
-                        .IsUnique();
-
-                    b.HasIndex("RulesetID");
-
-                    b.ToTable("BeatmapInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapMetadata", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Artist");
-
-                    b.Property<string>("ArtistUnicode");
-
-                    b.Property<string>("AudioFile");
-
-                    b.Property<int>("AuthorID")
-                        .HasColumnName("AuthorID");
-
-                    b.Property<string>("AuthorString")
-                        .HasColumnName("Author");
-
-                    b.Property<string>("BackgroundFile");
-
-                    b.Property<int>("PreviewTime");
-
-                    b.Property<string>("Source");
-
-                    b.Property<string>("Tags");
-
-                    b.Property<string>("Title");
-
-                    b.Property<string>("TitleUnicode");
-
-                    b.HasKey("ID");
-
-                    b.ToTable("BeatmapMetadata");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("BeatmapSetInfoID");
-
-                    b.Property<int>("FileInfoID");
-
-                    b.Property<string>("Filename")
-                        .IsRequired();
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("BeatmapSetInfoID");
-
-                    b.HasIndex("FileInfoID");
-
-                    b.ToTable("BeatmapSetFileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<DateTimeOffset>("DateAdded");
-
-                    b.Property<bool>("DeletePending");
-
-                    b.Property<string>("Hash");
-
-                    b.Property<int?>("MetadataID");
-
-                    b.Property<int?>("OnlineBeatmapSetID");
-
-                    b.Property<bool>("Protected");
-
-                    b.Property<int>("Status");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("DeletePending");
-
-                    b.HasIndex("Hash")
-                        .IsUnique();
-
-                    b.HasIndex("MetadataID");
-
-                    b.HasIndex("OnlineBeatmapSetID")
-                        .IsUnique();
-
-                    b.ToTable("BeatmapSetInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Configuration.DatabasedSetting", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Key")
-                        .HasColumnName("Key");
-
-                    b.Property<int?>("RulesetID");
-
-                    b.Property<int?>("SkinInfoID");
-
-                    b.Property<string>("StringValue")
-                        .HasColumnName("Value");
-
-                    b.Property<int?>("Variant");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("SkinInfoID");
-
-                    b.HasIndex("RulesetID", "Variant");
-
-                    b.ToTable("Settings");
-                });
-
-            modelBuilder.Entity("osu.Game.IO.FileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Hash");
-
-                    b.Property<int>("ReferenceCount");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("Hash")
-                        .IsUnique();
-
-                    b.HasIndex("ReferenceCount");
-
-                    b.ToTable("FileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Input.Bindings.DatabasedKeyBinding", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("IntAction")
-                        .HasColumnName("Action");
-
-                    b.Property<string>("KeysString")
-                        .HasColumnName("Keys");
-
-                    b.Property<int?>("RulesetID");
-
-                    b.Property<int?>("Variant");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("IntAction");
-
-                    b.HasIndex("RulesetID", "Variant");
-
-                    b.ToTable("KeyBinding");
-                });
-
-            modelBuilder.Entity("osu.Game.Rulesets.RulesetInfo", b =>
-                {
-                    b.Property<int?>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<bool>("Available");
-
-                    b.Property<string>("InstantiationInfo");
-
-                    b.Property<string>("Name");
-
-                    b.Property<string>("ShortName");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("Available");
-
-                    b.HasIndex("ShortName")
-                        .IsUnique();
-
-                    b.ToTable("RulesetInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Scoring.ScoreFileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("FileInfoID");
-
-                    b.Property<string>("Filename")
-                        .IsRequired();
-
-                    b.Property<int?>("ScoreInfoID");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("FileInfoID");
-
-                    b.HasIndex("ScoreInfoID");
-
-                    b.ToTable("ScoreFileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Scoring.ScoreInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<double>("Accuracy")
-                        .HasColumnType("DECIMAL(1,4)");
-
-                    b.Property<int>("BeatmapInfoID");
-
-                    b.Property<int>("Combo");
-
-                    b.Property<DateTimeOffset>("Date");
-
-                    b.Property<bool>("DeletePending");
-
-                    b.Property<string>("Hash");
-
-                    b.Property<int>("MaxCombo");
-
-                    b.Property<string>("ModsJson")
-                        .HasColumnName("Mods");
-
-                    b.Property<long?>("OnlineScoreID");
-
-                    b.Property<double?>("PP");
-
-                    b.Property<int>("Rank");
-
-                    b.Property<int>("RulesetID");
-
-                    b.Property<string>("StatisticsJson")
-                        .HasColumnName("Statistics");
-
-                    b.Property<long>("TotalScore");
-
-                    b.Property<int?>("UserID")
-                        .HasColumnName("UserID");
-
-                    b.Property<string>("UserString")
-                        .HasColumnName("User");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("BeatmapInfoID");
-
-                    b.HasIndex("OnlineScoreID")
-                        .IsUnique();
-
-                    b.HasIndex("RulesetID");
-
-                    b.ToTable("ScoreInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Skinning.SkinFileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("FileInfoID");
-
-                    b.Property<string>("Filename")
-                        .IsRequired();
-
-                    b.Property<int>("SkinInfoID");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("FileInfoID");
-
-                    b.HasIndex("SkinInfoID");
-
-                    b.ToTable("SkinFileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Skinning.SkinInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Creator");
-
-                    b.Property<bool>("DeletePending");
-
-                    b.Property<string>("Hash");
-
-                    b.Property<string>("InstantiationInfo");
-
-                    b.Property<string>("Name");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("DeletePending");
-
-                    b.HasIndex("Hash")
-                        .IsUnique();
-
-                    b.ToTable("SkinInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapDifficulty", "BaseDifficulty")
-                        .WithMany()
-                        .HasForeignKey("BaseDifficultyID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo", "BeatmapSet")
-                        .WithMany("Beatmaps")
-                        .HasForeignKey("BeatmapSetInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
-                        .WithMany("Beatmaps")
-                        .HasForeignKey("MetadataID");
-
-                    b.HasOne("osu.Game.Rulesets.RulesetInfo", "Ruleset")
-                        .WithMany()
-                        .HasForeignKey("RulesetID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo")
-                        .WithMany("Files")
-                        .HasForeignKey("BeatmapSetInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
-                        .WithMany()
-                        .HasForeignKey("FileInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
-                        .WithMany("BeatmapSets")
-                        .HasForeignKey("MetadataID");
-                });
-
-            modelBuilder.Entity("osu.Game.Configuration.DatabasedSetting", b =>
-                {
-                    b.HasOne("osu.Game.Skinning.SkinInfo")
-                        .WithMany("Settings")
-                        .HasForeignKey("SkinInfoID");
-                });
-
-            modelBuilder.Entity("osu.Game.Scoring.ScoreFileInfo", b =>
-                {
-                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
-                        .WithMany()
-                        .HasForeignKey("FileInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Scoring.ScoreInfo")
-                        .WithMany("Files")
-                        .HasForeignKey("ScoreInfoID");
-                });
-
-            modelBuilder.Entity("osu.Game.Scoring.ScoreInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapInfo", "Beatmap")
-                        .WithMany("Scores")
-                        .HasForeignKey("BeatmapInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Rulesets.RulesetInfo", "Ruleset")
-                        .WithMany()
-                        .HasForeignKey("RulesetID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-
-            modelBuilder.Entity("osu.Game.Skinning.SkinFileInfo", b =>
-                {
-                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
-                        .WithMany()
-                        .HasForeignKey("FileInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Skinning.SkinInfo")
-                        .WithMany("Files")
-                        .HasForeignKey("SkinInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-#pragma warning restore 612, 618
-        }
-    }
-}
diff --git a/osu.Game/Migrations/20210824185035_AddCountdownSettings.cs b/osu.Game/Migrations/20210824185035_AddCountdownSettings.cs
deleted file mode 100644
index 564f5f4520..0000000000
--- a/osu.Game/Migrations/20210824185035_AddCountdownSettings.cs
+++ /dev/null
@@ -1,23 +0,0 @@
-using Microsoft.EntityFrameworkCore.Migrations;
-
-namespace osu.Game.Migrations
-{
-    public partial class AddCountdownSettings : Migration
-    {
-        protected override void Up(MigrationBuilder migrationBuilder)
-        {
-            migrationBuilder.AddColumn<int>(
-                name: "CountdownOffset",
-                table: "BeatmapInfo",
-                nullable: false,
-                defaultValue: 0);
-        }
-
-        protected override void Down(MigrationBuilder migrationBuilder)
-        {
-            migrationBuilder.DropColumn(
-                name: "CountdownOffset",
-                table: "BeatmapInfo");
-        }
-    }
-}
diff --git a/osu.Game/Migrations/20210912144011_AddSamplesMatchPlaybackRate.Designer.cs b/osu.Game/Migrations/20210912144011_AddSamplesMatchPlaybackRate.Designer.cs
deleted file mode 100644
index 6e53d7fae0..0000000000
--- a/osu.Game/Migrations/20210912144011_AddSamplesMatchPlaybackRate.Designer.cs
+++ /dev/null
@@ -1,515 +0,0 @@
-// <auto-generated />
-using System;
-using Microsoft.EntityFrameworkCore;
-using Microsoft.EntityFrameworkCore.Infrastructure;
-using Microsoft.EntityFrameworkCore.Migrations;
-using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
-using osu.Game.Database;
-
-namespace osu.Game.Migrations
-{
-    [DbContext(typeof(OsuDbContext))]
-    [Migration("20210912144011_AddSamplesMatchPlaybackRate")]
-    partial class AddSamplesMatchPlaybackRate
-    {
-        protected override void BuildTargetModel(ModelBuilder modelBuilder)
-        {
-#pragma warning disable 612, 618
-            modelBuilder
-                .HasAnnotation("ProductVersion", "2.2.6-servicing-10079");
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapDifficulty", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<float>("ApproachRate");
-
-                    b.Property<float>("CircleSize");
-
-                    b.Property<float>("DrainRate");
-
-                    b.Property<float>("OverallDifficulty");
-
-                    b.Property<double>("SliderMultiplier");
-
-                    b.Property<double>("SliderTickRate");
-
-                    b.HasKey("ID");
-
-                    b.ToTable("BeatmapDifficulty");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<double>("AudioLeadIn");
-
-                    b.Property<double>("BPM");
-
-                    b.Property<int>("BaseDifficultyID");
-
-                    b.Property<int>("BeatDivisor");
-
-                    b.Property<int>("BeatmapSetInfoID");
-
-                    b.Property<int>("Countdown");
-
-                    b.Property<int>("CountdownOffset");
-
-                    b.Property<double>("DistanceSpacing");
-
-                    b.Property<bool>("EpilepsyWarning");
-
-                    b.Property<int>("GridSize");
-
-                    b.Property<string>("Hash");
-
-                    b.Property<bool>("Hidden");
-
-                    b.Property<double>("Length");
-
-                    b.Property<bool>("LetterboxInBreaks");
-
-                    b.Property<string>("MD5Hash");
-
-                    b.Property<int?>("MetadataID");
-
-                    b.Property<int?>("OnlineBeatmapID");
-
-                    b.Property<string>("Path");
-
-                    b.Property<int>("RulesetID");
-
-                    b.Property<bool>("SamplesMatchPlaybackRate");
-
-                    b.Property<bool>("SpecialStyle");
-
-                    b.Property<float>("StackLeniency");
-
-                    b.Property<double>("StarDifficulty");
-
-                    b.Property<int>("Status");
-
-                    b.Property<string>("StoredBookmarks");
-
-                    b.Property<double>("TimelineZoom");
-
-                    b.Property<string>("Version");
-
-                    b.Property<bool>("WidescreenStoryboard");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("BaseDifficultyID");
-
-                    b.HasIndex("BeatmapSetInfoID");
-
-                    b.HasIndex("Hash");
-
-                    b.HasIndex("MD5Hash");
-
-                    b.HasIndex("MetadataID");
-
-                    b.HasIndex("OnlineBeatmapID")
-                        .IsUnique();
-
-                    b.HasIndex("RulesetID");
-
-                    b.ToTable("BeatmapInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapMetadata", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Artist");
-
-                    b.Property<string>("ArtistUnicode");
-
-                    b.Property<string>("AudioFile");
-
-                    b.Property<int>("AuthorID")
-                        .HasColumnName("AuthorID");
-
-                    b.Property<string>("AuthorString")
-                        .HasColumnName("Author");
-
-                    b.Property<string>("BackgroundFile");
-
-                    b.Property<int>("PreviewTime");
-
-                    b.Property<string>("Source");
-
-                    b.Property<string>("Tags");
-
-                    b.Property<string>("Title");
-
-                    b.Property<string>("TitleUnicode");
-
-                    b.HasKey("ID");
-
-                    b.ToTable("BeatmapMetadata");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("BeatmapSetInfoID");
-
-                    b.Property<int>("FileInfoID");
-
-                    b.Property<string>("Filename")
-                        .IsRequired();
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("BeatmapSetInfoID");
-
-                    b.HasIndex("FileInfoID");
-
-                    b.ToTable("BeatmapSetFileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<DateTimeOffset>("DateAdded");
-
-                    b.Property<bool>("DeletePending");
-
-                    b.Property<string>("Hash");
-
-                    b.Property<int?>("MetadataID");
-
-                    b.Property<int?>("OnlineBeatmapSetID");
-
-                    b.Property<bool>("Protected");
-
-                    b.Property<int>("Status");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("DeletePending");
-
-                    b.HasIndex("Hash")
-                        .IsUnique();
-
-                    b.HasIndex("MetadataID");
-
-                    b.HasIndex("OnlineBeatmapSetID")
-                        .IsUnique();
-
-                    b.ToTable("BeatmapSetInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Configuration.DatabasedSetting", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Key")
-                        .HasColumnName("Key");
-
-                    b.Property<int?>("RulesetID");
-
-                    b.Property<int?>("SkinInfoID");
-
-                    b.Property<string>("StringValue")
-                        .HasColumnName("Value");
-
-                    b.Property<int?>("Variant");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("SkinInfoID");
-
-                    b.HasIndex("RulesetID", "Variant");
-
-                    b.ToTable("Settings");
-                });
-
-            modelBuilder.Entity("osu.Game.IO.FileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Hash");
-
-                    b.Property<int>("ReferenceCount");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("Hash")
-                        .IsUnique();
-
-                    b.HasIndex("ReferenceCount");
-
-                    b.ToTable("FileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Input.Bindings.DatabasedKeyBinding", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("IntAction")
-                        .HasColumnName("Action");
-
-                    b.Property<string>("KeysString")
-                        .HasColumnName("Keys");
-
-                    b.Property<int?>("RulesetID");
-
-                    b.Property<int?>("Variant");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("IntAction");
-
-                    b.HasIndex("RulesetID", "Variant");
-
-                    b.ToTable("KeyBinding");
-                });
-
-            modelBuilder.Entity("osu.Game.Rulesets.RulesetInfo", b =>
-                {
-                    b.Property<int?>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<bool>("Available");
-
-                    b.Property<string>("InstantiationInfo");
-
-                    b.Property<string>("Name");
-
-                    b.Property<string>("ShortName");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("Available");
-
-                    b.HasIndex("ShortName")
-                        .IsUnique();
-
-                    b.ToTable("RulesetInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Scoring.ScoreFileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("FileInfoID");
-
-                    b.Property<string>("Filename")
-                        .IsRequired();
-
-                    b.Property<int?>("ScoreInfoID");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("FileInfoID");
-
-                    b.HasIndex("ScoreInfoID");
-
-                    b.ToTable("ScoreFileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Scoring.ScoreInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<double>("Accuracy")
-                        .HasColumnType("DECIMAL(1,4)");
-
-                    b.Property<int>("BeatmapInfoID");
-
-                    b.Property<int>("Combo");
-
-                    b.Property<DateTimeOffset>("Date");
-
-                    b.Property<bool>("DeletePending");
-
-                    b.Property<string>("Hash");
-
-                    b.Property<int>("MaxCombo");
-
-                    b.Property<string>("ModsJson")
-                        .HasColumnName("Mods");
-
-                    b.Property<long?>("OnlineScoreID");
-
-                    b.Property<double?>("PP");
-
-                    b.Property<int>("Rank");
-
-                    b.Property<int>("RulesetID");
-
-                    b.Property<string>("StatisticsJson")
-                        .HasColumnName("Statistics");
-
-                    b.Property<long>("TotalScore");
-
-                    b.Property<int?>("UserID")
-                        .HasColumnName("UserID");
-
-                    b.Property<string>("UserString")
-                        .HasColumnName("User");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("BeatmapInfoID");
-
-                    b.HasIndex("OnlineScoreID")
-                        .IsUnique();
-
-                    b.HasIndex("RulesetID");
-
-                    b.ToTable("ScoreInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Skinning.SkinFileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("FileInfoID");
-
-                    b.Property<string>("Filename")
-                        .IsRequired();
-
-                    b.Property<int>("SkinInfoID");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("FileInfoID");
-
-                    b.HasIndex("SkinInfoID");
-
-                    b.ToTable("SkinFileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Skinning.SkinInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Creator");
-
-                    b.Property<bool>("DeletePending");
-
-                    b.Property<string>("Hash");
-
-                    b.Property<string>("InstantiationInfo");
-
-                    b.Property<string>("Name");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("DeletePending");
-
-                    b.HasIndex("Hash")
-                        .IsUnique();
-
-                    b.ToTable("SkinInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapDifficulty", "BaseDifficulty")
-                        .WithMany()
-                        .HasForeignKey("BaseDifficultyID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo", "BeatmapSet")
-                        .WithMany("Beatmaps")
-                        .HasForeignKey("BeatmapSetInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
-                        .WithMany("Beatmaps")
-                        .HasForeignKey("MetadataID");
-
-                    b.HasOne("osu.Game.Rulesets.RulesetInfo", "Ruleset")
-                        .WithMany()
-                        .HasForeignKey("RulesetID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo")
-                        .WithMany("Files")
-                        .HasForeignKey("BeatmapSetInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
-                        .WithMany()
-                        .HasForeignKey("FileInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
-                        .WithMany("BeatmapSets")
-                        .HasForeignKey("MetadataID");
-                });
-
-            modelBuilder.Entity("osu.Game.Configuration.DatabasedSetting", b =>
-                {
-                    b.HasOne("osu.Game.Skinning.SkinInfo")
-                        .WithMany("Settings")
-                        .HasForeignKey("SkinInfoID");
-                });
-
-            modelBuilder.Entity("osu.Game.Scoring.ScoreFileInfo", b =>
-                {
-                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
-                        .WithMany()
-                        .HasForeignKey("FileInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Scoring.ScoreInfo")
-                        .WithMany("Files")
-                        .HasForeignKey("ScoreInfoID");
-                });
-
-            modelBuilder.Entity("osu.Game.Scoring.ScoreInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapInfo", "Beatmap")
-                        .WithMany("Scores")
-                        .HasForeignKey("BeatmapInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Rulesets.RulesetInfo", "Ruleset")
-                        .WithMany()
-                        .HasForeignKey("RulesetID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-
-            modelBuilder.Entity("osu.Game.Skinning.SkinFileInfo", b =>
-                {
-                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
-                        .WithMany()
-                        .HasForeignKey("FileInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Skinning.SkinInfo")
-                        .WithMany("Files")
-                        .HasForeignKey("SkinInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-#pragma warning restore 612, 618
-        }
-    }
-}
diff --git a/osu.Game/Migrations/20210912144011_AddSamplesMatchPlaybackRate.cs b/osu.Game/Migrations/20210912144011_AddSamplesMatchPlaybackRate.cs
deleted file mode 100644
index bf3f855d5f..0000000000
--- a/osu.Game/Migrations/20210912144011_AddSamplesMatchPlaybackRate.cs
+++ /dev/null
@@ -1,23 +0,0 @@
-using Microsoft.EntityFrameworkCore.Migrations;
-
-namespace osu.Game.Migrations
-{
-    public partial class AddSamplesMatchPlaybackRate : Migration
-    {
-        protected override void Up(MigrationBuilder migrationBuilder)
-        {
-            migrationBuilder.AddColumn<bool>(
-                name: "SamplesMatchPlaybackRate",
-                table: "BeatmapInfo",
-                nullable: false,
-                defaultValue: false);
-        }
-
-        protected override void Down(MigrationBuilder migrationBuilder)
-        {
-            migrationBuilder.DropColumn(
-                name: "SamplesMatchPlaybackRate",
-                table: "BeatmapInfo");
-        }
-    }
-}
diff --git a/osu.Game/Migrations/20211020081609_ResetSkinHashes.cs b/osu.Game/Migrations/20211020081609_ResetSkinHashes.cs
deleted file mode 100644
index 6d53c019ec..0000000000
--- a/osu.Game/Migrations/20211020081609_ResetSkinHashes.cs
+++ /dev/null
@@ -1,23 +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 Microsoft.EntityFrameworkCore.Infrastructure;
-using Microsoft.EntityFrameworkCore.Migrations;
-using osu.Game.Database;
-
-namespace osu.Game.Migrations
-{
-    [DbContext(typeof(OsuDbContext))]
-    [Migration("20211020081609_ResetSkinHashes")]
-    public partial class ResetSkinHashes : Migration
-    {
-        protected override void Up(MigrationBuilder migrationBuilder)
-        {
-            migrationBuilder.Sql($"UPDATE SkinInfo SET Hash = null");
-        }
-
-        protected override void Down(MigrationBuilder migrationBuilder)
-        {
-        }
-    }
-}
diff --git a/osu.Game/Migrations/OsuDbContextModelSnapshot.cs b/osu.Game/Migrations/OsuDbContextModelSnapshot.cs
deleted file mode 100644
index 036c26cb0a..0000000000
--- a/osu.Game/Migrations/OsuDbContextModelSnapshot.cs
+++ /dev/null
@@ -1,513 +0,0 @@
-// <auto-generated />
-using System;
-using Microsoft.EntityFrameworkCore;
-using Microsoft.EntityFrameworkCore.Infrastructure;
-using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
-using osu.Game.Database;
-
-namespace osu.Game.Migrations
-{
-    [DbContext(typeof(OsuDbContext))]
-    partial class OsuDbContextModelSnapshot : ModelSnapshot
-    {
-        protected override void BuildModel(ModelBuilder modelBuilder)
-        {
-#pragma warning disable 612, 618
-            modelBuilder
-                .HasAnnotation("ProductVersion", "2.2.6-servicing-10079");
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapDifficulty", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<float>("ApproachRate");
-
-                    b.Property<float>("CircleSize");
-
-                    b.Property<float>("DrainRate");
-
-                    b.Property<float>("OverallDifficulty");
-
-                    b.Property<double>("SliderMultiplier");
-
-                    b.Property<double>("SliderTickRate");
-
-                    b.HasKey("ID");
-
-                    b.ToTable("BeatmapDifficulty");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<double>("AudioLeadIn");
-
-                    b.Property<double>("BPM");
-
-                    b.Property<int>("BaseDifficultyID");
-
-                    b.Property<int>("BeatDivisor");
-
-                    b.Property<int>("BeatmapSetInfoID");
-
-                    b.Property<int>("Countdown");
-
-                    b.Property<int>("CountdownOffset");
-
-                    b.Property<double>("DistanceSpacing");
-
-                    b.Property<bool>("EpilepsyWarning");
-
-                    b.Property<int>("GridSize");
-
-                    b.Property<string>("Hash");
-
-                    b.Property<bool>("Hidden");
-
-                    b.Property<double>("Length");
-
-                    b.Property<bool>("LetterboxInBreaks");
-
-                    b.Property<string>("MD5Hash");
-
-                    b.Property<int?>("MetadataID");
-
-                    b.Property<int?>("OnlineBeatmapID");
-
-                    b.Property<string>("Path");
-
-                    b.Property<int>("RulesetID");
-
-                    b.Property<bool>("SamplesMatchPlaybackRate");
-
-                    b.Property<bool>("SpecialStyle");
-
-                    b.Property<float>("StackLeniency");
-
-                    b.Property<double>("StarDifficulty");
-
-                    b.Property<int>("Status");
-
-                    b.Property<string>("StoredBookmarks");
-
-                    b.Property<double>("TimelineZoom");
-
-                    b.Property<string>("Version");
-
-                    b.Property<bool>("WidescreenStoryboard");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("BaseDifficultyID");
-
-                    b.HasIndex("BeatmapSetInfoID");
-
-                    b.HasIndex("Hash");
-
-                    b.HasIndex("MD5Hash");
-
-                    b.HasIndex("MetadataID");
-
-                    b.HasIndex("OnlineBeatmapID")
-                        .IsUnique();
-
-                    b.HasIndex("RulesetID");
-
-                    b.ToTable("BeatmapInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapMetadata", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Artist");
-
-                    b.Property<string>("ArtistUnicode");
-
-                    b.Property<string>("AudioFile");
-
-                    b.Property<int>("AuthorID")
-                        .HasColumnName("AuthorID");
-
-                    b.Property<string>("AuthorString")
-                        .HasColumnName("Author");
-
-                    b.Property<string>("BackgroundFile");
-
-                    b.Property<int>("PreviewTime");
-
-                    b.Property<string>("Source");
-
-                    b.Property<string>("Tags");
-
-                    b.Property<string>("Title");
-
-                    b.Property<string>("TitleUnicode");
-
-                    b.HasKey("ID");
-
-                    b.ToTable("BeatmapMetadata");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("BeatmapSetInfoID");
-
-                    b.Property<int>("FileInfoID");
-
-                    b.Property<string>("Filename")
-                        .IsRequired();
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("BeatmapSetInfoID");
-
-                    b.HasIndex("FileInfoID");
-
-                    b.ToTable("BeatmapSetFileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<DateTimeOffset>("DateAdded");
-
-                    b.Property<bool>("DeletePending");
-
-                    b.Property<string>("Hash");
-
-                    b.Property<int?>("MetadataID");
-
-                    b.Property<int?>("OnlineBeatmapSetID");
-
-                    b.Property<bool>("Protected");
-
-                    b.Property<int>("Status");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("DeletePending");
-
-                    b.HasIndex("Hash")
-                        .IsUnique();
-
-                    b.HasIndex("MetadataID");
-
-                    b.HasIndex("OnlineBeatmapSetID")
-                        .IsUnique();
-
-                    b.ToTable("BeatmapSetInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Configuration.DatabasedSetting", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Key")
-                        .HasColumnName("Key");
-
-                    b.Property<int?>("RulesetID");
-
-                    b.Property<int?>("SkinInfoID");
-
-                    b.Property<string>("StringValue")
-                        .HasColumnName("Value");
-
-                    b.Property<int?>("Variant");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("SkinInfoID");
-
-                    b.HasIndex("RulesetID", "Variant");
-
-                    b.ToTable("Settings");
-                });
-
-            modelBuilder.Entity("osu.Game.IO.FileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Hash");
-
-                    b.Property<int>("ReferenceCount");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("Hash")
-                        .IsUnique();
-
-                    b.HasIndex("ReferenceCount");
-
-                    b.ToTable("FileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Input.Bindings.DatabasedKeyBinding", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("IntAction")
-                        .HasColumnName("Action");
-
-                    b.Property<string>("KeysString")
-                        .HasColumnName("Keys");
-
-                    b.Property<int?>("RulesetID");
-
-                    b.Property<int?>("Variant");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("IntAction");
-
-                    b.HasIndex("RulesetID", "Variant");
-
-                    b.ToTable("KeyBinding");
-                });
-
-            modelBuilder.Entity("osu.Game.Rulesets.RulesetInfo", b =>
-                {
-                    b.Property<int?>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<bool>("Available");
-
-                    b.Property<string>("InstantiationInfo");
-
-                    b.Property<string>("Name");
-
-                    b.Property<string>("ShortName");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("Available");
-
-                    b.HasIndex("ShortName")
-                        .IsUnique();
-
-                    b.ToTable("RulesetInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Scoring.ScoreFileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("FileInfoID");
-
-                    b.Property<string>("Filename")
-                        .IsRequired();
-
-                    b.Property<int?>("ScoreInfoID");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("FileInfoID");
-
-                    b.HasIndex("ScoreInfoID");
-
-                    b.ToTable("ScoreFileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Scoring.ScoreInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<double>("Accuracy")
-                        .HasColumnType("DECIMAL(1,4)");
-
-                    b.Property<int>("BeatmapInfoID");
-
-                    b.Property<int>("Combo");
-
-                    b.Property<DateTimeOffset>("Date");
-
-                    b.Property<bool>("DeletePending");
-
-                    b.Property<string>("Hash");
-
-                    b.Property<int>("MaxCombo");
-
-                    b.Property<string>("ModsJson")
-                        .HasColumnName("Mods");
-
-                    b.Property<long?>("OnlineScoreID");
-
-                    b.Property<double?>("PP");
-
-                    b.Property<int>("Rank");
-
-                    b.Property<int>("RulesetID");
-
-                    b.Property<string>("StatisticsJson")
-                        .HasColumnName("Statistics");
-
-                    b.Property<long>("TotalScore");
-
-                    b.Property<int?>("UserID")
-                        .HasColumnName("UserID");
-
-                    b.Property<string>("UserString")
-                        .HasColumnName("User");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("BeatmapInfoID");
-
-                    b.HasIndex("OnlineScoreID")
-                        .IsUnique();
-
-                    b.HasIndex("RulesetID");
-
-                    b.ToTable("ScoreInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Skinning.SkinFileInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("FileInfoID");
-
-                    b.Property<string>("Filename")
-                        .IsRequired();
-
-                    b.Property<int>("SkinInfoID");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("FileInfoID");
-
-                    b.HasIndex("SkinInfoID");
-
-                    b.ToTable("SkinFileInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Skinning.SkinInfo", b =>
-                {
-                    b.Property<int>("ID")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Creator");
-
-                    b.Property<bool>("DeletePending");
-
-                    b.Property<string>("Hash");
-
-                    b.Property<string>("InstantiationInfo");
-
-                    b.Property<string>("Name");
-
-                    b.HasKey("ID");
-
-                    b.HasIndex("DeletePending");
-
-                    b.HasIndex("Hash")
-                        .IsUnique();
-
-                    b.ToTable("SkinInfo");
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapDifficulty", "BaseDifficulty")
-                        .WithMany()
-                        .HasForeignKey("BaseDifficultyID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo", "BeatmapSet")
-                        .WithMany("Beatmaps")
-                        .HasForeignKey("BeatmapSetInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
-                        .WithMany("Beatmaps")
-                        .HasForeignKey("MetadataID");
-
-                    b.HasOne("osu.Game.Rulesets.RulesetInfo", "Ruleset")
-                        .WithMany()
-                        .HasForeignKey("RulesetID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo")
-                        .WithMany("Files")
-                        .HasForeignKey("BeatmapSetInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
-                        .WithMany()
-                        .HasForeignKey("FileInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-
-            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
-                        .WithMany("BeatmapSets")
-                        .HasForeignKey("MetadataID");
-                });
-
-            modelBuilder.Entity("osu.Game.Configuration.DatabasedSetting", b =>
-                {
-                    b.HasOne("osu.Game.Skinning.SkinInfo")
-                        .WithMany("Settings")
-                        .HasForeignKey("SkinInfoID");
-                });
-
-            modelBuilder.Entity("osu.Game.Scoring.ScoreFileInfo", b =>
-                {
-                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
-                        .WithMany()
-                        .HasForeignKey("FileInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Scoring.ScoreInfo")
-                        .WithMany("Files")
-                        .HasForeignKey("ScoreInfoID");
-                });
-
-            modelBuilder.Entity("osu.Game.Scoring.ScoreInfo", b =>
-                {
-                    b.HasOne("osu.Game.Beatmaps.BeatmapInfo", "Beatmap")
-                        .WithMany("Scores")
-                        .HasForeignKey("BeatmapInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Rulesets.RulesetInfo", "Ruleset")
-                        .WithMany()
-                        .HasForeignKey("RulesetID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-
-            modelBuilder.Entity("osu.Game.Skinning.SkinFileInfo", b =>
-                {
-                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
-                        .WithMany()
-                        .HasForeignKey("FileInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-
-                    b.HasOne("osu.Game.Skinning.SkinInfo")
-                        .WithMany("Files")
-                        .HasForeignKey("SkinInfoID")
-                        .OnDelete(DeleteBehavior.Cascade);
-                });
-#pragma warning restore 612, 618
-        }
-    }
-}

From 6ddd2d59d3a2c84eadc13918812b3e14201a45fb Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 18 Jan 2022 20:44:26 +0900
Subject: [PATCH 2292/5547] Remove EF helper methods

---
 osu.Game/Database/EntityFrameworkLive.cs      | 41 -------------------
 .../Database/EntityFrameworkLiveExtensions.cs | 14 -------
 2 files changed, 55 deletions(-)
 delete mode 100644 osu.Game/Database/EntityFrameworkLive.cs
 delete mode 100644 osu.Game/Database/EntityFrameworkLiveExtensions.cs

diff --git a/osu.Game/Database/EntityFrameworkLive.cs b/osu.Game/Database/EntityFrameworkLive.cs
deleted file mode 100644
index 25c0778746..0000000000
--- a/osu.Game/Database/EntityFrameworkLive.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.
-
-using System;
-
-#nullable enable
-
-namespace osu.Game.Database
-{
-    public class EntityFrameworkLive<T> : ILive<T> where T : class
-    {
-        public EntityFrameworkLive(T item)
-        {
-            IsManaged = true; // no way to really know.
-            Value = item;
-        }
-
-        public Guid ID => throw new InvalidOperationException();
-
-        public void PerformRead(Action<T> perform)
-        {
-            perform(Value);
-        }
-
-        public TReturn PerformRead<TReturn>(Func<T, TReturn> perform)
-        {
-            return perform(Value);
-        }
-
-        public void PerformWrite(Action<T> perform)
-        {
-            perform(Value);
-        }
-
-        public bool IsManaged { get; }
-
-        public T Value { get; }
-
-        public bool Equals(ILive<T>? other) => ID == other?.ID;
-    }
-}
diff --git a/osu.Game/Database/EntityFrameworkLiveExtensions.cs b/osu.Game/Database/EntityFrameworkLiveExtensions.cs
deleted file mode 100644
index cd0673675e..0000000000
--- a/osu.Game/Database/EntityFrameworkLiveExtensions.cs
+++ /dev/null
@@ -1,14 +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.Database
-{
-    public static class EntityFrameworkLiveExtensions
-    {
-        public static ILive<T> ToEntityFrameworkLive<T>(this T item)
-            where T : class
-        {
-            return new EntityFrameworkLive<T>(item);
-        }
-    }
-}

From 6b0bf38c93cb994f2c8d144e26d4001e5ad01060 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 18 Jan 2022 20:47:53 +0900
Subject: [PATCH 2293/5547] Use a single EF context to avoid scores getting
 cascade deleted along the way

---
 osu.Game/Database/EFToRealmMigrator.cs | 8 ++------
 1 file changed, 2 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Database/EFToRealmMigrator.cs b/osu.Game/Database/EFToRealmMigrator.cs
index 8f5de80e3b..d479f81ead 100644
--- a/osu.Game/Database/EFToRealmMigrator.cs
+++ b/osu.Game/Database/EFToRealmMigrator.cs
@@ -34,16 +34,12 @@ namespace osu.Game.Database
         public void Run()
         {
             using (var ef = efContextFactory.GetForWrite())
+            {
                 migrateSettings(ef);
-
-            using (var ef = efContextFactory.GetForWrite())
                 migrateSkins(ef);
-
-            using (var ef = efContextFactory.GetForWrite())
                 migrateBeatmaps(ef);
-
-            using (var ef = efContextFactory.GetForWrite())
                 migrateScores(ef);
+            }
 
             // Delete the database permanently.
             // Will cause future startups to not attempt migration.

From 43e5bd731cbfa0fff4d2a0825e10ceaefb56d599 Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Tue, 18 Jan 2022 21:57:12 +0800
Subject: [PATCH 2294/5547] Compare performance to a perfect play

---
 .../Statistics/PerformanceStatistic.cs        | 97 +++++++++++++++++--
 .../Statistics/PerformanceStatisticTooltip.cs | 38 ++++----
 2 files changed, 107 insertions(+), 28 deletions(-)

diff --git a/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatistic.cs b/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatistic.cs
index 4fd6964a68..493f6a2dc9 100644
--- a/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatistic.cs
+++ b/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatistic.cs
@@ -2,19 +2,24 @@
 // 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;
 using osu.Framework.Bindables;
 using osu.Framework.Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Cursor;
+using osu.Game.Beatmaps;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Rulesets.Difficulty;
+using osu.Game.Rulesets.Mods;
+using osu.Game.Rulesets.Scoring;
 using osu.Game.Scoring;
 
 namespace osu.Game.Screens.Ranking.Expanded.Statistics
 {
-    public class PerformanceStatistic : StatisticDisplay, IHasCustomTooltip<PerformanceAttributes>
+    public class PerformanceStatistic : StatisticDisplay, IHasCustomTooltip<PerformanceStatistic.PerformanceBreakdown>
     {
         private readonly ScoreInfo score;
 
@@ -24,6 +29,15 @@ namespace osu.Game.Screens.Ranking.Expanded.Statistics
 
         private RollingCounter<int> counter;
 
+        [Resolved]
+        private ScorePerformanceCache performanceCache { get; set; }
+
+        [Resolved]
+        private BeatmapDifficultyCache difficultyCache { get; set; }
+
+        [Resolved]
+        private BeatmapManager beatmapManager { get; set; }
+
         public PerformanceStatistic(ScoreInfo score)
             : base("PP")
         {
@@ -31,18 +45,74 @@ namespace osu.Game.Screens.Ranking.Expanded.Statistics
         }
 
         [BackgroundDependencyLoader]
-        private void load(ScorePerformanceCache performanceCache)
+        private void load()
         {
-            performanceCache.CalculatePerformanceAsync(score, cancellationTokenSource.Token)
-                            .ContinueWith(t => Schedule(() => setPerformanceValue(t.GetResultSafely())), cancellationTokenSource.Token);
+            Task.WhenAll(
+                // actual performance
+                performanceCache.CalculatePerformanceAsync(score, cancellationTokenSource.Token),
+                // performance for a perfect play
+                getPerfectPerformance(score)
+            ).ContinueWith(attr =>
+            {
+                PerformanceAttributes[] result = attr.GetResultSafely();
+                setPerformanceValue(new PerformanceBreakdown { Performance = result[0], PerfectPerformance = result[1] });
+            });
         }
 
-        private void setPerformanceValue(PerformanceAttributes pp)
+        private async Task<PerformanceAttributes> getPerfectPerformance(ScoreInfo originalScore)
         {
-            if (pp != null)
+            ScoreInfo perfectScore = await getPerfectScore(originalScore).ConfigureAwait(false);
+            return await performanceCache.CalculatePerformanceAsync(perfectScore, cancellationTokenSource.Token).ConfigureAwait(false);
+        }
+
+        private Task<ScoreInfo> getPerfectScore(ScoreInfo originalScore)
+        {
+            return Task.Factory.StartNew(() =>
             {
-                TooltipContent = pp;
-                performance.Value = (int)Math.Round(pp.Total, MidpointRounding.AwayFromZero);
+                var beatmap = beatmapManager.GetWorkingBeatmap(originalScore.BeatmapInfo).GetPlayableBeatmap(originalScore.Ruleset, originalScore.Mods);
+                ScoreInfo perfectPlay = originalScore.DeepClone();
+                perfectPlay.Accuracy = 1;
+                perfectPlay.Passed = true;
+
+                // create statistics assuming all hit objects have perfect hit result
+                var statistics = beatmap.HitObjects
+                                        .Select(ho => ho.CreateJudgement().MaxResult)
+                                        .GroupBy(hr => hr, (hr, list) => (hitResult: hr, count: list.Count()))
+                                        .ToDictionary(pair => pair.hitResult, pair => pair.count);
+                perfectPlay.Statistics = statistics;
+
+                // calculate max combo
+                var difficulty = difficultyCache.GetDifficultyAsync(
+                    beatmap.BeatmapInfo,
+                    originalScore.Ruleset,
+                    originalScore.Mods,
+                    cancellationTokenSource.Token
+                ).GetResultSafely();
+                perfectPlay.MaxCombo = difficulty?.MaxCombo ?? originalScore.MaxCombo;
+
+                // calculate total score
+                ScoreProcessor scoreProcessor = originalScore.Ruleset.CreateInstance().CreateScoreProcessor();
+                perfectPlay.TotalScore = (long)scoreProcessor.GetImmediateScore(ScoringMode.Standardised, perfectPlay.MaxCombo, statistics);
+
+                // compute rank achieved
+                // default to SS, then adjust the rank with mods
+                perfectPlay.Rank = ScoreRank.X;
+
+                foreach (IApplicableToScoreProcessor mod in perfectPlay.Mods.OfType<IApplicableToScoreProcessor>())
+                {
+                    perfectPlay.Rank = mod.AdjustRank(perfectPlay.Rank, 1);
+                }
+
+                return perfectPlay;
+            }, cancellationTokenSource.Token);
+        }
+
+        private void setPerformanceValue(PerformanceBreakdown breakdown)
+        {
+            if (breakdown != null)
+            {
+                TooltipContent = breakdown;
+                performance.Value = (int)Math.Round(breakdown.Performance.Total, MidpointRounding.AwayFromZero);
             }
         }
 
@@ -64,8 +134,15 @@ namespace osu.Game.Screens.Ranking.Expanded.Statistics
             Origin = Anchor.TopCentre
         };
 
-        public ITooltip<PerformanceAttributes> GetCustomTooltip() => new PerformanceStatisticTooltip();
+        public ITooltip<PerformanceBreakdown> GetCustomTooltip() => new PerformanceStatisticTooltip();
 
-        public PerformanceAttributes TooltipContent { get; private set; }
+        public PerformanceBreakdown TooltipContent { get; private set; }
+
+        public class PerformanceBreakdown
+        {
+            public PerformanceAttributes Performance { get; set; }
+
+            public PerformanceAttributes PerfectPerformance { get; set; }
+        }
     }
 }
diff --git a/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatisticTooltip.cs b/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatisticTooltip.cs
index deef30124c..564c195a3d 100644
--- a/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatisticTooltip.cs
+++ b/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatisticTooltip.cs
@@ -1,11 +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.Globalization;
 using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.Color4Extensions;
+using osu.Framework.Extensions.LocalisationExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Cursor;
@@ -19,7 +18,9 @@ using osuTK.Graphics;
 
 namespace osu.Game.Screens.Ranking.Expanded.Statistics
 {
-    public class PerformanceStatisticTooltip : VisibilityContainer, ITooltip<PerformanceAttributes>
+    using static PerformanceStatistic;
+
+    public class PerformanceStatisticTooltip : VisibilityContainer, ITooltip<PerformanceBreakdown>
     {
         private readonly Box background;
         private Colour4 totalColour;
@@ -59,27 +60,30 @@ namespace osu.Game.Screens.Ranking.Expanded.Statistics
         protected override void PopIn()
         {
             // Don't display the tooltip if "Total" is the only item
-            if (lastAttributes.GetAttributesForDisplay().Count() > 1)
+            if (currentPerformance.Performance.GetAttributesForDisplay().Count() > 1)
                 this.FadeIn(200, Easing.OutQuint);
         }
 
         protected override void PopOut() => this.FadeOut(200, Easing.OutQuint);
 
-        private PerformanceAttributes lastAttributes;
+        private PerformanceBreakdown currentPerformance;
 
-        public void SetContent(PerformanceAttributes attributes)
+        public void SetContent(PerformanceBreakdown performance)
         {
-            if (attributes == lastAttributes)
+            if (performance == currentPerformance)
                 return;
 
-            lastAttributes = attributes;
+            currentPerformance = performance;
 
-            UpdateDisplay(attributes);
+            UpdateDisplay(performance);
         }
 
-        private Drawable createAttributeItem(PerformanceDisplayAttribute attribute, double attributeSum)
+        private Drawable createAttributeItem(PerformanceDisplayAttribute attribute, PerformanceDisplayAttribute perfectAttribute)
         {
             bool isTotal = attribute.PropertyName == nameof(PerformanceAttributes.Total);
+            float fraction = (float)(attribute.Value / perfectAttribute.Value);
+            if (float.IsNaN(fraction))
+                fraction = 0;
             return new GridContainer
             {
                 AutoSizeAxes = Axes.Both,
@@ -113,7 +117,7 @@ namespace osu.Game.Screens.Ranking.Expanded.Statistics
                             Width = 130,
                             Height = 5,
                             BackgroundColour = Color4.White.Opacity(0.5f),
-                            Length = (float)(attribute.Value / attributeSum),
+                            Length = fraction,
                             Margin = new MarginPadding { Left = 5, Right = 5 }
                         },
                         new OsuSpriteText
@@ -121,7 +125,7 @@ namespace osu.Game.Screens.Ranking.Expanded.Statistics
                             Origin = Anchor.CentreLeft,
                             Anchor = Anchor.CentreLeft,
                             Font = OsuFont.GetFont(weight: FontWeight.SemiBold),
-                            Text = ((int)Math.Round(attribute.Value, MidpointRounding.AwayFromZero)).ToString(CultureInfo.CurrentCulture),
+                            Text = fraction.ToLocalisableString("0%"),
                             Colour = isTotal ? totalColour : textColour
                         }
                     }
@@ -129,19 +133,17 @@ namespace osu.Game.Screens.Ranking.Expanded.Statistics
             };
         }
 
-        protected virtual void UpdateDisplay(PerformanceAttributes attributes)
+        protected virtual void UpdateDisplay(PerformanceBreakdown performance)
         {
             Content.Clear();
 
-            var displayAttributes = attributes.GetAttributesForDisplay();
+            var displayAttributes = performance.Performance.GetAttributesForDisplay();
 
-            double attributeSum = displayAttributes
-                                  .Where(attr => attr.PropertyName != nameof(PerformanceAttributes.Total))
-                                  .Sum(attr => attr.Value);
+            var perfectDisplayAttributes = performance.PerfectPerformance.GetAttributesForDisplay();
 
             foreach (PerformanceDisplayAttribute attr in displayAttributes)
             {
-                Content.Add(createAttributeItem(attr, attributeSum));
+                Content.Add(createAttributeItem(attr, perfectDisplayAttributes.First(a => a.PropertyName == attr.PropertyName)));
             }
         }
 

From 7f65f3a47f954ee85e2172c35178450ace95b677 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 18 Jan 2022 22:57:39 +0900
Subject: [PATCH 2295/5547] Remove all usage of `BaseDifficulty` (and access
 `Difficulty` instead)

---
 osu.Game.Rulesets.Catch.Tests/TestSceneAutoJuiceStream.cs | 2 +-
 osu.Game.Rulesets.Catch.Tests/TestSceneBananaShower.cs    | 2 +-
 osu.Game.Rulesets.Catch.Tests/TestSceneCatchStacker.cs    | 2 +-
 .../TestSceneDrawableHitObjects.cs                        | 2 +-
 osu.Game.Rulesets.Catch.Tests/TestSceneHyperDash.cs       | 2 +-
 osu.Game.Rulesets.Catch.Tests/TestSceneJuiceStream.cs     | 2 +-
 osu.Game.Rulesets.Mania.Tests/TestSceneHoldNoteInput.cs   | 6 +++---
 osu.Game.Rulesets.Mania/Beatmaps/ManiaBeatmapConverter.cs | 2 +-
 .../Editor/Checks/CheckTooShortSpinnersTest.cs            | 2 +-
 .../Mods/TestSceneOsuModDifficultyAdjust.cs               | 2 +-
 .../TestSceneHitCircleLongCombo.cs                        | 2 +-
 osu.Game.Rulesets.Osu.Tests/TestSceneNoSpinnerStacking.cs | 2 +-
 osu.Game.Rulesets.Osu.Tests/TestSceneSliderInput.cs       | 2 +-
 .../TestSceneStartTimeOrderedHitPolicy.cs                 | 2 +-
 .../DrawableTaikoRulesetTestScene.cs                      | 2 +-
 .../Skinning/TestSceneDrawableTaikoMascot.cs              | 2 +-
 osu.Game.Tests/Beatmaps/Formats/LegacyScoreDecoderTest.cs | 2 +-
 osu.Game.Tests/NonVisual/Filtering/FilterMatchingTest.cs  | 2 +-
 osu.Game.Tests/Resources/TestResources.cs                 | 2 +-
 .../Gameplay/TestSceneGameplaySampleTriggerSource.cs      | 2 +-
 .../Multiplayer/TestSceneMultiplayerMatchSongSelect.cs    | 2 +-
 .../Visual/Navigation/TestScenePresentBeatmap.cs          | 4 ++--
 osu.Game.Tests/Visual/Navigation/TestScenePresentScore.cs | 4 ++--
 .../Visual/SongSelect/TestSceneAdvancedStats.cs           | 4 ++--
 .../Visual/SongSelect/TestSceneBeatmapInfoWedge.cs        | 2 +-
 .../UserInterface/TestSceneModDifficultyAdjustSettings.cs | 2 +-
 osu.Game/Beatmaps/Beatmap.cs                              | 8 ++++----
 osu.Game/Beatmaps/BeatmapInfo.cs                          | 7 -------
 osu.Game/Beatmaps/BeatmapManager.cs                       | 2 +-
 osu.Game/Beatmaps/BeatmapModelManager.cs                  | 2 +-
 osu.Game/Beatmaps/DummyWorkingBeatmap.cs                  | 2 +-
 osu.Game/Rulesets/Mods/DifficultyAdjustSettingsControl.cs | 2 +-
 osu.Game/Screens/Select/Carousel/CarouselBeatmap.cs       | 8 ++++----
 osu.Game/Stores/BeatmapImporter.cs                        | 2 +-
 34 files changed, 44 insertions(+), 51 deletions(-)

diff --git a/osu.Game.Rulesets.Catch.Tests/TestSceneAutoJuiceStream.cs b/osu.Game.Rulesets.Catch.Tests/TestSceneAutoJuiceStream.cs
index f552c3c27b..1014158fc1 100644
--- a/osu.Game.Rulesets.Catch.Tests/TestSceneAutoJuiceStream.cs
+++ b/osu.Game.Rulesets.Catch.Tests/TestSceneAutoJuiceStream.cs
@@ -22,7 +22,7 @@ namespace osu.Game.Rulesets.Catch.Tests
             {
                 BeatmapInfo = new BeatmapInfo
                 {
-                    BaseDifficulty = new BeatmapDifficulty { CircleSize = 6, SliderMultiplier = 3 },
+                    Difficulty = new BeatmapDifficulty { CircleSize = 6, SliderMultiplier = 3 },
                     Ruleset = ruleset
                 }
             };
diff --git a/osu.Game.Rulesets.Catch.Tests/TestSceneBananaShower.cs b/osu.Game.Rulesets.Catch.Tests/TestSceneBananaShower.cs
index e89a95ae37..96ac5c4bf2 100644
--- a/osu.Game.Rulesets.Catch.Tests/TestSceneBananaShower.cs
+++ b/osu.Game.Rulesets.Catch.Tests/TestSceneBananaShower.cs
@@ -22,7 +22,7 @@ namespace osu.Game.Rulesets.Catch.Tests
             {
                 BeatmapInfo = new BeatmapInfo
                 {
-                    BaseDifficulty = new BeatmapDifficulty { CircleSize = 6 },
+                    Difficulty = new BeatmapDifficulty { CircleSize = 6 },
                     Ruleset = ruleset
                 }
             };
diff --git a/osu.Game.Rulesets.Catch.Tests/TestSceneCatchStacker.cs b/osu.Game.Rulesets.Catch.Tests/TestSceneCatchStacker.cs
index 1ff31697b8..0a4ef49e19 100644
--- a/osu.Game.Rulesets.Catch.Tests/TestSceneCatchStacker.cs
+++ b/osu.Game.Rulesets.Catch.Tests/TestSceneCatchStacker.cs
@@ -17,7 +17,7 @@ namespace osu.Game.Rulesets.Catch.Tests
             {
                 BeatmapInfo = new BeatmapInfo
                 {
-                    BaseDifficulty = new BeatmapDifficulty { CircleSize = 6 },
+                    Difficulty = new BeatmapDifficulty { CircleSize = 6 },
                     Ruleset = ruleset
                 }
             };
diff --git a/osu.Game.Rulesets.Catch.Tests/TestSceneDrawableHitObjects.cs b/osu.Game.Rulesets.Catch.Tests/TestSceneDrawableHitObjects.cs
index 23f6222eb6..27196bc30c 100644
--- a/osu.Game.Rulesets.Catch.Tests/TestSceneDrawableHitObjects.cs
+++ b/osu.Game.Rulesets.Catch.Tests/TestSceneDrawableHitObjects.cs
@@ -35,7 +35,7 @@ namespace osu.Game.Rulesets.Catch.Tests
                 HitObjects = new List<HitObject> { new Fruit() },
                 BeatmapInfo = new BeatmapInfo
                 {
-                    BaseDifficulty = new BeatmapDifficulty(),
+                    Difficulty = new BeatmapDifficulty(),
                     Metadata = new BeatmapMetadata
                     {
                         Artist = @"Unknown",
diff --git a/osu.Game.Rulesets.Catch.Tests/TestSceneHyperDash.cs b/osu.Game.Rulesets.Catch.Tests/TestSceneHyperDash.cs
index 163fee49fb..a5b44dc605 100644
--- a/osu.Game.Rulesets.Catch.Tests/TestSceneHyperDash.cs
+++ b/osu.Game.Rulesets.Catch.Tests/TestSceneHyperDash.cs
@@ -63,7 +63,7 @@ namespace osu.Game.Rulesets.Catch.Tests
                 BeatmapInfo =
                 {
                     Ruleset = ruleset,
-                    BaseDifficulty = new BeatmapDifficulty { CircleSize = 3.6f }
+                    Difficulty = new BeatmapDifficulty { CircleSize = 3.6f }
                 }
             };
 
diff --git a/osu.Game.Rulesets.Catch.Tests/TestSceneJuiceStream.cs b/osu.Game.Rulesets.Catch.Tests/TestSceneJuiceStream.cs
index 269e783899..4601234669 100644
--- a/osu.Game.Rulesets.Catch.Tests/TestSceneJuiceStream.cs
+++ b/osu.Game.Rulesets.Catch.Tests/TestSceneJuiceStream.cs
@@ -24,7 +24,7 @@ namespace osu.Game.Rulesets.Catch.Tests
         {
             BeatmapInfo = new BeatmapInfo
             {
-                BaseDifficulty = new BeatmapDifficulty { CircleSize = 5, SliderMultiplier = 2 },
+                Difficulty = new BeatmapDifficulty { CircleSize = 5, SliderMultiplier = 2 },
                 Ruleset = ruleset
             },
             HitObjects = new List<HitObject>
diff --git a/osu.Game.Rulesets.Mania.Tests/TestSceneHoldNoteInput.cs b/osu.Game.Rulesets.Mania.Tests/TestSceneHoldNoteInput.cs
index 4387bc6b3b..f973cb5ed3 100644
--- a/osu.Game.Rulesets.Mania.Tests/TestSceneHoldNoteInput.cs
+++ b/osu.Game.Rulesets.Mania.Tests/TestSceneHoldNoteInput.cs
@@ -264,7 +264,7 @@ namespace osu.Game.Rulesets.Mania.Tests
                 },
                 BeatmapInfo =
                 {
-                    BaseDifficulty = new BeatmapDifficulty
+                    Difficulty = new BeatmapDifficulty
                     {
                         SliderTickRate = 4,
                         OverallDifficulty = 10,
@@ -306,7 +306,7 @@ namespace osu.Game.Rulesets.Mania.Tests
                 },
                 BeatmapInfo =
                 {
-                    BaseDifficulty = new BeatmapDifficulty { SliderTickRate = tick_rate },
+                    Difficulty = new BeatmapDifficulty { SliderTickRate = tick_rate },
                     Ruleset = new ManiaRuleset().RulesetInfo
                 },
             };
@@ -383,7 +383,7 @@ namespace osu.Game.Rulesets.Mania.Tests
                     },
                     BeatmapInfo =
                     {
-                        BaseDifficulty = new BeatmapDifficulty { SliderTickRate = 4 },
+                        Difficulty = new BeatmapDifficulty { SliderTickRate = 4 },
                         Ruleset = new ManiaRuleset().RulesetInfo
                     },
                 };
diff --git a/osu.Game.Rulesets.Mania/Beatmaps/ManiaBeatmapConverter.cs b/osu.Game.Rulesets.Mania/Beatmaps/ManiaBeatmapConverter.cs
index 9d0aaec2ba..47e0e6d7b1 100644
--- a/osu.Game.Rulesets.Mania/Beatmaps/ManiaBeatmapConverter.cs
+++ b/osu.Game.Rulesets.Mania/Beatmaps/ManiaBeatmapConverter.cs
@@ -73,7 +73,7 @@ namespace osu.Game.Rulesets.Mania.Beatmaps
 
         public static int GetColumnCountForNonConvert(BeatmapInfo beatmapInfo)
         {
-            double roundedCircleSize = Math.Round(beatmapInfo.BaseDifficulty.CircleSize);
+            double roundedCircleSize = Math.Round(beatmapInfo.Difficulty.CircleSize);
             return (int)Math.Max(1, roundedCircleSize);
         }
 
diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/Checks/CheckTooShortSpinnersTest.cs b/osu.Game.Rulesets.Osu.Tests/Editor/Checks/CheckTooShortSpinnersTest.cs
index 787807a8ea..1f3d4297f1 100644
--- a/osu.Game.Rulesets.Osu.Tests/Editor/Checks/CheckTooShortSpinnersTest.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Editor/Checks/CheckTooShortSpinnersTest.cs
@@ -107,7 +107,7 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor.Checks
             var beatmap = new Beatmap<HitObject>
             {
                 HitObjects = hitObjects,
-                BeatmapInfo = new BeatmapInfo { BaseDifficulty = new BeatmapDifficulty(beatmapDifficulty) }
+                BeatmapInfo = new BeatmapInfo { Difficulty = new BeatmapDifficulty(beatmapDifficulty) }
             };
 
             return new BeatmapVerifierContext(beatmap, new TestWorkingBeatmap(beatmap));
diff --git a/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModDifficultyAdjust.cs b/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModDifficultyAdjust.cs
index db8546c71b..9d06ff5801 100644
--- a/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModDifficultyAdjust.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModDifficultyAdjust.cs
@@ -26,7 +26,7 @@ namespace osu.Game.Rulesets.Osu.Tests.Mods
             {
                 BeatmapInfo = new BeatmapInfo
                 {
-                    BaseDifficulty = new BeatmapDifficulty
+                    Difficulty = new BeatmapDifficulty
                     {
                         CircleSize = 8
                     }
diff --git a/osu.Game.Rulesets.Osu.Tests/TestSceneHitCircleLongCombo.cs b/osu.Game.Rulesets.Osu.Tests/TestSceneHitCircleLongCombo.cs
index 8cf29ddfbf..4e17c4c363 100644
--- a/osu.Game.Rulesets.Osu.Tests/TestSceneHitCircleLongCombo.cs
+++ b/osu.Game.Rulesets.Osu.Tests/TestSceneHitCircleLongCombo.cs
@@ -17,7 +17,7 @@ namespace osu.Game.Rulesets.Osu.Tests
             {
                 BeatmapInfo = new BeatmapInfo
                 {
-                    BaseDifficulty = new BeatmapDifficulty { CircleSize = 6 },
+                    Difficulty = new BeatmapDifficulty { CircleSize = 6 },
                     Ruleset = ruleset
                 }
             };
diff --git a/osu.Game.Rulesets.Osu.Tests/TestSceneNoSpinnerStacking.cs b/osu.Game.Rulesets.Osu.Tests/TestSceneNoSpinnerStacking.cs
index ef05bcd320..5e92bac986 100644
--- a/osu.Game.Rulesets.Osu.Tests/TestSceneNoSpinnerStacking.cs
+++ b/osu.Game.Rulesets.Osu.Tests/TestSceneNoSpinnerStacking.cs
@@ -17,7 +17,7 @@ namespace osu.Game.Rulesets.Osu.Tests
             {
                 BeatmapInfo = new BeatmapInfo
                 {
-                    BaseDifficulty = new BeatmapDifficulty { OverallDifficulty = 10 },
+                    Difficulty = new BeatmapDifficulty { OverallDifficulty = 10 },
                     Ruleset = ruleset
                 }
             };
diff --git a/osu.Game.Rulesets.Osu.Tests/TestSceneSliderInput.cs b/osu.Game.Rulesets.Osu.Tests/TestSceneSliderInput.cs
index f3392724ec..2368cc7365 100644
--- a/osu.Game.Rulesets.Osu.Tests/TestSceneSliderInput.cs
+++ b/osu.Game.Rulesets.Osu.Tests/TestSceneSliderInput.cs
@@ -358,7 +358,7 @@ namespace osu.Game.Rulesets.Osu.Tests
                     },
                     BeatmapInfo =
                     {
-                        BaseDifficulty = new BeatmapDifficulty { SliderTickRate = 3 },
+                        Difficulty = new BeatmapDifficulty { SliderTickRate = 3 },
                         Ruleset = new OsuRuleset().RulesetInfo
                     },
                 });
diff --git a/osu.Game.Rulesets.Osu.Tests/TestSceneStartTimeOrderedHitPolicy.cs b/osu.Game.Rulesets.Osu.Tests/TestSceneStartTimeOrderedHitPolicy.cs
index 2d43e1b95e..53fa3624b8 100644
--- a/osu.Game.Rulesets.Osu.Tests/TestSceneStartTimeOrderedHitPolicy.cs
+++ b/osu.Game.Rulesets.Osu.Tests/TestSceneStartTimeOrderedHitPolicy.cs
@@ -364,7 +364,7 @@ namespace osu.Game.Rulesets.Osu.Tests
                     HitObjects = hitObjects,
                     BeatmapInfo =
                     {
-                        BaseDifficulty = new BeatmapDifficulty { SliderTickRate = 3 },
+                        Difficulty = new BeatmapDifficulty { SliderTickRate = 3 },
                         Ruleset = new OsuRuleset().RulesetInfo
                     },
                 });
diff --git a/osu.Game.Rulesets.Taiko.Tests/DrawableTaikoRulesetTestScene.cs b/osu.Game.Rulesets.Taiko.Tests/DrawableTaikoRulesetTestScene.cs
index 4bdb85ba60..85d5d6419c 100644
--- a/osu.Game.Rulesets.Taiko.Tests/DrawableTaikoRulesetTestScene.cs
+++ b/osu.Game.Rulesets.Taiko.Tests/DrawableTaikoRulesetTestScene.cs
@@ -32,7 +32,7 @@ namespace osu.Game.Rulesets.Taiko.Tests
                 HitObjects = new List<HitObject> { new Hit { Type = HitType.Centre } },
                 BeatmapInfo = new BeatmapInfo
                 {
-                    BaseDifficulty = new BeatmapDifficulty(),
+                    Difficulty = new BeatmapDifficulty(),
                     Metadata = new BeatmapMetadata
                     {
                         Artist = @"Unknown",
diff --git a/osu.Game.Rulesets.Taiko.Tests/Skinning/TestSceneDrawableTaikoMascot.cs b/osu.Game.Rulesets.Taiko.Tests/Skinning/TestSceneDrawableTaikoMascot.cs
index b976735223..ffdf0f725d 100644
--- a/osu.Game.Rulesets.Taiko.Tests/Skinning/TestSceneDrawableTaikoMascot.cs
+++ b/osu.Game.Rulesets.Taiko.Tests/Skinning/TestSceneDrawableTaikoMascot.cs
@@ -158,7 +158,7 @@ namespace osu.Game.Rulesets.Taiko.Tests.Skinning
                 HitObjects = new List<HitObject> { new Hit { Type = HitType.Centre } },
                 BeatmapInfo = new BeatmapInfo
                 {
-                    BaseDifficulty = new BeatmapDifficulty(),
+                    Difficulty = new BeatmapDifficulty(),
                     Metadata = new BeatmapMetadata
                     {
                         Artist = "Unknown",
diff --git a/osu.Game.Tests/Beatmaps/Formats/LegacyScoreDecoderTest.cs b/osu.Game.Tests/Beatmaps/Formats/LegacyScoreDecoderTest.cs
index 9ac7838821..3d4b05b52b 100644
--- a/osu.Game.Tests/Beatmaps/Formats/LegacyScoreDecoderTest.cs
+++ b/osu.Game.Tests/Beatmaps/Formats/LegacyScoreDecoderTest.cs
@@ -128,7 +128,7 @@ namespace osu.Game.Tests.Beatmaps.Formats
                 {
                     MD5Hash = md5Hash,
                     Ruleset = new OsuRuleset().RulesetInfo,
-                    BaseDifficulty = new BeatmapDifficulty()
+                    Difficulty = new BeatmapDifficulty()
                 }
             });
         }
diff --git a/osu.Game.Tests/NonVisual/Filtering/FilterMatchingTest.cs b/osu.Game.Tests/NonVisual/Filtering/FilterMatchingTest.cs
index 3d78043c73..fa4c4bee8e 100644
--- a/osu.Game.Tests/NonVisual/Filtering/FilterMatchingTest.cs
+++ b/osu.Game.Tests/NonVisual/Filtering/FilterMatchingTest.cs
@@ -18,7 +18,7 @@ namespace osu.Game.Tests.NonVisual.Filtering
         {
             Ruleset = new RulesetInfo { OnlineID = 0 },
             StarRating = 4.0d,
-            BaseDifficulty = new BeatmapDifficulty
+            Difficulty = new BeatmapDifficulty
             {
                 ApproachRate = 5.0f,
                 DrainRate = 3.0f,
diff --git a/osu.Game.Tests/Resources/TestResources.cs b/osu.Game.Tests/Resources/TestResources.cs
index 1d99a5c20d..4c8b943279 100644
--- a/osu.Game.Tests/Resources/TestResources.cs
+++ b/osu.Game.Tests/Resources/TestResources.cs
@@ -133,7 +133,7 @@ namespace osu.Game.Tests.Resources
                         Hash = Guid.NewGuid().ToString().ComputeMD5Hash(),
                         Ruleset = rulesetInfo,
                         Metadata = metadata,
-                        BaseDifficulty = new BeatmapDifficulty
+                        Difficulty = new BeatmapDifficulty
                         {
                             OverallDifficulty = diff,
                         }
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneGameplaySampleTriggerSource.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneGameplaySampleTriggerSource.cs
index fccc1a377c..ac39395567 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneGameplaySampleTriggerSource.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneGameplaySampleTriggerSource.cs
@@ -29,7 +29,7 @@ namespace osu.Game.Tests.Visual.Gameplay
             {
                 BeatmapInfo = new BeatmapInfo
                 {
-                    BaseDifficulty = new BeatmapDifficulty { CircleSize = 6, SliderMultiplier = 3 },
+                    Difficulty = new BeatmapDifficulty { CircleSize = 6, SliderMultiplier = 3 },
                     Ruleset = ruleset
                 }
             };
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs
index 181b0c71f2..34b9485002 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs
@@ -76,7 +76,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     Length = length,
                     BPM = bpm,
                     Metadata = metadata,
-                    BaseDifficulty = new BeatmapDifficulty()
+                    Difficulty = new BeatmapDifficulty()
                 };
 
                 beatmaps.Add(beatmap);
diff --git a/osu.Game.Tests/Visual/Navigation/TestScenePresentBeatmap.cs b/osu.Game.Tests/Visual/Navigation/TestScenePresentBeatmap.cs
index 69b30ec6a0..606d3f929a 100644
--- a/osu.Game.Tests/Visual/Navigation/TestScenePresentBeatmap.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestScenePresentBeatmap.cs
@@ -114,14 +114,14 @@ namespace osu.Game.Tests.Visual.Navigation
                         {
                             OnlineID = i * 1024,
                             Metadata = metadata,
-                            BaseDifficulty = new BeatmapDifficulty(),
+                            Difficulty = new BeatmapDifficulty(),
                             Ruleset = ruleset ?? new OsuRuleset().RulesetInfo
                         },
                         new BeatmapInfo
                         {
                             OnlineID = i * 2048,
                             Metadata = metadata,
-                            BaseDifficulty = new BeatmapDifficulty(),
+                            Difficulty = new BeatmapDifficulty(),
                             Ruleset = ruleset ?? new OsuRuleset().RulesetInfo
                         },
                     }
diff --git a/osu.Game.Tests/Visual/Navigation/TestScenePresentScore.cs b/osu.Game.Tests/Visual/Navigation/TestScenePresentScore.cs
index f9649db135..3e354d5188 100644
--- a/osu.Game.Tests/Visual/Navigation/TestScenePresentScore.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestScenePresentScore.cs
@@ -44,7 +44,7 @@ namespace osu.Game.Tests.Visual.Navigation
                                 AuthorString = "SomeAuthor",
                                 Title = "import"
                             },
-                            BaseDifficulty = new BeatmapDifficulty(),
+                            Difficulty = new BeatmapDifficulty(),
                             Ruleset = new OsuRuleset().RulesetInfo
                         },
                         new BeatmapInfo
@@ -56,7 +56,7 @@ namespace osu.Game.Tests.Visual.Navigation
                                 AuthorString = "SomeAuthor",
                                 Title = "import"
                             },
-                            BaseDifficulty = new BeatmapDifficulty(),
+                            Difficulty = new BeatmapDifficulty(),
                             Ruleset = new OsuRuleset().RulesetInfo
                         },
                     }
diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneAdvancedStats.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneAdvancedStats.cs
index bc3e8553f7..7ceae0a69b 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneAdvancedStats.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneAdvancedStats.cs
@@ -38,7 +38,7 @@ namespace osu.Game.Tests.Visual.SongSelect
         private BeatmapInfo exampleBeatmapInfo => new BeatmapInfo
         {
             Ruleset = rulesets.AvailableRulesets.First(),
-            BaseDifficulty = new BeatmapDifficulty
+            Difficulty = new BeatmapDifficulty
             {
                 CircleSize = 7.2f,
                 DrainRate = 3,
@@ -68,7 +68,7 @@ namespace osu.Game.Tests.Visual.SongSelect
             AddStep("set beatmap", () => advancedStats.BeatmapInfo = new BeatmapInfo
             {
                 Ruleset = rulesets.GetRuleset(3) ?? throw new InvalidOperationException(),
-                BaseDifficulty = new BeatmapDifficulty
+                Difficulty = new BeatmapDifficulty
                 {
                     CircleSize = 5,
                     DrainRate = 4.3f,
diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapInfoWedge.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapInfoWedge.cs
index 9ad5242df4..3d65efc059 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapInfoWedge.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapInfoWedge.cs
@@ -216,7 +216,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                     Ruleset = ruleset,
                     StarRating = 6,
                     DifficultyName = $"{ruleset.ShortName}Version",
-                    BaseDifficulty = new BeatmapDifficulty()
+                    Difficulty = new BeatmapDifficulty()
                 },
                 HitObjects = objects
             };
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneModDifficultyAdjustSettings.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneModDifficultyAdjustSettings.cs
index f8652573f4..8e1f426f7b 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneModDifficultyAdjustSettings.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneModDifficultyAdjustSettings.cs
@@ -267,7 +267,7 @@ namespace osu.Game.Tests.Visual.UserInterface
             {
                 BeatmapInfo = new BeatmapInfo
                 {
-                    BaseDifficulty = new BeatmapDifficulty
+                    Difficulty = new BeatmapDifficulty
                     {
                         OverallDifficulty = value,
                         CircleSize = value,
diff --git a/osu.Game/Beatmaps/Beatmap.cs b/osu.Game/Beatmaps/Beatmap.cs
index ccecd69d21..69a86f4928 100644
--- a/osu.Game/Beatmaps/Beatmap.cs
+++ b/osu.Game/Beatmaps/Beatmap.cs
@@ -28,7 +28,7 @@ namespace osu.Game.Beatmaps
                 difficulty = value;
 
                 if (beatmapInfo != null)
-                    beatmapInfo.BaseDifficulty = difficulty.Clone();
+                    beatmapInfo.Difficulty = difficulty.Clone();
             }
         }
 
@@ -41,8 +41,8 @@ namespace osu.Game.Beatmaps
             {
                 beatmapInfo = value;
 
-                if (beatmapInfo?.BaseDifficulty != null)
-                    Difficulty = beatmapInfo.BaseDifficulty.Clone();
+                if (beatmapInfo?.Difficulty != null)
+                    Difficulty = beatmapInfo.Difficulty.Clone();
             }
         }
 
@@ -57,7 +57,7 @@ namespace osu.Game.Beatmaps
                     AuthorString = @"Unknown Creator",
                 },
                 DifficultyName = @"Normal",
-                BaseDifficulty = Difficulty,
+                Difficulty = Difficulty,
             };
         }
 
diff --git a/osu.Game/Beatmaps/BeatmapInfo.cs b/osu.Game/Beatmaps/BeatmapInfo.cs
index b0e10c2c38..b91f05cd11 100644
--- a/osu.Game/Beatmaps/BeatmapInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapInfo.cs
@@ -165,13 +165,6 @@ namespace osu.Game.Beatmaps
             }
         }
 
-        [Ignored]
-        public BeatmapDifficulty BaseDifficulty
-        {
-            get => Difficulty;
-            set => Difficulty = value;
-        }
-
         [Ignored]
         public string? Path => File?.Filename;
 
diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index f901b0fbc1..564f15361d 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -93,7 +93,7 @@ namespace osu.Game.Beatmaps
                 {
                     new BeatmapInfo
                     {
-                        BaseDifficulty = new BeatmapDifficulty(),
+                        Difficulty = new BeatmapDifficulty(),
                         Ruleset = ruleset,
                         Metadata = metadata,
                         WidescreenStoryboard = true,
diff --git a/osu.Game/Beatmaps/BeatmapModelManager.cs b/osu.Game/Beatmaps/BeatmapModelManager.cs
index 73ada09ef6..3822c6e121 100644
--- a/osu.Game/Beatmaps/BeatmapModelManager.cs
+++ b/osu.Game/Beatmaps/BeatmapModelManager.cs
@@ -58,7 +58,7 @@ namespace osu.Game.Beatmaps
             // Warning: The directionality here is important. Changes have to be copied *from* beatmapContent (which comes from editor and is being saved)
             // *to* the beatmapInfo (which is a database model and needs to receive values without the taiko slider velocity multiplier for correct operation).
             // CopyTo() will undo such adjustments, while CopyFrom() will not.
-            beatmapContent.Difficulty.CopyTo(beatmapInfo.BaseDifficulty);
+            beatmapContent.Difficulty.CopyTo(beatmapInfo.Difficulty);
 
             // All changes to metadata are made in the provided beatmapInfo, so this should be copied to the `IBeatmap` before encoding.
             beatmapContent.BeatmapInfo = beatmapInfo;
diff --git a/osu.Game/Beatmaps/DummyWorkingBeatmap.cs b/osu.Game/Beatmaps/DummyWorkingBeatmap.cs
index 9ea8517764..6e879d09d5 100644
--- a/osu.Game/Beatmaps/DummyWorkingBeatmap.cs
+++ b/osu.Game/Beatmaps/DummyWorkingBeatmap.cs
@@ -32,7 +32,7 @@ namespace osu.Game.Beatmaps
                     Title = "no beatmaps available!"
                 },
                 BeatmapSet = new BeatmapSetInfo(),
-                BaseDifficulty = new BeatmapDifficulty
+                Difficulty = new BeatmapDifficulty
                 {
                     DrainRate = 0,
                     CircleSize = 0,
diff --git a/osu.Game/Rulesets/Mods/DifficultyAdjustSettingsControl.cs b/osu.Game/Rulesets/Mods/DifficultyAdjustSettingsControl.cs
index 5d7565e56b..45873a321a 100644
--- a/osu.Game/Rulesets/Mods/DifficultyAdjustSettingsControl.cs
+++ b/osu.Game/Rulesets/Mods/DifficultyAdjustSettingsControl.cs
@@ -74,7 +74,7 @@ namespace osu.Game.Rulesets.Mods
                 return;
             }
 
-            var difficulty = beatmap.Value.BeatmapInfo.BaseDifficulty;
+            var difficulty = beatmap.Value.BeatmapInfo.Difficulty;
 
             // generally should always be implemented, else the slider will have a zero default.
             if (difficultyBindable.ReadCurrentFromDifficulty == null)
diff --git a/osu.Game/Screens/Select/Carousel/CarouselBeatmap.cs b/osu.Game/Screens/Select/Carousel/CarouselBeatmap.cs
index d2c7c75da8..d54a3bb54e 100644
--- a/osu.Game/Screens/Select/Carousel/CarouselBeatmap.cs
+++ b/osu.Game/Screens/Select/Carousel/CarouselBeatmap.cs
@@ -39,10 +39,10 @@ namespace osu.Game.Screens.Select.Carousel
             }
 
             match &= !criteria.StarDifficulty.HasFilter || criteria.StarDifficulty.IsInRange(BeatmapInfo.StarRating);
-            match &= !criteria.ApproachRate.HasFilter || criteria.ApproachRate.IsInRange(BeatmapInfo.BaseDifficulty.ApproachRate);
-            match &= !criteria.DrainRate.HasFilter || criteria.DrainRate.IsInRange(BeatmapInfo.BaseDifficulty.DrainRate);
-            match &= !criteria.CircleSize.HasFilter || criteria.CircleSize.IsInRange(BeatmapInfo.BaseDifficulty.CircleSize);
-            match &= !criteria.OverallDifficulty.HasFilter || criteria.OverallDifficulty.IsInRange(BeatmapInfo.BaseDifficulty.OverallDifficulty);
+            match &= !criteria.ApproachRate.HasFilter || criteria.ApproachRate.IsInRange(BeatmapInfo.Difficulty.ApproachRate);
+            match &= !criteria.DrainRate.HasFilter || criteria.DrainRate.IsInRange(BeatmapInfo.Difficulty.DrainRate);
+            match &= !criteria.CircleSize.HasFilter || criteria.CircleSize.IsInRange(BeatmapInfo.Difficulty.CircleSize);
+            match &= !criteria.OverallDifficulty.HasFilter || criteria.OverallDifficulty.IsInRange(BeatmapInfo.Difficulty.OverallDifficulty);
             match &= !criteria.Length.HasFilter || criteria.Length.IsInRange(BeatmapInfo.Length);
             match &= !criteria.BPM.HasFilter || criteria.BPM.IsInRange(BeatmapInfo.BPM);
 
diff --git a/osu.Game/Stores/BeatmapImporter.cs b/osu.Game/Stores/BeatmapImporter.cs
index 5303bd6fba..d285a6b61c 100644
--- a/osu.Game/Stores/BeatmapImporter.cs
+++ b/osu.Game/Stores/BeatmapImporter.cs
@@ -218,7 +218,7 @@ namespace osu.Game.Stores
                     }
 
                     var decodedInfo = decoded.BeatmapInfo;
-                    var decodedDifficulty = decodedInfo.BaseDifficulty;
+                    var decodedDifficulty = decodedInfo.Difficulty;
 
                     var ruleset = realm.All<RulesetInfo>().FirstOrDefault(r => r.OnlineID == decodedInfo.RulesetID);
 

From a5b53c01c813a94fadadd5f3102990f0aece2137 Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Tue, 18 Jan 2022 21:59:51 +0800
Subject: [PATCH 2296/5547] Add comments and tidy up

---
 .../Ranking/Expanded/Statistics/PerformanceStatistic.cs   | 6 ++++++
 .../Expanded/Statistics/PerformanceStatisticTooltip.cs    | 8 ++++----
 2 files changed, 10 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatistic.cs b/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatistic.cs
index 493f6a2dc9..f00eb9d71f 100644
--- a/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatistic.cs
+++ b/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatistic.cs
@@ -140,8 +140,14 @@ namespace osu.Game.Screens.Ranking.Expanded.Statistics
 
         public class PerformanceBreakdown
         {
+            /// <summary>
+            /// Actual gameplay performance.
+            /// </summary>
             public PerformanceAttributes Performance { get; set; }
 
+            /// <summary>
+            /// Performance of a perfect play for comparison.
+            /// </summary>
             public PerformanceAttributes PerfectPerformance { get; set; }
         }
     }
diff --git a/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatisticTooltip.cs b/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatisticTooltip.cs
index 564c195a3d..7209db53f6 100644
--- a/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatisticTooltip.cs
+++ b/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatisticTooltip.cs
@@ -23,7 +23,7 @@ namespace osu.Game.Screens.Ranking.Expanded.Statistics
     public class PerformanceStatisticTooltip : VisibilityContainer, ITooltip<PerformanceBreakdown>
     {
         private readonly Box background;
-        private Colour4 totalColour;
+        private Colour4 titleColor;
         private Colour4 textColour;
 
         protected override Container<Drawable> Content { get; }
@@ -53,7 +53,7 @@ namespace osu.Game.Screens.Ranking.Expanded.Statistics
         private void load(OsuColour colours)
         {
             background.Colour = colours.Gray3;
-            totalColour = colours.Blue;
+            titleColor = colours.Blue;
             textColour = colours.BlueLighter;
         }
 
@@ -107,7 +107,7 @@ namespace osu.Game.Screens.Ranking.Expanded.Statistics
                             Anchor = Anchor.CentreLeft,
                             Font = OsuFont.GetFont(weight: FontWeight.Regular),
                             Text = attribute.DisplayName,
-                            Colour = isTotal ? totalColour : textColour
+                            Colour = isTotal ? titleColor : textColour
                         },
                         new Bar
                         {
@@ -126,7 +126,7 @@ namespace osu.Game.Screens.Ranking.Expanded.Statistics
                             Anchor = Anchor.CentreLeft,
                             Font = OsuFont.GetFont(weight: FontWeight.SemiBold),
                             Text = fraction.ToLocalisableString("0%"),
-                            Colour = isTotal ? totalColour : textColour
+                            Colour = isTotal ? titleColor : textColour
                         }
                     }
                 }

From 31e03e99cd08f1bfd3c648461a6c17e959b0495a Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Tue, 18 Jan 2022 22:11:43 +0800
Subject: [PATCH 2297/5547] Improve display of "total PP"

---
 osu.Game/Rulesets/Difficulty/PerformanceAttributes.cs  |  2 +-
 .../Expanded/Statistics/PerformanceStatisticTooltip.cs | 10 ++++++++--
 2 files changed, 9 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Rulesets/Difficulty/PerformanceAttributes.cs b/osu.Game/Rulesets/Difficulty/PerformanceAttributes.cs
index 9bdb5f8f6f..f210c669a6 100644
--- a/osu.Game/Rulesets/Difficulty/PerformanceAttributes.cs
+++ b/osu.Game/Rulesets/Difficulty/PerformanceAttributes.cs
@@ -21,7 +21,7 @@ namespace osu.Game.Rulesets.Difficulty
         /// <returns></returns>
         public virtual IEnumerable<PerformanceDisplayAttribute> GetAttributesForDisplay()
         {
-            yield return new PerformanceDisplayAttribute(nameof(Total), "Total", Total);
+            yield return new PerformanceDisplayAttribute(nameof(Total), "Final PP", Total);
         }
     }
 }
diff --git a/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatisticTooltip.cs b/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatisticTooltip.cs
index 7209db53f6..528ccafd41 100644
--- a/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatisticTooltip.cs
+++ b/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatisticTooltip.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 osu.Framework.Allocation;
 using osu.Framework.Extensions.Color4Extensions;
@@ -84,6 +85,11 @@ namespace osu.Game.Screens.Ranking.Expanded.Statistics
             float fraction = (float)(attribute.Value / perfectAttribute.Value);
             if (float.IsNaN(fraction))
                 fraction = 0;
+            string text = fraction.ToLocalisableString("0%").ToString();
+
+            if (isTotal)
+                text = (int)Math.Round(attribute.Value, MidpointRounding.AwayFromZero) + "/" + (int)Math.Round(perfectAttribute.Value, MidpointRounding.AwayFromZero);
+
             return new GridContainer
             {
                 AutoSizeAxes = Axes.Both,
@@ -111,12 +117,12 @@ namespace osu.Game.Screens.Ranking.Expanded.Statistics
                         },
                         new Bar
                         {
-                            Alpha = isTotal ? 0 : 1,
                             Origin = Anchor.CentreLeft,
                             Anchor = Anchor.CentreLeft,
                             Width = 130,
                             Height = 5,
                             BackgroundColour = Color4.White.Opacity(0.5f),
+                            Colour = isTotal ? titleColor : textColour,
                             Length = fraction,
                             Margin = new MarginPadding { Left = 5, Right = 5 }
                         },
@@ -125,7 +131,7 @@ namespace osu.Game.Screens.Ranking.Expanded.Statistics
                             Origin = Anchor.CentreLeft,
                             Anchor = Anchor.CentreLeft,
                             Font = OsuFont.GetFont(weight: FontWeight.SemiBold),
-                            Text = fraction.ToLocalisableString("0%"),
+                            Text = text,
                             Colour = isTotal ? titleColor : textColour
                         }
                     }

From 3596c6ed5d59707c08296ff0ddbc08200a557659 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 18 Jan 2022 23:25:30 +0900
Subject: [PATCH 2298/5547] Add some missing `IgnoredAttributes` to reduce
 automapper overhead

---
 osu.Game/Beatmaps/BeatmapInfo.cs     | 1 +
 osu.Game/Beatmaps/BeatmapMetadata.cs | 1 +
 osu.Game/Beatmaps/BeatmapSetInfo.cs  | 1 +
 3 files changed, 3 insertions(+)

diff --git a/osu.Game/Beatmaps/BeatmapInfo.cs b/osu.Game/Beatmaps/BeatmapInfo.cs
index b0e10c2c38..9ad9e9b1c9 100644
--- a/osu.Game/Beatmaps/BeatmapInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapInfo.cs
@@ -64,6 +64,7 @@ namespace osu.Game.Beatmaps
         [Ignored]
         public RealmNamedFileUsage? File => BeatmapSet?.Files.FirstOrDefault(f => f.File.Hash == Hash);
 
+        [Ignored]
         public BeatmapOnlineStatus Status
         {
             get => (BeatmapOnlineStatus)StatusInt;
diff --git a/osu.Game/Beatmaps/BeatmapMetadata.cs b/osu.Game/Beatmaps/BeatmapMetadata.cs
index 6349476550..89f507581b 100644
--- a/osu.Game/Beatmaps/BeatmapMetadata.cs
+++ b/osu.Game/Beatmaps/BeatmapMetadata.cs
@@ -47,6 +47,7 @@ namespace osu.Game.Beatmaps
 
         #region Compatibility properties
 
+        [Ignored]
         public string AuthorString
         {
             get => Author.Username;
diff --git a/osu.Game/Beatmaps/BeatmapSetInfo.cs b/osu.Game/Beatmaps/BeatmapSetInfo.cs
index f6ca184ea3..a934d1a2e3 100644
--- a/osu.Game/Beatmaps/BeatmapSetInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapSetInfo.cs
@@ -32,6 +32,7 @@ namespace osu.Game.Beatmaps
 
         public IList<RealmNamedFileUsage> Files { get; } = null!;
 
+        [Ignored]
         public BeatmapOnlineStatus Status
         {
             get => (BeatmapOnlineStatus)StatusInt;

From 67bf95bc91d8cda84cd53b1f521ebc8b1e78c7e1 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 18 Jan 2022 23:30:40 +0900
Subject: [PATCH 2299/5547] Remove all usage of `AuthorString`

---
 .../TestSceneDrawableHitObjects.cs                    |  2 +-
 .../DrawableTaikoRulesetTestScene.cs                  |  2 +-
 .../Skinning/TestSceneDrawableTaikoMascot.cs          |  2 +-
 .../NonVisual/Filtering/FilterMatchingTest.cs         |  2 +-
 osu.Game.Tests/Resources/TestResources.cs             |  2 +-
 .../TestSceneMultiplayerMatchSongSelect.cs            |  2 +-
 .../Visual/Navigation/TestScenePresentBeatmap.cs      |  2 +-
 .../Visual/Navigation/TestScenePresentScore.cs        |  4 ++--
 .../Visual/SongSelect/TestSceneBeatmapCarousel.cs     |  2 +-
 .../Visual/SongSelect/TestSceneBeatmapInfoWedge.cs    |  4 ++--
 osu.Game/Beatmaps/Beatmap.cs                          |  2 +-
 osu.Game/Beatmaps/BeatmapMetadata.cs                  | 11 -----------
 osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs     |  2 +-
 osu.Game/Database/EFToRealmMigrator.cs                |  1 -
 osu.Game/Screens/Edit/Setup/MetadataSection.cs        |  2 +-
 15 files changed, 15 insertions(+), 27 deletions(-)

diff --git a/osu.Game.Rulesets.Catch.Tests/TestSceneDrawableHitObjects.cs b/osu.Game.Rulesets.Catch.Tests/TestSceneDrawableHitObjects.cs
index 23f6222eb6..f078a4353d 100644
--- a/osu.Game.Rulesets.Catch.Tests/TestSceneDrawableHitObjects.cs
+++ b/osu.Game.Rulesets.Catch.Tests/TestSceneDrawableHitObjects.cs
@@ -40,7 +40,7 @@ namespace osu.Game.Rulesets.Catch.Tests
                     {
                         Artist = @"Unknown",
                         Title = @"You're breathtaking",
-                        AuthorString = @"Everyone",
+                        Author = { Username = @"Everyone" },
                     },
                     Ruleset = new CatchRuleset().RulesetInfo
                 },
diff --git a/osu.Game.Rulesets.Taiko.Tests/DrawableTaikoRulesetTestScene.cs b/osu.Game.Rulesets.Taiko.Tests/DrawableTaikoRulesetTestScene.cs
index 4bdb85ba60..54bc6f1912 100644
--- a/osu.Game.Rulesets.Taiko.Tests/DrawableTaikoRulesetTestScene.cs
+++ b/osu.Game.Rulesets.Taiko.Tests/DrawableTaikoRulesetTestScene.cs
@@ -37,7 +37,7 @@ namespace osu.Game.Rulesets.Taiko.Tests
                     {
                         Artist = @"Unknown",
                         Title = @"Sample Beatmap",
-                        AuthorString = @"peppy",
+                        Author = { Username = @"peppy" },
                     },
                     Ruleset = new TaikoRuleset().RulesetInfo
                 },
diff --git a/osu.Game.Rulesets.Taiko.Tests/Skinning/TestSceneDrawableTaikoMascot.cs b/osu.Game.Rulesets.Taiko.Tests/Skinning/TestSceneDrawableTaikoMascot.cs
index b976735223..e73fb6bb1f 100644
--- a/osu.Game.Rulesets.Taiko.Tests/Skinning/TestSceneDrawableTaikoMascot.cs
+++ b/osu.Game.Rulesets.Taiko.Tests/Skinning/TestSceneDrawableTaikoMascot.cs
@@ -163,7 +163,7 @@ namespace osu.Game.Rulesets.Taiko.Tests.Skinning
                     {
                         Artist = "Unknown",
                         Title = "Sample Beatmap",
-                        AuthorString = "Craftplacer",
+                        Author = { Username = "Craftplacer" },
                     },
                     Ruleset = new TaikoRuleset().RulesetInfo
                 },
diff --git a/osu.Game.Tests/NonVisual/Filtering/FilterMatchingTest.cs b/osu.Game.Tests/NonVisual/Filtering/FilterMatchingTest.cs
index 3d78043c73..7ac26699a5 100644
--- a/osu.Game.Tests/NonVisual/Filtering/FilterMatchingTest.cs
+++ b/osu.Game.Tests/NonVisual/Filtering/FilterMatchingTest.cs
@@ -30,7 +30,7 @@ namespace osu.Game.Tests.NonVisual.Filtering
                 ArtistUnicode = "check unicode too",
                 Title = "Title goes here",
                 TitleUnicode = "Title goes here",
-                AuthorString = "The Author",
+                Author = { Username = "The Author" },
                 Source = "unit tests",
                 Tags = "look for tags too",
             },
diff --git a/osu.Game.Tests/Resources/TestResources.cs b/osu.Game.Tests/Resources/TestResources.cs
index 1d99a5c20d..e1da31abcb 100644
--- a/osu.Game.Tests/Resources/TestResources.cs
+++ b/osu.Game.Tests/Resources/TestResources.cs
@@ -89,7 +89,7 @@ namespace osu.Game.Tests.Resources
                 // Create random metadata, then we can check if sorting works based on these
                 Artist = "Some Artist " + RNG.Next(0, 9),
                 Title = $"Some Song (set id {setId}) {Guid.NewGuid()}",
-                AuthorString = "Some Guy " + RNG.Next(0, 9),
+                Author = { Username = "Some Guy " + RNG.Next(0, 9) },
             };
 
             var beatmapSet = new BeatmapSetInfo
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs
index 181b0c71f2..ae7705b97d 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs
@@ -52,7 +52,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             {
                 Artist = "Some Artist",
                 Title = "Some Beatmap",
-                AuthorString = "Some Author"
+                Author = { Username = "Some Author" },
             };
 
             var beatmapSetInfo = new BeatmapSetInfo
diff --git a/osu.Game.Tests/Visual/Navigation/TestScenePresentBeatmap.cs b/osu.Game.Tests/Visual/Navigation/TestScenePresentBeatmap.cs
index 69b30ec6a0..1b82094603 100644
--- a/osu.Game.Tests/Visual/Navigation/TestScenePresentBeatmap.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestScenePresentBeatmap.cs
@@ -100,7 +100,7 @@ namespace osu.Game.Tests.Visual.Navigation
                 var metadata = new BeatmapMetadata
                 {
                     Artist = "SomeArtist",
-                    AuthorString = "SomeAuthor",
+                    Author = { Username = "SomeAuthor" },
                     Title = $"import {i}"
                 };
 
diff --git a/osu.Game.Tests/Visual/Navigation/TestScenePresentScore.cs b/osu.Game.Tests/Visual/Navigation/TestScenePresentScore.cs
index f9649db135..b8e49d155e 100644
--- a/osu.Game.Tests/Visual/Navigation/TestScenePresentScore.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestScenePresentScore.cs
@@ -41,7 +41,7 @@ namespace osu.Game.Tests.Visual.Navigation
                             Metadata = new BeatmapMetadata
                             {
                                 Artist = "SomeArtist",
-                                AuthorString = "SomeAuthor",
+                                Author = { Username = "SomeAuthor" },
                                 Title = "import"
                             },
                             BaseDifficulty = new BeatmapDifficulty(),
@@ -53,7 +53,7 @@ namespace osu.Game.Tests.Visual.Navigation
                             Metadata = new BeatmapMetadata
                             {
                                 Artist = "SomeArtist",
-                                AuthorString = "SomeAuthor",
+                                Author = { Username = "SomeAuthor" },
                                 Title = "import"
                             },
                             BaseDifficulty = new BeatmapDifficulty(),
diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs
index 0f5bea10e8..0298c3bea9 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs
@@ -409,7 +409,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                     set.Beatmaps.ForEach(b => b.Metadata.Artist = zzz_string);
 
                 if (i == 16)
-                    set.Beatmaps.ForEach(b => b.Metadata.AuthorString = zzz_string);
+                    set.Beatmaps.ForEach(b => b.Metadata.Author.Username = zzz_string);
 
                 sets.Add(set);
             }
diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapInfoWedge.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapInfoWedge.cs
index 9ad5242df4..efacc395f1 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapInfoWedge.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapInfoWedge.cs
@@ -208,7 +208,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                 {
                     Metadata = new BeatmapMetadata
                     {
-                        AuthorString = $"{ruleset.ShortName}Author",
+                        Author = { Username = $"{ruleset.ShortName}Author" },
                         Artist = $"{ruleset.ShortName}Artist",
                         Source = $"{ruleset.ShortName}Source",
                         Title = $"{ruleset.ShortName}Title"
@@ -230,7 +230,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                 {
                     Metadata = new BeatmapMetadata
                     {
-                        AuthorString = "WWWWWWWWWWWWWWW",
+                        Author = { Username = "WWWWWWWWWWWWWWW" },
                         Artist = "Verrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrry long Artist",
                         Source = "Verrrrry long Source",
                         Title = "Verrrrry long Title"
diff --git a/osu.Game/Beatmaps/Beatmap.cs b/osu.Game/Beatmaps/Beatmap.cs
index ccecd69d21..a9eb7da5c9 100644
--- a/osu.Game/Beatmaps/Beatmap.cs
+++ b/osu.Game/Beatmaps/Beatmap.cs
@@ -54,7 +54,7 @@ namespace osu.Game.Beatmaps
                 {
                     Artist = @"Unknown",
                     Title = @"Unknown",
-                    AuthorString = @"Unknown Creator",
+                    Author = { Username = @"Unknown Creator" },
                 },
                 DifficultyName = @"Normal",
                 BaseDifficulty = Difficulty,
diff --git a/osu.Game/Beatmaps/BeatmapMetadata.cs b/osu.Game/Beatmaps/BeatmapMetadata.cs
index 89f507581b..a3385e3abe 100644
--- a/osu.Game/Beatmaps/BeatmapMetadata.cs
+++ b/osu.Game/Beatmaps/BeatmapMetadata.cs
@@ -45,17 +45,6 @@ namespace osu.Game.Beatmaps
 
         IUser IBeatmapMetadataInfo.Author => Author;
 
-        #region Compatibility properties
-
-        [Ignored]
-        public string AuthorString
-        {
-            get => Author.Username;
-            set => Author.Username = value;
-        }
-
-        #endregion
-
         public override string ToString() => this.GetDisplayTitle();
     }
 }
diff --git a/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs b/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
index e5db9d045a..893eb8ab78 100644
--- a/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
+++ b/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
@@ -251,7 +251,7 @@ namespace osu.Game.Beatmaps.Formats
                     break;
 
                 case @"Creator":
-                    metadata.AuthorString = pair.Value;
+                    metadata.Author.Username = pair.Value;
                     break;
 
                 case @"Version":
diff --git a/osu.Game/Database/EFToRealmMigrator.cs b/osu.Game/Database/EFToRealmMigrator.cs
index 7683accc5c..bd7a7677f2 100644
--- a/osu.Game/Database/EFToRealmMigrator.cs
+++ b/osu.Game/Database/EFToRealmMigrator.cs
@@ -144,7 +144,6 @@ namespace osu.Game.Database
                 PreviewTime = metadata.PreviewTime,
                 AudioFile = metadata.AudioFile,
                 BackgroundFile = metadata.BackgroundFile,
-                AuthorString = metadata.AuthorString,
             };
         }
 
diff --git a/osu.Game/Screens/Edit/Setup/MetadataSection.cs b/osu.Game/Screens/Edit/Setup/MetadataSection.cs
index 0d2b093a2e..f0ca3e1bbc 100644
--- a/osu.Game/Screens/Edit/Setup/MetadataSection.cs
+++ b/osu.Game/Screens/Edit/Setup/MetadataSection.cs
@@ -110,7 +110,7 @@ namespace osu.Game.Screens.Edit.Setup
             Beatmap.Metadata.TitleUnicode = TitleTextBox.Current.Value;
             Beatmap.Metadata.Title = RomanisedTitleTextBox.Current.Value;
 
-            Beatmap.Metadata.AuthorString = creatorTextBox.Current.Value;
+            Beatmap.Metadata.Author.Username = creatorTextBox.Current.Value;
             Beatmap.BeatmapInfo.DifficultyName = difficultyTextBox.Current.Value;
             Beatmap.Metadata.Source = sourceTextBox.Current.Value;
             Beatmap.Metadata.Tags = tagsTextBox.Current.Value;

From f2b151023eb32294fb00171e45a13ab332bd08f2 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 19 Jan 2022 00:03:19 +0900
Subject: [PATCH 2300/5547] Create separate automapper configurations to reduce
 cyclic detach overhead

This optimises the `BeatmapSetInfo` detach operation by avoiding
detaching `BeatmapSetInfo.Beatmaps[].BeatmapSetInfo` a second time over.
---
 osu.Game/Database/RealmObjectExtensions.cs | 67 +++++++++++++++-------
 1 file changed, 45 insertions(+), 22 deletions(-)

diff --git a/osu.Game/Database/RealmObjectExtensions.cs b/osu.Game/Database/RealmObjectExtensions.cs
index 4ddf0077ca..5ab7154486 100644
--- a/osu.Game/Database/RealmObjectExtensions.cs
+++ b/osu.Game/Database/RealmObjectExtensions.cs
@@ -74,21 +74,10 @@ namespace osu.Game.Database
 
         private static readonly IMapper mapper = new MapperConfiguration(c =>
         {
-            c.ShouldMapField = fi => false;
+            applyCommonConfiguration(c);
 
-            // This is specifically to avoid mapping explicit interface implementations.
-            // If we want to limit this further, we can avoid mapping properties with no setter that are not IList<>.
-            // Takes a bit of effort to determine whether this is the case though, see https://stackoverflow.com/questions/951536/how-do-i-tell-whether-a-type-implements-ilist
-            c.ShouldMapProperty = pi => pi.GetMethod?.IsPublic == true;
-
-            c.CreateMap<RealmKeyBinding, RealmKeyBinding>();
-            c.CreateMap<BeatmapMetadata, BeatmapMetadata>();
-            c.CreateMap<BeatmapDifficulty, BeatmapDifficulty>();
-            c.CreateMap<RulesetInfo, RulesetInfo>();
-            c.CreateMap<ScoreInfo, ScoreInfo>();
-            c.CreateMap<RealmUser, RealmUser>();
-            c.CreateMap<RealmFile, RealmFile>();
-            c.CreateMap<RealmNamedFileUsage, RealmNamedFileUsage>();
+            // This can be further optimised to reduce cyclic retrievals, similar to the optimised set mapper below.
+            // Only hasn't been done yet as we detach at the point of BeatmapInfo less often.
             c.CreateMap<BeatmapInfo, BeatmapInfo>()
              .MaxDepth(2)
              .AfterMap((s, d) =>
@@ -102,13 +91,28 @@ namespace osu.Game.Database
                      }
                  }
              });
-            c.CreateMap<BeatmapSetInfo, BeatmapSetInfo>()
-             .MaxDepth(2)
-             .AfterMap((s, d) =>
-             {
-                 foreach (var beatmap in d.Beatmaps)
-                     beatmap.BeatmapSet = d;
-             });
+        }).CreateMapper();
+
+        /// <summary>
+        /// A slightly optimised mapper that avoids double-fetches in cyclic reference.
+        /// </summary>
+        private static readonly IMapper beatmap_set_mapper = new MapperConfiguration(c =>
+        {
+            applyCommonConfiguration(c);
+
+            c.CreateMap<BeatmapInfo, BeatmapInfo>()
+             .MaxDepth(1)
+             .ForMember(b => b.BeatmapSet, cc => cc.Ignore());
+        }).CreateMapper();
+
+        private static void applyCommonConfiguration(IMapperConfigurationExpression c)
+        {
+            c.ShouldMapField = fi => false;
+
+            // This is specifically to avoid mapping explicit interface implementations.
+            // If we want to limit this further, we can avoid mapping properties with no setter that are not IList<>.
+            // Takes a bit of effort to determine whether this is the case though, see https://stackoverflow.com/questions/951536/how-do-i-tell-whether-a-type-implements-ilist
+            c.ShouldMapProperty = pi => pi.GetMethod?.IsPublic == true;
 
             c.Internal().ForAllMaps((typeMap, expression) =>
             {
@@ -118,7 +122,23 @@ namespace osu.Game.Database
                         m.Ignore();
                 });
             });
-        }).CreateMapper();
+
+            c.CreateMap<RealmKeyBinding, RealmKeyBinding>();
+            c.CreateMap<BeatmapMetadata, BeatmapMetadata>();
+            c.CreateMap<BeatmapDifficulty, BeatmapDifficulty>();
+            c.CreateMap<RulesetInfo, RulesetInfo>();
+            c.CreateMap<ScoreInfo, ScoreInfo>();
+            c.CreateMap<RealmUser, RealmUser>();
+            c.CreateMap<RealmFile, RealmFile>();
+            c.CreateMap<RealmNamedFileUsage, RealmNamedFileUsage>();
+            c.CreateMap<BeatmapSetInfo, BeatmapSetInfo>()
+             .MaxDepth(2)
+             .AfterMap((s, d) =>
+             {
+                 foreach (var beatmap in d.Beatmaps)
+                     beatmap.BeatmapSet = d;
+             });
+        }
 
         /// <summary>
         /// Create a detached copy of the each item in the collection.
@@ -153,6 +173,9 @@ namespace osu.Game.Database
             if (!item.IsManaged)
                 return item;
 
+            if (item is BeatmapSetInfo)
+                return beatmap_set_mapper.Map<T>(item);
+
             return mapper.Map<T>(item);
         }
 

From 60b80c88b60b356abc0ab3e27ef9b09817b34b30 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 19 Jan 2022 00:49:16 +0900
Subject: [PATCH 2301/5547] Avoid file retrieval overhead when detaching
 `BeatmapSetInfo`

It seems that no usages of `BeatmapSetInfo` detaches require files - a
`WorkingBeatmap` is always obtained before doing further lookups.

Therefore we can omit this include unless the detaching object is a
`BeatmapInfo`. A refetch is performed when retrieving a
`WorkingBeatmap` to complete the equation.
---
 osu.Game/Beatmaps/BeatmapManager.cs        | 18 +++++++++++++++-
 osu.Game/Database/RealmObjectExtensions.cs | 24 +++++++++++++++-------
 2 files changed, 34 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index f901b0fbc1..d983c087a0 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -299,7 +299,23 @@ namespace osu.Game.Beatmaps
 
         #region Implementation of IWorkingBeatmapCache
 
-        public WorkingBeatmap GetWorkingBeatmap(BeatmapInfo? importedBeatmap) => workingBeatmapCache.GetWorkingBeatmap(importedBeatmap);
+        public WorkingBeatmap GetWorkingBeatmap(BeatmapInfo? importedBeatmap)
+        {
+            // Detached sets don't come with files.
+            // If we seem to be missing files, now is a good time to re-fetch.
+            if (importedBeatmap?.BeatmapSet?.Files.Count == 0)
+            {
+                using (var realm = contextFactory.CreateContext())
+                {
+                    var refetch = realm.Find<BeatmapInfo>(importedBeatmap.ID)?.Detach();
+
+                    if (refetch != null)
+                        importedBeatmap = refetch;
+                }
+            }
+
+            return workingBeatmapCache.GetWorkingBeatmap(importedBeatmap);
+        }
 
         public WorkingBeatmap GetWorkingBeatmap(ILive<BeatmapInfo>? importedBeatmap)
         {
diff --git a/osu.Game/Database/RealmObjectExtensions.cs b/osu.Game/Database/RealmObjectExtensions.cs
index 5ab7154486..140f41c5d8 100644
--- a/osu.Game/Database/RealmObjectExtensions.cs
+++ b/osu.Game/Database/RealmObjectExtensions.cs
@@ -76,6 +76,14 @@ namespace osu.Game.Database
         {
             applyCommonConfiguration(c);
 
+            c.CreateMap<BeatmapSetInfo, BeatmapSetInfo>()
+             .MaxDepth(2)
+             .AfterMap((s, d) =>
+             {
+                 foreach (var beatmap in d.Beatmaps)
+                     beatmap.BeatmapSet = d;
+             });
+
             // This can be further optimised to reduce cyclic retrievals, similar to the optimised set mapper below.
             // Only hasn't been done yet as we detach at the point of BeatmapInfo less often.
             c.CreateMap<BeatmapInfo, BeatmapInfo>()
@@ -100,6 +108,15 @@ namespace osu.Game.Database
         {
             applyCommonConfiguration(c);
 
+            c.CreateMap<BeatmapSetInfo, BeatmapSetInfo>()
+             .MaxDepth(2)
+             .ForMember(b => b.Files, cc => cc.Ignore())
+             .AfterMap((s, d) =>
+             {
+                 foreach (var beatmap in d.Beatmaps)
+                     beatmap.BeatmapSet = d;
+             });
+
             c.CreateMap<BeatmapInfo, BeatmapInfo>()
              .MaxDepth(1)
              .ForMember(b => b.BeatmapSet, cc => cc.Ignore());
@@ -131,13 +148,6 @@ namespace osu.Game.Database
             c.CreateMap<RealmUser, RealmUser>();
             c.CreateMap<RealmFile, RealmFile>();
             c.CreateMap<RealmNamedFileUsage, RealmNamedFileUsage>();
-            c.CreateMap<BeatmapSetInfo, BeatmapSetInfo>()
-             .MaxDepth(2)
-             .AfterMap((s, d) =>
-             {
-                 foreach (var beatmap in d.Beatmaps)
-                     beatmap.BeatmapSet = d;
-             });
         }
 
         /// <summary>

From 1db2135d7022f16c58f4131c1ffaec6494002be0 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 19 Jan 2022 01:05:22 +0900
Subject: [PATCH 2302/5547] Update tests to match new behaviour

---
 osu.Game.Tests/Database/BeatmapImporterTests.cs | 16 +++++++++-------
 1 file changed, 9 insertions(+), 7 deletions(-)

diff --git a/osu.Game.Tests/Database/BeatmapImporterTests.cs b/osu.Game.Tests/Database/BeatmapImporterTests.cs
index 1bba73bea0..227314cffd 100644
--- a/osu.Game.Tests/Database/BeatmapImporterTests.cs
+++ b/osu.Game.Tests/Database/BeatmapImporterTests.cs
@@ -57,8 +57,9 @@ namespace osu.Game.Tests.Database
                     {
                         detachedBeatmapSet = live.Detach();
 
-                        Assert.AreEqual(live.Files.Count, detachedBeatmapSet.Files.Count);
-                        Assert.AreEqual(live.Files.Select(f => f.File).Count(), detachedBeatmapSet.Files.Select(f => f.File).Count());
+                        // files are omitted
+                        Assert.AreEqual(0, detachedBeatmapSet.Files.Count);
+
                         Assert.AreEqual(live.Beatmaps.Count, detachedBeatmapSet.Beatmaps.Count);
                         Assert.AreEqual(live.Beatmaps.Select(f => f.Difficulty).Count(), detachedBeatmapSet.Beatmaps.Select(f => f.Difficulty).Count());
                         Assert.AreEqual(live.Metadata, detachedBeatmapSet.Metadata);
@@ -67,11 +68,9 @@ namespace osu.Game.Tests.Database
                     Debug.Assert(detachedBeatmapSet != null);
 
                     // Check detached instances can all be accessed without throwing.
-                    Assert.NotNull(detachedBeatmapSet.Files.Count);
-                    Assert.NotZero(detachedBeatmapSet.Files.Select(f => f.File).Count());
+                    Assert.AreEqual(0, detachedBeatmapSet.Files.Count);
                     Assert.NotNull(detachedBeatmapSet.Beatmaps.Count);
                     Assert.NotZero(detachedBeatmapSet.Beatmaps.Select(f => f.Difficulty).Count());
-                    Assert.NotNull(detachedBeatmapSet.Beatmaps.First().Path);
                     Assert.NotNull(detachedBeatmapSet.Metadata);
 
                     // Check cyclic reference to beatmap set
@@ -96,9 +95,12 @@ namespace osu.Game.Tests.Database
                     Assert.NotNull(beatmapSet);
                     Debug.Assert(beatmapSet != null);
 
-                    BeatmapSetInfo? detachedBeatmapSet = null;
+                    // Detach at the BeatmapInfo point, similar to what GetWorkingBeatmap does.
+                    BeatmapInfo? detachedBeatmap = null;
 
-                    beatmapSet.PerformRead(s => detachedBeatmapSet = s.Detach());
+                    beatmapSet.PerformRead(s => detachedBeatmap = s.Beatmaps.First().Detach());
+
+                    BeatmapSetInfo? detachedBeatmapSet = detachedBeatmap?.BeatmapSet;
 
                     Debug.Assert(detachedBeatmapSet != null);
 

From 96d07e20edad425dd505fc70ec216f7c8160b2ab Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 19 Jan 2022 02:17:43 +0900
Subject: [PATCH 2303/5547] Revert nunit test adaptor version bump until
 console output bug is resolved

Tests have started to output too much log content, causing viewing CI
failures to be painfully impossible. Roll back for now.

Fix may be related to
https://github.com/nunit/nunit3-vs-adapter/issues/941, although we don't
use filter.
---
 .../osu.Game.Rulesets.EmptyFreeform.Tests.csproj                | 2 +-
 .../osu.Game.Rulesets.Pippidon.Tests.csproj                     | 2 +-
 .../osu.Game.Rulesets.EmptyScrolling.Tests.csproj               | 2 +-
 .../osu.Game.Rulesets.Pippidon.Tests.csproj                     | 2 +-
 osu.Game.Benchmarks/osu.Game.Benchmarks.csproj                  | 2 +-
 .../osu.Game.Rulesets.Catch.Tests.csproj                        | 2 +-
 .../osu.Game.Rulesets.Mania.Tests.csproj                        | 2 +-
 osu.Game.Rulesets.Osu.Tests/osu.Game.Rulesets.Osu.Tests.csproj  | 2 +-
 .../osu.Game.Rulesets.Taiko.Tests.csproj                        | 2 +-
 osu.Game.Tests/osu.Game.Tests.csproj                            | 2 +-
 osu.Game.Tournament.Tests/osu.Game.Tournament.Tests.csproj      | 2 +-
 11 files changed, 11 insertions(+), 11 deletions(-)

diff --git a/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform.Tests/osu.Game.Rulesets.EmptyFreeform.Tests.csproj b/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform.Tests/osu.Game.Rulesets.EmptyFreeform.Tests.csproj
index a7078f1c09..3c6aaa39ca 100644
--- a/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform.Tests/osu.Game.Rulesets.EmptyFreeform.Tests.csproj
+++ b/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform.Tests/osu.Game.Rulesets.EmptyFreeform.Tests.csproj
@@ -12,7 +12,7 @@
     <PackageReference Include="Appveyor.TestLogger" Version="2.0.0" />
     <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.0.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
-    <PackageReference Include="NUnit3TestAdapter" Version="4.2.0" />
+    <PackageReference Include="NUnit3TestAdapter" Version="4.1.0" />
     <PackageReference Update="Microsoft.EntityFrameworkCore.Sqlite" Version="2.1.4" />
   </ItemGroup>
   <ItemGroup>
diff --git a/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon.Tests/osu.Game.Rulesets.Pippidon.Tests.csproj b/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon.Tests/osu.Game.Rulesets.Pippidon.Tests.csproj
index c133b0e3f8..0719dd30df 100644
--- a/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon.Tests/osu.Game.Rulesets.Pippidon.Tests.csproj
+++ b/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon.Tests/osu.Game.Rulesets.Pippidon.Tests.csproj
@@ -12,7 +12,7 @@
     <PackageReference Include="Appveyor.TestLogger" Version="2.0.0" />
     <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.0.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
-    <PackageReference Include="NUnit3TestAdapter" Version="4.2.0" />
+    <PackageReference Include="NUnit3TestAdapter" Version="4.1.0" />
     <PackageReference Update="Microsoft.EntityFrameworkCore.Sqlite" Version="2.1.4" />
   </ItemGroup>
   <ItemGroup>
diff --git a/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling.Tests/osu.Game.Rulesets.EmptyScrolling.Tests.csproj b/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling.Tests/osu.Game.Rulesets.EmptyScrolling.Tests.csproj
index 92b48470e8..d0db43cc81 100644
--- a/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling.Tests/osu.Game.Rulesets.EmptyScrolling.Tests.csproj
+++ b/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling.Tests/osu.Game.Rulesets.EmptyScrolling.Tests.csproj
@@ -12,7 +12,7 @@
     <PackageReference Include="Appveyor.TestLogger" Version="2.0.0" />
     <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.0.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
-    <PackageReference Include="NUnit3TestAdapter" Version="4.2.0" />
+    <PackageReference Include="NUnit3TestAdapter" Version="4.1.0" />
     <PackageReference Update="Microsoft.EntityFrameworkCore.Sqlite" Version="2.1.4" />
   </ItemGroup>
   <ItemGroup>
diff --git a/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon.Tests/osu.Game.Rulesets.Pippidon.Tests.csproj b/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon.Tests/osu.Game.Rulesets.Pippidon.Tests.csproj
index c133b0e3f8..0719dd30df 100644
--- a/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon.Tests/osu.Game.Rulesets.Pippidon.Tests.csproj
+++ b/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon.Tests/osu.Game.Rulesets.Pippidon.Tests.csproj
@@ -12,7 +12,7 @@
     <PackageReference Include="Appveyor.TestLogger" Version="2.0.0" />
     <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.0.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
-    <PackageReference Include="NUnit3TestAdapter" Version="4.2.0" />
+    <PackageReference Include="NUnit3TestAdapter" Version="4.1.0" />
     <PackageReference Update="Microsoft.EntityFrameworkCore.Sqlite" Version="2.1.4" />
   </ItemGroup>
   <ItemGroup>
diff --git a/osu.Game.Benchmarks/osu.Game.Benchmarks.csproj b/osu.Game.Benchmarks/osu.Game.Benchmarks.csproj
index a8599f2cb6..57b914bee6 100644
--- a/osu.Game.Benchmarks/osu.Game.Benchmarks.csproj
+++ b/osu.Game.Benchmarks/osu.Game.Benchmarks.csproj
@@ -9,7 +9,7 @@
   <ItemGroup>
     <PackageReference Include="BenchmarkDotNet" Version="0.13.1" />
     <PackageReference Include="nunit" Version="3.13.2" />
-    <PackageReference Include="NUnit3TestAdapter" Version="4.2.0" />
+    <PackageReference Include="NUnit3TestAdapter" Version="4.1.0" />
   </ItemGroup>
 
   <ItemGroup>
diff --git a/osu.Game.Rulesets.Catch.Tests/osu.Game.Rulesets.Catch.Tests.csproj b/osu.Game.Rulesets.Catch.Tests/osu.Game.Rulesets.Catch.Tests.csproj
index d5496b7479..13f2e25f05 100644
--- a/osu.Game.Rulesets.Catch.Tests/osu.Game.Rulesets.Catch.Tests.csproj
+++ b/osu.Game.Rulesets.Catch.Tests/osu.Game.Rulesets.Catch.Tests.csproj
@@ -4,7 +4,7 @@
     <PackageReference Include="Appveyor.TestLogger" Version="2.0.0" />
     <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.0.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
-    <PackageReference Include="NUnit3TestAdapter" Version="4.2.0" />
+    <PackageReference Include="NUnit3TestAdapter" Version="4.1.0" />
     <PackageReference Update="Microsoft.EntityFrameworkCore.Sqlite" Version="2.1.4" />
   </ItemGroup>
   <PropertyGroup Label="Project">
diff --git a/osu.Game.Rulesets.Mania.Tests/osu.Game.Rulesets.Mania.Tests.csproj b/osu.Game.Rulesets.Mania.Tests/osu.Game.Rulesets.Mania.Tests.csproj
index 2f12b1535e..d51a6da4f9 100644
--- a/osu.Game.Rulesets.Mania.Tests/osu.Game.Rulesets.Mania.Tests.csproj
+++ b/osu.Game.Rulesets.Mania.Tests/osu.Game.Rulesets.Mania.Tests.csproj
@@ -4,7 +4,7 @@
     <PackageReference Include="Appveyor.TestLogger" Version="2.0.0" />
     <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.0.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
-    <PackageReference Include="NUnit3TestAdapter" Version="4.2.0" />
+    <PackageReference Include="NUnit3TestAdapter" Version="4.1.0" />
     <PackageReference Update="Microsoft.EntityFrameworkCore.Sqlite" Version="2.1.4" />
   </ItemGroup>
   <PropertyGroup Label="Project">
diff --git a/osu.Game.Rulesets.Osu.Tests/osu.Game.Rulesets.Osu.Tests.csproj b/osu.Game.Rulesets.Osu.Tests/osu.Game.Rulesets.Osu.Tests.csproj
index e5b2e070d8..fea2e408f6 100644
--- a/osu.Game.Rulesets.Osu.Tests/osu.Game.Rulesets.Osu.Tests.csproj
+++ b/osu.Game.Rulesets.Osu.Tests/osu.Game.Rulesets.Osu.Tests.csproj
@@ -5,7 +5,7 @@
     <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.0.0" />
     <PackageReference Include="Moq" Version="4.16.1" />
     <PackageReference Include="NUnit" Version="3.13.2" />
-    <PackageReference Include="NUnit3TestAdapter" Version="4.2.0" />
+    <PackageReference Include="NUnit3TestAdapter" Version="4.1.0" />
     <PackageReference Update="Microsoft.EntityFrameworkCore.Sqlite" Version="2.1.4" />
   </ItemGroup>
   <PropertyGroup Label="Project">
diff --git a/osu.Game.Rulesets.Taiko.Tests/osu.Game.Rulesets.Taiko.Tests.csproj b/osu.Game.Rulesets.Taiko.Tests/osu.Game.Rulesets.Taiko.Tests.csproj
index e48d80323a..ad3713e047 100644
--- a/osu.Game.Rulesets.Taiko.Tests/osu.Game.Rulesets.Taiko.Tests.csproj
+++ b/osu.Game.Rulesets.Taiko.Tests/osu.Game.Rulesets.Taiko.Tests.csproj
@@ -4,7 +4,7 @@
     <PackageReference Include="Appveyor.TestLogger" Version="2.0.0" />
     <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.0.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
-    <PackageReference Include="NUnit3TestAdapter" Version="4.2.0" />
+    <PackageReference Include="NUnit3TestAdapter" Version="4.1.0" />
     <PackageReference Update="Microsoft.EntityFrameworkCore.Sqlite" Version="2.1.4" />
   </ItemGroup>
   <PropertyGroup Label="Project">
diff --git a/osu.Game.Tests/osu.Game.Tests.csproj b/osu.Game.Tests/osu.Game.Tests.csproj
index c64ef918e3..3b115d43e5 100644
--- a/osu.Game.Tests/osu.Game.Tests.csproj
+++ b/osu.Game.Tests/osu.Game.Tests.csproj
@@ -6,7 +6,7 @@
     <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.0.0" />
     <PackageReference Include="Nito.AsyncEx" Version="5.1.2" />
     <PackageReference Include="NUnit" Version="3.13.2" />
-    <PackageReference Include="NUnit3TestAdapter" Version="4.2.0" />
+    <PackageReference Include="NUnit3TestAdapter" Version="4.1.0" />
     <PackageReference Update="Microsoft.EntityFrameworkCore.Sqlite" Version="2.1.4" />
     <PackageReference Include="Moq" Version="4.16.1" />
   </ItemGroup>
diff --git a/osu.Game.Tournament.Tests/osu.Game.Tournament.Tests.csproj b/osu.Game.Tournament.Tests/osu.Game.Tournament.Tests.csproj
index fb09a7be1e..130fcfaca1 100644
--- a/osu.Game.Tournament.Tests/osu.Game.Tournament.Tests.csproj
+++ b/osu.Game.Tournament.Tests/osu.Game.Tournament.Tests.csproj
@@ -7,7 +7,7 @@
     <PackageReference Include="Appveyor.TestLogger" Version="2.0.0" />
     <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.0.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
-    <PackageReference Include="NUnit3TestAdapter" Version="4.2.0" />
+    <PackageReference Include="NUnit3TestAdapter" Version="4.1.0" />
   </ItemGroup>
   <PropertyGroup Label="Project">
     <OutputType>WinExe</OutputType>

From 761e161eec0d774aaae10ed4e3c5c042003385a9 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 19 Jan 2022 09:44:21 +0900
Subject: [PATCH 2304/5547] Add comment explaining ignore rule

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

diff --git a/osu.Game/Database/RealmObjectExtensions.cs b/osu.Game/Database/RealmObjectExtensions.cs
index 5ab7154486..097e620e12 100644
--- a/osu.Game/Database/RealmObjectExtensions.cs
+++ b/osu.Game/Database/RealmObjectExtensions.cs
@@ -102,6 +102,7 @@ namespace osu.Game.Database
 
             c.CreateMap<BeatmapInfo, BeatmapInfo>()
              .MaxDepth(1)
+             // This is not required as it will be populated in the `AfterMap` call from the `BeatmapInfo`'s parent.
              .ForMember(b => b.BeatmapSet, cc => cc.Ignore());
         }).CreateMapper();
 

From 3bc091fe6d33cda1291e908b4818b0ddcf8ead64 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 19 Jan 2022 09:46:45 +0900
Subject: [PATCH 2305/5547] Add ignore rules on more helper properties

---
 osu.Game/Input/Bindings/RealmKeyBinding.cs | 2 ++
 osu.Game/Scoring/ScoreInfo.cs              | 1 +
 2 files changed, 3 insertions(+)

diff --git a/osu.Game/Input/Bindings/RealmKeyBinding.cs b/osu.Game/Input/Bindings/RealmKeyBinding.cs
index 6a408847fe..32813ada16 100644
--- a/osu.Game/Input/Bindings/RealmKeyBinding.cs
+++ b/osu.Game/Input/Bindings/RealmKeyBinding.cs
@@ -20,12 +20,14 @@ namespace osu.Game.Input.Bindings
 
         public int? Variant { get; set; }
 
+        [Ignored]
         public KeyCombination KeyCombination
         {
             get => KeyCombinationString;
             set => KeyCombinationString = value.ToString();
         }
 
+        [Ignored]
         public object Action
         {
             get => ActionInt;
diff --git a/osu.Game/Scoring/ScoreInfo.cs b/osu.Game/Scoring/ScoreInfo.cs
index e1328d8a06..b268e2cd91 100644
--- a/osu.Game/Scoring/ScoreInfo.cs
+++ b/osu.Game/Scoring/ScoreInfo.cs
@@ -104,6 +104,7 @@ namespace osu.Game.Scoring
             }
         }
 
+        [Ignored]
         public ScoreRank Rank
         {
             get => (ScoreRank)RankInt;

From 64a023665e9944f93615de503de190a64144bcf2 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 19 Jan 2022 10:16:54 +0900
Subject: [PATCH 2306/5547] Avoid taking more than one backup per migration run

---
 osu.Game/Database/EFToRealmMigrator.cs | 30 +++++++++++++++++++-------
 1 file changed, 22 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Database/EFToRealmMigrator.cs b/osu.Game/Database/EFToRealmMigrator.cs
index d479f81ead..b7f3eebe7a 100644
--- a/osu.Game/Database/EFToRealmMigrator.cs
+++ b/osu.Game/Database/EFToRealmMigrator.cs
@@ -24,6 +24,8 @@ namespace osu.Game.Database
         private readonly RealmContextFactory realmContextFactory;
         private readonly OsuConfigManager config;
 
+        private bool hasTakenBackup;
+
         public EFToRealmMigrator(DatabaseContextFactory efContextFactory, RealmContextFactory realmContextFactory, OsuConfigManager config)
         {
             this.efContextFactory = efContextFactory;
@@ -70,8 +72,16 @@ namespace osu.Game.Database
             using (var realm = realmContextFactory.CreateContext())
             {
                 Logger.Log($"Found {existingBeatmapSets.Count} beatmaps in EF", LoggingTarget.Database);
-                string migration = $"before_beatmap_migration_{DateTimeOffset.UtcNow.ToUnixTimeSeconds()}";
-                efContextFactory.CreateBackup($"client.{migration}.db");
+
+                if (!hasTakenBackup)
+                {
+                    string migration = $"before_beatmap_migration_{DateTimeOffset.UtcNow.ToUnixTimeSeconds()}";
+
+                    efContextFactory.CreateBackup($"client.{migration}.db");
+                    realmContextFactory.CreateBackup($"client.{migration}.realm");
+
+                    hasTakenBackup = true;
+                }
 
                 // only migrate data if the realm database is empty.
                 // note that this cannot be written as: `realm.All<BeatmapInfo>().All(s => s.Protected)`, because realm does not support `.All()`.
@@ -81,8 +91,6 @@ namespace osu.Game.Database
                 }
                 else
                 {
-                    realmContextFactory.CreateBackup($"client.{migration}.realm");
-
                     using (var transaction = realm.BeginWrite())
                     {
                         foreach (var beatmapSet in existingBeatmapSets)
@@ -195,8 +203,16 @@ namespace osu.Game.Database
             using (var realm = realmContextFactory.CreateContext())
             {
                 Logger.Log($"Found {existingScores.Count} scores in EF", LoggingTarget.Database);
-                string migration = $"before_score_migration_{DateTimeOffset.UtcNow.ToUnixTimeSeconds()}";
-                efContextFactory.CreateBackup($"client.{migration}.db");
+
+                if (!hasTakenBackup)
+                {
+                    string migration = $"before_score_migration_{DateTimeOffset.UtcNow.ToUnixTimeSeconds()}";
+
+                    efContextFactory.CreateBackup($"client.{migration}.db");
+                    realmContextFactory.CreateBackup($"client.{migration}.realm");
+
+                    hasTakenBackup = true;
+                }
 
                 // only migrate data if the realm database is empty.
                 // note that this cannot be written as: `realm.All<ScoreInfo>().All(s => s.Protected)`, because realm does not support `.All()`.
@@ -206,8 +222,6 @@ namespace osu.Game.Database
                 }
                 else
                 {
-                    realmContextFactory.CreateBackup($"client.{migration}.realm");
-
                     using (var transaction = realm.BeginWrite())
                     {
                         foreach (var score in existingScores)

From 04e9ffa966afd6b95698591de468006302328441 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 19 Jan 2022 10:20:43 +0900
Subject: [PATCH 2307/5547] Freshen some comments

---
 osu.Game/Database/EFToRealmMigrator.cs | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/osu.Game/Database/EFToRealmMigrator.cs b/osu.Game/Database/EFToRealmMigrator.cs
index b7f3eebe7a..6b911ebad0 100644
--- a/osu.Game/Database/EFToRealmMigrator.cs
+++ b/osu.Game/Database/EFToRealmMigrator.cs
@@ -84,7 +84,7 @@ namespace osu.Game.Database
                 }
 
                 // only migrate data if the realm database is empty.
-                // note that this cannot be written as: `realm.All<BeatmapInfo>().All(s => s.Protected)`, because realm does not support `.All()`.
+                // note that this cannot be written as: `realm.All<BeatmapSetInfo>().All(s => s.Protected)`, because realm does not support `.All()`.
                 if (realm.All<BeatmapSetInfo>().Any(s => !s.Protected))
                 {
                     Logger.Log("Skipping migration as realm already has beatmaps loaded", LoggingTarget.Database);
@@ -215,7 +215,6 @@ namespace osu.Game.Database
                 }
 
                 // only migrate data if the realm database is empty.
-                // note that this cannot be written as: `realm.All<ScoreInfo>().All(s => s.Protected)`, because realm does not support `.All()`.
                 if (realm.All<ScoreInfo>().Any())
                 {
                     Logger.Log("Skipping migration as realm already has scores loaded", LoggingTarget.Database);

From e1a35714be3720178f2a56ef88bcdb038946f04a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 19 Jan 2022 10:30:17 +0900
Subject: [PATCH 2308/5547] Add notification for debug builds when database
 migration occurs

---
 osu.Game/Database/DatabaseContextFactory.cs | 11 ++++++++---
 1 file changed, 8 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Database/DatabaseContextFactory.cs b/osu.Game/Database/DatabaseContextFactory.cs
index cc690a9fda..635c4373cd 100644
--- a/osu.Game/Database/DatabaseContextFactory.cs
+++ b/osu.Game/Database/DatabaseContextFactory.cs
@@ -5,6 +5,7 @@ using System.IO;
 using System.Linq;
 using System.Threading;
 using Microsoft.EntityFrameworkCore.Storage;
+using osu.Framework.Development;
 using osu.Framework.Logging;
 using osu.Framework.Platform;
 using osu.Framework.Statistics;
@@ -146,11 +147,15 @@ namespace osu.Game.Database
             Database = { AutoTransactionsEnabled = false }
         };
 
-        public void CreateBackup(string filename)
+        public void CreateBackup(string backupFilename)
         {
-            Logger.Log($"Creating full EF database backup at {filename}", LoggingTarget.Database);
+            Logger.Log($"Creating full EF database backup at {backupFilename}", LoggingTarget.Database);
+
+            if (DebugUtils.IsDebugBuild)
+                Logger.Log("Your development database has been fully migrated to realm. If you switch back to a pre-realm branch and need your previous database, rename the backup file back to \"client.db\".\n\nNote that doing this can potentially leave your file store in a bad state.", level: LogLevel.Important);
+
             using (var source = storage.GetStream(DATABASE_NAME))
-            using (var destination = storage.GetStream(filename, FileAccess.Write, FileMode.CreateNew))
+            using (var destination = storage.GetStream(backupFilename, FileAccess.Write, FileMode.CreateNew))
                 source.CopyTo(destination);
         }
 

From 195534a1d2e0a890be7b16feb3e936ed2fe426c4 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 19 Jan 2022 10:31:09 +0900
Subject: [PATCH 2309/5547] Only output "successful" messages when copy
 actually occurred

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

diff --git a/osu.Game/Database/EFToRealmMigrator.cs b/osu.Game/Database/EFToRealmMigrator.cs
index 6b911ebad0..76e5219f87 100644
--- a/osu.Game/Database/EFToRealmMigrator.cs
+++ b/osu.Game/Database/EFToRealmMigrator.cs
@@ -148,10 +148,10 @@ namespace osu.Game.Database
                         }
 
                         transaction.Commit();
+                        Logger.Log($"Successfully migrated {existingBeatmapSets.Count} beatmaps to realm", LoggingTarget.Database);
                     }
                 }
 
-                Logger.Log($"Successfully migrated {existingBeatmapSets.Count} beatmaps to realm", LoggingTarget.Database);
                 ef.Context.RemoveRange(existingBeatmapSets);
                 // Intentionally don't clean up the files, so they don't get purged by EF.
             }
@@ -257,10 +257,10 @@ namespace osu.Game.Database
                         }
 
                         transaction.Commit();
+                        Logger.Log($"Successfully migrated {existingScores.Count} scores to realm", LoggingTarget.Database);
                     }
                 }
 
-                Logger.Log($"Successfully migrated {existingScores.Count} scores to realm", LoggingTarget.Database);
                 db.Context.RemoveRange(existingScores);
                 // Intentionally don't clean up the files, so they don't get purged by EF.
             }

From 261b4988f9552b63a951efe3041e34a0b1f377a8 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 19 Jan 2022 10:58:59 +0900
Subject: [PATCH 2310/5547] Only catch `RealmExceptions` to avoid blocking the
 nested `TimeoutException`

---
 osu.Game/Database/RealmContextFactory.cs | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Database/RealmContextFactory.cs b/osu.Game/Database/RealmContextFactory.cs
index 52f515a4bb..901f28a449 100644
--- a/osu.Game/Database/RealmContextFactory.cs
+++ b/osu.Game/Database/RealmContextFactory.cs
@@ -21,6 +21,7 @@ using osu.Game.Stores;
 using osu.Game.Rulesets;
 using osu.Game.Scoring;
 using Realms;
+using Realms.Exceptions;
 
 #nullable enable
 
@@ -427,7 +428,7 @@ namespace osu.Game.Database
                             throw new TimeoutException(@"Took too long to acquire lock");
                     }
                 }
-                catch (Exception e)
+                catch (RealmException e)
                 {
                     // Compact may fail if the realm is in a bad state.
                     // We still want to continue with the blocking operation, though.

From c52899b1fb0f6a6e52d73ee93d74247b931bc6f4 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 19 Jan 2022 11:56:44 +0900
Subject: [PATCH 2311/5547] Rename property

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

diff --git a/osu.Game/Database/RealmContextFactory.cs b/osu.Game/Database/RealmContextFactory.cs
index 10c2438df9..8be8eab567 100644
--- a/osu.Game/Database/RealmContextFactory.cs
+++ b/osu.Game/Database/RealmContextFactory.cs
@@ -361,13 +361,13 @@ namespace osu.Game.Database
         private string? getRulesetShortNameFromLegacyID(long rulesetId) =>
             efContextFactory?.Get().RulesetInfo.FirstOrDefault(r => r.ID == rulesetId)?.ShortName;
 
-        public void CreateBackup(string filename)
+        public void CreateBackup(string backupFilename)
         {
             using (BlockAllOperations())
             {
-                Logger.Log($"Creating full realm database backup at {filename}", LoggingTarget.Database);
+                Logger.Log($"Creating full realm database backup at {backupFilename}", LoggingTarget.Database);
                 using (var source = storage.GetStream(Filename))
-                using (var destination = storage.GetStream(filename, FileAccess.Write, FileMode.CreateNew))
+                using (var destination = storage.GetStream(backupFilename, FileAccess.Write, FileMode.CreateNew))
                     source.CopyTo(destination);
             }
         }

From 2363130f8b2d791f98d3d7023e75b964b6240a49 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 19 Jan 2022 12:33:56 +0900
Subject: [PATCH 2312/5547] Add back `BaseDifficulty` with obsoletion counter
 to account for custom rulesets

---
 osu.Game/Beatmaps/BeatmapInfo.cs | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/osu.Game/Beatmaps/BeatmapInfo.cs b/osu.Game/Beatmaps/BeatmapInfo.cs
index b91f05cd11..f4d8697042 100644
--- a/osu.Game/Beatmaps/BeatmapInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapInfo.cs
@@ -165,6 +165,14 @@ namespace osu.Game.Beatmaps
             }
         }
 
+        [Ignored]
+        [Obsolete("Use BeatmapInfo.Difficulty instead.")] // can be removed 20220719
+        public BeatmapDifficulty BaseDifficulty
+        {
+            get => Difficulty;
+            set => Difficulty = value;
+        }
+
         [Ignored]
         public string? Path => File?.Filename;
 

From 9be5bf38c639a0736687b52e41e60d55329b7088 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 19 Jan 2022 13:20:52 +0900
Subject: [PATCH 2313/5547] Simplify binding/invalidation in `TopLocalRank`

---
 .../Select/Carousel/DrawableCarouselBeatmap.cs  |  1 -
 .../Screens/Select/Carousel/TopLocalRank.cs     | 17 ++++++-----------
 2 files changed, 6 insertions(+), 12 deletions(-)

diff --git a/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmap.cs b/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmap.cs
index a5fabd9237..3576b77ae8 100644
--- a/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmap.cs
+++ b/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmap.cs
@@ -159,7 +159,6 @@ namespace osu.Game.Screens.Select.Carousel
                                         new TopLocalRank(beatmapInfo)
                                         {
                                             Scale = new Vector2(0.8f),
-                                            Size = new Vector2(40, 20)
                                         },
                                         starCounter = new StarCounter
                                         {
diff --git a/osu.Game/Screens/Select/Carousel/TopLocalRank.cs b/osu.Game/Screens/Select/Carousel/TopLocalRank.cs
index 4542ab897b..7ac99f4935 100644
--- a/osu.Game/Screens/Select/Carousel/TopLocalRank.cs
+++ b/osu.Game/Screens/Select/Carousel/TopLocalRank.cs
@@ -13,6 +13,7 @@ using osu.Game.Online.API;
 using osu.Game.Online.Leaderboards;
 using osu.Game.Rulesets;
 using osu.Game.Scoring;
+using osuTK;
 using Realms;
 
 namespace osu.Game.Screens.Select.Carousel
@@ -32,12 +33,12 @@ namespace osu.Game.Screens.Select.Carousel
 
         private IDisposable scoreSubscription;
 
-        private bool rankUpdatePending;
-
         public TopLocalRank(BeatmapInfo beatmapInfo)
             : base(null)
         {
             this.beatmapInfo = beatmapInfo;
+
+            Size = new Vector2(40, 20);
         }
 
         protected override void LoadComplete()
@@ -46,10 +47,6 @@ namespace osu.Game.Screens.Select.Carousel
 
             ruleset.BindValueChanged(_ =>
             {
-                rankUpdatePending = true;
-                // Required since presence is changed via IsPresent override
-                Invalidate(Invalidation.Presence);
-
                 scoreSubscription?.Dispose();
                 scoreSubscription = realmFactory.Context.All<ScoreInfo>()
                                                 .Filter($"{nameof(ScoreInfo.User)}.{nameof(RealmUser.OnlineID)} == $0"
@@ -59,16 +56,14 @@ namespace osu.Game.Screens.Select.Carousel
                                                 .OrderByDescending(s => s.TotalScore)
                                                 .QueryAsyncWithNotifications((items, changes, ___) =>
                                                 {
-                                                    if (changes == null)
-                                                        rankUpdatePending = false;
-
                                                     Rank = items.FirstOrDefault()?.Rank;
+                                                    // Required since presence is changed via IsPresent override
+                                                    Invalidate(Invalidation.Presence);
                                                 });
             }, true);
         }
 
-        // We're present if a rank is set, or if there is a pending rank update (IsPresent = true is required for the scheduler to run).
-        public override bool IsPresent => base.IsPresent && (Rank != null || rankUpdatePending);
+        public override bool IsPresent => base.IsPresent && Rank != null;
 
         protected override void Dispose(bool isDisposing)
         {

From 201f2d78135a03a9b4345761f5141ae0dccaeeda Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 19 Jan 2022 13:48:00 +0900
Subject: [PATCH 2314/5547] Add comprehensive test coverage for `TopLocalRank`

---
 .../SongSelect/TestSceneTopLocalRank.cs       | 143 ++++++++++++++++++
 1 file changed, 143 insertions(+)
 create mode 100644 osu.Game.Tests/Visual/SongSelect/TestSceneTopLocalRank.cs

diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneTopLocalRank.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneTopLocalRank.cs
new file mode 100644
index 0000000000..3aa5a759e6
--- /dev/null
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneTopLocalRank.cs
@@ -0,0 +1,143 @@
+// 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.Audio;
+using osu.Framework.Extensions;
+using osu.Framework.Graphics;
+using osu.Framework.Platform;
+using osu.Framework.Testing;
+using osu.Game.Beatmaps;
+using osu.Game.Rulesets;
+using osu.Game.Scoring;
+using osu.Game.Screens.Select.Carousel;
+using osu.Game.Tests.Resources;
+using osuTK;
+
+namespace osu.Game.Tests.Visual.SongSelect
+{
+    public class TestSceneTopLocalRank : OsuTestScene
+    {
+        private RulesetStore rulesets;
+        private BeatmapManager beatmapManager;
+        private ScoreManager scoreManager;
+        private TopLocalRank topLocalRank;
+
+        [BackgroundDependencyLoader]
+        private void load(GameHost host, AudioManager audio)
+        {
+            Dependencies.Cache(rulesets = new RulesetStore(ContextFactory));
+            Dependencies.Cache(beatmapManager = new BeatmapManager(LocalStorage, ContextFactory, rulesets, null, audio, Resources, host, Beatmap.Default));
+            Dependencies.Cache(scoreManager = new ScoreManager(rulesets, () => beatmapManager, LocalStorage, ContextFactory, Scheduler));
+            Dependencies.Cache(ContextFactory);
+
+            beatmapManager.Import(TestResources.GetQuickTestBeatmapForImport()).WaitSafely();
+        }
+
+        private BeatmapInfo importedBeatmap => beatmapManager.GetAllUsableBeatmapSets().First().Beatmaps.First(b => b.Ruleset.ShortName == "osu");
+
+        [SetUpSteps]
+        public void SetUpSteps()
+        {
+            AddStep("Delete all scores", () => scoreManager.Delete());
+
+            AddStep("Create local rank", () =>
+            {
+                Add(topLocalRank = new TopLocalRank(importedBeatmap)
+                {
+                    Anchor = Anchor.Centre,
+                    Origin = Anchor.Centre,
+                    Scale = new Vector2(10),
+                });
+            });
+        }
+
+        [Test]
+        public void TestBasicImportDelete()
+        {
+            ScoreInfo testScoreInfo = null;
+
+            AddAssert("Initially not present", () => !topLocalRank.IsPresent);
+
+            AddStep("Add score for current user", () =>
+            {
+                testScoreInfo = TestResources.CreateTestScoreInfo(importedBeatmap);
+
+                testScoreInfo.User = API.LocalUser.Value;
+                testScoreInfo.Rank = ScoreRank.B;
+
+                scoreManager.Import(testScoreInfo);
+            });
+
+            AddUntilStep("Became present", () => topLocalRank.IsPresent);
+            AddAssert("Correct rank", () => topLocalRank.Rank == ScoreRank.B);
+
+            AddStep("Delete score", () =>
+            {
+                scoreManager.Delete(testScoreInfo);
+            });
+
+            AddUntilStep("Became not present", () => !topLocalRank.IsPresent);
+        }
+
+        [Test]
+        public void TestRulesetChange()
+        {
+            ScoreInfo testScoreInfo;
+
+            AddStep("Add score for current user", () =>
+            {
+                testScoreInfo = TestResources.CreateTestScoreInfo(importedBeatmap);
+
+                testScoreInfo.User = API.LocalUser.Value;
+                testScoreInfo.Rank = ScoreRank.B;
+
+                scoreManager.Import(testScoreInfo);
+            });
+
+            AddUntilStep("Wait for initial presence", () => topLocalRank.IsPresent);
+
+            AddStep("Change ruleset", () => Ruleset.Value = rulesets.GetRuleset("fruits"));
+            AddUntilStep("Became not present", () => !topLocalRank.IsPresent);
+
+            AddStep("Change ruleset back", () => Ruleset.Value = rulesets.GetRuleset("osu"));
+            AddUntilStep("Became present", () => topLocalRank.IsPresent);
+        }
+
+        [Test]
+        public void TestHigherScoreSet()
+        {
+            ScoreInfo testScoreInfo = null;
+
+            AddAssert("Initially not present", () => !topLocalRank.IsPresent);
+
+            AddStep("Add score for current user", () =>
+            {
+                testScoreInfo = TestResources.CreateTestScoreInfo(importedBeatmap);
+
+                testScoreInfo.User = API.LocalUser.Value;
+                testScoreInfo.Rank = ScoreRank.B;
+
+                scoreManager.Import(testScoreInfo);
+            });
+
+            AddUntilStep("Became present", () => topLocalRank.IsPresent);
+            AddAssert("Correct rank", () => topLocalRank.Rank == ScoreRank.B);
+
+            AddStep("Add higher score for current user", () =>
+            {
+                var testScoreInfo2 = TestResources.CreateTestScoreInfo(importedBeatmap);
+
+                testScoreInfo2.User = API.LocalUser.Value;
+                testScoreInfo2.Rank = ScoreRank.S;
+                testScoreInfo2.TotalScore = testScoreInfo.TotalScore + 1;
+
+                scoreManager.Import(testScoreInfo2);
+            });
+
+            AddAssert("Correct rank", () => topLocalRank.Rank == ScoreRank.S);
+        }
+    }
+}

From 493a970ed5985d7507b859451043feeb97499a21 Mon Sep 17 00:00:00 2001
From: Jamie Taylor <me@nekodex.net>
Date: Wed, 19 Jan 2022 14:08:21 +0900
Subject: [PATCH 2315/5547] Remove unused AudioManager

---
 .../OnlinePlay/Multiplayer/Participants/ParticipantsList.cs    | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantsList.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantsList.cs
index fe40a4bfe6..afb2111023 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantsList.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantsList.cs
@@ -3,7 +3,6 @@
 
 using System.Linq;
 using osu.Framework.Allocation;
-using osu.Framework.Audio;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Graphics.Containers;
@@ -17,7 +16,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Participants
         private FillFlowContainer<ParticipantPanel> panels;
 
         [BackgroundDependencyLoader]
-        private void load(AudioManager audio)
+        private void load()
         {
             InternalChild = new OsuContextMenuContainer
             {

From 664b4fdaf09e86e4b55d6c4e0ddf9c3929aac172 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 19 Jan 2022 14:17:56 +0900
Subject: [PATCH 2316/5547] Fix legacy score imports not correctly getting
 classic mod assigned

---
 osu.Game/Scoring/ScoreInfo.cs | 14 +++++++++-----
 1 file changed, 9 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Scoring/ScoreInfo.cs b/osu.Game/Scoring/ScoreInfo.cs
index b268e2cd91..fe99d5d9a8 100644
--- a/osu.Game/Scoring/ScoreInfo.cs
+++ b/osu.Game/Scoring/ScoreInfo.cs
@@ -191,9 +191,8 @@ namespace osu.Game.Scoring
             }
             set
             {
-                apiMods = null;
+                clearAllMods();
                 mods = value;
-
                 updateModsJson();
             }
         }
@@ -220,14 +219,19 @@ namespace osu.Game.Scoring
             }
             set
             {
+                clearAllMods();
                 apiMods = value;
-                mods = null;
-
-                // We potentially can't update this yet due to Ruleset being late-bound, so instead update on read as necessary.
                 updateModsJson();
             }
         }
 
+        private void clearAllMods()
+        {
+            ModsJson = string.Empty;
+            mods = null;
+            apiMods = null;
+        }
+
         private void updateModsJson()
         {
             ModsJson = JsonConvert.SerializeObject(APIMods);

From bb6f40d16e53816a86443a397c6d1747ed3e7180 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 19 Jan 2022 14:25:40 +0900
Subject: [PATCH 2317/5547] Add test coverage of all mod storages containing
 classic mod post-import

---
 osu.Game.Tests/Beatmaps/Formats/LegacyScoreDecoderTest.cs | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/osu.Game.Tests/Beatmaps/Formats/LegacyScoreDecoderTest.cs b/osu.Game.Tests/Beatmaps/Formats/LegacyScoreDecoderTest.cs
index 3d4b05b52b..2ba8c51a10 100644
--- a/osu.Game.Tests/Beatmaps/Formats/LegacyScoreDecoderTest.cs
+++ b/osu.Game.Tests/Beatmaps/Formats/LegacyScoreDecoderTest.cs
@@ -12,6 +12,7 @@ using osu.Game.Replays;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Catch;
 using osu.Game.Rulesets.Mania;
+using osu.Game.Rulesets.Mania.Mods;
 using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Osu.Replays;
 using osu.Game.Rulesets.Osu.UI;
@@ -51,6 +52,11 @@ namespace osu.Game.Tests.Beatmaps.Formats
 
                 Assert.AreEqual(829_931, score.ScoreInfo.TotalScore);
                 Assert.AreEqual(3, score.ScoreInfo.MaxCombo);
+
+                Assert.IsTrue(score.ScoreInfo.Mods.Any(m => m is ManiaModClassic));
+                Assert.IsTrue(score.ScoreInfo.APIMods.Any(m => m.Acronym == "CL"));
+                Assert.IsTrue(score.ScoreInfo.ModsJson.Contains("CL"));
+
                 Assert.IsTrue(Precision.AlmostEquals(0.8889, score.ScoreInfo.Accuracy, 0.0001));
                 Assert.AreEqual(ScoreRank.B, score.ScoreInfo.Rank);
 

From 18886f5d2ebdd2061e390854920df1d1c718aba0 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 19 Jan 2022 14:28:16 +0900
Subject: [PATCH 2318/5547] Use empty string instead of empty array for
 `ModsJson` when no mods are present

Not really correct, but this is how most scores have been stored until
now so let's do this for consistency.
---
 osu.Game/Scoring/ScoreInfo.cs | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Scoring/ScoreInfo.cs b/osu.Game/Scoring/ScoreInfo.cs
index fe99d5d9a8..cfc37e956d 100644
--- a/osu.Game/Scoring/ScoreInfo.cs
+++ b/osu.Game/Scoring/ScoreInfo.cs
@@ -234,7 +234,9 @@ namespace osu.Game.Scoring
 
         private void updateModsJson()
         {
-            ModsJson = JsonConvert.SerializeObject(APIMods);
+            ModsJson = APIMods.Length > 0
+                ? JsonConvert.SerializeObject(APIMods)
+                : string.Empty;
         }
 
         public IEnumerable<HitResultDisplayStatistic> GetStatisticsForDisplay()

From a002dacdce3bdb66d5f44cdee6a2423e954a1bc4 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 19 Jan 2022 14:32:56 +0900
Subject: [PATCH 2319/5547] Add test coverage of various `ScoreInfo` mod set
 operations

---
 osu.Game.Tests/NonVisual/ScoreInfoTest.cs | 41 +++++++++++++++++++++++
 1 file changed, 41 insertions(+)

diff --git a/osu.Game.Tests/NonVisual/ScoreInfoTest.cs b/osu.Game.Tests/NonVisual/ScoreInfoTest.cs
index 6e5718cd4c..ea2f50f3bb 100644
--- a/osu.Game.Tests/NonVisual/ScoreInfoTest.cs
+++ b/osu.Game.Tests/NonVisual/ScoreInfoTest.cs
@@ -2,6 +2,11 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using NUnit.Framework;
+using osu.Game.Online.API;
+using osu.Game.Rulesets.Mania;
+using osu.Game.Rulesets.Mania.Mods;
+using osu.Game.Rulesets.Mods;
+using osu.Game.Rulesets.Osu.Mods;
 using osu.Game.Rulesets.Scoring;
 using osu.Game.Scoring;
 
@@ -29,5 +34,41 @@ namespace osu.Game.Tests.NonVisual
             Assert.That(scoreCopy.Rank, Is.EqualTo(ScoreRank.B));
             Assert.That(score.Rank, Is.EqualTo(ScoreRank.X));
         }
+
+        [Test]
+        public void TestModsInitiallyEmpty()
+        {
+            var score = new ScoreInfo();
+
+            Assert.That(score.Mods, Is.Empty);
+            Assert.That(score.APIMods, Is.Empty);
+            Assert.That(score.ModsJson, Is.Empty);
+        }
+
+        [Test]
+        public void TestModsUpdatedCorrectly()
+        {
+            var score = new ScoreInfo
+            {
+                Mods = new Mod[] { new ManiaModClassic() },
+                Ruleset = new ManiaRuleset().RulesetInfo,
+            };
+
+            Assert.That(score.Mods, Contains.Item(new ManiaModClassic()));
+            Assert.That(score.APIMods, Contains.Item(new APIMod(new ManiaModClassic())));
+            Assert.That(score.ModsJson, Contains.Substring("CL"));
+
+            score.APIMods = new[] { new APIMod(new ManiaModDoubleTime()) };
+
+            Assert.That(score.Mods, Contains.Item(new ManiaModDoubleTime()));
+            Assert.That(score.APIMods, Contains.Item(new APIMod(new ManiaModDoubleTime())));
+            Assert.That(score.ModsJson, Contains.Substring("DT"));
+
+            score.Mods = new Mod[] { new ManiaModClassic() };
+
+            Assert.That(score.Mods, Contains.Item(new ManiaModClassic()));
+            Assert.That(score.APIMods, Contains.Item(new APIMod(new ManiaModClassic())));
+            Assert.That(score.ModsJson, Contains.Substring("CL"));
+        }
     }
 }

From 03ac91a3ee43144ea32c097dfb0f71e86773a75d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 19 Jan 2022 14:56:44 +0900
Subject: [PATCH 2320/5547] Consider all points in a group to meet redundancy
 check

---
 .../Components/Timelines/Summary/Parts/GroupVisualisation.cs    | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/GroupVisualisation.cs b/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/GroupVisualisation.cs
index 83759bbc2b..88587399f2 100644
--- a/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/GroupVisualisation.cs
+++ b/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/GroupVisualisation.cs
@@ -62,6 +62,6 @@ namespace osu.Game.Screens.Edit.Components.Timelines.Summary.Parts
         /// For display purposes, check whether the proposed group is made redundant by this visualisation group.
         /// </summary>
         public bool IsVisuallyRedundant(ControlPointGroup other) =>
-            other.ControlPoints.Any(c => InternalChildren.OfType<IControlPointVisualisation>().Any(c2 => c2.IsVisuallyRedundant(c)));
+            other.ControlPoints.All(c => InternalChildren.OfType<IControlPointVisualisation>().Any(c2 => c2.IsVisuallyRedundant(c)));
     }
 }

From 5f5765d6a2270b2536973e84d244be6421e9c61d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 19 Jan 2022 14:57:01 +0900
Subject: [PATCH 2321/5547] Reduce redundancy time range to create a bit more
 visual blending on the timeline

---
 .../Edit/Components/Timelines/Summary/Parts/ControlPointPart.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/ControlPointPart.cs b/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/ControlPointPart.cs
index a33bb73681..f1edb7dc7e 100644
--- a/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/ControlPointPart.cs
+++ b/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/ControlPointPart.cs
@@ -36,7 +36,7 @@ namespace osu.Game.Screens.Edit.Components.Timelines.Summary.Parts
                             // as an optimisation, don't add a visualisation if there are already groups with the same types in close proximity.
                             // for newly added control points (ie. lazer editor first where group is added empty) we always skip for simplicity.
                             // that is fine, because cases where this is causing a performance issue are mostly where external tools were used to create an insane number of points.
-                            if (Children.Any(g => Math.Abs(g.Group.Time - group.Time) < 1000 && g.IsVisuallyRedundant(group)))
+                            if (Children.Any(g => Math.Abs(g.Group.Time - group.Time) < 500 && g.IsVisuallyRedundant(group)))
                                 continue;
 
                             Add(new GroupVisualisation(group));

From faec62be5128f5e54832d7ea7256f3d0301de91f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 19 Jan 2022 15:11:36 +0900
Subject: [PATCH 2322/5547] Force a realm refresh after migration

This really shouldn't have much effect as it will be run in the first
`Update` method and is probably a noop (we are already pointing to the
newest version due to just performing writes), but seems like a safe addition.

In general `Realm.Refresh()` only really does anything when there's multithreaded
usage and notifications to be sent.
---
 osu.Game/Database/EFToRealmMigrator.cs | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/osu.Game/Database/EFToRealmMigrator.cs b/osu.Game/Database/EFToRealmMigrator.cs
index 1de6c25070..0a7d42e808 100644
--- a/osu.Game/Database/EFToRealmMigrator.cs
+++ b/osu.Game/Database/EFToRealmMigrator.cs
@@ -42,6 +42,9 @@ namespace osu.Game.Database
                 migrateScores(ef);
             }
 
+            Logger.Log("Refreshing realm...", LoggingTarget.Database);
+            realmContextFactory.Refresh();
+
             // Delete the database permanently.
             // Will cause future startups to not attempt migration.
             Logger.Log("Migration successful, deleting EF database", LoggingTarget.Database);

From 973836484c5b168684677f2d3aebf2cd4af659b3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 19 Jan 2022 15:52:59 +0900
Subject: [PATCH 2323/5547] Avoid using a write context for EF migration

This reduces a stall delay as EF tries to process changes over tracked
objects during disposal of the context.
---
 osu.Game/Database/EFToRealmMigrator.cs | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/osu.Game/Database/EFToRealmMigrator.cs b/osu.Game/Database/EFToRealmMigrator.cs
index 0a7d42e808..908f1b0294 100644
--- a/osu.Game/Database/EFToRealmMigrator.cs
+++ b/osu.Game/Database/EFToRealmMigrator.cs
@@ -34,7 +34,7 @@ namespace osu.Game.Database
 
         public void Run()
         {
-            using (var ef = efContextFactory.GetForWrite())
+            using (var ef = efContextFactory.Get())
             {
                 migrateSettings(ef);
                 migrateSkins(ef);
@@ -51,10 +51,10 @@ namespace osu.Game.Database
             efContextFactory.ResetDatabase();
         }
 
-        private void migrateBeatmaps(DatabaseWriteUsage ef)
+        private void migrateBeatmaps(OsuDbContext ef)
         {
             // can be removed 20220730.
-            var existingBeatmapSets = ef.Context.EFBeatmapSetInfo
+            var existingBeatmapSets = ef.EFBeatmapSetInfo
                                         .Include(s => s.Beatmaps).ThenInclude(b => b.RulesetInfo)
                                         .Include(s => s.Beatmaps).ThenInclude(b => b.Metadata)
                                         .Include(s => s.Beatmaps).ThenInclude(b => b.BaseDifficulty)
@@ -180,10 +180,10 @@ namespace osu.Game.Database
             };
         }
 
-        private void migrateScores(DatabaseWriteUsage db)
+        private void migrateScores(OsuDbContext db)
         {
             // can be removed 20220730.
-            var existingScores = db.Context.ScoreInfo
+            var existingScores = db.ScoreInfo
                                    .Include(s => s.Ruleset)
                                    .Include(s => s.BeatmapInfo)
                                    .Include(s => s.Files)
@@ -263,10 +263,10 @@ namespace osu.Game.Database
             }
         }
 
-        private void migrateSkins(DatabaseWriteUsage db)
+        private void migrateSkins(OsuDbContext db)
         {
             // can be removed 20220530.
-            var existingSkins = db.Context.SkinInfo
+            var existingSkins = db.SkinInfo
                                   .Include(s => s.Files)
                                   .ThenInclude(f => f.FileInfo)
                                   .ToList();
@@ -335,10 +335,10 @@ namespace osu.Game.Database
             }
         }
 
-        private void migrateSettings(DatabaseWriteUsage db)
+        private void migrateSettings(OsuDbContext db)
         {
             // migrate ruleset settings. can be removed 20220315.
-            var existingSettings = db.Context.DatabasedSetting.ToList();
+            var existingSettings = db.DatabasedSetting.ToList();
 
             // previous entries in EF are removed post migration.
             if (!existingSettings.Any())

From 42736c99951341a28224b207d185a9e8803bb74f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 19 Jan 2022 16:01:17 +0900
Subject: [PATCH 2324/5547] Add transactional committing of scores/beatmaps

This helps slightly with performance, allows better monitoring via realm
studio, but most importantly greatly reduces filesize.

fully compacted:        109M
transaction size 100:   115M
transaction size 1000:  123M
transaction size 10000: 164M
single transaction:     183M

With a transaction size of 100 there is a performance reduction, so 1000
seems to be the best middle-ground.
---
 osu.Game/Database/EFToRealmMigrator.cs | 42 +++++++++++++++++++++-----
 1 file changed, 34 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Database/EFToRealmMigrator.cs b/osu.Game/Database/EFToRealmMigrator.cs
index 908f1b0294..a7cfd71ff9 100644
--- a/osu.Game/Database/EFToRealmMigrator.cs
+++ b/osu.Game/Database/EFToRealmMigrator.cs
@@ -94,10 +94,20 @@ namespace osu.Game.Database
                 }
                 else
                 {
-                    using (var transaction = realm.BeginWrite())
+                    var transaction = realm.BeginWrite();
+                    int written = 0;
+
+                    try
                     {
                         foreach (var beatmapSet in existingBeatmapSets)
                         {
+                            if (++written % 1000 == 0)
+                            {
+                                transaction.Commit();
+                                transaction = realm.BeginWrite();
+                                Logger.Log($"Migrated {written}/{count} beatmaps...", LoggingTarget.Database);
+                            }
+
                             var realmBeatmapSet = new BeatmapSetInfo
                             {
                                 OnlineID = beatmapSet.OnlineID ?? -1,
@@ -149,10 +159,13 @@ namespace osu.Game.Database
 
                             realm.Add(realmBeatmapSet);
                         }
-
-                        transaction.Commit();
-                        Logger.Log($"Successfully migrated {count} beatmaps to realm", LoggingTarget.Database);
                     }
+                    finally
+                    {
+                        transaction.Commit();
+                    }
+
+                    Logger.Log($"Successfully migrated {count} beatmaps to realm", LoggingTarget.Database);
                 }
             }
         }
@@ -221,10 +234,20 @@ namespace osu.Game.Database
                 }
                 else
                 {
-                    using (var transaction = realm.BeginWrite())
+                    var transaction = realm.BeginWrite();
+                    int written = 0;
+
+                    try
                     {
                         foreach (var score in existingScores)
                         {
+                            if (++written % 1000 == 0)
+                            {
+                                transaction.Commit();
+                                transaction = realm.BeginWrite();
+                                Logger.Log($"Migrated {written}/{count} scores...", LoggingTarget.Database);
+                            }
+
                             var realmScore = new ScoreInfo
                             {
                                 Hash = score.Hash,
@@ -255,10 +278,13 @@ namespace osu.Game.Database
 
                             realm.Add(realmScore);
                         }
-
-                        transaction.Commit();
-                        Logger.Log($"Successfully migrated {count} scores to realm", LoggingTarget.Database);
                     }
+                    finally
+                    {
+                        transaction.Commit();
+                    }
+
+                    Logger.Log($"Successfully migrated {count} scores to realm", LoggingTarget.Database);
                 }
             }
         }

From fd5198d667f256ab59781d686721fd9507256ff7 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 19 Jan 2022 16:22:17 +0900
Subject: [PATCH 2325/5547] Avoid using parameterless constructors in migration
 code

Minor performance improvement (less garbage).
---
 osu.Game/Database/EFToRealmMigrator.cs | 24 ++++++++++++++++--------
 1 file changed, 16 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Database/EFToRealmMigrator.cs b/osu.Game/Database/EFToRealmMigrator.cs
index a7cfd71ff9..5e49a44733 100644
--- a/osu.Game/Database/EFToRealmMigrator.cs
+++ b/osu.Game/Database/EFToRealmMigrator.cs
@@ -122,7 +122,10 @@ namespace osu.Game.Database
 
                             foreach (var beatmap in beatmapSet.Beatmaps)
                             {
-                                var realmBeatmap = new BeatmapInfo
+                                var ruleset = realm.Find<RulesetInfo>(beatmap.RulesetInfo.ShortName);
+                                var metadata = getBestMetadata(beatmap.Metadata, beatmapSet.Metadata);
+
+                                var realmBeatmap = new BeatmapInfo(ruleset, new BeatmapDifficulty(beatmap.BaseDifficulty), metadata)
                                 {
                                     DifficultyName = beatmap.DifficultyName,
                                     Status = beatmap.Status,
@@ -148,9 +151,6 @@ namespace osu.Game.Database
                                     CountdownOffset = beatmap.CountdownOffset,
                                     MaxCombo = beatmap.MaxCombo,
                                     Bookmarks = beatmap.Bookmarks,
-                                    Ruleset = realm.Find<RulesetInfo>(beatmap.RulesetInfo.ShortName),
-                                    Difficulty = new BeatmapDifficulty(beatmap.BaseDifficulty),
-                                    Metadata = getBestMetadata(beatmap.Metadata, beatmapSet.Metadata),
                                     BeatmapSet = realmBeatmapSet,
                                 };
 
@@ -180,7 +180,7 @@ namespace osu.Game.Database
                 TitleUnicode = metadata.TitleUnicode,
                 Artist = metadata.Artist,
                 ArtistUnicode = metadata.ArtistUnicode,
-                Author = new RealmUser
+                Author =
                 {
                     OnlineID = metadata.Author.Id,
                     Username = metadata.Author.Username,
@@ -248,7 +248,15 @@ namespace osu.Game.Database
                                 Logger.Log($"Migrated {written}/{count} scores...", LoggingTarget.Database);
                             }
 
-                            var realmScore = new ScoreInfo
+                            var beatmap = realm.All<BeatmapInfo>().First(b => b.Hash == score.BeatmapInfo.Hash);
+                            var ruleset = realm.Find<RulesetInfo>(score.Ruleset.ShortName);
+                            var user = new RealmUser
+                            {
+                                OnlineID = score.User.OnlineID,
+                                Username = score.User.Username
+                            };
+
+                            var realmScore = new ScoreInfo(beatmap, ruleset, user)
                             {
                                 Hash = score.Hash,
                                 DeletePending = score.DeletePending,
@@ -262,8 +270,8 @@ namespace osu.Game.Database
                                 HasReplay = ((IScoreInfo)score).HasReplay,
                                 Date = score.Date,
                                 PP = score.PP,
-                                BeatmapInfo = realm.All<BeatmapInfo>().First(b => b.Hash == score.BeatmapInfo.Hash),
-                                Ruleset = realm.Find<RulesetInfo>(score.Ruleset.ShortName),
+                                BeatmapInfo = beatmap,
+                                Ruleset = ruleset,
                                 Rank = score.Rank,
                                 HitEvents = score.HitEvents,
                                 Passed = score.Passed,

From aa93042aa334c0111ddf279c73833c5b1f08add9 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 19 Jan 2022 16:28:16 +0900
Subject: [PATCH 2326/5547] Centralise backup code and also run on
 skin/settings migrations

---
 osu.Game/Database/EFToRealmMigrator.cs | 36 +++++++++++++-------------
 1 file changed, 18 insertions(+), 18 deletions(-)

diff --git a/osu.Game/Database/EFToRealmMigrator.cs b/osu.Game/Database/EFToRealmMigrator.cs
index 1de6c25070..23eb794837 100644
--- a/osu.Game/Database/EFToRealmMigrator.cs
+++ b/osu.Game/Database/EFToRealmMigrator.cs
@@ -73,15 +73,7 @@ namespace osu.Game.Database
             {
                 Logger.Log($"Found {count} beatmaps in EF", LoggingTarget.Database);
 
-                if (!hasTakenBackup)
-                {
-                    string migration = $"before_beatmap_migration_{DateTimeOffset.UtcNow.ToUnixTimeSeconds()}";
-
-                    efContextFactory.CreateBackup($"client.{migration}.db");
-                    realmContextFactory.CreateBackup($"client.{migration}.realm");
-
-                    hasTakenBackup = true;
-                }
+                ensureBackup();
 
                 // only migrate data if the realm database is empty.
                 // note that this cannot be written as: `realm.All<BeatmapSetInfo>().All(s => s.Protected)`, because realm does not support `.All()`.
@@ -201,15 +193,7 @@ namespace osu.Game.Database
             {
                 Logger.Log($"Found {count} scores in EF", LoggingTarget.Database);
 
-                if (!hasTakenBackup)
-                {
-                    string migration = $"before_score_migration_{DateTimeOffset.UtcNow.ToUnixTimeSeconds()}";
-
-                    efContextFactory.CreateBackup($"client.{migration}.db");
-                    realmContextFactory.CreateBackup($"client.{migration}.realm");
-
-                    hasTakenBackup = true;
-                }
+                ensureBackup();
 
                 // only migrate data if the realm database is empty.
                 if (realm.All<ScoreInfo>().Any())
@@ -272,6 +256,8 @@ namespace osu.Game.Database
             if (!existingSkins.Any())
                 return;
 
+            ensureBackup();
+
             var userSkinChoice = config.GetBindable<string>(OsuSetting.Skin);
             int.TryParse(userSkinChoice.Value, out int userSkinInt);
 
@@ -342,6 +328,7 @@ namespace osu.Game.Database
                 return;
 
             Logger.Log("Beginning settings migration to realm", LoggingTarget.Database);
+            ensureBackup();
 
             using (var realm = realmContextFactory.CreateContext())
             using (var transaction = realm.BeginWrite())
@@ -377,5 +364,18 @@ namespace osu.Game.Database
 
         private string? getRulesetShortNameFromLegacyID(long rulesetId) =>
             efContextFactory.Get().RulesetInfo.FirstOrDefault(r => r.ID == rulesetId)?.ShortName;
+
+        private void ensureBackup()
+        {
+            if (!hasTakenBackup)
+            {
+                string migration = $"before_final_migration_{DateTimeOffset.UtcNow.ToUnixTimeSeconds()}";
+
+                efContextFactory.CreateBackup($"client.{migration}.db");
+                realmContextFactory.CreateBackup($"client.{migration}.realm");
+
+                hasTakenBackup = true;
+            }
+        }
     }
 }

From fad66d7682323f8fbee433c5fa9a4b9a2083a547 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 19 Jan 2022 16:31:27 +0900
Subject: [PATCH 2327/5547] Backup collections alongside main databases when
 migrating to realm

---
 osu.Game/Database/EFToRealmMigrator.cs | 10 +++++++++-
 osu.Game/OsuGameBase.cs                |  2 +-
 2 files changed, 10 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Database/EFToRealmMigrator.cs b/osu.Game/Database/EFToRealmMigrator.cs
index 23eb794837..4c5dfe79cf 100644
--- a/osu.Game/Database/EFToRealmMigrator.cs
+++ b/osu.Game/Database/EFToRealmMigrator.cs
@@ -2,9 +2,11 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
+using System.IO;
 using System.Linq;
 using Microsoft.EntityFrameworkCore;
 using osu.Framework.Logging;
+using osu.Framework.Platform;
 using osu.Game.Beatmaps;
 using osu.Game.Configuration;
 using osu.Game.Models;
@@ -22,14 +24,16 @@ namespace osu.Game.Database
         private readonly DatabaseContextFactory efContextFactory;
         private readonly RealmContextFactory realmContextFactory;
         private readonly OsuConfigManager config;
+        private readonly Storage storage;
 
         private bool hasTakenBackup;
 
-        public EFToRealmMigrator(DatabaseContextFactory efContextFactory, RealmContextFactory realmContextFactory, OsuConfigManager config)
+        public EFToRealmMigrator(DatabaseContextFactory efContextFactory, RealmContextFactory realmContextFactory, OsuConfigManager config, Storage storage)
         {
             this.efContextFactory = efContextFactory;
             this.realmContextFactory = realmContextFactory;
             this.config = config;
+            this.storage = storage;
         }
 
         public void Run()
@@ -374,6 +378,10 @@ namespace osu.Game.Database
                 efContextFactory.CreateBackup($"client.{migration}.db");
                 realmContextFactory.CreateBackup($"client.{migration}.realm");
 
+                using (var source = storage.GetStream("collection.db"))
+                using (var destination = storage.GetStream($"collection.{migration}.db", FileAccess.Write, FileMode.CreateNew))
+                    source.CopyTo(destination);
+
                 hasTakenBackup = true;
             }
         }
diff --git a/osu.Game/OsuGameBase.cs b/osu.Game/OsuGameBase.cs
index b24fdf2bfe..fb09dac1b1 100644
--- a/osu.Game/OsuGameBase.cs
+++ b/osu.Game/OsuGameBase.cs
@@ -195,7 +195,7 @@ namespace osu.Game
 
             // A non-null context factory means there's still content to migrate.
             if (efContextFactory != null)
-                new EFToRealmMigrator(efContextFactory, realmFactory, LocalConfig).Run();
+                new EFToRealmMigrator(efContextFactory, realmFactory, LocalConfig, Storage).Run();
 
             dependencies.CacheAs(Storage);
 

From 0d708efb734571e8c2617b830b07c8406cdf5e31 Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Wed, 19 Jan 2022 15:33:33 +0800
Subject: [PATCH 2328/5547] Split off `PerformanceBreakdown` and its own
 calculation logic

---
 .../Difficulty/PerformanceBreakdown.cs        | 21 +++++
 .../PerformanceBreakdownCalculator.cs         | 90 +++++++++++++++++++
 .../Statistics/PerformanceStatistic.cs        | 80 +----------------
 .../Statistics/PerformanceStatisticTooltip.cs |  2 -
 4 files changed, 115 insertions(+), 78 deletions(-)
 create mode 100644 osu.Game/Rulesets/Difficulty/PerformanceBreakdown.cs
 create mode 100644 osu.Game/Rulesets/Difficulty/PerformanceBreakdownCalculator.cs

diff --git a/osu.Game/Rulesets/Difficulty/PerformanceBreakdown.cs b/osu.Game/Rulesets/Difficulty/PerformanceBreakdown.cs
new file mode 100644
index 0000000000..273d8613c5
--- /dev/null
+++ b/osu.Game/Rulesets/Difficulty/PerformanceBreakdown.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.
+
+namespace osu.Game.Rulesets.Difficulty
+{
+    /// <summary>
+    /// Data for generating a performance breakdown by comparing performance to a perfect play.
+    /// </summary>
+    public class PerformanceBreakdown
+    {
+        /// <summary>
+        /// Actual gameplay performance.
+        /// </summary>
+        public PerformanceAttributes Performance { get; set; }
+
+        /// <summary>
+        /// Performance of a perfect play for comparison.
+        /// </summary>
+        public PerformanceAttributes PerfectPerformance { get; set; }
+    }
+}
diff --git a/osu.Game/Rulesets/Difficulty/PerformanceBreakdownCalculator.cs b/osu.Game/Rulesets/Difficulty/PerformanceBreakdownCalculator.cs
new file mode 100644
index 0000000000..fad7937a99
--- /dev/null
+++ b/osu.Game/Rulesets/Difficulty/PerformanceBreakdownCalculator.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 System.Threading;
+using System.Threading.Tasks;
+using JetBrains.Annotations;
+using osu.Framework.Extensions;
+using osu.Game.Beatmaps;
+using osu.Game.Rulesets.Mods;
+using osu.Game.Rulesets.Scoring;
+using osu.Game.Scoring;
+
+namespace osu.Game.Rulesets.Difficulty
+{
+    public class PerformanceBreakdownCalculator
+    {
+        private readonly BeatmapManager beatmapManager;
+        private readonly BeatmapDifficultyCache difficultyCache;
+        private readonly ScorePerformanceCache performanceCache;
+
+        public PerformanceBreakdownCalculator(BeatmapManager beatmapManager, BeatmapDifficultyCache difficultyCache, ScorePerformanceCache performanceCache)
+        {
+            this.beatmapManager = beatmapManager;
+            this.difficultyCache = difficultyCache;
+            this.performanceCache = performanceCache;
+        }
+
+        [ItemCanBeNull]
+        public async Task<PerformanceBreakdown> CalculateAsync(ScoreInfo score, CancellationToken cancellationToken = default)
+        {
+            PerformanceAttributes performance = await performanceCache.CalculatePerformanceAsync(score, cancellationToken).ConfigureAwait(false);
+
+            ScoreInfo perfectScore = await getPerfectScore(score, cancellationToken).ConfigureAwait(false);
+            if (perfectScore == null)
+                return null;
+
+            PerformanceAttributes perfectPerformance = await performanceCache.CalculatePerformanceAsync(perfectScore, cancellationToken).ConfigureAwait(false);
+
+            return new PerformanceBreakdown { Performance = performance, PerfectPerformance = perfectPerformance };
+        }
+
+        [ItemCanBeNull]
+        private Task<ScoreInfo> getPerfectScore(ScoreInfo score, CancellationToken cancellationToken = default)
+        {
+            return Task.Factory.StartNew(() =>
+            {
+                IBeatmap beatmap = beatmapManager.GetWorkingBeatmap(score.BeatmapInfo).GetPlayableBeatmap(score.Ruleset, score.Mods);
+                ScoreInfo perfectPlay = score.DeepClone();
+                perfectPlay.Accuracy = 1;
+                perfectPlay.Passed = true;
+
+                // calculate max combo
+                var difficulty = difficultyCache.GetDifficultyAsync(
+                    beatmap.BeatmapInfo,
+                    score.Ruleset,
+                    score.Mods,
+                    cancellationToken
+                ).GetResultSafely();
+
+                if (difficulty == null)
+                    return null;
+
+                perfectPlay.MaxCombo = difficulty.Value.MaxCombo;
+
+                // create statistics assuming all hit objects have perfect hit result
+                var statistics = beatmap.HitObjects
+                                        .Select(ho => ho.CreateJudgement().MaxResult)
+                                        .GroupBy(hr => hr, (hr, list) => (hitResult: hr, count: list.Count()))
+                                        .ToDictionary(pair => pair.hitResult, pair => pair.count);
+                perfectPlay.Statistics = statistics;
+
+                // calculate total score
+                ScoreProcessor scoreProcessor = score.Ruleset.CreateInstance().CreateScoreProcessor();
+                perfectPlay.TotalScore = (long)scoreProcessor.GetImmediateScore(ScoringMode.Standardised, perfectPlay.MaxCombo, statistics);
+
+                // compute rank achieved
+                // default to SS, then adjust the rank with mods
+                perfectPlay.Rank = ScoreRank.X;
+
+                foreach (IApplicableToScoreProcessor mod in perfectPlay.Mods.OfType<IApplicableToScoreProcessor>())
+                {
+                    perfectPlay.Rank = mod.AdjustRank(perfectPlay.Rank, 1);
+                }
+
+                return perfectPlay;
+            }, cancellationToken);
+        }
+    }
+}
diff --git a/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatistic.cs b/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatistic.cs
index f00eb9d71f..f934dd1836 100644
--- a/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatistic.cs
+++ b/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatistic.cs
@@ -2,9 +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;
 using osu.Framework.Bindables;
 using osu.Framework.Extensions;
@@ -13,13 +11,11 @@ using osu.Framework.Graphics.Cursor;
 using osu.Game.Beatmaps;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Rulesets.Difficulty;
-using osu.Game.Rulesets.Mods;
-using osu.Game.Rulesets.Scoring;
 using osu.Game.Scoring;
 
 namespace osu.Game.Screens.Ranking.Expanded.Statistics
 {
-    public class PerformanceStatistic : StatisticDisplay, IHasCustomTooltip<PerformanceStatistic.PerformanceBreakdown>
+    public class PerformanceStatistic : StatisticDisplay, IHasCustomTooltip<PerformanceBreakdown>
     {
         private readonly ScoreInfo score;
 
@@ -47,64 +43,9 @@ namespace osu.Game.Screens.Ranking.Expanded.Statistics
         [BackgroundDependencyLoader]
         private void load()
         {
-            Task.WhenAll(
-                // actual performance
-                performanceCache.CalculatePerformanceAsync(score, cancellationTokenSource.Token),
-                // performance for a perfect play
-                getPerfectPerformance(score)
-            ).ContinueWith(attr =>
-            {
-                PerformanceAttributes[] result = attr.GetResultSafely();
-                setPerformanceValue(new PerformanceBreakdown { Performance = result[0], PerfectPerformance = result[1] });
-            });
-        }
-
-        private async Task<PerformanceAttributes> getPerfectPerformance(ScoreInfo originalScore)
-        {
-            ScoreInfo perfectScore = await getPerfectScore(originalScore).ConfigureAwait(false);
-            return await performanceCache.CalculatePerformanceAsync(perfectScore, cancellationTokenSource.Token).ConfigureAwait(false);
-        }
-
-        private Task<ScoreInfo> getPerfectScore(ScoreInfo originalScore)
-        {
-            return Task.Factory.StartNew(() =>
-            {
-                var beatmap = beatmapManager.GetWorkingBeatmap(originalScore.BeatmapInfo).GetPlayableBeatmap(originalScore.Ruleset, originalScore.Mods);
-                ScoreInfo perfectPlay = originalScore.DeepClone();
-                perfectPlay.Accuracy = 1;
-                perfectPlay.Passed = true;
-
-                // create statistics assuming all hit objects have perfect hit result
-                var statistics = beatmap.HitObjects
-                                        .Select(ho => ho.CreateJudgement().MaxResult)
-                                        .GroupBy(hr => hr, (hr, list) => (hitResult: hr, count: list.Count()))
-                                        .ToDictionary(pair => pair.hitResult, pair => pair.count);
-                perfectPlay.Statistics = statistics;
-
-                // calculate max combo
-                var difficulty = difficultyCache.GetDifficultyAsync(
-                    beatmap.BeatmapInfo,
-                    originalScore.Ruleset,
-                    originalScore.Mods,
-                    cancellationTokenSource.Token
-                ).GetResultSafely();
-                perfectPlay.MaxCombo = difficulty?.MaxCombo ?? originalScore.MaxCombo;
-
-                // calculate total score
-                ScoreProcessor scoreProcessor = originalScore.Ruleset.CreateInstance().CreateScoreProcessor();
-                perfectPlay.TotalScore = (long)scoreProcessor.GetImmediateScore(ScoringMode.Standardised, perfectPlay.MaxCombo, statistics);
-
-                // compute rank achieved
-                // default to SS, then adjust the rank with mods
-                perfectPlay.Rank = ScoreRank.X;
-
-                foreach (IApplicableToScoreProcessor mod in perfectPlay.Mods.OfType<IApplicableToScoreProcessor>())
-                {
-                    perfectPlay.Rank = mod.AdjustRank(perfectPlay.Rank, 1);
-                }
-
-                return perfectPlay;
-            }, cancellationTokenSource.Token);
+            new PerformanceBreakdownCalculator(beatmapManager, difficultyCache, performanceCache)
+                .CalculateAsync(score, cancellationTokenSource.Token)
+                .ContinueWith(t => setPerformanceValue(t.GetResultSafely()));
         }
 
         private void setPerformanceValue(PerformanceBreakdown breakdown)
@@ -137,18 +78,5 @@ namespace osu.Game.Screens.Ranking.Expanded.Statistics
         public ITooltip<PerformanceBreakdown> GetCustomTooltip() => new PerformanceStatisticTooltip();
 
         public PerformanceBreakdown TooltipContent { get; private set; }
-
-        public class PerformanceBreakdown
-        {
-            /// <summary>
-            /// Actual gameplay performance.
-            /// </summary>
-            public PerformanceAttributes Performance { get; set; }
-
-            /// <summary>
-            /// Performance of a perfect play for comparison.
-            /// </summary>
-            public PerformanceAttributes PerfectPerformance { get; set; }
-        }
     }
 }
diff --git a/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatisticTooltip.cs b/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatisticTooltip.cs
index 528ccafd41..930bfba96a 100644
--- a/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatisticTooltip.cs
+++ b/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatisticTooltip.cs
@@ -19,8 +19,6 @@ using osuTK.Graphics;
 
 namespace osu.Game.Screens.Ranking.Expanded.Statistics
 {
-    using static PerformanceStatistic;
-
     public class PerformanceStatisticTooltip : VisibilityContainer, ITooltip<PerformanceBreakdown>
     {
         private readonly Box background;

From 200fcb6f833e4cbbef4bcb485e051859b6d793cb Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 19 Jan 2022 16:59:49 +0900
Subject: [PATCH 2329/5547] Detach beatmap set before checking hidden state

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

diff --git a/osu.Game/Screens/Select/BeatmapCarousel.cs b/osu.Game/Screens/Select/BeatmapCarousel.cs
index dc67a4eb45..ea10e47cff 100644
--- a/osu.Game/Screens/Select/BeatmapCarousel.cs
+++ b/osu.Game/Screens/Select/BeatmapCarousel.cs
@@ -677,11 +677,11 @@ namespace osu.Game.Screens.Select
 
         private CarouselBeatmapSet createCarouselSet(BeatmapSetInfo beatmapSet)
         {
+            beatmapSet = beatmapSet.Detach();
+
             if (beatmapSet.Beatmaps.All(b => b.Hidden))
                 return null;
 
-            beatmapSet = beatmapSet.Detach();
-
             var set = new CarouselBeatmapSet(beatmapSet)
             {
                 GetRecommendedBeatmap = beatmaps => GetRecommendedBeatmap?.Invoke(beatmaps)

From dd42c89260c26d1cd719242c78388217f23a2f6d Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Wed, 19 Jan 2022 16:08:45 +0800
Subject: [PATCH 2330/5547] Feed more info to the temporary score processor for
 more accurate total score

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

diff --git a/osu.Game/Rulesets/Difficulty/PerformanceBreakdownCalculator.cs b/osu.Game/Rulesets/Difficulty/PerformanceBreakdownCalculator.cs
index fad7937a99..17cb1de303 100644
--- a/osu.Game/Rulesets/Difficulty/PerformanceBreakdownCalculator.cs
+++ b/osu.Game/Rulesets/Difficulty/PerformanceBreakdownCalculator.cs
@@ -72,6 +72,8 @@ namespace osu.Game.Rulesets.Difficulty
 
                 // calculate total score
                 ScoreProcessor scoreProcessor = score.Ruleset.CreateInstance().CreateScoreProcessor();
+                scoreProcessor.HighestCombo.Value = perfectPlay.MaxCombo;
+                scoreProcessor.Mods.Value = perfectPlay.Mods;
                 perfectPlay.TotalScore = (long)scoreProcessor.GetImmediateScore(ScoringMode.Standardised, perfectPlay.MaxCombo, statistics);
 
                 // compute rank achieved

From 2789986699b4f4fc77da1fe946af96e617cde4f6 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 19 Jan 2022 17:47:46 +0900
Subject: [PATCH 2331/5547] Use asynchronous loading for beatmap carousel again

---
 osu.Game/Screens/Select/BeatmapCarousel.cs | 34 ++++++++++++++++++++--
 1 file changed, 31 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Screens/Select/BeatmapCarousel.cs b/osu.Game/Screens/Select/BeatmapCarousel.cs
index ea10e47cff..7f9b19443a 100644
--- a/osu.Game/Screens/Select/BeatmapCarousel.cs
+++ b/osu.Game/Screens/Select/BeatmapCarousel.cs
@@ -181,6 +181,11 @@ namespace osu.Game.Screens.Select
 
             RightClickScrollingEnabled.ValueChanged += enabled => Scroll.RightMouseScrollbar = enabled.NewValue;
             RightClickScrollingEnabled.TriggerChange();
+
+            using (var realm = realmFactory.CreateContext())
+            {
+                loadBeatmapSets(getBeatmapSets(realm));
+            }
         }
 
         [Resolved]
@@ -190,7 +195,7 @@ namespace osu.Game.Screens.Select
         {
             base.LoadComplete();
 
-            subscriptionSets = realmFactory.Context.All<BeatmapSetInfo>().Where(s => !s.DeletePending && !s.Protected).QueryAsyncWithNotifications(beatmapSetsChanged);
+            subscriptionSets = getBeatmapSets(realmFactory.Context).QueryAsyncWithNotifications(beatmapSetsChanged);
             subscriptionBeatmaps = realmFactory.Context.All<BeatmapInfo>().Where(b => !b.Hidden).QueryAsyncWithNotifications(beatmapsChanged);
 
             // Can't use main subscriptions because we can't lookup deleted indices.
@@ -220,8 +225,29 @@ namespace osu.Game.Screens.Select
 
             if (changes == null)
             {
-                // initial load
-                loadBeatmapSets(sender);
+                // During initial population, we must manually account for the fact that our original query was done on an async thread.
+                // Since then, there may have been imports or deletions.
+                // Here we manually catch up on any changes.
+                var populatedSets = new HashSet<Guid>();
+                foreach (var s in beatmapSets)
+                    populatedSets.Add(s.BeatmapSet.ID);
+
+                var realmSets = new HashSet<Guid>();
+                foreach (var s in sender)
+                    realmSets.Add(s.ID);
+
+                foreach (var s in realmSets)
+                {
+                    if (!populatedSets.Contains(s))
+                        UpdateBeatmapSet(realmFactory.Context.Find<BeatmapSetInfo>(s));
+                }
+
+                foreach (var s in populatedSets)
+                {
+                    if (!realmSets.Contains(s))
+                        RemoveBeatmapSet(realmFactory.Context.Find<BeatmapSetInfo>(s));
+                }
+
                 return;
             }
 
@@ -242,6 +268,8 @@ namespace osu.Game.Screens.Select
                 UpdateBeatmapSet(sender[i].BeatmapSet);
         }
 
+        private IRealmCollection<BeatmapSetInfo> getBeatmapSets(Realm realm) => realm.All<BeatmapSetInfo>().Where(s => !s.DeletePending && !s.Protected).AsRealmCollection();
+
         public void RemoveBeatmapSet(BeatmapSetInfo beatmapSet) => Schedule(() =>
         {
             var existingSet = beatmapSets.FirstOrDefault(b => b.BeatmapSet.Equals(beatmapSet));

From 6c46fd6931a73f3329964c2e97ba5b650832edc5 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 20 Jan 2022 00:14:00 +0900
Subject: [PATCH 2332/5547] Fix some failing tests due to realm beatmaps
 overwriting test beatmaps

---
 osu.Game/Screens/Select/BeatmapCarousel.cs | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/Select/BeatmapCarousel.cs b/osu.Game/Screens/Select/BeatmapCarousel.cs
index 7f9b19443a..2dc9bfba0f 100644
--- a/osu.Game/Screens/Select/BeatmapCarousel.cs
+++ b/osu.Game/Screens/Select/BeatmapCarousel.cs
@@ -182,9 +182,10 @@ namespace osu.Game.Screens.Select
             RightClickScrollingEnabled.ValueChanged += enabled => Scroll.RightMouseScrollbar = enabled.NewValue;
             RightClickScrollingEnabled.TriggerChange();
 
-            using (var realm = realmFactory.CreateContext())
+            if (!loadedTestBeatmaps)
             {
-                loadBeatmapSets(getBeatmapSets(realm));
+                using (var realm = realmFactory.CreateContext())
+                    loadBeatmapSets(getBeatmapSets(realm));
             }
         }
 

From fea4400c030f6eabad7bf476a0c536e473fa07db Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 19 Jan 2022 18:49:37 +0100
Subject: [PATCH 2333/5547] Remove unused using directive

---
 osu.Game.Tests/NonVisual/ScoreInfoTest.cs | 1 -
 1 file changed, 1 deletion(-)

diff --git a/osu.Game.Tests/NonVisual/ScoreInfoTest.cs b/osu.Game.Tests/NonVisual/ScoreInfoTest.cs
index ea2f50f3bb..e0acc6d8db 100644
--- a/osu.Game.Tests/NonVisual/ScoreInfoTest.cs
+++ b/osu.Game.Tests/NonVisual/ScoreInfoTest.cs
@@ -6,7 +6,6 @@ using osu.Game.Online.API;
 using osu.Game.Rulesets.Mania;
 using osu.Game.Rulesets.Mania.Mods;
 using osu.Game.Rulesets.Mods;
-using osu.Game.Rulesets.Osu.Mods;
 using osu.Game.Rulesets.Scoring;
 using osu.Game.Scoring;
 

From a27a3b308cd204cbaddd52f7fbaf20020925d635 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 20 Jan 2022 04:34:00 +0900
Subject: [PATCH 2334/5547] Remove duplicate setters

---
 osu.Game/Database/EFToRealmMigrator.cs | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/osu.Game/Database/EFToRealmMigrator.cs b/osu.Game/Database/EFToRealmMigrator.cs
index 5e49a44733..717d18b9e5 100644
--- a/osu.Game/Database/EFToRealmMigrator.cs
+++ b/osu.Game/Database/EFToRealmMigrator.cs
@@ -263,15 +263,12 @@ namespace osu.Game.Database
                                 OnlineID = score.OnlineID ?? -1,
                                 ModsJson = score.ModsJson,
                                 StatisticsJson = score.StatisticsJson,
-                                User = score.User,
                                 TotalScore = score.TotalScore,
                                 MaxCombo = score.MaxCombo,
                                 Accuracy = score.Accuracy,
                                 HasReplay = ((IScoreInfo)score).HasReplay,
                                 Date = score.Date,
                                 PP = score.PP,
-                                BeatmapInfo = beatmap,
-                                Ruleset = ruleset,
                                 Rank = score.Rank,
                                 HitEvents = score.HitEvents,
                                 Passed = score.Passed,

From d925e44b40c087b1e3ca0f0c1e6030f7b372513b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 19 Jan 2022 22:02:01 +0100
Subject: [PATCH 2335/5547] Add test coverage for beatmap card expanded content
 clipping

---
 .../Online/TestSceneBeatmapListingOverlay.cs  | 28 +++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneBeatmapListingOverlay.cs b/osu.Game.Tests/Visual/Online/TestSceneBeatmapListingOverlay.cs
index d0e3340f2a..a056e0cd2c 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneBeatmapListingOverlay.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneBeatmapListingOverlay.cs
@@ -8,6 +8,7 @@ using NUnit.Framework;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps.Drawables.Cards;
+using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests;
@@ -292,6 +293,33 @@ namespace osu.Game.Tests.Visual.Online
             noPlaceholderShown();
         }
 
+        [Test]
+        public void TestExpandedCardContentNotClipped()
+        {
+            AddAssert("is visible", () => overlay.State.Value == Visibility.Visible);
+
+            AddStep("show result with many difficulties", () =>
+            {
+                var beatmapSet = CreateAPIBeatmapSet(Ruleset.Value);
+                beatmapSet.Beatmaps = Enumerable.Repeat(beatmapSet.Beatmaps.First(), 100).ToArray();
+                fetchFor(beatmapSet);
+            });
+            assertAllCardsOfType<BeatmapCardNormal>(1);
+
+            AddStep("hover extra info row", () =>
+            {
+                var difficultyArea = this.ChildrenOfType<BeatmapCardExtraInfoRow>().Single();
+                InputManager.MoveMouseTo(difficultyArea);
+            });
+            AddUntilStep("wait for expanded", () => this.ChildrenOfType<BeatmapCardNormal>().Single().Expanded.Value);
+            AddAssert("expanded content not clipped", () =>
+            {
+                var cardContainer = this.ChildrenOfType<ReverseChildIDFillFlowContainer<BeatmapCard>>().Single().Parent;
+                var expandedContent = this.ChildrenOfType<ExpandedContentScrollContainer>().Single();
+                return expandedContent.ScreenSpaceDrawQuad.GetVertices().ToArray().All(v => cardContainer.ScreenSpaceDrawQuad.Contains(v));
+            });
+        }
+
         private static int searchCount;
 
         private void fetchFor(params APIBeatmapSet[] beatmaps)

From 33ab356dc53439c5a69f3d322c3e011e5069f11c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 19 Jan 2022 22:10:05 +0100
Subject: [PATCH 2336/5547] Fix expanded card content being clipped on beatmap
 listing overlay

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

diff --git a/osu.Game/Overlays/BeatmapListingOverlay.cs b/osu.Game/Overlays/BeatmapListingOverlay.cs
index a8e5201aa3..fbed234cc7 100644
--- a/osu.Game/Overlays/BeatmapListingOverlay.cs
+++ b/osu.Game/Overlays/BeatmapListingOverlay.cs
@@ -187,8 +187,10 @@ namespace osu.Game.Overlays
                 Alpha = 0,
                 Margin = new MarginPadding
                 {
-                    Vertical = 15,
-                    Bottom = ExpandedContentScrollContainer.HEIGHT
+                    Top = 15,
+                    // the + 20 adjustment is roughly eyeballed in order to fit all of the expanded content height after it's scaled
+                    // as well as provide visual balance to the top margin.
+                    Bottom = ExpandedContentScrollContainer.HEIGHT + 20
                 },
                 ChildrenEnumerable = newCards
             };

From 77748a5f9308e8434d6e607381eed758c4428000 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 19 Jan 2022 22:21:05 +0100
Subject: [PATCH 2337/5547] Show scrollbar on expanded card content where
 applicable

---
 .../Drawables/Cards/ExpandedContentScrollContainer.cs       | 6 +-----
 1 file changed, 1 insertion(+), 5 deletions(-)

diff --git a/osu.Game/Beatmaps/Drawables/Cards/ExpandedContentScrollContainer.cs b/osu.Game/Beatmaps/Drawables/Cards/ExpandedContentScrollContainer.cs
index edf4c5328c..2e1ad6b516 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/ExpandedContentScrollContainer.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/ExpandedContentScrollContainer.cs
@@ -12,16 +12,12 @@ namespace osu.Game.Beatmaps.Drawables.Cards
     {
         public const float HEIGHT = 200;
 
-        public ExpandedContentScrollContainer()
-        {
-            ScrollbarVisible = false;
-        }
-
         protected override void Update()
         {
             base.Update();
 
             Height = Math.Min(Content.DrawHeight, HEIGHT);
+            ScrollbarVisible = allowScroll;
         }
 
         private bool allowScroll => !Precision.AlmostEquals(DrawSize, Content.DrawSize);

From 247c557eaf3a2abe25d693a0a7797d5d4ab0ce3f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 19 Jan 2022 22:30:49 +0100
Subject: [PATCH 2338/5547] Fix expanded content scrollbar inadvertently hiding
 expanded content

---
 .../Cards/ExpandedContentScrollContainer.cs   | 20 +++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/osu.Game/Beatmaps/Drawables/Cards/ExpandedContentScrollContainer.cs b/osu.Game/Beatmaps/Drawables/Cards/ExpandedContentScrollContainer.cs
index 2e1ad6b516..adde72d1e8 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/ExpandedContentScrollContainer.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/ExpandedContentScrollContainer.cs
@@ -2,6 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
+using osu.Framework.Graphics;
 using osu.Framework.Input.Events;
 using osu.Framework.Utils;
 using osu.Game.Graphics.Containers;
@@ -12,6 +13,8 @@ namespace osu.Game.Beatmaps.Drawables.Cards
     {
         public const float HEIGHT = 200;
 
+        protected override ScrollbarContainer CreateScrollbar(Direction direction) => new ExpandedContentScrollbar(direction);
+
         protected override void Update()
         {
             base.Update();
@@ -53,5 +56,22 @@ namespace osu.Game.Beatmaps.Drawables.Cards
 
             return base.OnScroll(e);
         }
+
+        private class ExpandedContentScrollbar : OsuScrollbar
+        {
+            public ExpandedContentScrollbar(Direction scrollDir)
+                : base(scrollDir)
+            {
+            }
+
+            protected override bool OnHover(HoverEvent e)
+            {
+                base.OnHover(e);
+                // do not handle hover, as handling hover would make the beatmap card's expanded content not-hovered
+                // and therefore cause it to hide when trying to drag the scroll bar.
+                // see: `BeatmapCardContent.dropdownContent` and its `Unhovered` handler.
+                return false;
+            }
+        }
     }
 }

From 4cad5890c608d5b5a8d3497e99a4b029444de668 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 19 Jan 2022 23:12:35 +0100
Subject: [PATCH 2339/5547] Add test coverage for news sidebar showing wrong
 headers

---
 .../Visual/Online/TestSceneNewsSidebar.cs     | 76 +++++++++++++++++++
 .../Overlays/News/Sidebar/MonthSection.cs     |  9 ++-
 2 files changed, 83 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneNewsSidebar.cs b/osu.Game.Tests/Visual/Online/TestSceneNewsSidebar.cs
index b000553a7b..382d76676a 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneNewsSidebar.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneNewsSidebar.cs
@@ -38,6 +38,14 @@ namespace osu.Game.Tests.Visual.Online
             AddUntilStep("No month sections were created", () => !sidebar.ChildrenOfType<MonthSection>().Any());
         }
 
+        [Test]
+        public void TestMetadataWithMultipleYears()
+        {
+            AddStep("Add data spanning multiple years", () => sidebar.Metadata.Value = metadata_with_multiple_years);
+            AddUntilStep("2022 month sections exist", () => sidebar.ChildrenOfType<MonthSection>().Any(s => s.Year == 2022));
+            AddUntilStep("2021 month sections exist", () => sidebar.ChildrenOfType<MonthSection>().Any(s => s.Year == 2021));
+        }
+
         [Test]
         public void TestYearsPanelVisibility()
         {
@@ -133,6 +141,74 @@ namespace osu.Game.Tests.Visual.Online
             NewsPosts = Array.Empty<APINewsPost>()
         };
 
+        // see https://osu.ppy.sh/docs/index.html#get-news-listing:
+        // "NewsPost collections queried by year will also include posts published in November and December of the previous year if the current date is the same year and before April."
+        private static readonly APINewsSidebar metadata_with_multiple_years = new APINewsSidebar
+        {
+            CurrentYear = 2022,
+            Years = new[]
+            {
+                2022,
+                2021,
+                2020,
+                2019,
+                2018,
+                2017,
+                2016,
+                2015,
+                2014,
+                2013
+            },
+            NewsPosts = new List<APINewsPost>
+            {
+                new APINewsPost
+                {
+                    Title = "(Mar 2022) Short title",
+                    PublishedAt = new DateTime(2022, 3, 1)
+                },
+                new APINewsPost
+                {
+                    Title = "(Mar 2022) Oh boy that's a long post title I wonder if it will break anything",
+                    PublishedAt = new DateTime(2022, 3, 1)
+                },
+                new APINewsPost
+                {
+                    Title = "(Feb 2022) Medium title, nothing to see here",
+                    PublishedAt = new DateTime(2022, 2, 1)
+                },
+                new APINewsPost
+                {
+                    Title = "(Feb 2022) Short title",
+                    PublishedAt = new DateTime(2022, 2, 1)
+                },
+                new APINewsPost
+                {
+                    Title = "(Jan 2022) Oh boy that's a long post title I wonder if it will break anything",
+                    PublishedAt = new DateTime(2022, 1, 1)
+                },
+                new APINewsPost
+                {
+                    Title = "(Jan 2022) Medium title, nothing to see here",
+                    PublishedAt = new DateTime(2022, 1, 1)
+                },
+                new APINewsPost
+                {
+                    Title = "(Jan 2022) Short title",
+                    PublishedAt = new DateTime(2022, 1, 1)
+                },
+                new APINewsPost
+                {
+                    Title = "(Dec 2021) Surprise, the last year's not gone yet",
+                    PublishedAt = new DateTime(2021, 12, 1)
+                },
+                new APINewsPost
+                {
+                    Title = "(Nov 2021) Same goes for November",
+                    PublishedAt = new DateTime(2021, 11, 1)
+                }
+            }
+        };
+
         private class TestNewsSidebar : NewsSidebar
         {
             public Action<int> YearChanged;
diff --git a/osu.Game/Overlays/News/Sidebar/MonthSection.cs b/osu.Game/Overlays/News/Sidebar/MonthSection.cs
index 948f312f15..aa83f89689 100644
--- a/osu.Game/Overlays/News/Sidebar/MonthSection.cs
+++ b/osu.Game/Overlays/News/Sidebar/MonthSection.cs
@@ -24,16 +24,21 @@ namespace osu.Game.Overlays.News.Sidebar
 {
     public class MonthSection : CompositeDrawable
     {
+        public int Year { get; private set; }
+        public int Month { get; private set; }
+        public readonly BindableBool Expanded = new BindableBool();
+
         private const int animation_duration = 250;
         private Sample sampleOpen;
         private Sample sampleClose;
 
-        public readonly BindableBool Expanded = new BindableBool();
-
         public MonthSection(int month, int year, IEnumerable<APINewsPost> posts)
         {
             Debug.Assert(posts.All(p => p.PublishedAt.Month == month && p.PublishedAt.Year == year));
 
+            Year = year;
+            Month = month;
+
             RelativeSizeAxes = Axes.X;
             AutoSizeAxes = Axes.Y;
             Masking = true;

From b8184a3005ab8f412ecc1790893b533e1beb429f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 19 Jan 2022 23:13:30 +0100
Subject: [PATCH 2340/5547] Fix news sidebar assuming returned posts are always
 from given year

---
 osu.Game/Overlays/News/Sidebar/NewsSidebar.cs | 12 +++++-------
 1 file changed, 5 insertions(+), 7 deletions(-)

diff --git a/osu.Game/Overlays/News/Sidebar/NewsSidebar.cs b/osu.Game/Overlays/News/Sidebar/NewsSidebar.cs
index fe965385d8..829fc5b3eb 100644
--- a/osu.Game/Overlays/News/Sidebar/NewsSidebar.cs
+++ b/osu.Game/Overlays/News/Sidebar/NewsSidebar.cs
@@ -56,19 +56,17 @@ namespace osu.Game.Overlays.News.Sidebar
             if (allPosts?.Any() != true)
                 return;
 
-            var lookup = metadata.NewValue.NewsPosts.ToLookup(post => post.PublishedAt.Month);
+            var lookup = metadata.NewValue.NewsPosts.ToLookup(post => (post.PublishedAt.Month, post.PublishedAt.Year));
 
             var keys = lookup.Select(kvp => kvp.Key);
-            var sortedKeys = keys.OrderByDescending(k => k).ToList();
-
-            int year = metadata.NewValue.CurrentYear;
+            var sortedKeys = keys.OrderByDescending(k => k.Year).ThenByDescending(k => k.Month).ToList();
 
             for (int i = 0; i < sortedKeys.Count; i++)
             {
-                int month = sortedKeys[i];
-                var posts = lookup[month];
+                var key = sortedKeys[i];
+                var posts = lookup[key];
 
-                monthsFlow.Add(new MonthSection(month, year, posts)
+                monthsFlow.Add(new MonthSection(key.Month, key.Year, posts)
                 {
                     Expanded = { Value = i == 0 }
                 });

From 261fae68735ef6df0b43c9d1599869972ba18a1c Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Thu, 20 Jan 2022 08:39:33 +0800
Subject: [PATCH 2341/5547] Move checks out of PopIn()

---
 .../Ranking/Expanded/Statistics/PerformanceStatistic.cs    | 4 +++-
 .../Expanded/Statistics/PerformanceStatisticTooltip.cs     | 7 +------
 2 files changed, 4 insertions(+), 7 deletions(-)

diff --git a/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatistic.cs b/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatistic.cs
index f934dd1836..bda147cf22 100644
--- a/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatistic.cs
+++ b/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatistic.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 osu.Framework.Allocation;
 using osu.Framework.Bindables;
@@ -50,7 +51,8 @@ namespace osu.Game.Screens.Ranking.Expanded.Statistics
 
         private void setPerformanceValue(PerformanceBreakdown breakdown)
         {
-            if (breakdown != null)
+            // Don't display the tooltip if "Total" is the only item
+            if (breakdown != null && breakdown.Performance.GetAttributesForDisplay().Count() > 1)
             {
                 TooltipContent = breakdown;
                 performance.Value = (int)Math.Round(breakdown.Performance.Total, MidpointRounding.AwayFromZero);
diff --git a/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatisticTooltip.cs b/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatisticTooltip.cs
index 930bfba96a..44e5c366bb 100644
--- a/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatisticTooltip.cs
+++ b/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatisticTooltip.cs
@@ -56,12 +56,7 @@ namespace osu.Game.Screens.Ranking.Expanded.Statistics
             textColour = colours.BlueLighter;
         }
 
-        protected override void PopIn()
-        {
-            // Don't display the tooltip if "Total" is the only item
-            if (currentPerformance.Performance.GetAttributesForDisplay().Count() > 1)
-                this.FadeIn(200, Easing.OutQuint);
-        }
+        protected override void PopIn() => this.FadeIn(200, Easing.OutQuint);
 
         protected override void PopOut() => this.FadeOut(200, Easing.OutQuint);
 

From 42d904acee23490e51086cbae21fd9bf3aff9045 Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Thu, 20 Jan 2022 12:50:28 +0800
Subject: [PATCH 2342/5547] Remove blocking calls and add back Task.WhenAll

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

diff --git a/osu.Game/Rulesets/Difficulty/PerformanceBreakdownCalculator.cs b/osu.Game/Rulesets/Difficulty/PerformanceBreakdownCalculator.cs
index 17cb1de303..3c9c00ff3b 100644
--- a/osu.Game/Rulesets/Difficulty/PerformanceBreakdownCalculator.cs
+++ b/osu.Game/Rulesets/Difficulty/PerformanceBreakdownCalculator.cs
@@ -5,7 +5,6 @@ using System.Linq;
 using System.Threading;
 using System.Threading.Tasks;
 using JetBrains.Annotations;
-using osu.Framework.Extensions;
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Scoring;
@@ -29,21 +28,30 @@ namespace osu.Game.Rulesets.Difficulty
         [ItemCanBeNull]
         public async Task<PerformanceBreakdown> CalculateAsync(ScoreInfo score, CancellationToken cancellationToken = default)
         {
-            PerformanceAttributes performance = await performanceCache.CalculatePerformanceAsync(score, cancellationToken).ConfigureAwait(false);
+            PerformanceAttributes[] performanceArray = await Task.WhenAll(
+                // compute actual performance
+                performanceCache.CalculatePerformanceAsync(score, cancellationToken),
+                // compute performance for perfect play
+                getPerfectPerformance(score, cancellationToken)
+            ).ConfigureAwait(false);
 
+            return new PerformanceBreakdown { Performance = performanceArray[0], PerfectPerformance = performanceArray[1] };
+        }
+
+        [ItemCanBeNull]
+        private async Task<PerformanceAttributes> getPerfectPerformance(ScoreInfo score, CancellationToken cancellationToken = default)
+        {
             ScoreInfo perfectScore = await getPerfectScore(score, cancellationToken).ConfigureAwait(false);
             if (perfectScore == null)
                 return null;
 
-            PerformanceAttributes perfectPerformance = await performanceCache.CalculatePerformanceAsync(perfectScore, cancellationToken).ConfigureAwait(false);
-
-            return new PerformanceBreakdown { Performance = performance, PerfectPerformance = perfectPerformance };
+            return await performanceCache.CalculatePerformanceAsync(perfectScore, cancellationToken).ConfigureAwait(false);
         }
 
         [ItemCanBeNull]
         private Task<ScoreInfo> getPerfectScore(ScoreInfo score, CancellationToken cancellationToken = default)
         {
-            return Task.Factory.StartNew(() =>
+            return Task.Run(async () =>
             {
                 IBeatmap beatmap = beatmapManager.GetWorkingBeatmap(score.BeatmapInfo).GetPlayableBeatmap(score.Ruleset, score.Mods);
                 ScoreInfo perfectPlay = score.DeepClone();
@@ -51,12 +59,12 @@ namespace osu.Game.Rulesets.Difficulty
                 perfectPlay.Passed = true;
 
                 // calculate max combo
-                var difficulty = difficultyCache.GetDifficultyAsync(
+                var difficulty = await difficultyCache.GetDifficultyAsync(
                     beatmap.BeatmapInfo,
                     score.Ruleset,
                     score.Mods,
                     cancellationToken
-                ).GetResultSafely();
+                ).ConfigureAwait(false);
 
                 if (difficulty == null)
                     return null;

From 6c97fbd3f28f8374822e41950ca293a3d5a1e62f Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Thu, 20 Jan 2022 13:06:00 +0800
Subject: [PATCH 2343/5547] Calculate perfect performance without caching

---
 .../PerformanceBreakdownCalculator.cs         | 19 ++++++-------------
 1 file changed, 6 insertions(+), 13 deletions(-)

diff --git a/osu.Game/Rulesets/Difficulty/PerformanceBreakdownCalculator.cs b/osu.Game/Rulesets/Difficulty/PerformanceBreakdownCalculator.cs
index 3c9c00ff3b..5cf63d0102 100644
--- a/osu.Game/Rulesets/Difficulty/PerformanceBreakdownCalculator.cs
+++ b/osu.Game/Rulesets/Difficulty/PerformanceBreakdownCalculator.cs
@@ -39,20 +39,11 @@ namespace osu.Game.Rulesets.Difficulty
         }
 
         [ItemCanBeNull]
-        private async Task<PerformanceAttributes> getPerfectPerformance(ScoreInfo score, CancellationToken cancellationToken = default)
-        {
-            ScoreInfo perfectScore = await getPerfectScore(score, cancellationToken).ConfigureAwait(false);
-            if (perfectScore == null)
-                return null;
-
-            return await performanceCache.CalculatePerformanceAsync(perfectScore, cancellationToken).ConfigureAwait(false);
-        }
-
-        [ItemCanBeNull]
-        private Task<ScoreInfo> getPerfectScore(ScoreInfo score, CancellationToken cancellationToken = default)
+        private Task<PerformanceAttributes> getPerfectPerformance(ScoreInfo score, CancellationToken cancellationToken = default)
         {
             return Task.Run(async () =>
             {
+                Ruleset ruleset = score.Ruleset.CreateInstance();
                 IBeatmap beatmap = beatmapManager.GetWorkingBeatmap(score.BeatmapInfo).GetPlayableBeatmap(score.Ruleset, score.Mods);
                 ScoreInfo perfectPlay = score.DeepClone();
                 perfectPlay.Accuracy = 1;
@@ -79,7 +70,7 @@ namespace osu.Game.Rulesets.Difficulty
                 perfectPlay.Statistics = statistics;
 
                 // calculate total score
-                ScoreProcessor scoreProcessor = score.Ruleset.CreateInstance().CreateScoreProcessor();
+                ScoreProcessor scoreProcessor = ruleset.CreateScoreProcessor();
                 scoreProcessor.HighestCombo.Value = perfectPlay.MaxCombo;
                 scoreProcessor.Mods.Value = perfectPlay.Mods;
                 perfectPlay.TotalScore = (long)scoreProcessor.GetImmediateScore(ScoringMode.Standardised, perfectPlay.MaxCombo, statistics);
@@ -93,7 +84,9 @@ namespace osu.Game.Rulesets.Difficulty
                     perfectPlay.Rank = mod.AdjustRank(perfectPlay.Rank, 1);
                 }
 
-                return perfectPlay;
+                // calculate performance for this perfect score
+                // ScorePerformanceCache is not used to avoid caching multiple copies of essentially identical perfect performance attributes
+                return ruleset.CreatePerformanceCalculator(difficulty.Value.Attributes, perfectPlay)?.Calculate();
             }, cancellationToken);
         }
     }

From 1dabf6c8a52cf176a2acae19e4b571b599b93347 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 20 Jan 2022 16:39:42 +0900
Subject: [PATCH 2344/5547] Fix `BeatmapCarousel` signalling it is finished
 loading before catching up on realm changes

---
 osu.Game/Screens/Select/BeatmapCarousel.cs | 21 +++++++++++++--------
 1 file changed, 13 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Screens/Select/BeatmapCarousel.cs b/osu.Game/Screens/Select/BeatmapCarousel.cs
index 2dc9bfba0f..437567d4b2 100644
--- a/osu.Game/Screens/Select/BeatmapCarousel.cs
+++ b/osu.Game/Screens/Select/BeatmapCarousel.cs
@@ -126,14 +126,8 @@ namespace osu.Game.Screens.Select
 
             applyActiveCriteria(false);
 
-            // Run on late scheduler want to ensure this runs after all pending UpdateBeatmapSet / RemoveBeatmapSet operations are run.
-            SchedulerAfterChildren.Add(() =>
-            {
-                BeatmapSetsChanged?.Invoke();
-                BeatmapSetsLoaded = true;
-
-                itemsCache.Invalidate();
-            });
+            if (loadedTestBeatmaps)
+                signalBeatmapsLoaded();
         }
 
         private readonly List<CarouselItem> visibleItems = new List<CarouselItem>();
@@ -249,6 +243,7 @@ namespace osu.Game.Screens.Select
                         RemoveBeatmapSet(realmFactory.Context.Find<BeatmapSetInfo>(s));
                 }
 
+                signalBeatmapsLoaded();
                 return;
             }
 
@@ -547,6 +542,16 @@ namespace osu.Game.Screens.Select
             }
         }
 
+        private void signalBeatmapsLoaded()
+        {
+            Debug.Assert(BeatmapSetsLoaded == false);
+
+            BeatmapSetsChanged?.Invoke();
+            BeatmapSetsLoaded = true;
+
+            itemsCache.Invalidate();
+        }
+
         private float? scrollTarget;
 
         /// <summary>

From 3faf980fed86b494f4c6a8337fa8c6480a58bc13 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 18 Jan 2022 22:51:45 +0900
Subject: [PATCH 2345/5547] Avoid constructor overhead for realm `BeatmapInfo`
 parameterless constructor

---
 osu.Game/Beatmaps/BeatmapInfo.cs | 30 ++++++++++++++----------------
 1 file changed, 14 insertions(+), 16 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapInfo.cs b/osu.Game/Beatmaps/BeatmapInfo.cs
index cddd7e9b30..1ea1c8ab4c 100644
--- a/osu.Game/Beatmaps/BeatmapInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapInfo.cs
@@ -26,37 +26,35 @@ namespace osu.Game.Beatmaps
     public class BeatmapInfo : RealmObject, IHasGuidPrimaryKey, IBeatmapInfo, IEquatable<BeatmapInfo>
     {
         [PrimaryKey]
-        public Guid ID { get; set; } = Guid.NewGuid();
+        public Guid ID { get; set; }
 
         public string DifficultyName { get; set; } = string.Empty;
 
-        public RulesetInfo Ruleset { get; set; }
+        public RulesetInfo Ruleset { get; set; } = null!;
 
-        public BeatmapDifficulty Difficulty { get; set; }
+        public BeatmapDifficulty Difficulty { get; set; } = null!;
 
-        public BeatmapMetadata Metadata { get; set; }
+        public BeatmapMetadata Metadata { get; set; } = null!;
 
         [Backlink(nameof(ScoreInfo.BeatmapInfo))]
         public IQueryable<ScoreInfo> Scores { get; } = null!;
 
-        public BeatmapInfo(RulesetInfo ruleset, BeatmapDifficulty difficulty, BeatmapMetadata metadata)
+        public BeatmapInfo(RulesetInfo? ruleset = null, BeatmapDifficulty? difficulty = null, BeatmapMetadata? metadata = null)
         {
-            Ruleset = ruleset;
-            Difficulty = difficulty;
-            Metadata = metadata;
-        }
-
-        [UsedImplicitly]
-        public BeatmapInfo() // TODO: consider removing this and migrating all usages to ctor with parameters.
-        {
-            Ruleset = new RulesetInfo
+            ID = Guid.NewGuid();
+            Ruleset = ruleset ?? new RulesetInfo
             {
                 OnlineID = 0,
                 ShortName = @"osu",
                 Name = @"null placeholder ruleset"
             };
-            Difficulty = new BeatmapDifficulty();
-            Metadata = new BeatmapMetadata();
+            Difficulty = difficulty ?? new BeatmapDifficulty();
+            Metadata = metadata ?? new BeatmapMetadata();
+        }
+
+        [UsedImplicitly]
+        private BeatmapInfo()
+        {
         }
 
         public BeatmapSetInfo? BeatmapSet { get; set; }

From 3c852e6d025d9fc3503c28f266ee66c9d99e5d77 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 20 Jan 2022 16:43:51 +0900
Subject: [PATCH 2346/5547] Avoid constructor overhead for realm `ScoreInfo`
 parameterless constructor

---
 osu.Game/Scoring/ScoreInfo.cs | 24 +++++++++++-------------
 1 file changed, 11 insertions(+), 13 deletions(-)

diff --git a/osu.Game/Scoring/ScoreInfo.cs b/osu.Game/Scoring/ScoreInfo.cs
index cfc37e956d..a28e16450f 100644
--- a/osu.Game/Scoring/ScoreInfo.cs
+++ b/osu.Game/Scoring/ScoreInfo.cs
@@ -29,11 +29,11 @@ namespace osu.Game.Scoring
     public class ScoreInfo : RealmObject, IHasGuidPrimaryKey, IHasRealmFiles, ISoftDelete, IEquatable<ScoreInfo>, IScoreInfo
     {
         [PrimaryKey]
-        public Guid ID { get; set; } = Guid.NewGuid();
+        public Guid ID { get; set; }
 
-        public BeatmapInfo BeatmapInfo { get; set; }
+        public BeatmapInfo BeatmapInfo { get; set; } = null!;
 
-        public RulesetInfo Ruleset { get; set; }
+        public RulesetInfo Ruleset { get; set; } = null!;
 
         public IList<RealmNamedFileUsage> Files { get; } = null!;
 
@@ -57,7 +57,7 @@ namespace osu.Game.Scoring
         public long OnlineID { get; set; } = -1;
 
         [MapTo("User")]
-        public RealmUser RealmUser { get; set; }
+        public RealmUser RealmUser { get; set; } = null!;
 
         [MapTo("Mods")]
         public string ModsJson { get; set; } = string.Empty;
@@ -65,19 +65,17 @@ namespace osu.Game.Scoring
         [MapTo("Statistics")]
         public string StatisticsJson { get; set; } = string.Empty;
 
-        public ScoreInfo(BeatmapInfo beatmap, RulesetInfo ruleset, RealmUser realmUser)
+        public ScoreInfo(BeatmapInfo? beatmap = null, RulesetInfo? ruleset = null, RealmUser? realmUser = null)
         {
-            Ruleset = ruleset;
-            BeatmapInfo = beatmap;
-            RealmUser = realmUser;
+            Ruleset = ruleset ?? new RulesetInfo();
+            BeatmapInfo = beatmap ?? new BeatmapInfo();
+            RealmUser = realmUser ?? new RealmUser();
+            ID = Guid.NewGuid();
         }
 
-        [UsedImplicitly]
-        public ScoreInfo() // TODO: consider removing this and migrating all usages to ctor with parameters.
+        [UsedImplicitly] // Realm
+        private ScoreInfo()
         {
-            Ruleset = new RulesetInfo();
-            RealmUser = new RealmUser();
-            BeatmapInfo = new BeatmapInfo();
         }
 
         // TODO: this is a bit temporary to account for the fact that this class is used to ferry API user data to certain UI components.

From ccddf9b47d94d9f7a3b00aa0e05c577f886e13ae Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 20 Jan 2022 16:49:39 +0900
Subject: [PATCH 2347/5547] Avoid constructor overhead for realm
 `BeatmapSetInfo` parameterless constructor

---
 osu.Game/Beatmaps/BeatmapSetInfo.cs        | 16 +++++++++++++++-
 osu.Game/Database/RealmObjectExtensions.cs |  3 +++
 2 files changed, 18 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Beatmaps/BeatmapSetInfo.cs b/osu.Game/Beatmaps/BeatmapSetInfo.cs
index a934d1a2e3..3cda111e97 100644
--- a/osu.Game/Beatmaps/BeatmapSetInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapSetInfo.cs
@@ -4,6 +4,7 @@
 using System;
 using System.Collections.Generic;
 using System.Linq;
+using JetBrains.Annotations;
 using osu.Framework.Testing;
 using osu.Game.Database;
 using osu.Game.Extensions;
@@ -19,7 +20,7 @@ namespace osu.Game.Beatmaps
     public class BeatmapSetInfo : RealmObject, IHasGuidPrimaryKey, IHasRealmFiles, ISoftDelete, IEquatable<BeatmapSetInfo>, IBeatmapSetInfo
     {
         [PrimaryKey]
-        public Guid ID { get; set; } = Guid.NewGuid();
+        public Guid ID { get; set; }
 
         [Indexed]
         public int OnlineID { get; set; } = -1;
@@ -57,6 +58,19 @@ namespace osu.Game.Beatmaps
 
         public double MaxBPM => Beatmaps.Count == 0 ? 0 : Beatmaps.Max(b => b.BPM);
 
+        public BeatmapSetInfo(IEnumerable<BeatmapInfo>? beatmaps = null)
+            : this()
+        {
+            ID = Guid.NewGuid();
+            if (beatmaps != null)
+                Beatmaps.AddRange(beatmaps);
+        }
+
+        [UsedImplicitly] // Realm
+        private BeatmapSetInfo()
+        {
+        }
+
         /// <summary>
         /// Returns the storage path for the file in this beatmapset with the given filename, if any exists, otherwise null.
         /// The path returned is relative to the user file storage.
diff --git a/osu.Game/Database/RealmObjectExtensions.cs b/osu.Game/Database/RealmObjectExtensions.cs
index 746a43fd37..c25aeab336 100644
--- a/osu.Game/Database/RealmObjectExtensions.cs
+++ b/osu.Game/Database/RealmObjectExtensions.cs
@@ -48,6 +48,7 @@ namespace osu.Game.Database
                  copyChangesToRealm(s.Metadata, d.Metadata);
              });
             c.CreateMap<BeatmapSetInfo, BeatmapSetInfo>()
+             .ConstructUsing(_ => new BeatmapSetInfo(null))
              .ForMember(s => s.Beatmaps, cc => cc.Ignore())
              .AfterMap((s, d) =>
              {
@@ -77,6 +78,7 @@ namespace osu.Game.Database
             applyCommonConfiguration(c);
 
             c.CreateMap<BeatmapSetInfo, BeatmapSetInfo>()
+             .ConstructUsing(_ => new BeatmapSetInfo(null))
              .MaxDepth(2)
              .AfterMap((s, d) =>
              {
@@ -109,6 +111,7 @@ namespace osu.Game.Database
             applyCommonConfiguration(c);
 
             c.CreateMap<BeatmapSetInfo, BeatmapSetInfo>()
+             .ConstructUsing(_ => new BeatmapSetInfo(null))
              .MaxDepth(2)
              .ForMember(b => b.Files, cc => cc.Ignore())
              .AfterMap((s, d) =>

From deb108816cd17e92f5700391e65bd03e34aa7e70 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 20 Jan 2022 17:09:31 +0900
Subject: [PATCH 2348/5547] Fix some regressions in json output (we need to
 make all these explicit instead)

---
 osu.Game/Beatmaps/BeatmapInfo.cs    | 1 +
 osu.Game/Beatmaps/BeatmapSetInfo.cs | 2 ++
 2 files changed, 3 insertions(+)

diff --git a/osu.Game/Beatmaps/BeatmapInfo.cs b/osu.Game/Beatmaps/BeatmapInfo.cs
index 1ea1c8ab4c..96254295a6 100644
--- a/osu.Game/Beatmaps/BeatmapInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapInfo.cs
@@ -36,6 +36,7 @@ namespace osu.Game.Beatmaps
 
         public BeatmapMetadata Metadata { get; set; } = null!;
 
+        [JsonIgnore]
         [Backlink(nameof(ScoreInfo.BeatmapInfo))]
         public IQueryable<ScoreInfo> Scores { get; } = null!;
 
diff --git a/osu.Game/Beatmaps/BeatmapSetInfo.cs b/osu.Game/Beatmaps/BeatmapSetInfo.cs
index 3cda111e97..9a4207d5cf 100644
--- a/osu.Game/Beatmaps/BeatmapSetInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapSetInfo.cs
@@ -5,6 +5,7 @@ using System;
 using System.Collections.Generic;
 using System.Linq;
 using JetBrains.Annotations;
+using Newtonsoft.Json;
 using osu.Framework.Testing;
 using osu.Game.Database;
 using osu.Game.Extensions;
@@ -27,6 +28,7 @@ namespace osu.Game.Beatmaps
 
         public DateTimeOffset DateAdded { get; set; }
 
+        [JsonIgnore]
         public IBeatmapMetadataInfo Metadata => Beatmaps.FirstOrDefault()?.Metadata ?? new BeatmapMetadata();
 
         public IList<BeatmapInfo> Beatmaps { get; } = null!;

From 6c10531df2b5ddd70c1c9ecf095b5d4a8617f7ee Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 20 Jan 2022 17:14:51 +0900
Subject: [PATCH 2349/5547] Avoid constructor overhead for realm
 `BeatmapMetadata` parameterless constructor

---
 osu.Game/Beatmaps/BeatmapMetadata.cs | 13 ++++++++++++-
 1 file changed, 12 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Beatmaps/BeatmapMetadata.cs b/osu.Game/Beatmaps/BeatmapMetadata.cs
index a3385e3abe..cb38373bd3 100644
--- a/osu.Game/Beatmaps/BeatmapMetadata.cs
+++ b/osu.Game/Beatmaps/BeatmapMetadata.cs
@@ -2,6 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
+using JetBrains.Annotations;
 using Newtonsoft.Json;
 using osu.Framework.Testing;
 using osu.Game.Models;
@@ -27,7 +28,7 @@ namespace osu.Game.Beatmaps
         [JsonProperty("artist_unicode")]
         public string ArtistUnicode { get; set; } = string.Empty;
 
-        public RealmUser Author { get; set; } = new RealmUser(); // TODO: not sure we want to initialise this only to have it overwritten by retrieval.
+        public RealmUser Author { get; set; } = null!;
 
         public string Source { get; set; } = string.Empty;
 
@@ -43,6 +44,16 @@ namespace osu.Game.Beatmaps
         public string AudioFile { get; set; } = string.Empty;
         public string BackgroundFile { get; set; } = string.Empty;
 
+        public BeatmapMetadata(RealmUser? user = null)
+        {
+            Author = new RealmUser();
+        }
+
+        [UsedImplicitly] // Realm
+        private BeatmapMetadata()
+        {
+        }
+
         IUser IBeatmapMetadataInfo.Author => Author;
 
         public override string ToString() => this.GetDisplayTitle();

From 70cc03fe4304b1c982178bf34601718503dd3547 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 20 Jan 2022 17:18:53 +0900
Subject: [PATCH 2350/5547] Avoid constructor overhead for realm
 `RealmKeyBinding` parameterless constructor

---
 .../Database/TestRealmKeyBindingStore.cs      | 20 +++----------------
 osu.Game/Input/Bindings/RealmKeyBinding.cs    | 20 +++++++++++++++++--
 osu.Game/Input/RealmKeyBindingStore.cs        |  8 +-------
 3 files changed, 22 insertions(+), 26 deletions(-)

diff --git a/osu.Game.Tests/Database/TestRealmKeyBindingStore.cs b/osu.Game.Tests/Database/TestRealmKeyBindingStore.cs
index f05d9ab3dc..e3c1d42667 100644
--- a/osu.Game.Tests/Database/TestRealmKeyBindingStore.cs
+++ b/osu.Game.Tests/Database/TestRealmKeyBindingStore.cs
@@ -63,23 +63,9 @@ namespace osu.Game.Tests.Database
             using (var realm = realmContextFactory.CreateContext())
             using (var transaction = realm.BeginWrite())
             {
-                realm.Add(new RealmKeyBinding
-                {
-                    Action = GlobalAction.Back,
-                    KeyCombination = new KeyCombination(InputKey.A)
-                });
-
-                realm.Add(new RealmKeyBinding
-                {
-                    Action = GlobalAction.Back,
-                    KeyCombination = new KeyCombination(InputKey.S)
-                });
-
-                realm.Add(new RealmKeyBinding
-                {
-                    Action = GlobalAction.Back,
-                    KeyCombination = new KeyCombination(InputKey.D)
-                });
+                realm.Add(new RealmKeyBinding(GlobalAction.Back, new KeyCombination(InputKey.A)));
+                realm.Add(new RealmKeyBinding(GlobalAction.Back, new KeyCombination(InputKey.S)));
+                realm.Add(new RealmKeyBinding(GlobalAction.Back, new KeyCombination(InputKey.D)));
 
                 transaction.Commit();
             }
diff --git a/osu.Game/Input/Bindings/RealmKeyBinding.cs b/osu.Game/Input/Bindings/RealmKeyBinding.cs
index 32813ada16..c941319ddb 100644
--- a/osu.Game/Input/Bindings/RealmKeyBinding.cs
+++ b/osu.Game/Input/Bindings/RealmKeyBinding.cs
@@ -2,6 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
+using JetBrains.Annotations;
 using osu.Framework.Input.Bindings;
 using osu.Game.Database;
 using Realms;
@@ -14,7 +15,7 @@ namespace osu.Game.Input.Bindings
     public class RealmKeyBinding : RealmObject, IHasGuidPrimaryKey, IKeyBinding
     {
         [PrimaryKey]
-        public Guid ID { get; set; } = Guid.NewGuid();
+        public Guid ID { get; set; }
 
         public string? RulesetName { get; set; }
 
@@ -38,6 +39,21 @@ namespace osu.Game.Input.Bindings
         public int ActionInt { get; set; }
 
         [MapTo(nameof(KeyCombination))]
-        public string KeyCombinationString { get; set; } = string.Empty;
+        public string KeyCombinationString { get; set; } = null!;
+
+        public RealmKeyBinding(object action, KeyCombination keyCombination, string? rulesetName = null, int? variant = null)
+        {
+            Action = action;
+            KeyCombination = keyCombination;
+
+            RulesetName = rulesetName;
+            Variant = variant;
+            ID = Guid.NewGuid();
+        }
+
+        [UsedImplicitly] // Realm
+        private RealmKeyBinding()
+        {
+        }
     }
 }
diff --git a/osu.Game/Input/RealmKeyBindingStore.cs b/osu.Game/Input/RealmKeyBindingStore.cs
index cb51797685..99f5752cfb 100644
--- a/osu.Game/Input/RealmKeyBindingStore.cs
+++ b/osu.Game/Input/RealmKeyBindingStore.cs
@@ -92,13 +92,7 @@ namespace osu.Game.Input
                 if (defaultsCount > existingCount)
                 {
                     // insert any defaults which are missing.
-                    realm.Add(defaultsForAction.Skip(existingCount).Select(k => new RealmKeyBinding
-                    {
-                        KeyCombinationString = k.KeyCombination.ToString(),
-                        ActionInt = (int)k.Action,
-                        RulesetName = rulesetName,
-                        Variant = variant
-                    }));
+                    realm.Add(defaultsForAction.Skip(existingCount).Select(k => new RealmKeyBinding(k.Action, k.KeyCombination, rulesetName, variant)));
                 }
                 else if (defaultsCount < existingCount)
                 {

From 0bd7486a832e0ec701e54d8ed5b271e1190d4a1c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 20 Jan 2022 17:29:03 +0900
Subject: [PATCH 2351/5547] Avoid constructor overhead for realm `SkinInfo`
 parameterless constructor

---
 osu.Game/Skinning/SkinInfo.cs | 22 ++++++++++++++++++----
 1 file changed, 18 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Skinning/SkinInfo.cs b/osu.Game/Skinning/SkinInfo.cs
index fee8c3edb2..a89725e466 100644
--- a/osu.Game/Skinning/SkinInfo.cs
+++ b/osu.Game/Skinning/SkinInfo.cs
@@ -3,6 +3,7 @@
 
 using System;
 using System.Collections.Generic;
+using JetBrains.Annotations;
 using Newtonsoft.Json;
 using osu.Framework.Extensions.ObjectExtensions;
 using osu.Framework.Testing;
@@ -26,16 +27,16 @@ namespace osu.Game.Skinning
 
         [PrimaryKey]
         [JsonProperty]
-        public Guid ID { get; set; } = Guid.NewGuid();
+        public Guid ID { get; set; }
 
         [JsonProperty]
-        public string Name { get; set; } = string.Empty;
+        public string Name { get; set; } = null!;
 
         [JsonProperty]
-        public string Creator { get; set; } = string.Empty;
+        public string Creator { get; set; } = null!;
 
         [JsonProperty]
-        public string InstantiationInfo { get; set; } = string.Empty;
+        public string InstantiationInfo { get; set; } = null!;
 
         public string Hash { get; set; } = string.Empty;
 
@@ -55,6 +56,19 @@ namespace osu.Game.Skinning
 
         public bool DeletePending { get; set; }
 
+        public SkinInfo(string? name = null, string? creator = null, string? instantiationInfo = null)
+        {
+            Name = name ?? string.Empty;
+            Creator = creator ?? string.Empty;
+            InstantiationInfo = instantiationInfo ?? string.Empty;
+            ID = Guid.NewGuid();
+        }
+
+        [UsedImplicitly] // Realm
+        private SkinInfo()
+        {
+        }
+
         public bool Equals(SkinInfo? other)
         {
             if (ReferenceEquals(this, other)) return true;

From 4235fb317d617909ee8b3b80a4462a1cbe5fa939 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 19 Jan 2022 15:00:05 +0900
Subject: [PATCH 2352/5547] Remove unnecessary detach operation

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

diff --git a/osu.Game/Collections/CollectionManager.cs b/osu.Game/Collections/CollectionManager.cs
index d230e649f7..c4f991094c 100644
--- a/osu.Game/Collections/CollectionManager.cs
+++ b/osu.Game/Collections/CollectionManager.cs
@@ -209,7 +209,7 @@ namespace osu.Game.Collections
 
                             string checksum = sr.ReadString();
 
-                            var beatmap = beatmaps.QueryBeatmap(b => b.MD5Hash == checksum)?.Detach();
+                            var beatmap = beatmaps.QueryBeatmap(b => b.MD5Hash == checksum);
                             if (beatmap != null)
                                 collection.Beatmaps.Add(beatmap);
                         }

From 3ba712703b7a464c85ffe08927b370c8b8f6514a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 20 Jan 2022 17:50:17 +0900
Subject: [PATCH 2353/5547] Add a note about hidden beatmap check

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

diff --git a/osu.Game/Screens/Select/BeatmapCarousel.cs b/osu.Game/Screens/Select/BeatmapCarousel.cs
index 437567d4b2..d23febf429 100644
--- a/osu.Game/Screens/Select/BeatmapCarousel.cs
+++ b/osu.Game/Screens/Select/BeatmapCarousel.cs
@@ -713,6 +713,11 @@ namespace osu.Game.Screens.Select
         {
             beatmapSet = beatmapSet.Detach();
 
+            // This can be moved to the realm query if required using:
+            // .Filter("DeletePending == false && Protected == false && ALL Beatmaps.Hidden == false")
+            //
+            // As long as we are detaching though, it makes more sense to do it here as adding to the realm query has an overhead
+            // as seen at https://github.com/realm/realm-dotnet/discussions/2773#discussioncomment-2004275.
             if (beatmapSet.Beatmaps.All(b => b.Hidden))
                 return null;
 

From b1cf3befa6700c49403d5e628f14da0daa37d7df Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 20 Jan 2022 18:36:20 +0900
Subject: [PATCH 2354/5547] Fix incorrect query in comment

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

diff --git a/osu.Game/Screens/Select/BeatmapCarousel.cs b/osu.Game/Screens/Select/BeatmapCarousel.cs
index d23febf429..75ad0511e6 100644
--- a/osu.Game/Screens/Select/BeatmapCarousel.cs
+++ b/osu.Game/Screens/Select/BeatmapCarousel.cs
@@ -714,7 +714,7 @@ namespace osu.Game.Screens.Select
             beatmapSet = beatmapSet.Detach();
 
             // This can be moved to the realm query if required using:
-            // .Filter("DeletePending == false && Protected == false && ALL Beatmaps.Hidden == false")
+            // .Filter("DeletePending == false && Protected == false && ANY Beatmaps.Hidden == false")
             //
             // As long as we are detaching though, it makes more sense to do it here as adding to the realm query has an overhead
             // as seen at https://github.com/realm/realm-dotnet/discussions/2773#discussioncomment-2004275.

From 5df46d0a54785719585b47646dfc305674615e9e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 20 Jan 2022 20:23:17 +0900
Subject: [PATCH 2355/5547] Remove all calls to `Realm.Refresh` to fix blocking
 overhead from subscriptions

Turns out this is not required if realm is aware of a
`SynchronizationContext`. See
https://github.com/realm/realm-dotnet/discussions/2775#discussioncomment-2005412
for further reading.
---
 osu.Game/Database/EFToRealmMigrator.cs   |  3 ---
 osu.Game/Database/RealmContextFactory.cs | 14 +-------------
 osu.Game/OsuGameBase.cs                  |  7 -------
 3 files changed, 1 insertion(+), 23 deletions(-)

diff --git a/osu.Game/Database/EFToRealmMigrator.cs b/osu.Game/Database/EFToRealmMigrator.cs
index cff83938bf..0f726f8ee5 100644
--- a/osu.Game/Database/EFToRealmMigrator.cs
+++ b/osu.Game/Database/EFToRealmMigrator.cs
@@ -46,9 +46,6 @@ namespace osu.Game.Database
                 migrateScores(ef);
             }
 
-            Logger.Log("Refreshing realm...", LoggingTarget.Database);
-            realmContextFactory.Refresh();
-
             // Delete the database permanently.
             // Will cause future startups to not attempt migration.
             Logger.Log("Migration successful, deleting EF database", LoggingTarget.Database);
diff --git a/osu.Game/Database/RealmContextFactory.cs b/osu.Game/Database/RealmContextFactory.cs
index 99b357710e..31dbb0c6c4 100644
--- a/osu.Game/Database/RealmContextFactory.cs
+++ b/osu.Game/Database/RealmContextFactory.cs
@@ -61,10 +61,10 @@ namespace osu.Game.Database
 
         private readonly ThreadLocal<bool> currentThreadCanCreateContexts = new ThreadLocal<bool>();
 
-        private static readonly GlobalStatistic<int> refreshes = GlobalStatistics.Get<int>(@"Realm", @"Dirty Refreshes");
         private static readonly GlobalStatistic<int> contexts_created = GlobalStatistics.Get<int>(@"Realm", @"Contexts (Created)");
 
         private readonly object contextLock = new object();
+
         private Realm? context;
 
         public Realm Context
@@ -169,18 +169,6 @@ namespace osu.Game.Database
         /// <returns></returns>
         public bool Compact() => Realm.Compact(getConfiguration());
 
-        /// <summary>
-        /// Perform a blocking refresh on the main realm context.
-        /// </summary>
-        public void Refresh()
-        {
-            lock (contextLock)
-            {
-                if (context?.Refresh() == true)
-                    refreshes.Value++;
-            }
-        }
-
         public Realm CreateContext()
         {
             if (isDisposed)
diff --git a/osu.Game/OsuGameBase.cs b/osu.Game/OsuGameBase.cs
index fb09dac1b1..5af992f800 100644
--- a/osu.Game/OsuGameBase.cs
+++ b/osu.Game/OsuGameBase.cs
@@ -351,13 +351,6 @@ namespace osu.Game
             FrameStatistics.ValueChanged += e => fpsDisplayVisible.Value = e.NewValue != FrameStatisticsMode.None;
         }
 
-        protected override void Update()
-        {
-            base.Update();
-
-            realmFactory.Refresh();
-        }
-
         protected override IReadOnlyDependencyContainer CreateChildDependencies(IReadOnlyDependencyContainer parent) =>
             dependencies = new DependencyContainer(base.CreateChildDependencies(parent));
 

From a8ce2c5edf15f5af96cb8e14183e89757c650ae9 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 20 Jan 2022 21:14:10 +0900
Subject: [PATCH 2356/5547] Detach before sending `BeatmapSetInfo` to any
 handling method

---
 osu.Game/Screens/Select/BeatmapCarousel.cs | 12 +++++-------
 1 file changed, 5 insertions(+), 7 deletions(-)

diff --git a/osu.Game/Screens/Select/BeatmapCarousel.cs b/osu.Game/Screens/Select/BeatmapCarousel.cs
index 75ad0511e6..0ee59f7f04 100644
--- a/osu.Game/Screens/Select/BeatmapCarousel.cs
+++ b/osu.Game/Screens/Select/BeatmapCarousel.cs
@@ -114,7 +114,7 @@ namespace osu.Game.Screens.Select
         {
             CarouselRoot newRoot = new CarouselRoot(this);
 
-            newRoot.AddChildren(beatmapSets.Select(createCarouselSet).Where(g => g != null));
+            newRoot.AddChildren(beatmapSets.Select(s => createCarouselSet(s.Detach())).Where(g => g != null));
 
             root = newRoot;
             if (selectedBeatmapSet != null && !beatmapSets.Contains(selectedBeatmapSet.BeatmapSet))
@@ -209,7 +209,7 @@ namespace osu.Game.Screens.Select
                 return;
 
             foreach (int i in changes.InsertedIndices)
-                RemoveBeatmapSet(sender[i]);
+                RemoveBeatmapSet(sender[i].Detach());
         }
 
         private void beatmapSetsChanged(IRealmCollection<BeatmapSetInfo> sender, ChangeSet changes, Exception error)
@@ -248,10 +248,10 @@ namespace osu.Game.Screens.Select
             }
 
             foreach (int i in changes.NewModifiedIndices)
-                UpdateBeatmapSet(sender[i]);
+                UpdateBeatmapSet(sender[i].Detach());
 
             foreach (int i in changes.InsertedIndices)
-                UpdateBeatmapSet(sender[i]);
+                UpdateBeatmapSet(sender[i].Detach());
         }
 
         private void beatmapsChanged(IRealmCollection<BeatmapInfo> sender, ChangeSet changes, Exception error)
@@ -261,7 +261,7 @@ namespace osu.Game.Screens.Select
                 return;
 
             foreach (int i in changes.InsertedIndices)
-                UpdateBeatmapSet(sender[i].BeatmapSet);
+                UpdateBeatmapSet(sender[i].BeatmapSet?.Detach());
         }
 
         private IRealmCollection<BeatmapSetInfo> getBeatmapSets(Realm realm) => realm.All<BeatmapSetInfo>().Where(s => !s.DeletePending && !s.Protected).AsRealmCollection();
@@ -711,8 +711,6 @@ namespace osu.Game.Screens.Select
 
         private CarouselBeatmapSet createCarouselSet(BeatmapSetInfo beatmapSet)
         {
-            beatmapSet = beatmapSet.Detach();
-
             // This can be moved to the realm query if required using:
             // .Filter("DeletePending == false && Protected == false && ANY Beatmaps.Hidden == false")
             //

From 9a864267d2054cb48fe06db37ccbdd9e4b8f26fa Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 20 Jan 2022 21:57:16 +0900
Subject: [PATCH 2357/5547] Fix `CarouselGroupEagerSelect` not invoking
 subclassed `AddChild` from `AddChildren` calls

---
 .../Select/Carousel/CarouselGroupEagerSelect.cs       | 11 +++++++++--
 1 file changed, 9 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/Select/Carousel/CarouselGroupEagerSelect.cs b/osu.Game/Screens/Select/Carousel/CarouselGroupEagerSelect.cs
index 9e8aad4b6f..aac0e4ed82 100644
--- a/osu.Game/Screens/Select/Carousel/CarouselGroupEagerSelect.cs
+++ b/osu.Game/Screens/Select/Carousel/CarouselGroupEagerSelect.cs
@@ -55,10 +55,16 @@ namespace osu.Game.Screens.Select.Carousel
                 updateSelectedIndex();
         }
 
+        private bool addingChildren;
+
         public void AddChildren(IEnumerable<CarouselItem> items)
         {
+            addingChildren = true;
+
             foreach (var i in items)
-                base.AddChild(i);
+                AddChild(i);
+
+            addingChildren = false;
 
             attemptSelection();
         }
@@ -66,7 +72,8 @@ namespace osu.Game.Screens.Select.Carousel
         public override void AddChild(CarouselItem i)
         {
             base.AddChild(i);
-            attemptSelection();
+            if (!addingChildren)
+                attemptSelection();
         }
 
         protected override void ChildItemStateChanged(CarouselItem item, CarouselItemState value)

From 0b93f3c88f2f1d2a6ae7b3e2300d5b77f8606cfb Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 20 Jan 2022 21:58:16 +0900
Subject: [PATCH 2358/5547] Add `<Guid,CarouselBeatmapSet>` dictionary to speed
 up update operations in carousel

---
 osu.Game/Screens/Select/BeatmapCarousel.cs | 99 ++++++++++++++--------
 1 file changed, 64 insertions(+), 35 deletions(-)

diff --git a/osu.Game/Screens/Select/BeatmapCarousel.cs b/osu.Game/Screens/Select/BeatmapCarousel.cs
index 0ee59f7f04..458a987130 100644
--- a/osu.Game/Screens/Select/BeatmapCarousel.cs
+++ b/osu.Game/Screens/Select/BeatmapCarousel.cs
@@ -95,7 +95,7 @@ namespace osu.Game.Screens.Select
 
         protected readonly CarouselScrollContainer Scroll;
 
-        private IEnumerable<CarouselBeatmapSet> beatmapSets => root.Children.OfType<CarouselBeatmapSet>();
+        private IEnumerable<CarouselBeatmapSet> beatmapSets => root.BeatmapSetsByID.Values;
 
         // todo: only used for testing, maybe remove.
         private bool loadedTestBeatmaps;
@@ -117,6 +117,7 @@ namespace osu.Game.Screens.Select
             newRoot.AddChildren(beatmapSets.Select(s => createCarouselSet(s.Detach())).Where(g => g != null));
 
             root = newRoot;
+
             if (selectedBeatmapSet != null && !beatmapSets.Contains(selectedBeatmapSet.BeatmapSet))
                 selectedBeatmapSet = null;
 
@@ -209,7 +210,7 @@ namespace osu.Game.Screens.Select
                 return;
 
             foreach (int i in changes.InsertedIndices)
-                RemoveBeatmapSet(sender[i].Detach());
+                removeBeatmapSet(sender[i].ID);
         }
 
         private void beatmapSetsChanged(IRealmCollection<BeatmapSetInfo> sender, ChangeSet changes, Exception error)
@@ -223,24 +224,20 @@ namespace osu.Game.Screens.Select
                 // During initial population, we must manually account for the fact that our original query was done on an async thread.
                 // Since then, there may have been imports or deletions.
                 // Here we manually catch up on any changes.
-                var populatedSets = new HashSet<Guid>();
-                foreach (var s in beatmapSets)
-                    populatedSets.Add(s.BeatmapSet.ID);
-
                 var realmSets = new HashSet<Guid>();
                 foreach (var s in sender)
                     realmSets.Add(s.ID);
 
-                foreach (var s in realmSets)
+                foreach (var id in realmSets)
                 {
-                    if (!populatedSets.Contains(s))
-                        UpdateBeatmapSet(realmFactory.Context.Find<BeatmapSetInfo>(s));
+                    if (!root.BeatmapSetsByID.ContainsKey(id))
+                        UpdateBeatmapSet(realmFactory.Context.Find<BeatmapSetInfo>(id).Detach());
                 }
 
-                foreach (var s in populatedSets)
+                foreach (var id in root.BeatmapSetsByID.Keys)
                 {
-                    if (!realmSets.Contains(s))
-                        RemoveBeatmapSet(realmFactory.Context.Find<BeatmapSetInfo>(s));
+                    if (!realmSets.Contains(id))
+                        removeBeatmapSet(id);
                 }
 
                 signalBeatmapsLoaded();
@@ -261,16 +258,30 @@ namespace osu.Game.Screens.Select
                 return;
 
             foreach (int i in changes.InsertedIndices)
-                UpdateBeatmapSet(sender[i].BeatmapSet?.Detach());
+            {
+                var beatmapInfo = sender[i];
+                var beatmapSet = beatmapInfo.BeatmapSet;
+
+                Debug.Assert(beatmapSet != null);
+
+                // Only require to action here if the beatmap is missing.
+                // This avoids processing these events unnecessarily when new beatmaps are imported, for example.
+                if (root.BeatmapSetsByID.TryGetValue(beatmapSet.ID, out var existingSet)
+                    && existingSet.BeatmapSet.Beatmaps.All(b => b.ID != beatmapInfo.ID))
+                {
+                    UpdateBeatmapSet(beatmapSet.Detach());
+                }
+            }
         }
 
         private IRealmCollection<BeatmapSetInfo> getBeatmapSets(Realm realm) => realm.All<BeatmapSetInfo>().Where(s => !s.DeletePending && !s.Protected).AsRealmCollection();
 
-        public void RemoveBeatmapSet(BeatmapSetInfo beatmapSet) => Schedule(() =>
-        {
-            var existingSet = beatmapSets.FirstOrDefault(b => b.BeatmapSet.Equals(beatmapSet));
+        public void RemoveBeatmapSet(BeatmapSetInfo beatmapSet) =>
+            removeBeatmapSet(beatmapSet.ID);
 
-            if (existingSet == null)
+        private void removeBeatmapSet(Guid beatmapSetID) => Schedule(() =>
+        {
+            if (!root.BeatmapSetsByID.TryGetValue(beatmapSetID, out var existingSet))
                 return;
 
             root.RemoveChild(existingSet);
@@ -281,33 +292,27 @@ namespace osu.Game.Screens.Select
         {
             Guid? previouslySelectedID = null;
 
-            CarouselBeatmapSet existingSet = beatmapSets.FirstOrDefault(b => b.BeatmapSet.Equals(beatmapSet));
-
             // If the selected beatmap is about to be removed, store its ID so it can be re-selected if required
-            if (existingSet?.State?.Value == CarouselItemState.Selected)
+            if (selectedBeatmapSet?.BeatmapSet.ID == beatmapSet.ID)
                 previouslySelectedID = selectedBeatmap?.BeatmapInfo.ID;
 
             var newSet = createCarouselSet(beatmapSet);
 
-            if (existingSet != null)
-                root.RemoveChild(existingSet);
+            root.RemoveChild(beatmapSet.ID);
 
-            if (newSet == null)
+            if (newSet != null)
             {
-                itemsCache.Invalidate();
-                return;
+                root.AddChild(newSet);
+
+                // only reset scroll position if already near the scroll target.
+                // without this, during a large beatmap import it is impossible to navigate the carousel.
+                applyActiveCriteria(false, alwaysResetScrollPosition: false);
+
+                // check if we can/need to maintain our current selection.
+                if (previouslySelectedID != null)
+                    select((CarouselItem)newSet.Beatmaps.FirstOrDefault(b => b.BeatmapInfo.ID == previouslySelectedID) ?? newSet);
             }
 
-            root.AddChild(newSet);
-
-            // only reset scroll position if already near the scroll target.
-            // without this, during a large beatmap import it is impossible to navigate the carousel.
-            applyActiveCriteria(false, alwaysResetScrollPosition: false);
-
-            // check if we can/need to maintain our current selection.
-            if (previouslySelectedID != null)
-                select((CarouselItem)newSet.Beatmaps.FirstOrDefault(b => b.BeatmapInfo.ID == previouslySelectedID) ?? newSet);
-
             itemsCache.Invalidate();
             Schedule(() => BeatmapSetsChanged?.Invoke());
         });
@@ -911,6 +916,8 @@ namespace osu.Game.Screens.Select
         {
             private readonly BeatmapCarousel carousel;
 
+            public readonly Dictionary<Guid, CarouselBeatmapSet> BeatmapSetsByID = new Dictionary<Guid, CarouselBeatmapSet>();
+
             public CarouselRoot(BeatmapCarousel carousel)
             {
                 // root should always remain selected. if not, PerformSelection will not be called.
@@ -920,6 +927,28 @@ namespace osu.Game.Screens.Select
                 this.carousel = carousel;
             }
 
+            public override void AddChild(CarouselItem i)
+            {
+                CarouselBeatmapSet set = (CarouselBeatmapSet)i;
+                BeatmapSetsByID[set.BeatmapSet.ID] = set;
+
+                base.AddChild(i);
+            }
+
+            public void RemoveChild(Guid beatmapSetID)
+            {
+                if (BeatmapSetsByID.TryGetValue(beatmapSetID, out var carouselBeatmapSet))
+                    RemoveChild(carouselBeatmapSet);
+            }
+
+            public override void RemoveChild(CarouselItem i)
+            {
+                CarouselBeatmapSet set = (CarouselBeatmapSet)i;
+                BeatmapSetsByID.Remove(set.BeatmapSet.ID);
+
+                base.RemoveChild(i);
+            }
+
             protected override void PerformSelection()
             {
                 if (LastSelected == null || LastSelected.Filtered.Value)

From 80f3a67876adcad87ba910e41e7bc82fd46cf820 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 20 Jan 2022 22:21:00 +0900
Subject: [PATCH 2359/5547] Use `for` instead of `foreach` to avoid enumerator
 overhead

---
 osu.Game/Screens/Select/BeatmapCarousel.cs | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/Select/BeatmapCarousel.cs b/osu.Game/Screens/Select/BeatmapCarousel.cs
index 458a987130..a5704b3b2e 100644
--- a/osu.Game/Screens/Select/BeatmapCarousel.cs
+++ b/osu.Game/Screens/Select/BeatmapCarousel.cs
@@ -225,8 +225,9 @@ namespace osu.Game.Screens.Select
                 // Since then, there may have been imports or deletions.
                 // Here we manually catch up on any changes.
                 var realmSets = new HashSet<Guid>();
-                foreach (var s in sender)
-                    realmSets.Add(s.ID);
+
+                for (int i = 0; i < sender.Count; i++)
+                    realmSets.Add(sender[i].ID);
 
                 foreach (var id in realmSets)
                 {

From ba31ddee017a950be2c8b50c4c9750ebeb575af6 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 21 Jan 2022 00:33:46 +0900
Subject: [PATCH 2360/5547] Revert `beatmapSets` reference to fix tests

New version changed order.
---
 osu.Game/Screens/Select/BeatmapCarousel.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Select/BeatmapCarousel.cs b/osu.Game/Screens/Select/BeatmapCarousel.cs
index a5704b3b2e..961dac9856 100644
--- a/osu.Game/Screens/Select/BeatmapCarousel.cs
+++ b/osu.Game/Screens/Select/BeatmapCarousel.cs
@@ -95,7 +95,7 @@ namespace osu.Game.Screens.Select
 
         protected readonly CarouselScrollContainer Scroll;
 
-        private IEnumerable<CarouselBeatmapSet> beatmapSets => root.BeatmapSetsByID.Values;
+        private IEnumerable<CarouselBeatmapSet> beatmapSets => root.Children.OfType<CarouselBeatmapSet>();
 
         // todo: only used for testing, maybe remove.
         private bool loadedTestBeatmaps;

From 079b2dfc42ac22168dbc4f436653a648b51f9ad8 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 21 Jan 2022 00:01:34 +0900
Subject: [PATCH 2361/5547] Create backup of databases before opening contexts

Attempt to avoid file IO issues.

Closes #16531.
---
 osu.Game/Database/EFToRealmMigrator.cs | 30 ++++++++------------------
 1 file changed, 9 insertions(+), 21 deletions(-)

diff --git a/osu.Game/Database/EFToRealmMigrator.cs b/osu.Game/Database/EFToRealmMigrator.cs
index 0f726f8ee5..727815cc4d 100644
--- a/osu.Game/Database/EFToRealmMigrator.cs
+++ b/osu.Game/Database/EFToRealmMigrator.cs
@@ -26,8 +26,6 @@ namespace osu.Game.Database
         private readonly OsuConfigManager config;
         private readonly Storage storage;
 
-        private bool hasTakenBackup;
-
         public EFToRealmMigrator(DatabaseContextFactory efContextFactory, RealmContextFactory realmContextFactory, OsuConfigManager config, Storage storage)
         {
             this.efContextFactory = efContextFactory;
@@ -38,6 +36,8 @@ namespace osu.Game.Database
 
         public void Run()
         {
+            createBackup();
+
             using (var ef = efContextFactory.Get())
             {
                 migrateSettings(ef);
@@ -77,8 +77,6 @@ namespace osu.Game.Database
             {
                 Logger.Log($"Found {count} beatmaps in EF", LoggingTarget.Database);
 
-                ensureBackup();
-
                 // only migrate data if the realm database is empty.
                 // note that this cannot be written as: `realm.All<BeatmapSetInfo>().All(s => s.Protected)`, because realm does not support `.All()`.
                 if (realm.All<BeatmapSetInfo>().Any(s => !s.Protected))
@@ -210,8 +208,6 @@ namespace osu.Game.Database
             {
                 Logger.Log($"Found {count} scores in EF", LoggingTarget.Database);
 
-                ensureBackup();
-
                 // only migrate data if the realm database is empty.
                 if (realm.All<ScoreInfo>().Any())
                 {
@@ -291,8 +287,6 @@ namespace osu.Game.Database
             if (!existingSkins.Any())
                 return;
 
-            ensureBackup();
-
             var userSkinChoice = config.GetBindable<string>(OsuSetting.Skin);
             int.TryParse(userSkinChoice.Value, out int userSkinInt);
 
@@ -363,7 +357,6 @@ namespace osu.Game.Database
                 return;
 
             Logger.Log("Beginning settings migration to realm", LoggingTarget.Database);
-            ensureBackup();
 
             using (var realm = realmContextFactory.CreateContext())
             using (var transaction = realm.BeginWrite())
@@ -400,21 +393,16 @@ namespace osu.Game.Database
         private string? getRulesetShortNameFromLegacyID(long rulesetId) =>
             efContextFactory.Get().RulesetInfo.FirstOrDefault(r => r.ID == rulesetId)?.ShortName;
 
-        private void ensureBackup()
+        private void createBackup()
         {
-            if (!hasTakenBackup)
-            {
-                string migration = $"before_final_migration_{DateTimeOffset.UtcNow.ToUnixTimeSeconds()}";
+            string migration = $"before_final_migration_{DateTimeOffset.UtcNow.ToUnixTimeSeconds()}";
 
-                efContextFactory.CreateBackup($"client.{migration}.db");
-                realmContextFactory.CreateBackup($"client.{migration}.realm");
+            efContextFactory.CreateBackup($"client.{migration}.db");
+            realmContextFactory.CreateBackup($"client.{migration}.realm");
 
-                using (var source = storage.GetStream("collection.db"))
-                using (var destination = storage.GetStream($"collection.{migration}.db", FileAccess.Write, FileMode.CreateNew))
-                    source.CopyTo(destination);
-
-                hasTakenBackup = true;
-            }
+            using (var source = storage.GetStream("collection.db"))
+            using (var destination = storage.GetStream($"collection.{migration}.db", FileAccess.Write, FileMode.CreateNew))
+                source.CopyTo(destination);
         }
     }
 }

From 7aad2780b1fae24d9fd6213f0e44c519fc87cc89 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 21 Jan 2022 00:46:47 +0900
Subject: [PATCH 2362/5547] Add retry logic for realm backup creation

---
 osu.Game/Database/RealmContextFactory.cs | 21 ++++++++++++++++++---
 1 file changed, 18 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Database/RealmContextFactory.cs b/osu.Game/Database/RealmContextFactory.cs
index 31dbb0c6c4..ffadf8258d 100644
--- a/osu.Game/Database/RealmContextFactory.cs
+++ b/osu.Game/Database/RealmContextFactory.cs
@@ -367,9 +367,24 @@ namespace osu.Game.Database
             using (BlockAllOperations())
             {
                 Logger.Log($"Creating full realm database backup at {backupFilename}", LoggingTarget.Database);
-                using (var source = storage.GetStream(Filename))
-                using (var destination = storage.GetStream(backupFilename, FileAccess.Write, FileMode.CreateNew))
-                    source.CopyTo(destination);
+
+                int attempts = 10;
+
+                while (attempts-- > 0)
+                {
+                    try
+                    {
+                        using (var source = storage.GetStream(Filename))
+                        using (var destination = storage.GetStream(backupFilename, FileAccess.Write, FileMode.CreateNew))
+                            source.CopyTo(destination);
+                        return;
+                    }
+                    catch (IOException)
+                    {
+                        // file may be locked during use.
+                        Thread.Sleep(500);
+                    }
+                }
             }
         }
 

From 0c9eb3ad61a412f6ebed4d0dc08f593743cee8d1 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 21 Jan 2022 01:33:45 +0900
Subject: [PATCH 2363/5547] Add realm factory helper methods to run work on the
 correct context

Avoids constructing a new `Realm` instance when called from the update
thread without worrying about disposal.
---
 osu.Game/Database/RealmContextFactory.cs | 35 ++++++++++++++++++++++++
 1 file changed, 35 insertions(+)

diff --git a/osu.Game/Database/RealmContextFactory.cs b/osu.Game/Database/RealmContextFactory.cs
index 31dbb0c6c4..50e456a0c8 100644
--- a/osu.Game/Database/RealmContextFactory.cs
+++ b/osu.Game/Database/RealmContextFactory.cs
@@ -169,6 +169,41 @@ namespace osu.Game.Database
         /// <returns></returns>
         public bool Compact() => Realm.Compact(getConfiguration());
 
+        /// <summary>
+        /// Run work on realm with a return value.
+        /// </summary>
+        /// <remarks>
+        /// Handles correct context management automatically.
+        /// </remarks>
+        /// <param name="action">The work to run.</param>
+        /// <typeparam name="T">The return type.</typeparam>
+        public T Run<T>(Func<Realm, T> action)
+        {
+            if (ThreadSafety.IsUpdateThread)
+                return action(Context);
+
+            using (var realm = CreateContext())
+                return action(realm);
+        }
+
+        /// <summary>
+        /// Run work on realm.
+        /// </summary>
+        /// <remarks>
+        /// Handles correct context management automatically.
+        /// </remarks>
+        /// <param name="action">The work to run.</param>
+        public void Run(Action<Realm> action)
+        {
+            if (ThreadSafety.IsUpdateThread)
+                action(Context);
+            else
+            {
+                using (var realm = CreateContext())
+                    action(realm);
+            }
+        }
+
         public Realm CreateContext()
         {
             if (isDisposed)

From a5d2047f055bbbda917d8acec11f09a363b202ce Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 21 Jan 2022 01:34:20 +0900
Subject: [PATCH 2364/5547] Fix various cases of creating realm contexts from
 update thread when not necessary

---
 osu.Game/Beatmaps/BeatmapManager.cs           | 39 ++++++++++---------
 osu.Game/Beatmaps/BeatmapModelManager.cs      |  7 ++--
 .../Settings/Sections/Input/KeyBindingRow.cs  |  4 +-
 osu.Game/Scoring/ScoreModelManager.cs         |  3 +-
 osu.Game/Skinning/SkinManager.cs              |  9 ++---
 osu.Game/Stores/BeatmapImporter.cs            |  3 +-
 osu.Game/Stores/RealmArchiveModelManager.cs   |  8 ++--
 7 files changed, 36 insertions(+), 37 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index ee649ad960..cc765657cc 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -119,15 +119,17 @@ namespace osu.Game.Beatmaps
         /// <param name="beatmapInfo">The beatmap difficulty to hide.</param>
         public void Hide(BeatmapInfo beatmapInfo)
         {
-            using (var realm = contextFactory.CreateContext())
-            using (var transaction = realm.BeginWrite())
+            contextFactory.Run(realm =>
             {
-                if (!beatmapInfo.IsManaged)
-                    beatmapInfo = realm.Find<BeatmapInfo>(beatmapInfo.ID);
+                using (var transaction = realm.BeginWrite())
+                {
+                    if (!beatmapInfo.IsManaged)
+                        beatmapInfo = realm.Find<BeatmapInfo>(beatmapInfo.ID);
 
-                beatmapInfo.Hidden = true;
-                transaction.Commit();
-            }
+                    beatmapInfo.Hidden = true;
+                    transaction.Commit();
+                }
+            });
         }
 
         /// <summary>
@@ -136,15 +138,17 @@ namespace osu.Game.Beatmaps
         /// <param name="beatmapInfo">The beatmap difficulty to restore.</param>
         public void Restore(BeatmapInfo beatmapInfo)
         {
-            using (var realm = contextFactory.CreateContext())
-            using (var transaction = realm.BeginWrite())
+            contextFactory.Run(realm =>
             {
-                if (!beatmapInfo.IsManaged)
-                    beatmapInfo = realm.Find<BeatmapInfo>(beatmapInfo.ID);
+                using (var transaction = realm.BeginWrite())
+                {
+                    if (!beatmapInfo.IsManaged)
+                        beatmapInfo = realm.Find<BeatmapInfo>(beatmapInfo.ID);
 
-                beatmapInfo.Hidden = false;
-                transaction.Commit();
-            }
+                    beatmapInfo.Hidden = false;
+                    transaction.Commit();
+                }
+            });
         }
 
         public void RestoreAll()
@@ -176,8 +180,7 @@ namespace osu.Game.Beatmaps
         /// <returns>The first result for the provided query, or null if no results were found.</returns>
         public ILive<BeatmapSetInfo>? QueryBeatmapSet(Expression<Func<BeatmapSetInfo, bool>> query)
         {
-            using (var context = contextFactory.CreateContext())
-                return context.All<BeatmapSetInfo>().FirstOrDefault(query)?.ToLive(contextFactory);
+            return contextFactory.Run(realm => realm.All<BeatmapSetInfo>().FirstOrDefault(query)?.ToLive(contextFactory));
         }
 
         #region Delegation to BeatmapModelManager (methods which previously existed locally).
@@ -305,13 +308,13 @@ namespace osu.Game.Beatmaps
             // If we seem to be missing files, now is a good time to re-fetch.
             if (importedBeatmap?.BeatmapSet?.Files.Count == 0)
             {
-                using (var realm = contextFactory.CreateContext())
+                contextFactory.Run(realm =>
                 {
                     var refetch = realm.Find<BeatmapInfo>(importedBeatmap.ID)?.Detach();
 
                     if (refetch != null)
                         importedBeatmap = refetch;
-                }
+                });
             }
 
             return workingBeatmapCache.GetWorkingBeatmap(importedBeatmap);
diff --git a/osu.Game/Beatmaps/BeatmapModelManager.cs b/osu.Game/Beatmaps/BeatmapModelManager.cs
index 3822c6e121..a4ba13a88d 100644
--- a/osu.Game/Beatmaps/BeatmapModelManager.cs
+++ b/osu.Game/Beatmaps/BeatmapModelManager.cs
@@ -98,17 +98,16 @@ namespace osu.Game.Beatmaps
         /// <returns>The first result for the provided query, or null if no results were found.</returns>
         public BeatmapInfo? QueryBeatmap(Expression<Func<BeatmapInfo, bool>> query)
         {
-            using (var context = ContextFactory.CreateContext())
-                return context.All<BeatmapInfo>().FirstOrDefault(query)?.Detach();
+            return ContextFactory.Run(realm => realm.All<BeatmapInfo>().FirstOrDefault(query)?.Detach());
         }
 
         public void Update(BeatmapSetInfo item)
         {
-            using (var realm = ContextFactory.CreateContext())
+            ContextFactory.Run(realm =>
             {
                 var existing = realm.Find<BeatmapSetInfo>(item.ID);
                 realm.Write(r => item.CopyChangesToRealm(existing));
-            }
+            });
         }
     }
 }
diff --git a/osu.Game/Overlays/Settings/Sections/Input/KeyBindingRow.cs b/osu.Game/Overlays/Settings/Sections/Input/KeyBindingRow.cs
index e0a1a82326..60aff91301 100644
--- a/osu.Game/Overlays/Settings/Sections/Input/KeyBindingRow.cs
+++ b/osu.Game/Overlays/Settings/Sections/Input/KeyBindingRow.cs
@@ -386,11 +386,11 @@ namespace osu.Game.Overlays.Settings.Sections.Input
 
         private void updateStoreFromButton(KeyButton button)
         {
-            using (var realm = realmFactory.CreateContext())
+            realmFactory.Run(realm =>
             {
                 var binding = realm.Find<RealmKeyBinding>(((IHasGuidPrimaryKey)button.KeyBinding).ID);
                 realm.Write(() => binding.KeyCombinationString = button.KeyBinding.KeyCombinationString);
-            }
+            });
         }
 
         private void updateIsDefaultValue()
diff --git a/osu.Game/Scoring/ScoreModelManager.cs b/osu.Game/Scoring/ScoreModelManager.cs
index 5ba152fad3..5e560effa1 100644
--- a/osu.Game/Scoring/ScoreModelManager.cs
+++ b/osu.Game/Scoring/ScoreModelManager.cs
@@ -74,8 +74,7 @@ namespace osu.Game.Scoring
 
         public override bool IsAvailableLocally(ScoreInfo model)
         {
-            using (var context = ContextFactory.CreateContext())
-                return context.All<ScoreInfo>().Any(b => b.OnlineID == model.OnlineID);
+            return ContextFactory.Run(realm => realm.All<ScoreInfo>().Any(s => s.OnlineID == model.OnlineID));
         }
     }
 }
diff --git a/osu.Game/Skinning/SkinManager.cs b/osu.Game/Skinning/SkinManager.cs
index cde21b78c1..3f6e5754fb 100644
--- a/osu.Game/Skinning/SkinManager.cs
+++ b/osu.Game/Skinning/SkinManager.cs
@@ -113,10 +113,10 @@ namespace osu.Game.Skinning
 
         public void SelectRandomSkin()
         {
-            using (var context = contextFactory.CreateContext())
+            contextFactory.Run(realm =>
             {
                 // choose from only user skins, removing the current selection to ensure a new one is chosen.
-                var randomChoices = context.All<SkinInfo>().Where(s => !s.DeletePending && s.ID != CurrentSkinInfo.Value.ID).ToArray();
+                var randomChoices = realm.All<SkinInfo>().Where(s => !s.DeletePending && s.ID != CurrentSkinInfo.Value.ID).ToArray();
 
                 if (randomChoices.Length == 0)
                 {
@@ -127,7 +127,7 @@ namespace osu.Game.Skinning
                 var chosen = randomChoices.ElementAt(RNG.Next(0, randomChoices.Length));
 
                 CurrentSkinInfo.Value = chosen.ToLive(contextFactory);
-            }
+            });
         }
 
         /// <summary>
@@ -182,8 +182,7 @@ namespace osu.Game.Skinning
         /// <returns>The first result for the provided query, or null if no results were found.</returns>
         public ILive<SkinInfo> Query(Expression<Func<SkinInfo, bool>> query)
         {
-            using (var context = contextFactory.CreateContext())
-                return context.All<SkinInfo>().FirstOrDefault(query)?.ToLive(contextFactory);
+            return contextFactory.Run(realm => realm.All<SkinInfo>().FirstOrDefault(query)?.ToLive(contextFactory));
         }
 
         public event Action SourceChanged;
diff --git a/osu.Game/Stores/BeatmapImporter.cs b/osu.Game/Stores/BeatmapImporter.cs
index d285a6b61c..61178014ef 100644
--- a/osu.Game/Stores/BeatmapImporter.cs
+++ b/osu.Game/Stores/BeatmapImporter.cs
@@ -165,8 +165,7 @@ namespace osu.Game.Stores
 
         public override bool IsAvailableLocally(BeatmapSetInfo model)
         {
-            using (var context = ContextFactory.CreateContext())
-                return context.All<BeatmapInfo>().Any(b => b.OnlineID == model.OnlineID);
+            return ContextFactory.Run(realm => realm.All<BeatmapInfo>().Any(b => b.OnlineID == model.OnlineID));
         }
 
         public override string HumanisedModelName => "beatmap";
diff --git a/osu.Game/Stores/RealmArchiveModelManager.cs b/osu.Game/Stores/RealmArchiveModelManager.cs
index b456dae343..115fbf721d 100644
--- a/osu.Game/Stores/RealmArchiveModelManager.cs
+++ b/osu.Game/Stores/RealmArchiveModelManager.cs
@@ -165,7 +165,7 @@ namespace osu.Game.Stores
 
         public bool Delete(TModel item)
         {
-            using (var realm = ContextFactory.CreateContext())
+            return ContextFactory.Run(realm =>
             {
                 if (!item.IsManaged)
                     item = realm.Find<TModel>(item.ID);
@@ -175,12 +175,12 @@ namespace osu.Game.Stores
 
                 realm.Write(r => item.DeletePending = true);
                 return true;
-            }
+            });
         }
 
         public void Undelete(TModel item)
         {
-            using (var realm = ContextFactory.CreateContext())
+            ContextFactory.Run(realm =>
             {
                 if (!item.IsManaged)
                     item = realm.Find<TModel>(item.ID);
@@ -189,7 +189,7 @@ namespace osu.Game.Stores
                     return;
 
                 realm.Write(r => item.DeletePending = false);
-            }
+            });
         }
 
         public abstract bool IsAvailableLocally(TModel model);

From e0fe8af365535a20c077cc397a69b2bf801c9dba Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Fri, 21 Jan 2022 08:54:08 +0800
Subject: [PATCH 2365/5547] Schedule setPerformanceValue

---
 .../Screens/Ranking/Expanded/Statistics/PerformanceStatistic.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatistic.cs b/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatistic.cs
index bda147cf22..158fd82b29 100644
--- a/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatistic.cs
+++ b/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatistic.cs
@@ -46,7 +46,7 @@ namespace osu.Game.Screens.Ranking.Expanded.Statistics
         {
             new PerformanceBreakdownCalculator(beatmapManager, difficultyCache, performanceCache)
                 .CalculateAsync(score, cancellationTokenSource.Token)
-                .ContinueWith(t => setPerformanceValue(t.GetResultSafely()));
+                .ContinueWith(t => Schedule(() => setPerformanceValue(t.GetResultSafely())));
         }
 
         private void setPerformanceValue(PerformanceBreakdown breakdown)

From 45bf35c42532d4051166df6a8df955d41a8b7e49 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 21 Jan 2022 12:26:24 +0900
Subject: [PATCH 2366/5547] Avoid performing keyword filtering at song select
 unless keywords are specified

---
 osu.Game/Screens/Select/Carousel/CarouselBeatmap.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Select/Carousel/CarouselBeatmap.cs b/osu.Game/Screens/Select/Carousel/CarouselBeatmap.cs
index d54a3bb54e..6b198ab505 100644
--- a/osu.Game/Screens/Select/Carousel/CarouselBeatmap.cs
+++ b/osu.Game/Screens/Select/Carousel/CarouselBeatmap.cs
@@ -55,7 +55,7 @@ namespace osu.Game.Screens.Select.Carousel
 
             match &= !criteria.UserStarDifficulty.HasFilter || criteria.UserStarDifficulty.IsInRange(BeatmapInfo.StarRating);
 
-            if (match)
+            if (match && criteria.SearchTerms.Length > 0)
             {
                 string[] terms = BeatmapInfo.GetSearchableTerms();
 

From 5b24800b0e9c88af8747f9e33a3c14b97ca1f4d8 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 21 Jan 2022 12:37:17 +0900
Subject: [PATCH 2367/5547] Avoid applying filter in `UpdateBeatmapSet` flow

---
 osu.Game/Screens/Select/BeatmapCarousel.cs    | 12 +++++----
 .../Screens/Select/Carousel/CarouselGroup.cs  | 27 +++++++++++++++++--
 2 files changed, 32 insertions(+), 7 deletions(-)

diff --git a/osu.Game/Screens/Select/BeatmapCarousel.cs b/osu.Game/Screens/Select/BeatmapCarousel.cs
index 75ad0511e6..6d3d7aa185 100644
--- a/osu.Game/Screens/Select/BeatmapCarousel.cs
+++ b/osu.Game/Screens/Select/BeatmapCarousel.cs
@@ -300,16 +300,18 @@ namespace osu.Game.Screens.Select
 
             root.AddChild(newSet);
 
-            // only reset scroll position if already near the scroll target.
-            // without this, during a large beatmap import it is impossible to navigate the carousel.
-            applyActiveCriteria(false, alwaysResetScrollPosition: false);
-
             // check if we can/need to maintain our current selection.
             if (previouslySelectedID != null)
                 select((CarouselItem)newSet.Beatmaps.FirstOrDefault(b => b.BeatmapInfo.ID == previouslySelectedID) ?? newSet);
 
             itemsCache.Invalidate();
-            Schedule(() => BeatmapSetsChanged?.Invoke());
+            Schedule(() =>
+            {
+                if (!Scroll.UserScrolling)
+                    ScrollToSelected(true);
+
+                BeatmapSetsChanged?.Invoke();
+            });
         });
 
         /// <summary>
diff --git a/osu.Game/Screens/Select/Carousel/CarouselGroup.cs b/osu.Game/Screens/Select/Carousel/CarouselGroup.cs
index b85e868b89..7e4c5fad72 100644
--- a/osu.Game/Screens/Select/Carousel/CarouselGroup.cs
+++ b/osu.Game/Screens/Select/Carousel/CarouselGroup.cs
@@ -3,6 +3,7 @@
 
 using System.Collections.Generic;
 using System.Linq;
+using JetBrains.Annotations;
 
 namespace osu.Game.Screens.Select.Carousel
 {
@@ -36,7 +37,21 @@ namespace osu.Game.Screens.Select.Carousel
         {
             i.State.ValueChanged += state => ChildItemStateChanged(i, state.NewValue);
             i.ChildID = ++currentChildID;
-            InternalChildren.Add(i);
+
+            if (lastCriteria != null)
+            {
+                i.Filter(lastCriteria);
+
+                int index = InternalChildren.BinarySearch(i, criteriaComparer);
+                if (index < 0) index = ~index; // BinarySearch hacks multiple return values with 2's complement.
+
+                InternalChildren.Insert(index, i);
+            }
+            else
+            {
+                // criteria may be null for initial population. the filtering will be applied post-add.
+                InternalChildren.Add(i);
+            }
         }
 
         public CarouselGroup(List<CarouselItem> items = null)
@@ -62,14 +77,22 @@ namespace osu.Game.Screens.Select.Carousel
             };
         }
 
+        private Comparer<CarouselItem> criteriaComparer;
+
+        [CanBeNull]
+        private FilterCriteria lastCriteria;
+
         public override void Filter(FilterCriteria criteria)
         {
             base.Filter(criteria);
 
             InternalChildren.ForEach(c => c.Filter(criteria));
+
             // IEnumerable<T>.OrderBy() is used instead of List<T>.Sort() to ensure sorting stability
-            var criteriaComparer = Comparer<CarouselItem>.Create((x, y) => x.CompareTo(criteria, y));
+            criteriaComparer = Comparer<CarouselItem>.Create((x, y) => x.CompareTo(criteria, y));
             InternalChildren = InternalChildren.OrderBy(c => c, criteriaComparer).ToList();
+
+            lastCriteria = criteria;
         }
 
         protected virtual void ChildItemStateChanged(CarouselItem item, CarouselItemState value)

From bed7b69464ed1b6971ae84ee81885d6ce90c5fed Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 21 Jan 2022 13:09:03 +0900
Subject: [PATCH 2368/5547] Apply NRT to `CarouselGroup`

---
 .../Screens/Select/Carousel/CarouselGroup.cs     | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Screens/Select/Carousel/CarouselGroup.cs b/osu.Game/Screens/Select/Carousel/CarouselGroup.cs
index 7e4c5fad72..6ebe314072 100644
--- a/osu.Game/Screens/Select/Carousel/CarouselGroup.cs
+++ b/osu.Game/Screens/Select/Carousel/CarouselGroup.cs
@@ -3,7 +3,8 @@
 
 using System.Collections.Generic;
 using System.Linq;
-using JetBrains.Annotations;
+
+#nullable enable
 
 namespace osu.Game.Screens.Select.Carousel
 {
@@ -12,7 +13,7 @@ namespace osu.Game.Screens.Select.Carousel
     /// </summary>
     public class CarouselGroup : CarouselItem
     {
-        public override DrawableCarouselItem CreateDrawableRepresentation() => null;
+        public override DrawableCarouselItem? CreateDrawableRepresentation() => null;
 
         public IReadOnlyList<CarouselItem> Children => InternalChildren;
 
@@ -24,6 +25,10 @@ namespace osu.Game.Screens.Select.Carousel
         /// </summary>
         private ulong currentChildID;
 
+        private Comparer<CarouselItem>? criteriaComparer;
+
+        private FilterCriteria? lastCriteria;
+
         public virtual void RemoveChild(CarouselItem i)
         {
             InternalChildren.Remove(i);
@@ -54,7 +59,7 @@ namespace osu.Game.Screens.Select.Carousel
             }
         }
 
-        public CarouselGroup(List<CarouselItem> items = null)
+        public CarouselGroup(List<CarouselItem>? items = null)
         {
             if (items != null) InternalChildren = items;
 
@@ -77,11 +82,6 @@ namespace osu.Game.Screens.Select.Carousel
             };
         }
 
-        private Comparer<CarouselItem> criteriaComparer;
-
-        [CanBeNull]
-        private FilterCriteria lastCriteria;
-
         public override void Filter(FilterCriteria criteria)
         {
             base.Filter(criteria);

From 5be41a189bb00e22926511b35424db85c992ead6 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 21 Jan 2022 14:56:28 +0900
Subject: [PATCH 2369/5547] Expose EF context factory for use in external
 migration logic

---
 osu.Game/OsuGameBase.cs | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/osu.Game/OsuGameBase.cs b/osu.Game/OsuGameBase.cs
index 5af992f800..3d40126b4f 100644
--- a/osu.Game/OsuGameBase.cs
+++ b/osu.Game/OsuGameBase.cs
@@ -161,6 +161,11 @@ namespace osu.Game
 
         private readonly BindableNumber<double> globalTrackVolumeAdjust = new BindableNumber<double>(global_track_volume_adjust);
 
+        /// <summary>
+        /// A legacy EF context factory if migration has not been performed to realm yet.
+        /// </summary>
+        protected DatabaseContextFactory EFContextFactory { get; private set; }
+
         public OsuGameBase()
         {
             UseDevelopmentServer = DebugUtils.IsDebugBuild;
@@ -184,19 +189,14 @@ namespace osu.Game
 
             Resources.AddStore(new DllResourceStore(OsuResources.ResourceAssembly));
 
-            DatabaseContextFactory efContextFactory = Storage.Exists(DatabaseContextFactory.DATABASE_NAME)
-                ? new DatabaseContextFactory(Storage)
-                : null;
+            if (Storage.Exists(DatabaseContextFactory.DATABASE_NAME))
+                dependencies.Cache(EFContextFactory = new DatabaseContextFactory(Storage));
 
-            dependencies.Cache(realmFactory = new RealmContextFactory(Storage, "client", efContextFactory));
+            dependencies.Cache(realmFactory = new RealmContextFactory(Storage, "client", EFContextFactory));
 
             dependencies.Cache(RulesetStore = new RulesetStore(realmFactory, Storage));
             dependencies.CacheAs<IRulesetStore>(RulesetStore);
 
-            // A non-null context factory means there's still content to migrate.
-            if (efContextFactory != null)
-                new EFToRealmMigrator(efContextFactory, realmFactory, LocalConfig, Storage).Run();
-
             dependencies.CacheAs(Storage);
 
             var largeStore = new LargeTextureStore(Host.CreateTextureLoaderStore(new NamespacedResourceStore<byte[]>(Resources, @"Textures")));

From 5622d2ba4f704fe707ea5a9e647ee9859277ed34 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 21 Jan 2022 14:56:49 +0900
Subject: [PATCH 2370/5547] Show realm migration progress at `Loader`

---
 osu.Game/Database/EFToRealmMigrator.cs | 150 +++++++++++++++++++------
 osu.Game/Screens/Loader.cs             |  12 +-
 2 files changed, 125 insertions(+), 37 deletions(-)

diff --git a/osu.Game/Database/EFToRealmMigrator.cs b/osu.Game/Database/EFToRealmMigrator.cs
index 727815cc4d..85d65fea82 100644
--- a/osu.Game/Database/EFToRealmMigrator.cs
+++ b/osu.Game/Database/EFToRealmMigrator.cs
@@ -4,52 +4,130 @@
 using System;
 using System.IO;
 using System.Linq;
+using System.Threading.Tasks;
 using Microsoft.EntityFrameworkCore;
+using osu.Framework.Allocation;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
 using osu.Framework.Logging;
 using osu.Framework.Platform;
 using osu.Game.Beatmaps;
 using osu.Game.Configuration;
+using osu.Game.Graphics;
+using osu.Game.Graphics.Sprites;
+using osu.Game.Graphics.UserInterface;
 using osu.Game.Models;
 using osu.Game.Rulesets;
 using osu.Game.Scoring;
 using osu.Game.Skinning;
+using osuTK;
 using Realms;
 
 #nullable enable
 
 namespace osu.Game.Database
 {
-    internal class EFToRealmMigrator
+    internal class EFToRealmMigrator : CompositeDrawable
     {
-        private readonly DatabaseContextFactory efContextFactory;
-        private readonly RealmContextFactory realmContextFactory;
-        private readonly OsuConfigManager config;
-        private readonly Storage storage;
+        public bool FinishedMigrating { get; private set; }
 
-        public EFToRealmMigrator(DatabaseContextFactory efContextFactory, RealmContextFactory realmContextFactory, OsuConfigManager config, Storage storage)
+        [Resolved]
+        private DatabaseContextFactory efContextFactory { get; set; } = null!;
+
+        [Resolved]
+        private RealmContextFactory realmContextFactory { get; set; } = null!;
+
+        [Resolved]
+        private OsuConfigManager config { get; set; } = null!;
+
+        [Resolved]
+        private Storage storage { get; set; } = null!;
+
+        private readonly OsuSpriteText currentOperationText;
+
+        public EFToRealmMigrator()
         {
-            this.efContextFactory = efContextFactory;
-            this.realmContextFactory = realmContextFactory;
-            this.config = config;
-            this.storage = storage;
+            RelativeSizeAxes = Axes.Both;
+
+            InternalChildren = new Drawable[]
+            {
+                new FillFlowContainer
+                {
+                    AutoSizeAxes = Axes.Both,
+                    Direction = FillDirection.Vertical,
+                    Anchor = Anchor.Centre,
+                    Origin = Anchor.Centre,
+                    Spacing = new Vector2(10),
+                    Children = new Drawable[]
+                    {
+                        new OsuSpriteText
+                        {
+                            Anchor = Anchor.Centre,
+                            Origin = Anchor.Centre,
+                            Text = "Database migration in progress",
+                            Font = OsuFont.Default.With(size: 40)
+                        },
+                        new OsuSpriteText
+                        {
+                            Anchor = Anchor.Centre,
+                            Origin = Anchor.Centre,
+                            Text = "This could take a few minutes depending on the speed of your disk(s).",
+                            Font = OsuFont.Default.With(size: 30)
+                        },
+                        new OsuSpriteText
+                        {
+                            Anchor = Anchor.Centre,
+                            Origin = Anchor.Centre,
+                            Text = "Please keep the window open until this completes!",
+                            Font = OsuFont.Default.With(size: 30)
+                        },
+                        new LoadingSpinner(true)
+                        {
+                            State = { Value = Visibility.Visible }
+                        },
+                        currentOperationText = new OsuSpriteText
+                        {
+                            Anchor = Anchor.Centre,
+                            Origin = Anchor.Centre,
+                            Font = OsuFont.Default.With(size: 30)
+                        },
+                    }
+                },
+            };
         }
 
-        public void Run()
+        protected override void LoadComplete()
         {
+            base.LoadComplete();
+
+            // needs to be run on the update thread because of realm BlockAllOperations.
+            // maybe we can work around this? not sure..
             createBackup();
 
-            using (var ef = efContextFactory.Get())
+            Task.Factory.StartNew(() =>
             {
-                migrateSettings(ef);
-                migrateSkins(ef);
-                migrateBeatmaps(ef);
-                migrateScores(ef);
-            }
+                using (var ef = efContextFactory.Get())
+                {
+                    migrateSettings(ef);
+                    migrateSkins(ef);
+                    migrateBeatmaps(ef);
+                    migrateScores(ef);
+                }
 
-            // Delete the database permanently.
-            // Will cause future startups to not attempt migration.
-            Logger.Log("Migration successful, deleting EF database", LoggingTarget.Database);
-            efContextFactory.ResetDatabase();
+                // Delete the database permanently.
+                // Will cause future startups to not attempt migration.
+                log("Migration successful, deleting EF database");
+                efContextFactory.ResetDatabase();
+            }, TaskCreationOptions.LongRunning).ContinueWith(t =>
+            {
+                FinishedMigrating = true;
+            });
+        }
+
+        private void log(string message)
+        {
+            Logger.Log(message, LoggingTarget.Database);
+            Scheduler.AddOnce(m => currentOperationText.Text = m, message);
         }
 
         private void migrateBeatmaps(OsuDbContext ef)
@@ -62,12 +140,12 @@ namespace osu.Game.Database
                                         .Include(s => s.Files).ThenInclude(f => f.FileInfo)
                                         .Include(s => s.Metadata);
 
-            Logger.Log("Beginning beatmaps migration to realm", LoggingTarget.Database);
+            log("Beginning beatmaps migration to realm");
 
             // previous entries in EF are removed post migration.
             if (!existingBeatmapSets.Any())
             {
-                Logger.Log("No beatmaps found to migrate", LoggingTarget.Database);
+                log("No beatmaps found to migrate");
                 return;
             }
 
@@ -75,13 +153,13 @@ namespace osu.Game.Database
 
             using (var realm = realmContextFactory.CreateContext())
             {
-                Logger.Log($"Found {count} beatmaps in EF", LoggingTarget.Database);
+                log($"Found {count} beatmaps in EF");
 
                 // only migrate data if the realm database is empty.
                 // note that this cannot be written as: `realm.All<BeatmapSetInfo>().All(s => s.Protected)`, because realm does not support `.All()`.
                 if (realm.All<BeatmapSetInfo>().Any(s => !s.Protected))
                 {
-                    Logger.Log("Skipping migration as realm already has beatmaps loaded", LoggingTarget.Database);
+                    log("Skipping migration as realm already has beatmaps loaded");
                 }
                 else
                 {
@@ -96,7 +174,7 @@ namespace osu.Game.Database
                             {
                                 transaction.Commit();
                                 transaction = realm.BeginWrite();
-                                Logger.Log($"Migrated {written}/{count} beatmaps...", LoggingTarget.Database);
+                                log($"Migrated {written}/{count} beatmaps...");
                             }
 
                             var realmBeatmapSet = new BeatmapSetInfo
@@ -156,7 +234,7 @@ namespace osu.Game.Database
                         transaction.Commit();
                     }
 
-                    Logger.Log($"Successfully migrated {count} beatmaps to realm", LoggingTarget.Database);
+                    log($"Successfully migrated {count} beatmaps to realm");
                 }
             }
         }
@@ -193,12 +271,12 @@ namespace osu.Game.Database
                                    .Include(s => s.Files)
                                    .ThenInclude(f => f.FileInfo);
 
-            Logger.Log("Beginning scores migration to realm", LoggingTarget.Database);
+            log("Beginning scores migration to realm");
 
             // previous entries in EF are removed post migration.
             if (!existingScores.Any())
             {
-                Logger.Log("No scores found to migrate", LoggingTarget.Database);
+                log("No scores found to migrate");
                 return;
             }
 
@@ -206,12 +284,12 @@ namespace osu.Game.Database
 
             using (var realm = realmContextFactory.CreateContext())
             {
-                Logger.Log($"Found {count} scores in EF", LoggingTarget.Database);
+                log($"Found {count} scores in EF");
 
                 // only migrate data if the realm database is empty.
                 if (realm.All<ScoreInfo>().Any())
                 {
-                    Logger.Log("Skipping migration as realm already has scores loaded", LoggingTarget.Database);
+                    log("Skipping migration as realm already has scores loaded");
                 }
                 else
                 {
@@ -226,7 +304,7 @@ namespace osu.Game.Database
                             {
                                 transaction.Commit();
                                 transaction = realm.BeginWrite();
-                                Logger.Log($"Migrated {written}/{count} scores...", LoggingTarget.Database);
+                                log($"Migrated {written}/{count} scores...");
                             }
 
                             var beatmap = realm.All<BeatmapInfo>().First(b => b.Hash == score.BeatmapInfo.Hash);
@@ -270,7 +348,7 @@ namespace osu.Game.Database
                         transaction.Commit();
                     }
 
-                    Logger.Log($"Successfully migrated {count} scores to realm", LoggingTarget.Database);
+                    log($"Successfully migrated {count} scores to realm");
                 }
             }
         }
@@ -308,7 +386,7 @@ namespace osu.Game.Database
                 // note that this cannot be written as: `realm.All<SkinInfo>().All(s => s.Protected)`, because realm does not support `.All()`.
                 if (!realm.All<SkinInfo>().Any(s => !s.Protected))
                 {
-                    Logger.Log($"Migrating {existingSkins.Count} skins", LoggingTarget.Database);
+                    log($"Migrating {existingSkins.Count} skins");
 
                     foreach (var skin in existingSkins)
                     {
@@ -356,7 +434,7 @@ namespace osu.Game.Database
             if (!existingSettings.Any())
                 return;
 
-            Logger.Log("Beginning settings migration to realm", LoggingTarget.Database);
+            log("Beginning settings migration to realm");
 
             using (var realm = realmContextFactory.CreateContext())
             using (var transaction = realm.BeginWrite())
@@ -364,7 +442,7 @@ namespace osu.Game.Database
                 // only migrate data if the realm database is empty.
                 if (!realm.All<RealmRulesetSetting>().Any())
                 {
-                    Logger.Log($"Migrating {existingSettings.Count} settings", LoggingTarget.Database);
+                    log($"Migrating {existingSettings.Count} settings");
 
                     foreach (var dkb in existingSettings)
                     {
diff --git a/osu.Game/Screens/Loader.cs b/osu.Game/Screens/Loader.cs
index 41097a4c74..8c4a13f2bd 100644
--- a/osu.Game/Screens/Loader.cs
+++ b/osu.Game/Screens/Loader.cs
@@ -12,6 +12,7 @@ using osu.Game.Screens.Menu;
 using osu.Framework.Screens;
 using osu.Framework.Threading;
 using osu.Game.Configuration;
+using osu.Game.Database;
 using osu.Game.Graphics.UserInterface;
 using IntroSequence = osu.Game.Configuration.IntroSequence;
 
@@ -63,6 +64,11 @@ namespace osu.Game.Screens
 
         protected virtual ShaderPrecompiler CreateShaderPrecompiler() => new ShaderPrecompiler();
 
+        [Resolved(canBeNull: true)]
+        private DatabaseContextFactory efContextFactory { get; set; }
+
+        private EFToRealmMigrator realmMigrator;
+
         public override void OnEntering(IScreen last)
         {
             base.OnEntering(last);
@@ -70,6 +76,10 @@ namespace osu.Game.Screens
             LoadComponentAsync(precompiler = CreateShaderPrecompiler(), AddInternal);
             LoadComponentAsync(loadableScreen = CreateLoadableScreen());
 
+            // A non-null context factory means there's still content to migrate.
+            if (efContextFactory != null)
+                LoadComponentAsync(realmMigrator = new EFToRealmMigrator(), AddInternal);
+
             LoadComponentAsync(spinner = new LoadingSpinner(true, true)
             {
                 Anchor = Anchor.BottomRight,
@@ -86,7 +96,7 @@ namespace osu.Game.Screens
 
         private void checkIfLoaded()
         {
-            if (loadableScreen.LoadState != LoadState.Ready || !precompiler.FinishedCompiling)
+            if (loadableScreen.LoadState != LoadState.Ready || !precompiler.FinishedCompiling || realmMigrator?.FinishedMigrating == false)
             {
                 Schedule(checkIfLoaded);
                 return;

From 3bcdce128c5927a90f718b0ef54d76678272648a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 21 Jan 2022 15:29:21 +0900
Subject: [PATCH 2371/5547] Use dictionary add for safety

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

diff --git a/osu.Game/Screens/Select/BeatmapCarousel.cs b/osu.Game/Screens/Select/BeatmapCarousel.cs
index 3cd9253eff..e8171d1512 100644
--- a/osu.Game/Screens/Select/BeatmapCarousel.cs
+++ b/osu.Game/Screens/Select/BeatmapCarousel.cs
@@ -934,7 +934,7 @@ namespace osu.Game.Screens.Select
             public override void AddChild(CarouselItem i)
             {
                 CarouselBeatmapSet set = (CarouselBeatmapSet)i;
-                BeatmapSetsByID[set.BeatmapSet.ID] = set;
+                BeatmapSetsByID.Add(set.BeatmapSet.ID, set);
 
                 base.AddChild(i);
             }

From dde10d1ba214691e8f41616a0f3fe5b1949867cc Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 21 Jan 2022 16:38:07 +0900
Subject: [PATCH 2372/5547] Remove unused `IRealmFactory` interface

---
 osu.Game/Database/IRealmFactory.cs       | 20 --------------------
 osu.Game/Database/RealmContextFactory.cs |  2 +-
 2 files changed, 1 insertion(+), 21 deletions(-)
 delete mode 100644 osu.Game/Database/IRealmFactory.cs

diff --git a/osu.Game/Database/IRealmFactory.cs b/osu.Game/Database/IRealmFactory.cs
deleted file mode 100644
index a957424584..0000000000
--- a/osu.Game/Database/IRealmFactory.cs
+++ /dev/null
@@ -1,20 +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 Realms;
-
-namespace osu.Game.Database
-{
-    public interface IRealmFactory
-    {
-        /// <summary>
-        /// The main realm context, bound to the update thread.
-        /// </summary>
-        Realm Context { get; }
-
-        /// <summary>
-        /// Create a new realm context for use on the current thread.
-        /// </summary>
-        Realm CreateContext();
-    }
-}
diff --git a/osu.Game/Database/RealmContextFactory.cs b/osu.Game/Database/RealmContextFactory.cs
index 50e456a0c8..c1b159eac7 100644
--- a/osu.Game/Database/RealmContextFactory.cs
+++ b/osu.Game/Database/RealmContextFactory.cs
@@ -30,7 +30,7 @@ namespace osu.Game.Database
     /// <summary>
     /// A factory which provides both the main (update thread bound) realm context and creates contexts for async usage.
     /// </summary>
-    public class RealmContextFactory : IDisposable, IRealmFactory
+    public class RealmContextFactory : IDisposable
     {
         private readonly Storage storage;
 

From a59105635e36c31baf63217ea74d472ec09dc239 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 21 Jan 2022 16:40:20 +0900
Subject: [PATCH 2373/5547] Make `CreateContext` private

---
 osu.Game/Database/RealmContextFactory.cs | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Database/RealmContextFactory.cs b/osu.Game/Database/RealmContextFactory.cs
index c1b159eac7..5c9d2d7c5a 100644
--- a/osu.Game/Database/RealmContextFactory.cs
+++ b/osu.Game/Database/RealmContextFactory.cs
@@ -72,13 +72,13 @@ namespace osu.Game.Database
             get
             {
                 if (!ThreadSafety.IsUpdateThread)
-                    throw new InvalidOperationException(@$"Use {nameof(CreateContext)} when performing realm operations from a non-update thread");
+                    throw new InvalidOperationException(@$"Use {nameof(createContext)} when performing realm operations from a non-update thread");
 
                 lock (contextLock)
                 {
                     if (context == null)
                     {
-                        context = CreateContext();
+                        context = createContext();
                         Logger.Log(@$"Opened realm ""{context.Config.DatabasePath}"" at version {context.Config.SchemaVersion}");
                     }
 
@@ -124,7 +124,7 @@ namespace osu.Game.Database
 
         private void cleanupPendingDeletions()
         {
-            using (var realm = CreateContext())
+            using (var realm = createContext())
             using (var transaction = realm.BeginWrite())
             {
                 var pendingDeleteScores = realm.All<ScoreInfo>().Where(s => s.DeletePending);
@@ -182,7 +182,7 @@ namespace osu.Game.Database
             if (ThreadSafety.IsUpdateThread)
                 return action(Context);
 
-            using (var realm = CreateContext())
+            using (var realm = createContext())
                 return action(realm);
         }
 
@@ -199,12 +199,12 @@ namespace osu.Game.Database
                 action(Context);
             else
             {
-                using (var realm = CreateContext())
+                using (var realm = createContext())
                     action(realm);
             }
         }
 
-        public Realm CreateContext()
+        private Realm createContext()
         {
             if (isDisposed)
                 throw new ObjectDisposedException(nameof(RealmContextFactory));

From da0a803e6c2df35194fd5a21e98f5940955d9f5f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 21 Jan 2022 17:08:02 +0900
Subject: [PATCH 2374/5547] Add `RealmContextFactory.Write` helper method

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

diff --git a/osu.Game/Database/RealmContextFactory.cs b/osu.Game/Database/RealmContextFactory.cs
index 5c9d2d7c5a..ea33fec2a0 100644
--- a/osu.Game/Database/RealmContextFactory.cs
+++ b/osu.Game/Database/RealmContextFactory.cs
@@ -204,6 +204,24 @@ namespace osu.Game.Database
             }
         }
 
+        /// <summary>
+        /// Write changes to realm.
+        /// </summary>
+        /// <remarks>
+        /// Handles correct context management and transaction committing automatically.
+        /// </remarks>
+        /// <param name="action">The work to run.</param>
+        public void Write(Action<Realm> action)
+        {
+            if (ThreadSafety.IsUpdateThread)
+                Context.Write(action);
+            else
+            {
+                using (var realm = createContext())
+                    realm.Write(action);
+            }
+        }
+
         private Realm createContext()
         {
             if (isDisposed)

From 114c9e8c1f985b2df61cd8e65e9a3bef9f94bb57 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 21 Jan 2022 17:08:20 +0900
Subject: [PATCH 2375/5547] Update all usages of `CreateContext` to use either
 `Run` or `Write`

---
 .../Beatmaps/IO/BeatmapImportHelper.cs        |   3 +-
 osu.Game.Tests/Database/GeneralUsageTests.cs  |  20 ++--
 osu.Game.Tests/Database/RealmLiveTests.cs     |  57 +++++-----
 .../Database/TestRealmKeyBindingStore.cs      |  27 ++---
 ...eneOnlinePlayBeatmapAvailabilityTracker.cs |   4 +-
 .../Visual/Ranking/TestSceneResultsScreen.cs  |   4 +-
 .../TestSceneDeleteLocalScore.cs              |   4 +-
 osu.Game/Beatmaps/BeatmapManager.cs           |  26 ++---
 osu.Game/Beatmaps/BeatmapModelManager.cs      |   4 +-
 osu.Game/Database/EFToRealmMigrator.cs        | 104 +++++++++--------
 osu.Game/Database/RealmLive.cs                |   7 +-
 osu.Game/Input/RealmKeyBindingStore.cs        |  36 +++---
 .../Sections/Input/KeyBindingsSubsection.cs   |   5 +-
 .../Configuration/RulesetConfigManager.cs     |  18 +--
 osu.Game/Rulesets/RulesetStore.cs             | 107 +++++++++---------
 osu.Game/Scoring/ScoreManager.cs              |  11 +-
 osu.Game/Screens/Select/BeatmapCarousel.cs    |   3 +-
 .../Select/Leaderboards/BeatmapLeaderboard.cs |   6 +-
 osu.Game/Skinning/SkinManager.cs              |  19 ++--
 osu.Game/Skinning/SkinModelManager.cs         |   4 +-
 osu.Game/Stores/RealmArchiveModelImporter.cs  |   4 +-
 osu.Game/Stores/RealmFileStore.cs             |   7 +-
 22 files changed, 230 insertions(+), 250 deletions(-)

diff --git a/osu.Game.Tests/Beatmaps/IO/BeatmapImportHelper.cs b/osu.Game.Tests/Beatmaps/IO/BeatmapImportHelper.cs
index 44f6943871..7aa2dc7093 100644
--- a/osu.Game.Tests/Beatmaps/IO/BeatmapImportHelper.cs
+++ b/osu.Game.Tests/Beatmaps/IO/BeatmapImportHelper.cs
@@ -55,8 +55,7 @@ namespace osu.Game.Tests.Beatmaps.IO
         {
             var realmContextFactory = osu.Dependencies.Get<RealmContextFactory>();
 
-            using (var realm = realmContextFactory.CreateContext())
-                BeatmapImporterTests.EnsureLoaded(realm, timeout);
+            realmContextFactory.Run(realm => BeatmapImporterTests.EnsureLoaded(realm, timeout));
 
             // TODO: add back some extra checks outside of the realm ones?
             // var set = queryBeatmapSets().First();
diff --git a/osu.Game.Tests/Database/GeneralUsageTests.cs b/osu.Game.Tests/Database/GeneralUsageTests.cs
index 0961ad71e4..9ebe94b383 100644
--- a/osu.Game.Tests/Database/GeneralUsageTests.cs
+++ b/osu.Game.Tests/Database/GeneralUsageTests.cs
@@ -21,7 +21,7 @@ namespace osu.Game.Tests.Database
         [Test]
         public void TestConstructRealm()
         {
-            RunTestWithRealm((realmFactory, _) => { realmFactory.CreateContext().Refresh(); });
+            RunTestWithRealm((realmFactory, _) => { realmFactory.Run(realm => realm.Refresh()); });
         }
 
         [Test]
@@ -46,23 +46,21 @@ namespace osu.Game.Tests.Database
             {
                 bool callbackRan = false;
 
-                using (var context = realmFactory.CreateContext())
+                realmFactory.Run(realm =>
                 {
-                    var subscription = context.All<BeatmapInfo>().QueryAsyncWithNotifications((sender, changes, error) =>
+                    var subscription = realm.All<BeatmapInfo>().QueryAsyncWithNotifications((sender, changes, error) =>
                     {
-                        using (realmFactory.CreateContext())
+                        realmFactory.Run(_ =>
                         {
                             callbackRan = true;
-                        }
+                        });
                     });
 
                     // Force the callback above to run.
-                    using (realmFactory.CreateContext())
-                    {
-                    }
+                    realmFactory.Run(r => r.Refresh());
 
                     subscription?.Dispose();
-                }
+                });
 
                 Assert.IsTrue(callbackRan);
             });
@@ -78,12 +76,12 @@ namespace osu.Game.Tests.Database
 
                 Task.Factory.StartNew(() =>
                 {
-                    using (realmFactory.CreateContext())
+                    realmFactory.Run(_ =>
                     {
                         hasThreadedUsage.Set();
 
                         stopThreadedUsage.Wait();
-                    }
+                    });
                 }, TaskCreationOptions.LongRunning | TaskCreationOptions.HideScheduler);
 
                 hasThreadedUsage.Wait();
diff --git a/osu.Game.Tests/Database/RealmLiveTests.cs b/osu.Game.Tests/Database/RealmLiveTests.cs
index 187fcd3ca7..2f16df4624 100644
--- a/osu.Game.Tests/Database/RealmLiveTests.cs
+++ b/osu.Game.Tests/Database/RealmLiveTests.cs
@@ -23,9 +23,9 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealm((realmFactory, _) =>
             {
-                ILive<BeatmapInfo> beatmap = realmFactory.CreateContext().Write(r => r.Add(new BeatmapInfo(CreateRuleset(), new BeatmapDifficulty(), new BeatmapMetadata()))).ToLive(realmFactory);
+                ILive<BeatmapInfo> beatmap = realmFactory.Run(realm => realm.Write(r => r.Add(new BeatmapInfo(CreateRuleset(), new BeatmapDifficulty(), new BeatmapMetadata()))).ToLive(realmFactory));
 
-                ILive<BeatmapInfo> beatmap2 = realmFactory.CreateContext().All<BeatmapInfo>().First().ToLive(realmFactory);
+                ILive<BeatmapInfo> beatmap2 = realmFactory.Run(realm => realm.All<BeatmapInfo>().First().ToLive(realmFactory));
 
                 Assert.AreEqual(beatmap, beatmap2);
             });
@@ -38,14 +38,14 @@ namespace osu.Game.Tests.Database
             {
                 var beatmap = new BeatmapInfo(CreateRuleset(), new BeatmapDifficulty(), new BeatmapMetadata());
 
-                ILive<BeatmapInfo> liveBeatmap;
+                ILive<BeatmapInfo>? liveBeatmap = null;
 
-                using (var context = realmFactory.CreateContext())
+                realmFactory.Run(realm =>
                 {
-                    context.Write(r => r.Add(beatmap));
+                    realm.Write(r => r.Add(beatmap));
 
                     liveBeatmap = beatmap.ToLive(realmFactory);
-                }
+                });
 
                 using (var migratedStorage = new TemporaryNativeStorage("realm-test-migration-target"))
                 {
@@ -53,7 +53,7 @@ namespace osu.Game.Tests.Database
 
                     storage.Migrate(migratedStorage);
 
-                    Assert.IsFalse(liveBeatmap.PerformRead(l => l.Hidden));
+                    Assert.IsFalse(liveBeatmap?.PerformRead(l => l.Hidden));
                 }
             });
         }
@@ -67,8 +67,7 @@ namespace osu.Game.Tests.Database
 
                 var liveBeatmap = beatmap.ToLive(realmFactory);
 
-                using (var context = realmFactory.CreateContext())
-                    context.Write(r => r.Add(beatmap));
+                realmFactory.Run(realm => realm.Write(r => r.Add(beatmap)));
 
                 Assert.IsFalse(liveBeatmap.PerformRead(l => l.Hidden));
             });
@@ -99,12 +98,12 @@ namespace osu.Game.Tests.Database
                 ILive<BeatmapInfo>? liveBeatmap = null;
                 Task.Factory.StartNew(() =>
                 {
-                    using (var threadContext = realmFactory.CreateContext())
+                    realmFactory.Run(threadContext =>
                     {
                         var beatmap = threadContext.Write(r => r.Add(new BeatmapInfo(CreateRuleset(), new BeatmapDifficulty(), new BeatmapMetadata())));
 
                         liveBeatmap = beatmap.ToLive(realmFactory);
-                    }
+                    });
                 }, TaskCreationOptions.LongRunning | TaskCreationOptions.HideScheduler).WaitSafely();
 
                 Debug.Assert(liveBeatmap != null);
@@ -128,12 +127,12 @@ namespace osu.Game.Tests.Database
                 ILive<BeatmapInfo>? liveBeatmap = null;
                 Task.Factory.StartNew(() =>
                 {
-                    using (var threadContext = realmFactory.CreateContext())
+                    realmFactory.Run(threadContext =>
                     {
                         var beatmap = threadContext.Write(r => r.Add(new BeatmapInfo(CreateRuleset(), new BeatmapDifficulty(), new BeatmapMetadata())));
 
                         liveBeatmap = beatmap.ToLive(realmFactory);
-                    }
+                    });
                 }, TaskCreationOptions.LongRunning | TaskCreationOptions.HideScheduler).WaitSafely();
 
                 Debug.Assert(liveBeatmap != null);
@@ -170,12 +169,12 @@ namespace osu.Game.Tests.Database
 
                 Task.Factory.StartNew(() =>
                 {
-                    using (var threadContext = realmFactory.CreateContext())
+                    realmFactory.Run(threadContext =>
                     {
                         var beatmap = threadContext.Write(r => r.Add(new BeatmapInfo(CreateRuleset(), new BeatmapDifficulty(), new BeatmapMetadata())));
 
                         liveBeatmap = beatmap.ToLive(realmFactory);
-                    }
+                    });
                 }, TaskCreationOptions.LongRunning | TaskCreationOptions.HideScheduler).WaitSafely();
 
                 Debug.Assert(liveBeatmap != null);
@@ -189,13 +188,13 @@ namespace osu.Game.Tests.Database
                     });
 
                     // Can't be used, even from within a valid context.
-                    using (realmFactory.CreateContext())
+                    realmFactory.Run(threadContext =>
                     {
                         Assert.Throws<InvalidOperationException>(() =>
                         {
                             var __ = liveBeatmap.Value;
                         });
-                    }
+                    });
                 }, TaskCreationOptions.LongRunning | TaskCreationOptions.HideScheduler).WaitSafely();
             });
         }
@@ -208,12 +207,12 @@ namespace osu.Game.Tests.Database
                 ILive<BeatmapInfo>? liveBeatmap = null;
                 Task.Factory.StartNew(() =>
                 {
-                    using (var threadContext = realmFactory.CreateContext())
+                    realmFactory.Run(threadContext =>
                     {
                         var beatmap = threadContext.Write(r => r.Add(new BeatmapInfo(CreateRuleset(), new BeatmapDifficulty(), new BeatmapMetadata())));
 
                         liveBeatmap = beatmap.ToLive(realmFactory);
-                    }
+                    });
                 }, TaskCreationOptions.LongRunning | TaskCreationOptions.HideScheduler).WaitSafely();
 
                 Debug.Assert(liveBeatmap != null);
@@ -235,50 +234,50 @@ namespace osu.Game.Tests.Database
             {
                 int changesTriggered = 0;
 
-                using (var updateThreadContext = realmFactory.CreateContext())
+                realmFactory.Run(outerRealm =>
                 {
-                    updateThreadContext.All<BeatmapInfo>().QueryAsyncWithNotifications(gotChange);
+                    outerRealm.All<BeatmapInfo>().QueryAsyncWithNotifications(gotChange);
                     ILive<BeatmapInfo>? liveBeatmap = null;
 
                     Task.Factory.StartNew(() =>
                     {
-                        using (var threadContext = realmFactory.CreateContext())
+                        realmFactory.Run(innerRealm =>
                         {
                             var ruleset = CreateRuleset();
-                            var beatmap = threadContext.Write(r => r.Add(new BeatmapInfo(ruleset, new BeatmapDifficulty(), new BeatmapMetadata())));
+                            var beatmap = innerRealm.Write(r => r.Add(new BeatmapInfo(ruleset, new BeatmapDifficulty(), new BeatmapMetadata())));
 
                             // add a second beatmap to ensure that a full refresh occurs below.
                             // not just a refresh from the resolved Live.
-                            threadContext.Write(r => r.Add(new BeatmapInfo(ruleset, new BeatmapDifficulty(), new BeatmapMetadata())));
+                            innerRealm.Write(r => r.Add(new BeatmapInfo(ruleset, new BeatmapDifficulty(), new BeatmapMetadata())));
 
                             liveBeatmap = beatmap.ToLive(realmFactory);
-                        }
+                        });
                     }, TaskCreationOptions.LongRunning | TaskCreationOptions.HideScheduler).WaitSafely();
 
                     Debug.Assert(liveBeatmap != null);
 
                     // not yet seen by main context
-                    Assert.AreEqual(0, updateThreadContext.All<BeatmapInfo>().Count());
+                    Assert.AreEqual(0, outerRealm.All<BeatmapInfo>().Count());
                     Assert.AreEqual(0, changesTriggered);
 
                     liveBeatmap.PerformRead(resolved =>
                     {
                         // retrieval causes an implicit refresh. even changes that aren't related to the retrieval are fired at this point.
                         // ReSharper disable once AccessToDisposedClosure
-                        Assert.AreEqual(2, updateThreadContext.All<BeatmapInfo>().Count());
+                        Assert.AreEqual(2, outerRealm.All<BeatmapInfo>().Count());
                         Assert.AreEqual(1, changesTriggered);
 
                         // can access properties without a crash.
                         Assert.IsFalse(resolved.Hidden);
 
                         // ReSharper disable once AccessToDisposedClosure
-                        updateThreadContext.Write(r =>
+                        outerRealm.Write(r =>
                         {
                             // can use with the main context.
                             r.Remove(resolved);
                         });
                     });
-                }
+                });
 
                 void gotChange(IRealmCollection<BeatmapInfo> sender, ChangeSet changes, Exception error)
                 {
diff --git a/osu.Game.Tests/Database/TestRealmKeyBindingStore.cs b/osu.Game.Tests/Database/TestRealmKeyBindingStore.cs
index e3c1d42667..c1041e9fd6 100644
--- a/osu.Game.Tests/Database/TestRealmKeyBindingStore.cs
+++ b/osu.Game.Tests/Database/TestRealmKeyBindingStore.cs
@@ -60,15 +60,12 @@ namespace osu.Game.Tests.Database
             KeyBindingContainer testContainer = new TestKeyBindingContainer();
 
             // Add some excess bindings for an action which only supports 1.
-            using (var realm = realmContextFactory.CreateContext())
-            using (var transaction = realm.BeginWrite())
+            realmContextFactory.Write(realm =>
             {
                 realm.Add(new RealmKeyBinding(GlobalAction.Back, new KeyCombination(InputKey.A)));
                 realm.Add(new RealmKeyBinding(GlobalAction.Back, new KeyCombination(InputKey.S)));
                 realm.Add(new RealmKeyBinding(GlobalAction.Back, new KeyCombination(InputKey.D)));
-
-                transaction.Commit();
-            }
+            });
 
             Assert.That(queryCount(GlobalAction.Back), Is.EqualTo(3));
 
@@ -79,13 +76,13 @@ namespace osu.Game.Tests.Database
 
         private int queryCount(GlobalAction? match = null)
         {
-            using (var realm = realmContextFactory.CreateContext())
+            return realmContextFactory.Run(realm =>
             {
                 var results = realm.All<RealmKeyBinding>();
                 if (match.HasValue)
                     results = results.Where(k => k.ActionInt == (int)match.Value);
                 return results.Count();
-            }
+            });
         }
 
         [Test]
@@ -95,26 +92,26 @@ namespace osu.Game.Tests.Database
 
             keyBindingStore.Register(testContainer, Enumerable.Empty<RulesetInfo>());
 
-            using (var primaryRealm = realmContextFactory.CreateContext())
+            realmContextFactory.Run(outerRealm =>
             {
-                var backBinding = primaryRealm.All<RealmKeyBinding>().Single(k => k.ActionInt == (int)GlobalAction.Back);
+                var backBinding = outerRealm.All<RealmKeyBinding>().Single(k => k.ActionInt == (int)GlobalAction.Back);
 
                 Assert.That(backBinding.KeyCombination.Keys, Is.EquivalentTo(new[] { InputKey.Escape }));
 
                 var tsr = ThreadSafeReference.Create(backBinding);
 
-                using (var threadedContext = realmContextFactory.CreateContext())
+                realmContextFactory.Run(innerRealm =>
                 {
-                    var binding = threadedContext.ResolveReference(tsr);
-                    threadedContext.Write(() => binding.KeyCombination = new KeyCombination(InputKey.BackSpace));
-                }
+                    var binding = innerRealm.ResolveReference(tsr);
+                    innerRealm.Write(() => binding.KeyCombination = new KeyCombination(InputKey.BackSpace));
+                });
 
                 Assert.That(backBinding.KeyCombination.Keys, Is.EquivalentTo(new[] { InputKey.BackSpace }));
 
                 // check still correct after re-query.
-                backBinding = primaryRealm.All<RealmKeyBinding>().Single(k => k.ActionInt == (int)GlobalAction.Back);
+                backBinding = outerRealm.All<RealmKeyBinding>().Single(k => k.ActionInt == (int)GlobalAction.Back);
                 Assert.That(backBinding.KeyCombination.Keys, Is.EquivalentTo(new[] { InputKey.BackSpace }));
-            }
+            });
         }
 
         [TearDown]
diff --git a/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs b/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
index 8c24b2eef8..1d639c6418 100644
--- a/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
+++ b/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
@@ -60,8 +60,8 @@ namespace osu.Game.Tests.Online
             testBeatmapInfo = getTestBeatmapInfo(testBeatmapFile);
             testBeatmapSet = testBeatmapInfo.BeatmapSet;
 
-            ContextFactory.Context.Write(r => r.RemoveAll<BeatmapSetInfo>());
-            ContextFactory.Context.Write(r => r.RemoveAll<BeatmapInfo>());
+            ContextFactory.Write(r => r.RemoveAll<BeatmapSetInfo>());
+            ContextFactory.Write(r => r.RemoveAll<BeatmapInfo>());
 
             selectedItem.Value = new PlaylistItem
             {
diff --git a/osu.Game.Tests/Visual/Ranking/TestSceneResultsScreen.cs b/osu.Game.Tests/Visual/Ranking/TestSceneResultsScreen.cs
index 62500babc1..a77480ee54 100644
--- a/osu.Game.Tests/Visual/Ranking/TestSceneResultsScreen.cs
+++ b/osu.Game.Tests/Visual/Ranking/TestSceneResultsScreen.cs
@@ -42,7 +42,7 @@ namespace osu.Game.Tests.Visual.Ranking
         {
             base.LoadComplete();
 
-            using (var realm = realmContextFactory.CreateContext())
+            realmContextFactory.Run(realm =>
             {
                 var beatmapInfo = realm.All<BeatmapInfo>()
                                        .Filter($"{nameof(BeatmapInfo.Ruleset)}.{nameof(RulesetInfo.OnlineID)} = $0", 0)
@@ -50,7 +50,7 @@ namespace osu.Game.Tests.Visual.Ranking
 
                 if (beatmapInfo != null)
                     Beatmap.Value = beatmaps.GetWorkingBeatmap(beatmapInfo);
-            }
+            });
         }
 
         [Test]
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
index 1e14e4b3e5..f43354514b 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
@@ -122,11 +122,11 @@ namespace osu.Game.Tests.Visual.UserInterface
         [SetUp]
         public void Setup() => Schedule(() =>
         {
-            using (var realm = realmFactory.CreateContext())
+            realmFactory.Run(realm =>
             {
                 // Due to soft deletions, we can re-use deleted scores between test runs
                 scoreManager.Undelete(realm.All<ScoreInfo>().Where(s => s.DeletePending).ToList());
-            }
+            });
 
             leaderboard.Scores = null;
             leaderboard.FinishTransforms(true); // After setting scores, we may be waiting for transforms to expire drawables
diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index cc765657cc..a9340e1250 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -153,14 +153,16 @@ namespace osu.Game.Beatmaps
 
         public void RestoreAll()
         {
-            using (var realm = contextFactory.CreateContext())
-            using (var transaction = realm.BeginWrite())
+            contextFactory.Run(realm =>
             {
-                foreach (var beatmap in realm.All<BeatmapInfo>().Where(b => b.Hidden))
-                    beatmap.Hidden = false;
+                using (var transaction = realm.BeginWrite())
+                {
+                    foreach (var beatmap in realm.All<BeatmapInfo>().Where(b => b.Hidden))
+                        beatmap.Hidden = false;
 
-                transaction.Commit();
-            }
+                    transaction.Commit();
+                }
+            });
         }
 
         /// <summary>
@@ -169,8 +171,7 @@ namespace osu.Game.Beatmaps
         /// <returns>A list of available <see cref="BeatmapSetInfo"/>.</returns>
         public List<BeatmapSetInfo> GetAllUsableBeatmapSets()
         {
-            using (var context = contextFactory.CreateContext())
-                return context.All<BeatmapSetInfo>().Where(b => !b.DeletePending).Detach();
+            return contextFactory.Run(realm => realm.All<BeatmapSetInfo>().Where(b => !b.DeletePending).Detach());
         }
 
         /// <summary>
@@ -235,21 +236,20 @@ namespace osu.Game.Beatmaps
 
         public void Delete(Expression<Func<BeatmapSetInfo, bool>>? filter = null, bool silent = false)
         {
-            using (var context = contextFactory.CreateContext())
+            contextFactory.Run(realm =>
             {
-                var items = context.All<BeatmapSetInfo>().Where(s => !s.DeletePending && !s.Protected);
+                var items = realm.All<BeatmapSetInfo>().Where(s => !s.DeletePending && !s.Protected);
 
                 if (filter != null)
                     items = items.Where(filter);
 
                 beatmapModelManager.Delete(items.ToList(), silent);
-            }
+            });
         }
 
         public void UndeleteAll()
         {
-            using (var context = contextFactory.CreateContext())
-                beatmapModelManager.Undelete(context.All<BeatmapSetInfo>().Where(s => s.DeletePending).ToList());
+            contextFactory.Run(realm => beatmapModelManager.Undelete(realm.All<BeatmapSetInfo>().Where(s => s.DeletePending).ToList()));
         }
 
         public void Undelete(List<BeatmapSetInfo> items, bool silent = false)
diff --git a/osu.Game/Beatmaps/BeatmapModelManager.cs b/osu.Game/Beatmaps/BeatmapModelManager.cs
index a4ba13a88d..44d6af5b73 100644
--- a/osu.Game/Beatmaps/BeatmapModelManager.cs
+++ b/osu.Game/Beatmaps/BeatmapModelManager.cs
@@ -103,10 +103,10 @@ namespace osu.Game.Beatmaps
 
         public void Update(BeatmapSetInfo item)
         {
-            ContextFactory.Run(realm =>
+            ContextFactory.Write(realm =>
             {
                 var existing = realm.Find<BeatmapSetInfo>(item.ID);
-                realm.Write(r => item.CopyChangesToRealm(existing));
+                item.CopyChangesToRealm(existing);
             });
         }
     }
diff --git a/osu.Game/Database/EFToRealmMigrator.cs b/osu.Game/Database/EFToRealmMigrator.cs
index 0f726f8ee5..58321efcc9 100644
--- a/osu.Game/Database/EFToRealmMigrator.cs
+++ b/osu.Game/Database/EFToRealmMigrator.cs
@@ -73,7 +73,7 @@ namespace osu.Game.Database
 
             int count = existingBeatmapSets.Count();
 
-            using (var realm = realmContextFactory.CreateContext())
+            realmContextFactory.Run(realm =>
             {
                 Logger.Log($"Found {count} beatmaps in EF", LoggingTarget.Database);
 
@@ -160,7 +160,7 @@ namespace osu.Game.Database
 
                     Logger.Log($"Successfully migrated {count} beatmaps to realm", LoggingTarget.Database);
                 }
-            }
+            });
         }
 
         private BeatmapMetadata getBestMetadata(EFBeatmapMetadata? beatmapMetadata, EFBeatmapMetadata? beatmapSetMetadata)
@@ -206,7 +206,7 @@ namespace osu.Game.Database
 
             int count = existingScores.Count();
 
-            using (var realm = realmContextFactory.CreateContext())
+            realmContextFactory.Run(realm =>
             {
                 Logger.Log($"Found {count} scores in EF", LoggingTarget.Database);
 
@@ -276,7 +276,7 @@ namespace osu.Game.Database
 
                     Logger.Log($"Successfully migrated {count} scores to realm", LoggingTarget.Database);
                 }
-            }
+            });
         }
 
         private void migrateSkins(OsuDbContext db)
@@ -307,37 +307,39 @@ namespace osu.Game.Database
                     break;
             }
 
-            using (var realm = realmContextFactory.CreateContext())
-            using (var transaction = realm.BeginWrite())
+            realmContextFactory.Run(realm =>
             {
-                // only migrate data if the realm database is empty.
-                // note that this cannot be written as: `realm.All<SkinInfo>().All(s => s.Protected)`, because realm does not support `.All()`.
-                if (!realm.All<SkinInfo>().Any(s => !s.Protected))
+                using (var transaction = realm.BeginWrite())
                 {
-                    Logger.Log($"Migrating {existingSkins.Count} skins", LoggingTarget.Database);
-
-                    foreach (var skin in existingSkins)
+                    // only migrate data if the realm database is empty.
+                    // note that this cannot be written as: `realm.All<SkinInfo>().All(s => s.Protected)`, because realm does not support `.All()`.
+                    if (!realm.All<SkinInfo>().Any(s => !s.Protected))
                     {
-                        var realmSkin = new SkinInfo
+                        Logger.Log($"Migrating {existingSkins.Count} skins", LoggingTarget.Database);
+
+                        foreach (var skin in existingSkins)
                         {
-                            Name = skin.Name,
-                            Creator = skin.Creator,
-                            Hash = skin.Hash,
-                            Protected = false,
-                            InstantiationInfo = skin.InstantiationInfo,
-                        };
+                            var realmSkin = new SkinInfo
+                            {
+                                Name = skin.Name,
+                                Creator = skin.Creator,
+                                Hash = skin.Hash,
+                                Protected = false,
+                                InstantiationInfo = skin.InstantiationInfo,
+                            };
 
-                        migrateFiles(skin, realm, realmSkin);
+                            migrateFiles(skin, realm, realmSkin);
 
-                        realm.Add(realmSkin);
+                            realm.Add(realmSkin);
 
-                        if (skin.ID == userSkinInt)
-                            userSkinChoice.Value = realmSkin.ID.ToString();
+                            if (skin.ID == userSkinInt)
+                                userSkinChoice.Value = realmSkin.ID.ToString();
+                        }
                     }
-                }
 
-                transaction.Commit();
-            }
+                    transaction.Commit();
+                }
+            });
         }
 
         private static void migrateFiles<T>(IHasFiles<T> fileSource, Realm realm, IHasRealmFiles realmObject) where T : INamedFileInfo
@@ -365,36 +367,38 @@ namespace osu.Game.Database
             Logger.Log("Beginning settings migration to realm", LoggingTarget.Database);
             ensureBackup();
 
-            using (var realm = realmContextFactory.CreateContext())
-            using (var transaction = realm.BeginWrite())
+            realmContextFactory.Run(realm =>
             {
-                // only migrate data if the realm database is empty.
-                if (!realm.All<RealmRulesetSetting>().Any())
+                using (var transaction = realm.BeginWrite())
                 {
-                    Logger.Log($"Migrating {existingSettings.Count} settings", LoggingTarget.Database);
-
-                    foreach (var dkb in existingSettings)
+                    // only migrate data if the realm database is empty.
+                    if (!realm.All<RealmRulesetSetting>().Any())
                     {
-                        if (dkb.RulesetID == null)
-                            continue;
+                        Logger.Log($"Migrating {existingSettings.Count} settings", LoggingTarget.Database);
 
-                        string? shortName = getRulesetShortNameFromLegacyID(dkb.RulesetID.Value);
-
-                        if (string.IsNullOrEmpty(shortName))
-                            continue;
-
-                        realm.Add(new RealmRulesetSetting
+                        foreach (var dkb in existingSettings)
                         {
-                            Key = dkb.Key,
-                            Value = dkb.StringValue,
-                            RulesetName = shortName,
-                            Variant = dkb.Variant ?? 0,
-                        });
-                    }
-                }
+                            if (dkb.RulesetID == null)
+                                continue;
 
-                transaction.Commit();
-            }
+                            string? shortName = getRulesetShortNameFromLegacyID(dkb.RulesetID.Value);
+
+                            if (string.IsNullOrEmpty(shortName))
+                                continue;
+
+                            realm.Add(new RealmRulesetSetting
+                            {
+                                Key = dkb.Key,
+                                Value = dkb.StringValue,
+                                RulesetName = shortName,
+                                Variant = dkb.Variant ?? 0,
+                            });
+                        }
+                    }
+
+                    transaction.Commit();
+                }
+            });
         }
 
         private string? getRulesetShortNameFromLegacyID(long rulesetId) =>
diff --git a/osu.Game/Database/RealmLive.cs b/osu.Game/Database/RealmLive.cs
index 6594224666..05367160f3 100644
--- a/osu.Game/Database/RealmLive.cs
+++ b/osu.Game/Database/RealmLive.cs
@@ -51,8 +51,7 @@ namespace osu.Game.Database
                 return;
             }
 
-            using (var realm = realmFactory.CreateContext())
-                perform(realm.Find<T>(ID));
+            realmFactory.Run(realm => perform(realm.Find<T>(ID)));
         }
 
         /// <summary>
@@ -64,7 +63,7 @@ namespace osu.Game.Database
             if (!IsManaged)
                 return perform(data);
 
-            using (var realm = realmFactory.CreateContext())
+            return realmFactory.Run(realm =>
             {
                 var returnData = perform(realm.Find<T>(ID));
 
@@ -72,7 +71,7 @@ namespace osu.Game.Database
                     throw new InvalidOperationException(@$"Managed realm objects should not exit the scope of {nameof(PerformRead)}.");
 
                 return returnData;
-            }
+            });
         }
 
         /// <summary>
diff --git a/osu.Game/Input/RealmKeyBindingStore.cs b/osu.Game/Input/RealmKeyBindingStore.cs
index 99f5752cfb..60f7eb2198 100644
--- a/osu.Game/Input/RealmKeyBindingStore.cs
+++ b/osu.Game/Input/RealmKeyBindingStore.cs
@@ -34,7 +34,7 @@ namespace osu.Game.Input
         {
             List<string> combinations = new List<string>();
 
-            using (var context = realmFactory.CreateContext())
+            realmFactory.Run(context =>
             {
                 foreach (var action in context.All<RealmKeyBinding>().Where(b => string.IsNullOrEmpty(b.RulesetName) && (GlobalAction)b.ActionInt == globalAction))
                 {
@@ -44,7 +44,7 @@ namespace osu.Game.Input
                     if (str.Length > 0)
                         combinations.Add(str);
                 }
-            }
+            });
 
             return combinations;
         }
@@ -56,24 +56,26 @@ namespace osu.Game.Input
         /// <param name="rulesets">The rulesets to populate defaults from.</param>
         public void Register(KeyBindingContainer container, IEnumerable<RulesetInfo> rulesets)
         {
-            using (var realm = realmFactory.CreateContext())
-            using (var transaction = realm.BeginWrite())
+            realmFactory.Run(realm =>
             {
-                // intentionally flattened to a list rather than querying against the IQueryable, as nullable fields being queried against aren't indexed.
-                // this is much faster as a result.
-                var existingBindings = realm.All<RealmKeyBinding>().ToList();
-
-                insertDefaults(realm, existingBindings, container.DefaultKeyBindings);
-
-                foreach (var ruleset in rulesets)
+                using (var transaction = realm.BeginWrite())
                 {
-                    var instance = ruleset.CreateInstance();
-                    foreach (int variant in instance.AvailableVariants)
-                        insertDefaults(realm, existingBindings, instance.GetDefaultKeyBindings(variant), ruleset.ShortName, variant);
-                }
+                    // intentionally flattened to a list rather than querying against the IQueryable, as nullable fields being queried against aren't indexed.
+                    // this is much faster as a result.
+                    var existingBindings = realm.All<RealmKeyBinding>().ToList();
 
-                transaction.Commit();
-            }
+                    insertDefaults(realm, existingBindings, container.DefaultKeyBindings);
+
+                    foreach (var ruleset in rulesets)
+                    {
+                        var instance = ruleset.CreateInstance();
+                        foreach (int variant in instance.AvailableVariants)
+                            insertDefaults(realm, existingBindings, instance.GetDefaultKeyBindings(variant), ruleset.ShortName, variant);
+                    }
+
+                    transaction.Commit();
+                }
+            });
         }
 
         private void insertDefaults(Realm realm, List<RealmKeyBinding> existingBindings, IEnumerable<IKeyBinding> defaults, string? rulesetName = null, int? variant = null)
diff --git a/osu.Game/Overlays/Settings/Sections/Input/KeyBindingsSubsection.cs b/osu.Game/Overlays/Settings/Sections/Input/KeyBindingsSubsection.cs
index 94c7c66538..9075dfefd4 100644
--- a/osu.Game/Overlays/Settings/Sections/Input/KeyBindingsSubsection.cs
+++ b/osu.Game/Overlays/Settings/Sections/Input/KeyBindingsSubsection.cs
@@ -34,10 +34,9 @@ namespace osu.Game.Overlays.Settings.Sections.Input
         {
             string rulesetName = Ruleset?.ShortName;
 
-            List<RealmKeyBinding> bindings;
+            List<RealmKeyBinding> bindings = null;
 
-            using (var realm = realmFactory.CreateContext())
-                bindings = realm.All<RealmKeyBinding>().Where(b => b.RulesetName == rulesetName && b.Variant == variant).Detach();
+            realmFactory.Run(realm => bindings = realm.All<RealmKeyBinding>().Where(b => b.RulesetName == rulesetName && b.Variant == variant).Detach());
 
             foreach (var defaultGroup in Defaults.GroupBy(d => d.Action))
             {
diff --git a/osu.Game/Rulesets/Configuration/RulesetConfigManager.cs b/osu.Game/Rulesets/Configuration/RulesetConfigManager.cs
index 17678775e9..60a6b70221 100644
--- a/osu.Game/Rulesets/Configuration/RulesetConfigManager.cs
+++ b/osu.Game/Rulesets/Configuration/RulesetConfigManager.cs
@@ -56,21 +56,15 @@ namespace osu.Game.Rulesets.Configuration
                 pendingWrites.Clear();
             }
 
-            if (realmFactory == null)
-                return true;
-
-            using (var context = realmFactory.CreateContext())
+            realmFactory?.Write(realm =>
             {
-                context.Write(realm =>
+                foreach (var c in changed)
                 {
-                    foreach (var c in changed)
-                    {
-                        var setting = realm.All<RealmRulesetSetting>().First(s => s.RulesetName == rulesetName && s.Variant == variant && s.Key == c.ToString());
+                    var setting = realm.All<RealmRulesetSetting>().First(s => s.RulesetName == rulesetName && s.Variant == variant && s.Key == c.ToString());
 
-                        setting.Value = ConfigStore[c].ToString();
-                    }
-                });
-            }
+                    setting.Value = ConfigStore[c].ToString();
+                }
+            });
 
             return true;
         }
diff --git a/osu.Game/Rulesets/RulesetStore.cs b/osu.Game/Rulesets/RulesetStore.cs
index c675fbbf63..a9e5ff797c 100644
--- a/osu.Game/Rulesets/RulesetStore.cs
+++ b/osu.Game/Rulesets/RulesetStore.cs
@@ -100,74 +100,71 @@ namespace osu.Game.Rulesets
 
         private void addMissingRulesets()
         {
-            using (var context = realmFactory.CreateContext())
+            realmFactory.Write(realm =>
             {
-                context.Write(realm =>
+                var rulesets = realm.All<RulesetInfo>();
+
+                List<Ruleset> instances = loadedAssemblies.Values
+                                                          .Select(r => Activator.CreateInstance(r) as Ruleset)
+                                                          .Where(r => r != null)
+                                                          .Select(r => r.AsNonNull())
+                                                          .ToList();
+
+                // add all legacy rulesets first to ensure they have exclusive choice of primary key.
+                foreach (var r in instances.Where(r => r is ILegacyRuleset))
                 {
-                    var rulesets = realm.All<RulesetInfo>();
+                    if (realm.All<RulesetInfo>().FirstOrDefault(rr => rr.OnlineID == r.RulesetInfo.OnlineID) == null)
+                        realm.Add(new RulesetInfo(r.RulesetInfo.ShortName, r.RulesetInfo.Name, r.RulesetInfo.InstantiationInfo, r.RulesetInfo.OnlineID));
+                }
 
-                    List<Ruleset> instances = loadedAssemblies.Values
-                                                              .Select(r => Activator.CreateInstance(r) as Ruleset)
-                                                              .Where(r => r != null)
-                                                              .Select(r => r.AsNonNull())
-                                                              .ToList();
-
-                    // add all legacy rulesets first to ensure they have exclusive choice of primary key.
-                    foreach (var r in instances.Where(r => r is ILegacyRuleset))
+                // add any other rulesets which have assemblies present but are not yet in the database.
+                foreach (var r in instances.Where(r => !(r is ILegacyRuleset)))
+                {
+                    if (rulesets.FirstOrDefault(ri => ri.InstantiationInfo.Equals(r.RulesetInfo.InstantiationInfo, StringComparison.Ordinal)) == null)
                     {
-                        if (realm.All<RulesetInfo>().FirstOrDefault(rr => rr.OnlineID == r.RulesetInfo.OnlineID) == null)
+                        var existingSameShortName = rulesets.FirstOrDefault(ri => ri.ShortName == r.RulesetInfo.ShortName);
+
+                        if (existingSameShortName != null)
+                        {
+                            // even if a matching InstantiationInfo was not found, there may be an existing ruleset with the same ShortName.
+                            // this generally means the user or ruleset provider has renamed their dll but the underlying ruleset is *likely* the same one.
+                            // in such cases, update the instantiation info of the existing entry to point to the new one.
+                            existingSameShortName.InstantiationInfo = r.RulesetInfo.InstantiationInfo;
+                        }
+                        else
                             realm.Add(new RulesetInfo(r.RulesetInfo.ShortName, r.RulesetInfo.Name, r.RulesetInfo.InstantiationInfo, r.RulesetInfo.OnlineID));
                     }
+                }
 
-                    // add any other rulesets which have assemblies present but are not yet in the database.
-                    foreach (var r in instances.Where(r => !(r is ILegacyRuleset)))
+                List<RulesetInfo> detachedRulesets = new List<RulesetInfo>();
+
+                // perform a consistency check and detach final rulesets from realm for cross-thread runtime usage.
+                foreach (var r in rulesets.OrderBy(r => r.OnlineID))
+                {
+                    try
                     {
-                        if (rulesets.FirstOrDefault(ri => ri.InstantiationInfo.Equals(r.RulesetInfo.InstantiationInfo, StringComparison.Ordinal)) == null)
-                        {
-                            var existingSameShortName = rulesets.FirstOrDefault(ri => ri.ShortName == r.RulesetInfo.ShortName);
+                        var resolvedType = Type.GetType(r.InstantiationInfo)
+                                           ?? throw new RulesetLoadException(@"Type could not be resolved");
 
-                            if (existingSameShortName != null)
-                            {
-                                // even if a matching InstantiationInfo was not found, there may be an existing ruleset with the same ShortName.
-                                // this generally means the user or ruleset provider has renamed their dll but the underlying ruleset is *likely* the same one.
-                                // in such cases, update the instantiation info of the existing entry to point to the new one.
-                                existingSameShortName.InstantiationInfo = r.RulesetInfo.InstantiationInfo;
-                            }
-                            else
-                                realm.Add(new RulesetInfo(r.RulesetInfo.ShortName, r.RulesetInfo.Name, r.RulesetInfo.InstantiationInfo, r.RulesetInfo.OnlineID));
-                        }
+                        var instanceInfo = (Activator.CreateInstance(resolvedType) as Ruleset)?.RulesetInfo
+                                           ?? throw new RulesetLoadException(@"Instantiation failure");
+
+                        r.Name = instanceInfo.Name;
+                        r.ShortName = instanceInfo.ShortName;
+                        r.InstantiationInfo = instanceInfo.InstantiationInfo;
+                        r.Available = true;
+
+                        detachedRulesets.Add(r.Clone());
                     }
-
-                    List<RulesetInfo> detachedRulesets = new List<RulesetInfo>();
-
-                    // perform a consistency check and detach final rulesets from realm for cross-thread runtime usage.
-                    foreach (var r in rulesets.OrderBy(r => r.OnlineID))
+                    catch (Exception ex)
                     {
-                        try
-                        {
-                            var resolvedType = Type.GetType(r.InstantiationInfo)
-                                               ?? throw new RulesetLoadException(@"Type could not be resolved");
-
-                            var instanceInfo = (Activator.CreateInstance(resolvedType) as Ruleset)?.RulesetInfo
-                                               ?? throw new RulesetLoadException(@"Instantiation failure");
-
-                            r.Name = instanceInfo.Name;
-                            r.ShortName = instanceInfo.ShortName;
-                            r.InstantiationInfo = instanceInfo.InstantiationInfo;
-                            r.Available = true;
-
-                            detachedRulesets.Add(r.Clone());
-                        }
-                        catch (Exception ex)
-                        {
-                            r.Available = false;
-                            Logger.Log($"Could not load ruleset {r}: {ex.Message}");
-                        }
+                        r.Available = false;
+                        Logger.Log($"Could not load ruleset {r}: {ex.Message}");
                     }
+                }
 
-                    availableRulesets.AddRange(detachedRulesets);
-                });
-            }
+                availableRulesets.AddRange(detachedRulesets);
+            });
         }
 
         private void loadFromAppDomain()
diff --git a/osu.Game/Scoring/ScoreManager.cs b/osu.Game/Scoring/ScoreManager.cs
index ccf3226792..f895134f97 100644
--- a/osu.Game/Scoring/ScoreManager.cs
+++ b/osu.Game/Scoring/ScoreManager.cs
@@ -51,8 +51,7 @@ namespace osu.Game.Scoring
         /// <returns>The first result for the provided query, or null if no results were found.</returns>
         public ScoreInfo Query(Expression<Func<ScoreInfo, bool>> query)
         {
-            using (var context = contextFactory.CreateContext())
-                return context.All<ScoreInfo>().FirstOrDefault(query)?.Detach();
+            return contextFactory.Run(realm => realm.All<ScoreInfo>().FirstOrDefault(query)?.Detach());
         }
 
         /// <summary>
@@ -255,16 +254,16 @@ namespace osu.Game.Scoring
 
         public void Delete([CanBeNull] Expression<Func<ScoreInfo, bool>> filter = null, bool silent = false)
         {
-            using (var context = contextFactory.CreateContext())
+            contextFactory.Run(realm =>
             {
-                var items = context.All<ScoreInfo>()
-                                   .Where(s => !s.DeletePending);
+                var items = realm.All<ScoreInfo>()
+                                 .Where(s => !s.DeletePending);
 
                 if (filter != null)
                     items = items.Where(filter);
 
                 scoreModelManager.Delete(items.ToList(), silent);
-            }
+            });
         }
 
         public void Delete(List<ScoreInfo> items, bool silent = false)
diff --git a/osu.Game/Screens/Select/BeatmapCarousel.cs b/osu.Game/Screens/Select/BeatmapCarousel.cs
index 75ad0511e6..fe3d407a64 100644
--- a/osu.Game/Screens/Select/BeatmapCarousel.cs
+++ b/osu.Game/Screens/Select/BeatmapCarousel.cs
@@ -178,8 +178,7 @@ namespace osu.Game.Screens.Select
 
             if (!loadedTestBeatmaps)
             {
-                using (var realm = realmFactory.CreateContext())
-                    loadBeatmapSets(getBeatmapSets(realm));
+                realmFactory.Run(realm => loadBeatmapSets(getBeatmapSets(realm)));
             }
         }
 
diff --git a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
index 49f2ea5d64..da52b43ab6 100644
--- a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
+++ b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
@@ -147,7 +147,7 @@ namespace osu.Game.Screens.Select.Leaderboards
 
             if (Scope == BeatmapLeaderboardScope.Local)
             {
-                using (var realm = realmFactory.CreateContext())
+                realmFactory.Run(realm =>
                 {
                     var scores = realm.All<ScoreInfo>()
                                       .AsEnumerable()
@@ -171,9 +171,9 @@ namespace osu.Game.Screens.Select.Leaderboards
 
                     scoreManager.OrderByTotalScoreAsync(scores.ToArray(), cancellationToken)
                                 .ContinueWith(ordered => scoresCallback?.Invoke(ordered.GetResultSafely()), TaskContinuationOptions.OnlyOnRanToCompletion);
+                });
 
-                    return null;
-                }
+                return null;
             }
 
             if (api?.IsLoggedIn != true)
diff --git a/osu.Game/Skinning/SkinManager.cs b/osu.Game/Skinning/SkinManager.cs
index 3f6e5754fb..82bcd3b292 100644
--- a/osu.Game/Skinning/SkinManager.cs
+++ b/osu.Game/Skinning/SkinManager.cs
@@ -87,17 +87,14 @@ namespace osu.Game.Skinning
             };
 
             // Ensure the default entries are present.
-            using (var context = contextFactory.CreateContext())
-            using (var transaction = context.BeginWrite())
+            contextFactory.Write(realm =>
             {
                 foreach (var skin in defaultSkins)
                 {
-                    if (context.Find<SkinInfo>(skin.SkinInfo.ID) == null)
-                        context.Add(skin.SkinInfo.Value);
+                    if (realm.Find<SkinInfo>(skin.SkinInfo.ID) == null)
+                        realm.Add(skin.SkinInfo.Value);
                 }
-
-                transaction.Commit();
-            }
+            });
 
             CurrentSkinInfo.ValueChanged += skin => CurrentSkin.Value = skin.NewValue.PerformRead(GetSkin);
 
@@ -292,10 +289,10 @@ namespace osu.Game.Skinning
 
         public void Delete([CanBeNull] Expression<Func<SkinInfo, bool>> filter = null, bool silent = false)
         {
-            using (var context = contextFactory.CreateContext())
+            contextFactory.Run(realm =>
             {
-                var items = context.All<SkinInfo>()
-                                   .Where(s => !s.Protected && !s.DeletePending);
+                var items = realm.All<SkinInfo>()
+                                 .Where(s => !s.Protected && !s.DeletePending);
                 if (filter != null)
                     items = items.Where(filter);
 
@@ -306,7 +303,7 @@ namespace osu.Game.Skinning
                     scheduler.Add(() => CurrentSkinInfo.Value = Skinning.DefaultSkin.CreateInfo().ToLiveUnmanaged());
 
                 skinModelManager.Delete(items.ToList(), silent);
-            }
+            });
         }
 
         #endregion
diff --git a/osu.Game/Skinning/SkinModelManager.cs b/osu.Game/Skinning/SkinModelManager.cs
index b8313f63a3..a1926913a9 100644
--- a/osu.Game/Skinning/SkinModelManager.cs
+++ b/osu.Game/Skinning/SkinModelManager.cs
@@ -205,7 +205,7 @@ namespace osu.Game.Skinning
 
         private void populateMissingHashes()
         {
-            using (var realm = ContextFactory.CreateContext())
+            ContextFactory.Run(realm =>
             {
                 var skinsWithoutHashes = realm.All<SkinInfo>().Where(i => !i.Protected && string.IsNullOrEmpty(i.Hash)).ToArray();
 
@@ -221,7 +221,7 @@ namespace osu.Game.Skinning
                         Logger.Error(e, $"Existing skin {skin} has been deleted during hash recomputation due to being invalid");
                     }
                 }
-            }
+            });
         }
 
         private Skin createInstance(SkinInfo item) => item.CreateInstance(skinResources);
diff --git a/osu.Game/Stores/RealmArchiveModelImporter.cs b/osu.Game/Stores/RealmArchiveModelImporter.cs
index 2ea7aecc94..3d8e9f2703 100644
--- a/osu.Game/Stores/RealmArchiveModelImporter.cs
+++ b/osu.Game/Stores/RealmArchiveModelImporter.cs
@@ -320,7 +320,7 @@ namespace osu.Game.Stores
         /// <param name="cancellationToken">An optional cancellation token.</param>
         public virtual Task<ILive<TModel>?> Import(TModel item, ArchiveReader? archive = null, bool lowPriority = false, CancellationToken cancellationToken = default)
         {
-            using (var realm = ContextFactory.CreateContext())
+            return ContextFactory.Run(realm =>
             {
                 cancellationToken.ThrowIfCancellationRequested();
 
@@ -414,7 +414,7 @@ namespace osu.Game.Stores
                 }
 
                 return Task.FromResult((ILive<TModel>?)item.ToLive(ContextFactory));
-            }
+            });
         }
 
         private string computeHashFast(ArchiveReader reader)
diff --git a/osu.Game/Stores/RealmFileStore.cs b/osu.Game/Stores/RealmFileStore.cs
index f9abbda4c0..ca371e29be 100644
--- a/osu.Game/Stores/RealmFileStore.cs
+++ b/osu.Game/Stores/RealmFileStore.cs
@@ -92,8 +92,7 @@ namespace osu.Game.Stores
             int removedFiles = 0;
 
             // can potentially be run asynchronously, although we will need to consider operation order for disk deletion vs realm removal.
-            using (var realm = realmFactory.CreateContext())
-            using (var transaction = realm.BeginWrite())
+            realmFactory.Write(realm =>
             {
                 // TODO: consider using a realm native query to avoid iterating all files (https://github.com/realm/realm-dotnet/issues/2659#issuecomment-927823707)
                 var files = realm.All<RealmFile>().ToList();
@@ -116,9 +115,7 @@ namespace osu.Game.Stores
                         Logger.Error(e, $@"Could not delete databased file {file.Hash}");
                     }
                 }
-
-                transaction.Commit();
-            }
+            });
 
             Logger.Log($@"Finished realm file store cleanup ({removedFiles} of {totalFiles} deleted)");
         }

From d2655c082546033490792d6f3e4d1806ba964e8c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 21 Jan 2022 17:27:30 +0900
Subject: [PATCH 2376/5547] Fix `RealmLive` not necessarily being in refreshed
 state due to potentially using update context

---
 osu.Game/Database/RealmLive.cs | 16 +++++++++++++++-
 1 file changed, 15 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Database/RealmLive.cs b/osu.Game/Database/RealmLive.cs
index 05367160f3..75d84d7cf1 100644
--- a/osu.Game/Database/RealmLive.cs
+++ b/osu.Game/Database/RealmLive.cs
@@ -51,7 +51,21 @@ namespace osu.Game.Database
                 return;
             }
 
-            realmFactory.Run(realm => perform(realm.Find<T>(ID)));
+            realmFactory.Run(realm =>
+            {
+                var found = realm.Find<T>(ID);
+
+                if (found == null)
+                {
+                    // It may be that we access this from the update thread before a refresh has taken place.
+                    // To ensure that behaviour matches what we'd expect (the object *is* available), force
+                    // a refresh to bring in any off-thread changes immediately.
+                    realm.Refresh();
+                    found = realm.Find<T>(ID);
+                }
+
+                perform(found);
+            });
         }
 
         /// <summary>

From 81b5717ae793e334fdcf8efd72d20debfb49e9ca Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 21 Jan 2022 17:33:03 +0900
Subject: [PATCH 2377/5547] Fix `RealmLive` failing to retrieve due to lack of
 refresh

---
 osu.Game/Database/RealmLive.cs | 31 ++++++++++++++++++-------------
 1 file changed, 18 insertions(+), 13 deletions(-)

diff --git a/osu.Game/Database/RealmLive.cs b/osu.Game/Database/RealmLive.cs
index 75d84d7cf1..df5e165f8e 100644
--- a/osu.Game/Database/RealmLive.cs
+++ b/osu.Game/Database/RealmLive.cs
@@ -53,18 +53,7 @@ namespace osu.Game.Database
 
             realmFactory.Run(realm =>
             {
-                var found = realm.Find<T>(ID);
-
-                if (found == null)
-                {
-                    // It may be that we access this from the update thread before a refresh has taken place.
-                    // To ensure that behaviour matches what we'd expect (the object *is* available), force
-                    // a refresh to bring in any off-thread changes immediately.
-                    realm.Refresh();
-                    found = realm.Find<T>(ID);
-                }
-
-                perform(found);
+                perform(retrieveFromID(realm, ID));
             });
         }
 
@@ -79,7 +68,7 @@ namespace osu.Game.Database
 
             return realmFactory.Run(realm =>
             {
-                var returnData = perform(realm.Find<T>(ID));
+                var returnData = perform(retrieveFromID(realm, ID));
 
                 if (returnData is RealmObjectBase realmObject && realmObject.IsManaged)
                     throw new InvalidOperationException(@$"Managed realm objects should not exit the scope of {nameof(PerformRead)}.");
@@ -119,6 +108,22 @@ namespace osu.Game.Database
             }
         }
 
+        private T retrieveFromID(Realm realm, Guid id)
+        {
+            var found = realm.Find<T>(ID);
+
+            if (found == null)
+            {
+                // It may be that we access this from the update thread before a refresh has taken place.
+                // To ensure that behaviour matches what we'd expect (the object *is* available), force
+                // a refresh to bring in any off-thread changes immediately.
+                realm.Refresh();
+                found = realm.Find<T>(ID);
+            }
+
+            return found;
+        }
+
         public bool Equals(ILive<T>? other) => ID == other?.ID;
 
         public override string ToString() => PerformRead(i => i.ToString());

From 495636538fc23101ec641bdf66eb0ba8b3f6a88c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 21 Jan 2022 17:33:26 +0900
Subject: [PATCH 2378/5547] Add forced refresh on `GetAllUsableBeatmapSets()`

This is commonly used in tests in a way where it's not feasible to
guarantee correct results unless a refresh is called. This method
shouldn't really be used outside of tests anyway, but that's for a
folow-up effort.
---
 osu.Game/Beatmaps/BeatmapManager.cs | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index a9340e1250..43e4b482bd 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -171,7 +171,11 @@ namespace osu.Game.Beatmaps
         /// <returns>A list of available <see cref="BeatmapSetInfo"/>.</returns>
         public List<BeatmapSetInfo> GetAllUsableBeatmapSets()
         {
-            return contextFactory.Run(realm => realm.All<BeatmapSetInfo>().Where(b => !b.DeletePending).Detach());
+            return contextFactory.Run(realm =>
+            {
+                realm.Refresh();
+                return realm.All<BeatmapSetInfo>().Where(b => !b.DeletePending).Detach();
+            });
         }
 
         /// <summary>

From 2006620a2c02d60c83792803b4276cb163a3b4a9 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 21 Jan 2022 17:55:27 +0900
Subject: [PATCH 2379/5547] Fix `IntroScreen` retrieving and iterating all
 realm beatmap sets

---
 osu.Game/Screens/Menu/IntroScreen.cs | 82 ++++++++++++++--------------
 1 file changed, 41 insertions(+), 41 deletions(-)

diff --git a/osu.Game/Screens/Menu/IntroScreen.cs b/osu.Game/Screens/Menu/IntroScreen.cs
index d98cb8056f..db9d9b83c4 100644
--- a/osu.Game/Screens/Menu/IntroScreen.cs
+++ b/osu.Game/Screens/Menu/IntroScreen.cs
@@ -21,6 +21,7 @@ using osu.Game.Overlays;
 using osu.Game.Screens.Backgrounds;
 using osuTK;
 using osuTK.Graphics;
+using Realms;
 
 namespace osu.Game.Screens.Menu
 {
@@ -93,58 +94,57 @@ namespace osu.Game.Screens.Menu
             MenuMusic = config.GetBindable<bool>(OsuSetting.MenuMusic);
             seeya = audio.Samples.Get(SeeyaSampleName);
 
-            ILive<BeatmapSetInfo> setInfo = null;
-
             // if the user has requested not to play theme music, we should attempt to find a random beatmap from their collection.
             if (!MenuMusic.Value)
             {
-                var sets = beatmaps.GetAllUsableBeatmapSets();
-
-                if (sets.Count > 0)
+                realmContextFactory.Run(realm =>
                 {
-                    setInfo = beatmaps.QueryBeatmapSet(s => s.ID == sets[RNG.Next(0, sets.Count - 1)].ID);
-                    setInfo?.PerformRead(s =>
+                    var sets = realm.All<BeatmapSetInfo>().Where(s => !s.DeletePending && !s.Protected).AsRealmCollection();
+
+                    int setCount = sets.Count;
+
+                    if (sets.Any())
+                    {
+                        var found = sets[RNG.Next(0, setCount - 1)].Beatmaps.FirstOrDefault();
+
+                        if (found != null)
+                            initialBeatmap = beatmaps.GetWorkingBeatmap(found);
+                    }
+                });
+
+                // we generally want a song to be playing on startup, so use the intro music even if a user has specified not to if no other track is available.
+                if (initialBeatmap == null)
+                {
+                    if (!loadThemedIntro())
+                    {
+                        // if we detect that the theme track or beatmap is unavailable this is either first startup or things are in a bad state.
+                        // this could happen if a user has nuked their files store. for now, reimport to repair this.
+                        var import = beatmaps.Import(new ZipArchiveReader(game.Resources.GetStream($"Tracks/{BeatmapFile}"), BeatmapFile)).GetResultSafely();
+
+                        import?.PerformWrite(b => b.Protected = true);
+
+                        loadThemedIntro();
+                    }
+                }
+
+                bool loadThemedIntro()
+                {
+                    var setInfo = beatmaps.QueryBeatmapSet(b => b.Hash == BeatmapHash);
+
+                    if (setInfo == null)
+                        return false;
+
+                    setInfo.PerformRead(s =>
                     {
                         if (s.Beatmaps.Count == 0)
                             return;
 
-                        initialBeatmap = beatmaps.GetWorkingBeatmap(s.Beatmaps[0]);
+                        initialBeatmap = beatmaps.GetWorkingBeatmap(s.Beatmaps.First());
                     });
+
+                    return UsingThemedIntro = initialBeatmap != null;
                 }
             }
-
-            // we generally want a song to be playing on startup, so use the intro music even if a user has specified not to if no other track is available.
-            if (setInfo == null)
-            {
-                if (!loadThemedIntro())
-                {
-                    // if we detect that the theme track or beatmap is unavailable this is either first startup or things are in a bad state.
-                    // this could happen if a user has nuked their files store. for now, reimport to repair this.
-                    var import = beatmaps.Import(new ZipArchiveReader(game.Resources.GetStream($"Tracks/{BeatmapFile}"), BeatmapFile)).GetResultSafely();
-
-                    import?.PerformWrite(b => b.Protected = true);
-
-                    loadThemedIntro();
-                }
-            }
-
-            bool loadThemedIntro()
-            {
-                setInfo = beatmaps.QueryBeatmapSet(b => b.Hash == BeatmapHash);
-
-                if (setInfo == null)
-                    return false;
-
-                setInfo.PerformRead(s =>
-                {
-                    if (s.Beatmaps.Count == 0)
-                        return;
-
-                    initialBeatmap = beatmaps.GetWorkingBeatmap(s.Beatmaps.First());
-                });
-
-                return UsingThemedIntro = initialBeatmap != null;
-            }
         }
 
         public override void OnResuming(IScreen last)

From 18bf690a30bc9d5c5c6d53133469fc462bcf62ec Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 21 Jan 2022 18:13:21 +0900
Subject: [PATCH 2380/5547] Add `Register` method for subscription purposes and
 update safeties

---
 osu.Game/Database/RealmContextFactory.cs   | 28 ++++++++++++++++++++++
 osu.Game/Database/RealmObjectExtensions.cs |  6 ++---
 2 files changed, 30 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Database/RealmContextFactory.cs b/osu.Game/Database/RealmContextFactory.cs
index 888ffb1dd5..169333bff8 100644
--- a/osu.Game/Database/RealmContextFactory.cs
+++ b/osu.Game/Database/RealmContextFactory.cs
@@ -88,6 +88,10 @@ namespace osu.Game.Database
             }
         }
 
+        internal static bool CurrentThreadSubscriptionsAllowed => current_thread_subscriptions_allowed.Value;
+
+        private static readonly ThreadLocal<bool> current_thread_subscriptions_allowed = new ThreadLocal<bool>();
+
         /// <summary>
         /// Construct a new instance of a realm context factory.
         /// </summary>
@@ -222,6 +226,30 @@ namespace osu.Game.Database
             }
         }
 
+        /// <summary>
+        /// Run work on realm that will be run every time the update thread realm context gets recycled.
+        /// </summary>
+        /// <param name="action">The work to run.</param>
+        public void Register(Action<Realm> action)
+        {
+            if (!ThreadSafety.IsUpdateThread && context != null)
+                throw new InvalidOperationException(@$"{nameof(BlockAllOperations)} must be called from the update thread.");
+
+            if (ThreadSafety.IsUpdateThread)
+            {
+                current_thread_subscriptions_allowed.Value = true;
+                action(Context);
+                current_thread_subscriptions_allowed.Value = false;
+            }
+            else
+            {
+                current_thread_subscriptions_allowed.Value = true;
+                using (var realm = createContext())
+                    action(realm);
+                current_thread_subscriptions_allowed.Value = false;
+            }
+        }
+
         private Realm createContext()
         {
             if (isDisposed)
diff --git a/osu.Game/Database/RealmObjectExtensions.cs b/osu.Game/Database/RealmObjectExtensions.cs
index c25aeab336..c30e1699b9 100644
--- a/osu.Game/Database/RealmObjectExtensions.cs
+++ b/osu.Game/Database/RealmObjectExtensions.cs
@@ -7,7 +7,6 @@ using System.Linq;
 using System.Runtime.Serialization;
 using AutoMapper;
 using AutoMapper.Internal;
-using osu.Framework.Development;
 using osu.Game.Beatmaps;
 using osu.Game.Input.Bindings;
 using osu.Game.Models;
@@ -272,9 +271,8 @@ namespace osu.Game.Database
         public static IDisposable? QueryAsyncWithNotifications<T>(this IRealmCollection<T> collection, NotificationCallbackDelegate<T> callback)
             where T : RealmObjectBase
         {
-            // Subscriptions can only work on the main thread.
-            if (!ThreadSafety.IsUpdateThread)
-                throw new InvalidOperationException("Cannot subscribe for realm notifications from a non-update thread.");
+            if (!RealmContextFactory.CurrentThreadSubscriptionsAllowed)
+                throw new InvalidOperationException($"Make sure to call {nameof(RealmContextFactory)}.{nameof(RealmContextFactory.Register)}");
 
             return collection.SubscribeForNotifications(callback);
         }

From 45aea9add5209953d7e76a093a74f5ad91732a60 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 21 Jan 2022 18:50:25 +0900
Subject: [PATCH 2381/5547] Implement full subscription flow

---
 osu.Game/Database/RealmContextFactory.cs | 46 +++++++++++++++++-------
 1 file changed, 34 insertions(+), 12 deletions(-)

diff --git a/osu.Game/Database/RealmContextFactory.cs b/osu.Game/Database/RealmContextFactory.cs
index 169333bff8..62717eb880 100644
--- a/osu.Game/Database/RealmContextFactory.cs
+++ b/osu.Game/Database/RealmContextFactory.cs
@@ -2,6 +2,8 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
+using System.Collections.Generic;
+using System.Diagnostics;
 using System.IO;
 using System.Linq;
 using System.Reflection;
@@ -80,6 +82,10 @@ namespace osu.Game.Database
                     {
                         context = createContext();
                         Logger.Log(@$"Opened realm ""{context.Config.DatabasePath}"" at version {context.Config.SchemaVersion}");
+
+                        // Resubscribe any subscriptions
+                        foreach (var action in subscriptionActions.Keys)
+                            registerSubscription(action);
                     }
 
                     // creating a context will ensure our schema is up-to-date and migrated.
@@ -226,26 +232,42 @@ namespace osu.Game.Database
             }
         }
 
+        private readonly Dictionary<Func<Realm, IDisposable?>, IDisposable?> subscriptionActions = new Dictionary<Func<Realm, IDisposable?>, IDisposable?>();
+
         /// <summary>
         /// Run work on realm that will be run every time the update thread realm context gets recycled.
         /// </summary>
-        /// <param name="action">The work to run.</param>
-        public void Register(Action<Realm> action)
+        /// <param name="action">The work to run. Return value should be an <see cref="IDisposable"/> from QueryAsyncWithNotifications, or an <see cref="InvokeOnDisposal"/> to clean up any bindings.</param>
+        /// <returns>An <see cref="IDisposable"/> which should be disposed to unsubscribe any inner subscription.</returns>
+        public IDisposable Register(Func<Realm, IDisposable?> action)
         {
-            if (!ThreadSafety.IsUpdateThread && context != null)
-                throw new InvalidOperationException(@$"{nameof(BlockAllOperations)} must be called from the update thread.");
+            if (!ThreadSafety.IsUpdateThread)
+                throw new InvalidOperationException(@$"{nameof(Register)} must be called from the update thread.");
 
-            if (ThreadSafety.IsUpdateThread)
+            subscriptionActions.Add(action, null);
+            registerSubscription(action);
+
+            return new InvokeOnDisposal(() =>
             {
-                current_thread_subscriptions_allowed.Value = true;
-                action(Context);
-                current_thread_subscriptions_allowed.Value = false;
-            }
-            else
+                // TODO: this likely needs to be run on the update thread.
+                if (subscriptionActions.TryGetValue(action, out var unsubscriptionAction))
+                {
+                    unsubscriptionAction?.Dispose();
+                    subscriptionActions.Remove(action);
+                }
+            });
+        }
+
+        private void registerSubscription(Func<Realm, IDisposable?> action)
+        {
+            Debug.Assert(ThreadSafety.IsUpdateThread);
+
+            lock (contextLock)
             {
+                Debug.Assert(context != null);
+
                 current_thread_subscriptions_allowed.Value = true;
-                using (var realm = createContext())
-                    action(realm);
+                subscriptionActions[action] = action(context);
                 current_thread_subscriptions_allowed.Value = false;
             }
         }

From 1f157d729dbc0d1bc2cdbed374b41bbef650e121 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 21 Jan 2022 19:39:49 +0900
Subject: [PATCH 2382/5547] Update existing subscriptions to new style

Fix missing detach calls in `MusicController`
---
 osu.Game.Tests/Database/GeneralUsageTests.cs  |  3 ++-
 osu.Game.Tests/Database/RealmLiveTests.cs     |  4 ++-
 osu.Game/Database/RealmContextFactory.cs      |  5 +---
 .../Bindings/DatabasedKeyBindingContainer.cs  | 26 +++++++++---------
 osu.Game/Online/BeatmapDownloadTracker.cs     |  4 +--
 .../OnlinePlayBeatmapAvailabilityTracker.cs   |  4 +--
 osu.Game/Online/ScoreDownloadTracker.cs       |  4 +--
 osu.Game/Overlays/MusicController.cs          | 17 +++++++-----
 .../Sections/DebugSettings/MemorySettings.cs  |  4 +++
 .../Overlays/Settings/Sections/SkinSection.cs | 22 +++++++--------
 osu.Game/Screens/Select/BeatmapCarousel.cs    | 17 ++++++------
 .../Screens/Select/Carousel/TopLocalRank.cs   | 25 ++++++++---------
 .../Select/Leaderboards/BeatmapLeaderboard.cs | 27 ++++++++++---------
 osu.Game/Screens/Spectate/SpectatorScreen.cs  | 20 +++++++-------
 14 files changed, 98 insertions(+), 84 deletions(-)

diff --git a/osu.Game.Tests/Database/GeneralUsageTests.cs b/osu.Game.Tests/Database/GeneralUsageTests.cs
index 9ebe94b383..c82c1b6e59 100644
--- a/osu.Game.Tests/Database/GeneralUsageTests.cs
+++ b/osu.Game.Tests/Database/GeneralUsageTests.cs
@@ -46,7 +46,7 @@ namespace osu.Game.Tests.Database
             {
                 bool callbackRan = false;
 
-                realmFactory.Run(realm =>
+                realmFactory.Register(realm =>
                 {
                     var subscription = realm.All<BeatmapInfo>().QueryAsyncWithNotifications((sender, changes, error) =>
                     {
@@ -60,6 +60,7 @@ namespace osu.Game.Tests.Database
                     realmFactory.Run(r => r.Refresh());
 
                     subscription?.Dispose();
+                    return null;
                 });
 
                 Assert.IsTrue(callbackRan);
diff --git a/osu.Game.Tests/Database/RealmLiveTests.cs b/osu.Game.Tests/Database/RealmLiveTests.cs
index 2f16df4624..5549c140f6 100644
--- a/osu.Game.Tests/Database/RealmLiveTests.cs
+++ b/osu.Game.Tests/Database/RealmLiveTests.cs
@@ -234,7 +234,7 @@ namespace osu.Game.Tests.Database
             {
                 int changesTriggered = 0;
 
-                realmFactory.Run(outerRealm =>
+                realmFactory.Register(outerRealm =>
                 {
                     outerRealm.All<BeatmapInfo>().QueryAsyncWithNotifications(gotChange);
                     ILive<BeatmapInfo>? liveBeatmap = null;
@@ -277,6 +277,8 @@ namespace osu.Game.Tests.Database
                             r.Remove(resolved);
                         });
                     });
+
+                    return null;
                 });
 
                 void gotChange(IRealmCollection<BeatmapInfo> sender, ChangeSet changes, Exception error)
diff --git a/osu.Game/Database/RealmContextFactory.cs b/osu.Game/Database/RealmContextFactory.cs
index 62717eb880..c11ff61039 100644
--- a/osu.Game/Database/RealmContextFactory.cs
+++ b/osu.Game/Database/RealmContextFactory.cs
@@ -244,7 +244,6 @@ namespace osu.Game.Database
             if (!ThreadSafety.IsUpdateThread)
                 throw new InvalidOperationException(@$"{nameof(Register)} must be called from the update thread.");
 
-            subscriptionActions.Add(action, null);
             registerSubscription(action);
 
             return new InvokeOnDisposal(() =>
@@ -264,10 +263,8 @@ namespace osu.Game.Database
 
             lock (contextLock)
             {
-                Debug.Assert(context != null);
-
                 current_thread_subscriptions_allowed.Value = true;
-                subscriptionActions[action] = action(context);
+                subscriptionActions[action] = action(Context);
                 current_thread_subscriptions_allowed.Value = false;
             }
         }
diff --git a/osu.Game/Input/Bindings/DatabasedKeyBindingContainer.cs b/osu.Game/Input/Bindings/DatabasedKeyBindingContainer.cs
index 03b069d431..5a9797ffce 100644
--- a/osu.Game/Input/Bindings/DatabasedKeyBindingContainer.cs
+++ b/osu.Game/Input/Bindings/DatabasedKeyBindingContainer.cs
@@ -23,7 +23,6 @@ namespace osu.Game.Input.Bindings
         private readonly int? variant;
 
         private IDisposable realmSubscription;
-        private IQueryable<RealmKeyBinding> realmKeyBindings;
 
         [Resolved]
         private RealmContextFactory realmFactory { get; set; }
@@ -47,22 +46,25 @@ namespace osu.Game.Input.Bindings
                 throw new InvalidOperationException($"{nameof(variant)} can not be null when a non-null {nameof(ruleset)} is provided.");
         }
 
+        private IQueryable<RealmKeyBinding> realmKeyBindings
+        {
+            get
+            {
+                string rulesetName = ruleset?.ShortName;
+                return realmFactory.Context.All<RealmKeyBinding>()
+                                   .Where(b => b.RulesetName == rulesetName && b.Variant == variant);
+            }
+        }
+
         protected override void LoadComplete()
         {
-            string rulesetName = ruleset?.ShortName;
-
-            realmKeyBindings = realmFactory.Context.All<RealmKeyBinding>()
-                                           .Where(b => b.RulesetName == rulesetName && b.Variant == variant);
-
-            realmSubscription = realmKeyBindings
+            realmSubscription = realmFactory.Register(realm => realmKeyBindings
                 .QueryAsyncWithNotifications((sender, changes, error) =>
                 {
-                    // first subscription ignored as we are handling this in LoadComplete.
-                    if (changes == null)
-                        return;
-
+                    // The first fire of this is a bit redundant as this is being called in base.LoadComplete,
+                    // but this is safest in case the subscription is restored after a context recycle.
                     ReloadMappings();
-                });
+                }));
 
             base.LoadComplete();
         }
diff --git a/osu.Game/Online/BeatmapDownloadTracker.cs b/osu.Game/Online/BeatmapDownloadTracker.cs
index be5bdea6f1..d50ab5a347 100644
--- a/osu.Game/Online/BeatmapDownloadTracker.cs
+++ b/osu.Game/Online/BeatmapDownloadTracker.cs
@@ -42,7 +42,7 @@ namespace osu.Game.Online
             // Used to interact with manager classes that don't support interface types. Will eventually be replaced.
             var beatmapSetInfo = new BeatmapSetInfo { OnlineID = TrackedItem.OnlineID };
 
-            realmSubscription = realmContextFactory.Context.All<BeatmapSetInfo>().Where(s => s.OnlineID == TrackedItem.OnlineID && !s.DeletePending).QueryAsyncWithNotifications((items, changes, ___) =>
+            realmSubscription = realmContextFactory.Register(realm => realm.All<BeatmapSetInfo>().Where(s => s.OnlineID == TrackedItem.OnlineID && !s.DeletePending).QueryAsyncWithNotifications((items, changes, ___) =>
             {
                 if (items.Any())
                     Schedule(() => UpdateState(DownloadState.LocallyAvailable));
@@ -54,7 +54,7 @@ namespace osu.Game.Online
                         attachDownload(Downloader.GetExistingDownload(beatmapSetInfo));
                     });
                 }
-            });
+            }));
         }
 
         private void downloadBegan(ArchiveDownloadRequest<IBeatmapSetInfo> request) => Schedule(() =>
diff --git a/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs b/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs
index 1f77b1d383..fdcf2b39c6 100644
--- a/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs
+++ b/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs
@@ -78,13 +78,13 @@ namespace osu.Game.Online.Rooms
 
                 // handles changes to hash that didn't occur from the import process (ie. a user editing the beatmap in the editor, somehow).
                 realmSubscription?.Dispose();
-                realmSubscription = filteredBeatmaps().QueryAsyncWithNotifications((items, changes, ___) =>
+                realmSubscription = realmContextFactory.Register(realm => filteredBeatmaps().QueryAsyncWithNotifications((items, changes, ___) =>
                 {
                     if (changes == null)
                         return;
 
                     Scheduler.AddOnce(updateAvailability);
-                });
+                }));
             }, true);
         }
 
diff --git a/osu.Game/Online/ScoreDownloadTracker.cs b/osu.Game/Online/ScoreDownloadTracker.cs
index b34586567d..de1d6fd94a 100644
--- a/osu.Game/Online/ScoreDownloadTracker.cs
+++ b/osu.Game/Online/ScoreDownloadTracker.cs
@@ -47,7 +47,7 @@ namespace osu.Game.Online
             Downloader.DownloadBegan += downloadBegan;
             Downloader.DownloadFailed += downloadFailed;
 
-            realmSubscription = realmContextFactory.Context.All<ScoreInfo>().Where(s => ((s.OnlineID > 0 && s.OnlineID == TrackedItem.OnlineID) || s.Hash == TrackedItem.Hash) && !s.DeletePending).QueryAsyncWithNotifications((items, changes, ___) =>
+            realmSubscription = realmContextFactory.Register(realm => realm.All<ScoreInfo>().Where(s => ((s.OnlineID > 0 && s.OnlineID == TrackedItem.OnlineID) || s.Hash == TrackedItem.Hash) && !s.DeletePending).QueryAsyncWithNotifications((items, changes, ___) =>
             {
                 if (items.Any())
                     Schedule(() => UpdateState(DownloadState.LocallyAvailable));
@@ -59,7 +59,7 @@ namespace osu.Game.Online
                         attachDownload(Downloader.GetExistingDownload(scoreInfo));
                     });
                 }
-            });
+            }));
         }
 
         private void downloadBegan(ArchiveDownloadRequest<IScoreInfo> request) => Schedule(() =>
diff --git a/osu.Game/Overlays/MusicController.cs b/osu.Game/Overlays/MusicController.cs
index 70f8332295..01a2c9d354 100644
--- a/osu.Game/Overlays/MusicController.cs
+++ b/osu.Game/Overlays/MusicController.cs
@@ -80,26 +80,31 @@ namespace osu.Game.Overlays
             mods.BindValueChanged(_ => ResetTrackAdjustments(), true);
         }
 
+        private IQueryable<BeatmapSetInfo> availableBeatmaps => realmFactory.Context
+                                                                            .All<BeatmapSetInfo>()
+                                                                            .Where(s => !s.DeletePending);
+
         protected override void LoadComplete()
         {
             base.LoadComplete();
 
-            var availableBeatmaps = realmFactory.Context
-                                                .All<BeatmapSetInfo>()
-                                                .Where(s => !s.DeletePending);
-
             // ensure we're ready before completing async load.
             // probably not a good way of handling this (as there is a period we aren't watching for changes until the realm subscription finishes up.
             foreach (var s in availableBeatmaps)
-                beatmapSets.Add(s);
+                beatmapSets.Add(s.Detach());
 
-            beatmapSubscription = availableBeatmaps.QueryAsyncWithNotifications(beatmapsChanged);
+            beatmapSubscription = realmFactory.Register(realm => availableBeatmaps.QueryAsyncWithNotifications(beatmapsChanged));
         }
 
         private void beatmapsChanged(IRealmCollection<BeatmapSetInfo> sender, ChangeSet changes, Exception error)
         {
             if (changes == null)
+            {
+                beatmapSets.Clear();
+                foreach (var s in sender)
+                    beatmapSets.Add(s.Detach());
                 return;
+            }
 
             foreach (int i in changes.InsertedIndices)
                 beatmapSets.Insert(i, sender[i].Detach());
diff --git a/osu.Game/Overlays/Settings/Sections/DebugSettings/MemorySettings.cs b/osu.Game/Overlays/Settings/Sections/DebugSettings/MemorySettings.cs
index 8d4fc5fc9f..84a54b208c 100644
--- a/osu.Game/Overlays/Settings/Sections/DebugSettings/MemorySettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/DebugSettings/MemorySettings.cs
@@ -33,6 +33,10 @@ namespace osu.Game.Overlays.Settings.Sections.DebugSettings
                         using (realmFactory.BlockAllOperations())
                         {
                         }
+
+                        // retrieve context to revive realm subscriptions.
+                        // TODO: should we do this from OsuGame or RealmContextFactory or something? Answer: yes.
+                        var _ = realmFactory.Context;
                     }
                 },
             };
diff --git a/osu.Game/Overlays/Settings/Sections/SkinSection.cs b/osu.Game/Overlays/Settings/Sections/SkinSection.cs
index 0fa6d78d4b..11a7275168 100644
--- a/osu.Game/Overlays/Settings/Sections/SkinSection.cs
+++ b/osu.Game/Overlays/Settings/Sections/SkinSection.cs
@@ -50,7 +50,12 @@ namespace osu.Game.Overlays.Settings.Sections
         private RealmContextFactory realmFactory { get; set; }
 
         private IDisposable realmSubscription;
-        private IQueryable<SkinInfo> realmSkins;
+
+        private IQueryable<SkinInfo> realmSkins =>
+            realmFactory.Context.All<SkinInfo>()
+                        .Where(s => !s.DeletePending)
+                        .OrderByDescending(s => s.Protected) // protected skins should be at the top.
+                        .ThenBy(s => s.Name, StringComparer.OrdinalIgnoreCase);
 
         [BackgroundDependencyLoader(permitNulls: true)]
         private void load(OsuConfigManager config, [CanBeNull] SkinEditorOverlay skinEditor)
@@ -78,20 +83,13 @@ namespace osu.Game.Overlays.Settings.Sections
 
             skinDropdown.Current = dropdownBindable;
 
-            realmSkins = realmFactory.Context.All<SkinInfo>()
-                                     .Where(s => !s.DeletePending)
-                                     .OrderByDescending(s => s.Protected) // protected skins should be at the top.
-                                     .ThenBy(s => s.Name, StringComparer.OrdinalIgnoreCase);
-
-            realmSubscription = realmSkins
+            realmSubscription = realmFactory.Register(realm => realmSkins
                 .QueryAsyncWithNotifications((sender, changes, error) =>
                 {
-                    if (changes == null)
-                        return;
-
-                    // Eventually this should be handling the individual changes rather than refreshing the whole dropdown.
+                    // The first fire of this is a bit redundant due to the call below,
+                    // but this is safest in case the subscription is restored after a context recycle.
                     updateItems();
-                });
+                }));
 
             updateItems();
 
diff --git a/osu.Game/Screens/Select/BeatmapCarousel.cs b/osu.Game/Screens/Select/BeatmapCarousel.cs
index f8cee2704b..6f3f467170 100644
--- a/osu.Game/Screens/Select/BeatmapCarousel.cs
+++ b/osu.Game/Screens/Select/BeatmapCarousel.cs
@@ -190,13 +190,13 @@ namespace osu.Game.Screens.Select
         {
             base.LoadComplete();
 
-            subscriptionSets = getBeatmapSets(realmFactory.Context).QueryAsyncWithNotifications(beatmapSetsChanged);
-            subscriptionBeatmaps = realmFactory.Context.All<BeatmapInfo>().Where(b => !b.Hidden).QueryAsyncWithNotifications(beatmapsChanged);
+            subscriptionSets = realmFactory.Register(realm => getBeatmapSets(realm).QueryAsyncWithNotifications(beatmapSetsChanged));
+            subscriptionBeatmaps = realmFactory.Register(realm => realm.All<BeatmapInfo>().Where(b => !b.Hidden).QueryAsyncWithNotifications(beatmapsChanged));
 
             // Can't use main subscriptions because we can't lookup deleted indices.
             // https://github.com/realm/realm-dotnet/discussions/2634#discussioncomment-1605595.
-            subscriptionDeletedSets = realmFactory.Context.All<BeatmapSetInfo>().Where(s => s.DeletePending && !s.Protected).QueryAsyncWithNotifications(deletedBeatmapSetsChanged);
-            subscriptionHiddenBeatmaps = realmFactory.Context.All<BeatmapInfo>().Where(b => b.Hidden).QueryAsyncWithNotifications(beatmapsChanged);
+            subscriptionDeletedSets = realmFactory.Register(realm => realm.All<BeatmapSetInfo>().Where(s => s.DeletePending && !s.Protected).QueryAsyncWithNotifications(deletedBeatmapSetsChanged));
+            subscriptionHiddenBeatmaps = realmFactory.Register(realm => realm.All<BeatmapInfo>().Where(b => b.Hidden).QueryAsyncWithNotifications(beatmapsChanged));
         }
 
         private void deletedBeatmapSetsChanged(IRealmCollection<BeatmapSetInfo> sender, ChangeSet changes, Exception error)
@@ -552,10 +552,11 @@ namespace osu.Game.Screens.Select
 
         private void signalBeatmapsLoaded()
         {
-            Debug.Assert(BeatmapSetsLoaded == false);
-
-            BeatmapSetsChanged?.Invoke();
-            BeatmapSetsLoaded = true;
+            if (!BeatmapSetsLoaded)
+            {
+                BeatmapSetsChanged?.Invoke();
+                BeatmapSetsLoaded = true;
+            }
 
             itemsCache.Invalidate();
         }
diff --git a/osu.Game/Screens/Select/Carousel/TopLocalRank.cs b/osu.Game/Screens/Select/Carousel/TopLocalRank.cs
index 7ac99f4935..ee3930364b 100644
--- a/osu.Game/Screens/Select/Carousel/TopLocalRank.cs
+++ b/osu.Game/Screens/Select/Carousel/TopLocalRank.cs
@@ -48,18 +48,19 @@ namespace osu.Game.Screens.Select.Carousel
             ruleset.BindValueChanged(_ =>
             {
                 scoreSubscription?.Dispose();
-                scoreSubscription = realmFactory.Context.All<ScoreInfo>()
-                                                .Filter($"{nameof(ScoreInfo.User)}.{nameof(RealmUser.OnlineID)} == $0"
-                                                        + $" && {nameof(ScoreInfo.BeatmapInfo)}.{nameof(BeatmapInfo.ID)} == $1"
-                                                        + $" && {nameof(ScoreInfo.Ruleset)}.{nameof(RulesetInfo.ShortName)} == $2"
-                                                        + $" && {nameof(ScoreInfo.DeletePending)} == false", api.LocalUser.Value.Id, beatmapInfo.ID, ruleset.Value.ShortName)
-                                                .OrderByDescending(s => s.TotalScore)
-                                                .QueryAsyncWithNotifications((items, changes, ___) =>
-                                                {
-                                                    Rank = items.FirstOrDefault()?.Rank;
-                                                    // Required since presence is changed via IsPresent override
-                                                    Invalidate(Invalidation.Presence);
-                                                });
+                scoreSubscription = realmFactory.Register(realm =>
+                    realm.All<ScoreInfo>()
+                         .Filter($"{nameof(ScoreInfo.User)}.{nameof(RealmUser.OnlineID)} == $0"
+                                 + $" && {nameof(ScoreInfo.BeatmapInfo)}.{nameof(BeatmapInfo.ID)} == $1"
+                                 + $" && {nameof(ScoreInfo.Ruleset)}.{nameof(RulesetInfo.ShortName)} == $2"
+                                 + $" && {nameof(ScoreInfo.DeletePending)} == false", api.LocalUser.Value.Id, beatmapInfo.ID, ruleset.Value.ShortName)
+                         .OrderByDescending(s => s.TotalScore)
+                         .QueryAsyncWithNotifications((items, changes, ___) =>
+                         {
+                             Rank = items.FirstOrDefault()?.Rank;
+                             // Required since presence is changed via IsPresent override
+                             Invalidate(Invalidation.Presence);
+                         }));
             }, true);
         }
 
diff --git a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
index da52b43ab6..954c2a6413 100644
--- a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
+++ b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
@@ -44,9 +44,13 @@ namespace osu.Game.Screens.Select.Leaderboards
                 beatmapInfo = value;
                 Scores = null;
 
-                UpdateScores();
-                if (IsLoaded)
-                    refreshRealmSubscription();
+                if (IsOnlineScope)
+                    UpdateScores();
+                else
+                {
+                    if (IsLoaded)
+                        refreshRealmSubscription();
+                }
             }
         }
 
@@ -109,15 +113,14 @@ namespace osu.Game.Screens.Select.Leaderboards
             if (beatmapInfo == null)
                 return;
 
-            scoreSubscription = realmFactory.Context.All<ScoreInfo>()
-                                            .Filter($"{nameof(ScoreInfo.BeatmapInfo)}.{nameof(BeatmapInfo.ID)} = $0", beatmapInfo.ID)
-                                            .QueryAsyncWithNotifications((_, changes, ___) =>
-                                            {
-                                                if (changes == null)
-                                                    return;
-
-                                                RefreshScores();
-                                            });
+            scoreSubscription = realmFactory.Register(realm =>
+                realm.All<ScoreInfo>()
+                     .Filter($"{nameof(ScoreInfo.BeatmapInfo)}.{nameof(BeatmapInfo.ID)} = $0", beatmapInfo.ID)
+                     .QueryAsyncWithNotifications((_, changes, ___) =>
+                     {
+                         if (!IsOnlineScope)
+                             RefreshScores();
+                     }));
         }
 
         protected override void Reset()
diff --git a/osu.Game/Screens/Spectate/SpectatorScreen.cs b/osu.Game/Screens/Spectate/SpectatorScreen.cs
index dd586bdd37..9fa5bb8562 100644
--- a/osu.Game/Screens/Spectate/SpectatorScreen.cs
+++ b/osu.Game/Screens/Spectate/SpectatorScreen.cs
@@ -79,17 +79,17 @@ namespace osu.Game.Screens.Spectate
                 playingUserStates.BindTo(spectatorClient.PlayingUserStates);
                 playingUserStates.BindCollectionChanged(onPlayingUserStatesChanged, true);
 
-                realmSubscription = realmContextFactory.Context
-                                                       .All<BeatmapSetInfo>()
-                                                       .Where(s => !s.DeletePending)
-                                                       .QueryAsyncWithNotifications((items, changes, ___) =>
-                                                       {
-                                                           if (changes?.InsertedIndices == null)
-                                                               return;
+                realmSubscription = realmContextFactory.Register(realm =>
+                    realm.All<BeatmapSetInfo>()
+                         .Where(s => !s.DeletePending)
+                         .QueryAsyncWithNotifications((items, changes, ___) =>
+                         {
+                             if (changes?.InsertedIndices == null)
+                                 return;
 
-                                                           foreach (int c in changes.InsertedIndices)
-                                                               beatmapUpdated(items[c]);
-                                                       });
+                             foreach (int c in changes.InsertedIndices)
+                                 beatmapUpdated(items[c]);
+                         }));
 
                 foreach ((int id, var _) in userMap)
                     spectatorClient.WatchUser(id);

From 63226f7def9f10d10460e43be72a139852f83cc8 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 21 Jan 2022 19:56:32 +0900
Subject: [PATCH 2383/5547] Remove pointless initial `MusicController` beatmap
 set population

Looks to pass tests and all usages look safe enough.
---
 osu.Game/Overlays/MusicController.cs | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/osu.Game/Overlays/MusicController.cs b/osu.Game/Overlays/MusicController.cs
index 01a2c9d354..c19a069343 100644
--- a/osu.Game/Overlays/MusicController.cs
+++ b/osu.Game/Overlays/MusicController.cs
@@ -87,12 +87,6 @@ namespace osu.Game.Overlays
         protected override void LoadComplete()
         {
             base.LoadComplete();
-
-            // ensure we're ready before completing async load.
-            // probably not a good way of handling this (as there is a period we aren't watching for changes until the realm subscription finishes up.
-            foreach (var s in availableBeatmaps)
-                beatmapSets.Add(s.Detach());
-
             beatmapSubscription = realmFactory.Register(realm => availableBeatmaps.QueryAsyncWithNotifications(beatmapsChanged));
         }
 

From a86c0014fe3093069a23f7014c537d31f6fdf8bf Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 21 Jan 2022 20:07:43 +0900
Subject: [PATCH 2384/5547] Remove unnecessary exception/check

---
 osu.Game/Overlays/MusicController.cs | 11 +----------
 1 file changed, 1 insertion(+), 10 deletions(-)

diff --git a/osu.Game/Overlays/MusicController.cs b/osu.Game/Overlays/MusicController.cs
index c19a069343..0671e6d2c7 100644
--- a/osu.Game/Overlays/MusicController.cs
+++ b/osu.Game/Overlays/MusicController.cs
@@ -30,16 +30,7 @@ namespace osu.Game.Overlays
         [Resolved]
         private BeatmapManager beatmaps { get; set; }
 
-        public IBindableList<BeatmapSetInfo> BeatmapSets
-        {
-            get
-            {
-                if (LoadState < LoadState.Ready)
-                    throw new InvalidOperationException($"{nameof(BeatmapSets)} should not be accessed before the music controller is loaded.");
-
-                return beatmapSets;
-            }
-        }
+        public IBindableList<BeatmapSetInfo> BeatmapSets => beatmapSets;
 
         /// <summary>
         /// Point in time after which the current track will be restarted on triggering a "previous track" action.

From 3b11235d3c65c7416e8e092d0a8d4aeb45c0c85c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 21 Jan 2022 20:45:10 +0900
Subject: [PATCH 2385/5547] Fix potentially cyclic subscription registration if
 a subscription's delegate accesses `Context`

---
 osu.Game/Database/RealmContextFactory.cs | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Database/RealmContextFactory.cs b/osu.Game/Database/RealmContextFactory.cs
index c11ff61039..d9c66ccc69 100644
--- a/osu.Game/Database/RealmContextFactory.cs
+++ b/osu.Game/Database/RealmContextFactory.cs
@@ -88,6 +88,8 @@ namespace osu.Game.Database
                             registerSubscription(action);
                     }
 
+                    Debug.Assert(context != null);
+
                     // creating a context will ensure our schema is up-to-date and migrated.
                     return context;
                 }
@@ -261,10 +263,13 @@ namespace osu.Game.Database
         {
             Debug.Assert(ThreadSafety.IsUpdateThread);
 
+            // Get context outside of flag update to ensure beyond doubt this can't be cyclic.
+            var realm = Context;
+
             lock (contextLock)
             {
                 current_thread_subscriptions_allowed.Value = true;
-                subscriptionActions[action] = action(Context);
+                subscriptionActions[action] = action(realm);
                 current_thread_subscriptions_allowed.Value = false;
             }
         }

From 9b63f15e68577a2d2b88d2613a6f61aff554097a Mon Sep 17 00:00:00 2001
From: Susko3 <16479013+Susko3@users.noreply.github.com>
Date: Fri, 21 Jan 2022 13:58:30 +0100
Subject: [PATCH 2386/5547] Add failing test

---
 .../Visual/Menus/TestSceneLoginPanel.cs       | 21 +++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/osu.Game.Tests/Visual/Menus/TestSceneLoginPanel.cs b/osu.Game.Tests/Visual/Menus/TestSceneLoginPanel.cs
index 4754a73f83..642cc68de5 100644
--- a/osu.Game.Tests/Visual/Menus/TestSceneLoginPanel.cs
+++ b/osu.Game.Tests/Visual/Menus/TestSceneLoginPanel.cs
@@ -8,6 +8,8 @@ using osu.Framework.Testing;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Online.API;
 using osu.Game.Overlays.Login;
+using osu.Game.Users.Drawables;
+using osuTK.Input;
 
 namespace osu.Game.Tests.Visual.Menus
 {
@@ -15,6 +17,7 @@ namespace osu.Game.Tests.Visual.Menus
     public class TestSceneLoginPanel : OsuManualInputManagerTestScene
     {
         private LoginPanel loginPanel;
+        private int hideCount;
 
         [SetUpSteps]
         public void SetUpSteps()
@@ -26,6 +29,7 @@ namespace osu.Game.Tests.Visual.Menus
                     Anchor = Anchor.Centre,
                     Origin = Anchor.Centre,
                     Width = 0.5f,
+                    RequestHide = () => hideCount++,
                 });
             });
         }
@@ -51,5 +55,22 @@ namespace osu.Game.Tests.Visual.Menus
             AddStep("enter password", () => loginPanel.ChildrenOfType<OsuPasswordTextBox>().First().Text = "password");
             AddStep("submit", () => loginPanel.ChildrenOfType<OsuButton>().First(b => b.Text.ToString() == "Sign in").TriggerClick());
         }
+
+        [Test]
+        public void TestClickingOnFlagClosesPanel()
+        {
+            AddStep("reset hide count", () => hideCount = 0);
+
+            AddStep("logout", () => API.Logout());
+            AddStep("enter password", () => loginPanel.ChildrenOfType<OsuPasswordTextBox>().First().Text = "password");
+            AddStep("submit", () => loginPanel.ChildrenOfType<OsuButton>().First(b => b.Text.ToString() == "Sign in").TriggerClick());
+
+            AddStep("click on flag", () =>
+            {
+                InputManager.MoveMouseTo(loginPanel.ChildrenOfType<UpdateableFlag>().First());
+                InputManager.Click(MouseButton.Left);
+            });
+            AddAssert("hide requested", () => hideCount == 1);
+        }
     }
 }

From 529610ee2e9c0d73c3a9c72c0531d4b716264644 Mon Sep 17 00:00:00 2001
From: Susko3 <16479013+Susko3@users.noreply.github.com>
Date: Fri, 21 Jan 2022 14:01:49 +0100
Subject: [PATCH 2387/5547] Call the UserPanel `Action` when clicking on the
 flag

---
 osu.Game/Users/Drawables/UpdateableFlag.cs | 8 ++++++++
 osu.Game/Users/ExtendedUserPanel.cs        | 3 ++-
 2 files changed, 10 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Users/Drawables/UpdateableFlag.cs b/osu.Game/Users/Drawables/UpdateableFlag.cs
index 7db834bf83..e5debc0683 100644
--- a/osu.Game/Users/Drawables/UpdateableFlag.cs
+++ b/osu.Game/Users/Drawables/UpdateableFlag.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.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
@@ -23,6 +24,12 @@ namespace osu.Game.Users.Drawables
         /// </summary>
         public bool ShowPlaceholderOnNull = 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).
+        /// </summary>
+        public Action Action;
+
         public UpdateableFlag(Country country = null)
         {
             Country = country;
@@ -52,6 +59,7 @@ namespace osu.Game.Users.Drawables
 
         protected override bool OnClick(ClickEvent e)
         {
+            Action?.Invoke();
             rankingsOverlay?.ShowCountry(Country);
             return true;
         }
diff --git a/osu.Game/Users/ExtendedUserPanel.cs b/osu.Game/Users/ExtendedUserPanel.cs
index fc5e1eca5f..d0f693c37c 100644
--- a/osu.Game/Users/ExtendedUserPanel.cs
+++ b/osu.Game/Users/ExtendedUserPanel.cs
@@ -53,7 +53,8 @@ namespace osu.Game.Users
 
         protected UpdateableFlag CreateFlag() => new UpdateableFlag(User.Country)
         {
-            Size = new Vector2(39, 26)
+            Size = new Vector2(39, 26),
+            Action = Action,
         };
 
         protected SpriteIcon CreateStatusIcon() => statusIcon = new SpriteIcon

From ad3a01dc06215e17458357189cac15b9c603d093 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 21 Jan 2022 22:40:18 +0900
Subject: [PATCH 2388/5547] Use a more reliable method of reviving the update
 thread realm after blocking

---
 osu.Game/Database/RealmContextFactory.cs      | 44 +++++++++++--------
 .../Sections/DebugSettings/MemorySettings.cs  |  4 --
 2 files changed, 25 insertions(+), 23 deletions(-)

diff --git a/osu.Game/Database/RealmContextFactory.cs b/osu.Game/Database/RealmContextFactory.cs
index d9c66ccc69..6fb9a2996b 100644
--- a/osu.Game/Database/RealmContextFactory.cs
+++ b/osu.Game/Database/RealmContextFactory.cs
@@ -69,30 +69,29 @@ namespace osu.Game.Database
 
         private Realm? context;
 
-        public Realm Context
+        public Realm Context => ensureUpdateContext();
+
+        private Realm ensureUpdateContext()
         {
-            get
+            if (!ThreadSafety.IsUpdateThread)
+                throw new InvalidOperationException(@$"Use {nameof(createContext)} when performing realm operations from a non-update thread");
+
+            lock (contextLock)
             {
-                if (!ThreadSafety.IsUpdateThread)
-                    throw new InvalidOperationException(@$"Use {nameof(createContext)} when performing realm operations from a non-update thread");
-
-                lock (contextLock)
+                if (context == null)
                 {
-                    if (context == null)
-                    {
-                        context = createContext();
-                        Logger.Log(@$"Opened realm ""{context.Config.DatabasePath}"" at version {context.Config.SchemaVersion}");
+                    context = createContext();
+                    Logger.Log(@$"Opened realm ""{context.Config.DatabasePath}"" at version {context.Config.SchemaVersion}");
 
-                        // Resubscribe any subscriptions
-                        foreach (var action in subscriptionActions.Keys)
-                            registerSubscription(action);
-                    }
-
-                    Debug.Assert(context != null);
-
-                    // creating a context will ensure our schema is up-to-date and migrated.
-                    return context;
+                    // Resubscribe any subscriptions
+                    foreach (var action in subscriptionActions.Keys)
+                        registerSubscription(action);
                 }
+
+                Debug.Assert(context != null);
+
+                // creating a context will ensure our schema is up-to-date and migrated.
+                return context;
             }
         }
 
@@ -506,6 +505,8 @@ namespace osu.Game.Database
             if (isDisposed)
                 throw new ObjectDisposedException(nameof(RealmContextFactory));
 
+            SynchronizationContext syncContext;
+
             try
             {
                 contextCreationLock.Wait();
@@ -515,6 +516,8 @@ namespace osu.Game.Database
                     if (!ThreadSafety.IsUpdateThread && context != null)
                         throw new InvalidOperationException(@$"{nameof(BlockAllOperations)} must be called from the update thread.");
 
+                    syncContext = SynchronizationContext.Current;
+
                     Logger.Log(@"Blocking realm operations.", LoggingTarget.Database);
 
                     context?.Dispose();
@@ -553,6 +556,9 @@ namespace osu.Game.Database
             {
                 factory.contextCreationLock.Release();
                 Logger.Log(@"Restoring realm operations.", LoggingTarget.Database);
+
+                // Post back to the update thread to revive any subscriptions.
+                syncContext?.Post(_ => ensureUpdateContext(), null);
             });
         }
 
diff --git a/osu.Game/Overlays/Settings/Sections/DebugSettings/MemorySettings.cs b/osu.Game/Overlays/Settings/Sections/DebugSettings/MemorySettings.cs
index 84a54b208c..8d4fc5fc9f 100644
--- a/osu.Game/Overlays/Settings/Sections/DebugSettings/MemorySettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/DebugSettings/MemorySettings.cs
@@ -33,10 +33,6 @@ namespace osu.Game.Overlays.Settings.Sections.DebugSettings
                         using (realmFactory.BlockAllOperations())
                         {
                         }
-
-                        // retrieve context to revive realm subscriptions.
-                        // TODO: should we do this from OsuGame or RealmContextFactory or something? Answer: yes.
-                        var _ = realmFactory.Context;
                     }
                 },
             };

From 81b07dee563b9ef01da5b8571061c09ccf0b417d Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 21 Jan 2022 17:41:33 +0300
Subject: [PATCH 2389/5547] Introduce `IExpandable` interface

---
 osu.Game/Overlays/IExpandable.cs | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)
 create mode 100644 osu.Game/Overlays/IExpandable.cs

diff --git a/osu.Game/Overlays/IExpandable.cs b/osu.Game/Overlays/IExpandable.cs
new file mode 100644
index 0000000000..770ac97847
--- /dev/null
+++ b/osu.Game/Overlays/IExpandable.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.Bindables;
+using osu.Framework.Graphics;
+
+namespace osu.Game.Overlays
+{
+    /// <summary>
+    /// An interface for drawables with ability to expand/contract.
+    /// </summary>
+    public interface IExpandable : IDrawable
+    {
+        /// <summary>
+        /// Whether this drawable is in an expanded state.
+        /// </summary>
+        BindableBool Expanded { get; }
+    }
+}

From a2b6bc9e5334e4357c10a5a6553486b2d9bd5e24 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 18 Jan 2022 18:10:00 +0900
Subject: [PATCH 2390/5547] Add benchmark coverage of variuos methods of
 reading properties from realm

---
 osu.Game.Benchmarks/BenchmarkRealmReads.cs | 139 +++++++++++++++++++++
 1 file changed, 139 insertions(+)
 create mode 100644 osu.Game.Benchmarks/BenchmarkRealmReads.cs

diff --git a/osu.Game.Benchmarks/BenchmarkRealmReads.cs b/osu.Game.Benchmarks/BenchmarkRealmReads.cs
new file mode 100644
index 0000000000..5b5bdf595d
--- /dev/null
+++ b/osu.Game.Benchmarks/BenchmarkRealmReads.cs
@@ -0,0 +1,139 @@
+// 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 System.Threading;
+using BenchmarkDotNet.Attributes;
+using osu.Framework.Testing;
+using osu.Framework.Threading;
+using osu.Game.Beatmaps;
+using osu.Game.Database;
+using osu.Game.Rulesets.Osu;
+using osu.Game.Tests.Resources;
+
+namespace osu.Game.Benchmarks
+{
+    public class BenchmarkRealmReads : BenchmarkTest
+    {
+        private TemporaryNativeStorage storage;
+        private RealmContextFactory realmFactory;
+        private UpdateThread updateThread;
+
+        [Params(1, 100, 1000)]
+        public int ReadsPerFetch { get; set; }
+
+        public override void SetUp()
+        {
+            storage = new TemporaryNativeStorage("realm-benchmark");
+            storage.DeleteDirectory(string.Empty);
+
+            realmFactory = new RealmContextFactory(storage, "client");
+
+            using (var context = realmFactory.CreateContext())
+                context.Write(c => c.Add(TestResources.CreateTestBeatmapSetInfo(rulesets: new[] { new OsuRuleset().RulesetInfo })));
+
+            updateThread = new UpdateThread(() => { }, null);
+            updateThread.Start();
+        }
+
+        [Benchmark]
+        public void BenchmarkDirectPropertyRead()
+        {
+            using (var context = realmFactory.CreateContext())
+            {
+                var beatmapSet = context.All<BeatmapSetInfo>().First();
+
+                for (int i = 0; i < ReadsPerFetch; i++)
+                {
+                    string _ = beatmapSet.Beatmaps.First().Hash;
+                }
+            }
+        }
+
+        [Benchmark]
+        public void BenchmarkDirectPropertyReadUpdateThread()
+        {
+            var done = new ManualResetEventSlim();
+
+            updateThread.Scheduler.Add(() =>
+            {
+                try
+                {
+                    var beatmapSet = realmFactory.Context.All<BeatmapSetInfo>().First();
+
+                    for (int i = 0; i < ReadsPerFetch; i++)
+                    {
+                        string _ = beatmapSet.Beatmaps.First().Hash;
+                    }
+                }
+                finally
+                {
+                    done.Set();
+                }
+            });
+
+            done.Wait();
+        }
+
+        [Benchmark]
+        public void BenchmarkRealmLivePropertyRead()
+        {
+            using (var context = realmFactory.CreateContext())
+            {
+                var beatmapSet = context.All<BeatmapSetInfo>().First().ToLive(realmFactory);
+
+                for (int i = 0; i < ReadsPerFetch; i++)
+                {
+                    string _ = beatmapSet.PerformRead(b => b.Beatmaps.First().Hash);
+                }
+            }
+        }
+
+        [Benchmark]
+        public void BenchmarkRealmLivePropertyReadUpdateThread()
+        {
+            var done = new ManualResetEventSlim();
+
+            updateThread.Scheduler.Add(() =>
+            {
+                try
+                {
+                    var beatmapSet = realmFactory.Context.All<BeatmapSetInfo>().First().ToLive(realmFactory);
+
+                    for (int i = 0; i < ReadsPerFetch; i++)
+                    {
+                        string _ = beatmapSet.PerformRead(b => b.Beatmaps.First().Hash);
+                    }
+                }
+                finally
+                {
+                    done.Set();
+                }
+            });
+
+            done.Wait();
+        }
+
+        [Benchmark]
+        public void BenchmarkDetachedPropertyRead()
+        {
+            using (var context = realmFactory.CreateContext())
+            {
+                var beatmapSet = context.All<BeatmapSetInfo>().First().Detach();
+
+                for (int i = 0; i < ReadsPerFetch; i++)
+                {
+                    string _ = beatmapSet.Beatmaps.First().Hash;
+                }
+            }
+        }
+
+        [GlobalCleanup]
+        public void Cleanup()
+        {
+            realmFactory?.Dispose();
+            storage?.Dispose();
+            updateThread?.Exit();
+        }
+    }
+}

From 8ef50ff42dab85eaae680274ccd7d3b25a78de2f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 17 Jan 2022 17:28:01 +0900
Subject: [PATCH 2391/5547] Add safety to ensure `RealmLiveUnmanaged` is not
 used with managed instances

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

diff --git a/osu.Game/Database/RealmLiveUnmanaged.cs b/osu.Game/Database/RealmLiveUnmanaged.cs
index ea50ccc1ff..97f2faa656 100644
--- a/osu.Game/Database/RealmLiveUnmanaged.cs
+++ b/osu.Game/Database/RealmLiveUnmanaged.cs
@@ -21,6 +21,9 @@ namespace osu.Game.Database
         /// <param name="data">The realm data.</param>
         public RealmLiveUnmanaged(T data)
         {
+            if (data.IsManaged)
+                throw new InvalidOperationException($"Cannot use {nameof(RealmLiveUnmanaged<T>)} with managed instances");
+
             Value = data;
         }
 

From 9946003069f7666f74bc383ac1371043cf6d0b35 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 22 Jan 2022 05:09:40 +0900
Subject: [PATCH 2392/5547] Update osu.Game/Screens/Menu/IntroScreen.cs

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

diff --git a/osu.Game/Screens/Menu/IntroScreen.cs b/osu.Game/Screens/Menu/IntroScreen.cs
index db9d9b83c4..10be90a5f0 100644
--- a/osu.Game/Screens/Menu/IntroScreen.cs
+++ b/osu.Game/Screens/Menu/IntroScreen.cs
@@ -103,7 +103,7 @@ namespace osu.Game.Screens.Menu
 
                     int setCount = sets.Count;
 
-                    if (sets.Any())
+                    if (setCount > 0)
                     {
                         var found = sets[RNG.Next(0, setCount - 1)].Beatmaps.FirstOrDefault();
 

From 855ef3fa92ef76e53d2db54eeddf7ec70482e248 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 22 Jan 2022 11:50:47 +0900
Subject: [PATCH 2393/5547] Create backup before any realm contexts are used

---
 osu.Game/Database/EFToRealmMigrator.cs | 16 ----------------
 osu.Game/OsuGameBase.cs                | 15 +++++++++++++++
 2 files changed, 15 insertions(+), 16 deletions(-)

diff --git a/osu.Game/Database/EFToRealmMigrator.cs b/osu.Game/Database/EFToRealmMigrator.cs
index 85d65fea82..1e21107628 100644
--- a/osu.Game/Database/EFToRealmMigrator.cs
+++ b/osu.Game/Database/EFToRealmMigrator.cs
@@ -100,10 +100,6 @@ namespace osu.Game.Database
         {
             base.LoadComplete();
 
-            // needs to be run on the update thread because of realm BlockAllOperations.
-            // maybe we can work around this? not sure..
-            createBackup();
-
             Task.Factory.StartNew(() =>
             {
                 using (var ef = efContextFactory.Get())
@@ -470,17 +466,5 @@ namespace osu.Game.Database
 
         private string? getRulesetShortNameFromLegacyID(long rulesetId) =>
             efContextFactory.Get().RulesetInfo.FirstOrDefault(r => r.ID == rulesetId)?.ShortName;
-
-        private void createBackup()
-        {
-            string migration = $"before_final_migration_{DateTimeOffset.UtcNow.ToUnixTimeSeconds()}";
-
-            efContextFactory.CreateBackup($"client.{migration}.db");
-            realmContextFactory.CreateBackup($"client.{migration}.realm");
-
-            using (var source = storage.GetStream("collection.db"))
-            using (var destination = storage.GetStream($"collection.{migration}.db", FileAccess.Write, FileMode.CreateNew))
-                source.CopyTo(destination);
-        }
     }
 }
diff --git a/osu.Game/OsuGameBase.cs b/osu.Game/OsuGameBase.cs
index 3d40126b4f..710a7be8d4 100644
--- a/osu.Game/OsuGameBase.cs
+++ b/osu.Game/OsuGameBase.cs
@@ -197,6 +197,21 @@ namespace osu.Game
             dependencies.Cache(RulesetStore = new RulesetStore(realmFactory, Storage));
             dependencies.CacheAs<IRulesetStore>(RulesetStore);
 
+            // Backup is taken here rather than in EFToRealmMigrator to avoid recycling realm contexts
+            // after initial usages below. It can be moved once a direction is established for handling re-subscription.
+            // See https://github.com/ppy/osu/pull/16547 for more discussion.
+            if (EFContextFactory != null)
+            {
+                string migration = $"before_final_migration_{DateTimeOffset.UtcNow.ToUnixTimeSeconds()}";
+
+                EFContextFactory.CreateBackup($"client.{migration}.db");
+                realmFactory.CreateBackup($"client.{migration}.realm");
+
+                using (var source = Storage.GetStream("collection.db"))
+                using (var destination = Storage.GetStream($"collection.{migration}.db", FileAccess.Write, FileMode.CreateNew))
+                    source.CopyTo(destination);
+            }
+
             dependencies.CacheAs(Storage);
 
             var largeStore = new LargeTextureStore(Host.CreateTextureLoaderStore(new NamespacedResourceStore<byte[]>(Resources, @"Textures")));

From daed0b04dc97e8a50375f6955451bd3175af6946 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 22 Jan 2022 11:54:40 +0900
Subject: [PATCH 2394/5547] Remove using statements

---
 osu.Game/Database/EFToRealmMigrator.cs | 2 --
 1 file changed, 2 deletions(-)

diff --git a/osu.Game/Database/EFToRealmMigrator.cs b/osu.Game/Database/EFToRealmMigrator.cs
index 1e21107628..f5b338062a 100644
--- a/osu.Game/Database/EFToRealmMigrator.cs
+++ b/osu.Game/Database/EFToRealmMigrator.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.IO;
 using System.Linq;
 using System.Threading.Tasks;
 using Microsoft.EntityFrameworkCore;

From b23f4674b12251a94fd8bb0f054adcdc60f8abf2 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 22 Jan 2022 12:02:18 +0900
Subject: [PATCH 2395/5547] Update outdated exception message

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

diff --git a/osu.Game/Database/RealmContextFactory.cs b/osu.Game/Database/RealmContextFactory.cs
index 888ffb1dd5..ea6a4b9636 100644
--- a/osu.Game/Database/RealmContextFactory.cs
+++ b/osu.Game/Database/RealmContextFactory.cs
@@ -72,7 +72,7 @@ namespace osu.Game.Database
             get
             {
                 if (!ThreadSafety.IsUpdateThread)
-                    throw new InvalidOperationException(@$"Use {nameof(createContext)} when performing realm operations from a non-update thread");
+                    throw new InvalidOperationException(@$"Use {nameof(Run)}/{nameof(Write)} when performing realm operations from a non-update thread");
 
                 lock (contextLock)
                 {

From 7025191fdd45767321565cf28bfbb403b29148ef Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 22 Jan 2022 12:02:44 +0900
Subject: [PATCH 2396/5547] Move target field outside of `Run` usage

Co-authored-by: Salman Ahmed <frenzibyte@gmail.com>
---
 .../Overlays/Settings/Sections/Input/KeyBindingsSubsection.cs   | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/Settings/Sections/Input/KeyBindingsSubsection.cs b/osu.Game/Overlays/Settings/Sections/Input/KeyBindingsSubsection.cs
index 9075dfefd4..2ee3372f80 100644
--- a/osu.Game/Overlays/Settings/Sections/Input/KeyBindingsSubsection.cs
+++ b/osu.Game/Overlays/Settings/Sections/Input/KeyBindingsSubsection.cs
@@ -36,7 +36,7 @@ namespace osu.Game.Overlays.Settings.Sections.Input
 
             List<RealmKeyBinding> bindings = null;
 
-            realmFactory.Run(realm => bindings = realm.All<RealmKeyBinding>().Where(b => b.RulesetName == rulesetName && b.Variant == variant).Detach());
+            bindings = realmFactory.Run(realm => realm.All<RealmKeyBinding>().Where(b => b.RulesetName == rulesetName && b.Variant == variant).Detach());
 
             foreach (var defaultGroup in Defaults.GroupBy(d => d.Action))
             {

From a89954d67f0b1f3b77edab3b8b8f7e71c1db1de8 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 22 Jan 2022 12:12:13 +0900
Subject: [PATCH 2397/5547] Update benchmarks in line with new structure

---
 osu.Game.Benchmarks/BenchmarkRealmReads.cs | 24 ++++++++++++----------
 1 file changed, 13 insertions(+), 11 deletions(-)

diff --git a/osu.Game.Benchmarks/BenchmarkRealmReads.cs b/osu.Game.Benchmarks/BenchmarkRealmReads.cs
index 5b5bdf595d..bb22fab51c 100644
--- a/osu.Game.Benchmarks/BenchmarkRealmReads.cs
+++ b/osu.Game.Benchmarks/BenchmarkRealmReads.cs
@@ -29,8 +29,10 @@ namespace osu.Game.Benchmarks
 
             realmFactory = new RealmContextFactory(storage, "client");
 
-            using (var context = realmFactory.CreateContext())
-                context.Write(c => c.Add(TestResources.CreateTestBeatmapSetInfo(rulesets: new[] { new OsuRuleset().RulesetInfo })));
+            realmFactory.Run(realm =>
+            {
+                realm.Write(c => c.Add(TestResources.CreateTestBeatmapSetInfo(rulesets: new[] { new OsuRuleset().RulesetInfo })));
+            });
 
             updateThread = new UpdateThread(() => { }, null);
             updateThread.Start();
@@ -39,15 +41,15 @@ namespace osu.Game.Benchmarks
         [Benchmark]
         public void BenchmarkDirectPropertyRead()
         {
-            using (var context = realmFactory.CreateContext())
+            realmFactory.Run(realm =>
             {
-                var beatmapSet = context.All<BeatmapSetInfo>().First();
+                var beatmapSet = realm.All<BeatmapSetInfo>().First();
 
                 for (int i = 0; i < ReadsPerFetch; i++)
                 {
                     string _ = beatmapSet.Beatmaps.First().Hash;
                 }
-            }
+            });
         }
 
         [Benchmark]
@@ -78,15 +80,15 @@ namespace osu.Game.Benchmarks
         [Benchmark]
         public void BenchmarkRealmLivePropertyRead()
         {
-            using (var context = realmFactory.CreateContext())
+            realmFactory.Run(realm =>
             {
-                var beatmapSet = context.All<BeatmapSetInfo>().First().ToLive(realmFactory);
+                var beatmapSet = realm.All<BeatmapSetInfo>().First().ToLive(realmFactory);
 
                 for (int i = 0; i < ReadsPerFetch; i++)
                 {
                     string _ = beatmapSet.PerformRead(b => b.Beatmaps.First().Hash);
                 }
-            }
+            });
         }
 
         [Benchmark]
@@ -117,15 +119,15 @@ namespace osu.Game.Benchmarks
         [Benchmark]
         public void BenchmarkDetachedPropertyRead()
         {
-            using (var context = realmFactory.CreateContext())
+            realmFactory.Run(realm =>
             {
-                var beatmapSet = context.All<BeatmapSetInfo>().First().Detach();
+                var beatmapSet = realm.All<BeatmapSetInfo>().First().Detach();
 
                 for (int i = 0; i < ReadsPerFetch; i++)
                 {
                     string _ = beatmapSet.Beatmaps.First().Hash;
                 }
-            }
+            });
         }
 
         [GlobalCleanup]

From c9db0181d0611554f68e70ac4ed2da1fc96e9550 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 22 Jan 2022 12:24:05 +0900
Subject: [PATCH 2398/5547] Attempt to fix test failures on windows due to
 context being held open

---
 osu.Game.Tests/Database/RealmLiveTests.cs | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/osu.Game.Tests/Database/RealmLiveTests.cs b/osu.Game.Tests/Database/RealmLiveTests.cs
index 2f16df4624..7b1cf763d6 100644
--- a/osu.Game.Tests/Database/RealmLiveTests.cs
+++ b/osu.Game.Tests/Database/RealmLiveTests.cs
@@ -47,6 +47,11 @@ namespace osu.Game.Tests.Database
                     liveBeatmap = beatmap.ToLive(realmFactory);
                 });
 
+                using (realmFactory.BlockAllOperations())
+                {
+                    // recycle realm before migrating
+                }
+
                 using (var migratedStorage = new TemporaryNativeStorage("realm-test-migration-target"))
                 {
                     migratedStorage.DeleteDirectory(string.Empty);

From 25dbe6b27c092e5ce992e7cb4d7663cf3e8656df Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 22 Jan 2022 12:58:30 +0900
Subject: [PATCH 2399/5547] Fix unused null assignment

---
 .../Settings/Sections/Input/KeyBindingsSubsection.cs        | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Overlays/Settings/Sections/Input/KeyBindingsSubsection.cs b/osu.Game/Overlays/Settings/Sections/Input/KeyBindingsSubsection.cs
index 2ee3372f80..5b8a52240e 100644
--- a/osu.Game/Overlays/Settings/Sections/Input/KeyBindingsSubsection.cs
+++ b/osu.Game/Overlays/Settings/Sections/Input/KeyBindingsSubsection.cs
@@ -34,9 +34,9 @@ namespace osu.Game.Overlays.Settings.Sections.Input
         {
             string rulesetName = Ruleset?.ShortName;
 
-            List<RealmKeyBinding> bindings = null;
-
-            bindings = realmFactory.Run(realm => realm.All<RealmKeyBinding>().Where(b => b.RulesetName == rulesetName && b.Variant == variant).Detach());
+            var bindings = realmFactory.Run(realm => realm.All<RealmKeyBinding>()
+                                                          .Where(b => b.RulesetName == rulesetName && b.Variant == variant)
+                                                          .Detach());
 
             foreach (var defaultGroup in Defaults.GroupBy(d => d.Action))
             {

From c99f2278797abd9c2e259b422ccd602ae14eea30 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 22 Jan 2022 13:48:49 +0100
Subject: [PATCH 2400/5547] Remove no longer used resolved storage

---
 osu.Game/Database/EFToRealmMigrator.cs | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/osu.Game/Database/EFToRealmMigrator.cs b/osu.Game/Database/EFToRealmMigrator.cs
index f5b338062a..161c12e35e 100644
--- a/osu.Game/Database/EFToRealmMigrator.cs
+++ b/osu.Game/Database/EFToRealmMigrator.cs
@@ -38,9 +38,6 @@ namespace osu.Game.Database
         [Resolved]
         private OsuConfigManager config { get; set; } = null!;
 
-        [Resolved]
-        private Storage storage { get; set; } = null!;
-
         private readonly OsuSpriteText currentOperationText;
 
         public EFToRealmMigrator()

From 7e68371d28b9ae109a8e89039bf1db1ed801436b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 22 Jan 2022 14:20:28 +0100
Subject: [PATCH 2401/5547] Move log statement about migration completed closer
 to rest of migration code

---
 osu.Game/Database/DatabaseContextFactory.cs | 4 ----
 osu.Game/Database/EFToRealmMigrator.cs      | 4 ++++
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Database/DatabaseContextFactory.cs b/osu.Game/Database/DatabaseContextFactory.cs
index 635c4373cd..c84edbfb81 100644
--- a/osu.Game/Database/DatabaseContextFactory.cs
+++ b/osu.Game/Database/DatabaseContextFactory.cs
@@ -5,7 +5,6 @@ using System.IO;
 using System.Linq;
 using System.Threading;
 using Microsoft.EntityFrameworkCore.Storage;
-using osu.Framework.Development;
 using osu.Framework.Logging;
 using osu.Framework.Platform;
 using osu.Framework.Statistics;
@@ -151,9 +150,6 @@ namespace osu.Game.Database
         {
             Logger.Log($"Creating full EF database backup at {backupFilename}", LoggingTarget.Database);
 
-            if (DebugUtils.IsDebugBuild)
-                Logger.Log("Your development database has been fully migrated to realm. If you switch back to a pre-realm branch and need your previous database, rename the backup file back to \"client.db\".\n\nNote that doing this can potentially leave your file store in a bad state.", level: LogLevel.Important);
-
             using (var source = storage.GetStream(DATABASE_NAME))
             using (var destination = storage.GetStream(backupFilename, FileAccess.Write, FileMode.CreateNew))
                 source.CopyTo(destination);
diff --git a/osu.Game/Database/EFToRealmMigrator.cs b/osu.Game/Database/EFToRealmMigrator.cs
index c224399dbc..bbbdac352e 100644
--- a/osu.Game/Database/EFToRealmMigrator.cs
+++ b/osu.Game/Database/EFToRealmMigrator.cs
@@ -5,6 +5,7 @@ using System.Linq;
 using System.Threading.Tasks;
 using Microsoft.EntityFrameworkCore;
 using osu.Framework.Allocation;
+using osu.Framework.Development;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Logging;
@@ -108,6 +109,9 @@ namespace osu.Game.Database
                 // Will cause future startups to not attempt migration.
                 log("Migration successful, deleting EF database");
                 efContextFactory.ResetDatabase();
+
+                if (DebugUtils.IsDebugBuild)
+                    Logger.Log("Your development database has been fully migrated to realm. If you switch back to a pre-realm branch and need your previous database, rename the backup file back to \"client.db\".\n\nNote that doing this can potentially leave your file store in a bad state.", level: LogLevel.Important);
             }, TaskCreationOptions.LongRunning).ContinueWith(t =>
             {
                 FinishedMigrating = true;

From b2d1bd029d9bd463714b69256b906caad62c1813 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sat, 22 Jan 2022 16:17:46 +0300
Subject: [PATCH 2402/5547] Turn on high poll rate when tournament chat is
 expanded

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

diff --git a/osu.Game.Tournament/Components/TournamentMatchChatDisplay.cs b/osu.Game.Tournament/Components/TournamentMatchChatDisplay.cs
index fe22d1e76d..a5ead6c2f0 100644
--- a/osu.Game.Tournament/Components/TournamentMatchChatDisplay.cs
+++ b/osu.Game.Tournament/Components/TournamentMatchChatDisplay.cs
@@ -45,7 +45,7 @@ namespace osu.Game.Tournament.Components
 
                     if (manager == null)
                     {
-                        AddInternal(manager = new ChannelManager());
+                        AddInternal(manager = new ChannelManager { HighPollRate = { Value = true } });
                         Channel.BindTo(manager.CurrentChannel);
                     }
 

From 955bab926fac76513a660737a42e48e01cfd9bc0 Mon Sep 17 00:00:00 2001
From: mk-56 <darioheadleysilva@gmail.com>
Date: Sat, 22 Jan 2022 19:38:56 +0100
Subject: [PATCH 2403/5547] Separate the settings for each modes radiuses

---
 .../Mods/CatchModFlashlight.cs                | 19 ++++++++--
 .../Mods/ManiaModFlashlight.cs                | 19 ++++++++--
 .../Mods/OsuModFlashlight.cs                  | 36 ++++++++++++-------
 .../Mods/TaikoModFlashlight.cs                | 19 ++++++++--
 osu.Game/Rulesets/Mods/ModFlashlight.cs       | 20 ++---------
 5 files changed, 75 insertions(+), 38 deletions(-)

diff --git a/osu.Game.Rulesets.Catch/Mods/CatchModFlashlight.cs b/osu.Game.Rulesets.Catch/Mods/CatchModFlashlight.cs
index 9d9fa5aed4..f75772b04e 100644
--- a/osu.Game.Rulesets.Catch/Mods/CatchModFlashlight.cs
+++ b/osu.Game.Rulesets.Catch/Mods/CatchModFlashlight.cs
@@ -3,6 +3,7 @@
 
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
+using osu.Game.Configuration;
 using osu.Game.Rulesets.Catch.Objects;
 using osu.Game.Rulesets.Catch.UI;
 using osu.Game.Rulesets.Mods;
@@ -15,8 +16,22 @@ namespace osu.Game.Rulesets.Catch.Mods
     {
         public override double ScoreMultiplier => 1.12;
 
-        public override bool DefaultComboDependency => true;
-        public override float DefaultRadius => 350;
+        [SettingSource("Change radius based on combo", "Decrease the flashlight radius as combo increases.")]
+        public override BindableBool ChangeRadius { get; } = new BindableBool
+        {
+            Default = true,
+            Value = true
+        };
+
+        [SettingSource("Initial radius", "Initial radius of the flashlight area.")]
+        public override BindableNumber<float> InitialRadius { get; } = new BindableNumber<float>
+        {
+            MinValue = 150f,
+            MaxValue = 600f,
+            Default = 350f,
+            Value = 350f,
+            Precision = 5f
+        };
 
         public override Flashlight CreateFlashlight() => new CatchFlashlight(playfield, ChangeRadius.Value, InitialRadius.Value);
 
diff --git a/osu.Game.Rulesets.Mania/Mods/ManiaModFlashlight.cs b/osu.Game.Rulesets.Mania/Mods/ManiaModFlashlight.cs
index 4fff736c57..a6a3c3be73 100644
--- a/osu.Game.Rulesets.Mania/Mods/ManiaModFlashlight.cs
+++ b/osu.Game.Rulesets.Mania/Mods/ManiaModFlashlight.cs
@@ -5,6 +5,7 @@ using System;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Layout;
+using osu.Game.Configuration;
 using osu.Game.Rulesets.Mania.Objects;
 using osu.Game.Rulesets.Mods;
 using osuTK;
@@ -16,8 +17,22 @@ namespace osu.Game.Rulesets.Mania.Mods
         public override double ScoreMultiplier => 1;
         public override Type[] IncompatibleMods => new[] { typeof(ModHidden) };
 
-        public override bool DefaultComboDependency => false;
-        public override float DefaultRadius => 180;
+        [SettingSource("Change radius based on combo", "Decrease the flashlight radius as combo increases.")]
+        public override BindableBool ChangeRadius { get; } = new BindableBool
+        {
+            Default = false,
+            Value = false
+        };
+
+        [SettingSource("Initial radius", "Initial radius of the flashlight area.")]
+        public override BindableNumber<float> InitialRadius { get; } = new BindableNumber<float>
+        {
+            MinValue = 0f,
+            MaxValue = 230f,
+            Default = 50f,
+            Value = 50f,
+            Precision = 5f
+        };
 
         public override Flashlight CreateFlashlight() => new ManiaFlashlight(ChangeRadius.Value, InitialRadius.Value);
 
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModFlashlight.cs b/osu.Game.Rulesets.Osu/Mods/OsuModFlashlight.cs
index f381d14ffe..e2a6d0f0dc 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModFlashlight.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModFlashlight.cs
@@ -20,14 +20,32 @@ namespace osu.Game.Rulesets.Osu.Mods
     {
         public override double ScoreMultiplier => 1.12;
 
-        public override bool DefaultComboDependency => true;
-
-        //private const float default_flashlight_size = 180;
-        public override float DefaultRadius => 180;
-
         private const double default_follow_delay = 120;
 
+        [SettingSource("Follow delay", "Milliseconds until the flashlight reaches the cursor")]
+        public BindableNumber<double> FollowDelay { get; } = new BindableDouble(default_follow_delay)
+        {
+            MinValue = default_follow_delay,
+            MaxValue = default_follow_delay * 10,
+            Precision = default_follow_delay,
+        };
 
+        [SettingSource("Change radius based on combo", "Decrease the flashlight radius as combo increases.")]
+        public override BindableBool ChangeRadius { get; } = new BindableBool
+        {
+            Default = true,
+            Value = true
+        };
+
+        [SettingSource("Initial radius", "Initial radius of the flashlight area.")]
+        public override BindableNumber<float> InitialRadius { get; } = new BindableNumber<float>
+        {
+            MinValue = 90f,
+            MaxValue = 360f,
+            Default = 180f,
+            Value = 180f,
+            Precision = 5f
+        };
 
         private OsuFlashlight flashlight;
 
@@ -39,14 +57,6 @@ namespace osu.Game.Rulesets.Osu.Mods
                 s.Tracking.ValueChanged += flashlight.OnSliderTrackingChange;
         }
 
-        [SettingSource("Follow delay", "Milliseconds until the flashlight reaches the cursor")]
-        public BindableNumber<double> FollowDelay { get; } = new BindableDouble(default_follow_delay)
-        {
-            MinValue = default_follow_delay,
-            MaxValue = default_follow_delay * 10,
-            Precision = default_follow_delay,
-        };
-
         private class OsuFlashlight : Flashlight, IRequireHighFrequencyMousePosition
         {
             public double FollowDelay { private get; set; }
diff --git a/osu.Game.Rulesets.Taiko/Mods/TaikoModFlashlight.cs b/osu.Game.Rulesets.Taiko/Mods/TaikoModFlashlight.cs
index 76f7c45b75..71c9d777ec 100644
--- a/osu.Game.Rulesets.Taiko/Mods/TaikoModFlashlight.cs
+++ b/osu.Game.Rulesets.Taiko/Mods/TaikoModFlashlight.cs
@@ -4,6 +4,7 @@
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Layout;
+using osu.Game.Configuration;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Taiko.Objects;
 using osu.Game.Rulesets.Taiko.UI;
@@ -16,10 +17,22 @@ namespace osu.Game.Rulesets.Taiko.Mods
     {
         public override double ScoreMultiplier => 1.12;
 
-        public override bool DefaultComboDependency => true;
+        [SettingSource("Change radius based on combo", "Decrease the flashlight radius as combo increases.")]
+        public override BindableBool ChangeRadius { get; } = new BindableBool
+        {
+            Default = true,
+            Value = true
+        };
 
-        //private const float default_flashlight_size = 250;
-        public override float DefaultRadius => 250;
+        [SettingSource("Initial radius", "Initial radius of the flashlight area.")]
+        public override BindableNumber<float> InitialRadius { get; } = new BindableNumber<float>
+        {
+            MinValue = 0f,
+            MaxValue = 400f,
+            Default = 250f,
+            Value = 250f,
+            Precision = 5f
+        };
 
         public override Flashlight CreateFlashlight() => new TaikoFlashlight(playfield, ChangeRadius.Value, InitialRadius.Value);
 
diff --git a/osu.Game/Rulesets/Mods/ModFlashlight.cs b/osu.Game/Rulesets/Mods/ModFlashlight.cs
index c218ab45fe..51006d96e8 100644
--- a/osu.Game/Rulesets/Mods/ModFlashlight.cs
+++ b/osu.Game/Rulesets/Mods/ModFlashlight.cs
@@ -34,26 +34,10 @@ namespace osu.Game.Rulesets.Mods
         public override string Description => "Restricted view area.";
 
         [SettingSource("Change radius based on combo", "Decrease the flashlight radius as combo increases.")]
-        public Bindable<bool> ChangeRadius { get; private set; }
+        public abstract BindableBool ChangeRadius { get; }
 
         [SettingSource("Initial radius", "Initial radius of the flashlight area.")]
-        public BindableNumber<float> InitialRadius { get; private set; }
-
-        public abstract float DefaultRadius { get; }
-
-        public abstract bool DefaultComboDependency { get; }
-
-        internal ModFlashlight()
-        {
-            InitialRadius = new BindableFloat(DefaultRadius)
-            {
-                MinValue = DefaultRadius * .5f,
-                MaxValue = DefaultRadius * 1.5f,
-                Precision = 5f,
-            };
-
-            ChangeRadius = new BindableBool(DefaultComboDependency);
-        }
+        public abstract BindableNumber<float> InitialRadius { get; }
     }
 
     public abstract class ModFlashlight<T> : ModFlashlight, IApplicableToDrawableRuleset<T>, IApplicableToScoreProcessor

From 735414bc49381df02d6fb243c25054ba8f35e204 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 22 Jan 2022 17:27:27 +0100
Subject: [PATCH 2404/5547] Replace `TimeSignatures` enum with struct for
 storage of arbitrary meter

---
 .../Skinning/Default/CirclePiece.cs           |  2 +-
 .../Formats/LegacyBeatmapDecoderTest.cs       |  6 +--
 .../NonVisual/BarLineGeneratorTest.cs         |  6 +--
 .../TestSceneNightcoreBeatContainer.cs        |  4 +-
 .../ControlPoints/TimingControlPoint.cs       |  4 +-
 .../Beatmaps/Formats/LegacyBeatmapDecoder.cs  |  4 +-
 .../Beatmaps/Formats/LegacyBeatmapEncoder.cs  |  2 +-
 osu.Game/Beatmaps/Timing/TimeSignature.cs     | 45 +++++++++++++++++++
 osu.Game/Beatmaps/Timing/TimeSignatures.cs    |  4 +-
 osu.Game/Rulesets/Mods/Metronome.cs           |  2 +-
 osu.Game/Rulesets/Mods/ModNightcore.cs        | 10 ++---
 osu.Game/Rulesets/Objects/BarLineGenerator.cs |  6 +--
 .../Timeline/TimelineTickDisplay.cs           |  2 +-
 .../RowAttributes/TimingRowAttribute.cs       |  2 +-
 osu.Game/Screens/Edit/Timing/TimingSection.cs | 11 +++--
 osu.Game/Screens/Menu/MenuSideFlashes.cs      |  4 +-
 osu.Game/Screens/Menu/OsuLogo.cs              |  2 +-
 17 files changed, 84 insertions(+), 32 deletions(-)
 create mode 100644 osu.Game/Beatmaps/Timing/TimeSignature.cs

diff --git a/osu.Game.Rulesets.Taiko/Skinning/Default/CirclePiece.cs b/osu.Game.Rulesets.Taiko/Skinning/Default/CirclePiece.cs
index 8ca996159b..a106c4f629 100644
--- a/osu.Game.Rulesets.Taiko/Skinning/Default/CirclePiece.cs
+++ b/osu.Game.Rulesets.Taiko/Skinning/Default/CirclePiece.cs
@@ -153,7 +153,7 @@ namespace osu.Game.Rulesets.Taiko.Skinning.Default
             if (!effectPoint.KiaiMode)
                 return;
 
-            if (beatIndex % (int)timingPoint.TimeSignature != 0)
+            if (beatIndex % timingPoint.TimeSignature.Numerator != 0)
                 return;
 
             double duration = timingPoint.BeatLength * 2;
diff --git a/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs b/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs
index 6ec14e6351..0459753b28 100644
--- a/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs
+++ b/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs
@@ -178,17 +178,17 @@ namespace osu.Game.Tests.Beatmaps.Formats
                 var timingPoint = controlPoints.TimingPointAt(0);
                 Assert.AreEqual(956, timingPoint.Time);
                 Assert.AreEqual(329.67032967033, timingPoint.BeatLength);
-                Assert.AreEqual(TimeSignatures.SimpleQuadruple, timingPoint.TimeSignature);
+                Assert.AreEqual(TimeSignature.SimpleQuadruple, timingPoint.TimeSignature);
 
                 timingPoint = controlPoints.TimingPointAt(48428);
                 Assert.AreEqual(956, timingPoint.Time);
                 Assert.AreEqual(329.67032967033d, timingPoint.BeatLength);
-                Assert.AreEqual(TimeSignatures.SimpleQuadruple, timingPoint.TimeSignature);
+                Assert.AreEqual(TimeSignature.SimpleQuadruple, timingPoint.TimeSignature);
 
                 timingPoint = controlPoints.TimingPointAt(119637);
                 Assert.AreEqual(119637, timingPoint.Time);
                 Assert.AreEqual(659.340659340659, timingPoint.BeatLength);
-                Assert.AreEqual(TimeSignatures.SimpleQuadruple, timingPoint.TimeSignature);
+                Assert.AreEqual(TimeSignature.SimpleQuadruple, timingPoint.TimeSignature);
 
                 var difficultyPoint = controlPoints.DifficultyPointAt(0);
                 Assert.AreEqual(0, difficultyPoint.Time);
diff --git a/osu.Game.Tests/NonVisual/BarLineGeneratorTest.cs b/osu.Game.Tests/NonVisual/BarLineGeneratorTest.cs
index 834c05fd08..6ae8231deb 100644
--- a/osu.Game.Tests/NonVisual/BarLineGeneratorTest.cs
+++ b/osu.Game.Tests/NonVisual/BarLineGeneratorTest.cs
@@ -26,7 +26,7 @@ namespace osu.Game.Tests.NonVisual
 
             const int beat_length_numerator = 2000;
             const int beat_length_denominator = 7;
-            const TimeSignatures signature = TimeSignatures.SimpleQuadruple;
+            TimeSignature signature = TimeSignature.SimpleQuadruple;
 
             var beatmap = new Beatmap
             {
@@ -49,7 +49,7 @@ namespace osu.Game.Tests.NonVisual
             for (int i = 0; i * beat_length_denominator < barLines.Count; i++)
             {
                 var barLine = barLines[i * beat_length_denominator];
-                int expectedTime = beat_length_numerator * (int)signature * i;
+                int expectedTime = beat_length_numerator * signature.Numerator * i;
 
                 // every seventh bar's start time should be at least greater than the whole number we expect.
                 // It cannot be less, as that can affect overlapping scroll algorithms
@@ -60,7 +60,7 @@ namespace osu.Game.Tests.NonVisual
                 Assert.IsTrue(Precision.AlmostEquals(barLine.StartTime, expectedTime));
 
                 // check major/minor lines for good measure too
-                Assert.AreEqual(i % (int)signature == 0, barLine.Major);
+                Assert.AreEqual(i % signature.Numerator == 0, barLine.Major);
             }
         }
 
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneNightcoreBeatContainer.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneNightcoreBeatContainer.cs
index 951ee1489d..759e4fa4ec 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneNightcoreBeatContainer.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneNightcoreBeatContainer.cs
@@ -24,8 +24,8 @@ namespace osu.Game.Tests.Visual.Gameplay
 
             Add(new ModNightcore<HitObject>.NightcoreBeatContainer());
 
-            AddStep("change signature to quadruple", () => Beatmap.Value.Beatmap.ControlPointInfo.TimingPoints.ForEach(p => p.TimeSignature = TimeSignatures.SimpleQuadruple));
-            AddStep("change signature to triple", () => Beatmap.Value.Beatmap.ControlPointInfo.TimingPoints.ForEach(p => p.TimeSignature = TimeSignatures.SimpleTriple));
+            AddStep("change signature to quadruple", () => Beatmap.Value.Beatmap.ControlPointInfo.TimingPoints.ForEach(p => p.TimeSignature = TimeSignature.SimpleQuadruple));
+            AddStep("change signature to triple", () => Beatmap.Value.Beatmap.ControlPointInfo.TimingPoints.ForEach(p => p.TimeSignature = TimeSignature.SimpleTriple));
         }
     }
 }
diff --git a/osu.Game/Beatmaps/ControlPoints/TimingControlPoint.cs b/osu.Game/Beatmaps/ControlPoints/TimingControlPoint.cs
index ec20328fab..922439fcb8 100644
--- a/osu.Game/Beatmaps/ControlPoints/TimingControlPoint.cs
+++ b/osu.Game/Beatmaps/ControlPoints/TimingControlPoint.cs
@@ -13,7 +13,7 @@ namespace osu.Game.Beatmaps.ControlPoints
         /// <summary>
         /// The time signature at this control point.
         /// </summary>
-        public readonly Bindable<TimeSignatures> TimeSignatureBindable = new Bindable<TimeSignatures>(TimeSignatures.SimpleQuadruple) { Default = TimeSignatures.SimpleQuadruple };
+        public readonly Bindable<TimeSignature> TimeSignatureBindable = new Bindable<TimeSignature>(TimeSignature.SimpleQuadruple);
 
         /// <summary>
         /// Default length of a beat in milliseconds. Used whenever there is no beatmap or track playing.
@@ -35,7 +35,7 @@ namespace osu.Game.Beatmaps.ControlPoints
         /// <summary>
         /// The time signature at this control point.
         /// </summary>
-        public TimeSignatures TimeSignature
+        public TimeSignature TimeSignature
         {
             get => TimeSignatureBindable.Value;
             set => TimeSignatureBindable.Value = value;
diff --git a/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs b/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
index 893eb8ab78..8f3f05aa9f 100644
--- a/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
+++ b/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
@@ -340,9 +340,9 @@ namespace osu.Game.Beatmaps.Formats
             double beatLength = Parsing.ParseDouble(split[1].Trim());
             double speedMultiplier = beatLength < 0 ? 100.0 / -beatLength : 1;
 
-            TimeSignatures timeSignature = TimeSignatures.SimpleQuadruple;
+            TimeSignature timeSignature = TimeSignature.SimpleQuadruple;
             if (split.Length >= 3)
-                timeSignature = split[2][0] == '0' ? TimeSignatures.SimpleQuadruple : (TimeSignatures)Parsing.ParseInt(split[2]);
+                timeSignature = split[2][0] == '0' ? TimeSignature.SimpleQuadruple : new TimeSignature(Parsing.ParseInt(split[2]));
 
             LegacySampleBank sampleSet = defaultSampleBank;
             if (split.Length >= 4)
diff --git a/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs b/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs
index ebdc882d2f..4cf6d3335f 100644
--- a/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs
+++ b/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs
@@ -227,7 +227,7 @@ namespace osu.Game.Beatmaps.Formats
                 if (effectPoint.OmitFirstBarLine)
                     effectFlags |= LegacyEffectFlags.OmitFirstBarLine;
 
-                writer.Write(FormattableString.Invariant($"{(int)legacyControlPoints.TimingPointAt(time).TimeSignature},"));
+                writer.Write(FormattableString.Invariant($"{legacyControlPoints.TimingPointAt(time).TimeSignature.Numerator},"));
                 writer.Write(FormattableString.Invariant($"{(int)toLegacySampleBank(tempHitSample.Bank)},"));
                 writer.Write(FormattableString.Invariant($"{toLegacyCustomSampleBank(tempHitSample)},"));
                 writer.Write(FormattableString.Invariant($"{tempHitSample.Volume},"));
diff --git a/osu.Game/Beatmaps/Timing/TimeSignature.cs b/osu.Game/Beatmaps/Timing/TimeSignature.cs
new file mode 100644
index 0000000000..5bfeea5e9b
--- /dev/null
+++ b/osu.Game/Beatmaps/Timing/TimeSignature.cs
@@ -0,0 +1,45 @@
+// 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.Beatmaps.Timing
+{
+    /// <summary>
+    /// Stores the time signature of a track.
+    /// For now, the lower numeral can only be 4; support for other denominators can be considered at a later date.
+    /// </summary>
+    public class TimeSignature : IEquatable<TimeSignature>
+    {
+        /// <summary>
+        /// The numerator of a signature.
+        /// </summary>
+        public int Numerator { get; }
+
+        // TODO: support time signatures with a denominator other than 4
+        // this in particular requires a new beatmap format.
+
+        public TimeSignature(int numerator)
+        {
+            if (numerator < 1)
+                throw new ArgumentOutOfRangeException(nameof(numerator), numerator, "The numerator of a time signature must be positive.");
+
+            Numerator = numerator;
+        }
+
+        public static TimeSignature SimpleTriple => new TimeSignature(3);
+        public static TimeSignature SimpleQuadruple => new TimeSignature(4);
+
+        public override string ToString() => $"{Numerator}/4";
+
+        public bool Equals(TimeSignature other)
+        {
+            if (ReferenceEquals(null, other)) return false;
+            if (ReferenceEquals(this, other)) return true;
+
+            return Numerator == other.Numerator;
+        }
+
+        public override int GetHashCode() => Numerator;
+    }
+}
diff --git a/osu.Game/Beatmaps/Timing/TimeSignatures.cs b/osu.Game/Beatmaps/Timing/TimeSignatures.cs
index 33e6342ae6..d783d3f9ec 100644
--- a/osu.Game/Beatmaps/Timing/TimeSignatures.cs
+++ b/osu.Game/Beatmaps/Timing/TimeSignatures.cs
@@ -1,11 +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 System.ComponentModel;
 
 namespace osu.Game.Beatmaps.Timing
 {
-    public enum TimeSignatures
+    [Obsolete("Use osu.Game.Beatmaps.Timing.TimeSignature instead.")]
+    public enum TimeSignatures // can be removed 20220722
     {
         [Description("4/4")]
         SimpleQuadruple = 4,
diff --git a/osu.Game/Rulesets/Mods/Metronome.cs b/osu.Game/Rulesets/Mods/Metronome.cs
index 8b6d86c45f..b85a341577 100644
--- a/osu.Game/Rulesets/Mods/Metronome.cs
+++ b/osu.Game/Rulesets/Mods/Metronome.cs
@@ -33,7 +33,7 @@ namespace osu.Game.Rulesets.Mods
 
             if (!IsBeatSyncedWithTrack) return;
 
-            int timeSignature = (int)timingPoint.TimeSignature;
+            int timeSignature = timingPoint.TimeSignature.Numerator;
 
             // play metronome from one measure before the first object.
             if (BeatSyncClock.CurrentTime < firstHitTime - timingPoint.BeatLength * timeSignature)
diff --git a/osu.Game/Rulesets/Mods/ModNightcore.cs b/osu.Game/Rulesets/Mods/ModNightcore.cs
index a44967c21c..993efead33 100644
--- a/osu.Game/Rulesets/Mods/ModNightcore.cs
+++ b/osu.Game/Rulesets/Mods/ModNightcore.cs
@@ -85,7 +85,7 @@ namespace osu.Game.Rulesets.Mods
             {
                 base.OnNewBeat(beatIndex, timingPoint, effectPoint, amplitudes);
 
-                int beatsPerBar = (int)timingPoint.TimeSignature;
+                int beatsPerBar = timingPoint.TimeSignature.Numerator;
                 int segmentLength = beatsPerBar * Divisor * bars_per_segment;
 
                 if (!IsBeatSyncedWithTrack)
@@ -102,14 +102,14 @@ namespace osu.Game.Rulesets.Mods
                     playBeatFor(beatIndex % segmentLength, timingPoint.TimeSignature);
             }
 
-            private void playBeatFor(int beatIndex, TimeSignatures signature)
+            private void playBeatFor(int beatIndex, TimeSignature signature)
             {
                 if (beatIndex == 0)
                     finishSample?.Play();
 
-                switch (signature)
+                switch (signature.Numerator)
                 {
-                    case TimeSignatures.SimpleTriple:
+                    case 3:
                         switch (beatIndex % 6)
                         {
                             case 0:
@@ -127,7 +127,7 @@ namespace osu.Game.Rulesets.Mods
 
                         break;
 
-                    case TimeSignatures.SimpleQuadruple:
+                    case 4:
                         switch (beatIndex % 4)
                         {
                             case 0:
diff --git a/osu.Game/Rulesets/Objects/BarLineGenerator.cs b/osu.Game/Rulesets/Objects/BarLineGenerator.cs
index e78aa5a5a0..d71a499119 100644
--- a/osu.Game/Rulesets/Objects/BarLineGenerator.cs
+++ b/osu.Game/Rulesets/Objects/BarLineGenerator.cs
@@ -41,9 +41,9 @@ namespace osu.Game.Rulesets.Objects
                 int currentBeat = 0;
 
                 // Stop on the beat before the next timing point, or if there is no next timing point stop slightly past the last object
-                double endTime = i < timingPoints.Count - 1 ? timingPoints[i + 1].Time - currentTimingPoint.BeatLength : lastHitTime + currentTimingPoint.BeatLength * (int)currentTimingPoint.TimeSignature;
+                double endTime = i < timingPoints.Count - 1 ? timingPoints[i + 1].Time - currentTimingPoint.BeatLength : lastHitTime + currentTimingPoint.BeatLength * currentTimingPoint.TimeSignature.Numerator;
 
-                double barLength = currentTimingPoint.BeatLength * (int)currentTimingPoint.TimeSignature;
+                double barLength = currentTimingPoint.BeatLength * currentTimingPoint.TimeSignature.Numerator;
 
                 for (double t = currentTimingPoint.Time; Precision.DefinitelyBigger(endTime, t); t += barLength, currentBeat++)
                 {
@@ -60,7 +60,7 @@ namespace osu.Game.Rulesets.Objects
                     BarLines.Add(new TBarLine
                     {
                         StartTime = t,
-                        Major = currentBeat % (int)currentTimingPoint.TimeSignature == 0
+                        Major = currentBeat % currentTimingPoint.TimeSignature.Numerator == 0
                     });
                 }
             }
diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineTickDisplay.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineTickDisplay.cs
index 1415014e59..cc4041394d 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineTickDisplay.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineTickDisplay.cs
@@ -125,7 +125,7 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
                         if (beat == 0 && i == 0)
                             nextMinTick = float.MinValue;
 
-                        int indexInBar = beat % ((int)point.TimeSignature * beatDivisor.Value);
+                        int indexInBar = beat % (point.TimeSignature.Numerator * beatDivisor.Value);
 
                         int divisor = BindableBeatDivisor.GetDivisorForBeatIndex(beat, beatDivisor.Value);
                         var colour = BindableBeatDivisor.GetColourFor(divisor, colours);
diff --git a/osu.Game/Screens/Edit/Timing/RowAttributes/TimingRowAttribute.cs b/osu.Game/Screens/Edit/Timing/RowAttributes/TimingRowAttribute.cs
index ab840e56a7..f8ec4aef25 100644
--- a/osu.Game/Screens/Edit/Timing/RowAttributes/TimingRowAttribute.cs
+++ b/osu.Game/Screens/Edit/Timing/RowAttributes/TimingRowAttribute.cs
@@ -13,7 +13,7 @@ namespace osu.Game.Screens.Edit.Timing.RowAttributes
     public class TimingRowAttribute : RowAttribute
     {
         private readonly BindableNumber<double> beatLength;
-        private readonly Bindable<TimeSignatures> timeSignature;
+        private readonly Bindable<TimeSignature> timeSignature;
         private OsuSpriteText text;
 
         public TimingRowAttribute(TimingControlPoint timing)
diff --git a/osu.Game/Screens/Edit/Timing/TimingSection.cs b/osu.Game/Screens/Edit/Timing/TimingSection.cs
index a0bb9ac506..e0b09ce980 100644
--- a/osu.Game/Screens/Edit/Timing/TimingSection.cs
+++ b/osu.Game/Screens/Edit/Timing/TimingSection.cs
@@ -15,7 +15,7 @@ namespace osu.Game.Screens.Edit.Timing
     internal class TimingSection : Section<TimingControlPoint>
     {
         private SettingsSlider<double> bpmSlider;
-        private SettingsEnumDropdown<TimeSignatures> timeSignature;
+        private SettingsDropdown<TimeSignature> timeSignature;
         private BPMTextBox bpmTextEntry;
 
         [BackgroundDependencyLoader]
@@ -25,9 +25,14 @@ namespace osu.Game.Screens.Edit.Timing
             {
                 bpmTextEntry = new BPMTextBox(),
                 bpmSlider = new BPMSlider(),
-                timeSignature = new SettingsEnumDropdown<TimeSignatures>
+                timeSignature = new SettingsDropdown<TimeSignature>
                 {
-                    LabelText = "Time Signature"
+                    LabelText = "Time Signature",
+                    Items = new[]
+                    {
+                        TimeSignature.SimpleTriple,
+                        TimeSignature.SimpleQuadruple
+                    }
                 },
             });
         }
diff --git a/osu.Game/Screens/Menu/MenuSideFlashes.cs b/osu.Game/Screens/Menu/MenuSideFlashes.cs
index bdcd3020f8..cd0c75c1a1 100644
--- a/osu.Game/Screens/Menu/MenuSideFlashes.cs
+++ b/osu.Game/Screens/Menu/MenuSideFlashes.cs
@@ -94,9 +94,9 @@ namespace osu.Game.Screens.Menu
             if (beatIndex < 0)
                 return;
 
-            if (effectPoint.KiaiMode ? beatIndex % 2 == 0 : beatIndex % (int)timingPoint.TimeSignature == 0)
+            if (effectPoint.KiaiMode ? beatIndex % 2 == 0 : beatIndex % timingPoint.TimeSignature.Numerator == 0)
                 flash(leftBox, timingPoint.BeatLength, effectPoint.KiaiMode, amplitudes);
-            if (effectPoint.KiaiMode ? beatIndex % 2 == 1 : beatIndex % (int)timingPoint.TimeSignature == 0)
+            if (effectPoint.KiaiMode ? beatIndex % 2 == 1 : beatIndex % timingPoint.TimeSignature.Numerator == 0)
                 flash(rightBox, timingPoint.BeatLength, effectPoint.KiaiMode, amplitudes);
         }
 
diff --git a/osu.Game/Screens/Menu/OsuLogo.cs b/osu.Game/Screens/Menu/OsuLogo.cs
index f9388097ac..c82efe2d32 100644
--- a/osu.Game/Screens/Menu/OsuLogo.cs
+++ b/osu.Game/Screens/Menu/OsuLogo.cs
@@ -282,7 +282,7 @@ namespace osu.Game.Screens.Menu
             {
                 this.Delay(early_activation).Schedule(() =>
                 {
-                    if (beatIndex % (int)timingPoint.TimeSignature == 0)
+                    if (beatIndex % timingPoint.TimeSignature.Numerator == 0)
                         sampleDownbeat.Play();
                     else
                         sampleBeat.Play();

From f39f2c93b52526a3e5d5aa06e18d0f0ac85020c6 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 22 Jan 2022 18:54:14 +0100
Subject: [PATCH 2405/5547] Add control for arbitrary-numerator time signatures

---
 .../Editing/TestSceneLabelledTimeSignature.cs | 88 ++++++++++++++++++
 .../Edit/Timing/LabelledTimeSignature.cs      | 93 +++++++++++++++++++
 2 files changed, 181 insertions(+)
 create mode 100644 osu.Game.Tests/Visual/Editing/TestSceneLabelledTimeSignature.cs
 create mode 100644 osu.Game/Screens/Edit/Timing/LabelledTimeSignature.cs

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneLabelledTimeSignature.cs b/osu.Game.Tests/Visual/Editing/TestSceneLabelledTimeSignature.cs
new file mode 100644
index 0000000000..cedbb5025f
--- /dev/null
+++ b/osu.Game.Tests/Visual/Editing/TestSceneLabelledTimeSignature.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 System.Linq;
+using NUnit.Framework;
+using osu.Framework.Graphics;
+using osu.Framework.Testing;
+using osu.Game.Beatmaps.Timing;
+using osu.Game.Graphics.UserInterface;
+using osu.Game.Screens.Edit.Timing;
+
+namespace osu.Game.Tests.Visual.Editing
+{
+    public class TestSceneLabelledTimeSignature : OsuManualInputManagerTestScene
+    {
+        private LabelledTimeSignature timeSignature;
+
+        private void createLabelledTimeSignature(TimeSignature initial) => AddStep("create labelled time signature", () =>
+        {
+            Child = timeSignature = new LabelledTimeSignature
+            {
+                Label = "Time Signature",
+                RelativeSizeAxes = Axes.None,
+                Width = 400,
+                Anchor = Anchor.Centre,
+                Origin = Anchor.Centre,
+                Current = { Value = initial }
+            };
+        });
+
+        private OsuTextBox numeratorTextBox => timeSignature.ChildrenOfType<OsuTextBox>().Single();
+
+        [Test]
+        public void TestInitialValue()
+        {
+            createLabelledTimeSignature(TimeSignature.SimpleTriple);
+            AddAssert("current is 3/4", () => timeSignature.Current.Value.Equals(TimeSignature.SimpleTriple));
+        }
+
+        [Test]
+        public void TestChangeViaCurrent()
+        {
+            createLabelledTimeSignature(TimeSignature.SimpleQuadruple);
+            AddAssert("current is 4/4", () => timeSignature.Current.Value.Equals(TimeSignature.SimpleQuadruple));
+
+            AddStep("set current to 5/4", () => timeSignature.Current.Value = new TimeSignature(5));
+
+            AddAssert("current is 5/4", () => timeSignature.Current.Value.Equals(new TimeSignature(5)));
+            AddAssert("numerator is 5", () => numeratorTextBox.Current.Value == "5");
+
+            AddStep("set current to 3/4", () => timeSignature.Current.Value = TimeSignature.SimpleTriple);
+
+            AddAssert("current is 3/4", () => timeSignature.Current.Value.Equals(TimeSignature.SimpleTriple));
+            AddAssert("numerator is 5", () => numeratorTextBox.Current.Value == "3");
+        }
+
+        [Test]
+        public void TestChangeNumerator()
+        {
+            createLabelledTimeSignature(TimeSignature.SimpleQuadruple);
+            AddAssert("current is 4/4", () => timeSignature.Current.Value.Equals(TimeSignature.SimpleQuadruple));
+
+            AddStep("focus text box", () => 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));
+            AddAssert("current is 7/4", () => timeSignature.Current.Value.Equals(new TimeSignature(7)));
+        }
+
+        [Test]
+        public void TestInvalidChangeRollbackOnCommit()
+        {
+            createLabelledTimeSignature(TimeSignature.SimpleQuadruple);
+            AddAssert("current is 4/4", () => timeSignature.Current.Value.Equals(TimeSignature.SimpleQuadruple));
+
+            AddStep("focus text box", () => 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));
+            AddAssert("current is 4/4", () => timeSignature.Current.Value.Equals(TimeSignature.SimpleQuadruple));
+            AddAssert("numerator is 4", () => numeratorTextBox.Current.Value == "4");
+        }
+    }
+}
diff --git a/osu.Game/Screens/Edit/Timing/LabelledTimeSignature.cs b/osu.Game/Screens/Edit/Timing/LabelledTimeSignature.cs
new file mode 100644
index 0000000000..52aece75ad
--- /dev/null
+++ b/osu.Game/Screens/Edit/Timing/LabelledTimeSignature.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.Framework.Allocation;
+using osu.Framework.Bindables;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.UserInterface;
+using osu.Game.Beatmaps.Timing;
+using osu.Game.Graphics;
+using osu.Game.Graphics.Sprites;
+using osu.Game.Graphics.UserInterface;
+using osu.Game.Graphics.UserInterfaceV2;
+
+namespace osu.Game.Screens.Edit.Timing
+{
+    internal class LabelledTimeSignature : LabelledComponent<LabelledTimeSignature.TimeSignatureBox, TimeSignature>
+    {
+        public LabelledTimeSignature()
+            : base(false)
+        {
+        }
+
+        protected override TimeSignatureBox CreateComponent() => new TimeSignatureBox();
+
+        internal class TimeSignatureBox : CompositeDrawable, IHasCurrentValue<TimeSignature>
+        {
+            private readonly BindableWithCurrent<TimeSignature> current = new BindableWithCurrent<TimeSignature>(TimeSignature.SimpleQuadruple);
+
+            public Bindable<TimeSignature> Current
+            {
+                get => current.Current;
+                set => current.Current = value;
+            }
+
+            private OsuNumberBox numeratorBox;
+
+            [BackgroundDependencyLoader]
+            private void load()
+            {
+                AutoSizeAxes = Axes.Both;
+                InternalChild = new FillFlowContainer
+                {
+                    AutoSizeAxes = Axes.Both,
+                    Direction = FillDirection.Horizontal,
+                    Children = new Drawable[]
+                    {
+                        numeratorBox = new OsuNumberBox
+                        {
+                            Width = 40,
+                            Anchor = Anchor.CentreLeft,
+                            Origin = Anchor.CentreLeft,
+                            CornerRadius = CORNER_RADIUS,
+                            CommitOnFocusLost = true
+                        },
+                        new OsuSpriteText
+                        {
+                            Anchor = Anchor.CentreLeft,
+                            Origin = Anchor.CentreLeft,
+                            Margin = new MarginPadding(10),
+                            Text = "/4",
+                            Font = OsuFont.Default.With(size: 20)
+                        }
+                    }
+                };
+            }
+
+            protected override void LoadComplete()
+            {
+                base.LoadComplete();
+
+                Current.BindValueChanged(_ => updateFromCurrent(), true);
+                numeratorBox.OnCommit += (_, __) => updateFromNumeratorBox();
+            }
+
+            private void updateFromCurrent()
+            {
+                numeratorBox.Current.Value = Current.Value.Numerator.ToString();
+            }
+
+            private void updateFromNumeratorBox()
+            {
+                if (int.TryParse(numeratorBox.Current.Value, out int numerator) && numerator > 0)
+                    Current.Value = new TimeSignature(numerator);
+                else
+                {
+                    // trigger `Current` change to restore the numerator box's text to a valid value.
+                    Current.TriggerChange();
+                }
+            }
+        }
+    }
+}

From 54f7b1b8d0cec1638c67492fadf7c7fca8577f5b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 22 Jan 2022 18:54:28 +0100
Subject: [PATCH 2406/5547] Use new time signature control on timing screen

---
 osu.Game/Screens/Edit/Timing/TimingSection.cs | 14 ++++----------
 1 file changed, 4 insertions(+), 10 deletions(-)

diff --git a/osu.Game/Screens/Edit/Timing/TimingSection.cs b/osu.Game/Screens/Edit/Timing/TimingSection.cs
index e0b09ce980..cd0b56d338 100644
--- a/osu.Game/Screens/Edit/Timing/TimingSection.cs
+++ b/osu.Game/Screens/Edit/Timing/TimingSection.cs
@@ -6,7 +6,6 @@ using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Game.Beatmaps.ControlPoints;
-using osu.Game.Beatmaps.Timing;
 using osu.Game.Graphics.UserInterfaceV2;
 using osu.Game.Overlays.Settings;
 
@@ -15,7 +14,7 @@ namespace osu.Game.Screens.Edit.Timing
     internal class TimingSection : Section<TimingControlPoint>
     {
         private SettingsSlider<double> bpmSlider;
-        private SettingsDropdown<TimeSignature> timeSignature;
+        private LabelledTimeSignature timeSignature;
         private BPMTextBox bpmTextEntry;
 
         [BackgroundDependencyLoader]
@@ -25,15 +24,10 @@ namespace osu.Game.Screens.Edit.Timing
             {
                 bpmTextEntry = new BPMTextBox(),
                 bpmSlider = new BPMSlider(),
-                timeSignature = new SettingsDropdown<TimeSignature>
+                timeSignature = new LabelledTimeSignature
                 {
-                    LabelText = "Time Signature",
-                    Items = new[]
-                    {
-                        TimeSignature.SimpleTriple,
-                        TimeSignature.SimpleQuadruple
-                    }
-                },
+                    Label = "Time Signature"
+                }
             });
         }
 

From 62a2bccd7655f78a66d74a7d77d4dec73f311c3a Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 21 Jan 2022 17:41:45 +0300
Subject: [PATCH 2407/5547] Abstractify expansion logic from
 `ExpandingButtonContainer`

---
 osu.Game/Overlays/ExpandingButtonContainer.cs | 136 ++----------------
 .../Overlays/ExpandingControlContainer.cs     | 124 ++++++++++++++++
 osu.Game/Overlays/IExpandingContainer.cs      |  16 +++
 osu.Game/Overlays/SettingsPanel.cs            |   2 +-
 4 files changed, 150 insertions(+), 128 deletions(-)
 create mode 100644 osu.Game/Overlays/ExpandingControlContainer.cs
 create mode 100644 osu.Game/Overlays/IExpandingContainer.cs

diff --git a/osu.Game/Overlays/ExpandingButtonContainer.cs b/osu.Game/Overlays/ExpandingButtonContainer.cs
index 4eb8c47a1f..d7ff285707 100644
--- a/osu.Game/Overlays/ExpandingButtonContainer.cs
+++ b/osu.Game/Overlays/ExpandingButtonContainer.cs
@@ -1,141 +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 System;
-using System.Linq;
-using osu.Framework;
-using osu.Framework.Graphics;
-using osu.Framework.Graphics.Containers;
-using osu.Framework.Input.Events;
-using osu.Framework.Testing;
-using osu.Framework.Threading;
-using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.UserInterface;
-using osuTK;
 
 namespace osu.Game.Overlays
 {
-    public abstract class ExpandingButtonContainer : Container, IStateful<ExpandedState>
+    /// <summary>
+    /// An <see cref="ExpandingControlContainer{TControl}"/> with a long hover expansion delay for buttons.
+    /// </summary>
+    /// <remarks>
+    /// Mostly used for buttons with explanatory labels, in which the label would display after a "long hover".
+    /// </remarks>
+    public class ExpandingButtonContainer : ExpandingControlContainer<OsuButton>
     {
-        private readonly float contractedWidth;
-        private readonly float expandedWidth;
-
-        public event Action<ExpandedState> StateChanged;
-
-        protected override Container<Drawable> Content => FillFlow;
-
-        protected FillFlowContainer FillFlow { get; }
-
         protected ExpandingButtonContainer(float contractedWidth, float expandedWidth)
+            : base(contractedWidth, expandedWidth)
         {
-            this.contractedWidth = contractedWidth;
-            this.expandedWidth = expandedWidth;
-
-            RelativeSizeAxes = Axes.Y;
-            Width = contractedWidth;
-
-            InternalChildren = new Drawable[]
-            {
-                new SidebarScrollContainer
-                {
-                    Children = new[]
-                    {
-                        FillFlow = new FillFlowContainer
-                        {
-                            Origin = Anchor.CentreLeft,
-                            Anchor = Anchor.CentreLeft,
-                            AutoSizeAxes = Axes.Y,
-                            RelativeSizeAxes = Axes.X,
-                            Direction = FillDirection.Vertical,
-                        }
-                    }
-                },
-            };
         }
 
-        private ScheduledDelegate expandEvent;
-        private ExpandedState state;
-
-        protected override bool OnHover(HoverEvent e)
-        {
-            queueExpandIfHovering();
-            return true;
-        }
-
-        protected override void OnHoverLost(HoverLostEvent e)
-        {
-            expandEvent?.Cancel();
-            hoveredButton = null;
-            State = ExpandedState.Contracted;
-
-            base.OnHoverLost(e);
-        }
-
-        protected override bool OnMouseMove(MouseMoveEvent e)
-        {
-            queueExpandIfHovering();
-            return base.OnMouseMove(e);
-        }
-
-        private class SidebarScrollContainer : OsuScrollContainer
-        {
-            public SidebarScrollContainer()
-            {
-                RelativeSizeAxes = Axes.Both;
-                ScrollbarVisible = false;
-            }
-        }
-
-        public ExpandedState State
-        {
-            get => state;
-            set
-            {
-                expandEvent?.Cancel();
-
-                if (state == value) return;
-
-                state = value;
-
-                switch (state)
-                {
-                    default:
-                        this.ResizeTo(new Vector2(contractedWidth, Height), 500, Easing.OutQuint);
-                        break;
-
-                    case ExpandedState.Expanded:
-                        this.ResizeTo(new Vector2(expandedWidth, Height), 500, Easing.OutQuint);
-                        break;
-                }
-
-                StateChanged?.Invoke(State);
-            }
-        }
-
-        private Drawable hoveredButton;
-
-        private void queueExpandIfHovering()
-        {
-            // if the same button is hovered, let the scheduled expand play out..
-            if (hoveredButton?.IsHovered == true)
-                return;
-
-            // ..otherwise check whether a new button is hovered, and if so, queue a new hover operation.
-
-            // usually we wouldn't use ChildrenOfType in implementations, but this is the simplest way
-            // to handle cases like the editor where the buttons may be nested within a child hierarchy.
-            hoveredButton = FillFlow.ChildrenOfType<OsuButton>().FirstOrDefault(c => c.IsHovered);
-
-            expandEvent?.Cancel();
-
-            if (hoveredButton?.IsHovered == true && State != ExpandedState.Expanded)
-                expandEvent = Scheduler.AddDelayed(() => State = ExpandedState.Expanded, 750);
-        }
-    }
-
-    public enum ExpandedState
-    {
-        Contracted,
-        Expanded,
+        protected override double HoverExpansionDelay => 750;
     }
 }
diff --git a/osu.Game/Overlays/ExpandingControlContainer.cs b/osu.Game/Overlays/ExpandingControlContainer.cs
new file mode 100644
index 0000000000..8e02cab923
--- /dev/null
+++ b/osu.Game/Overlays/ExpandingControlContainer.cs
@@ -0,0 +1,124 @@
+// 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.Bindables;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
+using osu.Framework.Input.Events;
+using osu.Framework.Testing;
+using osu.Framework.Threading;
+using osu.Game.Graphics.Containers;
+using osu.Game.Overlays.Settings;
+
+namespace osu.Game.Overlays
+{
+    /// <summary>
+    /// Represents a <see cref="Container"/> with the ability to expand/contract when hovering the controls within it.
+    /// </summary>
+    /// <typeparam name="TControl">The type of UI control to lookup for hover expansion.</typeparam>
+    public class ExpandingControlContainer<TControl> : Container, IExpandingContainer
+        where TControl : class, IDrawable
+    {
+        private readonly float contractedWidth;
+        private readonly float expandedWidth;
+
+        public BindableBool Expanded { get; } = new BindableBool();
+
+        /// <summary>
+        /// Delay before the container switches to expanded state from hover.
+        /// </summary>
+        protected virtual double HoverExpansionDelay => 0;
+
+        protected override Container<Drawable> Content => FillFlow;
+
+        protected FillFlowContainer FillFlow { get; }
+
+        protected ExpandingControlContainer(float contractedWidth, float expandedWidth)
+        {
+            this.contractedWidth = contractedWidth;
+            this.expandedWidth = expandedWidth;
+
+            RelativeSizeAxes = Axes.Y;
+            Width = contractedWidth;
+
+            InternalChild = new OsuScrollContainer
+            {
+                RelativeSizeAxes = Axes.Both,
+                ScrollbarVisible = false,
+                Child = FillFlow = new FillFlowContainer
+                {
+                    Origin = Anchor.CentreLeft,
+                    Anchor = Anchor.CentreLeft,
+                    RelativeSizeAxes = Axes.X,
+                    AutoSizeAxes = Axes.Y,
+                    Direction = FillDirection.Vertical,
+                },
+            };
+        }
+
+        private ScheduledDelegate hoverExpandEvent;
+        private TControl activeControl;
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            Expanded.BindValueChanged(v =>
+            {
+                this.ResizeWidthTo(v.NewValue ? expandedWidth : contractedWidth, 500, Easing.OutQuint);
+            }, true);
+        }
+
+        protected override void Update()
+        {
+            base.Update();
+
+            // if the container was expanded from hovering over a control, we have to check per-frame whether we can contract it back.
+            // that's because contracting the container depends not only on whether it's no longer hovered,
+            // but also on whether the hovered control is no longer in a dragged state (if it was).
+            if (hoverExpandEvent != null && !IsHovered && (activeControl == null || !isControlActive(activeControl)))
+            {
+                hoverExpandEvent?.Cancel();
+
+                Expanded.Value = false;
+                hoverExpandEvent = null;
+                activeControl = null;
+            }
+        }
+
+        protected override bool OnHover(HoverEvent e)
+        {
+            queueExpandIfHovering();
+            return true;
+        }
+
+        protected override bool OnMouseMove(MouseMoveEvent e)
+        {
+            queueExpandIfHovering();
+            return base.OnMouseMove(e);
+        }
+
+        private void queueExpandIfHovering()
+        {
+            // if the same control is hovered or dragged, let the scheduled expand play out..
+            if (activeControl != null && isControlActive(activeControl))
+                return;
+
+            // ..otherwise check whether a new control is hovered, and if so, queue a new hover operation.
+            hoverExpandEvent?.Cancel();
+
+            // usually we wouldn't use ChildrenOfType in implementations, but this is the simplest way
+            // to handle cases like the editor where the controls may be nested within a child hierarchy.
+            activeControl = FillFlow.ChildrenOfType<TControl>().FirstOrDefault(isControlActive);
+
+            if (activeControl != null && !Expanded.Value)
+                hoverExpandEvent = Scheduler.AddDelayed(() => Expanded.Value = true, HoverExpansionDelay);
+        }
+
+        /// <summary>
+        /// Whether the given control is currently active, by checking whether it's hovered or dragged.
+        /// </summary>
+        private bool isControlActive(TControl control) => control.IsHovered || control.IsDragged;
+    }
+}
diff --git a/osu.Game/Overlays/IExpandingContainer.cs b/osu.Game/Overlays/IExpandingContainer.cs
new file mode 100644
index 0000000000..ec5f0c90f4
--- /dev/null
+++ b/osu.Game/Overlays/IExpandingContainer.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 osu.Framework.Allocation;
+using osu.Framework.Graphics.Containers;
+
+namespace osu.Game.Overlays
+{
+    /// <summary>
+    /// A target expanding container that should be resolved by children <see cref="IExpandable"/>s to propagate state changes.
+    /// </summary>
+    [Cached(typeof(IExpandingContainer))]
+    public interface IExpandingContainer : IContainer, IExpandable
+    {
+    }
+}
diff --git a/osu.Game/Overlays/SettingsPanel.cs b/osu.Game/Overlays/SettingsPanel.cs
index ba7118cffe..b11b6fde27 100644
--- a/osu.Game/Overlays/SettingsPanel.cs
+++ b/osu.Game/Overlays/SettingsPanel.cs
@@ -265,7 +265,7 @@ namespace osu.Game.Overlays
                             return;
 
                         SectionsContainer.ScrollTo(section);
-                        Sidebar.State = ExpandedState.Contracted;
+                        Sidebar.Expanded.Value = false;
                     },
                 };
             }

From 326f12f8477da2838a368e921329d1ee726e4c44 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 21 Jan 2022 17:43:05 +0300
Subject: [PATCH 2408/5547] Add `IExpandable` support for
 `SettingsToolboxGroup`

---
 osu.Game/Overlays/SettingsToolboxGroup.cs     | 80 +++++++++++--------
 .../Screens/Play/HUD/PlayerSettingsOverlay.cs |  2 +-
 2 files changed, 49 insertions(+), 33 deletions(-)

diff --git a/osu.Game/Overlays/SettingsToolboxGroup.cs b/osu.Game/Overlays/SettingsToolboxGroup.cs
index ca0980a9c9..9e7223df9d 100644
--- a/osu.Game/Overlays/SettingsToolboxGroup.cs
+++ b/osu.Game/Overlays/SettingsToolboxGroup.cs
@@ -2,6 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using osu.Framework.Allocation;
+using osu.Framework.Bindables;
 using osu.Framework.Caching;
 using osu.Framework.Extensions.EnumExtensions;
 using osu.Framework.Graphics;
@@ -18,7 +19,7 @@ using osuTK.Graphics;
 
 namespace osu.Game.Overlays
 {
-    public abstract class SettingsToolboxGroup : Container
+    public class SettingsToolboxGroup : Container, IExpandable
     {
         private const float transition_duration = 250;
         private const int container_width = 270;
@@ -34,30 +35,7 @@ namespace osu.Game.Overlays
         private readonly FillFlowContainer content;
         private readonly IconButton button;
 
-        private bool expanded = true;
-
-        public bool Expanded
-        {
-            get => expanded;
-            set
-            {
-                if (expanded == value) return;
-
-                expanded = value;
-
-                content.ClearTransforms();
-
-                if (expanded)
-                    content.AutoSizeAxes = Axes.Y;
-                else
-                {
-                    content.AutoSizeAxes = Axes.None;
-                    content.ResizeHeightTo(0, transition_duration, Easing.OutQuint);
-                }
-
-                updateExpanded();
-            }
-        }
+        public BindableBool Expanded { get; } = new BindableBool(true);
 
         private Color4 expandedColour;
 
@@ -67,7 +45,7 @@ namespace osu.Game.Overlays
         /// Create a new instance.
         /// </summary>
         /// <param name="title">The title to be displayed in the header of this group.</param>
-        protected SettingsToolboxGroup(string title)
+        public SettingsToolboxGroup(string title)
         {
             AutoSizeAxes = Axes.Y;
             Width = container_width;
@@ -115,7 +93,7 @@ namespace osu.Game.Overlays
                                     Position = new Vector2(-15, 0),
                                     Icon = FontAwesome.Solid.Bars,
                                     Scale = new Vector2(0.75f),
-                                    Action = () => Expanded = !Expanded,
+                                    Action = () => Expanded.Toggle(),
                                 },
                             }
                         },
@@ -155,23 +133,58 @@ namespace osu.Game.Overlays
                 headerText.FadeTo(headerText.DrawWidth < DrawWidth ? 1 : 0, 150, Easing.OutQuint);
         }
 
+        [Resolved(canBeNull: true)]
+        private IExpandingContainer expandingContainer { get; set; }
+
+        private bool expandedByContainer;
+
         protected override void LoadComplete()
         {
             base.LoadComplete();
 
-            this.Delay(600).FadeTo(inactive_alpha, fade_duration, Easing.OutQuint);
-            updateExpanded();
+            expandingContainer?.Expanded.BindValueChanged(containerExpanded =>
+            {
+                if (containerExpanded.NewValue && !Expanded.Value)
+                {
+                    Expanded.Value = true;
+                    expandedByContainer = true;
+                }
+                else if (!containerExpanded.NewValue && expandedByContainer)
+                {
+                    Expanded.Value = false;
+                    expandedByContainer = false;
+                }
+
+                updateActiveState();
+            }, true);
+
+            Expanded.BindValueChanged(v =>
+            {
+                content.ClearTransforms();
+
+                if (v.NewValue)
+                    content.AutoSizeAxes = Axes.Y;
+                else
+                {
+                    content.AutoSizeAxes = Axes.None;
+                    content.ResizeHeightTo(0, transition_duration, Easing.OutQuint);
+                }
+
+                button.FadeColour(Expanded.Value ? expandedColour : Color4.White, 200, Easing.InOutQuint);
+            }, true);
+
+            this.Delay(600).Schedule(updateActiveState);
         }
 
         protected override bool OnHover(HoverEvent e)
         {
-            this.FadeIn(fade_duration, Easing.OutQuint);
+            updateActiveState();
             return false;
         }
 
         protected override void OnHoverLost(HoverLostEvent e)
         {
-            this.FadeTo(inactive_alpha, fade_duration, Easing.OutQuint);
+            updateActiveState();
             base.OnHoverLost(e);
         }
 
@@ -181,7 +194,10 @@ namespace osu.Game.Overlays
             expandedColour = colours.Yellow;
         }
 
-        private void updateExpanded() => button.FadeColour(expanded ? expandedColour : Color4.White, 200, Easing.InOutQuint);
+        private void updateActiveState()
+        {
+            this.FadeTo(IsHovered || expandingContainer?.Expanded.Value == true ? 1 : inactive_alpha, fade_duration, Easing.OutQuint);
+        }
 
         protected override Container<Drawable> Content => content;
 
diff --git a/osu.Game/Screens/Play/HUD/PlayerSettingsOverlay.cs b/osu.Game/Screens/Play/HUD/PlayerSettingsOverlay.cs
index ffcbb06fb3..807b4989c7 100644
--- a/osu.Game/Screens/Play/HUD/PlayerSettingsOverlay.cs
+++ b/osu.Game/Screens/Play/HUD/PlayerSettingsOverlay.cs
@@ -40,7 +40,7 @@ namespace osu.Game.Screens.Play.HUD
                     //CollectionSettings = new CollectionSettings(),
                     //DiscussionSettings = new DiscussionSettings(),
                     PlaybackSettings = new PlaybackSettings(),
-                    VisualSettings = new VisualSettings { Expanded = false }
+                    VisualSettings = new VisualSettings { Expanded = { Value = false } }
                 }
             };
         }

From f4c7a332c343b1d23df835914150fe85992ef7ee Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 21 Jan 2022 17:45:08 +0300
Subject: [PATCH 2409/5547] Add `IExpandable` support for `SettingsItem<T>`

---
 osu.Game/Overlays/Settings/ISettingsItem.cs |  9 +-
 osu.Game/Overlays/Settings/SettingsItem.cs  | 91 ++++++++++++++++-----
 2 files changed, 78 insertions(+), 22 deletions(-)

diff --git a/osu.Game/Overlays/Settings/ISettingsItem.cs b/osu.Game/Overlays/Settings/ISettingsItem.cs
index e7afa48502..fe21f0664a 100644
--- a/osu.Game/Overlays/Settings/ISettingsItem.cs
+++ b/osu.Game/Overlays/Settings/ISettingsItem.cs
@@ -2,12 +2,17 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
-using osu.Framework.Graphics;
 
 namespace osu.Game.Overlays.Settings
 {
-    public interface ISettingsItem : IDrawable, IDisposable
+    /// <summary>
+    /// A non-generic interface for <see cref="SettingsItem{T}"/>s.
+    /// </summary>
+    public interface ISettingsItem : IExpandable, IDisposable
     {
+        /// <summary>
+        /// Invoked when the setting value has changed.
+        /// </summary>
         event Action SettingChanged;
     }
 }
diff --git a/osu.Game/Overlays/Settings/SettingsItem.cs b/osu.Game/Overlays/Settings/SettingsItem.cs
index e709be1343..cc8d5b36d0 100644
--- a/osu.Game/Overlays/Settings/SettingsItem.cs
+++ b/osu.Game/Overlays/Settings/SettingsItem.cs
@@ -30,7 +30,7 @@ namespace osu.Game.Overlays.Settings
 
         protected readonly FillFlowContainer FlowContent;
 
-        private SpriteText labelText;
+        private SpriteText label;
 
         private OsuTextFlowContainer warningText;
 
@@ -42,21 +42,34 @@ namespace osu.Game.Overlays.Settings
         [Resolved]
         private OsuColour colours { get; set; }
 
+        private LocalisableString labelText;
+
         public virtual LocalisableString LabelText
         {
-            get => labelText?.Text ?? string.Empty;
+            get => labelText;
             set
             {
-                if (labelText == null)
-                {
-                    // construct lazily for cases where the label is not needed (may be provided by the Control).
-                    FlowContent.Insert(-1, labelText = new OsuSpriteText());
+                ensureLabelCreated();
 
-                    updateDisabled();
-                }
+                labelText = value;
+                updateLabelText();
+            }
+        }
 
-                labelText.Text = value;
-                updateLayout();
+        private LocalisableString? contractedLabelText;
+
+        /// <summary>
+        /// Text to be displayed in place of <see cref="LabelText"/> when this <see cref="SettingsItem{T}"/> is in a contracted state.
+        /// </summary>
+        public LocalisableString? ContractedLabelText
+        {
+            get => contractedLabelText;
+            set
+            {
+                ensureLabelCreated();
+
+                contractedLabelText = value;
+                updateLabelText();
             }
         }
 
@@ -90,6 +103,10 @@ namespace osu.Game.Overlays.Settings
             set => controlWithCurrent.Current = value;
         }
 
+        public BindableBool Expanded { get; } = new BindableBool(true);
+
+        public event Action SettingChanged;
+
         public virtual IEnumerable<string> FilterTerms => Keywords == null ? new[] { LabelText.ToString() } : new List<string>(Keywords) { LabelText.ToString() }.ToArray();
 
         public IEnumerable<string> Keywords { get; set; }
@@ -101,8 +118,6 @@ namespace osu.Game.Overlays.Settings
 
         public bool FilteringActive { get; set; }
 
-        public event Action SettingChanged;
-
         protected SettingsItem()
         {
             RelativeSizeAxes = Axes.X;
@@ -151,23 +166,59 @@ namespace osu.Game.Overlays.Settings
                     Anchor = Anchor.Centre,
                     Origin = Anchor.Centre
                 });
-                updateLayout();
             }
         }
 
-        private void updateLayout()
-        {
-            bool hasLabel = labelText != null && !string.IsNullOrEmpty(labelText.Text.ToString());
+        [Resolved(canBeNull: true)]
+        private IExpandingContainer expandingContainer { get; set; }
 
-            // if the settings item is providing a label, the default value indicator should be centred vertically to the left of the label.
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            expandingContainer?.Expanded.BindValueChanged(containerExpanded => Expanded.Value = containerExpanded.NewValue, true);
+
+            Expanded.BindValueChanged(v =>
+            {
+                updateLabelText();
+
+                Control.FadeTo(v.NewValue ? 1 : 0, 500, Easing.OutQuint);
+                Control.BypassAutoSizeAxes = v.NewValue ? Axes.None : Axes.Both;
+            }, true);
+
+            FinishTransforms(true);
+        }
+
+        private void ensureLabelCreated()
+        {
+            if (label != null)
+                return;
+
+            // construct lazily for cases where the label is not needed (may be provided by the Control).
+            FlowContent.Insert(-1, label = new OsuSpriteText());
+
+            updateDisabled();
+        }
+
+        private void updateLabelText()
+        {
+            if (label != null)
+            {
+                if (contractedLabelText is LocalisableString contractedText)
+                    label.Text = Expanded.Value ? labelText : contractedText;
+                else
+                    label.Text = labelText;
+            }
+
+            // if the settings item is providing a non-empty label, the default value indicator should be centred vertically to the left of the label.
             // otherwise, it should be centred vertically to the left of the main control of the settings item.
-            defaultValueIndicatorContainer.Height = hasLabel ? labelText.DrawHeight : Control.DrawHeight;
+            defaultValueIndicatorContainer.Height = !string.IsNullOrEmpty(label?.Text.ToString()) ? label.DrawHeight : Control.DrawHeight;
         }
 
         private void updateDisabled()
         {
-            if (labelText != null)
-                labelText.Alpha = controlWithCurrent.Current.Disabled ? 0.3f : 1;
+            if (label != null)
+                label.Alpha = controlWithCurrent.Current.Disabled ? 0.3f : 1;
         }
     }
 }

From 648e7f6bbc4883d591ed7c01994f511006caa770 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 21 Jan 2022 17:47:11 +0300
Subject: [PATCH 2410/5547] Handle controls with dragging state wrapped in
 underlying components

I'm not 100% sure about this approach but it'll do for now.
---
 osu.Game/Overlays/ExpandingControlContainer.cs | 2 +-
 osu.Game/Overlays/Settings/ISettingsItem.cs    | 5 +++++
 osu.Game/Overlays/Settings/SettingsItem.cs     | 2 ++
 3 files changed, 8 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/ExpandingControlContainer.cs b/osu.Game/Overlays/ExpandingControlContainer.cs
index 8e02cab923..2accd63fb9 100644
--- a/osu.Game/Overlays/ExpandingControlContainer.cs
+++ b/osu.Game/Overlays/ExpandingControlContainer.cs
@@ -119,6 +119,6 @@ namespace osu.Game.Overlays
         /// <summary>
         /// Whether the given control is currently active, by checking whether it's hovered or dragged.
         /// </summary>
-        private bool isControlActive(TControl control) => control.IsHovered || control.IsDragged;
+        private bool isControlActive(TControl control) => control.IsHovered || control.IsDragged || (control is ISettingsItem item && item.IsControlDragged);
     }
 }
diff --git a/osu.Game/Overlays/Settings/ISettingsItem.cs b/osu.Game/Overlays/Settings/ISettingsItem.cs
index fe21f0664a..20e2f48f96 100644
--- a/osu.Game/Overlays/Settings/ISettingsItem.cs
+++ b/osu.Game/Overlays/Settings/ISettingsItem.cs
@@ -14,5 +14,10 @@ namespace osu.Game.Overlays.Settings
         /// Invoked when the setting value has changed.
         /// </summary>
         event Action SettingChanged;
+
+        /// <summary>
+        /// Returns whether the UI control is currently in a dragged state.
+        /// </summary>
+        bool IsControlDragged { get; }
     }
 }
diff --git a/osu.Game/Overlays/Settings/SettingsItem.cs b/osu.Game/Overlays/Settings/SettingsItem.cs
index cc8d5b36d0..29980dc5a8 100644
--- a/osu.Game/Overlays/Settings/SettingsItem.cs
+++ b/osu.Game/Overlays/Settings/SettingsItem.cs
@@ -105,6 +105,8 @@ namespace osu.Game.Overlays.Settings
 
         public BindableBool Expanded { get; } = new BindableBool(true);
 
+        public bool IsControlDragged => Control.IsDragged;
+
         public event Action SettingChanged;
 
         public virtual IEnumerable<string> FilterTerms => Keywords == null ? new[] { LabelText.ToString() } : new List<string>(Keywords) { LabelText.ToString() }.ToArray();

From 6b35c0fe01795d664fc3599085a4ec2aa17d614d Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 21 Jan 2022 18:39:58 +0300
Subject: [PATCH 2411/5547] Add test scene for `ExpandingControlContainer`

---
 .../TestSceneExpandingControlContainer.cs     | 183 ++++++++++++++++++
 1 file changed, 183 insertions(+)
 create mode 100644 osu.Game.Tests/Visual/UserInterface/TestSceneExpandingControlContainer.cs

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneExpandingControlContainer.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneExpandingControlContainer.cs
new file mode 100644
index 0000000000..d75089ceac
--- /dev/null
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneExpandingControlContainer.cs
@@ -0,0 +1,183 @@
+// 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.Bindables;
+using osu.Framework.Graphics;
+using osu.Framework.Testing;
+using osu.Game.Graphics.UserInterface;
+using osu.Game.Overlays;
+using osu.Game.Overlays.Settings;
+using osu.Game.Overlays.Settings.Sections;
+using osuTK;
+using osuTK.Input;
+
+namespace osu.Game.Tests.Visual.UserInterface
+{
+    public class TestSceneExpandingControlContainer : OsuManualInputManagerTestScene
+    {
+        private TestExpandingContainer container;
+        private SettingsToolboxGroup toolboxGroup;
+
+        private SettingsSlider<float, SizeSlider> slider1;
+        private SettingsSlider<double> slider2;
+
+        [SetUp]
+        public void SetUp() => Schedule(() =>
+        {
+            Child = container = new TestExpandingContainer
+            {
+                Anchor = Anchor.Centre,
+                Origin = Anchor.Centre,
+                Height = 0.33f,
+                Child = toolboxGroup = new SettingsToolboxGroup("sliders")
+                {
+                    RelativeSizeAxes = Axes.X,
+                    Width = 1,
+                    Children = new Drawable[]
+                    {
+                        slider1 = new SettingsSlider<float, SizeSlider>
+                        {
+                            Current = new BindableFloat
+                            {
+                                Default = 1.0f,
+                                MinValue = 1.0f,
+                                MaxValue = 10.0f,
+                                Precision = 0.01f,
+                            },
+                        },
+                        slider2 = new SettingsSlider<double>
+                        {
+                            Current = new BindableDouble
+                            {
+                                Default = 1.0,
+                                MinValue = 1.0,
+                                MaxValue = 10.0,
+                                Precision = 0.01,
+                            },
+                        },
+                    }
+                }
+            };
+
+            slider1.Current.BindValueChanged(v =>
+            {
+                slider1.LabelText = $"Slider One ({v.NewValue:0.##x})";
+                slider1.ContractedLabelText = $"S. 1. ({v.NewValue:0.##x})";
+            }, true);
+
+            slider2.Current.BindValueChanged(v =>
+            {
+                slider2.LabelText = $"Slider Two ({v.NewValue:N2})";
+                slider2.ContractedLabelText = $"S. 2. ({v.NewValue:N2})";
+            }, true);
+        });
+
+        [Test]
+        public void TestDisplay()
+        {
+            AddStep("switch to contracted", () => container.Expanded.Value = false);
+            AddStep("switch to expanded", () => container.Expanded.Value = true);
+            AddStep("set left origin", () => container.Origin = Anchor.CentreLeft);
+            AddStep("set centre origin", () => container.Origin = Anchor.Centre);
+            AddStep("set right origin", () => container.Origin = Anchor.CentreRight);
+        }
+
+        /// <summary>
+        /// Tests hovering over controls expands the parenting container appropriately and does not contract until hover is lost from container.
+        /// </summary>
+        [Test]
+        public void TestHoveringControlExpandsContainer()
+        {
+            AddAssert("ensure container contracted", () => !container.Expanded.Value);
+
+            AddStep("hover slider", () => InputManager.MoveMouseTo(slider1));
+            AddAssert("container expanded", () => container.Expanded.Value);
+            AddAssert("controls expanded", () => slider1.Expanded.Value && slider2.Expanded.Value);
+
+            AddStep("hover group top", () => InputManager.MoveMouseTo(toolboxGroup.ScreenSpaceDrawQuad.TopLeft + new Vector2(5)));
+            AddAssert("container still expanded", () => container.Expanded.Value);
+            AddAssert("controls still expanded", () => slider1.Expanded.Value && slider2.Expanded.Value);
+
+            AddStep("hover away", () => InputManager.MoveMouseTo(Vector2.Zero));
+            AddAssert("container contracted", () => !container.Expanded.Value);
+            AddAssert("controls contracted", () => !slider1.Expanded.Value && !slider2.Expanded.Value);
+        }
+
+        /// <summary>
+        /// Tests dragging a UI control (e.g. <see cref="OsuSliderBar{T}"/>) outside its parenting container does not contract it until dragging is finished.
+        /// </summary>
+        [Test]
+        public void TestDraggingControlOutsideDoesntContractContainer()
+        {
+            AddStep("hover slider", () => InputManager.MoveMouseTo(slider1));
+            AddAssert("container expanded", () => container.Expanded.Value);
+
+            AddStep("hover slider nub", () => InputManager.MoveMouseTo(slider1.ChildrenOfType<Nub>().Single()));
+            AddStep("hold slider nub", () => InputManager.PressButton(MouseButton.Left));
+            AddStep("drag outside container", () => InputManager.MoveMouseTo(Vector2.Zero));
+            AddAssert("container still expanded", () => container.Expanded.Value);
+
+            AddStep("release slider nub", () => InputManager.ReleaseButton(MouseButton.Left));
+            AddAssert("container contracted", () => !container.Expanded.Value);
+        }
+
+        /// <summary>
+        /// Tests expanding a container will expand underlying groups if contracted.
+        /// </summary>
+        [Test]
+        public void TestExpandingContainerExpandsContractedGroup()
+        {
+            AddStep("contract group", () => toolboxGroup.Expanded.Value = false);
+
+            AddStep("expand container", () => container.Expanded.Value = true);
+            AddAssert("group expanded", () => toolboxGroup.Expanded.Value);
+            AddAssert("controls expanded", () => slider1.Expanded.Value && slider2.Expanded.Value);
+
+            AddStep("contract container", () => container.Expanded.Value = false);
+            AddAssert("group contracted", () => !toolboxGroup.Expanded.Value);
+            AddAssert("controls contracted", () => !slider1.Expanded.Value && !slider2.Expanded.Value);
+        }
+
+        /// <summary>
+        /// Tests contracting a container does not contract underlying groups if expanded by user (i.e. by setting <see cref="SettingsToolboxGroup.Expanded"/> directly).
+        /// </summary>
+        [Test]
+        public void TestContractingContainerDoesntContractUserExpandedGroup()
+        {
+            AddAssert("ensure group expanded", () => toolboxGroup.Expanded.Value);
+
+            AddStep("expand container", () => container.Expanded.Value = true);
+            AddAssert("group still expanded", () => toolboxGroup.Expanded.Value);
+            AddAssert("controls expanded", () => slider1.Expanded.Value && slider2.Expanded.Value);
+
+            AddStep("contract container", () => container.Expanded.Value = false);
+            AddAssert("group still expanded", () => toolboxGroup.Expanded.Value);
+            AddAssert("controls contracted", () => !slider1.Expanded.Value && !slider2.Expanded.Value);
+        }
+
+        /// <summary>
+        /// Tests expanding a container via <see cref="ExpandingControlContainer{TControl}.Expanded"/> does not get contracted by losing hover.
+        /// </summary>
+        [Test]
+        public void TestExpandingContainerDoesntGetContractedByHover()
+        {
+            AddStep("expand container", () => container.Expanded.Value = true);
+
+            AddStep("hover control", () => InputManager.MoveMouseTo(slider1));
+            AddAssert("container still expanded", () => container.Expanded.Value);
+
+            AddStep("hover away", () => InputManager.MoveMouseTo(Vector2.Zero));
+            AddAssert("container still expanded", () => container.Expanded.Value);
+        }
+
+        private class TestExpandingContainer : ExpandingControlContainer<ISettingsItem>
+        {
+            public TestExpandingContainer()
+                : base(120, 250)
+            {
+            }
+        }
+    }
+}

From 48aa1677dcd28e0477bb84ae17075ba53d46e56e Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Sun, 23 Jan 2022 11:01:30 +0800
Subject: [PATCH 2412/5547] Include hit results of nested hit objects in
 statistics of perfect score

---
 .../Difficulty/PerformanceBreakdownCalculator.cs     | 12 +++++++++++-
 1 file changed, 11 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Rulesets/Difficulty/PerformanceBreakdownCalculator.cs b/osu.Game/Rulesets/Difficulty/PerformanceBreakdownCalculator.cs
index 5cf63d0102..46342b237c 100644
--- a/osu.Game/Rulesets/Difficulty/PerformanceBreakdownCalculator.cs
+++ b/osu.Game/Rulesets/Difficulty/PerformanceBreakdownCalculator.cs
@@ -1,12 +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 System.Threading;
 using System.Threading.Tasks;
 using JetBrains.Annotations;
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Mods;
+using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Scoring;
 using osu.Game.Scoring;
 
@@ -64,7 +66,7 @@ namespace osu.Game.Rulesets.Difficulty
 
                 // create statistics assuming all hit objects have perfect hit result
                 var statistics = beatmap.HitObjects
-                                        .Select(ho => ho.CreateJudgement().MaxResult)
+                                        .SelectMany(getPerfectHitResults)
                                         .GroupBy(hr => hr, (hr, list) => (hitResult: hr, count: list.Count()))
                                         .ToDictionary(pair => pair.hitResult, pair => pair.count);
                 perfectPlay.Statistics = statistics;
@@ -89,5 +91,13 @@ namespace osu.Game.Rulesets.Difficulty
                 return ruleset.CreatePerformanceCalculator(difficulty.Value.Attributes, perfectPlay)?.Calculate();
             }, cancellationToken);
         }
+
+        private IEnumerable<HitResult> getPerfectHitResults(HitObject hitObject)
+        {
+            foreach (HitObject nested in hitObject.NestedHitObjects)
+                yield return nested.CreateJudgement().MaxResult;
+
+            yield return hitObject.CreateJudgement().MaxResult;
+        }
     }
 }

From f53ce5aedfd17d18eaa9a882e14707636a806a92 Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Sun, 23 Jan 2022 11:11:12 +0800
Subject: [PATCH 2413/5547] Fix max combo calculation in osu diffcalc

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

diff --git a/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs b/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs
index c5b1baaad1..c80b19e1d3 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs
@@ -63,8 +63,10 @@ namespace osu.Game.Rulesets.Osu.Difficulty
             double drainRate = beatmap.Difficulty.DrainRate;
 
             int maxCombo = beatmap.HitObjects.Count;
-            // Add the ticks + tail of the slider. 1 is subtracted because the head circle would be counted twice (once for the slider itself in the line above)
-            maxCombo += beatmap.HitObjects.OfType<Slider>().Sum(s => s.NestedHitObjects.Count - 1);
+            // Add the ticks + tail of the slider
+            // 1 is subtracted because the head circle would be counted twice (once for the slider itself in the line above)
+            // an additional 1 is subtracted if only nested objects are judged because the hit result of the entire slider would not contribute to combo
+            maxCombo += beatmap.HitObjects.OfType<Slider>().Sum(s => s.NestedHitObjects.Count - 1 - (s.OnlyJudgeNestedObjects ? 1 : 0));
 
             int hitCirclesCount = beatmap.HitObjects.Count(h => h is HitCircle);
             int sliderCount = beatmap.HitObjects.Count(h => h is Slider);

From 44311c1f4e3e18548f9b574de968468d52f8c282 Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Sun, 23 Jan 2022 11:25:22 +0800
Subject: [PATCH 2414/5547] Add tests for diffcalc max combo

---
 .../CatchDifficultyCalculatorTest.cs          | 12 +++++------
 .../ManiaDifficultyCalculatorTest.cs          | 12 +++++------
 .../OsuDifficultyCalculatorTest.cs            | 21 ++++++++++++-------
 .../TaikoDifficultyCalculatorTest.cs          | 16 +++++++-------
 .../Beatmaps/DifficultyCalculatorTest.cs      |  7 +++++--
 5 files changed, 38 insertions(+), 30 deletions(-)

diff --git a/osu.Game.Rulesets.Catch.Tests/CatchDifficultyCalculatorTest.cs b/osu.Game.Rulesets.Catch.Tests/CatchDifficultyCalculatorTest.cs
index 7e8d567fbe..48d46636df 100644
--- a/osu.Game.Rulesets.Catch.Tests/CatchDifficultyCalculatorTest.cs
+++ b/osu.Game.Rulesets.Catch.Tests/CatchDifficultyCalculatorTest.cs
@@ -14,13 +14,13 @@ namespace osu.Game.Rulesets.Catch.Tests
     {
         protected override string ResourceAssembly => "osu.Game.Rulesets.Catch";
 
-        [TestCase(4.0505463516206195d, "diffcalc-test")]
-        public void Test(double expected, string name)
-            => base.Test(expected, name);
+        [TestCase(4.0505463516206195d, 127, "diffcalc-test")]
+        public void Test(double expectedStarRating, int expectedMaxCombo, string name)
+            => base.Test(expectedStarRating, expectedMaxCombo, name);
 
-        [TestCase(5.1696411260785498d, "diffcalc-test")]
-        public void TestClockRateAdjusted(double expected, string name)
-            => Test(expected, name, new CatchModDoubleTime());
+        [TestCase(5.1696411260785498d, 127, "diffcalc-test")]
+        public void TestClockRateAdjusted(double expectedStarRating, int expectedMaxCombo, string name)
+            => Test(expectedStarRating, expectedMaxCombo, name, new CatchModDoubleTime());
 
         protected override DifficultyCalculator CreateDifficultyCalculator(IWorkingBeatmap beatmap) => new CatchDifficultyCalculator(new CatchRuleset().RulesetInfo, beatmap);
 
diff --git a/osu.Game.Rulesets.Mania.Tests/ManiaDifficultyCalculatorTest.cs b/osu.Game.Rulesets.Mania.Tests/ManiaDifficultyCalculatorTest.cs
index 6ec49d7634..715614a201 100644
--- a/osu.Game.Rulesets.Mania.Tests/ManiaDifficultyCalculatorTest.cs
+++ b/osu.Game.Rulesets.Mania.Tests/ManiaDifficultyCalculatorTest.cs
@@ -14,13 +14,13 @@ namespace osu.Game.Rulesets.Mania.Tests
     {
         protected override string ResourceAssembly => "osu.Game.Rulesets.Mania";
 
-        [TestCase(2.3449735700206298d, "diffcalc-test")]
-        public void Test(double expected, string name)
-            => base.Test(expected, name);
+        [TestCase(2.3449735700206298d, 151, "diffcalc-test")]
+        public void Test(double expectedStarRating, int expectedMaxCombo, string name)
+            => base.Test(expectedStarRating, expectedMaxCombo, name);
 
-        [TestCase(2.7879104989252959d, "diffcalc-test")]
-        public void TestClockRateAdjusted(double expected, string name)
-            => Test(expected, name, new ManiaModDoubleTime());
+        [TestCase(2.7879104989252959d, 151, "diffcalc-test")]
+        public void TestClockRateAdjusted(double expectedStarRating, int expectedMaxCombo, string name)
+            => Test(expectedStarRating, expectedMaxCombo, name, new ManiaModDoubleTime());
 
         protected override DifficultyCalculator CreateDifficultyCalculator(IWorkingBeatmap beatmap) => new ManiaDifficultyCalculator(new ManiaRuleset().RulesetInfo, beatmap);
 
diff --git a/osu.Game.Rulesets.Osu.Tests/OsuDifficultyCalculatorTest.cs b/osu.Game.Rulesets.Osu.Tests/OsuDifficultyCalculatorTest.cs
index b7984e6995..df577ea8d3 100644
--- a/osu.Game.Rulesets.Osu.Tests/OsuDifficultyCalculatorTest.cs
+++ b/osu.Game.Rulesets.Osu.Tests/OsuDifficultyCalculatorTest.cs
@@ -15,15 +15,20 @@ namespace osu.Game.Rulesets.Osu.Tests
     {
         protected override string ResourceAssembly => "osu.Game.Rulesets.Osu";
 
-        [TestCase(6.6972307565739273d, "diffcalc-test")]
-        [TestCase(1.4484754139145539d, "zero-length-sliders")]
-        public void Test(double expected, string name)
-            => base.Test(expected, name);
+        [TestCase(6.6972307565739273d, 206, "diffcalc-test")]
+        [TestCase(1.4484754139145539d, 45, "zero-length-sliders")]
+        public void Test(double expectedStarRating, int expectedMaxCombo, string name)
+            => base.Test(expectedStarRating, expectedMaxCombo, name);
 
-        [TestCase(8.9382559208689809d, "diffcalc-test")]
-        [TestCase(1.7548875851757628d, "zero-length-sliders")]
-        public void TestClockRateAdjusted(double expected, string name)
-            => Test(expected, name, new OsuModDoubleTime());
+        [TestCase(8.9382559208689809d, 206, "diffcalc-test")]
+        [TestCase(1.7548875851757628d, 45, "zero-length-sliders")]
+        public void TestClockRateAdjusted(double expectedStarRating, int expectedMaxCombo, string name)
+            => Test(expectedStarRating, expectedMaxCombo, name, new OsuModDoubleTime());
+
+        [TestCase(6.6972307218715166d, 239, "diffcalc-test")]
+        [TestCase(1.4484754139145537d, 54, "zero-length-sliders")]
+        public void TestClassicMod(double expectedStarRating, int expectedMaxCombo, string name)
+            => Test(expectedStarRating, expectedMaxCombo, name, new OsuModClassic());
 
         protected override DifficultyCalculator CreateDifficultyCalculator(IWorkingBeatmap beatmap) => new OsuDifficultyCalculator(new OsuRuleset().RulesetInfo, beatmap);
 
diff --git a/osu.Game.Rulesets.Taiko.Tests/TaikoDifficultyCalculatorTest.cs b/osu.Game.Rulesets.Taiko.Tests/TaikoDifficultyCalculatorTest.cs
index 2b1cbc580e..226da7df09 100644
--- a/osu.Game.Rulesets.Taiko.Tests/TaikoDifficultyCalculatorTest.cs
+++ b/osu.Game.Rulesets.Taiko.Tests/TaikoDifficultyCalculatorTest.cs
@@ -14,15 +14,15 @@ namespace osu.Game.Rulesets.Taiko.Tests
     {
         protected override string ResourceAssembly => "osu.Game.Rulesets.Taiko";
 
-        [TestCase(2.2420075288523802d, "diffcalc-test")]
-        [TestCase(2.2420075288523802d, "diffcalc-test-strong")]
-        public void Test(double expected, string name)
-            => base.Test(expected, name);
+        [TestCase(2.2420075288523802d, 200, "diffcalc-test")]
+        [TestCase(2.2420075288523802d, 200, "diffcalc-test-strong")]
+        public void Test(double expectedStarRating, int expectedMaxCombo, string name)
+            => base.Test(expectedStarRating, expectedMaxCombo, name);
 
-        [TestCase(3.134084469440479d, "diffcalc-test")]
-        [TestCase(3.134084469440479d, "diffcalc-test-strong")]
-        public void TestClockRateAdjusted(double expected, string name)
-            => Test(expected, name, new TaikoModDoubleTime());
+        [TestCase(3.134084469440479d, 200, "diffcalc-test")]
+        [TestCase(3.134084469440479d, 200, "diffcalc-test-strong")]
+        public void TestClockRateAdjusted(double expectedStarRating, int expectedMaxCombo, string name)
+            => Test(expectedStarRating, expectedMaxCombo, name, new TaikoModDoubleTime());
 
         protected override DifficultyCalculator CreateDifficultyCalculator(IWorkingBeatmap beatmap) => new TaikoDifficultyCalculator(new TaikoRuleset().RulesetInfo, beatmap);
 
diff --git a/osu.Game/Tests/Beatmaps/DifficultyCalculatorTest.cs b/osu.Game/Tests/Beatmaps/DifficultyCalculatorTest.cs
index 9f8811c7f9..ed00c7959b 100644
--- a/osu.Game/Tests/Beatmaps/DifficultyCalculatorTest.cs
+++ b/osu.Game/Tests/Beatmaps/DifficultyCalculatorTest.cs
@@ -22,10 +22,13 @@ namespace osu.Game.Tests.Beatmaps
 
         protected abstract string ResourceAssembly { get; }
 
-        protected void Test(double expected, string name, params Mod[] mods)
+        protected void Test(double expectedStarRating, int expectedMaxCombo, string name, params Mod[] mods)
         {
+            var attributes = CreateDifficultyCalculator(getBeatmap(name)).Calculate(mods);
+
             // Platform-dependent math functions (Pow, Cbrt, Exp, etc) may result in minute differences.
-            Assert.That(CreateDifficultyCalculator(getBeatmap(name)).Calculate(mods).StarRating, Is.EqualTo(expected).Within(0.00001));
+            Assert.That(attributes.StarRating, Is.EqualTo(expectedStarRating).Within(0.00001));
+            Assert.That(attributes.MaxCombo, Is.EqualTo(expectedMaxCombo));
         }
 
         private IWorkingBeatmap getBeatmap(string name)

From 74a55ead7711108c4d6b856e11433b476459c35a Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Sun, 23 Jan 2022 13:00:54 +0800
Subject: [PATCH 2415/5547] Simplify combo counting logic

---
 .../Difficulty/OsuDifficultyCalculator.cs     | 20 ++++++++++++++-----
 1 file changed, 15 insertions(+), 5 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs b/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs
index c80b19e1d3..d04d0872d8 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs
@@ -9,6 +9,7 @@ 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.Osu.Difficulty.Preprocessing;
 using osu.Game.Rulesets.Osu.Difficulty.Skills;
 using osu.Game.Rulesets.Osu.Mods;
@@ -62,11 +63,20 @@ namespace osu.Game.Rulesets.Osu.Difficulty
             double preempt = IBeatmapDifficultyInfo.DifficultyRange(beatmap.Difficulty.ApproachRate, 1800, 1200, 450) / clockRate;
             double drainRate = beatmap.Difficulty.DrainRate;
 
-            int maxCombo = beatmap.HitObjects.Count;
-            // Add the ticks + tail of the slider
-            // 1 is subtracted because the head circle would be counted twice (once for the slider itself in the line above)
-            // an additional 1 is subtracted if only nested objects are judged because the hit result of the entire slider would not contribute to combo
-            maxCombo += beatmap.HitObjects.OfType<Slider>().Sum(s => s.NestedHitObjects.Count - 1 - (s.OnlyJudgeNestedObjects ? 1 : 0));
+            int maxCombo = 0;
+
+            void countCombo(HitObject ho)
+            {
+                if (ho.CreateJudgement().MaxResult.AffectsCombo())
+                    maxCombo++;
+            }
+
+            foreach (HitObject ho in beatmap.HitObjects)
+            {
+                countCombo(ho);
+                foreach (HitObject nested in ho.NestedHitObjects)
+                    countCombo(nested);
+            }
 
             int hitCirclesCount = beatmap.HitObjects.Count(h => h is HitCircle);
             int sliderCount = beatmap.HitObjects.Count(h => h is Slider);

From 1ea5a2e6a75301341355f7a934b6b79a5f282d7c Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sun, 23 Jan 2022 10:11:07 +0300
Subject: [PATCH 2416/5547] Fix incorrect assert step name

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

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneLabelledTimeSignature.cs b/osu.Game.Tests/Visual/Editing/TestSceneLabelledTimeSignature.cs
index cedbb5025f..b34974dfc7 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneLabelledTimeSignature.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneLabelledTimeSignature.cs
@@ -51,7 +51,7 @@ namespace osu.Game.Tests.Visual.Editing
             AddStep("set current to 3/4", () => timeSignature.Current.Value = TimeSignature.SimpleTriple);
 
             AddAssert("current is 3/4", () => timeSignature.Current.Value.Equals(TimeSignature.SimpleTriple));
-            AddAssert("numerator is 5", () => numeratorTextBox.Current.Value == "3");
+            AddAssert("numerator is 3", () => numeratorTextBox.Current.Value == "3");
         }
 
         [Test]

From e4758c9dbbee726593078de2c111fd243b4db582 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sun, 23 Jan 2022 10:13:32 +0300
Subject: [PATCH 2417/5547] Mark `LabelledTimeSignature` as public

---
 osu.Game/Screens/Edit/Timing/LabelledTimeSignature.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/Edit/Timing/LabelledTimeSignature.cs b/osu.Game/Screens/Edit/Timing/LabelledTimeSignature.cs
index 52aece75ad..66bd341393 100644
--- a/osu.Game/Screens/Edit/Timing/LabelledTimeSignature.cs
+++ b/osu.Game/Screens/Edit/Timing/LabelledTimeSignature.cs
@@ -14,7 +14,7 @@ using osu.Game.Graphics.UserInterfaceV2;
 
 namespace osu.Game.Screens.Edit.Timing
 {
-    internal class LabelledTimeSignature : LabelledComponent<LabelledTimeSignature.TimeSignatureBox, TimeSignature>
+    public class LabelledTimeSignature : LabelledComponent<LabelledTimeSignature.TimeSignatureBox, TimeSignature>
     {
         public LabelledTimeSignature()
             : base(false)
@@ -23,7 +23,7 @@ namespace osu.Game.Screens.Edit.Timing
 
         protected override TimeSignatureBox CreateComponent() => new TimeSignatureBox();
 
-        internal class TimeSignatureBox : CompositeDrawable, IHasCurrentValue<TimeSignature>
+        public class TimeSignatureBox : CompositeDrawable, IHasCurrentValue<TimeSignature>
         {
             private readonly BindableWithCurrent<TimeSignature> current = new BindableWithCurrent<TimeSignature>(TimeSignature.SimpleQuadruple);
 

From a5493ce0d1f70b6db0d9ce846ed14c42f360946e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 23 Jan 2022 17:51:32 +0900
Subject: [PATCH 2418/5547] Fix incorrect nesting of statements causing
 completely broken logic

---
 osu.Game/Screens/Menu/IntroScreen.cs | 54 ++++++++++++++--------------
 1 file changed, 27 insertions(+), 27 deletions(-)

diff --git a/osu.Game/Screens/Menu/IntroScreen.cs b/osu.Game/Screens/Menu/IntroScreen.cs
index 10be90a5f0..e66ecc74e1 100644
--- a/osu.Game/Screens/Menu/IntroScreen.cs
+++ b/osu.Game/Screens/Menu/IntroScreen.cs
@@ -99,51 +99,51 @@ namespace osu.Game.Screens.Menu
             {
                 realmContextFactory.Run(realm =>
                 {
-                    var sets = realm.All<BeatmapSetInfo>().Where(s => !s.DeletePending && !s.Protected).AsRealmCollection();
+                    var usableBeatmapSets = realm.All<BeatmapSetInfo>().Where(s => !s.DeletePending && !s.Protected).AsRealmCollection();
 
-                    int setCount = sets.Count;
+                    int setCount = usableBeatmapSets.Count;
 
                     if (setCount > 0)
                     {
-                        var found = sets[RNG.Next(0, setCount - 1)].Beatmaps.FirstOrDefault();
+                        var found = usableBeatmapSets[RNG.Next(0, setCount - 1)].Beatmaps.FirstOrDefault();
 
                         if (found != null)
                             initialBeatmap = beatmaps.GetWorkingBeatmap(found);
                     }
                 });
+            }
 
-                // we generally want a song to be playing on startup, so use the intro music even if a user has specified not to if no other track is available.
-                if (initialBeatmap == null)
+            // we generally want a song to be playing on startup, so use the intro music even if a user has specified not to if no other track is available.
+            if (initialBeatmap == null)
+            {
+                if (!loadThemedIntro())
                 {
-                    if (!loadThemedIntro())
-                    {
-                        // if we detect that the theme track or beatmap is unavailable this is either first startup or things are in a bad state.
-                        // this could happen if a user has nuked their files store. for now, reimport to repair this.
-                        var import = beatmaps.Import(new ZipArchiveReader(game.Resources.GetStream($"Tracks/{BeatmapFile}"), BeatmapFile)).GetResultSafely();
+                    // if we detect that the theme track or beatmap is unavailable this is either first startup or things are in a bad state.
+                    // this could happen if a user has nuked their files store. for now, reimport to repair this.
+                    var import = beatmaps.Import(new ZipArchiveReader(game.Resources.GetStream($"Tracks/{BeatmapFile}"), BeatmapFile)).GetResultSafely();
 
-                        import?.PerformWrite(b => b.Protected = true);
+                    import?.PerformWrite(b => b.Protected = true);
 
-                        loadThemedIntro();
-                    }
+                    loadThemedIntro();
                 }
+            }
 
-                bool loadThemedIntro()
+            bool loadThemedIntro()
+            {
+                var setInfo = beatmaps.QueryBeatmapSet(b => b.Hash == BeatmapHash);
+
+                if (setInfo == null)
+                    return false;
+
+                setInfo.PerformRead(s =>
                 {
-                    var setInfo = beatmaps.QueryBeatmapSet(b => b.Hash == BeatmapHash);
+                    if (s.Beatmaps.Count == 0)
+                        return;
 
-                    if (setInfo == null)
-                        return false;
+                    initialBeatmap = beatmaps.GetWorkingBeatmap(s.Beatmaps.First());
+                });
 
-                    setInfo.PerformRead(s =>
-                    {
-                        if (s.Beatmaps.Count == 0)
-                            return;
-
-                        initialBeatmap = beatmaps.GetWorkingBeatmap(s.Beatmaps.First());
-                    });
-
-                    return UsingThemedIntro = initialBeatmap != null;
-                }
+                return UsingThemedIntro = initialBeatmap != null;
             }
         }
 

From 70a120ea8a5e7694c068624b6495fa857f95a4e8 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 23 Jan 2022 18:00:24 +0900
Subject: [PATCH 2419/5547] Add missing lock coverage when using
 `subscriptionActions` dictionary

---
 osu.Game/Database/RealmContextFactory.cs | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Database/RealmContextFactory.cs b/osu.Game/Database/RealmContextFactory.cs
index 6fb9a2996b..606871337c 100644
--- a/osu.Game/Database/RealmContextFactory.cs
+++ b/osu.Game/Database/RealmContextFactory.cs
@@ -249,11 +249,13 @@ namespace osu.Game.Database
 
             return new InvokeOnDisposal(() =>
             {
-                // TODO: this likely needs to be run on the update thread.
-                if (subscriptionActions.TryGetValue(action, out var unsubscriptionAction))
+                lock (contextLock)
                 {
-                    unsubscriptionAction?.Dispose();
-                    subscriptionActions.Remove(action);
+                    if (subscriptionActions.TryGetValue(action, out var unsubscriptionAction))
+                    {
+                        unsubscriptionAction?.Dispose();
+                        subscriptionActions.Remove(action);
+                    }
                 }
             });
         }

From bd0eda7e908e7366198e0007d6db9434faded441 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 23 Jan 2022 18:01:39 +0900
Subject: [PATCH 2420/5547] Use method instead of property for realm query
 retrieval

---
 .../Bindings/DatabasedKeyBindingContainer.cs  | 23 ++++++++-----------
 1 file changed, 10 insertions(+), 13 deletions(-)

diff --git a/osu.Game/Input/Bindings/DatabasedKeyBindingContainer.cs b/osu.Game/Input/Bindings/DatabasedKeyBindingContainer.cs
index 5a9797ffce..ac33c64391 100644
--- a/osu.Game/Input/Bindings/DatabasedKeyBindingContainer.cs
+++ b/osu.Game/Input/Bindings/DatabasedKeyBindingContainer.cs
@@ -46,19 +46,16 @@ namespace osu.Game.Input.Bindings
                 throw new InvalidOperationException($"{nameof(variant)} can not be null when a non-null {nameof(ruleset)} is provided.");
         }
 
-        private IQueryable<RealmKeyBinding> realmKeyBindings
+        private IQueryable<RealmKeyBinding> queryRealmKeyBindings()
         {
-            get
-            {
-                string rulesetName = ruleset?.ShortName;
-                return realmFactory.Context.All<RealmKeyBinding>()
-                                   .Where(b => b.RulesetName == rulesetName && b.Variant == variant);
-            }
+            string rulesetName = ruleset?.ShortName;
+            return realmFactory.Context.All<RealmKeyBinding>()
+                               .Where(b => b.RulesetName == rulesetName && b.Variant == variant);
         }
 
         protected override void LoadComplete()
         {
-            realmSubscription = realmFactory.Register(realm => realmKeyBindings
+            realmSubscription = realmFactory.Register(realm => queryRealmKeyBindings()
                 .QueryAsyncWithNotifications((sender, changes, error) =>
                 {
                     // The first fire of this is a bit redundant as this is being called in base.LoadComplete,
@@ -80,11 +77,11 @@ namespace osu.Game.Input.Bindings
         {
             var defaults = DefaultKeyBindings.ToList();
 
-            List<RealmKeyBinding> newBindings = realmKeyBindings.Detach()
-                                                                // this ordering is important to ensure that we read entries from the database in the order
-                                                                // enforced by DefaultKeyBindings. allow for song select to handle actions that may otherwise
-                                                                // have been eaten by the music controller due to query order.
-                                                                .OrderBy(b => defaults.FindIndex(d => (int)d.Action == b.ActionInt)).ToList();
+            List<RealmKeyBinding> newBindings = queryRealmKeyBindings().Detach()
+                                                                       // this ordering is important to ensure that we read entries from the database in the order
+                                                                       // enforced by DefaultKeyBindings. allow for song select to handle actions that may otherwise
+                                                                       // have been eaten by the music controller due to query order.
+                                                                       .OrderBy(b => defaults.FindIndex(d => (int)d.Action == b.ActionInt)).ToList();
 
             // In the case no bindings were found in the database, presume this usage is for a non-databased ruleset.
             // This actually should never be required and can be removed if it is ever deemed to cause a problem.

From f39ff1eacb3b5179f70aa47f0a892d23e2651e7d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 23 Jan 2022 18:13:28 +0900
Subject: [PATCH 2421/5547] Add unregistration on blocking

This is the first part of the requirement of sending a `ChangeSet` event
to ensure correct state during blocking time
---
 osu.Game/Database/RealmContextFactory.cs | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/osu.Game/Database/RealmContextFactory.cs b/osu.Game/Database/RealmContextFactory.cs
index 606871337c..3e0f278e30 100644
--- a/osu.Game/Database/RealmContextFactory.cs
+++ b/osu.Game/Database/RealmContextFactory.cs
@@ -247,6 +247,8 @@ namespace osu.Game.Database
 
             registerSubscription(action);
 
+            // This token is returned to the consumer only.
+            // It will cause the registration to be permanently removed.
             return new InvokeOnDisposal(() =>
             {
                 lock (contextLock)
@@ -269,12 +271,27 @@ namespace osu.Game.Database
 
             lock (contextLock)
             {
+                Debug.Assert(!customSubscriptionActions.TryGetValue(action, out var found) || found == null);
+
                 current_thread_subscriptions_allowed.Value = true;
                 subscriptionActions[action] = action(realm);
                 current_thread_subscriptions_allowed.Value = false;
             }
         }
 
+        /// <summary>
+        /// Unregister all subscriptions when the realm context is to be recycled.
+        /// Subscriptions will still remain and will be re-subscribed when the realm context returns.
+        /// </summary>
+        private void unregisterAllSubscriptions()
+        {
+            foreach (var action in subscriptionActions)
+            {
+                action.Value?.Dispose();
+                subscriptionActions[action.Key] = null;
+            }
+        }
+
         private Realm createContext()
         {
             if (isDisposed)
@@ -519,6 +536,7 @@ namespace osu.Game.Database
                         throw new InvalidOperationException(@$"{nameof(BlockAllOperations)} must be called from the update thread.");
 
                     syncContext = SynchronizationContext.Current;
+                    unregisterAllSubscriptions();
 
                     Logger.Log(@"Blocking realm operations.", LoggingTarget.Database);
 

From 61cef42be977be4fe3cd612122de1f52556e03d1 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 23 Jan 2022 19:42:26 +0900
Subject: [PATCH 2422/5547] Proof of concept realm subscriptions via `Register`

---
 osu.Game/Database/EmptyRealmSet.cs           | 74 ++++++++++++++++++++
 osu.Game/Database/RealmContextFactory.cs     | 33 +++++++--
 osu.Game/Screens/Select/BeatmapCarousel.cs   |  4 +-
 osu.Game/Screens/Spectate/SpectatorScreen.cs | 21 +++---
 4 files changed, 112 insertions(+), 20 deletions(-)
 create mode 100644 osu.Game/Database/EmptyRealmSet.cs

diff --git a/osu.Game/Database/EmptyRealmSet.cs b/osu.Game/Database/EmptyRealmSet.cs
new file mode 100644
index 0000000000..2fecfcbe07
--- /dev/null
+++ b/osu.Game/Database/EmptyRealmSet.cs
@@ -0,0 +1,74 @@
+// 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;
+using System.Collections.Generic;
+using System.Collections.Specialized;
+using System.ComponentModel;
+using Realms;
+using Realms.Schema;
+
+#nullable enable
+
+namespace osu.Game.Database
+{
+    public class EmptyRealmSet<T> : IRealmCollection<T>
+    {
+        private static List<T> emptySet => new List<T>();
+
+        public IEnumerator<T> GetEnumerator()
+        {
+            return emptySet.GetEnumerator();
+        }
+
+        IEnumerator IEnumerable.GetEnumerator()
+        {
+            return ((IEnumerable)emptySet).GetEnumerator();
+        }
+
+        public int Count => emptySet.Count;
+
+        public T this[int index] => emptySet[index];
+
+        public event NotifyCollectionChangedEventHandler? CollectionChanged
+        {
+            add => throw new NotImplementedException();
+            remove => throw new NotImplementedException();
+        }
+
+        public event PropertyChangedEventHandler? PropertyChanged
+        {
+            add => throw new NotImplementedException();
+            remove => throw new NotImplementedException();
+        }
+
+        public int IndexOf(object item)
+        {
+            return emptySet.IndexOf((T)item);
+        }
+
+        public bool Contains(object item)
+        {
+            return emptySet.Contains((T)item);
+        }
+
+        public IRealmCollection<T> Freeze()
+        {
+            throw new NotImplementedException();
+        }
+
+        public IDisposable SubscribeForNotifications(NotificationCallbackDelegate<T> callback)
+        {
+            throw new NotImplementedException();
+        }
+
+        public bool IsValid => throw new NotImplementedException();
+
+        public Realm Realm => throw new NotImplementedException();
+
+        public ObjectSchema ObjectSchema => throw new NotImplementedException();
+
+        public bool IsFrozen => throw new NotImplementedException();
+    }
+}
diff --git a/osu.Game/Database/RealmContextFactory.cs b/osu.Game/Database/RealmContextFactory.cs
index 3e0f278e30..32f7ac99c1 100644
--- a/osu.Game/Database/RealmContextFactory.cs
+++ b/osu.Game/Database/RealmContextFactory.cs
@@ -84,7 +84,7 @@ namespace osu.Game.Database
                     Logger.Log(@$"Opened realm ""{context.Config.DatabasePath}"" at version {context.Config.SchemaVersion}");
 
                     // Resubscribe any subscriptions
-                    foreach (var action in subscriptionActions.Keys)
+                    foreach (var action in customSubscriptionActions.Keys)
                         registerSubscription(action);
                 }
 
@@ -233,7 +233,22 @@ namespace osu.Game.Database
             }
         }
 
-        private readonly Dictionary<Func<Realm, IDisposable?>, IDisposable?> subscriptionActions = new Dictionary<Func<Realm, IDisposable?>, IDisposable?>();
+        private readonly Dictionary<Func<Realm, IDisposable?>, IDisposable?> customSubscriptionActions = new Dictionary<Func<Realm, IDisposable?>, IDisposable?>();
+
+        private readonly Dictionary<Func<Realm, IDisposable?>, Action> realmSubscriptionsResetMap = new Dictionary<Func<Realm, IDisposable?>, Action>();
+
+        public IDisposable Register<T>(Func<Realm, IQueryable<T>> query, NotificationCallbackDelegate<T> onChanged)
+            where T : RealmObjectBase
+        {
+            if (!ThreadSafety.IsUpdateThread)
+                throw new InvalidOperationException(@$"{nameof(Register)} must be called from the update thread.");
+
+            realmSubscriptionsResetMap.Add(action, () => onChanged(new EmptyRealmSet<T>(), null, null));
+
+            return Register(action);
+
+            IDisposable? action(Realm realm) => query(realm).QueryAsyncWithNotifications(onChanged);
+        }
 
         /// <summary>
         /// Run work on realm that will be run every time the update thread realm context gets recycled.
@@ -253,10 +268,11 @@ namespace osu.Game.Database
             {
                 lock (contextLock)
                 {
-                    if (subscriptionActions.TryGetValue(action, out var unsubscriptionAction))
+                    if (customSubscriptionActions.TryGetValue(action, out var unsubscriptionAction))
                     {
                         unsubscriptionAction?.Dispose();
-                        subscriptionActions.Remove(action);
+                        customSubscriptionActions.Remove(action);
+                        realmSubscriptionsResetMap.Remove(action);
                     }
                 }
             });
@@ -274,7 +290,7 @@ namespace osu.Game.Database
                 Debug.Assert(!customSubscriptionActions.TryGetValue(action, out var found) || found == null);
 
                 current_thread_subscriptions_allowed.Value = true;
-                subscriptionActions[action] = action(realm);
+                customSubscriptionActions[action] = action(realm);
                 current_thread_subscriptions_allowed.Value = false;
             }
         }
@@ -285,10 +301,13 @@ namespace osu.Game.Database
         /// </summary>
         private void unregisterAllSubscriptions()
         {
-            foreach (var action in subscriptionActions)
+            foreach (var action in realmSubscriptionsResetMap.Values)
+                action();
+
+            foreach (var action in customSubscriptionActions)
             {
                 action.Value?.Dispose();
-                subscriptionActions[action.Key] = null;
+                customSubscriptionActions[action.Key] = null;
             }
         }
 
diff --git a/osu.Game/Screens/Select/BeatmapCarousel.cs b/osu.Game/Screens/Select/BeatmapCarousel.cs
index 6f3f467170..10ba23985e 100644
--- a/osu.Game/Screens/Select/BeatmapCarousel.cs
+++ b/osu.Game/Screens/Select/BeatmapCarousel.cs
@@ -190,7 +190,7 @@ namespace osu.Game.Screens.Select
         {
             base.LoadComplete();
 
-            subscriptionSets = realmFactory.Register(realm => getBeatmapSets(realm).QueryAsyncWithNotifications(beatmapSetsChanged));
+            subscriptionSets = realmFactory.Register(getBeatmapSets, beatmapSetsChanged);
             subscriptionBeatmaps = realmFactory.Register(realm => realm.All<BeatmapInfo>().Where(b => !b.Hidden).QueryAsyncWithNotifications(beatmapsChanged));
 
             // Can't use main subscriptions because we can't lookup deleted indices.
@@ -274,7 +274,7 @@ namespace osu.Game.Screens.Select
             }
         }
 
-        private IRealmCollection<BeatmapSetInfo> getBeatmapSets(Realm realm) => realm.All<BeatmapSetInfo>().Where(s => !s.DeletePending && !s.Protected).AsRealmCollection();
+        private IQueryable<BeatmapSetInfo> getBeatmapSets(Realm realm) => realm.All<BeatmapSetInfo>().Where(s => !s.DeletePending && !s.Protected);
 
         public void RemoveBeatmapSet(BeatmapSetInfo beatmapSet) =>
             removeBeatmapSet(beatmapSet.ID);
diff --git a/osu.Game/Screens/Spectate/SpectatorScreen.cs b/osu.Game/Screens/Spectate/SpectatorScreen.cs
index 9fa5bb8562..904648f727 100644
--- a/osu.Game/Screens/Spectate/SpectatorScreen.cs
+++ b/osu.Game/Screens/Spectate/SpectatorScreen.cs
@@ -17,6 +17,7 @@ using osu.Game.Online.Spectator;
 using osu.Game.Replays;
 using osu.Game.Rulesets;
 using osu.Game.Scoring;
+using Realms;
 
 namespace osu.Game.Screens.Spectate
 {
@@ -79,23 +80,21 @@ namespace osu.Game.Screens.Spectate
                 playingUserStates.BindTo(spectatorClient.PlayingUserStates);
                 playingUserStates.BindCollectionChanged(onPlayingUserStatesChanged, true);
 
-                realmSubscription = realmContextFactory.Register(realm =>
-                    realm.All<BeatmapSetInfo>()
-                         .Where(s => !s.DeletePending)
-                         .QueryAsyncWithNotifications((items, changes, ___) =>
-                         {
-                             if (changes?.InsertedIndices == null)
-                                 return;
-
-                             foreach (int c in changes.InsertedIndices)
-                                 beatmapUpdated(items[c]);
-                         }));
+                realmSubscription = realmContextFactory.Register(
+                    realm => realm.All<BeatmapSetInfo>().Where(s => !s.DeletePending), beatmapsChanged);
 
                 foreach ((int id, var _) in userMap)
                     spectatorClient.WatchUser(id);
             }));
         }
 
+        private void beatmapsChanged(IRealmCollection<BeatmapSetInfo> items, ChangeSet changes, Exception ___)
+        {
+            if (changes?.InsertedIndices == null) return;
+
+            foreach (int c in changes.InsertedIndices) beatmapUpdated(items[c]);
+        }
+
         private void beatmapUpdated(BeatmapSetInfo beatmapSet)
         {
             foreach ((int userId, _) in userMap)

From e9e3e024a19d4867673152efa06f89842937d032 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 23 Jan 2022 19:50:29 +0900
Subject: [PATCH 2423/5547] Update all usages of `QueryAsyncWithNotifications`
 to use new `Register` pathway

---
 .../Bindings/DatabasedKeyBindingContainer.cs  | 13 +++++-----
 osu.Game/Online/BeatmapDownloadTracker.cs     |  4 ++--
 .../OnlinePlayBeatmapAvailabilityTracker.cs   |  4 ++--
 osu.Game/Online/ScoreDownloadTracker.cs       |  4 ++--
 osu.Game/Overlays/MusicController.cs          |  2 +-
 .../Overlays/Settings/Sections/SkinSection.cs | 19 +++++++--------
 osu.Game/Screens/Select/BeatmapCarousel.cs    |  6 ++---
 .../Screens/Select/Carousel/TopLocalRank.cs   | 24 +++++++++----------
 .../Select/Leaderboards/BeatmapLeaderboard.cs | 14 +++++------
 9 files changed, 44 insertions(+), 46 deletions(-)

diff --git a/osu.Game/Input/Bindings/DatabasedKeyBindingContainer.cs b/osu.Game/Input/Bindings/DatabasedKeyBindingContainer.cs
index ac33c64391..4ad5693867 100644
--- a/osu.Game/Input/Bindings/DatabasedKeyBindingContainer.cs
+++ b/osu.Game/Input/Bindings/DatabasedKeyBindingContainer.cs
@@ -55,13 +55,12 @@ namespace osu.Game.Input.Bindings
 
         protected override void LoadComplete()
         {
-            realmSubscription = realmFactory.Register(realm => queryRealmKeyBindings()
-                .QueryAsyncWithNotifications((sender, changes, error) =>
-                {
-                    // The first fire of this is a bit redundant as this is being called in base.LoadComplete,
-                    // but this is safest in case the subscription is restored after a context recycle.
-                    ReloadMappings();
-                }));
+            realmSubscription = realmFactory.Register(realm => queryRealmKeyBindings(), (sender, changes, error) =>
+            {
+                // The first fire of this is a bit redundant as this is being called in base.LoadComplete,
+                // but this is safest in case the subscription is restored after a context recycle.
+                ReloadMappings();
+            });
 
             base.LoadComplete();
         }
diff --git a/osu.Game/Online/BeatmapDownloadTracker.cs b/osu.Game/Online/BeatmapDownloadTracker.cs
index d50ab5a347..70599a167b 100644
--- a/osu.Game/Online/BeatmapDownloadTracker.cs
+++ b/osu.Game/Online/BeatmapDownloadTracker.cs
@@ -42,7 +42,7 @@ namespace osu.Game.Online
             // Used to interact with manager classes that don't support interface types. Will eventually be replaced.
             var beatmapSetInfo = new BeatmapSetInfo { OnlineID = TrackedItem.OnlineID };
 
-            realmSubscription = realmContextFactory.Register(realm => realm.All<BeatmapSetInfo>().Where(s => s.OnlineID == TrackedItem.OnlineID && !s.DeletePending).QueryAsyncWithNotifications((items, changes, ___) =>
+            realmSubscription = realmContextFactory.Register(realm => realm.All<BeatmapSetInfo>().Where(s => s.OnlineID == TrackedItem.OnlineID && !s.DeletePending), (items, changes, ___) =>
             {
                 if (items.Any())
                     Schedule(() => UpdateState(DownloadState.LocallyAvailable));
@@ -54,7 +54,7 @@ namespace osu.Game.Online
                         attachDownload(Downloader.GetExistingDownload(beatmapSetInfo));
                     });
                 }
-            }));
+            });
         }
 
         private void downloadBegan(ArchiveDownloadRequest<IBeatmapSetInfo> request) => Schedule(() =>
diff --git a/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs b/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs
index fdcf2b39c6..8dd28f5417 100644
--- a/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs
+++ b/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs
@@ -78,13 +78,13 @@ namespace osu.Game.Online.Rooms
 
                 // handles changes to hash that didn't occur from the import process (ie. a user editing the beatmap in the editor, somehow).
                 realmSubscription?.Dispose();
-                realmSubscription = realmContextFactory.Register(realm => filteredBeatmaps().QueryAsyncWithNotifications((items, changes, ___) =>
+                realmSubscription = realmContextFactory.Register(realm => filteredBeatmaps(), (items, changes, ___) =>
                 {
                     if (changes == null)
                         return;
 
                     Scheduler.AddOnce(updateAvailability);
-                }));
+                });
             }, true);
         }
 
diff --git a/osu.Game/Online/ScoreDownloadTracker.cs b/osu.Game/Online/ScoreDownloadTracker.cs
index de1d6fd94a..72e95bd6df 100644
--- a/osu.Game/Online/ScoreDownloadTracker.cs
+++ b/osu.Game/Online/ScoreDownloadTracker.cs
@@ -47,7 +47,7 @@ namespace osu.Game.Online
             Downloader.DownloadBegan += downloadBegan;
             Downloader.DownloadFailed += downloadFailed;
 
-            realmSubscription = realmContextFactory.Register(realm => realm.All<ScoreInfo>().Where(s => ((s.OnlineID > 0 && s.OnlineID == TrackedItem.OnlineID) || s.Hash == TrackedItem.Hash) && !s.DeletePending).QueryAsyncWithNotifications((items, changes, ___) =>
+            realmSubscription = realmContextFactory.Register(realm => realm.All<ScoreInfo>().Where(s => ((s.OnlineID > 0 && s.OnlineID == TrackedItem.OnlineID) || s.Hash == TrackedItem.Hash) && !s.DeletePending), (items, changes, ___) =>
             {
                 if (items.Any())
                     Schedule(() => UpdateState(DownloadState.LocallyAvailable));
@@ -59,7 +59,7 @@ namespace osu.Game.Online
                         attachDownload(Downloader.GetExistingDownload(scoreInfo));
                     });
                 }
-            }));
+            });
         }
 
         private void downloadBegan(ArchiveDownloadRequest<IScoreInfo> request) => Schedule(() =>
diff --git a/osu.Game/Overlays/MusicController.cs b/osu.Game/Overlays/MusicController.cs
index 01a2c9d354..24d907285a 100644
--- a/osu.Game/Overlays/MusicController.cs
+++ b/osu.Game/Overlays/MusicController.cs
@@ -93,7 +93,7 @@ namespace osu.Game.Overlays
             foreach (var s in availableBeatmaps)
                 beatmapSets.Add(s.Detach());
 
-            beatmapSubscription = realmFactory.Register(realm => availableBeatmaps.QueryAsyncWithNotifications(beatmapsChanged));
+            beatmapSubscription = realmFactory.Register(realm => availableBeatmaps, beatmapsChanged);
         }
 
         private void beatmapsChanged(IRealmCollection<BeatmapSetInfo> sender, ChangeSet changes, Exception error)
diff --git a/osu.Game/Overlays/Settings/Sections/SkinSection.cs b/osu.Game/Overlays/Settings/Sections/SkinSection.cs
index 11a7275168..c767edec71 100644
--- a/osu.Game/Overlays/Settings/Sections/SkinSection.cs
+++ b/osu.Game/Overlays/Settings/Sections/SkinSection.cs
@@ -51,7 +51,7 @@ namespace osu.Game.Overlays.Settings.Sections
 
         private IDisposable realmSubscription;
 
-        private IQueryable<SkinInfo> realmSkins =>
+        private IQueryable<SkinInfo> queryRealmSkins() =>
             realmFactory.Context.All<SkinInfo>()
                         .Where(s => !s.DeletePending)
                         .OrderByDescending(s => s.Protected) // protected skins should be at the top.
@@ -83,13 +83,12 @@ namespace osu.Game.Overlays.Settings.Sections
 
             skinDropdown.Current = dropdownBindable;
 
-            realmSubscription = realmFactory.Register(realm => realmSkins
-                .QueryAsyncWithNotifications((sender, changes, error) =>
-                {
-                    // The first fire of this is a bit redundant due to the call below,
-                    // but this is safest in case the subscription is restored after a context recycle.
-                    updateItems();
-                }));
+            realmSubscription = realmFactory.Register(realm => queryRealmSkins(), (sender, changes, error) =>
+            {
+                // The first fire of this is a bit redundant due to the call below,
+                // but this is safest in case the subscription is restored after a context recycle.
+                updateItems();
+            });
 
             updateItems();
 
@@ -129,9 +128,9 @@ namespace osu.Game.Overlays.Settings.Sections
 
         private void updateItems()
         {
-            int protectedCount = realmSkins.Count(s => s.Protected);
+            int protectedCount = queryRealmSkins().Count(s => s.Protected);
 
-            skinItems = realmSkins.ToLive(realmFactory);
+            skinItems = queryRealmSkins().ToLive(realmFactory);
 
             skinItems.Insert(protectedCount, random_skin_info);
 
diff --git a/osu.Game/Screens/Select/BeatmapCarousel.cs b/osu.Game/Screens/Select/BeatmapCarousel.cs
index 10ba23985e..889a6f5b79 100644
--- a/osu.Game/Screens/Select/BeatmapCarousel.cs
+++ b/osu.Game/Screens/Select/BeatmapCarousel.cs
@@ -191,12 +191,12 @@ namespace osu.Game.Screens.Select
             base.LoadComplete();
 
             subscriptionSets = realmFactory.Register(getBeatmapSets, beatmapSetsChanged);
-            subscriptionBeatmaps = realmFactory.Register(realm => realm.All<BeatmapInfo>().Where(b => !b.Hidden).QueryAsyncWithNotifications(beatmapsChanged));
+            subscriptionBeatmaps = realmFactory.Register(realm => realm.All<BeatmapInfo>().Where(b => !b.Hidden), beatmapsChanged);
 
             // Can't use main subscriptions because we can't lookup deleted indices.
             // https://github.com/realm/realm-dotnet/discussions/2634#discussioncomment-1605595.
-            subscriptionDeletedSets = realmFactory.Register(realm => realm.All<BeatmapSetInfo>().Where(s => s.DeletePending && !s.Protected).QueryAsyncWithNotifications(deletedBeatmapSetsChanged));
-            subscriptionHiddenBeatmaps = realmFactory.Register(realm => realm.All<BeatmapInfo>().Where(b => b.Hidden).QueryAsyncWithNotifications(beatmapsChanged));
+            subscriptionDeletedSets = realmFactory.Register(realm => realm.All<BeatmapSetInfo>().Where(s => s.DeletePending && !s.Protected), deletedBeatmapSetsChanged);
+            subscriptionHiddenBeatmaps = realmFactory.Register(realm => realm.All<BeatmapInfo>().Where(b => b.Hidden), beatmapsChanged);
         }
 
         private void deletedBeatmapSetsChanged(IRealmCollection<BeatmapSetInfo> sender, ChangeSet changes, Exception error)
diff --git a/osu.Game/Screens/Select/Carousel/TopLocalRank.cs b/osu.Game/Screens/Select/Carousel/TopLocalRank.cs
index ee3930364b..fc2188e597 100644
--- a/osu.Game/Screens/Select/Carousel/TopLocalRank.cs
+++ b/osu.Game/Screens/Select/Carousel/TopLocalRank.cs
@@ -49,18 +49,18 @@ namespace osu.Game.Screens.Select.Carousel
             {
                 scoreSubscription?.Dispose();
                 scoreSubscription = realmFactory.Register(realm =>
-                    realm.All<ScoreInfo>()
-                         .Filter($"{nameof(ScoreInfo.User)}.{nameof(RealmUser.OnlineID)} == $0"
-                                 + $" && {nameof(ScoreInfo.BeatmapInfo)}.{nameof(BeatmapInfo.ID)} == $1"
-                                 + $" && {nameof(ScoreInfo.Ruleset)}.{nameof(RulesetInfo.ShortName)} == $2"
-                                 + $" && {nameof(ScoreInfo.DeletePending)} == false", api.LocalUser.Value.Id, beatmapInfo.ID, ruleset.Value.ShortName)
-                         .OrderByDescending(s => s.TotalScore)
-                         .QueryAsyncWithNotifications((items, changes, ___) =>
-                         {
-                             Rank = items.FirstOrDefault()?.Rank;
-                             // Required since presence is changed via IsPresent override
-                             Invalidate(Invalidation.Presence);
-                         }));
+                        realm.All<ScoreInfo>()
+                             .Filter($"{nameof(ScoreInfo.User)}.{nameof(RealmUser.OnlineID)} == $0"
+                                     + $" && {nameof(ScoreInfo.BeatmapInfo)}.{nameof(BeatmapInfo.ID)} == $1"
+                                     + $" && {nameof(ScoreInfo.Ruleset)}.{nameof(RulesetInfo.ShortName)} == $2"
+                                     + $" && {nameof(ScoreInfo.DeletePending)} == false", api.LocalUser.Value.Id, beatmapInfo.ID, ruleset.Value.ShortName)
+                             .OrderByDescending(s => s.TotalScore),
+                    (items, changes, ___) =>
+                    {
+                        Rank = items.FirstOrDefault()?.Rank;
+                        // Required since presence is changed via IsPresent override
+                        Invalidate(Invalidation.Presence);
+                    });
             }, true);
         }
 
diff --git a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
index 954c2a6413..463f878e2a 100644
--- a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
+++ b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
@@ -114,13 +114,13 @@ namespace osu.Game.Screens.Select.Leaderboards
                 return;
 
             scoreSubscription = realmFactory.Register(realm =>
-                realm.All<ScoreInfo>()
-                     .Filter($"{nameof(ScoreInfo.BeatmapInfo)}.{nameof(BeatmapInfo.ID)} = $0", beatmapInfo.ID)
-                     .QueryAsyncWithNotifications((_, changes, ___) =>
-                     {
-                         if (!IsOnlineScope)
-                             RefreshScores();
-                     }));
+                    realm.All<ScoreInfo>()
+                         .Filter($"{nameof(ScoreInfo.BeatmapInfo)}.{nameof(BeatmapInfo.ID)} = $0", beatmapInfo.ID),
+                (_, changes, ___) =>
+                {
+                    if (!IsOnlineScope)
+                        RefreshScores();
+                });
         }
 
         protected override void Reset()

From db8639435538108982acffad2d9e8da710dd71e7 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 23 Jan 2022 20:27:35 +0900
Subject: [PATCH 2424/5547] Fix `TestResources` returning a test
 `BeatmapSetInfo` that can't be laoded directly into realm

---
 osu.Game.Tests/Resources/TestResources.cs | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Resources/TestResources.cs b/osu.Game.Tests/Resources/TestResources.cs
index d2cab09ac9..81b624f908 100644
--- a/osu.Game.Tests/Resources/TestResources.cs
+++ b/osu.Game.Tests/Resources/TestResources.cs
@@ -80,7 +80,10 @@ namespace osu.Game.Tests.Resources
         public static BeatmapSetInfo CreateTestBeatmapSetInfo(int? difficultyCount = null, RulesetInfo[] rulesets = null)
         {
             int j = 0;
-            RulesetInfo getRuleset() => rulesets?[j++ % rulesets.Length] ?? new OsuRuleset().RulesetInfo;
+
+            rulesets ??= new[] { new OsuRuleset().RulesetInfo };
+
+            RulesetInfo getRuleset() => rulesets?[j++ % rulesets.Length];
 
             int setId = Interlocked.Increment(ref importId);
 

From 0709a2ac9be3376193a4aeb266b497683b1bde7b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 23 Jan 2022 20:28:13 +0900
Subject: [PATCH 2425/5547] Add test coverage of realm subscription scenarios

---
 .../RealmSubscriptionRegistrationTests.cs     | 138 ++++++++++++++++++
 1 file changed, 138 insertions(+)
 create mode 100644 osu.Game.Tests/Database/RealmSubscriptionRegistrationTests.cs

diff --git a/osu.Game.Tests/Database/RealmSubscriptionRegistrationTests.cs b/osu.Game.Tests/Database/RealmSubscriptionRegistrationTests.cs
new file mode 100644
index 0000000000..16e9f31c7b
--- /dev/null
+++ b/osu.Game.Tests/Database/RealmSubscriptionRegistrationTests.cs
@@ -0,0 +1,138 @@
+// 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.Game.Beatmaps;
+using osu.Game.Rulesets;
+using osu.Game.Tests.Resources;
+using Realms;
+
+#nullable enable
+
+namespace osu.Game.Tests.Database
+{
+    [TestFixture]
+    public class RealmSubscriptionRegistrationTests : RealmTest
+    {
+        [Test]
+        public void TestSubscriptionWithContextLoss()
+        {
+            IEnumerable<BeatmapSetInfo>? resolvedItems = null;
+            ChangeSet? lastChanges = null;
+
+            RunTestWithRealm((realmFactory, _) =>
+            {
+                realmFactory.Write(realm => realm.Add(TestResources.CreateTestBeatmapSetInfo()));
+
+                var registration = realmFactory.Register(realm => realm.All<BeatmapSetInfo>(), onChanged);
+
+                testEventsArriving(true);
+
+                // All normal until here.
+                // Now let's yank the main realm context.
+                resolvedItems = null;
+                lastChanges = null;
+
+                using (realmFactory.BlockAllOperations())
+                    Assert.That(resolvedItems, Is.Empty);
+
+                realmFactory.Write(realm => realm.Add(TestResources.CreateTestBeatmapSetInfo()));
+
+                testEventsArriving(true);
+
+                // Now let's try unsubscribing.
+                resolvedItems = null;
+                lastChanges = null;
+
+                registration.Dispose();
+
+                realmFactory.Write(realm => realm.Add(TestResources.CreateTestBeatmapSetInfo()));
+
+                testEventsArriving(false);
+
+                // And make sure even after another context loss we don't get firings.
+                using (realmFactory.BlockAllOperations())
+                    Assert.That(resolvedItems, Is.Null);
+
+                realmFactory.Write(realm => realm.Add(TestResources.CreateTestBeatmapSetInfo()));
+
+                testEventsArriving(false);
+
+                void testEventsArriving(bool shouldArrive)
+                {
+                    realmFactory.Run(realm => realm.Refresh());
+
+                    if (shouldArrive)
+                        Assert.That(resolvedItems, Has.One.Items);
+                    else
+                        Assert.That(resolvedItems, Is.Null);
+
+                    realmFactory.Write(realm =>
+                    {
+                        realm.RemoveAll<BeatmapSetInfo>();
+                        realm.RemoveAll<RulesetInfo>();
+                    });
+
+                    realmFactory.Run(realm => realm.Refresh());
+
+                    if (shouldArrive)
+                        Assert.That(lastChanges?.DeletedIndices, Has.One.Items);
+                    else
+                        Assert.That(lastChanges, Is.Null);
+                }
+            });
+
+            void onChanged(IRealmCollection<BeatmapSetInfo> sender, ChangeSet? changes, Exception error)
+            {
+                if (changes == null)
+                    resolvedItems = sender;
+
+                lastChanges = changes;
+            }
+        }
+
+        [Test]
+        public void TestCustomRegisterWithContextLoss()
+        {
+            RunTestWithRealm((realmFactory, _) =>
+            {
+                BeatmapSetInfo? beatmapSetInfo = null;
+
+                realmFactory.Write(realm => realm.Add(TestResources.CreateTestBeatmapSetInfo()));
+
+                var subscription = realmFactory.Register(realm =>
+                {
+                    beatmapSetInfo = realm.All<BeatmapSetInfo>().First();
+
+                    return new InvokeOnDisposal(() => beatmapSetInfo = null);
+                });
+
+                Assert.That(beatmapSetInfo, Is.Not.Null);
+
+                using (realmFactory.BlockAllOperations())
+                {
+                    // custom disposal action fired when context lost.
+                    Assert.That(beatmapSetInfo, Is.Null);
+                }
+
+                // re-registration after context restore.
+                realmFactory.Run(realm => realm.Refresh());
+                Assert.That(beatmapSetInfo, Is.Not.Null);
+
+                subscription.Dispose();
+
+                Assert.That(beatmapSetInfo, Is.Null);
+
+                using (realmFactory.BlockAllOperations())
+                    Assert.That(beatmapSetInfo, Is.Null);
+
+                realmFactory.Run(realm => realm.Refresh());
+                Assert.That(beatmapSetInfo, Is.Null);
+            });
+        }
+    }
+}

From 5e7993c35afaae58a3dec41dddd0463b4e07a53a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 23 Jan 2022 20:38:34 +0900
Subject: [PATCH 2426/5547] Post disposal to synchronisation context

---
 osu.Game/Database/RealmContextFactory.cs | 20 +++++++++++++++-----
 1 file changed, 15 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Database/RealmContextFactory.cs b/osu.Game/Database/RealmContextFactory.cs
index 32f7ac99c1..26943c1951 100644
--- a/osu.Game/Database/RealmContextFactory.cs
+++ b/osu.Game/Database/RealmContextFactory.cs
@@ -260,19 +260,29 @@ namespace osu.Game.Database
             if (!ThreadSafety.IsUpdateThread)
                 throw new InvalidOperationException(@$"{nameof(Register)} must be called from the update thread.");
 
+            var syncContext = SynchronizationContext.Current;
+
             registerSubscription(action);
 
             // This token is returned to the consumer only.
             // It will cause the registration to be permanently removed.
             return new InvokeOnDisposal(() =>
             {
-                lock (contextLock)
+                if (ThreadSafety.IsUpdateThread)
+                    unsubscribe();
+                else
+                    syncContext.Post(_ => unsubscribe(), null);
+
+                void unsubscribe()
                 {
-                    if (customSubscriptionActions.TryGetValue(action, out var unsubscriptionAction))
+                    lock (contextLock)
                     {
-                        unsubscriptionAction?.Dispose();
-                        customSubscriptionActions.Remove(action);
-                        realmSubscriptionsResetMap.Remove(action);
+                        if (customSubscriptionActions.TryGetValue(action, out var unsubscriptionAction))
+                        {
+                            unsubscriptionAction?.Dispose();
+                            customSubscriptionActions.Remove(action);
+                            realmSubscriptionsResetMap.Remove(action);
+                        }
                     }
                 }
             });

From 249f0f9697f828649c1734eeec281e0b0876ba77 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 23 Jan 2022 23:15:39 +0900
Subject: [PATCH 2427/5547] Add more lengthy comment explaining cyclic
 avoidance
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/Database/RealmContextFactory.cs | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Database/RealmContextFactory.cs b/osu.Game/Database/RealmContextFactory.cs
index 26943c1951..c8fa298f91 100644
--- a/osu.Game/Database/RealmContextFactory.cs
+++ b/osu.Game/Database/RealmContextFactory.cs
@@ -292,7 +292,9 @@ namespace osu.Game.Database
         {
             Debug.Assert(ThreadSafety.IsUpdateThread);
 
-            // Get context outside of flag update to ensure beyond doubt this can't be cyclic.
+            // Retrieve context outside of flag update to ensure that the context is constructed,
+            // as attempting to access it inside the subscription if it's not constructed would lead to
+            // cyclic invocations of the subscription callback.
             var realm = Context;
 
             lock (contextLock)

From deb167086212faa8d6c51fe911bcd54c1cc85c73 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 23 Jan 2022 23:17:33 +0900
Subject: [PATCH 2428/5547] Use `Array.Empty` instead of constructed list

---
 osu.Game/Database/EmptyRealmSet.cs | 42 +++++-------------------------
 1 file changed, 7 insertions(+), 35 deletions(-)

diff --git a/osu.Game/Database/EmptyRealmSet.cs b/osu.Game/Database/EmptyRealmSet.cs
index 2fecfcbe07..b7f27ba035 100644
--- a/osu.Game/Database/EmptyRealmSet.cs
+++ b/osu.Game/Database/EmptyRealmSet.cs
@@ -15,21 +15,14 @@ namespace osu.Game.Database
 {
     public class EmptyRealmSet<T> : IRealmCollection<T>
     {
-        private static List<T> emptySet => new List<T>();
-
-        public IEnumerator<T> GetEnumerator()
-        {
-            return emptySet.GetEnumerator();
-        }
-
-        IEnumerator IEnumerable.GetEnumerator()
-        {
-            return ((IEnumerable)emptySet).GetEnumerator();
-        }
+        private IList<T> emptySet => Array.Empty<T>();
 
+        public IEnumerator<T> GetEnumerator() => emptySet.GetEnumerator();
+        IEnumerator IEnumerable.GetEnumerator() => emptySet.GetEnumerator();
         public int Count => emptySet.Count;
-
         public T this[int index] => emptySet[index];
+        public int IndexOf(object item) => emptySet.IndexOf((T)item);
+        public bool Contains(object item) => emptySet.Contains((T)item);
 
         public event NotifyCollectionChangedEventHandler? CollectionChanged
         {
@@ -43,32 +36,11 @@ namespace osu.Game.Database
             remove => throw new NotImplementedException();
         }
 
-        public int IndexOf(object item)
-        {
-            return emptySet.IndexOf((T)item);
-        }
-
-        public bool Contains(object item)
-        {
-            return emptySet.Contains((T)item);
-        }
-
-        public IRealmCollection<T> Freeze()
-        {
-            throw new NotImplementedException();
-        }
-
-        public IDisposable SubscribeForNotifications(NotificationCallbackDelegate<T> callback)
-        {
-            throw new NotImplementedException();
-        }
-
+        public IRealmCollection<T> Freeze() => throw new NotImplementedException();
+        public IDisposable SubscribeForNotifications(NotificationCallbackDelegate<T> callback) => throw new NotImplementedException();
         public bool IsValid => throw new NotImplementedException();
-
         public Realm Realm => throw new NotImplementedException();
-
         public ObjectSchema ObjectSchema => throw new NotImplementedException();
-
         public bool IsFrozen => throw new NotImplementedException();
     }
 }

From 351c766ea1f211b8eebe8ff58cb7d5fd0e813739 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 23 Jan 2022 23:20:03 +0900
Subject: [PATCH 2429/5547] Fix one remaining instance of realm query as
 property

---
 osu.Game/Overlays/MusicController.cs | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Overlays/MusicController.cs b/osu.Game/Overlays/MusicController.cs
index 24d907285a..8caa69e78c 100644
--- a/osu.Game/Overlays/MusicController.cs
+++ b/osu.Game/Overlays/MusicController.cs
@@ -80,9 +80,10 @@ namespace osu.Game.Overlays
             mods.BindValueChanged(_ => ResetTrackAdjustments(), true);
         }
 
-        private IQueryable<BeatmapSetInfo> availableBeatmaps => realmFactory.Context
-                                                                            .All<BeatmapSetInfo>()
-                                                                            .Where(s => !s.DeletePending);
+        private IQueryable<BeatmapSetInfo> queryRealmBeatmapSets() =>
+            realmFactory.Context
+                        .All<BeatmapSetInfo>()
+                        .Where(s => !s.DeletePending);
 
         protected override void LoadComplete()
         {
@@ -90,10 +91,10 @@ namespace osu.Game.Overlays
 
             // ensure we're ready before completing async load.
             // probably not a good way of handling this (as there is a period we aren't watching for changes until the realm subscription finishes up.
-            foreach (var s in availableBeatmaps)
+            foreach (var s in queryRealmBeatmapSets())
                 beatmapSets.Add(s.Detach());
 
-            beatmapSubscription = realmFactory.Register(realm => availableBeatmaps, beatmapsChanged);
+            beatmapSubscription = realmFactory.Register(realm => queryRealmBeatmapSets(), beatmapsChanged);
         }
 
         private void beatmapsChanged(IRealmCollection<BeatmapSetInfo> sender, ChangeSet changes, Exception error)

From 4e5a1f27a8c35f462385dfecdeffe9e11d8c14b6 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 23 Jan 2022 15:14:53 +0100
Subject: [PATCH 2430/5547] Initialise `Simple{Triple,Quadruple}` only once
 ever rather than create every time

---
 osu.Game/Beatmaps/Timing/TimeSignature.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Beatmaps/Timing/TimeSignature.cs b/osu.Game/Beatmaps/Timing/TimeSignature.cs
index 5bfeea5e9b..eebbcc34cd 100644
--- a/osu.Game/Beatmaps/Timing/TimeSignature.cs
+++ b/osu.Game/Beatmaps/Timing/TimeSignature.cs
@@ -27,8 +27,8 @@ namespace osu.Game.Beatmaps.Timing
             Numerator = numerator;
         }
 
-        public static TimeSignature SimpleTriple => new TimeSignature(3);
-        public static TimeSignature SimpleQuadruple => new TimeSignature(4);
+        public static TimeSignature SimpleTriple { get; } = new TimeSignature(3);
+        public static TimeSignature SimpleQuadruple { get; } = new TimeSignature(4);
 
         public override string ToString() => $"{Numerator}/4";
 

From bd748686fad63ccb40f13ae9498a53f2c3f47570 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 23 Jan 2022 15:20:51 +0100
Subject: [PATCH 2431/5547] Adjust spacing of time signature numerator input
 box

---
 osu.Game/Screens/Edit/Timing/LabelledTimeSignature.cs | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/Edit/Timing/LabelledTimeSignature.cs b/osu.Game/Screens/Edit/Timing/LabelledTimeSignature.cs
index 66bd341393..51b58bd3dc 100644
--- a/osu.Game/Screens/Edit/Timing/LabelledTimeSignature.cs
+++ b/osu.Game/Screens/Edit/Timing/LabelledTimeSignature.cs
@@ -57,8 +57,12 @@ namespace osu.Game.Screens.Edit.Timing
                         {
                             Anchor = Anchor.CentreLeft,
                             Origin = Anchor.CentreLeft,
-                            Margin = new MarginPadding(10),
-                            Text = "/4",
+                            Margin = new MarginPadding
+                            {
+                                Left = 5,
+                                Right = CONTENT_PADDING_HORIZONTAL
+                            },
+                            Text = "/ 4",
                             Font = OsuFont.Default.With(size: 20)
                         }
                     }

From e236f5d604ee30d92fffccac17702ea4d341abc2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 23 Jan 2022 20:28:19 +0100
Subject: [PATCH 2432/5547] Add failing test coverage for correct beatmap
 filename generation on save

---
 osu.Game.Tests/Visual/Editing/TestSceneEditorSaving.cs | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneEditorSaving.cs b/osu.Game.Tests/Visual/Editing/TestSceneEditorSaving.cs
index f89be0adf3..bf3b46c6f7 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneEditorSaving.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneEditorSaving.cs
@@ -46,6 +46,7 @@ namespace osu.Game.Tests.Visual.Editing
                 editorBeatmap.BeatmapInfo.Metadata.Artist = "artist";
                 editorBeatmap.BeatmapInfo.Metadata.Title = "title";
             });
+            AddStep("Set author", () => editorBeatmap.BeatmapInfo.Metadata.Author.Username = "author");
             AddStep("Set difficulty name", () => editorBeatmap.BeatmapInfo.DifficultyName = "difficulty");
 
             AddStep("Add timing point", () => editorBeatmap.ControlPointInfo.Add(0, new TimingControlPoint()));
@@ -64,6 +65,7 @@ namespace osu.Game.Tests.Visual.Editing
             AddStep("Save", () => InputManager.Keys(PlatformAction.Save));
 
             checkMutations();
+            AddAssert("Beatmap has correct .osu file path", () => editorBeatmap.BeatmapInfo.Path == "artist - title (author) [difficulty].osu");
 
             AddStep("Exit", () => InputManager.Key(Key.Escape));
 
@@ -88,6 +90,7 @@ namespace osu.Game.Tests.Visual.Editing
             AddAssert("Beatmap contains single hitcircle", () => editorBeatmap.HitObjects.Count == 1);
             AddAssert("Beatmap has correct overall difficulty", () => editorBeatmap.Difficulty.OverallDifficulty == 7);
             AddAssert("Beatmap has correct metadata", () => editorBeatmap.BeatmapInfo.Metadata.Artist == "artist" && editorBeatmap.BeatmapInfo.Metadata.Title == "title");
+            AddAssert("Beatmap has correct author", () => editorBeatmap.BeatmapInfo.Metadata.Author.Username == "author");
             AddAssert("Beatmap has correct difficulty name", () => editorBeatmap.BeatmapInfo.DifficultyName == "difficulty");
         }
     }

From 838a9f69ed078e6e954ca393e1aa5d6fee9ac4b1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 23 Jan 2022 19:41:41 +0100
Subject: [PATCH 2433/5547] Fix saved beatmap filename depending on
 `ToString()` implementation

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

diff --git a/osu.Game/Beatmaps/BeatmapModelManager.cs b/osu.Game/Beatmaps/BeatmapModelManager.cs
index 44d6af5b73..ead86c1059 100644
--- a/osu.Game/Beatmaps/BeatmapModelManager.cs
+++ b/osu.Game/Beatmaps/BeatmapModelManager.cs
@@ -88,7 +88,7 @@ namespace osu.Game.Beatmaps
         private static string getFilename(BeatmapInfo beatmapInfo)
         {
             var metadata = beatmapInfo.Metadata;
-            return $"{metadata.Artist} - {metadata.Title} ({metadata.Author}) [{beatmapInfo.DifficultyName}].osu".GetValidArchiveContentFilename();
+            return $"{metadata.Artist} - {metadata.Title} ({metadata.Author.Username}) [{beatmapInfo.DifficultyName}].osu".GetValidArchiveContentFilename();
         }
 
         /// <summary>

From ed84ae0ac0d8f57f66ee7e2360b3259e6a786e2c Mon Sep 17 00:00:00 2001
From: mk-56 <darioheadleysilva@gmail.com>
Date: Mon, 24 Jan 2022 00:42:43 +0100
Subject: [PATCH 2434/5547] Adjust values to Bdach's refined taste

---
 .../Mods/CatchModFlashlight.cs                | 22 ++++++++++++-------
 .../Mods/ManiaModFlashlight.cs                | 20 +++++++++++------
 .../Mods/OsuModFlashlight.cs                  | 22 ++++++++++++-------
 .../Mods/TaikoModFlashlight.cs                | 22 ++++++++++++-------
 osu.Game/Rulesets/Mods/ModFlashlight.cs       | 13 +++++++----
 5 files changed, 64 insertions(+), 35 deletions(-)

diff --git a/osu.Game.Rulesets.Catch/Mods/CatchModFlashlight.cs b/osu.Game.Rulesets.Catch/Mods/CatchModFlashlight.cs
index f75772b04e..e8f1ebdd10 100644
--- a/osu.Game.Rulesets.Catch/Mods/CatchModFlashlight.cs
+++ b/osu.Game.Rulesets.Catch/Mods/CatchModFlashlight.cs
@@ -26,14 +26,20 @@ namespace osu.Game.Rulesets.Catch.Mods
         [SettingSource("Initial radius", "Initial radius of the flashlight area.")]
         public override BindableNumber<float> InitialRadius { get; } = new BindableNumber<float>
         {
-            MinValue = 150f,
-            MaxValue = 600f,
-            Default = 350f,
-            Value = 350f,
-            Precision = 5f
+            MinValue = 0.4f,
+            MaxValue = 1.7f,
+            Default = 1f,
+            Value = 1f,
+            Precision = 0.1f
         };
 
-        public override Flashlight CreateFlashlight() => new CatchFlashlight(playfield, ChangeRadius.Value, InitialRadius.Value);
+        protected override BindableNumber<float> ModeMultiplier { get; } = new BindableNumber<float>
+        {
+            Default = 350,
+            Value = 350,
+        };
+
+        public override Flashlight CreateFlashlight() => new CatchFlashlight(playfield, ChangeRadius.Value, InitialRadius.Value, ModeMultiplier.Value);
 
         private CatchPlayfield playfield;
 
@@ -47,8 +53,8 @@ namespace osu.Game.Rulesets.Catch.Mods
         {
             private readonly CatchPlayfield playfield;
 
-            public CatchFlashlight(CatchPlayfield playfield, bool isRadiusBasedOnCombo, float initialRadius)
-                : base(isRadiusBasedOnCombo, initialRadius)
+            public CatchFlashlight(CatchPlayfield playfield, bool isRadiusBasedOnCombo, float initialRadius, float modeMultiplier)
+                : base(isRadiusBasedOnCombo, initialRadius, modeMultiplier)
             {
                 this.playfield = playfield;
                 FlashlightSize = new Vector2(0, GetRadiusFor(0));
diff --git a/osu.Game.Rulesets.Mania/Mods/ManiaModFlashlight.cs b/osu.Game.Rulesets.Mania/Mods/ManiaModFlashlight.cs
index a6a3c3be73..9ca1a72584 100644
--- a/osu.Game.Rulesets.Mania/Mods/ManiaModFlashlight.cs
+++ b/osu.Game.Rulesets.Mania/Mods/ManiaModFlashlight.cs
@@ -28,20 +28,26 @@ namespace osu.Game.Rulesets.Mania.Mods
         public override BindableNumber<float> InitialRadius { get; } = new BindableNumber<float>
         {
             MinValue = 0f,
-            MaxValue = 230f,
-            Default = 50f,
-            Value = 50f,
-            Precision = 5f
+            MaxValue = 4.5f,
+            Default = 1f,
+            Value = 1f,
+            Precision = 0.1f
         };
 
-        public override Flashlight CreateFlashlight() => new ManiaFlashlight(ChangeRadius.Value, InitialRadius.Value);
+        protected override BindableNumber<float> ModeMultiplier { get; } = new BindableNumber<float>
+        {
+            Default = 50,
+            Value = 50,
+        };
+
+        public override Flashlight CreateFlashlight() => new ManiaFlashlight(ChangeRadius.Value, InitialRadius.Value, ModeMultiplier.Value);
 
         private class ManiaFlashlight : Flashlight
         {
             private readonly LayoutValue flashlightProperties = new LayoutValue(Invalidation.DrawSize);
 
-            public ManiaFlashlight(bool isRadiusBasedOnCombo, float initialRadius)
-                : base(isRadiusBasedOnCombo, initialRadius)
+            public ManiaFlashlight(bool isRadiusBasedOnCombo, float initialRadius, float modeMultiplier)
+                : base(isRadiusBasedOnCombo, initialRadius, modeMultiplier)
             {
                 FlashlightSize = new Vector2(DrawWidth, GetRadiusFor(0));
 
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModFlashlight.cs b/osu.Game.Rulesets.Osu/Mods/OsuModFlashlight.cs
index e2a6d0f0dc..c6cf5ce4b5 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModFlashlight.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModFlashlight.cs
@@ -40,16 +40,22 @@ namespace osu.Game.Rulesets.Osu.Mods
         [SettingSource("Initial radius", "Initial radius of the flashlight area.")]
         public override BindableNumber<float> InitialRadius { get; } = new BindableNumber<float>
         {
-            MinValue = 90f,
-            MaxValue = 360f,
-            Default = 180f,
-            Value = 180f,
-            Precision = 5f
+            MinValue = 0.5f,
+            MaxValue = 2f,
+            Default = 1f,
+            Value = 1f,
+            Precision = 0.1f
+        };
+
+        protected override BindableNumber<float> ModeMultiplier { get; } = new BindableNumber<float>
+        {
+            Default = 180,
+            Value = 180,
         };
 
         private OsuFlashlight flashlight;
 
-        public override Flashlight CreateFlashlight() => flashlight = new OsuFlashlight(ChangeRadius.Value, InitialRadius.Value, FollowDelay.Value);
+        public override Flashlight CreateFlashlight() => flashlight = new OsuFlashlight(ChangeRadius.Value, InitialRadius.Value, FollowDelay.Value, ModeMultiplier.Value);
 
         public void ApplyToDrawableHitObject(DrawableHitObject drawable)
         {
@@ -64,8 +70,8 @@ namespace osu.Game.Rulesets.Osu.Mods
             //public float InitialRadius { private get; set; }
             public bool ChangeRadius { private get; set; }
 
-            public OsuFlashlight(bool isRadiusBasedOnCombo, float initialRadius, double followDelay)
-                : base(isRadiusBasedOnCombo, initialRadius)
+            public OsuFlashlight(bool isRadiusBasedOnCombo, float initialRadius, double followDelay, float modeMultiplier)
+                : base(isRadiusBasedOnCombo, initialRadius, modeMultiplier)
             {
                 FollowDelay = followDelay;
 
diff --git a/osu.Game.Rulesets.Taiko/Mods/TaikoModFlashlight.cs b/osu.Game.Rulesets.Taiko/Mods/TaikoModFlashlight.cs
index 71c9d777ec..f235698b55 100644
--- a/osu.Game.Rulesets.Taiko/Mods/TaikoModFlashlight.cs
+++ b/osu.Game.Rulesets.Taiko/Mods/TaikoModFlashlight.cs
@@ -27,14 +27,20 @@ namespace osu.Game.Rulesets.Taiko.Mods
         [SettingSource("Initial radius", "Initial radius of the flashlight area.")]
         public override BindableNumber<float> InitialRadius { get; } = new BindableNumber<float>
         {
-            MinValue = 0f,
-            MaxValue = 400f,
-            Default = 250f,
-            Value = 250f,
-            Precision = 5f
+            MinValue = 0,
+            MaxValue = 1.66f,
+            Default = 1f,
+            Value = 1f,
+            Precision = 0.1f
         };
 
-        public override Flashlight CreateFlashlight() => new TaikoFlashlight(playfield, ChangeRadius.Value, InitialRadius.Value);
+        protected override BindableNumber<float> ModeMultiplier { get; } = new BindableNumber<float>
+        {
+            Default = 250,
+            Value = 250,
+        };
+
+        public override Flashlight CreateFlashlight() => new TaikoFlashlight(playfield, ChangeRadius.Value, InitialRadius.Value, ModeMultiplier.Value);
 
         private TaikoPlayfield playfield;
 
@@ -49,8 +55,8 @@ namespace osu.Game.Rulesets.Taiko.Mods
             private readonly LayoutValue flashlightProperties = new LayoutValue(Invalidation.DrawSize);
             private readonly TaikoPlayfield taikoPlayfield;
 
-            public TaikoFlashlight(TaikoPlayfield taikoPlayfield, bool isRadiusBasedOnCombo, float initialRadius)
-                : base(isRadiusBasedOnCombo, initialRadius)
+            public TaikoFlashlight(TaikoPlayfield taikoPlayfield, bool isRadiusBasedOnCombo, float initialRadius, float modeMultiplier)
+                : base(isRadiusBasedOnCombo, initialRadius, modeMultiplier)
             {
                 this.taikoPlayfield = taikoPlayfield;
                 FlashlightSize = getSizeFor(0);
diff --git a/osu.Game/Rulesets/Mods/ModFlashlight.cs b/osu.Game/Rulesets/Mods/ModFlashlight.cs
index 51006d96e8..d16f310582 100644
--- a/osu.Game/Rulesets/Mods/ModFlashlight.cs
+++ b/osu.Game/Rulesets/Mods/ModFlashlight.cs
@@ -38,6 +38,8 @@ namespace osu.Game.Rulesets.Mods
 
         [SettingSource("Initial radius", "Initial radius of the flashlight area.")]
         public abstract BindableNumber<float> InitialRadius { get; }
+
+        protected abstract BindableNumber<float> ModeMultiplier { get; }
     }
 
     public abstract class ModFlashlight<T> : ModFlashlight, IApplicableToDrawableRuleset<T>, IApplicableToScoreProcessor
@@ -100,10 +102,13 @@ namespace osu.Game.Rulesets.Mods
 
             public readonly float InitialRadius;
 
-            protected Flashlight(bool isRadiusBasedOnCombo, float initialRadius)
+            public readonly float ModeMultiplier;
+
+            protected Flashlight(bool isRadiusBasedOnCombo, float initialRadius, float modeMultiplier)
             {
                 IsRadiusBasedOnCombo = isRadiusBasedOnCombo;
                 InitialRadius = initialRadius;
+                ModeMultiplier = modeMultiplier;
             }
 
             [BackgroundDependencyLoader]
@@ -142,12 +147,12 @@ namespace osu.Game.Rulesets.Mods
                 if (IsRadiusBasedOnCombo)
                 {
                     if (combo > 200)
-                        return InitialRadius * 0.8f;
+                        return InitialRadius * 0.8f * ModeMultiplier;
                     else if (combo > 100)
-                        return InitialRadius * 0.9f;
+                        return InitialRadius * 0.9f * ModeMultiplier;
                 }
 
-                return InitialRadius;
+                return InitialRadius * ModeMultiplier;
             }
 
             private Vector2 flashlightPosition;

From 997c13f64367f07fcd81f0107408774d2f0fd241 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 24 Jan 2022 13:36:51 +0900
Subject: [PATCH 2435/5547] Add locking over `realmSubscriptionsResetMap` for
 sanity

---
 osu.Game/Database/RealmContextFactory.cs | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Database/RealmContextFactory.cs b/osu.Game/Database/RealmContextFactory.cs
index c8fa298f91..522a5fdfd9 100644
--- a/osu.Game/Database/RealmContextFactory.cs
+++ b/osu.Game/Database/RealmContextFactory.cs
@@ -243,9 +243,11 @@ namespace osu.Game.Database
             if (!ThreadSafety.IsUpdateThread)
                 throw new InvalidOperationException(@$"{nameof(Register)} must be called from the update thread.");
 
-            realmSubscriptionsResetMap.Add(action, () => onChanged(new EmptyRealmSet<T>(), null, null));
-
-            return Register(action);
+            lock (contextLock)
+            {
+                realmSubscriptionsResetMap.Add(action, () => onChanged(new EmptyRealmSet<T>(), null, null));
+                return Register(action);
+            }
 
             IDisposable? action(Realm realm) => query(realm).QueryAsyncWithNotifications(onChanged);
         }

From d7a9c5fd410e370f89e83ef1bd3475a418ffe4ed Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 24 Jan 2022 14:36:48 +0900
Subject: [PATCH 2436/5547] Add settings buttons to allow temporarily blocking
 realm access

---
 .../Sections/DebugSettings/MemorySettings.cs  | 42 +++++++++++++++++++
 1 file changed, 42 insertions(+)

diff --git a/osu.Game/Overlays/Settings/Sections/DebugSettings/MemorySettings.cs b/osu.Game/Overlays/Settings/Sections/DebugSettings/MemorySettings.cs
index 8d4fc5fc9f..f058c274e4 100644
--- a/osu.Game/Overlays/Settings/Sections/DebugSettings/MemorySettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/DebugSettings/MemorySettings.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.Threading;
+using System.Threading.Tasks;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Localisation;
@@ -17,6 +19,9 @@ namespace osu.Game.Overlays.Settings.Sections.DebugSettings
         [BackgroundDependencyLoader]
         private void load(GameHost host, RealmContextFactory realmFactory)
         {
+            SettingsButton blockAction;
+            SettingsButton unblockAction;
+
             Children = new Drawable[]
             {
                 new SettingsButton
@@ -35,6 +40,43 @@ namespace osu.Game.Overlays.Settings.Sections.DebugSettings
                         }
                     }
                 },
+                blockAction = new SettingsButton
+                {
+                    Text = "Block realm",
+                },
+                unblockAction = new SettingsButton
+                {
+                    Text = "Unblock realm",
+                },
+            };
+
+            blockAction.Action = () =>
+            {
+                var blocking = realmFactory.BlockAllOperations();
+                blockAction.Enabled.Value = false;
+
+                // As a safety measure, unblock after 10 seconds.
+                // This is to handle the case where a dev may block, but then something on the update thread
+                // accesses realm and blocks for eternity.
+                Task.Factory.StartNew(() =>
+                {
+                    Thread.Sleep(10000);
+                    unblock();
+                });
+
+                unblockAction.Action = unblock;
+
+                void unblock()
+                {
+                    blocking?.Dispose();
+                    blocking = null;
+
+                    Scheduler.Add(() =>
+                    {
+                        blockAction.Enabled.Value = true;
+                        unblockAction.Action = null;
+                    });
+                }
             };
         }
     }

From 40aa8731900bd7f856e5f5b417aa85897bf79f0f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 24 Jan 2022 14:37:36 +0900
Subject: [PATCH 2437/5547] Rename register methods to better explain their
 purpose

---
 osu.Game.Tests/Database/GeneralUsageTests.cs   |  2 +-
 osu.Game.Tests/Database/RealmLiveTests.cs      |  2 +-
 .../RealmSubscriptionRegistrationTests.cs      |  4 ++--
 osu.Game/Database/RealmContextFactory.cs       | 18 +++++++++---------
 osu.Game/Database/RealmObjectExtensions.cs     |  2 +-
 .../Bindings/DatabasedKeyBindingContainer.cs   |  2 +-
 osu.Game/Online/BeatmapDownloadTracker.cs      |  2 +-
 .../OnlinePlayBeatmapAvailabilityTracker.cs    |  2 +-
 osu.Game/Online/ScoreDownloadTracker.cs        |  2 +-
 osu.Game/Overlays/MusicController.cs           |  2 +-
 .../Overlays/Settings/Sections/SkinSection.cs  |  2 +-
 osu.Game/Screens/Select/BeatmapCarousel.cs     |  8 ++++----
 .../Screens/Select/Carousel/TopLocalRank.cs    |  2 +-
 .../Select/Leaderboards/BeatmapLeaderboard.cs  |  2 +-
 osu.Game/Screens/Spectate/SpectatorScreen.cs   |  2 +-
 15 files changed, 27 insertions(+), 27 deletions(-)

diff --git a/osu.Game.Tests/Database/GeneralUsageTests.cs b/osu.Game.Tests/Database/GeneralUsageTests.cs
index c82c1b6e59..3c62153d9e 100644
--- a/osu.Game.Tests/Database/GeneralUsageTests.cs
+++ b/osu.Game.Tests/Database/GeneralUsageTests.cs
@@ -46,7 +46,7 @@ namespace osu.Game.Tests.Database
             {
                 bool callbackRan = false;
 
-                realmFactory.Register(realm =>
+                realmFactory.RegisterCustomSubscription(realm =>
                 {
                     var subscription = realm.All<BeatmapInfo>().QueryAsyncWithNotifications((sender, changes, error) =>
                     {
diff --git a/osu.Game.Tests/Database/RealmLiveTests.cs b/osu.Game.Tests/Database/RealmLiveTests.cs
index 0e6ad910d9..d53fcb9ac7 100644
--- a/osu.Game.Tests/Database/RealmLiveTests.cs
+++ b/osu.Game.Tests/Database/RealmLiveTests.cs
@@ -239,7 +239,7 @@ namespace osu.Game.Tests.Database
             {
                 int changesTriggered = 0;
 
-                realmFactory.Register(outerRealm =>
+                realmFactory.RegisterCustomSubscription(outerRealm =>
                 {
                     outerRealm.All<BeatmapInfo>().QueryAsyncWithNotifications(gotChange);
                     ILive<BeatmapInfo>? liveBeatmap = null;
diff --git a/osu.Game.Tests/Database/RealmSubscriptionRegistrationTests.cs b/osu.Game.Tests/Database/RealmSubscriptionRegistrationTests.cs
index 16e9f31c7b..1799b95905 100644
--- a/osu.Game.Tests/Database/RealmSubscriptionRegistrationTests.cs
+++ b/osu.Game.Tests/Database/RealmSubscriptionRegistrationTests.cs
@@ -28,7 +28,7 @@ namespace osu.Game.Tests.Database
             {
                 realmFactory.Write(realm => realm.Add(TestResources.CreateTestBeatmapSetInfo()));
 
-                var registration = realmFactory.Register(realm => realm.All<BeatmapSetInfo>(), onChanged);
+                var registration = realmFactory.RegisterForNotifications(realm => realm.All<BeatmapSetInfo>(), onChanged);
 
                 testEventsArriving(true);
 
@@ -104,7 +104,7 @@ namespace osu.Game.Tests.Database
 
                 realmFactory.Write(realm => realm.Add(TestResources.CreateTestBeatmapSetInfo()));
 
-                var subscription = realmFactory.Register(realm =>
+                var subscription = realmFactory.RegisterCustomSubscription(realm =>
                 {
                     beatmapSetInfo = realm.All<BeatmapSetInfo>().First();
 
diff --git a/osu.Game/Database/RealmContextFactory.cs b/osu.Game/Database/RealmContextFactory.cs
index 522a5fdfd9..697caf8cd3 100644
--- a/osu.Game/Database/RealmContextFactory.cs
+++ b/osu.Game/Database/RealmContextFactory.cs
@@ -63,6 +63,10 @@ namespace osu.Game.Database
 
         private readonly ThreadLocal<bool> currentThreadCanCreateContexts = new ThreadLocal<bool>();
 
+        private readonly Dictionary<Func<Realm, IDisposable?>, IDisposable?> customSubscriptionActions = new Dictionary<Func<Realm, IDisposable?>, IDisposable?>();
+
+        private readonly Dictionary<Func<Realm, IDisposable?>, Action> realmSubscriptionsResetMap = new Dictionary<Func<Realm, IDisposable?>, Action>();
+
         private static readonly GlobalStatistic<int> contexts_created = GlobalStatistics.Get<int>(@"Realm", @"Contexts (Created)");
 
         private readonly object contextLock = new object();
@@ -233,20 +237,16 @@ namespace osu.Game.Database
             }
         }
 
-        private readonly Dictionary<Func<Realm, IDisposable?>, IDisposable?> customSubscriptionActions = new Dictionary<Func<Realm, IDisposable?>, IDisposable?>();
-
-        private readonly Dictionary<Func<Realm, IDisposable?>, Action> realmSubscriptionsResetMap = new Dictionary<Func<Realm, IDisposable?>, Action>();
-
-        public IDisposable Register<T>(Func<Realm, IQueryable<T>> query, NotificationCallbackDelegate<T> onChanged)
+        public IDisposable RegisterForNotifications<T>(Func<Realm, IQueryable<T>> query, NotificationCallbackDelegate<T> onChanged)
             where T : RealmObjectBase
         {
             if (!ThreadSafety.IsUpdateThread)
-                throw new InvalidOperationException(@$"{nameof(Register)} must be called from the update thread.");
+                throw new InvalidOperationException(@$"{nameof(RegisterForNotifications)} must be called from the update thread.");
 
             lock (contextLock)
             {
                 realmSubscriptionsResetMap.Add(action, () => onChanged(new EmptyRealmSet<T>(), null, null));
-                return Register(action);
+                return RegisterCustomSubscription(action);
             }
 
             IDisposable? action(Realm realm) => query(realm).QueryAsyncWithNotifications(onChanged);
@@ -257,10 +257,10 @@ namespace osu.Game.Database
         /// </summary>
         /// <param name="action">The work to run. Return value should be an <see cref="IDisposable"/> from QueryAsyncWithNotifications, or an <see cref="InvokeOnDisposal"/> to clean up any bindings.</param>
         /// <returns>An <see cref="IDisposable"/> which should be disposed to unsubscribe any inner subscription.</returns>
-        public IDisposable Register(Func<Realm, IDisposable?> action)
+        public IDisposable RegisterCustomSubscription(Func<Realm, IDisposable?> action)
         {
             if (!ThreadSafety.IsUpdateThread)
-                throw new InvalidOperationException(@$"{nameof(Register)} must be called from the update thread.");
+                throw new InvalidOperationException(@$"{nameof(RegisterForNotifications)} must be called from the update thread.");
 
             var syncContext = SynchronizationContext.Current;
 
diff --git a/osu.Game/Database/RealmObjectExtensions.cs b/osu.Game/Database/RealmObjectExtensions.cs
index c30e1699b9..d9026d165d 100644
--- a/osu.Game/Database/RealmObjectExtensions.cs
+++ b/osu.Game/Database/RealmObjectExtensions.cs
@@ -272,7 +272,7 @@ namespace osu.Game.Database
             where T : RealmObjectBase
         {
             if (!RealmContextFactory.CurrentThreadSubscriptionsAllowed)
-                throw new InvalidOperationException($"Make sure to call {nameof(RealmContextFactory)}.{nameof(RealmContextFactory.Register)}");
+                throw new InvalidOperationException($"Make sure to call {nameof(RealmContextFactory)}.{nameof(RealmContextFactory.RegisterForNotifications)}");
 
             return collection.SubscribeForNotifications(callback);
         }
diff --git a/osu.Game/Input/Bindings/DatabasedKeyBindingContainer.cs b/osu.Game/Input/Bindings/DatabasedKeyBindingContainer.cs
index 4ad5693867..9cd9865441 100644
--- a/osu.Game/Input/Bindings/DatabasedKeyBindingContainer.cs
+++ b/osu.Game/Input/Bindings/DatabasedKeyBindingContainer.cs
@@ -55,7 +55,7 @@ namespace osu.Game.Input.Bindings
 
         protected override void LoadComplete()
         {
-            realmSubscription = realmFactory.Register(realm => queryRealmKeyBindings(), (sender, changes, error) =>
+            realmSubscription = realmFactory.RegisterForNotifications(realm => queryRealmKeyBindings(), (sender, changes, error) =>
             {
                 // The first fire of this is a bit redundant as this is being called in base.LoadComplete,
                 // but this is safest in case the subscription is restored after a context recycle.
diff --git a/osu.Game/Online/BeatmapDownloadTracker.cs b/osu.Game/Online/BeatmapDownloadTracker.cs
index 70599a167b..3f45afb6b2 100644
--- a/osu.Game/Online/BeatmapDownloadTracker.cs
+++ b/osu.Game/Online/BeatmapDownloadTracker.cs
@@ -42,7 +42,7 @@ namespace osu.Game.Online
             // Used to interact with manager classes that don't support interface types. Will eventually be replaced.
             var beatmapSetInfo = new BeatmapSetInfo { OnlineID = TrackedItem.OnlineID };
 
-            realmSubscription = realmContextFactory.Register(realm => realm.All<BeatmapSetInfo>().Where(s => s.OnlineID == TrackedItem.OnlineID && !s.DeletePending), (items, changes, ___) =>
+            realmSubscription = realmContextFactory.RegisterForNotifications(realm => realm.All<BeatmapSetInfo>().Where(s => s.OnlineID == TrackedItem.OnlineID && !s.DeletePending), (items, changes, ___) =>
             {
                 if (items.Any())
                     Schedule(() => UpdateState(DownloadState.LocallyAvailable));
diff --git a/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs b/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs
index 8dd28f5417..28c41bec33 100644
--- a/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs
+++ b/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs
@@ -78,7 +78,7 @@ namespace osu.Game.Online.Rooms
 
                 // handles changes to hash that didn't occur from the import process (ie. a user editing the beatmap in the editor, somehow).
                 realmSubscription?.Dispose();
-                realmSubscription = realmContextFactory.Register(realm => filteredBeatmaps(), (items, changes, ___) =>
+                realmSubscription = realmContextFactory.RegisterForNotifications(realm => filteredBeatmaps(), (items, changes, ___) =>
                 {
                     if (changes == null)
                         return;
diff --git a/osu.Game/Online/ScoreDownloadTracker.cs b/osu.Game/Online/ScoreDownloadTracker.cs
index 72e95bd6df..64ceee9fe6 100644
--- a/osu.Game/Online/ScoreDownloadTracker.cs
+++ b/osu.Game/Online/ScoreDownloadTracker.cs
@@ -47,7 +47,7 @@ namespace osu.Game.Online
             Downloader.DownloadBegan += downloadBegan;
             Downloader.DownloadFailed += downloadFailed;
 
-            realmSubscription = realmContextFactory.Register(realm => realm.All<ScoreInfo>().Where(s => ((s.OnlineID > 0 && s.OnlineID == TrackedItem.OnlineID) || s.Hash == TrackedItem.Hash) && !s.DeletePending), (items, changes, ___) =>
+            realmSubscription = realmContextFactory.RegisterForNotifications(realm => realm.All<ScoreInfo>().Where(s => ((s.OnlineID > 0 && s.OnlineID == TrackedItem.OnlineID) || s.Hash == TrackedItem.Hash) && !s.DeletePending), (items, changes, ___) =>
             {
                 if (items.Any())
                     Schedule(() => UpdateState(DownloadState.LocallyAvailable));
diff --git a/osu.Game/Overlays/MusicController.cs b/osu.Game/Overlays/MusicController.cs
index 8caa69e78c..8df7ed9736 100644
--- a/osu.Game/Overlays/MusicController.cs
+++ b/osu.Game/Overlays/MusicController.cs
@@ -94,7 +94,7 @@ namespace osu.Game.Overlays
             foreach (var s in queryRealmBeatmapSets())
                 beatmapSets.Add(s.Detach());
 
-            beatmapSubscription = realmFactory.Register(realm => queryRealmBeatmapSets(), beatmapsChanged);
+            beatmapSubscription = realmFactory.RegisterForNotifications(realm => queryRealmBeatmapSets(), beatmapsChanged);
         }
 
         private void beatmapsChanged(IRealmCollection<BeatmapSetInfo> sender, ChangeSet changes, Exception error)
diff --git a/osu.Game/Overlays/Settings/Sections/SkinSection.cs b/osu.Game/Overlays/Settings/Sections/SkinSection.cs
index c767edec71..6e5cd0da2d 100644
--- a/osu.Game/Overlays/Settings/Sections/SkinSection.cs
+++ b/osu.Game/Overlays/Settings/Sections/SkinSection.cs
@@ -83,7 +83,7 @@ namespace osu.Game.Overlays.Settings.Sections
 
             skinDropdown.Current = dropdownBindable;
 
-            realmSubscription = realmFactory.Register(realm => queryRealmSkins(), (sender, changes, error) =>
+            realmSubscription = realmFactory.RegisterForNotifications(realm => queryRealmSkins(), (sender, changes, error) =>
             {
                 // The first fire of this is a bit redundant due to the call below,
                 // but this is safest in case the subscription is restored after a context recycle.
diff --git a/osu.Game/Screens/Select/BeatmapCarousel.cs b/osu.Game/Screens/Select/BeatmapCarousel.cs
index 889a6f5b79..5a6295fe74 100644
--- a/osu.Game/Screens/Select/BeatmapCarousel.cs
+++ b/osu.Game/Screens/Select/BeatmapCarousel.cs
@@ -190,13 +190,13 @@ namespace osu.Game.Screens.Select
         {
             base.LoadComplete();
 
-            subscriptionSets = realmFactory.Register(getBeatmapSets, beatmapSetsChanged);
-            subscriptionBeatmaps = realmFactory.Register(realm => realm.All<BeatmapInfo>().Where(b => !b.Hidden), beatmapsChanged);
+            subscriptionSets = realmFactory.RegisterForNotifications(getBeatmapSets, beatmapSetsChanged);
+            subscriptionBeatmaps = realmFactory.RegisterForNotifications(realm => realm.All<BeatmapInfo>().Where(b => !b.Hidden), beatmapsChanged);
 
             // Can't use main subscriptions because we can't lookup deleted indices.
             // https://github.com/realm/realm-dotnet/discussions/2634#discussioncomment-1605595.
-            subscriptionDeletedSets = realmFactory.Register(realm => realm.All<BeatmapSetInfo>().Where(s => s.DeletePending && !s.Protected), deletedBeatmapSetsChanged);
-            subscriptionHiddenBeatmaps = realmFactory.Register(realm => realm.All<BeatmapInfo>().Where(b => b.Hidden), beatmapsChanged);
+            subscriptionDeletedSets = realmFactory.RegisterForNotifications(realm => realm.All<BeatmapSetInfo>().Where(s => s.DeletePending && !s.Protected), deletedBeatmapSetsChanged);
+            subscriptionHiddenBeatmaps = realmFactory.RegisterForNotifications(realm => realm.All<BeatmapInfo>().Where(b => b.Hidden), beatmapsChanged);
         }
 
         private void deletedBeatmapSetsChanged(IRealmCollection<BeatmapSetInfo> sender, ChangeSet changes, Exception error)
diff --git a/osu.Game/Screens/Select/Carousel/TopLocalRank.cs b/osu.Game/Screens/Select/Carousel/TopLocalRank.cs
index fc2188e597..c03d464ef6 100644
--- a/osu.Game/Screens/Select/Carousel/TopLocalRank.cs
+++ b/osu.Game/Screens/Select/Carousel/TopLocalRank.cs
@@ -48,7 +48,7 @@ namespace osu.Game.Screens.Select.Carousel
             ruleset.BindValueChanged(_ =>
             {
                 scoreSubscription?.Dispose();
-                scoreSubscription = realmFactory.Register(realm =>
+                scoreSubscription = realmFactory.RegisterForNotifications(realm =>
                         realm.All<ScoreInfo>()
                              .Filter($"{nameof(ScoreInfo.User)}.{nameof(RealmUser.OnlineID)} == $0"
                                      + $" && {nameof(ScoreInfo.BeatmapInfo)}.{nameof(BeatmapInfo.ID)} == $1"
diff --git a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
index 463f878e2a..5f288b972b 100644
--- a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
+++ b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
@@ -113,7 +113,7 @@ namespace osu.Game.Screens.Select.Leaderboards
             if (beatmapInfo == null)
                 return;
 
-            scoreSubscription = realmFactory.Register(realm =>
+            scoreSubscription = realmFactory.RegisterForNotifications(realm =>
                     realm.All<ScoreInfo>()
                          .Filter($"{nameof(ScoreInfo.BeatmapInfo)}.{nameof(BeatmapInfo.ID)} = $0", beatmapInfo.ID),
                 (_, changes, ___) =>
diff --git a/osu.Game/Screens/Spectate/SpectatorScreen.cs b/osu.Game/Screens/Spectate/SpectatorScreen.cs
index 904648f727..4abde56ea6 100644
--- a/osu.Game/Screens/Spectate/SpectatorScreen.cs
+++ b/osu.Game/Screens/Spectate/SpectatorScreen.cs
@@ -80,7 +80,7 @@ namespace osu.Game.Screens.Spectate
                 playingUserStates.BindTo(spectatorClient.PlayingUserStates);
                 playingUserStates.BindCollectionChanged(onPlayingUserStatesChanged, true);
 
-                realmSubscription = realmContextFactory.Register(
+                realmSubscription = realmContextFactory.RegisterForNotifications(
                     realm => realm.All<BeatmapSetInfo>().Where(s => !s.DeletePending), beatmapsChanged);
 
                 foreach ((int id, var _) in userMap)

From cb319cebdbae8cf70e4b750b1bd80ce655e41183 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 24 Jan 2022 14:48:55 +0900
Subject: [PATCH 2438/5547] Refactor naming and add more comments to help
 understanding in `RealmContextFactory` subscription logic

---
 osu.Game/Database/RealmContextFactory.cs | 39 ++++++++++++++++--------
 1 file changed, 27 insertions(+), 12 deletions(-)

diff --git a/osu.Game/Database/RealmContextFactory.cs b/osu.Game/Database/RealmContextFactory.cs
index 697caf8cd3..0137e22e94 100644
--- a/osu.Game/Database/RealmContextFactory.cs
+++ b/osu.Game/Database/RealmContextFactory.cs
@@ -63,8 +63,22 @@ namespace osu.Game.Database
 
         private readonly ThreadLocal<bool> currentThreadCanCreateContexts = new ThreadLocal<bool>();
 
-        private readonly Dictionary<Func<Realm, IDisposable?>, IDisposable?> customSubscriptionActions = new Dictionary<Func<Realm, IDisposable?>, IDisposable?>();
+        /// <summary>
+        /// Holds a map of functions registered via <see cref="RegisterCustomSubscription"/> and <see cref="RegisterForNotifications{T}"/> and a coinciding action which when triggered,
+        /// will unregister the subscription from realm.
+        ///
+        /// Put another way, the key is an action which registers the subscription with realm. The returned <see cref="IDisposable"/> from the action is stored as the value and only
+        /// used internally.
+        ///
+        /// Entries in this dictionary are only removed when a consumer signals that the subscription should be permanently ceased (via their own <see cref="IDisposable"/>).
+        /// </summary>
+        private readonly Dictionary<Func<Realm, IDisposable?>, IDisposable?> customSubscriptionsResetMap = new Dictionary<Func<Realm, IDisposable?>, IDisposable?>();
 
+        /// <summary>
+        /// Holds a map of functions registered via <see cref="RegisterForNotifications{T}"/> and a coinciding action which when triggered,
+        /// fires a change set event with an empty collection. This is used to inform subscribers when a realm context goes away, and ensure they don't use invalidated
+        /// managed realm objects from a previous firing.
+        /// </summary>
         private readonly Dictionary<Func<Realm, IDisposable?>, Action> realmSubscriptionsResetMap = new Dictionary<Func<Realm, IDisposable?>, Action>();
 
         private static readonly GlobalStatistic<int> contexts_created = GlobalStatistics.Get<int>(@"Realm", @"Contexts (Created)");
@@ -88,7 +102,7 @@ namespace osu.Game.Database
                     Logger.Log(@$"Opened realm ""{context.Config.DatabasePath}"" at version {context.Config.SchemaVersion}");
 
                     // Resubscribe any subscriptions
-                    foreach (var action in customSubscriptionActions.Keys)
+                    foreach (var action in customSubscriptionsResetMap.Keys)
                         registerSubscription(action);
                 }
 
@@ -245,11 +259,12 @@ namespace osu.Game.Database
 
             lock (contextLock)
             {
+                Func<Realm, IDisposable?> action = realm => query(realm).QueryAsyncWithNotifications(onChanged);
+
+                // Store an action which is used when blocking to ensure consumers don't use results of a stale changeset firing.
                 realmSubscriptionsResetMap.Add(action, () => onChanged(new EmptyRealmSet<T>(), null, null));
                 return RegisterCustomSubscription(action);
             }
-
-            IDisposable? action(Realm realm) => query(realm).QueryAsyncWithNotifications(onChanged);
         }
 
         /// <summary>
@@ -266,8 +281,8 @@ namespace osu.Game.Database
 
             registerSubscription(action);
 
-            // This token is returned to the consumer only.
-            // It will cause the registration to be permanently removed.
+            // This token is returned to the consumer.
+            // When disposed, it will cause the registration to be permanently ceased (unsubscribed with realm and unregistered by this class).
             return new InvokeOnDisposal(() =>
             {
                 if (ThreadSafety.IsUpdateThread)
@@ -279,10 +294,10 @@ namespace osu.Game.Database
                 {
                     lock (contextLock)
                     {
-                        if (customSubscriptionActions.TryGetValue(action, out var unsubscriptionAction))
+                        if (customSubscriptionsResetMap.TryGetValue(action, out var unsubscriptionAction))
                         {
                             unsubscriptionAction?.Dispose();
-                            customSubscriptionActions.Remove(action);
+                            customSubscriptionsResetMap.Remove(action);
                             realmSubscriptionsResetMap.Remove(action);
                         }
                     }
@@ -301,10 +316,10 @@ namespace osu.Game.Database
 
             lock (contextLock)
             {
-                Debug.Assert(!customSubscriptionActions.TryGetValue(action, out var found) || found == null);
+                Debug.Assert(!customSubscriptionsResetMap.TryGetValue(action, out var found) || found == null);
 
                 current_thread_subscriptions_allowed.Value = true;
-                customSubscriptionActions[action] = action(realm);
+                customSubscriptionsResetMap[action] = action(realm);
                 current_thread_subscriptions_allowed.Value = false;
             }
         }
@@ -318,10 +333,10 @@ namespace osu.Game.Database
             foreach (var action in realmSubscriptionsResetMap.Values)
                 action();
 
-            foreach (var action in customSubscriptionActions)
+            foreach (var action in customSubscriptionsResetMap)
             {
                 action.Value?.Dispose();
-                customSubscriptionActions[action.Key] = null;
+                customSubscriptionsResetMap[action.Key] = null;
             }
         }
 

From 1e483ece322f4c78c4ff8eab95c1993d388a1f9c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 24 Jan 2022 16:40:16 +0900
Subject: [PATCH 2439/5547] Avoid adding "exit all screens" step when running
 tests interactively

---
 osu.Game/Tests/Visual/ScreenTestScene.cs | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Tests/Visual/ScreenTestScene.cs b/osu.Game/Tests/Visual/ScreenTestScene.cs
index c44a848275..b6f6ca6daa 100644
--- a/osu.Game/Tests/Visual/ScreenTestScene.cs
+++ b/osu.Game/Tests/Visual/ScreenTestScene.cs
@@ -2,6 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using osu.Framework.Allocation;
+using osu.Framework.Development;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Logging;
@@ -48,7 +49,11 @@ namespace osu.Game.Tests.Visual
         public virtual void SetUpSteps() => addExitAllScreensStep();
 
         [TearDownSteps]
-        public virtual void TearDownSteps() => addExitAllScreensStep();
+        public virtual void TearDownSteps()
+        {
+            if (DebugUtils.IsNUnitRunning)
+                addExitAllScreensStep();
+        }
 
         private void addExitAllScreensStep()
         {

From e22aea0613698af3fa5870fd745764306a9273dd Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 24 Jan 2022 17:05:49 +0900
Subject: [PATCH 2440/5547] Apply same fix to `OsuGameTestScene`

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

diff --git a/osu.Game/Tests/Visual/OsuGameTestScene.cs b/osu.Game/Tests/Visual/OsuGameTestScene.cs
index 6a11bd3fea..ebbd9bb5dd 100644
--- a/osu.Game/Tests/Visual/OsuGameTestScene.cs
+++ b/osu.Game/Tests/Visual/OsuGameTestScene.cs
@@ -5,6 +5,7 @@ using System;
 using System.Collections.Generic;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
+using osu.Framework.Development;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
@@ -72,8 +73,11 @@ namespace osu.Game.Tests.Visual
         [TearDownSteps]
         public void TearDownSteps()
         {
-            AddStep("exit game", () => Game.Exit());
-            AddUntilStep("wait for game exit", () => Game.Parent == null);
+            if (DebugUtils.IsNUnitRunning)
+            {
+                AddStep("exit game", () => Game.Exit());
+                AddUntilStep("wait for game exit", () => Game.Parent == null);
+            }
         }
 
         protected void CreateGame()

From 161a2a321ef5ecc93dfeb9d5a99af66f7881be2a Mon Sep 17 00:00:00 2001
From: mk-56 <darioheadleysilva@gmail.com>
Date: Mon, 24 Jan 2022 09:07:07 +0100
Subject: [PATCH 2441/5547] Remove bindable from ModeMultiplier

---
 osu.Game.Rulesets.Catch/Mods/CatchModFlashlight.cs | 8 ++------
 osu.Game.Rulesets.Mania/Mods/ManiaModFlashlight.cs | 8 ++------
 osu.Game.Rulesets.Osu/Mods/OsuModFlashlight.cs     | 8 ++------
 osu.Game.Rulesets.Taiko/Mods/TaikoModFlashlight.cs | 8 ++------
 osu.Game/Rulesets/Mods/ModFlashlight.cs            | 2 +-
 5 files changed, 9 insertions(+), 25 deletions(-)

diff --git a/osu.Game.Rulesets.Catch/Mods/CatchModFlashlight.cs b/osu.Game.Rulesets.Catch/Mods/CatchModFlashlight.cs
index e8f1ebdd10..4fbbf63abf 100644
--- a/osu.Game.Rulesets.Catch/Mods/CatchModFlashlight.cs
+++ b/osu.Game.Rulesets.Catch/Mods/CatchModFlashlight.cs
@@ -33,13 +33,9 @@ namespace osu.Game.Rulesets.Catch.Mods
             Precision = 0.1f
         };
 
-        protected override BindableNumber<float> ModeMultiplier { get; } = new BindableNumber<float>
-        {
-            Default = 350,
-            Value = 350,
-        };
+        protected override float ModeMultiplier => 350;
 
-        public override Flashlight CreateFlashlight() => new CatchFlashlight(playfield, ChangeRadius.Value, InitialRadius.Value, ModeMultiplier.Value);
+        public override Flashlight CreateFlashlight() => new CatchFlashlight(playfield, ChangeRadius.Value, InitialRadius.Value, ModeMultiplier);
 
         private CatchPlayfield playfield;
 
diff --git a/osu.Game.Rulesets.Mania/Mods/ManiaModFlashlight.cs b/osu.Game.Rulesets.Mania/Mods/ManiaModFlashlight.cs
index 9ca1a72584..61f73a1ee5 100644
--- a/osu.Game.Rulesets.Mania/Mods/ManiaModFlashlight.cs
+++ b/osu.Game.Rulesets.Mania/Mods/ManiaModFlashlight.cs
@@ -34,13 +34,9 @@ namespace osu.Game.Rulesets.Mania.Mods
             Precision = 0.1f
         };
 
-        protected override BindableNumber<float> ModeMultiplier { get; } = new BindableNumber<float>
-        {
-            Default = 50,
-            Value = 50,
-        };
+        protected override float ModeMultiplier => 50;
 
-        public override Flashlight CreateFlashlight() => new ManiaFlashlight(ChangeRadius.Value, InitialRadius.Value, ModeMultiplier.Value);
+        public override Flashlight CreateFlashlight() => new ManiaFlashlight(ChangeRadius.Value, InitialRadius.Value, ModeMultiplier);
 
         private class ManiaFlashlight : Flashlight
         {
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModFlashlight.cs b/osu.Game.Rulesets.Osu/Mods/OsuModFlashlight.cs
index c6cf5ce4b5..75299863a9 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModFlashlight.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModFlashlight.cs
@@ -47,15 +47,11 @@ namespace osu.Game.Rulesets.Osu.Mods
             Precision = 0.1f
         };
 
-        protected override BindableNumber<float> ModeMultiplier { get; } = new BindableNumber<float>
-        {
-            Default = 180,
-            Value = 180,
-        };
+        protected override float ModeMultiplier => 180;
 
         private OsuFlashlight flashlight;
 
-        public override Flashlight CreateFlashlight() => flashlight = new OsuFlashlight(ChangeRadius.Value, InitialRadius.Value, FollowDelay.Value, ModeMultiplier.Value);
+        public override Flashlight CreateFlashlight() => flashlight = new OsuFlashlight(ChangeRadius.Value, InitialRadius.Value, FollowDelay.Value, ModeMultiplier);
 
         public void ApplyToDrawableHitObject(DrawableHitObject drawable)
         {
diff --git a/osu.Game.Rulesets.Taiko/Mods/TaikoModFlashlight.cs b/osu.Game.Rulesets.Taiko/Mods/TaikoModFlashlight.cs
index f235698b55..65a173b491 100644
--- a/osu.Game.Rulesets.Taiko/Mods/TaikoModFlashlight.cs
+++ b/osu.Game.Rulesets.Taiko/Mods/TaikoModFlashlight.cs
@@ -34,13 +34,9 @@ namespace osu.Game.Rulesets.Taiko.Mods
             Precision = 0.1f
         };
 
-        protected override BindableNumber<float> ModeMultiplier { get; } = new BindableNumber<float>
-        {
-            Default = 250,
-            Value = 250,
-        };
+        protected override float ModeMultiplier => 250;
 
-        public override Flashlight CreateFlashlight() => new TaikoFlashlight(playfield, ChangeRadius.Value, InitialRadius.Value, ModeMultiplier.Value);
+        public override Flashlight CreateFlashlight() => new TaikoFlashlight(playfield, ChangeRadius.Value, InitialRadius.Value, ModeMultiplier);
 
         private TaikoPlayfield playfield;
 
diff --git a/osu.Game/Rulesets/Mods/ModFlashlight.cs b/osu.Game/Rulesets/Mods/ModFlashlight.cs
index d16f310582..7b980e8097 100644
--- a/osu.Game/Rulesets/Mods/ModFlashlight.cs
+++ b/osu.Game/Rulesets/Mods/ModFlashlight.cs
@@ -39,7 +39,7 @@ namespace osu.Game.Rulesets.Mods
         [SettingSource("Initial radius", "Initial radius of the flashlight area.")]
         public abstract BindableNumber<float> InitialRadius { get; }
 
-        protected abstract BindableNumber<float> ModeMultiplier { get; }
+        protected abstract float ModeMultiplier { get; }
     }
 
     public abstract class ModFlashlight<T> : ModFlashlight, IApplicableToDrawableRuleset<T>, IApplicableToScoreProcessor

From 52cd906af6552ecb099d40454d10e2e266a4e92f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 24 Jan 2022 17:45:31 +0900
Subject: [PATCH 2442/5547] Move context retrieval inside lock

---
 osu.Game/Database/RealmContextFactory.cs | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Database/RealmContextFactory.cs b/osu.Game/Database/RealmContextFactory.cs
index 0137e22e94..be484329bc 100644
--- a/osu.Game/Database/RealmContextFactory.cs
+++ b/osu.Game/Database/RealmContextFactory.cs
@@ -309,13 +309,13 @@ namespace osu.Game.Database
         {
             Debug.Assert(ThreadSafety.IsUpdateThread);
 
-            // Retrieve context outside of flag update to ensure that the context is constructed,
-            // as attempting to access it inside the subscription if it's not constructed would lead to
-            // cyclic invocations of the subscription callback.
-            var realm = Context;
-
             lock (contextLock)
             {
+                // Retrieve context outside of flag update to ensure that the context is constructed,
+                // as attempting to access it inside the subscription if it's not constructed would lead to
+                // cyclic invocations of the subscription callback.
+                var realm = Context;
+
                 Debug.Assert(!customSubscriptionsResetMap.TryGetValue(action, out var found) || found == null);
 
                 current_thread_subscriptions_allowed.Value = true;

From abf14f09820bb8f5859604135174f36f0e9e7cc5 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 24 Jan 2022 17:46:53 +0900
Subject: [PATCH 2443/5547] Lock unregistration for sanity

---
 osu.Game/Database/RealmContextFactory.cs | 15 +++++++++------
 1 file changed, 9 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Database/RealmContextFactory.cs b/osu.Game/Database/RealmContextFactory.cs
index be484329bc..5dd4e88ccd 100644
--- a/osu.Game/Database/RealmContextFactory.cs
+++ b/osu.Game/Database/RealmContextFactory.cs
@@ -330,13 +330,16 @@ namespace osu.Game.Database
         /// </summary>
         private void unregisterAllSubscriptions()
         {
-            foreach (var action in realmSubscriptionsResetMap.Values)
-                action();
-
-            foreach (var action in customSubscriptionsResetMap)
+            lock (contextLock)
             {
-                action.Value?.Dispose();
-                customSubscriptionsResetMap[action.Key] = null;
+                foreach (var action in realmSubscriptionsResetMap.Values)
+                    action();
+
+                foreach (var action in customSubscriptionsResetMap)
+                {
+                    action.Value?.Dispose();
+                    customSubscriptionsResetMap[action.Key] = null;
+                }
             }
         }
 

From f4e7211ef1356f6598f4ad6038d896c771f39cbd Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 24 Jan 2022 17:52:36 +0900
Subject: [PATCH 2444/5547] Add xmldoc for `RegisterForNotifications`

---
 osu.Game/Database/RealmContextFactory.cs | 27 +++++++++++++++++++++---
 1 file changed, 24 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Database/RealmContextFactory.cs b/osu.Game/Database/RealmContextFactory.cs
index 5dd4e88ccd..f8470b8c73 100644
--- a/osu.Game/Database/RealmContextFactory.cs
+++ b/osu.Game/Database/RealmContextFactory.cs
@@ -251,7 +251,28 @@ namespace osu.Game.Database
             }
         }
 
-        public IDisposable RegisterForNotifications<T>(Func<Realm, IQueryable<T>> query, NotificationCallbackDelegate<T> onChanged)
+        /// <summary>
+        /// Subscribe to a realm collection and begin watching for asynchronous changes.
+        /// </summary>
+        /// <remarks>
+        /// This adds osu! specific thread and managed state safety checks on top of <see cref="IRealmCollection{T}.SubscribeForNotifications"/>.
+        ///
+        /// In addition to the documented realm behaviour, we have the additional requirement of handling subscriptions over potential context loss.
+        /// When this happens, callback events will be automatically fired:
+        /// - On context loss, a callback with an empty collection and <c>null</c> <see cref="ChangeSet"/> will be invoked.
+        /// - On context revival, a standard initial realm callback will arrive, with <c>null</c> <see cref="ChangeSet"/> and an up-to-date collection.
+        /// </remarks>
+        /// <param name="query">The <see cref="IQueryable{T}"/> to observe for changes.</param>
+        /// <typeparam name="T">Type of the elements in the list.</typeparam>
+        /// <seealso cref="IRealmCollection{T}.SubscribeForNotifications"/>
+        /// <param name="callback">The callback to be invoked with the updated <see cref="IRealmCollection{T}"/>.</param>
+        /// <returns>
+        /// A subscription token. It must be kept alive for as long as you want to receive change notifications.
+        /// To stop receiving notifications, call <see cref="IDisposable.Dispose"/>.
+        ///
+        /// May be null in the case the provided collection is not managed.
+        /// </returns>
+        public IDisposable RegisterForNotifications<T>(Func<Realm, IQueryable<T>> query, NotificationCallbackDelegate<T> callback)
             where T : RealmObjectBase
         {
             if (!ThreadSafety.IsUpdateThread)
@@ -259,10 +280,10 @@ namespace osu.Game.Database
 
             lock (contextLock)
             {
-                Func<Realm, IDisposable?> action = realm => query(realm).QueryAsyncWithNotifications(onChanged);
+                Func<Realm, IDisposable?> action = realm => query(realm).QueryAsyncWithNotifications(callback);
 
                 // Store an action which is used when blocking to ensure consumers don't use results of a stale changeset firing.
-                realmSubscriptionsResetMap.Add(action, () => onChanged(new EmptyRealmSet<T>(), null, null));
+                realmSubscriptionsResetMap.Add(action, () => callback(new EmptyRealmSet<T>(), null, null));
                 return RegisterCustomSubscription(action);
             }
         }

From bf5bf8d1fd147f1a0e27756321512eaa0676e3d7 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 24 Jan 2022 17:58:53 +0900
Subject: [PATCH 2445/5547] Rename dictionaries to match methods

---
 osu.Game/Database/RealmContextFactory.cs | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Database/RealmContextFactory.cs b/osu.Game/Database/RealmContextFactory.cs
index f8470b8c73..738d0a70a9 100644
--- a/osu.Game/Database/RealmContextFactory.cs
+++ b/osu.Game/Database/RealmContextFactory.cs
@@ -79,7 +79,7 @@ namespace osu.Game.Database
         /// fires a change set event with an empty collection. This is used to inform subscribers when a realm context goes away, and ensure they don't use invalidated
         /// managed realm objects from a previous firing.
         /// </summary>
-        private readonly Dictionary<Func<Realm, IDisposable?>, Action> realmSubscriptionsResetMap = new Dictionary<Func<Realm, IDisposable?>, Action>();
+        private readonly Dictionary<Func<Realm, IDisposable?>, Action> notificationsResetMap = new Dictionary<Func<Realm, IDisposable?>, Action>();
 
         private static readonly GlobalStatistic<int> contexts_created = GlobalStatistics.Get<int>(@"Realm", @"Contexts (Created)");
 
@@ -283,7 +283,7 @@ namespace osu.Game.Database
                 Func<Realm, IDisposable?> action = realm => query(realm).QueryAsyncWithNotifications(callback);
 
                 // Store an action which is used when blocking to ensure consumers don't use results of a stale changeset firing.
-                realmSubscriptionsResetMap.Add(action, () => callback(new EmptyRealmSet<T>(), null, null));
+                notificationsResetMap.Add(action, () => callback(new EmptyRealmSet<T>(), null, null));
                 return RegisterCustomSubscription(action);
             }
         }
@@ -319,7 +319,7 @@ namespace osu.Game.Database
                         {
                             unsubscriptionAction?.Dispose();
                             customSubscriptionsResetMap.Remove(action);
-                            realmSubscriptionsResetMap.Remove(action);
+                            notificationsResetMap.Remove(action);
                         }
                     }
                 }
@@ -353,7 +353,7 @@ namespace osu.Game.Database
         {
             lock (contextLock)
             {
-                foreach (var action in realmSubscriptionsResetMap.Values)
+                foreach (var action in notificationsResetMap.Values)
                     action();
 
                 foreach (var action in customSubscriptionsResetMap)

From e3083c2477ae80b23f5c17c9360c7aa51b07dc88 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 24 Jan 2022 18:05:30 +0900
Subject: [PATCH 2446/5547] Fix copy pasted xmldoc

---
 osu.Game/Database/RealmContextFactory.cs | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/osu.Game/Database/RealmContextFactory.cs b/osu.Game/Database/RealmContextFactory.cs
index 738d0a70a9..3956738147 100644
--- a/osu.Game/Database/RealmContextFactory.cs
+++ b/osu.Game/Database/RealmContextFactory.cs
@@ -264,14 +264,12 @@ namespace osu.Game.Database
         /// </remarks>
         /// <param name="query">The <see cref="IQueryable{T}"/> to observe for changes.</param>
         /// <typeparam name="T">Type of the elements in the list.</typeparam>
-        /// <seealso cref="IRealmCollection{T}.SubscribeForNotifications"/>
         /// <param name="callback">The callback to be invoked with the updated <see cref="IRealmCollection{T}"/>.</param>
         /// <returns>
         /// A subscription token. It must be kept alive for as long as you want to receive change notifications.
         /// To stop receiving notifications, call <see cref="IDisposable.Dispose"/>.
-        ///
-        /// May be null in the case the provided collection is not managed.
         /// </returns>
+        /// <seealso cref="IRealmCollection{T}.SubscribeForNotifications"/>
         public IDisposable RegisterForNotifications<T>(Func<Realm, IQueryable<T>> query, NotificationCallbackDelegate<T> callback)
             where T : RealmObjectBase
         {

From b0919722ac1c77fb484a7175e3f90cf325d03f9e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 24 Jan 2022 18:24:25 +0900
Subject: [PATCH 2447/5547] Guard against potential exception while blocking
 realm

---
 .../Sections/DebugSettings/MemorySettings.cs  | 48 +++++++++++--------
 1 file changed, 29 insertions(+), 19 deletions(-)

diff --git a/osu.Game/Overlays/Settings/Sections/DebugSettings/MemorySettings.cs b/osu.Game/Overlays/Settings/Sections/DebugSettings/MemorySettings.cs
index f058c274e4..c5854981e6 100644
--- a/osu.Game/Overlays/Settings/Sections/DebugSettings/MemorySettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/DebugSettings/MemorySettings.cs
@@ -1,11 +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 System.Threading;
 using System.Threading.Tasks;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Localisation;
+using osu.Framework.Logging;
 using osu.Framework.Platform;
 using osu.Game.Database;
 using osu.Game.Localisation;
@@ -52,30 +54,38 @@ namespace osu.Game.Overlays.Settings.Sections.DebugSettings
 
             blockAction.Action = () =>
             {
-                var blocking = realmFactory.BlockAllOperations();
-                blockAction.Enabled.Value = false;
-
-                // As a safety measure, unblock after 10 seconds.
-                // This is to handle the case where a dev may block, but then something on the update thread
-                // accesses realm and blocks for eternity.
-                Task.Factory.StartNew(() =>
+                try
                 {
-                    Thread.Sleep(10000);
-                    unblock();
-                });
+                    var token = realmFactory.BlockAllOperations();
 
-                unblockAction.Action = unblock;
+                    blockAction.Enabled.Value = false;
 
-                void unblock()
-                {
-                    blocking?.Dispose();
-                    blocking = null;
-
-                    Scheduler.Add(() =>
+                    // As a safety measure, unblock after 10 seconds.
+                    // This is to handle the case where a dev may block, but then something on the update thread
+                    // accesses realm and blocks for eternity.
+                    Task.Factory.StartNew(() =>
                     {
-                        blockAction.Enabled.Value = true;
-                        unblockAction.Action = null;
+                        Thread.Sleep(10000);
+                        unblock();
                     });
+
+                    unblockAction.Action = unblock;
+
+                    void unblock()
+                    {
+                        token?.Dispose();
+                        token = null;
+
+                        Scheduler.Add(() =>
+                        {
+                            blockAction.Enabled.Value = true;
+                            unblockAction.Action = null;
+                        });
+                    }
+                }
+                catch (Exception e)
+                {
+                    Logger.Error(e, "Blocking realm failed");
                 }
             };
         }

From 9afa034296e8f06642c907d44ab3061c076c9815 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 24 Jan 2022 18:36:16 +0900
Subject: [PATCH 2448/5547] Fix attempt to revive update thread realm context
 from non-update thread

---
 osu.Game/Database/RealmContextFactory.cs | 18 ++++++++++++++----
 1 file changed, 14 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Database/RealmContextFactory.cs b/osu.Game/Database/RealmContextFactory.cs
index 3956738147..778092c543 100644
--- a/osu.Game/Database/RealmContextFactory.cs
+++ b/osu.Game/Database/RealmContextFactory.cs
@@ -594,7 +594,7 @@ namespace osu.Game.Database
             if (isDisposed)
                 throw new ObjectDisposedException(nameof(RealmContextFactory));
 
-            SynchronizationContext syncContext;
+            SynchronizationContext? syncContext = null;
 
             try
             {
@@ -602,10 +602,20 @@ namespace osu.Game.Database
 
                 lock (contextLock)
                 {
-                    if (!ThreadSafety.IsUpdateThread && context != null)
-                        throw new InvalidOperationException(@$"{nameof(BlockAllOperations)} must be called from the update thread.");
+                    if (context == null)
+                    {
+                        // null context means the update thread has not yet retrieved its context.
+                        // we don't need to worry about reviving the update context in this case, so don't bother with the SynchronizationContext.
+                        Debug.Assert(!ThreadSafety.IsUpdateThread);
+                    }
+                    else
+                    {
+                        if (!ThreadSafety.IsUpdateThread)
+                            throw new InvalidOperationException(@$"{nameof(BlockAllOperations)} must be called from the update thread.");
+
+                        syncContext = SynchronizationContext.Current;
+                    }
 
-                    syncContext = SynchronizationContext.Current;
                     unregisterAllSubscriptions();
 
                     Logger.Log(@"Blocking realm operations.", LoggingTarget.Database);

From 66c5d77d6388686c733eb229e822d0ad4120dee1 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 24 Jan 2022 18:55:15 +0900
Subject: [PATCH 2449/5547] Allow realm migration to run again if interrupted
 halfway

---
 osu.Game/Database/EFToRealmMigrator.cs | 258 ++++++++++++-------------
 osu.Game/Screens/Loader.cs             |  15 +-
 2 files changed, 140 insertions(+), 133 deletions(-)

diff --git a/osu.Game/Database/EFToRealmMigrator.cs b/osu.Game/Database/EFToRealmMigrator.cs
index bbbdac352e..edce99e302 100644
--- a/osu.Game/Database/EFToRealmMigrator.cs
+++ b/osu.Game/Database/EFToRealmMigrator.cs
@@ -27,7 +27,9 @@ namespace osu.Game.Database
 {
     internal class EFToRealmMigrator : CompositeDrawable
     {
-        public bool FinishedMigrating { get; private set; }
+        public Task<bool> MigrationCompleted => migrationCompleted.Task;
+
+        private readonly TaskCompletionSource<bool> migrationCompleted = new TaskCompletionSource<bool>();
 
         [Resolved]
         private DatabaseContextFactory efContextFactory { get; set; } = null!;
@@ -99,6 +101,17 @@ namespace osu.Game.Database
             {
                 using (var ef = efContextFactory.Get())
                 {
+                    realmContextFactory.Write(realm =>
+                    {
+                        // Before beginning, ensure realm is in an empty state.
+                        // Migrations which are half-completed could lead to issues if the user tries a second time.
+                        // Note that we only do this for beatmaps and scores since the other migrations are yonks old.
+                        realm.RemoveAll<BeatmapSetInfo>();
+                        realm.RemoveAll<BeatmapInfo>();
+                        realm.RemoveAll<BeatmapMetadata>();
+                        realm.RemoveAll<ScoreInfo>();
+                    });
+
                     migrateSettings(ef);
                     migrateSkins(ef);
                     migrateBeatmaps(ef);
@@ -114,7 +127,7 @@ namespace osu.Game.Database
                     Logger.Log("Your development database has been fully migrated to realm. If you switch back to a pre-realm branch and need your previous database, rename the backup file back to \"client.db\".\n\nNote that doing this can potentially leave your file store in a bad state.", level: LogLevel.Important);
             }, TaskCreationOptions.LongRunning).ContinueWith(t =>
             {
-                FinishedMigrating = true;
+                migrationCompleted.SetResult(true);
             });
         }
 
@@ -149,87 +162,78 @@ namespace osu.Game.Database
             {
                 log($"Found {count} beatmaps in EF");
 
-                // only migrate data if the realm database is empty.
-                // note that this cannot be written as: `realm.All<BeatmapSetInfo>().All(s => s.Protected)`, because realm does not support `.All()`.
-                if (realm.All<BeatmapSetInfo>().Any(s => !s.Protected))
-                {
-                    log("Skipping migration as realm already has beatmaps loaded");
-                }
-                else
-                {
-                    var transaction = realm.BeginWrite();
-                    int written = 0;
+                var transaction = realm.BeginWrite();
+                int written = 0;
 
-                    try
+                try
+                {
+                    foreach (var beatmapSet in existingBeatmapSets)
                     {
-                        foreach (var beatmapSet in existingBeatmapSets)
+                        if (++written % 1000 == 0)
                         {
-                            if (++written % 1000 == 0)
-                            {
-                                transaction.Commit();
-                                transaction = realm.BeginWrite();
-                                log($"Migrated {written}/{count} beatmaps...");
-                            }
+                            transaction.Commit();
+                            transaction = realm.BeginWrite();
+                            log($"Migrated {written}/{count} beatmaps...");
+                        }
 
-                            var realmBeatmapSet = new BeatmapSetInfo
+                        var realmBeatmapSet = new BeatmapSetInfo
+                        {
+                            OnlineID = beatmapSet.OnlineID ?? -1,
+                            DateAdded = beatmapSet.DateAdded,
+                            Status = beatmapSet.Status,
+                            DeletePending = beatmapSet.DeletePending,
+                            Hash = beatmapSet.Hash,
+                            Protected = beatmapSet.Protected,
+                        };
+
+                        migrateFiles(beatmapSet, realm, realmBeatmapSet);
+
+                        foreach (var beatmap in beatmapSet.Beatmaps)
+                        {
+                            var ruleset = realm.Find<RulesetInfo>(beatmap.RulesetInfo.ShortName);
+                            var metadata = getBestMetadata(beatmap.Metadata, beatmapSet.Metadata);
+
+                            var realmBeatmap = new BeatmapInfo(ruleset, new BeatmapDifficulty(beatmap.BaseDifficulty), metadata)
                             {
-                                OnlineID = beatmapSet.OnlineID ?? -1,
-                                DateAdded = beatmapSet.DateAdded,
-                                Status = beatmapSet.Status,
-                                DeletePending = beatmapSet.DeletePending,
-                                Hash = beatmapSet.Hash,
-                                Protected = beatmapSet.Protected,
+                                DifficultyName = beatmap.DifficultyName,
+                                Status = beatmap.Status,
+                                OnlineID = beatmap.OnlineID ?? -1,
+                                Length = beatmap.Length,
+                                BPM = beatmap.BPM,
+                                Hash = beatmap.Hash,
+                                StarRating = beatmap.StarRating,
+                                MD5Hash = beatmap.MD5Hash,
+                                Hidden = beatmap.Hidden,
+                                AudioLeadIn = beatmap.AudioLeadIn,
+                                StackLeniency = beatmap.StackLeniency,
+                                SpecialStyle = beatmap.SpecialStyle,
+                                LetterboxInBreaks = beatmap.LetterboxInBreaks,
+                                WidescreenStoryboard = beatmap.WidescreenStoryboard,
+                                EpilepsyWarning = beatmap.EpilepsyWarning,
+                                SamplesMatchPlaybackRate = beatmap.SamplesMatchPlaybackRate,
+                                DistanceSpacing = beatmap.DistanceSpacing,
+                                BeatDivisor = beatmap.BeatDivisor,
+                                GridSize = beatmap.GridSize,
+                                TimelineZoom = beatmap.TimelineZoom,
+                                Countdown = beatmap.Countdown,
+                                CountdownOffset = beatmap.CountdownOffset,
+                                MaxCombo = beatmap.MaxCombo,
+                                Bookmarks = beatmap.Bookmarks,
+                                BeatmapSet = realmBeatmapSet,
                             };
 
-                            migrateFiles(beatmapSet, realm, realmBeatmapSet);
-
-                            foreach (var beatmap in beatmapSet.Beatmaps)
-                            {
-                                var ruleset = realm.Find<RulesetInfo>(beatmap.RulesetInfo.ShortName);
-                                var metadata = getBestMetadata(beatmap.Metadata, beatmapSet.Metadata);
-
-                                var realmBeatmap = new BeatmapInfo(ruleset, new BeatmapDifficulty(beatmap.BaseDifficulty), metadata)
-                                {
-                                    DifficultyName = beatmap.DifficultyName,
-                                    Status = beatmap.Status,
-                                    OnlineID = beatmap.OnlineID ?? -1,
-                                    Length = beatmap.Length,
-                                    BPM = beatmap.BPM,
-                                    Hash = beatmap.Hash,
-                                    StarRating = beatmap.StarRating,
-                                    MD5Hash = beatmap.MD5Hash,
-                                    Hidden = beatmap.Hidden,
-                                    AudioLeadIn = beatmap.AudioLeadIn,
-                                    StackLeniency = beatmap.StackLeniency,
-                                    SpecialStyle = beatmap.SpecialStyle,
-                                    LetterboxInBreaks = beatmap.LetterboxInBreaks,
-                                    WidescreenStoryboard = beatmap.WidescreenStoryboard,
-                                    EpilepsyWarning = beatmap.EpilepsyWarning,
-                                    SamplesMatchPlaybackRate = beatmap.SamplesMatchPlaybackRate,
-                                    DistanceSpacing = beatmap.DistanceSpacing,
-                                    BeatDivisor = beatmap.BeatDivisor,
-                                    GridSize = beatmap.GridSize,
-                                    TimelineZoom = beatmap.TimelineZoom,
-                                    Countdown = beatmap.Countdown,
-                                    CountdownOffset = beatmap.CountdownOffset,
-                                    MaxCombo = beatmap.MaxCombo,
-                                    Bookmarks = beatmap.Bookmarks,
-                                    BeatmapSet = realmBeatmapSet,
-                                };
-
-                                realmBeatmapSet.Beatmaps.Add(realmBeatmap);
-                            }
-
-                            realm.Add(realmBeatmapSet);
+                            realmBeatmapSet.Beatmaps.Add(realmBeatmap);
                         }
-                    }
-                    finally
-                    {
-                        transaction.Commit();
-                    }
 
-                    log($"Successfully migrated {count} beatmaps to realm");
+                        realm.Add(realmBeatmapSet);
+                    }
                 }
+                finally
+                {
+                    transaction.Commit();
+                }
+
+                log($"Successfully migrated {count} beatmaps to realm");
             });
         }
 
@@ -280,70 +284,62 @@ namespace osu.Game.Database
             {
                 log($"Found {count} scores in EF");
 
-                // only migrate data if the realm database is empty.
-                if (realm.All<ScoreInfo>().Any())
-                {
-                    log("Skipping migration as realm already has scores loaded");
-                }
-                else
-                {
-                    var transaction = realm.BeginWrite();
-                    int written = 0;
+                var transaction = realm.BeginWrite();
+                int written = 0;
 
-                    try
+                try
+                {
+                    foreach (var score in existingScores)
                     {
-                        foreach (var score in existingScores)
+                        if (++written % 1000 == 0)
                         {
-                            if (++written % 1000 == 0)
-                            {
-                                transaction.Commit();
-                                transaction = realm.BeginWrite();
-                                log($"Migrated {written}/{count} scores...");
-                            }
-
-                            var beatmap = realm.All<BeatmapInfo>().First(b => b.Hash == score.BeatmapInfo.Hash);
-                            var ruleset = realm.Find<RulesetInfo>(score.Ruleset.ShortName);
-                            var user = new RealmUser
-                            {
-                                OnlineID = score.User.OnlineID,
-                                Username = score.User.Username
-                            };
-
-                            var realmScore = new ScoreInfo(beatmap, ruleset, user)
-                            {
-                                Hash = score.Hash,
-                                DeletePending = score.DeletePending,
-                                OnlineID = score.OnlineID ?? -1,
-                                ModsJson = score.ModsJson,
-                                StatisticsJson = score.StatisticsJson,
-                                TotalScore = score.TotalScore,
-                                MaxCombo = score.MaxCombo,
-                                Accuracy = score.Accuracy,
-                                HasReplay = ((IScoreInfo)score).HasReplay,
-                                Date = score.Date,
-                                PP = score.PP,
-                                Rank = score.Rank,
-                                HitEvents = score.HitEvents,
-                                Passed = score.Passed,
-                                Combo = score.Combo,
-                                Position = score.Position,
-                                Statistics = score.Statistics,
-                                Mods = score.Mods,
-                                APIMods = score.APIMods,
-                            };
-
-                            migrateFiles(score, realm, realmScore);
-
-                            realm.Add(realmScore);
+                            transaction.Commit();
+                            transaction = realm.BeginWrite();
+                            log($"Migrated {written}/{count} scores...");
                         }
-                    }
-                    finally
-                    {
-                        transaction.Commit();
-                    }
 
-                    log($"Successfully migrated {count} scores to realm");
+                        var beatmap = realm.All<BeatmapInfo>().First(b => b.Hash == score.BeatmapInfo.Hash);
+                        var ruleset = realm.Find<RulesetInfo>(score.Ruleset.ShortName);
+                        var user = new RealmUser
+                        {
+                            OnlineID = score.User.OnlineID,
+                            Username = score.User.Username
+                        };
+
+                        var realmScore = new ScoreInfo(beatmap, ruleset, user)
+                        {
+                            Hash = score.Hash,
+                            DeletePending = score.DeletePending,
+                            OnlineID = score.OnlineID ?? -1,
+                            ModsJson = score.ModsJson,
+                            StatisticsJson = score.StatisticsJson,
+                            TotalScore = score.TotalScore,
+                            MaxCombo = score.MaxCombo,
+                            Accuracy = score.Accuracy,
+                            HasReplay = ((IScoreInfo)score).HasReplay,
+                            Date = score.Date,
+                            PP = score.PP,
+                            Rank = score.Rank,
+                            HitEvents = score.HitEvents,
+                            Passed = score.Passed,
+                            Combo = score.Combo,
+                            Position = score.Position,
+                            Statistics = score.Statistics,
+                            Mods = score.Mods,
+                            APIMods = score.APIMods,
+                        };
+
+                        migrateFiles(score, realm, realmScore);
+
+                        realm.Add(realmScore);
+                    }
                 }
+                finally
+                {
+                    transaction.Commit();
+                }
+
+                log($"Successfully migrated {count} scores to realm");
             });
         }
 
diff --git a/osu.Game/Screens/Loader.cs b/osu.Game/Screens/Loader.cs
index 8c4a13f2bd..a72ba89dfa 100644
--- a/osu.Game/Screens/Loader.cs
+++ b/osu.Game/Screens/Loader.cs
@@ -74,11 +74,22 @@ namespace osu.Game.Screens
             base.OnEntering(last);
 
             LoadComponentAsync(precompiler = CreateShaderPrecompiler(), AddInternal);
-            LoadComponentAsync(loadableScreen = CreateLoadableScreen());
 
             // A non-null context factory means there's still content to migrate.
             if (efContextFactory != null)
+            {
                 LoadComponentAsync(realmMigrator = new EFToRealmMigrator(), AddInternal);
+                realmMigrator.MigrationCompleted.ContinueWith(_ => Schedule(() =>
+                {
+                    // Delay initial screen loading to ensure that the migration is in a complete and sane state
+                    // before the intro screen may import the game intro beatmap.
+                    LoadComponentAsync(loadableScreen = CreateLoadableScreen());
+                }));
+            }
+            else
+            {
+                LoadComponentAsync(loadableScreen = CreateLoadableScreen());
+            }
 
             LoadComponentAsync(spinner = new LoadingSpinner(true, true)
             {
@@ -96,7 +107,7 @@ namespace osu.Game.Screens
 
         private void checkIfLoaded()
         {
-            if (loadableScreen.LoadState != LoadState.Ready || !precompiler.FinishedCompiling || realmMigrator?.FinishedMigrating == false)
+            if (loadableScreen?.LoadState != LoadState.Ready || !precompiler.FinishedCompiling)
             {
                 Schedule(checkIfLoaded);
                 return;

From 948867898cb36ed2a32ff2e58a6f7c9de64d66d5 Mon Sep 17 00:00:00 2001
From: mk-56 <darioheadleysilva@gmail.com>
Date: Mon, 24 Jan 2022 11:38:52 +0100
Subject: [PATCH 2450/5547] ModeMultiplier rename

---
 osu.Game.Rulesets.Catch/Mods/CatchModFlashlight.cs |  8 ++++----
 osu.Game.Rulesets.Mania/Mods/ManiaModFlashlight.cs |  8 ++++----
 osu.Game.Rulesets.Osu/Mods/OsuModFlashlight.cs     |  8 ++++----
 osu.Game.Rulesets.Taiko/Mods/TaikoModFlashlight.cs |  8 ++++----
 osu.Game/Rulesets/Mods/ModFlashlight.cs            | 14 ++++++--------
 5 files changed, 22 insertions(+), 24 deletions(-)

diff --git a/osu.Game.Rulesets.Catch/Mods/CatchModFlashlight.cs b/osu.Game.Rulesets.Catch/Mods/CatchModFlashlight.cs
index 4fbbf63abf..d48382a9ee 100644
--- a/osu.Game.Rulesets.Catch/Mods/CatchModFlashlight.cs
+++ b/osu.Game.Rulesets.Catch/Mods/CatchModFlashlight.cs
@@ -33,9 +33,9 @@ namespace osu.Game.Rulesets.Catch.Mods
             Precision = 0.1f
         };
 
-        protected override float ModeMultiplier => 350;
+        protected virtual float DefaultFlashlightSize => 350;
 
-        public override Flashlight CreateFlashlight() => new CatchFlashlight(playfield, ChangeRadius.Value, InitialRadius.Value, ModeMultiplier);
+        public override Flashlight CreateFlashlight() => new CatchFlashlight(playfield, ChangeRadius.Value, InitialRadius.Value, DefaultFlashlightSize);
 
         private CatchPlayfield playfield;
 
@@ -49,8 +49,8 @@ namespace osu.Game.Rulesets.Catch.Mods
         {
             private readonly CatchPlayfield playfield;
 
-            public CatchFlashlight(CatchPlayfield playfield, bool isRadiusBasedOnCombo, float initialRadius, float modeMultiplier)
-                : base(isRadiusBasedOnCombo, initialRadius, modeMultiplier)
+            public CatchFlashlight(CatchPlayfield playfield, bool isRadiusBasedOnCombo, float initialRadius, float defaultFlashlightSize)
+                : base(isRadiusBasedOnCombo, initialRadius, defaultFlashlightSize)
             {
                 this.playfield = playfield;
                 FlashlightSize = new Vector2(0, GetRadiusFor(0));
diff --git a/osu.Game.Rulesets.Mania/Mods/ManiaModFlashlight.cs b/osu.Game.Rulesets.Mania/Mods/ManiaModFlashlight.cs
index 61f73a1ee5..eb3f60edce 100644
--- a/osu.Game.Rulesets.Mania/Mods/ManiaModFlashlight.cs
+++ b/osu.Game.Rulesets.Mania/Mods/ManiaModFlashlight.cs
@@ -34,16 +34,16 @@ namespace osu.Game.Rulesets.Mania.Mods
             Precision = 0.1f
         };
 
-        protected override float ModeMultiplier => 50;
+        protected virtual float DefaultFlashlightSize => 50;
 
-        public override Flashlight CreateFlashlight() => new ManiaFlashlight(ChangeRadius.Value, InitialRadius.Value, ModeMultiplier);
+        public override Flashlight CreateFlashlight() => new ManiaFlashlight(ChangeRadius.Value, InitialRadius.Value, DefaultFlashlightSize);
 
         private class ManiaFlashlight : Flashlight
         {
             private readonly LayoutValue flashlightProperties = new LayoutValue(Invalidation.DrawSize);
 
-            public ManiaFlashlight(bool isRadiusBasedOnCombo, float initialRadius, float modeMultiplier)
-                : base(isRadiusBasedOnCombo, initialRadius, modeMultiplier)
+            public ManiaFlashlight(bool isRadiusBasedOnCombo, float initialRadius, float defaultFlashlightSize)
+                : base(isRadiusBasedOnCombo, initialRadius, defaultFlashlightSize)
             {
                 FlashlightSize = new Vector2(DrawWidth, GetRadiusFor(0));
 
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModFlashlight.cs b/osu.Game.Rulesets.Osu/Mods/OsuModFlashlight.cs
index 75299863a9..6a9d199c54 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModFlashlight.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModFlashlight.cs
@@ -47,11 +47,11 @@ namespace osu.Game.Rulesets.Osu.Mods
             Precision = 0.1f
         };
 
-        protected override float ModeMultiplier => 180;
+        protected virtual float DefaultFlashlightSize => 180;
 
         private OsuFlashlight flashlight;
 
-        public override Flashlight CreateFlashlight() => flashlight = new OsuFlashlight(ChangeRadius.Value, InitialRadius.Value, FollowDelay.Value, ModeMultiplier);
+        public override Flashlight CreateFlashlight() => flashlight = new OsuFlashlight(ChangeRadius.Value, InitialRadius.Value, FollowDelay.Value, DefaultFlashlightSize);
 
         public void ApplyToDrawableHitObject(DrawableHitObject drawable)
         {
@@ -66,8 +66,8 @@ namespace osu.Game.Rulesets.Osu.Mods
             //public float InitialRadius { private get; set; }
             public bool ChangeRadius { private get; set; }
 
-            public OsuFlashlight(bool isRadiusBasedOnCombo, float initialRadius, double followDelay, float modeMultiplier)
-                : base(isRadiusBasedOnCombo, initialRadius, modeMultiplier)
+            public OsuFlashlight(bool isRadiusBasedOnCombo, float initialRadius, double followDelay, float defaultFlashlightSize)
+                : base(isRadiusBasedOnCombo, initialRadius, defaultFlashlightSize)
             {
                 FollowDelay = followDelay;
 
diff --git a/osu.Game.Rulesets.Taiko/Mods/TaikoModFlashlight.cs b/osu.Game.Rulesets.Taiko/Mods/TaikoModFlashlight.cs
index 65a173b491..8de7c859c4 100644
--- a/osu.Game.Rulesets.Taiko/Mods/TaikoModFlashlight.cs
+++ b/osu.Game.Rulesets.Taiko/Mods/TaikoModFlashlight.cs
@@ -34,9 +34,9 @@ namespace osu.Game.Rulesets.Taiko.Mods
             Precision = 0.1f
         };
 
-        protected override float ModeMultiplier => 250;
+        protected virtual float DefaultFlashlightSize => 250;
 
-        public override Flashlight CreateFlashlight() => new TaikoFlashlight(playfield, ChangeRadius.Value, InitialRadius.Value, ModeMultiplier);
+        public override Flashlight CreateFlashlight() => new TaikoFlashlight(playfield, ChangeRadius.Value, InitialRadius.Value, DefaultFlashlightSize);
 
         private TaikoPlayfield playfield;
 
@@ -51,8 +51,8 @@ namespace osu.Game.Rulesets.Taiko.Mods
             private readonly LayoutValue flashlightProperties = new LayoutValue(Invalidation.DrawSize);
             private readonly TaikoPlayfield taikoPlayfield;
 
-            public TaikoFlashlight(TaikoPlayfield taikoPlayfield, bool isRadiusBasedOnCombo, float initialRadius, float modeMultiplier)
-                : base(isRadiusBasedOnCombo, initialRadius, modeMultiplier)
+            public TaikoFlashlight(TaikoPlayfield taikoPlayfield, bool isRadiusBasedOnCombo, float initialRadius, float defaultFlashlightSize)
+                : base(isRadiusBasedOnCombo, initialRadius, defaultFlashlightSize)
             {
                 this.taikoPlayfield = taikoPlayfield;
                 FlashlightSize = getSizeFor(0);
diff --git a/osu.Game/Rulesets/Mods/ModFlashlight.cs b/osu.Game/Rulesets/Mods/ModFlashlight.cs
index 7b980e8097..531ee92b7a 100644
--- a/osu.Game/Rulesets/Mods/ModFlashlight.cs
+++ b/osu.Game/Rulesets/Mods/ModFlashlight.cs
@@ -38,8 +38,6 @@ namespace osu.Game.Rulesets.Mods
 
         [SettingSource("Initial radius", "Initial radius of the flashlight area.")]
         public abstract BindableNumber<float> InitialRadius { get; }
-
-        protected abstract float ModeMultiplier { get; }
     }
 
     public abstract class ModFlashlight<T> : ModFlashlight, IApplicableToDrawableRuleset<T>, IApplicableToScoreProcessor
@@ -102,13 +100,13 @@ namespace osu.Game.Rulesets.Mods
 
             public readonly float InitialRadius;
 
-            public readonly float ModeMultiplier;
+            public readonly float DefaultFlashlightSize;
 
-            protected Flashlight(bool isRadiusBasedOnCombo, float initialRadius, float modeMultiplier)
+            protected Flashlight(bool isRadiusBasedOnCombo, float initialRadius, float defaultFlashlightSize)
             {
                 IsRadiusBasedOnCombo = isRadiusBasedOnCombo;
                 InitialRadius = initialRadius;
-                ModeMultiplier = modeMultiplier;
+                DefaultFlashlightSize = defaultFlashlightSize;
             }
 
             [BackgroundDependencyLoader]
@@ -147,12 +145,12 @@ namespace osu.Game.Rulesets.Mods
                 if (IsRadiusBasedOnCombo)
                 {
                     if (combo > 200)
-                        return InitialRadius * 0.8f * ModeMultiplier;
+                        return InitialRadius * 0.8f * DefaultFlashlightSize;
                     else if (combo > 100)
-                        return InitialRadius * 0.9f * ModeMultiplier;
+                        return InitialRadius * 0.9f * DefaultFlashlightSize;
                 }
 
-                return InitialRadius * ModeMultiplier;
+                return InitialRadius * DefaultFlashlightSize;
             }
 
             private Vector2 flashlightPosition;

From deaff340d2733c544b8e87d78a51d5d69063ee27 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 24 Jan 2022 17:58:06 +0900
Subject: [PATCH 2451/5547] Add test coverage of saving velocity

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

diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderVelocityAdjust.cs b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderVelocityAdjust.cs
new file mode 100644
index 0000000000..4750c97566
--- /dev/null
+++ b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderVelocityAdjust.cs
@@ -0,0 +1,98 @@
+// 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 System.Linq;
+using NUnit.Framework;
+using osu.Framework.Input;
+using osu.Framework.Testing;
+using osu.Framework.Utils;
+using osu.Game.Beatmaps;
+using osu.Game.Rulesets.Edit;
+using osu.Game.Rulesets.Osu.Objects;
+using osu.Game.Rulesets.UI;
+using osu.Game.Screens.Edit;
+using osu.Game.Screens.Edit.Compose.Components.Timeline;
+using osu.Game.Screens.Edit.Timing;
+using osu.Game.Tests.Beatmaps;
+using osu.Game.Tests.Visual;
+using osuTK;
+using osuTK.Input;
+
+namespace osu.Game.Rulesets.Osu.Tests.Editor
+{
+    public class TestSceneSliderVelocityAdjust : OsuGameTestScene
+    {
+        private Screens.Edit.Editor editor => Game.ScreenStack.CurrentScreen as Screens.Edit.Editor;
+
+        private EditorBeatmap editorBeatmap => editor.ChildrenOfType<EditorBeatmap>().FirstOrDefault();
+
+        private EditorClock editorClock => editor.ChildrenOfType<EditorClock>().FirstOrDefault();
+
+        private Slider slider => editorBeatmap.HitObjects.OfType<Slider>().FirstOrDefault();
+
+        private TimelineHitObjectBlueprint blueprint => editor.ChildrenOfType<TimelineHitObjectBlueprint>().FirstOrDefault();
+
+        private DifficultyPointPiece difficultyPointPiece => blueprint.ChildrenOfType<DifficultyPointPiece>().First();
+
+        private IndeterminateSliderWithTextBoxInput<double> velocityTextBox => Game.ChildrenOfType<DifficultyPointPiece.DifficultyEditPopover>().First().ChildrenOfType<IndeterminateSliderWithTextBoxInput<double>>().First();
+
+        protected override IBeatmap CreateBeatmap(RulesetInfo ruleset) => new TestBeatmap(ruleset, false);
+
+        private bool editorComponentsReady => editor.ChildrenOfType<HitObjectComposer>().FirstOrDefault()?.IsLoaded == true
+                                              && editor.ChildrenOfType<TimelineArea>().FirstOrDefault()?.IsLoaded == true
+                                              && editor?.ChildrenOfType<Playfield>().FirstOrDefault()?.IsLoaded == true;
+
+        [TestCase(true)]
+        [TestCase(false)]
+        public void TestVelocityChangeSavesCorrectly(bool adjustVelocity)
+        {
+            double? velocity = null;
+
+            AddStep("enter editor", () => Game.ScreenStack.Push(new EditorLoader()));
+            AddUntilStep("wait for editor load", () => editorComponentsReady);
+
+            AddStep("seek to first control point", () => editorClock.Seek(editorBeatmap.ControlPointInfo.TimingPoints.First().Time));
+            AddStep("enter slider placement mode", () => InputManager.Key(Key.Number3));
+
+            AddStep("move mouse to centre", () => InputManager.MoveMouseTo(editor.ChildrenOfType<Playfield>().First().ScreenSpaceDrawQuad.Centre));
+            AddStep("start placement", () => InputManager.Click(MouseButton.Left));
+
+            AddStep("move mouse to bottom right", () => InputManager.MoveMouseTo(editor.ChildrenOfType<Playfield>().First().ScreenSpaceDrawQuad.BottomRight - new Vector2(10)));
+            AddStep("end placement", () => InputManager.Click(MouseButton.Right));
+
+            AddStep("exit placement mode", () => InputManager.Key(Key.Number1));
+
+            AddAssert("slider placed", () => slider != null);
+
+            AddStep("select slider", () => editorBeatmap.SelectedHitObjects.Add(slider));
+
+            AddAssert("ensure one slider placed", () => slider != null);
+
+            AddStep("store velocity", () => velocity = slider.Velocity);
+
+            if (adjustVelocity)
+            {
+                AddStep("open velocity adjust panel", () => difficultyPointPiece.TriggerClick());
+                AddStep("change velocity", () => velocityTextBox.Current.Value = 2);
+
+                AddAssert("velocity adjusted", () =>
+                {
+                    Debug.Assert(velocity != null);
+                    return Precision.AlmostEquals(velocity.Value * 2, slider.Velocity);
+                });
+
+                AddStep("store velocity", () => velocity = slider.Velocity);
+            }
+
+            AddStep("save", () => InputManager.Keys(PlatformAction.Save));
+            AddStep("exit", () => InputManager.Key(Key.Escape));
+
+            AddStep("enter editor (again)", () => Game.ScreenStack.Push(new EditorLoader()));
+            AddUntilStep("wait for editor load", () => editorComponentsReady);
+
+            AddStep("seek to slider", () => editorClock.Seek(slider.StartTime));
+            AddAssert("slider has correct velocity", () => slider.Velocity == velocity);
+        }
+    }
+}

From c3758047fd9e2113173ea9bfcba50a575f5b7035 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 24 Jan 2022 19:54:07 +0900
Subject: [PATCH 2452/5547] Don't include nested hit objects'
 `DifficultyControLPoints` in legacy encoder logic

The editor doesn't currently propagate velocity to nested objects. We're
not yet sure whether it should or not. For now, let's just ignore nested
objects' `DifficultyControlPoints` for simplicity.

Note that this only affects osu! ruleset due to the pre-check on
`isOsuRuleset`.
---
 osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs b/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs
index 4cf6d3335f..9d848fd8a4 100644
--- a/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs
+++ b/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs
@@ -242,12 +242,7 @@ namespace osu.Game.Beatmaps.Formats
                     yield break;
 
                 foreach (var hitObject in hitObjects)
-                {
                     yield return hitObject.DifficultyControlPoint;
-
-                    foreach (var nested in collectDifficultyControlPoints(hitObject.NestedHitObjects))
-                        yield return nested;
-                }
             }
 
             void extractDifficultyControlPoints(IEnumerable<HitObject> hitObjects)

From 6eb2c28e41369be24fbefb14478b62935207992d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 24 Jan 2022 19:59:58 +0900
Subject: [PATCH 2453/5547] Rename `RealmContextFactory` to `RealmAccess`

---
 osu.Game.Benchmarks/BenchmarkRealmReads.cs    |  20 +-
 .../Beatmaps/IO/BeatmapImportHelper.cs        |   4 +-
 .../Database/BeatmapImporterTests.cs          | 258 +++++++++---------
 osu.Game.Tests/Database/FileStoreTests.cs     |  24 +-
 osu.Game.Tests/Database/GeneralUsageTests.cs  |  22 +-
 osu.Game.Tests/Database/RealmLiveTests.cs     |  60 ++--
 .../RealmSubscriptionRegistrationTests.cs     |  42 +--
 osu.Game.Tests/Database/RealmTest.cs          |  34 +--
 osu.Game.Tests/Database/RulesetStoreTests.cs  |  18 +-
 .../Database/TestRealmKeyBindingStore.cs      |  16 +-
 .../Gameplay/TestSceneStoryboardSamples.cs    |   2 +-
 ...eneOnlinePlayBeatmapAvailabilityTracker.cs |  20 +-
 .../Background/TestSceneUserDimBackgrounds.cs |   6 +-
 .../TestSceneManageCollectionsDialog.cs       |   6 +-
 .../Visual/Multiplayer/QueueModeTestScene.cs  |   6 +-
 .../TestSceneDrawableRoomPlaylist.cs          |   6 +-
 .../Multiplayer/TestSceneMultiplayer.cs       |   6 +-
 .../TestSceneMultiplayerMatchSongSelect.cs    |   6 +-
 .../TestSceneMultiplayerMatchSubScreen.cs     |   6 +-
 .../TestSceneMultiplayerPlaylist.cs           |   6 +-
 .../TestSceneMultiplayerQueueList.cs          |   6 +-
 .../TestSceneMultiplayerReadyButton.cs        |   6 +-
 .../TestSceneMultiplayerSpectateButton.cs     |   6 +-
 .../TestScenePlaylistsSongSelect.cs           |   6 +-
 .../Visual/Multiplayer/TestSceneTeamVersus.cs |   6 +-
 .../TestSceneChangeAndUseGameplayBindings.cs  |   2 +-
 .../TestScenePlaylistsRoomCreation.cs         |   6 +-
 .../Visual/Ranking/TestSceneResultsScreen.cs  |   4 +-
 .../SongSelect/TestSceneBeatmapLeaderboard.cs |   8 +-
 .../SongSelect/TestSceneFilterControl.cs      |   6 +-
 .../SongSelect/TestScenePlaySongSelect.cs     |   6 +-
 .../SongSelect/TestSceneTopLocalRank.cs       |   8 +-
 .../TestSceneDeleteLocalScore.cs              |  12 +-
 osu.Game/Beatmaps/BeatmapManager.cs           |  30 +-
 osu.Game/Beatmaps/BeatmapModelManager.cs      |   8 +-
 osu.Game/Beatmaps/WorkingBeatmapCache.cs      |   2 +-
 osu.Game/Configuration/SettingsStore.cs       |   6 +-
 osu.Game/Database/EFToRealmMigrator.cs        |  12 +-
 ...{RealmContextFactory.cs => RealmAccess.cs} |  10 +-
 osu.Game/Database/RealmLive.cs                |  14 +-
 osu.Game/Database/RealmObjectExtensions.cs    |  12 +-
 osu.Game/IO/IStorageResourceProvider.cs       |   2 +-
 .../Bindings/DatabasedKeyBindingContainer.cs  |   8 +-
 osu.Game/Input/RealmKeyBindingStore.cs        |  10 +-
 osu.Game/Online/BeatmapDownloadTracker.cs     |   4 +-
 .../OnlinePlayBeatmapAvailabilityTracker.cs   |  10 +-
 osu.Game/Online/ScoreDownloadTracker.cs       |   4 +-
 osu.Game/OsuGameBase.cs                       |  22 +-
 osu.Game/Overlays/MusicController.cs          |  10 +-
 .../Sections/DebugSettings/MemorySettings.cs  |   6 +-
 .../Settings/Sections/Input/KeyBindingRow.cs  |   4 +-
 .../Sections/Input/KeyBindingsSubsection.cs   |   8 +-
 .../Overlays/Settings/Sections/SkinSection.cs |  14 +-
 osu.Game/Overlays/Toolbar/ToolbarButton.cs    |   4 +-
 .../Configuration/RulesetConfigManager.cs     |  12 +-
 osu.Game/Rulesets/RulesetConfigCache.cs       |   8 +-
 osu.Game/Rulesets/RulesetStore.cs             |   8 +-
 osu.Game/Scoring/ScoreManager.cs              |  12 +-
 osu.Game/Scoring/ScoreModelManager.cs         |   6 +-
 osu.Game/Screens/Menu/IntroScreen.cs          |   6 +-
 osu.Game/Screens/Select/BeatmapCarousel.cs    |  14 +-
 .../Screens/Select/Carousel/TopLocalRank.cs   |   4 +-
 .../Select/Leaderboards/BeatmapLeaderboard.cs |   6 +-
 osu.Game/Screens/Spectate/SpectatorScreen.cs  |   4 +-
 osu.Game/Skinning/Skin.cs                     |   4 +-
 osu.Game/Skinning/SkinManager.cs              |  22 +-
 osu.Game/Skinning/SkinModelManager.cs         |   6 +-
 osu.Game/Stores/BeatmapImporter.cs            |   6 +-
 osu.Game/Stores/RealmArchiveModelImporter.cs  |  16 +-
 osu.Game/Stores/RealmArchiveModelManager.cs   |  12 +-
 osu.Game/Stores/RealmFileStore.cs             |   8 +-
 .../Drawables/DrawableStoryboard.cs           |   4 +-
 .../Tests/Beatmaps/HitObjectSampleTest.cs     |   2 +-
 osu.Game/Tests/Visual/EditorTestScene.cs      |  14 +-
 osu.Game/Tests/Visual/OsuTestScene.cs         |   6 +-
 osu.Game/Tests/Visual/SkinnableTestScene.cs   |   2 +-
 76 files changed, 516 insertions(+), 516 deletions(-)
 rename osu.Game/Database/{RealmContextFactory.cs => RealmAccess.cs} (98%)

diff --git a/osu.Game.Benchmarks/BenchmarkRealmReads.cs b/osu.Game.Benchmarks/BenchmarkRealmReads.cs
index bb22fab51c..412f86bd1c 100644
--- a/osu.Game.Benchmarks/BenchmarkRealmReads.cs
+++ b/osu.Game.Benchmarks/BenchmarkRealmReads.cs
@@ -16,7 +16,7 @@ namespace osu.Game.Benchmarks
     public class BenchmarkRealmReads : BenchmarkTest
     {
         private TemporaryNativeStorage storage;
-        private RealmContextFactory realmFactory;
+        private RealmAccess realm;
         private UpdateThread updateThread;
 
         [Params(1, 100, 1000)]
@@ -27,9 +27,9 @@ namespace osu.Game.Benchmarks
             storage = new TemporaryNativeStorage("realm-benchmark");
             storage.DeleteDirectory(string.Empty);
 
-            realmFactory = new RealmContextFactory(storage, "client");
+            realm = new RealmAccess(storage, "client");
 
-            realmFactory.Run(realm =>
+            realm.Run(realm =>
             {
                 realm.Write(c => c.Add(TestResources.CreateTestBeatmapSetInfo(rulesets: new[] { new OsuRuleset().RulesetInfo })));
             });
@@ -41,7 +41,7 @@ namespace osu.Game.Benchmarks
         [Benchmark]
         public void BenchmarkDirectPropertyRead()
         {
-            realmFactory.Run(realm =>
+            realm.Run(realm =>
             {
                 var beatmapSet = realm.All<BeatmapSetInfo>().First();
 
@@ -61,7 +61,7 @@ namespace osu.Game.Benchmarks
             {
                 try
                 {
-                    var beatmapSet = realmFactory.Context.All<BeatmapSetInfo>().First();
+                    var beatmapSet = realm.Realm.All<BeatmapSetInfo>().First();
 
                     for (int i = 0; i < ReadsPerFetch; i++)
                     {
@@ -80,9 +80,9 @@ namespace osu.Game.Benchmarks
         [Benchmark]
         public void BenchmarkRealmLivePropertyRead()
         {
-            realmFactory.Run(realm =>
+            realm.Run(r =>
             {
-                var beatmapSet = realm.All<BeatmapSetInfo>().First().ToLive(realmFactory);
+                var beatmapSet = r.All<BeatmapSetInfo>().First().ToLive(realm);
 
                 for (int i = 0; i < ReadsPerFetch; i++)
                 {
@@ -100,7 +100,7 @@ namespace osu.Game.Benchmarks
             {
                 try
                 {
-                    var beatmapSet = realmFactory.Context.All<BeatmapSetInfo>().First().ToLive(realmFactory);
+                    var beatmapSet = realm.Realm.All<BeatmapSetInfo>().First().ToLive(realm);
 
                     for (int i = 0; i < ReadsPerFetch; i++)
                     {
@@ -119,7 +119,7 @@ namespace osu.Game.Benchmarks
         [Benchmark]
         public void BenchmarkDetachedPropertyRead()
         {
-            realmFactory.Run(realm =>
+            realm.Run(realm =>
             {
                 var beatmapSet = realm.All<BeatmapSetInfo>().First().Detach();
 
@@ -133,7 +133,7 @@ namespace osu.Game.Benchmarks
         [GlobalCleanup]
         public void Cleanup()
         {
-            realmFactory?.Dispose();
+            realm?.Dispose();
             storage?.Dispose();
             updateThread?.Exit();
         }
diff --git a/osu.Game.Tests/Beatmaps/IO/BeatmapImportHelper.cs b/osu.Game.Tests/Beatmaps/IO/BeatmapImportHelper.cs
index 7aa2dc7093..9e440c6bce 100644
--- a/osu.Game.Tests/Beatmaps/IO/BeatmapImportHelper.cs
+++ b/osu.Game.Tests/Beatmaps/IO/BeatmapImportHelper.cs
@@ -53,9 +53,9 @@ namespace osu.Game.Tests.Beatmaps.IO
 
         private static void ensureLoaded(OsuGameBase osu, int timeout = 60000)
         {
-            var realmContextFactory = osu.Dependencies.Get<RealmContextFactory>();
+            var realm = osu.Dependencies.Get<RealmAccess>();
 
-            realmContextFactory.Run(realm => BeatmapImporterTests.EnsureLoaded(realm, timeout));
+            realm.Run(r => BeatmapImporterTests.EnsureLoaded(r, timeout));
 
             // TODO: add back some extra checks outside of the realm ones?
             // var set = queryBeatmapSets().First();
diff --git a/osu.Game.Tests/Database/BeatmapImporterTests.cs b/osu.Game.Tests/Database/BeatmapImporterTests.cs
index 227314cffd..a52b21244c 100644
--- a/osu.Game.Tests/Database/BeatmapImporterTests.cs
+++ b/osu.Game.Tests/Database/BeatmapImporterTests.cs
@@ -38,10 +38,10 @@ namespace osu.Game.Tests.Database
         [Test]
         public void TestDetachBeatmapSet()
         {
-            RunTestWithRealmAsync(async (realmFactory, storage) =>
+            RunTestWithRealmAsync(async (realm, storage) =>
             {
-                using (var importer = new BeatmapModelManager(realmFactory, storage))
-                using (new RulesetStore(realmFactory, storage))
+                using (var importer = new BeatmapModelManager(realm, storage))
+                using (new RulesetStore(realm, storage))
                 {
                     ILive<BeatmapSetInfo>? beatmapSet;
 
@@ -82,10 +82,10 @@ namespace osu.Game.Tests.Database
         [Test]
         public void TestUpdateDetachedBeatmapSet()
         {
-            RunTestWithRealmAsync(async (realmFactory, storage) =>
+            RunTestWithRealmAsync(async (realm, storage) =>
             {
-                using (var importer = new BeatmapModelManager(realmFactory, storage))
-                using (new RulesetStore(realmFactory, storage))
+                using (var importer = new BeatmapModelManager(realm, storage))
+                using (new RulesetStore(realm, storage))
                 {
                     ILive<BeatmapSetInfo>? beatmapSet;
 
@@ -139,53 +139,53 @@ namespace osu.Game.Tests.Database
         [Test]
         public void TestImportBeatmapThenCleanup()
         {
-            RunTestWithRealmAsync(async (realmFactory, storage) =>
+            RunTestWithRealmAsync(async (realm, storage) =>
             {
-                using (var importer = new BeatmapModelManager(realmFactory, storage))
-                using (new RulesetStore(realmFactory, storage))
+                using (var importer = new BeatmapModelManager(realm, storage))
+                using (new RulesetStore(realm, storage))
                 {
                     ILive<BeatmapSetInfo>? imported;
 
                     using (var reader = new ZipArchiveReader(TestResources.GetTestBeatmapStream()))
                         imported = await importer.Import(reader);
 
-                    Assert.AreEqual(1, realmFactory.Context.All<BeatmapSetInfo>().Count());
+                    Assert.AreEqual(1, realm.Realm.All<BeatmapSetInfo>().Count());
 
                     Assert.NotNull(imported);
                     Debug.Assert(imported != null);
 
                     imported.PerformWrite(s => s.DeletePending = true);
 
-                    Assert.AreEqual(1, realmFactory.Context.All<BeatmapSetInfo>().Count(s => s.DeletePending));
+                    Assert.AreEqual(1, realm.Realm.All<BeatmapSetInfo>().Count(s => s.DeletePending));
                 }
             });
 
             Logger.Log("Running with no work to purge pending deletions");
 
-            RunTestWithRealm((realmFactory, _) => { Assert.AreEqual(0, realmFactory.Context.All<BeatmapSetInfo>().Count()); });
+            RunTestWithRealm((realm, _) => { Assert.AreEqual(0, realm.Realm.All<BeatmapSetInfo>().Count()); });
         }
 
         [Test]
         public void TestImportWhenClosed()
         {
-            RunTestWithRealmAsync(async (realmFactory, storage) =>
+            RunTestWithRealmAsync(async (realm, storage) =>
             {
-                using var importer = new BeatmapModelManager(realmFactory, storage);
-                using var store = new RulesetStore(realmFactory, storage);
+                using var importer = new BeatmapModelManager(realm, storage);
+                using var store = new RulesetStore(realm, storage);
 
-                await LoadOszIntoStore(importer, realmFactory.Context);
+                await LoadOszIntoStore(importer, realm.Realm);
             });
         }
 
         [Test]
         public void TestAccessFileAfterImport()
         {
-            RunTestWithRealmAsync(async (realmFactory, storage) =>
+            RunTestWithRealmAsync(async (realm, storage) =>
             {
-                using var importer = new BeatmapModelManager(realmFactory, storage);
-                using var store = new RulesetStore(realmFactory, storage);
+                using var importer = new BeatmapModelManager(realm, storage);
+                using var store = new RulesetStore(realm, storage);
 
-                var imported = await LoadOszIntoStore(importer, realmFactory.Context);
+                var imported = await LoadOszIntoStore(importer, realm.Realm);
 
                 var beatmap = imported.Beatmaps.First();
                 var file = beatmap.File;
@@ -198,24 +198,24 @@ namespace osu.Game.Tests.Database
         [Test]
         public void TestImportThenDelete()
         {
-            RunTestWithRealmAsync(async (realmFactory, storage) =>
+            RunTestWithRealmAsync(async (realm, storage) =>
             {
-                using var importer = new BeatmapModelManager(realmFactory, storage);
-                using var store = new RulesetStore(realmFactory, storage);
+                using var importer = new BeatmapModelManager(realm, storage);
+                using var store = new RulesetStore(realm, storage);
 
-                var imported = await LoadOszIntoStore(importer, realmFactory.Context);
+                var imported = await LoadOszIntoStore(importer, realm.Realm);
 
-                deleteBeatmapSet(imported, realmFactory.Context);
+                deleteBeatmapSet(imported, realm.Realm);
             });
         }
 
         [Test]
         public void TestImportThenDeleteFromStream()
         {
-            RunTestWithRealmAsync(async (realmFactory, storage) =>
+            RunTestWithRealmAsync(async (realm, storage) =>
             {
-                using var importer = new BeatmapModelManager(realmFactory, storage);
-                using var store = new RulesetStore(realmFactory, storage);
+                using var importer = new BeatmapModelManager(realm, storage);
+                using var store = new RulesetStore(realm, storage);
 
                 string? tempPath = TestResources.GetTestBeatmapForImport();
 
@@ -224,7 +224,7 @@ namespace osu.Game.Tests.Database
                 using (var stream = File.OpenRead(tempPath))
                 {
                     importedSet = await importer.Import(new ImportTask(stream, Path.GetFileName(tempPath)));
-                    EnsureLoaded(realmFactory.Context);
+                    EnsureLoaded(realm.Realm);
                 }
 
                 Assert.NotNull(importedSet);
@@ -233,39 +233,39 @@ namespace osu.Game.Tests.Database
                 Assert.IsTrue(File.Exists(tempPath), "Stream source file somehow went missing");
                 File.Delete(tempPath);
 
-                var imported = realmFactory.Context.All<BeatmapSetInfo>().First(beatmapSet => beatmapSet.ID == importedSet.ID);
+                var imported = realm.Realm.All<BeatmapSetInfo>().First(beatmapSet => beatmapSet.ID == importedSet.ID);
 
-                deleteBeatmapSet(imported, realmFactory.Context);
+                deleteBeatmapSet(imported, realm.Realm);
             });
         }
 
         [Test]
         public void TestImportThenImport()
         {
-            RunTestWithRealmAsync(async (realmFactory, storage) =>
+            RunTestWithRealmAsync(async (realm, storage) =>
             {
-                using var importer = new BeatmapModelManager(realmFactory, storage);
-                using var store = new RulesetStore(realmFactory, storage);
+                using var importer = new BeatmapModelManager(realm, storage);
+                using var store = new RulesetStore(realm, storage);
 
-                var imported = await LoadOszIntoStore(importer, realmFactory.Context);
-                var importedSecondTime = await LoadOszIntoStore(importer, realmFactory.Context);
+                var imported = await LoadOszIntoStore(importer, realm.Realm);
+                var importedSecondTime = await LoadOszIntoStore(importer, realm.Realm);
 
                 // check the newly "imported" beatmap is actually just the restored previous import. since it matches hash.
                 Assert.IsTrue(imported.ID == importedSecondTime.ID);
                 Assert.IsTrue(imported.Beatmaps.First().ID == importedSecondTime.Beatmaps.First().ID);
 
-                checkBeatmapSetCount(realmFactory.Context, 1);
-                checkSingleReferencedFileCount(realmFactory.Context, 18);
+                checkBeatmapSetCount(realm.Realm, 1);
+                checkSingleReferencedFileCount(realm.Realm, 18);
             });
         }
 
         [Test]
         public void TestImportThenImportWithReZip()
         {
-            RunTestWithRealmAsync(async (realmFactory, storage) =>
+            RunTestWithRealmAsync(async (realm, storage) =>
             {
-                using var importer = new BeatmapModelManager(realmFactory, storage);
-                using var store = new RulesetStore(realmFactory, storage);
+                using var importer = new BeatmapModelManager(realm, storage);
+                using var store = new RulesetStore(realm, storage);
 
                 string? temp = TestResources.GetTestBeatmapForImport();
 
@@ -274,7 +274,7 @@ namespace osu.Game.Tests.Database
 
                 try
                 {
-                    var imported = await LoadOszIntoStore(importer, realmFactory.Context);
+                    var imported = await LoadOszIntoStore(importer, realm.Realm);
 
                     string hashBefore = hashFile(temp);
 
@@ -292,7 +292,7 @@ namespace osu.Game.Tests.Database
 
                     var importedSecondTime = await importer.Import(new ImportTask(temp));
 
-                    EnsureLoaded(realmFactory.Context);
+                    EnsureLoaded(realm.Realm);
 
                     Assert.NotNull(importedSecondTime);
                     Debug.Assert(importedSecondTime != null);
@@ -311,10 +311,10 @@ namespace osu.Game.Tests.Database
         [Test]
         public void TestImportThenImportWithChangedHashedFile()
         {
-            RunTestWithRealmAsync(async (realmFactory, storage) =>
+            RunTestWithRealmAsync(async (realm, storage) =>
             {
-                using var importer = new BeatmapModelManager(realmFactory, storage);
-                using var store = new RulesetStore(realmFactory, storage);
+                using var importer = new BeatmapModelManager(realm, storage);
+                using var store = new RulesetStore(realm, storage);
 
                 string? temp = TestResources.GetTestBeatmapForImport();
 
@@ -323,9 +323,9 @@ namespace osu.Game.Tests.Database
 
                 try
                 {
-                    var imported = await LoadOszIntoStore(importer, realmFactory.Context);
+                    var imported = await LoadOszIntoStore(importer, realm.Realm);
 
-                    await createScoreForBeatmap(realmFactory.Context, imported.Beatmaps.First());
+                    await createScoreForBeatmap(realm.Realm, imported.Beatmaps.First());
 
                     using (var zip = ZipArchive.Open(temp))
                         zip.WriteToDirectory(extractedFolder);
@@ -343,7 +343,7 @@ namespace osu.Game.Tests.Database
 
                     var importedSecondTime = await importer.Import(new ImportTask(temp));
 
-                    EnsureLoaded(realmFactory.Context);
+                    EnsureLoaded(realm.Realm);
 
                     // check the newly "imported" beatmap is not the original.
                     Assert.NotNull(importedSecondTime);
@@ -363,10 +363,10 @@ namespace osu.Game.Tests.Database
         [Ignore("intentionally broken by import optimisations")]
         public void TestImportThenImportWithChangedFile()
         {
-            RunTestWithRealmAsync(async (realmFactory, storage) =>
+            RunTestWithRealmAsync(async (realm, storage) =>
             {
-                using var importer = new BeatmapModelManager(realmFactory, storage);
-                using var store = new RulesetStore(realmFactory, storage);
+                using var importer = new BeatmapModelManager(realm, storage);
+                using var store = new RulesetStore(realm, storage);
 
                 string? temp = TestResources.GetTestBeatmapForImport();
 
@@ -375,7 +375,7 @@ namespace osu.Game.Tests.Database
 
                 try
                 {
-                    var imported = await LoadOszIntoStore(importer, realmFactory.Context);
+                    var imported = await LoadOszIntoStore(importer, realm.Realm);
 
                     using (var zip = ZipArchive.Open(temp))
                         zip.WriteToDirectory(extractedFolder);
@@ -392,7 +392,7 @@ namespace osu.Game.Tests.Database
 
                     var importedSecondTime = await importer.Import(new ImportTask(temp));
 
-                    EnsureLoaded(realmFactory.Context);
+                    EnsureLoaded(realm.Realm);
 
                     Assert.NotNull(importedSecondTime);
                     Debug.Assert(importedSecondTime != null);
@@ -411,10 +411,10 @@ namespace osu.Game.Tests.Database
         [Test]
         public void TestImportThenImportWithDifferentFilename()
         {
-            RunTestWithRealmAsync(async (realmFactory, storage) =>
+            RunTestWithRealmAsync(async (realm, storage) =>
             {
-                using var importer = new BeatmapModelManager(realmFactory, storage);
-                using var store = new RulesetStore(realmFactory, storage);
+                using var importer = new BeatmapModelManager(realm, storage);
+                using var store = new RulesetStore(realm, storage);
 
                 string? temp = TestResources.GetTestBeatmapForImport();
 
@@ -423,7 +423,7 @@ namespace osu.Game.Tests.Database
 
                 try
                 {
-                    var imported = await LoadOszIntoStore(importer, realmFactory.Context);
+                    var imported = await LoadOszIntoStore(importer, realm.Realm);
 
                     using (var zip = ZipArchive.Open(temp))
                         zip.WriteToDirectory(extractedFolder);
@@ -440,7 +440,7 @@ namespace osu.Game.Tests.Database
 
                     var importedSecondTime = await importer.Import(new ImportTask(temp));
 
-                    EnsureLoaded(realmFactory.Context);
+                    EnsureLoaded(realm.Realm);
 
                     Assert.NotNull(importedSecondTime);
                     Debug.Assert(importedSecondTime != null);
@@ -460,12 +460,12 @@ namespace osu.Game.Tests.Database
         [Ignore("intentionally broken by import optimisations")]
         public void TestImportCorruptThenImport()
         {
-            RunTestWithRealmAsync(async (realmFactory, storage) =>
+            RunTestWithRealmAsync(async (realm, storage) =>
             {
-                using var importer = new BeatmapModelManager(realmFactory, storage);
-                using var store = new RulesetStore(realmFactory, storage);
+                using var importer = new BeatmapModelManager(realm, storage);
+                using var store = new RulesetStore(realm, storage);
 
-                var imported = await LoadOszIntoStore(importer, realmFactory.Context);
+                var imported = await LoadOszIntoStore(importer, realm.Realm);
 
                 var firstFile = imported.Files.First();
 
@@ -476,7 +476,7 @@ namespace osu.Game.Tests.Database
                 using (var stream = storage.GetStream(firstFile.File.GetStoragePath(), FileAccess.Write, FileMode.Create))
                     stream.WriteByte(0);
 
-                var importedSecondTime = await LoadOszIntoStore(importer, realmFactory.Context);
+                var importedSecondTime = await LoadOszIntoStore(importer, realm.Realm);
 
                 using (var stream = storage.GetStream(firstFile.File.GetStoragePath()))
                     Assert.AreEqual(stream.Length, originalLength, "Corruption was not fixed on second import");
@@ -485,18 +485,18 @@ namespace osu.Game.Tests.Database
                 Assert.IsTrue(imported.ID == importedSecondTime.ID);
                 Assert.IsTrue(imported.Beatmaps.First().ID == importedSecondTime.Beatmaps.First().ID);
 
-                checkBeatmapSetCount(realmFactory.Context, 1);
-                checkSingleReferencedFileCount(realmFactory.Context, 18);
+                checkBeatmapSetCount(realm.Realm, 1);
+                checkSingleReferencedFileCount(realm.Realm, 18);
             });
         }
 
         [Test]
         public void TestModelCreationFailureDoesntReturn()
         {
-            RunTestWithRealmAsync(async (realmFactory, storage) =>
+            RunTestWithRealmAsync(async (realm, storage) =>
             {
-                using var importer = new BeatmapModelManager(realmFactory, storage);
-                using var store = new RulesetStore(realmFactory, storage);
+                using var importer = new BeatmapModelManager(realm, storage);
+                using var store = new RulesetStore(realm, storage);
 
                 var progressNotification = new ImportProgressNotification();
 
@@ -510,8 +510,8 @@ namespace osu.Game.Tests.Database
                     new ImportTask(zipStream, string.Empty)
                 );
 
-                checkBeatmapSetCount(realmFactory.Context, 0);
-                checkBeatmapCount(realmFactory.Context, 0);
+                checkBeatmapSetCount(realm.Realm, 0);
+                checkBeatmapCount(realm.Realm, 0);
 
                 Assert.IsEmpty(imported);
                 Assert.AreEqual(ProgressNotificationState.Cancelled, progressNotification.State);
@@ -521,7 +521,7 @@ namespace osu.Game.Tests.Database
         [Test]
         public void TestRollbackOnFailure()
         {
-            RunTestWithRealmAsync(async (realmFactory, storage) =>
+            RunTestWithRealmAsync(async (realm, storage) =>
             {
                 int loggedExceptionCount = 0;
 
@@ -531,16 +531,16 @@ namespace osu.Game.Tests.Database
                         Interlocked.Increment(ref loggedExceptionCount);
                 };
 
-                using var importer = new BeatmapModelManager(realmFactory, storage);
-                using var store = new RulesetStore(realmFactory, storage);
+                using var importer = new BeatmapModelManager(realm, storage);
+                using var store = new RulesetStore(realm, storage);
 
-                var imported = await LoadOszIntoStore(importer, realmFactory.Context);
+                var imported = await LoadOszIntoStore(importer, realm.Realm);
 
-                realmFactory.Context.Write(() => imported.Hash += "-changed");
+                realm.Realm.Write(() => imported.Hash += "-changed");
 
-                checkBeatmapSetCount(realmFactory.Context, 1);
-                checkBeatmapCount(realmFactory.Context, 12);
-                checkSingleReferencedFileCount(realmFactory.Context, 18);
+                checkBeatmapSetCount(realm.Realm, 1);
+                checkBeatmapCount(realm.Realm, 12);
+                checkSingleReferencedFileCount(realm.Realm, 18);
 
                 string? brokenTempFilename = TestResources.GetTestBeatmapForImport();
 
@@ -565,10 +565,10 @@ namespace osu.Game.Tests.Database
                 {
                 }
 
-                checkBeatmapSetCount(realmFactory.Context, 1);
-                checkBeatmapCount(realmFactory.Context, 12);
+                checkBeatmapSetCount(realm.Realm, 1);
+                checkBeatmapCount(realm.Realm, 12);
 
-                checkSingleReferencedFileCount(realmFactory.Context, 18);
+                checkSingleReferencedFileCount(realm.Realm, 18);
 
                 Assert.AreEqual(1, loggedExceptionCount);
 
@@ -579,18 +579,18 @@ namespace osu.Game.Tests.Database
         [Test]
         public void TestImportThenDeleteThenImportOptimisedPath()
         {
-            RunTestWithRealmAsync(async (realmFactory, storage) =>
+            RunTestWithRealmAsync(async (realm, storage) =>
             {
-                using var importer = new BeatmapModelManager(realmFactory, storage);
-                using var store = new RulesetStore(realmFactory, storage);
+                using var importer = new BeatmapModelManager(realm, storage);
+                using var store = new RulesetStore(realm, storage);
 
-                var imported = await LoadOszIntoStore(importer, realmFactory.Context);
+                var imported = await LoadOszIntoStore(importer, realm.Realm);
 
-                deleteBeatmapSet(imported, realmFactory.Context);
+                deleteBeatmapSet(imported, realm.Realm);
 
                 Assert.IsTrue(imported.DeletePending);
 
-                var importedSecondTime = await LoadOszIntoStore(importer, realmFactory.Context);
+                var importedSecondTime = await LoadOszIntoStore(importer, realm.Realm);
 
                 // check the newly "imported" beatmap is actually just the restored previous import. since it matches hash.
                 Assert.IsTrue(imported.ID == importedSecondTime.ID);
@@ -603,18 +603,18 @@ namespace osu.Game.Tests.Database
         [Test]
         public void TestImportThenDeleteThenImportNonOptimisedPath()
         {
-            RunTestWithRealmAsync(async (realmFactory, storage) =>
+            RunTestWithRealmAsync(async (realm, storage) =>
             {
-                using var importer = new NonOptimisedBeatmapImporter(realmFactory, storage);
-                using var store = new RulesetStore(realmFactory, storage);
+                using var importer = new NonOptimisedBeatmapImporter(realm, storage);
+                using var store = new RulesetStore(realm, storage);
 
-                var imported = await LoadOszIntoStore(importer, realmFactory.Context);
+                var imported = await LoadOszIntoStore(importer, realm.Realm);
 
-                deleteBeatmapSet(imported, realmFactory.Context);
+                deleteBeatmapSet(imported, realm.Realm);
 
                 Assert.IsTrue(imported.DeletePending);
 
-                var importedSecondTime = await LoadOszIntoStore(importer, realmFactory.Context);
+                var importedSecondTime = await LoadOszIntoStore(importer, realm.Realm);
 
                 // check the newly "imported" beatmap is actually just the restored previous import. since it matches hash.
                 Assert.IsTrue(imported.ID == importedSecondTime.ID);
@@ -627,22 +627,22 @@ namespace osu.Game.Tests.Database
         [Test]
         public void TestImportThenDeleteThenImportWithOnlineIDsMissing()
         {
-            RunTestWithRealmAsync(async (realmFactory, storage) =>
+            RunTestWithRealmAsync(async (realm, storage) =>
             {
-                using var importer = new BeatmapModelManager(realmFactory, storage);
-                using var store = new RulesetStore(realmFactory, storage);
+                using var importer = new BeatmapModelManager(realm, storage);
+                using var store = new RulesetStore(realm, storage);
 
-                var imported = await LoadOszIntoStore(importer, realmFactory.Context);
+                var imported = await LoadOszIntoStore(importer, realm.Realm);
 
-                realmFactory.Context.Write(() =>
+                realm.Realm.Write(() =>
                 {
                     foreach (var b in imported.Beatmaps)
                         b.OnlineID = -1;
                 });
 
-                deleteBeatmapSet(imported, realmFactory.Context);
+                deleteBeatmapSet(imported, realm.Realm);
 
-                var importedSecondTime = await LoadOszIntoStore(importer, realmFactory.Context);
+                var importedSecondTime = await LoadOszIntoStore(importer, realm.Realm);
 
                 // check the newly "imported" beatmap has been reimported due to mismatch (even though hashes matched)
                 Assert.IsTrue(imported.ID != importedSecondTime.ID);
@@ -653,10 +653,10 @@ namespace osu.Game.Tests.Database
         [Test]
         public void TestImportWithDuplicateBeatmapIDs()
         {
-            RunTestWithRealmAsync(async (realmFactory, storage) =>
+            RunTestWithRealmAsync(async (realm, storage) =>
             {
-                using var importer = new BeatmapModelManager(realmFactory, storage);
-                using var store = new RulesetStore(realmFactory, storage);
+                using var importer = new BeatmapModelManager(realm, storage);
+                using var store = new RulesetStore(realm, storage);
 
                 var metadata = new BeatmapMetadata
                 {
@@ -667,7 +667,7 @@ namespace osu.Game.Tests.Database
                     }
                 };
 
-                var ruleset = realmFactory.Context.All<RulesetInfo>().First();
+                var ruleset = realm.Realm.All<RulesetInfo>().First();
 
                 var toImport = new BeatmapSetInfo
                 {
@@ -699,15 +699,15 @@ namespace osu.Game.Tests.Database
         [Test]
         public void TestImportWhenFileOpen()
         {
-            RunTestWithRealmAsync(async (realmFactory, storage) =>
+            RunTestWithRealmAsync(async (realm, storage) =>
             {
-                using var importer = new BeatmapModelManager(realmFactory, storage);
-                using var store = new RulesetStore(realmFactory, storage);
+                using var importer = new BeatmapModelManager(realm, storage);
+                using var store = new RulesetStore(realm, storage);
 
                 string? temp = TestResources.GetTestBeatmapForImport();
                 using (File.OpenRead(temp))
                     await importer.Import(temp);
-                EnsureLoaded(realmFactory.Context);
+                EnsureLoaded(realm.Realm);
                 File.Delete(temp);
                 Assert.IsFalse(File.Exists(temp), "We likely held a read lock on the file when we shouldn't");
             });
@@ -716,10 +716,10 @@ namespace osu.Game.Tests.Database
         [Test]
         public void TestImportWithDuplicateHashes()
         {
-            RunTestWithRealmAsync(async (realmFactory, storage) =>
+            RunTestWithRealmAsync(async (realm, storage) =>
             {
-                using var importer = new BeatmapModelManager(realmFactory, storage);
-                using var store = new RulesetStore(realmFactory, storage);
+                using var importer = new BeatmapModelManager(realm, storage);
+                using var store = new RulesetStore(realm, storage);
 
                 string? temp = TestResources.GetTestBeatmapForImport();
 
@@ -740,7 +740,7 @@ namespace osu.Game.Tests.Database
 
                     await importer.Import(temp);
 
-                    EnsureLoaded(realmFactory.Context);
+                    EnsureLoaded(realm.Realm);
                 }
                 finally
                 {
@@ -752,10 +752,10 @@ namespace osu.Game.Tests.Database
         [Test]
         public void TestImportNestedStructure()
         {
-            RunTestWithRealmAsync(async (realmFactory, storage) =>
+            RunTestWithRealmAsync(async (realm, storage) =>
             {
-                using var importer = new BeatmapModelManager(realmFactory, storage);
-                using var store = new RulesetStore(realmFactory, storage);
+                using var importer = new BeatmapModelManager(realm, storage);
+                using var store = new RulesetStore(realm, storage);
 
                 string? temp = TestResources.GetTestBeatmapForImport();
 
@@ -780,7 +780,7 @@ namespace osu.Game.Tests.Database
                     Assert.NotNull(imported);
                     Debug.Assert(imported != null);
 
-                    EnsureLoaded(realmFactory.Context);
+                    EnsureLoaded(realm.Realm);
 
                     Assert.IsFalse(imported.PerformRead(s => s.Files.Any(f => f.Filename.Contains("subfolder"))), "Files contain common subfolder");
                 }
@@ -794,10 +794,10 @@ namespace osu.Game.Tests.Database
         [Test]
         public void TestImportWithIgnoredDirectoryInArchive()
         {
-            RunTestWithRealmAsync(async (realmFactory, storage) =>
+            RunTestWithRealmAsync(async (realm, storage) =>
             {
-                using var importer = new BeatmapModelManager(realmFactory, storage);
-                using var store = new RulesetStore(realmFactory, storage);
+                using var importer = new BeatmapModelManager(realm, storage);
+                using var store = new RulesetStore(realm, storage);
 
                 string? temp = TestResources.GetTestBeatmapForImport();
 
@@ -830,7 +830,7 @@ namespace osu.Game.Tests.Database
                     Assert.NotNull(imported);
                     Debug.Assert(imported != null);
 
-                    EnsureLoaded(realmFactory.Context);
+                    EnsureLoaded(realm.Realm);
 
                     Assert.IsFalse(imported.PerformRead(s => s.Files.Any(f => f.Filename.Contains("__MACOSX"))), "Files contain resource fork folder, which should be ignored");
                     Assert.IsFalse(imported.PerformRead(s => s.Files.Any(f => f.Filename.Contains("actual_data"))), "Files contain common subfolder");
@@ -845,22 +845,22 @@ namespace osu.Game.Tests.Database
         [Test]
         public void TestUpdateBeatmapInfo()
         {
-            RunTestWithRealmAsync(async (realmFactory, storage) =>
+            RunTestWithRealmAsync(async (realm, storage) =>
             {
-                using var importer = new BeatmapModelManager(realmFactory, storage);
-                using var store = new RulesetStore(realmFactory, storage);
+                using var importer = new BeatmapModelManager(realm, storage);
+                using var store = new RulesetStore(realm, storage);
 
                 string? temp = TestResources.GetTestBeatmapForImport();
                 await importer.Import(temp);
 
                 // Update via the beatmap, not the beatmap info, to ensure correct linking
-                BeatmapSetInfo setToUpdate = realmFactory.Context.All<BeatmapSetInfo>().First();
+                BeatmapSetInfo setToUpdate = realm.Realm.All<BeatmapSetInfo>().First();
 
                 var beatmapToUpdate = setToUpdate.Beatmaps.First();
 
-                realmFactory.Context.Write(() => beatmapToUpdate.DifficultyName = "updated");
+                realm.Realm.Write(() => beatmapToUpdate.DifficultyName = "updated");
 
-                BeatmapInfo updatedInfo = realmFactory.Context.All<BeatmapInfo>().First(b => b.ID == beatmapToUpdate.ID);
+                BeatmapInfo updatedInfo = realm.Realm.All<BeatmapInfo>().First(b => b.ID == beatmapToUpdate.ID);
                 Assert.That(updatedInfo.DifficultyName, Is.EqualTo("updated"));
             });
         }
@@ -1004,8 +1004,8 @@ namespace osu.Game.Tests.Database
 
         public class NonOptimisedBeatmapImporter : BeatmapImporter
         {
-            public NonOptimisedBeatmapImporter(RealmContextFactory realmFactory, Storage storage)
-                : base(realmFactory, storage)
+            public NonOptimisedBeatmapImporter(RealmAccess realm, Storage storage)
+                : base(realm, storage)
             {
             }
 
diff --git a/osu.Game.Tests/Database/FileStoreTests.cs b/osu.Game.Tests/Database/FileStoreTests.cs
index 3cb4705381..008aa3d833 100644
--- a/osu.Game.Tests/Database/FileStoreTests.cs
+++ b/osu.Game.Tests/Database/FileStoreTests.cs
@@ -19,10 +19,10 @@ namespace osu.Game.Tests.Database
         [Test]
         public void TestImportFile()
         {
-            RunTestWithRealm((realmFactory, storage) =>
+            RunTestWithRealm((realmAccess, storage) =>
             {
-                var realm = realmFactory.Context;
-                var files = new RealmFileStore(realmFactory, storage);
+                var realm = realmAccess.Context;
+                var files = new RealmFileStore(realmAccess, storage);
 
                 var testData = new MemoryStream(new byte[] { 0, 1, 2, 3 });
 
@@ -36,10 +36,10 @@ namespace osu.Game.Tests.Database
         [Test]
         public void TestImportSameFileTwice()
         {
-            RunTestWithRealm((realmFactory, storage) =>
+            RunTestWithRealm((realmAccess, storage) =>
             {
-                var realm = realmFactory.Context;
-                var files = new RealmFileStore(realmFactory, storage);
+                var realm = realmAccess.Context;
+                var files = new RealmFileStore(realmAccess, storage);
 
                 var testData = new MemoryStream(new byte[] { 0, 1, 2, 3 });
 
@@ -53,10 +53,10 @@ namespace osu.Game.Tests.Database
         [Test]
         public void TestDontPurgeReferenced()
         {
-            RunTestWithRealm((realmFactory, storage) =>
+            RunTestWithRealm((realmAccess, storage) =>
             {
-                var realm = realmFactory.Context;
-                var files = new RealmFileStore(realmFactory, storage);
+                var realm = realmAccess.Context;
+                var files = new RealmFileStore(realmAccess, storage);
 
                 var file = realm.Write(() => files.Add(new MemoryStream(new byte[] { 0, 1, 2, 3 }), realm));
 
@@ -92,10 +92,10 @@ namespace osu.Game.Tests.Database
         [Test]
         public void TestPurgeUnreferenced()
         {
-            RunTestWithRealm((realmFactory, storage) =>
+            RunTestWithRealm((realmAccess, storage) =>
             {
-                var realm = realmFactory.Context;
-                var files = new RealmFileStore(realmFactory, storage);
+                var realm = realmAccess.Context;
+                var files = new RealmFileStore(realmAccess, storage);
 
                 var file = realm.Write(() => files.Add(new MemoryStream(new byte[] { 0, 1, 2, 3 }), realm));
 
diff --git a/osu.Game.Tests/Database/GeneralUsageTests.cs b/osu.Game.Tests/Database/GeneralUsageTests.cs
index 3c62153d9e..2533c832e6 100644
--- a/osu.Game.Tests/Database/GeneralUsageTests.cs
+++ b/osu.Game.Tests/Database/GeneralUsageTests.cs
@@ -21,15 +21,15 @@ namespace osu.Game.Tests.Database
         [Test]
         public void TestConstructRealm()
         {
-            RunTestWithRealm((realmFactory, _) => { realmFactory.Run(realm => realm.Refresh()); });
+            RunTestWithRealm((realm, _) => { realm.Run(r => r.Refresh()); });
         }
 
         [Test]
         public void TestBlockOperations()
         {
-            RunTestWithRealm((realmFactory, _) =>
+            RunTestWithRealm((realm, _) =>
             {
-                using (realmFactory.BlockAllOperations())
+                using (realm.BlockAllOperations())
                 {
                 }
             });
@@ -42,22 +42,22 @@ namespace osu.Game.Tests.Database
         [Test]
         public void TestNestedContextCreationWithSubscription()
         {
-            RunTestWithRealm((realmFactory, _) =>
+            RunTestWithRealm((realm, _) =>
             {
                 bool callbackRan = false;
 
-                realmFactory.RegisterCustomSubscription(realm =>
+                realm.RegisterCustomSubscription(r =>
                 {
-                    var subscription = realm.All<BeatmapInfo>().QueryAsyncWithNotifications((sender, changes, error) =>
+                    var subscription = r.All<BeatmapInfo>().QueryAsyncWithNotifications((sender, changes, error) =>
                     {
-                        realmFactory.Run(_ =>
+                        realm.Run(_ =>
                         {
                             callbackRan = true;
                         });
                     });
 
                     // Force the callback above to run.
-                    realmFactory.Run(r => r.Refresh());
+                    realm.Run(rr => rr.Refresh());
 
                     subscription?.Dispose();
                     return null;
@@ -70,14 +70,14 @@ namespace osu.Game.Tests.Database
         [Test]
         public void TestBlockOperationsWithContention()
         {
-            RunTestWithRealm((realmFactory, _) =>
+            RunTestWithRealm((realm, _) =>
             {
                 ManualResetEventSlim stopThreadedUsage = new ManualResetEventSlim();
                 ManualResetEventSlim hasThreadedUsage = new ManualResetEventSlim();
 
                 Task.Factory.StartNew(() =>
                 {
-                    realmFactory.Run(_ =>
+                    realm.Run(_ =>
                     {
                         hasThreadedUsage.Set();
 
@@ -89,7 +89,7 @@ namespace osu.Game.Tests.Database
 
                 Assert.Throws<TimeoutException>(() =>
                 {
-                    using (realmFactory.BlockAllOperations())
+                    using (realm.BlockAllOperations())
                     {
                     }
                 });
diff --git a/osu.Game.Tests/Database/RealmLiveTests.cs b/osu.Game.Tests/Database/RealmLiveTests.cs
index d53fcb9ac7..2e3f708f79 100644
--- a/osu.Game.Tests/Database/RealmLiveTests.cs
+++ b/osu.Game.Tests/Database/RealmLiveTests.cs
@@ -21,11 +21,11 @@ namespace osu.Game.Tests.Database
         [Test]
         public void TestLiveEquality()
         {
-            RunTestWithRealm((realmFactory, _) =>
+            RunTestWithRealm((realm, _) =>
             {
-                ILive<BeatmapInfo> beatmap = realmFactory.Run(realm => realm.Write(r => r.Add(new BeatmapInfo(CreateRuleset(), new BeatmapDifficulty(), new BeatmapMetadata()))).ToLive(realmFactory));
+                ILive<BeatmapInfo> beatmap = realm.Run(r => r.Write(_ => r.Add(new BeatmapInfo(CreateRuleset(), new BeatmapDifficulty(), new BeatmapMetadata()))).ToLive(realm));
 
-                ILive<BeatmapInfo> beatmap2 = realmFactory.Run(realm => realm.All<BeatmapInfo>().First().ToLive(realmFactory));
+                ILive<BeatmapInfo> beatmap2 = realm.Run(r => r.All<BeatmapInfo>().First().ToLive(realm));
 
                 Assert.AreEqual(beatmap, beatmap2);
             });
@@ -34,20 +34,20 @@ namespace osu.Game.Tests.Database
         [Test]
         public void TestAccessAfterStorageMigrate()
         {
-            RunTestWithRealm((realmFactory, storage) =>
+            RunTestWithRealm((realm, storage) =>
             {
                 var beatmap = new BeatmapInfo(CreateRuleset(), new BeatmapDifficulty(), new BeatmapMetadata());
 
                 ILive<BeatmapInfo>? liveBeatmap = null;
 
-                realmFactory.Run(realm =>
+                realm.Run(r =>
                 {
-                    realm.Write(r => r.Add(beatmap));
+                    r.Write(_ => r.Add(beatmap));
 
-                    liveBeatmap = beatmap.ToLive(realmFactory);
+                    liveBeatmap = beatmap.ToLive(realm);
                 });
 
-                using (realmFactory.BlockAllOperations())
+                using (realm.BlockAllOperations())
                 {
                     // recycle realm before migrating
                 }
@@ -66,13 +66,13 @@ namespace osu.Game.Tests.Database
         [Test]
         public void TestAccessAfterAttach()
         {
-            RunTestWithRealm((realmFactory, _) =>
+            RunTestWithRealm((realm, _) =>
             {
                 var beatmap = new BeatmapInfo(CreateRuleset(), new BeatmapDifficulty(), new BeatmapMetadata());
 
-                var liveBeatmap = beatmap.ToLive(realmFactory);
+                var liveBeatmap = beatmap.ToLive(realm);
 
-                realmFactory.Run(realm => realm.Write(r => r.Add(beatmap)));
+                realm.Run(r => r.Write(_ => r.Add(beatmap)));
 
                 Assert.IsFalse(liveBeatmap.PerformRead(l => l.Hidden));
             });
@@ -98,16 +98,16 @@ namespace osu.Game.Tests.Database
         [Test]
         public void TestScopedReadWithoutContext()
         {
-            RunTestWithRealm((realmFactory, _) =>
+            RunTestWithRealm((realm, _) =>
             {
                 ILive<BeatmapInfo>? liveBeatmap = null;
                 Task.Factory.StartNew(() =>
                 {
-                    realmFactory.Run(threadContext =>
+                    realm.Run(threadContext =>
                     {
                         var beatmap = threadContext.Write(r => r.Add(new BeatmapInfo(CreateRuleset(), new BeatmapDifficulty(), new BeatmapMetadata())));
 
-                        liveBeatmap = beatmap.ToLive(realmFactory);
+                        liveBeatmap = beatmap.ToLive(realm);
                     });
                 }, TaskCreationOptions.LongRunning | TaskCreationOptions.HideScheduler).WaitSafely();
 
@@ -127,16 +127,16 @@ namespace osu.Game.Tests.Database
         [Test]
         public void TestScopedWriteWithoutContext()
         {
-            RunTestWithRealm((realmFactory, _) =>
+            RunTestWithRealm((realm, _) =>
             {
                 ILive<BeatmapInfo>? liveBeatmap = null;
                 Task.Factory.StartNew(() =>
                 {
-                    realmFactory.Run(threadContext =>
+                    realm.Run(threadContext =>
                     {
                         var beatmap = threadContext.Write(r => r.Add(new BeatmapInfo(CreateRuleset(), new BeatmapDifficulty(), new BeatmapMetadata())));
 
-                        liveBeatmap = beatmap.ToLive(realmFactory);
+                        liveBeatmap = beatmap.ToLive(realm);
                     });
                 }, TaskCreationOptions.LongRunning | TaskCreationOptions.HideScheduler).WaitSafely();
 
@@ -153,10 +153,10 @@ namespace osu.Game.Tests.Database
         [Test]
         public void TestValueAccessNonManaged()
         {
-            RunTestWithRealm((realmFactory, _) =>
+            RunTestWithRealm((realm, _) =>
             {
                 var beatmap = new BeatmapInfo(CreateRuleset(), new BeatmapDifficulty(), new BeatmapMetadata());
-                var liveBeatmap = beatmap.ToLive(realmFactory);
+                var liveBeatmap = beatmap.ToLive(realm);
 
                 Assert.DoesNotThrow(() =>
                 {
@@ -168,17 +168,17 @@ namespace osu.Game.Tests.Database
         [Test]
         public void TestValueAccessWithOpenContextFails()
         {
-            RunTestWithRealm((realmFactory, _) =>
+            RunTestWithRealm((realm, _) =>
             {
                 ILive<BeatmapInfo>? liveBeatmap = null;
 
                 Task.Factory.StartNew(() =>
                 {
-                    realmFactory.Run(threadContext =>
+                    realm.Run(threadContext =>
                     {
                         var beatmap = threadContext.Write(r => r.Add(new BeatmapInfo(CreateRuleset(), new BeatmapDifficulty(), new BeatmapMetadata())));
 
-                        liveBeatmap = beatmap.ToLive(realmFactory);
+                        liveBeatmap = beatmap.ToLive(realm);
                     });
                 }, TaskCreationOptions.LongRunning | TaskCreationOptions.HideScheduler).WaitSafely();
 
@@ -193,7 +193,7 @@ namespace osu.Game.Tests.Database
                     });
 
                     // Can't be used, even from within a valid context.
-                    realmFactory.Run(threadContext =>
+                    realm.Run(threadContext =>
                     {
                         Assert.Throws<InvalidOperationException>(() =>
                         {
@@ -207,16 +207,16 @@ namespace osu.Game.Tests.Database
         [Test]
         public void TestValueAccessWithoutOpenContextFails()
         {
-            RunTestWithRealm((realmFactory, _) =>
+            RunTestWithRealm((realm, _) =>
             {
                 ILive<BeatmapInfo>? liveBeatmap = null;
                 Task.Factory.StartNew(() =>
                 {
-                    realmFactory.Run(threadContext =>
+                    realm.Run(threadContext =>
                     {
                         var beatmap = threadContext.Write(r => r.Add(new BeatmapInfo(CreateRuleset(), new BeatmapDifficulty(), new BeatmapMetadata())));
 
-                        liveBeatmap = beatmap.ToLive(realmFactory);
+                        liveBeatmap = beatmap.ToLive(realm);
                     });
                 }, TaskCreationOptions.LongRunning | TaskCreationOptions.HideScheduler).WaitSafely();
 
@@ -235,18 +235,18 @@ namespace osu.Game.Tests.Database
         [Test]
         public void TestLiveAssumptions()
         {
-            RunTestWithRealm((realmFactory, _) =>
+            RunTestWithRealm((realm, _) =>
             {
                 int changesTriggered = 0;
 
-                realmFactory.RegisterCustomSubscription(outerRealm =>
+                realm.RegisterCustomSubscription(outerRealm =>
                 {
                     outerRealm.All<BeatmapInfo>().QueryAsyncWithNotifications(gotChange);
                     ILive<BeatmapInfo>? liveBeatmap = null;
 
                     Task.Factory.StartNew(() =>
                     {
-                        realmFactory.Run(innerRealm =>
+                        realm.Run(innerRealm =>
                         {
                             var ruleset = CreateRuleset();
                             var beatmap = innerRealm.Write(r => r.Add(new BeatmapInfo(ruleset, new BeatmapDifficulty(), new BeatmapMetadata())));
@@ -255,7 +255,7 @@ namespace osu.Game.Tests.Database
                             // not just a refresh from the resolved Live.
                             innerRealm.Write(r => r.Add(new BeatmapInfo(ruleset, new BeatmapDifficulty(), new BeatmapMetadata())));
 
-                            liveBeatmap = beatmap.ToLive(realmFactory);
+                            liveBeatmap = beatmap.ToLive(realm);
                         });
                     }, TaskCreationOptions.LongRunning | TaskCreationOptions.HideScheduler).WaitSafely();
 
diff --git a/osu.Game.Tests/Database/RealmSubscriptionRegistrationTests.cs b/osu.Game.Tests/Database/RealmSubscriptionRegistrationTests.cs
index 1799b95905..d62ce3b585 100644
--- a/osu.Game.Tests/Database/RealmSubscriptionRegistrationTests.cs
+++ b/osu.Game.Tests/Database/RealmSubscriptionRegistrationTests.cs
@@ -24,11 +24,11 @@ namespace osu.Game.Tests.Database
             IEnumerable<BeatmapSetInfo>? resolvedItems = null;
             ChangeSet? lastChanges = null;
 
-            RunTestWithRealm((realmFactory, _) =>
+            RunTestWithRealm((realm, _) =>
             {
-                realmFactory.Write(realm => realm.Add(TestResources.CreateTestBeatmapSetInfo()));
+                realm.Write(r => r.Add(TestResources.CreateTestBeatmapSetInfo()));
 
-                var registration = realmFactory.RegisterForNotifications(realm => realm.All<BeatmapSetInfo>(), onChanged);
+                var registration = realm.RegisterForNotifications(r => r.All<BeatmapSetInfo>(), onChanged);
 
                 testEventsArriving(true);
 
@@ -37,10 +37,10 @@ namespace osu.Game.Tests.Database
                 resolvedItems = null;
                 lastChanges = null;
 
-                using (realmFactory.BlockAllOperations())
+                using (realm.BlockAllOperations())
                     Assert.That(resolvedItems, Is.Empty);
 
-                realmFactory.Write(realm => realm.Add(TestResources.CreateTestBeatmapSetInfo()));
+                realm.Write(r => r.Add(TestResources.CreateTestBeatmapSetInfo()));
 
                 testEventsArriving(true);
 
@@ -50,34 +50,34 @@ namespace osu.Game.Tests.Database
 
                 registration.Dispose();
 
-                realmFactory.Write(realm => realm.Add(TestResources.CreateTestBeatmapSetInfo()));
+                realm.Write(r => r.Add(TestResources.CreateTestBeatmapSetInfo()));
 
                 testEventsArriving(false);
 
                 // And make sure even after another context loss we don't get firings.
-                using (realmFactory.BlockAllOperations())
+                using (realm.BlockAllOperations())
                     Assert.That(resolvedItems, Is.Null);
 
-                realmFactory.Write(realm => realm.Add(TestResources.CreateTestBeatmapSetInfo()));
+                realm.Write(r => r.Add(TestResources.CreateTestBeatmapSetInfo()));
 
                 testEventsArriving(false);
 
                 void testEventsArriving(bool shouldArrive)
                 {
-                    realmFactory.Run(realm => realm.Refresh());
+                    realm.Run(r => r.Refresh());
 
                     if (shouldArrive)
                         Assert.That(resolvedItems, Has.One.Items);
                     else
                         Assert.That(resolvedItems, Is.Null);
 
-                    realmFactory.Write(realm =>
+                    realm.Write(r =>
                     {
-                        realm.RemoveAll<BeatmapSetInfo>();
-                        realm.RemoveAll<RulesetInfo>();
+                        r.RemoveAll<BeatmapSetInfo>();
+                        r.RemoveAll<RulesetInfo>();
                     });
 
-                    realmFactory.Run(realm => realm.Refresh());
+                    realm.Run(r => r.Refresh());
 
                     if (shouldArrive)
                         Assert.That(lastChanges?.DeletedIndices, Has.One.Items);
@@ -98,39 +98,39 @@ namespace osu.Game.Tests.Database
         [Test]
         public void TestCustomRegisterWithContextLoss()
         {
-            RunTestWithRealm((realmFactory, _) =>
+            RunTestWithRealm((realm, _) =>
             {
                 BeatmapSetInfo? beatmapSetInfo = null;
 
-                realmFactory.Write(realm => realm.Add(TestResources.CreateTestBeatmapSetInfo()));
+                realm.Write(r => r.Add(TestResources.CreateTestBeatmapSetInfo()));
 
-                var subscription = realmFactory.RegisterCustomSubscription(realm =>
+                var subscription = realm.RegisterCustomSubscription(r =>
                 {
-                    beatmapSetInfo = realm.All<BeatmapSetInfo>().First();
+                    beatmapSetInfo = r.All<BeatmapSetInfo>().First();
 
                     return new InvokeOnDisposal(() => beatmapSetInfo = null);
                 });
 
                 Assert.That(beatmapSetInfo, Is.Not.Null);
 
-                using (realmFactory.BlockAllOperations())
+                using (realm.BlockAllOperations())
                 {
                     // custom disposal action fired when context lost.
                     Assert.That(beatmapSetInfo, Is.Null);
                 }
 
                 // re-registration after context restore.
-                realmFactory.Run(realm => realm.Refresh());
+                realm.Run(r => r.Refresh());
                 Assert.That(beatmapSetInfo, Is.Not.Null);
 
                 subscription.Dispose();
 
                 Assert.That(beatmapSetInfo, Is.Null);
 
-                using (realmFactory.BlockAllOperations())
+                using (realm.BlockAllOperations())
                     Assert.That(beatmapSetInfo, Is.Null);
 
-                realmFactory.Run(realm => realm.Refresh());
+                realm.Run(r => r.Refresh());
                 Assert.That(beatmapSetInfo, Is.Null);
             });
         }
diff --git a/osu.Game.Tests/Database/RealmTest.cs b/osu.Game.Tests/Database/RealmTest.cs
index 0cee165f75..c2339dd9ad 100644
--- a/osu.Game.Tests/Database/RealmTest.cs
+++ b/osu.Game.Tests/Database/RealmTest.cs
@@ -30,7 +30,7 @@ namespace osu.Game.Tests.Database
             storage.DeleteDirectory(string.Empty);
         }
 
-        protected void RunTestWithRealm(Action<RealmContextFactory, OsuStorage> testAction, [CallerMemberName] string caller = "")
+        protected void RunTestWithRealm(Action<RealmAccess, OsuStorage> testAction, [CallerMemberName] string caller = "")
         {
             using (HeadlessGameHost host = new CleanRunHeadlessGameHost(callingMethodName: caller))
             {
@@ -39,22 +39,22 @@ namespace osu.Game.Tests.Database
                     // ReSharper disable once AccessToDisposedClosure
                     var testStorage = new OsuStorage(host, storage.GetStorageForDirectory(caller));
 
-                    using (var realmFactory = new RealmContextFactory(testStorage, "client"))
+                    using (var realm = new RealmAccess(testStorage, "client"))
                     {
-                        Logger.Log($"Running test using realm file {testStorage.GetFullPath(realmFactory.Filename)}");
-                        testAction(realmFactory, testStorage);
+                        Logger.Log($"Running test using realm file {testStorage.GetFullPath(realm.Filename)}");
+                        testAction(realm, testStorage);
 
-                        realmFactory.Dispose();
+                        realm.Dispose();
 
-                        Logger.Log($"Final database size: {getFileSize(testStorage, realmFactory)}");
-                        realmFactory.Compact();
-                        Logger.Log($"Final database size after compact: {getFileSize(testStorage, realmFactory)}");
+                        Logger.Log($"Final database size: {getFileSize(testStorage, realm)}");
+                        realm.Compact();
+                        Logger.Log($"Final database size after compact: {getFileSize(testStorage, realm)}");
                     }
                 }));
             }
         }
 
-        protected void RunTestWithRealmAsync(Func<RealmContextFactory, Storage, Task> testAction, [CallerMemberName] string caller = "")
+        protected void RunTestWithRealmAsync(Func<RealmAccess, Storage, Task> testAction, [CallerMemberName] string caller = "")
         {
             using (HeadlessGameHost host = new CleanRunHeadlessGameHost(callingMethodName: caller))
             {
@@ -62,15 +62,15 @@ namespace osu.Game.Tests.Database
                 {
                     var testStorage = storage.GetStorageForDirectory(caller);
 
-                    using (var realmFactory = new RealmContextFactory(testStorage, "client"))
+                    using (var realm = new RealmAccess(testStorage, "client"))
                     {
-                        Logger.Log($"Running test using realm file {testStorage.GetFullPath(realmFactory.Filename)}");
-                        await testAction(realmFactory, testStorage);
+                        Logger.Log($"Running test using realm file {testStorage.GetFullPath(realm.Filename)}");
+                        await testAction(realm, testStorage);
 
-                        realmFactory.Dispose();
+                        realm.Dispose();
 
-                        Logger.Log($"Final database size: {getFileSize(testStorage, realmFactory)}");
-                        realmFactory.Compact();
+                        Logger.Log($"Final database size: {getFileSize(testStorage, realm)}");
+                        realm.Compact();
                     }
                 }));
             }
@@ -138,11 +138,11 @@ namespace osu.Game.Tests.Database
             }
         }
 
-        private static long getFileSize(Storage testStorage, RealmContextFactory realmFactory)
+        private static long getFileSize(Storage testStorage, RealmAccess realm)
         {
             try
             {
-                using (var stream = testStorage.GetStream(realmFactory.Filename))
+                using (var stream = testStorage.GetStream(realm.Filename))
                     return stream?.Length ?? 0;
             }
             catch
diff --git a/osu.Game.Tests/Database/RulesetStoreTests.cs b/osu.Game.Tests/Database/RulesetStoreTests.cs
index 4416da6f92..7544142b70 100644
--- a/osu.Game.Tests/Database/RulesetStoreTests.cs
+++ b/osu.Game.Tests/Database/RulesetStoreTests.cs
@@ -12,37 +12,37 @@ namespace osu.Game.Tests.Database
         [Test]
         public void TestCreateStore()
         {
-            RunTestWithRealm((realmFactory, storage) =>
+            RunTestWithRealm((realm, storage) =>
             {
-                var rulesets = new RulesetStore(realmFactory, storage);
+                var rulesets = new RulesetStore(realm, storage);
 
                 Assert.AreEqual(4, rulesets.AvailableRulesets.Count());
-                Assert.AreEqual(4, realmFactory.Context.All<RulesetInfo>().Count());
+                Assert.AreEqual(4, realm.Realm.All<RulesetInfo>().Count());
             });
         }
 
         [Test]
         public void TestCreateStoreTwiceDoesntAddRulesetsAgain()
         {
-            RunTestWithRealm((realmFactory, storage) =>
+            RunTestWithRealm((realm, storage) =>
             {
-                var rulesets = new RulesetStore(realmFactory, storage);
-                var rulesets2 = new RulesetStore(realmFactory, storage);
+                var rulesets = new RulesetStore(realm, storage);
+                var rulesets2 = new RulesetStore(realm, storage);
 
                 Assert.AreEqual(4, rulesets.AvailableRulesets.Count());
                 Assert.AreEqual(4, rulesets2.AvailableRulesets.Count());
 
                 Assert.AreEqual(rulesets.AvailableRulesets.First(), rulesets2.AvailableRulesets.First());
-                Assert.AreEqual(4, realmFactory.Context.All<RulesetInfo>().Count());
+                Assert.AreEqual(4, realm.Realm.All<RulesetInfo>().Count());
             });
         }
 
         [Test]
         public void TestRetrievedRulesetsAreDetached()
         {
-            RunTestWithRealm((realmFactory, storage) =>
+            RunTestWithRealm((realm, storage) =>
             {
-                var rulesets = new RulesetStore(realmFactory, storage);
+                var rulesets = new RulesetStore(realm, storage);
 
                 Assert.IsFalse(rulesets.AvailableRulesets.First().IsManaged);
                 Assert.IsFalse(rulesets.GetRuleset(0)?.IsManaged);
diff --git a/osu.Game.Tests/Database/TestRealmKeyBindingStore.cs b/osu.Game.Tests/Database/TestRealmKeyBindingStore.cs
index c1041e9fd6..4b8816f142 100644
--- a/osu.Game.Tests/Database/TestRealmKeyBindingStore.cs
+++ b/osu.Game.Tests/Database/TestRealmKeyBindingStore.cs
@@ -24,7 +24,7 @@ namespace osu.Game.Tests.Database
 
         private RealmKeyBindingStore keyBindingStore;
 
-        private RealmContextFactory realmContextFactory;
+        private RealmAccess realm;
 
         [SetUp]
         public void SetUp()
@@ -33,8 +33,8 @@ namespace osu.Game.Tests.Database
 
             storage = new NativeStorage(directory.FullName);
 
-            realmContextFactory = new RealmContextFactory(storage, "test");
-            keyBindingStore = new RealmKeyBindingStore(realmContextFactory, new ReadableKeyCombinationProvider());
+            realm = new RealmAccess(storage, "test");
+            keyBindingStore = new RealmKeyBindingStore(realm, new ReadableKeyCombinationProvider());
         }
 
         [Test]
@@ -60,7 +60,7 @@ namespace osu.Game.Tests.Database
             KeyBindingContainer testContainer = new TestKeyBindingContainer();
 
             // Add some excess bindings for an action which only supports 1.
-            realmContextFactory.Write(realm =>
+            realm.Write(realm =>
             {
                 realm.Add(new RealmKeyBinding(GlobalAction.Back, new KeyCombination(InputKey.A)));
                 realm.Add(new RealmKeyBinding(GlobalAction.Back, new KeyCombination(InputKey.S)));
@@ -76,7 +76,7 @@ namespace osu.Game.Tests.Database
 
         private int queryCount(GlobalAction? match = null)
         {
-            return realmContextFactory.Run(realm =>
+            return realm.Run(realm =>
             {
                 var results = realm.All<RealmKeyBinding>();
                 if (match.HasValue)
@@ -92,7 +92,7 @@ namespace osu.Game.Tests.Database
 
             keyBindingStore.Register(testContainer, Enumerable.Empty<RulesetInfo>());
 
-            realmContextFactory.Run(outerRealm =>
+            realm.Run(outerRealm =>
             {
                 var backBinding = outerRealm.All<RealmKeyBinding>().Single(k => k.ActionInt == (int)GlobalAction.Back);
 
@@ -100,7 +100,7 @@ namespace osu.Game.Tests.Database
 
                 var tsr = ThreadSafeReference.Create(backBinding);
 
-                realmContextFactory.Run(innerRealm =>
+                realm.Run(innerRealm =>
                 {
                     var binding = innerRealm.ResolveReference(tsr);
                     innerRealm.Write(() => binding.KeyCombination = new KeyCombination(InputKey.BackSpace));
@@ -117,7 +117,7 @@ namespace osu.Game.Tests.Database
         [TearDown]
         public void TearDown()
         {
-            realmContextFactory.Dispose();
+            realm.Dispose();
             storage.DeleteDirectory(string.Empty);
         }
 
diff --git a/osu.Game.Tests/Gameplay/TestSceneStoryboardSamples.cs b/osu.Game.Tests/Gameplay/TestSceneStoryboardSamples.cs
index f0ebd7a8cc..88862ea28b 100644
--- a/osu.Game.Tests/Gameplay/TestSceneStoryboardSamples.cs
+++ b/osu.Game.Tests/Gameplay/TestSceneStoryboardSamples.cs
@@ -261,7 +261,7 @@ namespace osu.Game.Tests.Gameplay
         public AudioManager AudioManager => Audio;
         public IResourceStore<byte[]> Files => null;
         public new IResourceStore<byte[]> Resources => base.Resources;
-        public RealmContextFactory RealmContextFactory => null;
+        public RealmAccess RealmAccess => null;
         public IResourceStore<TextureUpload> CreateTextureLoaderStore(IResourceStore<byte[]> underlyingStore) => null;
 
         #endregion
diff --git a/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs b/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
index 1d639c6418..e35e4d9b15 100644
--- a/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
+++ b/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
@@ -45,8 +45,8 @@ namespace osu.Game.Tests.Online
         [BackgroundDependencyLoader]
         private void load(AudioManager audio, GameHost host)
         {
-            Dependencies.Cache(rulesets = new RulesetStore(ContextFactory));
-            Dependencies.CacheAs<BeatmapManager>(beatmaps = new TestBeatmapManager(LocalStorage, ContextFactory, rulesets, API, audio, Resources, host, Beatmap.Default));
+            Dependencies.Cache(rulesets = new RulesetStore(Access));
+            Dependencies.CacheAs<BeatmapManager>(beatmaps = new TestBeatmapManager(LocalStorage, Access, rulesets, API, audio, Resources, host, Beatmap.Default));
             Dependencies.CacheAs<BeatmapModelDownloader>(beatmapDownloader = new TestBeatmapModelDownloader(beatmaps, API, host));
         }
 
@@ -60,8 +60,8 @@ namespace osu.Game.Tests.Online
             testBeatmapInfo = getTestBeatmapInfo(testBeatmapFile);
             testBeatmapSet = testBeatmapInfo.BeatmapSet;
 
-            ContextFactory.Write(r => r.RemoveAll<BeatmapSetInfo>());
-            ContextFactory.Write(r => r.RemoveAll<BeatmapInfo>());
+            Access.Write(r => r.RemoveAll<BeatmapSetInfo>());
+            Access.Write(r => r.RemoveAll<BeatmapInfo>());
 
             selectedItem.Value = new PlaylistItem
             {
@@ -166,22 +166,22 @@ namespace osu.Game.Tests.Online
 
             public Task<ILive<BeatmapSetInfo>> CurrentImportTask { get; private set; }
 
-            public TestBeatmapManager(Storage storage, RealmContextFactory contextFactory, RulesetStore rulesets, IAPIProvider api, [NotNull] AudioManager audioManager, IResourceStore<byte[]> resources, GameHost host = null, WorkingBeatmap defaultBeatmap = null)
-                : base(storage, contextFactory, rulesets, api, audioManager, resources, host, defaultBeatmap)
+            public TestBeatmapManager(Storage storage, RealmAccess realm, RulesetStore rulesets, IAPIProvider api, [NotNull] AudioManager audioManager, IResourceStore<byte[]> resources, GameHost host = null, WorkingBeatmap defaultBeatmap = null)
+                : base(storage, realm, rulesets, api, audioManager, resources, host, defaultBeatmap)
             {
             }
 
-            protected override BeatmapModelManager CreateBeatmapModelManager(Storage storage, RealmContextFactory contextFactory, RulesetStore rulesets, BeatmapOnlineLookupQueue onlineLookupQueue)
+            protected override BeatmapModelManager CreateBeatmapModelManager(Storage storage, RealmAccess realm, RulesetStore rulesets, BeatmapOnlineLookupQueue onlineLookupQueue)
             {
-                return new TestBeatmapModelManager(this, storage, contextFactory, rulesets, onlineLookupQueue);
+                return new TestBeatmapModelManager(this, storage, realm, rulesets, onlineLookupQueue);
             }
 
             internal class TestBeatmapModelManager : BeatmapModelManager
             {
                 private readonly TestBeatmapManager testBeatmapManager;
 
-                public TestBeatmapModelManager(TestBeatmapManager testBeatmapManager, Storage storage, RealmContextFactory databaseContextFactory, RulesetStore rulesetStore, BeatmapOnlineLookupQueue beatmapOnlineLookupQueue)
-                    : base(databaseContextFactory, storage, beatmapOnlineLookupQueue)
+                public TestBeatmapModelManager(TestBeatmapManager testBeatmapManager, Storage storage, RealmAccess databaseAccess, RulesetStore rulesetStore, BeatmapOnlineLookupQueue beatmapOnlineLookupQueue)
+                    : base(databaseAccess, storage, beatmapOnlineLookupQueue)
                 {
                     this.testBeatmapManager = testBeatmapManager;
                 }
diff --git a/osu.Game.Tests/Visual/Background/TestSceneUserDimBackgrounds.cs b/osu.Game.Tests/Visual/Background/TestSceneUserDimBackgrounds.cs
index 4ab4c08353..fbfa7eda6a 100644
--- a/osu.Game.Tests/Visual/Background/TestSceneUserDimBackgrounds.cs
+++ b/osu.Game.Tests/Visual/Background/TestSceneUserDimBackgrounds.cs
@@ -47,10 +47,10 @@ namespace osu.Game.Tests.Visual.Background
         [BackgroundDependencyLoader]
         private void load(GameHost host, AudioManager audio)
         {
-            Dependencies.Cache(rulesets = new RulesetStore(ContextFactory));
-            Dependencies.Cache(manager = new BeatmapManager(LocalStorage, ContextFactory, rulesets, null, audio, Resources, host, Beatmap.Default));
+            Dependencies.Cache(rulesets = new RulesetStore(Access));
+            Dependencies.Cache(manager = new BeatmapManager(LocalStorage, Access, rulesets, null, audio, Resources, host, Beatmap.Default));
             Dependencies.Cache(new OsuConfigManager(LocalStorage));
-            Dependencies.Cache(ContextFactory);
+            Dependencies.Cache(Access);
 
             manager.Import(TestResources.GetQuickTestBeatmapForImport()).WaitSafely();
 
diff --git a/osu.Game.Tests/Visual/Collections/TestSceneManageCollectionsDialog.cs b/osu.Game.Tests/Visual/Collections/TestSceneManageCollectionsDialog.cs
index 18572ac211..fd0645a1e9 100644
--- a/osu.Game.Tests/Visual/Collections/TestSceneManageCollectionsDialog.cs
+++ b/osu.Game.Tests/Visual/Collections/TestSceneManageCollectionsDialog.cs
@@ -36,9 +36,9 @@ namespace osu.Game.Tests.Visual.Collections
         [BackgroundDependencyLoader]
         private void load(GameHost host)
         {
-            Dependencies.Cache(rulesets = new RulesetStore(ContextFactory));
-            Dependencies.Cache(beatmapManager = new BeatmapManager(LocalStorage, ContextFactory, rulesets, null, Audio, Resources, host, Beatmap.Default));
-            Dependencies.Cache(ContextFactory);
+            Dependencies.Cache(rulesets = new RulesetStore(Access));
+            Dependencies.Cache(beatmapManager = new BeatmapManager(LocalStorage, Access, rulesets, null, Audio, Resources, host, Beatmap.Default));
+            Dependencies.Cache(Access);
 
             beatmapManager.Import(TestResources.GetQuickTestBeatmapForImport()).WaitSafely();
 
diff --git a/osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs b/osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs
index d4282ff21e..07b2bdcba3 100644
--- a/osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs
@@ -47,9 +47,9 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [BackgroundDependencyLoader]
         private void load(GameHost host, AudioManager audio)
         {
-            Dependencies.Cache(rulesets = new RulesetStore(ContextFactory));
-            Dependencies.Cache(beatmaps = new BeatmapManager(LocalStorage, ContextFactory, rulesets, null, audio, Resources, host, Beatmap.Default));
-            Dependencies.Cache(ContextFactory);
+            Dependencies.Cache(rulesets = new RulesetStore(Access));
+            Dependencies.Cache(beatmaps = new BeatmapManager(LocalStorage, Access, rulesets, null, audio, Resources, host, Beatmap.Default));
+            Dependencies.Cache(Access);
         }
 
         public override void SetUpSteps()
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
index 99c867b014..0bf1d60ac5 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
@@ -43,9 +43,9 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [BackgroundDependencyLoader]
         private void load(GameHost host, AudioManager audio)
         {
-            Dependencies.Cache(rulesets = new RulesetStore(ContextFactory));
-            Dependencies.Cache(manager = new BeatmapManager(LocalStorage, ContextFactory, rulesets, null, audio, Resources, host, Beatmap.Default));
-            Dependencies.Cache(ContextFactory);
+            Dependencies.Cache(rulesets = new RulesetStore(Access));
+            Dependencies.Cache(manager = new BeatmapManager(LocalStorage, Access, rulesets, null, audio, Resources, host, Beatmap.Default));
+            Dependencies.Cache(Access);
         }
 
         [Test]
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
index 373b165acc..063d886729 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
@@ -61,9 +61,9 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [BackgroundDependencyLoader]
         private void load(GameHost host, AudioManager audio)
         {
-            Dependencies.Cache(rulesets = new RulesetStore(ContextFactory));
-            Dependencies.Cache(beatmaps = new BeatmapManager(LocalStorage, ContextFactory, rulesets, API, audio, Resources, host, Beatmap.Default));
-            Dependencies.Cache(ContextFactory);
+            Dependencies.Cache(rulesets = new RulesetStore(Access));
+            Dependencies.Cache(beatmaps = new BeatmapManager(LocalStorage, Access, rulesets, API, audio, Resources, host, Beatmap.Default));
+            Dependencies.Cache(Access);
         }
 
         public override void SetUpSteps()
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs
index 15ebe0ee00..8c79c468d7 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs
@@ -42,9 +42,9 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [BackgroundDependencyLoader]
         private void load(GameHost host, AudioManager audio)
         {
-            Dependencies.Cache(rulesets = new RulesetStore(ContextFactory));
-            Dependencies.Cache(manager = new BeatmapManager(LocalStorage, ContextFactory, rulesets, null, audio, Resources, host, Beatmap.Default));
-            Dependencies.Cache(ContextFactory);
+            Dependencies.Cache(rulesets = new RulesetStore(Access));
+            Dependencies.Cache(manager = new BeatmapManager(LocalStorage, Access, rulesets, null, audio, Resources, host, Beatmap.Default));
+            Dependencies.Cache(Access);
 
             beatmaps = new List<BeatmapInfo>();
 
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs
index 012a2fd960..77e2c9c714 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs
@@ -38,9 +38,9 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [BackgroundDependencyLoader]
         private void load(GameHost host, AudioManager audio)
         {
-            Dependencies.Cache(rulesets = new RulesetStore(ContextFactory));
-            Dependencies.Cache(beatmaps = new BeatmapManager(LocalStorage, ContextFactory, rulesets, null, audio, Resources, host, Beatmap.Default));
-            Dependencies.Cache(ContextFactory);
+            Dependencies.Cache(rulesets = new RulesetStore(Access));
+            Dependencies.Cache(beatmaps = new BeatmapManager(LocalStorage, Access, rulesets, null, audio, Resources, host, Beatmap.Default));
+            Dependencies.Cache(Access);
 
             beatmaps.Import(TestResources.GetQuickTestBeatmapForImport()).WaitSafely();
 
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs
index d547b42891..4270818b1a 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs
@@ -33,9 +33,9 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [BackgroundDependencyLoader]
         private void load(GameHost host, AudioManager audio)
         {
-            Dependencies.Cache(rulesets = new RulesetStore(ContextFactory));
-            Dependencies.Cache(beatmaps = new BeatmapManager(LocalStorage, ContextFactory, rulesets, null, audio, Resources, host, Beatmap.Default));
-            Dependencies.Cache(ContextFactory);
+            Dependencies.Cache(rulesets = new RulesetStore(Access));
+            Dependencies.Cache(beatmaps = new BeatmapManager(LocalStorage, Access, rulesets, null, audio, Resources, host, Beatmap.Default));
+            Dependencies.Cache(Access);
         }
 
         [SetUp]
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs
index 965b142ed7..56e64292c6 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs
@@ -38,9 +38,9 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [BackgroundDependencyLoader]
         private void load(GameHost host, AudioManager audio)
         {
-            Dependencies.Cache(rulesets = new RulesetStore(ContextFactory));
-            Dependencies.Cache(beatmaps = new BeatmapManager(LocalStorage, ContextFactory, rulesets, API, audio, Resources, host, Beatmap.Default));
-            Dependencies.Cache(ContextFactory);
+            Dependencies.Cache(rulesets = new RulesetStore(Access));
+            Dependencies.Cache(beatmaps = new BeatmapManager(LocalStorage, Access, rulesets, API, audio, Resources, host, Beatmap.Default));
+            Dependencies.Cache(Access);
         }
 
         public override void SetUpSteps()
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs
index 1c346e09d5..afb60b62aa 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs
@@ -40,9 +40,9 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [BackgroundDependencyLoader]
         private void load(GameHost host, AudioManager audio)
         {
-            Dependencies.Cache(rulesets = new RulesetStore(ContextFactory));
-            Dependencies.Cache(beatmaps = new BeatmapManager(LocalStorage, ContextFactory, rulesets, null, audio, Resources, host, Beatmap.Default));
-            Dependencies.Cache(ContextFactory);
+            Dependencies.Cache(rulesets = new RulesetStore(Access));
+            Dependencies.Cache(beatmaps = new BeatmapManager(LocalStorage, Access, rulesets, null, audio, Resources, host, Beatmap.Default));
+            Dependencies.Cache(Access);
 
             beatmaps.Import(TestResources.GetQuickTestBeatmapForImport()).WaitSafely();
         }
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerSpectateButton.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerSpectateButton.cs
index 221732910b..79b29f0eca 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerSpectateButton.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerSpectateButton.cs
@@ -41,9 +41,9 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [BackgroundDependencyLoader]
         private void load(GameHost host, AudioManager audio)
         {
-            Dependencies.Cache(rulesets = new RulesetStore(ContextFactory));
-            Dependencies.Cache(beatmaps = new BeatmapManager(LocalStorage, ContextFactory, rulesets, null, audio, Resources, host, Beatmap.Default));
-            Dependencies.Cache(ContextFactory);
+            Dependencies.Cache(rulesets = new RulesetStore(Access));
+            Dependencies.Cache(beatmaps = new BeatmapManager(LocalStorage, Access, rulesets, null, audio, Resources, host, Beatmap.Default));
+            Dependencies.Cache(Access);
 
             beatmaps.Import(TestResources.GetQuickTestBeatmapForImport()).WaitSafely();
         }
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsSongSelect.cs b/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsSongSelect.cs
index 0b0006e437..6ed57e9899 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsSongSelect.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsSongSelect.cs
@@ -34,9 +34,9 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [BackgroundDependencyLoader]
         private void load(GameHost host, AudioManager audio)
         {
-            Dependencies.Cache(rulesets = new RulesetStore(ContextFactory));
-            Dependencies.Cache(manager = new BeatmapManager(LocalStorage, ContextFactory, rulesets, null, audio, Resources, host, Beatmap.Default));
-            Dependencies.Cache(ContextFactory);
+            Dependencies.Cache(rulesets = new RulesetStore(Access));
+            Dependencies.Cache(manager = new BeatmapManager(LocalStorage, Access, rulesets, null, audio, Resources, host, Beatmap.Default));
+            Dependencies.Cache(Access);
 
             var beatmapSet = TestResources.CreateTestBeatmapSetInfo();
 
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs
index 39cde0ad87..bd95b297d4 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs
@@ -42,9 +42,9 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [BackgroundDependencyLoader]
         private void load(GameHost host, AudioManager audio)
         {
-            Dependencies.Cache(rulesets = new RulesetStore(ContextFactory));
-            Dependencies.Cache(beatmaps = new BeatmapManager(LocalStorage, ContextFactory, rulesets, null, audio, Resources, host, Beatmap.Default));
-            Dependencies.Cache(ContextFactory);
+            Dependencies.Cache(rulesets = new RulesetStore(Access));
+            Dependencies.Cache(beatmaps = new BeatmapManager(LocalStorage, Access, rulesets, null, audio, Resources, host, Beatmap.Default));
+            Dependencies.Cache(Access);
         }
 
         public override void SetUpSteps()
diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneChangeAndUseGameplayBindings.cs b/osu.Game.Tests/Visual/Navigation/TestSceneChangeAndUseGameplayBindings.cs
index 0f314242b4..7cb29895eb 100644
--- a/osu.Game.Tests/Visual/Navigation/TestSceneChangeAndUseGameplayBindings.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneChangeAndUseGameplayBindings.cs
@@ -76,7 +76,7 @@ namespace osu.Game.Tests.Visual.Navigation
                                                        .ChildrenOfType<KeyBindingPanel>().SingleOrDefault();
 
         private RealmKeyBinding firstOsuRulesetKeyBindings => Game.Dependencies
-                                                                  .Get<RealmContextFactory>().Context
+                                                                  .Get<RealmAccess>().Context
                                                                   .All<RealmKeyBinding>()
                                                                   .AsEnumerable()
                                                                   .First(k => k.RulesetName == "osu" && k.ActionInt == 0);
diff --git a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs
index bc9f759bdd..716e3a535d 100644
--- a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs
+++ b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs
@@ -40,9 +40,9 @@ namespace osu.Game.Tests.Visual.Playlists
         [BackgroundDependencyLoader]
         private void load(GameHost host, AudioManager audio)
         {
-            Dependencies.Cache(rulesets = new RulesetStore(ContextFactory));
-            Dependencies.Cache(manager = new BeatmapManager(LocalStorage, ContextFactory, rulesets, API, audio, Resources, host, Beatmap.Default));
-            Dependencies.Cache(ContextFactory);
+            Dependencies.Cache(rulesets = new RulesetStore(Access));
+            Dependencies.Cache(manager = new BeatmapManager(LocalStorage, Access, rulesets, API, audio, Resources, host, Beatmap.Default));
+            Dependencies.Cache(Access);
         }
 
         [SetUpSteps]
diff --git a/osu.Game.Tests/Visual/Ranking/TestSceneResultsScreen.cs b/osu.Game.Tests/Visual/Ranking/TestSceneResultsScreen.cs
index a77480ee54..13b4af5223 100644
--- a/osu.Game.Tests/Visual/Ranking/TestSceneResultsScreen.cs
+++ b/osu.Game.Tests/Visual/Ranking/TestSceneResultsScreen.cs
@@ -36,13 +36,13 @@ namespace osu.Game.Tests.Visual.Ranking
         private BeatmapManager beatmaps { get; set; }
 
         [Resolved]
-        private RealmContextFactory realmContextFactory { get; set; }
+        private RealmAccess realm { get; set; }
 
         protected override void LoadComplete()
         {
             base.LoadComplete();
 
-            realmContextFactory.Run(realm =>
+            realm.Run(realm =>
             {
                 var beatmapInfo = realm.All<BeatmapInfo>()
                                        .Filter($"{nameof(BeatmapInfo.Ruleset)}.{nameof(RulesetInfo.OnlineID)} = $0", 0)
diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
index 2e1a66be5f..2f5594379b 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
@@ -42,10 +42,10 @@ namespace osu.Game.Tests.Visual.SongSelect
         {
             var dependencies = new DependencyContainer(base.CreateChildDependencies(parent));
 
-            dependencies.Cache(rulesetStore = new RulesetStore(ContextFactory));
-            dependencies.Cache(beatmapManager = new BeatmapManager(LocalStorage, ContextFactory, rulesetStore, null, dependencies.Get<AudioManager>(), Resources, dependencies.Get<GameHost>(), Beatmap.Default));
-            dependencies.Cache(scoreManager = new ScoreManager(rulesetStore, () => beatmapManager, LocalStorage, ContextFactory, Scheduler));
-            Dependencies.Cache(ContextFactory);
+            dependencies.Cache(rulesetStore = new RulesetStore(Access));
+            dependencies.Cache(beatmapManager = new BeatmapManager(LocalStorage, Access, rulesetStore, null, dependencies.Get<AudioManager>(), Resources, dependencies.Get<GameHost>(), Beatmap.Default));
+            dependencies.Cache(scoreManager = new ScoreManager(rulesetStore, () => beatmapManager, LocalStorage, Access, Scheduler));
+            Dependencies.Cache(Access);
 
             return dependencies;
         }
diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneFilterControl.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneFilterControl.cs
index ca8e9d2eff..4868a4a075 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneFilterControl.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneFilterControl.cs
@@ -36,9 +36,9 @@ namespace osu.Game.Tests.Visual.SongSelect
         [BackgroundDependencyLoader]
         private void load(GameHost host)
         {
-            Dependencies.Cache(rulesets = new RulesetStore(ContextFactory));
-            Dependencies.Cache(beatmapManager = new BeatmapManager(LocalStorage, ContextFactory, rulesets, null, Audio, Resources, host, Beatmap.Default));
-            Dependencies.Cache(ContextFactory);
+            Dependencies.Cache(rulesets = new RulesetStore(Access));
+            Dependencies.Cache(beatmapManager = new BeatmapManager(LocalStorage, Access, rulesets, null, Audio, Resources, host, Beatmap.Default));
+            Dependencies.Cache(Access);
 
             beatmapManager.Import(TestResources.GetQuickTestBeatmapForImport()).WaitSafely();
 
diff --git a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
index 6295a52bdd..d8a39dda01 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
@@ -47,9 +47,9 @@ namespace osu.Game.Tests.Visual.SongSelect
         {
             // These DI caches are required to ensure for interactive runs this test scene doesn't nuke all user beatmaps in the local install.
             // At a point we have isolated interactive test runs enough, this can likely be removed.
-            Dependencies.Cache(rulesets = new RulesetStore(ContextFactory));
-            Dependencies.Cache(ContextFactory);
-            Dependencies.Cache(manager = new BeatmapManager(LocalStorage, ContextFactory, rulesets, null, audio, Resources, host, defaultBeatmap = Beatmap.Default));
+            Dependencies.Cache(rulesets = new RulesetStore(Access));
+            Dependencies.Cache(Access);
+            Dependencies.Cache(manager = new BeatmapManager(LocalStorage, Access, rulesets, null, audio, Resources, host, defaultBeatmap = Beatmap.Default));
 
             Dependencies.Cache(music = new MusicController());
 
diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneTopLocalRank.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneTopLocalRank.cs
index 3aa5a759e6..a0657ffdf6 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneTopLocalRank.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneTopLocalRank.cs
@@ -28,10 +28,10 @@ namespace osu.Game.Tests.Visual.SongSelect
         [BackgroundDependencyLoader]
         private void load(GameHost host, AudioManager audio)
         {
-            Dependencies.Cache(rulesets = new RulesetStore(ContextFactory));
-            Dependencies.Cache(beatmapManager = new BeatmapManager(LocalStorage, ContextFactory, rulesets, null, audio, Resources, host, Beatmap.Default));
-            Dependencies.Cache(scoreManager = new ScoreManager(rulesets, () => beatmapManager, LocalStorage, ContextFactory, Scheduler));
-            Dependencies.Cache(ContextFactory);
+            Dependencies.Cache(rulesets = new RulesetStore(Access));
+            Dependencies.Cache(beatmapManager = new BeatmapManager(LocalStorage, Access, rulesets, null, audio, Resources, host, Beatmap.Default));
+            Dependencies.Cache(scoreManager = new ScoreManager(rulesets, () => beatmapManager, LocalStorage, Access, Scheduler));
+            Dependencies.Cache(Access);
 
             beatmapManager.Import(TestResources.GetQuickTestBeatmapForImport()).WaitSafely();
         }
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
index f43354514b..2278d3f8bf 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
@@ -45,7 +45,7 @@ namespace osu.Game.Tests.Visual.UserInterface
         private BeatmapInfo beatmapInfo;
 
         [Resolved]
-        private RealmContextFactory realmFactory { get; set; }
+        private RealmAccess realm { get; set; }
 
         [Cached]
         private readonly DialogOverlay dialogOverlay;
@@ -87,10 +87,10 @@ namespace osu.Game.Tests.Visual.UserInterface
         {
             var dependencies = new DependencyContainer(base.CreateChildDependencies(parent));
 
-            dependencies.Cache(rulesetStore = new RulesetStore(ContextFactory));
-            dependencies.Cache(beatmapManager = new BeatmapManager(LocalStorage, ContextFactory, rulesetStore, null, dependencies.Get<AudioManager>(), Resources, dependencies.Get<GameHost>(), Beatmap.Default));
-            dependencies.Cache(scoreManager = new ScoreManager(dependencies.Get<RulesetStore>(), () => beatmapManager, LocalStorage, ContextFactory, Scheduler));
-            Dependencies.Cache(ContextFactory);
+            dependencies.Cache(rulesetStore = new RulesetStore(Access));
+            dependencies.Cache(beatmapManager = new BeatmapManager(LocalStorage, Access, rulesetStore, null, dependencies.Get<AudioManager>(), Resources, dependencies.Get<GameHost>(), Beatmap.Default));
+            dependencies.Cache(scoreManager = new ScoreManager(dependencies.Get<RulesetStore>(), () => beatmapManager, LocalStorage, Access, Scheduler));
+            Dependencies.Cache(Access);
 
             var imported = beatmapManager.Import(new ImportTask(TestResources.GetQuickTestBeatmapForImport())).GetResultSafely();
 
@@ -122,7 +122,7 @@ namespace osu.Game.Tests.Visual.UserInterface
         [SetUp]
         public void Setup() => Schedule(() =>
         {
-            realmFactory.Run(realm =>
+            realm.Run(realm =>
             {
                 // Due to soft deletions, we can re-use deleted scores between test runs
                 scoreManager.Undelete(realm.All<ScoreInfo>().Where(s => s.DeletePending).ToList());
diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index 43e4b482bd..ddc1d054cc 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -41,11 +41,11 @@ namespace osu.Game.Beatmaps
         private readonly WorkingBeatmapCache workingBeatmapCache;
         private readonly BeatmapOnlineLookupQueue? onlineBeatmapLookupQueue;
 
-        private readonly RealmContextFactory contextFactory;
+        private readonly RealmAccess realm;
 
-        public BeatmapManager(Storage storage, RealmContextFactory contextFactory, RulesetStore rulesets, IAPIProvider? api, AudioManager audioManager, IResourceStore<byte[]> gameResources, GameHost? host = null, WorkingBeatmap? defaultBeatmap = null, bool performOnlineLookups = false)
+        public BeatmapManager(Storage storage, RealmAccess realm, RulesetStore rulesets, IAPIProvider? api, AudioManager audioManager, IResourceStore<byte[]> gameResources, GameHost? host = null, WorkingBeatmap? defaultBeatmap = null, bool performOnlineLookups = false)
         {
-            this.contextFactory = contextFactory;
+            this.realm = realm;
 
             if (performOnlineLookups)
             {
@@ -55,11 +55,11 @@ namespace osu.Game.Beatmaps
                 onlineBeatmapLookupQueue = new BeatmapOnlineLookupQueue(api, storage);
             }
 
-            var userResources = new RealmFileStore(contextFactory, storage).Store;
+            var userResources = new RealmFileStore(realm, storage).Store;
 
             BeatmapTrackStore = audioManager.GetTrackStore(userResources);
 
-            beatmapModelManager = CreateBeatmapModelManager(storage, contextFactory, rulesets, onlineBeatmapLookupQueue);
+            beatmapModelManager = CreateBeatmapModelManager(storage, realm, rulesets, onlineBeatmapLookupQueue);
             workingBeatmapCache = CreateWorkingBeatmapCache(audioManager, gameResources, userResources, defaultBeatmap, host);
 
             beatmapModelManager.WorkingBeatmapCache = workingBeatmapCache;
@@ -70,8 +70,8 @@ namespace osu.Game.Beatmaps
             return new WorkingBeatmapCache(BeatmapTrackStore, audioManager, resources, storage, defaultBeatmap, host);
         }
 
-        protected virtual BeatmapModelManager CreateBeatmapModelManager(Storage storage, RealmContextFactory contextFactory, RulesetStore rulesets, BeatmapOnlineLookupQueue? onlineLookupQueue) =>
-            new BeatmapModelManager(contextFactory, storage, onlineLookupQueue);
+        protected virtual BeatmapModelManager CreateBeatmapModelManager(Storage storage, RealmAccess realm, RulesetStore rulesets, BeatmapOnlineLookupQueue? onlineLookupQueue) =>
+            new BeatmapModelManager(realm, storage, onlineLookupQueue);
 
         /// <summary>
         /// Create a new <see cref="WorkingBeatmap"/>.
@@ -119,7 +119,7 @@ namespace osu.Game.Beatmaps
         /// <param name="beatmapInfo">The beatmap difficulty to hide.</param>
         public void Hide(BeatmapInfo beatmapInfo)
         {
-            contextFactory.Run(realm =>
+            realm.Run(realm =>
             {
                 using (var transaction = realm.BeginWrite())
                 {
@@ -138,7 +138,7 @@ namespace osu.Game.Beatmaps
         /// <param name="beatmapInfo">The beatmap difficulty to restore.</param>
         public void Restore(BeatmapInfo beatmapInfo)
         {
-            contextFactory.Run(realm =>
+            realm.Run(realm =>
             {
                 using (var transaction = realm.BeginWrite())
                 {
@@ -153,7 +153,7 @@ namespace osu.Game.Beatmaps
 
         public void RestoreAll()
         {
-            contextFactory.Run(realm =>
+            realm.Run(realm =>
             {
                 using (var transaction = realm.BeginWrite())
                 {
@@ -171,7 +171,7 @@ namespace osu.Game.Beatmaps
         /// <returns>A list of available <see cref="BeatmapSetInfo"/>.</returns>
         public List<BeatmapSetInfo> GetAllUsableBeatmapSets()
         {
-            return contextFactory.Run(realm =>
+            return realm.Run(realm =>
             {
                 realm.Refresh();
                 return realm.All<BeatmapSetInfo>().Where(b => !b.DeletePending).Detach();
@@ -185,7 +185,7 @@ namespace osu.Game.Beatmaps
         /// <returns>The first result for the provided query, or null if no results were found.</returns>
         public ILive<BeatmapSetInfo>? QueryBeatmapSet(Expression<Func<BeatmapSetInfo, bool>> query)
         {
-            return contextFactory.Run(realm => realm.All<BeatmapSetInfo>().FirstOrDefault(query)?.ToLive(contextFactory));
+            return realm.Run(r => r.All<BeatmapSetInfo>().FirstOrDefault(query)?.ToLive(realm));
         }
 
         #region Delegation to BeatmapModelManager (methods which previously existed locally).
@@ -240,7 +240,7 @@ namespace osu.Game.Beatmaps
 
         public void Delete(Expression<Func<BeatmapSetInfo, bool>>? filter = null, bool silent = false)
         {
-            contextFactory.Run(realm =>
+            realm.Run(realm =>
             {
                 var items = realm.All<BeatmapSetInfo>().Where(s => !s.DeletePending && !s.Protected);
 
@@ -253,7 +253,7 @@ namespace osu.Game.Beatmaps
 
         public void UndeleteAll()
         {
-            contextFactory.Run(realm => beatmapModelManager.Undelete(realm.All<BeatmapSetInfo>().Where(s => s.DeletePending).ToList()));
+            realm.Run(realm => beatmapModelManager.Undelete(realm.All<BeatmapSetInfo>().Where(s => s.DeletePending).ToList()));
         }
 
         public void Undelete(List<BeatmapSetInfo> items, bool silent = false)
@@ -312,7 +312,7 @@ namespace osu.Game.Beatmaps
             // If we seem to be missing files, now is a good time to re-fetch.
             if (importedBeatmap?.BeatmapSet?.Files.Count == 0)
             {
-                contextFactory.Run(realm =>
+                realm.Run(realm =>
                 {
                     var refetch = realm.Find<BeatmapInfo>(importedBeatmap.ID)?.Detach();
 
diff --git a/osu.Game/Beatmaps/BeatmapModelManager.cs b/osu.Game/Beatmaps/BeatmapModelManager.cs
index ead86c1059..167d77d6f6 100644
--- a/osu.Game/Beatmaps/BeatmapModelManager.cs
+++ b/osu.Game/Beatmaps/BeatmapModelManager.cs
@@ -33,8 +33,8 @@ namespace osu.Game.Beatmaps
 
         protected override string[] HashableFileTypes => new[] { ".osu" };
 
-        public BeatmapModelManager(RealmContextFactory contextFactory, Storage storage, BeatmapOnlineLookupQueue? onlineLookupQueue = null)
-            : base(contextFactory, storage, onlineLookupQueue)
+        public BeatmapModelManager(RealmAccess realm, Storage storage, BeatmapOnlineLookupQueue? onlineLookupQueue = null)
+            : base(realm, storage, onlineLookupQueue)
         {
         }
 
@@ -98,12 +98,12 @@ namespace osu.Game.Beatmaps
         /// <returns>The first result for the provided query, or null if no results were found.</returns>
         public BeatmapInfo? QueryBeatmap(Expression<Func<BeatmapInfo, bool>> query)
         {
-            return ContextFactory.Run(realm => realm.All<BeatmapInfo>().FirstOrDefault(query)?.Detach());
+            return Access.Run(realm => realm.All<BeatmapInfo>().FirstOrDefault(query)?.Detach());
         }
 
         public void Update(BeatmapSetInfo item)
         {
-            ContextFactory.Write(realm =>
+            Access.Write(realm =>
             {
                 var existing = realm.Find<BeatmapSetInfo>(item.ID);
                 item.CopyChangesToRealm(existing);
diff --git a/osu.Game/Beatmaps/WorkingBeatmapCache.cs b/osu.Game/Beatmaps/WorkingBeatmapCache.cs
index 6947752c47..d3f356bb24 100644
--- a/osu.Game/Beatmaps/WorkingBeatmapCache.cs
+++ b/osu.Game/Beatmaps/WorkingBeatmapCache.cs
@@ -100,7 +100,7 @@ namespace osu.Game.Beatmaps
         TextureStore IBeatmapResourceProvider.LargeTextureStore => largeTextureStore;
         ITrackStore IBeatmapResourceProvider.Tracks => trackStore;
         AudioManager IStorageResourceProvider.AudioManager => audioManager;
-        RealmContextFactory IStorageResourceProvider.RealmContextFactory => null;
+        RealmAccess IStorageResourceProvider.RealmAccess => null;
         IResourceStore<byte[]> IStorageResourceProvider.Files => files;
         IResourceStore<byte[]> IStorageResourceProvider.Resources => resources;
         IResourceStore<TextureUpload> IStorageResourceProvider.CreateTextureLoaderStore(IResourceStore<byte[]> underlyingStore) => host?.CreateTextureLoaderStore(underlyingStore);
diff --git a/osu.Game/Configuration/SettingsStore.cs b/osu.Game/Configuration/SettingsStore.cs
index 2bba20fb09..e5d2d572c8 100644
--- a/osu.Game/Configuration/SettingsStore.cs
+++ b/osu.Game/Configuration/SettingsStore.cs
@@ -10,11 +10,11 @@ namespace osu.Game.Configuration
         // this class mostly exists as a wrapper to avoid breaking the ruleset API (see usage in RulesetConfigManager).
         // it may cease to exist going forward, depending on how the structure of the config data layer changes.
 
-        public readonly RealmContextFactory Realm;
+        public readonly RealmAccess Realm;
 
-        public SettingsStore(RealmContextFactory realmFactory)
+        public SettingsStore(RealmAccess realm)
         {
-            Realm = realmFactory;
+            Realm = realm;
         }
     }
 }
diff --git a/osu.Game/Database/EFToRealmMigrator.cs b/osu.Game/Database/EFToRealmMigrator.cs
index edce99e302..a0787e81e6 100644
--- a/osu.Game/Database/EFToRealmMigrator.cs
+++ b/osu.Game/Database/EFToRealmMigrator.cs
@@ -35,7 +35,7 @@ namespace osu.Game.Database
         private DatabaseContextFactory efContextFactory { get; set; } = null!;
 
         [Resolved]
-        private RealmContextFactory realmContextFactory { get; set; } = null!;
+        private RealmAccess realm { get; set; } = null!;
 
         [Resolved]
         private OsuConfigManager config { get; set; } = null!;
@@ -101,7 +101,7 @@ namespace osu.Game.Database
             {
                 using (var ef = efContextFactory.Get())
                 {
-                    realmContextFactory.Write(realm =>
+                    realm.Write(realm =>
                     {
                         // Before beginning, ensure realm is in an empty state.
                         // Migrations which are half-completed could lead to issues if the user tries a second time.
@@ -158,7 +158,7 @@ namespace osu.Game.Database
 
             int count = existingBeatmapSets.Count();
 
-            realmContextFactory.Run(realm =>
+            realm.Run(realm =>
             {
                 log($"Found {count} beatmaps in EF");
 
@@ -280,7 +280,7 @@ namespace osu.Game.Database
 
             int count = existingScores.Count();
 
-            realmContextFactory.Run(realm =>
+            realm.Run(realm =>
             {
                 log($"Found {count} scores in EF");
 
@@ -369,7 +369,7 @@ namespace osu.Game.Database
                     break;
             }
 
-            realmContextFactory.Run(realm =>
+            realm.Run(realm =>
             {
                 using (var transaction = realm.BeginWrite())
                 {
@@ -428,7 +428,7 @@ namespace osu.Game.Database
 
             log("Beginning settings migration to realm");
 
-            realmContextFactory.Run(realm =>
+            realm.Run(realm =>
             {
                 using (var transaction = realm.BeginWrite())
                 {
diff --git a/osu.Game/Database/RealmContextFactory.cs b/osu.Game/Database/RealmAccess.cs
similarity index 98%
rename from osu.Game/Database/RealmContextFactory.cs
rename to osu.Game/Database/RealmAccess.cs
index 778092c543..2f397639c9 100644
--- a/osu.Game/Database/RealmContextFactory.cs
+++ b/osu.Game/Database/RealmAccess.cs
@@ -32,7 +32,7 @@ namespace osu.Game.Database
     /// <summary>
     /// A factory which provides both the main (update thread bound) realm context and creates contexts for async usage.
     /// </summary>
-    public class RealmContextFactory : IDisposable
+    public class RealmAccess : IDisposable
     {
         private readonly Storage storage;
 
@@ -123,7 +123,7 @@ namespace osu.Game.Database
         /// <param name="storage">The game storage which will be used to create the realm backing file.</param>
         /// <param name="filename">The filename to use for the realm backing file. A ".realm" extension will be added automatically if not specified.</param>
         /// <param name="efContextFactory">An EF factory used only for migration purposes.</param>
-        public RealmContextFactory(Storage storage, string filename, IDatabaseContextFactory? efContextFactory = null)
+        public RealmAccess(Storage storage, string filename, IDatabaseContextFactory? efContextFactory = null)
         {
             this.storage = storage;
             this.efContextFactory = efContextFactory;
@@ -365,7 +365,7 @@ namespace osu.Game.Database
         private Realm createContext()
         {
             if (isDisposed)
-                throw new ObjectDisposedException(nameof(RealmContextFactory));
+                throw new ObjectDisposedException(nameof(RealmAccess));
 
             bool tookSemaphoreLock = false;
 
@@ -592,7 +592,7 @@ namespace osu.Game.Database
         public IDisposable BlockAllOperations()
         {
             if (isDisposed)
-                throw new ObjectDisposedException(nameof(RealmContextFactory));
+                throw new ObjectDisposedException(nameof(RealmAccess));
 
             SynchronizationContext? syncContext = null;
 
@@ -652,7 +652,7 @@ namespace osu.Game.Database
                 throw;
             }
 
-            return new InvokeOnDisposal<RealmContextFactory>(this, factory =>
+            return new InvokeOnDisposal<RealmAccess>(this, factory =>
             {
                 factory.contextCreationLock.Release();
                 Logger.Log(@"Restoring realm operations.", LoggingTarget.Database);
diff --git a/osu.Game/Database/RealmLive.cs b/osu.Game/Database/RealmLive.cs
index df5e165f8e..29159fd5be 100644
--- a/osu.Game/Database/RealmLive.cs
+++ b/osu.Game/Database/RealmLive.cs
@@ -24,17 +24,17 @@ namespace osu.Game.Database
         /// </summary>
         private readonly T data;
 
-        private readonly RealmContextFactory realmFactory;
+        private readonly RealmAccess realm;
 
         /// <summary>
         /// Construct a new instance of live realm data.
         /// </summary>
         /// <param name="data">The realm data.</param>
-        /// <param name="realmFactory">The realm factory the data was sourced from. May be null for an unmanaged object.</param>
-        public RealmLive(T data, RealmContextFactory realmFactory)
+        /// <param name="realm">The realm factory the data was sourced from. May be null for an unmanaged object.</param>
+        public RealmLive(T data, RealmAccess realm)
         {
             this.data = data;
-            this.realmFactory = realmFactory;
+            this.realm = realm;
 
             ID = data.ID;
         }
@@ -51,7 +51,7 @@ namespace osu.Game.Database
                 return;
             }
 
-            realmFactory.Run(realm =>
+            realm.Run(realm =>
             {
                 perform(retrieveFromID(realm, ID));
             });
@@ -66,7 +66,7 @@ namespace osu.Game.Database
             if (!IsManaged)
                 return perform(data);
 
-            return realmFactory.Run(realm =>
+            return realm.Run(realm =>
             {
                 var returnData = perform(retrieveFromID(realm, ID));
 
@@ -104,7 +104,7 @@ namespace osu.Game.Database
                 if (!ThreadSafety.IsUpdateThread)
                     throw new InvalidOperationException($"Can't use {nameof(Value)} on managed objects from non-update threads");
 
-                return realmFactory.Context.Find<T>(ID);
+                return realm.Realm.Find<T>(ID);
             }
         }
 
diff --git a/osu.Game/Database/RealmObjectExtensions.cs b/osu.Game/Database/RealmObjectExtensions.cs
index d9026d165d..d4f8978ac5 100644
--- a/osu.Game/Database/RealmObjectExtensions.cs
+++ b/osu.Game/Database/RealmObjectExtensions.cs
@@ -216,16 +216,16 @@ namespace osu.Game.Database
             return new RealmLiveUnmanaged<T>(realmObject);
         }
 
-        public static List<ILive<T>> ToLive<T>(this IEnumerable<T> realmList, RealmContextFactory realmContextFactory)
+        public static List<ILive<T>> ToLive<T>(this IEnumerable<T> realmList, RealmAccess realm)
             where T : RealmObject, IHasGuidPrimaryKey
         {
-            return realmList.Select(l => new RealmLive<T>(l, realmContextFactory)).Cast<ILive<T>>().ToList();
+            return realmList.Select(l => new RealmLive<T>(l, realm)).Cast<ILive<T>>().ToList();
         }
 
-        public static ILive<T> ToLive<T>(this T realmObject, RealmContextFactory realmContextFactory)
+        public static ILive<T> ToLive<T>(this T realmObject, RealmAccess realm)
             where T : RealmObject, IHasGuidPrimaryKey
         {
-            return new RealmLive<T>(realmObject, realmContextFactory);
+            return new RealmLive<T>(realmObject, realm);
         }
 
         /// <summary>
@@ -271,8 +271,8 @@ namespace osu.Game.Database
         public static IDisposable? QueryAsyncWithNotifications<T>(this IRealmCollection<T> collection, NotificationCallbackDelegate<T> callback)
             where T : RealmObjectBase
         {
-            if (!RealmContextFactory.CurrentThreadSubscriptionsAllowed)
-                throw new InvalidOperationException($"Make sure to call {nameof(RealmContextFactory)}.{nameof(RealmContextFactory.RegisterForNotifications)}");
+            if (!RealmAccess.CurrentThreadSubscriptionsAllowed)
+                throw new InvalidOperationException($"Make sure to call {nameof(RealmAccess)}.{nameof(RealmAccess.RegisterForNotifications)}");
 
             return collection.SubscribeForNotifications(callback);
         }
diff --git a/osu.Game/IO/IStorageResourceProvider.cs b/osu.Game/IO/IStorageResourceProvider.cs
index 950b5aae09..b381ac70b0 100644
--- a/osu.Game/IO/IStorageResourceProvider.cs
+++ b/osu.Game/IO/IStorageResourceProvider.cs
@@ -28,7 +28,7 @@ namespace osu.Game.IO
         /// <summary>
         /// Access realm.
         /// </summary>
-        RealmContextFactory RealmContextFactory { get; }
+        RealmAccess RealmAccess { get; }
 
         /// <summary>
         /// Create a texture loader store based on an underlying data store.
diff --git a/osu.Game/Input/Bindings/DatabasedKeyBindingContainer.cs b/osu.Game/Input/Bindings/DatabasedKeyBindingContainer.cs
index 9cd9865441..d54c049c99 100644
--- a/osu.Game/Input/Bindings/DatabasedKeyBindingContainer.cs
+++ b/osu.Game/Input/Bindings/DatabasedKeyBindingContainer.cs
@@ -25,7 +25,7 @@ namespace osu.Game.Input.Bindings
         private IDisposable realmSubscription;
 
         [Resolved]
-        private RealmContextFactory realmFactory { get; set; }
+        private RealmAccess realm { get; set; }
 
         public override IEnumerable<IKeyBinding> DefaultKeyBindings => ruleset.CreateInstance().GetDefaultKeyBindings(variant ?? 0);
 
@@ -49,13 +49,13 @@ namespace osu.Game.Input.Bindings
         private IQueryable<RealmKeyBinding> queryRealmKeyBindings()
         {
             string rulesetName = ruleset?.ShortName;
-            return realmFactory.Context.All<RealmKeyBinding>()
-                               .Where(b => b.RulesetName == rulesetName && b.Variant == variant);
+            return realm.Realm.All<RealmKeyBinding>()
+                        .Where(b => b.RulesetName == rulesetName && b.Variant == variant);
         }
 
         protected override void LoadComplete()
         {
-            realmSubscription = realmFactory.RegisterForNotifications(realm => queryRealmKeyBindings(), (sender, changes, error) =>
+            realmSubscription = realm.RegisterForNotifications(realm => queryRealmKeyBindings(), (sender, changes, error) =>
             {
                 // The first fire of this is a bit redundant as this is being called in base.LoadComplete,
                 // but this is safest in case the subscription is restored after a context recycle.
diff --git a/osu.Game/Input/RealmKeyBindingStore.cs b/osu.Game/Input/RealmKeyBindingStore.cs
index 60f7eb2198..cccd42a9aa 100644
--- a/osu.Game/Input/RealmKeyBindingStore.cs
+++ b/osu.Game/Input/RealmKeyBindingStore.cs
@@ -16,12 +16,12 @@ namespace osu.Game.Input
 {
     public class RealmKeyBindingStore
     {
-        private readonly RealmContextFactory realmFactory;
+        private readonly RealmAccess realm;
         private readonly ReadableKeyCombinationProvider keyCombinationProvider;
 
-        public RealmKeyBindingStore(RealmContextFactory realmFactory, ReadableKeyCombinationProvider keyCombinationProvider)
+        public RealmKeyBindingStore(RealmAccess realm, ReadableKeyCombinationProvider keyCombinationProvider)
         {
-            this.realmFactory = realmFactory;
+            this.realm = realm;
             this.keyCombinationProvider = keyCombinationProvider;
         }
 
@@ -34,7 +34,7 @@ namespace osu.Game.Input
         {
             List<string> combinations = new List<string>();
 
-            realmFactory.Run(context =>
+            realm.Run(context =>
             {
                 foreach (var action in context.All<RealmKeyBinding>().Where(b => string.IsNullOrEmpty(b.RulesetName) && (GlobalAction)b.ActionInt == globalAction))
                 {
@@ -56,7 +56,7 @@ namespace osu.Game.Input
         /// <param name="rulesets">The rulesets to populate defaults from.</param>
         public void Register(KeyBindingContainer container, IEnumerable<RulesetInfo> rulesets)
         {
-            realmFactory.Run(realm =>
+            realm.Run(realm =>
             {
                 using (var transaction = realm.BeginWrite())
                 {
diff --git a/osu.Game/Online/BeatmapDownloadTracker.cs b/osu.Game/Online/BeatmapDownloadTracker.cs
index 3f45afb6b2..f54dc30620 100644
--- a/osu.Game/Online/BeatmapDownloadTracker.cs
+++ b/osu.Game/Online/BeatmapDownloadTracker.cs
@@ -22,7 +22,7 @@ namespace osu.Game.Online
         private IDisposable? realmSubscription;
 
         [Resolved]
-        private RealmContextFactory realmContextFactory { get; set; } = null!;
+        private RealmAccess realm { get; set; } = null!;
 
         public BeatmapDownloadTracker(IBeatmapSetInfo trackedItem)
             : base(trackedItem)
@@ -42,7 +42,7 @@ namespace osu.Game.Online
             // Used to interact with manager classes that don't support interface types. Will eventually be replaced.
             var beatmapSetInfo = new BeatmapSetInfo { OnlineID = TrackedItem.OnlineID };
 
-            realmSubscription = realmContextFactory.RegisterForNotifications(realm => realm.All<BeatmapSetInfo>().Where(s => s.OnlineID == TrackedItem.OnlineID && !s.DeletePending), (items, changes, ___) =>
+            realmSubscription = realm.RegisterForNotifications(realm => realm.All<BeatmapSetInfo>().Where(s => s.OnlineID == TrackedItem.OnlineID && !s.DeletePending), (items, changes, ___) =>
             {
                 if (items.Any())
                     Schedule(() => UpdateState(DownloadState.LocallyAvailable));
diff --git a/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs b/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs
index 28c41bec33..c562695ac1 100644
--- a/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs
+++ b/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs
@@ -30,7 +30,7 @@ namespace osu.Game.Online.Rooms
         protected override bool RequiresChildrenUpdate => true;
 
         [Resolved]
-        private RealmContextFactory realmContextFactory { get; set; } = null!;
+        private RealmAccess realm { get; set; } = null!;
 
         /// <summary>
         /// The availability state of the currently selected playlist item.
@@ -78,7 +78,7 @@ namespace osu.Game.Online.Rooms
 
                 // handles changes to hash that didn't occur from the import process (ie. a user editing the beatmap in the editor, somehow).
                 realmSubscription?.Dispose();
-                realmSubscription = realmContextFactory.RegisterForNotifications(realm => filteredBeatmaps(), (items, changes, ___) =>
+                realmSubscription = realm.RegisterForNotifications(realm => filteredBeatmaps(), (items, changes, ___) =>
                 {
                     if (changes == null)
                         return;
@@ -128,9 +128,9 @@ namespace osu.Game.Online.Rooms
             int onlineId = SelectedItem.Value.Beatmap.Value.OnlineID;
             string checksum = SelectedItem.Value.Beatmap.Value.MD5Hash;
 
-            return realmContextFactory.Context
-                                      .All<BeatmapInfo>()
-                                      .Filter("OnlineID == $0 && MD5Hash == $1 && BeatmapSet.DeletePending == false", onlineId, checksum);
+            return realm.Realm
+                        .All<BeatmapInfo>()
+                        .Filter("OnlineID == $0 && MD5Hash == $1 && BeatmapSet.DeletePending == false", onlineId, checksum);
         }
 
         protected override void Dispose(bool isDisposing)
diff --git a/osu.Game/Online/ScoreDownloadTracker.cs b/osu.Game/Online/ScoreDownloadTracker.cs
index 64ceee9fe6..81dfc811a4 100644
--- a/osu.Game/Online/ScoreDownloadTracker.cs
+++ b/osu.Game/Online/ScoreDownloadTracker.cs
@@ -23,7 +23,7 @@ namespace osu.Game.Online
         private IDisposable? realmSubscription;
 
         [Resolved]
-        private RealmContextFactory realmContextFactory { get; set; } = null!;
+        private RealmAccess realm { get; set; } = null!;
 
         public ScoreDownloadTracker(ScoreInfo trackedItem)
             : base(trackedItem)
@@ -47,7 +47,7 @@ namespace osu.Game.Online
             Downloader.DownloadBegan += downloadBegan;
             Downloader.DownloadFailed += downloadFailed;
 
-            realmSubscription = realmContextFactory.RegisterForNotifications(realm => realm.All<ScoreInfo>().Where(s => ((s.OnlineID > 0 && s.OnlineID == TrackedItem.OnlineID) || s.Hash == TrackedItem.Hash) && !s.DeletePending), (items, changes, ___) =>
+            realmSubscription = realm.RegisterForNotifications(realm => realm.All<ScoreInfo>().Where(s => ((s.OnlineID > 0 && s.OnlineID == TrackedItem.OnlineID) || s.Hash == TrackedItem.Hash) && !s.DeletePending), (items, changes, ___) =>
             {
                 if (items.Any())
                     Schedule(() => UpdateState(DownloadState.LocallyAvailable));
diff --git a/osu.Game/OsuGameBase.cs b/osu.Game/OsuGameBase.cs
index 710a7be8d4..7a6a126900 100644
--- a/osu.Game/OsuGameBase.cs
+++ b/osu.Game/OsuGameBase.cs
@@ -149,7 +149,7 @@ namespace osu.Game
 
         private MultiplayerClient multiplayerClient;
 
-        private RealmContextFactory realmFactory;
+        private RealmAccess realm;
 
         protected override Container<Drawable> Content => content;
 
@@ -192,9 +192,9 @@ namespace osu.Game
             if (Storage.Exists(DatabaseContextFactory.DATABASE_NAME))
                 dependencies.Cache(EFContextFactory = new DatabaseContextFactory(Storage));
 
-            dependencies.Cache(realmFactory = new RealmContextFactory(Storage, "client", EFContextFactory));
+            dependencies.Cache(realm = new RealmAccess(Storage, "client", EFContextFactory));
 
-            dependencies.Cache(RulesetStore = new RulesetStore(realmFactory, Storage));
+            dependencies.Cache(RulesetStore = new RulesetStore(realm, Storage));
             dependencies.CacheAs<IRulesetStore>(RulesetStore);
 
             // Backup is taken here rather than in EFToRealmMigrator to avoid recycling realm contexts
@@ -205,7 +205,7 @@ namespace osu.Game
                 string migration = $"before_final_migration_{DateTimeOffset.UtcNow.ToUnixTimeSeconds()}";
 
                 EFContextFactory.CreateBackup($"client.{migration}.db");
-                realmFactory.CreateBackup($"client.{migration}.realm");
+                realm.CreateBackup($"client.{migration}.realm");
 
                 using (var source = Storage.GetStream("collection.db"))
                 using (var destination = Storage.GetStream($"collection.{migration}.db", FileAccess.Write, FileMode.CreateNew))
@@ -225,7 +225,7 @@ namespace osu.Game
 
             Audio.Samples.PlaybackConcurrency = SAMPLE_CONCURRENCY;
 
-            dependencies.Cache(SkinManager = new SkinManager(Storage, realmFactory, Host, Resources, Audio, Scheduler));
+            dependencies.Cache(SkinManager = new SkinManager(Storage, realm, Host, Resources, Audio, Scheduler));
             dependencies.CacheAs<ISkinSource>(SkinManager);
 
             EndpointConfiguration endpoints = UseDevelopmentServer ? (EndpointConfiguration)new DevelopmentEndpointConfiguration() : new ProductionEndpointConfiguration();
@@ -240,8 +240,8 @@ namespace osu.Game
             var defaultBeatmap = new DummyWorkingBeatmap(Audio, Textures);
 
             // ordering is important here to ensure foreign keys rules are not broken in ModelStore.Cleanup()
-            dependencies.Cache(ScoreManager = new ScoreManager(RulesetStore, () => BeatmapManager, Storage, realmFactory, Scheduler, Host, () => difficultyCache, LocalConfig));
-            dependencies.Cache(BeatmapManager = new BeatmapManager(Storage, realmFactory, RulesetStore, API, Audio, Resources, Host, defaultBeatmap, performOnlineLookups: true));
+            dependencies.Cache(ScoreManager = new ScoreManager(RulesetStore, () => BeatmapManager, Storage, realm, Scheduler, Host, () => difficultyCache, LocalConfig));
+            dependencies.Cache(BeatmapManager = new BeatmapManager(Storage, realm, RulesetStore, API, Audio, Resources, Host, defaultBeatmap, performOnlineLookups: true));
 
             dependencies.Cache(BeatmapDownloader = new BeatmapModelDownloader(BeatmapManager, API));
             dependencies.Cache(ScoreDownloader = new ScoreModelDownloader(ScoreManager, API));
@@ -259,7 +259,7 @@ namespace osu.Game
             dependencies.Cache(scorePerformanceManager);
             AddInternal(scorePerformanceManager);
 
-            dependencies.CacheAs<IRulesetConfigCache>(rulesetConfigCache = new RulesetConfigCache(realmFactory, RulesetStore));
+            dependencies.CacheAs<IRulesetConfigCache>(rulesetConfigCache = new RulesetConfigCache(realm, RulesetStore));
 
             var powerStatus = CreateBatteryInfo();
             if (powerStatus != null)
@@ -303,7 +303,7 @@ namespace osu.Game
 
             base.Content.Add(CreateScalingContainer().WithChildren(mainContent));
 
-            KeyBindingStore = new RealmKeyBindingStore(realmFactory, keyCombinationProvider);
+            KeyBindingStore = new RealmKeyBindingStore(realm, keyCombinationProvider);
             KeyBindingStore.Register(globalBindings, RulesetStore.AvailableRulesets);
 
             dependencies.Cache(globalBindings);
@@ -405,7 +405,7 @@ namespace osu.Game
 
                 Scheduler.Add(() =>
                 {
-                    realmBlocker = realmFactory.BlockAllOperations();
+                    realmBlocker = realm.BlockAllOperations();
 
                     readyToRun.Set();
                 }, false);
@@ -483,7 +483,7 @@ namespace osu.Game
             BeatmapManager?.Dispose();
             LocalConfig?.Dispose();
 
-            realmFactory?.Dispose();
+            realm?.Dispose();
         }
     }
 }
diff --git a/osu.Game/Overlays/MusicController.cs b/osu.Game/Overlays/MusicController.cs
index 8df7ed9736..8450446473 100644
--- a/osu.Game/Overlays/MusicController.cs
+++ b/osu.Game/Overlays/MusicController.cs
@@ -69,7 +69,7 @@ namespace osu.Game.Overlays
         public DrawableTrack CurrentTrack { get; private set; } = new DrawableTrack(new TrackVirtual(1000));
 
         [Resolved]
-        private RealmContextFactory realmFactory { get; set; }
+        private RealmAccess realm { get; set; }
 
         [BackgroundDependencyLoader]
         private void load()
@@ -81,9 +81,9 @@ namespace osu.Game.Overlays
         }
 
         private IQueryable<BeatmapSetInfo> queryRealmBeatmapSets() =>
-            realmFactory.Context
-                        .All<BeatmapSetInfo>()
-                        .Where(s => !s.DeletePending);
+            realm.Realm
+                 .All<BeatmapSetInfo>()
+                 .Where(s => !s.DeletePending);
 
         protected override void LoadComplete()
         {
@@ -94,7 +94,7 @@ namespace osu.Game.Overlays
             foreach (var s in queryRealmBeatmapSets())
                 beatmapSets.Add(s.Detach());
 
-            beatmapSubscription = realmFactory.RegisterForNotifications(realm => queryRealmBeatmapSets(), beatmapsChanged);
+            beatmapSubscription = realm.RegisterForNotifications(realm => queryRealmBeatmapSets(), beatmapsChanged);
         }
 
         private void beatmapsChanged(IRealmCollection<BeatmapSetInfo> sender, ChangeSet changes, Exception error)
diff --git a/osu.Game/Overlays/Settings/Sections/DebugSettings/MemorySettings.cs b/osu.Game/Overlays/Settings/Sections/DebugSettings/MemorySettings.cs
index c5854981e6..3b94cae171 100644
--- a/osu.Game/Overlays/Settings/Sections/DebugSettings/MemorySettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/DebugSettings/MemorySettings.cs
@@ -19,7 +19,7 @@ namespace osu.Game.Overlays.Settings.Sections.DebugSettings
         protected override LocalisableString Header => DebugSettingsStrings.MemoryHeader;
 
         [BackgroundDependencyLoader]
-        private void load(GameHost host, RealmContextFactory realmFactory)
+        private void load(GameHost host, RealmAccess realm)
         {
             SettingsButton blockAction;
             SettingsButton unblockAction;
@@ -37,7 +37,7 @@ namespace osu.Game.Overlays.Settings.Sections.DebugSettings
                     Action = () =>
                     {
                         // Blocking operations implicitly causes a Compact().
-                        using (realmFactory.BlockAllOperations())
+                        using (realm.BlockAllOperations())
                         {
                         }
                     }
@@ -56,7 +56,7 @@ namespace osu.Game.Overlays.Settings.Sections.DebugSettings
             {
                 try
                 {
-                    var token = realmFactory.BlockAllOperations();
+                    var token = realm.BlockAllOperations();
 
                     blockAction.Enabled.Value = false;
 
diff --git a/osu.Game/Overlays/Settings/Sections/Input/KeyBindingRow.cs b/osu.Game/Overlays/Settings/Sections/Input/KeyBindingRow.cs
index 60aff91301..91883e4f41 100644
--- a/osu.Game/Overlays/Settings/Sections/Input/KeyBindingRow.cs
+++ b/osu.Game/Overlays/Settings/Sections/Input/KeyBindingRow.cs
@@ -79,7 +79,7 @@ namespace osu.Game.Overlays.Settings.Sections.Input
         }
 
         [Resolved]
-        private RealmContextFactory realmFactory { get; set; }
+        private RealmAccess realm { get; set; }
 
         [BackgroundDependencyLoader]
         private void load(OverlayColourProvider colourProvider)
@@ -386,7 +386,7 @@ namespace osu.Game.Overlays.Settings.Sections.Input
 
         private void updateStoreFromButton(KeyButton button)
         {
-            realmFactory.Run(realm =>
+            realm.Run(realm =>
             {
                 var binding = realm.Find<RealmKeyBinding>(((IHasGuidPrimaryKey)button.KeyBinding).ID);
                 realm.Write(() => binding.KeyCombinationString = button.KeyBinding.KeyCombinationString);
diff --git a/osu.Game/Overlays/Settings/Sections/Input/KeyBindingsSubsection.cs b/osu.Game/Overlays/Settings/Sections/Input/KeyBindingsSubsection.cs
index 5b8a52240e..922d371261 100644
--- a/osu.Game/Overlays/Settings/Sections/Input/KeyBindingsSubsection.cs
+++ b/osu.Game/Overlays/Settings/Sections/Input/KeyBindingsSubsection.cs
@@ -30,13 +30,13 @@ namespace osu.Game.Overlays.Settings.Sections.Input
         }
 
         [BackgroundDependencyLoader]
-        private void load(RealmContextFactory realmFactory)
+        private void load(RealmAccess realm)
         {
             string rulesetName = Ruleset?.ShortName;
 
-            var bindings = realmFactory.Run(realm => realm.All<RealmKeyBinding>()
-                                                          .Where(b => b.RulesetName == rulesetName && b.Variant == variant)
-                                                          .Detach());
+            var bindings = realm.Run(r => r.All<RealmKeyBinding>()
+                                           .Where(b => b.RulesetName == rulesetName && b.Variant == variant)
+                                           .Detach());
 
             foreach (var defaultGroup in Defaults.GroupBy(d => d.Action))
             {
diff --git a/osu.Game/Overlays/Settings/Sections/SkinSection.cs b/osu.Game/Overlays/Settings/Sections/SkinSection.cs
index 6e5cd0da2d..af3fd5c9bf 100644
--- a/osu.Game/Overlays/Settings/Sections/SkinSection.cs
+++ b/osu.Game/Overlays/Settings/Sections/SkinSection.cs
@@ -47,15 +47,15 @@ namespace osu.Game.Overlays.Settings.Sections
         private SkinManager skins { get; set; }
 
         [Resolved]
-        private RealmContextFactory realmFactory { get; set; }
+        private RealmAccess realm { get; set; }
 
         private IDisposable realmSubscription;
 
         private IQueryable<SkinInfo> queryRealmSkins() =>
-            realmFactory.Context.All<SkinInfo>()
-                        .Where(s => !s.DeletePending)
-                        .OrderByDescending(s => s.Protected) // protected skins should be at the top.
-                        .ThenBy(s => s.Name, StringComparer.OrdinalIgnoreCase);
+            realm.Realm.All<SkinInfo>()
+                 .Where(s => !s.DeletePending)
+                 .OrderByDescending(s => s.Protected) // protected skins should be at the top.
+                 .ThenBy(s => s.Name, StringComparer.OrdinalIgnoreCase);
 
         [BackgroundDependencyLoader(permitNulls: true)]
         private void load(OsuConfigManager config, [CanBeNull] SkinEditorOverlay skinEditor)
@@ -83,7 +83,7 @@ namespace osu.Game.Overlays.Settings.Sections
 
             skinDropdown.Current = dropdownBindable;
 
-            realmSubscription = realmFactory.RegisterForNotifications(realm => queryRealmSkins(), (sender, changes, error) =>
+            realmSubscription = realm.RegisterForNotifications(realm => queryRealmSkins(), (sender, changes, error) =>
             {
                 // The first fire of this is a bit redundant due to the call below,
                 // but this is safest in case the subscription is restored after a context recycle.
@@ -130,7 +130,7 @@ namespace osu.Game.Overlays.Settings.Sections
         {
             int protectedCount = queryRealmSkins().Count(s => s.Protected);
 
-            skinItems = queryRealmSkins().ToLive(realmFactory);
+            skinItems = queryRealmSkins().ToLive(realm);
 
             skinItems.Insert(protectedCount, random_skin_info);
 
diff --git a/osu.Game/Overlays/Toolbar/ToolbarButton.cs b/osu.Game/Overlays/Toolbar/ToolbarButton.cs
index 75bebfa763..c855b76680 100644
--- a/osu.Game/Overlays/Toolbar/ToolbarButton.cs
+++ b/osu.Game/Overlays/Toolbar/ToolbarButton.cs
@@ -80,7 +80,7 @@ namespace osu.Game.Overlays.Toolbar
         protected FillFlowContainer Flow;
 
         [Resolved]
-        private RealmContextFactory realmFactory { get; set; }
+        private RealmAccess realm { get; set; }
 
         protected ToolbarButton()
             : base(HoverSampleSet.Toolbar)
@@ -207,7 +207,7 @@ namespace osu.Game.Overlays.Toolbar
         {
             if (Hotkey == null) return;
 
-            var realmKeyBinding = realmFactory.Context.All<RealmKeyBinding>().FirstOrDefault(rkb => rkb.RulesetName == null && rkb.ActionInt == (int)Hotkey.Value);
+            var realmKeyBinding = realm.Realm.All<RealmKeyBinding>().FirstOrDefault(rkb => rkb.RulesetName == null && rkb.ActionInt == (int)Hotkey.Value);
 
             if (realmKeyBinding != null)
             {
diff --git a/osu.Game/Rulesets/Configuration/RulesetConfigManager.cs b/osu.Game/Rulesets/Configuration/RulesetConfigManager.cs
index 60a6b70221..cfa20e0b87 100644
--- a/osu.Game/Rulesets/Configuration/RulesetConfigManager.cs
+++ b/osu.Game/Rulesets/Configuration/RulesetConfigManager.cs
@@ -14,7 +14,7 @@ namespace osu.Game.Rulesets.Configuration
     public abstract class RulesetConfigManager<TLookup> : ConfigManager<TLookup>, IRulesetConfigManager
         where TLookup : struct, Enum
     {
-        private readonly RealmContextFactory realmFactory;
+        private readonly RealmAccess realm;
 
         private readonly int variant;
 
@@ -24,7 +24,7 @@ namespace osu.Game.Rulesets.Configuration
 
         protected RulesetConfigManager(SettingsStore store, RulesetInfo ruleset, int? variant = null)
         {
-            realmFactory = store?.Realm;
+            realm = store?.Realm;
 
             rulesetName = ruleset.ShortName;
 
@@ -37,10 +37,10 @@ namespace osu.Game.Rulesets.Configuration
 
         protected override void PerformLoad()
         {
-            if (realmFactory != null)
+            if (realm != null)
             {
                 // As long as RulesetConfigCache exists, there is no need to subscribe to realm events.
-                databasedSettings = realmFactory.Context.All<RealmRulesetSetting>().Where(b => b.RulesetName == rulesetName && b.Variant == variant).ToList();
+                databasedSettings = realm.Realm.All<RealmRulesetSetting>().Where(b => b.RulesetName == rulesetName && b.Variant == variant).ToList();
             }
         }
 
@@ -56,7 +56,7 @@ namespace osu.Game.Rulesets.Configuration
                 pendingWrites.Clear();
             }
 
-            realmFactory?.Write(realm =>
+            realm?.Write(realm =>
             {
                 foreach (var c in changed)
                 {
@@ -89,7 +89,7 @@ namespace osu.Game.Rulesets.Configuration
                     Variant = variant,
                 };
 
-                realmFactory?.Context.Write(() => realmFactory.Context.Add(setting));
+                realm?.Realm.Write(() => realm.Realm.Add(setting));
 
                 databasedSettings.Add(setting);
             }
diff --git a/osu.Game/Rulesets/RulesetConfigCache.cs b/osu.Game/Rulesets/RulesetConfigCache.cs
index dee13e74a5..c4f1933cd8 100644
--- a/osu.Game/Rulesets/RulesetConfigCache.cs
+++ b/osu.Game/Rulesets/RulesetConfigCache.cs
@@ -13,14 +13,14 @@ namespace osu.Game.Rulesets
 {
     public class RulesetConfigCache : Component, IRulesetConfigCache
     {
-        private readonly RealmContextFactory realmFactory;
+        private readonly RealmAccess realm;
         private readonly RulesetStore rulesets;
 
         private readonly Dictionary<string, IRulesetConfigManager> configCache = new Dictionary<string, IRulesetConfigManager>();
 
-        public RulesetConfigCache(RealmContextFactory realmFactory, RulesetStore rulesets)
+        public RulesetConfigCache(RealmAccess realm, RulesetStore rulesets)
         {
-            this.realmFactory = realmFactory;
+            this.realm = realm;
             this.rulesets = rulesets;
         }
 
@@ -28,7 +28,7 @@ namespace osu.Game.Rulesets
         {
             base.LoadComplete();
 
-            var settingsStore = new SettingsStore(realmFactory);
+            var settingsStore = new SettingsStore(realm);
 
             // let's keep things simple for now and just retrieve all the required configs at startup..
             foreach (var ruleset in rulesets.AvailableRulesets)
diff --git a/osu.Game/Rulesets/RulesetStore.cs b/osu.Game/Rulesets/RulesetStore.cs
index a9e5ff797c..606bc65599 100644
--- a/osu.Game/Rulesets/RulesetStore.cs
+++ b/osu.Game/Rulesets/RulesetStore.cs
@@ -18,7 +18,7 @@ namespace osu.Game.Rulesets
 {
     public class RulesetStore : IDisposable, IRulesetStore
     {
-        private readonly RealmContextFactory realmFactory;
+        private readonly RealmAccess realm;
 
         private const string ruleset_library_prefix = @"osu.Game.Rulesets";
 
@@ -31,9 +31,9 @@ namespace osu.Game.Rulesets
 
         private readonly List<RulesetInfo> availableRulesets = new List<RulesetInfo>();
 
-        public RulesetStore(RealmContextFactory realmFactory, Storage? storage = null)
+        public RulesetStore(RealmAccess realm, Storage? storage = null)
         {
-            this.realmFactory = realmFactory;
+            this.realm = realm;
 
             // On android in release configuration assemblies are loaded from the apk directly into memory.
             // We cannot read assemblies from cwd, so should check loaded assemblies instead.
@@ -100,7 +100,7 @@ namespace osu.Game.Rulesets
 
         private void addMissingRulesets()
         {
-            realmFactory.Write(realm =>
+            realm.Write(realm =>
             {
                 var rulesets = realm.All<RulesetInfo>();
 
diff --git a/osu.Game/Scoring/ScoreManager.cs b/osu.Game/Scoring/ScoreManager.cs
index f895134f97..e712d170cd 100644
--- a/osu.Game/Scoring/ScoreManager.cs
+++ b/osu.Game/Scoring/ScoreManager.cs
@@ -25,21 +25,21 @@ namespace osu.Game.Scoring
 {
     public class ScoreManager : IModelManager<ScoreInfo>, IModelImporter<ScoreInfo>
     {
-        private readonly RealmContextFactory contextFactory;
+        private readonly RealmAccess realm;
         private readonly Scheduler scheduler;
         private readonly Func<BeatmapDifficultyCache> difficulties;
         private readonly OsuConfigManager configManager;
         private readonly ScoreModelManager scoreModelManager;
 
-        public ScoreManager(RulesetStore rulesets, Func<BeatmapManager> beatmaps, Storage storage, RealmContextFactory contextFactory, Scheduler scheduler,
+        public ScoreManager(RulesetStore rulesets, Func<BeatmapManager> beatmaps, Storage storage, RealmAccess realm, Scheduler scheduler,
                             IIpcHost importHost = null, Func<BeatmapDifficultyCache> difficulties = null, OsuConfigManager configManager = null)
         {
-            this.contextFactory = contextFactory;
+            this.realm = realm;
             this.scheduler = scheduler;
             this.difficulties = difficulties;
             this.configManager = configManager;
 
-            scoreModelManager = new ScoreModelManager(rulesets, beatmaps, storage, contextFactory);
+            scoreModelManager = new ScoreModelManager(rulesets, beatmaps, storage, realm);
         }
 
         public Score GetScore(ScoreInfo score) => scoreModelManager.GetScore(score);
@@ -51,7 +51,7 @@ namespace osu.Game.Scoring
         /// <returns>The first result for the provided query, or null if no results were found.</returns>
         public ScoreInfo Query(Expression<Func<ScoreInfo, bool>> query)
         {
-            return contextFactory.Run(realm => realm.All<ScoreInfo>().FirstOrDefault(query)?.Detach());
+            return realm.Run(realm => realm.All<ScoreInfo>().FirstOrDefault(query)?.Detach());
         }
 
         /// <summary>
@@ -254,7 +254,7 @@ namespace osu.Game.Scoring
 
         public void Delete([CanBeNull] Expression<Func<ScoreInfo, bool>> filter = null, bool silent = false)
         {
-            contextFactory.Run(realm =>
+            realm.Run(realm =>
             {
                 var items = realm.All<ScoreInfo>()
                                  .Where(s => !s.DeletePending);
diff --git a/osu.Game/Scoring/ScoreModelManager.cs b/osu.Game/Scoring/ScoreModelManager.cs
index 5e560effa1..2147ff1ba1 100644
--- a/osu.Game/Scoring/ScoreModelManager.cs
+++ b/osu.Game/Scoring/ScoreModelManager.cs
@@ -29,8 +29,8 @@ namespace osu.Game.Scoring
         private readonly RulesetStore rulesets;
         private readonly Func<BeatmapManager> beatmaps;
 
-        public ScoreModelManager(RulesetStore rulesets, Func<BeatmapManager> beatmaps, Storage storage, RealmContextFactory contextFactory)
-            : base(storage, contextFactory)
+        public ScoreModelManager(RulesetStore rulesets, Func<BeatmapManager> beatmaps, Storage storage, RealmAccess realm)
+            : base(storage, realm)
         {
             this.rulesets = rulesets;
             this.beatmaps = beatmaps;
@@ -74,7 +74,7 @@ namespace osu.Game.Scoring
 
         public override bool IsAvailableLocally(ScoreInfo model)
         {
-            return ContextFactory.Run(realm => realm.All<ScoreInfo>().Any(s => s.OnlineID == model.OnlineID));
+            return Access.Run(realm => realm.All<ScoreInfo>().Any(s => s.OnlineID == model.OnlineID));
         }
     }
 }
diff --git a/osu.Game/Screens/Menu/IntroScreen.cs b/osu.Game/Screens/Menu/IntroScreen.cs
index e66ecc74e1..fceb083916 100644
--- a/osu.Game/Screens/Menu/IntroScreen.cs
+++ b/osu.Game/Screens/Menu/IntroScreen.cs
@@ -85,7 +85,7 @@ namespace osu.Game.Screens.Menu
         private BeatmapManager beatmaps { get; set; }
 
         [BackgroundDependencyLoader]
-        private void load(OsuConfigManager config, Framework.Game game, RealmContextFactory realmContextFactory)
+        private void load(OsuConfigManager config, Framework.Game game, RealmAccess realm)
         {
             // prevent user from changing beatmap while the intro is still running.
             beatmap = Beatmap.BeginLease(false);
@@ -97,9 +97,9 @@ namespace osu.Game.Screens.Menu
             // if the user has requested not to play theme music, we should attempt to find a random beatmap from their collection.
             if (!MenuMusic.Value)
             {
-                realmContextFactory.Run(realm =>
+                realm.Run(r =>
                 {
-                    var usableBeatmapSets = realm.All<BeatmapSetInfo>().Where(s => !s.DeletePending && !s.Protected).AsRealmCollection();
+                    var usableBeatmapSets = r.All<BeatmapSetInfo>().Where(s => !s.DeletePending && !s.Protected).AsRealmCollection();
 
                     int setCount = usableBeatmapSets.Count;
 
diff --git a/osu.Game/Screens/Select/BeatmapCarousel.cs b/osu.Game/Screens/Select/BeatmapCarousel.cs
index 5a6295fe74..8e0fdea0f8 100644
--- a/osu.Game/Screens/Select/BeatmapCarousel.cs
+++ b/osu.Game/Screens/Select/BeatmapCarousel.cs
@@ -179,24 +179,24 @@ namespace osu.Game.Screens.Select
 
             if (!loadedTestBeatmaps)
             {
-                realmFactory.Run(realm => loadBeatmapSets(getBeatmapSets(realm)));
+                realm.Run(realm => loadBeatmapSets(getBeatmapSets(realm)));
             }
         }
 
         [Resolved]
-        private RealmContextFactory realmFactory { get; set; }
+        private RealmAccess realm { get; set; }
 
         protected override void LoadComplete()
         {
             base.LoadComplete();
 
-            subscriptionSets = realmFactory.RegisterForNotifications(getBeatmapSets, beatmapSetsChanged);
-            subscriptionBeatmaps = realmFactory.RegisterForNotifications(realm => realm.All<BeatmapInfo>().Where(b => !b.Hidden), beatmapsChanged);
+            subscriptionSets = realm.RegisterForNotifications(getBeatmapSets, beatmapSetsChanged);
+            subscriptionBeatmaps = realm.RegisterForNotifications(realm => realm.All<BeatmapInfo>().Where(b => !b.Hidden), beatmapsChanged);
 
             // Can't use main subscriptions because we can't lookup deleted indices.
             // https://github.com/realm/realm-dotnet/discussions/2634#discussioncomment-1605595.
-            subscriptionDeletedSets = realmFactory.RegisterForNotifications(realm => realm.All<BeatmapSetInfo>().Where(s => s.DeletePending && !s.Protected), deletedBeatmapSetsChanged);
-            subscriptionHiddenBeatmaps = realmFactory.RegisterForNotifications(realm => realm.All<BeatmapInfo>().Where(b => b.Hidden), beatmapsChanged);
+            subscriptionDeletedSets = realm.RegisterForNotifications(realm => realm.All<BeatmapSetInfo>().Where(s => s.DeletePending && !s.Protected), deletedBeatmapSetsChanged);
+            subscriptionHiddenBeatmaps = realm.RegisterForNotifications(realm => realm.All<BeatmapInfo>().Where(b => b.Hidden), beatmapsChanged);
         }
 
         private void deletedBeatmapSetsChanged(IRealmCollection<BeatmapSetInfo> sender, ChangeSet changes, Exception error)
@@ -231,7 +231,7 @@ namespace osu.Game.Screens.Select
                 foreach (var id in realmSets)
                 {
                     if (!root.BeatmapSetsByID.ContainsKey(id))
-                        UpdateBeatmapSet(realmFactory.Context.Find<BeatmapSetInfo>(id).Detach());
+                        UpdateBeatmapSet(realm.Realm.Find<BeatmapSetInfo>(id).Detach());
                 }
 
                 foreach (var id in root.BeatmapSetsByID.Keys)
diff --git a/osu.Game/Screens/Select/Carousel/TopLocalRank.cs b/osu.Game/Screens/Select/Carousel/TopLocalRank.cs
index c03d464ef6..021dfd06f7 100644
--- a/osu.Game/Screens/Select/Carousel/TopLocalRank.cs
+++ b/osu.Game/Screens/Select/Carousel/TopLocalRank.cs
@@ -26,7 +26,7 @@ namespace osu.Game.Screens.Select.Carousel
         private IBindable<RulesetInfo> ruleset { get; set; }
 
         [Resolved]
-        private RealmContextFactory realmFactory { get; set; }
+        private RealmAccess realm { get; set; }
 
         [Resolved]
         private IAPIProvider api { get; set; }
@@ -48,7 +48,7 @@ namespace osu.Game.Screens.Select.Carousel
             ruleset.BindValueChanged(_ =>
             {
                 scoreSubscription?.Dispose();
-                scoreSubscription = realmFactory.RegisterForNotifications(realm =>
+                scoreSubscription = realm.RegisterForNotifications(realm =>
                         realm.All<ScoreInfo>()
                              .Filter($"{nameof(ScoreInfo.User)}.{nameof(RealmUser.OnlineID)} == $0"
                                      + $" && {nameof(ScoreInfo.BeatmapInfo)}.{nameof(BeatmapInfo.ID)} == $1"
diff --git a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
index 5f288b972b..3d262f8b97 100644
--- a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
+++ b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
@@ -29,7 +29,7 @@ namespace osu.Game.Screens.Select.Leaderboards
         private RulesetStore rulesets { get; set; }
 
         [Resolved]
-        private RealmContextFactory realmFactory { get; set; }
+        private RealmAccess realm { get; set; }
 
         private BeatmapInfo beatmapInfo;
 
@@ -113,7 +113,7 @@ namespace osu.Game.Screens.Select.Leaderboards
             if (beatmapInfo == null)
                 return;
 
-            scoreSubscription = realmFactory.RegisterForNotifications(realm =>
+            scoreSubscription = realm.RegisterForNotifications(realm =>
                     realm.All<ScoreInfo>()
                          .Filter($"{nameof(ScoreInfo.BeatmapInfo)}.{nameof(BeatmapInfo.ID)} = $0", beatmapInfo.ID),
                 (_, changes, ___) =>
@@ -150,7 +150,7 @@ namespace osu.Game.Screens.Select.Leaderboards
 
             if (Scope == BeatmapLeaderboardScope.Local)
             {
-                realmFactory.Run(realm =>
+                realm.Run(realm =>
                 {
                     var scores = realm.All<ScoreInfo>()
                                       .AsEnumerable()
diff --git a/osu.Game/Screens/Spectate/SpectatorScreen.cs b/osu.Game/Screens/Spectate/SpectatorScreen.cs
index 4abde56ea6..3cf9f79611 100644
--- a/osu.Game/Screens/Spectate/SpectatorScreen.cs
+++ b/osu.Game/Screens/Spectate/SpectatorScreen.cs
@@ -57,7 +57,7 @@ namespace osu.Game.Screens.Spectate
         }
 
         [Resolved]
-        private RealmContextFactory realmContextFactory { get; set; }
+        private RealmAccess realm { get; set; }
 
         private IDisposable realmSubscription;
 
@@ -80,7 +80,7 @@ namespace osu.Game.Screens.Spectate
                 playingUserStates.BindTo(spectatorClient.PlayingUserStates);
                 playingUserStates.BindCollectionChanged(onPlayingUserStatesChanged, true);
 
-                realmSubscription = realmContextFactory.RegisterForNotifications(
+                realmSubscription = realm.RegisterForNotifications(
                     realm => realm.All<BeatmapSetInfo>().Where(s => !s.DeletePending), beatmapsChanged);
 
                 foreach ((int id, var _) in userMap)
diff --git a/osu.Game/Skinning/Skin.cs b/osu.Game/Skinning/Skin.cs
index d606d94b97..3685a26e26 100644
--- a/osu.Game/Skinning/Skin.cs
+++ b/osu.Game/Skinning/Skin.cs
@@ -43,8 +43,8 @@ namespace osu.Game.Skinning
 
         protected Skin(SkinInfo skin, IStorageResourceProvider resources, [CanBeNull] Stream configurationStream = null)
         {
-            SkinInfo = resources?.RealmContextFactory != null
-                ? skin.ToLive(resources.RealmContextFactory)
+            SkinInfo = resources?.RealmAccess != null
+                ? skin.ToLive(resources.RealmAccess)
                 // This path should only be used in some tests.
                 : skin.ToLiveUnmanaged();
 
diff --git a/osu.Game/Skinning/SkinManager.cs b/osu.Game/Skinning/SkinManager.cs
index 82bcd3b292..66956325da 100644
--- a/osu.Game/Skinning/SkinManager.cs
+++ b/osu.Game/Skinning/SkinManager.cs
@@ -54,7 +54,7 @@ namespace osu.Game.Skinning
         };
 
         private readonly SkinModelManager skinModelManager;
-        private readonly RealmContextFactory contextFactory;
+        private readonly RealmAccess realm;
 
         private readonly IResourceStore<byte[]> userFiles;
 
@@ -68,9 +68,9 @@ namespace osu.Game.Skinning
         /// </summary>
         public Skin DefaultLegacySkin { get; }
 
-        public SkinManager(Storage storage, RealmContextFactory contextFactory, GameHost host, IResourceStore<byte[]> resources, AudioManager audio, Scheduler scheduler)
+        public SkinManager(Storage storage, RealmAccess realm, GameHost host, IResourceStore<byte[]> resources, AudioManager audio, Scheduler scheduler)
         {
-            this.contextFactory = contextFactory;
+            this.realm = realm;
             this.audio = audio;
             this.scheduler = scheduler;
             this.host = host;
@@ -78,7 +78,7 @@ namespace osu.Game.Skinning
 
             userFiles = new StorageBackedResourceStore(storage.GetStorageForDirectory("files"));
 
-            skinModelManager = new SkinModelManager(storage, contextFactory, host, this);
+            skinModelManager = new SkinModelManager(storage, realm, host, this);
 
             var defaultSkins = new[]
             {
@@ -87,7 +87,7 @@ namespace osu.Game.Skinning
             };
 
             // Ensure the default entries are present.
-            contextFactory.Write(realm =>
+            realm.Write(realm =>
             {
                 foreach (var skin in defaultSkins)
                 {
@@ -110,10 +110,10 @@ namespace osu.Game.Skinning
 
         public void SelectRandomSkin()
         {
-            contextFactory.Run(realm =>
+            realm.Run(r =>
             {
                 // choose from only user skins, removing the current selection to ensure a new one is chosen.
-                var randomChoices = realm.All<SkinInfo>().Where(s => !s.DeletePending && s.ID != CurrentSkinInfo.Value.ID).ToArray();
+                var randomChoices = r.All<SkinInfo>().Where(s => !s.DeletePending && s.ID != CurrentSkinInfo.Value.ID).ToArray();
 
                 if (randomChoices.Length == 0)
                 {
@@ -123,7 +123,7 @@ namespace osu.Game.Skinning
 
                 var chosen = randomChoices.ElementAt(RNG.Next(0, randomChoices.Length));
 
-                CurrentSkinInfo.Value = chosen.ToLive(contextFactory);
+                CurrentSkinInfo.Value = chosen.ToLive(realm);
             });
         }
 
@@ -179,7 +179,7 @@ namespace osu.Game.Skinning
         /// <returns>The first result for the provided query, or null if no results were found.</returns>
         public ILive<SkinInfo> Query(Expression<Func<SkinInfo, bool>> query)
         {
-            return contextFactory.Run(realm => realm.All<SkinInfo>().FirstOrDefault(query)?.ToLive(contextFactory));
+            return realm.Run(r => r.All<SkinInfo>().FirstOrDefault(query)?.ToLive(realm));
         }
 
         public event Action SourceChanged;
@@ -234,7 +234,7 @@ namespace osu.Game.Skinning
         AudioManager IStorageResourceProvider.AudioManager => audio;
         IResourceStore<byte[]> IStorageResourceProvider.Resources => resources;
         IResourceStore<byte[]> IStorageResourceProvider.Files => userFiles;
-        RealmContextFactory IStorageResourceProvider.RealmContextFactory => contextFactory;
+        RealmAccess IStorageResourceProvider.RealmAccess => realm;
         IResourceStore<TextureUpload> IStorageResourceProvider.CreateTextureLoaderStore(IResourceStore<byte[]> underlyingStore) => host.CreateTextureLoaderStore(underlyingStore);
 
         #endregion
@@ -289,7 +289,7 @@ namespace osu.Game.Skinning
 
         public void Delete([CanBeNull] Expression<Func<SkinInfo, bool>> filter = null, bool silent = false)
         {
-            contextFactory.Run(realm =>
+            realm.Run(realm =>
             {
                 var items = realm.All<SkinInfo>()
                                  .Where(s => !s.Protected && !s.DeletePending);
diff --git a/osu.Game/Skinning/SkinModelManager.cs b/osu.Game/Skinning/SkinModelManager.cs
index a1926913a9..c93cdb17dd 100644
--- a/osu.Game/Skinning/SkinModelManager.cs
+++ b/osu.Game/Skinning/SkinModelManager.cs
@@ -27,8 +27,8 @@ namespace osu.Game.Skinning
 
         private readonly IStorageResourceProvider skinResources;
 
-        public SkinModelManager(Storage storage, RealmContextFactory contextFactory, GameHost host, IStorageResourceProvider skinResources)
-            : base(storage, contextFactory)
+        public SkinModelManager(Storage storage, RealmAccess realm, GameHost host, IStorageResourceProvider skinResources)
+            : base(storage, realm)
         {
             this.skinResources = skinResources;
 
@@ -205,7 +205,7 @@ namespace osu.Game.Skinning
 
         private void populateMissingHashes()
         {
-            ContextFactory.Run(realm =>
+            Access.Run(realm =>
             {
                 var skinsWithoutHashes = realm.All<SkinInfo>().Where(i => !i.Protected && string.IsNullOrEmpty(i.Hash)).ToArray();
 
diff --git a/osu.Game/Stores/BeatmapImporter.cs b/osu.Game/Stores/BeatmapImporter.cs
index 61178014ef..3d241e795c 100644
--- a/osu.Game/Stores/BeatmapImporter.cs
+++ b/osu.Game/Stores/BeatmapImporter.cs
@@ -44,8 +44,8 @@ namespace osu.Game.Stores
 
         private readonly BeatmapOnlineLookupQueue? onlineLookupQueue;
 
-        protected BeatmapImporter(RealmContextFactory contextFactory, Storage storage, BeatmapOnlineLookupQueue? onlineLookupQueue = null)
-            : base(storage, contextFactory)
+        protected BeatmapImporter(RealmAccess realm, Storage storage, BeatmapOnlineLookupQueue? onlineLookupQueue = null)
+            : base(storage, realm)
         {
             this.onlineLookupQueue = onlineLookupQueue;
         }
@@ -165,7 +165,7 @@ namespace osu.Game.Stores
 
         public override bool IsAvailableLocally(BeatmapSetInfo model)
         {
-            return ContextFactory.Run(realm => realm.All<BeatmapInfo>().Any(b => b.OnlineID == model.OnlineID));
+            return Access.Run(realm => realm.All<BeatmapInfo>().Any(b => b.OnlineID == model.OnlineID));
         }
 
         public override string HumanisedModelName => "beatmap";
diff --git a/osu.Game/Stores/RealmArchiveModelImporter.cs b/osu.Game/Stores/RealmArchiveModelImporter.cs
index 3d8e9f2703..23a860791e 100644
--- a/osu.Game/Stores/RealmArchiveModelImporter.cs
+++ b/osu.Game/Stores/RealmArchiveModelImporter.cs
@@ -59,7 +59,7 @@ namespace osu.Game.Stores
 
         protected readonly RealmFileStore Files;
 
-        protected readonly RealmContextFactory ContextFactory;
+        protected readonly RealmAccess Access;
 
         /// <summary>
         /// Fired when the user requests to view the resulting import.
@@ -71,11 +71,11 @@ namespace osu.Game.Stores
         /// </summary>
         public Action<Notification>? PostNotification { protected get; set; }
 
-        protected RealmArchiveModelImporter(Storage storage, RealmContextFactory contextFactory)
+        protected RealmArchiveModelImporter(Storage storage, RealmAccess realm)
         {
-            ContextFactory = contextFactory;
+            Access = realm;
 
-            Files = new RealmFileStore(contextFactory, storage);
+            Files = new RealmFileStore(realm, storage);
         }
 
         /// <summary>
@@ -320,7 +320,7 @@ namespace osu.Game.Stores
         /// <param name="cancellationToken">An optional cancellation token.</param>
         public virtual Task<ILive<TModel>?> Import(TModel item, ArchiveReader? archive = null, bool lowPriority = false, CancellationToken cancellationToken = default)
         {
-            return ContextFactory.Run(realm =>
+            return Access.Run(realm =>
             {
                 cancellationToken.ThrowIfCancellationRequested();
 
@@ -352,7 +352,7 @@ namespace osu.Game.Stores
                                 transaction.Commit();
                             }
 
-                            return Task.FromResult((ILive<TModel>?)existing.ToLive(ContextFactory));
+                            return Task.FromResult((ILive<TModel>?)existing.ToLive(Access));
                         }
 
                         LogForModel(item, @"Found existing (optimised) but failed pre-check.");
@@ -387,7 +387,7 @@ namespace osu.Game.Stores
                                 existing.DeletePending = false;
                                 transaction.Commit();
 
-                                return Task.FromResult((ILive<TModel>?)existing.ToLive(ContextFactory));
+                                return Task.FromResult((ILive<TModel>?)existing.ToLive(Access));
                             }
 
                             LogForModel(item, @"Found existing but failed re-use check.");
@@ -413,7 +413,7 @@ namespace osu.Game.Stores
                     throw;
                 }
 
-                return Task.FromResult((ILive<TModel>?)item.ToLive(ContextFactory));
+                return Task.FromResult((ILive<TModel>?)item.ToLive(Access));
             });
         }
 
diff --git a/osu.Game/Stores/RealmArchiveModelManager.cs b/osu.Game/Stores/RealmArchiveModelManager.cs
index 115fbf721d..01eb90d6e8 100644
--- a/osu.Game/Stores/RealmArchiveModelManager.cs
+++ b/osu.Game/Stores/RealmArchiveModelManager.cs
@@ -24,10 +24,10 @@ namespace osu.Game.Stores
     {
         private readonly RealmFileStore realmFileStore;
 
-        protected RealmArchiveModelManager(Storage storage, RealmContextFactory contextFactory)
-            : base(storage, contextFactory)
+        protected RealmArchiveModelManager(Storage storage, RealmAccess realm)
+            : base(storage, realm)
         {
-            realmFileStore = new RealmFileStore(contextFactory, storage);
+            realmFileStore = new RealmFileStore(realm, storage);
         }
 
         public void DeleteFile(TModel item, RealmNamedFileUsage file) =>
@@ -45,7 +45,7 @@ namespace osu.Game.Stores
             // This method should be removed as soon as all the surrounding pieces support non-detached operations.
             if (!item.IsManaged)
             {
-                var managed = ContextFactory.Context.Find<TModel>(item.ID);
+                var managed = Access.Context.Find<TModel>(item.ID);
                 managed.Realm.Write(() => operation(managed));
 
                 item.Files.Clear();
@@ -165,7 +165,7 @@ namespace osu.Game.Stores
 
         public bool Delete(TModel item)
         {
-            return ContextFactory.Run(realm =>
+            return Access.Run(realm =>
             {
                 if (!item.IsManaged)
                     item = realm.Find<TModel>(item.ID);
@@ -180,7 +180,7 @@ namespace osu.Game.Stores
 
         public void Undelete(TModel item)
         {
-            ContextFactory.Run(realm =>
+            Access.Run(realm =>
             {
                 if (!item.IsManaged)
                     item = realm.Find<TModel>(item.ID);
diff --git a/osu.Game/Stores/RealmFileStore.cs b/osu.Game/Stores/RealmFileStore.cs
index ca371e29be..5edc1be954 100644
--- a/osu.Game/Stores/RealmFileStore.cs
+++ b/osu.Game/Stores/RealmFileStore.cs
@@ -24,15 +24,15 @@ namespace osu.Game.Stores
     [ExcludeFromDynamicCompile]
     public class RealmFileStore
     {
-        private readonly RealmContextFactory realmFactory;
+        private readonly RealmAccess realm;
 
         public readonly IResourceStore<byte[]> Store;
 
         public readonly Storage Storage;
 
-        public RealmFileStore(RealmContextFactory realmFactory, Storage storage)
+        public RealmFileStore(RealmAccess realm, Storage storage)
         {
-            this.realmFactory = realmFactory;
+            this.realm = realm;
 
             Storage = storage.GetStorageForDirectory(@"files");
             Store = new StorageBackedResourceStore(Storage);
@@ -92,7 +92,7 @@ namespace osu.Game.Stores
             int removedFiles = 0;
 
             // can potentially be run asynchronously, although we will need to consider operation order for disk deletion vs realm removal.
-            realmFactory.Write(realm =>
+            realm.Write(realm =>
             {
                 // TODO: consider using a realm native query to avoid iterating all files (https://github.com/realm/realm-dotnet/issues/2659#issuecomment-927823707)
                 var files = realm.All<RealmFile>().ToList();
diff --git a/osu.Game/Storyboards/Drawables/DrawableStoryboard.cs b/osu.Game/Storyboards/Drawables/DrawableStoryboard.cs
index 3d6240bc98..e6528a83bd 100644
--- a/osu.Game/Storyboards/Drawables/DrawableStoryboard.cs
+++ b/osu.Game/Storyboards/Drawables/DrawableStoryboard.cs
@@ -77,12 +77,12 @@ namespace osu.Game.Storyboards.Drawables
         }
 
         [BackgroundDependencyLoader(true)]
-        private void load(GameplayClock clock, CancellationToken? cancellationToken, GameHost host, RealmContextFactory realmContextFactory)
+        private void load(GameplayClock clock, CancellationToken? cancellationToken, GameHost host, RealmAccess realm)
         {
             if (clock != null)
                 Clock = clock;
 
-            dependencies.Cache(new TextureStore(host.CreateTextureLoaderStore(new RealmFileStore(realmContextFactory, host.Storage).Store), false, scaleAdjust: 1));
+            dependencies.Cache(new TextureStore(host.CreateTextureLoaderStore(new RealmFileStore(realm, host.Storage).Store), false, scaleAdjust: 1));
 
             foreach (var layer in Storyboard.Layers)
             {
diff --git a/osu.Game/Tests/Beatmaps/HitObjectSampleTest.cs b/osu.Game/Tests/Beatmaps/HitObjectSampleTest.cs
index 10cb210f4d..f7e154b5e7 100644
--- a/osu.Game/Tests/Beatmaps/HitObjectSampleTest.cs
+++ b/osu.Game/Tests/Beatmaps/HitObjectSampleTest.cs
@@ -123,7 +123,7 @@ namespace osu.Game.Tests.Beatmaps
         public IResourceStore<byte[]> Files => userSkinResourceStore;
         public new IResourceStore<byte[]> Resources => base.Resources;
         public IResourceStore<TextureUpload> CreateTextureLoaderStore(IResourceStore<byte[]> underlyingStore) => null;
-        RealmContextFactory IStorageResourceProvider.RealmContextFactory => null;
+        RealmAccess IStorageResourceProvider.RealmAccess => null;
 
         #endregion
 
diff --git a/osu.Game/Tests/Visual/EditorTestScene.cs b/osu.Game/Tests/Visual/EditorTestScene.cs
index 6cc009514d..a6cac0ec86 100644
--- a/osu.Game/Tests/Visual/EditorTestScene.cs
+++ b/osu.Game/Tests/Visual/EditorTestScene.cs
@@ -53,7 +53,7 @@ namespace osu.Game.Tests.Visual
             working = CreateWorkingBeatmap(Ruleset.Value);
 
             if (IsolateSavingFromDatabase)
-                Dependencies.CacheAs<BeatmapManager>(testBeatmapManager = new TestBeatmapManager(LocalStorage, ContextFactory, rulesets, null, audio, Resources, host, Beatmap.Default));
+                Dependencies.CacheAs<BeatmapManager>(testBeatmapManager = new TestBeatmapManager(LocalStorage, Access, rulesets, null, audio, Resources, host, Beatmap.Default));
         }
 
         protected override void LoadComplete()
@@ -126,14 +126,14 @@ namespace osu.Game.Tests.Visual
         {
             public WorkingBeatmap TestBeatmap;
 
-            public TestBeatmapManager(Storage storage, RealmContextFactory contextFactory, RulesetStore rulesets, IAPIProvider api, [NotNull] AudioManager audioManager, IResourceStore<byte[]> resources, GameHost host, WorkingBeatmap defaultBeatmap)
-                : base(storage, contextFactory, rulesets, api, audioManager, resources, host, defaultBeatmap)
+            public TestBeatmapManager(Storage storage, RealmAccess realm, RulesetStore rulesets, IAPIProvider api, [NotNull] AudioManager audioManager, IResourceStore<byte[]> resources, GameHost host, WorkingBeatmap defaultBeatmap)
+                : base(storage, realm, rulesets, api, audioManager, resources, host, defaultBeatmap)
             {
             }
 
-            protected override BeatmapModelManager CreateBeatmapModelManager(Storage storage, RealmContextFactory contextFactory, RulesetStore rulesets, BeatmapOnlineLookupQueue onlineLookupQueue)
+            protected override BeatmapModelManager CreateBeatmapModelManager(Storage storage, RealmAccess realm, RulesetStore rulesets, BeatmapOnlineLookupQueue onlineLookupQueue)
             {
-                return new TestBeatmapModelManager(storage, contextFactory, rulesets, onlineLookupQueue);
+                return new TestBeatmapModelManager(storage, realm, rulesets, onlineLookupQueue);
             }
 
             protected override WorkingBeatmapCache CreateWorkingBeatmapCache(AudioManager audioManager, IResourceStore<byte[]> resources, IResourceStore<byte[]> storage, WorkingBeatmap defaultBeatmap, GameHost host)
@@ -157,8 +157,8 @@ namespace osu.Game.Tests.Visual
 
             internal class TestBeatmapModelManager : BeatmapModelManager
             {
-                public TestBeatmapModelManager(Storage storage, RealmContextFactory databaseContextFactory, RulesetStore rulesetStore, BeatmapOnlineLookupQueue beatmapOnlineLookupQueue)
-                    : base(databaseContextFactory, storage, beatmapOnlineLookupQueue)
+                public TestBeatmapModelManager(Storage storage, RealmAccess databaseAccess, RulesetStore rulesetStore, BeatmapOnlineLookupQueue beatmapOnlineLookupQueue)
+                    : base(databaseAccess, storage, beatmapOnlineLookupQueue)
                 {
                 }
 
diff --git a/osu.Game/Tests/Visual/OsuTestScene.cs b/osu.Game/Tests/Visual/OsuTestScene.cs
index da8af49158..33dd1d45b8 100644
--- a/osu.Game/Tests/Visual/OsuTestScene.cs
+++ b/osu.Game/Tests/Visual/OsuTestScene.cs
@@ -75,9 +75,9 @@ namespace osu.Game.Tests.Visual
         /// <remarks>
         /// In interactive runs (ie. VisualTests) this will use the user's database if <see cref="UseFreshStoragePerRun"/> is not set to <c>true</c>.
         /// </remarks>
-        protected RealmContextFactory ContextFactory => contextFactory.Value;
+        protected RealmAccess Access => contextFactory.Value;
 
-        private Lazy<RealmContextFactory> contextFactory;
+        private Lazy<RealmAccess> contextFactory;
 
         /// <summary>
         /// Whether a fresh storage should be initialised per test (method) run.
@@ -119,7 +119,7 @@ namespace osu.Game.Tests.Visual
 
             Resources = parent.Get<OsuGameBase>().Resources;
 
-            contextFactory = new Lazy<RealmContextFactory>(() => new RealmContextFactory(LocalStorage, "client"));
+            contextFactory = new Lazy<RealmAccess>(() => new RealmAccess(LocalStorage, "client"));
 
             RecycleLocalStorage(false);
 
diff --git a/osu.Game/Tests/Visual/SkinnableTestScene.cs b/osu.Game/Tests/Visual/SkinnableTestScene.cs
index a080f47d66..cd675e467b 100644
--- a/osu.Game/Tests/Visual/SkinnableTestScene.cs
+++ b/osu.Game/Tests/Visual/SkinnableTestScene.cs
@@ -159,7 +159,7 @@ namespace osu.Game.Tests.Visual
         public IResourceStore<byte[]> Files => null;
         public new IResourceStore<byte[]> Resources => base.Resources;
         public IResourceStore<TextureUpload> CreateTextureLoaderStore(IResourceStore<byte[]> underlyingStore) => host.CreateTextureLoaderStore(underlyingStore);
-        RealmContextFactory IStorageResourceProvider.RealmContextFactory => null;
+        RealmAccess IStorageResourceProvider.RealmAccess => null;
 
         #endregion
 

From f30894840c709505464cc2b903f4a8870feb7fd4 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 24 Jan 2022 20:11:36 +0900
Subject: [PATCH 2454/5547] Update terminology to realm "instance" rather than
 "context"

This matches the terminology used by realm themselves, which feels
better.
---
 osu.Game.Tests/Database/FileStoreTests.cs     |   8 +-
 .../TestSceneChangeAndUseGameplayBindings.cs  |   2 +-
 osu.Game/Database/RealmAccess.cs              | 131 ++++++++----------
 osu.Game/Stores/RealmArchiveModelManager.cs   |   2 +-
 4 files changed, 67 insertions(+), 76 deletions(-)

diff --git a/osu.Game.Tests/Database/FileStoreTests.cs b/osu.Game.Tests/Database/FileStoreTests.cs
index 008aa3d833..98b0ed99b5 100644
--- a/osu.Game.Tests/Database/FileStoreTests.cs
+++ b/osu.Game.Tests/Database/FileStoreTests.cs
@@ -21,7 +21,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealm((realmAccess, storage) =>
             {
-                var realm = realmAccess.Context;
+                var realm = realmAccess.Realm;
                 var files = new RealmFileStore(realmAccess, storage);
 
                 var testData = new MemoryStream(new byte[] { 0, 1, 2, 3 });
@@ -38,7 +38,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealm((realmAccess, storage) =>
             {
-                var realm = realmAccess.Context;
+                var realm = realmAccess.Realm;
                 var files = new RealmFileStore(realmAccess, storage);
 
                 var testData = new MemoryStream(new byte[] { 0, 1, 2, 3 });
@@ -55,7 +55,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealm((realmAccess, storage) =>
             {
-                var realm = realmAccess.Context;
+                var realm = realmAccess.Realm;
                 var files = new RealmFileStore(realmAccess, storage);
 
                 var file = realm.Write(() => files.Add(new MemoryStream(new byte[] { 0, 1, 2, 3 }), realm));
@@ -94,7 +94,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealm((realmAccess, storage) =>
             {
-                var realm = realmAccess.Context;
+                var realm = realmAccess.Realm;
                 var files = new RealmFileStore(realmAccess, storage);
 
                 var file = realm.Write(() => files.Add(new MemoryStream(new byte[] { 0, 1, 2, 3 }), realm));
diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneChangeAndUseGameplayBindings.cs b/osu.Game.Tests/Visual/Navigation/TestSceneChangeAndUseGameplayBindings.cs
index 7cb29895eb..bfcefdbbfe 100644
--- a/osu.Game.Tests/Visual/Navigation/TestSceneChangeAndUseGameplayBindings.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneChangeAndUseGameplayBindings.cs
@@ -76,7 +76,7 @@ namespace osu.Game.Tests.Visual.Navigation
                                                        .ChildrenOfType<KeyBindingPanel>().SingleOrDefault();
 
         private RealmKeyBinding firstOsuRulesetKeyBindings => Game.Dependencies
-                                                                  .Get<RealmAccess>().Context
+                                                                  .Get<RealmAccess>().Realm
                                                                   .All<RealmKeyBinding>()
                                                                   .AsEnumerable()
                                                                   .First(k => k.RulesetName == "osu" && k.ActionInt == 0);
diff --git a/osu.Game/Database/RealmAccess.cs b/osu.Game/Database/RealmAccess.cs
index 2f397639c9..66b4edbe84 100644
--- a/osu.Game/Database/RealmAccess.cs
+++ b/osu.Game/Database/RealmAccess.cs
@@ -59,9 +59,9 @@ namespace osu.Game.Database
         /// <summary>
         /// Lock object which is held during <see cref="BlockAllOperations"/> sections, blocking context creation during blocking periods.
         /// </summary>
-        private readonly SemaphoreSlim contextCreationLock = new SemaphoreSlim(1);
+        private readonly SemaphoreSlim realmCreationLock = new SemaphoreSlim(1);
 
-        private readonly ThreadLocal<bool> currentThreadCanCreateContexts = new ThreadLocal<bool>();
+        private readonly ThreadLocal<bool> currentThreadCanCreateRealmInstances = new ThreadLocal<bool>();
 
         /// <summary>
         /// Holds a map of functions registered via <see cref="RegisterCustomSubscription"/> and <see cref="RegisterForNotifications{T}"/> and a coinciding action which when triggered,
@@ -81,35 +81,35 @@ namespace osu.Game.Database
         /// </summary>
         private readonly Dictionary<Func<Realm, IDisposable?>, Action> notificationsResetMap = new Dictionary<Func<Realm, IDisposable?>, Action>();
 
-        private static readonly GlobalStatistic<int> contexts_created = GlobalStatistics.Get<int>(@"Realm", @"Contexts (Created)");
+        private static readonly GlobalStatistic<int> realm_instances_created = GlobalStatistics.Get<int>(@"Realm", @"Instances (Created)");
 
-        private readonly object contextLock = new object();
+        private readonly object realmLock = new object();
 
-        private Realm? context;
+        private Realm? updateRealm;
 
-        public Realm Context => ensureUpdateContext();
+        public Realm Realm => ensureUpdateRealm();
 
-        private Realm ensureUpdateContext()
+        private Realm ensureUpdateRealm()
         {
             if (!ThreadSafety.IsUpdateThread)
-                throw new InvalidOperationException(@$"Use {nameof(createContext)} when performing realm operations from a non-update thread");
+                throw new InvalidOperationException(@$"Use {nameof(getRealmInstance)} when performing realm operations from a non-update thread");
 
-            lock (contextLock)
+            lock (realmLock)
             {
-                if (context == null)
+                if (updateRealm == null)
                 {
-                    context = createContext();
-                    Logger.Log(@$"Opened realm ""{context.Config.DatabasePath}"" at version {context.Config.SchemaVersion}");
+                    updateRealm = getRealmInstance();
+
+                    Logger.Log(@$"Opened realm ""{updateRealm.Config.DatabasePath}"" at version {updateRealm.Config.SchemaVersion}");
 
                     // Resubscribe any subscriptions
                     foreach (var action in customSubscriptionsResetMap.Keys)
                         registerSubscription(action);
                 }
 
-                Debug.Assert(context != null);
+                Debug.Assert(updateRealm != null);
 
-                // creating a context will ensure our schema is up-to-date and migrated.
-                return context;
+                return updateRealm;
             }
         }
 
@@ -118,7 +118,7 @@ namespace osu.Game.Database
         private static readonly ThreadLocal<bool> current_thread_subscriptions_allowed = new ThreadLocal<bool>();
 
         /// <summary>
-        /// Construct a new instance of a realm context factory.
+        /// Construct a new instance.
         /// </summary>
         /// <param name="storage">The game storage which will be used to create the realm backing file.</param>
         /// <param name="filename">The filename to use for the realm backing file. A ".realm" extension will be added automatically if not specified.</param>
@@ -137,7 +137,7 @@ namespace osu.Game.Database
 
             try
             {
-                // This method triggers the first `CreateContext` call, which will implicitly run realm migrations and bring the schema up-to-date.
+                // This method triggers the first `getRealmInstance` call, which will implicitly run realm migrations and bring the schema up-to-date.
                 cleanupPendingDeletions();
             }
             catch (Exception e)
@@ -153,7 +153,7 @@ namespace osu.Game.Database
 
         private void cleanupPendingDeletions()
         {
-            using (var realm = createContext())
+            using (var realm = getRealmInstance())
             using (var transaction = realm.BeginWrite())
             {
                 var pendingDeleteScores = realm.All<ScoreInfo>().Where(s => s.DeletePending);
@@ -201,34 +201,28 @@ namespace osu.Game.Database
         /// <summary>
         /// Run work on realm with a return value.
         /// </summary>
-        /// <remarks>
-        /// Handles correct context management automatically.
-        /// </remarks>
         /// <param name="action">The work to run.</param>
         /// <typeparam name="T">The return type.</typeparam>
         public T Run<T>(Func<Realm, T> action)
         {
             if (ThreadSafety.IsUpdateThread)
-                return action(Context);
+                return action(Realm);
 
-            using (var realm = createContext())
+            using (var realm = getRealmInstance())
                 return action(realm);
         }
 
         /// <summary>
         /// Run work on realm.
         /// </summary>
-        /// <remarks>
-        /// Handles correct context management automatically.
-        /// </remarks>
         /// <param name="action">The work to run.</param>
         public void Run(Action<Realm> action)
         {
             if (ThreadSafety.IsUpdateThread)
-                action(Context);
+                action(Realm);
             else
             {
-                using (var realm = createContext())
+                using (var realm = getRealmInstance())
                     action(realm);
             }
         }
@@ -236,17 +230,14 @@ namespace osu.Game.Database
         /// <summary>
         /// Write changes to realm.
         /// </summary>
-        /// <remarks>
-        /// Handles correct context management and transaction committing automatically.
-        /// </remarks>
         /// <param name="action">The work to run.</param>
         public void Write(Action<Realm> action)
         {
             if (ThreadSafety.IsUpdateThread)
-                Context.Write(action);
+                Realm.Write(action);
             else
             {
-                using (var realm = createContext())
+                using (var realm = getRealmInstance())
                     realm.Write(action);
             }
         }
@@ -257,10 +248,10 @@ namespace osu.Game.Database
         /// <remarks>
         /// This adds osu! specific thread and managed state safety checks on top of <see cref="IRealmCollection{T}.SubscribeForNotifications"/>.
         ///
-        /// In addition to the documented realm behaviour, we have the additional requirement of handling subscriptions over potential context loss.
+        /// In addition to the documented realm behaviour, we have the additional requirement of handling subscriptions over potential realm instance recycle.
         /// When this happens, callback events will be automatically fired:
-        /// - On context loss, a callback with an empty collection and <c>null</c> <see cref="ChangeSet"/> will be invoked.
-        /// - On context revival, a standard initial realm callback will arrive, with <c>null</c> <see cref="ChangeSet"/> and an up-to-date collection.
+        /// - On recycle start, a callback with an empty collection and <c>null</c> <see cref="ChangeSet"/> will be invoked.
+        /// - On recycle end, a standard initial realm callback will arrive, with <c>null</c> <see cref="ChangeSet"/> and an up-to-date collection.
         /// </remarks>
         /// <param name="query">The <see cref="IQueryable{T}"/> to observe for changes.</param>
         /// <typeparam name="T">Type of the elements in the list.</typeparam>
@@ -276,7 +267,7 @@ namespace osu.Game.Database
             if (!ThreadSafety.IsUpdateThread)
                 throw new InvalidOperationException(@$"{nameof(RegisterForNotifications)} must be called from the update thread.");
 
-            lock (contextLock)
+            lock (realmLock)
             {
                 Func<Realm, IDisposable?> action = realm => query(realm).QueryAsyncWithNotifications(callback);
 
@@ -287,7 +278,7 @@ namespace osu.Game.Database
         }
 
         /// <summary>
-        /// Run work on realm that will be run every time the update thread realm context gets recycled.
+        /// Run work on realm that will be run every time the update thread realm instance gets recycled.
         /// </summary>
         /// <param name="action">The work to run. Return value should be an <see cref="IDisposable"/> from QueryAsyncWithNotifications, or an <see cref="InvokeOnDisposal"/> to clean up any bindings.</param>
         /// <returns>An <see cref="IDisposable"/> which should be disposed to unsubscribe any inner subscription.</returns>
@@ -311,7 +302,7 @@ namespace osu.Game.Database
 
                 void unsubscribe()
                 {
-                    lock (contextLock)
+                    lock (realmLock)
                     {
                         if (customSubscriptionsResetMap.TryGetValue(action, out var unsubscriptionAction))
                         {
@@ -328,12 +319,12 @@ namespace osu.Game.Database
         {
             Debug.Assert(ThreadSafety.IsUpdateThread);
 
-            lock (contextLock)
+            lock (realmLock)
             {
-                // Retrieve context outside of flag update to ensure that the context is constructed,
+                // Retrieve realm instance outside of flag update to ensure that the instance is retrieved,
                 // as attempting to access it inside the subscription if it's not constructed would lead to
                 // cyclic invocations of the subscription callback.
-                var realm = Context;
+                var realm = Realm;
 
                 Debug.Assert(!customSubscriptionsResetMap.TryGetValue(action, out var found) || found == null);
 
@@ -344,12 +335,12 @@ namespace osu.Game.Database
         }
 
         /// <summary>
-        /// Unregister all subscriptions when the realm context is to be recycled.
-        /// Subscriptions will still remain and will be re-subscribed when the realm context returns.
+        /// Unregister all subscriptions when the realm instance is to be recycled.
+        /// Subscriptions will still remain and will be re-subscribed when the realm instance returns.
         /// </summary>
         private void unregisterAllSubscriptions()
         {
-            lock (contextLock)
+            lock (realmLock)
             {
                 foreach (var action in notificationsResetMap.Values)
                     action();
@@ -362,7 +353,7 @@ namespace osu.Game.Database
             }
         }
 
-        private Realm createContext()
+        private Realm getRealmInstance()
         {
             if (isDisposed)
                 throw new ObjectDisposedException(nameof(RealmAccess));
@@ -371,20 +362,20 @@ namespace osu.Game.Database
 
             try
             {
-                if (!currentThreadCanCreateContexts.Value)
+                if (!currentThreadCanCreateRealmInstances.Value)
                 {
-                    contextCreationLock.Wait();
-                    currentThreadCanCreateContexts.Value = true;
+                    realmCreationLock.Wait();
+                    currentThreadCanCreateRealmInstances.Value = true;
                     tookSemaphoreLock = true;
                 }
                 else
                 {
-                    // the semaphore is used to handle blocking of all context creation during certain periods.
-                    // once the semaphore has been taken by this code section, it is safe to create further contexts on the same thread.
-                    // this can happen if a realm subscription is active and triggers a callback which has user code that calls `CreateContext`.
+                    // the semaphore is used to handle blocking of all realm retrieval during certain periods.
+                    // once the semaphore has been taken by this code section, it is safe to retrieve further realm instances on the same thread.
+                    // this can happen if a realm subscription is active and triggers a callback which has user code that calls `Run`.
                 }
 
-                contexts_created.Value++;
+                realm_instances_created.Value++;
 
                 return Realm.GetInstance(getConfiguration());
             }
@@ -392,8 +383,8 @@ namespace osu.Game.Database
             {
                 if (tookSemaphoreLock)
                 {
-                    contextCreationLock.Release();
-                    currentThreadCanCreateContexts.Value = false;
+                    realmCreationLock.Release();
+                    currentThreadCanCreateRealmInstances.Value = false;
                 }
             }
         }
@@ -582,7 +573,7 @@ namespace osu.Game.Database
         }
 
         /// <summary>
-        /// Flush any active contexts and block any further writes.
+        /// Flush any active realm instances and block any further writes.
         /// </summary>
         /// <remarks>
         /// This should be used in places we need to ensure no ongoing reads/writes are occurring with realm.
@@ -598,14 +589,14 @@ namespace osu.Game.Database
 
             try
             {
-                contextCreationLock.Wait();
+                realmCreationLock.Wait();
 
-                lock (contextLock)
+                lock (realmLock)
                 {
-                    if (context == null)
+                    if (updateRealm == null)
                     {
-                        // null context means the update thread has not yet retrieved its context.
-                        // we don't need to worry about reviving the update context in this case, so don't bother with the SynchronizationContext.
+                        // null realm means the update thread has not yet retrieved its instance.
+                        // we don't need to worry about reviving the update instance in this case, so don't bother with the SynchronizationContext.
                         Debug.Assert(!ThreadSafety.IsUpdateThread);
                     }
                     else
@@ -620,8 +611,8 @@ namespace osu.Game.Database
 
                     Logger.Log(@"Blocking realm operations.", LoggingTarget.Database);
 
-                    context?.Dispose();
-                    context = null;
+                    updateRealm?.Dispose();
+                    updateRealm = null;
                 }
 
                 const int sleep_length = 200;
@@ -648,17 +639,17 @@ namespace osu.Game.Database
             }
             catch
             {
-                contextCreationLock.Release();
+                realmCreationLock.Release();
                 throw;
             }
 
             return new InvokeOnDisposal<RealmAccess>(this, factory =>
             {
-                factory.contextCreationLock.Release();
+                factory.realmCreationLock.Release();
                 Logger.Log(@"Restoring realm operations.", LoggingTarget.Database);
 
                 // Post back to the update thread to revive any subscriptions.
-                syncContext?.Post(_ => ensureUpdateContext(), null);
+                syncContext?.Post(_ => ensureUpdateRealm(), null);
             });
         }
 
@@ -669,16 +660,16 @@ namespace osu.Game.Database
 
         public void Dispose()
         {
-            lock (contextLock)
+            lock (realmLock)
             {
-                context?.Dispose();
+                updateRealm?.Dispose();
             }
 
             if (!isDisposed)
             {
                 // intentionally block context creation indefinitely. this ensures that nothing can start consuming a new context after disposal.
-                contextCreationLock.Wait();
-                contextCreationLock.Dispose();
+                realmCreationLock.Wait();
+                realmCreationLock.Dispose();
 
                 isDisposed = true;
             }
diff --git a/osu.Game/Stores/RealmArchiveModelManager.cs b/osu.Game/Stores/RealmArchiveModelManager.cs
index 01eb90d6e8..00cd1c2958 100644
--- a/osu.Game/Stores/RealmArchiveModelManager.cs
+++ b/osu.Game/Stores/RealmArchiveModelManager.cs
@@ -45,7 +45,7 @@ namespace osu.Game.Stores
             // This method should be removed as soon as all the surrounding pieces support non-detached operations.
             if (!item.IsManaged)
             {
-                var managed = Access.Context.Find<TModel>(item.ID);
+                var managed = Access.Realm.Find<TModel>(item.ID);
                 managed.Realm.Write(() => operation(managed));
 
                 item.Files.Clear();

From 6f4c337a5696ef2e51c10511ceeed873cd0834b3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 24 Jan 2022 20:52:27 +0900
Subject: [PATCH 2455/5547] Fix a failed `BlockAllOperations` leaving update
 realm in unretrieved state

If the operation timed out on..

```csharp
   throw new TimeoutException(@"Took too long to acquire lock");
```

..from an update thread, it would not restore the update context.

The next call would then fail on the assert that ensures a non-null
context in such cases.

Can add test coverage if required.
---
 osu.Game/Database/RealmAccess.cs | 17 +++++++++--------
 1 file changed, 9 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Database/RealmAccess.cs b/osu.Game/Database/RealmAccess.cs
index 66b4edbe84..64063664eb 100644
--- a/osu.Game/Database/RealmAccess.cs
+++ b/osu.Game/Database/RealmAccess.cs
@@ -595,8 +595,8 @@ namespace osu.Game.Database
                 {
                     if (updateRealm == null)
                     {
-                        // null realm means the update thread has not yet retrieved its instance.
-                        // we don't need to worry about reviving the update instance in this case, so don't bother with the SynchronizationContext.
+                        // null context means the update thread has not yet retrieved its context.
+                        // we don't need to worry about reviving the update context in this case, so don't bother with the SynchronizationContext.
                         Debug.Assert(!ThreadSafety.IsUpdateThread);
                     }
                     else
@@ -639,18 +639,19 @@ namespace osu.Game.Database
             }
             catch
             {
-                realmCreationLock.Release();
+                restoreOperation();
                 throw;
             }
 
-            return new InvokeOnDisposal<RealmAccess>(this, factory =>
-            {
-                factory.realmCreationLock.Release();
-                Logger.Log(@"Restoring realm operations.", LoggingTarget.Database);
+            return new InvokeOnDisposal(restoreOperation);
 
+            void restoreOperation()
+            {
+                Logger.Log(@"Restoring realm operations.", LoggingTarget.Database);
+                realmCreationLock.Release();
                 // Post back to the update thread to revive any subscriptions.
                 syncContext?.Post(_ => ensureUpdateRealm(), null);
-            });
+            }
         }
 
         // https://github.com/realm/realm-dotnet/blob/32f4ebcc88b3e80a3b254412665340cd9f3bd6b5/Realm/Realm/Extensions/ReflectionExtensions.cs#L46

From a7c0d507cefa16343475f5aa73a23d666b6b7446 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 24 Jan 2022 20:44:25 +0100
Subject: [PATCH 2456/5547] Rename flashlight settings to be more accurate

---
 .../Mods/CatchModFlashlight.cs                | 20 +++++++++----------
 .../Mods/ManiaModFlashlight.cs                | 20 +++++++++----------
 .../Mods/OsuModFlashlight.cs                  | 20 +++++++++----------
 .../Mods/TaikoModFlashlight.cs                | 20 +++++++++----------
 osu.Game/Rulesets/Mods/ModFlashlight.cs       |  8 ++++----
 5 files changed, 44 insertions(+), 44 deletions(-)

diff --git a/osu.Game.Rulesets.Catch/Mods/CatchModFlashlight.cs b/osu.Game.Rulesets.Catch/Mods/CatchModFlashlight.cs
index d48382a9ee..e7335dcc34 100644
--- a/osu.Game.Rulesets.Catch/Mods/CatchModFlashlight.cs
+++ b/osu.Game.Rulesets.Catch/Mods/CatchModFlashlight.cs
@@ -16,15 +16,8 @@ namespace osu.Game.Rulesets.Catch.Mods
     {
         public override double ScoreMultiplier => 1.12;
 
-        [SettingSource("Change radius based on combo", "Decrease the flashlight radius as combo increases.")]
-        public override BindableBool ChangeRadius { get; } = new BindableBool
-        {
-            Default = true,
-            Value = true
-        };
-
-        [SettingSource("Initial radius", "Initial radius of the flashlight area.")]
-        public override BindableNumber<float> InitialRadius { get; } = new BindableNumber<float>
+        [SettingSource("Flashlight size", "Multiplier applied to the default flashlight size.")]
+        public override BindableNumber<float> SizeMultiplier { get; } = new BindableNumber<float>
         {
             MinValue = 0.4f,
             MaxValue = 1.7f,
@@ -33,9 +26,16 @@ namespace osu.Game.Rulesets.Catch.Mods
             Precision = 0.1f
         };
 
+        [SettingSource("Change size based on combo", "Decrease the flashlight size as combo increases.")]
+        public override BindableBool ComboBasedSize { get; } = new BindableBool
+        {
+            Default = true,
+            Value = true
+        };
+
         protected virtual float DefaultFlashlightSize => 350;
 
-        public override Flashlight CreateFlashlight() => new CatchFlashlight(playfield, ChangeRadius.Value, InitialRadius.Value, DefaultFlashlightSize);
+        public override Flashlight CreateFlashlight() => new CatchFlashlight(playfield, ComboBasedSize.Value, SizeMultiplier.Value, DefaultFlashlightSize);
 
         private CatchPlayfield playfield;
 
diff --git a/osu.Game.Rulesets.Mania/Mods/ManiaModFlashlight.cs b/osu.Game.Rulesets.Mania/Mods/ManiaModFlashlight.cs
index eb3f60edce..f89c131fea 100644
--- a/osu.Game.Rulesets.Mania/Mods/ManiaModFlashlight.cs
+++ b/osu.Game.Rulesets.Mania/Mods/ManiaModFlashlight.cs
@@ -17,15 +17,8 @@ namespace osu.Game.Rulesets.Mania.Mods
         public override double ScoreMultiplier => 1;
         public override Type[] IncompatibleMods => new[] { typeof(ModHidden) };
 
-        [SettingSource("Change radius based on combo", "Decrease the flashlight radius as combo increases.")]
-        public override BindableBool ChangeRadius { get; } = new BindableBool
-        {
-            Default = false,
-            Value = false
-        };
-
-        [SettingSource("Initial radius", "Initial radius of the flashlight area.")]
-        public override BindableNumber<float> InitialRadius { get; } = new BindableNumber<float>
+        [SettingSource("Flashlight size", "Multiplier applied to the default flashlight size.")]
+        public override BindableNumber<float> SizeMultiplier { get; } = new BindableNumber<float>
         {
             MinValue = 0f,
             MaxValue = 4.5f,
@@ -34,9 +27,16 @@ namespace osu.Game.Rulesets.Mania.Mods
             Precision = 0.1f
         };
 
+        [SettingSource("Change size based on combo", "Decrease the flashlight size as combo increases.")]
+        public override BindableBool ComboBasedSize { get; } = new BindableBool
+        {
+            Default = false,
+            Value = false
+        };
+
         protected virtual float DefaultFlashlightSize => 50;
 
-        public override Flashlight CreateFlashlight() => new ManiaFlashlight(ChangeRadius.Value, InitialRadius.Value, DefaultFlashlightSize);
+        public override Flashlight CreateFlashlight() => new ManiaFlashlight(ComboBasedSize.Value, SizeMultiplier.Value, DefaultFlashlightSize);
 
         private class ManiaFlashlight : Flashlight
         {
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModFlashlight.cs b/osu.Game.Rulesets.Osu/Mods/OsuModFlashlight.cs
index 6a9d199c54..bc915591d0 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModFlashlight.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModFlashlight.cs
@@ -30,15 +30,8 @@ namespace osu.Game.Rulesets.Osu.Mods
             Precision = default_follow_delay,
         };
 
-        [SettingSource("Change radius based on combo", "Decrease the flashlight radius as combo increases.")]
-        public override BindableBool ChangeRadius { get; } = new BindableBool
-        {
-            Default = true,
-            Value = true
-        };
-
-        [SettingSource("Initial radius", "Initial radius of the flashlight area.")]
-        public override BindableNumber<float> InitialRadius { get; } = new BindableNumber<float>
+        [SettingSource("Flashlight size", "Multiplier applied to the default flashlight size.")]
+        public override BindableNumber<float> SizeMultiplier { get; } = new BindableNumber<float>
         {
             MinValue = 0.5f,
             MaxValue = 2f,
@@ -47,11 +40,18 @@ namespace osu.Game.Rulesets.Osu.Mods
             Precision = 0.1f
         };
 
+        [SettingSource("Change size based on combo", "Decrease the flashlight size as combo increases.")]
+        public override BindableBool ComboBasedSize { get; } = new BindableBool
+        {
+            Default = true,
+            Value = true
+        };
+
         protected virtual float DefaultFlashlightSize => 180;
 
         private OsuFlashlight flashlight;
 
-        public override Flashlight CreateFlashlight() => flashlight = new OsuFlashlight(ChangeRadius.Value, InitialRadius.Value, FollowDelay.Value, DefaultFlashlightSize);
+        public override Flashlight CreateFlashlight() => flashlight = new OsuFlashlight(ComboBasedSize.Value, SizeMultiplier.Value, FollowDelay.Value, DefaultFlashlightSize);
 
         public void ApplyToDrawableHitObject(DrawableHitObject drawable)
         {
diff --git a/osu.Game.Rulesets.Taiko/Mods/TaikoModFlashlight.cs b/osu.Game.Rulesets.Taiko/Mods/TaikoModFlashlight.cs
index 8de7c859c4..48e56c8784 100644
--- a/osu.Game.Rulesets.Taiko/Mods/TaikoModFlashlight.cs
+++ b/osu.Game.Rulesets.Taiko/Mods/TaikoModFlashlight.cs
@@ -17,15 +17,8 @@ namespace osu.Game.Rulesets.Taiko.Mods
     {
         public override double ScoreMultiplier => 1.12;
 
-        [SettingSource("Change radius based on combo", "Decrease the flashlight radius as combo increases.")]
-        public override BindableBool ChangeRadius { get; } = new BindableBool
-        {
-            Default = true,
-            Value = true
-        };
-
-        [SettingSource("Initial radius", "Initial radius of the flashlight area.")]
-        public override BindableNumber<float> InitialRadius { get; } = new BindableNumber<float>
+        [SettingSource("Flashlight size", "Multiplier applied to the default flashlight size.")]
+        public override BindableNumber<float> SizeMultiplier { get; } = new BindableNumber<float>
         {
             MinValue = 0,
             MaxValue = 1.66f,
@@ -34,9 +27,16 @@ namespace osu.Game.Rulesets.Taiko.Mods
             Precision = 0.1f
         };
 
+        [SettingSource("Change size based on combo", "Decrease the flashlight size as combo increases.")]
+        public override BindableBool ComboBasedSize { get; } = new BindableBool
+        {
+            Default = true,
+            Value = true
+        };
+
         protected virtual float DefaultFlashlightSize => 250;
 
-        public override Flashlight CreateFlashlight() => new TaikoFlashlight(playfield, ChangeRadius.Value, InitialRadius.Value, DefaultFlashlightSize);
+        public override Flashlight CreateFlashlight() => new TaikoFlashlight(playfield, ComboBasedSize.Value, SizeMultiplier.Value, DefaultFlashlightSize);
 
         private TaikoPlayfield playfield;
 
diff --git a/osu.Game/Rulesets/Mods/ModFlashlight.cs b/osu.Game/Rulesets/Mods/ModFlashlight.cs
index 531ee92b7a..d3998bcad4 100644
--- a/osu.Game/Rulesets/Mods/ModFlashlight.cs
+++ b/osu.Game/Rulesets/Mods/ModFlashlight.cs
@@ -33,11 +33,11 @@ namespace osu.Game.Rulesets.Mods
         public override ModType Type => ModType.DifficultyIncrease;
         public override string Description => "Restricted view area.";
 
-        [SettingSource("Change radius based on combo", "Decrease the flashlight radius as combo increases.")]
-        public abstract BindableBool ChangeRadius { get; }
+        [SettingSource("Flashlight size", "Multiplier applied to the default flashlight size.")]
+        public abstract BindableNumber<float> SizeMultiplier { get; }
 
-        [SettingSource("Initial radius", "Initial radius of the flashlight area.")]
-        public abstract BindableNumber<float> InitialRadius { get; }
+        [SettingSource("Change size based on combo", "Decrease the flashlight size as combo increases.")]
+        public abstract BindableBool ComboBasedSize { get; }
     }
 
     public abstract class ModFlashlight<T> : ModFlashlight, IApplicableToDrawableRuleset<T>, IApplicableToScoreProcessor

From 5874475dffbc5ba6d1bf620d07e026360858a3a7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 24 Jan 2022 20:46:54 +0100
Subject: [PATCH 2457/5547] Extract `DefaultFlashlightSize` to base flashlight
 class

---
 osu.Game.Rulesets.Catch/Mods/CatchModFlashlight.cs | 2 +-
 osu.Game.Rulesets.Mania/Mods/ManiaModFlashlight.cs | 2 +-
 osu.Game.Rulesets.Osu/Mods/OsuModFlashlight.cs     | 2 +-
 osu.Game.Rulesets.Taiko/Mods/TaikoModFlashlight.cs | 2 +-
 osu.Game/Rulesets/Mods/ModFlashlight.cs            | 6 ++++++
 5 files changed, 10 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Rulesets.Catch/Mods/CatchModFlashlight.cs b/osu.Game.Rulesets.Catch/Mods/CatchModFlashlight.cs
index e7335dcc34..4c5dcf84d2 100644
--- a/osu.Game.Rulesets.Catch/Mods/CatchModFlashlight.cs
+++ b/osu.Game.Rulesets.Catch/Mods/CatchModFlashlight.cs
@@ -33,7 +33,7 @@ namespace osu.Game.Rulesets.Catch.Mods
             Value = true
         };
 
-        protected virtual float DefaultFlashlightSize => 350;
+        public override float DefaultFlashlightSize => 350;
 
         public override Flashlight CreateFlashlight() => new CatchFlashlight(playfield, ComboBasedSize.Value, SizeMultiplier.Value, DefaultFlashlightSize);
 
diff --git a/osu.Game.Rulesets.Mania/Mods/ManiaModFlashlight.cs b/osu.Game.Rulesets.Mania/Mods/ManiaModFlashlight.cs
index f89c131fea..03be00c5db 100644
--- a/osu.Game.Rulesets.Mania/Mods/ManiaModFlashlight.cs
+++ b/osu.Game.Rulesets.Mania/Mods/ManiaModFlashlight.cs
@@ -34,7 +34,7 @@ namespace osu.Game.Rulesets.Mania.Mods
             Value = false
         };
 
-        protected virtual float DefaultFlashlightSize => 50;
+        public override float DefaultFlashlightSize => 50;
 
         public override Flashlight CreateFlashlight() => new ManiaFlashlight(ComboBasedSize.Value, SizeMultiplier.Value, DefaultFlashlightSize);
 
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModFlashlight.cs b/osu.Game.Rulesets.Osu/Mods/OsuModFlashlight.cs
index bc915591d0..f344bb017e 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModFlashlight.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModFlashlight.cs
@@ -47,7 +47,7 @@ namespace osu.Game.Rulesets.Osu.Mods
             Value = true
         };
 
-        protected virtual float DefaultFlashlightSize => 180;
+        public override float DefaultFlashlightSize => 180;
 
         private OsuFlashlight flashlight;
 
diff --git a/osu.Game.Rulesets.Taiko/Mods/TaikoModFlashlight.cs b/osu.Game.Rulesets.Taiko/Mods/TaikoModFlashlight.cs
index 48e56c8784..576fbb65a0 100644
--- a/osu.Game.Rulesets.Taiko/Mods/TaikoModFlashlight.cs
+++ b/osu.Game.Rulesets.Taiko/Mods/TaikoModFlashlight.cs
@@ -34,7 +34,7 @@ namespace osu.Game.Rulesets.Taiko.Mods
             Value = true
         };
 
-        protected virtual float DefaultFlashlightSize => 250;
+        public override float DefaultFlashlightSize => 250;
 
         public override Flashlight CreateFlashlight() => new TaikoFlashlight(playfield, ComboBasedSize.Value, SizeMultiplier.Value, DefaultFlashlightSize);
 
diff --git a/osu.Game/Rulesets/Mods/ModFlashlight.cs b/osu.Game/Rulesets/Mods/ModFlashlight.cs
index d3998bcad4..f2fd86d549 100644
--- a/osu.Game/Rulesets/Mods/ModFlashlight.cs
+++ b/osu.Game/Rulesets/Mods/ModFlashlight.cs
@@ -38,6 +38,12 @@ namespace osu.Game.Rulesets.Mods
 
         [SettingSource("Change size based on combo", "Decrease the flashlight size as combo increases.")]
         public abstract BindableBool ComboBasedSize { get; }
+
+        /// <summary>
+        /// The default size of the flashlight in ruleset-appropriate dimensions.
+        /// <see cref="SizeMultiplier"/> and <see cref="ComboBasedSize"/> will apply their adjustments on top of this size.
+        /// </summary>
+        public abstract float DefaultFlashlightSize { get; }
     }
 
     public abstract class ModFlashlight<T> : ModFlashlight, IApplicableToDrawableRuleset<T>, IApplicableToScoreProcessor

From a227af75edb70a847aac468c47371bacc4d3d49f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 24 Jan 2022 20:55:24 +0100
Subject: [PATCH 2458/5547] Simplify flashlight parameter passing flow

---
 .../Mods/CatchModFlashlight.cs                | 10 +++----
 .../Mods/ManiaModFlashlight.cs                | 10 +++----
 .../Mods/OsuModFlashlight.cs                  | 19 +++++-------
 .../Mods/TaikoModFlashlight.cs                |  8 ++---
 osu.Game/Rulesets/Mods/ModFlashlight.cs       | 30 +++++++++----------
 5 files changed, 37 insertions(+), 40 deletions(-)

diff --git a/osu.Game.Rulesets.Catch/Mods/CatchModFlashlight.cs b/osu.Game.Rulesets.Catch/Mods/CatchModFlashlight.cs
index 4c5dcf84d2..6bd914de33 100644
--- a/osu.Game.Rulesets.Catch/Mods/CatchModFlashlight.cs
+++ b/osu.Game.Rulesets.Catch/Mods/CatchModFlashlight.cs
@@ -35,7 +35,7 @@ namespace osu.Game.Rulesets.Catch.Mods
 
         public override float DefaultFlashlightSize => 350;
 
-        public override Flashlight CreateFlashlight() => new CatchFlashlight(playfield, ComboBasedSize.Value, SizeMultiplier.Value, DefaultFlashlightSize);
+        protected override Flashlight CreateFlashlight() => new CatchFlashlight(this, playfield);
 
         private CatchPlayfield playfield;
 
@@ -49,11 +49,11 @@ namespace osu.Game.Rulesets.Catch.Mods
         {
             private readonly CatchPlayfield playfield;
 
-            public CatchFlashlight(CatchPlayfield playfield, bool isRadiusBasedOnCombo, float initialRadius, float defaultFlashlightSize)
-                : base(isRadiusBasedOnCombo, initialRadius, defaultFlashlightSize)
+            public CatchFlashlight(CatchModFlashlight modFlashlight, CatchPlayfield playfield)
+                : base(modFlashlight)
             {
                 this.playfield = playfield;
-                FlashlightSize = new Vector2(0, GetRadiusFor(0));
+                FlashlightSize = new Vector2(0, GetSizeFor(0));
             }
 
             protected override void Update()
@@ -65,7 +65,7 @@ namespace osu.Game.Rulesets.Catch.Mods
 
             protected override void OnComboChange(ValueChangedEvent<int> e)
             {
-                this.TransformTo(nameof(FlashlightSize), new Vector2(0, GetRadiusFor(e.NewValue)), FLASHLIGHT_FADE_DURATION);
+                this.TransformTo(nameof(FlashlightSize), new Vector2(0, GetSizeFor(e.NewValue)), FLASHLIGHT_FADE_DURATION);
             }
 
             protected override string FragmentShader => "CircularFlashlight";
diff --git a/osu.Game.Rulesets.Mania/Mods/ManiaModFlashlight.cs b/osu.Game.Rulesets.Mania/Mods/ManiaModFlashlight.cs
index 03be00c5db..def3f8b274 100644
--- a/osu.Game.Rulesets.Mania/Mods/ManiaModFlashlight.cs
+++ b/osu.Game.Rulesets.Mania/Mods/ManiaModFlashlight.cs
@@ -36,16 +36,16 @@ namespace osu.Game.Rulesets.Mania.Mods
 
         public override float DefaultFlashlightSize => 50;
 
-        public override Flashlight CreateFlashlight() => new ManiaFlashlight(ComboBasedSize.Value, SizeMultiplier.Value, DefaultFlashlightSize);
+        protected override Flashlight CreateFlashlight() => new ManiaFlashlight(this);
 
         private class ManiaFlashlight : Flashlight
         {
             private readonly LayoutValue flashlightProperties = new LayoutValue(Invalidation.DrawSize);
 
-            public ManiaFlashlight(bool isRadiusBasedOnCombo, float initialRadius, float defaultFlashlightSize)
-                : base(isRadiusBasedOnCombo, initialRadius, defaultFlashlightSize)
+            public ManiaFlashlight(ManiaModFlashlight modFlashlight)
+                : base(modFlashlight)
             {
-                FlashlightSize = new Vector2(DrawWidth, GetRadiusFor(0));
+                FlashlightSize = new Vector2(DrawWidth, GetSizeFor(0));
 
                 AddLayout(flashlightProperties);
             }
@@ -65,7 +65,7 @@ namespace osu.Game.Rulesets.Mania.Mods
 
             protected override void OnComboChange(ValueChangedEvent<int> e)
             {
-                this.TransformTo(nameof(FlashlightSize), new Vector2(DrawWidth, GetRadiusFor(e.NewValue)), FLASHLIGHT_FADE_DURATION);
+                this.TransformTo(nameof(FlashlightSize), new Vector2(DrawWidth, GetSizeFor(e.NewValue)), FLASHLIGHT_FADE_DURATION);
             }
 
             protected override string FragmentShader => "RectangularFlashlight";
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModFlashlight.cs b/osu.Game.Rulesets.Osu/Mods/OsuModFlashlight.cs
index f344bb017e..b4eff57c55 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModFlashlight.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModFlashlight.cs
@@ -51,7 +51,7 @@ namespace osu.Game.Rulesets.Osu.Mods
 
         private OsuFlashlight flashlight;
 
-        public override Flashlight CreateFlashlight() => flashlight = new OsuFlashlight(ComboBasedSize.Value, SizeMultiplier.Value, FollowDelay.Value, DefaultFlashlightSize);
+        protected override Flashlight CreateFlashlight() => flashlight = new OsuFlashlight(this);
 
         public void ApplyToDrawableHitObject(DrawableHitObject drawable)
         {
@@ -61,17 +61,14 @@ namespace osu.Game.Rulesets.Osu.Mods
 
         private class OsuFlashlight : Flashlight, IRequireHighFrequencyMousePosition
         {
-            public double FollowDelay { private get; set; }
+            private readonly double followDelay;
 
-            //public float InitialRadius { private get; set; }
-            public bool ChangeRadius { private get; set; }
-
-            public OsuFlashlight(bool isRadiusBasedOnCombo, float initialRadius, double followDelay, float defaultFlashlightSize)
-                : base(isRadiusBasedOnCombo, initialRadius, defaultFlashlightSize)
+            public OsuFlashlight(OsuModFlashlight modFlashlight)
+                : base(modFlashlight)
             {
-                FollowDelay = followDelay;
+                followDelay = modFlashlight.FollowDelay.Value;
 
-                FlashlightSize = new Vector2(0, GetRadiusFor(0));
+                FlashlightSize = new Vector2(0, GetSizeFor(0));
             }
 
             public void OnSliderTrackingChange(ValueChangedEvent<bool> e)
@@ -86,14 +83,14 @@ namespace osu.Game.Rulesets.Osu.Mods
                 var destination = e.MousePosition;
 
                 FlashlightPosition = Interpolation.ValueAt(
-                    Math.Min(Math.Abs(Clock.ElapsedFrameTime), FollowDelay), position, destination, 0, FollowDelay, Easing.Out);
+                    Math.Min(Math.Abs(Clock.ElapsedFrameTime), followDelay), position, destination, 0, followDelay, Easing.Out);
 
                 return base.OnMouseMove(e);
             }
 
             protected override void OnComboChange(ValueChangedEvent<int> e)
             {
-                this.TransformTo(nameof(FlashlightSize), new Vector2(0, GetRadiusFor(e.NewValue)), FLASHLIGHT_FADE_DURATION);
+                this.TransformTo(nameof(FlashlightSize), new Vector2(0, GetSizeFor(e.NewValue)), FLASHLIGHT_FADE_DURATION);
             }
 
             protected override string FragmentShader => "CircularFlashlight";
diff --git a/osu.Game.Rulesets.Taiko/Mods/TaikoModFlashlight.cs b/osu.Game.Rulesets.Taiko/Mods/TaikoModFlashlight.cs
index 576fbb65a0..84444dded9 100644
--- a/osu.Game.Rulesets.Taiko/Mods/TaikoModFlashlight.cs
+++ b/osu.Game.Rulesets.Taiko/Mods/TaikoModFlashlight.cs
@@ -36,7 +36,7 @@ namespace osu.Game.Rulesets.Taiko.Mods
 
         public override float DefaultFlashlightSize => 250;
 
-        public override Flashlight CreateFlashlight() => new TaikoFlashlight(playfield, ComboBasedSize.Value, SizeMultiplier.Value, DefaultFlashlightSize);
+        protected override Flashlight CreateFlashlight() => new TaikoFlashlight(this, playfield);
 
         private TaikoPlayfield playfield;
 
@@ -51,8 +51,8 @@ namespace osu.Game.Rulesets.Taiko.Mods
             private readonly LayoutValue flashlightProperties = new LayoutValue(Invalidation.DrawSize);
             private readonly TaikoPlayfield taikoPlayfield;
 
-            public TaikoFlashlight(TaikoPlayfield taikoPlayfield, bool isRadiusBasedOnCombo, float initialRadius, float defaultFlashlightSize)
-                : base(isRadiusBasedOnCombo, initialRadius, defaultFlashlightSize)
+            public TaikoFlashlight(TaikoModFlashlight modFlashlight, TaikoPlayfield taikoPlayfield)
+                : base(modFlashlight)
             {
                 this.taikoPlayfield = taikoPlayfield;
                 FlashlightSize = getSizeFor(0);
@@ -63,7 +63,7 @@ namespace osu.Game.Rulesets.Taiko.Mods
             private Vector2 getSizeFor(int combo)
             {
                 // Preserve flashlight size through the playfield's aspect adjustment.
-                return new Vector2(0, GetRadiusFor(combo) * taikoPlayfield.DrawHeight / TaikoPlayfield.DEFAULT_HEIGHT);
+                return new Vector2(0, GetSizeFor(combo) * taikoPlayfield.DrawHeight / TaikoPlayfield.DEFAULT_HEIGHT);
             }
 
             protected override void OnComboChange(ValueChangedEvent<int> e)
diff --git a/osu.Game/Rulesets/Mods/ModFlashlight.cs b/osu.Game/Rulesets/Mods/ModFlashlight.cs
index f2fd86d549..e6487c6b29 100644
--- a/osu.Game/Rulesets/Mods/ModFlashlight.cs
+++ b/osu.Game/Rulesets/Mods/ModFlashlight.cs
@@ -88,7 +88,7 @@ namespace osu.Game.Rulesets.Mods
             flashlight.Breaks = drawableRuleset.Beatmap.Breaks;
         }
 
-        public abstract Flashlight CreateFlashlight();
+        protected abstract Flashlight CreateFlashlight();
 
         public abstract class Flashlight : Drawable
         {
@@ -102,17 +102,15 @@ namespace osu.Game.Rulesets.Mods
 
             public List<BreakPeriod> Breaks;
 
-            public readonly bool IsRadiusBasedOnCombo;
+            private readonly float defaultFlashlightSize;
+            private readonly float sizeMultiplier;
+            private readonly bool comboBasedSize;
 
-            public readonly float InitialRadius;
-
-            public readonly float DefaultFlashlightSize;
-
-            protected Flashlight(bool isRadiusBasedOnCombo, float initialRadius, float defaultFlashlightSize)
+            protected Flashlight(ModFlashlight modFlashlight)
             {
-                IsRadiusBasedOnCombo = isRadiusBasedOnCombo;
-                InitialRadius = initialRadius;
-                DefaultFlashlightSize = defaultFlashlightSize;
+                defaultFlashlightSize = modFlashlight.DefaultFlashlightSize;
+                sizeMultiplier = modFlashlight.SizeMultiplier.Value;
+                comboBasedSize = modFlashlight.ComboBasedSize.Value;
             }
 
             [BackgroundDependencyLoader]
@@ -146,17 +144,19 @@ namespace osu.Game.Rulesets.Mods
 
             protected abstract string FragmentShader { get; }
 
-            protected float GetRadiusFor(int combo)
+            protected float GetSizeFor(int combo)
             {
-                if (IsRadiusBasedOnCombo)
+                float size = defaultFlashlightSize * sizeMultiplier;
+
+                if (comboBasedSize)
                 {
                     if (combo > 200)
-                        return InitialRadius * 0.8f * DefaultFlashlightSize;
+                        size *= 0.8f;
                     else if (combo > 100)
-                        return InitialRadius * 0.9f * DefaultFlashlightSize;
+                        size *= 0.9f;
                 }
 
-                return InitialRadius * DefaultFlashlightSize;
+                return size;
             }
 
             private Vector2 flashlightPosition;

From 4a13c93ca7e98c89ba5938c89c1e00a2856c08c1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 24 Jan 2022 20:56:59 +0100
Subject: [PATCH 2459/5547] Disallow zero size multiplier in flashlight
 implementations

---
 osu.Game.Rulesets.Mania/Mods/ManiaModFlashlight.cs | 2 +-
 osu.Game.Rulesets.Taiko/Mods/TaikoModFlashlight.cs | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Rulesets.Mania/Mods/ManiaModFlashlight.cs b/osu.Game.Rulesets.Mania/Mods/ManiaModFlashlight.cs
index def3f8b274..60de063b24 100644
--- a/osu.Game.Rulesets.Mania/Mods/ManiaModFlashlight.cs
+++ b/osu.Game.Rulesets.Mania/Mods/ManiaModFlashlight.cs
@@ -20,7 +20,7 @@ namespace osu.Game.Rulesets.Mania.Mods
         [SettingSource("Flashlight size", "Multiplier applied to the default flashlight size.")]
         public override BindableNumber<float> SizeMultiplier { get; } = new BindableNumber<float>
         {
-            MinValue = 0f,
+            MinValue = 0.1f,
             MaxValue = 4.5f,
             Default = 1f,
             Value = 1f,
diff --git a/osu.Game.Rulesets.Taiko/Mods/TaikoModFlashlight.cs b/osu.Game.Rulesets.Taiko/Mods/TaikoModFlashlight.cs
index 84444dded9..bdb30e9ded 100644
--- a/osu.Game.Rulesets.Taiko/Mods/TaikoModFlashlight.cs
+++ b/osu.Game.Rulesets.Taiko/Mods/TaikoModFlashlight.cs
@@ -20,7 +20,7 @@ namespace osu.Game.Rulesets.Taiko.Mods
         [SettingSource("Flashlight size", "Multiplier applied to the default flashlight size.")]
         public override BindableNumber<float> SizeMultiplier { get; } = new BindableNumber<float>
         {
-            MinValue = 0,
+            MinValue = 0.1f,
             MaxValue = 1.66f,
             Default = 1f,
             Value = 1f,

From 2375420d4cbce1372fd2848b7de799bee2f281b8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 24 Jan 2022 21:16:10 +0100
Subject: [PATCH 2460/5547] Tweak allowable ranges of size multiplier

---
 osu.Game.Rulesets.Catch/Mods/CatchModFlashlight.cs | 4 ++--
 osu.Game.Rulesets.Mania/Mods/ManiaModFlashlight.cs | 4 ++--
 osu.Game.Rulesets.Taiko/Mods/TaikoModFlashlight.cs | 4 ++--
 3 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/osu.Game.Rulesets.Catch/Mods/CatchModFlashlight.cs b/osu.Game.Rulesets.Catch/Mods/CatchModFlashlight.cs
index 6bd914de33..2d92c925d7 100644
--- a/osu.Game.Rulesets.Catch/Mods/CatchModFlashlight.cs
+++ b/osu.Game.Rulesets.Catch/Mods/CatchModFlashlight.cs
@@ -19,8 +19,8 @@ namespace osu.Game.Rulesets.Catch.Mods
         [SettingSource("Flashlight size", "Multiplier applied to the default flashlight size.")]
         public override BindableNumber<float> SizeMultiplier { get; } = new BindableNumber<float>
         {
-            MinValue = 0.4f,
-            MaxValue = 1.7f,
+            MinValue = 0.5f,
+            MaxValue = 1.5f,
             Default = 1f,
             Value = 1f,
             Precision = 0.1f
diff --git a/osu.Game.Rulesets.Mania/Mods/ManiaModFlashlight.cs b/osu.Game.Rulesets.Mania/Mods/ManiaModFlashlight.cs
index 60de063b24..1ee4ea12e3 100644
--- a/osu.Game.Rulesets.Mania/Mods/ManiaModFlashlight.cs
+++ b/osu.Game.Rulesets.Mania/Mods/ManiaModFlashlight.cs
@@ -20,8 +20,8 @@ namespace osu.Game.Rulesets.Mania.Mods
         [SettingSource("Flashlight size", "Multiplier applied to the default flashlight size.")]
         public override BindableNumber<float> SizeMultiplier { get; } = new BindableNumber<float>
         {
-            MinValue = 0.1f,
-            MaxValue = 4.5f,
+            MinValue = 0.5f,
+            MaxValue = 3f,
             Default = 1f,
             Value = 1f,
             Precision = 0.1f
diff --git a/osu.Game.Rulesets.Taiko/Mods/TaikoModFlashlight.cs b/osu.Game.Rulesets.Taiko/Mods/TaikoModFlashlight.cs
index bdb30e9ded..fb07c687bb 100644
--- a/osu.Game.Rulesets.Taiko/Mods/TaikoModFlashlight.cs
+++ b/osu.Game.Rulesets.Taiko/Mods/TaikoModFlashlight.cs
@@ -20,8 +20,8 @@ namespace osu.Game.Rulesets.Taiko.Mods
         [SettingSource("Flashlight size", "Multiplier applied to the default flashlight size.")]
         public override BindableNumber<float> SizeMultiplier { get; } = new BindableNumber<float>
         {
-            MinValue = 0.1f,
-            MaxValue = 1.66f,
+            MinValue = 0.5f,
+            MaxValue = 1.5f,
             Default = 1f,
             Value = 1f,
             Precision = 0.1f

From 2d34831b5fd0383c75cf1c4cdc5d49a9b256d892 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 25 Jan 2022 12:54:38 +0900
Subject: [PATCH 2461/5547] Fix `TestMigration` failing due to changes in realm
 migration logic

Fixes failures as seen at https://github.com/ppy/osu/runs/4927916031?check_suite_focus=true.
---
 .../NonVisual/CustomDataDirectoryTest.cs      | 21 +++++++++++++------
 1 file changed, 15 insertions(+), 6 deletions(-)

diff --git a/osu.Game.Tests/NonVisual/CustomDataDirectoryTest.cs b/osu.Game.Tests/NonVisual/CustomDataDirectoryTest.cs
index 61ef31e07e..834930a05e 100644
--- a/osu.Game.Tests/NonVisual/CustomDataDirectoryTest.cs
+++ b/osu.Game.Tests/NonVisual/CustomDataDirectoryTest.cs
@@ -142,19 +142,28 @@ namespace osu.Game.Tests.NonVisual
 
                     Assert.That(osuStorage, Is.Not.Null);
 
+                    // In the following tests, realm files are ignored as
+                    // - in the case of checking the source, interacting with the pipe files (client.realm.note) may
+                    //   lead to unexpected behaviour.
+                    // - in the case of checking the destination, the files may have already been recreated by the game
+                    //   as part of the standard migration flow.
+
                     foreach (string file in osuStorage.IgnoreFiles)
                     {
-                        // avoid touching realm files which may be a pipe and break everything.
-                        // this is also done locally inside OsuStorage via the IgnoreFiles list.
-                        if (file.EndsWith(".ini", StringComparison.Ordinal))
+                        if (!file.Contains("realm", StringComparison.Ordinal))
+                        {
                             Assert.That(File.Exists(Path.Combine(originalDirectory, file)));
-                        Assert.That(storage.Exists(file), Is.False);
+                            Assert.That(storage.Exists(file), Is.False, () => $"{file} exists in destination when it was expected to be ignored");
+                        }
                     }
 
                     foreach (string dir in osuStorage.IgnoreDirectories)
                     {
-                        Assert.That(Directory.Exists(Path.Combine(originalDirectory, dir)));
-                        Assert.That(storage.ExistsDirectory(dir), Is.False);
+                        if (!dir.Contains("realm", StringComparison.Ordinal))
+                        {
+                            Assert.That(Directory.Exists(Path.Combine(originalDirectory, dir)));
+                            Assert.That(storage.Exists(dir), Is.False, () => $"{dir} exists in destination when it was expected to be ignored");
+                        }
                     }
 
                     Assert.That(new StreamReader(Path.Combine(originalDirectory, "storage.ini")).ReadToEnd().Contains($"FullPath = {customPath}"));

From 3e5c9e843606647561eb35541459386ecf54da20 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 25 Jan 2022 12:58:15 +0900
Subject: [PATCH 2462/5547] Fix cases of `Access` instead of `Realm`

---
 .../TestSceneOnlinePlayBeatmapAvailabilityTracker.cs |  8 ++++----
 .../Visual/Background/TestSceneUserDimBackgrounds.cs |  6 +++---
 .../Collections/TestSceneManageCollectionsDialog.cs  |  6 +++---
 .../Visual/Multiplayer/QueueModeTestScene.cs         |  6 +++---
 .../Multiplayer/TestSceneDrawableRoomPlaylist.cs     |  6 +++---
 .../Visual/Multiplayer/TestSceneMultiplayer.cs       |  6 +++---
 .../TestSceneMultiplayerMatchSongSelect.cs           |  6 +++---
 .../TestSceneMultiplayerMatchSubScreen.cs            |  6 +++---
 .../Multiplayer/TestSceneMultiplayerPlaylist.cs      |  6 +++---
 .../Multiplayer/TestSceneMultiplayerQueueList.cs     |  6 +++---
 .../Multiplayer/TestSceneMultiplayerReadyButton.cs   |  6 +++---
 .../TestSceneMultiplayerSpectateButton.cs            |  6 +++---
 .../Multiplayer/TestScenePlaylistsSongSelect.cs      |  6 +++---
 .../Visual/Multiplayer/TestSceneTeamVersus.cs        |  6 +++---
 .../Playlists/TestScenePlaylistsRoomCreation.cs      |  6 +++---
 .../Visual/SongSelect/TestSceneBeatmapLeaderboard.cs |  8 ++++----
 .../Visual/SongSelect/TestSceneFilterControl.cs      |  6 +++---
 .../Visual/SongSelect/TestScenePlaySongSelect.cs     |  6 +++---
 .../Visual/SongSelect/TestSceneTopLocalRank.cs       |  8 ++++----
 .../UserInterface/TestSceneDeleteLocalScore.cs       |  8 ++++----
 osu.Game/Beatmaps/BeatmapModelManager.cs             |  4 ++--
 osu.Game/Scoring/ScoreModelManager.cs                |  2 +-
 osu.Game/Skinning/SkinModelManager.cs                |  2 +-
 osu.Game/Stores/BeatmapImporter.cs                   |  2 +-
 osu.Game/Stores/RealmArchiveModelImporter.cs         | 12 ++++++------
 osu.Game/Stores/RealmArchiveModelManager.cs          |  6 +++---
 osu.Game/Tests/Visual/EditorTestScene.cs             |  2 +-
 osu.Game/Tests/Visual/OsuTestScene.cs                |  6 +++---
 28 files changed, 82 insertions(+), 82 deletions(-)

diff --git a/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs b/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
index e35e4d9b15..144cbe15c3 100644
--- a/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
+++ b/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
@@ -45,8 +45,8 @@ namespace osu.Game.Tests.Online
         [BackgroundDependencyLoader]
         private void load(AudioManager audio, GameHost host)
         {
-            Dependencies.Cache(rulesets = new RulesetStore(Access));
-            Dependencies.CacheAs<BeatmapManager>(beatmaps = new TestBeatmapManager(LocalStorage, Access, rulesets, API, audio, Resources, host, Beatmap.Default));
+            Dependencies.Cache(rulesets = new RulesetStore(Realm));
+            Dependencies.CacheAs<BeatmapManager>(beatmaps = new TestBeatmapManager(LocalStorage, Realm, rulesets, API, audio, Resources, host, Beatmap.Default));
             Dependencies.CacheAs<BeatmapModelDownloader>(beatmapDownloader = new TestBeatmapModelDownloader(beatmaps, API, host));
         }
 
@@ -60,8 +60,8 @@ namespace osu.Game.Tests.Online
             testBeatmapInfo = getTestBeatmapInfo(testBeatmapFile);
             testBeatmapSet = testBeatmapInfo.BeatmapSet;
 
-            Access.Write(r => r.RemoveAll<BeatmapSetInfo>());
-            Access.Write(r => r.RemoveAll<BeatmapInfo>());
+            Realm.Write(r => r.RemoveAll<BeatmapSetInfo>());
+            Realm.Write(r => r.RemoveAll<BeatmapInfo>());
 
             selectedItem.Value = new PlaylistItem
             {
diff --git a/osu.Game.Tests/Visual/Background/TestSceneUserDimBackgrounds.cs b/osu.Game.Tests/Visual/Background/TestSceneUserDimBackgrounds.cs
index fbfa7eda6a..40e7c0a844 100644
--- a/osu.Game.Tests/Visual/Background/TestSceneUserDimBackgrounds.cs
+++ b/osu.Game.Tests/Visual/Background/TestSceneUserDimBackgrounds.cs
@@ -47,10 +47,10 @@ namespace osu.Game.Tests.Visual.Background
         [BackgroundDependencyLoader]
         private void load(GameHost host, AudioManager audio)
         {
-            Dependencies.Cache(rulesets = new RulesetStore(Access));
-            Dependencies.Cache(manager = new BeatmapManager(LocalStorage, Access, rulesets, null, audio, Resources, host, Beatmap.Default));
+            Dependencies.Cache(rulesets = new RulesetStore(Realm));
+            Dependencies.Cache(manager = new BeatmapManager(LocalStorage, Realm, rulesets, null, audio, Resources, host, Beatmap.Default));
             Dependencies.Cache(new OsuConfigManager(LocalStorage));
-            Dependencies.Cache(Access);
+            Dependencies.Cache(Realm);
 
             manager.Import(TestResources.GetQuickTestBeatmapForImport()).WaitSafely();
 
diff --git a/osu.Game.Tests/Visual/Collections/TestSceneManageCollectionsDialog.cs b/osu.Game.Tests/Visual/Collections/TestSceneManageCollectionsDialog.cs
index fd0645a1e9..d4c13059da 100644
--- a/osu.Game.Tests/Visual/Collections/TestSceneManageCollectionsDialog.cs
+++ b/osu.Game.Tests/Visual/Collections/TestSceneManageCollectionsDialog.cs
@@ -36,9 +36,9 @@ namespace osu.Game.Tests.Visual.Collections
         [BackgroundDependencyLoader]
         private void load(GameHost host)
         {
-            Dependencies.Cache(rulesets = new RulesetStore(Access));
-            Dependencies.Cache(beatmapManager = new BeatmapManager(LocalStorage, Access, rulesets, null, Audio, Resources, host, Beatmap.Default));
-            Dependencies.Cache(Access);
+            Dependencies.Cache(rulesets = new RulesetStore(Realm));
+            Dependencies.Cache(beatmapManager = new BeatmapManager(LocalStorage, Realm, rulesets, null, Audio, Resources, host, Beatmap.Default));
+            Dependencies.Cache(Realm);
 
             beatmapManager.Import(TestResources.GetQuickTestBeatmapForImport()).WaitSafely();
 
diff --git a/osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs b/osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs
index 07b2bdcba3..4cd19b53a4 100644
--- a/osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs
@@ -47,9 +47,9 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [BackgroundDependencyLoader]
         private void load(GameHost host, AudioManager audio)
         {
-            Dependencies.Cache(rulesets = new RulesetStore(Access));
-            Dependencies.Cache(beatmaps = new BeatmapManager(LocalStorage, Access, rulesets, null, audio, Resources, host, Beatmap.Default));
-            Dependencies.Cache(Access);
+            Dependencies.Cache(rulesets = new RulesetStore(Realm));
+            Dependencies.Cache(beatmaps = new BeatmapManager(LocalStorage, Realm, rulesets, null, audio, Resources, host, Beatmap.Default));
+            Dependencies.Cache(Realm);
         }
 
         public override void SetUpSteps()
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
index 0bf1d60ac5..30ac1302aa 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
@@ -43,9 +43,9 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [BackgroundDependencyLoader]
         private void load(GameHost host, AudioManager audio)
         {
-            Dependencies.Cache(rulesets = new RulesetStore(Access));
-            Dependencies.Cache(manager = new BeatmapManager(LocalStorage, Access, rulesets, null, audio, Resources, host, Beatmap.Default));
-            Dependencies.Cache(Access);
+            Dependencies.Cache(rulesets = new RulesetStore(Realm));
+            Dependencies.Cache(manager = new BeatmapManager(LocalStorage, Realm, rulesets, null, audio, Resources, host, Beatmap.Default));
+            Dependencies.Cache(Realm);
         }
 
         [Test]
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
index 063d886729..3f151a0ae8 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
@@ -61,9 +61,9 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [BackgroundDependencyLoader]
         private void load(GameHost host, AudioManager audio)
         {
-            Dependencies.Cache(rulesets = new RulesetStore(Access));
-            Dependencies.Cache(beatmaps = new BeatmapManager(LocalStorage, Access, rulesets, API, audio, Resources, host, Beatmap.Default));
-            Dependencies.Cache(Access);
+            Dependencies.Cache(rulesets = new RulesetStore(Realm));
+            Dependencies.Cache(beatmaps = new BeatmapManager(LocalStorage, Realm, rulesets, API, audio, Resources, host, Beatmap.Default));
+            Dependencies.Cache(Realm);
         }
 
         public override void SetUpSteps()
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs
index 8c79c468d7..7e3c9722cf 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs
@@ -42,9 +42,9 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [BackgroundDependencyLoader]
         private void load(GameHost host, AudioManager audio)
         {
-            Dependencies.Cache(rulesets = new RulesetStore(Access));
-            Dependencies.Cache(manager = new BeatmapManager(LocalStorage, Access, rulesets, null, audio, Resources, host, Beatmap.Default));
-            Dependencies.Cache(Access);
+            Dependencies.Cache(rulesets = new RulesetStore(Realm));
+            Dependencies.Cache(manager = new BeatmapManager(LocalStorage, Realm, rulesets, null, audio, Resources, host, Beatmap.Default));
+            Dependencies.Cache(Realm);
 
             beatmaps = new List<BeatmapInfo>();
 
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs
index 77e2c9c714..9d14d80d07 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs
@@ -38,9 +38,9 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [BackgroundDependencyLoader]
         private void load(GameHost host, AudioManager audio)
         {
-            Dependencies.Cache(rulesets = new RulesetStore(Access));
-            Dependencies.Cache(beatmaps = new BeatmapManager(LocalStorage, Access, rulesets, null, audio, Resources, host, Beatmap.Default));
-            Dependencies.Cache(Access);
+            Dependencies.Cache(rulesets = new RulesetStore(Realm));
+            Dependencies.Cache(beatmaps = new BeatmapManager(LocalStorage, Realm, rulesets, null, audio, Resources, host, Beatmap.Default));
+            Dependencies.Cache(Realm);
 
             beatmaps.Import(TestResources.GetQuickTestBeatmapForImport()).WaitSafely();
 
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs
index 4270818b1a..d970ab6c34 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs
@@ -33,9 +33,9 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [BackgroundDependencyLoader]
         private void load(GameHost host, AudioManager audio)
         {
-            Dependencies.Cache(rulesets = new RulesetStore(Access));
-            Dependencies.Cache(beatmaps = new BeatmapManager(LocalStorage, Access, rulesets, null, audio, Resources, host, Beatmap.Default));
-            Dependencies.Cache(Access);
+            Dependencies.Cache(rulesets = new RulesetStore(Realm));
+            Dependencies.Cache(beatmaps = new BeatmapManager(LocalStorage, Realm, rulesets, null, audio, Resources, host, Beatmap.Default));
+            Dependencies.Cache(Realm);
         }
 
         [SetUp]
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs
index 56e64292c6..d83421ee3a 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs
@@ -38,9 +38,9 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [BackgroundDependencyLoader]
         private void load(GameHost host, AudioManager audio)
         {
-            Dependencies.Cache(rulesets = new RulesetStore(Access));
-            Dependencies.Cache(beatmaps = new BeatmapManager(LocalStorage, Access, rulesets, API, audio, Resources, host, Beatmap.Default));
-            Dependencies.Cache(Access);
+            Dependencies.Cache(rulesets = new RulesetStore(Realm));
+            Dependencies.Cache(beatmaps = new BeatmapManager(LocalStorage, Realm, rulesets, API, audio, Resources, host, Beatmap.Default));
+            Dependencies.Cache(Realm);
         }
 
         public override void SetUpSteps()
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs
index afb60b62aa..9867e5225e 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs
@@ -40,9 +40,9 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [BackgroundDependencyLoader]
         private void load(GameHost host, AudioManager audio)
         {
-            Dependencies.Cache(rulesets = new RulesetStore(Access));
-            Dependencies.Cache(beatmaps = new BeatmapManager(LocalStorage, Access, rulesets, null, audio, Resources, host, Beatmap.Default));
-            Dependencies.Cache(Access);
+            Dependencies.Cache(rulesets = new RulesetStore(Realm));
+            Dependencies.Cache(beatmaps = new BeatmapManager(LocalStorage, Realm, rulesets, null, audio, Resources, host, Beatmap.Default));
+            Dependencies.Cache(Realm);
 
             beatmaps.Import(TestResources.GetQuickTestBeatmapForImport()).WaitSafely();
         }
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerSpectateButton.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerSpectateButton.cs
index 79b29f0eca..42ae279667 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerSpectateButton.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerSpectateButton.cs
@@ -41,9 +41,9 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [BackgroundDependencyLoader]
         private void load(GameHost host, AudioManager audio)
         {
-            Dependencies.Cache(rulesets = new RulesetStore(Access));
-            Dependencies.Cache(beatmaps = new BeatmapManager(LocalStorage, Access, rulesets, null, audio, Resources, host, Beatmap.Default));
-            Dependencies.Cache(Access);
+            Dependencies.Cache(rulesets = new RulesetStore(Realm));
+            Dependencies.Cache(beatmaps = new BeatmapManager(LocalStorage, Realm, rulesets, null, audio, Resources, host, Beatmap.Default));
+            Dependencies.Cache(Realm);
 
             beatmaps.Import(TestResources.GetQuickTestBeatmapForImport()).WaitSafely();
         }
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsSongSelect.cs b/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsSongSelect.cs
index 6ed57e9899..d7a0885c95 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsSongSelect.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsSongSelect.cs
@@ -34,9 +34,9 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [BackgroundDependencyLoader]
         private void load(GameHost host, AudioManager audio)
         {
-            Dependencies.Cache(rulesets = new RulesetStore(Access));
-            Dependencies.Cache(manager = new BeatmapManager(LocalStorage, Access, rulesets, null, audio, Resources, host, Beatmap.Default));
-            Dependencies.Cache(Access);
+            Dependencies.Cache(rulesets = new RulesetStore(Realm));
+            Dependencies.Cache(manager = new BeatmapManager(LocalStorage, Realm, rulesets, null, audio, Resources, host, Beatmap.Default));
+            Dependencies.Cache(Realm);
 
             var beatmapSet = TestResources.CreateTestBeatmapSetInfo();
 
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs
index bd95b297d4..73c67d26d9 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs
@@ -42,9 +42,9 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [BackgroundDependencyLoader]
         private void load(GameHost host, AudioManager audio)
         {
-            Dependencies.Cache(rulesets = new RulesetStore(Access));
-            Dependencies.Cache(beatmaps = new BeatmapManager(LocalStorage, Access, rulesets, null, audio, Resources, host, Beatmap.Default));
-            Dependencies.Cache(Access);
+            Dependencies.Cache(rulesets = new RulesetStore(Realm));
+            Dependencies.Cache(beatmaps = new BeatmapManager(LocalStorage, Realm, rulesets, null, audio, Resources, host, Beatmap.Default));
+            Dependencies.Cache(Realm);
         }
 
         public override void SetUpSteps()
diff --git a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs
index 716e3a535d..d397b37d05 100644
--- a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs
+++ b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs
@@ -40,9 +40,9 @@ namespace osu.Game.Tests.Visual.Playlists
         [BackgroundDependencyLoader]
         private void load(GameHost host, AudioManager audio)
         {
-            Dependencies.Cache(rulesets = new RulesetStore(Access));
-            Dependencies.Cache(manager = new BeatmapManager(LocalStorage, Access, rulesets, API, audio, Resources, host, Beatmap.Default));
-            Dependencies.Cache(Access);
+            Dependencies.Cache(rulesets = new RulesetStore(Realm));
+            Dependencies.Cache(manager = new BeatmapManager(LocalStorage, Realm, rulesets, API, audio, Resources, host, Beatmap.Default));
+            Dependencies.Cache(Realm);
         }
 
         [SetUpSteps]
diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
index 2f5594379b..5e977d075d 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
@@ -42,10 +42,10 @@ namespace osu.Game.Tests.Visual.SongSelect
         {
             var dependencies = new DependencyContainer(base.CreateChildDependencies(parent));
 
-            dependencies.Cache(rulesetStore = new RulesetStore(Access));
-            dependencies.Cache(beatmapManager = new BeatmapManager(LocalStorage, Access, rulesetStore, null, dependencies.Get<AudioManager>(), Resources, dependencies.Get<GameHost>(), Beatmap.Default));
-            dependencies.Cache(scoreManager = new ScoreManager(rulesetStore, () => beatmapManager, LocalStorage, Access, Scheduler));
-            Dependencies.Cache(Access);
+            dependencies.Cache(rulesetStore = new RulesetStore(Realm));
+            dependencies.Cache(beatmapManager = new BeatmapManager(LocalStorage, Realm, rulesetStore, null, dependencies.Get<AudioManager>(), Resources, dependencies.Get<GameHost>(), Beatmap.Default));
+            dependencies.Cache(scoreManager = new ScoreManager(rulesetStore, () => beatmapManager, LocalStorage, Realm, Scheduler));
+            Dependencies.Cache(Realm);
 
             return dependencies;
         }
diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneFilterControl.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneFilterControl.cs
index 4868a4a075..b384061531 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneFilterControl.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneFilterControl.cs
@@ -36,9 +36,9 @@ namespace osu.Game.Tests.Visual.SongSelect
         [BackgroundDependencyLoader]
         private void load(GameHost host)
         {
-            Dependencies.Cache(rulesets = new RulesetStore(Access));
-            Dependencies.Cache(beatmapManager = new BeatmapManager(LocalStorage, Access, rulesets, null, Audio, Resources, host, Beatmap.Default));
-            Dependencies.Cache(Access);
+            Dependencies.Cache(rulesets = new RulesetStore(Realm));
+            Dependencies.Cache(beatmapManager = new BeatmapManager(LocalStorage, Realm, rulesets, null, Audio, Resources, host, Beatmap.Default));
+            Dependencies.Cache(Realm);
 
             beatmapManager.Import(TestResources.GetQuickTestBeatmapForImport()).WaitSafely();
 
diff --git a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
index d8a39dda01..0dc4556ed9 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
@@ -47,9 +47,9 @@ namespace osu.Game.Tests.Visual.SongSelect
         {
             // These DI caches are required to ensure for interactive runs this test scene doesn't nuke all user beatmaps in the local install.
             // At a point we have isolated interactive test runs enough, this can likely be removed.
-            Dependencies.Cache(rulesets = new RulesetStore(Access));
-            Dependencies.Cache(Access);
-            Dependencies.Cache(manager = new BeatmapManager(LocalStorage, Access, rulesets, null, audio, Resources, host, defaultBeatmap = Beatmap.Default));
+            Dependencies.Cache(rulesets = new RulesetStore(Realm));
+            Dependencies.Cache(Realm);
+            Dependencies.Cache(manager = new BeatmapManager(LocalStorage, Realm, rulesets, null, audio, Resources, host, defaultBeatmap = Beatmap.Default));
 
             Dependencies.Cache(music = new MusicController());
 
diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneTopLocalRank.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneTopLocalRank.cs
index a0657ffdf6..8e5f76a2eb 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneTopLocalRank.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneTopLocalRank.cs
@@ -28,10 +28,10 @@ namespace osu.Game.Tests.Visual.SongSelect
         [BackgroundDependencyLoader]
         private void load(GameHost host, AudioManager audio)
         {
-            Dependencies.Cache(rulesets = new RulesetStore(Access));
-            Dependencies.Cache(beatmapManager = new BeatmapManager(LocalStorage, Access, rulesets, null, audio, Resources, host, Beatmap.Default));
-            Dependencies.Cache(scoreManager = new ScoreManager(rulesets, () => beatmapManager, LocalStorage, Access, Scheduler));
-            Dependencies.Cache(Access);
+            Dependencies.Cache(rulesets = new RulesetStore(Realm));
+            Dependencies.Cache(beatmapManager = new BeatmapManager(LocalStorage, Realm, rulesets, null, audio, Resources, host, Beatmap.Default));
+            Dependencies.Cache(scoreManager = new ScoreManager(rulesets, () => beatmapManager, LocalStorage, Realm, Scheduler));
+            Dependencies.Cache(Realm);
 
             beatmapManager.Import(TestResources.GetQuickTestBeatmapForImport()).WaitSafely();
         }
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
index 2278d3f8bf..94ce85ef38 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
@@ -87,10 +87,10 @@ namespace osu.Game.Tests.Visual.UserInterface
         {
             var dependencies = new DependencyContainer(base.CreateChildDependencies(parent));
 
-            dependencies.Cache(rulesetStore = new RulesetStore(Access));
-            dependencies.Cache(beatmapManager = new BeatmapManager(LocalStorage, Access, rulesetStore, null, dependencies.Get<AudioManager>(), Resources, dependencies.Get<GameHost>(), Beatmap.Default));
-            dependencies.Cache(scoreManager = new ScoreManager(dependencies.Get<RulesetStore>(), () => beatmapManager, LocalStorage, Access, Scheduler));
-            Dependencies.Cache(Access);
+            dependencies.Cache(rulesetStore = new RulesetStore(Realm));
+            dependencies.Cache(beatmapManager = new BeatmapManager(LocalStorage, Realm, rulesetStore, null, dependencies.Get<AudioManager>(), Resources, dependencies.Get<GameHost>(), Beatmap.Default));
+            dependencies.Cache(scoreManager = new ScoreManager(dependencies.Get<RulesetStore>(), () => beatmapManager, LocalStorage, Realm, Scheduler));
+            Dependencies.Cache(Realm);
 
             var imported = beatmapManager.Import(new ImportTask(TestResources.GetQuickTestBeatmapForImport())).GetResultSafely();
 
diff --git a/osu.Game/Beatmaps/BeatmapModelManager.cs b/osu.Game/Beatmaps/BeatmapModelManager.cs
index 167d77d6f6..e8104f2ecb 100644
--- a/osu.Game/Beatmaps/BeatmapModelManager.cs
+++ b/osu.Game/Beatmaps/BeatmapModelManager.cs
@@ -98,12 +98,12 @@ namespace osu.Game.Beatmaps
         /// <returns>The first result for the provided query, or null if no results were found.</returns>
         public BeatmapInfo? QueryBeatmap(Expression<Func<BeatmapInfo, bool>> query)
         {
-            return Access.Run(realm => realm.All<BeatmapInfo>().FirstOrDefault(query)?.Detach());
+            return Realm.Run(realm => realm.All<BeatmapInfo>().FirstOrDefault(query)?.Detach());
         }
 
         public void Update(BeatmapSetInfo item)
         {
-            Access.Write(realm =>
+            Realm.Write(realm =>
             {
                 var existing = realm.Find<BeatmapSetInfo>(item.ID);
                 item.CopyChangesToRealm(existing);
diff --git a/osu.Game/Scoring/ScoreModelManager.cs b/osu.Game/Scoring/ScoreModelManager.cs
index 2147ff1ba1..59102360f9 100644
--- a/osu.Game/Scoring/ScoreModelManager.cs
+++ b/osu.Game/Scoring/ScoreModelManager.cs
@@ -74,7 +74,7 @@ namespace osu.Game.Scoring
 
         public override bool IsAvailableLocally(ScoreInfo model)
         {
-            return Access.Run(realm => realm.All<ScoreInfo>().Any(s => s.OnlineID == model.OnlineID));
+            return Realm.Run(realm => realm.All<ScoreInfo>().Any(s => s.OnlineID == model.OnlineID));
         }
     }
 }
diff --git a/osu.Game/Skinning/SkinModelManager.cs b/osu.Game/Skinning/SkinModelManager.cs
index c93cdb17dd..0af31100a9 100644
--- a/osu.Game/Skinning/SkinModelManager.cs
+++ b/osu.Game/Skinning/SkinModelManager.cs
@@ -205,7 +205,7 @@ namespace osu.Game.Skinning
 
         private void populateMissingHashes()
         {
-            Access.Run(realm =>
+            Realm.Run(realm =>
             {
                 var skinsWithoutHashes = realm.All<SkinInfo>().Where(i => !i.Protected && string.IsNullOrEmpty(i.Hash)).ToArray();
 
diff --git a/osu.Game/Stores/BeatmapImporter.cs b/osu.Game/Stores/BeatmapImporter.cs
index 3d241e795c..a6f20c8d4f 100644
--- a/osu.Game/Stores/BeatmapImporter.cs
+++ b/osu.Game/Stores/BeatmapImporter.cs
@@ -165,7 +165,7 @@ namespace osu.Game.Stores
 
         public override bool IsAvailableLocally(BeatmapSetInfo model)
         {
-            return Access.Run(realm => realm.All<BeatmapInfo>().Any(b => b.OnlineID == model.OnlineID));
+            return Realm.Run(realm => realm.All<BeatmapInfo>().Any(b => b.OnlineID == model.OnlineID));
         }
 
         public override string HumanisedModelName => "beatmap";
diff --git a/osu.Game/Stores/RealmArchiveModelImporter.cs b/osu.Game/Stores/RealmArchiveModelImporter.cs
index 23a860791e..d9ca3f50a3 100644
--- a/osu.Game/Stores/RealmArchiveModelImporter.cs
+++ b/osu.Game/Stores/RealmArchiveModelImporter.cs
@@ -59,7 +59,7 @@ namespace osu.Game.Stores
 
         protected readonly RealmFileStore Files;
 
-        protected readonly RealmAccess Access;
+        protected readonly RealmAccess Realm;
 
         /// <summary>
         /// Fired when the user requests to view the resulting import.
@@ -73,7 +73,7 @@ namespace osu.Game.Stores
 
         protected RealmArchiveModelImporter(Storage storage, RealmAccess realm)
         {
-            Access = realm;
+            Realm = realm;
 
             Files = new RealmFileStore(realm, storage);
         }
@@ -320,7 +320,7 @@ namespace osu.Game.Stores
         /// <param name="cancellationToken">An optional cancellation token.</param>
         public virtual Task<ILive<TModel>?> Import(TModel item, ArchiveReader? archive = null, bool lowPriority = false, CancellationToken cancellationToken = default)
         {
-            return Access.Run(realm =>
+            return Realm.Run(realm =>
             {
                 cancellationToken.ThrowIfCancellationRequested();
 
@@ -352,7 +352,7 @@ namespace osu.Game.Stores
                                 transaction.Commit();
                             }
 
-                            return Task.FromResult((ILive<TModel>?)existing.ToLive(Access));
+                            return Task.FromResult((ILive<TModel>?)existing.ToLive(Realm));
                         }
 
                         LogForModel(item, @"Found existing (optimised) but failed pre-check.");
@@ -387,7 +387,7 @@ namespace osu.Game.Stores
                                 existing.DeletePending = false;
                                 transaction.Commit();
 
-                                return Task.FromResult((ILive<TModel>?)existing.ToLive(Access));
+                                return Task.FromResult((ILive<TModel>?)existing.ToLive(Realm));
                             }
 
                             LogForModel(item, @"Found existing but failed re-use check.");
@@ -413,7 +413,7 @@ namespace osu.Game.Stores
                     throw;
                 }
 
-                return Task.FromResult((ILive<TModel>?)item.ToLive(Access));
+                return Task.FromResult((ILive<TModel>?)item.ToLive(Realm));
             });
         }
 
diff --git a/osu.Game/Stores/RealmArchiveModelManager.cs b/osu.Game/Stores/RealmArchiveModelManager.cs
index 00cd1c2958..57e51b79aa 100644
--- a/osu.Game/Stores/RealmArchiveModelManager.cs
+++ b/osu.Game/Stores/RealmArchiveModelManager.cs
@@ -45,7 +45,7 @@ namespace osu.Game.Stores
             // This method should be removed as soon as all the surrounding pieces support non-detached operations.
             if (!item.IsManaged)
             {
-                var managed = Access.Realm.Find<TModel>(item.ID);
+                var managed = Realm.Realm.Find<TModel>(item.ID);
                 managed.Realm.Write(() => operation(managed));
 
                 item.Files.Clear();
@@ -165,7 +165,7 @@ namespace osu.Game.Stores
 
         public bool Delete(TModel item)
         {
-            return Access.Run(realm =>
+            return Realm.Run(realm =>
             {
                 if (!item.IsManaged)
                     item = realm.Find<TModel>(item.ID);
@@ -180,7 +180,7 @@ namespace osu.Game.Stores
 
         public void Undelete(TModel item)
         {
-            Access.Run(realm =>
+            Realm.Run(realm =>
             {
                 if (!item.IsManaged)
                     item = realm.Find<TModel>(item.ID);
diff --git a/osu.Game/Tests/Visual/EditorTestScene.cs b/osu.Game/Tests/Visual/EditorTestScene.cs
index a6cac0ec86..6f751b1736 100644
--- a/osu.Game/Tests/Visual/EditorTestScene.cs
+++ b/osu.Game/Tests/Visual/EditorTestScene.cs
@@ -53,7 +53,7 @@ namespace osu.Game.Tests.Visual
             working = CreateWorkingBeatmap(Ruleset.Value);
 
             if (IsolateSavingFromDatabase)
-                Dependencies.CacheAs<BeatmapManager>(testBeatmapManager = new TestBeatmapManager(LocalStorage, Access, rulesets, null, audio, Resources, host, Beatmap.Default));
+                Dependencies.CacheAs<BeatmapManager>(testBeatmapManager = new TestBeatmapManager(LocalStorage, Realm, rulesets, null, audio, Resources, host, Beatmap.Default));
         }
 
         protected override void LoadComplete()
diff --git a/osu.Game/Tests/Visual/OsuTestScene.cs b/osu.Game/Tests/Visual/OsuTestScene.cs
index 33dd1d45b8..42e96f80ca 100644
--- a/osu.Game/Tests/Visual/OsuTestScene.cs
+++ b/osu.Game/Tests/Visual/OsuTestScene.cs
@@ -75,9 +75,9 @@ namespace osu.Game.Tests.Visual
         /// <remarks>
         /// In interactive runs (ie. VisualTests) this will use the user's database if <see cref="UseFreshStoragePerRun"/> is not set to <c>true</c>.
         /// </remarks>
-        protected RealmAccess Access => contextFactory.Value;
+        protected RealmAccess Realm => realm.Value;
 
-        private Lazy<RealmAccess> contextFactory;
+        private Lazy<RealmAccess> realm;
 
         /// <summary>
         /// Whether a fresh storage should be initialised per test (method) run.
@@ -119,7 +119,7 @@ namespace osu.Game.Tests.Visual
 
             Resources = parent.Get<OsuGameBase>().Resources;
 
-            contextFactory = new Lazy<RealmAccess>(() => new RealmAccess(LocalStorage, "client"));
+            realm = new Lazy<RealmAccess>(() => new RealmAccess(LocalStorage, "client"));
 
             RecycleLocalStorage(false);
 

From e23b10e6a5a91ba1d7fd1f746846043c73c0427c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 25 Jan 2022 13:04:05 +0900
Subject: [PATCH 2463/5547] Update remaining cases of clashing variable name in
 `realm.Run(realm..`

---
 osu.Game.Benchmarks/BenchmarkRealmReads.cs    | 10 ++--
 .../Database/TestRealmKeyBindingStore.cs      |  4 +-
 .../Visual/Ranking/TestSceneResultsScreen.cs  |  8 ++--
 .../TestSceneDeleteLocalScore.cs              |  4 +-
 osu.Game/Beatmaps/BeatmapManager.cs           | 34 +++++++-------
 osu.Game/Database/EFToRealmMigrator.cs        | 46 +++++++++----------
 osu.Game/Database/RealmLive.cs                |  9 ++--
 osu.Game/Input/RealmKeyBindingStore.cs        | 10 ++--
 .../Settings/Sections/Input/KeyBindingRow.cs  |  6 +--
 osu.Game/Scoring/ScoreManager.cs              |  8 ++--
 osu.Game/Screens/Select/BeatmapCarousel.cs    |  2 +-
 .../Select/Leaderboards/BeatmapLeaderboard.cs | 10 ++--
 osu.Game/Skinning/SkinManager.cs              |  6 +--
 13 files changed, 77 insertions(+), 80 deletions(-)

diff --git a/osu.Game.Benchmarks/BenchmarkRealmReads.cs b/osu.Game.Benchmarks/BenchmarkRealmReads.cs
index 412f86bd1c..bf9467700c 100644
--- a/osu.Game.Benchmarks/BenchmarkRealmReads.cs
+++ b/osu.Game.Benchmarks/BenchmarkRealmReads.cs
@@ -29,7 +29,7 @@ namespace osu.Game.Benchmarks
 
             realm = new RealmAccess(storage, "client");
 
-            realm.Run(realm =>
+            realm.Run(r =>
             {
                 realm.Write(c => c.Add(TestResources.CreateTestBeatmapSetInfo(rulesets: new[] { new OsuRuleset().RulesetInfo })));
             });
@@ -41,9 +41,9 @@ namespace osu.Game.Benchmarks
         [Benchmark]
         public void BenchmarkDirectPropertyRead()
         {
-            realm.Run(realm =>
+            realm.Run(r =>
             {
-                var beatmapSet = realm.All<BeatmapSetInfo>().First();
+                var beatmapSet = r.All<BeatmapSetInfo>().First();
 
                 for (int i = 0; i < ReadsPerFetch; i++)
                 {
@@ -119,9 +119,9 @@ namespace osu.Game.Benchmarks
         [Benchmark]
         public void BenchmarkDetachedPropertyRead()
         {
-            realm.Run(realm =>
+            realm.Run(r =>
             {
-                var beatmapSet = realm.All<BeatmapSetInfo>().First().Detach();
+                var beatmapSet = r.All<BeatmapSetInfo>().First().Detach();
 
                 for (int i = 0; i < ReadsPerFetch; i++)
                 {
diff --git a/osu.Game.Tests/Database/TestRealmKeyBindingStore.cs b/osu.Game.Tests/Database/TestRealmKeyBindingStore.cs
index 4b8816f142..7b2d2a1278 100644
--- a/osu.Game.Tests/Database/TestRealmKeyBindingStore.cs
+++ b/osu.Game.Tests/Database/TestRealmKeyBindingStore.cs
@@ -76,9 +76,9 @@ namespace osu.Game.Tests.Database
 
         private int queryCount(GlobalAction? match = null)
         {
-            return realm.Run(realm =>
+            return realm.Run(r =>
             {
-                var results = realm.All<RealmKeyBinding>();
+                var results = r.All<RealmKeyBinding>();
                 if (match.HasValue)
                     results = results.Where(k => k.ActionInt == (int)match.Value);
                 return results.Count();
diff --git a/osu.Game.Tests/Visual/Ranking/TestSceneResultsScreen.cs b/osu.Game.Tests/Visual/Ranking/TestSceneResultsScreen.cs
index 13b4af5223..988f429ff5 100644
--- a/osu.Game.Tests/Visual/Ranking/TestSceneResultsScreen.cs
+++ b/osu.Game.Tests/Visual/Ranking/TestSceneResultsScreen.cs
@@ -42,11 +42,11 @@ namespace osu.Game.Tests.Visual.Ranking
         {
             base.LoadComplete();
 
-            realm.Run(realm =>
+            realm.Run(r =>
             {
-                var beatmapInfo = realm.All<BeatmapInfo>()
-                                       .Filter($"{nameof(BeatmapInfo.Ruleset)}.{nameof(RulesetInfo.OnlineID)} = $0", 0)
-                                       .FirstOrDefault();
+                var beatmapInfo = r.All<BeatmapInfo>()
+                                   .Filter($"{nameof(BeatmapInfo.Ruleset)}.{nameof(RulesetInfo.OnlineID)} = $0", 0)
+                                   .FirstOrDefault();
 
                 if (beatmapInfo != null)
                     Beatmap.Value = beatmaps.GetWorkingBeatmap(beatmapInfo);
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
index 94ce85ef38..55031a9699 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
@@ -122,10 +122,10 @@ namespace osu.Game.Tests.Visual.UserInterface
         [SetUp]
         public void Setup() => Schedule(() =>
         {
-            realm.Run(realm =>
+            realm.Run(r =>
             {
                 // Due to soft deletions, we can re-use deleted scores between test runs
-                scoreManager.Undelete(realm.All<ScoreInfo>().Where(s => s.DeletePending).ToList());
+                scoreManager.Undelete(r.All<ScoreInfo>().Where(s => s.DeletePending).ToList());
             });
 
             leaderboard.Scores = null;
diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index ddc1d054cc..4488301fe5 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -119,12 +119,12 @@ namespace osu.Game.Beatmaps
         /// <param name="beatmapInfo">The beatmap difficulty to hide.</param>
         public void Hide(BeatmapInfo beatmapInfo)
         {
-            realm.Run(realm =>
+            realm.Run(r =>
             {
-                using (var transaction = realm.BeginWrite())
+                using (var transaction = r.BeginWrite())
                 {
                     if (!beatmapInfo.IsManaged)
-                        beatmapInfo = realm.Find<BeatmapInfo>(beatmapInfo.ID);
+                        beatmapInfo = r.Find<BeatmapInfo>(beatmapInfo.ID);
 
                     beatmapInfo.Hidden = true;
                     transaction.Commit();
@@ -138,12 +138,12 @@ namespace osu.Game.Beatmaps
         /// <param name="beatmapInfo">The beatmap difficulty to restore.</param>
         public void Restore(BeatmapInfo beatmapInfo)
         {
-            realm.Run(realm =>
+            realm.Run(r =>
             {
-                using (var transaction = realm.BeginWrite())
+                using (var transaction = r.BeginWrite())
                 {
                     if (!beatmapInfo.IsManaged)
-                        beatmapInfo = realm.Find<BeatmapInfo>(beatmapInfo.ID);
+                        beatmapInfo = r.Find<BeatmapInfo>(beatmapInfo.ID);
 
                     beatmapInfo.Hidden = false;
                     transaction.Commit();
@@ -153,11 +153,11 @@ namespace osu.Game.Beatmaps
 
         public void RestoreAll()
         {
-            realm.Run(realm =>
+            realm.Run(r =>
             {
-                using (var transaction = realm.BeginWrite())
+                using (var transaction = r.BeginWrite())
                 {
-                    foreach (var beatmap in realm.All<BeatmapInfo>().Where(b => b.Hidden))
+                    foreach (var beatmap in r.All<BeatmapInfo>().Where(b => b.Hidden))
                         beatmap.Hidden = false;
 
                     transaction.Commit();
@@ -171,10 +171,10 @@ namespace osu.Game.Beatmaps
         /// <returns>A list of available <see cref="BeatmapSetInfo"/>.</returns>
         public List<BeatmapSetInfo> GetAllUsableBeatmapSets()
         {
-            return realm.Run(realm =>
+            return realm.Run(r =>
             {
-                realm.Refresh();
-                return realm.All<BeatmapSetInfo>().Where(b => !b.DeletePending).Detach();
+                r.Refresh();
+                return r.All<BeatmapSetInfo>().Where(b => !b.DeletePending).Detach();
             });
         }
 
@@ -240,9 +240,9 @@ namespace osu.Game.Beatmaps
 
         public void Delete(Expression<Func<BeatmapSetInfo, bool>>? filter = null, bool silent = false)
         {
-            realm.Run(realm =>
+            realm.Run(r =>
             {
-                var items = realm.All<BeatmapSetInfo>().Where(s => !s.DeletePending && !s.Protected);
+                var items = r.All<BeatmapSetInfo>().Where(s => !s.DeletePending && !s.Protected);
 
                 if (filter != null)
                     items = items.Where(filter);
@@ -253,7 +253,7 @@ namespace osu.Game.Beatmaps
 
         public void UndeleteAll()
         {
-            realm.Run(realm => beatmapModelManager.Undelete(realm.All<BeatmapSetInfo>().Where(s => s.DeletePending).ToList()));
+            realm.Run(r => beatmapModelManager.Undelete(r.All<BeatmapSetInfo>().Where(s => s.DeletePending).ToList()));
         }
 
         public void Undelete(List<BeatmapSetInfo> items, bool silent = false)
@@ -312,9 +312,9 @@ namespace osu.Game.Beatmaps
             // If we seem to be missing files, now is a good time to re-fetch.
             if (importedBeatmap?.BeatmapSet?.Files.Count == 0)
             {
-                realm.Run(realm =>
+                realm.Run(r =>
                 {
-                    var refetch = realm.Find<BeatmapInfo>(importedBeatmap.ID)?.Detach();
+                    var refetch = r.Find<BeatmapInfo>(importedBeatmap.ID)?.Detach();
 
                     if (refetch != null)
                         importedBeatmap = refetch;
diff --git a/osu.Game/Database/EFToRealmMigrator.cs b/osu.Game/Database/EFToRealmMigrator.cs
index a0787e81e6..349452afce 100644
--- a/osu.Game/Database/EFToRealmMigrator.cs
+++ b/osu.Game/Database/EFToRealmMigrator.cs
@@ -158,11 +158,11 @@ namespace osu.Game.Database
 
             int count = existingBeatmapSets.Count();
 
-            realm.Run(realm =>
+            realm.Run(r =>
             {
                 log($"Found {count} beatmaps in EF");
 
-                var transaction = realm.BeginWrite();
+                var transaction = r.BeginWrite();
                 int written = 0;
 
                 try
@@ -172,7 +172,7 @@ namespace osu.Game.Database
                         if (++written % 1000 == 0)
                         {
                             transaction.Commit();
-                            transaction = realm.BeginWrite();
+                            transaction = r.BeginWrite();
                             log($"Migrated {written}/{count} beatmaps...");
                         }
 
@@ -186,11 +186,11 @@ namespace osu.Game.Database
                             Protected = beatmapSet.Protected,
                         };
 
-                        migrateFiles(beatmapSet, realm, realmBeatmapSet);
+                        migrateFiles(beatmapSet, r, realmBeatmapSet);
 
                         foreach (var beatmap in beatmapSet.Beatmaps)
                         {
-                            var ruleset = realm.Find<RulesetInfo>(beatmap.RulesetInfo.ShortName);
+                            var ruleset = r.Find<RulesetInfo>(beatmap.RulesetInfo.ShortName);
                             var metadata = getBestMetadata(beatmap.Metadata, beatmapSet.Metadata);
 
                             var realmBeatmap = new BeatmapInfo(ruleset, new BeatmapDifficulty(beatmap.BaseDifficulty), metadata)
@@ -225,7 +225,7 @@ namespace osu.Game.Database
                             realmBeatmapSet.Beatmaps.Add(realmBeatmap);
                         }
 
-                        realm.Add(realmBeatmapSet);
+                        r.Add(realmBeatmapSet);
                     }
                 }
                 finally
@@ -280,11 +280,11 @@ namespace osu.Game.Database
 
             int count = existingScores.Count();
 
-            realm.Run(realm =>
+            realm.Run(r =>
             {
                 log($"Found {count} scores in EF");
 
-                var transaction = realm.BeginWrite();
+                var transaction = r.BeginWrite();
                 int written = 0;
 
                 try
@@ -294,12 +294,12 @@ namespace osu.Game.Database
                         if (++written % 1000 == 0)
                         {
                             transaction.Commit();
-                            transaction = realm.BeginWrite();
+                            transaction = r.BeginWrite();
                             log($"Migrated {written}/{count} scores...");
                         }
 
-                        var beatmap = realm.All<BeatmapInfo>().First(b => b.Hash == score.BeatmapInfo.Hash);
-                        var ruleset = realm.Find<RulesetInfo>(score.Ruleset.ShortName);
+                        var beatmap = r.All<BeatmapInfo>().First(b => b.Hash == score.BeatmapInfo.Hash);
+                        var ruleset = r.Find<RulesetInfo>(score.Ruleset.ShortName);
                         var user = new RealmUser
                         {
                             OnlineID = score.User.OnlineID,
@@ -329,9 +329,9 @@ namespace osu.Game.Database
                             APIMods = score.APIMods,
                         };
 
-                        migrateFiles(score, realm, realmScore);
+                        migrateFiles(score, r, realmScore);
 
-                        realm.Add(realmScore);
+                        r.Add(realmScore);
                     }
                 }
                 finally
@@ -369,13 +369,13 @@ namespace osu.Game.Database
                     break;
             }
 
-            realm.Run(realm =>
+            realm.Run(r =>
             {
-                using (var transaction = realm.BeginWrite())
+                using (var transaction = r.BeginWrite())
                 {
                     // only migrate data if the realm database is empty.
-                    // note that this cannot be written as: `realm.All<SkinInfo>().All(s => s.Protected)`, because realm does not support `.All()`.
-                    if (!realm.All<SkinInfo>().Any(s => !s.Protected))
+                    // note that this cannot be written as: `r.All<SkinInfo>().All(s => s.Protected)`, because realm does not support `.All()`.
+                    if (!r.All<SkinInfo>().Any(s => !s.Protected))
                     {
                         log($"Migrating {existingSkins.Count} skins");
 
@@ -390,9 +390,9 @@ namespace osu.Game.Database
                                 InstantiationInfo = skin.InstantiationInfo,
                             };
 
-                            migrateFiles(skin, realm, realmSkin);
+                            migrateFiles(skin, r, realmSkin);
 
-                            realm.Add(realmSkin);
+                            r.Add(realmSkin);
 
                             if (skin.ID == userSkinInt)
                                 userSkinChoice.Value = realmSkin.ID.ToString();
@@ -428,12 +428,12 @@ namespace osu.Game.Database
 
             log("Beginning settings migration to realm");
 
-            realm.Run(realm =>
+            realm.Run(r =>
             {
-                using (var transaction = realm.BeginWrite())
+                using (var transaction = r.BeginWrite())
                 {
                     // only migrate data if the realm database is empty.
-                    if (!realm.All<RealmRulesetSetting>().Any())
+                    if (!r.All<RealmRulesetSetting>().Any())
                     {
                         log($"Migrating {existingSettings.Count} settings");
 
@@ -447,7 +447,7 @@ namespace osu.Game.Database
                             if (string.IsNullOrEmpty(shortName))
                                 continue;
 
-                            realm.Add(new RealmRulesetSetting
+                            r.Add(new RealmRulesetSetting
                             {
                                 Key = dkb.Key,
                                 Value = dkb.StringValue,
diff --git a/osu.Game/Database/RealmLive.cs b/osu.Game/Database/RealmLive.cs
index 29159fd5be..f06ba1eff9 100644
--- a/osu.Game/Database/RealmLive.cs
+++ b/osu.Game/Database/RealmLive.cs
@@ -51,10 +51,7 @@ namespace osu.Game.Database
                 return;
             }
 
-            realm.Run(realm =>
-            {
-                perform(retrieveFromID(realm, ID));
-            });
+            realm.Run(r => perform(retrieveFromID(r, ID)));
         }
 
         /// <summary>
@@ -66,9 +63,9 @@ namespace osu.Game.Database
             if (!IsManaged)
                 return perform(data);
 
-            return realm.Run(realm =>
+            return realm.Run(r =>
             {
-                var returnData = perform(retrieveFromID(realm, ID));
+                var returnData = perform(retrieveFromID(r, ID));
 
                 if (returnData is RealmObjectBase realmObject && realmObject.IsManaged)
                     throw new InvalidOperationException(@$"Managed realm objects should not exit the scope of {nameof(PerformRead)}.");
diff --git a/osu.Game/Input/RealmKeyBindingStore.cs b/osu.Game/Input/RealmKeyBindingStore.cs
index cccd42a9aa..20971ffca5 100644
--- a/osu.Game/Input/RealmKeyBindingStore.cs
+++ b/osu.Game/Input/RealmKeyBindingStore.cs
@@ -56,21 +56,21 @@ namespace osu.Game.Input
         /// <param name="rulesets">The rulesets to populate defaults from.</param>
         public void Register(KeyBindingContainer container, IEnumerable<RulesetInfo> rulesets)
         {
-            realm.Run(realm =>
+            realm.Run(r =>
             {
-                using (var transaction = realm.BeginWrite())
+                using (var transaction = r.BeginWrite())
                 {
                     // intentionally flattened to a list rather than querying against the IQueryable, as nullable fields being queried against aren't indexed.
                     // this is much faster as a result.
-                    var existingBindings = realm.All<RealmKeyBinding>().ToList();
+                    var existingBindings = r.All<RealmKeyBinding>().ToList();
 
-                    insertDefaults(realm, existingBindings, container.DefaultKeyBindings);
+                    insertDefaults(r, existingBindings, container.DefaultKeyBindings);
 
                     foreach (var ruleset in rulesets)
                     {
                         var instance = ruleset.CreateInstance();
                         foreach (int variant in instance.AvailableVariants)
-                            insertDefaults(realm, existingBindings, instance.GetDefaultKeyBindings(variant), ruleset.ShortName, variant);
+                            insertDefaults(r, existingBindings, instance.GetDefaultKeyBindings(variant), ruleset.ShortName, variant);
                     }
 
                     transaction.Commit();
diff --git a/osu.Game/Overlays/Settings/Sections/Input/KeyBindingRow.cs b/osu.Game/Overlays/Settings/Sections/Input/KeyBindingRow.cs
index 91883e4f41..2405618917 100644
--- a/osu.Game/Overlays/Settings/Sections/Input/KeyBindingRow.cs
+++ b/osu.Game/Overlays/Settings/Sections/Input/KeyBindingRow.cs
@@ -386,10 +386,10 @@ namespace osu.Game.Overlays.Settings.Sections.Input
 
         private void updateStoreFromButton(KeyButton button)
         {
-            realm.Run(realm =>
+            realm.Run(r =>
             {
-                var binding = realm.Find<RealmKeyBinding>(((IHasGuidPrimaryKey)button.KeyBinding).ID);
-                realm.Write(() => binding.KeyCombinationString = button.KeyBinding.KeyCombinationString);
+                var binding = r.Find<RealmKeyBinding>(((IHasGuidPrimaryKey)button.KeyBinding).ID);
+                r.Write(() => binding.KeyCombinationString = button.KeyBinding.KeyCombinationString);
             });
         }
 
diff --git a/osu.Game/Scoring/ScoreManager.cs b/osu.Game/Scoring/ScoreManager.cs
index e712d170cd..bb26bd3b04 100644
--- a/osu.Game/Scoring/ScoreManager.cs
+++ b/osu.Game/Scoring/ScoreManager.cs
@@ -51,7 +51,7 @@ namespace osu.Game.Scoring
         /// <returns>The first result for the provided query, or null if no results were found.</returns>
         public ScoreInfo Query(Expression<Func<ScoreInfo, bool>> query)
         {
-            return realm.Run(realm => realm.All<ScoreInfo>().FirstOrDefault(query)?.Detach());
+            return realm.Run(r => r.All<ScoreInfo>().FirstOrDefault(query)?.Detach());
         }
 
         /// <summary>
@@ -254,10 +254,10 @@ namespace osu.Game.Scoring
 
         public void Delete([CanBeNull] Expression<Func<ScoreInfo, bool>> filter = null, bool silent = false)
         {
-            realm.Run(realm =>
+            realm.Run(r =>
             {
-                var items = realm.All<ScoreInfo>()
-                                 .Where(s => !s.DeletePending);
+                var items = r.All<ScoreInfo>()
+                             .Where(s => !s.DeletePending);
 
                 if (filter != null)
                     items = items.Where(filter);
diff --git a/osu.Game/Screens/Select/BeatmapCarousel.cs b/osu.Game/Screens/Select/BeatmapCarousel.cs
index 8e0fdea0f8..b02abd2f7a 100644
--- a/osu.Game/Screens/Select/BeatmapCarousel.cs
+++ b/osu.Game/Screens/Select/BeatmapCarousel.cs
@@ -179,7 +179,7 @@ namespace osu.Game.Screens.Select
 
             if (!loadedTestBeatmaps)
             {
-                realm.Run(realm => loadBeatmapSets(getBeatmapSets(realm)));
+                realm.Run(r => loadBeatmapSets(getBeatmapSets(r)));
             }
         }
 
diff --git a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
index 3d262f8b97..b53aa6f43c 100644
--- a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
+++ b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
@@ -150,12 +150,12 @@ namespace osu.Game.Screens.Select.Leaderboards
 
             if (Scope == BeatmapLeaderboardScope.Local)
             {
-                realm.Run(realm =>
+                realm.Run(r =>
                 {
-                    var scores = realm.All<ScoreInfo>()
-                                      .AsEnumerable()
-                                      // TODO: update to use a realm filter directly (or at least figure out the beatmap part to reduce scope).
-                                      .Where(s => !s.DeletePending && s.BeatmapInfo.ID == fetchBeatmapInfo.ID && s.Ruleset.OnlineID == ruleset.Value.ID);
+                    var scores = r.All<ScoreInfo>()
+                                  .AsEnumerable()
+                                  // TODO: update to use a realm filter directly (or at least figure out the beatmap part to reduce scope).
+                                  .Where(s => !s.DeletePending && s.BeatmapInfo.ID == fetchBeatmapInfo.ID && s.Ruleset.OnlineID == ruleset.Value.ID);
 
                     if (filterMods && !mods.Value.Any())
                     {
diff --git a/osu.Game/Skinning/SkinManager.cs b/osu.Game/Skinning/SkinManager.cs
index 66956325da..22fb8ce86f 100644
--- a/osu.Game/Skinning/SkinManager.cs
+++ b/osu.Game/Skinning/SkinManager.cs
@@ -289,10 +289,10 @@ namespace osu.Game.Skinning
 
         public void Delete([CanBeNull] Expression<Func<SkinInfo, bool>> filter = null, bool silent = false)
         {
-            realm.Run(realm =>
+            realm.Run(r =>
             {
-                var items = realm.All<SkinInfo>()
-                                 .Where(s => !s.Protected && !s.DeletePending);
+                var items = r.All<SkinInfo>()
+                             .Where(s => !s.Protected && !s.DeletePending);
                 if (filter != null)
                     items = items.Where(filter);
 

From d7342880f5a099e3260695bd04741a61864ff921 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 25 Jan 2022 13:09:47 +0900
Subject: [PATCH 2464/5547] Update remaining cases of clashes with
 `realm.Write` and `realm.RegisterForNotifications`

---
 .../Database/TestRealmKeyBindingStore.cs           |  8 ++++----
 osu.Game/Database/EFToRealmMigrator.cs             | 10 +++++-----
 .../Input/Bindings/DatabasedKeyBindingContainer.cs |  2 +-
 osu.Game/Online/BeatmapDownloadTracker.cs          |  2 +-
 .../Rooms/OnlinePlayBeatmapAvailabilityTracker.cs  |  2 +-
 osu.Game/Online/ScoreDownloadTracker.cs            |  2 +-
 osu.Game/Overlays/MusicController.cs               |  2 +-
 osu.Game/Overlays/Settings/Sections/SkinSection.cs |  2 +-
 .../Rulesets/Configuration/RulesetConfigManager.cs |  4 ++--
 osu.Game/Rulesets/RulesetStore.cs                  |  6 +++---
 osu.Game/Screens/Select/BeatmapCarousel.cs         |  6 +++---
 osu.Game/Screens/Select/Carousel/TopLocalRank.cs   | 14 +++++++-------
 .../Select/Leaderboards/BeatmapLeaderboard.cs      |  6 +++---
 osu.Game/Skinning/SkinManager.cs                   |  6 +++---
 osu.Game/Stores/RealmFileStore.cs                  |  6 +++---
 15 files changed, 39 insertions(+), 39 deletions(-)

diff --git a/osu.Game.Tests/Database/TestRealmKeyBindingStore.cs b/osu.Game.Tests/Database/TestRealmKeyBindingStore.cs
index 7b2d2a1278..891801865f 100644
--- a/osu.Game.Tests/Database/TestRealmKeyBindingStore.cs
+++ b/osu.Game.Tests/Database/TestRealmKeyBindingStore.cs
@@ -60,11 +60,11 @@ namespace osu.Game.Tests.Database
             KeyBindingContainer testContainer = new TestKeyBindingContainer();
 
             // Add some excess bindings for an action which only supports 1.
-            realm.Write(realm =>
+            realm.Write(r =>
             {
-                realm.Add(new RealmKeyBinding(GlobalAction.Back, new KeyCombination(InputKey.A)));
-                realm.Add(new RealmKeyBinding(GlobalAction.Back, new KeyCombination(InputKey.S)));
-                realm.Add(new RealmKeyBinding(GlobalAction.Back, new KeyCombination(InputKey.D)));
+                r.Add(new RealmKeyBinding(GlobalAction.Back, new KeyCombination(InputKey.A)));
+                r.Add(new RealmKeyBinding(GlobalAction.Back, new KeyCombination(InputKey.S)));
+                r.Add(new RealmKeyBinding(GlobalAction.Back, new KeyCombination(InputKey.D)));
             });
 
             Assert.That(queryCount(GlobalAction.Back), Is.EqualTo(3));
diff --git a/osu.Game/Database/EFToRealmMigrator.cs b/osu.Game/Database/EFToRealmMigrator.cs
index 349452afce..adf91e4a41 100644
--- a/osu.Game/Database/EFToRealmMigrator.cs
+++ b/osu.Game/Database/EFToRealmMigrator.cs
@@ -101,15 +101,15 @@ namespace osu.Game.Database
             {
                 using (var ef = efContextFactory.Get())
                 {
-                    realm.Write(realm =>
+                    realm.Write(r =>
                     {
                         // Before beginning, ensure realm is in an empty state.
                         // Migrations which are half-completed could lead to issues if the user tries a second time.
                         // Note that we only do this for beatmaps and scores since the other migrations are yonks old.
-                        realm.RemoveAll<BeatmapSetInfo>();
-                        realm.RemoveAll<BeatmapInfo>();
-                        realm.RemoveAll<BeatmapMetadata>();
-                        realm.RemoveAll<ScoreInfo>();
+                        r.RemoveAll<BeatmapSetInfo>();
+                        r.RemoveAll<BeatmapInfo>();
+                        r.RemoveAll<BeatmapMetadata>();
+                        r.RemoveAll<ScoreInfo>();
                     });
 
                     migrateSettings(ef);
diff --git a/osu.Game/Input/Bindings/DatabasedKeyBindingContainer.cs b/osu.Game/Input/Bindings/DatabasedKeyBindingContainer.cs
index d54c049c99..3e4a9759a3 100644
--- a/osu.Game/Input/Bindings/DatabasedKeyBindingContainer.cs
+++ b/osu.Game/Input/Bindings/DatabasedKeyBindingContainer.cs
@@ -55,7 +55,7 @@ namespace osu.Game.Input.Bindings
 
         protected override void LoadComplete()
         {
-            realmSubscription = realm.RegisterForNotifications(realm => queryRealmKeyBindings(), (sender, changes, error) =>
+            realmSubscription = realm.RegisterForNotifications(r => queryRealmKeyBindings(), (sender, changes, error) =>
             {
                 // The first fire of this is a bit redundant as this is being called in base.LoadComplete,
                 // but this is safest in case the subscription is restored after a context recycle.
diff --git a/osu.Game/Online/BeatmapDownloadTracker.cs b/osu.Game/Online/BeatmapDownloadTracker.cs
index f54dc30620..9f795f007a 100644
--- a/osu.Game/Online/BeatmapDownloadTracker.cs
+++ b/osu.Game/Online/BeatmapDownloadTracker.cs
@@ -42,7 +42,7 @@ namespace osu.Game.Online
             // Used to interact with manager classes that don't support interface types. Will eventually be replaced.
             var beatmapSetInfo = new BeatmapSetInfo { OnlineID = TrackedItem.OnlineID };
 
-            realmSubscription = realm.RegisterForNotifications(realm => realm.All<BeatmapSetInfo>().Where(s => s.OnlineID == TrackedItem.OnlineID && !s.DeletePending), (items, changes, ___) =>
+            realmSubscription = realm.RegisterForNotifications(r => r.All<BeatmapSetInfo>().Where(s => s.OnlineID == TrackedItem.OnlineID && !s.DeletePending), (items, changes, ___) =>
             {
                 if (items.Any())
                     Schedule(() => UpdateState(DownloadState.LocallyAvailable));
diff --git a/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs b/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs
index c562695ac1..c67cbade6a 100644
--- a/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs
+++ b/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs
@@ -78,7 +78,7 @@ namespace osu.Game.Online.Rooms
 
                 // handles changes to hash that didn't occur from the import process (ie. a user editing the beatmap in the editor, somehow).
                 realmSubscription?.Dispose();
-                realmSubscription = realm.RegisterForNotifications(realm => filteredBeatmaps(), (items, changes, ___) =>
+                realmSubscription = realm.RegisterForNotifications(r => filteredBeatmaps(), (items, changes, ___) =>
                 {
                     if (changes == null)
                         return;
diff --git a/osu.Game/Online/ScoreDownloadTracker.cs b/osu.Game/Online/ScoreDownloadTracker.cs
index 81dfc811a4..d7e31c8a59 100644
--- a/osu.Game/Online/ScoreDownloadTracker.cs
+++ b/osu.Game/Online/ScoreDownloadTracker.cs
@@ -47,7 +47,7 @@ namespace osu.Game.Online
             Downloader.DownloadBegan += downloadBegan;
             Downloader.DownloadFailed += downloadFailed;
 
-            realmSubscription = realm.RegisterForNotifications(realm => realm.All<ScoreInfo>().Where(s => ((s.OnlineID > 0 && s.OnlineID == TrackedItem.OnlineID) || s.Hash == TrackedItem.Hash) && !s.DeletePending), (items, changes, ___) =>
+            realmSubscription = realm.RegisterForNotifications(r => r.All<ScoreInfo>().Where(s => ((s.OnlineID > 0 && s.OnlineID == TrackedItem.OnlineID) || s.Hash == TrackedItem.Hash) && !s.DeletePending), (items, changes, ___) =>
             {
                 if (items.Any())
                     Schedule(() => UpdateState(DownloadState.LocallyAvailable));
diff --git a/osu.Game/Overlays/MusicController.cs b/osu.Game/Overlays/MusicController.cs
index 0f8e390ebf..9dc55d24dd 100644
--- a/osu.Game/Overlays/MusicController.cs
+++ b/osu.Game/Overlays/MusicController.cs
@@ -79,7 +79,7 @@ namespace osu.Game.Overlays
         protected override void LoadComplete()
         {
             base.LoadComplete();
-            beatmapSubscription = realm.RegisterForNotifications(realm => queryRealmBeatmapSets(), beatmapsChanged);
+            beatmapSubscription = realm.RegisterForNotifications(r => queryRealmBeatmapSets(), beatmapsChanged);
         }
 
         private void beatmapsChanged(IRealmCollection<BeatmapSetInfo> sender, ChangeSet changes, Exception error)
diff --git a/osu.Game/Overlays/Settings/Sections/SkinSection.cs b/osu.Game/Overlays/Settings/Sections/SkinSection.cs
index af3fd5c9bf..8ab296c0a8 100644
--- a/osu.Game/Overlays/Settings/Sections/SkinSection.cs
+++ b/osu.Game/Overlays/Settings/Sections/SkinSection.cs
@@ -83,7 +83,7 @@ namespace osu.Game.Overlays.Settings.Sections
 
             skinDropdown.Current = dropdownBindable;
 
-            realmSubscription = realm.RegisterForNotifications(realm => queryRealmSkins(), (sender, changes, error) =>
+            realmSubscription = realm.RegisterForNotifications(r => queryRealmSkins(), (sender, changes, error) =>
             {
                 // The first fire of this is a bit redundant due to the call below,
                 // but this is safest in case the subscription is restored after a context recycle.
diff --git a/osu.Game/Rulesets/Configuration/RulesetConfigManager.cs b/osu.Game/Rulesets/Configuration/RulesetConfigManager.cs
index cfa20e0b87..30bb95ba72 100644
--- a/osu.Game/Rulesets/Configuration/RulesetConfigManager.cs
+++ b/osu.Game/Rulesets/Configuration/RulesetConfigManager.cs
@@ -56,11 +56,11 @@ namespace osu.Game.Rulesets.Configuration
                 pendingWrites.Clear();
             }
 
-            realm?.Write(realm =>
+            realm?.Write(r =>
             {
                 foreach (var c in changed)
                 {
-                    var setting = realm.All<RealmRulesetSetting>().First(s => s.RulesetName == rulesetName && s.Variant == variant && s.Key == c.ToString());
+                    var setting = r.All<RealmRulesetSetting>().First(s => s.RulesetName == rulesetName && s.Variant == variant && s.Key == c.ToString());
 
                     setting.Value = ConfigStore[c].ToString();
                 }
diff --git a/osu.Game/Rulesets/RulesetStore.cs b/osu.Game/Rulesets/RulesetStore.cs
index 606bc65599..9af9ace7ad 100644
--- a/osu.Game/Rulesets/RulesetStore.cs
+++ b/osu.Game/Rulesets/RulesetStore.cs
@@ -18,7 +18,7 @@ namespace osu.Game.Rulesets
 {
     public class RulesetStore : IDisposable, IRulesetStore
     {
-        private readonly RealmAccess realm;
+        private readonly RealmAccess realmAccess;
 
         private const string ruleset_library_prefix = @"osu.Game.Rulesets";
 
@@ -33,7 +33,7 @@ namespace osu.Game.Rulesets
 
         public RulesetStore(RealmAccess realm, Storage? storage = null)
         {
-            this.realm = realm;
+            realmAccess = realm;
 
             // On android in release configuration assemblies are loaded from the apk directly into memory.
             // We cannot read assemblies from cwd, so should check loaded assemblies instead.
@@ -100,7 +100,7 @@ namespace osu.Game.Rulesets
 
         private void addMissingRulesets()
         {
-            realm.Write(realm =>
+            realmAccess.Write(realm =>
             {
                 var rulesets = realm.All<RulesetInfo>();
 
diff --git a/osu.Game/Screens/Select/BeatmapCarousel.cs b/osu.Game/Screens/Select/BeatmapCarousel.cs
index b02abd2f7a..dff2c598c3 100644
--- a/osu.Game/Screens/Select/BeatmapCarousel.cs
+++ b/osu.Game/Screens/Select/BeatmapCarousel.cs
@@ -191,12 +191,12 @@ namespace osu.Game.Screens.Select
             base.LoadComplete();
 
             subscriptionSets = realm.RegisterForNotifications(getBeatmapSets, beatmapSetsChanged);
-            subscriptionBeatmaps = realm.RegisterForNotifications(realm => realm.All<BeatmapInfo>().Where(b => !b.Hidden), beatmapsChanged);
+            subscriptionBeatmaps = realm.RegisterForNotifications(r => r.All<BeatmapInfo>().Where(b => !b.Hidden), beatmapsChanged);
 
             // Can't use main subscriptions because we can't lookup deleted indices.
             // https://github.com/realm/realm-dotnet/discussions/2634#discussioncomment-1605595.
-            subscriptionDeletedSets = realm.RegisterForNotifications(realm => realm.All<BeatmapSetInfo>().Where(s => s.DeletePending && !s.Protected), deletedBeatmapSetsChanged);
-            subscriptionHiddenBeatmaps = realm.RegisterForNotifications(realm => realm.All<BeatmapInfo>().Where(b => b.Hidden), beatmapsChanged);
+            subscriptionDeletedSets = realm.RegisterForNotifications(r => r.All<BeatmapSetInfo>().Where(s => s.DeletePending && !s.Protected), deletedBeatmapSetsChanged);
+            subscriptionHiddenBeatmaps = realm.RegisterForNotifications(r => r.All<BeatmapInfo>().Where(b => b.Hidden), beatmapsChanged);
         }
 
         private void deletedBeatmapSetsChanged(IRealmCollection<BeatmapSetInfo> sender, ChangeSet changes, Exception error)
diff --git a/osu.Game/Screens/Select/Carousel/TopLocalRank.cs b/osu.Game/Screens/Select/Carousel/TopLocalRank.cs
index 021dfd06f7..e1f9c1b508 100644
--- a/osu.Game/Screens/Select/Carousel/TopLocalRank.cs
+++ b/osu.Game/Screens/Select/Carousel/TopLocalRank.cs
@@ -48,13 +48,13 @@ namespace osu.Game.Screens.Select.Carousel
             ruleset.BindValueChanged(_ =>
             {
                 scoreSubscription?.Dispose();
-                scoreSubscription = realm.RegisterForNotifications(realm =>
-                        realm.All<ScoreInfo>()
-                             .Filter($"{nameof(ScoreInfo.User)}.{nameof(RealmUser.OnlineID)} == $0"
-                                     + $" && {nameof(ScoreInfo.BeatmapInfo)}.{nameof(BeatmapInfo.ID)} == $1"
-                                     + $" && {nameof(ScoreInfo.Ruleset)}.{nameof(RulesetInfo.ShortName)} == $2"
-                                     + $" && {nameof(ScoreInfo.DeletePending)} == false", api.LocalUser.Value.Id, beatmapInfo.ID, ruleset.Value.ShortName)
-                             .OrderByDescending(s => s.TotalScore),
+                scoreSubscription = realm.RegisterForNotifications(r =>
+                        r.All<ScoreInfo>()
+                         .Filter($"{nameof(ScoreInfo.User)}.{nameof(RealmUser.OnlineID)} == $0"
+                                 + $" && {nameof(ScoreInfo.BeatmapInfo)}.{nameof(BeatmapInfo.ID)} == $1"
+                                 + $" && {nameof(ScoreInfo.Ruleset)}.{nameof(RulesetInfo.ShortName)} == $2"
+                                 + $" && {nameof(ScoreInfo.DeletePending)} == false", api.LocalUser.Value.Id, beatmapInfo.ID, ruleset.Value.ShortName)
+                         .OrderByDescending(s => s.TotalScore),
                     (items, changes, ___) =>
                     {
                         Rank = items.FirstOrDefault()?.Rank;
diff --git a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
index b53aa6f43c..f25997650b 100644
--- a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
+++ b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
@@ -113,9 +113,9 @@ namespace osu.Game.Screens.Select.Leaderboards
             if (beatmapInfo == null)
                 return;
 
-            scoreSubscription = realm.RegisterForNotifications(realm =>
-                    realm.All<ScoreInfo>()
-                         .Filter($"{nameof(ScoreInfo.BeatmapInfo)}.{nameof(BeatmapInfo.ID)} = $0", beatmapInfo.ID),
+            scoreSubscription = realm.RegisterForNotifications(r =>
+                    r.All<ScoreInfo>()
+                     .Filter($"{nameof(ScoreInfo.BeatmapInfo)}.{nameof(BeatmapInfo.ID)} = $0", beatmapInfo.ID),
                 (_, changes, ___) =>
                 {
                     if (!IsOnlineScope)
diff --git a/osu.Game/Skinning/SkinManager.cs b/osu.Game/Skinning/SkinManager.cs
index 22fb8ce86f..344acb7a0f 100644
--- a/osu.Game/Skinning/SkinManager.cs
+++ b/osu.Game/Skinning/SkinManager.cs
@@ -87,12 +87,12 @@ namespace osu.Game.Skinning
             };
 
             // Ensure the default entries are present.
-            realm.Write(realm =>
+            realm.Write(r =>
             {
                 foreach (var skin in defaultSkins)
                 {
-                    if (realm.Find<SkinInfo>(skin.SkinInfo.ID) == null)
-                        realm.Add(skin.SkinInfo.Value);
+                    if (r.Find<SkinInfo>(skin.SkinInfo.ID) == null)
+                        r.Add(skin.SkinInfo.Value);
                 }
             });
 
diff --git a/osu.Game/Stores/RealmFileStore.cs b/osu.Game/Stores/RealmFileStore.cs
index 5edc1be954..b5dd3d64e4 100644
--- a/osu.Game/Stores/RealmFileStore.cs
+++ b/osu.Game/Stores/RealmFileStore.cs
@@ -92,10 +92,10 @@ namespace osu.Game.Stores
             int removedFiles = 0;
 
             // can potentially be run asynchronously, although we will need to consider operation order for disk deletion vs realm removal.
-            realm.Write(realm =>
+            realm.Write(r =>
             {
                 // TODO: consider using a realm native query to avoid iterating all files (https://github.com/realm/realm-dotnet/issues/2659#issuecomment-927823707)
-                var files = realm.All<RealmFile>().ToList();
+                var files = r.All<RealmFile>().ToList();
 
                 foreach (var file in files)
                 {
@@ -108,7 +108,7 @@ namespace osu.Game.Stores
                     {
                         removedFiles++;
                         Storage.Delete(file.GetStoragePath());
-                        realm.Remove(file);
+                        r.Remove(file);
                     }
                     catch (Exception e)
                     {

From bbcc149e2e7cc01045374b7b25be85983658aa0e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 25 Jan 2022 13:42:41 +0900
Subject: [PATCH 2465/5547] During import if files are found to be missing,
 ensure they are restored

This is one step closer to sanity in terms of physical files. As per the
comment I have left in place, we really should be checking file sizes or
hashes, but to keep things simple and fast I've opted to just cover the
"missing file" scenario for now.

Ran into this when testing against a foreign `client.realm` by:
- Noticing a beatmap doesn't load
- Deleting said beatmap
- Downloading via beatmap overlay
- Beatmap is restored but still doesn't work

Note that I've kept the logic where this will undelete an existing
import rather than create one from fresh, as I think that is beneficial
to the user (ie. it will still keep any linked scores on restore).
---
 .../Database/BeatmapImporterTests.cs          | 32 +++++++++++++++++++
 osu.Game/Stores/RealmArchiveModelImporter.cs  | 10 ++++--
 2 files changed, 39 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Tests/Database/BeatmapImporterTests.cs b/osu.Game.Tests/Database/BeatmapImporterTests.cs
index 227314cffd..abab8ae3c6 100644
--- a/osu.Game.Tests/Database/BeatmapImporterTests.cs
+++ b/osu.Game.Tests/Database/BeatmapImporterTests.cs
@@ -600,6 +600,38 @@ namespace osu.Game.Tests.Database
             });
         }
 
+        [Test]
+        public void TestImportThenReimportAfterMissingFiles()
+        {
+            RunTestWithRealmAsync(async (realmFactory, storage) =>
+            {
+                using var importer = new BeatmapModelManager(realmFactory, storage);
+                using var store = new RulesetStore(realmFactory, storage);
+
+                var imported = await LoadOszIntoStore(importer, realmFactory.Context);
+
+                deleteBeatmapSet(imported, realmFactory.Context);
+
+                Assert.IsTrue(imported.DeletePending);
+
+                // intentionally nuke all files
+                storage.DeleteDirectory("files");
+
+                Assert.That(imported.Files.All(f => !storage.GetStorageForDirectory("files").Exists(f.File.GetStoragePath())));
+
+                var importedSecondTime = await LoadOszIntoStore(importer, realmFactory.Context);
+
+                // check the newly "imported" beatmap is actually just the restored previous import. since it matches hash.
+                Assert.IsTrue(imported.ID == importedSecondTime.ID);
+                Assert.IsTrue(imported.Beatmaps.First().ID == importedSecondTime.Beatmaps.First().ID);
+                Assert.IsFalse(imported.DeletePending);
+                Assert.IsFalse(importedSecondTime.DeletePending);
+
+                // check that the files now exist, even though they were deleted above.
+                Assert.That(importedSecondTime.Files.All(f => storage.GetStorageForDirectory("files").Exists(f.File.GetStoragePath())));
+            });
+        }
+
         [Test]
         public void TestImportThenDeleteThenImportNonOptimisedPath()
         {
diff --git a/osu.Game/Stores/RealmArchiveModelImporter.cs b/osu.Game/Stores/RealmArchiveModelImporter.cs
index 3d8e9f2703..154135ea71 100644
--- a/osu.Game/Stores/RealmArchiveModelImporter.cs
+++ b/osu.Game/Stores/RealmArchiveModelImporter.cs
@@ -342,7 +342,8 @@ namespace osu.Game.Stores
                         // note that this should really be checking filesizes on disk (of existing files) for some degree of sanity.
                         // or alternatively doing a faster hash check. either of these require database changes and reprocessing of existing files.
                         if (CanSkipImport(existing, item) &&
-                            getFilenames(existing.Files).SequenceEqual(getShortenedFilenames(archive).Select(p => p.shortened).OrderBy(f => f)))
+                            getFilenames(existing.Files).SequenceEqual(getShortenedFilenames(archive).Select(p => p.shortened).OrderBy(f => f)) &&
+                            checkAllFilesExist(existing))
                         {
                             LogForModel(item, @$"Found existing (optimised) {HumanisedModelName} for {item} (ID {existing.ID}) – skipping import.");
 
@@ -459,7 +460,6 @@ namespace osu.Game.Stores
             if (!(prefix.EndsWith('/') || prefix.EndsWith('\\')))
                 prefix = string.Empty;
 
-            // import files to manager
             foreach (string file in reader.Filenames)
                 yield return (file, file.Substring(prefix.Length).ToStandardisedPath());
         }
@@ -519,7 +519,11 @@ namespace osu.Game.Stores
             // for the best or worst, we copy and import files of a new import before checking whether
             // it is a duplicate. so to check if anything has changed, we can just compare all File IDs.
             getIDs(existing.Files).SequenceEqual(getIDs(import.Files)) &&
-            getFilenames(existing.Files).SequenceEqual(getFilenames(import.Files));
+            getFilenames(existing.Files).SequenceEqual(getFilenames(import.Files)) &&
+            checkAllFilesExist(existing);
+
+        private bool checkAllFilesExist(TModel model) =>
+            model.Files.All(f => Files.Storage.Exists(f.File.GetStoragePath()));
 
         /// <summary>
         /// Whether this specified path should be removed after successful import.

From df1297ade6fcdf95b9025252aae63cbebcd0ba0b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 25 Jan 2022 13:50:39 +0900
Subject: [PATCH 2466/5547] Update framework

---
 osu.Android.props        | 2 +-
 osu.Game/osu.Game.csproj | 2 +-
 osu.iOS.props            | 4 ++--
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Android.props b/osu.Android.props
index b296c114e9..4e5b9fdbb1 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -52,7 +52,7 @@
   </ItemGroup>
   <ItemGroup>
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.115.0" />
-    <PackageReference Include="ppy.osu.Framework.Android" Version="2022.118.0" />
+    <PackageReference Include="ppy.osu.Framework.Android" Version="2022.125.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
     <!-- Realm needs to be directly referenced in all Xamarin projects, as it will not pull in its transitive dependencies otherwise. -->
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 758575e74a..af5d8a5920 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="10.8.0" />
-    <PackageReference Include="ppy.osu.Framework" Version="2022.118.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2022.125.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.115.0" />
     <PackageReference Include="Sentry" Version="3.13.0" />
     <PackageReference Include="SharpCompress" Version="0.30.1" />
diff --git a/osu.iOS.props b/osu.iOS.props
index 5925581e28..2bcdea61b3 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -60,7 +60,7 @@
     <Reference Include="System.Net.Http" />
   </ItemGroup>
   <ItemGroup Label="Package References">
-    <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.118.0" />
+    <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.125.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.115.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net5.0 / net6.0) -->
@@ -83,7 +83,7 @@
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="2.2.6" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.Core" Version="2.2.6" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
-    <PackageReference Include="ppy.osu.Framework" Version="2022.118.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2022.125.0" />
     <PackageReference Include="SharpCompress" Version="0.30.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
     <PackageReference Include="System.ComponentModel.Annotations" Version="5.0.0" />

From dd2caea694f0e2782c4c34b8dba3c165ef9136da Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 24 Jan 2022 19:10:14 +0900
Subject: [PATCH 2467/5547] Update `GetSuitableHost` usages in line with new
 `HostOptions`

---
 osu.Desktop/Program.cs                                      | 2 +-
 osu.Game.Tests/Collections/IO/ImportCollectionsTest.cs      | 3 ++-
 .../NonVisual/CustomTourneyDirectoryTest.cs                 | 5 +++--
 osu.Game.Tournament.Tests/NonVisual/IPCLocationTest.cs      | 3 ++-
 osu.Game.Tournament.Tests/TournamentTestRunner.cs           | 2 +-
 osu.Game/Tests/CleanRunHeadlessGameHost.cs                  | 6 +++++-
 osu.Game/Tests/VisualTestRunner.cs                          | 2 +-
 7 files changed, 15 insertions(+), 8 deletions(-)

diff --git a/osu.Desktop/Program.cs b/osu.Desktop/Program.cs
index 7ec7d53a7e..ab9935a220 100644
--- a/osu.Desktop/Program.cs
+++ b/osu.Desktop/Program.cs
@@ -55,7 +55,7 @@ namespace osu.Desktop
                 }
             }
 
-            using (DesktopGameHost host = Host.GetSuitableHost(gameName, true))
+            using (DesktopGameHost host = Host.GetSuitableDesktopHost(gameName, new HostOptions { PortableInstallation = true }))
             {
                 host.ExceptionThrown += handleException;
 
diff --git a/osu.Game.Tests/Collections/IO/ImportCollectionsTest.cs b/osu.Game.Tests/Collections/IO/ImportCollectionsTest.cs
index 53e4ef07e7..ee746ba4d5 100644
--- a/osu.Game.Tests/Collections/IO/ImportCollectionsTest.cs
+++ b/osu.Game.Tests/Collections/IO/ImportCollectionsTest.cs
@@ -6,6 +6,7 @@ using System.IO;
 using System.Text;
 using System.Threading.Tasks;
 using NUnit.Framework;
+using osu.Framework;
 using osu.Framework.Extensions;
 using osu.Framework.Platform;
 using osu.Framework.Testing;
@@ -155,7 +156,7 @@ namespace osu.Game.Tests.Collections.IO
             }
 
             // Name matches the automatically chosen name from `CleanRunHeadlessGameHost` above, so we end up using the same storage location.
-            using (HeadlessGameHost host = new TestRunHeadlessGameHost(firstRunName))
+            using (HeadlessGameHost host = new TestRunHeadlessGameHost(firstRunName, null))
             {
                 try
                 {
diff --git a/osu.Game.Tournament.Tests/NonVisual/CustomTourneyDirectoryTest.cs b/osu.Game.Tournament.Tests/NonVisual/CustomTourneyDirectoryTest.cs
index fc5d3b652f..36d0c6f0f6 100644
--- a/osu.Game.Tournament.Tests/NonVisual/CustomTourneyDirectoryTest.cs
+++ b/osu.Game.Tournament.Tests/NonVisual/CustomTourneyDirectoryTest.cs
@@ -4,6 +4,7 @@
 using System.IO;
 using System.Linq;
 using NUnit.Framework;
+using osu.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Platform;
 using osu.Framework.Testing;
@@ -37,7 +38,7 @@ namespace osu.Game.Tournament.Tests.NonVisual
         [Test]
         public void TestCustomDirectory()
         {
-            using (HeadlessGameHost host = new TestRunHeadlessGameHost(nameof(TestCustomDirectory))) // don't use clean run as we are writing a config file.
+            using (HeadlessGameHost host = new TestRunHeadlessGameHost(nameof(TestCustomDirectory), null)) // don't use clean run as we are writing a config file.
             {
                 string osuDesktopStorage = Path.Combine(host.UserStoragePaths.First(), nameof(TestCustomDirectory));
                 const string custom_tournament = "custom";
@@ -68,7 +69,7 @@ namespace osu.Game.Tournament.Tests.NonVisual
         [Test]
         public void TestMigration()
         {
-            using (HeadlessGameHost host = new TestRunHeadlessGameHost(nameof(TestMigration))) // don't use clean run as we are writing test files for migration.
+            using (HeadlessGameHost host = new TestRunHeadlessGameHost(nameof(TestMigration), null)) // don't use clean run as we are writing test files for migration.
             {
                 string osuRoot = Path.Combine(host.UserStoragePaths.First(), nameof(TestMigration));
                 string configFile = Path.Combine(osuRoot, "tournament.ini");
diff --git a/osu.Game.Tournament.Tests/NonVisual/IPCLocationTest.cs b/osu.Game.Tournament.Tests/NonVisual/IPCLocationTest.cs
index 03252e3be6..11b686e3e8 100644
--- a/osu.Game.Tournament.Tests/NonVisual/IPCLocationTest.cs
+++ b/osu.Game.Tournament.Tests/NonVisual/IPCLocationTest.cs
@@ -4,6 +4,7 @@
 using System.IO;
 using System.Linq;
 using NUnit.Framework;
+using osu.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Platform;
 using osu.Framework.Testing;
@@ -19,7 +20,7 @@ namespace osu.Game.Tournament.Tests.NonVisual
         public void CheckIPCLocation()
         {
             // don't use clean run because files are being written before osu! launches.
-            using (var host = new TestRunHeadlessGameHost(nameof(CheckIPCLocation)))
+            using (var host = new TestRunHeadlessGameHost(nameof(CheckIPCLocation), null))
             {
                 string basePath = Path.Combine(host.UserStoragePaths.First(), nameof(CheckIPCLocation));
 
diff --git a/osu.Game.Tournament.Tests/TournamentTestRunner.cs b/osu.Game.Tournament.Tests/TournamentTestRunner.cs
index 1f63f7c545..23da37a6b7 100644
--- a/osu.Game.Tournament.Tests/TournamentTestRunner.cs
+++ b/osu.Game.Tournament.Tests/TournamentTestRunner.cs
@@ -12,7 +12,7 @@ namespace osu.Game.Tournament.Tests
         [STAThread]
         public static int Main(string[] args)
         {
-            using (DesktopGameHost host = Host.GetSuitableHost(@"osu", true))
+            using (DesktopGameHost host = Host.GetSuitableDesktopHost(@"osu", new HostOptions { PortableInstallation = true }))
             {
                 host.Run(new TournamentTestBrowser());
                 return 0;
diff --git a/osu.Game/Tests/CleanRunHeadlessGameHost.cs b/osu.Game/Tests/CleanRunHeadlessGameHost.cs
index 754c9044e8..bdb171c528 100644
--- a/osu.Game/Tests/CleanRunHeadlessGameHost.cs
+++ b/osu.Game/Tests/CleanRunHeadlessGameHost.cs
@@ -3,6 +3,7 @@
 
 using System;
 using System.Runtime.CompilerServices;
+using osu.Framework;
 using osu.Framework.Testing;
 
 namespace osu.Game.Tests
@@ -20,7 +21,10 @@ namespace osu.Game.Tests
         /// <param name="bypassCleanup">Whether to bypass directory cleanup on host disposal. Should be used only if a subsequent test relies on the files still existing.</param>
         /// <param name="callingMethodName">The name of the calling method, used for test file isolation and clean-up.</param>
         public CleanRunHeadlessGameHost(bool bindIPC = false, bool realtime = true, bool bypassCleanup = false, [CallerMemberName] string callingMethodName = @"")
-            : base($"{callingMethodName}-{Guid.NewGuid()}", bindIPC, realtime, bypassCleanup: bypassCleanup)
+            : base($"{callingMethodName}-{Guid.NewGuid()}", new HostOptions
+            {
+                BindIPC = bindIPC,
+            }, bypassCleanup: bypassCleanup, realtime: realtime)
         {
         }
 
diff --git a/osu.Game/Tests/VisualTestRunner.cs b/osu.Game/Tests/VisualTestRunner.cs
index d63b3d48b2..973801099e 100644
--- a/osu.Game/Tests/VisualTestRunner.cs
+++ b/osu.Game/Tests/VisualTestRunner.cs
@@ -12,7 +12,7 @@ namespace osu.Game.Tests
         [STAThread]
         public static int Main(string[] args)
         {
-            using (DesktopGameHost host = Host.GetSuitableHost(@"osu", true))
+            using (DesktopGameHost host = Host.GetSuitableDesktopHost(@"osu", new HostOptions { PortableInstallation = true, }))
             {
                 host.Run(new OsuTestBrowser());
                 return 0;

From a5c76a9647c56b1677bd9105c93220ee7ad59441 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 25 Jan 2022 13:56:47 +0900
Subject: [PATCH 2468/5547] Fix a few more cases of "context" terminology usage

---
 osu.Game/Database/RealmAccess.cs | 24 ++++++++++++------------
 1 file changed, 12 insertions(+), 12 deletions(-)

diff --git a/osu.Game/Database/RealmAccess.cs b/osu.Game/Database/RealmAccess.cs
index 66b4edbe84..65e13cf542 100644
--- a/osu.Game/Database/RealmAccess.cs
+++ b/osu.Game/Database/RealmAccess.cs
@@ -30,7 +30,7 @@ using Realms.Exceptions;
 namespace osu.Game.Database
 {
     /// <summary>
-    /// A factory which provides both the main (update thread bound) realm context and creates contexts for async usage.
+    /// A factory which provides safe access to the realm storage backend.
     /// </summary>
     public class RealmAccess : IDisposable
     {
@@ -57,9 +57,9 @@ namespace osu.Game.Database
         private const int schema_version = 13;
 
         /// <summary>
-        /// Lock object which is held during <see cref="BlockAllOperations"/> sections, blocking context creation during blocking periods.
+        /// Lock object which is held during <see cref="BlockAllOperations"/> sections, blocking realm retrieval during blocking periods.
         /// </summary>
-        private readonly SemaphoreSlim realmCreationLock = new SemaphoreSlim(1);
+        private readonly SemaphoreSlim realmRetrievalLock = new SemaphoreSlim(1);
 
         private readonly ThreadLocal<bool> currentThreadCanCreateRealmInstances = new ThreadLocal<bool>();
 
@@ -76,7 +76,7 @@ namespace osu.Game.Database
 
         /// <summary>
         /// Holds a map of functions registered via <see cref="RegisterForNotifications{T}"/> and a coinciding action which when triggered,
-        /// fires a change set event with an empty collection. This is used to inform subscribers when a realm context goes away, and ensure they don't use invalidated
+        /// fires a change set event with an empty collection. This is used to inform subscribers when the main realm instance gets recycled, and ensure they don't use invalidated
         /// managed realm objects from a previous firing.
         /// </summary>
         private readonly Dictionary<Func<Realm, IDisposable?>, Action> notificationsResetMap = new Dictionary<Func<Realm, IDisposable?>, Action>();
@@ -364,7 +364,7 @@ namespace osu.Game.Database
             {
                 if (!currentThreadCanCreateRealmInstances.Value)
                 {
-                    realmCreationLock.Wait();
+                    realmRetrievalLock.Wait();
                     currentThreadCanCreateRealmInstances.Value = true;
                     tookSemaphoreLock = true;
                 }
@@ -383,7 +383,7 @@ namespace osu.Game.Database
             {
                 if (tookSemaphoreLock)
                 {
-                    realmCreationLock.Release();
+                    realmRetrievalLock.Release();
                     currentThreadCanCreateRealmInstances.Value = false;
                 }
             }
@@ -589,7 +589,7 @@ namespace osu.Game.Database
 
             try
             {
-                realmCreationLock.Wait();
+                realmRetrievalLock.Wait();
 
                 lock (realmLock)
                 {
@@ -639,13 +639,13 @@ namespace osu.Game.Database
             }
             catch
             {
-                realmCreationLock.Release();
+                realmRetrievalLock.Release();
                 throw;
             }
 
             return new InvokeOnDisposal<RealmAccess>(this, factory =>
             {
-                factory.realmCreationLock.Release();
+                factory.realmRetrievalLock.Release();
                 Logger.Log(@"Restoring realm operations.", LoggingTarget.Database);
 
                 // Post back to the update thread to revive any subscriptions.
@@ -667,9 +667,9 @@ namespace osu.Game.Database
 
             if (!isDisposed)
             {
-                // intentionally block context creation indefinitely. this ensures that nothing can start consuming a new context after disposal.
-                realmCreationLock.Wait();
-                realmCreationLock.Dispose();
+                // intentionally block realm retrieval indefinitely. this ensures that nothing can start consuming a new instance after disposal.
+                realmRetrievalLock.Wait();
+                realmRetrievalLock.Dispose();
 
                 isDisposed = true;
             }

From 8116806db3fa6b06e96d1f38eac77964a96435a2 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 25 Jan 2022 14:00:58 +0900
Subject: [PATCH 2469/5547] Add test coverage of calling `BlockAllOperations` a
 second time after timeout

---
 osu.Game.Tests/Database/GeneralUsageTests.cs | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/osu.Game.Tests/Database/GeneralUsageTests.cs b/osu.Game.Tests/Database/GeneralUsageTests.cs
index 2533c832e6..8262ef18d4 100644
--- a/osu.Game.Tests/Database/GeneralUsageTests.cs
+++ b/osu.Game.Tests/Database/GeneralUsageTests.cs
@@ -95,6 +95,11 @@ namespace osu.Game.Tests.Database
                 });
 
                 stopThreadedUsage.Set();
+
+                // Ensure we can block a second time after the usage has ended.
+                using (realm.BlockAllOperations())
+                {
+                }
             });
         }
     }

From 86c844bd58317c2fc5d978a6142ea3ac153794a3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 25 Jan 2022 14:15:29 +0900
Subject: [PATCH 2470/5547] Update remaining usages of `GetSuitableHost` in
 template projects

---
 .../osu.Game.Rulesets.EmptyFreeform.Tests/VisualTestRunner.cs   | 2 +-
 .../osu.Game.Rulesets.Pippidon.Tests/VisualTestRunner.cs        | 2 +-
 .../osu.Game.Rulesets.EmptyScrolling.Tests/VisualTestRunner.cs  | 2 +-
 .../osu.Game.Rulesets.Pippidon.Tests/VisualTestRunner.cs        | 2 +-
 osu.Game.Tests/Collections/IO/ImportCollectionsTest.cs          | 1 -
 .../NonVisual/CustomTourneyDirectoryTest.cs                     | 1 -
 osu.Game.Tournament.Tests/NonVisual/IPCLocationTest.cs          | 1 -
 7 files changed, 4 insertions(+), 7 deletions(-)

diff --git a/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform.Tests/VisualTestRunner.cs b/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform.Tests/VisualTestRunner.cs
index 4f810ce17f..03ee7c9204 100644
--- a/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform.Tests/VisualTestRunner.cs
+++ b/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform.Tests/VisualTestRunner.cs
@@ -13,7 +13,7 @@ namespace osu.Game.Rulesets.EmptyFreeform.Tests
         [STAThread]
         public static int Main(string[] args)
         {
-            using (DesktopGameHost host = Host.GetSuitableHost(@"osu", true))
+            using (DesktopGameHost host = Host.GetSuitableDesktopHost(@"osu", new HostOptions { BindIPC = true }))
             {
                 host.Run(new OsuTestBrowser());
                 return 0;
diff --git a/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon.Tests/VisualTestRunner.cs b/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon.Tests/VisualTestRunner.cs
index fd6bd9b714..55c0cf6a3b 100644
--- a/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon.Tests/VisualTestRunner.cs
+++ b/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon.Tests/VisualTestRunner.cs
@@ -13,7 +13,7 @@ namespace osu.Game.Rulesets.Pippidon.Tests
         [STAThread]
         public static int Main(string[] args)
         {
-            using (DesktopGameHost host = Host.GetSuitableHost(@"osu", true))
+            using (DesktopGameHost host = Host.GetSuitableDesktopHost(@"osu", new HostOptions { BindIPC = true }))
             {
                 host.Run(new OsuTestBrowser());
                 return 0;
diff --git a/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling.Tests/VisualTestRunner.cs b/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling.Tests/VisualTestRunner.cs
index 65cfb2bff4..b45505678c 100644
--- a/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling.Tests/VisualTestRunner.cs
+++ b/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling.Tests/VisualTestRunner.cs
@@ -13,7 +13,7 @@ namespace osu.Game.Rulesets.EmptyScrolling.Tests
         [STAThread]
         public static int Main(string[] args)
         {
-            using (DesktopGameHost host = Host.GetSuitableHost(@"osu", true))
+            using (DesktopGameHost host = Host.GetSuitableDesktopHost(@"osu", new HostOptions { BindIPC = true }))
             {
                 host.Run(new OsuTestBrowser());
                 return 0;
diff --git a/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon.Tests/VisualTestRunner.cs b/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon.Tests/VisualTestRunner.cs
index fd6bd9b714..55c0cf6a3b 100644
--- a/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon.Tests/VisualTestRunner.cs
+++ b/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon.Tests/VisualTestRunner.cs
@@ -13,7 +13,7 @@ namespace osu.Game.Rulesets.Pippidon.Tests
         [STAThread]
         public static int Main(string[] args)
         {
-            using (DesktopGameHost host = Host.GetSuitableHost(@"osu", true))
+            using (DesktopGameHost host = Host.GetSuitableDesktopHost(@"osu", new HostOptions { BindIPC = true }))
             {
                 host.Run(new OsuTestBrowser());
                 return 0;
diff --git a/osu.Game.Tests/Collections/IO/ImportCollectionsTest.cs b/osu.Game.Tests/Collections/IO/ImportCollectionsTest.cs
index ee746ba4d5..5cbede54f5 100644
--- a/osu.Game.Tests/Collections/IO/ImportCollectionsTest.cs
+++ b/osu.Game.Tests/Collections/IO/ImportCollectionsTest.cs
@@ -6,7 +6,6 @@ using System.IO;
 using System.Text;
 using System.Threading.Tasks;
 using NUnit.Framework;
-using osu.Framework;
 using osu.Framework.Extensions;
 using osu.Framework.Platform;
 using osu.Framework.Testing;
diff --git a/osu.Game.Tournament.Tests/NonVisual/CustomTourneyDirectoryTest.cs b/osu.Game.Tournament.Tests/NonVisual/CustomTourneyDirectoryTest.cs
index 36d0c6f0f6..26fb03bed4 100644
--- a/osu.Game.Tournament.Tests/NonVisual/CustomTourneyDirectoryTest.cs
+++ b/osu.Game.Tournament.Tests/NonVisual/CustomTourneyDirectoryTest.cs
@@ -4,7 +4,6 @@
 using System.IO;
 using System.Linq;
 using NUnit.Framework;
-using osu.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Platform;
 using osu.Framework.Testing;
diff --git a/osu.Game.Tournament.Tests/NonVisual/IPCLocationTest.cs b/osu.Game.Tournament.Tests/NonVisual/IPCLocationTest.cs
index 11b686e3e8..80cc9be5c1 100644
--- a/osu.Game.Tournament.Tests/NonVisual/IPCLocationTest.cs
+++ b/osu.Game.Tournament.Tests/NonVisual/IPCLocationTest.cs
@@ -4,7 +4,6 @@
 using System.IO;
 using System.Linq;
 using NUnit.Framework;
-using osu.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Platform;
 using osu.Framework.Testing;

From 5872dabf604f55a1feec63039404780a9d48133b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 25 Jan 2022 14:16:15 +0900
Subject: [PATCH 2471/5547] Fix incorrect flag to options conversion

---
 osu.Desktop/Program.cs                            | 2 +-
 osu.Game.Tournament.Tests/TournamentTestRunner.cs | 2 +-
 osu.Game/Tests/VisualTestRunner.cs                | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Desktop/Program.cs b/osu.Desktop/Program.cs
index ab9935a220..b944068e78 100644
--- a/osu.Desktop/Program.cs
+++ b/osu.Desktop/Program.cs
@@ -55,7 +55,7 @@ namespace osu.Desktop
                 }
             }
 
-            using (DesktopGameHost host = Host.GetSuitableDesktopHost(gameName, new HostOptions { PortableInstallation = true }))
+            using (DesktopGameHost host = Host.GetSuitableDesktopHost(gameName, new HostOptions { BindIPC = true }))
             {
                 host.ExceptionThrown += handleException;
 
diff --git a/osu.Game.Tournament.Tests/TournamentTestRunner.cs b/osu.Game.Tournament.Tests/TournamentTestRunner.cs
index 23da37a6b7..229ab41a1e 100644
--- a/osu.Game.Tournament.Tests/TournamentTestRunner.cs
+++ b/osu.Game.Tournament.Tests/TournamentTestRunner.cs
@@ -12,7 +12,7 @@ namespace osu.Game.Tournament.Tests
         [STAThread]
         public static int Main(string[] args)
         {
-            using (DesktopGameHost host = Host.GetSuitableDesktopHost(@"osu", new HostOptions { PortableInstallation = true }))
+            using (DesktopGameHost host = Host.GetSuitableDesktopHost(@"osu", new HostOptions { BindIPC = true }))
             {
                 host.Run(new TournamentTestBrowser());
                 return 0;
diff --git a/osu.Game/Tests/VisualTestRunner.cs b/osu.Game/Tests/VisualTestRunner.cs
index 973801099e..6aa75ec147 100644
--- a/osu.Game/Tests/VisualTestRunner.cs
+++ b/osu.Game/Tests/VisualTestRunner.cs
@@ -12,7 +12,7 @@ namespace osu.Game.Tests
         [STAThread]
         public static int Main(string[] args)
         {
-            using (DesktopGameHost host = Host.GetSuitableDesktopHost(@"osu", new HostOptions { PortableInstallation = true, }))
+            using (DesktopGameHost host = Host.GetSuitableDesktopHost(@"osu", new HostOptions { BindIPC = true, }))
             {
                 host.Run(new OsuTestBrowser());
                 return 0;

From 56d7d814658d1d202e405f237cf74d8a386d078b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 25 Jan 2022 14:47:21 +0900
Subject: [PATCH 2472/5547] Fix broken test due to `SynchronizationContext`
 never running expected work

---
 osu.Game.Tests/Database/GeneralUsageTests.cs | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/osu.Game.Tests/Database/GeneralUsageTests.cs b/osu.Game.Tests/Database/GeneralUsageTests.cs
index 8262ef18d4..dc0d42595b 100644
--- a/osu.Game.Tests/Database/GeneralUsageTests.cs
+++ b/osu.Game.Tests/Database/GeneralUsageTests.cs
@@ -87,6 +87,11 @@ namespace osu.Game.Tests.Database
 
                 hasThreadedUsage.Wait();
 
+                // Usually the host would run the synchronization context work per frame.
+                // For the sake of keeping this test simple (there's only one update invocation),
+                // let's replace it so we can ensure work is run immediately.
+                SynchronizationContext.SetSynchronizationContext(new ImmediateExecuteSynchronizationContext());
+
                 Assert.Throws<TimeoutException>(() =>
                 {
                     using (realm.BlockAllOperations())
@@ -102,5 +107,10 @@ namespace osu.Game.Tests.Database
                 }
             });
         }
+
+        private class ImmediateExecuteSynchronizationContext : SynchronizationContext
+        {
+            public override void Post(SendOrPostCallback d, object? state) => d(state);
+        }
     }
 }

From 5fb9b58c9b12c2929d07eaccfabf71528f259fe6 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 24 Jan 2022 20:23:10 +0900
Subject: [PATCH 2473/5547] Add tracking of total subscriptions

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

diff --git a/osu.Game/Database/RealmAccess.cs b/osu.Game/Database/RealmAccess.cs
index 65e13cf542..fe4c30d7dd 100644
--- a/osu.Game/Database/RealmAccess.cs
+++ b/osu.Game/Database/RealmAccess.cs
@@ -83,6 +83,8 @@ namespace osu.Game.Database
 
         private static readonly GlobalStatistic<int> realm_instances_created = GlobalStatistics.Get<int>(@"Realm", @"Instances (Created)");
 
+        private static readonly GlobalStatistic<int> total_subscriptions = GlobalStatistics.Get<int>(@"Realm", @"Subscriptions");
+
         private readonly object realmLock = new object();
 
         private Realm? updateRealm;
@@ -289,6 +291,8 @@ namespace osu.Game.Database
 
             var syncContext = SynchronizationContext.Current;
 
+            total_subscriptions.Value++;
+
             registerSubscription(action);
 
             // This token is returned to the consumer.
@@ -309,6 +313,7 @@ namespace osu.Game.Database
                             unsubscriptionAction?.Dispose();
                             customSubscriptionsResetMap.Remove(action);
                             notificationsResetMap.Remove(action);
+                            total_subscriptions.Value--;
                         }
                     }
                 }

From ae0fea8e2627f68f211c89a27a9bae04a651b0f3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 25 Jan 2022 15:29:45 +0900
Subject: [PATCH 2474/5547] Fix compilation issues due to misnamed fild

---
 osu.Game.Tests/Database/BeatmapImporterTests.cs | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Tests/Database/BeatmapImporterTests.cs b/osu.Game.Tests/Database/BeatmapImporterTests.cs
index 8cb762ed12..b37d2be0bc 100644
--- a/osu.Game.Tests/Database/BeatmapImporterTests.cs
+++ b/osu.Game.Tests/Database/BeatmapImporterTests.cs
@@ -608,9 +608,9 @@ namespace osu.Game.Tests.Database
                 using var importer = new BeatmapModelManager(realmFactory, storage);
                 using var store = new RulesetStore(realmFactory, storage);
 
-                var imported = await LoadOszIntoStore(importer, realmFactory.Context);
+                var imported = await LoadOszIntoStore(importer, realmFactory.Realm);
 
-                deleteBeatmapSet(imported, realmFactory.Context);
+                deleteBeatmapSet(imported, realmFactory.Realm);
 
                 Assert.IsTrue(imported.DeletePending);
 
@@ -619,7 +619,7 @@ namespace osu.Game.Tests.Database
 
                 Assert.That(imported.Files.All(f => !storage.GetStorageForDirectory("files").Exists(f.File.GetStoragePath())));
 
-                var importedSecondTime = await LoadOszIntoStore(importer, realmFactory.Context);
+                var importedSecondTime = await LoadOszIntoStore(importer, realmFactory.Realm);
 
                 // check the newly "imported" beatmap is actually just the restored previous import. since it matches hash.
                 Assert.IsTrue(imported.ID == importedSecondTime.ID);

From 778d2a71b484bb3220a09db15fc5fc632cb891e9 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 25 Jan 2022 15:23:51 +0900
Subject: [PATCH 2475/5547] Remove `Task` from the inner-most `Import` method
 in `RealmArchiveModelImporter`

One of my pending work items for post-realm merge.

The lowest-level import task is no longer asynchronous, as we don't want
it to span multiple threads to allow easier interaction with realm.
Removing the `Task` spec simplifies a heap of usages.

Individual usages should decide whether they want to run the import
asynchronously, by either using an alternative override or spooling up a
thread themselves.
---
 .../Database/BeatmapImporterTests.cs          |  4 ++--
 ...eneOnlinePlayBeatmapAvailabilityTracker.cs | 10 ++++-----
 osu.Game.Tests/Scores/IO/ImportScoreTest.cs   | 22 +++++++++----------
 .../Gameplay/TestSceneReplayDownloadButton.cs |  2 +-
 .../Menus/TestSceneMusicActionHandling.cs     |  2 +-
 .../TestSceneDrawableRoomPlaylist.cs          |  3 +--
 .../TestSceneMultiplayerMatchSongSelect.cs    |  2 +-
 .../TestScenePlaylistsSongSelect.cs           |  3 +--
 .../Navigation/TestScenePresentBeatmap.cs     |  3 +--
 .../Navigation/TestScenePresentScore.cs       |  5 ++---
 .../TestScenePlaylistsRoomCreation.cs         |  7 +++---
 .../SongSelect/TestSceneBeatmapLeaderboard.cs |  2 +-
 .../TestSceneBeatmapRecommendations.cs        |  3 +--
 .../SongSelect/TestScenePlaySongSelect.cs     | 13 +++++------
 .../TestSceneDeleteLocalScore.cs              |  2 +-
 osu.Game/Beatmaps/BeatmapManager.cs           |  5 ++---
 osu.Game/Database/IModelImporter.cs           |  2 +-
 osu.Game/Scoring/ScoreManager.cs              |  2 +-
 osu.Game/Screens/Play/Player.cs               |  8 ++++---
 osu.Game/Skinning/SkinManager.cs              |  5 ++---
 osu.Game/Stores/RealmArchiveModelImporter.cs  | 14 +++++++-----
 21 files changed, 57 insertions(+), 62 deletions(-)

diff --git a/osu.Game.Tests/Database/BeatmapImporterTests.cs b/osu.Game.Tests/Database/BeatmapImporterTests.cs
index b37d2be0bc..69dd2d930a 100644
--- a/osu.Game.Tests/Database/BeatmapImporterTests.cs
+++ b/osu.Game.Tests/Database/BeatmapImporterTests.cs
@@ -685,7 +685,7 @@ namespace osu.Game.Tests.Database
         [Test]
         public void TestImportWithDuplicateBeatmapIDs()
         {
-            RunTestWithRealmAsync(async (realm, storage) =>
+            RunTestWithRealm((realm, storage) =>
             {
                 using var importer = new BeatmapModelManager(realm, storage);
                 using var store = new RulesetStore(realm, storage);
@@ -718,7 +718,7 @@ namespace osu.Game.Tests.Database
                     }
                 };
 
-                var imported = await importer.Import(toImport);
+                var imported = importer.Import(toImport);
 
                 Assert.NotNull(imported);
                 Debug.Assert(imported != null);
diff --git a/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs b/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
index 144cbe15c3..95c15367aa 100644
--- a/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
+++ b/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
@@ -91,7 +91,7 @@ namespace osu.Game.Tests.Online
             addAvailabilityCheckStep("state importing", BeatmapAvailability.Importing);
 
             AddStep("allow importing", () => beatmaps.AllowImport.SetResult(true));
-            AddUntilStep("wait for import", () => beatmaps.CurrentImportTask?.IsCompleted == true);
+            AddUntilStep("wait for import", () => beatmaps.CurrentImport != null);
             addAvailabilityCheckStep("state locally available", BeatmapAvailability.LocallyAvailable);
         }
 
@@ -164,7 +164,7 @@ namespace osu.Game.Tests.Online
         {
             public TaskCompletionSource<bool> AllowImport = new TaskCompletionSource<bool>();
 
-            public Task<ILive<BeatmapSetInfo>> CurrentImportTask { get; private set; }
+            public ILive<BeatmapSetInfo> CurrentImport { get; private set; }
 
             public TestBeatmapManager(Storage storage, RealmAccess realm, RulesetStore rulesets, IAPIProvider api, [NotNull] AudioManager audioManager, IResourceStore<byte[]> resources, GameHost host = null, WorkingBeatmap defaultBeatmap = null)
                 : base(storage, realm, rulesets, api, audioManager, resources, host, defaultBeatmap)
@@ -186,10 +186,10 @@ namespace osu.Game.Tests.Online
                     this.testBeatmapManager = testBeatmapManager;
                 }
 
-                public override async Task<ILive<BeatmapSetInfo>> Import(BeatmapSetInfo item, ArchiveReader archive = null, bool lowPriority = false, CancellationToken cancellationToken = default)
+                public override ILive<BeatmapSetInfo> Import(BeatmapSetInfo item, ArchiveReader archive = null, bool lowPriority = false, CancellationToken cancellationToken = default)
                 {
-                    await testBeatmapManager.AllowImport.Task.ConfigureAwait(false);
-                    return await (testBeatmapManager.CurrentImportTask = base.Import(item, archive, lowPriority, cancellationToken)).ConfigureAwait(false);
+                    testBeatmapManager.AllowImport.Task.WaitSafely();
+                    return (testBeatmapManager.CurrentImport = base.Import(item, archive, lowPriority, cancellationToken));
                 }
             }
         }
diff --git a/osu.Game.Tests/Scores/IO/ImportScoreTest.cs b/osu.Game.Tests/Scores/IO/ImportScoreTest.cs
index dd12c94855..8de9f0a292 100644
--- a/osu.Game.Tests/Scores/IO/ImportScoreTest.cs
+++ b/osu.Game.Tests/Scores/IO/ImportScoreTest.cs
@@ -5,7 +5,6 @@ using System;
 using System.Collections.Generic;
 using System.IO;
 using System.Linq;
-using System.Threading.Tasks;
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Extensions;
@@ -25,7 +24,7 @@ namespace osu.Game.Tests.Scores.IO
     public class ImportScoreTest : ImportTest
     {
         [Test]
-        public async Task TestBasicImport()
+        public void TestBasicImport()
         {
             using (HeadlessGameHost host = new CleanRunHeadlessGameHost())
             {
@@ -49,7 +48,7 @@ namespace osu.Game.Tests.Scores.IO
                         BeatmapInfo = beatmap.Beatmaps.First()
                     };
 
-                    var imported = await LoadScoreIntoOsu(osu, toImport);
+                    var imported = LoadScoreIntoOsu(osu, toImport);
 
                     Assert.AreEqual(toImport.Rank, imported.Rank);
                     Assert.AreEqual(toImport.TotalScore, imported.TotalScore);
@@ -67,7 +66,7 @@ namespace osu.Game.Tests.Scores.IO
         }
 
         [Test]
-        public async Task TestImportMods()
+        public void TestImportMods()
         {
             using (HeadlessGameHost host = new CleanRunHeadlessGameHost())
             {
@@ -85,7 +84,7 @@ namespace osu.Game.Tests.Scores.IO
                         Mods = new Mod[] { new OsuModHardRock(), new OsuModDoubleTime() },
                     };
 
-                    var imported = await LoadScoreIntoOsu(osu, toImport);
+                    var imported = LoadScoreIntoOsu(osu, toImport);
 
                     Assert.IsTrue(imported.Mods.Any(m => m is OsuModHardRock));
                     Assert.IsTrue(imported.Mods.Any(m => m is OsuModDoubleTime));
@@ -98,7 +97,7 @@ namespace osu.Game.Tests.Scores.IO
         }
 
         [Test]
-        public async Task TestImportStatistics()
+        public void TestImportStatistics()
         {
             using (HeadlessGameHost host = new CleanRunHeadlessGameHost())
             {
@@ -120,7 +119,7 @@ namespace osu.Game.Tests.Scores.IO
                         }
                     };
 
-                    var imported = await LoadScoreIntoOsu(osu, toImport);
+                    var imported = LoadScoreIntoOsu(osu, toImport);
 
                     Assert.AreEqual(toImport.Statistics[HitResult.Perfect], imported.Statistics[HitResult.Perfect]);
                     Assert.AreEqual(toImport.Statistics[HitResult.Miss], imported.Statistics[HitResult.Miss]);
@@ -133,7 +132,7 @@ namespace osu.Game.Tests.Scores.IO
         }
 
         [Test]
-        public async Task TestOnlineScoreIsAvailableLocally()
+        public void TestOnlineScoreIsAvailableLocally()
         {
             using (HeadlessGameHost host = new CleanRunHeadlessGameHost())
             {
@@ -143,7 +142,7 @@ namespace osu.Game.Tests.Scores.IO
 
                     var beatmap = BeatmapImportHelper.LoadOszIntoOsu(osu, TestResources.GetQuickTestBeatmapForImport()).GetResultSafely();
 
-                    await LoadScoreIntoOsu(osu, new ScoreInfo
+                    LoadScoreIntoOsu(osu, new ScoreInfo
                     {
                         User = new APIUser { Username = "Test user" },
                         BeatmapInfo = beatmap.Beatmaps.First(),
@@ -168,13 +167,14 @@ namespace osu.Game.Tests.Scores.IO
             }
         }
 
-        public static async Task<ScoreInfo> LoadScoreIntoOsu(OsuGameBase osu, ScoreInfo score, ArchiveReader archive = null)
+        public static ScoreInfo LoadScoreIntoOsu(OsuGameBase osu, ScoreInfo score, ArchiveReader archive = null)
         {
             // clone to avoid attaching the input score to realm.
             score = score.DeepClone();
 
             var scoreManager = osu.Dependencies.Get<ScoreManager>();
-            await scoreManager.Import(score, archive);
+
+            scoreManager.Import(score, archive);
 
             return scoreManager.Query(_ => true);
         }
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneReplayDownloadButton.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneReplayDownloadButton.cs
index 8199389b36..a12171401a 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneReplayDownloadButton.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneReplayDownloadButton.cs
@@ -147,7 +147,7 @@ namespace osu.Game.Tests.Visual.Gameplay
 
             AddUntilStep("state is not downloaded", () => downloadButton.State.Value == DownloadState.NotDownloaded);
 
-            AddStep("import score", () => imported = scoreManager.Import(getScoreInfo(true)).GetResultSafely());
+            AddStep("import score", () => imported = scoreManager.Import(getScoreInfo(true)));
 
             AddUntilStep("state is available", () => downloadButton.State.Value == DownloadState.LocallyAvailable);
 
diff --git a/osu.Game.Tests/Visual/Menus/TestSceneMusicActionHandling.cs b/osu.Game.Tests/Visual/Menus/TestSceneMusicActionHandling.cs
index 3ebc64cd0b..10a82089b3 100644
--- a/osu.Game.Tests/Visual/Menus/TestSceneMusicActionHandling.cs
+++ b/osu.Game.Tests/Visual/Menus/TestSceneMusicActionHandling.cs
@@ -34,7 +34,7 @@ namespace osu.Game.Tests.Visual.Menus
             Queue<(IWorkingBeatmap working, TrackChangeDirection changeDirection)> trackChangeQueue = null;
 
             // ensure we have at least two beatmaps available to identify the direction the music controller navigated to.
-            AddRepeatStep("import beatmap", () => Game.BeatmapManager.Import(TestResources.CreateTestBeatmapSetInfo()).WaitSafely(), 5);
+            AddRepeatStep("import beatmap", () => Game.BeatmapManager.Import(TestResources.CreateTestBeatmapSetInfo()), 5);
 
             AddStep("import beatmap with track", () =>
             {
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
index 30ac1302aa..92accb0cd1 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
@@ -8,7 +8,6 @@ using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
-using osu.Framework.Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Platform;
@@ -158,7 +157,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             Debug.Assert(beatmap.BeatmapSet != null);
 
-            AddStep("import beatmap", () => imported = manager.Import(beatmap.BeatmapSet).GetResultSafely());
+            AddStep("import beatmap", () => imported = manager.Import(beatmap.BeatmapSet));
 
             createPlaylistWithBeatmaps(() => imported.PerformRead(s => s.Beatmaps.Detach()));
 
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs
index 7e3c9722cf..5465061891 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs
@@ -83,7 +83,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 beatmapSetInfo.Beatmaps.Add(beatmap);
             }
 
-            manager.Import(beatmapSetInfo).WaitSafely();
+            manager.Import(beatmapSetInfo);
         }
 
         public override void SetUpSteps()
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsSongSelect.cs b/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsSongSelect.cs
index d7a0885c95..d933491ab6 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsSongSelect.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsSongSelect.cs
@@ -6,7 +6,6 @@ using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
-using osu.Framework.Extensions;
 using osu.Framework.Platform;
 using osu.Framework.Screens;
 using osu.Framework.Utils;
@@ -40,7 +39,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             var beatmapSet = TestResources.CreateTestBeatmapSetInfo();
 
-            manager.Import(beatmapSet).WaitSafely();
+            manager.Import(beatmapSet);
         }
 
         public override void SetUpSteps()
diff --git a/osu.Game.Tests/Visual/Navigation/TestScenePresentBeatmap.cs b/osu.Game.Tests/Visual/Navigation/TestScenePresentBeatmap.cs
index f6c53e76c4..63226de750 100644
--- a/osu.Game.Tests/Visual/Navigation/TestScenePresentBeatmap.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestScenePresentBeatmap.cs
@@ -4,7 +4,6 @@
 using System;
 using System.Linq;
 using NUnit.Framework;
-using osu.Framework.Extensions;
 using osu.Framework.Screens;
 using osu.Game.Beatmaps;
 using osu.Game.Extensions;
@@ -125,7 +124,7 @@ namespace osu.Game.Tests.Visual.Navigation
                             Ruleset = ruleset ?? new OsuRuleset().RulesetInfo
                         },
                     }
-                }).GetResultSafely()?.Value;
+                })?.Value;
             });
 
             AddAssert($"import {i} succeeded", () => imported != null);
diff --git a/osu.Game.Tests/Visual/Navigation/TestScenePresentScore.cs b/osu.Game.Tests/Visual/Navigation/TestScenePresentScore.cs
index 7bd8110374..7656bf79dc 100644
--- a/osu.Game.Tests/Visual/Navigation/TestScenePresentScore.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestScenePresentScore.cs
@@ -4,7 +4,6 @@
 using System;
 using System.Linq;
 using NUnit.Framework;
-using osu.Framework.Extensions;
 using osu.Framework.Screens;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
@@ -60,7 +59,7 @@ namespace osu.Game.Tests.Visual.Navigation
                             Ruleset = new OsuRuleset().RulesetInfo
                         },
                     }
-                }).GetResultSafely()?.Value;
+                })?.Value;
             });
         }
 
@@ -135,7 +134,7 @@ namespace osu.Game.Tests.Visual.Navigation
                     BeatmapInfo = beatmap.Beatmaps.First(),
                     Ruleset = ruleset ?? new OsuRuleset().RulesetInfo,
                     User = new GuestUser(),
-                }).GetResultSafely().Value;
+                }).Value;
             });
 
             AddAssert($"import {i} succeeded", () => imported != null);
diff --git a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs
index d397b37d05..68225f6d64 100644
--- a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs
+++ b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs
@@ -8,7 +8,6 @@ using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
 using osu.Framework.Bindables;
-using osu.Framework.Extensions;
 using osu.Framework.Platform;
 using osu.Framework.Screens;
 using osu.Framework.Testing;
@@ -151,7 +150,7 @@ namespace osu.Game.Tests.Visual.Playlists
 
                 Debug.Assert(modifiedBeatmap.BeatmapInfo.BeatmapSet != null);
 
-                manager.Import(modifiedBeatmap.BeatmapInfo.BeatmapSet).WaitSafely();
+                manager.Import(modifiedBeatmap.BeatmapInfo.BeatmapSet);
             });
 
             // Create the room using the real beatmap values.
@@ -196,7 +195,7 @@ namespace osu.Game.Tests.Visual.Playlists
 
                 Debug.Assert(originalBeatmap.BeatmapInfo.BeatmapSet != null);
 
-                manager.Import(originalBeatmap.BeatmapInfo.BeatmapSet).WaitSafely();
+                manager.Import(originalBeatmap.BeatmapInfo.BeatmapSet);
             });
 
             AddUntilStep("match has correct beatmap", () => realHash == match.Beatmap.Value.BeatmapInfo.MD5Hash);
@@ -219,7 +218,7 @@ namespace osu.Game.Tests.Visual.Playlists
 
             Debug.Assert(beatmap.BeatmapInfo.BeatmapSet != null);
 
-            importedBeatmap = manager.Import(beatmap.BeatmapInfo.BeatmapSet).GetResultSafely()?.Value.Detach();
+            importedBeatmap = manager.Import(beatmap.BeatmapInfo.BeatmapSet)?.Value.Detach();
         });
 
         private class TestPlaylistsRoomSubScreen : PlaylistsRoomSubScreen
diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
index 5e977d075d..e31be1d51a 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
@@ -180,7 +180,7 @@ namespace osu.Game.Tests.Visual.SongSelect
             AddStep(@"Load new scores via manager", () =>
             {
                 foreach (var score in generateSampleScores(beatmapInfo()))
-                    scoreManager.Import(score).WaitSafely();
+                    scoreManager.Import(score);
             });
         }
 
diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapRecommendations.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapRecommendations.cs
index b7bc0c37e1..940d001c5b 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapRecommendations.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapRecommendations.cs
@@ -5,7 +5,6 @@ using System;
 using System.Collections.Generic;
 using System.Linq;
 using NUnit.Framework;
-using osu.Framework.Extensions;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
 using osu.Game.Extensions;
@@ -184,7 +183,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                 beatmap.DifficultyName = $"SR{i + 1}";
             }
 
-            return Game.BeatmapManager.Import(beatmapSet).GetResultSafely()?.Value;
+            return Game.BeatmapManager.Import(beatmapSet)?.Value;
         }
 
         private bool ensureAllBeatmapSetsImported(IEnumerable<BeatmapSetInfo> beatmapSets) => beatmapSets.All(set => set != null);
diff --git a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
index 0dc4556ed9..630171a4d0 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
@@ -8,7 +8,6 @@ using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
 using osu.Framework.Bindables;
-using osu.Framework.Extensions;
 using osu.Framework.Platform;
 using osu.Framework.Screens;
 using osu.Framework.Testing;
@@ -260,7 +259,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                 AddStep("import multi-ruleset map", () =>
                 {
                     var usableRulesets = rulesets.AvailableRulesets.Where(r => r.OnlineID != 2).ToArray();
-                    manager.Import(TestResources.CreateTestBeatmapSetInfo(rulesets: usableRulesets)).WaitSafely();
+                    manager.Import(TestResources.CreateTestBeatmapSetInfo(rulesets: usableRulesets));
                 });
             }
             else
@@ -675,7 +674,7 @@ namespace osu.Game.Tests.Visual.SongSelect
             AddStep("import multi-ruleset map", () =>
             {
                 var usableRulesets = rulesets.AvailableRulesets.Where(r => r.OnlineID != 2).ToArray();
-                manager.Import(TestResources.CreateTestBeatmapSetInfo(3, usableRulesets)).WaitSafely();
+                manager.Import(TestResources.CreateTestBeatmapSetInfo(3, usableRulesets));
             });
 
             int previousSetID = 0;
@@ -715,7 +714,7 @@ namespace osu.Game.Tests.Visual.SongSelect
             AddStep("import multi-ruleset map", () =>
             {
                 var usableRulesets = rulesets.AvailableRulesets.Where(r => r.OnlineID != 2).ToArray();
-                manager.Import(TestResources.CreateTestBeatmapSetInfo(3, usableRulesets)).WaitSafely();
+                manager.Import(TestResources.CreateTestBeatmapSetInfo(3, usableRulesets));
             });
 
             DrawableCarouselBeatmapSet set = null;
@@ -764,7 +763,7 @@ namespace osu.Game.Tests.Visual.SongSelect
             AddStep("import huge difficulty count map", () =>
             {
                 var usableRulesets = rulesets.AvailableRulesets.Where(r => r.OnlineID != 2).ToArray();
-                imported = manager.Import(TestResources.CreateTestBeatmapSetInfo(50, usableRulesets)).GetResultSafely()?.Value;
+                imported = manager.Import(TestResources.CreateTestBeatmapSetInfo(50, usableRulesets))?.Value;
             });
 
             AddStep("select the first beatmap of import", () => Beatmap.Value = manager.GetWorkingBeatmap(imported.Beatmaps.First()));
@@ -873,7 +872,7 @@ namespace osu.Game.Tests.Visual.SongSelect
 
         private void addRulesetImportStep(int id) => AddStep($"import test map for ruleset {id}", () => importForRuleset(id));
 
-        private void importForRuleset(int id) => manager.Import(TestResources.CreateTestBeatmapSetInfo(3, rulesets.AvailableRulesets.Where(r => r.OnlineID == id).ToArray())).WaitSafely();
+        private void importForRuleset(int id) => manager.Import(TestResources.CreateTestBeatmapSetInfo(3, rulesets.AvailableRulesets.Where(r => r.OnlineID == id).ToArray()));
 
         private void checkMusicPlaying(bool playing) =>
             AddUntilStep($"music {(playing ? "" : "not ")}playing", () => music.IsPlaying == playing);
@@ -903,7 +902,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                 var usableRulesets = rulesets.AvailableRulesets.Where(r => r.OnlineID != 2).ToArray();
 
                 for (int i = 0; i < 10; i++)
-                    manager.Import(TestResources.CreateTestBeatmapSetInfo(difficultyCountPerSet, usableRulesets)).WaitSafely();
+                    manager.Import(TestResources.CreateTestBeatmapSetInfo(difficultyCountPerSet, usableRulesets));
             });
         }
 
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
index 55031a9699..4826d2fb33 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
@@ -112,7 +112,7 @@ namespace osu.Game.Tests.Visual.UserInterface
                         Ruleset = new OsuRuleset().RulesetInfo,
                     };
 
-                    importedScores.Add(scoreManager.Import(score).GetResultSafely().Value);
+                    importedScores.Add(scoreManager.Import(score).Value);
                 }
             });
 
diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index 4488301fe5..a1c1982f00 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -10,7 +10,6 @@ using System.Threading;
 using System.Threading.Tasks;
 using osu.Framework.Audio;
 using osu.Framework.Audio.Track;
-using osu.Framework.Extensions;
 using osu.Framework.IO.Stores;
 using osu.Framework.Platform;
 using osu.Framework.Testing;
@@ -105,7 +104,7 @@ namespace osu.Game.Beatmaps
             foreach (BeatmapInfo b in beatmapSet.Beatmaps)
                 b.BeatmapSet = beatmapSet;
 
-            var imported = beatmapModelManager.Import(beatmapSet).GetResultSafely();
+            var imported = beatmapModelManager.Import(beatmapSet);
 
             if (imported == null)
                 throw new InvalidOperationException("Failed to import new beatmap");
@@ -295,7 +294,7 @@ namespace osu.Game.Beatmaps
             return beatmapModelManager.Import(archive, lowPriority, cancellationToken);
         }
 
-        public Task<ILive<BeatmapSetInfo>?> Import(BeatmapSetInfo item, ArchiveReader? archive = null, bool lowPriority = false, CancellationToken cancellationToken = default)
+        public ILive<BeatmapSetInfo>? Import(BeatmapSetInfo item, ArchiveReader? archive = null, bool lowPriority = false, CancellationToken cancellationToken = default)
         {
             return beatmapModelManager.Import(item, archive, lowPriority, cancellationToken);
         }
diff --git a/osu.Game/Database/IModelImporter.cs b/osu.Game/Database/IModelImporter.cs
index d00cfb2035..3047a1d30a 100644
--- a/osu.Game/Database/IModelImporter.cs
+++ b/osu.Game/Database/IModelImporter.cs
@@ -45,7 +45,7 @@ namespace osu.Game.Database
         /// <param name="archive">An optional archive to use for model population.</param>
         /// <param name="lowPriority">Whether this is a low priority import.</param>
         /// <param name="cancellationToken">An optional cancellation token.</param>
-        Task<ILive<TModel>?> Import(TModel item, ArchiveReader? archive = null, bool lowPriority = false, CancellationToken cancellationToken = default);
+        ILive<TModel>? Import(TModel item, ArchiveReader? archive = null, bool lowPriority = false, CancellationToken cancellationToken = default);
 
         /// <summary>
         /// A user displayable name for the model type associated with this manager.
diff --git a/osu.Game/Scoring/ScoreManager.cs b/osu.Game/Scoring/ScoreManager.cs
index bb26bd3b04..3a842a048a 100644
--- a/osu.Game/Scoring/ScoreManager.cs
+++ b/osu.Game/Scoring/ScoreManager.cs
@@ -308,7 +308,7 @@ namespace osu.Game.Scoring
             return scoreModelManager.Import(archive, lowPriority, cancellationToken);
         }
 
-        public Task<ILive<ScoreInfo>> Import(ScoreInfo item, ArchiveReader archive = null, bool lowPriority = false, CancellationToken cancellationToken = default)
+        public ILive<ScoreInfo> Import(ScoreInfo item, ArchiveReader archive = null, bool lowPriority = false, CancellationToken cancellationToken = default)
         {
             return scoreModelManager.Import(item, archive, lowPriority, cancellationToken);
         }
diff --git a/osu.Game/Screens/Play/Player.cs b/osu.Game/Screens/Play/Player.cs
index 4d3201cd27..cfca2d0a3d 100644
--- a/osu.Game/Screens/Play/Player.cs
+++ b/osu.Game/Screens/Play/Player.cs
@@ -1024,11 +1024,11 @@ namespace osu.Game.Screens.Play
         /// </summary>
         /// <param name="score">The <see cref="Scoring.Score"/> to import.</param>
         /// <returns>The imported score.</returns>
-        protected virtual async Task ImportScore(Score score)
+        protected virtual Task ImportScore(Score score)
         {
             // Replays are already populated and present in the game's database, so should not be re-imported.
             if (DrawableRuleset.ReplayScore != null)
-                return;
+                return Task.CompletedTask;
 
             LegacyByteArrayReader replayReader;
 
@@ -1048,7 +1048,7 @@ namespace osu.Game.Screens.Play
             // conflicts across various systems (ie. solo and multiplayer).
             importableScore.OnlineID = -1;
 
-            var imported = await scoreManager.Import(importableScore, replayReader).ConfigureAwait(false);
+            var imported = scoreManager.Import(importableScore, replayReader);
 
             imported.PerformRead(s =>
             {
@@ -1056,6 +1056,8 @@ namespace osu.Game.Screens.Play
                 score.ScoreInfo.Hash = s.Hash;
                 score.ScoreInfo.ID = s.ID;
             });
+
+            return Task.CompletedTask;
         }
 
         /// <summary>
diff --git a/osu.Game/Skinning/SkinManager.cs b/osu.Game/Skinning/SkinManager.cs
index 344acb7a0f..47c7bc060a 100644
--- a/osu.Game/Skinning/SkinManager.cs
+++ b/osu.Game/Skinning/SkinManager.cs
@@ -11,7 +11,6 @@ using JetBrains.Annotations;
 using osu.Framework.Audio;
 using osu.Framework.Audio.Sample;
 using osu.Framework.Bindables;
-using osu.Framework.Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.OpenGL.Textures;
 using osu.Framework.Graphics.Textures;
@@ -151,7 +150,7 @@ namespace osu.Game.Skinning
                     Name = s.Name + @" (modified)",
                     Creator = s.Creator,
                     InstantiationInfo = s.InstantiationInfo,
-                }).GetResultSafely();
+                });
 
                 if (result != null)
                 {
@@ -278,7 +277,7 @@ namespace osu.Game.Skinning
             return skinModelManager.Import(archive, lowPriority, cancellationToken);
         }
 
-        public Task<ILive<SkinInfo>> Import(SkinInfo item, ArchiveReader archive = null, bool lowPriority = false, CancellationToken cancellationToken = default)
+        public ILive<SkinInfo> Import(SkinInfo item, ArchiveReader archive = null, bool lowPriority = false, CancellationToken cancellationToken = default)
         {
             return skinModelManager.Import(item, archive, lowPriority, cancellationToken);
         }
diff --git a/osu.Game/Stores/RealmArchiveModelImporter.cs b/osu.Game/Stores/RealmArchiveModelImporter.cs
index b0f676ecf0..43c1c7c888 100644
--- a/osu.Game/Stores/RealmArchiveModelImporter.cs
+++ b/osu.Game/Stores/RealmArchiveModelImporter.cs
@@ -250,8 +250,10 @@ namespace osu.Game.Stores
                 return null;
             }
 
-            var scheduledImport = Task.Factory.StartNew(async () => await Import(model, archive, lowPriority, cancellationToken).ConfigureAwait(false),
-                cancellationToken, TaskCreationOptions.HideScheduler, lowPriority ? import_scheduler_low_priority : import_scheduler).Unwrap();
+            var scheduledImport = Task.Factory.StartNew(() => Import(model, archive, lowPriority, cancellationToken),
+                cancellationToken,
+                TaskCreationOptions.HideScheduler,
+                lowPriority ? import_scheduler_low_priority : import_scheduler);
 
             return await scheduledImport.ConfigureAwait(false);
         }
@@ -318,7 +320,7 @@ namespace osu.Game.Stores
         /// <param name="archive">An optional archive to use for model population.</param>
         /// <param name="lowPriority">Whether this is a low priority import.</param>
         /// <param name="cancellationToken">An optional cancellation token.</param>
-        public virtual Task<ILive<TModel>?> Import(TModel item, ArchiveReader? archive = null, bool lowPriority = false, CancellationToken cancellationToken = default)
+        public virtual ILive<TModel>? Import(TModel item, ArchiveReader? archive = null, bool lowPriority = false, CancellationToken cancellationToken = default)
         {
             return Realm.Run(realm =>
             {
@@ -353,7 +355,7 @@ namespace osu.Game.Stores
                                 transaction.Commit();
                             }
 
-                            return Task.FromResult((ILive<TModel>?)existing.ToLive(Realm));
+                            return existing.ToLive(Realm);
                         }
 
                         LogForModel(item, @"Found existing (optimised) but failed pre-check.");
@@ -388,7 +390,7 @@ namespace osu.Game.Stores
                                 existing.DeletePending = false;
                                 transaction.Commit();
 
-                                return Task.FromResult((ILive<TModel>?)existing.ToLive(Realm));
+                                return existing.ToLive(Realm);
                             }
 
                             LogForModel(item, @"Found existing but failed re-use check.");
@@ -414,7 +416,7 @@ namespace osu.Game.Stores
                     throw;
                 }
 
-                return Task.FromResult((ILive<TModel>?)item.ToLive(Realm));
+                return (ILive<TModel>?)item.ToLive(Realm);
             });
         }
 

From fc58b202b1d93b98d4d90b22741a5502591d5c3b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 25 Jan 2022 15:45:23 +0900
Subject: [PATCH 2476/5547] Fix crash when trying to migrate collection
 database that doesn't exist

---
 osu.Game/OsuGameBase.cs | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/osu.Game/OsuGameBase.cs b/osu.Game/OsuGameBase.cs
index 7a6a126900..09ca4e450d 100644
--- a/osu.Game/OsuGameBase.cs
+++ b/osu.Game/OsuGameBase.cs
@@ -208,8 +208,13 @@ namespace osu.Game
                 realm.CreateBackup($"client.{migration}.realm");
 
                 using (var source = Storage.GetStream("collection.db"))
-                using (var destination = Storage.GetStream($"collection.{migration}.db", FileAccess.Write, FileMode.CreateNew))
-                    source.CopyTo(destination);
+                {
+                    if (source != null)
+                    {
+                        using (var destination = Storage.GetStream($"collection.{migration}.db", FileAccess.Write, FileMode.CreateNew))
+                            source.CopyTo(destination);
+                    }
+                }
             }
 
             dependencies.CacheAs(Storage);

From 1bb1366c9f1c7e3d6d0b43f0bdf7d7f0ce3fe551 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 25 Jan 2022 16:26:06 +0900
Subject: [PATCH 2477/5547] Fix notification reset events potentially arriving
 out of order if a block operation times out

---
 osu.Game/Database/RealmAccess.cs | 40 +++++++++++++++-----------------
 1 file changed, 19 insertions(+), 21 deletions(-)

diff --git a/osu.Game/Database/RealmAccess.cs b/osu.Game/Database/RealmAccess.cs
index e6e3c9ee41..bf88313663 100644
--- a/osu.Game/Database/RealmAccess.cs
+++ b/osu.Game/Database/RealmAccess.cs
@@ -334,25 +334,6 @@ namespace osu.Game.Database
             }
         }
 
-        /// <summary>
-        /// Unregister all subscriptions when the realm instance is to be recycled.
-        /// Subscriptions will still remain and will be re-subscribed when the realm instance returns.
-        /// </summary>
-        private void unregisterAllSubscriptions()
-        {
-            lock (realmLock)
-            {
-                foreach (var action in notificationsResetMap.Values)
-                    action();
-
-                foreach (var action in customSubscriptionsResetMap)
-                {
-                    action.Value?.Dispose();
-                    customSubscriptionsResetMap[action.Key] = null;
-                }
-            }
-        }
-
         private Realm getRealmInstance()
         {
             if (isDisposed)
@@ -605,9 +586,16 @@ namespace osu.Game.Database
                             throw new InvalidOperationException(@$"{nameof(BlockAllOperations)} must be called from the update thread.");
 
                         syncContext = SynchronizationContext.Current;
-                    }
 
-                    unregisterAllSubscriptions();
+                        // Before disposing the update context, clean up all subscriptions.
+                        // Note that in the case of realm notification subscriptions, this is not really required (they will be cleaned up by disposal).
+                        // In the case of custom subscriptions, we want them to fire before the update realm is disposed in case they do any follow-up work.
+                        foreach (var action in customSubscriptionsResetMap)
+                        {
+                            action.Value?.Dispose();
+                            customSubscriptionsResetMap[action.Key] = null;
+                        }
+                    }
 
                     Logger.Log(@"Blocking realm operations.", LoggingTarget.Database);
 
@@ -615,6 +603,16 @@ namespace osu.Game.Database
                     updateRealm = null;
                 }
 
+                // In order to ensure events arrive in the correct order, these *must* be fired post disposal of the update realm,
+                // and must be posted to the synchronization context.
+                // This is because realm may fire event callbacks between the `unregisterAllSubscriptions` and `updateRealm.Dispose`
+                // calls above.
+                syncContext?.Post(_ =>
+                {
+                    foreach (var action in notificationsResetMap.Values)
+                        action();
+                }, null);
+
                 const int sleep_length = 200;
                 int timeout = 5000;
 

From 5a9524a74e945b6db0d51cdfa71574a63e6ee832 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Mon, 24 Jan 2022 02:51:13 +0300
Subject: [PATCH 2478/5547] Decrease default timeline zoom to "6 seconds
 visible" range

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

diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/Timeline.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/Timeline.cs
index 265f56534f..35a0282611 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/Timeline.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/Timeline.cs
@@ -141,7 +141,7 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
                 {
                     MaxZoom = getZoomLevelForVisibleMilliseconds(500);
                     MinZoom = getZoomLevelForVisibleMilliseconds(10000);
-                    Zoom = getZoomLevelForVisibleMilliseconds(2000);
+                    Zoom = getZoomLevelForVisibleMilliseconds(6000);
                 }
             }, true);
         }

From 1f9cf00db89f7a80027e665d86a3cfd8e1891b31 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 25 Jan 2022 16:44:44 +0900
Subject: [PATCH 2479/5547] Fix `DatabasedKeyBindingContainer` re-querying
 realm on receiving notification

---
 .../Bindings/DatabasedKeyBindingContainer.cs  | 41 ++++++++++---------
 1 file changed, 22 insertions(+), 19 deletions(-)

diff --git a/osu.Game/Input/Bindings/DatabasedKeyBindingContainer.cs b/osu.Game/Input/Bindings/DatabasedKeyBindingContainer.cs
index 3e4a9759a3..ba129b93e5 100644
--- a/osu.Game/Input/Bindings/DatabasedKeyBindingContainer.cs
+++ b/osu.Game/Input/Bindings/DatabasedKeyBindingContainer.cs
@@ -8,6 +8,7 @@ using osu.Framework.Allocation;
 using osu.Framework.Input.Bindings;
 using osu.Game.Database;
 using osu.Game.Rulesets;
+using Realms;
 
 namespace osu.Game.Input.Bindings
 {
@@ -46,41 +47,36 @@ namespace osu.Game.Input.Bindings
                 throw new InvalidOperationException($"{nameof(variant)} can not be null when a non-null {nameof(ruleset)} is provided.");
         }
 
-        private IQueryable<RealmKeyBinding> queryRealmKeyBindings()
-        {
-            string rulesetName = ruleset?.ShortName;
-            return realm.Realm.All<RealmKeyBinding>()
-                        .Where(b => b.RulesetName == rulesetName && b.Variant == variant);
-        }
-
         protected override void LoadComplete()
         {
-            realmSubscription = realm.RegisterForNotifications(r => queryRealmKeyBindings(), (sender, changes, error) =>
+            realmSubscription = realm.RegisterForNotifications(queryRealmKeyBindings, (sender, changes, error) =>
             {
                 // The first fire of this is a bit redundant as this is being called in base.LoadComplete,
                 // but this is safest in case the subscription is restored after a context recycle.
-                ReloadMappings();
+                reloadMappings(sender.AsQueryable());
             });
 
             base.LoadComplete();
         }
 
-        protected override void Dispose(bool isDisposing)
-        {
-            base.Dispose(isDisposing);
+        protected override void ReloadMappings() => reloadMappings(queryRealmKeyBindings(realm.Realm));
 
-            realmSubscription?.Dispose();
+        private IQueryable<RealmKeyBinding> queryRealmKeyBindings(Realm realm)
+        {
+            string rulesetName = ruleset?.ShortName;
+            return realm.All<RealmKeyBinding>()
+                        .Where(b => b.RulesetName == rulesetName && b.Variant == variant);
         }
 
-        protected override void ReloadMappings()
+        private void reloadMappings(IQueryable<RealmKeyBinding> realmKeyBindings)
         {
             var defaults = DefaultKeyBindings.ToList();
 
-            List<RealmKeyBinding> newBindings = queryRealmKeyBindings().Detach()
-                                                                       // this ordering is important to ensure that we read entries from the database in the order
-                                                                       // enforced by DefaultKeyBindings. allow for song select to handle actions that may otherwise
-                                                                       // have been eaten by the music controller due to query order.
-                                                                       .OrderBy(b => defaults.FindIndex(d => (int)d.Action == b.ActionInt)).ToList();
+            List<RealmKeyBinding> newBindings = realmKeyBindings.Detach()
+                                                                // this ordering is important to ensure that we read entries from the database in the order
+                                                                // enforced by DefaultKeyBindings. allow for song select to handle actions that may otherwise
+                                                                // have been eaten by the music controller due to query order.
+                                                                .OrderBy(b => defaults.FindIndex(d => (int)d.Action == b.ActionInt)).ToList();
 
             // In the case no bindings were found in the database, presume this usage is for a non-databased ruleset.
             // This actually should never be required and can be removed if it is ever deemed to cause a problem.
@@ -91,5 +87,12 @@ namespace osu.Game.Input.Bindings
             else
                 KeyBindings = newBindings;
         }
+
+        protected override void Dispose(bool isDisposing)
+        {
+            base.Dispose(isDisposing);
+
+            realmSubscription?.Dispose();
+        }
     }
 }

From 958cfde60834a0e5a9342c3dfc7f59893e52942d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 21 Jan 2022 23:45:06 +0900
Subject: [PATCH 2480/5547] Stop detaching and exposing beatmaps from
 `MusicController`

---
 osu.Game/Overlays/MusicController.cs   | 14 ++++++--------
 osu.Game/Overlays/NowPlayingOverlay.cs |  1 -
 2 files changed, 6 insertions(+), 9 deletions(-)

diff --git a/osu.Game/Overlays/MusicController.cs b/osu.Game/Overlays/MusicController.cs
index 9dc55d24dd..335abb53dc 100644
--- a/osu.Game/Overlays/MusicController.cs
+++ b/osu.Game/Overlays/MusicController.cs
@@ -30,8 +30,6 @@ namespace osu.Game.Overlays
         [Resolved]
         private BeatmapManager beatmaps { get; set; }
 
-        public IBindableList<BeatmapSetInfo> BeatmapSets => beatmapSets;
-
         /// <summary>
         /// Point in time after which the current track will be restarted on triggering a "previous track" action.
         /// </summary>
@@ -88,12 +86,12 @@ namespace osu.Game.Overlays
             {
                 beatmapSets.Clear();
                 foreach (var s in sender)
-                    beatmapSets.Add(s.Detach());
+                    beatmapSets.Add(s);
                 return;
             }
 
             foreach (int i in changes.InsertedIndices)
-                beatmapSets.Insert(i, sender[i].Detach());
+                beatmapSets.Insert(i, sender[i]);
 
             foreach (int i in changes.DeletedIndices.OrderByDescending(i => i))
                 beatmapSets.RemoveAt(i);
@@ -240,7 +238,7 @@ namespace osu.Game.Overlays
 
             queuedDirection = TrackChangeDirection.Prev;
 
-            var playable = BeatmapSets.TakeWhile(i => !i.Equals(current.BeatmapSetInfo)).LastOrDefault() ?? BeatmapSets.LastOrDefault();
+            var playable = beatmapSets.TakeWhile(i => !i.Equals(current.BeatmapSetInfo)).LastOrDefault() ?? beatmapSets.LastOrDefault();
 
             if (playable != null)
             {
@@ -271,7 +269,7 @@ namespace osu.Game.Overlays
 
             queuedDirection = TrackChangeDirection.Next;
 
-            var playableSet = BeatmapSets.SkipWhile(i => i.ID != current.BeatmapSetInfo.ID).ElementAtOrDefault(1) ?? BeatmapSets.FirstOrDefault();
+            var playableSet = beatmapSets.SkipWhile(i => i.ID != current.BeatmapSetInfo.ID).ElementAtOrDefault(1) ?? beatmapSets.FirstOrDefault();
             var playableBeatmap = playableSet?.Beatmaps.FirstOrDefault();
 
             if (playableBeatmap != null)
@@ -322,8 +320,8 @@ namespace osu.Game.Overlays
                 else
                 {
                     // figure out the best direction based on order in playlist.
-                    int last = BeatmapSets.TakeWhile(b => !b.Equals(current.BeatmapSetInfo)).Count();
-                    int next = newWorking == null ? -1 : BeatmapSets.TakeWhile(b => !b.Equals(newWorking.BeatmapSetInfo)).Count();
+                    int last = beatmapSets.TakeWhile(b => !b.Equals(current.BeatmapSetInfo)).Count();
+                    int next = newWorking == null ? -1 : beatmapSets.TakeWhile(b => !b.Equals(newWorking.BeatmapSetInfo)).Count();
 
                     direction = last > next ? TrackChangeDirection.Prev : TrackChangeDirection.Next;
                 }
diff --git a/osu.Game/Overlays/NowPlayingOverlay.cs b/osu.Game/Overlays/NowPlayingOverlay.cs
index 4dd23c0008..4617a91885 100644
--- a/osu.Game/Overlays/NowPlayingOverlay.cs
+++ b/osu.Game/Overlays/NowPlayingOverlay.cs
@@ -197,7 +197,6 @@ namespace osu.Game.Overlays
                 {
                     dragContainer.Add(playlist);
 
-                    playlist.BeatmapSets.BindTo(musicController.BeatmapSets);
                     playlist.State.BindValueChanged(s => playlistButton.FadeColour(s.NewValue == Visibility.Visible ? colours.Yellow : Color4.White, 200, Easing.OutQuint), true);
 
                     togglePlaylist();

From 8a4f3a7ce093b02dbbfa655146a30308214330d3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 22 Jan 2022 01:18:21 +0900
Subject: [PATCH 2481/5547] Reimplement subscription logic in `PlaylistOverlay`
 directly

---
 osu.Game/Overlays/Music/PlaylistOverlay.cs | 39 ++++++++++++++++++++++
 1 file changed, 39 insertions(+)

diff --git a/osu.Game/Overlays/Music/PlaylistOverlay.cs b/osu.Game/Overlays/Music/PlaylistOverlay.cs
index 78b2d58dae..245886743a 100644
--- a/osu.Game/Overlays/Music/PlaylistOverlay.cs
+++ b/osu.Game/Overlays/Music/PlaylistOverlay.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 osu.Framework.Allocation;
 using osu.Framework.Bindables;
@@ -10,9 +11,11 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Effects;
 using osu.Framework.Graphics.Shapes;
 using osu.Game.Beatmaps;
+using osu.Game.Database;
 using osu.Game.Graphics;
 using osuTK;
 using osuTK.Graphics;
+using Realms;
 
 namespace osu.Game.Overlays.Music
 {
@@ -30,6 +33,15 @@ namespace osu.Game.Overlays.Music
         [Resolved]
         private BeatmapManager beatmaps { get; set; }
 
+        [Resolved]
+        private RealmContextFactory realmFactory { get; set; }
+
+        private IDisposable beatmapSubscription;
+
+        private IQueryable<BeatmapSetInfo> availableBeatmaps => realmFactory.Context
+                                                                            .All<BeatmapSetInfo>()
+                                                                            .Where(s => !s.DeletePending);
+
         private FilterControl filter;
         private Playlist list;
 
@@ -91,10 +103,31 @@ namespace osu.Game.Overlays.Music
         {
             base.LoadComplete();
 
+            // tests might bind externally, in which case we don't want to involve realm.
+            if (beatmapSets.Count == 0)
+                beatmapSubscription = realmFactory.RegisterForNotifications(realm => availableBeatmaps, beatmapsChanged);
+
             list.Items.BindTo(beatmapSets);
             beatmap.BindValueChanged(working => list.SelectedSet.Value = working.NewValue.BeatmapSetInfo, true);
         }
 
+        private void beatmapsChanged(IRealmCollection<BeatmapSetInfo> sender, ChangeSet changes, Exception error)
+        {
+            if (changes == null)
+            {
+                beatmapSets.Clear();
+                // must use AddRange to avoid RearrangeableList sort overhead per add op.
+                beatmapSets.AddRange(sender);
+                return;
+            }
+
+            foreach (int i in changes.InsertedIndices)
+                beatmapSets.Insert(i, sender[i]);
+
+            foreach (int i in changes.DeletedIndices.OrderByDescending(i => i))
+                beatmapSets.RemoveAt(i);
+        }
+
         protected override void PopIn()
         {
             filter.Search.HoldFocus = true;
@@ -123,5 +156,11 @@ namespace osu.Game.Overlays.Music
             beatmap.Value = beatmaps.GetWorkingBeatmap(set.Beatmaps.First());
             beatmap.Value.Track.Restart();
         }
+
+        protected override void Dispose(bool isDisposing)
+        {
+            base.Dispose(isDisposing);
+            beatmapSubscription?.Dispose();
+        }
     }
 }

From ace2bd2208eead324a2ad8753b4c33bb6e1d02ea Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 22 Jan 2022 01:18:29 +0900
Subject: [PATCH 2482/5547] Apply some initial optimisations to `PlaylistItem`

---
 osu.Game/Overlays/Music/PlaylistItem.cs | 44 +++++++++++--------------
 1 file changed, 20 insertions(+), 24 deletions(-)

diff --git a/osu.Game/Overlays/Music/PlaylistItem.cs b/osu.Game/Overlays/Music/PlaylistItem.cs
index 04c12b8cd7..b3b039148b 100644
--- a/osu.Game/Overlays/Music/PlaylistItem.cs
+++ b/osu.Game/Overlays/Music/PlaylistItem.cs
@@ -32,8 +32,6 @@ namespace osu.Game.Overlays.Music
             : base(item)
         {
             Padding = new MarginPadding { Left = 5 };
-
-            FilterTerms = item.Metadata.GetSearchableTerms();
         }
 
         [BackgroundDependencyLoader]
@@ -46,6 +44,25 @@ namespace osu.Game.Overlays.Music
         {
             base.LoadComplete();
 
+            var metadata = Model.Metadata;
+
+            var title = new RomanisableString(metadata.TitleUnicode, metadata.Title);
+            var artist = new RomanisableString(metadata.ArtistUnicode, metadata.Artist);
+
+            titlePart = text.AddText(title, sprite => sprite.Font = OsuFont.GetFont(weight: FontWeight.Regular));
+
+            updateSelectionState(true);
+            titlePart.DrawablePartsRecreated += _ => updateSelectionState(true);
+
+            text.AddText(@"  "); // to separate the title from the artist.
+
+            text.AddText(artist, sprite =>
+            {
+                sprite.Font = OsuFont.GetFont(size: 14, weight: FontWeight.Bold);
+                sprite.Colour = colours.Gray9;
+                sprite.Padding = new MarginPadding { Top = 1 };
+            });
+
             SelectedSet.BindValueChanged(set =>
             {
                 if (set.OldValue?.Equals(Model) != true && set.NewValue?.Equals(Model) != true)
@@ -67,27 +84,6 @@ namespace osu.Game.Overlays.Music
             AutoSizeAxes = Axes.Y,
         };
 
-        protected override void LoadAsyncComplete()
-        {
-            base.LoadAsyncComplete();
-
-            var title = new RomanisableString(Model.Metadata.TitleUnicode, Model.Metadata.Title);
-            var artist = new RomanisableString(Model.Metadata.ArtistUnicode, Model.Metadata.Artist);
-
-            titlePart = text.AddText(title, sprite => sprite.Font = OsuFont.GetFont(weight: FontWeight.Regular));
-            updateSelectionState(true);
-            titlePart.DrawablePartsRecreated += _ => updateSelectionState(true);
-
-            text.AddText(@"  "); // to separate the title from the artist.
-
-            text.AddText(artist, sprite =>
-            {
-                sprite.Font = OsuFont.GetFont(size: 14, weight: FontWeight.Bold);
-                sprite.Colour = colours.Gray9;
-                sprite.Padding = new MarginPadding { Top = 1 };
-            });
-        }
-
         protected override bool OnClick(ClickEvent e)
         {
             RequestSelection?.Invoke(Model);
@@ -109,7 +105,7 @@ namespace osu.Game.Overlays.Music
             }
         }
 
-        public IEnumerable<string> FilterTerms { get; }
+        public IEnumerable<string> FilterTerms => Model.Metadata.GetSearchableTerms();
 
         private bool matchingFilter = true;
 

From 2a786f9ec0302f3ba39561ae5a5d56a0eafa7fe5 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 22 Jan 2022 01:49:07 +0900
Subject: [PATCH 2483/5547] Load text only after it comes on screen (and tidy
 up selection handling logic)

---
 osu.Game/Overlays/Music/PlaylistItem.cs | 20 ++++++++++++--------
 1 file changed, 12 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Overlays/Music/PlaylistItem.cs b/osu.Game/Overlays/Music/PlaylistItem.cs
index b3b039148b..b31a03a64d 100644
--- a/osu.Game/Overlays/Music/PlaylistItem.cs
+++ b/osu.Game/Overlays/Music/PlaylistItem.cs
@@ -50,12 +50,9 @@ namespace osu.Game.Overlays.Music
             var artist = new RomanisableString(metadata.ArtistUnicode, metadata.Artist);
 
             titlePart = text.AddText(title, sprite => sprite.Font = OsuFont.GetFont(weight: FontWeight.Regular));
-
-            updateSelectionState(true);
             titlePart.DrawablePartsRecreated += _ => updateSelectionState(true);
 
             text.AddText(@"  "); // to separate the title from the artist.
-
             text.AddText(artist, sprite =>
             {
                 sprite.Font = OsuFont.GetFont(size: 14, weight: FontWeight.Bold);
@@ -65,24 +62,31 @@ namespace osu.Game.Overlays.Music
 
             SelectedSet.BindValueChanged(set =>
             {
-                if (set.OldValue?.Equals(Model) != true && set.NewValue?.Equals(Model) != true)
+                bool newSelected = set.NewValue?.Equals(Model) == true;
+
+                if (newSelected == selected)
                     return;
 
+                selected = newSelected;
                 updateSelectionState(false);
-            }, true);
+            });
+
+            updateSelectionState(true);
         }
 
+        private bool selected;
+
         private void updateSelectionState(bool instant)
         {
             foreach (Drawable s in titlePart.Drawables)
-                s.FadeColour(SelectedSet.Value?.Equals(Model) == true ? colours.Yellow : Color4.White, instant ? 0 : FADE_DURATION);
+                s.FadeColour(selected ? colours.Yellow : Color4.White, instant ? 0 : FADE_DURATION);
         }
 
-        protected override Drawable CreateContent() => text = new OsuTextFlowContainer
+        protected override Drawable CreateContent() => new DelayedLoadWrapper(text = new OsuTextFlowContainer
         {
             RelativeSizeAxes = Axes.X,
             AutoSizeAxes = Axes.Y,
-        };
+        });
 
         protected override bool OnClick(ClickEvent e)
         {

From 83b0e4572a057c520723c3319d7227c1ccf8951f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 22 Jan 2022 02:39:01 +0900
Subject: [PATCH 2484/5547] Fix test failures

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

diff --git a/osu.Game.Tests/Visual/UserInterface/TestScenePlaylistOverlay.cs b/osu.Game.Tests/Visual/UserInterface/TestScenePlaylistOverlay.cs
index 62f3b63780..7131c19471 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestScenePlaylistOverlay.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestScenePlaylistOverlay.cs
@@ -68,7 +68,7 @@ namespace osu.Game.Tests.Visual.UserInterface
             AddStep("drag to 5th", () =>
             {
                 var item = this.ChildrenOfType<PlaylistItem>().ElementAt(4);
-                InputManager.MoveMouseTo(item.ScreenSpaceDrawQuad.Centre);
+                InputManager.MoveMouseTo(item.ScreenSpaceDrawQuad.BottomLeft);
             });
 
             AddAssert("song 1 is 5th", () => beatmapSets[4].Equals(first));

From 1a776a95877907b7d9304ffa6ac4a529558f1b79 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 22 Jan 2022 04:27:07 +0900
Subject: [PATCH 2485/5547] Completely remove subscription from
 `MusicController`

---
 osu.Game/Overlays/Music/PlaylistOverlay.cs | 10 ++--
 osu.Game/Overlays/MusicController.cs       | 68 ++++------------------
 2 files changed, 16 insertions(+), 62 deletions(-)

diff --git a/osu.Game/Overlays/Music/PlaylistOverlay.cs b/osu.Game/Overlays/Music/PlaylistOverlay.cs
index 245886743a..6adcd2a6d6 100644
--- a/osu.Game/Overlays/Music/PlaylistOverlay.cs
+++ b/osu.Game/Overlays/Music/PlaylistOverlay.cs
@@ -34,13 +34,13 @@ namespace osu.Game.Overlays.Music
         private BeatmapManager beatmaps { get; set; }
 
         [Resolved]
-        private RealmContextFactory realmFactory { get; set; }
+        private RealmAccess realm { get; set; }
 
         private IDisposable beatmapSubscription;
 
-        private IQueryable<BeatmapSetInfo> availableBeatmaps => realmFactory.Context
-                                                                            .All<BeatmapSetInfo>()
-                                                                            .Where(s => !s.DeletePending);
+        private IQueryable<BeatmapSetInfo> availableBeatmaps => realm.Realm
+                                                                     .All<BeatmapSetInfo>()
+                                                                     .Where(s => !s.DeletePending);
 
         private FilterControl filter;
         private Playlist list;
@@ -105,7 +105,7 @@ namespace osu.Game.Overlays.Music
 
             // tests might bind externally, in which case we don't want to involve realm.
             if (beatmapSets.Count == 0)
-                beatmapSubscription = realmFactory.RegisterForNotifications(realm => availableBeatmaps, beatmapsChanged);
+                beatmapSubscription = realm.RegisterForNotifications(realm => availableBeatmaps, beatmapsChanged);
 
             list.Items.BindTo(beatmapSets);
             beatmap.BindValueChanged(working => list.SelectedSet.Value = working.NewValue.BeatmapSetInfo, true);
diff --git a/osu.Game/Overlays/MusicController.cs b/osu.Game/Overlays/MusicController.cs
index 335abb53dc..5fc0da8891 100644
--- a/osu.Game/Overlays/MusicController.cs
+++ b/osu.Game/Overlays/MusicController.cs
@@ -16,7 +16,6 @@ using osu.Framework.Threading;
 using osu.Game.Beatmaps;
 using osu.Game.Database;
 using osu.Game.Rulesets.Mods;
-using Realms;
 
 namespace osu.Game.Overlays
 {
@@ -25,8 +24,6 @@ namespace osu.Game.Overlays
     /// </summary>
     public class MusicController : CompositeDrawable
     {
-        private IDisposable beatmapSubscription;
-
         [Resolved]
         private BeatmapManager beatmaps { get; set; }
 
@@ -35,8 +32,6 @@ namespace osu.Game.Overlays
         /// </summary>
         private const double restart_cutoff_point = 5000;
 
-        private readonly BindableList<BeatmapSetInfo> beatmapSets = new BindableList<BeatmapSetInfo>();
-
         /// <summary>
         /// Whether the user has requested the track to be paused. Use <see cref="IsPlaying"/> to determine whether the track is still playing.
         /// </summary>
@@ -69,50 +64,11 @@ namespace osu.Game.Overlays
             mods.BindValueChanged(_ => ResetTrackAdjustments(), true);
         }
 
-        private IQueryable<BeatmapSetInfo> queryRealmBeatmapSets() =>
-            realm.Realm
-                 .All<BeatmapSetInfo>()
-                 .Where(s => !s.DeletePending);
-
-        protected override void LoadComplete()
-        {
-            base.LoadComplete();
-            beatmapSubscription = realm.RegisterForNotifications(r => queryRealmBeatmapSets(), beatmapsChanged);
-        }
-
-        private void beatmapsChanged(IRealmCollection<BeatmapSetInfo> sender, ChangeSet changes, Exception error)
-        {
-            if (changes == null)
-            {
-                beatmapSets.Clear();
-                foreach (var s in sender)
-                    beatmapSets.Add(s);
-                return;
-            }
-
-            foreach (int i in changes.InsertedIndices)
-                beatmapSets.Insert(i, sender[i]);
-
-            foreach (int i in changes.DeletedIndices.OrderByDescending(i => i))
-                beatmapSets.RemoveAt(i);
-        }
-
         /// <summary>
         /// Forcefully reload the current <see cref="WorkingBeatmap"/>'s track from disk.
         /// </summary>
         public void ReloadCurrentTrack() => changeTrack();
 
-        /// <summary>
-        /// Change the position of a <see cref="BeatmapSetInfo"/> in the current playlist.
-        /// </summary>
-        /// <param name="beatmapSetInfo">The beatmap to move.</param>
-        /// <param name="index">The new position.</param>
-        public void ChangeBeatmapSetPosition(BeatmapSetInfo beatmapSetInfo, int index)
-        {
-            beatmapSets.Remove(beatmapSetInfo);
-            beatmapSets.Insert(index, beatmapSetInfo);
-        }
-
         /// <summary>
         /// Returns whether the beatmap track is playing.
         /// </summary>
@@ -238,11 +194,12 @@ namespace osu.Game.Overlays
 
             queuedDirection = TrackChangeDirection.Prev;
 
-            var playable = beatmapSets.TakeWhile(i => !i.Equals(current.BeatmapSetInfo)).LastOrDefault() ?? beatmapSets.LastOrDefault();
+            var playableSet = getBeatmapSets().AsEnumerable().TakeWhile(i => !i.Equals(current.BeatmapSetInfo)).LastOrDefault()
+                              ?? getBeatmapSets().LastOrDefault();
 
-            if (playable != null)
+            if (playableSet != null)
             {
-                changeBeatmap(beatmaps.GetWorkingBeatmap(playable.Beatmaps.First()));
+                changeBeatmap(beatmaps.GetWorkingBeatmap(playableSet.Beatmaps.First()));
                 restartTrack();
                 return PreviousTrackResult.Previous;
             }
@@ -269,7 +226,9 @@ namespace osu.Game.Overlays
 
             queuedDirection = TrackChangeDirection.Next;
 
-            var playableSet = beatmapSets.SkipWhile(i => i.ID != current.BeatmapSetInfo.ID).ElementAtOrDefault(1) ?? beatmapSets.FirstOrDefault();
+            var playableSet = getBeatmapSets().AsEnumerable().SkipWhile(i => !i.Equals(current.BeatmapSetInfo)).ElementAtOrDefault(1)
+                              ?? getBeatmapSets().FirstOrDefault();
+
             var playableBeatmap = playableSet?.Beatmaps.FirstOrDefault();
 
             if (playableBeatmap != null)
@@ -293,6 +252,8 @@ namespace osu.Game.Overlays
 
         private TrackChangeDirection? queuedDirection;
 
+        private IQueryable<BeatmapSetInfo> getBeatmapSets() => realm.Realm.All<BeatmapSetInfo>().Where(s => !s.DeletePending);
+
         private void beatmapChanged(ValueChangedEvent<WorkingBeatmap> beatmap) => changeBeatmap(beatmap.NewValue);
 
         private void changeBeatmap(WorkingBeatmap newWorking)
@@ -320,8 +281,8 @@ namespace osu.Game.Overlays
                 else
                 {
                     // figure out the best direction based on order in playlist.
-                    int last = beatmapSets.TakeWhile(b => !b.Equals(current.BeatmapSetInfo)).Count();
-                    int next = newWorking == null ? -1 : beatmapSets.TakeWhile(b => !b.Equals(newWorking.BeatmapSetInfo)).Count();
+                    int last = getBeatmapSets().AsEnumerable().TakeWhile(b => !b.Equals(current.BeatmapSetInfo)).Count();
+                    int next = newWorking == null ? -1 : getBeatmapSets().AsEnumerable().TakeWhile(b => !b.Equals(newWorking.BeatmapSetInfo)).Count();
 
                     direction = last > next ? TrackChangeDirection.Prev : TrackChangeDirection.Next;
                 }
@@ -435,13 +396,6 @@ namespace osu.Game.Overlays
                     mod.ApplyToTrack(CurrentTrack);
             }
         }
-
-        protected override void Dispose(bool isDisposing)
-        {
-            base.Dispose(isDisposing);
-
-            beatmapSubscription?.Dispose();
-        }
     }
 
     public enum TrackChangeDirection

From ffd7877a1e8b6b822fd5f5922111b3d1ae7c027b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 25 Jan 2022 17:41:22 +0900
Subject: [PATCH 2486/5547] Remove synchronization context hacks in realm tests

---
 osu.Game.Tests/Database/GeneralUsageTests.cs | 10 ----------
 1 file changed, 10 deletions(-)

diff --git a/osu.Game.Tests/Database/GeneralUsageTests.cs b/osu.Game.Tests/Database/GeneralUsageTests.cs
index dc0d42595b..8262ef18d4 100644
--- a/osu.Game.Tests/Database/GeneralUsageTests.cs
+++ b/osu.Game.Tests/Database/GeneralUsageTests.cs
@@ -87,11 +87,6 @@ namespace osu.Game.Tests.Database
 
                 hasThreadedUsage.Wait();
 
-                // Usually the host would run the synchronization context work per frame.
-                // For the sake of keeping this test simple (there's only one update invocation),
-                // let's replace it so we can ensure work is run immediately.
-                SynchronizationContext.SetSynchronizationContext(new ImmediateExecuteSynchronizationContext());
-
                 Assert.Throws<TimeoutException>(() =>
                 {
                     using (realm.BlockAllOperations())
@@ -107,10 +102,5 @@ namespace osu.Game.Tests.Database
                 }
             });
         }
-
-        private class ImmediateExecuteSynchronizationContext : SynchronizationContext
-        {
-            public override void Post(SendOrPostCallback d, object? state) => d(state);
-        }
     }
 }

From 90a7dd771107f0de718a1fefc286c2d946ee99c8 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 25 Jan 2022 14:30:00 +0900
Subject: [PATCH 2487/5547] In gameplay bindings test, ensure a selection is
 made before attempting to enter gameplay

---
 .../Visual/Navigation/TestSceneChangeAndUseGameplayBindings.cs | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneChangeAndUseGameplayBindings.cs b/osu.Game.Tests/Visual/Navigation/TestSceneChangeAndUseGameplayBindings.cs
index bfcefdbbfe..6165c9d9b1 100644
--- a/osu.Game.Tests/Visual/Navigation/TestSceneChangeAndUseGameplayBindings.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneChangeAndUseGameplayBindings.cs
@@ -50,8 +50,11 @@ namespace osu.Game.Tests.Visual.Navigation
             AddStep("close settings", () => Game.Settings.Hide());
 
             AddStep("import beatmap", () => BeatmapImportHelper.LoadQuickOszIntoOsu(Game).WaitSafely());
+
             PushAndConfirm(() => new PlaySongSelect());
 
+            AddUntilStep("wait for selection", () => !Game.Beatmap.IsDefault);
+
             AddStep("enter gameplay", () => InputManager.Key(Key.Enter));
 
             AddUntilStep("wait for gameplay", () => player?.IsBreakTime.Value == false);

From c0ed30801686e2a25486fb2a80a9ec2534e2b522 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 25 Jan 2022 14:30:32 +0900
Subject: [PATCH 2488/5547] Use more correct method of deletion in
 `TestScenePlaySongSelect`

---
 osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
index 630171a4d0..458c6130c7 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
@@ -64,13 +64,13 @@ namespace osu.Game.Tests.Visual.SongSelect
         {
             base.SetUpSteps();
 
-            AddStep("delete all beatmaps", () =>
+            AddStep("reset defaults", () =>
             {
                 Ruleset.Value = new OsuRuleset().RulesetInfo;
-                manager?.Delete(manager.GetAllUsableBeatmapSets());
-
                 Beatmap.SetDefault();
             });
+
+            AddStep("delete all beatmaps", () => manager?.Delete());
         }
 
         [Test]

From b2b6672095d10a8da9a005dd87d072212893e454 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Tue, 25 Jan 2022 11:43:05 +0300
Subject: [PATCH 2489/5547] Add failing test asserts

---
 osu.Game.Tests/Visual/Editing/TestSceneEditorSaving.cs | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneEditorSaving.cs b/osu.Game.Tests/Visual/Editing/TestSceneEditorSaving.cs
index bf3b46c6f7..96f815621c 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneEditorSaving.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneEditorSaving.cs
@@ -3,6 +3,7 @@
 
 using System.Linq;
 using NUnit.Framework;
+using osu.Framework.Allocation;
 using osu.Framework.Input;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps.ControlPoints;
@@ -40,6 +41,7 @@ namespace osu.Game.Tests.Visual.Editing
             AddStep("Enter compose mode", () => InputManager.Key(Key.F1));
             AddUntilStep("Wait for compose mode load", () => editor.ChildrenOfType<HitObjectComposer>().FirstOrDefault()?.IsLoaded == true);
 
+            AddStep("Set beat divisor", () => editor.Dependencies.Get<BindableBeatDivisor>().Value = 16);
             AddStep("Set overall difficulty", () => editorBeatmap.Difficulty.OverallDifficulty = 7);
             AddStep("Set artist and title", () =>
             {
@@ -88,6 +90,7 @@ namespace osu.Game.Tests.Visual.Editing
         private void checkMutations()
         {
             AddAssert("Beatmap contains single hitcircle", () => editorBeatmap.HitObjects.Count == 1);
+            AddAssert("Beatmap has correct beat divisor", () => editorBeatmap.BeatmapInfo.BeatDivisor == 16);
             AddAssert("Beatmap has correct overall difficulty", () => editorBeatmap.Difficulty.OverallDifficulty == 7);
             AddAssert("Beatmap has correct metadata", () => editorBeatmap.BeatmapInfo.Metadata.Artist == "artist" && editorBeatmap.BeatmapInfo.Metadata.Title == "title");
             AddAssert("Beatmap has correct author", () => editorBeatmap.BeatmapInfo.Metadata.Author.Username == "author");

From f7f58b06a1bd107100d3ed0ee23c65bb0925112c Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Tue, 25 Jan 2022 11:43:16 +0300
Subject: [PATCH 2490/5547] Fix beat divisor not saving in editor

---
 osu.Game/Screens/Edit/Editor.cs | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Screens/Edit/Editor.cs b/osu.Game/Screens/Edit/Editor.cs
index 8c4b458534..b42f629aad 100644
--- a/osu.Game/Screens/Edit/Editor.cs
+++ b/osu.Game/Screens/Edit/Editor.cs
@@ -158,9 +158,6 @@ namespace osu.Game.Screens.Edit
                 return;
             }
 
-            beatDivisor.Value = playableBeatmap.BeatmapInfo.BeatDivisor;
-            beatDivisor.BindValueChanged(divisor => playableBeatmap.BeatmapInfo.BeatDivisor = divisor.NewValue);
-
             // Todo: should probably be done at a DrawableRuleset level to share logic with Player.
             clock = new EditorClock(playableBeatmap, beatDivisor) { IsCoupled = false };
             clock.ChangeSource(loadableBeatmap.Track);
@@ -178,6 +175,9 @@ namespace osu.Game.Screens.Edit
             changeHandler = new EditorChangeHandler(editorBeatmap);
             dependencies.CacheAs<IEditorChangeHandler>(changeHandler);
 
+            beatDivisor.Value = editorBeatmap.BeatmapInfo.BeatDivisor;
+            beatDivisor.BindValueChanged(divisor => editorBeatmap.BeatmapInfo.BeatDivisor = divisor.NewValue);
+
             updateLastSavedHash();
 
             Schedule(() =>

From a93873e8ca0f9290c5be236b363337d71042824f Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Tue, 25 Jan 2022 13:01:30 +0300
Subject: [PATCH 2491/5547] Recreate test beatmap of `EditorTestScene` on set
 up

---
 osu.Game/Tests/Visual/EditorTestScene.cs | 17 +++++------------
 1 file changed, 5 insertions(+), 12 deletions(-)

diff --git a/osu.Game/Tests/Visual/EditorTestScene.cs b/osu.Game/Tests/Visual/EditorTestScene.cs
index 6f751b1736..f7d62a8694 100644
--- a/osu.Game/Tests/Visual/EditorTestScene.cs
+++ b/osu.Game/Tests/Visual/EditorTestScene.cs
@@ -43,28 +43,16 @@ namespace osu.Game.Tests.Visual
         };
 
         private TestBeatmapManager testBeatmapManager;
-        private WorkingBeatmap working;
 
         [BackgroundDependencyLoader]
         private void load(GameHost host, AudioManager audio, RulesetStore rulesets)
         {
             Add(logo);
 
-            working = CreateWorkingBeatmap(Ruleset.Value);
-
             if (IsolateSavingFromDatabase)
                 Dependencies.CacheAs<BeatmapManager>(testBeatmapManager = new TestBeatmapManager(LocalStorage, Realm, rulesets, null, audio, Resources, host, Beatmap.Default));
         }
 
-        protected override void LoadComplete()
-        {
-            base.LoadComplete();
-
-            Beatmap.Value = working;
-            if (testBeatmapManager != null)
-                testBeatmapManager.TestBeatmap = working;
-        }
-
         protected virtual bool EditorComponentsReady => Editor.ChildrenOfType<HitObjectComposer>().FirstOrDefault()?.IsLoaded == true
                                                         && Editor.ChildrenOfType<TimelineArea>().FirstOrDefault()?.IsLoaded == true;
 
@@ -78,6 +66,11 @@ namespace osu.Game.Tests.Visual
 
         protected virtual void LoadEditor()
         {
+            Beatmap.Value = CreateWorkingBeatmap(Ruleset.Value);
+
+            if (testBeatmapManager != null)
+                testBeatmapManager.TestBeatmap = Beatmap.Value;
+
             LoadScreen(editorLoader = new TestEditorLoader());
         }
 

From 4a9f4eecba45e66428de23094f1d1387199bb450 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 25 Jan 2022 20:49:52 +0900
Subject: [PATCH 2492/5547] Use blocking calls to `SynchronizationContext` to
 guarantee order of execution

---
 osu.Game/Database/RealmAccess.cs | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Database/RealmAccess.cs b/osu.Game/Database/RealmAccess.cs
index bf88313663..ffaae9b4ae 100644
--- a/osu.Game/Database/RealmAccess.cs
+++ b/osu.Game/Database/RealmAccess.cs
@@ -607,7 +607,7 @@ namespace osu.Game.Database
                 // and must be posted to the synchronization context.
                 // This is because realm may fire event callbacks between the `unregisterAllSubscriptions` and `updateRealm.Dispose`
                 // calls above.
-                syncContext?.Post(_ =>
+                syncContext?.Send(_ =>
                 {
                     foreach (var action in notificationsResetMap.Values)
                         action();
@@ -647,8 +647,14 @@ namespace osu.Game.Database
             {
                 Logger.Log(@"Restoring realm operations.", LoggingTarget.Database);
                 realmRetrievalLock.Release();
+
                 // Post back to the update thread to revive any subscriptions.
-                syncContext?.Post(_ => ensureUpdateRealm(), null);
+                // In the case we are on the update thread, let's also require this to run synchronously.
+                // This requirement is mostly due to test coverage, but shouldn't cause any harm.
+                if (ThreadSafety.IsUpdateThread)
+                    syncContext?.Send(_ => ensureUpdateRealm(), null);
+                else
+                    syncContext?.Post(_ => ensureUpdateRealm(), null);
             }
         }
 

From 6c69df815a83f718d59354744321ce99ca5b644a Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Tue, 25 Jan 2022 15:25:28 +0300
Subject: [PATCH 2493/5547] Update editor test scenes to set working beatmap
 properly

---
 .../Visual/Editing/TestSceneDifficultySwitching.cs        | 8 +++-----
 .../Visual/Editing/TestSceneEditorBeatmapCreation.cs      | 7 ++-----
 .../Visual/Editing/TestSceneEditorTestGameplay.cs         | 5 ++++-
 3 files changed, 9 insertions(+), 11 deletions(-)

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneDifficultySwitching.cs b/osu.Game.Tests/Visual/Editing/TestSceneDifficultySwitching.cs
index 243bb71e26..cf6488f721 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneDifficultySwitching.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneDifficultySwitching.cs
@@ -13,6 +13,7 @@ using osu.Game.Rulesets;
 using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.UI;
 using osu.Game.Screens.Edit;
+using osu.Game.Storyboards;
 using osu.Game.Tests.Beatmaps.IO;
 
 namespace osu.Game.Tests.Visual.Editing
@@ -37,11 +38,8 @@ namespace osu.Game.Tests.Visual.Editing
             base.SetUpSteps();
         }
 
-        protected override void LoadEditor()
-        {
-            Beatmap.Value = beatmaps.GetWorkingBeatmap(importedBeatmapSet.Beatmaps.First());
-            base.LoadEditor();
-        }
+        protected override WorkingBeatmap CreateWorkingBeatmap(IBeatmap beatmap, Storyboard storyboard = null)
+            => beatmaps.GetWorkingBeatmap(importedBeatmapSet.Beatmaps.First());
 
         [Test]
         public void TestBasicSwitch()
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneEditorBeatmapCreation.cs b/osu.Game.Tests/Visual/Editing/TestSceneEditorBeatmapCreation.cs
index 2386446e96..e3fb44534b 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneEditorBeatmapCreation.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneEditorBeatmapCreation.cs
@@ -13,6 +13,7 @@ using osu.Game.Rulesets;
 using osu.Game.Rulesets.Osu;
 using osu.Game.Screens.Edit;
 using osu.Game.Screens.Edit.Setup;
+using osu.Game.Storyboards;
 using osu.Game.Tests.Resources;
 using SharpCompress.Archives;
 using SharpCompress.Archives.Zip;
@@ -39,11 +40,7 @@ namespace osu.Game.Tests.Visual.Editing
             AddStep("make new beatmap unique", () => EditorBeatmap.Metadata.Title = Guid.NewGuid().ToString());
         }
 
-        protected override void LoadEditor()
-        {
-            Beatmap.Value = new DummyWorkingBeatmap(Audio, null);
-            base.LoadEditor();
-        }
+        protected override WorkingBeatmap CreateWorkingBeatmap(IBeatmap beatmap, Storyboard storyboard = null) => new DummyWorkingBeatmap(Audio, null);
 
         [Test]
         public void TestCreateNewBeatmap()
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneEditorTestGameplay.cs b/osu.Game.Tests/Visual/Editing/TestSceneEditorTestGameplay.cs
index bb630e5d5c..79afc8cf27 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneEditorTestGameplay.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneEditorTestGameplay.cs
@@ -17,6 +17,7 @@ using osu.Game.Screens.Edit;
 using osu.Game.Screens.Edit.Components.Timelines.Summary;
 using osu.Game.Screens.Edit.GameplayTest;
 using osu.Game.Screens.Play;
+using osu.Game.Storyboards;
 using osu.Game.Tests.Beatmaps.IO;
 using osuTK.Graphics;
 using osuTK.Input;
@@ -43,9 +44,11 @@ namespace osu.Game.Tests.Visual.Editing
             base.SetUpSteps();
         }
 
+        protected override WorkingBeatmap CreateWorkingBeatmap(IBeatmap beatmap, Storyboard storyboard = null)
+            => beatmaps.GetWorkingBeatmap(importedBeatmapSet.Beatmaps.First(b => b.RulesetID == 0));
+
         protected override void LoadEditor()
         {
-            Beatmap.Value = beatmaps.GetWorkingBeatmap(importedBeatmapSet.Beatmaps.First(b => b.RulesetID == 0));
             SelectedMods.Value = new[] { new ModCinema() };
             base.LoadEditor();
         }

From cdef67ccd0840053192a151b9d75f303e44ecb07 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 25 Jan 2022 23:38:46 +0900
Subject: [PATCH 2494/5547] Log posted notifications

To help with test failures and the likes.
---
 osu.Game/Overlays/NotificationOverlay.cs                | 3 +++
 osu.Game/Overlays/Notifications/Notification.cs         | 3 +++
 osu.Game/Overlays/Notifications/ProgressNotification.cs | 2 +-
 osu.Game/Overlays/Notifications/SimpleNotification.cs   | 2 +-
 4 files changed, 8 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Overlays/NotificationOverlay.cs b/osu.Game/Overlays/NotificationOverlay.cs
index 8809dec642..e4e3931048 100644
--- a/osu.Game/Overlays/NotificationOverlay.cs
+++ b/osu.Game/Overlays/NotificationOverlay.cs
@@ -12,6 +12,7 @@ using osu.Framework.Allocation;
 using osu.Framework.Audio;
 using osu.Framework.Bindables;
 using osu.Framework.Localisation;
+using osu.Framework.Logging;
 using osu.Framework.Threading;
 using osu.Game.Graphics;
 using osu.Game.Localisation;
@@ -118,6 +119,8 @@ namespace osu.Game.Overlays
         {
             ++runningDepth;
 
+            Logger.Log($"⚠️ {notification.Text}");
+
             notification.Closed += notificationClosed;
 
             if (notification is IHasCompletionTarget hasCompletionTarget)
diff --git a/osu.Game/Overlays/Notifications/Notification.cs b/osu.Game/Overlays/Notifications/Notification.cs
index 44203e8ee7..ec6e9e09b3 100644
--- a/osu.Game/Overlays/Notifications/Notification.cs
+++ b/osu.Game/Overlays/Notifications/Notification.cs
@@ -11,6 +11,7 @@ using osu.Framework.Graphics.Effects;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Input.Events;
+using osu.Framework.Localisation;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osuTK;
@@ -25,6 +26,8 @@ namespace osu.Game.Overlays.Notifications
         /// </summary>
         public event Action Closed;
 
+        public abstract LocalisableString Text { get; set; }
+
         /// <summary>
         /// Whether this notification should forcefully display itself.
         /// </summary>
diff --git a/osu.Game/Overlays/Notifications/ProgressNotification.cs b/osu.Game/Overlays/Notifications/ProgressNotification.cs
index 5b74bff817..4735fcb7c1 100644
--- a/osu.Game/Overlays/Notifications/ProgressNotification.cs
+++ b/osu.Game/Overlays/Notifications/ProgressNotification.cs
@@ -25,7 +25,7 @@ namespace osu.Game.Overlays.Notifications
 
         private LocalisableString text;
 
-        public LocalisableString Text
+        public override LocalisableString Text
         {
             get => text;
             set
diff --git a/osu.Game/Overlays/Notifications/SimpleNotification.cs b/osu.Game/Overlays/Notifications/SimpleNotification.cs
index c32e40ffc8..b9a1cc6d90 100644
--- a/osu.Game/Overlays/Notifications/SimpleNotification.cs
+++ b/osu.Game/Overlays/Notifications/SimpleNotification.cs
@@ -18,7 +18,7 @@ namespace osu.Game.Overlays.Notifications
     {
         private LocalisableString text;
 
-        public LocalisableString Text
+        public override LocalisableString Text
         {
             get => text;
             set

From d1cbdf63f09afb381961cc646782d2c01610f80d Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Tue, 25 Jan 2022 10:43:43 +0300
Subject: [PATCH 2495/5547] Add support for reading/saving timeline zoom in
 editor

---
 .../Compose/Components/Timeline/Timeline.cs   | 29 ++++++++++++++++---
 .../Timeline/ZoomableScrollContainer.cs       |  9 ++++++
 2 files changed, 34 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/Timeline.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/Timeline.cs
index 35a0282611..5722174490 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/Timeline.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/Timeline.cs
@@ -24,7 +24,11 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
     [Cached]
     public class Timeline : ZoomableScrollContainer, IPositionSnapProvider
     {
+        private const float timeline_height = 72;
+        private const float timeline_expanded_height = 94;
+
         private readonly Drawable userContent;
+
         public readonly Bindable<bool> WaveformVisible = new Bindable<bool>();
 
         public readonly Bindable<bool> ControlPointsVisible = new Bindable<bool>();
@@ -58,8 +62,12 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
 
         private Track track;
 
-        private const float timeline_height = 72;
-        private const float timeline_expanded_height = 94;
+        /// <summary>
+        /// The timeline zoom level at a 1x zoom scale.
+        /// </summary>
+        private float defaultTimelineZoom;
+
+        private readonly Bindable<double> timelineZoomScale = new BindableDouble(1.0);
 
         public Timeline(Drawable userContent)
         {
@@ -84,7 +92,7 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
         private Bindable<float> waveformOpacity;
 
         [BackgroundDependencyLoader]
-        private void load(IBindable<WorkingBeatmap> beatmap, OsuColour colours, OsuConfigManager config)
+        private void load(IBindable<WorkingBeatmap> beatmap, EditorBeatmap editorBeatmap, OsuColour colours, OsuConfigManager config)
         {
             CentreMarker centreMarker;
 
@@ -141,9 +149,16 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
                 {
                     MaxZoom = getZoomLevelForVisibleMilliseconds(500);
                     MinZoom = getZoomLevelForVisibleMilliseconds(10000);
-                    Zoom = getZoomLevelForVisibleMilliseconds(6000);
+                    defaultTimelineZoom = getZoomLevelForVisibleMilliseconds(6000);
                 }
             }, true);
+
+            timelineZoomScale.Value = editorBeatmap.BeatmapInfo.TimelineZoom;
+            timelineZoomScale.BindValueChanged(scale =>
+            {
+                Zoom = (float)(defaultTimelineZoom * scale.NewValue);
+                editorBeatmap.BeatmapInfo.TimelineZoom = scale.NewValue;
+            }, true);
         }
 
         protected override void LoadComplete()
@@ -201,6 +216,12 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
             return base.OnScroll(e);
         }
 
+        protected override void OnZoomChange()
+        {
+            base.OnZoomChange();
+            timelineZoomScale.Value = Zoom / defaultTimelineZoom;
+        }
+
         protected override void UpdateAfterChildren()
         {
             base.UpdateAfterChildren();
diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/ZoomableScrollContainer.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/ZoomableScrollContainer.cs
index f10eb0d284..6dea99f1c8 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/ZoomableScrollContainer.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/ZoomableScrollContainer.cs
@@ -136,11 +136,20 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
         {
             zoomTarget = Math.Clamp(newZoom, MinZoom, MaxZoom);
             transformZoomTo(zoomTarget, focusPoint, ZoomDuration, ZoomEasing);
+
+            OnZoomChange();
         }
 
         private void transformZoomTo(float newZoom, float focusPoint, double duration = 0, Easing easing = Easing.None)
             => this.TransformTo(this.PopulateTransform(new TransformZoom(focusPoint, zoomedContent.DrawWidth, Current), newZoom, duration, easing));
 
+        /// <summary>
+        /// Invoked when the zoom target has changed.
+        /// </summary>
+        protected virtual void OnZoomChange()
+        {
+        }
+
         private class TransformZoom : Transform<float, ZoomableScrollContainer>
         {
             /// <summary>

From ad18bc4983254b389c5b80f707ee8610197a5ceb Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Tue, 25 Jan 2022 17:02:23 +0300
Subject: [PATCH 2496/5547] Update timeline selection test scene with zoom
 changes

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

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneTimelineSelection.cs b/osu.Game.Tests/Visual/Editing/TestSceneTimelineSelection.cs
index 2544b6c2a1..81ab4712ab 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneTimelineSelection.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneTimelineSelection.cs
@@ -47,25 +47,25 @@ namespace osu.Game.Tests.Visual.Editing
 
             AddStep("add hitobjects", () => EditorBeatmap.AddRange(addedObjects = new[]
             {
-                new HitCircle { StartTime = 100 },
-                new HitCircle { StartTime = 200, Position = new Vector2(100) },
-                new HitCircle { StartTime = 300, Position = new Vector2(200) },
-                new HitCircle { StartTime = 400, Position = new Vector2(300) },
+                new HitCircle { StartTime = 500 },
+                new HitCircle { StartTime = 1000, Position = new Vector2(100) },
+                new HitCircle { StartTime = 1500, Position = new Vector2(200) },
+                new HitCircle { StartTime = 2000, Position = new Vector2(300) },
             }));
 
             AddStep("select objects", () => EditorBeatmap.SelectedHitObjects.AddRange(addedObjects));
 
             AddStep("nudge forwards", () => InputManager.Key(Key.K));
-            AddAssert("objects moved forwards in time", () => addedObjects[0].StartTime > 100);
+            AddAssert("objects moved forwards in time", () => addedObjects[0].StartTime > 500);
 
             AddStep("nudge backwards", () => InputManager.Key(Key.J));
-            AddAssert("objects reverted to original position", () => addedObjects[0].StartTime == 100);
+            AddAssert("objects reverted to original position", () => addedObjects[0].StartTime == 500);
         }
 
         [Test]
         public void TestBasicSelect()
         {
-            var addedObject = new HitCircle { StartTime = 100 };
+            var addedObject = new HitCircle { StartTime = 500 };
             AddStep("add hitobject", () => EditorBeatmap.Add(addedObject));
 
             moveMouseToObject(() => addedObject);
@@ -75,7 +75,7 @@ namespace osu.Game.Tests.Visual.Editing
 
             var addedObject2 = new HitCircle
             {
-                StartTime = 200,
+                StartTime = 1000,
                 Position = new Vector2(100),
             };
 
@@ -92,10 +92,10 @@ namespace osu.Game.Tests.Visual.Editing
         {
             var addedObjects = new[]
             {
-                new HitCircle { StartTime = 100 },
-                new HitCircle { StartTime = 200, Position = new Vector2(100) },
-                new HitCircle { StartTime = 300, Position = new Vector2(200) },
-                new HitCircle { StartTime = 400, Position = new Vector2(300) },
+                new HitCircle { StartTime = 500 },
+                new HitCircle { StartTime = 1000, Position = new Vector2(100) },
+                new HitCircle { StartTime = 1500, Position = new Vector2(200) },
+                new HitCircle { StartTime = 2000, Position = new Vector2(300) },
             };
 
             AddStep("add hitobjects", () => EditorBeatmap.AddRange(addedObjects));
@@ -125,7 +125,7 @@ namespace osu.Game.Tests.Visual.Editing
         [Test]
         public void TestBasicDeselect()
         {
-            var addedObject = new HitCircle { StartTime = 100 };
+            var addedObject = new HitCircle { StartTime = 500 };
             AddStep("add hitobject", () => EditorBeatmap.Add(addedObject));
 
             moveMouseToObject(() => addedObject);
@@ -166,11 +166,11 @@ namespace osu.Game.Tests.Visual.Editing
         {
             var addedObjects = new[]
             {
-                new HitCircle { StartTime = 100 },
-                new HitCircle { StartTime = 200, Position = new Vector2(100) },
-                new HitCircle { StartTime = 300, Position = new Vector2(200) },
-                new HitCircle { StartTime = 400, Position = new Vector2(300) },
-                new HitCircle { StartTime = 500, Position = new Vector2(400) },
+                new HitCircle { StartTime = 500 },
+                new HitCircle { StartTime = 1000, Position = new Vector2(100) },
+                new HitCircle { StartTime = 1500, Position = new Vector2(200) },
+                new HitCircle { StartTime = 2000, Position = new Vector2(300) },
+                new HitCircle { StartTime = 2500, Position = new Vector2(400) },
             };
 
             AddStep("add hitobjects", () => EditorBeatmap.AddRange(addedObjects));
@@ -236,10 +236,10 @@ namespace osu.Game.Tests.Visual.Editing
         {
             var addedObjects = new[]
             {
-                new HitCircle { StartTime = 100 },
-                new HitCircle { StartTime = 200, Position = new Vector2(100) },
-                new HitCircle { StartTime = 300, Position = new Vector2(200) },
-                new HitCircle { StartTime = 400, Position = new Vector2(300) },
+                new HitCircle { StartTime = 500 },
+                new HitCircle { StartTime = 1000, Position = new Vector2(100) },
+                new HitCircle { StartTime = 1500, Position = new Vector2(200) },
+                new HitCircle { StartTime = 2000, Position = new Vector2(300) },
             };
 
             AddStep("add hitobjects", () => EditorBeatmap.AddRange(addedObjects));

From 4169e5592ee973349fc5f39e1778b948ac722338 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Tue, 25 Jan 2022 19:36:19 +0300
Subject: [PATCH 2497/5547] Reword event handler name and update xmldoc

---
 .../Screens/Edit/Compose/Components/Timeline/Timeline.cs    | 4 ++--
 .../Compose/Components/Timeline/ZoomableScrollContainer.cs  | 6 +++---
 2 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/Timeline.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/Timeline.cs
index 5722174490..51cca4ceff 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/Timeline.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/Timeline.cs
@@ -216,9 +216,9 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
             return base.OnScroll(e);
         }
 
-        protected override void OnZoomChange()
+        protected override void OnZoomChanged()
         {
-            base.OnZoomChange();
+            base.OnZoomChanged();
             timelineZoomScale.Value = Zoom / defaultTimelineZoom;
         }
 
diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/ZoomableScrollContainer.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/ZoomableScrollContainer.cs
index 6dea99f1c8..35d103ddf1 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/ZoomableScrollContainer.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/ZoomableScrollContainer.cs
@@ -137,16 +137,16 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
             zoomTarget = Math.Clamp(newZoom, MinZoom, MaxZoom);
             transformZoomTo(zoomTarget, focusPoint, ZoomDuration, ZoomEasing);
 
-            OnZoomChange();
+            OnZoomChanged();
         }
 
         private void transformZoomTo(float newZoom, float focusPoint, double duration = 0, Easing easing = Easing.None)
             => this.TransformTo(this.PopulateTransform(new TransformZoom(focusPoint, zoomedContent.DrawWidth, Current), newZoom, duration, easing));
 
         /// <summary>
-        /// Invoked when the zoom target has changed.
+        /// Invoked when <see cref="Zoom"/> has changed.
         /// </summary>
-        protected virtual void OnZoomChange()
+        protected virtual void OnZoomChanged()
         {
         }
 

From 5085eb68018d1ae069cce9e754d5e6af326d3a06 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 26 Jan 2022 03:37:11 +0900
Subject: [PATCH 2498/5547] Ensure gameplay starts by dismissing any
 notifications in `TestSceneChangeAndUseGameplayBindings`

---
 .../TestSceneChangeAndUseGameplayBindings.cs        | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneChangeAndUseGameplayBindings.cs b/osu.Game.Tests/Visual/Navigation/TestSceneChangeAndUseGameplayBindings.cs
index 6165c9d9b1..347b4b6c54 100644
--- a/osu.Game.Tests/Visual/Navigation/TestSceneChangeAndUseGameplayBindings.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneChangeAndUseGameplayBindings.cs
@@ -57,6 +57,13 @@ namespace osu.Game.Tests.Visual.Navigation
 
             AddStep("enter gameplay", () => InputManager.Key(Key.Enter));
 
+            AddUntilStep("wait for player", () =>
+            {
+                // dismiss any notifications that may appear (ie. muted notification).
+                clickMouseInCentre();
+                return player != null;
+            });
+
             AddUntilStep("wait for gameplay", () => player?.IsBreakTime.Value == false);
 
             AddStep("press 'z'", () => InputManager.Key(Key.Z));
@@ -66,6 +73,12 @@ namespace osu.Game.Tests.Visual.Navigation
             AddAssert("key counter did increase", () => keyCounter.CountPresses == 1);
         }
 
+        private void clickMouseInCentre()
+        {
+            InputManager.MoveMouseTo(Game.ScreenSpaceDrawQuad.Centre);
+            InputManager.Click(MouseButton.Left);
+        }
+
         private KeyBindingsSubsection osuBindingSubsection => keyBindingPanel
                                                               .ChildrenOfType<VariantBindingsSubsection>()
                                                               .FirstOrDefault(s => s.Ruleset.ShortName == "osu");

From 64914c45a4d7528713b8d06d3e7d54c2335db2cb Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 26 Jan 2022 11:53:50 +0900
Subject: [PATCH 2499/5547] Remove unnecessary realm query helper method

---
 osu.Game/Overlays/Music/PlaylistOverlay.cs | 6 +-----
 1 file changed, 1 insertion(+), 5 deletions(-)

diff --git a/osu.Game/Overlays/Music/PlaylistOverlay.cs b/osu.Game/Overlays/Music/PlaylistOverlay.cs
index 6adcd2a6d6..ffddf168ed 100644
--- a/osu.Game/Overlays/Music/PlaylistOverlay.cs
+++ b/osu.Game/Overlays/Music/PlaylistOverlay.cs
@@ -38,10 +38,6 @@ namespace osu.Game.Overlays.Music
 
         private IDisposable beatmapSubscription;
 
-        private IQueryable<BeatmapSetInfo> availableBeatmaps => realm.Realm
-                                                                     .All<BeatmapSetInfo>()
-                                                                     .Where(s => !s.DeletePending);
-
         private FilterControl filter;
         private Playlist list;
 
@@ -105,7 +101,7 @@ namespace osu.Game.Overlays.Music
 
             // tests might bind externally, in which case we don't want to involve realm.
             if (beatmapSets.Count == 0)
-                beatmapSubscription = realm.RegisterForNotifications(realm => availableBeatmaps, beatmapsChanged);
+                beatmapSubscription = realm.RegisterForNotifications(r => r.All<BeatmapSetInfo>().Where(s => !s.DeletePending), beatmapsChanged);
 
             list.Items.BindTo(beatmapSets);
             beatmap.BindValueChanged(working => list.SelectedSet.Value = working.NewValue.BeatmapSetInfo, true);

From dda513dd08f4aad11b847fef0da0ef4e669f35b0 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 26 Jan 2022 12:19:05 +0900
Subject: [PATCH 2500/5547] Change `PlaylistOverlay` to use `ILive`

---
 .../UserInterface/TestScenePlaylistOverlay.cs |  9 +--
 osu.Game/Collections/BeatmapCollection.cs     |  2 +-
 .../Collections/CollectionFilterDropdown.cs   |  4 +-
 osu.Game/Overlays/Music/Playlist.cs           | 17 ++---
 osu.Game/Overlays/Music/PlaylistItem.cs       | 66 ++++++++++---------
 osu.Game/Overlays/Music/PlaylistOverlay.cs    | 42 +++++++-----
 6 files changed, 76 insertions(+), 64 deletions(-)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestScenePlaylistOverlay.cs b/osu.Game.Tests/Visual/UserInterface/TestScenePlaylistOverlay.cs
index 7131c19471..1a3e38ddd7 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestScenePlaylistOverlay.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestScenePlaylistOverlay.cs
@@ -8,6 +8,7 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
+using osu.Game.Database;
 using osu.Game.Graphics.Containers;
 using osu.Game.Overlays.Music;
 using osu.Game.Tests.Resources;
@@ -18,11 +19,11 @@ namespace osu.Game.Tests.Visual.UserInterface
 {
     public class TestScenePlaylistOverlay : OsuManualInputManagerTestScene
     {
-        private readonly BindableList<BeatmapSetInfo> beatmapSets = new BindableList<BeatmapSetInfo>();
+        private readonly BindableList<ILive<BeatmapSetInfo>> beatmapSets = new BindableList<ILive<BeatmapSetInfo>>();
 
         private PlaylistOverlay playlistOverlay;
 
-        private BeatmapSetInfo first;
+        private ILive<BeatmapSetInfo> first;
 
         [SetUp]
         public void Setup() => Schedule(() =>
@@ -45,7 +46,7 @@ namespace osu.Game.Tests.Visual.UserInterface
 
             for (int i = 0; i < 100; i++)
             {
-                beatmapSets.Add(TestResources.CreateTestBeatmapSetInfo());
+                beatmapSets.Add(TestResources.CreateTestBeatmapSetInfo().ToLiveUnmanaged());
             }
 
             first = beatmapSets.First();
@@ -60,7 +61,7 @@ namespace osu.Game.Tests.Visual.UserInterface
 
             AddStep("hold 1st item handle", () =>
             {
-                var handle = this.ChildrenOfType<OsuRearrangeableListItem<BeatmapSetInfo>.PlaylistItemHandle>().First();
+                var handle = this.ChildrenOfType<OsuRearrangeableListItem<ILive<BeatmapSetInfo>>.PlaylistItemHandle>().First();
                 InputManager.MoveMouseTo(handle.ScreenSpaceDrawQuad.Centre);
                 InputManager.PressButton(MouseButton.Left);
             });
diff --git a/osu.Game/Collections/BeatmapCollection.cs b/osu.Game/Collections/BeatmapCollection.cs
index 1a739f824f..7e4b15ecf9 100644
--- a/osu.Game/Collections/BeatmapCollection.cs
+++ b/osu.Game/Collections/BeatmapCollection.cs
@@ -25,7 +25,7 @@ namespace osu.Game.Collections
         /// <summary>
         /// The beatmaps contained by the collection.
         /// </summary>
-        public readonly BindableList<IBeatmapInfo> Beatmaps = new BindableList<IBeatmapInfo>();
+        public readonly BindableList<BeatmapInfo> Beatmaps = new BindableList<BeatmapInfo>();
 
         /// <summary>
         /// The date when this collection was last modified.
diff --git a/osu.Game/Collections/CollectionFilterDropdown.cs b/osu.Game/Collections/CollectionFilterDropdown.cs
index 77bda00107..c46ba8e06e 100644
--- a/osu.Game/Collections/CollectionFilterDropdown.cs
+++ b/osu.Game/Collections/CollectionFilterDropdown.cs
@@ -38,7 +38,7 @@ namespace osu.Game.Collections
         }
 
         private readonly IBindableList<BeatmapCollection> collections = new BindableList<BeatmapCollection>();
-        private readonly IBindableList<IBeatmapInfo> beatmaps = new BindableList<IBeatmapInfo>();
+        private readonly IBindableList<BeatmapInfo> beatmaps = new BindableList<BeatmapInfo>();
         private readonly BindableList<CollectionFilterMenuItem> filters = new BindableList<CollectionFilterMenuItem>();
 
         [Resolved(CanBeNull = true)]
@@ -196,7 +196,7 @@ namespace osu.Game.Collections
             private IBindable<WorkingBeatmap> beatmap { get; set; }
 
             [CanBeNull]
-            private readonly BindableList<IBeatmapInfo> collectionBeatmaps;
+            private readonly BindableList<BeatmapInfo> collectionBeatmaps;
 
             [NotNull]
             private readonly Bindable<string> collectionName;
diff --git a/osu.Game/Overlays/Music/Playlist.cs b/osu.Game/Overlays/Music/Playlist.cs
index 0b15a3a1bc..c86146ff25 100644
--- a/osu.Game/Overlays/Music/Playlist.cs
+++ b/osu.Game/Overlays/Music/Playlist.cs
@@ -7,16 +7,17 @@ using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Beatmaps;
+using osu.Game.Database;
 using osu.Game.Graphics.Containers;
 using osuTK;
 
 namespace osu.Game.Overlays.Music
 {
-    public class Playlist : OsuRearrangeableListContainer<BeatmapSetInfo>
+    public class Playlist : OsuRearrangeableListContainer<ILive<BeatmapSetInfo>>
     {
-        public Action<BeatmapSetInfo> RequestSelection;
+        public Action<ILive<BeatmapSetInfo>> RequestSelection;
 
-        public readonly Bindable<BeatmapSetInfo> SelectedSet = new Bindable<BeatmapSetInfo>();
+        public readonly Bindable<ILive<BeatmapSetInfo>> SelectedSet = new Bindable<ILive<BeatmapSetInfo>>();
 
         public new MarginPadding Padding
         {
@@ -26,23 +27,23 @@ namespace osu.Game.Overlays.Music
 
         public void Filter(FilterCriteria criteria)
         {
-            var items = (SearchContainer<RearrangeableListItem<BeatmapSetInfo>>)ListContainer;
+            var items = (SearchContainer<RearrangeableListItem<ILive<BeatmapSetInfo>>>)ListContainer;
 
             foreach (var item in items.OfType<PlaylistItem>())
-                item.InSelectedCollection = criteria.Collection?.Beatmaps.Any(b => item.Model.Equals(b.BeatmapSet)) ?? true;
+                item.InSelectedCollection = criteria.Collection?.Beatmaps.Any(b => item.Model.ID == b.BeatmapSet?.ID) ?? true;
 
             items.SearchTerm = criteria.SearchText;
         }
 
-        public BeatmapSetInfo FirstVisibleSet => Items.FirstOrDefault(i => ((PlaylistItem)ItemMap[i]).MatchingFilter);
+        public ILive<BeatmapSetInfo> FirstVisibleSet => Items.FirstOrDefault(i => ((PlaylistItem)ItemMap[i]).MatchingFilter);
 
-        protected override OsuRearrangeableListItem<BeatmapSetInfo> CreateOsuDrawable(BeatmapSetInfo item) => new PlaylistItem(item)
+        protected override OsuRearrangeableListItem<ILive<BeatmapSetInfo>> CreateOsuDrawable(ILive<BeatmapSetInfo> item) => new PlaylistItem(item)
         {
             SelectedSet = { BindTarget = SelectedSet },
             RequestSelection = set => RequestSelection?.Invoke(set)
         };
 
-        protected override FillFlowContainer<RearrangeableListItem<BeatmapSetInfo>> CreateListFillFlowContainer() => new SearchContainer<RearrangeableListItem<BeatmapSetInfo>>
+        protected override FillFlowContainer<RearrangeableListItem<ILive<BeatmapSetInfo>>> CreateListFillFlowContainer() => new SearchContainer<RearrangeableListItem<ILive<BeatmapSetInfo>>>
         {
             Spacing = new Vector2(0, 3),
             LayoutDuration = 200,
diff --git a/osu.Game/Overlays/Music/PlaylistItem.cs b/osu.Game/Overlays/Music/PlaylistItem.cs
index b31a03a64d..3f82580bfb 100644
--- a/osu.Game/Overlays/Music/PlaylistItem.cs
+++ b/osu.Game/Overlays/Music/PlaylistItem.cs
@@ -10,17 +10,18 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Input.Events;
 using osu.Framework.Localisation;
 using osu.Game.Beatmaps;
+using osu.Game.Database;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osuTK.Graphics;
 
 namespace osu.Game.Overlays.Music
 {
-    public class PlaylistItem : OsuRearrangeableListItem<BeatmapSetInfo>, IFilterable
+    public class PlaylistItem : OsuRearrangeableListItem<ILive<BeatmapSetInfo>>, IFilterable
     {
-        public readonly Bindable<BeatmapSetInfo> SelectedSet = new Bindable<BeatmapSetInfo>();
+        public readonly Bindable<ILive<BeatmapSetInfo>> SelectedSet = new Bindable<ILive<BeatmapSetInfo>>();
 
-        public Action<BeatmapSetInfo> RequestSelection;
+        public Action<ILive<BeatmapSetInfo>> RequestSelection;
 
         private TextFlowContainer text;
         private ITextPart titlePart;
@@ -28,7 +29,7 @@ namespace osu.Game.Overlays.Music
         [Resolved]
         private OsuColour colours { get; set; }
 
-        public PlaylistItem(BeatmapSetInfo item)
+        public PlaylistItem(ILive<BeatmapSetInfo> item)
             : base(item)
         {
             Padding = new MarginPadding { Left = 5 };
@@ -44,34 +45,37 @@ namespace osu.Game.Overlays.Music
         {
             base.LoadComplete();
 
-            var metadata = Model.Metadata;
-
-            var title = new RomanisableString(metadata.TitleUnicode, metadata.Title);
-            var artist = new RomanisableString(metadata.ArtistUnicode, metadata.Artist);
-
-            titlePart = text.AddText(title, sprite => sprite.Font = OsuFont.GetFont(weight: FontWeight.Regular));
-            titlePart.DrawablePartsRecreated += _ => updateSelectionState(true);
-
-            text.AddText(@"  "); // to separate the title from the artist.
-            text.AddText(artist, sprite =>
+            Model.PerformRead(m =>
             {
-                sprite.Font = OsuFont.GetFont(size: 14, weight: FontWeight.Bold);
-                sprite.Colour = colours.Gray9;
-                sprite.Padding = new MarginPadding { Top = 1 };
+                var metadata = m.Metadata;
+
+                var title = new RomanisableString(metadata.TitleUnicode, metadata.Title);
+                var artist = new RomanisableString(metadata.ArtistUnicode, metadata.Artist);
+
+                titlePart = text.AddText(title, sprite => sprite.Font = OsuFont.GetFont(weight: FontWeight.Regular));
+                titlePart.DrawablePartsRecreated += _ => updateSelectionState(true);
+
+                text.AddText(@"  "); // to separate the title from the artist.
+                text.AddText(artist, sprite =>
+                {
+                    sprite.Font = OsuFont.GetFont(size: 14, weight: FontWeight.Bold);
+                    sprite.Colour = colours.Gray9;
+                    sprite.Padding = new MarginPadding { Top = 1 };
+                });
+
+                SelectedSet.BindValueChanged(set =>
+                {
+                    bool newSelected = set.NewValue?.Equals(Model) == true;
+
+                    if (newSelected == selected)
+                        return;
+
+                    selected = newSelected;
+                    updateSelectionState(false);
+                });
+
+                updateSelectionState(true);
             });
-
-            SelectedSet.BindValueChanged(set =>
-            {
-                bool newSelected = set.NewValue?.Equals(Model) == true;
-
-                if (newSelected == selected)
-                    return;
-
-                selected = newSelected;
-                updateSelectionState(false);
-            });
-
-            updateSelectionState(true);
         }
 
         private bool selected;
@@ -109,7 +113,7 @@ namespace osu.Game.Overlays.Music
             }
         }
 
-        public IEnumerable<string> FilterTerms => Model.Metadata.GetSearchableTerms();
+        public IEnumerable<string> FilterTerms => Model.PerformRead(m => m.Metadata.GetSearchableTerms());
 
         private bool matchingFilter = true;
 
diff --git a/osu.Game/Overlays/Music/PlaylistOverlay.cs b/osu.Game/Overlays/Music/PlaylistOverlay.cs
index ffddf168ed..4b10bb779e 100644
--- a/osu.Game/Overlays/Music/PlaylistOverlay.cs
+++ b/osu.Game/Overlays/Music/PlaylistOverlay.cs
@@ -24,9 +24,9 @@ namespace osu.Game.Overlays.Music
         private const float transition_duration = 600;
         private const float playlist_height = 510;
 
-        public IBindableList<BeatmapSetInfo> BeatmapSets => beatmapSets;
+        public IBindableList<ILive<BeatmapSetInfo>> BeatmapSets => beatmapSets;
 
-        private readonly BindableList<BeatmapSetInfo> beatmapSets = new BindableList<BeatmapSetInfo>();
+        private readonly BindableList<ILive<BeatmapSetInfo>> beatmapSets = new BindableList<ILive<BeatmapSetInfo>>();
 
         private readonly Bindable<WorkingBeatmap> beatmap = new Bindable<WorkingBeatmap>();
 
@@ -85,13 +85,16 @@ namespace osu.Game.Overlays.Music
 
             filter.Search.OnCommit += (sender, newText) =>
             {
-                BeatmapInfo toSelect = list.FirstVisibleSet?.Beatmaps.FirstOrDefault();
-
-                if (toSelect != null)
+                list.FirstVisibleSet.PerformRead(set =>
                 {
-                    beatmap.Value = beatmaps.GetWorkingBeatmap(toSelect);
-                    beatmap.Value.Track.Restart();
-                }
+                    BeatmapInfo toSelect = set.Beatmaps.FirstOrDefault();
+
+                    if (toSelect != null)
+                    {
+                        beatmap.Value = beatmaps.GetWorkingBeatmap(toSelect);
+                        beatmap.Value.Track.Restart();
+                    }
+                });
             };
         }
 
@@ -104,7 +107,7 @@ namespace osu.Game.Overlays.Music
                 beatmapSubscription = realm.RegisterForNotifications(r => r.All<BeatmapSetInfo>().Where(s => !s.DeletePending), beatmapsChanged);
 
             list.Items.BindTo(beatmapSets);
-            beatmap.BindValueChanged(working => list.SelectedSet.Value = working.NewValue.BeatmapSetInfo, true);
+            beatmap.BindValueChanged(working => list.SelectedSet.Value = working.NewValue.BeatmapSetInfo.ToLive(realm), true);
         }
 
         private void beatmapsChanged(IRealmCollection<BeatmapSetInfo> sender, ChangeSet changes, Exception error)
@@ -113,12 +116,12 @@ namespace osu.Game.Overlays.Music
             {
                 beatmapSets.Clear();
                 // must use AddRange to avoid RearrangeableList sort overhead per add op.
-                beatmapSets.AddRange(sender);
+                beatmapSets.AddRange(sender.ToLive(realm));
                 return;
             }
 
             foreach (int i in changes.InsertedIndices)
-                beatmapSets.Insert(i, sender[i]);
+                beatmapSets.Insert(i, sender[i].ToLive(realm));
 
             foreach (int i in changes.DeletedIndices.OrderByDescending(i => i))
                 beatmapSets.RemoveAt(i);
@@ -141,16 +144,19 @@ namespace osu.Game.Overlays.Music
             this.FadeOut(transition_duration);
         }
 
-        private void itemSelected(BeatmapSetInfo set)
+        private void itemSelected(ILive<BeatmapSetInfo> beatmapSet)
         {
-            if (set.Equals((beatmap.Value?.BeatmapSetInfo)))
+            beatmapSet.PerformRead(set =>
             {
-                beatmap.Value?.Track.Seek(0);
-                return;
-            }
+                if (set.Equals((beatmap.Value?.BeatmapSetInfo)))
+                {
+                    beatmap.Value?.Track.Seek(0);
+                    return;
+                }
 
-            beatmap.Value = beatmaps.GetWorkingBeatmap(set.Beatmaps.First());
-            beatmap.Value.Track.Restart();
+                beatmap.Value = beatmaps.GetWorkingBeatmap(set.Beatmaps.First());
+                beatmap.Value.Track.Restart();
+            });
         }
 
         protected override void Dispose(bool isDisposing)

From d76822b6857dbad12737662352157d1bb4b6ff69 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 17 Jan 2022 18:32:57 +0900
Subject: [PATCH 2501/5547] Avoid creating realm contexts or refetching when
 accessing `RealmLive` from the update thread

---
 osu.Game/Database/RealmLive.cs | 38 +++++++++++++++++++++++++++++++---
 1 file changed, 35 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Database/RealmLive.cs b/osu.Game/Database/RealmLive.cs
index f06ba1eff9..c572d52cc6 100644
--- a/osu.Game/Database/RealmLive.cs
+++ b/osu.Game/Database/RealmLive.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.Development;
 using Realms;
 
@@ -22,7 +23,9 @@ namespace osu.Game.Database
         /// <summary>
         /// The original live data used to create this instance.
         /// </summary>
-        private readonly T data;
+        private T data;
+
+        private bool dataIsFromUpdateThread;
 
         private readonly RealmAccess realm;
 
@@ -37,6 +40,7 @@ namespace osu.Game.Database
             this.realm = realm;
 
             ID = data.ID;
+            dataIsFromUpdateThread = ThreadSafety.IsUpdateThread;
         }
 
         /// <summary>
@@ -51,7 +55,17 @@ namespace osu.Game.Database
                 return;
             }
 
-            realm.Run(r => perform(retrieveFromID(r, ID)));
+            realm.Run(r =>
+            {
+                if (ThreadSafety.IsUpdateThread)
+                {
+                    ensureDataIsFromUpdateThread();
+                    perform(data);
+                    return;
+                }
+
+                perform(retrieveFromID(r, ID));
+            });
         }
 
         /// <summary>
@@ -63,6 +77,12 @@ namespace osu.Game.Database
             if (!IsManaged)
                 return perform(data);
 
+            if (ThreadSafety.IsUpdateThread)
+            {
+                ensureDataIsFromUpdateThread();
+                return perform(data);
+            }
+
             return realm.Run(r =>
             {
                 var returnData = perform(retrieveFromID(r, ID));
@@ -101,10 +121,22 @@ namespace osu.Game.Database
                 if (!ThreadSafety.IsUpdateThread)
                     throw new InvalidOperationException($"Can't use {nameof(Value)} on managed objects from non-update threads");
 
-                return realm.Realm.Find<T>(ID);
+                ensureDataIsFromUpdateThread();
+                return data;
             }
         }
 
+        private void ensureDataIsFromUpdateThread()
+        {
+            Debug.Assert(ThreadSafety.IsUpdateThread);
+
+            if (dataIsFromUpdateThread)
+                return;
+
+            dataIsFromUpdateThread = true;
+            data = retrieveFromID(realm.Realm, ID);
+        }
+
         private T retrieveFromID(Realm realm, Guid id)
         {
             var found = realm.Find<T>(ID);

From 56b06f34f01818063f18cf5d7d1c952f328f7dc9 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 21 Jan 2022 02:10:14 +0900
Subject: [PATCH 2502/5547] Fix `RealmLive` not refetching if update thread
 context was closed at some point

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

diff --git a/osu.Game/Database/RealmLive.cs b/osu.Game/Database/RealmLive.cs
index c572d52cc6..d420c3b5c7 100644
--- a/osu.Game/Database/RealmLive.cs
+++ b/osu.Game/Database/RealmLive.cs
@@ -130,7 +130,7 @@ namespace osu.Game.Database
         {
             Debug.Assert(ThreadSafety.IsUpdateThread);
 
-            if (dataIsFromUpdateThread)
+            if (dataIsFromUpdateThread && !data.Realm.IsClosed)
                 return;
 
             dataIsFromUpdateThread = true;

From c7947b34890aa64297cc22139ec9f6b683c81492 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 26 Jan 2022 12:42:24 +0900
Subject: [PATCH 2503/5547] Add statistics for `Live` usage

---
 osu.Game/Database/RealmLive.cs | 18 +++++++++++++++++-
 1 file changed, 17 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Database/RealmLive.cs b/osu.Game/Database/RealmLive.cs
index d420c3b5c7..76a17e860f 100644
--- a/osu.Game/Database/RealmLive.cs
+++ b/osu.Game/Database/RealmLive.cs
@@ -4,6 +4,7 @@
 using System;
 using System.Diagnostics;
 using osu.Framework.Development;
+using osu.Framework.Statistics;
 using Realms;
 
 #nullable enable
@@ -14,7 +15,7 @@ namespace osu.Game.Database
     /// Provides a method of working with realm objects over longer application lifetimes.
     /// </summary>
     /// <typeparam name="T">The underlying object type.</typeparam>
-    public class RealmLive<T> : ILive<T> where T : RealmObject, IHasGuidPrimaryKey
+    public class RealmLive<T> : RealmLive, ILive<T> where T : RealmObject, IHasGuidPrimaryKey
     {
         public Guid ID { get; }
 
@@ -65,6 +66,7 @@ namespace osu.Game.Database
                 }
 
                 perform(retrieveFromID(r, ID));
+                USAGE_ASYNC.Value++;
             });
         }
 
@@ -86,6 +88,7 @@ namespace osu.Game.Database
             return realm.Run(r =>
             {
                 var returnData = perform(retrieveFromID(r, ID));
+                USAGE_ASYNC.Value++;
 
                 if (returnData is RealmObjectBase realmObject && realmObject.IsManaged)
                     throw new InvalidOperationException(@$"Managed realm objects should not exit the scope of {nameof(PerformRead)}.");
@@ -108,6 +111,7 @@ namespace osu.Game.Database
                 var transaction = t.Realm.BeginWrite();
                 perform(t);
                 transaction.Commit();
+                WRITES.Value++;
             });
         }
 
@@ -131,10 +135,14 @@ namespace osu.Game.Database
             Debug.Assert(ThreadSafety.IsUpdateThread);
 
             if (dataIsFromUpdateThread && !data.Realm.IsClosed)
+            {
+                USAGE_UPDATE_IMMEDIATE.Value++;
                 return;
+            }
 
             dataIsFromUpdateThread = true;
             data = retrieveFromID(realm.Realm, ID);
+            USAGE_UPDATE_REFETCH.Value++;
         }
 
         private T retrieveFromID(Realm realm, Guid id)
@@ -157,4 +165,12 @@ namespace osu.Game.Database
 
         public override string ToString() => PerformRead(i => i.ToString());
     }
+
+    public class RealmLive
+    {
+        protected static readonly GlobalStatistic<int> WRITES = GlobalStatistics.Get<int>(@"Realm", @"Live writes");
+        protected static readonly GlobalStatistic<int> USAGE_UPDATE_IMMEDIATE = GlobalStatistics.Get<int>(@"Realm", @"Live update read (fast)");
+        protected static readonly GlobalStatistic<int> USAGE_UPDATE_REFETCH = GlobalStatistics.Get<int>(@"Realm", @"Live update read (slow)");
+        protected static readonly GlobalStatistic<int> USAGE_ASYNC = GlobalStatistics.Get<int>(@"Realm", @"Live async read");
+    }
 }

From 7ca73f7e6def6c7ae3447ba79fc0b475984c9b74 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 26 Jan 2022 12:51:09 +0900
Subject: [PATCH 2504/5547] Don't auto-unblock realm when user has manually
 pressed unblock button

---
 .../Overlays/Settings/Sections/DebugSettings/MemorySettings.cs | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/osu.Game/Overlays/Settings/Sections/DebugSettings/MemorySettings.cs b/osu.Game/Overlays/Settings/Sections/DebugSettings/MemorySettings.cs
index 3b94cae171..f26326a220 100644
--- a/osu.Game/Overlays/Settings/Sections/DebugSettings/MemorySettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/DebugSettings/MemorySettings.cs
@@ -73,6 +73,9 @@ namespace osu.Game.Overlays.Settings.Sections.DebugSettings
 
                     void unblock()
                     {
+                        if (token == null)
+                            return;
+
                         token?.Dispose();
                         token = null;
 

From d37c3c463e5b82aaa7084e1e748ead6651eb2ba9 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 26 Jan 2022 13:29:12 +0900
Subject: [PATCH 2505/5547] Move statistics to static class

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

diff --git a/osu.Game/Database/RealmLive.cs b/osu.Game/Database/RealmLive.cs
index 76a17e860f..13b9bc2704 100644
--- a/osu.Game/Database/RealmLive.cs
+++ b/osu.Game/Database/RealmLive.cs
@@ -15,7 +15,7 @@ namespace osu.Game.Database
     /// Provides a method of working with realm objects over longer application lifetimes.
     /// </summary>
     /// <typeparam name="T">The underlying object type.</typeparam>
-    public class RealmLive<T> : RealmLive, ILive<T> where T : RealmObject, IHasGuidPrimaryKey
+    public class RealmLive<T> : ILive<T> where T : RealmObject, IHasGuidPrimaryKey
     {
         public Guid ID { get; }
 
@@ -66,7 +66,7 @@ namespace osu.Game.Database
                 }
 
                 perform(retrieveFromID(r, ID));
-                USAGE_ASYNC.Value++;
+                RealmLiveStatistics.USAGE_ASYNC.Value++;
             });
         }
 
@@ -88,7 +88,7 @@ namespace osu.Game.Database
             return realm.Run(r =>
             {
                 var returnData = perform(retrieveFromID(r, ID));
-                USAGE_ASYNC.Value++;
+                RealmLiveStatistics.USAGE_ASYNC.Value++;
 
                 if (returnData is RealmObjectBase realmObject && realmObject.IsManaged)
                     throw new InvalidOperationException(@$"Managed realm objects should not exit the scope of {nameof(PerformRead)}.");
@@ -111,7 +111,7 @@ namespace osu.Game.Database
                 var transaction = t.Realm.BeginWrite();
                 perform(t);
                 transaction.Commit();
-                WRITES.Value++;
+                RealmLiveStatistics.WRITES.Value++;
             });
         }
 
@@ -136,13 +136,13 @@ namespace osu.Game.Database
 
             if (dataIsFromUpdateThread && !data.Realm.IsClosed)
             {
-                USAGE_UPDATE_IMMEDIATE.Value++;
+                RealmLiveStatistics.USAGE_UPDATE_IMMEDIATE.Value++;
                 return;
             }
 
             dataIsFromUpdateThread = true;
             data = retrieveFromID(realm.Realm, ID);
-            USAGE_UPDATE_REFETCH.Value++;
+            RealmLiveStatistics.USAGE_UPDATE_REFETCH.Value++;
         }
 
         private T retrieveFromID(Realm realm, Guid id)
@@ -166,11 +166,11 @@ namespace osu.Game.Database
         public override string ToString() => PerformRead(i => i.ToString());
     }
 
-    public class RealmLive
+    internal static class RealmLiveStatistics
     {
-        protected static readonly GlobalStatistic<int> WRITES = GlobalStatistics.Get<int>(@"Realm", @"Live writes");
-        protected static readonly GlobalStatistic<int> USAGE_UPDATE_IMMEDIATE = GlobalStatistics.Get<int>(@"Realm", @"Live update read (fast)");
-        protected static readonly GlobalStatistic<int> USAGE_UPDATE_REFETCH = GlobalStatistics.Get<int>(@"Realm", @"Live update read (slow)");
-        protected static readonly GlobalStatistic<int> USAGE_ASYNC = GlobalStatistics.Get<int>(@"Realm", @"Live async read");
+        public static readonly GlobalStatistic<int> WRITES = GlobalStatistics.Get<int>(@"Realm", @"Live writes");
+        public static readonly GlobalStatistic<int> USAGE_UPDATE_IMMEDIATE = GlobalStatistics.Get<int>(@"Realm", @"Live update read (fast)");
+        public static readonly GlobalStatistic<int> USAGE_UPDATE_REFETCH = GlobalStatistics.Get<int>(@"Realm", @"Live update read (slow)");
+        public static readonly GlobalStatistic<int> USAGE_ASYNC = GlobalStatistics.Get<int>(@"Realm", @"Live async read");
     }
 }

From cd71ec0edd6576384418b45683ae3615dbdca669 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 26 Jan 2022 13:37:33 +0900
Subject: [PATCH 2506/5547] Remove `ILive<>` interface (and use `abstract
 Live<>` instead)

---
 .../Database/BeatmapImporterTests.cs          |  8 +++---
 osu.Game.Tests/Database/RealmLiveTests.cs     | 16 +++++------
 ...eneOnlinePlayBeatmapAvailabilityTracker.cs |  4 +--
 osu.Game.Tests/Skins/IO/ImportSkinTest.cs     |  8 +++---
 .../Gameplay/TestSceneReplayDownloadButton.cs |  2 +-
 .../TestSceneDrawableRoomPlaylist.cs          |  2 +-
 osu.Game/Beatmaps/BeatmapManager.cs           | 14 +++++-----
 osu.Game/Database/IModelImporter.cs           | 10 +++----
 osu.Game/Database/IPostImports.cs             |  4 +--
 osu.Game/Database/LegacyModelImporter.cs      |  2 +-
 osu.Game/Database/{ILive.cs => Live.cs}       | 27 +++++++++++++------
 osu.Game/Database/RealmLive.cs                | 20 +++++---------
 osu.Game/Database/RealmLiveUnmanaged.cs       | 27 ++++++++-----------
 osu.Game/Database/RealmObjectExtensions.cs    | 12 ++++-----
 osu.Game/OsuGame.cs                           |  4 +--
 .../Overlays/Settings/Sections/SkinSection.cs | 14 +++++-----
 osu.Game/Scoring/ScoreManager.cs              | 10 +++----
 osu.Game/Skinning/Skin.cs                     |  2 +-
 osu.Game/Skinning/SkinManager.cs              | 14 +++++-----
 osu.Game/Stores/RealmArchiveModelImporter.cs  | 16 +++++------
 20 files changed, 108 insertions(+), 108 deletions(-)
 rename osu.Game/Database/{ILive.cs => Live.cs} (65%)

diff --git a/osu.Game.Tests/Database/BeatmapImporterTests.cs b/osu.Game.Tests/Database/BeatmapImporterTests.cs
index 69dd2d930a..2c7d0211a0 100644
--- a/osu.Game.Tests/Database/BeatmapImporterTests.cs
+++ b/osu.Game.Tests/Database/BeatmapImporterTests.cs
@@ -43,7 +43,7 @@ namespace osu.Game.Tests.Database
                 using (var importer = new BeatmapModelManager(realm, storage))
                 using (new RulesetStore(realm, storage))
                 {
-                    ILive<BeatmapSetInfo>? beatmapSet;
+                    Live<BeatmapSetInfo>? beatmapSet;
 
                     using (var reader = new ZipArchiveReader(TestResources.GetTestBeatmapStream()))
                         beatmapSet = await importer.Import(reader);
@@ -87,7 +87,7 @@ namespace osu.Game.Tests.Database
                 using (var importer = new BeatmapModelManager(realm, storage))
                 using (new RulesetStore(realm, storage))
                 {
-                    ILive<BeatmapSetInfo>? beatmapSet;
+                    Live<BeatmapSetInfo>? beatmapSet;
 
                     using (var reader = new ZipArchiveReader(TestResources.GetTestBeatmapStream()))
                         beatmapSet = await importer.Import(reader);
@@ -144,7 +144,7 @@ namespace osu.Game.Tests.Database
                 using (var importer = new BeatmapModelManager(realm, storage))
                 using (new RulesetStore(realm, storage))
                 {
-                    ILive<BeatmapSetInfo>? imported;
+                    Live<BeatmapSetInfo>? imported;
 
                     using (var reader = new ZipArchiveReader(TestResources.GetTestBeatmapStream()))
                         imported = await importer.Import(reader);
@@ -219,7 +219,7 @@ namespace osu.Game.Tests.Database
 
                 string? tempPath = TestResources.GetTestBeatmapForImport();
 
-                ILive<BeatmapSetInfo>? importedSet;
+                Live<BeatmapSetInfo>? importedSet;
 
                 using (var stream = File.OpenRead(tempPath))
                 {
diff --git a/osu.Game.Tests/Database/RealmLiveTests.cs b/osu.Game.Tests/Database/RealmLiveTests.cs
index 2e3f708f79..3f81b36378 100644
--- a/osu.Game.Tests/Database/RealmLiveTests.cs
+++ b/osu.Game.Tests/Database/RealmLiveTests.cs
@@ -23,9 +23,9 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealm((realm, _) =>
             {
-                ILive<BeatmapInfo> beatmap = realm.Run(r => r.Write(_ => r.Add(new BeatmapInfo(CreateRuleset(), new BeatmapDifficulty(), new BeatmapMetadata()))).ToLive(realm));
+                Live<BeatmapInfo> beatmap = realm.Run(r => r.Write(_ => r.Add(new BeatmapInfo(CreateRuleset(), new BeatmapDifficulty(), new BeatmapMetadata()))).ToLive(realm));
 
-                ILive<BeatmapInfo> beatmap2 = realm.Run(r => r.All<BeatmapInfo>().First().ToLive(realm));
+                Live<BeatmapInfo> beatmap2 = realm.Run(r => r.All<BeatmapInfo>().First().ToLive(realm));
 
                 Assert.AreEqual(beatmap, beatmap2);
             });
@@ -38,7 +38,7 @@ namespace osu.Game.Tests.Database
             {
                 var beatmap = new BeatmapInfo(CreateRuleset(), new BeatmapDifficulty(), new BeatmapMetadata());
 
-                ILive<BeatmapInfo>? liveBeatmap = null;
+                Live<BeatmapInfo>? liveBeatmap = null;
 
                 realm.Run(r =>
                 {
@@ -100,7 +100,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealm((realm, _) =>
             {
-                ILive<BeatmapInfo>? liveBeatmap = null;
+                Live<BeatmapInfo>? liveBeatmap = null;
                 Task.Factory.StartNew(() =>
                 {
                     realm.Run(threadContext =>
@@ -129,7 +129,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealm((realm, _) =>
             {
-                ILive<BeatmapInfo>? liveBeatmap = null;
+                Live<BeatmapInfo>? liveBeatmap = null;
                 Task.Factory.StartNew(() =>
                 {
                     realm.Run(threadContext =>
@@ -170,7 +170,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealm((realm, _) =>
             {
-                ILive<BeatmapInfo>? liveBeatmap = null;
+                Live<BeatmapInfo>? liveBeatmap = null;
 
                 Task.Factory.StartNew(() =>
                 {
@@ -209,7 +209,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealm((realm, _) =>
             {
-                ILive<BeatmapInfo>? liveBeatmap = null;
+                Live<BeatmapInfo>? liveBeatmap = null;
                 Task.Factory.StartNew(() =>
                 {
                     realm.Run(threadContext =>
@@ -242,7 +242,7 @@ namespace osu.Game.Tests.Database
                 realm.RegisterCustomSubscription(outerRealm =>
                 {
                     outerRealm.All<BeatmapInfo>().QueryAsyncWithNotifications(gotChange);
-                    ILive<BeatmapInfo>? liveBeatmap = null;
+                    Live<BeatmapInfo>? liveBeatmap = null;
 
                     Task.Factory.StartNew(() =>
                     {
diff --git a/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs b/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
index 95c15367aa..f9161816e7 100644
--- a/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
+++ b/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
@@ -164,7 +164,7 @@ namespace osu.Game.Tests.Online
         {
             public TaskCompletionSource<bool> AllowImport = new TaskCompletionSource<bool>();
 
-            public ILive<BeatmapSetInfo> CurrentImport { get; private set; }
+            public Live<BeatmapSetInfo> CurrentImport { get; private set; }
 
             public TestBeatmapManager(Storage storage, RealmAccess realm, RulesetStore rulesets, IAPIProvider api, [NotNull] AudioManager audioManager, IResourceStore<byte[]> resources, GameHost host = null, WorkingBeatmap defaultBeatmap = null)
                 : base(storage, realm, rulesets, api, audioManager, resources, host, defaultBeatmap)
@@ -186,7 +186,7 @@ namespace osu.Game.Tests.Online
                     this.testBeatmapManager = testBeatmapManager;
                 }
 
-                public override ILive<BeatmapSetInfo> Import(BeatmapSetInfo item, ArchiveReader archive = null, bool lowPriority = false, CancellationToken cancellationToken = default)
+                public override Live<BeatmapSetInfo> Import(BeatmapSetInfo item, ArchiveReader archive = null, bool lowPriority = false, CancellationToken cancellationToken = default)
                 {
                     testBeatmapManager.AllowImport.Task.WaitSafely();
                     return (testBeatmapManager.CurrentImport = base.Import(item, archive, lowPriority, cancellationToken));
diff --git a/osu.Game.Tests/Skins/IO/ImportSkinTest.cs b/osu.Game.Tests/Skins/IO/ImportSkinTest.cs
index 3f063264e0..9b0facd625 100644
--- a/osu.Game.Tests/Skins/IO/ImportSkinTest.cs
+++ b/osu.Game.Tests/Skins/IO/ImportSkinTest.cs
@@ -235,7 +235,7 @@ namespace osu.Game.Tests.Skins.IO
 
         #endregion
 
-        private void assertCorrectMetadata(ILive<SkinInfo> import1, string name, string creator, OsuGameBase osu)
+        private void assertCorrectMetadata(Live<SkinInfo> import1, string name, string creator, OsuGameBase osu)
         {
             import1.PerformRead(i =>
             {
@@ -250,7 +250,7 @@ namespace osu.Game.Tests.Skins.IO
             });
         }
 
-        private void assertImportedBoth(ILive<SkinInfo> import1, ILive<SkinInfo> import2)
+        private void assertImportedBoth(Live<SkinInfo> import1, Live<SkinInfo> import2)
         {
             import1.PerformRead(i1 => import2.PerformRead(i2 =>
             {
@@ -260,7 +260,7 @@ namespace osu.Game.Tests.Skins.IO
             }));
         }
 
-        private void assertImportedOnce(ILive<SkinInfo> import1, ILive<SkinInfo> import2)
+        private void assertImportedOnce(Live<SkinInfo> import1, Live<SkinInfo> import2)
         {
             import1.PerformRead(i1 => import2.PerformRead(i2 =>
             {
@@ -334,7 +334,7 @@ namespace osu.Game.Tests.Skins.IO
             }
         }
 
-        private async Task<ILive<SkinInfo>> loadSkinIntoOsu(OsuGameBase osu, ArchiveReader archive = null)
+        private async Task<Live<SkinInfo>> loadSkinIntoOsu(OsuGameBase osu, ArchiveReader archive = null)
         {
             var skinManager = osu.Dependencies.Get<SkinManager>();
             return await skinManager.Import(archive);
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneReplayDownloadButton.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneReplayDownloadButton.cs
index a12171401a..8b7e1c4e58 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneReplayDownloadButton.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneReplayDownloadButton.cs
@@ -132,7 +132,7 @@ namespace osu.Game.Tests.Visual.Gameplay
         [Test]
         public void TestScoreImportThenDelete()
         {
-            ILive<ScoreInfo> imported = null;
+            Live<ScoreInfo> imported = null;
 
             AddStep("create button without replay", () =>
             {
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
index 92accb0cd1..5c8c90e166 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
@@ -153,7 +153,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         public void TestDownloadButtonHiddenWhenBeatmapExists()
         {
             var beatmap = new TestBeatmap(new OsuRuleset().RulesetInfo).BeatmapInfo;
-            ILive<BeatmapSetInfo> imported = null;
+            Live<BeatmapSetInfo> imported = null;
 
             Debug.Assert(beatmap.BeatmapSet != null);
 
diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index a1c1982f00..414b7cd12b 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -182,7 +182,7 @@ namespace osu.Game.Beatmaps
         /// </summary>
         /// <param name="query">The query.</param>
         /// <returns>The first result for the provided query, or null if no results were found.</returns>
-        public ILive<BeatmapSetInfo>? QueryBeatmapSet(Expression<Func<BeatmapSetInfo, bool>> query)
+        public Live<BeatmapSetInfo>? QueryBeatmapSet(Expression<Func<BeatmapSetInfo, bool>> query)
         {
             return realm.Run(r => r.All<BeatmapSetInfo>().FirstOrDefault(query)?.ToLive(realm));
         }
@@ -279,22 +279,22 @@ namespace osu.Game.Beatmaps
             return beatmapModelManager.Import(tasks);
         }
 
-        public Task<IEnumerable<ILive<BeatmapSetInfo>>> Import(ProgressNotification notification, params ImportTask[] tasks)
+        public Task<IEnumerable<Live<BeatmapSetInfo>>> Import(ProgressNotification notification, params ImportTask[] tasks)
         {
             return beatmapModelManager.Import(notification, tasks);
         }
 
-        public Task<ILive<BeatmapSetInfo>?> Import(ImportTask task, bool lowPriority = false, CancellationToken cancellationToken = default)
+        public Task<Live<BeatmapSetInfo>?> Import(ImportTask task, bool lowPriority = false, CancellationToken cancellationToken = default)
         {
             return beatmapModelManager.Import(task, lowPriority, cancellationToken);
         }
 
-        public Task<ILive<BeatmapSetInfo>?> Import(ArchiveReader archive, bool lowPriority = false, CancellationToken cancellationToken = default)
+        public Task<Live<BeatmapSetInfo>?> Import(ArchiveReader archive, bool lowPriority = false, CancellationToken cancellationToken = default)
         {
             return beatmapModelManager.Import(archive, lowPriority, cancellationToken);
         }
 
-        public ILive<BeatmapSetInfo>? Import(BeatmapSetInfo item, ArchiveReader? archive = null, bool lowPriority = false, CancellationToken cancellationToken = default)
+        public Live<BeatmapSetInfo>? Import(BeatmapSetInfo item, ArchiveReader? archive = null, bool lowPriority = false, CancellationToken cancellationToken = default)
         {
             return beatmapModelManager.Import(item, archive, lowPriority, cancellationToken);
         }
@@ -323,7 +323,7 @@ namespace osu.Game.Beatmaps
             return workingBeatmapCache.GetWorkingBeatmap(importedBeatmap);
         }
 
-        public WorkingBeatmap GetWorkingBeatmap(ILive<BeatmapInfo>? importedBeatmap)
+        public WorkingBeatmap GetWorkingBeatmap(Live<BeatmapInfo>? importedBeatmap)
         {
             WorkingBeatmap working = workingBeatmapCache.GetWorkingBeatmap(null);
 
@@ -367,7 +367,7 @@ namespace osu.Game.Beatmaps
 
         #region Implementation of IPostImports<out BeatmapSetInfo>
 
-        public Action<IEnumerable<ILive<BeatmapSetInfo>>>? PostImport
+        public Action<IEnumerable<Live<BeatmapSetInfo>>>? PostImport
         {
             set => beatmapModelManager.PostImport = value;
         }
diff --git a/osu.Game/Database/IModelImporter.cs b/osu.Game/Database/IModelImporter.cs
index 3047a1d30a..90df13477e 100644
--- a/osu.Game/Database/IModelImporter.cs
+++ b/osu.Game/Database/IModelImporter.cs
@@ -16,9 +16,9 @@ namespace osu.Game.Database
     /// </summary>
     /// <typeparam name="TModel">The model type.</typeparam>
     public interface IModelImporter<TModel> : IPostNotifications, IPostImports<TModel>, ICanAcceptFiles
-        where TModel : class
+        where TModel : class, IHasGuidPrimaryKey
     {
-        Task<IEnumerable<ILive<TModel>>> Import(ProgressNotification notification, params ImportTask[] tasks);
+        Task<IEnumerable<Live<TModel>>> Import(ProgressNotification notification, params ImportTask[] tasks);
 
         /// <summary>
         /// Import one <typeparamref name="TModel"/> from the filesystem and delete the file on success.
@@ -28,7 +28,7 @@ namespace osu.Game.Database
         /// <param name="lowPriority">Whether this is a low priority import.</param>
         /// <param name="cancellationToken">An optional cancellation token.</param>
         /// <returns>The imported model, if successful.</returns>
-        Task<ILive<TModel>?> Import(ImportTask task, bool lowPriority = false, CancellationToken cancellationToken = default);
+        Task<Live<TModel>?> Import(ImportTask task, bool lowPriority = false, CancellationToken cancellationToken = default);
 
         /// <summary>
         /// Silently import an item from an <see cref="ArchiveReader"/>.
@@ -36,7 +36,7 @@ namespace osu.Game.Database
         /// <param name="archive">The archive to be imported.</param>
         /// <param name="lowPriority">Whether this is a low priority import.</param>
         /// <param name="cancellationToken">An optional cancellation token.</param>
-        Task<ILive<TModel>?> Import(ArchiveReader archive, bool lowPriority = false, CancellationToken cancellationToken = default);
+        Task<Live<TModel>?> Import(ArchiveReader archive, bool lowPriority = false, CancellationToken cancellationToken = default);
 
         /// <summary>
         /// Silently import an item from a <typeparamref name="TModel"/>.
@@ -45,7 +45,7 @@ namespace osu.Game.Database
         /// <param name="archive">An optional archive to use for model population.</param>
         /// <param name="lowPriority">Whether this is a low priority import.</param>
         /// <param name="cancellationToken">An optional cancellation token.</param>
-        ILive<TModel>? Import(TModel item, ArchiveReader? archive = null, bool lowPriority = false, CancellationToken cancellationToken = default);
+        Live<TModel>? Import(TModel item, ArchiveReader? archive = null, bool lowPriority = false, CancellationToken cancellationToken = default);
 
         /// <summary>
         /// A user displayable name for the model type associated with this manager.
diff --git a/osu.Game/Database/IPostImports.cs b/osu.Game/Database/IPostImports.cs
index adb3a7108d..6f047098da 100644
--- a/osu.Game/Database/IPostImports.cs
+++ b/osu.Game/Database/IPostImports.cs
@@ -9,11 +9,11 @@ using System.Collections.Generic;
 namespace osu.Game.Database
 {
     public interface IPostImports<TModel>
-        where TModel : class
+        where TModel : class, IHasGuidPrimaryKey
     {
         /// <summary>
         /// Fired when the user requests to view the resulting import.
         /// </summary>
-        public Action<IEnumerable<ILive<TModel>>>? PostImport { set; }
+        public Action<IEnumerable<Live<TModel>>>? PostImport { set; }
     }
 }
diff --git a/osu.Game/Database/LegacyModelImporter.cs b/osu.Game/Database/LegacyModelImporter.cs
index dacb7327ea..d85fb5aab2 100644
--- a/osu.Game/Database/LegacyModelImporter.cs
+++ b/osu.Game/Database/LegacyModelImporter.cs
@@ -14,7 +14,7 @@ namespace osu.Game.Database
     /// A class which handles importing legacy user data of a single type from osu-stable.
     /// </summary>
     public abstract class LegacyModelImporter<TModel>
-        where TModel : class
+        where TModel : class, IHasGuidPrimaryKey
     {
         /// <summary>
         /// The relative path from osu-stable's data directory to import items from.
diff --git a/osu.Game/Database/ILive.cs b/osu.Game/Database/Live.cs
similarity index 65%
rename from osu.Game/Database/ILive.cs
rename to osu.Game/Database/Live.cs
index 3011754bc1..6256902e17 100644
--- a/osu.Game/Database/ILive.cs
+++ b/osu.Game/Database/Live.cs
@@ -3,39 +3,41 @@
 
 using System;
 
+#nullable enable
+
 namespace osu.Game.Database
 {
     /// <summary>
     /// A wrapper to provide access to database backed classes in a thread-safe manner.
     /// </summary>
     /// <typeparam name="T">The databased type.</typeparam>
-    public interface ILive<T> : IEquatable<ILive<T>>
-        where T : class // TODO: Add IHasGuidPrimaryKey once we don't need EF support any more.
+    public abstract class Live<T> : IEquatable<Live<T>>
+        where T : class, IHasGuidPrimaryKey
     {
-        Guid ID { get; }
+        public Guid ID { get; }
 
         /// <summary>
         /// Perform a read operation on this live object.
         /// </summary>
         /// <param name="perform">The action to perform.</param>
-        void PerformRead(Action<T> perform);
+        public abstract void PerformRead(Action<T> perform);
 
         /// <summary>
         /// Perform a read operation on this live object.
         /// </summary>
         /// <param name="perform">The action to perform.</param>
-        TReturn PerformRead<TReturn>(Func<T, TReturn> perform);
+        public abstract TReturn PerformRead<TReturn>(Func<T, TReturn> perform);
 
         /// <summary>
         /// Perform a write operation on this live object.
         /// </summary>
         /// <param name="perform">The action to perform.</param>
-        void PerformWrite(Action<T> perform);
+        public abstract void PerformWrite(Action<T> perform);
 
         /// <summary>
         /// Whether this instance is tracking data which is managed by the database backing.
         /// </summary>
-        bool IsManaged { get; }
+        public abstract bool IsManaged { get; }
 
         /// <summary>
         /// Resolve the value of this instance on the update thread.
@@ -43,6 +45,15 @@ namespace osu.Game.Database
         /// <remarks>
         /// After resolving, the data should not be passed between threads.
         /// </remarks>
-        T Value { get; }
+        public abstract T Value { get; }
+
+        protected Live(Guid id)
+        {
+            ID = id;
+        }
+
+        public bool Equals(Live<T>? other) => ID == other?.ID;
+
+        public override string ToString() => PerformRead(i => i.ToString());
     }
 }
diff --git a/osu.Game/Database/RealmLive.cs b/osu.Game/Database/RealmLive.cs
index 13b9bc2704..186e801425 100644
--- a/osu.Game/Database/RealmLive.cs
+++ b/osu.Game/Database/RealmLive.cs
@@ -15,11 +15,9 @@ namespace osu.Game.Database
     /// Provides a method of working with realm objects over longer application lifetimes.
     /// </summary>
     /// <typeparam name="T">The underlying object type.</typeparam>
-    public class RealmLive<T> : ILive<T> where T : RealmObject, IHasGuidPrimaryKey
+    public class RealmLive<T> : Live<T> where T : RealmObject, IHasGuidPrimaryKey
     {
-        public Guid ID { get; }
-
-        public bool IsManaged => data.IsManaged;
+        public override bool IsManaged => data.IsManaged;
 
         /// <summary>
         /// The original live data used to create this instance.
@@ -36,11 +34,11 @@ namespace osu.Game.Database
         /// <param name="data">The realm data.</param>
         /// <param name="realm">The realm factory the data was sourced from. May be null for an unmanaged object.</param>
         public RealmLive(T data, RealmAccess realm)
+            : base(data.ID)
         {
             this.data = data;
             this.realm = realm;
 
-            ID = data.ID;
             dataIsFromUpdateThread = ThreadSafety.IsUpdateThread;
         }
 
@@ -48,7 +46,7 @@ namespace osu.Game.Database
         /// Perform a read operation on this live object.
         /// </summary>
         /// <param name="perform">The action to perform.</param>
-        public void PerformRead(Action<T> perform)
+        public override void PerformRead(Action<T> perform)
         {
             if (!IsManaged)
             {
@@ -74,7 +72,7 @@ namespace osu.Game.Database
         /// Perform a read operation on this live object.
         /// </summary>
         /// <param name="perform">The action to perform.</param>
-        public TReturn PerformRead<TReturn>(Func<T, TReturn> perform)
+        public override TReturn PerformRead<TReturn>(Func<T, TReturn> perform)
         {
             if (!IsManaged)
                 return perform(data);
@@ -101,7 +99,7 @@ namespace osu.Game.Database
         /// Perform a write operation on this live object.
         /// </summary>
         /// <param name="perform">The action to perform.</param>
-        public void PerformWrite(Action<T> perform)
+        public override void PerformWrite(Action<T> perform)
         {
             if (!IsManaged)
                 throw new InvalidOperationException(@"Can't perform writes on a non-managed underlying value");
@@ -115,7 +113,7 @@ namespace osu.Game.Database
             });
         }
 
-        public T Value
+        public override T Value
         {
             get
             {
@@ -160,10 +158,6 @@ namespace osu.Game.Database
 
             return found;
         }
-
-        public bool Equals(ILive<T>? other) => ID == other?.ID;
-
-        public override string ToString() => PerformRead(i => i.ToString());
     }
 
     internal static class RealmLiveStatistics
diff --git a/osu.Game/Database/RealmLiveUnmanaged.cs b/osu.Game/Database/RealmLiveUnmanaged.cs
index 97f2faa656..1080f3b8c7 100644
--- a/osu.Game/Database/RealmLiveUnmanaged.cs
+++ b/osu.Game/Database/RealmLiveUnmanaged.cs
@@ -13,13 +13,19 @@ namespace osu.Game.Database
     /// Usually used for testing purposes where the instance is never required to be managed.
     /// </summary>
     /// <typeparam name="T">The underlying object type.</typeparam>
-    public class RealmLiveUnmanaged<T> : ILive<T> where T : RealmObjectBase, IHasGuidPrimaryKey
+    public class RealmLiveUnmanaged<T> : Live<T> where T : RealmObjectBase, IHasGuidPrimaryKey
     {
+        /// <summary>
+        /// The original live data used to create this instance.
+        /// </summary>
+        public override T Value { get; }
+
         /// <summary>
         /// Construct a new instance of live realm data.
         /// </summary>
         /// <param name="data">The realm data.</param>
         public RealmLiveUnmanaged(T data)
+            : base(data.ID)
         {
             if (data.IsManaged)
                 throw new InvalidOperationException($"Cannot use {nameof(RealmLiveUnmanaged<T>)} with managed instances");
@@ -27,23 +33,12 @@ namespace osu.Game.Database
             Value = data;
         }
 
-        public bool Equals(ILive<T>? other) => ID == other?.ID;
+        public override void PerformRead(Action<T> perform) => perform(Value);
 
-        public override string ToString() => Value.ToString();
+        public override TReturn PerformRead<TReturn>(Func<T, TReturn> perform) => perform(Value);
 
-        public Guid ID => Value.ID;
+        public override void PerformWrite(Action<T> perform) => throw new InvalidOperationException(@"Can't perform writes on a non-managed underlying value");
 
-        public void PerformRead(Action<T> perform) => perform(Value);
-
-        public TReturn PerformRead<TReturn>(Func<T, TReturn> perform) => perform(Value);
-
-        public void PerformWrite(Action<T> perform) => throw new InvalidOperationException(@"Can't perform writes on a non-managed underlying value");
-
-        public bool IsManaged => false;
-
-        /// <summary>
-        /// The original live data used to create this instance.
-        /// </summary>
-        public T Value { get; }
+        public override bool IsManaged => false;
     }
 }
diff --git a/osu.Game/Database/RealmObjectExtensions.cs b/osu.Game/Database/RealmObjectExtensions.cs
index d4f8978ac5..dba8633f53 100644
--- a/osu.Game/Database/RealmObjectExtensions.cs
+++ b/osu.Game/Database/RealmObjectExtensions.cs
@@ -204,25 +204,25 @@ namespace osu.Game.Database
         private static void copyChangesToRealm<T>(T source, T destination) where T : RealmObjectBase
             => write_mapper.Map(source, destination);
 
-        public static List<ILive<T>> ToLiveUnmanaged<T>(this IEnumerable<T> realmList)
+        public static List<Live<T>> ToLiveUnmanaged<T>(this IEnumerable<T> realmList)
             where T : RealmObject, IHasGuidPrimaryKey
         {
-            return realmList.Select(l => new RealmLiveUnmanaged<T>(l)).Cast<ILive<T>>().ToList();
+            return realmList.Select(l => new RealmLiveUnmanaged<T>(l)).Cast<Live<T>>().ToList();
         }
 
-        public static ILive<T> ToLiveUnmanaged<T>(this T realmObject)
+        public static Live<T> ToLiveUnmanaged<T>(this T realmObject)
             where T : RealmObject, IHasGuidPrimaryKey
         {
             return new RealmLiveUnmanaged<T>(realmObject);
         }
 
-        public static List<ILive<T>> ToLive<T>(this IEnumerable<T> realmList, RealmAccess realm)
+        public static List<Live<T>> ToLive<T>(this IEnumerable<T> realmList, RealmAccess realm)
             where T : RealmObject, IHasGuidPrimaryKey
         {
-            return realmList.Select(l => new RealmLive<T>(l, realm)).Cast<ILive<T>>().ToList();
+            return realmList.Select(l => new RealmLive<T>(l, realm)).Cast<Live<T>>().ToList();
         }
 
-        public static ILive<T> ToLive<T>(this T realmObject, RealmAccess realm)
+        public static Live<T> ToLive<T>(this T realmObject, RealmAccess realm)
             where T : RealmObject, IHasGuidPrimaryKey
         {
             return new RealmLive<T>(realmObject, realm);
diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index 5b3abc54d3..c2e1b25d94 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -249,7 +249,7 @@ namespace osu.Game
             SkinManager.CurrentSkinInfo.ValueChanged += skin => configSkin.Value = skin.NewValue.ID.ToString();
             configSkin.ValueChanged += skinId =>
             {
-                ILive<SkinInfo> skinInfo = null;
+                Live<SkinInfo> skinInfo = null;
 
                 if (Guid.TryParse(skinId.NewValue, out var guid))
                     skinInfo = SkinManager.Query(s => s.ID == guid);
@@ -439,7 +439,7 @@ namespace osu.Game
         /// </remarks>
         public void PresentBeatmap(IBeatmapSetInfo beatmap, Predicate<BeatmapInfo> difficultyCriteria = null)
         {
-            ILive<BeatmapSetInfo> databasedSet = null;
+            Live<BeatmapSetInfo> databasedSet = null;
 
             if (beatmap.OnlineID > 0)
                 databasedSet = BeatmapManager.QueryBeatmapSet(s => s.OnlineID == beatmap.OnlineID);
diff --git a/osu.Game/Overlays/Settings/Sections/SkinSection.cs b/osu.Game/Overlays/Settings/Sections/SkinSection.cs
index 8ab296c0a8..0846c023c1 100644
--- a/osu.Game/Overlays/Settings/Sections/SkinSection.cs
+++ b/osu.Game/Overlays/Settings/Sections/SkinSection.cs
@@ -32,16 +32,16 @@ namespace osu.Game.Overlays.Settings.Sections
             Icon = FontAwesome.Solid.PaintBrush
         };
 
-        private readonly Bindable<ILive<SkinInfo>> dropdownBindable = new Bindable<ILive<SkinInfo>> { Default = DefaultSkin.CreateInfo().ToLiveUnmanaged() };
+        private readonly Bindable<Live<SkinInfo>> dropdownBindable = new Bindable<Live<SkinInfo>> { Default = DefaultSkin.CreateInfo().ToLiveUnmanaged() };
         private readonly Bindable<string> configBindable = new Bindable<string>();
 
-        private static readonly ILive<SkinInfo> random_skin_info = new SkinInfo
+        private static readonly Live<SkinInfo> random_skin_info = new SkinInfo
         {
             ID = SkinInfo.RANDOM_SKIN,
             Name = "<Random Skin>",
         }.ToLiveUnmanaged();
 
-        private List<ILive<SkinInfo>> skinItems;
+        private List<Live<SkinInfo>> skinItems;
 
         [Resolved]
         private SkinManager skins { get; set; }
@@ -118,7 +118,7 @@ namespace osu.Game.Overlays.Settings.Sections
 
         private void updateSelectedSkinFromConfig()
         {
-            ILive<SkinInfo> skin = null;
+            Live<SkinInfo> skin = null;
 
             if (Guid.TryParse(configBindable.Value, out var configId))
                 skin = skinDropdown.Items.FirstOrDefault(s => s.ID == configId);
@@ -144,13 +144,13 @@ namespace osu.Game.Overlays.Settings.Sections
             realmSubscription?.Dispose();
         }
 
-        private class SkinSettingsDropdown : SettingsDropdown<ILive<SkinInfo>>
+        private class SkinSettingsDropdown : SettingsDropdown<Live<SkinInfo>>
         {
-            protected override OsuDropdown<ILive<SkinInfo>> CreateDropdown() => new SkinDropdownControl();
+            protected override OsuDropdown<Live<SkinInfo>> CreateDropdown() => new SkinDropdownControl();
 
             private class SkinDropdownControl : DropdownControl
             {
-                protected override LocalisableString GenerateItemText(ILive<SkinInfo> item) => item.ToString();
+                protected override LocalisableString GenerateItemText(Live<SkinInfo> item) => item.ToString();
             }
         }
 
diff --git a/osu.Game/Scoring/ScoreManager.cs b/osu.Game/Scoring/ScoreManager.cs
index 3a842a048a..8f665224ee 100644
--- a/osu.Game/Scoring/ScoreManager.cs
+++ b/osu.Game/Scoring/ScoreManager.cs
@@ -293,22 +293,22 @@ namespace osu.Game.Scoring
 
         public IEnumerable<string> HandledExtensions => scoreModelManager.HandledExtensions;
 
-        public Task<IEnumerable<ILive<ScoreInfo>>> Import(ProgressNotification notification, params ImportTask[] tasks)
+        public Task<IEnumerable<Live<ScoreInfo>>> Import(ProgressNotification notification, params ImportTask[] tasks)
         {
             return scoreModelManager.Import(notification, tasks);
         }
 
-        public Task<ILive<ScoreInfo>> Import(ImportTask task, bool lowPriority = false, CancellationToken cancellationToken = default)
+        public Task<Live<ScoreInfo>> Import(ImportTask task, bool lowPriority = false, CancellationToken cancellationToken = default)
         {
             return scoreModelManager.Import(task, lowPriority, cancellationToken);
         }
 
-        public Task<ILive<ScoreInfo>> Import(ArchiveReader archive, bool lowPriority = false, CancellationToken cancellationToken = default)
+        public Task<Live<ScoreInfo>> Import(ArchiveReader archive, bool lowPriority = false, CancellationToken cancellationToken = default)
         {
             return scoreModelManager.Import(archive, lowPriority, cancellationToken);
         }
 
-        public ILive<ScoreInfo> Import(ScoreInfo item, ArchiveReader archive = null, bool lowPriority = false, CancellationToken cancellationToken = default)
+        public Live<ScoreInfo> Import(ScoreInfo item, ArchiveReader archive = null, bool lowPriority = false, CancellationToken cancellationToken = default)
         {
             return scoreModelManager.Import(item, archive, lowPriority, cancellationToken);
         }
@@ -322,7 +322,7 @@ namespace osu.Game.Scoring
 
         #region Implementation of IPresentImports<ScoreInfo>
 
-        public Action<IEnumerable<ILive<ScoreInfo>>> PostImport
+        public Action<IEnumerable<Live<ScoreInfo>>> PostImport
         {
             set => scoreModelManager.PostImport = value;
         }
diff --git a/osu.Game/Skinning/Skin.cs b/osu.Game/Skinning/Skin.cs
index 3685a26e26..931bdfed48 100644
--- a/osu.Game/Skinning/Skin.cs
+++ b/osu.Game/Skinning/Skin.cs
@@ -24,7 +24,7 @@ namespace osu.Game.Skinning
 {
     public abstract class Skin : IDisposable, ISkin
     {
-        public readonly ILive<SkinInfo> SkinInfo;
+        public readonly Live<SkinInfo> SkinInfo;
         private readonly IStorageResourceProvider resources;
 
         public SkinConfiguration Configuration { get; set; }
diff --git a/osu.Game/Skinning/SkinManager.cs b/osu.Game/Skinning/SkinManager.cs
index 47c7bc060a..06bd0abc9f 100644
--- a/osu.Game/Skinning/SkinManager.cs
+++ b/osu.Game/Skinning/SkinManager.cs
@@ -47,7 +47,7 @@ namespace osu.Game.Skinning
 
         public readonly Bindable<Skin> CurrentSkin = new Bindable<Skin>();
 
-        public readonly Bindable<ILive<SkinInfo>> CurrentSkinInfo = new Bindable<ILive<SkinInfo>>(Skinning.DefaultSkin.CreateInfo().ToLiveUnmanaged())
+        public readonly Bindable<Live<SkinInfo>> CurrentSkinInfo = new Bindable<Live<SkinInfo>>(Skinning.DefaultSkin.CreateInfo().ToLiveUnmanaged())
         {
             Default = Skinning.DefaultSkin.CreateInfo().ToLiveUnmanaged()
         };
@@ -176,7 +176,7 @@ namespace osu.Game.Skinning
         /// </summary>
         /// <param name="query">The query.</param>
         /// <returns>The first result for the provided query, or null if no results were found.</returns>
-        public ILive<SkinInfo> Query(Expression<Func<SkinInfo, bool>> query)
+        public Live<SkinInfo> Query(Expression<Func<SkinInfo, bool>> query)
         {
             return realm.Run(r => r.All<SkinInfo>().FirstOrDefault(query)?.ToLive(realm));
         }
@@ -245,7 +245,7 @@ namespace osu.Game.Skinning
             set => skinModelManager.PostNotification = value;
         }
 
-        public Action<IEnumerable<ILive<SkinInfo>>> PostImport
+        public Action<IEnumerable<Live<SkinInfo>>> PostImport
         {
             set => skinModelManager.PostImport = value;
         }
@@ -262,22 +262,22 @@ namespace osu.Game.Skinning
 
         public IEnumerable<string> HandledExtensions => skinModelManager.HandledExtensions;
 
-        public Task<IEnumerable<ILive<SkinInfo>>> Import(ProgressNotification notification, params ImportTask[] tasks)
+        public Task<IEnumerable<Live<SkinInfo>>> Import(ProgressNotification notification, params ImportTask[] tasks)
         {
             return skinModelManager.Import(notification, tasks);
         }
 
-        public Task<ILive<SkinInfo>> Import(ImportTask task, bool lowPriority = false, CancellationToken cancellationToken = default)
+        public Task<Live<SkinInfo>> Import(ImportTask task, bool lowPriority = false, CancellationToken cancellationToken = default)
         {
             return skinModelManager.Import(task, lowPriority, cancellationToken);
         }
 
-        public Task<ILive<SkinInfo>> Import(ArchiveReader archive, bool lowPriority = false, CancellationToken cancellationToken = default)
+        public Task<Live<SkinInfo>> Import(ArchiveReader archive, bool lowPriority = false, CancellationToken cancellationToken = default)
         {
             return skinModelManager.Import(archive, lowPriority, cancellationToken);
         }
 
-        public ILive<SkinInfo> Import(SkinInfo item, ArchiveReader archive = null, bool lowPriority = false, CancellationToken cancellationToken = default)
+        public Live<SkinInfo> Import(SkinInfo item, ArchiveReader archive = null, bool lowPriority = false, CancellationToken cancellationToken = default)
         {
             return skinModelManager.Import(item, archive, lowPriority, cancellationToken);
         }
diff --git a/osu.Game/Stores/RealmArchiveModelImporter.cs b/osu.Game/Stores/RealmArchiveModelImporter.cs
index 43c1c7c888..3011bc0320 100644
--- a/osu.Game/Stores/RealmArchiveModelImporter.cs
+++ b/osu.Game/Stores/RealmArchiveModelImporter.cs
@@ -64,7 +64,7 @@ namespace osu.Game.Stores
         /// <summary>
         /// Fired when the user requests to view the resulting import.
         /// </summary>
-        public Action<IEnumerable<ILive<TModel>>>? PostImport { get; set; }
+        public Action<IEnumerable<Live<TModel>>>? PostImport { get; set; }
 
         /// <summary>
         /// Set an endpoint for notifications to be posted to.
@@ -104,7 +104,7 @@ namespace osu.Game.Stores
             return Import(notification, tasks);
         }
 
-        public async Task<IEnumerable<ILive<TModel>>> Import(ProgressNotification notification, params ImportTask[] tasks)
+        public async Task<IEnumerable<Live<TModel>>> Import(ProgressNotification notification, params ImportTask[] tasks)
         {
             if (tasks.Length == 0)
             {
@@ -118,7 +118,7 @@ namespace osu.Game.Stores
 
             int current = 0;
 
-            var imported = new List<ILive<TModel>>();
+            var imported = new List<Live<TModel>>();
 
             bool isLowPriorityImport = tasks.Length > low_priority_import_batch_size;
 
@@ -196,11 +196,11 @@ namespace osu.Game.Stores
         /// <param name="lowPriority">Whether this is a low priority import.</param>
         /// <param name="cancellationToken">An optional cancellation token.</param>
         /// <returns>The imported model, if successful.</returns>
-        public async Task<ILive<TModel>?> Import(ImportTask task, bool lowPriority = false, CancellationToken cancellationToken = default)
+        public async Task<Live<TModel>?> Import(ImportTask task, bool lowPriority = false, CancellationToken cancellationToken = default)
         {
             cancellationToken.ThrowIfCancellationRequested();
 
-            ILive<TModel>? import;
+            Live<TModel>? import;
             using (ArchiveReader reader = task.GetReader())
                 import = await Import(reader, lowPriority, cancellationToken).ConfigureAwait(false);
 
@@ -227,7 +227,7 @@ namespace osu.Game.Stores
         /// <param name="archive">The archive to be imported.</param>
         /// <param name="lowPriority">Whether this is a low priority import.</param>
         /// <param name="cancellationToken">An optional cancellation token.</param>
-        public async Task<ILive<TModel>?> Import(ArchiveReader archive, bool lowPriority = false, CancellationToken cancellationToken = default)
+        public async Task<Live<TModel>?> Import(ArchiveReader archive, bool lowPriority = false, CancellationToken cancellationToken = default)
         {
             cancellationToken.ThrowIfCancellationRequested();
 
@@ -320,7 +320,7 @@ namespace osu.Game.Stores
         /// <param name="archive">An optional archive to use for model population.</param>
         /// <param name="lowPriority">Whether this is a low priority import.</param>
         /// <param name="cancellationToken">An optional cancellation token.</param>
-        public virtual ILive<TModel>? Import(TModel item, ArchiveReader? archive = null, bool lowPriority = false, CancellationToken cancellationToken = default)
+        public virtual Live<TModel>? Import(TModel item, ArchiveReader? archive = null, bool lowPriority = false, CancellationToken cancellationToken = default)
         {
             return Realm.Run(realm =>
             {
@@ -416,7 +416,7 @@ namespace osu.Game.Stores
                     throw;
                 }
 
-                return (ILive<TModel>?)item.ToLive(Realm);
+                return (Live<TModel>?)item.ToLive(Realm);
             });
         }
 

From 064468faada4ba6af341296f634978e774bcec03 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Tue, 25 Jan 2022 11:31:05 +0300
Subject: [PATCH 2507/5547] Refactor editor saving test scene for scalability

---
 .../Visual/Editing/TestSceneEditorSaving.cs   | 152 ++++++++++--------
 osu.Game/Beatmaps/BeatmapInfo.cs              |   2 +-
 .../Tests/Visual/EditorSavingTestScene.cs     |  67 ++++++++
 3 files changed, 154 insertions(+), 67 deletions(-)
 create mode 100644 osu.Game/Tests/Visual/EditorSavingTestScene.cs

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneEditorSaving.cs b/osu.Game.Tests/Visual/Editing/TestSceneEditorSaving.cs
index 96f815621c..58daab1ce2 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneEditorSaving.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneEditorSaving.cs
@@ -4,97 +4,117 @@
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
-using osu.Framework.Input;
 using osu.Framework.Testing;
+using osu.Framework.Utils;
 using osu.Game.Beatmaps.ControlPoints;
-using osu.Game.Rulesets.Edit;
 using osu.Game.Screens.Edit;
-using osu.Game.Screens.Edit.Setup;
-using osu.Game.Screens.Menu;
-using osu.Game.Screens.Select;
+using osu.Game.Screens.Edit.Compose.Components.Timeline;
 using osuTK.Input;
 
 namespace osu.Game.Tests.Visual.Editing
 {
-    public class TestSceneEditorSaving : OsuGameTestScene
+    public class TestSceneEditorSaving : EditorSavingTestScene
     {
-        private Editor editor => Game.ChildrenOfType<Editor>().FirstOrDefault();
-
-        private EditorBeatmap editorBeatmap => (EditorBeatmap)editor.Dependencies.Get(typeof(EditorBeatmap));
-
-        /// <summary>
-        /// Tests the general expected flow of creating a new beatmap, saving it, then loading it back from song select.
-        /// </summary>
         [Test]
-        public void TestNewBeatmapSaveThenLoad()
+        public void TestMetadata()
         {
-            AddStep("set default beatmap", () => Game.Beatmap.SetDefault());
-
-            PushAndConfirm(() => new EditorLoader());
-
-            AddUntilStep("wait for editor load", () => editor?.IsLoaded == true);
-
-            AddUntilStep("wait for metadata screen load", () => editor.ChildrenOfType<MetadataSection>().FirstOrDefault()?.IsLoaded == true);
-
-            // We intentionally switch away from the metadata screen, else there is a feedback loop with the textbox handling which causes metadata changes below to get overwritten.
-
-            AddStep("Enter compose mode", () => InputManager.Key(Key.F1));
-            AddUntilStep("Wait for compose mode load", () => editor.ChildrenOfType<HitObjectComposer>().FirstOrDefault()?.IsLoaded == true);
-
-            AddStep("Set beat divisor", () => editor.Dependencies.Get<BindableBeatDivisor>().Value = 16);
-            AddStep("Set overall difficulty", () => editorBeatmap.Difficulty.OverallDifficulty = 7);
             AddStep("Set artist and title", () =>
             {
-                editorBeatmap.BeatmapInfo.Metadata.Artist = "artist";
-                editorBeatmap.BeatmapInfo.Metadata.Title = "title";
+                EditorBeatmap.BeatmapInfo.Metadata.Artist = "artist";
+                EditorBeatmap.BeatmapInfo.Metadata.Title = "title";
             });
-            AddStep("Set author", () => editorBeatmap.BeatmapInfo.Metadata.Author.Username = "author");
-            AddStep("Set difficulty name", () => editorBeatmap.BeatmapInfo.DifficultyName = "difficulty");
+            AddStep("Set author", () => EditorBeatmap.BeatmapInfo.Metadata.Author.Username = "author");
+            AddStep("Set difficulty name", () => EditorBeatmap.BeatmapInfo.DifficultyName = "difficulty");
 
-            AddStep("Add timing point", () => editorBeatmap.ControlPointInfo.Add(0, new TimingControlPoint()));
+            SaveEditor();
 
+            AddAssert("Beatmap has correct metadata", () => EditorBeatmap.BeatmapInfo.Metadata.Artist == "artist" && EditorBeatmap.BeatmapInfo.Metadata.Title == "title");
+            AddAssert("Beatmap has correct author", () => EditorBeatmap.BeatmapInfo.Metadata.Author.Username == "author");
+            AddAssert("Beatmap has correct difficulty name", () => EditorBeatmap.BeatmapInfo.DifficultyName == "difficulty");
+            AddAssert("Beatmap has correct .osu file path", () => EditorBeatmap.BeatmapInfo.Path == "artist - title (author) [difficulty].osu");
+
+            ReloadEditorToSameBeatmap();
+
+            AddAssert("Beatmap still has correct metadata", () => EditorBeatmap.BeatmapInfo.Metadata.Artist == "artist" && EditorBeatmap.BeatmapInfo.Metadata.Title == "title");
+            AddAssert("Beatmap still has correct author", () => EditorBeatmap.BeatmapInfo.Metadata.Author.Username == "author");
+            AddAssert("Beatmap still has correct difficulty name", () => EditorBeatmap.BeatmapInfo.DifficultyName == "difficulty");
+            AddAssert("Beatmap still has correct .osu file path", () => EditorBeatmap.BeatmapInfo.Path == "artist - title (author) [difficulty].osu");
+        }
+
+        [Test]
+        public void TestConfiguration()
+        {
+            double originalTimelineZoom = 0;
+            double changedTimelineZoom = 0;
+
+            AddStep("Set beat divisor", () => Editor.Dependencies.Get<BindableBeatDivisor>().Value = 16);
+            AddStep("Set timeline zoom", () =>
+            {
+                originalTimelineZoom = EditorBeatmap.BeatmapInfo.TimelineZoom;
+
+                var timeline = Editor.ChildrenOfType<Timeline>().Single();
+                InputManager.MoveMouseTo(timeline);
+                InputManager.PressKey(Key.AltLeft);
+                InputManager.ScrollVerticalBy(15f);
+                InputManager.ReleaseKey(Key.AltLeft);
+            });
+
+            AddAssert("Ensure timeline zoom changed", () =>
+            {
+                changedTimelineZoom = EditorBeatmap.BeatmapInfo.TimelineZoom;
+                return !Precision.AlmostEquals(changedTimelineZoom, originalTimelineZoom);
+            });
+
+            SaveEditor();
+
+            AddAssert("Beatmap has correct beat divisor", () => EditorBeatmap.BeatmapInfo.BeatDivisor == 16);
+            AddAssert("Beatmap has correct timeline zoom", () => EditorBeatmap.BeatmapInfo.TimelineZoom == changedTimelineZoom);
+
+            ReloadEditorToSameBeatmap();
+
+            AddAssert("Beatmap still has correct beat divisor", () => EditorBeatmap.BeatmapInfo.BeatDivisor == 16);
+            AddAssert("Beatmap still has correct timeline zoom", () => EditorBeatmap.BeatmapInfo.TimelineZoom == changedTimelineZoom);
+        }
+
+        [Test]
+        public void TestDifficulty()
+        {
+            AddStep("Set overall difficulty", () => EditorBeatmap.Difficulty.OverallDifficulty = 7);
+
+            SaveEditor();
+
+            AddAssert("Beatmap has correct overall difficulty", () => EditorBeatmap.Difficulty.OverallDifficulty == 7);
+
+            ReloadEditorToSameBeatmap();
+
+            AddAssert("Beatmap still has correct overall difficulty", () => EditorBeatmap.Difficulty.OverallDifficulty == 7);
+        }
+
+        [Test]
+        public void TestHitObjectPlacement()
+        {
+            AddStep("Add timing point", () => EditorBeatmap.ControlPointInfo.Add(500, new TimingControlPoint()));
             AddStep("Change to placement mode", () => InputManager.Key(Key.Number2));
             AddStep("Move to playfield", () => InputManager.MoveMouseTo(Game.ScreenSpaceDrawQuad.Centre));
             AddStep("Place single hitcircle", () => InputManager.Click(MouseButton.Left));
 
-            checkMutations();
+            SaveEditor();
+
+            AddAssert("Beatmap has correct timing point", () => EditorBeatmap.ControlPointInfo.TimingPoints.Single().Time == 500);
 
             // After placement these must be non-default as defaults are read-only.
             AddAssert("Placed object has non-default control points", () =>
-                editorBeatmap.HitObjects[0].SampleControlPoint != SampleControlPoint.DEFAULT &&
-                editorBeatmap.HitObjects[0].DifficultyControlPoint != DifficultyControlPoint.DEFAULT);
+                EditorBeatmap.HitObjects[0].SampleControlPoint != SampleControlPoint.DEFAULT &&
+                EditorBeatmap.HitObjects[0].DifficultyControlPoint != DifficultyControlPoint.DEFAULT);
 
-            AddStep("Save", () => InputManager.Keys(PlatformAction.Save));
+            ReloadEditorToSameBeatmap();
 
-            checkMutations();
-            AddAssert("Beatmap has correct .osu file path", () => editorBeatmap.BeatmapInfo.Path == "artist - title (author) [difficulty].osu");
+            AddAssert("Beatmap still has correct timing point", () => EditorBeatmap.ControlPointInfo.TimingPoints.Single().Time == 500);
 
-            AddStep("Exit", () => InputManager.Key(Key.Escape));
-
-            AddUntilStep("Wait for main menu", () => Game.ScreenStack.CurrentScreen is MainMenu);
-
-            Screens.Select.SongSelect songSelect = null;
-
-            PushAndConfirm(() => songSelect = new PlaySongSelect());
-            AddUntilStep("wait for carousel load", () => songSelect.BeatmapSetsLoaded);
-
-            AddUntilStep("Wait for beatmap selected", () => !Game.Beatmap.IsDefault);
-            AddStep("Open options", () => InputManager.Key(Key.F3));
-            AddStep("Enter editor", () => InputManager.Key(Key.Number5));
-
-            AddUntilStep("Wait for editor load", () => editor != null);
-
-            checkMutations();
-        }
-
-        private void checkMutations()
-        {
-            AddAssert("Beatmap contains single hitcircle", () => editorBeatmap.HitObjects.Count == 1);
-            AddAssert("Beatmap has correct beat divisor", () => editorBeatmap.BeatmapInfo.BeatDivisor == 16);
-            AddAssert("Beatmap has correct overall difficulty", () => editorBeatmap.Difficulty.OverallDifficulty == 7);
-            AddAssert("Beatmap has correct metadata", () => editorBeatmap.BeatmapInfo.Metadata.Artist == "artist" && editorBeatmap.BeatmapInfo.Metadata.Title == "title");
-            AddAssert("Beatmap has correct author", () => editorBeatmap.BeatmapInfo.Metadata.Author.Username == "author");
-            AddAssert("Beatmap has correct difficulty name", () => editorBeatmap.BeatmapInfo.DifficultyName == "difficulty");
+            // After placement these must be non-default as defaults are read-only.
+            AddAssert("Placed object still has non-default control points", () =>
+                EditorBeatmap.HitObjects[0].SampleControlPoint != SampleControlPoint.DEFAULT &&
+                EditorBeatmap.HitObjects[0].DifficultyControlPoint != DifficultyControlPoint.DEFAULT);
         }
     }
 }
diff --git a/osu.Game/Beatmaps/BeatmapInfo.cs b/osu.Game/Beatmaps/BeatmapInfo.cs
index 96254295a6..4e1a34ddbf 100644
--- a/osu.Game/Beatmaps/BeatmapInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapInfo.cs
@@ -111,7 +111,7 @@ namespace osu.Game.Beatmaps
 
         public int GridSize { get; set; }
 
-        public double TimelineZoom { get; set; }
+        public double TimelineZoom { get; set; } = 1.0;
 
         [Ignored]
         public CountdownType Countdown { get; set; } = CountdownType.Normal;
diff --git a/osu.Game/Tests/Visual/EditorSavingTestScene.cs b/osu.Game/Tests/Visual/EditorSavingTestScene.cs
new file mode 100644
index 0000000000..72b5d076a5
--- /dev/null
+++ b/osu.Game/Tests/Visual/EditorSavingTestScene.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 System.Linq;
+using osu.Framework.Input;
+using osu.Framework.Testing;
+using osu.Game.Rulesets.Edit;
+using osu.Game.Screens.Edit;
+using osu.Game.Screens.Edit.Setup;
+using osu.Game.Screens.Menu;
+using osu.Game.Screens.Select;
+using osuTK.Input;
+
+namespace osu.Game.Tests.Visual
+{
+    /// <summary>
+    /// Tests the general expected flow of creating a new beatmap, saving it, then loading it back from song select.
+    /// </summary>
+    public class EditorSavingTestScene : OsuGameTestScene
+    {
+        protected Editor Editor => Game.ChildrenOfType<Editor>().FirstOrDefault();
+
+        protected EditorBeatmap EditorBeatmap => (EditorBeatmap)Editor.Dependencies.Get(typeof(EditorBeatmap));
+
+        [SetUpSteps]
+        public override void SetUpSteps()
+        {
+            base.SetUpSteps();
+
+            AddStep("set default beatmap", () => Game.Beatmap.SetDefault());
+
+            PushAndConfirm(() => new EditorLoader());
+
+            AddUntilStep("wait for editor load", () => Editor?.IsLoaded == true);
+
+            AddUntilStep("wait for metadata screen load", () => Editor.ChildrenOfType<MetadataSection>().FirstOrDefault()?.IsLoaded == true);
+
+            // We intentionally switch away from the metadata screen, else there is a feedback loop with the textbox handling which causes metadata changes below to get overwritten.
+
+            AddStep("Enter compose mode", () => InputManager.Key(Key.F1));
+            AddUntilStep("Wait for compose mode load", () => Editor.ChildrenOfType<HitObjectComposer>().FirstOrDefault()?.IsLoaded == true);
+        }
+
+        protected void SaveEditor()
+        {
+            AddStep("Save", () => InputManager.Keys(PlatformAction.Save));
+        }
+
+        protected void ReloadEditorToSameBeatmap()
+        {
+            AddStep("Exit", () => InputManager.Key(Key.Escape));
+
+            AddUntilStep("Wait for main menu", () => Game.ScreenStack.CurrentScreen is MainMenu);
+
+            SongSelect songSelect = null;
+
+            PushAndConfirm(() => songSelect = new PlaySongSelect());
+            AddUntilStep("wait for carousel load", () => songSelect.BeatmapSetsLoaded);
+
+            AddUntilStep("Wait for beatmap selected", () => !Game.Beatmap.IsDefault);
+            AddStep("Open options", () => InputManager.Key(Key.F3));
+            AddStep("Enter editor", () => InputManager.Key(Key.Number5));
+
+            AddUntilStep("Wait for editor load", () => Editor != null);
+        }
+    }
+}

From de0a7d8501c5c3853755c49cf289a6be666c77a9 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Tue, 25 Jan 2022 12:29:41 +0300
Subject: [PATCH 2508/5547] Migrate taiko editor saving test scene to
 `EditorSavingTestScene`

---
 .../Editor/TestSceneEditorSaving.cs           | 91 -------------------
 .../Editor/TestSceneTaikoEditorSaving.cs      | 38 ++++++++
 2 files changed, 38 insertions(+), 91 deletions(-)
 delete mode 100644 osu.Game.Rulesets.Taiko.Tests/Editor/TestSceneEditorSaving.cs
 create mode 100644 osu.Game.Rulesets.Taiko.Tests/Editor/TestSceneTaikoEditorSaving.cs

diff --git a/osu.Game.Rulesets.Taiko.Tests/Editor/TestSceneEditorSaving.cs b/osu.Game.Rulesets.Taiko.Tests/Editor/TestSceneEditorSaving.cs
deleted file mode 100644
index 42ab84714a..0000000000
--- a/osu.Game.Rulesets.Taiko.Tests/Editor/TestSceneEditorSaving.cs
+++ /dev/null
@@ -1,91 +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.Linq;
-using NUnit.Framework;
-using osu.Framework.Input;
-using osu.Framework.Testing;
-using osu.Framework.Utils;
-using osu.Game.Beatmaps;
-using osu.Game.Rulesets.Edit;
-using osu.Game.Rulesets.Taiko.Beatmaps;
-using osu.Game.Screens.Edit;
-using osu.Game.Screens.Edit.Setup;
-using osu.Game.Screens.Menu;
-using osu.Game.Screens.Select;
-using osu.Game.Tests.Visual;
-using osuTK.Input;
-
-namespace osu.Game.Rulesets.Taiko.Tests.Editor
-{
-    public class TestSceneEditorSaving : OsuGameTestScene
-    {
-        private Screens.Edit.Editor editor => Game.ChildrenOfType<Screens.Edit.Editor>().FirstOrDefault();
-
-        private EditorBeatmap editorBeatmap => (EditorBeatmap)editor.Dependencies.Get(typeof(EditorBeatmap));
-
-        /// <summary>
-        /// Tests the general expected flow of creating a new beatmap, saving it, then loading it back from song select.
-        /// Emphasis is placed on <see cref="BeatmapDifficulty.SliderMultiplier"/>, since taiko has special handling for it to keep compatibility with stable.
-        /// </summary>
-        [Test]
-        public void TestNewBeatmapSaveThenLoad()
-        {
-            AddStep("set default beatmap", () => Game.Beatmap.SetDefault());
-            AddStep("set taiko ruleset", () => Ruleset.Value = new TaikoRuleset().RulesetInfo);
-
-            PushAndConfirm(() => new EditorLoader());
-
-            AddUntilStep("wait for editor load", () => editor?.IsLoaded == true);
-
-            AddUntilStep("wait for metadata screen load", () => editor.ChildrenOfType<MetadataSection>().FirstOrDefault()?.IsLoaded == true);
-
-            // We intentionally switch away from the metadata screen, else there is a feedback loop with the textbox handling which causes metadata changes below to get overwritten.
-
-            AddStep("Enter compose mode", () => InputManager.Key(Key.F1));
-            AddUntilStep("Wait for compose mode load", () => editor.ChildrenOfType<HitObjectComposer>().FirstOrDefault()?.IsLoaded == true);
-
-            AddStep("Set slider multiplier", () => editorBeatmap.Difficulty.SliderMultiplier = 2);
-            AddStep("Set artist and title", () =>
-            {
-                editorBeatmap.BeatmapInfo.Metadata.Artist = "artist";
-                editorBeatmap.BeatmapInfo.Metadata.Title = "title";
-            });
-            AddStep("Set difficulty name", () => editorBeatmap.BeatmapInfo.DifficultyName = "difficulty");
-
-            checkMutations();
-
-            AddStep("Save", () => InputManager.Keys(PlatformAction.Save));
-
-            checkMutations();
-
-            AddStep("Exit", () => InputManager.Key(Key.Escape));
-
-            AddUntilStep("Wait for main menu", () => Game.ScreenStack.CurrentScreen is MainMenu);
-
-            PushAndConfirm(() => new PlaySongSelect());
-
-            AddUntilStep("Wait for beatmap selected", () => !Game.Beatmap.IsDefault);
-            AddStep("Open options", () => InputManager.Key(Key.F3));
-            AddStep("Enter editor", () => InputManager.Key(Key.Number5));
-
-            AddUntilStep("Wait for editor load", () => editor != null);
-
-            checkMutations();
-        }
-
-        private void checkMutations()
-        {
-            AddAssert("Beatmap has correct slider multiplier", () =>
-            {
-                // we can only assert value correctness on TaikoMultiplierAppliedDifficulty, because that is the final difficulty converted taiko beatmaps use.
-                // therefore, ensure that we have that difficulty type by calling .CopyFrom(), which is a no-op if the type is already correct.
-                var taikoDifficulty = new TaikoBeatmapConverter.TaikoMultiplierAppliedDifficulty();
-                taikoDifficulty.CopyFrom(editorBeatmap.Difficulty);
-                return Precision.AlmostEquals(taikoDifficulty.SliderMultiplier, 2);
-            });
-            AddAssert("Beatmap has correct metadata", () => editorBeatmap.BeatmapInfo.Metadata.Artist == "artist" && editorBeatmap.BeatmapInfo.Metadata.Title == "title");
-            AddAssert("Beatmap has correct difficulty name", () => editorBeatmap.BeatmapInfo.DifficultyName == "difficulty");
-        }
-    }
-}
diff --git a/osu.Game.Rulesets.Taiko.Tests/Editor/TestSceneTaikoEditorSaving.cs b/osu.Game.Rulesets.Taiko.Tests/Editor/TestSceneTaikoEditorSaving.cs
new file mode 100644
index 0000000000..33c2ba532e
--- /dev/null
+++ b/osu.Game.Rulesets.Taiko.Tests/Editor/TestSceneTaikoEditorSaving.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 NUnit.Framework;
+using osu.Framework.Utils;
+using osu.Game.Rulesets.Taiko.Beatmaps;
+using osu.Game.Tests.Visual;
+
+namespace osu.Game.Rulesets.Taiko.Tests.Editor
+{
+    public class TestSceneTaikoEditorSaving : EditorSavingTestScene
+    {
+        protected override Ruleset CreateRuleset() => new TaikoRuleset();
+
+        [Test]
+        public void TestTaikoSliderMultiplier()
+        {
+            AddStep("Set slider multiplier", () => EditorBeatmap.Difficulty.SliderMultiplier = 2);
+
+            SaveEditor();
+
+            AddAssert("Beatmap has correct slider multiplier", assertTaikoSliderMulitplier);
+
+            ReloadEditorToSameBeatmap();
+
+            AddAssert("Beatmap still has correct slider multiplier", assertTaikoSliderMulitplier);
+
+            bool assertTaikoSliderMulitplier()
+            {
+                // we can only assert value correctness on TaikoMultiplierAppliedDifficulty, because that is the final difficulty converted taiko beatmaps use.
+                // therefore, ensure that we have that difficulty type by calling .CopyFrom(), which is a no-op if the type is already correct.
+                var taikoDifficulty = new TaikoBeatmapConverter.TaikoMultiplierAppliedDifficulty();
+                taikoDifficulty.CopyFrom(EditorBeatmap.Difficulty);
+                return Precision.AlmostEquals(taikoDifficulty.SliderMultiplier, 2);
+            }
+        }
+    }
+}

From 3491b77c8cc95ce752a25434e00f130227dad182 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 26 Jan 2022 14:25:55 +0900
Subject: [PATCH 2509/5547] Fix `ScoreInfo.RealmUser` not getting deep cloned
 correctly

I'm still not at all happy with the play-to-results flow (with multiple
clones), but this will have to do for now.
---
 osu.Game.Tests/NonVisual/ScoreInfoTest.cs | 4 ++++
 osu.Game/Scoring/ScoreInfo.cs             | 5 +++++
 2 files changed, 9 insertions(+)

diff --git a/osu.Game.Tests/NonVisual/ScoreInfoTest.cs b/osu.Game.Tests/NonVisual/ScoreInfoTest.cs
index e0acc6d8db..836c978ba2 100644
--- a/osu.Game.Tests/NonVisual/ScoreInfoTest.cs
+++ b/osu.Game.Tests/NonVisual/ScoreInfoTest.cs
@@ -26,12 +26,16 @@ namespace osu.Game.Tests.NonVisual
 
             score.Statistics[HitResult.Good]++;
             score.Rank = ScoreRank.X;
+            score.RealmUser.Username = "test";
 
             Assert.That(scoreCopy.Statistics[HitResult.Good], Is.EqualTo(10));
             Assert.That(score.Statistics[HitResult.Good], Is.EqualTo(11));
 
             Assert.That(scoreCopy.Rank, Is.EqualTo(ScoreRank.B));
             Assert.That(score.Rank, Is.EqualTo(ScoreRank.X));
+
+            Assert.That(scoreCopy.RealmUser.Username, Is.EqualTo("test"));
+            Assert.That(score.Rank, Is.Empty);
         }
 
         [Test]
diff --git a/osu.Game/Scoring/ScoreInfo.cs b/osu.Game/Scoring/ScoreInfo.cs
index a28e16450f..4de1d580dc 100644
--- a/osu.Game/Scoring/ScoreInfo.cs
+++ b/osu.Game/Scoring/ScoreInfo.cs
@@ -133,6 +133,11 @@ namespace osu.Game.Scoring
             var clone = (ScoreInfo)this.Detach().MemberwiseClone();
 
             clone.Statistics = new Dictionary<HitResult, int>(clone.Statistics);
+            clone.RealmUser = new RealmUser
+            {
+                OnlineID = RealmUser.OnlineID,
+                Username = RealmUser.Username,
+            };
 
             return clone;
         }

From 9532454e2a0d691652f40b7e15c3bd3503d9c9b4 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 26 Jan 2022 15:12:01 +0900
Subject: [PATCH 2510/5547] Remove `ILive` remnants

---
 .../UserInterface/TestScenePlaylistOverlay.cs      |  6 +++---
 osu.Game/Overlays/Music/Playlist.cs                | 14 +++++++-------
 osu.Game/Overlays/Music/PlaylistItem.cs            |  8 ++++----
 osu.Game/Overlays/Music/PlaylistOverlay.cs         |  6 +++---
 4 files changed, 17 insertions(+), 17 deletions(-)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestScenePlaylistOverlay.cs b/osu.Game.Tests/Visual/UserInterface/TestScenePlaylistOverlay.cs
index 1a3e38ddd7..09e5bc849e 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestScenePlaylistOverlay.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestScenePlaylistOverlay.cs
@@ -19,11 +19,11 @@ namespace osu.Game.Tests.Visual.UserInterface
 {
     public class TestScenePlaylistOverlay : OsuManualInputManagerTestScene
     {
-        private readonly BindableList<ILive<BeatmapSetInfo>> beatmapSets = new BindableList<ILive<BeatmapSetInfo>>();
+        private readonly BindableList<Live<BeatmapSetInfo>> beatmapSets = new BindableList<Live<BeatmapSetInfo>>();
 
         private PlaylistOverlay playlistOverlay;
 
-        private ILive<BeatmapSetInfo> first;
+        private Live<BeatmapSetInfo> first;
 
         [SetUp]
         public void Setup() => Schedule(() =>
@@ -61,7 +61,7 @@ namespace osu.Game.Tests.Visual.UserInterface
 
             AddStep("hold 1st item handle", () =>
             {
-                var handle = this.ChildrenOfType<OsuRearrangeableListItem<ILive<BeatmapSetInfo>>.PlaylistItemHandle>().First();
+                var handle = this.ChildrenOfType<OsuRearrangeableListItem<Live<BeatmapSetInfo>>.PlaylistItemHandle>().First();
                 InputManager.MoveMouseTo(handle.ScreenSpaceDrawQuad.Centre);
                 InputManager.PressButton(MouseButton.Left);
             });
diff --git a/osu.Game/Overlays/Music/Playlist.cs b/osu.Game/Overlays/Music/Playlist.cs
index c86146ff25..24d867141c 100644
--- a/osu.Game/Overlays/Music/Playlist.cs
+++ b/osu.Game/Overlays/Music/Playlist.cs
@@ -13,11 +13,11 @@ using osuTK;
 
 namespace osu.Game.Overlays.Music
 {
-    public class Playlist : OsuRearrangeableListContainer<ILive<BeatmapSetInfo>>
+    public class Playlist : OsuRearrangeableListContainer<Live<BeatmapSetInfo>>
     {
-        public Action<ILive<BeatmapSetInfo>> RequestSelection;
+        public Action<Live<BeatmapSetInfo>> RequestSelection;
 
-        public readonly Bindable<ILive<BeatmapSetInfo>> SelectedSet = new Bindable<ILive<BeatmapSetInfo>>();
+        public readonly Bindable<Live<BeatmapSetInfo>> SelectedSet = new Bindable<Live<BeatmapSetInfo>>();
 
         public new MarginPadding Padding
         {
@@ -27,7 +27,7 @@ namespace osu.Game.Overlays.Music
 
         public void Filter(FilterCriteria criteria)
         {
-            var items = (SearchContainer<RearrangeableListItem<ILive<BeatmapSetInfo>>>)ListContainer;
+            var items = (SearchContainer<RearrangeableListItem<Live<BeatmapSetInfo>>>)ListContainer;
 
             foreach (var item in items.OfType<PlaylistItem>())
                 item.InSelectedCollection = criteria.Collection?.Beatmaps.Any(b => item.Model.ID == b.BeatmapSet?.ID) ?? true;
@@ -35,15 +35,15 @@ namespace osu.Game.Overlays.Music
             items.SearchTerm = criteria.SearchText;
         }
 
-        public ILive<BeatmapSetInfo> FirstVisibleSet => Items.FirstOrDefault(i => ((PlaylistItem)ItemMap[i]).MatchingFilter);
+        public Live<BeatmapSetInfo> FirstVisibleSet => Items.FirstOrDefault(i => ((PlaylistItem)ItemMap[i]).MatchingFilter);
 
-        protected override OsuRearrangeableListItem<ILive<BeatmapSetInfo>> CreateOsuDrawable(ILive<BeatmapSetInfo> item) => new PlaylistItem(item)
+        protected override OsuRearrangeableListItem<Live<BeatmapSetInfo>> CreateOsuDrawable(Live<BeatmapSetInfo> item) => new PlaylistItem(item)
         {
             SelectedSet = { BindTarget = SelectedSet },
             RequestSelection = set => RequestSelection?.Invoke(set)
         };
 
-        protected override FillFlowContainer<RearrangeableListItem<ILive<BeatmapSetInfo>>> CreateListFillFlowContainer() => new SearchContainer<RearrangeableListItem<ILive<BeatmapSetInfo>>>
+        protected override FillFlowContainer<RearrangeableListItem<Live<BeatmapSetInfo>>> CreateListFillFlowContainer() => new SearchContainer<RearrangeableListItem<Live<BeatmapSetInfo>>>
         {
             Spacing = new Vector2(0, 3),
             LayoutDuration = 200,
diff --git a/osu.Game/Overlays/Music/PlaylistItem.cs b/osu.Game/Overlays/Music/PlaylistItem.cs
index 3f82580bfb..f081cc0503 100644
--- a/osu.Game/Overlays/Music/PlaylistItem.cs
+++ b/osu.Game/Overlays/Music/PlaylistItem.cs
@@ -17,11 +17,11 @@ using osuTK.Graphics;
 
 namespace osu.Game.Overlays.Music
 {
-    public class PlaylistItem : OsuRearrangeableListItem<ILive<BeatmapSetInfo>>, IFilterable
+    public class PlaylistItem : OsuRearrangeableListItem<Live<BeatmapSetInfo>>, IFilterable
     {
-        public readonly Bindable<ILive<BeatmapSetInfo>> SelectedSet = new Bindable<ILive<BeatmapSetInfo>>();
+        public readonly Bindable<Live<BeatmapSetInfo>> SelectedSet = new Bindable<Live<BeatmapSetInfo>>();
 
-        public Action<ILive<BeatmapSetInfo>> RequestSelection;
+        public Action<Live<BeatmapSetInfo>> RequestSelection;
 
         private TextFlowContainer text;
         private ITextPart titlePart;
@@ -29,7 +29,7 @@ namespace osu.Game.Overlays.Music
         [Resolved]
         private OsuColour colours { get; set; }
 
-        public PlaylistItem(ILive<BeatmapSetInfo> item)
+        public PlaylistItem(Live<BeatmapSetInfo> item)
             : base(item)
         {
             Padding = new MarginPadding { Left = 5 };
diff --git a/osu.Game/Overlays/Music/PlaylistOverlay.cs b/osu.Game/Overlays/Music/PlaylistOverlay.cs
index 4b10bb779e..7b705a905b 100644
--- a/osu.Game/Overlays/Music/PlaylistOverlay.cs
+++ b/osu.Game/Overlays/Music/PlaylistOverlay.cs
@@ -24,9 +24,9 @@ namespace osu.Game.Overlays.Music
         private const float transition_duration = 600;
         private const float playlist_height = 510;
 
-        public IBindableList<ILive<BeatmapSetInfo>> BeatmapSets => beatmapSets;
+        public IBindableList<Live<BeatmapSetInfo>> BeatmapSets => beatmapSets;
 
-        private readonly BindableList<ILive<BeatmapSetInfo>> beatmapSets = new BindableList<ILive<BeatmapSetInfo>>();
+        private readonly BindableList<Live<BeatmapSetInfo>> beatmapSets = new BindableList<Live<BeatmapSetInfo>>();
 
         private readonly Bindable<WorkingBeatmap> beatmap = new Bindable<WorkingBeatmap>();
 
@@ -144,7 +144,7 @@ namespace osu.Game.Overlays.Music
             this.FadeOut(transition_duration);
         }
 
-        private void itemSelected(ILive<BeatmapSetInfo> beatmapSet)
+        private void itemSelected(Live<BeatmapSetInfo> beatmapSet)
         {
             beatmapSet.PerformRead(set =>
             {

From d0a2818847d85fe68e99a3cc5feb11ca4602e130 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 26 Jan 2022 15:14:43 +0900
Subject: [PATCH 2511/5547] Fix incorrect testing

---
 osu.Game.Tests/NonVisual/ScoreInfoTest.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/NonVisual/ScoreInfoTest.cs b/osu.Game.Tests/NonVisual/ScoreInfoTest.cs
index 836c978ba2..41b08a9e98 100644
--- a/osu.Game.Tests/NonVisual/ScoreInfoTest.cs
+++ b/osu.Game.Tests/NonVisual/ScoreInfoTest.cs
@@ -34,8 +34,8 @@ namespace osu.Game.Tests.NonVisual
             Assert.That(scoreCopy.Rank, Is.EqualTo(ScoreRank.B));
             Assert.That(score.Rank, Is.EqualTo(ScoreRank.X));
 
-            Assert.That(scoreCopy.RealmUser.Username, Is.EqualTo("test"));
-            Assert.That(score.Rank, Is.Empty);
+            Assert.That(scoreCopy.RealmUser.Username, Is.Empty);
+            Assert.That(score.RealmUser.Username, Is.EqualTo("test"));
         }
 
         [Test]

From 267a7bd21fa709fc941d3620fe2c57c48e5bbe4a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 26 Jan 2022 15:14:49 +0900
Subject: [PATCH 2512/5547] Give `RealmUser.Username` a better default value

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

diff --git a/osu.Game/Models/RealmUser.cs b/osu.Game/Models/RealmUser.cs
index ff35528827..5fccff597c 100644
--- a/osu.Game/Models/RealmUser.cs
+++ b/osu.Game/Models/RealmUser.cs
@@ -11,7 +11,7 @@ namespace osu.Game.Models
     {
         public int OnlineID { get; set; } = 1;
 
-        public string Username { get; set; }
+        public string Username { get; set; } = string.Empty;
 
         public bool IsBot => false;
 

From 4fe3d83fc40a176edf7ba9a1e3785c0fb57d24f4 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 26 Jan 2022 15:21:14 +0900
Subject: [PATCH 2513/5547] Update framework

---
 osu.Android.props        | 2 +-
 osu.Game/osu.Game.csproj | 2 +-
 osu.iOS.props            | 4 ++--
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Android.props b/osu.Android.props
index 4e5b9fdbb1..f85a96f819 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -52,7 +52,7 @@
   </ItemGroup>
   <ItemGroup>
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.115.0" />
-    <PackageReference Include="ppy.osu.Framework.Android" Version="2022.125.0" />
+    <PackageReference Include="ppy.osu.Framework.Android" Version="2022.126.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
     <!-- Realm needs to be directly referenced in all Xamarin projects, as it will not pull in its transitive dependencies otherwise. -->
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index af5d8a5920..aa6fb93aa0 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="10.8.0" />
-    <PackageReference Include="ppy.osu.Framework" Version="2022.125.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2022.126.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.115.0" />
     <PackageReference Include="Sentry" Version="3.13.0" />
     <PackageReference Include="SharpCompress" Version="0.30.1" />
diff --git a/osu.iOS.props b/osu.iOS.props
index 2bcdea61b3..fbb4688588 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -60,7 +60,7 @@
     <Reference Include="System.Net.Http" />
   </ItemGroup>
   <ItemGroup Label="Package References">
-    <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.125.0" />
+    <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.126.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.115.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net5.0 / net6.0) -->
@@ -83,7 +83,7 @@
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="2.2.6" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.Core" Version="2.2.6" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
-    <PackageReference Include="ppy.osu.Framework" Version="2022.125.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2022.126.0" />
     <PackageReference Include="SharpCompress" Version="0.30.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
     <PackageReference Include="System.ComponentModel.Annotations" Version="5.0.0" />

From 5ea781faef9a4fe2de3be7a72ce84ad2306ecf23 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 26 Jan 2022 15:24:53 +0900
Subject: [PATCH 2514/5547] `Send` unsubscribe actions to synchronization
 context for consistency and safety

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

diff --git a/osu.Game/Database/RealmAccess.cs b/osu.Game/Database/RealmAccess.cs
index 3866138d40..3572446aef 100644
--- a/osu.Game/Database/RealmAccess.cs
+++ b/osu.Game/Database/RealmAccess.cs
@@ -300,7 +300,7 @@ namespace osu.Game.Database
             return new InvokeOnDisposal(() =>
             {
                 if (ThreadSafety.IsUpdateThread)
-                    unsubscribe();
+                    syncContext.Send(_ => unsubscribe(), null);
                 else
                     syncContext.Post(_ => unsubscribe(), null);
 

From b5e6352137d4254323d2888f308c81dc2ced3208 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 26 Jan 2022 09:31:29 +0300
Subject: [PATCH 2515/5547] Revert `SettingsItem<T>`-related changes

---
 osu.Game/Overlays/Settings/ISettingsItem.cs | 14 +---
 osu.Game/Overlays/Settings/SettingsItem.cs  | 91 +++++----------------
 2 files changed, 21 insertions(+), 84 deletions(-)

diff --git a/osu.Game/Overlays/Settings/ISettingsItem.cs b/osu.Game/Overlays/Settings/ISettingsItem.cs
index 20e2f48f96..e7afa48502 100644
--- a/osu.Game/Overlays/Settings/ISettingsItem.cs
+++ b/osu.Game/Overlays/Settings/ISettingsItem.cs
@@ -2,22 +2,12 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
+using osu.Framework.Graphics;
 
 namespace osu.Game.Overlays.Settings
 {
-    /// <summary>
-    /// A non-generic interface for <see cref="SettingsItem{T}"/>s.
-    /// </summary>
-    public interface ISettingsItem : IExpandable, IDisposable
+    public interface ISettingsItem : IDrawable, IDisposable
     {
-        /// <summary>
-        /// Invoked when the setting value has changed.
-        /// </summary>
         event Action SettingChanged;
-
-        /// <summary>
-        /// Returns whether the UI control is currently in a dragged state.
-        /// </summary>
-        bool IsControlDragged { get; }
     }
 }
diff --git a/osu.Game/Overlays/Settings/SettingsItem.cs b/osu.Game/Overlays/Settings/SettingsItem.cs
index 29980dc5a8..e709be1343 100644
--- a/osu.Game/Overlays/Settings/SettingsItem.cs
+++ b/osu.Game/Overlays/Settings/SettingsItem.cs
@@ -30,7 +30,7 @@ namespace osu.Game.Overlays.Settings
 
         protected readonly FillFlowContainer FlowContent;
 
-        private SpriteText label;
+        private SpriteText labelText;
 
         private OsuTextFlowContainer warningText;
 
@@ -42,34 +42,21 @@ namespace osu.Game.Overlays.Settings
         [Resolved]
         private OsuColour colours { get; set; }
 
-        private LocalisableString labelText;
-
         public virtual LocalisableString LabelText
         {
-            get => labelText;
+            get => labelText?.Text ?? string.Empty;
             set
             {
-                ensureLabelCreated();
+                if (labelText == null)
+                {
+                    // construct lazily for cases where the label is not needed (may be provided by the Control).
+                    FlowContent.Insert(-1, labelText = new OsuSpriteText());
 
-                labelText = value;
-                updateLabelText();
-            }
-        }
+                    updateDisabled();
+                }
 
-        private LocalisableString? contractedLabelText;
-
-        /// <summary>
-        /// Text to be displayed in place of <see cref="LabelText"/> when this <see cref="SettingsItem{T}"/> is in a contracted state.
-        /// </summary>
-        public LocalisableString? ContractedLabelText
-        {
-            get => contractedLabelText;
-            set
-            {
-                ensureLabelCreated();
-
-                contractedLabelText = value;
-                updateLabelText();
+                labelText.Text = value;
+                updateLayout();
             }
         }
 
@@ -103,12 +90,6 @@ namespace osu.Game.Overlays.Settings
             set => controlWithCurrent.Current = value;
         }
 
-        public BindableBool Expanded { get; } = new BindableBool(true);
-
-        public bool IsControlDragged => Control.IsDragged;
-
-        public event Action SettingChanged;
-
         public virtual IEnumerable<string> FilterTerms => Keywords == null ? new[] { LabelText.ToString() } : new List<string>(Keywords) { LabelText.ToString() }.ToArray();
 
         public IEnumerable<string> Keywords { get; set; }
@@ -120,6 +101,8 @@ namespace osu.Game.Overlays.Settings
 
         public bool FilteringActive { get; set; }
 
+        public event Action SettingChanged;
+
         protected SettingsItem()
         {
             RelativeSizeAxes = Axes.X;
@@ -168,59 +151,23 @@ namespace osu.Game.Overlays.Settings
                     Anchor = Anchor.Centre,
                     Origin = Anchor.Centre
                 });
+                updateLayout();
             }
         }
 
-        [Resolved(canBeNull: true)]
-        private IExpandingContainer expandingContainer { get; set; }
-
-        protected override void LoadComplete()
+        private void updateLayout()
         {
-            base.LoadComplete();
+            bool hasLabel = labelText != null && !string.IsNullOrEmpty(labelText.Text.ToString());
 
-            expandingContainer?.Expanded.BindValueChanged(containerExpanded => Expanded.Value = containerExpanded.NewValue, true);
-
-            Expanded.BindValueChanged(v =>
-            {
-                updateLabelText();
-
-                Control.FadeTo(v.NewValue ? 1 : 0, 500, Easing.OutQuint);
-                Control.BypassAutoSizeAxes = v.NewValue ? Axes.None : Axes.Both;
-            }, true);
-
-            FinishTransforms(true);
-        }
-
-        private void ensureLabelCreated()
-        {
-            if (label != null)
-                return;
-
-            // construct lazily for cases where the label is not needed (may be provided by the Control).
-            FlowContent.Insert(-1, label = new OsuSpriteText());
-
-            updateDisabled();
-        }
-
-        private void updateLabelText()
-        {
-            if (label != null)
-            {
-                if (contractedLabelText is LocalisableString contractedText)
-                    label.Text = Expanded.Value ? labelText : contractedText;
-                else
-                    label.Text = labelText;
-            }
-
-            // if the settings item is providing a non-empty label, the default value indicator should be centred vertically to the left of the label.
+            // if the settings item is providing a label, the default value indicator should be centred vertically to the left of the label.
             // otherwise, it should be centred vertically to the left of the main control of the settings item.
-            defaultValueIndicatorContainer.Height = !string.IsNullOrEmpty(label?.Text.ToString()) ? label.DrawHeight : Control.DrawHeight;
+            defaultValueIndicatorContainer.Height = hasLabel ? labelText.DrawHeight : Control.DrawHeight;
         }
 
         private void updateDisabled()
         {
-            if (label != null)
-                label.Alpha = controlWithCurrent.Current.Disabled ? 0.3f : 1;
+            if (labelText != null)
+                labelText.Alpha = controlWithCurrent.Current.Disabled ? 0.3f : 1;
         }
     }
 }

From 24bcba64183a7bf404eca503a3c31a24762bfdac Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 26 Jan 2022 15:57:05 +0900
Subject: [PATCH 2516/5547] Move final result set firing to before the update
 realm is disposed

Without this, if any registered callback attempts to access
`RealmAccess.Realm` when handling the empty set callback, it will
deadlock the game.
---
 osu.Game/Database/RealmAccess.cs | 18 ++++++++----------
 1 file changed, 8 insertions(+), 10 deletions(-)

diff --git a/osu.Game/Database/RealmAccess.cs b/osu.Game/Database/RealmAccess.cs
index 3572446aef..1a40176c1d 100644
--- a/osu.Game/Database/RealmAccess.cs
+++ b/osu.Game/Database/RealmAccess.cs
@@ -604,20 +604,18 @@ namespace osu.Game.Database
 
                     Logger.Log(@"Blocking realm operations.", LoggingTarget.Database);
 
+                    // Force a flush of any pending callbacks in the synchronization context.
+                    // We want to ensure that the empty set callbacks are the last thing to arrive.
+                    syncContext?.Send(_ =>
+                    {
+                        foreach (var action in notificationsResetMap.Values)
+                            action();
+                    }, null);
+
                     updateRealm?.Dispose();
                     updateRealm = null;
                 }
 
-                // In order to ensure events arrive in the correct order, these *must* be fired post disposal of the update realm,
-                // and must be posted to the synchronization context.
-                // This is because realm may fire event callbacks between the `unregisterAllSubscriptions` and `updateRealm.Dispose`
-                // calls above.
-                syncContext?.Send(_ =>
-                {
-                    foreach (var action in notificationsResetMap.Values)
-                        action();
-                }, null);
-
                 const int sleep_length = 200;
                 int timeout = 5000;
 

From 699826677006b6e7a230f061c505c53b2fbd73c6 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 26 Jan 2022 10:18:06 +0300
Subject: [PATCH 2517/5547] Add simplified implementation of an expandable
 slider

---
 osu.Game/Overlays/ExpandableSlider.cs   | 123 ++++++++++++++++++++++++
 osu.Game/Overlays/IExpandableControl.cs |  16 +++
 2 files changed, 139 insertions(+)
 create mode 100644 osu.Game/Overlays/ExpandableSlider.cs
 create mode 100644 osu.Game/Overlays/IExpandableControl.cs

diff --git a/osu.Game/Overlays/ExpandableSlider.cs b/osu.Game/Overlays/ExpandableSlider.cs
new file mode 100644
index 0000000000..38faf44148
--- /dev/null
+++ b/osu.Game/Overlays/ExpandableSlider.cs
@@ -0,0 +1,123 @@
+// 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.Bindables;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.UserInterface;
+using osu.Framework.Localisation;
+using osu.Game.Graphics.Sprites;
+using osu.Game.Graphics.UserInterface;
+
+namespace osu.Game.Overlays
+{
+    /// <summary>
+    /// An <see cref="IExpandable"/> implementation for the UI slider bar control.
+    /// </summary>
+    public class ExpandableSlider<T, TSlider> : CompositeDrawable, IExpandableControl, IHasCurrentValue<T>
+        where T : struct, IEquatable<T>, IComparable<T>, IConvertible
+        where TSlider : OsuSliderBar<T>, new()
+    {
+        private readonly OsuSpriteText label;
+        private readonly TSlider slider;
+
+        private LocalisableString contractedLabelText;
+
+        /// <summary>
+        /// The label text to display when this slider is in a contracted state.
+        /// </summary>
+        public LocalisableString ContractedLabelText
+        {
+            get => contractedLabelText;
+            set
+            {
+                if (value == contractedLabelText)
+                    return;
+
+                contractedLabelText = value;
+
+                if (!Expanded.Value)
+                    label.Text = value;
+            }
+        }
+
+        private LocalisableString expandedLabelText;
+
+        /// <summary>
+        /// The label text to display when this slider is in an expanded state.
+        /// </summary>
+        public LocalisableString ExpandedLabelText
+        {
+            get => expandedLabelText;
+            set
+            {
+                if (value == expandedLabelText)
+                    return;
+
+                expandedLabelText = value;
+
+                if (Expanded.Value)
+                    label.Text = value;
+            }
+        }
+
+        public Bindable<T> Current
+        {
+            get => slider.Current;
+            set => slider.Current = value;
+        }
+
+        public BindableBool Expanded { get; } = new BindableBool();
+
+        public bool IsControlDragged => slider.IsDragged;
+
+        public override bool HandlePositionalInput => true;
+
+        public ExpandableSlider()
+        {
+            RelativeSizeAxes = Axes.X;
+            AutoSizeAxes = Axes.Y;
+
+            InternalChild = new FillFlowContainer
+            {
+                RelativeSizeAxes = Axes.X,
+                AutoSizeAxes = Axes.Y,
+                Children = new Drawable[]
+                {
+                    label = new OsuSpriteText(),
+                    slider = new TSlider(),
+                }
+            };
+        }
+
+        [Resolved(canBeNull: true)]
+        private IExpandingContainer expandingContainer { get; set; }
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            expandingContainer?.Expanded.BindValueChanged(containerExpanded =>
+            {
+                Expanded.Value = containerExpanded.NewValue;
+            }, true);
+
+            Expanded.BindValueChanged(v =>
+            {
+                label.Text = v.NewValue ? expandedLabelText : contractedLabelText;
+                slider.FadeTo(v.NewValue ? 1f : 0f, 500, Easing.OutQuint);
+                slider.BypassAutoSizeAxes = v.NewValue ? Axes.Y : Axes.None;
+            }, true);
+        }
+    }
+
+    /// <summary>
+    /// An <see cref="IExpandable"/> implementation for the UI slider bar control.
+    /// </summary>
+    public class ExpandableSlider<T> : ExpandableSlider<T, OsuSliderBar<T>>
+        where T : struct, IEquatable<T>, IComparable<T>, IConvertible
+    {
+    }
+}
diff --git a/osu.Game/Overlays/IExpandableControl.cs b/osu.Game/Overlays/IExpandableControl.cs
new file mode 100644
index 0000000000..fae07ae23b
--- /dev/null
+++ b/osu.Game/Overlays/IExpandableControl.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.Game.Overlays
+{
+    /// <summary>
+    /// An interface for UI controls with the ability to expand/contract.
+    /// </summary>
+    public interface IExpandableControl : IExpandable
+    {
+        /// <summary>
+        /// Returns whether the UI control is currently in a dragged state.
+        /// </summary>
+        bool IsControlDragged { get; }
+    }
+}

From eb83b7fe0a912130641da4e56a9808ed18ce099b Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 26 Jan 2022 10:18:17 +0300
Subject: [PATCH 2518/5547] Update existing implementation with changes

---
 .../TestSceneExpandingControlContainer.cs         | 15 +++++++--------
 osu.Game/Overlays/ExpandingControlContainer.cs    |  3 +--
 2 files changed, 8 insertions(+), 10 deletions(-)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneExpandingControlContainer.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneExpandingControlContainer.cs
index d75089ceac..48089566cc 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneExpandingControlContainer.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneExpandingControlContainer.cs
@@ -8,7 +8,6 @@ using osu.Framework.Graphics;
 using osu.Framework.Testing;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Overlays;
-using osu.Game.Overlays.Settings;
 using osu.Game.Overlays.Settings.Sections;
 using osuTK;
 using osuTK.Input;
@@ -20,8 +19,8 @@ namespace osu.Game.Tests.Visual.UserInterface
         private TestExpandingContainer container;
         private SettingsToolboxGroup toolboxGroup;
 
-        private SettingsSlider<float, SizeSlider> slider1;
-        private SettingsSlider<double> slider2;
+        private ExpandableSlider<float, SizeSlider> slider1;
+        private ExpandableSlider<double> slider2;
 
         [SetUp]
         public void SetUp() => Schedule(() =>
@@ -37,7 +36,7 @@ namespace osu.Game.Tests.Visual.UserInterface
                     Width = 1,
                     Children = new Drawable[]
                     {
-                        slider1 = new SettingsSlider<float, SizeSlider>
+                        slider1 = new ExpandableSlider<float, SizeSlider>
                         {
                             Current = new BindableFloat
                             {
@@ -47,7 +46,7 @@ namespace osu.Game.Tests.Visual.UserInterface
                                 Precision = 0.01f,
                             },
                         },
-                        slider2 = new SettingsSlider<double>
+                        slider2 = new ExpandableSlider<double>
                         {
                             Current = new BindableDouble
                             {
@@ -63,13 +62,13 @@ namespace osu.Game.Tests.Visual.UserInterface
 
             slider1.Current.BindValueChanged(v =>
             {
-                slider1.LabelText = $"Slider One ({v.NewValue:0.##x})";
+                slider1.ExpandedLabelText = $"Slider One ({v.NewValue:0.##x})";
                 slider1.ContractedLabelText = $"S. 1. ({v.NewValue:0.##x})";
             }, true);
 
             slider2.Current.BindValueChanged(v =>
             {
-                slider2.LabelText = $"Slider Two ({v.NewValue:N2})";
+                slider2.ExpandedLabelText = $"Slider Two ({v.NewValue:N2})";
                 slider2.ContractedLabelText = $"S. 2. ({v.NewValue:N2})";
             }, true);
         });
@@ -172,7 +171,7 @@ namespace osu.Game.Tests.Visual.UserInterface
             AddAssert("container still expanded", () => container.Expanded.Value);
         }
 
-        private class TestExpandingContainer : ExpandingControlContainer<ISettingsItem>
+        private class TestExpandingContainer : ExpandingControlContainer<IExpandableControl>
         {
             public TestExpandingContainer()
                 : base(120, 250)
diff --git a/osu.Game/Overlays/ExpandingControlContainer.cs b/osu.Game/Overlays/ExpandingControlContainer.cs
index 2accd63fb9..fb6a71ba97 100644
--- a/osu.Game/Overlays/ExpandingControlContainer.cs
+++ b/osu.Game/Overlays/ExpandingControlContainer.cs
@@ -9,7 +9,6 @@ using osu.Framework.Input.Events;
 using osu.Framework.Testing;
 using osu.Framework.Threading;
 using osu.Game.Graphics.Containers;
-using osu.Game.Overlays.Settings;
 
 namespace osu.Game.Overlays
 {
@@ -119,6 +118,6 @@ namespace osu.Game.Overlays
         /// <summary>
         /// Whether the given control is currently active, by checking whether it's hovered or dragged.
         /// </summary>
-        private bool isControlActive(TControl control) => control.IsHovered || control.IsDragged || (control is ISettingsItem item && item.IsControlDragged);
+        private bool isControlActive(TControl control) => control.IsHovered || control.IsDragged || (control is IExpandableControl expandable && expandable.IsControlDragged);
     }
 }

From 11f0f3c17de6986c7aa6f6a3915b239bf2b5543e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 26 Jan 2022 16:21:24 +0900
Subject: [PATCH 2519/5547] Revert "Move final result set firing to before the
 update realm is disposed"

This reverts commit 24bcba64183a7bf404eca503a3c31a24762bfdac.
---
 osu.Game/Database/RealmAccess.cs | 18 ++++++++++--------
 1 file changed, 10 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Database/RealmAccess.cs b/osu.Game/Database/RealmAccess.cs
index 1a40176c1d..3572446aef 100644
--- a/osu.Game/Database/RealmAccess.cs
+++ b/osu.Game/Database/RealmAccess.cs
@@ -604,18 +604,20 @@ namespace osu.Game.Database
 
                     Logger.Log(@"Blocking realm operations.", LoggingTarget.Database);
 
-                    // Force a flush of any pending callbacks in the synchronization context.
-                    // We want to ensure that the empty set callbacks are the last thing to arrive.
-                    syncContext?.Send(_ =>
-                    {
-                        foreach (var action in notificationsResetMap.Values)
-                            action();
-                    }, null);
-
                     updateRealm?.Dispose();
                     updateRealm = null;
                 }
 
+                // In order to ensure events arrive in the correct order, these *must* be fired post disposal of the update realm,
+                // and must be posted to the synchronization context.
+                // This is because realm may fire event callbacks between the `unregisterAllSubscriptions` and `updateRealm.Dispose`
+                // calls above.
+                syncContext?.Send(_ =>
+                {
+                    foreach (var action in notificationsResetMap.Values)
+                        action();
+                }, null);
+
                 const int sleep_length = 200;
                 int timeout = 5000;
 

From 161ff45f8cb5e93d7cf2a02c5601344d9d35064c Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 26 Jan 2022 10:35:42 +0300
Subject: [PATCH 2520/5547] Resolve further UI-related issues

---
 osu.Game/Overlays/ExpandableSlider.cs | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Overlays/ExpandableSlider.cs b/osu.Game/Overlays/ExpandableSlider.cs
index 38faf44148..524485d806 100644
--- a/osu.Game/Overlays/ExpandableSlider.cs
+++ b/osu.Game/Overlays/ExpandableSlider.cs
@@ -10,6 +10,7 @@ using osu.Framework.Graphics.UserInterface;
 using osu.Framework.Localisation;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.UserInterface;
+using osuTK;
 
 namespace osu.Game.Overlays
 {
@@ -84,10 +85,14 @@ namespace osu.Game.Overlays
             {
                 RelativeSizeAxes = Axes.X,
                 AutoSizeAxes = Axes.Y,
+                Spacing = new Vector2(0f, 10f),
                 Children = new Drawable[]
                 {
                     label = new OsuSpriteText(),
-                    slider = new TSlider(),
+                    slider = new TSlider
+                    {
+                        RelativeSizeAxes = Axes.X,
+                    },
                 }
             };
         }
@@ -108,7 +113,7 @@ namespace osu.Game.Overlays
             {
                 label.Text = v.NewValue ? expandedLabelText : contractedLabelText;
                 slider.FadeTo(v.NewValue ? 1f : 0f, 500, Easing.OutQuint);
-                slider.BypassAutoSizeAxes = v.NewValue ? Axes.Y : Axes.None;
+                slider.BypassAutoSizeAxes = !v.NewValue ? Axes.Y : Axes.None;
             }, true);
         }
     }

From 791ea0308f8026c127d26ee2118b083ffa72abf9 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 26 Jan 2022 17:09:28 +0900
Subject: [PATCH 2521/5547] Add flag to guard against deadlocks during blocking
 operations

---
 osu.Game/Database/RealmAccess.cs | 21 +++++++++++++++++++--
 1 file changed, 19 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Database/RealmAccess.cs b/osu.Game/Database/RealmAccess.cs
index 3572446aef..dc7c8bf668 100644
--- a/osu.Game/Database/RealmAccess.cs
+++ b/osu.Game/Database/RealmAccess.cs
@@ -89,10 +89,15 @@ namespace osu.Game.Database
 
         private Realm? updateRealm;
 
+        private bool isSendingNotificationResetEvents;
+
         public Realm Realm => ensureUpdateRealm();
 
         private Realm ensureUpdateRealm()
         {
+            if (isSendingNotificationResetEvents)
+                throw new InvalidOperationException("Cannot retrieve a realm context from a notification callback during a blocking operation.");
+
             if (!ThreadSafety.IsUpdateThread)
                 throw new InvalidOperationException(@$"Use {nameof(getRealmInstance)} when performing realm operations from a non-update thread");
 
@@ -614,8 +619,20 @@ namespace osu.Game.Database
                 // calls above.
                 syncContext?.Send(_ =>
                 {
-                    foreach (var action in notificationsResetMap.Values)
-                        action();
+                    // Flag ensures that we don't get in a deadlocked scenario due to a callback attempting to access `RealmAccess.Realm` or `RealmAccess.Run`
+                    // and hitting `realmRetrievalLock` a second time. Generally such usages should not exist, and as such we throw when an attempt is made
+                    // to use in this fashion.
+                    isSendingNotificationResetEvents = true;
+
+                    try
+                    {
+                        foreach (var action in notificationsResetMap.Values)
+                            action();
+                    }
+                    finally
+                    {
+                        isSendingNotificationResetEvents = false;
+                    }
                 }, null);
 
                 const int sleep_length = 200;

From 885fb92aada99e4dfccb0904f544e16a093787ba Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 26 Jan 2022 17:21:57 +0900
Subject: [PATCH 2522/5547] Move final empty result set sending to post-compact

---
 osu.Game/Database/RealmAccess.cs | 44 ++++++++++++++++----------------
 1 file changed, 22 insertions(+), 22 deletions(-)

diff --git a/osu.Game/Database/RealmAccess.cs b/osu.Game/Database/RealmAccess.cs
index dc7c8bf668..9bdbebfe89 100644
--- a/osu.Game/Database/RealmAccess.cs
+++ b/osu.Game/Database/RealmAccess.cs
@@ -613,28 +613,6 @@ namespace osu.Game.Database
                     updateRealm = null;
                 }
 
-                // In order to ensure events arrive in the correct order, these *must* be fired post disposal of the update realm,
-                // and must be posted to the synchronization context.
-                // This is because realm may fire event callbacks between the `unregisterAllSubscriptions` and `updateRealm.Dispose`
-                // calls above.
-                syncContext?.Send(_ =>
-                {
-                    // Flag ensures that we don't get in a deadlocked scenario due to a callback attempting to access `RealmAccess.Realm` or `RealmAccess.Run`
-                    // and hitting `realmRetrievalLock` a second time. Generally such usages should not exist, and as such we throw when an attempt is made
-                    // to use in this fashion.
-                    isSendingNotificationResetEvents = true;
-
-                    try
-                    {
-                        foreach (var action in notificationsResetMap.Values)
-                            action();
-                    }
-                    finally
-                    {
-                        isSendingNotificationResetEvents = false;
-                    }
-                }, null);
-
                 const int sleep_length = 200;
                 int timeout = 5000;
 
@@ -656,6 +634,28 @@ namespace osu.Game.Database
                     // We still want to continue with the blocking operation, though.
                     Logger.Log($"Realm compact failed with error {e}", LoggingTarget.Database);
                 }
+
+                // In order to ensure events arrive in the correct order, these *must* be fired post disposal of the update realm,
+                // and must be posted to the synchronization context.
+                // This is because realm may fire event callbacks between the `unregisterAllSubscriptions` and `updateRealm.Dispose`
+                // calls above.
+                syncContext?.Send(_ =>
+                {
+                    // Flag ensures that we don't get in a deadlocked scenario due to a callback attempting to access `RealmAccess.Realm` or `RealmAccess.Run`
+                    // and hitting `realmRetrievalLock` a second time. Generally such usages should not exist, and as such we throw when an attempt is made
+                    // to use in this fashion.
+                    isSendingNotificationResetEvents = true;
+
+                    try
+                    {
+                        foreach (var action in notificationsResetMap.Values)
+                            action();
+                    }
+                    finally
+                    {
+                        isSendingNotificationResetEvents = false;
+                    }
+                }, null);
             }
             catch
             {

From d1a22562621a2768056d3604400108f0b20c5441 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 26 Jan 2022 17:48:11 +0900
Subject: [PATCH 2523/5547] Refactor `SkinSection` to avoid unnecessary realm
 queries

---
 .../Overlays/Settings/Sections/SkinSection.cs | 83 ++++++++++---------
 1 file changed, 42 insertions(+), 41 deletions(-)

diff --git a/osu.Game/Overlays/Settings/Sections/SkinSection.cs b/osu.Game/Overlays/Settings/Sections/SkinSection.cs
index 0846c023c1..441a439596 100644
--- a/osu.Game/Overlays/Settings/Sections/SkinSection.cs
+++ b/osu.Game/Overlays/Settings/Sections/SkinSection.cs
@@ -18,6 +18,7 @@ using osu.Game.Graphics.UserInterface;
 using osu.Game.Localisation;
 using osu.Game.Skinning;
 using osu.Game.Skinning.Editor;
+using Realms;
 
 namespace osu.Game.Overlays.Settings.Sections
 {
@@ -51,12 +52,6 @@ namespace osu.Game.Overlays.Settings.Sections
 
         private IDisposable realmSubscription;
 
-        private IQueryable<SkinInfo> queryRealmSkins() =>
-            realm.Realm.All<SkinInfo>()
-                 .Where(s => !s.DeletePending)
-                 .OrderByDescending(s => s.Protected) // protected skins should be at the top.
-                 .ThenBy(s => s.Name, StringComparer.OrdinalIgnoreCase);
-
         [BackgroundDependencyLoader(permitNulls: true)]
         private void load(OsuConfigManager config, [CanBeNull] SkinEditorOverlay skinEditor)
         {
@@ -83,37 +78,54 @@ namespace osu.Game.Overlays.Settings.Sections
 
             skinDropdown.Current = dropdownBindable;
 
-            realmSubscription = realm.RegisterForNotifications(r => queryRealmSkins(), (sender, changes, error) =>
-            {
-                // The first fire of this is a bit redundant due to the call below,
-                // but this is safest in case the subscription is restored after a context recycle.
-                updateItems();
-            });
-
-            updateItems();
+            realmSubscription = realm.RegisterForNotifications(r => realm.Realm.All<SkinInfo>()
+                                                                         .Where(s => !s.DeletePending)
+                                                                         .OrderByDescending(s => s.Protected) // protected skins should be at the top.
+                                                                         .ThenBy(s => s.Name, StringComparer.OrdinalIgnoreCase), skinsChanged);
 
             configBindable.BindValueChanged(id => Scheduler.AddOnce(updateSelectedSkinFromConfig));
-            updateSelectedSkinFromConfig();
 
-            dropdownBindable.BindValueChanged(skin =>
+            dropdownBindable.BindValueChanged(dropdownSelectionChanged);
+        }
+
+        private void dropdownSelectionChanged(ValueChangedEvent<Live<SkinInfo>> skin)
+        {
+            // Only handle cases where it's clear the user has intent to change skins.
+            if (skin.OldValue == null) return;
+
+            if (skin.NewValue.Equals(random_skin_info))
             {
-                if (skin.NewValue.Equals(random_skin_info))
+                var skinBefore = skins.CurrentSkinInfo.Value;
+
+                skins.SelectRandomSkin();
+
+                if (skinBefore == skins.CurrentSkinInfo.Value)
                 {
-                    var skinBefore = skins.CurrentSkinInfo.Value;
-
-                    skins.SelectRandomSkin();
-
-                    if (skinBefore == skins.CurrentSkinInfo.Value)
-                    {
-                        // the random selection didn't change the skin, so we should manually update the dropdown to match.
-                        dropdownBindable.Value = skins.CurrentSkinInfo.Value;
-                    }
-
-                    return;
+                    // the random selection didn't change the skin, so we should manually update the dropdown to match.
+                    dropdownBindable.Value = skins.CurrentSkinInfo.Value;
                 }
 
-                configBindable.Value = skin.NewValue.ID.ToString();
-            });
+                return;
+            }
+
+            configBindable.Value = skin.NewValue.ID.ToString();
+        }
+
+        private void skinsChanged(IRealmCollection<SkinInfo> skins, ChangeSet changes, Exception error)
+        {
+            // This can only mean that realm is recycling, else we would see the protected skins.
+            // Because we are using `Live<>` in this class, we don't need to worry about this scenario too much.
+            if (!skins.Any())
+                return;
+
+            int protectedCount = skins.Count(s => s.Protected);
+
+            skinItems = skins.ToLive(realm);
+            skinItems.Insert(protectedCount, random_skin_info);
+
+            skinDropdown.Items = skinItems;
+
+            updateSelectedSkinFromConfig();
         }
 
         private void updateSelectedSkinFromConfig()
@@ -126,17 +138,6 @@ namespace osu.Game.Overlays.Settings.Sections
             dropdownBindable.Value = skin ?? skinDropdown.Items.First();
         }
 
-        private void updateItems()
-        {
-            int protectedCount = queryRealmSkins().Count(s => s.Protected);
-
-            skinItems = queryRealmSkins().ToLive(realm);
-
-            skinItems.Insert(protectedCount, random_skin_info);
-
-            skinDropdown.Items = skinItems;
-        }
-
         protected override void Dispose(bool isDisposing)
         {
             base.Dispose(isDisposing);

From f2d48d088d81773f1d93f298b8e7d142565b7e80 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 26 Jan 2022 17:57:03 +0900
Subject: [PATCH 2524/5547] Fix realm migration failures with presence of
 databased EF rulesets that don't exist on disk

---
 osu.Game/Rulesets/EFRulesetInfo.cs | 10 ++--------
 1 file changed, 2 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Rulesets/EFRulesetInfo.cs b/osu.Game/Rulesets/EFRulesetInfo.cs
index 473b7c657e..9559cfa00c 100644
--- a/osu.Game/Rulesets/EFRulesetInfo.cs
+++ b/osu.Game/Rulesets/EFRulesetInfo.cs
@@ -28,21 +28,15 @@ namespace osu.Game.Rulesets
         public Ruleset CreateInstance()
         {
             if (!Available)
-                throw new RulesetLoadException(@"Ruleset not available");
+                return null;
 
             var type = Type.GetType(InstantiationInfo);
 
             if (type == null)
-                throw new RulesetLoadException(@"Type lookup failure");
+                return null;
 
             var ruleset = Activator.CreateInstance(type) as Ruleset;
 
-            if (ruleset == null)
-                throw new RulesetLoadException(@"Instantiation failure");
-
-            // overwrite the pre-populated RulesetInfo with a potentially database attached copy.
-            // ruleset.RulesetInfo = this;
-
             return ruleset;
         }
 

From 3aa681005bd5bf676b0cdf912aa0567a8120f077 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 26 Jan 2022 18:04:53 +0900
Subject: [PATCH 2525/5547] Skip importing scores which have no matching realm
 ruleset

There's no real way to recover these unless we want to start importing
rulesets into realm. And that seems counter productive. This can only
happen if users don't have the dll present any more, and it was removed
far before realm was tracking rulesets (else it would have an
`Available=0` entry in realm to match).
---
 osu.Game/Database/EFToRealmMigrator.cs | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/osu.Game/Database/EFToRealmMigrator.cs b/osu.Game/Database/EFToRealmMigrator.cs
index adf91e4a41..33f7c25b28 100644
--- a/osu.Game/Database/EFToRealmMigrator.cs
+++ b/osu.Game/Database/EFToRealmMigrator.cs
@@ -286,6 +286,7 @@ namespace osu.Game.Database
 
                 var transaction = r.BeginWrite();
                 int written = 0;
+                int missing = 0;
 
                 try
                 {
@@ -300,6 +301,13 @@ namespace osu.Game.Database
 
                         var beatmap = r.All<BeatmapInfo>().First(b => b.Hash == score.BeatmapInfo.Hash);
                         var ruleset = r.Find<RulesetInfo>(score.Ruleset.ShortName);
+
+                        if (ruleset == null)
+                        {
+                            log($"Skipping {++missing} scores with missing ruleset");
+                            continue;
+                        }
+
                         var user = new RealmUser
                         {
                             OnlineID = score.User.OnlineID,

From 45636ce04b224ca516b798c253f2289c357aaa5c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 26 Jan 2022 18:25:27 +0900
Subject: [PATCH 2526/5547] Remove collection `ToLive` helper method to avoid
 confusion

---
 osu.Game/Database/RealmObjectExtensions.cs     |  6 ------
 .../Overlays/Settings/Sections/SkinSection.cs  | 18 +++++++++++-------
 2 files changed, 11 insertions(+), 13 deletions(-)

diff --git a/osu.Game/Database/RealmObjectExtensions.cs b/osu.Game/Database/RealmObjectExtensions.cs
index dba8633f53..7a0ca2c85a 100644
--- a/osu.Game/Database/RealmObjectExtensions.cs
+++ b/osu.Game/Database/RealmObjectExtensions.cs
@@ -216,12 +216,6 @@ namespace osu.Game.Database
             return new RealmLiveUnmanaged<T>(realmObject);
         }
 
-        public static List<Live<T>> ToLive<T>(this IEnumerable<T> realmList, RealmAccess realm)
-            where T : RealmObject, IHasGuidPrimaryKey
-        {
-            return realmList.Select(l => new RealmLive<T>(l, realm)).Cast<Live<T>>().ToList();
-        }
-
         public static Live<T> ToLive<T>(this T realmObject, RealmAccess realm)
             where T : RealmObject, IHasGuidPrimaryKey
         {
diff --git a/osu.Game/Overlays/Settings/Sections/SkinSection.cs b/osu.Game/Overlays/Settings/Sections/SkinSection.cs
index 441a439596..1dfe49945f 100644
--- a/osu.Game/Overlays/Settings/Sections/SkinSection.cs
+++ b/osu.Game/Overlays/Settings/Sections/SkinSection.cs
@@ -42,7 +42,7 @@ namespace osu.Game.Overlays.Settings.Sections
             Name = "<Random Skin>",
         }.ToLiveUnmanaged();
 
-        private List<Live<SkinInfo>> skinItems;
+        private readonly List<Live<SkinInfo>> dropdownItems = new List<Live<SkinInfo>>();
 
         [Resolved]
         private SkinManager skins { get; set; }
@@ -111,19 +111,23 @@ namespace osu.Game.Overlays.Settings.Sections
             configBindable.Value = skin.NewValue.ID.ToString();
         }
 
-        private void skinsChanged(IRealmCollection<SkinInfo> skins, ChangeSet changes, Exception error)
+        private void skinsChanged(IRealmCollection<SkinInfo> sender, ChangeSet changes, Exception error)
         {
             // This can only mean that realm is recycling, else we would see the protected skins.
             // Because we are using `Live<>` in this class, we don't need to worry about this scenario too much.
-            if (!skins.Any())
+            if (!sender.Any())
                 return;
 
-            int protectedCount = skins.Count(s => s.Protected);
+            int protectedCount = sender.Count(s => s.Protected);
 
-            skinItems = skins.ToLive(realm);
-            skinItems.Insert(protectedCount, random_skin_info);
+            // For simplicity repopulate the full list.
+            // In the future we should change this to properly handle ChangeSet events.
+            dropdownItems.Clear();
+            foreach (var skin in sender)
+                dropdownItems.Add(skin.ToLive(realm));
+            dropdownItems.Insert(protectedCount, random_skin_info);
 
-            skinDropdown.Items = skinItems;
+            skinDropdown.Items = dropdownItems;
 
             updateSelectedSkinFromConfig();
         }

From 473c4d00cabb5079b8c1630dd46659889cb25665 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 26 Jan 2022 18:38:44 +0900
Subject: [PATCH 2527/5547] Fix grouped difficulty icons using incorrect lookup
 for ruleset grouping

---
 osu.Game/Screens/Select/Carousel/SetPanelContent.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Select/Carousel/SetPanelContent.cs b/osu.Game/Screens/Select/Carousel/SetPanelContent.cs
index 619806f96e..82523c9d9d 100644
--- a/osu.Game/Screens/Select/Carousel/SetPanelContent.cs
+++ b/osu.Game/Screens/Select/Carousel/SetPanelContent.cs
@@ -87,7 +87,7 @@ namespace osu.Game.Screens.Select.Carousel
             var beatmaps = carouselSet.Beatmaps.ToList();
 
             return beatmaps.Count > maximum_difficulty_icons
-                ? (IEnumerable<DifficultyIcon>)beatmaps.GroupBy(b => b.BeatmapInfo.RulesetID)
+                ? (IEnumerable<DifficultyIcon>)beatmaps.GroupBy(b => b.BeatmapInfo.Ruleset.ShortName)
                                                        .Select(group => new FilterableGroupedDifficultyIcon(group.ToList(), group.Last().BeatmapInfo.Ruleset))
                 : beatmaps.Select(b => new FilterableDifficultyIcon(b));
         }

From 57e624d8e7519427fbe05a54da4fe7bed5f7cf67 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 26 Jan 2022 18:46:32 +0900
Subject: [PATCH 2528/5547] Fix custom rulesets being displayed before official
 ones

---
 osu.Game/Rulesets/RulesetStore.cs | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Rulesets/RulesetStore.cs b/osu.Game/Rulesets/RulesetStore.cs
index 9af9ace7ad..0f518be639 100644
--- a/osu.Game/Rulesets/RulesetStore.cs
+++ b/osu.Game/Rulesets/RulesetStore.cs
@@ -163,7 +163,10 @@ namespace osu.Game.Rulesets
                     }
                 }
 
-                availableRulesets.AddRange(detachedRulesets);
+                // add known official rulesets first..
+                availableRulesets.AddRange(detachedRulesets.Where(r => r.OnlineID >= 0).OrderBy(r => r.OnlineID));
+                // .. then add any customs
+                availableRulesets.AddRange(detachedRulesets.Where(r => r.OnlineID < 0).OrderBy(r => r.ShortName));
             });
         }
 

From abe2cccaaecd1a01b5f3855705b4195958ef11da Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 26 Jan 2022 19:03:26 +0900
Subject: [PATCH 2529/5547] Fix completely invalid method of testing realm
 migration

---
 osu.Game.Tests/Database/RealmLiveTests.cs | 10 ++++------
 1 file changed, 4 insertions(+), 6 deletions(-)

diff --git a/osu.Game.Tests/Database/RealmLiveTests.cs b/osu.Game.Tests/Database/RealmLiveTests.cs
index 3f81b36378..4bc1f5078a 100644
--- a/osu.Game.Tests/Database/RealmLiveTests.cs
+++ b/osu.Game.Tests/Database/RealmLiveTests.cs
@@ -47,16 +47,14 @@ namespace osu.Game.Tests.Database
                     liveBeatmap = beatmap.ToLive(realm);
                 });
 
-                using (realm.BlockAllOperations())
-                {
-                    // recycle realm before migrating
-                }
-
                 using (var migratedStorage = new TemporaryNativeStorage("realm-test-migration-target"))
                 {
                     migratedStorage.DeleteDirectory(string.Empty);
 
-                    storage.Migrate(migratedStorage);
+                    using (realm.BlockAllOperations())
+                    {
+                        storage.Migrate(migratedStorage);
+                    }
 
                     Assert.IsFalse(liveBeatmap?.PerformRead(l => l.Hidden));
                 }

From b3f2392358ac141b17f28328932d299384e3bec9 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 26 Jan 2022 19:04:18 +0900
Subject: [PATCH 2530/5547] Resolve compilation error due to removed method

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

diff --git a/osu.Game/Overlays/Music/PlaylistOverlay.cs b/osu.Game/Overlays/Music/PlaylistOverlay.cs
index 7b705a905b..59ade0918d 100644
--- a/osu.Game/Overlays/Music/PlaylistOverlay.cs
+++ b/osu.Game/Overlays/Music/PlaylistOverlay.cs
@@ -116,7 +116,7 @@ namespace osu.Game.Overlays.Music
             {
                 beatmapSets.Clear();
                 // must use AddRange to avoid RearrangeableList sort overhead per add op.
-                beatmapSets.AddRange(sender.ToLive(realm));
+                beatmapSets.AddRange(sender.Select(b => b.ToLive(realm)));
                 return;
             }
 

From 378173cc66e202e97a342b51c6f0f4a6327cf278 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 26 Jan 2022 22:46:29 +0900
Subject: [PATCH 2531/5547] Fix some score imports failing due to null string
 attempted to be parsed as json

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

diff --git a/osu.Game/Scoring/EFScoreInfo.cs b/osu.Game/Scoring/EFScoreInfo.cs
index 1dd4e3b6b3..4161336cfc 100644
--- a/osu.Game/Scoring/EFScoreInfo.cs
+++ b/osu.Game/Scoring/EFScoreInfo.cs
@@ -105,7 +105,7 @@ namespace osu.Game.Scoring
         public string ModsJson
         {
             get => JsonConvert.SerializeObject(APIMods);
-            set => APIMods = JsonConvert.DeserializeObject<APIMod[]>(value);
+            set => APIMods = !string.IsNullOrEmpty(value) ? JsonConvert.DeserializeObject<APIMod[]>(value) : Array.Empty<APIMod>();
         }
 
         [NotMapped]

From 7f34085baa52a837edef6e1e1ed431f186d08224 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 26 Jan 2022 17:04:28 +0300
Subject: [PATCH 2532/5547] Mark `EditorSavingTestScene` as abstract

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

diff --git a/osu.Game/Tests/Visual/EditorSavingTestScene.cs b/osu.Game/Tests/Visual/EditorSavingTestScene.cs
index 72b5d076a5..cc39ead1de 100644
--- a/osu.Game/Tests/Visual/EditorSavingTestScene.cs
+++ b/osu.Game/Tests/Visual/EditorSavingTestScene.cs
@@ -16,7 +16,7 @@ namespace osu.Game.Tests.Visual
     /// <summary>
     /// Tests the general expected flow of creating a new beatmap, saving it, then loading it back from song select.
     /// </summary>
-    public class EditorSavingTestScene : OsuGameTestScene
+    public abstract class EditorSavingTestScene : OsuGameTestScene
     {
         protected Editor Editor => Game.ChildrenOfType<Editor>().FirstOrDefault();
 

From 873d3676153521b732167bfeb052445931984846 Mon Sep 17 00:00:00 2001
From: Derrick Timmermans <derrick.timmermans@outlook.com>
Date: Wed, 26 Jan 2022 15:51:39 +0100
Subject: [PATCH 2533/5547] Fix custom rulesets not being able to convert maps

---
 osu.Game/Screens/Select/Carousel/CarouselBeatmap.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Select/Carousel/CarouselBeatmap.cs b/osu.Game/Screens/Select/Carousel/CarouselBeatmap.cs
index 6b198ab505..7fd312371b 100644
--- a/osu.Game/Screens/Select/Carousel/CarouselBeatmap.cs
+++ b/osu.Game/Screens/Select/Carousel/CarouselBeatmap.cs
@@ -29,7 +29,7 @@ namespace osu.Game.Screens.Select.Carousel
             bool match =
                 criteria.Ruleset == null ||
                 BeatmapInfo.RulesetID == criteria.Ruleset.OnlineID ||
-                (BeatmapInfo.RulesetID == 0 && criteria.Ruleset.OnlineID > 0 && criteria.AllowConvertedBeatmaps);
+                (BeatmapInfo.RulesetID == 0 && criteria.Ruleset.OnlineID != 0 && criteria.AllowConvertedBeatmaps);
 
             if (BeatmapInfo.BeatmapSet?.Equals(criteria.SelectedBeatmapSet) == true)
             {

From e712fab2994557019a825c80d8658197fca51b21 Mon Sep 17 00:00:00 2001
From: Derrick Timmermans <derrick.timmermans@outlook.com>
Date: Wed, 26 Jan 2022 16:14:07 +0100
Subject: [PATCH 2534/5547] Add test for custom ruleset conversion filtering

---
 .../NonVisual/Filtering/FilterMatchingTest.cs      | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/osu.Game.Tests/NonVisual/Filtering/FilterMatchingTest.cs b/osu.Game.Tests/NonVisual/Filtering/FilterMatchingTest.cs
index 74904f4585..2e7a4a65e5 100644
--- a/osu.Game.Tests/NonVisual/Filtering/FilterMatchingTest.cs
+++ b/osu.Game.Tests/NonVisual/Filtering/FilterMatchingTest.cs
@@ -78,6 +78,20 @@ namespace osu.Game.Tests.NonVisual.Filtering
             Assert.IsFalse(carouselItem.Filtered.Value);
         }
 
+        [Test]
+        public void TestCriteriaMatchingConvertedBeatmapsForCustomRulesets()
+        {
+            var exampleBeatmapInfo = getExampleBeatmap();
+            var criteria = new FilterCriteria
+            {
+                Ruleset = new RulesetInfo { OnlineID = -25 },
+                AllowConvertedBeatmaps = true
+            };
+            var carouselItem = new CarouselBeatmap(exampleBeatmapInfo);
+            carouselItem.Filter(criteria);
+            Assert.IsFalse(carouselItem.Filtered.Value);
+        }
+
         [Test]
         [TestCase(true)]
         [TestCase(false)]

From 6ec9c5c21a7891c0d1d7e8f9e88b44f482885da1 Mon Sep 17 00:00:00 2001
From: Derrick Timmermans <derrick.timmermans@outlook.com>
Date: Wed, 26 Jan 2022 16:23:00 +0100
Subject: [PATCH 2535/5547] Use default custom ruleset ID

---
 osu.Game.Tests/NonVisual/Filtering/FilterMatchingTest.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Tests/NonVisual/Filtering/FilterMatchingTest.cs b/osu.Game.Tests/NonVisual/Filtering/FilterMatchingTest.cs
index 2e7a4a65e5..363753cb33 100644
--- a/osu.Game.Tests/NonVisual/Filtering/FilterMatchingTest.cs
+++ b/osu.Game.Tests/NonVisual/Filtering/FilterMatchingTest.cs
@@ -84,7 +84,7 @@ namespace osu.Game.Tests.NonVisual.Filtering
             var exampleBeatmapInfo = getExampleBeatmap();
             var criteria = new FilterCriteria
             {
-                Ruleset = new RulesetInfo { OnlineID = -25 },
+                Ruleset = new RulesetInfo { OnlineID = -1 },
                 AllowConvertedBeatmaps = true
             };
             var carouselItem = new CarouselBeatmap(exampleBeatmapInfo);

From f21e3d0d866e637870d9a9693b693b108c114611 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 27 Jan 2022 00:34:51 +0900
Subject: [PATCH 2536/5547] Block collection loading until realm migration has
 completed

---
 osu.Game/Collections/CollectionManager.cs   | 5 +++++
 osu.Game/Database/DatabaseContextFactory.cs | 6 ++++++
 osu.Game/Database/EFToRealmMigrator.cs      | 1 +
 3 files changed, 12 insertions(+)

diff --git a/osu.Game/Collections/CollectionManager.cs b/osu.Game/Collections/CollectionManager.cs
index c4f991094c..5845e0d4d1 100644
--- a/osu.Game/Collections/CollectionManager.cs
+++ b/osu.Game/Collections/CollectionManager.cs
@@ -50,9 +50,14 @@ namespace osu.Game.Collections
             this.storage = storage;
         }
 
+        [Resolved(canBeNull: true)]
+        private DatabaseContextFactory efContextFactory { get; set; } = null!;
+
         [BackgroundDependencyLoader]
         private void load()
         {
+            efContextFactory?.WaitForMigrationCompletion();
+
             Collections.CollectionChanged += collectionsChanged;
 
             if (storage.Exists(database_backup_name))
diff --git a/osu.Game/Database/DatabaseContextFactory.cs b/osu.Game/Database/DatabaseContextFactory.cs
index c84edbfb81..123ed8019c 100644
--- a/osu.Game/Database/DatabaseContextFactory.cs
+++ b/osu.Game/Database/DatabaseContextFactory.cs
@@ -184,5 +184,11 @@ namespace osu.Game.Database
         }
 
         public static string CreateDatabaseConnectionString(string filename, Storage storage) => string.Concat("Data Source=", storage.GetFullPath($@"{filename}", true));
+
+        private readonly ManualResetEventSlim migrationComplete = new ManualResetEventSlim();
+
+        public void SetMigrationCompletion() => migrationComplete.Set();
+
+        public void WaitForMigrationCompletion() => migrationComplete.Wait();
     }
 }
diff --git a/osu.Game/Database/EFToRealmMigrator.cs b/osu.Game/Database/EFToRealmMigrator.cs
index 33f7c25b28..96baad35ec 100644
--- a/osu.Game/Database/EFToRealmMigrator.cs
+++ b/osu.Game/Database/EFToRealmMigrator.cs
@@ -128,6 +128,7 @@ namespace osu.Game.Database
             }, TaskCreationOptions.LongRunning).ContinueWith(t =>
             {
                 migrationCompleted.SetResult(true);
+                efContextFactory.SetMigrationCompletion();
             });
         }
 

From 0c2ed2f9a77c863865844f20bc0796ef1d6e14e0 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 27 Jan 2022 01:25:55 +0900
Subject: [PATCH 2537/5547] Add failing test coverage of incorrect filter
 ruleset matching

---
 osu.Game.Tests/NonVisual/Filtering/FilterMatchingTest.cs | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/NonVisual/Filtering/FilterMatchingTest.cs b/osu.Game.Tests/NonVisual/Filtering/FilterMatchingTest.cs
index 363753cb33..33204d33a7 100644
--- a/osu.Game.Tests/NonVisual/Filtering/FilterMatchingTest.cs
+++ b/osu.Game.Tests/NonVisual/Filtering/FilterMatchingTest.cs
@@ -16,7 +16,11 @@ namespace osu.Game.Tests.NonVisual.Filtering
     {
         private BeatmapInfo getExampleBeatmap() => new BeatmapInfo
         {
-            Ruleset = new RulesetInfo { OnlineID = 0 },
+            Ruleset = new RulesetInfo
+            {
+                ShortName = "osu",
+                OnlineID = 0
+            },
             StarRating = 4.0d,
             Difficulty = new BeatmapDifficulty
             {
@@ -57,7 +61,7 @@ namespace osu.Game.Tests.NonVisual.Filtering
             var exampleBeatmapInfo = getExampleBeatmap();
             var criteria = new FilterCriteria
             {
-                Ruleset = new RulesetInfo { OnlineID = 6 }
+                Ruleset = new RulesetInfo { ShortName = "catch" }
             };
             var carouselItem = new CarouselBeatmap(exampleBeatmapInfo);
             carouselItem.Filter(criteria);

From f70e10e8a4607dd51254a9915c78880b35a4f923 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 27 Jan 2022 01:25:40 +0900
Subject: [PATCH 2538/5547] Fix ruleset filter matching using `OnlineID`
 instead of `ShortName`

---
 osu.Game/Screens/Select/Carousel/CarouselBeatmap.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Select/Carousel/CarouselBeatmap.cs b/osu.Game/Screens/Select/Carousel/CarouselBeatmap.cs
index 7fd312371b..e6dee0233f 100644
--- a/osu.Game/Screens/Select/Carousel/CarouselBeatmap.cs
+++ b/osu.Game/Screens/Select/Carousel/CarouselBeatmap.cs
@@ -28,7 +28,7 @@ namespace osu.Game.Screens.Select.Carousel
 
             bool match =
                 criteria.Ruleset == null ||
-                BeatmapInfo.RulesetID == criteria.Ruleset.OnlineID ||
+                BeatmapInfo.Ruleset.ShortName == criteria.Ruleset.ShortName ||
                 (BeatmapInfo.RulesetID == 0 && criteria.Ruleset.OnlineID != 0 && criteria.AllowConvertedBeatmaps);
 
             if (BeatmapInfo.BeatmapSet?.Equals(criteria.SelectedBeatmapSet) == true)

From 4382adad8240fee9c85f1b5cb21efea70c011184 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 25 Jan 2022 23:20:33 +0100
Subject: [PATCH 2539/5547] Add test coverage for editor changes not resetting
 after exit without save

---
 .../Visual/Editing/TestSceneEditorSaving.cs   | 21 +++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneEditorSaving.cs b/osu.Game.Tests/Visual/Editing/TestSceneEditorSaving.cs
index 58daab1ce2..adaa24d542 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneEditorSaving.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneEditorSaving.cs
@@ -4,11 +4,13 @@
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
+using osu.Framework.Screens;
 using osu.Framework.Testing;
 using osu.Framework.Utils;
 using osu.Game.Beatmaps.ControlPoints;
 using osu.Game.Screens.Edit;
 using osu.Game.Screens.Edit.Compose.Components.Timeline;
+using osu.Game.Screens.Select;
 using osuTK.Input;
 
 namespace osu.Game.Tests.Visual.Editing
@@ -116,5 +118,24 @@ namespace osu.Game.Tests.Visual.Editing
                 EditorBeatmap.HitObjects[0].SampleControlPoint != SampleControlPoint.DEFAULT &&
                 EditorBeatmap.HitObjects[0].DifficultyControlPoint != DifficultyControlPoint.DEFAULT);
         }
+
+        [Test]
+        public void TestExitWithoutSaveFromExistingBeatmap()
+        {
+            const string tags_to_save = "these tags will be saved";
+            const string tags_to_discard = "these tags should be discarded";
+
+            AddStep("Set tags", () => EditorBeatmap.BeatmapInfo.Metadata.Tags = tags_to_save);
+            SaveEditor();
+            AddAssert("Tags saved correctly", () => EditorBeatmap.BeatmapInfo.Metadata.Tags == tags_to_save);
+
+            ReloadEditorToSameBeatmap();
+            AddAssert("Tags saved correctly", () => EditorBeatmap.BeatmapInfo.Metadata.Tags == tags_to_save);
+            AddStep("Set tags again", () => EditorBeatmap.BeatmapInfo.Metadata.Tags = tags_to_discard);
+
+            AddStep("Exit editor", () => Editor.Exit());
+            AddUntilStep("Wait for song select", () => Game.ScreenStack.CurrentScreen is PlaySongSelect);
+            AddAssert("Tags reverted correctly", () => Game.Beatmap.Value.BeatmapInfo.Metadata.Tags == tags_to_save);
+        }
     }
 }

From d760283665b6ecadcdee4989ded6e7684387dd41 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 25 Jan 2022 23:31:42 +0100
Subject: [PATCH 2540/5547] Ensure edited beatmap is restored to a baseline
 state on exit

---
 osu.Game/Screens/Edit/Editor.cs | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Edit/Editor.cs b/osu.Game/Screens/Edit/Editor.cs
index b42f629aad..e26453f99a 100644
--- a/osu.Game/Screens/Edit/Editor.cs
+++ b/osu.Game/Screens/Edit/Editor.cs
@@ -574,7 +574,9 @@ namespace osu.Game.Screens.Edit
             // To update the game-wide beatmap with any changes, perform a re-fetch on exit/suspend.
             // This is required as the editor makes its local changes via EditorBeatmap
             // (which are not propagated outwards to a potentially cached WorkingBeatmap).
-            var refetchedBeatmap = beatmapManager.GetWorkingBeatmap(Beatmap.Value.BeatmapInfo);
+            ((IWorkingBeatmapCache)beatmapManager).Invalidate(Beatmap.Value.BeatmapInfo);
+            var refetchedBeatmapInfo = beatmapManager.QueryBeatmap(b => b.ID == Beatmap.Value.BeatmapInfo.ID);
+            var refetchedBeatmap = beatmapManager.GetWorkingBeatmap(refetchedBeatmapInfo);
 
             if (!(refetchedBeatmap is DummyWorkingBeatmap))
             {

From e0616476e2a0a772c5998b0194d8a0dab0ad0eb4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 26 Jan 2022 20:52:14 +0100
Subject: [PATCH 2541/5547] Fix test gameplay tests failing due to beatmap
 refetch on suspend

---
 .../Visual/Editing/TestSceneEditorTestGameplay.cs    | 12 ++++++++++--
 1 file changed, 10 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneEditorTestGameplay.cs b/osu.Game.Tests/Visual/Editing/TestSceneEditorTestGameplay.cs
index 79afc8cf27..e2406a8d27 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneEditorTestGameplay.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneEditorTestGameplay.cs
@@ -70,7 +70,11 @@ namespace osu.Game.Tests.Visual.Editing
             AddUntilStep("current screen is editor", () => Stack.CurrentScreen is Editor);
             AddUntilStep("background has correct params", () =>
             {
-                var background = this.ChildrenOfType<BackgroundScreenBeatmap>().Single();
+                // the test gameplay player's beatmap may be the "same" beatmap as the one being edited, *but* the `BeatmapInfo` references may differ
+                // due to the beatmap refetch logic ran on editor suspend.
+                // this test cares about checking the background belonging to the editor specifically, so check that using reference equality
+                // (as `.Equals()` cannot discern between the two, as they technically share the same database GUID).
+                var background = this.ChildrenOfType<BackgroundScreenBeatmap>().Single(b => ReferenceEquals(b.Beatmap.BeatmapInfo, EditorBeatmap.BeatmapInfo));
                 return background.Colour == Color4.DarkGray && background.BlurAmount.Value == 0;
             });
             AddAssert("no mods selected", () => SelectedMods.Value.Count == 0);
@@ -99,7 +103,11 @@ namespace osu.Game.Tests.Visual.Editing
             AddUntilStep("current screen is editor", () => Stack.CurrentScreen is Editor);
             AddUntilStep("background has correct params", () =>
             {
-                var background = this.ChildrenOfType<BackgroundScreenBeatmap>().Single();
+                // the test gameplay player's beatmap may be the "same" beatmap as the one being edited, *but* the `BeatmapInfo` references may differ
+                // due to the beatmap refetch logic ran on editor suspend.
+                // this test cares about checking the background belonging to the editor specifically, so check that using reference equality
+                // (as `.Equals()` cannot discern between the two, as they technically share the same database GUID).
+                var background = this.ChildrenOfType<BackgroundScreenBeatmap>().Single(b => ReferenceEquals(b.Beatmap.BeatmapInfo, EditorBeatmap.BeatmapInfo));
                 return background.Colour == Color4.DarkGray && background.BlurAmount.Value == 0;
             });
 

From 587c0f965c877ee05db77ad87762ee9c810f4366 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 27 Jan 2022 14:32:20 +0900
Subject: [PATCH 2542/5547] Add more attempts to delete EF database

Just noticed in passing. Probably best we do this since it was known to
fail on windows in some rare cases.
---
 osu.Game/Database/DatabaseContextFactory.cs | 20 +++++++++++++++++++-
 1 file changed, 19 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Database/DatabaseContextFactory.cs b/osu.Game/Database/DatabaseContextFactory.cs
index 123ed8019c..45557aa5ec 100644
--- a/osu.Game/Database/DatabaseContextFactory.cs
+++ b/osu.Game/Database/DatabaseContextFactory.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.IO;
 using System.Linq;
 using System.Threading;
@@ -163,7 +164,24 @@ namespace osu.Game.Database
 
                 try
                 {
-                    storage.Delete(DATABASE_NAME);
+                    int attempts = 10;
+
+                    // Retry logic taken from MigratableStorage.AttemptOperation.
+                    while (true)
+                    {
+                        try
+                        {
+                            storage.Delete(DATABASE_NAME);
+                            return;
+                        }
+                        catch (Exception)
+                        {
+                            if (attempts-- == 0)
+                                throw;
+                        }
+
+                        Thread.Sleep(250);
+                    }
                 }
                 catch
                 {

From deb5d75b5f21078d0877fd1ce5b75468fc896e3d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 27 Jan 2022 14:33:44 +0900
Subject: [PATCH 2543/5547] Change migration process to always delete old EF
 database

It is already backed up, so this is probably fine.
---
 osu.Game/Database/EFToRealmMigrator.cs | 44 +++++++++++++++++++++-----
 1 file changed, 36 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Database/EFToRealmMigrator.cs b/osu.Game/Database/EFToRealmMigrator.cs
index 96baad35ec..072d1c95f1 100644
--- a/osu.Game/Database/EFToRealmMigrator.cs
+++ b/osu.Game/Database/EFToRealmMigrator.cs
@@ -15,6 +15,8 @@ using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Models;
+using osu.Game.Overlays;
+using osu.Game.Overlays.Notifications;
 using osu.Game.Rulesets;
 using osu.Game.Scoring;
 using osu.Game.Skinning;
@@ -40,6 +42,12 @@ namespace osu.Game.Database
         [Resolved]
         private OsuConfigManager config { get; set; } = null!;
 
+        [Resolved]
+        private NotificationOverlay notificationOverlay { get; set; } = null!;
+
+        [Resolved]
+        private OsuGame game { get; set; } = null!;
+
         private readonly OsuSpriteText currentOperationText;
 
         public EFToRealmMigrator()
@@ -96,7 +104,11 @@ namespace osu.Game.Database
         protected override void LoadComplete()
         {
             base.LoadComplete();
+            beginMigration();
+        }
 
+        private void beginMigration()
+        {
             Task.Factory.StartNew(() =>
             {
                 using (var ef = efContextFactory.Get())
@@ -117,21 +129,37 @@ namespace osu.Game.Database
                     migrateBeatmaps(ef);
                     migrateScores(ef);
                 }
-
-                // Delete the database permanently.
-                // Will cause future startups to not attempt migration.
-                log("Migration successful, deleting EF database");
-                efContextFactory.ResetDatabase();
-
-                if (DebugUtils.IsDebugBuild)
-                    Logger.Log("Your development database has been fully migrated to realm. If you switch back to a pre-realm branch and need your previous database, rename the backup file back to \"client.db\".\n\nNote that doing this can potentially leave your file store in a bad state.", level: LogLevel.Important);
             }, TaskCreationOptions.LongRunning).ContinueWith(t =>
             {
+                if (t.Exception == null)
+                {
+                    log("Migration successful!");
+
+                    if (DebugUtils.IsDebugBuild)
+                        Logger.Log("Your development database has been fully migrated to realm. If you switch back to a pre-realm branch and need your previous database, rename the backup file back to \"client.db\".\n\nNote that doing this can potentially leave your file store in a bad state.", level: LogLevel.Important);
+                }
+                else
+                {
+                    log("Migration failed!");
+                    Logger.Log(t.Exception.ToString(), LoggingTarget.Database);
+                }
+
+                // Regardless of success, since the game is going to continue with startup let's move the ef database out of the way.
+                // If we were to not do this, the migration would run another time the next time the user starts the game.
+                deletePreRealmData();
+
                 migrationCompleted.SetResult(true);
                 efContextFactory.SetMigrationCompletion();
             });
         }
 
+        private void deletePreRealmData()
+        {
+            // Delete the database permanently.
+            // Will cause future startups to not attempt migration.
+            efContextFactory.ResetDatabase();
+        }
+
         private void log(string message)
         {
             Logger.Log(message, LoggingTarget.Database);

From b745252962b232e3bc3173491ab37495f302a56d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 27 Jan 2022 14:34:18 +0900
Subject: [PATCH 2544/5547] Show notification when migration fails to give
 users a recovery path

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

diff --git a/osu.Game/Database/EFToRealmMigrator.cs b/osu.Game/Database/EFToRealmMigrator.cs
index 072d1c95f1..d110ac2f9f 100644
--- a/osu.Game/Database/EFToRealmMigrator.cs
+++ b/osu.Game/Database/EFToRealmMigrator.cs
@@ -142,6 +142,16 @@ namespace osu.Game.Database
                 {
                     log("Migration failed!");
                     Logger.Log(t.Exception.ToString(), LoggingTarget.Database);
+
+                    notificationOverlay.Post(new SimpleErrorNotification
+                    {
+                        Text = "IMPORTANT: During data migration, some of your data could not be successfully migrated. It has been backed up in your osu! folder.\n\nFor further assistance, please open a discussion on github and attach your backup files (click to get started).",
+                        Activated = () =>
+                        {
+                            game.OpenUrlExternally(@"https://github.com/ppy/osu/discussions/new?title=Realm%20migration%20issue&body=Please%20attach%20your%20database%20backups%20by%20zipping%20them%20and%20dragging%20in%20here!&category=q-a");
+                            return true;
+                        }
+                    });
                 }
 
                 // Regardless of success, since the game is going to continue with startup let's move the ef database out of the way.

From 08948f60f3108ccfaf098be3ebe99a69ffe61c93 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 27 Jan 2022 14:39:07 +0900
Subject: [PATCH 2545/5547] Move backups to "backups" subfolder to make them
 easier to find

---
 osu.Game/OsuGameBase.cs | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/osu.Game/OsuGameBase.cs b/osu.Game/OsuGameBase.cs
index 09ca4e450d..8363c41437 100644
--- a/osu.Game/OsuGameBase.cs
+++ b/osu.Game/OsuGameBase.cs
@@ -202,16 +202,18 @@ namespace osu.Game
             // See https://github.com/ppy/osu/pull/16547 for more discussion.
             if (EFContextFactory != null)
             {
+                const string backup_folder = "backups";
+
                 string migration = $"before_final_migration_{DateTimeOffset.UtcNow.ToUnixTimeSeconds()}";
 
-                EFContextFactory.CreateBackup($"client.{migration}.db");
-                realm.CreateBackup($"client.{migration}.realm");
+                EFContextFactory.CreateBackup(Path.Combine(backup_folder, $"client.{migration}.db"));
+                realm.CreateBackup(Path.Combine(backup_folder, $"client.{migration}.realm"));
 
                 using (var source = Storage.GetStream("collection.db"))
                 {
                     if (source != null)
                     {
-                        using (var destination = Storage.GetStream($"collection.{migration}.db", FileAccess.Write, FileMode.CreateNew))
+                        using (var destination = Storage.GetStream(Path.Combine(backup_folder, $"collection.{migration}.db"), FileAccess.Write, FileMode.CreateNew))
                             source.CopyTo(destination);
                     }
                 }

From 31abb372e5c2ac123decc43f88aa8d68b5d3c2ff Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 27 Jan 2022 14:52:43 +0900
Subject: [PATCH 2546/5547] Automatically zip and show the backup archive to
 the user

---
 osu.Game/Database/EFToRealmMigrator.cs | 29 ++++++++++++++++++++++++--
 1 file changed, 27 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Database/EFToRealmMigrator.cs b/osu.Game/Database/EFToRealmMigrator.cs
index d110ac2f9f..c41461cc68 100644
--- a/osu.Game/Database/EFToRealmMigrator.cs
+++ b/osu.Game/Database/EFToRealmMigrator.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 System.Linq;
 using System.Threading.Tasks;
 using Microsoft.EntityFrameworkCore;
@@ -9,6 +10,7 @@ using osu.Framework.Development;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Logging;
+using osu.Framework.Platform;
 using osu.Game.Beatmaps;
 using osu.Game.Configuration;
 using osu.Game.Graphics;
@@ -22,6 +24,10 @@ using osu.Game.Scoring;
 using osu.Game.Skinning;
 using osuTK;
 using Realms;
+using SharpCompress.Archives;
+using SharpCompress.Archives.Zip;
+using SharpCompress.Common;
+using SharpCompress.Writers.Zip;
 
 #nullable enable
 
@@ -48,6 +54,9 @@ namespace osu.Game.Database
         [Resolved]
         private OsuGame game { get; set; } = null!;
 
+        [Resolved]
+        private Storage storage { get; set; } = null!;
+
         private readonly OsuSpriteText currentOperationText;
 
         public EFToRealmMigrator()
@@ -145,10 +154,26 @@ namespace osu.Game.Database
 
                     notificationOverlay.Post(new SimpleErrorNotification
                     {
-                        Text = "IMPORTANT: During data migration, some of your data could not be successfully migrated. It has been backed up in your osu! folder.\n\nFor further assistance, please open a discussion on github and attach your backup files (click to get started).",
+                        Text = "IMPORTANT: During data migration, some of your data could not be successfully migrated. The previous version has been backed up.\n\nFor further assistance, please open a discussion on github and attach your backup files (click to get started).",
                         Activated = () =>
                         {
-                            game.OpenUrlExternally(@"https://github.com/ppy/osu/discussions/new?title=Realm%20migration%20issue&body=Please%20attach%20your%20database%20backups%20by%20zipping%20them%20and%20dragging%20in%20here!&category=q-a");
+                            game.OpenUrlExternally(@"https://github.com/ppy/osu/discussions/new?title=Realm%20migration%20issue&body=Please%20drag%20the%20""attach_me.zip""%20file%20here!&category=q-a");
+
+                            const string attachment_filename = "attach_me.zip";
+                            const string backup_folder = "backups";
+
+                            var backupStorage = storage.GetStorageForDirectory(backup_folder);
+
+                            backupStorage.Delete(attachment_filename);
+
+                            using (var zip = ZipArchive.Create())
+                            {
+                                zip.AddAllFromDirectory(backupStorage.GetFullPath(string.Empty));
+                                zip.SaveTo(Path.Combine(backupStorage.GetFullPath(string.Empty), attachment_filename), new ZipWriterOptions(CompressionType.Deflate));
+                            }
+
+                            backupStorage.PresentFileExternally(attachment_filename);
+
                             return true;
                         }
                     });

From 465e7d29feb9529dbde477bcf384bf8ef94b2949 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 27 Jan 2022 14:53:11 +0900
Subject: [PATCH 2547/5547] Avoid showing the external link warning

---
 osu.Game/Database/EFToRealmMigrator.cs     | 2 +-
 osu.Game/Online/Chat/ExternalLinkOpener.cs | 4 ++--
 osu.Game/OsuGame.cs                        | 4 ++--
 3 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Database/EFToRealmMigrator.cs b/osu.Game/Database/EFToRealmMigrator.cs
index c41461cc68..05bc86a7c0 100644
--- a/osu.Game/Database/EFToRealmMigrator.cs
+++ b/osu.Game/Database/EFToRealmMigrator.cs
@@ -157,7 +157,7 @@ namespace osu.Game.Database
                         Text = "IMPORTANT: During data migration, some of your data could not be successfully migrated. The previous version has been backed up.\n\nFor further assistance, please open a discussion on github and attach your backup files (click to get started).",
                         Activated = () =>
                         {
-                            game.OpenUrlExternally(@"https://github.com/ppy/osu/discussions/new?title=Realm%20migration%20issue&body=Please%20drag%20the%20""attach_me.zip""%20file%20here!&category=q-a");
+                            game.OpenUrlExternally(@"https://github.com/ppy/osu/discussions/new?title=Realm%20migration%20issue&body=Please%20drag%20the%20""attach_me.zip""%20file%20here!&category=q-a", true);
 
                             const string attachment_filename = "attach_me.zip";
                             const string backup_folder = "backups";
diff --git a/osu.Game/Online/Chat/ExternalLinkOpener.cs b/osu.Game/Online/Chat/ExternalLinkOpener.cs
index 8407e2ca6a..328b43c4e8 100644
--- a/osu.Game/Online/Chat/ExternalLinkOpener.cs
+++ b/osu.Game/Online/Chat/ExternalLinkOpener.cs
@@ -27,9 +27,9 @@ namespace osu.Game.Online.Chat
             externalLinkWarning = config.GetBindable<bool>(OsuSetting.ExternalLinkWarning);
         }
 
-        public void OpenUrlExternally(string url)
+        public void OpenUrlExternally(string url, bool bypassWarning = false)
         {
-            if (externalLinkWarning.Value)
+            if (!bypassWarning && externalLinkWarning.Value)
                 dialogOverlay.Push(new ExternalLinkDialog(url, () => host.OpenUrlExternally(url)));
             else
                 host.OpenUrlExternally(url);
diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index c2e1b25d94..5b58dec0c3 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -357,12 +357,12 @@ namespace osu.Game
             }
         });
 
-        public void OpenUrlExternally(string url) => waitForReady(() => externalLinkOpener, _ =>
+        public void OpenUrlExternally(string url, bool bypassExternalUrlWarning = false) => waitForReady(() => externalLinkOpener, _ =>
         {
             if (url.StartsWith('/'))
                 url = $"{API.APIEndpointUrl}{url}";
 
-            externalLinkOpener.OpenUrlExternally(url);
+            externalLinkOpener.OpenUrlExternally(url, bypassExternalUrlWarning);
         });
 
         /// <summary>

From fb081384e13ca4a09bee571636021ea0ce894dc2 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 27 Jan 2022 14:55:52 +0900
Subject: [PATCH 2548/5547] Add safety against zip creation potentially failing
 (probably can't but still)

---
 osu.Game/Database/EFToRealmMigrator.cs | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Database/EFToRealmMigrator.cs b/osu.Game/Database/EFToRealmMigrator.cs
index 05bc86a7c0..723b3eeada 100644
--- a/osu.Game/Database/EFToRealmMigrator.cs
+++ b/osu.Game/Database/EFToRealmMigrator.cs
@@ -166,11 +166,15 @@ namespace osu.Game.Database
 
                             backupStorage.Delete(attachment_filename);
 
-                            using (var zip = ZipArchive.Create())
+                            try
                             {
-                                zip.AddAllFromDirectory(backupStorage.GetFullPath(string.Empty));
-                                zip.SaveTo(Path.Combine(backupStorage.GetFullPath(string.Empty), attachment_filename), new ZipWriterOptions(CompressionType.Deflate));
+                                using (var zip = ZipArchive.Create())
+                                {
+                                    zip.AddAllFromDirectory(backupStorage.GetFullPath(string.Empty));
+                                    zip.SaveTo(Path.Combine(backupStorage.GetFullPath(string.Empty), attachment_filename), new ZipWriterOptions(CompressionType.Deflate));
+                                }
                             }
+                            catch { }
 
                             backupStorage.PresentFileExternally(attachment_filename);
 

From 67ccb879926f309f3b2d3dbd3bc31a2a8760b05e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 27 Jan 2022 14:56:04 +0900
Subject: [PATCH 2549/5547] Add exception message to discussion template url

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

diff --git a/osu.Game/Database/EFToRealmMigrator.cs b/osu.Game/Database/EFToRealmMigrator.cs
index 723b3eeada..639bf10e19 100644
--- a/osu.Game/Database/EFToRealmMigrator.cs
+++ b/osu.Game/Database/EFToRealmMigrator.cs
@@ -157,7 +157,7 @@ namespace osu.Game.Database
                         Text = "IMPORTANT: During data migration, some of your data could not be successfully migrated. The previous version has been backed up.\n\nFor further assistance, please open a discussion on github and attach your backup files (click to get started).",
                         Activated = () =>
                         {
-                            game.OpenUrlExternally(@"https://github.com/ppy/osu/discussions/new?title=Realm%20migration%20issue&body=Please%20drag%20the%20""attach_me.zip""%20file%20here!&category=q-a", true);
+                            game.OpenUrlExternally($@"https://github.com/ppy/osu/discussions/new?title=Realm%20migration%20issue ({t.Exception.Message})&body=Please%20drag%20the%20""attach_me.zip""%20file%20here!&category=q-a", true);
 
                             const string attachment_filename = "attach_me.zip";
                             const string backup_folder = "backups";

From f30d63107a73c1a4f059366a12483f086e26c22f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 27 Jan 2022 15:19:27 +0900
Subject: [PATCH 2550/5547] Add `SortID` to `RulesetInfo` to allow stable
 ordering of rulesets for display

---
 .../NonVisual/RulesetInfoOrderingTest.cs      | 38 +++++++++++++++++++
 osu.Game/Rulesets/RulesetInfo.cs              |  5 +++
 osu.Game/Rulesets/RulesetStore.cs             |  5 +--
 .../Select/Carousel/CarouselBeatmap.cs        |  2 +-
 .../Select/Carousel/CarouselBeatmapSet.cs     |  2 +-
 5 files changed, 46 insertions(+), 6 deletions(-)
 create mode 100644 osu.Game.Tests/NonVisual/RulesetInfoOrderingTest.cs

diff --git a/osu.Game.Tests/NonVisual/RulesetInfoOrderingTest.cs b/osu.Game.Tests/NonVisual/RulesetInfoOrderingTest.cs
new file mode 100644
index 0000000000..e7c04d27c1
--- /dev/null
+++ b/osu.Game.Tests/NonVisual/RulesetInfoOrderingTest.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.Linq;
+using NUnit.Framework;
+using osu.Game.Rulesets;
+using osu.Game.Rulesets.Catch;
+using osu.Game.Rulesets.Osu;
+
+namespace osu.Game.Tests.NonVisual
+{
+    [TestFixture]
+    public class RulesetInfoOrderingTest
+    {
+        [Test]
+        public void TestOrdering()
+        {
+            var rulesets = new[]
+            {
+                new RulesetInfo("custom2", "Custom Ruleset 2", string.Empty, -1),
+                new OsuRuleset().RulesetInfo,
+                new RulesetInfo("custom3", "Custom Ruleset 3", string.Empty, -1),
+                new RulesetInfo("custom2", "Custom Ruleset 2", string.Empty, -1),
+                new CatchRuleset().RulesetInfo,
+                new RulesetInfo("custom3", "Custom Ruleset 3", string.Empty, -1),
+            };
+
+            var orderedRulesets = rulesets.OrderBy(r => r.SortID);
+
+            // Ensure all customs are after official.
+            Assert.That(orderedRulesets.Select(r => r.OnlineID), Is.EqualTo(new[] { 0, 2, -1, -1, -1, -1 }));
+
+            // Ensure customs are grouped next to each other (ie. stably sorted).
+            Assert.That(orderedRulesets.SkipWhile(r => r.ShortName != "custom2").Skip(1).First().ShortName, Is.EqualTo("custom2"));
+            Assert.That(orderedRulesets.SkipWhile(r => r.ShortName != "custom3").Skip(1).First().ShortName, Is.EqualTo("custom3"));
+        }
+    }
+}
diff --git a/osu.Game/Rulesets/RulesetInfo.cs b/osu.Game/Rulesets/RulesetInfo.cs
index 2e2ec5c024..d721926e95 100644
--- a/osu.Game/Rulesets/RulesetInfo.cs
+++ b/osu.Game/Rulesets/RulesetInfo.cs
@@ -24,6 +24,11 @@ namespace osu.Game.Rulesets
 
         public string InstantiationInfo { get; set; } = string.Empty;
 
+        /// <summary>
+        /// A best effort sort ID which provides stable ordering and puts online rulesets before non-online rulesets.
+        /// </summary>
+        public int SortID => OnlineID >= 0 ? OnlineID : Math.Abs(ShortName.GetHashCode());
+
         public RulesetInfo(string shortName, string name, string instantiationInfo, int onlineID)
         {
             ShortName = shortName;
diff --git a/osu.Game/Rulesets/RulesetStore.cs b/osu.Game/Rulesets/RulesetStore.cs
index 0f518be639..a9fd8f430e 100644
--- a/osu.Game/Rulesets/RulesetStore.cs
+++ b/osu.Game/Rulesets/RulesetStore.cs
@@ -163,10 +163,7 @@ namespace osu.Game.Rulesets
                     }
                 }
 
-                // add known official rulesets first..
-                availableRulesets.AddRange(detachedRulesets.Where(r => r.OnlineID >= 0).OrderBy(r => r.OnlineID));
-                // .. then add any customs
-                availableRulesets.AddRange(detachedRulesets.Where(r => r.OnlineID < 0).OrderBy(r => r.ShortName));
+                availableRulesets.AddRange(detachedRulesets.OrderBy(r => r.SortID));
             });
         }
 
diff --git a/osu.Game/Screens/Select/Carousel/CarouselBeatmap.cs b/osu.Game/Screens/Select/Carousel/CarouselBeatmap.cs
index e6dee0233f..9d49fdaf6e 100644
--- a/osu.Game/Screens/Select/Carousel/CarouselBeatmap.cs
+++ b/osu.Game/Screens/Select/Carousel/CarouselBeatmap.cs
@@ -89,7 +89,7 @@ namespace osu.Game.Screens.Select.Carousel
             {
                 default:
                 case SortMode.Difficulty:
-                    int ruleset = BeatmapInfo.RulesetID.CompareTo(otherBeatmap.BeatmapInfo.RulesetID);
+                    int ruleset = BeatmapInfo.Ruleset.SortID.CompareTo(otherBeatmap.BeatmapInfo.Ruleset.SortID);
                     if (ruleset != 0) return ruleset;
 
                     return BeatmapInfo.StarRating.CompareTo(otherBeatmap.BeatmapInfo.StarRating);
diff --git a/osu.Game/Screens/Select/Carousel/CarouselBeatmapSet.cs b/osu.Game/Screens/Select/Carousel/CarouselBeatmapSet.cs
index b2b3b5411c..274be7b73a 100644
--- a/osu.Game/Screens/Select/Carousel/CarouselBeatmapSet.cs
+++ b/osu.Game/Screens/Select/Carousel/CarouselBeatmapSet.cs
@@ -39,7 +39,7 @@ namespace osu.Game.Screens.Select.Carousel
 
             beatmapSet.Beatmaps
                       .Where(b => !b.Hidden)
-                      .OrderBy(b => b.RulesetID)
+                      .OrderBy(b => b.Ruleset.SortID)
                       .ThenBy(b => b.StarRating)
                       .Select(b => new CarouselBeatmap(b))
                       .ForEach(AddChild);

From e67b1fe0ec9c50b7ddb429edb2ee13d534e881ad Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 27 Jan 2022 15:25:56 +0900
Subject: [PATCH 2551/5547] Make `Ruleset.RulesetInfo` get only

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

diff --git a/osu.Game/Rulesets/Ruleset.cs b/osu.Game/Rulesets/Ruleset.cs
index d279f6d6ee..616540b59c 100644
--- a/osu.Game/Rulesets/Ruleset.cs
+++ b/osu.Game/Rulesets/Ruleset.cs
@@ -37,7 +37,7 @@ namespace osu.Game.Rulesets
     [ExcludeFromDynamicCompile]
     public abstract class Ruleset
     {
-        public RulesetInfo RulesetInfo { get; internal set; }
+        public RulesetInfo RulesetInfo { get; }
 
         private static readonly ConcurrentDictionary<string, IMod[]> mod_reference_cache = new ConcurrentDictionary<string, IMod[]>();
 

From 714177cce13a86d3665d1685831da3a1e30c7382 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 27 Jan 2022 15:23:16 +0900
Subject: [PATCH 2552/5547] Remove pointless constructor in `RulesetInfo`

---
 osu.Game.Tests/Database/RealmTest.cs | 2 +-
 osu.Game/Rulesets/RulesetInfo.cs     | 8 --------
 2 files changed, 1 insertion(+), 9 deletions(-)

diff --git a/osu.Game.Tests/Database/RealmTest.cs b/osu.Game.Tests/Database/RealmTest.cs
index c2339dd9ad..838759c991 100644
--- a/osu.Game.Tests/Database/RealmTest.cs
+++ b/osu.Game.Tests/Database/RealmTest.cs
@@ -114,7 +114,7 @@ namespace osu.Game.Tests.Database
         }
 
         protected static RulesetInfo CreateRuleset() =>
-            new RulesetInfo(0, "osu!", "osu", true);
+            new RulesetInfo("osu", "osu!", string.Empty, 0) { Available = true };
 
         private class RealmTestGame : Framework.Game
         {
diff --git a/osu.Game/Rulesets/RulesetInfo.cs b/osu.Game/Rulesets/RulesetInfo.cs
index 2e2ec5c024..5171f0d63c 100644
--- a/osu.Game/Rulesets/RulesetInfo.cs
+++ b/osu.Game/Rulesets/RulesetInfo.cs
@@ -37,14 +37,6 @@ namespace osu.Game.Rulesets
         {
         }
 
-        public RulesetInfo(int? onlineID, string name, string shortName, bool available)
-        {
-            OnlineID = onlineID ?? -1;
-            Name = name;
-            ShortName = shortName;
-            Available = available;
-        }
-
         public bool Available { get; set; }
 
         public bool Equals(RulesetInfo? other)

From 5288eedd311feabd82cebf1ddf19336557197016 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 27 Jan 2022 15:19:48 +0900
Subject: [PATCH 2553/5547] Update all usages of `RulesetID` and `Ruleset.ID`
 to use `Ruleset.OnlineID`

---
 .../ManiaFilterCriteria.cs                    |  2 +-
 .../Beatmaps/TaikoBeatmapConverter.cs         |  2 +-
 .../Formats/LegacyBeatmapDecoderTest.cs       |  2 +-
 .../Formats/LegacyBeatmapEncoderTest.cs       |  2 +-
 .../Beatmaps/Formats/OsuJsonDecoderTest.cs    |  2 +-
 .../Editing/TestSceneDifficultySwitching.cs   |  4 +-
 .../Editing/TestSceneEditorTestGameplay.cs    |  2 +-
 .../TestScenePlayerScoreSubmission.cs         |  4 +-
 .../Visual/Gameplay/TestSceneSpectator.cs     |  2 +-
 .../Visual/Multiplayer/QueueModeTestScene.cs  |  4 +-
 .../TestSceneMultiSpectatorScreen.cs          |  2 +-
 .../Multiplayer/TestSceneMultiplayer.cs       | 48 +++++++++----------
 .../TestSceneMultiplayerMatchSongSelect.cs    |  4 +-
 .../TestSceneMultiplayerPlaylist.cs           |  2 +-
 .../TestSceneMultiplayerQueueList.cs          |  2 +-
 .../Visual/Multiplayer/TestSceneTeamVersus.cs |  8 ++--
 .../SongSelect/TestSceneBeatmapCarousel.cs    |  2 +-
 .../SongSelect/TestScenePlaySongSelect.cs     | 26 +++++-----
 .../Components/TournamentModIcon.cs           |  2 +-
 osu.Game/Beatmaps/BeatmapInfo.cs              |  1 -
 osu.Game/Beatmaps/FlatFileWorkingBeatmap.cs   |  2 +-
 .../Beatmaps/Formats/LegacyBeatmapDecoder.cs  |  8 ++--
 .../Beatmaps/Formats/LegacyBeatmapEncoder.cs  | 18 ++++---
 osu.Game/Rulesets/RulesetInfo.cs              |  6 ---
 osu.Game/Scoring/Legacy/LegacyScoreEncoder.cs |  2 +-
 osu.Game/Screens/Edit/Editor.cs               |  4 +-
 .../Select/Carousel/CarouselBeatmap.cs        |  2 +-
 .../Select/Leaderboards/BeatmapLeaderboard.cs |  2 +-
 osu.Game/Screens/Select/SongSelect.cs         |  2 +-
 osu.Game/Stores/BeatmapImporter.cs            |  4 +-
 .../Tests/Beatmaps/BeatmapConversionTest.cs   |  2 +-
 .../Tests/Beatmaps/HitObjectSampleTest.cs     |  2 +-
 osu.Game/Tests/Visual/OsuTestScene.cs         |  2 +-
 33 files changed, 89 insertions(+), 90 deletions(-)

diff --git a/osu.Game.Rulesets.Mania/ManiaFilterCriteria.cs b/osu.Game.Rulesets.Mania/ManiaFilterCriteria.cs
index 0290230490..c8832dfdfb 100644
--- a/osu.Game.Rulesets.Mania/ManiaFilterCriteria.cs
+++ b/osu.Game.Rulesets.Mania/ManiaFilterCriteria.cs
@@ -15,7 +15,7 @@ namespace osu.Game.Rulesets.Mania
 
         public bool Matches(BeatmapInfo beatmapInfo)
         {
-            return !keys.HasFilter || (beatmapInfo.RulesetID == new ManiaRuleset().LegacyID && keys.IsInRange(ManiaBeatmapConverter.GetColumnCountForNonConvert(beatmapInfo)));
+            return !keys.HasFilter || (beatmapInfo.Ruleset.OnlineID == new ManiaRuleset().LegacyID && keys.IsInRange(ManiaBeatmapConverter.GetColumnCountForNonConvert(beatmapInfo)));
         }
 
         public bool TryParseCustomKeywordCriteria(string key, Operator op, string value)
diff --git a/osu.Game.Rulesets.Taiko/Beatmaps/TaikoBeatmapConverter.cs b/osu.Game.Rulesets.Taiko/Beatmaps/TaikoBeatmapConverter.cs
index 613874b7d6..b1d8575de4 100644
--- a/osu.Game.Rulesets.Taiko/Beatmaps/TaikoBeatmapConverter.cs
+++ b/osu.Game.Rulesets.Taiko/Beatmaps/TaikoBeatmapConverter.cs
@@ -55,7 +55,7 @@ namespace osu.Game.Rulesets.Taiko.Beatmaps
 
             Beatmap<TaikoHitObject> converted = base.ConvertBeatmap(original, cancellationToken);
 
-            if (original.BeatmapInfo.RulesetID == 3)
+            if (original.BeatmapInfo.Ruleset.OnlineID == 3)
             {
                 // Post processing step to transform mania hit objects with the same start time into strong hits
                 converted.HitObjects = converted.HitObjects.GroupBy(t => t.StartTime).Select(x =>
diff --git a/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs b/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs
index 0459753b28..1edd21b5a9 100644
--- a/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs
+++ b/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs
@@ -60,7 +60,7 @@ namespace osu.Game.Tests.Beatmaps.Formats
                 Assert.AreEqual(0, beatmapInfo.AudioLeadIn);
                 Assert.AreEqual(164471, metadata.PreviewTime);
                 Assert.AreEqual(0.7f, beatmapInfo.StackLeniency);
-                Assert.IsTrue(beatmapInfo.RulesetID == 0);
+                Assert.IsTrue(beatmapInfo.Ruleset.OnlineID == 0);
                 Assert.IsFalse(beatmapInfo.LetterboxInBreaks);
                 Assert.IsFalse(beatmapInfo.SpecialStyle);
                 Assert.IsFalse(beatmapInfo.WidescreenStoryboard);
diff --git a/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapEncoderTest.cs b/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapEncoderTest.cs
index d12da1a22f..d19b3c71f1 100644
--- a/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapEncoderTest.cs
+++ b/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapEncoderTest.cs
@@ -195,7 +195,7 @@ namespace osu.Game.Tests.Beatmaps.Formats
 
         private IBeatmap convert(IBeatmap beatmap)
         {
-            switch (beatmap.BeatmapInfo.RulesetID)
+            switch (beatmap.BeatmapInfo.Ruleset.OnlineID)
             {
                 case 0:
                     beatmap.BeatmapInfo.Ruleset = new OsuRuleset().RulesetInfo;
diff --git a/osu.Game.Tests/Beatmaps/Formats/OsuJsonDecoderTest.cs b/osu.Game.Tests/Beatmaps/Formats/OsuJsonDecoderTest.cs
index 06ed638e0a..2eb75259d9 100644
--- a/osu.Game.Tests/Beatmaps/Formats/OsuJsonDecoderTest.cs
+++ b/osu.Game.Tests/Beatmaps/Formats/OsuJsonDecoderTest.cs
@@ -52,7 +52,7 @@ namespace osu.Game.Tests.Beatmaps.Formats
             Assert.AreEqual(0, beatmapInfo.AudioLeadIn);
             Assert.AreEqual(0.7f, beatmapInfo.StackLeniency);
             Assert.AreEqual(false, beatmapInfo.SpecialStyle);
-            Assert.IsTrue(beatmapInfo.RulesetID == 0);
+            Assert.IsTrue(beatmapInfo.Ruleset.OnlineID == 0);
             Assert.AreEqual(false, beatmapInfo.LetterboxInBreaks);
             Assert.AreEqual(false, beatmapInfo.WidescreenStoryboard);
             Assert.AreEqual(CountdownType.None, beatmapInfo.Countdown);
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneDifficultySwitching.cs b/osu.Game.Tests/Visual/Editing/TestSceneDifficultySwitching.cs
index cf6488f721..81cb286058 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneDifficultySwitching.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneDifficultySwitching.cs
@@ -82,8 +82,8 @@ namespace osu.Game.Tests.Visual.Editing
             AddStep("set target difficulty", () =>
             {
                 targetDifficulty = sameRuleset
-                    ? importedBeatmapSet.Beatmaps.Last(beatmap => !beatmap.Equals(Beatmap.Value.BeatmapInfo) && beatmap.RulesetID == Beatmap.Value.BeatmapInfo.RulesetID)
-                    : importedBeatmapSet.Beatmaps.Last(beatmap => !beatmap.Equals(Beatmap.Value.BeatmapInfo) && beatmap.RulesetID != Beatmap.Value.BeatmapInfo.RulesetID);
+                    ? importedBeatmapSet.Beatmaps.Last(beatmap => !beatmap.Equals(Beatmap.Value.BeatmapInfo) && beatmap.Ruleset.ShortName == Beatmap.Value.BeatmapInfo.Ruleset.ShortName)
+                    : importedBeatmapSet.Beatmaps.Last(beatmap => !beatmap.Equals(Beatmap.Value.BeatmapInfo) && beatmap.Ruleset.ShortName != Beatmap.Value.BeatmapInfo.Ruleset.ShortName);
             });
             switchToDifficulty(() => targetDifficulty);
             confirmEditingBeatmap(() => targetDifficulty);
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneEditorTestGameplay.cs b/osu.Game.Tests/Visual/Editing/TestSceneEditorTestGameplay.cs
index 79afc8cf27..2b827bee74 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneEditorTestGameplay.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneEditorTestGameplay.cs
@@ -45,7 +45,7 @@ namespace osu.Game.Tests.Visual.Editing
         }
 
         protected override WorkingBeatmap CreateWorkingBeatmap(IBeatmap beatmap, Storyboard storyboard = null)
-            => beatmaps.GetWorkingBeatmap(importedBeatmapSet.Beatmaps.First(b => b.RulesetID == 0));
+            => beatmaps.GetWorkingBeatmap(importedBeatmapSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0));
 
         protected override void LoadEditor()
         {
diff --git a/osu.Game.Tests/Visual/Gameplay/TestScenePlayerScoreSubmission.cs b/osu.Game.Tests/Visual/Gameplay/TestScenePlayerScoreSubmission.cs
index a4a4f351ec..a9675a2ee2 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestScenePlayerScoreSubmission.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestScenePlayerScoreSubmission.cs
@@ -110,7 +110,7 @@ namespace osu.Game.Tests.Visual.Gameplay
 
             AddUntilStep("results displayed", () => Player.GetChildScreen() is ResultsScreen);
             AddAssert("ensure passing submission", () => Player.SubmittedScore?.ScoreInfo.Passed == true);
-            AddAssert("submitted score has correct ruleset ID", () => Player.SubmittedScore?.ScoreInfo.RulesetID == new TaikoRuleset().RulesetInfo.ID);
+            AddAssert("submitted score has correct ruleset ID", () => Player.SubmittedScore?.ScoreInfo.Ruleset.ShortName == new TaikoRuleset().RulesetInfo.ShortName);
         }
 
         [Test]
@@ -130,7 +130,7 @@ namespace osu.Game.Tests.Visual.Gameplay
 
             AddUntilStep("results displayed", () => Player.GetChildScreen() is ResultsScreen);
             AddAssert("ensure passing submission", () => Player.SubmittedScore?.ScoreInfo.Passed == true);
-            AddAssert("submitted score has correct ruleset ID", () => Player.SubmittedScore?.ScoreInfo.RulesetID == new ManiaRuleset().RulesetInfo.ID);
+            AddAssert("submitted score has correct ruleset ID", () => Player.SubmittedScore?.ScoreInfo.Ruleset.ShortName == new ManiaRuleset().RulesetInfo.ShortName);
         }
 
         [Test]
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs
index 8b7e1a1d85..0afd2c76dd 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs
@@ -62,7 +62,7 @@ namespace osu.Game.Tests.Visual.Gameplay
             AddStep("import beatmap", () =>
             {
                 importedBeatmap = BeatmapImportHelper.LoadOszIntoOsu(game, virtualTrack: true).GetResultSafely();
-                importedBeatmapId = importedBeatmap.Beatmaps.First(b => b.RulesetID == 0).OnlineID;
+                importedBeatmapId = importedBeatmap.Beatmaps.First(b => b.Ruleset.OnlineID == 0).OnlineID;
             });
         }
 
diff --git a/osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs b/osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs
index 4cd19b53a4..c79395b343 100644
--- a/osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs
@@ -60,8 +60,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
             {
                 beatmaps.Import(TestResources.GetQuickTestBeatmapForImport()).WaitSafely();
                 importedSet = beatmaps.GetAllUsableBeatmapSets().First();
-                InitialBeatmap = importedSet.Beatmaps.First(b => b.RulesetID == 0);
-                OtherBeatmap = importedSet.Beatmaps.Last(b => b.RulesetID == 0);
+                InitialBeatmap = importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0);
+                OtherBeatmap = importedSet.Beatmaps.Last(b => b.Ruleset.OnlineID == 0);
             });
 
             AddStep("load multiplayer", () => LoadScreen(multiplayerComponents = new TestMultiplayerComponents()));
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs
index 9d67742e4d..b84f7760e4 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs
@@ -48,7 +48,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         private void load()
         {
             importedSet = BeatmapImportHelper.LoadOszIntoOsu(game, virtualTrack: true).GetResultSafely();
-            importedBeatmap = importedSet.Beatmaps.First(b => b.RulesetID == 0);
+            importedBeatmap = importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0);
             importedBeatmapId = importedBeatmap.OnlineID;
         }
 
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
index 3f151a0ae8..3563869d8b 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
@@ -98,7 +98,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 {
                     new PlaylistItem
                     {
-                        Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.RulesetID == 0)).BeatmapInfo },
+                        Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo },
                         Ruleset = { Value = new OsuRuleset().RulesetInfo },
                     }
                 }
@@ -234,7 +234,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 {
                     new PlaylistItem
                     {
-                        Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.RulesetID == 0)).BeatmapInfo },
+                        Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo },
                         Ruleset = { Value = new OsuRuleset().RulesetInfo },
                     }
                 }
@@ -256,7 +256,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     {
                         new PlaylistItem
                         {
-                            Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.RulesetID == 0)).BeatmapInfo },
+                            Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo },
                             Ruleset = { Value = new OsuRuleset().RulesetInfo },
                         }
                     }
@@ -286,7 +286,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     {
                         new PlaylistItem
                         {
-                            Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.RulesetID == 0)).BeatmapInfo },
+                            Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo },
                             Ruleset = { Value = new OsuRuleset().RulesetInfo },
                         }
                     }
@@ -317,7 +317,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 {
                     new PlaylistItem
                     {
-                        Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.RulesetID == 0)).BeatmapInfo },
+                        Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo },
                         Ruleset = { Value = new OsuRuleset().RulesetInfo },
                     }
                 }
@@ -339,7 +339,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     {
                         new PlaylistItem
                         {
-                            Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.RulesetID == 0)).BeatmapInfo },
+                            Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo },
                             Ruleset = { Value = new OsuRuleset().RulesetInfo },
                         }
                     }
@@ -372,7 +372,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 {
                     new PlaylistItem
                     {
-                        Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.RulesetID == 0)).BeatmapInfo },
+                        Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo },
                         Ruleset = { Value = new OsuRuleset().RulesetInfo },
                     }
                 }
@@ -392,7 +392,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 {
                     new PlaylistItem
                     {
-                        Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.RulesetID == 0)).BeatmapInfo },
+                        Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo },
                         Ruleset = { Value = new OsuRuleset().RulesetInfo },
                     }
                 }
@@ -414,7 +414,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 {
                     new PlaylistItem
                     {
-                        Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.RulesetID == 0)).BeatmapInfo },
+                        Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo },
                         Ruleset = { Value = new OsuRuleset().RulesetInfo },
                     }
                 }
@@ -453,7 +453,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 {
                     new PlaylistItem
                     {
-                        Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.RulesetID == 0)).BeatmapInfo },
+                        Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo },
                         Ruleset = { Value = new OsuRuleset().RulesetInfo },
                     }
                 }
@@ -492,7 +492,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 {
                     new PlaylistItem
                     {
-                        Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.RulesetID == 0)).BeatmapInfo },
+                        Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo },
                         Ruleset = { Value = new OsuRuleset().RulesetInfo },
                     }
                 }
@@ -531,7 +531,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 {
                     new PlaylistItem
                     {
-                        Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.RulesetID == 0)).BeatmapInfo },
+                        Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo },
                         Ruleset = { Value = new OsuRuleset().RulesetInfo },
                     }
                 }
@@ -565,7 +565,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 {
                     new PlaylistItem
                     {
-                        Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.RulesetID == 0)).BeatmapInfo },
+                        Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo },
                         Ruleset = { Value = new OsuRuleset().RulesetInfo },
                     }
                 }
@@ -605,7 +605,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 {
                     new PlaylistItem
                     {
-                        Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.RulesetID == 0)).BeatmapInfo },
+                        Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo },
                         Ruleset = { Value = new OsuRuleset().RulesetInfo },
                     }
                 }
@@ -625,7 +625,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 {
                     new PlaylistItem
                     {
-                        Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.RulesetID == 0)).BeatmapInfo },
+                        Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo },
                         Ruleset = { Value = new OsuRuleset().RulesetInfo },
                         AllowedMods = { new OsuModHidden() }
                     }
@@ -665,7 +665,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 {
                     new PlaylistItem
                     {
-                        Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.RulesetID == 0)).BeatmapInfo },
+                        Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo },
                         Ruleset = { Value = new OsuRuleset().RulesetInfo },
                     }
                 }
@@ -696,7 +696,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     {
                         new PlaylistItem
                         {
-                            Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.RulesetID == 0)).BeatmapInfo },
+                            Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo },
                             Ruleset = { Value = new OsuRuleset().RulesetInfo },
                         }
                     }
@@ -714,7 +714,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 roomManager.ServerSideRooms[0].Playlist.Add(new PlaylistItem
                 {
                     ID = 2,
-                    Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.RulesetID == 0)).BeatmapInfo },
+                    Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo },
                     Ruleset = { Value = new OsuRuleset().RulesetInfo },
                 });
             });
@@ -742,7 +742,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 {
                     new PlaylistItem
                     {
-                        Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.RulesetID == 0)).BeatmapInfo },
+                        Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo },
                         Ruleset = { Value = new OsuRuleset().RulesetInfo },
                     }
                 }
@@ -778,7 +778,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 {
                     new PlaylistItem
                     {
-                        Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.RulesetID == 0)).BeatmapInfo },
+                        Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo },
                         Ruleset = { Value = new OsuRuleset().RulesetInfo },
                     }
                 }
@@ -817,7 +817,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 {
                     new PlaylistItem
                     {
-                        Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.RulesetID == 0)).BeatmapInfo },
+                        Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo },
                         Ruleset = { Value = new OsuRuleset().RulesetInfo },
                     }
                 }
@@ -828,7 +828,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddStep("join other user", () => client.AddUser(new APIUser { Id = 1234 }));
             AddStep("add item as other user", () => client.AddUserPlaylistItem(1234, new MultiplayerPlaylistItem(new PlaylistItem
             {
-                BeatmapID = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.RulesetID == 0)).BeatmapInfo.OnlineID
+                BeatmapID = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo.OnlineID
             })));
 
             AddUntilStep("item arrived in playlist", () => client.Room?.Playlist.Count == 2);
@@ -848,7 +848,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 {
                     new PlaylistItem
                     {
-                        Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.RulesetID == 0)).BeatmapInfo },
+                        Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo },
                         Ruleset = { Value = new OsuRuleset().RulesetInfo },
                     }
                 }
@@ -859,7 +859,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddStep("join other user", () => client.AddUser(new APIUser { Id = 1234 }));
             AddStep("add item as other user", () => client.AddUserPlaylistItem(1234, new MultiplayerPlaylistItem(new PlaylistItem
             {
-                BeatmapID = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.RulesetID == 0)).BeatmapInfo.OnlineID
+                BeatmapID = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo.OnlineID
             })));
 
             AddUntilStep("item arrived in playlist", () => client.Room?.Playlist.Count == 2);
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs
index 5465061891..457b53ae61 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs
@@ -107,7 +107,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             BeatmapInfo selectedBeatmap = null;
 
             AddStep("select beatmap",
-                () => songSelect.Carousel.SelectBeatmap(selectedBeatmap = beatmaps.Where(beatmap => beatmap.RulesetID == new OsuRuleset().LegacyID).ElementAt(1)));
+                () => songSelect.Carousel.SelectBeatmap(selectedBeatmap = beatmaps.Where(beatmap => beatmap.Ruleset.OnlineID == new OsuRuleset().LegacyID).ElementAt(1)));
             AddUntilStep("wait for selection", () => Beatmap.Value.BeatmapInfo.Equals(selectedBeatmap));
 
             AddStep("exit song select", () => songSelect.Exit());
@@ -139,7 +139,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             AddStep("change ruleset", () => Ruleset.Value = new TaikoRuleset().RulesetInfo);
             AddStep("select beatmap",
-                () => songSelect.Carousel.SelectBeatmap(selectedBeatmap = beatmaps.First(beatmap => beatmap.RulesetID == new TaikoRuleset().LegacyID)));
+                () => songSelect.Carousel.SelectBeatmap(selectedBeatmap = beatmaps.First(beatmap => beatmap.Ruleset.OnlineID == new TaikoRuleset().LegacyID)));
             AddUntilStep("wait for selection", () => Beatmap.Value.BeatmapInfo.Equals(selectedBeatmap));
             AddStep("set mods", () => SelectedMods.Value = new[] { new TaikoModDoubleTime() });
 
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs
index d970ab6c34..936798e6b4 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs
@@ -57,7 +57,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             {
                 beatmaps.Import(TestResources.GetQuickTestBeatmapForImport()).WaitSafely();
                 importedSet = beatmaps.GetAllUsableBeatmapSets().First();
-                importedBeatmap = importedSet.Beatmaps.First(b => b.RulesetID == 0);
+                importedBeatmap = importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0);
             });
 
             AddStep("change to all players mode", () => Client.ChangeSettings(new MultiplayerRoomSettings { QueueMode = QueueMode.AllPlayers }));
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs
index d83421ee3a..ddf794b437 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs
@@ -62,7 +62,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             {
                 beatmaps.Import(TestResources.GetQuickTestBeatmapForImport()).WaitSafely();
                 importedSet = beatmaps.GetAllUsableBeatmapSets().First();
-                importedBeatmap = importedSet.Beatmaps.First(b => b.RulesetID == 0);
+                importedBeatmap = importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0);
             });
 
             AddStep("change to all players mode", () => Client.ChangeSettings(new MultiplayerRoomSettings { QueueMode = QueueMode.AllPlayers }));
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs
index 73c67d26d9..781f0a1824 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs
@@ -73,7 +73,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 {
                     new PlaylistItem
                     {
-                        Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.RulesetID == 0)).BeatmapInfo },
+                        Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo },
                         Ruleset = { Value = new OsuRuleset().RulesetInfo },
                     }
                 }
@@ -94,7 +94,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 {
                     new PlaylistItem
                     {
-                        Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.RulesetID == 0)).BeatmapInfo },
+                        Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo },
                         Ruleset = { Value = new OsuRuleset().RulesetInfo },
                     }
                 }
@@ -132,7 +132,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 {
                     new PlaylistItem
                     {
-                        Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.RulesetID == 0)).BeatmapInfo },
+                        Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo },
                         Ruleset = { Value = new OsuRuleset().RulesetInfo },
                     }
                 }
@@ -158,7 +158,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 {
                     new PlaylistItem
                     {
-                        Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.RulesetID == 0)).BeatmapInfo },
+                        Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo },
                         Ruleset = { Value = new OsuRuleset().RulesetInfo },
                     }
                 }
diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs
index 0298c3bea9..830631ebad 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs
@@ -586,7 +586,7 @@ namespace osu.Game.Tests.Visual.SongSelect
             AddStep("filter to ruleset 0", () =>
                 carousel.Filter(new FilterCriteria { Ruleset = rulesets.AvailableRulesets.ElementAt(0) }, false));
             AddStep("select filtered map skipping filtered", () => carousel.SelectBeatmap(testMixed.Beatmaps[1], false));
-            AddAssert("unfiltered beatmap not selected", () => carousel.SelectedBeatmapInfo.RulesetID == 0);
+            AddAssert("unfiltered beatmap not selected", () => carousel.SelectedBeatmapInfo.Ruleset.OnlineID == 0);
 
             AddStep("remove mixed set", () =>
             {
diff --git a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
index 458c6130c7..136173c8a7 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
@@ -325,10 +325,10 @@ namespace osu.Game.Tests.Visual.SongSelect
             changeRuleset(2);
             addRulesetImportStep(2);
             addRulesetImportStep(1);
-            AddUntilStep("has selection", () => songSelect.Carousel.SelectedBeatmapInfo.RulesetID == 2);
+            AddUntilStep("has selection", () => songSelect.Carousel.SelectedBeatmapInfo.Ruleset.OnlineID == 2);
 
             changeRuleset(1);
-            AddUntilStep("has selection", () => songSelect.Carousel.SelectedBeatmapInfo.RulesetID == 1);
+            AddUntilStep("has selection", () => songSelect.Carousel.SelectedBeatmapInfo.Ruleset.OnlineID == 1);
 
             changeRuleset(0);
             AddUntilStep("no selection", () => songSelect.Carousel.SelectedBeatmapInfo == null);
@@ -341,7 +341,7 @@ namespace osu.Game.Tests.Visual.SongSelect
             changeRuleset(2);
 
             addRulesetImportStep(2);
-            AddUntilStep("has selection", () => songSelect.Carousel.SelectedBeatmapInfo.RulesetID == 2);
+            AddUntilStep("has selection", () => songSelect.Carousel.SelectedBeatmapInfo.Ruleset.OnlineID == 2);
 
             addRulesetImportStep(0);
             addRulesetImportStep(0);
@@ -352,7 +352,7 @@ namespace osu.Game.Tests.Visual.SongSelect
             AddStep("select beatmap/ruleset externally", () =>
             {
                 target = manager.GetAllUsableBeatmapSets()
-                                .Last(b => b.Beatmaps.Any(bi => bi.RulesetID == 0)).Beatmaps.Last();
+                                .Last(b => b.Beatmaps.Any(bi => bi.Ruleset.OnlineID == 0)).Beatmaps.Last();
 
                 Ruleset.Value = rulesets.AvailableRulesets.First(r => r.OnlineID == 0);
                 Beatmap.Value = manager.GetWorkingBeatmap(target);
@@ -371,7 +371,7 @@ namespace osu.Game.Tests.Visual.SongSelect
             changeRuleset(2);
 
             addRulesetImportStep(2);
-            AddUntilStep("has selection", () => songSelect.Carousel.SelectedBeatmapInfo.RulesetID == 2);
+            AddUntilStep("has selection", () => songSelect.Carousel.SelectedBeatmapInfo.Ruleset.OnlineID == 2);
 
             addRulesetImportStep(0);
             addRulesetImportStep(0);
@@ -382,7 +382,7 @@ namespace osu.Game.Tests.Visual.SongSelect
             AddStep("select beatmap/ruleset externally", () =>
             {
                 target = manager.GetAllUsableBeatmapSets()
-                                .Last(b => b.Beatmaps.Any(bi => bi.RulesetID == 0)).Beatmaps.Last();
+                                .Last(b => b.Beatmaps.Any(bi => bi.Ruleset.OnlineID == 0)).Beatmaps.Last();
 
                 Beatmap.Value = manager.GetWorkingBeatmap(target);
                 Ruleset.Value = rulesets.AvailableRulesets.First(r => r.OnlineID == 0);
@@ -493,9 +493,9 @@ namespace osu.Game.Tests.Visual.SongSelect
             AddStep("select beatmap externally", () =>
             {
                 target = manager.GetAllUsableBeatmapSets()
-                                .First(b => b.Beatmaps.Any(bi => bi.RulesetID == targetRuleset))
+                                .First(b => b.Beatmaps.Any(bi => bi.Ruleset.OnlineID == targetRuleset))
                                 .Beatmaps
-                                .First(bi => bi.RulesetID == targetRuleset);
+                                .First(bi => bi.Ruleset.OnlineID == targetRuleset);
 
                 Beatmap.Value = manager.GetWorkingBeatmap(target);
             });
@@ -544,7 +544,7 @@ namespace osu.Game.Tests.Visual.SongSelect
             {
                 target = manager
                          .GetAllUsableBeatmapSets()
-                         .First(b => b.Beatmaps.Any(bi => bi.RulesetID == 1))
+                         .First(b => b.Beatmaps.Any(bi => bi.Ruleset.OnlineID == 1))
                          .Beatmaps.First();
 
                 Beatmap.Value = manager.GetWorkingBeatmap(target);
@@ -799,8 +799,8 @@ namespace osu.Game.Tests.Visual.SongSelect
         [Test]
         public void TestChangeRulesetWhilePresentingScore()
         {
-            BeatmapInfo getPresentBeatmap() => manager.GetAllUsableBeatmapSets().Where(s => !s.DeletePending).SelectMany(s => s.Beatmaps).First(b => b.RulesetID == 0);
-            BeatmapInfo getSwitchBeatmap() => manager.GetAllUsableBeatmapSets().Where(s => !s.DeletePending).SelectMany(s => s.Beatmaps).First(b => b.RulesetID == 1);
+            BeatmapInfo getPresentBeatmap() => manager.GetAllUsableBeatmapSets().Where(s => !s.DeletePending).SelectMany(s => s.Beatmaps).First(b => b.Ruleset.OnlineID == 0);
+            BeatmapInfo getSwitchBeatmap() => manager.GetAllUsableBeatmapSets().Where(s => !s.DeletePending).SelectMany(s => s.Beatmaps).First(b => b.Ruleset.OnlineID == 1);
 
             changeRuleset(0);
 
@@ -831,8 +831,8 @@ namespace osu.Game.Tests.Visual.SongSelect
         [Test]
         public void TestChangeBeatmapWhilePresentingScore()
         {
-            BeatmapInfo getPresentBeatmap() => manager.GetAllUsableBeatmapSets().Where(s => !s.DeletePending).SelectMany(s => s.Beatmaps).First(b => b.RulesetID == 0);
-            BeatmapInfo getSwitchBeatmap() => manager.GetAllUsableBeatmapSets().Where(s => !s.DeletePending).SelectMany(s => s.Beatmaps).First(b => b.RulesetID == 1);
+            BeatmapInfo getPresentBeatmap() => manager.GetAllUsableBeatmapSets().Where(s => !s.DeletePending).SelectMany(s => s.Beatmaps).First(b => b.Ruleset.OnlineID == 0);
+            BeatmapInfo getSwitchBeatmap() => manager.GetAllUsableBeatmapSets().Where(s => !s.DeletePending).SelectMany(s => s.Beatmaps).First(b => b.Ruleset.OnlineID == 1);
 
             changeRuleset(0);
 
diff --git a/osu.Game.Tournament/Components/TournamentModIcon.cs b/osu.Game.Tournament/Components/TournamentModIcon.cs
index ed8a36c220..57a0390ac2 100644
--- a/osu.Game.Tournament/Components/TournamentModIcon.cs
+++ b/osu.Game.Tournament/Components/TournamentModIcon.cs
@@ -47,7 +47,7 @@ namespace osu.Game.Tournament.Components
                 return;
             }
 
-            var ruleset = rulesets.GetRuleset(ladderInfo.Ruleset.Value?.ID ?? 0);
+            var ruleset = rulesets.GetRuleset(ladderInfo.Ruleset.Value?.OnlineID ?? 0);
             var modIcon = ruleset?.CreateInstance().CreateModFromAcronym(modAcronym);
 
             if (modIcon == null)
diff --git a/osu.Game/Beatmaps/BeatmapInfo.cs b/osu.Game/Beatmaps/BeatmapInfo.cs
index 4e1a34ddbf..3e6e33f1d0 100644
--- a/osu.Game/Beatmaps/BeatmapInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapInfo.cs
@@ -155,7 +155,6 @@ namespace osu.Game.Beatmaps
         [Ignored]
         public int RulesetID
         {
-            get => Ruleset.OnlineID;
             set
             {
                 if (!string.IsNullOrEmpty(Ruleset.InstantiationInfo))
diff --git a/osu.Game/Beatmaps/FlatFileWorkingBeatmap.cs b/osu.Game/Beatmaps/FlatFileWorkingBeatmap.cs
index dc8201a402..163da12b2e 100644
--- a/osu.Game/Beatmaps/FlatFileWorkingBeatmap.cs
+++ b/osu.Game/Beatmaps/FlatFileWorkingBeatmap.cs
@@ -30,7 +30,7 @@ namespace osu.Game.Beatmaps
         {
             this.beatmap = beatmap;
 
-            beatmap.BeatmapInfo.Ruleset = rulesetProvider(beatmap.BeatmapInfo.RulesetID).RulesetInfo;
+            beatmap.BeatmapInfo.Ruleset = rulesetProvider(beatmap.BeatmapInfo.Ruleset.OnlineID).RulesetInfo;
 
             if (beatmapId.HasValue)
                 beatmap.BeatmapInfo.OnlineID = beatmapId.Value;
diff --git a/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs b/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
index 8f3f05aa9f..35d1cefeca 100644
--- a/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
+++ b/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
@@ -141,9 +141,11 @@ namespace osu.Game.Beatmaps.Formats
                     break;
 
                 case @"Mode":
-                    beatmap.BeatmapInfo.RulesetID = Parsing.ParseInt(pair.Value);
+                    int rulesetID = Parsing.ParseInt(pair.Value);
 
-                    switch (beatmap.BeatmapInfo.RulesetID)
+                    beatmap.BeatmapInfo.RulesetID = rulesetID;
+
+                    switch (rulesetID)
                     {
                         case 0:
                             parser = new Rulesets.Objects.Legacy.Osu.ConvertHitObjectParser(getOffsetTime(), FormatVersion);
@@ -397,7 +399,7 @@ namespace osu.Game.Beatmaps.Formats
                 OmitFirstBarLine = omitFirstBarSignature,
             };
 
-            bool isOsuRuleset = beatmap.BeatmapInfo.RulesetID == 0;
+            bool isOsuRuleset = beatmap.BeatmapInfo.Ruleset.OnlineID == 0;
             // scrolling rulesets use effect points rather than difficulty points for scroll speed adjustments.
             if (!isOsuRuleset)
                 effectPoint.ScrollSpeed = speedMultiplier;
diff --git a/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs b/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs
index 9d848fd8a4..7ddbc2f768 100644
--- a/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs
+++ b/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs
@@ -35,6 +35,8 @@ namespace osu.Game.Beatmaps.Formats
         [CanBeNull]
         private readonly ISkin skin;
 
+        private readonly int onlineRulesetID;
+
         /// <summary>
         /// Creates a new <see cref="LegacyBeatmapEncoder"/>.
         /// </summary>
@@ -45,7 +47,9 @@ namespace osu.Game.Beatmaps.Formats
             this.beatmap = beatmap;
             this.skin = skin;
 
-            if (beatmap.BeatmapInfo.RulesetID < 0 || beatmap.BeatmapInfo.RulesetID > 3)
+            onlineRulesetID = beatmap.BeatmapInfo.Ruleset.OnlineID;
+
+            if (onlineRulesetID < 0 || onlineRulesetID > 3)
                 throw new ArgumentException("Only beatmaps in the osu, taiko, catch, or mania rulesets can be encoded to the legacy beatmap format.", nameof(beatmap));
         }
 
@@ -88,7 +92,7 @@ namespace osu.Game.Beatmaps.Formats
             writer.WriteLine(FormattableString.Invariant($"Countdown: {(int)beatmap.BeatmapInfo.Countdown}"));
             writer.WriteLine(FormattableString.Invariant($"SampleSet: {toLegacySampleBank((beatmap.HitObjects.FirstOrDefault()?.SampleControlPoint ?? SampleControlPoint.DEFAULT).SampleBank)}"));
             writer.WriteLine(FormattableString.Invariant($"StackLeniency: {beatmap.BeatmapInfo.StackLeniency}"));
-            writer.WriteLine(FormattableString.Invariant($"Mode: {beatmap.BeatmapInfo.RulesetID}"));
+            writer.WriteLine(FormattableString.Invariant($"Mode: {onlineRulesetID}"));
             writer.WriteLine(FormattableString.Invariant($"LetterboxInBreaks: {(beatmap.BeatmapInfo.LetterboxInBreaks ? '1' : '0')}"));
             // if (beatmap.BeatmapInfo.UseSkinSprites)
             //     writer.WriteLine(@"UseSkinSprites: 1");
@@ -102,7 +106,7 @@ namespace osu.Game.Beatmaps.Formats
                 writer.WriteLine(@"EpilepsyWarning: 1");
             if (beatmap.BeatmapInfo.CountdownOffset > 0)
                 writer.WriteLine(FormattableString.Invariant($@"CountdownOffset: {beatmap.BeatmapInfo.CountdownOffset}"));
-            if (beatmap.BeatmapInfo.RulesetID == 3)
+            if (onlineRulesetID == 3)
                 writer.WriteLine(FormattableString.Invariant($"SpecialStyle: {(beatmap.BeatmapInfo.SpecialStyle ? '1' : '0')}"));
             writer.WriteLine(FormattableString.Invariant($"WidescreenStoryboard: {(beatmap.BeatmapInfo.WidescreenStoryboard ? '1' : '0')}"));
             if (beatmap.BeatmapInfo.SamplesMatchPlaybackRate)
@@ -147,7 +151,7 @@ namespace osu.Game.Beatmaps.Formats
             writer.WriteLine(FormattableString.Invariant($"ApproachRate: {beatmap.Difficulty.ApproachRate}"));
 
             // Taiko adjusts the slider multiplier (see: LEGACY_TAIKO_VELOCITY_MULTIPLIER)
-            writer.WriteLine(beatmap.BeatmapInfo.RulesetID == 1
+            writer.WriteLine(onlineRulesetID == 1
                 ? FormattableString.Invariant($"SliderMultiplier: {beatmap.Difficulty.SliderMultiplier / LEGACY_TAIKO_VELOCITY_MULTIPLIER}")
                 : FormattableString.Invariant($"SliderMultiplier: {beatmap.Difficulty.SliderMultiplier}"));
 
@@ -179,7 +183,7 @@ namespace osu.Game.Beatmaps.Formats
             SampleControlPoint lastRelevantSamplePoint = null;
             DifficultyControlPoint lastRelevantDifficultyPoint = null;
 
-            bool isOsuRuleset = beatmap.BeatmapInfo.RulesetID == 0;
+            bool isOsuRuleset = onlineRulesetID == 0;
 
             // iterate over hitobjects and pull out all required sample and difficulty changes
             extractDifficultyControlPoints(beatmap.HitObjects);
@@ -318,7 +322,7 @@ namespace osu.Game.Beatmaps.Formats
         {
             Vector2 position = new Vector2(256, 192);
 
-            switch (beatmap.BeatmapInfo.RulesetID)
+            switch (onlineRulesetID)
             {
                 case 0:
                 case 2:
@@ -372,7 +376,7 @@ namespace osu.Game.Beatmaps.Formats
                     break;
 
                 case IHasDuration _:
-                    if (beatmap.BeatmapInfo.RulesetID == 3)
+                    if (onlineRulesetID == 3)
                         type |= LegacyHitObjectType.Hold;
                     else
                         type |= LegacyHitObjectType.Spinner;
diff --git a/osu.Game/Rulesets/RulesetInfo.cs b/osu.Game/Rulesets/RulesetInfo.cs
index 2e2ec5c024..e2007c910e 100644
--- a/osu.Game/Rulesets/RulesetInfo.cs
+++ b/osu.Game/Rulesets/RulesetInfo.cs
@@ -98,11 +98,5 @@ namespace osu.Game.Rulesets
 
             return ruleset;
         }
-
-        #region Compatibility properties
-
-        public int ID => OnlineID;
-
-        #endregion
     }
 }
diff --git a/osu.Game/Scoring/Legacy/LegacyScoreEncoder.cs b/osu.Game/Scoring/Legacy/LegacyScoreEncoder.cs
index 2902ff7848..9460ec680c 100644
--- a/osu.Game/Scoring/Legacy/LegacyScoreEncoder.cs
+++ b/osu.Game/Scoring/Legacy/LegacyScoreEncoder.cs
@@ -34,7 +34,7 @@ namespace osu.Game.Scoring.Legacy
             this.score = score;
             this.beatmap = beatmap;
 
-            if (score.ScoreInfo.BeatmapInfo.RulesetID < 0 || score.ScoreInfo.BeatmapInfo.RulesetID > 3)
+            if (score.ScoreInfo.BeatmapInfo.Ruleset.OnlineID < 0 || score.ScoreInfo.BeatmapInfo.Ruleset.OnlineID > 3)
                 throw new ArgumentException("Only scores in the osu, taiko, catch, or mania rulesets can be encoded to the legacy score format.", nameof(score));
         }
 
diff --git a/osu.Game/Screens/Edit/Editor.cs b/osu.Game/Screens/Edit/Editor.cs
index b42f629aad..55b01bd8ab 100644
--- a/osu.Game/Screens/Edit/Editor.cs
+++ b/osu.Game/Screens/Edit/Editor.cs
@@ -338,7 +338,7 @@ namespace osu.Game.Screens.Edit
         public EditorState GetState([CanBeNull] BeatmapInfo nextBeatmap = null) => new EditorState
         {
             Time = clock.CurrentTimeAccurate,
-            ClipboardContent = nextBeatmap == null || editorBeatmap.BeatmapInfo.RulesetID == nextBeatmap.RulesetID ? Clipboard.Content.Value : string.Empty
+            ClipboardContent = nextBeatmap == null || editorBeatmap.BeatmapInfo.Ruleset.ShortName == nextBeatmap.Ruleset.ShortName ? Clipboard.Content.Value : string.Empty
         };
 
         /// <summary>
@@ -780,7 +780,7 @@ namespace osu.Game.Screens.Edit
 
             var difficultyItems = new List<MenuItem>();
 
-            foreach (var rulesetBeatmaps in beatmapSet.Beatmaps.GroupBy(b => b.RulesetID).OrderBy(group => group.Key))
+            foreach (var rulesetBeatmaps in beatmapSet.Beatmaps.GroupBy(b => b.Ruleset.ShortName).OrderBy(group => group.Key))
             {
                 if (difficultyItems.Count > 0)
                     difficultyItems.Add(new EditorMenuItemSpacer());
diff --git a/osu.Game/Screens/Select/Carousel/CarouselBeatmap.cs b/osu.Game/Screens/Select/Carousel/CarouselBeatmap.cs
index e6dee0233f..3962f7b26f 100644
--- a/osu.Game/Screens/Select/Carousel/CarouselBeatmap.cs
+++ b/osu.Game/Screens/Select/Carousel/CarouselBeatmap.cs
@@ -29,7 +29,7 @@ namespace osu.Game.Screens.Select.Carousel
             bool match =
                 criteria.Ruleset == null ||
                 BeatmapInfo.Ruleset.ShortName == criteria.Ruleset.ShortName ||
-                (BeatmapInfo.RulesetID == 0 && criteria.Ruleset.OnlineID != 0 && criteria.AllowConvertedBeatmaps);
+                (BeatmapInfo.Ruleset.OnlineID == 0 && criteria.Ruleset.OnlineID != 0 && criteria.AllowConvertedBeatmaps);
 
             if (BeatmapInfo.BeatmapSet?.Equals(criteria.SelectedBeatmapSet) == true)
             {
diff --git a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
index f25997650b..2070e53257 100644
--- a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
+++ b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
@@ -155,7 +155,7 @@ namespace osu.Game.Screens.Select.Leaderboards
                     var scores = r.All<ScoreInfo>()
                                   .AsEnumerable()
                                   // TODO: update to use a realm filter directly (or at least figure out the beatmap part to reduce scope).
-                                  .Where(s => !s.DeletePending && s.BeatmapInfo.ID == fetchBeatmapInfo.ID && s.Ruleset.OnlineID == ruleset.Value.ID);
+                                  .Where(s => !s.DeletePending && s.BeatmapInfo.ID == fetchBeatmapInfo.ID && s.Ruleset.ShortName == ruleset.Value.ShortName);
 
                     if (filterMods && !mods.Value.Any())
                     {
diff --git a/osu.Game/Screens/Select/SongSelect.cs b/osu.Game/Screens/Select/SongSelect.cs
index 837f30eb2b..10150fcd9f 100644
--- a/osu.Game/Screens/Select/SongSelect.cs
+++ b/osu.Game/Screens/Select/SongSelect.cs
@@ -502,7 +502,7 @@ namespace osu.Game.Screens.Select
                 // clear pending task immediately to track any potential nested debounce operation.
                 selectionChangedDebounce = null;
 
-                Logger.Log($"updating selection with beatmap:{beatmap?.ID.ToString() ?? "null"} ruleset:{ruleset?.ID.ToString() ?? "null"}");
+                Logger.Log($"updating selection with beatmap:{beatmap?.ID.ToString() ?? "null"} ruleset:{ruleset?.ShortName ?? "null"}");
 
                 if (transferRulesetValue())
                 {
diff --git a/osu.Game/Stores/BeatmapImporter.cs b/osu.Game/Stores/BeatmapImporter.cs
index a6f20c8d4f..709dd67087 100644
--- a/osu.Game/Stores/BeatmapImporter.cs
+++ b/osu.Game/Stores/BeatmapImporter.cs
@@ -219,11 +219,11 @@ namespace osu.Game.Stores
                     var decodedInfo = decoded.BeatmapInfo;
                     var decodedDifficulty = decodedInfo.Difficulty;
 
-                    var ruleset = realm.All<RulesetInfo>().FirstOrDefault(r => r.OnlineID == decodedInfo.RulesetID);
+                    var ruleset = realm.All<RulesetInfo>().FirstOrDefault(r => r.OnlineID == decodedInfo.Ruleset.OnlineID);
 
                     if (ruleset?.Available != true)
                     {
-                        Logger.Log($"Skipping import of {file.Filename} due to missing local ruleset {decodedInfo.RulesetID}.", LoggingTarget.Database);
+                        Logger.Log($"Skipping import of {file.Filename} due to missing local ruleset {decodedInfo.Ruleset.OnlineID}.", LoggingTarget.Database);
                         continue;
                     }
 
diff --git a/osu.Game/Tests/Beatmaps/BeatmapConversionTest.cs b/osu.Game/Tests/Beatmaps/BeatmapConversionTest.cs
index 897d4363f1..8d622955b7 100644
--- a/osu.Game/Tests/Beatmaps/BeatmapConversionTest.cs
+++ b/osu.Game/Tests/Beatmaps/BeatmapConversionTest.cs
@@ -175,7 +175,7 @@ namespace osu.Game.Tests.Beatmaps
                 var beatmap = decoder.Decode(stream);
 
                 var rulesetInstance = CreateRuleset();
-                beatmap.BeatmapInfo.Ruleset = beatmap.BeatmapInfo.RulesetID == rulesetInstance.RulesetInfo.ID ? rulesetInstance.RulesetInfo : new RulesetInfo();
+                beatmap.BeatmapInfo.Ruleset = beatmap.BeatmapInfo.Ruleset.OnlineID == rulesetInstance.RulesetInfo.OnlineID ? rulesetInstance.RulesetInfo : new RulesetInfo();
 
                 return beatmap;
             }
diff --git a/osu.Game/Tests/Beatmaps/HitObjectSampleTest.cs b/osu.Game/Tests/Beatmaps/HitObjectSampleTest.cs
index f7e154b5e7..2a3e51b4f5 100644
--- a/osu.Game/Tests/Beatmaps/HitObjectSampleTest.cs
+++ b/osu.Game/Tests/Beatmaps/HitObjectSampleTest.cs
@@ -79,7 +79,7 @@ namespace osu.Game.Tests.Beatmaps
                         currentTestBeatmap = Decoder.GetDecoder<Beatmap>(reader).Decode(reader);
 
                     // populate ruleset for beatmap converters that require it to be present.
-                    var ruleset = rulesetStore.GetRuleset(currentTestBeatmap.BeatmapInfo.RulesetID);
+                    var ruleset = rulesetStore.GetRuleset(currentTestBeatmap.BeatmapInfo.Ruleset.OnlineID);
 
                     Debug.Assert(ruleset != null);
 
diff --git a/osu.Game/Tests/Visual/OsuTestScene.cs b/osu.Game/Tests/Visual/OsuTestScene.cs
index 42e96f80ca..ec02655544 100644
--- a/osu.Game/Tests/Visual/OsuTestScene.cs
+++ b/osu.Game/Tests/Visual/OsuTestScene.cs
@@ -282,7 +282,7 @@ namespace osu.Game.Tests.Visual
                         Status = beatmap.Status,
                         Checksum = beatmap.MD5Hash,
                         AuthorID = beatmap.Metadata.Author.OnlineID,
-                        RulesetID = beatmap.RulesetID,
+                        RulesetID = beatmap.Ruleset.OnlineID,
                         StarRating = beatmap.StarRating,
                         DifficultyName = beatmap.DifficultyName,
                     }

From 5637fd64d641dcf147d7f9e2d17532bf351264ed Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 27 Jan 2022 15:59:20 +0900
Subject: [PATCH 2554/5547] Perform ordering using `IComparable` instead

---
 .../NonVisual/RulesetInfoOrderingTest.cs      |  2 +-
 osu.Game/Rulesets/EFRulesetInfo.cs            |  2 ++
 osu.Game/Rulesets/IRulesetInfo.cs             |  2 +-
 osu.Game/Rulesets/RulesetInfo.cs              | 19 ++++++++++++++-----
 osu.Game/Rulesets/RulesetStore.cs             |  2 +-
 .../Select/Carousel/CarouselBeatmap.cs        |  2 +-
 .../Select/Carousel/CarouselBeatmapSet.cs     |  2 +-
 7 files changed, 21 insertions(+), 10 deletions(-)

diff --git a/osu.Game.Tests/NonVisual/RulesetInfoOrderingTest.cs b/osu.Game.Tests/NonVisual/RulesetInfoOrderingTest.cs
index e7c04d27c1..ae999d08d5 100644
--- a/osu.Game.Tests/NonVisual/RulesetInfoOrderingTest.cs
+++ b/osu.Game.Tests/NonVisual/RulesetInfoOrderingTest.cs
@@ -25,7 +25,7 @@ namespace osu.Game.Tests.NonVisual
                 new RulesetInfo("custom3", "Custom Ruleset 3", string.Empty, -1),
             };
 
-            var orderedRulesets = rulesets.OrderBy(r => r.SortID);
+            var orderedRulesets = rulesets.OrderBy(r => r);
 
             // Ensure all customs are after official.
             Assert.That(orderedRulesets.Select(r => r.OnlineID), Is.EqualTo(new[] { 0, 2, -1, -1, -1, -1 }));
diff --git a/osu.Game/Rulesets/EFRulesetInfo.cs b/osu.Game/Rulesets/EFRulesetInfo.cs
index 9559cfa00c..b4a64fe932 100644
--- a/osu.Game/Rulesets/EFRulesetInfo.cs
+++ b/osu.Game/Rulesets/EFRulesetInfo.cs
@@ -42,6 +42,8 @@ namespace osu.Game.Rulesets
 
         public bool Equals(EFRulesetInfo other) => other != null && ID == other.ID && Available == other.Available && Name == other.Name && InstantiationInfo == other.InstantiationInfo;
 
+        public int CompareTo(RulesetInfo other) => ID?.CompareTo(other.ID) ?? -1;
+
         public override bool Equals(object obj) => obj is EFRulesetInfo rulesetInfo && Equals(rulesetInfo);
 
         public bool Equals(IRulesetInfo other) => other is RulesetInfo b && Equals(b);
diff --git a/osu.Game/Rulesets/IRulesetInfo.cs b/osu.Game/Rulesets/IRulesetInfo.cs
index 6599e0d59d..44731a2495 100644
--- a/osu.Game/Rulesets/IRulesetInfo.cs
+++ b/osu.Game/Rulesets/IRulesetInfo.cs
@@ -11,7 +11,7 @@ namespace osu.Game.Rulesets
     /// <summary>
     /// A representation of a ruleset's metadata.
     /// </summary>
-    public interface IRulesetInfo : IHasOnlineID<int>, IEquatable<IRulesetInfo>
+    public interface IRulesetInfo : IHasOnlineID<int>, IEquatable<IRulesetInfo>, IComparable<RulesetInfo>
     {
         /// <summary>
         /// The user-exposed name of this ruleset.
diff --git a/osu.Game/Rulesets/RulesetInfo.cs b/osu.Game/Rulesets/RulesetInfo.cs
index d721926e95..896b9ee279 100644
--- a/osu.Game/Rulesets/RulesetInfo.cs
+++ b/osu.Game/Rulesets/RulesetInfo.cs
@@ -24,11 +24,6 @@ namespace osu.Game.Rulesets
 
         public string InstantiationInfo { get; set; } = string.Empty;
 
-        /// <summary>
-        /// A best effort sort ID which provides stable ordering and puts online rulesets before non-online rulesets.
-        /// </summary>
-        public int SortID => OnlineID >= 0 ? OnlineID : Math.Abs(ShortName.GetHashCode());
-
         public RulesetInfo(string shortName, string name, string instantiationInfo, int onlineID)
         {
             ShortName = shortName;
@@ -62,6 +57,20 @@ namespace osu.Game.Rulesets
 
         public bool Equals(IRulesetInfo? other) => other is RulesetInfo b && Equals(b);
 
+        public int CompareTo(RulesetInfo other)
+        {
+            // Official rulesets are always given precedence for the time being.
+            if (OnlineID >= 0)
+            {
+                if (other.OnlineID >= 0)
+                    return OnlineID.CompareTo(other.OnlineID);
+
+                return -1;
+            }
+
+            return string.Compare(ShortName, other.ShortName, StringComparison.Ordinal);
+        }
+
         public override int GetHashCode()
         {
             // Importantly, ignore the underlying realm hash code, as it will usually not match.
diff --git a/osu.Game/Rulesets/RulesetStore.cs b/osu.Game/Rulesets/RulesetStore.cs
index a9fd8f430e..d017d54ed9 100644
--- a/osu.Game/Rulesets/RulesetStore.cs
+++ b/osu.Game/Rulesets/RulesetStore.cs
@@ -163,7 +163,7 @@ namespace osu.Game.Rulesets
                     }
                 }
 
-                availableRulesets.AddRange(detachedRulesets.OrderBy(r => r.SortID));
+                availableRulesets.AddRange(detachedRulesets.OrderBy(r => r));
             });
         }
 
diff --git a/osu.Game/Screens/Select/Carousel/CarouselBeatmap.cs b/osu.Game/Screens/Select/Carousel/CarouselBeatmap.cs
index 9d49fdaf6e..0045e7ba4f 100644
--- a/osu.Game/Screens/Select/Carousel/CarouselBeatmap.cs
+++ b/osu.Game/Screens/Select/Carousel/CarouselBeatmap.cs
@@ -89,7 +89,7 @@ namespace osu.Game.Screens.Select.Carousel
             {
                 default:
                 case SortMode.Difficulty:
-                    int ruleset = BeatmapInfo.Ruleset.SortID.CompareTo(otherBeatmap.BeatmapInfo.Ruleset.SortID);
+                    int ruleset = BeatmapInfo.Ruleset.CompareTo(otherBeatmap.BeatmapInfo.Ruleset);
                     if (ruleset != 0) return ruleset;
 
                     return BeatmapInfo.StarRating.CompareTo(otherBeatmap.BeatmapInfo.StarRating);
diff --git a/osu.Game/Screens/Select/Carousel/CarouselBeatmapSet.cs b/osu.Game/Screens/Select/Carousel/CarouselBeatmapSet.cs
index 274be7b73a..fc4b6c27f3 100644
--- a/osu.Game/Screens/Select/Carousel/CarouselBeatmapSet.cs
+++ b/osu.Game/Screens/Select/Carousel/CarouselBeatmapSet.cs
@@ -39,7 +39,7 @@ namespace osu.Game.Screens.Select.Carousel
 
             beatmapSet.Beatmaps
                       .Where(b => !b.Hidden)
-                      .OrderBy(b => b.Ruleset.SortID)
+                      .OrderBy(b => b.Ruleset)
                       .ThenBy(b => b.StarRating)
                       .Select(b => new CarouselBeatmap(b))
                       .ForEach(AddChild);

From b87d1a61a8d2d2d48674ba3bed92568cabef7c25 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 27 Jan 2022 16:39:36 +0900
Subject: [PATCH 2555/5547] Fix `ButtonSystem` null reference crash due to
 missing null check in delayed animations

```csharp
[runtime] 2022-01-27 07:36:34 [error]: System.NullReferenceException: Object reference not set to an instance of an object.
[runtime] 2022-01-27 07:36:34 [error]: at osu.Game.Screens.Menu.ButtonSystem.<>c__DisplayClass56_0.<updateLogoState>b__1() in /Users/dean/Projects/osu/osu.Game/Screens/Menu/ButtonSystem.cs:line 357
[runtime] 2022-01-27 07:36:34 [error]: at osu.Framework.Threading.ScheduledDelegate.RunTaskInternal()
[runtime] 2022-01-27 07:36:34 [error]: at osu.Framework.Threading.Scheduler.Update()
[runtime] 2022-01-27 07:36:34 [error]: at osu.Framework.Graphics.Drawable.UpdateSubTree()
```
---
 osu.Game/Screens/Menu/ButtonSystem.cs | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Screens/Menu/ButtonSystem.cs b/osu.Game/Screens/Menu/ButtonSystem.cs
index 32731407fd..b03425fef4 100644
--- a/osu.Game/Screens/Menu/ButtonSystem.cs
+++ b/osu.Game/Screens/Menu/ButtonSystem.cs
@@ -4,6 +4,7 @@
 using System;
 using System.Collections.Generic;
 using System.Linq;
+using JetBrains.Annotations;
 using osu.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
@@ -49,6 +50,7 @@ namespace osu.Game.Screens.Menu
         public const float BUTTON_WIDTH = 140f;
         public const float WEDGE_WIDTH = 20;
 
+        [CanBeNull]
         private OsuLogo logo;
 
         /// <summary>
@@ -328,9 +330,9 @@ namespace osu.Game.Screens.Menu
 
                         game?.Toolbar.Hide();
 
-                        logo.ClearTransforms(targetMember: nameof(Position));
-                        logo.MoveTo(new Vector2(0.5f), 800, Easing.OutExpo);
-                        logo.ScaleTo(1, 800, Easing.OutExpo);
+                        logo?.ClearTransforms(targetMember: nameof(Position));
+                        logo?.MoveTo(new Vector2(0.5f), 800, Easing.OutExpo);
+                        logo?.ScaleTo(1, 800, Easing.OutExpo);
                     }, buttonArea.Alpha * 150);
                     break;
 
@@ -354,7 +356,7 @@ namespace osu.Game.Screens.Menu
                             logoDelayedAction = Scheduler.AddDelayed(() =>
                             {
                                 if (impact)
-                                    logo.Impact();
+                                    logo?.Impact();
 
                                 game?.Toolbar.Show();
                             }, 200);

From 0a45aa80cb011e658dc1d7c3504d2fe4ef12f079 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 27 Jan 2022 16:16:49 +0900
Subject: [PATCH 2556/5547] Remove unnecessary double-schedule in
 `UpdateBeatmapSet`

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

diff --git a/osu.Game/Screens/Select/BeatmapCarousel.cs b/osu.Game/Screens/Select/BeatmapCarousel.cs
index dff2c598c3..94e520ba1c 100644
--- a/osu.Game/Screens/Select/BeatmapCarousel.cs
+++ b/osu.Game/Screens/Select/BeatmapCarousel.cs
@@ -311,13 +311,10 @@ namespace osu.Game.Screens.Select
 
             itemsCache.Invalidate();
 
-            Schedule(() =>
-            {
-                if (!Scroll.UserScrolling)
-                    ScrollToSelected(true);
+            if (!Scroll.UserScrolling)
+                ScrollToSelected(true);
 
-                BeatmapSetsChanged?.Invoke();
-            });
+            BeatmapSetsChanged?.Invoke();
         });
 
         /// <summary>

From 449e9bcf5c123e1e1c92534f8f3a710412a5028d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 27 Jan 2022 16:17:38 +0900
Subject: [PATCH 2557/5547] Ensure beatmap carousel scroll position is
 maintained during deletion operations

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

diff --git a/osu.Game/Screens/Select/BeatmapCarousel.cs b/osu.Game/Screens/Select/BeatmapCarousel.cs
index 94e520ba1c..c27915c383 100644
--- a/osu.Game/Screens/Select/BeatmapCarousel.cs
+++ b/osu.Game/Screens/Select/BeatmapCarousel.cs
@@ -286,6 +286,9 @@ namespace osu.Game.Screens.Select
 
             root.RemoveChild(existingSet);
             itemsCache.Invalidate();
+
+            if (!Scroll.UserScrolling)
+                ScrollToSelected(true);
         });
 
         public void UpdateBeatmapSet(BeatmapSetInfo beatmapSet) => Schedule(() =>

From f2cecad83b2e1df2b2e15c5cd49e04534cf55dca Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 27 Jan 2022 16:38:02 +0900
Subject: [PATCH 2558/5547] Add failing test coverage showing carousel
 deletions don't keep scroll position

---
 .../SongSelect/TestSceneBeatmapCarousel.cs    | 43 +++++++++++++++++++
 1 file changed, 43 insertions(+)

diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs
index 0298c3bea9..2f2001c4f2 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs
@@ -9,6 +9,7 @@ using osu.Framework.Allocation;
 using osu.Framework.Extensions.IEnumerableExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
+using osu.Framework.Utils;
 using osu.Game.Beatmaps;
 using osu.Game.Configuration;
 using osu.Game.Rulesets;
@@ -40,6 +41,36 @@ namespace osu.Game.Tests.Visual.SongSelect
             this.rulesets = rulesets;
         }
 
+        [Test]
+        public void TestScrollPositionMaintainedOnAdd()
+        {
+            loadBeatmaps(count: 1, randomDifficulties: false);
+
+            for (int i = 0; i < 10; i++)
+            {
+                AddRepeatStep("Add some sets", () => carousel.UpdateBeatmapSet(TestResources.CreateTestBeatmapSetInfo()), 4);
+
+                checkSelectionIsCentered();
+            }
+        }
+
+        [Test]
+        public void TestScrollPositionMaintainedOnDelete()
+        {
+            loadBeatmaps(count: 50, randomDifficulties: false);
+
+            for (int i = 0; i < 10; i++)
+            {
+                AddRepeatStep("Remove some sets", () =>
+                    carousel.RemoveBeatmapSet(carousel.Items.Select(item => item.Item)
+                                                      .OfType<CarouselBeatmapSet>()
+                                                      .OrderBy(item => item.GetHashCode())
+                                                      .First(item => item.State.Value != CarouselItemState.Selected && item.Visible).BeatmapSet), 4);
+
+                checkSelectionIsCentered();
+            }
+        }
+
         [Test]
         public void TestManyPanels()
         {
@@ -813,6 +844,18 @@ namespace osu.Game.Tests.Visual.SongSelect
                 carousel.Items.Count(s => (diff ? s.Item is CarouselBeatmap : s.Item is CarouselBeatmapSet) && s.Item.Visible) == count);
         }
 
+        private void checkSelectionIsCentered()
+        {
+            AddAssert("Selected panel is centered", () =>
+            {
+                return Precision.AlmostEquals(
+                    carousel.ScreenSpaceDrawQuad.Centre,
+                    carousel.Items
+                            .First(i => i.Item.State.Value == CarouselItemState.Selected)
+                            .ScreenSpaceDrawQuad.Centre, 100);
+            });
+        }
+
         private void checkNoSelection() => AddAssert("Selection is null", () => currentSelection == null);
 
         private void nextRandom() =>

From 3ae5973ab7de887e1908430d3601fbc18301489e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 27 Jan 2022 17:08:12 +0900
Subject: [PATCH 2559/5547] Fix compilation error due to commit split

---
 osu.Game/Screens/Select/Carousel/CarouselBeatmap.cs    | 2 +-
 osu.Game/Screens/Select/Carousel/CarouselBeatmapSet.cs | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/Select/Carousel/CarouselBeatmap.cs b/osu.Game/Screens/Select/Carousel/CarouselBeatmap.cs
index 3962f7b26f..1f346d19f0 100644
--- a/osu.Game/Screens/Select/Carousel/CarouselBeatmap.cs
+++ b/osu.Game/Screens/Select/Carousel/CarouselBeatmap.cs
@@ -89,7 +89,7 @@ namespace osu.Game.Screens.Select.Carousel
             {
                 default:
                 case SortMode.Difficulty:
-                    int ruleset = BeatmapInfo.RulesetID.CompareTo(otherBeatmap.BeatmapInfo.RulesetID);
+                    int ruleset = BeatmapInfo.Ruleset.OnlineID.CompareTo(otherBeatmap.BeatmapInfo.Ruleset.OnlineID);
                     if (ruleset != 0) return ruleset;
 
                     return BeatmapInfo.StarRating.CompareTo(otherBeatmap.BeatmapInfo.StarRating);
diff --git a/osu.Game/Screens/Select/Carousel/CarouselBeatmapSet.cs b/osu.Game/Screens/Select/Carousel/CarouselBeatmapSet.cs
index b2b3b5411c..6156fea769 100644
--- a/osu.Game/Screens/Select/Carousel/CarouselBeatmapSet.cs
+++ b/osu.Game/Screens/Select/Carousel/CarouselBeatmapSet.cs
@@ -39,7 +39,7 @@ namespace osu.Game.Screens.Select.Carousel
 
             beatmapSet.Beatmaps
                       .Where(b => !b.Hidden)
-                      .OrderBy(b => b.RulesetID)
+                      .OrderBy(b => b.Ruleset.OnlineID)
                       .ThenBy(b => b.StarRating)
                       .Select(b => new CarouselBeatmap(b))
                       .ForEach(AddChild);

From 831fa44433059078f0c96d06cf0e69b8686e5d8c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 27 Jan 2022 19:35:04 +0900
Subject: [PATCH 2560/5547] Fix song select tests not waiting for beatmap
 imports to arrive

After the change to realm, notification fires could take a frame or two.
We aren't accounting for this.

Fixes test failures like
https://github.com/ppy/osu/runs/4963255990?check_suite_focus=true
---
 .../SongSelect/TestScenePlaySongSelect.cs     | 23 +++++++++++++++++--
 1 file changed, 21 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
index 458c6130c7..ca0f2b8012 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
@@ -13,6 +13,7 @@ using osu.Framework.Screens;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
 using osu.Game.Configuration;
+using osu.Game.Database;
 using osu.Game.Extensions;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Online.API.Requests.Responses;
@@ -73,6 +74,17 @@ namespace osu.Game.Tests.Visual.SongSelect
             AddStep("delete all beatmaps", () => manager?.Delete());
         }
 
+        public override void TearDownSteps()
+        {
+            base.TearDownSteps();
+
+            AddStep("remove song select", () =>
+            {
+                songSelect?.Expire();
+                songSelect = null;
+            });
+        }
+
         [Test]
         public void TestSingleFilterOnEnter()
         {
@@ -870,9 +882,16 @@ namespace osu.Game.Tests.Visual.SongSelect
             return set.ChildrenOfType<FilterableDifficultyIcon>().ToList().FindIndex(i => i == icon);
         }
 
-        private void addRulesetImportStep(int id) => AddStep($"import test map for ruleset {id}", () => importForRuleset(id));
+        private void addRulesetImportStep(int id)
+        {
+            Live<BeatmapSetInfo> imported = null;
+            AddStep($"import test map for ruleset {id}", () => imported = importForRuleset(id));
+            // This is specifically for cases where the add is happening post song select load.
+            // For cases where song select is null, the assertions are provided by the load checks.
+            AddUntilStep("wait for imported to arrive in carousel", () => songSelect == null || songSelect.Carousel.BeatmapSets.Any(s => s.ID == imported?.ID));
+        }
 
-        private void importForRuleset(int id) => manager.Import(TestResources.CreateTestBeatmapSetInfo(3, rulesets.AvailableRulesets.Where(r => r.OnlineID == id).ToArray()));
+        private Live<BeatmapSetInfo> importForRuleset(int id) => manager.Import(TestResources.CreateTestBeatmapSetInfo(3, rulesets.AvailableRulesets.Where(r => r.OnlineID == id).ToArray()));
 
         private void checkMusicPlaying(bool playing) =>
             AddUntilStep($"music {(playing ? "" : "not ")}playing", () => music.IsPlaying == playing);

From 1bdf16494baa48fd15715ece296b198f6f60b64f Mon Sep 17 00:00:00 2001
From: Spooghetti420 <kkovachev1947@gmail.com>
Date: Thu, 27 Jan 2022 11:35:31 +0000
Subject: [PATCH 2561/5547] Add No Long Notes mod

---
 osu.Game.Rulesets.Mania/ManiaRuleset.cs       |  3 +-
 .../Mods/ManiaModNoLongNotes.cs               | 80 +++++++++++++++++++
 2 files changed, 82 insertions(+), 1 deletion(-)
 create mode 100644 osu.Game.Rulesets.Mania/Mods/ManiaModNoLongNotes.cs

diff --git a/osu.Game.Rulesets.Mania/ManiaRuleset.cs b/osu.Game.Rulesets.Mania/ManiaRuleset.cs
index 6fc7dc018b..3471f4ca66 100644
--- a/osu.Game.Rulesets.Mania/ManiaRuleset.cs
+++ b/osu.Game.Rulesets.Mania/ManiaRuleset.cs
@@ -243,7 +243,8 @@ namespace osu.Game.Rulesets.Mania
                         new ManiaModDifficultyAdjust(),
                         new ManiaModClassic(),
                         new ManiaModInvert(),
-                        new ManiaModConstantSpeed()
+                        new ManiaModConstantSpeed(),
+                        new ManiaModNoLongNotes()
                     };
 
                 case ModType.Automation:
diff --git a/osu.Game.Rulesets.Mania/Mods/ManiaModNoLongNotes.cs b/osu.Game.Rulesets.Mania/Mods/ManiaModNoLongNotes.cs
new file mode 100644
index 0000000000..7295a9eb6e
--- /dev/null
+++ b/osu.Game.Rulesets.Mania/Mods/ManiaModNoLongNotes.cs
@@ -0,0 +1,80 @@
+// 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.Extensions.IEnumerableExtensions;
+using osu.Game.Beatmaps;
+using osu.Game.Rulesets.Mania.Objects;
+using osu.Game.Rulesets.Mods;
+using osu.Framework.Graphics.Sprites;
+using System;
+using System.Collections.Generic;
+using osu.Game.Audio;
+using osu.Game.Rulesets.Mania.Beatmaps;
+using osu.Framework.Utils;
+using osu.Game.Overlays.Settings;
+using osu.Framework.Bindables;
+using osu.Game.Configuration;
+using osu.Game.Graphics;
+
+
+
+namespace osu.Game.Rulesets.Mania.Mods
+{
+    public class ManiaModNoLongNotes : Mod, IApplicableAfterBeatmapConversion
+    {
+
+        public override string Name => "No Long Notes";
+        public override string Acronym => "NL";
+        public override double ScoreMultiplier => 1;
+        public override string Description => @"Turns all held notes into tap notes. No coordination required.";
+        public override IconUsage? Icon => FontAwesome.Solid.DotCircle;
+        public override ModType Type => ModType.Conversion;
+
+        [SettingSource("Add end notes", "Also add a note at the end of a held note")]
+        public BindableBool AddEndNotes { get; } = new BindableBool
+        {
+            Default = true,
+            Value = true
+        };
+
+        [SettingSource("Length threshold", "Only add an end note for held notes longer than this threshold (in milliseconds)")]
+        public BindableNumber<double> Threshold { get; } = new BindableDouble
+        {
+            MinValue = 1.0,
+            MaxValue = 1990.0,
+            Default = 200.0,
+            Value = 200.0,
+            Precision = 1.0,
+        };
+        public void ApplyToBeatmap(IBeatmap beatmap)
+        {
+            var maniaBeatmap = (ManiaBeatmap)beatmap;
+
+            var newObjects = new List<ManiaHitObject>();
+            beatmap.HitObjects.OfType<HoldNote>().ForEach(h => 
+            {
+                // Add a note for the beginning of the hold note
+                newObjects.Add(new Note
+                {
+                    Column = h.Column,
+                    StartTime = h.StartTime,
+                    Samples = h.Samples
+                });
+
+                // Don't add an end note if the duration is below the threshold, or end notes are disabled
+                if (AddEndNotes.Value && h.Duration > Threshold.Value) 
+                {
+                    newObjects.Add(new Note
+                    {
+                        Column = h.Column,
+                        StartTime = h.EndTime,
+                        Samples = h.Samples
+                    });
+                }
+            });
+
+            maniaBeatmap.HitObjects = maniaBeatmap.HitObjects.OfType<Note>().Concat(newObjects).OrderBy(h => h.StartTime).ToList();            
+        }
+    }
+}

From 33b7bdcf8260cf0d9090d9edaa186729682b8b3b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 27 Jan 2022 21:49:33 +0900
Subject: [PATCH 2562/5547] Update pointless `CompareTo` implementation

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

diff --git a/osu.Game/Rulesets/EFRulesetInfo.cs b/osu.Game/Rulesets/EFRulesetInfo.cs
index b4a64fe932..ba56adac49 100644
--- a/osu.Game/Rulesets/EFRulesetInfo.cs
+++ b/osu.Game/Rulesets/EFRulesetInfo.cs
@@ -42,7 +42,7 @@ namespace osu.Game.Rulesets
 
         public bool Equals(EFRulesetInfo other) => other != null && ID == other.ID && Available == other.Available && Name == other.Name && InstantiationInfo == other.InstantiationInfo;
 
-        public int CompareTo(RulesetInfo other) => ID?.CompareTo(other.ID) ?? -1;
+        public int CompareTo(RulesetInfo other) => OnlineID.CompareTo(other.OnlineID);
 
         public override bool Equals(object obj) => obj is EFRulesetInfo rulesetInfo && Equals(rulesetInfo);
 

From 2cc69d6b19b2682db3a7c6ec8dd79ccc1421a0d1 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 27 Jan 2022 15:57:56 +0300
Subject: [PATCH 2563/5547] Replace `IsControlDragged` with an abstract
 `ShouldBeExpanded`

---
 osu.Game/Overlays/ExpandableSlider.cs          |  2 +-
 osu.Game/Overlays/ExpandingControlContainer.cs |  8 +++++++-
 osu.Game/Overlays/IExpandable.cs               | 11 +++++++++++
 osu.Game/Overlays/IExpandableControl.cs        |  4 ----
 4 files changed, 19 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Overlays/ExpandableSlider.cs b/osu.Game/Overlays/ExpandableSlider.cs
index 524485d806..d346b9b22c 100644
--- a/osu.Game/Overlays/ExpandableSlider.cs
+++ b/osu.Game/Overlays/ExpandableSlider.cs
@@ -72,7 +72,7 @@ namespace osu.Game.Overlays
 
         public BindableBool Expanded { get; } = new BindableBool();
 
-        public bool IsControlDragged => slider.IsDragged;
+        bool IExpandable.ShouldBeExpanded => IsHovered || slider.IsDragged;
 
         public override bool HandlePositionalInput => true;
 
diff --git a/osu.Game/Overlays/ExpandingControlContainer.cs b/osu.Game/Overlays/ExpandingControlContainer.cs
index fb6a71ba97..859e4bcd25 100644
--- a/osu.Game/Overlays/ExpandingControlContainer.cs
+++ b/osu.Game/Overlays/ExpandingControlContainer.cs
@@ -118,6 +118,12 @@ namespace osu.Game.Overlays
         /// <summary>
         /// Whether the given control is currently active, by checking whether it's hovered or dragged.
         /// </summary>
-        private bool isControlActive(TControl control) => control.IsHovered || control.IsDragged || (control is IExpandableControl expandable && expandable.IsControlDragged);
+        private bool isControlActive(TControl control)
+        {
+            if (control is IExpandable expandable)
+                return expandable.ShouldBeExpanded;
+
+            return control.IsHovered || control.IsDragged;
+        }
     }
 }
diff --git a/osu.Game/Overlays/IExpandable.cs b/osu.Game/Overlays/IExpandable.cs
index 770ac97847..f998fc7b9f 100644
--- a/osu.Game/Overlays/IExpandable.cs
+++ b/osu.Game/Overlays/IExpandable.cs
@@ -3,6 +3,7 @@
 
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
+using osu.Game.Graphics.UserInterface;
 
 namespace osu.Game.Overlays
 {
@@ -15,5 +16,15 @@ namespace osu.Game.Overlays
         /// Whether this drawable is in an expanded state.
         /// </summary>
         BindableBool Expanded { get; }
+
+        /// <summary>
+        /// Whether this drawable should be/stay expanded by a parenting <see cref="IExpandingContainer"/>.
+        /// By default, this is <see langword="true"/> when this drawable is in a hovered or dragged state.
+        /// </summary>
+        /// <remarks>
+        /// This is defined for certain controls which may have a child handling dragging instead.
+        /// (e.g. <see cref="ExpandableSlider{T,TSlider}"/> in which dragging is handled by their underlying <see cref="OsuSliderBar{T}"/> control).
+        /// </remarks>
+        bool ShouldBeExpanded => IsHovered || IsDragged;
     }
 }
diff --git a/osu.Game/Overlays/IExpandableControl.cs b/osu.Game/Overlays/IExpandableControl.cs
index fae07ae23b..2cda6f467b 100644
--- a/osu.Game/Overlays/IExpandableControl.cs
+++ b/osu.Game/Overlays/IExpandableControl.cs
@@ -8,9 +8,5 @@ namespace osu.Game.Overlays
     /// </summary>
     public interface IExpandableControl : IExpandable
     {
-        /// <summary>
-        /// Returns whether the UI control is currently in a dragged state.
-        /// </summary>
-        bool IsControlDragged { get; }
     }
 }

From 2d1a8a9d492258f760ed9d1475135862d76f483f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 27 Jan 2022 21:58:04 +0900
Subject: [PATCH 2564/5547] Use a more correct `CompareTo` implementation for
 ruleset ordering

---
 osu.Game/Rulesets/RulesetInfo.cs | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Rulesets/RulesetInfo.cs b/osu.Game/Rulesets/RulesetInfo.cs
index dd47a19f32..0a0941d1ff 100644
--- a/osu.Game/Rulesets/RulesetInfo.cs
+++ b/osu.Game/Rulesets/RulesetInfo.cs
@@ -51,14 +51,14 @@ namespace osu.Game.Rulesets
 
         public int CompareTo(RulesetInfo other)
         {
+            if (OnlineID >= 0 && other.OnlineID >= 0)
+                return OnlineID.CompareTo(other.OnlineID);
+
             // Official rulesets are always given precedence for the time being.
             if (OnlineID >= 0)
-            {
-                if (other.OnlineID >= 0)
-                    return OnlineID.CompareTo(other.OnlineID);
-
                 return -1;
-            }
+            if (other.OnlineID >= 0)
+                return 1;
 
             return string.Compare(ShortName, other.ShortName, StringComparison.Ordinal);
         }

From fae4f8bd8e17f7a5df716b8a19ca731a229c714f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 27 Jan 2022 21:59:44 +0900
Subject: [PATCH 2565/5547] Move nulling of previous `songSelect` to
 `SetUpSteps` instead

---
 .../Visual/SongSelect/TestScenePlaySongSelect.cs    | 13 ++-----------
 1 file changed, 2 insertions(+), 11 deletions(-)

diff --git a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
index ca0f2b8012..0c452f857f 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
@@ -69,22 +69,13 @@ namespace osu.Game.Tests.Visual.SongSelect
             {
                 Ruleset.Value = new OsuRuleset().RulesetInfo;
                 Beatmap.SetDefault();
+
+                songSelect = null;
             });
 
             AddStep("delete all beatmaps", () => manager?.Delete());
         }
 
-        public override void TearDownSteps()
-        {
-            base.TearDownSteps();
-
-            AddStep("remove song select", () =>
-            {
-                songSelect?.Expire();
-                songSelect = null;
-            });
-        }
-
         [Test]
         public void TestSingleFilterOnEnter()
         {

From 81461be49fede927581065f46f03331d69d93e8d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 28 Jan 2022 00:14:18 +0900
Subject: [PATCH 2566/5547] Skip beatmap imports where ruleset is not present
 in realm

Closes #16651.

When a ruleset is not available, the `Find` call would return null. When
a null is passed to the constructor, `BeatmapInfo` would create an "osu"
ruleset, which tries to get stored to realm and fails on duplicate
primary key.

Probably need to add better safeties against this (or change that
constructor...) but this will fix the migration process.

Probably not serious enough to pull the build. This only affects
rulesets like karaoke which have custom beatmaps.
---
 osu.Game/Database/EFToRealmMigrator.cs | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/osu.Game/Database/EFToRealmMigrator.cs b/osu.Game/Database/EFToRealmMigrator.cs
index 639bf10e19..9fb0130619 100644
--- a/osu.Game/Database/EFToRealmMigrator.cs
+++ b/osu.Game/Database/EFToRealmMigrator.cs
@@ -232,6 +232,7 @@ namespace osu.Game.Database
 
                 var transaction = r.BeginWrite();
                 int written = 0;
+                int missing = 0;
 
                 try
                 {
@@ -261,6 +262,12 @@ namespace osu.Game.Database
                             var ruleset = r.Find<RulesetInfo>(beatmap.RulesetInfo.ShortName);
                             var metadata = getBestMetadata(beatmap.Metadata, beatmapSet.Metadata);
 
+                            if (ruleset == null)
+                            {
+                                log($"Skipping {++missing} beatmaps with missing ruleset");
+                                continue;
+                            }
+
                             var realmBeatmap = new BeatmapInfo(ruleset, new BeatmapDifficulty(beatmap.BaseDifficulty), metadata)
                             {
                                 DifficultyName = beatmap.DifficultyName,

From 942ea896f1dfab080c624e57b8c90b30844e56ba Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 28 Jan 2022 01:20:32 +0900
Subject: [PATCH 2567/5547] Skip scores missing beatmaps during realm migration

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

diff --git a/osu.Game/Database/EFToRealmMigrator.cs b/osu.Game/Database/EFToRealmMigrator.cs
index 9fb0130619..a53704df9d 100644
--- a/osu.Game/Database/EFToRealmMigrator.cs
+++ b/osu.Game/Database/EFToRealmMigrator.cs
@@ -374,12 +374,12 @@ namespace osu.Game.Database
                             log($"Migrated {written}/{count} scores...");
                         }
 
-                        var beatmap = r.All<BeatmapInfo>().First(b => b.Hash == score.BeatmapInfo.Hash);
+                        var beatmap = r.All<BeatmapInfo>().FirstOrDefault(b => b.Hash == score.BeatmapInfo.Hash);
                         var ruleset = r.Find<RulesetInfo>(score.Ruleset.ShortName);
 
-                        if (ruleset == null)
+                        if (beatmap == null || ruleset == null)
                         {
-                            log($"Skipping {++missing} scores with missing ruleset");
+                            log($"Skipping {++missing} scores with missing ruleset or beatmap");
                             continue;
                         }
 

From c0b2f8bd01b62c2bbd0366c8d97eb883e95b9349 Mon Sep 17 00:00:00 2001
From: Spooghetti420 <kkovachev1947@gmail.com>
Date: Thu, 27 Jan 2022 16:21:38 +0000
Subject: [PATCH 2568/5547] Fix newline style in mod

---
 osu.Game.Rulesets.Mania/Mods/ManiaModNoLongNotes.cs | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/osu.Game.Rulesets.Mania/Mods/ManiaModNoLongNotes.cs b/osu.Game.Rulesets.Mania/Mods/ManiaModNoLongNotes.cs
index 7295a9eb6e..56522a4587 100644
--- a/osu.Game.Rulesets.Mania/Mods/ManiaModNoLongNotes.cs
+++ b/osu.Game.Rulesets.Mania/Mods/ManiaModNoLongNotes.cs
@@ -25,10 +25,15 @@ namespace osu.Game.Rulesets.Mania.Mods
     {
 
         public override string Name => "No Long Notes";
+
         public override string Acronym => "NL";
+        
         public override double ScoreMultiplier => 1;
+        
         public override string Description => @"Turns all held notes into tap notes. No coordination required.";
+        
         public override IconUsage? Icon => FontAwesome.Solid.DotCircle;
+        
         public override ModType Type => ModType.Conversion;
 
         [SettingSource("Add end notes", "Also add a note at the end of a held note")]

From 400633bd99a8cb86f647437d18f25ee4c702232b Mon Sep 17 00:00:00 2001
From: Spooghetti420 <kkovachev1947@gmail.com>
Date: Thu, 27 Jan 2022 16:23:09 +0000
Subject: [PATCH 2569/5547] Add another newline

---
 osu.Game.Rulesets.Mania/Mods/ManiaModNoLongNotes.cs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Game.Rulesets.Mania/Mods/ManiaModNoLongNotes.cs b/osu.Game.Rulesets.Mania/Mods/ManiaModNoLongNotes.cs
index 56522a4587..d10003b783 100644
--- a/osu.Game.Rulesets.Mania/Mods/ManiaModNoLongNotes.cs
+++ b/osu.Game.Rulesets.Mania/Mods/ManiaModNoLongNotes.cs
@@ -52,6 +52,7 @@ namespace osu.Game.Rulesets.Mania.Mods
             Value = 200.0,
             Precision = 1.0,
         };
+
         public void ApplyToBeatmap(IBeatmap beatmap)
         {
             var maniaBeatmap = (ManiaBeatmap)beatmap;

From 9deeaee40481e7702c4b0e143ec177e755928dd7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 27 Jan 2022 16:57:38 +0100
Subject: [PATCH 2570/5547] Fix tournament client not loading

Caused by a `LoadComponentsAsync()` call being fired from a worker
thread, which will throw exceptions since the recent addition of safety
checks around that method.
---
 osu.Game.Tournament/TournamentGame.cs | 15 ++++++---------
 1 file changed, 6 insertions(+), 9 deletions(-)

diff --git a/osu.Game.Tournament/TournamentGame.cs b/osu.Game.Tournament/TournamentGame.cs
index 5d613894d4..7967f54b49 100644
--- a/osu.Game.Tournament/TournamentGame.cs
+++ b/osu.Game.Tournament/TournamentGame.cs
@@ -61,18 +61,15 @@ namespace osu.Game.Tournament
 
             loadingSpinner.Show();
 
-            BracketLoadTask.ContinueWith(t =>
+            BracketLoadTask.ContinueWith(t => Schedule(() =>
             {
                 if (t.IsFaulted)
                 {
-                    Schedule(() =>
-                    {
-                        loadingSpinner.Hide();
-                        loadingSpinner.Expire();
+                    loadingSpinner.Hide();
+                    loadingSpinner.Expire();
 
-                        Logger.Error(t.Exception, "Couldn't load bracket with error");
-                        Add(new WarningBox($"Your {BRACKET_FILENAME} file could not be parsed. Please check runtime.log for more details."));
-                    });
+                    Logger.Error(t.Exception, "Couldn't load bracket with error");
+                    Add(new WarningBox($"Your {BRACKET_FILENAME} file could not be parsed. Please check runtime.log for more details."));
 
                     return;
                 }
@@ -143,7 +140,7 @@ namespace osu.Game.Tournament
                         windowMode.Value = WindowMode.Windowed;
                     }), true);
                 });
-            });
+            }));
         }
     }
 }

From 7dc3940dee206b6ebec790078c4eefa6ee78b464 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 27 Jan 2022 21:41:09 +0100
Subject: [PATCH 2571/5547] Add test coverage for preserving legacy beatmap
 info defaults

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

diff --git a/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs b/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs
index 1edd21b5a9..3a6051ed43 100644
--- a/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs
+++ b/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs
@@ -794,5 +794,32 @@ namespace osu.Game.Tests.Beatmaps.Formats
                 Assert.That(path.Distance, Is.EqualTo(1));
             }
         }
+
+        [Test]
+        public void TestLegacyDefaultsPreserved()
+        {
+            var decoder = new LegacyBeatmapDecoder { ApplyOffsets = false };
+
+            using (var memoryStream = new MemoryStream())
+            using (var stream = new LineBufferedReader(memoryStream))
+            {
+                var decoded = decoder.Decode(stream);
+
+                Assert.Multiple(() =>
+                {
+                    Assert.That(decoded.BeatmapInfo.AudioLeadIn, Is.EqualTo(0));
+                    Assert.That(decoded.BeatmapInfo.StackLeniency, Is.EqualTo(0.7f));
+                    Assert.That(decoded.BeatmapInfo.SpecialStyle, Is.False);
+                    Assert.That(decoded.BeatmapInfo.LetterboxInBreaks, Is.False);
+                    Assert.That(decoded.BeatmapInfo.WidescreenStoryboard, Is.False);
+                    Assert.That(decoded.BeatmapInfo.EpilepsyWarning, Is.False);
+                    Assert.That(decoded.BeatmapInfo.SamplesMatchPlaybackRate, Is.False);
+                    Assert.That(decoded.BeatmapInfo.Countdown, Is.EqualTo(CountdownType.Normal));
+                    Assert.That(decoded.BeatmapInfo.CountdownOffset, Is.EqualTo(0));
+                    Assert.That(decoded.BeatmapInfo.Metadata.PreviewTime, Is.EqualTo(-1));
+                    Assert.That(decoded.BeatmapInfo.Ruleset.OnlineID, Is.EqualTo(0));
+                });
+            }
+        }
     }
 }

From 1b8136e3e0fa023a613dd0b66602b9b943db83d6 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 27 Jan 2022 21:41:30 +0100
Subject: [PATCH 2572/5547] Change some `BeatmapInfo` defaults in a backwards
 compatible manner

---
 osu.Game/Beatmaps/BeatmapInfo.cs                  |  4 ++--
 osu.Game/Beatmaps/BeatmapManager.cs               |  9 +--------
 osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs | 15 +++++++++++++++
 3 files changed, 18 insertions(+), 10 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapInfo.cs b/osu.Game/Beatmaps/BeatmapInfo.cs
index 3e6e33f1d0..e4bfd768b7 100644
--- a/osu.Game/Beatmaps/BeatmapInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapInfo.cs
@@ -99,11 +99,11 @@ namespace osu.Game.Beatmaps
 
         public bool LetterboxInBreaks { get; set; }
 
-        public bool WidescreenStoryboard { get; set; }
+        public bool WidescreenStoryboard { get; set; } = true;
 
         public bool EpilepsyWarning { get; set; }
 
-        public bool SamplesMatchPlaybackRate { get; set; }
+        public bool SamplesMatchPlaybackRate { get; set; } = true;
 
         public double DistanceSpacing { get; set; }
 
diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index 414b7cd12b..e4fdb3d471 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -90,14 +90,7 @@ namespace osu.Game.Beatmaps
             {
                 Beatmaps =
                 {
-                    new BeatmapInfo
-                    {
-                        Difficulty = new BeatmapDifficulty(),
-                        Ruleset = ruleset,
-                        Metadata = metadata,
-                        WidescreenStoryboard = true,
-                        SamplesMatchPlaybackRate = true,
-                    }
+                    new BeatmapInfo(ruleset, new BeatmapDifficulty(), metadata)
                 }
             };
 
diff --git a/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs b/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
index 35d1cefeca..01ba0fcc9f 100644
--- a/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
+++ b/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
@@ -56,6 +56,8 @@ namespace osu.Game.Beatmaps.Formats
             this.beatmap = beatmap;
             this.beatmap.BeatmapInfo.BeatmapVersion = FormatVersion;
 
+            applyLegacyDefaults(this.beatmap.BeatmapInfo);
+
             base.ParseStreamInto(stream, beatmap);
 
             flushPendingPoints();
@@ -70,6 +72,19 @@ namespace osu.Game.Beatmaps.Formats
                 hitObject.ApplyDefaults(this.beatmap.ControlPointInfo, this.beatmap.Difficulty);
         }
 
+        /// <summary>
+        /// Some `BeatmapInfo` members have default values that differ from the default values used by stable.
+        /// In addition, legacy beatmaps will sometimes not contain some configuration keys, in which case
+        /// the legacy default values should be used.
+        /// 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)
+        {
+            beatmapInfo.WidescreenStoryboard = false;
+            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)

From 6674567af1d678f33eb7c54920e3f11cba7301a5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 27 Jan 2022 21:51:51 +0100
Subject: [PATCH 2573/5547] Use -1 as the default preview time globally in
 metadata

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

diff --git a/osu.Game/Beatmaps/BeatmapMetadata.cs b/osu.Game/Beatmaps/BeatmapMetadata.cs
index cb38373bd3..1514d3af7a 100644
--- a/osu.Game/Beatmaps/BeatmapMetadata.cs
+++ b/osu.Game/Beatmaps/BeatmapMetadata.cs
@@ -39,7 +39,7 @@ namespace osu.Game.Beatmaps
         /// The time in milliseconds to begin playing the track for preview purposes.
         /// If -1, the track should begin playing at 40% of its length.
         /// </summary>
-        public int PreviewTime { get; set; }
+        public int PreviewTime { get; set; } = -1;
 
         public string AudioFile { get; set; } = string.Empty;
         public string BackgroundFile { get; set; } = string.Empty;

From 3e068e564d79d6b446b93a69904268abd19ba194 Mon Sep 17 00:00:00 2001
From: Spooghetti420 <kkovachev1947@gmail.com>
Date: Thu, 27 Jan 2022 20:56:51 +0000
Subject: [PATCH 2574/5547] Update mod per discussion + create test

---
 .../Mods/TestSceneManiaModNoHolds.cs          | 52 +++++++++++++
 osu.Game.Rulesets.Mania/ManiaRuleset.cs       |  2 +-
 .../Mods/ManiaModNoHolds.cs                   | 75 +++++++++++++++++++
 3 files changed, 128 insertions(+), 1 deletion(-)
 create mode 100644 osu.Game.Rulesets.Mania.Tests/Mods/TestSceneManiaModNoHolds.cs
 create mode 100644 osu.Game.Rulesets.Mania/Mods/ManiaModNoHolds.cs

diff --git a/osu.Game.Rulesets.Mania.Tests/Mods/TestSceneManiaModNoHolds.cs b/osu.Game.Rulesets.Mania.Tests/Mods/TestSceneManiaModNoHolds.cs
new file mode 100644
index 0000000000..411f891f43
--- /dev/null
+++ b/osu.Game.Rulesets.Mania.Tests/Mods/TestSceneManiaModNoHolds.cs
@@ -0,0 +1,52 @@
+// 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.Testing;
+using osu.Game.Beatmaps;
+using osu.Game.Rulesets.Mania.Mods;
+using osu.Game.Tests.Visual;
+using osu.Game.Rulesets.Mania.Tests;
+using System.Collections.Generic;
+using osu.Game.Rulesets.Mania.Objects;
+using osu.Game.Rulesets.Objects;
+using osu.Game.Beatmaps.ControlPoints;
+using osu.Game.Rulesets.Mania.Beatmaps;
+
+namespace osu.Game.Rulesets.Mania.Tests.Mods
+{
+    public class TestSceneManiaModNoHolds : ModTestScene
+    {
+        protected override Ruleset CreatePlayerRuleset() => new ManiaRuleset();
+
+        [Test]
+        public void TestMapHasNoHeldNotes()
+        {
+            var testBeatmap = createBeatmap();
+            Assert.That(!testBeatmap.HitObjects.OfType<HoldNote>().Any());
+        }
+
+
+        private static IBeatmap createBeatmap()
+        {
+            var beatmap = createRawBeatmap();
+            var noHoldsMod = new ManiaModNoHolds();
+
+            foreach (var hitObject in beatmap.HitObjects)
+                hitObject.ApplyDefaults(new ControlPointInfo(), new BeatmapDifficulty());
+
+            noHoldsMod.ApplyToBeatmap(beatmap);
+
+            return beatmap;
+        }
+        private static IBeatmap createRawBeatmap()
+        {
+            var beatmap = new ManiaBeatmap(new StageDefinition { Columns = 1 });
+            beatmap.HitObjects.Add(new Note { StartTime = 1000 });
+            beatmap.HitObjects.Add(new HoldNote { StartTime = 1000, EndTime = 3000 });
+            return beatmap;
+        }
+    }
+}
diff --git a/osu.Game.Rulesets.Mania/ManiaRuleset.cs b/osu.Game.Rulesets.Mania/ManiaRuleset.cs
index 3471f4ca66..55ca1a465e 100644
--- a/osu.Game.Rulesets.Mania/ManiaRuleset.cs
+++ b/osu.Game.Rulesets.Mania/ManiaRuleset.cs
@@ -244,7 +244,7 @@ namespace osu.Game.Rulesets.Mania
                         new ManiaModClassic(),
                         new ManiaModInvert(),
                         new ManiaModConstantSpeed(),
-                        new ManiaModNoLongNotes()
+                        new ManiaModNoHolds()
                     };
 
                 case ModType.Automation:
diff --git a/osu.Game.Rulesets.Mania/Mods/ManiaModNoHolds.cs b/osu.Game.Rulesets.Mania/Mods/ManiaModNoHolds.cs
new file mode 100644
index 0000000000..0d5ca44898
--- /dev/null
+++ b/osu.Game.Rulesets.Mania/Mods/ManiaModNoHolds.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 System.Linq;
+using osu.Framework.Extensions.IEnumerableExtensions;
+using osu.Game.Beatmaps;
+using osu.Game.Rulesets.Mania.Objects;
+using osu.Game.Rulesets.Mods;
+using osu.Framework.Graphics.Sprites;
+using System;
+using System.Collections.Generic;
+using osu.Game.Audio;
+using osu.Game.Rulesets.Mania.Beatmaps;
+using osu.Framework.Utils;
+using osu.Game.Overlays.Settings;
+using osu.Framework.Bindables;
+using osu.Game.Configuration;
+using osu.Game.Graphics;
+
+namespace osu.Game.Rulesets.Mania.Mods
+{
+    public class ManiaModNoHolds : Mod, IApplicableAfterBeatmapConversion
+    {
+        public override string Name => "No Holds";
+
+        public override string Acronym => "NH";
+
+        public override double ScoreMultiplier => 1;
+
+        public override string Description => @"Turns all hold notes into normal notes. No coordination required.";
+
+        public override IconUsage? Icon => FontAwesome.Solid.DotCircle;
+
+        public override ModType Type => ModType.Conversion;
+
+        [SettingSource("Add end notes", "Also add a note at the end of a hold note")]
+        public BindableBool AddEndNotes { get; } = new BindableBool
+        {
+            Default = true,
+            Value = true
+        };
+
+        public void ApplyToBeatmap(IBeatmap beatmap)
+        {
+            var maniaBeatmap = (ManiaBeatmap)beatmap;
+
+            var newObjects = new List<ManiaHitObject>();
+            foreach (var h in beatmap.HitObjects.OfType<HoldNote>())
+            {
+                // Add a note for the beginning of the hold note
+                newObjects.Add(new Note
+                {
+                    Column = h.Column,
+                    StartTime = h.StartTime,
+                    Samples = h.GetNodeSamples(0)
+                });
+
+                // Don't add an end note if the duration is shorter than some threshold, or end notes are disabled
+                if (AddEndNotes.Value && h.Duration > 200)
+                {
+                    newObjects.Add(new Note
+                    {
+                        Column = h.Column,
+                        StartTime = h.EndTime,
+                        Samples = h.GetNodeSamples((h.NodeSamples?.Count - 1) ?? 1)
+                    });
+                }
+            }
+
+            maniaBeatmap.HitObjects = maniaBeatmap.HitObjects.OfType<Note>().Concat(newObjects).OrderBy(h => h.StartTime).ToList();
+        }
+
+    }
+
+}

From 146c54a2c14608b95363647a0e965aeeb47aa03e Mon Sep 17 00:00:00 2001
From: Spooghetti420 <kkovachev1947@gmail.com>
Date: Thu, 27 Jan 2022 21:02:59 +0000
Subject: [PATCH 2575/5547] Fix code formatting

---
 .../Mods/TestSceneManiaModNoHolds.cs                          | 1 -
 osu.Game.Rulesets.Mania/Mods/ManiaModNoHolds.cs               | 4 +---
 2 files changed, 1 insertion(+), 4 deletions(-)

diff --git a/osu.Game.Rulesets.Mania.Tests/Mods/TestSceneManiaModNoHolds.cs b/osu.Game.Rulesets.Mania.Tests/Mods/TestSceneManiaModNoHolds.cs
index 411f891f43..f22b724c99 100644
--- a/osu.Game.Rulesets.Mania.Tests/Mods/TestSceneManiaModNoHolds.cs
+++ b/osu.Game.Rulesets.Mania.Tests/Mods/TestSceneManiaModNoHolds.cs
@@ -28,7 +28,6 @@ namespace osu.Game.Rulesets.Mania.Tests.Mods
             Assert.That(!testBeatmap.HitObjects.OfType<HoldNote>().Any());
         }
 
-
         private static IBeatmap createBeatmap()
         {
             var beatmap = createRawBeatmap();
diff --git a/osu.Game.Rulesets.Mania/Mods/ManiaModNoHolds.cs b/osu.Game.Rulesets.Mania/Mods/ManiaModNoHolds.cs
index 0d5ca44898..a18dbad4a1 100644
--- a/osu.Game.Rulesets.Mania/Mods/ManiaModNoHolds.cs
+++ b/osu.Game.Rulesets.Mania/Mods/ManiaModNoHolds.cs
@@ -69,7 +69,5 @@ namespace osu.Game.Rulesets.Mania.Mods
 
             maniaBeatmap.HitObjects = maniaBeatmap.HitObjects.OfType<Note>().Concat(newObjects).OrderBy(h => h.StartTime).ToList();
         }
-
     }
-
-}
+}
\ No newline at end of file

From f59828e2d9dc745e352ecbbf01fe811389e2ed47 Mon Sep 17 00:00:00 2001
From: Jamie Taylor <me@nekodex.net>
Date: Fri, 28 Jan 2022 13:27:12 +0900
Subject: [PATCH 2576/5547] Add audio feedback to song select 'random'

---
 osu.Game/Screens/Select/BeatmapCarousel.cs | 29 +++++++++++++++++++++-
 osu.Game/Screens/Select/SongSelect.cs      | 21 +++++++++++++---
 2 files changed, 46 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Screens/Select/BeatmapCarousel.cs b/osu.Game/Screens/Select/BeatmapCarousel.cs
index c27915c383..ef19eb187a 100644
--- a/osu.Game/Screens/Select/BeatmapCarousel.cs
+++ b/osu.Game/Screens/Select/BeatmapCarousel.cs
@@ -6,6 +6,8 @@ using System.Collections.Generic;
 using System.Diagnostics;
 using System.Linq;
 using osu.Framework.Allocation;
+using osu.Framework.Audio;
+using osu.Framework.Audio.Sample;
 using osu.Framework.Bindables;
 using osu.Framework.Caching;
 using osu.Framework.Graphics;
@@ -151,6 +153,10 @@ namespace osu.Game.Screens.Select
 
         private readonly DrawablePool<DrawableCarouselBeatmapSet> setPool = new DrawablePool<DrawableCarouselBeatmapSet>(100);
 
+        private Sample spinSample;
+
+        private int visibleSetsCount;
+
         public BeatmapCarousel()
         {
             root = new CarouselRoot(this);
@@ -169,8 +175,10 @@ namespace osu.Game.Screens.Select
         }
 
         [BackgroundDependencyLoader]
-        private void load(OsuConfigManager config)
+        private void load(OsuConfigManager config, AudioManager audio)
         {
+            spinSample = audio.Samples.Get("SongSelect/random-spin");
+
             config.BindWith(OsuSetting.RandomSelectAlgorithm, RandomAlgorithm);
             config.BindWith(OsuSetting.SongSelectRightMouseScroll, RightClickScrollingEnabled);
 
@@ -419,6 +427,9 @@ namespace osu.Game.Screens.Select
                 return false;
 
             var visibleSets = beatmapSets.Where(s => !s.Filtered.Value).ToList();
+
+            visibleSetsCount = visibleSets.Count;
+
             if (!visibleSets.Any())
                 return false;
 
@@ -450,6 +461,9 @@ namespace osu.Game.Screens.Select
             else
                 set = visibleSets.ElementAt(RNG.Next(visibleSets.Count));
 
+            if (selectedBeatmapSet != null)
+                playSpinSample(distanceBetween(set, selectedBeatmapSet));
+
             select(set);
             return true;
         }
@@ -464,12 +478,25 @@ namespace osu.Game.Screens.Select
                 {
                     if (RandomAlgorithm.Value == RandomSelectAlgorithm.RandomPermutation)
                         previouslyVisitedRandomSets.Remove(selectedBeatmapSet);
+
+                    if (selectedBeatmapSet != null)
+                        playSpinSample(distanceBetween(beatmap, selectedBeatmapSet));
+
                     select(beatmap);
                     break;
                 }
             }
         }
 
+        private double distanceBetween(CarouselItem item1, CarouselItem item2) => Math.Ceiling(Math.Abs(item1.CarouselYPosition - item2.CarouselYPosition) / DrawableCarouselItem.MAX_HEIGHT);
+
+        private void playSpinSample(double distance)
+        {
+            var chan = spinSample.GetChannel();
+            chan.Frequency.Value = 1f + Math.Min(1f, distance / visibleSetsCount);
+            chan.Play();
+        }
+
         private void select(CarouselItem item)
         {
             if (!AllowSelection)
diff --git a/osu.Game/Screens/Select/SongSelect.cs b/osu.Game/Screens/Select/SongSelect.cs
index 10150fcd9f..6fbadfe6cf 100644
--- a/osu.Game/Screens/Select/SongSelect.cs
+++ b/osu.Game/Screens/Select/SongSelect.cs
@@ -100,6 +100,7 @@ namespace osu.Game.Screens.Select
 
         private Sample sampleChangeDifficulty;
         private Sample sampleChangeBeatmap;
+        private Sample sampleRandomBeatmap;
 
         private Container carouselContainer;
 
@@ -109,6 +110,8 @@ namespace osu.Game.Screens.Select
 
         private double audioFeedbackLastPlaybackTime;
 
+        private bool randomClicked;
+
         [Resolved]
         private MusicController music { get; set; }
 
@@ -288,6 +291,7 @@ namespace osu.Game.Screens.Select
 
             sampleChangeDifficulty = audio.Samples.Get(@"SongSelect/select-difficulty");
             sampleChangeBeatmap = audio.Samples.Get(@"SongSelect/select-expand");
+            sampleRandomBeatmap = audio.Samples.Get(@"SongSelect/select-random");
             SampleConfirm = audio.Samples.Get(@"SongSelect/confirm-selection");
 
             if (dialogOverlay != null)
@@ -315,8 +319,16 @@ namespace osu.Game.Screens.Select
             (new FooterButtonMods { Current = Mods }, ModSelect),
             (new FooterButtonRandom
             {
-                NextRandom = () => Carousel.SelectNextRandom(),
-                PreviousRandom = Carousel.SelectPreviousRandom
+                NextRandom = () =>
+                {
+                    randomClicked = true;
+                    Carousel.SelectNextRandom();
+                },
+                PreviousRandom = () =>
+                {
+                    randomClicked = true;
+                    Carousel.SelectPreviousRandom();
+                }
             }, null),
             (new FooterButtonOptions(), BeatmapOptions)
         };
@@ -486,7 +498,9 @@ namespace osu.Game.Screens.Select
             {
                 if (beatmap != null && beatmapInfoPrevious != null && Time.Current - audioFeedbackLastPlaybackTime >= 50)
                 {
-                    if (beatmap.BeatmapSet?.ID == beatmapInfoPrevious.BeatmapSet?.ID)
+                    if (randomClicked)
+                        sampleRandomBeatmap.Play();
+                    else if (beatmap.BeatmapSet?.ID == beatmapInfoPrevious.BeatmapSet?.ID)
                         sampleChangeDifficulty.Play();
                     else
                         sampleChangeBeatmap.Play();
@@ -494,6 +508,7 @@ namespace osu.Game.Screens.Select
                     audioFeedbackLastPlaybackTime = Time.Current;
                 }
 
+                randomClicked = false;
                 beatmapInfoPrevious = beatmap;
             }
 

From c44af4853d6aabb82006d7944e146d82c06401fd Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 28 Jan 2022 13:43:53 +0900
Subject: [PATCH 2577/5547] Add thread safety to `PollingComponent.Poll`
 implementations

---
 .../Components/ListingPollingComponent.cs         | 14 ++++++++------
 .../Components/SelectionPollingComponent.cs       | 15 +++++++++------
 2 files changed, 17 insertions(+), 12 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Components/ListingPollingComponent.cs b/osu.Game/Screens/OnlinePlay/Components/ListingPollingComponent.cs
index fcf7767958..666d425f62 100644
--- a/osu.Game/Screens/OnlinePlay/Components/ListingPollingComponent.cs
+++ b/osu.Game/Screens/OnlinePlay/Components/ListingPollingComponent.cs
@@ -33,7 +33,7 @@ namespace osu.Game.Screens.OnlinePlay.Components
             });
         }
 
-        private GetRoomsRequest pollReq;
+        private GetRoomsRequest lastPollRequest;
 
         protected override Task Poll()
         {
@@ -45,10 +45,11 @@ namespace osu.Game.Screens.OnlinePlay.Components
 
             var tcs = new TaskCompletionSource<bool>();
 
-            pollReq?.Cancel();
-            pollReq = new GetRoomsRequest(Filter.Value.Status, Filter.Value.Category);
+            lastPollRequest?.Cancel();
 
-            pollReq.Success += result =>
+            var req = new GetRoomsRequest(Filter.Value.Status, Filter.Value.Category);
+
+            req.Success += result =>
             {
                 foreach (var existing in RoomManager.Rooms.ToArray())
                 {
@@ -66,10 +67,11 @@ namespace osu.Game.Screens.OnlinePlay.Components
                 tcs.SetResult(true);
             };
 
-            pollReq.Failure += _ => tcs.SetResult(false);
+            req.Failure += _ => tcs.SetResult(false);
 
-            API.Queue(pollReq);
+            API.Queue(req);
 
+            lastPollRequest = req;
             return tcs.Task;
         }
     }
diff --git a/osu.Game/Screens/OnlinePlay/Components/SelectionPollingComponent.cs b/osu.Game/Screens/OnlinePlay/Components/SelectionPollingComponent.cs
index 22842fbb9e..e05bdf8c8e 100644
--- a/osu.Game/Screens/OnlinePlay/Components/SelectionPollingComponent.cs
+++ b/osu.Game/Screens/OnlinePlay/Components/SelectionPollingComponent.cs
@@ -18,7 +18,7 @@ namespace osu.Game.Screens.OnlinePlay.Components
             this.room = room;
         }
 
-        private GetRoomRequest pollReq;
+        private GetRoomRequest lastPollRequest;
 
         protected override Task Poll()
         {
@@ -30,19 +30,22 @@ namespace osu.Game.Screens.OnlinePlay.Components
 
             var tcs = new TaskCompletionSource<bool>();
 
-            pollReq?.Cancel();
-            pollReq = new GetRoomRequest(room.RoomID.Value.Value);
+            lastPollRequest?.Cancel();
 
-            pollReq.Success += result =>
+            var req = new GetRoomRequest(room.RoomID.Value.Value);
+
+            req.Success += result =>
             {
                 result.RemoveExpiredPlaylistItems();
                 RoomManager.AddOrUpdateRoom(result);
                 tcs.SetResult(true);
             };
 
-            pollReq.Failure += _ => tcs.SetResult(false);
+            req.Failure += _ => tcs.SetResult(false);
 
-            API.Queue(pollReq);
+            API.Queue(req);
+
+            lastPollRequest = req;
 
             return tcs.Task;
         }

From c953a5d5034416bb32ee2caada7c0a74f0b4551a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 28 Jan 2022 13:44:09 +0900
Subject: [PATCH 2578/5547] Ensure `PollingComponent.Poll` is always called
 from the update thread

Not strictly required since all `Poll` implementations are now
threadsafe, but extra safety is never a bad thing?
---
 osu.Game/Online/PollingComponent.cs | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Online/PollingComponent.cs b/osu.Game/Online/PollingComponent.cs
index 243be8da44..5eddb3b49d 100644
--- a/osu.Game/Online/PollingComponent.cs
+++ b/osu.Game/Online/PollingComponent.cs
@@ -2,8 +2,10 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
+using System.Diagnostics;
 using System.Threading.Tasks;
 using osu.Framework.Bindables;
+using osu.Framework.Development;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Threading;
 
@@ -66,6 +68,8 @@ namespace osu.Game.Online
 
         private void doPoll()
         {
+            Debug.Assert(ThreadSafety.IsUpdateThread);
+
             scheduledPoll = null;
             pollingActive = true;
             Poll().ContinueWith(_ => pollComplete());
@@ -96,13 +100,13 @@ namespace osu.Game.Online
 
             if (!lastTimePolled.HasValue)
             {
-                doPoll();
+                Scheduler.AddOnce(doPoll);
                 return;
             }
 
             if (Time.Current - lastTimePolled.Value > TimeBetweenPolls.Value)
             {
-                doPoll();
+                Scheduler.AddOnce(doPoll);
                 return;
             }
 

From 91be77ad3d61f844c997681cfdf5b2643115bd43 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 28 Jan 2022 14:01:10 +0900
Subject: [PATCH 2579/5547] Fix null ref in `ComposeScreen` when ruleset
 doesn't provide a composer

---
 osu.Game/Screens/Edit/Compose/ComposeScreen.cs | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/osu.Game/Screens/Edit/Compose/ComposeScreen.cs b/osu.Game/Screens/Edit/Compose/ComposeScreen.cs
index 2bdf59b21c..2cde962b12 100644
--- a/osu.Game/Screens/Edit/Compose/ComposeScreen.cs
+++ b/osu.Game/Screens/Edit/Compose/ComposeScreen.cs
@@ -82,6 +82,11 @@ namespace osu.Game.Screens.Edit.Compose
         protected override void LoadComplete()
         {
             base.LoadComplete();
+
+            // May be null in the case of a ruleset that doesn't have editor support, see CreateMainContent().
+            if (composer == null)
+                return;
+
             EditorBeatmap.SelectedHitObjects.BindCollectionChanged((_, __) => updateClipboardActionAvailability());
             clipboard.BindValueChanged(_ => updateClipboardActionAvailability());
             composer.OnLoadComplete += _ => updateClipboardActionAvailability();

From b3856c900541e1af68aa8e4a5c55b9a03f62356f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 28 Jan 2022 14:01:31 +0900
Subject: [PATCH 2580/5547] Fix editor crashing on custom rulesets due to
 `ChangeHandler` not being supported

As per https://github.com/ppy/osu/discussions/16668, even without proper
saving support some ruleset developers do want to work on the editor.
This brings things back into a workable state.
---
 osu.Game/Screens/Edit/Editor.cs | 46 +++++++++++++++++++++++++++------
 1 file changed, 38 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Screens/Edit/Editor.cs b/osu.Game/Screens/Edit/Editor.cs
index 4812da98f4..2fead84deb 100644
--- a/osu.Game/Screens/Edit/Editor.cs
+++ b/osu.Game/Screens/Edit/Editor.cs
@@ -28,6 +28,8 @@ using osu.Game.Graphics.UserInterface;
 using osu.Game.Input.Bindings;
 using osu.Game.Online.API;
 using osu.Game.Overlays;
+using osu.Game.Overlays.Notifications;
+using osu.Game.Rulesets;
 using osu.Game.Rulesets.Edit;
 using osu.Game.Screens.Edit.Components;
 using osu.Game.Screens.Edit.Components.Menus;
@@ -61,7 +63,16 @@ namespace osu.Game.Screens.Edit
 
         public override bool? AllowTrackAdjustments => false;
 
-        protected bool HasUnsavedChanges => lastSavedHash != changeHandler.CurrentStateHash;
+        protected bool HasUnsavedChanges
+        {
+            get
+            {
+                if (!canSave)
+                    return false;
+
+                return lastSavedHash != changeHandler?.CurrentStateHash;
+            }
+        }
 
         [Resolved]
         private BeatmapManager beatmapManager { get; set; }
@@ -72,10 +83,15 @@ namespace osu.Game.Screens.Edit
         [Resolved(canBeNull: true)]
         private DialogOverlay dialogOverlay { get; set; }
 
+        [Resolved(canBeNull: true)]
+        private NotificationOverlay notifications { get; set; }
+
         public IBindable<bool> SamplePlaybackDisabled => samplePlaybackDisabled;
 
         private readonly Bindable<bool> samplePlaybackDisabled = new Bindable<bool>();
 
+        private bool canSave;
+
         private bool exitConfirmed;
 
         private string lastSavedHash;
@@ -92,6 +108,8 @@ namespace osu.Game.Screens.Edit
 
         private IBeatmap playableBeatmap;
         private EditorBeatmap editorBeatmap;
+
+        [CanBeNull] // Should be non-null once it can support custom rulesets.
         private EditorChangeHandler changeHandler;
 
         private EditorMenuBar menuBar;
@@ -172,8 +190,14 @@ namespace osu.Game.Screens.Edit
 
             AddInternal(editorBeatmap = new EditorBeatmap(playableBeatmap, loadableBeatmap.GetSkin(), loadableBeatmap.BeatmapInfo));
             dependencies.CacheAs(editorBeatmap);
-            changeHandler = new EditorChangeHandler(editorBeatmap);
-            dependencies.CacheAs<IEditorChangeHandler>(changeHandler);
+
+            canSave = editorBeatmap.BeatmapInfo.Ruleset.CreateInstance() is ILegacyRuleset;
+
+            if (canSave)
+            {
+                changeHandler = new EditorChangeHandler(editorBeatmap);
+                dependencies.CacheAs<IEditorChangeHandler>(changeHandler);
+            }
 
             beatDivisor.Value = editorBeatmap.BeatmapInfo.BeatDivisor;
             beatDivisor.BindValueChanged(divisor => editorBeatmap.BeatmapInfo.BeatDivisor = divisor.NewValue);
@@ -311,8 +335,8 @@ namespace osu.Game.Screens.Edit
                 }
             });
 
-            changeHandler.CanUndo.BindValueChanged(v => undoMenuItem.Action.Disabled = !v.NewValue, true);
-            changeHandler.CanRedo.BindValueChanged(v => redoMenuItem.Action.Disabled = !v.NewValue, true);
+            changeHandler?.CanUndo.BindValueChanged(v => undoMenuItem.Action.Disabled = !v.NewValue, true);
+            changeHandler?.CanRedo.BindValueChanged(v => redoMenuItem.Action.Disabled = !v.NewValue, true);
 
             menuBar.Mode.ValueChanged += onModeChanged;
         }
@@ -353,6 +377,12 @@ namespace osu.Game.Screens.Edit
 
         protected void Save()
         {
+            if (!canSave)
+            {
+                notifications?.Post(new SimpleErrorNotification { Text = "Saving is not supported for this ruleset yet, sorry!" });
+                return;
+            }
+
             // no longer new after first user-triggered save.
             isNewBeatmap = false;
 
@@ -648,9 +678,9 @@ namespace osu.Game.Screens.Edit
 
         #endregion
 
-        protected void Undo() => changeHandler.RestoreState(-1);
+        protected void Undo() => changeHandler?.RestoreState(-1);
 
-        protected void Redo() => changeHandler.RestoreState(1);
+        protected void Redo() => changeHandler?.RestoreState(1);
 
         private void resetTrack(bool seekToStart = false)
         {
@@ -761,7 +791,7 @@ namespace osu.Game.Screens.Edit
 
         private void updateLastSavedHash()
         {
-            lastSavedHash = changeHandler.CurrentStateHash;
+            lastSavedHash = changeHandler?.CurrentStateHash;
         }
 
         private List<MenuItem> createFileMenuItems()

From b7d8c9bf067f64021a4648ecfd413648258f373f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 28 Jan 2022 14:18:10 +0900
Subject: [PATCH 2581/5547] Fix a couple of cases of incorrect equality checks
 in the case both values are null

---
 .../BeatmapSet/Scores/TopScoreStatisticsSection.cs        | 3 +++
 .../Screens/Select/Leaderboards/BeatmapLeaderboard.cs     | 8 ++++++++
 2 files changed, 11 insertions(+)

diff --git a/osu.Game/Overlays/BeatmapSet/Scores/TopScoreStatisticsSection.cs b/osu.Game/Overlays/BeatmapSet/Scores/TopScoreStatisticsSection.cs
index 1f3f73a60a..ec795cf6b2 100644
--- a/osu.Game/Overlays/BeatmapSet/Scores/TopScoreStatisticsSection.cs
+++ b/osu.Game/Overlays/BeatmapSet/Scores/TopScoreStatisticsSection.cs
@@ -107,6 +107,9 @@ namespace osu.Game.Overlays.BeatmapSet.Scores
         {
             set
             {
+                if (score == null && value == null)
+                    return;
+
                 if (score?.Equals(value) == true)
                     return;
 
diff --git a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
index 2070e53257..31cbe91f5c 100644
--- a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
+++ b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
@@ -38,6 +38,14 @@ namespace osu.Game.Screens.Select.Leaderboards
             get => beatmapInfo;
             set
             {
+                if (beatmapInfo == null && value == null)
+                {
+                    // always null scores to ensure a correct initial display.
+                    // see weird `scoresLoadedOnce` logic in base implementation.
+                    Scores = null;
+                    return;
+                }
+
                 if (beatmapInfo?.Equals(value) == true)
                     return;
 

From f32d56e213fa26566b38ca12bb44cf9d8f0f0100 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 28 Jan 2022 14:48:17 +0900
Subject: [PATCH 2582/5547] Bring `HoldForMenuButton` tests up-to-date in code
 quality

---
 .../Gameplay/TestSceneHoldForMenuButton.cs    | 37 ++++++++++++-------
 1 file changed, 23 insertions(+), 14 deletions(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneHoldForMenuButton.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneHoldForMenuButton.cs
index 235842acc9..e0765ab5fb 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneHoldForMenuButton.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneHoldForMenuButton.cs
@@ -3,9 +3,10 @@
 
 using System.Linq;
 using NUnit.Framework;
-using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Sprites;
+using osu.Framework.Testing;
+using osu.Game.Graphics.Containers;
 using osu.Game.Screens.Play.HUD;
 using osuTK;
 using osuTK.Input;
@@ -19,28 +20,35 @@ namespace osu.Game.Tests.Visual.Gameplay
 
         protected override double TimePerAction => 100; // required for the early exit test, since hold-to-confirm delay is 200ms
 
-        [BackgroundDependencyLoader]
-        private void load()
+        private HoldForMenuButton holdForMenuButton;
+
+        [SetUpSteps]
+        public void SetUpSteps()
         {
-            HoldForMenuButton holdForMenuButton;
-
-            Add(holdForMenuButton = new HoldForMenuButton
+            AddStep("create button", () =>
             {
-                Origin = Anchor.BottomRight,
-                Anchor = Anchor.BottomRight,
-                Action = () => exitAction = true
+                exitAction = false;
+
+                Child = holdForMenuButton = new HoldForMenuButton
+                {
+                    Scale = new Vector2(2),
+                    Origin = Anchor.CentreRight,
+                    Anchor = Anchor.CentreRight,
+                    Action = () => exitAction = true
+                };
             });
+        }
 
-            var text = holdForMenuButton.Children.OfType<SpriteText>().First();
-
+        [Test]
+        public void TestMovementAndTrigger()
+        {
             AddStep("Trigger text fade in", () => InputManager.MoveMouseTo(holdForMenuButton));
-            AddUntilStep("Text visible", () => text.IsPresent && !exitAction);
+            AddUntilStep("Text visible", () => getSpriteText().IsPresent && !exitAction);
             AddStep("Trigger text fade out", () => InputManager.MoveMouseTo(Vector2.One));
-            AddUntilStep("Text is not visible", () => !text.IsPresent && !exitAction);
+            AddUntilStep("Text is not visible", () => !getSpriteText().IsPresent && !exitAction);
 
             AddStep("Trigger exit action", () =>
             {
-                exitAction = false;
                 InputManager.MoveMouseTo(holdForMenuButton);
                 InputManager.PressButton(MouseButton.Left);
             });
@@ -50,6 +58,7 @@ namespace osu.Game.Tests.Visual.Gameplay
 
             AddStep("Trigger exit action", () => InputManager.PressButton(MouseButton.Left));
             AddUntilStep($"{nameof(holdForMenuButton.Action)} was triggered", () => exitAction);
+            AddStep("Release", () => InputManager.ReleaseButton(MouseButton.Left));
         }
     }
 }

From 28c8e07e3f223aaaa15fe840fc8ee375c31dc48d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 28 Jan 2022 14:48:34 +0900
Subject: [PATCH 2583/5547] Ensure hold for menu button fades out if the cursor
 is never moved

Closes https://github.com/ppy/osu/discussions/16669.
---
 .../Visual/Gameplay/TestSceneHoldForMenuButton.cs      | 10 ++++++++++
 osu.Game/Screens/Play/HUD/HoldForMenuButton.cs         |  2 +-
 2 files changed, 11 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneHoldForMenuButton.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneHoldForMenuButton.cs
index e0765ab5fb..feec06f372 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneHoldForMenuButton.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneHoldForMenuButton.cs
@@ -60,5 +60,15 @@ namespace osu.Game.Tests.Visual.Gameplay
             AddUntilStep($"{nameof(holdForMenuButton.Action)} was triggered", () => exitAction);
             AddStep("Release", () => InputManager.ReleaseButton(MouseButton.Left));
         }
+
+        [Test]
+        public void TestFadeOnNoInput()
+        {
+            AddStep("move mouse away", () => InputManager.MoveMouseTo(Vector2.One));
+            AddUntilStep("wait for text fade out", () => !getSpriteText().IsPresent);
+            AddUntilStep("wait for button fade out", () => holdForMenuButton.Alpha < 0.1f);
+        }
+
+        private SpriteText getSpriteText() => holdForMenuButton.Children.OfType<SpriteText>().First();
     }
 }
diff --git a/osu.Game/Screens/Play/HUD/HoldForMenuButton.cs b/osu.Game/Screens/Play/HUD/HoldForMenuButton.cs
index 5a7ef786d3..430f001427 100644
--- a/osu.Game/Screens/Play/HUD/HoldForMenuButton.cs
+++ b/osu.Game/Screens/Play/HUD/HoldForMenuButton.cs
@@ -80,7 +80,7 @@ namespace osu.Game.Screens.Play.HUD
             base.LoadComplete();
         }
 
-        private float positionalAdjust;
+        private float positionalAdjust = 1; // Start at 1 to handle the case where a user never send positional input.
 
         protected override bool OnMouseMove(MouseMoveEvent e)
         {

From 32f9299fe082f7347aebfceef7aa6f8dd017f2f6 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 28 Jan 2022 15:26:29 +0900
Subject: [PATCH 2584/5547] Remove unused using

---
 osu.Game.Tests/Visual/Gameplay/TestSceneHoldForMenuButton.cs | 1 -
 1 file changed, 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneHoldForMenuButton.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneHoldForMenuButton.cs
index feec06f372..ddb0872541 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneHoldForMenuButton.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneHoldForMenuButton.cs
@@ -6,7 +6,6 @@ using NUnit.Framework;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Testing;
-using osu.Game.Graphics.Containers;
 using osu.Game.Screens.Play.HUD;
 using osuTK;
 using osuTK.Input;

From cb7ae413feea2e53fd4b5aa3b59167ae0a398c13 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 28 Jan 2022 15:50:13 +0900
Subject: [PATCH 2585/5547] Ensure test game is always active

---
 osu.Game/Tests/Visual/OsuGameTestScene.cs | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/osu.Game/Tests/Visual/OsuGameTestScene.cs b/osu.Game/Tests/Visual/OsuGameTestScene.cs
index ebbd9bb5dd..dabf49c15e 100644
--- a/osu.Game/Tests/Visual/OsuGameTestScene.cs
+++ b/osu.Game/Tests/Visual/OsuGameTestScene.cs
@@ -158,6 +158,14 @@ namespace osu.Game.Tests.Visual
 
                 Dependencies.Get<SessionStatics>().SetValue(Static.MutedAudioNotificationShownOnce, true);
             }
+
+            protected override void Update()
+            {
+                base.Update();
+
+                // when running in visual tests and the window loses focus, we generally don't want the game to pause.
+                ((Bindable<bool>)IsActive).Value = true;
+            }
         }
 
         public class TestLoader : Loader

From 778eebc94df6b2ff8a068b014aaee05de8bd594b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 28 Jan 2022 15:50:22 +0900
Subject: [PATCH 2586/5547] Add test coverage of local score import and
 deletion

---
 .../Navigation/TestSceneScreenNavigation.cs   | 90 +++++++++++++++----
 osu.Game/Tests/Visual/OsuGameTestScene.cs     |  3 +
 2 files changed, 74 insertions(+), 19 deletions(-)

diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs b/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
index 89dca77af4..6d89feef52 100644
--- a/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.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.Allocation;
@@ -10,16 +11,19 @@ using osu.Framework.Screens;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
 using osu.Game.Graphics.UserInterface;
+using osu.Game.Online.Leaderboards;
 using osu.Game.Overlays;
 using osu.Game.Overlays.Mods;
 using osu.Game.Overlays.Toolbar;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Osu.Mods;
+using osu.Game.Scoring;
 using osu.Game.Screens.Menu;
 using osu.Game.Screens.OnlinePlay.Lounge;
 using osu.Game.Screens.Play;
 using osu.Game.Screens.Ranking;
 using osu.Game.Screens.Select;
+using osu.Game.Screens.Select.Leaderboards;
 using osu.Game.Screens.Select.Options;
 using osu.Game.Tests.Beatmaps.IO;
 using osuTK;
@@ -96,35 +100,52 @@ namespace osu.Game.Tests.Visual.Navigation
         [Test]
         public void TestRetryFromResults()
         {
-            Player player = null;
-            ResultsScreen results = null;
+            var getOriginalPlayer = playToResults();
 
-            IWorkingBeatmap beatmap() => Game.Beatmap.Value;
+            AddStep("attempt to retry", () => ((ResultsScreen)Game.ScreenStack.CurrentScreen).ChildrenOfType<HotkeyRetryOverlay>().First().Action());
+            AddUntilStep("wait for player", () => Game.ScreenStack.CurrentScreen != getOriginalPlayer() && Game.ScreenStack.CurrentScreen is Player);
+        }
 
-            Screens.Select.SongSelect songSelect = null;
-            PushAndConfirm(() => songSelect = new TestPlaySongSelect());
-            AddUntilStep("wait for song select", () => songSelect.BeatmapSetsLoaded);
+        [Test]
+        public void TestDeleteScoreAfterPlaying()
+        {
+            playToResults();
 
-            AddStep("import beatmap", () => BeatmapImportHelper.LoadQuickOszIntoOsu(Game).WaitSafely());
+            ScoreInfo score = null;
+            LeaderboardScore scorePanel = null;
 
-            AddUntilStep("wait for selected", () => !Game.Beatmap.IsDefault);
+            AddStep("get score", () => score = ((ResultsScreen)Game.ScreenStack.CurrentScreen).Score);
 
-            AddStep("set mods", () => Game.SelectedMods.Value = new Mod[] { new OsuModNoFail(), new OsuModDoubleTime { SpeedChange = { Value = 2 } } });
+            AddAssert("ensure score is databased", () => Game.Realm.Run(r => r.Find<ScoreInfo>(score.ID)?.DeletePending == false));
 
-            AddStep("press enter", () => InputManager.Key(Key.Enter));
+            AddStep("press back button", () => Game.ChildrenOfType<BackButton>().First().Action());
 
-            AddUntilStep("wait for player", () =>
+            AddStep("show local scores", () => Game.ChildrenOfType<BeatmapDetailAreaTabControl>().First().Current.Value = new BeatmapDetailAreaLeaderboardTabItem<BeatmapLeaderboardScope>(BeatmapLeaderboardScope.Local));
+
+            AddUntilStep("wait for score displayed", () => (scorePanel = Game.ChildrenOfType<LeaderboardScore>().FirstOrDefault(s => s.Score.Equals(score))) != null);
+
+            AddStep("right click panel", () =>
             {
-                // dismiss any notifications that may appear (ie. muted notification).
-                clickMouseInCentre();
-                return (player = Game.ScreenStack.CurrentScreen as Player) != null;
+                InputManager.MoveMouseTo(scorePanel);
+                InputManager.Click(MouseButton.Right);
             });
 
-            AddUntilStep("wait for track playing", () => beatmap().Track.IsRunning);
-            AddStep("seek to near end", () => player.ChildrenOfType<GameplayClockContainer>().First().Seek(beatmap().Beatmap.HitObjects[^1].StartTime - 1000));
-            AddUntilStep("wait for pass", () => (results = Game.ScreenStack.CurrentScreen as ResultsScreen) != null && results.IsLoaded);
-            AddStep("attempt to retry", () => results.ChildrenOfType<HotkeyRetryOverlay>().First().Action());
-            AddUntilStep("wait for player", () => Game.ScreenStack.CurrentScreen != player && Game.ScreenStack.CurrentScreen is Player);
+            AddStep("click delete", () =>
+            {
+                var dropdownItem = Game
+                                   .ChildrenOfType<PlayBeatmapDetailArea>().First()
+                                   .ChildrenOfType<OsuContextMenu>().First()
+                                   .ChildrenOfType<DrawableOsuMenuItem>().First(i => i.Item.Text.ToString() == "Delete");
+
+                InputManager.MoveMouseTo(dropdownItem);
+                InputManager.Click(MouseButton.Left);
+            });
+
+            AddStep("confirm deletion", () => InputManager.Key(Key.Number1));
+
+            AddAssert("ensure score is pending deletion", () => Game.Realm.Run(r => r.Find<ScoreInfo>(score.ID)?.DeletePending == true));
+
+            AddUntilStep("wait for score panel removal", () => scorePanel.Parent == null);
         }
 
         [TestCase(true)]
@@ -432,6 +453,37 @@ namespace osu.Game.Tests.Visual.Navigation
             AddStep("test dispose doesn't crash", () => Game.Dispose());
         }
 
+        private Func<Player> playToResults()
+        {
+            Player player = null;
+
+            IWorkingBeatmap beatmap() => Game.Beatmap.Value;
+
+            Screens.Select.SongSelect songSelect = null;
+            PushAndConfirm(() => songSelect = new TestPlaySongSelect());
+            AddUntilStep("wait for song select", () => songSelect.BeatmapSetsLoaded);
+
+            AddStep("import beatmap", () => BeatmapImportHelper.LoadQuickOszIntoOsu(Game).WaitSafely());
+
+            AddUntilStep("wait for selected", () => !Game.Beatmap.IsDefault);
+
+            AddStep("set mods", () => Game.SelectedMods.Value = new Mod[] { new OsuModNoFail(), new OsuModDoubleTime { SpeedChange = { Value = 2 } } });
+
+            AddStep("press enter", () => InputManager.Key(Key.Enter));
+
+            AddUntilStep("wait for player", () =>
+            {
+                // dismiss any notifications that may appear (ie. muted notification).
+                clickMouseInCentre();
+                return (player = Game.ScreenStack.CurrentScreen as Player) != null;
+            });
+
+            AddUntilStep("wait for track playing", () => beatmap().Track.IsRunning);
+            AddStep("seek to near end", () => player.ChildrenOfType<GameplayClockContainer>().First().Seek(beatmap().Beatmap.HitObjects[^1].StartTime - 1000));
+            AddUntilStep("wait for pass", () => (Game.ScreenStack.CurrentScreen as ResultsScreen)?.IsLoaded == true);
+            return () => player;
+        }
+
         private void clickMouseInCentre()
         {
             InputManager.MoveMouseTo(Game.ScreenSpaceDrawQuad.Centre);
diff --git a/osu.Game/Tests/Visual/OsuGameTestScene.cs b/osu.Game/Tests/Visual/OsuGameTestScene.cs
index dabf49c15e..3b8d9a4cd1 100644
--- a/osu.Game/Tests/Visual/OsuGameTestScene.cs
+++ b/osu.Game/Tests/Visual/OsuGameTestScene.cs
@@ -14,6 +14,7 @@ using osu.Framework.Screens;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
 using osu.Game.Configuration;
+using osu.Game.Database;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Online.API;
 using osu.Game.Overlays;
@@ -111,6 +112,8 @@ namespace osu.Game.Tests.Visual
 
             public new ScreenStack ScreenStack => base.ScreenStack;
 
+            public RealmAccess Realm => Dependencies.Get<RealmAccess>();
+
             public new BackButton BackButton => base.BackButton;
 
             public new BeatmapManager BeatmapManager => base.BeatmapManager;

From 2453bf5ed0b8b3660c2a109ad2720ba125b1fc2c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 28 Jan 2022 15:54:51 +0900
Subject: [PATCH 2587/5547] Add test coverage of the same thing but via "clear
 all scores" button

---
 .../Navigation/TestSceneScreenNavigation.cs   | 29 +++++++++++++++++++
 1 file changed, 29 insertions(+)

diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs b/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
index 6d89feef52..3be7cf7c5c 100644
--- a/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
@@ -106,6 +106,35 @@ namespace osu.Game.Tests.Visual.Navigation
             AddUntilStep("wait for player", () => Game.ScreenStack.CurrentScreen != getOriginalPlayer() && Game.ScreenStack.CurrentScreen is Player);
         }
 
+        [Test]
+        public void TestDeleteAllScoresAfterPlaying()
+        {
+            playToResults();
+
+            ScoreInfo score = null;
+            LeaderboardScore scorePanel = null;
+
+            AddStep("get score", () => score = ((ResultsScreen)Game.ScreenStack.CurrentScreen).Score);
+
+            AddAssert("ensure score is databased", () => Game.Realm.Run(r => r.Find<ScoreInfo>(score.ID)?.DeletePending == false));
+
+            AddStep("press back button", () => Game.ChildrenOfType<BackButton>().First().Action());
+
+            AddStep("show local scores", () => Game.ChildrenOfType<BeatmapDetailAreaTabControl>().First().Current.Value = new BeatmapDetailAreaLeaderboardTabItem<BeatmapLeaderboardScope>(BeatmapLeaderboardScope.Local));
+
+            AddUntilStep("wait for score displayed", () => (scorePanel = Game.ChildrenOfType<LeaderboardScore>().FirstOrDefault(s => s.Score.Equals(score))) != null);
+
+            AddStep("open options", () => InputManager.Key(Key.F3));
+
+            AddStep("choose clear all scores", () => InputManager.Key(Key.Number4));
+
+            AddStep("confirm deletion", () => InputManager.Key(Key.Number1));
+
+            AddAssert("ensure score is pending deletion", () => Game.Realm.Run(r => r.Find<ScoreInfo>(score.ID)?.DeletePending == true));
+
+            AddUntilStep("wait for score panel removal", () => scorePanel.Parent == null);
+        }
+
         [Test]
         public void TestDeleteScoreAfterPlaying()
         {

From 0d3ac4fd9c72db8eb2049d07652375c0de419f0c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 28 Jan 2022 15:08:39 +0900
Subject: [PATCH 2588/5547] Fix delete local scores crashing the game

---
 osu.Game/Scoring/ScoreManager.cs                    | 9 +++++++++
 osu.Game/Screens/Select/BeatmapClearScoresDialog.cs | 2 +-
 2 files changed, 10 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Scoring/ScoreManager.cs b/osu.Game/Scoring/ScoreManager.cs
index 8f665224ee..6f9cce2d3c 100644
--- a/osu.Game/Scoring/ScoreManager.cs
+++ b/osu.Game/Scoring/ScoreManager.cs
@@ -266,6 +266,15 @@ namespace osu.Game.Scoring
             });
         }
 
+        public void Delete(BeatmapInfo beatmap, bool silent = false)
+        {
+            realm.Run(r =>
+            {
+                var beatmapScores = r.Find<BeatmapInfo>(beatmap.ID).Scores.ToList();
+                scoreModelManager.Delete(beatmapScores, silent);
+            });
+        }
+
         public void Delete(List<ScoreInfo> items, bool silent = false)
         {
             scoreModelManager.Delete(items, silent);
diff --git a/osu.Game/Screens/Select/BeatmapClearScoresDialog.cs b/osu.Game/Screens/Select/BeatmapClearScoresDialog.cs
index 774d3b4b28..4a16be4a3a 100644
--- a/osu.Game/Screens/Select/BeatmapClearScoresDialog.cs
+++ b/osu.Game/Screens/Select/BeatmapClearScoresDialog.cs
@@ -28,7 +28,7 @@ namespace osu.Game.Screens.Select
                     Text = @"Yes. Please.",
                     Action = () =>
                     {
-                        Task.Run(() => scoreManager.Delete(s => !s.DeletePending && s.BeatmapInfo.ID == beatmapInfo.ID))
+                        Task.Run(() => scoreManager.Delete(beatmapInfo))
                             .ContinueWith(_ => onCompletion);
                     }
                 },

From 4d9b61212b22d154c0632c0d50978e90ecc59f9d Mon Sep 17 00:00:00 2001
From: Jamie Taylor <me@nekodex.net>
Date: Fri, 28 Jan 2022 18:13:51 +0900
Subject: [PATCH 2589/5547] Add 'cursor tap' audio feedback

---
 osu.Game/Graphics/Cursor/MenuCursor.cs | 20 +++++++++++++++++++-
 1 file changed, 19 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Graphics/Cursor/MenuCursor.cs b/osu.Game/Graphics/Cursor/MenuCursor.cs
index 8e272f637f..a89d8dac71 100644
--- a/osu.Game/Graphics/Cursor/MenuCursor.cs
+++ b/osu.Game/Graphics/Cursor/MenuCursor.cs
@@ -10,6 +10,8 @@ using osu.Framework.Graphics.Sprites;
 using osu.Game.Configuration;
 using System;
 using JetBrains.Annotations;
+using osu.Framework.Audio;
+using osu.Framework.Audio.Sample;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics.Textures;
 using osu.Framework.Input.Events;
@@ -30,13 +32,17 @@ namespace osu.Game.Graphics.Cursor
         private DragRotationState dragRotationState;
         private Vector2 positionMouseDown;
 
+        private Sample tapSample;
+
         [BackgroundDependencyLoader(true)]
-        private void load([NotNull] OsuConfigManager config, [CanBeNull] ScreenshotManager screenshotManager)
+        private void load([NotNull] OsuConfigManager config, [CanBeNull] ScreenshotManager screenshotManager, AudioManager audio)
         {
             cursorRotate = config.GetBindable<bool>(OsuSetting.CursorRotation);
 
             if (screenshotManager != null)
                 screenshotCursorVisibility.BindTo(screenshotManager.CursorVisibility);
+
+            tapSample = audio.Samples.Get(@"UI/cursor-tap");
         }
 
         protected override bool OnMouseMove(MouseMoveEvent e)
@@ -70,6 +76,18 @@ namespace osu.Game.Graphics.Cursor
             return base.OnMouseMove(e);
         }
 
+        protected override bool OnClick(ClickEvent e)
+        {
+            var channel = tapSample.GetChannel();
+
+            // scale to [-0.75, 0.75] so that the sample isn't fully panned left or right (sounds weird)
+            channel.Balance.Value = ((activeCursor.X / DrawWidth) * 2 - 1) * 0.75;
+            channel.Frequency.Value = 0.99 + RNG.NextDouble(0.02);
+            channel.Play();
+
+            return base.OnClick(e);
+        }
+
         protected override bool OnMouseDown(MouseDownEvent e)
         {
             if (State.Value == Visibility.Visible)

From 17f0d7897b8a361a7a1fc5e6faa2379efc0a9a8c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 28 Jan 2022 18:35:59 +0900
Subject: [PATCH 2590/5547] Increase lenience of alpha check in
 `TestSceneOsuModNoScope`

I believe the [test
failures](https://github.com/ppy/osu/runs/4977283066?check_suite_focus=true)
we're seeing here are due to the implementation of interpolation of the
alpha being frame dependent (in a way that doesn't interact well with
tests). The reason for never hitting the expected value is that the
beatmap ends, causing the cursor to become fully visible again.

It's probably already good-enough for most cases, so let's attempt to
silence these test failures by not checking so precisely for the alpha
value.

We're checking for either 1 or 0 so it's not too important how close it
is to either.
---
 osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModNoScope.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModNoScope.cs b/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModNoScope.cs
index 8e226c7ded..44404ca245 100644
--- a/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModNoScope.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModNoScope.cs
@@ -145,6 +145,6 @@ namespace osu.Game.Rulesets.Osu.Tests.Mods
 
         private bool isBreak() => Player.IsBreakTime.Value;
 
-        private bool cursorAlphaAlmostEquals(float alpha) => Precision.AlmostEquals(Player.DrawableRuleset.Cursor.Alpha, alpha);
+        private bool cursorAlphaAlmostEquals(float alpha) => Precision.AlmostEquals(Player.DrawableRuleset.Cursor.Alpha, alpha, 0.1f);
     }
 }

From 142a67e1634fb379e8725d3ad51e5cf4dd9825a6 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 28 Jan 2022 18:53:28 +0900
Subject: [PATCH 2591/5547] Fix approach rate not being transferred from OD on
 older beatmaps

---
 osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs b/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
index 01ba0fcc9f..07ada8ecc4 100644
--- a/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
+++ b/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
@@ -311,10 +311,13 @@ namespace osu.Game.Beatmaps.Formats
 
                 case @"OverallDifficulty":
                     difficulty.OverallDifficulty = Parsing.ParseFloat(pair.Value);
+                    if (!hasApproachRate)
+                        difficulty.ApproachRate = difficulty.OverallDifficulty;
                     break;
 
                 case @"ApproachRate":
                     difficulty.ApproachRate = Parsing.ParseFloat(pair.Value);
+                    hasApproachRate = true;
                     break;
 
                 case @"SliderMultiplier":
@@ -432,6 +435,7 @@ namespace osu.Game.Beatmaps.Formats
         private readonly List<ControlPoint> pendingControlPoints = new List<ControlPoint>();
         private readonly HashSet<Type> pendingControlPointTypes = new HashSet<Type>();
         private double pendingControlPointsTime;
+        private bool hasApproachRate;
 
         private void addControlPoint(double time, ControlPoint point, bool timingChange)
         {

From 53ca597e2b2c85431c722f1801f00805179b150b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 28 Jan 2022 19:12:32 +0900
Subject: [PATCH 2592/5547] Update framework

---
 osu.Android.props        | 2 +-
 osu.Game/osu.Game.csproj | 2 +-
 osu.iOS.props            | 4 ++--
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Android.props b/osu.Android.props
index f85a96f819..2902c74f0a 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -52,7 +52,7 @@
   </ItemGroup>
   <ItemGroup>
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.115.0" />
-    <PackageReference Include="ppy.osu.Framework.Android" Version="2022.126.0" />
+    <PackageReference Include="ppy.osu.Framework.Android" Version="2022.128.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
     <!-- Realm needs to be directly referenced in all Xamarin projects, as it will not pull in its transitive dependencies otherwise. -->
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index aa6fb93aa0..b74d51e8f1 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="10.8.0" />
-    <PackageReference Include="ppy.osu.Framework" Version="2022.126.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2022.128.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.115.0" />
     <PackageReference Include="Sentry" Version="3.13.0" />
     <PackageReference Include="SharpCompress" Version="0.30.1" />
diff --git a/osu.iOS.props b/osu.iOS.props
index fbb4688588..90ffb9605f 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -60,7 +60,7 @@
     <Reference Include="System.Net.Http" />
   </ItemGroup>
   <ItemGroup Label="Package References">
-    <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.126.0" />
+    <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.128.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.115.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net5.0 / net6.0) -->
@@ -83,7 +83,7 @@
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="2.2.6" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.Core" Version="2.2.6" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
-    <PackageReference Include="ppy.osu.Framework" Version="2022.126.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2022.128.0" />
     <PackageReference Include="SharpCompress" Version="0.30.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
     <PackageReference Include="System.ComponentModel.Annotations" Version="5.0.0" />

From bda3cdc9a773ac76c36470174e13db398e33fd7e Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 28 Jan 2022 19:28:42 +0900
Subject: [PATCH 2593/5547] Add tests

---
 .../Formats/LegacyBeatmapDecoderTest.cs       | 42 +++++++++++++++++++
 ...approach-rate-after-overall-difficulty.osu |  3 ++
 ...pproach-rate-before-overall-difficulty.osu |  3 ++
 .../Resources/undefined-approach-rate.osu     |  2 +
 4 files changed, 50 insertions(+)
 create mode 100644 osu.Game.Tests/Resources/approach-rate-after-overall-difficulty.osu
 create mode 100644 osu.Game.Tests/Resources/approach-rate-before-overall-difficulty.osu
 create mode 100644 osu.Game.Tests/Resources/undefined-approach-rate.osu

diff --git a/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs b/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs
index 3a6051ed43..468cb7683c 100644
--- a/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs
+++ b/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs
@@ -821,5 +821,47 @@ namespace osu.Game.Tests.Beatmaps.Formats
                 });
             }
         }
+
+        [Test]
+        public void TestUndefinedApproachRateInheritsOverallDifficulty()
+        {
+            var decoder = new LegacyBeatmapDecoder { ApplyOffsets = false };
+
+            using (var resStream = TestResources.OpenResource("undefined-approach-rate.osu"))
+            using (var stream = new LineBufferedReader(resStream))
+            {
+                var decoded = decoder.Decode(stream);
+                Assert.That(decoded.Difficulty.ApproachRate, Is.EqualTo(1));
+                Assert.That(decoded.Difficulty.OverallDifficulty, Is.EqualTo(1));
+            }
+        }
+
+        [Test]
+        public void TestApproachRateDefinedBeforeOverallDifficulty()
+        {
+            var decoder = new LegacyBeatmapDecoder { ApplyOffsets = false };
+
+            using (var resStream = TestResources.OpenResource("approach-rate-before-overall-difficulty.osu"))
+            using (var stream = new LineBufferedReader(resStream))
+            {
+                var decoded = decoder.Decode(stream);
+                Assert.That(decoded.Difficulty.ApproachRate, Is.EqualTo(9));
+                Assert.That(decoded.Difficulty.OverallDifficulty, Is.EqualTo(1));
+            }
+        }
+
+        [Test]
+        public void TestApproachRateDefinedAfterOverallDifficulty()
+        {
+            var decoder = new LegacyBeatmapDecoder { ApplyOffsets = false };
+
+            using (var resStream = TestResources.OpenResource("approach-rate-after-overall-difficulty.osu"))
+            using (var stream = new LineBufferedReader(resStream))
+            {
+                var decoded = decoder.Decode(stream);
+                Assert.That(decoded.Difficulty.ApproachRate, Is.EqualTo(9));
+                Assert.That(decoded.Difficulty.OverallDifficulty, Is.EqualTo(1));
+            }
+        }
     }
 }
diff --git a/osu.Game.Tests/Resources/approach-rate-after-overall-difficulty.osu b/osu.Game.Tests/Resources/approach-rate-after-overall-difficulty.osu
new file mode 100644
index 0000000000..23732aef8c
--- /dev/null
+++ b/osu.Game.Tests/Resources/approach-rate-after-overall-difficulty.osu
@@ -0,0 +1,3 @@
+[Difficulty]
+OverallDifficulty:1
+ApproachRate:9
\ No newline at end of file
diff --git a/osu.Game.Tests/Resources/approach-rate-before-overall-difficulty.osu b/osu.Game.Tests/Resources/approach-rate-before-overall-difficulty.osu
new file mode 100644
index 0000000000..18885c6624
--- /dev/null
+++ b/osu.Game.Tests/Resources/approach-rate-before-overall-difficulty.osu
@@ -0,0 +1,3 @@
+[Difficulty]
+ApproachRate:9
+OverallDifficulty:1
\ No newline at end of file
diff --git a/osu.Game.Tests/Resources/undefined-approach-rate.osu b/osu.Game.Tests/Resources/undefined-approach-rate.osu
new file mode 100644
index 0000000000..0de24238bf
--- /dev/null
+++ b/osu.Game.Tests/Resources/undefined-approach-rate.osu
@@ -0,0 +1,2 @@
+[Difficulty]
+OverallDifficulty:1
\ No newline at end of file

From 397971c6313eff22d645c07d782547a4e7683a2e Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 28 Jan 2022 22:06:34 +0900
Subject: [PATCH 2594/5547] Change FrameDataBundle.Frames into an IList

---
 osu.Game/Online/Spectator/FrameDataBundle.cs | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Online/Spectator/FrameDataBundle.cs b/osu.Game/Online/Spectator/FrameDataBundle.cs
index 0e59cdf4ce..a4c4972989 100644
--- a/osu.Game/Online/Spectator/FrameDataBundle.cs
+++ b/osu.Game/Online/Spectator/FrameDataBundle.cs
@@ -20,16 +20,16 @@ namespace osu.Game.Online.Spectator
         public FrameHeader Header { get; set; }
 
         [Key(1)]
-        public IEnumerable<LegacyReplayFrame> Frames { get; set; }
+        public IList<LegacyReplayFrame> Frames { get; set; }
 
-        public FrameDataBundle(ScoreInfo score, IEnumerable<LegacyReplayFrame> frames)
+        public FrameDataBundle(ScoreInfo score, IList<LegacyReplayFrame> frames)
         {
             Frames = frames;
             Header = new FrameHeader(score);
         }
 
         [JsonConstructor]
-        public FrameDataBundle(FrameHeader header, IEnumerable<LegacyReplayFrame> frames)
+        public FrameDataBundle(FrameHeader header, IList<LegacyReplayFrame> frames)
         {
             Header = header;
             Frames = frames;

From 3037a3a7696b7f00cef3820c5c5994949de78622 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 28 Jan 2022 22:26:05 +0900
Subject: [PATCH 2595/5547] Purge final spectator frames before ending play

---
 .../Visual/Gameplay/TestSceneSpectator.cs      | 18 ++++++++++++++++++
 osu.Game/Online/Spectator/SpectatorClient.cs   | 10 ++++++++--
 .../Visual/Spectator/TestSpectatorClient.cs    | 11 +++++++++++
 3 files changed, 37 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs
index 0afd2c76dd..d1a25b07ec 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs
@@ -15,11 +15,14 @@ using osu.Game.Online.Spectator;
 using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Osu.Replays;
 using osu.Game.Rulesets.UI;
+using osu.Game.Scoring;
 using osu.Game.Screens;
 using osu.Game.Screens.Play;
+using osu.Game.Tests.Beatmaps;
 using osu.Game.Tests.Beatmaps.IO;
 using osu.Game.Tests.Visual.Multiplayer;
 using osu.Game.Tests.Visual.Spectator;
+using osuTK;
 
 namespace osu.Game.Tests.Visual.Gameplay
 {
@@ -200,6 +203,21 @@ namespace osu.Game.Tests.Visual.Gameplay
             AddAssert("screen didn't change", () => Stack.CurrentScreen is SoloSpectator);
         }
 
+        [Test]
+        public void TestFinalFramesPurgedBeforeEndingPlay()
+        {
+            AddStep("begin playing", () => spectatorClient.BeginPlaying(new GameplayState(new TestBeatmap(new OsuRuleset().RulesetInfo), new OsuRuleset()), new Score()));
+
+            AddStep("send frames and finish play", () =>
+            {
+                spectatorClient.HandleFrame(new OsuReplayFrame(1000, Vector2.Zero));
+                spectatorClient.EndPlaying();
+            });
+
+            // We can't access API because we're an "online" test.
+            AddAssert("last received frame has time = 1000", () => spectatorClient.LastReceivedFrame.First().Value.Time == 1000);
+        }
+
         private OsuFramedReplayInputHandler replayHandler =>
             (OsuFramedReplayInputHandler)Stack.ChildrenOfType<OsuInputManager>().First().ReplayInputHandler;
 
diff --git a/osu.Game/Online/Spectator/SpectatorClient.cs b/osu.Game/Online/Spectator/SpectatorClient.cs
index 4da9bace70..fddb94fad7 100644
--- a/osu.Game/Online/Spectator/SpectatorClient.cs
+++ b/osu.Game/Online/Spectator/SpectatorClient.cs
@@ -167,6 +167,9 @@ namespace osu.Game.Online.Spectator
                 if (!IsPlaying)
                     return;
 
+                if (pendingFrames.Count > 0)
+                    purgePendingFrames(true);
+
                 IsPlaying = false;
                 currentBeatmap = null;
 
@@ -238,9 +241,12 @@ namespace osu.Game.Online.Spectator
                 purgePendingFrames();
         }
 
-        private void purgePendingFrames()
+        private void purgePendingFrames(bool force = false)
         {
-            if (lastSend?.IsCompleted == false)
+            if (lastSend?.IsCompleted == false && !force)
+                return;
+
+            if (pendingFrames.Count == 0)
                 return;
 
             var frames = pendingFrames.ToArray();
diff --git a/osu.Game/Tests/Visual/Spectator/TestSpectatorClient.cs b/osu.Game/Tests/Visual/Spectator/TestSpectatorClient.cs
index f206d4f8b0..3f3d0f5b01 100644
--- a/osu.Game/Tests/Visual/Spectator/TestSpectatorClient.cs
+++ b/osu.Game/Tests/Visual/Spectator/TestSpectatorClient.cs
@@ -14,6 +14,7 @@ using osu.Framework.Utils;
 using osu.Game.Online.API;
 using osu.Game.Online.Spectator;
 using osu.Game.Replays.Legacy;
+using osu.Game.Rulesets.Replays;
 using osu.Game.Scoring;
 
 namespace osu.Game.Tests.Visual.Spectator
@@ -27,12 +28,22 @@ namespace osu.Game.Tests.Visual.Spectator
 
         public override IBindable<bool> IsConnected { get; } = new Bindable<bool>(true);
 
+        public readonly Dictionary<int, ReplayFrame> LastReceivedFrame = new Dictionary<int, ReplayFrame>();
         private readonly Dictionary<int, int> userBeatmapDictionary = new Dictionary<int, int>();
         private readonly Dictionary<int, int> userNextFrameDictionary = new Dictionary<int, int>();
 
         [Resolved]
         private IAPIProvider api { get; set; } = null!;
 
+        public TestSpectatorClient()
+        {
+            OnNewFrames += (i, bundle) =>
+            {
+                if (PlayingUsers.Contains(i))
+                    LastReceivedFrame[i] = bundle.Frames[^1];
+            };
+        }
+
         /// <summary>
         /// Starts play for an arbitrary user.
         /// </summary>

From 1253e1ecc1f7ec68f78f7b30878b673b2c37345d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 28 Jan 2022 20:25:12 +0100
Subject: [PATCH 2596/5547] Replace LINQ `Count()` invocation with count
 property access

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

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorPlayback.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorPlayback.cs
index 4790bd44db..90abdf2ba3 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorPlayback.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorPlayback.cs
@@ -184,7 +184,7 @@ namespace osu.Game.Tests.Visual.Gameplay
 
         private void onNewFrames(int userId, FrameDataBundle frames)
         {
-            Logger.Log($"Received {frames.Frames.Count()} new frames ({string.Join(',', frames.Frames.Select(f => ((int)f.Time).ToString()))})");
+            Logger.Log($"Received {frames.Frames.Count} new frames ({string.Join(',', frames.Frames.Select(f => ((int)f.Time).ToString()))})");
 
             foreach (var legacyFrame in frames.Frames)
             {

From a4aa501bb540cd83f988febd90d128f1c890b0b9 Mon Sep 17 00:00:00 2001
From: Spooghetti420 <kkovachev1947@gmail.com>
Date: Fri, 28 Jan 2022 21:59:53 +0000
Subject: [PATCH 2597/5547] Change threshold from ms to beat-based, add tests

---
 .../Mods/TestSceneManiaModHoldOff.cs          | 130 ++++++++++++++++++
 .../Mods/TestSceneManiaModNoHolds.cs          |  51 -------
 osu.Game.Rulesets.Mania/ManiaRuleset.cs       |   2 +-
 ...{ManiaModNoHolds.cs => ManiaModHoldOff.cs} |  34 +++--
 .../Mods/ManiaModNoLongNotes.cs               |  86 ------------
 5 files changed, 155 insertions(+), 148 deletions(-)
 create mode 100644 osu.Game.Rulesets.Mania.Tests/Mods/TestSceneManiaModHoldOff.cs
 delete mode 100644 osu.Game.Rulesets.Mania.Tests/Mods/TestSceneManiaModNoHolds.cs
 rename osu.Game.Rulesets.Mania/Mods/{ManiaModNoHolds.cs => ManiaModHoldOff.cs} (66%)
 delete mode 100644 osu.Game.Rulesets.Mania/Mods/ManiaModNoLongNotes.cs

diff --git a/osu.Game.Rulesets.Mania.Tests/Mods/TestSceneManiaModHoldOff.cs b/osu.Game.Rulesets.Mania.Tests/Mods/TestSceneManiaModHoldOff.cs
new file mode 100644
index 0000000000..e157cb50b1
--- /dev/null
+++ b/osu.Game.Rulesets.Mania.Tests/Mods/TestSceneManiaModHoldOff.cs
@@ -0,0 +1,130 @@
+// 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.Game.Beatmaps;
+using osu.Game.Rulesets.Mania.Mods;
+using osu.Game.Tests.Visual;
+using System.Collections.Generic;
+using osu.Game.Rulesets.Mania.Objects;
+using osu.Game.Beatmaps.ControlPoints;
+using osu.Game.Rulesets.Mania.Beatmaps;
+using osu.Game.Rulesets.Mania.Difficulty;
+using osu.Game.Tests.Beatmaps;
+
+namespace osu.Game.Rulesets.Mania.Tests.Mods
+{
+    public class TestSceneManiaModHoldOff : ModTestScene
+    {
+        protected override Ruleset CreatePlayerRuleset() => new ManiaRuleset();
+
+        [Test]
+        public void TestMapHasNoHoldNotes()
+        {
+            var testBeatmap = createModdedBeatmap();
+            Assert.False(testBeatmap.HitObjects.OfType<HoldNote>().Any());
+        }
+
+        [Test]
+        public void TestCorrectNoteValues()
+        {
+            var testBeatmap = createRawBeatmap();
+            var noteValues = new List<double>(testBeatmap.HitObjects.OfType<HoldNote>().Count());
+            foreach (HoldNote h in testBeatmap.HitObjects.OfType<HoldNote>()) {
+                noteValues.Add(ManiaModHoldOff.getNoteValue(h, (ManiaBeatmap)testBeatmap));
+            }
+            noteValues.Sort();
+            Assert.AreEqual(noteValues, new List<double> { 0.125, 0.250, 0.500, 1.000, 2.000 });
+        }
+
+        [TestCase(ManiaModHoldOff.BeatDivisors.Whole)]
+        [TestCase(ManiaModHoldOff.BeatDivisors.Half)]
+        [TestCase(ManiaModHoldOff.BeatDivisors.Quarter)]
+        [TestCase(ManiaModHoldOff.BeatDivisors.Eighth)]
+        public void TestCorrectObjectCount(ManiaModHoldOff.BeatDivisors minBeatSnap) {
+            /*
+                This test is to ensure that, given that end notes are enabled,
+                the mod produces the expected number of objects when the mod is applied.
+            */
+
+            // Mod settings will be set to include the correct beat snap value
+            var rawBeatmap = createRawBeatmap();
+            var testBeatmap = createModdedBeatmap(minBeatSnap);
+
+            // Calculate expected number of objects
+            int expectedObjectCount = 0;
+            double beatSnapValue = 1/(Math.Pow(2, (int)minBeatSnap));
+
+            foreach (ManiaHitObject h in rawBeatmap.HitObjects) {
+                // Both notes and hold notes account for at least one object
+                expectedObjectCount++;
+                if (h.GetType() == typeof(HoldNote)) {
+                    var noteValue = ManiaModHoldOff.getNoteValue((HoldNote)h, (ManiaBeatmap)rawBeatmap);
+                    if (noteValue >= beatSnapValue) {
+                        // Should generate an end note if it's longer than the minimum note value
+                        expectedObjectCount++;
+                    }
+                }
+            }
+
+            Assert.That(testBeatmap.HitObjects.Count() == expectedObjectCount);
+        }
+
+        [Test]
+        public void TestDifficultyIncrease() {
+            // A lower minimum beat snap divisor should only make the map harder, never easier
+            // (as more notes can be spawned)
+            var beatmaps = new ManiaBeatmap[] {
+                createModdedBeatmap(ManiaModHoldOff.BeatDivisors.Whole),
+                createModdedBeatmap(ManiaModHoldOff.BeatDivisors.Half),
+                createModdedBeatmap(ManiaModHoldOff.BeatDivisors.Quarter),
+                createModdedBeatmap(ManiaModHoldOff.BeatDivisors.Eighth),
+                createModdedBeatmap(ManiaModHoldOff.BeatDivisors.Sixteenth)
+            };
+
+            var mapDifficulties = new double[beatmaps.Length];
+            for (int i = 0; i < mapDifficulties.Length; i++) {
+                var workingBeatmap = new TestWorkingBeatmap(beatmaps[i]);
+                var difficultyCalculator = new ManiaDifficultyCalculator(new ManiaRuleset().RulesetInfo, workingBeatmap);
+                mapDifficulties[i] = difficultyCalculator.Calculate().StarRating;
+                if (i > 0) {
+                    Assert.LessOrEqual(mapDifficulties[i-1], mapDifficulties[i]);
+                    Assert.LessOrEqual(beatmaps[i-1].HitObjects.Count, beatmaps[i].HitObjects.Count);
+                }
+            }
+        }
+
+        private static ManiaBeatmap createModdedBeatmap(ManiaModHoldOff.BeatDivisors minBeatSnap=ManiaModHoldOff.BeatDivisors.Whole)
+        {
+            var beatmap = createRawBeatmap();
+            var holdOffMod = new ManiaModHoldOff();
+            holdOffMod.MinBeatSnap.Value = minBeatSnap; // Set the specified beat snap setting
+            Assert.AreEqual(holdOffMod.MinBeatSnap.Value, minBeatSnap);
+
+            foreach (var hitObject in beatmap.HitObjects)
+                hitObject.ApplyDefaults(beatmap.ControlPointInfo, new BeatmapDifficulty());
+
+            holdOffMod.ApplyToBeatmap(beatmap);
+
+            return (ManiaBeatmap)beatmap;
+        }
+        private static ManiaBeatmap createRawBeatmap()
+        {
+            var beatmap = new ManiaBeatmap(new StageDefinition { Columns = 1 });
+            beatmap.ControlPointInfo.Add(0.0, new TimingControlPoint { BeatLength = 1000 } ); // Set BPM to 60
+
+            // Add test hit objects
+            beatmap.HitObjects.Add(new Note { StartTime = 4000 });
+            beatmap.HitObjects.Add(new Note { StartTime = 4500 });
+            beatmap.HitObjects.Add(new HoldNote { StartTime = 0, EndTime = 125 });  // 1/8 note
+            beatmap.HitObjects.Add(new HoldNote { StartTime = 0, EndTime = 250 });  // 1/4 note
+            beatmap.HitObjects.Add(new HoldNote { StartTime = 0, EndTime = 500 });  // 1/2 note
+            beatmap.HitObjects.Add(new HoldNote { StartTime = 0, EndTime = 1000 }); // 1/1 note
+            beatmap.HitObjects.Add(new HoldNote { StartTime = 0, EndTime = 2000 }); // 2/1 note
+
+            return beatmap;
+        }
+    }
+}
diff --git a/osu.Game.Rulesets.Mania.Tests/Mods/TestSceneManiaModNoHolds.cs b/osu.Game.Rulesets.Mania.Tests/Mods/TestSceneManiaModNoHolds.cs
deleted file mode 100644
index f22b724c99..0000000000
--- a/osu.Game.Rulesets.Mania.Tests/Mods/TestSceneManiaModNoHolds.cs
+++ /dev/null
@@ -1,51 +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.Linq;
-using NUnit.Framework;
-using osu.Framework.Allocation;
-using osu.Framework.Testing;
-using osu.Game.Beatmaps;
-using osu.Game.Rulesets.Mania.Mods;
-using osu.Game.Tests.Visual;
-using osu.Game.Rulesets.Mania.Tests;
-using System.Collections.Generic;
-using osu.Game.Rulesets.Mania.Objects;
-using osu.Game.Rulesets.Objects;
-using osu.Game.Beatmaps.ControlPoints;
-using osu.Game.Rulesets.Mania.Beatmaps;
-
-namespace osu.Game.Rulesets.Mania.Tests.Mods
-{
-    public class TestSceneManiaModNoHolds : ModTestScene
-    {
-        protected override Ruleset CreatePlayerRuleset() => new ManiaRuleset();
-
-        [Test]
-        public void TestMapHasNoHeldNotes()
-        {
-            var testBeatmap = createBeatmap();
-            Assert.That(!testBeatmap.HitObjects.OfType<HoldNote>().Any());
-        }
-
-        private static IBeatmap createBeatmap()
-        {
-            var beatmap = createRawBeatmap();
-            var noHoldsMod = new ManiaModNoHolds();
-
-            foreach (var hitObject in beatmap.HitObjects)
-                hitObject.ApplyDefaults(new ControlPointInfo(), new BeatmapDifficulty());
-
-            noHoldsMod.ApplyToBeatmap(beatmap);
-
-            return beatmap;
-        }
-        private static IBeatmap createRawBeatmap()
-        {
-            var beatmap = new ManiaBeatmap(new StageDefinition { Columns = 1 });
-            beatmap.HitObjects.Add(new Note { StartTime = 1000 });
-            beatmap.HitObjects.Add(new HoldNote { StartTime = 1000, EndTime = 3000 });
-            return beatmap;
-        }
-    }
-}
diff --git a/osu.Game.Rulesets.Mania/ManiaRuleset.cs b/osu.Game.Rulesets.Mania/ManiaRuleset.cs
index 55ca1a465e..2098c7f5d8 100644
--- a/osu.Game.Rulesets.Mania/ManiaRuleset.cs
+++ b/osu.Game.Rulesets.Mania/ManiaRuleset.cs
@@ -244,7 +244,7 @@ namespace osu.Game.Rulesets.Mania
                         new ManiaModClassic(),
                         new ManiaModInvert(),
                         new ManiaModConstantSpeed(),
-                        new ManiaModNoHolds()
+                        new ManiaModHoldOff()
                     };
 
                 case ModType.Automation:
diff --git a/osu.Game.Rulesets.Mania/Mods/ManiaModNoHolds.cs b/osu.Game.Rulesets.Mania/Mods/ManiaModHoldOff.cs
similarity index 66%
rename from osu.Game.Rulesets.Mania/Mods/ManiaModNoHolds.cs
rename to osu.Game.Rulesets.Mania/Mods/ManiaModHoldOff.cs
index a18dbad4a1..cfdb58ee67 100644
--- a/osu.Game.Rulesets.Mania/Mods/ManiaModNoHolds.cs
+++ b/osu.Game.Rulesets.Mania/Mods/ManiaModHoldOff.cs
@@ -2,28 +2,23 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System.Linq;
-using osu.Framework.Extensions.IEnumerableExtensions;
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Mania.Objects;
 using osu.Game.Rulesets.Mods;
 using osu.Framework.Graphics.Sprites;
 using System;
 using System.Collections.Generic;
-using osu.Game.Audio;
 using osu.Game.Rulesets.Mania.Beatmaps;
-using osu.Framework.Utils;
-using osu.Game.Overlays.Settings;
 using osu.Framework.Bindables;
 using osu.Game.Configuration;
-using osu.Game.Graphics;
 
 namespace osu.Game.Rulesets.Mania.Mods
 {
-    public class ManiaModNoHolds : Mod, IApplicableAfterBeatmapConversion
+    public class ManiaModHoldOff : Mod, IApplicableAfterBeatmapConversion
     {
-        public override string Name => "No Holds";
+        public override string Name => "Hold Off";
 
-        public override string Acronym => "NH";
+        public override string Acronym => "HO";
 
         public override double ScoreMultiplier => 1;
 
@@ -40,11 +35,15 @@ namespace osu.Game.Rulesets.Mania.Mods
             Value = true
         };
 
+        [SettingSource("Minimum end note beat snap", "Don't add end notes for hold notes shorter than this beat division")]
+        public Bindable<BeatDivisors> MinBeatSnap { get; } = new Bindable<BeatDivisors>(defaultValue: BeatDivisors.Half);
+
         public void ApplyToBeatmap(IBeatmap beatmap)
         {
             var maniaBeatmap = (ManiaBeatmap)beatmap;
 
             var newObjects = new List<ManiaHitObject>();
+            var beatSnap = 1/(Math.Pow(2, (double)MinBeatSnap.Value));
             foreach (var h in beatmap.HitObjects.OfType<HoldNote>())
             {
                 // Add a note for the beginning of the hold note
@@ -56,7 +55,8 @@ namespace osu.Game.Rulesets.Mania.Mods
                 });
 
                 // Don't add an end note if the duration is shorter than some threshold, or end notes are disabled
-                if (AddEndNotes.Value && h.Duration > 200)
+                var noteValue = getNoteValue(h, maniaBeatmap); // 1/1, 1/2, 1/4, etc.
+                if (AddEndNotes.Value && noteValue >= beatSnap)
                 {
                     newObjects.Add(new Note
                     {
@@ -66,8 +66,22 @@ namespace osu.Game.Rulesets.Mania.Mods
                     });
                 }
             }
-
             maniaBeatmap.HitObjects = maniaBeatmap.HitObjects.OfType<Note>().Concat(newObjects).OrderBy(h => h.StartTime).ToList();
         }
+
+        public static double getNoteValue(HoldNote holdNote, ManiaBeatmap beatmap) {
+            var bpmAtNoteTime = beatmap.ControlPointInfo.TimingPointAt(holdNote.StartTime).BPM;
+            var noteValue = (60*holdNote.Duration)/(1000*bpmAtNoteTime);
+            return noteValue;
+        }
+
+        public enum BeatDivisors
+        {
+            Whole,
+            Half,
+            Quarter,
+            Eighth,
+            Sixteenth
+        }
     }
 }
\ No newline at end of file
diff --git a/osu.Game.Rulesets.Mania/Mods/ManiaModNoLongNotes.cs b/osu.Game.Rulesets.Mania/Mods/ManiaModNoLongNotes.cs
deleted file mode 100644
index d10003b783..0000000000
--- a/osu.Game.Rulesets.Mania/Mods/ManiaModNoLongNotes.cs
+++ /dev/null
@@ -1,86 +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.Linq;
-using osu.Framework.Extensions.IEnumerableExtensions;
-using osu.Game.Beatmaps;
-using osu.Game.Rulesets.Mania.Objects;
-using osu.Game.Rulesets.Mods;
-using osu.Framework.Graphics.Sprites;
-using System;
-using System.Collections.Generic;
-using osu.Game.Audio;
-using osu.Game.Rulesets.Mania.Beatmaps;
-using osu.Framework.Utils;
-using osu.Game.Overlays.Settings;
-using osu.Framework.Bindables;
-using osu.Game.Configuration;
-using osu.Game.Graphics;
-
-
-
-namespace osu.Game.Rulesets.Mania.Mods
-{
-    public class ManiaModNoLongNotes : Mod, IApplicableAfterBeatmapConversion
-    {
-
-        public override string Name => "No Long Notes";
-
-        public override string Acronym => "NL";
-        
-        public override double ScoreMultiplier => 1;
-        
-        public override string Description => @"Turns all held notes into tap notes. No coordination required.";
-        
-        public override IconUsage? Icon => FontAwesome.Solid.DotCircle;
-        
-        public override ModType Type => ModType.Conversion;
-
-        [SettingSource("Add end notes", "Also add a note at the end of a held note")]
-        public BindableBool AddEndNotes { get; } = new BindableBool
-        {
-            Default = true,
-            Value = true
-        };
-
-        [SettingSource("Length threshold", "Only add an end note for held notes longer than this threshold (in milliseconds)")]
-        public BindableNumber<double> Threshold { get; } = new BindableDouble
-        {
-            MinValue = 1.0,
-            MaxValue = 1990.0,
-            Default = 200.0,
-            Value = 200.0,
-            Precision = 1.0,
-        };
-
-        public void ApplyToBeatmap(IBeatmap beatmap)
-        {
-            var maniaBeatmap = (ManiaBeatmap)beatmap;
-
-            var newObjects = new List<ManiaHitObject>();
-            beatmap.HitObjects.OfType<HoldNote>().ForEach(h => 
-            {
-                // Add a note for the beginning of the hold note
-                newObjects.Add(new Note
-                {
-                    Column = h.Column,
-                    StartTime = h.StartTime,
-                    Samples = h.Samples
-                });
-
-                // Don't add an end note if the duration is below the threshold, or end notes are disabled
-                if (AddEndNotes.Value && h.Duration > Threshold.Value) 
-                {
-                    newObjects.Add(new Note
-                    {
-                        Column = h.Column,
-                        StartTime = h.EndTime,
-                        Samples = h.Samples
-                    });
-                }
-            });
-
-            maniaBeatmap.HitObjects = maniaBeatmap.HitObjects.OfType<Note>().Concat(newObjects).OrderBy(h => h.StartTime).ToList();            
-        }
-    }
-}

From b2ebcabdd5c56fa734a6eaf8eacc8b8c5c3db9a6 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 29 Jan 2022 13:27:19 +0900
Subject: [PATCH 2598/5547] Fix potential crash during stable install migration
 due to multiple configuration files

Apparently this can be a thing on windows.

Closes https://github.com/ppy/osu/discussions/16689.
---
 osu.Game/IO/StableStorage.cs | 12 +++++++++---
 1 file changed, 9 insertions(+), 3 deletions(-)

diff --git a/osu.Game/IO/StableStorage.cs b/osu.Game/IO/StableStorage.cs
index f5a8c4dc9e..84b7da91fc 100644
--- a/osu.Game/IO/StableStorage.cs
+++ b/osu.Game/IO/StableStorage.cs
@@ -34,11 +34,17 @@ namespace osu.Game.IO
 
         private string locateSongsDirectory()
         {
-            string configFile = GetFiles(".", $"osu!.{Environment.UserName}.cfg").SingleOrDefault();
+            var configurationFiles = GetFiles(".", $"osu!.{Environment.UserName}.cfg");
 
-            if (configFile != null)
+            // GetFiles returns case insensitive results, so multiple files could exist.
+            // Prefer a case-correct match, but fallback to any available.
+            string usableConfigFile =
+                configurationFiles.FirstOrDefault(f => f.Contains(Environment.UserName, StringComparison.Ordinal))
+                ?? configurationFiles.FirstOrDefault();
+
+            if (usableConfigFile != null)
             {
-                using (var stream = GetStream(configFile))
+                using (var stream = GetStream(usableConfigFile))
                 using (var textReader = new StreamReader(stream))
                 {
                     string line;

From c75ffe9b0764effd0c5270ac6b0a0bcd02c6762a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 29 Jan 2022 13:47:04 +0900
Subject: [PATCH 2599/5547] Apply code style changes

---
 osu.Game.Rulesets.Mania/Mods/ManiaModHoldOff.cs | 17 ++++++++++-------
 1 file changed, 10 insertions(+), 7 deletions(-)

diff --git a/osu.Game.Rulesets.Mania/Mods/ManiaModHoldOff.cs b/osu.Game.Rulesets.Mania/Mods/ManiaModHoldOff.cs
index cfdb58ee67..aa447356ff 100644
--- a/osu.Game.Rulesets.Mania/Mods/ManiaModHoldOff.cs
+++ b/osu.Game.Rulesets.Mania/Mods/ManiaModHoldOff.cs
@@ -43,7 +43,8 @@ namespace osu.Game.Rulesets.Mania.Mods
             var maniaBeatmap = (ManiaBeatmap)beatmap;
 
             var newObjects = new List<ManiaHitObject>();
-            var beatSnap = 1/(Math.Pow(2, (double)MinBeatSnap.Value));
+            double beatSnap = 1 / (Math.Pow(2, (double)MinBeatSnap.Value));
+
             foreach (var h in beatmap.HitObjects.OfType<HoldNote>())
             {
                 // Add a note for the beginning of the hold note
@@ -55,7 +56,8 @@ namespace osu.Game.Rulesets.Mania.Mods
                 });
 
                 // Don't add an end note if the duration is shorter than some threshold, or end notes are disabled
-                var noteValue = getNoteValue(h, maniaBeatmap); // 1/1, 1/2, 1/4, etc.
+                double noteValue = getNoteValue(h, maniaBeatmap); // 1/1, 1/2, 1/4, etc.
+
                 if (AddEndNotes.Value && noteValue >= beatSnap)
                 {
                     newObjects.Add(new Note
@@ -66,13 +68,14 @@ namespace osu.Game.Rulesets.Mania.Mods
                     });
                 }
             }
+
             maniaBeatmap.HitObjects = maniaBeatmap.HitObjects.OfType<Note>().Concat(newObjects).OrderBy(h => h.StartTime).ToList();
         }
 
-        public static double getNoteValue(HoldNote holdNote, ManiaBeatmap beatmap) {
-            var bpmAtNoteTime = beatmap.ControlPointInfo.TimingPointAt(holdNote.StartTime).BPM;
-            var noteValue = (60*holdNote.Duration)/(1000*bpmAtNoteTime);
-            return noteValue;
+        private static double getNoteValue(HoldNote holdNote, ManiaBeatmap beatmap)
+        {
+            double bpmAtNoteTime = beatmap.ControlPointInfo.TimingPointAt(holdNote.StartTime).BPM;
+            return (60 * holdNote.Duration) / (1000 * bpmAtNoteTime);
         }
 
         public enum BeatDivisors
@@ -84,4 +87,4 @@ namespace osu.Game.Rulesets.Mania.Mods
             Sixteenth
         }
     }
-}
\ No newline at end of file
+}

From 035a84e75c4b84f655ad8fadd27b24677bd66ae2 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 29 Jan 2022 14:05:23 +0900
Subject: [PATCH 2600/5547] Rename function and make `public` again for test
 usage

---
 .../Mods/TestSceneManiaModHoldOff.cs          | 54 ++++++++++++-------
 .../Mods/ManiaModHoldOff.cs                   |  4 +-
 2 files changed, 37 insertions(+), 21 deletions(-)

diff --git a/osu.Game.Rulesets.Mania.Tests/Mods/TestSceneManiaModHoldOff.cs b/osu.Game.Rulesets.Mania.Tests/Mods/TestSceneManiaModHoldOff.cs
index e157cb50b1..ddf09aab33 100644
--- a/osu.Game.Rulesets.Mania.Tests/Mods/TestSceneManiaModHoldOff.cs
+++ b/osu.Game.Rulesets.Mania.Tests/Mods/TestSceneManiaModHoldOff.cs
@@ -32,9 +32,12 @@ namespace osu.Game.Rulesets.Mania.Tests.Mods
         {
             var testBeatmap = createRawBeatmap();
             var noteValues = new List<double>(testBeatmap.HitObjects.OfType<HoldNote>().Count());
-            foreach (HoldNote h in testBeatmap.HitObjects.OfType<HoldNote>()) {
-                noteValues.Add(ManiaModHoldOff.getNoteValue(h, (ManiaBeatmap)testBeatmap));
+
+            foreach (HoldNote h in testBeatmap.HitObjects.OfType<HoldNote>())
+            {
+                noteValues.Add(ManiaModHoldOff.GetNoteDurationInBeatLength(h, (ManiaBeatmap)testBeatmap));
             }
+
             noteValues.Sort();
             Assert.AreEqual(noteValues, new List<double> { 0.125, 0.250, 0.500, 1.000, 2.000 });
         }
@@ -43,7 +46,8 @@ namespace osu.Game.Rulesets.Mania.Tests.Mods
         [TestCase(ManiaModHoldOff.BeatDivisors.Half)]
         [TestCase(ManiaModHoldOff.BeatDivisors.Quarter)]
         [TestCase(ManiaModHoldOff.BeatDivisors.Eighth)]
-        public void TestCorrectObjectCount(ManiaModHoldOff.BeatDivisors minBeatSnap) {
+        public void TestCorrectObjectCount(ManiaModHoldOff.BeatDivisors minBeatSnap)
+        {
             /*
                 This test is to ensure that, given that end notes are enabled,
                 the mod produces the expected number of objects when the mod is applied.
@@ -55,14 +59,19 @@ namespace osu.Game.Rulesets.Mania.Tests.Mods
 
             // Calculate expected number of objects
             int expectedObjectCount = 0;
-            double beatSnapValue = 1/(Math.Pow(2, (int)minBeatSnap));
+            double beatSnapValue = 1 / (Math.Pow(2, (int)minBeatSnap));
 
-            foreach (ManiaHitObject h in rawBeatmap.HitObjects) {
+            foreach (ManiaHitObject h in rawBeatmap.HitObjects)
+            {
                 // Both notes and hold notes account for at least one object
                 expectedObjectCount++;
-                if (h.GetType() == typeof(HoldNote)) {
-                    var noteValue = ManiaModHoldOff.getNoteValue((HoldNote)h, (ManiaBeatmap)rawBeatmap);
-                    if (noteValue >= beatSnapValue) {
+
+                if (h.GetType() == typeof(HoldNote))
+                {
+                    var noteValue = ManiaModHoldOff.GetNoteDurationInBeatLength((HoldNote)h, (ManiaBeatmap)rawBeatmap);
+
+                    if (noteValue >= beatSnapValue)
+                    {
                         // Should generate an end note if it's longer than the minimum note value
                         expectedObjectCount++;
                     }
@@ -73,10 +82,12 @@ namespace osu.Game.Rulesets.Mania.Tests.Mods
         }
 
         [Test]
-        public void TestDifficultyIncrease() {
+        public void TestDifficultyIncrease()
+        {
             // A lower minimum beat snap divisor should only make the map harder, never easier
             // (as more notes can be spawned)
-            var beatmaps = new ManiaBeatmap[] {
+            var beatmaps = new ManiaBeatmap[]
+            {
                 createModdedBeatmap(ManiaModHoldOff.BeatDivisors.Whole),
                 createModdedBeatmap(ManiaModHoldOff.BeatDivisors.Half),
                 createModdedBeatmap(ManiaModHoldOff.BeatDivisors.Quarter),
@@ -85,18 +96,22 @@ namespace osu.Game.Rulesets.Mania.Tests.Mods
             };
 
             var mapDifficulties = new double[beatmaps.Length];
-            for (int i = 0; i < mapDifficulties.Length; i++) {
+
+            for (int i = 0; i < mapDifficulties.Length; i++)
+            {
                 var workingBeatmap = new TestWorkingBeatmap(beatmaps[i]);
                 var difficultyCalculator = new ManiaDifficultyCalculator(new ManiaRuleset().RulesetInfo, workingBeatmap);
                 mapDifficulties[i] = difficultyCalculator.Calculate().StarRating;
-                if (i > 0) {
-                    Assert.LessOrEqual(mapDifficulties[i-1], mapDifficulties[i]);
-                    Assert.LessOrEqual(beatmaps[i-1].HitObjects.Count, beatmaps[i].HitObjects.Count);
+
+                if (i > 0)
+                {
+                    Assert.LessOrEqual(mapDifficulties[i - 1], mapDifficulties[i]);
+                    Assert.LessOrEqual(beatmaps[i - 1].HitObjects.Count, beatmaps[i].HitObjects.Count);
                 }
             }
         }
 
-        private static ManiaBeatmap createModdedBeatmap(ManiaModHoldOff.BeatDivisors minBeatSnap=ManiaModHoldOff.BeatDivisors.Whole)
+        private static ManiaBeatmap createModdedBeatmap(ManiaModHoldOff.BeatDivisors minBeatSnap = ManiaModHoldOff.BeatDivisors.Whole)
         {
             var beatmap = createRawBeatmap();
             var holdOffMod = new ManiaModHoldOff();
@@ -110,17 +125,18 @@ namespace osu.Game.Rulesets.Mania.Tests.Mods
 
             return (ManiaBeatmap)beatmap;
         }
+
         private static ManiaBeatmap createRawBeatmap()
         {
             var beatmap = new ManiaBeatmap(new StageDefinition { Columns = 1 });
-            beatmap.ControlPointInfo.Add(0.0, new TimingControlPoint { BeatLength = 1000 } ); // Set BPM to 60
+            beatmap.ControlPointInfo.Add(0.0, new TimingControlPoint { BeatLength = 1000 }); // Set BPM to 60
 
             // Add test hit objects
             beatmap.HitObjects.Add(new Note { StartTime = 4000 });
             beatmap.HitObjects.Add(new Note { StartTime = 4500 });
-            beatmap.HitObjects.Add(new HoldNote { StartTime = 0, EndTime = 125 });  // 1/8 note
-            beatmap.HitObjects.Add(new HoldNote { StartTime = 0, EndTime = 250 });  // 1/4 note
-            beatmap.HitObjects.Add(new HoldNote { StartTime = 0, EndTime = 500 });  // 1/2 note
+            beatmap.HitObjects.Add(new HoldNote { StartTime = 0, EndTime = 125 }); // 1/8 note
+            beatmap.HitObjects.Add(new HoldNote { StartTime = 0, EndTime = 250 }); // 1/4 note
+            beatmap.HitObjects.Add(new HoldNote { StartTime = 0, EndTime = 500 }); // 1/2 note
             beatmap.HitObjects.Add(new HoldNote { StartTime = 0, EndTime = 1000 }); // 1/1 note
             beatmap.HitObjects.Add(new HoldNote { StartTime = 0, EndTime = 2000 }); // 2/1 note
 
diff --git a/osu.Game.Rulesets.Mania/Mods/ManiaModHoldOff.cs b/osu.Game.Rulesets.Mania/Mods/ManiaModHoldOff.cs
index aa447356ff..637142aed6 100644
--- a/osu.Game.Rulesets.Mania/Mods/ManiaModHoldOff.cs
+++ b/osu.Game.Rulesets.Mania/Mods/ManiaModHoldOff.cs
@@ -56,7 +56,7 @@ namespace osu.Game.Rulesets.Mania.Mods
                 });
 
                 // Don't add an end note if the duration is shorter than some threshold, or end notes are disabled
-                double noteValue = getNoteValue(h, maniaBeatmap); // 1/1, 1/2, 1/4, etc.
+                double noteValue = GetNoteDurationInBeatLength(h, maniaBeatmap); // 1/1, 1/2, 1/4, etc.
 
                 if (AddEndNotes.Value && noteValue >= beatSnap)
                 {
@@ -72,7 +72,7 @@ namespace osu.Game.Rulesets.Mania.Mods
             maniaBeatmap.HitObjects = maniaBeatmap.HitObjects.OfType<Note>().Concat(newObjects).OrderBy(h => h.StartTime).ToList();
         }
 
-        private static double getNoteValue(HoldNote holdNote, ManiaBeatmap beatmap)
+        public static double GetNoteDurationInBeatLength(HoldNote holdNote, ManiaBeatmap beatmap)
         {
             double bpmAtNoteTime = beatmap.ControlPointInfo.TimingPointAt(holdNote.StartTime).BPM;
             return (60 * holdNote.Duration) / (1000 * bpmAtNoteTime);

From c7580a5177eb24aad1a667bee76e098dcb60f559 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 29 Jan 2022 14:06:43 +0900
Subject: [PATCH 2601/5547] Fix inspections in test scene

---
 .../Mods/TestSceneManiaModHoldOff.cs          | 20 ++++++++++---------
 1 file changed, 11 insertions(+), 9 deletions(-)

diff --git a/osu.Game.Rulesets.Mania.Tests/Mods/TestSceneManiaModHoldOff.cs b/osu.Game.Rulesets.Mania.Tests/Mods/TestSceneManiaModHoldOff.cs
index ddf09aab33..e74f63abb3 100644
--- a/osu.Game.Rulesets.Mania.Tests/Mods/TestSceneManiaModHoldOff.cs
+++ b/osu.Game.Rulesets.Mania.Tests/Mods/TestSceneManiaModHoldOff.cs
@@ -35,7 +35,7 @@ namespace osu.Game.Rulesets.Mania.Tests.Mods
 
             foreach (HoldNote h in testBeatmap.HitObjects.OfType<HoldNote>())
             {
-                noteValues.Add(ManiaModHoldOff.GetNoteDurationInBeatLength(h, (ManiaBeatmap)testBeatmap));
+                noteValues.Add(ManiaModHoldOff.GetNoteDurationInBeatLength(h, testBeatmap));
             }
 
             noteValues.Sort();
@@ -68,7 +68,7 @@ namespace osu.Game.Rulesets.Mania.Tests.Mods
 
                 if (h.GetType() == typeof(HoldNote))
                 {
-                    var noteValue = ManiaModHoldOff.GetNoteDurationInBeatLength((HoldNote)h, (ManiaBeatmap)rawBeatmap);
+                    double noteValue = ManiaModHoldOff.GetNoteDurationInBeatLength((HoldNote)h, rawBeatmap);
 
                     if (noteValue >= beatSnapValue)
                     {
@@ -78,7 +78,7 @@ namespace osu.Game.Rulesets.Mania.Tests.Mods
                 }
             }
 
-            Assert.That(testBeatmap.HitObjects.Count() == expectedObjectCount);
+            Assert.That(testBeatmap.HitObjects.Count == expectedObjectCount);
         }
 
         [Test]
@@ -86,16 +86,16 @@ namespace osu.Game.Rulesets.Mania.Tests.Mods
         {
             // A lower minimum beat snap divisor should only make the map harder, never easier
             // (as more notes can be spawned)
-            var beatmaps = new ManiaBeatmap[]
+            var beatmaps = new[]
             {
-                createModdedBeatmap(ManiaModHoldOff.BeatDivisors.Whole),
+                createModdedBeatmap(),
                 createModdedBeatmap(ManiaModHoldOff.BeatDivisors.Half),
                 createModdedBeatmap(ManiaModHoldOff.BeatDivisors.Quarter),
                 createModdedBeatmap(ManiaModHoldOff.BeatDivisors.Eighth),
                 createModdedBeatmap(ManiaModHoldOff.BeatDivisors.Sixteenth)
             };
 
-            var mapDifficulties = new double[beatmaps.Length];
+            double[] mapDifficulties = new double[beatmaps.Length];
 
             for (int i = 0; i < mapDifficulties.Length; i++)
             {
@@ -114,8 +114,10 @@ namespace osu.Game.Rulesets.Mania.Tests.Mods
         private static ManiaBeatmap createModdedBeatmap(ManiaModHoldOff.BeatDivisors minBeatSnap = ManiaModHoldOff.BeatDivisors.Whole)
         {
             var beatmap = createRawBeatmap();
-            var holdOffMod = new ManiaModHoldOff();
-            holdOffMod.MinBeatSnap.Value = minBeatSnap; // Set the specified beat snap setting
+            var holdOffMod = new ManiaModHoldOff
+            {
+                MinBeatSnap = { Value = minBeatSnap }
+            };
             Assert.AreEqual(holdOffMod.MinBeatSnap.Value, minBeatSnap);
 
             foreach (var hitObject in beatmap.HitObjects)
@@ -123,7 +125,7 @@ namespace osu.Game.Rulesets.Mania.Tests.Mods
 
             holdOffMod.ApplyToBeatmap(beatmap);
 
-            return (ManiaBeatmap)beatmap;
+            return beatmap;
         }
 
         private static ManiaBeatmap createRawBeatmap()

From 4c97ed676fc335a8640bcf1e39085e656b4e997f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 29 Jan 2022 14:46:24 +0900
Subject: [PATCH 2602/5547] Fix score presentation tests not correctly entering
 song select before running

---
 osu.Game.Tests/Visual/Navigation/TestScenePresentScore.cs | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/osu.Game.Tests/Visual/Navigation/TestScenePresentScore.cs b/osu.Game.Tests/Visual/Navigation/TestScenePresentScore.cs
index 7656bf79dc..6c32171b29 100644
--- a/osu.Game.Tests/Visual/Navigation/TestScenePresentScore.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestScenePresentScore.cs
@@ -16,6 +16,7 @@ using osu.Game.Screens;
 using osu.Game.Screens.Menu;
 using osu.Game.Screens.Play;
 using osu.Game.Screens.Ranking;
+using osu.Game.Screens.Select;
 
 namespace osu.Game.Tests.Visual.Navigation
 {
@@ -92,6 +93,9 @@ namespace osu.Game.Tests.Visual.Navigation
         [Test]
         public void TestFromSongSelect([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);
 
@@ -102,6 +106,9 @@ namespace osu.Game.Tests.Visual.Navigation
         [Test]
         public void TestFromSongSelectDifferentRuleset([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);
 

From e7823982d827b3371f80b4f74a5c567933c62551 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 29 Jan 2022 18:38:45 +0900
Subject: [PATCH 2603/5547] Fix ruleset value not being transferred when
 `FinaliseSelection` is not called

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

diff --git a/osu.Game/Screens/Select/SongSelect.cs b/osu.Game/Screens/Select/SongSelect.cs
index 10150fcd9f..f5b11448f8 100644
--- a/osu.Game/Screens/Select/SongSelect.cs
+++ b/osu.Game/Screens/Select/SongSelect.cs
@@ -619,6 +619,10 @@ namespace osu.Game.Screens.Select
 
         public override void OnSuspending(IScreen next)
         {
+            // Handle the case where FinaliseSelection is never called (ie. when a screen is pushed externally).
+            // Without this, it's possible for a transfer to happen while we are not the current screen.
+            transferRulesetValue();
+
             ModSelect.SelectedMods.UnbindFrom(selectedMods);
             ModSelect.Hide();
 

From aa582fb0e1a15de97b48203a7bcaed3c84a4d6c7 Mon Sep 17 00:00:00 2001
From: Nitrous <nathan.alo2000@gmail.com>
Date: Sat, 29 Jan 2022 20:38:12 +0800
Subject: [PATCH 2604/5547] add Alternate Mod

---
 osu.Game.Rulesets.Osu/Mods/OsuModAlternate.cs | 45 +++++++++++
 osu.Game.Rulesets.Osu/OsuRuleset.cs           |  1 +
 osu.Game/Rulesets/Mods/ModAlternate.cs        | 77 +++++++++++++++++++
 3 files changed, 123 insertions(+)
 create mode 100644 osu.Game.Rulesets.Osu/Mods/OsuModAlternate.cs
 create mode 100644 osu.Game/Rulesets/Mods/ModAlternate.cs

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModAlternate.cs b/osu.Game.Rulesets.Osu/Mods/OsuModAlternate.cs
new file mode 100644
index 0000000000..9a9074ee52
--- /dev/null
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModAlternate.cs
@@ -0,0 +1,45 @@
+// 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.Game.Rulesets.Mods;
+using osu.Game.Rulesets.Osu.Objects;
+using osu.Game.Rulesets.UI;
+
+namespace osu.Game.Rulesets.Osu.Mods
+{
+    public class OsuModAlternate : ModAlternate<OsuHitObject, OsuAction>
+    {
+        private const double flash_duration = 1000;
+        private OsuAction? lastActionPressed;
+        private DrawableRuleset<OsuHitObject> ruleset;
+
+        public override void ApplyToDrawableRuleset(DrawableRuleset<OsuHitObject> drawableRuleset)
+        {
+            ruleset = drawableRuleset;
+            base.ApplyToDrawableRuleset(drawableRuleset);
+        }
+
+        protected override void Reset()
+        {
+            lastActionPressed = null;
+        }
+
+        protected override bool OnPressed(OsuAction key)
+        {
+            if (lastActionPressed == key)
+            {
+                ruleset.Cursor.FlashColour(Colour4.Red, flash_duration, Easing.OutQuint);
+                return true;
+            }
+
+            lastActionPressed = key;
+
+            return false;
+        }
+
+        protected override void OnReleased(OsuAction key)
+        {
+        }
+    }
+}
diff --git a/osu.Game.Rulesets.Osu/OsuRuleset.cs b/osu.Game.Rulesets.Osu/OsuRuleset.cs
index 18e4bb259c..7e8974b5ed 100644
--- a/osu.Game.Rulesets.Osu/OsuRuleset.cs
+++ b/osu.Game.Rulesets.Osu/OsuRuleset.cs
@@ -159,6 +159,7 @@ namespace osu.Game.Rulesets.Osu
                         new MultiMod(new OsuModDoubleTime(), new OsuModNightcore()),
                         new OsuModHidden(),
                         new MultiMod(new OsuModFlashlight(), new OsuModBlinds()),
+                        new OsuModAlternate(),
                     };
 
                 case ModType.Conversion:
diff --git a/osu.Game/Rulesets/Mods/ModAlternate.cs b/osu.Game/Rulesets/Mods/ModAlternate.cs
new file mode 100644
index 0000000000..683654f605
--- /dev/null
+++ b/osu.Game/Rulesets/Mods/ModAlternate.cs
@@ -0,0 +1,77 @@
+// 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.Graphics;
+using osu.Framework.Graphics.Sprites;
+using osu.Framework.Input.Bindings;
+using osu.Framework.Input.Events;
+using osu.Game.Rulesets.Objects;
+using osu.Game.Rulesets.UI;
+using osu.Game.Screens.Play;
+
+namespace osu.Game.Rulesets.Mods
+{
+    public abstract class ModAlternate : Mod
+    {
+        public override string Name => @"Alternate";
+        public override string Acronym => @"AL";
+        public override string Description => @"Never hit the same key twice!";
+        public override double ScoreMultiplier => 1.0;
+        public override Type[] IncompatibleMods => new[] { typeof(ModAutoplay) };
+        public override ModType Type => ModType.DifficultyIncrease;
+        public override IconUsage? Icon => FontAwesome.Solid.Keyboard;
+    }
+
+    public abstract class ModAlternate<THitObject, TAction> : ModAlternate, IApplicableToDrawableRuleset<THitObject>, IApplicableToPlayer
+        where THitObject : HitObject
+        where TAction : struct
+    {
+        public bool CanIntercept => !isBreakTime.Value;
+
+        private IBindable<bool> isBreakTime;
+
+        public virtual void ApplyToDrawableRuleset(DrawableRuleset<THitObject> drawableRuleset)
+        {
+            drawableRuleset.KeyBindingInputManager.Add(new InputInterceptor(this));
+        }
+
+        public void ApplyToPlayer(Player player)
+        {
+            isBreakTime = player.IsBreakTime.GetBoundCopy();
+            isBreakTime.ValueChanged += e =>
+            {
+                if (e.NewValue)
+                    Reset();
+            };
+        }
+
+        protected abstract void Reset();
+
+        protected abstract bool OnPressed(TAction key);
+
+        protected abstract void OnReleased(TAction key);
+
+        private class InputInterceptor : Component, IKeyBindingHandler<TAction>
+        {
+            private readonly ModAlternate<THitObject, TAction> mod;
+
+            public InputInterceptor(ModAlternate<THitObject, TAction> mod)
+            {
+                this.mod = mod;
+            }
+
+            public bool OnPressed(KeyBindingPressEvent<TAction> e)
+            {
+                return mod.CanIntercept && mod.OnPressed(e.Action);
+            }
+
+            public void OnReleased(KeyBindingReleaseEvent<TAction> e)
+            {
+                if (mod.CanIntercept)
+                    mod.OnReleased(e.Action);
+            }
+        }
+    }
+}

From 2326c36836aa317635c869610d7daff18ecbbee3 Mon Sep 17 00:00:00 2001
From: Nitrous <nathan.alo2000@gmail.com>
Date: Sat, 29 Jan 2022 21:09:36 +0800
Subject: [PATCH 2605/5547] remove unused method and fix description

---
 osu.Game.Rulesets.Osu/Mods/OsuModAlternate.cs | 4 ----
 osu.Game/Rulesets/Mods/ModAlternate.cs        | 9 ++++-----
 2 files changed, 4 insertions(+), 9 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModAlternate.cs b/osu.Game.Rulesets.Osu/Mods/OsuModAlternate.cs
index 9a9074ee52..34802bab43 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModAlternate.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModAlternate.cs
@@ -37,9 +37,5 @@ namespace osu.Game.Rulesets.Osu.Mods
 
             return false;
         }
-
-        protected override void OnReleased(OsuAction key)
-        {
-        }
     }
 }
diff --git a/osu.Game/Rulesets/Mods/ModAlternate.cs b/osu.Game/Rulesets/Mods/ModAlternate.cs
index 683654f605..17d8b92469 100644
--- a/osu.Game/Rulesets/Mods/ModAlternate.cs
+++ b/osu.Game/Rulesets/Mods/ModAlternate.cs
@@ -17,7 +17,7 @@ namespace osu.Game.Rulesets.Mods
     {
         public override string Name => @"Alternate";
         public override string Acronym => @"AL";
-        public override string Description => @"Never hit the same key twice!";
+        public override string Description => @"Don't use the same key twice in a row!";
         public override double ScoreMultiplier => 1.0;
         public override Type[] IncompatibleMods => new[] { typeof(ModAutoplay) };
         public override ModType Type => ModType.DifficultyIncrease;
@@ -28,6 +28,9 @@ namespace osu.Game.Rulesets.Mods
         where THitObject : HitObject
         where TAction : struct
     {
+        /// <summary>
+        /// Whether incoming input must be checked by <see cref="InputInterceptor"/>.
+        /// </summary>
         public bool CanIntercept => !isBreakTime.Value;
 
         private IBindable<bool> isBreakTime;
@@ -51,8 +54,6 @@ namespace osu.Game.Rulesets.Mods
 
         protected abstract bool OnPressed(TAction key);
 
-        protected abstract void OnReleased(TAction key);
-
         private class InputInterceptor : Component, IKeyBindingHandler<TAction>
         {
             private readonly ModAlternate<THitObject, TAction> mod;
@@ -69,8 +70,6 @@ namespace osu.Game.Rulesets.Mods
 
             public void OnReleased(KeyBindingReleaseEvent<TAction> e)
             {
-                if (mod.CanIntercept)
-                    mod.OnReleased(e.Action);
             }
         }
     }

From 98d8b26a9c24dee403ba9d7199d0652910c72c0b Mon Sep 17 00:00:00 2001
From: Nitrous <nathan.alo2000@gmail.com>
Date: Sat, 29 Jan 2022 21:49:40 +0800
Subject: [PATCH 2606/5547] move `ModAlternate` to `OsuModAlternate` and check
 if intro has ended

---
 osu.Game.Rulesets.Osu/Mods/OsuModAlternate.cs | 67 ++++++++++++++--
 osu.Game/Rulesets/Mods/ModAlternate.cs        | 76 -------------------
 2 files changed, 61 insertions(+), 82 deletions(-)
 delete mode 100644 osu.Game/Rulesets/Mods/ModAlternate.cs

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModAlternate.cs b/osu.Game.Rulesets.Osu/Mods/OsuModAlternate.cs
index 34802bab43..f366481c7d 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModAlternate.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModAlternate.cs
@@ -1,31 +1,63 @@
 // 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.Bindables;
 using osu.Framework.Graphics;
+using osu.Framework.Graphics.Sprites;
+using osu.Framework.Input.Bindings;
+using osu.Framework.Input.Events;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Osu.Objects;
+using osu.Game.Rulesets.Scoring;
 using osu.Game.Rulesets.UI;
+using osu.Game.Screens.Play;
 
 namespace osu.Game.Rulesets.Osu.Mods
 {
-    public class OsuModAlternate : ModAlternate<OsuHitObject, OsuAction>
+    public class OsuModAlternate : Mod, IApplicableToDrawableRuleset<OsuHitObject>, IApplicableToPlayer, IUpdatableByPlayfield
     {
+        public override string Name => @"Alternate";
+        public override string Acronym => @"AL";
+        public override string Description => @"Don't use the same key twice in a row!";
+        public override double ScoreMultiplier => 1.0;
+        public override Type[] IncompatibleMods => new[] { typeof(ModAutoplay) };
+        public override ModType Type => ModType.DifficultyIncrease;
+        public override IconUsage? Icon => FontAwesome.Solid.Keyboard;
+
+        /// <summary>
+        /// Whether incoming input must be checked by <see cref="InputInterceptor"/>.
+        /// </summary>
+        public bool CanIntercept => !isBreakTime.Value && introEnded;
+
+        private bool introEnded;
+        private double earliestStartTime;
+        private IBindable<bool> isBreakTime;
         private const double flash_duration = 1000;
         private OsuAction? lastActionPressed;
         private DrawableRuleset<OsuHitObject> ruleset;
 
-        public override void ApplyToDrawableRuleset(DrawableRuleset<OsuHitObject> drawableRuleset)
+        public void ApplyToDrawableRuleset(DrawableRuleset<OsuHitObject> drawableRuleset)
         {
             ruleset = drawableRuleset;
-            base.ApplyToDrawableRuleset(drawableRuleset);
+            drawableRuleset.KeyBindingInputManager.Add(new InputInterceptor(this));
+
+            var firstHitObject = ruleset.Objects.FirstOrDefault();
+            earliestStartTime = (firstHitObject?.StartTime ?? 0) - (firstHitObject?.HitWindows.WindowFor(HitResult.Meh) ?? 0);
         }
 
-        protected override void Reset()
+        public void ApplyToPlayer(Player player)
         {
-            lastActionPressed = null;
+            isBreakTime = player.IsBreakTime.GetBoundCopy();
+            isBreakTime.ValueChanged += e =>
+            {
+                if (e.NewValue)
+                    lastActionPressed = null;
+            };
         }
 
-        protected override bool OnPressed(OsuAction key)
+        private bool onPressed(OsuAction key)
         {
             if (lastActionPressed == key)
             {
@@ -37,5 +69,28 @@ namespace osu.Game.Rulesets.Osu.Mods
 
             return false;
         }
+
+        public void Update(Playfield playfield)
+        {
+            if (!introEnded)
+                introEnded = playfield.Clock.CurrentTime > earliestStartTime;
+        }
+
+        private class InputInterceptor : Component, IKeyBindingHandler<OsuAction>
+        {
+            private readonly OsuModAlternate mod;
+
+            public InputInterceptor(OsuModAlternate mod)
+            {
+                this.mod = mod;
+            }
+
+            public bool OnPressed(KeyBindingPressEvent<OsuAction> e)
+                => mod.CanIntercept && mod.onPressed(e.Action);
+
+            public void OnReleased(KeyBindingReleaseEvent<OsuAction> e)
+            {
+            }
+        }
     }
 }
diff --git a/osu.Game/Rulesets/Mods/ModAlternate.cs b/osu.Game/Rulesets/Mods/ModAlternate.cs
deleted file mode 100644
index 17d8b92469..0000000000
--- a/osu.Game/Rulesets/Mods/ModAlternate.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 System;
-using osu.Framework.Bindables;
-using osu.Framework.Graphics;
-using osu.Framework.Graphics.Sprites;
-using osu.Framework.Input.Bindings;
-using osu.Framework.Input.Events;
-using osu.Game.Rulesets.Objects;
-using osu.Game.Rulesets.UI;
-using osu.Game.Screens.Play;
-
-namespace osu.Game.Rulesets.Mods
-{
-    public abstract class ModAlternate : Mod
-    {
-        public override string Name => @"Alternate";
-        public override string Acronym => @"AL";
-        public override string Description => @"Don't use the same key twice in a row!";
-        public override double ScoreMultiplier => 1.0;
-        public override Type[] IncompatibleMods => new[] { typeof(ModAutoplay) };
-        public override ModType Type => ModType.DifficultyIncrease;
-        public override IconUsage? Icon => FontAwesome.Solid.Keyboard;
-    }
-
-    public abstract class ModAlternate<THitObject, TAction> : ModAlternate, IApplicableToDrawableRuleset<THitObject>, IApplicableToPlayer
-        where THitObject : HitObject
-        where TAction : struct
-    {
-        /// <summary>
-        /// Whether incoming input must be checked by <see cref="InputInterceptor"/>.
-        /// </summary>
-        public bool CanIntercept => !isBreakTime.Value;
-
-        private IBindable<bool> isBreakTime;
-
-        public virtual void ApplyToDrawableRuleset(DrawableRuleset<THitObject> drawableRuleset)
-        {
-            drawableRuleset.KeyBindingInputManager.Add(new InputInterceptor(this));
-        }
-
-        public void ApplyToPlayer(Player player)
-        {
-            isBreakTime = player.IsBreakTime.GetBoundCopy();
-            isBreakTime.ValueChanged += e =>
-            {
-                if (e.NewValue)
-                    Reset();
-            };
-        }
-
-        protected abstract void Reset();
-
-        protected abstract bool OnPressed(TAction key);
-
-        private class InputInterceptor : Component, IKeyBindingHandler<TAction>
-        {
-            private readonly ModAlternate<THitObject, TAction> mod;
-
-            public InputInterceptor(ModAlternate<THitObject, TAction> mod)
-            {
-                this.mod = mod;
-            }
-
-            public bool OnPressed(KeyBindingPressEvent<TAction> e)
-            {
-                return mod.CanIntercept && mod.OnPressed(e.Action);
-            }
-
-            public void OnReleased(KeyBindingReleaseEvent<TAction> e)
-            {
-            }
-        }
-    }
-}

From d48fae11004b7142a58b8d701c0cbfd073e43992 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 29 Jan 2022 23:13:19 +0900
Subject: [PATCH 2607/5547] Revert "Remove all EF migrations"

This reverts commit bb5b9458e8130a2a5f213e968f5590d00ede3d87.
---
 .../20171019041408_InitialCreate.Designer.cs  | 293 ++++++++++
 .../20171019041408_InitialCreate.cs           | 311 +++++++++++
 ...025071459_AddMissingIndexRules.Designer.cs | 299 ++++++++++
 .../20171025071459_AddMissingIndexRules.cs    |  80 +++
 ...eatmapOnlineIDUniqueConstraint.Designer.cs | 302 ++++++++++
 ...5731_AddBeatmapOnlineIDUniqueConstraint.cs |  23 +
 ...034410_AddRulesetInfoShortName.Designer.cs | 307 +++++++++++
 .../20171209034410_AddRulesetInfoShortName.cs |  33 ++
 .../20180125143340_Settings.Designer.cs       | 329 +++++++++++
 .../Migrations/20180125143340_Settings.cs     |  55 ++
 .../20180131154205_AddMuteBinding.cs          |  23 +
 .../20180219060912_AddSkins.Designer.cs       | 379 +++++++++++++
 .../Migrations/20180219060912_AddSkins.cs     |  71 +++
 ...54_RemoveUniqueHashConstraints.Designer.cs | 377 +++++++++++++
 ...80529055154_RemoveUniqueHashConstraints.cs |  51 ++
 ...111_UpdateTaikoDefaultBindings.Designer.cs | 376 +++++++++++++
 ...180621044111_UpdateTaikoDefaultBindings.cs |  17 +
 ...628011956_RemoveNegativeSetIDs.Designer.cs | 376 +++++++++++++
 .../20180628011956_RemoveNegativeSetIDs.cs    |  18 +
 .../20180913080842_AddRankStatus.Designer.cs  | 380 +++++++++++++
 .../20180913080842_AddRankStatus.cs           |  33 ++
 ...0181007180454_StandardizePaths.Designer.cs | 380 +++++++++++++
 .../20181007180454_StandardizePaths.cs        |  26 +
 ...20181128100659_AddSkinInfoHash.Designer.cs | 387 +++++++++++++
 .../20181128100659_AddSkinInfoHash.cs         |  41 ++
 ...81130113755_AddScoreInfoTables.Designer.cs | 484 ++++++++++++++++
 .../20181130113755_AddScoreInfoTables.cs      | 112 ++++
 ...20190225062029_AddUserIDColumn.Designer.cs | 487 +++++++++++++++++
 .../20190225062029_AddUserIDColumn.cs         |  22 +
 .../20190525060824_SkinSettings.Designer.cs   | 498 +++++++++++++++++
 .../Migrations/20190525060824_SkinSettings.cs |  54 ++
 ...AddDateAddedColumnToBeatmapSet.Designer.cs | 489 +++++++++++++++++
 ...05091246_AddDateAddedColumnToBeatmapSet.cs |  24 +
 ...8070844_AddBPMAndLengthColumns.Designer.cs | 504 +++++++++++++++++
 .../20190708070844_AddBPMAndLengthColumns.cs  |  33 ++
 ...20190913104727_AddBeatmapVideo.Designer.cs | 506 +++++++++++++++++
 .../20190913104727_AddBeatmapVideo.cs         |  22 +
 ...02094919_RefreshVolumeBindings.Designer.cs | 506 +++++++++++++++++
 .../20200302094919_RefreshVolumeBindings.cs   |  16 +
 ...01019224408_AddEpilepsyWarning.Designer.cs | 508 +++++++++++++++++
 .../20201019224408_AddEpilepsyWarning.cs      |  23 +
 ...700_RefreshVolumeBindingsAgain.Designer.cs | 506 +++++++++++++++++
 ...210412045700_RefreshVolumeBindingsAgain.cs |  16 +
 ...60743_AddSkinInstantiationInfo.Designer.cs | 508 +++++++++++++++++
 ...20210511060743_AddSkinInstantiationInfo.cs |  22 +
 ...9_AddAuthorIdToBeatmapMetadata.Designer.cs | 511 +++++++++++++++++
 ...0514062639_AddAuthorIdToBeatmapMetadata.cs |  23 +
 ...824185035_AddCountdownSettings.Designer.cs | 513 +++++++++++++++++
 .../20210824185035_AddCountdownSettings.cs    |  23 +
 ...11_AddSamplesMatchPlaybackRate.Designer.cs | 515 ++++++++++++++++++
 ...10912144011_AddSamplesMatchPlaybackRate.cs |  23 +
 .../20211020081609_ResetSkinHashes.cs         |  23 +
 .../Migrations/OsuDbContextModelSnapshot.cs   | 513 +++++++++++++++++
 53 files changed, 12451 insertions(+)
 create mode 100644 osu.Game/Migrations/20171019041408_InitialCreate.Designer.cs
 create mode 100644 osu.Game/Migrations/20171019041408_InitialCreate.cs
 create mode 100644 osu.Game/Migrations/20171025071459_AddMissingIndexRules.Designer.cs
 create mode 100644 osu.Game/Migrations/20171025071459_AddMissingIndexRules.cs
 create mode 100644 osu.Game/Migrations/20171119065731_AddBeatmapOnlineIDUniqueConstraint.Designer.cs
 create mode 100644 osu.Game/Migrations/20171119065731_AddBeatmapOnlineIDUniqueConstraint.cs
 create mode 100644 osu.Game/Migrations/20171209034410_AddRulesetInfoShortName.Designer.cs
 create mode 100644 osu.Game/Migrations/20171209034410_AddRulesetInfoShortName.cs
 create mode 100644 osu.Game/Migrations/20180125143340_Settings.Designer.cs
 create mode 100644 osu.Game/Migrations/20180125143340_Settings.cs
 create mode 100644 osu.Game/Migrations/20180131154205_AddMuteBinding.cs
 create mode 100644 osu.Game/Migrations/20180219060912_AddSkins.Designer.cs
 create mode 100644 osu.Game/Migrations/20180219060912_AddSkins.cs
 create mode 100644 osu.Game/Migrations/20180529055154_RemoveUniqueHashConstraints.Designer.cs
 create mode 100644 osu.Game/Migrations/20180529055154_RemoveUniqueHashConstraints.cs
 create mode 100644 osu.Game/Migrations/20180621044111_UpdateTaikoDefaultBindings.Designer.cs
 create mode 100644 osu.Game/Migrations/20180621044111_UpdateTaikoDefaultBindings.cs
 create mode 100644 osu.Game/Migrations/20180628011956_RemoveNegativeSetIDs.Designer.cs
 create mode 100644 osu.Game/Migrations/20180628011956_RemoveNegativeSetIDs.cs
 create mode 100644 osu.Game/Migrations/20180913080842_AddRankStatus.Designer.cs
 create mode 100644 osu.Game/Migrations/20180913080842_AddRankStatus.cs
 create mode 100644 osu.Game/Migrations/20181007180454_StandardizePaths.Designer.cs
 create mode 100644 osu.Game/Migrations/20181007180454_StandardizePaths.cs
 create mode 100644 osu.Game/Migrations/20181128100659_AddSkinInfoHash.Designer.cs
 create mode 100644 osu.Game/Migrations/20181128100659_AddSkinInfoHash.cs
 create mode 100644 osu.Game/Migrations/20181130113755_AddScoreInfoTables.Designer.cs
 create mode 100644 osu.Game/Migrations/20181130113755_AddScoreInfoTables.cs
 create mode 100644 osu.Game/Migrations/20190225062029_AddUserIDColumn.Designer.cs
 create mode 100644 osu.Game/Migrations/20190225062029_AddUserIDColumn.cs
 create mode 100644 osu.Game/Migrations/20190525060824_SkinSettings.Designer.cs
 create mode 100644 osu.Game/Migrations/20190525060824_SkinSettings.cs
 create mode 100644 osu.Game/Migrations/20190605091246_AddDateAddedColumnToBeatmapSet.Designer.cs
 create mode 100644 osu.Game/Migrations/20190605091246_AddDateAddedColumnToBeatmapSet.cs
 create mode 100644 osu.Game/Migrations/20190708070844_AddBPMAndLengthColumns.Designer.cs
 create mode 100644 osu.Game/Migrations/20190708070844_AddBPMAndLengthColumns.cs
 create mode 100644 osu.Game/Migrations/20190913104727_AddBeatmapVideo.Designer.cs
 create mode 100644 osu.Game/Migrations/20190913104727_AddBeatmapVideo.cs
 create mode 100644 osu.Game/Migrations/20200302094919_RefreshVolumeBindings.Designer.cs
 create mode 100644 osu.Game/Migrations/20200302094919_RefreshVolumeBindings.cs
 create mode 100644 osu.Game/Migrations/20201019224408_AddEpilepsyWarning.Designer.cs
 create mode 100644 osu.Game/Migrations/20201019224408_AddEpilepsyWarning.cs
 create mode 100644 osu.Game/Migrations/20210412045700_RefreshVolumeBindingsAgain.Designer.cs
 create mode 100644 osu.Game/Migrations/20210412045700_RefreshVolumeBindingsAgain.cs
 create mode 100644 osu.Game/Migrations/20210511060743_AddSkinInstantiationInfo.Designer.cs
 create mode 100644 osu.Game/Migrations/20210511060743_AddSkinInstantiationInfo.cs
 create mode 100644 osu.Game/Migrations/20210514062639_AddAuthorIdToBeatmapMetadata.Designer.cs
 create mode 100644 osu.Game/Migrations/20210514062639_AddAuthorIdToBeatmapMetadata.cs
 create mode 100644 osu.Game/Migrations/20210824185035_AddCountdownSettings.Designer.cs
 create mode 100644 osu.Game/Migrations/20210824185035_AddCountdownSettings.cs
 create mode 100644 osu.Game/Migrations/20210912144011_AddSamplesMatchPlaybackRate.Designer.cs
 create mode 100644 osu.Game/Migrations/20210912144011_AddSamplesMatchPlaybackRate.cs
 create mode 100644 osu.Game/Migrations/20211020081609_ResetSkinHashes.cs
 create mode 100644 osu.Game/Migrations/OsuDbContextModelSnapshot.cs

diff --git a/osu.Game/Migrations/20171019041408_InitialCreate.Designer.cs b/osu.Game/Migrations/20171019041408_InitialCreate.Designer.cs
new file mode 100644
index 0000000000..c751530bf4
--- /dev/null
+++ b/osu.Game/Migrations/20171019041408_InitialCreate.Designer.cs
@@ -0,0 +1,293 @@
+// <auto-generated />
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Infrastructure;
+using Microsoft.EntityFrameworkCore.Metadata;
+using Microsoft.EntityFrameworkCore.Migrations;
+using Microsoft.EntityFrameworkCore.Storage;
+using osu.Game.Database;
+using System;
+
+namespace osu.Game.Migrations
+{
+    [DbContext(typeof(OsuDbContext))]
+    [Migration("20171019041408_InitialCreate")]
+    partial class InitialCreate
+    {
+        protected override void BuildTargetModel(ModelBuilder modelBuilder)
+        {
+#pragma warning disable 612, 618
+            modelBuilder
+                .HasAnnotation("ProductVersion", "2.0.0-rtm-26452");
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapDifficulty", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<float>("ApproachRate");
+
+                    b.Property<float>("CircleSize");
+
+                    b.Property<float>("DrainRate");
+
+                    b.Property<float>("OverallDifficulty");
+
+                    b.Property<float>("SliderMultiplier");
+
+                    b.Property<float>("SliderTickRate");
+
+                    b.HasKey("ID");
+
+                    b.ToTable("BeatmapDifficulty");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("AudioLeadIn");
+
+                    b.Property<int>("BaseDifficultyID");
+
+                    b.Property<int>("BeatDivisor");
+
+                    b.Property<int>("BeatmapSetInfoID");
+
+                    b.Property<bool>("Countdown");
+
+                    b.Property<double>("DistanceSpacing");
+
+                    b.Property<int>("GridSize");
+
+                    b.Property<string>("Hash");
+
+                    b.Property<bool>("Hidden");
+
+                    b.Property<bool>("LetterboxInBreaks");
+
+                    b.Property<string>("MD5Hash");
+
+                    b.Property<int?>("MetadataID");
+
+                    b.Property<int?>("OnlineBeatmapID");
+
+                    b.Property<string>("Path");
+
+                    b.Property<int>("RulesetID");
+
+                    b.Property<bool>("SpecialStyle");
+
+                    b.Property<float>("StackLeniency");
+
+                    b.Property<double>("StarDifficulty");
+
+                    b.Property<string>("StoredBookmarks");
+
+                    b.Property<double>("TimelineZoom");
+
+                    b.Property<string>("Version");
+
+                    b.Property<bool>("WidescreenStoryboard");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("BaseDifficultyID");
+
+                    b.HasIndex("BeatmapSetInfoID");
+
+                    b.HasIndex("Hash");
+
+                    b.HasIndex("MD5Hash");
+
+                    b.HasIndex("MetadataID");
+
+                    b.HasIndex("RulesetID");
+
+                    b.ToTable("BeatmapInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapMetadata", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<string>("Artist");
+
+                    b.Property<string>("ArtistUnicode");
+
+                    b.Property<string>("AudioFile");
+
+                    b.Property<string>("AuthorString")
+                        .HasColumnName("Author");
+
+                    b.Property<string>("BackgroundFile");
+
+                    b.Property<int>("PreviewTime");
+
+                    b.Property<string>("Source");
+
+                    b.Property<string>("Tags");
+
+                    b.Property<string>("Title");
+
+                    b.Property<string>("TitleUnicode");
+
+                    b.HasKey("ID");
+
+                    b.ToTable("BeatmapMetadata");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("BeatmapSetInfoID");
+
+                    b.Property<int>("FileInfoID");
+
+                    b.Property<string>("Filename")
+                        .IsRequired();
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("BeatmapSetInfoID");
+
+                    b.HasIndex("FileInfoID");
+
+                    b.ToTable("BeatmapSetFileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<bool>("DeletePending");
+
+                    b.Property<string>("Hash");
+
+                    b.Property<int?>("MetadataID");
+
+                    b.Property<int?>("OnlineBeatmapSetID");
+
+                    b.Property<bool>("Protected");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("DeletePending");
+
+                    b.HasIndex("Hash");
+
+                    b.HasIndex("MetadataID");
+
+                    b.ToTable("BeatmapSetInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Input.Bindings.DatabasedKeyBinding", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("IntAction")
+                        .HasColumnName("Action");
+
+                    b.Property<string>("KeysString")
+                        .HasColumnName("Keys");
+
+                    b.Property<int?>("RulesetID");
+
+                    b.Property<int?>("Variant");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("IntAction");
+
+                    b.HasIndex("Variant");
+
+                    b.ToTable("KeyBinding");
+                });
+
+            modelBuilder.Entity("osu.Game.IO.FileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<string>("Hash");
+
+                    b.Property<int>("ReferenceCount");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("Hash")
+                        .IsUnique();
+
+                    b.HasIndex("ReferenceCount");
+
+                    b.ToTable("FileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Rulesets.RulesetInfo", b =>
+                {
+                    b.Property<int?>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<bool>("Available");
+
+                    b.Property<string>("InstantiationInfo");
+
+                    b.Property<string>("Name");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("Available");
+
+                    b.ToTable("RulesetInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapDifficulty", "BaseDifficulty")
+                        .WithMany()
+                        .HasForeignKey("BaseDifficultyID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo", "BeatmapSet")
+                        .WithMany("Beatmaps")
+                        .HasForeignKey("BeatmapSetInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
+                        .WithMany("Beatmaps")
+                        .HasForeignKey("MetadataID");
+
+                    b.HasOne("osu.Game.Rulesets.RulesetInfo", "Ruleset")
+                        .WithMany()
+                        .HasForeignKey("RulesetID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo")
+                        .WithMany("Files")
+                        .HasForeignKey("BeatmapSetInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
+                        .WithMany()
+                        .HasForeignKey("FileInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
+                        .WithMany("BeatmapSets")
+                        .HasForeignKey("MetadataID");
+                });
+#pragma warning restore 612, 618
+        }
+    }
+}
diff --git a/osu.Game/Migrations/20171019041408_InitialCreate.cs b/osu.Game/Migrations/20171019041408_InitialCreate.cs
new file mode 100644
index 0000000000..9b6881f98c
--- /dev/null
+++ b/osu.Game/Migrations/20171019041408_InitialCreate.cs
@@ -0,0 +1,311 @@
+using Microsoft.EntityFrameworkCore.Migrations;
+
+namespace osu.Game.Migrations
+{
+    public partial class InitialCreate : Migration
+    {
+        protected override void Up(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.CreateTable(
+                name: "BeatmapDifficulty",
+                columns: table => new
+                {
+                    ID = table.Column<int>(type: "INTEGER", nullable: false)
+                        .Annotation("Sqlite:Autoincrement", true),
+                    ApproachRate = table.Column<float>(type: "REAL", nullable: false),
+                    CircleSize = table.Column<float>(type: "REAL", nullable: false),
+                    DrainRate = table.Column<float>(type: "REAL", nullable: false),
+                    OverallDifficulty = table.Column<float>(type: "REAL", nullable: false),
+                    SliderMultiplier = table.Column<float>(type: "REAL", nullable: false),
+                    SliderTickRate = table.Column<float>(type: "REAL", nullable: false)
+                },
+                constraints: table =>
+                {
+                    table.PrimaryKey("PK_BeatmapDifficulty", x => x.ID);
+                });
+
+            migrationBuilder.CreateTable(
+                name: "BeatmapMetadata",
+                columns: table => new
+                {
+                    ID = table.Column<int>(type: "INTEGER", nullable: false)
+                        .Annotation("Sqlite:Autoincrement", true),
+                    Artist = table.Column<string>(type: "TEXT", nullable: true),
+                    ArtistUnicode = table.Column<string>(type: "TEXT", nullable: true),
+                    AudioFile = table.Column<string>(type: "TEXT", nullable: true),
+                    Author = table.Column<string>(type: "TEXT", nullable: true),
+                    BackgroundFile = table.Column<string>(type: "TEXT", nullable: true),
+                    PreviewTime = table.Column<int>(type: "INTEGER", nullable: false),
+                    Source = table.Column<string>(type: "TEXT", nullable: true),
+                    Tags = table.Column<string>(type: "TEXT", nullable: true),
+                    Title = table.Column<string>(type: "TEXT", nullable: true),
+                    TitleUnicode = table.Column<string>(type: "TEXT", nullable: true)
+                },
+                constraints: table =>
+                {
+                    table.PrimaryKey("PK_BeatmapMetadata", x => x.ID);
+                });
+
+            migrationBuilder.CreateTable(
+                name: "FileInfo",
+                columns: table => new
+                {
+                    ID = table.Column<int>(type: "INTEGER", nullable: false)
+                        .Annotation("Sqlite:Autoincrement", true),
+                    Hash = table.Column<string>(type: "TEXT", nullable: true),
+                    ReferenceCount = table.Column<int>(type: "INTEGER", nullable: false)
+                },
+                constraints: table =>
+                {
+                    table.PrimaryKey("PK_FileInfo", x => x.ID);
+                });
+
+            migrationBuilder.CreateTable(
+                name: "KeyBinding",
+                columns: table => new
+                {
+                    ID = table.Column<int>(type: "INTEGER", nullable: false)
+                        .Annotation("Sqlite:Autoincrement", true),
+                    Action = table.Column<int>(type: "INTEGER", nullable: false),
+                    Keys = table.Column<string>(type: "TEXT", nullable: true),
+                    RulesetID = table.Column<int>(type: "INTEGER", nullable: true),
+                    Variant = table.Column<int>(type: "INTEGER", nullable: true)
+                },
+                constraints: table =>
+                {
+                    table.PrimaryKey("PK_KeyBinding", x => x.ID);
+                });
+
+            migrationBuilder.CreateTable(
+                name: "RulesetInfo",
+                columns: table => new
+                {
+                    ID = table.Column<int>(type: "INTEGER", nullable: false)
+                        .Annotation("Sqlite:Autoincrement", true),
+                    Available = table.Column<bool>(type: "INTEGER", nullable: false),
+                    InstantiationInfo = table.Column<string>(type: "TEXT", nullable: true),
+                    Name = table.Column<string>(type: "TEXT", nullable: true)
+                },
+                constraints: table =>
+                {
+                    table.PrimaryKey("PK_RulesetInfo", x => x.ID);
+                });
+
+            migrationBuilder.CreateTable(
+                name: "BeatmapSetInfo",
+                columns: table => new
+                {
+                    ID = table.Column<int>(type: "INTEGER", nullable: false)
+                        .Annotation("Sqlite:Autoincrement", true),
+                    DeletePending = table.Column<bool>(type: "INTEGER", nullable: false),
+                    Hash = table.Column<string>(type: "TEXT", nullable: true),
+                    MetadataID = table.Column<int>(type: "INTEGER", nullable: true),
+                    OnlineBeatmapSetID = table.Column<int>(type: "INTEGER", nullable: true),
+                    Protected = table.Column<bool>(type: "INTEGER", nullable: false)
+                },
+                constraints: table =>
+                {
+                    table.PrimaryKey("PK_BeatmapSetInfo", x => x.ID);
+                    table.ForeignKey(
+                        name: "FK_BeatmapSetInfo_BeatmapMetadata_MetadataID",
+                        column: x => x.MetadataID,
+                        principalTable: "BeatmapMetadata",
+                        principalColumn: "ID",
+                        onDelete: ReferentialAction.Restrict);
+                });
+
+            migrationBuilder.CreateTable(
+                name: "BeatmapInfo",
+                columns: table => new
+                {
+                    ID = table.Column<int>(type: "INTEGER", nullable: false)
+                        .Annotation("Sqlite:Autoincrement", true),
+                    AudioLeadIn = table.Column<int>(type: "INTEGER", nullable: false),
+                    BaseDifficultyID = table.Column<int>(type: "INTEGER", nullable: false),
+                    BeatDivisor = table.Column<int>(type: "INTEGER", nullable: false),
+                    BeatmapSetInfoID = table.Column<int>(type: "INTEGER", nullable: false),
+                    Countdown = table.Column<bool>(type: "INTEGER", nullable: false),
+                    DistanceSpacing = table.Column<double>(type: "REAL", nullable: false),
+                    GridSize = table.Column<int>(type: "INTEGER", nullable: false),
+                    Hash = table.Column<string>(type: "TEXT", nullable: true),
+                    Hidden = table.Column<bool>(type: "INTEGER", nullable: false),
+                    LetterboxInBreaks = table.Column<bool>(type: "INTEGER", nullable: false),
+                    MD5Hash = table.Column<string>(type: "TEXT", nullable: true),
+                    MetadataID = table.Column<int>(type: "INTEGER", nullable: true),
+                    OnlineBeatmapID = table.Column<int>(type: "INTEGER", nullable: true),
+                    Path = table.Column<string>(type: "TEXT", nullable: true),
+                    RulesetID = table.Column<int>(type: "INTEGER", nullable: false),
+                    SpecialStyle = table.Column<bool>(type: "INTEGER", nullable: false),
+                    StackLeniency = table.Column<float>(type: "REAL", nullable: false),
+                    StarDifficulty = table.Column<double>(type: "REAL", nullable: false),
+                    StoredBookmarks = table.Column<string>(type: "TEXT", nullable: true),
+                    TimelineZoom = table.Column<double>(type: "REAL", nullable: false),
+                    Version = table.Column<string>(type: "TEXT", nullable: true),
+                    WidescreenStoryboard = table.Column<bool>(type: "INTEGER", nullable: false)
+                },
+                constraints: table =>
+                {
+                    table.PrimaryKey("PK_BeatmapInfo", x => x.ID);
+                    table.ForeignKey(
+                        name: "FK_BeatmapInfo_BeatmapDifficulty_BaseDifficultyID",
+                        column: x => x.BaseDifficultyID,
+                        principalTable: "BeatmapDifficulty",
+                        principalColumn: "ID",
+                        onDelete: ReferentialAction.Cascade);
+                    table.ForeignKey(
+                        name: "FK_BeatmapInfo_BeatmapSetInfo_BeatmapSetInfoID",
+                        column: x => x.BeatmapSetInfoID,
+                        principalTable: "BeatmapSetInfo",
+                        principalColumn: "ID",
+                        onDelete: ReferentialAction.Cascade);
+                    table.ForeignKey(
+                        name: "FK_BeatmapInfo_BeatmapMetadata_MetadataID",
+                        column: x => x.MetadataID,
+                        principalTable: "BeatmapMetadata",
+                        principalColumn: "ID",
+                        onDelete: ReferentialAction.Restrict);
+                    table.ForeignKey(
+                        name: "FK_BeatmapInfo_RulesetInfo_RulesetID",
+                        column: x => x.RulesetID,
+                        principalTable: "RulesetInfo",
+                        principalColumn: "ID",
+                        onDelete: ReferentialAction.Cascade);
+                });
+
+            migrationBuilder.CreateTable(
+                name: "BeatmapSetFileInfo",
+                columns: table => new
+                {
+                    ID = table.Column<int>(type: "INTEGER", nullable: false)
+                        .Annotation("Sqlite:Autoincrement", true),
+                    BeatmapSetInfoID = table.Column<int>(type: "INTEGER", nullable: false),
+                    FileInfoID = table.Column<int>(type: "INTEGER", nullable: false),
+                    Filename = table.Column<string>(type: "TEXT", nullable: false)
+                },
+                constraints: table =>
+                {
+                    table.PrimaryKey("PK_BeatmapSetFileInfo", x => x.ID);
+                    table.ForeignKey(
+                        name: "FK_BeatmapSetFileInfo_BeatmapSetInfo_BeatmapSetInfoID",
+                        column: x => x.BeatmapSetInfoID,
+                        principalTable: "BeatmapSetInfo",
+                        principalColumn: "ID",
+                        onDelete: ReferentialAction.Cascade);
+                    table.ForeignKey(
+                        name: "FK_BeatmapSetFileInfo_FileInfo_FileInfoID",
+                        column: x => x.FileInfoID,
+                        principalTable: "FileInfo",
+                        principalColumn: "ID",
+                        onDelete: ReferentialAction.Cascade);
+                });
+
+            migrationBuilder.CreateIndex(
+                name: "IX_BeatmapInfo_BaseDifficultyID",
+                table: "BeatmapInfo",
+                column: "BaseDifficultyID");
+
+            migrationBuilder.CreateIndex(
+                name: "IX_BeatmapInfo_BeatmapSetInfoID",
+                table: "BeatmapInfo",
+                column: "BeatmapSetInfoID");
+
+            migrationBuilder.CreateIndex(
+                name: "IX_BeatmapInfo_Hash",
+                table: "BeatmapInfo",
+                column: "Hash");
+
+            migrationBuilder.CreateIndex(
+                name: "IX_BeatmapInfo_MD5Hash",
+                table: "BeatmapInfo",
+                column: "MD5Hash");
+
+            migrationBuilder.CreateIndex(
+                name: "IX_BeatmapInfo_MetadataID",
+                table: "BeatmapInfo",
+                column: "MetadataID");
+
+            migrationBuilder.CreateIndex(
+                name: "IX_BeatmapInfo_RulesetID",
+                table: "BeatmapInfo",
+                column: "RulesetID");
+
+            migrationBuilder.CreateIndex(
+                name: "IX_BeatmapSetFileInfo_BeatmapSetInfoID",
+                table: "BeatmapSetFileInfo",
+                column: "BeatmapSetInfoID");
+
+            migrationBuilder.CreateIndex(
+                name: "IX_BeatmapSetFileInfo_FileInfoID",
+                table: "BeatmapSetFileInfo",
+                column: "FileInfoID");
+
+            migrationBuilder.CreateIndex(
+                name: "IX_BeatmapSetInfo_DeletePending",
+                table: "BeatmapSetInfo",
+                column: "DeletePending");
+
+            migrationBuilder.CreateIndex(
+                name: "IX_BeatmapSetInfo_Hash",
+                table: "BeatmapSetInfo",
+                column: "Hash");
+
+            migrationBuilder.CreateIndex(
+                name: "IX_BeatmapSetInfo_MetadataID",
+                table: "BeatmapSetInfo",
+                column: "MetadataID");
+
+            migrationBuilder.CreateIndex(
+                name: "IX_FileInfo_Hash",
+                table: "FileInfo",
+                column: "Hash",
+                unique: true);
+
+            migrationBuilder.CreateIndex(
+                name: "IX_FileInfo_ReferenceCount",
+                table: "FileInfo",
+                column: "ReferenceCount");
+
+            migrationBuilder.CreateIndex(
+                name: "IX_KeyBinding_Action",
+                table: "KeyBinding",
+                column: "Action");
+
+            migrationBuilder.CreateIndex(
+                name: "IX_KeyBinding_Variant",
+                table: "KeyBinding",
+                column: "Variant");
+
+            migrationBuilder.CreateIndex(
+                name: "IX_RulesetInfo_Available",
+                table: "RulesetInfo",
+                column: "Available");
+        }
+
+        protected override void Down(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.DropTable(
+                name: "BeatmapInfo");
+
+            migrationBuilder.DropTable(
+                name: "BeatmapSetFileInfo");
+
+            migrationBuilder.DropTable(
+                name: "KeyBinding");
+
+            migrationBuilder.DropTable(
+                name: "BeatmapDifficulty");
+
+            migrationBuilder.DropTable(
+                name: "RulesetInfo");
+
+            migrationBuilder.DropTable(
+                name: "BeatmapSetInfo");
+
+            migrationBuilder.DropTable(
+                name: "FileInfo");
+
+            migrationBuilder.DropTable(
+                name: "BeatmapMetadata");
+        }
+    }
+}
diff --git a/osu.Game/Migrations/20171025071459_AddMissingIndexRules.Designer.cs b/osu.Game/Migrations/20171025071459_AddMissingIndexRules.Designer.cs
new file mode 100644
index 0000000000..4cd234f2ef
--- /dev/null
+++ b/osu.Game/Migrations/20171025071459_AddMissingIndexRules.Designer.cs
@@ -0,0 +1,299 @@
+// <auto-generated />
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Infrastructure;
+using Microsoft.EntityFrameworkCore.Metadata;
+using Microsoft.EntityFrameworkCore.Migrations;
+using Microsoft.EntityFrameworkCore.Storage;
+using osu.Game.Database;
+using System;
+
+namespace osu.Game.Migrations
+{
+    [DbContext(typeof(OsuDbContext))]
+    [Migration("20171025071459_AddMissingIndexRules")]
+    partial class AddMissingIndexRules
+    {
+        protected override void BuildTargetModel(ModelBuilder modelBuilder)
+        {
+#pragma warning disable 612, 618
+            modelBuilder
+                .HasAnnotation("ProductVersion", "2.0.0-rtm-26452");
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapDifficulty", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<float>("ApproachRate");
+
+                    b.Property<float>("CircleSize");
+
+                    b.Property<float>("DrainRate");
+
+                    b.Property<float>("OverallDifficulty");
+
+                    b.Property<float>("SliderMultiplier");
+
+                    b.Property<float>("SliderTickRate");
+
+                    b.HasKey("ID");
+
+                    b.ToTable("BeatmapDifficulty");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("AudioLeadIn");
+
+                    b.Property<int>("BaseDifficultyID");
+
+                    b.Property<int>("BeatDivisor");
+
+                    b.Property<int>("BeatmapSetInfoID");
+
+                    b.Property<bool>("Countdown");
+
+                    b.Property<double>("DistanceSpacing");
+
+                    b.Property<int>("GridSize");
+
+                    b.Property<string>("Hash");
+
+                    b.Property<bool>("Hidden");
+
+                    b.Property<bool>("LetterboxInBreaks");
+
+                    b.Property<string>("MD5Hash");
+
+                    b.Property<int?>("MetadataID");
+
+                    b.Property<int?>("OnlineBeatmapID");
+
+                    b.Property<string>("Path");
+
+                    b.Property<int>("RulesetID");
+
+                    b.Property<bool>("SpecialStyle");
+
+                    b.Property<float>("StackLeniency");
+
+                    b.Property<double>("StarDifficulty");
+
+                    b.Property<string>("StoredBookmarks");
+
+                    b.Property<double>("TimelineZoom");
+
+                    b.Property<string>("Version");
+
+                    b.Property<bool>("WidescreenStoryboard");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("BaseDifficultyID");
+
+                    b.HasIndex("BeatmapSetInfoID");
+
+                    b.HasIndex("Hash")
+                        .IsUnique();
+
+                    b.HasIndex("MD5Hash")
+                        .IsUnique();
+
+                    b.HasIndex("MetadataID");
+
+                    b.HasIndex("RulesetID");
+
+                    b.ToTable("BeatmapInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapMetadata", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<string>("Artist");
+
+                    b.Property<string>("ArtistUnicode");
+
+                    b.Property<string>("AudioFile");
+
+                    b.Property<string>("AuthorString")
+                        .HasColumnName("Author");
+
+                    b.Property<string>("BackgroundFile");
+
+                    b.Property<int>("PreviewTime");
+
+                    b.Property<string>("Source");
+
+                    b.Property<string>("Tags");
+
+                    b.Property<string>("Title");
+
+                    b.Property<string>("TitleUnicode");
+
+                    b.HasKey("ID");
+
+                    b.ToTable("BeatmapMetadata");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("BeatmapSetInfoID");
+
+                    b.Property<int>("FileInfoID");
+
+                    b.Property<string>("Filename")
+                        .IsRequired();
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("BeatmapSetInfoID");
+
+                    b.HasIndex("FileInfoID");
+
+                    b.ToTable("BeatmapSetFileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<bool>("DeletePending");
+
+                    b.Property<string>("Hash");
+
+                    b.Property<int?>("MetadataID");
+
+                    b.Property<int?>("OnlineBeatmapSetID");
+
+                    b.Property<bool>("Protected");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("DeletePending");
+
+                    b.HasIndex("Hash")
+                        .IsUnique();
+
+                    b.HasIndex("MetadataID");
+
+                    b.HasIndex("OnlineBeatmapSetID")
+                        .IsUnique();
+
+                    b.ToTable("BeatmapSetInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Input.Bindings.DatabasedKeyBinding", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("IntAction")
+                        .HasColumnName("Action");
+
+                    b.Property<string>("KeysString")
+                        .HasColumnName("Keys");
+
+                    b.Property<int?>("RulesetID");
+
+                    b.Property<int?>("Variant");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("IntAction");
+
+                    b.HasIndex("Variant");
+
+                    b.ToTable("KeyBinding");
+                });
+
+            modelBuilder.Entity("osu.Game.IO.FileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<string>("Hash");
+
+                    b.Property<int>("ReferenceCount");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("Hash")
+                        .IsUnique();
+
+                    b.HasIndex("ReferenceCount");
+
+                    b.ToTable("FileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Rulesets.RulesetInfo", b =>
+                {
+                    b.Property<int?>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<bool>("Available");
+
+                    b.Property<string>("InstantiationInfo");
+
+                    b.Property<string>("Name");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("Available");
+
+                    b.ToTable("RulesetInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapDifficulty", "BaseDifficulty")
+                        .WithMany()
+                        .HasForeignKey("BaseDifficultyID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo", "BeatmapSet")
+                        .WithMany("Beatmaps")
+                        .HasForeignKey("BeatmapSetInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
+                        .WithMany("Beatmaps")
+                        .HasForeignKey("MetadataID");
+
+                    b.HasOne("osu.Game.Rulesets.RulesetInfo", "Ruleset")
+                        .WithMany()
+                        .HasForeignKey("RulesetID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo")
+                        .WithMany("Files")
+                        .HasForeignKey("BeatmapSetInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
+                        .WithMany()
+                        .HasForeignKey("FileInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
+                        .WithMany("BeatmapSets")
+                        .HasForeignKey("MetadataID");
+                });
+#pragma warning restore 612, 618
+        }
+    }
+}
diff --git a/osu.Game/Migrations/20171025071459_AddMissingIndexRules.cs b/osu.Game/Migrations/20171025071459_AddMissingIndexRules.cs
new file mode 100644
index 0000000000..c9fc59c5a2
--- /dev/null
+++ b/osu.Game/Migrations/20171025071459_AddMissingIndexRules.cs
@@ -0,0 +1,80 @@
+using Microsoft.EntityFrameworkCore.Migrations;
+
+namespace osu.Game.Migrations
+{
+    public partial class AddMissingIndexRules : Migration
+    {
+        protected override void Up(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.DropIndex(
+                name: "IX_BeatmapSetInfo_Hash",
+                table: "BeatmapSetInfo");
+
+            migrationBuilder.DropIndex(
+                name: "IX_BeatmapInfo_Hash",
+                table: "BeatmapInfo");
+
+            migrationBuilder.DropIndex(
+                name: "IX_BeatmapInfo_MD5Hash",
+                table: "BeatmapInfo");
+
+            migrationBuilder.CreateIndex(
+                name: "IX_BeatmapSetInfo_Hash",
+                table: "BeatmapSetInfo",
+                column: "Hash",
+                unique: true);
+
+            migrationBuilder.CreateIndex(
+                name: "IX_BeatmapSetInfo_OnlineBeatmapSetID",
+                table: "BeatmapSetInfo",
+                column: "OnlineBeatmapSetID",
+                unique: true);
+
+            migrationBuilder.CreateIndex(
+                name: "IX_BeatmapInfo_Hash",
+                table: "BeatmapInfo",
+                column: "Hash",
+                unique: true);
+
+            migrationBuilder.CreateIndex(
+                name: "IX_BeatmapInfo_MD5Hash",
+                table: "BeatmapInfo",
+                column: "MD5Hash",
+                unique: true);
+        }
+
+        protected override void Down(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.DropIndex(
+                name: "IX_BeatmapSetInfo_Hash",
+                table: "BeatmapSetInfo");
+
+            migrationBuilder.DropIndex(
+                name: "IX_BeatmapSetInfo_OnlineBeatmapSetID",
+                table: "BeatmapSetInfo");
+
+            migrationBuilder.DropIndex(
+                name: "IX_BeatmapInfo_Hash",
+                table: "BeatmapInfo");
+
+            migrationBuilder.DropIndex(
+                name: "IX_BeatmapInfo_MD5Hash",
+                table: "BeatmapInfo");
+
+            migrationBuilder.CreateIndex(
+                name: "IX_BeatmapSetInfo_Hash",
+                table: "BeatmapSetInfo",
+                column: "Hash");
+
+            migrationBuilder.CreateIndex(
+                name: "IX_BeatmapInfo_Hash",
+                table: "BeatmapInfo",
+                column: "Hash");
+
+            migrationBuilder.CreateIndex(
+                name: "IX_BeatmapInfo_MD5Hash",
+                table: "BeatmapInfo",
+                column: "MD5Hash");
+        }
+    }
+}
diff --git a/osu.Game/Migrations/20171119065731_AddBeatmapOnlineIDUniqueConstraint.Designer.cs b/osu.Game/Migrations/20171119065731_AddBeatmapOnlineIDUniqueConstraint.Designer.cs
new file mode 100644
index 0000000000..006acf12cd
--- /dev/null
+++ b/osu.Game/Migrations/20171119065731_AddBeatmapOnlineIDUniqueConstraint.Designer.cs
@@ -0,0 +1,302 @@
+// <auto-generated />
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Infrastructure;
+using Microsoft.EntityFrameworkCore.Metadata;
+using Microsoft.EntityFrameworkCore.Migrations;
+using Microsoft.EntityFrameworkCore.Storage;
+using osu.Game.Database;
+using System;
+
+namespace osu.Game.Migrations
+{
+    [DbContext(typeof(OsuDbContext))]
+    [Migration("20171119065731_AddBeatmapOnlineIDUniqueConstraint")]
+    partial class AddBeatmapOnlineIDUniqueConstraint
+    {
+        protected override void BuildTargetModel(ModelBuilder modelBuilder)
+        {
+#pragma warning disable 612, 618
+            modelBuilder
+                .HasAnnotation("ProductVersion", "2.0.0-rtm-26452");
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapDifficulty", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<float>("ApproachRate");
+
+                    b.Property<float>("CircleSize");
+
+                    b.Property<float>("DrainRate");
+
+                    b.Property<float>("OverallDifficulty");
+
+                    b.Property<float>("SliderMultiplier");
+
+                    b.Property<float>("SliderTickRate");
+
+                    b.HasKey("ID");
+
+                    b.ToTable("BeatmapDifficulty");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("AudioLeadIn");
+
+                    b.Property<int>("BaseDifficultyID");
+
+                    b.Property<int>("BeatDivisor");
+
+                    b.Property<int>("BeatmapSetInfoID");
+
+                    b.Property<bool>("Countdown");
+
+                    b.Property<double>("DistanceSpacing");
+
+                    b.Property<int>("GridSize");
+
+                    b.Property<string>("Hash");
+
+                    b.Property<bool>("Hidden");
+
+                    b.Property<bool>("LetterboxInBreaks");
+
+                    b.Property<string>("MD5Hash");
+
+                    b.Property<int?>("MetadataID");
+
+                    b.Property<int?>("OnlineBeatmapID");
+
+                    b.Property<string>("Path");
+
+                    b.Property<int>("RulesetID");
+
+                    b.Property<bool>("SpecialStyle");
+
+                    b.Property<float>("StackLeniency");
+
+                    b.Property<double>("StarDifficulty");
+
+                    b.Property<string>("StoredBookmarks");
+
+                    b.Property<double>("TimelineZoom");
+
+                    b.Property<string>("Version");
+
+                    b.Property<bool>("WidescreenStoryboard");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("BaseDifficultyID");
+
+                    b.HasIndex("BeatmapSetInfoID");
+
+                    b.HasIndex("Hash")
+                        .IsUnique();
+
+                    b.HasIndex("MD5Hash")
+                        .IsUnique();
+
+                    b.HasIndex("MetadataID");
+
+                    b.HasIndex("OnlineBeatmapID")
+                        .IsUnique();
+
+                    b.HasIndex("RulesetID");
+
+                    b.ToTable("BeatmapInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapMetadata", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<string>("Artist");
+
+                    b.Property<string>("ArtistUnicode");
+
+                    b.Property<string>("AudioFile");
+
+                    b.Property<string>("AuthorString")
+                        .HasColumnName("Author");
+
+                    b.Property<string>("BackgroundFile");
+
+                    b.Property<int>("PreviewTime");
+
+                    b.Property<string>("Source");
+
+                    b.Property<string>("Tags");
+
+                    b.Property<string>("Title");
+
+                    b.Property<string>("TitleUnicode");
+
+                    b.HasKey("ID");
+
+                    b.ToTable("BeatmapMetadata");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("BeatmapSetInfoID");
+
+                    b.Property<int>("FileInfoID");
+
+                    b.Property<string>("Filename")
+                        .IsRequired();
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("BeatmapSetInfoID");
+
+                    b.HasIndex("FileInfoID");
+
+                    b.ToTable("BeatmapSetFileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<bool>("DeletePending");
+
+                    b.Property<string>("Hash");
+
+                    b.Property<int?>("MetadataID");
+
+                    b.Property<int?>("OnlineBeatmapSetID");
+
+                    b.Property<bool>("Protected");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("DeletePending");
+
+                    b.HasIndex("Hash")
+                        .IsUnique();
+
+                    b.HasIndex("MetadataID");
+
+                    b.HasIndex("OnlineBeatmapSetID")
+                        .IsUnique();
+
+                    b.ToTable("BeatmapSetInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Input.Bindings.DatabasedKeyBinding", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("IntAction")
+                        .HasColumnName("Action");
+
+                    b.Property<string>("KeysString")
+                        .HasColumnName("Keys");
+
+                    b.Property<int?>("RulesetID");
+
+                    b.Property<int?>("Variant");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("IntAction");
+
+                    b.HasIndex("Variant");
+
+                    b.ToTable("KeyBinding");
+                });
+
+            modelBuilder.Entity("osu.Game.IO.FileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<string>("Hash");
+
+                    b.Property<int>("ReferenceCount");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("Hash")
+                        .IsUnique();
+
+                    b.HasIndex("ReferenceCount");
+
+                    b.ToTable("FileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Rulesets.RulesetInfo", b =>
+                {
+                    b.Property<int?>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<bool>("Available");
+
+                    b.Property<string>("InstantiationInfo");
+
+                    b.Property<string>("Name");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("Available");
+
+                    b.ToTable("RulesetInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapDifficulty", "BaseDifficulty")
+                        .WithMany()
+                        .HasForeignKey("BaseDifficultyID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo", "BeatmapSet")
+                        .WithMany("Beatmaps")
+                        .HasForeignKey("BeatmapSetInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
+                        .WithMany("Beatmaps")
+                        .HasForeignKey("MetadataID");
+
+                    b.HasOne("osu.Game.Rulesets.RulesetInfo", "Ruleset")
+                        .WithMany()
+                        .HasForeignKey("RulesetID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo")
+                        .WithMany("Files")
+                        .HasForeignKey("BeatmapSetInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
+                        .WithMany()
+                        .HasForeignKey("FileInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
+                        .WithMany("BeatmapSets")
+                        .HasForeignKey("MetadataID");
+                });
+#pragma warning restore 612, 618
+        }
+    }
+}
diff --git a/osu.Game/Migrations/20171119065731_AddBeatmapOnlineIDUniqueConstraint.cs b/osu.Game/Migrations/20171119065731_AddBeatmapOnlineIDUniqueConstraint.cs
new file mode 100644
index 0000000000..084ae67940
--- /dev/null
+++ b/osu.Game/Migrations/20171119065731_AddBeatmapOnlineIDUniqueConstraint.cs
@@ -0,0 +1,23 @@
+using Microsoft.EntityFrameworkCore.Migrations;
+
+namespace osu.Game.Migrations
+{
+    public partial class AddBeatmapOnlineIDUniqueConstraint : Migration
+    {
+        protected override void Up(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.CreateIndex(
+                name: "IX_BeatmapInfo_OnlineBeatmapID",
+                table: "BeatmapInfo",
+                column: "OnlineBeatmapID",
+                unique: true);
+        }
+
+        protected override void Down(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.DropIndex(
+                name: "IX_BeatmapInfo_OnlineBeatmapID",
+                table: "BeatmapInfo");
+        }
+    }
+}
diff --git a/osu.Game/Migrations/20171209034410_AddRulesetInfoShortName.Designer.cs b/osu.Game/Migrations/20171209034410_AddRulesetInfoShortName.Designer.cs
new file mode 100644
index 0000000000..fc2496bc24
--- /dev/null
+++ b/osu.Game/Migrations/20171209034410_AddRulesetInfoShortName.Designer.cs
@@ -0,0 +1,307 @@
+// <auto-generated />
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Infrastructure;
+using Microsoft.EntityFrameworkCore.Metadata;
+using Microsoft.EntityFrameworkCore.Migrations;
+using Microsoft.EntityFrameworkCore.Storage;
+using osu.Game.Database;
+using System;
+
+namespace osu.Game.Migrations
+{
+    [DbContext(typeof(OsuDbContext))]
+    [Migration("20171209034410_AddRulesetInfoShortName")]
+    partial class AddRulesetInfoShortName
+    {
+        protected override void BuildTargetModel(ModelBuilder modelBuilder)
+        {
+#pragma warning disable 612, 618
+            modelBuilder
+                .HasAnnotation("ProductVersion", "2.0.0-rtm-26452");
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapDifficulty", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<float>("ApproachRate");
+
+                    b.Property<float>("CircleSize");
+
+                    b.Property<float>("DrainRate");
+
+                    b.Property<float>("OverallDifficulty");
+
+                    b.Property<float>("SliderMultiplier");
+
+                    b.Property<float>("SliderTickRate");
+
+                    b.HasKey("ID");
+
+                    b.ToTable("BeatmapDifficulty");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("AudioLeadIn");
+
+                    b.Property<int>("BaseDifficultyID");
+
+                    b.Property<int>("BeatDivisor");
+
+                    b.Property<int>("BeatmapSetInfoID");
+
+                    b.Property<bool>("Countdown");
+
+                    b.Property<double>("DistanceSpacing");
+
+                    b.Property<int>("GridSize");
+
+                    b.Property<string>("Hash");
+
+                    b.Property<bool>("Hidden");
+
+                    b.Property<bool>("LetterboxInBreaks");
+
+                    b.Property<string>("MD5Hash");
+
+                    b.Property<int?>("MetadataID");
+
+                    b.Property<int?>("OnlineBeatmapID");
+
+                    b.Property<string>("Path");
+
+                    b.Property<int>("RulesetID");
+
+                    b.Property<bool>("SpecialStyle");
+
+                    b.Property<float>("StackLeniency");
+
+                    b.Property<double>("StarDifficulty");
+
+                    b.Property<string>("StoredBookmarks");
+
+                    b.Property<double>("TimelineZoom");
+
+                    b.Property<string>("Version");
+
+                    b.Property<bool>("WidescreenStoryboard");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("BaseDifficultyID");
+
+                    b.HasIndex("BeatmapSetInfoID");
+
+                    b.HasIndex("Hash")
+                        .IsUnique();
+
+                    b.HasIndex("MD5Hash")
+                        .IsUnique();
+
+                    b.HasIndex("MetadataID");
+
+                    b.HasIndex("OnlineBeatmapID")
+                        .IsUnique();
+
+                    b.HasIndex("RulesetID");
+
+                    b.ToTable("BeatmapInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapMetadata", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<string>("Artist");
+
+                    b.Property<string>("ArtistUnicode");
+
+                    b.Property<string>("AudioFile");
+
+                    b.Property<string>("AuthorString")
+                        .HasColumnName("Author");
+
+                    b.Property<string>("BackgroundFile");
+
+                    b.Property<int>("PreviewTime");
+
+                    b.Property<string>("Source");
+
+                    b.Property<string>("Tags");
+
+                    b.Property<string>("Title");
+
+                    b.Property<string>("TitleUnicode");
+
+                    b.HasKey("ID");
+
+                    b.ToTable("BeatmapMetadata");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("BeatmapSetInfoID");
+
+                    b.Property<int>("FileInfoID");
+
+                    b.Property<string>("Filename")
+                        .IsRequired();
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("BeatmapSetInfoID");
+
+                    b.HasIndex("FileInfoID");
+
+                    b.ToTable("BeatmapSetFileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<bool>("DeletePending");
+
+                    b.Property<string>("Hash");
+
+                    b.Property<int?>("MetadataID");
+
+                    b.Property<int?>("OnlineBeatmapSetID");
+
+                    b.Property<bool>("Protected");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("DeletePending");
+
+                    b.HasIndex("Hash")
+                        .IsUnique();
+
+                    b.HasIndex("MetadataID");
+
+                    b.HasIndex("OnlineBeatmapSetID")
+                        .IsUnique();
+
+                    b.ToTable("BeatmapSetInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Input.Bindings.DatabasedKeyBinding", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("IntAction")
+                        .HasColumnName("Action");
+
+                    b.Property<string>("KeysString")
+                        .HasColumnName("Keys");
+
+                    b.Property<int?>("RulesetID");
+
+                    b.Property<int?>("Variant");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("IntAction");
+
+                    b.HasIndex("Variant");
+
+                    b.ToTable("KeyBinding");
+                });
+
+            modelBuilder.Entity("osu.Game.IO.FileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<string>("Hash");
+
+                    b.Property<int>("ReferenceCount");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("Hash")
+                        .IsUnique();
+
+                    b.HasIndex("ReferenceCount");
+
+                    b.ToTable("FileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Rulesets.RulesetInfo", b =>
+                {
+                    b.Property<int?>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<bool>("Available");
+
+                    b.Property<string>("InstantiationInfo");
+
+                    b.Property<string>("Name");
+
+                    b.Property<string>("ShortName");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("Available");
+
+                    b.HasIndex("ShortName")
+                        .IsUnique();
+
+                    b.ToTable("RulesetInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapDifficulty", "BaseDifficulty")
+                        .WithMany()
+                        .HasForeignKey("BaseDifficultyID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo", "BeatmapSet")
+                        .WithMany("Beatmaps")
+                        .HasForeignKey("BeatmapSetInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
+                        .WithMany("Beatmaps")
+                        .HasForeignKey("MetadataID");
+
+                    b.HasOne("osu.Game.Rulesets.RulesetInfo", "Ruleset")
+                        .WithMany()
+                        .HasForeignKey("RulesetID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo")
+                        .WithMany("Files")
+                        .HasForeignKey("BeatmapSetInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
+                        .WithMany()
+                        .HasForeignKey("FileInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
+                        .WithMany("BeatmapSets")
+                        .HasForeignKey("MetadataID");
+                });
+#pragma warning restore 612, 618
+        }
+    }
+}
diff --git a/osu.Game/Migrations/20171209034410_AddRulesetInfoShortName.cs b/osu.Game/Migrations/20171209034410_AddRulesetInfoShortName.cs
new file mode 100644
index 0000000000..09cf0af89c
--- /dev/null
+++ b/osu.Game/Migrations/20171209034410_AddRulesetInfoShortName.cs
@@ -0,0 +1,33 @@
+using Microsoft.EntityFrameworkCore.Migrations;
+
+namespace osu.Game.Migrations
+{
+    public partial class AddRulesetInfoShortName : Migration
+    {
+        protected override void Up(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.AddColumn<string>(
+                name: "ShortName",
+                table: "RulesetInfo",
+                type: "TEXT",
+                nullable: true);
+
+            migrationBuilder.CreateIndex(
+                name: "IX_RulesetInfo_ShortName",
+                table: "RulesetInfo",
+                column: "ShortName",
+                unique: true);
+        }
+
+        protected override void Down(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.DropIndex(
+                name: "IX_RulesetInfo_ShortName",
+                table: "RulesetInfo");
+
+            migrationBuilder.DropColumn(
+                name: "ShortName",
+                table: "RulesetInfo");
+        }
+    }
+}
diff --git a/osu.Game/Migrations/20180125143340_Settings.Designer.cs b/osu.Game/Migrations/20180125143340_Settings.Designer.cs
new file mode 100644
index 0000000000..4bb599eec1
--- /dev/null
+++ b/osu.Game/Migrations/20180125143340_Settings.Designer.cs
@@ -0,0 +1,329 @@
+// <auto-generated />
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Infrastructure;
+using Microsoft.EntityFrameworkCore.Metadata;
+using Microsoft.EntityFrameworkCore.Migrations;
+using Microsoft.EntityFrameworkCore.Storage;
+using osu.Game.Database;
+using System;
+
+namespace osu.Game.Migrations
+{
+    [DbContext(typeof(OsuDbContext))]
+    [Migration("20180125143340_Settings")]
+    partial class Settings
+    {
+        protected override void BuildTargetModel(ModelBuilder modelBuilder)
+        {
+#pragma warning disable 612, 618
+            modelBuilder
+                .HasAnnotation("ProductVersion", "2.0.0-rtm-26452");
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapDifficulty", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<float>("ApproachRate");
+
+                    b.Property<float>("CircleSize");
+
+                    b.Property<float>("DrainRate");
+
+                    b.Property<float>("OverallDifficulty");
+
+                    b.Property<float>("SliderMultiplier");
+
+                    b.Property<float>("SliderTickRate");
+
+                    b.HasKey("ID");
+
+                    b.ToTable("BeatmapDifficulty");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("AudioLeadIn");
+
+                    b.Property<int>("BaseDifficultyID");
+
+                    b.Property<int>("BeatDivisor");
+
+                    b.Property<int>("BeatmapSetInfoID");
+
+                    b.Property<bool>("Countdown");
+
+                    b.Property<double>("DistanceSpacing");
+
+                    b.Property<int>("GridSize");
+
+                    b.Property<string>("Hash");
+
+                    b.Property<bool>("Hidden");
+
+                    b.Property<bool>("LetterboxInBreaks");
+
+                    b.Property<string>("MD5Hash");
+
+                    b.Property<int?>("MetadataID");
+
+                    b.Property<int?>("OnlineBeatmapID");
+
+                    b.Property<string>("Path");
+
+                    b.Property<int>("RulesetID");
+
+                    b.Property<bool>("SpecialStyle");
+
+                    b.Property<float>("StackLeniency");
+
+                    b.Property<double>("StarDifficulty");
+
+                    b.Property<string>("StoredBookmarks");
+
+                    b.Property<double>("TimelineZoom");
+
+                    b.Property<string>("Version");
+
+                    b.Property<bool>("WidescreenStoryboard");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("BaseDifficultyID");
+
+                    b.HasIndex("BeatmapSetInfoID");
+
+                    b.HasIndex("Hash")
+                        .IsUnique();
+
+                    b.HasIndex("MD5Hash")
+                        .IsUnique();
+
+                    b.HasIndex("MetadataID");
+
+                    b.HasIndex("OnlineBeatmapID")
+                        .IsUnique();
+
+                    b.HasIndex("RulesetID");
+
+                    b.ToTable("BeatmapInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapMetadata", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<string>("Artist");
+
+                    b.Property<string>("ArtistUnicode");
+
+                    b.Property<string>("AudioFile");
+
+                    b.Property<string>("AuthorString")
+                        .HasColumnName("Author");
+
+                    b.Property<string>("BackgroundFile");
+
+                    b.Property<int>("PreviewTime");
+
+                    b.Property<string>("Source");
+
+                    b.Property<string>("Tags");
+
+                    b.Property<string>("Title");
+
+                    b.Property<string>("TitleUnicode");
+
+                    b.HasKey("ID");
+
+                    b.ToTable("BeatmapMetadata");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("BeatmapSetInfoID");
+
+                    b.Property<int>("FileInfoID");
+
+                    b.Property<string>("Filename")
+                        .IsRequired();
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("BeatmapSetInfoID");
+
+                    b.HasIndex("FileInfoID");
+
+                    b.ToTable("BeatmapSetFileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<bool>("DeletePending");
+
+                    b.Property<string>("Hash");
+
+                    b.Property<int?>("MetadataID");
+
+                    b.Property<int?>("OnlineBeatmapSetID");
+
+                    b.Property<bool>("Protected");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("DeletePending");
+
+                    b.HasIndex("Hash")
+                        .IsUnique();
+
+                    b.HasIndex("MetadataID");
+
+                    b.HasIndex("OnlineBeatmapSetID")
+                        .IsUnique();
+
+                    b.ToTable("BeatmapSetInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Configuration.DatabasedSetting", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("IntKey")
+                        .HasColumnName("Key");
+
+                    b.Property<int?>("RulesetID");
+
+                    b.Property<string>("StringValue")
+                        .HasColumnName("Value");
+
+                    b.Property<int?>("Variant");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("RulesetID", "Variant");
+
+                    b.ToTable("Settings");
+                });
+
+            modelBuilder.Entity("osu.Game.Input.Bindings.DatabasedKeyBinding", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("IntAction")
+                        .HasColumnName("Action");
+
+                    b.Property<string>("KeysString")
+                        .HasColumnName("Keys");
+
+                    b.Property<int?>("RulesetID");
+
+                    b.Property<int?>("Variant");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("IntAction");
+
+                    b.HasIndex("RulesetID", "Variant");
+
+                    b.ToTable("KeyBinding");
+                });
+
+            modelBuilder.Entity("osu.Game.IO.FileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<string>("Hash");
+
+                    b.Property<int>("ReferenceCount");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("Hash")
+                        .IsUnique();
+
+                    b.HasIndex("ReferenceCount");
+
+                    b.ToTable("FileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Rulesets.RulesetInfo", b =>
+                {
+                    b.Property<int?>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<bool>("Available");
+
+                    b.Property<string>("InstantiationInfo");
+
+                    b.Property<string>("Name");
+
+                    b.Property<string>("ShortName");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("Available");
+
+                    b.HasIndex("ShortName")
+                        .IsUnique();
+
+                    b.ToTable("RulesetInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapDifficulty", "BaseDifficulty")
+                        .WithMany()
+                        .HasForeignKey("BaseDifficultyID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo", "BeatmapSet")
+                        .WithMany("Beatmaps")
+                        .HasForeignKey("BeatmapSetInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
+                        .WithMany("Beatmaps")
+                        .HasForeignKey("MetadataID");
+
+                    b.HasOne("osu.Game.Rulesets.RulesetInfo", "Ruleset")
+                        .WithMany()
+                        .HasForeignKey("RulesetID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo")
+                        .WithMany("Files")
+                        .HasForeignKey("BeatmapSetInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
+                        .WithMany()
+                        .HasForeignKey("FileInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
+                        .WithMany("BeatmapSets")
+                        .HasForeignKey("MetadataID");
+                });
+#pragma warning restore 612, 618
+        }
+    }
+}
diff --git a/osu.Game/Migrations/20180125143340_Settings.cs b/osu.Game/Migrations/20180125143340_Settings.cs
new file mode 100644
index 0000000000..166d3c086d
--- /dev/null
+++ b/osu.Game/Migrations/20180125143340_Settings.cs
@@ -0,0 +1,55 @@
+using Microsoft.EntityFrameworkCore.Migrations;
+
+namespace osu.Game.Migrations
+{
+    public partial class Settings : Migration
+    {
+        protected override void Up(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.DropIndex(
+                name: "IX_KeyBinding_Variant",
+                table: "KeyBinding");
+
+            migrationBuilder.CreateTable(
+                name: "Settings",
+                columns: table => new
+                {
+                    ID = table.Column<int>(type: "INTEGER", nullable: false)
+                        .Annotation("Sqlite:Autoincrement", true),
+                    Key = table.Column<int>(type: "TEXT", nullable: false),
+                    RulesetID = table.Column<int>(type: "INTEGER", nullable: true),
+                    Value = table.Column<string>(type: "TEXT", nullable: true),
+                    Variant = table.Column<int>(type: "INTEGER", nullable: true)
+                },
+                constraints: table =>
+                {
+                    table.PrimaryKey("PK_Settings", x => x.ID);
+                });
+
+            migrationBuilder.CreateIndex(
+                name: "IX_KeyBinding_RulesetID_Variant",
+                table: "KeyBinding",
+                columns: new[] { "RulesetID", "Variant" });
+
+            migrationBuilder.CreateIndex(
+                name: "IX_Settings_RulesetID_Variant",
+                table: "Settings",
+                columns: new[] { "RulesetID", "Variant" });
+        }
+
+        protected override void Down(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.DropTable(
+                name: "Settings");
+
+            migrationBuilder.DropIndex(
+                name: "IX_KeyBinding_RulesetID_Variant",
+                table: "KeyBinding");
+
+            migrationBuilder.CreateIndex(
+                name: "IX_KeyBinding_Variant",
+                table: "KeyBinding",
+                column: "Variant");
+        }
+    }
+}
diff --git a/osu.Game/Migrations/20180131154205_AddMuteBinding.cs b/osu.Game/Migrations/20180131154205_AddMuteBinding.cs
new file mode 100644
index 0000000000..5564a30bbf
--- /dev/null
+++ b/osu.Game/Migrations/20180131154205_AddMuteBinding.cs
@@ -0,0 +1,23 @@
+using Microsoft.EntityFrameworkCore.Migrations;
+using Microsoft.EntityFrameworkCore.Infrastructure;
+using osu.Game.Database;
+using osu.Game.Input.Bindings;
+
+namespace osu.Game.Migrations
+{
+    [DbContext(typeof(OsuDbContext))]
+    [Migration("20180131154205_AddMuteBinding")]
+    public partial class AddMuteBinding : Migration
+    {
+        protected override void Up(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.Sql($"UPDATE KeyBinding SET Action = Action + 1 WHERE RulesetID IS NULL AND Variant IS NULL AND Action >= {(int)GlobalAction.ToggleMute}");
+        }
+
+        protected override void Down(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.Sql($"DELETE FROM KeyBinding WHERE RulesetID IS NULL AND Variant IS NULL AND Action = {(int)GlobalAction.ToggleMute}");
+            migrationBuilder.Sql($"UPDATE KeyBinding SET Action = Action - 1 WHERE RulesetID IS NULL AND Variant IS NULL AND Action > {(int)GlobalAction.ToggleMute}");
+        }
+    }
+}
diff --git a/osu.Game/Migrations/20180219060912_AddSkins.Designer.cs b/osu.Game/Migrations/20180219060912_AddSkins.Designer.cs
new file mode 100644
index 0000000000..cdc4ef2e66
--- /dev/null
+++ b/osu.Game/Migrations/20180219060912_AddSkins.Designer.cs
@@ -0,0 +1,379 @@
+// <auto-generated />
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Infrastructure;
+using Microsoft.EntityFrameworkCore.Metadata;
+using Microsoft.EntityFrameworkCore.Migrations;
+using Microsoft.EntityFrameworkCore.Storage;
+using osu.Game.Database;
+using System;
+
+namespace osu.Game.Migrations
+{
+    [DbContext(typeof(OsuDbContext))]
+    [Migration("20180219060912_AddSkins")]
+    partial class AddSkins
+    {
+        protected override void BuildTargetModel(ModelBuilder modelBuilder)
+        {
+#pragma warning disable 612, 618
+            modelBuilder
+                .HasAnnotation("ProductVersion", "2.0.0-rtm-26452");
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapDifficulty", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<float>("ApproachRate");
+
+                    b.Property<float>("CircleSize");
+
+                    b.Property<float>("DrainRate");
+
+                    b.Property<float>("OverallDifficulty");
+
+                    b.Property<float>("SliderMultiplier");
+
+                    b.Property<float>("SliderTickRate");
+
+                    b.HasKey("ID");
+
+                    b.ToTable("BeatmapDifficulty");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("AudioLeadIn");
+
+                    b.Property<int>("BaseDifficultyID");
+
+                    b.Property<int>("BeatDivisor");
+
+                    b.Property<int>("BeatmapSetInfoID");
+
+                    b.Property<bool>("Countdown");
+
+                    b.Property<double>("DistanceSpacing");
+
+                    b.Property<int>("GridSize");
+
+                    b.Property<string>("Hash");
+
+                    b.Property<bool>("Hidden");
+
+                    b.Property<bool>("LetterboxInBreaks");
+
+                    b.Property<string>("MD5Hash");
+
+                    b.Property<int?>("MetadataID");
+
+                    b.Property<int?>("OnlineBeatmapID");
+
+                    b.Property<string>("Path");
+
+                    b.Property<int>("RulesetID");
+
+                    b.Property<bool>("SpecialStyle");
+
+                    b.Property<float>("StackLeniency");
+
+                    b.Property<double>("StarDifficulty");
+
+                    b.Property<string>("StoredBookmarks");
+
+                    b.Property<double>("TimelineZoom");
+
+                    b.Property<string>("Version");
+
+                    b.Property<bool>("WidescreenStoryboard");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("BaseDifficultyID");
+
+                    b.HasIndex("BeatmapSetInfoID");
+
+                    b.HasIndex("Hash")
+                        .IsUnique();
+
+                    b.HasIndex("MD5Hash")
+                        .IsUnique();
+
+                    b.HasIndex("MetadataID");
+
+                    b.HasIndex("OnlineBeatmapID")
+                        .IsUnique();
+
+                    b.HasIndex("RulesetID");
+
+                    b.ToTable("BeatmapInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapMetadata", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<string>("Artist");
+
+                    b.Property<string>("ArtistUnicode");
+
+                    b.Property<string>("AudioFile");
+
+                    b.Property<string>("AuthorString")
+                        .HasColumnName("Author");
+
+                    b.Property<string>("BackgroundFile");
+
+                    b.Property<int>("PreviewTime");
+
+                    b.Property<string>("Source");
+
+                    b.Property<string>("Tags");
+
+                    b.Property<string>("Title");
+
+                    b.Property<string>("TitleUnicode");
+
+                    b.HasKey("ID");
+
+                    b.ToTable("BeatmapMetadata");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("BeatmapSetInfoID");
+
+                    b.Property<int>("FileInfoID");
+
+                    b.Property<string>("Filename")
+                        .IsRequired();
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("BeatmapSetInfoID");
+
+                    b.HasIndex("FileInfoID");
+
+                    b.ToTable("BeatmapSetFileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<bool>("DeletePending");
+
+                    b.Property<string>("Hash");
+
+                    b.Property<int?>("MetadataID");
+
+                    b.Property<int?>("OnlineBeatmapSetID");
+
+                    b.Property<bool>("Protected");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("DeletePending");
+
+                    b.HasIndex("Hash")
+                        .IsUnique();
+
+                    b.HasIndex("MetadataID");
+
+                    b.HasIndex("OnlineBeatmapSetID")
+                        .IsUnique();
+
+                    b.ToTable("BeatmapSetInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Configuration.DatabasedSetting", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("IntKey")
+                        .HasColumnName("Key");
+
+                    b.Property<int?>("RulesetID");
+
+                    b.Property<string>("StringValue")
+                        .HasColumnName("Value");
+
+                    b.Property<int?>("Variant");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("RulesetID", "Variant");
+
+                    b.ToTable("Settings");
+                });
+
+            modelBuilder.Entity("osu.Game.Input.Bindings.DatabasedKeyBinding", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("IntAction")
+                        .HasColumnName("Action");
+
+                    b.Property<string>("KeysString")
+                        .HasColumnName("Keys");
+
+                    b.Property<int?>("RulesetID");
+
+                    b.Property<int?>("Variant");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("IntAction");
+
+                    b.HasIndex("RulesetID", "Variant");
+
+                    b.ToTable("KeyBinding");
+                });
+
+            modelBuilder.Entity("osu.Game.IO.FileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<string>("Hash");
+
+                    b.Property<int>("ReferenceCount");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("Hash")
+                        .IsUnique();
+
+                    b.HasIndex("ReferenceCount");
+
+                    b.ToTable("FileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Rulesets.RulesetInfo", b =>
+                {
+                    b.Property<int?>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<bool>("Available");
+
+                    b.Property<string>("InstantiationInfo");
+
+                    b.Property<string>("Name");
+
+                    b.Property<string>("ShortName");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("Available");
+
+                    b.HasIndex("ShortName")
+                        .IsUnique();
+
+                    b.ToTable("RulesetInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Skinning.SkinFileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("FileInfoID");
+
+                    b.Property<string>("Filename")
+                        .IsRequired();
+
+                    b.Property<int>("SkinInfoID");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("FileInfoID");
+
+                    b.HasIndex("SkinInfoID");
+
+                    b.ToTable("SkinFileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Skinning.SkinInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<string>("Creator");
+
+                    b.Property<bool>("DeletePending");
+
+                    b.Property<string>("Name");
+
+                    b.HasKey("ID");
+
+                    b.ToTable("SkinInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapDifficulty", "BaseDifficulty")
+                        .WithMany()
+                        .HasForeignKey("BaseDifficultyID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo", "BeatmapSet")
+                        .WithMany("Beatmaps")
+                        .HasForeignKey("BeatmapSetInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
+                        .WithMany("Beatmaps")
+                        .HasForeignKey("MetadataID");
+
+                    b.HasOne("osu.Game.Rulesets.RulesetInfo", "Ruleset")
+                        .WithMany()
+                        .HasForeignKey("RulesetID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo")
+                        .WithMany("Files")
+                        .HasForeignKey("BeatmapSetInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
+                        .WithMany()
+                        .HasForeignKey("FileInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
+                        .WithMany("BeatmapSets")
+                        .HasForeignKey("MetadataID");
+                });
+
+            modelBuilder.Entity("osu.Game.Skinning.SkinFileInfo", b =>
+                {
+                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
+                        .WithMany()
+                        .HasForeignKey("FileInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Skinning.SkinInfo")
+                        .WithMany("Files")
+                        .HasForeignKey("SkinInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+#pragma warning restore 612, 618
+        }
+    }
+}
diff --git a/osu.Game/Migrations/20180219060912_AddSkins.cs b/osu.Game/Migrations/20180219060912_AddSkins.cs
new file mode 100644
index 0000000000..a0270ab0fd
--- /dev/null
+++ b/osu.Game/Migrations/20180219060912_AddSkins.cs
@@ -0,0 +1,71 @@
+using Microsoft.EntityFrameworkCore.Migrations;
+
+namespace osu.Game.Migrations
+{
+    public partial class AddSkins : Migration
+    {
+        protected override void Up(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.CreateTable(
+                name: "SkinInfo",
+                columns: table => new
+                {
+                    ID = table.Column<int>(type: "INTEGER", nullable: false)
+                        .Annotation("Sqlite:Autoincrement", true),
+                    Creator = table.Column<string>(type: "TEXT", nullable: true),
+                    DeletePending = table.Column<bool>(type: "INTEGER", nullable: false),
+                    Name = table.Column<string>(type: "TEXT", nullable: true)
+                },
+                constraints: table =>
+                {
+                    table.PrimaryKey("PK_SkinInfo", x => x.ID);
+                });
+
+            migrationBuilder.CreateTable(
+                name: "SkinFileInfo",
+                columns: table => new
+                {
+                    ID = table.Column<int>(type: "INTEGER", nullable: false)
+                        .Annotation("Sqlite:Autoincrement", true),
+                    FileInfoID = table.Column<int>(type: "INTEGER", nullable: false),
+                    Filename = table.Column<string>(type: "TEXT", nullable: false),
+                    SkinInfoID = table.Column<int>(type: "INTEGER", nullable: false)
+                },
+                constraints: table =>
+                {
+                    table.PrimaryKey("PK_SkinFileInfo", x => x.ID);
+                    table.ForeignKey(
+                        name: "FK_SkinFileInfo_FileInfo_FileInfoID",
+                        column: x => x.FileInfoID,
+                        principalTable: "FileInfo",
+                        principalColumn: "ID",
+                        onDelete: ReferentialAction.Cascade);
+                    table.ForeignKey(
+                        name: "FK_SkinFileInfo_SkinInfo_SkinInfoID",
+                        column: x => x.SkinInfoID,
+                        principalTable: "SkinInfo",
+                        principalColumn: "ID",
+                        onDelete: ReferentialAction.Cascade);
+                });
+
+            migrationBuilder.CreateIndex(
+                name: "IX_SkinFileInfo_FileInfoID",
+                table: "SkinFileInfo",
+                column: "FileInfoID");
+
+            migrationBuilder.CreateIndex(
+                name: "IX_SkinFileInfo_SkinInfoID",
+                table: "SkinFileInfo",
+                column: "SkinInfoID");
+        }
+
+        protected override void Down(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.DropTable(
+                name: "SkinFileInfo");
+
+            migrationBuilder.DropTable(
+                name: "SkinInfo");
+        }
+    }
+}
diff --git a/osu.Game/Migrations/20180529055154_RemoveUniqueHashConstraints.Designer.cs b/osu.Game/Migrations/20180529055154_RemoveUniqueHashConstraints.Designer.cs
new file mode 100644
index 0000000000..f28408bfb3
--- /dev/null
+++ b/osu.Game/Migrations/20180529055154_RemoveUniqueHashConstraints.Designer.cs
@@ -0,0 +1,377 @@
+// <auto-generated />
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Infrastructure;
+using Microsoft.EntityFrameworkCore.Metadata;
+using Microsoft.EntityFrameworkCore.Migrations;
+using Microsoft.EntityFrameworkCore.Storage;
+using osu.Game.Database;
+using System;
+
+namespace osu.Game.Migrations
+{
+    [DbContext(typeof(OsuDbContext))]
+    [Migration("20180529055154_RemoveUniqueHashConstraints")]
+    partial class RemoveUniqueHashConstraints
+    {
+        protected override void BuildTargetModel(ModelBuilder modelBuilder)
+        {
+#pragma warning disable 612, 618
+            modelBuilder
+                .HasAnnotation("ProductVersion", "2.0.3-rtm-10026");
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapDifficulty", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<float>("ApproachRate");
+
+                    b.Property<float>("CircleSize");
+
+                    b.Property<float>("DrainRate");
+
+                    b.Property<float>("OverallDifficulty");
+
+                    b.Property<double>("SliderMultiplier");
+
+                    b.Property<double>("SliderTickRate");
+
+                    b.HasKey("ID");
+
+                    b.ToTable("BeatmapDifficulty");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("AudioLeadIn");
+
+                    b.Property<int>("BaseDifficultyID");
+
+                    b.Property<int>("BeatDivisor");
+
+                    b.Property<int>("BeatmapSetInfoID");
+
+                    b.Property<bool>("Countdown");
+
+                    b.Property<double>("DistanceSpacing");
+
+                    b.Property<int>("GridSize");
+
+                    b.Property<string>("Hash");
+
+                    b.Property<bool>("Hidden");
+
+                    b.Property<bool>("LetterboxInBreaks");
+
+                    b.Property<string>("MD5Hash");
+
+                    b.Property<int?>("MetadataID");
+
+                    b.Property<int?>("OnlineBeatmapID");
+
+                    b.Property<string>("Path");
+
+                    b.Property<int>("RulesetID");
+
+                    b.Property<bool>("SpecialStyle");
+
+                    b.Property<float>("StackLeniency");
+
+                    b.Property<double>("StarDifficulty");
+
+                    b.Property<string>("StoredBookmarks");
+
+                    b.Property<double>("TimelineZoom");
+
+                    b.Property<string>("Version");
+
+                    b.Property<bool>("WidescreenStoryboard");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("BaseDifficultyID");
+
+                    b.HasIndex("BeatmapSetInfoID");
+
+                    b.HasIndex("Hash");
+
+                    b.HasIndex("MD5Hash");
+
+                    b.HasIndex("MetadataID");
+
+                    b.HasIndex("OnlineBeatmapID")
+                        .IsUnique();
+
+                    b.HasIndex("RulesetID");
+
+                    b.ToTable("BeatmapInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapMetadata", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<string>("Artist");
+
+                    b.Property<string>("ArtistUnicode");
+
+                    b.Property<string>("AudioFile");
+
+                    b.Property<string>("AuthorString")
+                        .HasColumnName("Author");
+
+                    b.Property<string>("BackgroundFile");
+
+                    b.Property<int>("PreviewTime");
+
+                    b.Property<string>("Source");
+
+                    b.Property<string>("Tags");
+
+                    b.Property<string>("Title");
+
+                    b.Property<string>("TitleUnicode");
+
+                    b.HasKey("ID");
+
+                    b.ToTable("BeatmapMetadata");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("BeatmapSetInfoID");
+
+                    b.Property<int>("FileInfoID");
+
+                    b.Property<string>("Filename")
+                        .IsRequired();
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("BeatmapSetInfoID");
+
+                    b.HasIndex("FileInfoID");
+
+                    b.ToTable("BeatmapSetFileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<bool>("DeletePending");
+
+                    b.Property<string>("Hash");
+
+                    b.Property<int?>("MetadataID");
+
+                    b.Property<int?>("OnlineBeatmapSetID");
+
+                    b.Property<bool>("Protected");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("DeletePending");
+
+                    b.HasIndex("Hash")
+                        .IsUnique();
+
+                    b.HasIndex("MetadataID");
+
+                    b.HasIndex("OnlineBeatmapSetID")
+                        .IsUnique();
+
+                    b.ToTable("BeatmapSetInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Configuration.DatabasedSetting", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("IntKey")
+                        .HasColumnName("Key");
+
+                    b.Property<int?>("RulesetID");
+
+                    b.Property<string>("StringValue")
+                        .HasColumnName("Value");
+
+                    b.Property<int?>("Variant");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("RulesetID", "Variant");
+
+                    b.ToTable("Settings");
+                });
+
+            modelBuilder.Entity("osu.Game.Input.Bindings.DatabasedKeyBinding", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("IntAction")
+                        .HasColumnName("Action");
+
+                    b.Property<string>("KeysString")
+                        .HasColumnName("Keys");
+
+                    b.Property<int?>("RulesetID");
+
+                    b.Property<int?>("Variant");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("IntAction");
+
+                    b.HasIndex("RulesetID", "Variant");
+
+                    b.ToTable("KeyBinding");
+                });
+
+            modelBuilder.Entity("osu.Game.IO.FileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<string>("Hash");
+
+                    b.Property<int>("ReferenceCount");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("Hash")
+                        .IsUnique();
+
+                    b.HasIndex("ReferenceCount");
+
+                    b.ToTable("FileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Rulesets.RulesetInfo", b =>
+                {
+                    b.Property<int?>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<bool>("Available");
+
+                    b.Property<string>("InstantiationInfo");
+
+                    b.Property<string>("Name");
+
+                    b.Property<string>("ShortName");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("Available");
+
+                    b.HasIndex("ShortName")
+                        .IsUnique();
+
+                    b.ToTable("RulesetInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Skinning.SkinFileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("FileInfoID");
+
+                    b.Property<string>("Filename")
+                        .IsRequired();
+
+                    b.Property<int>("SkinInfoID");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("FileInfoID");
+
+                    b.HasIndex("SkinInfoID");
+
+                    b.ToTable("SkinFileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Skinning.SkinInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<string>("Creator");
+
+                    b.Property<bool>("DeletePending");
+
+                    b.Property<string>("Name");
+
+                    b.HasKey("ID");
+
+                    b.ToTable("SkinInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapDifficulty", "BaseDifficulty")
+                        .WithMany()
+                        .HasForeignKey("BaseDifficultyID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo", "BeatmapSet")
+                        .WithMany("Beatmaps")
+                        .HasForeignKey("BeatmapSetInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
+                        .WithMany("Beatmaps")
+                        .HasForeignKey("MetadataID");
+
+                    b.HasOne("osu.Game.Rulesets.RulesetInfo", "Ruleset")
+                        .WithMany()
+                        .HasForeignKey("RulesetID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo")
+                        .WithMany("Files")
+                        .HasForeignKey("BeatmapSetInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
+                        .WithMany()
+                        .HasForeignKey("FileInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
+                        .WithMany("BeatmapSets")
+                        .HasForeignKey("MetadataID");
+                });
+
+            modelBuilder.Entity("osu.Game.Skinning.SkinFileInfo", b =>
+                {
+                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
+                        .WithMany()
+                        .HasForeignKey("FileInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Skinning.SkinInfo")
+                        .WithMany("Files")
+                        .HasForeignKey("SkinInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+#pragma warning restore 612, 618
+        }
+    }
+}
diff --git a/osu.Game/Migrations/20180529055154_RemoveUniqueHashConstraints.cs b/osu.Game/Migrations/20180529055154_RemoveUniqueHashConstraints.cs
new file mode 100644
index 0000000000..27269cc5fc
--- /dev/null
+++ b/osu.Game/Migrations/20180529055154_RemoveUniqueHashConstraints.cs
@@ -0,0 +1,51 @@
+using Microsoft.EntityFrameworkCore.Migrations;
+
+namespace osu.Game.Migrations
+{
+    public partial class RemoveUniqueHashConstraints : Migration
+    {
+        protected override void Up(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.DropIndex(
+                name: "IX_BeatmapInfo_Hash",
+                table: "BeatmapInfo");
+
+            migrationBuilder.DropIndex(
+                name: "IX_BeatmapInfo_MD5Hash",
+                table: "BeatmapInfo");
+
+            migrationBuilder.CreateIndex(
+                name: "IX_BeatmapInfo_Hash",
+                table: "BeatmapInfo",
+                column: "Hash");
+
+            migrationBuilder.CreateIndex(
+                name: "IX_BeatmapInfo_MD5Hash",
+                table: "BeatmapInfo",
+                column: "MD5Hash");
+        }
+
+        protected override void Down(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.DropIndex(
+                name: "IX_BeatmapInfo_Hash",
+                table: "BeatmapInfo");
+
+            migrationBuilder.DropIndex(
+                name: "IX_BeatmapInfo_MD5Hash",
+                table: "BeatmapInfo");
+
+            migrationBuilder.CreateIndex(
+                name: "IX_BeatmapInfo_Hash",
+                table: "BeatmapInfo",
+                column: "Hash",
+                unique: true);
+
+            migrationBuilder.CreateIndex(
+                name: "IX_BeatmapInfo_MD5Hash",
+                table: "BeatmapInfo",
+                column: "MD5Hash",
+                unique: true);
+        }
+    }
+}
diff --git a/osu.Game/Migrations/20180621044111_UpdateTaikoDefaultBindings.Designer.cs b/osu.Game/Migrations/20180621044111_UpdateTaikoDefaultBindings.Designer.cs
new file mode 100644
index 0000000000..aaa11e88b6
--- /dev/null
+++ b/osu.Game/Migrations/20180621044111_UpdateTaikoDefaultBindings.Designer.cs
@@ -0,0 +1,376 @@
+// <auto-generated />
+using System;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Infrastructure;
+using Microsoft.EntityFrameworkCore.Migrations;
+using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
+using osu.Game.Database;
+
+namespace osu.Game.Migrations
+{
+    [DbContext(typeof(OsuDbContext))]
+    [Migration("20180621044111_UpdateTaikoDefaultBindings")]
+    partial class UpdateTaikoDefaultBindings
+    {
+        protected override void BuildTargetModel(ModelBuilder modelBuilder)
+        {
+#pragma warning disable 612, 618
+            modelBuilder
+                .HasAnnotation("ProductVersion", "2.1.1-rtm-30846");
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapDifficulty", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<float>("ApproachRate");
+
+                    b.Property<float>("CircleSize");
+
+                    b.Property<float>("DrainRate");
+
+                    b.Property<float>("OverallDifficulty");
+
+                    b.Property<double>("SliderMultiplier");
+
+                    b.Property<double>("SliderTickRate");
+
+                    b.HasKey("ID");
+
+                    b.ToTable("BeatmapDifficulty");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("AudioLeadIn");
+
+                    b.Property<int>("BaseDifficultyID");
+
+                    b.Property<int>("BeatDivisor");
+
+                    b.Property<int>("BeatmapSetInfoID");
+
+                    b.Property<bool>("Countdown");
+
+                    b.Property<double>("DistanceSpacing");
+
+                    b.Property<int>("GridSize");
+
+                    b.Property<string>("Hash");
+
+                    b.Property<bool>("Hidden");
+
+                    b.Property<bool>("LetterboxInBreaks");
+
+                    b.Property<string>("MD5Hash");
+
+                    b.Property<int?>("MetadataID");
+
+                    b.Property<int?>("OnlineBeatmapID");
+
+                    b.Property<string>("Path");
+
+                    b.Property<int>("RulesetID");
+
+                    b.Property<bool>("SpecialStyle");
+
+                    b.Property<float>("StackLeniency");
+
+                    b.Property<double>("StarDifficulty");
+
+                    b.Property<string>("StoredBookmarks");
+
+                    b.Property<double>("TimelineZoom");
+
+                    b.Property<string>("Version");
+
+                    b.Property<bool>("WidescreenStoryboard");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("BaseDifficultyID");
+
+                    b.HasIndex("BeatmapSetInfoID");
+
+                    b.HasIndex("Hash");
+
+                    b.HasIndex("MD5Hash");
+
+                    b.HasIndex("MetadataID");
+
+                    b.HasIndex("OnlineBeatmapID")
+                        .IsUnique();
+
+                    b.HasIndex("RulesetID");
+
+                    b.ToTable("BeatmapInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapMetadata", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<string>("Artist");
+
+                    b.Property<string>("ArtistUnicode");
+
+                    b.Property<string>("AudioFile");
+
+                    b.Property<string>("AuthorString")
+                        .HasColumnName("Author");
+
+                    b.Property<string>("BackgroundFile");
+
+                    b.Property<int>("PreviewTime");
+
+                    b.Property<string>("Source");
+
+                    b.Property<string>("Tags");
+
+                    b.Property<string>("Title");
+
+                    b.Property<string>("TitleUnicode");
+
+                    b.HasKey("ID");
+
+                    b.ToTable("BeatmapMetadata");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("BeatmapSetInfoID");
+
+                    b.Property<int>("FileInfoID");
+
+                    b.Property<string>("Filename")
+                        .IsRequired();
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("BeatmapSetInfoID");
+
+                    b.HasIndex("FileInfoID");
+
+                    b.ToTable("BeatmapSetFileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<bool>("DeletePending");
+
+                    b.Property<string>("Hash");
+
+                    b.Property<int?>("MetadataID");
+
+                    b.Property<int?>("OnlineBeatmapSetID");
+
+                    b.Property<bool>("Protected");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("DeletePending");
+
+                    b.HasIndex("Hash")
+                        .IsUnique();
+
+                    b.HasIndex("MetadataID");
+
+                    b.HasIndex("OnlineBeatmapSetID")
+                        .IsUnique();
+
+                    b.ToTable("BeatmapSetInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Configuration.DatabasedSetting", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("IntKey")
+                        .HasColumnName("Key");
+
+                    b.Property<int?>("RulesetID");
+
+                    b.Property<string>("StringValue")
+                        .HasColumnName("Value");
+
+                    b.Property<int?>("Variant");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("RulesetID", "Variant");
+
+                    b.ToTable("Settings");
+                });
+
+            modelBuilder.Entity("osu.Game.Input.Bindings.DatabasedKeyBinding", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("IntAction")
+                        .HasColumnName("Action");
+
+                    b.Property<string>("KeysString")
+                        .HasColumnName("Keys");
+
+                    b.Property<int?>("RulesetID");
+
+                    b.Property<int?>("Variant");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("IntAction");
+
+                    b.HasIndex("RulesetID", "Variant");
+
+                    b.ToTable("KeyBinding");
+                });
+
+            modelBuilder.Entity("osu.Game.IO.FileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<string>("Hash");
+
+                    b.Property<int>("ReferenceCount");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("Hash")
+                        .IsUnique();
+
+                    b.HasIndex("ReferenceCount");
+
+                    b.ToTable("FileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Rulesets.RulesetInfo", b =>
+                {
+                    b.Property<int?>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<bool>("Available");
+
+                    b.Property<string>("InstantiationInfo");
+
+                    b.Property<string>("Name");
+
+                    b.Property<string>("ShortName");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("Available");
+
+                    b.HasIndex("ShortName")
+                        .IsUnique();
+
+                    b.ToTable("RulesetInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Skinning.SkinFileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("FileInfoID");
+
+                    b.Property<string>("Filename")
+                        .IsRequired();
+
+                    b.Property<int>("SkinInfoID");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("FileInfoID");
+
+                    b.HasIndex("SkinInfoID");
+
+                    b.ToTable("SkinFileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Skinning.SkinInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<string>("Creator");
+
+                    b.Property<bool>("DeletePending");
+
+                    b.Property<string>("Name");
+
+                    b.HasKey("ID");
+
+                    b.ToTable("SkinInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapDifficulty", "BaseDifficulty")
+                        .WithMany()
+                        .HasForeignKey("BaseDifficultyID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo", "BeatmapSet")
+                        .WithMany("Beatmaps")
+                        .HasForeignKey("BeatmapSetInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
+                        .WithMany("Beatmaps")
+                        .HasForeignKey("MetadataID");
+
+                    b.HasOne("osu.Game.Rulesets.RulesetInfo", "Ruleset")
+                        .WithMany()
+                        .HasForeignKey("RulesetID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo")
+                        .WithMany("Files")
+                        .HasForeignKey("BeatmapSetInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
+                        .WithMany()
+                        .HasForeignKey("FileInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
+                        .WithMany("BeatmapSets")
+                        .HasForeignKey("MetadataID");
+                });
+
+            modelBuilder.Entity("osu.Game.Skinning.SkinFileInfo", b =>
+                {
+                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
+                        .WithMany()
+                        .HasForeignKey("FileInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Skinning.SkinInfo")
+                        .WithMany("Files")
+                        .HasForeignKey("SkinInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+#pragma warning restore 612, 618
+        }
+    }
+}
diff --git a/osu.Game/Migrations/20180621044111_UpdateTaikoDefaultBindings.cs b/osu.Game/Migrations/20180621044111_UpdateTaikoDefaultBindings.cs
new file mode 100644
index 0000000000..71304ea979
--- /dev/null
+++ b/osu.Game/Migrations/20180621044111_UpdateTaikoDefaultBindings.cs
@@ -0,0 +1,17 @@
+using Microsoft.EntityFrameworkCore.Migrations;
+
+namespace osu.Game.Migrations
+{
+    public partial class UpdateTaikoDefaultBindings : Migration
+    {
+        protected override void Up(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.Sql("DELETE FROM KeyBinding WHERE RulesetID = 1");
+        }
+
+        protected override void Down(MigrationBuilder migrationBuilder)
+        {
+            // we can't really tell if these should be restored or not, so let's just not do so.
+        }
+    }
+}
diff --git a/osu.Game/Migrations/20180628011956_RemoveNegativeSetIDs.Designer.cs b/osu.Game/Migrations/20180628011956_RemoveNegativeSetIDs.Designer.cs
new file mode 100644
index 0000000000..7eeacd56d7
--- /dev/null
+++ b/osu.Game/Migrations/20180628011956_RemoveNegativeSetIDs.Designer.cs
@@ -0,0 +1,376 @@
+// <auto-generated />
+using System;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Infrastructure;
+using Microsoft.EntityFrameworkCore.Migrations;
+using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
+using osu.Game.Database;
+
+namespace osu.Game.Migrations
+{
+    [DbContext(typeof(OsuDbContext))]
+    [Migration("20180628011956_RemoveNegativeSetIDs")]
+    partial class RemoveNegativeSetIDs
+    {
+        protected override void BuildTargetModel(ModelBuilder modelBuilder)
+        {
+#pragma warning disable 612, 618
+            modelBuilder
+                .HasAnnotation("ProductVersion", "2.1.1-rtm-30846");
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapDifficulty", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<float>("ApproachRate");
+
+                    b.Property<float>("CircleSize");
+
+                    b.Property<float>("DrainRate");
+
+                    b.Property<float>("OverallDifficulty");
+
+                    b.Property<double>("SliderMultiplier");
+
+                    b.Property<double>("SliderTickRate");
+
+                    b.HasKey("ID");
+
+                    b.ToTable("BeatmapDifficulty");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("AudioLeadIn");
+
+                    b.Property<int>("BaseDifficultyID");
+
+                    b.Property<int>("BeatDivisor");
+
+                    b.Property<int>("BeatmapSetInfoID");
+
+                    b.Property<bool>("Countdown");
+
+                    b.Property<double>("DistanceSpacing");
+
+                    b.Property<int>("GridSize");
+
+                    b.Property<string>("Hash");
+
+                    b.Property<bool>("Hidden");
+
+                    b.Property<bool>("LetterboxInBreaks");
+
+                    b.Property<string>("MD5Hash");
+
+                    b.Property<int?>("MetadataID");
+
+                    b.Property<int?>("OnlineBeatmapID");
+
+                    b.Property<string>("Path");
+
+                    b.Property<int>("RulesetID");
+
+                    b.Property<bool>("SpecialStyle");
+
+                    b.Property<float>("StackLeniency");
+
+                    b.Property<double>("StarDifficulty");
+
+                    b.Property<string>("StoredBookmarks");
+
+                    b.Property<double>("TimelineZoom");
+
+                    b.Property<string>("Version");
+
+                    b.Property<bool>("WidescreenStoryboard");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("BaseDifficultyID");
+
+                    b.HasIndex("BeatmapSetInfoID");
+
+                    b.HasIndex("Hash");
+
+                    b.HasIndex("MD5Hash");
+
+                    b.HasIndex("MetadataID");
+
+                    b.HasIndex("OnlineBeatmapID")
+                        .IsUnique();
+
+                    b.HasIndex("RulesetID");
+
+                    b.ToTable("BeatmapInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapMetadata", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<string>("Artist");
+
+                    b.Property<string>("ArtistUnicode");
+
+                    b.Property<string>("AudioFile");
+
+                    b.Property<string>("AuthorString")
+                        .HasColumnName("Author");
+
+                    b.Property<string>("BackgroundFile");
+
+                    b.Property<int>("PreviewTime");
+
+                    b.Property<string>("Source");
+
+                    b.Property<string>("Tags");
+
+                    b.Property<string>("Title");
+
+                    b.Property<string>("TitleUnicode");
+
+                    b.HasKey("ID");
+
+                    b.ToTable("BeatmapMetadata");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("BeatmapSetInfoID");
+
+                    b.Property<int>("FileInfoID");
+
+                    b.Property<string>("Filename")
+                        .IsRequired();
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("BeatmapSetInfoID");
+
+                    b.HasIndex("FileInfoID");
+
+                    b.ToTable("BeatmapSetFileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<bool>("DeletePending");
+
+                    b.Property<string>("Hash");
+
+                    b.Property<int?>("MetadataID");
+
+                    b.Property<int?>("OnlineBeatmapSetID");
+
+                    b.Property<bool>("Protected");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("DeletePending");
+
+                    b.HasIndex("Hash")
+                        .IsUnique();
+
+                    b.HasIndex("MetadataID");
+
+                    b.HasIndex("OnlineBeatmapSetID")
+                        .IsUnique();
+
+                    b.ToTable("BeatmapSetInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Configuration.DatabasedSetting", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("IntKey")
+                        .HasColumnName("Key");
+
+                    b.Property<int?>("RulesetID");
+
+                    b.Property<string>("StringValue")
+                        .HasColumnName("Value");
+
+                    b.Property<int?>("Variant");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("RulesetID", "Variant");
+
+                    b.ToTable("Settings");
+                });
+
+            modelBuilder.Entity("osu.Game.Input.Bindings.DatabasedKeyBinding", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("IntAction")
+                        .HasColumnName("Action");
+
+                    b.Property<string>("KeysString")
+                        .HasColumnName("Keys");
+
+                    b.Property<int?>("RulesetID");
+
+                    b.Property<int?>("Variant");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("IntAction");
+
+                    b.HasIndex("RulesetID", "Variant");
+
+                    b.ToTable("KeyBinding");
+                });
+
+            modelBuilder.Entity("osu.Game.IO.FileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<string>("Hash");
+
+                    b.Property<int>("ReferenceCount");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("Hash")
+                        .IsUnique();
+
+                    b.HasIndex("ReferenceCount");
+
+                    b.ToTable("FileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Rulesets.RulesetInfo", b =>
+                {
+                    b.Property<int?>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<bool>("Available");
+
+                    b.Property<string>("InstantiationInfo");
+
+                    b.Property<string>("Name");
+
+                    b.Property<string>("ShortName");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("Available");
+
+                    b.HasIndex("ShortName")
+                        .IsUnique();
+
+                    b.ToTable("RulesetInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Skinning.SkinFileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("FileInfoID");
+
+                    b.Property<string>("Filename")
+                        .IsRequired();
+
+                    b.Property<int>("SkinInfoID");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("FileInfoID");
+
+                    b.HasIndex("SkinInfoID");
+
+                    b.ToTable("SkinFileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Skinning.SkinInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<string>("Creator");
+
+                    b.Property<bool>("DeletePending");
+
+                    b.Property<string>("Name");
+
+                    b.HasKey("ID");
+
+                    b.ToTable("SkinInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapDifficulty", "BaseDifficulty")
+                        .WithMany()
+                        .HasForeignKey("BaseDifficultyID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo", "BeatmapSet")
+                        .WithMany("Beatmaps")
+                        .HasForeignKey("BeatmapSetInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
+                        .WithMany("Beatmaps")
+                        .HasForeignKey("MetadataID");
+
+                    b.HasOne("osu.Game.Rulesets.RulesetInfo", "Ruleset")
+                        .WithMany()
+                        .HasForeignKey("RulesetID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo")
+                        .WithMany("Files")
+                        .HasForeignKey("BeatmapSetInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
+                        .WithMany()
+                        .HasForeignKey("FileInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
+                        .WithMany("BeatmapSets")
+                        .HasForeignKey("MetadataID");
+                });
+
+            modelBuilder.Entity("osu.Game.Skinning.SkinFileInfo", b =>
+                {
+                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
+                        .WithMany()
+                        .HasForeignKey("FileInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Skinning.SkinInfo")
+                        .WithMany("Files")
+                        .HasForeignKey("SkinInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+#pragma warning restore 612, 618
+        }
+    }
+}
diff --git a/osu.Game/Migrations/20180628011956_RemoveNegativeSetIDs.cs b/osu.Game/Migrations/20180628011956_RemoveNegativeSetIDs.cs
new file mode 100644
index 0000000000..506d65f761
--- /dev/null
+++ b/osu.Game/Migrations/20180628011956_RemoveNegativeSetIDs.cs
@@ -0,0 +1,18 @@
+using Microsoft.EntityFrameworkCore.Migrations;
+
+namespace osu.Game.Migrations
+{
+    public partial class RemoveNegativeSetIDs : Migration
+    {
+        protected override void Up(MigrationBuilder migrationBuilder)
+        {
+            // There was a change that beatmaps were being loaded with "-1" online IDs, which is completely incorrect.
+            // This ensures there will not be unique key conflicts as a result of these incorrectly imported beatmaps.
+            migrationBuilder.Sql("UPDATE BeatmapSetInfo SET OnlineBeatmapSetID = null WHERE OnlineBeatmapSetID <= 0");
+        }
+
+        protected override void Down(MigrationBuilder migrationBuilder)
+        {
+        }
+    }
+}
diff --git a/osu.Game/Migrations/20180913080842_AddRankStatus.Designer.cs b/osu.Game/Migrations/20180913080842_AddRankStatus.Designer.cs
new file mode 100644
index 0000000000..5ab43da046
--- /dev/null
+++ b/osu.Game/Migrations/20180913080842_AddRankStatus.Designer.cs
@@ -0,0 +1,380 @@
+// <auto-generated />
+using System;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Infrastructure;
+using Microsoft.EntityFrameworkCore.Migrations;
+using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
+using osu.Game.Database;
+
+namespace osu.Game.Migrations
+{
+    [DbContext(typeof(OsuDbContext))]
+    [Migration("20180913080842_AddRankStatus")]
+    partial class AddRankStatus
+    {
+        protected override void BuildTargetModel(ModelBuilder modelBuilder)
+        {
+#pragma warning disable 612, 618
+            modelBuilder
+                .HasAnnotation("ProductVersion", "2.1.2-rtm-30932");
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapDifficulty", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<float>("ApproachRate");
+
+                    b.Property<float>("CircleSize");
+
+                    b.Property<float>("DrainRate");
+
+                    b.Property<float>("OverallDifficulty");
+
+                    b.Property<double>("SliderMultiplier");
+
+                    b.Property<double>("SliderTickRate");
+
+                    b.HasKey("ID");
+
+                    b.ToTable("BeatmapDifficulty");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("AudioLeadIn");
+
+                    b.Property<int>("BaseDifficultyID");
+
+                    b.Property<int>("BeatDivisor");
+
+                    b.Property<int>("BeatmapSetInfoID");
+
+                    b.Property<bool>("Countdown");
+
+                    b.Property<double>("DistanceSpacing");
+
+                    b.Property<int>("GridSize");
+
+                    b.Property<string>("Hash");
+
+                    b.Property<bool>("Hidden");
+
+                    b.Property<bool>("LetterboxInBreaks");
+
+                    b.Property<string>("MD5Hash");
+
+                    b.Property<int?>("MetadataID");
+
+                    b.Property<int?>("OnlineBeatmapID");
+
+                    b.Property<string>("Path");
+
+                    b.Property<int>("RulesetID");
+
+                    b.Property<bool>("SpecialStyle");
+
+                    b.Property<float>("StackLeniency");
+
+                    b.Property<double>("StarDifficulty");
+
+                    b.Property<int>("Status");
+
+                    b.Property<string>("StoredBookmarks");
+
+                    b.Property<double>("TimelineZoom");
+
+                    b.Property<string>("Version");
+
+                    b.Property<bool>("WidescreenStoryboard");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("BaseDifficultyID");
+
+                    b.HasIndex("BeatmapSetInfoID");
+
+                    b.HasIndex("Hash");
+
+                    b.HasIndex("MD5Hash");
+
+                    b.HasIndex("MetadataID");
+
+                    b.HasIndex("OnlineBeatmapID")
+                        .IsUnique();
+
+                    b.HasIndex("RulesetID");
+
+                    b.ToTable("BeatmapInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapMetadata", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<string>("Artist");
+
+                    b.Property<string>("ArtistUnicode");
+
+                    b.Property<string>("AudioFile");
+
+                    b.Property<string>("AuthorString")
+                        .HasColumnName("Author");
+
+                    b.Property<string>("BackgroundFile");
+
+                    b.Property<int>("PreviewTime");
+
+                    b.Property<string>("Source");
+
+                    b.Property<string>("Tags");
+
+                    b.Property<string>("Title");
+
+                    b.Property<string>("TitleUnicode");
+
+                    b.HasKey("ID");
+
+                    b.ToTable("BeatmapMetadata");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("BeatmapSetInfoID");
+
+                    b.Property<int>("FileInfoID");
+
+                    b.Property<string>("Filename")
+                        .IsRequired();
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("BeatmapSetInfoID");
+
+                    b.HasIndex("FileInfoID");
+
+                    b.ToTable("BeatmapSetFileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<bool>("DeletePending");
+
+                    b.Property<string>("Hash");
+
+                    b.Property<int?>("MetadataID");
+
+                    b.Property<int?>("OnlineBeatmapSetID");
+
+                    b.Property<bool>("Protected");
+
+                    b.Property<int>("Status");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("DeletePending");
+
+                    b.HasIndex("Hash")
+                        .IsUnique();
+
+                    b.HasIndex("MetadataID");
+
+                    b.HasIndex("OnlineBeatmapSetID")
+                        .IsUnique();
+
+                    b.ToTable("BeatmapSetInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Configuration.DatabasedSetting", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("IntKey")
+                        .HasColumnName("Key");
+
+                    b.Property<int?>("RulesetID");
+
+                    b.Property<string>("StringValue")
+                        .HasColumnName("Value");
+
+                    b.Property<int?>("Variant");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("RulesetID", "Variant");
+
+                    b.ToTable("Settings");
+                });
+
+            modelBuilder.Entity("osu.Game.Input.Bindings.DatabasedKeyBinding", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("IntAction")
+                        .HasColumnName("Action");
+
+                    b.Property<string>("KeysString")
+                        .HasColumnName("Keys");
+
+                    b.Property<int?>("RulesetID");
+
+                    b.Property<int?>("Variant");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("IntAction");
+
+                    b.HasIndex("RulesetID", "Variant");
+
+                    b.ToTable("KeyBinding");
+                });
+
+            modelBuilder.Entity("osu.Game.IO.FileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<string>("Hash");
+
+                    b.Property<int>("ReferenceCount");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("Hash")
+                        .IsUnique();
+
+                    b.HasIndex("ReferenceCount");
+
+                    b.ToTable("FileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Rulesets.RulesetInfo", b =>
+                {
+                    b.Property<int?>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<bool>("Available");
+
+                    b.Property<string>("InstantiationInfo");
+
+                    b.Property<string>("Name");
+
+                    b.Property<string>("ShortName");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("Available");
+
+                    b.HasIndex("ShortName")
+                        .IsUnique();
+
+                    b.ToTable("RulesetInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Skinning.SkinFileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("FileInfoID");
+
+                    b.Property<string>("Filename")
+                        .IsRequired();
+
+                    b.Property<int>("SkinInfoID");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("FileInfoID");
+
+                    b.HasIndex("SkinInfoID");
+
+                    b.ToTable("SkinFileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Skinning.SkinInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<string>("Creator");
+
+                    b.Property<bool>("DeletePending");
+
+                    b.Property<string>("Name");
+
+                    b.HasKey("ID");
+
+                    b.ToTable("SkinInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapDifficulty", "BaseDifficulty")
+                        .WithMany()
+                        .HasForeignKey("BaseDifficultyID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo", "BeatmapSet")
+                        .WithMany("Beatmaps")
+                        .HasForeignKey("BeatmapSetInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
+                        .WithMany("Beatmaps")
+                        .HasForeignKey("MetadataID");
+
+                    b.HasOne("osu.Game.Rulesets.RulesetInfo", "Ruleset")
+                        .WithMany()
+                        .HasForeignKey("RulesetID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo")
+                        .WithMany("Files")
+                        .HasForeignKey("BeatmapSetInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
+                        .WithMany()
+                        .HasForeignKey("FileInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
+                        .WithMany("BeatmapSets")
+                        .HasForeignKey("MetadataID");
+                });
+
+            modelBuilder.Entity("osu.Game.Skinning.SkinFileInfo", b =>
+                {
+                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
+                        .WithMany()
+                        .HasForeignKey("FileInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Skinning.SkinInfo")
+                        .WithMany("Files")
+                        .HasForeignKey("SkinInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+#pragma warning restore 612, 618
+        }
+    }
+}
diff --git a/osu.Game/Migrations/20180913080842_AddRankStatus.cs b/osu.Game/Migrations/20180913080842_AddRankStatus.cs
new file mode 100644
index 0000000000..bba4944bb7
--- /dev/null
+++ b/osu.Game/Migrations/20180913080842_AddRankStatus.cs
@@ -0,0 +1,33 @@
+using Microsoft.EntityFrameworkCore.Migrations;
+
+namespace osu.Game.Migrations
+{
+    public partial class AddRankStatus : Migration
+    {
+        protected override void Up(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.AddColumn<int>(
+                name: "Status",
+                table: "BeatmapSetInfo",
+                nullable: false,
+                defaultValue: -3); // NONE
+
+            migrationBuilder.AddColumn<int>(
+                name: "Status",
+                table: "BeatmapInfo",
+                nullable: false,
+                defaultValue: -3); // NONE
+        }
+
+        protected override void Down(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.DropColumn(
+                name: "Status",
+                table: "BeatmapSetInfo");
+
+            migrationBuilder.DropColumn(
+                name: "Status",
+                table: "BeatmapInfo");
+        }
+    }
+}
diff --git a/osu.Game/Migrations/20181007180454_StandardizePaths.Designer.cs b/osu.Game/Migrations/20181007180454_StandardizePaths.Designer.cs
new file mode 100644
index 0000000000..b387a45ecf
--- /dev/null
+++ b/osu.Game/Migrations/20181007180454_StandardizePaths.Designer.cs
@@ -0,0 +1,380 @@
+// <auto-generated />
+using System;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Infrastructure;
+using Microsoft.EntityFrameworkCore.Migrations;
+using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
+using osu.Game.Database;
+
+namespace osu.Game.Migrations
+{
+    [DbContext(typeof(OsuDbContext))]
+    [Migration("20181007180454_StandardizePaths")]
+    partial class StandardizePaths
+    {
+        protected override void BuildTargetModel(ModelBuilder modelBuilder)
+        {
+#pragma warning disable 612, 618
+            modelBuilder
+                .HasAnnotation("ProductVersion", "2.1.3-rtm-32065");
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapDifficulty", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<float>("ApproachRate");
+
+                    b.Property<float>("CircleSize");
+
+                    b.Property<float>("DrainRate");
+
+                    b.Property<float>("OverallDifficulty");
+
+                    b.Property<double>("SliderMultiplier");
+
+                    b.Property<double>("SliderTickRate");
+
+                    b.HasKey("ID");
+
+                    b.ToTable("BeatmapDifficulty");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("AudioLeadIn");
+
+                    b.Property<int>("BaseDifficultyID");
+
+                    b.Property<int>("BeatDivisor");
+
+                    b.Property<int>("BeatmapSetInfoID");
+
+                    b.Property<bool>("Countdown");
+
+                    b.Property<double>("DistanceSpacing");
+
+                    b.Property<int>("GridSize");
+
+                    b.Property<string>("Hash");
+
+                    b.Property<bool>("Hidden");
+
+                    b.Property<bool>("LetterboxInBreaks");
+
+                    b.Property<string>("MD5Hash");
+
+                    b.Property<int?>("MetadataID");
+
+                    b.Property<int?>("OnlineBeatmapID");
+
+                    b.Property<string>("Path");
+
+                    b.Property<int>("RulesetID");
+
+                    b.Property<bool>("SpecialStyle");
+
+                    b.Property<float>("StackLeniency");
+
+                    b.Property<double>("StarDifficulty");
+
+                    b.Property<int>("Status");
+
+                    b.Property<string>("StoredBookmarks");
+
+                    b.Property<double>("TimelineZoom");
+
+                    b.Property<string>("Version");
+
+                    b.Property<bool>("WidescreenStoryboard");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("BaseDifficultyID");
+
+                    b.HasIndex("BeatmapSetInfoID");
+
+                    b.HasIndex("Hash");
+
+                    b.HasIndex("MD5Hash");
+
+                    b.HasIndex("MetadataID");
+
+                    b.HasIndex("OnlineBeatmapID")
+                        .IsUnique();
+
+                    b.HasIndex("RulesetID");
+
+                    b.ToTable("BeatmapInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapMetadata", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<string>("Artist");
+
+                    b.Property<string>("ArtistUnicode");
+
+                    b.Property<string>("AudioFile");
+
+                    b.Property<string>("AuthorString")
+                        .HasColumnName("Author");
+
+                    b.Property<string>("BackgroundFile");
+
+                    b.Property<int>("PreviewTime");
+
+                    b.Property<string>("Source");
+
+                    b.Property<string>("Tags");
+
+                    b.Property<string>("Title");
+
+                    b.Property<string>("TitleUnicode");
+
+                    b.HasKey("ID");
+
+                    b.ToTable("BeatmapMetadata");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("BeatmapSetInfoID");
+
+                    b.Property<int>("FileInfoID");
+
+                    b.Property<string>("Filename")
+                        .IsRequired();
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("BeatmapSetInfoID");
+
+                    b.HasIndex("FileInfoID");
+
+                    b.ToTable("BeatmapSetFileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<bool>("DeletePending");
+
+                    b.Property<string>("Hash");
+
+                    b.Property<int?>("MetadataID");
+
+                    b.Property<int?>("OnlineBeatmapSetID");
+
+                    b.Property<bool>("Protected");
+
+                    b.Property<int>("Status");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("DeletePending");
+
+                    b.HasIndex("Hash")
+                        .IsUnique();
+
+                    b.HasIndex("MetadataID");
+
+                    b.HasIndex("OnlineBeatmapSetID")
+                        .IsUnique();
+
+                    b.ToTable("BeatmapSetInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Configuration.DatabasedSetting", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("IntKey")
+                        .HasColumnName("Key");
+
+                    b.Property<int?>("RulesetID");
+
+                    b.Property<string>("StringValue")
+                        .HasColumnName("Value");
+
+                    b.Property<int?>("Variant");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("RulesetID", "Variant");
+
+                    b.ToTable("Settings");
+                });
+
+            modelBuilder.Entity("osu.Game.Input.Bindings.DatabasedKeyBinding", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("IntAction")
+                        .HasColumnName("Action");
+
+                    b.Property<string>("KeysString")
+                        .HasColumnName("Keys");
+
+                    b.Property<int?>("RulesetID");
+
+                    b.Property<int?>("Variant");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("IntAction");
+
+                    b.HasIndex("RulesetID", "Variant");
+
+                    b.ToTable("KeyBinding");
+                });
+
+            modelBuilder.Entity("osu.Game.IO.FileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<string>("Hash");
+
+                    b.Property<int>("ReferenceCount");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("Hash")
+                        .IsUnique();
+
+                    b.HasIndex("ReferenceCount");
+
+                    b.ToTable("FileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Rulesets.RulesetInfo", b =>
+                {
+                    b.Property<int?>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<bool>("Available");
+
+                    b.Property<string>("InstantiationInfo");
+
+                    b.Property<string>("Name");
+
+                    b.Property<string>("ShortName");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("Available");
+
+                    b.HasIndex("ShortName")
+                        .IsUnique();
+
+                    b.ToTable("RulesetInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Skinning.SkinFileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("FileInfoID");
+
+                    b.Property<string>("Filename")
+                        .IsRequired();
+
+                    b.Property<int>("SkinInfoID");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("FileInfoID");
+
+                    b.HasIndex("SkinInfoID");
+
+                    b.ToTable("SkinFileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Skinning.SkinInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<string>("Creator");
+
+                    b.Property<bool>("DeletePending");
+
+                    b.Property<string>("Name");
+
+                    b.HasKey("ID");
+
+                    b.ToTable("SkinInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapDifficulty", "BaseDifficulty")
+                        .WithMany()
+                        .HasForeignKey("BaseDifficultyID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo", "BeatmapSet")
+                        .WithMany("Beatmaps")
+                        .HasForeignKey("BeatmapSetInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
+                        .WithMany("Beatmaps")
+                        .HasForeignKey("MetadataID");
+
+                    b.HasOne("osu.Game.Rulesets.RulesetInfo", "Ruleset")
+                        .WithMany()
+                        .HasForeignKey("RulesetID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo")
+                        .WithMany("Files")
+                        .HasForeignKey("BeatmapSetInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
+                        .WithMany()
+                        .HasForeignKey("FileInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
+                        .WithMany("BeatmapSets")
+                        .HasForeignKey("MetadataID");
+                });
+
+            modelBuilder.Entity("osu.Game.Skinning.SkinFileInfo", b =>
+                {
+                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
+                        .WithMany()
+                        .HasForeignKey("FileInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Skinning.SkinInfo")
+                        .WithMany("Files")
+                        .HasForeignKey("SkinInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+#pragma warning restore 612, 618
+        }
+    }
+}
diff --git a/osu.Game/Migrations/20181007180454_StandardizePaths.cs b/osu.Game/Migrations/20181007180454_StandardizePaths.cs
new file mode 100644
index 0000000000..274b8030a9
--- /dev/null
+++ b/osu.Game/Migrations/20181007180454_StandardizePaths.cs
@@ -0,0 +1,26 @@
+using System;
+using Microsoft.EntityFrameworkCore.Migrations;
+using System.IO;
+
+namespace osu.Game.Migrations
+{
+    public partial class StandardizePaths : Migration
+    {
+        protected override void Up(MigrationBuilder migrationBuilder)
+        {
+            string windowsStyle = @"\";
+            string standardized = "/";
+
+            // Escaping \ does not seem to be needed.
+            migrationBuilder.Sql($"UPDATE `BeatmapInfo` SET `Path` = REPLACE(`Path`, '{windowsStyle}', '{standardized}')");
+            migrationBuilder.Sql($"UPDATE `BeatmapMetadata` SET `AudioFile` = REPLACE(`AudioFile`, '{windowsStyle}', '{standardized}')");
+            migrationBuilder.Sql($"UPDATE `BeatmapMetadata` SET `BackgroundFile` = REPLACE(`BackgroundFile`, '{windowsStyle}', '{standardized}')");
+            migrationBuilder.Sql($"UPDATE `BeatmapSetFileInfo` SET `Filename` = REPLACE(`Filename`, '{windowsStyle}', '{standardized}')");
+            migrationBuilder.Sql($"UPDATE `SkinFileInfo` SET `Filename` = REPLACE(`Filename`, '{windowsStyle}', '{standardized}')");
+        }
+
+        protected override void Down(MigrationBuilder migrationBuilder)
+        {
+        }
+    }
+}
diff --git a/osu.Game/Migrations/20181128100659_AddSkinInfoHash.Designer.cs b/osu.Game/Migrations/20181128100659_AddSkinInfoHash.Designer.cs
new file mode 100644
index 0000000000..120674671a
--- /dev/null
+++ b/osu.Game/Migrations/20181128100659_AddSkinInfoHash.Designer.cs
@@ -0,0 +1,387 @@
+// <auto-generated />
+using System;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Infrastructure;
+using Microsoft.EntityFrameworkCore.Migrations;
+using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
+using osu.Game.Database;
+
+namespace osu.Game.Migrations
+{
+    [DbContext(typeof(OsuDbContext))]
+    [Migration("20181128100659_AddSkinInfoHash")]
+    partial class AddSkinInfoHash
+    {
+        protected override void BuildTargetModel(ModelBuilder modelBuilder)
+        {
+#pragma warning disable 612, 618
+            modelBuilder
+                .HasAnnotation("ProductVersion", "2.1.4-rtm-31024");
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapDifficulty", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<float>("ApproachRate");
+
+                    b.Property<float>("CircleSize");
+
+                    b.Property<float>("DrainRate");
+
+                    b.Property<float>("OverallDifficulty");
+
+                    b.Property<double>("SliderMultiplier");
+
+                    b.Property<double>("SliderTickRate");
+
+                    b.HasKey("ID");
+
+                    b.ToTable("BeatmapDifficulty");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("AudioLeadIn");
+
+                    b.Property<int>("BaseDifficultyID");
+
+                    b.Property<int>("BeatDivisor");
+
+                    b.Property<int>("BeatmapSetInfoID");
+
+                    b.Property<bool>("Countdown");
+
+                    b.Property<double>("DistanceSpacing");
+
+                    b.Property<int>("GridSize");
+
+                    b.Property<string>("Hash");
+
+                    b.Property<bool>("Hidden");
+
+                    b.Property<bool>("LetterboxInBreaks");
+
+                    b.Property<string>("MD5Hash");
+
+                    b.Property<int?>("MetadataID");
+
+                    b.Property<int?>("OnlineBeatmapID");
+
+                    b.Property<string>("Path");
+
+                    b.Property<int>("RulesetID");
+
+                    b.Property<bool>("SpecialStyle");
+
+                    b.Property<float>("StackLeniency");
+
+                    b.Property<double>("StarDifficulty");
+
+                    b.Property<int>("Status");
+
+                    b.Property<string>("StoredBookmarks");
+
+                    b.Property<double>("TimelineZoom");
+
+                    b.Property<string>("Version");
+
+                    b.Property<bool>("WidescreenStoryboard");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("BaseDifficultyID");
+
+                    b.HasIndex("BeatmapSetInfoID");
+
+                    b.HasIndex("Hash");
+
+                    b.HasIndex("MD5Hash");
+
+                    b.HasIndex("MetadataID");
+
+                    b.HasIndex("OnlineBeatmapID")
+                        .IsUnique();
+
+                    b.HasIndex("RulesetID");
+
+                    b.ToTable("BeatmapInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapMetadata", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<string>("Artist");
+
+                    b.Property<string>("ArtistUnicode");
+
+                    b.Property<string>("AudioFile");
+
+                    b.Property<string>("AuthorString")
+                        .HasColumnName("Author");
+
+                    b.Property<string>("BackgroundFile");
+
+                    b.Property<int>("PreviewTime");
+
+                    b.Property<string>("Source");
+
+                    b.Property<string>("Tags");
+
+                    b.Property<string>("Title");
+
+                    b.Property<string>("TitleUnicode");
+
+                    b.HasKey("ID");
+
+                    b.ToTable("BeatmapMetadata");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("BeatmapSetInfoID");
+
+                    b.Property<int>("FileInfoID");
+
+                    b.Property<string>("Filename")
+                        .IsRequired();
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("BeatmapSetInfoID");
+
+                    b.HasIndex("FileInfoID");
+
+                    b.ToTable("BeatmapSetFileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<bool>("DeletePending");
+
+                    b.Property<string>("Hash");
+
+                    b.Property<int?>("MetadataID");
+
+                    b.Property<int?>("OnlineBeatmapSetID");
+
+                    b.Property<bool>("Protected");
+
+                    b.Property<int>("Status");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("DeletePending");
+
+                    b.HasIndex("Hash")
+                        .IsUnique();
+
+                    b.HasIndex("MetadataID");
+
+                    b.HasIndex("OnlineBeatmapSetID")
+                        .IsUnique();
+
+                    b.ToTable("BeatmapSetInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Configuration.DatabasedSetting", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("IntKey")
+                        .HasColumnName("Key");
+
+                    b.Property<int?>("RulesetID");
+
+                    b.Property<string>("StringValue")
+                        .HasColumnName("Value");
+
+                    b.Property<int?>("Variant");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("RulesetID", "Variant");
+
+                    b.ToTable("Settings");
+                });
+
+            modelBuilder.Entity("osu.Game.Input.Bindings.DatabasedKeyBinding", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("IntAction")
+                        .HasColumnName("Action");
+
+                    b.Property<string>("KeysString")
+                        .HasColumnName("Keys");
+
+                    b.Property<int?>("RulesetID");
+
+                    b.Property<int?>("Variant");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("IntAction");
+
+                    b.HasIndex("RulesetID", "Variant");
+
+                    b.ToTable("KeyBinding");
+                });
+
+            modelBuilder.Entity("osu.Game.IO.FileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<string>("Hash");
+
+                    b.Property<int>("ReferenceCount");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("Hash")
+                        .IsUnique();
+
+                    b.HasIndex("ReferenceCount");
+
+                    b.ToTable("FileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Rulesets.RulesetInfo", b =>
+                {
+                    b.Property<int?>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<bool>("Available");
+
+                    b.Property<string>("InstantiationInfo");
+
+                    b.Property<string>("Name");
+
+                    b.Property<string>("ShortName");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("Available");
+
+                    b.HasIndex("ShortName")
+                        .IsUnique();
+
+                    b.ToTable("RulesetInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Skinning.SkinFileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("FileInfoID");
+
+                    b.Property<string>("Filename")
+                        .IsRequired();
+
+                    b.Property<int>("SkinInfoID");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("FileInfoID");
+
+                    b.HasIndex("SkinInfoID");
+
+                    b.ToTable("SkinFileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Skinning.SkinInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<string>("Creator");
+
+                    b.Property<bool>("DeletePending");
+
+                    b.Property<string>("Hash");
+
+                    b.Property<string>("Name");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("DeletePending");
+
+                    b.HasIndex("Hash")
+                        .IsUnique();
+
+                    b.ToTable("SkinInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapDifficulty", "BaseDifficulty")
+                        .WithMany()
+                        .HasForeignKey("BaseDifficultyID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo", "BeatmapSet")
+                        .WithMany("Beatmaps")
+                        .HasForeignKey("BeatmapSetInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
+                        .WithMany("Beatmaps")
+                        .HasForeignKey("MetadataID");
+
+                    b.HasOne("osu.Game.Rulesets.RulesetInfo", "Ruleset")
+                        .WithMany()
+                        .HasForeignKey("RulesetID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo")
+                        .WithMany("Files")
+                        .HasForeignKey("BeatmapSetInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
+                        .WithMany()
+                        .HasForeignKey("FileInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
+                        .WithMany("BeatmapSets")
+                        .HasForeignKey("MetadataID");
+                });
+
+            modelBuilder.Entity("osu.Game.Skinning.SkinFileInfo", b =>
+                {
+                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
+                        .WithMany()
+                        .HasForeignKey("FileInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Skinning.SkinInfo")
+                        .WithMany("Files")
+                        .HasForeignKey("SkinInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+#pragma warning restore 612, 618
+        }
+    }
+}
diff --git a/osu.Game/Migrations/20181128100659_AddSkinInfoHash.cs b/osu.Game/Migrations/20181128100659_AddSkinInfoHash.cs
new file mode 100644
index 0000000000..860264a7dd
--- /dev/null
+++ b/osu.Game/Migrations/20181128100659_AddSkinInfoHash.cs
@@ -0,0 +1,41 @@
+using Microsoft.EntityFrameworkCore.Migrations;
+
+namespace osu.Game.Migrations
+{
+    public partial class AddSkinInfoHash : Migration
+    {
+        protected override void Up(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.AddColumn<string>(
+                name: "Hash",
+                table: "SkinInfo",
+                nullable: true);
+
+            migrationBuilder.CreateIndex(
+                name: "IX_SkinInfo_DeletePending",
+                table: "SkinInfo",
+                column: "DeletePending");
+
+            migrationBuilder.CreateIndex(
+                name: "IX_SkinInfo_Hash",
+                table: "SkinInfo",
+                column: "Hash",
+                unique: true);
+        }
+
+        protected override void Down(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.DropIndex(
+                name: "IX_SkinInfo_DeletePending",
+                table: "SkinInfo");
+
+            migrationBuilder.DropIndex(
+                name: "IX_SkinInfo_Hash",
+                table: "SkinInfo");
+
+            migrationBuilder.DropColumn(
+                name: "Hash",
+                table: "SkinInfo");
+        }
+    }
+}
diff --git a/osu.Game/Migrations/20181130113755_AddScoreInfoTables.Designer.cs b/osu.Game/Migrations/20181130113755_AddScoreInfoTables.Designer.cs
new file mode 100644
index 0000000000..eee53182ce
--- /dev/null
+++ b/osu.Game/Migrations/20181130113755_AddScoreInfoTables.Designer.cs
@@ -0,0 +1,484 @@
+// <auto-generated />
+using System;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Infrastructure;
+using Microsoft.EntityFrameworkCore.Migrations;
+using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
+using osu.Game.Database;
+
+namespace osu.Game.Migrations
+{
+    [DbContext(typeof(OsuDbContext))]
+    [Migration("20181130113755_AddScoreInfoTables")]
+    partial class AddScoreInfoTables
+    {
+        protected override void BuildTargetModel(ModelBuilder modelBuilder)
+        {
+#pragma warning disable 612, 618
+            modelBuilder
+                .HasAnnotation("ProductVersion", "2.1.4-rtm-31024");
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapDifficulty", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<float>("ApproachRate");
+
+                    b.Property<float>("CircleSize");
+
+                    b.Property<float>("DrainRate");
+
+                    b.Property<float>("OverallDifficulty");
+
+                    b.Property<double>("SliderMultiplier");
+
+                    b.Property<double>("SliderTickRate");
+
+                    b.HasKey("ID");
+
+                    b.ToTable("BeatmapDifficulty");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("AudioLeadIn");
+
+                    b.Property<int>("BaseDifficultyID");
+
+                    b.Property<int>("BeatDivisor");
+
+                    b.Property<int>("BeatmapSetInfoID");
+
+                    b.Property<bool>("Countdown");
+
+                    b.Property<double>("DistanceSpacing");
+
+                    b.Property<int>("GridSize");
+
+                    b.Property<string>("Hash");
+
+                    b.Property<bool>("Hidden");
+
+                    b.Property<bool>("LetterboxInBreaks");
+
+                    b.Property<string>("MD5Hash");
+
+                    b.Property<int?>("MetadataID");
+
+                    b.Property<int?>("OnlineBeatmapID");
+
+                    b.Property<string>("Path");
+
+                    b.Property<int>("RulesetID");
+
+                    b.Property<bool>("SpecialStyle");
+
+                    b.Property<float>("StackLeniency");
+
+                    b.Property<double>("StarDifficulty");
+
+                    b.Property<int>("Status");
+
+                    b.Property<string>("StoredBookmarks");
+
+                    b.Property<double>("TimelineZoom");
+
+                    b.Property<string>("Version");
+
+                    b.Property<bool>("WidescreenStoryboard");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("BaseDifficultyID");
+
+                    b.HasIndex("BeatmapSetInfoID");
+
+                    b.HasIndex("Hash");
+
+                    b.HasIndex("MD5Hash");
+
+                    b.HasIndex("MetadataID");
+
+                    b.HasIndex("OnlineBeatmapID")
+                        .IsUnique();
+
+                    b.HasIndex("RulesetID");
+
+                    b.ToTable("BeatmapInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapMetadata", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<string>("Artist");
+
+                    b.Property<string>("ArtistUnicode");
+
+                    b.Property<string>("AudioFile");
+
+                    b.Property<string>("AuthorString")
+                        .HasColumnName("Author");
+
+                    b.Property<string>("BackgroundFile");
+
+                    b.Property<int>("PreviewTime");
+
+                    b.Property<string>("Source");
+
+                    b.Property<string>("Tags");
+
+                    b.Property<string>("Title");
+
+                    b.Property<string>("TitleUnicode");
+
+                    b.HasKey("ID");
+
+                    b.ToTable("BeatmapMetadata");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("BeatmapSetInfoID");
+
+                    b.Property<int>("FileInfoID");
+
+                    b.Property<string>("Filename")
+                        .IsRequired();
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("BeatmapSetInfoID");
+
+                    b.HasIndex("FileInfoID");
+
+                    b.ToTable("BeatmapSetFileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<bool>("DeletePending");
+
+                    b.Property<string>("Hash");
+
+                    b.Property<int?>("MetadataID");
+
+                    b.Property<int?>("OnlineBeatmapSetID");
+
+                    b.Property<bool>("Protected");
+
+                    b.Property<int>("Status");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("DeletePending");
+
+                    b.HasIndex("Hash")
+                        .IsUnique();
+
+                    b.HasIndex("MetadataID");
+
+                    b.HasIndex("OnlineBeatmapSetID")
+                        .IsUnique();
+
+                    b.ToTable("BeatmapSetInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Configuration.DatabasedSetting", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("IntKey")
+                        .HasColumnName("Key");
+
+                    b.Property<int?>("RulesetID");
+
+                    b.Property<string>("StringValue")
+                        .HasColumnName("Value");
+
+                    b.Property<int?>("Variant");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("RulesetID", "Variant");
+
+                    b.ToTable("Settings");
+                });
+
+            modelBuilder.Entity("osu.Game.Input.Bindings.DatabasedKeyBinding", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("IntAction")
+                        .HasColumnName("Action");
+
+                    b.Property<string>("KeysString")
+                        .HasColumnName("Keys");
+
+                    b.Property<int?>("RulesetID");
+
+                    b.Property<int?>("Variant");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("IntAction");
+
+                    b.HasIndex("RulesetID", "Variant");
+
+                    b.ToTable("KeyBinding");
+                });
+
+            modelBuilder.Entity("osu.Game.IO.FileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<string>("Hash");
+
+                    b.Property<int>("ReferenceCount");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("Hash")
+                        .IsUnique();
+
+                    b.HasIndex("ReferenceCount");
+
+                    b.ToTable("FileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Rulesets.RulesetInfo", b =>
+                {
+                    b.Property<int?>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<bool>("Available");
+
+                    b.Property<string>("InstantiationInfo");
+
+                    b.Property<string>("Name");
+
+                    b.Property<string>("ShortName");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("Available");
+
+                    b.HasIndex("ShortName")
+                        .IsUnique();
+
+                    b.ToTable("RulesetInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Scoring.ScoreFileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("FileInfoID");
+
+                    b.Property<string>("Filename")
+                        .IsRequired();
+
+                    b.Property<int?>("ScoreInfoID");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("FileInfoID");
+
+                    b.HasIndex("ScoreInfoID");
+
+                    b.ToTable("ScoreFileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Scoring.ScoreInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<double>("Accuracy")
+                        .HasColumnType("DECIMAL(1,4)");
+
+                    b.Property<int>("BeatmapInfoID");
+
+                    b.Property<int>("Combo");
+
+                    b.Property<DateTimeOffset>("Date");
+
+                    b.Property<bool>("DeletePending");
+
+                    b.Property<string>("Hash");
+
+                    b.Property<int>("MaxCombo");
+
+                    b.Property<string>("ModsJson")
+                        .HasColumnName("Mods");
+
+                    b.Property<long?>("OnlineScoreID");
+
+                    b.Property<double?>("PP");
+
+                    b.Property<int>("Rank");
+
+                    b.Property<int>("RulesetID");
+
+                    b.Property<string>("StatisticsJson")
+                        .HasColumnName("Statistics");
+
+                    b.Property<int>("TotalScore");
+
+                    b.Property<string>("UserString")
+                        .HasColumnName("User");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("BeatmapInfoID");
+
+                    b.HasIndex("OnlineScoreID")
+                        .IsUnique();
+
+                    b.HasIndex("RulesetID");
+
+                    b.ToTable("ScoreInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Skinning.SkinFileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("FileInfoID");
+
+                    b.Property<string>("Filename")
+                        .IsRequired();
+
+                    b.Property<int>("SkinInfoID");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("FileInfoID");
+
+                    b.HasIndex("SkinInfoID");
+
+                    b.ToTable("SkinFileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Skinning.SkinInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<string>("Creator");
+
+                    b.Property<bool>("DeletePending");
+
+                    b.Property<string>("Hash");
+
+                    b.Property<string>("Name");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("DeletePending");
+
+                    b.HasIndex("Hash")
+                        .IsUnique();
+
+                    b.ToTable("SkinInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapDifficulty", "BaseDifficulty")
+                        .WithMany()
+                        .HasForeignKey("BaseDifficultyID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo", "BeatmapSet")
+                        .WithMany("Beatmaps")
+                        .HasForeignKey("BeatmapSetInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
+                        .WithMany("Beatmaps")
+                        .HasForeignKey("MetadataID");
+
+                    b.HasOne("osu.Game.Rulesets.RulesetInfo", "Ruleset")
+                        .WithMany()
+                        .HasForeignKey("RulesetID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo")
+                        .WithMany("Files")
+                        .HasForeignKey("BeatmapSetInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
+                        .WithMany()
+                        .HasForeignKey("FileInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
+                        .WithMany("BeatmapSets")
+                        .HasForeignKey("MetadataID");
+                });
+
+            modelBuilder.Entity("osu.Game.Scoring.ScoreFileInfo", b =>
+                {
+                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
+                        .WithMany()
+                        .HasForeignKey("FileInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Scoring.ScoreInfo")
+                        .WithMany("Files")
+                        .HasForeignKey("ScoreInfoID");
+                });
+
+            modelBuilder.Entity("osu.Game.Scoring.ScoreInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapInfo", "Beatmap")
+                        .WithMany()
+                        .HasForeignKey("BeatmapInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Rulesets.RulesetInfo", "Ruleset")
+                        .WithMany()
+                        .HasForeignKey("RulesetID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+
+            modelBuilder.Entity("osu.Game.Skinning.SkinFileInfo", b =>
+                {
+                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
+                        .WithMany()
+                        .HasForeignKey("FileInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Skinning.SkinInfo")
+                        .WithMany("Files")
+                        .HasForeignKey("SkinInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+#pragma warning restore 612, 618
+        }
+    }
+}
diff --git a/osu.Game/Migrations/20181130113755_AddScoreInfoTables.cs b/osu.Game/Migrations/20181130113755_AddScoreInfoTables.cs
new file mode 100644
index 0000000000..2b6f94c5a4
--- /dev/null
+++ b/osu.Game/Migrations/20181130113755_AddScoreInfoTables.cs
@@ -0,0 +1,112 @@
+using System;
+using Microsoft.EntityFrameworkCore.Migrations;
+
+namespace osu.Game.Migrations
+{
+    public partial class AddScoreInfoTables : Migration
+    {
+        protected override void Up(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.CreateTable(
+                name: "ScoreInfo",
+                columns: table => new
+                {
+                    ID = table.Column<int>(nullable: false)
+                        .Annotation("Sqlite:Autoincrement", true),
+                    Rank = table.Column<int>(nullable: false),
+                    TotalScore = table.Column<int>(nullable: false),
+                    Accuracy = table.Column<double>(type: "DECIMAL(1,4)", nullable: false),
+                    PP = table.Column<double>(nullable: true),
+                    MaxCombo = table.Column<int>(nullable: false),
+                    Combo = table.Column<int>(nullable: false),
+                    RulesetID = table.Column<int>(nullable: false),
+                    Mods = table.Column<string>(nullable: true),
+                    User = table.Column<string>(nullable: true),
+                    BeatmapInfoID = table.Column<int>(nullable: false),
+                    OnlineScoreID = table.Column<long>(nullable: true),
+                    Date = table.Column<DateTimeOffset>(nullable: false),
+                    Statistics = table.Column<string>(nullable: true),
+                    Hash = table.Column<string>(nullable: true),
+                    DeletePending = table.Column<bool>(nullable: false)
+                },
+                constraints: table =>
+                {
+                    table.PrimaryKey("PK_ScoreInfo", x => x.ID);
+                    table.ForeignKey(
+                        name: "FK_ScoreInfo_BeatmapInfo_BeatmapInfoID",
+                        column: x => x.BeatmapInfoID,
+                        principalTable: "BeatmapInfo",
+                        principalColumn: "ID",
+                        onDelete: ReferentialAction.Cascade);
+                    table.ForeignKey(
+                        name: "FK_ScoreInfo_RulesetInfo_RulesetID",
+                        column: x => x.RulesetID,
+                        principalTable: "RulesetInfo",
+                        principalColumn: "ID",
+                        onDelete: ReferentialAction.Cascade);
+                });
+
+            migrationBuilder.CreateTable(
+                name: "ScoreFileInfo",
+                columns: table => new
+                {
+                    ID = table.Column<int>(nullable: false)
+                        .Annotation("Sqlite:Autoincrement", true),
+                    FileInfoID = table.Column<int>(nullable: false),
+                    Filename = table.Column<string>(nullable: false),
+                    ScoreInfoID = table.Column<int>(nullable: true)
+                },
+                constraints: table =>
+                {
+                    table.PrimaryKey("PK_ScoreFileInfo", x => x.ID);
+                    table.ForeignKey(
+                        name: "FK_ScoreFileInfo_FileInfo_FileInfoID",
+                        column: x => x.FileInfoID,
+                        principalTable: "FileInfo",
+                        principalColumn: "ID",
+                        onDelete: ReferentialAction.Cascade);
+                    table.ForeignKey(
+                        name: "FK_ScoreFileInfo_ScoreInfo_ScoreInfoID",
+                        column: x => x.ScoreInfoID,
+                        principalTable: "ScoreInfo",
+                        principalColumn: "ID",
+                        onDelete: ReferentialAction.Restrict);
+                });
+
+            migrationBuilder.CreateIndex(
+                name: "IX_ScoreFileInfo_FileInfoID",
+                table: "ScoreFileInfo",
+                column: "FileInfoID");
+
+            migrationBuilder.CreateIndex(
+                name: "IX_ScoreFileInfo_ScoreInfoID",
+                table: "ScoreFileInfo",
+                column: "ScoreInfoID");
+
+            migrationBuilder.CreateIndex(
+                name: "IX_ScoreInfo_BeatmapInfoID",
+                table: "ScoreInfo",
+                column: "BeatmapInfoID");
+
+            migrationBuilder.CreateIndex(
+                name: "IX_ScoreInfo_OnlineScoreID",
+                table: "ScoreInfo",
+                column: "OnlineScoreID",
+                unique: true);
+
+            migrationBuilder.CreateIndex(
+                name: "IX_ScoreInfo_RulesetID",
+                table: "ScoreInfo",
+                column: "RulesetID");
+        }
+
+        protected override void Down(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.DropTable(
+                name: "ScoreFileInfo");
+
+            migrationBuilder.DropTable(
+                name: "ScoreInfo");
+        }
+    }
+}
diff --git a/osu.Game/Migrations/20190225062029_AddUserIDColumn.Designer.cs b/osu.Game/Migrations/20190225062029_AddUserIDColumn.Designer.cs
new file mode 100644
index 0000000000..8e1e3a59f3
--- /dev/null
+++ b/osu.Game/Migrations/20190225062029_AddUserIDColumn.Designer.cs
@@ -0,0 +1,487 @@
+// <auto-generated />
+using System;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Infrastructure;
+using Microsoft.EntityFrameworkCore.Migrations;
+using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
+using osu.Game.Database;
+
+namespace osu.Game.Migrations
+{
+    [DbContext(typeof(OsuDbContext))]
+    [Migration("20190225062029_AddUserIDColumn")]
+    partial class AddUserIDColumn
+    {
+        protected override void BuildTargetModel(ModelBuilder modelBuilder)
+        {
+#pragma warning disable 612, 618
+            modelBuilder
+                .HasAnnotation("ProductVersion", "2.2.1-servicing-10028");
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapDifficulty", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<float>("ApproachRate");
+
+                    b.Property<float>("CircleSize");
+
+                    b.Property<float>("DrainRate");
+
+                    b.Property<float>("OverallDifficulty");
+
+                    b.Property<double>("SliderMultiplier");
+
+                    b.Property<double>("SliderTickRate");
+
+                    b.HasKey("ID");
+
+                    b.ToTable("BeatmapDifficulty");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("AudioLeadIn");
+
+                    b.Property<int>("BaseDifficultyID");
+
+                    b.Property<int>("BeatDivisor");
+
+                    b.Property<int>("BeatmapSetInfoID");
+
+                    b.Property<bool>("Countdown");
+
+                    b.Property<double>("DistanceSpacing");
+
+                    b.Property<int>("GridSize");
+
+                    b.Property<string>("Hash");
+
+                    b.Property<bool>("Hidden");
+
+                    b.Property<bool>("LetterboxInBreaks");
+
+                    b.Property<string>("MD5Hash");
+
+                    b.Property<int?>("MetadataID");
+
+                    b.Property<int?>("OnlineBeatmapID");
+
+                    b.Property<string>("Path");
+
+                    b.Property<int>("RulesetID");
+
+                    b.Property<bool>("SpecialStyle");
+
+                    b.Property<float>("StackLeniency");
+
+                    b.Property<double>("StarDifficulty");
+
+                    b.Property<int>("Status");
+
+                    b.Property<string>("StoredBookmarks");
+
+                    b.Property<double>("TimelineZoom");
+
+                    b.Property<string>("Version");
+
+                    b.Property<bool>("WidescreenStoryboard");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("BaseDifficultyID");
+
+                    b.HasIndex("BeatmapSetInfoID");
+
+                    b.HasIndex("Hash");
+
+                    b.HasIndex("MD5Hash");
+
+                    b.HasIndex("MetadataID");
+
+                    b.HasIndex("OnlineBeatmapID")
+                        .IsUnique();
+
+                    b.HasIndex("RulesetID");
+
+                    b.ToTable("BeatmapInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapMetadata", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<string>("Artist");
+
+                    b.Property<string>("ArtistUnicode");
+
+                    b.Property<string>("AudioFile");
+
+                    b.Property<string>("AuthorString")
+                        .HasColumnName("Author");
+
+                    b.Property<string>("BackgroundFile");
+
+                    b.Property<int>("PreviewTime");
+
+                    b.Property<string>("Source");
+
+                    b.Property<string>("Tags");
+
+                    b.Property<string>("Title");
+
+                    b.Property<string>("TitleUnicode");
+
+                    b.HasKey("ID");
+
+                    b.ToTable("BeatmapMetadata");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("BeatmapSetInfoID");
+
+                    b.Property<int>("FileInfoID");
+
+                    b.Property<string>("Filename")
+                        .IsRequired();
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("BeatmapSetInfoID");
+
+                    b.HasIndex("FileInfoID");
+
+                    b.ToTable("BeatmapSetFileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<bool>("DeletePending");
+
+                    b.Property<string>("Hash");
+
+                    b.Property<int?>("MetadataID");
+
+                    b.Property<int?>("OnlineBeatmapSetID");
+
+                    b.Property<bool>("Protected");
+
+                    b.Property<int>("Status");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("DeletePending");
+
+                    b.HasIndex("Hash")
+                        .IsUnique();
+
+                    b.HasIndex("MetadataID");
+
+                    b.HasIndex("OnlineBeatmapSetID")
+                        .IsUnique();
+
+                    b.ToTable("BeatmapSetInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Configuration.DatabasedSetting", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("IntKey")
+                        .HasColumnName("Key");
+
+                    b.Property<int?>("RulesetID");
+
+                    b.Property<string>("StringValue")
+                        .HasColumnName("Value");
+
+                    b.Property<int?>("Variant");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("RulesetID", "Variant");
+
+                    b.ToTable("Settings");
+                });
+
+            modelBuilder.Entity("osu.Game.IO.FileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<string>("Hash");
+
+                    b.Property<int>("ReferenceCount");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("Hash")
+                        .IsUnique();
+
+                    b.HasIndex("ReferenceCount");
+
+                    b.ToTable("FileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Input.Bindings.DatabasedKeyBinding", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("IntAction")
+                        .HasColumnName("Action");
+
+                    b.Property<string>("KeysString")
+                        .HasColumnName("Keys");
+
+                    b.Property<int?>("RulesetID");
+
+                    b.Property<int?>("Variant");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("IntAction");
+
+                    b.HasIndex("RulesetID", "Variant");
+
+                    b.ToTable("KeyBinding");
+                });
+
+            modelBuilder.Entity("osu.Game.Rulesets.RulesetInfo", b =>
+                {
+                    b.Property<int?>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<bool>("Available");
+
+                    b.Property<string>("InstantiationInfo");
+
+                    b.Property<string>("Name");
+
+                    b.Property<string>("ShortName");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("Available");
+
+                    b.HasIndex("ShortName")
+                        .IsUnique();
+
+                    b.ToTable("RulesetInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Scoring.ScoreFileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("FileInfoID");
+
+                    b.Property<string>("Filename")
+                        .IsRequired();
+
+                    b.Property<int?>("ScoreInfoID");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("FileInfoID");
+
+                    b.HasIndex("ScoreInfoID");
+
+                    b.ToTable("ScoreFileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Scoring.ScoreInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<double>("Accuracy")
+                        .HasColumnType("DECIMAL(1,4)");
+
+                    b.Property<int>("BeatmapInfoID");
+
+                    b.Property<int>("Combo");
+
+                    b.Property<DateTimeOffset>("Date");
+
+                    b.Property<bool>("DeletePending");
+
+                    b.Property<string>("Hash");
+
+                    b.Property<int>("MaxCombo");
+
+                    b.Property<string>("ModsJson")
+                        .HasColumnName("Mods");
+
+                    b.Property<long?>("OnlineScoreID");
+
+                    b.Property<double?>("PP");
+
+                    b.Property<int>("Rank");
+
+                    b.Property<int>("RulesetID");
+
+                    b.Property<string>("StatisticsJson")
+                        .HasColumnName("Statistics");
+
+                    b.Property<int>("TotalScore");
+
+                    b.Property<long?>("UserID")
+                        .HasColumnName("UserID");
+
+                    b.Property<string>("UserString")
+                        .HasColumnName("User");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("BeatmapInfoID");
+
+                    b.HasIndex("OnlineScoreID")
+                        .IsUnique();
+
+                    b.HasIndex("RulesetID");
+
+                    b.ToTable("ScoreInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Skinning.SkinFileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("FileInfoID");
+
+                    b.Property<string>("Filename")
+                        .IsRequired();
+
+                    b.Property<int>("SkinInfoID");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("FileInfoID");
+
+                    b.HasIndex("SkinInfoID");
+
+                    b.ToTable("SkinFileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Skinning.SkinInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<string>("Creator");
+
+                    b.Property<bool>("DeletePending");
+
+                    b.Property<string>("Hash");
+
+                    b.Property<string>("Name");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("DeletePending");
+
+                    b.HasIndex("Hash")
+                        .IsUnique();
+
+                    b.ToTable("SkinInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapDifficulty", "BaseDifficulty")
+                        .WithMany()
+                        .HasForeignKey("BaseDifficultyID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo", "BeatmapSet")
+                        .WithMany("Beatmaps")
+                        .HasForeignKey("BeatmapSetInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
+                        .WithMany("Beatmaps")
+                        .HasForeignKey("MetadataID");
+
+                    b.HasOne("osu.Game.Rulesets.RulesetInfo", "Ruleset")
+                        .WithMany()
+                        .HasForeignKey("RulesetID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo")
+                        .WithMany("Files")
+                        .HasForeignKey("BeatmapSetInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
+                        .WithMany()
+                        .HasForeignKey("FileInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
+                        .WithMany("BeatmapSets")
+                        .HasForeignKey("MetadataID");
+                });
+
+            modelBuilder.Entity("osu.Game.Scoring.ScoreFileInfo", b =>
+                {
+                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
+                        .WithMany()
+                        .HasForeignKey("FileInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Scoring.ScoreInfo")
+                        .WithMany("Files")
+                        .HasForeignKey("ScoreInfoID");
+                });
+
+            modelBuilder.Entity("osu.Game.Scoring.ScoreInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapInfo", "Beatmap")
+                        .WithMany("Scores")
+                        .HasForeignKey("BeatmapInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Rulesets.RulesetInfo", "Ruleset")
+                        .WithMany()
+                        .HasForeignKey("RulesetID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+
+            modelBuilder.Entity("osu.Game.Skinning.SkinFileInfo", b =>
+                {
+                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
+                        .WithMany()
+                        .HasForeignKey("FileInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Skinning.SkinInfo")
+                        .WithMany("Files")
+                        .HasForeignKey("SkinInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+#pragma warning restore 612, 618
+        }
+    }
+}
diff --git a/osu.Game/Migrations/20190225062029_AddUserIDColumn.cs b/osu.Game/Migrations/20190225062029_AddUserIDColumn.cs
new file mode 100644
index 0000000000..0720e0eac7
--- /dev/null
+++ b/osu.Game/Migrations/20190225062029_AddUserIDColumn.cs
@@ -0,0 +1,22 @@
+using Microsoft.EntityFrameworkCore.Migrations;
+
+namespace osu.Game.Migrations
+{
+    public partial class AddUserIDColumn : Migration
+    {
+        protected override void Up(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.AddColumn<long>(
+                name: "UserID",
+                table: "ScoreInfo",
+                nullable: true);
+        }
+
+        protected override void Down(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.DropColumn(
+                name: "UserID",
+                table: "ScoreInfo");
+        }
+    }
+}
diff --git a/osu.Game/Migrations/20190525060824_SkinSettings.Designer.cs b/osu.Game/Migrations/20190525060824_SkinSettings.Designer.cs
new file mode 100644
index 0000000000..348c42adb9
--- /dev/null
+++ b/osu.Game/Migrations/20190525060824_SkinSettings.Designer.cs
@@ -0,0 +1,498 @@
+// <auto-generated />
+using System;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Infrastructure;
+using Microsoft.EntityFrameworkCore.Migrations;
+using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
+using osu.Game.Database;
+
+namespace osu.Game.Migrations
+{
+    [DbContext(typeof(OsuDbContext))]
+    [Migration("20190525060824_SkinSettings")]
+    partial class SkinSettings
+    {
+        protected override void BuildTargetModel(ModelBuilder modelBuilder)
+        {
+#pragma warning disable 612, 618
+            modelBuilder
+                .HasAnnotation("ProductVersion", "2.2.4-servicing-10062");
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapDifficulty", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<float>("ApproachRate");
+
+                    b.Property<float>("CircleSize");
+
+                    b.Property<float>("DrainRate");
+
+                    b.Property<float>("OverallDifficulty");
+
+                    b.Property<double>("SliderMultiplier");
+
+                    b.Property<double>("SliderTickRate");
+
+                    b.HasKey("ID");
+
+                    b.ToTable("BeatmapDifficulty");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("AudioLeadIn");
+
+                    b.Property<int>("BaseDifficultyID");
+
+                    b.Property<int>("BeatDivisor");
+
+                    b.Property<int>("BeatmapSetInfoID");
+
+                    b.Property<bool>("Countdown");
+
+                    b.Property<double>("DistanceSpacing");
+
+                    b.Property<int>("GridSize");
+
+                    b.Property<string>("Hash");
+
+                    b.Property<bool>("Hidden");
+
+                    b.Property<bool>("LetterboxInBreaks");
+
+                    b.Property<string>("MD5Hash");
+
+                    b.Property<int?>("MetadataID");
+
+                    b.Property<int?>("OnlineBeatmapID");
+
+                    b.Property<string>("Path");
+
+                    b.Property<int>("RulesetID");
+
+                    b.Property<bool>("SpecialStyle");
+
+                    b.Property<float>("StackLeniency");
+
+                    b.Property<double>("StarDifficulty");
+
+                    b.Property<int>("Status");
+
+                    b.Property<string>("StoredBookmarks");
+
+                    b.Property<double>("TimelineZoom");
+
+                    b.Property<string>("Version");
+
+                    b.Property<bool>("WidescreenStoryboard");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("BaseDifficultyID");
+
+                    b.HasIndex("BeatmapSetInfoID");
+
+                    b.HasIndex("Hash");
+
+                    b.HasIndex("MD5Hash");
+
+                    b.HasIndex("MetadataID");
+
+                    b.HasIndex("OnlineBeatmapID")
+                        .IsUnique();
+
+                    b.HasIndex("RulesetID");
+
+                    b.ToTable("BeatmapInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapMetadata", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<string>("Artist");
+
+                    b.Property<string>("ArtistUnicode");
+
+                    b.Property<string>("AudioFile");
+
+                    b.Property<string>("AuthorString")
+                        .HasColumnName("Author");
+
+                    b.Property<string>("BackgroundFile");
+
+                    b.Property<int>("PreviewTime");
+
+                    b.Property<string>("Source");
+
+                    b.Property<string>("Tags");
+
+                    b.Property<string>("Title");
+
+                    b.Property<string>("TitleUnicode");
+
+                    b.HasKey("ID");
+
+                    b.ToTable("BeatmapMetadata");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("BeatmapSetInfoID");
+
+                    b.Property<int>("FileInfoID");
+
+                    b.Property<string>("Filename")
+                        .IsRequired();
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("BeatmapSetInfoID");
+
+                    b.HasIndex("FileInfoID");
+
+                    b.ToTable("BeatmapSetFileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<bool>("DeletePending");
+
+                    b.Property<string>("Hash");
+
+                    b.Property<int?>("MetadataID");
+
+                    b.Property<int?>("OnlineBeatmapSetID");
+
+                    b.Property<bool>("Protected");
+
+                    b.Property<int>("Status");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("DeletePending");
+
+                    b.HasIndex("Hash")
+                        .IsUnique();
+
+                    b.HasIndex("MetadataID");
+
+                    b.HasIndex("OnlineBeatmapSetID")
+                        .IsUnique();
+
+                    b.ToTable("BeatmapSetInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Configuration.DatabasedSetting", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<string>("Key")
+                        .HasColumnName("Key");
+
+                    b.Property<int?>("RulesetID");
+
+                    b.Property<int?>("SkinInfoID");
+
+                    b.Property<string>("StringValue")
+                        .HasColumnName("Value");
+
+                    b.Property<int?>("Variant");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("SkinInfoID");
+
+                    b.HasIndex("RulesetID", "Variant");
+
+                    b.ToTable("Settings");
+                });
+
+            modelBuilder.Entity("osu.Game.IO.FileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<string>("Hash");
+
+                    b.Property<int>("ReferenceCount");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("Hash")
+                        .IsUnique();
+
+                    b.HasIndex("ReferenceCount");
+
+                    b.ToTable("FileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Input.Bindings.DatabasedKeyBinding", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("IntAction")
+                        .HasColumnName("Action");
+
+                    b.Property<string>("KeysString")
+                        .HasColumnName("Keys");
+
+                    b.Property<int?>("RulesetID");
+
+                    b.Property<int?>("Variant");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("IntAction");
+
+                    b.HasIndex("RulesetID", "Variant");
+
+                    b.ToTable("KeyBinding");
+                });
+
+            modelBuilder.Entity("osu.Game.Rulesets.RulesetInfo", b =>
+                {
+                    b.Property<int?>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<bool>("Available");
+
+                    b.Property<string>("InstantiationInfo");
+
+                    b.Property<string>("Name");
+
+                    b.Property<string>("ShortName");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("Available");
+
+                    b.HasIndex("ShortName")
+                        .IsUnique();
+
+                    b.ToTable("RulesetInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Scoring.ScoreFileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("FileInfoID");
+
+                    b.Property<string>("Filename")
+                        .IsRequired();
+
+                    b.Property<int?>("ScoreInfoID");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("FileInfoID");
+
+                    b.HasIndex("ScoreInfoID");
+
+                    b.ToTable("ScoreFileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Scoring.ScoreInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<double>("Accuracy")
+                        .HasColumnType("DECIMAL(1,4)");
+
+                    b.Property<int>("BeatmapInfoID");
+
+                    b.Property<int>("Combo");
+
+                    b.Property<DateTimeOffset>("Date");
+
+                    b.Property<bool>("DeletePending");
+
+                    b.Property<string>("Hash");
+
+                    b.Property<int>("MaxCombo");
+
+                    b.Property<string>("ModsJson")
+                        .HasColumnName("Mods");
+
+                    b.Property<long?>("OnlineScoreID");
+
+                    b.Property<double?>("PP");
+
+                    b.Property<int>("Rank");
+
+                    b.Property<int>("RulesetID");
+
+                    b.Property<string>("StatisticsJson")
+                        .HasColumnName("Statistics");
+
+                    b.Property<long>("TotalScore");
+
+                    b.Property<long?>("UserID")
+                        .HasColumnName("UserID");
+
+                    b.Property<string>("UserString")
+                        .HasColumnName("User");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("BeatmapInfoID");
+
+                    b.HasIndex("OnlineScoreID")
+                        .IsUnique();
+
+                    b.HasIndex("RulesetID");
+
+                    b.ToTable("ScoreInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Skinning.SkinFileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("FileInfoID");
+
+                    b.Property<string>("Filename")
+                        .IsRequired();
+
+                    b.Property<int>("SkinInfoID");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("FileInfoID");
+
+                    b.HasIndex("SkinInfoID");
+
+                    b.ToTable("SkinFileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Skinning.SkinInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<string>("Creator");
+
+                    b.Property<bool>("DeletePending");
+
+                    b.Property<string>("Hash");
+
+                    b.Property<string>("Name");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("DeletePending");
+
+                    b.HasIndex("Hash")
+                        .IsUnique();
+
+                    b.ToTable("SkinInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapDifficulty", "BaseDifficulty")
+                        .WithMany()
+                        .HasForeignKey("BaseDifficultyID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo", "BeatmapSet")
+                        .WithMany("Beatmaps")
+                        .HasForeignKey("BeatmapSetInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
+                        .WithMany("Beatmaps")
+                        .HasForeignKey("MetadataID");
+
+                    b.HasOne("osu.Game.Rulesets.RulesetInfo", "Ruleset")
+                        .WithMany()
+                        .HasForeignKey("RulesetID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo")
+                        .WithMany("Files")
+                        .HasForeignKey("BeatmapSetInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
+                        .WithMany()
+                        .HasForeignKey("FileInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
+                        .WithMany("BeatmapSets")
+                        .HasForeignKey("MetadataID");
+                });
+
+            modelBuilder.Entity("osu.Game.Configuration.DatabasedSetting", b =>
+                {
+                    b.HasOne("osu.Game.Skinning.SkinInfo")
+                        .WithMany("Settings")
+                        .HasForeignKey("SkinInfoID");
+                });
+
+            modelBuilder.Entity("osu.Game.Scoring.ScoreFileInfo", b =>
+                {
+                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
+                        .WithMany()
+                        .HasForeignKey("FileInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Scoring.ScoreInfo")
+                        .WithMany("Files")
+                        .HasForeignKey("ScoreInfoID");
+                });
+
+            modelBuilder.Entity("osu.Game.Scoring.ScoreInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapInfo", "Beatmap")
+                        .WithMany("Scores")
+                        .HasForeignKey("BeatmapInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Rulesets.RulesetInfo", "Ruleset")
+                        .WithMany()
+                        .HasForeignKey("RulesetID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+
+            modelBuilder.Entity("osu.Game.Skinning.SkinFileInfo", b =>
+                {
+                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
+                        .WithMany()
+                        .HasForeignKey("FileInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Skinning.SkinInfo")
+                        .WithMany("Files")
+                        .HasForeignKey("SkinInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+#pragma warning restore 612, 618
+        }
+    }
+}
diff --git a/osu.Game/Migrations/20190525060824_SkinSettings.cs b/osu.Game/Migrations/20190525060824_SkinSettings.cs
new file mode 100644
index 0000000000..99237419b7
--- /dev/null
+++ b/osu.Game/Migrations/20190525060824_SkinSettings.cs
@@ -0,0 +1,54 @@
+using Microsoft.EntityFrameworkCore.Migrations;
+
+namespace osu.Game.Migrations
+{
+    public partial class SkinSettings : Migration
+    {
+        protected override void Up(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.Sql(@"create table Settings_dg_tmp
+            (
+	            ID INTEGER not null
+		            constraint PK_Settings
+			            primary key autoincrement,
+	            Key TEXT not null,
+	            RulesetID INTEGER,
+	            Value TEXT,
+	            Variant INTEGER,
+	            SkinInfoID int
+		            constraint Settings_SkinInfo_ID_fk
+			            references SkinInfo
+				            on delete restrict
+            );
+
+            insert into Settings_dg_tmp(ID, Key, RulesetID, Value, Variant) select ID, Key, RulesetID, Value, Variant from Settings;
+
+            drop table Settings;
+
+            alter table Settings_dg_tmp rename to Settings;
+
+            create index IX_Settings_RulesetID_Variant
+	            on Settings (RulesetID, Variant);
+
+            create index Settings_SkinInfoID_index
+	            on Settings (SkinInfoID);
+
+            ");
+        }
+
+        protected override void Down(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.DropForeignKey(
+                name: "FK_Settings_SkinInfo_SkinInfoID",
+                table: "Settings");
+
+            migrationBuilder.DropIndex(
+                name: "IX_Settings_SkinInfoID",
+                table: "Settings");
+
+            migrationBuilder.DropColumn(
+                name: "SkinInfoID",
+                table: "Settings");
+        }
+    }
+}
diff --git a/osu.Game/Migrations/20190605091246_AddDateAddedColumnToBeatmapSet.Designer.cs b/osu.Game/Migrations/20190605091246_AddDateAddedColumnToBeatmapSet.Designer.cs
new file mode 100644
index 0000000000..9477369aa0
--- /dev/null
+++ b/osu.Game/Migrations/20190605091246_AddDateAddedColumnToBeatmapSet.Designer.cs
@@ -0,0 +1,489 @@
+// <auto-generated />
+using System;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Infrastructure;
+using Microsoft.EntityFrameworkCore.Migrations;
+using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
+using osu.Game.Database;
+
+namespace osu.Game.Migrations
+{
+    [DbContext(typeof(OsuDbContext))]
+    [Migration("20190605091246_AddDateAddedColumnToBeatmapSet")]
+    partial class AddDateAddedColumnToBeatmapSet
+    {
+        protected override void BuildTargetModel(ModelBuilder modelBuilder)
+        {
+#pragma warning disable 612, 618
+            modelBuilder
+                .HasAnnotation("ProductVersion", "2.2.4-servicing-10062");
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapDifficulty", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<float>("ApproachRate");
+
+                    b.Property<float>("CircleSize");
+
+                    b.Property<float>("DrainRate");
+
+                    b.Property<float>("OverallDifficulty");
+
+                    b.Property<double>("SliderMultiplier");
+
+                    b.Property<double>("SliderTickRate");
+
+                    b.HasKey("ID");
+
+                    b.ToTable("BeatmapDifficulty");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("AudioLeadIn");
+
+                    b.Property<int>("BaseDifficultyID");
+
+                    b.Property<int>("BeatDivisor");
+
+                    b.Property<int>("BeatmapSetInfoID");
+
+                    b.Property<bool>("Countdown");
+
+                    b.Property<double>("DistanceSpacing");
+
+                    b.Property<int>("GridSize");
+
+                    b.Property<string>("Hash");
+
+                    b.Property<bool>("Hidden");
+
+                    b.Property<bool>("LetterboxInBreaks");
+
+                    b.Property<string>("MD5Hash");
+
+                    b.Property<int?>("MetadataID");
+
+                    b.Property<int?>("OnlineBeatmapID");
+
+                    b.Property<string>("Path");
+
+                    b.Property<int>("RulesetID");
+
+                    b.Property<bool>("SpecialStyle");
+
+                    b.Property<float>("StackLeniency");
+
+                    b.Property<double>("StarDifficulty");
+
+                    b.Property<int>("Status");
+
+                    b.Property<string>("StoredBookmarks");
+
+                    b.Property<double>("TimelineZoom");
+
+                    b.Property<string>("Version");
+
+                    b.Property<bool>("WidescreenStoryboard");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("BaseDifficultyID");
+
+                    b.HasIndex("BeatmapSetInfoID");
+
+                    b.HasIndex("Hash");
+
+                    b.HasIndex("MD5Hash");
+
+                    b.HasIndex("MetadataID");
+
+                    b.HasIndex("OnlineBeatmapID")
+                        .IsUnique();
+
+                    b.HasIndex("RulesetID");
+
+                    b.ToTable("BeatmapInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapMetadata", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<string>("Artist");
+
+                    b.Property<string>("ArtistUnicode");
+
+                    b.Property<string>("AudioFile");
+
+                    b.Property<string>("AuthorString")
+                        .HasColumnName("Author");
+
+                    b.Property<string>("BackgroundFile");
+
+                    b.Property<int>("PreviewTime");
+
+                    b.Property<string>("Source");
+
+                    b.Property<string>("Tags");
+
+                    b.Property<string>("Title");
+
+                    b.Property<string>("TitleUnicode");
+
+                    b.HasKey("ID");
+
+                    b.ToTable("BeatmapMetadata");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("BeatmapSetInfoID");
+
+                    b.Property<int>("FileInfoID");
+
+                    b.Property<string>("Filename")
+                        .IsRequired();
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("BeatmapSetInfoID");
+
+                    b.HasIndex("FileInfoID");
+
+                    b.ToTable("BeatmapSetFileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<DateTimeOffset>("DateAdded");
+
+                    b.Property<bool>("DeletePending");
+
+                    b.Property<string>("Hash");
+
+                    b.Property<int?>("MetadataID");
+
+                    b.Property<int?>("OnlineBeatmapSetID");
+
+                    b.Property<bool>("Protected");
+
+                    b.Property<int>("Status");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("DeletePending");
+
+                    b.HasIndex("Hash")
+                        .IsUnique();
+
+                    b.HasIndex("MetadataID");
+
+                    b.HasIndex("OnlineBeatmapSetID")
+                        .IsUnique();
+
+                    b.ToTable("BeatmapSetInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Configuration.DatabasedSetting", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<string>("Key")
+                        .HasColumnName("Key");
+
+                    b.Property<int?>("RulesetID");
+
+                    b.Property<string>("StringValue")
+                        .HasColumnName("Value");
+
+                    b.Property<int?>("Variant");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("RulesetID", "Variant");
+
+                    b.ToTable("Settings");
+                });
+
+            modelBuilder.Entity("osu.Game.IO.FileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<string>("Hash");
+
+                    b.Property<int>("ReferenceCount");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("Hash")
+                        .IsUnique();
+
+                    b.HasIndex("ReferenceCount");
+
+                    b.ToTable("FileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Input.Bindings.DatabasedKeyBinding", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("IntAction")
+                        .HasColumnName("Action");
+
+                    b.Property<string>("KeysString")
+                        .HasColumnName("Keys");
+
+                    b.Property<int?>("RulesetID");
+
+                    b.Property<int?>("Variant");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("IntAction");
+
+                    b.HasIndex("RulesetID", "Variant");
+
+                    b.ToTable("KeyBinding");
+                });
+
+            modelBuilder.Entity("osu.Game.Rulesets.RulesetInfo", b =>
+                {
+                    b.Property<int?>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<bool>("Available");
+
+                    b.Property<string>("InstantiationInfo");
+
+                    b.Property<string>("Name");
+
+                    b.Property<string>("ShortName");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("Available");
+
+                    b.HasIndex("ShortName")
+                        .IsUnique();
+
+                    b.ToTable("RulesetInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Scoring.ScoreFileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("FileInfoID");
+
+                    b.Property<string>("Filename")
+                        .IsRequired();
+
+                    b.Property<int?>("ScoreInfoID");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("FileInfoID");
+
+                    b.HasIndex("ScoreInfoID");
+
+                    b.ToTable("ScoreFileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Scoring.ScoreInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<double>("Accuracy")
+                        .HasColumnType("DECIMAL(1,4)");
+
+                    b.Property<int>("BeatmapInfoID");
+
+                    b.Property<int>("Combo");
+
+                    b.Property<DateTimeOffset>("Date");
+
+                    b.Property<bool>("DeletePending");
+
+                    b.Property<string>("Hash");
+
+                    b.Property<int>("MaxCombo");
+
+                    b.Property<string>("ModsJson")
+                        .HasColumnName("Mods");
+
+                    b.Property<long?>("OnlineScoreID");
+
+                    b.Property<double?>("PP");
+
+                    b.Property<int>("Rank");
+
+                    b.Property<int>("RulesetID");
+
+                    b.Property<string>("StatisticsJson")
+                        .HasColumnName("Statistics");
+
+                    b.Property<long>("TotalScore");
+
+                    b.Property<long?>("UserID")
+                        .HasColumnName("UserID");
+
+                    b.Property<string>("UserString")
+                        .HasColumnName("User");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("BeatmapInfoID");
+
+                    b.HasIndex("OnlineScoreID")
+                        .IsUnique();
+
+                    b.HasIndex("RulesetID");
+
+                    b.ToTable("ScoreInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Skinning.SkinFileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("FileInfoID");
+
+                    b.Property<string>("Filename")
+                        .IsRequired();
+
+                    b.Property<int>("SkinInfoID");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("FileInfoID");
+
+                    b.HasIndex("SkinInfoID");
+
+                    b.ToTable("SkinFileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Skinning.SkinInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<string>("Creator");
+
+                    b.Property<bool>("DeletePending");
+
+                    b.Property<string>("Hash");
+
+                    b.Property<string>("Name");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("DeletePending");
+
+                    b.HasIndex("Hash")
+                        .IsUnique();
+
+                    b.ToTable("SkinInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapDifficulty", "BaseDifficulty")
+                        .WithMany()
+                        .HasForeignKey("BaseDifficultyID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo", "BeatmapSet")
+                        .WithMany("Beatmaps")
+                        .HasForeignKey("BeatmapSetInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
+                        .WithMany("Beatmaps")
+                        .HasForeignKey("MetadataID");
+
+                    b.HasOne("osu.Game.Rulesets.RulesetInfo", "Ruleset")
+                        .WithMany()
+                        .HasForeignKey("RulesetID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo")
+                        .WithMany("Files")
+                        .HasForeignKey("BeatmapSetInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
+                        .WithMany()
+                        .HasForeignKey("FileInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
+                        .WithMany("BeatmapSets")
+                        .HasForeignKey("MetadataID");
+                });
+
+            modelBuilder.Entity("osu.Game.Scoring.ScoreFileInfo", b =>
+                {
+                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
+                        .WithMany()
+                        .HasForeignKey("FileInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Scoring.ScoreInfo")
+                        .WithMany("Files")
+                        .HasForeignKey("ScoreInfoID");
+                });
+
+            modelBuilder.Entity("osu.Game.Scoring.ScoreInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapInfo", "Beatmap")
+                        .WithMany("Scores")
+                        .HasForeignKey("BeatmapInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Rulesets.RulesetInfo", "Ruleset")
+                        .WithMany()
+                        .HasForeignKey("RulesetID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+
+            modelBuilder.Entity("osu.Game.Skinning.SkinFileInfo", b =>
+                {
+                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
+                        .WithMany()
+                        .HasForeignKey("FileInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Skinning.SkinInfo")
+                        .WithMany("Files")
+                        .HasForeignKey("SkinInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+#pragma warning restore 612, 618
+        }
+    }
+}
diff --git a/osu.Game/Migrations/20190605091246_AddDateAddedColumnToBeatmapSet.cs b/osu.Game/Migrations/20190605091246_AddDateAddedColumnToBeatmapSet.cs
new file mode 100644
index 0000000000..55dc18b6a3
--- /dev/null
+++ b/osu.Game/Migrations/20190605091246_AddDateAddedColumnToBeatmapSet.cs
@@ -0,0 +1,24 @@
+using System;
+using Microsoft.EntityFrameworkCore.Migrations;
+
+namespace osu.Game.Migrations
+{
+    public partial class AddDateAddedColumnToBeatmapSet : Migration
+    {
+        protected override void Up(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.AddColumn<DateTimeOffset>(
+                name: "DateAdded",
+                table: "BeatmapSetInfo",
+                nullable: false,
+                defaultValue: new DateTimeOffset(new DateTime(1, 1, 1, 0, 0, 0, 0, DateTimeKind.Unspecified), new TimeSpan(0, 0, 0, 0, 0)));
+        }
+
+        protected override void Down(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.DropColumn(
+                name: "DateAdded",
+                table: "BeatmapSetInfo");
+        }
+    }
+}
diff --git a/osu.Game/Migrations/20190708070844_AddBPMAndLengthColumns.Designer.cs b/osu.Game/Migrations/20190708070844_AddBPMAndLengthColumns.Designer.cs
new file mode 100644
index 0000000000..c5fcc16f84
--- /dev/null
+++ b/osu.Game/Migrations/20190708070844_AddBPMAndLengthColumns.Designer.cs
@@ -0,0 +1,504 @@
+// <auto-generated />
+using System;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Infrastructure;
+using Microsoft.EntityFrameworkCore.Migrations;
+using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
+using osu.Game.Database;
+
+namespace osu.Game.Migrations
+{
+    [DbContext(typeof(OsuDbContext))]
+    [Migration("20190708070844_AddBPMAndLengthColumns")]
+    partial class AddBPMAndLengthColumns
+    {
+        protected override void BuildTargetModel(ModelBuilder modelBuilder)
+        {
+#pragma warning disable 612, 618
+            modelBuilder
+                .HasAnnotation("ProductVersion", "2.2.4-servicing-10062");
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapDifficulty", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<float>("ApproachRate");
+
+                    b.Property<float>("CircleSize");
+
+                    b.Property<float>("DrainRate");
+
+                    b.Property<float>("OverallDifficulty");
+
+                    b.Property<double>("SliderMultiplier");
+
+                    b.Property<double>("SliderTickRate");
+
+                    b.HasKey("ID");
+
+                    b.ToTable("BeatmapDifficulty");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("AudioLeadIn");
+
+                    b.Property<double>("BPM");
+
+                    b.Property<int>("BaseDifficultyID");
+
+                    b.Property<int>("BeatDivisor");
+
+                    b.Property<int>("BeatmapSetInfoID");
+
+                    b.Property<bool>("Countdown");
+
+                    b.Property<double>("DistanceSpacing");
+
+                    b.Property<int>("GridSize");
+
+                    b.Property<string>("Hash");
+
+                    b.Property<bool>("Hidden");
+
+                    b.Property<double>("Length");
+
+                    b.Property<bool>("LetterboxInBreaks");
+
+                    b.Property<string>("MD5Hash");
+
+                    b.Property<int?>("MetadataID");
+
+                    b.Property<int?>("OnlineBeatmapID");
+
+                    b.Property<string>("Path");
+
+                    b.Property<int>("RulesetID");
+
+                    b.Property<bool>("SpecialStyle");
+
+                    b.Property<float>("StackLeniency");
+
+                    b.Property<double>("StarDifficulty");
+
+                    b.Property<int>("Status");
+
+                    b.Property<string>("StoredBookmarks");
+
+                    b.Property<double>("TimelineZoom");
+
+                    b.Property<string>("Version");
+
+                    b.Property<bool>("WidescreenStoryboard");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("BaseDifficultyID");
+
+                    b.HasIndex("BeatmapSetInfoID");
+
+                    b.HasIndex("Hash");
+
+                    b.HasIndex("MD5Hash");
+
+                    b.HasIndex("MetadataID");
+
+                    b.HasIndex("OnlineBeatmapID")
+                        .IsUnique();
+
+                    b.HasIndex("RulesetID");
+
+                    b.ToTable("BeatmapInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapMetadata", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<string>("Artist");
+
+                    b.Property<string>("ArtistUnicode");
+
+                    b.Property<string>("AudioFile");
+
+                    b.Property<string>("AuthorString")
+                        .HasColumnName("Author");
+
+                    b.Property<string>("BackgroundFile");
+
+                    b.Property<int>("PreviewTime");
+
+                    b.Property<string>("Source");
+
+                    b.Property<string>("Tags");
+
+                    b.Property<string>("Title");
+
+                    b.Property<string>("TitleUnicode");
+
+                    b.HasKey("ID");
+
+                    b.ToTable("BeatmapMetadata");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("BeatmapSetInfoID");
+
+                    b.Property<int>("FileInfoID");
+
+                    b.Property<string>("Filename")
+                        .IsRequired();
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("BeatmapSetInfoID");
+
+                    b.HasIndex("FileInfoID");
+
+                    b.ToTable("BeatmapSetFileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<DateTimeOffset>("DateAdded");
+
+                    b.Property<bool>("DeletePending");
+
+                    b.Property<string>("Hash");
+
+                    b.Property<int?>("MetadataID");
+
+                    b.Property<int?>("OnlineBeatmapSetID");
+
+                    b.Property<bool>("Protected");
+
+                    b.Property<int>("Status");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("DeletePending");
+
+                    b.HasIndex("Hash")
+                        .IsUnique();
+
+                    b.HasIndex("MetadataID");
+
+                    b.HasIndex("OnlineBeatmapSetID")
+                        .IsUnique();
+
+                    b.ToTable("BeatmapSetInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Configuration.DatabasedSetting", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<string>("Key")
+                        .HasColumnName("Key");
+
+                    b.Property<int?>("RulesetID");
+
+                    b.Property<int?>("SkinInfoID");
+
+                    b.Property<string>("StringValue")
+                        .HasColumnName("Value");
+
+                    b.Property<int?>("Variant");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("SkinInfoID");
+
+                    b.HasIndex("RulesetID", "Variant");
+
+                    b.ToTable("Settings");
+                });
+
+            modelBuilder.Entity("osu.Game.IO.FileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<string>("Hash");
+
+                    b.Property<int>("ReferenceCount");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("Hash")
+                        .IsUnique();
+
+                    b.HasIndex("ReferenceCount");
+
+                    b.ToTable("FileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Input.Bindings.DatabasedKeyBinding", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("IntAction")
+                        .HasColumnName("Action");
+
+                    b.Property<string>("KeysString")
+                        .HasColumnName("Keys");
+
+                    b.Property<int?>("RulesetID");
+
+                    b.Property<int?>("Variant");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("IntAction");
+
+                    b.HasIndex("RulesetID", "Variant");
+
+                    b.ToTable("KeyBinding");
+                });
+
+            modelBuilder.Entity("osu.Game.Rulesets.RulesetInfo", b =>
+                {
+                    b.Property<int?>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<bool>("Available");
+
+                    b.Property<string>("InstantiationInfo");
+
+                    b.Property<string>("Name");
+
+                    b.Property<string>("ShortName");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("Available");
+
+                    b.HasIndex("ShortName")
+                        .IsUnique();
+
+                    b.ToTable("RulesetInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Scoring.ScoreFileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("FileInfoID");
+
+                    b.Property<string>("Filename")
+                        .IsRequired();
+
+                    b.Property<int?>("ScoreInfoID");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("FileInfoID");
+
+                    b.HasIndex("ScoreInfoID");
+
+                    b.ToTable("ScoreFileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Scoring.ScoreInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<double>("Accuracy")
+                        .HasColumnType("DECIMAL(1,4)");
+
+                    b.Property<int>("BeatmapInfoID");
+
+                    b.Property<int>("Combo");
+
+                    b.Property<DateTimeOffset>("Date");
+
+                    b.Property<bool>("DeletePending");
+
+                    b.Property<string>("Hash");
+
+                    b.Property<int>("MaxCombo");
+
+                    b.Property<string>("ModsJson")
+                        .HasColumnName("Mods");
+
+                    b.Property<long?>("OnlineScoreID");
+
+                    b.Property<double?>("PP");
+
+                    b.Property<int>("Rank");
+
+                    b.Property<int>("RulesetID");
+
+                    b.Property<string>("StatisticsJson")
+                        .HasColumnName("Statistics");
+
+                    b.Property<long>("TotalScore");
+
+                    b.Property<long?>("UserID")
+                        .HasColumnName("UserID");
+
+                    b.Property<string>("UserString")
+                        .HasColumnName("User");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("BeatmapInfoID");
+
+                    b.HasIndex("OnlineScoreID")
+                        .IsUnique();
+
+                    b.HasIndex("RulesetID");
+
+                    b.ToTable("ScoreInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Skinning.SkinFileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("FileInfoID");
+
+                    b.Property<string>("Filename")
+                        .IsRequired();
+
+                    b.Property<int>("SkinInfoID");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("FileInfoID");
+
+                    b.HasIndex("SkinInfoID");
+
+                    b.ToTable("SkinFileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Skinning.SkinInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<string>("Creator");
+
+                    b.Property<bool>("DeletePending");
+
+                    b.Property<string>("Hash");
+
+                    b.Property<string>("Name");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("DeletePending");
+
+                    b.HasIndex("Hash")
+                        .IsUnique();
+
+                    b.ToTable("SkinInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapDifficulty", "BaseDifficulty")
+                        .WithMany()
+                        .HasForeignKey("BaseDifficultyID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo", "BeatmapSet")
+                        .WithMany("Beatmaps")
+                        .HasForeignKey("BeatmapSetInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
+                        .WithMany("Beatmaps")
+                        .HasForeignKey("MetadataID");
+
+                    b.HasOne("osu.Game.Rulesets.RulesetInfo", "Ruleset")
+                        .WithMany()
+                        .HasForeignKey("RulesetID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo")
+                        .WithMany("Files")
+                        .HasForeignKey("BeatmapSetInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
+                        .WithMany()
+                        .HasForeignKey("FileInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
+                        .WithMany("BeatmapSets")
+                        .HasForeignKey("MetadataID");
+                });
+
+            modelBuilder.Entity("osu.Game.Configuration.DatabasedSetting", b =>
+                {
+                    b.HasOne("osu.Game.Skinning.SkinInfo")
+                        .WithMany("Settings")
+                        .HasForeignKey("SkinInfoID");
+                });
+
+            modelBuilder.Entity("osu.Game.Scoring.ScoreFileInfo", b =>
+                {
+                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
+                        .WithMany()
+                        .HasForeignKey("FileInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Scoring.ScoreInfo")
+                        .WithMany("Files")
+                        .HasForeignKey("ScoreInfoID");
+                });
+
+            modelBuilder.Entity("osu.Game.Scoring.ScoreInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapInfo", "Beatmap")
+                        .WithMany("Scores")
+                        .HasForeignKey("BeatmapInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Rulesets.RulesetInfo", "Ruleset")
+                        .WithMany()
+                        .HasForeignKey("RulesetID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+
+            modelBuilder.Entity("osu.Game.Skinning.SkinFileInfo", b =>
+                {
+                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
+                        .WithMany()
+                        .HasForeignKey("FileInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Skinning.SkinInfo")
+                        .WithMany("Files")
+                        .HasForeignKey("SkinInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+#pragma warning restore 612, 618
+        }
+    }
+}
diff --git a/osu.Game/Migrations/20190708070844_AddBPMAndLengthColumns.cs b/osu.Game/Migrations/20190708070844_AddBPMAndLengthColumns.cs
new file mode 100644
index 0000000000..f5963ebf5e
--- /dev/null
+++ b/osu.Game/Migrations/20190708070844_AddBPMAndLengthColumns.cs
@@ -0,0 +1,33 @@
+using Microsoft.EntityFrameworkCore.Migrations;
+
+namespace osu.Game.Migrations
+{
+    public partial class AddBPMAndLengthColumns : Migration
+    {
+        protected override void Up(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.AddColumn<double>(
+                name: "BPM",
+                table: "BeatmapInfo",
+                nullable: false,
+                defaultValue: 0.0);
+
+            migrationBuilder.AddColumn<double>(
+                name: "Length",
+                table: "BeatmapInfo",
+                nullable: false,
+                defaultValue: 0.0);
+        }
+
+        protected override void Down(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.DropColumn(
+                name: "BPM",
+                table: "BeatmapInfo");
+
+            migrationBuilder.DropColumn(
+                name: "Length",
+                table: "BeatmapInfo");
+        }
+    }
+}
diff --git a/osu.Game/Migrations/20190913104727_AddBeatmapVideo.Designer.cs b/osu.Game/Migrations/20190913104727_AddBeatmapVideo.Designer.cs
new file mode 100644
index 0000000000..826233a2b0
--- /dev/null
+++ b/osu.Game/Migrations/20190913104727_AddBeatmapVideo.Designer.cs
@@ -0,0 +1,506 @@
+// <auto-generated />
+using System;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Infrastructure;
+using Microsoft.EntityFrameworkCore.Migrations;
+using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
+using osu.Game.Database;
+
+namespace osu.Game.Migrations
+{
+    [DbContext(typeof(OsuDbContext))]
+    [Migration("20190913104727_AddBeatmapVideo")]
+    partial class AddBeatmapVideo
+    {
+        protected override void BuildTargetModel(ModelBuilder modelBuilder)
+        {
+#pragma warning disable 612, 618
+            modelBuilder
+                .HasAnnotation("ProductVersion", "2.2.6-servicing-10079");
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapDifficulty", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<float>("ApproachRate");
+
+                    b.Property<float>("CircleSize");
+
+                    b.Property<float>("DrainRate");
+
+                    b.Property<float>("OverallDifficulty");
+
+                    b.Property<double>("SliderMultiplier");
+
+                    b.Property<double>("SliderTickRate");
+
+                    b.HasKey("ID");
+
+                    b.ToTable("BeatmapDifficulty");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("AudioLeadIn");
+
+                    b.Property<double>("BPM");
+
+                    b.Property<int>("BaseDifficultyID");
+
+                    b.Property<int>("BeatDivisor");
+
+                    b.Property<int>("BeatmapSetInfoID");
+
+                    b.Property<bool>("Countdown");
+
+                    b.Property<double>("DistanceSpacing");
+
+                    b.Property<int>("GridSize");
+
+                    b.Property<string>("Hash");
+
+                    b.Property<bool>("Hidden");
+
+                    b.Property<double>("Length");
+
+                    b.Property<bool>("LetterboxInBreaks");
+
+                    b.Property<string>("MD5Hash");
+
+                    b.Property<int?>("MetadataID");
+
+                    b.Property<int?>("OnlineBeatmapID");
+
+                    b.Property<string>("Path");
+
+                    b.Property<int>("RulesetID");
+
+                    b.Property<bool>("SpecialStyle");
+
+                    b.Property<float>("StackLeniency");
+
+                    b.Property<double>("StarDifficulty");
+
+                    b.Property<int>("Status");
+
+                    b.Property<string>("StoredBookmarks");
+
+                    b.Property<double>("TimelineZoom");
+
+                    b.Property<string>("Version");
+
+                    b.Property<bool>("WidescreenStoryboard");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("BaseDifficultyID");
+
+                    b.HasIndex("BeatmapSetInfoID");
+
+                    b.HasIndex("Hash");
+
+                    b.HasIndex("MD5Hash");
+
+                    b.HasIndex("MetadataID");
+
+                    b.HasIndex("OnlineBeatmapID")
+                        .IsUnique();
+
+                    b.HasIndex("RulesetID");
+
+                    b.ToTable("BeatmapInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapMetadata", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<string>("Artist");
+
+                    b.Property<string>("ArtistUnicode");
+
+                    b.Property<string>("AudioFile");
+
+                    b.Property<string>("AuthorString")
+                        .HasColumnName("Author");
+
+                    b.Property<string>("BackgroundFile");
+
+                    b.Property<int>("PreviewTime");
+
+                    b.Property<string>("Source");
+
+                    b.Property<string>("Tags");
+
+                    b.Property<string>("Title");
+
+                    b.Property<string>("TitleUnicode");
+
+                    b.Property<string>("VideoFile");
+
+                    b.HasKey("ID");
+
+                    b.ToTable("BeatmapMetadata");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("BeatmapSetInfoID");
+
+                    b.Property<int>("FileInfoID");
+
+                    b.Property<string>("Filename")
+                        .IsRequired();
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("BeatmapSetInfoID");
+
+                    b.HasIndex("FileInfoID");
+
+                    b.ToTable("BeatmapSetFileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<DateTimeOffset>("DateAdded");
+
+                    b.Property<bool>("DeletePending");
+
+                    b.Property<string>("Hash");
+
+                    b.Property<int?>("MetadataID");
+
+                    b.Property<int?>("OnlineBeatmapSetID");
+
+                    b.Property<bool>("Protected");
+
+                    b.Property<int>("Status");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("DeletePending");
+
+                    b.HasIndex("Hash")
+                        .IsUnique();
+
+                    b.HasIndex("MetadataID");
+
+                    b.HasIndex("OnlineBeatmapSetID")
+                        .IsUnique();
+
+                    b.ToTable("BeatmapSetInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Configuration.DatabasedSetting", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<string>("Key")
+                        .HasColumnName("Key");
+
+                    b.Property<int?>("RulesetID");
+
+                    b.Property<int?>("SkinInfoID");
+
+                    b.Property<string>("StringValue")
+                        .HasColumnName("Value");
+
+                    b.Property<int?>("Variant");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("SkinInfoID");
+
+                    b.HasIndex("RulesetID", "Variant");
+
+                    b.ToTable("Settings");
+                });
+
+            modelBuilder.Entity("osu.Game.IO.FileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<string>("Hash");
+
+                    b.Property<int>("ReferenceCount");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("Hash")
+                        .IsUnique();
+
+                    b.HasIndex("ReferenceCount");
+
+                    b.ToTable("FileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Input.Bindings.DatabasedKeyBinding", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("IntAction")
+                        .HasColumnName("Action");
+
+                    b.Property<string>("KeysString")
+                        .HasColumnName("Keys");
+
+                    b.Property<int?>("RulesetID");
+
+                    b.Property<int?>("Variant");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("IntAction");
+
+                    b.HasIndex("RulesetID", "Variant");
+
+                    b.ToTable("KeyBinding");
+                });
+
+            modelBuilder.Entity("osu.Game.Rulesets.RulesetInfo", b =>
+                {
+                    b.Property<int?>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<bool>("Available");
+
+                    b.Property<string>("InstantiationInfo");
+
+                    b.Property<string>("Name");
+
+                    b.Property<string>("ShortName");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("Available");
+
+                    b.HasIndex("ShortName")
+                        .IsUnique();
+
+                    b.ToTable("RulesetInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Scoring.ScoreFileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("FileInfoID");
+
+                    b.Property<string>("Filename")
+                        .IsRequired();
+
+                    b.Property<int?>("ScoreInfoID");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("FileInfoID");
+
+                    b.HasIndex("ScoreInfoID");
+
+                    b.ToTable("ScoreFileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Scoring.ScoreInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<double>("Accuracy")
+                        .HasColumnType("DECIMAL(1,4)");
+
+                    b.Property<int>("BeatmapInfoID");
+
+                    b.Property<int>("Combo");
+
+                    b.Property<DateTimeOffset>("Date");
+
+                    b.Property<bool>("DeletePending");
+
+                    b.Property<string>("Hash");
+
+                    b.Property<int>("MaxCombo");
+
+                    b.Property<string>("ModsJson")
+                        .HasColumnName("Mods");
+
+                    b.Property<long?>("OnlineScoreID");
+
+                    b.Property<double?>("PP");
+
+                    b.Property<int>("Rank");
+
+                    b.Property<int>("RulesetID");
+
+                    b.Property<string>("StatisticsJson")
+                        .HasColumnName("Statistics");
+
+                    b.Property<long>("TotalScore");
+
+                    b.Property<long?>("UserID")
+                        .HasColumnName("UserID");
+
+                    b.Property<string>("UserString")
+                        .HasColumnName("User");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("BeatmapInfoID");
+
+                    b.HasIndex("OnlineScoreID")
+                        .IsUnique();
+
+                    b.HasIndex("RulesetID");
+
+                    b.ToTable("ScoreInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Skinning.SkinFileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("FileInfoID");
+
+                    b.Property<string>("Filename")
+                        .IsRequired();
+
+                    b.Property<int>("SkinInfoID");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("FileInfoID");
+
+                    b.HasIndex("SkinInfoID");
+
+                    b.ToTable("SkinFileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Skinning.SkinInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<string>("Creator");
+
+                    b.Property<bool>("DeletePending");
+
+                    b.Property<string>("Hash");
+
+                    b.Property<string>("Name");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("DeletePending");
+
+                    b.HasIndex("Hash")
+                        .IsUnique();
+
+                    b.ToTable("SkinInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapDifficulty", "BaseDifficulty")
+                        .WithMany()
+                        .HasForeignKey("BaseDifficultyID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo", "BeatmapSet")
+                        .WithMany("Beatmaps")
+                        .HasForeignKey("BeatmapSetInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
+                        .WithMany("Beatmaps")
+                        .HasForeignKey("MetadataID");
+
+                    b.HasOne("osu.Game.Rulesets.RulesetInfo", "Ruleset")
+                        .WithMany()
+                        .HasForeignKey("RulesetID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo")
+                        .WithMany("Files")
+                        .HasForeignKey("BeatmapSetInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
+                        .WithMany()
+                        .HasForeignKey("FileInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
+                        .WithMany("BeatmapSets")
+                        .HasForeignKey("MetadataID");
+                });
+
+            modelBuilder.Entity("osu.Game.Configuration.DatabasedSetting", b =>
+                {
+                    b.HasOne("osu.Game.Skinning.SkinInfo")
+                        .WithMany("Settings")
+                        .HasForeignKey("SkinInfoID");
+                });
+
+            modelBuilder.Entity("osu.Game.Scoring.ScoreFileInfo", b =>
+                {
+                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
+                        .WithMany()
+                        .HasForeignKey("FileInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Scoring.ScoreInfo")
+                        .WithMany("Files")
+                        .HasForeignKey("ScoreInfoID");
+                });
+
+            modelBuilder.Entity("osu.Game.Scoring.ScoreInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapInfo", "Beatmap")
+                        .WithMany("Scores")
+                        .HasForeignKey("BeatmapInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Rulesets.RulesetInfo", "Ruleset")
+                        .WithMany()
+                        .HasForeignKey("RulesetID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+
+            modelBuilder.Entity("osu.Game.Skinning.SkinFileInfo", b =>
+                {
+                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
+                        .WithMany()
+                        .HasForeignKey("FileInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Skinning.SkinInfo")
+                        .WithMany("Files")
+                        .HasForeignKey("SkinInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+#pragma warning restore 612, 618
+        }
+    }
+}
diff --git a/osu.Game/Migrations/20190913104727_AddBeatmapVideo.cs b/osu.Game/Migrations/20190913104727_AddBeatmapVideo.cs
new file mode 100644
index 0000000000..9ed0943acd
--- /dev/null
+++ b/osu.Game/Migrations/20190913104727_AddBeatmapVideo.cs
@@ -0,0 +1,22 @@
+using Microsoft.EntityFrameworkCore.Migrations;
+
+namespace osu.Game.Migrations
+{
+    public partial class AddBeatmapVideo : Migration
+    {
+        protected override void Up(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.AddColumn<string>(
+                name: "VideoFile",
+                table: "BeatmapMetadata",
+                nullable: true);
+        }
+
+        protected override void Down(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.DropColumn(
+                name: "VideoFile",
+                table: "BeatmapMetadata");
+        }
+    }
+}
diff --git a/osu.Game/Migrations/20200302094919_RefreshVolumeBindings.Designer.cs b/osu.Game/Migrations/20200302094919_RefreshVolumeBindings.Designer.cs
new file mode 100644
index 0000000000..22316b0380
--- /dev/null
+++ b/osu.Game/Migrations/20200302094919_RefreshVolumeBindings.Designer.cs
@@ -0,0 +1,506 @@
+// <auto-generated />
+using System;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Infrastructure;
+using Microsoft.EntityFrameworkCore.Migrations;
+using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
+using osu.Game.Database;
+
+namespace osu.Game.Migrations
+{
+    [DbContext(typeof(OsuDbContext))]
+    [Migration("20200302094919_RefreshVolumeBindings")]
+    partial class RefreshVolumeBindings
+    {
+        protected override void BuildTargetModel(ModelBuilder modelBuilder)
+        {
+#pragma warning disable 612, 618
+            modelBuilder
+                .HasAnnotation("ProductVersion", "2.2.6-servicing-10079");
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapDifficulty", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<float>("ApproachRate");
+
+                    b.Property<float>("CircleSize");
+
+                    b.Property<float>("DrainRate");
+
+                    b.Property<float>("OverallDifficulty");
+
+                    b.Property<double>("SliderMultiplier");
+
+                    b.Property<double>("SliderTickRate");
+
+                    b.HasKey("ID");
+
+                    b.ToTable("BeatmapDifficulty");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<double>("AudioLeadIn");
+
+                    b.Property<double>("BPM");
+
+                    b.Property<int>("BaseDifficultyID");
+
+                    b.Property<int>("BeatDivisor");
+
+                    b.Property<int>("BeatmapSetInfoID");
+
+                    b.Property<bool>("Countdown");
+
+                    b.Property<double>("DistanceSpacing");
+
+                    b.Property<int>("GridSize");
+
+                    b.Property<string>("Hash");
+
+                    b.Property<bool>("Hidden");
+
+                    b.Property<double>("Length");
+
+                    b.Property<bool>("LetterboxInBreaks");
+
+                    b.Property<string>("MD5Hash");
+
+                    b.Property<int?>("MetadataID");
+
+                    b.Property<int?>("OnlineBeatmapID");
+
+                    b.Property<string>("Path");
+
+                    b.Property<int>("RulesetID");
+
+                    b.Property<bool>("SpecialStyle");
+
+                    b.Property<float>("StackLeniency");
+
+                    b.Property<double>("StarDifficulty");
+
+                    b.Property<int>("Status");
+
+                    b.Property<string>("StoredBookmarks");
+
+                    b.Property<double>("TimelineZoom");
+
+                    b.Property<string>("Version");
+
+                    b.Property<bool>("WidescreenStoryboard");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("BaseDifficultyID");
+
+                    b.HasIndex("BeatmapSetInfoID");
+
+                    b.HasIndex("Hash");
+
+                    b.HasIndex("MD5Hash");
+
+                    b.HasIndex("MetadataID");
+
+                    b.HasIndex("OnlineBeatmapID")
+                        .IsUnique();
+
+                    b.HasIndex("RulesetID");
+
+                    b.ToTable("BeatmapInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapMetadata", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<string>("Artist");
+
+                    b.Property<string>("ArtistUnicode");
+
+                    b.Property<string>("AudioFile");
+
+                    b.Property<string>("AuthorString")
+                        .HasColumnName("Author");
+
+                    b.Property<string>("BackgroundFile");
+
+                    b.Property<int>("PreviewTime");
+
+                    b.Property<string>("Source");
+
+                    b.Property<string>("Tags");
+
+                    b.Property<string>("Title");
+
+                    b.Property<string>("TitleUnicode");
+
+                    b.Property<string>("VideoFile");
+
+                    b.HasKey("ID");
+
+                    b.ToTable("BeatmapMetadata");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("BeatmapSetInfoID");
+
+                    b.Property<int>("FileInfoID");
+
+                    b.Property<string>("Filename")
+                        .IsRequired();
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("BeatmapSetInfoID");
+
+                    b.HasIndex("FileInfoID");
+
+                    b.ToTable("BeatmapSetFileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<DateTimeOffset>("DateAdded");
+
+                    b.Property<bool>("DeletePending");
+
+                    b.Property<string>("Hash");
+
+                    b.Property<int?>("MetadataID");
+
+                    b.Property<int?>("OnlineBeatmapSetID");
+
+                    b.Property<bool>("Protected");
+
+                    b.Property<int>("Status");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("DeletePending");
+
+                    b.HasIndex("Hash")
+                        .IsUnique();
+
+                    b.HasIndex("MetadataID");
+
+                    b.HasIndex("OnlineBeatmapSetID")
+                        .IsUnique();
+
+                    b.ToTable("BeatmapSetInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Configuration.DatabasedSetting", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<string>("Key")
+                        .HasColumnName("Key");
+
+                    b.Property<int?>("RulesetID");
+
+                    b.Property<int?>("SkinInfoID");
+
+                    b.Property<string>("StringValue")
+                        .HasColumnName("Value");
+
+                    b.Property<int?>("Variant");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("SkinInfoID");
+
+                    b.HasIndex("RulesetID", "Variant");
+
+                    b.ToTable("Settings");
+                });
+
+            modelBuilder.Entity("osu.Game.IO.FileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<string>("Hash");
+
+                    b.Property<int>("ReferenceCount");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("Hash")
+                        .IsUnique();
+
+                    b.HasIndex("ReferenceCount");
+
+                    b.ToTable("FileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Input.Bindings.DatabasedKeyBinding", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("IntAction")
+                        .HasColumnName("Action");
+
+                    b.Property<string>("KeysString")
+                        .HasColumnName("Keys");
+
+                    b.Property<int?>("RulesetID");
+
+                    b.Property<int?>("Variant");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("IntAction");
+
+                    b.HasIndex("RulesetID", "Variant");
+
+                    b.ToTable("KeyBinding");
+                });
+
+            modelBuilder.Entity("osu.Game.Rulesets.RulesetInfo", b =>
+                {
+                    b.Property<int?>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<bool>("Available");
+
+                    b.Property<string>("InstantiationInfo");
+
+                    b.Property<string>("Name");
+
+                    b.Property<string>("ShortName");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("Available");
+
+                    b.HasIndex("ShortName")
+                        .IsUnique();
+
+                    b.ToTable("RulesetInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Scoring.ScoreFileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("FileInfoID");
+
+                    b.Property<string>("Filename")
+                        .IsRequired();
+
+                    b.Property<int?>("ScoreInfoID");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("FileInfoID");
+
+                    b.HasIndex("ScoreInfoID");
+
+                    b.ToTable("ScoreFileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Scoring.ScoreInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<double>("Accuracy")
+                        .HasColumnType("DECIMAL(1,4)");
+
+                    b.Property<int>("BeatmapInfoID");
+
+                    b.Property<int>("Combo");
+
+                    b.Property<DateTimeOffset>("Date");
+
+                    b.Property<bool>("DeletePending");
+
+                    b.Property<string>("Hash");
+
+                    b.Property<int>("MaxCombo");
+
+                    b.Property<string>("ModsJson")
+                        .HasColumnName("Mods");
+
+                    b.Property<long?>("OnlineScoreID");
+
+                    b.Property<double?>("PP");
+
+                    b.Property<int>("Rank");
+
+                    b.Property<int>("RulesetID");
+
+                    b.Property<string>("StatisticsJson")
+                        .HasColumnName("Statistics");
+
+                    b.Property<long>("TotalScore");
+
+                    b.Property<long?>("UserID")
+                        .HasColumnName("UserID");
+
+                    b.Property<string>("UserString")
+                        .HasColumnName("User");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("BeatmapInfoID");
+
+                    b.HasIndex("OnlineScoreID")
+                        .IsUnique();
+
+                    b.HasIndex("RulesetID");
+
+                    b.ToTable("ScoreInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Skinning.SkinFileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("FileInfoID");
+
+                    b.Property<string>("Filename")
+                        .IsRequired();
+
+                    b.Property<int>("SkinInfoID");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("FileInfoID");
+
+                    b.HasIndex("SkinInfoID");
+
+                    b.ToTable("SkinFileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Skinning.SkinInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<string>("Creator");
+
+                    b.Property<bool>("DeletePending");
+
+                    b.Property<string>("Hash");
+
+                    b.Property<string>("Name");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("DeletePending");
+
+                    b.HasIndex("Hash")
+                        .IsUnique();
+
+                    b.ToTable("SkinInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapDifficulty", "BaseDifficulty")
+                        .WithMany()
+                        .HasForeignKey("BaseDifficultyID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo", "BeatmapSet")
+                        .WithMany("Beatmaps")
+                        .HasForeignKey("BeatmapSetInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
+                        .WithMany("Beatmaps")
+                        .HasForeignKey("MetadataID");
+
+                    b.HasOne("osu.Game.Rulesets.RulesetInfo", "Ruleset")
+                        .WithMany()
+                        .HasForeignKey("RulesetID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo")
+                        .WithMany("Files")
+                        .HasForeignKey("BeatmapSetInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
+                        .WithMany()
+                        .HasForeignKey("FileInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
+                        .WithMany("BeatmapSets")
+                        .HasForeignKey("MetadataID");
+                });
+
+            modelBuilder.Entity("osu.Game.Configuration.DatabasedSetting", b =>
+                {
+                    b.HasOne("osu.Game.Skinning.SkinInfo")
+                        .WithMany("Settings")
+                        .HasForeignKey("SkinInfoID");
+                });
+
+            modelBuilder.Entity("osu.Game.Scoring.ScoreFileInfo", b =>
+                {
+                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
+                        .WithMany()
+                        .HasForeignKey("FileInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Scoring.ScoreInfo")
+                        .WithMany("Files")
+                        .HasForeignKey("ScoreInfoID");
+                });
+
+            modelBuilder.Entity("osu.Game.Scoring.ScoreInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapInfo", "Beatmap")
+                        .WithMany("Scores")
+                        .HasForeignKey("BeatmapInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Rulesets.RulesetInfo", "Ruleset")
+                        .WithMany()
+                        .HasForeignKey("RulesetID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+
+            modelBuilder.Entity("osu.Game.Skinning.SkinFileInfo", b =>
+                {
+                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
+                        .WithMany()
+                        .HasForeignKey("FileInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Skinning.SkinInfo")
+                        .WithMany("Files")
+                        .HasForeignKey("SkinInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+#pragma warning restore 612, 618
+        }
+    }
+}
diff --git a/osu.Game/Migrations/20200302094919_RefreshVolumeBindings.cs b/osu.Game/Migrations/20200302094919_RefreshVolumeBindings.cs
new file mode 100644
index 0000000000..ec4475971c
--- /dev/null
+++ b/osu.Game/Migrations/20200302094919_RefreshVolumeBindings.cs
@@ -0,0 +1,16 @@
+using Microsoft.EntityFrameworkCore.Migrations;
+
+namespace osu.Game.Migrations
+{
+    public partial class RefreshVolumeBindings : Migration
+    {
+        protected override void Up(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.Sql("DELETE FROM KeyBinding WHERE action in (6,7)");
+        }
+
+        protected override void Down(MigrationBuilder migrationBuilder)
+        {
+        }
+    }
+}
diff --git a/osu.Game/Migrations/20201019224408_AddEpilepsyWarning.Designer.cs b/osu.Game/Migrations/20201019224408_AddEpilepsyWarning.Designer.cs
new file mode 100644
index 0000000000..1c05de832e
--- /dev/null
+++ b/osu.Game/Migrations/20201019224408_AddEpilepsyWarning.Designer.cs
@@ -0,0 +1,508 @@
+// <auto-generated />
+using System;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Infrastructure;
+using Microsoft.EntityFrameworkCore.Migrations;
+using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
+using osu.Game.Database;
+
+namespace osu.Game.Migrations
+{
+    [DbContext(typeof(OsuDbContext))]
+    [Migration("20201019224408_AddEpilepsyWarning")]
+    partial class AddEpilepsyWarning
+    {
+        protected override void BuildTargetModel(ModelBuilder modelBuilder)
+        {
+#pragma warning disable 612, 618
+            modelBuilder
+                .HasAnnotation("ProductVersion", "2.2.6-servicing-10079");
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapDifficulty", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<float>("ApproachRate");
+
+                    b.Property<float>("CircleSize");
+
+                    b.Property<float>("DrainRate");
+
+                    b.Property<float>("OverallDifficulty");
+
+                    b.Property<double>("SliderMultiplier");
+
+                    b.Property<double>("SliderTickRate");
+
+                    b.HasKey("ID");
+
+                    b.ToTable("BeatmapDifficulty");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<double>("AudioLeadIn");
+
+                    b.Property<double>("BPM");
+
+                    b.Property<int>("BaseDifficultyID");
+
+                    b.Property<int>("BeatDivisor");
+
+                    b.Property<int>("BeatmapSetInfoID");
+
+                    b.Property<bool>("Countdown");
+
+                    b.Property<double>("DistanceSpacing");
+
+                    b.Property<bool>("EpilepsyWarning");
+
+                    b.Property<int>("GridSize");
+
+                    b.Property<string>("Hash");
+
+                    b.Property<bool>("Hidden");
+
+                    b.Property<double>("Length");
+
+                    b.Property<bool>("LetterboxInBreaks");
+
+                    b.Property<string>("MD5Hash");
+
+                    b.Property<int?>("MetadataID");
+
+                    b.Property<int?>("OnlineBeatmapID");
+
+                    b.Property<string>("Path");
+
+                    b.Property<int>("RulesetID");
+
+                    b.Property<bool>("SpecialStyle");
+
+                    b.Property<float>("StackLeniency");
+
+                    b.Property<double>("StarDifficulty");
+
+                    b.Property<int>("Status");
+
+                    b.Property<string>("StoredBookmarks");
+
+                    b.Property<double>("TimelineZoom");
+
+                    b.Property<string>("Version");
+
+                    b.Property<bool>("WidescreenStoryboard");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("BaseDifficultyID");
+
+                    b.HasIndex("BeatmapSetInfoID");
+
+                    b.HasIndex("Hash");
+
+                    b.HasIndex("MD5Hash");
+
+                    b.HasIndex("MetadataID");
+
+                    b.HasIndex("OnlineBeatmapID")
+                        .IsUnique();
+
+                    b.HasIndex("RulesetID");
+
+                    b.ToTable("BeatmapInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapMetadata", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<string>("Artist");
+
+                    b.Property<string>("ArtistUnicode");
+
+                    b.Property<string>("AudioFile");
+
+                    b.Property<string>("AuthorString")
+                        .HasColumnName("Author");
+
+                    b.Property<string>("BackgroundFile");
+
+                    b.Property<int>("PreviewTime");
+
+                    b.Property<string>("Source");
+
+                    b.Property<string>("Tags");
+
+                    b.Property<string>("Title");
+
+                    b.Property<string>("TitleUnicode");
+
+                    b.Property<string>("VideoFile");
+
+                    b.HasKey("ID");
+
+                    b.ToTable("BeatmapMetadata");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("BeatmapSetInfoID");
+
+                    b.Property<int>("FileInfoID");
+
+                    b.Property<string>("Filename")
+                        .IsRequired();
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("BeatmapSetInfoID");
+
+                    b.HasIndex("FileInfoID");
+
+                    b.ToTable("BeatmapSetFileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<DateTimeOffset>("DateAdded");
+
+                    b.Property<bool>("DeletePending");
+
+                    b.Property<string>("Hash");
+
+                    b.Property<int?>("MetadataID");
+
+                    b.Property<int?>("OnlineBeatmapSetID");
+
+                    b.Property<bool>("Protected");
+
+                    b.Property<int>("Status");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("DeletePending");
+
+                    b.HasIndex("Hash")
+                        .IsUnique();
+
+                    b.HasIndex("MetadataID");
+
+                    b.HasIndex("OnlineBeatmapSetID")
+                        .IsUnique();
+
+                    b.ToTable("BeatmapSetInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Configuration.DatabasedSetting", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<string>("Key")
+                        .HasColumnName("Key");
+
+                    b.Property<int?>("RulesetID");
+
+                    b.Property<int?>("SkinInfoID");
+
+                    b.Property<string>("StringValue")
+                        .HasColumnName("Value");
+
+                    b.Property<int?>("Variant");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("SkinInfoID");
+
+                    b.HasIndex("RulesetID", "Variant");
+
+                    b.ToTable("Settings");
+                });
+
+            modelBuilder.Entity("osu.Game.IO.FileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<string>("Hash");
+
+                    b.Property<int>("ReferenceCount");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("Hash")
+                        .IsUnique();
+
+                    b.HasIndex("ReferenceCount");
+
+                    b.ToTable("FileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Input.Bindings.DatabasedKeyBinding", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("IntAction")
+                        .HasColumnName("Action");
+
+                    b.Property<string>("KeysString")
+                        .HasColumnName("Keys");
+
+                    b.Property<int?>("RulesetID");
+
+                    b.Property<int?>("Variant");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("IntAction");
+
+                    b.HasIndex("RulesetID", "Variant");
+
+                    b.ToTable("KeyBinding");
+                });
+
+            modelBuilder.Entity("osu.Game.Rulesets.RulesetInfo", b =>
+                {
+                    b.Property<int?>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<bool>("Available");
+
+                    b.Property<string>("InstantiationInfo");
+
+                    b.Property<string>("Name");
+
+                    b.Property<string>("ShortName");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("Available");
+
+                    b.HasIndex("ShortName")
+                        .IsUnique();
+
+                    b.ToTable("RulesetInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Scoring.ScoreFileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("FileInfoID");
+
+                    b.Property<string>("Filename")
+                        .IsRequired();
+
+                    b.Property<int?>("ScoreInfoID");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("FileInfoID");
+
+                    b.HasIndex("ScoreInfoID");
+
+                    b.ToTable("ScoreFileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Scoring.ScoreInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<double>("Accuracy")
+                        .HasColumnType("DECIMAL(1,4)");
+
+                    b.Property<int>("BeatmapInfoID");
+
+                    b.Property<int>("Combo");
+
+                    b.Property<DateTimeOffset>("Date");
+
+                    b.Property<bool>("DeletePending");
+
+                    b.Property<string>("Hash");
+
+                    b.Property<int>("MaxCombo");
+
+                    b.Property<string>("ModsJson")
+                        .HasColumnName("Mods");
+
+                    b.Property<long?>("OnlineScoreID");
+
+                    b.Property<double?>("PP");
+
+                    b.Property<int>("Rank");
+
+                    b.Property<int>("RulesetID");
+
+                    b.Property<string>("StatisticsJson")
+                        .HasColumnName("Statistics");
+
+                    b.Property<long>("TotalScore");
+
+                    b.Property<long?>("UserID")
+                        .HasColumnName("UserID");
+
+                    b.Property<string>("UserString")
+                        .HasColumnName("User");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("BeatmapInfoID");
+
+                    b.HasIndex("OnlineScoreID")
+                        .IsUnique();
+
+                    b.HasIndex("RulesetID");
+
+                    b.ToTable("ScoreInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Skinning.SkinFileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("FileInfoID");
+
+                    b.Property<string>("Filename")
+                        .IsRequired();
+
+                    b.Property<int>("SkinInfoID");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("FileInfoID");
+
+                    b.HasIndex("SkinInfoID");
+
+                    b.ToTable("SkinFileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Skinning.SkinInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<string>("Creator");
+
+                    b.Property<bool>("DeletePending");
+
+                    b.Property<string>("Hash");
+
+                    b.Property<string>("Name");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("DeletePending");
+
+                    b.HasIndex("Hash")
+                        .IsUnique();
+
+                    b.ToTable("SkinInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapDifficulty", "BaseDifficulty")
+                        .WithMany()
+                        .HasForeignKey("BaseDifficultyID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo", "BeatmapSet")
+                        .WithMany("Beatmaps")
+                        .HasForeignKey("BeatmapSetInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
+                        .WithMany("Beatmaps")
+                        .HasForeignKey("MetadataID");
+
+                    b.HasOne("osu.Game.Rulesets.RulesetInfo", "Ruleset")
+                        .WithMany()
+                        .HasForeignKey("RulesetID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo")
+                        .WithMany("Files")
+                        .HasForeignKey("BeatmapSetInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
+                        .WithMany()
+                        .HasForeignKey("FileInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
+                        .WithMany("BeatmapSets")
+                        .HasForeignKey("MetadataID");
+                });
+
+            modelBuilder.Entity("osu.Game.Configuration.DatabasedSetting", b =>
+                {
+                    b.HasOne("osu.Game.Skinning.SkinInfo")
+                        .WithMany("Settings")
+                        .HasForeignKey("SkinInfoID");
+                });
+
+            modelBuilder.Entity("osu.Game.Scoring.ScoreFileInfo", b =>
+                {
+                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
+                        .WithMany()
+                        .HasForeignKey("FileInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Scoring.ScoreInfo")
+                        .WithMany("Files")
+                        .HasForeignKey("ScoreInfoID");
+                });
+
+            modelBuilder.Entity("osu.Game.Scoring.ScoreInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapInfo", "Beatmap")
+                        .WithMany("Scores")
+                        .HasForeignKey("BeatmapInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Rulesets.RulesetInfo", "Ruleset")
+                        .WithMany()
+                        .HasForeignKey("RulesetID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+
+            modelBuilder.Entity("osu.Game.Skinning.SkinFileInfo", b =>
+                {
+                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
+                        .WithMany()
+                        .HasForeignKey("FileInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Skinning.SkinInfo")
+                        .WithMany("Files")
+                        .HasForeignKey("SkinInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+#pragma warning restore 612, 618
+        }
+    }
+}
diff --git a/osu.Game/Migrations/20201019224408_AddEpilepsyWarning.cs b/osu.Game/Migrations/20201019224408_AddEpilepsyWarning.cs
new file mode 100644
index 0000000000..be6968aa5d
--- /dev/null
+++ b/osu.Game/Migrations/20201019224408_AddEpilepsyWarning.cs
@@ -0,0 +1,23 @@
+using Microsoft.EntityFrameworkCore.Migrations;
+
+namespace osu.Game.Migrations
+{
+    public partial class AddEpilepsyWarning : Migration
+    {
+        protected override void Up(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.AddColumn<bool>(
+                name: "EpilepsyWarning",
+                table: "BeatmapInfo",
+                nullable: false,
+                defaultValue: false);
+        }
+
+        protected override void Down(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.DropColumn(
+                name: "EpilepsyWarning",
+                table: "BeatmapInfo");
+        }
+    }
+}
diff --git a/osu.Game/Migrations/20210412045700_RefreshVolumeBindingsAgain.Designer.cs b/osu.Game/Migrations/20210412045700_RefreshVolumeBindingsAgain.Designer.cs
new file mode 100644
index 0000000000..2c100d39b9
--- /dev/null
+++ b/osu.Game/Migrations/20210412045700_RefreshVolumeBindingsAgain.Designer.cs
@@ -0,0 +1,506 @@
+// <auto-generated />
+using System;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Infrastructure;
+using Microsoft.EntityFrameworkCore.Migrations;
+using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
+using osu.Game.Database;
+
+namespace osu.Game.Migrations
+{
+    [DbContext(typeof(OsuDbContext))]
+    [Migration("20210412045700_RefreshVolumeBindingsAgain")]
+    partial class RefreshVolumeBindingsAgain
+    {
+        protected override void BuildTargetModel(ModelBuilder modelBuilder)
+        {
+#pragma warning disable 612, 618
+            modelBuilder
+                .HasAnnotation("ProductVersion", "2.2.6-servicing-10079");
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapDifficulty", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<float>("ApproachRate");
+
+                    b.Property<float>("CircleSize");
+
+                    b.Property<float>("DrainRate");
+
+                    b.Property<float>("OverallDifficulty");
+
+                    b.Property<double>("SliderMultiplier");
+
+                    b.Property<double>("SliderTickRate");
+
+                    b.HasKey("ID");
+
+                    b.ToTable("BeatmapDifficulty");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<double>("AudioLeadIn");
+
+                    b.Property<double>("BPM");
+
+                    b.Property<int>("BaseDifficultyID");
+
+                    b.Property<int>("BeatDivisor");
+
+                    b.Property<int>("BeatmapSetInfoID");
+
+                    b.Property<bool>("Countdown");
+
+                    b.Property<double>("DistanceSpacing");
+
+                    b.Property<int>("GridSize");
+
+                    b.Property<string>("Hash");
+
+                    b.Property<bool>("Hidden");
+
+                    b.Property<double>("Length");
+
+                    b.Property<bool>("LetterboxInBreaks");
+
+                    b.Property<string>("MD5Hash");
+
+                    b.Property<int?>("MetadataID");
+
+                    b.Property<int?>("OnlineBeatmapID");
+
+                    b.Property<string>("Path");
+
+                    b.Property<int>("RulesetID");
+
+                    b.Property<bool>("SpecialStyle");
+
+                    b.Property<float>("StackLeniency");
+
+                    b.Property<double>("StarDifficulty");
+
+                    b.Property<int>("Status");
+
+                    b.Property<string>("StoredBookmarks");
+
+                    b.Property<double>("TimelineZoom");
+
+                    b.Property<string>("Version");
+
+                    b.Property<bool>("WidescreenStoryboard");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("BaseDifficultyID");
+
+                    b.HasIndex("BeatmapSetInfoID");
+
+                    b.HasIndex("Hash");
+
+                    b.HasIndex("MD5Hash");
+
+                    b.HasIndex("MetadataID");
+
+                    b.HasIndex("OnlineBeatmapID")
+                        .IsUnique();
+
+                    b.HasIndex("RulesetID");
+
+                    b.ToTable("BeatmapInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapMetadata", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<string>("Artist");
+
+                    b.Property<string>("ArtistUnicode");
+
+                    b.Property<string>("AudioFile");
+
+                    b.Property<string>("AuthorString")
+                        .HasColumnName("Author");
+
+                    b.Property<string>("BackgroundFile");
+
+                    b.Property<int>("PreviewTime");
+
+                    b.Property<string>("Source");
+
+                    b.Property<string>("Tags");
+
+                    b.Property<string>("Title");
+
+                    b.Property<string>("TitleUnicode");
+
+                    b.Property<string>("VideoFile");
+
+                    b.HasKey("ID");
+
+                    b.ToTable("BeatmapMetadata");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("BeatmapSetInfoID");
+
+                    b.Property<int>("FileInfoID");
+
+                    b.Property<string>("Filename")
+                        .IsRequired();
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("BeatmapSetInfoID");
+
+                    b.HasIndex("FileInfoID");
+
+                    b.ToTable("BeatmapSetFileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<DateTimeOffset>("DateAdded");
+
+                    b.Property<bool>("DeletePending");
+
+                    b.Property<string>("Hash");
+
+                    b.Property<int?>("MetadataID");
+
+                    b.Property<int?>("OnlineBeatmapSetID");
+
+                    b.Property<bool>("Protected");
+
+                    b.Property<int>("Status");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("DeletePending");
+
+                    b.HasIndex("Hash")
+                        .IsUnique();
+
+                    b.HasIndex("MetadataID");
+
+                    b.HasIndex("OnlineBeatmapSetID")
+                        .IsUnique();
+
+                    b.ToTable("BeatmapSetInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Configuration.DatabasedSetting", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<string>("Key")
+                        .HasColumnName("Key");
+
+                    b.Property<int?>("RulesetID");
+
+                    b.Property<int?>("SkinInfoID");
+
+                    b.Property<string>("StringValue")
+                        .HasColumnName("Value");
+
+                    b.Property<int?>("Variant");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("SkinInfoID");
+
+                    b.HasIndex("RulesetID", "Variant");
+
+                    b.ToTable("Settings");
+                });
+
+            modelBuilder.Entity("osu.Game.IO.FileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<string>("Hash");
+
+                    b.Property<int>("ReferenceCount");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("Hash")
+                        .IsUnique();
+
+                    b.HasIndex("ReferenceCount");
+
+                    b.ToTable("FileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Input.Bindings.DatabasedKeyBinding", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("IntAction")
+                        .HasColumnName("Action");
+
+                    b.Property<string>("KeysString")
+                        .HasColumnName("Keys");
+
+                    b.Property<int?>("RulesetID");
+
+                    b.Property<int?>("Variant");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("IntAction");
+
+                    b.HasIndex("RulesetID", "Variant");
+
+                    b.ToTable("KeyBinding");
+                });
+
+            modelBuilder.Entity("osu.Game.Rulesets.RulesetInfo", b =>
+                {
+                    b.Property<int?>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<bool>("Available");
+
+                    b.Property<string>("InstantiationInfo");
+
+                    b.Property<string>("Name");
+
+                    b.Property<string>("ShortName");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("Available");
+
+                    b.HasIndex("ShortName")
+                        .IsUnique();
+
+                    b.ToTable("RulesetInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Scoring.ScoreFileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("FileInfoID");
+
+                    b.Property<string>("Filename")
+                        .IsRequired();
+
+                    b.Property<int?>("ScoreInfoID");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("FileInfoID");
+
+                    b.HasIndex("ScoreInfoID");
+
+                    b.ToTable("ScoreFileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Scoring.ScoreInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<double>("Accuracy")
+                        .HasColumnType("DECIMAL(1,4)");
+
+                    b.Property<int>("BeatmapInfoID");
+
+                    b.Property<int>("Combo");
+
+                    b.Property<DateTimeOffset>("Date");
+
+                    b.Property<bool>("DeletePending");
+
+                    b.Property<string>("Hash");
+
+                    b.Property<int>("MaxCombo");
+
+                    b.Property<string>("ModsJson")
+                        .HasColumnName("Mods");
+
+                    b.Property<long?>("OnlineScoreID");
+
+                    b.Property<double?>("PP");
+
+                    b.Property<int>("Rank");
+
+                    b.Property<int>("RulesetID");
+
+                    b.Property<string>("StatisticsJson")
+                        .HasColumnName("Statistics");
+
+                    b.Property<long>("TotalScore");
+
+                    b.Property<long?>("UserID")
+                        .HasColumnName("UserID");
+
+                    b.Property<string>("UserString")
+                        .HasColumnName("User");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("BeatmapInfoID");
+
+                    b.HasIndex("OnlineScoreID")
+                        .IsUnique();
+
+                    b.HasIndex("RulesetID");
+
+                    b.ToTable("ScoreInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Skinning.SkinFileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("FileInfoID");
+
+                    b.Property<string>("Filename")
+                        .IsRequired();
+
+                    b.Property<int>("SkinInfoID");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("FileInfoID");
+
+                    b.HasIndex("SkinInfoID");
+
+                    b.ToTable("SkinFileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Skinning.SkinInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<string>("Creator");
+
+                    b.Property<bool>("DeletePending");
+
+                    b.Property<string>("Hash");
+
+                    b.Property<string>("Name");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("DeletePending");
+
+                    b.HasIndex("Hash")
+                        .IsUnique();
+
+                    b.ToTable("SkinInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapDifficulty", "BaseDifficulty")
+                        .WithMany()
+                        .HasForeignKey("BaseDifficultyID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo", "BeatmapSet")
+                        .WithMany("Beatmaps")
+                        .HasForeignKey("BeatmapSetInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
+                        .WithMany("Beatmaps")
+                        .HasForeignKey("MetadataID");
+
+                    b.HasOne("osu.Game.Rulesets.RulesetInfo", "Ruleset")
+                        .WithMany()
+                        .HasForeignKey("RulesetID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo")
+                        .WithMany("Files")
+                        .HasForeignKey("BeatmapSetInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
+                        .WithMany()
+                        .HasForeignKey("FileInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
+                        .WithMany("BeatmapSets")
+                        .HasForeignKey("MetadataID");
+                });
+
+            modelBuilder.Entity("osu.Game.Configuration.DatabasedSetting", b =>
+                {
+                    b.HasOne("osu.Game.Skinning.SkinInfo")
+                        .WithMany("Settings")
+                        .HasForeignKey("SkinInfoID");
+                });
+
+            modelBuilder.Entity("osu.Game.Scoring.ScoreFileInfo", b =>
+                {
+                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
+                        .WithMany()
+                        .HasForeignKey("FileInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Scoring.ScoreInfo")
+                        .WithMany("Files")
+                        .HasForeignKey("ScoreInfoID");
+                });
+
+            modelBuilder.Entity("osu.Game.Scoring.ScoreInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapInfo", "Beatmap")
+                        .WithMany("Scores")
+                        .HasForeignKey("BeatmapInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Rulesets.RulesetInfo", "Ruleset")
+                        .WithMany()
+                        .HasForeignKey("RulesetID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+
+            modelBuilder.Entity("osu.Game.Skinning.SkinFileInfo", b =>
+                {
+                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
+                        .WithMany()
+                        .HasForeignKey("FileInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Skinning.SkinInfo")
+                        .WithMany("Files")
+                        .HasForeignKey("SkinInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+#pragma warning restore 612, 618
+        }
+    }
+}
diff --git a/osu.Game/Migrations/20210412045700_RefreshVolumeBindingsAgain.cs b/osu.Game/Migrations/20210412045700_RefreshVolumeBindingsAgain.cs
new file mode 100644
index 0000000000..155d6670a8
--- /dev/null
+++ b/osu.Game/Migrations/20210412045700_RefreshVolumeBindingsAgain.cs
@@ -0,0 +1,16 @@
+using Microsoft.EntityFrameworkCore.Migrations;
+
+namespace osu.Game.Migrations
+{
+    public partial class RefreshVolumeBindingsAgain : Migration
+    {
+        protected override void Up(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.Sql("DELETE FROM KeyBinding WHERE action in (6,7)");
+        }
+
+        protected override void Down(MigrationBuilder migrationBuilder)
+        {
+        }
+    }
+}
diff --git a/osu.Game/Migrations/20210511060743_AddSkinInstantiationInfo.Designer.cs b/osu.Game/Migrations/20210511060743_AddSkinInstantiationInfo.Designer.cs
new file mode 100644
index 0000000000..b808c648da
--- /dev/null
+++ b/osu.Game/Migrations/20210511060743_AddSkinInstantiationInfo.Designer.cs
@@ -0,0 +1,508 @@
+// <auto-generated />
+using System;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Infrastructure;
+using Microsoft.EntityFrameworkCore.Migrations;
+using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
+using osu.Game.Database;
+
+namespace osu.Game.Migrations
+{
+    [DbContext(typeof(OsuDbContext))]
+    [Migration("20210511060743_AddSkinInstantiationInfo")]
+    partial class AddSkinInstantiationInfo
+    {
+        protected override void BuildTargetModel(ModelBuilder modelBuilder)
+        {
+#pragma warning disable 612, 618
+            modelBuilder
+                .HasAnnotation("ProductVersion", "2.2.6-servicing-10079");
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapDifficulty", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<float>("ApproachRate");
+
+                    b.Property<float>("CircleSize");
+
+                    b.Property<float>("DrainRate");
+
+                    b.Property<float>("OverallDifficulty");
+
+                    b.Property<double>("SliderMultiplier");
+
+                    b.Property<double>("SliderTickRate");
+
+                    b.HasKey("ID");
+
+                    b.ToTable("BeatmapDifficulty");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<double>("AudioLeadIn");
+
+                    b.Property<double>("BPM");
+
+                    b.Property<int>("BaseDifficultyID");
+
+                    b.Property<int>("BeatDivisor");
+
+                    b.Property<int>("BeatmapSetInfoID");
+
+                    b.Property<bool>("Countdown");
+
+                    b.Property<double>("DistanceSpacing");
+
+                    b.Property<bool>("EpilepsyWarning");
+
+                    b.Property<int>("GridSize");
+
+                    b.Property<string>("Hash");
+
+                    b.Property<bool>("Hidden");
+
+                    b.Property<double>("Length");
+
+                    b.Property<bool>("LetterboxInBreaks");
+
+                    b.Property<string>("MD5Hash");
+
+                    b.Property<int?>("MetadataID");
+
+                    b.Property<int?>("OnlineBeatmapID");
+
+                    b.Property<string>("Path");
+
+                    b.Property<int>("RulesetID");
+
+                    b.Property<bool>("SpecialStyle");
+
+                    b.Property<float>("StackLeniency");
+
+                    b.Property<double>("StarDifficulty");
+
+                    b.Property<int>("Status");
+
+                    b.Property<string>("StoredBookmarks");
+
+                    b.Property<double>("TimelineZoom");
+
+                    b.Property<string>("Version");
+
+                    b.Property<bool>("WidescreenStoryboard");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("BaseDifficultyID");
+
+                    b.HasIndex("BeatmapSetInfoID");
+
+                    b.HasIndex("Hash");
+
+                    b.HasIndex("MD5Hash");
+
+                    b.HasIndex("MetadataID");
+
+                    b.HasIndex("OnlineBeatmapID")
+                        .IsUnique();
+
+                    b.HasIndex("RulesetID");
+
+                    b.ToTable("BeatmapInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapMetadata", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<string>("Artist");
+
+                    b.Property<string>("ArtistUnicode");
+
+                    b.Property<string>("AudioFile");
+
+                    b.Property<string>("AuthorString")
+                        .HasColumnName("Author");
+
+                    b.Property<string>("BackgroundFile");
+
+                    b.Property<int>("PreviewTime");
+
+                    b.Property<string>("Source");
+
+                    b.Property<string>("Tags");
+
+                    b.Property<string>("Title");
+
+                    b.Property<string>("TitleUnicode");
+
+                    b.HasKey("ID");
+
+                    b.ToTable("BeatmapMetadata");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("BeatmapSetInfoID");
+
+                    b.Property<int>("FileInfoID");
+
+                    b.Property<string>("Filename")
+                        .IsRequired();
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("BeatmapSetInfoID");
+
+                    b.HasIndex("FileInfoID");
+
+                    b.ToTable("BeatmapSetFileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<DateTimeOffset>("DateAdded");
+
+                    b.Property<bool>("DeletePending");
+
+                    b.Property<string>("Hash");
+
+                    b.Property<int?>("MetadataID");
+
+                    b.Property<int?>("OnlineBeatmapSetID");
+
+                    b.Property<bool>("Protected");
+
+                    b.Property<int>("Status");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("DeletePending");
+
+                    b.HasIndex("Hash")
+                        .IsUnique();
+
+                    b.HasIndex("MetadataID");
+
+                    b.HasIndex("OnlineBeatmapSetID")
+                        .IsUnique();
+
+                    b.ToTable("BeatmapSetInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Configuration.DatabasedSetting", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<string>("Key")
+                        .HasColumnName("Key");
+
+                    b.Property<int?>("RulesetID");
+
+                    b.Property<int?>("SkinInfoID");
+
+                    b.Property<string>("StringValue")
+                        .HasColumnName("Value");
+
+                    b.Property<int?>("Variant");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("SkinInfoID");
+
+                    b.HasIndex("RulesetID", "Variant");
+
+                    b.ToTable("Settings");
+                });
+
+            modelBuilder.Entity("osu.Game.IO.FileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<string>("Hash");
+
+                    b.Property<int>("ReferenceCount");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("Hash")
+                        .IsUnique();
+
+                    b.HasIndex("ReferenceCount");
+
+                    b.ToTable("FileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Input.Bindings.DatabasedKeyBinding", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("IntAction")
+                        .HasColumnName("Action");
+
+                    b.Property<string>("KeysString")
+                        .HasColumnName("Keys");
+
+                    b.Property<int?>("RulesetID");
+
+                    b.Property<int?>("Variant");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("IntAction");
+
+                    b.HasIndex("RulesetID", "Variant");
+
+                    b.ToTable("KeyBinding");
+                });
+
+            modelBuilder.Entity("osu.Game.Rulesets.RulesetInfo", b =>
+                {
+                    b.Property<int?>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<bool>("Available");
+
+                    b.Property<string>("InstantiationInfo");
+
+                    b.Property<string>("Name");
+
+                    b.Property<string>("ShortName");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("Available");
+
+                    b.HasIndex("ShortName")
+                        .IsUnique();
+
+                    b.ToTable("RulesetInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Scoring.ScoreFileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("FileInfoID");
+
+                    b.Property<string>("Filename")
+                        .IsRequired();
+
+                    b.Property<int?>("ScoreInfoID");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("FileInfoID");
+
+                    b.HasIndex("ScoreInfoID");
+
+                    b.ToTable("ScoreFileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Scoring.ScoreInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<double>("Accuracy")
+                        .HasColumnType("DECIMAL(1,4)");
+
+                    b.Property<int>("BeatmapInfoID");
+
+                    b.Property<int>("Combo");
+
+                    b.Property<DateTimeOffset>("Date");
+
+                    b.Property<bool>("DeletePending");
+
+                    b.Property<string>("Hash");
+
+                    b.Property<int>("MaxCombo");
+
+                    b.Property<string>("ModsJson")
+                        .HasColumnName("Mods");
+
+                    b.Property<long?>("OnlineScoreID");
+
+                    b.Property<double?>("PP");
+
+                    b.Property<int>("Rank");
+
+                    b.Property<int>("RulesetID");
+
+                    b.Property<string>("StatisticsJson")
+                        .HasColumnName("Statistics");
+
+                    b.Property<long>("TotalScore");
+
+                    b.Property<int?>("UserID")
+                        .HasColumnName("UserID");
+
+                    b.Property<string>("UserString")
+                        .HasColumnName("User");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("BeatmapInfoID");
+
+                    b.HasIndex("OnlineScoreID")
+                        .IsUnique();
+
+                    b.HasIndex("RulesetID");
+
+                    b.ToTable("ScoreInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Skinning.SkinFileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("FileInfoID");
+
+                    b.Property<string>("Filename")
+                        .IsRequired();
+
+                    b.Property<int>("SkinInfoID");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("FileInfoID");
+
+                    b.HasIndex("SkinInfoID");
+
+                    b.ToTable("SkinFileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Skinning.SkinInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<string>("Creator");
+
+                    b.Property<bool>("DeletePending");
+
+                    b.Property<string>("Hash");
+
+                    b.Property<string>("InstantiationInfo");
+
+                    b.Property<string>("Name");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("DeletePending");
+
+                    b.HasIndex("Hash")
+                        .IsUnique();
+
+                    b.ToTable("SkinInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapDifficulty", "BaseDifficulty")
+                        .WithMany()
+                        .HasForeignKey("BaseDifficultyID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo", "BeatmapSet")
+                        .WithMany("Beatmaps")
+                        .HasForeignKey("BeatmapSetInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
+                        .WithMany("Beatmaps")
+                        .HasForeignKey("MetadataID");
+
+                    b.HasOne("osu.Game.Rulesets.RulesetInfo", "Ruleset")
+                        .WithMany()
+                        .HasForeignKey("RulesetID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo")
+                        .WithMany("Files")
+                        .HasForeignKey("BeatmapSetInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
+                        .WithMany()
+                        .HasForeignKey("FileInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
+                        .WithMany("BeatmapSets")
+                        .HasForeignKey("MetadataID");
+                });
+
+            modelBuilder.Entity("osu.Game.Configuration.DatabasedSetting", b =>
+                {
+                    b.HasOne("osu.Game.Skinning.SkinInfo")
+                        .WithMany("Settings")
+                        .HasForeignKey("SkinInfoID");
+                });
+
+            modelBuilder.Entity("osu.Game.Scoring.ScoreFileInfo", b =>
+                {
+                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
+                        .WithMany()
+                        .HasForeignKey("FileInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Scoring.ScoreInfo")
+                        .WithMany("Files")
+                        .HasForeignKey("ScoreInfoID");
+                });
+
+            modelBuilder.Entity("osu.Game.Scoring.ScoreInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapInfo", "Beatmap")
+                        .WithMany("Scores")
+                        .HasForeignKey("BeatmapInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Rulesets.RulesetInfo", "Ruleset")
+                        .WithMany()
+                        .HasForeignKey("RulesetID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+
+            modelBuilder.Entity("osu.Game.Skinning.SkinFileInfo", b =>
+                {
+                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
+                        .WithMany()
+                        .HasForeignKey("FileInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Skinning.SkinInfo")
+                        .WithMany("Files")
+                        .HasForeignKey("SkinInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+#pragma warning restore 612, 618
+        }
+    }
+}
diff --git a/osu.Game/Migrations/20210511060743_AddSkinInstantiationInfo.cs b/osu.Game/Migrations/20210511060743_AddSkinInstantiationInfo.cs
new file mode 100644
index 0000000000..1d5b0769a4
--- /dev/null
+++ b/osu.Game/Migrations/20210511060743_AddSkinInstantiationInfo.cs
@@ -0,0 +1,22 @@
+using Microsoft.EntityFrameworkCore.Migrations;
+
+namespace osu.Game.Migrations
+{
+    public partial class AddSkinInstantiationInfo : Migration
+    {
+        protected override void Up(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.AddColumn<string>(
+                name: "InstantiationInfo",
+                table: "SkinInfo",
+                nullable: true);
+        }
+
+        protected override void Down(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.DropColumn(
+                name: "InstantiationInfo",
+                table: "SkinInfo");
+        }
+    }
+}
diff --git a/osu.Game/Migrations/20210514062639_AddAuthorIdToBeatmapMetadata.Designer.cs b/osu.Game/Migrations/20210514062639_AddAuthorIdToBeatmapMetadata.Designer.cs
new file mode 100644
index 0000000000..89bab3a0fa
--- /dev/null
+++ b/osu.Game/Migrations/20210514062639_AddAuthorIdToBeatmapMetadata.Designer.cs
@@ -0,0 +1,511 @@
+// <auto-generated />
+using System;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Infrastructure;
+using Microsoft.EntityFrameworkCore.Migrations;
+using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
+using osu.Game.Database;
+
+namespace osu.Game.Migrations
+{
+    [DbContext(typeof(OsuDbContext))]
+    [Migration("20210514062639_AddAuthorIdToBeatmapMetadata")]
+    partial class AddAuthorIdToBeatmapMetadata
+    {
+        protected override void BuildTargetModel(ModelBuilder modelBuilder)
+        {
+#pragma warning disable 612, 618
+            modelBuilder
+                .HasAnnotation("ProductVersion", "2.2.6-servicing-10079");
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapDifficulty", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<float>("ApproachRate");
+
+                    b.Property<float>("CircleSize");
+
+                    b.Property<float>("DrainRate");
+
+                    b.Property<float>("OverallDifficulty");
+
+                    b.Property<double>("SliderMultiplier");
+
+                    b.Property<double>("SliderTickRate");
+
+                    b.HasKey("ID");
+
+                    b.ToTable("BeatmapDifficulty");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<double>("AudioLeadIn");
+
+                    b.Property<double>("BPM");
+
+                    b.Property<int>("BaseDifficultyID");
+
+                    b.Property<int>("BeatDivisor");
+
+                    b.Property<int>("BeatmapSetInfoID");
+
+                    b.Property<bool>("Countdown");
+
+                    b.Property<double>("DistanceSpacing");
+
+                    b.Property<bool>("EpilepsyWarning");
+
+                    b.Property<int>("GridSize");
+
+                    b.Property<string>("Hash");
+
+                    b.Property<bool>("Hidden");
+
+                    b.Property<double>("Length");
+
+                    b.Property<bool>("LetterboxInBreaks");
+
+                    b.Property<string>("MD5Hash");
+
+                    b.Property<int?>("MetadataID");
+
+                    b.Property<int?>("OnlineBeatmapID");
+
+                    b.Property<string>("Path");
+
+                    b.Property<int>("RulesetID");
+
+                    b.Property<bool>("SpecialStyle");
+
+                    b.Property<float>("StackLeniency");
+
+                    b.Property<double>("StarDifficulty");
+
+                    b.Property<int>("Status");
+
+                    b.Property<string>("StoredBookmarks");
+
+                    b.Property<double>("TimelineZoom");
+
+                    b.Property<string>("Version");
+
+                    b.Property<bool>("WidescreenStoryboard");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("BaseDifficultyID");
+
+                    b.HasIndex("BeatmapSetInfoID");
+
+                    b.HasIndex("Hash");
+
+                    b.HasIndex("MD5Hash");
+
+                    b.HasIndex("MetadataID");
+
+                    b.HasIndex("OnlineBeatmapID")
+                        .IsUnique();
+
+                    b.HasIndex("RulesetID");
+
+                    b.ToTable("BeatmapInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapMetadata", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<string>("Artist");
+
+                    b.Property<string>("ArtistUnicode");
+
+                    b.Property<string>("AudioFile");
+
+                    b.Property<int>("AuthorID")
+                        .HasColumnName("AuthorID");
+
+                    b.Property<string>("AuthorString")
+                        .HasColumnName("Author");
+
+                    b.Property<string>("BackgroundFile");
+
+                    b.Property<int>("PreviewTime");
+
+                    b.Property<string>("Source");
+
+                    b.Property<string>("Tags");
+
+                    b.Property<string>("Title");
+
+                    b.Property<string>("TitleUnicode");
+
+                    b.HasKey("ID");
+
+                    b.ToTable("BeatmapMetadata");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("BeatmapSetInfoID");
+
+                    b.Property<int>("FileInfoID");
+
+                    b.Property<string>("Filename")
+                        .IsRequired();
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("BeatmapSetInfoID");
+
+                    b.HasIndex("FileInfoID");
+
+                    b.ToTable("BeatmapSetFileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<DateTimeOffset>("DateAdded");
+
+                    b.Property<bool>("DeletePending");
+
+                    b.Property<string>("Hash");
+
+                    b.Property<int?>("MetadataID");
+
+                    b.Property<int?>("OnlineBeatmapSetID");
+
+                    b.Property<bool>("Protected");
+
+                    b.Property<int>("Status");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("DeletePending");
+
+                    b.HasIndex("Hash")
+                        .IsUnique();
+
+                    b.HasIndex("MetadataID");
+
+                    b.HasIndex("OnlineBeatmapSetID")
+                        .IsUnique();
+
+                    b.ToTable("BeatmapSetInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Configuration.DatabasedSetting", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<string>("Key")
+                        .HasColumnName("Key");
+
+                    b.Property<int?>("RulesetID");
+
+                    b.Property<int?>("SkinInfoID");
+
+                    b.Property<string>("StringValue")
+                        .HasColumnName("Value");
+
+                    b.Property<int?>("Variant");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("SkinInfoID");
+
+                    b.HasIndex("RulesetID", "Variant");
+
+                    b.ToTable("Settings");
+                });
+
+            modelBuilder.Entity("osu.Game.IO.FileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<string>("Hash");
+
+                    b.Property<int>("ReferenceCount");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("Hash")
+                        .IsUnique();
+
+                    b.HasIndex("ReferenceCount");
+
+                    b.ToTable("FileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Input.Bindings.DatabasedKeyBinding", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("IntAction")
+                        .HasColumnName("Action");
+
+                    b.Property<string>("KeysString")
+                        .HasColumnName("Keys");
+
+                    b.Property<int?>("RulesetID");
+
+                    b.Property<int?>("Variant");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("IntAction");
+
+                    b.HasIndex("RulesetID", "Variant");
+
+                    b.ToTable("KeyBinding");
+                });
+
+            modelBuilder.Entity("osu.Game.Rulesets.RulesetInfo", b =>
+                {
+                    b.Property<int?>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<bool>("Available");
+
+                    b.Property<string>("InstantiationInfo");
+
+                    b.Property<string>("Name");
+
+                    b.Property<string>("ShortName");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("Available");
+
+                    b.HasIndex("ShortName")
+                        .IsUnique();
+
+                    b.ToTable("RulesetInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Scoring.ScoreFileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("FileInfoID");
+
+                    b.Property<string>("Filename")
+                        .IsRequired();
+
+                    b.Property<int?>("ScoreInfoID");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("FileInfoID");
+
+                    b.HasIndex("ScoreInfoID");
+
+                    b.ToTable("ScoreFileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Scoring.ScoreInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<double>("Accuracy")
+                        .HasColumnType("DECIMAL(1,4)");
+
+                    b.Property<int>("BeatmapInfoID");
+
+                    b.Property<int>("Combo");
+
+                    b.Property<DateTimeOffset>("Date");
+
+                    b.Property<bool>("DeletePending");
+
+                    b.Property<string>("Hash");
+
+                    b.Property<int>("MaxCombo");
+
+                    b.Property<string>("ModsJson")
+                        .HasColumnName("Mods");
+
+                    b.Property<long?>("OnlineScoreID");
+
+                    b.Property<double?>("PP");
+
+                    b.Property<int>("Rank");
+
+                    b.Property<int>("RulesetID");
+
+                    b.Property<string>("StatisticsJson")
+                        .HasColumnName("Statistics");
+
+                    b.Property<long>("TotalScore");
+
+                    b.Property<int?>("UserID")
+                        .HasColumnName("UserID");
+
+                    b.Property<string>("UserString")
+                        .HasColumnName("User");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("BeatmapInfoID");
+
+                    b.HasIndex("OnlineScoreID")
+                        .IsUnique();
+
+                    b.HasIndex("RulesetID");
+
+                    b.ToTable("ScoreInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Skinning.SkinFileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("FileInfoID");
+
+                    b.Property<string>("Filename")
+                        .IsRequired();
+
+                    b.Property<int>("SkinInfoID");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("FileInfoID");
+
+                    b.HasIndex("SkinInfoID");
+
+                    b.ToTable("SkinFileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Skinning.SkinInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<string>("Creator");
+
+                    b.Property<bool>("DeletePending");
+
+                    b.Property<string>("Hash");
+
+                    b.Property<string>("InstantiationInfo");
+
+                    b.Property<string>("Name");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("DeletePending");
+
+                    b.HasIndex("Hash")
+                        .IsUnique();
+
+                    b.ToTable("SkinInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapDifficulty", "BaseDifficulty")
+                        .WithMany()
+                        .HasForeignKey("BaseDifficultyID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo", "BeatmapSet")
+                        .WithMany("Beatmaps")
+                        .HasForeignKey("BeatmapSetInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
+                        .WithMany("Beatmaps")
+                        .HasForeignKey("MetadataID");
+
+                    b.HasOne("osu.Game.Rulesets.RulesetInfo", "Ruleset")
+                        .WithMany()
+                        .HasForeignKey("RulesetID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo")
+                        .WithMany("Files")
+                        .HasForeignKey("BeatmapSetInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
+                        .WithMany()
+                        .HasForeignKey("FileInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
+                        .WithMany("BeatmapSets")
+                        .HasForeignKey("MetadataID");
+                });
+
+            modelBuilder.Entity("osu.Game.Configuration.DatabasedSetting", b =>
+                {
+                    b.HasOne("osu.Game.Skinning.SkinInfo")
+                        .WithMany("Settings")
+                        .HasForeignKey("SkinInfoID");
+                });
+
+            modelBuilder.Entity("osu.Game.Scoring.ScoreFileInfo", b =>
+                {
+                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
+                        .WithMany()
+                        .HasForeignKey("FileInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Scoring.ScoreInfo")
+                        .WithMany("Files")
+                        .HasForeignKey("ScoreInfoID");
+                });
+
+            modelBuilder.Entity("osu.Game.Scoring.ScoreInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapInfo", "Beatmap")
+                        .WithMany("Scores")
+                        .HasForeignKey("BeatmapInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Rulesets.RulesetInfo", "Ruleset")
+                        .WithMany()
+                        .HasForeignKey("RulesetID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+
+            modelBuilder.Entity("osu.Game.Skinning.SkinFileInfo", b =>
+                {
+                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
+                        .WithMany()
+                        .HasForeignKey("FileInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Skinning.SkinInfo")
+                        .WithMany("Files")
+                        .HasForeignKey("SkinInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+#pragma warning restore 612, 618
+        }
+    }
+}
diff --git a/osu.Game/Migrations/20210514062639_AddAuthorIdToBeatmapMetadata.cs b/osu.Game/Migrations/20210514062639_AddAuthorIdToBeatmapMetadata.cs
new file mode 100644
index 0000000000..98fe9b5e13
--- /dev/null
+++ b/osu.Game/Migrations/20210514062639_AddAuthorIdToBeatmapMetadata.cs
@@ -0,0 +1,23 @@
+using Microsoft.EntityFrameworkCore.Migrations;
+
+namespace osu.Game.Migrations
+{
+    public partial class AddAuthorIdToBeatmapMetadata : Migration
+    {
+        protected override void Up(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.AddColumn<int>(
+                name: "AuthorID",
+                table: "BeatmapMetadata",
+                nullable: false,
+                defaultValue: 0);
+        }
+
+        protected override void Down(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.DropColumn(
+                name: "AuthorID",
+                table: "BeatmapMetadata");
+        }
+    }
+}
diff --git a/osu.Game/Migrations/20210824185035_AddCountdownSettings.Designer.cs b/osu.Game/Migrations/20210824185035_AddCountdownSettings.Designer.cs
new file mode 100644
index 0000000000..afeb42130d
--- /dev/null
+++ b/osu.Game/Migrations/20210824185035_AddCountdownSettings.Designer.cs
@@ -0,0 +1,513 @@
+// <auto-generated />
+using System;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Infrastructure;
+using Microsoft.EntityFrameworkCore.Migrations;
+using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
+using osu.Game.Database;
+
+namespace osu.Game.Migrations
+{
+    [DbContext(typeof(OsuDbContext))]
+    [Migration("20210824185035_AddCountdownSettings")]
+    partial class AddCountdownSettings
+    {
+        protected override void BuildTargetModel(ModelBuilder modelBuilder)
+        {
+#pragma warning disable 612, 618
+            modelBuilder
+                .HasAnnotation("ProductVersion", "2.2.6-servicing-10079");
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapDifficulty", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<float>("ApproachRate");
+
+                    b.Property<float>("CircleSize");
+
+                    b.Property<float>("DrainRate");
+
+                    b.Property<float>("OverallDifficulty");
+
+                    b.Property<double>("SliderMultiplier");
+
+                    b.Property<double>("SliderTickRate");
+
+                    b.HasKey("ID");
+
+                    b.ToTable("BeatmapDifficulty");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<double>("AudioLeadIn");
+
+                    b.Property<double>("BPM");
+
+                    b.Property<int>("BaseDifficultyID");
+
+                    b.Property<int>("BeatDivisor");
+
+                    b.Property<int>("BeatmapSetInfoID");
+
+                    b.Property<int>("Countdown");
+
+                    b.Property<int>("CountdownOffset");
+
+                    b.Property<double>("DistanceSpacing");
+
+                    b.Property<bool>("EpilepsyWarning");
+
+                    b.Property<int>("GridSize");
+
+                    b.Property<string>("Hash");
+
+                    b.Property<bool>("Hidden");
+
+                    b.Property<double>("Length");
+
+                    b.Property<bool>("LetterboxInBreaks");
+
+                    b.Property<string>("MD5Hash");
+
+                    b.Property<int?>("MetadataID");
+
+                    b.Property<int?>("OnlineBeatmapID");
+
+                    b.Property<string>("Path");
+
+                    b.Property<int>("RulesetID");
+
+                    b.Property<bool>("SpecialStyle");
+
+                    b.Property<float>("StackLeniency");
+
+                    b.Property<double>("StarDifficulty");
+
+                    b.Property<int>("Status");
+
+                    b.Property<string>("StoredBookmarks");
+
+                    b.Property<double>("TimelineZoom");
+
+                    b.Property<string>("Version");
+
+                    b.Property<bool>("WidescreenStoryboard");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("BaseDifficultyID");
+
+                    b.HasIndex("BeatmapSetInfoID");
+
+                    b.HasIndex("Hash");
+
+                    b.HasIndex("MD5Hash");
+
+                    b.HasIndex("MetadataID");
+
+                    b.HasIndex("OnlineBeatmapID")
+                        .IsUnique();
+
+                    b.HasIndex("RulesetID");
+
+                    b.ToTable("BeatmapInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapMetadata", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<string>("Artist");
+
+                    b.Property<string>("ArtistUnicode");
+
+                    b.Property<string>("AudioFile");
+
+                    b.Property<int>("AuthorID")
+                        .HasColumnName("AuthorID");
+
+                    b.Property<string>("AuthorString")
+                        .HasColumnName("Author");
+
+                    b.Property<string>("BackgroundFile");
+
+                    b.Property<int>("PreviewTime");
+
+                    b.Property<string>("Source");
+
+                    b.Property<string>("Tags");
+
+                    b.Property<string>("Title");
+
+                    b.Property<string>("TitleUnicode");
+
+                    b.HasKey("ID");
+
+                    b.ToTable("BeatmapMetadata");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("BeatmapSetInfoID");
+
+                    b.Property<int>("FileInfoID");
+
+                    b.Property<string>("Filename")
+                        .IsRequired();
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("BeatmapSetInfoID");
+
+                    b.HasIndex("FileInfoID");
+
+                    b.ToTable("BeatmapSetFileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<DateTimeOffset>("DateAdded");
+
+                    b.Property<bool>("DeletePending");
+
+                    b.Property<string>("Hash");
+
+                    b.Property<int?>("MetadataID");
+
+                    b.Property<int?>("OnlineBeatmapSetID");
+
+                    b.Property<bool>("Protected");
+
+                    b.Property<int>("Status");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("DeletePending");
+
+                    b.HasIndex("Hash")
+                        .IsUnique();
+
+                    b.HasIndex("MetadataID");
+
+                    b.HasIndex("OnlineBeatmapSetID")
+                        .IsUnique();
+
+                    b.ToTable("BeatmapSetInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Configuration.DatabasedSetting", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<string>("Key")
+                        .HasColumnName("Key");
+
+                    b.Property<int?>("RulesetID");
+
+                    b.Property<int?>("SkinInfoID");
+
+                    b.Property<string>("StringValue")
+                        .HasColumnName("Value");
+
+                    b.Property<int?>("Variant");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("SkinInfoID");
+
+                    b.HasIndex("RulesetID", "Variant");
+
+                    b.ToTable("Settings");
+                });
+
+            modelBuilder.Entity("osu.Game.IO.FileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<string>("Hash");
+
+                    b.Property<int>("ReferenceCount");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("Hash")
+                        .IsUnique();
+
+                    b.HasIndex("ReferenceCount");
+
+                    b.ToTable("FileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Input.Bindings.DatabasedKeyBinding", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("IntAction")
+                        .HasColumnName("Action");
+
+                    b.Property<string>("KeysString")
+                        .HasColumnName("Keys");
+
+                    b.Property<int?>("RulesetID");
+
+                    b.Property<int?>("Variant");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("IntAction");
+
+                    b.HasIndex("RulesetID", "Variant");
+
+                    b.ToTable("KeyBinding");
+                });
+
+            modelBuilder.Entity("osu.Game.Rulesets.RulesetInfo", b =>
+                {
+                    b.Property<int?>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<bool>("Available");
+
+                    b.Property<string>("InstantiationInfo");
+
+                    b.Property<string>("Name");
+
+                    b.Property<string>("ShortName");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("Available");
+
+                    b.HasIndex("ShortName")
+                        .IsUnique();
+
+                    b.ToTable("RulesetInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Scoring.ScoreFileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("FileInfoID");
+
+                    b.Property<string>("Filename")
+                        .IsRequired();
+
+                    b.Property<int?>("ScoreInfoID");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("FileInfoID");
+
+                    b.HasIndex("ScoreInfoID");
+
+                    b.ToTable("ScoreFileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Scoring.ScoreInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<double>("Accuracy")
+                        .HasColumnType("DECIMAL(1,4)");
+
+                    b.Property<int>("BeatmapInfoID");
+
+                    b.Property<int>("Combo");
+
+                    b.Property<DateTimeOffset>("Date");
+
+                    b.Property<bool>("DeletePending");
+
+                    b.Property<string>("Hash");
+
+                    b.Property<int>("MaxCombo");
+
+                    b.Property<string>("ModsJson")
+                        .HasColumnName("Mods");
+
+                    b.Property<long?>("OnlineScoreID");
+
+                    b.Property<double?>("PP");
+
+                    b.Property<int>("Rank");
+
+                    b.Property<int>("RulesetID");
+
+                    b.Property<string>("StatisticsJson")
+                        .HasColumnName("Statistics");
+
+                    b.Property<long>("TotalScore");
+
+                    b.Property<int?>("UserID")
+                        .HasColumnName("UserID");
+
+                    b.Property<string>("UserString")
+                        .HasColumnName("User");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("BeatmapInfoID");
+
+                    b.HasIndex("OnlineScoreID")
+                        .IsUnique();
+
+                    b.HasIndex("RulesetID");
+
+                    b.ToTable("ScoreInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Skinning.SkinFileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("FileInfoID");
+
+                    b.Property<string>("Filename")
+                        .IsRequired();
+
+                    b.Property<int>("SkinInfoID");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("FileInfoID");
+
+                    b.HasIndex("SkinInfoID");
+
+                    b.ToTable("SkinFileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Skinning.SkinInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<string>("Creator");
+
+                    b.Property<bool>("DeletePending");
+
+                    b.Property<string>("Hash");
+
+                    b.Property<string>("InstantiationInfo");
+
+                    b.Property<string>("Name");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("DeletePending");
+
+                    b.HasIndex("Hash")
+                        .IsUnique();
+
+                    b.ToTable("SkinInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapDifficulty", "BaseDifficulty")
+                        .WithMany()
+                        .HasForeignKey("BaseDifficultyID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo", "BeatmapSet")
+                        .WithMany("Beatmaps")
+                        .HasForeignKey("BeatmapSetInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
+                        .WithMany("Beatmaps")
+                        .HasForeignKey("MetadataID");
+
+                    b.HasOne("osu.Game.Rulesets.RulesetInfo", "Ruleset")
+                        .WithMany()
+                        .HasForeignKey("RulesetID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo")
+                        .WithMany("Files")
+                        .HasForeignKey("BeatmapSetInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
+                        .WithMany()
+                        .HasForeignKey("FileInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
+                        .WithMany("BeatmapSets")
+                        .HasForeignKey("MetadataID");
+                });
+
+            modelBuilder.Entity("osu.Game.Configuration.DatabasedSetting", b =>
+                {
+                    b.HasOne("osu.Game.Skinning.SkinInfo")
+                        .WithMany("Settings")
+                        .HasForeignKey("SkinInfoID");
+                });
+
+            modelBuilder.Entity("osu.Game.Scoring.ScoreFileInfo", b =>
+                {
+                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
+                        .WithMany()
+                        .HasForeignKey("FileInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Scoring.ScoreInfo")
+                        .WithMany("Files")
+                        .HasForeignKey("ScoreInfoID");
+                });
+
+            modelBuilder.Entity("osu.Game.Scoring.ScoreInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapInfo", "Beatmap")
+                        .WithMany("Scores")
+                        .HasForeignKey("BeatmapInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Rulesets.RulesetInfo", "Ruleset")
+                        .WithMany()
+                        .HasForeignKey("RulesetID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+
+            modelBuilder.Entity("osu.Game.Skinning.SkinFileInfo", b =>
+                {
+                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
+                        .WithMany()
+                        .HasForeignKey("FileInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Skinning.SkinInfo")
+                        .WithMany("Files")
+                        .HasForeignKey("SkinInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+#pragma warning restore 612, 618
+        }
+    }
+}
diff --git a/osu.Game/Migrations/20210824185035_AddCountdownSettings.cs b/osu.Game/Migrations/20210824185035_AddCountdownSettings.cs
new file mode 100644
index 0000000000..564f5f4520
--- /dev/null
+++ b/osu.Game/Migrations/20210824185035_AddCountdownSettings.cs
@@ -0,0 +1,23 @@
+using Microsoft.EntityFrameworkCore.Migrations;
+
+namespace osu.Game.Migrations
+{
+    public partial class AddCountdownSettings : Migration
+    {
+        protected override void Up(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.AddColumn<int>(
+                name: "CountdownOffset",
+                table: "BeatmapInfo",
+                nullable: false,
+                defaultValue: 0);
+        }
+
+        protected override void Down(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.DropColumn(
+                name: "CountdownOffset",
+                table: "BeatmapInfo");
+        }
+    }
+}
diff --git a/osu.Game/Migrations/20210912144011_AddSamplesMatchPlaybackRate.Designer.cs b/osu.Game/Migrations/20210912144011_AddSamplesMatchPlaybackRate.Designer.cs
new file mode 100644
index 0000000000..6e53d7fae0
--- /dev/null
+++ b/osu.Game/Migrations/20210912144011_AddSamplesMatchPlaybackRate.Designer.cs
@@ -0,0 +1,515 @@
+// <auto-generated />
+using System;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Infrastructure;
+using Microsoft.EntityFrameworkCore.Migrations;
+using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
+using osu.Game.Database;
+
+namespace osu.Game.Migrations
+{
+    [DbContext(typeof(OsuDbContext))]
+    [Migration("20210912144011_AddSamplesMatchPlaybackRate")]
+    partial class AddSamplesMatchPlaybackRate
+    {
+        protected override void BuildTargetModel(ModelBuilder modelBuilder)
+        {
+#pragma warning disable 612, 618
+            modelBuilder
+                .HasAnnotation("ProductVersion", "2.2.6-servicing-10079");
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapDifficulty", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<float>("ApproachRate");
+
+                    b.Property<float>("CircleSize");
+
+                    b.Property<float>("DrainRate");
+
+                    b.Property<float>("OverallDifficulty");
+
+                    b.Property<double>("SliderMultiplier");
+
+                    b.Property<double>("SliderTickRate");
+
+                    b.HasKey("ID");
+
+                    b.ToTable("BeatmapDifficulty");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<double>("AudioLeadIn");
+
+                    b.Property<double>("BPM");
+
+                    b.Property<int>("BaseDifficultyID");
+
+                    b.Property<int>("BeatDivisor");
+
+                    b.Property<int>("BeatmapSetInfoID");
+
+                    b.Property<int>("Countdown");
+
+                    b.Property<int>("CountdownOffset");
+
+                    b.Property<double>("DistanceSpacing");
+
+                    b.Property<bool>("EpilepsyWarning");
+
+                    b.Property<int>("GridSize");
+
+                    b.Property<string>("Hash");
+
+                    b.Property<bool>("Hidden");
+
+                    b.Property<double>("Length");
+
+                    b.Property<bool>("LetterboxInBreaks");
+
+                    b.Property<string>("MD5Hash");
+
+                    b.Property<int?>("MetadataID");
+
+                    b.Property<int?>("OnlineBeatmapID");
+
+                    b.Property<string>("Path");
+
+                    b.Property<int>("RulesetID");
+
+                    b.Property<bool>("SamplesMatchPlaybackRate");
+
+                    b.Property<bool>("SpecialStyle");
+
+                    b.Property<float>("StackLeniency");
+
+                    b.Property<double>("StarDifficulty");
+
+                    b.Property<int>("Status");
+
+                    b.Property<string>("StoredBookmarks");
+
+                    b.Property<double>("TimelineZoom");
+
+                    b.Property<string>("Version");
+
+                    b.Property<bool>("WidescreenStoryboard");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("BaseDifficultyID");
+
+                    b.HasIndex("BeatmapSetInfoID");
+
+                    b.HasIndex("Hash");
+
+                    b.HasIndex("MD5Hash");
+
+                    b.HasIndex("MetadataID");
+
+                    b.HasIndex("OnlineBeatmapID")
+                        .IsUnique();
+
+                    b.HasIndex("RulesetID");
+
+                    b.ToTable("BeatmapInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapMetadata", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<string>("Artist");
+
+                    b.Property<string>("ArtistUnicode");
+
+                    b.Property<string>("AudioFile");
+
+                    b.Property<int>("AuthorID")
+                        .HasColumnName("AuthorID");
+
+                    b.Property<string>("AuthorString")
+                        .HasColumnName("Author");
+
+                    b.Property<string>("BackgroundFile");
+
+                    b.Property<int>("PreviewTime");
+
+                    b.Property<string>("Source");
+
+                    b.Property<string>("Tags");
+
+                    b.Property<string>("Title");
+
+                    b.Property<string>("TitleUnicode");
+
+                    b.HasKey("ID");
+
+                    b.ToTable("BeatmapMetadata");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("BeatmapSetInfoID");
+
+                    b.Property<int>("FileInfoID");
+
+                    b.Property<string>("Filename")
+                        .IsRequired();
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("BeatmapSetInfoID");
+
+                    b.HasIndex("FileInfoID");
+
+                    b.ToTable("BeatmapSetFileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<DateTimeOffset>("DateAdded");
+
+                    b.Property<bool>("DeletePending");
+
+                    b.Property<string>("Hash");
+
+                    b.Property<int?>("MetadataID");
+
+                    b.Property<int?>("OnlineBeatmapSetID");
+
+                    b.Property<bool>("Protected");
+
+                    b.Property<int>("Status");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("DeletePending");
+
+                    b.HasIndex("Hash")
+                        .IsUnique();
+
+                    b.HasIndex("MetadataID");
+
+                    b.HasIndex("OnlineBeatmapSetID")
+                        .IsUnique();
+
+                    b.ToTable("BeatmapSetInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Configuration.DatabasedSetting", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<string>("Key")
+                        .HasColumnName("Key");
+
+                    b.Property<int?>("RulesetID");
+
+                    b.Property<int?>("SkinInfoID");
+
+                    b.Property<string>("StringValue")
+                        .HasColumnName("Value");
+
+                    b.Property<int?>("Variant");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("SkinInfoID");
+
+                    b.HasIndex("RulesetID", "Variant");
+
+                    b.ToTable("Settings");
+                });
+
+            modelBuilder.Entity("osu.Game.IO.FileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<string>("Hash");
+
+                    b.Property<int>("ReferenceCount");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("Hash")
+                        .IsUnique();
+
+                    b.HasIndex("ReferenceCount");
+
+                    b.ToTable("FileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Input.Bindings.DatabasedKeyBinding", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("IntAction")
+                        .HasColumnName("Action");
+
+                    b.Property<string>("KeysString")
+                        .HasColumnName("Keys");
+
+                    b.Property<int?>("RulesetID");
+
+                    b.Property<int?>("Variant");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("IntAction");
+
+                    b.HasIndex("RulesetID", "Variant");
+
+                    b.ToTable("KeyBinding");
+                });
+
+            modelBuilder.Entity("osu.Game.Rulesets.RulesetInfo", b =>
+                {
+                    b.Property<int?>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<bool>("Available");
+
+                    b.Property<string>("InstantiationInfo");
+
+                    b.Property<string>("Name");
+
+                    b.Property<string>("ShortName");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("Available");
+
+                    b.HasIndex("ShortName")
+                        .IsUnique();
+
+                    b.ToTable("RulesetInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Scoring.ScoreFileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("FileInfoID");
+
+                    b.Property<string>("Filename")
+                        .IsRequired();
+
+                    b.Property<int?>("ScoreInfoID");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("FileInfoID");
+
+                    b.HasIndex("ScoreInfoID");
+
+                    b.ToTable("ScoreFileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Scoring.ScoreInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<double>("Accuracy")
+                        .HasColumnType("DECIMAL(1,4)");
+
+                    b.Property<int>("BeatmapInfoID");
+
+                    b.Property<int>("Combo");
+
+                    b.Property<DateTimeOffset>("Date");
+
+                    b.Property<bool>("DeletePending");
+
+                    b.Property<string>("Hash");
+
+                    b.Property<int>("MaxCombo");
+
+                    b.Property<string>("ModsJson")
+                        .HasColumnName("Mods");
+
+                    b.Property<long?>("OnlineScoreID");
+
+                    b.Property<double?>("PP");
+
+                    b.Property<int>("Rank");
+
+                    b.Property<int>("RulesetID");
+
+                    b.Property<string>("StatisticsJson")
+                        .HasColumnName("Statistics");
+
+                    b.Property<long>("TotalScore");
+
+                    b.Property<int?>("UserID")
+                        .HasColumnName("UserID");
+
+                    b.Property<string>("UserString")
+                        .HasColumnName("User");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("BeatmapInfoID");
+
+                    b.HasIndex("OnlineScoreID")
+                        .IsUnique();
+
+                    b.HasIndex("RulesetID");
+
+                    b.ToTable("ScoreInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Skinning.SkinFileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("FileInfoID");
+
+                    b.Property<string>("Filename")
+                        .IsRequired();
+
+                    b.Property<int>("SkinInfoID");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("FileInfoID");
+
+                    b.HasIndex("SkinInfoID");
+
+                    b.ToTable("SkinFileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Skinning.SkinInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<string>("Creator");
+
+                    b.Property<bool>("DeletePending");
+
+                    b.Property<string>("Hash");
+
+                    b.Property<string>("InstantiationInfo");
+
+                    b.Property<string>("Name");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("DeletePending");
+
+                    b.HasIndex("Hash")
+                        .IsUnique();
+
+                    b.ToTable("SkinInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapDifficulty", "BaseDifficulty")
+                        .WithMany()
+                        .HasForeignKey("BaseDifficultyID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo", "BeatmapSet")
+                        .WithMany("Beatmaps")
+                        .HasForeignKey("BeatmapSetInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
+                        .WithMany("Beatmaps")
+                        .HasForeignKey("MetadataID");
+
+                    b.HasOne("osu.Game.Rulesets.RulesetInfo", "Ruleset")
+                        .WithMany()
+                        .HasForeignKey("RulesetID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo")
+                        .WithMany("Files")
+                        .HasForeignKey("BeatmapSetInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
+                        .WithMany()
+                        .HasForeignKey("FileInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
+                        .WithMany("BeatmapSets")
+                        .HasForeignKey("MetadataID");
+                });
+
+            modelBuilder.Entity("osu.Game.Configuration.DatabasedSetting", b =>
+                {
+                    b.HasOne("osu.Game.Skinning.SkinInfo")
+                        .WithMany("Settings")
+                        .HasForeignKey("SkinInfoID");
+                });
+
+            modelBuilder.Entity("osu.Game.Scoring.ScoreFileInfo", b =>
+                {
+                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
+                        .WithMany()
+                        .HasForeignKey("FileInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Scoring.ScoreInfo")
+                        .WithMany("Files")
+                        .HasForeignKey("ScoreInfoID");
+                });
+
+            modelBuilder.Entity("osu.Game.Scoring.ScoreInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapInfo", "Beatmap")
+                        .WithMany("Scores")
+                        .HasForeignKey("BeatmapInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Rulesets.RulesetInfo", "Ruleset")
+                        .WithMany()
+                        .HasForeignKey("RulesetID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+
+            modelBuilder.Entity("osu.Game.Skinning.SkinFileInfo", b =>
+                {
+                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
+                        .WithMany()
+                        .HasForeignKey("FileInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Skinning.SkinInfo")
+                        .WithMany("Files")
+                        .HasForeignKey("SkinInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+#pragma warning restore 612, 618
+        }
+    }
+}
diff --git a/osu.Game/Migrations/20210912144011_AddSamplesMatchPlaybackRate.cs b/osu.Game/Migrations/20210912144011_AddSamplesMatchPlaybackRate.cs
new file mode 100644
index 0000000000..bf3f855d5f
--- /dev/null
+++ b/osu.Game/Migrations/20210912144011_AddSamplesMatchPlaybackRate.cs
@@ -0,0 +1,23 @@
+using Microsoft.EntityFrameworkCore.Migrations;
+
+namespace osu.Game.Migrations
+{
+    public partial class AddSamplesMatchPlaybackRate : Migration
+    {
+        protected override void Up(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.AddColumn<bool>(
+                name: "SamplesMatchPlaybackRate",
+                table: "BeatmapInfo",
+                nullable: false,
+                defaultValue: false);
+        }
+
+        protected override void Down(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.DropColumn(
+                name: "SamplesMatchPlaybackRate",
+                table: "BeatmapInfo");
+        }
+    }
+}
diff --git a/osu.Game/Migrations/20211020081609_ResetSkinHashes.cs b/osu.Game/Migrations/20211020081609_ResetSkinHashes.cs
new file mode 100644
index 0000000000..6d53c019ec
--- /dev/null
+++ b/osu.Game/Migrations/20211020081609_ResetSkinHashes.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 Microsoft.EntityFrameworkCore.Infrastructure;
+using Microsoft.EntityFrameworkCore.Migrations;
+using osu.Game.Database;
+
+namespace osu.Game.Migrations
+{
+    [DbContext(typeof(OsuDbContext))]
+    [Migration("20211020081609_ResetSkinHashes")]
+    public partial class ResetSkinHashes : Migration
+    {
+        protected override void Up(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.Sql($"UPDATE SkinInfo SET Hash = null");
+        }
+
+        protected override void Down(MigrationBuilder migrationBuilder)
+        {
+        }
+    }
+}
diff --git a/osu.Game/Migrations/OsuDbContextModelSnapshot.cs b/osu.Game/Migrations/OsuDbContextModelSnapshot.cs
new file mode 100644
index 0000000000..036c26cb0a
--- /dev/null
+++ b/osu.Game/Migrations/OsuDbContextModelSnapshot.cs
@@ -0,0 +1,513 @@
+// <auto-generated />
+using System;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Infrastructure;
+using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
+using osu.Game.Database;
+
+namespace osu.Game.Migrations
+{
+    [DbContext(typeof(OsuDbContext))]
+    partial class OsuDbContextModelSnapshot : ModelSnapshot
+    {
+        protected override void BuildModel(ModelBuilder modelBuilder)
+        {
+#pragma warning disable 612, 618
+            modelBuilder
+                .HasAnnotation("ProductVersion", "2.2.6-servicing-10079");
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapDifficulty", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<float>("ApproachRate");
+
+                    b.Property<float>("CircleSize");
+
+                    b.Property<float>("DrainRate");
+
+                    b.Property<float>("OverallDifficulty");
+
+                    b.Property<double>("SliderMultiplier");
+
+                    b.Property<double>("SliderTickRate");
+
+                    b.HasKey("ID");
+
+                    b.ToTable("BeatmapDifficulty");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<double>("AudioLeadIn");
+
+                    b.Property<double>("BPM");
+
+                    b.Property<int>("BaseDifficultyID");
+
+                    b.Property<int>("BeatDivisor");
+
+                    b.Property<int>("BeatmapSetInfoID");
+
+                    b.Property<int>("Countdown");
+
+                    b.Property<int>("CountdownOffset");
+
+                    b.Property<double>("DistanceSpacing");
+
+                    b.Property<bool>("EpilepsyWarning");
+
+                    b.Property<int>("GridSize");
+
+                    b.Property<string>("Hash");
+
+                    b.Property<bool>("Hidden");
+
+                    b.Property<double>("Length");
+
+                    b.Property<bool>("LetterboxInBreaks");
+
+                    b.Property<string>("MD5Hash");
+
+                    b.Property<int?>("MetadataID");
+
+                    b.Property<int?>("OnlineBeatmapID");
+
+                    b.Property<string>("Path");
+
+                    b.Property<int>("RulesetID");
+
+                    b.Property<bool>("SamplesMatchPlaybackRate");
+
+                    b.Property<bool>("SpecialStyle");
+
+                    b.Property<float>("StackLeniency");
+
+                    b.Property<double>("StarDifficulty");
+
+                    b.Property<int>("Status");
+
+                    b.Property<string>("StoredBookmarks");
+
+                    b.Property<double>("TimelineZoom");
+
+                    b.Property<string>("Version");
+
+                    b.Property<bool>("WidescreenStoryboard");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("BaseDifficultyID");
+
+                    b.HasIndex("BeatmapSetInfoID");
+
+                    b.HasIndex("Hash");
+
+                    b.HasIndex("MD5Hash");
+
+                    b.HasIndex("MetadataID");
+
+                    b.HasIndex("OnlineBeatmapID")
+                        .IsUnique();
+
+                    b.HasIndex("RulesetID");
+
+                    b.ToTable("BeatmapInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapMetadata", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<string>("Artist");
+
+                    b.Property<string>("ArtistUnicode");
+
+                    b.Property<string>("AudioFile");
+
+                    b.Property<int>("AuthorID")
+                        .HasColumnName("AuthorID");
+
+                    b.Property<string>("AuthorString")
+                        .HasColumnName("Author");
+
+                    b.Property<string>("BackgroundFile");
+
+                    b.Property<int>("PreviewTime");
+
+                    b.Property<string>("Source");
+
+                    b.Property<string>("Tags");
+
+                    b.Property<string>("Title");
+
+                    b.Property<string>("TitleUnicode");
+
+                    b.HasKey("ID");
+
+                    b.ToTable("BeatmapMetadata");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("BeatmapSetInfoID");
+
+                    b.Property<int>("FileInfoID");
+
+                    b.Property<string>("Filename")
+                        .IsRequired();
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("BeatmapSetInfoID");
+
+                    b.HasIndex("FileInfoID");
+
+                    b.ToTable("BeatmapSetFileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<DateTimeOffset>("DateAdded");
+
+                    b.Property<bool>("DeletePending");
+
+                    b.Property<string>("Hash");
+
+                    b.Property<int?>("MetadataID");
+
+                    b.Property<int?>("OnlineBeatmapSetID");
+
+                    b.Property<bool>("Protected");
+
+                    b.Property<int>("Status");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("DeletePending");
+
+                    b.HasIndex("Hash")
+                        .IsUnique();
+
+                    b.HasIndex("MetadataID");
+
+                    b.HasIndex("OnlineBeatmapSetID")
+                        .IsUnique();
+
+                    b.ToTable("BeatmapSetInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Configuration.DatabasedSetting", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<string>("Key")
+                        .HasColumnName("Key");
+
+                    b.Property<int?>("RulesetID");
+
+                    b.Property<int?>("SkinInfoID");
+
+                    b.Property<string>("StringValue")
+                        .HasColumnName("Value");
+
+                    b.Property<int?>("Variant");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("SkinInfoID");
+
+                    b.HasIndex("RulesetID", "Variant");
+
+                    b.ToTable("Settings");
+                });
+
+            modelBuilder.Entity("osu.Game.IO.FileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<string>("Hash");
+
+                    b.Property<int>("ReferenceCount");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("Hash")
+                        .IsUnique();
+
+                    b.HasIndex("ReferenceCount");
+
+                    b.ToTable("FileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Input.Bindings.DatabasedKeyBinding", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("IntAction")
+                        .HasColumnName("Action");
+
+                    b.Property<string>("KeysString")
+                        .HasColumnName("Keys");
+
+                    b.Property<int?>("RulesetID");
+
+                    b.Property<int?>("Variant");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("IntAction");
+
+                    b.HasIndex("RulesetID", "Variant");
+
+                    b.ToTable("KeyBinding");
+                });
+
+            modelBuilder.Entity("osu.Game.Rulesets.RulesetInfo", b =>
+                {
+                    b.Property<int?>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<bool>("Available");
+
+                    b.Property<string>("InstantiationInfo");
+
+                    b.Property<string>("Name");
+
+                    b.Property<string>("ShortName");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("Available");
+
+                    b.HasIndex("ShortName")
+                        .IsUnique();
+
+                    b.ToTable("RulesetInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Scoring.ScoreFileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("FileInfoID");
+
+                    b.Property<string>("Filename")
+                        .IsRequired();
+
+                    b.Property<int?>("ScoreInfoID");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("FileInfoID");
+
+                    b.HasIndex("ScoreInfoID");
+
+                    b.ToTable("ScoreFileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Scoring.ScoreInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<double>("Accuracy")
+                        .HasColumnType("DECIMAL(1,4)");
+
+                    b.Property<int>("BeatmapInfoID");
+
+                    b.Property<int>("Combo");
+
+                    b.Property<DateTimeOffset>("Date");
+
+                    b.Property<bool>("DeletePending");
+
+                    b.Property<string>("Hash");
+
+                    b.Property<int>("MaxCombo");
+
+                    b.Property<string>("ModsJson")
+                        .HasColumnName("Mods");
+
+                    b.Property<long?>("OnlineScoreID");
+
+                    b.Property<double?>("PP");
+
+                    b.Property<int>("Rank");
+
+                    b.Property<int>("RulesetID");
+
+                    b.Property<string>("StatisticsJson")
+                        .HasColumnName("Statistics");
+
+                    b.Property<long>("TotalScore");
+
+                    b.Property<int?>("UserID")
+                        .HasColumnName("UserID");
+
+                    b.Property<string>("UserString")
+                        .HasColumnName("User");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("BeatmapInfoID");
+
+                    b.HasIndex("OnlineScoreID")
+                        .IsUnique();
+
+                    b.HasIndex("RulesetID");
+
+                    b.ToTable("ScoreInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Skinning.SkinFileInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<int>("FileInfoID");
+
+                    b.Property<string>("Filename")
+                        .IsRequired();
+
+                    b.Property<int>("SkinInfoID");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("FileInfoID");
+
+                    b.HasIndex("SkinInfoID");
+
+                    b.ToTable("SkinFileInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Skinning.SkinInfo", b =>
+                {
+                    b.Property<int>("ID")
+                        .ValueGeneratedOnAdd();
+
+                    b.Property<string>("Creator");
+
+                    b.Property<bool>("DeletePending");
+
+                    b.Property<string>("Hash");
+
+                    b.Property<string>("InstantiationInfo");
+
+                    b.Property<string>("Name");
+
+                    b.HasKey("ID");
+
+                    b.HasIndex("DeletePending");
+
+                    b.HasIndex("Hash")
+                        .IsUnique();
+
+                    b.ToTable("SkinInfo");
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapDifficulty", "BaseDifficulty")
+                        .WithMany()
+                        .HasForeignKey("BaseDifficultyID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo", "BeatmapSet")
+                        .WithMany("Beatmaps")
+                        .HasForeignKey("BeatmapSetInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
+                        .WithMany("Beatmaps")
+                        .HasForeignKey("MetadataID");
+
+                    b.HasOne("osu.Game.Rulesets.RulesetInfo", "Ruleset")
+                        .WithMany()
+                        .HasForeignKey("RulesetID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetFileInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapSetInfo")
+                        .WithMany("Files")
+                        .HasForeignKey("BeatmapSetInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
+                        .WithMany()
+                        .HasForeignKey("FileInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+
+            modelBuilder.Entity("osu.Game.Beatmaps.BeatmapSetInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapMetadata", "Metadata")
+                        .WithMany("BeatmapSets")
+                        .HasForeignKey("MetadataID");
+                });
+
+            modelBuilder.Entity("osu.Game.Configuration.DatabasedSetting", b =>
+                {
+                    b.HasOne("osu.Game.Skinning.SkinInfo")
+                        .WithMany("Settings")
+                        .HasForeignKey("SkinInfoID");
+                });
+
+            modelBuilder.Entity("osu.Game.Scoring.ScoreFileInfo", b =>
+                {
+                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
+                        .WithMany()
+                        .HasForeignKey("FileInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Scoring.ScoreInfo")
+                        .WithMany("Files")
+                        .HasForeignKey("ScoreInfoID");
+                });
+
+            modelBuilder.Entity("osu.Game.Scoring.ScoreInfo", b =>
+                {
+                    b.HasOne("osu.Game.Beatmaps.BeatmapInfo", "Beatmap")
+                        .WithMany("Scores")
+                        .HasForeignKey("BeatmapInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Rulesets.RulesetInfo", "Ruleset")
+                        .WithMany()
+                        .HasForeignKey("RulesetID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+
+            modelBuilder.Entity("osu.Game.Skinning.SkinFileInfo", b =>
+                {
+                    b.HasOne("osu.Game.IO.FileInfo", "FileInfo")
+                        .WithMany()
+                        .HasForeignKey("FileInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.HasOne("osu.Game.Skinning.SkinInfo")
+                        .WithMany("Files")
+                        .HasForeignKey("SkinInfoID")
+                        .OnDelete(DeleteBehavior.Cascade);
+                });
+#pragma warning restore 612, 618
+        }
+    }
+}

From 1a14ccc7ee37f2daa4b3500483668621b7c7abef Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 29 Jan 2022 22:42:34 +0900
Subject: [PATCH 2608/5547] Run EF migrations before migrating to realm

Turns out that there are more than zero users that are upgrading from
old databases. I think we probably want to support this for now.

Tested against database in https://github.com/ppy/osu/discussions/16700
and one other I had locally, both work correctly.
---
 osu.Game/Database/EFToRealmMigrator.cs | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/osu.Game/Database/EFToRealmMigrator.cs b/osu.Game/Database/EFToRealmMigrator.cs
index a53704df9d..0bb5388d55 100644
--- a/osu.Game/Database/EFToRealmMigrator.cs
+++ b/osu.Game/Database/EFToRealmMigrator.cs
@@ -133,6 +133,8 @@ namespace osu.Game.Database
                         r.RemoveAll<ScoreInfo>();
                     });
 
+                    ef.Migrate();
+
                     migrateSettings(ef);
                     migrateSkins(ef);
                     migrateBeatmaps(ef);

From 24f9ef4005827338702e3e8766a835b755c7a5d0 Mon Sep 17 00:00:00 2001
From: Nitrous <nathan.alo2000@gmail.com>
Date: Sat, 29 Jan 2022 22:31:04 +0800
Subject: [PATCH 2609/5547] make xmldoc more verbose

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

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModAlternate.cs b/osu.Game.Rulesets.Osu/Mods/OsuModAlternate.cs
index f366481c7d..9eeb060135 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModAlternate.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModAlternate.cs
@@ -27,7 +27,7 @@ namespace osu.Game.Rulesets.Osu.Mods
         public override IconUsage? Icon => FontAwesome.Solid.Keyboard;
 
         /// <summary>
-        /// Whether incoming input must be checked by <see cref="InputInterceptor"/>.
+        /// Whether incoming input must be checked by <see cref="InputInterceptor"/> before it is passed to gameplay.
         /// </summary>
         public bool CanIntercept => !isBreakTime.Value && introEnded;
 

From b4e516c535032f91c70f67e0ae8aebbe156d8d3e Mon Sep 17 00:00:00 2001
From: Nitrous <nathan.alo2000@gmail.com>
Date: Sat, 29 Jan 2022 22:31:24 +0800
Subject: [PATCH 2610/5547] allow test scenes to specify replays manually

---
 osu.Game/Tests/Visual/ModTestScene.cs | 33 +++++++++++++++++++++++++--
 1 file changed, 31 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Tests/Visual/ModTestScene.cs b/osu.Game/Tests/Visual/ModTestScene.cs
index a71d008eb9..524482237a 100644
--- a/osu.Game/Tests/Visual/ModTestScene.cs
+++ b/osu.Game/Tests/Visual/ModTestScene.cs
@@ -5,8 +5,12 @@ using System;
 using System.Collections.Generic;
 using JetBrains.Annotations;
 using osu.Game.Beatmaps;
+using osu.Game.Online.API.Requests.Responses;
+using osu.Game.Replays;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Mods;
+using osu.Game.Rulesets.Replays;
+using osu.Game.Scoring;
 
 namespace osu.Game.Tests.Visual
 {
@@ -50,18 +54,37 @@ namespace osu.Game.Tests.Visual
             return CreateModPlayer(ruleset);
         }
 
-        protected virtual TestPlayer CreateModPlayer(Ruleset ruleset) => new ModTestPlayer(AllowFail);
+        protected virtual TestPlayer CreateModPlayer(Ruleset ruleset) => new ModTestPlayer(currentTestData, AllowFail);
 
         protected class ModTestPlayer : TestPlayer
         {
             private readonly bool allowFail;
+            private ModTestData currentTestData;
 
             protected override bool CheckModsAllowFailure() => allowFail;
 
-            public ModTestPlayer(bool allowFail)
+            public ModTestPlayer(ModTestData data, bool allowFail)
                 : base(false, false)
             {
                 this.allowFail = allowFail;
+                currentTestData = data;
+            }
+
+            protected override void PrepareReplay()
+            {
+                if (currentTestData.Autoplay && currentTestData.Frames?.Count > 0)
+                    throw new InvalidOperationException(@$"{nameof(ModTestData.Autoplay)} must be false when {nameof(ModTestData.Frames)} is specified.");
+
+                if (currentTestData.Frames != null)
+                {
+                    DrawableRuleset?.SetReplayScore(new Score
+                    {
+                        Replay = new Replay { Frames = currentTestData.Frames },
+                        ScoreInfo = new ScoreInfo { User = new APIUser { Username = @"Test" } },
+                    });
+                }
+
+                base.PrepareReplay();
             }
         }
 
@@ -72,6 +95,12 @@ namespace osu.Game.Tests.Visual
             /// </summary>
             public bool Autoplay = true;
 
+            /// <summary>
+            /// The frames to use for replay. <see cref="Autoplay"/> must be set to false.
+            /// </summary>
+            [CanBeNull]
+            public List<ReplayFrame> Frames;
+
             /// <summary>
             /// The beatmap for this test case.
             /// </summary>

From 1087d8b1cedfaad85e048151e20638c6cf18ff18 Mon Sep 17 00:00:00 2001
From: Nitrous <nathan.alo2000@gmail.com>
Date: Sat, 29 Jan 2022 22:31:31 +0800
Subject: [PATCH 2611/5547] add tests

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

diff --git a/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModAlternate.cs b/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModAlternate.cs
new file mode 100644
index 0000000000..7b3eaa7ffd
--- /dev/null
+++ b/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModAlternate.cs
@@ -0,0 +1,154 @@
+// 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.Game.Beatmaps;
+using osu.Game.Beatmaps.Timing;
+using osu.Game.Rulesets.Objects;
+using osu.Game.Rulesets.Osu.Mods;
+using osu.Game.Rulesets.Osu.Objects;
+using osu.Game.Rulesets.Osu.Replays;
+using osu.Game.Rulesets.Replays;
+using osuTK;
+
+namespace osu.Game.Rulesets.Osu.Tests.Mods
+{
+    public class TestSceneOsuModAlternate : OsuModTestScene
+    {
+        [Test]
+        public void TestInputAtIntro() => CreateModTest(new ModTestData
+        {
+            Mod = new OsuModAlternate(),
+            PassCondition = () => Player.ScoreProcessor.Combo.Value == 1,
+            Autoplay = false,
+            Beatmap = new Beatmap
+            {
+                HitObjects = new List<HitObject>
+                {
+                    new HitCircle
+                    {
+                        StartTime = 1000,
+                        Position = new Vector2(100),
+                    },
+                },
+            },
+            Frames = new List<ReplayFrame>
+            {
+                new OsuReplayFrame(500, new Vector2(200), OsuAction.LeftButton),
+                new OsuReplayFrame(501, new Vector2(200)),
+                new OsuReplayFrame(1000, new Vector2(100), OsuAction.LeftButton),
+            }
+        });
+
+        [Test]
+        public void TestInputAlternating() => CreateModTest(new ModTestData
+        {
+            Mod = new OsuModAlternate(),
+            PassCondition = () => Player.ScoreProcessor.Combo.Value == 4,
+            Autoplay = false,
+            Beatmap = new Beatmap
+            {
+                HitObjects = new List<HitObject>
+                {
+                    new HitCircle
+                    {
+                        StartTime = 500,
+                        Position = new Vector2(100),
+                    },
+                    new HitCircle
+                    {
+                        StartTime = 1000,
+                        Position = new Vector2(200, 100),
+                    },
+                    new HitCircle
+                    {
+                        StartTime = 1500,
+                        Position = new Vector2(300, 100),
+                    },
+                    new HitCircle
+                    {
+                        StartTime = 2000,
+                        Position = new Vector2(400, 100),
+                    },
+                },
+            },
+            Frames = new List<ReplayFrame>
+            {
+                new OsuReplayFrame(500, new Vector2(100), OsuAction.LeftButton),
+                new OsuReplayFrame(501, new Vector2(100)),
+                new OsuReplayFrame(1000, new Vector2(200, 100), OsuAction.RightButton),
+                new OsuReplayFrame(1001, new Vector2(200, 100)),
+                new OsuReplayFrame(1500, new Vector2(300, 100), OsuAction.LeftButton),
+                new OsuReplayFrame(1501, new Vector2(300, 100)),
+                new OsuReplayFrame(2000, new Vector2(400, 100), OsuAction.RightButton),
+                new OsuReplayFrame(2001, new Vector2(400, 100)),
+            }
+        });
+
+        [Test]
+        public void TestInputSingular() => CreateModTest(new ModTestData
+        {
+            Mod = new OsuModAlternate(),
+            PassCondition = () => Player.ScoreProcessor.Combo.Value == 0 && Player.ScoreProcessor.HighestCombo.Value == 1,
+            Autoplay = false,
+            Beatmap = new Beatmap
+            {
+                HitObjects = new List<HitObject>
+                {
+                    new HitCircle
+                    {
+                        StartTime = 500,
+                        Position = new Vector2(100),
+                    },
+                    new HitCircle
+                    {
+                        StartTime = 1000,
+                        Position = new Vector2(200, 100),
+                    },
+                },
+            },
+            Frames = new List<ReplayFrame>
+            {
+                new OsuReplayFrame(500, new Vector2(100), OsuAction.LeftButton),
+                new OsuReplayFrame(501, new Vector2(100)),
+                new OsuReplayFrame(1000, new Vector2(200, 100), OsuAction.LeftButton),
+            }
+        });
+
+        [Test]
+        public void TestInputSingularWithBreak() => CreateModTest(new ModTestData
+        {
+            Mod = new OsuModAlternate(),
+            PassCondition = () => Player.ScoreProcessor.Combo.Value == 2,
+            Autoplay = false,
+            Beatmap = new Beatmap
+            {
+                Breaks = new List<BreakPeriod>
+                {
+                    new BreakPeriod(500, 2250),
+                },
+                HitObjects = new List<HitObject>
+                {
+                    new HitCircle
+                    {
+                        StartTime = 500,
+                        Position = new Vector2(100),
+                    },
+                    new HitCircle
+                    {
+                        StartTime = 2500,
+                        Position = new Vector2(100),
+                    }
+                }
+            },
+            Frames = new List<ReplayFrame>
+            {
+                new OsuReplayFrame(500, new Vector2(100), OsuAction.LeftButton),
+                new OsuReplayFrame(501, new Vector2(100)),
+                new OsuReplayFrame(2500, new Vector2(100), OsuAction.LeftButton),
+                new OsuReplayFrame(2501, new Vector2(100)),
+            }
+        });
+    }
+}

From a8eb3f95df2501659941c8d4d242fd8d08b897c8 Mon Sep 17 00:00:00 2001
From: Nitrous <nathan.alo2000@gmail.com>
Date: Sat, 29 Jan 2022 22:54:17 +0800
Subject: [PATCH 2612/5547] add readonly modifier

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

diff --git a/osu.Game/Tests/Visual/ModTestScene.cs b/osu.Game/Tests/Visual/ModTestScene.cs
index 524482237a..96fafa8727 100644
--- a/osu.Game/Tests/Visual/ModTestScene.cs
+++ b/osu.Game/Tests/Visual/ModTestScene.cs
@@ -59,7 +59,7 @@ namespace osu.Game.Tests.Visual
         protected class ModTestPlayer : TestPlayer
         {
             private readonly bool allowFail;
-            private ModTestData currentTestData;
+            private readonly ModTestData currentTestData;
 
             protected override bool CheckModsAllowFailure() => allowFail;
 

From c6d303a5b44ba2f0d0c221178e9abab50dc2fbaa Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 28 Jan 2022 21:16:29 +0900
Subject: [PATCH 2613/5547] Add xmldoc to `Leaderboard` class

---
 osu.Game/Online/Leaderboards/Leaderboard.cs | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/osu.Game/Online/Leaderboards/Leaderboard.cs b/osu.Game/Online/Leaderboards/Leaderboard.cs
index 515cc6fd73..e2a52b5db9 100644
--- a/osu.Game/Online/Leaderboards/Leaderboard.cs
+++ b/osu.Game/Online/Leaderboards/Leaderboard.cs
@@ -23,6 +23,12 @@ using osuTK.Graphics;
 
 namespace osu.Game.Online.Leaderboards
 {
+    /// <summary>
+    /// A leaderboard which displays a scrolling list of top scores, along with a single "user best"
+    /// for the local user.
+    /// </summary>
+    /// <typeparam name="TScope">The scope of the leaderboard (ie. global or local).</typeparam>
+    /// <typeparam name="TScoreInfo">The score model class.</typeparam>
     public abstract class Leaderboard<TScope, TScoreInfo> : Container
     {
         private const double fade_duration = 300;

From aee93934d5c42792b41ef3b13c7baa748b7c3ee0 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 28 Jan 2022 21:22:09 +0900
Subject: [PATCH 2614/5547] Rename methods to make more sense (and always run
 through `AddOnce`)

---
 .../Visual/UserInterface/TestSceneDeleteLocalScore.cs  |  2 +-
 osu.Game/Online/Leaderboards/Leaderboard.cs            | 10 +++++-----
 .../OnlinePlay/Match/Components/MatchLeaderboard.cs    |  2 +-
 .../OnlinePlay/Playlists/PlaylistsRoomSubScreen.cs     |  2 +-
 .../Screens/Select/Leaderboards/BeatmapLeaderboard.cs  | 10 +++++-----
 osu.Game/Screens/Select/PlayBeatmapDetailArea.cs       |  2 +-
 6 files changed, 14 insertions(+), 14 deletions(-)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
index 4826d2fb33..4938fd1271 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
@@ -132,7 +132,7 @@ namespace osu.Game.Tests.Visual.UserInterface
             leaderboard.FinishTransforms(true); // After setting scores, we may be waiting for transforms to expire drawables
 
             leaderboard.BeatmapInfo = beatmapInfo;
-            leaderboard.RefreshScores(); // Required in the case that the beatmap hasn't changed
+            leaderboard.RefetchScores(); // Required in the case that the beatmap hasn't changed
         });
 
         [SetUpSteps]
diff --git a/osu.Game/Online/Leaderboards/Leaderboard.cs b/osu.Game/Online/Leaderboards/Leaderboard.cs
index e2a52b5db9..cd67fc7301 100644
--- a/osu.Game/Online/Leaderboards/Leaderboard.cs
+++ b/osu.Game/Online/Leaderboards/Leaderboard.cs
@@ -132,7 +132,7 @@ namespace osu.Game.Online.Leaderboards
                     return;
 
                 scope = value;
-                RefreshScores();
+                RefetchScores();
             }
         }
 
@@ -160,7 +160,7 @@ namespace osu.Game.Online.Leaderboards
                     case PlaceholderState.NetworkFailure:
                         replacePlaceholder(new ClickablePlaceholder(@"Couldn't fetch scores!", FontAwesome.Solid.Sync)
                         {
-                            Action = RefreshScores
+                            Action = RefetchScores
                         });
                         break;
 
@@ -272,15 +272,15 @@ namespace osu.Game.Online.Leaderboards
                 case APIState.Online:
                 case APIState.Offline:
                     if (IsOnlineScope)
-                        RefreshScores();
+                        RefetchScores();
 
                     break;
             }
         });
 
-        public void RefreshScores() => Scheduler.AddOnce(UpdateScores);
+        public void RefetchScores() => Scheduler.AddOnce(refetchScores);
 
-        protected void UpdateScores()
+        private void refetchScores()
         {
             // don't display any scores or placeholder until the first Scores_Set has been called.
             // this avoids scope changes flickering a "no scores" placeholder before initialisation of song select is finished.
diff --git a/osu.Game/Screens/OnlinePlay/Match/Components/MatchLeaderboard.cs b/osu.Game/Screens/OnlinePlay/Match/Components/MatchLeaderboard.cs
index 134e083c42..e4ec3ac4a5 100644
--- a/osu.Game/Screens/OnlinePlay/Match/Components/MatchLeaderboard.cs
+++ b/osu.Game/Screens/OnlinePlay/Match/Components/MatchLeaderboard.cs
@@ -26,7 +26,7 @@ namespace osu.Game.Screens.OnlinePlay.Match.Components
                     return;
 
                 Scores = null;
-                UpdateScores();
+                RefetchScores();
             }, true);
         }
 
diff --git a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSubScreen.cs b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSubScreen.cs
index 4114a5e9a0..542851cb0f 100644
--- a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSubScreen.cs
@@ -220,7 +220,7 @@ namespace osu.Game.Screens.OnlinePlay.Playlists
 
         protected override Screen CreateGameplayScreen() => new PlayerLoader(() => new PlaylistsPlayer(Room, SelectedItem.Value)
         {
-            Exited = () => leaderboard.RefreshScores()
+            Exited = () => leaderboard.RefetchScores()
         });
     }
 }
diff --git a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
index 31cbe91f5c..02e4e162dd 100644
--- a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
+++ b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
@@ -53,7 +53,7 @@ namespace osu.Game.Screens.Select.Leaderboards
                 Scores = null;
 
                 if (IsOnlineScope)
-                    UpdateScores();
+                    RefetchScores();
                 else
                 {
                     if (IsLoaded)
@@ -77,7 +77,7 @@ namespace osu.Game.Screens.Select.Leaderboards
 
                 filterMods = value;
 
-                UpdateScores();
+                RefetchScores();
             }
         }
 
@@ -96,11 +96,11 @@ namespace osu.Game.Screens.Select.Leaderboards
         [BackgroundDependencyLoader]
         private void load()
         {
-            ruleset.ValueChanged += _ => UpdateScores();
+            ruleset.ValueChanged += _ => RefetchScores();
             mods.ValueChanged += _ =>
             {
                 if (filterMods)
-                    UpdateScores();
+                    RefetchScores();
             };
         }
 
@@ -127,7 +127,7 @@ namespace osu.Game.Screens.Select.Leaderboards
                 (_, changes, ___) =>
                 {
                     if (!IsOnlineScope)
-                        RefreshScores();
+                        RefetchScores();
                 });
         }
 
diff --git a/osu.Game/Screens/Select/PlayBeatmapDetailArea.cs b/osu.Game/Screens/Select/PlayBeatmapDetailArea.cs
index b8b8e3e4bc..09f75b7658 100644
--- a/osu.Game/Screens/Select/PlayBeatmapDetailArea.cs
+++ b/osu.Game/Screens/Select/PlayBeatmapDetailArea.cs
@@ -53,7 +53,7 @@ namespace osu.Game.Screens.Select
         {
             base.Refresh();
 
-            Leaderboard.RefreshScores();
+            Leaderboard.RefetchScores();
         }
 
         protected override void OnTabChanged(BeatmapDetailAreaTabItem tab, bool selectedMods)

From b9dac6c3b2d312bc79fefff4d5abb1c24d78c00c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 28 Jan 2022 21:33:22 +0900
Subject: [PATCH 2615/5547] Reorder and tidy up bindable flows

---
 osu.Game/Online/Leaderboards/Leaderboard.cs | 81 ++++++++++++---------
 1 file changed, 45 insertions(+), 36 deletions(-)

diff --git a/osu.Game/Online/Leaderboards/Leaderboard.cs b/osu.Game/Online/Leaderboards/Leaderboard.cs
index cd67fc7301..af448b7d7b 100644
--- a/osu.Game/Online/Leaderboards/Leaderboard.cs
+++ b/osu.Game/Online/Leaderboards/Leaderboard.cs
@@ -46,6 +46,18 @@ namespace osu.Game.Online.Leaderboards
 
         private bool scoresLoadedOnce;
 
+        private APIRequest getScoresRequest;
+        private ScheduledDelegate getScoresRequestCallback;
+
+        protected abstract bool IsOnlineScope { get; }
+
+        [Resolved(CanBeNull = true)]
+        private IAPIProvider api { get; set; }
+
+        private ScheduledDelegate pendingUpdateScores;
+
+        private readonly IBindable<APIState> apiState = new Bindable<APIState>();
+
         private readonly Container content;
 
         protected override Container<Drawable> Content => content;
@@ -239,44 +251,34 @@ namespace osu.Game.Online.Leaderboards
 
         protected virtual void Reset()
         {
-            getScoresRequest?.Cancel();
-            getScoresRequest = null;
+            cancelPendingWork();
+
             Scores = null;
         }
 
-        [Resolved(CanBeNull = true)]
-        private IAPIProvider api { get; set; }
-
-        private ScheduledDelegate pendingUpdateScores;
-
-        private readonly IBindable<APIState> apiState = new Bindable<APIState>();
-
-        [BackgroundDependencyLoader]
-        private void load()
+        protected override void LoadComplete()
         {
+            base.LoadComplete();
+
             if (api != null)
-                apiState.BindTo(api.State);
-
-            apiState.BindValueChanged(onlineStateChanged, true);
-        }
-
-        private APIRequest getScoresRequest;
-        private ScheduledDelegate getScoresRequestCallback;
-
-        protected abstract bool IsOnlineScope { get; }
-
-        private void onlineStateChanged(ValueChangedEvent<APIState> state) => Schedule(() =>
-        {
-            switch (state.NewValue)
             {
-                case APIState.Online:
-                case APIState.Offline:
-                    if (IsOnlineScope)
-                        RefetchScores();
+                apiState.BindTo(api.State);
+                apiState.BindValueChanged(state =>
+                {
+                    switch (state.NewValue)
+                    {
+                        case APIState.Online:
+                        case APIState.Offline:
+                            if (IsOnlineScope)
+                                RefetchScores();
 
-                    break;
+                            break;
+                    }
+                });
             }
-        });
+
+            RefetchScores();
+        }
 
         public void RefetchScores() => Scheduler.AddOnce(refetchScores);
 
@@ -286,13 +288,8 @@ namespace osu.Game.Online.Leaderboards
             // this avoids scope changes flickering a "no scores" placeholder before initialisation of song select is finished.
             if (!scoresLoadedOnce) return;
 
-            getScoresRequest?.Cancel();
-            getScoresRequest = null;
+            cancelPendingWork();
 
-            getScoresRequestCallback?.Cancel();
-            getScoresRequestCallback = null;
-
-            pendingUpdateScores?.Cancel();
             pendingUpdateScores = Schedule(() =>
             {
                 PlaceholderState = PlaceholderState.Retrieving;
@@ -319,6 +316,18 @@ namespace osu.Game.Online.Leaderboards
             });
         }
 
+        private void cancelPendingWork()
+        {
+            getScoresRequest?.Cancel();
+            getScoresRequest = null;
+
+            getScoresRequestCallback?.Cancel();
+            getScoresRequestCallback = null;
+
+            pendingUpdateScores?.Cancel();
+            pendingUpdateScores = null;
+        }
+
         /// <summary>
         /// Performs a fetch/refresh of scores to be displayed.
         /// </summary>

From 64925b3feaafa353bbfb87af39e13ee9e762a8bb Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 28 Jan 2022 21:38:23 +0900
Subject: [PATCH 2616/5547] Remove unused `Content` override

---
 osu.Game/Online/Leaderboards/Leaderboard.cs | 8 ++------
 1 file changed, 2 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Online/Leaderboards/Leaderboard.cs b/osu.Game/Online/Leaderboards/Leaderboard.cs
index af448b7d7b..785c2e2ecf 100644
--- a/osu.Game/Online/Leaderboards/Leaderboard.cs
+++ b/osu.Game/Online/Leaderboards/Leaderboard.cs
@@ -29,7 +29,7 @@ namespace osu.Game.Online.Leaderboards
     /// </summary>
     /// <typeparam name="TScope">The scope of the leaderboard (ie. global or local).</typeparam>
     /// <typeparam name="TScoreInfo">The score model class.</typeparam>
-    public abstract class Leaderboard<TScope, TScoreInfo> : Container
+    public abstract class Leaderboard<TScope, TScoreInfo> : CompositeDrawable
     {
         private const double fade_duration = 300;
 
@@ -58,10 +58,6 @@ namespace osu.Game.Online.Leaderboards
 
         private readonly IBindable<APIState> apiState = new Bindable<APIState>();
 
-        private readonly Container content;
-
-        protected override Container<Drawable> Content => content;
-
         private ICollection<TScoreInfo> scores;
 
         public ICollection<TScoreInfo> Scores
@@ -231,7 +227,7 @@ namespace osu.Game.Online.Leaderboards
                             },
                             new Drawable[]
                             {
-                                content = new Container
+                                new Container
                                 {
                                     AutoSizeAxes = Axes.Y,
                                     RelativeSizeAxes = Axes.X,

From 17aa9f304000505d5aff1d04239f5fa828873871 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 28 Jan 2022 21:47:28 +0900
Subject: [PATCH 2617/5547] Remove pointless level of schedule/cancel logic

---
 osu.Game/Online/Leaderboards/Leaderboard.cs | 39 ++++++++-------------
 1 file changed, 15 insertions(+), 24 deletions(-)

diff --git a/osu.Game/Online/Leaderboards/Leaderboard.cs b/osu.Game/Online/Leaderboards/Leaderboard.cs
index 785c2e2ecf..7ab3d0343a 100644
--- a/osu.Game/Online/Leaderboards/Leaderboard.cs
+++ b/osu.Game/Online/Leaderboards/Leaderboard.cs
@@ -54,8 +54,6 @@ namespace osu.Game.Online.Leaderboards
         [Resolved(CanBeNull = true)]
         private IAPIProvider api { get; set; }
 
-        private ScheduledDelegate pendingUpdateScores;
-
         private readonly IBindable<APIState> apiState = new Bindable<APIState>();
 
         private ICollection<TScoreInfo> scores;
@@ -248,7 +246,6 @@ namespace osu.Game.Online.Leaderboards
         protected virtual void Reset()
         {
             cancelPendingWork();
-
             Scores = null;
         }
 
@@ -286,30 +283,27 @@ namespace osu.Game.Online.Leaderboards
 
             cancelPendingWork();
 
-            pendingUpdateScores = Schedule(() =>
+            PlaceholderState = PlaceholderState.Retrieving;
+            loading.Show();
+
+            getScoresRequest = FetchScores(scores => getScoresRequestCallback = Schedule(() =>
             {
-                PlaceholderState = PlaceholderState.Retrieving;
-                loading.Show();
+                Scores = scores.ToArray();
+                PlaceholderState = Scores.Any() ? PlaceholderState.Successful : PlaceholderState.NoScores;
+            }));
 
-                getScoresRequest = FetchScores(scores => getScoresRequestCallback = Schedule(() =>
-                {
-                    Scores = scores.ToArray();
-                    PlaceholderState = Scores.Any() ? PlaceholderState.Successful : PlaceholderState.NoScores;
-                }));
+            if (getScoresRequest == null)
+                return;
 
-                if (getScoresRequest == null)
+            getScoresRequest.Failure += e => getScoresRequestCallback = Schedule(() =>
+            {
+                if (e is OperationCanceledException)
                     return;
 
-                getScoresRequest.Failure += e => getScoresRequestCallback = Schedule(() =>
-                {
-                    if (e is OperationCanceledException)
-                        return;
-
-                    PlaceholderState = PlaceholderState.NetworkFailure;
-                });
-
-                api?.Queue(getScoresRequest);
+                PlaceholderState = PlaceholderState.NetworkFailure;
             });
+
+            api?.Queue(getScoresRequest);
         }
 
         private void cancelPendingWork()
@@ -319,9 +313,6 @@ namespace osu.Game.Online.Leaderboards
 
             getScoresRequestCallback?.Cancel();
             getScoresRequestCallback = null;
-
-            pendingUpdateScores?.Cancel();
-            pendingUpdateScores = null;
         }
 
         /// <summary>

From c5486586623acd425be534fced770e456493c85c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 28 Jan 2022 21:49:52 +0900
Subject: [PATCH 2618/5547] Remove move unused pieces

---
 osu.Game/Online/Leaderboards/Leaderboard.cs | 29 ++++++++-------------
 1 file changed, 11 insertions(+), 18 deletions(-)

diff --git a/osu.Game/Online/Leaderboards/Leaderboard.cs b/osu.Game/Online/Leaderboards/Leaderboard.cs
index 7ab3d0343a..a426d2b448 100644
--- a/osu.Game/Online/Leaderboards/Leaderboard.cs
+++ b/osu.Game/Online/Leaderboards/Leaderboard.cs
@@ -82,7 +82,13 @@ namespace osu.Game.Online.Leaderboards
                 // ensure placeholder is hidden when displaying scores
                 PlaceholderState = PlaceholderState.Successful;
 
-                var scoreFlow = CreateScoreFlow();
+                var scoreFlow = new FillFlowContainer<LeaderboardScore>
+                {
+                    RelativeSizeAxes = Axes.X,
+                    AutoSizeAxes = Axes.Y,
+                    Spacing = new Vector2(0f, 5f),
+                    Padding = new MarginPadding { Top = 10, Bottom = 5 },
+                };
                 scoreFlow.ChildrenEnumerable = scores.Select((s, index) => CreateDrawableScore(s, index + 1));
 
                 // schedule because we may not be loaded yet (LoadComponentAsync complains).
@@ -118,15 +124,6 @@ namespace osu.Game.Online.Leaderboards
             }
         }
 
-        protected virtual FillFlowContainer<LeaderboardScore> CreateScoreFlow()
-            => new FillFlowContainer<LeaderboardScore>
-            {
-                RelativeSizeAxes = Axes.X,
-                AutoSizeAxes = Axes.Y,
-                Spacing = new Vector2(0f, 5f),
-                Padding = new MarginPadding { Top = 10, Bottom = 5 },
-            };
-
         private TScope scope;
 
         public TScope Scope
@@ -345,9 +342,6 @@ namespace osu.Game.Online.Leaderboards
             currentPlaceholder = placeholder;
         }
 
-        protected virtual bool FadeBottom => true;
-        protected virtual bool FadeTop => false;
-
         protected override void UpdateAfterChildren()
         {
             base.UpdateAfterChildren();
@@ -366,22 +360,21 @@ namespace osu.Game.Online.Leaderboards
                 float topY = c.ToSpaceOfOtherDrawable(Vector2.Zero, scrollFlow).Y;
                 float bottomY = topY + LeaderboardScore.HEIGHT;
 
-                bool requireTopFade = FadeTop && topY <= fadeTop;
-                bool requireBottomFade = FadeBottom && bottomY >= fadeBottom;
+                bool requireBottomFade = bottomY >= fadeBottom;
 
-                if (!requireTopFade && !requireBottomFade)
+                if (!requireBottomFade)
                     c.Colour = Color4.White;
                 else if (topY > fadeBottom + LeaderboardScore.HEIGHT || bottomY < fadeTop - LeaderboardScore.HEIGHT)
                     c.Colour = Color4.Transparent;
                 else
                 {
-                    if (bottomY - fadeBottom > 0 && FadeBottom)
+                    if (bottomY - fadeBottom > 0)
                     {
                         c.Colour = ColourInfo.GradientVertical(
                             Color4.White.Opacity(Math.Min(1 - (topY - fadeBottom) / LeaderboardScore.HEIGHT, 1)),
                             Color4.White.Opacity(Math.Min(1 - (bottomY - fadeBottom) / LeaderboardScore.HEIGHT, 1)));
                     }
-                    else if (FadeTop)
+                    else
                     {
                         c.Colour = ColourInfo.GradientVertical(
                             Color4.White.Opacity(Math.Min(1 - (fadeTop - topY) / LeaderboardScore.HEIGHT, 1)),

From b85b2c01fb248db8a3deb773ba1ed5da930d07c2 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 28 Jan 2022 21:53:12 +0900
Subject: [PATCH 2619/5547] Reorder based on accessibility and add regions

---
 osu.Game/Online/Leaderboards/Leaderboard.cs | 268 ++++++++++----------
 1 file changed, 138 insertions(+), 130 deletions(-)

diff --git a/osu.Game/Online/Leaderboards/Leaderboard.cs b/osu.Game/Online/Leaderboards/Leaderboard.cs
index a426d2b448..d843dcb2bb 100644
--- a/osu.Game/Online/Leaderboards/Leaderboard.cs
+++ b/osu.Game/Online/Leaderboards/Leaderboard.cs
@@ -139,6 +139,139 @@ namespace osu.Game.Online.Leaderboards
             }
         }
 
+        protected Leaderboard()
+        {
+            InternalChildren = new Drawable[]
+            {
+                new OsuContextMenuContainer
+                {
+                    RelativeSizeAxes = Axes.Both,
+                    Masking = true,
+                    Child = new GridContainer
+                    {
+                        RelativeSizeAxes = Axes.Both,
+                        RowDimensions = new[]
+                        {
+                            new Dimension(),
+                            new Dimension(GridSizeMode.AutoSize),
+                        },
+                        Content = new[]
+                        {
+                            new Drawable[]
+                            {
+                                scrollContainer = new OsuScrollContainer
+                                {
+                                    RelativeSizeAxes = Axes.Both,
+                                    ScrollbarVisible = false,
+                                }
+                            },
+                            new Drawable[]
+                            {
+                                new Container
+                                {
+                                    AutoSizeAxes = Axes.Y,
+                                    RelativeSizeAxes = Axes.X,
+                                    Child = topScoreContainer = new UserTopScoreContainer<TScoreInfo>(CreateDrawableTopScore)
+                                },
+                            },
+                        },
+                    },
+                },
+                loading = new LoadingSpinner(),
+                placeholderContainer = new Container
+                {
+                    RelativeSizeAxes = Axes.Both
+                },
+            };
+        }
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            if (api != null)
+            {
+                apiState.BindTo(api.State);
+                apiState.BindValueChanged(state =>
+                {
+                    switch (state.NewValue)
+                    {
+                        case APIState.Online:
+                        case APIState.Offline:
+                            if (IsOnlineScope)
+                                RefetchScores();
+
+                            break;
+                    }
+                });
+            }
+
+            RefetchScores();
+        }
+
+        public void RefetchScores() => Scheduler.AddOnce(refetchScores);
+
+        protected virtual void Reset()
+        {
+            cancelPendingWork();
+            Scores = null;
+        }
+
+        /// <summary>
+        /// Performs a fetch/refresh of scores to be displayed.
+        /// </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 abstract APIRequest FetchScores(Action<IEnumerable<TScoreInfo>> scoresCallback);
+
+        protected abstract LeaderboardScore CreateDrawableScore(TScoreInfo model, int index);
+
+        protected abstract LeaderboardScore CreateDrawableTopScore(TScoreInfo model);
+
+        private void refetchScores()
+        {
+            // don't display any scores or placeholder until the first Scores_Set has been called.
+            // this avoids scope changes flickering a "no scores" placeholder before initialisation of song select is finished.
+            if (!scoresLoadedOnce) return;
+
+            cancelPendingWork();
+
+            PlaceholderState = PlaceholderState.Retrieving;
+            loading.Show();
+
+            getScoresRequest = FetchScores(scores => getScoresRequestCallback = Schedule(() =>
+            {
+                Scores = scores.ToArray();
+                PlaceholderState = Scores.Any() ? PlaceholderState.Successful : PlaceholderState.NoScores;
+            }));
+
+            if (getScoresRequest == null)
+                return;
+
+            getScoresRequest.Failure += e => getScoresRequestCallback = Schedule(() =>
+            {
+                if (e is OperationCanceledException)
+                    return;
+
+                PlaceholderState = PlaceholderState.NetworkFailure;
+            });
+
+            api?.Queue(getScoresRequest);
+        }
+
+        private void cancelPendingWork()
+        {
+            getScoresRequest?.Cancel();
+            getScoresRequest = null;
+
+            getScoresRequestCallback?.Cancel();
+            getScoresRequestCallback = null;
+        }
+
+        #region Placeholder handling
+
+        private Placeholder currentPlaceholder;
+
         private PlaceholderState placeholderState;
 
         /// <summary>
@@ -194,133 +327,6 @@ namespace osu.Game.Online.Leaderboards
             }
         }
 
-        protected Leaderboard()
-        {
-            InternalChildren = new Drawable[]
-            {
-                new OsuContextMenuContainer
-                {
-                    RelativeSizeAxes = Axes.Both,
-                    Masking = true,
-                    Child = new GridContainer
-                    {
-                        RelativeSizeAxes = Axes.Both,
-                        RowDimensions = new[]
-                        {
-                            new Dimension(),
-                            new Dimension(GridSizeMode.AutoSize),
-                        },
-                        Content = new[]
-                        {
-                            new Drawable[]
-                            {
-                                scrollContainer = new OsuScrollContainer
-                                {
-                                    RelativeSizeAxes = Axes.Both,
-                                    ScrollbarVisible = false,
-                                }
-                            },
-                            new Drawable[]
-                            {
-                                new Container
-                                {
-                                    AutoSizeAxes = Axes.Y,
-                                    RelativeSizeAxes = Axes.X,
-                                    Child = topScoreContainer = new UserTopScoreContainer<TScoreInfo>(CreateDrawableTopScore)
-                                },
-                            },
-                        },
-                    },
-                },
-                loading = new LoadingSpinner(),
-                placeholderContainer = new Container
-                {
-                    RelativeSizeAxes = Axes.Both
-                },
-            };
-        }
-
-        protected virtual void Reset()
-        {
-            cancelPendingWork();
-            Scores = null;
-        }
-
-        protected override void LoadComplete()
-        {
-            base.LoadComplete();
-
-            if (api != null)
-            {
-                apiState.BindTo(api.State);
-                apiState.BindValueChanged(state =>
-                {
-                    switch (state.NewValue)
-                    {
-                        case APIState.Online:
-                        case APIState.Offline:
-                            if (IsOnlineScope)
-                                RefetchScores();
-
-                            break;
-                    }
-                });
-            }
-
-            RefetchScores();
-        }
-
-        public void RefetchScores() => Scheduler.AddOnce(refetchScores);
-
-        private void refetchScores()
-        {
-            // don't display any scores or placeholder until the first Scores_Set has been called.
-            // this avoids scope changes flickering a "no scores" placeholder before initialisation of song select is finished.
-            if (!scoresLoadedOnce) return;
-
-            cancelPendingWork();
-
-            PlaceholderState = PlaceholderState.Retrieving;
-            loading.Show();
-
-            getScoresRequest = FetchScores(scores => getScoresRequestCallback = Schedule(() =>
-            {
-                Scores = scores.ToArray();
-                PlaceholderState = Scores.Any() ? PlaceholderState.Successful : PlaceholderState.NoScores;
-            }));
-
-            if (getScoresRequest == null)
-                return;
-
-            getScoresRequest.Failure += e => getScoresRequestCallback = Schedule(() =>
-            {
-                if (e is OperationCanceledException)
-                    return;
-
-                PlaceholderState = PlaceholderState.NetworkFailure;
-            });
-
-            api?.Queue(getScoresRequest);
-        }
-
-        private void cancelPendingWork()
-        {
-            getScoresRequest?.Cancel();
-            getScoresRequest = null;
-
-            getScoresRequestCallback?.Cancel();
-            getScoresRequestCallback = null;
-        }
-
-        /// <summary>
-        /// Performs a fetch/refresh of scores to be displayed.
-        /// </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 abstract APIRequest FetchScores(Action<IEnumerable<TScoreInfo>> scoresCallback);
-
-        private Placeholder currentPlaceholder;
-
         private void replacePlaceholder(Placeholder placeholder)
         {
             if (placeholder != null && placeholder.Equals(currentPlaceholder))
@@ -342,6 +348,10 @@ namespace osu.Game.Online.Leaderboards
             currentPlaceholder = placeholder;
         }
 
+        #endregion
+
+        #region Fade handling
+
         protected override void UpdateAfterChildren()
         {
             base.UpdateAfterChildren();
@@ -384,8 +394,6 @@ namespace osu.Game.Online.Leaderboards
             }
         }
 
-        protected abstract LeaderboardScore CreateDrawableScore(TScoreInfo model, int index);
-
-        protected abstract LeaderboardScore CreateDrawableTopScore(TScoreInfo model);
+        #endregion
     }
 }

From 661fec7c8abd1fba873a5003092d9f5f45da475c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 28 Jan 2022 21:59:29 +0900
Subject: [PATCH 2620/5547] Make score setter private

---
 .../Visual/SongSelect/TestSceneBeatmapLeaderboard.cs         | 5 ++++-
 .../Visual/UserInterface/TestSceneDeleteLocalScore.cs        | 3 ---
 osu.Game/Online/Leaderboards/Leaderboard.cs                  | 2 +-
 3 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
index e31be1d51a..7ffab2eebc 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
@@ -2,6 +2,7 @@
 // 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;
@@ -100,7 +101,7 @@ namespace osu.Game.Tests.Visual.SongSelect
         public void TestGlobalScoresDisplay()
         {
             AddStep(@"Set scope", () => leaderboard.Scope = BeatmapLeaderboardScope.Global);
-            AddStep(@"New Scores", () => leaderboard.Scores = generateSampleScores(null));
+            AddStep(@"New Scores", () => leaderboard.SetScores(generateSampleScores(null)));
         }
 
         [Test]
@@ -422,6 +423,8 @@ namespace osu.Game.Tests.Visual.SongSelect
             {
                 PlaceholderState = state;
             }
+
+            public void SetScores(ICollection<ScoreInfo> scores) => Scores = scores;
         }
     }
 }
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
index 4938fd1271..985ff6f251 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
@@ -128,9 +128,6 @@ namespace osu.Game.Tests.Visual.UserInterface
                 scoreManager.Undelete(r.All<ScoreInfo>().Where(s => s.DeletePending).ToList());
             });
 
-            leaderboard.Scores = null;
-            leaderboard.FinishTransforms(true); // After setting scores, we may be waiting for transforms to expire drawables
-
             leaderboard.BeatmapInfo = beatmapInfo;
             leaderboard.RefetchScores(); // Required in the case that the beatmap hasn't changed
         });
diff --git a/osu.Game/Online/Leaderboards/Leaderboard.cs b/osu.Game/Online/Leaderboards/Leaderboard.cs
index d843dcb2bb..0c58faa178 100644
--- a/osu.Game/Online/Leaderboards/Leaderboard.cs
+++ b/osu.Game/Online/Leaderboards/Leaderboard.cs
@@ -61,7 +61,7 @@ namespace osu.Game.Online.Leaderboards
         public ICollection<TScoreInfo> Scores
         {
             get => scores;
-            set
+            protected set
             {
                 scores = value;
 

From a700ad38499ed2fbaed093e5de5570b27f5cd0c3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 28 Jan 2022 22:04:34 +0900
Subject: [PATCH 2621/5547] Remove `scoresLoadedOnce` weirdness

---
 osu.Game/Online/Leaderboards/Leaderboard.cs | 8 --------
 1 file changed, 8 deletions(-)

diff --git a/osu.Game/Online/Leaderboards/Leaderboard.cs b/osu.Game/Online/Leaderboards/Leaderboard.cs
index 0c58faa178..238e883d24 100644
--- a/osu.Game/Online/Leaderboards/Leaderboard.cs
+++ b/osu.Game/Online/Leaderboards/Leaderboard.cs
@@ -44,8 +44,6 @@ namespace osu.Game.Online.Leaderboards
         private ScheduledDelegate showScoresDelegate;
         private CancellationTokenSource showScoresCancellationSource;
 
-        private bool scoresLoadedOnce;
-
         private APIRequest getScoresRequest;
         private ScheduledDelegate getScoresRequestCallback;
 
@@ -65,8 +63,6 @@ namespace osu.Game.Online.Leaderboards
             {
                 scores = value;
 
-                scoresLoadedOnce = true;
-
                 scrollFlow?.FadeOut(fade_duration, Easing.OutQuint).Expire();
                 scrollFlow = null;
 
@@ -230,10 +226,6 @@ namespace osu.Game.Online.Leaderboards
 
         private void refetchScores()
         {
-            // don't display any scores or placeholder until the first Scores_Set has been called.
-            // this avoids scope changes flickering a "no scores" placeholder before initialisation of song select is finished.
-            if (!scoresLoadedOnce) return;
-
             cancelPendingWork();
 
             PlaceholderState = PlaceholderState.Retrieving;

From c48e9f2bbdc2dba7360e5d0b7ef9e4dad12256e4 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 28 Jan 2022 22:13:52 +0900
Subject: [PATCH 2622/5547] Remove more unnecessary schedule/cancel logic

---
 osu.Game/Online/Leaderboards/Leaderboard.cs | 19 ++++++++++++-------
 1 file changed, 12 insertions(+), 7 deletions(-)

diff --git a/osu.Game/Online/Leaderboards/Leaderboard.cs b/osu.Game/Online/Leaderboards/Leaderboard.cs
index 238e883d24..e8fc2d126e 100644
--- a/osu.Game/Online/Leaderboards/Leaderboard.cs
+++ b/osu.Game/Online/Leaderboards/Leaderboard.cs
@@ -3,10 +3,12 @@
 
 using System;
 using System.Collections.Generic;
+using System.Diagnostics;
 using System.Linq;
 using System.Threading;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
+using osu.Framework.Development;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Colour;
@@ -41,7 +43,6 @@ namespace osu.Game.Online.Leaderboards
 
         private readonly LoadingSpinner loading;
 
-        private ScheduledDelegate showScoresDelegate;
         private CancellationTokenSource showScoresCancellationSource;
 
         private APIRequest getScoresRequest;
@@ -61,15 +62,16 @@ namespace osu.Game.Online.Leaderboards
             get => scores;
             protected set
             {
+                Debug.Assert(ThreadSafety.IsUpdateThread);
+
                 scores = value;
 
                 scrollFlow?.FadeOut(fade_duration, Easing.OutQuint).Expire();
                 scrollFlow = null;
 
-                showScoresDelegate?.Cancel();
                 showScoresCancellationSource?.Cancel();
 
-                if (scores == null || !scores.Any())
+                if (scores?.Any() != true)
                 {
                     loading.Hide();
                     return;
@@ -84,11 +86,11 @@ namespace osu.Game.Online.Leaderboards
                     AutoSizeAxes = Axes.Y,
                     Spacing = new Vector2(0f, 5f),
                     Padding = new MarginPadding { Top = 10, Bottom = 5 },
+                    ChildrenEnumerable = scores.Select((s, index) => CreateDrawableScore(s, index + 1))
                 };
-                scoreFlow.ChildrenEnumerable = scores.Select((s, index) => CreateDrawableScore(s, index + 1));
 
                 // schedule because we may not be loaded yet (LoadComponentAsync complains).
-                showScoresDelegate = Schedule(() => LoadComponentAsync(scoreFlow, _ =>
+                LoadComponentAsync(scoreFlow, _ =>
                 {
                     scrollContainer.Add(scrollFlow = scoreFlow);
 
@@ -100,9 +102,9 @@ namespace osu.Game.Online.Leaderboards
                             s.Show();
                     }
 
-                    scrollContainer.ScrollTo(0f, false);
+                    scrollContainer.ScrollToStart(false);
                     loading.Hide();
-                }, (showScoresCancellationSource = new CancellationTokenSource()).Token));
+                }, (showScoresCancellationSource = new CancellationTokenSource()).Token);
             }
         }
 
@@ -253,6 +255,9 @@ namespace osu.Game.Online.Leaderboards
 
         private void cancelPendingWork()
         {
+            showScoresCancellationSource?.Cancel();
+            showScoresCancellationSource = null;
+
             getScoresRequest?.Cancel();
             getScoresRequest = null;
 

From 13f445ddd5c49b2be0ccf2efeeff72c4703b1b8b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 28 Jan 2022 22:28:13 +0900
Subject: [PATCH 2623/5547] Move score update code into own method

---
 osu.Game/Online/Leaderboards/Leaderboard.cs | 91 +++++++++++----------
 1 file changed, 48 insertions(+), 43 deletions(-)

diff --git a/osu.Game/Online/Leaderboards/Leaderboard.cs b/osu.Game/Online/Leaderboards/Leaderboard.cs
index e8fc2d126e..0302568b34 100644
--- a/osu.Game/Online/Leaderboards/Leaderboard.cs
+++ b/osu.Game/Online/Leaderboards/Leaderboard.cs
@@ -33,6 +33,8 @@ namespace osu.Game.Online.Leaderboards
     /// <typeparam name="TScoreInfo">The score model class.</typeparam>
     public abstract class Leaderboard<TScope, TScoreInfo> : CompositeDrawable
     {
+        protected abstract bool IsOnlineScope { get; }
+
         private const double fade_duration = 300;
 
         private readonly OsuScrollContainer scrollContainer;
@@ -48,8 +50,6 @@ namespace osu.Game.Online.Leaderboards
         private APIRequest getScoresRequest;
         private ScheduledDelegate getScoresRequestCallback;
 
-        protected abstract bool IsOnlineScope { get; }
-
         [Resolved(CanBeNull = true)]
         private IAPIProvider api { get; set; }
 
@@ -62,49 +62,9 @@ namespace osu.Game.Online.Leaderboards
             get => scores;
             protected set
             {
-                Debug.Assert(ThreadSafety.IsUpdateThread);
-
                 scores = value;
 
-                scrollFlow?.FadeOut(fade_duration, Easing.OutQuint).Expire();
-                scrollFlow = null;
-
-                showScoresCancellationSource?.Cancel();
-
-                if (scores?.Any() != true)
-                {
-                    loading.Hide();
-                    return;
-                }
-
-                // ensure placeholder is hidden when displaying scores
-                PlaceholderState = PlaceholderState.Successful;
-
-                var scoreFlow = new FillFlowContainer<LeaderboardScore>
-                {
-                    RelativeSizeAxes = Axes.X,
-                    AutoSizeAxes = Axes.Y,
-                    Spacing = new Vector2(0f, 5f),
-                    Padding = new MarginPadding { Top = 10, Bottom = 5 },
-                    ChildrenEnumerable = scores.Select((s, index) => CreateDrawableScore(s, index + 1))
-                };
-
-                // schedule because we may not be loaded yet (LoadComponentAsync complains).
-                LoadComponentAsync(scoreFlow, _ =>
-                {
-                    scrollContainer.Add(scrollFlow = scoreFlow);
-
-                    int i = 0;
-
-                    foreach (var s in scrollFlow.Children)
-                    {
-                        using (s.BeginDelayedSequence(i++ * 50))
-                            s.Show();
-                    }
-
-                    scrollContainer.ScrollToStart(false);
-                    loading.Hide();
-                }, (showScoresCancellationSource = new CancellationTokenSource()).Token);
+                updateScoresDrawables();
             }
         }
 
@@ -324,6 +284,51 @@ namespace osu.Game.Online.Leaderboards
             }
         }
 
+        private void updateScoresDrawables()
+        {
+            Debug.Assert(ThreadSafety.IsUpdateThread);
+
+            scrollFlow?.FadeOut(fade_duration, Easing.OutQuint).Expire();
+            scrollFlow = null;
+
+            showScoresCancellationSource?.Cancel();
+
+            if (scores?.Any() != true)
+            {
+                loading.Hide();
+                return;
+            }
+
+            // ensure placeholder is hidden when displaying scores
+            PlaceholderState = PlaceholderState.Successful;
+
+            var scoreFlow = new FillFlowContainer<LeaderboardScore>
+            {
+                RelativeSizeAxes = Axes.X,
+                AutoSizeAxes = Axes.Y,
+                Spacing = new Vector2(0f, 5f),
+                Padding = new MarginPadding { Top = 10, Bottom = 5 },
+                ChildrenEnumerable = scores.Select((s, index) => CreateDrawableScore(s, index + 1))
+            };
+
+            // schedule because we may not be loaded yet (LoadComponentAsync complains).
+            LoadComponentAsync(scoreFlow, _ =>
+            {
+                scrollContainer.Add(scrollFlow = scoreFlow);
+
+                int i = 0;
+
+                foreach (var s in scrollFlow.Children)
+                {
+                    using (s.BeginDelayedSequence(i++ * 50))
+                        s.Show();
+                }
+
+                scrollContainer.ScrollToStart(false);
+                loading.Hide();
+            }, (showScoresCancellationSource = new CancellationTokenSource()).Token);
+        }
+
         private void replacePlaceholder(Placeholder placeholder)
         {
             if (placeholder != null && placeholder.Equals(currentPlaceholder))

From 3d59bab7c61cea8d71b362bd21f9bc183c3baf7d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 28 Jan 2022 22:47:45 +0900
Subject: [PATCH 2624/5547] Remove fetch callback logic completely

---
 osu.Game/Online/Leaderboards/Leaderboard.cs   |  25 +---
 .../Match/Components/MatchLeaderboard.cs      |   6 +-
 .../Select/Leaderboards/BeatmapLeaderboard.cs | 130 ++++++++----------
 3 files changed, 67 insertions(+), 94 deletions(-)

diff --git a/osu.Game/Online/Leaderboards/Leaderboard.cs b/osu.Game/Online/Leaderboards/Leaderboard.cs
index 0302568b34..eeb814b4cb 100644
--- a/osu.Game/Online/Leaderboards/Leaderboard.cs
+++ b/osu.Game/Online/Leaderboards/Leaderboard.cs
@@ -3,12 +3,11 @@
 
 using System;
 using System.Collections.Generic;
-using System.Diagnostics;
 using System.Linq;
 using System.Threading;
+using JetBrains.Annotations;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
-using osu.Framework.Development;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Colour;
@@ -178,9 +177,9 @@ namespace osu.Game.Online.Leaderboards
         /// <summary>
         /// Performs a fetch/refresh of scores to be displayed.
         /// </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 abstract APIRequest FetchScores(Action<IEnumerable<TScoreInfo>> scoresCallback);
+        [CanBeNull]
+        protected abstract APIRequest FetchScores();
 
         protected abstract LeaderboardScore CreateDrawableScore(TScoreInfo model, int index);
 
@@ -193,11 +192,7 @@ namespace osu.Game.Online.Leaderboards
             PlaceholderState = PlaceholderState.Retrieving;
             loading.Show();
 
-            getScoresRequest = FetchScores(scores => getScoresRequestCallback = Schedule(() =>
-            {
-                Scores = scores.ToArray();
-                PlaceholderState = Scores.Any() ? PlaceholderState.Successful : PlaceholderState.NoScores;
-            }));
+            getScoresRequest = FetchScores();
 
             if (getScoresRequest == null)
                 return;
@@ -240,11 +235,6 @@ namespace osu.Game.Online.Leaderboards
             get => placeholderState;
             set
             {
-                if (value != PlaceholderState.Successful)
-                {
-                    Reset();
-                }
-
                 if (value == placeholderState)
                     return;
 
@@ -284,10 +274,8 @@ namespace osu.Game.Online.Leaderboards
             }
         }
 
-        private void updateScoresDrawables()
+        private void updateScoresDrawables() => Scheduler.Add(() =>
         {
-            Debug.Assert(ThreadSafety.IsUpdateThread);
-
             scrollFlow?.FadeOut(fade_duration, Easing.OutQuint).Expire();
             scrollFlow = null;
 
@@ -296,6 +284,7 @@ namespace osu.Game.Online.Leaderboards
             if (scores?.Any() != true)
             {
                 loading.Hide();
+                PlaceholderState = PlaceholderState.NoScores;
                 return;
             }
 
@@ -327,7 +316,7 @@ namespace osu.Game.Online.Leaderboards
                 scrollContainer.ScrollToStart(false);
                 loading.Hide();
             }, (showScoresCancellationSource = new CancellationTokenSource()).Token);
-        }
+        }, false);
 
         private void replacePlaceholder(Placeholder placeholder)
         {
diff --git a/osu.Game/Screens/OnlinePlay/Match/Components/MatchLeaderboard.cs b/osu.Game/Screens/OnlinePlay/Match/Components/MatchLeaderboard.cs
index e4ec3ac4a5..5b60f64160 100644
--- a/osu.Game/Screens/OnlinePlay/Match/Components/MatchLeaderboard.cs
+++ b/osu.Game/Screens/OnlinePlay/Match/Components/MatchLeaderboard.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.Collections.Generic;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Game.Online.API;
@@ -32,7 +30,7 @@ namespace osu.Game.Screens.OnlinePlay.Match.Components
 
         protected override bool IsOnlineScope => true;
 
-        protected override APIRequest FetchScores(Action<IEnumerable<APIUserScoreAggregate>> scoresCallback)
+        protected override APIRequest FetchScores()
         {
             if (roomId.Value == null)
                 return null;
@@ -41,7 +39,7 @@ namespace osu.Game.Screens.OnlinePlay.Match.Components
 
             req.Success += r =>
             {
-                scoresCallback?.Invoke(r.Leaderboard);
+                Scores = r.Leaderboard;
                 TopScore = r.UserScore;
             };
 
diff --git a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
index 02e4e162dd..898b894541 100644
--- a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
+++ b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
@@ -25,12 +25,6 @@ namespace osu.Game.Screens.Select.Leaderboards
     {
         public Action<ScoreInfo> ScoreSelected;
 
-        [Resolved]
-        private RulesetStore rulesets { get; set; }
-
-        [Resolved]
-        private RealmAccess realm { get; set; }
-
         private BeatmapInfo beatmapInfo;
 
         public BeatmapInfo BeatmapInfo
@@ -52,13 +46,7 @@ namespace osu.Game.Screens.Select.Leaderboards
                 beatmapInfo = value;
                 Scores = null;
 
-                if (IsOnlineScope)
-                    RefetchScores();
-                else
-                {
-                    if (IsLoaded)
-                        refreshRealmSubscription();
-                }
+                RefetchScores();
             }
         }
 
@@ -93,6 +81,14 @@ namespace osu.Game.Screens.Select.Leaderboards
         [Resolved]
         private IAPIProvider api { get; set; }
 
+        [Resolved]
+        private RulesetStore rulesets { get; set; }
+
+        [Resolved]
+        private RealmAccess realm { get; set; }
+
+        private IDisposable scoreSubscription;
+
         [BackgroundDependencyLoader]
         private void load()
         {
@@ -104,33 +100,6 @@ namespace osu.Game.Screens.Select.Leaderboards
             };
         }
 
-        protected override void LoadComplete()
-        {
-            base.LoadComplete();
-
-            refreshRealmSubscription();
-        }
-
-        private IDisposable scoreSubscription;
-
-        private void refreshRealmSubscription()
-        {
-            scoreSubscription?.Dispose();
-            scoreSubscription = null;
-
-            if (beatmapInfo == null)
-                return;
-
-            scoreSubscription = realm.RegisterForNotifications(r =>
-                    r.All<ScoreInfo>()
-                     .Filter($"{nameof(ScoreInfo.BeatmapInfo)}.{nameof(BeatmapInfo.ID)} = $0", beatmapInfo.ID),
-                (_, changes, ___) =>
-                {
-                    if (!IsOnlineScope)
-                        RefetchScores();
-                });
-        }
-
         protected override void Reset()
         {
             base.Reset();
@@ -141,13 +110,11 @@ namespace osu.Game.Screens.Select.Leaderboards
 
         private CancellationTokenSource loadCancellationSource;
 
-        protected override APIRequest FetchScores(Action<IEnumerable<ScoreInfo>> scoresCallback)
+        protected override APIRequest FetchScores()
         {
             loadCancellationSource?.Cancel();
             loadCancellationSource = new CancellationTokenSource();
 
-            var cancellationToken = loadCancellationSource.Token;
-
             var fetchBeatmapInfo = BeatmapInfo;
 
             if (fetchBeatmapInfo == null)
@@ -158,31 +125,7 @@ namespace osu.Game.Screens.Select.Leaderboards
 
             if (Scope == BeatmapLeaderboardScope.Local)
             {
-                realm.Run(r =>
-                {
-                    var scores = r.All<ScoreInfo>()
-                                  .AsEnumerable()
-                                  // TODO: update to use a realm filter directly (or at least figure out the beatmap part to reduce scope).
-                                  .Where(s => !s.DeletePending && s.BeatmapInfo.ID == fetchBeatmapInfo.ID && s.Ruleset.ShortName == ruleset.Value.ShortName);
-
-                    if (filterMods && !mods.Value.Any())
-                    {
-                        // we need to filter out all scores that have any mods to get all local nomod scores
-                        scores = scores.Where(s => !s.Mods.Any());
-                    }
-                    else if (filterMods)
-                    {
-                        // otherwise find all the scores that have *any* of the currently selected mods (similar to how web applies mod filters)
-                        // we're creating and using a string list representation of selected mods so that it can be translated into the DB query itself
-                        var selectedMods = mods.Value.Select(m => m.Acronym);
-                        scores = scores.Where(s => s.Mods.Any(m => selectedMods.Contains(m.Acronym)));
-                    }
-
-                    scores = scores.Detach();
-
-                    scoreManager.OrderByTotalScoreAsync(scores.ToArray(), cancellationToken)
-                                .ContinueWith(ordered => scoresCallback?.Invoke(ordered.GetResultSafely()), TaskContinuationOptions.OnlyOnRanToCompletion);
-                });
+                subscribeToLocalScores();
 
                 return null;
             }
@@ -217,13 +160,13 @@ namespace osu.Game.Screens.Select.Leaderboards
 
             req.Success += r =>
             {
-                scoreManager.OrderByTotalScoreAsync(r.Scores.Select(s => s.CreateScoreInfo(rulesets, fetchBeatmapInfo)).ToArray(), cancellationToken)
+                scoreManager.OrderByTotalScoreAsync(r.Scores.Select(s => s.CreateScoreInfo(rulesets, fetchBeatmapInfo)).ToArray(), loadCancellationSource.Token)
                             .ContinueWith(task => Schedule(() =>
                             {
-                                if (cancellationToken.IsCancellationRequested)
+                                if (loadCancellationSource.IsCancellationRequested)
                                     return;
 
-                                scoresCallback?.Invoke(task.GetResultSafely());
+                                Scores = task.GetResultSafely();
                                 TopScore = r.UserScore?.CreateScoreInfo(rulesets, fetchBeatmapInfo);
                             }), TaskContinuationOptions.OnlyOnRanToCompletion);
             };
@@ -241,10 +184,53 @@ namespace osu.Game.Screens.Select.Leaderboards
             Action = () => ScoreSelected?.Invoke(model)
         };
 
+        private void subscribeToLocalScores()
+        {
+            scoreSubscription?.Dispose();
+            scoreSubscription = null;
+
+            if (beatmapInfo == null)
+                return;
+
+            scoreSubscription = realm.RegisterForNotifications(r =>
+                r.All<ScoreInfo>().Filter($"{nameof(ScoreInfo.BeatmapInfo)}.{nameof(BeatmapInfo.ID)} == $0"
+                                          + $" AND {nameof(ScoreInfo.Ruleset)}.{nameof(RulesetInfo.ShortName)} == $1"
+                                          + $" AND {nameof(ScoreInfo.DeletePending)} == false"
+                    , beatmapInfo.ID, ruleset.Value.ShortName), localScoresChanged);
+        }
+
+        private void localScoresChanged(IRealmCollection<ScoreInfo> sender, ChangeSet changes, Exception exception)
+        {
+            if (IsOnlineScope)
+                return;
+
+            var scores = sender.AsEnumerable();
+
+            if (filterMods && !mods.Value.Any())
+            {
+                // we need to filter out all scores that have any mods to get all local nomod scores
+                scores = scores.Where(s => !s.Mods.Any());
+            }
+            else if (filterMods)
+            {
+                // otherwise find all the scores that have *any* of the currently selected mods (similar to how web applies mod filters)
+                // we're creating and using a string list representation of selected mods so that it can be translated into the DB query itself
+                var selectedMods = mods.Value.Select(m => m.Acronym);
+                scores = scores.Where(s => s.Mods.Any(m => selectedMods.Contains(m.Acronym)));
+            }
+
+            scores = scores.Detach();
+
+            scoreManager.OrderByTotalScoreAsync(scores.ToArray(), loadCancellationSource.Token)
+                        .ContinueWith(ordered =>
+                        {
+                            Scores = ordered.GetResultSafely();
+                        }, TaskContinuationOptions.OnlyOnRanToCompletion);
+        }
+
         protected override void Dispose(bool isDisposing)
         {
             base.Dispose(isDisposing);
-
             scoreSubscription?.Dispose();
         }
     }

From daea13f49158b5c464f20c4b395a85bd46206991 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 28 Jan 2022 23:14:26 +0900
Subject: [PATCH 2625/5547] Simplify flow of cancellation token

---
 osu.Game/Online/Leaderboards/Leaderboard.cs   | 42 ++++++------
 .../Match/Components/MatchLeaderboard.cs      |  6 +-
 .../Select/Leaderboards/BeatmapLeaderboard.cs | 65 +++++++++----------
 3 files changed, 55 insertions(+), 58 deletions(-)

diff --git a/osu.Game/Online/Leaderboards/Leaderboard.cs b/osu.Game/Online/Leaderboards/Leaderboard.cs
index eeb814b4cb..0d430f4903 100644
--- a/osu.Game/Online/Leaderboards/Leaderboard.cs
+++ b/osu.Game/Online/Leaderboards/Leaderboard.cs
@@ -3,6 +3,7 @@
 
 using System;
 using System.Collections.Generic;
+using System.Diagnostics;
 using System.Linq;
 using System.Threading;
 using JetBrains.Annotations;
@@ -13,7 +14,6 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Colour;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Sprites;
-using osu.Framework.Threading;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Cursor;
 using osu.Game.Graphics.UserInterface;
@@ -44,10 +44,9 @@ namespace osu.Game.Online.Leaderboards
 
         private readonly LoadingSpinner loading;
 
-        private CancellationTokenSource showScoresCancellationSource;
+        private CancellationTokenSource currentFetchCancellationSource;
 
-        private APIRequest getScoresRequest;
-        private ScheduledDelegate getScoresRequestCallback;
+        private APIRequest fetchScoresRequest;
 
         [Resolved(CanBeNull = true)]
         private IAPIProvider api { get; set; }
@@ -62,7 +61,6 @@ namespace osu.Game.Online.Leaderboards
             protected set
             {
                 scores = value;
-
                 updateScoresDrawables();
             }
         }
@@ -177,9 +175,10 @@ namespace osu.Game.Online.Leaderboards
         /// <summary>
         /// Performs a fetch/refresh of scores to be displayed.
         /// </summary>
+        /// <param name="cancellationToken"></param>
         /// <returns>An <see cref="APIRequest"/> responsible for the fetch operation. This will be queued and performed automatically.</returns>
         [CanBeNull]
-        protected abstract APIRequest FetchScores();
+        protected abstract APIRequest FetchScores(CancellationToken cancellationToken);
 
         protected abstract LeaderboardScore CreateDrawableScore(TScoreInfo model, int index);
 
@@ -187,37 +186,36 @@ namespace osu.Game.Online.Leaderboards
 
         private void refetchScores()
         {
-            cancelPendingWork();
+            Reset();
 
             PlaceholderState = PlaceholderState.Retrieving;
             loading.Show();
 
-            getScoresRequest = FetchScores();
+            currentFetchCancellationSource = new CancellationTokenSource();
 
-            if (getScoresRequest == null)
+            fetchScoresRequest = FetchScores(currentFetchCancellationSource.Token);
+
+            if (fetchScoresRequest == null)
                 return;
 
-            getScoresRequest.Failure += e => getScoresRequestCallback = Schedule(() =>
+            fetchScoresRequest.Failure += e => Schedule(() =>
             {
-                if (e is OperationCanceledException)
+                if (e is OperationCanceledException || currentFetchCancellationSource.IsCancellationRequested)
                     return;
 
                 PlaceholderState = PlaceholderState.NetworkFailure;
             });
 
-            api?.Queue(getScoresRequest);
+            api?.Queue(fetchScoresRequest);
         }
 
         private void cancelPendingWork()
         {
-            showScoresCancellationSource?.Cancel();
-            showScoresCancellationSource = null;
+            currentFetchCancellationSource?.Cancel();
+            currentFetchCancellationSource = null;
 
-            getScoresRequest?.Cancel();
-            getScoresRequest = null;
-
-            getScoresRequestCallback?.Cancel();
-            getScoresRequestCallback = null;
+            fetchScoresRequest?.Cancel();
+            fetchScoresRequest = null;
         }
 
         #region Placeholder handling
@@ -279,8 +277,6 @@ namespace osu.Game.Online.Leaderboards
             scrollFlow?.FadeOut(fade_duration, Easing.OutQuint).Expire();
             scrollFlow = null;
 
-            showScoresCancellationSource?.Cancel();
-
             if (scores?.Any() != true)
             {
                 loading.Hide();
@@ -288,6 +284,8 @@ namespace osu.Game.Online.Leaderboards
                 return;
             }
 
+            Debug.Assert(!currentFetchCancellationSource.IsCancellationRequested);
+
             // ensure placeholder is hidden when displaying scores
             PlaceholderState = PlaceholderState.Successful;
 
@@ -315,7 +313,7 @@ namespace osu.Game.Online.Leaderboards
 
                 scrollContainer.ScrollToStart(false);
                 loading.Hide();
-            }, (showScoresCancellationSource = new CancellationTokenSource()).Token);
+            }, currentFetchCancellationSource.Token);
         }, false);
 
         private void replacePlaceholder(Placeholder placeholder)
diff --git a/osu.Game/Screens/OnlinePlay/Match/Components/MatchLeaderboard.cs b/osu.Game/Screens/OnlinePlay/Match/Components/MatchLeaderboard.cs
index 5b60f64160..1945899a11 100644
--- a/osu.Game/Screens/OnlinePlay/Match/Components/MatchLeaderboard.cs
+++ b/osu.Game/Screens/OnlinePlay/Match/Components/MatchLeaderboard.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.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Game.Online.API;
@@ -30,7 +31,7 @@ namespace osu.Game.Screens.OnlinePlay.Match.Components
 
         protected override bool IsOnlineScope => true;
 
-        protected override APIRequest FetchScores()
+        protected override APIRequest FetchScores(CancellationToken cancellationToken)
         {
             if (roomId.Value == null)
                 return null;
@@ -39,6 +40,9 @@ namespace osu.Game.Screens.OnlinePlay.Match.Components
 
             req.Success += r =>
             {
+                if (cancellationToken.IsCancellationRequested)
+                    return;
+
                 Scores = r.Leaderboard;
                 TopScore = r.UserScore;
             };
diff --git a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
index 898b894541..388395c9f9 100644
--- a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
+++ b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
@@ -108,13 +108,8 @@ namespace osu.Game.Screens.Select.Leaderboards
 
         protected override bool IsOnlineScope => Scope != BeatmapLeaderboardScope.Local;
 
-        private CancellationTokenSource loadCancellationSource;
-
-        protected override APIRequest FetchScores()
+        protected override APIRequest FetchScores(CancellationToken cancellationToken)
         {
-            loadCancellationSource?.Cancel();
-            loadCancellationSource = new CancellationTokenSource();
-
             var fetchBeatmapInfo = BeatmapInfo;
 
             if (fetchBeatmapInfo == null)
@@ -125,7 +120,7 @@ namespace osu.Game.Screens.Select.Leaderboards
 
             if (Scope == BeatmapLeaderboardScope.Local)
             {
-                subscribeToLocalScores();
+                subscribeToLocalScores(cancellationToken);
 
                 return null;
             }
@@ -160,10 +155,10 @@ namespace osu.Game.Screens.Select.Leaderboards
 
             req.Success += r =>
             {
-                scoreManager.OrderByTotalScoreAsync(r.Scores.Select(s => s.CreateScoreInfo(rulesets, fetchBeatmapInfo)).ToArray(), loadCancellationSource.Token)
+                scoreManager.OrderByTotalScoreAsync(r.Scores.Select(s => s.CreateScoreInfo(rulesets, fetchBeatmapInfo)).ToArray(), cancellationToken)
                             .ContinueWith(task => Schedule(() =>
                             {
-                                if (loadCancellationSource.IsCancellationRequested)
+                                if (cancellationToken.IsCancellationRequested)
                                     return;
 
                                 Scores = task.GetResultSafely();
@@ -184,7 +179,7 @@ namespace osu.Game.Screens.Select.Leaderboards
             Action = () => ScoreSelected?.Invoke(model)
         };
 
-        private void subscribeToLocalScores()
+        private void subscribeToLocalScores(CancellationToken cancellationToken)
         {
             scoreSubscription?.Dispose();
             scoreSubscription = null;
@@ -197,35 +192,35 @@ namespace osu.Game.Screens.Select.Leaderboards
                                           + $" AND {nameof(ScoreInfo.Ruleset)}.{nameof(RulesetInfo.ShortName)} == $1"
                                           + $" AND {nameof(ScoreInfo.DeletePending)} == false"
                     , beatmapInfo.ID, ruleset.Value.ShortName), localScoresChanged);
-        }
 
-        private void localScoresChanged(IRealmCollection<ScoreInfo> sender, ChangeSet changes, Exception exception)
-        {
-            if (IsOnlineScope)
-                return;
-
-            var scores = sender.AsEnumerable();
-
-            if (filterMods && !mods.Value.Any())
+            void localScoresChanged(IRealmCollection<ScoreInfo> sender, ChangeSet changes, Exception exception)
             {
-                // we need to filter out all scores that have any mods to get all local nomod scores
-                scores = scores.Where(s => !s.Mods.Any());
-            }
-            else if (filterMods)
-            {
-                // otherwise find all the scores that have *any* of the currently selected mods (similar to how web applies mod filters)
-                // we're creating and using a string list representation of selected mods so that it can be translated into the DB query itself
-                var selectedMods = mods.Value.Select(m => m.Acronym);
-                scores = scores.Where(s => s.Mods.Any(m => selectedMods.Contains(m.Acronym)));
-            }
+                if (IsOnlineScope || cancellationToken.IsCancellationRequested)
+                    return;
 
-            scores = scores.Detach();
+                var scores = sender.AsEnumerable();
 
-            scoreManager.OrderByTotalScoreAsync(scores.ToArray(), loadCancellationSource.Token)
-                        .ContinueWith(ordered =>
-                        {
-                            Scores = ordered.GetResultSafely();
-                        }, TaskContinuationOptions.OnlyOnRanToCompletion);
+                if (filterMods && !mods.Value.Any())
+                {
+                    // we need to filter out all scores that have any mods to get all local nomod scores
+                    scores = scores.Where(s => !s.Mods.Any());
+                }
+                else if (filterMods)
+                {
+                    // otherwise find all the scores that have *any* of the currently selected mods (similar to how web applies mod filters)
+                    // we're creating and using a string list representation of selected mods so that it can be translated into the DB query itself
+                    var selectedMods = mods.Value.Select(m => m.Acronym);
+                    scores = scores.Where(s => s.Mods.Any(m => selectedMods.Contains(m.Acronym)));
+                }
+
+                scores = scores.Detach();
+
+                scoreManager.OrderByTotalScoreAsync(scores.ToArray(), cancellationToken)
+                            .ContinueWith(ordered =>
+                            {
+                                Scores = ordered.GetResultSafely();
+                            }, TaskContinuationOptions.OnlyOnRanToCompletion);
+            }
         }
 
         protected override void Dispose(bool isDisposing)

From 0293d95f829f7b3596e472244e42ed040ee62717 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 28 Jan 2022 23:17:06 +0900
Subject: [PATCH 2626/5547] Simplify `IsOnlineScope` usage

---
 osu.Game/Online/Leaderboards/Leaderboard.cs                | 3 +++
 osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs | 2 +-
 2 files changed, 4 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Online/Leaderboards/Leaderboard.cs b/osu.Game/Online/Leaderboards/Leaderboard.cs
index 0d430f4903..6c2f0d9425 100644
--- a/osu.Game/Online/Leaderboards/Leaderboard.cs
+++ b/osu.Game/Online/Leaderboards/Leaderboard.cs
@@ -32,6 +32,9 @@ namespace osu.Game.Online.Leaderboards
     /// <typeparam name="TScoreInfo">The score model class.</typeparam>
     public abstract class Leaderboard<TScope, TScoreInfo> : CompositeDrawable
     {
+        /// <summary>
+        /// Whether the current scope should refetch in response to changes in API connectivity state.
+        /// </summary>
         protected abstract bool IsOnlineScope { get; }
 
         private const double fade_duration = 300;
diff --git a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
index 388395c9f9..e55bd56e62 100644
--- a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
+++ b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
@@ -195,7 +195,7 @@ namespace osu.Game.Screens.Select.Leaderboards
 
             void localScoresChanged(IRealmCollection<ScoreInfo> sender, ChangeSet changes, Exception exception)
             {
-                if (IsOnlineScope || cancellationToken.IsCancellationRequested)
+                if (cancellationToken.IsCancellationRequested)
                     return;
 
                 var scores = sender.AsEnumerable();

From d0b74a91fba148d56fbd0ac586e5f6e1159e2a92 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 29 Jan 2022 02:12:36 +0900
Subject: [PATCH 2627/5547] Fix edge cases with score drawable loading

---
 osu.Game/Online/Leaderboards/Leaderboard.cs   | 45 ++++++++++---------
 .../Select/Leaderboards/BeatmapLeaderboard.cs |  1 -
 2 files changed, 24 insertions(+), 22 deletions(-)

diff --git a/osu.Game/Online/Leaderboards/Leaderboard.cs b/osu.Game/Online/Leaderboards/Leaderboard.cs
index 6c2f0d9425..a1f07c469a 100644
--- a/osu.Game/Online/Leaderboards/Leaderboard.cs
+++ b/osu.Game/Online/Leaderboards/Leaderboard.cs
@@ -3,7 +3,6 @@
 
 using System;
 using System.Collections.Generic;
-using System.Diagnostics;
 using System.Linq;
 using System.Threading;
 using JetBrains.Annotations;
@@ -43,11 +42,12 @@ namespace osu.Game.Online.Leaderboards
         private readonly Container placeholderContainer;
         private readonly UserTopScoreContainer<TScoreInfo> topScoreContainer;
 
-        private FillFlowContainer<LeaderboardScore> scrollFlow;
+        private FillFlowContainer<LeaderboardScore> scoreFlowContainer;
 
         private readonly LoadingSpinner loading;
 
         private CancellationTokenSource currentFetchCancellationSource;
+        private CancellationTokenSource currentScoresAsyncLoadCancellationSource;
 
         private APIRequest fetchScoresRequest;
 
@@ -64,7 +64,7 @@ namespace osu.Game.Online.Leaderboards
             protected set
             {
                 scores = value;
-                updateScoresDrawables();
+                Scheduler.AddOnce(updateScoresDrawables);
             }
         }
 
@@ -239,6 +239,8 @@ namespace osu.Game.Online.Leaderboards
                 if (value == placeholderState)
                     return;
 
+                loading.Hide();
+
                 switch (placeholderState = value)
                 {
                     case PlaceholderState.NetworkFailure:
@@ -275,40 +277,41 @@ namespace osu.Game.Online.Leaderboards
             }
         }
 
-        private void updateScoresDrawables() => Scheduler.Add(() =>
+        private void updateScoresDrawables()
         {
-            scrollFlow?.FadeOut(fade_duration, Easing.OutQuint).Expire();
-            scrollFlow = null;
+            currentScoresAsyncLoadCancellationSource?.Cancel();
+            currentScoresAsyncLoadCancellationSource = new CancellationTokenSource();
+
+            scoreFlowContainer?
+                .FadeOut(fade_duration, Easing.OutQuint)
+                .Expire();
+            scoreFlowContainer = null;
+
+            loading.Hide();
 
             if (scores?.Any() != true)
             {
-                loading.Hide();
                 PlaceholderState = PlaceholderState.NoScores;
                 return;
             }
 
-            Debug.Assert(!currentFetchCancellationSource.IsCancellationRequested);
-
             // ensure placeholder is hidden when displaying scores
             PlaceholderState = PlaceholderState.Successful;
 
-            var scoreFlow = new FillFlowContainer<LeaderboardScore>
+            LoadComponentAsync(new FillFlowContainer<LeaderboardScore>
             {
                 RelativeSizeAxes = Axes.X,
                 AutoSizeAxes = Axes.Y,
                 Spacing = new Vector2(0f, 5f),
                 Padding = new MarginPadding { Top = 10, Bottom = 5 },
                 ChildrenEnumerable = scores.Select((s, index) => CreateDrawableScore(s, index + 1))
-            };
-
-            // schedule because we may not be loaded yet (LoadComponentAsync complains).
-            LoadComponentAsync(scoreFlow, _ =>
+            }, newFlow =>
             {
-                scrollContainer.Add(scrollFlow = scoreFlow);
+                scrollContainer.Add(scoreFlowContainer = newFlow);
 
                 int i = 0;
 
-                foreach (var s in scrollFlow.Children)
+                foreach (var s in scoreFlowContainer.Children)
                 {
                     using (s.BeginDelayedSequence(i++ * 50))
                         s.Show();
@@ -316,8 +319,8 @@ namespace osu.Game.Online.Leaderboards
 
                 scrollContainer.ScrollToStart(false);
                 loading.Hide();
-            }, currentFetchCancellationSource.Token);
-        }, false);
+            }, currentScoresAsyncLoadCancellationSource.Token);
+        }
 
         private void replacePlaceholder(Placeholder placeholder)
         {
@@ -354,12 +357,12 @@ namespace osu.Game.Online.Leaderboards
             if (!scrollContainer.IsScrolledToEnd())
                 fadeBottom -= LeaderboardScore.HEIGHT;
 
-            if (scrollFlow == null)
+            if (scoreFlowContainer == null)
                 return;
 
-            foreach (var c in scrollFlow.Children)
+            foreach (var c in scoreFlowContainer.Children)
             {
-                float topY = c.ToSpaceOfOtherDrawable(Vector2.Zero, scrollFlow).Y;
+                float topY = c.ToSpaceOfOtherDrawable(Vector2.Zero, scoreFlowContainer).Y;
                 float bottomY = topY + LeaderboardScore.HEIGHT;
 
                 bool requireBottomFade = bottomY >= fadeBottom;
diff --git a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
index e55bd56e62..31868624bb 100644
--- a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
+++ b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
@@ -121,7 +121,6 @@ namespace osu.Game.Screens.Select.Leaderboards
             if (Scope == BeatmapLeaderboardScope.Local)
             {
                 subscribeToLocalScores(cancellationToken);
-
                 return null;
             }
 

From 6f54f8ad7897cc9bfa31e3ad00660eff3efeef59 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 29 Jan 2022 12:18:34 +0900
Subject: [PATCH 2628/5547] Add more safety around `CancellationToken` usage

---
 osu.Game/Online/Leaderboards/Leaderboard.cs | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Online/Leaderboards/Leaderboard.cs b/osu.Game/Online/Leaderboards/Leaderboard.cs
index a1f07c469a..cc6d7a7b62 100644
--- a/osu.Game/Online/Leaderboards/Leaderboard.cs
+++ b/osu.Game/Online/Leaderboards/Leaderboard.cs
@@ -3,11 +3,13 @@
 
 using System;
 using System.Collections.Generic;
+using System.Diagnostics;
 using System.Linq;
 using System.Threading;
 using JetBrains.Annotations;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
+using osu.Framework.Development;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Colour;
@@ -189,6 +191,8 @@ namespace osu.Game.Online.Leaderboards
 
         private void refetchScores()
         {
+            Debug.Assert(ThreadSafety.IsUpdateThread);
+
             Reset();
 
             PlaceholderState = PlaceholderState.Retrieving;
@@ -215,10 +219,8 @@ namespace osu.Game.Online.Leaderboards
         private void cancelPendingWork()
         {
             currentFetchCancellationSource?.Cancel();
-            currentFetchCancellationSource = null;
-
+            currentScoresAsyncLoadCancellationSource?.Cancel();
             fetchScoresRequest?.Cancel();
-            fetchScoresRequest = null;
         }
 
         #region Placeholder handling
@@ -280,7 +282,6 @@ namespace osu.Game.Online.Leaderboards
         private void updateScoresDrawables()
         {
             currentScoresAsyncLoadCancellationSource?.Cancel();
-            currentScoresAsyncLoadCancellationSource = new CancellationTokenSource();
 
             scoreFlowContainer?
                 .FadeOut(fade_duration, Easing.OutQuint)
@@ -319,7 +320,7 @@ namespace osu.Game.Online.Leaderboards
 
                 scrollContainer.ScrollToStart(false);
                 loading.Hide();
-            }, currentScoresAsyncLoadCancellationSource.Token);
+            }, (currentScoresAsyncLoadCancellationSource = new CancellationTokenSource()).Token);
         }
 
         private void replacePlaceholder(Placeholder placeholder)

From a915b9cd3093bd2ede73c3d6ef9470ff12967dc1 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 29 Jan 2022 23:12:57 +0900
Subject: [PATCH 2629/5547] Fix occasional failures in
 `TestSceneDeleteLocalScore`

---
 .../Visual/UserInterface/TestSceneDeleteLocalScore.cs         | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
index 985ff6f251..da4cf9c6e3 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
@@ -135,11 +135,9 @@ namespace osu.Game.Tests.Visual.UserInterface
         [SetUpSteps]
         public void SetupSteps()
         {
-            // Ensure the leaderboard has finished async-loading drawables
-            AddUntilStep("wait for drawables", () => leaderboard.ChildrenOfType<LeaderboardScore>().Any());
-
             // Ensure the leaderboard items have finished showing up
             AddStep("finish transforms", () => leaderboard.FinishTransforms(true));
+            AddUntilStep("wait for drawables", () => leaderboard.ChildrenOfType<LeaderboardScore>().Any());
         }
 
         [Test]

From 9861c50b33f8fa036e8bdf62ff1f646cab55c8ef Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 30 Jan 2022 00:03:22 +0900
Subject: [PATCH 2630/5547] Remove pointless tests that no longer show anything
 valid

---
 .../Visual/SongSelect/TestSceneBeatmapLeaderboard.cs       | 7 -------
 1 file changed, 7 deletions(-)

diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
index 7ffab2eebc..b4b66e8afa 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
@@ -122,13 +122,6 @@ namespace osu.Game.Tests.Visual.SongSelect
             AddStep(@"None selected", () => leaderboard.SetRetrievalState(PlaceholderState.NoneSelected));
         }
 
-        [Test]
-        public void TestBeatmapStates()
-        {
-            foreach (BeatmapOnlineStatus status in Enum.GetValues(typeof(BeatmapOnlineStatus)))
-                AddStep($"{status} beatmap", () => showBeatmapWithStatus(status));
-        }
-
         private void showPersonalBestWithNullPosition()
         {
             leaderboard.TopScore = new ScoreInfo

From e408d8ef0e1ced02cf3842c95318814e987c3303 Mon Sep 17 00:00:00 2001
From: Nitrous <nathan.alo2000@gmail.com>
Date: Sat, 29 Jan 2022 23:19:51 +0800
Subject: [PATCH 2631/5547] rename `Frames` to `ReplayFrames`

---
 .../Mods/TestSceneOsuModAlternate.cs                   |  8 ++++----
 osu.Game/Tests/Visual/ModTestScene.cs                  | 10 +++++-----
 2 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModAlternate.cs b/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModAlternate.cs
index 7b3eaa7ffd..de1f61a0bd 100644
--- a/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModAlternate.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModAlternate.cs
@@ -33,7 +33,7 @@ namespace osu.Game.Rulesets.Osu.Tests.Mods
                     },
                 },
             },
-            Frames = new List<ReplayFrame>
+            ReplayFrames = new List<ReplayFrame>
             {
                 new OsuReplayFrame(500, new Vector2(200), OsuAction.LeftButton),
                 new OsuReplayFrame(501, new Vector2(200)),
@@ -73,7 +73,7 @@ namespace osu.Game.Rulesets.Osu.Tests.Mods
                     },
                 },
             },
-            Frames = new List<ReplayFrame>
+            ReplayFrames = new List<ReplayFrame>
             {
                 new OsuReplayFrame(500, new Vector2(100), OsuAction.LeftButton),
                 new OsuReplayFrame(501, new Vector2(100)),
@@ -108,7 +108,7 @@ namespace osu.Game.Rulesets.Osu.Tests.Mods
                     },
                 },
             },
-            Frames = new List<ReplayFrame>
+            ReplayFrames = new List<ReplayFrame>
             {
                 new OsuReplayFrame(500, new Vector2(100), OsuAction.LeftButton),
                 new OsuReplayFrame(501, new Vector2(100)),
@@ -142,7 +142,7 @@ namespace osu.Game.Rulesets.Osu.Tests.Mods
                     }
                 }
             },
-            Frames = new List<ReplayFrame>
+            ReplayFrames = new List<ReplayFrame>
             {
                 new OsuReplayFrame(500, new Vector2(100), OsuAction.LeftButton),
                 new OsuReplayFrame(501, new Vector2(100)),
diff --git a/osu.Game/Tests/Visual/ModTestScene.cs b/osu.Game/Tests/Visual/ModTestScene.cs
index 96fafa8727..2505864d59 100644
--- a/osu.Game/Tests/Visual/ModTestScene.cs
+++ b/osu.Game/Tests/Visual/ModTestScene.cs
@@ -72,14 +72,14 @@ namespace osu.Game.Tests.Visual
 
             protected override void PrepareReplay()
             {
-                if (currentTestData.Autoplay && currentTestData.Frames?.Count > 0)
-                    throw new InvalidOperationException(@$"{nameof(ModTestData.Autoplay)} must be false when {nameof(ModTestData.Frames)} is specified.");
+                if (currentTestData.Autoplay && currentTestData.ReplayFrames?.Count > 0)
+                    throw new InvalidOperationException(@$"{nameof(ModTestData.Autoplay)} must be false when {nameof(ModTestData.ReplayFrames)} is specified.");
 
-                if (currentTestData.Frames != null)
+                if (currentTestData.ReplayFrames != null)
                 {
                     DrawableRuleset?.SetReplayScore(new Score
                     {
-                        Replay = new Replay { Frames = currentTestData.Frames },
+                        Replay = new Replay { Frames = currentTestData.ReplayFrames },
                         ScoreInfo = new ScoreInfo { User = new APIUser { Username = @"Test" } },
                     });
                 }
@@ -99,7 +99,7 @@ namespace osu.Game.Tests.Visual
             /// The frames to use for replay. <see cref="Autoplay"/> must be set to false.
             /// </summary>
             [CanBeNull]
-            public List<ReplayFrame> Frames;
+            public List<ReplayFrame> ReplayFrames;
 
             /// <summary>
             /// The beatmap for this test case.

From 535216a0d3f5c063d5e5519ff4cd0533c3e72df5 Mon Sep 17 00:00:00 2001
From: Nitrous <nathan.alo2000@gmail.com>
Date: Sat, 29 Jan 2022 23:20:31 +0800
Subject: [PATCH 2632/5547] rename `CanIntercept` to `ShouldAlternate`

---
 osu.Game.Rulesets.Osu/Mods/OsuModAlternate.cs | 9 +++------
 1 file changed, 3 insertions(+), 6 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModAlternate.cs b/osu.Game.Rulesets.Osu/Mods/OsuModAlternate.cs
index 9eeb060135..876742caba 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModAlternate.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModAlternate.cs
@@ -9,6 +9,7 @@ using osu.Framework.Graphics.Sprites;
 using osu.Framework.Input.Bindings;
 using osu.Framework.Input.Events;
 using osu.Game.Rulesets.Mods;
+using osu.Game.Rulesets.Objects.Types;
 using osu.Game.Rulesets.Osu.Objects;
 using osu.Game.Rulesets.Scoring;
 using osu.Game.Rulesets.UI;
@@ -25,11 +26,7 @@ namespace osu.Game.Rulesets.Osu.Mods
         public override Type[] IncompatibleMods => new[] { typeof(ModAutoplay) };
         public override ModType Type => ModType.DifficultyIncrease;
         public override IconUsage? Icon => FontAwesome.Solid.Keyboard;
-
-        /// <summary>
-        /// Whether incoming input must be checked by <see cref="InputInterceptor"/> before it is passed to gameplay.
-        /// </summary>
-        public bool CanIntercept => !isBreakTime.Value && introEnded;
+        public bool ShouldAlternate => !isBreakTime.Value && introEnded;
 
         private bool introEnded;
         private double earliestStartTime;
@@ -86,7 +83,7 @@ namespace osu.Game.Rulesets.Osu.Mods
             }
 
             public bool OnPressed(KeyBindingPressEvent<OsuAction> e)
-                => mod.CanIntercept && mod.onPressed(e.Action);
+                => mod.ShouldAlternate && mod.onPressed(e.Action);
 
             public void OnReleased(KeyBindingReleaseEvent<OsuAction> e)
             {

From 40f43344f16056d66d6713078ecc3b5ccf47372b Mon Sep 17 00:00:00 2001
From: Nitrous <nathan.alo2000@gmail.com>
Date: Sat, 29 Jan 2022 23:31:26 +0800
Subject: [PATCH 2633/5547] remove unused using

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

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModAlternate.cs b/osu.Game.Rulesets.Osu/Mods/OsuModAlternate.cs
index 876742caba..db8bd217f6 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModAlternate.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModAlternate.cs
@@ -9,7 +9,6 @@ using osu.Framework.Graphics.Sprites;
 using osu.Framework.Input.Bindings;
 using osu.Framework.Input.Events;
 using osu.Game.Rulesets.Mods;
-using osu.Game.Rulesets.Objects.Types;
 using osu.Game.Rulesets.Osu.Objects;
 using osu.Game.Rulesets.Scoring;
 using osu.Game.Rulesets.UI;

From 51acf79935724e5786ecd1b515f07657071b65fd Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 30 Jan 2022 02:29:51 +0900
Subject: [PATCH 2634/5547] Change test exposure to property instead of method

---
 .../Visual/SongSelect/TestSceneBeatmapLeaderboard.cs      | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
index b4b66e8afa..91ec1de3ad 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
@@ -101,7 +101,7 @@ namespace osu.Game.Tests.Visual.SongSelect
         public void TestGlobalScoresDisplay()
         {
             AddStep(@"Set scope", () => leaderboard.Scope = BeatmapLeaderboardScope.Global);
-            AddStep(@"New Scores", () => leaderboard.SetScores(generateSampleScores(null)));
+            AddStep(@"New Scores", () => leaderboard.Scores = generateSampleScores(null));
         }
 
         [Test]
@@ -417,7 +417,11 @@ namespace osu.Game.Tests.Visual.SongSelect
                 PlaceholderState = state;
             }
 
-            public void SetScores(ICollection<ScoreInfo> scores) => Scores = scores;
+            public new ICollection<ScoreInfo> Scores
+            {
+                get => base.Scores;
+                set => base.Scores = value;
+            }
         }
     }
 }

From 3d771c0fc7ed0f292ec28c0257ff80c122bcd058 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 30 Jan 2022 02:34:31 +0900
Subject: [PATCH 2635/5547] Remove unnecessary `loading` hide call from
 `PlaceholderState_Set` and add more assertiveness

---
 osu.Game/Online/Leaderboards/Leaderboard.cs | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Online/Leaderboards/Leaderboard.cs b/osu.Game/Online/Leaderboards/Leaderboard.cs
index cc6d7a7b62..e20c8b5007 100644
--- a/osu.Game/Online/Leaderboards/Leaderboard.cs
+++ b/osu.Game/Online/Leaderboards/Leaderboard.cs
@@ -241,9 +241,11 @@ namespace osu.Game.Online.Leaderboards
                 if (value == placeholderState)
                     return;
 
-                loading.Hide();
+                placeholderState = value;
 
-                switch (placeholderState = value)
+                Debug.Assert(placeholderState != PlaceholderState.Successful || scores?.Any() == true);
+
+                switch (placeholderState)
                 {
                     case PlaceholderState.NetworkFailure:
                         replacePlaceholder(new ClickablePlaceholder(@"Couldn't fetch scores!", FontAwesome.Solid.Sync)

From d3cb910cf82cb208bf3ae6c3059e8b851107770e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 30 Jan 2022 02:36:50 +0900
Subject: [PATCH 2636/5547] Convert inline math to not so inline to make
 operation more explicit

---
 osu.Game/Online/Leaderboards/Leaderboard.cs | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Online/Leaderboards/Leaderboard.cs b/osu.Game/Online/Leaderboards/Leaderboard.cs
index e20c8b5007..460869fa54 100644
--- a/osu.Game/Online/Leaderboards/Leaderboard.cs
+++ b/osu.Game/Online/Leaderboards/Leaderboard.cs
@@ -312,12 +312,14 @@ namespace osu.Game.Online.Leaderboards
             {
                 scrollContainer.Add(scoreFlowContainer = newFlow);
 
-                int i = 0;
+                double delay = 0;
 
                 foreach (var s in scoreFlowContainer.Children)
                 {
-                    using (s.BeginDelayedSequence(i++ * 50))
+                    using (s.BeginDelayedSequence(delay))
                         s.Show();
+
+                    delay += 50;
                 }
 
                 scrollContainer.ScrollToStart(false);

From d21464ea61b8efcf53eb867970b8bf4a5013a109 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 30 Jan 2022 02:54:51 +0900
Subject: [PATCH 2637/5547] Fix assertions to work in both directions

---
 .../Visual/SongSelect/TestSceneBeatmapLeaderboard.cs     | 1 +
 osu.Game/Online/Leaderboards/Leaderboard.cs              | 9 +++++++--
 2 files changed, 8 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
index 91ec1de3ad..31b7b9fa8d 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
@@ -414,6 +414,7 @@ namespace osu.Game.Tests.Visual.SongSelect
         {
             public void SetRetrievalState(PlaceholderState state)
             {
+                Scores = null;
                 PlaceholderState = state;
             }
 
diff --git a/osu.Game/Online/Leaderboards/Leaderboard.cs b/osu.Game/Online/Leaderboards/Leaderboard.cs
index 460869fa54..7b596d8381 100644
--- a/osu.Game/Online/Leaderboards/Leaderboard.cs
+++ b/osu.Game/Online/Leaderboards/Leaderboard.cs
@@ -243,11 +243,10 @@ namespace osu.Game.Online.Leaderboards
 
                 placeholderState = value;
 
-                Debug.Assert(placeholderState != PlaceholderState.Successful || scores?.Any() == true);
-
                 switch (placeholderState)
                 {
                     case PlaceholderState.NetworkFailure:
+                        Debug.Assert(scores?.Any() != true);
                         replacePlaceholder(new ClickablePlaceholder(@"Couldn't fetch scores!", FontAwesome.Solid.Sync)
                         {
                             Action = RefetchScores
@@ -255,26 +254,32 @@ namespace osu.Game.Online.Leaderboards
                         break;
 
                     case PlaceholderState.NoneSelected:
+                        Debug.Assert(scores?.Any() != true);
                         replacePlaceholder(new MessagePlaceholder(@"Please select a beatmap!"));
                         break;
 
                     case PlaceholderState.Unavailable:
+                        Debug.Assert(scores?.Any() != true);
                         replacePlaceholder(new MessagePlaceholder(@"Leaderboards are not available for this beatmap!"));
                         break;
 
                     case PlaceholderState.NoScores:
+                        Debug.Assert(scores?.Any() != true);
                         replacePlaceholder(new MessagePlaceholder(@"No records yet!"));
                         break;
 
                     case PlaceholderState.NotLoggedIn:
+                        Debug.Assert(scores?.Any() != true);
                         replacePlaceholder(new LoginPlaceholder(@"Please sign in to view online leaderboards!"));
                         break;
 
                     case PlaceholderState.NotSupporter:
+                        Debug.Assert(scores?.Any() != true);
                         replacePlaceholder(new MessagePlaceholder(@"Please invest in an osu!supporter tag to view this leaderboard!"));
                         break;
 
                     default:
+                        Debug.Assert(scores?.Any() == true);
                         replacePlaceholder(null);
                         break;
                 }

From 9b573fbc2bdc044d0702179fa9b94a82a0fe0648 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 30 Jan 2022 02:58:53 +0900
Subject: [PATCH 2638/5547] Add missing entries to `switch` statement and guard
 against out of range

---
 osu.Game/Online/Leaderboards/Leaderboard.cs | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Online/Leaderboards/Leaderboard.cs b/osu.Game/Online/Leaderboards/Leaderboard.cs
index 7b596d8381..4134046320 100644
--- a/osu.Game/Online/Leaderboards/Leaderboard.cs
+++ b/osu.Game/Online/Leaderboards/Leaderboard.cs
@@ -278,10 +278,18 @@ namespace osu.Game.Online.Leaderboards
                         replacePlaceholder(new MessagePlaceholder(@"Please invest in an osu!supporter tag to view this leaderboard!"));
                         break;
 
-                    default:
+                    case PlaceholderState.Retrieving:
+                        Debug.Assert(scores?.Any() != true);
+                        replacePlaceholder(null);
+                        break;
+
+                    case PlaceholderState.Successful:
                         Debug.Assert(scores?.Any() == true);
                         replacePlaceholder(null);
                         break;
+
+                    default:
+                        throw new ArgumentOutOfRangeException();
                 }
             }
         }

From 06660ff96019000f7b8302d24fdd0cf28176f460 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 30 Jan 2022 03:02:56 +0900
Subject: [PATCH 2639/5547] Fix null beatmap in test scene

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

diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
index 31b7b9fa8d..77fe3be933 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
@@ -101,7 +101,7 @@ namespace osu.Game.Tests.Visual.SongSelect
         public void TestGlobalScoresDisplay()
         {
             AddStep(@"Set scope", () => leaderboard.Scope = BeatmapLeaderboardScope.Global);
-            AddStep(@"New Scores", () => leaderboard.Scores = generateSampleScores(null));
+            AddStep(@"New Scores", () => leaderboard.Scores = generateSampleScores(new BeatmapInfo()));
         }
 
         [Test]

From dad9cc931524f6627c507d5831c9cbd3a79ba6fb Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 30 Jan 2022 03:06:29 +0900
Subject: [PATCH 2640/5547] Ensure `Reset`/`Scores_Set` run inline where
 possible

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

diff --git a/osu.Game/Online/Leaderboards/Leaderboard.cs b/osu.Game/Online/Leaderboards/Leaderboard.cs
index 4134046320..0ad9f46130 100644
--- a/osu.Game/Online/Leaderboards/Leaderboard.cs
+++ b/osu.Game/Online/Leaderboards/Leaderboard.cs
@@ -66,7 +66,7 @@ namespace osu.Game.Online.Leaderboards
             protected set
             {
                 scores = value;
-                Scheduler.AddOnce(updateScoresDrawables);
+                Scheduler.Add(updateScoresDrawables, false);
             }
         }
 

From b434e29a7c4f4883cb55498678933dc44b4ec185 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 30 Jan 2022 03:10:01 +0900
Subject: [PATCH 2641/5547] Move loading hide operation inside early return to
 ensure not hidden too early

It should only be hidden after the async load completes.
---
 osu.Game/Online/Leaderboards/Leaderboard.cs | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/osu.Game/Online/Leaderboards/Leaderboard.cs b/osu.Game/Online/Leaderboards/Leaderboard.cs
index 0ad9f46130..8cf20ea8d1 100644
--- a/osu.Game/Online/Leaderboards/Leaderboard.cs
+++ b/osu.Game/Online/Leaderboards/Leaderboard.cs
@@ -303,10 +303,9 @@ namespace osu.Game.Online.Leaderboards
                 .Expire();
             scoreFlowContainer = null;
 
-            loading.Hide();
-
             if (scores?.Any() != true)
             {
+                loading.Hide();
                 PlaceholderState = PlaceholderState.NoScores;
                 return;
             }

From 4f4f60248faad019bc3c0501e42de854fea5dbdc Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 11 Aug 2021 12:16:25 +0300
Subject: [PATCH 2642/5547] Add failing test case

---
 .../TestSceneMultiSpectatorScreen.cs          | 51 +++++++++++++++++--
 .../Spectate/MultiSpectatorScreen.cs          |  5 +-
 .../Multiplayer/Spectate/PlayerArea.cs        | 13 ++++-
 osu.Game/Screens/Play/Player.cs               |  7 +++
 4 files changed, 71 insertions(+), 5 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs
index b84f7760e4..56cb6036c7 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs
@@ -347,19 +347,44 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddAssert($"{PLAYER_1_ID} score quit still set", () => getLeaderboardScore(PLAYER_1_ID).HasQuit.Value);
         }
 
-        private void loadSpectateScreen(bool waitForPlayerLoad = true)
+        /// <summary>
+        /// Tests spectating with a gameplay start time set to a negative value.
+        /// Simulating beatmaps with high <see cref="BeatmapInfo.AudioLeadIn"/> or negative time storyboard elements.
+        /// </summary>
+        [Test]
+        public void TestNegativeGameplayStartTime()
         {
-            AddStep("load screen", () =>
+            start(PLAYER_1_ID);
+
+            loadSpectateScreen(false, -500);
+
+            // to ensure negative gameplay start time does not affect spectator, send frames exactly after StartGameplay().
+            // (similar to real spectating sessions in which the first frames get sent between StartGameplay() and player load complete)
+            AddStep("send frames at gameplay start", () => getInstance(PLAYER_1_ID).OnGameplayStarted += () => SpectatorClient.SendFrames(PLAYER_1_ID, 100));
+
+            AddUntilStep("wait for player load", () => spectatorScreen.AllPlayersLoaded);
+
+            AddWaitStep("wait for progression", 3);
+
+            assertNotCatchingUp(PLAYER_1_ID);
+            assertRunning(PLAYER_1_ID);
+        }
+
+        private void loadSpectateScreen(bool waitForPlayerLoad = true, double? gameplayStartTime = null)
+        {
+            AddStep(!gameplayStartTime.HasValue ? "load screen" : $"load screen (start = {gameplayStartTime}ms)", () =>
             {
                 Beatmap.Value = beatmapManager.GetWorkingBeatmap(importedBeatmap);
                 Ruleset.Value = importedBeatmap.Ruleset;
 
-                LoadScreen(spectatorScreen = new MultiSpectatorScreen(playingUsers.ToArray()));
+                LoadScreen(spectatorScreen = new TestMultiSpectatorScreen(playingUsers.ToArray(), gameplayStartTime));
             });
 
             AddUntilStep("wait for screen load", () => spectatorScreen.LoadState == LoadState.Loaded && (!waitForPlayerLoad || spectatorScreen.AllPlayersLoaded));
         }
 
+        private void start(int userId, int? beatmapId = null) => start(new[] { userId }, beatmapId);
+
         private void start(int[] userIds, int? beatmapId = null)
         {
             AddStep("start play", () =>
@@ -419,6 +444,12 @@ namespace osu.Game.Tests.Visual.Multiplayer
         private void assertMuted(int userId, bool muted)
             => AddAssert($"{userId} {(muted ? "is" : "is not")} muted", () => getInstance(userId).Mute == muted);
 
+        private void assertRunning(int userId)
+            => AddAssert($"{userId} clock running", () => getInstance(userId).GameplayClock.IsRunning);
+
+        private void assertNotCatchingUp(int userId)
+            => AddAssert($"{userId} in sync", () => !getInstance(userId).GameplayClock.IsCatchingUp);
+
         private void waitForCatchup(int userId)
             => AddUntilStep($"{userId} not catching up", () => !getInstance(userId).GameplayClock.IsCatchingUp);
 
@@ -429,5 +460,19 @@ namespace osu.Game.Tests.Visual.Multiplayer
         private GameplayLeaderboardScore getLeaderboardScore(int userId) => spectatorScreen.ChildrenOfType<GameplayLeaderboardScore>().Single(s => s.User?.Id == userId);
 
         private int[] getPlayerIds(int count) => Enumerable.Range(PLAYER_1_ID, count).ToArray();
+
+        private class TestMultiSpectatorScreen : MultiSpectatorScreen
+        {
+            private readonly double? gameplayStartTime;
+
+            public TestMultiSpectatorScreen(MultiplayerRoomUser[] users, double? gameplayStartTime = null)
+                : base(users)
+            {
+                this.gameplayStartTime = gameplayStartTime;
+            }
+
+            protected override MasterGameplayClockContainer CreateMasterGameplayClockContainer(WorkingBeatmap beatmap)
+                => new MasterGameplayClockContainer(beatmap, gameplayStartTime ?? 0, gameplayStartTime.HasValue);
+        }
     }
 }
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorScreen.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorScreen.cs
index 7350408eba..4646f42d63 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorScreen.cs
@@ -9,6 +9,7 @@ using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
+using osu.Game.Beatmaps;
 using osu.Game.Graphics;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Spectator;
@@ -68,7 +69,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Spectate
             Container leaderboardContainer;
             Container scoreDisplayContainer;
 
-            masterClockContainer = new MasterGameplayClockContainer(Beatmap.Value, 0);
+            masterClockContainer = CreateMasterGameplayClockContainer(Beatmap.Value);
 
             InternalChildren = new[]
             {
@@ -235,5 +236,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Spectate
 
             return base.OnBackButton();
         }
+
+        protected virtual MasterGameplayClockContainer CreateMasterGameplayClockContainer(WorkingBeatmap beatmap) => new MasterGameplayClockContainer(beatmap, 0);
     }
 }
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/PlayerArea.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/PlayerArea.cs
index 48f153ecbe..f5a6777a62 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/PlayerArea.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/PlayerArea.cs
@@ -24,6 +24,11 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Spectate
     /// </summary>
     public class PlayerArea : CompositeDrawable
     {
+        /// <summary>
+        /// Raised after <see cref="Player.StartGameplay"/> is called on <see cref="Player"/>.
+        /// </summary>
+        public event Action OnGameplayStarted;
+
         /// <summary>
         /// Whether a <see cref="Player"/> is loaded in the area.
         /// </summary>
@@ -93,7 +98,13 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Spectate
                 }
             };
 
-            stack.Push(new MultiSpectatorPlayerLoader(Score, () => new MultiSpectatorPlayer(Score, GameplayClock)));
+            stack.Push(new MultiSpectatorPlayerLoader(Score, () =>
+            {
+                var player = new MultiSpectatorPlayer(Score, GameplayClock);
+                player.OnGameplayStarted += OnGameplayStarted;
+                return player;
+            }));
+
             loadingLayer.Hide();
         }
 
diff --git a/osu.Game/Screens/Play/Player.cs b/osu.Game/Screens/Play/Player.cs
index cfca2d0a3d..0312789b12 100644
--- a/osu.Game/Screens/Play/Player.cs
+++ b/osu.Game/Screens/Play/Player.cs
@@ -45,6 +45,11 @@ namespace osu.Game.Screens.Play
         /// </summary>
         public const double RESULTS_DISPLAY_DELAY = 1000.0;
 
+        /// <summary>
+        /// Raised after <see cref="StartGameplay"/> is called.
+        /// </summary>
+        public event Action OnGameplayStarted;
+
         public override bool AllowBackButton => false; // handled by HoldForMenuButton
 
         protected override UserActivity InitialActivity => new UserActivity.InSoloGame(Beatmap.Value.BeatmapInfo, Ruleset.Value);
@@ -958,7 +963,9 @@ namespace osu.Game.Screens.Play
             updateGameplayState();
 
             GameplayClockContainer.FadeInFromZero(750, Easing.OutQuint);
+
             StartGameplay();
+            OnGameplayStarted?.Invoke();
         }
 
         /// <summary>

From 3ec193d47e9655de747d6de21b042e36ed5f8211 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sat, 29 Jan 2022 20:17:57 +0300
Subject: [PATCH 2643/5547] Fix spectator clock container incorrectly starting
 catch-up clock

---
 .../OnlinePlay/Multiplayer/Spectate/MultiSpectatorPlayer.cs     | 2 ++
 osu.Game/Screens/Play/GameplayClockContainer.cs                 | 2 +-
 2 files changed, 3 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorPlayer.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorPlayer.cs
index ececa1e497..615bd41f3f 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorPlayer.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorPlayer.cs
@@ -55,6 +55,8 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Spectate
             public SpectatorGameplayClockContainer([NotNull] IClock sourceClock)
                 : base(sourceClock)
             {
+                // the container should initially be in a stopped state until the catch-up clock is started by the sync manager.
+                Stop();
             }
 
             protected override void Update()
diff --git a/osu.Game/Screens/Play/GameplayClockContainer.cs b/osu.Game/Screens/Play/GameplayClockContainer.cs
index 0c9b827a41..0fd524f976 100644
--- a/osu.Game/Screens/Play/GameplayClockContainer.cs
+++ b/osu.Game/Screens/Play/GameplayClockContainer.cs
@@ -101,7 +101,7 @@ namespace osu.Game.Screens.Play
         /// <summary>
         /// Stops gameplay.
         /// </summary>
-        public virtual void Stop() => IsPaused.Value = true;
+        public void Stop() => IsPaused.Value = true;
 
         /// <summary>
         /// Resets this <see cref="GameplayClockContainer"/> and the source to an initial state ready for gameplay.

From c401629dd84e8b91a9389fc85c16cc84f55aa013 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 30 Jan 2022 03:37:57 +0900
Subject: [PATCH 2644/5547] Also refactor `placeholder` logic to make more
 sense

---
 .../SongSelect/TestSceneBeatmapLeaderboard.cs |  27 +--
 osu.Game/Online/Leaderboards/Leaderboard.cs   | 155 +++++++++---------
 ...olderState.cs => LeaderboardErrorState.cs} |   5 +-
 .../Select/Leaderboards/BeatmapLeaderboard.cs |  15 +-
 4 files changed, 86 insertions(+), 116 deletions(-)
 rename osu.Game/Online/Leaderboards/{PlaceholderState.cs => LeaderboardErrorState.cs} (82%)

diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
index 77fe3be933..969bafa98b 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
@@ -114,12 +114,12 @@ namespace osu.Game.Tests.Visual.SongSelect
         [Test]
         public void TestPlaceholderStates()
         {
-            AddStep(@"Empty Scores", () => leaderboard.SetRetrievalState(PlaceholderState.NoScores));
-            AddStep(@"Network failure", () => leaderboard.SetRetrievalState(PlaceholderState.NetworkFailure));
-            AddStep(@"No supporter", () => leaderboard.SetRetrievalState(PlaceholderState.NotSupporter));
-            AddStep(@"Not logged in", () => leaderboard.SetRetrievalState(PlaceholderState.NotLoggedIn));
-            AddStep(@"Unavailable", () => leaderboard.SetRetrievalState(PlaceholderState.Unavailable));
-            AddStep(@"None selected", () => leaderboard.SetRetrievalState(PlaceholderState.NoneSelected));
+            AddStep(@"Empty Scores", () => leaderboard.SetErrorState(LeaderboardErrorState.NoScores));
+            AddStep(@"Network failure", () => leaderboard.SetErrorState(LeaderboardErrorState.NetworkFailure));
+            AddStep(@"No supporter", () => leaderboard.SetErrorState(LeaderboardErrorState.NotSupporter));
+            AddStep(@"Not logged in", () => leaderboard.SetErrorState(LeaderboardErrorState.NotLoggedIn));
+            AddStep(@"Unavailable", () => leaderboard.SetErrorState(LeaderboardErrorState.Unavailable));
+            AddStep(@"None selected", () => leaderboard.SetErrorState(LeaderboardErrorState.NoneSelected));
         }
 
         private void showPersonalBestWithNullPosition()
@@ -401,22 +401,9 @@ namespace osu.Game.Tests.Visual.SongSelect
             };
         }
 
-        private void showBeatmapWithStatus(BeatmapOnlineStatus status)
-        {
-            leaderboard.BeatmapInfo = new BeatmapInfo
-            {
-                OnlineID = 1113057,
-                Status = status,
-            };
-        }
-
         private class FailableLeaderboard : BeatmapLeaderboard
         {
-            public void SetRetrievalState(PlaceholderState state)
-            {
-                Scores = null;
-                PlaceholderState = state;
-            }
+            public new void SetErrorState(LeaderboardErrorState errorState) => base.SetErrorState(errorState);
 
             public new ICollection<ScoreInfo> Scores
             {
diff --git a/osu.Game/Online/Leaderboards/Leaderboard.cs b/osu.Game/Online/Leaderboards/Leaderboard.cs
index 8cf20ea8d1..2e552f9774 100644
--- a/osu.Game/Online/Leaderboards/Leaderboard.cs
+++ b/osu.Game/Online/Leaderboards/Leaderboard.cs
@@ -53,6 +53,8 @@ namespace osu.Game.Online.Leaderboards
 
         private APIRequest fetchScoresRequest;
 
+        private LeaderboardErrorState errorState;
+
         [Resolved(CanBeNull = true)]
         private IAPIProvider api { get; set; }
 
@@ -169,14 +171,37 @@ namespace osu.Game.Online.Leaderboards
             RefetchScores();
         }
 
+        /// <summary>
+        /// Perform a full refetch of scores using current criteria.
+        /// </summary>
         public void RefetchScores() => Scheduler.AddOnce(refetchScores);
 
+        /// <summary>
+        /// Reset the leaderboard into an empty state.
+        /// </summary>
         protected virtual void Reset()
         {
             cancelPendingWork();
             Scores = null;
         }
 
+        /// <summary>
+        /// Call when a retrieval or display failure happened to show a relevant message to the user.
+        /// </summary>
+        /// <param name="errorState">The state to display.</param>
+        protected void SetErrorState(LeaderboardErrorState errorState)
+        {
+            switch (errorState)
+            {
+                case LeaderboardErrorState.NoError:
+                    throw new InvalidOperationException($"State {errorState} cannot be set by a leaderboard implementation.");
+            }
+
+            Debug.Assert(scores?.Any() != true);
+
+            setErrorState(errorState);
+        }
+
         /// <summary>
         /// Performs a fetch/refresh of scores to be displayed.
         /// </summary>
@@ -195,7 +220,7 @@ namespace osu.Game.Online.Leaderboards
 
             Reset();
 
-            PlaceholderState = PlaceholderState.Retrieving;
+            setErrorState(LeaderboardErrorState.NoError);
             loading.Show();
 
             currentFetchCancellationSource = new CancellationTokenSource();
@@ -210,7 +235,7 @@ namespace osu.Game.Online.Leaderboards
                 if (e is OperationCanceledException || currentFetchCancellationSource.IsCancellationRequested)
                     return;
 
-                PlaceholderState = PlaceholderState.NetworkFailure;
+                SetErrorState(LeaderboardErrorState.NetworkFailure);
             });
 
             api?.Queue(fetchScoresRequest);
@@ -223,77 +248,6 @@ namespace osu.Game.Online.Leaderboards
             fetchScoresRequest?.Cancel();
         }
 
-        #region Placeholder handling
-
-        private Placeholder currentPlaceholder;
-
-        private PlaceholderState placeholderState;
-
-        /// <summary>
-        /// Update the placeholder visibility.
-        /// Setting this to anything other than PlaceholderState.Successful will cancel all existing retrieval requests and hide scores.
-        /// </summary>
-        protected PlaceholderState PlaceholderState
-        {
-            get => placeholderState;
-            set
-            {
-                if (value == placeholderState)
-                    return;
-
-                placeholderState = value;
-
-                switch (placeholderState)
-                {
-                    case PlaceholderState.NetworkFailure:
-                        Debug.Assert(scores?.Any() != true);
-                        replacePlaceholder(new ClickablePlaceholder(@"Couldn't fetch scores!", FontAwesome.Solid.Sync)
-                        {
-                            Action = RefetchScores
-                        });
-                        break;
-
-                    case PlaceholderState.NoneSelected:
-                        Debug.Assert(scores?.Any() != true);
-                        replacePlaceholder(new MessagePlaceholder(@"Please select a beatmap!"));
-                        break;
-
-                    case PlaceholderState.Unavailable:
-                        Debug.Assert(scores?.Any() != true);
-                        replacePlaceholder(new MessagePlaceholder(@"Leaderboards are not available for this beatmap!"));
-                        break;
-
-                    case PlaceholderState.NoScores:
-                        Debug.Assert(scores?.Any() != true);
-                        replacePlaceholder(new MessagePlaceholder(@"No records yet!"));
-                        break;
-
-                    case PlaceholderState.NotLoggedIn:
-                        Debug.Assert(scores?.Any() != true);
-                        replacePlaceholder(new LoginPlaceholder(@"Please sign in to view online leaderboards!"));
-                        break;
-
-                    case PlaceholderState.NotSupporter:
-                        Debug.Assert(scores?.Any() != true);
-                        replacePlaceholder(new MessagePlaceholder(@"Please invest in an osu!supporter tag to view this leaderboard!"));
-                        break;
-
-                    case PlaceholderState.Retrieving:
-                        Debug.Assert(scores?.Any() != true);
-                        replacePlaceholder(null);
-                        break;
-
-                    case PlaceholderState.Successful:
-                        Debug.Assert(scores?.Any() == true);
-                        replacePlaceholder(null);
-                        break;
-
-                    default:
-                        throw new ArgumentOutOfRangeException();
-                }
-            }
-        }
-
         private void updateScoresDrawables()
         {
             currentScoresAsyncLoadCancellationSource?.Cancel();
@@ -305,13 +259,14 @@ namespace osu.Game.Online.Leaderboards
 
             if (scores?.Any() != true)
             {
+                SetErrorState(LeaderboardErrorState.NoScores);
                 loading.Hide();
-                PlaceholderState = PlaceholderState.NoScores;
                 return;
             }
 
             // ensure placeholder is hidden when displaying scores
-            PlaceholderState = PlaceholderState.Successful;
+            setErrorState(LeaderboardErrorState.NoError);
+            loading.Show();
 
             LoadComponentAsync(new FillFlowContainer<LeaderboardScore>
             {
@@ -339,25 +294,61 @@ namespace osu.Game.Online.Leaderboards
             }, (currentScoresAsyncLoadCancellationSource = new CancellationTokenSource()).Token);
         }
 
-        private void replacePlaceholder(Placeholder placeholder)
+        #region Placeholder handling
+
+        private Placeholder placeholder;
+
+        private void setErrorState(LeaderboardErrorState errorState)
         {
-            if (placeholder != null && placeholder.Equals(currentPlaceholder))
+            if (errorState == this.errorState)
                 return;
 
-            currentPlaceholder?.FadeOut(150, Easing.OutQuint).Expire();
+            this.errorState = errorState;
+
+            placeholder?.FadeOut(150, Easing.OutQuint).Expire();
+
+            placeholder = getPlaceholderFor(errorState);
 
             if (placeholder == null)
-            {
-                currentPlaceholder = null;
                 return;
-            }
 
             placeholderContainer.Child = placeholder;
 
             placeholder.ScaleTo(0.8f).Then().ScaleTo(1, fade_duration * 3, Easing.OutQuint);
             placeholder.FadeInFromZero(fade_duration, Easing.OutQuint);
+        }
 
-            currentPlaceholder = placeholder;
+        private Placeholder getPlaceholderFor(LeaderboardErrorState errorState)
+        {
+            switch (errorState)
+            {
+                case LeaderboardErrorState.NetworkFailure:
+                    return new ClickablePlaceholder(@"Couldn't fetch scores!", FontAwesome.Solid.Sync)
+                    {
+                        Action = RefetchScores
+                    };
+
+                case LeaderboardErrorState.NoneSelected:
+                    return new MessagePlaceholder(@"Please select a beatmap!");
+
+                case LeaderboardErrorState.Unavailable:
+                    return new MessagePlaceholder(@"Leaderboards are not available for this beatmap!");
+
+                case LeaderboardErrorState.NoScores:
+                    return new MessagePlaceholder(@"No records yet!");
+
+                case LeaderboardErrorState.NotLoggedIn:
+                    return new LoginPlaceholder(@"Please sign in to view online leaderboards!");
+
+                case LeaderboardErrorState.NotSupporter:
+                    return new MessagePlaceholder(@"Please invest in an osu!supporter tag to view this leaderboard!");
+
+                case LeaderboardErrorState.NoError:
+                    return null;
+
+                default:
+                    throw new ArgumentOutOfRangeException();
+            }
         }
 
         #endregion
diff --git a/osu.Game/Online/Leaderboards/PlaceholderState.cs b/osu.Game/Online/Leaderboards/LeaderboardErrorState.cs
similarity index 82%
rename from osu.Game/Online/Leaderboards/PlaceholderState.cs
rename to osu.Game/Online/Leaderboards/LeaderboardErrorState.cs
index 297241fa73..17f47bb557 100644
--- a/osu.Game/Online/Leaderboards/PlaceholderState.cs
+++ b/osu.Game/Online/Leaderboards/LeaderboardErrorState.cs
@@ -3,10 +3,9 @@
 
 namespace osu.Game.Online.Leaderboards
 {
-    public enum PlaceholderState
+    public enum LeaderboardErrorState
     {
-        Successful,
-        Retrieving,
+        NoError,
         NetworkFailure,
         Unavailable,
         NoneSelected,
diff --git a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
index 31868624bb..b0ba830076 100644
--- a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
+++ b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
@@ -33,19 +33,12 @@ namespace osu.Game.Screens.Select.Leaderboards
             set
             {
                 if (beatmapInfo == null && value == null)
-                {
-                    // always null scores to ensure a correct initial display.
-                    // see weird `scoresLoadedOnce` logic in base implementation.
-                    Scores = null;
                     return;
-                }
 
                 if (beatmapInfo?.Equals(value) == true)
                     return;
 
                 beatmapInfo = value;
-                Scores = null;
-
                 RefetchScores();
             }
         }
@@ -114,7 +107,7 @@ namespace osu.Game.Screens.Select.Leaderboards
 
             if (fetchBeatmapInfo == null)
             {
-                PlaceholderState = PlaceholderState.NoneSelected;
+                SetErrorState(LeaderboardErrorState.NoneSelected);
                 return null;
             }
 
@@ -126,19 +119,19 @@ namespace osu.Game.Screens.Select.Leaderboards
 
             if (api?.IsLoggedIn != true)
             {
-                PlaceholderState = PlaceholderState.NotLoggedIn;
+                SetErrorState(LeaderboardErrorState.NotLoggedIn);
                 return null;
             }
 
             if (fetchBeatmapInfo.OnlineID <= 0 || fetchBeatmapInfo.Status <= BeatmapOnlineStatus.Pending)
             {
-                PlaceholderState = PlaceholderState.Unavailable;
+                SetErrorState(LeaderboardErrorState.Unavailable);
                 return null;
             }
 
             if (!api.LocalUser.Value.IsSupporter && (Scope != BeatmapLeaderboardScope.Global || filterMods))
             {
-                PlaceholderState = PlaceholderState.NotSupporter;
+                SetErrorState(LeaderboardErrorState.NotSupporter);
                 return null;
             }
 

From acc1199addc044c2673516c1738586e16a058a87 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 30 Jan 2022 16:16:00 +0900
Subject: [PATCH 2645/5547] Consolidate flows of `Set` operations, either
 result or error

---
 .../SongSelect/TestSceneBeatmapLeaderboard.cs | 17 ++---
 osu.Game/Online/Leaderboards/Leaderboard.cs   | 63 ++++++++-----------
 .../Match/Components/MatchLeaderboard.cs      |  5 +-
 .../Select/Leaderboards/BeatmapLeaderboard.cs | 11 +---
 4 files changed, 37 insertions(+), 59 deletions(-)

diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
index 969bafa98b..e9a518b2fd 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
@@ -101,7 +101,7 @@ namespace osu.Game.Tests.Visual.SongSelect
         public void TestGlobalScoresDisplay()
         {
             AddStep(@"Set scope", () => leaderboard.Scope = BeatmapLeaderboardScope.Global);
-            AddStep(@"New Scores", () => leaderboard.Scores = generateSampleScores(new BeatmapInfo()));
+            AddStep(@"New Scores", () => leaderboard.SetScores(generateSampleScores(new BeatmapInfo())));
         }
 
         [Test]
@@ -124,7 +124,7 @@ namespace osu.Game.Tests.Visual.SongSelect
 
         private void showPersonalBestWithNullPosition()
         {
-            leaderboard.TopScore = new ScoreInfo
+            leaderboard.SetScores(leaderboard.Scores, new ScoreInfo
             {
                 Rank = ScoreRank.XH,
                 Accuracy = 1,
@@ -142,12 +142,12 @@ namespace osu.Game.Tests.Visual.SongSelect
                         FlagName = @"ES",
                     },
                 },
-            };
+            });
         }
 
         private void showPersonalBest()
         {
-            leaderboard.TopScore = new ScoreInfo
+            leaderboard.SetScores(leaderboard.Scores, new ScoreInfo
             {
                 Position = 999,
                 Rank = ScoreRank.XH,
@@ -166,7 +166,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                         FlagName = @"ES",
                     },
                 },
-            };
+            });
         }
 
         private void loadMoreScores(Func<BeatmapInfo> beatmapInfo)
@@ -404,12 +404,7 @@ namespace osu.Game.Tests.Visual.SongSelect
         private class FailableLeaderboard : BeatmapLeaderboard
         {
             public new void SetErrorState(LeaderboardErrorState errorState) => base.SetErrorState(errorState);
-
-            public new ICollection<ScoreInfo> Scores
-            {
-                get => base.Scores;
-                set => base.Scores = value;
-            }
+            public new void SetScores(IEnumerable<ScoreInfo> scores, ScoreInfo userScore = default) => base.SetScores(scores, userScore);
         }
     }
 }
diff --git a/osu.Game/Online/Leaderboards/Leaderboard.cs b/osu.Game/Online/Leaderboards/Leaderboard.cs
index 2e552f9774..9c46739443 100644
--- a/osu.Game/Online/Leaderboards/Leaderboard.cs
+++ b/osu.Game/Online/Leaderboards/Leaderboard.cs
@@ -33,6 +33,11 @@ namespace osu.Game.Online.Leaderboards
     /// <typeparam name="TScoreInfo">The score model class.</typeparam>
     public abstract class Leaderboard<TScope, TScoreInfo> : CompositeDrawable
     {
+        /// <summary>
+        /// The currently displayed scores.
+        /// </summary>
+        public IEnumerable<TScoreInfo> Scores => scores;
+
         /// <summary>
         /// Whether the current scope should refetch in response to changes in API connectivity state.
         /// </summary>
@@ -42,7 +47,7 @@ namespace osu.Game.Online.Leaderboards
 
         private readonly OsuScrollContainer scrollContainer;
         private readonly Container placeholderContainer;
-        private readonly UserTopScoreContainer<TScoreInfo> topScoreContainer;
+        private readonly UserTopScoreContainer<TScoreInfo> userScoreContainer;
 
         private FillFlowContainer<LeaderboardScore> scoreFlowContainer;
 
@@ -62,30 +67,6 @@ namespace osu.Game.Online.Leaderboards
 
         private ICollection<TScoreInfo> scores;
 
-        public ICollection<TScoreInfo> Scores
-        {
-            get => scores;
-            protected set
-            {
-                scores = value;
-                Scheduler.Add(updateScoresDrawables, false);
-            }
-        }
-
-        public TScoreInfo TopScore
-        {
-            get => topScoreContainer.Score.Value;
-            set
-            {
-                topScoreContainer.Score.Value = value;
-
-                if (value == null)
-                    topScoreContainer.Hide();
-                else
-                    topScoreContainer.Show();
-            }
-        }
-
         private TScope scope;
 
         public TScope Scope
@@ -133,7 +114,7 @@ namespace osu.Game.Online.Leaderboards
                                 {
                                     AutoSizeAxes = Axes.Y,
                                     RelativeSizeAxes = Axes.X,
-                                    Child = topScoreContainer = new UserTopScoreContainer<TScoreInfo>(CreateDrawableTopScore)
+                                    Child = userScoreContainer = new UserTopScoreContainer<TScoreInfo>(CreateDrawableTopScore)
                                 },
                             },
                         },
@@ -176,15 +157,6 @@ namespace osu.Game.Online.Leaderboards
         /// </summary>
         public void RefetchScores() => Scheduler.AddOnce(refetchScores);
 
-        /// <summary>
-        /// Reset the leaderboard into an empty state.
-        /// </summary>
-        protected virtual void Reset()
-        {
-            cancelPendingWork();
-            Scores = null;
-        }
-
         /// <summary>
         /// Call when a retrieval or display failure happened to show a relevant message to the user.
         /// </summary>
@@ -202,6 +174,24 @@ namespace osu.Game.Online.Leaderboards
             setErrorState(errorState);
         }
 
+        /// <summary>
+        /// Call when score retrieval is ready to be displayed.
+        /// </summary>
+        /// <param name="scores">The scores to display.</param>
+        /// <param name="userScore">The user top score, if any.</param>
+        protected void SetScores(IEnumerable<TScoreInfo> scores, TScoreInfo userScore = default)
+        {
+            this.scores = scores?.ToList();
+            userScoreContainer.Score.Value = userScore;
+
+            if (userScore == null)
+                userScoreContainer.Hide();
+            else
+                userScoreContainer.Show();
+
+            Scheduler.Add(updateScoresDrawables, false);
+        }
+
         /// <summary>
         /// Performs a fetch/refresh of scores to be displayed.
         /// </summary>
@@ -218,7 +208,8 @@ namespace osu.Game.Online.Leaderboards
         {
             Debug.Assert(ThreadSafety.IsUpdateThread);
 
-            Reset();
+            cancelPendingWork();
+            SetScores(null);
 
             setErrorState(LeaderboardErrorState.NoError);
             loading.Show();
diff --git a/osu.Game/Screens/OnlinePlay/Match/Components/MatchLeaderboard.cs b/osu.Game/Screens/OnlinePlay/Match/Components/MatchLeaderboard.cs
index 1945899a11..ea7de917e2 100644
--- a/osu.Game/Screens/OnlinePlay/Match/Components/MatchLeaderboard.cs
+++ b/osu.Game/Screens/OnlinePlay/Match/Components/MatchLeaderboard.cs
@@ -24,7 +24,7 @@ namespace osu.Game.Screens.OnlinePlay.Match.Components
                 if (id.NewValue == null)
                     return;
 
-                Scores = null;
+                SetScores(null);
                 RefetchScores();
             }, true);
         }
@@ -43,8 +43,7 @@ namespace osu.Game.Screens.OnlinePlay.Match.Components
                 if (cancellationToken.IsCancellationRequested)
                     return;
 
-                Scores = r.Leaderboard;
-                TopScore = r.UserScore;
+                SetScores(r.Leaderboard, r.UserScore);
             };
 
             return req;
diff --git a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
index b0ba830076..3521a2ef78 100644
--- a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
+++ b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
@@ -93,12 +93,6 @@ namespace osu.Game.Screens.Select.Leaderboards
             };
         }
 
-        protected override void Reset()
-        {
-            base.Reset();
-            TopScore = null;
-        }
-
         protected override bool IsOnlineScope => Scope != BeatmapLeaderboardScope.Local;
 
         protected override APIRequest FetchScores(CancellationToken cancellationToken)
@@ -153,8 +147,7 @@ namespace osu.Game.Screens.Select.Leaderboards
                                 if (cancellationToken.IsCancellationRequested)
                                     return;
 
-                                Scores = task.GetResultSafely();
-                                TopScore = r.UserScore?.CreateScoreInfo(rulesets, fetchBeatmapInfo);
+                                SetScores(task.GetResultSafely(), r.UserScore?.CreateScoreInfo(rulesets, fetchBeatmapInfo));
                             }), TaskContinuationOptions.OnlyOnRanToCompletion);
             };
 
@@ -210,7 +203,7 @@ namespace osu.Game.Screens.Select.Leaderboards
                 scoreManager.OrderByTotalScoreAsync(scores.ToArray(), cancellationToken)
                             .ContinueWith(ordered =>
                             {
-                                Scores = ordered.GetResultSafely();
+                                SetScores(ordered.GetResultSafely());
                             }, TaskContinuationOptions.OnlyOnRanToCompletion);
             }
         }

From 04dbb5d3c6cc9c8285fa5d95ac23621761e4a57c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 30 Jan 2022 16:16:33 +0900
Subject: [PATCH 2646/5547] Disallow setting "NoScores" externally as it is
 handled internally

---
 .../Visual/SongSelect/TestSceneBeatmapLeaderboard.cs           | 3 ++-
 osu.Game/Online/Leaderboards/Leaderboard.cs                    | 3 ++-
 2 files changed, 4 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
index e9a518b2fd..f91339e060 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
@@ -114,7 +114,8 @@ namespace osu.Game.Tests.Visual.SongSelect
         [Test]
         public void TestPlaceholderStates()
         {
-            AddStep(@"Empty Scores", () => leaderboard.SetErrorState(LeaderboardErrorState.NoScores));
+            AddStep("ensure no scores displayed", () => leaderboard.SetScores(null));
+
             AddStep(@"Network failure", () => leaderboard.SetErrorState(LeaderboardErrorState.NetworkFailure));
             AddStep(@"No supporter", () => leaderboard.SetErrorState(LeaderboardErrorState.NotSupporter));
             AddStep(@"Not logged in", () => leaderboard.SetErrorState(LeaderboardErrorState.NotLoggedIn));
diff --git a/osu.Game/Online/Leaderboards/Leaderboard.cs b/osu.Game/Online/Leaderboards/Leaderboard.cs
index 9c46739443..9fb0fe0e3b 100644
--- a/osu.Game/Online/Leaderboards/Leaderboard.cs
+++ b/osu.Game/Online/Leaderboards/Leaderboard.cs
@@ -165,6 +165,7 @@ namespace osu.Game.Online.Leaderboards
         {
             switch (errorState)
             {
+                case LeaderboardErrorState.NoScores:
                 case LeaderboardErrorState.NoError:
                     throw new InvalidOperationException($"State {errorState} cannot be set by a leaderboard implementation.");
             }
@@ -250,7 +251,7 @@ namespace osu.Game.Online.Leaderboards
 
             if (scores?.Any() != true)
             {
-                SetErrorState(LeaderboardErrorState.NoScores);
+                setErrorState(LeaderboardErrorState.NoScores);
                 loading.Hide();
                 return;
             }

From 1dbcb5ab63a7d5656c40f370213148011d3c8fbb Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 30 Jan 2022 18:51:15 +0900
Subject: [PATCH 2647/5547] Add test coverage of intro fail scenario

---
 osu.Game.Tests/Visual/Menus/IntroTestScene.cs | 45 +++++++++++++++++++
 1 file changed, 45 insertions(+)

diff --git a/osu.Game.Tests/Visual/Menus/IntroTestScene.cs b/osu.Game.Tests/Visual/Menus/IntroTestScene.cs
index bfea97410a..40b072c171 100644
--- a/osu.Game.Tests/Visual/Menus/IntroTestScene.cs
+++ b/osu.Game.Tests/Visual/Menus/IntroTestScene.cs
@@ -5,6 +5,8 @@ using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Shapes;
+using osu.Framework.Threading;
+using osu.Game.Overlays;
 using osu.Game.Screens;
 using osu.Game.Screens.Menu;
 using osuTK;
@@ -22,6 +24,11 @@ namespace osu.Game.Tests.Visual.Menus
 
         private IntroScreen intro;
 
+        [Cached]
+        private NotificationOverlay notifications;
+
+        private ScheduledDelegate trackResetDelegate;
+
         protected IntroTestScene()
         {
             Children = new Drawable[]
@@ -38,6 +45,11 @@ namespace osu.Game.Tests.Visual.Menus
                     RelativePositionAxes = Axes.Both,
                     Depth = float.MinValue,
                     Position = new Vector2(0.5f),
+                },
+                notifications = new NotificationOverlay
+                {
+                    Anchor = Anchor.TopRight,
+                    Origin = Anchor.TopRight,
                 }
             };
         }
@@ -63,6 +75,39 @@ namespace osu.Game.Tests.Visual.Menus
             AddUntilStep("wait for menu", () => intro.DidLoadMenu);
         }
 
+        [Test]
+        public virtual void TestPlayIntroWithFailingAudioDevice()
+        {
+            AddStep("hide notifications", () => notifications.Hide());
+            AddStep("restart sequence", () =>
+            {
+                logo.FinishTransforms();
+                logo.IsTracking = false;
+
+                IntroStack?.Expire();
+
+                Add(IntroStack = new OsuScreenStack
+                {
+                    RelativeSizeAxes = Axes.Both,
+                });
+
+                IntroStack.Push(intro = CreateScreen());
+            });
+
+            AddStep("trigger failure", () =>
+            {
+                trackResetDelegate = Scheduler.AddDelayed(() =>
+                {
+                    intro.Beatmap.Value.Track.Seek(0);
+                }, 0, true);
+            });
+
+            AddUntilStep("wait for menu", () => intro.DidLoadMenu);
+            AddUntilStep("wait for notification", () => notifications.UnreadCount.Value == 1);
+
+            AddStep("uninstall delegate", () => trackResetDelegate?.Cancel());
+        }
+
         protected abstract IntroScreen CreateScreen();
     }
 }

From 52f1c2bfdbc349259bc817ac3e0a4925f9c78a8e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 30 Jan 2022 18:37:00 +0900
Subject: [PATCH 2648/5547] Add failsafe to `IntroScreen` to stop users with
 incorrect audio configuration getting stuck

The most common case of this seems to be linux users with incorrect or
unsupported audio driver configurations. It continues to be brought up
in discussions as people are unsure of why their game freezes on
startup, and unable to easily recover.
---
 osu.Game/Screens/Menu/IntroScreen.cs | 37 ++++++++++++++++++++++++++++
 1 file changed, 37 insertions(+)

diff --git a/osu.Game/Screens/Menu/IntroScreen.cs b/osu.Game/Screens/Menu/IntroScreen.cs
index fceb083916..98c4b15f7f 100644
--- a/osu.Game/Screens/Menu/IntroScreen.cs
+++ b/osu.Game/Screens/Menu/IntroScreen.cs
@@ -18,6 +18,7 @@ using osu.Game.Configuration;
 using osu.Game.Database;
 using osu.Game.IO.Archives;
 using osu.Game.Overlays;
+using osu.Game.Overlays.Notifications;
 using osu.Game.Screens.Backgrounds;
 using osuTK;
 using osuTK.Graphics;
@@ -147,6 +148,36 @@ namespace osu.Game.Screens.Menu
             }
         }
 
+        public override void OnEntering(IScreen last)
+        {
+            base.OnEntering(last);
+            ensureEventuallyArrivingAtMenu();
+        }
+
+        [Resolved]
+        private NotificationOverlay notifications { get; set; }
+
+        private void ensureEventuallyArrivingAtMenu()
+        {
+            // This intends to handle the case where an intro may get stuck.
+            // Historically, this could happen if the host system's audio device is in a state it can't
+            // play audio, causing a clock to never elapse time and the intro to never end.
+            //
+            // This safety measure gives the user a chance to fix the problem from the settings menu.
+            Scheduler.AddDelayed(() =>
+            {
+                if (DidLoadMenu)
+                    return;
+
+                PrepareMenuLoad();
+                LoadMenu();
+                notifications.Post(new SimpleErrorNotification
+                {
+                    Text = "osu! doesn't seem to be able to play audio correctly.\n\nPlease try changing your audio device to a working setting."
+                });
+            }, 5000);
+        }
+
         public override void OnResuming(IScreen last)
         {
             this.FadeIn(300);
@@ -241,6 +272,9 @@ namespace osu.Game.Screens.Menu
 
         protected void PrepareMenuLoad()
         {
+            if (nextScreen != null)
+                return;
+
             nextScreen = createNextScreen?.Invoke();
 
             if (nextScreen != null)
@@ -249,6 +283,9 @@ namespace osu.Game.Screens.Menu
 
         protected void LoadMenu()
         {
+            if (DidLoadMenu)
+                return;
+
             beatmap.Return();
 
             DidLoadMenu = true;

From 6a21d583259b43c0d7865371f34c73d5cba04e04 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 30 Jan 2022 18:59:18 +0900
Subject: [PATCH 2649/5547] Avoid test failures on non-triangle intro tests

---
 osu.Game.Tests/Visual/Menus/IntroTestScene.cs          | 6 +++++-
 osu.Game.Tests/Visual/Menus/TestSceneIntroCircles.cs   | 1 +
 osu.Game.Tests/Visual/Menus/TestSceneIntroTriangles.cs | 1 +
 osu.Game.Tests/Visual/Menus/TestSceneIntroWelcome.cs   | 1 +
 4 files changed, 8 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/Menus/IntroTestScene.cs b/osu.Game.Tests/Visual/Menus/IntroTestScene.cs
index 40b072c171..82accceb23 100644
--- a/osu.Game.Tests/Visual/Menus/IntroTestScene.cs
+++ b/osu.Game.Tests/Visual/Menus/IntroTestScene.cs
@@ -20,6 +20,8 @@ namespace osu.Game.Tests.Visual.Menus
         [Cached]
         private OsuLogo logo;
 
+        protected abstract bool IntroReliesOnTrack { get; }
+
         protected OsuScreenStack IntroStack;
 
         private IntroScreen intro;
@@ -103,7 +105,9 @@ namespace osu.Game.Tests.Visual.Menus
             });
 
             AddUntilStep("wait for menu", () => intro.DidLoadMenu);
-            AddUntilStep("wait for notification", () => notifications.UnreadCount.Value == 1);
+
+            if (IntroReliesOnTrack)
+                AddUntilStep("wait for notification", () => notifications.UnreadCount.Value == 1);
 
             AddStep("uninstall delegate", () => trackResetDelegate?.Cancel());
         }
diff --git a/osu.Game.Tests/Visual/Menus/TestSceneIntroCircles.cs b/osu.Game.Tests/Visual/Menus/TestSceneIntroCircles.cs
index ffc99185fb..7ad49b5dcd 100644
--- a/osu.Game.Tests/Visual/Menus/TestSceneIntroCircles.cs
+++ b/osu.Game.Tests/Visual/Menus/TestSceneIntroCircles.cs
@@ -9,6 +9,7 @@ namespace osu.Game.Tests.Visual.Menus
     [TestFixture]
     public class TestSceneIntroCircles : IntroTestScene
     {
+        protected override bool IntroReliesOnTrack => false;
         protected override IntroScreen CreateScreen() => new IntroCircles();
     }
 }
diff --git a/osu.Game.Tests/Visual/Menus/TestSceneIntroTriangles.cs b/osu.Game.Tests/Visual/Menus/TestSceneIntroTriangles.cs
index 8f01e0321b..abe8936330 100644
--- a/osu.Game.Tests/Visual/Menus/TestSceneIntroTriangles.cs
+++ b/osu.Game.Tests/Visual/Menus/TestSceneIntroTriangles.cs
@@ -9,6 +9,7 @@ namespace osu.Game.Tests.Visual.Menus
     [TestFixture]
     public class TestSceneIntroTriangles : IntroTestScene
     {
+        protected override bool IntroReliesOnTrack => true;
         protected override IntroScreen CreateScreen() => new IntroTriangles();
     }
 }
diff --git a/osu.Game.Tests/Visual/Menus/TestSceneIntroWelcome.cs b/osu.Game.Tests/Visual/Menus/TestSceneIntroWelcome.cs
index 9081be3dd6..11cea25865 100644
--- a/osu.Game.Tests/Visual/Menus/TestSceneIntroWelcome.cs
+++ b/osu.Game.Tests/Visual/Menus/TestSceneIntroWelcome.cs
@@ -10,6 +10,7 @@ namespace osu.Game.Tests.Visual.Menus
     [TestFixture]
     public class TestSceneIntroWelcome : IntroTestScene
     {
+        protected override bool IntroReliesOnTrack => false;
         protected override IntroScreen CreateScreen() => new IntroWelcome();
 
         public override void TestPlayIntro()

From 82806d7aebc5a0a2273575f4efdbbd6d1c7c866f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 30 Jan 2022 21:32:39 +0900
Subject: [PATCH 2650/5547] Ensure the background is eventually displayed when
 `IntroTriangles` suspends

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

diff --git a/osu.Game/Screens/Menu/IntroTriangles.cs b/osu.Game/Screens/Menu/IntroTriangles.cs
index 10f940e9de..b6b6bf2ad7 100644
--- a/osu.Game/Screens/Menu/IntroTriangles.cs
+++ b/osu.Game/Screens/Menu/IntroTriangles.cs
@@ -93,6 +93,9 @@ namespace osu.Game.Screens.Menu
         {
             base.OnSuspending(next);
 
+            // ensure the background is shown, even if the TriangleIntroSequence failed to do so.
+            background.ApplyToBackground(b => b.Show());
+
             // important as there is a clock attached to a track which will likely be disposed before returning to this screen.
             intro.Expire();
         }

From 1cec76df74df950db682ecde9de14ceeb9c1de8a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 30 Jan 2022 23:18:40 +0900
Subject: [PATCH 2651/5547] Fix weird reading 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/Online/Leaderboards/Leaderboard.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Online/Leaderboards/Leaderboard.cs b/osu.Game/Online/Leaderboards/Leaderboard.cs
index 9fb0fe0e3b..e96b12bc5d 100644
--- a/osu.Game/Online/Leaderboards/Leaderboard.cs
+++ b/osu.Game/Online/Leaderboards/Leaderboard.cs
@@ -176,7 +176,7 @@ namespace osu.Game.Online.Leaderboards
         }
 
         /// <summary>
-        /// Call when score retrieval is ready to be displayed.
+        /// Call when retrieved scores are ready to be displayed.
         /// </summary>
         /// <param name="scores">The scores to display.</param>
         /// <param name="userScore">The user top score, if any.</param>

From f8939af5e6d165d97ad733d0b39634ef6c5b1723 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 31 Jan 2022 01:12:03 +0900
Subject: [PATCH 2652/5547] Track loading via state as well

---
 .../SongSelect/TestSceneBeatmapLeaderboard.cs | 12 ++--
 osu.Game/Online/Leaderboards/Leaderboard.cs   | 66 ++++++++++---------
 ...boardErrorState.cs => LeaderboardState.cs} |  5 +-
 .../Select/Leaderboards/BeatmapLeaderboard.cs |  8 +--
 4 files changed, 48 insertions(+), 43 deletions(-)
 rename osu.Game/Online/Leaderboards/{LeaderboardErrorState.cs => LeaderboardState.cs} (82%)

diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
index f91339e060..48230ff9e9 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
@@ -116,11 +116,11 @@ namespace osu.Game.Tests.Visual.SongSelect
         {
             AddStep("ensure no scores displayed", () => leaderboard.SetScores(null));
 
-            AddStep(@"Network failure", () => leaderboard.SetErrorState(LeaderboardErrorState.NetworkFailure));
-            AddStep(@"No supporter", () => leaderboard.SetErrorState(LeaderboardErrorState.NotSupporter));
-            AddStep(@"Not logged in", () => leaderboard.SetErrorState(LeaderboardErrorState.NotLoggedIn));
-            AddStep(@"Unavailable", () => leaderboard.SetErrorState(LeaderboardErrorState.Unavailable));
-            AddStep(@"None selected", () => leaderboard.SetErrorState(LeaderboardErrorState.NoneSelected));
+            AddStep(@"Network failure", () => leaderboard.SetErrorState(LeaderboardState.NetworkFailure));
+            AddStep(@"No supporter", () => leaderboard.SetErrorState(LeaderboardState.NotSupporter));
+            AddStep(@"Not logged in", () => leaderboard.SetErrorState(LeaderboardState.NotLoggedIn));
+            AddStep(@"Unavailable", () => leaderboard.SetErrorState(LeaderboardState.Unavailable));
+            AddStep(@"None selected", () => leaderboard.SetErrorState(LeaderboardState.NoneSelected));
         }
 
         private void showPersonalBestWithNullPosition()
@@ -404,7 +404,7 @@ namespace osu.Game.Tests.Visual.SongSelect
 
         private class FailableLeaderboard : BeatmapLeaderboard
         {
-            public new void SetErrorState(LeaderboardErrorState errorState) => base.SetErrorState(errorState);
+            public new void SetErrorState(LeaderboardState state) => base.SetErrorState(state);
             public new void SetScores(IEnumerable<ScoreInfo> scores, ScoreInfo userScore = default) => base.SetScores(scores, userScore);
         }
     }
diff --git a/osu.Game/Online/Leaderboards/Leaderboard.cs b/osu.Game/Online/Leaderboards/Leaderboard.cs
index e96b12bc5d..7ac05fb0c0 100644
--- a/osu.Game/Online/Leaderboards/Leaderboard.cs
+++ b/osu.Game/Online/Leaderboards/Leaderboard.cs
@@ -58,7 +58,7 @@ namespace osu.Game.Online.Leaderboards
 
         private APIRequest fetchScoresRequest;
 
-        private LeaderboardErrorState errorState;
+        private LeaderboardState state;
 
         [Resolved(CanBeNull = true)]
         private IAPIProvider api { get; set; }
@@ -160,19 +160,20 @@ namespace osu.Game.Online.Leaderboards
         /// <summary>
         /// Call when a retrieval or display failure happened to show a relevant message to the user.
         /// </summary>
-        /// <param name="errorState">The state to display.</param>
-        protected void SetErrorState(LeaderboardErrorState errorState)
+        /// <param name="state">The state to display.</param>
+        protected void SetErrorState(LeaderboardState state)
         {
-            switch (errorState)
+            switch (state)
             {
-                case LeaderboardErrorState.NoScores:
-                case LeaderboardErrorState.NoError:
-                    throw new InvalidOperationException($"State {errorState} cannot be set by a leaderboard implementation.");
+                case LeaderboardState.NoScores:
+                case LeaderboardState.Retrieving:
+                case LeaderboardState.Success:
+                    throw new InvalidOperationException($"State {state} cannot be set by a leaderboard implementation.");
             }
 
             Debug.Assert(scores?.Any() != true);
 
-            setErrorState(errorState);
+            setState(state);
         }
 
         /// <summary>
@@ -212,8 +213,7 @@ namespace osu.Game.Online.Leaderboards
             cancelPendingWork();
             SetScores(null);
 
-            setErrorState(LeaderboardErrorState.NoError);
-            loading.Show();
+            setState(LeaderboardState.Retrieving);
 
             currentFetchCancellationSource = new CancellationTokenSource();
 
@@ -227,7 +227,7 @@ namespace osu.Game.Online.Leaderboards
                 if (e is OperationCanceledException || currentFetchCancellationSource.IsCancellationRequested)
                     return;
 
-                SetErrorState(LeaderboardErrorState.NetworkFailure);
+                SetErrorState(LeaderboardState.NetworkFailure);
             });
 
             api?.Queue(fetchScoresRequest);
@@ -251,15 +251,10 @@ namespace osu.Game.Online.Leaderboards
 
             if (scores?.Any() != true)
             {
-                setErrorState(LeaderboardErrorState.NoScores);
-                loading.Hide();
+                setState(LeaderboardState.NoScores);
                 return;
             }
 
-            // ensure placeholder is hidden when displaying scores
-            setErrorState(LeaderboardErrorState.NoError);
-            loading.Show();
-
             LoadComponentAsync(new FillFlowContainer<LeaderboardScore>
             {
                 RelativeSizeAxes = Axes.X,
@@ -269,6 +264,8 @@ namespace osu.Game.Online.Leaderboards
                 ChildrenEnumerable = scores.Select((s, index) => CreateDrawableScore(s, index + 1))
             }, newFlow =>
             {
+                setState(LeaderboardState.Success);
+
                 scrollContainer.Add(scoreFlowContainer = newFlow);
 
                 double delay = 0;
@@ -282,7 +279,6 @@ namespace osu.Game.Online.Leaderboards
                 }
 
                 scrollContainer.ScrollToStart(false);
-                loading.Hide();
             }, (currentScoresAsyncLoadCancellationSource = new CancellationTokenSource()).Token);
         }
 
@@ -290,16 +286,21 @@ namespace osu.Game.Online.Leaderboards
 
         private Placeholder placeholder;
 
-        private void setErrorState(LeaderboardErrorState errorState)
+        private void setState(LeaderboardState state)
         {
-            if (errorState == this.errorState)
+            if (state == this.state)
                 return;
 
-            this.errorState = errorState;
+            if (state == LeaderboardState.Retrieving)
+                loading.Show();
+            else
+                loading.Hide();
+
+            this.state = state;
 
             placeholder?.FadeOut(150, Easing.OutQuint).Expire();
 
-            placeholder = getPlaceholderFor(errorState);
+            placeholder = getPlaceholderFor(state);
 
             if (placeholder == null)
                 return;
@@ -310,32 +311,35 @@ namespace osu.Game.Online.Leaderboards
             placeholder.FadeInFromZero(fade_duration, Easing.OutQuint);
         }
 
-        private Placeholder getPlaceholderFor(LeaderboardErrorState errorState)
+        private Placeholder getPlaceholderFor(LeaderboardState state)
         {
-            switch (errorState)
+            switch (state)
             {
-                case LeaderboardErrorState.NetworkFailure:
+                case LeaderboardState.NetworkFailure:
                     return new ClickablePlaceholder(@"Couldn't fetch scores!", FontAwesome.Solid.Sync)
                     {
                         Action = RefetchScores
                     };
 
-                case LeaderboardErrorState.NoneSelected:
+                case LeaderboardState.NoneSelected:
                     return new MessagePlaceholder(@"Please select a beatmap!");
 
-                case LeaderboardErrorState.Unavailable:
+                case LeaderboardState.Unavailable:
                     return new MessagePlaceholder(@"Leaderboards are not available for this beatmap!");
 
-                case LeaderboardErrorState.NoScores:
+                case LeaderboardState.NoScores:
                     return new MessagePlaceholder(@"No records yet!");
 
-                case LeaderboardErrorState.NotLoggedIn:
+                case LeaderboardState.NotLoggedIn:
                     return new LoginPlaceholder(@"Please sign in to view online leaderboards!");
 
-                case LeaderboardErrorState.NotSupporter:
+                case LeaderboardState.NotSupporter:
                     return new MessagePlaceholder(@"Please invest in an osu!supporter tag to view this leaderboard!");
 
-                case LeaderboardErrorState.NoError:
+                case LeaderboardState.Retrieving:
+                    return null;
+
+                case LeaderboardState.Success:
                     return null;
 
                 default:
diff --git a/osu.Game/Online/Leaderboards/LeaderboardErrorState.cs b/osu.Game/Online/Leaderboards/LeaderboardState.cs
similarity index 82%
rename from osu.Game/Online/Leaderboards/LeaderboardErrorState.cs
rename to osu.Game/Online/Leaderboards/LeaderboardState.cs
index 17f47bb557..75e2c6e6db 100644
--- a/osu.Game/Online/Leaderboards/LeaderboardErrorState.cs
+++ b/osu.Game/Online/Leaderboards/LeaderboardState.cs
@@ -3,9 +3,10 @@
 
 namespace osu.Game.Online.Leaderboards
 {
-    public enum LeaderboardErrorState
+    public enum LeaderboardState
     {
-        NoError,
+        Success,
+        Retrieving,
         NetworkFailure,
         Unavailable,
         NoneSelected,
diff --git a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
index 3521a2ef78..48eb33cc05 100644
--- a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
+++ b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
@@ -101,7 +101,7 @@ namespace osu.Game.Screens.Select.Leaderboards
 
             if (fetchBeatmapInfo == null)
             {
-                SetErrorState(LeaderboardErrorState.NoneSelected);
+                SetErrorState(LeaderboardState.NoneSelected);
                 return null;
             }
 
@@ -113,19 +113,19 @@ namespace osu.Game.Screens.Select.Leaderboards
 
             if (api?.IsLoggedIn != true)
             {
-                SetErrorState(LeaderboardErrorState.NotLoggedIn);
+                SetErrorState(LeaderboardState.NotLoggedIn);
                 return null;
             }
 
             if (fetchBeatmapInfo.OnlineID <= 0 || fetchBeatmapInfo.Status <= BeatmapOnlineStatus.Pending)
             {
-                SetErrorState(LeaderboardErrorState.Unavailable);
+                SetErrorState(LeaderboardState.Unavailable);
                 return null;
             }
 
             if (!api.LocalUser.Value.IsSupporter && (Scope != BeatmapLeaderboardScope.Global || filterMods))
             {
-                SetErrorState(LeaderboardErrorState.NotSupporter);
+                SetErrorState(LeaderboardState.NotSupporter);
                 return null;
             }
 

From b52153e73d354f137b221d5c14cd505d37a8ffdd Mon Sep 17 00:00:00 2001
From: Spooghetti420 <kkovachev1947@gmail.com>
Date: Sun, 30 Jan 2022 17:40:15 +0000
Subject: [PATCH 2653/5547] Remove settings

---
 .../Mods/TestSceneManiaModHoldOff.cs          | 58 +++----------------
 .../Mods/ManiaModHoldOff.cs                   | 28 +--------
 2 files changed, 10 insertions(+), 76 deletions(-)

diff --git a/osu.Game.Rulesets.Mania.Tests/Mods/TestSceneManiaModHoldOff.cs b/osu.Game.Rulesets.Mania.Tests/Mods/TestSceneManiaModHoldOff.cs
index e74f63abb3..a113b7ac80 100644
--- a/osu.Game.Rulesets.Mania.Tests/Mods/TestSceneManiaModHoldOff.cs
+++ b/osu.Game.Rulesets.Mania.Tests/Mods/TestSceneManiaModHoldOff.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.Linq;
 using NUnit.Framework;
 using osu.Game.Beatmaps;
@@ -11,8 +10,6 @@ using System.Collections.Generic;
 using osu.Game.Rulesets.Mania.Objects;
 using osu.Game.Beatmaps.ControlPoints;
 using osu.Game.Rulesets.Mania.Beatmaps;
-using osu.Game.Rulesets.Mania.Difficulty;
-using osu.Game.Tests.Beatmaps;
 
 namespace osu.Game.Rulesets.Mania.Tests.Mods
 {
@@ -42,24 +39,17 @@ namespace osu.Game.Rulesets.Mania.Tests.Mods
             Assert.AreEqual(noteValues, new List<double> { 0.125, 0.250, 0.500, 1.000, 2.000 });
         }
 
-        [TestCase(ManiaModHoldOff.BeatDivisors.Whole)]
-        [TestCase(ManiaModHoldOff.BeatDivisors.Half)]
-        [TestCase(ManiaModHoldOff.BeatDivisors.Quarter)]
-        [TestCase(ManiaModHoldOff.BeatDivisors.Eighth)]
-        public void TestCorrectObjectCount(ManiaModHoldOff.BeatDivisors minBeatSnap)
+        [Test]
+        public void TestCorrectObjectCount()
         {
-            /*
-                This test is to ensure that, given that end notes are enabled,
-                the mod produces the expected number of objects when the mod is applied.
-            */
+            // Ensure that the mod produces the expected number of objects when applied.
 
-            // Mod settings will be set to include the correct beat snap value
             var rawBeatmap = createRawBeatmap();
-            var testBeatmap = createModdedBeatmap(minBeatSnap);
+            var testBeatmap = createModdedBeatmap();
 
             // Calculate expected number of objects
             int expectedObjectCount = 0;
-            double beatSnapValue = 1 / (Math.Pow(2, (int)minBeatSnap));
+            double beatSnapValue = ManiaModHoldOff.Threshold;
 
             foreach (ManiaHitObject h in rawBeatmap.HitObjects)
             {
@@ -81,44 +71,10 @@ namespace osu.Game.Rulesets.Mania.Tests.Mods
             Assert.That(testBeatmap.HitObjects.Count == expectedObjectCount);
         }
 
-        [Test]
-        public void TestDifficultyIncrease()
-        {
-            // A lower minimum beat snap divisor should only make the map harder, never easier
-            // (as more notes can be spawned)
-            var beatmaps = new[]
-            {
-                createModdedBeatmap(),
-                createModdedBeatmap(ManiaModHoldOff.BeatDivisors.Half),
-                createModdedBeatmap(ManiaModHoldOff.BeatDivisors.Quarter),
-                createModdedBeatmap(ManiaModHoldOff.BeatDivisors.Eighth),
-                createModdedBeatmap(ManiaModHoldOff.BeatDivisors.Sixteenth)
-            };
-
-            double[] mapDifficulties = new double[beatmaps.Length];
-
-            for (int i = 0; i < mapDifficulties.Length; i++)
-            {
-                var workingBeatmap = new TestWorkingBeatmap(beatmaps[i]);
-                var difficultyCalculator = new ManiaDifficultyCalculator(new ManiaRuleset().RulesetInfo, workingBeatmap);
-                mapDifficulties[i] = difficultyCalculator.Calculate().StarRating;
-
-                if (i > 0)
-                {
-                    Assert.LessOrEqual(mapDifficulties[i - 1], mapDifficulties[i]);
-                    Assert.LessOrEqual(beatmaps[i - 1].HitObjects.Count, beatmaps[i].HitObjects.Count);
-                }
-            }
-        }
-
-        private static ManiaBeatmap createModdedBeatmap(ManiaModHoldOff.BeatDivisors minBeatSnap = ManiaModHoldOff.BeatDivisors.Whole)
+        private static ManiaBeatmap createModdedBeatmap()
         {
             var beatmap = createRawBeatmap();
-            var holdOffMod = new ManiaModHoldOff
-            {
-                MinBeatSnap = { Value = minBeatSnap }
-            };
-            Assert.AreEqual(holdOffMod.MinBeatSnap.Value, minBeatSnap);
+            var holdOffMod = new ManiaModHoldOff();
 
             foreach (var hitObject in beatmap.HitObjects)
                 hitObject.ApplyDefaults(beatmap.ControlPointInfo, new BeatmapDifficulty());
diff --git a/osu.Game.Rulesets.Mania/Mods/ManiaModHoldOff.cs b/osu.Game.Rulesets.Mania/Mods/ManiaModHoldOff.cs
index 637142aed6..5a47e1ba89 100644
--- a/osu.Game.Rulesets.Mania/Mods/ManiaModHoldOff.cs
+++ b/osu.Game.Rulesets.Mania/Mods/ManiaModHoldOff.cs
@@ -6,11 +6,8 @@ using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Mania.Objects;
 using osu.Game.Rulesets.Mods;
 using osu.Framework.Graphics.Sprites;
-using System;
 using System.Collections.Generic;
 using osu.Game.Rulesets.Mania.Beatmaps;
-using osu.Framework.Bindables;
-using osu.Game.Configuration;
 
 namespace osu.Game.Rulesets.Mania.Mods
 {
@@ -27,23 +24,13 @@ namespace osu.Game.Rulesets.Mania.Mods
         public override IconUsage? Icon => FontAwesome.Solid.DotCircle;
 
         public override ModType Type => ModType.Conversion;
-
-        [SettingSource("Add end notes", "Also add a note at the end of a hold note")]
-        public BindableBool AddEndNotes { get; } = new BindableBool
-        {
-            Default = true,
-            Value = true
-        };
-
-        [SettingSource("Minimum end note beat snap", "Don't add end notes for hold notes shorter than this beat division")]
-        public Bindable<BeatDivisors> MinBeatSnap { get; } = new Bindable<BeatDivisors>(defaultValue: BeatDivisors.Half);
+        public const double Threshold = 1/2;
 
         public void ApplyToBeatmap(IBeatmap beatmap)
         {
             var maniaBeatmap = (ManiaBeatmap)beatmap;
 
             var newObjects = new List<ManiaHitObject>();
-            double beatSnap = 1 / (Math.Pow(2, (double)MinBeatSnap.Value));
 
             foreach (var h in beatmap.HitObjects.OfType<HoldNote>())
             {
@@ -55,10 +42,10 @@ namespace osu.Game.Rulesets.Mania.Mods
                     Samples = h.GetNodeSamples(0)
                 });
 
-                // Don't add an end note if the duration is shorter than some threshold, or end notes are disabled
+                // Don't add an end note if the duration is shorter than the threshold
                 double noteValue = GetNoteDurationInBeatLength(h, maniaBeatmap); // 1/1, 1/2, 1/4, etc.
 
-                if (AddEndNotes.Value && noteValue >= beatSnap)
+                if (noteValue >= Threshold)
                 {
                     newObjects.Add(new Note
                     {
@@ -77,14 +64,5 @@ namespace osu.Game.Rulesets.Mania.Mods
             double bpmAtNoteTime = beatmap.ControlPointInfo.TimingPointAt(holdNote.StartTime).BPM;
             return (60 * holdNote.Duration) / (1000 * bpmAtNoteTime);
         }
-
-        public enum BeatDivisors
-        {
-            Whole,
-            Half,
-            Quarter,
-            Eighth,
-            Sixteenth
-        }
     }
 }

From 2b999f9780f4f9e96c92fbe42e4a71a86605b0ec Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sat, 29 Jan 2022 23:39:45 +0300
Subject: [PATCH 2654/5547] Add failing test case

---
 .../TestSceneMasterGameplayClockContainer.cs  | 52 +++++++++++++++++++
 1 file changed, 52 insertions(+)

diff --git a/osu.Game.Tests/Gameplay/TestSceneMasterGameplayClockContainer.cs b/osu.Game.Tests/Gameplay/TestSceneMasterGameplayClockContainer.cs
index 935bc07733..172531605a 100644
--- a/osu.Game.Tests/Gameplay/TestSceneMasterGameplayClockContainer.cs
+++ b/osu.Game.Tests/Gameplay/TestSceneMasterGameplayClockContainer.cs
@@ -2,7 +2,13 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using NUnit.Framework;
+using osu.Framework.Allocation;
+using osu.Framework.Audio;
+using osu.Framework.Bindables;
 using osu.Framework.Testing;
+using osu.Framework.Timing;
+using osu.Framework.Utils;
+using osu.Game.Configuration;
 using osu.Game.Rulesets.Osu;
 using osu.Game.Screens.Play;
 using osu.Game.Tests.Visual;
@@ -12,6 +18,14 @@ namespace osu.Game.Tests.Gameplay
     [HeadlessTest]
     public class TestSceneMasterGameplayClockContainer : OsuTestScene
     {
+        private OsuConfigManager localConfig;
+
+        [BackgroundDependencyLoader]
+        private void load()
+        {
+            Dependencies.Cache(localConfig = new OsuConfigManager(LocalStorage));
+        }
+
         [Test]
         public void TestStartThenElapsedTime()
         {
@@ -54,5 +68,43 @@ namespace osu.Game.Tests.Gameplay
 
             AddAssert("current time < time at reset", () => gcc.GameplayClock.CurrentTime < timeAtReset);
         }
+
+        [Test]
+        public void TestSeekPerformsInGameplayTime(
+            [Values(1.0, 0.5, 2.0)] double clockRate,
+            [Values(0.0, 200.0, -200.0)] double userOffset,
+            [Values(false, true)] bool whileStopped)
+        {
+            ClockBackedTestWorkingBeatmap working = null;
+            GameplayClockContainer gcc = null;
+
+            AddStep("create container", () =>
+            {
+                working = new ClockBackedTestWorkingBeatmap(new OsuRuleset().RulesetInfo, new FramedClock(new ManualClock()), Audio);
+                working.LoadTrack();
+
+                Add(gcc = new MasterGameplayClockContainer(working, 0));
+
+                if (whileStopped)
+                    gcc.Stop();
+
+                gcc.Reset();
+            });
+
+            AddStep($"set clock rate to {clockRate}", () => working.Track.AddAdjustment(AdjustableProperty.Frequency, new BindableDouble(clockRate)));
+            AddStep($"set audio offset to {userOffset}", () => localConfig.SetValue(OsuSetting.AudioOffset, userOffset));
+
+            AddStep("seek to 2500", () => gcc.Seek(2500));
+            AddAssert("gameplay clock time = 2500", () => Precision.AlmostEquals(gcc.CurrentTime, 2500, 10f));
+
+            AddStep("seek to 10000", () => gcc.Seek(10000));
+            AddAssert("gameplay clock time = 10000", () => Precision.AlmostEquals(gcc.CurrentTime, 10000, 10f));
+        }
+
+        protected override void Dispose(bool isDisposing)
+        {
+            localConfig?.Dispose();
+            base.Dispose(isDisposing);
+        }
     }
 }

From 6556a7e3c3533b46a1f6b97989d2d6bf4f908a4a Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sat, 29 Jan 2022 23:06:31 +0300
Subject: [PATCH 2655/5547] Handle different gameplay rates when seeking on
 master clock

---
 .../Play/MasterGameplayClockContainer.cs      | 39 ++++++++++++++-----
 1 file changed, 29 insertions(+), 10 deletions(-)

diff --git a/osu.Game/Screens/Play/MasterGameplayClockContainer.cs b/osu.Game/Screens/Play/MasterGameplayClockContainer.cs
index aa46522dec..200921680e 100644
--- a/osu.Game/Screens/Play/MasterGameplayClockContainer.cs
+++ b/osu.Game/Screens/Play/MasterGameplayClockContainer.cs
@@ -43,7 +43,7 @@ namespace osu.Game.Screens.Play
             Precision = 0.1,
         };
 
-        private double totalOffset => userOffsetClock.Offset + platformOffsetClock.Offset;
+        private double totalAppliedOffset => userOffsetClock.RateAdjustedOffset + platformOffsetClock.RateAdjustedOffset;
 
         private readonly BindableDouble pauseFreqAdjust = new BindableDouble(1);
 
@@ -52,8 +52,8 @@ namespace osu.Game.Screens.Play
         private readonly bool startAtGameplayStart;
         private readonly double firstHitObjectTime;
 
-        private FramedOffsetClock userOffsetClock;
-        private FramedOffsetClock platformOffsetClock;
+        private HardwareCorrectionOffsetClock userOffsetClock;
+        private HardwareCorrectionOffsetClock platformOffsetClock;
         private MasterGameplayClock masterGameplayClock;
         private Bindable<double> userAudioOffset;
         private double startOffset;
@@ -128,7 +128,7 @@ namespace osu.Game.Screens.Play
         {
             // remove the offset component here because most of the time we want the seek to be aligned to gameplay, not the audio track.
             // we may want to consider reversing the application of offsets in the future as it may feel more correct.
-            base.Seek(time - totalOffset);
+            base.Seek(time - totalAppliedOffset);
         }
 
         /// <summary>
@@ -214,13 +214,25 @@ namespace osu.Game.Screens.Play
 
         private class HardwareCorrectionOffsetClock : FramedOffsetClock
         {
-            // we always want to apply the same real-time offset, so it should be adjusted by the difference in playback rate (from realtime) to achieve this.
-            // base implementation already adds offset at 1.0 rate, so we only add the difference from that here.
-            public override double CurrentTime => base.CurrentTime + offsetAdjust;
-
             private readonly BindableDouble pauseRateAdjust;
 
-            private double offsetAdjust;
+            private double offset;
+
+            public new double Offset
+            {
+                get => offset;
+                set
+                {
+                    if (value == offset)
+                        return;
+
+                    offset = value;
+
+                    updateOffset();
+                }
+            }
+
+            public double RateAdjustedOffset => base.Offset;
 
             public HardwareCorrectionOffsetClock(IClock source, BindableDouble pauseRateAdjust)
                 : base(source)
@@ -231,10 +243,17 @@ namespace osu.Game.Screens.Play
             public override void ProcessFrame()
             {
                 base.ProcessFrame();
+                updateOffset();
+            }
 
+            private void updateOffset()
+            {
                 // changing this during the pause transform effect will cause a potentially large offset to be suddenly applied as we approach zero rate.
                 if (pauseRateAdjust.Value == 1)
-                    offsetAdjust = Offset * (Rate - 1);
+                {
+                    // we always want to apply the same real-time offset, so it should be adjusted by the difference in playback rate (from realtime) to achieve this.
+                    base.Offset = Offset * Rate;
+                }
             }
         }
 

From bb8dc74e88fb3fcc3ce6958d740199a9249bc11b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 31 Jan 2022 12:20:51 +0900
Subject: [PATCH 2656/5547] Fix constant formatting

---
 .../Mods/TestSceneManiaModHoldOff.cs                         | 3 +--
 osu.Game.Rulesets.Mania/Mods/ManiaModHoldOff.cs              | 5 +++--
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Rulesets.Mania.Tests/Mods/TestSceneManiaModHoldOff.cs b/osu.Game.Rulesets.Mania.Tests/Mods/TestSceneManiaModHoldOff.cs
index a113b7ac80..7970d5b594 100644
--- a/osu.Game.Rulesets.Mania.Tests/Mods/TestSceneManiaModHoldOff.cs
+++ b/osu.Game.Rulesets.Mania.Tests/Mods/TestSceneManiaModHoldOff.cs
@@ -49,7 +49,6 @@ namespace osu.Game.Rulesets.Mania.Tests.Mods
 
             // Calculate expected number of objects
             int expectedObjectCount = 0;
-            double beatSnapValue = ManiaModHoldOff.Threshold;
 
             foreach (ManiaHitObject h in rawBeatmap.HitObjects)
             {
@@ -60,7 +59,7 @@ namespace osu.Game.Rulesets.Mania.Tests.Mods
                 {
                     double noteValue = ManiaModHoldOff.GetNoteDurationInBeatLength((HoldNote)h, rawBeatmap);
 
-                    if (noteValue >= beatSnapValue)
+                    if (noteValue >= ManiaModHoldOff.END_NOTE_ALLOW_THRESHOLD)
                     {
                         // Should generate an end note if it's longer than the minimum note value
                         expectedObjectCount++;
diff --git a/osu.Game.Rulesets.Mania/Mods/ManiaModHoldOff.cs b/osu.Game.Rulesets.Mania/Mods/ManiaModHoldOff.cs
index 5a47e1ba89..42dc7fdc1f 100644
--- a/osu.Game.Rulesets.Mania/Mods/ManiaModHoldOff.cs
+++ b/osu.Game.Rulesets.Mania/Mods/ManiaModHoldOff.cs
@@ -24,7 +24,8 @@ namespace osu.Game.Rulesets.Mania.Mods
         public override IconUsage? Icon => FontAwesome.Solid.DotCircle;
 
         public override ModType Type => ModType.Conversion;
-        public const double Threshold = 1/2;
+
+        public const double END_NOTE_ALLOW_THRESHOLD = 0.5;
 
         public void ApplyToBeatmap(IBeatmap beatmap)
         {
@@ -45,7 +46,7 @@ namespace osu.Game.Rulesets.Mania.Mods
                 // Don't add an end note if the duration is shorter than the threshold
                 double noteValue = GetNoteDurationInBeatLength(h, maniaBeatmap); // 1/1, 1/2, 1/4, etc.
 
-                if (noteValue >= Threshold)
+                if (noteValue >= END_NOTE_ALLOW_THRESHOLD)
                 {
                     newObjects.Add(new Note
                     {

From 610eb9f6a45e8f3f762bac4f25a814c7169d8010 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 31 Jan 2022 13:45:49 +0900
Subject: [PATCH 2657/5547] Remove unnecessary container level

---
 osu.Game/Online/Leaderboards/Leaderboard.cs | 7 +------
 1 file changed, 1 insertion(+), 6 deletions(-)

diff --git a/osu.Game/Online/Leaderboards/Leaderboard.cs b/osu.Game/Online/Leaderboards/Leaderboard.cs
index 7ac05fb0c0..5dd3e46b4a 100644
--- a/osu.Game/Online/Leaderboards/Leaderboard.cs
+++ b/osu.Game/Online/Leaderboards/Leaderboard.cs
@@ -110,12 +110,7 @@ namespace osu.Game.Online.Leaderboards
                             },
                             new Drawable[]
                             {
-                                new Container
-                                {
-                                    AutoSizeAxes = Axes.Y,
-                                    RelativeSizeAxes = Axes.X,
-                                    Child = userScoreContainer = new UserTopScoreContainer<TScoreInfo>(CreateDrawableTopScore)
-                                },
+                                userScoreContainer = new UserTopScoreContainer<TScoreInfo>(CreateDrawableTopScore)
                             },
                         },
                     },

From 9c9fda84f3cf54073c7d15b62946251a3a27d328 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 31 Jan 2022 13:50:53 +0900
Subject: [PATCH 2658/5547] Add schedule and cancellation check to score
 ordering step

---
 osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
index 48eb33cc05..907a2c9bda 100644
--- a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
+++ b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
@@ -201,10 +201,13 @@ namespace osu.Game.Screens.Select.Leaderboards
                 scores = scores.Detach();
 
                 scoreManager.OrderByTotalScoreAsync(scores.ToArray(), cancellationToken)
-                            .ContinueWith(ordered =>
+                            .ContinueWith(ordered => Schedule(() =>
                             {
+                                if (cancellationToken.IsCancellationRequested)
+                                    return;
+
                                 SetScores(ordered.GetResultSafely());
-                            }, TaskContinuationOptions.OnlyOnRanToCompletion);
+                            }), TaskContinuationOptions.OnlyOnRanToCompletion);
             }
         }
 

From a06287e76aac73bbf141d07a71fa417c7dbb31d2 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 30 Jan 2022 12:34:08 +0900
Subject: [PATCH 2659/5547] Remove `DrawableCarouselItem.Update` updating of
 height

Marginal from a performance aspect, but reads better.
---
 .../Select/Carousel/DrawableCarouselBeatmap.cs     |  7 +++----
 .../Select/Carousel/DrawableCarouselItem.cs        | 14 ++++++--------
 2 files changed, 9 insertions(+), 12 deletions(-)

diff --git a/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmap.cs b/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmap.cs
index 3576b77ae8..43ddfc79b1 100644
--- a/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmap.cs
+++ b/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmap.cs
@@ -36,9 +36,9 @@ namespace osu.Game.Screens.Select.Carousel
         /// <summary>
         /// The height of a carousel beatmap, including vertical spacing.
         /// </summary>
-        public const float HEIGHT = height + CAROUSEL_BEATMAP_SPACING;
+        public const float HEIGHT = header_height + CAROUSEL_BEATMAP_SPACING;
 
-        private const float height = MAX_HEIGHT * 0.6f;
+        private const float header_height = MAX_HEIGHT * 0.6f;
 
         private readonly BeatmapInfo beatmapInfo;
 
@@ -67,6 +67,7 @@ namespace osu.Game.Screens.Select.Carousel
         private CancellationTokenSource starDifficultyCancellationSource;
 
         public DrawableCarouselBeatmap(CarouselBeatmap panel)
+            : base(header_height)
         {
             beatmapInfo = panel.BeatmapInfo;
             Item = panel;
@@ -75,8 +76,6 @@ namespace osu.Game.Screens.Select.Carousel
         [BackgroundDependencyLoader(true)]
         private void load(BeatmapManager manager, SongSelect songSelect)
         {
-            Header.Height = height;
-
             if (songSelect != null)
             {
                 startRequested = b => songSelect.FinaliseSelection(b);
diff --git a/osu.Game/Screens/Select/Carousel/DrawableCarouselItem.cs b/osu.Game/Screens/Select/Carousel/DrawableCarouselItem.cs
index cde3edad39..8b38bb9a96 100644
--- a/osu.Game/Screens/Select/Carousel/DrawableCarouselItem.cs
+++ b/osu.Game/Screens/Select/Carousel/DrawableCarouselItem.cs
@@ -60,7 +60,7 @@ namespace osu.Game.Screens.Select.Carousel
             }
         }
 
-        protected DrawableCarouselItem()
+        protected DrawableCarouselItem(float headerHeight = MAX_HEIGHT)
         {
             RelativeSizeAxes = Axes.X;
 
@@ -73,10 +73,14 @@ namespace osu.Game.Screens.Select.Carousel
                     RelativeSizeAxes = Axes.Both,
                     Children = new Drawable[]
                     {
-                        Header = new CarouselHeader(),
+                        Header = new CarouselHeader
+                        {
+                            Height = headerHeight,
+                        },
                         Content = new Container
                         {
                             RelativeSizeAxes = Axes.Both,
+                            Y = headerHeight,
                         }
                     }
                 },
@@ -92,12 +96,6 @@ namespace osu.Game.Screens.Select.Carousel
             UpdateItem();
         }
 
-        protected override void Update()
-        {
-            base.Update();
-            Content.Y = Header.Height;
-        }
-
         protected virtual void UpdateItem()
         {
             if (item == null)

From c3e3b2019dcf169d74c435bde269ec53bf43a8fb Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 30 Jan 2022 13:01:41 +0900
Subject: [PATCH 2660/5547] Reduce overhead of `ApplyState` by tracking
 previous values

Even with pooling applied, there are overheads involved with transforms
when quickly cycling through the carousel.

The main goal here is to reduce the transforms in cases the reuse is
still in the same state. Avoiding firing `FadeIn` and `FadeOut` are the
main areas of saving.
---
 .../Carousel/DrawableCarouselBeatmap.cs       |  3 +
 .../Select/Carousel/DrawableCarouselItem.cs   | 55 ++++++++++++++-----
 2 files changed, 43 insertions(+), 15 deletions(-)

diff --git a/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmap.cs b/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmap.cs
index 43ddfc79b1..a3483aa60a 100644
--- a/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmap.cs
+++ b/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmap.cs
@@ -71,6 +71,9 @@ namespace osu.Game.Screens.Select.Carousel
         {
             beatmapInfo = panel.BeatmapInfo;
             Item = panel;
+
+            // Difficulty panels should start hidden for a better initial effect.
+            Hide();
         }
 
         [BackgroundDependencyLoader(true)]
diff --git a/osu.Game/Screens/Select/Carousel/DrawableCarouselItem.cs b/osu.Game/Screens/Select/Carousel/DrawableCarouselItem.cs
index 8b38bb9a96..4a23faa650 100644
--- a/osu.Game/Screens/Select/Carousel/DrawableCarouselItem.cs
+++ b/osu.Game/Screens/Select/Carousel/DrawableCarouselItem.cs
@@ -64,8 +64,6 @@ namespace osu.Game.Screens.Select.Carousel
         {
             RelativeSizeAxes = Axes.X;
 
-            Alpha = 0;
-
             InternalChildren = new Drawable[]
             {
                 MovementContainer = new Container
@@ -119,29 +117,56 @@ namespace osu.Game.Screens.Select.Carousel
 
         private void onStateChange(ValueChangedEvent<bool> _) => Scheduler.AddOnce(ApplyState);
 
+        private CarouselItemState? lastAppliedState;
+
         protected virtual void ApplyState()
         {
-            // Use the fact that we know the precise height of the item from the model to avoid the need for AutoSize overhead.
-            // Additionally, AutoSize doesn't work well due to content starting off-screen and being masked away.
-            Height = Item.TotalHeight;
-
             Debug.Assert(Item != null);
 
-            switch (Item.State.Value)
+            if (lastAppliedState != Item.State.Value)
             {
-                case CarouselItemState.NotSelected:
-                    Deselected();
-                    break;
+                lastAppliedState = Item.State.Value;
 
-                case CarouselItemState.Selected:
-                    Selected();
-                    break;
+                // Use the fact that we know the precise height of the item from the model to avoid the need for AutoSize overhead.
+                // Additionally, AutoSize doesn't work well due to content starting off-screen and being masked away.
+                Height = Item.TotalHeight;
+
+                switch (lastAppliedState)
+                {
+                    case CarouselItemState.NotSelected:
+                        Deselected();
+                        break;
+
+                    case CarouselItemState.Selected:
+                        Selected();
+                        break;
+                }
             }
 
             if (!Item.Visible)
-                this.FadeOut(300, Easing.OutQuint);
+                Hide();
             else
-                this.FadeIn(250);
+                Show();
+        }
+
+        private bool isVisible = true;
+
+        public override void Show()
+        {
+            if (isVisible)
+                return;
+
+            isVisible = true;
+            this.FadeIn(250);
+        }
+
+        public override void Hide()
+        {
+            if (!isVisible)
+                return;
+
+            isVisible = false;
+            this.FadeOut(300, Easing.OutQuint);
         }
 
         protected virtual void Selected()

From 2ee0db0ebf68bc6651171c78e077418e952d71dd Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 30 Jan 2022 14:07:29 +0900
Subject: [PATCH 2661/5547] Move fade in function local

---
 .../Screens/Select/Carousel/DrawableCarouselBeatmapSet.cs     | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmapSet.cs b/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmapSet.cs
index 618c5cf5ec..4f19e011b2 100644
--- a/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmapSet.cs
+++ b/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmapSet.cs
@@ -124,9 +124,9 @@ namespace osu.Game.Screens.Select.Carousel
 
             background.DelayedLoadComplete += fadeContentIn;
             mainFlow.DelayedLoadComplete += fadeContentIn;
-        }
 
-        private void fadeContentIn(Drawable d) => d.FadeInFromZero(750, Easing.OutQuint);
+            static void fadeContentIn(Drawable d) => d.FadeInFromZero(750, Easing.OutQuint);
+        }
 
         protected override void Deselected()
         {

From 8917ab78f427c1dfb2e5eef47738fafec8fa746a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 30 Jan 2022 14:14:50 +0900
Subject: [PATCH 2662/5547] Reduce unnecessary container nesting and adjust
 empty state opacity slightly

---
 osu.Game/Screens/Select/BeatmapCarousel.cs    |  6 ++--
 .../Screens/Select/Carousel/CarouselHeader.cs | 29 ++++++++-----------
 .../Select/Carousel/DrawableCarouselItem.cs   |  2 --
 3 files changed, 14 insertions(+), 23 deletions(-)

diff --git a/osu.Game/Screens/Select/BeatmapCarousel.cs b/osu.Game/Screens/Select/BeatmapCarousel.cs
index c27915c383..fbb12a86d3 100644
--- a/osu.Game/Screens/Select/BeatmapCarousel.cs
+++ b/osu.Game/Screens/Select/BeatmapCarousel.cs
@@ -894,10 +894,8 @@ namespace osu.Game.Screens.Select
             // child items (difficulties) are still visible.
             item.Header.X = offsetX(dist, visibleHalfHeight) - (parent?.X ?? 0);
 
-            // We are applying a multiplicative alpha (which is internally done by nesting an
-            // additional container and setting that container's alpha) such that we can
-            // layer alpha transformations on top.
-            item.SetMultiplicativeAlpha(Math.Clamp(1.75f - 1.5f * dist, 0, 1));
+            // We are applying alpha to the header here such that we can layer alpha transformations on top.
+            item.Header.Alpha = Math.Clamp(1.75f - 1.5f * dist, 0, 1);
         }
 
         private enum PendingScrollOperation
diff --git a/osu.Game/Screens/Select/Carousel/CarouselHeader.cs b/osu.Game/Screens/Select/Carousel/CarouselHeader.cs
index ed3aea3445..533694b265 100644
--- a/osu.Game/Screens/Select/Carousel/CarouselHeader.cs
+++ b/osu.Game/Screens/Select/Carousel/CarouselHeader.cs
@@ -21,8 +21,6 @@ namespace osu.Game.Screens.Select.Carousel
 {
     public class CarouselHeader : Container
     {
-        public Container BorderContainer;
-
         public readonly Bindable<CarouselItemState> State = new Bindable<CarouselItemState>(CarouselItemState.NotSelected);
 
         private readonly HoverLayer hoverLayer;
@@ -37,17 +35,14 @@ namespace osu.Game.Screens.Select.Carousel
             RelativeSizeAxes = Axes.X;
             Height = DrawableCarouselItem.MAX_HEIGHT;
 
-            InternalChild = BorderContainer = new Container
+            Masking = true;
+            CornerRadius = corner_radius;
+            BorderColour = new Color4(221, 255, 255, 255);
+
+            InternalChildren = new Drawable[]
             {
-                RelativeSizeAxes = Axes.Both,
-                Masking = true,
-                CornerRadius = corner_radius,
-                BorderColour = new Color4(221, 255, 255, 255),
-                Children = new Drawable[]
-                {
-                    Content,
-                    hoverLayer = new HoverLayer()
-                }
+                Content,
+                hoverLayer = new HoverLayer()
             };
         }
 
@@ -66,21 +61,21 @@ namespace osu.Game.Screens.Select.Carousel
                 case CarouselItemState.NotSelected:
                     hoverLayer.InsetForBorder = false;
 
-                    BorderContainer.BorderThickness = 0;
-                    BorderContainer.EdgeEffect = new EdgeEffectParameters
+                    BorderThickness = 0;
+                    EdgeEffect = new EdgeEffectParameters
                     {
                         Type = EdgeEffectType.Shadow,
                         Offset = new Vector2(1),
                         Radius = 10,
-                        Colour = Color4.Black.Opacity(100),
+                        Colour = Color4.Black.Opacity(0.5f),
                     };
                     break;
 
                 case CarouselItemState.Selected:
                     hoverLayer.InsetForBorder = true;
 
-                    BorderContainer.BorderThickness = border_thickness;
-                    BorderContainer.EdgeEffect = new EdgeEffectParameters
+                    BorderThickness = border_thickness;
+                    EdgeEffect = new EdgeEffectParameters
                     {
                         Type = EdgeEffectType.Glow,
                         Colour = new Color4(130, 204, 255, 150),
diff --git a/osu.Game/Screens/Select/Carousel/DrawableCarouselItem.cs b/osu.Game/Screens/Select/Carousel/DrawableCarouselItem.cs
index 4a23faa650..5e7ca0825a 100644
--- a/osu.Game/Screens/Select/Carousel/DrawableCarouselItem.cs
+++ b/osu.Game/Screens/Select/Carousel/DrawableCarouselItem.cs
@@ -85,8 +85,6 @@ namespace osu.Game.Screens.Select.Carousel
             };
         }
 
-        public void SetMultiplicativeAlpha(float alpha) => Header.BorderContainer.Alpha = alpha;
-
         protected override void LoadComplete()
         {
             base.LoadComplete();

From 6bc6675fa1bff93de775e10b6cf6781af9bdb3f1 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 31 Jan 2022 14:46:16 +0900
Subject: [PATCH 2663/5547] Adjust fade in times slightly

---
 .../Screens/Select/Carousel/DrawableCarouselBeatmapSet.cs   | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmapSet.cs b/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmapSet.cs
index 4f19e011b2..63c004f4bc 100644
--- a/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmapSet.cs
+++ b/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmapSet.cs
@@ -122,10 +122,8 @@ namespace osu.Game.Screens.Select.Carousel
                 },
             };
 
-            background.DelayedLoadComplete += fadeContentIn;
-            mainFlow.DelayedLoadComplete += fadeContentIn;
-
-            static void fadeContentIn(Drawable d) => d.FadeInFromZero(750, Easing.OutQuint);
+            background.DelayedLoadComplete += d => d.FadeInFromZero(750, Easing.OutQuint);
+            mainFlow.DelayedLoadComplete += d => d.FadeInFromZero(500, Easing.OutQuint);
         }
 
         protected override void Deselected()

From 57f793aff0e6f562198b732dea85f9bd8c154dee Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 31 Jan 2022 15:12:08 +0900
Subject: [PATCH 2664/5547] Rename dictionary and make `private` for added
 safety

---
 osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs   | 2 +-
 osu.Game/Tests/Visual/Spectator/TestSpectatorClient.cs | 7 +++++--
 2 files changed, 6 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs
index d1a25b07ec..917b3c89a8 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs
@@ -215,7 +215,7 @@ namespace osu.Game.Tests.Visual.Gameplay
             });
 
             // We can't access API because we're an "online" test.
-            AddAssert("last received frame has time = 1000", () => spectatorClient.LastReceivedFrame.First().Value.Time == 1000);
+            AddAssert("last received frame has time = 1000", () => spectatorClient.LastReceivedUserFrames.First().Value.Time == 1000);
         }
 
         private OsuFramedReplayInputHandler replayHandler =>
diff --git a/osu.Game/Tests/Visual/Spectator/TestSpectatorClient.cs b/osu.Game/Tests/Visual/Spectator/TestSpectatorClient.cs
index 3f3d0f5b01..1a1d493249 100644
--- a/osu.Game/Tests/Visual/Spectator/TestSpectatorClient.cs
+++ b/osu.Game/Tests/Visual/Spectator/TestSpectatorClient.cs
@@ -28,7 +28,10 @@ namespace osu.Game.Tests.Visual.Spectator
 
         public override IBindable<bool> IsConnected { get; } = new Bindable<bool>(true);
 
-        public readonly Dictionary<int, ReplayFrame> LastReceivedFrame = new Dictionary<int, ReplayFrame>();
+        public IReadOnlyDictionary<int, ReplayFrame> LastReceivedUserFrames => lastReceivedUserFrames;
+
+        private readonly Dictionary<int, ReplayFrame> lastReceivedUserFrames = new Dictionary<int, ReplayFrame>();
+
         private readonly Dictionary<int, int> userBeatmapDictionary = new Dictionary<int, int>();
         private readonly Dictionary<int, int> userNextFrameDictionary = new Dictionary<int, int>();
 
@@ -40,7 +43,7 @@ namespace osu.Game.Tests.Visual.Spectator
             OnNewFrames += (i, bundle) =>
             {
                 if (PlayingUsers.Contains(i))
-                    LastReceivedFrame[i] = bundle.Frames[^1];
+                    lastReceivedUserFrames[i] = bundle.Frames[^1];
             };
         }
 

From 9001c3a396a7f876bc52d772e1567d62161770f1 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 31 Jan 2022 15:17:06 +0900
Subject: [PATCH 2665/5547] Fix test failures if `DialogOverlay` is not loaded
 in time

As seen at https://github.com/ppy/osu/runs/4999391205?check_suite_focus=true, where `DialogOverlay` hasn't loaded in single file yet.
---
 osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs b/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
index 3be7cf7c5c..ed484e03f6 100644
--- a/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
@@ -128,7 +128,9 @@ namespace osu.Game.Tests.Visual.Navigation
 
             AddStep("choose clear all scores", () => InputManager.Key(Key.Number4));
 
+            AddUntilStep("wait for dialog", () => Game.Dependencies.Get<DialogOverlay>().CurrentDialog != null);
             AddStep("confirm deletion", () => InputManager.Key(Key.Number1));
+            AddUntilStep("wait for dialog dismissed", () => Game.Dependencies.Get<DialogOverlay>().CurrentDialog == null);
 
             AddAssert("ensure score is pending deletion", () => Game.Realm.Run(r => r.Find<ScoreInfo>(score.ID)?.DeletePending == true));
 
@@ -170,7 +172,9 @@ namespace osu.Game.Tests.Visual.Navigation
                 InputManager.Click(MouseButton.Left);
             });
 
+            AddUntilStep("wait for dialog", () => Game.Dependencies.Get<DialogOverlay>().CurrentDialog != null);
             AddStep("confirm deletion", () => InputManager.Key(Key.Number1));
+            AddUntilStep("wait for dialog dismissed", () => Game.Dependencies.Get<DialogOverlay>().CurrentDialog == null);
 
             AddAssert("ensure score is pending deletion", () => Game.Realm.Run(r => r.Find<ScoreInfo>(score.ID)?.DeletePending == true));
 

From 25cbe5a0dee2ef50bdf32bdc8a2b09bc9c98446d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 31 Jan 2022 15:23:31 +0900
Subject: [PATCH 2666/5547] Remove acronym shortening of
 `GameplayClockContainer`

---
 .../TestSceneMasterGameplayClockContainer.cs  | 38 +++++++++----------
 1 file changed, 19 insertions(+), 19 deletions(-)

diff --git a/osu.Game.Tests/Gameplay/TestSceneMasterGameplayClockContainer.cs b/osu.Game.Tests/Gameplay/TestSceneMasterGameplayClockContainer.cs
index 172531605a..77b402ad3c 100644
--- a/osu.Game.Tests/Gameplay/TestSceneMasterGameplayClockContainer.cs
+++ b/osu.Game.Tests/Gameplay/TestSceneMasterGameplayClockContainer.cs
@@ -29,44 +29,44 @@ namespace osu.Game.Tests.Gameplay
         [Test]
         public void TestStartThenElapsedTime()
         {
-            GameplayClockContainer gcc = null;
+            GameplayClockContainer gameplayClockContainer = null;
 
             AddStep("create container", () =>
             {
                 var working = CreateWorkingBeatmap(new OsuRuleset().RulesetInfo);
                 working.LoadTrack();
 
-                Add(gcc = new MasterGameplayClockContainer(working, 0));
+                Add(gameplayClockContainer = new MasterGameplayClockContainer(working, 0));
             });
 
-            AddStep("start clock", () => gcc.Start());
-            AddUntilStep("elapsed greater than zero", () => gcc.GameplayClock.ElapsedFrameTime > 0);
+            AddStep("start clock", () => gameplayClockContainer.Start());
+            AddUntilStep("elapsed greater than zero", () => gameplayClockContainer.GameplayClock.ElapsedFrameTime > 0);
         }
 
         [Test]
         public void TestElapseThenReset()
         {
-            GameplayClockContainer gcc = null;
+            GameplayClockContainer gameplayClockContainer = null;
 
             AddStep("create container", () =>
             {
                 var working = CreateWorkingBeatmap(new OsuRuleset().RulesetInfo);
                 working.LoadTrack();
 
-                Add(gcc = new MasterGameplayClockContainer(working, 0));
+                Add(gameplayClockContainer = new MasterGameplayClockContainer(working, 0));
             });
 
-            AddStep("start clock", () => gcc.Start());
-            AddUntilStep("current time greater 2000", () => gcc.GameplayClock.CurrentTime > 2000);
+            AddStep("start clock", () => gameplayClockContainer.Start());
+            AddUntilStep("current time greater 2000", () => gameplayClockContainer.GameplayClock.CurrentTime > 2000);
 
             double timeAtReset = 0;
             AddStep("reset clock", () =>
             {
-                timeAtReset = gcc.GameplayClock.CurrentTime;
-                gcc.Reset();
+                timeAtReset = gameplayClockContainer.GameplayClock.CurrentTime;
+                gameplayClockContainer.Reset();
             });
 
-            AddAssert("current time < time at reset", () => gcc.GameplayClock.CurrentTime < timeAtReset);
+            AddAssert("current time < time at reset", () => gameplayClockContainer.GameplayClock.CurrentTime < timeAtReset);
         }
 
         [Test]
@@ -76,29 +76,29 @@ namespace osu.Game.Tests.Gameplay
             [Values(false, true)] bool whileStopped)
         {
             ClockBackedTestWorkingBeatmap working = null;
-            GameplayClockContainer gcc = null;
+            GameplayClockContainer gameplayClockContainer = null;
 
             AddStep("create container", () =>
             {
                 working = new ClockBackedTestWorkingBeatmap(new OsuRuleset().RulesetInfo, new FramedClock(new ManualClock()), Audio);
                 working.LoadTrack();
 
-                Add(gcc = new MasterGameplayClockContainer(working, 0));
+                Add(gameplayClockContainer = new MasterGameplayClockContainer(working, 0));
 
                 if (whileStopped)
-                    gcc.Stop();
+                    gameplayClockContainer.Stop();
 
-                gcc.Reset();
+                gameplayClockContainer.Reset();
             });
 
             AddStep($"set clock rate to {clockRate}", () => working.Track.AddAdjustment(AdjustableProperty.Frequency, new BindableDouble(clockRate)));
             AddStep($"set audio offset to {userOffset}", () => localConfig.SetValue(OsuSetting.AudioOffset, userOffset));
 
-            AddStep("seek to 2500", () => gcc.Seek(2500));
-            AddAssert("gameplay clock time = 2500", () => Precision.AlmostEquals(gcc.CurrentTime, 2500, 10f));
+            AddStep("seek to 2500", () => gameplayClockContainer.Seek(2500));
+            AddAssert("gameplay clock time = 2500", () => Precision.AlmostEquals(gameplayClockContainer.CurrentTime, 2500, 10f));
 
-            AddStep("seek to 10000", () => gcc.Seek(10000));
-            AddAssert("gameplay clock time = 10000", () => Precision.AlmostEquals(gcc.CurrentTime, 10000, 10f));
+            AddStep("seek to 10000", () => gameplayClockContainer.Seek(10000));
+            AddAssert("gameplay clock time = 10000", () => Precision.AlmostEquals(gameplayClockContainer.CurrentTime, 10000, 10f));
         }
 
         protected override void Dispose(bool isDisposing)

From cc7fb0e559b096566b2874607f2ff5f57ca8e0e3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 31 Jan 2022 16:36:56 +0900
Subject: [PATCH 2667/5547] Add mouse click support and increase area to full
 column height

---
 osu.Game.Rulesets.Mania/UI/Column.cs | 72 +++++++++++++++-------------
 1 file changed, 40 insertions(+), 32 deletions(-)

diff --git a/osu.Game.Rulesets.Mania/UI/Column.cs b/osu.Game.Rulesets.Mania/UI/Column.cs
index cd5f3d2170..9bcd9ad853 100644
--- a/osu.Game.Rulesets.Mania/UI/Column.cs
+++ b/osu.Game.Rulesets.Mania/UI/Column.cs
@@ -28,7 +28,6 @@ namespace osu.Game.Rulesets.Mania.UI
     {
         public const float COLUMN_WIDTH = 80;
         public const float SPECIAL_COLUMN_WIDTH = 70;
-        public const float TOUCH_AREA_HEIGHT = 100;
 
         /// <summary>
         /// The index of this column as part of the whole playfield.
@@ -45,37 +44,6 @@ namespace osu.Game.Rulesets.Mania.UI
 
         private readonly GameplaySampleTriggerSource sampleTriggerSource;
 
-        public class ColumnTouchInputArea : Drawable
-        {
-            public ColumnTouchInputArea()
-            {
-                RelativeSizeAxes = Axes.X;
-                Anchor = Anchor.BottomCentre;
-                Origin = Anchor.BottomCentre;
-                Height = TOUCH_AREA_HEIGHT;
-            }
-
-            private Column column => (Column)Parent;
-
-            protected override void LoadComplete()
-            {
-                keyBindingContainer = (ManiaInputManager.RulesetKeyBindingContainer)((ManiaInputManager)GetContainingInputManager()).KeyBindingContainer;
-            }
-
-            private ManiaInputManager.RulesetKeyBindingContainer keyBindingContainer { get; set; }
-
-            protected override bool OnTouchDown(TouchDownEvent e)
-            {
-                keyBindingContainer.TriggerPressed(column.Action.Value);
-                return false;
-            }
-
-            protected override void OnTouchUp(TouchUpEvent e)
-            {
-                keyBindingContainer.TriggerReleased(column.Action.Value);
-            }
-        }
-
         public Column(int index)
         {
             Index = index;
@@ -172,5 +140,45 @@ 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 class ColumnTouchInputArea : Drawable
+        {
+            public ColumnTouchInputArea()
+            {
+                RelativeSizeAxes = Axes.Both;
+            }
+
+            private Column column => (Column)Parent;
+
+            protected override void LoadComplete()
+            {
+                keyBindingContainer = (ManiaInputManager.RulesetKeyBindingContainer)((ManiaInputManager)GetContainingInputManager()).KeyBindingContainer;
+            }
+
+            private ManiaInputManager.RulesetKeyBindingContainer keyBindingContainer { get; set; }
+
+            protected override bool OnMouseDown(MouseDownEvent e)
+            {
+                keyBindingContainer.TriggerPressed(column.Action.Value);
+                return base.OnMouseDown(e);
+            }
+
+            protected override void OnMouseUp(MouseUpEvent e)
+            {
+                keyBindingContainer.TriggerReleased(column.Action.Value);
+                base.OnMouseUp(e);
+            }
+
+            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 9005bce0fa574ec9be7661bbeb5029e1ad8797fc Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 31 Jan 2022 16:37:47 +0900
Subject: [PATCH 2668/5547] Add "counter" keyword for key overlay setting

---
 osu.Game/Overlays/Settings/Sections/Gameplay/HUDSettings.cs | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/Settings/Sections/Gameplay/HUDSettings.cs b/osu.Game/Overlays/Settings/Sections/Gameplay/HUDSettings.cs
index e1b452e322..ba9779d650 100644
--- a/osu.Game/Overlays/Settings/Sections/Gameplay/HUDSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Gameplay/HUDSettings.cs
@@ -37,7 +37,8 @@ namespace osu.Game.Overlays.Settings.Sections.Gameplay
                 new SettingsCheckbox
                 {
                     LabelText = GameplaySettingsStrings.AlwaysShowKeyOverlay,
-                    Current = config.GetBindable<bool>(OsuSetting.KeyOverlay)
+                    Current = config.GetBindable<bool>(OsuSetting.KeyOverlay),
+                    Keywords = new[] { "counter" },
                 },
             };
         }

From 0e764538e0ea81293ef99994b25e3ab7ceed609e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 31 Jan 2022 16:47:20 +0900
Subject: [PATCH 2669/5547] Retrieve `KeyBindingContainer` via DI rather than
 traversal lookup

---
 osu.Game.Rulesets.Mania/ManiaInputManager.cs |  2 ++
 osu.Game.Rulesets.Mania/UI/Column.cs         | 17 ++++++++++-------
 osu.Game/Rulesets/UI/RulesetInputManager.cs  |  4 ++--
 3 files changed, 14 insertions(+), 9 deletions(-)

diff --git a/osu.Game.Rulesets.Mania/ManiaInputManager.cs b/osu.Game.Rulesets.Mania/ManiaInputManager.cs
index 186fc4b15d..14ca27a11a 100644
--- a/osu.Game.Rulesets.Mania/ManiaInputManager.cs
+++ b/osu.Game.Rulesets.Mania/ManiaInputManager.cs
@@ -2,11 +2,13 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System.ComponentModel;
+using osu.Framework.Allocation;
 using osu.Framework.Input.Bindings;
 using osu.Game.Rulesets.UI;
 
 namespace osu.Game.Rulesets.Mania
 {
+    [Cached] // Used for touch input, see ColumnTouchInputArea.
     public class ManiaInputManager : RulesetInputManager<ManiaAction>
     {
         public ManiaInputManager(RulesetInfo ruleset, int variant)
diff --git a/osu.Game.Rulesets.Mania/UI/Column.cs b/osu.Game.Rulesets.Mania/UI/Column.cs
index 9bcd9ad853..a6c64e9b2d 100644
--- a/osu.Game.Rulesets.Mania/UI/Column.cs
+++ b/osu.Game.Rulesets.Mania/UI/Column.cs
@@ -143,6 +143,11 @@ namespace osu.Game.Rulesets.Mania.UI
 
         public class ColumnTouchInputArea : Drawable
         {
+            [Resolved(canBeNull: true)]
+            private ManiaInputManager maniaInputManager { get; set; }
+
+            private KeyBindingContainer<ManiaAction> keyBindingContainer;
+
             public ColumnTouchInputArea()
             {
                 RelativeSizeAxes = Axes.Both;
@@ -152,32 +157,30 @@ namespace osu.Game.Rulesets.Mania.UI
 
             protected override void LoadComplete()
             {
-                keyBindingContainer = (ManiaInputManager.RulesetKeyBindingContainer)((ManiaInputManager)GetContainingInputManager()).KeyBindingContainer;
+                keyBindingContainer = maniaInputManager?.KeyBindingContainer;
             }
 
-            private ManiaInputManager.RulesetKeyBindingContainer keyBindingContainer { get; set; }
-
             protected override bool OnMouseDown(MouseDownEvent e)
             {
-                keyBindingContainer.TriggerPressed(column.Action.Value);
+                keyBindingContainer?.TriggerPressed(column.Action.Value);
                 return base.OnMouseDown(e);
             }
 
             protected override void OnMouseUp(MouseUpEvent e)
             {
-                keyBindingContainer.TriggerReleased(column.Action.Value);
+                keyBindingContainer?.TriggerReleased(column.Action.Value);
                 base.OnMouseUp(e);
             }
 
             protected override bool OnTouchDown(TouchDownEvent e)
             {
-                keyBindingContainer.TriggerPressed(column.Action.Value);
+                keyBindingContainer?.TriggerPressed(column.Action.Value);
                 return true;
             }
 
             protected override void OnTouchUp(TouchUpEvent e)
             {
-                keyBindingContainer.TriggerReleased(column.Action.Value);
+                keyBindingContainer?.TriggerReleased(column.Action.Value);
             }
         }
     }
diff --git a/osu.Game/Rulesets/UI/RulesetInputManager.cs b/osu.Game/Rulesets/UI/RulesetInputManager.cs
index 160c0a2606..84e42818be 100644
--- a/osu.Game/Rulesets/UI/RulesetInputManager.cs
+++ b/osu.Game/Rulesets/UI/RulesetInputManager.cs
@@ -24,6 +24,8 @@ namespace osu.Game.Rulesets.UI
     public abstract class RulesetInputManager<T> : PassThroughInputManager, ICanAttachKeyCounter, IHasReplayHandler, IHasRecordingHandler
         where T : struct
     {
+        public readonly KeyBindingContainer<T> KeyBindingContainer;
+
         private ReplayRecorder recorder;
 
         public ReplayRecorder Recorder
@@ -43,8 +45,6 @@ namespace osu.Game.Rulesets.UI
 
         protected override InputState CreateInitialState() => new RulesetInputManagerInputState<T>(base.CreateInitialState());
 
-        public readonly KeyBindingContainer<T> KeyBindingContainer;
-
         protected override Container<Drawable> Content => content;
 
         private readonly Container content;

From a49a9ed0a05d778b5af4c6328071bb0f8926d7b5 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Mon, 31 Jan 2022 17:19:04 +0900
Subject: [PATCH 2670/5547] Fix incorrect invoke

---
 osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/PlayerArea.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/PlayerArea.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/PlayerArea.cs
index f5a6777a62..4979bd906b 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/PlayerArea.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/PlayerArea.cs
@@ -101,7 +101,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Spectate
             stack.Push(new MultiSpectatorPlayerLoader(Score, () =>
             {
                 var player = new MultiSpectatorPlayer(Score, GameplayClock);
-                player.OnGameplayStarted += OnGameplayStarted;
+                player.OnGameplayStarted += () => OnGameplayStarted?.Invoke();
                 return player;
             }));
 

From 4727aeda012f6c5f00f500d0eaf4c05ba8bbc58c Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Mon, 31 Jan 2022 18:32:17 +0900
Subject: [PATCH 2671/5547] Give last bundled replay frame the frame header

---
 .../Visual/Gameplay/TestSceneSpectator.cs        | 16 ++++++++++++++++
 osu.Game/Online/Spectator/SpectatorClient.cs     |  3 +++
 osu.Game/Rulesets/Replays/ReplayFrame.cs         | 13 +++++++++++++
 osu.Game/Screens/Play/SpectatorPlayer.cs         |  1 +
 4 files changed, 33 insertions(+)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs
index 917b3c89a8..a7b9d45f7a 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs
@@ -218,6 +218,22 @@ namespace osu.Game.Tests.Visual.Gameplay
             AddAssert("last received frame has time = 1000", () => spectatorClient.LastReceivedUserFrames.First().Value.Time == 1000);
         }
 
+        [Test]
+        public void TestFinalFrameInBundleHasHeader()
+        {
+            FrameDataBundle lastBundle = null;
+
+            AddStep("bind to client", () => spectatorClient.OnNewFrames += (_, bundle) => lastBundle = bundle);
+
+            start(-1234);
+            sendFrames();
+            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);
+        }
+
         private OsuFramedReplayInputHandler replayHandler =>
             (OsuFramedReplayInputHandler)Stack.ChildrenOfType<OsuInputManager>().First().ReplayInputHandler;
 
diff --git a/osu.Game/Online/Spectator/SpectatorClient.cs b/osu.Game/Online/Spectator/SpectatorClient.cs
index fddb94fad7..67aa75727d 100644
--- a/osu.Game/Online/Spectator/SpectatorClient.cs
+++ b/osu.Game/Online/Spectator/SpectatorClient.cs
@@ -129,6 +129,9 @@ namespace osu.Game.Online.Spectator
 
         Task ISpectatorClient.UserSentFrames(int userId, FrameDataBundle data)
         {
+            if (data.Frames.Count > 0)
+                data.Frames[^1].Header = data.Header;
+
             Schedule(() => OnNewFrames?.Invoke(userId, data));
 
             return Task.CompletedTask;
diff --git a/osu.Game/Rulesets/Replays/ReplayFrame.cs b/osu.Game/Rulesets/Replays/ReplayFrame.cs
index 7de53211a2..2b67b60d8f 100644
--- a/osu.Game/Rulesets/Replays/ReplayFrame.cs
+++ b/osu.Game/Rulesets/Replays/ReplayFrame.cs
@@ -1,16 +1,29 @@
 // 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 enable
+
 using MessagePack;
+using osu.Game.Online.Spectator;
 
 namespace osu.Game.Rulesets.Replays
 {
     [MessagePackObject]
     public class ReplayFrame
     {
+        /// <summary>
+        /// The time at which this <see cref="ReplayFrame"/> takes place.
+        /// </summary>
         [Key(0)]
         public double Time;
 
+        /// <summary>
+        /// A <see cref="FrameHeader"/> containing the state of a play after this <see cref="ReplayFrame"/> takes place.
+        /// May be omitted where exact per-frame accuracy is not required.
+        /// </summary>
+        [IgnoreMember]
+        public FrameHeader? Header;
+
         public ReplayFrame()
         {
         }
diff --git a/osu.Game/Screens/Play/SpectatorPlayer.cs b/osu.Game/Screens/Play/SpectatorPlayer.cs
index d42643c416..c415041081 100644
--- a/osu.Game/Screens/Play/SpectatorPlayer.cs
+++ b/osu.Game/Screens/Play/SpectatorPlayer.cs
@@ -72,6 +72,7 @@ namespace osu.Game.Screens.Play
 
                 var convertedFrame = (ReplayFrame)convertibleFrame;
                 convertedFrame.Time = frame.Time;
+                convertedFrame.Header = frame.Header;
 
                 score.Replay.Frames.Add(convertedFrame);
             }

From 0458d408bb36b15c00c47634926dea59b116205c Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Mon, 31 Jan 2022 18:37:51 +0900
Subject: [PATCH 2672/5547] Add replay statistics frames to
 FramedReplayInputHandler

---
 .../EmptyFreeformFramedReplayInputHandler.cs  |  2 +-
 .../PippidonFramedReplayInputHandler.cs       |  2 +-
 .../EmptyScrollingFramedReplayInputHandler.cs |  2 +-
 .../PippidonFramedReplayInputHandler.cs       |  2 +-
 .../Replays/CatchFramedReplayInputHandler.cs  |  2 +-
 .../Replays/ManiaFramedReplayInputHandler.cs  |  2 +-
 .../Replays/OsuFramedReplayInputHandler.cs    |  2 +-
 .../Replays/TaikoFramedReplayInputHandler.cs  |  2 +-
 .../Gameplay/TestSceneReplayRecorder.cs       |  2 +-
 .../Gameplay/TestSceneSpectatorPlayback.cs    |  2 +-
 osu.Game/Input/Handlers/ReplayInputHandler.cs | 34 +++++++++++++++++++
 .../Replays/FramedReplayInputHandler.cs       | 15 ++++++++
 12 files changed, 59 insertions(+), 10 deletions(-)

diff --git a/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform/Replays/EmptyFreeformFramedReplayInputHandler.cs b/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform/Replays/EmptyFreeformFramedReplayInputHandler.cs
index cc4483de31..a9bc8dc10e 100644
--- a/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform/Replays/EmptyFreeformFramedReplayInputHandler.cs
+++ b/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform/Replays/EmptyFreeformFramedReplayInputHandler.cs
@@ -19,7 +19,7 @@ namespace osu.Game.Rulesets.EmptyFreeform.Replays
 
         protected override bool IsImportant(EmptyFreeformReplayFrame frame) => frame.Actions.Any();
 
-        public override void CollectPendingInputs(List<IInput> inputs)
+        protected override void CollectReplayInputs(List<IInput> inputs)
         {
             var position = Interpolation.ValueAt(CurrentTime, StartFrame.Position, EndFrame.Position, StartFrame.Time, EndFrame.Time);
 
diff --git a/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon/Replays/PippidonFramedReplayInputHandler.cs b/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon/Replays/PippidonFramedReplayInputHandler.cs
index e005346e1e..dbfaf8a01d 100644
--- a/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon/Replays/PippidonFramedReplayInputHandler.cs
+++ b/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon/Replays/PippidonFramedReplayInputHandler.cs
@@ -18,7 +18,7 @@ namespace osu.Game.Rulesets.Pippidon.Replays
 
         protected override bool IsImportant(PippidonReplayFrame frame) => true;
 
-        public override void CollectPendingInputs(List<IInput> inputs)
+        protected override void CollectReplayInputs(List<IInput> inputs)
         {
             var position = Interpolation.ValueAt(CurrentTime, StartFrame.Position, EndFrame.Position, StartFrame.Time, EndFrame.Time);
 
diff --git a/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling/Replays/EmptyScrollingFramedReplayInputHandler.cs b/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling/Replays/EmptyScrollingFramedReplayInputHandler.cs
index 4b998cfca3..1d33ab8a54 100644
--- a/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling/Replays/EmptyScrollingFramedReplayInputHandler.cs
+++ b/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling/Replays/EmptyScrollingFramedReplayInputHandler.cs
@@ -18,7 +18,7 @@ namespace osu.Game.Rulesets.EmptyScrolling.Replays
 
         protected override bool IsImportant(EmptyScrollingReplayFrame frame) => frame.Actions.Any();
 
-        public override void CollectPendingInputs(List<IInput> inputs)
+        protected override void CollectReplayInputs(List<IInput> inputs)
         {
             inputs.Add(new ReplayState<EmptyScrollingAction>
             {
diff --git a/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon/Replays/PippidonFramedReplayInputHandler.cs b/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon/Replays/PippidonFramedReplayInputHandler.cs
index 7652357b4d..702f6fdb04 100644
--- a/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon/Replays/PippidonFramedReplayInputHandler.cs
+++ b/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon/Replays/PippidonFramedReplayInputHandler.cs
@@ -18,7 +18,7 @@ namespace osu.Game.Rulesets.Pippidon.Replays
 
         protected override bool IsImportant(PippidonReplayFrame frame) => frame.Actions.Any();
 
-        public override void CollectPendingInputs(List<IInput> inputs)
+        protected override void CollectReplayInputs(List<IInput> inputs)
         {
             inputs.Add(new ReplayState<PippidonAction>
             {
diff --git a/osu.Game.Rulesets.Catch/Replays/CatchFramedReplayInputHandler.cs b/osu.Game.Rulesets.Catch/Replays/CatchFramedReplayInputHandler.cs
index bd742ce6a6..b6af88a771 100644
--- a/osu.Game.Rulesets.Catch/Replays/CatchFramedReplayInputHandler.cs
+++ b/osu.Game.Rulesets.Catch/Replays/CatchFramedReplayInputHandler.cs
@@ -19,7 +19,7 @@ namespace osu.Game.Rulesets.Catch.Replays
 
         protected override bool IsImportant(CatchReplayFrame frame) => frame.Actions.Any();
 
-        public override void CollectPendingInputs(List<IInput> inputs)
+        protected override void CollectReplayInputs(List<IInput> inputs)
         {
             float position = Interpolation.ValueAt(CurrentTime, StartFrame.Position, EndFrame.Position, StartFrame.Time, EndFrame.Time);
 
diff --git a/osu.Game.Rulesets.Mania/Replays/ManiaFramedReplayInputHandler.cs b/osu.Game.Rulesets.Mania/Replays/ManiaFramedReplayInputHandler.cs
index aa0c148caf..aa164f95da 100644
--- a/osu.Game.Rulesets.Mania/Replays/ManiaFramedReplayInputHandler.cs
+++ b/osu.Game.Rulesets.Mania/Replays/ManiaFramedReplayInputHandler.cs
@@ -18,7 +18,7 @@ namespace osu.Game.Rulesets.Mania.Replays
 
         protected override bool IsImportant(ManiaReplayFrame frame) => frame.Actions.Any();
 
-        public override void CollectPendingInputs(List<IInput> inputs)
+        protected override void CollectReplayInputs(List<IInput> inputs)
         {
             inputs.Add(new ReplayState<ManiaAction> { PressedActions = CurrentFrame?.Actions ?? new List<ManiaAction>() });
         }
diff --git a/osu.Game.Rulesets.Osu/Replays/OsuFramedReplayInputHandler.cs b/osu.Game.Rulesets.Osu/Replays/OsuFramedReplayInputHandler.cs
index 7d696dfb79..ea36ecc399 100644
--- a/osu.Game.Rulesets.Osu/Replays/OsuFramedReplayInputHandler.cs
+++ b/osu.Game.Rulesets.Osu/Replays/OsuFramedReplayInputHandler.cs
@@ -19,7 +19,7 @@ namespace osu.Game.Rulesets.Osu.Replays
 
         protected override bool IsImportant(OsuReplayFrame frame) => frame.Actions.Any();
 
-        public override void CollectPendingInputs(List<IInput> inputs)
+        protected override void CollectReplayInputs(List<IInput> inputs)
         {
             var position = Interpolation.ValueAt(CurrentTime, StartFrame.Position, EndFrame.Position, StartFrame.Time, EndFrame.Time);
 
diff --git a/osu.Game.Rulesets.Taiko/Replays/TaikoFramedReplayInputHandler.cs b/osu.Game.Rulesets.Taiko/Replays/TaikoFramedReplayInputHandler.cs
index 138e8f9785..2f9b6c7f60 100644
--- a/osu.Game.Rulesets.Taiko/Replays/TaikoFramedReplayInputHandler.cs
+++ b/osu.Game.Rulesets.Taiko/Replays/TaikoFramedReplayInputHandler.cs
@@ -18,7 +18,7 @@ namespace osu.Game.Rulesets.Taiko.Replays
 
         protected override bool IsImportant(TaikoReplayFrame frame) => frame.Actions.Any();
 
-        public override void CollectPendingInputs(List<IInput> inputs)
+        protected override void CollectReplayInputs(List<IInput> inputs)
         {
             inputs.Add(new ReplayState<TaikoAction> { PressedActions = CurrentFrame?.Actions ?? new List<TaikoAction>() });
         }
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneReplayRecorder.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneReplayRecorder.cs
index 4eab1a21da..8df32c500e 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneReplayRecorder.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneReplayRecorder.cs
@@ -210,7 +210,7 @@ namespace osu.Game.Tests.Visual.Gameplay
             {
             }
 
-            public override void CollectPendingInputs(List<IInput> inputs)
+            protected override void CollectReplayInputs(List<IInput> inputs)
             {
                 inputs.Add(new MousePositionAbsoluteInput { Position = GamefieldToScreenSpace(CurrentFrame?.Position ?? Vector2.Zero) });
                 inputs.Add(new ReplayState<TestAction> { PressedActions = CurrentFrame?.Actions ?? new List<TestAction>() });
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorPlayback.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorPlayback.cs
index 90abdf2ba3..4af254866a 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorPlayback.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorPlayback.cs
@@ -259,7 +259,7 @@ namespace osu.Game.Tests.Visual.Gameplay
             {
             }
 
-            public override void CollectPendingInputs(List<IInput> inputs)
+            protected override void CollectReplayInputs(List<IInput> inputs)
             {
                 inputs.Add(new MousePositionAbsoluteInput { Position = GamefieldToScreenSpace(CurrentFrame?.Position ?? Vector2.Zero) });
                 inputs.Add(new ReplayState<TestAction> { PressedActions = CurrentFrame?.Actions ?? new List<TestAction>() });
diff --git a/osu.Game/Input/Handlers/ReplayInputHandler.cs b/osu.Game/Input/Handlers/ReplayInputHandler.cs
index e4aec4edac..205a1ea1ac 100644
--- a/osu.Game/Input/Handlers/ReplayInputHandler.cs
+++ b/osu.Game/Input/Handlers/ReplayInputHandler.cs
@@ -9,6 +9,7 @@ using osu.Framework.Input.StateChanges;
 using osu.Framework.Input.StateChanges.Events;
 using osu.Framework.Input.States;
 using osu.Framework.Platform;
+using osu.Game.Rulesets.Replays;
 using osu.Game.Rulesets.UI;
 using osuTK;
 
@@ -79,5 +80,38 @@ namespace osu.Game.Input.Handlers
                 PressedActions = pressedActions;
             }
         }
+
+        /// <summary>
+        /// An <see cref="IInput"/> that is triggered when a frame containing replay statistics arrives.
+        /// </summary>
+        public class ReplayStatisticsFrameInput : IInput
+        {
+            /// <summary>
+            /// The frame containing the statistics.
+            /// </summary>
+            public ReplayFrame Frame;
+
+            public void Apply(InputState state, IInputStateChangeHandler handler)
+            {
+                handler.HandleInputStateChange(new ReplayStatisticsFrameEvent(state, this, Frame));
+            }
+        }
+
+        /// <summary>
+        /// An <see cref="InputStateChangeEvent"/> that is triggered when a frame containing replay statistics arrives.
+        /// </summary>
+        public class ReplayStatisticsFrameEvent : InputStateChangeEvent
+        {
+            /// <summary>
+            /// The frame containing the statistics.
+            /// </summary>
+            public readonly ReplayFrame Frame;
+
+            public ReplayStatisticsFrameEvent(InputState state, IInput input, ReplayFrame frame)
+                : base(state, input)
+            {
+                Frame = frame;
+            }
+        }
     }
 }
diff --git a/osu.Game/Rulesets/Replays/FramedReplayInputHandler.cs b/osu.Game/Rulesets/Replays/FramedReplayInputHandler.cs
index d3ee10dd23..f889d15485 100644
--- a/osu.Game/Rulesets/Replays/FramedReplayInputHandler.cs
+++ b/osu.Game/Rulesets/Replays/FramedReplayInputHandler.cs
@@ -6,6 +6,7 @@
 using System;
 using System.Collections.Generic;
 using System.Linq;
+using osu.Framework.Input.StateChanges;
 using osu.Game.Input.Handlers;
 using osu.Game.Replays;
 
@@ -174,5 +175,19 @@ namespace osu.Game.Rulesets.Replays
 
             return Frames[index].Time;
         }
+
+        public sealed override void CollectPendingInputs(List<IInput> inputs)
+        {
+            base.CollectPendingInputs(inputs);
+
+            CollectReplayInputs(inputs);
+
+            if (CurrentFrame?.Header != null)
+                inputs.Add(new ReplayStatisticsFrameInput { Frame = CurrentFrame });
+        }
+
+        protected virtual void CollectReplayInputs(List<IInput> inputs)
+        {
+        }
     }
 }

From 39e1d65976ba2d35e0c7729b21ca75fdf1745864 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Mon, 31 Jan 2022 18:43:10 +0900
Subject: [PATCH 2673/5547] Make ScoreProcessor write all judgement types

---
 osu.Game/Rulesets/Scoring/HitResult.cs      |  2 +-
 osu.Game/Rulesets/Scoring/ScoreProcessor.cs | 10 +++++-----
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Rulesets/Scoring/HitResult.cs b/osu.Game/Rulesets/Scoring/HitResult.cs
index 5599ed96a3..a254f9b760 100644
--- a/osu.Game/Rulesets/Scoring/HitResult.cs
+++ b/osu.Game/Rulesets/Scoring/HitResult.cs
@@ -176,7 +176,7 @@ namespace osu.Game.Rulesets.Scoring
         /// <summary>
         /// An array of all scorable <see cref="HitResult"/>s.
         /// </summary>
-        public static readonly HitResult[] SCORABLE_TYPES = ((HitResult[])Enum.GetValues(typeof(HitResult))).Where(r => r.IsScorable()).ToArray();
+        public static readonly HitResult[] ALL_TYPES = ((HitResult[])Enum.GetValues(typeof(HitResult))).ToArray();
 
         /// <summary>
         /// Whether a <see cref="HitResult"/> is valid within a given <see cref="HitResult"/> range.
diff --git a/osu.Game/Rulesets/Scoring/ScoreProcessor.cs b/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
index fc24972b8e..fc5e982521 100644
--- a/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
+++ b/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
@@ -125,6 +125,8 @@ namespace osu.Game.Rulesets.Scoring
             if (result.FailedAtJudgement)
                 return;
 
+            scoreResultCounts[result.Type] = scoreResultCounts.GetValueOrDefault(result.Type) + 1;
+
             if (!result.Type.IsScorable())
                 return;
 
@@ -151,8 +153,6 @@ namespace osu.Game.Rulesets.Scoring
                 rollingMaxBaseScore += result.Judgement.MaxNumericResult;
             }
 
-            scoreResultCounts[result.Type] = scoreResultCounts.GetValueOrDefault(result.Type) + 1;
-
             hitEvents.Add(CreateHitEvent(result));
             lastHitObject = result.HitObject;
 
@@ -175,6 +175,8 @@ namespace osu.Game.Rulesets.Scoring
             if (result.FailedAtJudgement)
                 return;
 
+            scoreResultCounts[result.Type] = scoreResultCounts.GetValueOrDefault(result.Type) - 1;
+
             if (!result.Type.IsScorable())
                 return;
 
@@ -186,8 +188,6 @@ namespace osu.Game.Rulesets.Scoring
                 rollingMaxBaseScore -= result.Judgement.MaxNumericResult;
             }
 
-            scoreResultCounts[result.Type] = scoreResultCounts.GetValueOrDefault(result.Type) - 1;
-
             Debug.Assert(hitEvents.Count > 0);
             lastHitObject = hitEvents[^1].LastHitObject;
             hitEvents.RemoveAt(hitEvents.Count - 1);
@@ -346,7 +346,7 @@ namespace osu.Game.Rulesets.Scoring
             score.Accuracy = Accuracy.Value;
             score.Rank = Rank.Value;
 
-            foreach (var result in HitResultExtensions.SCORABLE_TYPES)
+            foreach (var result in HitResultExtensions.ALL_TYPES)
                 score.Statistics[result] = GetStatistic(result);
 
             score.HitEvents = hitEvents;

From 4fb565e15f1be7d6fd740090f24cd2d98552aabb Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Mon, 31 Jan 2022 18:54:23 +0900
Subject: [PATCH 2674/5547] Reset ScoreProcessor from statistics replay frames

---
 .../Gameplay/TestSceneScoreProcessor.cs       | 37 +++++++++
 .../Rulesets/Scoring/JudgementProcessor.cs    | 12 +++
 osu.Game/Rulesets/Scoring/ScoreProcessor.cs   | 77 +++++++++++++++++--
 osu.Game/Rulesets/UI/RulesetInputManager.cs   | 32 +++++---
 osu.Game/Screens/Play/Player.cs               |  1 +
 5 files changed, 144 insertions(+), 15 deletions(-)

diff --git a/osu.Game.Tests/Gameplay/TestSceneScoreProcessor.cs b/osu.Game.Tests/Gameplay/TestSceneScoreProcessor.cs
index 432e3df95e..bcaa70d062 100644
--- a/osu.Game.Tests/Gameplay/TestSceneScoreProcessor.cs
+++ b/osu.Game.Tests/Gameplay/TestSceneScoreProcessor.cs
@@ -1,11 +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;
+using System.Collections.Generic;
 using NUnit.Framework;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
+using osu.Game.Online.Spectator;
 using osu.Game.Rulesets.Judgements;
 using osu.Game.Rulesets.Objects;
+using osu.Game.Rulesets.Osu;
+using osu.Game.Rulesets.Osu.Objects;
+using osu.Game.Rulesets.Osu.Replays;
 using osu.Game.Rulesets.Scoring;
 using osu.Game.Tests.Visual;
 
@@ -42,6 +48,37 @@ namespace osu.Game.Tests.Gameplay
             Assert.That(scoreProcessor.TotalScore.Value, Is.EqualTo(Judgement.LARGE_BONUS_SCORE));
         }
 
+        [Test]
+        public void TestResetFromReplayFrame()
+        {
+            var beatmap = new Beatmap<HitObject> { HitObjects = { new HitCircle() } };
+
+            var scoreProcessor = new ScoreProcessor();
+            scoreProcessor.ApplyBeatmap(beatmap);
+
+            scoreProcessor.ApplyResult(new JudgementResult(beatmap.HitObjects[0], new TestJudgement(HitResult.Great)) { Type = HitResult.Great });
+            Assert.That(scoreProcessor.TotalScore.Value, Is.EqualTo(1_000_000));
+            Assert.That(scoreProcessor.JudgedHits, Is.EqualTo(1));
+
+            // Reset with a miss instead.
+            scoreProcessor.ResetFromReplayFrame(new OsuRuleset(), new OsuReplayFrame
+            {
+                Header = new FrameHeader(0, 0, 0, new Dictionary<HitResult, int> { { HitResult.Miss, 1 } }, DateTimeOffset.Now)
+            });
+
+            Assert.That(scoreProcessor.TotalScore.Value, Is.Zero);
+            Assert.That(scoreProcessor.JudgedHits, Is.EqualTo(1));
+
+            // Reset with no judged hit.
+            scoreProcessor.ResetFromReplayFrame(new OsuRuleset(), new OsuReplayFrame
+            {
+                Header = new FrameHeader(0, 0, 0, new Dictionary<HitResult, int>(), DateTimeOffset.Now)
+            });
+
+            Assert.That(scoreProcessor.TotalScore.Value, Is.Zero);
+            Assert.That(scoreProcessor.JudgedHits, Is.Zero);
+        }
+
         private class TestJudgement : Judgement
         {
             public override HitResult MaxResult { get; }
diff --git a/osu.Game/Rulesets/Scoring/JudgementProcessor.cs b/osu.Game/Rulesets/Scoring/JudgementProcessor.cs
index c3c4a2c949..f38155240e 100644
--- a/osu.Game/Rulesets/Scoring/JudgementProcessor.cs
+++ b/osu.Game/Rulesets/Scoring/JudgementProcessor.cs
@@ -8,6 +8,7 @@ using osu.Framework.Graphics;
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Judgements;
 using osu.Game.Rulesets.Objects;
+using osu.Game.Rulesets.Replays;
 
 namespace osu.Game.Rulesets.Scoring
 {
@@ -107,6 +108,17 @@ namespace osu.Game.Rulesets.Scoring
             JudgedHits = 0;
         }
 
+        public virtual void ResetFromReplayFrame(Ruleset ruleset, ReplayFrame frame)
+        {
+            if (frame.Header == null)
+                return;
+
+            JudgedHits = 0;
+
+            foreach ((_, int count) in frame.Header.Statistics)
+                JudgedHits += count;
+        }
+
         /// <summary>
         /// Creates the <see cref="JudgementResult"/> that represents the scoring result for a <see cref="HitObject"/>.
         /// </summary>
diff --git a/osu.Game/Rulesets/Scoring/ScoreProcessor.cs b/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
index fc5e982521..37ee3771df 100644
--- a/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
+++ b/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
@@ -7,9 +7,11 @@ using System.Diagnostics;
 using System.Linq;
 using osu.Framework.Bindables;
 using osu.Framework.Utils;
+using osu.Game.Extensions;
 using osu.Game.Rulesets.Judgements;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Objects;
+using osu.Game.Rulesets.Replays;
 using osu.Game.Scoring;
 
 namespace osu.Game.Rulesets.Scoring
@@ -18,6 +20,11 @@ namespace osu.Game.Rulesets.Scoring
     {
         private const double max_score = 1000000;
 
+        /// <summary>
+        /// Invoked when this <see cref="ScoreProcessor"/> was reset from a replay frame.
+        /// </summary>
+        public event Action OnResetFromReplayFrame;
+
         /// <summary>
         /// The current total score.
         /// </summary>
@@ -329,12 +336,6 @@ namespace osu.Game.Rulesets.Scoring
             HighestCombo.Value = 0;
         }
 
-        protected override void Dispose(bool isDisposing)
-        {
-            base.Dispose(isDisposing);
-            hitEvents.Clear();
-        }
-
         /// <summary>
         /// Retrieve a score populated with data for the current play this processor is responsible for.
         /// </summary>
@@ -351,6 +352,70 @@ namespace osu.Game.Rulesets.Scoring
 
             score.HitEvents = hitEvents;
         }
+
+        /// <summary>
+        /// Maximum <see cref="HitResult"/> for a normal hit (i.e. not tick/bonus) for this ruleset. Only populated via <see cref="ResetFromReplayFrame"/>.
+        /// </summary>
+        private HitResult? maxNormalResult;
+
+        public override void ResetFromReplayFrame(Ruleset ruleset, ReplayFrame frame)
+        {
+            base.ResetFromReplayFrame(ruleset, frame);
+
+            if (frame.Header == null)
+                return;
+
+            baseScore = 0;
+            rollingMaxBaseScore = 0;
+            HighestCombo.Value = frame.Header.MaxCombo;
+
+            foreach ((HitResult result, int count) in frame.Header.Statistics)
+            {
+                // Bonus scores are counted separately directly from the statistics dictionary later on.
+                if (!result.IsScorable() || result.IsBonus())
+                    continue;
+
+                // The maximum result of this judgement if it wasn't a miss.
+                // E.g. For a GOOD judgement, the max result is either GREAT/PERFECT depending on which one the ruleset uses (osu!: GREAT, osu!mania: PERFECT).
+                HitResult maxResult;
+
+                switch (result)
+                {
+                    case HitResult.LargeTickHit:
+                    case HitResult.LargeTickMiss:
+                        maxResult = HitResult.LargeTickHit;
+                        break;
+
+                    case HitResult.SmallTickHit:
+                    case HitResult.SmallTickMiss:
+                        maxResult = HitResult.SmallTickHit;
+                        break;
+
+                    default:
+                        maxResult = maxNormalResult ??= ruleset.GetHitResults().OrderByDescending(kvp => Judgement.ToNumericResult(kvp.result)).First().result;
+                        break;
+                }
+
+                for (int i = 0; i < count; i++)
+                {
+                    baseScore += Judgement.ToNumericResult(result);
+                    rollingMaxBaseScore += Judgement.ToNumericResult(maxResult);
+                }
+            }
+
+            scoreResultCounts.Clear();
+            scoreResultCounts.AddRange(frame.Header.Statistics);
+
+            updateScore();
+
+            OnResetFromReplayFrame?.Invoke();
+        }
+
+        protected override void Dispose(bool isDisposing)
+        {
+            base.Dispose(isDisposing);
+            hitEvents.Clear();
+        }
     }
 
     public enum ScoringMode
diff --git a/osu.Game/Rulesets/UI/RulesetInputManager.cs b/osu.Game/Rulesets/UI/RulesetInputManager.cs
index 370c99ffaf..050ec82071 100644
--- a/osu.Game/Rulesets/UI/RulesetInputManager.cs
+++ b/osu.Game/Rulesets/UI/RulesetInputManager.cs
@@ -16,6 +16,7 @@ using osu.Game.Configuration;
 using osu.Game.Input;
 using osu.Game.Input.Bindings;
 using osu.Game.Input.Handlers;
+using osu.Game.Rulesets.Scoring;
 using osu.Game.Screens.Play;
 using static osu.Game.Input.Handlers.ReplayInputHandler;
 
@@ -24,6 +25,11 @@ namespace osu.Game.Rulesets.UI
     public abstract class RulesetInputManager<T> : PassThroughInputManager, ICanAttachKeyCounter, IHasReplayHandler, IHasRecordingHandler
         where T : struct
     {
+        private readonly Ruleset ruleset;
+
+        [Resolved(CanBeNull = true)]
+        private ScoreProcessor scoreProcessor { get; set; }
+
         private ReplayRecorder recorder;
 
         public ReplayRecorder Recorder
@@ -51,6 +57,8 @@ namespace osu.Game.Rulesets.UI
 
         protected RulesetInputManager(RulesetInfo ruleset, int variant, SimultaneousBindingMode unique)
         {
+            this.ruleset = ruleset.CreateInstance();
+
             InternalChild = KeyBindingContainer =
                 CreateKeyBindingContainer(ruleset, variant, unique)
                     .WithChild(content = new Container { RelativeSizeAxes = Axes.Both });
@@ -66,17 +74,23 @@ namespace osu.Game.Rulesets.UI
 
         public override void HandleInputStateChange(InputStateChangeEvent inputStateChange)
         {
-            if (inputStateChange is ReplayStateChangeEvent<T> replayStateChanged)
+            switch (inputStateChange)
             {
-                foreach (var action in replayStateChanged.ReleasedActions)
-                    KeyBindingContainer.TriggerReleased(action);
+                case ReplayStateChangeEvent<T> stateChangeEvent:
+                    foreach (var action in stateChangeEvent.ReleasedActions)
+                        KeyBindingContainer.TriggerReleased(action);
 
-                foreach (var action in replayStateChanged.PressedActions)
-                    KeyBindingContainer.TriggerPressed(action);
-            }
-            else
-            {
-                base.HandleInputStateChange(inputStateChange);
+                    foreach (var action in stateChangeEvent.PressedActions)
+                        KeyBindingContainer.TriggerPressed(action);
+                    break;
+
+                case ReplayStatisticsFrameEvent statisticsStateChangeEvent:
+                    scoreProcessor?.ResetFromReplayFrame(ruleset, statisticsStateChangeEvent.Frame);
+                    break;
+
+                default:
+                    base.HandleInputStateChange(inputStateChange);
+                    break;
             }
         }
 
diff --git a/osu.Game/Screens/Play/Player.cs b/osu.Game/Screens/Play/Player.cs
index cfca2d0a3d..e0fcca4eb7 100644
--- a/osu.Game/Screens/Play/Player.cs
+++ b/osu.Game/Screens/Play/Player.cs
@@ -165,6 +165,7 @@ namespace osu.Game.Screens.Play
             PrepareReplay();
 
             ScoreProcessor.NewJudgement += result => ScoreProcessor.PopulateScore(Score.ScoreInfo);
+            ScoreProcessor.OnResetFromReplayFrame += () => ScoreProcessor.PopulateScore(Score.ScoreInfo);
 
             gameActive.BindValueChanged(_ => updatePauseOnFocusLostState(), true);
         }

From e5601772a99aba7374077f986f158a1a839f2264 Mon Sep 17 00:00:00 2001
From: Spooghetti420 <kkovachev1947@gmail.com>
Date: Mon, 31 Jan 2022 15:00:36 +0000
Subject: [PATCH 2675/5547] Make incompatible with

---
 osu.Game.Rulesets.Mania/Mods/ManiaModHoldOff.cs | 3 +++
 osu.Game.Rulesets.Mania/Mods/ManiaModInvert.cs  | 2 ++
 2 files changed, 5 insertions(+)

diff --git a/osu.Game.Rulesets.Mania/Mods/ManiaModHoldOff.cs b/osu.Game.Rulesets.Mania/Mods/ManiaModHoldOff.cs
index 42dc7fdc1f..1abca970d5 100644
--- a/osu.Game.Rulesets.Mania/Mods/ManiaModHoldOff.cs
+++ b/osu.Game.Rulesets.Mania/Mods/ManiaModHoldOff.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 osu.Game.Beatmaps;
 using osu.Game.Rulesets.Mania.Objects;
@@ -25,6 +26,8 @@ namespace osu.Game.Rulesets.Mania.Mods
 
         public override ModType Type => ModType.Conversion;
 
+        public override Type[] IncompatibleMods => new[] { typeof(ManiaModInvert) };
+
         public const double END_NOTE_ALLOW_THRESHOLD = 0.5;
 
         public void ApplyToBeatmap(IBeatmap beatmap)
diff --git a/osu.Game.Rulesets.Mania/Mods/ManiaModInvert.cs b/osu.Game.Rulesets.Mania/Mods/ManiaModInvert.cs
index 1ea45c295c..4cbdaee323 100644
--- a/osu.Game.Rulesets.Mania/Mods/ManiaModInvert.cs
+++ b/osu.Game.Rulesets.Mania/Mods/ManiaModInvert.cs
@@ -26,6 +26,8 @@ namespace osu.Game.Rulesets.Mania.Mods
 
         public override ModType Type => ModType.Conversion;
 
+        public override Type[] IncompatibleMods => new[] { typeof(ManiaModHoldOff) };
+
         public void ApplyToBeatmap(IBeatmap beatmap)
         {
             var maniaBeatmap = (ManiaBeatmap)beatmap;

From 2f88efd3c3c2f66f0bc8104f737cbc532527251f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 1 Feb 2022 00:53:56 +0900
Subject: [PATCH 2676/5547] Pass column in rather than accessing parent

---
 osu.Game.Rulesets.Mania/UI/Column.cs | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Rulesets.Mania/UI/Column.cs b/osu.Game.Rulesets.Mania/UI/Column.cs
index a6c64e9b2d..dc3b86ac7f 100644
--- a/osu.Game.Rulesets.Mania/UI/Column.cs
+++ b/osu.Game.Rulesets.Mania/UI/Column.cs
@@ -69,7 +69,7 @@ namespace osu.Game.Rulesets.Mania.UI
                 },
                 background,
                 TopLevelContainer = new Container { RelativeSizeAxes = Axes.Both },
-                new ColumnTouchInputArea()
+                new ColumnTouchInputArea(this)
             };
 
             hitPolicy = new OrderedHitPolicy(HitObjectContainer);
@@ -143,17 +143,19 @@ namespace osu.Game.Rulesets.Mania.UI
 
         public class ColumnTouchInputArea : Drawable
         {
+            private readonly Column column;
+
             [Resolved(canBeNull: true)]
             private ManiaInputManager maniaInputManager { get; set; }
 
             private KeyBindingContainer<ManiaAction> keyBindingContainer;
 
-            public ColumnTouchInputArea()
+            public ColumnTouchInputArea(Column column)
             {
                 RelativeSizeAxes = Axes.Both;
-            }
 
-            private Column column => (Column)Parent;
+                this.column = column;
+            }
 
             protected override void LoadComplete()
             {

From 9227211a441eb2df90a2e0504e6bdaa08f94bfe4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 31 Jan 2022 22:56:27 +0100
Subject: [PATCH 2677/5547] Privatise `shouldAlternate`

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

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModAlternate.cs b/osu.Game.Rulesets.Osu/Mods/OsuModAlternate.cs
index db8bd217f6..f68f2b5bee 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModAlternate.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModAlternate.cs
@@ -25,7 +25,6 @@ namespace osu.Game.Rulesets.Osu.Mods
         public override Type[] IncompatibleMods => new[] { typeof(ModAutoplay) };
         public override ModType Type => ModType.DifficultyIncrease;
         public override IconUsage? Icon => FontAwesome.Solid.Keyboard;
-        public bool ShouldAlternate => !isBreakTime.Value && introEnded;
 
         private bool introEnded;
         private double earliestStartTime;
@@ -34,6 +33,8 @@ namespace osu.Game.Rulesets.Osu.Mods
         private OsuAction? lastActionPressed;
         private DrawableRuleset<OsuHitObject> ruleset;
 
+        private bool shouldAlternate => !isBreakTime.Value && introEnded;
+
         public void ApplyToDrawableRuleset(DrawableRuleset<OsuHitObject> drawableRuleset)
         {
             ruleset = drawableRuleset;
@@ -82,7 +83,7 @@ namespace osu.Game.Rulesets.Osu.Mods
             }
 
             public bool OnPressed(KeyBindingPressEvent<OsuAction> e)
-                => mod.ShouldAlternate && mod.onPressed(e.Action);
+                => mod.shouldAlternate && mod.onPressed(e.Action);
 
             public void OnReleased(KeyBindingReleaseEvent<OsuAction> e)
             {

From c50577e25ff3d20c307cbec120b8436558cb6aa3 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 1 Feb 2022 10:48:41 +0900
Subject: [PATCH 2678/5547] Apply suggestion from review
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/Scoring/ScoreProcessor.cs | 7 ++-----
 1 file changed, 2 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Rulesets/Scoring/ScoreProcessor.cs b/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
index 37ee3771df..79861c0ecc 100644
--- a/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
+++ b/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
@@ -396,11 +396,8 @@ namespace osu.Game.Rulesets.Scoring
                         break;
                 }
 
-                for (int i = 0; i < count; i++)
-                {
-                    baseScore += Judgement.ToNumericResult(result);
-                    rollingMaxBaseScore += Judgement.ToNumericResult(maxResult);
-                }
+                baseScore += count * Judgement.ToNumericResult(result);
+                rollingMaxBaseScore += count * Judgement.ToNumericResult(maxResult);
             }
 
             scoreResultCounts.Clear();

From 5a6d57efb77728df1d09dab9837a75e36311f611 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 1 Feb 2022 12:43:35 +0900
Subject: [PATCH 2679/5547] Update fastlane and dependencies

---
 Gemfile.lock       | 147 +++++++++++++++++++++++++++++----------------
 fastlane/README.md |   2 +-
 2 files changed, 95 insertions(+), 54 deletions(-)

diff --git a/Gemfile.lock b/Gemfile.lock
index 8ac863c9a8..86c8baabe6 100644
--- a/Gemfile.lock
+++ b/Gemfile.lock
@@ -1,53 +1,75 @@
 GEM
   remote: https://rubygems.org/
   specs:
-    CFPropertyList (3.0.3)
-    addressable (2.7.0)
+    CFPropertyList (3.0.5)
+      rexml
+    addressable (2.8.0)
       public_suffix (>= 2.0.2, < 5.0)
+    artifactory (3.0.15)
     atomos (0.1.3)
-    aws-eventstream (1.1.0)
-    aws-partitions (1.413.0)
-    aws-sdk-core (3.110.0)
+    aws-eventstream (1.2.0)
+    aws-partitions (1.551.0)
+    aws-sdk-core (3.125.5)
       aws-eventstream (~> 1, >= 1.0.2)
-      aws-partitions (~> 1, >= 1.239.0)
+      aws-partitions (~> 1, >= 1.525.0)
       aws-sigv4 (~> 1.1)
       jmespath (~> 1.0)
-    aws-sdk-kms (1.40.0)
-      aws-sdk-core (~> 3, >= 3.109.0)
+    aws-sdk-kms (1.53.0)
+      aws-sdk-core (~> 3, >= 3.125.0)
       aws-sigv4 (~> 1.1)
-    aws-sdk-s3 (1.87.0)
-      aws-sdk-core (~> 3, >= 3.109.0)
+    aws-sdk-s3 (1.111.3)
+      aws-sdk-core (~> 3, >= 3.125.0)
       aws-sdk-kms (~> 1)
-      aws-sigv4 (~> 1.1)
-    aws-sigv4 (1.2.2)
+      aws-sigv4 (~> 1.4)
+    aws-sigv4 (1.4.0)
       aws-eventstream (~> 1, >= 1.0.2)
     babosa (1.0.4)
-    claide (1.0.3)
+    claide (1.1.0)
     colored (1.2)
     colored2 (3.1.2)
     commander-fastlane (4.4.6)
       highline (~> 1.7.2)
     declarative (0.0.20)
-    declarative-option (0.1.0)
-    digest-crc (0.6.3)
+    digest-crc (0.6.4)
       rake (>= 12.0.0, < 14.0.0)
     domain_name (0.5.20190701)
       unf (>= 0.0.5, < 1.0.0)
     dotenv (2.7.6)
-    emoji_regex (3.2.1)
-    excon (0.78.1)
-    faraday (1.2.0)
-      multipart-post (>= 1.2, < 3)
-      ruby2_keywords
+    emoji_regex (3.2.3)
+    excon (0.90.0)
+    faraday (1.9.3)
+      faraday-em_http (~> 1.0)
+      faraday-em_synchrony (~> 1.0)
+      faraday-excon (~> 1.1)
+      faraday-httpclient (~> 1.0)
+      faraday-multipart (~> 1.0)
+      faraday-net_http (~> 1.0)
+      faraday-net_http_persistent (~> 1.0)
+      faraday-patron (~> 1.0)
+      faraday-rack (~> 1.0)
+      faraday-retry (~> 1.0)
+      ruby2_keywords (>= 0.0.4)
     faraday-cookie_jar (0.0.7)
       faraday (>= 0.8.0)
       http-cookie (~> 1.0.0)
-    faraday_middleware (1.0.0)
+    faraday-em_http (1.0.0)
+    faraday-em_synchrony (1.0.0)
+    faraday-excon (1.1.0)
+    faraday-httpclient (1.0.1)
+    faraday-multipart (1.0.3)
+      multipart-post (>= 1.2, < 3)
+    faraday-net_http (1.0.1)
+    faraday-net_http_persistent (1.2.0)
+    faraday-patron (1.0.0)
+    faraday-rack (1.0.0)
+    faraday-retry (1.0.3)
+    faraday_middleware (1.2.0)
       faraday (~> 1.0)
-    fastimage (2.2.1)
-    fastlane (2.170.0)
+    fastimage (2.2.6)
+    fastlane (2.181.0)
       CFPropertyList (>= 2.3, < 4.0.0)
       addressable (>= 2.3, < 3.0.0)
+      artifactory (~> 3.0)
       aws-sdk-s3 (~> 1.0)
       babosa (>= 1.0.3, < 2.0.0)
       bundler (>= 1.12.0, < 3.0.0)
@@ -68,6 +90,7 @@ GEM
       jwt (>= 2.1.0, < 3)
       mini_magick (>= 4.9.4, < 5.0.0)
       multipart-post (~> 2.0.0)
+      naturally (~> 2.2)
       plist (>= 3.1.0, < 4.0.0)
       rubyzip (>= 2.0.0, < 3.0.0)
       security (= 0.1.3)
@@ -94,65 +117,80 @@ GEM
       representable (~> 3.0)
       retriable (>= 2.0, < 4.0)
       signet (~> 0.12)
-    google-cloud-core (1.5.0)
+    google-apis-core (0.4.2)
+      addressable (~> 2.5, >= 2.5.1)
+      googleauth (>= 0.16.2, < 2.a)
+      httpclient (>= 2.8.1, < 3.a)
+      mini_mime (~> 1.0)
+      representable (~> 3.0)
+      retriable (>= 2.0, < 4.a)
+      rexml
+      webrick
+    google-apis-iamcredentials_v1 (0.10.0)
+      google-apis-core (>= 0.4, < 2.a)
+    google-apis-storage_v1 (0.11.0)
+      google-apis-core (>= 0.4, < 2.a)
+    google-cloud-core (1.6.0)
       google-cloud-env (~> 1.0)
       google-cloud-errors (~> 1.0)
-    google-cloud-env (1.4.0)
+    google-cloud-env (1.5.0)
       faraday (>= 0.17.3, < 2.0)
-    google-cloud-errors (1.0.1)
-    google-cloud-storage (1.29.2)
-      addressable (~> 2.5)
+    google-cloud-errors (1.2.0)
+    google-cloud-storage (1.36.0)
+      addressable (~> 2.8)
       digest-crc (~> 0.4)
-      google-api-client (~> 0.33)
-      google-cloud-core (~> 1.2)
-      googleauth (~> 0.9)
+      google-apis-iamcredentials_v1 (~> 0.1)
+      google-apis-storage_v1 (~> 0.1)
+      google-cloud-core (~> 1.6)
+      googleauth (>= 0.16.2, < 2.a)
       mini_mime (~> 1.0)
-    googleauth (0.14.0)
+    googleauth (0.17.1)
       faraday (>= 0.17.3, < 2.0)
       jwt (>= 1.4, < 3.0)
       memoist (~> 0.16)
       multi_json (~> 1.11)
       os (>= 0.9, < 2.0)
-      signet (~> 0.14)
+      signet (~> 0.15)
     highline (1.7.10)
-    http-cookie (1.0.3)
+    http-cookie (1.0.4)
       domain_name (~> 0.5)
     httpclient (2.8.3)
-    jmespath (1.4.0)
-    json (2.5.1)
-    jwt (2.2.2)
+    jmespath (1.5.0)
+    json (2.6.1)
+    jwt (2.3.0)
     memoist (0.16.2)
     mini_magick (4.11.0)
-    mini_mime (1.0.2)
+    mini_mime (1.1.2)
     mini_portile2 (2.4.0)
     multi_json (1.15.0)
     multipart-post (2.0.0)
     nanaimo (0.3.0)
-    naturally (2.2.0)
+    naturally (2.2.1)
     nokogiri (1.10.10)
       mini_portile2 (~> 2.4.0)
-    os (1.1.1)
-    plist (3.5.0)
+    os (1.1.4)
+    plist (3.6.0)
     public_suffix (4.0.6)
-    rake (13.0.3)
-    representable (3.0.4)
+    rake (13.0.6)
+    representable (3.1.1)
       declarative (< 0.1.0)
-      declarative-option (< 0.2.0)
+      trailblazer-option (>= 0.1.1, < 0.2.0)
       uber (< 0.2.0)
     retriable (3.1.2)
+    rexml (3.2.5)
     rouge (2.0.7)
-    ruby2_keywords (0.0.2)
-    rubyzip (2.3.0)
+    ruby2_keywords (0.0.5)
+    rubyzip (2.3.2)
     security (0.1.3)
-    signet (0.14.0)
-      addressable (~> 2.3)
+    signet (0.16.0)
+      addressable (~> 2.8)
       faraday (>= 0.17.3, < 2.0)
       jwt (>= 1.5, < 3.0)
       multi_json (~> 1.10)
     simctl (1.6.8)
       CFPropertyList
       naturally
-    slack-notifier (2.3.2)
+    slack-notifier (2.4.0)
     souyuz (0.9.1)
       fastlane (>= 1.103.0)
       highline (~> 1.7)
@@ -160,6 +198,7 @@ GEM
     terminal-notifier (2.0.0)
     terminal-table (1.8.0)
       unicode-display_width (~> 1.1, >= 1.1.1)
+    trailblazer-option (0.1.2)
     tty-cursor (0.7.1)
     tty-screen (0.8.1)
     tty-spinner (0.9.3)
@@ -167,18 +206,20 @@ GEM
     uber (0.1.0)
     unf (0.1.4)
       unf_ext
-    unf_ext (0.0.7.7)
-    unicode-display_width (1.7.0)
+    unf_ext (0.0.8)
+    unicode-display_width (1.8.0)
+    webrick (1.7.0)
     word_wrap (1.0.0)
-    xcodeproj (1.19.0)
+    xcodeproj (1.21.0)
       CFPropertyList (>= 2.3.3, < 4.0)
       atomos (~> 0.1.3)
       claide (>= 1.0.2, < 2.0)
       colored2 (~> 3.1)
       nanaimo (~> 0.3.0)
+      rexml (~> 3.2.4)
     xcpretty (0.3.0)
       rouge (~> 2.0.7)
-    xcpretty-travis-formatter (1.0.0)
+    xcpretty-travis-formatter (1.0.1)
       xcpretty (~> 0.2, >= 0.0.7)
 
 PLATFORMS
diff --git a/fastlane/README.md b/fastlane/README.md
index a400ed9516..8273fdaa5d 100644
--- a/fastlane/README.md
+++ b/fastlane/README.md
@@ -12,7 +12,7 @@ Install _fastlane_ using
 ```
 [sudo] gem install fastlane -NV
 ```
-or alternatively using `brew cask install fastlane`
+or alternatively using `brew install fastlane`
 
 # Available Actions
 ## Android

From aa492270dd9738bf9cf8c7dc0c4eb7543e155f8a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 1 Feb 2022 13:30:26 +0900
Subject: [PATCH 2680/5547] Ignore `FodyWeavers.xml` files in subdirectories

These are created when building specific projects rather than the main
solution (typically iOS / android) and of no use to us.
---
 .gitignore | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.gitignore b/.gitignore
index de6a3ac848..5b19270ab9 100644
--- a/.gitignore
+++ b/.gitignore
@@ -339,3 +339,4 @@ inspectcode
 
 # Fody (pulled in by Realm) - schema file
 FodyWeavers.xsd
+**/FodyWeavers.xml

From db973fb34876e1329c215f08dcee2dc7039ae422 Mon Sep 17 00:00:00 2001
From: dekrain <dawidkrainski8@gmail.com>
Date: Tue, 1 Feb 2022 06:28:18 +0100
Subject: [PATCH 2681/5547] Add basic tooltip for leaderboard scores

---
 .../Online/Leaderboards/LeaderboardScore.cs   |   5 +-
 .../Leaderboards/LeaderboardScoreTooltip.cs   | 225 ++++++++++++++++++
 2 files changed, 229 insertions(+), 1 deletion(-)
 create mode 100644 osu.Game/Online/Leaderboards/LeaderboardScoreTooltip.cs

diff --git a/osu.Game/Online/Leaderboards/LeaderboardScore.cs b/osu.Game/Online/Leaderboards/LeaderboardScore.cs
index 906e09b8c1..7779043ccd 100644
--- a/osu.Game/Online/Leaderboards/LeaderboardScore.cs
+++ b/osu.Game/Online/Leaderboards/LeaderboardScore.cs
@@ -32,7 +32,7 @@ using osu.Game.Utils;
 
 namespace osu.Game.Online.Leaderboards
 {
-    public class LeaderboardScore : OsuClickableContainer, IHasContextMenu
+    public class LeaderboardScore : OsuClickableContainer, IHasContextMenu, IHasCustomTooltip<ScoreInfo>
     {
         public const float HEIGHT = 60;
 
@@ -70,6 +70,9 @@ namespace osu.Game.Online.Leaderboards
         [Resolved]
         private Storage storage { get; set; }
 
+        public ITooltip<ScoreInfo> GetCustomTooltip() => new LeaderboardScoreTooltip();
+        public ScoreInfo TooltipContent => Score;
+
         public LeaderboardScore(ScoreInfo score, int? rank, bool isOnlineScope = true)
         {
             Score = score;
diff --git a/osu.Game/Online/Leaderboards/LeaderboardScoreTooltip.cs b/osu.Game/Online/Leaderboards/LeaderboardScoreTooltip.cs
new file mode 100644
index 0000000000..78064c33bc
--- /dev/null
+++ b/osu.Game/Online/Leaderboards/LeaderboardScoreTooltip.cs
@@ -0,0 +1,225 @@
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Shapes;
+using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.Cursor;
+using osu.Game.Scoring;
+using osuTK;
+using osu.Game.Graphics.Sprites;
+using osu.Game.Graphics;
+using osu.Framework.Allocation;
+using osu.Framework.Extensions.Color4Extensions;
+using osu.Game.Rulesets.Scoring;
+using osu.Game.Rulesets.Mods;
+using osu.Game.Rulesets.UI;
+
+namespace osu.Game.Online.Leaderboards
+{
+    public class LeaderboardScoreTooltip : VisibilityContainer, ITooltip<ScoreInfo>
+    {
+        private OsuSpriteText timestampLabel;
+        private FillFlowContainer<HitResultCell> topScoreStatistics;
+        private FillFlowContainer<HitResultCell> bottomScoreStatistics;
+        private FillFlowContainer<ModCell> modStatistics;
+
+        public LeaderboardScoreTooltip()
+        {
+            AutoSizeAxes = Axes.Both;
+            Masking = true;
+            CornerRadius = 5;
+
+            InternalChildren = new Drawable[]
+            {
+                new Box
+                {
+                    RelativeSizeAxes = Axes.Both,
+                    Alpha = 0.7f,
+                    Colour = Colour4.Black,
+                },
+                new GridContainer
+                {
+                    Margin = new MarginPadding(5f),
+                    AutoSizeAxes = Axes.Both,
+                    RowDimensions = new[]
+                    {
+                        new Dimension(GridSizeMode.AutoSize),
+                        new Dimension(GridSizeMode.AutoSize),
+                        new Dimension(GridSizeMode.AutoSize),
+                        new Dimension(GridSizeMode.AutoSize),
+                    },
+                    ColumnDimensions = new[]
+                    {
+                        new Dimension(GridSizeMode.AutoSize),
+                    },
+                    Content = new[]
+                    {
+                        // Info row
+                        new Drawable[]
+                        {
+                            timestampLabel = new OsuSpriteText()
+                            {
+                                Font = OsuFont.GetFont(size: 12, weight: FontWeight.SemiBold),
+                            }
+                        },
+                        // Mods row
+                        new Drawable[]
+                        {
+                            modStatistics = new FillFlowContainer<ModCell>
+                            {
+                                AutoSizeAxes = Axes.Both,
+                                Direction = FillDirection.Horizontal,
+                            }
+                        },
+                        // Actual stats rows
+                        new Drawable[]
+                        {
+                            topScoreStatistics = new FillFlowContainer<HitResultCell>
+                            {
+                                AutoSizeAxes = Axes.Both,
+                                Direction = FillDirection.Horizontal,
+                            }
+                        },
+                        new Drawable[]
+                        {
+                            bottomScoreStatistics = new FillFlowContainer<HitResultCell>
+                            {
+                                AutoSizeAxes = Axes.Both,
+                                Direction = FillDirection.Horizontal,
+                            }
+                        },
+                    }
+                }
+            };
+        }
+
+        private ScoreInfo currentScore;
+
+        public void SetContent(ScoreInfo score)
+        {
+            if (currentScore == score)
+                return;
+            currentScore = score;
+
+            timestampLabel.Text = $"Played on {score.Date.ToLocalTime():d MMMM yyyy HH:mm}";
+
+            modStatistics.Clear();
+            topScoreStatistics.Clear();
+            bottomScoreStatistics.Clear();
+
+            foreach (var mod in score.Mods)
+            {
+                modStatistics.Add(new ModCell(mod));
+            }
+
+            foreach (var result in score.GetStatisticsForDisplay())
+            {
+                (result.Result > HitResult.Perfect
+                    ? bottomScoreStatistics
+                    : topScoreStatistics
+                ).Add(new HitResultCell(result));
+            }
+        }
+
+        protected override void PopIn() => this.FadeIn(20, Easing.OutQuint);
+        protected override void PopOut() => this.FadeOut(80, Easing.OutQuint);
+
+        public void Move(Vector2 pos) => Position = pos;
+
+        private class HitResultCell : CompositeDrawable
+        {
+            readonly private string DisplayName;
+            readonly private HitResult Result;
+            readonly private int Count;
+
+            public HitResultCell(HitResultDisplayStatistic stat)
+            {
+                AutoSizeAxes = Axes.Both;
+                Padding = new MarginPadding{ Horizontal = 5f };
+
+                DisplayName = stat.DisplayName;
+                Result = stat.Result;
+                Count = stat.Count;
+            }
+
+            [BackgroundDependencyLoader]
+            private void load(OsuColour colours)
+            {
+                InternalChild = new FillFlowContainer
+                {
+                    Height = 12,
+                    AutoSizeAxes = Axes.X,
+                    Direction = FillDirection.Horizontal,
+                    Spacing = new Vector2(2f, 0f),
+                    Children = new Drawable[]
+                    {
+                        new CircularContainer
+                        {
+                            AutoSizeAxes = Axes.X,
+                            RelativeSizeAxes = Axes.Y,
+                            Masking = true,
+                            Children = new Drawable[]
+                            {
+                                new Box
+                                {
+                                    RelativeSizeAxes = Axes.Both,
+                                    Colour = Color4Extensions.FromHex("#222")
+                                },
+                                new OsuSpriteText
+                                {
+                                    Padding = new MarginPadding{ Horizontal = 2f },
+                                    Anchor = Anchor.Centre,
+                                    Origin = Anchor.Centre,
+                                    Font = OsuFont.Torus.With(size: 12, weight: FontWeight.SemiBold),
+                                    Text = DisplayName.ToUpperInvariant(),
+                                    Colour = colours.ForHitResult(Result),
+                                }
+                            }
+                        },
+                        new OsuSpriteText
+                        {
+                            RelativeSizeAxes = Axes.Y,
+                            Font = OsuFont.GetFont(size: 12, weight: FontWeight.SemiBold),
+                            Text = Count.ToString(),
+                        },
+                    }
+                };
+            }
+        }
+
+        private class ModCell : CompositeDrawable
+        {
+            readonly private Mod Mod;
+
+            public ModCell(Mod mod)
+            {
+                AutoSizeAxes = Axes.Both;
+                Padding = new MarginPadding{ Horizontal = 5f };
+                Mod = mod;
+            }
+
+            [BackgroundDependencyLoader]
+            private void load()
+            {
+                InternalChild = new FillFlowContainer
+                {
+                    Height = 15,
+                    AutoSizeAxes = Axes.X,
+                    Direction = FillDirection.Horizontal,
+                    Spacing = new Vector2(2f, 0f),
+                    Children = new Drawable[]
+                    {
+                        new ModIcon(Mod, showTooltip: false).With(icon =>
+                        {
+                            icon.Scale = new Vector2(15f / icon.Height);
+                        }),
+                        new OsuSpriteText
+                        {
+                            RelativeSizeAxes = Axes.Y,
+                            Font = OsuFont.GetFont(size: 12, weight: FontWeight.SemiBold),
+                            Text = Mod.SettingDescription,
+                        }
+                    }
+                };
+            }
+        }
+    }
+}

From 502e6af008757204e53f04eb5cbfe7f586558989 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 26 Jan 2022 00:21:54 +0900
Subject: [PATCH 2682/5547] Remove PlayingUsers list from SpectatorClient

---
 .../Gameplay/TestSceneSpectatorPlayback.cs    | 38 -------------------
 ...TestSceneMultiplayerGameplayLeaderboard.cs |  2 +-
 osu.Game/Online/Spectator/SpectatorClient.cs  | 10 -----
 .../Dashboard/CurrentlyPlayingDisplay.cs      | 30 +++++++--------
 .../Visual/Spectator/TestSpectatorClient.cs   |  7 ++--
 5 files changed, 19 insertions(+), 68 deletions(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorPlayback.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorPlayback.cs
index 90abdf2ba3..75369661a0 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorPlayback.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorPlayback.cs
@@ -3,12 +3,9 @@
 
 using System;
 using System.Collections.Generic;
-using System.Collections.Specialized;
-using System.Diagnostics;
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
-using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
@@ -20,7 +17,6 @@ using osu.Framework.Testing;
 using osu.Framework.Timing;
 using osu.Game.Beatmaps;
 using osu.Game.Graphics.Sprites;
-using osu.Game.Online.API;
 using osu.Game.Online.Spectator;
 using osu.Game.Replays;
 using osu.Game.Replays.Legacy;
@@ -47,8 +43,6 @@ namespace osu.Game.Tests.Visual.Gameplay
 
         private Replay replay;
 
-        private readonly IBindableList<int> users = new BindableList<int>();
-
         private TestReplayRecorder recorder;
 
         private ManualClock manualClock;
@@ -57,9 +51,6 @@ namespace osu.Game.Tests.Visual.Gameplay
 
         private TestFramedReplayInputHandler replayHandler;
 
-        [Resolved]
-        private IAPIProvider api { get; set; }
-
         [Resolved]
         private SpectatorClient spectatorClient { get; set; }
 
@@ -78,35 +69,6 @@ namespace osu.Game.Tests.Visual.Gameplay
 
                 spectatorClient.OnNewFrames += onNewFrames;
 
-                users.BindTo(spectatorClient.PlayingUsers);
-                users.BindCollectionChanged((obj, args) =>
-                {
-                    switch (args.Action)
-                    {
-                        case NotifyCollectionChangedAction.Add:
-                            Debug.Assert(args.NewItems != null);
-
-                            foreach (int user in args.NewItems)
-                            {
-                                if (user == api.LocalUser.Value.Id)
-                                    spectatorClient.WatchUser(user);
-                            }
-
-                            break;
-
-                        case NotifyCollectionChangedAction.Remove:
-                            Debug.Assert(args.OldItems != null);
-
-                            foreach (int user in args.OldItems)
-                            {
-                                if (user == api.LocalUser.Value.Id)
-                                    spectatorClient.StopWatchingUser(user);
-                            }
-
-                            break;
-                    }
-                }, true);
-
                 Children = new Drawable[]
                 {
                     new GridContainer
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs
index 9b8e67b07a..8b71dfac21 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs
@@ -115,7 +115,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             public void RandomlyUpdateState()
             {
-                foreach (int userId in PlayingUsers)
+                foreach ((int userId, _) in PlayingUserStates)
                 {
                     if (RNG.NextBool())
                         continue;
diff --git a/osu.Game/Online/Spectator/SpectatorClient.cs b/osu.Game/Online/Spectator/SpectatorClient.cs
index fddb94fad7..c3e70edcd3 100644
--- a/osu.Game/Online/Spectator/SpectatorClient.cs
+++ b/osu.Game/Online/Spectator/SpectatorClient.cs
@@ -37,9 +37,6 @@ namespace osu.Game.Online.Spectator
 
         private readonly List<int> watchingUsers = new List<int>();
 
-        public IBindableList<int> PlayingUsers => playingUsers;
-        private readonly BindableList<int> playingUsers = new BindableList<int>();
-
         public IBindableDictionary<int, SpectatorState> PlayingUserStates => playingUserStates;
         private readonly BindableDictionary<int, SpectatorState> playingUserStates = new BindableDictionary<int, SpectatorState>();
 
@@ -88,10 +85,7 @@ namespace osu.Game.Online.Spectator
                         BeginPlayingInternal(currentState);
                 }
                 else
-                {
-                    playingUsers.Clear();
                     playingUserStates.Clear();
-                }
             }), true);
         }
 
@@ -99,9 +93,6 @@ namespace osu.Game.Online.Spectator
         {
             Schedule(() =>
             {
-                if (!playingUsers.Contains(userId))
-                    playingUsers.Add(userId);
-
                 // UserBeganPlaying() is called by the server regardless of whether the local user is watching the remote user, and is called a further time when the remote user is watched.
                 // This may be a temporary thing (see: https://github.com/ppy/osu-server-spectator/blob/2273778e02cfdb4a9c6a934f2a46a8459cb5d29c/osu.Server.Spectator/Hubs/SpectatorHub.cs#L28-L29).
                 // We don't want the user states to update unless the player is being watched, otherwise calling BindUserBeganPlaying() can lead to double invocations.
@@ -118,7 +109,6 @@ namespace osu.Game.Online.Spectator
         {
             Schedule(() =>
             {
-                playingUsers.Remove(userId);
                 playingUserStates.Remove(userId);
 
                 OnUserFinishedPlaying?.Invoke(userId, state);
diff --git a/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs b/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs
index fde20575fc..afbfb9f7ef 100644
--- a/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs
+++ b/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.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.Collections.Specialized;
+using System.Diagnostics;
 using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
@@ -22,7 +22,7 @@ namespace osu.Game.Overlays.Dashboard
 {
     internal class CurrentlyPlayingDisplay : CompositeDrawable
     {
-        private readonly IBindableList<int> playingUsers = new BindableList<int>();
+        private readonly IBindableDictionary<int, SpectatorState> playingUserStates = new BindableDictionary<int, SpectatorState>();
 
         private FillFlowContainer<PlayingUserPanel> userFlow;
 
@@ -51,18 +51,20 @@ namespace osu.Game.Overlays.Dashboard
         {
             base.LoadComplete();
 
-            playingUsers.BindTo(spectatorClient.PlayingUsers);
-            playingUsers.BindCollectionChanged(onUsersChanged, true);
+            playingUserStates.BindTo(spectatorClient.PlayingUserStates);
+            playingUserStates.BindCollectionChanged(onUsersChanged, true);
         }
 
-        private void onUsersChanged(object sender, NotifyCollectionChangedEventArgs e) => Schedule(() =>
+        private void onUsersChanged(object sender, NotifyDictionaryChangedEventArgs<int, SpectatorState> e) => Schedule(() =>
         {
             switch (e.Action)
             {
-                case NotifyCollectionChangedAction.Add:
-                    foreach (int id in e.NewItems.OfType<int>().ToArray())
+                case NotifyDictionaryChangedAction.Add:
+                    Debug.Assert(e.NewItems != null);
+
+                    foreach ((int userId, _) in e.NewItems)
                     {
-                        users.GetUserAsync(id).ContinueWith(task =>
+                        users.GetUserAsync(userId).ContinueWith(task =>
                         {
                             var user = task.GetResultSafely();
 
@@ -71,7 +73,7 @@ namespace osu.Game.Overlays.Dashboard
                             Schedule(() =>
                             {
                                 // user may no longer be playing.
-                                if (!playingUsers.Contains(user.Id))
+                                if (!playingUserStates.ContainsKey(user.Id))
                                     return;
 
                                 userFlow.Add(createUserPanel(user));
@@ -81,13 +83,11 @@ namespace osu.Game.Overlays.Dashboard
 
                     break;
 
-                case NotifyCollectionChangedAction.Remove:
-                    foreach (int u in e.OldItems.OfType<int>())
-                        userFlow.FirstOrDefault(card => card.User.Id == u)?.Expire();
-                    break;
+                case NotifyDictionaryChangedAction.Remove:
+                    Debug.Assert(e.OldItems != null);
 
-                case NotifyCollectionChangedAction.Reset:
-                    userFlow.Clear();
+                    foreach ((int userId, _) in e.OldItems)
+                        userFlow.FirstOrDefault(card => card.User.Id == userId)?.Expire();
                     break;
             }
         });
diff --git a/osu.Game/Tests/Visual/Spectator/TestSpectatorClient.cs b/osu.Game/Tests/Visual/Spectator/TestSpectatorClient.cs
index 1a1d493249..7848a825f4 100644
--- a/osu.Game/Tests/Visual/Spectator/TestSpectatorClient.cs
+++ b/osu.Game/Tests/Visual/Spectator/TestSpectatorClient.cs
@@ -6,7 +6,6 @@
 using System;
 using System.Collections.Generic;
 using System.Diagnostics;
-using System.Linq;
 using System.Threading.Tasks;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
@@ -42,7 +41,7 @@ namespace osu.Game.Tests.Visual.Spectator
         {
             OnNewFrames += (i, bundle) =>
             {
-                if (PlayingUsers.Contains(i))
+                if (PlayingUserStates.ContainsKey(i))
                     lastReceivedUserFrames[i] = bundle.Frames[^1];
             };
         }
@@ -65,7 +64,7 @@ namespace osu.Game.Tests.Visual.Spectator
         /// <param name="userId">The user to end play for.</param>
         public void EndPlay(int userId)
         {
-            if (!PlayingUsers.Contains(userId))
+            if (!PlayingUserStates.ContainsKey(userId))
                 return;
 
             ((ISpectatorClient)this).UserFinishedPlaying(userId, new SpectatorState
@@ -131,7 +130,7 @@ namespace osu.Game.Tests.Visual.Spectator
         protected override Task WatchUserInternal(int userId)
         {
             // When newly watching a user, the server sends the playing state immediately.
-            if (PlayingUsers.Contains(userId))
+            if (PlayingUserStates.ContainsKey(userId))
                 sendPlayingState(userId);
 
             return Task.CompletedTask;

From c2b775c0a39cebce5cf2d2494266484f17223094 Mon Sep 17 00:00:00 2001
From: dekrain <dawidkrainski8@gmail.com>
Date: Tue, 1 Feb 2022 06:45:59 +0100
Subject: [PATCH 2683/5547] Minor alignment adjustments

---
 .../Leaderboards/LeaderboardScoreTooltip.cs   | 24 +++++++++++++------
 1 file changed, 17 insertions(+), 7 deletions(-)

diff --git a/osu.Game/Online/Leaderboards/LeaderboardScoreTooltip.cs b/osu.Game/Online/Leaderboards/LeaderboardScoreTooltip.cs
index 78064c33bc..bea589e47f 100644
--- a/osu.Game/Online/Leaderboards/LeaderboardScoreTooltip.cs
+++ b/osu.Game/Online/Leaderboards/LeaderboardScoreTooltip.cs
@@ -199,7 +199,8 @@ namespace osu.Game.Online.Leaderboards
             [BackgroundDependencyLoader]
             private void load()
             {
-                InternalChild = new FillFlowContainer
+                FillFlowContainer container;
+                InternalChild = container = new FillFlowContainer
                 {
                     Height = 15,
                     AutoSizeAxes = Axes.X,
@@ -209,16 +210,25 @@ namespace osu.Game.Online.Leaderboards
                     {
                         new ModIcon(Mod, showTooltip: false).With(icon =>
                         {
+                            icon.Origin = Anchor.CentreLeft;
+                            icon.Anchor = Anchor.CentreLeft;
                             icon.Scale = new Vector2(15f / icon.Height);
                         }),
-                        new OsuSpriteText
-                        {
-                            RelativeSizeAxes = Axes.Y,
-                            Font = OsuFont.GetFont(size: 12, weight: FontWeight.SemiBold),
-                            Text = Mod.SettingDescription,
-                        }
                     }
                 };
+
+                string description = Mod.SettingDescription;
+                if (!string.IsNullOrEmpty(description))
+                {
+                    container.Add(new OsuSpriteText
+                    {
+                        RelativeSizeAxes = Axes.Y,
+                        Font = OsuFont.GetFont(size: 12, weight: FontWeight.SemiBold),
+                        Text = Mod.SettingDescription,
+                        Origin = Anchor.CentreLeft,
+                        Anchor = Anchor.CentreLeft,
+                    });
+                }
             }
         }
     }

From 781cb9f18d55e21b153967ee389c1a45ca934e0a Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 26 Jan 2022 01:45:11 +0900
Subject: [PATCH 2684/5547] Move HasPassed/HasFailed into GameplayState

---
 .../TestSceneTaikoSuddenDeath.cs              |  2 +-
 .../Visual/Gameplay/TestSceneFailAnimation.cs |  2 +-
 .../Visual/Gameplay/TestSceneFailJudgement.cs |  2 +-
 .../Visual/Gameplay/TestScenePause.cs         | 12 ++++++------
 .../TestScenePlayerScoreSubmission.cs         |  4 ++--
 .../Gameplay/TestSceneStoryboardWithOutro.cs  |  2 +-
 .../Navigation/TestSceneScreenNavigation.cs   |  2 +-
 .../Multiplayer/MultiplayerPlayerLoader.cs    |  2 +-
 osu.Game/Screens/Play/GameplayState.cs        | 10 ++++++++++
 osu.Game/Screens/Play/Player.cs               | 19 ++++++-------------
 10 files changed, 30 insertions(+), 27 deletions(-)

diff --git a/osu.Game.Rulesets.Taiko.Tests/TestSceneTaikoSuddenDeath.cs b/osu.Game.Rulesets.Taiko.Tests/TestSceneTaikoSuddenDeath.cs
index 0be005e1c4..eec88d7bf8 100644
--- a/osu.Game.Rulesets.Taiko.Tests/TestSceneTaikoSuddenDeath.cs
+++ b/osu.Game.Rulesets.Taiko.Tests/TestSceneTaikoSuddenDeath.cs
@@ -45,7 +45,7 @@ namespace osu.Game.Rulesets.Taiko.Tests
                 Player.ScoreProcessor.NewJudgement += b => judged = true;
             });
             AddUntilStep("swell judged", () => judged);
-            AddAssert("failed", () => Player.HasFailed);
+            AddAssert("failed", () => Player.GameplayState.HasFailed);
         }
     }
 }
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneFailAnimation.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneFailAnimation.cs
index 7167d3120a..744227c55e 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneFailAnimation.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneFailAnimation.cs
@@ -29,7 +29,7 @@ namespace osu.Game.Tests.Visual.Gameplay
 
         protected override void AddCheckSteps()
         {
-            AddUntilStep("wait for fail", () => Player.HasFailed);
+            AddUntilStep("wait for fail", () => Player.GameplayState.HasFailed);
             AddUntilStep("wait for fail overlay", () => ((FailPlayer)Player).FailOverlay.State.Value == Visibility.Visible);
 
             // The pause screen and fail animation both ramp frequency.
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneFailJudgement.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneFailJudgement.cs
index fa27e1abdd..6430c29dfa 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneFailJudgement.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneFailJudgement.cs
@@ -21,7 +21,7 @@ namespace osu.Game.Tests.Visual.Gameplay
 
         protected override void AddCheckSteps()
         {
-            AddUntilStep("wait for fail", () => Player.HasFailed);
+            AddUntilStep("wait for fail", () => Player.GameplayState.HasFailed);
             AddUntilStep("wait for multiple judgements", () => ((FailPlayer)Player).ScoreProcessor.JudgedHits > 1);
             AddAssert("total number of results == 1", () =>
             {
diff --git a/osu.Game.Tests/Visual/Gameplay/TestScenePause.cs b/osu.Game.Tests/Visual/Gameplay/TestScenePause.cs
index 04676f656f..ea0255ab76 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestScenePause.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestScenePause.cs
@@ -185,7 +185,7 @@ namespace osu.Game.Tests.Visual.Gameplay
         [Test]
         public void TestPauseAfterFail()
         {
-            AddUntilStep("wait for fail", () => Player.HasFailed);
+            AddUntilStep("wait for fail", () => Player.GameplayState.HasFailed);
             AddUntilStep("fail overlay shown", () => Player.FailOverlayVisible);
 
             confirmClockRunning(false);
@@ -201,7 +201,7 @@ namespace osu.Game.Tests.Visual.Gameplay
         [Test]
         public void TestExitFromFailedGameplayAfterFailAnimation()
         {
-            AddUntilStep("wait for fail", () => Player.HasFailed);
+            AddUntilStep("wait for fail", () => Player.GameplayState.HasFailed);
             AddUntilStep("wait for fail overlay shown", () => Player.FailOverlayVisible);
 
             confirmClockRunning(false);
@@ -213,7 +213,7 @@ namespace osu.Game.Tests.Visual.Gameplay
         [Test]
         public void TestExitFromFailedGameplayDuringFailAnimation()
         {
-            AddUntilStep("wait for fail", () => Player.HasFailed);
+            AddUntilStep("wait for fail", () => Player.GameplayState.HasFailed);
 
             // will finish the fail animation and show the fail/pause screen.
             AddStep("attempt exit via pause key", () => Player.ExitViaPause());
@@ -227,7 +227,7 @@ namespace osu.Game.Tests.Visual.Gameplay
         [Test]
         public void TestQuickRetryFromFailedGameplay()
         {
-            AddUntilStep("wait for fail", () => Player.HasFailed);
+            AddUntilStep("wait for fail", () => Player.GameplayState.HasFailed);
             AddStep("quick retry", () => Player.GameplayClockContainer.ChildrenOfType<HotkeyRetryOverlay>().First().Action?.Invoke());
 
             confirmExited();
@@ -236,7 +236,7 @@ namespace osu.Game.Tests.Visual.Gameplay
         [Test]
         public void TestQuickExitFromFailedGameplay()
         {
-            AddUntilStep("wait for fail", () => Player.HasFailed);
+            AddUntilStep("wait for fail", () => Player.GameplayState.HasFailed);
             AddStep("quick exit", () => Player.GameplayClockContainer.ChildrenOfType<HotkeyExitOverlay>().First().Action?.Invoke());
 
             confirmExited();
@@ -341,7 +341,7 @@ namespace osu.Game.Tests.Visual.Gameplay
         {
             confirmClockRunning(false);
             confirmNotExited();
-            AddAssert("player not failed", () => !Player.HasFailed);
+            AddAssert("player not failed", () => !Player.GameplayState.HasFailed);
             AddAssert("pause overlay shown", () => Player.PauseOverlayVisible);
         }
 
diff --git a/osu.Game.Tests/Visual/Gameplay/TestScenePlayerScoreSubmission.cs b/osu.Game.Tests/Visual/Gameplay/TestScenePlayerScoreSubmission.cs
index a9675a2ee2..58b5df2612 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestScenePlayerScoreSubmission.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestScenePlayerScoreSubmission.cs
@@ -159,7 +159,7 @@ namespace osu.Game.Tests.Visual.Gameplay
 
             AddUntilStep("wait for token request", () => Player.TokenCreationRequested);
 
-            AddUntilStep("wait for fail", () => Player.HasFailed);
+            AddUntilStep("wait for fail", () => Player.GameplayState.HasFailed);
             AddStep("exit", () => Player.Exit());
 
             AddAssert("ensure no submission", () => Player.SubmittedScore == null);
@@ -176,7 +176,7 @@ namespace osu.Game.Tests.Visual.Gameplay
 
             addFakeHit();
 
-            AddUntilStep("wait for fail", () => Player.HasFailed);
+            AddUntilStep("wait for fail", () => Player.GameplayState.HasFailed);
             AddStep("exit", () => Player.Exit());
 
             AddAssert("ensure failing submission", () => Player.SubmittedScore?.ScoreInfo.Passed == false);
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboardWithOutro.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboardWithOutro.cs
index 69798dcb82..b87183cbc7 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboardWithOutro.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboardWithOutro.cs
@@ -96,7 +96,7 @@ namespace osu.Game.Tests.Visual.Gameplay
                 AddStep("set storyboard duration to 0.6s", () => currentStoryboardDuration = 600);
             });
 
-            AddUntilStep("wait for fail", () => Player.HasFailed);
+            AddUntilStep("wait for fail", () => Player.GameplayState.HasFailed);
             AddUntilStep("storyboard ends", () => Player.GameplayClockContainer.GameplayClock.CurrentTime >= currentStoryboardDuration);
             AddUntilStep("wait for fail overlay", () => Player.FailOverlay.State.Value == Visibility.Visible);
         }
diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs b/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
index ed484e03f6..63984a1bed 100644
--- a/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
@@ -209,7 +209,7 @@ namespace osu.Game.Tests.Visual.Navigation
                 return (player = Game.ScreenStack.CurrentScreen as Player) != null;
             });
 
-            AddUntilStep("wait for fail", () => player.HasFailed);
+            AddUntilStep("wait for fail", () => player.GameplayState.HasFailed);
 
             AddUntilStep("wait for track stop", () => !Game.MusicController.IsPlaying);
             AddAssert("Ensure time before preview point", () => Game.MusicController.CurrentTrack.CurrentTime < beatmap().BeatmapInfo.Metadata.PreviewTime);
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayerLoader.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayerLoader.cs
index 470ba59a76..772651727e 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayerLoader.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayerLoader.cs
@@ -9,7 +9,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
 {
     public class MultiplayerPlayerLoader : PlayerLoader
     {
-        public bool GameplayPassed => player?.GameplayPassed == true;
+        public bool GameplayPassed => player?.GameplayState.HasPassed == true;
 
         private Player player;
 
diff --git a/osu.Game/Screens/Play/GameplayState.cs b/osu.Game/Screens/Play/GameplayState.cs
index 83881f739d..60fbfa6644 100644
--- a/osu.Game/Screens/Play/GameplayState.cs
+++ b/osu.Game/Screens/Play/GameplayState.cs
@@ -39,6 +39,16 @@ namespace osu.Game.Screens.Play
         /// </summary>
         public readonly Score Score;
 
+        /// <summary>
+        /// Whether gameplay completed without the user failing.
+        /// </summary>
+        public bool HasPassed { get; set; }
+
+        /// <summary>
+        /// Whether the user failed during gameplay.
+        /// </summary>
+        public bool HasFailed { get; set; }
+
         /// <summary>
         /// A bindable tracking the last judgement result applied to any hit object.
         /// </summary>
diff --git a/osu.Game/Screens/Play/Player.cs b/osu.Game/Screens/Play/Player.cs
index 0312789b12..814aacd2fa 100644
--- a/osu.Game/Screens/Play/Player.cs
+++ b/osu.Game/Screens/Play/Player.cs
@@ -72,15 +72,8 @@ namespace osu.Game.Screens.Play
         /// </summary>
         protected virtual bool PauseOnFocusLost => true;
 
-        /// <summary>
-        /// Whether gameplay has completed without the user having failed.
-        /// </summary>
-        public bool GameplayPassed { get; private set; }
-
         public Action RestartRequested;
 
-        public bool HasFailed { get; private set; }
-
         private Bindable<bool> mouseWheelDisabled;
 
         private readonly Bindable<bool> storyboardReplacesBackground = new Bindable<bool>();
@@ -559,7 +552,7 @@ namespace osu.Game.Screens.Play
             if (showDialogFirst && !pauseOrFailDialogVisible)
             {
                 // if the fail animation is currently in progress, accelerate it (it will show the pause dialog on completion).
-                if (ValidForResume && HasFailed)
+                if (ValidForResume && GameplayState.HasFailed)
                 {
                     failAnimationLayer.FinishTransforms(true);
                     return;
@@ -678,7 +671,7 @@ namespace osu.Game.Screens.Play
                 resultsDisplayDelegate?.Cancel();
                 resultsDisplayDelegate = null;
 
-                GameplayPassed = false;
+                GameplayState.HasPassed = false;
                 ValidForResume = true;
                 skipOutroOverlay.Hide();
                 return;
@@ -688,7 +681,7 @@ namespace osu.Game.Screens.Play
             if (HealthProcessor.HasFailed)
                 return;
 
-            GameplayPassed = true;
+            GameplayState.HasPassed = true;
 
             // Setting this early in the process means that even if something were to go wrong in the order of events following, there
             // is no chance that a user could return to the (already completed) Player instance from a child screen.
@@ -804,7 +797,7 @@ namespace osu.Game.Screens.Play
             if (!CheckModsAllowFailure())
                 return false;
 
-            HasFailed = true;
+            GameplayState.HasFailed = true;
             Score.ScoreInfo.Passed = false;
 
             // There is a chance that we could be in a paused state as the ruleset's internal clock (see FrameStabilityContainer)
@@ -859,13 +852,13 @@ namespace osu.Game.Screens.Play
             // replays cannot be paused and exit immediately
             && !DrawableRuleset.HasReplayLoaded.Value
             // cannot pause if we are already in a fail state
-            && !HasFailed;
+            && !GameplayState.HasFailed;
 
         private bool canResume =>
             // cannot resume from a non-paused state
             GameplayClockContainer.IsPaused.Value
             // cannot resume if we are already in a fail state
-            && !HasFailed
+            && !GameplayState.HasFailed
             // already resuming
             && !IsResuming;
 

From 38e075c522f72371742e4d02a948f7a53a0aac5d Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 26 Jan 2022 02:02:31 +0900
Subject: [PATCH 2685/5547] Add HasQuit gameplay state

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

diff --git a/osu.Game/Screens/Play/GameplayState.cs b/osu.Game/Screens/Play/GameplayState.cs
index 60fbfa6644..64e873b3bb 100644
--- a/osu.Game/Screens/Play/GameplayState.cs
+++ b/osu.Game/Screens/Play/GameplayState.cs
@@ -49,6 +49,11 @@ namespace osu.Game.Screens.Play
         /// </summary>
         public bool HasFailed { get; set; }
 
+        /// <summary>
+        /// Whether the user quit gameplay without either having either passed or failed.
+        /// </summary>
+        public bool HasQuit { get; set; }
+
         /// <summary>
         /// A bindable tracking the last judgement result applied to any hit object.
         /// </summary>
diff --git a/osu.Game/Screens/Play/Player.cs b/osu.Game/Screens/Play/Player.cs
index 814aacd2fa..f6a2310826 100644
--- a/osu.Game/Screens/Play/Player.cs
+++ b/osu.Game/Screens/Play/Player.cs
@@ -983,6 +983,9 @@ namespace osu.Game.Screens.Play
 
         public override bool OnExiting(IScreen next)
         {
+            if (!GameplayState.HasPassed && !GameplayState.HasFailed)
+                GameplayState.HasQuit = true;
+
             screenSuspension?.RemoveAndDisposeImmediately();
             failAnimationLayer?.RemoveFilters();
 

From fd287e06f2bbe0f1115961184f837f0cd30927fe Mon Sep 17 00:00:00 2001
From: dekrain <dawidkrainski8@gmail.com>
Date: Tue, 1 Feb 2022 06:51:00 +0100
Subject: [PATCH 2686/5547] Add missing license header

---
 osu.Game/Online/Leaderboards/LeaderboardScoreTooltip.cs | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/osu.Game/Online/Leaderboards/LeaderboardScoreTooltip.cs b/osu.Game/Online/Leaderboards/LeaderboardScoreTooltip.cs
index bea589e47f..ea02c238f3 100644
--- a/osu.Game/Online/Leaderboards/LeaderboardScoreTooltip.cs
+++ b/osu.Game/Online/Leaderboards/LeaderboardScoreTooltip.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 osu.Framework.Graphics;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Graphics.Containers;

From d7b939277e81d99eb36aeb25f9aa71846b8b90c6 Mon Sep 17 00:00:00 2001
From: dekrain <dawidkrainski8@gmail.com>
Date: Tue, 1 Feb 2022 07:10:00 +0100
Subject: [PATCH 2687/5547] Code quality improvements

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

diff --git a/osu.Game/Online/Leaderboards/LeaderboardScoreTooltip.cs b/osu.Game/Online/Leaderboards/LeaderboardScoreTooltip.cs
index ea02c238f3..0b2de3e2c8 100644
--- a/osu.Game/Online/Leaderboards/LeaderboardScoreTooltip.cs
+++ b/osu.Game/Online/Leaderboards/LeaderboardScoreTooltip.cs
@@ -19,10 +19,10 @@ namespace osu.Game.Online.Leaderboards
 {
     public class LeaderboardScoreTooltip : VisibilityContainer, ITooltip<ScoreInfo>
     {
-        private OsuSpriteText timestampLabel;
-        private FillFlowContainer<HitResultCell> topScoreStatistics;
-        private FillFlowContainer<HitResultCell> bottomScoreStatistics;
-        private FillFlowContainer<ModCell> modStatistics;
+        private readonly OsuSpriteText timestampLabel;
+        private readonly FillFlowContainer<HitResultCell> topScoreStatistics;
+        private readonly FillFlowContainer<HitResultCell> bottomScoreStatistics;
+        private readonly FillFlowContainer<ModCell> modStatistics;
 
         public LeaderboardScoreTooltip()
         {
@@ -58,7 +58,7 @@ namespace osu.Game.Online.Leaderboards
                         // Info row
                         new Drawable[]
                         {
-                            timestampLabel = new OsuSpriteText()
+                            timestampLabel = new OsuSpriteText
                             {
                                 Font = OsuFont.GetFont(size: 12, weight: FontWeight.SemiBold),
                             }
@@ -98,8 +98,9 @@ namespace osu.Game.Online.Leaderboards
 
         public void SetContent(ScoreInfo score)
         {
-            if (currentScore == score)
+            if (currentScore.Equals(score))
                 return;
+
             currentScore = score;
 
             timestampLabel.Text = $"Played on {score.Date.ToLocalTime():d MMMM yyyy HH:mm}";
@@ -116,9 +117,9 @@ namespace osu.Game.Online.Leaderboards
             foreach (var result in score.GetStatisticsForDisplay())
             {
                 (result.Result > HitResult.Perfect
-                    ? bottomScoreStatistics
-                    : topScoreStatistics
-                ).Add(new HitResultCell(result));
+                        ? bottomScoreStatistics
+                        : topScoreStatistics
+                        ).Add(new HitResultCell(result));
             }
         }
 
@@ -129,9 +130,9 @@ namespace osu.Game.Online.Leaderboards
 
         private class HitResultCell : CompositeDrawable
         {
-            readonly private string DisplayName;
-            readonly private HitResult Result;
-            readonly private int Count;
+            private readonly string DisplayName;
+            private readonly HitResult Result;
+            private readonly int Count;
 
             public HitResultCell(HitResultDisplayStatistic stat)
             {
@@ -190,7 +191,7 @@ namespace osu.Game.Online.Leaderboards
 
         private class ModCell : CompositeDrawable
         {
-            readonly private Mod Mod;
+            private readonly Mod Mod;
 
             public ModCell(Mod mod)
             {

From e1b57c4bf61d97070021f154a25cbd802b3133dc Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 1 Feb 2022 16:07:57 +0900
Subject: [PATCH 2688/5547] Fix inspections

---
 .../Leaderboards/LeaderboardScoreTooltip.cs   | 37 ++++++++++---------
 1 file changed, 19 insertions(+), 18 deletions(-)

diff --git a/osu.Game/Online/Leaderboards/LeaderboardScoreTooltip.cs b/osu.Game/Online/Leaderboards/LeaderboardScoreTooltip.cs
index 0b2de3e2c8..7825a50a0b 100644
--- a/osu.Game/Online/Leaderboards/LeaderboardScoreTooltip.cs
+++ b/osu.Game/Online/Leaderboards/LeaderboardScoreTooltip.cs
@@ -119,7 +119,7 @@ namespace osu.Game.Online.Leaderboards
                 (result.Result > HitResult.Perfect
                         ? bottomScoreStatistics
                         : topScoreStatistics
-                        ).Add(new HitResultCell(result));
+                    ).Add(new HitResultCell(result));
             }
         }
 
@@ -130,18 +130,18 @@ namespace osu.Game.Online.Leaderboards
 
         private class HitResultCell : CompositeDrawable
         {
-            private readonly string DisplayName;
-            private readonly HitResult Result;
-            private readonly int Count;
+            private readonly string displayName;
+            private readonly HitResult result;
+            private readonly int count;
 
             public HitResultCell(HitResultDisplayStatistic stat)
             {
                 AutoSizeAxes = Axes.Both;
-                Padding = new MarginPadding{ Horizontal = 5f };
+                Padding = new MarginPadding { Horizontal = 5f };
 
-                DisplayName = stat.DisplayName;
-                Result = stat.Result;
-                Count = stat.Count;
+                displayName = stat.DisplayName;
+                result = stat.Result;
+                count = stat.Count;
             }
 
             [BackgroundDependencyLoader]
@@ -169,12 +169,12 @@ namespace osu.Game.Online.Leaderboards
                                 },
                                 new OsuSpriteText
                                 {
-                                    Padding = new MarginPadding{ Horizontal = 2f },
+                                    Padding = new MarginPadding { Horizontal = 2f },
                                     Anchor = Anchor.Centre,
                                     Origin = Anchor.Centre,
                                     Font = OsuFont.Torus.With(size: 12, weight: FontWeight.SemiBold),
-                                    Text = DisplayName.ToUpperInvariant(),
-                                    Colour = colours.ForHitResult(Result),
+                                    Text = displayName.ToUpperInvariant(),
+                                    Colour = colours.ForHitResult(result),
                                 }
                             }
                         },
@@ -182,7 +182,7 @@ namespace osu.Game.Online.Leaderboards
                         {
                             RelativeSizeAxes = Axes.Y,
                             Font = OsuFont.GetFont(size: 12, weight: FontWeight.SemiBold),
-                            Text = Count.ToString(),
+                            Text = count.ToString(),
                         },
                     }
                 };
@@ -191,13 +191,13 @@ namespace osu.Game.Online.Leaderboards
 
         private class ModCell : CompositeDrawable
         {
-            private readonly Mod Mod;
+            private readonly Mod mod;
 
             public ModCell(Mod mod)
             {
                 AutoSizeAxes = Axes.Both;
-                Padding = new MarginPadding{ Horizontal = 5f };
-                Mod = mod;
+                Padding = new MarginPadding { Horizontal = 5f };
+                this.mod = mod;
             }
 
             [BackgroundDependencyLoader]
@@ -212,7 +212,7 @@ namespace osu.Game.Online.Leaderboards
                     Spacing = new Vector2(2f, 0f),
                     Children = new Drawable[]
                     {
-                        new ModIcon(Mod, showTooltip: false).With(icon =>
+                        new ModIcon(mod, showTooltip: false).With(icon =>
                         {
                             icon.Origin = Anchor.CentreLeft;
                             icon.Anchor = Anchor.CentreLeft;
@@ -221,14 +221,15 @@ namespace osu.Game.Online.Leaderboards
                     }
                 };
 
-                string description = Mod.SettingDescription;
+                string description = mod.SettingDescription;
+
                 if (!string.IsNullOrEmpty(description))
                 {
                     container.Add(new OsuSpriteText
                     {
                         RelativeSizeAxes = Axes.Y,
                         Font = OsuFont.GetFont(size: 12, weight: FontWeight.SemiBold),
-                        Text = Mod.SettingDescription,
+                        Text = mod.SettingDescription,
                         Origin = Anchor.CentreLeft,
                         Anchor = Anchor.CentreLeft,
                     });

From 855135c51e63f8a2095e7ae5dc8402a5df1b1920 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 1 Feb 2022 16:13:27 +0900
Subject: [PATCH 2689/5547] Fix potential nullref during display due to
 incorrect equality check

---
 osu.Game/Online/Leaderboards/LeaderboardScoreTooltip.cs | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Online/Leaderboards/LeaderboardScoreTooltip.cs b/osu.Game/Online/Leaderboards/LeaderboardScoreTooltip.cs
index 7825a50a0b..85db59b3ea 100644
--- a/osu.Game/Online/Leaderboards/LeaderboardScoreTooltip.cs
+++ b/osu.Game/Online/Leaderboards/LeaderboardScoreTooltip.cs
@@ -15,6 +15,8 @@ using osu.Game.Rulesets.Scoring;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.UI;
 
+#nullable enable
+
 namespace osu.Game.Online.Leaderboards
 {
     public class LeaderboardScoreTooltip : VisibilityContainer, ITooltip<ScoreInfo>
@@ -94,14 +96,14 @@ namespace osu.Game.Online.Leaderboards
             };
         }
 
-        private ScoreInfo currentScore;
+        private ScoreInfo? displayedScore;
 
         public void SetContent(ScoreInfo score)
         {
-            if (currentScore.Equals(score))
+            if (displayedScore?.Equals(score) == true)
                 return;
 
-            currentScore = score;
+            displayedScore = score;
 
             timestampLabel.Text = $"Played on {score.Date.ToLocalTime():d MMMM yyyy HH:mm}";
 

From fdb52a8fd70105516a2b4fb32cb6b3b4657d98ae Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 1 Feb 2022 16:20:40 +0900
Subject: [PATCH 2690/5547] Remove gap in tooltip display between statistics

---
 osu.Game/Online/Leaderboards/LeaderboardScore.cs | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/osu.Game/Online/Leaderboards/LeaderboardScore.cs b/osu.Game/Online/Leaderboards/LeaderboardScore.cs
index 7779043ccd..b4aaebd4e4 100644
--- a/osu.Game/Online/Leaderboards/LeaderboardScore.cs
+++ b/osu.Game/Online/Leaderboards/LeaderboardScore.cs
@@ -186,7 +186,6 @@ namespace osu.Game.Online.Leaderboards
                                                     Anchor = Anchor.BottomLeft,
                                                     AutoSizeAxes = Axes.Both,
                                                     Direction = FillDirection.Horizontal,
-                                                    Spacing = new Vector2(10f, 0f),
                                                     Margin = new MarginPadding { Left = edge_margin },
                                                     Children = statisticsLabels
                                                 },
@@ -231,7 +230,6 @@ namespace osu.Game.Online.Leaderboards
                                     Origin = Anchor.BottomRight,
                                     AutoSizeAxes = Axes.Both,
                                     Direction = FillDirection.Horizontal,
-                                    Spacing = new Vector2(1),
                                     ChildrenEnumerable = Score.Mods.Select(mod => new ModIcon(mod) { Scale = new Vector2(0.375f) })
                                 },
                             },
@@ -316,6 +314,7 @@ namespace osu.Game.Online.Leaderboards
                 {
                     AutoSizeAxes = Axes.Both,
                     Direction = FillDirection.Horizontal,
+                    Padding = new MarginPadding { Right = 10 },
                     Children = new Drawable[]
                     {
                         new Container

From 3ca2c906842209fe36e6d67ee7ace35f2cfad747 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 1 Feb 2022 16:35:05 +0900
Subject: [PATCH 2691/5547] Add test scores in `BeatmapLeaderboard` test scene
 with more mods

---
 .../SongSelect/TestSceneBeatmapLeaderboard.cs | 35 +++++++++++++------
 1 file changed, 25 insertions(+), 10 deletions(-)

diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
index 48230ff9e9..7292ec96ed 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
@@ -197,7 +197,22 @@ namespace osu.Game.Tests.Visual.SongSelect
                     Accuracy = 1,
                     MaxCombo = 244,
                     TotalScore = 1707827,
-                    //Mods = new Mod[] { new OsuModHidden(), new OsuModHardRock(), },
+                    Mods = new Mod[]
+                    {
+                        new OsuModHidden(),
+                        new OsuModHardRock(),
+                        new OsuModFlashlight
+                        {
+                            FollowDelay = { Value = 200 }
+                        },
+                        new OsuModDifficultyAdjust
+                        {
+                            CircleSize = { Value = 8 },
+                            ApproachRate = { Value = 7 },
+                            OverallDifficulty = { Value = 6 },
+                            DrainRate = { Value = 5 },
+                        }
+                    },
                     Ruleset = new OsuRuleset().RulesetInfo,
                     BeatmapInfo = beatmapInfo,
                     User = new APIUser
@@ -217,7 +232,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                     Accuracy = 1,
                     MaxCombo = 244,
                     TotalScore = 1707827,
-                    //Mods = new Mod[] { new OsuModHidden(), new OsuModHardRock(), },
+                    Mods = new Mod[] { new OsuModHidden(), new OsuModHardRock(), },
                     BeatmapInfo = beatmapInfo,
                     Ruleset = new OsuRuleset().RulesetInfo,
                     User = new APIUser
@@ -237,7 +252,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                     Accuracy = 1,
                     MaxCombo = 244,
                     TotalScore = 1707827,
-                    //Mods = new Mod[] { new OsuModHidden(), new OsuModHardRock(), },
+                    Mods = new Mod[] { new OsuModHidden(), new OsuModHardRock(), },
                     BeatmapInfo = beatmapInfo,
                     Ruleset = new OsuRuleset().RulesetInfo,
 
@@ -258,7 +273,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                     Accuracy = 1,
                     MaxCombo = 244,
                     TotalScore = 1707827,
-                    //Mods = new Mod[] { new OsuModHidden(), new OsuModHardRock(), },
+                    Mods = new Mod[] { new OsuModHidden(), new OsuModHardRock(), },
                     BeatmapInfo = beatmapInfo,
                     Ruleset = new OsuRuleset().RulesetInfo,
 
@@ -279,7 +294,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                     Accuracy = 1,
                     MaxCombo = 244,
                     TotalScore = 1707827,
-                    //Mods = new Mod[] { new OsuModHidden(), new OsuModHardRock(), },
+                    Mods = new Mod[] { new OsuModHidden(), new OsuModHardRock(), },
                     BeatmapInfo = beatmapInfo,
                     Ruleset = new OsuRuleset().RulesetInfo,
 
@@ -300,7 +315,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                     Accuracy = 0.9826,
                     MaxCombo = 244,
                     TotalScore = 1707827,
-                    //Mods = new Mod[] { new OsuModHidden(), new OsuModHardRock(), },
+                    Mods = new Mod[] { new OsuModHidden(), new OsuModHardRock(), },
                     BeatmapInfo = beatmapInfo,
                     Ruleset = new OsuRuleset().RulesetInfo,
 
@@ -321,7 +336,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                     Accuracy = 0.9654,
                     MaxCombo = 244,
                     TotalScore = 1707827,
-                    //Mods = new Mod[] { new OsuModHidden(), new OsuModHardRock(), },
+                    Mods = new Mod[] { new OsuModHidden(), new OsuModHardRock(), },
                     BeatmapInfo = beatmapInfo,
                     Ruleset = new OsuRuleset().RulesetInfo,
 
@@ -342,7 +357,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                     Accuracy = 0.6025,
                     MaxCombo = 244,
                     TotalScore = 1707827,
-                    //Mods = new Mod[] { new OsuModHidden(), new OsuModHardRock(), },
+                    Mods = new Mod[] { new OsuModHidden(), new OsuModHardRock(), },
                     BeatmapInfo = beatmapInfo,
                     Ruleset = new OsuRuleset().RulesetInfo,
 
@@ -363,7 +378,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                     Accuracy = 0.5140,
                     MaxCombo = 244,
                     TotalScore = 1707827,
-                    //Mods = new Mod[] { new OsuModHidden(), new OsuModHardRock(), },
+                    Mods = new Mod[] { new OsuModHidden(), new OsuModHardRock(), },
                     BeatmapInfo = beatmapInfo,
                     Ruleset = new OsuRuleset().RulesetInfo,
 
@@ -384,7 +399,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                     Accuracy = 0.4222,
                     MaxCombo = 244,
                     TotalScore = 1707827,
-                    //Mods = new Mod[] { new OsuModHidden(), new OsuModHardRock(), },
+                    Mods = new Mod[] { new OsuModHidden(), new OsuModHardRock(), },
                     BeatmapInfo = beatmapInfo,
                     Ruleset = new OsuRuleset().RulesetInfo,
 

From 8eace12fe3b5b585657cfec9ad733c129dd4d73a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 1 Feb 2022 16:35:22 +0900
Subject: [PATCH 2692/5547] Synchronise (roughly) backgrounds of all custom
 tooltips

---
 .../Drawables/DifficultyIconTooltip.cs        |  1 +
 .../Leaderboards/LeaderboardScoreTooltip.cs   | 29 ++++++++++++-------
 2 files changed, 19 insertions(+), 11 deletions(-)

diff --git a/osu.Game/Beatmaps/Drawables/DifficultyIconTooltip.cs b/osu.Game/Beatmaps/Drawables/DifficultyIconTooltip.cs
index ec4bcbd65f..aba01a1294 100644
--- a/osu.Game/Beatmaps/Drawables/DifficultyIconTooltip.cs
+++ b/osu.Game/Beatmaps/Drawables/DifficultyIconTooltip.cs
@@ -30,6 +30,7 @@ namespace osu.Game.Beatmaps.Drawables
             {
                 background = new Box
                 {
+                    Alpha = 0.9f,
                     RelativeSizeAxes = Axes.Both
                 },
                 new FillFlowContainer
diff --git a/osu.Game/Online/Leaderboards/LeaderboardScoreTooltip.cs b/osu.Game/Online/Leaderboards/LeaderboardScoreTooltip.cs
index 85db59b3ea..7b88c0d534 100644
--- a/osu.Game/Online/Leaderboards/LeaderboardScoreTooltip.cs
+++ b/osu.Game/Online/Leaderboards/LeaderboardScoreTooltip.cs
@@ -21,24 +21,31 @@ namespace osu.Game.Online.Leaderboards
 {
     public class LeaderboardScoreTooltip : VisibilityContainer, ITooltip<ScoreInfo>
     {
-        private readonly OsuSpriteText timestampLabel;
-        private readonly FillFlowContainer<HitResultCell> topScoreStatistics;
-        private readonly FillFlowContainer<HitResultCell> bottomScoreStatistics;
-        private readonly FillFlowContainer<ModCell> modStatistics;
+        private OsuSpriteText timestampLabel = null!;
+        private FillFlowContainer<HitResultCell> topScoreStatistics = null!;
+        private FillFlowContainer<HitResultCell> bottomScoreStatistics = null!;
+        private FillFlowContainer<ModCell> modStatistics = null!;
 
         public LeaderboardScoreTooltip()
         {
             AutoSizeAxes = Axes.Both;
+            AutoSizeDuration = 200;
+            AutoSizeEasing = Easing.OutQuint;
+
             Masking = true;
             CornerRadius = 5;
+        }
 
+        [BackgroundDependencyLoader]
+        private void load(OsuColour colours)
+        {
             InternalChildren = new Drawable[]
             {
                 new Box
                 {
                     RelativeSizeAxes = Axes.Both,
-                    Alpha = 0.7f,
-                    Colour = Colour4.Black,
+                    Alpha = 0.9f,
+                    Colour = colours.Gray3,
                 },
                 new GridContainer
                 {
@@ -118,10 +125,10 @@ namespace osu.Game.Online.Leaderboards
 
             foreach (var result in score.GetStatisticsForDisplay())
             {
-                (result.Result > HitResult.Perfect
-                        ? bottomScoreStatistics
-                        : topScoreStatistics
-                    ).Add(new HitResultCell(result));
+                if (result.Result > HitResult.Perfect)
+                    bottomScoreStatistics.Add(new HitResultCell(result));
+                else
+                    topScoreStatistics.Add(new HitResultCell(result));
             }
         }
 
@@ -171,7 +178,7 @@ namespace osu.Game.Online.Leaderboards
                                 },
                                 new OsuSpriteText
                                 {
-                                    Padding = new MarginPadding { Horizontal = 2f },
+                                    Padding = new MarginPadding(2),
                                     Anchor = Anchor.Centre,
                                     Origin = Anchor.Centre,
                                     Font = OsuFont.Torus.With(size: 12, weight: FontWeight.SemiBold),

From f87920cd83d060542ac77784fdefef09f9521348 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 1 Feb 2022 16:43:26 +0900
Subject: [PATCH 2693/5547] Remove unnecessary `GridContainer` and list mods
 verticall to give more space

---
 .../Leaderboards/LeaderboardScoreTooltip.cs   | 61 ++++++++-----------
 1 file changed, 24 insertions(+), 37 deletions(-)

diff --git a/osu.Game/Online/Leaderboards/LeaderboardScoreTooltip.cs b/osu.Game/Online/Leaderboards/LeaderboardScoreTooltip.cs
index 7b88c0d534..8c349d56e0 100644
--- a/osu.Game/Online/Leaderboards/LeaderboardScoreTooltip.cs
+++ b/osu.Game/Online/Leaderboards/LeaderboardScoreTooltip.cs
@@ -47,55 +47,42 @@ namespace osu.Game.Online.Leaderboards
                     Alpha = 0.9f,
                     Colour = colours.Gray3,
                 },
-                new GridContainer
+                new FillFlowContainer
                 {
                     Margin = new MarginPadding(5f),
+                    Spacing = new Vector2(10),
                     AutoSizeAxes = Axes.Both,
-                    RowDimensions = new[]
-                    {
-                        new Dimension(GridSizeMode.AutoSize),
-                        new Dimension(GridSizeMode.AutoSize),
-                        new Dimension(GridSizeMode.AutoSize),
-                        new Dimension(GridSizeMode.AutoSize),
-                    },
-                    ColumnDimensions = new[]
-                    {
-                        new Dimension(GridSizeMode.AutoSize),
-                    },
-                    Content = new[]
+                    Direction = FillDirection.Vertical,
+                    Children = new Drawable[]
                     {
                         // Info row
-                        new Drawable[]
+                        timestampLabel = new OsuSpriteText
                         {
-                            timestampLabel = new OsuSpriteText
-                            {
-                                Font = OsuFont.GetFont(size: 12, weight: FontWeight.SemiBold),
-                            }
+                            Font = OsuFont.GetFont(size: 12, weight: FontWeight.SemiBold),
                         },
                         // Mods row
-                        new Drawable[]
+                        modStatistics = new FillFlowContainer<ModCell>
                         {
-                            modStatistics = new FillFlowContainer<ModCell>
-                            {
-                                AutoSizeAxes = Axes.Both,
-                                Direction = FillDirection.Horizontal,
-                            }
+                            AutoSizeAxes = Axes.Both,
+                            Direction = FillDirection.Vertical,
                         },
-                        // Actual stats rows
-                        new Drawable[]
+                        new FillFlowContainer
                         {
-                            topScoreStatistics = new FillFlowContainer<HitResultCell>
+                            AutoSizeAxes = Axes.Both,
+                            Direction = FillDirection.Vertical,
+                            Children = new Drawable[]
                             {
-                                AutoSizeAxes = Axes.Both,
-                                Direction = FillDirection.Horizontal,
-                            }
-                        },
-                        new Drawable[]
-                        {
-                            bottomScoreStatistics = new FillFlowContainer<HitResultCell>
-                            {
-                                AutoSizeAxes = Axes.Both,
-                                Direction = FillDirection.Horizontal,
+                                // Actual stats rows
+                                topScoreStatistics = new FillFlowContainer<HitResultCell>
+                                {
+                                    AutoSizeAxes = Axes.Both,
+                                    Direction = FillDirection.Horizontal,
+                                },
+                                bottomScoreStatistics = new FillFlowContainer<HitResultCell>
+                                {
+                                    AutoSizeAxes = Axes.Both,
+                                    Direction = FillDirection.Horizontal,
+                                },
                             }
                         },
                     }

From 0f83f77d2b3fc8de0d615361e53130f5958c94c6 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 1 Feb 2022 16:52:53 +0900
Subject: [PATCH 2694/5547] Add xmldoc for new `ResetFromReplayFrame` method

---
 osu.Game/Rulesets/Scoring/JudgementProcessor.cs | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/osu.Game/Rulesets/Scoring/JudgementProcessor.cs b/osu.Game/Rulesets/Scoring/JudgementProcessor.cs
index f38155240e..a643c31daa 100644
--- a/osu.Game/Rulesets/Scoring/JudgementProcessor.cs
+++ b/osu.Game/Rulesets/Scoring/JudgementProcessor.cs
@@ -108,6 +108,14 @@ namespace osu.Game.Rulesets.Scoring
             JudgedHits = 0;
         }
 
+        /// <summary>
+        /// Reset all statistics based on header information contained within a replay frame.
+        /// </summary>
+        /// <remarks>
+        /// If the provided replay frame does not have any header information, this will be a noop.
+        /// </remarks>
+        /// <param name="ruleset">The ruleset to be used for retrieving statistics.</param>
+        /// <param name="frame">The replay frame to read header statistics from.</param>
         public virtual void ResetFromReplayFrame(Ruleset ruleset, ReplayFrame frame)
         {
             if (frame.Header == null)

From 15479ae046ebf96b22367565333622a573dd59ae Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 1 Feb 2022 16:55:28 +0900
Subject: [PATCH 2695/5547] Add test coverage of no header doing nothing

---
 osu.Game.Tests/Gameplay/TestSceneScoreProcessor.cs | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/osu.Game.Tests/Gameplay/TestSceneScoreProcessor.cs b/osu.Game.Tests/Gameplay/TestSceneScoreProcessor.cs
index bcaa70d062..70ba868de6 100644
--- a/osu.Game.Tests/Gameplay/TestSceneScoreProcessor.cs
+++ b/osu.Game.Tests/Gameplay/TestSceneScoreProcessor.cs
@@ -60,6 +60,12 @@ namespace osu.Game.Tests.Gameplay
             Assert.That(scoreProcessor.TotalScore.Value, Is.EqualTo(1_000_000));
             Assert.That(scoreProcessor.JudgedHits, Is.EqualTo(1));
 
+            // No header shouldn't cause any change
+            scoreProcessor.ResetFromReplayFrame(new OsuRuleset(), new OsuReplayFrame());
+
+            Assert.That(scoreProcessor.TotalScore.Value, Is.EqualTo(1_000_000));
+            Assert.That(scoreProcessor.JudgedHits, Is.EqualTo(1));
+
             // Reset with a miss instead.
             scoreProcessor.ResetFromReplayFrame(new OsuRuleset(), new OsuReplayFrame
             {

From bfe6218ed51c6451f85046998e225de2bdcbe7e6 Mon Sep 17 00:00:00 2001
From: Susko3 <16479013+Susko3@users.noreply.github.com>
Date: Tue, 1 Feb 2022 12:43:58 +0100
Subject: [PATCH 2696/5547] Change default orientation to SensorLandscape

---
 osu.Android/GameplayScreenRotationLocker.cs | 2 +-
 osu.Android/OsuGameActivity.cs              | 4 +++-
 2 files changed, 4 insertions(+), 2 deletions(-)

diff --git a/osu.Android/GameplayScreenRotationLocker.cs b/osu.Android/GameplayScreenRotationLocker.cs
index 25bd659a5d..ab91b4e3b3 100644
--- a/osu.Android/GameplayScreenRotationLocker.cs
+++ b/osu.Android/GameplayScreenRotationLocker.cs
@@ -27,7 +27,7 @@ namespace osu.Android
         {
             gameActivity.RunOnUiThread(() =>
             {
-                gameActivity.RequestedOrientation = userPlaying.NewValue ? ScreenOrientation.Locked : ScreenOrientation.FullUser;
+                gameActivity.RequestedOrientation = userPlaying.NewValue ? ScreenOrientation.Locked : OsuGameActivity.DEFAULT_ORIENTATION;
             });
         }
     }
diff --git a/osu.Android/OsuGameActivity.cs b/osu.Android/OsuGameActivity.cs
index c9fb539d8a..e6679b61a6 100644
--- a/osu.Android/OsuGameActivity.cs
+++ b/osu.Android/OsuGameActivity.cs
@@ -17,7 +17,7 @@ using osu.Game.Database;
 
 namespace osu.Android
 {
-    [Activity(ConfigurationChanges = DEFAULT_CONFIG_CHANGES, Exported = true, LaunchMode = DEFAULT_LAUNCH_MODE, MainLauncher = true, ScreenOrientation = ScreenOrientation.FullUser)]
+    [Activity(ConfigurationChanges = DEFAULT_CONFIG_CHANGES, Exported = true, LaunchMode = DEFAULT_LAUNCH_MODE, MainLauncher = true, ScreenOrientation = DEFAULT_ORIENTATION)]
     [IntentFilter(new[] { Intent.ActionView }, Categories = new[] { Intent.CategoryDefault }, DataScheme = "content", DataPathPattern = ".*\\\\.osz", DataHost = "*", DataMimeType = "*/*")]
     [IntentFilter(new[] { Intent.ActionView }, Categories = new[] { Intent.CategoryDefault }, DataScheme = "content", DataPathPattern = ".*\\\\.osk", DataHost = "*", DataMimeType = "*/*")]
     [IntentFilter(new[] { Intent.ActionView }, Categories = new[] { Intent.CategoryDefault }, DataScheme = "content", DataPathPattern = ".*\\\\.osr", DataHost = "*", DataMimeType = "*/*")]
@@ -39,6 +39,8 @@ namespace osu.Android
     [IntentFilter(new[] { Intent.ActionView }, Categories = new[] { Intent.CategoryBrowsable, Intent.CategoryDefault }, DataSchemes = new[] { "osu", "osump" })]
     public class OsuGameActivity : AndroidGameActivity
     {
+        public const ScreenOrientation DEFAULT_ORIENTATION = ScreenOrientation.SensorLandscape;
+
         private static readonly string[] osu_url_schemes = { "osu", "osump" };
 
         private OsuGameAndroid game;

From 41007169f722febe2217ff805cf95cdb6d81c3dd Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 1 Feb 2022 15:51:41 +0900
Subject: [PATCH 2697/5547] Give SpectatorState a user state

---
 .../Visual/Gameplay/TestSceneSpectator.cs     |  2 +-
 .../Online/Spectator/SpectatingUserState.cs   | 33 +++++++++++++++++++
 osu.Game/Online/Spectator/SpectatorClient.cs  | 10 +++++-
 osu.Game/Online/Spectator/SpectatorState.cs   |  7 ++--
 osu.Game/Rulesets/UI/ReplayRecorder.cs        |  4 ++-
 osu.Game/Screens/Play/Player.cs               |  2 +-
 6 files changed, 52 insertions(+), 6 deletions(-)
 create mode 100644 osu.Game/Online/Spectator/SpectatingUserState.cs

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs
index 917b3c89a8..86d6de6975 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs
@@ -211,7 +211,7 @@ namespace osu.Game.Tests.Visual.Gameplay
             AddStep("send frames and finish play", () =>
             {
                 spectatorClient.HandleFrame(new OsuReplayFrame(1000, Vector2.Zero));
-                spectatorClient.EndPlaying();
+                spectatorClient.EndPlaying(new GameplayState(new TestBeatmap(new OsuRuleset().RulesetInfo), new OsuRuleset()) { HasPassed = true });
             });
 
             // We can't access API because we're an "online" test.
diff --git a/osu.Game/Online/Spectator/SpectatingUserState.cs b/osu.Game/Online/Spectator/SpectatingUserState.cs
new file mode 100644
index 0000000000..c7ba4ba248
--- /dev/null
+++ b/osu.Game/Online/Spectator/SpectatingUserState.cs
@@ -0,0 +1,33 @@
+// 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.Online.Spectator
+{
+    public enum SpectatingUserState
+    {
+        /// <summary>
+        /// The spectated user has not yet played.
+        /// </summary>
+        Idle,
+
+        /// <summary>
+        /// The spectated user is currently playing.
+        /// </summary>
+        Playing,
+
+        /// <summary>
+        /// The spectated user has successfully completed gameplay.
+        /// </summary>
+        Completed,
+
+        /// <summary>
+        /// The spectator user has failed during gameplay.
+        /// </summary>
+        Failed,
+
+        /// <summary>
+        /// The spectated user has quit during gameplay.
+        /// </summary>
+        Quit
+    }
+}
diff --git a/osu.Game/Online/Spectator/SpectatorClient.cs b/osu.Game/Online/Spectator/SpectatorClient.cs
index c3e70edcd3..f4161e1db9 100644
--- a/osu.Game/Online/Spectator/SpectatorClient.cs
+++ b/osu.Game/Online/Spectator/SpectatorClient.cs
@@ -138,6 +138,7 @@ namespace osu.Game.Online.Spectator
                 currentState.BeatmapID = score.ScoreInfo.BeatmapInfo.OnlineID;
                 currentState.RulesetID = score.ScoreInfo.RulesetID;
                 currentState.Mods = score.ScoreInfo.Mods.Select(m => new APIMod(m)).ToArray();
+                currentState.State = SpectatingUserState.Playing;
 
                 currentBeatmap = state.Beatmap;
                 currentScore = score;
@@ -148,7 +149,7 @@ namespace osu.Game.Online.Spectator
 
         public void SendFrames(FrameDataBundle data) => lastSend = SendFramesInternal(data);
 
-        public void EndPlaying()
+        public void EndPlaying(GameplayState state)
         {
             // This method is most commonly called via Dispose(), which is can be asynchronous (via the AsyncDisposalQueue).
             // We probably need to find a better way to handle this...
@@ -163,6 +164,13 @@ namespace osu.Game.Online.Spectator
                 IsPlaying = false;
                 currentBeatmap = null;
 
+                if (state.HasPassed)
+                    currentState.State = SpectatingUserState.Completed;
+                else if (state.HasFailed)
+                    currentState.State = SpectatingUserState.Failed;
+                else
+                    currentState.State = SpectatingUserState.Quit;
+
                 EndPlayingInternal(currentState);
             });
         }
diff --git a/osu.Game/Online/Spectator/SpectatorState.cs b/osu.Game/Online/Spectator/SpectatorState.cs
index ebb91e4dd2..fc62f16bba 100644
--- a/osu.Game/Online/Spectator/SpectatorState.cs
+++ b/osu.Game/Online/Spectator/SpectatorState.cs
@@ -24,14 +24,17 @@ namespace osu.Game.Online.Spectator
         [Key(2)]
         public IEnumerable<APIMod> Mods { get; set; } = Enumerable.Empty<APIMod>();
 
+        [Key(3)]
+        public SpectatingUserState State { get; set; }
+
         public bool Equals(SpectatorState other)
         {
             if (ReferenceEquals(null, other)) return false;
             if (ReferenceEquals(this, other)) return true;
 
-            return BeatmapID == other.BeatmapID && Mods.SequenceEqual(other.Mods) && RulesetID == other.RulesetID;
+            return BeatmapID == other.BeatmapID && Mods.SequenceEqual(other.Mods) && RulesetID == other.RulesetID && State == other.State;
         }
 
-        public override string ToString() => $"Beatmap:{BeatmapID} Mods:{string.Join(',', Mods)} Ruleset:{RulesetID}";
+        public override string ToString() => $"Beatmap:{BeatmapID} Mods:{string.Join(',', Mods)} Ruleset:{RulesetID} State:{State}";
     }
 }
diff --git a/osu.Game/Rulesets/UI/ReplayRecorder.cs b/osu.Game/Rulesets/UI/ReplayRecorder.cs
index 976f95cef8..277040b2a6 100644
--- a/osu.Game/Rulesets/UI/ReplayRecorder.cs
+++ b/osu.Game/Rulesets/UI/ReplayRecorder.cs
@@ -55,7 +55,9 @@ namespace osu.Game.Rulesets.UI
         protected override void Dispose(bool isDisposing)
         {
             base.Dispose(isDisposing);
-            spectatorClient?.EndPlaying();
+
+            if (spectatorClient != null && gameplayState != null)
+                spectatorClient.EndPlaying(gameplayState);
         }
 
         protected override void Update()
diff --git a/osu.Game/Screens/Play/Player.cs b/osu.Game/Screens/Play/Player.cs
index f6a2310826..1aa6cded48 100644
--- a/osu.Game/Screens/Play/Player.cs
+++ b/osu.Game/Screens/Play/Player.cs
@@ -1000,7 +1000,7 @@ namespace osu.Game.Screens.Play
             // EndPlaying() is typically called from ReplayRecorder.Dispose(). Disposal is currently asynchronous.
             // To resolve test failures, forcefully end playing synchronously when this screen exits.
             // Todo: Replace this with a more permanent solution once osu-framework has a synchronous cleanup method.
-            spectatorClient.EndPlaying();
+            spectatorClient.EndPlaying(GameplayState);
 
             // GameplayClockContainer performs seeks / start / stop operations on the beatmap's track.
             // as we are no longer the current screen, we cannot guarantee the track is still usable.

From f4210f7a302a3bad2130181800106cdcefeb2020 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 26 Jan 2022 22:21:07 +0900
Subject: [PATCH 2698/5547] Rework spectator components to use new user state

---
 osu.Game/Online/Spectator/SpectatorClient.cs  |  8 +---
 .../Dashboard/CurrentlyPlayingDisplay.cs      | 42 ++++++++++++-------
 osu.Game/Screens/Spectate/SpectatorScreen.cs  | 33 ++++++++-------
 3 files changed, 45 insertions(+), 38 deletions(-)

diff --git a/osu.Game/Online/Spectator/SpectatorClient.cs b/osu.Game/Online/Spectator/SpectatorClient.cs
index f4161e1db9..fb7526347b 100644
--- a/osu.Game/Online/Spectator/SpectatorClient.cs
+++ b/osu.Game/Online/Spectator/SpectatorClient.cs
@@ -93,12 +93,8 @@ namespace osu.Game.Online.Spectator
         {
             Schedule(() =>
             {
-                // UserBeganPlaying() is called by the server regardless of whether the local user is watching the remote user, and is called a further time when the remote user is watched.
-                // This may be a temporary thing (see: https://github.com/ppy/osu-server-spectator/blob/2273778e02cfdb4a9c6a934f2a46a8459cb5d29c/osu.Server.Spectator/Hubs/SpectatorHub.cs#L28-L29).
-                // We don't want the user states to update unless the player is being watched, otherwise calling BindUserBeganPlaying() can lead to double invocations.
                 if (watchingUsers.Contains(userId))
                     playingUserStates[userId] = state;
-
                 OnUserBeganPlaying?.Invoke(userId, state);
             });
 
@@ -109,8 +105,8 @@ namespace osu.Game.Online.Spectator
         {
             Schedule(() =>
             {
-                playingUserStates.Remove(userId);
-
+                if (watchingUsers.Contains(userId))
+                    playingUserStates[userId] = state;
                 OnUserFinishedPlaying?.Invoke(userId, state);
             });
 
diff --git a/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs b/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs
index afbfb9f7ef..383f17d8d2 100644
--- a/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs
+++ b/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs
@@ -22,7 +22,7 @@ namespace osu.Game.Overlays.Dashboard
 {
     internal class CurrentlyPlayingDisplay : CompositeDrawable
     {
-        private readonly IBindableDictionary<int, SpectatorState> playingUserStates = new BindableDictionary<int, SpectatorState>();
+        private readonly IBindableDictionary<int, SpectatorState> userStates = new BindableDictionary<int, SpectatorState>();
 
         private FillFlowContainer<PlayingUserPanel> userFlow;
 
@@ -51,33 +51,32 @@ namespace osu.Game.Overlays.Dashboard
         {
             base.LoadComplete();
 
-            playingUserStates.BindTo(spectatorClient.PlayingUserStates);
-            playingUserStates.BindCollectionChanged(onUsersChanged, true);
+            userStates.BindTo(spectatorClient.PlayingUserStates);
+            userStates.BindCollectionChanged(onUserStatesChanged, true);
         }
 
-        private void onUsersChanged(object sender, NotifyDictionaryChangedEventArgs<int, SpectatorState> e) => Schedule(() =>
+        private void onUserStatesChanged(object sender, NotifyDictionaryChangedEventArgs<int, SpectatorState> e) => Schedule(() =>
         {
             switch (e.Action)
             {
                 case NotifyDictionaryChangedAction.Add:
+                case NotifyDictionaryChangedAction.Replace:
                     Debug.Assert(e.NewItems != null);
 
-                    foreach ((int userId, _) in e.NewItems)
+                    foreach ((int userId, SpectatorState state) in e.NewItems)
                     {
+                        if (state.State != SpectatingUserState.Playing)
+                        {
+                            removePlayingUser(userId);
+                            continue;
+                        }
+
                         users.GetUserAsync(userId).ContinueWith(task =>
                         {
                             var user = task.GetResultSafely();
 
-                            if (user == null) return;
-
-                            Schedule(() =>
-                            {
-                                // user may no longer be playing.
-                                if (!playingUserStates.ContainsKey(user.Id))
-                                    return;
-
-                                userFlow.Add(createUserPanel(user));
-                            });
+                            if (user != null)
+                                Schedule(() => addPlayingUser(user));
                         });
                     }
 
@@ -87,9 +86,20 @@ namespace osu.Game.Overlays.Dashboard
                     Debug.Assert(e.OldItems != null);
 
                     foreach ((int userId, _) in e.OldItems)
-                        userFlow.FirstOrDefault(card => card.User.Id == userId)?.Expire();
+                        removePlayingUser(userId);
                     break;
             }
+
+            void addPlayingUser(APIUser user)
+            {
+                // user may no longer be playing.
+                if (!userStates.TryGetValue(user.Id, out var state2) || state2.State != SpectatingUserState.Playing)
+                    return;
+
+                userFlow.Add(createUserPanel(user));
+            }
+
+            void removePlayingUser(int userId) => userFlow.FirstOrDefault(card => card.User.Id == userId)?.Expire();
         });
 
         private PlayingUserPanel createUserPanel(APIUser user) =>
diff --git a/osu.Game/Screens/Spectate/SpectatorScreen.cs b/osu.Game/Screens/Spectate/SpectatorScreen.cs
index 3cf9f79611..783ba494eb 100644
--- a/osu.Game/Screens/Spectate/SpectatorScreen.cs
+++ b/osu.Game/Screens/Spectate/SpectatorScreen.cs
@@ -42,7 +42,7 @@ namespace osu.Game.Screens.Spectate
         [Resolved]
         private UserLookupCache userLookupCache { get; set; }
 
-        private readonly IBindableDictionary<int, SpectatorState> playingUserStates = new BindableDictionary<int, SpectatorState>();
+        private readonly IBindableDictionary<int, SpectatorState> userStates = new BindableDictionary<int, SpectatorState>();
 
         private readonly Dictionary<int, APIUser> userMap = new Dictionary<int, APIUser>();
         private readonly Dictionary<int, SpectatorGameplayState> gameplayStates = new Dictionary<int, SpectatorGameplayState>();
@@ -77,8 +77,8 @@ namespace osu.Game.Screens.Spectate
                     userMap[u.Id] = u;
                 }
 
-                playingUserStates.BindTo(spectatorClient.PlayingUserStates);
-                playingUserStates.BindCollectionChanged(onPlayingUserStatesChanged, true);
+                userStates.BindTo(spectatorClient.PlayingUserStates);
+                userStates.BindCollectionChanged(onUserStatesChanged, true);
 
                 realmSubscription = realm.RegisterForNotifications(
                     realm => realm.All<BeatmapSetInfo>().Where(s => !s.DeletePending), beatmapsChanged);
@@ -99,7 +99,7 @@ namespace osu.Game.Screens.Spectate
         {
             foreach ((int userId, _) in userMap)
             {
-                if (!playingUserStates.TryGetValue(userId, out var userState))
+                if (!userStates.TryGetValue(userId, out var userState))
                     continue;
 
                 if (beatmapSet.Beatmaps.Any(b => b.OnlineID == userState.BeatmapID))
@@ -107,40 +107,41 @@ namespace osu.Game.Screens.Spectate
             }
         }
 
-        private void onPlayingUserStatesChanged(object sender, NotifyDictionaryChangedEventArgs<int, SpectatorState> e)
+        private void onUserStatesChanged(object sender, NotifyDictionaryChangedEventArgs<int, SpectatorState> e)
         {
             switch (e.Action)
             {
                 case NotifyDictionaryChangedAction.Add:
                     foreach ((int userId, var state) in e.NewItems.AsNonNull())
-                        onUserStateAdded(userId, state);
+                        onUserStateChanged(userId, state);
                     break;
 
                 case NotifyDictionaryChangedAction.Remove:
-                    foreach ((int userId, var _) in e.OldItems.AsNonNull())
+                    foreach ((int userId, _) in e.OldItems.AsNonNull())
                         onUserStateRemoved(userId);
                     break;
 
                 case NotifyDictionaryChangedAction.Replace:
-                    foreach ((int userId, var _) in e.OldItems.AsNonNull())
-                        onUserStateRemoved(userId);
-
                     foreach ((int userId, var state) in e.NewItems.AsNonNull())
-                        onUserStateAdded(userId, state);
+                        onUserStateChanged(userId, state);
                     break;
             }
         }
 
-        private void onUserStateAdded(int userId, SpectatorState state)
+        private void onUserStateChanged(int userId, SpectatorState newState)
         {
-            if (state.RulesetID == null || state.BeatmapID == null)
+            if (newState.RulesetID == null || newState.BeatmapID == null)
                 return;
 
             if (!userMap.ContainsKey(userId))
                 return;
 
-            Schedule(() => OnUserStateChanged(userId, state));
-            updateGameplayState(userId);
+            // Do nothing for failed/completed states.
+            if (newState.State == SpectatingUserState.Playing)
+            {
+                Schedule(() => OnUserStateChanged(userId, newState));
+                updateGameplayState(userId);
+            }
         }
 
         private void onUserStateRemoved(int userId)
@@ -162,7 +163,7 @@ namespace osu.Game.Screens.Spectate
             Debug.Assert(userMap.ContainsKey(userId));
 
             var user = userMap[userId];
-            var spectatorState = playingUserStates[userId];
+            var spectatorState = userStates[userId];
 
             var resolvedRuleset = rulesets.AvailableRulesets.FirstOrDefault(r => r.OnlineID == spectatorState.RulesetID)?.CreateInstance();
             if (resolvedRuleset == null)

From b75c08c9ab07232d44b1bde38f68f2054547b91c Mon Sep 17 00:00:00 2001
From: Spooghetti420 <83249561+Spooghetti420@users.noreply.github.com>
Date: Tue, 1 Feb 2022 13:36:36 +0000
Subject: [PATCH 2699/5547] Improve beat length logic
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.Mania/Mods/ManiaModHoldOff.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Rulesets.Mania/Mods/ManiaModHoldOff.cs b/osu.Game.Rulesets.Mania/Mods/ManiaModHoldOff.cs
index 1abca970d5..6e942f672b 100644
--- a/osu.Game.Rulesets.Mania/Mods/ManiaModHoldOff.cs
+++ b/osu.Game.Rulesets.Mania/Mods/ManiaModHoldOff.cs
@@ -65,8 +65,8 @@ namespace osu.Game.Rulesets.Mania.Mods
 
         public static double GetNoteDurationInBeatLength(HoldNote holdNote, ManiaBeatmap beatmap)
         {
-            double bpmAtNoteTime = beatmap.ControlPointInfo.TimingPointAt(holdNote.StartTime).BPM;
-            return (60 * holdNote.Duration) / (1000 * bpmAtNoteTime);
+            double beatLength = beatmap.ControlPointInfo.TimingPointAt(holdNote.StartTime).BeatLength;
+            return holdNote.Duration / beatLength;
         }
     }
 }

From 39524f3dd296d44cfb8187507a416e02a47b040c Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Tue, 1 Feb 2022 22:26:30 +0800
Subject: [PATCH 2700/5547] Split total pp into 2 lines

---
 .../Statistics/PerformanceStatisticTooltip.cs | 85 ++++++++++++++++---
 1 file changed, 72 insertions(+), 13 deletions(-)

diff --git a/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatisticTooltip.cs b/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatisticTooltip.cs
index 44e5c366bb..739fac9d63 100644
--- a/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatisticTooltip.cs
+++ b/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatisticTooltip.cs
@@ -72,16 +72,73 @@ namespace osu.Game.Screens.Ranking.Expanded.Statistics
             UpdateDisplay(performance);
         }
 
-        private Drawable createAttributeItem(PerformanceDisplayAttribute attribute, PerformanceDisplayAttribute perfectAttribute)
+        private Drawable createItemForTotal(PerformanceDisplayAttribute attribute, PerformanceDisplayAttribute perfectAttribute)
         {
-            bool isTotal = attribute.PropertyName == nameof(PerformanceAttributes.Total);
-            float fraction = (float)(attribute.Value / perfectAttribute.Value);
-            if (float.IsNaN(fraction))
-                fraction = 0;
-            string text = fraction.ToLocalisableString("0%").ToString();
+            return
+                new GridContainer
+                {
+                    AutoSizeAxes = Axes.Both,
+                    Margin = new MarginPadding { Bottom = 10 },
+                    ColumnDimensions = new[]
+                    {
+                        new Dimension(GridSizeMode.Absolute, 250),
+                        new Dimension(GridSizeMode.AutoSize)
+                    },
+                    RowDimensions = new[]
+                    {
+                        new Dimension(GridSizeMode.AutoSize),
+                        new Dimension(GridSizeMode.AutoSize)
+                    },
+                    Content = new[]
+                    {
+                        new Drawable[]
+                        {
+                            new OsuSpriteText
+                            {
+                                Origin = Anchor.CentreLeft,
+                                Anchor = Anchor.CentreLeft,
+                                Font = OsuFont.GetFont(weight: FontWeight.Regular),
+                                Text = attribute.DisplayName,
+                                Colour = titleColor
+                            },
+                            new OsuSpriteText
+                            {
+                                Origin = Anchor.CentreLeft,
+                                Anchor = Anchor.CentreLeft,
+                                Font = OsuFont.GetFont(weight: FontWeight.SemiBold),
+                                Text = Math.Round(attribute.Value, MidpointRounding.AwayFromZero).ToLocalisableString(),
+                                Colour = titleColor
+                            }
+                        },
+                        new Drawable[]
+                        {
+                            new OsuSpriteText
+                            {
+                                Origin = Anchor.CentreLeft,
+                                Anchor = Anchor.CentreLeft,
+                                Font = OsuFont.GetFont(weight: FontWeight.Regular),
+                                Text = "Maximum",
+                                Colour = OsuColour.Gray(0.7f)
+                            },
+                            new OsuSpriteText
+                            {
+                                Origin = Anchor.CentreLeft,
+                                Anchor = Anchor.CentreLeft,
+                                Font = OsuFont.GetFont(weight: FontWeight.Regular),
+                                Text = Math.Round(perfectAttribute.Value, MidpointRounding.AwayFromZero).ToLocalisableString(),
+                                Colour = OsuColour.Gray(0.7f)
+                            }
+                        }
+                    }
+                };
+        }
 
-            if (isTotal)
-                text = (int)Math.Round(attribute.Value, MidpointRounding.AwayFromZero) + "/" + (int)Math.Round(perfectAttribute.Value, MidpointRounding.AwayFromZero);
+        private Drawable createItemForAttribute(PerformanceDisplayAttribute attribute, PerformanceDisplayAttribute perfectAttribute)
+        {
+            float percentage = (float)(attribute.Value / perfectAttribute.Value);
+            if (float.IsNaN(percentage))
+                percentage = 0;
+            string text = percentage.ToLocalisableString("0%").ToString();
 
             return new GridContainer
             {
@@ -106,7 +163,7 @@ namespace osu.Game.Screens.Ranking.Expanded.Statistics
                             Anchor = Anchor.CentreLeft,
                             Font = OsuFont.GetFont(weight: FontWeight.Regular),
                             Text = attribute.DisplayName,
-                            Colour = isTotal ? titleColor : textColour
+                            Colour = textColour
                         },
                         new Bar
                         {
@@ -115,8 +172,8 @@ namespace osu.Game.Screens.Ranking.Expanded.Statistics
                             Width = 130,
                             Height = 5,
                             BackgroundColour = Color4.White.Opacity(0.5f),
-                            Colour = isTotal ? titleColor : textColour,
-                            Length = fraction,
+                            Colour = textColour,
+                            Length = percentage,
                             Margin = new MarginPadding { Left = 5, Right = 5 }
                         },
                         new OsuSpriteText
@@ -125,7 +182,7 @@ namespace osu.Game.Screens.Ranking.Expanded.Statistics
                             Anchor = Anchor.CentreLeft,
                             Font = OsuFont.GetFont(weight: FontWeight.SemiBold),
                             Text = text,
-                            Colour = isTotal ? titleColor : textColour
+                            Colour = textColour
                         }
                     }
                 }
@@ -142,7 +199,9 @@ namespace osu.Game.Screens.Ranking.Expanded.Statistics
 
             foreach (PerformanceDisplayAttribute attr in displayAttributes)
             {
-                Content.Add(createAttributeItem(attr, perfectDisplayAttributes.First(a => a.PropertyName == attr.PropertyName)));
+                Content.Add(attr.PropertyName == nameof(PerformanceAttributes.Total)
+                    ? createItemForTotal(attr, perfectDisplayAttributes.First(a => a.PropertyName == attr.PropertyName))
+                    : createItemForAttribute(attr, perfectDisplayAttributes.First(a => a.PropertyName == attr.PropertyName)));
             }
         }
 

From b06128ffa5f4845bd0c9ae6dabe11120336b5cf4 Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Tue, 1 Feb 2022 22:26:55 +0800
Subject: [PATCH 2701/5547] Rename "Final PP" to "Achieved PP"

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

diff --git a/osu.Game/Rulesets/Difficulty/PerformanceAttributes.cs b/osu.Game/Rulesets/Difficulty/PerformanceAttributes.cs
index f210c669a6..e8c4c71913 100644
--- a/osu.Game/Rulesets/Difficulty/PerformanceAttributes.cs
+++ b/osu.Game/Rulesets/Difficulty/PerformanceAttributes.cs
@@ -21,7 +21,7 @@ namespace osu.Game.Rulesets.Difficulty
         /// <returns></returns>
         public virtual IEnumerable<PerformanceDisplayAttribute> GetAttributesForDisplay()
         {
-            yield return new PerformanceDisplayAttribute(nameof(Total), "Final PP", Total);
+            yield return new PerformanceDisplayAttribute(nameof(Total), "Achieved PP", Total);
         }
     }
 }

From eee020f8e4a17db7a1af6be611cbc0b3c5554852 Mon Sep 17 00:00:00 2001
From: dekrain <dawidkrainski8@gmail.com>
Date: Tue, 1 Feb 2022 20:26:52 +0100
Subject: [PATCH 2702/5547] Cleanup tooltip layout
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>
---
 .../Leaderboards/LeaderboardScoreTooltip.cs   | 42 ++++++-------------
 1 file changed, 13 insertions(+), 29 deletions(-)

diff --git a/osu.Game/Online/Leaderboards/LeaderboardScoreTooltip.cs b/osu.Game/Online/Leaderboards/LeaderboardScoreTooltip.cs
index 8c349d56e0..a0eea94501 100644
--- a/osu.Game/Online/Leaderboards/LeaderboardScoreTooltip.cs
+++ b/osu.Game/Online/Leaderboards/LeaderboardScoreTooltip.cs
@@ -10,7 +10,6 @@ using osuTK;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics;
 using osu.Framework.Allocation;
-using osu.Framework.Extensions.Color4Extensions;
 using osu.Game.Rulesets.Scoring;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.UI;
@@ -49,7 +48,7 @@ namespace osu.Game.Online.Leaderboards
                 },
                 new FillFlowContainer
                 {
-                    Margin = new MarginPadding(5f),
+                    Margin = new MarginPadding(5),
                     Spacing = new Vector2(10),
                     AutoSizeAxes = Axes.Both,
                     Direction = FillDirection.Vertical,
@@ -63,8 +62,10 @@ namespace osu.Game.Online.Leaderboards
                         // Mods row
                         modStatistics = new FillFlowContainer<ModCell>
                         {
-                            AutoSizeAxes = Axes.Both,
-                            Direction = FillDirection.Vertical,
+                            AutoSizeAxes = Axes.Y,
+                            RelativeSizeAxes = Axes.X,
+                            Direction = FillDirection.Full,
+                            Spacing = new Vector2(5, 0),
                         },
                         new FillFlowContainer
                         {
@@ -77,11 +78,13 @@ namespace osu.Game.Online.Leaderboards
                                 {
                                     AutoSizeAxes = Axes.Both,
                                     Direction = FillDirection.Horizontal,
+                                    Spacing = new Vector2(10, 0),
                                 },
                                 bottomScoreStatistics = new FillFlowContainer<HitResultCell>
                                 {
                                     AutoSizeAxes = Axes.Both,
                                     Direction = FillDirection.Horizontal,
+                                    Spacing = new Vector2(10, 0),
                                 },
                             }
                         },
@@ -133,7 +136,6 @@ namespace osu.Game.Online.Leaderboards
             public HitResultCell(HitResultDisplayStatistic stat)
             {
                 AutoSizeAxes = Axes.Both;
-                Padding = new MarginPadding { Horizontal = 5f };
 
                 displayName = stat.DisplayName;
                 result = stat.Result;
@@ -148,35 +150,17 @@ namespace osu.Game.Online.Leaderboards
                     Height = 12,
                     AutoSizeAxes = Axes.X,
                     Direction = FillDirection.Horizontal,
-                    Spacing = new Vector2(2f, 0f),
+                    Spacing = new Vector2(5f, 0f),
                     Children = new Drawable[]
                     {
-                        new CircularContainer
+                        new OsuSpriteText
                         {
-                            AutoSizeAxes = Axes.X,
-                            RelativeSizeAxes = Axes.Y,
-                            Masking = true,
-                            Children = new Drawable[]
-                            {
-                                new Box
-                                {
-                                    RelativeSizeAxes = Axes.Both,
-                                    Colour = Color4Extensions.FromHex("#222")
-                                },
-                                new OsuSpriteText
-                                {
-                                    Padding = new MarginPadding(2),
-                                    Anchor = Anchor.Centre,
-                                    Origin = Anchor.Centre,
-                                    Font = OsuFont.Torus.With(size: 12, weight: FontWeight.SemiBold),
-                                    Text = displayName.ToUpperInvariant(),
-                                    Colour = colours.ForHitResult(result),
-                                }
-                            }
+                            Font = OsuFont.Torus.With(size: 12, weight: FontWeight.SemiBold),
+                            Text = displayName.ToUpperInvariant(),
+                            Colour = colours.ForHitResult(result),
                         },
                         new OsuSpriteText
                         {
-                            RelativeSizeAxes = Axes.Y,
                             Font = OsuFont.GetFont(size: 12, weight: FontWeight.SemiBold),
                             Text = count.ToString(),
                         },
@@ -192,7 +176,6 @@ namespace osu.Game.Online.Leaderboards
             public ModCell(Mod mod)
             {
                 AutoSizeAxes = Axes.Both;
-                Padding = new MarginPadding { Horizontal = 5f };
                 this.mod = mod;
             }
 
@@ -228,6 +211,7 @@ namespace osu.Game.Online.Leaderboards
                         Text = mod.SettingDescription,
                         Origin = Anchor.CentreLeft,
                         Anchor = Anchor.CentreLeft,
+                        Margin = new MarginPadding { Top = 1 },
                     });
                 }
             }

From 3d7af805a3cd0905fef3bfc15544330d3bdcd912 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 1 Feb 2022 21:16:28 +0100
Subject: [PATCH 2703/5547] Fix `BeatmapMetadata` not using its user param
 correctly

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

diff --git a/osu.Game/Beatmaps/BeatmapMetadata.cs b/osu.Game/Beatmaps/BeatmapMetadata.cs
index 1514d3af7a..f6666a6ea9 100644
--- a/osu.Game/Beatmaps/BeatmapMetadata.cs
+++ b/osu.Game/Beatmaps/BeatmapMetadata.cs
@@ -46,7 +46,7 @@ namespace osu.Game.Beatmaps
 
         public BeatmapMetadata(RealmUser? user = null)
         {
-            Author = new RealmUser();
+            Author = user ?? new RealmUser();
         }
 
         [UsedImplicitly] // Realm

From a378e78ced3e0b5dfe6dafa3803060b1c9d118ad Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 1 Feb 2022 21:17:27 +0100
Subject: [PATCH 2704/5547] Fix `RealmLive` unnecessarily passing ID around

Appears to have never been needed. When the `retrieveFromID` method was
created in 81b5717ae793e334fdcf8efd72d20debfb49e9ca, it didn't use the
`id` parameter for anything either.
---
 osu.Game/Database/RealmLive.cs | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Database/RealmLive.cs b/osu.Game/Database/RealmLive.cs
index 186e801425..ecfececaa4 100644
--- a/osu.Game/Database/RealmLive.cs
+++ b/osu.Game/Database/RealmLive.cs
@@ -63,7 +63,7 @@ namespace osu.Game.Database
                     return;
                 }
 
-                perform(retrieveFromID(r, ID));
+                perform(retrieveFromID(r));
                 RealmLiveStatistics.USAGE_ASYNC.Value++;
             });
         }
@@ -85,7 +85,7 @@ namespace osu.Game.Database
 
             return realm.Run(r =>
             {
-                var returnData = perform(retrieveFromID(r, ID));
+                var returnData = perform(retrieveFromID(r));
                 RealmLiveStatistics.USAGE_ASYNC.Value++;
 
                 if (returnData is RealmObjectBase realmObject && realmObject.IsManaged)
@@ -139,11 +139,11 @@ namespace osu.Game.Database
             }
 
             dataIsFromUpdateThread = true;
-            data = retrieveFromID(realm.Realm, ID);
+            data = retrieveFromID(realm.Realm);
             RealmLiveStatistics.USAGE_UPDATE_REFETCH.Value++;
         }
 
-        private T retrieveFromID(Realm realm, Guid id)
+        private T retrieveFromID(Realm realm)
         {
             var found = realm.Find<T>(ID);
 

From 16e0cc6a2b393312f90da6320d6d9e4d00685e54 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 1 Feb 2022 21:20:59 +0100
Subject: [PATCH 2705/5547] Remove `IIpcHost` param from `ScoreManager`

No longer used since 3e3b9bc963583fa5f6ad3b822ad3e6e3818aa06c.
---
 osu.Game/OsuGameBase.cs          | 2 +-
 osu.Game/Scoring/ScoreManager.cs | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/OsuGameBase.cs b/osu.Game/OsuGameBase.cs
index 8363c41437..1713e73905 100644
--- a/osu.Game/OsuGameBase.cs
+++ b/osu.Game/OsuGameBase.cs
@@ -247,7 +247,7 @@ namespace osu.Game
             var defaultBeatmap = new DummyWorkingBeatmap(Audio, Textures);
 
             // ordering is important here to ensure foreign keys rules are not broken in ModelStore.Cleanup()
-            dependencies.Cache(ScoreManager = new ScoreManager(RulesetStore, () => BeatmapManager, Storage, realm, Scheduler, Host, () => difficultyCache, LocalConfig));
+            dependencies.Cache(ScoreManager = new ScoreManager(RulesetStore, () => BeatmapManager, Storage, realm, Scheduler, () => difficultyCache, LocalConfig));
             dependencies.Cache(BeatmapManager = new BeatmapManager(Storage, realm, RulesetStore, API, Audio, Resources, Host, defaultBeatmap, performOnlineLookups: true));
 
             dependencies.Cache(BeatmapDownloader = new BeatmapModelDownloader(BeatmapManager, API));
diff --git a/osu.Game/Scoring/ScoreManager.cs b/osu.Game/Scoring/ScoreManager.cs
index 6f9cce2d3c..532c6b42a3 100644
--- a/osu.Game/Scoring/ScoreManager.cs
+++ b/osu.Game/Scoring/ScoreManager.cs
@@ -32,7 +32,7 @@ namespace osu.Game.Scoring
         private readonly ScoreModelManager scoreModelManager;
 
         public ScoreManager(RulesetStore rulesets, Func<BeatmapManager> beatmaps, Storage storage, RealmAccess realm, Scheduler scheduler,
-                            IIpcHost importHost = null, Func<BeatmapDifficultyCache> difficulties = null, OsuConfigManager configManager = null)
+                            Func<BeatmapDifficultyCache> difficulties = null, OsuConfigManager configManager = null)
         {
             this.realm = realm;
             this.scheduler = scheduler;

From c6a65ccfeddc3dd190d38b0629fbb9efbd64fab9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 1 Feb 2022 21:22:22 +0100
Subject: [PATCH 2706/5547] Remove unused parameter from `createContent()`

No longer used since 513e470b525c4948d793555beb0df0928b3b9019.
---
 osu.Game/Screens/Edit/Timing/ControlPointTable.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/Edit/Timing/ControlPointTable.cs b/osu.Game/Screens/Edit/Timing/ControlPointTable.cs
index 1e6899e05f..0c12eff503 100644
--- a/osu.Game/Screens/Edit/Timing/ControlPointTable.cs
+++ b/osu.Game/Screens/Edit/Timing/ControlPointTable.cs
@@ -51,7 +51,7 @@ namespace osu.Game.Screens.Edit.Timing
                 }
 
                 Columns = createHeaders();
-                Content = value.Select((g, i) => createContent(i, g)).ToArray().ToRectangular();
+                Content = value.Select(createContent).ToArray().ToRectangular();
             }
         }
 
@@ -76,7 +76,7 @@ namespace osu.Game.Screens.Edit.Timing
             return columns.ToArray();
         }
 
-        private Drawable[] createContent(int index, ControlPointGroup group)
+        private Drawable[] createContent(ControlPointGroup group)
         {
             return new Drawable[]
             {

From 1fa2bf5d69f0c92755f9191acb4ae686b160fa9f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 1 Feb 2022 21:27:14 +0100
Subject: [PATCH 2707/5547] Remove unused parameter from `createColourBars()`

No longer used since b61aa660c63f0e126f32643ef17e7bb458d2a1ae.
---
 .../Screens/Play/HUD/HitErrorMeters/BarHitErrorMeter.cs    | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Screens/Play/HUD/HitErrorMeters/BarHitErrorMeter.cs b/osu.Game/Screens/Play/HUD/HitErrorMeters/BarHitErrorMeter.cs
index a8141c57da..7903e54960 100644
--- a/osu.Game/Screens/Play/HUD/HitErrorMeters/BarHitErrorMeter.cs
+++ b/osu.Game/Screens/Play/HUD/HitErrorMeters/BarHitErrorMeter.cs
@@ -10,7 +10,6 @@ using osu.Framework.Graphics.Colour;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Graphics.Sprites;
-using osu.Game.Graphics;
 using osu.Game.Rulesets.Judgements;
 using osu.Game.Rulesets.Scoring;
 using osuTK;
@@ -49,7 +48,7 @@ namespace osu.Game.Screens.Play.HUD.HitErrorMeters
         }
 
         [BackgroundDependencyLoader]
-        private void load(OsuColour colours)
+        private void load()
         {
             InternalChild = new FillFlowContainer
             {
@@ -127,7 +126,7 @@ namespace osu.Game.Screens.Play.HUD.HitErrorMeters
                 }
             };
 
-            createColourBars(colours);
+            createColourBars();
         }
 
         protected override void LoadComplete()
@@ -150,7 +149,7 @@ namespace osu.Game.Screens.Play.HUD.HitErrorMeters
             iconLate.Rotation = -Rotation;
         }
 
-        private void createColourBars(OsuColour colours)
+        private void createColourBars()
         {
             var windows = HitWindows.GetAllAvailableWindows().ToArray();
 

From a94702b3aeaac4b1dfe1e0adeb71140650bcaabd Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 1 Feb 2022 21:30:28 +0100
Subject: [PATCH 2708/5547] Remove unused parameters in `LegacyComboCounter`

No longer used since 9bb8a43bcee61d11f26598fff2228af1f07a4d17.
---
 osu.Game/Screens/Play/HUD/LegacyComboCounter.cs | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Screens/Play/HUD/LegacyComboCounter.cs b/osu.Game/Screens/Play/HUD/LegacyComboCounter.cs
index 567e4386c6..9510453ba5 100644
--- a/osu.Game/Screens/Play/HUD/LegacyComboCounter.cs
+++ b/osu.Game/Screens/Play/HUD/LegacyComboCounter.cs
@@ -109,7 +109,7 @@ namespace osu.Game.Screens.Play.HUD
                     return;
 
                 if (isRolling)
-                    onDisplayedCountRolling(displayedCount, value);
+                    onDisplayedCountRolling(value);
                 else if (displayedCount + 1 == value)
                     onDisplayedCountIncrement(value);
                 else
@@ -151,7 +151,7 @@ namespace osu.Game.Screens.Play.HUD
                 if (prev + 1 == Current.Value)
                     onCountIncrement(prev, Current.Value);
                 else
-                    onCountChange(prev, Current.Value);
+                    onCountChange(Current.Value);
             }
             else
             {
@@ -226,7 +226,7 @@ namespace osu.Game.Screens.Play.HUD
             transformRoll(currentValue, newValue);
         }
 
-        private void onCountChange(int currentValue, int newValue)
+        private void onCountChange(int newValue)
         {
             scheduledPopOutCurrentId++;
 
@@ -236,7 +236,7 @@ namespace osu.Game.Screens.Play.HUD
             DisplayedCount = newValue;
         }
 
-        private void onDisplayedCountRolling(int currentValue, int newValue)
+        private void onDisplayedCountRolling(int newValue)
         {
             if (newValue == 0)
                 displayedCountSpriteText.FadeOut(fade_out_duration);

From 07d09b3520210f1233cb024e8419548f342c4001 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 1 Feb 2022 21:32:58 +0100
Subject: [PATCH 2709/5547] Remove unused parameter from
 `createGameplayComponents()`

No longer used since 136843c8e450507ad0527622af851d648afb1545.
---
 osu.Game/Screens/Play/Player.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/Play/Player.cs b/osu.Game/Screens/Play/Player.cs
index 1556e752ab..240620b686 100644
--- a/osu.Game/Screens/Play/Player.cs
+++ b/osu.Game/Screens/Play/Player.cs
@@ -251,7 +251,7 @@ namespace osu.Game.Screens.Play
                     {
                         // underlay and gameplay should have access to the skinning sources.
                         createUnderlayComponents(),
-                        createGameplayComponents(Beatmap.Value, playableBeatmap)
+                        createGameplayComponents(Beatmap.Value)
                     }
                 },
                 FailOverlay = new FailOverlay
@@ -364,7 +364,7 @@ namespace osu.Game.Screens.Play
         private Drawable createUnderlayComponents() =>
             DimmableStoryboard = new DimmableStoryboard(Beatmap.Value.Storyboard) { RelativeSizeAxes = Axes.Both };
 
-        private Drawable createGameplayComponents(IWorkingBeatmap working, IBeatmap playableBeatmap) => new ScalingContainer(ScalingMode.Gameplay)
+        private Drawable createGameplayComponents(IWorkingBeatmap working) => new ScalingContainer(ScalingMode.Gameplay)
         {
             Children = new Drawable[]
             {

From 994fb966b6ba27baf7c178a7483ccf353db46fc3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 1 Feb 2022 21:37:19 +0100
Subject: [PATCH 2710/5547] Remove `Host` ctor param from `SkinModelManager`

No longer used since 29d074bdb8629ff480207498c0eeec61b010a530.
---
 osu.Game/Skinning/SkinManager.cs      | 2 +-
 osu.Game/Skinning/SkinModelManager.cs | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Skinning/SkinManager.cs b/osu.Game/Skinning/SkinManager.cs
index 06bd0abc9f..bad559d9fe 100644
--- a/osu.Game/Skinning/SkinManager.cs
+++ b/osu.Game/Skinning/SkinManager.cs
@@ -77,7 +77,7 @@ namespace osu.Game.Skinning
 
             userFiles = new StorageBackedResourceStore(storage.GetStorageForDirectory("files"));
 
-            skinModelManager = new SkinModelManager(storage, realm, host, this);
+            skinModelManager = new SkinModelManager(storage, realm, this);
 
             var defaultSkins = new[]
             {
diff --git a/osu.Game/Skinning/SkinModelManager.cs b/osu.Game/Skinning/SkinModelManager.cs
index 0af31100a9..33e49ce486 100644
--- a/osu.Game/Skinning/SkinModelManager.cs
+++ b/osu.Game/Skinning/SkinModelManager.cs
@@ -27,7 +27,7 @@ namespace osu.Game.Skinning
 
         private readonly IStorageResourceProvider skinResources;
 
-        public SkinModelManager(Storage storage, RealmAccess realm, GameHost host, IStorageResourceProvider skinResources)
+        public SkinModelManager(Storage storage, RealmAccess realm, IStorageResourceProvider skinResources)
             : base(storage, realm)
         {
             this.skinResources = skinResources;

From 75101b11052c2f02471a8fed6129f9d0e4d5eb76 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 1 Feb 2022 21:39:52 +0100
Subject: [PATCH 2711/5547] Remove unused ruleset ctor params from test beatmap
 model managers

No longer used since 00e3af3366e80214c7f0c956d144000a78cd0b56.
---
 .../Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs   | 4 ++--
 osu.Game/Tests/Visual/EditorTestScene.cs                      | 4 ++--
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs b/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
index f9161816e7..79cb424803 100644
--- a/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
+++ b/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
@@ -173,14 +173,14 @@ namespace osu.Game.Tests.Online
 
             protected override BeatmapModelManager CreateBeatmapModelManager(Storage storage, RealmAccess realm, RulesetStore rulesets, BeatmapOnlineLookupQueue onlineLookupQueue)
             {
-                return new TestBeatmapModelManager(this, storage, realm, rulesets, onlineLookupQueue);
+                return new TestBeatmapModelManager(this, storage, realm, onlineLookupQueue);
             }
 
             internal class TestBeatmapModelManager : BeatmapModelManager
             {
                 private readonly TestBeatmapManager testBeatmapManager;
 
-                public TestBeatmapModelManager(TestBeatmapManager testBeatmapManager, Storage storage, RealmAccess databaseAccess, RulesetStore rulesetStore, BeatmapOnlineLookupQueue beatmapOnlineLookupQueue)
+                public TestBeatmapModelManager(TestBeatmapManager testBeatmapManager, Storage storage, RealmAccess databaseAccess, BeatmapOnlineLookupQueue beatmapOnlineLookupQueue)
                     : base(databaseAccess, storage, beatmapOnlineLookupQueue)
                 {
                     this.testBeatmapManager = testBeatmapManager;
diff --git a/osu.Game/Tests/Visual/EditorTestScene.cs b/osu.Game/Tests/Visual/EditorTestScene.cs
index f7d62a8694..bcf169bb1e 100644
--- a/osu.Game/Tests/Visual/EditorTestScene.cs
+++ b/osu.Game/Tests/Visual/EditorTestScene.cs
@@ -126,7 +126,7 @@ namespace osu.Game.Tests.Visual
 
             protected override BeatmapModelManager CreateBeatmapModelManager(Storage storage, RealmAccess realm, RulesetStore rulesets, BeatmapOnlineLookupQueue onlineLookupQueue)
             {
-                return new TestBeatmapModelManager(storage, realm, rulesets, onlineLookupQueue);
+                return new TestBeatmapModelManager(storage, realm, onlineLookupQueue);
             }
 
             protected override WorkingBeatmapCache CreateWorkingBeatmapCache(AudioManager audioManager, IResourceStore<byte[]> resources, IResourceStore<byte[]> storage, WorkingBeatmap defaultBeatmap, GameHost host)
@@ -150,7 +150,7 @@ namespace osu.Game.Tests.Visual
 
             internal class TestBeatmapModelManager : BeatmapModelManager
             {
-                public TestBeatmapModelManager(Storage storage, RealmAccess databaseAccess, RulesetStore rulesetStore, BeatmapOnlineLookupQueue beatmapOnlineLookupQueue)
+                public TestBeatmapModelManager(Storage storage, RealmAccess databaseAccess, BeatmapOnlineLookupQueue beatmapOnlineLookupQueue)
                     : base(databaseAccess, storage, beatmapOnlineLookupQueue)
                 {
                 }

From e042f29ee3a12e60eb6d06165db93af1c37faf8c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 1 Feb 2022 21:41:18 +0100
Subject: [PATCH 2712/5547] Remove skin ctor param from
 `LegacyCatchComboCounter`

No longer used since 004798d61d44d88114acfd7c2861378261eab107.
---
 .../Skinning/Legacy/CatchLegacySkinTransformer.cs               | 2 +-
 .../Skinning/Legacy/LegacyCatchComboCounter.cs                  | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Rulesets.Catch/Skinning/Legacy/CatchLegacySkinTransformer.cs b/osu.Game.Rulesets.Catch/Skinning/Legacy/CatchLegacySkinTransformer.cs
index faad95e386..b2a555f89d 100644
--- a/osu.Game.Rulesets.Catch/Skinning/Legacy/CatchLegacySkinTransformer.cs
+++ b/osu.Game.Rulesets.Catch/Skinning/Legacy/CatchLegacySkinTransformer.cs
@@ -81,7 +81,7 @@ namespace osu.Game.Rulesets.Catch.Skinning.Legacy
 
                     case CatchSkinComponents.CatchComboCounter:
                         if (providesComboCounter)
-                            return new LegacyCatchComboCounter(Skin);
+                            return new LegacyCatchComboCounter();
 
                         return null;
 
diff --git a/osu.Game.Rulesets.Catch/Skinning/Legacy/LegacyCatchComboCounter.cs b/osu.Game.Rulesets.Catch/Skinning/Legacy/LegacyCatchComboCounter.cs
index 33c3867f5a..b4d29988d9 100644
--- a/osu.Game.Rulesets.Catch/Skinning/Legacy/LegacyCatchComboCounter.cs
+++ b/osu.Game.Rulesets.Catch/Skinning/Legacy/LegacyCatchComboCounter.cs
@@ -19,7 +19,7 @@ namespace osu.Game.Rulesets.Catch.Skinning.Legacy
 
         private readonly LegacyRollingCounter explosion;
 
-        public LegacyCatchComboCounter(ISkin skin)
+        public LegacyCatchComboCounter()
         {
             AutoSizeAxes = Axes.Both;
 

From e4028b8fc1b86df31a6882480797cf0094c0a027 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 1 Feb 2022 21:42:58 +0100
Subject: [PATCH 2713/5547] Remove index ctor param from `ColumnHitObjectArea`

No longer used since 5692cecaa47e9e071fb6079d9f3847b8b1de0972.
---
 .../Skinning/TestSceneColumnHitObjectArea.cs                  | 4 ++--
 osu.Game.Rulesets.Mania/UI/Column.cs                          | 2 +-
 osu.Game.Rulesets.Mania/UI/Components/ColumnHitObjectArea.cs  | 2 +-
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Rulesets.Mania.Tests/Skinning/TestSceneColumnHitObjectArea.cs b/osu.Game.Rulesets.Mania.Tests/Skinning/TestSceneColumnHitObjectArea.cs
index 215f8fb1d5..8034341d15 100644
--- a/osu.Game.Rulesets.Mania.Tests/Skinning/TestSceneColumnHitObjectArea.cs
+++ b/osu.Game.Rulesets.Mania.Tests/Skinning/TestSceneColumnHitObjectArea.cs
@@ -28,7 +28,7 @@ namespace osu.Game.Rulesets.Mania.Tests.Skinning
                     {
                         RelativeSizeAxes = Axes.Both,
                         Width = 0.5f,
-                        Child = new ColumnHitObjectArea(0, new HitObjectContainer())
+                        Child = new ColumnHitObjectArea(new HitObjectContainer())
                         {
                             RelativeSizeAxes = Axes.Both
                         }
@@ -37,7 +37,7 @@ namespace osu.Game.Rulesets.Mania.Tests.Skinning
                     {
                         RelativeSizeAxes = Axes.Both,
                         Width = 0.5f,
-                        Child = new ColumnHitObjectArea(1, new HitObjectContainer())
+                        Child = new ColumnHitObjectArea(new HitObjectContainer())
                         {
                             RelativeSizeAxes = Axes.Both
                         }
diff --git a/osu.Game.Rulesets.Mania/UI/Column.cs b/osu.Game.Rulesets.Mania/UI/Column.cs
index dc3b86ac7f..a04f5ef98e 100644
--- a/osu.Game.Rulesets.Mania/UI/Column.cs
+++ b/osu.Game.Rulesets.Mania/UI/Column.cs
@@ -62,7 +62,7 @@ namespace osu.Game.Rulesets.Mania.UI
                 sampleTriggerSource = new GameplaySampleTriggerSource(HitObjectContainer),
                 // For input purposes, the background is added at the highest depth, but is then proxied back below all other elements
                 background.CreateProxy(),
-                HitObjectArea = new ColumnHitObjectArea(Index, HitObjectContainer) { RelativeSizeAxes = Axes.Both },
+                HitObjectArea = new ColumnHitObjectArea(HitObjectContainer) { RelativeSizeAxes = Axes.Both },
                 new SkinnableDrawable(new ManiaSkinComponent(ManiaSkinComponents.KeyArea), _ => new DefaultKeyArea())
                 {
                     RelativeSizeAxes = Axes.Both
diff --git a/osu.Game.Rulesets.Mania/UI/Components/ColumnHitObjectArea.cs b/osu.Game.Rulesets.Mania/UI/Components/ColumnHitObjectArea.cs
index f69d2aafdc..51c138f5e1 100644
--- a/osu.Game.Rulesets.Mania/UI/Components/ColumnHitObjectArea.cs
+++ b/osu.Game.Rulesets.Mania/UI/Components/ColumnHitObjectArea.cs
@@ -17,7 +17,7 @@ namespace osu.Game.Rulesets.Mania.UI.Components
 
         private readonly Drawable hitTarget;
 
-        public ColumnHitObjectArea(int columnIndex, HitObjectContainer hitObjectContainer)
+        public ColumnHitObjectArea(HitObjectContainer hitObjectContainer)
             : base(hitObjectContainer)
         {
             AddRangeInternal(new[]

From 7cdf63c6543034a7517ec17949874d16bdd1b47f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 1 Feb 2022 21:44:59 +0100
Subject: [PATCH 2714/5547] Remove unused `FindProvider()` methods

No longer needed since 39f99bf785676c443f37248668eb9bf45006032e.
---
 osu.Game.Rulesets.Osu.Tests/TestSceneGameplayCursor.cs       | 1 -
 osu.Game.Tests/Gameplay/TestSceneHitObjectAccentColour.cs    | 2 --
 osu.Game.Tests/NonVisual/Skinning/LegacySkinAnimationTest.cs | 1 -
 osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableDrawable.cs | 4 ----
 4 files changed, 8 deletions(-)

diff --git a/osu.Game.Rulesets.Osu.Tests/TestSceneGameplayCursor.cs b/osu.Game.Rulesets.Osu.Tests/TestSceneGameplayCursor.cs
index 1f01ba601b..a36f07ff7b 100644
--- a/osu.Game.Rulesets.Osu.Tests/TestSceneGameplayCursor.cs
+++ b/osu.Game.Rulesets.Osu.Tests/TestSceneGameplayCursor.cs
@@ -118,7 +118,6 @@ namespace osu.Game.Rulesets.Osu.Tests
             public Drawable GetDrawableComponent(ISkinComponent component) => null;
             public Texture GetTexture(string componentName, WrapMode wrapModeS, WrapMode wrapModeT) => null;
             public ISample GetSample(ISampleInfo sampleInfo) => null;
-            public ISkin FindProvider(Func<ISkin, bool> lookupFunction) => null;
 
             public IBindable<TValue> GetConfig<TLookup, TValue>(TLookup lookup)
             {
diff --git a/osu.Game.Tests/Gameplay/TestSceneHitObjectAccentColour.cs b/osu.Game.Tests/Gameplay/TestSceneHitObjectAccentColour.cs
index 34f70659e3..5553c67141 100644
--- a/osu.Game.Tests/Gameplay/TestSceneHitObjectAccentColour.cs
+++ b/osu.Game.Tests/Gameplay/TestSceneHitObjectAccentColour.cs
@@ -131,8 +131,6 @@ namespace osu.Game.Tests.Gameplay
 
             public ISample GetSample(ISampleInfo sampleInfo) => throw new NotImplementedException();
 
-            public ISkin FindProvider(Func<ISkin, bool> lookupFunction) => null;
-
             public IBindable<TValue> GetConfig<TLookup, TValue>(TLookup lookup)
             {
                 switch (lookup)
diff --git a/osu.Game.Tests/NonVisual/Skinning/LegacySkinAnimationTest.cs b/osu.Game.Tests/NonVisual/Skinning/LegacySkinAnimationTest.cs
index 785f31386d..4209f188cc 100644
--- a/osu.Game.Tests/NonVisual/Skinning/LegacySkinAnimationTest.cs
+++ b/osu.Game.Tests/NonVisual/Skinning/LegacySkinAnimationTest.cs
@@ -61,7 +61,6 @@ namespace osu.Game.Tests.NonVisual.Skinning
             public Drawable GetDrawableComponent(ISkinComponent component) => throw new NotSupportedException();
             public ISample GetSample(ISampleInfo sampleInfo) => throw new NotSupportedException();
             public IBindable<TValue> GetConfig<TLookup, TValue>(TLookup lookup) => throw new NotSupportedException();
-            public ISkin FindProvider(Func<ISkin, bool> lookupFunction) => null;
         }
 
         private class TestAnimationTimeReference : IAnimationTimeReference
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableDrawable.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableDrawable.cs
index 3e8ba69e01..35130f3109 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableDrawable.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableDrawable.cs
@@ -301,8 +301,6 @@ namespace osu.Game.Tests.Visual.Gameplay
             public ISample GetSample(ISampleInfo sampleInfo) => throw new NotImplementedException();
 
             public IBindable<TValue> GetConfig<TLookup, TValue>(TLookup lookup) => throw new NotImplementedException();
-
-            public ISkin FindProvider(Func<ISkin, bool> lookupFunction) => throw new NotImplementedException();
         }
 
         private class SecondarySource : ISkin
@@ -314,8 +312,6 @@ namespace osu.Game.Tests.Visual.Gameplay
             public ISample GetSample(ISampleInfo sampleInfo) => throw new NotImplementedException();
 
             public IBindable<TValue> GetConfig<TLookup, TValue>(TLookup lookup) => throw new NotImplementedException();
-
-            public ISkin FindProvider(Func<ISkin, bool> lookupFunction) => throw new NotImplementedException();
         }
 
         [Cached(typeof(ISkinSource))]

From b978010b481fd8e46a7b0448b813a3e547d375ce Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 1 Feb 2022 21:47:55 +0100
Subject: [PATCH 2715/5547] Remove unused `allowMissing` parameter in audio
 file check test

No longer used since 7f95400f466beafe6fa94c002cfd6ed8dc3f4f94.
---
 .../Editing/Checks/CheckTooShortAudioFilesTest.cs           | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Tests/Editing/Checks/CheckTooShortAudioFilesTest.cs b/osu.Game.Tests/Editing/Checks/CheckTooShortAudioFilesTest.cs
index 242fec2f68..53c85defae 100644
--- a/osu.Game.Tests/Editing/Checks/CheckTooShortAudioFilesTest.cs
+++ b/osu.Game.Tests/Editing/Checks/CheckTooShortAudioFilesTest.cs
@@ -52,7 +52,7 @@ namespace osu.Game.Tests.Editing.Checks
             beatmap.BeatmapInfo.BeatmapSet.Files.Add(CheckTestHelpers.CreateMockFile("jpg"));
 
             // Should fail to load, but not produce an error due to the extension not being expected to load.
-            Assert.IsEmpty(check.Run(getContext(null, allowMissing: true)));
+            Assert.IsEmpty(check.Run(getContext(null)));
         }
 
         [Test]
@@ -91,7 +91,7 @@ namespace osu.Game.Tests.Editing.Checks
         {
             using (var resourceStream = TestResources.OpenResource("Samples/missing.mp3"))
             {
-                Assert.IsEmpty(check.Run(getContext(resourceStream, allowMissing: true)));
+                Assert.IsEmpty(check.Run(getContext(resourceStream)));
             }
         }
 
@@ -107,7 +107,7 @@ namespace osu.Game.Tests.Editing.Checks
             }
         }
 
-        private BeatmapVerifierContext getContext(Stream resourceStream, bool allowMissing = false)
+        private BeatmapVerifierContext getContext(Stream resourceStream)
         {
             var mockWorkingBeatmap = new Mock<TestWorkingBeatmap>(beatmap, null, null);
             mockWorkingBeatmap.Setup(w => w.GetStream(It.IsAny<string>())).Returns(resourceStream);

From 3674ed15ce7cc4e5b0e50303e04db4af6eba3164 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 1 Feb 2022 21:52:16 +0100
Subject: [PATCH 2716/5547] Remove unused game host parameter

No longer used since eeccf836ec04d2e3aac1fec93c15b48aa6672352.
---
 .../Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs   | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs b/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
index 79cb424803..94e61eaee0 100644
--- a/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
+++ b/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
@@ -47,7 +47,7 @@ namespace osu.Game.Tests.Online
         {
             Dependencies.Cache(rulesets = new RulesetStore(Realm));
             Dependencies.CacheAs<BeatmapManager>(beatmaps = new TestBeatmapManager(LocalStorage, Realm, rulesets, API, audio, Resources, host, Beatmap.Default));
-            Dependencies.CacheAs<BeatmapModelDownloader>(beatmapDownloader = new TestBeatmapModelDownloader(beatmaps, API, host));
+            Dependencies.CacheAs<BeatmapModelDownloader>(beatmapDownloader = new TestBeatmapModelDownloader(beatmaps, API));
         }
 
         [SetUp]
@@ -196,7 +196,7 @@ namespace osu.Game.Tests.Online
 
         internal class TestBeatmapModelDownloader : BeatmapModelDownloader
         {
-            public TestBeatmapModelDownloader(IModelImporter<BeatmapSetInfo> importer, IAPIProvider apiProvider, GameHost gameHost)
+            public TestBeatmapModelDownloader(IModelImporter<BeatmapSetInfo> importer, IAPIProvider apiProvider)
                 : base(importer, apiProvider)
             {
             }

From 35b76532903254b3ea434f7fccf9ef95d07be72c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 2 Feb 2022 09:13:19 +0900
Subject: [PATCH 2717/5547] Revert mod flow changes and add visual test
 coverage showing an overflow case

---
 .../Visual/SongSelect/TestSceneBeatmapLeaderboard.cs | 12 +++++++-----
 .../Online/Leaderboards/LeaderboardScoreTooltip.cs   |  5 ++---
 2 files changed, 9 insertions(+), 8 deletions(-)

diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
index 7292ec96ed..667fd08084 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
@@ -203,14 +203,16 @@ namespace osu.Game.Tests.Visual.SongSelect
                         new OsuModHardRock(),
                         new OsuModFlashlight
                         {
-                            FollowDelay = { Value = 200 }
+                            FollowDelay = { Value = 200 },
+                            SizeMultiplier = { Value = 5 },
                         },
                         new OsuModDifficultyAdjust
                         {
-                            CircleSize = { Value = 8 },
-                            ApproachRate = { Value = 7 },
-                            OverallDifficulty = { Value = 6 },
-                            DrainRate = { Value = 5 },
+                            CircleSize = { Value = 11 },
+                            ApproachRate = { Value = 10 },
+                            OverallDifficulty = { Value = 10 },
+                            DrainRate = { Value = 10 },
+                            ExtendedLimits = { Value = true }
                         }
                     },
                     Ruleset = new OsuRuleset().RulesetInfo,
diff --git a/osu.Game/Online/Leaderboards/LeaderboardScoreTooltip.cs b/osu.Game/Online/Leaderboards/LeaderboardScoreTooltip.cs
index a0eea94501..c26e9e6802 100644
--- a/osu.Game/Online/Leaderboards/LeaderboardScoreTooltip.cs
+++ b/osu.Game/Online/Leaderboards/LeaderboardScoreTooltip.cs
@@ -62,9 +62,8 @@ namespace osu.Game.Online.Leaderboards
                         // Mods row
                         modStatistics = new FillFlowContainer<ModCell>
                         {
-                            AutoSizeAxes = Axes.Y,
-                            RelativeSizeAxes = Axes.X,
-                            Direction = FillDirection.Full,
+                            AutoSizeAxes = Axes.Both,
+                            Direction = FillDirection.Vertical,
                             Spacing = new Vector2(5, 0),
                         },
                         new FillFlowContainer

From b4fd1ecba20a10858a1219beddabf8122517fa22 Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Wed, 2 Feb 2022 11:02:01 +0800
Subject: [PATCH 2718/5547] Hide attribute if the maximum is 0

---
 .../Statistics/PerformanceStatisticTooltip.cs        | 12 +++++++-----
 1 file changed, 7 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatisticTooltip.cs b/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatisticTooltip.cs
index 739fac9d63..bd6eb057c6 100644
--- a/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatisticTooltip.cs
+++ b/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatisticTooltip.cs
@@ -137,8 +137,7 @@ namespace osu.Game.Screens.Ranking.Expanded.Statistics
         {
             float percentage = (float)(attribute.Value / perfectAttribute.Value);
             if (float.IsNaN(percentage))
-                percentage = 0;
-            string text = percentage.ToLocalisableString("0%").ToString();
+                return null;
 
             return new GridContainer
             {
@@ -181,7 +180,7 @@ namespace osu.Game.Screens.Ranking.Expanded.Statistics
                             Origin = Anchor.CentreLeft,
                             Anchor = Anchor.CentreLeft,
                             Font = OsuFont.GetFont(weight: FontWeight.SemiBold),
-                            Text = text,
+                            Text = percentage.ToLocalisableString("0%"),
                             Colour = textColour
                         }
                     }
@@ -199,9 +198,12 @@ namespace osu.Game.Screens.Ranking.Expanded.Statistics
 
             foreach (PerformanceDisplayAttribute attr in displayAttributes)
             {
-                Content.Add(attr.PropertyName == nameof(PerformanceAttributes.Total)
+                var attributeItem = attr.PropertyName == nameof(PerformanceAttributes.Total)
                     ? createItemForTotal(attr, perfectDisplayAttributes.First(a => a.PropertyName == attr.PropertyName))
-                    : createItemForAttribute(attr, perfectDisplayAttributes.First(a => a.PropertyName == attr.PropertyName)));
+                    : createItemForAttribute(attr, perfectDisplayAttributes.First(a => a.PropertyName == attr.PropertyName));
+
+                if (attributeItem != null)
+                    Content.Add(attributeItem);
             }
         }
 

From d065e32ca1f8c77b361593016bedf0487540fcff Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 2 Feb 2022 13:23:49 +0900
Subject: [PATCH 2719/5547] Fix crash due to `MatchLeaderboardScore`s not
 having populated rulesets

---
 osu.Game/Online/Leaderboards/LeaderboardScore.cs                | 2 +-
 .../OnlinePlay/Match/Components/MatchLeaderboardScore.cs        | 2 ++
 2 files changed, 3 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Online/Leaderboards/LeaderboardScore.cs b/osu.Game/Online/Leaderboards/LeaderboardScore.cs
index b4aaebd4e4..c2393a5de5 100644
--- a/osu.Game/Online/Leaderboards/LeaderboardScore.cs
+++ b/osu.Game/Online/Leaderboards/LeaderboardScore.cs
@@ -71,7 +71,7 @@ namespace osu.Game.Online.Leaderboards
         private Storage storage { get; set; }
 
         public ITooltip<ScoreInfo> GetCustomTooltip() => new LeaderboardScoreTooltip();
-        public ScoreInfo TooltipContent => Score;
+        public virtual ScoreInfo TooltipContent => Score;
 
         public LeaderboardScore(ScoreInfo score, int? rank, bool isOnlineScope = true)
         {
diff --git a/osu.Game/Screens/OnlinePlay/Match/Components/MatchLeaderboardScore.cs b/osu.Game/Screens/OnlinePlay/Match/Components/MatchLeaderboardScore.cs
index 799c44cc28..cf7e33fd63 100644
--- a/osu.Game/Screens/OnlinePlay/Match/Components/MatchLeaderboardScore.cs
+++ b/osu.Game/Screens/OnlinePlay/Match/Components/MatchLeaderboardScore.cs
@@ -14,6 +14,8 @@ namespace osu.Game.Screens.OnlinePlay.Match.Components
     {
         private readonly APIUserScoreAggregate score;
 
+        public override ScoreInfo TooltipContent => null; // match aggregate scores can't show statistics that the custom tooltip displays.
+
         public MatchLeaderboardScore(APIUserScoreAggregate score, int? rank, bool isOnlineScope = true)
             : base(score.CreateScoreInfo(), rank, isOnlineScope)
         {

From ddc8094a75babd5fad94ea8b692b8e12a899c461 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 2 Feb 2022 13:34:23 +0900
Subject: [PATCH 2720/5547] Update description

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

diff --git a/osu.Game.Rulesets.Mania/Mods/ManiaModHoldOff.cs b/osu.Game.Rulesets.Mania/Mods/ManiaModHoldOff.cs
index 6e942f672b..a65938184c 100644
--- a/osu.Game.Rulesets.Mania/Mods/ManiaModHoldOff.cs
+++ b/osu.Game.Rulesets.Mania/Mods/ManiaModHoldOff.cs
@@ -20,7 +20,7 @@ namespace osu.Game.Rulesets.Mania.Mods
 
         public override double ScoreMultiplier => 1;
 
-        public override string Description => @"Turns all hold notes into normal notes. No coordination required.";
+        public override string Description => @"Replaces all hold notes with normal notes.";
 
         public override IconUsage? Icon => FontAwesome.Solid.DotCircle;
 

From 0036d0e26db709f1661e3cff89364ccb7c6f94b5 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 2 Feb 2022 13:58:13 +0900
Subject: [PATCH 2721/5547] Move alternate mod to "conversion" category

---
 osu.Game.Rulesets.Osu/Mods/OsuModAlternate.cs | 2 +-
 osu.Game.Rulesets.Osu/OsuRuleset.cs           | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModAlternate.cs b/osu.Game.Rulesets.Osu/Mods/OsuModAlternate.cs
index f68f2b5bee..936bb290b4 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModAlternate.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModAlternate.cs
@@ -23,7 +23,7 @@ namespace osu.Game.Rulesets.Osu.Mods
         public override string Description => @"Don't use the same key twice in a row!";
         public override double ScoreMultiplier => 1.0;
         public override Type[] IncompatibleMods => new[] { typeof(ModAutoplay) };
-        public override ModType Type => ModType.DifficultyIncrease;
+        public override ModType Type => ModType.Conversion;
         public override IconUsage? Icon => FontAwesome.Solid.Keyboard;
 
         private bool introEnded;
diff --git a/osu.Game.Rulesets.Osu/OsuRuleset.cs b/osu.Game.Rulesets.Osu/OsuRuleset.cs
index 7e8974b5ed..2faecbcda2 100644
--- a/osu.Game.Rulesets.Osu/OsuRuleset.cs
+++ b/osu.Game.Rulesets.Osu/OsuRuleset.cs
@@ -159,7 +159,6 @@ namespace osu.Game.Rulesets.Osu
                         new MultiMod(new OsuModDoubleTime(), new OsuModNightcore()),
                         new OsuModHidden(),
                         new MultiMod(new OsuModFlashlight(), new OsuModBlinds()),
-                        new OsuModAlternate(),
                     };
 
                 case ModType.Conversion:
@@ -170,6 +169,7 @@ namespace osu.Game.Rulesets.Osu
                         new OsuModClassic(),
                         new OsuModRandom(),
                         new OsuModMirror(),
+                        new OsuModAlternate(),
                     };
 
                 case ModType.Automation:

From fed63abd83715cf1f904a53038999b7625e41f4f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 2 Feb 2022 14:02:48 +0900
Subject: [PATCH 2722/5547] Sanitise interceptor logic to now require two
 separate check paths

---
 osu.Game.Rulesets.Osu/Mods/OsuModAlternate.cs | 21 ++++++++++++-------
 1 file changed, 13 insertions(+), 8 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModAlternate.cs b/osu.Game.Rulesets.Osu/Mods/OsuModAlternate.cs
index 936bb290b4..9d389432e5 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModAlternate.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModAlternate.cs
@@ -33,8 +33,6 @@ namespace osu.Game.Rulesets.Osu.Mods
         private OsuAction? lastActionPressed;
         private DrawableRuleset<OsuHitObject> ruleset;
 
-        private bool shouldAlternate => !isBreakTime.Value && introEnded;
-
         public void ApplyToDrawableRuleset(DrawableRuleset<OsuHitObject> drawableRuleset)
         {
             ruleset = drawableRuleset;
@@ -54,16 +52,22 @@ namespace osu.Game.Rulesets.Osu.Mods
             };
         }
 
-        private bool onPressed(OsuAction key)
+        private bool checkCorrectAction(OsuAction action)
         {
-            if (lastActionPressed == key)
+            if (isBreakTime.Value)
+                return true;
+
+            if (!introEnded)
+                return true;
+
+            if (lastActionPressed != action)
             {
-                ruleset.Cursor.FlashColour(Colour4.Red, flash_duration, Easing.OutQuint);
+                // User alternated correctly
+                lastActionPressed = action;
                 return true;
             }
 
-            lastActionPressed = key;
-
+            ruleset.Cursor.FlashColour(Colour4.Red, flash_duration, Easing.OutQuint);
             return false;
         }
 
@@ -83,7 +87,8 @@ namespace osu.Game.Rulesets.Osu.Mods
             }
 
             public bool OnPressed(KeyBindingPressEvent<OsuAction> e)
-                => mod.shouldAlternate && mod.onPressed(e.Action);
+                // if the pressed action is incorrect, block it from reaching gameplay.
+                => !mod.checkCorrectAction(e.Action);
 
             public void OnReleased(KeyBindingReleaseEvent<OsuAction> e)
             {

From c7a192cc5fae75bca23b5a714d6ff2fde49b6bbf Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 2 Feb 2022 14:04:10 +0900
Subject: [PATCH 2723/5547] Only handle `LeftButton` and `RightButton` actions

There are definitely going to be other actions used in the future, which
would immediately cause this mod to fail. Limiting handling to
left/right buttons only is the correct way forward.
---
 osu.Game.Rulesets.Osu/Mods/OsuModAlternate.cs | 13 ++++++++++++-
 1 file changed, 12 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModAlternate.cs b/osu.Game.Rulesets.Osu/Mods/OsuModAlternate.cs
index 9d389432e5..b9f25bd1cf 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModAlternate.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModAlternate.cs
@@ -60,9 +60,20 @@ namespace osu.Game.Rulesets.Osu.Mods
             if (!introEnded)
                 return true;
 
+            switch (action)
+            {
+                case OsuAction.LeftButton:
+                case OsuAction.RightButton:
+                    break;
+
+                // Any action which is not left or right button should be ignored.
+                default:
+                    return true;
+            }
+
             if (lastActionPressed != action)
             {
-                // User alternated correctly
+                // User alternated correctly.
                 lastActionPressed = action;
                 return true;
             }

From c5c4c85006ffd4a34e05ba33d6e81bb9acf8acc8 Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Wed, 2 Feb 2022 13:29:18 +0800
Subject: [PATCH 2724/5547] Lazily create content of StatisticItem

---
 osu.Game.Rulesets.Mania/ManiaRuleset.cs       | 22 +++++++++-------
 osu.Game.Rulesets.Osu/OsuRuleset.cs           | 25 +++++++++++--------
 osu.Game.Rulesets.Taiko/TaikoRuleset.cs       | 22 +++++++++-------
 .../Ranking/Statistics/StatisticContainer.cs  |  2 +-
 .../Ranking/Statistics/StatisticItem.cs       | 12 +++++++--
 .../Ranking/Statistics/StatisticsPanel.cs     | 10 +++++---
 6 files changed, 59 insertions(+), 34 deletions(-)

diff --git a/osu.Game.Rulesets.Mania/ManiaRuleset.cs b/osu.Game.Rulesets.Mania/ManiaRuleset.cs
index 2098c7f5d8..8ac8001457 100644
--- a/osu.Game.Rulesets.Mania/ManiaRuleset.cs
+++ b/osu.Game.Rulesets.Mania/ManiaRuleset.cs
@@ -370,21 +370,25 @@ namespace osu.Game.Rulesets.Mania
             {
                 Columns = new[]
                 {
-                    new StatisticItem("Timing Distribution", new HitEventTimingDistributionGraph(score.HitEvents)
-                    {
-                        RelativeSizeAxes = Axes.X,
-                        Height = 250
-                    }),
+                    new StatisticItem("Timing Distribution",
+                        true,
+                        () => new HitEventTimingDistributionGraph(score.HitEvents)
+                        {
+                            RelativeSizeAxes = Axes.X,
+                            Height = 250
+                        }),
                 }
             },
             new StatisticRow
             {
                 Columns = new[]
                 {
-                    new StatisticItem(string.Empty, new SimpleStatisticTable(3, new SimpleStatisticItem[]
-                    {
-                        new UnstableRate(score.HitEvents)
-                    }))
+                    new StatisticItem(string.Empty,
+                        true,
+                        () => new SimpleStatisticTable(3, new SimpleStatisticItem[]
+                        {
+                            new UnstableRate(score.HitEvents)
+                        }))
                 }
             }
         };
diff --git a/osu.Game.Rulesets.Osu/OsuRuleset.cs b/osu.Game.Rulesets.Osu/OsuRuleset.cs
index 18e4bb259c..b6f417b7fe 100644
--- a/osu.Game.Rulesets.Osu/OsuRuleset.cs
+++ b/osu.Game.Rulesets.Osu/OsuRuleset.cs
@@ -278,7 +278,8 @@ namespace osu.Game.Rulesets.Osu
                     Columns = new[]
                     {
                         new StatisticItem("Timing Distribution",
-                            new HitEventTimingDistributionGraph(timedHitEvents)
+                            true,
+                            () => new HitEventTimingDistributionGraph(timedHitEvents)
                             {
                                 RelativeSizeAxes = Axes.X,
                                 Height = 250
@@ -289,21 +290,25 @@ namespace osu.Game.Rulesets.Osu
                 {
                     Columns = new[]
                     {
-                        new StatisticItem("Accuracy Heatmap", new AccuracyHeatmap(score, playableBeatmap)
-                        {
-                            RelativeSizeAxes = Axes.X,
-                            Height = 250
-                        }),
+                        new StatisticItem("Accuracy Heatmap",
+                            true,
+                            () => new AccuracyHeatmap(score, playableBeatmap)
+                            {
+                                RelativeSizeAxes = Axes.X,
+                                Height = 250
+                            }),
                     }
                 },
                 new StatisticRow
                 {
                     Columns = new[]
                     {
-                        new StatisticItem(string.Empty, new SimpleStatisticTable(3, new SimpleStatisticItem[]
-                        {
-                            new UnstableRate(timedHitEvents)
-                        }))
+                        new StatisticItem(string.Empty,
+                            true,
+                            () => new SimpleStatisticTable(3, new SimpleStatisticItem[]
+                            {
+                                new UnstableRate(timedHitEvents)
+                            }))
                     }
                 }
             };
diff --git a/osu.Game.Rulesets.Taiko/TaikoRuleset.cs b/osu.Game.Rulesets.Taiko/TaikoRuleset.cs
index ca860f24c3..2a64b8dddd 100644
--- a/osu.Game.Rulesets.Taiko/TaikoRuleset.cs
+++ b/osu.Game.Rulesets.Taiko/TaikoRuleset.cs
@@ -213,21 +213,25 @@ namespace osu.Game.Rulesets.Taiko
                 {
                     Columns = new[]
                     {
-                        new StatisticItem("Timing Distribution", new HitEventTimingDistributionGraph(timedHitEvents)
-                        {
-                            RelativeSizeAxes = Axes.X,
-                            Height = 250
-                        }),
+                        new StatisticItem("Timing Distribution",
+                            true,
+                            () => new HitEventTimingDistributionGraph(timedHitEvents)
+                            {
+                                RelativeSizeAxes = Axes.X,
+                                Height = 250
+                            }),
                     }
                 },
                 new StatisticRow
                 {
                     Columns = new[]
                     {
-                        new StatisticItem(string.Empty, new SimpleStatisticTable(3, new SimpleStatisticItem[]
-                        {
-                            new UnstableRate(timedHitEvents)
-                        }))
+                        new StatisticItem(string.Empty,
+                            true,
+                            () => new SimpleStatisticTable(3, new SimpleStatisticItem[]
+                            {
+                                new UnstableRate(timedHitEvents)
+                            }))
                     }
                 }
             };
diff --git a/osu.Game/Screens/Ranking/Statistics/StatisticContainer.cs b/osu.Game/Screens/Ranking/Statistics/StatisticContainer.cs
index 485d24d024..f3bd2c6fc1 100644
--- a/osu.Game/Screens/Ranking/Statistics/StatisticContainer.cs
+++ b/osu.Game/Screens/Ranking/Statistics/StatisticContainer.cs
@@ -43,7 +43,7 @@ namespace osu.Game.Screens.Ranking.Statistics
                             RelativeSizeAxes = Axes.X,
                             AutoSizeAxes = Axes.Y,
                             Margin = new MarginPadding { Top = 15 },
-                            Child = item.Content
+                            Child = item.Content()
                         }
                     },
                 },
diff --git a/osu.Game/Screens/Ranking/Statistics/StatisticItem.cs b/osu.Game/Screens/Ranking/Statistics/StatisticItem.cs
index 4903983759..5e6ddf445b 100644
--- a/osu.Game/Screens/Ranking/Statistics/StatisticItem.cs
+++ b/osu.Game/Screens/Ranking/Statistics/StatisticItem.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 JetBrains.Annotations;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
@@ -20,22 +21,29 @@ namespace osu.Game.Screens.Ranking.Statistics
         /// <summary>
         /// The <see cref="Drawable"/> content to be displayed.
         /// </summary>
-        public readonly Drawable Content;
+        public readonly Func<Drawable> Content;
 
         /// <summary>
         /// The <see cref="Dimension"/> of this row. This can be thought of as the column dimension of an encompassing <see cref="GridContainer"/>.
         /// </summary>
         public readonly Dimension Dimension;
 
+        /// <summary>
+        /// Whether this item requires hit events. If true, the <see cref="Content"/> will not be created if no hit events are available.
+        /// </summary>
+        public readonly bool RequiresHitEvents;
+
         /// <summary>
         /// Creates a new <see cref="StatisticItem"/>, to be displayed inside a <see cref="StatisticRow"/> in the results screen.
         /// </summary>
         /// <param name="name">The name of the item. Can be <see cref="string.Empty"/> to hide the item header.</param>
+        /// <param name="requiresHitEvents">Whether this item requires hit events. If true, the <see cref="Content"/> will not be created if no hit events are available.</param>
         /// <param name="content">The <see cref="Drawable"/> content to be displayed.</param>
         /// <param name="dimension">The <see cref="Dimension"/> of this item. This can be thought of as the column dimension of an encompassing <see cref="GridContainer"/>.</param>
-        public StatisticItem([NotNull] string name, [NotNull] Drawable content, [CanBeNull] Dimension dimension = null)
+        public StatisticItem([NotNull] string name, bool requiresHitEvents, [NotNull] Func<Drawable> content, [CanBeNull] Dimension dimension = null)
         {
             Name = name;
+            RequiresHitEvents = requiresHitEvents;
             Content = content;
             Dimension = dimension;
         }
diff --git a/osu.Game/Screens/Ranking/Statistics/StatisticsPanel.cs b/osu.Game/Screens/Ranking/Statistics/StatisticsPanel.cs
index 567a2307dd..14cdfe2f03 100644
--- a/osu.Game/Screens/Ranking/Statistics/StatisticsPanel.cs
+++ b/osu.Game/Screens/Ranking/Statistics/StatisticsPanel.cs
@@ -118,6 +118,10 @@ namespace osu.Game.Screens.Ranking.Statistics
 
                     foreach (var row in newScore.Ruleset.CreateInstance().CreateStatisticsForScore(newScore, playableBeatmap))
                     {
+                        var columnsToDisplay = newScore.HitEvents.Count == 0
+                            ? row.Columns?.Where(c => !c.RequiresHitEvents).ToArray()
+                            : row.Columns;
+
                         rows.Add(new GridContainer
                         {
                             Anchor = Anchor.TopCentre,
@@ -126,14 +130,14 @@ namespace osu.Game.Screens.Ranking.Statistics
                             AutoSizeAxes = Axes.Y,
                             Content = new[]
                             {
-                                row.Columns?.Select(c => new StatisticContainer(c)
+                                columnsToDisplay?.Select(c => new StatisticContainer(c)
                                 {
                                     Anchor = Anchor.Centre,
                                     Origin = Anchor.Centre,
                                 }).Cast<Drawable>().ToArray()
                             },
-                            ColumnDimensions = Enumerable.Range(0, row.Columns?.Length ?? 0)
-                                                         .Select(i => row.Columns[i].Dimension ?? new Dimension()).ToArray(),
+                            ColumnDimensions = Enumerable.Range(0, columnsToDisplay?.Length ?? 0)
+                                                         .Select(i => columnsToDisplay?[i].Dimension ?? new Dimension()).ToArray(),
                             RowDimensions = new[] { new Dimension(GridSizeMode.AutoSize) }
                         });
                     }

From a2affefb0aa8ca794ff329a1a7e65e3502450f35 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 2 Feb 2022 14:33:17 +0900
Subject: [PATCH 2725/5547] Avoid checking gameplay clock time in `Update`
 method

---
 osu.Game.Rulesets.Osu/Mods/OsuModAlternate.cs | 19 ++++++++-----------
 1 file changed, 8 insertions(+), 11 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModAlternate.cs b/osu.Game.Rulesets.Osu/Mods/OsuModAlternate.cs
index b9f25bd1cf..46b97dd23b 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModAlternate.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModAlternate.cs
@@ -16,7 +16,7 @@ using osu.Game.Screens.Play;
 
 namespace osu.Game.Rulesets.Osu.Mods
 {
-    public class OsuModAlternate : Mod, IApplicableToDrawableRuleset<OsuHitObject>, IApplicableToPlayer, IUpdatableByPlayfield
+    public class OsuModAlternate : Mod, IApplicableToDrawableRuleset<OsuHitObject>, IApplicableToPlayer
     {
         public override string Name => @"Alternate";
         public override string Acronym => @"AL";
@@ -26,20 +26,23 @@ namespace osu.Game.Rulesets.Osu.Mods
         public override ModType Type => ModType.Conversion;
         public override IconUsage? Icon => FontAwesome.Solid.Keyboard;
 
-        private bool introEnded;
-        private double earliestStartTime;
+        private double firstObjectValidJudgementTime;
         private IBindable<bool> isBreakTime;
         private const double flash_duration = 1000;
         private OsuAction? lastActionPressed;
         private DrawableRuleset<OsuHitObject> ruleset;
 
+        private IFrameStableClock gameplayClock;
+
         public void ApplyToDrawableRuleset(DrawableRuleset<OsuHitObject> drawableRuleset)
         {
             ruleset = drawableRuleset;
             drawableRuleset.KeyBindingInputManager.Add(new InputInterceptor(this));
 
             var firstHitObject = ruleset.Objects.FirstOrDefault();
-            earliestStartTime = (firstHitObject?.StartTime ?? 0) - (firstHitObject?.HitWindows.WindowFor(HitResult.Meh) ?? 0);
+            firstObjectValidJudgementTime = (firstHitObject?.StartTime ?? 0) - (firstHitObject?.HitWindows.WindowFor(HitResult.Meh) ?? 0);
+
+            gameplayClock = drawableRuleset.FrameStableClock;
         }
 
         public void ApplyToPlayer(Player player)
@@ -57,7 +60,7 @@ namespace osu.Game.Rulesets.Osu.Mods
             if (isBreakTime.Value)
                 return true;
 
-            if (!introEnded)
+            if (gameplayClock.CurrentTime < firstObjectValidJudgementTime)
                 return true;
 
             switch (action)
@@ -82,12 +85,6 @@ namespace osu.Game.Rulesets.Osu.Mods
             return false;
         }
 
-        public void Update(Playfield playfield)
-        {
-            if (!introEnded)
-                introEnded = playfield.Clock.CurrentTime > earliestStartTime;
-        }
-
         private class InputInterceptor : Component, IKeyBindingHandler<OsuAction>
         {
             private readonly OsuModAlternate mod;

From 3ba5d88914d09e1725ee3abaec9fd44699e3973c Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Wed, 2 Feb 2022 13:41:51 +0800
Subject: [PATCH 2726/5547] Update statistics item display logic

---
 .../Ranking/Statistics/StatisticsPanel.cs     | 131 +++++++++---------
 1 file changed, 69 insertions(+), 62 deletions(-)

diff --git a/osu.Game/Screens/Ranking/Statistics/StatisticsPanel.cs b/osu.Game/Screens/Ranking/Statistics/StatisticsPanel.cs
index 14cdfe2f03..9d89aa213c 100644
--- a/osu.Game/Screens/Ranking/Statistics/StatisticsPanel.cs
+++ b/osu.Game/Screens/Ranking/Statistics/StatisticsPanel.cs
@@ -74,85 +74,92 @@ namespace osu.Game.Screens.Ranking.Statistics
             if (newScore == null)
                 return;
 
-            if (newScore.HitEvents.Count == 0)
+            spinner.Show();
+
+            var localCancellationSource = loadCancellation = new CancellationTokenSource();
+            IBeatmap playableBeatmap = null;
+
+            // Todo: The placement of this is temporary. Eventually we'll both generate the playable beatmap _and_ run through it in a background task to generate the hit events.
+            Task.Run(() =>
             {
-                content.Add(new FillFlowContainer
+                playableBeatmap = beatmapManager.GetWorkingBeatmap(newScore.BeatmapInfo).GetPlayableBeatmap(newScore.Ruleset, newScore.Mods);
+            }, loadCancellation.Token).ContinueWith(t => Schedule(() =>
+            {
+                var rows = new FillFlowContainer
                 {
-                    RelativeSizeAxes = Axes.Both,
+                    RelativeSizeAxes = Axes.X,
+                    AutoSizeAxes = Axes.Y,
+                    Anchor = Anchor.Centre,
+                    Origin = Anchor.Centre,
                     Direction = FillDirection.Vertical,
-                    Children = new Drawable[]
+                    Spacing = new Vector2(30, 15),
+                    Alpha = 0
+                };
+
+                bool panelIsEmpty = true;
+                bool hitEventsAvailable = newScore.HitEvents.Count != 0;
+
+                foreach (var row in newScore.Ruleset.CreateInstance().CreateStatisticsForScore(newScore, playableBeatmap))
+                {
+                    var columnsToDisplay = hitEventsAvailable
+                        ? row.Columns
+                        : row.Columns?.Where(c => !c.RequiresHitEvents).ToArray();
+
+                    if (columnsToDisplay?.Any() ?? false)
+                        panelIsEmpty = false;
+
+                    rows.Add(new GridContainer
                     {
-                        new MessagePlaceholder("Extended statistics are only available after watching a replay!"),
-                        new ReplayDownloadButton(newScore)
+                        Anchor = Anchor.TopCentre,
+                        Origin = Anchor.TopCentre,
+                        RelativeSizeAxes = Axes.X,
+                        AutoSizeAxes = Axes.Y,
+                        Content = new[]
                         {
-                            Scale = new Vector2(1.5f),
-                            Anchor = Anchor.Centre,
-                            Origin = Anchor.Centre,
+                            columnsToDisplay?.Select(c => new StatisticContainer(c)
+                            {
+                                Anchor = Anchor.Centre,
+                                Origin = Anchor.Centre,
+                            }).Cast<Drawable>().ToArray()
                         },
-                    }
-                });
-            }
-            else
-            {
-                spinner.Show();
+                        ColumnDimensions = Enumerable.Range(0, columnsToDisplay?.Length ?? 0)
+                                                     .Select(i => columnsToDisplay?[i].Dimension ?? new Dimension()).ToArray(),
+                        RowDimensions = new[] { new Dimension(GridSizeMode.AutoSize) }
+                    });
+                }
 
-                var localCancellationSource = loadCancellation = new CancellationTokenSource();
-                IBeatmap playableBeatmap = null;
-
-                // Todo: The placement of this is temporary. Eventually we'll both generate the playable beatmap _and_ run through it in a background task to generate the hit events.
-                Task.Run(() =>
+                if (!hitEventsAvailable)
                 {
-                    playableBeatmap = beatmapManager.GetWorkingBeatmap(newScore.BeatmapInfo).GetPlayableBeatmap(newScore.Ruleset, newScore.Mods);
-                }, loadCancellation.Token).ContinueWith(t => Schedule(() =>
-                {
-                    var rows = new FillFlowContainer
+                    rows.Add(new FillFlowContainer
                     {
                         RelativeSizeAxes = Axes.X,
                         AutoSizeAxes = Axes.Y,
-                        Anchor = Anchor.Centre,
-                        Origin = Anchor.Centre,
                         Direction = FillDirection.Vertical,
-                        Spacing = new Vector2(30, 15),
-                        Alpha = 0
-                    };
-
-                    foreach (var row in newScore.Ruleset.CreateInstance().CreateStatisticsForScore(newScore, playableBeatmap))
-                    {
-                        var columnsToDisplay = newScore.HitEvents.Count == 0
-                            ? row.Columns?.Where(c => !c.RequiresHitEvents).ToArray()
-                            : row.Columns;
-
-                        rows.Add(new GridContainer
+                        Children = new Drawable[]
                         {
-                            Anchor = Anchor.TopCentre,
-                            Origin = Anchor.TopCentre,
-                            RelativeSizeAxes = Axes.X,
-                            AutoSizeAxes = Axes.Y,
-                            Content = new[]
+                            new MessagePlaceholder(panelIsEmpty
+                                ? "Extended statistics are only available after watching a replay!"
+                                : "More statistics available after watching a replay!"),
+                            new ReplayDownloadButton(newScore)
                             {
-                                columnsToDisplay?.Select(c => new StatisticContainer(c)
-                                {
-                                    Anchor = Anchor.Centre,
-                                    Origin = Anchor.Centre,
-                                }).Cast<Drawable>().ToArray()
+                                Scale = new Vector2(1.5f),
+                                Anchor = Anchor.Centre,
+                                Origin = Anchor.Centre,
                             },
-                            ColumnDimensions = Enumerable.Range(0, columnsToDisplay?.Length ?? 0)
-                                                         .Select(i => columnsToDisplay?[i].Dimension ?? new Dimension()).ToArray(),
-                            RowDimensions = new[] { new Dimension(GridSizeMode.AutoSize) }
-                        });
-                    }
+                        }
+                    });
+                }
 
-                    LoadComponentAsync(rows, d =>
-                    {
-                        if (!Score.Value.Equals(newScore))
-                            return;
+                LoadComponentAsync(rows, d =>
+                {
+                    if (!Score.Value.Equals(newScore))
+                        return;
 
-                        spinner.Hide();
-                        content.Add(d);
-                        d.FadeIn(250, Easing.OutQuint);
-                    }, localCancellationSource.Token);
-                }), localCancellationSource.Token);
-            }
+                    spinner.Hide();
+                    content.Add(d);
+                    d.FadeIn(250, Easing.OutQuint);
+                }, localCancellationSource.Token);
+            }), localCancellationSource.Token);
         }
 
         protected override bool OnClick(ClickEvent e)

From 6e60e68b809be7e1d93f3a80371f1ba551d45c43 Mon Sep 17 00:00:00 2001
From: Jamie Taylor <me@nekodex.net>
Date: Wed, 2 Feb 2022 14:44:06 +0900
Subject: [PATCH 2727/5547] Change from click to mousedown+mouseup and only
 play when cursor is visible

---
 osu.Game/Graphics/Cursor/MenuCursor.cs | 29 +++++++++++++++-----------
 1 file changed, 17 insertions(+), 12 deletions(-)

diff --git a/osu.Game/Graphics/Cursor/MenuCursor.cs b/osu.Game/Graphics/Cursor/MenuCursor.cs
index a89d8dac71..0cc751ea21 100644
--- a/osu.Game/Graphics/Cursor/MenuCursor.cs
+++ b/osu.Game/Graphics/Cursor/MenuCursor.cs
@@ -76,18 +76,6 @@ namespace osu.Game.Graphics.Cursor
             return base.OnMouseMove(e);
         }
 
-        protected override bool OnClick(ClickEvent e)
-        {
-            var channel = tapSample.GetChannel();
-
-            // scale to [-0.75, 0.75] so that the sample isn't fully panned left or right (sounds weird)
-            channel.Balance.Value = ((activeCursor.X / DrawWidth) * 2 - 1) * 0.75;
-            channel.Frequency.Value = 0.99 + RNG.NextDouble(0.02);
-            channel.Play();
-
-            return base.OnClick(e);
-        }
-
         protected override bool OnMouseDown(MouseDownEvent e)
         {
             if (State.Value == Visibility.Visible)
@@ -105,6 +93,8 @@ namespace osu.Game.Graphics.Cursor
                     dragRotationState = DragRotationState.DragStarted;
                     positionMouseDown = e.MousePosition;
                 }
+
+                playTapSample();
             }
 
             return base.OnMouseDown(e);
@@ -122,6 +112,9 @@ namespace osu.Game.Graphics.Cursor
                     activeCursor.RotateTo(0, 600 * (1 + Math.Abs(activeCursor.Rotation / 720)), Easing.OutElasticHalf);
                     dragRotationState = DragRotationState.NotDragging;
                 }
+
+                if (State.Value == Visibility.Visible)
+                    playTapSample(0.8);
             }
 
             base.OnMouseUp(e);
@@ -139,6 +132,18 @@ namespace osu.Game.Graphics.Cursor
             activeCursor.ScaleTo(0.6f, 250, Easing.In);
         }
 
+        private void playTapSample(double baseFrequency = 1f)
+        {
+            const float random_range = 0.02f;
+            SampleChannel channel = tapSample.GetChannel();
+
+            // Scale to [-0.75, 0.75] so that the sample isn't fully panned left or right (sounds weird)
+            channel.Balance.Value = ((activeCursor.X / DrawWidth) * 2 - 1) * 0.75;
+            channel.Frequency.Value = baseFrequency - (random_range / 2f) + RNG.NextDouble(random_range);
+
+            channel.Play();
+        }
+
         public class Cursor : Container
         {
             private Container cursorContainer;

From 0c5da9370a239b957f6d7a2fce929c0b7cff323c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 2 Feb 2022 14:51:55 +0900
Subject: [PATCH 2728/5547] Fix rulesets potentially being marked `Available`
 even when methods are missing

Came up when running the game after the recent breaking changes
(https://github.com/ppy/osu/pull/16722), where two template rulesets I
had loaded were erroring on startup but still being marked as available,
allowing them to crash the game on attempting to initiate relpay logic.

These cases are already handled for first-time ruleset loading via the
`GetTypes()` enumeration in `RulesetStore.addRuleset`, but when
consistency checking already present rulesets the only runtime
validation being done was `ruleset.CreateInstance()`, which does not
handle missing types or methods.
---
 osu.Game/Rulesets/RulesetStore.cs | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/osu.Game/Rulesets/RulesetStore.cs b/osu.Game/Rulesets/RulesetStore.cs
index d017d54ed9..dd25005006 100644
--- a/osu.Game/Rulesets/RulesetStore.cs
+++ b/osu.Game/Rulesets/RulesetStore.cs
@@ -149,6 +149,10 @@ namespace osu.Game.Rulesets
                         var instanceInfo = (Activator.CreateInstance(resolvedType) as Ruleset)?.RulesetInfo
                                            ?? throw new RulesetLoadException(@"Instantiation failure");
 
+                        // If a ruleset isn't up-to-date with the API, it could cause a crash at an arbitrary point of execution.
+                        // To eagerly handle cases of missing implementations, enumerate all types here and mark as non-available on throw.
+                        resolvedType.Assembly.GetTypes();
+
                         r.Name = instanceInfo.Name;
                         r.ShortName = instanceInfo.ShortName;
                         r.InstantiationInfo = instanceInfo.InstantiationInfo;

From e7d72f1823a5a97db761b0712851128942668366 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 2 Feb 2022 15:10:56 +0900
Subject: [PATCH 2729/5547] Revert recent changes

---
 osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs | 80 +++++++++++++++----
 1 file changed, 66 insertions(+), 14 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs b/osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs
index a383b533fd..cfe3312415 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs
@@ -11,8 +11,8 @@ using osu.Game.Rulesets.Osu.UI;
 using osuTK;
 using System.Linq;
 using osu.Game.Rulesets.Osu.Objects;
-using osu.Game.Configuration;
 using osu.Framework.Bindables;
+using osu.Game.Configuration;
 
 namespace osu.Game.Rulesets.Osu.Mods
 {
@@ -34,10 +34,16 @@ namespace osu.Game.Rulesets.Osu.Mods
             MaxValue = 1.0f,
         };
 
-        private double? lastUpdate;
+        private const float spin_radius = 30;
+
+        private Vector2? prevCursorPos;
+        private OsuInputManager inputManager;
 
         public void ApplyToDrawableRuleset(DrawableRuleset<OsuHitObject> drawableRuleset)
         {
+            // Grab the input manager for future use
+            inputManager = (OsuInputManager)drawableRuleset.KeyBindingInputManager;
+
             // Hide judgment displays and follow points
             drawableRuleset.Playfield.DisplayJudgements.Value = false;
             (drawableRuleset.Playfield as OsuPlayfield)?.FollowPoints.Hide();
@@ -45,29 +51,75 @@ namespace osu.Game.Rulesets.Osu.Mods
 
         public void Update(Playfield playfield)
         {
+            var cursorPos = playfield.Cursor.ActiveCursor.DrawPosition;
             double currentTime = playfield.Clock.CurrentTime;
 
-            if (currentTime - (lastUpdate ?? double.MinValue) < 100)
-                return;
-
-            Vector2 cursorPos = playfield.Cursor.ActiveCursor.DrawPosition;
-
+            // Move all currently alive object to new destination
             foreach (var drawable in playfield.HitObjectContainer.AliveObjects.OfType<DrawableOsuHitObject>())
             {
                 var h = drawable.HitObject;
 
-                if (currentTime < h.StartTime && (drawable is DrawableHitCircle || drawable is DrawableSlider))
+                switch (drawable)
                 {
-                    double timeMoving = currentTime - (h.StartTime - h.TimePreempt);
-                    float percentDoneMoving = (float)(timeMoving / h.TimePreempt);
-                    float percentDistLeft = Math.Clamp(AssistStrength.Value - percentDoneMoving + 0.1f, 0, 1);
+                    case DrawableHitCircle circle:
 
-                    Vector2 targetPos = drawable.Position + percentDistLeft * (cursorPos - drawable.Position);
-                    drawable.MoveTo(targetPos, h.StartTime - currentTime);
+                        // 10ms earlier on the note to reduce chance of missing when clicking early / cursor moves fast
+                        circle.MoveTo(cursorPos, Math.Max(0, h.StartTime - currentTime - 10));
+                        // FIXME: some circles cause flash at original(?) position when clicked too early
+
+                        break;
+
+                    case DrawableSlider slider:
+
+                        // Move slider to cursor
+                        if (currentTime < h.StartTime)
+                        {
+                            slider.MoveTo(cursorPos, Math.Max(0, h.StartTime - currentTime - 10));
+                        }
+                        // Move slider so that sliderball stays on the cursor
+                        else
+                        {
+                            slider.HeadCircle.Hide(); // hide flash, triangles, ... so they don't move with slider
+                            slider.MoveTo(cursorPos - slider.Ball.DrawPosition);
+                            // FIXME: some sliders re-appearing at their original position for a single frame when they're done
+                        }
+
+                        break;
+
+                    case DrawableSpinner spinner:
+
+                        // Move spinner _next_ to cursor
+                        if (currentTime < h.StartTime)
+                        {
+                            spinner.MoveTo(cursorPos + new Vector2(0, -spin_radius), Math.Max(0, h.StartTime - currentTime - 10));
+                        }
+                        else
+                        {
+                            // Move spinner visually
+                            Vector2 delta = spin_radius * (spinner.Position - prevCursorPos ?? cursorPos).Normalized();
+                            const float angle = 3 * MathF.PI / 180; // radians per update, arbitrary value
+
+                            // Rotation matrix
+                            var targetPos = new Vector2(
+                                delta.X * MathF.Cos(angle) - delta.Y * MathF.Sin(angle) + cursorPos.X,
+                                delta.X * MathF.Sin(angle) + delta.Y * MathF.Cos(angle) + cursorPos.Y
+                            );
+
+                            spinner.MoveTo(targetPos);
+
+                            // Move spinner logically
+                            if (inputManager?.PressedActions.Any(x => x == OsuAction.LeftButton || x == OsuAction.RightButton) ?? false)
+                            {
+                                // Arbitrary value, might lead to some inconsistencies depending on clock rate, replay, ...
+                                spinner.RotationTracker.AddRotation(2 * MathF.PI);
+                            }
+                        }
+
+                        break;
                 }
             }
 
-            lastUpdate = currentTime;
+            prevCursorPos = cursorPos;
         }
     }
 }

From 104256a054150963b6ffd5a4b68c14fedcfff834 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 2 Feb 2022 15:06:04 +0900
Subject: [PATCH 2730/5547] Add test coverage

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

diff --git a/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModAimAssist.cs b/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModAimAssist.cs
new file mode 100644
index 0000000000..8fa7e0cd09
--- /dev/null
+++ b/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModAimAssist.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 NUnit.Framework;
+using osu.Game.Rulesets.Osu.Mods;
+
+namespace osu.Game.Rulesets.Osu.Tests.Mods
+{
+    public class TestSceneOsuModAimAssist : OsuModTestScene
+    {
+        [Test]
+        public void TestAimAssist()
+        {
+            var mod = new OsuModAimAssist();
+
+            CreateModTest(new ModTestData
+            {
+                Autoplay = false,
+                Mod = mod,
+            });
+        }
+    }
+}

From 334ed2c9c488ec63e786d9197f756aa5bdaeb3b0 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 2 Feb 2022 15:36:09 +0900
Subject: [PATCH 2731/5547] Fix sliders moving before they are actually hit

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

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs b/osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs
index cfe3312415..a3c5638ea7 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs
@@ -72,7 +72,7 @@ namespace osu.Game.Rulesets.Osu.Mods
                     case DrawableSlider slider:
 
                         // Move slider to cursor
-                        if (currentTime < h.StartTime)
+                        if (!slider.HeadCircle.Result.HasResult)
                         {
                             slider.MoveTo(cursorPos, Math.Max(0, h.StartTime - currentTime - 10));
                         }

From f07502ac5fadab49871be06c51bb29d95a7cb32a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 2 Feb 2022 16:15:06 +0900
Subject: [PATCH 2732/5547] Use simple damp easing rather than transforms

---
 osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs | 69 ++++++++++---------
 1 file changed, 37 insertions(+), 32 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs b/osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs
index a3c5638ea7..db83ee09af 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs
@@ -2,17 +2,18 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
-using osu.Framework.Graphics;
-using osu.Framework.Graphics.Sprites;
-using osu.Game.Rulesets.Mods;
-using osu.Game.Rulesets.Osu.Objects.Drawables;
-using osu.Game.Rulesets.UI;
-using osu.Game.Rulesets.Osu.UI;
-using osuTK;
 using System.Linq;
-using osu.Game.Rulesets.Osu.Objects;
 using osu.Framework.Bindables;
+using osu.Framework.Graphics.Sprites;
+using osu.Framework.Utils;
 using osu.Game.Configuration;
+using osu.Game.Rulesets.Mods;
+using osu.Game.Rulesets.Objects.Drawables;
+using osu.Game.Rulesets.Osu.Objects;
+using osu.Game.Rulesets.Osu.Objects.Drawables;
+using osu.Game.Rulesets.Osu.UI;
+using osu.Game.Rulesets.UI;
+using osuTK;
 
 namespace osu.Game.Rulesets.Osu.Mods
 {
@@ -26,17 +27,18 @@ namespace osu.Game.Rulesets.Osu.Mods
         public override double ScoreMultiplier => 1;
         public override Type[] IncompatibleMods => new[] { typeof(OsuModAutopilot), typeof(OsuModWiggle), typeof(OsuModTransform), typeof(ModAutoplay) };
 
+        private IFrameStableClock gameplayClock;
+
         [SettingSource("Assist strength", "Change the distance notes should travel towards you.", 0)]
-        public BindableFloat AssistStrength { get; } = new BindableFloat(0.3f)
+        public BindableFloat AssistStrength { get; } = new BindableFloat(0.5f)
         {
             Precision = 0.05f,
-            MinValue = 0.0f,
+            MinValue = 0.1f,
             MaxValue = 1.0f,
         };
 
-        private const float spin_radius = 30;
+        private const float spin_radius = 50;
 
-        private Vector2? prevCursorPos;
         private OsuInputManager inputManager;
 
         public void ApplyToDrawableRuleset(DrawableRuleset<OsuHitObject> drawableRuleset)
@@ -44,6 +46,8 @@ namespace osu.Game.Rulesets.Osu.Mods
             // Grab the input manager for future use
             inputManager = (OsuInputManager)drawableRuleset.KeyBindingInputManager;
 
+            gameplayClock = drawableRuleset.FrameStableClock;
+
             // Hide judgment displays and follow points
             drawableRuleset.Playfield.DisplayJudgements.Value = false;
             (drawableRuleset.Playfield as OsuPlayfield)?.FollowPoints.Hide();
@@ -62,10 +66,7 @@ namespace osu.Game.Rulesets.Osu.Mods
                 switch (drawable)
                 {
                     case DrawableHitCircle circle:
-
-                        // 10ms earlier on the note to reduce chance of missing when clicking early / cursor moves fast
-                        circle.MoveTo(cursorPos, Math.Max(0, h.StartTime - currentTime - 10));
-                        // FIXME: some circles cause flash at original(?) position when clicked too early
+                        easeTo(circle, cursorPos);
 
                         break;
 
@@ -74,13 +75,13 @@ namespace osu.Game.Rulesets.Osu.Mods
                         // Move slider to cursor
                         if (!slider.HeadCircle.Result.HasResult)
                         {
-                            slider.MoveTo(cursorPos, Math.Max(0, h.StartTime - currentTime - 10));
+                            easeTo(slider, cursorPos);
                         }
                         // Move slider so that sliderball stays on the cursor
                         else
                         {
                             slider.HeadCircle.Hide(); // hide flash, triangles, ... so they don't move with slider
-                            slider.MoveTo(cursorPos - slider.Ball.DrawPosition);
+                            easeTo(slider, cursorPos - slider.Ball.DrawPosition);
                             // FIXME: some sliders re-appearing at their original position for a single frame when they're done
                         }
 
@@ -91,35 +92,39 @@ namespace osu.Game.Rulesets.Osu.Mods
                         // Move spinner _next_ to cursor
                         if (currentTime < h.StartTime)
                         {
-                            spinner.MoveTo(cursorPos + new Vector2(0, -spin_radius), Math.Max(0, h.StartTime - currentTime - 10));
+                            easeTo(spinner, cursorPos + new Vector2(0, -spin_radius));
                         }
                         else
                         {
                             // Move spinner visually
-                            Vector2 delta = spin_radius * (spinner.Position - prevCursorPos ?? cursorPos).Normalized();
-                            const float angle = 3 * MathF.PI / 180; // radians per update, arbitrary value
-
-                            // Rotation matrix
-                            var targetPos = new Vector2(
-                                delta.X * MathF.Cos(angle) - delta.Y * MathF.Sin(angle) + cursorPos.X,
-                                delta.X * MathF.Sin(angle) + delta.Y * MathF.Cos(angle) + cursorPos.Y
-                            );
-
-                            spinner.MoveTo(targetPos);
+                            Vector2 delta = new Vector2(spin_radius);
+                            float angle = (float)gameplayClock.CurrentTime * 10;
 
                             // Move spinner logically
                             if (inputManager?.PressedActions.Any(x => x == OsuAction.LeftButton || x == OsuAction.RightButton) ?? false)
                             {
-                                // Arbitrary value, might lead to some inconsistencies depending on clock rate, replay, ...
-                                spinner.RotationTracker.AddRotation(2 * MathF.PI);
+                                var targetPos = new Vector2(
+                                    delta.X * MathF.Cos(angle) - delta.Y * MathF.Sin(angle) + cursorPos.X,
+                                    delta.X * MathF.Sin(angle) + delta.Y * MathF.Cos(angle) + cursorPos.Y
+                                );
+
+                                easeTo(spinner, targetPos);
                             }
                         }
 
                         break;
                 }
             }
+        }
 
-            prevCursorPos = cursorPos;
+        private void easeTo(DrawableHitObject hitObject, Vector2 destination)
+        {
+            double dampLength = Interpolation.Lerp(500, 50, AssistStrength.Value);
+
+            float x = (float)Interpolation.DampContinuously(hitObject.X, destination.X, dampLength, gameplayClock.ElapsedFrameTime);
+            float y = (float)Interpolation.DampContinuously(hitObject.Y, destination.Y, dampLength, gameplayClock.ElapsedFrameTime);
+
+            hitObject.Position = new Vector2(x, y);
         }
     }
 }

From 987aa5a21c043360d71f0155b52d70e77ddd3a5e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 2 Feb 2022 16:15:14 +0900
Subject: [PATCH 2733/5547] Add testing of different strengths

---
 .../Mods/TestSceneOsuModAimAssist.cs               | 14 +++++++++-----
 1 file changed, 9 insertions(+), 5 deletions(-)

diff --git a/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModAimAssist.cs b/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModAimAssist.cs
index 8fa7e0cd09..b8310bc4e7 100644
--- a/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModAimAssist.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModAimAssist.cs
@@ -8,15 +8,19 @@ namespace osu.Game.Rulesets.Osu.Tests.Mods
 {
     public class TestSceneOsuModAimAssist : OsuModTestScene
     {
-        [Test]
-        public void TestAimAssist()
+        [TestCase(0.1f)]
+        [TestCase(0.5f)]
+        [TestCase(1)]
+        public void TestAimAssist(float strength)
         {
-            var mod = new OsuModAimAssist();
-
             CreateModTest(new ModTestData
             {
+                Mod = new OsuModAimAssist
+                {
+                    AssistStrength = { Value = strength },
+                },
+                PassCondition = () => true,
                 Autoplay = false,
-                Mod = mod,
             });
         }
     }

From 2e46404fe5e10f5279730ad61f90be5a805830b8 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 2 Feb 2022 16:15:49 +0900
Subject: [PATCH 2734/5547] Remove spinner support for now

---
 osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs | 30 -------------------
 1 file changed, 30 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs b/osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs
index db83ee09af..e3a68bcbcc 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs
@@ -37,8 +37,6 @@ namespace osu.Game.Rulesets.Osu.Mods
             MaxValue = 1.0f,
         };
 
-        private const float spin_radius = 50;
-
         private OsuInputManager inputManager;
 
         public void ApplyToDrawableRuleset(DrawableRuleset<OsuHitObject> drawableRuleset)
@@ -82,34 +80,6 @@ namespace osu.Game.Rulesets.Osu.Mods
                         {
                             slider.HeadCircle.Hide(); // hide flash, triangles, ... so they don't move with slider
                             easeTo(slider, cursorPos - slider.Ball.DrawPosition);
-                            // FIXME: some sliders re-appearing at their original position for a single frame when they're done
-                        }
-
-                        break;
-
-                    case DrawableSpinner spinner:
-
-                        // Move spinner _next_ to cursor
-                        if (currentTime < h.StartTime)
-                        {
-                            easeTo(spinner, cursorPos + new Vector2(0, -spin_radius));
-                        }
-                        else
-                        {
-                            // Move spinner visually
-                            Vector2 delta = new Vector2(spin_radius);
-                            float angle = (float)gameplayClock.CurrentTime * 10;
-
-                            // Move spinner logically
-                            if (inputManager?.PressedActions.Any(x => x == OsuAction.LeftButton || x == OsuAction.RightButton) ?? false)
-                            {
-                                var targetPos = new Vector2(
-                                    delta.X * MathF.Cos(angle) - delta.Y * MathF.Sin(angle) + cursorPos.X,
-                                    delta.X * MathF.Sin(angle) + delta.Y * MathF.Cos(angle) + cursorPos.Y
-                                );
-
-                                easeTo(spinner, targetPos);
-                            }
                         }
 
                         break;

From 6e41a6e704512ea2a355ae23d5793435ce464ef7 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 2 Feb 2022 16:26:10 +0900
Subject: [PATCH 2735/5547] Tidy up code into a presentable state

---
 osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs | 31 +++++--------------
 1 file changed, 7 insertions(+), 24 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs b/osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs
index e3a68bcbcc..ed4b139e00 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs
@@ -2,7 +2,6 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
-using System.Linq;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Utils;
@@ -23,30 +22,26 @@ namespace osu.Game.Rulesets.Osu.Mods
         public override string Acronym => "AA";
         public override IconUsage? Icon => FontAwesome.Solid.MousePointer;
         public override ModType Type => ModType.Fun;
-        public override string Description => "No need to chase the circle, the circle chases you";
+        public override string Description => "No need to chase the circle – the circle chases you!";
         public override double ScoreMultiplier => 1;
         public override Type[] IncompatibleMods => new[] { typeof(OsuModAutopilot), typeof(OsuModWiggle), typeof(OsuModTransform), typeof(ModAutoplay) };
 
         private IFrameStableClock gameplayClock;
 
-        [SettingSource("Assist strength", "Change the distance notes should travel towards you.", 0)]
+        [SettingSource("Assist strength", "How much this mod will assist you.", 0)]
         public BindableFloat AssistStrength { get; } = new BindableFloat(0.5f)
         {
             Precision = 0.05f,
-            MinValue = 0.1f,
+            MinValue = 0.05f,
             MaxValue = 1.0f,
         };
 
-        private OsuInputManager inputManager;
-
         public void ApplyToDrawableRuleset(DrawableRuleset<OsuHitObject> drawableRuleset)
         {
-            // Grab the input manager for future use
-            inputManager = (OsuInputManager)drawableRuleset.KeyBindingInputManager;
-
             gameplayClock = drawableRuleset.FrameStableClock;
 
-            // Hide judgment displays and follow points
+            // Hide judgment displays and follow points as they won't make any sense.
+            // Judgements can potentially be turned on in a future where they display at a position relative to their drawable counterpart.
             drawableRuleset.Playfield.DisplayJudgements.Value = false;
             (drawableRuleset.Playfield as OsuPlayfield)?.FollowPoints.Hide();
         }
@@ -54,33 +49,21 @@ namespace osu.Game.Rulesets.Osu.Mods
         public void Update(Playfield playfield)
         {
             var cursorPos = playfield.Cursor.ActiveCursor.DrawPosition;
-            double currentTime = playfield.Clock.CurrentTime;
 
-            // Move all currently alive object to new destination
-            foreach (var drawable in playfield.HitObjectContainer.AliveObjects.OfType<DrawableOsuHitObject>())
+            foreach (var drawable in playfield.HitObjectContainer.AliveObjects)
             {
-                var h = drawable.HitObject;
-
                 switch (drawable)
                 {
                     case DrawableHitCircle circle:
                         easeTo(circle, cursorPos);
-
                         break;
 
                     case DrawableSlider slider:
 
-                        // Move slider to cursor
                         if (!slider.HeadCircle.Result.HasResult)
-                        {
                             easeTo(slider, cursorPos);
-                        }
-                        // Move slider so that sliderball stays on the cursor
                         else
-                        {
-                            slider.HeadCircle.Hide(); // hide flash, triangles, ... so they don't move with slider
                             easeTo(slider, cursorPos - slider.Ball.DrawPosition);
-                        }
 
                         break;
                 }
@@ -89,7 +72,7 @@ namespace osu.Game.Rulesets.Osu.Mods
 
         private void easeTo(DrawableHitObject hitObject, Vector2 destination)
         {
-            double dampLength = Interpolation.Lerp(500, 50, AssistStrength.Value);
+            double dampLength = Interpolation.Lerp(3000, 40, AssistStrength.Value);
 
             float x = (float)Interpolation.DampContinuously(hitObject.X, destination.X, dampLength, gameplayClock.ElapsedFrameTime);
             float y = (float)Interpolation.DampContinuously(hitObject.Y, destination.Y, dampLength, gameplayClock.ElapsedFrameTime);

From 4758de226beda4f592aecef6f2ec2d8d0c390f03 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 2 Feb 2022 16:27:59 +0900
Subject: [PATCH 2736/5547] Update resources

---
 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 f85a96f819..963b61a2d3 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -51,7 +51,7 @@
     <Reference Include="Java.Interop" />
   </ItemGroup>
   <ItemGroup>
-    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.115.0" />
+    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.202.0" />
     <PackageReference Include="ppy.osu.Framework.Android" Version="2022.126.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index aa6fb93aa0..cc68393eae 100644
--- a/osu.Game/osu.Game.csproj
+++ b/osu.Game/osu.Game.csproj
@@ -37,7 +37,7 @@
     </PackageReference>
     <PackageReference Include="Realm" Version="10.8.0" />
     <PackageReference Include="ppy.osu.Framework" Version="2022.126.0" />
-    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.115.0" />
+    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.202.0" />
     <PackageReference Include="Sentry" Version="3.13.0" />
     <PackageReference Include="SharpCompress" Version="0.30.1" />
     <PackageReference Include="NUnit" Version="3.13.2" />
diff --git a/osu.iOS.props b/osu.iOS.props
index fbb4688588..846617c2f7 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -61,7 +61,7 @@
   </ItemGroup>
   <ItemGroup Label="Package References">
     <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.126.0" />
-    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.115.0" />
+    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.202.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net5.0 / net6.0) -->
   <PropertyGroup>

From 5e3d124eef996801dcb315cc48ed7499dc4aa0ef Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Wed, 2 Feb 2022 17:20:22 +0800
Subject: [PATCH 2737/5547] Add scrolling to the extended statistics panel

---
 .../Ranking/Statistics/StatisticsPanel.cs     | 78 +++++++++++++------
 1 file changed, 56 insertions(+), 22 deletions(-)

diff --git a/osu.Game/Screens/Ranking/Statistics/StatisticsPanel.cs b/osu.Game/Screens/Ranking/Statistics/StatisticsPanel.cs
index 9d89aa213c..1c96e640b4 100644
--- a/osu.Game/Screens/Ranking/Statistics/StatisticsPanel.cs
+++ b/osu.Game/Screens/Ranking/Statistics/StatisticsPanel.cs
@@ -10,6 +10,7 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Input.Events;
 using osu.Game.Beatmaps;
+using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Online.Placeholders;
 using osu.Game.Scoring;
@@ -85,15 +86,21 @@ namespace osu.Game.Screens.Ranking.Statistics
                 playableBeatmap = beatmapManager.GetWorkingBeatmap(newScore.BeatmapInfo).GetPlayableBeatmap(newScore.Ruleset, newScore.Mods);
             }, loadCancellation.Token).ContinueWith(t => Schedule(() =>
             {
-                var rows = new FillFlowContainer
+                FillFlowContainer rows;
+                Container<Drawable> container = new OsuScrollContainer(Direction.Vertical)
                 {
-                    RelativeSizeAxes = Axes.X,
-                    AutoSizeAxes = Axes.Y,
+                    RelativeSizeAxes = Axes.Both,
                     Anchor = Anchor.Centre,
                     Origin = Anchor.Centre,
-                    Direction = FillDirection.Vertical,
-                    Spacing = new Vector2(30, 15),
-                    Alpha = 0
+                    Alpha = 0,
+                    Children = new[]
+                    {
+                        rows = new FillFlowContainer
+                        {
+                            RelativeSizeAxes = Axes.X,
+                            AutoSizeAxes = Axes.Y
+                        }
+                    }
                 };
 
                 bool panelIsEmpty = true;
@@ -107,6 +114,8 @@ namespace osu.Game.Screens.Ranking.Statistics
 
                     if (columnsToDisplay?.Any() ?? false)
                         panelIsEmpty = false;
+                    else
+                        continue;
 
                     rows.Add(new GridContainer
                     {
@@ -114,6 +123,7 @@ namespace osu.Game.Screens.Ranking.Statistics
                         Origin = Anchor.TopCentre,
                         RelativeSizeAxes = Axes.X,
                         AutoSizeAxes = Axes.Y,
+                        Margin = new MarginPadding { Bottom = 15 },
                         Content = new[]
                         {
                             columnsToDisplay?.Select(c => new StatisticContainer(c)
@@ -130,27 +140,51 @@ namespace osu.Game.Screens.Ranking.Statistics
 
                 if (!hitEventsAvailable)
                 {
-                    rows.Add(new FillFlowContainer
+                    if (panelIsEmpty)
                     {
-                        RelativeSizeAxes = Axes.X,
-                        AutoSizeAxes = Axes.Y,
-                        Direction = FillDirection.Vertical,
-                        Children = new Drawable[]
+                        // Replace the scroll container with fill flow container to get the message centered.
+                        container = new FillFlowContainer
                         {
-                            new MessagePlaceholder(panelIsEmpty
-                                ? "Extended statistics are only available after watching a replay!"
-                                : "More statistics available after watching a replay!"),
-                            new ReplayDownloadButton(newScore)
+                            RelativeSizeAxes = Axes.Both,
+                            Anchor = Anchor.Centre,
+                            Origin = Anchor.Centre,
+                            Direction = FillDirection.Vertical,
+                            Children = new Drawable[]
                             {
-                                Scale = new Vector2(1.5f),
-                                Anchor = Anchor.Centre,
-                                Origin = Anchor.Centre,
-                            },
-                        }
-                    });
+                                new MessagePlaceholder("Extended statistics are only available after watching a replay!"),
+                                new ReplayDownloadButton(newScore)
+                                {
+                                    Scale = new Vector2(1.5f),
+                                    Anchor = Anchor.Centre,
+                                    Origin = Anchor.Centre,
+                                },
+                            }
+                        };
+                    }
+                    else
+                    {
+                        rows.Add(new FillFlowContainer
+                        {
+                            RelativeSizeAxes = Axes.X,
+                            AutoSizeAxes = Axes.Y,
+                            Direction = FillDirection.Vertical,
+                            Anchor = Anchor.TopCentre,
+                            Origin = Anchor.TopCentre,
+                            Children = new Drawable[]
+                            {
+                                new MessagePlaceholder("More statistics available after watching a replay!"),
+                                new ReplayDownloadButton(newScore)
+                                {
+                                    Scale = new Vector2(1.5f),
+                                    Anchor = Anchor.Centre,
+                                    Origin = Anchor.Centre,
+                                },
+                            }
+                        });
+                    }
                 }
 
-                LoadComponentAsync(rows, d =>
+                LoadComponentAsync(container, d =>
                 {
                     if (!Score.Value.Equals(newScore))
                         return;

From 6a482827fea64cbc0869700489e4feb9389f86d6 Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Wed, 2 Feb 2022 17:23:03 +0800
Subject: [PATCH 2738/5547] Fix weird line breaking

---
 osu.Game.Rulesets.Mania/ManiaRuleset.cs | 6 ++----
 osu.Game.Rulesets.Osu/OsuRuleset.cs     | 9 +++------
 osu.Game.Rulesets.Taiko/TaikoRuleset.cs | 6 ++----
 3 files changed, 7 insertions(+), 14 deletions(-)

diff --git a/osu.Game.Rulesets.Mania/ManiaRuleset.cs b/osu.Game.Rulesets.Mania/ManiaRuleset.cs
index 8ac8001457..0ea1cd5fc7 100644
--- a/osu.Game.Rulesets.Mania/ManiaRuleset.cs
+++ b/osu.Game.Rulesets.Mania/ManiaRuleset.cs
@@ -370,8 +370,7 @@ namespace osu.Game.Rulesets.Mania
             {
                 Columns = new[]
                 {
-                    new StatisticItem("Timing Distribution",
-                        true,
+                    new StatisticItem("Timing Distribution", true,
                         () => new HitEventTimingDistributionGraph(score.HitEvents)
                         {
                             RelativeSizeAxes = Axes.X,
@@ -383,8 +382,7 @@ namespace osu.Game.Rulesets.Mania
             {
                 Columns = new[]
                 {
-                    new StatisticItem(string.Empty,
-                        true,
+                    new StatisticItem(string.Empty, true,
                         () => new SimpleStatisticTable(3, new SimpleStatisticItem[]
                         {
                             new UnstableRate(score.HitEvents)
diff --git a/osu.Game.Rulesets.Osu/OsuRuleset.cs b/osu.Game.Rulesets.Osu/OsuRuleset.cs
index b6f417b7fe..2bf47100c1 100644
--- a/osu.Game.Rulesets.Osu/OsuRuleset.cs
+++ b/osu.Game.Rulesets.Osu/OsuRuleset.cs
@@ -277,8 +277,7 @@ namespace osu.Game.Rulesets.Osu
                 {
                     Columns = new[]
                     {
-                        new StatisticItem("Timing Distribution",
-                            true,
+                        new StatisticItem("Timing Distribution", true,
                             () => new HitEventTimingDistributionGraph(timedHitEvents)
                             {
                                 RelativeSizeAxes = Axes.X,
@@ -290,8 +289,7 @@ namespace osu.Game.Rulesets.Osu
                 {
                     Columns = new[]
                     {
-                        new StatisticItem("Accuracy Heatmap",
-                            true,
+                        new StatisticItem("Accuracy Heatmap", true,
                             () => new AccuracyHeatmap(score, playableBeatmap)
                             {
                                 RelativeSizeAxes = Axes.X,
@@ -303,8 +301,7 @@ namespace osu.Game.Rulesets.Osu
                 {
                     Columns = new[]
                     {
-                        new StatisticItem(string.Empty,
-                            true,
+                        new StatisticItem(string.Empty, true,
                             () => new SimpleStatisticTable(3, new SimpleStatisticItem[]
                             {
                                 new UnstableRate(timedHitEvents)
diff --git a/osu.Game.Rulesets.Taiko/TaikoRuleset.cs b/osu.Game.Rulesets.Taiko/TaikoRuleset.cs
index 2a64b8dddd..fe4116b4a6 100644
--- a/osu.Game.Rulesets.Taiko/TaikoRuleset.cs
+++ b/osu.Game.Rulesets.Taiko/TaikoRuleset.cs
@@ -213,8 +213,7 @@ namespace osu.Game.Rulesets.Taiko
                 {
                     Columns = new[]
                     {
-                        new StatisticItem("Timing Distribution",
-                            true,
+                        new StatisticItem("Timing Distribution", true,
                             () => new HitEventTimingDistributionGraph(timedHitEvents)
                             {
                                 RelativeSizeAxes = Axes.X,
@@ -226,8 +225,7 @@ namespace osu.Game.Rulesets.Taiko
                 {
                     Columns = new[]
                     {
-                        new StatisticItem(string.Empty,
-                            true,
+                        new StatisticItem(string.Empty, true,
                             () => new SimpleStatisticTable(3, new SimpleStatisticItem[]
                             {
                                 new UnstableRate(timedHitEvents)

From 90e30bc9e8b3e7058aebfa83336383d52d0e0efb Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Wed, 2 Feb 2022 17:26:17 +0800
Subject: [PATCH 2739/5547] Remove useless null checks

---
 osu.Game/Screens/Ranking/Statistics/StatisticsPanel.cs | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Screens/Ranking/Statistics/StatisticsPanel.cs b/osu.Game/Screens/Ranking/Statistics/StatisticsPanel.cs
index 1c96e640b4..8b69f83055 100644
--- a/osu.Game/Screens/Ranking/Statistics/StatisticsPanel.cs
+++ b/osu.Game/Screens/Ranking/Statistics/StatisticsPanel.cs
@@ -110,9 +110,9 @@ namespace osu.Game.Screens.Ranking.Statistics
                 {
                     var columnsToDisplay = hitEventsAvailable
                         ? row.Columns
-                        : row.Columns?.Where(c => !c.RequiresHitEvents).ToArray();
+                        : row.Columns.Where(c => !c.RequiresHitEvents).ToArray();
 
-                    if (columnsToDisplay?.Any() ?? false)
+                    if (columnsToDisplay.Any())
                         panelIsEmpty = false;
                     else
                         continue;
@@ -132,8 +132,8 @@ namespace osu.Game.Screens.Ranking.Statistics
                                 Origin = Anchor.Centre,
                             }).Cast<Drawable>().ToArray()
                         },
-                        ColumnDimensions = Enumerable.Range(0, columnsToDisplay?.Length ?? 0)
-                                                     .Select(i => columnsToDisplay?[i].Dimension ?? new Dimension()).ToArray(),
+                        ColumnDimensions = Enumerable.Range(0, columnsToDisplay.Length)
+                                                     .Select(i => columnsToDisplay[i].Dimension ?? new Dimension()).ToArray(),
                         RowDimensions = new[] { new Dimension(GridSizeMode.AutoSize) }
                     });
                 }

From 042574660c10d6a28c29a81d6f45f5b8547f956a Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Wed, 2 Feb 2022 17:29:03 +0800
Subject: [PATCH 2740/5547] Rename "Content" to "CreateContent"

---
 .../Ranking/Statistics/StatisticContainer.cs       |  2 +-
 .../Screens/Ranking/Statistics/StatisticItem.cs    | 14 +++++++-------
 2 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Screens/Ranking/Statistics/StatisticContainer.cs b/osu.Game/Screens/Ranking/Statistics/StatisticContainer.cs
index f3bd2c6fc1..79f813ef64 100644
--- a/osu.Game/Screens/Ranking/Statistics/StatisticContainer.cs
+++ b/osu.Game/Screens/Ranking/Statistics/StatisticContainer.cs
@@ -43,7 +43,7 @@ namespace osu.Game.Screens.Ranking.Statistics
                             RelativeSizeAxes = Axes.X,
                             AutoSizeAxes = Axes.Y,
                             Margin = new MarginPadding { Top = 15 },
-                            Child = item.Content()
+                            Child = item.CreateContent()
                         }
                     },
                 },
diff --git a/osu.Game/Screens/Ranking/Statistics/StatisticItem.cs b/osu.Game/Screens/Ranking/Statistics/StatisticItem.cs
index 5e6ddf445b..cb5ba4b9fe 100644
--- a/osu.Game/Screens/Ranking/Statistics/StatisticItem.cs
+++ b/osu.Game/Screens/Ranking/Statistics/StatisticItem.cs
@@ -19,9 +19,9 @@ namespace osu.Game.Screens.Ranking.Statistics
         public readonly string Name;
 
         /// <summary>
-        /// The <see cref="Drawable"/> content to be displayed.
+        /// A function returning the <see cref="Drawable"/> content to be displayed.
         /// </summary>
-        public readonly Func<Drawable> Content;
+        public readonly Func<Drawable> CreateContent;
 
         /// <summary>
         /// The <see cref="Dimension"/> of this row. This can be thought of as the column dimension of an encompassing <see cref="GridContainer"/>.
@@ -29,7 +29,7 @@ namespace osu.Game.Screens.Ranking.Statistics
         public readonly Dimension Dimension;
 
         /// <summary>
-        /// Whether this item requires hit events. If true, the <see cref="Content"/> will not be created if no hit events are available.
+        /// Whether this item requires hit events. If true, <see cref="CreateContent"/> will not be called if no hit events are available.
         /// </summary>
         public readonly bool RequiresHitEvents;
 
@@ -37,14 +37,14 @@ namespace osu.Game.Screens.Ranking.Statistics
         /// Creates a new <see cref="StatisticItem"/>, to be displayed inside a <see cref="StatisticRow"/> in the results screen.
         /// </summary>
         /// <param name="name">The name of the item. Can be <see cref="string.Empty"/> to hide the item header.</param>
-        /// <param name="requiresHitEvents">Whether this item requires hit events. If true, the <see cref="Content"/> will not be created if no hit events are available.</param>
-        /// <param name="content">The <see cref="Drawable"/> content to be displayed.</param>
+        /// <param name="requiresHitEvents">Whether this item requires hit events. If true, <see cref="CreateContent"/> will not be called if no hit events are available.</param>
+        /// <param name="createContent">A function returning the <see cref="Drawable"/> content to be displayed.</param>
         /// <param name="dimension">The <see cref="Dimension"/> of this item. This can be thought of as the column dimension of an encompassing <see cref="GridContainer"/>.</param>
-        public StatisticItem([NotNull] string name, bool requiresHitEvents, [NotNull] Func<Drawable> content, [CanBeNull] Dimension dimension = null)
+        public StatisticItem([NotNull] string name, bool requiresHitEvents, [NotNull] Func<Drawable> createContent, [CanBeNull] Dimension dimension = null)
         {
             Name = name;
             RequiresHitEvents = requiresHitEvents;
-            Content = content;
+            CreateContent = createContent;
             Dimension = dimension;
         }
     }

From 36bfef4f54f4f116ec7f84747db2c4c93a883d0d Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Wed, 2 Feb 2022 17:32:16 +0800
Subject: [PATCH 2741/5547] Dispose container before replacing

---
 osu.Game/Screens/Ranking/Statistics/StatisticsPanel.cs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Game/Screens/Ranking/Statistics/StatisticsPanel.cs b/osu.Game/Screens/Ranking/Statistics/StatisticsPanel.cs
index 8b69f83055..2327f60f81 100644
--- a/osu.Game/Screens/Ranking/Statistics/StatisticsPanel.cs
+++ b/osu.Game/Screens/Ranking/Statistics/StatisticsPanel.cs
@@ -143,6 +143,7 @@ namespace osu.Game.Screens.Ranking.Statistics
                     if (panelIsEmpty)
                     {
                         // Replace the scroll container with fill flow container to get the message centered.
+                        container.Dispose();
                         container = new FillFlowContainer
                         {
                             RelativeSizeAxes = Axes.Both,

From b5fb3b7dae02bdbaeec37e535d447bb09fcfbaeb Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 2 Feb 2022 18:42:20 +0900
Subject: [PATCH 2742/5547] Fix crash when selecting swap mod as freemod

---
 .../TestSceneMultiplayerMatchSubScreen.cs     | 25 +++++++++++++++++++
 .../Participants/ParticipantPanel.cs          |  8 ++++--
 2 files changed, 31 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs
index 9d14d80d07..869fb17317 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs
@@ -15,8 +15,12 @@ using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Rooms;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Osu;
+using osu.Game.Rulesets.Taiko;
+using osu.Game.Rulesets.Taiko.Mods;
+using osu.Game.Rulesets.UI;
 using osu.Game.Screens.OnlinePlay.Multiplayer;
 using osu.Game.Screens.OnlinePlay.Multiplayer.Match;
+using osu.Game.Screens.OnlinePlay.Multiplayer.Participants;
 using osu.Game.Tests.Beatmaps;
 using osu.Game.Tests.Resources;
 
@@ -77,6 +81,27 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddUntilStep("wait for join", () => RoomJoined);
         }
 
+        [Test]
+        public void TestTaikoOnlyMod()
+        {
+            AddStep("add playlist item", () =>
+            {
+                SelectedRoom.Value.Playlist.Add(new PlaylistItem
+                {
+                    Beatmap = { Value = new TestBeatmap(new TaikoRuleset().RulesetInfo).BeatmapInfo },
+                    Ruleset = { Value = new TaikoRuleset().RulesetInfo },
+                    AllowedMods = { new TaikoModSwap() }
+                });
+            });
+
+            ClickButtonWhenEnabled<MultiplayerMatchSettingsOverlay.CreateOrUpdateButton>();
+
+            AddUntilStep("wait for join", () => RoomJoined);
+
+            AddStep("select swap mod", () => Client.ChangeUserMods(API.LocalUser.Value.OnlineID, new[] { new TaikoModSwap() }));
+            AddUntilStep("participant panel has mod", () => this.ChildrenOfType<ParticipantPanel>().Any(p => p.ChildrenOfType<ModIcon>().Any(m => m.Mod is TaikoModSwap)));
+        }
+
         [Test]
         public void TestSettingValidity()
         {
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantPanel.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantPanel.cs
index 8fbaebadfe..96a665f33d 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantPanel.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantPanel.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.Extensions.Color4Extensions;
@@ -18,6 +19,7 @@ using osu.Game.Graphics.UserInterface;
 using osu.Game.Online;
 using osu.Game.Online.API;
 using osu.Game.Online.Multiplayer;
+using osu.Game.Online.Rooms;
 using osu.Game.Rulesets;
 using osu.Game.Screens.Play.HUD;
 using osu.Game.Users;
@@ -184,8 +186,10 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Participants
 
             const double fade_time = 50;
 
-            // Todo: Should use the room's selected item to determine ruleset.
-            var ruleset = rulesets.GetRuleset(0)?.CreateInstance();
+            var currentItem = Playlist.GetCurrentItem();
+            Debug.Assert(currentItem != null);
+
+            var ruleset = rulesets.GetRuleset(currentItem.RulesetID)?.CreateInstance();
 
             int? currentModeRank = ruleset != null ? User.User?.RulesetsStatistics?.GetValueOrDefault(ruleset.ShortName)?.GlobalRank : null;
             userRankText.Text = currentModeRank != null ? $"#{currentModeRank.Value:N0}" : string.Empty;

From b0023b9809d15cdb7f19d5a2f6be9c0d047bf9fc Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Wed, 2 Feb 2022 19:00:46 +0800
Subject: [PATCH 2743/5547] Also dispose `rows`

---
 osu.Game/Screens/Ranking/Statistics/StatisticsPanel.cs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Game/Screens/Ranking/Statistics/StatisticsPanel.cs b/osu.Game/Screens/Ranking/Statistics/StatisticsPanel.cs
index 2327f60f81..62f9eb8506 100644
--- a/osu.Game/Screens/Ranking/Statistics/StatisticsPanel.cs
+++ b/osu.Game/Screens/Ranking/Statistics/StatisticsPanel.cs
@@ -143,6 +143,7 @@ namespace osu.Game.Screens.Ranking.Statistics
                     if (panelIsEmpty)
                     {
                         // Replace the scroll container with fill flow container to get the message centered.
+                        rows.Dispose();
                         container.Dispose();
                         container = new FillFlowContainer
                         {

From 1e19c7046a71de056cc975deaa045eb2eff46c8b Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Wed, 2 Feb 2022 19:02:29 +0800
Subject: [PATCH 2744/5547] Use spacing instead of bottom margin

---
 osu.Game/Screens/Ranking/Statistics/StatisticsPanel.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/Ranking/Statistics/StatisticsPanel.cs b/osu.Game/Screens/Ranking/Statistics/StatisticsPanel.cs
index 62f9eb8506..68414c4d49 100644
--- a/osu.Game/Screens/Ranking/Statistics/StatisticsPanel.cs
+++ b/osu.Game/Screens/Ranking/Statistics/StatisticsPanel.cs
@@ -98,7 +98,8 @@ namespace osu.Game.Screens.Ranking.Statistics
                         rows = new FillFlowContainer
                         {
                             RelativeSizeAxes = Axes.X,
-                            AutoSizeAxes = Axes.Y
+                            AutoSizeAxes = Axes.Y,
+                            Spacing = new Vector2(30, 15)
                         }
                     }
                 };
@@ -123,7 +124,6 @@ namespace osu.Game.Screens.Ranking.Statistics
                         Origin = Anchor.TopCentre,
                         RelativeSizeAxes = Axes.X,
                         AutoSizeAxes = Axes.Y,
-                        Margin = new MarginPadding { Bottom = 15 },
                         Content = new[]
                         {
                             columnsToDisplay?.Select(c => new StatisticContainer(c)

From 3c2a6fe2086a1eb560a4aefe1805a8d402b1d153 Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Wed, 2 Feb 2022 19:07:14 +0800
Subject: [PATCH 2745/5547] Don't prompt for a replay if no item requires hit
 events

---
 osu.Game/Screens/Ranking/Statistics/StatisticsPanel.cs | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Ranking/Statistics/StatisticsPanel.cs b/osu.Game/Screens/Ranking/Statistics/StatisticsPanel.cs
index 68414c4d49..08be1de652 100644
--- a/osu.Game/Screens/Ranking/Statistics/StatisticsPanel.cs
+++ b/osu.Game/Screens/Ranking/Statistics/StatisticsPanel.cs
@@ -105,6 +105,7 @@ namespace osu.Game.Screens.Ranking.Statistics
                 };
 
                 bool panelIsEmpty = true;
+                bool panelIsComplete = true;
                 bool hitEventsAvailable = newScore.HitEvents.Count != 0;
 
                 foreach (var row in newScore.Ruleset.CreateInstance().CreateStatisticsForScore(newScore, playableBeatmap))
@@ -113,6 +114,9 @@ namespace osu.Game.Screens.Ranking.Statistics
                         ? row.Columns
                         : row.Columns.Where(c => !c.RequiresHitEvents).ToArray();
 
+                    if (columnsToDisplay.Length < row.Columns.Length)
+                        panelIsComplete = false;
+
                     if (columnsToDisplay.Any())
                         panelIsEmpty = false;
                     else
@@ -163,7 +167,7 @@ namespace osu.Game.Screens.Ranking.Statistics
                             }
                         };
                     }
-                    else
+                    else if (!panelIsComplete)
                     {
                         rows.Add(new FillFlowContainer
                         {

From 19eb9ad8a7e86b384ca65648b95e35e37c2ce068 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 2 Feb 2022 23:02:38 +0900
Subject: [PATCH 2746/5547] Reorder `StatisticsItem` constructor to make a
 touch more sense

---
 osu.Game.Rulesets.Mania/ManiaRuleset.cs       | 20 ++++++------
 osu.Game.Rulesets.Osu/OsuRuleset.cs           | 31 +++++++++----------
 osu.Game.Rulesets.Taiko/TaikoRuleset.cs       | 20 ++++++------
 .../Ranking/Statistics/StatisticItem.cs       |  4 +--
 4 files changed, 34 insertions(+), 41 deletions(-)

diff --git a/osu.Game.Rulesets.Mania/ManiaRuleset.cs b/osu.Game.Rulesets.Mania/ManiaRuleset.cs
index 0ea1cd5fc7..ffb26b224f 100644
--- a/osu.Game.Rulesets.Mania/ManiaRuleset.cs
+++ b/osu.Game.Rulesets.Mania/ManiaRuleset.cs
@@ -370,23 +370,21 @@ namespace osu.Game.Rulesets.Mania
             {
                 Columns = new[]
                 {
-                    new StatisticItem("Timing Distribution", true,
-                        () => new HitEventTimingDistributionGraph(score.HitEvents)
-                        {
-                            RelativeSizeAxes = Axes.X,
-                            Height = 250
-                        }),
+                    new StatisticItem("Timing Distribution", () => new HitEventTimingDistributionGraph(score.HitEvents)
+                    {
+                        RelativeSizeAxes = Axes.X,
+                        Height = 250
+                    }, true),
                 }
             },
             new StatisticRow
             {
                 Columns = new[]
                 {
-                    new StatisticItem(string.Empty, true,
-                        () => new SimpleStatisticTable(3, new SimpleStatisticItem[]
-                        {
-                            new UnstableRate(score.HitEvents)
-                        }))
+                    new StatisticItem(string.Empty, () => new SimpleStatisticTable(3, new SimpleStatisticItem[]
+                    {
+                        new UnstableRate(score.HitEvents)
+                    }), true)
                 }
             }
         };
diff --git a/osu.Game.Rulesets.Osu/OsuRuleset.cs b/osu.Game.Rulesets.Osu/OsuRuleset.cs
index 2bf47100c1..1122a869b7 100644
--- a/osu.Game.Rulesets.Osu/OsuRuleset.cs
+++ b/osu.Game.Rulesets.Osu/OsuRuleset.cs
@@ -277,35 +277,32 @@ namespace osu.Game.Rulesets.Osu
                 {
                     Columns = new[]
                     {
-                        new StatisticItem("Timing Distribution", true,
-                            () => new HitEventTimingDistributionGraph(timedHitEvents)
-                            {
-                                RelativeSizeAxes = Axes.X,
-                                Height = 250
-                            }),
+                        new StatisticItem("Timing Distribution", () => new HitEventTimingDistributionGraph(timedHitEvents)
+                        {
+                            RelativeSizeAxes = Axes.X,
+                            Height = 250
+                        }, true),
                     }
                 },
                 new StatisticRow
                 {
                     Columns = new[]
                     {
-                        new StatisticItem("Accuracy Heatmap", true,
-                            () => new AccuracyHeatmap(score, playableBeatmap)
-                            {
-                                RelativeSizeAxes = Axes.X,
-                                Height = 250
-                            }),
+                        new StatisticItem("Accuracy Heatmap", () => new AccuracyHeatmap(score, playableBeatmap)
+                        {
+                            RelativeSizeAxes = Axes.X,
+                            Height = 250
+                        }, true),
                     }
                 },
                 new StatisticRow
                 {
                     Columns = new[]
                     {
-                        new StatisticItem(string.Empty, true,
-                            () => new SimpleStatisticTable(3, new SimpleStatisticItem[]
-                            {
-                                new UnstableRate(timedHitEvents)
-                            }))
+                        new StatisticItem(string.Empty, () => new SimpleStatisticTable(3, new SimpleStatisticItem[]
+                        {
+                            new UnstableRate(timedHitEvents)
+                        }), true)
                     }
                 }
             };
diff --git a/osu.Game.Rulesets.Taiko/TaikoRuleset.cs b/osu.Game.Rulesets.Taiko/TaikoRuleset.cs
index fe4116b4a6..21c99c0d2f 100644
--- a/osu.Game.Rulesets.Taiko/TaikoRuleset.cs
+++ b/osu.Game.Rulesets.Taiko/TaikoRuleset.cs
@@ -213,23 +213,21 @@ namespace osu.Game.Rulesets.Taiko
                 {
                     Columns = new[]
                     {
-                        new StatisticItem("Timing Distribution", true,
-                            () => new HitEventTimingDistributionGraph(timedHitEvents)
-                            {
-                                RelativeSizeAxes = Axes.X,
-                                Height = 250
-                            }),
+                        new StatisticItem("Timing Distribution", () => new HitEventTimingDistributionGraph(timedHitEvents)
+                        {
+                            RelativeSizeAxes = Axes.X,
+                            Height = 250
+                        }, true),
                     }
                 },
                 new StatisticRow
                 {
                     Columns = new[]
                     {
-                        new StatisticItem(string.Empty, true,
-                            () => new SimpleStatisticTable(3, new SimpleStatisticItem[]
-                            {
-                                new UnstableRate(timedHitEvents)
-                            }))
+                        new StatisticItem(string.Empty, () => new SimpleStatisticTable(3, new SimpleStatisticItem[]
+                        {
+                            new UnstableRate(timedHitEvents)
+                        }), true)
                     }
                 }
             };
diff --git a/osu.Game/Screens/Ranking/Statistics/StatisticItem.cs b/osu.Game/Screens/Ranking/Statistics/StatisticItem.cs
index cb5ba4b9fe..3cfc38e263 100644
--- a/osu.Game/Screens/Ranking/Statistics/StatisticItem.cs
+++ b/osu.Game/Screens/Ranking/Statistics/StatisticItem.cs
@@ -37,10 +37,10 @@ namespace osu.Game.Screens.Ranking.Statistics
         /// Creates a new <see cref="StatisticItem"/>, to be displayed inside a <see cref="StatisticRow"/> in the results screen.
         /// </summary>
         /// <param name="name">The name of the item. Can be <see cref="string.Empty"/> to hide the item header.</param>
-        /// <param name="requiresHitEvents">Whether this item requires hit events. If true, <see cref="CreateContent"/> will not be called if no hit events are available.</param>
         /// <param name="createContent">A function returning the <see cref="Drawable"/> content to be displayed.</param>
+        /// <param name="requiresHitEvents">Whether this item requires hit events. If true, <see cref="CreateContent"/> will not be called if no hit events are available.</param>
         /// <param name="dimension">The <see cref="Dimension"/> of this item. This can be thought of as the column dimension of an encompassing <see cref="GridContainer"/>.</param>
-        public StatisticItem([NotNull] string name, bool requiresHitEvents, [NotNull] Func<Drawable> createContent, [CanBeNull] Dimension dimension = null)
+        public StatisticItem([NotNull] string name, [NotNull] Func<Drawable> createContent, bool requiresHitEvents = false, [CanBeNull] Dimension dimension = null)
         {
             Name = name;
             RequiresHitEvents = requiresHitEvents;

From 9d1d13c7152592d31a212fc04b04aac1fac171b1 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 2 Feb 2022 23:00:43 +0900
Subject: [PATCH 2747/5547] Fix up TestSpectatorClient implementation

Rather than using a list which is supposed to be updated "client"-side,
now uses the "server"-side list.
---
 .../Visual/Spectator/TestSpectatorClient.cs     | 17 +++++++++--------
 1 file changed, 9 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Tests/Visual/Spectator/TestSpectatorClient.cs b/osu.Game/Tests/Visual/Spectator/TestSpectatorClient.cs
index 7848a825f4..6862cda88c 100644
--- a/osu.Game/Tests/Visual/Spectator/TestSpectatorClient.cs
+++ b/osu.Game/Tests/Visual/Spectator/TestSpectatorClient.cs
@@ -39,11 +39,7 @@ namespace osu.Game.Tests.Visual.Spectator
 
         public TestSpectatorClient()
         {
-            OnNewFrames += (i, bundle) =>
-            {
-                if (PlayingUserStates.ContainsKey(i))
-                    lastReceivedUserFrames[i] = bundle.Frames[^1];
-            };
+            OnNewFrames += (i, bundle) => lastReceivedUserFrames[i] = bundle.Frames[^1];
         }
 
         /// <summary>
@@ -62,16 +58,20 @@ namespace osu.Game.Tests.Visual.Spectator
         /// Ends play for an arbitrary user.
         /// </summary>
         /// <param name="userId">The user to end play for.</param>
-        public void EndPlay(int userId)
+        /// <param name="state">The spectator state to end play with.</param>
+        public void EndPlay(int userId, SpectatingUserState state = SpectatingUserState.Quit)
         {
-            if (!PlayingUserStates.ContainsKey(userId))
+            if (!userBeatmapDictionary.ContainsKey(userId))
                 return;
 
             ((ISpectatorClient)this).UserFinishedPlaying(userId, new SpectatorState
             {
                 BeatmapID = userBeatmapDictionary[userId],
                 RulesetID = 0,
+                State = state
             });
+
+            userBeatmapDictionary.Remove(userId);
         }
 
         public new void Schedule(Action action) => base.Schedule(action);
@@ -130,7 +130,7 @@ namespace osu.Game.Tests.Visual.Spectator
         protected override Task WatchUserInternal(int userId)
         {
             // When newly watching a user, the server sends the playing state immediately.
-            if (PlayingUserStates.ContainsKey(userId))
+            if (userBeatmapDictionary.ContainsKey(userId))
                 sendPlayingState(userId);
 
             return Task.CompletedTask;
@@ -144,6 +144,7 @@ namespace osu.Game.Tests.Visual.Spectator
             {
                 BeatmapID = userBeatmapDictionary[userId],
                 RulesetID = 0,
+                State = SpectatingUserState.Playing
             });
         }
     }

From 589f5e7a31f53275f7cd001adbe4deedb1e18473 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 2 Feb 2022 23:09:38 +0900
Subject: [PATCH 2748/5547] Update test which has now been resolved

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

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs
index d28e5203e3..9f8470446c 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs
@@ -155,11 +155,12 @@ namespace osu.Game.Tests.Visual.Gameplay
 
             waitForPlayer();
             checkPaused(true);
+            sendFrames();
 
-            finish();
+            finish(SpectatingUserState.Failed);
 
-            checkPaused(false);
-            // TODO: should replay until running out of frames then fail
+            checkPaused(false); // Should continue playing until out of frames
+            checkPaused(true);
         }
 
         [Test]
@@ -246,7 +247,7 @@ namespace osu.Game.Tests.Visual.Gameplay
 
         private void start(int? beatmapId = null) => AddStep("start play", () => spectatorClient.StartPlay(streamingUser.Id, beatmapId ?? importedBeatmapId));
 
-        private void finish() => AddStep("end play", () => spectatorClient.EndPlay(streamingUser.Id));
+        private void finish(SpectatingUserState state = SpectatingUserState.Quit) => AddStep("end play", () => spectatorClient.EndPlay(streamingUser.Id, state));
 
         private void checkPaused(bool state) =>
             AddUntilStep($"game is {(state ? "paused" : "playing")}", () => player.ChildrenOfType<DrawableRuleset>().First().IsPaused.Value == state);

From fcbba3d9481ca396acd9885593065ea782362475 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 2 Feb 2022 23:11:29 +0900
Subject: [PATCH 2749/5547] Rename PlayingUserStates -> WatchingUserStates

---
 .../Visual/Gameplay/TestSceneSpectatorHost.cs        |  4 ++--
 .../TestSceneMultiplayerGameplayLeaderboard.cs       |  2 +-
 osu.Game/Online/Spectator/SpectatorClient.cs         | 12 ++++++------
 .../Overlays/Dashboard/CurrentlyPlayingDisplay.cs    |  2 +-
 osu.Game/Screens/Spectate/SpectatorScreen.cs         |  2 +-
 5 files changed, 11 insertions(+), 11 deletions(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorHost.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorHost.cs
index 409cec4cf6..6d6b0bf89e 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorHost.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorHost.cs
@@ -37,8 +37,8 @@ namespace osu.Game.Tests.Visual.Gameplay
         [Test]
         public void TestClientSendsCorrectRuleset()
         {
-            AddUntilStep("spectator client sending frames", () => spectatorClient.PlayingUserStates.ContainsKey(dummy_user_id));
-            AddAssert("spectator client sent correct ruleset", () => spectatorClient.PlayingUserStates[dummy_user_id].RulesetID == Ruleset.Value.OnlineID);
+            AddUntilStep("spectator client sending frames", () => spectatorClient.WatchingUserStates.ContainsKey(dummy_user_id));
+            AddAssert("spectator client sent correct ruleset", () => spectatorClient.WatchingUserStates[dummy_user_id].RulesetID == Ruleset.Value.OnlineID);
         }
 
         public override void TearDownSteps()
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs
index 8b71dfac21..55450b36e2 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs
@@ -115,7 +115,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             public void RandomlyUpdateState()
             {
-                foreach ((int userId, _) in PlayingUserStates)
+                foreach ((int userId, _) in WatchingUserStates)
                 {
                     if (RNG.NextBool())
                         continue;
diff --git a/osu.Game/Online/Spectator/SpectatorClient.cs b/osu.Game/Online/Spectator/SpectatorClient.cs
index 156d544960..3646c51d94 100644
--- a/osu.Game/Online/Spectator/SpectatorClient.cs
+++ b/osu.Game/Online/Spectator/SpectatorClient.cs
@@ -37,8 +37,8 @@ namespace osu.Game.Online.Spectator
 
         private readonly List<int> watchingUsers = new List<int>();
 
-        public IBindableDictionary<int, SpectatorState> PlayingUserStates => playingUserStates;
-        private readonly BindableDictionary<int, SpectatorState> playingUserStates = new BindableDictionary<int, SpectatorState>();
+        public IBindableDictionary<int, SpectatorState> WatchingUserStates => watchingUserStates;
+        private readonly BindableDictionary<int, SpectatorState> watchingUserStates = new BindableDictionary<int, SpectatorState>();
 
         private IBeatmap? currentBeatmap;
         private Score? currentScore;
@@ -85,7 +85,7 @@ namespace osu.Game.Online.Spectator
                         BeginPlayingInternal(currentState);
                 }
                 else
-                    playingUserStates.Clear();
+                    watchingUserStates.Clear();
             }), true);
         }
 
@@ -94,7 +94,7 @@ namespace osu.Game.Online.Spectator
             Schedule(() =>
             {
                 if (watchingUsers.Contains(userId))
-                    playingUserStates[userId] = state;
+                    watchingUserStates[userId] = state;
                 OnUserBeganPlaying?.Invoke(userId, state);
             });
 
@@ -106,7 +106,7 @@ namespace osu.Game.Online.Spectator
             Schedule(() =>
             {
                 if (watchingUsers.Contains(userId))
-                    playingUserStates[userId] = state;
+                    watchingUserStates[userId] = state;
                 OnUserFinishedPlaying?.Invoke(userId, state);
             });
 
@@ -193,7 +193,7 @@ namespace osu.Game.Online.Spectator
             Schedule(() =>
             {
                 watchingUsers.Remove(userId);
-                playingUserStates.Remove(userId);
+                watchingUserStates.Remove(userId);
                 StopWatchingUserInternal(userId);
             });
         }
diff --git a/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs b/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs
index 383f17d8d2..975402a443 100644
--- a/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs
+++ b/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs
@@ -51,7 +51,7 @@ namespace osu.Game.Overlays.Dashboard
         {
             base.LoadComplete();
 
-            userStates.BindTo(spectatorClient.PlayingUserStates);
+            userStates.BindTo(spectatorClient.WatchingUserStates);
             userStates.BindCollectionChanged(onUserStatesChanged, true);
         }
 
diff --git a/osu.Game/Screens/Spectate/SpectatorScreen.cs b/osu.Game/Screens/Spectate/SpectatorScreen.cs
index 783ba494eb..0b2a7cecf6 100644
--- a/osu.Game/Screens/Spectate/SpectatorScreen.cs
+++ b/osu.Game/Screens/Spectate/SpectatorScreen.cs
@@ -77,7 +77,7 @@ namespace osu.Game.Screens.Spectate
                     userMap[u.Id] = u;
                 }
 
-                userStates.BindTo(spectatorClient.PlayingUserStates);
+                userStates.BindTo(spectatorClient.WatchingUserStates);
                 userStates.BindCollectionChanged(onUserStatesChanged, true);
 
                 realmSubscription = realm.RegisterForNotifications(

From 81a22dbd29543b3ff5387669bd6ce1fc048a4811 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 2 Feb 2022 23:19:43 +0900
Subject: [PATCH 2750/5547] Add back playing users list

---
 osu.Game/Online/Spectator/SpectatorClient.cs  | 28 +++++++++--
 .../Dashboard/CurrentlyPlayingDisplay.cs      | 48 ++++++++-----------
 2 files changed, 45 insertions(+), 31 deletions(-)

diff --git a/osu.Game/Online/Spectator/SpectatorClient.cs b/osu.Game/Online/Spectator/SpectatorClient.cs
index 3646c51d94..9e168411b0 100644
--- a/osu.Game/Online/Spectator/SpectatorClient.cs
+++ b/osu.Game/Online/Spectator/SpectatorClient.cs
@@ -35,16 +35,28 @@ namespace osu.Game.Online.Spectator
         /// </summary>
         public abstract IBindable<bool> IsConnected { get; }
 
+        /// <summary>
+        /// The states of all users currently being watched.
+        /// </summary>
+        public IBindableDictionary<int, SpectatorState> WatchingUserStates => watchingUserStates;
+
+        /// <summary>
+        /// A global list of all players currently playing.
+        /// </summary>
+        public IBindableList<int> PlayingUsers => playingUsers;
+
+        /// <summary>
+        /// All users currently being watched.
+        /// </summary>
         private readonly List<int> watchingUsers = new List<int>();
 
-        public IBindableDictionary<int, SpectatorState> WatchingUserStates => watchingUserStates;
         private readonly BindableDictionary<int, SpectatorState> watchingUserStates = new BindableDictionary<int, SpectatorState>();
+        private readonly BindableList<int> playingUsers = new BindableList<int>();
+        private readonly SpectatorState currentState = new SpectatorState();
 
         private IBeatmap? currentBeatmap;
         private Score? currentScore;
 
-        private readonly SpectatorState currentState = new SpectatorState();
-
         /// <summary>
         /// Whether the local user is playing.
         /// </summary>
@@ -85,7 +97,10 @@ namespace osu.Game.Online.Spectator
                         BeginPlayingInternal(currentState);
                 }
                 else
+                {
                     watchingUserStates.Clear();
+                    playingUsers.Clear();
+                }
             }), true);
         }
 
@@ -93,8 +108,12 @@ namespace osu.Game.Online.Spectator
         {
             Schedule(() =>
             {
+                if (!playingUsers.Contains(userId))
+                    playingUsers.Add(userId);
+
                 if (watchingUsers.Contains(userId))
                     watchingUserStates[userId] = state;
+
                 OnUserBeganPlaying?.Invoke(userId, state);
             });
 
@@ -105,8 +124,11 @@ namespace osu.Game.Online.Spectator
         {
             Schedule(() =>
             {
+                playingUsers.Remove(userId);
+
                 if (watchingUsers.Contains(userId))
                     watchingUserStates[userId] = state;
+
                 OnUserFinishedPlaying?.Invoke(userId, state);
             });
 
diff --git a/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs b/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs
index 975402a443..02ef28f825 100644
--- a/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs
+++ b/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.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.Specialized;
 using System.Diagnostics;
 using System.Linq;
 using osu.Framework.Allocation;
@@ -22,7 +23,7 @@ namespace osu.Game.Overlays.Dashboard
 {
     internal class CurrentlyPlayingDisplay : CompositeDrawable
     {
-        private readonly IBindableDictionary<int, SpectatorState> userStates = new BindableDictionary<int, SpectatorState>();
+        private readonly IBindableList<int> playingUsers = new BindableList<int>();
 
         private FillFlowContainer<PlayingUserPanel> userFlow;
 
@@ -51,55 +52,46 @@ namespace osu.Game.Overlays.Dashboard
         {
             base.LoadComplete();
 
-            userStates.BindTo(spectatorClient.WatchingUserStates);
-            userStates.BindCollectionChanged(onUserStatesChanged, true);
+            playingUsers.BindTo(spectatorClient.PlayingUsers);
+            playingUsers.BindCollectionChanged(onPlayingUsersChanged, true);
         }
 
-        private void onUserStatesChanged(object sender, NotifyDictionaryChangedEventArgs<int, SpectatorState> e) => Schedule(() =>
+        private void onPlayingUsersChanged(object sender, NotifyCollectionChangedEventArgs e) => Schedule(() =>
         {
             switch (e.Action)
             {
-                case NotifyDictionaryChangedAction.Add:
-                case NotifyDictionaryChangedAction.Replace:
+                case NotifyCollectionChangedAction.Add:
                     Debug.Assert(e.NewItems != null);
 
-                    foreach ((int userId, SpectatorState state) in e.NewItems)
+                    foreach (int userId in e.NewItems)
                     {
-                        if (state.State != SpectatingUserState.Playing)
-                        {
-                            removePlayingUser(userId);
-                            continue;
-                        }
-
                         users.GetUserAsync(userId).ContinueWith(task =>
                         {
                             var user = task.GetResultSafely();
 
                             if (user != null)
-                                Schedule(() => addPlayingUser(user));
+                            {
+                                Schedule(() =>
+                                {
+                                    // user may no longer be playing.
+                                    if (!playingUsers.Contains(user.Id))
+                                        return;
+
+                                    userFlow.Add(createUserPanel(user));
+                                });
+                            }
                         });
                     }
 
                     break;
 
-                case NotifyDictionaryChangedAction.Remove:
+                case NotifyCollectionChangedAction.Remove:
                     Debug.Assert(e.OldItems != null);
 
-                    foreach ((int userId, _) in e.OldItems)
-                        removePlayingUser(userId);
+                    foreach (int userId in e.OldItems)
+                        userFlow.FirstOrDefault(card => card.User.Id == userId)?.Expire();
                     break;
             }
-
-            void addPlayingUser(APIUser user)
-            {
-                // user may no longer be playing.
-                if (!userStates.TryGetValue(user.Id, out var state2) || state2.State != SpectatingUserState.Playing)
-                    return;
-
-                userFlow.Add(createUserPanel(user));
-            }
-
-            void removePlayingUser(int userId) => userFlow.FirstOrDefault(card => card.User.Id == userId)?.Expire();
         });
 
         private PlayingUserPanel createUserPanel(APIUser user) =>

From 074a69163558c6ee6c2b177e97ed53126ab8b805 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 2 Feb 2022 17:16:35 +0300
Subject: [PATCH 2751/5547] Set keyboard step to `0.1` for difficulty adjust
 sliders

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

diff --git a/osu.Game/Rulesets/Mods/DifficultyAdjustSettingsControl.cs b/osu.Game/Rulesets/Mods/DifficultyAdjustSettingsControl.cs
index 45873a321a..c8e7284f5d 100644
--- a/osu.Game/Rulesets/Mods/DifficultyAdjustSettingsControl.cs
+++ b/osu.Game/Rulesets/Mods/DifficultyAdjustSettingsControl.cs
@@ -105,6 +105,7 @@ namespace osu.Game.Rulesets.Mods
                     {
                         ShowsDefaultIndicator = false,
                         Current = currentNumber,
+                        KeyboardStep = 0.1f,
                     }
                 };
 

From 74637444070838cc55bd0d7e04f9580f13552737 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 2 Feb 2022 19:17:33 +0100
Subject: [PATCH 2752/5547] Fix osu! autoplay-like mods not declaring
 incompatibility with `AimAssist`

---
 osu.Game.Rulesets.Osu/Mods/OsuModAutoplay.cs | 2 +-
 osu.Game.Rulesets.Osu/Mods/OsuModCinema.cs   | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModAutoplay.cs b/osu.Game.Rulesets.Osu/Mods/OsuModAutoplay.cs
index 106edfb623..2668013321 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModAutoplay.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModAutoplay.cs
@@ -14,7 +14,7 @@ namespace osu.Game.Rulesets.Osu.Mods
 {
     public class OsuModAutoplay : ModAutoplay
     {
-        public override Type[] IncompatibleMods => base.IncompatibleMods.Append(typeof(OsuModAutopilot)).Append(typeof(OsuModSpunOut)).ToArray();
+        public override Type[] IncompatibleMods => base.IncompatibleMods.Concat(new[] { typeof(OsuModAimAssist), typeof(OsuModAutopilot), typeof(OsuModSpunOut) }).ToArray();
 
         public override Score CreateReplayScore(IBeatmap beatmap, IReadOnlyList<Mod> mods) => new Score
         {
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModCinema.cs b/osu.Game.Rulesets.Osu/Mods/OsuModCinema.cs
index f478790134..ff31cfcd18 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModCinema.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModCinema.cs
@@ -15,7 +15,7 @@ namespace osu.Game.Rulesets.Osu.Mods
 {
     public class OsuModCinema : ModCinema<OsuHitObject>
     {
-        public override Type[] IncompatibleMods => base.IncompatibleMods.Append(typeof(OsuModAutopilot)).Append(typeof(OsuModSpunOut)).ToArray();
+        public override Type[] IncompatibleMods => base.IncompatibleMods.Concat(new[] { typeof(OsuModAimAssist), typeof(OsuModAutopilot), typeof(OsuModSpunOut) }).ToArray();
 
         public override Score CreateReplayScore(IBeatmap beatmap, IReadOnlyList<Mod> mods) => new Score
         {

From dca1bddabb789867e34562e20bba19d02e22fab1 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 2 Feb 2022 21:25:50 +0300
Subject: [PATCH 2753/5547] Lock supported interface orientation to landscape
 for iPhone

---
 osu.Game.Rulesets.Catch.Tests.iOS/Info.plist | 5 +++++
 osu.Game.Rulesets.Mania.Tests.iOS/Info.plist | 5 +++++
 osu.Game.Rulesets.Osu.Tests.iOS/Info.plist   | 5 +++++
 osu.Game.Rulesets.Taiko.Tests.iOS/Info.plist | 5 +++++
 osu.Game.Tests.iOS/Info.plist                | 5 +++++
 osu.iOS/Info.plist                           | 5 +++++
 6 files changed, 30 insertions(+)

diff --git a/osu.Game.Rulesets.Catch.Tests.iOS/Info.plist b/osu.Game.Rulesets.Catch.Tests.iOS/Info.plist
index 3ba1886d98..88317b6393 100644
--- a/osu.Game.Rulesets.Catch.Tests.iOS/Info.plist
+++ b/osu.Game.Rulesets.Catch.Tests.iOS/Info.plist
@@ -24,6 +24,11 @@
 		<string>armv7</string>
 	</array>
 	<key>UISupportedInterfaceOrientations</key>
+	<array>
+		<string>UIInterfaceOrientationLandscapeLeft</string>
+		<string>UIInterfaceOrientationLandscapeRight</string>
+	</array>
+	<key>UISupportedInterfaceOrientations~ipad</key>
 	<array>
 		<string>UIInterfaceOrientationPortrait</string>
 		<string>UIInterfaceOrientationPortraitUpsideDown</string>
diff --git a/osu.Game.Rulesets.Mania.Tests.iOS/Info.plist b/osu.Game.Rulesets.Mania.Tests.iOS/Info.plist
index 09ed2dd007..8d05c2bb73 100644
--- a/osu.Game.Rulesets.Mania.Tests.iOS/Info.plist
+++ b/osu.Game.Rulesets.Mania.Tests.iOS/Info.plist
@@ -24,6 +24,11 @@
 		<string>armv7</string>
 	</array>
 	<key>UISupportedInterfaceOrientations</key>
+	<array>
+		<string>UIInterfaceOrientationLandscapeLeft</string>
+		<string>UIInterfaceOrientationLandscapeRight</string>
+	</array>
+	<key>UISupportedInterfaceOrientations~ipad</key>
 	<array>
 		<string>UIInterfaceOrientationPortrait</string>
 		<string>UIInterfaceOrientationPortraitUpsideDown</string>
diff --git a/osu.Game.Rulesets.Osu.Tests.iOS/Info.plist b/osu.Game.Rulesets.Osu.Tests.iOS/Info.plist
index dd032ef1c1..63ad313a70 100644
--- a/osu.Game.Rulesets.Osu.Tests.iOS/Info.plist
+++ b/osu.Game.Rulesets.Osu.Tests.iOS/Info.plist
@@ -24,6 +24,11 @@
 		<string>armv7</string>
 	</array>
 	<key>UISupportedInterfaceOrientations</key>
+	<array>
+		<string>UIInterfaceOrientationLandscapeLeft</string>
+		<string>UIInterfaceOrientationLandscapeRight</string>
+	</array>
+	<key>UISupportedInterfaceOrientations~ipad</key>
 	<array>
 		<string>UIInterfaceOrientationPortrait</string>
 		<string>UIInterfaceOrientationPortraitUpsideDown</string>
diff --git a/osu.Game.Rulesets.Taiko.Tests.iOS/Info.plist b/osu.Game.Rulesets.Taiko.Tests.iOS/Info.plist
index ac658cd14e..3c76622ee3 100644
--- a/osu.Game.Rulesets.Taiko.Tests.iOS/Info.plist
+++ b/osu.Game.Rulesets.Taiko.Tests.iOS/Info.plist
@@ -24,6 +24,11 @@
 		<string>armv7</string>
 	</array>
 	<key>UISupportedInterfaceOrientations</key>
+	<array>
+		<string>UIInterfaceOrientationLandscapeLeft</string>
+		<string>UIInterfaceOrientationLandscapeRight</string>
+	</array>
+	<key>UISupportedInterfaceOrientations~ipad</key>
 	<array>
 		<string>UIInterfaceOrientationPortrait</string>
 		<string>UIInterfaceOrientationPortraitUpsideDown</string>
diff --git a/osu.Game.Tests.iOS/Info.plist b/osu.Game.Tests.iOS/Info.plist
index 1a89345bc5..835e958bc6 100644
--- a/osu.Game.Tests.iOS/Info.plist
+++ b/osu.Game.Tests.iOS/Info.plist
@@ -24,6 +24,11 @@
 		<string>armv7</string>
 	</array>
 	<key>UISupportedInterfaceOrientations</key>
+	<array>
+		<string>UIInterfaceOrientationLandscapeLeft</string>
+		<string>UIInterfaceOrientationLandscapeRight</string>
+	</array>
+	<key>UISupportedInterfaceOrientations~ipad</key>
 	<array>
 		<string>UIInterfaceOrientationPortrait</string>
 		<string>UIInterfaceOrientationPortraitUpsideDown</string>
diff --git a/osu.iOS/Info.plist b/osu.iOS/Info.plist
index 2592f909ce..1156c0954c 100644
--- a/osu.iOS/Info.plist
+++ b/osu.iOS/Info.plist
@@ -40,6 +40,11 @@
 	<key>NSMicrophoneUsageDescription</key>
 	<string>We don&apos;t really use the microphone.</string>
 	<key>UISupportedInterfaceOrientations</key>
+	<array>
+		<string>UIInterfaceOrientationLandscapeLeft</string>
+		<string>UIInterfaceOrientationLandscapeRight</string>
+	</array>
+	<key>UISupportedInterfaceOrientations~ipad</key>
 	<array>
 		<string>UIInterfaceOrientationPortrait</string>
 		<string>UIInterfaceOrientationPortraitUpsideDown</string>

From 4aa4df69f258bd4027c8c90abba8adaa6a3a7b28 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 2 Feb 2022 22:17:23 +0300
Subject: [PATCH 2754/5547] Reorder iOS landscape orientations to prioritise
 "Landscape Right"

"Landscape Right" is often the proper default for landscape-only applications.

Matches up with all other landscape-only iOS games I have locally.
---
 osu.Game.Rulesets.Catch.Tests.iOS/Info.plist | 4 ++--
 osu.Game.Rulesets.Mania.Tests.iOS/Info.plist | 4 ++--
 osu.Game.Rulesets.Osu.Tests.iOS/Info.plist   | 4 ++--
 osu.Game.Rulesets.Taiko.Tests.iOS/Info.plist | 4 ++--
 osu.Game.Tests.iOS/Info.plist                | 4 ++--
 osu.iOS/Info.plist                           | 4 ++--
 6 files changed, 12 insertions(+), 12 deletions(-)

diff --git a/osu.Game.Rulesets.Catch.Tests.iOS/Info.plist b/osu.Game.Rulesets.Catch.Tests.iOS/Info.plist
index 88317b6393..33ddac6dfb 100644
--- a/osu.Game.Rulesets.Catch.Tests.iOS/Info.plist
+++ b/osu.Game.Rulesets.Catch.Tests.iOS/Info.plist
@@ -25,15 +25,15 @@
 	</array>
 	<key>UISupportedInterfaceOrientations</key>
 	<array>
-		<string>UIInterfaceOrientationLandscapeLeft</string>
 		<string>UIInterfaceOrientationLandscapeRight</string>
+		<string>UIInterfaceOrientationLandscapeLeft</string>
 	</array>
 	<key>UISupportedInterfaceOrientations~ipad</key>
 	<array>
 		<string>UIInterfaceOrientationPortrait</string>
 		<string>UIInterfaceOrientationPortraitUpsideDown</string>
-		<string>UIInterfaceOrientationLandscapeLeft</string>
 		<string>UIInterfaceOrientationLandscapeRight</string>
+		<string>UIInterfaceOrientationLandscapeLeft</string>
 	</array>
 	<key>XSAppIconAssets</key>
 	<string>Assets.xcassets/AppIcon.appiconset</string>
diff --git a/osu.Game.Rulesets.Mania.Tests.iOS/Info.plist b/osu.Game.Rulesets.Mania.Tests.iOS/Info.plist
index 8d05c2bb73..78349334b4 100644
--- a/osu.Game.Rulesets.Mania.Tests.iOS/Info.plist
+++ b/osu.Game.Rulesets.Mania.Tests.iOS/Info.plist
@@ -25,15 +25,15 @@
 	</array>
 	<key>UISupportedInterfaceOrientations</key>
 	<array>
-		<string>UIInterfaceOrientationLandscapeLeft</string>
 		<string>UIInterfaceOrientationLandscapeRight</string>
+		<string>UIInterfaceOrientationLandscapeLeft</string>
 	</array>
 	<key>UISupportedInterfaceOrientations~ipad</key>
 	<array>
 		<string>UIInterfaceOrientationPortrait</string>
 		<string>UIInterfaceOrientationPortraitUpsideDown</string>
-		<string>UIInterfaceOrientationLandscapeLeft</string>
 		<string>UIInterfaceOrientationLandscapeRight</string>
+		<string>UIInterfaceOrientationLandscapeLeft</string>
 	</array>
 	<key>XSAppIconAssets</key>
 	<string>Assets.xcassets/AppIcon.appiconset</string>
diff --git a/osu.Game.Rulesets.Osu.Tests.iOS/Info.plist b/osu.Game.Rulesets.Osu.Tests.iOS/Info.plist
index 63ad313a70..b9f371c049 100644
--- a/osu.Game.Rulesets.Osu.Tests.iOS/Info.plist
+++ b/osu.Game.Rulesets.Osu.Tests.iOS/Info.plist
@@ -25,15 +25,15 @@
 	</array>
 	<key>UISupportedInterfaceOrientations</key>
 	<array>
-		<string>UIInterfaceOrientationLandscapeLeft</string>
 		<string>UIInterfaceOrientationLandscapeRight</string>
+		<string>UIInterfaceOrientationLandscapeLeft</string>
 	</array>
 	<key>UISupportedInterfaceOrientations~ipad</key>
 	<array>
 		<string>UIInterfaceOrientationPortrait</string>
 		<string>UIInterfaceOrientationPortraitUpsideDown</string>
-		<string>UIInterfaceOrientationLandscapeLeft</string>
 		<string>UIInterfaceOrientationLandscapeRight</string>
+		<string>UIInterfaceOrientationLandscapeLeft</string>
 	</array>
 	<key>XSAppIconAssets</key>
 	<string>Assets.xcassets/AppIcon.appiconset</string>
diff --git a/osu.Game.Rulesets.Taiko.Tests.iOS/Info.plist b/osu.Game.Rulesets.Taiko.Tests.iOS/Info.plist
index 3c76622ee3..65c47d2115 100644
--- a/osu.Game.Rulesets.Taiko.Tests.iOS/Info.plist
+++ b/osu.Game.Rulesets.Taiko.Tests.iOS/Info.plist
@@ -25,15 +25,15 @@
 	</array>
 	<key>UISupportedInterfaceOrientations</key>
 	<array>
-		<string>UIInterfaceOrientationLandscapeLeft</string>
 		<string>UIInterfaceOrientationLandscapeRight</string>
+		<string>UIInterfaceOrientationLandscapeLeft</string>
 	</array>
 	<key>UISupportedInterfaceOrientations~ipad</key>
 	<array>
 		<string>UIInterfaceOrientationPortrait</string>
 		<string>UIInterfaceOrientationPortraitUpsideDown</string>
-		<string>UIInterfaceOrientationLandscapeLeft</string>
 		<string>UIInterfaceOrientationLandscapeRight</string>
+		<string>UIInterfaceOrientationLandscapeLeft</string>
 	</array>
 	<key>XSAppIconAssets</key>
 	<string>Assets.xcassets/AppIcon.appiconset</string>
diff --git a/osu.Game.Tests.iOS/Info.plist b/osu.Game.Tests.iOS/Info.plist
index 835e958bc6..ed0c2e4dbf 100644
--- a/osu.Game.Tests.iOS/Info.plist
+++ b/osu.Game.Tests.iOS/Info.plist
@@ -25,15 +25,15 @@
 	</array>
 	<key>UISupportedInterfaceOrientations</key>
 	<array>
-		<string>UIInterfaceOrientationLandscapeLeft</string>
 		<string>UIInterfaceOrientationLandscapeRight</string>
+		<string>UIInterfaceOrientationLandscapeLeft</string>
 	</array>
 	<key>UISupportedInterfaceOrientations~ipad</key>
 	<array>
 		<string>UIInterfaceOrientationPortrait</string>
 		<string>UIInterfaceOrientationPortraitUpsideDown</string>
-		<string>UIInterfaceOrientationLandscapeLeft</string>
 		<string>UIInterfaceOrientationLandscapeRight</string>
+		<string>UIInterfaceOrientationLandscapeLeft</string>
 	</array>
 	<key>XSAppIconAssets</key>
 	<string>Assets.xcassets/AppIcon.appiconset</string>
diff --git a/osu.iOS/Info.plist b/osu.iOS/Info.plist
index 1156c0954c..02968b87a7 100644
--- a/osu.iOS/Info.plist
+++ b/osu.iOS/Info.plist
@@ -41,15 +41,15 @@
 	<string>We don&apos;t really use the microphone.</string>
 	<key>UISupportedInterfaceOrientations</key>
 	<array>
-		<string>UIInterfaceOrientationLandscapeLeft</string>
 		<string>UIInterfaceOrientationLandscapeRight</string>
+		<string>UIInterfaceOrientationLandscapeLeft</string>
 	</array>
 	<key>UISupportedInterfaceOrientations~ipad</key>
 	<array>
 		<string>UIInterfaceOrientationPortrait</string>
 		<string>UIInterfaceOrientationPortraitUpsideDown</string>
-		<string>UIInterfaceOrientationLandscapeLeft</string>
 		<string>UIInterfaceOrientationLandscapeRight</string>
+		<string>UIInterfaceOrientationLandscapeLeft</string>
 	</array>
 	<key>XSAppIconAssets</key>
 	<string>Assets.xcassets/AppIcon.appiconset</string>

From 82f9ad63f514f1220c44bb087d58a154a1e1f2c4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 2 Feb 2022 20:41:25 +0100
Subject: [PATCH 2755/5547] Fix flashlight size multiplier printing with too
 many decimal digits

---
 osu.Game.Rulesets.Catch/Mods/CatchModFlashlight.cs | 2 +-
 osu.Game.Rulesets.Mania/Mods/ManiaModFlashlight.cs | 2 +-
 osu.Game.Rulesets.Osu/Mods/OsuModFlashlight.cs     | 2 +-
 osu.Game.Rulesets.Taiko/Mods/TaikoModFlashlight.cs | 2 +-
 osu.Game/Rulesets/Mods/ModFlashlight.cs            | 2 +-
 5 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/osu.Game.Rulesets.Catch/Mods/CatchModFlashlight.cs b/osu.Game.Rulesets.Catch/Mods/CatchModFlashlight.cs
index 2d92c925d7..d576ea3df8 100644
--- a/osu.Game.Rulesets.Catch/Mods/CatchModFlashlight.cs
+++ b/osu.Game.Rulesets.Catch/Mods/CatchModFlashlight.cs
@@ -17,7 +17,7 @@ namespace osu.Game.Rulesets.Catch.Mods
         public override double ScoreMultiplier => 1.12;
 
         [SettingSource("Flashlight size", "Multiplier applied to the default flashlight size.")]
-        public override BindableNumber<float> SizeMultiplier { get; } = new BindableNumber<float>
+        public override BindableFloat SizeMultiplier { get; } = new BindableFloat
         {
             MinValue = 0.5f,
             MaxValue = 1.5f,
diff --git a/osu.Game.Rulesets.Mania/Mods/ManiaModFlashlight.cs b/osu.Game.Rulesets.Mania/Mods/ManiaModFlashlight.cs
index 1ee4ea12e3..8ef5bfd94c 100644
--- a/osu.Game.Rulesets.Mania/Mods/ManiaModFlashlight.cs
+++ b/osu.Game.Rulesets.Mania/Mods/ManiaModFlashlight.cs
@@ -18,7 +18,7 @@ namespace osu.Game.Rulesets.Mania.Mods
         public override Type[] IncompatibleMods => new[] { typeof(ModHidden) };
 
         [SettingSource("Flashlight size", "Multiplier applied to the default flashlight size.")]
-        public override BindableNumber<float> SizeMultiplier { get; } = new BindableNumber<float>
+        public override BindableFloat SizeMultiplier { get; } = new BindableFloat
         {
             MinValue = 0.5f,
             MaxValue = 3f,
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModFlashlight.cs b/osu.Game.Rulesets.Osu/Mods/OsuModFlashlight.cs
index b4eff57c55..38c84be295 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModFlashlight.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModFlashlight.cs
@@ -31,7 +31,7 @@ namespace osu.Game.Rulesets.Osu.Mods
         };
 
         [SettingSource("Flashlight size", "Multiplier applied to the default flashlight size.")]
-        public override BindableNumber<float> SizeMultiplier { get; } = new BindableNumber<float>
+        public override BindableFloat SizeMultiplier { get; } = new BindableFloat
         {
             MinValue = 0.5f,
             MaxValue = 2f,
diff --git a/osu.Game.Rulesets.Taiko/Mods/TaikoModFlashlight.cs b/osu.Game.Rulesets.Taiko/Mods/TaikoModFlashlight.cs
index fb07c687bb..beec785fe8 100644
--- a/osu.Game.Rulesets.Taiko/Mods/TaikoModFlashlight.cs
+++ b/osu.Game.Rulesets.Taiko/Mods/TaikoModFlashlight.cs
@@ -18,7 +18,7 @@ namespace osu.Game.Rulesets.Taiko.Mods
         public override double ScoreMultiplier => 1.12;
 
         [SettingSource("Flashlight size", "Multiplier applied to the default flashlight size.")]
-        public override BindableNumber<float> SizeMultiplier { get; } = new BindableNumber<float>
+        public override BindableFloat SizeMultiplier { get; } = new BindableFloat
         {
             MinValue = 0.5f,
             MaxValue = 1.5f,
diff --git a/osu.Game/Rulesets/Mods/ModFlashlight.cs b/osu.Game/Rulesets/Mods/ModFlashlight.cs
index e6487c6b29..b449f3f64d 100644
--- a/osu.Game/Rulesets/Mods/ModFlashlight.cs
+++ b/osu.Game/Rulesets/Mods/ModFlashlight.cs
@@ -34,7 +34,7 @@ namespace osu.Game.Rulesets.Mods
         public override string Description => "Restricted view area.";
 
         [SettingSource("Flashlight size", "Multiplier applied to the default flashlight size.")]
-        public abstract BindableNumber<float> SizeMultiplier { get; }
+        public abstract BindableFloat SizeMultiplier { get; }
 
         [SettingSource("Change size based on combo", "Decrease the flashlight size as combo increases.")]
         public abstract BindableBool ComboBasedSize { get; }

From e2fcdc394b25cbeb0af8a74c4e68bd79f722f8c9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 23 Jan 2022 16:29:00 +0100
Subject: [PATCH 2756/5547] Extract method for difficulty switch menu creation

---
 osu.Game/Screens/Edit/Editor.cs | 26 ++++++++++++++------------
 1 file changed, 14 insertions(+), 12 deletions(-)

diff --git a/osu.Game/Screens/Edit/Editor.cs b/osu.Game/Screens/Edit/Editor.cs
index 2fead84deb..71a19c4425 100644
--- a/osu.Game/Screens/Edit/Editor.cs
+++ b/osu.Game/Screens/Edit/Editor.cs
@@ -806,6 +806,15 @@ namespace osu.Game.Screens.Edit
 
             fileMenuItems.Add(new EditorMenuItemSpacer());
 
+            fileMenuItems.Add(createDifficultySwitchMenu());
+
+            fileMenuItems.Add(new EditorMenuItemSpacer());
+            fileMenuItems.Add(new EditorMenuItem("Exit", MenuItemType.Standard, this.Exit));
+            return fileMenuItems;
+        }
+
+        private EditorMenuItem createDifficultySwitchMenu()
+        {
             var beatmapSet = playableBeatmap.BeatmapInfo.BeatmapSet;
 
             Debug.Assert(beatmapSet != null);
@@ -818,20 +827,13 @@ namespace osu.Game.Screens.Edit
                     difficultyItems.Add(new EditorMenuItemSpacer());
 
                 foreach (var beatmap in rulesetBeatmaps.OrderBy(b => b.StarRating))
-                    difficultyItems.Add(createDifficultyMenuItem(beatmap));
+                {
+                    bool isCurrentDifficulty = playableBeatmap.BeatmapInfo.Equals(beatmap);
+                    difficultyItems.Add(new DifficultyMenuItem(beatmap, isCurrentDifficulty, SwitchToDifficulty));
+                }
             }
 
-            fileMenuItems.Add(new EditorMenuItem("Change difficulty") { Items = difficultyItems });
-
-            fileMenuItems.Add(new EditorMenuItemSpacer());
-            fileMenuItems.Add(new EditorMenuItem("Exit", MenuItemType.Standard, this.Exit));
-            return fileMenuItems;
-        }
-
-        private DifficultyMenuItem createDifficultyMenuItem(BeatmapInfo beatmapInfo)
-        {
-            bool isCurrentDifficulty = playableBeatmap.BeatmapInfo.Equals(beatmapInfo);
-            return new DifficultyMenuItem(beatmapInfo, isCurrentDifficulty, SwitchToDifficulty);
+            return new EditorMenuItem("Change difficulty") { Items = difficultyItems };
         }
 
         protected void SwitchToDifficulty(BeatmapInfo nextBeatmap) => loader?.ScheduleDifficultySwitch(nextBeatmap, GetState(nextBeatmap));

From 3386f038ba0857f47934c438d7d8a7024e06285c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 23 Jan 2022 16:34:02 +0100
Subject: [PATCH 2757/5547] Add new difficulty creation menu

---
 osu.Game/Screens/Edit/Editor.cs | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/osu.Game/Screens/Edit/Editor.cs b/osu.Game/Screens/Edit/Editor.cs
index 71a19c4425..61c5fd2ca4 100644
--- a/osu.Game/Screens/Edit/Editor.cs
+++ b/osu.Game/Screens/Edit/Editor.cs
@@ -77,6 +77,9 @@ namespace osu.Game.Screens.Edit
         [Resolved]
         private BeatmapManager beatmapManager { get; set; }
 
+        [Resolved]
+        private RulesetStore rulesets { get; set; }
+
         [Resolved]
         private Storage storage { get; set; }
 
@@ -806,6 +809,7 @@ namespace osu.Game.Screens.Edit
 
             fileMenuItems.Add(new EditorMenuItemSpacer());
 
+            fileMenuItems.Add(createDifficultyCreationMenu());
             fileMenuItems.Add(createDifficultySwitchMenu());
 
             fileMenuItems.Add(new EditorMenuItemSpacer());
@@ -813,6 +817,16 @@ namespace osu.Game.Screens.Edit
             return fileMenuItems;
         }
 
+        private EditorMenuItem createDifficultyCreationMenu()
+        {
+            var rulesetItems = new List<MenuItem>();
+
+            foreach (var ruleset in rulesets.AvailableRulesets.OrderBy(ruleset => ruleset.OnlineID))
+                rulesetItems.Add(new EditorMenuItem(ruleset.Name));
+
+            return new EditorMenuItem("Create new difficulty") { Items = rulesetItems };
+        }
+
         private EditorMenuItem createDifficultySwitchMenu()
         {
             var beatmapSet = playableBeatmap.BeatmapInfo.BeatmapSet;

From b613aedeb81ea46bcb664b9b76feac179252778f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 23 Jan 2022 16:36:18 +0100
Subject: [PATCH 2758/5547] Fix menu item width changing when hovered

---
 osu.Game/Graphics/UserInterface/DrawableOsuMenuItem.cs | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Graphics/UserInterface/DrawableOsuMenuItem.cs b/osu.Game/Graphics/UserInterface/DrawableOsuMenuItem.cs
index 4267b82bb7..4ecc543ffd 100644
--- a/osu.Game/Graphics/UserInterface/DrawableOsuMenuItem.cs
+++ b/osu.Game/Graphics/UserInterface/DrawableOsuMenuItem.cs
@@ -117,6 +117,7 @@ namespace osu.Game.Graphics.UserInterface
                 {
                     NormalText = new OsuSpriteText
                     {
+                        AlwaysPresent = true, // ensures that the menu item does not change width when switching between normal and bold text.
                         Anchor = Anchor.CentreLeft,
                         Origin = Anchor.CentreLeft,
                         Font = OsuFont.GetFont(size: text_size),
@@ -124,7 +125,7 @@ namespace osu.Game.Graphics.UserInterface
                     },
                     BoldText = new OsuSpriteText
                     {
-                        AlwaysPresent = true,
+                        AlwaysPresent = true, // ensures that the menu item does not change width when switching between normal and bold text.
                         Alpha = 0,
                         Anchor = Anchor.CentreLeft,
                         Origin = Anchor.CentreLeft,

From dc96c4888bfa5fa04ddd4228b9bf218d206a71c6 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 23 Jan 2022 17:49:17 +0100
Subject: [PATCH 2759/5547] Add support for creating new blank difficulties

---
 osu.Game/Beatmaps/BeatmapManager.cs        | 32 +++++++++++++++++++++-
 osu.Game/Beatmaps/BeatmapMetadata.cs       | 16 ++++++++++-
 osu.Game/Beatmaps/BeatmapModelManager.cs   | 23 ++++++++++++++--
 osu.Game/Database/RealmObjectExtensions.cs | 11 +++++++-
 osu.Game/Models/RealmUser.cs               |  6 +++-
 osu.Game/Screens/Edit/Editor.cs            |  7 +++--
 osu.Game/Screens/Edit/EditorLoader.cs      | 11 ++++++--
 7 files changed, 95 insertions(+), 11 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index e4fdb3d471..38ba244f28 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -73,7 +73,9 @@ namespace osu.Game.Beatmaps
             new BeatmapModelManager(realm, storage, onlineLookupQueue);
 
         /// <summary>
-        /// Create a new <see cref="WorkingBeatmap"/>.
+        /// Create a new beatmap set, backed by a <see cref="BeatmapSetInfo"/> model,
+        /// with a single difficulty which is backed by a <see cref="BeatmapInfo"/> model
+        /// and represented by the returned usable <see cref="WorkingBeatmap"/>.
         /// </summary>
         public WorkingBeatmap CreateNew(RulesetInfo ruleset, APIUser user)
         {
@@ -105,6 +107,34 @@ namespace osu.Game.Beatmaps
             return imported.PerformRead(s => GetWorkingBeatmap(s.Beatmaps.First()));
         }
 
+        /// <summary>
+        /// Add a new difficulty to the beatmap set represented by the provided <see cref="BeatmapSetInfo"/>.
+        /// The new difficulty will be backed by a <see cref="BeatmapInfo"/> model
+        /// and represented by the returned <see cref="WorkingBeatmap"/>.
+        /// </summary>
+        public WorkingBeatmap CreateNewBlankDifficulty(BeatmapSetInfo beatmapSetInfo, RulesetInfo rulesetInfo)
+        {
+            // fetch one of the existing difficulties to copy timing points and metadata from,
+            // so that the user doesn't have to fill all of that out again.
+            // this silently assumes that all difficulties have the same timing points and metadata,
+            // but cases where this isn't true seem rather rare / pathological.
+            var referenceBeatmap = GetWorkingBeatmap(beatmapSetInfo.Beatmaps.First());
+
+            var newBeatmap = new Beatmap
+            {
+                BeatmapInfo = new BeatmapInfo(rulesetInfo, new BeatmapDifficulty(), referenceBeatmap.Metadata.DeepClone())
+            };
+
+            foreach (var timingPoint in referenceBeatmap.Beatmap.ControlPointInfo.TimingPoints)
+                newBeatmap.ControlPointInfo.Add(timingPoint.Time, timingPoint.DeepClone());
+
+            var createdBeatmapInfo = beatmapModelManager.AddDifficultyToBeatmapSet(beatmapSetInfo, newBeatmap);
+            return GetWorkingBeatmap(createdBeatmapInfo);
+        }
+
+        // TODO: add back support for making a copy of another difficulty
+        // (likely via a separate `CopyDifficulty()` method).
+
         /// <summary>
         /// Delete a beatmap difficulty.
         /// </summary>
diff --git a/osu.Game/Beatmaps/BeatmapMetadata.cs b/osu.Game/Beatmaps/BeatmapMetadata.cs
index f6666a6ea9..3a24c4808f 100644
--- a/osu.Game/Beatmaps/BeatmapMetadata.cs
+++ b/osu.Game/Beatmaps/BeatmapMetadata.cs
@@ -7,6 +7,7 @@ using Newtonsoft.Json;
 using osu.Framework.Testing;
 using osu.Game.Models;
 using osu.Game.Users;
+using osu.Game.Utils;
 using Realms;
 
 #nullable enable
@@ -16,7 +17,7 @@ namespace osu.Game.Beatmaps
     [ExcludeFromDynamicCompile]
     [Serializable]
     [MapTo("BeatmapMetadata")]
-    public class BeatmapMetadata : RealmObject, IBeatmapMetadataInfo
+    public class BeatmapMetadata : RealmObject, IBeatmapMetadataInfo, IDeepCloneable<BeatmapMetadata>
     {
         public string Title { get; set; } = string.Empty;
 
@@ -57,5 +58,18 @@ namespace osu.Game.Beatmaps
         IUser IBeatmapMetadataInfo.Author => Author;
 
         public override string ToString() => this.GetDisplayTitle();
+
+        public BeatmapMetadata DeepClone() => new BeatmapMetadata(Author.DeepClone())
+        {
+            Title = Title,
+            TitleUnicode = TitleUnicode,
+            Artist = Artist,
+            ArtistUnicode = ArtistUnicode,
+            Source = Source,
+            Tags = Tags,
+            PreviewTime = PreviewTime,
+            AudioFile = AudioFile,
+            BackgroundFile = BackgroundFile
+        };
     }
 }
diff --git a/osu.Game/Beatmaps/BeatmapModelManager.cs b/osu.Game/Beatmaps/BeatmapModelManager.cs
index e8104f2ecb..2ab5ac1db9 100644
--- a/osu.Game/Beatmaps/BeatmapModelManager.cs
+++ b/osu.Game/Beatmaps/BeatmapModelManager.cs
@@ -49,7 +49,6 @@ namespace osu.Game.Beatmaps
         public virtual void Save(BeatmapInfo beatmapInfo, IBeatmap beatmapContent, ISkin? beatmapSkin = null)
         {
             var setInfo = beatmapInfo.BeatmapSet;
-
             Debug.Assert(setInfo != null);
 
             // Difficulty settings must be copied first due to the clone in `Beatmap<>.BeatmapInfo_Set`.
@@ -85,6 +84,24 @@ namespace osu.Game.Beatmaps
             WorkingBeatmapCache?.Invalidate(beatmapInfo);
         }
 
+        /// <summary>
+        /// Add a new difficulty to the beatmap set represented by the provided <see cref="BeatmapSetInfo"/>.
+        /// </summary>
+        public BeatmapInfo AddDifficultyToBeatmapSet(BeatmapSetInfo beatmapSetInfo, Beatmap beatmap)
+        {
+            return Realm.Run(realm =>
+            {
+                var beatmapInfo = beatmap.BeatmapInfo;
+
+                beatmapSetInfo.Beatmaps.Add(beatmapInfo);
+                beatmapInfo.BeatmapSet = beatmapSetInfo;
+
+                Save(beatmapInfo, beatmap);
+
+                return beatmapInfo.Detach();
+            });
+        }
+
         private static string getFilename(BeatmapInfo beatmapInfo)
         {
             var metadata = beatmapInfo.Metadata;
@@ -103,9 +120,9 @@ namespace osu.Game.Beatmaps
 
         public void Update(BeatmapSetInfo item)
         {
-            Realm.Write(realm =>
+            Realm.Write(r =>
             {
-                var existing = realm.Find<BeatmapSetInfo>(item.ID);
+                var existing = r.Find<BeatmapSetInfo>(item.ID);
                 item.CopyChangesToRealm(existing);
             });
         }
diff --git a/osu.Game/Database/RealmObjectExtensions.cs b/osu.Game/Database/RealmObjectExtensions.cs
index 7a0ca2c85a..f89bbbe19d 100644
--- a/osu.Game/Database/RealmObjectExtensions.cs
+++ b/osu.Game/Database/RealmObjectExtensions.cs
@@ -58,7 +58,16 @@ namespace osu.Game.Database
                      if (existing != null)
                          copyChangesToRealm(beatmap, existing);
                      else
-                         d.Beatmaps.Add(beatmap);
+                     {
+                         var newBeatmap = new BeatmapInfo
+                         {
+                             ID = beatmap.ID,
+                             BeatmapSet = d,
+                             Ruleset = d.Realm.Find<RulesetInfo>(beatmap.Ruleset.ShortName)
+                         };
+                         d.Beatmaps.Add(newBeatmap);
+                         copyChangesToRealm(beatmap, newBeatmap);
+                     }
                  }
              });
 
diff --git a/osu.Game/Models/RealmUser.cs b/osu.Game/Models/RealmUser.cs
index 5fccff597c..18c849cf0a 100644
--- a/osu.Game/Models/RealmUser.cs
+++ b/osu.Game/Models/RealmUser.cs
@@ -2,12 +2,14 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
+using osu.Game.Database;
 using osu.Game.Users;
+using osu.Game.Utils;
 using Realms;
 
 namespace osu.Game.Models
 {
-    public class RealmUser : EmbeddedObject, IUser, IEquatable<RealmUser>
+    public class RealmUser : EmbeddedObject, IUser, IEquatable<RealmUser>, IDeepCloneable<RealmUser>
     {
         public int OnlineID { get; set; } = 1;
 
@@ -22,5 +24,7 @@ namespace osu.Game.Models
 
             return OnlineID == other.OnlineID && Username == other.Username;
         }
+
+        public RealmUser DeepClone() => (RealmUser)this.Detach().MemberwiseClone();
     }
 }
diff --git a/osu.Game/Screens/Edit/Editor.cs b/osu.Game/Screens/Edit/Editor.cs
index 61c5fd2ca4..df8e326c5b 100644
--- a/osu.Game/Screens/Edit/Editor.cs
+++ b/osu.Game/Screens/Edit/Editor.cs
@@ -822,11 +822,14 @@ namespace osu.Game.Screens.Edit
             var rulesetItems = new List<MenuItem>();
 
             foreach (var ruleset in rulesets.AvailableRulesets.OrderBy(ruleset => ruleset.OnlineID))
-                rulesetItems.Add(new EditorMenuItem(ruleset.Name));
+                rulesetItems.Add(new EditorMenuItem(ruleset.Name, MenuItemType.Standard, () => createNewDifficulty(ruleset)));
 
             return new EditorMenuItem("Create new difficulty") { Items = rulesetItems };
         }
 
+        private void createNewDifficulty(RulesetInfo rulesetInfo)
+            => loader?.ScheduleSwitchToNewDifficulty(editorBeatmap.BeatmapInfo.BeatmapSet, rulesetInfo, GetState());
+
         private EditorMenuItem createDifficultySwitchMenu()
         {
             var beatmapSet = playableBeatmap.BeatmapInfo.BeatmapSet;
@@ -850,7 +853,7 @@ namespace osu.Game.Screens.Edit
             return new EditorMenuItem("Change difficulty") { Items = difficultyItems };
         }
 
-        protected void SwitchToDifficulty(BeatmapInfo nextBeatmap) => loader?.ScheduleDifficultySwitch(nextBeatmap, GetState(nextBeatmap));
+        protected void SwitchToDifficulty(BeatmapInfo nextBeatmap) => loader?.ScheduleSwitchToExistingDifficulty(nextBeatmap, GetState(nextBeatmap));
 
         private void cancelExit()
         {
diff --git a/osu.Game/Screens/Edit/EditorLoader.cs b/osu.Game/Screens/Edit/EditorLoader.cs
index 15d70e28b6..731bc75b52 100644
--- a/osu.Game/Screens/Edit/EditorLoader.cs
+++ b/osu.Game/Screens/Edit/EditorLoader.cs
@@ -10,6 +10,7 @@ using osu.Framework.Screens;
 using osu.Framework.Threading;
 using osu.Game.Beatmaps;
 using osu.Game.Graphics.UserInterface;
+using osu.Game.Rulesets;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Screens.Menu;
 using osu.Game.Screens.Play;
@@ -78,7 +79,13 @@ namespace osu.Game.Screens.Edit
             }
         }
 
-        public void ScheduleDifficultySwitch(BeatmapInfo nextBeatmap, EditorState editorState)
+        public void ScheduleSwitchToNewDifficulty(BeatmapSetInfo beatmapSetInfo, RulesetInfo rulesetInfo, EditorState editorState)
+            => scheduleDifficultySwitch(() => beatmapManager.CreateNewBlankDifficulty(beatmapSetInfo, rulesetInfo), editorState);
+
+        public void ScheduleSwitchToExistingDifficulty(BeatmapInfo beatmapInfo, EditorState editorState)
+            => scheduleDifficultySwitch(() => beatmapManager.GetWorkingBeatmap(beatmapInfo), editorState);
+
+        private void scheduleDifficultySwitch(Func<WorkingBeatmap> nextBeatmap, EditorState editorState)
         {
             scheduledDifficultySwitch?.Cancel();
             ValidForResume = true;
@@ -87,7 +94,7 @@ namespace osu.Game.Screens.Edit
 
             scheduledDifficultySwitch = Schedule(() =>
             {
-                Beatmap.Value = beatmapManager.GetWorkingBeatmap(nextBeatmap);
+                Beatmap.Value = nextBeatmap.Invoke();
                 state = editorState;
 
                 // This screen is a weird exception to the rule that nothing after song select changes the global beatmap.

From 0d51c015addfcd10fdcc24f6ef37446ef7c1fdb6 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 23 Jan 2022 18:34:33 +0100
Subject: [PATCH 2760/5547] Add basic test coverage for new difficulty creation

---
 .../Editing/TestSceneEditorBeatmapCreation.cs | 40 +++++++++++++++++++
 osu.Game/Screens/Edit/Editor.cs               |  4 +-
 osu.Game/Tests/Visual/EditorTestScene.cs      |  2 +
 3 files changed, 44 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneEditorBeatmapCreation.cs b/osu.Game.Tests/Visual/Editing/TestSceneEditorBeatmapCreation.cs
index e3fb44534b..9ceff86426 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneEditorBeatmapCreation.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneEditorBeatmapCreation.cs
@@ -90,5 +90,45 @@ namespace osu.Game.Tests.Visual.Editing
 
             AddAssert("track length changed", () => Beatmap.Value.Track.Length > 60000);
         }
+
+        [Test]
+        public void TestCreateNewDifficulty()
+        {
+            string firstDifficultyName = Guid.NewGuid().ToString();
+            string secondDifficultyName = Guid.NewGuid().ToString();
+
+            AddStep("set unique difficulty name", () => EditorBeatmap.BeatmapInfo.DifficultyName = firstDifficultyName);
+            AddStep("save beatmap", () => Editor.Save());
+            AddAssert("new beatmap persisted", () =>
+            {
+                var beatmap = beatmapManager.QueryBeatmap(b => b.DifficultyName == firstDifficultyName);
+                var set = beatmapManager.QueryBeatmapSet(s => s.ID == EditorBeatmap.BeatmapInfo.BeatmapSet.ID);
+
+                return beatmap != null
+                       && beatmap.DifficultyName == firstDifficultyName
+                       && set != null
+                       && set.PerformRead(s => s.Beatmaps.Single().ID == beatmap.ID);
+            });
+
+            AddStep("create new difficulty", () => Editor.CreateNewDifficulty(new OsuRuleset().RulesetInfo));
+            AddUntilStep("wait for created", () =>
+            {
+                string difficultyName = Editor.ChildrenOfType<EditorBeatmap>().SingleOrDefault()?.BeatmapInfo.DifficultyName;
+                return difficultyName != null && difficultyName != firstDifficultyName;
+            });
+
+            AddStep("set unique difficulty name", () => EditorBeatmap.BeatmapInfo.DifficultyName = secondDifficultyName);
+            AddStep("save beatmap", () => Editor.Save());
+            AddAssert("new beatmap persisted", () =>
+            {
+                var beatmap = beatmapManager.QueryBeatmap(b => b.DifficultyName == secondDifficultyName);
+                var set = beatmapManager.QueryBeatmapSet(s => s.ID == EditorBeatmap.BeatmapInfo.BeatmapSet.ID);
+
+                return beatmap != null
+                       && beatmap.DifficultyName == secondDifficultyName
+                       && set != null
+                       && set.PerformRead(s => s.Beatmaps.Count == 2 && s.Beatmaps.Any(b => b.DifficultyName == secondDifficultyName));
+            });
+        }
     }
 }
diff --git a/osu.Game/Screens/Edit/Editor.cs b/osu.Game/Screens/Edit/Editor.cs
index df8e326c5b..3d7677ce19 100644
--- a/osu.Game/Screens/Edit/Editor.cs
+++ b/osu.Game/Screens/Edit/Editor.cs
@@ -822,12 +822,12 @@ namespace osu.Game.Screens.Edit
             var rulesetItems = new List<MenuItem>();
 
             foreach (var ruleset in rulesets.AvailableRulesets.OrderBy(ruleset => ruleset.OnlineID))
-                rulesetItems.Add(new EditorMenuItem(ruleset.Name, MenuItemType.Standard, () => createNewDifficulty(ruleset)));
+                rulesetItems.Add(new EditorMenuItem(ruleset.Name, MenuItemType.Standard, () => CreateNewDifficulty(ruleset)));
 
             return new EditorMenuItem("Create new difficulty") { Items = rulesetItems };
         }
 
-        private void createNewDifficulty(RulesetInfo rulesetInfo)
+        protected void CreateNewDifficulty(RulesetInfo rulesetInfo)
             => loader?.ScheduleSwitchToNewDifficulty(editorBeatmap.BeatmapInfo.BeatmapSet, rulesetInfo, GetState());
 
         private EditorMenuItem createDifficultySwitchMenu()
diff --git a/osu.Game/Tests/Visual/EditorTestScene.cs b/osu.Game/Tests/Visual/EditorTestScene.cs
index bcf169bb1e..52d61ed422 100644
--- a/osu.Game/Tests/Visual/EditorTestScene.cs
+++ b/osu.Game/Tests/Visual/EditorTestScene.cs
@@ -107,6 +107,8 @@ namespace osu.Game.Tests.Visual
 
             public new void SwitchToDifficulty(BeatmapInfo beatmapInfo) => base.SwitchToDifficulty(beatmapInfo);
 
+            public new void CreateNewDifficulty(RulesetInfo rulesetInfo) => base.CreateNewDifficulty(rulesetInfo);
+
             public new bool HasUnsavedChanges => base.HasUnsavedChanges;
 
             public TestEditor(EditorLoader loader = null)

From 54bb6ad40c992cb55de194ed12aac4686fea6ee6 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 23 Jan 2022 18:56:19 +0100
Subject: [PATCH 2761/5547] Fix working beatmaps not seeing new difficulties
 after add

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

diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index 38ba244f28..d9b0ec3170 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -129,6 +129,8 @@ namespace osu.Game.Beatmaps
                 newBeatmap.ControlPointInfo.Add(timingPoint.Time, timingPoint.DeepClone());
 
             var createdBeatmapInfo = beatmapModelManager.AddDifficultyToBeatmapSet(beatmapSetInfo, newBeatmap);
+
+            workingBeatmapCache.Invalidate(createdBeatmapInfo.BeatmapSet);
             return GetWorkingBeatmap(createdBeatmapInfo);
         }
 

From 87e2e83288ec72a569207d0854dbba49bf4880b2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 23 Jan 2022 19:25:59 +0100
Subject: [PATCH 2762/5547] Add test coverage for difficulty name clash cases

---
 .../Editing/TestSceneEditorBeatmapCreation.cs | 54 +++++++++++++++++++
 1 file changed, 54 insertions(+)

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneEditorBeatmapCreation.cs b/osu.Game.Tests/Visual/Editing/TestSceneEditorBeatmapCreation.cs
index 9ceff86426..31348c1e17 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneEditorBeatmapCreation.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneEditorBeatmapCreation.cs
@@ -130,5 +130,59 @@ namespace osu.Game.Tests.Visual.Editing
                        && set.PerformRead(s => s.Beatmaps.Count == 2 && s.Beatmaps.Any(b => b.DifficultyName == secondDifficultyName));
             });
         }
+
+        [Test]
+        public void TestCreateNewBeatmapFailsWithBlankNamedDifficulties()
+        {
+            Guid setId = Guid.Empty;
+
+            AddStep("retrieve set ID", () => setId = EditorBeatmap.BeatmapInfo.BeatmapSet!.ID);
+            AddStep("save beatmap", () => Editor.Save());
+            AddAssert("new beatmap persisted", () =>
+            {
+                var set = beatmapManager.QueryBeatmapSet(s => s.ID == setId);
+                return set != null && set.PerformRead(s => s.Beatmaps.Count == 1 && s.Files.Count == 1);
+            });
+
+            AddStep("try to create new difficulty", () => Editor.CreateNewDifficulty(new OsuRuleset().RulesetInfo));
+            AddAssert("beatmap set unchanged", () =>
+            {
+                var set = beatmapManager.QueryBeatmapSet(s => s.ID == setId);
+                return set != null && set.PerformRead(s => s.Beatmaps.Count == 1 && s.Files.Count == 1);
+            });
+        }
+
+        [Test]
+        public void TestCreateNewBeatmapFailsWithSameNamedDifficulties()
+        {
+            Guid setId = Guid.Empty;
+            const string duplicate_difficulty_name = "duplicate";
+
+            AddStep("retrieve set ID", () => setId = EditorBeatmap.BeatmapInfo.BeatmapSet!.ID);
+            AddStep("set difficulty name", () => EditorBeatmap.BeatmapInfo.DifficultyName = duplicate_difficulty_name);
+            AddStep("save beatmap", () => Editor.Save());
+            AddAssert("new beatmap persisted", () =>
+            {
+                var set = beatmapManager.QueryBeatmapSet(s => s.ID == setId);
+                return set != null && set.PerformRead(s => s.Beatmaps.Count == 1 && s.Files.Count == 1);
+            });
+
+            AddStep("create new difficulty", () => Editor.CreateNewDifficulty(new OsuRuleset().RulesetInfo));
+            AddUntilStep("wait for created", () =>
+            {
+                string difficultyName = Editor.ChildrenOfType<EditorBeatmap>().SingleOrDefault()?.BeatmapInfo.DifficultyName;
+                return difficultyName != null && difficultyName != duplicate_difficulty_name;
+            });
+
+            AddStep("set difficulty name", () => EditorBeatmap.BeatmapInfo.DifficultyName = duplicate_difficulty_name);
+            AddStep("try to save beatmap", () => Editor.Save());
+            AddAssert("beatmap set not corrupted", () =>
+            {
+                var set = beatmapManager.QueryBeatmapSet(s => s.ID == setId);
+                // the difficulty was already created at the point of the switch.
+                // what we want to check is that both difficulties do not use the same file.
+                return set != null && set.PerformRead(s => s.Beatmaps.Count == 2 && s.Files.Count == 2);
+            });
+        }
     }
 }

From 4f1aac9345f8e4b292d079b630c2a00e62a264ca Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 23 Jan 2022 19:42:07 +0100
Subject: [PATCH 2763/5547] Add safeties preventing creating multiple
 difficulties with same name

---
 osu.Game/Beatmaps/BeatmapModelManager.cs |  6 ++++++
 osu.Game/Screens/Edit/Editor.cs          | 16 ++++++++++++----
 osu.Game/Screens/Edit/EditorLoader.cs    | 16 +++++++++++++++-
 3 files changed, 33 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapModelManager.cs b/osu.Game/Beatmaps/BeatmapModelManager.cs
index 2ab5ac1db9..327e10e643 100644
--- a/osu.Game/Beatmaps/BeatmapModelManager.cs
+++ b/osu.Game/Beatmaps/BeatmapModelManager.cs
@@ -71,6 +71,12 @@ namespace osu.Game.Beatmaps
 
                 // AddFile generally handles updating/replacing files, but this is a case where the filename may have also changed so let's delete for simplicity.
                 var existingFileInfo = setInfo.Files.SingleOrDefault(f => string.Equals(f.Filename, beatmapInfo.Path, StringComparison.OrdinalIgnoreCase));
+                string targetFilename = getFilename(beatmapInfo);
+
+                // ensure that two difficulties from the set don't point at the same beatmap file.
+                if (setInfo.Beatmaps.Any(b => string.Equals(b.Path, targetFilename, StringComparison.OrdinalIgnoreCase)))
+                    throw new InvalidOperationException($"{setInfo.GetDisplayString()} already has a difficulty with the name of '{beatmapInfo.DifficultyName}'.");
+
                 if (existingFileInfo != null)
                     DeleteFile(setInfo, existingFileInfo);
 
diff --git a/osu.Game/Screens/Edit/Editor.cs b/osu.Game/Screens/Edit/Editor.cs
index 3d7677ce19..64b23ccda8 100644
--- a/osu.Game/Screens/Edit/Editor.cs
+++ b/osu.Game/Screens/Edit/Editor.cs
@@ -386,12 +386,20 @@ namespace osu.Game.Screens.Edit
                 return;
             }
 
+            try
+            {
+                // save the loaded beatmap's data stream.
+                beatmapManager.Save(editorBeatmap.BeatmapInfo, editorBeatmap.PlayableBeatmap, editorBeatmap.BeatmapSkin);
+            }
+            catch (Exception ex)
+            {
+                // can fail e.g. due to duplicated difficulty names.
+                Logger.Error(ex, ex.Message);
+                return;
+            }
+
             // no longer new after first user-triggered save.
             isNewBeatmap = false;
-
-            // save the loaded beatmap's data stream.
-            beatmapManager.Save(editorBeatmap.BeatmapInfo, editorBeatmap.PlayableBeatmap, editorBeatmap.BeatmapSkin);
-
             updateLastSavedHash();
         }
 
diff --git a/osu.Game/Screens/Edit/EditorLoader.cs b/osu.Game/Screens/Edit/EditorLoader.cs
index 731bc75b52..de47411fdc 100644
--- a/osu.Game/Screens/Edit/EditorLoader.cs
+++ b/osu.Game/Screens/Edit/EditorLoader.cs
@@ -6,6 +6,7 @@ using JetBrains.Annotations;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
+using osu.Framework.Logging;
 using osu.Framework.Screens;
 using osu.Framework.Threading;
 using osu.Game.Beatmaps;
@@ -80,7 +81,20 @@ namespace osu.Game.Screens.Edit
         }
 
         public void ScheduleSwitchToNewDifficulty(BeatmapSetInfo beatmapSetInfo, RulesetInfo rulesetInfo, EditorState editorState)
-            => scheduleDifficultySwitch(() => beatmapManager.CreateNewBlankDifficulty(beatmapSetInfo, rulesetInfo), editorState);
+            => scheduleDifficultySwitch(() =>
+            {
+                try
+                {
+                    return beatmapManager.CreateNewBlankDifficulty(beatmapSetInfo, rulesetInfo);
+                }
+                catch (Exception ex)
+                {
+                    // if the beatmap creation fails (e.g. due to duplicated difficulty names),
+                    // bring the user back to the previous beatmap as a best-effort.
+                    Logger.Error(ex, ex.Message);
+                    return Beatmap.Value;
+                }
+            }, editorState);
 
         public void ScheduleSwitchToExistingDifficulty(BeatmapInfo beatmapInfo, EditorState editorState)
             => scheduleDifficultySwitch(() => beatmapManager.GetWorkingBeatmap(beatmapInfo), editorState);

From afc48d86df1be79ca37d02cb3fdee604d7f7ecaf Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 23 Jan 2022 19:50:02 +0100
Subject: [PATCH 2764/5547] Add failing test coverage for save after safeties
 addition

---
 .../Editing/TestSceneEditorBeatmapCreation.cs       |  1 +
 osu.Game/Screens/Edit/Editor.cs                     | 13 +++++++++----
 osu.Game/Tests/Visual/EditorTestScene.cs            |  2 +-
 3 files changed, 11 insertions(+), 5 deletions(-)

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneEditorBeatmapCreation.cs b/osu.Game.Tests/Visual/Editing/TestSceneEditorBeatmapCreation.cs
index 31348c1e17..a14c9aded3 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneEditorBeatmapCreation.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneEditorBeatmapCreation.cs
@@ -109,6 +109,7 @@ namespace osu.Game.Tests.Visual.Editing
                        && set != null
                        && set.PerformRead(s => s.Beatmaps.Single().ID == beatmap.ID);
             });
+            AddAssert("can save again", () => Editor.Save());
 
             AddStep("create new difficulty", () => Editor.CreateNewDifficulty(new OsuRuleset().RulesetInfo));
             AddUntilStep("wait for created", () =>
diff --git a/osu.Game/Screens/Edit/Editor.cs b/osu.Game/Screens/Edit/Editor.cs
index 64b23ccda8..78c5c862f7 100644
--- a/osu.Game/Screens/Edit/Editor.cs
+++ b/osu.Game/Screens/Edit/Editor.cs
@@ -378,12 +378,16 @@ namespace osu.Game.Screens.Edit
             Clipboard.Content.Value = state.ClipboardContent;
         });
 
-        protected void Save()
+        /// <summary>
+        /// Saves the currently edited beatmap.
+        /// </summary>
+        /// <returns>Whether the save was successful.</returns>
+        protected bool Save()
         {
             if (!canSave)
             {
                 notifications?.Post(new SimpleErrorNotification { Text = "Saving is not supported for this ruleset yet, sorry!" });
-                return;
+                return false;
             }
 
             try
@@ -395,12 +399,13 @@ namespace osu.Game.Screens.Edit
             {
                 // can fail e.g. due to duplicated difficulty names.
                 Logger.Error(ex, ex.Message);
-                return;
+                return false;
             }
 
             // no longer new after first user-triggered save.
             isNewBeatmap = false;
             updateLastSavedHash();
+            return true;
         }
 
         protected override void Update()
@@ -809,7 +814,7 @@ namespace osu.Game.Screens.Edit
         {
             var fileMenuItems = new List<MenuItem>
             {
-                new EditorMenuItem("Save", MenuItemType.Standard, Save)
+                new EditorMenuItem("Save", MenuItemType.Standard, () => Save())
             };
 
             if (RuntimeInfo.IsDesktop)
diff --git a/osu.Game/Tests/Visual/EditorTestScene.cs b/osu.Game/Tests/Visual/EditorTestScene.cs
index 52d61ed422..da13c6862f 100644
--- a/osu.Game/Tests/Visual/EditorTestScene.cs
+++ b/osu.Game/Tests/Visual/EditorTestScene.cs
@@ -97,7 +97,7 @@ namespace osu.Game.Tests.Visual
 
             public new void Redo() => base.Redo();
 
-            public new void Save() => base.Save();
+            public new bool Save() => base.Save();
 
             public new void Cut() => base.Cut();
 

From 47429fb0c68b6df09b73056a8a7a5b8d3fe2e4ff Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 23 Jan 2022 19:54:57 +0100
Subject: [PATCH 2765/5547] Fix same-name safety firing wrongly

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

diff --git a/osu.Game/Beatmaps/BeatmapModelManager.cs b/osu.Game/Beatmaps/BeatmapModelManager.cs
index 327e10e643..d4df4b7870 100644
--- a/osu.Game/Beatmaps/BeatmapModelManager.cs
+++ b/osu.Game/Beatmaps/BeatmapModelManager.cs
@@ -74,7 +74,7 @@ namespace osu.Game.Beatmaps
                 string targetFilename = getFilename(beatmapInfo);
 
                 // ensure that two difficulties from the set don't point at the same beatmap file.
-                if (setInfo.Beatmaps.Any(b => string.Equals(b.Path, targetFilename, StringComparison.OrdinalIgnoreCase)))
+                if (setInfo.Beatmaps.Any(b => b.ID != beatmapInfo.ID && string.Equals(b.Path, targetFilename, StringComparison.OrdinalIgnoreCase)))
                     throw new InvalidOperationException($"{setInfo.GetDisplayString()} already has a difficulty with the name of '{beatmapInfo.DifficultyName}'.");
 
                 if (existingFileInfo != null)

From a8ffc4fc2a08b27af6e295ee97cfee3d208d4bc1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 23 Jan 2022 19:58:21 +0100
Subject: [PATCH 2766/5547] Add editor override to respect
 `IsolateSavingFromDatabase`

---
 osu.Game/Beatmaps/BeatmapManager.cs      | 2 +-
 osu.Game/Tests/Visual/EditorTestScene.cs | 6 ++++++
 2 files changed, 7 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index d9b0ec3170..9c9b995955 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -112,7 +112,7 @@ namespace osu.Game.Beatmaps
         /// The new difficulty will be backed by a <see cref="BeatmapInfo"/> model
         /// and represented by the returned <see cref="WorkingBeatmap"/>.
         /// </summary>
-        public WorkingBeatmap CreateNewBlankDifficulty(BeatmapSetInfo beatmapSetInfo, RulesetInfo rulesetInfo)
+        public virtual WorkingBeatmap CreateNewBlankDifficulty(BeatmapSetInfo beatmapSetInfo, RulesetInfo rulesetInfo)
         {
             // fetch one of the existing difficulties to copy timing points and metadata from,
             // so that the user doesn't have to fill all of that out again.
diff --git a/osu.Game/Tests/Visual/EditorTestScene.cs b/osu.Game/Tests/Visual/EditorTestScene.cs
index da13c6862f..331bf04644 100644
--- a/osu.Game/Tests/Visual/EditorTestScene.cs
+++ b/osu.Game/Tests/Visual/EditorTestScene.cs
@@ -136,6 +136,12 @@ namespace osu.Game.Tests.Visual
                 return new TestWorkingBeatmapCache(this, audioManager, resources, storage, defaultBeatmap, host);
             }
 
+            public override WorkingBeatmap CreateNewBlankDifficulty(BeatmapSetInfo beatmapSetInfo, RulesetInfo rulesetInfo)
+            {
+                // don't actually care about properly creating a difficulty for this context.
+                return TestBeatmap;
+            }
+
             private class TestWorkingBeatmapCache : WorkingBeatmapCache
             {
                 private readonly TestBeatmapManager testBeatmapManager;

From 62537eb4aa5f458fd959846a8bf318b16e2acef0 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 3 Feb 2022 12:44:33 +0900
Subject: [PATCH 2767/5547] Fix spectator not completing

---
 osu.Game/Screens/Spectate/SpectatorScreen.cs | 21 +++++++++++---------
 1 file changed, 12 insertions(+), 9 deletions(-)

diff --git a/osu.Game/Screens/Spectate/SpectatorScreen.cs b/osu.Game/Screens/Spectate/SpectatorScreen.cs
index 0b2a7cecf6..460352ee07 100644
--- a/osu.Game/Screens/Spectate/SpectatorScreen.cs
+++ b/osu.Game/Screens/Spectate/SpectatorScreen.cs
@@ -112,6 +112,7 @@ namespace osu.Game.Screens.Spectate
             switch (e.Action)
             {
                 case NotifyDictionaryChangedAction.Add:
+                case NotifyDictionaryChangedAction.Replace:
                     foreach ((int userId, var state) in e.NewItems.AsNonNull())
                         onUserStateChanged(userId, state);
                     break;
@@ -120,11 +121,6 @@ namespace osu.Game.Screens.Spectate
                     foreach ((int userId, _) in e.OldItems.AsNonNull())
                         onUserStateRemoved(userId);
                     break;
-
-                case NotifyDictionaryChangedAction.Replace:
-                    foreach ((int userId, var state) in e.NewItems.AsNonNull())
-                        onUserStateChanged(userId, state);
-                    break;
             }
         }
 
@@ -136,11 +132,18 @@ namespace osu.Game.Screens.Spectate
             if (!userMap.ContainsKey(userId))
                 return;
 
-            // Do nothing for failed/completed states.
-            if (newState.State == SpectatingUserState.Playing)
+            switch (newState.State)
             {
-                Schedule(() => OnUserStateChanged(userId, newState));
-                updateGameplayState(userId);
+                case SpectatingUserState.Completed:
+                    // Make sure that gameplay completes to the end.
+                    if (gameplayStates.TryGetValue(userId, out var gameplayState))
+                        gameplayState.Score.Replay.HasReceivedAllFrames = true;
+                    break;
+
+                case SpectatingUserState.Playing:
+                    Schedule(() => OnUserStateChanged(userId, newState));
+                    updateGameplayState(userId);
+                    break;
             }
         }
 

From aff36d4e163c96c9dd35ea280a1b630806b63d10 Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Thu, 3 Feb 2022 11:52:37 +0800
Subject: [PATCH 2768/5547] Refactor `populateStatistics` to avoid disposing

---
 .../Ranking/Statistics/StatisticsPanel.cs     | 128 +++++++++---------
 1 file changed, 63 insertions(+), 65 deletions(-)

diff --git a/osu.Game/Screens/Ranking/Statistics/StatisticsPanel.cs b/osu.Game/Screens/Ranking/Statistics/StatisticsPanel.cs
index 08be1de652..cbb4e5089d 100644
--- a/osu.Game/Screens/Ranking/Statistics/StatisticsPanel.cs
+++ b/osu.Game/Screens/Ranking/Statistics/StatisticsPanel.cs
@@ -86,88 +86,86 @@ namespace osu.Game.Screens.Ranking.Statistics
                 playableBeatmap = beatmapManager.GetWorkingBeatmap(newScore.BeatmapInfo).GetPlayableBeatmap(newScore.Ruleset, newScore.Mods);
             }, loadCancellation.Token).ContinueWith(t => Schedule(() =>
             {
-                FillFlowContainer rows;
-                Container<Drawable> container = new OsuScrollContainer(Direction.Vertical)
-                {
-                    RelativeSizeAxes = Axes.Both,
-                    Anchor = Anchor.Centre,
-                    Origin = Anchor.Centre,
-                    Alpha = 0,
-                    Children = new[]
-                    {
-                        rows = new FillFlowContainer
-                        {
-                            RelativeSizeAxes = Axes.X,
-                            AutoSizeAxes = Axes.Y,
-                            Spacing = new Vector2(30, 15)
-                        }
-                    }
-                };
-
-                bool panelIsEmpty = true;
-                bool panelIsComplete = true;
                 bool hitEventsAvailable = newScore.HitEvents.Count != 0;
+                Container<Drawable> container;
 
-                foreach (var row in newScore.Ruleset.CreateInstance().CreateStatisticsForScore(newScore, playableBeatmap))
+                var statisticRows = newScore.Ruleset.CreateInstance().CreateStatisticsForScore(newScore, playableBeatmap);
+
+                if (!hitEventsAvailable && statisticRows.SelectMany(r => r.Columns).All(c => c.RequiresHitEvents))
                 {
-                    var columnsToDisplay = hitEventsAvailable
-                        ? row.Columns
-                        : row.Columns.Where(c => !c.RequiresHitEvents).ToArray();
-
-                    if (columnsToDisplay.Length < row.Columns.Length)
-                        panelIsComplete = false;
-
-                    if (columnsToDisplay.Any())
-                        panelIsEmpty = false;
-                    else
-                        continue;
-
-                    rows.Add(new GridContainer
+                    container = new FillFlowContainer
                     {
-                        Anchor = Anchor.TopCentre,
-                        Origin = Anchor.TopCentre,
-                        RelativeSizeAxes = Axes.X,
-                        AutoSizeAxes = Axes.Y,
-                        Content = new[]
+                        RelativeSizeAxes = Axes.Both,
+                        Anchor = Anchor.Centre,
+                        Origin = Anchor.Centre,
+                        Direction = FillDirection.Vertical,
+                        Children = new Drawable[]
                         {
-                            columnsToDisplay?.Select(c => new StatisticContainer(c)
+                            new MessagePlaceholder("Extended statistics are only available after watching a replay!"),
+                            new ReplayDownloadButton(newScore)
                             {
+                                Scale = new Vector2(1.5f),
                                 Anchor = Anchor.Centre,
                                 Origin = Anchor.Centre,
-                            }).Cast<Drawable>().ToArray()
-                        },
-                        ColumnDimensions = Enumerable.Range(0, columnsToDisplay.Length)
-                                                     .Select(i => columnsToDisplay[i].Dimension ?? new Dimension()).ToArray(),
-                        RowDimensions = new[] { new Dimension(GridSizeMode.AutoSize) }
-                    });
+                            },
+                        }
+                    };
                 }
-
-                if (!hitEventsAvailable)
+                else
                 {
-                    if (panelIsEmpty)
+                    FillFlowContainer rows;
+                    container = new OsuScrollContainer(Direction.Vertical)
                     {
-                        // Replace the scroll container with fill flow container to get the message centered.
-                        rows.Dispose();
-                        container.Dispose();
-                        container = new FillFlowContainer
+                        RelativeSizeAxes = Axes.Both,
+                        Anchor = Anchor.Centre,
+                        Origin = Anchor.Centre,
+                        Alpha = 0,
+                        Children = new[]
                         {
-                            RelativeSizeAxes = Axes.Both,
-                            Anchor = Anchor.Centre,
-                            Origin = Anchor.Centre,
-                            Direction = FillDirection.Vertical,
-                            Children = new Drawable[]
+                            rows = new FillFlowContainer
                             {
-                                new MessagePlaceholder("Extended statistics are only available after watching a replay!"),
-                                new ReplayDownloadButton(newScore)
+                                RelativeSizeAxes = Axes.X,
+                                AutoSizeAxes = Axes.Y,
+                                Spacing = new Vector2(30, 15)
+                            }
+                        }
+                    };
+
+                    bool panelIsComplete = true;
+
+                    foreach (var row in statisticRows)
+                    {
+                        var columnsToDisplay = hitEventsAvailable
+                            ? row.Columns
+                            : row.Columns.Where(c => !c.RequiresHitEvents).ToArray();
+
+                        if (columnsToDisplay.Length < row.Columns.Length)
+                            panelIsComplete = false;
+
+                        if (columnsToDisplay.Length == 0)
+                            continue;
+
+                        rows.Add(new GridContainer
+                        {
+                            Anchor = Anchor.TopCentre,
+                            Origin = Anchor.TopCentre,
+                            RelativeSizeAxes = Axes.X,
+                            AutoSizeAxes = Axes.Y,
+                            Content = new[]
+                            {
+                                columnsToDisplay?.Select(c => new StatisticContainer(c)
                                 {
-                                    Scale = new Vector2(1.5f),
                                     Anchor = Anchor.Centre,
                                     Origin = Anchor.Centre,
-                                },
-                            }
-                        };
+                                }).Cast<Drawable>().ToArray()
+                            },
+                            ColumnDimensions = Enumerable.Range(0, columnsToDisplay.Length)
+                                                         .Select(i => columnsToDisplay[i].Dimension ?? new Dimension()).ToArray(),
+                            RowDimensions = new[] { new Dimension(GridSizeMode.AutoSize) }
+                        });
                     }
-                    else if (!panelIsComplete)
+
+                    if (!hitEventsAvailable && !panelIsComplete)
                     {
                         rows.Add(new FillFlowContainer
                         {

From d9a43b4c4ce50d58ff4d12393c9b4f4c66bc602d Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 3 Feb 2022 13:16:54 +0900
Subject: [PATCH 2769/5547] Fix API requests not completing when offline

---
 osu.Game/Online/API/APIAccess.cs | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/osu.Game/Online/API/APIAccess.cs b/osu.Game/Online/API/APIAccess.cs
index 8d91548149..1d2abe0c7f 100644
--- a/osu.Game/Online/API/APIAccess.cs
+++ b/osu.Game/Online/API/APIAccess.cs
@@ -399,7 +399,10 @@ namespace osu.Game.Online.API
             lock (queue)
             {
                 if (state.Value == APIState.Offline)
+                {
+                    request.Fail(new WebException("Disconnected from server"));
                     return;
+                }
 
                 queue.Enqueue(request);
             }

From 62fa915193ba65a386d647ba63b0e5d422d18c64 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 3 Feb 2022 13:58:55 +0900
Subject: [PATCH 2770/5547] Standardise exception messages for
 local-user-logged-out flows

---
 osu.Game/Online/API/APIAccess.cs | 11 +++++++++--
 1 file changed, 9 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Online/API/APIAccess.cs b/osu.Game/Online/API/APIAccess.cs
index 1d2abe0c7f..a1b8e5bee7 100644
--- a/osu.Game/Online/API/APIAccess.cs
+++ b/osu.Game/Online/API/APIAccess.cs
@@ -400,7 +400,7 @@ namespace osu.Game.Online.API
             {
                 if (state.Value == APIState.Offline)
                 {
-                    request.Fail(new WebException("Disconnected from server"));
+                    failFromAPIOffline(request);
                     return;
                 }
 
@@ -419,7 +419,7 @@ namespace osu.Game.Online.API
                 if (failOldRequests)
                 {
                     foreach (var req in oldQueueRequests)
-                        req.Fail(new WebException(@"Disconnected from server"));
+                        failFromAPIOffline(req);
                 }
             }
         }
@@ -440,6 +440,13 @@ namespace osu.Game.Online.API
             flushQueue();
         }
 
+        private void failFromAPIOffline(APIRequest req)
+        {
+            Debug.Assert(state.Value == APIState.Offline);
+
+            req.Fail(new WebException(@"User not logged in"));
+        }
+
         private static APIUser createGuestUser() => new GuestUser();
 
         protected override void Dispose(bool isDisposing)

From a69c7a9de6f80b3b95b628abc1b5711c6338743e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 3 Feb 2022 14:09:27 +0900
Subject: [PATCH 2771/5547] Split exceptions back out to give better messaging

---
 osu.Game/Online/API/APIAccess.cs | 11 ++---------
 1 file changed, 2 insertions(+), 9 deletions(-)

diff --git a/osu.Game/Online/API/APIAccess.cs b/osu.Game/Online/API/APIAccess.cs
index a1b8e5bee7..c5302a393c 100644
--- a/osu.Game/Online/API/APIAccess.cs
+++ b/osu.Game/Online/API/APIAccess.cs
@@ -400,7 +400,7 @@ namespace osu.Game.Online.API
             {
                 if (state.Value == APIState.Offline)
                 {
-                    failFromAPIOffline(request);
+                    request.Fail(new WebException(@"User not logged in"));
                     return;
                 }
 
@@ -419,7 +419,7 @@ namespace osu.Game.Online.API
                 if (failOldRequests)
                 {
                     foreach (var req in oldQueueRequests)
-                        failFromAPIOffline(req);
+                        req.Fail(new WebException($@"Request failed from flush operation (state {state.Value})"));
                 }
             }
         }
@@ -440,13 +440,6 @@ namespace osu.Game.Online.API
             flushQueue();
         }
 
-        private void failFromAPIOffline(APIRequest req)
-        {
-            Debug.Assert(state.Value == APIState.Offline);
-
-            req.Fail(new WebException(@"User not logged in"));
-        }
-
         private static APIUser createGuestUser() => new GuestUser();
 
         protected override void Dispose(bool isDisposing)

From c8ce00b26a5c9ca1049274cd7eee7e0c2f54e075 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 3 Feb 2022 14:50:40 +0900
Subject: [PATCH 2772/5547] Trigger a re-layout of HUD components when scoring
 mode is changed

This is a simple way of fixing the layout of scoring elements
overlapping due to different score display width requirements of
different scoring modes. It will only resolve the case where a user
hasn't customsied the layout of the default skins, but as this is a very
simple / low effort implementation for the most common scenario, I think
it makes sense.

Closes https://github.com/ppy/osu/issues/16067.
---
 osu.Game/Screens/Play/HUDOverlay.cs | 30 +++++++++++++++++++++++++----
 1 file changed, 26 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Screens/Play/HUDOverlay.cs b/osu.Game/Screens/Play/HUDOverlay.cs
index fdb5d418f3..628452fbc8 100644
--- a/osu.Game/Screens/Play/HUDOverlay.cs
+++ b/osu.Game/Screens/Play/HUDOverlay.cs
@@ -17,6 +17,7 @@ using osu.Game.Input.Bindings;
 using osu.Game.Overlays;
 using osu.Game.Overlays.Notifications;
 using osu.Game.Rulesets.Mods;
+using osu.Game.Rulesets.Scoring;
 using osu.Game.Rulesets.UI;
 using osu.Game.Screens.Play.HUD;
 using osu.Game.Skinning;
@@ -83,10 +84,7 @@ namespace osu.Game.Screens.Play
             Children = new Drawable[]
             {
                 CreateFailingLayer(),
-                mainComponents = new SkinnableTargetContainer(SkinnableTarget.MainHUDComponents)
-                {
-                    RelativeSizeAxes = Axes.Both,
-                },
+                mainComponents = new MainComponentsContainer(),
                 topRightElements = new FillFlowContainer
                 {
                     Anchor = Anchor.TopRight,
@@ -325,5 +323,29 @@ namespace osu.Game.Screens.Play
                     break;
             }
         }
+
+        private class MainComponentsContainer : SkinnableTargetContainer
+        {
+            private Bindable<ScoringMode> scoringMode;
+
+            [Resolved]
+            private OsuConfigManager config { get; set; }
+
+            public MainComponentsContainer()
+                : base(SkinnableTarget.MainHUDComponents)
+            {
+                RelativeSizeAxes = Axes.Both;
+            }
+
+            protected override void LoadComplete()
+            {
+                base.LoadComplete();
+
+                // When the scoring mode changes, relative positions of elements may change (see DefaultSkin.GetDrawableComponent).
+                // This is a best effort implementation for cases where users haven't customised layouts.
+                scoringMode = config.GetBindable<ScoringMode>(OsuSetting.ScoreDisplayMode);
+                scoringMode.BindValueChanged(val => Reload());
+            }
+        }
     }
 }

From 6355ac66634834124adfb30be16a3a3d138ada9c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 3 Feb 2022 15:10:06 +0900
Subject: [PATCH 2773/5547] Wait for `DialogOverlay` load in more tests

Apparently the previous fix was not enough as this can still be seen
failing
(https://github.com/ppy/osu/runs/5046718623?check_suite_focus=true).

This change is copying from what other tests use seemingly reliably,
such as `TestScenePerformFromScreen`)
---
 osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs b/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
index ed484e03f6..e31377b96e 100644
--- a/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
@@ -128,6 +128,7 @@ namespace osu.Game.Tests.Visual.Navigation
 
             AddStep("choose clear all scores", () => InputManager.Key(Key.Number4));
 
+            AddUntilStep("wait for dialog display", () => Game.Dependencies.Get<DialogOverlay>().IsLoaded);
             AddUntilStep("wait for dialog", () => Game.Dependencies.Get<DialogOverlay>().CurrentDialog != null);
             AddStep("confirm deletion", () => InputManager.Key(Key.Number1));
             AddUntilStep("wait for dialog dismissed", () => Game.Dependencies.Get<DialogOverlay>().CurrentDialog == null);
@@ -172,6 +173,7 @@ namespace osu.Game.Tests.Visual.Navigation
                 InputManager.Click(MouseButton.Left);
             });
 
+            AddUntilStep("wait for dialog display", () => Game.Dependencies.Get<DialogOverlay>().IsLoaded);
             AddUntilStep("wait for dialog", () => Game.Dependencies.Get<DialogOverlay>().CurrentDialog != null);
             AddStep("confirm deletion", () => InputManager.Key(Key.Number1));
             AddUntilStep("wait for dialog dismissed", () => Game.Dependencies.Get<DialogOverlay>().CurrentDialog == null);

From 41aa4b8cca63be85c7a8434618c0dc3189f04f87 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 3 Feb 2022 16:04:05 +0900
Subject: [PATCH 2774/5547] Fix `TestSelectingFilteredRuleset` failing under
 visual tests due to using local database

---
 .../SongSelect/TestSceneBeatmapCarousel.cs    | 32 ++++++++++---------
 1 file changed, 17 insertions(+), 15 deletions(-)

diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs
index a23bc620ec..4e46901e08 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs
@@ -601,7 +601,7 @@ namespace osu.Game.Tests.Visual.SongSelect
         {
             BeatmapSetInfo testMixed = null;
 
-            createCarousel();
+            createCarousel(new List<BeatmapSetInfo>());
 
             AddStep("add mixed ruleset beatmapset", () =>
             {
@@ -765,22 +765,22 @@ namespace osu.Game.Tests.Visual.SongSelect
         {
             bool changed = false;
 
-            createCarousel(c =>
+            if (beatmapSets == null)
+            {
+                beatmapSets = new List<BeatmapSetInfo>();
+
+                for (int i = 1; i <= (count ?? set_count); i++)
+                {
+                    beatmapSets.Add(randomDifficulties
+                        ? TestResources.CreateTestBeatmapSetInfo()
+                        : TestResources.CreateTestBeatmapSetInfo(3));
+                }
+            }
+
+            createCarousel(beatmapSets, c =>
             {
                 carouselAdjust?.Invoke(c);
 
-                if (beatmapSets == null)
-                {
-                    beatmapSets = new List<BeatmapSetInfo>();
-
-                    for (int i = 1; i <= (count ?? set_count); i++)
-                    {
-                        beatmapSets.Add(randomDifficulties
-                            ? TestResources.CreateTestBeatmapSetInfo()
-                            : TestResources.CreateTestBeatmapSetInfo(3));
-                    }
-                }
-
                 carousel.Filter(initialCriteria?.Invoke() ?? new FilterCriteria());
                 carousel.BeatmapSetsChanged = () => changed = true;
                 carousel.BeatmapSets = beatmapSets;
@@ -789,7 +789,7 @@ namespace osu.Game.Tests.Visual.SongSelect
             AddUntilStep("Wait for load", () => changed);
         }
 
-        private void createCarousel(Action<BeatmapCarousel> carouselAdjust = null, Container target = null)
+        private void createCarousel(List<BeatmapSetInfo> beatmapSets, Action<BeatmapCarousel> carouselAdjust = null, Container target = null)
         {
             AddStep("Create carousel", () =>
             {
@@ -803,6 +803,8 @@ namespace osu.Game.Tests.Visual.SongSelect
 
                 carouselAdjust?.Invoke(carousel);
 
+                carousel.BeatmapSets = beatmapSets;
+
                 (target ?? this).Child = carousel;
             });
         }

From e65996efc31b5c17d7386baa1548d204889849ed Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 3 Feb 2022 17:14:38 +0900
Subject: [PATCH 2775/5547] Rename variable to match purpose better

---
 osu.Game/Screens/Select/SongSelect.cs | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Screens/Select/SongSelect.cs b/osu.Game/Screens/Select/SongSelect.cs
index 44af63a554..ee807762bf 100644
--- a/osu.Game/Screens/Select/SongSelect.cs
+++ b/osu.Game/Screens/Select/SongSelect.cs
@@ -110,7 +110,7 @@ namespace osu.Game.Screens.Select
 
         private double audioFeedbackLastPlaybackTime;
 
-        private bool randomClicked;
+        private bool randomSelectionPending;
 
         [Resolved]
         private MusicController music { get; set; }
@@ -321,12 +321,12 @@ namespace osu.Game.Screens.Select
             {
                 NextRandom = () =>
                 {
-                    randomClicked = true;
+                    randomSelectionPending = true;
                     Carousel.SelectNextRandom();
                 },
                 PreviousRandom = () =>
                 {
-                    randomClicked = true;
+                    randomSelectionPending = true;
                     Carousel.SelectPreviousRandom();
                 }
             }, null),
@@ -498,7 +498,7 @@ namespace osu.Game.Screens.Select
             {
                 if (beatmap != null && beatmapInfoPrevious != null && Time.Current - audioFeedbackLastPlaybackTime >= 50)
                 {
-                    if (randomClicked)
+                    if (randomSelectionPending)
                         sampleRandomBeatmap.Play();
                     else if (beatmap.BeatmapSet?.ID == beatmapInfoPrevious.BeatmapSet?.ID)
                         sampleChangeDifficulty.Play();
@@ -508,7 +508,7 @@ namespace osu.Game.Screens.Select
                     audioFeedbackLastPlaybackTime = Time.Current;
                 }
 
-                randomClicked = false;
+                randomSelectionPending = false;
                 beatmapInfoPrevious = beatmap;
             }
 

From a27d0572ed3d5c8b4c5f082015de2f6c33b86005 Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Thu, 3 Feb 2022 17:00:40 +0800
Subject: [PATCH 2776/5547] Add test cases for manual testing

---
 .../Ranking/TestSceneStatisticsPanel.cs       | 155 ++++++++++++++++++
 1 file changed, 155 insertions(+)

diff --git a/osu.Game.Tests/Visual/Ranking/TestSceneStatisticsPanel.cs b/osu.Game.Tests/Visual/Ranking/TestSceneStatisticsPanel.cs
index f64b7b2b65..35281a85eb 100644
--- a/osu.Game.Tests/Visual/Ranking/TestSceneStatisticsPanel.cs
+++ b/osu.Game.Tests/Visual/Ranking/TestSceneStatisticsPanel.cs
@@ -6,10 +6,18 @@ using System.Collections.Generic;
 using NUnit.Framework;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.Shapes;
+using osu.Game.Beatmaps;
+using osu.Game.Graphics;
+using osu.Game.Graphics.Sprites;
+using osu.Game.Rulesets;
+using osu.Game.Rulesets.Difficulty;
+using osu.Game.Rulesets.Mods;
 using osu.Game.Scoring;
 using osu.Game.Screens.Ranking.Statistics;
 using osu.Game.Rulesets.Osu.Objects;
 using osu.Game.Rulesets.Scoring;
+using osu.Game.Rulesets.UI;
 using osu.Game.Tests.Resources;
 using osuTK;
 
@@ -41,6 +49,24 @@ namespace osu.Game.Tests.Visual.Ranking
             loadPanel(TestResources.CreateTestScoreInfo());
         }
 
+        [Test]
+        public void TestScoreInRulesetWhereAllStatsRequireHitEvents()
+        {
+            loadPanel(TestResources.CreateTestScoreInfo(new TestRulesetAllStatsRequireHitEvents().RulesetInfo));
+        }
+
+        [Test]
+        public void TestScoreInRulesetWhereNoStatsRequireHitEvents()
+        {
+            loadPanel(TestResources.CreateTestScoreInfo(new TestRulesetNoStatsRequireHitEvents().RulesetInfo));
+        }
+
+        [Test]
+        public void TestScoreInMixedRuleset()
+        {
+            loadPanel(TestResources.CreateTestScoreInfo(new TestRulesetMixed().RulesetInfo));
+        }
+
         [Test]
         public void TestNullScore()
         {
@@ -75,5 +101,134 @@ namespace osu.Game.Tests.Visual.Ranking
 
             return hitEvents;
         }
+
+        private class TestRuleset : Ruleset
+        {
+            public override IEnumerable<Mod> GetModsFor(ModType type)
+            {
+                throw new NotImplementedException();
+            }
+
+            public override DrawableRuleset CreateDrawableRulesetWith(IBeatmap beatmap, IReadOnlyList<Mod> mods = null)
+            {
+                throw new NotImplementedException();
+            }
+
+            public override IBeatmapConverter CreateBeatmapConverter(IBeatmap beatmap)
+            {
+                throw new NotImplementedException();
+            }
+
+            public override DifficultyCalculator CreateDifficultyCalculator(IWorkingBeatmap beatmap)
+            {
+                throw new NotImplementedException();
+            }
+
+            public override string Description => string.Empty;
+
+            public override string ShortName => string.Empty;
+
+            protected static Drawable CreatePlaceholderStatistic(string message) => new Container
+            {
+                RelativeSizeAxes = Axes.X,
+                Masking = true,
+                CornerRadius = 20,
+                Height = 250,
+                Children = new Drawable[]
+                {
+                    new Box
+                    {
+                        RelativeSizeAxes = Axes.Both,
+                        Colour = OsuColour.Gray(0.5f),
+                        Alpha = 0.5f
+                    },
+                    new OsuSpriteText
+                    {
+                        Origin = Anchor.CentreLeft,
+                        Anchor = Anchor.CentreLeft,
+                        Text = message,
+                        Margin = new MarginPadding { Left = 20 }
+                    }
+                }
+            };
+        }
+
+        private class TestRulesetAllStatsRequireHitEvents : TestRuleset
+        {
+            public override StatisticRow[] CreateStatisticsForScore(ScoreInfo score, IBeatmap playableBeatmap)
+            {
+                return new[]
+                {
+                    new StatisticRow
+                    {
+                        Columns = new[]
+                        {
+                            new StatisticItem("Statistic Requiring Hit Events 1",
+                                () => CreatePlaceholderStatistic("Placeholder statistic. Requires hit events"), true)
+                        }
+                    },
+                    new StatisticRow
+                    {
+                        Columns = new[]
+                        {
+                            new StatisticItem("Statistic Requiring Hit Events 2",
+                                () => CreatePlaceholderStatistic("Placeholder statistic. Requires hit events"), true)
+                        }
+                    }
+                };
+            }
+        }
+
+        private class TestRulesetNoStatsRequireHitEvents : TestRuleset
+        {
+            public override StatisticRow[] CreateStatisticsForScore(ScoreInfo score, IBeatmap playableBeatmap)
+            {
+                return new[]
+                {
+                    new StatisticRow
+                    {
+                        Columns = new[]
+                        {
+                            new StatisticItem("Statistic Not Requiring Hit Events 1",
+                                () => CreatePlaceholderStatistic("Placeholder statistic. Does not require hit events"))
+                        }
+                    },
+                    new StatisticRow
+                    {
+                        Columns = new[]
+                        {
+                            new StatisticItem("Statistic Not Requiring Hit Events 2",
+                                () => CreatePlaceholderStatistic("Placeholder statistic. Does not require hit events"))
+                        }
+                    }
+                };
+            }
+        }
+
+        private class TestRulesetMixed : TestRuleset
+        {
+            public override StatisticRow[] CreateStatisticsForScore(ScoreInfo score, IBeatmap playableBeatmap)
+            {
+                return new[]
+                {
+                    new StatisticRow
+                    {
+                        Columns = new[]
+                        {
+                            new StatisticItem("Statistic Requiring Hit Events",
+                                () => CreatePlaceholderStatistic("Placeholder statistic. Requires hit events"), true)
+                        }
+                    },
+                    new StatisticRow
+                    {
+                        Columns = new[]
+                        {
+                            new StatisticItem("Statistic Not Requiring Hit Events",
+                                () => CreatePlaceholderStatistic("Placeholder statistic. Does not require hit events"))
+                        }
+                    }
+                };
+            }
+        }
     }
 }

From 6d6327d3da550900a717b166a8220f09ab1dde16 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 3 Feb 2022 18:40:10 +0900
Subject: [PATCH 2777/5547] Fix test beatmap loading potentially performing
 selection before carousel itself is loaded

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

diff --git a/osu.Game/Screens/Select/BeatmapCarousel.cs b/osu.Game/Screens/Select/BeatmapCarousel.cs
index 0f5c708ab8..f17daa8697 100644
--- a/osu.Game/Screens/Select/BeatmapCarousel.cs
+++ b/osu.Game/Screens/Select/BeatmapCarousel.cs
@@ -108,7 +108,7 @@ namespace osu.Game.Screens.Select
             set
             {
                 loadedTestBeatmaps = true;
-                loadBeatmapSets(value);
+                Schedule(() => loadBeatmapSets(value));
             }
         }
 

From 6974c2d255f400be9401479df9e782c79a2c04b8 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 3 Feb 2022 19:00:03 +0900
Subject: [PATCH 2778/5547] Remove weird `panelIsComplete` flag and replace
 LINQ with simple `foreach`

---
 .../Ranking/Statistics/StatisticsPanel.cs     | 46 +++++++++++--------
 1 file changed, 27 insertions(+), 19 deletions(-)

diff --git a/osu.Game/Screens/Ranking/Statistics/StatisticsPanel.cs b/osu.Game/Screens/Ranking/Statistics/StatisticsPanel.cs
index cbb4e5089d..898bd69b2c 100644
--- a/osu.Game/Screens/Ranking/Statistics/StatisticsPanel.cs
+++ b/osu.Game/Screens/Ranking/Statistics/StatisticsPanel.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 System.Threading;
 using System.Threading.Tasks;
@@ -131,41 +132,48 @@ namespace osu.Game.Screens.Ranking.Statistics
                         }
                     };
 
-                    bool panelIsComplete = true;
+                    bool anyRequiredHitEvents = false;
 
                     foreach (var row in statisticRows)
                     {
-                        var columnsToDisplay = hitEventsAvailable
-                            ? row.Columns
-                            : row.Columns.Where(c => !c.RequiresHitEvents).ToArray();
+                        var columns = row.Columns;
 
-                        if (columnsToDisplay.Length < row.Columns.Length)
-                            panelIsComplete = false;
-
-                        if (columnsToDisplay.Length == 0)
+                        if (columns.Length == 0)
                             continue;
 
+                        var columnContent = new List<Drawable>();
+                        var dimensions = new List<Dimension>();
+
+                        foreach (var col in columns)
+                        {
+                            if (!hitEventsAvailable && col.RequiresHitEvents)
+                            {
+                                anyRequiredHitEvents = true;
+                                continue;
+                            }
+
+                            columnContent.Add(new StatisticContainer(col)
+                            {
+                                Anchor = Anchor.Centre,
+                                Origin = Anchor.Centre,
+                            });
+
+                            dimensions.Add(col.Dimension ?? new Dimension());
+                        }
+
                         rows.Add(new GridContainer
                         {
                             Anchor = Anchor.TopCentre,
                             Origin = Anchor.TopCentre,
                             RelativeSizeAxes = Axes.X,
                             AutoSizeAxes = Axes.Y,
-                            Content = new[]
-                            {
-                                columnsToDisplay?.Select(c => new StatisticContainer(c)
-                                {
-                                    Anchor = Anchor.Centre,
-                                    Origin = Anchor.Centre,
-                                }).Cast<Drawable>().ToArray()
-                            },
-                            ColumnDimensions = Enumerable.Range(0, columnsToDisplay.Length)
-                                                         .Select(i => columnsToDisplay[i].Dimension ?? new Dimension()).ToArray(),
+                            Content = new[] { columnContent.ToArray() },
+                            ColumnDimensions = dimensions.ToArray(),
                             RowDimensions = new[] { new Dimension(GridSizeMode.AutoSize) }
                         });
                     }
 
-                    if (!hitEventsAvailable && !panelIsComplete)
+                    if (anyRequiredHitEvents)
                     {
                         rows.Add(new FillFlowContainer
                         {

From 47d577ec9c822edb762c91067fb7c17ea97a766a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 3 Feb 2022 19:17:56 +0900
Subject: [PATCH 2779/5547] Add back constructor for ruleset compatibility

---
 osu.Game/Screens/Ranking/Statistics/StatisticItem.cs | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/osu.Game/Screens/Ranking/Statistics/StatisticItem.cs b/osu.Game/Screens/Ranking/Statistics/StatisticItem.cs
index 3cfc38e263..b43fbbdeee 100644
--- a/osu.Game/Screens/Ranking/Statistics/StatisticItem.cs
+++ b/osu.Game/Screens/Ranking/Statistics/StatisticItem.cs
@@ -33,6 +33,12 @@ namespace osu.Game.Screens.Ranking.Statistics
         /// </summary>
         public readonly bool RequiresHitEvents;
 
+        [Obsolete("Use constructor which takes creation function instead.")] // Can be removed 20220803.
+        public StatisticItem([NotNull] string name, [NotNull] Drawable content, [CanBeNull] Dimension dimension = null)
+            : this(name, () => content, true, dimension)
+        {
+        }
+
         /// <summary>
         /// Creates a new <see cref="StatisticItem"/>, to be displayed inside a <see cref="StatisticRow"/> in the results screen.
         /// </summary>

From ad47649d1c5044c64c4a4f8d50ff739031019221 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 3 Feb 2022 19:38:53 +0900
Subject: [PATCH 2780/5547] Make `BeatmapModelManager.Save` non-virtual

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

diff --git a/osu.Game/Beatmaps/BeatmapModelManager.cs b/osu.Game/Beatmaps/BeatmapModelManager.cs
index d4df4b7870..a9da221e08 100644
--- a/osu.Game/Beatmaps/BeatmapModelManager.cs
+++ b/osu.Game/Beatmaps/BeatmapModelManager.cs
@@ -46,7 +46,7 @@ namespace osu.Game.Beatmaps
         /// <param name="beatmapInfo">The <see cref="BeatmapInfo"/> to save the content against. The file referenced by <see cref="BeatmapInfo.Path"/> will be replaced.</param>
         /// <param name="beatmapContent">The <see cref="IBeatmap"/> content to write.</param>
         /// <param name="beatmapSkin">The beatmap <see cref="ISkin"/> content to write, null if to be omitted.</param>
-        public virtual void Save(BeatmapInfo beatmapInfo, IBeatmap beatmapContent, ISkin? beatmapSkin = null)
+        public void Save(BeatmapInfo beatmapInfo, IBeatmap beatmapContent, ISkin? beatmapSkin = null)
         {
             var setInfo = beatmapInfo.BeatmapSet;
             Debug.Assert(setInfo != null);

From bef0a2da210c7505adef18314ec12312b3ee59d1 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 3 Feb 2022 19:39:24 +0900
Subject: [PATCH 2781/5547] Remove return type from `AddDifficultyToBeatmapSet`

Also removes a pointless realm encapsulation.
---
 osu.Game/Beatmaps/BeatmapManager.cs      |  6 +++---
 osu.Game/Beatmaps/BeatmapModelManager.cs | 15 +++++----------
 2 files changed, 8 insertions(+), 13 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index 9c9b995955..d60cfdee9e 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -128,10 +128,10 @@ namespace osu.Game.Beatmaps
             foreach (var timingPoint in referenceBeatmap.Beatmap.ControlPointInfo.TimingPoints)
                 newBeatmap.ControlPointInfo.Add(timingPoint.Time, timingPoint.DeepClone());
 
-            var createdBeatmapInfo = beatmapModelManager.AddDifficultyToBeatmapSet(beatmapSetInfo, newBeatmap);
+            beatmapModelManager.AddDifficultyToBeatmapSet(beatmapSetInfo, newBeatmap);
 
-            workingBeatmapCache.Invalidate(createdBeatmapInfo.BeatmapSet);
-            return GetWorkingBeatmap(createdBeatmapInfo);
+            workingBeatmapCache.Invalidate(beatmapSetInfo);
+            return GetWorkingBeatmap(newBeatmap.BeatmapInfo);
         }
 
         // TODO: add back support for making a copy of another difficulty
diff --git a/osu.Game/Beatmaps/BeatmapModelManager.cs b/osu.Game/Beatmaps/BeatmapModelManager.cs
index a9da221e08..b9f0af8833 100644
--- a/osu.Game/Beatmaps/BeatmapModelManager.cs
+++ b/osu.Game/Beatmaps/BeatmapModelManager.cs
@@ -93,19 +93,14 @@ namespace osu.Game.Beatmaps
         /// <summary>
         /// Add a new difficulty to the beatmap set represented by the provided <see cref="BeatmapSetInfo"/>.
         /// </summary>
-        public BeatmapInfo AddDifficultyToBeatmapSet(BeatmapSetInfo beatmapSetInfo, Beatmap beatmap)
+        public void AddDifficultyToBeatmapSet(BeatmapSetInfo beatmapSetInfo, Beatmap beatmap)
         {
-            return Realm.Run(realm =>
-            {
-                var beatmapInfo = beatmap.BeatmapInfo;
+            var beatmapInfo = beatmap.BeatmapInfo;
 
-                beatmapSetInfo.Beatmaps.Add(beatmapInfo);
-                beatmapInfo.BeatmapSet = beatmapSetInfo;
+            beatmapSetInfo.Beatmaps.Add(beatmapInfo);
+            beatmapInfo.BeatmapSet = beatmapSetInfo;
 
-                Save(beatmapInfo, beatmap);
-
-                return beatmapInfo.Detach();
-            });
+            Save(beatmapInfo, beatmap);
         }
 
         private static string getFilename(BeatmapInfo beatmapInfo)

From 40953751b542281dca26e24c323e48b73b2a6c60 Mon Sep 17 00:00:00 2001
From: Susko3 <16479013+Susko3@users.noreply.github.com>
Date: Thu, 3 Feb 2022 13:28:49 +0100
Subject: [PATCH 2782/5547] Use `ScreenOrientation.FullUser` on Android tablets

---
 osu.Android/GameplayScreenRotationLocker.cs |  2 +-
 osu.Android/OsuGameActivity.cs              | 25 ++++++++++++++++-----
 2 files changed, 21 insertions(+), 6 deletions(-)

diff --git a/osu.Android/GameplayScreenRotationLocker.cs b/osu.Android/GameplayScreenRotationLocker.cs
index ab91b4e3b3..1b7893e5b9 100644
--- a/osu.Android/GameplayScreenRotationLocker.cs
+++ b/osu.Android/GameplayScreenRotationLocker.cs
@@ -27,7 +27,7 @@ namespace osu.Android
         {
             gameActivity.RunOnUiThread(() =>
             {
-                gameActivity.RequestedOrientation = userPlaying.NewValue ? ScreenOrientation.Locked : OsuGameActivity.DEFAULT_ORIENTATION;
+                gameActivity.RequestedOrientation = userPlaying.NewValue ? ScreenOrientation.Locked : gameActivity.ScreenOrientation;
             });
         }
     }
diff --git a/osu.Android/OsuGameActivity.cs b/osu.Android/OsuGameActivity.cs
index e6679b61a6..7de597fe88 100644
--- a/osu.Android/OsuGameActivity.cs
+++ b/osu.Android/OsuGameActivity.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.IO;
 using System.Linq;
@@ -8,16 +9,18 @@ using System.Threading.Tasks;
 using Android.App;
 using Android.Content;
 using Android.Content.PM;
-using Android.Net;
+using Android.Graphics;
 using Android.OS;
 using Android.Provider;
 using Android.Views;
 using osu.Framework.Android;
 using osu.Game.Database;
+using Debug = System.Diagnostics.Debug;
+using Uri = Android.Net.Uri;
 
 namespace osu.Android
 {
-    [Activity(ConfigurationChanges = DEFAULT_CONFIG_CHANGES, Exported = true, LaunchMode = DEFAULT_LAUNCH_MODE, MainLauncher = true, ScreenOrientation = DEFAULT_ORIENTATION)]
+    [Activity(ConfigurationChanges = DEFAULT_CONFIG_CHANGES, Exported = true, LaunchMode = DEFAULT_LAUNCH_MODE, MainLauncher = true)]
     [IntentFilter(new[] { Intent.ActionView }, Categories = new[] { Intent.CategoryDefault }, DataScheme = "content", DataPathPattern = ".*\\\\.osz", DataHost = "*", DataMimeType = "*/*")]
     [IntentFilter(new[] { Intent.ActionView }, Categories = new[] { Intent.CategoryDefault }, DataScheme = "content", DataPathPattern = ".*\\\\.osk", DataHost = "*", DataMimeType = "*/*")]
     [IntentFilter(new[] { Intent.ActionView }, Categories = new[] { Intent.CategoryDefault }, DataScheme = "content", DataPathPattern = ".*\\\\.osr", DataHost = "*", DataMimeType = "*/*")]
@@ -39,10 +42,10 @@ namespace osu.Android
     [IntentFilter(new[] { Intent.ActionView }, Categories = new[] { Intent.CategoryBrowsable, Intent.CategoryDefault }, DataSchemes = new[] { "osu", "osump" })]
     public class OsuGameActivity : AndroidGameActivity
     {
-        public const ScreenOrientation DEFAULT_ORIENTATION = ScreenOrientation.SensorLandscape;
-
         private static readonly string[] osu_url_schemes = { "osu", "osump" };
 
+        public ScreenOrientation ScreenOrientation = ScreenOrientation.Unspecified;
+
         private OsuGameAndroid game;
 
         protected override Framework.Game CreateGame() => game = new OsuGameAndroid(this);
@@ -56,8 +59,20 @@ namespace osu.Android
             // reference: https://developer.android.com/reference/android/app/Activity#onNewIntent(android.content.Intent)
             handleIntent(Intent);
 
+            Debug.Assert(Window != null);
+
             Window.AddFlags(WindowManagerFlags.Fullscreen);
             Window.AddFlags(WindowManagerFlags.KeepScreenOn);
+
+            Debug.Assert(WindowManager?.DefaultDisplay != null);
+            Debug.Assert(Resources?.DisplayMetrics != null);
+
+            Point displaySize = new Point();
+            WindowManager.DefaultDisplay.GetSize(displaySize);
+            float smallestWidthDp = Math.Min(displaySize.X, displaySize.Y) / Resources.DisplayMetrics.Density;
+            bool isTablet = smallestWidthDp >= 600f;
+
+            RequestedOrientation = ScreenOrientation = isTablet ? ScreenOrientation.FullUser : ScreenOrientation.SensorLandscape;
         }
 
         protected override void OnNewIntent(Intent intent) => handleIntent(intent);
@@ -106,7 +121,7 @@ namespace osu.Android
 
                 cursor.MoveToFirst();
 
-                var filenameColumn = cursor.GetColumnIndex(OpenableColumns.DisplayName);
+                int filenameColumn = cursor.GetColumnIndex(OpenableColumns.DisplayName);
                 string filename = cursor.GetString(filenameColumn);
 
                 // SharpCompress requires archive streams to be seekable, which the stream opened by

From f2850601486ec6a8b4b4a88d76b13c75fddd0320 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 3 Feb 2022 21:50:15 +0900
Subject: [PATCH 2783/5547] Fix MultiSpectatorScreen not continuing to results

---
 .../Multiplayer/Spectate/MultiSpectatorScreen.cs |  5 ++++-
 osu.Game/Screens/Play/SoloSpectator.cs           |  2 +-
 osu.Game/Screens/Spectate/SpectatorScreen.cs     | 16 ++++++++++------
 3 files changed, 15 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorScreen.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorScreen.cs
index 4646f42d63..bbdd7a3d56 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorScreen.cs
@@ -215,8 +215,11 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Spectate
         protected override void StartGameplay(int userId, SpectatorGameplayState spectatorGameplayState)
             => instances.Single(i => i.UserId == userId).LoadScore(spectatorGameplayState.Score);
 
-        protected override void EndGameplay(int userId)
+        protected override void EndGameplay(int userId, SpectatorState state)
         {
+            if (state.State == SpectatingUserState.Completed || state.State == SpectatingUserState.Failed)
+                return;
+
             RemoveUser(userId);
 
             var instance = instances.Single(i => i.UserId == userId);
diff --git a/osu.Game/Screens/Play/SoloSpectator.cs b/osu.Game/Screens/Play/SoloSpectator.cs
index b530965269..a710db6d24 100644
--- a/osu.Game/Screens/Play/SoloSpectator.cs
+++ b/osu.Game/Screens/Play/SoloSpectator.cs
@@ -180,7 +180,7 @@ namespace osu.Game.Screens.Play
             scheduleStart(spectatorGameplayState);
         }
 
-        protected override void EndGameplay(int userId)
+        protected override void EndGameplay(int userId, SpectatorState state)
         {
             scheduledStart?.Cancel();
             immediateSpectatorGameplayState = null;
diff --git a/osu.Game/Screens/Spectate/SpectatorScreen.cs b/osu.Game/Screens/Spectate/SpectatorScreen.cs
index 460352ee07..7b58f669a0 100644
--- a/osu.Game/Screens/Spectate/SpectatorScreen.cs
+++ b/osu.Game/Screens/Spectate/SpectatorScreen.cs
@@ -118,8 +118,8 @@ namespace osu.Game.Screens.Spectate
                     break;
 
                 case NotifyDictionaryChangedAction.Remove:
-                    foreach ((int userId, _) in e.OldItems.AsNonNull())
-                        onUserStateRemoved(userId);
+                    foreach ((int userId, SpectatorState state) in e.OldItems.AsNonNull())
+                        onUserStateRemoved(userId, state);
                     break;
             }
         }
@@ -147,7 +147,7 @@ namespace osu.Game.Screens.Spectate
             }
         }
 
-        private void onUserStateRemoved(int userId)
+        private void onUserStateRemoved(int userId, SpectatorState state)
         {
             if (!userMap.ContainsKey(userId))
                 return;
@@ -158,7 +158,7 @@ namespace osu.Game.Screens.Spectate
             gameplayState.Score.Replay.HasReceivedAllFrames = true;
 
             gameplayStates.Remove(userId);
-            Schedule(() => EndGameplay(userId));
+            Schedule(() => EndGameplay(userId, state));
         }
 
         private void updateGameplayState(int userId)
@@ -212,7 +212,8 @@ namespace osu.Game.Screens.Spectate
         /// Ends gameplay for a user.
         /// </summary>
         /// <param name="userId">The user to end gameplay for.</param>
-        protected abstract void EndGameplay(int userId);
+        /// <param name="state">The final user state.</param>
+        protected abstract void EndGameplay(int userId, SpectatorState state);
 
         /// <summary>
         /// Stops spectating a user.
@@ -220,7 +221,10 @@ namespace osu.Game.Screens.Spectate
         /// <param name="userId">The user to stop spectating.</param>
         protected void RemoveUser(int userId)
         {
-            onUserStateRemoved(userId);
+            if (!userStates.TryGetValue(userId, out var state))
+                return;
+
+            onUserStateRemoved(userId, state);
 
             users.Remove(userId);
             userMap.Remove(userId);

From 84171962e56faa9b5310450d01d0faedeffd2146 Mon Sep 17 00:00:00 2001
From: Susko3 <16479013+Susko3@users.noreply.github.com>
Date: Thu, 3 Feb 2022 13:55:04 +0100
Subject: [PATCH 2784/5547] Change name and add xmldoc

---
 osu.Android/GameplayScreenRotationLocker.cs | 2 +-
 osu.Android/OsuGameActivity.cs              | 8 ++++++--
 2 files changed, 7 insertions(+), 3 deletions(-)

diff --git a/osu.Android/GameplayScreenRotationLocker.cs b/osu.Android/GameplayScreenRotationLocker.cs
index 1b7893e5b9..2e83f784d3 100644
--- a/osu.Android/GameplayScreenRotationLocker.cs
+++ b/osu.Android/GameplayScreenRotationLocker.cs
@@ -27,7 +27,7 @@ namespace osu.Android
         {
             gameActivity.RunOnUiThread(() =>
             {
-                gameActivity.RequestedOrientation = userPlaying.NewValue ? ScreenOrientation.Locked : gameActivity.ScreenOrientation;
+                gameActivity.RequestedOrientation = userPlaying.NewValue ? ScreenOrientation.Locked : gameActivity.DefaultOrientation;
             });
         }
     }
diff --git a/osu.Android/OsuGameActivity.cs b/osu.Android/OsuGameActivity.cs
index 7de597fe88..eebd079f68 100644
--- a/osu.Android/OsuGameActivity.cs
+++ b/osu.Android/OsuGameActivity.cs
@@ -44,7 +44,11 @@ namespace osu.Android
     {
         private static readonly string[] osu_url_schemes = { "osu", "osump" };
 
-        public ScreenOrientation ScreenOrientation = ScreenOrientation.Unspecified;
+        /// <summary>
+        /// The default screen orientation.
+        /// </summary>
+        /// <remarks>Adjusted on startup to match expected UX for the current device type (phone/tablet).</remarks>
+        public ScreenOrientation DefaultOrientation = ScreenOrientation.Unspecified;
 
         private OsuGameAndroid game;
 
@@ -72,7 +76,7 @@ namespace osu.Android
             float smallestWidthDp = Math.Min(displaySize.X, displaySize.Y) / Resources.DisplayMetrics.Density;
             bool isTablet = smallestWidthDp >= 600f;
 
-            RequestedOrientation = ScreenOrientation = isTablet ? ScreenOrientation.FullUser : ScreenOrientation.SensorLandscape;
+            RequestedOrientation = DefaultOrientation = isTablet ? ScreenOrientation.FullUser : ScreenOrientation.SensorLandscape;
         }
 
         protected override void OnNewIntent(Intent intent) => handleIntent(intent);

From d4ebff6ea1f381bad406c692ab15b097fbdefd2b Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 3 Feb 2022 23:18:22 +0900
Subject: [PATCH 2785/5547] Add failing test

---
 .../Multiplayer/TestSceneMultiplayer.cs       | 46 +++++++++++++++++++
 1 file changed, 46 insertions(+)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
index 3563869d8b..27bf1c209c 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
@@ -871,6 +871,52 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddUntilStep("queue is empty", () => this.ChildrenOfType<MultiplayerQueueList>().Single().Items.Count == 0);
         }
 
+        [Test]
+        public void TestGameplayStartsWhileInSpectatorScreen()
+        {
+            createRoom(() => new Room
+            {
+                Name = { Value = "Test Room" },
+                Playlist =
+                {
+                    new PlaylistItem
+                    {
+                        Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo },
+                        Ruleset = { Value = new OsuRuleset().RulesetInfo },
+                    }
+                }
+            });
+
+            AddStep("join other user and make host", () =>
+            {
+                client.AddUser(new APIUser { Id = 1234 });
+                client.TransferHost(1234);
+            });
+
+            AddStep("set local user spectating", () => client.ChangeUserState(API.LocalUser.Value.OnlineID, MultiplayerUserState.Spectating));
+            AddUntilStep("wait for spectating state", () => client.LocalUser?.State == MultiplayerUserState.Spectating);
+
+            runGameplay();
+
+            AddStep("exit gameplay for other user", () => client.ChangeUserState(1234, MultiplayerUserState.Idle));
+            AddUntilStep("wait for room to be idle", () => client.Room?.State == MultiplayerRoomState.Open);
+
+            runGameplay();
+
+            void runGameplay()
+            {
+                AddStep("start match by other user", () =>
+                {
+                    client.ChangeUserState(1234, MultiplayerUserState.Ready);
+                    client.StartMatch();
+                });
+
+                AddUntilStep("wait for loading", () => client.Room?.State == MultiplayerRoomState.WaitingForLoad);
+                AddStep("set player loaded", () => client.ChangeUserState(1234, MultiplayerUserState.Loaded));
+                AddUntilStep("wait for gameplay to start", () => client.Room?.State == MultiplayerRoomState.Playing);
+            }
+        }
+
         private void enterGameplay()
         {
             pressReadyButton();

From 6dc0f3fd960cc5a4fd914123388a0585901e0243 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 3 Feb 2022 18:14:30 +0100
Subject: [PATCH 2786/5547] Merge difficulty creation methods into one

One of them wasn't really doing much anymore and was more obfuscating
what was actually happening at this point.
---
 osu.Game/Beatmaps/BeatmapManager.cs      | 14 +++++++++-----
 osu.Game/Beatmaps/BeatmapModelManager.cs | 13 -------------
 2 files changed, 9 insertions(+), 18 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index d60cfdee9e..633eb8f15e 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -120,15 +120,19 @@ namespace osu.Game.Beatmaps
             // but cases where this isn't true seem rather rare / pathological.
             var referenceBeatmap = GetWorkingBeatmap(beatmapSetInfo.Beatmaps.First());
 
-            var newBeatmap = new Beatmap
-            {
-                BeatmapInfo = new BeatmapInfo(rulesetInfo, new BeatmapDifficulty(), referenceBeatmap.Metadata.DeepClone())
-            };
+            var newBeatmapInfo = new BeatmapInfo(rulesetInfo, new BeatmapDifficulty(), referenceBeatmap.Metadata.DeepClone());
 
+            // populate circular beatmap set info <-> beatmap info references manually.
+            // several places like `BeatmapModelManager.Save()` or `GetWorkingBeatmap()`
+            // rely on them being freely traversable in both directions for correct operation.
+            beatmapSetInfo.Beatmaps.Add(newBeatmapInfo);
+            newBeatmapInfo.BeatmapSet = beatmapSetInfo;
+
+            var newBeatmap = new Beatmap { BeatmapInfo = newBeatmapInfo };
             foreach (var timingPoint in referenceBeatmap.Beatmap.ControlPointInfo.TimingPoints)
                 newBeatmap.ControlPointInfo.Add(timingPoint.Time, timingPoint.DeepClone());
 
-            beatmapModelManager.AddDifficultyToBeatmapSet(beatmapSetInfo, newBeatmap);
+            beatmapModelManager.Save(newBeatmapInfo, newBeatmap);
 
             workingBeatmapCache.Invalidate(beatmapSetInfo);
             return GetWorkingBeatmap(newBeatmap.BeatmapInfo);
diff --git a/osu.Game/Beatmaps/BeatmapModelManager.cs b/osu.Game/Beatmaps/BeatmapModelManager.cs
index b9f0af8833..4c680bbcc9 100644
--- a/osu.Game/Beatmaps/BeatmapModelManager.cs
+++ b/osu.Game/Beatmaps/BeatmapModelManager.cs
@@ -90,19 +90,6 @@ namespace osu.Game.Beatmaps
             WorkingBeatmapCache?.Invalidate(beatmapInfo);
         }
 
-        /// <summary>
-        /// Add a new difficulty to the beatmap set represented by the provided <see cref="BeatmapSetInfo"/>.
-        /// </summary>
-        public void AddDifficultyToBeatmapSet(BeatmapSetInfo beatmapSetInfo, Beatmap beatmap)
-        {
-            var beatmapInfo = beatmap.BeatmapInfo;
-
-            beatmapSetInfo.Beatmaps.Add(beatmapInfo);
-            beatmapInfo.BeatmapSet = beatmapSetInfo;
-
-            Save(beatmapInfo, beatmap);
-        }
-
         private static string getFilename(BeatmapInfo beatmapInfo)
         {
             var metadata = beatmapInfo.Metadata;

From ee1feae8062919f2992bd41b23cabd19aa49f345 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 4 Feb 2022 11:06:18 +0900
Subject: [PATCH 2787/5547] Remove unnecessary ruleset ordering

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

diff --git a/osu.Game/Screens/Edit/Editor.cs b/osu.Game/Screens/Edit/Editor.cs
index 78c5c862f7..5503a62ba2 100644
--- a/osu.Game/Screens/Edit/Editor.cs
+++ b/osu.Game/Screens/Edit/Editor.cs
@@ -834,7 +834,7 @@ namespace osu.Game.Screens.Edit
         {
             var rulesetItems = new List<MenuItem>();
 
-            foreach (var ruleset in rulesets.AvailableRulesets.OrderBy(ruleset => ruleset.OnlineID))
+            foreach (var ruleset in rulesets.AvailableRulesets)
                 rulesetItems.Add(new EditorMenuItem(ruleset.Name, MenuItemType.Standard, () => CreateNewDifficulty(ruleset)));
 
             return new EditorMenuItem("Create new difficulty") { Items = rulesetItems };

From bbef12e72c7bbaaf41c9a9b34b9d90ce5b4cfc2e Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 4 Feb 2022 05:45:12 +0300
Subject: [PATCH 2788/5547] Refactor `ExpandingControlContainer` to no longer
 rely on controls

---
 ...iner.cs => TestSceneExpandingContainer.cs} | 40 ++----------
 osu.Game/Overlays/ExpandableSlider.cs         |  4 +-
 osu.Game/Overlays/ExpandingButtonContainer.cs |  6 +-
 ...trolContainer.cs => ExpandingContainer.cs} | 64 ++++++-------------
 osu.Game/Overlays/IExpandable.cs              | 11 ----
 osu.Game/Overlays/IExpandableControl.cs       | 12 ----
 6 files changed, 28 insertions(+), 109 deletions(-)
 rename osu.Game.Tests/Visual/UserInterface/{TestSceneExpandingControlContainer.cs => TestSceneExpandingContainer.cs} (74%)
 rename osu.Game/Overlays/{ExpandingControlContainer.cs => ExpandingContainer.cs} (54%)
 delete mode 100644 osu.Game/Overlays/IExpandableControl.cs

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneExpandingControlContainer.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneExpandingContainer.cs
similarity index 74%
rename from osu.Game.Tests/Visual/UserInterface/TestSceneExpandingControlContainer.cs
rename to osu.Game.Tests/Visual/UserInterface/TestSceneExpandingContainer.cs
index 48089566cc..f63591311f 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneExpandingControlContainer.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneExpandingContainer.cs
@@ -1,20 +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.Linq;
 using NUnit.Framework;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
-using osu.Framework.Testing;
-using osu.Game.Graphics.UserInterface;
 using osu.Game.Overlays;
 using osu.Game.Overlays.Settings.Sections;
 using osuTK;
-using osuTK.Input;
 
 namespace osu.Game.Tests.Visual.UserInterface
 {
-    public class TestSceneExpandingControlContainer : OsuManualInputManagerTestScene
+    public class TestSceneExpandingContainer : OsuManualInputManagerTestScene
     {
         private TestExpandingContainer container;
         private SettingsToolboxGroup toolboxGroup;
@@ -84,44 +80,22 @@ namespace osu.Game.Tests.Visual.UserInterface
         }
 
         /// <summary>
-        /// Tests hovering over controls expands the parenting container appropriately and does not contract until hover is lost from container.
+        /// Tests hovering expands the container and does not contract until hover is lost.
         /// </summary>
         [Test]
-        public void TestHoveringControlExpandsContainer()
+        public void TestHoveringExpandsContainer()
         {
             AddAssert("ensure container contracted", () => !container.Expanded.Value);
 
-            AddStep("hover slider", () => InputManager.MoveMouseTo(slider1));
+            AddStep("hover container", () => InputManager.MoveMouseTo(container));
             AddAssert("container expanded", () => container.Expanded.Value);
             AddAssert("controls expanded", () => slider1.Expanded.Value && slider2.Expanded.Value);
 
-            AddStep("hover group top", () => InputManager.MoveMouseTo(toolboxGroup.ScreenSpaceDrawQuad.TopLeft + new Vector2(5)));
-            AddAssert("container still expanded", () => container.Expanded.Value);
-            AddAssert("controls still expanded", () => slider1.Expanded.Value && slider2.Expanded.Value);
-
             AddStep("hover away", () => InputManager.MoveMouseTo(Vector2.Zero));
             AddAssert("container contracted", () => !container.Expanded.Value);
             AddAssert("controls contracted", () => !slider1.Expanded.Value && !slider2.Expanded.Value);
         }
 
-        /// <summary>
-        /// Tests dragging a UI control (e.g. <see cref="OsuSliderBar{T}"/>) outside its parenting container does not contract it until dragging is finished.
-        /// </summary>
-        [Test]
-        public void TestDraggingControlOutsideDoesntContractContainer()
-        {
-            AddStep("hover slider", () => InputManager.MoveMouseTo(slider1));
-            AddAssert("container expanded", () => container.Expanded.Value);
-
-            AddStep("hover slider nub", () => InputManager.MoveMouseTo(slider1.ChildrenOfType<Nub>().Single()));
-            AddStep("hold slider nub", () => InputManager.PressButton(MouseButton.Left));
-            AddStep("drag outside container", () => InputManager.MoveMouseTo(Vector2.Zero));
-            AddAssert("container still expanded", () => container.Expanded.Value);
-
-            AddStep("release slider nub", () => InputManager.ReleaseButton(MouseButton.Left));
-            AddAssert("container contracted", () => !container.Expanded.Value);
-        }
-
         /// <summary>
         /// Tests expanding a container will expand underlying groups if contracted.
         /// </summary>
@@ -157,21 +131,21 @@ namespace osu.Game.Tests.Visual.UserInterface
         }
 
         /// <summary>
-        /// Tests expanding a container via <see cref="ExpandingControlContainer{TControl}.Expanded"/> does not get contracted by losing hover.
+        /// Tests expanding a container via <see cref="ExpandingContainer.Expanded"/> does not get contracted by losing hover.
         /// </summary>
         [Test]
         public void TestExpandingContainerDoesntGetContractedByHover()
         {
             AddStep("expand container", () => container.Expanded.Value = true);
 
-            AddStep("hover control", () => InputManager.MoveMouseTo(slider1));
+            AddStep("hover container", () => InputManager.MoveMouseTo(container));
             AddAssert("container still expanded", () => container.Expanded.Value);
 
             AddStep("hover away", () => InputManager.MoveMouseTo(Vector2.Zero));
             AddAssert("container still expanded", () => container.Expanded.Value);
         }
 
-        private class TestExpandingContainer : ExpandingControlContainer<IExpandableControl>
+        private class TestExpandingContainer : ExpandingContainer
         {
             public TestExpandingContainer()
                 : base(120, 250)
diff --git a/osu.Game/Overlays/ExpandableSlider.cs b/osu.Game/Overlays/ExpandableSlider.cs
index d346b9b22c..062de98659 100644
--- a/osu.Game/Overlays/ExpandableSlider.cs
+++ b/osu.Game/Overlays/ExpandableSlider.cs
@@ -17,7 +17,7 @@ namespace osu.Game.Overlays
     /// <summary>
     /// An <see cref="IExpandable"/> implementation for the UI slider bar control.
     /// </summary>
-    public class ExpandableSlider<T, TSlider> : CompositeDrawable, IExpandableControl, IHasCurrentValue<T>
+    public class ExpandableSlider<T, TSlider> : CompositeDrawable, IExpandable, IHasCurrentValue<T>
         where T : struct, IEquatable<T>, IComparable<T>, IConvertible
         where TSlider : OsuSliderBar<T>, new()
     {
@@ -72,8 +72,6 @@ namespace osu.Game.Overlays
 
         public BindableBool Expanded { get; } = new BindableBool();
 
-        bool IExpandable.ShouldBeExpanded => IsHovered || slider.IsDragged;
-
         public override bool HandlePositionalInput => true;
 
         public ExpandableSlider()
diff --git a/osu.Game/Overlays/ExpandingButtonContainer.cs b/osu.Game/Overlays/ExpandingButtonContainer.cs
index d7ff285707..8fb3e1b550 100644
--- a/osu.Game/Overlays/ExpandingButtonContainer.cs
+++ b/osu.Game/Overlays/ExpandingButtonContainer.cs
@@ -1,17 +1,15 @@
 // 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.UserInterface;
-
 namespace osu.Game.Overlays
 {
     /// <summary>
-    /// An <see cref="ExpandingControlContainer{TControl}"/> with a long hover expansion delay for buttons.
+    /// An <see cref="ExpandingContainer"/> with a long hover expansion delay.
     /// </summary>
     /// <remarks>
     /// Mostly used for buttons with explanatory labels, in which the label would display after a "long hover".
     /// </remarks>
-    public class ExpandingButtonContainer : ExpandingControlContainer<OsuButton>
+    public class ExpandingButtonContainer : ExpandingContainer
     {
         protected ExpandingButtonContainer(float contractedWidth, float expandedWidth)
             : base(contractedWidth, expandedWidth)
diff --git a/osu.Game/Overlays/ExpandingControlContainer.cs b/osu.Game/Overlays/ExpandingContainer.cs
similarity index 54%
rename from osu.Game/Overlays/ExpandingControlContainer.cs
rename to osu.Game/Overlays/ExpandingContainer.cs
index 859e4bcd25..ea3fffcb78 100644
--- a/osu.Game/Overlays/ExpandingControlContainer.cs
+++ b/osu.Game/Overlays/ExpandingContainer.cs
@@ -1,23 +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 System.Linq;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Input.Events;
-using osu.Framework.Testing;
 using osu.Framework.Threading;
 using osu.Game.Graphics.Containers;
 
 namespace osu.Game.Overlays
 {
     /// <summary>
-    /// Represents a <see cref="Container"/> with the ability to expand/contract when hovering the controls within it.
+    /// Represents a <see cref="Container"/> with the ability to expand/contract on hover.
     /// </summary>
-    /// <typeparam name="TControl">The type of UI control to lookup for hover expansion.</typeparam>
-    public class ExpandingControlContainer<TControl> : Container, IExpandingContainer
-        where TControl : class, IDrawable
+    public class ExpandingContainer : Container, IExpandingContainer
     {
         private readonly float contractedWidth;
         private readonly float expandedWidth;
@@ -33,7 +29,7 @@ namespace osu.Game.Overlays
 
         protected FillFlowContainer FillFlow { get; }
 
-        protected ExpandingControlContainer(float contractedWidth, float expandedWidth)
+        protected ExpandingContainer(float contractedWidth, float expandedWidth)
         {
             this.contractedWidth = contractedWidth;
             this.expandedWidth = expandedWidth;
@@ -57,7 +53,6 @@ namespace osu.Game.Overlays
         }
 
         private ScheduledDelegate hoverExpandEvent;
-        private TControl activeControl;
 
         protected override void LoadComplete()
         {
@@ -69,61 +64,38 @@ namespace osu.Game.Overlays
             }, true);
         }
 
-        protected override void Update()
-        {
-            base.Update();
-
-            // if the container was expanded from hovering over a control, we have to check per-frame whether we can contract it back.
-            // that's because contracting the container depends not only on whether it's no longer hovered,
-            // but also on whether the hovered control is no longer in a dragged state (if it was).
-            if (hoverExpandEvent != null && !IsHovered && (activeControl == null || !isControlActive(activeControl)))
-            {
-                hoverExpandEvent?.Cancel();
-
-                Expanded.Value = false;
-                hoverExpandEvent = null;
-                activeControl = null;
-            }
-        }
-
         protected override bool OnHover(HoverEvent e)
         {
-            queueExpandIfHovering();
+            updateHoverExpansion();
             return true;
         }
 
         protected override bool OnMouseMove(MouseMoveEvent e)
         {
-            queueExpandIfHovering();
+            updateHoverExpansion();
             return base.OnMouseMove(e);
         }
 
-        private void queueExpandIfHovering()
+        protected override void OnHoverLost(HoverLostEvent e)
         {
-            // if the same control is hovered or dragged, let the scheduled expand play out..
-            if (activeControl != null && isControlActive(activeControl))
+            if (hoverExpandEvent != null)
+            {
+                hoverExpandEvent?.Cancel();
+                hoverExpandEvent = null;
+
+                Expanded.Value = false;
                 return;
+            }
 
-            // ..otherwise check whether a new control is hovered, and if so, queue a new hover operation.
-            hoverExpandEvent?.Cancel();
-
-            // usually we wouldn't use ChildrenOfType in implementations, but this is the simplest way
-            // to handle cases like the editor where the controls may be nested within a child hierarchy.
-            activeControl = FillFlow.ChildrenOfType<TControl>().FirstOrDefault(isControlActive);
-
-            if (activeControl != null && !Expanded.Value)
-                hoverExpandEvent = Scheduler.AddDelayed(() => Expanded.Value = true, HoverExpansionDelay);
+            base.OnHoverLost(e);
         }
 
-        /// <summary>
-        /// Whether the given control is currently active, by checking whether it's hovered or dragged.
-        /// </summary>
-        private bool isControlActive(TControl control)
+        private void updateHoverExpansion()
         {
-            if (control is IExpandable expandable)
-                return expandable.ShouldBeExpanded;
+            hoverExpandEvent?.Cancel();
 
-            return control.IsHovered || control.IsDragged;
+            if (IsHovered && !Expanded.Value)
+                hoverExpandEvent = Scheduler.AddDelayed(() => Expanded.Value = true, HoverExpansionDelay);
         }
     }
 }
diff --git a/osu.Game/Overlays/IExpandable.cs b/osu.Game/Overlays/IExpandable.cs
index f998fc7b9f..770ac97847 100644
--- a/osu.Game/Overlays/IExpandable.cs
+++ b/osu.Game/Overlays/IExpandable.cs
@@ -3,7 +3,6 @@
 
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
-using osu.Game.Graphics.UserInterface;
 
 namespace osu.Game.Overlays
 {
@@ -16,15 +15,5 @@ namespace osu.Game.Overlays
         /// Whether this drawable is in an expanded state.
         /// </summary>
         BindableBool Expanded { get; }
-
-        /// <summary>
-        /// Whether this drawable should be/stay expanded by a parenting <see cref="IExpandingContainer"/>.
-        /// By default, this is <see langword="true"/> when this drawable is in a hovered or dragged state.
-        /// </summary>
-        /// <remarks>
-        /// This is defined for certain controls which may have a child handling dragging instead.
-        /// (e.g. <see cref="ExpandableSlider{T,TSlider}"/> in which dragging is handled by their underlying <see cref="OsuSliderBar{T}"/> control).
-        /// </remarks>
-        bool ShouldBeExpanded => IsHovered || IsDragged;
     }
 }
diff --git a/osu.Game/Overlays/IExpandableControl.cs b/osu.Game/Overlays/IExpandableControl.cs
deleted file mode 100644
index 2cda6f467b..0000000000
--- a/osu.Game/Overlays/IExpandableControl.cs
+++ /dev/null
@@ -1,12 +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.Overlays
-{
-    /// <summary>
-    /// An interface for UI controls with the ability to expand/contract.
-    /// </summary>
-    public interface IExpandableControl : IExpandable
-    {
-    }
-}

From 4728919bcaaa7151f3d3036a629212f8e395f570 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 4 Feb 2022 15:45:27 +0900
Subject: [PATCH 2789/5547] Update framework

---
 osu.Android.props        | 2 +-
 osu.Game/osu.Game.csproj | 2 +-
 osu.iOS.props            | 4 ++--
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Android.props b/osu.Android.props
index f89994cd56..04c543750e 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -52,7 +52,7 @@
   </ItemGroup>
   <ItemGroup>
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.202.0" />
-    <PackageReference Include="ppy.osu.Framework.Android" Version="2022.128.0" />
+    <PackageReference Include="ppy.osu.Framework.Android" Version="2022.204.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
     <!-- Realm needs to be directly referenced in all Xamarin projects, as it will not pull in its transitive dependencies otherwise. -->
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 50cef71b26..83c3593edb 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="10.8.0" />
-    <PackageReference Include="ppy.osu.Framework" Version="2022.128.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2022.204.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.202.0" />
     <PackageReference Include="Sentry" Version="3.13.0" />
     <PackageReference Include="SharpCompress" Version="0.30.1" />
diff --git a/osu.iOS.props b/osu.iOS.props
index 9ec0f1c0a0..b0c056ea21 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -60,7 +60,7 @@
     <Reference Include="System.Net.Http" />
   </ItemGroup>
   <ItemGroup Label="Package References">
-    <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.128.0" />
+    <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.204.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.202.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net5.0 / net6.0) -->
@@ -83,7 +83,7 @@
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="2.2.6" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.Core" Version="2.2.6" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
-    <PackageReference Include="ppy.osu.Framework" Version="2022.128.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2022.204.0" />
     <PackageReference Include="SharpCompress" Version="0.30.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
     <PackageReference Include="System.ComponentModel.Annotations" Version="5.0.0" />

From 52fdf0349f32a73ad1022a9b5ef26de9c39edc36 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 4 Feb 2022 16:07:05 +0900
Subject: [PATCH 2790/5547] Add safe area support via `ScalingContainer`

---
 .../Graphics/Containers/ScalingContainer.cs   | 10 +++++++-
 osu.Game/OsuGameBase.cs                       | 24 ++++++++++++-------
 2 files changed, 24 insertions(+), 10 deletions(-)

diff --git a/osu.Game/Graphics/Containers/ScalingContainer.cs b/osu.Game/Graphics/Containers/ScalingContainer.cs
index d2b1e5e523..f9bd571131 100644
--- a/osu.Game/Graphics/Containers/ScalingContainer.cs
+++ b/osu.Game/Graphics/Containers/ScalingContainer.cs
@@ -101,6 +101,9 @@ namespace osu.Game.Graphics.Containers
             }
         }
 
+        [Resolved]
+        private ISafeArea safeArea { get; set; }
+
         [BackgroundDependencyLoader]
         private void load(OsuConfigManager config)
         {
@@ -118,6 +121,8 @@ namespace osu.Game.Graphics.Containers
 
             posY = config.GetBindable<float>(OsuSetting.ScalingPositionY);
             posY.ValueChanged += _ => updateSize();
+
+            safeArea.SafeAreaPadding.BindValueChanged(_ => updateSize());
         }
 
         protected override void LoadComplete()
@@ -161,7 +166,10 @@ namespace osu.Game.Graphics.Containers
 
             var targetSize = scaling ? new Vector2(sizeX.Value, sizeY.Value) : Vector2.One;
             var targetPosition = scaling ? new Vector2(posX.Value, posY.Value) * (Vector2.One - targetSize) : Vector2.Zero;
-            bool requiresMasking = scaling && targetSize != Vector2.One;
+            bool requiresMasking = scaling && targetSize != Vector2.One
+                                   // For the top level scaling container, for now we apply masking if safe areas are in use.
+                                   // In the future this can likely be removed as more of the actual UI supports overflowing into the safe areas.
+                                   || (targetMode == ScalingMode.Everything && safeArea.SafeAreaPadding.Value.Total != Vector2.Zero);
 
             if (requiresMasking)
                 sizableContainer.Masking = true;
diff --git a/osu.Game/OsuGameBase.cs b/osu.Game/OsuGameBase.cs
index 1713e73905..5f87abcfed 100644
--- a/osu.Game/OsuGameBase.cs
+++ b/osu.Game/OsuGameBase.cs
@@ -299,16 +299,22 @@ namespace osu.Game
 
             GlobalActionContainer globalBindings;
 
-            var mainContent = new Drawable[]
+            base.Content.Add(new SafeAreaContainer
             {
-                MenuCursorContainer = new MenuCursorContainer { RelativeSizeAxes = Axes.Both },
-                // to avoid positional input being blocked by children, ensure the GlobalActionContainer is above everything.
-                globalBindings = new GlobalActionContainer(this)
-            };
-
-            MenuCursorContainer.Child = content = new OsuTooltipContainer(MenuCursorContainer.Cursor) { RelativeSizeAxes = Axes.Both };
-
-            base.Content.Add(CreateScalingContainer().WithChildren(mainContent));
+                RelativeSizeAxes = Axes.Both,
+                Child = CreateScalingContainer().WithChildren(new Drawable[]
+                {
+                    (MenuCursorContainer = new MenuCursorContainer
+                    {
+                        RelativeSizeAxes = Axes.Both
+                    }).WithChild(content = new OsuTooltipContainer(MenuCursorContainer.Cursor)
+                    {
+                        RelativeSizeAxes = Axes.Both
+                    }),
+                    // to avoid positional input being blocked by children, ensure the GlobalActionContainer is above everything.
+                    globalBindings = new GlobalActionContainer(this)
+                })
+            });
 
             KeyBindingStore = new RealmKeyBindingStore(realm, keyCombinationProvider);
             KeyBindingStore.Register(globalBindings, RulesetStore.AvailableRulesets);

From 1444df4d50ce0e2d9417f0958d4a39f76ae8e85e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 4 Feb 2022 16:37:11 +0900
Subject: [PATCH 2791/5547] Add test scene for playing with safe areas

---
 .../TestSceneSafeAreaHandling.cs              | 116 ++++++++++++++++++
 1 file changed, 116 insertions(+)
 create mode 100644 osu.Game.Tests/Visual/UserInterface/TestSceneSafeAreaHandling.cs

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneSafeAreaHandling.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneSafeAreaHandling.cs
new file mode 100644
index 0000000000..676ae1276b
--- /dev/null
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneSafeAreaHandling.cs
@@ -0,0 +1,116 @@
+// 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.Bindables;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.Shapes;
+using osu.Game.Overlays.Settings;
+using osuTK.Graphics;
+
+namespace osu.Game.Tests.Visual.UserInterface
+{
+    public class TestSceneSafeAreaHandling : OsuGameTestScene
+    {
+        private SafeAreaDefiningContainer safeAreaContainer;
+
+        private static BindableSafeArea safeArea;
+
+        private readonly Bindable<float> safeAreaPaddingTop = new BindableFloat { MinValue = 0, MaxValue = 200 };
+        private readonly Bindable<float> safeAreaPaddingBottom = new BindableFloat { MinValue = 0, MaxValue = 200 };
+        private readonly Bindable<float> safeAreaPaddingLeft = new BindableFloat { MinValue = 0, MaxValue = 200 };
+        private readonly Bindable<float> safeAreaPaddingRight = new BindableFloat { MinValue = 0, MaxValue = 200 };
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            // Usually this would be placed between the host and the game, but that's a bit of a pain to do with the test scene hierarchy.
+
+            // Add is required for the container to get a size (and give out correct metrics to the usages in SafeAreaContainer).
+            Add(
+                safeAreaContainer = new SafeAreaDefiningContainer(safeArea = new BindableSafeArea())
+                {
+                    RelativeSizeAxes = Axes.Both
+                });
+
+            // Cache is required for the test game to see the safe area.
+            Dependencies.CacheAs<ISafeArea>(safeAreaContainer);
+        }
+
+        public override void SetUpSteps()
+        {
+            AddStep("Add adjust controls", () =>
+            {
+                Add(new Container
+                {
+                    Depth = float.MinValue,
+                    Anchor = Anchor.Centre,
+                    Origin = Anchor.Centre,
+                    AutoSizeAxes = Axes.Both,
+                    Children = new Drawable[]
+                    {
+                        new Box
+                        {
+                            Colour = Color4.Black,
+                            RelativeSizeAxes = Axes.Both,
+                            Alpha = 0.8f,
+                        },
+                        new FillFlowContainer
+                        {
+                            AutoSizeAxes = Axes.Y,
+                            Width = 400,
+                            Children = new Drawable[]
+                            {
+                                new SettingsSlider<float>
+                                {
+                                    Current = safeAreaPaddingTop,
+                                    LabelText = "Top"
+                                },
+                                new SettingsSlider<float>
+                                {
+                                    Current = safeAreaPaddingBottom,
+                                    LabelText = "Bottom"
+                                },
+                                new SettingsSlider<float>
+                                {
+                                    Current = safeAreaPaddingLeft,
+                                    LabelText = "Left"
+                                },
+                                new SettingsSlider<float>
+                                {
+                                    Current = safeAreaPaddingRight,
+                                    LabelText = "Right"
+                                },
+                            }
+                        }
+                    }
+                });
+
+                safeAreaPaddingTop.BindValueChanged(_ => updateSafeArea());
+                safeAreaPaddingBottom.BindValueChanged(_ => updateSafeArea());
+                safeAreaPaddingLeft.BindValueChanged(_ => updateSafeArea());
+                safeAreaPaddingRight.BindValueChanged(_ => updateSafeArea());
+            });
+
+            base.SetUpSteps();
+        }
+
+        private void updateSafeArea()
+        {
+            safeArea.Value = new MarginPadding
+            {
+                Top = safeAreaPaddingTop.Value,
+                Bottom = safeAreaPaddingBottom.Value,
+                Left = safeAreaPaddingLeft.Value,
+                Right = safeAreaPaddingRight.Value,
+            };
+        }
+
+        [Test]
+        public void TestSafeArea()
+        {
+        }
+    }
+}

From 30d2c7ba6a9355e88a3f605dd68d23728ede247a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 4 Feb 2022 17:07:21 +0900
Subject: [PATCH 2792/5547] Add parenthesis to disambiguify conditionals

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

diff --git a/osu.Game/Graphics/Containers/ScalingContainer.cs b/osu.Game/Graphics/Containers/ScalingContainer.cs
index f9bd571131..aa4e3a7fde 100644
--- a/osu.Game/Graphics/Containers/ScalingContainer.cs
+++ b/osu.Game/Graphics/Containers/ScalingContainer.cs
@@ -166,7 +166,7 @@ namespace osu.Game.Graphics.Containers
 
             var targetSize = scaling ? new Vector2(sizeX.Value, sizeY.Value) : Vector2.One;
             var targetPosition = scaling ? new Vector2(posX.Value, posY.Value) * (Vector2.One - targetSize) : Vector2.Zero;
-            bool requiresMasking = scaling && targetSize != Vector2.One
+            bool requiresMasking = (scaling && targetSize != Vector2.One)
                                    // For the top level scaling container, for now we apply masking if safe areas are in use.
                                    // In the future this can likely be removed as more of the actual UI supports overflowing into the safe areas.
                                    || (targetMode == ScalingMode.Everything && safeArea.SafeAreaPadding.Value.Total != Vector2.Zero);

From b41655d5b905cd28425e2851f6900f24f7a82893 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 3 Feb 2022 23:22:08 +0900
Subject: [PATCH 2793/5547] Fix crash when gameplay starts while in
 multi-spectator screen

---
 osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs  | 1 +
 .../OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs    | 7 +++++++
 2 files changed, 8 insertions(+)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
index 27bf1c209c..8f6ba6375f 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
@@ -914,6 +914,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 AddUntilStep("wait for loading", () => client.Room?.State == MultiplayerRoomState.WaitingForLoad);
                 AddStep("set player loaded", () => client.ChangeUserState(1234, MultiplayerUserState.Loaded));
                 AddUntilStep("wait for gameplay to start", () => client.Room?.State == MultiplayerRoomState.Playing);
+                AddUntilStep("wait for local user to enter spectator", () => multiplayerComponents.CurrentScreen is MultiSpectatorScreen);
             }
         }
 
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
index 4bd68f2034..020217eac6 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
@@ -457,6 +457,13 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
                 return;
             }
 
+            // The beatmap is queried asynchronously when the selected item changes.
+            // This is an issue with MultiSpectatorScreen which is effectively in an always "ready" state and receives LoadRequested() callbacks
+            // even when it is not truly ready (i.e. the beatmap hasn't been selected by the client yet). For the time being, a simple fix to this is to ignore the callback.
+            // Note that spectator will be entered automatically when the client is capable of doing so via beatmap availability callbacks (see: updateBeatmapAvailability()).
+            if (client.LocalUser?.State == MultiplayerUserState.Spectating && Beatmap.IsDefault)
+                return;
+
             StartPlay();
 
             readyClickOperation?.Dispose();

From 0473c6c52f9156954eb7c782a421a540cbc35e5d Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 4 Feb 2022 17:53:30 +0900
Subject: [PATCH 2794/5547] Also handle null SelectedItem for safety

---
 .../Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
index 020217eac6..a397493bab 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
@@ -461,7 +461,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
             // This is an issue with MultiSpectatorScreen which is effectively in an always "ready" state and receives LoadRequested() callbacks
             // even when it is not truly ready (i.e. the beatmap hasn't been selected by the client yet). For the time being, a simple fix to this is to ignore the callback.
             // Note that spectator will be entered automatically when the client is capable of doing so via beatmap availability callbacks (see: updateBeatmapAvailability()).
-            if (client.LocalUser?.State == MultiplayerUserState.Spectating && Beatmap.IsDefault)
+            if (client.LocalUser?.State == MultiplayerUserState.Spectating && (SelectedItem.Value == null || Beatmap.IsDefault))
                 return;
 
             StartPlay();

From 8fc4d0c6f51053184b5d8952214aa652cf6f7c1a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 4 Feb 2022 18:20:17 +0900
Subject: [PATCH 2795/5547] Add override edge rule to overflow above home
 indicator on iOS

---
 osu.Game/OsuGameBase.cs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Game/OsuGameBase.cs b/osu.Game/OsuGameBase.cs
index 5f87abcfed..594e7a10c4 100644
--- a/osu.Game/OsuGameBase.cs
+++ b/osu.Game/OsuGameBase.cs
@@ -301,6 +301,7 @@ namespace osu.Game
 
             base.Content.Add(new SafeAreaContainer
             {
+                SafeAreaOverrideEdges = Edges.Bottom,
                 RelativeSizeAxes = Axes.Both,
                 Child = CreateScalingContainer().WithChildren(new Drawable[]
                 {

From 6457cf8d9b70264e46f757b01116b85ef393c163 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 4 Feb 2022 18:45:38 +0900
Subject: [PATCH 2796/5547] Fix weird formatting in `TestSceneSafeArea`

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

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneSafeAreaHandling.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneSafeAreaHandling.cs
index 676ae1276b..8b4e3f6d3a 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneSafeAreaHandling.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneSafeAreaHandling.cs
@@ -29,11 +29,10 @@ namespace osu.Game.Tests.Visual.UserInterface
             // Usually this would be placed between the host and the game, but that's a bit of a pain to do with the test scene hierarchy.
 
             // Add is required for the container to get a size (and give out correct metrics to the usages in SafeAreaContainer).
-            Add(
-                safeAreaContainer = new SafeAreaDefiningContainer(safeArea = new BindableSafeArea())
-                {
-                    RelativeSizeAxes = Axes.Both
-                });
+            Add(safeAreaContainer = new SafeAreaDefiningContainer(safeArea = new BindableSafeArea())
+            {
+                RelativeSizeAxes = Axes.Both
+            });
 
             // Cache is required for the test game to see the safe area.
             Dependencies.CacheAs<ISafeArea>(safeAreaContainer);

From 915d63f6dea742d853f7e635c3d18093d30de815 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 4 Feb 2022 18:58:29 +0900
Subject: [PATCH 2797/5547] Limit safe area bottom override to iOS only

---
 osu.Game/OsuGameBase.cs | 8 +++++++-
 osu.iOS/OsuGameIOS.cs   | 6 ++++++
 2 files changed, 13 insertions(+), 1 deletion(-)

diff --git a/osu.Game/OsuGameBase.cs b/osu.Game/OsuGameBase.cs
index 594e7a10c4..97d2e64072 100644
--- a/osu.Game/OsuGameBase.cs
+++ b/osu.Game/OsuGameBase.cs
@@ -89,6 +89,12 @@ namespace osu.Game
             }
         }
 
+        /// <summary>
+        /// The <see cref="Edges"/> that the game should be drawn over at a top level.
+        /// Defaults to <see cref="Edges.None"/>.
+        /// </summary>
+        public virtual Edges SafeAreaOverrideEdges { get; set; }
+
         protected OsuConfigManager LocalConfig { get; private set; }
 
         protected SessionStatics SessionStatics { get; private set; }
@@ -301,7 +307,7 @@ namespace osu.Game
 
             base.Content.Add(new SafeAreaContainer
             {
-                SafeAreaOverrideEdges = Edges.Bottom,
+                SafeAreaOverrideEdges = SafeAreaOverrideEdges,
                 RelativeSizeAxes = Axes.Both,
                 Child = CreateScalingContainer().WithChildren(new Drawable[]
                 {
diff --git a/osu.iOS/OsuGameIOS.cs b/osu.iOS/OsuGameIOS.cs
index 702aef45f5..cf14745be1 100644
--- a/osu.iOS/OsuGameIOS.cs
+++ b/osu.iOS/OsuGameIOS.cs
@@ -3,6 +3,7 @@
 
 using System;
 using Foundation;
+using osu.Framework.Graphics;
 using osu.Game;
 using osu.Game.Updater;
 using osu.Game.Utils;
@@ -18,6 +19,11 @@ namespace osu.iOS
 
         protected override BatteryInfo CreateBatteryInfo() => new IOSBatteryInfo();
 
+        public override Edges SafeAreaOverrideEdges =>
+            // iOS shows a home indicator at the bottom, and adds a safe area to account for this.
+            // Because we have the home indicator (mostly) hidden we don't really care about drawing in this region.
+            Edges.Bottom;
+
         private class IOSBatteryInfo : BatteryInfo
         {
             public override double ChargeLevel => Battery.ChargeLevel;

From dd63b1a3500be04b494623a51806121364720ba2 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 4 Feb 2022 19:03:52 +0900
Subject: [PATCH 2798/5547] Fix broken spectator playback test scene

---
 .../Gameplay/TestSceneSpectatorPlayback.cs    | 221 +++++++-----------
 1 file changed, 85 insertions(+), 136 deletions(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorPlayback.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorPlayback.cs
index 4af254866a..69bf2a7a38 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorPlayback.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorPlayback.cs
@@ -3,12 +3,8 @@
 
 using System;
 using System.Collections.Generic;
-using System.Collections.Specialized;
-using System.Diagnostics;
 using System.Linq;
 using NUnit.Framework;
-using osu.Framework.Allocation;
-using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
@@ -20,7 +16,6 @@ using osu.Framework.Testing;
 using osu.Framework.Timing;
 using osu.Game.Beatmaps;
 using osu.Game.Graphics.Sprites;
-using osu.Game.Online.API;
 using osu.Game.Online.Spectator;
 using osu.Game.Replays;
 using osu.Game.Replays.Legacy;
@@ -32,6 +27,7 @@ using osu.Game.Rulesets.Replays.Types;
 using osu.Game.Rulesets.UI;
 using osu.Game.Scoring;
 using osu.Game.Screens.Play;
+using osu.Game.Tests.Visual.Spectator;
 using osu.Game.Tests.Visual.UserInterface;
 using osuTK;
 using osuTK.Graphics;
@@ -47,138 +43,105 @@ namespace osu.Game.Tests.Visual.Gameplay
 
         private Replay replay;
 
-        private readonly IBindableList<int> users = new BindableList<int>();
-
-        private TestReplayRecorder recorder;
-
         private ManualClock manualClock;
 
         private OsuSpriteText latencyDisplay;
 
         private TestFramedReplayInputHandler replayHandler;
 
-        [Resolved]
-        private IAPIProvider api { get; set; }
-
-        [Resolved]
-        private SpectatorClient spectatorClient { get; set; }
-
-        [Cached]
-        private GameplayState gameplayState = new GameplayState(new Beatmap(), new OsuRuleset(), Array.Empty<Mod>());
-
         [SetUpSteps]
         public void SetUpSteps()
         {
-            AddStep("Reset recorder state", cleanUpState);
-
             AddStep("Setup containers", () =>
             {
                 replay = new Replay();
                 manualClock = new ManualClock();
+                SpectatorClient spectatorClient;
+
+                Child = new DependencyProvidingContainer
+                {
+                    RelativeSizeAxes = Axes.Both,
+                    CachedDependencies = new[]
+                    {
+                        (typeof(SpectatorClient), (object)(spectatorClient = new TestSpectatorClient())),
+                        (typeof(GameplayState), new GameplayState(new Beatmap(), new OsuRuleset(), Array.Empty<Mod>()))
+                    },
+                    Children = new Drawable[]
+                    {
+                        spectatorClient,
+                        new GridContainer
+                        {
+                            RelativeSizeAxes = Axes.Both,
+                            Content = new[]
+                            {
+                                new Drawable[]
+                                {
+                                    recordingManager = new TestRulesetInputManager(TestSceneModSettings.CreateTestRulesetInfo(), 0, SimultaneousBindingMode.Unique)
+                                    {
+                                        Recorder = new TestReplayRecorder
+                                        {
+                                            ScreenSpaceToGamefield = pos => recordingManager.ToLocalSpace(pos),
+                                        },
+                                        Child = new Container
+                                        {
+                                            RelativeSizeAxes = Axes.Both,
+                                            Children = new Drawable[]
+                                            {
+                                                new Box
+                                                {
+                                                    Colour = Color4.Brown,
+                                                    RelativeSizeAxes = Axes.Both,
+                                                },
+                                                new OsuSpriteText
+                                                {
+                                                    Text = "Sending",
+                                                    Scale = new Vector2(3),
+                                                    Anchor = Anchor.Centre,
+                                                    Origin = Anchor.Centre,
+                                                },
+                                                new TestInputConsumer()
+                                            }
+                                        },
+                                    }
+                                },
+                                new Drawable[]
+                                {
+                                    playbackManager = new TestRulesetInputManager(TestSceneModSettings.CreateTestRulesetInfo(), 0, SimultaneousBindingMode.Unique)
+                                    {
+                                        Clock = new FramedClock(manualClock),
+                                        ReplayInputHandler = replayHandler = new TestFramedReplayInputHandler(replay)
+                                        {
+                                            GamefieldToScreenSpace = pos => playbackManager.ToScreenSpace(pos),
+                                        },
+                                        Child = new Container
+                                        {
+                                            RelativeSizeAxes = Axes.Both,
+                                            Children = new Drawable[]
+                                            {
+                                                new Box
+                                                {
+                                                    Colour = Color4.DarkBlue,
+                                                    RelativeSizeAxes = Axes.Both,
+                                                },
+                                                new OsuSpriteText
+                                                {
+                                                    Text = "Receiving",
+                                                    Scale = new Vector2(3),
+                                                    Anchor = Anchor.Centre,
+                                                    Origin = Anchor.Centre,
+                                                },
+                                                new TestInputConsumer()
+                                            }
+                                        },
+                                    }
+                                }
+                            }
+                        },
+                        latencyDisplay = new OsuSpriteText()
+                    }
+                };
 
                 spectatorClient.OnNewFrames += onNewFrames;
-
-                users.BindTo(spectatorClient.PlayingUsers);
-                users.BindCollectionChanged((obj, args) =>
-                {
-                    switch (args.Action)
-                    {
-                        case NotifyCollectionChangedAction.Add:
-                            Debug.Assert(args.NewItems != null);
-
-                            foreach (int user in args.NewItems)
-                            {
-                                if (user == api.LocalUser.Value.Id)
-                                    spectatorClient.WatchUser(user);
-                            }
-
-                            break;
-
-                        case NotifyCollectionChangedAction.Remove:
-                            Debug.Assert(args.OldItems != null);
-
-                            foreach (int user in args.OldItems)
-                            {
-                                if (user == api.LocalUser.Value.Id)
-                                    spectatorClient.StopWatchingUser(user);
-                            }
-
-                            break;
-                    }
-                }, true);
-
-                Children = new Drawable[]
-                {
-                    new GridContainer
-                    {
-                        RelativeSizeAxes = Axes.Both,
-                        Content = new[]
-                        {
-                            new Drawable[]
-                            {
-                                recordingManager = new TestRulesetInputManager(TestSceneModSettings.CreateTestRulesetInfo(), 0, SimultaneousBindingMode.Unique)
-                                {
-                                    Recorder = recorder = new TestReplayRecorder
-                                    {
-                                        ScreenSpaceToGamefield = pos => recordingManager.ToLocalSpace(pos),
-                                    },
-                                    Child = new Container
-                                    {
-                                        RelativeSizeAxes = Axes.Both,
-                                        Children = new Drawable[]
-                                        {
-                                            new Box
-                                            {
-                                                Colour = Color4.Brown,
-                                                RelativeSizeAxes = Axes.Both,
-                                            },
-                                            new OsuSpriteText
-                                            {
-                                                Text = "Sending",
-                                                Scale = new Vector2(3),
-                                                Anchor = Anchor.Centre,
-                                                Origin = Anchor.Centre,
-                                            },
-                                            new TestInputConsumer()
-                                        }
-                                    },
-                                }
-                            },
-                            new Drawable[]
-                            {
-                                playbackManager = new TestRulesetInputManager(TestSceneModSettings.CreateTestRulesetInfo(), 0, SimultaneousBindingMode.Unique)
-                                {
-                                    Clock = new FramedClock(manualClock),
-                                    ReplayInputHandler = replayHandler = new TestFramedReplayInputHandler(replay)
-                                    {
-                                        GamefieldToScreenSpace = pos => playbackManager.ToScreenSpace(pos),
-                                    },
-                                    Child = new Container
-                                    {
-                                        RelativeSizeAxes = Axes.Both,
-                                        Children = new Drawable[]
-                                        {
-                                            new Box
-                                            {
-                                                Colour = Color4.DarkBlue,
-                                                RelativeSizeAxes = Axes.Both,
-                                            },
-                                            new OsuSpriteText
-                                            {
-                                                Text = "Receiving",
-                                                Scale = new Vector2(3),
-                                                Anchor = Anchor.Centre,
-                                                Origin = Anchor.Centre,
-                                            },
-                                            new TestInputConsumer()
-                                        }
-                                    },
-                                }
-                            }
-                        }
-                    },
-                    latencyDisplay = new OsuSpriteText()
-                };
             });
         }
 
@@ -238,20 +201,6 @@ namespace osu.Game.Tests.Visual.Gameplay
             manualClock.CurrentTime = time.Value;
         }
 
-        [TearDownSteps]
-        public void TearDown()
-        {
-            AddStep("stop recorder", cleanUpState);
-        }
-
-        private void cleanUpState()
-        {
-            // Ensure previous recorder is disposed else it may affect the global playing state of `SpectatorClient`.
-            recorder?.RemoveAndDisposeImmediately();
-            recorder = null;
-            spectatorClient.OnNewFrames -= onNewFrames;
-        }
-
         public class TestFramedReplayInputHandler : FramedReplayInputHandler<TestReplayFrame>
         {
             public TestFramedReplayInputHandler(Replay replay)

From fa3d1115fa9535d288e9cc74756b3cc68548ed5b Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 4 Feb 2022 19:17:50 +0900
Subject: [PATCH 2799/5547] Remove online api requirement

---
 osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorPlayback.cs | 2 --
 1 file changed, 2 deletions(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorPlayback.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorPlayback.cs
index 69bf2a7a38..a4d8460846 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorPlayback.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorPlayback.cs
@@ -36,8 +36,6 @@ namespace osu.Game.Tests.Visual.Gameplay
 {
     public class TestSceneSpectatorPlayback : OsuManualInputManagerTestScene
     {
-        protected override bool UseOnlineAPI => true;
-
         private TestRulesetInputManager playbackManager;
         private TestRulesetInputManager recordingManager;
 

From 503025b970b1df6bb4935c13df7c4f9d82e56036 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 4 Feb 2022 19:19:44 +0900
Subject: [PATCH 2800/5547] Fix completely incorrect and dangerous usage of
 bindable binding

---
 osu.Game/Graphics/Containers/ScalingContainer.cs | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Graphics/Containers/ScalingContainer.cs b/osu.Game/Graphics/Containers/ScalingContainer.cs
index aa4e3a7fde..f505a62a33 100644
--- a/osu.Game/Graphics/Containers/ScalingContainer.cs
+++ b/osu.Game/Graphics/Containers/ScalingContainer.cs
@@ -23,6 +23,8 @@ namespace osu.Game.Graphics.Containers
         private Bindable<float> posX;
         private Bindable<float> posY;
 
+        private Bindable<MarginPadding> safeAreaPadding;
+
         private readonly ScalingMode? targetMode;
 
         private Bindable<ScalingMode> scalingMode;
@@ -101,11 +103,8 @@ namespace osu.Game.Graphics.Containers
             }
         }
 
-        [Resolved]
-        private ISafeArea safeArea { get; set; }
-
         [BackgroundDependencyLoader]
-        private void load(OsuConfigManager config)
+        private void load(OsuConfigManager config, ISafeArea safeArea)
         {
             scalingMode = config.GetBindable<ScalingMode>(OsuSetting.Scaling);
             scalingMode.ValueChanged += _ => updateSize();
@@ -122,7 +121,8 @@ namespace osu.Game.Graphics.Containers
             posY = config.GetBindable<float>(OsuSetting.ScalingPositionY);
             posY.ValueChanged += _ => updateSize();
 
-            safeArea.SafeAreaPadding.BindValueChanged(_ => updateSize());
+            safeAreaPadding = safeArea.SafeAreaPadding.GetBoundCopy();
+            safeAreaPadding.BindValueChanged(_ => updateSize());
         }
 
         protected override void LoadComplete()
@@ -169,7 +169,7 @@ namespace osu.Game.Graphics.Containers
             bool requiresMasking = (scaling && targetSize != Vector2.One)
                                    // For the top level scaling container, for now we apply masking if safe areas are in use.
                                    // In the future this can likely be removed as more of the actual UI supports overflowing into the safe areas.
-                                   || (targetMode == ScalingMode.Everything && safeArea.SafeAreaPadding.Value.Total != Vector2.Zero);
+                                   || (targetMode == ScalingMode.Everything && safeAreaPadding.Value.Total != Vector2.Zero);
 
             if (requiresMasking)
                 sizableContainer.Masking = true;

From 0f48c0131ca99a6b9f3283ebbd037cd991e181b6 Mon Sep 17 00:00:00 2001
From: Jamie Taylor <me@nekodex.net>
Date: Fri, 4 Feb 2022 15:42:52 +0900
Subject: [PATCH 2801/5547] Layer playback of beatmap-changed and
 random-beatmap samples

---
 osu.Game/Screens/Select/BeatmapCarousel.cs |  4 ++++
 osu.Game/Screens/Select/SongSelect.cs      | 21 +++------------------
 2 files changed, 7 insertions(+), 18 deletions(-)

diff --git a/osu.Game/Screens/Select/BeatmapCarousel.cs b/osu.Game/Screens/Select/BeatmapCarousel.cs
index f17daa8697..3d5ed70dda 100644
--- a/osu.Game/Screens/Select/BeatmapCarousel.cs
+++ b/osu.Game/Screens/Select/BeatmapCarousel.cs
@@ -154,6 +154,7 @@ namespace osu.Game.Screens.Select
         private readonly DrawablePool<DrawableCarouselBeatmapSet> setPool = new DrawablePool<DrawableCarouselBeatmapSet>(100);
 
         private Sample spinSample;
+        private Sample randomSelectSample;
 
         private int visibleSetsCount;
 
@@ -178,6 +179,7 @@ namespace osu.Game.Screens.Select
         private void load(OsuConfigManager config, AudioManager audio)
         {
             spinSample = audio.Samples.Get("SongSelect/random-spin");
+            randomSelectSample = audio.Samples.Get(@"SongSelect/select-random");
 
             config.BindWith(OsuSetting.RandomSelectAlgorithm, RandomAlgorithm);
             config.BindWith(OsuSetting.SongSelectRightMouseScroll, RightClickScrollingEnabled);
@@ -495,6 +497,8 @@ namespace osu.Game.Screens.Select
             var chan = spinSample.GetChannel();
             chan.Frequency.Value = 1f + Math.Min(1f, distance / visibleSetsCount);
             chan.Play();
+
+            randomSelectSample?.Play();
         }
 
         private void select(CarouselItem item)
diff --git a/osu.Game/Screens/Select/SongSelect.cs b/osu.Game/Screens/Select/SongSelect.cs
index ee807762bf..f5b11448f8 100644
--- a/osu.Game/Screens/Select/SongSelect.cs
+++ b/osu.Game/Screens/Select/SongSelect.cs
@@ -100,7 +100,6 @@ namespace osu.Game.Screens.Select
 
         private Sample sampleChangeDifficulty;
         private Sample sampleChangeBeatmap;
-        private Sample sampleRandomBeatmap;
 
         private Container carouselContainer;
 
@@ -110,8 +109,6 @@ namespace osu.Game.Screens.Select
 
         private double audioFeedbackLastPlaybackTime;
 
-        private bool randomSelectionPending;
-
         [Resolved]
         private MusicController music { get; set; }
 
@@ -291,7 +288,6 @@ namespace osu.Game.Screens.Select
 
             sampleChangeDifficulty = audio.Samples.Get(@"SongSelect/select-difficulty");
             sampleChangeBeatmap = audio.Samples.Get(@"SongSelect/select-expand");
-            sampleRandomBeatmap = audio.Samples.Get(@"SongSelect/select-random");
             SampleConfirm = audio.Samples.Get(@"SongSelect/confirm-selection");
 
             if (dialogOverlay != null)
@@ -319,16 +315,8 @@ namespace osu.Game.Screens.Select
             (new FooterButtonMods { Current = Mods }, ModSelect),
             (new FooterButtonRandom
             {
-                NextRandom = () =>
-                {
-                    randomSelectionPending = true;
-                    Carousel.SelectNextRandom();
-                },
-                PreviousRandom = () =>
-                {
-                    randomSelectionPending = true;
-                    Carousel.SelectPreviousRandom();
-                }
+                NextRandom = () => Carousel.SelectNextRandom(),
+                PreviousRandom = Carousel.SelectPreviousRandom
             }, null),
             (new FooterButtonOptions(), BeatmapOptions)
         };
@@ -498,9 +486,7 @@ namespace osu.Game.Screens.Select
             {
                 if (beatmap != null && beatmapInfoPrevious != null && Time.Current - audioFeedbackLastPlaybackTime >= 50)
                 {
-                    if (randomSelectionPending)
-                        sampleRandomBeatmap.Play();
-                    else if (beatmap.BeatmapSet?.ID == beatmapInfoPrevious.BeatmapSet?.ID)
+                    if (beatmap.BeatmapSet?.ID == beatmapInfoPrevious.BeatmapSet?.ID)
                         sampleChangeDifficulty.Play();
                     else
                         sampleChangeBeatmap.Play();
@@ -508,7 +494,6 @@ namespace osu.Game.Screens.Select
                     audioFeedbackLastPlaybackTime = Time.Current;
                 }
 
-                randomSelectionPending = false;
                 beatmapInfoPrevious = beatmap;
             }
 

From e2262bf3b25f14f625e76bec34118203299c31d0 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 4 Feb 2022 20:33:15 +0900
Subject: [PATCH 2802/5547] Schedule all calls to `updateSize` for safety

---
 osu.Game/Graphics/Containers/ScalingContainer.cs | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Graphics/Containers/ScalingContainer.cs b/osu.Game/Graphics/Containers/ScalingContainer.cs
index f505a62a33..b3423345b1 100644
--- a/osu.Game/Graphics/Containers/ScalingContainer.cs
+++ b/osu.Game/Graphics/Containers/ScalingContainer.cs
@@ -52,7 +52,7 @@ namespace osu.Game.Graphics.Containers
                     return;
 
                 allowScaling = value;
-                if (IsLoaded) updateSize();
+                if (IsLoaded) Scheduler.AddOnce(updateSize);
             }
         }
 
@@ -107,29 +107,29 @@ namespace osu.Game.Graphics.Containers
         private void load(OsuConfigManager config, ISafeArea safeArea)
         {
             scalingMode = config.GetBindable<ScalingMode>(OsuSetting.Scaling);
-            scalingMode.ValueChanged += _ => updateSize();
+            scalingMode.ValueChanged += _ => Scheduler.AddOnce(updateSize);
 
             sizeX = config.GetBindable<float>(OsuSetting.ScalingSizeX);
-            sizeX.ValueChanged += _ => updateSize();
+            sizeX.ValueChanged += _ => Scheduler.AddOnce(updateSize);
 
             sizeY = config.GetBindable<float>(OsuSetting.ScalingSizeY);
-            sizeY.ValueChanged += _ => updateSize();
+            sizeY.ValueChanged += _ => Scheduler.AddOnce(updateSize);
 
             posX = config.GetBindable<float>(OsuSetting.ScalingPositionX);
-            posX.ValueChanged += _ => updateSize();
+            posX.ValueChanged += _ => Scheduler.AddOnce(updateSize);
 
             posY = config.GetBindable<float>(OsuSetting.ScalingPositionY);
-            posY.ValueChanged += _ => updateSize();
+            posY.ValueChanged += _ => Scheduler.AddOnce(updateSize);
 
             safeAreaPadding = safeArea.SafeAreaPadding.GetBoundCopy();
-            safeAreaPadding.BindValueChanged(_ => updateSize());
+            safeAreaPadding.BindValueChanged(_ => Scheduler.AddOnce(updateSize));
         }
 
         protected override void LoadComplete()
         {
             base.LoadComplete();
 
-            updateSize();
+            Scheduler.AddOnce(updateSize);
             sizableContainer.FinishTransforms();
         }
 

From b5dde6f1ad22d1c80502d307dee061556e3e404f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 4 Feb 2022 21:38:52 +0900
Subject: [PATCH 2803/5547] Update resources

---
 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 04c543750e..71525a7acb 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -51,7 +51,7 @@
     <Reference Include="Java.Interop" />
   </ItemGroup>
   <ItemGroup>
-    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.202.0" />
+    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.204.0" />
     <PackageReference Include="ppy.osu.Framework.Android" Version="2022.204.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 83c3593edb..c8f634284b 100644
--- a/osu.Game/osu.Game.csproj
+++ b/osu.Game/osu.Game.csproj
@@ -37,7 +37,7 @@
     </PackageReference>
     <PackageReference Include="Realm" Version="10.8.0" />
     <PackageReference Include="ppy.osu.Framework" Version="2022.204.0" />
-    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.202.0" />
+    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.204.0" />
     <PackageReference Include="Sentry" Version="3.13.0" />
     <PackageReference Include="SharpCompress" Version="0.30.1" />
     <PackageReference Include="NUnit" Version="3.13.2" />
diff --git a/osu.iOS.props b/osu.iOS.props
index b0c056ea21..5978f6d685 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -61,7 +61,7 @@
   </ItemGroup>
   <ItemGroup Label="Package References">
     <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.204.0" />
-    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.202.0" />
+    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.204.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net5.0 / net6.0) -->
   <PropertyGroup>

From 5e47ce333ce42831d8b4d48fdd4aa4437956587a Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 4 Feb 2022 16:10:49 +0300
Subject: [PATCH 2804/5547] Change `SafeAreaOverrideEdges` to be get-only and
 protected

---
 osu.Game/OsuGameBase.cs | 2 +-
 osu.iOS/OsuGameIOS.cs   | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/OsuGameBase.cs b/osu.Game/OsuGameBase.cs
index 97d2e64072..5b2eb5607a 100644
--- a/osu.Game/OsuGameBase.cs
+++ b/osu.Game/OsuGameBase.cs
@@ -93,7 +93,7 @@ namespace osu.Game
         /// The <see cref="Edges"/> that the game should be drawn over at a top level.
         /// Defaults to <see cref="Edges.None"/>.
         /// </summary>
-        public virtual Edges SafeAreaOverrideEdges { get; set; }
+        protected virtual Edges SafeAreaOverrideEdges => Edges.None;
 
         protected OsuConfigManager LocalConfig { get; private set; }
 
diff --git a/osu.iOS/OsuGameIOS.cs b/osu.iOS/OsuGameIOS.cs
index cf14745be1..9c1795e45e 100644
--- a/osu.iOS/OsuGameIOS.cs
+++ b/osu.iOS/OsuGameIOS.cs
@@ -19,7 +19,7 @@ namespace osu.iOS
 
         protected override BatteryInfo CreateBatteryInfo() => new IOSBatteryInfo();
 
-        public override Edges SafeAreaOverrideEdges =>
+        protected override Edges SafeAreaOverrideEdges =>
             // iOS shows a home indicator at the bottom, and adds a safe area to account for this.
             // Because we have the home indicator (mostly) hidden we don't really care about drawing in this region.
             Edges.Bottom;

From d62885f30b64cd2cfbac451591b952ff9663a5a9 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 4 Feb 2022 22:31:41 +0900
Subject: [PATCH 2805/5547] Don't schedule call to `updateSize` in
 `LoadComplete` to ensure following `FinishTransforms` runs as expected

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

diff --git a/osu.Game/Graphics/Containers/ScalingContainer.cs b/osu.Game/Graphics/Containers/ScalingContainer.cs
index b3423345b1..0d543bdbc8 100644
--- a/osu.Game/Graphics/Containers/ScalingContainer.cs
+++ b/osu.Game/Graphics/Containers/ScalingContainer.cs
@@ -129,7 +129,7 @@ namespace osu.Game.Graphics.Containers
         {
             base.LoadComplete();
 
-            Scheduler.AddOnce(updateSize);
+            updateSize();
             sizableContainer.FinishTransforms();
         }
 

From 750f90e7288b04f0abe4b7c4abb4805d52d5fda8 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 4 Feb 2022 22:38:40 +0900
Subject: [PATCH 2806/5547] Simplify TestSpectatorClient implementation

---
 .../Tests/Visual/Spectator/TestSpectatorClient.cs   | 13 +++++--------
 1 file changed, 5 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Tests/Visual/Spectator/TestSpectatorClient.cs b/osu.Game/Tests/Visual/Spectator/TestSpectatorClient.cs
index 1a1d493249..453c086604 100644
--- a/osu.Game/Tests/Visual/Spectator/TestSpectatorClient.cs
+++ b/osu.Game/Tests/Visual/Spectator/TestSpectatorClient.cs
@@ -6,7 +6,6 @@
 using System;
 using System.Collections.Generic;
 using System.Diagnostics;
-using System.Linq;
 using System.Threading.Tasks;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
@@ -40,11 +39,7 @@ namespace osu.Game.Tests.Visual.Spectator
 
         public TestSpectatorClient()
         {
-            OnNewFrames += (i, bundle) =>
-            {
-                if (PlayingUsers.Contains(i))
-                    lastReceivedUserFrames[i] = bundle.Frames[^1];
-            };
+            OnNewFrames += (i, bundle) => lastReceivedUserFrames[i] = bundle.Frames[^1];
         }
 
         /// <summary>
@@ -65,7 +60,7 @@ namespace osu.Game.Tests.Visual.Spectator
         /// <param name="userId">The user to end play for.</param>
         public void EndPlay(int userId)
         {
-            if (!PlayingUsers.Contains(userId))
+            if (!userBeatmapDictionary.ContainsKey(userId))
                 return;
 
             ((ISpectatorClient)this).UserFinishedPlaying(userId, new SpectatorState
@@ -73,6 +68,8 @@ namespace osu.Game.Tests.Visual.Spectator
                 BeatmapID = userBeatmapDictionary[userId],
                 RulesetID = 0,
             });
+
+            userBeatmapDictionary.Remove(userId);
         }
 
         public new void Schedule(Action action) => base.Schedule(action);
@@ -131,7 +128,7 @@ namespace osu.Game.Tests.Visual.Spectator
         protected override Task WatchUserInternal(int userId)
         {
             // When newly watching a user, the server sends the playing state immediately.
-            if (PlayingUsers.Contains(userId))
+            if (userBeatmapDictionary.ContainsKey(userId))
                 sendPlayingState(userId);
 
             return Task.CompletedTask;

From eb25730b614ececc5f6672e298dc5e786984c92e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 5 Feb 2022 16:12:58 +0900
Subject: [PATCH 2807/5547] Revert "Merge pull request #16716 from
 peppy/carousel-less-invalidations"

This reverts commit 8d13e0514b27ce5e6f587ba8918c165d3e1ddbbf, reversing
changes made to 95582a9023488da37edb3b9236f6b4aeb197ccb9.
---
 osu.Game/Screens/Select/BeatmapCarousel.cs    |  6 +-
 .../Screens/Select/Carousel/CarouselHeader.cs | 29 ++++----
 .../Carousel/DrawableCarouselBeatmap.cs       | 10 ++-
 .../Carousel/DrawableCarouselBeatmapSet.cs    |  6 +-
 .../Select/Carousel/DrawableCarouselItem.cs   | 71 +++++++------------
 5 files changed, 54 insertions(+), 68 deletions(-)

diff --git a/osu.Game/Screens/Select/BeatmapCarousel.cs b/osu.Game/Screens/Select/BeatmapCarousel.cs
index 3d5ed70dda..c3d340ac61 100644
--- a/osu.Game/Screens/Select/BeatmapCarousel.cs
+++ b/osu.Game/Screens/Select/BeatmapCarousel.cs
@@ -925,8 +925,10 @@ namespace osu.Game.Screens.Select
             // child items (difficulties) are still visible.
             item.Header.X = offsetX(dist, visibleHalfHeight) - (parent?.X ?? 0);
 
-            // We are applying alpha to the header here such that we can layer alpha transformations on top.
-            item.Header.Alpha = Math.Clamp(1.75f - 1.5f * dist, 0, 1);
+            // We are applying a multiplicative alpha (which is internally done by nesting an
+            // additional container and setting that container's alpha) such that we can
+            // layer alpha transformations on top.
+            item.SetMultiplicativeAlpha(Math.Clamp(1.75f - 1.5f * dist, 0, 1));
         }
 
         private enum PendingScrollOperation
diff --git a/osu.Game/Screens/Select/Carousel/CarouselHeader.cs b/osu.Game/Screens/Select/Carousel/CarouselHeader.cs
index 533694b265..ed3aea3445 100644
--- a/osu.Game/Screens/Select/Carousel/CarouselHeader.cs
+++ b/osu.Game/Screens/Select/Carousel/CarouselHeader.cs
@@ -21,6 +21,8 @@ namespace osu.Game.Screens.Select.Carousel
 {
     public class CarouselHeader : Container
     {
+        public Container BorderContainer;
+
         public readonly Bindable<CarouselItemState> State = new Bindable<CarouselItemState>(CarouselItemState.NotSelected);
 
         private readonly HoverLayer hoverLayer;
@@ -35,14 +37,17 @@ namespace osu.Game.Screens.Select.Carousel
             RelativeSizeAxes = Axes.X;
             Height = DrawableCarouselItem.MAX_HEIGHT;
 
-            Masking = true;
-            CornerRadius = corner_radius;
-            BorderColour = new Color4(221, 255, 255, 255);
-
-            InternalChildren = new Drawable[]
+            InternalChild = BorderContainer = new Container
             {
-                Content,
-                hoverLayer = new HoverLayer()
+                RelativeSizeAxes = Axes.Both,
+                Masking = true,
+                CornerRadius = corner_radius,
+                BorderColour = new Color4(221, 255, 255, 255),
+                Children = new Drawable[]
+                {
+                    Content,
+                    hoverLayer = new HoverLayer()
+                }
             };
         }
 
@@ -61,21 +66,21 @@ namespace osu.Game.Screens.Select.Carousel
                 case CarouselItemState.NotSelected:
                     hoverLayer.InsetForBorder = false;
 
-                    BorderThickness = 0;
-                    EdgeEffect = new EdgeEffectParameters
+                    BorderContainer.BorderThickness = 0;
+                    BorderContainer.EdgeEffect = new EdgeEffectParameters
                     {
                         Type = EdgeEffectType.Shadow,
                         Offset = new Vector2(1),
                         Radius = 10,
-                        Colour = Color4.Black.Opacity(0.5f),
+                        Colour = Color4.Black.Opacity(100),
                     };
                     break;
 
                 case CarouselItemState.Selected:
                     hoverLayer.InsetForBorder = true;
 
-                    BorderThickness = border_thickness;
-                    EdgeEffect = new EdgeEffectParameters
+                    BorderContainer.BorderThickness = border_thickness;
+                    BorderContainer.EdgeEffect = new EdgeEffectParameters
                     {
                         Type = EdgeEffectType.Glow,
                         Colour = new Color4(130, 204, 255, 150),
diff --git a/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmap.cs b/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmap.cs
index a3483aa60a..3576b77ae8 100644
--- a/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmap.cs
+++ b/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmap.cs
@@ -36,9 +36,9 @@ namespace osu.Game.Screens.Select.Carousel
         /// <summary>
         /// The height of a carousel beatmap, including vertical spacing.
         /// </summary>
-        public const float HEIGHT = header_height + CAROUSEL_BEATMAP_SPACING;
+        public const float HEIGHT = height + CAROUSEL_BEATMAP_SPACING;
 
-        private const float header_height = MAX_HEIGHT * 0.6f;
+        private const float height = MAX_HEIGHT * 0.6f;
 
         private readonly BeatmapInfo beatmapInfo;
 
@@ -67,18 +67,16 @@ namespace osu.Game.Screens.Select.Carousel
         private CancellationTokenSource starDifficultyCancellationSource;
 
         public DrawableCarouselBeatmap(CarouselBeatmap panel)
-            : base(header_height)
         {
             beatmapInfo = panel.BeatmapInfo;
             Item = panel;
-
-            // Difficulty panels should start hidden for a better initial effect.
-            Hide();
         }
 
         [BackgroundDependencyLoader(true)]
         private void load(BeatmapManager manager, SongSelect songSelect)
         {
+            Header.Height = height;
+
             if (songSelect != null)
             {
                 startRequested = b => songSelect.FinaliseSelection(b);
diff --git a/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmapSet.cs b/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmapSet.cs
index 63c004f4bc..618c5cf5ec 100644
--- a/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmapSet.cs
+++ b/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmapSet.cs
@@ -122,10 +122,12 @@ namespace osu.Game.Screens.Select.Carousel
                 },
             };
 
-            background.DelayedLoadComplete += d => d.FadeInFromZero(750, Easing.OutQuint);
-            mainFlow.DelayedLoadComplete += d => d.FadeInFromZero(500, Easing.OutQuint);
+            background.DelayedLoadComplete += fadeContentIn;
+            mainFlow.DelayedLoadComplete += fadeContentIn;
         }
 
+        private void fadeContentIn(Drawable d) => d.FadeInFromZero(750, Easing.OutQuint);
+
         protected override void Deselected()
         {
             base.Deselected();
diff --git a/osu.Game/Screens/Select/Carousel/DrawableCarouselItem.cs b/osu.Game/Screens/Select/Carousel/DrawableCarouselItem.cs
index 5e7ca0825a..cde3edad39 100644
--- a/osu.Game/Screens/Select/Carousel/DrawableCarouselItem.cs
+++ b/osu.Game/Screens/Select/Carousel/DrawableCarouselItem.cs
@@ -60,10 +60,12 @@ namespace osu.Game.Screens.Select.Carousel
             }
         }
 
-        protected DrawableCarouselItem(float headerHeight = MAX_HEIGHT)
+        protected DrawableCarouselItem()
         {
             RelativeSizeAxes = Axes.X;
 
+            Alpha = 0;
+
             InternalChildren = new Drawable[]
             {
                 MovementContainer = new Container
@@ -71,20 +73,18 @@ namespace osu.Game.Screens.Select.Carousel
                     RelativeSizeAxes = Axes.Both,
                     Children = new Drawable[]
                     {
-                        Header = new CarouselHeader
-                        {
-                            Height = headerHeight,
-                        },
+                        Header = new CarouselHeader(),
                         Content = new Container
                         {
                             RelativeSizeAxes = Axes.Both,
-                            Y = headerHeight,
                         }
                     }
                 },
             };
         }
 
+        public void SetMultiplicativeAlpha(float alpha) => Header.BorderContainer.Alpha = alpha;
+
         protected override void LoadComplete()
         {
             base.LoadComplete();
@@ -92,6 +92,12 @@ namespace osu.Game.Screens.Select.Carousel
             UpdateItem();
         }
 
+        protected override void Update()
+        {
+            base.Update();
+            Content.Y = Header.Height;
+        }
+
         protected virtual void UpdateItem()
         {
             if (item == null)
@@ -115,56 +121,29 @@ namespace osu.Game.Screens.Select.Carousel
 
         private void onStateChange(ValueChangedEvent<bool> _) => Scheduler.AddOnce(ApplyState);
 
-        private CarouselItemState? lastAppliedState;
-
         protected virtual void ApplyState()
         {
+            // Use the fact that we know the precise height of the item from the model to avoid the need for AutoSize overhead.
+            // Additionally, AutoSize doesn't work well due to content starting off-screen and being masked away.
+            Height = Item.TotalHeight;
+
             Debug.Assert(Item != null);
 
-            if (lastAppliedState != Item.State.Value)
+            switch (Item.State.Value)
             {
-                lastAppliedState = Item.State.Value;
+                case CarouselItemState.NotSelected:
+                    Deselected();
+                    break;
 
-                // Use the fact that we know the precise height of the item from the model to avoid the need for AutoSize overhead.
-                // Additionally, AutoSize doesn't work well due to content starting off-screen and being masked away.
-                Height = Item.TotalHeight;
-
-                switch (lastAppliedState)
-                {
-                    case CarouselItemState.NotSelected:
-                        Deselected();
-                        break;
-
-                    case CarouselItemState.Selected:
-                        Selected();
-                        break;
-                }
+                case CarouselItemState.Selected:
+                    Selected();
+                    break;
             }
 
             if (!Item.Visible)
-                Hide();
+                this.FadeOut(300, Easing.OutQuint);
             else
-                Show();
-        }
-
-        private bool isVisible = true;
-
-        public override void Show()
-        {
-            if (isVisible)
-                return;
-
-            isVisible = true;
-            this.FadeIn(250);
-        }
-
-        public override void Hide()
-        {
-            if (!isVisible)
-                return;
-
-            isVisible = false;
-            this.FadeOut(300, Easing.OutQuint);
+                this.FadeIn(250);
         }
 
         protected virtual void Selected()

From 2e1a9f137994a3085a592d216c075054126ceb38 Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Sat, 5 Feb 2022 21:13:16 +0800
Subject: [PATCH 2808/5547] Add performance breakdown as statistic item in
 extended statistics panel

---
 osu.Game.Rulesets.Osu/OsuRuleset.cs           |  11 +
 .../Statistics/PerformanceBreakdownChart.cs   | 244 ++++++++++++++++++
 2 files changed, 255 insertions(+)
 create mode 100644 osu.Game/Screens/Ranking/Statistics/PerformanceBreakdownChart.cs

diff --git a/osu.Game.Rulesets.Osu/OsuRuleset.cs b/osu.Game.Rulesets.Osu/OsuRuleset.cs
index 428e7b9df5..769e83ec00 100644
--- a/osu.Game.Rulesets.Osu/OsuRuleset.cs
+++ b/osu.Game.Rulesets.Osu/OsuRuleset.cs
@@ -298,6 +298,17 @@ namespace osu.Game.Rulesets.Osu
                     }
                 },
                 new StatisticRow
+                {
+                    Columns = new[]
+                    {
+                        new StatisticItem("Performance Breakdown", () => new PerformanceBreakdownChart(score)
+                        {
+                            RelativeSizeAxes = Axes.X,
+                            AutoSizeAxes = Axes.Y
+                        }),
+                    }
+                },
+                new StatisticRow
                 {
                     Columns = new[]
                     {
diff --git a/osu.Game/Screens/Ranking/Statistics/PerformanceBreakdownChart.cs b/osu.Game/Screens/Ranking/Statistics/PerformanceBreakdownChart.cs
new file mode 100644
index 0000000000..b58974eb96
--- /dev/null
+++ b/osu.Game/Screens/Ranking/Statistics/PerformanceBreakdownChart.cs
@@ -0,0 +1,244 @@
+// 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 JetBrains.Annotations;
+using osu.Framework.Allocation;
+using osu.Framework.Extensions;
+using osu.Framework.Extensions.Color4Extensions;
+using osu.Framework.Extensions.LocalisationExtensions;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
+using osu.Game.Beatmaps;
+using osu.Game.Graphics;
+using osu.Game.Graphics.Sprites;
+using osu.Game.Graphics.UserInterface;
+using osu.Game.Rulesets.Difficulty;
+using osu.Game.Scoring;
+using osuTK;
+using osuTK.Graphics;
+
+namespace osu.Game.Screens.Ranking.Statistics
+{
+    public class PerformanceBreakdownChart : Container
+    {
+        private readonly ScoreInfo score;
+
+        private Drawable spinner;
+        private Drawable content;
+        private GridContainer chart;
+        private OsuSpriteText achievedPerformance;
+        private OsuSpriteText maximumPerformance;
+
+        private readonly CancellationTokenSource cancellationTokenSource = new CancellationTokenSource();
+
+        [Resolved]
+        private ScorePerformanceCache performanceCache { get; set; }
+
+        [Resolved]
+        private BeatmapDifficultyCache difficultyCache { get; set; }
+
+        [Resolved]
+        private BeatmapManager beatmapManager { get; set; }
+
+        public PerformanceBreakdownChart(ScoreInfo score)
+        {
+            this.score = score;
+        }
+
+        [BackgroundDependencyLoader]
+        private void load()
+        {
+            Children = new[]
+            {
+                spinner = new LoadingSpinner(true)
+                {
+                    Origin = Anchor.Centre,
+                    Anchor = Anchor.Centre
+                },
+                content = new FillFlowContainer
+                {
+                    Alpha = 0,
+                    RelativeSizeAxes = Axes.X,
+                    AutoSizeAxes = Axes.Y,
+                    Width = 0.6f,
+                    Origin = Anchor.TopCentre,
+                    Anchor = Anchor.TopCentre,
+                    Spacing = new Vector2(15, 15),
+                    Children = new Drawable[]
+                    {
+                        new GridContainer
+                        {
+                            RelativeSizeAxes = Axes.X,
+                            Width = 0.8f,
+                            AutoSizeAxes = Axes.Y,
+                            Origin = Anchor.TopCentre,
+                            Anchor = Anchor.TopCentre,
+                            ColumnDimensions = new[]
+                            {
+                                new Dimension(),
+                                new Dimension(GridSizeMode.AutoSize)
+                            },
+                            RowDimensions = new[]
+                            {
+                                new Dimension(GridSizeMode.AutoSize),
+                                new Dimension(GridSizeMode.AutoSize)
+                            },
+                            Content = new[]
+                            {
+                                new Drawable[]
+                                {
+                                    new OsuSpriteText
+                                    {
+                                        Origin = Anchor.CentreLeft,
+                                        Anchor = Anchor.CentreLeft,
+                                        Font = OsuFont.GetFont(weight: FontWeight.Regular, size: 18),
+                                        Text = "Achieved PP",
+                                        Colour = Color4Extensions.FromHex("#66FFCC")
+                                    },
+                                    achievedPerformance = new OsuSpriteText
+                                    {
+                                        Origin = Anchor.CentreRight,
+                                        Anchor = Anchor.CentreRight,
+                                        Font = OsuFont.GetFont(weight: FontWeight.SemiBold, size: 18),
+                                        Colour = Color4Extensions.FromHex("#66FFCC")
+                                    }
+                                },
+                                new Drawable[]
+                                {
+                                    new OsuSpriteText
+                                    {
+                                        Origin = Anchor.CentreLeft,
+                                        Anchor = Anchor.CentreLeft,
+                                        Font = OsuFont.GetFont(weight: FontWeight.Regular, size: 18),
+                                        Text = "Maximum",
+                                        Colour = OsuColour.Gray(0.7f)
+                                    },
+                                    maximumPerformance = new OsuSpriteText
+                                    {
+                                        Origin = Anchor.CentreLeft,
+                                        Anchor = Anchor.CentreLeft,
+                                        Font = OsuFont.GetFont(weight: FontWeight.Regular, size: 18),
+                                        Colour = OsuColour.Gray(0.7f)
+                                    }
+                                }
+                            }
+                        },
+                        chart = new GridContainer
+                        {
+                            RelativeSizeAxes = Axes.X,
+                            AutoSizeAxes = Axes.Y,
+                            Origin = Anchor.TopCentre,
+                            Anchor = Anchor.TopCentre,
+                            ColumnDimensions = new[]
+                            {
+                                new Dimension(GridSizeMode.AutoSize),
+                                new Dimension(),
+                                new Dimension(GridSizeMode.AutoSize)
+                            }
+                        }
+                    }
+                }
+            };
+
+            spinner.Show();
+
+            new PerformanceBreakdownCalculator(beatmapManager, difficultyCache, performanceCache)
+                .CalculateAsync(score, cancellationTokenSource.Token)
+                .ContinueWith(t => Schedule(() => setPerformanceValue(t.GetResultSafely())));
+        }
+
+        private void setPerformanceValue(PerformanceBreakdown breakdown)
+        {
+            spinner.Hide();
+            content.FadeIn(200);
+
+            var displayAttributes = breakdown.Performance.GetAttributesForDisplay();
+            var perfectDisplayAttributes = breakdown.PerfectPerformance.GetAttributesForDisplay();
+
+            setTotalValues(
+                displayAttributes.First(a => a.PropertyName == nameof(PerformanceAttributes.Total)),
+                perfectDisplayAttributes.First(a => a.PropertyName == nameof(PerformanceAttributes.Total))
+            );
+
+            var rowDimensions = new List<Dimension>();
+            var rows = new List<Drawable[]>();
+
+            foreach (PerformanceDisplayAttribute attr in displayAttributes)
+            {
+                if (attr.PropertyName == nameof(PerformanceAttributes.Total)) continue;
+
+                var row = createAttributeRow(attr, perfectDisplayAttributes.First(a => a.PropertyName == attr.PropertyName));
+
+                if (row != null)
+                {
+                    rows.Add(row);
+                    rowDimensions.Add(new Dimension(GridSizeMode.AutoSize));
+                }
+            }
+
+            chart.RowDimensions = rowDimensions.ToArray();
+            chart.Content = rows.ToArray();
+        }
+
+        private void setTotalValues(PerformanceDisplayAttribute attribute, PerformanceDisplayAttribute perfectAttribute)
+        {
+            achievedPerformance.Text = Math.Round(attribute.Value, MidpointRounding.AwayFromZero).ToLocalisableString();
+            maximumPerformance.Text = Math.Round(perfectAttribute.Value, MidpointRounding.AwayFromZero).ToLocalisableString();
+        }
+
+        [CanBeNull]
+        private Drawable[] createAttributeRow(PerformanceDisplayAttribute attribute, PerformanceDisplayAttribute perfectAttribute)
+        {
+            float percentage = (float)(attribute.Value / perfectAttribute.Value);
+            if (float.IsNaN(percentage))
+                return null;
+
+            return new Drawable[]
+            {
+                new OsuSpriteText
+                {
+                    Origin = Anchor.CentreLeft,
+                    Anchor = Anchor.CentreLeft,
+                    Font = OsuFont.GetFont(weight: FontWeight.Regular),
+                    Text = attribute.DisplayName,
+                    Colour = Colour4.White
+                },
+                new Container
+                {
+                    RelativeSizeAxes = Axes.Both,
+                    Padding = new MarginPadding { Left = 10, Right = 10 },
+                    Child = new Bar
+                    {
+                        RelativeSizeAxes = Axes.X,
+                        Origin = Anchor.Centre,
+                        Anchor = Anchor.Centre,
+                        CornerRadius = 2.5f,
+                        Masking = true,
+                        Height = 5,
+                        BackgroundColour = Color4.White.Opacity(0.5f),
+                        AccentColour = Color4Extensions.FromHex("#66FFCC"),
+                        Length = percentage
+                    }
+                },
+                new OsuSpriteText
+                {
+                    Origin = Anchor.CentreRight,
+                    Anchor = Anchor.CentreRight,
+                    Font = OsuFont.GetFont(weight: FontWeight.SemiBold),
+                    Text = percentage.ToLocalisableString("0%"),
+                    Colour = Colour4.White
+                }
+            };
+        }
+
+        protected override void Dispose(bool isDisposing)
+        {
+            cancellationTokenSource?.Cancel();
+            base.Dispose(isDisposing);
+        }
+    }
+}

From c35ef917a171564750d54c3bee09d24339d27ee2 Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Sat, 5 Feb 2022 21:18:23 +0800
Subject: [PATCH 2809/5547] Remove tooltip from performance statistic

---
 .../Statistics/PerformanceStatistic.cs        |  43 ++--
 .../Statistics/PerformanceStatisticTooltip.cs | 212 ------------------
 2 files changed, 14 insertions(+), 241 deletions(-)
 delete mode 100644 osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatisticTooltip.cs

diff --git a/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatistic.cs b/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatistic.cs
index 158fd82b29..859b42d66d 100644
--- a/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatistic.cs
+++ b/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatistic.cs
@@ -2,21 +2,17 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
-using System.Linq;
 using System.Threading;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Extensions;
 using osu.Framework.Graphics;
-using osu.Framework.Graphics.Cursor;
-using osu.Game.Beatmaps;
 using osu.Game.Graphics.UserInterface;
-using osu.Game.Rulesets.Difficulty;
 using osu.Game.Scoring;
 
 namespace osu.Game.Screens.Ranking.Expanded.Statistics
 {
-    public class PerformanceStatistic : StatisticDisplay, IHasCustomTooltip<PerformanceBreakdown>
+    public class PerformanceStatistic : StatisticDisplay
     {
         private readonly ScoreInfo score;
 
@@ -26,15 +22,6 @@ namespace osu.Game.Screens.Ranking.Expanded.Statistics
 
         private RollingCounter<int> counter;
 
-        [Resolved]
-        private ScorePerformanceCache performanceCache { get; set; }
-
-        [Resolved]
-        private BeatmapDifficultyCache difficultyCache { get; set; }
-
-        [Resolved]
-        private BeatmapManager beatmapManager { get; set; }
-
         public PerformanceStatistic(ScoreInfo score)
             : base("PP")
         {
@@ -42,21 +29,23 @@ namespace osu.Game.Screens.Ranking.Expanded.Statistics
         }
 
         [BackgroundDependencyLoader]
-        private void load()
+        private void load(ScorePerformanceCache performanceCache)
         {
-            new PerformanceBreakdownCalculator(beatmapManager, difficultyCache, performanceCache)
-                .CalculateAsync(score, cancellationTokenSource.Token)
-                .ContinueWith(t => Schedule(() => setPerformanceValue(t.GetResultSafely())));
+            if (score.PP.HasValue)
+            {
+                setPerformanceValue(score.PP.Value);
+            }
+            else
+            {
+                performanceCache.CalculatePerformanceAsync(score, cancellationTokenSource.Token)
+                                .ContinueWith(t => Schedule(() => setPerformanceValue(t.GetResultSafely().Total)), cancellationTokenSource.Token);
+            }
         }
 
-        private void setPerformanceValue(PerformanceBreakdown breakdown)
+        private void setPerformanceValue(double? pp)
         {
-            // Don't display the tooltip if "Total" is the only item
-            if (breakdown != null && breakdown.Performance.GetAttributesForDisplay().Count() > 1)
-            {
-                TooltipContent = breakdown;
-                performance.Value = (int)Math.Round(breakdown.Performance.Total, MidpointRounding.AwayFromZero);
-            }
+            if (pp.HasValue)
+                performance.Value = (int)Math.Round(pp.Value, MidpointRounding.AwayFromZero);
         }
 
         public override void Appear()
@@ -76,9 +65,5 @@ namespace osu.Game.Screens.Ranking.Expanded.Statistics
             Anchor = Anchor.TopCentre,
             Origin = Anchor.TopCentre
         };
-
-        public ITooltip<PerformanceBreakdown> GetCustomTooltip() => new PerformanceStatisticTooltip();
-
-        public PerformanceBreakdown TooltipContent { get; private set; }
     }
 }
diff --git a/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatisticTooltip.cs b/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatisticTooltip.cs
deleted file mode 100644
index bd6eb057c6..0000000000
--- a/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatisticTooltip.cs
+++ /dev/null
@@ -1,212 +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.Linq;
-using osu.Framework.Allocation;
-using osu.Framework.Extensions.Color4Extensions;
-using osu.Framework.Extensions.LocalisationExtensions;
-using osu.Framework.Graphics;
-using osu.Framework.Graphics.Containers;
-using osu.Framework.Graphics.Cursor;
-using osu.Framework.Graphics.Shapes;
-using osu.Game.Graphics;
-using osu.Game.Graphics.Sprites;
-using osu.Game.Graphics.UserInterface;
-using osu.Game.Rulesets.Difficulty;
-using osuTK;
-using osuTK.Graphics;
-
-namespace osu.Game.Screens.Ranking.Expanded.Statistics
-{
-    public class PerformanceStatisticTooltip : VisibilityContainer, ITooltip<PerformanceBreakdown>
-    {
-        private readonly Box background;
-        private Colour4 titleColor;
-        private Colour4 textColour;
-
-        protected override Container<Drawable> Content { get; }
-
-        public PerformanceStatisticTooltip()
-        {
-            AutoSizeAxes = Axes.Both;
-            Masking = true;
-            CornerRadius = 5;
-
-            InternalChildren = new Drawable[]
-            {
-                background = new Box
-                {
-                    RelativeSizeAxes = Axes.Both
-                },
-                Content = new FillFlowContainer
-                {
-                    AutoSizeAxes = Axes.Both,
-                    Direction = FillDirection.Vertical,
-                    Padding = new MarginPadding { Left = 10, Right = 10, Top = 5, Bottom = 5 }
-                },
-            };
-        }
-
-        [BackgroundDependencyLoader]
-        private void load(OsuColour colours)
-        {
-            background.Colour = colours.Gray3;
-            titleColor = colours.Blue;
-            textColour = colours.BlueLighter;
-        }
-
-        protected override void PopIn() => this.FadeIn(200, Easing.OutQuint);
-
-        protected override void PopOut() => this.FadeOut(200, Easing.OutQuint);
-
-        private PerformanceBreakdown currentPerformance;
-
-        public void SetContent(PerformanceBreakdown performance)
-        {
-            if (performance == currentPerformance)
-                return;
-
-            currentPerformance = performance;
-
-            UpdateDisplay(performance);
-        }
-
-        private Drawable createItemForTotal(PerformanceDisplayAttribute attribute, PerformanceDisplayAttribute perfectAttribute)
-        {
-            return
-                new GridContainer
-                {
-                    AutoSizeAxes = Axes.Both,
-                    Margin = new MarginPadding { Bottom = 10 },
-                    ColumnDimensions = new[]
-                    {
-                        new Dimension(GridSizeMode.Absolute, 250),
-                        new Dimension(GridSizeMode.AutoSize)
-                    },
-                    RowDimensions = new[]
-                    {
-                        new Dimension(GridSizeMode.AutoSize),
-                        new Dimension(GridSizeMode.AutoSize)
-                    },
-                    Content = new[]
-                    {
-                        new Drawable[]
-                        {
-                            new OsuSpriteText
-                            {
-                                Origin = Anchor.CentreLeft,
-                                Anchor = Anchor.CentreLeft,
-                                Font = OsuFont.GetFont(weight: FontWeight.Regular),
-                                Text = attribute.DisplayName,
-                                Colour = titleColor
-                            },
-                            new OsuSpriteText
-                            {
-                                Origin = Anchor.CentreLeft,
-                                Anchor = Anchor.CentreLeft,
-                                Font = OsuFont.GetFont(weight: FontWeight.SemiBold),
-                                Text = Math.Round(attribute.Value, MidpointRounding.AwayFromZero).ToLocalisableString(),
-                                Colour = titleColor
-                            }
-                        },
-                        new Drawable[]
-                        {
-                            new OsuSpriteText
-                            {
-                                Origin = Anchor.CentreLeft,
-                                Anchor = Anchor.CentreLeft,
-                                Font = OsuFont.GetFont(weight: FontWeight.Regular),
-                                Text = "Maximum",
-                                Colour = OsuColour.Gray(0.7f)
-                            },
-                            new OsuSpriteText
-                            {
-                                Origin = Anchor.CentreLeft,
-                                Anchor = Anchor.CentreLeft,
-                                Font = OsuFont.GetFont(weight: FontWeight.Regular),
-                                Text = Math.Round(perfectAttribute.Value, MidpointRounding.AwayFromZero).ToLocalisableString(),
-                                Colour = OsuColour.Gray(0.7f)
-                            }
-                        }
-                    }
-                };
-        }
-
-        private Drawable createItemForAttribute(PerformanceDisplayAttribute attribute, PerformanceDisplayAttribute perfectAttribute)
-        {
-            float percentage = (float)(attribute.Value / perfectAttribute.Value);
-            if (float.IsNaN(percentage))
-                return null;
-
-            return new GridContainer
-            {
-                AutoSizeAxes = Axes.Both,
-                ColumnDimensions = new[]
-                {
-                    new Dimension(GridSizeMode.Absolute, 110),
-                    new Dimension(GridSizeMode.Absolute, 140),
-                    new Dimension(GridSizeMode.AutoSize)
-                },
-                RowDimensions = new[]
-                {
-                    new Dimension(GridSizeMode.AutoSize)
-                },
-                Content = new[]
-                {
-                    new Drawable[]
-                    {
-                        new OsuSpriteText
-                        {
-                            Origin = Anchor.CentreLeft,
-                            Anchor = Anchor.CentreLeft,
-                            Font = OsuFont.GetFont(weight: FontWeight.Regular),
-                            Text = attribute.DisplayName,
-                            Colour = textColour
-                        },
-                        new Bar
-                        {
-                            Origin = Anchor.CentreLeft,
-                            Anchor = Anchor.CentreLeft,
-                            Width = 130,
-                            Height = 5,
-                            BackgroundColour = Color4.White.Opacity(0.5f),
-                            Colour = textColour,
-                            Length = percentage,
-                            Margin = new MarginPadding { Left = 5, Right = 5 }
-                        },
-                        new OsuSpriteText
-                        {
-                            Origin = Anchor.CentreLeft,
-                            Anchor = Anchor.CentreLeft,
-                            Font = OsuFont.GetFont(weight: FontWeight.SemiBold),
-                            Text = percentage.ToLocalisableString("0%"),
-                            Colour = textColour
-                        }
-                    }
-                }
-            };
-        }
-
-        protected virtual void UpdateDisplay(PerformanceBreakdown performance)
-        {
-            Content.Clear();
-
-            var displayAttributes = performance.Performance.GetAttributesForDisplay();
-
-            var perfectDisplayAttributes = performance.PerfectPerformance.GetAttributesForDisplay();
-
-            foreach (PerformanceDisplayAttribute attr in displayAttributes)
-            {
-                var attributeItem = attr.PropertyName == nameof(PerformanceAttributes.Total)
-                    ? createItemForTotal(attr, perfectDisplayAttributes.First(a => a.PropertyName == attr.PropertyName))
-                    : createItemForAttribute(attr, perfectDisplayAttributes.First(a => a.PropertyName == attr.PropertyName));
-
-                if (attributeItem != null)
-                    Content.Add(attributeItem);
-            }
-        }
-
-        public void Move(Vector2 pos) => Position = pos;
-    }
-}

From 440b674bb017f54affd7f201580936ced8a8a126 Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Sat, 5 Feb 2022 21:30:35 +0800
Subject: [PATCH 2810/5547] Add statistic item for mania & taiko

---
 osu.Game.Rulesets.Mania/ManiaRuleset.cs | 11 +++++++++++
 osu.Game.Rulesets.Taiko/TaikoRuleset.cs | 11 +++++++++++
 2 files changed, 22 insertions(+)

diff --git a/osu.Game.Rulesets.Mania/ManiaRuleset.cs b/osu.Game.Rulesets.Mania/ManiaRuleset.cs
index ffb26b224f..aa9b4d5f1d 100644
--- a/osu.Game.Rulesets.Mania/ManiaRuleset.cs
+++ b/osu.Game.Rulesets.Mania/ManiaRuleset.cs
@@ -378,6 +378,17 @@ namespace osu.Game.Rulesets.Mania
                 }
             },
             new StatisticRow
+            {
+                Columns = new[]
+                {
+                    new StatisticItem("Performance Breakdown", () => new PerformanceBreakdownChart(score)
+                    {
+                        RelativeSizeAxes = Axes.X,
+                        AutoSizeAxes = Axes.Y
+                    }),
+                }
+            },
+            new StatisticRow
             {
                 Columns = new[]
                 {
diff --git a/osu.Game.Rulesets.Taiko/TaikoRuleset.cs b/osu.Game.Rulesets.Taiko/TaikoRuleset.cs
index 21c99c0d2f..37e959f8b4 100644
--- a/osu.Game.Rulesets.Taiko/TaikoRuleset.cs
+++ b/osu.Game.Rulesets.Taiko/TaikoRuleset.cs
@@ -221,6 +221,17 @@ namespace osu.Game.Rulesets.Taiko
                     }
                 },
                 new StatisticRow
+                {
+                    Columns = new[]
+                    {
+                        new StatisticItem("Performance Breakdown", () => new PerformanceBreakdownChart(score)
+                        {
+                            RelativeSizeAxes = Axes.X,
+                            AutoSizeAxes = Axes.Y
+                        }),
+                    }
+                },
+                new StatisticRow
                 {
                     Columns = new[]
                     {

From 0b1fef38af1660d6c17c87bdb0c94cff9770cfb0 Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Sat, 5 Feb 2022 21:36:34 +0800
Subject: [PATCH 2811/5547] Use the playable beatmap provided in
 `CreateStatisticsForScore`

---
 osu.Game.Rulesets.Mania/ManiaRuleset.cs         |  2 +-
 osu.Game.Rulesets.Osu/OsuRuleset.cs             |  2 +-
 osu.Game.Rulesets.Taiko/TaikoRuleset.cs         |  2 +-
 .../PerformanceBreakdownCalculator.cs           | 17 ++++++++---------
 .../Statistics/PerformanceBreakdownChart.cs     |  9 ++++-----
 5 files changed, 15 insertions(+), 17 deletions(-)

diff --git a/osu.Game.Rulesets.Mania/ManiaRuleset.cs b/osu.Game.Rulesets.Mania/ManiaRuleset.cs
index aa9b4d5f1d..9027b71069 100644
--- a/osu.Game.Rulesets.Mania/ManiaRuleset.cs
+++ b/osu.Game.Rulesets.Mania/ManiaRuleset.cs
@@ -381,7 +381,7 @@ namespace osu.Game.Rulesets.Mania
             {
                 Columns = new[]
                 {
-                    new StatisticItem("Performance Breakdown", () => new PerformanceBreakdownChart(score)
+                    new StatisticItem("Performance Breakdown", () => new PerformanceBreakdownChart(score, playableBeatmap)
                     {
                         RelativeSizeAxes = Axes.X,
                         AutoSizeAxes = Axes.Y
diff --git a/osu.Game.Rulesets.Osu/OsuRuleset.cs b/osu.Game.Rulesets.Osu/OsuRuleset.cs
index 769e83ec00..68e91e42a7 100644
--- a/osu.Game.Rulesets.Osu/OsuRuleset.cs
+++ b/osu.Game.Rulesets.Osu/OsuRuleset.cs
@@ -301,7 +301,7 @@ namespace osu.Game.Rulesets.Osu
                 {
                     Columns = new[]
                     {
-                        new StatisticItem("Performance Breakdown", () => new PerformanceBreakdownChart(score)
+                        new StatisticItem("Performance Breakdown", () => new PerformanceBreakdownChart(score, playableBeatmap)
                         {
                             RelativeSizeAxes = Axes.X,
                             AutoSizeAxes = Axes.Y
diff --git a/osu.Game.Rulesets.Taiko/TaikoRuleset.cs b/osu.Game.Rulesets.Taiko/TaikoRuleset.cs
index 37e959f8b4..ddc594a70a 100644
--- a/osu.Game.Rulesets.Taiko/TaikoRuleset.cs
+++ b/osu.Game.Rulesets.Taiko/TaikoRuleset.cs
@@ -224,7 +224,7 @@ namespace osu.Game.Rulesets.Taiko
                 {
                     Columns = new[]
                     {
-                        new StatisticItem("Performance Breakdown", () => new PerformanceBreakdownChart(score)
+                        new StatisticItem("Performance Breakdown", () => new PerformanceBreakdownChart(score, playableBeatmap)
                         {
                             RelativeSizeAxes = Axes.X,
                             AutoSizeAxes = Axes.Y
diff --git a/osu.Game/Rulesets/Difficulty/PerformanceBreakdownCalculator.cs b/osu.Game/Rulesets/Difficulty/PerformanceBreakdownCalculator.cs
index 46342b237c..d68c2edb40 100644
--- a/osu.Game/Rulesets/Difficulty/PerformanceBreakdownCalculator.cs
+++ b/osu.Game/Rulesets/Difficulty/PerformanceBreakdownCalculator.cs
@@ -16,13 +16,13 @@ namespace osu.Game.Rulesets.Difficulty
 {
     public class PerformanceBreakdownCalculator
     {
-        private readonly BeatmapManager beatmapManager;
+        private readonly IBeatmap playableBeatmap;
         private readonly BeatmapDifficultyCache difficultyCache;
         private readonly ScorePerformanceCache performanceCache;
 
-        public PerformanceBreakdownCalculator(BeatmapManager beatmapManager, BeatmapDifficultyCache difficultyCache, ScorePerformanceCache performanceCache)
+        public PerformanceBreakdownCalculator(IBeatmap playableBeatmap, BeatmapDifficultyCache difficultyCache, ScorePerformanceCache performanceCache)
         {
-            this.beatmapManager = beatmapManager;
+            this.playableBeatmap = playableBeatmap;
             this.difficultyCache = difficultyCache;
             this.performanceCache = performanceCache;
         }
@@ -46,14 +46,13 @@ namespace osu.Game.Rulesets.Difficulty
             return Task.Run(async () =>
             {
                 Ruleset ruleset = score.Ruleset.CreateInstance();
-                IBeatmap beatmap = beatmapManager.GetWorkingBeatmap(score.BeatmapInfo).GetPlayableBeatmap(score.Ruleset, score.Mods);
                 ScoreInfo perfectPlay = score.DeepClone();
                 perfectPlay.Accuracy = 1;
                 perfectPlay.Passed = true;
 
                 // calculate max combo
                 var difficulty = await difficultyCache.GetDifficultyAsync(
-                    beatmap.BeatmapInfo,
+                    playableBeatmap.BeatmapInfo,
                     score.Ruleset,
                     score.Mods,
                     cancellationToken
@@ -65,10 +64,10 @@ namespace osu.Game.Rulesets.Difficulty
                 perfectPlay.MaxCombo = difficulty.Value.MaxCombo;
 
                 // create statistics assuming all hit objects have perfect hit result
-                var statistics = beatmap.HitObjects
-                                        .SelectMany(getPerfectHitResults)
-                                        .GroupBy(hr => hr, (hr, list) => (hitResult: hr, count: list.Count()))
-                                        .ToDictionary(pair => pair.hitResult, pair => pair.count);
+                var statistics = playableBeatmap.HitObjects
+                                                .SelectMany(getPerfectHitResults)
+                                                .GroupBy(hr => hr, (hr, list) => (hitResult: hr, count: list.Count()))
+                                                .ToDictionary(pair => pair.hitResult, pair => pair.count);
                 perfectPlay.Statistics = statistics;
 
                 // calculate total score
diff --git a/osu.Game/Screens/Ranking/Statistics/PerformanceBreakdownChart.cs b/osu.Game/Screens/Ranking/Statistics/PerformanceBreakdownChart.cs
index b58974eb96..fb9c93f0e6 100644
--- a/osu.Game/Screens/Ranking/Statistics/PerformanceBreakdownChart.cs
+++ b/osu.Game/Screens/Ranking/Statistics/PerformanceBreakdownChart.cs
@@ -26,6 +26,7 @@ namespace osu.Game.Screens.Ranking.Statistics
     public class PerformanceBreakdownChart : Container
     {
         private readonly ScoreInfo score;
+        private readonly IBeatmap playableBeatmap;
 
         private Drawable spinner;
         private Drawable content;
@@ -41,12 +42,10 @@ namespace osu.Game.Screens.Ranking.Statistics
         [Resolved]
         private BeatmapDifficultyCache difficultyCache { get; set; }
 
-        [Resolved]
-        private BeatmapManager beatmapManager { get; set; }
-
-        public PerformanceBreakdownChart(ScoreInfo score)
+        public PerformanceBreakdownChart(ScoreInfo score, IBeatmap playableBeatmap)
         {
             this.score = score;
+            this.playableBeatmap = playableBeatmap;
         }
 
         [BackgroundDependencyLoader]
@@ -146,7 +145,7 @@ namespace osu.Game.Screens.Ranking.Statistics
 
             spinner.Show();
 
-            new PerformanceBreakdownCalculator(beatmapManager, difficultyCache, performanceCache)
+            new PerformanceBreakdownCalculator(playableBeatmap, difficultyCache, performanceCache)
                 .CalculateAsync(score, cancellationTokenSource.Token)
                 .ContinueWith(t => Schedule(() => setPerformanceValue(t.GetResultSafely())));
         }

From ee6d4b25836d8051e4802b02c68075c28e2494b4 Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Sat, 5 Feb 2022 21:39:01 +0800
Subject: [PATCH 2812/5547] Move performance breakdown to the top to prevent
 re-ordering after watching replay

---
 osu.Game.Rulesets.Mania/ManiaRuleset.cs | 12 ++++++------
 osu.Game.Rulesets.Osu/OsuRuleset.cs     | 22 +++++++++++-----------
 osu.Game.Rulesets.Taiko/TaikoRuleset.cs | 12 ++++++------
 3 files changed, 23 insertions(+), 23 deletions(-)

diff --git a/osu.Game.Rulesets.Mania/ManiaRuleset.cs b/osu.Game.Rulesets.Mania/ManiaRuleset.cs
index 9027b71069..180b9ef71b 100644
--- a/osu.Game.Rulesets.Mania/ManiaRuleset.cs
+++ b/osu.Game.Rulesets.Mania/ManiaRuleset.cs
@@ -370,22 +370,22 @@ namespace osu.Game.Rulesets.Mania
             {
                 Columns = new[]
                 {
-                    new StatisticItem("Timing Distribution", () => new HitEventTimingDistributionGraph(score.HitEvents)
+                    new StatisticItem("Performance Breakdown", () => new PerformanceBreakdownChart(score, playableBeatmap)
                     {
                         RelativeSizeAxes = Axes.X,
-                        Height = 250
-                    }, true),
+                        AutoSizeAxes = Axes.Y
+                    }),
                 }
             },
             new StatisticRow
             {
                 Columns = new[]
                 {
-                    new StatisticItem("Performance Breakdown", () => new PerformanceBreakdownChart(score, playableBeatmap)
+                    new StatisticItem("Timing Distribution", () => new HitEventTimingDistributionGraph(score.HitEvents)
                     {
                         RelativeSizeAxes = Axes.X,
-                        AutoSizeAxes = Axes.Y
-                    }),
+                        Height = 250
+                    }, true),
                 }
             },
             new StatisticRow
diff --git a/osu.Game.Rulesets.Osu/OsuRuleset.cs b/osu.Game.Rulesets.Osu/OsuRuleset.cs
index 68e91e42a7..ad00a025a1 100644
--- a/osu.Game.Rulesets.Osu/OsuRuleset.cs
+++ b/osu.Game.Rulesets.Osu/OsuRuleset.cs
@@ -275,6 +275,17 @@ namespace osu.Game.Rulesets.Osu
 
             return new[]
             {
+                new StatisticRow
+                {
+                    Columns = new[]
+                    {
+                        new StatisticItem("Performance Breakdown", () => new PerformanceBreakdownChart(score, playableBeatmap)
+                        {
+                            RelativeSizeAxes = Axes.X,
+                            AutoSizeAxes = Axes.Y
+                        }),
+                    }
+                },
                 new StatisticRow
                 {
                     Columns = new[]
@@ -298,17 +309,6 @@ namespace osu.Game.Rulesets.Osu
                     }
                 },
                 new StatisticRow
-                {
-                    Columns = new[]
-                    {
-                        new StatisticItem("Performance Breakdown", () => new PerformanceBreakdownChart(score, playableBeatmap)
-                        {
-                            RelativeSizeAxes = Axes.X,
-                            AutoSizeAxes = Axes.Y
-                        }),
-                    }
-                },
-                new StatisticRow
                 {
                     Columns = new[]
                     {
diff --git a/osu.Game.Rulesets.Taiko/TaikoRuleset.cs b/osu.Game.Rulesets.Taiko/TaikoRuleset.cs
index ddc594a70a..e56aabaf9d 100644
--- a/osu.Game.Rulesets.Taiko/TaikoRuleset.cs
+++ b/osu.Game.Rulesets.Taiko/TaikoRuleset.cs
@@ -213,22 +213,22 @@ namespace osu.Game.Rulesets.Taiko
                 {
                     Columns = new[]
                     {
-                        new StatisticItem("Timing Distribution", () => new HitEventTimingDistributionGraph(timedHitEvents)
+                        new StatisticItem("Performance Breakdown", () => new PerformanceBreakdownChart(score, playableBeatmap)
                         {
                             RelativeSizeAxes = Axes.X,
-                            Height = 250
-                        }, true),
+                            AutoSizeAxes = Axes.Y
+                        }),
                     }
                 },
                 new StatisticRow
                 {
                     Columns = new[]
                     {
-                        new StatisticItem("Performance Breakdown", () => new PerformanceBreakdownChart(score, playableBeatmap)
+                        new StatisticItem("Timing Distribution", () => new HitEventTimingDistributionGraph(timedHitEvents)
                         {
                             RelativeSizeAxes = Axes.X,
-                            AutoSizeAxes = Axes.Y
-                        }),
+                            Height = 250
+                        }, true),
                     }
                 },
                 new StatisticRow

From b31c1513f6ef0e7c17e7a3af39bb19174084255a Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Sat, 5 Feb 2022 22:41:04 +0800
Subject: [PATCH 2813/5547] Fix test failure

The cursor was clicking too far to the right.
---
 osu.Game.Tests/Visual/Ranking/TestSceneResultsScreen.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/Ranking/TestSceneResultsScreen.cs b/osu.Game.Tests/Visual/Ranking/TestSceneResultsScreen.cs
index 988f429ff5..167acc94c4 100644
--- a/osu.Game.Tests/Visual/Ranking/TestSceneResultsScreen.cs
+++ b/osu.Game.Tests/Visual/Ranking/TestSceneResultsScreen.cs
@@ -130,7 +130,7 @@ namespace osu.Game.Tests.Visual.Ranking
             AddStep("click to right of panel", () =>
             {
                 var expandedPanel = this.ChildrenOfType<ScorePanel>().Single(p => p.State == PanelState.Expanded);
-                InputManager.MoveMouseTo(expandedPanel.ScreenSpaceDrawQuad.TopRight + new Vector2(100, 0));
+                InputManager.MoveMouseTo(expandedPanel.ScreenSpaceDrawQuad.TopRight + new Vector2(50, 0));
                 InputManager.Click(MouseButton.Left);
             });
 

From f78c853bc752f33d5fff6688fd286182e8ecd476 Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Sun, 6 Feb 2022 10:59:53 +0800
Subject: [PATCH 2814/5547] Calculate max combo locally in
 `PerformanceBreakdownCalculator`

---
 .../PerformanceBreakdownCalculator.cs         | 26 ++++++++++---------
 1 file changed, 14 insertions(+), 12 deletions(-)

diff --git a/osu.Game/Rulesets/Difficulty/PerformanceBreakdownCalculator.cs b/osu.Game/Rulesets/Difficulty/PerformanceBreakdownCalculator.cs
index d68c2edb40..87e60fbe9d 100644
--- a/osu.Game/Rulesets/Difficulty/PerformanceBreakdownCalculator.cs
+++ b/osu.Game/Rulesets/Difficulty/PerformanceBreakdownCalculator.cs
@@ -51,17 +51,7 @@ namespace osu.Game.Rulesets.Difficulty
                 perfectPlay.Passed = true;
 
                 // calculate max combo
-                var difficulty = await difficultyCache.GetDifficultyAsync(
-                    playableBeatmap.BeatmapInfo,
-                    score.Ruleset,
-                    score.Mods,
-                    cancellationToken
-                ).ConfigureAwait(false);
-
-                if (difficulty == null)
-                    return null;
-
-                perfectPlay.MaxCombo = difficulty.Value.MaxCombo;
+                perfectPlay.MaxCombo = calculateMaxCombo(playableBeatmap);
 
                 // create statistics assuming all hit objects have perfect hit result
                 var statistics = playableBeatmap.HitObjects
@@ -86,11 +76,23 @@ namespace osu.Game.Rulesets.Difficulty
                 }
 
                 // calculate performance for this perfect score
+                var difficulty = await difficultyCache.GetDifficultyAsync(
+                    playableBeatmap.BeatmapInfo,
+                    score.Ruleset,
+                    score.Mods,
+                    cancellationToken
+                ).ConfigureAwait(false);
+
                 // ScorePerformanceCache is not used to avoid caching multiple copies of essentially identical perfect performance attributes
-                return ruleset.CreatePerformanceCalculator(difficulty.Value.Attributes, perfectPlay)?.Calculate();
+                return difficulty == null ? null : ruleset.CreatePerformanceCalculator(difficulty.Value.Attributes, perfectPlay)?.Calculate();
             }, cancellationToken);
         }
 
+        private int calculateMaxCombo(IBeatmap beatmap)
+        {
+            return beatmap.HitObjects.SelectMany(getPerfectHitResults).Count(r => r.AffectsCombo());
+        }
+
         private IEnumerable<HitResult> getPerfectHitResults(HitObject hitObject)
         {
             foreach (HitObject nested in hitObject.NestedHitObjects)

From 56c90a21ceec78749b3b76f26c46c54cb3533169 Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Sun, 6 Feb 2022 11:22:12 +0800
Subject: [PATCH 2815/5547] Add a todo

---
 osu.Game/Rulesets/Difficulty/PerformanceBreakdownCalculator.cs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Game/Rulesets/Difficulty/PerformanceBreakdownCalculator.cs b/osu.Game/Rulesets/Difficulty/PerformanceBreakdownCalculator.cs
index 87e60fbe9d..3d384f5914 100644
--- a/osu.Game/Rulesets/Difficulty/PerformanceBreakdownCalculator.cs
+++ b/osu.Game/Rulesets/Difficulty/PerformanceBreakdownCalculator.cs
@@ -51,6 +51,7 @@ namespace osu.Game.Rulesets.Difficulty
                 perfectPlay.Passed = true;
 
                 // calculate max combo
+                // todo: Get max combo from difficulty calculator instead when diffcalc properly supports lazer-first scores
                 perfectPlay.MaxCombo = calculateMaxCombo(playableBeatmap);
 
                 // create statistics assuming all hit objects have perfect hit result

From c2416c490e3b81c1fe7aa61c90200f9757fed7c8 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 8 Feb 2022 11:29:39 +0900
Subject: [PATCH 2816/5547] Fix crash on disconnection during multi-spectate

---
 .../OnlinePlay/Multiplayer/Spectate/MultiSpectatorScreen.cs   | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorScreen.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorScreen.cs
index 4646f42d63..bff7023102 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorScreen.cs
@@ -2,7 +2,6 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
-using System.Diagnostics;
 using System.Linq;
 using JetBrains.Annotations;
 using osu.Framework.Allocation;
@@ -228,7 +227,8 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Spectate
 
         public override bool OnBackButton()
         {
-            Debug.Assert(multiplayerClient.Room != null);
+            if (multiplayerClient.Room == null)
+                return base.OnBackButton();
 
             // On a manual exit, set the player back to idle unless gameplay has finished.
             if (multiplayerClient.Room.State != MultiplayerRoomState.Open)

From 10bdb7240ff3615f53cb7a0ce61b88f5b3d3428c Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Tue, 8 Feb 2022 14:36:29 +0800
Subject: [PATCH 2817/5547] Pre-check for divisor zero and add explanation

---
 .../Ranking/Statistics/PerformanceBreakdownChart.cs       | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/Ranking/Statistics/PerformanceBreakdownChart.cs b/osu.Game/Screens/Ranking/Statistics/PerformanceBreakdownChart.cs
index fb9c93f0e6..5b42554716 100644
--- a/osu.Game/Screens/Ranking/Statistics/PerformanceBreakdownChart.cs
+++ b/osu.Game/Screens/Ranking/Statistics/PerformanceBreakdownChart.cs
@@ -12,6 +12,7 @@ using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Extensions.LocalisationExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
+using osu.Framework.Utils;
 using osu.Game.Beatmaps;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
@@ -192,10 +193,13 @@ namespace osu.Game.Screens.Ranking.Statistics
         [CanBeNull]
         private Drawable[] createAttributeRow(PerformanceDisplayAttribute attribute, PerformanceDisplayAttribute perfectAttribute)
         {
-            float percentage = (float)(attribute.Value / perfectAttribute.Value);
-            if (float.IsNaN(percentage))
+            // Don't display the attribute if its maximum is 0
+            // For example, flashlight bonus would be zero if flashlight mod isn't on
+            if (Precision.AlmostEquals(perfectAttribute.Value, 0f))
                 return null;
 
+            float percentage = (float)(attribute.Value / perfectAttribute.Value);
+
             return new Drawable[]
             {
                 new OsuSpriteText

From 9c2d57d70783cdc71c8a8ee5439dcbc5eec41073 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 8 Feb 2022 19:36:16 +0900
Subject: [PATCH 2818/5547] Add failing test

---
 .../Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs    | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs b/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
index 94e61eaee0..343fc7e6e0 100644
--- a/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
+++ b/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
@@ -92,7 +92,8 @@ namespace osu.Game.Tests.Online
 
             AddStep("allow importing", () => beatmaps.AllowImport.SetResult(true));
             AddUntilStep("wait for import", () => beatmaps.CurrentImport != null);
-            addAvailabilityCheckStep("state locally available", BeatmapAvailability.LocallyAvailable);
+            AddAssert("ensure beatmap available", () => beatmaps.IsAvailableLocally(testBeatmapSet));
+            addAvailabilityCheckStep("state is locally available", BeatmapAvailability.LocallyAvailable);
         }
 
         [Test]

From b1a73996ba69de0cd1e02c9cb25266d52d29e2b7 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 8 Feb 2022 19:36:41 +0900
Subject: [PATCH 2819/5547] Fix incorrect check for beatmap availability

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

diff --git a/osu.Game/Stores/BeatmapImporter.cs b/osu.Game/Stores/BeatmapImporter.cs
index 709dd67087..2a2786b861 100644
--- a/osu.Game/Stores/BeatmapImporter.cs
+++ b/osu.Game/Stores/BeatmapImporter.cs
@@ -165,7 +165,7 @@ namespace osu.Game.Stores
 
         public override bool IsAvailableLocally(BeatmapSetInfo model)
         {
-            return Realm.Run(realm => realm.All<BeatmapInfo>().Any(b => b.OnlineID == model.OnlineID));
+            return Realm.Run(realm => realm.All<BeatmapSetInfo>().Any(b => b.OnlineID == model.OnlineID));
         }
 
         public override string HumanisedModelName => "beatmap";

From 0d99017178af1b373212f4174242e7bf8ee224a3 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 8 Feb 2022 20:27:08 +0900
Subject: [PATCH 2820/5547] Add state tests

---
 .../Visual/Gameplay/TestSceneSpectator.cs     | 65 +++++++++++++++++++
 1 file changed, 65 insertions(+)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs
index 9f8470446c..65583919d6 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs
@@ -235,6 +235,71 @@ namespace osu.Game.Tests.Visual.Gameplay
             AddAssert("last frame has header", () => lastBundle.Frames[^1].Header != null);
         }
 
+        [Test]
+        public void TestPlayingState()
+        {
+            loadSpectatingScreen();
+
+            start();
+            sendFrames();
+            waitForPlayer();
+            AddUntilStep("state is playing", () => spectatorClient.WatchingUserStates[streamingUser.Id].State == SpectatingUserState.Playing);
+        }
+
+        [Test]
+        public void TestCompletionState()
+        {
+            loadSpectatingScreen();
+
+            start();
+            sendFrames();
+            waitForPlayer();
+
+            AddStep("send completion", () => spectatorClient.EndPlay(streamingUser.Id, SpectatingUserState.Completed));
+            AddUntilStep("state is completed", () => spectatorClient.WatchingUserStates[streamingUser.Id].State == SpectatingUserState.Completed);
+
+            start();
+            sendFrames();
+            waitForPlayer();
+            AddUntilStep("state is playing", () => spectatorClient.WatchingUserStates[streamingUser.Id].State == SpectatingUserState.Playing);
+        }
+
+        [Test]
+        public void TestQuitState()
+        {
+            loadSpectatingScreen();
+
+            start();
+            sendFrames();
+            waitForPlayer();
+
+            AddStep("send quit", () => spectatorClient.EndPlay(streamingUser.Id, SpectatingUserState.Quit));
+            AddUntilStep("state is quit", () => spectatorClient.WatchingUserStates[streamingUser.Id].State == SpectatingUserState.Quit);
+
+            start();
+            sendFrames();
+            waitForPlayer();
+            AddUntilStep("state is playing", () => spectatorClient.WatchingUserStates[streamingUser.Id].State == SpectatingUserState.Playing);
+        }
+
+        [Test]
+        public void TestFailedState()
+        {
+            loadSpectatingScreen();
+
+            start();
+            sendFrames();
+            waitForPlayer();
+
+            AddStep("send failed", () => spectatorClient.EndPlay(streamingUser.Id, SpectatingUserState.Failed));
+            AddUntilStep("state is failed", () => spectatorClient.WatchingUserStates[streamingUser.Id].State == SpectatingUserState.Failed);
+
+            start();
+            sendFrames();
+            waitForPlayer();
+            AddUntilStep("state is playing", () => spectatorClient.WatchingUserStates[streamingUser.Id].State == SpectatingUserState.Playing);
+        }
+
         private OsuFramedReplayInputHandler replayHandler =>
             (OsuFramedReplayInputHandler)Stack.ChildrenOfType<OsuInputManager>().First().ReplayInputHandler;
 

From 4c76027178933d9bcade478495f0588746220a18 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 8 Feb 2022 20:29:49 +0900
Subject: [PATCH 2821/5547] Rename completed state to passed

---
 osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs   |  6 +++---
 osu.Game/Online/Spectator/SpectatingUserState.cs       | 10 +++++-----
 osu.Game/Online/Spectator/SpectatorClient.cs           |  2 +-
 .../Multiplayer/Spectate/MultiSpectatorScreen.cs       |  2 +-
 osu.Game/Screens/Spectate/SpectatorScreen.cs           |  2 +-
 5 files changed, 11 insertions(+), 11 deletions(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs
index 65583919d6..a263bb1e6f 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs
@@ -247,7 +247,7 @@ namespace osu.Game.Tests.Visual.Gameplay
         }
 
         [Test]
-        public void TestCompletionState()
+        public void TestPassedState()
         {
             loadSpectatingScreen();
 
@@ -255,8 +255,8 @@ namespace osu.Game.Tests.Visual.Gameplay
             sendFrames();
             waitForPlayer();
 
-            AddStep("send completion", () => spectatorClient.EndPlay(streamingUser.Id, SpectatingUserState.Completed));
-            AddUntilStep("state is completed", () => spectatorClient.WatchingUserStates[streamingUser.Id].State == SpectatingUserState.Completed);
+            AddStep("send passed", () => spectatorClient.EndPlay(streamingUser.Id, SpectatingUserState.Passed));
+            AddUntilStep("state is passed", () => spectatorClient.WatchingUserStates[streamingUser.Id].State == SpectatingUserState.Passed);
 
             start();
             sendFrames();
diff --git a/osu.Game/Online/Spectator/SpectatingUserState.cs b/osu.Game/Online/Spectator/SpectatingUserState.cs
index c7ba4ba248..30be57b739 100644
--- a/osu.Game/Online/Spectator/SpectatingUserState.cs
+++ b/osu.Game/Online/Spectator/SpectatingUserState.cs
@@ -6,7 +6,7 @@ namespace osu.Game.Online.Spectator
     public enum SpectatingUserState
     {
         /// <summary>
-        /// The spectated user has not yet played.
+        /// The spectated user is not yet playing.
         /// </summary>
         Idle,
 
@@ -16,17 +16,17 @@ namespace osu.Game.Online.Spectator
         Playing,
 
         /// <summary>
-        /// The spectated user has successfully completed gameplay.
+        /// The spectated user has passed gameplay.
         /// </summary>
-        Completed,
+        Passed,
 
         /// <summary>
-        /// The spectator user has failed during gameplay.
+        /// The spectator user has failed gameplay.
         /// </summary>
         Failed,
 
         /// <summary>
-        /// The spectated user has quit during gameplay.
+        /// The spectated user has quit gameplay.
         /// </summary>
         Quit
     }
diff --git a/osu.Game/Online/Spectator/SpectatorClient.cs b/osu.Game/Online/Spectator/SpectatorClient.cs
index 9e168411b0..ee5fdc917a 100644
--- a/osu.Game/Online/Spectator/SpectatorClient.cs
+++ b/osu.Game/Online/Spectator/SpectatorClient.cs
@@ -186,7 +186,7 @@ namespace osu.Game.Online.Spectator
                 currentBeatmap = null;
 
                 if (state.HasPassed)
-                    currentState.State = SpectatingUserState.Completed;
+                    currentState.State = SpectatingUserState.Passed;
                 else if (state.HasFailed)
                     currentState.State = SpectatingUserState.Failed;
                 else
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorScreen.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorScreen.cs
index 125e4b261c..60bf87ff61 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorScreen.cs
@@ -216,7 +216,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Spectate
 
         protected override void EndGameplay(int userId, SpectatorState state)
         {
-            if (state.State == SpectatingUserState.Completed || state.State == SpectatingUserState.Failed)
+            if (state.State == SpectatingUserState.Passed || state.State == SpectatingUserState.Failed)
                 return;
 
             RemoveUser(userId);
diff --git a/osu.Game/Screens/Spectate/SpectatorScreen.cs b/osu.Game/Screens/Spectate/SpectatorScreen.cs
index 7b58f669a0..394afb3a4c 100644
--- a/osu.Game/Screens/Spectate/SpectatorScreen.cs
+++ b/osu.Game/Screens/Spectate/SpectatorScreen.cs
@@ -134,7 +134,7 @@ namespace osu.Game.Screens.Spectate
 
             switch (newState.State)
             {
-                case SpectatingUserState.Completed:
+                case SpectatingUserState.Passed:
                     // Make sure that gameplay completes to the end.
                     if (gameplayStates.TryGetValue(userId, out var gameplayState))
                         gameplayState.Score.Replay.HasReceivedAllFrames = true;

From c1766d8a411f1626255c1d74fbf0b634e7bc4610 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 8 Feb 2022 20:29:53 +0900
Subject: [PATCH 2822/5547] Add paused state

---
 osu.Game/Online/Spectator/SpectatingUserState.cs | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/osu.Game/Online/Spectator/SpectatingUserState.cs b/osu.Game/Online/Spectator/SpectatingUserState.cs
index 30be57b739..e00c2e1947 100644
--- a/osu.Game/Online/Spectator/SpectatingUserState.cs
+++ b/osu.Game/Online/Spectator/SpectatingUserState.cs
@@ -15,6 +15,11 @@ namespace osu.Game.Online.Spectator
         /// </summary>
         Playing,
 
+        /// <summary>
+        /// The spectated user is currently paused. Unused for the time being.
+        /// </summary>
+        Paused,
+
         /// <summary>
         /// The spectated user has passed gameplay.
         /// </summary>

From 79d1d54e336c2cb0eff7399912933eb32f24b19e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 8 Feb 2022 20:35:38 +0900
Subject: [PATCH 2823/5547] Rename parameter to match other usages

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

diff --git a/osu.Game/Stores/BeatmapImporter.cs b/osu.Game/Stores/BeatmapImporter.cs
index 2a2786b861..e6b655589c 100644
--- a/osu.Game/Stores/BeatmapImporter.cs
+++ b/osu.Game/Stores/BeatmapImporter.cs
@@ -165,7 +165,7 @@ namespace osu.Game.Stores
 
         public override bool IsAvailableLocally(BeatmapSetInfo model)
         {
-            return Realm.Run(realm => realm.All<BeatmapSetInfo>().Any(b => b.OnlineID == model.OnlineID));
+            return Realm.Run(realm => realm.All<BeatmapSetInfo>().Any(s => s.OnlineID == model.OnlineID));
         }
 
         public override string HumanisedModelName => "beatmap";

From 886d1d2df637dcbac1e3b7147b3062ba576ce178 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 8 Feb 2022 21:20:33 +0900
Subject: [PATCH 2824/5547] Refactorings

---
 .../Visual/Gameplay/TestSceneSpectator.cs     |  3 ++-
 osu.Game/Online/Spectator/SpectatorClient.cs  |  2 +-
 .../Dashboard/CurrentlyPlayingDisplay.cs      | 20 +++++++++----------
 .../Spectate/MultiSpectatorScreen.cs          |  2 ++
 osu.Game/Screens/Play/GameplayState.cs        |  2 +-
 5 files changed, 16 insertions(+), 13 deletions(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs
index a263bb1e6f..e0946df2dc 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs
@@ -160,7 +160,8 @@ namespace osu.Game.Tests.Visual.Gameplay
             finish(SpectatingUserState.Failed);
 
             checkPaused(false); // Should continue playing until out of frames
-            checkPaused(true);
+            checkPaused(true); // And eventually stop after running out of frames and fail.
+            // Todo: Should check for + display a failed message.
         }
 
         [Test]
diff --git a/osu.Game/Online/Spectator/SpectatorClient.cs b/osu.Game/Online/Spectator/SpectatorClient.cs
index ee5fdc917a..ed6e355ddf 100644
--- a/osu.Game/Online/Spectator/SpectatorClient.cs
+++ b/osu.Game/Online/Spectator/SpectatorClient.cs
@@ -98,8 +98,8 @@ namespace osu.Game.Online.Spectator
                 }
                 else
                 {
-                    watchingUserStates.Clear();
                     playingUsers.Clear();
+                    watchingUserStates.Clear();
                 }
             }), true);
         }
diff --git a/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs b/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs
index 02ef28f825..117de88166 100644
--- a/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs
+++ b/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs
@@ -69,17 +69,17 @@ namespace osu.Game.Overlays.Dashboard
                         {
                             var user = task.GetResultSafely();
 
-                            if (user != null)
-                            {
-                                Schedule(() =>
-                                {
-                                    // user may no longer be playing.
-                                    if (!playingUsers.Contains(user.Id))
-                                        return;
+                            if (user == null)
+                                return;
 
-                                    userFlow.Add(createUserPanel(user));
-                                });
-                            }
+                            Schedule(() =>
+                            {
+                                // user may no longer be playing.
+                                if (!playingUsers.Contains(user.Id))
+                                    return;
+
+                                userFlow.Add(createUserPanel(user));
+                            });
                         });
                     }
 
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorScreen.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorScreen.cs
index 60bf87ff61..55df8301da 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorScreen.cs
@@ -216,6 +216,8 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Spectate
 
         protected override void EndGameplay(int userId, SpectatorState state)
         {
+            // Allowed passed/failed users to complete their remaining replay frames.
+            // The failed state isn't really possible in multiplayer (yet?) but is added here just for safety in case it starts being used.
             if (state.State == SpectatingUserState.Passed || state.State == SpectatingUserState.Failed)
                 return;
 
diff --git a/osu.Game/Screens/Play/GameplayState.cs b/osu.Game/Screens/Play/GameplayState.cs
index 64e873b3bb..c6a072da74 100644
--- a/osu.Game/Screens/Play/GameplayState.cs
+++ b/osu.Game/Screens/Play/GameplayState.cs
@@ -50,7 +50,7 @@ namespace osu.Game.Screens.Play
         public bool HasFailed { get; set; }
 
         /// <summary>
-        /// Whether the user quit gameplay without either having either passed or failed.
+        /// Whether the user quit gameplay without having either passed or failed.
         /// </summary>
         public bool HasQuit { get; set; }
 

From c242a63b1177b4e772fc52dff5b4eb2030bd48b9 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 9 Feb 2022 10:16:43 +0900
Subject: [PATCH 2825/5547] Fix playlist overlay null reference when attempting
 an empty selection

As reported at https://github.com/ppy/osu/discussions/16829.
---
 osu.Game/Overlays/Music/PlaylistOverlay.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/Music/PlaylistOverlay.cs b/osu.Game/Overlays/Music/PlaylistOverlay.cs
index 59ade0918d..ce816f84f0 100644
--- a/osu.Game/Overlays/Music/PlaylistOverlay.cs
+++ b/osu.Game/Overlays/Music/PlaylistOverlay.cs
@@ -85,7 +85,7 @@ namespace osu.Game.Overlays.Music
 
             filter.Search.OnCommit += (sender, newText) =>
             {
-                list.FirstVisibleSet.PerformRead(set =>
+                list.FirstVisibleSet?.PerformRead(set =>
                 {
                     BeatmapInfo toSelect = set.Beatmaps.FirstOrDefault();
 

From 4966c4e974c9a3e7b98910adeee5b658d6889e22 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 9 Feb 2022 11:51:47 +0900
Subject: [PATCH 2826/5547] Remove redundant parameter

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

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs
index e0946df2dc..7235bce789 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs
@@ -274,7 +274,7 @@ namespace osu.Game.Tests.Visual.Gameplay
             sendFrames();
             waitForPlayer();
 
-            AddStep("send quit", () => spectatorClient.EndPlay(streamingUser.Id, SpectatingUserState.Quit));
+            AddStep("send quit", () => spectatorClient.EndPlay(streamingUser.Id));
             AddUntilStep("state is quit", () => spectatorClient.WatchingUserStates[streamingUser.Id].State == SpectatingUserState.Quit);
 
             start();

From ffc4c64f7e7fb0951c9c3f3109497b37f50196b3 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 9 Feb 2022 12:09:04 +0900
Subject: [PATCH 2827/5547] Unify namings across the board

---
 .../Visual/Gameplay/TestSceneSpectator.cs     | 22 ++++++------
 .../Visual/Gameplay/TestSceneSpectatorHost.cs |  4 +--
 ...TestSceneMultiplayerGameplayLeaderboard.cs |  2 +-
 ...tingUserState.cs => SpectatedUserState.cs} |  4 +--
 osu.Game/Online/Spectator/SpectatorClient.cs  | 36 +++++++++----------
 osu.Game/Online/Spectator/SpectatorState.cs   |  2 +-
 .../Spectate/MultiSpectatorScreen.cs          |  2 +-
 osu.Game/Screens/Spectate/SpectatorScreen.cs  |  6 ++--
 .../Visual/Spectator/TestSpectatorClient.cs   |  4 +--
 9 files changed, 41 insertions(+), 41 deletions(-)
 rename osu.Game/Online/Spectator/{SpectatingUserState.cs => SpectatedUserState.cs} (90%)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs
index 7235bce789..157c248d69 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs
@@ -157,7 +157,7 @@ namespace osu.Game.Tests.Visual.Gameplay
             checkPaused(true);
             sendFrames();
 
-            finish(SpectatingUserState.Failed);
+            finish(SpectatedUserState.Failed);
 
             checkPaused(false); // Should continue playing until out of frames
             checkPaused(true); // And eventually stop after running out of frames and fail.
@@ -244,7 +244,7 @@ namespace osu.Game.Tests.Visual.Gameplay
             start();
             sendFrames();
             waitForPlayer();
-            AddUntilStep("state is playing", () => spectatorClient.WatchingUserStates[streamingUser.Id].State == SpectatingUserState.Playing);
+            AddUntilStep("state is playing", () => spectatorClient.WatchedUserStates[streamingUser.Id].State == SpectatedUserState.Playing);
         }
 
         [Test]
@@ -256,13 +256,13 @@ namespace osu.Game.Tests.Visual.Gameplay
             sendFrames();
             waitForPlayer();
 
-            AddStep("send passed", () => spectatorClient.EndPlay(streamingUser.Id, SpectatingUserState.Passed));
-            AddUntilStep("state is passed", () => spectatorClient.WatchingUserStates[streamingUser.Id].State == SpectatingUserState.Passed);
+            AddStep("send passed", () => spectatorClient.EndPlay(streamingUser.Id, SpectatedUserState.Passed));
+            AddUntilStep("state is passed", () => spectatorClient.WatchedUserStates[streamingUser.Id].State == SpectatedUserState.Passed);
 
             start();
             sendFrames();
             waitForPlayer();
-            AddUntilStep("state is playing", () => spectatorClient.WatchingUserStates[streamingUser.Id].State == SpectatingUserState.Playing);
+            AddUntilStep("state is playing", () => spectatorClient.WatchedUserStates[streamingUser.Id].State == SpectatedUserState.Playing);
         }
 
         [Test]
@@ -275,12 +275,12 @@ namespace osu.Game.Tests.Visual.Gameplay
             waitForPlayer();
 
             AddStep("send quit", () => spectatorClient.EndPlay(streamingUser.Id));
-            AddUntilStep("state is quit", () => spectatorClient.WatchingUserStates[streamingUser.Id].State == SpectatingUserState.Quit);
+            AddUntilStep("state is quit", () => spectatorClient.WatchedUserStates[streamingUser.Id].State == SpectatedUserState.Quit);
 
             start();
             sendFrames();
             waitForPlayer();
-            AddUntilStep("state is playing", () => spectatorClient.WatchingUserStates[streamingUser.Id].State == SpectatingUserState.Playing);
+            AddUntilStep("state is playing", () => spectatorClient.WatchedUserStates[streamingUser.Id].State == SpectatedUserState.Playing);
         }
 
         [Test]
@@ -292,13 +292,13 @@ namespace osu.Game.Tests.Visual.Gameplay
             sendFrames();
             waitForPlayer();
 
-            AddStep("send failed", () => spectatorClient.EndPlay(streamingUser.Id, SpectatingUserState.Failed));
-            AddUntilStep("state is failed", () => spectatorClient.WatchingUserStates[streamingUser.Id].State == SpectatingUserState.Failed);
+            AddStep("send failed", () => spectatorClient.EndPlay(streamingUser.Id, SpectatedUserState.Failed));
+            AddUntilStep("state is failed", () => spectatorClient.WatchedUserStates[streamingUser.Id].State == SpectatedUserState.Failed);
 
             start();
             sendFrames();
             waitForPlayer();
-            AddUntilStep("state is playing", () => spectatorClient.WatchingUserStates[streamingUser.Id].State == SpectatingUserState.Playing);
+            AddUntilStep("state is playing", () => spectatorClient.WatchedUserStates[streamingUser.Id].State == SpectatedUserState.Playing);
         }
 
         private OsuFramedReplayInputHandler replayHandler =>
@@ -313,7 +313,7 @@ namespace osu.Game.Tests.Visual.Gameplay
 
         private void start(int? beatmapId = null) => AddStep("start play", () => spectatorClient.StartPlay(streamingUser.Id, beatmapId ?? importedBeatmapId));
 
-        private void finish(SpectatingUserState state = SpectatingUserState.Quit) => AddStep("end play", () => spectatorClient.EndPlay(streamingUser.Id, state));
+        private void finish(SpectatedUserState state = SpectatedUserState.Quit) => AddStep("end play", () => spectatorClient.EndPlay(streamingUser.Id, state));
 
         private void checkPaused(bool state) =>
             AddUntilStep($"game is {(state ? "paused" : "playing")}", () => player.ChildrenOfType<DrawableRuleset>().First().IsPaused.Value == state);
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorHost.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorHost.cs
index 6d6b0bf89e..034519fbf8 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorHost.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorHost.cs
@@ -37,8 +37,8 @@ namespace osu.Game.Tests.Visual.Gameplay
         [Test]
         public void TestClientSendsCorrectRuleset()
         {
-            AddUntilStep("spectator client sending frames", () => spectatorClient.WatchingUserStates.ContainsKey(dummy_user_id));
-            AddAssert("spectator client sent correct ruleset", () => spectatorClient.WatchingUserStates[dummy_user_id].RulesetID == Ruleset.Value.OnlineID);
+            AddUntilStep("spectator client sending frames", () => spectatorClient.WatchedUserStates.ContainsKey(dummy_user_id));
+            AddAssert("spectator client sent correct ruleset", () => spectatorClient.WatchedUserStates[dummy_user_id].RulesetID == Ruleset.Value.OnlineID);
         }
 
         public override void TearDownSteps()
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs
index 55450b36e2..1322fbc96e 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs
@@ -115,7 +115,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             public void RandomlyUpdateState()
             {
-                foreach ((int userId, _) in WatchingUserStates)
+                foreach ((int userId, _) in WatchedUserStates)
                 {
                     if (RNG.NextBool())
                         continue;
diff --git a/osu.Game/Online/Spectator/SpectatingUserState.cs b/osu.Game/Online/Spectator/SpectatedUserState.cs
similarity index 90%
rename from osu.Game/Online/Spectator/SpectatingUserState.cs
rename to osu.Game/Online/Spectator/SpectatedUserState.cs
index e00c2e1947..0f0a3068b8 100644
--- a/osu.Game/Online/Spectator/SpectatingUserState.cs
+++ b/osu.Game/Online/Spectator/SpectatedUserState.cs
@@ -3,7 +3,7 @@
 
 namespace osu.Game.Online.Spectator
 {
-    public enum SpectatingUserState
+    public enum SpectatedUserState
     {
         /// <summary>
         /// The spectated user is not yet playing.
@@ -26,7 +26,7 @@ namespace osu.Game.Online.Spectator
         Passed,
 
         /// <summary>
-        /// The spectator user has failed gameplay.
+        /// The spectated user has failed gameplay.
         /// </summary>
         Failed,
 
diff --git a/osu.Game/Online/Spectator/SpectatorClient.cs b/osu.Game/Online/Spectator/SpectatorClient.cs
index ed6e355ddf..a54ea0d9ee 100644
--- a/osu.Game/Online/Spectator/SpectatorClient.cs
+++ b/osu.Game/Online/Spectator/SpectatorClient.cs
@@ -38,7 +38,7 @@ namespace osu.Game.Online.Spectator
         /// <summary>
         /// The states of all users currently being watched.
         /// </summary>
-        public IBindableDictionary<int, SpectatorState> WatchingUserStates => watchingUserStates;
+        public IBindableDictionary<int, SpectatorState> WatchedUserStates => watchedUserStates;
 
         /// <summary>
         /// A global list of all players currently playing.
@@ -48,9 +48,9 @@ namespace osu.Game.Online.Spectator
         /// <summary>
         /// All users currently being watched.
         /// </summary>
-        private readonly List<int> watchingUsers = new List<int>();
+        private readonly List<int> watchedUsers = new List<int>();
 
-        private readonly BindableDictionary<int, SpectatorState> watchingUserStates = new BindableDictionary<int, SpectatorState>();
+        private readonly BindableDictionary<int, SpectatorState> watchedUserStates = new BindableDictionary<int, SpectatorState>();
         private readonly BindableList<int> playingUsers = new BindableList<int>();
         private readonly SpectatorState currentState = new SpectatorState();
 
@@ -85,8 +85,8 @@ namespace osu.Game.Online.Spectator
                 if (connected.NewValue)
                 {
                     // get all the users that were previously being watched
-                    int[] users = watchingUsers.ToArray();
-                    watchingUsers.Clear();
+                    int[] users = watchedUsers.ToArray();
+                    watchedUsers.Clear();
 
                     // resubscribe to watched users.
                     foreach (int userId in users)
@@ -99,7 +99,7 @@ namespace osu.Game.Online.Spectator
                 else
                 {
                     playingUsers.Clear();
-                    watchingUserStates.Clear();
+                    watchedUserStates.Clear();
                 }
             }), true);
         }
@@ -111,8 +111,8 @@ namespace osu.Game.Online.Spectator
                 if (!playingUsers.Contains(userId))
                     playingUsers.Add(userId);
 
-                if (watchingUsers.Contains(userId))
-                    watchingUserStates[userId] = state;
+                if (watchedUsers.Contains(userId))
+                    watchedUserStates[userId] = state;
 
                 OnUserBeganPlaying?.Invoke(userId, state);
             });
@@ -126,8 +126,8 @@ namespace osu.Game.Online.Spectator
             {
                 playingUsers.Remove(userId);
 
-                if (watchingUsers.Contains(userId))
-                    watchingUserStates[userId] = state;
+                if (watchedUsers.Contains(userId))
+                    watchedUserStates[userId] = state;
 
                 OnUserFinishedPlaying?.Invoke(userId, state);
             });
@@ -159,7 +159,7 @@ namespace osu.Game.Online.Spectator
                 currentState.BeatmapID = score.ScoreInfo.BeatmapInfo.OnlineID;
                 currentState.RulesetID = score.ScoreInfo.RulesetID;
                 currentState.Mods = score.ScoreInfo.Mods.Select(m => new APIMod(m)).ToArray();
-                currentState.State = SpectatingUserState.Playing;
+                currentState.State = SpectatedUserState.Playing;
 
                 currentBeatmap = state.Beatmap;
                 currentScore = score;
@@ -186,11 +186,11 @@ namespace osu.Game.Online.Spectator
                 currentBeatmap = null;
 
                 if (state.HasPassed)
-                    currentState.State = SpectatingUserState.Passed;
+                    currentState.State = SpectatedUserState.Passed;
                 else if (state.HasFailed)
-                    currentState.State = SpectatingUserState.Failed;
+                    currentState.State = SpectatedUserState.Failed;
                 else
-                    currentState.State = SpectatingUserState.Quit;
+                    currentState.State = SpectatedUserState.Quit;
 
                 EndPlayingInternal(currentState);
             });
@@ -200,10 +200,10 @@ namespace osu.Game.Online.Spectator
         {
             Debug.Assert(ThreadSafety.IsUpdateThread);
 
-            if (watchingUsers.Contains(userId))
+            if (watchedUsers.Contains(userId))
                 return;
 
-            watchingUsers.Add(userId);
+            watchedUsers.Add(userId);
 
             WatchUserInternal(userId);
         }
@@ -214,8 +214,8 @@ namespace osu.Game.Online.Spectator
             // Todo: This should not be a thing, but requires framework changes.
             Schedule(() =>
             {
-                watchingUsers.Remove(userId);
-                watchingUserStates.Remove(userId);
+                watchedUsers.Remove(userId);
+                watchedUserStates.Remove(userId);
                 StopWatchingUserInternal(userId);
             });
         }
diff --git a/osu.Game/Online/Spectator/SpectatorState.cs b/osu.Game/Online/Spectator/SpectatorState.cs
index fc62f16bba..77686d12da 100644
--- a/osu.Game/Online/Spectator/SpectatorState.cs
+++ b/osu.Game/Online/Spectator/SpectatorState.cs
@@ -25,7 +25,7 @@ namespace osu.Game.Online.Spectator
         public IEnumerable<APIMod> Mods { get; set; } = Enumerable.Empty<APIMod>();
 
         [Key(3)]
-        public SpectatingUserState State { get; set; }
+        public SpectatedUserState State { get; set; }
 
         public bool Equals(SpectatorState other)
         {
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorScreen.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorScreen.cs
index 55df8301da..571b6b4324 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorScreen.cs
@@ -218,7 +218,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Spectate
         {
             // Allowed passed/failed users to complete their remaining replay frames.
             // The failed state isn't really possible in multiplayer (yet?) but is added here just for safety in case it starts being used.
-            if (state.State == SpectatingUserState.Passed || state.State == SpectatingUserState.Failed)
+            if (state.State == SpectatedUserState.Passed || state.State == SpectatedUserState.Failed)
                 return;
 
             RemoveUser(userId);
diff --git a/osu.Game/Screens/Spectate/SpectatorScreen.cs b/osu.Game/Screens/Spectate/SpectatorScreen.cs
index 394afb3a4c..9d0f8abddc 100644
--- a/osu.Game/Screens/Spectate/SpectatorScreen.cs
+++ b/osu.Game/Screens/Spectate/SpectatorScreen.cs
@@ -77,7 +77,7 @@ namespace osu.Game.Screens.Spectate
                     userMap[u.Id] = u;
                 }
 
-                userStates.BindTo(spectatorClient.WatchingUserStates);
+                userStates.BindTo(spectatorClient.WatchedUserStates);
                 userStates.BindCollectionChanged(onUserStatesChanged, true);
 
                 realmSubscription = realm.RegisterForNotifications(
@@ -134,13 +134,13 @@ namespace osu.Game.Screens.Spectate
 
             switch (newState.State)
             {
-                case SpectatingUserState.Passed:
+                case SpectatedUserState.Passed:
                     // Make sure that gameplay completes to the end.
                     if (gameplayStates.TryGetValue(userId, out var gameplayState))
                         gameplayState.Score.Replay.HasReceivedAllFrames = true;
                     break;
 
-                case SpectatingUserState.Playing:
+                case SpectatedUserState.Playing:
                     Schedule(() => OnUserStateChanged(userId, newState));
                     updateGameplayState(userId);
                     break;
diff --git a/osu.Game/Tests/Visual/Spectator/TestSpectatorClient.cs b/osu.Game/Tests/Visual/Spectator/TestSpectatorClient.cs
index 6862cda88c..1322a99ea7 100644
--- a/osu.Game/Tests/Visual/Spectator/TestSpectatorClient.cs
+++ b/osu.Game/Tests/Visual/Spectator/TestSpectatorClient.cs
@@ -59,7 +59,7 @@ namespace osu.Game.Tests.Visual.Spectator
         /// </summary>
         /// <param name="userId">The user to end play for.</param>
         /// <param name="state">The spectator state to end play with.</param>
-        public void EndPlay(int userId, SpectatingUserState state = SpectatingUserState.Quit)
+        public void EndPlay(int userId, SpectatedUserState state = SpectatedUserState.Quit)
         {
             if (!userBeatmapDictionary.ContainsKey(userId))
                 return;
@@ -144,7 +144,7 @@ namespace osu.Game.Tests.Visual.Spectator
             {
                 BeatmapID = userBeatmapDictionary[userId],
                 RulesetID = 0,
-                State = SpectatingUserState.Playing
+                State = SpectatedUserState.Playing
             });
         }
     }

From 18251c9285a559ac3f4070cdc8538211175e18ab Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 9 Feb 2022 12:20:07 +0900
Subject: [PATCH 2828/5547] Clean up SpectatorScreen based on suggestions

---
 .../Multiplayer/Spectate/MultiSpectatorScreen.cs     |  2 +-
 osu.Game/Screens/Play/SoloSpectator.cs               |  2 +-
 osu.Game/Screens/Spectate/SpectatorScreen.cs         | 12 ++++++------
 3 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorScreen.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorScreen.cs
index 571b6b4324..e5eeeb3448 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorScreen.cs
@@ -207,7 +207,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Spectate
             }
         }
 
-        protected override void OnUserStateChanged(int userId, SpectatorState spectatorState)
+        protected override void OnNewPlayingUserState(int userId, SpectatorState spectatorState)
         {
         }
 
diff --git a/osu.Game/Screens/Play/SoloSpectator.cs b/osu.Game/Screens/Play/SoloSpectator.cs
index a710db6d24..a0b07fcbd9 100644
--- a/osu.Game/Screens/Play/SoloSpectator.cs
+++ b/osu.Game/Screens/Play/SoloSpectator.cs
@@ -166,7 +166,7 @@ namespace osu.Game.Screens.Play
             automaticDownload.Current.BindValueChanged(_ => checkForAutomaticDownload());
         }
 
-        protected override void OnUserStateChanged(int userId, SpectatorState spectatorState)
+        protected override void OnNewPlayingUserState(int userId, SpectatorState spectatorState)
         {
             clearDisplay();
             showBeatmapPanel(spectatorState);
diff --git a/osu.Game/Screens/Spectate/SpectatorScreen.cs b/osu.Game/Screens/Spectate/SpectatorScreen.cs
index 9d0f8abddc..9eb374f0f7 100644
--- a/osu.Game/Screens/Spectate/SpectatorScreen.cs
+++ b/osu.Game/Screens/Spectate/SpectatorScreen.cs
@@ -103,7 +103,7 @@ namespace osu.Game.Screens.Spectate
                     continue;
 
                 if (beatmapSet.Beatmaps.Any(b => b.OnlineID == userState.BeatmapID))
-                    updateGameplayState(userId);
+                    startGameplay(userId);
             }
         }
 
@@ -141,8 +141,8 @@ namespace osu.Game.Screens.Spectate
                     break;
 
                 case SpectatedUserState.Playing:
-                    Schedule(() => OnUserStateChanged(userId, newState));
-                    updateGameplayState(userId);
+                    Schedule(() => OnNewPlayingUserState(userId, newState));
+                    startGameplay(userId);
                     break;
             }
         }
@@ -161,7 +161,7 @@ namespace osu.Game.Screens.Spectate
             Schedule(() => EndGameplay(userId, state));
         }
 
-        private void updateGameplayState(int userId)
+        private void startGameplay(int userId)
         {
             Debug.Assert(userMap.ContainsKey(userId));
 
@@ -195,11 +195,11 @@ namespace osu.Game.Screens.Spectate
         }
 
         /// <summary>
-        /// Invoked when a spectated user's state has changed.
+        /// Invoked when a spectated user's state has changed to a new state indicating the player is currently playing.
         /// </summary>
         /// <param name="userId">The user whose state has changed.</param>
         /// <param name="spectatorState">The new state.</param>
-        protected abstract void OnUserStateChanged(int userId, [NotNull] SpectatorState spectatorState);
+        protected abstract void OnNewPlayingUserState(int userId, [NotNull] SpectatorState spectatorState);
 
         /// <summary>
         /// Starts gameplay for a user.

From 1b8ada087d97ffdf8b62697a678ddaf8a8c4c654 Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Wed, 9 Feb 2022 19:25:51 +0800
Subject: [PATCH 2829/5547] Set `NoDefaultExcludes` to true

This allows files such as .editorconfig and .gitignore to be included in the nupkg
---
 Templates/osu.Game.Templates.csproj | 1 +
 1 file changed, 1 insertion(+)

diff --git a/Templates/osu.Game.Templates.csproj b/Templates/osu.Game.Templates.csproj
index 31a24a301f..4624d3d771 100644
--- a/Templates/osu.Game.Templates.csproj
+++ b/Templates/osu.Game.Templates.csproj
@@ -15,6 +15,7 @@
     <IncludeContentInPack>true</IncludeContentInPack>
     <IncludeBuildOutput>false</IncludeBuildOutput>
     <ContentTargetFolders>content</ContentTargetFolders>
+    <NoDefaultExcludes>true</NoDefaultExcludes>
   </PropertyGroup>
 
   <ItemGroup>

From f1c6fdb2afce097de6a636cfff97aef2b337e70f Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Wed, 9 Feb 2022 19:53:34 +0800
Subject: [PATCH 2830/5547] Update `.editorconfig`, `.gitignore` and
 DotSettings

Basically just copied from root directory
---
 .../Rulesets/ruleset-empty/.editorconfig      |  20 +--
 Templates/Rulesets/ruleset-empty/.gitignore   | 128 +++++++++++++-----
 ...ame.Rulesets.EmptyFreeform.sln.DotSettings |  83 +++++++++++-
 .../Rulesets/ruleset-example/.editorconfig    |  20 +--
 Templates/Rulesets/ruleset-example/.gitignore | 128 +++++++++++++-----
 ...osu.Game.Rulesets.Pippidon.sln.DotSettings |  83 +++++++++++-
 .../ruleset-scrolling-empty/.editorconfig     |  20 +--
 .../ruleset-scrolling-empty/.gitignore        | 128 +++++++++++++-----
 ...me.Rulesets.EmptyScrolling.sln.DotSettings |  83 +++++++++++-
 .../ruleset-scrolling-example/.editorconfig   |  20 +--
 .../ruleset-scrolling-example/.gitignore      | 128 +++++++++++++-----
 ...osu.Game.Rulesets.Pippidon.sln.DotSettings |  83 +++++++++++-
 12 files changed, 696 insertions(+), 228 deletions(-)

diff --git a/Templates/Rulesets/ruleset-empty/.editorconfig b/Templates/Rulesets/ruleset-empty/.editorconfig
index f3badda9b3..b01749195f 100644
--- a/Templates/Rulesets/ruleset-empty/.editorconfig
+++ b/Templates/Rulesets/ruleset-empty/.editorconfig
@@ -10,14 +10,6 @@ trim_trailing_whitespace = true
 
 #Roslyn naming styles
 
-#PascalCase for public and protected members
-dotnet_naming_style.pascalcase.capitalization = pascal_case
-dotnet_naming_symbols.public_members.applicable_accessibilities = public,internal,protected,protected_internal,private_protected
-dotnet_naming_symbols.public_members.applicable_kinds = property,method,field,event
-dotnet_naming_rule.public_members_pascalcase.severity = error
-dotnet_naming_rule.public_members_pascalcase.symbols = public_members
-dotnet_naming_rule.public_members_pascalcase.style = pascalcase
-
 #camelCase for private members
 dotnet_naming_style.camelcase.capitalization = camel_case
 
@@ -121,7 +113,7 @@ dotnet_style_qualification_for_event = false:warning
 dotnet_style_predefined_type_for_locals_parameters_members = true:warning
 dotnet_style_predefined_type_for_member_access = true:warning
 csharp_style_var_when_type_is_apparent = true:none
-csharp_style_var_for_built_in_types = true:none
+csharp_style_var_for_built_in_types = false:warning
 csharp_style_var_elsewhere = true:silent
 
 #Style - modifiers
@@ -165,7 +157,7 @@ csharp_style_unused_value_assignment_preference = discard_variable:warning
 
 #Style - variable declaration
 csharp_style_inlined_variable_declaration = true:warning
-csharp_style_deconstructed_variable_declaration = true:warning
+csharp_style_deconstructed_variable_declaration = false:silent
 
 #Style - other C# 7.x features
 dotnet_style_prefer_inferred_tuple_names = true:warning
@@ -176,8 +168,8 @@ dotnet_style_prefer_is_null_check_over_reference_equality_method = true:silent
 #Style - C# 8 features
 csharp_prefer_static_local_function = true:warning
 csharp_prefer_simple_using_statement = true:silent
-csharp_style_prefer_index_operator = true:warning
-csharp_style_prefer_range_operator = true:warning
+csharp_style_prefer_index_operator = false:silent
+csharp_style_prefer_range_operator = false:silent
 csharp_style_prefer_switch_expression = false:none
 
 #Supressing roslyn built-in analyzers
@@ -197,4 +189,6 @@ dotnet_diagnostic.IDE0069.severity = none
 dotnet_diagnostic.CA2225.severity = none
 
 # Banned APIs
-dotnet_diagnostic.RS0030.severity = error
\ No newline at end of file
+dotnet_diagnostic.RS0030.severity = error
+
+dotnet_diagnostic.OLOC001.license_header = // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.\n// See the LICENCE file in the repository root for full licence text.
diff --git a/Templates/Rulesets/ruleset-empty/.gitignore b/Templates/Rulesets/ruleset-empty/.gitignore
index 940794e60f..5b19270ab9 100644
--- a/Templates/Rulesets/ruleset-empty/.gitignore
+++ b/Templates/Rulesets/ruleset-empty/.gitignore
@@ -1,7 +1,5 @@
 ## Ignore Visual Studio temporary files, build results, and
 ## files generated by popular Visual Studio add-ons.
-##
-## Get latest from https://github.com/github/gitignore/blob/master/VisualStudio.gitignore
 
 # User-specific files
 *.suo
@@ -17,8 +15,6 @@
 [Dd]ebugPublic/
 [Rr]elease/
 [Rr]eleases/
-x64/
-x86/
 bld/
 [Bb]in/
 [Oo]bj/
@@ -42,11 +38,10 @@ TestResult.xml
 [Rr]eleasePS/
 dlldata.c
 
-# .NET Core
+# DNX
 project.lock.json
 project.fragment.lock.json
 artifacts/
-**/Properties/launchSettings.json
 
 *_i.c
 *_p.c
@@ -113,10 +108,6 @@ _TeamCity*
 # DotCover is a Code Coverage Tool
 *.dotCover
 
-# Visual Studio code coverage results
-*.coverage
-*.coveragexml
-
 # NCrunch
 _NCrunch_*
 .*crunch*.local.xml
@@ -166,7 +157,7 @@ PublishScripts/
 !**/packages/build/
 # Uncomment if necessary however generally it will be regenerated when needed
 #!**/packages/repositories.config
-# NuGet v3's project.json files produces more ignorable files
+# NuGet v3's project.json files produces more ignoreable files
 *.nuget.props
 *.nuget.targets
 
@@ -196,10 +187,11 @@ ClientBin/
 *~
 *.dbmdl
 *.dbproj.schemaview
-*.jfm
 *.pfx
 *.publishsettings
+node_modules/
 orleans.codegen.cs
+Resource.designer.cs
 
 # Since there are multiple workflows, uncomment next line to ignore bower_components
 # (https://github.com/github/gitignore/pull/1529#issuecomment-104372622)
@@ -219,7 +211,6 @@ UpgradeLog*.htm
 # SQL Server files
 *.mdf
 *.ldf
-*.ndf
 
 # Business Intelligence projects
 *.rdl.data
@@ -234,10 +225,6 @@ FakesAssemblies/
 
 # Node.js Tools for Visual Studio
 .ntvs_analysis.dat
-node_modules/
-
-# Typescript v1 declaration files
-typings/
 
 # Visual Studio 6 build log
 *.plg
@@ -245,9 +232,6 @@ typings/
 # Visual Studio 6 workspace options file
 *.opt
 
-# Visual Studio 6 auto-generated workspace file (contains which files were open etc.)
-*.vbw
-
 # Visual Studio LightSwitch build output
 **/*.HTMLClient/GeneratedArtifacts
 **/*.DesktopClient/GeneratedArtifacts
@@ -263,26 +247,96 @@ paket-files/
 # FAKE - F# Make
 .fake/
 
-# JetBrains Rider
-.idea/
-*.sln.iml
-
-# CodeRush
-.cr/
-
 # Python Tools for Visual Studio (PTVS)
 __pycache__/
 *.pyc
 
-# Cake - Uncomment if you are using it
-# tools/**
-# !tools/packages.config
+# Cake #
+/tools/**
+/build/tools/**
+/build/temp/**
 
-# Telerik's JustMock configuration file
-*.jmconfig
+# Covers JetBrains IDEs: IntelliJ, RubyMine, PhpStorm, AppCode, PyCharm, CLion, Android Studio and WebStorm
+# Reference: https://intellij-support.jetbrains.com/hc/en-us/articles/206544839
 
-# BizTalk build output
-*.btp.cs
-*.btm.cs
-*.odx.cs
-*.xsd.cs
+# User-specific stuff
+.idea/**/workspace.xml
+.idea/**/tasks.xml
+.idea/**/usage.statistics.xml
+.idea/**/dictionaries
+.idea/**/shelf
+
+# Generated files
+.idea/**/contentModel.xml
+
+# Sensitive or high-churn files
+.idea/**/dataSources/
+.idea/**/dataSources.ids
+.idea/**/dataSources.local.xml
+.idea/**/sqlDataSources.xml
+.idea/**/dynamic.xml
+.idea/**/uiDesigner.xml
+.idea/**/dbnavigator.xml
+
+# Gradle
+.idea/**/gradle.xml
+.idea/**/libraries
+
+# Gradle and Maven with auto-import
+# When using Gradle or Maven with auto-import, you should exclude module files,
+# since they will be recreated, and may cause churn.  Uncomment if using
+# auto-import.
+.idea/modules.xml
+.idea/*.iml
+.idea/modules
+*.iml
+*.ipr
+
+# CMake
+cmake-build-*/
+
+# Mongo Explorer plugin
+.idea/**/mongoSettings.xml
+
+# File-based project format
+*.iws
+
+# IntelliJ
+out/
+
+# mpeltonen/sbt-idea plugin
+.idea_modules/
+
+# JIRA plugin
+atlassian-ide-plugin.xml
+
+# Cursive Clojure plugin
+.idea/replstate.xml
+
+# Crashlytics plugin (for Android Studio and IntelliJ)
+com_crashlytics_export_strings.xml
+crashlytics.properties
+crashlytics-build.properties
+fabric.properties
+
+# Editor-based Rest Client
+.idea/httpRequests
+
+# Android studio 3.1+ serialized cache file
+.idea/caches/build_file_checksums.ser
+
+# fastlane
+fastlane/report.xml
+
+# inspectcode
+inspectcodereport.xml
+inspectcode
+
+# BenchmarkDotNet
+/BenchmarkDotNet.Artifacts
+
+*.GeneratedMSBuildEditorConfig.editorconfig
+
+# Fody (pulled in by Realm) - schema file
+FodyWeavers.xsd
+**/FodyWeavers.xml
diff --git a/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform.sln.DotSettings b/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform.sln.DotSettings
index aa8f8739c1..2ff0f4d30b 100644
--- a/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform.sln.DotSettings
+++ b/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform.sln.DotSettings
@@ -18,9 +18,10 @@
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=ArrangeTypeModifiers/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=AssignedValueIsNeverUsed/@EntryIndexedValue">HINT</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=AssignmentIsFullyDiscarded/@EntryIndexedValue">DO_NOT_SHOW</s:String>
-	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=AssignNullToNotNullAttribute/@EntryIndexedValue">HINT</s:String>
-	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=AutoPropertyCanBeMadeGetOnly_002EGlobal/@EntryIndexedValue">WARNING</s:String>
-	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=AutoPropertyCanBeMadeGetOnly_002ELocal/@EntryIndexedValue">WARNING</s:String>
+	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=AssignNullToNotNullAttribute/@EntryIndexedValue">WARNING</s:String>
+	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=AsyncVoidMethod/@EntryIndexedValue">WARNING</s:String>
+	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=AutoPropertyCanBeMadeGetOnly_002EGlobal/@EntryIndexedValue">HINT</s:String>
+	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=AutoPropertyCanBeMadeGetOnly_002ELocal/@EntryIndexedValue">HINT</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=BadAttributeBracketsSpaces/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=BadBracesSpaces/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=BadChildStatementIndent/@EntryIndexedValue">WARNING</s:String>
@@ -73,6 +74,7 @@
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=ConvertToLocalFunction/@EntryIndexedValue">HINT</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=ConvertToStaticClass/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=ConvertToUsingDeclaration/@EntryIndexedValue">HINT</s:String>
+	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=ConvertTypeCheckPatternToNullCheck/@EntryIndexedValue">DO_NOT_SHOW</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=DoubleNegationOperator/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=EmptyGeneralCatchClause/@EntryIndexedValue">DO_NOT_SHOW</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=EnforceDoWhileStatementBraces/@EntryIndexedValue">WARNING</s:String>
@@ -105,8 +107,9 @@
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=MemberCanBeProtected_002EGlobal/@EntryIndexedValue">HINT</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=MergeCastWithTypeCheck/@EntryIndexedValue">HINT</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=MergeConditionalExpression/@EntryIndexedValue">WARNING</s:String>
+	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=MergeIntoNegatedPattern/@EntryIndexedValue">DO_NOT_SHOW</s:String>
+	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=MergeIntoPattern/@EntryIndexedValue">DO_NOT_SHOW</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=MergeSequentialChecks/@EntryIndexedValue">WARNING</s:String>
-	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=MergeSequentialPatterns/@EntryIndexedValue">DO_NOT_SHOW</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=MethodHasAsyncOverload/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=MethodHasAsyncOverloadWithCancellation/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=MethodSupportsCancellation/@EntryIndexedValue">WARNING</s:String>
@@ -120,6 +123,7 @@
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=MultipleTypeMembersOnOneLine/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=NestedStringInterpolation/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=NotAccessedField_002EGlobal/@EntryIndexedValue">HINT</s:String>
+	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=NotOverriddenInSpecificCulture/@EntryIndexedValue">HINT</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=OutdentIsOffPrevLevel/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=ParameterHidesMember/@EntryIndexedValue">HINT</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=ParameterOnlyUsedForPreconditionCheck_002EGlobal/@EntryIndexedValue">HINT</s:String>
@@ -129,7 +133,7 @@
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=PossibleMultipleEnumeration/@EntryIndexedValue">HINT</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=PrivateVariableCanBeMadeReadonly/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=PublicConstructorInAbstractClass/@EntryIndexedValue">WARNING</s:String>
-	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=RedundantArgumentDefaultValue/@EntryIndexedValue">HINT</s:String>
+	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=RedundantArgumentDefaultValue/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=RedundantArrayCreationExpression/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=RedundantAttributeParentheses/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=RedundantAttributeUsageProperty/@EntryIndexedValue">WARNING</s:String>
@@ -204,8 +208,10 @@
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=StringLiteralTypo/@EntryIndexedValue">HINT</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=StringStartsWithIsCultureSpecific/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=StructCanBeMadeReadOnly/@EntryIndexedValue">WARNING</s:String>
-	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=SuggestVarOrType_005FBuiltInTypes/@EntryIndexedValue">DO_NOT_SHOW</s:String>
+	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=SuggestVarOrType_005FBuiltInTypes/@EntryIndexedValue">SUGGESTION</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=SuggestVarOrType_005FSimpleTypes/@EntryIndexedValue">DO_NOT_SHOW</s:String>
+	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=SuspiciousTypeConversion_002EGlobal/@EntryIndexedValue"></s:String>
+	<s:Boolean x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=SuspiciousTypeConversion_002EGlobal/@EntryIndexRemoved">True</s:Boolean>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=SwitchStatementMissingSomeCases/@EntryIndexedValue">DO_NOT_SHOW</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=TabsAndSpacesMismatch/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=TabsAreDisallowed/@EntryIndexedValue">WARNING</s:String>
@@ -226,6 +232,7 @@
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=UnusedType_002EGlobal/@EntryIndexedValue">HINT</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=UseAwaitUsing/@EntryIndexedValue">DO_NOT_SHOW</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=UseCollectionCountProperty/@EntryIndexedValue">WARNING</s:String>
+	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=UseConfigureAwaitFalseForAsyncDisposable/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=UseFormatSpecifierInFormatString/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=UseFormatSpecifierInInterpolation/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=UseIndexFromEndExpression/@EntryIndexedValue">WARNING</s:String>
@@ -298,15 +305,21 @@
 	<s:Boolean x:Key="/Default/CodeStyle/CodeFormatting/CSharpFormat/WRAP_BEFORE_BINARY_OPSIGN/@EntryValue">True</s:Boolean>
 	<s:Int64 x:Key="/Default/CodeStyle/CodeFormatting/CSharpFormat/WRAP_LIMIT/@EntryValue">200</s:Int64>
 	<s:String x:Key="/Default/CodeStyle/CodeFormatting/CSharpFormat/WRAP_OBJECT_AND_COLLECTION_INITIALIZER_STYLE/@EntryValue">CHOP_IF_LONG</s:String>
+	<s:String x:Key="/Default/CodeStyle/CSharpVarKeywordUsage/ForBuiltInTypes/@EntryValue">UseExplicitType</s:String>
+	<s:String x:Key="/Default/CodeStyle/CSharpVarKeywordUsage/ForOtherTypes/@EntryValue">UseVarWhenEvident</s:String>
+	<s:String x:Key="/Default/CodeStyle/CSharpVarKeywordUsage/ForSimpleTypes/@EntryValue">UseVarWhenEvident</s:String>
 	<s:Boolean x:Key="/Default/CodeStyle/EncapsulateField/MakeFieldPrivate/@EntryValue">False</s:Boolean>
 	<s:Boolean x:Key="/Default/CodeStyle/EncapsulateField/UseAutoProperty/@EntryValue">False</s:Boolean>
 	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/Abbreviations/=AABB/@EntryIndexedValue">AABB</s:String>
 	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/Abbreviations/=API/@EntryIndexedValue">API</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/=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>
 	<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/=HSV/@EntryIndexedValue">HSV</s:String>
 	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/Abbreviations/=HTML/@EntryIndexedValue">HTML</s:String>
 	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/Abbreviations/=HUD/@EntryIndexedValue">HUD</s:String>
 	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/Abbreviations/=ID/@EntryIndexedValue">ID</s:String>
@@ -909,26 +922,82 @@ private void load()
 {
 	$END$
 };</s:String>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=antiflow/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Beatmap/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=beatmaps/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Beatmapset/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=beatmap_0027s/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=bindable/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=bindables/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Catmull/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Clickthrough/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Closedness/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=crosshair/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Daycore/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Deserialise/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=deserialised/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Dimmable/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Disableable/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Drawables/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Failable/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=favourited/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Gamefield/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=gameplay/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Geki/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Hashable/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Hitnormal/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=hitobject/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=hitobjects/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Hitsound/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Hitsounded/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Hitsounds/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Judgeable/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Katu/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=keymods/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Kiai/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Kudosu/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Lazer/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Leaderboard/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Leaderboards/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=letterboxing/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=localisable/@EntryIndexedValue">True</s:Boolean>
+	<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/=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>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Playfield/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=playfields/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Poolable/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Preclicked/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=purgeable/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Rearrangeable/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=refetch/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=refetched/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Refilter/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Reinstantiation/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=resampler/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=romanisable/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Romanisation/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Romanised/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=ruleset/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=rulesets/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=ruleset_0027s/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Scorable/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=seeya/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Skinnable/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Snappable/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Soleily/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Spinnable/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Strongable/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Taiko/@EntryIndexedValue">True</s:Boolean>
-	<s:Boolean x:Key="/Default/UserDictionary/Words/=Unranked/@EntryIndexedValue">True</s:Boolean></wpf:ResourceDictionary>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=undim/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=undownloadable/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Unescaping/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Unhover/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Unhovered/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Unplayed/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Unproxy/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Unranked/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Zoomable/@EntryIndexedValue">True</s:Boolean></wpf:ResourceDictionary>
diff --git a/Templates/Rulesets/ruleset-example/.editorconfig b/Templates/Rulesets/ruleset-example/.editorconfig
index f3badda9b3..b01749195f 100644
--- a/Templates/Rulesets/ruleset-example/.editorconfig
+++ b/Templates/Rulesets/ruleset-example/.editorconfig
@@ -10,14 +10,6 @@ trim_trailing_whitespace = true
 
 #Roslyn naming styles
 
-#PascalCase for public and protected members
-dotnet_naming_style.pascalcase.capitalization = pascal_case
-dotnet_naming_symbols.public_members.applicable_accessibilities = public,internal,protected,protected_internal,private_protected
-dotnet_naming_symbols.public_members.applicable_kinds = property,method,field,event
-dotnet_naming_rule.public_members_pascalcase.severity = error
-dotnet_naming_rule.public_members_pascalcase.symbols = public_members
-dotnet_naming_rule.public_members_pascalcase.style = pascalcase
-
 #camelCase for private members
 dotnet_naming_style.camelcase.capitalization = camel_case
 
@@ -121,7 +113,7 @@ dotnet_style_qualification_for_event = false:warning
 dotnet_style_predefined_type_for_locals_parameters_members = true:warning
 dotnet_style_predefined_type_for_member_access = true:warning
 csharp_style_var_when_type_is_apparent = true:none
-csharp_style_var_for_built_in_types = true:none
+csharp_style_var_for_built_in_types = false:warning
 csharp_style_var_elsewhere = true:silent
 
 #Style - modifiers
@@ -165,7 +157,7 @@ csharp_style_unused_value_assignment_preference = discard_variable:warning
 
 #Style - variable declaration
 csharp_style_inlined_variable_declaration = true:warning
-csharp_style_deconstructed_variable_declaration = true:warning
+csharp_style_deconstructed_variable_declaration = false:silent
 
 #Style - other C# 7.x features
 dotnet_style_prefer_inferred_tuple_names = true:warning
@@ -176,8 +168,8 @@ dotnet_style_prefer_is_null_check_over_reference_equality_method = true:silent
 #Style - C# 8 features
 csharp_prefer_static_local_function = true:warning
 csharp_prefer_simple_using_statement = true:silent
-csharp_style_prefer_index_operator = true:warning
-csharp_style_prefer_range_operator = true:warning
+csharp_style_prefer_index_operator = false:silent
+csharp_style_prefer_range_operator = false:silent
 csharp_style_prefer_switch_expression = false:none
 
 #Supressing roslyn built-in analyzers
@@ -197,4 +189,6 @@ dotnet_diagnostic.IDE0069.severity = none
 dotnet_diagnostic.CA2225.severity = none
 
 # Banned APIs
-dotnet_diagnostic.RS0030.severity = error
\ No newline at end of file
+dotnet_diagnostic.RS0030.severity = error
+
+dotnet_diagnostic.OLOC001.license_header = // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.\n// See the LICENCE file in the repository root for full licence text.
diff --git a/Templates/Rulesets/ruleset-example/.gitignore b/Templates/Rulesets/ruleset-example/.gitignore
index 940794e60f..5b19270ab9 100644
--- a/Templates/Rulesets/ruleset-example/.gitignore
+++ b/Templates/Rulesets/ruleset-example/.gitignore
@@ -1,7 +1,5 @@
 ## Ignore Visual Studio temporary files, build results, and
 ## files generated by popular Visual Studio add-ons.
-##
-## Get latest from https://github.com/github/gitignore/blob/master/VisualStudio.gitignore
 
 # User-specific files
 *.suo
@@ -17,8 +15,6 @@
 [Dd]ebugPublic/
 [Rr]elease/
 [Rr]eleases/
-x64/
-x86/
 bld/
 [Bb]in/
 [Oo]bj/
@@ -42,11 +38,10 @@ TestResult.xml
 [Rr]eleasePS/
 dlldata.c
 
-# .NET Core
+# DNX
 project.lock.json
 project.fragment.lock.json
 artifacts/
-**/Properties/launchSettings.json
 
 *_i.c
 *_p.c
@@ -113,10 +108,6 @@ _TeamCity*
 # DotCover is a Code Coverage Tool
 *.dotCover
 
-# Visual Studio code coverage results
-*.coverage
-*.coveragexml
-
 # NCrunch
 _NCrunch_*
 .*crunch*.local.xml
@@ -166,7 +157,7 @@ PublishScripts/
 !**/packages/build/
 # Uncomment if necessary however generally it will be regenerated when needed
 #!**/packages/repositories.config
-# NuGet v3's project.json files produces more ignorable files
+# NuGet v3's project.json files produces more ignoreable files
 *.nuget.props
 *.nuget.targets
 
@@ -196,10 +187,11 @@ ClientBin/
 *~
 *.dbmdl
 *.dbproj.schemaview
-*.jfm
 *.pfx
 *.publishsettings
+node_modules/
 orleans.codegen.cs
+Resource.designer.cs
 
 # Since there are multiple workflows, uncomment next line to ignore bower_components
 # (https://github.com/github/gitignore/pull/1529#issuecomment-104372622)
@@ -219,7 +211,6 @@ UpgradeLog*.htm
 # SQL Server files
 *.mdf
 *.ldf
-*.ndf
 
 # Business Intelligence projects
 *.rdl.data
@@ -234,10 +225,6 @@ FakesAssemblies/
 
 # Node.js Tools for Visual Studio
 .ntvs_analysis.dat
-node_modules/
-
-# Typescript v1 declaration files
-typings/
 
 # Visual Studio 6 build log
 *.plg
@@ -245,9 +232,6 @@ typings/
 # Visual Studio 6 workspace options file
 *.opt
 
-# Visual Studio 6 auto-generated workspace file (contains which files were open etc.)
-*.vbw
-
 # Visual Studio LightSwitch build output
 **/*.HTMLClient/GeneratedArtifacts
 **/*.DesktopClient/GeneratedArtifacts
@@ -263,26 +247,96 @@ paket-files/
 # FAKE - F# Make
 .fake/
 
-# JetBrains Rider
-.idea/
-*.sln.iml
-
-# CodeRush
-.cr/
-
 # Python Tools for Visual Studio (PTVS)
 __pycache__/
 *.pyc
 
-# Cake - Uncomment if you are using it
-# tools/**
-# !tools/packages.config
+# Cake #
+/tools/**
+/build/tools/**
+/build/temp/**
 
-# Telerik's JustMock configuration file
-*.jmconfig
+# Covers JetBrains IDEs: IntelliJ, RubyMine, PhpStorm, AppCode, PyCharm, CLion, Android Studio and WebStorm
+# Reference: https://intellij-support.jetbrains.com/hc/en-us/articles/206544839
 
-# BizTalk build output
-*.btp.cs
-*.btm.cs
-*.odx.cs
-*.xsd.cs
+# User-specific stuff
+.idea/**/workspace.xml
+.idea/**/tasks.xml
+.idea/**/usage.statistics.xml
+.idea/**/dictionaries
+.idea/**/shelf
+
+# Generated files
+.idea/**/contentModel.xml
+
+# Sensitive or high-churn files
+.idea/**/dataSources/
+.idea/**/dataSources.ids
+.idea/**/dataSources.local.xml
+.idea/**/sqlDataSources.xml
+.idea/**/dynamic.xml
+.idea/**/uiDesigner.xml
+.idea/**/dbnavigator.xml
+
+# Gradle
+.idea/**/gradle.xml
+.idea/**/libraries
+
+# Gradle and Maven with auto-import
+# When using Gradle or Maven with auto-import, you should exclude module files,
+# since they will be recreated, and may cause churn.  Uncomment if using
+# auto-import.
+.idea/modules.xml
+.idea/*.iml
+.idea/modules
+*.iml
+*.ipr
+
+# CMake
+cmake-build-*/
+
+# Mongo Explorer plugin
+.idea/**/mongoSettings.xml
+
+# File-based project format
+*.iws
+
+# IntelliJ
+out/
+
+# mpeltonen/sbt-idea plugin
+.idea_modules/
+
+# JIRA plugin
+atlassian-ide-plugin.xml
+
+# Cursive Clojure plugin
+.idea/replstate.xml
+
+# Crashlytics plugin (for Android Studio and IntelliJ)
+com_crashlytics_export_strings.xml
+crashlytics.properties
+crashlytics-build.properties
+fabric.properties
+
+# Editor-based Rest Client
+.idea/httpRequests
+
+# Android studio 3.1+ serialized cache file
+.idea/caches/build_file_checksums.ser
+
+# fastlane
+fastlane/report.xml
+
+# inspectcode
+inspectcodereport.xml
+inspectcode
+
+# BenchmarkDotNet
+/BenchmarkDotNet.Artifacts
+
+*.GeneratedMSBuildEditorConfig.editorconfig
+
+# Fody (pulled in by Realm) - schema file
+FodyWeavers.xsd
+**/FodyWeavers.xml
diff --git a/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon.sln.DotSettings b/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon.sln.DotSettings
index aa8f8739c1..2ff0f4d30b 100644
--- a/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon.sln.DotSettings
+++ b/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon.sln.DotSettings
@@ -18,9 +18,10 @@
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=ArrangeTypeModifiers/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=AssignedValueIsNeverUsed/@EntryIndexedValue">HINT</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=AssignmentIsFullyDiscarded/@EntryIndexedValue">DO_NOT_SHOW</s:String>
-	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=AssignNullToNotNullAttribute/@EntryIndexedValue">HINT</s:String>
-	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=AutoPropertyCanBeMadeGetOnly_002EGlobal/@EntryIndexedValue">WARNING</s:String>
-	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=AutoPropertyCanBeMadeGetOnly_002ELocal/@EntryIndexedValue">WARNING</s:String>
+	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=AssignNullToNotNullAttribute/@EntryIndexedValue">WARNING</s:String>
+	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=AsyncVoidMethod/@EntryIndexedValue">WARNING</s:String>
+	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=AutoPropertyCanBeMadeGetOnly_002EGlobal/@EntryIndexedValue">HINT</s:String>
+	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=AutoPropertyCanBeMadeGetOnly_002ELocal/@EntryIndexedValue">HINT</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=BadAttributeBracketsSpaces/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=BadBracesSpaces/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=BadChildStatementIndent/@EntryIndexedValue">WARNING</s:String>
@@ -73,6 +74,7 @@
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=ConvertToLocalFunction/@EntryIndexedValue">HINT</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=ConvertToStaticClass/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=ConvertToUsingDeclaration/@EntryIndexedValue">HINT</s:String>
+	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=ConvertTypeCheckPatternToNullCheck/@EntryIndexedValue">DO_NOT_SHOW</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=DoubleNegationOperator/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=EmptyGeneralCatchClause/@EntryIndexedValue">DO_NOT_SHOW</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=EnforceDoWhileStatementBraces/@EntryIndexedValue">WARNING</s:String>
@@ -105,8 +107,9 @@
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=MemberCanBeProtected_002EGlobal/@EntryIndexedValue">HINT</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=MergeCastWithTypeCheck/@EntryIndexedValue">HINT</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=MergeConditionalExpression/@EntryIndexedValue">WARNING</s:String>
+	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=MergeIntoNegatedPattern/@EntryIndexedValue">DO_NOT_SHOW</s:String>
+	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=MergeIntoPattern/@EntryIndexedValue">DO_NOT_SHOW</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=MergeSequentialChecks/@EntryIndexedValue">WARNING</s:String>
-	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=MergeSequentialPatterns/@EntryIndexedValue">DO_NOT_SHOW</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=MethodHasAsyncOverload/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=MethodHasAsyncOverloadWithCancellation/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=MethodSupportsCancellation/@EntryIndexedValue">WARNING</s:String>
@@ -120,6 +123,7 @@
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=MultipleTypeMembersOnOneLine/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=NestedStringInterpolation/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=NotAccessedField_002EGlobal/@EntryIndexedValue">HINT</s:String>
+	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=NotOverriddenInSpecificCulture/@EntryIndexedValue">HINT</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=OutdentIsOffPrevLevel/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=ParameterHidesMember/@EntryIndexedValue">HINT</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=ParameterOnlyUsedForPreconditionCheck_002EGlobal/@EntryIndexedValue">HINT</s:String>
@@ -129,7 +133,7 @@
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=PossibleMultipleEnumeration/@EntryIndexedValue">HINT</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=PrivateVariableCanBeMadeReadonly/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=PublicConstructorInAbstractClass/@EntryIndexedValue">WARNING</s:String>
-	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=RedundantArgumentDefaultValue/@EntryIndexedValue">HINT</s:String>
+	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=RedundantArgumentDefaultValue/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=RedundantArrayCreationExpression/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=RedundantAttributeParentheses/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=RedundantAttributeUsageProperty/@EntryIndexedValue">WARNING</s:String>
@@ -204,8 +208,10 @@
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=StringLiteralTypo/@EntryIndexedValue">HINT</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=StringStartsWithIsCultureSpecific/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=StructCanBeMadeReadOnly/@EntryIndexedValue">WARNING</s:String>
-	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=SuggestVarOrType_005FBuiltInTypes/@EntryIndexedValue">DO_NOT_SHOW</s:String>
+	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=SuggestVarOrType_005FBuiltInTypes/@EntryIndexedValue">SUGGESTION</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=SuggestVarOrType_005FSimpleTypes/@EntryIndexedValue">DO_NOT_SHOW</s:String>
+	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=SuspiciousTypeConversion_002EGlobal/@EntryIndexedValue"></s:String>
+	<s:Boolean x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=SuspiciousTypeConversion_002EGlobal/@EntryIndexRemoved">True</s:Boolean>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=SwitchStatementMissingSomeCases/@EntryIndexedValue">DO_NOT_SHOW</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=TabsAndSpacesMismatch/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=TabsAreDisallowed/@EntryIndexedValue">WARNING</s:String>
@@ -226,6 +232,7 @@
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=UnusedType_002EGlobal/@EntryIndexedValue">HINT</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=UseAwaitUsing/@EntryIndexedValue">DO_NOT_SHOW</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=UseCollectionCountProperty/@EntryIndexedValue">WARNING</s:String>
+	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=UseConfigureAwaitFalseForAsyncDisposable/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=UseFormatSpecifierInFormatString/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=UseFormatSpecifierInInterpolation/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=UseIndexFromEndExpression/@EntryIndexedValue">WARNING</s:String>
@@ -298,15 +305,21 @@
 	<s:Boolean x:Key="/Default/CodeStyle/CodeFormatting/CSharpFormat/WRAP_BEFORE_BINARY_OPSIGN/@EntryValue">True</s:Boolean>
 	<s:Int64 x:Key="/Default/CodeStyle/CodeFormatting/CSharpFormat/WRAP_LIMIT/@EntryValue">200</s:Int64>
 	<s:String x:Key="/Default/CodeStyle/CodeFormatting/CSharpFormat/WRAP_OBJECT_AND_COLLECTION_INITIALIZER_STYLE/@EntryValue">CHOP_IF_LONG</s:String>
+	<s:String x:Key="/Default/CodeStyle/CSharpVarKeywordUsage/ForBuiltInTypes/@EntryValue">UseExplicitType</s:String>
+	<s:String x:Key="/Default/CodeStyle/CSharpVarKeywordUsage/ForOtherTypes/@EntryValue">UseVarWhenEvident</s:String>
+	<s:String x:Key="/Default/CodeStyle/CSharpVarKeywordUsage/ForSimpleTypes/@EntryValue">UseVarWhenEvident</s:String>
 	<s:Boolean x:Key="/Default/CodeStyle/EncapsulateField/MakeFieldPrivate/@EntryValue">False</s:Boolean>
 	<s:Boolean x:Key="/Default/CodeStyle/EncapsulateField/UseAutoProperty/@EntryValue">False</s:Boolean>
 	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/Abbreviations/=AABB/@EntryIndexedValue">AABB</s:String>
 	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/Abbreviations/=API/@EntryIndexedValue">API</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/=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>
 	<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/=HSV/@EntryIndexedValue">HSV</s:String>
 	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/Abbreviations/=HTML/@EntryIndexedValue">HTML</s:String>
 	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/Abbreviations/=HUD/@EntryIndexedValue">HUD</s:String>
 	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/Abbreviations/=ID/@EntryIndexedValue">ID</s:String>
@@ -909,26 +922,82 @@ private void load()
 {
 	$END$
 };</s:String>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=antiflow/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Beatmap/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=beatmaps/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Beatmapset/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=beatmap_0027s/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=bindable/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=bindables/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Catmull/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Clickthrough/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Closedness/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=crosshair/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Daycore/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Deserialise/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=deserialised/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Dimmable/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Disableable/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Drawables/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Failable/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=favourited/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Gamefield/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=gameplay/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Geki/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Hashable/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Hitnormal/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=hitobject/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=hitobjects/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Hitsound/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Hitsounded/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Hitsounds/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Judgeable/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Katu/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=keymods/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Kiai/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Kudosu/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Lazer/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Leaderboard/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Leaderboards/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=letterboxing/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=localisable/@EntryIndexedValue">True</s:Boolean>
+	<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/=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>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Playfield/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=playfields/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Poolable/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Preclicked/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=purgeable/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Rearrangeable/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=refetch/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=refetched/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Refilter/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Reinstantiation/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=resampler/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=romanisable/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Romanisation/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Romanised/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=ruleset/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=rulesets/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=ruleset_0027s/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Scorable/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=seeya/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Skinnable/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Snappable/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Soleily/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Spinnable/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Strongable/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Taiko/@EntryIndexedValue">True</s:Boolean>
-	<s:Boolean x:Key="/Default/UserDictionary/Words/=Unranked/@EntryIndexedValue">True</s:Boolean></wpf:ResourceDictionary>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=undim/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=undownloadable/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Unescaping/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Unhover/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Unhovered/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Unplayed/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Unproxy/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Unranked/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Zoomable/@EntryIndexedValue">True</s:Boolean></wpf:ResourceDictionary>
diff --git a/Templates/Rulesets/ruleset-scrolling-empty/.editorconfig b/Templates/Rulesets/ruleset-scrolling-empty/.editorconfig
index f3badda9b3..b01749195f 100644
--- a/Templates/Rulesets/ruleset-scrolling-empty/.editorconfig
+++ b/Templates/Rulesets/ruleset-scrolling-empty/.editorconfig
@@ -10,14 +10,6 @@ trim_trailing_whitespace = true
 
 #Roslyn naming styles
 
-#PascalCase for public and protected members
-dotnet_naming_style.pascalcase.capitalization = pascal_case
-dotnet_naming_symbols.public_members.applicable_accessibilities = public,internal,protected,protected_internal,private_protected
-dotnet_naming_symbols.public_members.applicable_kinds = property,method,field,event
-dotnet_naming_rule.public_members_pascalcase.severity = error
-dotnet_naming_rule.public_members_pascalcase.symbols = public_members
-dotnet_naming_rule.public_members_pascalcase.style = pascalcase
-
 #camelCase for private members
 dotnet_naming_style.camelcase.capitalization = camel_case
 
@@ -121,7 +113,7 @@ dotnet_style_qualification_for_event = false:warning
 dotnet_style_predefined_type_for_locals_parameters_members = true:warning
 dotnet_style_predefined_type_for_member_access = true:warning
 csharp_style_var_when_type_is_apparent = true:none
-csharp_style_var_for_built_in_types = true:none
+csharp_style_var_for_built_in_types = false:warning
 csharp_style_var_elsewhere = true:silent
 
 #Style - modifiers
@@ -165,7 +157,7 @@ csharp_style_unused_value_assignment_preference = discard_variable:warning
 
 #Style - variable declaration
 csharp_style_inlined_variable_declaration = true:warning
-csharp_style_deconstructed_variable_declaration = true:warning
+csharp_style_deconstructed_variable_declaration = false:silent
 
 #Style - other C# 7.x features
 dotnet_style_prefer_inferred_tuple_names = true:warning
@@ -176,8 +168,8 @@ dotnet_style_prefer_is_null_check_over_reference_equality_method = true:silent
 #Style - C# 8 features
 csharp_prefer_static_local_function = true:warning
 csharp_prefer_simple_using_statement = true:silent
-csharp_style_prefer_index_operator = true:warning
-csharp_style_prefer_range_operator = true:warning
+csharp_style_prefer_index_operator = false:silent
+csharp_style_prefer_range_operator = false:silent
 csharp_style_prefer_switch_expression = false:none
 
 #Supressing roslyn built-in analyzers
@@ -197,4 +189,6 @@ dotnet_diagnostic.IDE0069.severity = none
 dotnet_diagnostic.CA2225.severity = none
 
 # Banned APIs
-dotnet_diagnostic.RS0030.severity = error
\ No newline at end of file
+dotnet_diagnostic.RS0030.severity = error
+
+dotnet_diagnostic.OLOC001.license_header = // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.\n// See the LICENCE file in the repository root for full licence text.
diff --git a/Templates/Rulesets/ruleset-scrolling-empty/.gitignore b/Templates/Rulesets/ruleset-scrolling-empty/.gitignore
index 940794e60f..5b19270ab9 100644
--- a/Templates/Rulesets/ruleset-scrolling-empty/.gitignore
+++ b/Templates/Rulesets/ruleset-scrolling-empty/.gitignore
@@ -1,7 +1,5 @@
 ## Ignore Visual Studio temporary files, build results, and
 ## files generated by popular Visual Studio add-ons.
-##
-## Get latest from https://github.com/github/gitignore/blob/master/VisualStudio.gitignore
 
 # User-specific files
 *.suo
@@ -17,8 +15,6 @@
 [Dd]ebugPublic/
 [Rr]elease/
 [Rr]eleases/
-x64/
-x86/
 bld/
 [Bb]in/
 [Oo]bj/
@@ -42,11 +38,10 @@ TestResult.xml
 [Rr]eleasePS/
 dlldata.c
 
-# .NET Core
+# DNX
 project.lock.json
 project.fragment.lock.json
 artifacts/
-**/Properties/launchSettings.json
 
 *_i.c
 *_p.c
@@ -113,10 +108,6 @@ _TeamCity*
 # DotCover is a Code Coverage Tool
 *.dotCover
 
-# Visual Studio code coverage results
-*.coverage
-*.coveragexml
-
 # NCrunch
 _NCrunch_*
 .*crunch*.local.xml
@@ -166,7 +157,7 @@ PublishScripts/
 !**/packages/build/
 # Uncomment if necessary however generally it will be regenerated when needed
 #!**/packages/repositories.config
-# NuGet v3's project.json files produces more ignorable files
+# NuGet v3's project.json files produces more ignoreable files
 *.nuget.props
 *.nuget.targets
 
@@ -196,10 +187,11 @@ ClientBin/
 *~
 *.dbmdl
 *.dbproj.schemaview
-*.jfm
 *.pfx
 *.publishsettings
+node_modules/
 orleans.codegen.cs
+Resource.designer.cs
 
 # Since there are multiple workflows, uncomment next line to ignore bower_components
 # (https://github.com/github/gitignore/pull/1529#issuecomment-104372622)
@@ -219,7 +211,6 @@ UpgradeLog*.htm
 # SQL Server files
 *.mdf
 *.ldf
-*.ndf
 
 # Business Intelligence projects
 *.rdl.data
@@ -234,10 +225,6 @@ FakesAssemblies/
 
 # Node.js Tools for Visual Studio
 .ntvs_analysis.dat
-node_modules/
-
-# Typescript v1 declaration files
-typings/
 
 # Visual Studio 6 build log
 *.plg
@@ -245,9 +232,6 @@ typings/
 # Visual Studio 6 workspace options file
 *.opt
 
-# Visual Studio 6 auto-generated workspace file (contains which files were open etc.)
-*.vbw
-
 # Visual Studio LightSwitch build output
 **/*.HTMLClient/GeneratedArtifacts
 **/*.DesktopClient/GeneratedArtifacts
@@ -263,26 +247,96 @@ paket-files/
 # FAKE - F# Make
 .fake/
 
-# JetBrains Rider
-.idea/
-*.sln.iml
-
-# CodeRush
-.cr/
-
 # Python Tools for Visual Studio (PTVS)
 __pycache__/
 *.pyc
 
-# Cake - Uncomment if you are using it
-# tools/**
-# !tools/packages.config
+# Cake #
+/tools/**
+/build/tools/**
+/build/temp/**
 
-# Telerik's JustMock configuration file
-*.jmconfig
+# Covers JetBrains IDEs: IntelliJ, RubyMine, PhpStorm, AppCode, PyCharm, CLion, Android Studio and WebStorm
+# Reference: https://intellij-support.jetbrains.com/hc/en-us/articles/206544839
 
-# BizTalk build output
-*.btp.cs
-*.btm.cs
-*.odx.cs
-*.xsd.cs
+# User-specific stuff
+.idea/**/workspace.xml
+.idea/**/tasks.xml
+.idea/**/usage.statistics.xml
+.idea/**/dictionaries
+.idea/**/shelf
+
+# Generated files
+.idea/**/contentModel.xml
+
+# Sensitive or high-churn files
+.idea/**/dataSources/
+.idea/**/dataSources.ids
+.idea/**/dataSources.local.xml
+.idea/**/sqlDataSources.xml
+.idea/**/dynamic.xml
+.idea/**/uiDesigner.xml
+.idea/**/dbnavigator.xml
+
+# Gradle
+.idea/**/gradle.xml
+.idea/**/libraries
+
+# Gradle and Maven with auto-import
+# When using Gradle or Maven with auto-import, you should exclude module files,
+# since they will be recreated, and may cause churn.  Uncomment if using
+# auto-import.
+.idea/modules.xml
+.idea/*.iml
+.idea/modules
+*.iml
+*.ipr
+
+# CMake
+cmake-build-*/
+
+# Mongo Explorer plugin
+.idea/**/mongoSettings.xml
+
+# File-based project format
+*.iws
+
+# IntelliJ
+out/
+
+# mpeltonen/sbt-idea plugin
+.idea_modules/
+
+# JIRA plugin
+atlassian-ide-plugin.xml
+
+# Cursive Clojure plugin
+.idea/replstate.xml
+
+# Crashlytics plugin (for Android Studio and IntelliJ)
+com_crashlytics_export_strings.xml
+crashlytics.properties
+crashlytics-build.properties
+fabric.properties
+
+# Editor-based Rest Client
+.idea/httpRequests
+
+# Android studio 3.1+ serialized cache file
+.idea/caches/build_file_checksums.ser
+
+# fastlane
+fastlane/report.xml
+
+# inspectcode
+inspectcodereport.xml
+inspectcode
+
+# BenchmarkDotNet
+/BenchmarkDotNet.Artifacts
+
+*.GeneratedMSBuildEditorConfig.editorconfig
+
+# Fody (pulled in by Realm) - schema file
+FodyWeavers.xsd
+**/FodyWeavers.xml
diff --git a/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling.sln.DotSettings b/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling.sln.DotSettings
index aa8f8739c1..2ff0f4d30b 100644
--- a/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling.sln.DotSettings
+++ b/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling.sln.DotSettings
@@ -18,9 +18,10 @@
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=ArrangeTypeModifiers/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=AssignedValueIsNeverUsed/@EntryIndexedValue">HINT</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=AssignmentIsFullyDiscarded/@EntryIndexedValue">DO_NOT_SHOW</s:String>
-	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=AssignNullToNotNullAttribute/@EntryIndexedValue">HINT</s:String>
-	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=AutoPropertyCanBeMadeGetOnly_002EGlobal/@EntryIndexedValue">WARNING</s:String>
-	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=AutoPropertyCanBeMadeGetOnly_002ELocal/@EntryIndexedValue">WARNING</s:String>
+	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=AssignNullToNotNullAttribute/@EntryIndexedValue">WARNING</s:String>
+	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=AsyncVoidMethod/@EntryIndexedValue">WARNING</s:String>
+	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=AutoPropertyCanBeMadeGetOnly_002EGlobal/@EntryIndexedValue">HINT</s:String>
+	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=AutoPropertyCanBeMadeGetOnly_002ELocal/@EntryIndexedValue">HINT</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=BadAttributeBracketsSpaces/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=BadBracesSpaces/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=BadChildStatementIndent/@EntryIndexedValue">WARNING</s:String>
@@ -73,6 +74,7 @@
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=ConvertToLocalFunction/@EntryIndexedValue">HINT</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=ConvertToStaticClass/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=ConvertToUsingDeclaration/@EntryIndexedValue">HINT</s:String>
+	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=ConvertTypeCheckPatternToNullCheck/@EntryIndexedValue">DO_NOT_SHOW</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=DoubleNegationOperator/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=EmptyGeneralCatchClause/@EntryIndexedValue">DO_NOT_SHOW</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=EnforceDoWhileStatementBraces/@EntryIndexedValue">WARNING</s:String>
@@ -105,8 +107,9 @@
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=MemberCanBeProtected_002EGlobal/@EntryIndexedValue">HINT</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=MergeCastWithTypeCheck/@EntryIndexedValue">HINT</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=MergeConditionalExpression/@EntryIndexedValue">WARNING</s:String>
+	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=MergeIntoNegatedPattern/@EntryIndexedValue">DO_NOT_SHOW</s:String>
+	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=MergeIntoPattern/@EntryIndexedValue">DO_NOT_SHOW</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=MergeSequentialChecks/@EntryIndexedValue">WARNING</s:String>
-	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=MergeSequentialPatterns/@EntryIndexedValue">DO_NOT_SHOW</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=MethodHasAsyncOverload/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=MethodHasAsyncOverloadWithCancellation/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=MethodSupportsCancellation/@EntryIndexedValue">WARNING</s:String>
@@ -120,6 +123,7 @@
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=MultipleTypeMembersOnOneLine/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=NestedStringInterpolation/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=NotAccessedField_002EGlobal/@EntryIndexedValue">HINT</s:String>
+	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=NotOverriddenInSpecificCulture/@EntryIndexedValue">HINT</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=OutdentIsOffPrevLevel/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=ParameterHidesMember/@EntryIndexedValue">HINT</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=ParameterOnlyUsedForPreconditionCheck_002EGlobal/@EntryIndexedValue">HINT</s:String>
@@ -129,7 +133,7 @@
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=PossibleMultipleEnumeration/@EntryIndexedValue">HINT</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=PrivateVariableCanBeMadeReadonly/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=PublicConstructorInAbstractClass/@EntryIndexedValue">WARNING</s:String>
-	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=RedundantArgumentDefaultValue/@EntryIndexedValue">HINT</s:String>
+	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=RedundantArgumentDefaultValue/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=RedundantArrayCreationExpression/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=RedundantAttributeParentheses/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=RedundantAttributeUsageProperty/@EntryIndexedValue">WARNING</s:String>
@@ -204,8 +208,10 @@
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=StringLiteralTypo/@EntryIndexedValue">HINT</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=StringStartsWithIsCultureSpecific/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=StructCanBeMadeReadOnly/@EntryIndexedValue">WARNING</s:String>
-	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=SuggestVarOrType_005FBuiltInTypes/@EntryIndexedValue">DO_NOT_SHOW</s:String>
+	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=SuggestVarOrType_005FBuiltInTypes/@EntryIndexedValue">SUGGESTION</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=SuggestVarOrType_005FSimpleTypes/@EntryIndexedValue">DO_NOT_SHOW</s:String>
+	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=SuspiciousTypeConversion_002EGlobal/@EntryIndexedValue"></s:String>
+	<s:Boolean x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=SuspiciousTypeConversion_002EGlobal/@EntryIndexRemoved">True</s:Boolean>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=SwitchStatementMissingSomeCases/@EntryIndexedValue">DO_NOT_SHOW</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=TabsAndSpacesMismatch/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=TabsAreDisallowed/@EntryIndexedValue">WARNING</s:String>
@@ -226,6 +232,7 @@
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=UnusedType_002EGlobal/@EntryIndexedValue">HINT</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=UseAwaitUsing/@EntryIndexedValue">DO_NOT_SHOW</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=UseCollectionCountProperty/@EntryIndexedValue">WARNING</s:String>
+	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=UseConfigureAwaitFalseForAsyncDisposable/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=UseFormatSpecifierInFormatString/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=UseFormatSpecifierInInterpolation/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=UseIndexFromEndExpression/@EntryIndexedValue">WARNING</s:String>
@@ -298,15 +305,21 @@
 	<s:Boolean x:Key="/Default/CodeStyle/CodeFormatting/CSharpFormat/WRAP_BEFORE_BINARY_OPSIGN/@EntryValue">True</s:Boolean>
 	<s:Int64 x:Key="/Default/CodeStyle/CodeFormatting/CSharpFormat/WRAP_LIMIT/@EntryValue">200</s:Int64>
 	<s:String x:Key="/Default/CodeStyle/CodeFormatting/CSharpFormat/WRAP_OBJECT_AND_COLLECTION_INITIALIZER_STYLE/@EntryValue">CHOP_IF_LONG</s:String>
+	<s:String x:Key="/Default/CodeStyle/CSharpVarKeywordUsage/ForBuiltInTypes/@EntryValue">UseExplicitType</s:String>
+	<s:String x:Key="/Default/CodeStyle/CSharpVarKeywordUsage/ForOtherTypes/@EntryValue">UseVarWhenEvident</s:String>
+	<s:String x:Key="/Default/CodeStyle/CSharpVarKeywordUsage/ForSimpleTypes/@EntryValue">UseVarWhenEvident</s:String>
 	<s:Boolean x:Key="/Default/CodeStyle/EncapsulateField/MakeFieldPrivate/@EntryValue">False</s:Boolean>
 	<s:Boolean x:Key="/Default/CodeStyle/EncapsulateField/UseAutoProperty/@EntryValue">False</s:Boolean>
 	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/Abbreviations/=AABB/@EntryIndexedValue">AABB</s:String>
 	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/Abbreviations/=API/@EntryIndexedValue">API</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/=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>
 	<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/=HSV/@EntryIndexedValue">HSV</s:String>
 	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/Abbreviations/=HTML/@EntryIndexedValue">HTML</s:String>
 	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/Abbreviations/=HUD/@EntryIndexedValue">HUD</s:String>
 	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/Abbreviations/=ID/@EntryIndexedValue">ID</s:String>
@@ -909,26 +922,82 @@ private void load()
 {
 	$END$
 };</s:String>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=antiflow/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Beatmap/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=beatmaps/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Beatmapset/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=beatmap_0027s/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=bindable/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=bindables/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Catmull/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Clickthrough/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Closedness/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=crosshair/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Daycore/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Deserialise/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=deserialised/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Dimmable/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Disableable/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Drawables/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Failable/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=favourited/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Gamefield/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=gameplay/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Geki/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Hashable/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Hitnormal/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=hitobject/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=hitobjects/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Hitsound/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Hitsounded/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Hitsounds/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Judgeable/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Katu/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=keymods/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Kiai/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Kudosu/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Lazer/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Leaderboard/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Leaderboards/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=letterboxing/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=localisable/@EntryIndexedValue">True</s:Boolean>
+	<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/=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>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Playfield/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=playfields/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Poolable/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Preclicked/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=purgeable/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Rearrangeable/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=refetch/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=refetched/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Refilter/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Reinstantiation/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=resampler/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=romanisable/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Romanisation/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Romanised/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=ruleset/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=rulesets/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=ruleset_0027s/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Scorable/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=seeya/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Skinnable/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Snappable/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Soleily/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Spinnable/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Strongable/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Taiko/@EntryIndexedValue">True</s:Boolean>
-	<s:Boolean x:Key="/Default/UserDictionary/Words/=Unranked/@EntryIndexedValue">True</s:Boolean></wpf:ResourceDictionary>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=undim/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=undownloadable/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Unescaping/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Unhover/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Unhovered/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Unplayed/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Unproxy/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Unranked/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Zoomable/@EntryIndexedValue">True</s:Boolean></wpf:ResourceDictionary>
diff --git a/Templates/Rulesets/ruleset-scrolling-example/.editorconfig b/Templates/Rulesets/ruleset-scrolling-example/.editorconfig
index f3badda9b3..b01749195f 100644
--- a/Templates/Rulesets/ruleset-scrolling-example/.editorconfig
+++ b/Templates/Rulesets/ruleset-scrolling-example/.editorconfig
@@ -10,14 +10,6 @@ trim_trailing_whitespace = true
 
 #Roslyn naming styles
 
-#PascalCase for public and protected members
-dotnet_naming_style.pascalcase.capitalization = pascal_case
-dotnet_naming_symbols.public_members.applicable_accessibilities = public,internal,protected,protected_internal,private_protected
-dotnet_naming_symbols.public_members.applicable_kinds = property,method,field,event
-dotnet_naming_rule.public_members_pascalcase.severity = error
-dotnet_naming_rule.public_members_pascalcase.symbols = public_members
-dotnet_naming_rule.public_members_pascalcase.style = pascalcase
-
 #camelCase for private members
 dotnet_naming_style.camelcase.capitalization = camel_case
 
@@ -121,7 +113,7 @@ dotnet_style_qualification_for_event = false:warning
 dotnet_style_predefined_type_for_locals_parameters_members = true:warning
 dotnet_style_predefined_type_for_member_access = true:warning
 csharp_style_var_when_type_is_apparent = true:none
-csharp_style_var_for_built_in_types = true:none
+csharp_style_var_for_built_in_types = false:warning
 csharp_style_var_elsewhere = true:silent
 
 #Style - modifiers
@@ -165,7 +157,7 @@ csharp_style_unused_value_assignment_preference = discard_variable:warning
 
 #Style - variable declaration
 csharp_style_inlined_variable_declaration = true:warning
-csharp_style_deconstructed_variable_declaration = true:warning
+csharp_style_deconstructed_variable_declaration = false:silent
 
 #Style - other C# 7.x features
 dotnet_style_prefer_inferred_tuple_names = true:warning
@@ -176,8 +168,8 @@ dotnet_style_prefer_is_null_check_over_reference_equality_method = true:silent
 #Style - C# 8 features
 csharp_prefer_static_local_function = true:warning
 csharp_prefer_simple_using_statement = true:silent
-csharp_style_prefer_index_operator = true:warning
-csharp_style_prefer_range_operator = true:warning
+csharp_style_prefer_index_operator = false:silent
+csharp_style_prefer_range_operator = false:silent
 csharp_style_prefer_switch_expression = false:none
 
 #Supressing roslyn built-in analyzers
@@ -197,4 +189,6 @@ dotnet_diagnostic.IDE0069.severity = none
 dotnet_diagnostic.CA2225.severity = none
 
 # Banned APIs
-dotnet_diagnostic.RS0030.severity = error
\ No newline at end of file
+dotnet_diagnostic.RS0030.severity = error
+
+dotnet_diagnostic.OLOC001.license_header = // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.\n// See the LICENCE file in the repository root for full licence text.
diff --git a/Templates/Rulesets/ruleset-scrolling-example/.gitignore b/Templates/Rulesets/ruleset-scrolling-example/.gitignore
index 940794e60f..5b19270ab9 100644
--- a/Templates/Rulesets/ruleset-scrolling-example/.gitignore
+++ b/Templates/Rulesets/ruleset-scrolling-example/.gitignore
@@ -1,7 +1,5 @@
 ## Ignore Visual Studio temporary files, build results, and
 ## files generated by popular Visual Studio add-ons.
-##
-## Get latest from https://github.com/github/gitignore/blob/master/VisualStudio.gitignore
 
 # User-specific files
 *.suo
@@ -17,8 +15,6 @@
 [Dd]ebugPublic/
 [Rr]elease/
 [Rr]eleases/
-x64/
-x86/
 bld/
 [Bb]in/
 [Oo]bj/
@@ -42,11 +38,10 @@ TestResult.xml
 [Rr]eleasePS/
 dlldata.c
 
-# .NET Core
+# DNX
 project.lock.json
 project.fragment.lock.json
 artifacts/
-**/Properties/launchSettings.json
 
 *_i.c
 *_p.c
@@ -113,10 +108,6 @@ _TeamCity*
 # DotCover is a Code Coverage Tool
 *.dotCover
 
-# Visual Studio code coverage results
-*.coverage
-*.coveragexml
-
 # NCrunch
 _NCrunch_*
 .*crunch*.local.xml
@@ -166,7 +157,7 @@ PublishScripts/
 !**/packages/build/
 # Uncomment if necessary however generally it will be regenerated when needed
 #!**/packages/repositories.config
-# NuGet v3's project.json files produces more ignorable files
+# NuGet v3's project.json files produces more ignoreable files
 *.nuget.props
 *.nuget.targets
 
@@ -196,10 +187,11 @@ ClientBin/
 *~
 *.dbmdl
 *.dbproj.schemaview
-*.jfm
 *.pfx
 *.publishsettings
+node_modules/
 orleans.codegen.cs
+Resource.designer.cs
 
 # Since there are multiple workflows, uncomment next line to ignore bower_components
 # (https://github.com/github/gitignore/pull/1529#issuecomment-104372622)
@@ -219,7 +211,6 @@ UpgradeLog*.htm
 # SQL Server files
 *.mdf
 *.ldf
-*.ndf
 
 # Business Intelligence projects
 *.rdl.data
@@ -234,10 +225,6 @@ FakesAssemblies/
 
 # Node.js Tools for Visual Studio
 .ntvs_analysis.dat
-node_modules/
-
-# Typescript v1 declaration files
-typings/
 
 # Visual Studio 6 build log
 *.plg
@@ -245,9 +232,6 @@ typings/
 # Visual Studio 6 workspace options file
 *.opt
 
-# Visual Studio 6 auto-generated workspace file (contains which files were open etc.)
-*.vbw
-
 # Visual Studio LightSwitch build output
 **/*.HTMLClient/GeneratedArtifacts
 **/*.DesktopClient/GeneratedArtifacts
@@ -263,26 +247,96 @@ paket-files/
 # FAKE - F# Make
 .fake/
 
-# JetBrains Rider
-.idea/
-*.sln.iml
-
-# CodeRush
-.cr/
-
 # Python Tools for Visual Studio (PTVS)
 __pycache__/
 *.pyc
 
-# Cake - Uncomment if you are using it
-# tools/**
-# !tools/packages.config
+# Cake #
+/tools/**
+/build/tools/**
+/build/temp/**
 
-# Telerik's JustMock configuration file
-*.jmconfig
+# Covers JetBrains IDEs: IntelliJ, RubyMine, PhpStorm, AppCode, PyCharm, CLion, Android Studio and WebStorm
+# Reference: https://intellij-support.jetbrains.com/hc/en-us/articles/206544839
 
-# BizTalk build output
-*.btp.cs
-*.btm.cs
-*.odx.cs
-*.xsd.cs
+# User-specific stuff
+.idea/**/workspace.xml
+.idea/**/tasks.xml
+.idea/**/usage.statistics.xml
+.idea/**/dictionaries
+.idea/**/shelf
+
+# Generated files
+.idea/**/contentModel.xml
+
+# Sensitive or high-churn files
+.idea/**/dataSources/
+.idea/**/dataSources.ids
+.idea/**/dataSources.local.xml
+.idea/**/sqlDataSources.xml
+.idea/**/dynamic.xml
+.idea/**/uiDesigner.xml
+.idea/**/dbnavigator.xml
+
+# Gradle
+.idea/**/gradle.xml
+.idea/**/libraries
+
+# Gradle and Maven with auto-import
+# When using Gradle or Maven with auto-import, you should exclude module files,
+# since they will be recreated, and may cause churn.  Uncomment if using
+# auto-import.
+.idea/modules.xml
+.idea/*.iml
+.idea/modules
+*.iml
+*.ipr
+
+# CMake
+cmake-build-*/
+
+# Mongo Explorer plugin
+.idea/**/mongoSettings.xml
+
+# File-based project format
+*.iws
+
+# IntelliJ
+out/
+
+# mpeltonen/sbt-idea plugin
+.idea_modules/
+
+# JIRA plugin
+atlassian-ide-plugin.xml
+
+# Cursive Clojure plugin
+.idea/replstate.xml
+
+# Crashlytics plugin (for Android Studio and IntelliJ)
+com_crashlytics_export_strings.xml
+crashlytics.properties
+crashlytics-build.properties
+fabric.properties
+
+# Editor-based Rest Client
+.idea/httpRequests
+
+# Android studio 3.1+ serialized cache file
+.idea/caches/build_file_checksums.ser
+
+# fastlane
+fastlane/report.xml
+
+# inspectcode
+inspectcodereport.xml
+inspectcode
+
+# BenchmarkDotNet
+/BenchmarkDotNet.Artifacts
+
+*.GeneratedMSBuildEditorConfig.editorconfig
+
+# Fody (pulled in by Realm) - schema file
+FodyWeavers.xsd
+**/FodyWeavers.xml
diff --git a/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon.sln.DotSettings b/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon.sln.DotSettings
index aa8f8739c1..2ff0f4d30b 100644
--- a/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon.sln.DotSettings
+++ b/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon.sln.DotSettings
@@ -18,9 +18,10 @@
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=ArrangeTypeModifiers/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=AssignedValueIsNeverUsed/@EntryIndexedValue">HINT</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=AssignmentIsFullyDiscarded/@EntryIndexedValue">DO_NOT_SHOW</s:String>
-	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=AssignNullToNotNullAttribute/@EntryIndexedValue">HINT</s:String>
-	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=AutoPropertyCanBeMadeGetOnly_002EGlobal/@EntryIndexedValue">WARNING</s:String>
-	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=AutoPropertyCanBeMadeGetOnly_002ELocal/@EntryIndexedValue">WARNING</s:String>
+	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=AssignNullToNotNullAttribute/@EntryIndexedValue">WARNING</s:String>
+	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=AsyncVoidMethod/@EntryIndexedValue">WARNING</s:String>
+	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=AutoPropertyCanBeMadeGetOnly_002EGlobal/@EntryIndexedValue">HINT</s:String>
+	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=AutoPropertyCanBeMadeGetOnly_002ELocal/@EntryIndexedValue">HINT</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=BadAttributeBracketsSpaces/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=BadBracesSpaces/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=BadChildStatementIndent/@EntryIndexedValue">WARNING</s:String>
@@ -73,6 +74,7 @@
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=ConvertToLocalFunction/@EntryIndexedValue">HINT</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=ConvertToStaticClass/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=ConvertToUsingDeclaration/@EntryIndexedValue">HINT</s:String>
+	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=ConvertTypeCheckPatternToNullCheck/@EntryIndexedValue">DO_NOT_SHOW</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=DoubleNegationOperator/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=EmptyGeneralCatchClause/@EntryIndexedValue">DO_NOT_SHOW</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=EnforceDoWhileStatementBraces/@EntryIndexedValue">WARNING</s:String>
@@ -105,8 +107,9 @@
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=MemberCanBeProtected_002EGlobal/@EntryIndexedValue">HINT</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=MergeCastWithTypeCheck/@EntryIndexedValue">HINT</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=MergeConditionalExpression/@EntryIndexedValue">WARNING</s:String>
+	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=MergeIntoNegatedPattern/@EntryIndexedValue">DO_NOT_SHOW</s:String>
+	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=MergeIntoPattern/@EntryIndexedValue">DO_NOT_SHOW</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=MergeSequentialChecks/@EntryIndexedValue">WARNING</s:String>
-	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=MergeSequentialPatterns/@EntryIndexedValue">DO_NOT_SHOW</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=MethodHasAsyncOverload/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=MethodHasAsyncOverloadWithCancellation/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=MethodSupportsCancellation/@EntryIndexedValue">WARNING</s:String>
@@ -120,6 +123,7 @@
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=MultipleTypeMembersOnOneLine/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=NestedStringInterpolation/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=NotAccessedField_002EGlobal/@EntryIndexedValue">HINT</s:String>
+	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=NotOverriddenInSpecificCulture/@EntryIndexedValue">HINT</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=OutdentIsOffPrevLevel/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=ParameterHidesMember/@EntryIndexedValue">HINT</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=ParameterOnlyUsedForPreconditionCheck_002EGlobal/@EntryIndexedValue">HINT</s:String>
@@ -129,7 +133,7 @@
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=PossibleMultipleEnumeration/@EntryIndexedValue">HINT</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=PrivateVariableCanBeMadeReadonly/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=PublicConstructorInAbstractClass/@EntryIndexedValue">WARNING</s:String>
-	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=RedundantArgumentDefaultValue/@EntryIndexedValue">HINT</s:String>
+	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=RedundantArgumentDefaultValue/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=RedundantArrayCreationExpression/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=RedundantAttributeParentheses/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=RedundantAttributeUsageProperty/@EntryIndexedValue">WARNING</s:String>
@@ -204,8 +208,10 @@
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=StringLiteralTypo/@EntryIndexedValue">HINT</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=StringStartsWithIsCultureSpecific/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=StructCanBeMadeReadOnly/@EntryIndexedValue">WARNING</s:String>
-	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=SuggestVarOrType_005FBuiltInTypes/@EntryIndexedValue">DO_NOT_SHOW</s:String>
+	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=SuggestVarOrType_005FBuiltInTypes/@EntryIndexedValue">SUGGESTION</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=SuggestVarOrType_005FSimpleTypes/@EntryIndexedValue">DO_NOT_SHOW</s:String>
+	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=SuspiciousTypeConversion_002EGlobal/@EntryIndexedValue"></s:String>
+	<s:Boolean x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=SuspiciousTypeConversion_002EGlobal/@EntryIndexRemoved">True</s:Boolean>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=SwitchStatementMissingSomeCases/@EntryIndexedValue">DO_NOT_SHOW</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=TabsAndSpacesMismatch/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=TabsAreDisallowed/@EntryIndexedValue">WARNING</s:String>
@@ -226,6 +232,7 @@
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=UnusedType_002EGlobal/@EntryIndexedValue">HINT</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=UseAwaitUsing/@EntryIndexedValue">DO_NOT_SHOW</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=UseCollectionCountProperty/@EntryIndexedValue">WARNING</s:String>
+	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=UseConfigureAwaitFalseForAsyncDisposable/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=UseFormatSpecifierInFormatString/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=UseFormatSpecifierInInterpolation/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=UseIndexFromEndExpression/@EntryIndexedValue">WARNING</s:String>
@@ -298,15 +305,21 @@
 	<s:Boolean x:Key="/Default/CodeStyle/CodeFormatting/CSharpFormat/WRAP_BEFORE_BINARY_OPSIGN/@EntryValue">True</s:Boolean>
 	<s:Int64 x:Key="/Default/CodeStyle/CodeFormatting/CSharpFormat/WRAP_LIMIT/@EntryValue">200</s:Int64>
 	<s:String x:Key="/Default/CodeStyle/CodeFormatting/CSharpFormat/WRAP_OBJECT_AND_COLLECTION_INITIALIZER_STYLE/@EntryValue">CHOP_IF_LONG</s:String>
+	<s:String x:Key="/Default/CodeStyle/CSharpVarKeywordUsage/ForBuiltInTypes/@EntryValue">UseExplicitType</s:String>
+	<s:String x:Key="/Default/CodeStyle/CSharpVarKeywordUsage/ForOtherTypes/@EntryValue">UseVarWhenEvident</s:String>
+	<s:String x:Key="/Default/CodeStyle/CSharpVarKeywordUsage/ForSimpleTypes/@EntryValue">UseVarWhenEvident</s:String>
 	<s:Boolean x:Key="/Default/CodeStyle/EncapsulateField/MakeFieldPrivate/@EntryValue">False</s:Boolean>
 	<s:Boolean x:Key="/Default/CodeStyle/EncapsulateField/UseAutoProperty/@EntryValue">False</s:Boolean>
 	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/Abbreviations/=AABB/@EntryIndexedValue">AABB</s:String>
 	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/Abbreviations/=API/@EntryIndexedValue">API</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/=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>
 	<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/=HSV/@EntryIndexedValue">HSV</s:String>
 	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/Abbreviations/=HTML/@EntryIndexedValue">HTML</s:String>
 	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/Abbreviations/=HUD/@EntryIndexedValue">HUD</s:String>
 	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/Abbreviations/=ID/@EntryIndexedValue">ID</s:String>
@@ -909,26 +922,82 @@ private void load()
 {
 	$END$
 };</s:String>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=antiflow/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Beatmap/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=beatmaps/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Beatmapset/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=beatmap_0027s/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=bindable/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=bindables/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Catmull/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Clickthrough/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Closedness/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=crosshair/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Daycore/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Deserialise/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=deserialised/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Dimmable/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Disableable/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Drawables/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Failable/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=favourited/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Gamefield/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=gameplay/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Geki/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Hashable/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Hitnormal/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=hitobject/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=hitobjects/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Hitsound/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Hitsounded/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Hitsounds/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Judgeable/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Katu/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=keymods/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Kiai/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Kudosu/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Lazer/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Leaderboard/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Leaderboards/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=letterboxing/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=localisable/@EntryIndexedValue">True</s:Boolean>
+	<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/=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>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Playfield/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=playfields/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Poolable/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Preclicked/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=purgeable/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Rearrangeable/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=refetch/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=refetched/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Refilter/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Reinstantiation/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=resampler/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=romanisable/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Romanisation/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Romanised/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=ruleset/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=rulesets/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=ruleset_0027s/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Scorable/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=seeya/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Skinnable/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Snappable/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Soleily/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Spinnable/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Strongable/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Taiko/@EntryIndexedValue">True</s:Boolean>
-	<s:Boolean x:Key="/Default/UserDictionary/Words/=Unranked/@EntryIndexedValue">True</s:Boolean></wpf:ResourceDictionary>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=undim/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=undownloadable/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Unescaping/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Unhover/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Unhovered/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Unplayed/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Unproxy/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Unranked/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Zoomable/@EntryIndexedValue">True</s:Boolean></wpf:ResourceDictionary>

From d06d584867e57ee6cb03cc566c1114ada0f47473 Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Wed, 9 Feb 2022 19:56:32 +0800
Subject: [PATCH 2831/5547] Change assembly titles

So that they match the source name specified in template.json and can get replaced
---
 .../osu.Game.Rulesets.EmptyFreeform.csproj                      | 2 +-
 .../osu.Game.Rulesets.Pippidon.csproj                           | 2 +-
 .../osu.Game.Rulesets.EmptyScrolling.csproj                     | 2 +-
 .../osu.Game.Rulesets.Pippidon.csproj                           | 2 +-
 4 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform/osu.Game.Rulesets.EmptyFreeform.csproj b/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform/osu.Game.Rulesets.EmptyFreeform.csproj
index cfe2bd1cb2..092a013614 100644
--- a/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform/osu.Game.Rulesets.EmptyFreeform.csproj
+++ b/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform/osu.Game.Rulesets.EmptyFreeform.csproj
@@ -1,7 +1,7 @@
 <Project Sdk="Microsoft.NET.Sdk">
   <PropertyGroup Label="Project">
     <TargetFramework>netstandard2.1</TargetFramework>
-    <AssemblyTitle>osu.Game.Rulesets.Sample</AssemblyTitle>
+    <AssemblyTitle>osu.Game.Rulesets.EmptyFreeform</AssemblyTitle>
     <OutputType>Library</OutputType>
     <PlatformTarget>AnyCPU</PlatformTarget>
     <RootNamespace>osu.Game.Rulesets.EmptyFreeform</RootNamespace>
diff --git a/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon/osu.Game.Rulesets.Pippidon.csproj b/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon/osu.Game.Rulesets.Pippidon.csproj
index 61b859f45b..a3607343c9 100644
--- a/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon/osu.Game.Rulesets.Pippidon.csproj
+++ b/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon/osu.Game.Rulesets.Pippidon.csproj
@@ -1,7 +1,7 @@
 <Project Sdk="Microsoft.NET.Sdk">
   <PropertyGroup Label="Project">
     <TargetFramework>netstandard2.1</TargetFramework>
-    <AssemblyTitle>osu.Game.Rulesets.Sample</AssemblyTitle>
+    <AssemblyTitle>osu.Game.Rulesets.Pippidon</AssemblyTitle>
     <OutputType>Library</OutputType>
     <PlatformTarget>AnyCPU</PlatformTarget>
     <RootNamespace>osu.Game.Rulesets.Pippidon</RootNamespace>
diff --git a/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling/osu.Game.Rulesets.EmptyScrolling.csproj b/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling/osu.Game.Rulesets.EmptyScrolling.csproj
index 9dce3c9a0a..2ea52429ab 100644
--- a/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling/osu.Game.Rulesets.EmptyScrolling.csproj
+++ b/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling/osu.Game.Rulesets.EmptyScrolling.csproj
@@ -1,7 +1,7 @@
 <Project Sdk="Microsoft.NET.Sdk">
   <PropertyGroup Label="Project">
     <TargetFramework>netstandard2.1</TargetFramework>
-    <AssemblyTitle>osu.Game.Rulesets.Sample</AssemblyTitle>
+    <AssemblyTitle>osu.Game.Rulesets.EmptyScrolling</AssemblyTitle>
     <OutputType>Library</OutputType>
     <PlatformTarget>AnyCPU</PlatformTarget>
     <RootNamespace>osu.Game.Rulesets.EmptyScrolling</RootNamespace>
diff --git a/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon/osu.Game.Rulesets.Pippidon.csproj b/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon/osu.Game.Rulesets.Pippidon.csproj
index 61b859f45b..a3607343c9 100644
--- a/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon/osu.Game.Rulesets.Pippidon.csproj
+++ b/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon/osu.Game.Rulesets.Pippidon.csproj
@@ -1,7 +1,7 @@
 <Project Sdk="Microsoft.NET.Sdk">
   <PropertyGroup Label="Project">
     <TargetFramework>netstandard2.1</TargetFramework>
-    <AssemblyTitle>osu.Game.Rulesets.Sample</AssemblyTitle>
+    <AssemblyTitle>osu.Game.Rulesets.Pippidon</AssemblyTitle>
     <OutputType>Library</OutputType>
     <PlatformTarget>AnyCPU</PlatformTarget>
     <RootNamespace>osu.Game.Rulesets.Pippidon</RootNamespace>

From 036d17d9fd215423f34ace116203af936ef7428e Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Wed, 9 Feb 2022 20:48:14 +0800
Subject: [PATCH 2832/5547] Remove licence headers

---
 Templates/Rulesets/ruleset-empty/.editorconfig                 | 2 --
 .../osu.Game.Rulesets.EmptyFreeform.sln.DotSettings            | 3 ---
 Templates/Rulesets/ruleset-example/.editorconfig               | 2 --
 .../ruleset-example/osu.Game.Rulesets.Pippidon.sln.DotSettings | 3 ---
 Templates/Rulesets/ruleset-scrolling-empty/.editorconfig       | 2 --
 .../osu.Game.Rulesets.EmptyScrolling.sln.DotSettings           | 3 ---
 Templates/Rulesets/ruleset-scrolling-example/.editorconfig     | 2 --
 .../osu.Game.Rulesets.Pippidon.sln.DotSettings                 | 3 ---
 8 files changed, 20 deletions(-)

diff --git a/Templates/Rulesets/ruleset-empty/.editorconfig b/Templates/Rulesets/ruleset-empty/.editorconfig
index b01749195f..9c7537de4b 100644
--- a/Templates/Rulesets/ruleset-empty/.editorconfig
+++ b/Templates/Rulesets/ruleset-empty/.editorconfig
@@ -190,5 +190,3 @@ dotnet_diagnostic.CA2225.severity = none
 
 # Banned APIs
 dotnet_diagnostic.RS0030.severity = error
-
-dotnet_diagnostic.OLOC001.license_header = // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.\n// See the LICENCE file in the repository root for full licence text.
diff --git a/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform.sln.DotSettings b/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform.sln.DotSettings
index 2ff0f4d30b..9752e08599 100644
--- a/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform.sln.DotSettings
+++ b/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform.sln.DotSettings
@@ -730,9 +730,6 @@
 	&lt;/Group&gt;&#xD;
 	&lt;/TypePattern&gt;&#xD;
 &lt;/Patterns&gt;</s:String>
-	<s:String x:Key="/Default/CodeStyle/FileHeader/FileHeaderText/@EntryValue">Copyright (c) ppy Pty Ltd &lt;contact@ppy.sh&gt;. Licensed under the MIT Licence.&#xD;
-See the LICENCE file in the repository root for full licence text.&#xD;
-</s:String>
 	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/PredefinedNamingRules/=Constants/@EntryIndexedValue">&lt;Policy Inspect="True" Prefix="" Suffix="" Style="AA_BB" /&gt;</s:String>
 	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/PredefinedNamingRules/=EnumMember/@EntryIndexedValue">&lt;Policy Inspect="False" Prefix="" Suffix="" Style="AaBb" /&gt;</s:String>
 	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/PredefinedNamingRules/=LocalConstants/@EntryIndexedValue">&lt;Policy Inspect="True" Prefix="" Suffix="" Style="aa_bb" /&gt;</s:String>
diff --git a/Templates/Rulesets/ruleset-example/.editorconfig b/Templates/Rulesets/ruleset-example/.editorconfig
index b01749195f..9c7537de4b 100644
--- a/Templates/Rulesets/ruleset-example/.editorconfig
+++ b/Templates/Rulesets/ruleset-example/.editorconfig
@@ -190,5 +190,3 @@ dotnet_diagnostic.CA2225.severity = none
 
 # Banned APIs
 dotnet_diagnostic.RS0030.severity = error
-
-dotnet_diagnostic.OLOC001.license_header = // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.\n// See the LICENCE file in the repository root for full licence text.
diff --git a/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon.sln.DotSettings b/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon.sln.DotSettings
index 2ff0f4d30b..9752e08599 100644
--- a/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon.sln.DotSettings
+++ b/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon.sln.DotSettings
@@ -730,9 +730,6 @@
 	&lt;/Group&gt;&#xD;
 	&lt;/TypePattern&gt;&#xD;
 &lt;/Patterns&gt;</s:String>
-	<s:String x:Key="/Default/CodeStyle/FileHeader/FileHeaderText/@EntryValue">Copyright (c) ppy Pty Ltd &lt;contact@ppy.sh&gt;. Licensed under the MIT Licence.&#xD;
-See the LICENCE file in the repository root for full licence text.&#xD;
-</s:String>
 	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/PredefinedNamingRules/=Constants/@EntryIndexedValue">&lt;Policy Inspect="True" Prefix="" Suffix="" Style="AA_BB" /&gt;</s:String>
 	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/PredefinedNamingRules/=EnumMember/@EntryIndexedValue">&lt;Policy Inspect="False" Prefix="" Suffix="" Style="AaBb" /&gt;</s:String>
 	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/PredefinedNamingRules/=LocalConstants/@EntryIndexedValue">&lt;Policy Inspect="True" Prefix="" Suffix="" Style="aa_bb" /&gt;</s:String>
diff --git a/Templates/Rulesets/ruleset-scrolling-empty/.editorconfig b/Templates/Rulesets/ruleset-scrolling-empty/.editorconfig
index b01749195f..9c7537de4b 100644
--- a/Templates/Rulesets/ruleset-scrolling-empty/.editorconfig
+++ b/Templates/Rulesets/ruleset-scrolling-empty/.editorconfig
@@ -190,5 +190,3 @@ dotnet_diagnostic.CA2225.severity = none
 
 # Banned APIs
 dotnet_diagnostic.RS0030.severity = error
-
-dotnet_diagnostic.OLOC001.license_header = // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.\n// See the LICENCE file in the repository root for full licence text.
diff --git a/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling.sln.DotSettings b/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling.sln.DotSettings
index 2ff0f4d30b..9752e08599 100644
--- a/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling.sln.DotSettings
+++ b/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling.sln.DotSettings
@@ -730,9 +730,6 @@
 	&lt;/Group&gt;&#xD;
 	&lt;/TypePattern&gt;&#xD;
 &lt;/Patterns&gt;</s:String>
-	<s:String x:Key="/Default/CodeStyle/FileHeader/FileHeaderText/@EntryValue">Copyright (c) ppy Pty Ltd &lt;contact@ppy.sh&gt;. Licensed under the MIT Licence.&#xD;
-See the LICENCE file in the repository root for full licence text.&#xD;
-</s:String>
 	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/PredefinedNamingRules/=Constants/@EntryIndexedValue">&lt;Policy Inspect="True" Prefix="" Suffix="" Style="AA_BB" /&gt;</s:String>
 	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/PredefinedNamingRules/=EnumMember/@EntryIndexedValue">&lt;Policy Inspect="False" Prefix="" Suffix="" Style="AaBb" /&gt;</s:String>
 	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/PredefinedNamingRules/=LocalConstants/@EntryIndexedValue">&lt;Policy Inspect="True" Prefix="" Suffix="" Style="aa_bb" /&gt;</s:String>
diff --git a/Templates/Rulesets/ruleset-scrolling-example/.editorconfig b/Templates/Rulesets/ruleset-scrolling-example/.editorconfig
index b01749195f..9c7537de4b 100644
--- a/Templates/Rulesets/ruleset-scrolling-example/.editorconfig
+++ b/Templates/Rulesets/ruleset-scrolling-example/.editorconfig
@@ -190,5 +190,3 @@ dotnet_diagnostic.CA2225.severity = none
 
 # Banned APIs
 dotnet_diagnostic.RS0030.severity = error
-
-dotnet_diagnostic.OLOC001.license_header = // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.\n// See the LICENCE file in the repository root for full licence text.
diff --git a/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon.sln.DotSettings b/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon.sln.DotSettings
index 2ff0f4d30b..9752e08599 100644
--- a/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon.sln.DotSettings
+++ b/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon.sln.DotSettings
@@ -730,9 +730,6 @@
 	&lt;/Group&gt;&#xD;
 	&lt;/TypePattern&gt;&#xD;
 &lt;/Patterns&gt;</s:String>
-	<s:String x:Key="/Default/CodeStyle/FileHeader/FileHeaderText/@EntryValue">Copyright (c) ppy Pty Ltd &lt;contact@ppy.sh&gt;. Licensed under the MIT Licence.&#xD;
-See the LICENCE file in the repository root for full licence text.&#xD;
-</s:String>
 	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/PredefinedNamingRules/=Constants/@EntryIndexedValue">&lt;Policy Inspect="True" Prefix="" Suffix="" Style="AA_BB" /&gt;</s:String>
 	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/PredefinedNamingRules/=EnumMember/@EntryIndexedValue">&lt;Policy Inspect="False" Prefix="" Suffix="" Style="AaBb" /&gt;</s:String>
 	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/PredefinedNamingRules/=LocalConstants/@EntryIndexedValue">&lt;Policy Inspect="True" Prefix="" Suffix="" Style="aa_bb" /&gt;</s:String>

From f47748591a2deb2604f9556bfbe4bdad754ba96a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 10 Feb 2022 12:11:26 +0900
Subject: [PATCH 2833/5547] Update fastlane to latest release

This pulls in the fix from souyuz to allow us to bring things up-to-date
 again (see https://github.com/voydz/souyuz/pull/36#event-6033249116).

Have tested builds locally to work as expected.
---
 Gemfile.lock       | 71 ++++++++++++++++++------------------
 fastlane/README.md | 91 +++++++++++++++++++++++++++++++---------------
 2 files changed, 96 insertions(+), 66 deletions(-)

diff --git a/Gemfile.lock b/Gemfile.lock
index 86c8baabe6..1010027af9 100644
--- a/Gemfile.lock
+++ b/Gemfile.lock
@@ -8,17 +8,17 @@ GEM
     artifactory (3.0.15)
     atomos (0.1.3)
     aws-eventstream (1.2.0)
-    aws-partitions (1.551.0)
-    aws-sdk-core (3.125.5)
+    aws-partitions (1.553.0)
+    aws-sdk-core (3.126.0)
       aws-eventstream (~> 1, >= 1.0.2)
       aws-partitions (~> 1, >= 1.525.0)
       aws-sigv4 (~> 1.1)
       jmespath (~> 1.0)
-    aws-sdk-kms (1.53.0)
-      aws-sdk-core (~> 3, >= 3.125.0)
+    aws-sdk-kms (1.54.0)
+      aws-sdk-core (~> 3, >= 3.126.0)
       aws-sigv4 (~> 1.1)
-    aws-sdk-s3 (1.111.3)
-      aws-sdk-core (~> 3, >= 3.125.0)
+    aws-sdk-s3 (1.112.0)
+      aws-sdk-core (~> 3, >= 3.126.0)
       aws-sdk-kms (~> 1)
       aws-sigv4 (~> 1.4)
     aws-sigv4 (1.4.0)
@@ -27,8 +27,8 @@ GEM
     claide (1.1.0)
     colored (1.2)
     colored2 (3.1.2)
-    commander-fastlane (4.4.6)
-      highline (~> 1.7.2)
+    commander (4.6.0)
+      highline (~> 2.0.0)
     declarative (0.0.20)
     digest-crc (0.6.4)
       rake (>= 12.0.0, < 14.0.0)
@@ -36,7 +36,7 @@ GEM
       unf (>= 0.0.5, < 1.0.0)
     dotenv (2.7.6)
     emoji_regex (3.2.3)
-    excon (0.90.0)
+    excon (0.91.0)
     faraday (1.9.3)
       faraday-em_http (~> 1.0)
       faraday-em_synchrony (~> 1.0)
@@ -66,15 +66,15 @@ GEM
     faraday_middleware (1.2.0)
       faraday (~> 1.0)
     fastimage (2.2.6)
-    fastlane (2.181.0)
+    fastlane (2.204.2)
       CFPropertyList (>= 2.3, < 4.0.0)
-      addressable (>= 2.3, < 3.0.0)
+      addressable (>= 2.8, < 3.0.0)
       artifactory (~> 3.0)
       aws-sdk-s3 (~> 1.0)
       babosa (>= 1.0.3, < 2.0.0)
       bundler (>= 1.12.0, < 3.0.0)
       colored
-      commander-fastlane (>= 4.4.6, < 5.0.0)
+      commander (~> 4.6)
       dotenv (>= 2.1.1, < 3.0.0)
       emoji_regex (>= 0.1, < 4.0)
       excon (>= 0.71.0, < 1.0.0)
@@ -83,19 +83,20 @@ GEM
       faraday_middleware (~> 1.0)
       fastimage (>= 2.1.0, < 3.0.0)
       gh_inspector (>= 1.1.2, < 2.0.0)
-      google-api-client (>= 0.37.0, < 0.39.0)
-      google-cloud-storage (>= 1.15.0, < 2.0.0)
-      highline (>= 1.7.2, < 2.0.0)
+      google-apis-androidpublisher_v3 (~> 0.3)
+      google-apis-playcustomapp_v1 (~> 0.1)
+      google-cloud-storage (~> 1.31)
+      highline (~> 2.0)
       json (< 3.0.0)
       jwt (>= 2.1.0, < 3)
       mini_magick (>= 4.9.4, < 5.0.0)
       multipart-post (~> 2.0.0)
       naturally (~> 2.2)
+      optparse (~> 0.1.1)
       plist (>= 3.1.0, < 4.0.0)
       rubyzip (>= 2.0.0, < 3.0.0)
       security (= 0.1.3)
       simctl (~> 1.6.3)
-      slack-notifier (>= 2.0.0, < 3.0.0)
       terminal-notifier (>= 2.0.0, < 3.0.0)
       terminal-table (>= 1.4.5, < 2.0.0)
       tty-screen (>= 0.6.3, < 1.0.0)
@@ -105,18 +106,12 @@ GEM
       xcpretty (~> 0.3.0)
       xcpretty-travis-formatter (>= 0.0.3)
     fastlane-plugin-clean_testflight_testers (0.3.0)
-    fastlane-plugin-souyuz (0.9.1)
-      souyuz (= 0.9.1)
+    fastlane-plugin-souyuz (0.11.1)
+      souyuz (= 0.11.1)
     fastlane-plugin-xamarin (0.6.3)
     gh_inspector (1.1.3)
-    google-api-client (0.38.0)
-      addressable (~> 2.5, >= 2.5.1)
-      googleauth (~> 0.9)
-      httpclient (>= 2.8.1, < 3.0)
-      mini_mime (~> 1.0)
-      representable (~> 3.0)
-      retriable (>= 2.0, < 4.0)
-      signet (~> 0.12)
+    google-apis-androidpublisher_v3 (0.16.0)
+      google-apis-core (>= 0.4, < 2.a)
     google-apis-core (0.4.2)
       addressable (~> 2.5, >= 2.5.1)
       googleauth (>= 0.16.2, < 2.a)
@@ -128,6 +123,8 @@ GEM
       webrick
     google-apis-iamcredentials_v1 (0.10.0)
       google-apis-core (>= 0.4, < 2.a)
+    google-apis-playcustomapp_v1 (0.7.0)
+      google-apis-core (>= 0.4, < 2.a)
     google-apis-storage_v1 (0.11.0)
       google-apis-core (>= 0.4, < 2.a)
     google-cloud-core (1.6.0)
@@ -144,14 +141,14 @@ GEM
       google-cloud-core (~> 1.6)
       googleauth (>= 0.16.2, < 2.a)
       mini_mime (~> 1.0)
-    googleauth (0.17.1)
+    googleauth (1.1.0)
       faraday (>= 0.17.3, < 2.0)
       jwt (>= 1.4, < 3.0)
       memoist (~> 0.16)
       multi_json (~> 1.11)
       os (>= 0.9, < 2.0)
-      signet (~> 0.15)
-    highline (1.7.10)
+      signet (>= 0.16, < 2.a)
+    highline (2.0.3)
     http-cookie (1.0.4)
       domain_name (~> 0.5)
     httpclient (2.8.3)
@@ -161,16 +158,19 @@ GEM
     memoist (0.16.2)
     mini_magick (4.11.0)
     mini_mime (1.1.2)
-    mini_portile2 (2.4.0)
+    mini_portile2 (2.7.1)
     multi_json (1.15.0)
     multipart-post (2.0.0)
     nanaimo (0.3.0)
     naturally (2.2.1)
-    nokogiri (1.10.10)
-      mini_portile2 (~> 2.4.0)
+    nokogiri (1.13.1)
+      mini_portile2 (~> 2.7.0)
+      racc (~> 1.4)
+    optparse (0.1.1)
     os (1.1.4)
     plist (3.6.0)
     public_suffix (4.0.6)
+    racc (1.6.0)
     rake (13.0.6)
     representable (3.1.1)
       declarative (< 0.1.0)
@@ -190,10 +190,9 @@ GEM
     simctl (1.6.8)
       CFPropertyList
       naturally
-    slack-notifier (2.4.0)
-    souyuz (0.9.1)
-      fastlane (>= 1.103.0)
-      highline (~> 1.7)
+    souyuz (0.11.1)
+      fastlane (>= 2.182.0)
+      highline (~> 2.0)
       nokogiri (~> 1.7)
     terminal-notifier (2.0.0)
     terminal-table (1.8.0)
diff --git a/fastlane/README.md b/fastlane/README.md
index 8273fdaa5d..9d5e11f7cb 100644
--- a/fastlane/README.md
+++ b/fastlane/README.md
@@ -1,78 +1,109 @@
 fastlane documentation
-================
+----
+
 # Installation
 
 Make sure you have the latest version of the Xcode command line tools installed:
 
-```
+```sh
 xcode-select --install
 ```
 
-Install _fastlane_ using
-```
-[sudo] gem install fastlane -NV
-```
-or alternatively using `brew install fastlane`
+For _fastlane_ installation instructions, see [Installing _fastlane_](https://docs.fastlane.tools/#installing-fastlane)
 
 # Available Actions
+
 ## Android
+
 ### android beta
+
+```sh
+[bundle exec] fastlane android beta
 ```
-fastlane android beta
-```
+
 Deploy to play store
+
 ### android build_github
+
+```sh
+[bundle exec] fastlane android build_github
 ```
-fastlane android build_github
-```
+
 Deploy to github release
+
 ### android build
+
+```sh
+[bundle exec] fastlane android build
 ```
-fastlane android build
-```
+
 Compile the project
+
 ### android update_version
+
+```sh
+[bundle exec] fastlane android update_version
 ```
-fastlane android update_version
-```
+
 
 
 ----
 
+
 ## iOS
+
 ### ios beta
+
+```sh
+[bundle exec] fastlane ios beta
 ```
-fastlane ios beta
-```
+
 Deploy to testflight
+
 ### ios build
+
+```sh
+[bundle exec] fastlane ios build
 ```
-fastlane ios build
-```
+
 Compile the project
+
 ### ios provision
+
+```sh
+[bundle exec] fastlane ios provision
 ```
-fastlane ios provision
-```
+
 Install provisioning profiles using match
+
 ### ios update_version
+
+```sh
+[bundle exec] fastlane ios update_version
 ```
-fastlane ios update_version
-```
+
+
 
 ### ios testflight_prune_dry
-```
-fastlane ios testflight_prune_dry
+
+```sh
+[bundle exec] fastlane ios testflight_prune_dry
 ```
 
+
+
 ### ios testflight_prune
+
+```sh
+[bundle exec] fastlane ios testflight_prune
 ```
-fastlane ios testflight_prune
-```
+
 
 
 ----
 
-This README.md is auto-generated and will be re-generated every time [fastlane](https://fastlane.tools) is run.
-More information about fastlane can be found on [fastlane.tools](https://fastlane.tools).
-The documentation of fastlane can be found on [docs.fastlane.tools](https://docs.fastlane.tools).
+This README.md is auto-generated and will be re-generated every time [_fastlane_](https://fastlane.tools) is run.
+
+More information about _fastlane_ can be found on [fastlane.tools](https://fastlane.tools).
+
+The documentation of _fastlane_ can be found on [docs.fastlane.tools](https://docs.fastlane.tools).

From a3896a8ebdc87b95c9d97a1f5112c65bafe761b9 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 10 Feb 2022 14:18:29 +0900
Subject: [PATCH 2834/5547] Remove allowance of null dependency

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

diff --git a/osu.Game/Rulesets/UI/ReplayRecorder.cs b/osu.Game/Rulesets/UI/ReplayRecorder.cs
index 277040b2a6..0a94b55221 100644
--- a/osu.Game/Rulesets/UI/ReplayRecorder.cs
+++ b/osu.Game/Rulesets/UI/ReplayRecorder.cs
@@ -28,7 +28,7 @@ namespace osu.Game.Rulesets.UI
 
         public int RecordFrameRate = 60;
 
-        [Resolved(canBeNull: true)]
+        [Resolved]
         private SpectatorClient spectatorClient { get; set; }
 
         [Resolved]
@@ -48,8 +48,7 @@ namespace osu.Game.Rulesets.UI
             base.LoadComplete();
 
             inputManager = GetContainingInputManager();
-
-            spectatorClient?.BeginPlaying(gameplayState, target);
+            spectatorClient.BeginPlaying(gameplayState, target);
         }
 
         protected override void Dispose(bool isDisposing)

From f7fb7825cc322c3ac08a0c310928591ed96e3142 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 10 Feb 2022 14:21:33 +0900
Subject: [PATCH 2835/5547] Simplify disposal

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

diff --git a/osu.Game/Rulesets/UI/ReplayRecorder.cs b/osu.Game/Rulesets/UI/ReplayRecorder.cs
index 0a94b55221..6843beef7b 100644
--- a/osu.Game/Rulesets/UI/ReplayRecorder.cs
+++ b/osu.Game/Rulesets/UI/ReplayRecorder.cs
@@ -3,6 +3,7 @@
 
 using System;
 using System.Collections.Generic;
+using System.Diagnostics;
 using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
@@ -54,9 +55,7 @@ namespace osu.Game.Rulesets.UI
         protected override void Dispose(bool isDisposing)
         {
             base.Dispose(isDisposing);
-
-            if (spectatorClient != null && gameplayState != null)
-                spectatorClient.EndPlaying(gameplayState);
+            spectatorClient?.EndPlaying(gameplayState);
         }
 
         protected override void Update()

From ebd105422fd6c2903bced01cb820d7e0d542789a Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 10 Feb 2022 14:22:08 +0900
Subject: [PATCH 2836/5547] Remove unused using

---
 osu.Game/Rulesets/UI/ReplayRecorder.cs | 1 -
 1 file changed, 1 deletion(-)

diff --git a/osu.Game/Rulesets/UI/ReplayRecorder.cs b/osu.Game/Rulesets/UI/ReplayRecorder.cs
index 6843beef7b..dcd8f12028 100644
--- a/osu.Game/Rulesets/UI/ReplayRecorder.cs
+++ b/osu.Game/Rulesets/UI/ReplayRecorder.cs
@@ -3,7 +3,6 @@
 
 using System;
 using System.Collections.Generic;
-using System.Diagnostics;
 using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;

From 88bb9d4237c62d37678d8e0e110438ea247b7ae5 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 10 Feb 2022 15:50:03 +0900
Subject: [PATCH 2837/5547] Fix migration errors not outputting the call stack
 to logs

---
 .../Settings/Sections/Maintenance/MigrationRunScreen.cs         | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/Settings/Sections/Maintenance/MigrationRunScreen.cs b/osu.Game/Overlays/Settings/Sections/Maintenance/MigrationRunScreen.cs
index b0b61554eb..adb347e7b8 100644
--- a/osu.Game/Overlays/Settings/Sections/Maintenance/MigrationRunScreen.cs
+++ b/osu.Game/Overlays/Settings/Sections/Maintenance/MigrationRunScreen.cs
@@ -88,7 +88,7 @@ namespace osu.Game.Overlays.Settings.Sections.Maintenance
                                 .ContinueWith(t =>
                                 {
                                     if (t.IsFaulted)
-                                        Logger.Log($"Error during migration: {t.Exception?.Message}", level: LogLevel.Error);
+                                        Logger.Error(t.Exception, $"Error during migration: {t.Exception?.Message}");
 
                                     Schedule(this.Exit);
                                 });

From 176bb4a4e22901a37761ab6e1812663d3ec6c7dd Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 10 Feb 2022 15:25:54 +0900
Subject: [PATCH 2838/5547] Update desktop projects to target .NET 6

---
 .run/osu! (Second Client).run.xml                         | 8 ++++----
 .../osu.Game.Rulesets.EmptyFreeform.Tests.csproj          | 4 ++--
 .../osu.Game.Rulesets.Pippidon.Tests.csproj               | 4 ++--
 .../osu.Game.Rulesets.EmptyScrolling.Tests.csproj         | 4 ++--
 .../osu.Game.Rulesets.Pippidon.Tests.csproj               | 4 ++--
 osu.Desktop/osu.Desktop.csproj                            | 2 +-
 osu.Game.Benchmarks/osu.Game.Benchmarks.csproj            | 2 +-
 .../osu.Game.Rulesets.Catch.Tests.csproj                  | 4 ++--
 .../osu.Game.Rulesets.Mania.Tests.csproj                  | 4 ++--
 .../osu.Game.Rulesets.Osu.Tests.csproj                    | 4 ++--
 .../osu.Game.Rulesets.Taiko.Tests.csproj                  | 4 ++--
 osu.Game.Tests/osu.Game.Tests.csproj                      | 2 +-
 .../osu.Game.Tournament.Tests.csproj                      | 4 ++--
 osu.iOS.props                                             | 2 +-
 14 files changed, 26 insertions(+), 26 deletions(-)

diff --git a/.run/osu! (Second Client).run.xml b/.run/osu! (Second Client).run.xml
index 599b4b986b..9a471df902 100644
--- a/.run/osu! (Second Client).run.xml	
+++ b/.run/osu! (Second Client).run.xml	
@@ -1,8 +1,8 @@
 <component name="ProjectRunConfigurationManager">
   <configuration default="false" name="osu! (Second Client)" type="DotNetProject" factoryName=".NET Project" folderName="osu!" activateToolWindowBeforeRun="false">
-    <option name="EXE_PATH" value="$PROJECT_DIR$/osu.Desktop/bin/Debug/net5.0/osu!.dll" />
+    <option name="EXE_PATH" value="$PROJECT_DIR$/osu.Desktop/bin/Debug/net6.0/osu!.dll" />
     <option name="PROGRAM_PARAMETERS" value="--debug-client-id=1" />
-    <option name="WORKING_DIRECTORY" value="$PROJECT_DIR$/osu.Desktop/bin/Debug/net5.0" />
+    <option name="WORKING_DIRECTORY" value="$PROJECT_DIR$/osu.Desktop/bin/Debug/net6.0" />
     <option name="PASS_PARENT_ENVS" value="1" />
     <option name="USE_EXTERNAL_CONSOLE" value="0" />
     <option name="USE_MONO" value="0" />
@@ -12,9 +12,9 @@
     <option name="PROJECT_ARGUMENTS_TRACKING" value="1" />
     <option name="PROJECT_WORKING_DIRECTORY_TRACKING" value="1" />
     <option name="PROJECT_KIND" value="DotNetCore" />
-    <option name="PROJECT_TFM" value="net5.0" />
+    <option name="PROJECT_TFM" value="net6.0" />
     <method v="2">
       <option name="Build" />
     </method>
   </configuration>
-</component>
\ No newline at end of file
+</component>
diff --git a/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform.Tests/osu.Game.Rulesets.EmptyFreeform.Tests.csproj b/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform.Tests/osu.Game.Rulesets.EmptyFreeform.Tests.csproj
index 3c6aaa39ca..cb922c5a58 100644
--- a/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform.Tests/osu.Game.Rulesets.EmptyFreeform.Tests.csproj
+++ b/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform.Tests/osu.Game.Rulesets.EmptyFreeform.Tests.csproj
@@ -20,7 +20,7 @@
   </ItemGroup>
   <PropertyGroup Label="Project">
     <OutputType>WinExe</OutputType>
-    <TargetFramework>net5.0</TargetFramework>
+    <TargetFramework>net6.0</TargetFramework>
     <RootNamespace>osu.Game.Rulesets.EmptyFreeform.Tests</RootNamespace>
   </PropertyGroup>
-</Project>
\ No newline at end of file
+</Project>
diff --git a/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon.Tests/osu.Game.Rulesets.Pippidon.Tests.csproj b/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon.Tests/osu.Game.Rulesets.Pippidon.Tests.csproj
index 0719dd30df..5ecd9cc675 100644
--- a/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon.Tests/osu.Game.Rulesets.Pippidon.Tests.csproj
+++ b/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon.Tests/osu.Game.Rulesets.Pippidon.Tests.csproj
@@ -20,7 +20,7 @@
   </ItemGroup>
   <PropertyGroup Label="Project">
     <OutputType>WinExe</OutputType>
-    <TargetFramework>net5.0</TargetFramework>
+    <TargetFramework>net6.0</TargetFramework>
     <RootNamespace>osu.Game.Rulesets.Pippidon.Tests</RootNamespace>
   </PropertyGroup>
-</Project>
\ No newline at end of file
+</Project>
diff --git a/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling.Tests/osu.Game.Rulesets.EmptyScrolling.Tests.csproj b/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling.Tests/osu.Game.Rulesets.EmptyScrolling.Tests.csproj
index d0db43cc81..33ad0ac4f7 100644
--- a/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling.Tests/osu.Game.Rulesets.EmptyScrolling.Tests.csproj
+++ b/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling.Tests/osu.Game.Rulesets.EmptyScrolling.Tests.csproj
@@ -20,7 +20,7 @@
   </ItemGroup>
   <PropertyGroup Label="Project">
     <OutputType>WinExe</OutputType>
-    <TargetFramework>net5.0</TargetFramework>
+    <TargetFramework>net6.0</TargetFramework>
     <RootNamespace>osu.Game.Rulesets.EmptyScrolling.Tests</RootNamespace>
   </PropertyGroup>
-</Project>
\ No newline at end of file
+</Project>
diff --git a/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon.Tests/osu.Game.Rulesets.Pippidon.Tests.csproj b/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon.Tests/osu.Game.Rulesets.Pippidon.Tests.csproj
index 0719dd30df..5ecd9cc675 100644
--- a/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon.Tests/osu.Game.Rulesets.Pippidon.Tests.csproj
+++ b/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon.Tests/osu.Game.Rulesets.Pippidon.Tests.csproj
@@ -20,7 +20,7 @@
   </ItemGroup>
   <PropertyGroup Label="Project">
     <OutputType>WinExe</OutputType>
-    <TargetFramework>net5.0</TargetFramework>
+    <TargetFramework>net6.0</TargetFramework>
     <RootNamespace>osu.Game.Rulesets.Pippidon.Tests</RootNamespace>
   </PropertyGroup>
-</Project>
\ No newline at end of file
+</Project>
diff --git a/osu.Desktop/osu.Desktop.csproj b/osu.Desktop/osu.Desktop.csproj
index 89b9ffb94b..5e203af1f2 100644
--- a/osu.Desktop/osu.Desktop.csproj
+++ b/osu.Desktop/osu.Desktop.csproj
@@ -1,6 +1,6 @@
 <Project Sdk="Microsoft.NET.Sdk">
   <PropertyGroup Label="Project">
-    <TargetFramework>net5.0</TargetFramework>
+    <TargetFramework>net6.0</TargetFramework>
     <OutputType>WinExe</OutputType>
     <AllowUnsafeBlocks>true</AllowUnsafeBlocks>
     <Description>A free-to-win rhythm game. Rhythm is just a *click* away!</Description>
diff --git a/osu.Game.Benchmarks/osu.Game.Benchmarks.csproj b/osu.Game.Benchmarks/osu.Game.Benchmarks.csproj
index 57b914bee6..434c0e0367 100644
--- a/osu.Game.Benchmarks/osu.Game.Benchmarks.csproj
+++ b/osu.Game.Benchmarks/osu.Game.Benchmarks.csproj
@@ -1,7 +1,7 @@
 <Project Sdk="Microsoft.NET.Sdk">
 
   <PropertyGroup>
-    <TargetFramework>net5.0</TargetFramework>
+    <TargetFramework>net6.0</TargetFramework>
     <OutputType>Exe</OutputType>
     <IsPackable>false</IsPackable>
   </PropertyGroup>
diff --git a/osu.Game.Rulesets.Catch.Tests/osu.Game.Rulesets.Catch.Tests.csproj b/osu.Game.Rulesets.Catch.Tests/osu.Game.Rulesets.Catch.Tests.csproj
index 13f2e25f05..fc6d900567 100644
--- a/osu.Game.Rulesets.Catch.Tests/osu.Game.Rulesets.Catch.Tests.csproj
+++ b/osu.Game.Rulesets.Catch.Tests/osu.Game.Rulesets.Catch.Tests.csproj
@@ -9,9 +9,9 @@
   </ItemGroup>
   <PropertyGroup Label="Project">
     <OutputType>WinExe</OutputType>
-    <TargetFramework>net5.0</TargetFramework>
+    <TargetFramework>net6.0</TargetFramework>
   </PropertyGroup>
   <ItemGroup Label="Project References">
     <ProjectReference Include="..\osu.Game.Rulesets.Catch\osu.Game.Rulesets.Catch.csproj" />
   </ItemGroup>
-</Project>
\ No newline at end of file
+</Project>
diff --git a/osu.Game.Rulesets.Mania.Tests/osu.Game.Rulesets.Mania.Tests.csproj b/osu.Game.Rulesets.Mania.Tests/osu.Game.Rulesets.Mania.Tests.csproj
index d51a6da4f9..ddad2adfea 100644
--- a/osu.Game.Rulesets.Mania.Tests/osu.Game.Rulesets.Mania.Tests.csproj
+++ b/osu.Game.Rulesets.Mania.Tests/osu.Game.Rulesets.Mania.Tests.csproj
@@ -9,9 +9,9 @@
   </ItemGroup>
   <PropertyGroup Label="Project">
     <OutputType>WinExe</OutputType>
-    <TargetFramework>net5.0</TargetFramework>
+    <TargetFramework>net6.0</TargetFramework>
   </PropertyGroup>
   <ItemGroup Label="Project References">
     <ProjectReference Include="..\osu.Game.Rulesets.Mania\osu.Game.Rulesets.Mania.csproj" />
   </ItemGroup>
-</Project>
\ No newline at end of file
+</Project>
diff --git a/osu.Game.Rulesets.Osu.Tests/osu.Game.Rulesets.Osu.Tests.csproj b/osu.Game.Rulesets.Osu.Tests/osu.Game.Rulesets.Osu.Tests.csproj
index fea2e408f6..bd4c3d3345 100644
--- a/osu.Game.Rulesets.Osu.Tests/osu.Game.Rulesets.Osu.Tests.csproj
+++ b/osu.Game.Rulesets.Osu.Tests/osu.Game.Rulesets.Osu.Tests.csproj
@@ -10,9 +10,9 @@
   </ItemGroup>
   <PropertyGroup Label="Project">
     <OutputType>WinExe</OutputType>
-    <TargetFramework>net5.0</TargetFramework>
+    <TargetFramework>net6.0</TargetFramework>
   </PropertyGroup>
   <ItemGroup Label="Project References">
     <ProjectReference Include="..\osu.Game.Rulesets.Osu\osu.Game.Rulesets.Osu.csproj" />
   </ItemGroup>
-</Project>
\ No newline at end of file
+</Project>
diff --git a/osu.Game.Rulesets.Taiko.Tests/osu.Game.Rulesets.Taiko.Tests.csproj b/osu.Game.Rulesets.Taiko.Tests/osu.Game.Rulesets.Taiko.Tests.csproj
index ad3713e047..a6b8eb8651 100644
--- a/osu.Game.Rulesets.Taiko.Tests/osu.Game.Rulesets.Taiko.Tests.csproj
+++ b/osu.Game.Rulesets.Taiko.Tests/osu.Game.Rulesets.Taiko.Tests.csproj
@@ -9,9 +9,9 @@
   </ItemGroup>
   <PropertyGroup Label="Project">
     <OutputType>WinExe</OutputType>
-    <TargetFramework>net5.0</TargetFramework>
+    <TargetFramework>net6.0</TargetFramework>
   </PropertyGroup>
   <ItemGroup Label="Project References">
     <ProjectReference Include="..\osu.Game.Rulesets.Taiko\osu.Game.Rulesets.Taiko.csproj" />
   </ItemGroup>
-</Project>
\ No newline at end of file
+</Project>
diff --git a/osu.Game.Tests/osu.Game.Tests.csproj b/osu.Game.Tests/osu.Game.Tests.csproj
index 3b115d43e5..acf1e8470b 100644
--- a/osu.Game.Tests/osu.Game.Tests.csproj
+++ b/osu.Game.Tests/osu.Game.Tests.csproj
@@ -12,7 +12,7 @@
   </ItemGroup>
   <PropertyGroup Label="Project">
     <OutputType>WinExe</OutputType>
-    <TargetFramework>net5.0</TargetFramework>
+    <TargetFramework>net6.0</TargetFramework>
   </PropertyGroup>
   <PropertyGroup Label="Code Analysis">
     <CodeAnalysisRuleSet>tests.ruleset</CodeAnalysisRuleSet>
diff --git a/osu.Game.Tournament.Tests/osu.Game.Tournament.Tests.csproj b/osu.Game.Tournament.Tests/osu.Game.Tournament.Tests.csproj
index 130fcfaca1..c7314a4969 100644
--- a/osu.Game.Tournament.Tests/osu.Game.Tournament.Tests.csproj
+++ b/osu.Game.Tournament.Tests/osu.Game.Tournament.Tests.csproj
@@ -11,7 +11,7 @@
   </ItemGroup>
   <PropertyGroup Label="Project">
     <OutputType>WinExe</OutputType>
-    <TargetFramework>net5.0</TargetFramework>
+    <TargetFramework>net6.0</TargetFramework>
   </PropertyGroup>
   <ItemGroup Label="Project References">
     <ProjectReference Include="..\osu.Game.Rulesets.Catch\osu.Game.Rulesets.Catch.csproj" />
@@ -20,4 +20,4 @@
     <ProjectReference Include="..\osu.Game.Rulesets.Taiko\osu.Game.Rulesets.Taiko.csproj" />
     <ProjectReference Include="..\osu.Game.Tournament\osu.Game.Tournament.csproj" />
   </ItemGroup>
-</Project>
\ No newline at end of file
+</Project>
diff --git a/osu.iOS.props b/osu.iOS.props
index 5978f6d685..7e5ab37257 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -63,7 +63,7 @@
     <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.204.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.204.0" />
   </ItemGroup>
-  <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net5.0 / net6.0) -->
+  <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net6.0) -->
   <PropertyGroup>
     <NoWarn>$(NoWarn);NU1605</NoWarn>
   </PropertyGroup>

From 44f2d8a4481d686aea94d6d480cfc0e17ec7351b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 10 Feb 2022 18:48:37 +0900
Subject: [PATCH 2839/5547] Allow game folder migration to fail gracefully when
 cleanup cannot completely succeed

---
 osu.Game.Tournament/IO/TournamentStorage.cs   |  4 ++-
 osu.Game/IO/MigratableStorage.cs              | 30 +++++++++++-----
 osu.Game/IO/OsuStorage.cs                     |  7 ++--
 osu.Game/OsuGameBase.cs                       |  9 ++---
 .../Maintenance/MigrationRunScreen.cs         | 36 ++++++++++++++++---
 5 files changed, 66 insertions(+), 20 deletions(-)

diff --git a/osu.Game.Tournament/IO/TournamentStorage.cs b/osu.Game.Tournament/IO/TournamentStorage.cs
index 347d368a04..b4859d0c91 100644
--- a/osu.Game.Tournament/IO/TournamentStorage.cs
+++ b/osu.Game.Tournament/IO/TournamentStorage.cs
@@ -70,7 +70,7 @@ namespace osu.Game.Tournament.IO
 
         public IEnumerable<string> ListTournaments() => AllTournaments.GetDirectories(string.Empty);
 
-        public override void Migrate(Storage newStorage)
+        public override bool Migrate(Storage newStorage)
         {
             // this migration only happens once on moving to the per-tournament storage system.
             // listed files are those known at that point in time.
@@ -94,6 +94,8 @@ namespace osu.Game.Tournament.IO
             ChangeTargetStorage(newStorage);
             storageConfig.SetValue(StorageConfig.CurrentTournament, default_tournament);
             storageConfig.Save();
+
+            return true;
         }
 
         private void moveFileIfExists(string file, DirectoryInfo destination)
diff --git a/osu.Game/IO/MigratableStorage.cs b/osu.Game/IO/MigratableStorage.cs
index 1b76725b04..e478144294 100644
--- a/osu.Game/IO/MigratableStorage.cs
+++ b/osu.Game/IO/MigratableStorage.cs
@@ -33,7 +33,8 @@ namespace osu.Game.IO
         /// A general purpose migration method to move the storage to a different location.
         /// <param name="newStorage">The target storage of the migration.</param>
         /// </summary>
-        public virtual void Migrate(Storage newStorage)
+        /// <returns>Whether cleanup could complete.</returns>
+        public virtual bool Migrate(Storage newStorage)
         {
             var source = new DirectoryInfo(GetFullPath("."));
             var destination = new DirectoryInfo(newStorage.GetFullPath("."));
@@ -57,17 +58,20 @@ namespace osu.Game.IO
 
             CopyRecursive(source, destination);
             ChangeTargetStorage(newStorage);
-            DeleteRecursive(source);
+
+            return DeleteRecursive(source);
         }
 
-        protected void DeleteRecursive(DirectoryInfo target, bool topLevelExcludes = true)
+        protected bool DeleteRecursive(DirectoryInfo target, bool topLevelExcludes = true)
         {
+            bool allFilesDeleted = true;
+
             foreach (System.IO.FileInfo fi in target.GetFiles())
             {
                 if (topLevelExcludes && IgnoreFiles.Contains(fi.Name))
                     continue;
 
-                AttemptOperation(() => fi.Delete());
+                allFilesDeleted &= AttemptOperation(() => fi.Delete(), throwOnFailure: false);
             }
 
             foreach (DirectoryInfo dir in target.GetDirectories())
@@ -75,11 +79,13 @@ namespace osu.Game.IO
                 if (topLevelExcludes && IgnoreDirectories.Contains(dir.Name))
                     continue;
 
-                AttemptOperation(() => dir.Delete(true));
+                allFilesDeleted &= AttemptOperation(() => dir.Delete(true), throwOnFailure: false);
             }
 
             if (target.GetFiles().Length == 0 && target.GetDirectories().Length == 0)
-                AttemptOperation(target.Delete);
+                allFilesDeleted &= AttemptOperation(target.Delete, throwOnFailure: false);
+
+            return allFilesDeleted;
         }
 
         protected void CopyRecursive(DirectoryInfo source, DirectoryInfo destination, bool topLevelExcludes = true)
@@ -110,19 +116,25 @@ namespace osu.Game.IO
         /// </summary>
         /// <param name="action">The action to perform.</param>
         /// <param name="attempts">The number of attempts (250ms wait between each).</param>
-        protected static void AttemptOperation(Action action, int attempts = 10)
+        /// <param name="throwOnFailure">Whether to throw an exception on failure. If <c>false</c>, will silently fail.</param>
+        protected static bool AttemptOperation(Action action, int attempts = 10, bool throwOnFailure = true)
         {
             while (true)
             {
                 try
                 {
                     action();
-                    return;
+                    return true;
                 }
                 catch (Exception)
                 {
                     if (attempts-- == 0)
-                        throw;
+                    {
+                        if (throwOnFailure)
+                            throw;
+
+                        return false;
+                    }
                 }
 
                 Thread.Sleep(250);
diff --git a/osu.Game/IO/OsuStorage.cs b/osu.Game/IO/OsuStorage.cs
index 802c71e363..6e7cb545e3 100644
--- a/osu.Game/IO/OsuStorage.cs
+++ b/osu.Game/IO/OsuStorage.cs
@@ -113,11 +113,14 @@ namespace osu.Game.IO
             }
         }
 
-        public override void Migrate(Storage newStorage)
+        public override bool Migrate(Storage newStorage)
         {
-            base.Migrate(newStorage);
+            bool cleanupSucceeded = base.Migrate(newStorage);
+
             storageConfig.SetValue(StorageConfig.FullPath, newStorage.GetFullPath("."));
             storageConfig.Save();
+
+            return cleanupSucceeded;
         }
     }
 
diff --git a/osu.Game/OsuGameBase.cs b/osu.Game/OsuGameBase.cs
index 5b2eb5607a..0b2644d5ba 100644
--- a/osu.Game/OsuGameBase.cs
+++ b/osu.Game/OsuGameBase.cs
@@ -413,7 +413,7 @@ namespace osu.Game
                 Scheduler.AddDelayed(GracefullyExit, 2000);
         }
 
-        public void Migrate(string path)
+        public bool Migrate(string path)
         {
             Logger.Log($@"Migrating osu! data from ""{Storage.GetFullPath(string.Empty)}"" to ""{path}""...");
 
@@ -432,14 +432,15 @@ namespace osu.Game
 
                 readyToRun.Wait();
 
-                (Storage as OsuStorage)?.Migrate(Host.GetStorage(path));
+                bool? cleanupSucceded = (Storage as OsuStorage)?.Migrate(Host.GetStorage(path));
+
+                Logger.Log(@"Migration complete!");
+                return cleanupSucceded != false;
             }
             finally
             {
                 realmBlocker?.Dispose();
             }
-
-            Logger.Log(@"Migration complete!");
         }
 
         protected override UserInputManager CreateUserInputManager() => new OsuUserInputManager();
diff --git a/osu.Game/Overlays/Settings/Sections/Maintenance/MigrationRunScreen.cs b/osu.Game/Overlays/Settings/Sections/Maintenance/MigrationRunScreen.cs
index adb347e7b8..fb7ff0dbd1 100644
--- a/osu.Game/Overlays/Settings/Sections/Maintenance/MigrationRunScreen.cs
+++ b/osu.Game/Overlays/Settings/Sections/Maintenance/MigrationRunScreen.cs
@@ -4,13 +4,16 @@
 using System.IO;
 using System.Threading.Tasks;
 using osu.Framework.Allocation;
+using osu.Framework.Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Logging;
+using osu.Framework.Platform;
 using osu.Framework.Screens;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.UserInterface;
+using osu.Game.Overlays.Notifications;
 using osu.Game.Screens;
 using osuTK;
 
@@ -23,6 +26,15 @@ namespace osu.Game.Overlays.Settings.Sections.Maintenance
         [Resolved(canBeNull: true)]
         private OsuGame game { get; set; }
 
+        [Resolved]
+        private NotificationOverlay notifications { get; set; }
+
+        [Resolved]
+        private Storage storage { get; set; }
+
+        [Resolved]
+        private GameHost host { get; set; }
+
         public override bool AllowBackButton => false;
 
         public override bool AllowExternalScreenChange => false;
@@ -84,17 +96,33 @@ namespace osu.Game.Overlays.Settings.Sections.Maintenance
 
             Beatmap.Value = Beatmap.Default;
 
+            var originalStorage = new NativeStorage(storage.GetFullPath(string.Empty), host);
+
             migrationTask = Task.Run(PerformMigration)
-                                .ContinueWith(t =>
+                                .ContinueWith(task =>
                                 {
-                                    if (t.IsFaulted)
-                                        Logger.Error(t.Exception, $"Error during migration: {t.Exception?.Message}");
+                                    if (task.IsFaulted)
+                                    {
+                                        Logger.Error(task.Exception, $"Error during migration: {task.Exception?.Message}");
+                                    }
+                                    else if (!task.GetResultSafely())
+                                    {
+                                        notifications.Post(new SimpleNotification
+                                        {
+                                            Text = "Some files couldn't be cleaned up during migration. Clicking this notification will open the folder so you can manually clean things up.",
+                                            Activated = () =>
+                                            {
+                                                originalStorage.PresentExternally();
+                                                return true;
+                                            }
+                                        });
+                                    }
 
                                     Schedule(this.Exit);
                                 });
         }
 
-        protected virtual void PerformMigration() => game?.Migrate(destination.FullName);
+        protected virtual bool PerformMigration() => game?.Migrate(destination.FullName) != false;
 
         public override void OnEntering(IScreen last)
         {

From 19cb8cb03a100c9baa80c23b7b307ff300130df2 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 10 Feb 2022 19:21:17 +0900
Subject: [PATCH 2840/5547] Update tests

---
 .../Settings/TestSceneMigrationScreens.cs     | 51 ++++++++++++++++---
 1 file changed, 44 insertions(+), 7 deletions(-)

diff --git a/osu.Game.Tests/Visual/Settings/TestSceneMigrationScreens.cs b/osu.Game.Tests/Visual/Settings/TestSceneMigrationScreens.cs
index 2883e54385..a68090504d 100644
--- a/osu.Game.Tests/Visual/Settings/TestSceneMigrationScreens.cs
+++ b/osu.Game.Tests/Visual/Settings/TestSceneMigrationScreens.cs
@@ -3,32 +3,69 @@
 
 using System.IO;
 using System.Threading;
+using NUnit.Framework;
+using osu.Framework.Allocation;
+using osu.Framework.Graphics;
 using osu.Framework.Screens;
+using osu.Game.Overlays;
 using osu.Game.Overlays.Settings.Sections.Maintenance;
 
 namespace osu.Game.Tests.Visual.Settings
 {
     public class TestSceneMigrationScreens : ScreenTestScene
     {
+        [Cached]
+        private readonly NotificationOverlay notifications;
+
         public TestSceneMigrationScreens()
         {
-            AddStep("Push screen", () => Stack.Push(new TestMigrationSelectScreen()));
+            Children = new Drawable[]
+            {
+                notifications = new NotificationOverlay
+                {
+                    Anchor = Anchor.TopRight,
+                    Origin = Anchor.TopRight,
+                }
+            };
+        }
+
+        [Test]
+        public void TestDeleteSuccess()
+        {
+            AddStep("Push screen", () => Stack.Push(new TestMigrationSelectScreen(true)));
+        }
+
+        [Test]
+        public void TestDeleteFails()
+        {
+            AddStep("Push screen", () => Stack.Push(new TestMigrationSelectScreen(false)));
         }
 
         private class TestMigrationSelectScreen : MigrationSelectScreen
         {
-            protected override void BeginMigration(DirectoryInfo target) => this.Push(new TestMigrationRunScreen());
+            private readonly bool deleteSuccess;
+
+            public TestMigrationSelectScreen(bool deleteSuccess)
+            {
+                this.deleteSuccess = deleteSuccess;
+            }
+
+            protected override void BeginMigration(DirectoryInfo target) => this.Push(new TestMigrationRunScreen(deleteSuccess));
 
             private class TestMigrationRunScreen : MigrationRunScreen
             {
-                protected override void PerformMigration()
-                {
-                    Thread.Sleep(3000);
-                }
+                private readonly bool success;
 
-                public TestMigrationRunScreen()
+                public TestMigrationRunScreen(bool success)
                     : base(null)
                 {
+                    this.success = success;
+                }
+
+                protected override bool PerformMigration()
+                {
+                    Thread.Sleep(3000);
+                    return success;
                 }
             }
         }

From 2939bc4644b2b5079a5af5ffa578288676cf0ca2 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 11 Feb 2022 01:49:52 +0900
Subject: [PATCH 2841/5547] Update resources

---
 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 71525a7acb..147f576c55 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -51,7 +51,7 @@
     <Reference Include="Java.Interop" />
   </ItemGroup>
   <ItemGroup>
-    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.204.0" />
+    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.210.0" />
     <PackageReference Include="ppy.osu.Framework.Android" Version="2022.204.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index c8f634284b..dd10807ec2 100644
--- a/osu.Game/osu.Game.csproj
+++ b/osu.Game/osu.Game.csproj
@@ -37,7 +37,7 @@
     </PackageReference>
     <PackageReference Include="Realm" Version="10.8.0" />
     <PackageReference Include="ppy.osu.Framework" Version="2022.204.0" />
-    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.204.0" />
+    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.210.0" />
     <PackageReference Include="Sentry" Version="3.13.0" />
     <PackageReference Include="SharpCompress" Version="0.30.1" />
     <PackageReference Include="NUnit" Version="3.13.2" />
diff --git a/osu.iOS.props b/osu.iOS.props
index 5978f6d685..6fbc468586 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -61,7 +61,7 @@
   </ItemGroup>
   <ItemGroup Label="Package References">
     <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.204.0" />
-    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.204.0" />
+    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.210.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net5.0 / net6.0) -->
   <PropertyGroup>

From 9cd88ec2b84d8460af461bd91deec5fc355ddced Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 10 Feb 2022 21:23:38 +0300
Subject: [PATCH 2842/5547] Update API models with score pinning changes

---
 osu.Game/Online/API/Requests/GetUserScoresRequest.cs | 3 ++-
 osu.Game/Online/API/Requests/Responses/APIUser.cs    | 3 +++
 2 files changed, 5 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Online/API/Requests/GetUserScoresRequest.cs b/osu.Game/Online/API/Requests/GetUserScoresRequest.cs
index 653abf7427..5d39799f6b 100644
--- a/osu.Game/Online/API/Requests/GetUserScoresRequest.cs
+++ b/osu.Game/Online/API/Requests/GetUserScoresRequest.cs
@@ -39,6 +39,7 @@ namespace osu.Game.Online.API.Requests
     {
         Best,
         Firsts,
-        Recent
+        Recent,
+        Pinned
     }
 }
diff --git a/osu.Game/Online/API/Requests/Responses/APIUser.cs b/osu.Game/Online/API/Requests/Responses/APIUser.cs
index e4a432b074..2b64e5de06 100644
--- a/osu.Game/Online/API/Requests/Responses/APIUser.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIUser.cs
@@ -151,6 +151,9 @@ namespace osu.Game.Online.API.Requests.Responses
         [JsonProperty(@"scores_recent_count")]
         public int ScoresRecentCount;
 
+        [JsonProperty(@"scores_pinned_count")]
+        public int ScoresPinnedCount;
+
         [JsonProperty(@"beatmap_playcounts_count")]
         public int BeatmapPlayCountsCount;
 

From 4f7003928acb9a14a12adc02c343cb9329181ec5 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 10 Feb 2022 21:32:07 +0300
Subject: [PATCH 2843/5547] Add score container for pinned scores in ranks
 section

---
 .../Overlays/Profile/Sections/Ranks/PaginatedScoreContainer.cs | 3 +++
 osu.Game/Overlays/Profile/Sections/RanksSection.cs             | 2 ++
 2 files changed, 5 insertions(+)

diff --git a/osu.Game/Overlays/Profile/Sections/Ranks/PaginatedScoreContainer.cs b/osu.Game/Overlays/Profile/Sections/Ranks/PaginatedScoreContainer.cs
index 5532e35cc5..5c67da1911 100644
--- a/osu.Game/Overlays/Profile/Sections/Ranks/PaginatedScoreContainer.cs
+++ b/osu.Game/Overlays/Profile/Sections/Ranks/PaginatedScoreContainer.cs
@@ -46,6 +46,9 @@ namespace osu.Game.Overlays.Profile.Sections.Ranks
                 case ScoreType.Recent:
                     return user.ScoresRecentCount;
 
+                case ScoreType.Pinned:
+                    return user.ScoresPinnedCount;
+
                 default:
                     return 0;
             }
diff --git a/osu.Game/Overlays/Profile/Sections/RanksSection.cs b/osu.Game/Overlays/Profile/Sections/RanksSection.cs
index 00a68d5bf9..02d8bd8c52 100644
--- a/osu.Game/Overlays/Profile/Sections/RanksSection.cs
+++ b/osu.Game/Overlays/Profile/Sections/RanksSection.cs
@@ -18,6 +18,8 @@ namespace osu.Game.Overlays.Profile.Sections
         {
             Children = new[]
             {
+                // todo: update to use UsersStrings.ShowExtraTopRanksPinnedTitle once that exists.
+                new PaginatedScoreContainer(ScoreType.Pinned, User, "Pinned Scores"),
                 new PaginatedScoreContainer(ScoreType.Best, User, UsersStrings.ShowExtraTopRanksBestTitle),
                 new PaginatedScoreContainer(ScoreType.Firsts, User, UsersStrings.ShowExtraTopRanksFirstTitle)
             };

From 9574bc13820665f5e6721915b3c05367ac9dccb7 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 11 Feb 2022 04:00:40 +0300
Subject: [PATCH 2844/5547] Allow `IRulesetInfo`s of same type to be comparable

At first I was planning on making `CompareTo` implemented at
`IRulesetInfo` itself and shared across classes, but turns out it only
implements it explicitly and not allow direct `IRulesetInfo.Equals`
calls.

It messed with my head enough that I decided to just let each class have
its own implementation and only allow same type.
---
 osu.Game/Rulesets/IRulesetInfo.cs |  2 +-
 osu.Game/Rulesets/RulesetInfo.cs  | 12 ++++++++++--
 2 files changed, 11 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Rulesets/IRulesetInfo.cs b/osu.Game/Rulesets/IRulesetInfo.cs
index 44731a2495..60a02212fc 100644
--- a/osu.Game/Rulesets/IRulesetInfo.cs
+++ b/osu.Game/Rulesets/IRulesetInfo.cs
@@ -11,7 +11,7 @@ namespace osu.Game.Rulesets
     /// <summary>
     /// A representation of a ruleset's metadata.
     /// </summary>
-    public interface IRulesetInfo : IHasOnlineID<int>, IEquatable<IRulesetInfo>, IComparable<RulesetInfo>
+    public interface IRulesetInfo : IHasOnlineID<int>, IEquatable<IRulesetInfo>, IComparable<IRulesetInfo>
     {
         /// <summary>
         /// The user-exposed name of this ruleset.
diff --git a/osu.Game/Rulesets/RulesetInfo.cs b/osu.Game/Rulesets/RulesetInfo.cs
index 0a0941d1ff..88e3988431 100644
--- a/osu.Game/Rulesets/RulesetInfo.cs
+++ b/osu.Game/Rulesets/RulesetInfo.cs
@@ -12,7 +12,7 @@ namespace osu.Game.Rulesets
 {
     [ExcludeFromDynamicCompile]
     [MapTo("Ruleset")]
-    public class RulesetInfo : RealmObject, IEquatable<RulesetInfo>, IRulesetInfo
+    public class RulesetInfo : RealmObject, IEquatable<RulesetInfo>, IComparable<RulesetInfo>, IRulesetInfo
     {
         [PrimaryKey]
         public string ShortName { get; set; } = string.Empty;
@@ -47,7 +47,7 @@ namespace osu.Game.Rulesets
             return ShortName == other.ShortName;
         }
 
-        public bool Equals(IRulesetInfo? other) => other is RulesetInfo b && Equals(b);
+        public bool Equals(IRulesetInfo? other) => other is RulesetInfo r && Equals(r);
 
         public int CompareTo(RulesetInfo other)
         {
@@ -63,6 +63,14 @@ namespace osu.Game.Rulesets
             return string.Compare(ShortName, other.ShortName, StringComparison.Ordinal);
         }
 
+        public int CompareTo(IRulesetInfo other)
+        {
+            if (!(other is RulesetInfo ruleset))
+                throw new ArgumentException($@"Object is not of type {nameof(RulesetInfo)}.", nameof(other));
+
+            return CompareTo(ruleset);
+        }
+
         public override int GetHashCode()
         {
             // Importantly, ignore the underlying realm hash code, as it will usually not match.

From 1b729e891d53e8134efcd5ef8f09d5655c5bf20f Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 11 Feb 2022 04:01:10 +0300
Subject: [PATCH 2845/5547] Update pointless `CompareTo` implementation once
 again

---
 osu.Game/Rulesets/EFRulesetInfo.cs | 12 ++++++++++--
 1 file changed, 10 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Rulesets/EFRulesetInfo.cs b/osu.Game/Rulesets/EFRulesetInfo.cs
index ba56adac49..4174aa773c 100644
--- a/osu.Game/Rulesets/EFRulesetInfo.cs
+++ b/osu.Game/Rulesets/EFRulesetInfo.cs
@@ -11,7 +11,7 @@ namespace osu.Game.Rulesets
 {
     [ExcludeFromDynamicCompile]
     [Table(@"RulesetInfo")]
-    public sealed class EFRulesetInfo : IEquatable<EFRulesetInfo>, IRulesetInfo
+    public sealed class EFRulesetInfo : IEquatable<EFRulesetInfo>, IComparable<EFRulesetInfo>, IRulesetInfo
     {
         public int? ID { get; set; }
 
@@ -42,7 +42,15 @@ namespace osu.Game.Rulesets
 
         public bool Equals(EFRulesetInfo other) => other != null && ID == other.ID && Available == other.Available && Name == other.Name && InstantiationInfo == other.InstantiationInfo;
 
-        public int CompareTo(RulesetInfo other) => OnlineID.CompareTo(other.OnlineID);
+        public int CompareTo(EFRulesetInfo other) => OnlineID.CompareTo(other.OnlineID);
+
+        public int CompareTo(IRulesetInfo other)
+        {
+            if (!(other is EFRulesetInfo ruleset))
+                throw new ArgumentException($@"Object is not of type {nameof(EFRulesetInfo)}.", nameof(other));
+
+            return CompareTo(ruleset);
+        }
 
         public override bool Equals(object obj) => obj is EFRulesetInfo rulesetInfo && Equals(rulesetInfo);
 

From 26839f6ad8f3c49c3d1c63016b3af47e9afd2602 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 11 Feb 2022 04:17:24 +0300
Subject: [PATCH 2846/5547] Consider `OnlineID`s during ruleset equality if
 available

Required for `APIBeatmap`s, which provide `Ruleset` instances with `OnlineID` available only.

Also consistent with the comparer implementation.
---
 osu.Game/Rulesets/RulesetInfo.cs | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/osu.Game/Rulesets/RulesetInfo.cs b/osu.Game/Rulesets/RulesetInfo.cs
index 88e3988431..ba7c8d191d 100644
--- a/osu.Game/Rulesets/RulesetInfo.cs
+++ b/osu.Game/Rulesets/RulesetInfo.cs
@@ -44,6 +44,9 @@ namespace osu.Game.Rulesets
             if (ReferenceEquals(this, other)) return true;
             if (other == null) return false;
 
+            if (OnlineID >= 0 && other.OnlineID >= 0)
+                return OnlineID == other.OnlineID;
+
             return ShortName == other.ShortName;
         }
 

From 6f0e32826c6d90c92c1130cd7aa07894e3b7f38f Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 11 Feb 2022 04:06:28 +0300
Subject: [PATCH 2847/5547] Standardise ordering/grouping of
 `IRulesetInfo`/`RulesetInfo`s

---
 .../Beatmaps/Drawables/Cards/BeatmapCardDifficultyList.cs   | 2 +-
 osu.Game/Beatmaps/Drawables/DifficultySpectrumDisplay.cs    | 6 ++----
 osu.Game/Screens/Edit/Editor.cs                             | 2 +-
 osu.Game/Screens/Select/Carousel/SetPanelContent.cs         | 2 +-
 4 files changed, 5 insertions(+), 7 deletions(-)

diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardDifficultyList.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardDifficultyList.cs
index 7753d8480a..eeb86f4702 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardDifficultyList.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardDifficultyList.cs
@@ -33,7 +33,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
 
             bool firstGroup = true;
 
-            foreach (var group in beatmapSetInfo.Beatmaps.GroupBy(beatmap => beatmap.Ruleset.OnlineID).OrderBy(group => group.Key))
+            foreach (var group in beatmapSetInfo.Beatmaps.GroupBy(beatmap => beatmap.Ruleset).OrderBy(group => group.Key))
             {
                 if (!firstGroup)
                 {
diff --git a/osu.Game/Beatmaps/Drawables/DifficultySpectrumDisplay.cs b/osu.Game/Beatmaps/Drawables/DifficultySpectrumDisplay.cs
index 5b211084ab..5b467d67e2 100644
--- a/osu.Game/Beatmaps/Drawables/DifficultySpectrumDisplay.cs
+++ b/osu.Game/Beatmaps/Drawables/DifficultySpectrumDisplay.cs
@@ -62,10 +62,8 @@ namespace osu.Game.Beatmaps.Drawables
             // matching web: https://github.com/ppy/osu-web/blob/d06d8c5e735eb1f48799b1654b528e9a7afb0a35/resources/assets/lib/beatmapset-panel.tsx#L127
             bool collapsed = beatmapSet.Beatmaps.Count() > 12;
 
-            foreach (var rulesetGrouping in beatmapSet.Beatmaps.GroupBy(beatmap => beatmap.Ruleset.OnlineID).OrderBy(group => group.Key))
-            {
-                flow.Add(new RulesetDifficultyGroup(rulesetGrouping.Key, rulesetGrouping, collapsed));
-            }
+            foreach (var rulesetGrouping in beatmapSet.Beatmaps.GroupBy(beatmap => beatmap.Ruleset).OrderBy(group => group.Key))
+                flow.Add(new RulesetDifficultyGroup(rulesetGrouping.Key.OnlineID, rulesetGrouping, collapsed));
         }
 
         protected override void LoadComplete()
diff --git a/osu.Game/Screens/Edit/Editor.cs b/osu.Game/Screens/Edit/Editor.cs
index 5503a62ba2..2aec63fa65 100644
--- a/osu.Game/Screens/Edit/Editor.cs
+++ b/osu.Game/Screens/Edit/Editor.cs
@@ -851,7 +851,7 @@ namespace osu.Game.Screens.Edit
 
             var difficultyItems = new List<MenuItem>();
 
-            foreach (var rulesetBeatmaps in beatmapSet.Beatmaps.GroupBy(b => b.Ruleset.ShortName).OrderBy(group => group.Key))
+            foreach (var rulesetBeatmaps in beatmapSet.Beatmaps.GroupBy(b => b.Ruleset).OrderBy(group => group.Key))
             {
                 if (difficultyItems.Count > 0)
                     difficultyItems.Add(new EditorMenuItemSpacer());
diff --git a/osu.Game/Screens/Select/Carousel/SetPanelContent.cs b/osu.Game/Screens/Select/Carousel/SetPanelContent.cs
index 82523c9d9d..760915b528 100644
--- a/osu.Game/Screens/Select/Carousel/SetPanelContent.cs
+++ b/osu.Game/Screens/Select/Carousel/SetPanelContent.cs
@@ -87,7 +87,7 @@ namespace osu.Game.Screens.Select.Carousel
             var beatmaps = carouselSet.Beatmaps.ToList();
 
             return beatmaps.Count > maximum_difficulty_icons
-                ? (IEnumerable<DifficultyIcon>)beatmaps.GroupBy(b => b.BeatmapInfo.Ruleset.ShortName)
+                ? (IEnumerable<DifficultyIcon>)beatmaps.GroupBy(b => b.BeatmapInfo.Ruleset)
                                                        .Select(group => new FilterableGroupedDifficultyIcon(group.ToList(), group.Last().BeatmapInfo.Ruleset))
                 : beatmaps.Select(b => new FilterableDifficultyIcon(b));
         }

From c29cc78853f9cfb5efc4e923c7d9fca6fda8fbf7 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 11 Feb 2022 04:44:54 +0300
Subject: [PATCH 2848/5547] Fix failing test case

---
 .../Visual/UserInterface/TestSceneModSelectOverlay.cs         | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectOverlay.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectOverlay.cs
index b429619044..9083415a78 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectOverlay.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectOverlay.cs
@@ -457,10 +457,12 @@ namespace osu.Game.Tests.Visual.UserInterface
             public override ModType Type => ModType.Conversion;
         }
 
-        private class TestUnimplementedModOsuRuleset : OsuRuleset
+        private class TestUnimplementedModOsuRuleset : OsuRuleset, ILegacyRuleset
         {
             public override string ShortName => "unimplemented";
 
+            int ILegacyRuleset.LegacyID => -1;
+
             public override IEnumerable<Mod> GetModsFor(ModType type)
             {
                 if (type == ModType.Conversion) return base.GetModsFor(type).Concat(new[] { new TestUnimplementedMod() });

From 92e22c57a77a2860e2ddc78ee85da46f2e5f43d4 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 11 Feb 2022 08:02:51 +0300
Subject: [PATCH 2849/5547] Introduce private `APIRuleset` for online ID
 equality comparison

---
 .../API/Requests/Responses/APIBeatmap.cs      | 26 ++++++++++++++++++-
 osu.Game/Rulesets/RulesetInfo.cs              |  3 ---
 2 files changed, 25 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs b/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs
index ebbac0dcab..dca60e54cb 100644
--- a/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs
@@ -98,7 +98,7 @@ namespace osu.Game.Online.API.Requests.Responses
 
         public string MD5Hash => Checksum;
 
-        public IRulesetInfo Ruleset => new RulesetInfo { OnlineID = RulesetID };
+        public IRulesetInfo Ruleset => new APIRuleset { OnlineID = RulesetID };
 
         [JsonIgnore]
         public string Hash => throw new NotImplementedException();
@@ -106,5 +106,29 @@ namespace osu.Game.Online.API.Requests.Responses
         #endregion
 
         public bool Equals(IBeatmapInfo? other) => other is APIBeatmap b && this.MatchesOnlineID(b);
+
+        private class APIRuleset : IRulesetInfo
+        {
+            public int OnlineID { get; set; } = -1;
+
+            public string Name => $@"{nameof(APIRuleset)} (ID: {OnlineID})";
+            public string ShortName => nameof(APIRuleset);
+            public string InstantiationInfo => string.Empty;
+
+            public Ruleset CreateInstance() => throw new NotImplementedException();
+
+            public bool Equals(IRulesetInfo? other) => other is APIRuleset r && this.MatchesOnlineID(r);
+
+            public int CompareTo(IRulesetInfo other)
+            {
+                if (!(other is APIRuleset ruleset))
+                    throw new ArgumentException($@"Object is not of type {nameof(APIRuleset)}.", nameof(other));
+
+                return OnlineID.CompareTo(ruleset.OnlineID);
+            }
+
+            // ReSharper disable once NonReadonlyMemberInGetHashCode
+            public override int GetHashCode() => OnlineID;
+        }
     }
 }
diff --git a/osu.Game/Rulesets/RulesetInfo.cs b/osu.Game/Rulesets/RulesetInfo.cs
index ba7c8d191d..88e3988431 100644
--- a/osu.Game/Rulesets/RulesetInfo.cs
+++ b/osu.Game/Rulesets/RulesetInfo.cs
@@ -44,9 +44,6 @@ namespace osu.Game.Rulesets
             if (ReferenceEquals(this, other)) return true;
             if (other == null) return false;
 
-            if (OnlineID >= 0 && other.OnlineID >= 0)
-                return OnlineID == other.OnlineID;
-
             return ShortName == other.ShortName;
         }
 

From b06caf2bf7b3a8705d26101f5e1fba464542a701 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 11 Feb 2022 09:12:02 +0300
Subject: [PATCH 2850/5547] Update resources

---
 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 147f576c55..1a2859c851 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -51,7 +51,7 @@
     <Reference Include="Java.Interop" />
   </ItemGroup>
   <ItemGroup>
-    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.210.0" />
+    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.211.0" />
     <PackageReference Include="ppy.osu.Framework.Android" Version="2022.204.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index dd10807ec2..a9c0226951 100644
--- a/osu.Game/osu.Game.csproj
+++ b/osu.Game/osu.Game.csproj
@@ -37,7 +37,7 @@
     </PackageReference>
     <PackageReference Include="Realm" Version="10.8.0" />
     <PackageReference Include="ppy.osu.Framework" Version="2022.204.0" />
-    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.210.0" />
+    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.211.0" />
     <PackageReference Include="Sentry" Version="3.13.0" />
     <PackageReference Include="SharpCompress" Version="0.30.1" />
     <PackageReference Include="NUnit" Version="3.13.2" />
diff --git a/osu.iOS.props b/osu.iOS.props
index 6fbc468586..5e0b264834 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -61,7 +61,7 @@
   </ItemGroup>
   <ItemGroup Label="Package References">
     <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.204.0" />
-    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.210.0" />
+    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.211.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net5.0 / net6.0) -->
   <PropertyGroup>

From f049f175d5d2d3a971bce6825d8cdbd2fedea42d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 11 Feb 2022 15:19:55 +0900
Subject: [PATCH 2851/5547] Revert "Fix failing test case"

This reverts commit c29cc78853f9cfb5efc4e923c7d9fca6fda8fbf7.
---
 .../Visual/UserInterface/TestSceneModSelectOverlay.cs         | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectOverlay.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectOverlay.cs
index 9083415a78..b429619044 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectOverlay.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectOverlay.cs
@@ -457,12 +457,10 @@ namespace osu.Game.Tests.Visual.UserInterface
             public override ModType Type => ModType.Conversion;
         }
 
-        private class TestUnimplementedModOsuRuleset : OsuRuleset, ILegacyRuleset
+        private class TestUnimplementedModOsuRuleset : OsuRuleset
         {
             public override string ShortName => "unimplemented";
 
-            int ILegacyRuleset.LegacyID => -1;
-
             public override IEnumerable<Mod> GetModsFor(ModType type)
             {
                 if (type == ModType.Conversion) return base.GetModsFor(type).Concat(new[] { new TestUnimplementedMod() });

From f012f64fd1f441c96c589035afd63010b41d0b1e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 3 Feb 2022 16:45:57 +0900
Subject: [PATCH 2852/5547] Add test coverage checking carousel panel visual
 state after ruleset filter change

---
 .../SongSelect/TestSceneBeatmapCarousel.cs    | 62 +++++++++++++++++++
 1 file changed, 62 insertions(+)

diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs
index 4e46901e08..540b820250 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs
@@ -41,6 +41,68 @@ namespace osu.Game.Tests.Visual.SongSelect
             this.rulesets = rulesets;
         }
 
+        [Test]
+        public void TestExternalRulesetChange()
+        {
+            createCarousel(new List<BeatmapSetInfo>());
+
+            AddStep("filter to ruleset 0", () => carousel.Filter(new FilterCriteria
+            {
+                Ruleset = rulesets.AvailableRulesets.ElementAt(0),
+                AllowConvertedBeatmaps = true,
+            }, false));
+
+            AddStep("add mixed ruleset beatmapset", () =>
+            {
+                var testMixed = TestResources.CreateTestBeatmapSetInfo(3);
+
+                for (int i = 0; i <= 2; i++)
+                {
+                    testMixed.Beatmaps[i].Ruleset = rulesets.AvailableRulesets.ElementAt(i);
+                }
+
+                carousel.UpdateBeatmapSet(testMixed);
+            });
+
+            AddUntilStep("wait for filtered difficulties", () =>
+            {
+                var visibleBeatmapPanels = carousel.Items.OfType<DrawableCarouselBeatmap>().Where(p => p.IsPresent).ToArray();
+
+                return visibleBeatmapPanels.Length == 1
+                       && visibleBeatmapPanels.Count(p => ((CarouselBeatmap)p.Item).BeatmapInfo.Ruleset.OnlineID == 0) == 1;
+            });
+
+            AddStep("filter to ruleset 1", () => carousel.Filter(new FilterCriteria
+            {
+                Ruleset = rulesets.AvailableRulesets.ElementAt(1),
+                AllowConvertedBeatmaps = true,
+            }, false));
+
+            AddUntilStep("wait for filtered difficulties", () =>
+            {
+                var visibleBeatmapPanels = carousel.Items.OfType<DrawableCarouselBeatmap>().Where(p => p.IsPresent).ToArray();
+
+                return visibleBeatmapPanels.Length == 2
+                       && visibleBeatmapPanels.Count(p => ((CarouselBeatmap)p.Item).BeatmapInfo.Ruleset.OnlineID == 0) == 1
+                       && visibleBeatmapPanels.Count(p => ((CarouselBeatmap)p.Item).BeatmapInfo.Ruleset.OnlineID == 1) == 1;
+            });
+
+            AddStep("filter to ruleset 2", () => carousel.Filter(new FilterCriteria
+            {
+                Ruleset = rulesets.AvailableRulesets.ElementAt(2),
+                AllowConvertedBeatmaps = true,
+            }, false));
+
+            AddUntilStep("wait for filtered difficulties", () =>
+            {
+                var visibleBeatmapPanels = carousel.Items.OfType<DrawableCarouselBeatmap>().Where(p => p.IsPresent).ToArray();
+
+                return visibleBeatmapPanels.Length == 2
+                       && visibleBeatmapPanels.Count(p => ((CarouselBeatmap)p.Item).BeatmapInfo.Ruleset.OnlineID == 0) == 1
+                       && visibleBeatmapPanels.Count(p => ((CarouselBeatmap)p.Item).BeatmapInfo.Ruleset.OnlineID == 2) == 1;
+            });
+        }
+
         [Test]
         public void TestScrollPositionMaintainedOnAdd()
         {

From ccd664896185a0aff852fb8eaf6c47cb1b7bf125 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 11 Feb 2022 09:22:09 +0300
Subject: [PATCH 2853/5547] Update pinned score container header to use
 localised title

---
 osu.Game/Overlays/Profile/Sections/RanksSection.cs | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/osu.Game/Overlays/Profile/Sections/RanksSection.cs b/osu.Game/Overlays/Profile/Sections/RanksSection.cs
index 02d8bd8c52..f48e33dc12 100644
--- a/osu.Game/Overlays/Profile/Sections/RanksSection.cs
+++ b/osu.Game/Overlays/Profile/Sections/RanksSection.cs
@@ -18,8 +18,7 @@ namespace osu.Game.Overlays.Profile.Sections
         {
             Children = new[]
             {
-                // todo: update to use UsersStrings.ShowExtraTopRanksPinnedTitle once that exists.
-                new PaginatedScoreContainer(ScoreType.Pinned, User, "Pinned Scores"),
+                new PaginatedScoreContainer(ScoreType.Pinned, User, UsersStrings.ShowExtraTopRanksPinnedTitle),
                 new PaginatedScoreContainer(ScoreType.Best, User, UsersStrings.ShowExtraTopRanksBestTitle),
                 new PaginatedScoreContainer(ScoreType.Firsts, User, UsersStrings.ShowExtraTopRanksFirstTitle)
             };

From beb3731c0b079c6b2bdaf1d051bd51b5350899f0 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 11 Feb 2022 15:53:45 +0900
Subject: [PATCH 2854/5547] Standardise and combine base implementation of
 score submission requests

These share too much yet have very different constructor signatures and
property exposure. Just a clean-up pass as I begin to look at replay
submission.
---
 .../Online/Rooms/SubmitRoomScoreRequest.cs    | 32 ++-------------
 osu.Game/Online/Rooms/SubmitScoreRequest.cs   | 41 +++++++++++++++++++
 .../Online/Solo/SubmitSoloScoreRequest.cs     | 33 ++-------------
 osu.Game/Screens/Play/RoomSubmittingPlayer.cs |  2 +-
 osu.Game/Screens/Play/SoloPlayer.cs           |  2 +-
 5 files changed, 51 insertions(+), 59 deletions(-)
 create mode 100644 osu.Game/Online/Rooms/SubmitScoreRequest.cs

diff --git a/osu.Game/Online/Rooms/SubmitRoomScoreRequest.cs b/osu.Game/Online/Rooms/SubmitRoomScoreRequest.cs
index e24d113822..39193be1af 100644
--- a/osu.Game/Online/Rooms/SubmitRoomScoreRequest.cs
+++ b/osu.Game/Online/Rooms/SubmitRoomScoreRequest.cs
@@ -1,46 +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 System.Net.Http;
-using Newtonsoft.Json;
-using osu.Framework.IO.Network;
-using osu.Game.Online.API;
-using osu.Game.Online.Solo;
 using osu.Game.Scoring;
 
 namespace osu.Game.Online.Rooms
 {
-    public class SubmitRoomScoreRequest : APIRequest<MultiplayerScore>
+    public class SubmitRoomScoreRequest : SubmitScoreRequest
     {
-        private readonly long scoreId;
         private readonly long roomId;
         private readonly long playlistItemId;
-        private readonly SubmittableScore score;
 
-        public SubmitRoomScoreRequest(long scoreId, long roomId, long playlistItemId, ScoreInfo scoreInfo)
+        public SubmitRoomScoreRequest(ScoreInfo scoreInfo, long scoreId, long roomId, long playlistItemId)
+            : base(scoreInfo, scoreId)
         {
-            this.scoreId = scoreId;
             this.roomId = roomId;
             this.playlistItemId = playlistItemId;
-            score = new SubmittableScore(scoreInfo);
         }
 
-        protected override WebRequest CreateWebRequest()
-        {
-            var req = base.CreateWebRequest();
-
-            req.ContentType = "application/json";
-            req.Method = HttpMethod.Put;
-            req.Timeout = 30000;
-
-            req.AddRaw(JsonConvert.SerializeObject(score, new JsonSerializerSettings
-            {
-                ReferenceLoopHandling = ReferenceLoopHandling.Ignore
-            }));
-
-            return req;
-        }
-
-        protected override string Target => $@"rooms/{roomId}/playlist/{playlistItemId}/scores/{scoreId}";
+        protected override string Target => $@"rooms/{roomId}/playlist/{playlistItemId}/scores/{ScoreId}";
     }
 }
diff --git a/osu.Game/Online/Rooms/SubmitScoreRequest.cs b/osu.Game/Online/Rooms/SubmitScoreRequest.cs
new file mode 100644
index 0000000000..14f858f007
--- /dev/null
+++ b/osu.Game/Online/Rooms/SubmitScoreRequest.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 System.Net.Http;
+using Newtonsoft.Json;
+using osu.Framework.IO.Network;
+using osu.Game.Online.API;
+using osu.Game.Online.Solo;
+using osu.Game.Scoring;
+
+namespace osu.Game.Online.Rooms
+{
+    public abstract class SubmitScoreRequest : APIRequest<MultiplayerScore>
+    {
+        public readonly SubmittableScore Score;
+
+        protected readonly long ScoreId;
+
+        protected SubmitScoreRequest(ScoreInfo scoreInfo, long scoreId)
+        {
+            Score = new SubmittableScore(scoreInfo);
+            this.ScoreId = scoreId;
+        }
+
+        protected override WebRequest CreateWebRequest()
+        {
+            var req = base.CreateWebRequest();
+
+            req.ContentType = "application/json";
+            req.Method = HttpMethod.Put;
+            req.Timeout = 30000;
+
+            req.AddRaw(JsonConvert.SerializeObject(Score, new JsonSerializerSettings
+            {
+                ReferenceLoopHandling = ReferenceLoopHandling.Ignore
+            }));
+
+            return req;
+        }
+    }
+}
diff --git a/osu.Game/Online/Solo/SubmitSoloScoreRequest.cs b/osu.Game/Online/Solo/SubmitSoloScoreRequest.cs
index 78ebddb2e6..77fd7b813b 100644
--- a/osu.Game/Online/Solo/SubmitSoloScoreRequest.cs
+++ b/osu.Game/Online/Solo/SubmitSoloScoreRequest.cs
@@ -1,46 +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.Net.Http;
-using Newtonsoft.Json;
-using osu.Framework.IO.Network;
-using osu.Game.Online.API;
 using osu.Game.Online.Rooms;
 using osu.Game.Scoring;
 
 namespace osu.Game.Online.Solo
 {
-    public class SubmitSoloScoreRequest : APIRequest<MultiplayerScore>
+    public class SubmitSoloScoreRequest : SubmitScoreRequest
     {
-        public readonly SubmittableScore Score;
-
-        private readonly long scoreId;
-
         private readonly int beatmapId;
 
-        public SubmitSoloScoreRequest(int beatmapId, long scoreId, ScoreInfo scoreInfo)
+        public SubmitSoloScoreRequest(ScoreInfo scoreInfo, long scoreId, int beatmapId)
+            : base(scoreInfo, scoreId)
         {
             this.beatmapId = beatmapId;
-            this.scoreId = scoreId;
-            Score = new SubmittableScore(scoreInfo);
         }
 
-        protected override WebRequest CreateWebRequest()
-        {
-            var req = base.CreateWebRequest();
-
-            req.ContentType = "application/json";
-            req.Method = HttpMethod.Put;
-            req.Timeout = 30000;
-
-            req.AddRaw(JsonConvert.SerializeObject(Score, new JsonSerializerSettings
-            {
-                ReferenceLoopHandling = ReferenceLoopHandling.Ignore
-            }));
-
-            return req;
-        }
-
-        protected override string Target => $@"beatmaps/{beatmapId}/solo/scores/{scoreId}";
+        protected override string Target => $@"beatmaps/{beatmapId}/solo/scores/{ScoreId}";
     }
 }
diff --git a/osu.Game/Screens/Play/RoomSubmittingPlayer.cs b/osu.Game/Screens/Play/RoomSubmittingPlayer.cs
index 1002e7607f..fc96dfa965 100644
--- a/osu.Game/Screens/Play/RoomSubmittingPlayer.cs
+++ b/osu.Game/Screens/Play/RoomSubmittingPlayer.cs
@@ -34,7 +34,7 @@ namespace osu.Game.Screens.Play
         protected override APIRequest<MultiplayerScore> CreateSubmissionRequest(Score score, long token)
         {
             Debug.Assert(Room.RoomID.Value != null);
-            return new SubmitRoomScoreRequest(token, Room.RoomID.Value.Value, PlaylistItem.ID, score.ScoreInfo);
+            return new SubmitRoomScoreRequest(score.ScoreInfo, token, Room.RoomID.Value.Value, PlaylistItem.ID);
         }
     }
 }
diff --git a/osu.Game/Screens/Play/SoloPlayer.cs b/osu.Game/Screens/Play/SoloPlayer.cs
index eced2d142b..824c0072e3 100644
--- a/osu.Game/Screens/Play/SoloPlayer.cs
+++ b/osu.Game/Screens/Play/SoloPlayer.cs
@@ -46,7 +46,7 @@ namespace osu.Game.Screens.Play
 
             Debug.Assert(beatmap.OnlineID > 0);
 
-            return new SubmitSoloScoreRequest(beatmap.OnlineID, token, score.ScoreInfo);
+            return new SubmitSoloScoreRequest(score.ScoreInfo, token, beatmap.OnlineID);
         }
     }
 }

From 908c31c68764370e44e9e3a6055aa881a7ce1971 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 11 Feb 2022 16:02:25 +0900
Subject: [PATCH 2855/5547] Update stream read operations to use new helper
 methods

---
 osu.Game/Database/ImportTask.cs       |  5 ++---
 osu.Game/IO/Archives/ArchiveReader.cs | 14 +++-----------
 2 files changed, 5 insertions(+), 14 deletions(-)

diff --git a/osu.Game/Database/ImportTask.cs b/osu.Game/Database/ImportTask.cs
index cd9e396d13..d75c1a73e6 100644
--- a/osu.Game/Database/ImportTask.cs
+++ b/osu.Game/Database/ImportTask.cs
@@ -4,6 +4,7 @@
 #nullable enable
 
 using System.IO;
+using osu.Framework.Extensions;
 using osu.Game.IO.Archives;
 using osu.Game.Stores;
 using osu.Game.Utils;
@@ -63,9 +64,7 @@ namespace osu.Game.Database
             if (!(stream is MemoryStream memoryStream))
             {
                 // This isn't used in any current path. May need to reconsider for performance reasons (ie. if we don't expect the incoming stream to be copied out).
-                byte[] buffer = new byte[stream.Length];
-                stream.Read(buffer, 0, (int)stream.Length);
-                memoryStream = new MemoryStream(buffer);
+                memoryStream = new MemoryStream(stream.ReadAllBytesToArray());
             }
 
             if (ZipUtils.IsZipArchive(memoryStream))
diff --git a/osu.Game/IO/Archives/ArchiveReader.cs b/osu.Game/IO/Archives/ArchiveReader.cs
index 1d8da16c72..dab70eaf70 100644
--- a/osu.Game/IO/Archives/ArchiveReader.cs
+++ b/osu.Game/IO/Archives/ArchiveReader.cs
@@ -5,6 +5,7 @@ using System.Collections.Generic;
 using System.IO;
 using System.Threading;
 using System.Threading.Tasks;
+using osu.Framework.Extensions;
 using osu.Framework.IO.Stores;
 
 namespace osu.Game.IO.Archives
@@ -35,14 +36,7 @@ namespace osu.Game.IO.Archives
         public virtual byte[] Get(string name)
         {
             using (Stream input = GetStream(name))
-            {
-                if (input == null)
-                    return null;
-
-                byte[] buffer = new byte[input.Length];
-                input.Read(buffer);
-                return buffer;
-            }
+                return input?.ReadAllBytesToArray();
         }
 
         public async Task<byte[]> GetAsync(string name, CancellationToken cancellationToken = default)
@@ -52,9 +46,7 @@ namespace osu.Game.IO.Archives
                 if (input == null)
                     return null;
 
-                byte[] buffer = new byte[input.Length];
-                await input.ReadAsync(buffer, cancellationToken).ConfigureAwait(false);
-                return buffer;
+                return await input.ReadAllBytesToArrayAsync(cancellationToken).ConfigureAwait(false);
             }
         }
     }

From 6005daeba8bda373622123167bc533e2738704d3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 11 Feb 2022 16:02:42 +0900
Subject: [PATCH 2856/5547] Fix fire-and-forget async calls to use `WaitSafely`

---
 osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
index 8f6ba6375f..7661cf671b 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
@@ -829,7 +829,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddStep("add item as other user", () => client.AddUserPlaylistItem(1234, new MultiplayerPlaylistItem(new PlaylistItem
             {
                 BeatmapID = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo.OnlineID
-            })));
+            })).WaitSafely());
 
             AddUntilStep("item arrived in playlist", () => client.Room?.Playlist.Count == 2);
 
@@ -860,11 +860,11 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddStep("add item as other user", () => client.AddUserPlaylistItem(1234, new MultiplayerPlaylistItem(new PlaylistItem
             {
                 BeatmapID = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo.OnlineID
-            })));
+            })).WaitSafely());
 
             AddUntilStep("item arrived in playlist", () => client.Room?.Playlist.Count == 2);
 
-            AddStep("delete item as other user", () => client.RemoveUserPlaylistItem(1234, 2));
+            AddStep("delete item as other user", () => client.RemoveUserPlaylistItem(1234, 2).WaitSafely());
             AddUntilStep("item removed from playlist", () => client.Room?.Playlist.Count == 1);
 
             AddStep("exit gameplay as initial user", () => multiplayerComponents.MultiplayerScreen.MakeCurrent());

From 28bbf34b1495908b1e145f8575f6ffaaf0979bd4 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 11 Feb 2022 16:21:49 +0900
Subject: [PATCH 2857/5547] Remove unnecessary `this.` prefix

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

diff --git a/osu.Game/Online/Rooms/SubmitScoreRequest.cs b/osu.Game/Online/Rooms/SubmitScoreRequest.cs
index 14f858f007..b263262d2b 100644
--- a/osu.Game/Online/Rooms/SubmitScoreRequest.cs
+++ b/osu.Game/Online/Rooms/SubmitScoreRequest.cs
@@ -19,7 +19,7 @@ namespace osu.Game.Online.Rooms
         protected SubmitScoreRequest(ScoreInfo scoreInfo, long scoreId)
         {
             Score = new SubmittableScore(scoreInfo);
-            this.ScoreId = scoreId;
+            ScoreId = scoreId;
         }
 
         protected override WebRequest CreateWebRequest()

From 2ed3d5853144436f76260feb38f0d4d1c3a56e52 Mon Sep 17 00:00:00 2001
From: PercyDan54 <50285552+PercyDan54@users.noreply.github.com>
Date: Sat, 12 Feb 2022 08:51:09 +0800
Subject: [PATCH 2858/5547] Ignore short spinners for relax mod

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

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModRelax.cs b/osu.Game.Rulesets.Osu/Mods/OsuModRelax.cs
index 5d191119b9..905d55c64e 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModRelax.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModRelax.cs
@@ -87,8 +87,9 @@ namespace osu.Game.Rulesets.Osu.Mods
                         requiresHold |= slider.Ball.IsHovered || h.IsHovered;
                         break;
 
-                    case DrawableSpinner _:
-                        requiresHold = true;
+                    case DrawableSpinner spinner:
+                        if (spinner.HitObject.SpinsRequired > 0)
+                            requiresHold = true;
                         break;
                 }
             }

From 053f41d755999ec120c1674c958cfadadb7898f7 Mon Sep 17 00:00:00 2001
From: PercyDan54 <50285552+PercyDan54@users.noreply.github.com>
Date: Sat, 12 Feb 2022 10:06:43 +0800
Subject: [PATCH 2859/5547] Simplify code

---
 osu.Game.Rulesets.Osu/Mods/OsuModRelax.cs | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModRelax.cs b/osu.Game.Rulesets.Osu/Mods/OsuModRelax.cs
index 905d55c64e..10abd24e80 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModRelax.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModRelax.cs
@@ -88,8 +88,7 @@ namespace osu.Game.Rulesets.Osu.Mods
                         break;
 
                     case DrawableSpinner spinner:
-                        if (spinner.HitObject.SpinsRequired > 0)
-                            requiresHold = true;
+                        requiresHold = spinner.HitObject.SpinsRequired > 0;
                         break;
                 }
             }

From 639d813d06fe2275b6220fc41b6133e0390de5f5 Mon Sep 17 00:00:00 2001
From: PercyDan <50285552+PercyDan54@users.noreply.github.com>
Date: Sat, 12 Feb 2022 11:15:03 +0800
Subject: [PATCH 2860/5547] Don't override previous value

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

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModRelax.cs b/osu.Game.Rulesets.Osu/Mods/OsuModRelax.cs
index 10abd24e80..1bf63ef6d4 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModRelax.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModRelax.cs
@@ -88,7 +88,7 @@ namespace osu.Game.Rulesets.Osu.Mods
                         break;
 
                     case DrawableSpinner spinner:
-                        requiresHold = spinner.HitObject.SpinsRequired > 0;
+                        requiresHold |= spinner.HitObject.SpinsRequired > 0;
                         break;
                 }
             }

From f1535b74beb185c83f76d7e7e3a54e55b6c32a81 Mon Sep 17 00:00:00 2001
From: Kaleb <sh0ck.04@outlook.com>
Date: Sun, 13 Feb 2022 02:16:06 -0500
Subject: [PATCH 2861/5547] Give Spun Out mod dynamic spin rate

---
 osu.Game.Rulesets.Osu/Mods/OsuModSpunOut.cs | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModSpunOut.cs b/osu.Game.Rulesets.Osu/Mods/OsuModSpunOut.cs
index 098c639949..b900fa3274 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModSpunOut.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModSpunOut.cs
@@ -45,7 +45,8 @@ namespace osu.Game.Rulesets.Osu.Mods
             // for that reason using ElapsedFrameTime directly leads to fewer SPM with Half Time and more SPM with Double Time.
             // for spinners we want the real (wall clock) elapsed time; to achieve that, unapply the clock rate locally here.
             double rateIndependentElapsedTime = spinner.Clock.ElapsedFrameTime / spinner.Clock.Rate;
-            spinner.RotationTracker.AddRotation(MathUtils.RadiansToDegrees((float)rateIndependentElapsedTime * 0.03f));
+            float rotationSpeed = (float)(spinner.HitObject.SpinsRequired / spinner.HitObject.Duration / 1.01);
+            spinner.RotationTracker.AddRotation(MathUtils.RadiansToDegrees((float)rateIndependentElapsedTime * rotationSpeed * MathF.PI * 2.0f));
         }
     }
 }

From 585bd541f319ce316c8c4eef80aeb4247449b232 Mon Sep 17 00:00:00 2001
From: Kaleb <sh0ck.04@outlook.com>
Date: Sun, 13 Feb 2022 02:38:49 -0500
Subject: [PATCH 2862/5547] Add missing parentheses to RPM calculation

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

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModSpunOut.cs b/osu.Game.Rulesets.Osu/Mods/OsuModSpunOut.cs
index b900fa3274..4725a43a77 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModSpunOut.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModSpunOut.cs
@@ -45,7 +45,7 @@ namespace osu.Game.Rulesets.Osu.Mods
             // for that reason using ElapsedFrameTime directly leads to fewer SPM with Half Time and more SPM with Double Time.
             // for spinners we want the real (wall clock) elapsed time; to achieve that, unapply the clock rate locally here.
             double rateIndependentElapsedTime = spinner.Clock.ElapsedFrameTime / spinner.Clock.Rate;
-            float rotationSpeed = (float)(spinner.HitObject.SpinsRequired / spinner.HitObject.Duration / 1.01);
+            float rotationSpeed = (float)(spinner.HitObject.SpinsRequired / (spinner.HitObject.Duration / 1.01));
             spinner.RotationTracker.AddRotation(MathUtils.RadiansToDegrees((float)rateIndependentElapsedTime * rotationSpeed * MathF.PI * 2.0f));
         }
     }

From a2c2b2bbb3dcbd87f9c4c08582b00b98f1096e79 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 6 Feb 2022 17:52:59 +0100
Subject: [PATCH 2863/5547] Add flow for copying existing difficulty content

---
 osu.Game/Beatmaps/BeatmapManager.cs           | 34 ++++++++------
 .../Screens/Edit/CreateNewDifficultyDialog.cs | 45 +++++++++++++++++++
 osu.Game/Screens/Edit/Editor.cs               | 20 ++++++++-
 osu.Game/Screens/Edit/EditorLoader.cs         |  7 ++-
 .../Edit/NewDifficultyCreationParameters.cs   | 36 +++++++++++++++
 osu.Game/Tests/Visual/EditorTestScene.cs      |  2 +-
 6 files changed, 125 insertions(+), 19 deletions(-)
 create mode 100644 osu.Game/Screens/Edit/CreateNewDifficultyDialog.cs
 create mode 100644 osu.Game/Screens/Edit/NewDifficultyCreationParameters.cs

diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index 633eb8f15e..bd9cdba9fb 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -20,6 +20,7 @@ using osu.Game.Online.API;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays.Notifications;
 using osu.Game.Rulesets;
+using osu.Game.Screens.Edit;
 using osu.Game.Skinning;
 using osu.Game.Stores;
 
@@ -112,29 +113,36 @@ namespace osu.Game.Beatmaps
         /// The new difficulty will be backed by a <see cref="BeatmapInfo"/> model
         /// and represented by the returned <see cref="WorkingBeatmap"/>.
         /// </summary>
-        public virtual WorkingBeatmap CreateNewBlankDifficulty(BeatmapSetInfo beatmapSetInfo, RulesetInfo rulesetInfo)
+        public virtual WorkingBeatmap CreateNewBlankDifficulty(NewDifficultyCreationParameters creationParameters)
         {
-            // fetch one of the existing difficulties to copy timing points and metadata from,
-            // so that the user doesn't have to fill all of that out again.
-            // this silently assumes that all difficulties have the same timing points and metadata,
-            // but cases where this isn't true seem rather rare / pathological.
-            var referenceBeatmap = GetWorkingBeatmap(beatmapSetInfo.Beatmaps.First());
+            var referenceBeatmap = creationParameters.ReferenceBeatmap;
+            var targetBeatmapSet = creationParameters.BeatmapSet;
 
-            var newBeatmapInfo = new BeatmapInfo(rulesetInfo, new BeatmapDifficulty(), referenceBeatmap.Metadata.DeepClone());
+            var newBeatmapInfo = new BeatmapInfo(creationParameters.Ruleset, new BeatmapDifficulty(), referenceBeatmap.Metadata.DeepClone());
 
             // populate circular beatmap set info <-> beatmap info references manually.
             // several places like `BeatmapModelManager.Save()` or `GetWorkingBeatmap()`
             // rely on them being freely traversable in both directions for correct operation.
-            beatmapSetInfo.Beatmaps.Add(newBeatmapInfo);
-            newBeatmapInfo.BeatmapSet = beatmapSetInfo;
+            targetBeatmapSet.Beatmaps.Add(newBeatmapInfo);
+            newBeatmapInfo.BeatmapSet = targetBeatmapSet;
 
-            var newBeatmap = new Beatmap { BeatmapInfo = newBeatmapInfo };
-            foreach (var timingPoint in referenceBeatmap.Beatmap.ControlPointInfo.TimingPoints)
-                newBeatmap.ControlPointInfo.Add(timingPoint.Time, timingPoint.DeepClone());
+            IBeatmap newBeatmap;
+
+            if (creationParameters.ClearAllObjects)
+            {
+                newBeatmap = new Beatmap { BeatmapInfo = newBeatmapInfo };
+                foreach (var timingPoint in referenceBeatmap.ControlPointInfo.TimingPoints)
+                    newBeatmap.ControlPointInfo.Add(timingPoint.Time, timingPoint.DeepClone());
+            }
+            else
+            {
+                newBeatmap = referenceBeatmap.Clone();
+                newBeatmap.BeatmapInfo = newBeatmapInfo;
+            }
 
             beatmapModelManager.Save(newBeatmapInfo, newBeatmap);
 
-            workingBeatmapCache.Invalidate(beatmapSetInfo);
+            workingBeatmapCache.Invalidate(targetBeatmapSet);
             return GetWorkingBeatmap(newBeatmap.BeatmapInfo);
         }
 
diff --git a/osu.Game/Screens/Edit/CreateNewDifficultyDialog.cs b/osu.Game/Screens/Edit/CreateNewDifficultyDialog.cs
new file mode 100644
index 0000000000..472f0e8948
--- /dev/null
+++ b/osu.Game/Screens/Edit/CreateNewDifficultyDialog.cs
@@ -0,0 +1,45 @@
+// 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.Sprites;
+using osu.Game.Overlays.Dialog;
+
+namespace osu.Game.Screens.Edit
+{
+    public class CreateNewDifficultyDialog : PopupDialog
+    {
+        /// <summary>
+        /// Delegate used to create new difficulties.
+        /// A value of <see langword="true"/> in the <c>clearAllObjects</c> parameter
+        /// indicates that the new difficulty should have its hitobjects cleared;
+        /// otherwise, the new difficulty should be an exact copy of an existing one.
+        /// </summary>
+        public delegate void CreateNewDifficulty(bool clearAllObjects);
+
+        public CreateNewDifficultyDialog(CreateNewDifficulty createNewDifficulty)
+        {
+            HeaderText = "Would you like to clear all objects?";
+
+            Icon = FontAwesome.Regular.Clone;
+
+            Buttons = new PopupDialogButton[]
+            {
+                new PopupDialogOkButton
+                {
+                    Text = "Yeah, let's start from scratch!",
+                    Action = () => createNewDifficulty.Invoke(true)
+                },
+                new PopupDialogCancelButton
+                {
+                    Text = "No, create an exact copy of this difficulty",
+                    Action = () => createNewDifficulty.Invoke(false)
+                },
+                new PopupDialogCancelButton
+                {
+                    Text = "I changed my mind, I want to keep editing this difficulty",
+                    Action = () => { }
+                }
+            };
+        }
+    }
+}
diff --git a/osu.Game/Screens/Edit/Editor.cs b/osu.Game/Screens/Edit/Editor.cs
index 2aec63fa65..c5578287e3 100644
--- a/osu.Game/Screens/Edit/Editor.cs
+++ b/osu.Game/Screens/Edit/Editor.cs
@@ -841,7 +841,25 @@ namespace osu.Game.Screens.Edit
         }
 
         protected void CreateNewDifficulty(RulesetInfo rulesetInfo)
-            => loader?.ScheduleSwitchToNewDifficulty(editorBeatmap.BeatmapInfo.BeatmapSet, rulesetInfo, GetState());
+        {
+            if (!rulesetInfo.Equals(editorBeatmap.BeatmapInfo.Ruleset))
+            {
+                switchToNewDifficulty(rulesetInfo, true);
+                return;
+            }
+
+            dialogOverlay.Push(new CreateNewDifficultyDialog(clearAllObjects => switchToNewDifficulty(rulesetInfo, clearAllObjects)));
+        }
+
+        private void switchToNewDifficulty(RulesetInfo rulesetInfo, bool clearAllObjects)
+            => loader?.ScheduleSwitchToNewDifficulty(new NewDifficultyCreationParameters
+            {
+                BeatmapSet = editorBeatmap.BeatmapInfo.BeatmapSet,
+                Ruleset = rulesetInfo,
+                ReferenceBeatmap = playableBeatmap,
+                ClearAllObjects = clearAllObjects,
+                EditorState = GetState()
+            });
 
         private EditorMenuItem createDifficultySwitchMenu()
         {
diff --git a/osu.Game/Screens/Edit/EditorLoader.cs b/osu.Game/Screens/Edit/EditorLoader.cs
index de47411fdc..169b601a94 100644
--- a/osu.Game/Screens/Edit/EditorLoader.cs
+++ b/osu.Game/Screens/Edit/EditorLoader.cs
@@ -11,7 +11,6 @@ using osu.Framework.Screens;
 using osu.Framework.Threading;
 using osu.Game.Beatmaps;
 using osu.Game.Graphics.UserInterface;
-using osu.Game.Rulesets;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Screens.Menu;
 using osu.Game.Screens.Play;
@@ -80,12 +79,12 @@ namespace osu.Game.Screens.Edit
             }
         }
 
-        public void ScheduleSwitchToNewDifficulty(BeatmapSetInfo beatmapSetInfo, RulesetInfo rulesetInfo, EditorState editorState)
+        public void ScheduleSwitchToNewDifficulty(NewDifficultyCreationParameters creationParameters)
             => scheduleDifficultySwitch(() =>
             {
                 try
                 {
-                    return beatmapManager.CreateNewBlankDifficulty(beatmapSetInfo, rulesetInfo);
+                    return beatmapManager.CreateNewBlankDifficulty(creationParameters);
                 }
                 catch (Exception ex)
                 {
@@ -94,7 +93,7 @@ namespace osu.Game.Screens.Edit
                     Logger.Error(ex, ex.Message);
                     return Beatmap.Value;
                 }
-            }, editorState);
+            }, creationParameters.EditorState);
 
         public void ScheduleSwitchToExistingDifficulty(BeatmapInfo beatmapInfo, EditorState editorState)
             => scheduleDifficultySwitch(() => beatmapManager.GetWorkingBeatmap(beatmapInfo), editorState);
diff --git a/osu.Game/Screens/Edit/NewDifficultyCreationParameters.cs b/osu.Game/Screens/Edit/NewDifficultyCreationParameters.cs
new file mode 100644
index 0000000000..dd03fd3644
--- /dev/null
+++ b/osu.Game/Screens/Edit/NewDifficultyCreationParameters.cs
@@ -0,0 +1,36 @@
+// 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.Beatmaps;
+using osu.Game.Rulesets;
+
+namespace osu.Game.Screens.Edit
+{
+    public class NewDifficultyCreationParameters
+    {
+        /// <summary>
+        /// The <see cref="BeatmapSetInfo"/> that should contain the newly-created difficulty.
+        /// </summary>
+        public BeatmapSetInfo BeatmapSet { get; set; }
+
+        /// <summary>
+        /// The <see cref="RulesetInfo"/> that the new difficulty should be playable for.
+        /// </summary>
+        public RulesetInfo Ruleset { get; set; }
+
+        /// <summary>
+        /// A reference <see cref="IBeatmap"/> upon which the new difficulty should be based.
+        /// </summary>
+        public IBeatmap ReferenceBeatmap { get; set; }
+
+        /// <summary>
+        /// Whether all objects should be cleared from the new difficulty.
+        /// </summary>
+        public bool ClearAllObjects { get; set; }
+
+        /// <summary>
+        /// The saved state of the previous <see cref="Editor"/> which should be restored upon opening the newly-created difficulty.
+        /// </summary>
+        public EditorState EditorState { get; set; }
+    }
+}
diff --git a/osu.Game/Tests/Visual/EditorTestScene.cs b/osu.Game/Tests/Visual/EditorTestScene.cs
index 331bf04644..ff09598eef 100644
--- a/osu.Game/Tests/Visual/EditorTestScene.cs
+++ b/osu.Game/Tests/Visual/EditorTestScene.cs
@@ -136,7 +136,7 @@ namespace osu.Game.Tests.Visual
                 return new TestWorkingBeatmapCache(this, audioManager, resources, storage, defaultBeatmap, host);
             }
 
-            public override WorkingBeatmap CreateNewBlankDifficulty(BeatmapSetInfo beatmapSetInfo, RulesetInfo rulesetInfo)
+            public override WorkingBeatmap CreateNewBlankDifficulty(NewDifficultyCreationParameters creationParameters)
             {
                 // don't actually care about properly creating a difficulty for this context.
                 return TestBeatmap;

From 0d1171b7fae94ea769598bb2b5f0dff194c6c32d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 6 Feb 2022 17:56:51 +0100
Subject: [PATCH 2864/5547] Adjust existing test coverage to pass

---
 .../Editing/TestSceneEditorBeatmapCreation.cs | 23 +++++++++++++++----
 1 file changed, 19 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneEditorBeatmapCreation.cs b/osu.Game.Tests/Visual/Editing/TestSceneEditorBeatmapCreation.cs
index a14c9aded3..89a9307f9f 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneEditorBeatmapCreation.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneEditorBeatmapCreation.cs
@@ -10,6 +10,7 @@ using osu.Framework.Screens;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets;
+using osu.Game.Rulesets.Catch;
 using osu.Game.Rulesets.Osu;
 using osu.Game.Screens.Edit;
 using osu.Game.Screens.Edit.Setup;
@@ -92,7 +93,7 @@ namespace osu.Game.Tests.Visual.Editing
         }
 
         [Test]
-        public void TestCreateNewDifficulty()
+        public void TestCreateNewDifficulty([Values] bool sameRuleset)
         {
             string firstDifficultyName = Guid.NewGuid().ToString();
             string secondDifficultyName = Guid.NewGuid().ToString();
@@ -111,7 +112,14 @@ namespace osu.Game.Tests.Visual.Editing
             });
             AddAssert("can save again", () => Editor.Save());
 
-            AddStep("create new difficulty", () => Editor.CreateNewDifficulty(new OsuRuleset().RulesetInfo));
+            AddStep("create new difficulty", () => Editor.CreateNewDifficulty(sameRuleset ? new OsuRuleset().RulesetInfo : new CatchRuleset().RulesetInfo));
+
+            if (sameRuleset)
+            {
+                AddUntilStep("wait for dialog", () => DialogOverlay.CurrentDialog is CreateNewDifficultyDialog);
+                AddStep("confirm creation with no objects", () => DialogOverlay.CurrentDialog.PerformOkAction());
+            }
+
             AddUntilStep("wait for created", () =>
             {
                 string difficultyName = Editor.ChildrenOfType<EditorBeatmap>().SingleOrDefault()?.BeatmapInfo.DifficultyName;
@@ -154,7 +162,7 @@ namespace osu.Game.Tests.Visual.Editing
         }
 
         [Test]
-        public void TestCreateNewBeatmapFailsWithSameNamedDifficulties()
+        public void TestCreateNewBeatmapFailsWithSameNamedDifficulties([Values] bool sameRuleset)
         {
             Guid setId = Guid.Empty;
             const string duplicate_difficulty_name = "duplicate";
@@ -168,7 +176,14 @@ namespace osu.Game.Tests.Visual.Editing
                 return set != null && set.PerformRead(s => s.Beatmaps.Count == 1 && s.Files.Count == 1);
             });
 
-            AddStep("create new difficulty", () => Editor.CreateNewDifficulty(new OsuRuleset().RulesetInfo));
+            AddStep("create new difficulty", () => Editor.CreateNewDifficulty(sameRuleset ? new OsuRuleset().RulesetInfo : new CatchRuleset().RulesetInfo));
+
+            if (sameRuleset)
+            {
+                AddUntilStep("wait for dialog", () => DialogOverlay.CurrentDialog is CreateNewDifficultyDialog);
+                AddStep("confirm creation with no objects", () => DialogOverlay.CurrentDialog.PerformOkAction());
+            }
+
             AddUntilStep("wait for created", () =>
             {
                 string difficultyName = Editor.ChildrenOfType<EditorBeatmap>().SingleOrDefault()?.BeatmapInfo.DifficultyName;

From eb939547a9978e0d4e47a65f90c3b5b902b7d988 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 6 Feb 2022 18:03:54 +0100
Subject: [PATCH 2865/5547] Add test coverage for difficulty copy flow

---
 .../Editing/TestSceneEditorBeatmapCreation.cs | 93 +++++++++++++++++++
 1 file changed, 93 insertions(+)

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneEditorBeatmapCreation.cs b/osu.Game.Tests/Visual/Editing/TestSceneEditorBeatmapCreation.cs
index 89a9307f9f..91f667d8b0 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneEditorBeatmapCreation.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneEditorBeatmapCreation.cs
@@ -9,13 +9,17 @@ using osu.Framework.Allocation;
 using osu.Framework.Screens;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
+using osu.Game.Beatmaps.ControlPoints;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Catch;
 using osu.Game.Rulesets.Osu;
+using osu.Game.Rulesets.Osu.Objects;
+using osu.Game.Rulesets.Osu.UI;
 using osu.Game.Screens.Edit;
 using osu.Game.Screens.Edit.Setup;
 using osu.Game.Storyboards;
 using osu.Game.Tests.Resources;
+using osuTK;
 using SharpCompress.Archives;
 using SharpCompress.Archives.Zip;
 
@@ -99,6 +103,21 @@ namespace osu.Game.Tests.Visual.Editing
             string secondDifficultyName = Guid.NewGuid().ToString();
 
             AddStep("set unique difficulty name", () => EditorBeatmap.BeatmapInfo.DifficultyName = firstDifficultyName);
+            AddStep("add timing point", () => EditorBeatmap.ControlPointInfo.Add(0, new TimingControlPoint { BeatLength = 1000 }));
+            AddStep("add hitobjects", () => EditorBeatmap.AddRange(new[]
+            {
+                new HitCircle
+                {
+                    Position = new Vector2(0),
+                    StartTime = 0
+                },
+                new HitCircle
+                {
+                    Position = OsuPlayfield.BASE_SIZE,
+                    StartTime = 1000
+                }
+            }));
+
             AddStep("save beatmap", () => Editor.Save());
             AddAssert("new beatmap persisted", () =>
             {
@@ -126,6 +145,80 @@ namespace osu.Game.Tests.Visual.Editing
                 return difficultyName != null && difficultyName != firstDifficultyName;
             });
 
+            AddAssert("created difficulty has timing point", () =>
+            {
+                var timingPoint = EditorBeatmap.ControlPointInfo.TimingPoints.Single();
+                return timingPoint.Time == 0 && timingPoint.BeatLength == 1000;
+            });
+            AddAssert("created difficulty has no objects", () => EditorBeatmap.HitObjects.Count == 0);
+
+            AddStep("set unique difficulty name", () => EditorBeatmap.BeatmapInfo.DifficultyName = secondDifficultyName);
+            AddStep("save beatmap", () => Editor.Save());
+            AddAssert("new beatmap persisted", () =>
+            {
+                var beatmap = beatmapManager.QueryBeatmap(b => b.DifficultyName == secondDifficultyName);
+                var set = beatmapManager.QueryBeatmapSet(s => s.ID == EditorBeatmap.BeatmapInfo.BeatmapSet.ID);
+
+                return beatmap != null
+                       && beatmap.DifficultyName == secondDifficultyName
+                       && set != null
+                       && set.PerformRead(s => s.Beatmaps.Count == 2 && s.Beatmaps.Any(b => b.DifficultyName == secondDifficultyName));
+            });
+        }
+
+        [Test]
+        public void TestCopyDifficulty()
+        {
+            string firstDifficultyName = Guid.NewGuid().ToString();
+            string secondDifficultyName = Guid.NewGuid().ToString();
+
+            AddStep("set unique difficulty name", () => EditorBeatmap.BeatmapInfo.DifficultyName = firstDifficultyName);
+            AddStep("add timing point", () => EditorBeatmap.ControlPointInfo.Add(0, new TimingControlPoint { BeatLength = 1000 }));
+            AddStep("add hitobjects", () => EditorBeatmap.AddRange(new[]
+            {
+                new HitCircle
+                {
+                    Position = new Vector2(0),
+                    StartTime = 0
+                },
+                new HitCircle
+                {
+                    Position = OsuPlayfield.BASE_SIZE,
+                    StartTime = 1000
+                }
+            }));
+
+            AddStep("save beatmap", () => Editor.Save());
+            AddAssert("new beatmap persisted", () =>
+            {
+                var beatmap = beatmapManager.QueryBeatmap(b => b.DifficultyName == firstDifficultyName);
+                var set = beatmapManager.QueryBeatmapSet(s => s.ID == EditorBeatmap.BeatmapInfo.BeatmapSet.ID);
+
+                return beatmap != null
+                       && beatmap.DifficultyName == firstDifficultyName
+                       && set != null
+                       && set.PerformRead(s => s.Beatmaps.Single().ID == beatmap.ID);
+            });
+            AddAssert("can save again", () => Editor.Save());
+
+            AddStep("create new difficulty", () => Editor.CreateNewDifficulty(new OsuRuleset().RulesetInfo));
+
+            AddUntilStep("wait for dialog", () => DialogOverlay.CurrentDialog is CreateNewDifficultyDialog);
+            AddStep("confirm creation as a copy", () => DialogOverlay.CurrentDialog.Buttons.ElementAt(1).TriggerClick());
+
+            AddUntilStep("wait for created", () =>
+            {
+                string difficultyName = Editor.ChildrenOfType<EditorBeatmap>().SingleOrDefault()?.BeatmapInfo.DifficultyName;
+                return difficultyName != null && difficultyName != firstDifficultyName;
+            });
+
+            AddAssert("created difficulty has timing point", () =>
+            {
+                var timingPoint = EditorBeatmap.ControlPointInfo.TimingPoints.Single();
+                return timingPoint.Time == 0 && timingPoint.BeatLength == 1000;
+            });
+            AddAssert("created difficulty has objects", () => EditorBeatmap.HitObjects.Count == 2);
+
             AddStep("set unique difficulty name", () => EditorBeatmap.BeatmapInfo.DifficultyName = secondDifficultyName);
             AddStep("save beatmap", () => Editor.Save());
             AddAssert("new beatmap persisted", () =>

From fd1c8c361444f1bd7077379d64a1c03e5576c0f6 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 6 Feb 2022 18:26:19 +0100
Subject: [PATCH 2866/5547] Add failing test coverage for correct beatmap
 difficulty copy

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

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneEditorBeatmapCreation.cs b/osu.Game.Tests/Visual/Editing/TestSceneEditorBeatmapCreation.cs
index 91f667d8b0..672e643e60 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneEditorBeatmapCreation.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneEditorBeatmapCreation.cs
@@ -187,6 +187,7 @@ namespace osu.Game.Tests.Visual.Editing
                     StartTime = 1000
                 }
             }));
+            AddStep("set approach rate", () => EditorBeatmap.Difficulty.ApproachRate = 4);
 
             AddStep("save beatmap", () => Editor.Save());
             AddAssert("new beatmap persisted", () =>
@@ -218,6 +219,7 @@ namespace osu.Game.Tests.Visual.Editing
                 return timingPoint.Time == 0 && timingPoint.BeatLength == 1000;
             });
             AddAssert("created difficulty has objects", () => EditorBeatmap.HitObjects.Count == 2);
+            AddAssert("approach rate correctly copied", () => EditorBeatmap.Difficulty.ApproachRate == 4);
 
             AddStep("set unique difficulty name", () => EditorBeatmap.BeatmapInfo.DifficultyName = secondDifficultyName);
             AddStep("save beatmap", () => Editor.Save());

From 1bf5375e746f6be78a992594fda76b821b72cb88 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 6 Feb 2022 18:40:51 +0100
Subject: [PATCH 2867/5547] Fix `BeatmapInfo`-associated member not copying

---
 osu.Game/Beatmaps/BeatmapManager.cs | 22 +++++++++++++---------
 1 file changed, 13 insertions(+), 9 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index bd9cdba9fb..c350cfc111 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -118,18 +118,12 @@ namespace osu.Game.Beatmaps
             var referenceBeatmap = creationParameters.ReferenceBeatmap;
             var targetBeatmapSet = creationParameters.BeatmapSet;
 
-            var newBeatmapInfo = new BeatmapInfo(creationParameters.Ruleset, new BeatmapDifficulty(), referenceBeatmap.Metadata.DeepClone());
-
-            // populate circular beatmap set info <-> beatmap info references manually.
-            // several places like `BeatmapModelManager.Save()` or `GetWorkingBeatmap()`
-            // rely on them being freely traversable in both directions for correct operation.
-            targetBeatmapSet.Beatmaps.Add(newBeatmapInfo);
-            newBeatmapInfo.BeatmapSet = targetBeatmapSet;
-
+            BeatmapInfo newBeatmapInfo;
             IBeatmap newBeatmap;
 
             if (creationParameters.ClearAllObjects)
             {
+                newBeatmapInfo = new BeatmapInfo(creationParameters.Ruleset, new BeatmapDifficulty(), referenceBeatmap.Metadata.DeepClone());
                 newBeatmap = new Beatmap { BeatmapInfo = newBeatmapInfo };
                 foreach (var timingPoint in referenceBeatmap.ControlPointInfo.TimingPoints)
                     newBeatmap.ControlPointInfo.Add(timingPoint.Time, timingPoint.DeepClone());
@@ -137,9 +131,19 @@ namespace osu.Game.Beatmaps
             else
             {
                 newBeatmap = referenceBeatmap.Clone();
-                newBeatmap.BeatmapInfo = newBeatmapInfo;
+                newBeatmap.BeatmapInfo = newBeatmapInfo = referenceBeatmap.BeatmapInfo.Clone();
+                // assign a new ID to the clone.
+                newBeatmapInfo.ID = Guid.NewGuid();
+                // clear difficulty name to avoid clashes on save.
+                newBeatmapInfo.DifficultyName = string.Empty;
             }
 
+            // populate circular beatmap set info <-> beatmap info references manually.
+            // several places like `BeatmapModelManager.Save()` or `GetWorkingBeatmap()`
+            // rely on them being freely traversable in both directions for correct operation.
+            targetBeatmapSet.Beatmaps.Add(newBeatmapInfo);
+            newBeatmapInfo.BeatmapSet = targetBeatmapSet;
+
             beatmapModelManager.Save(newBeatmapInfo, newBeatmap);
 
             workingBeatmapCache.Invalidate(targetBeatmapSet);

From 1292722a00e331933852f1842455a3e25108c4cc Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 6 Feb 2022 18:44:12 +0100
Subject: [PATCH 2868/5547] Add failing test coverage for correct combo colour
 copy

---
 .../Editing/TestSceneEditorBeatmapCreation.cs       | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneEditorBeatmapCreation.cs b/osu.Game.Tests/Visual/Editing/TestSceneEditorBeatmapCreation.cs
index 672e643e60..90b1d3a6f9 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneEditorBeatmapCreation.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneEditorBeatmapCreation.cs
@@ -6,6 +6,8 @@ using System.IO;
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
+using osu.Framework.Extensions.ObjectExtensions;
+using osu.Framework.Graphics;
 using osu.Framework.Screens;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
@@ -188,6 +190,16 @@ namespace osu.Game.Tests.Visual.Editing
                 }
             }));
             AddStep("set approach rate", () => EditorBeatmap.Difficulty.ApproachRate = 4);
+            AddStep("set combo colours", () =>
+            {
+                var beatmapSkin = EditorBeatmap.BeatmapSkin.AsNonNull();
+                beatmapSkin.ComboColours.Clear();
+                beatmapSkin.ComboColours.AddRange(new[]
+                {
+                    new Colour4(255, 0, 0, 255),
+                    new Colour4(0, 0, 255, 255)
+                });
+            });
 
             AddStep("save beatmap", () => Editor.Save());
             AddAssert("new beatmap persisted", () =>
@@ -220,6 +232,7 @@ namespace osu.Game.Tests.Visual.Editing
             });
             AddAssert("created difficulty has objects", () => EditorBeatmap.HitObjects.Count == 2);
             AddAssert("approach rate correctly copied", () => EditorBeatmap.Difficulty.ApproachRate == 4);
+            AddAssert("combo colours correctly copied", () => EditorBeatmap.BeatmapSkin.AsNonNull().ComboColours.Count == 2);
 
             AddStep("set unique difficulty name", () => EditorBeatmap.BeatmapInfo.DifficultyName = secondDifficultyName);
             AddStep("save beatmap", () => Editor.Save());

From a144d6f8d67b0fe6c90021b3309682f323da9322 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 6 Feb 2022 18:50:11 +0100
Subject: [PATCH 2869/5547] Fix beatmap skin properties not copying

---
 osu.Game/Beatmaps/BeatmapManager.cs           |  2 +-
 osu.Game/Screens/Edit/Editor.cs               | 16 +++++----
 .../Edit/NewDifficultyCreationParameters.cs   | 34 ++++++++++++++++---
 3 files changed, 39 insertions(+), 13 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index c350cfc111..a9d0576696 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -144,7 +144,7 @@ namespace osu.Game.Beatmaps
             targetBeatmapSet.Beatmaps.Add(newBeatmapInfo);
             newBeatmapInfo.BeatmapSet = targetBeatmapSet;
 
-            beatmapModelManager.Save(newBeatmapInfo, newBeatmap);
+            beatmapModelManager.Save(newBeatmapInfo, newBeatmap, creationParameters.ReferenceBeatmapSkin);
 
             workingBeatmapCache.Invalidate(targetBeatmapSet);
             return GetWorkingBeatmap(newBeatmap.BeatmapInfo);
diff --git a/osu.Game/Screens/Edit/Editor.cs b/osu.Game/Screens/Edit/Editor.cs
index c5578287e3..37d4dce60e 100644
--- a/osu.Game/Screens/Edit/Editor.cs
+++ b/osu.Game/Screens/Edit/Editor.cs
@@ -9,6 +9,7 @@ using JetBrains.Annotations;
 using osu.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
+using osu.Framework.Extensions.ObjectExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
@@ -853,13 +854,14 @@ namespace osu.Game.Screens.Edit
 
         private void switchToNewDifficulty(RulesetInfo rulesetInfo, bool clearAllObjects)
             => loader?.ScheduleSwitchToNewDifficulty(new NewDifficultyCreationParameters
-            {
-                BeatmapSet = editorBeatmap.BeatmapInfo.BeatmapSet,
-                Ruleset = rulesetInfo,
-                ReferenceBeatmap = playableBeatmap,
-                ClearAllObjects = clearAllObjects,
-                EditorState = GetState()
-            });
+            (
+                editorBeatmap.BeatmapInfo.BeatmapSet.AsNonNull(),
+                rulesetInfo,
+                playableBeatmap,
+                editorBeatmap.BeatmapSkin,
+                clearAllObjects,
+                GetState()
+            ));
 
         private EditorMenuItem createDifficultySwitchMenu()
         {
diff --git a/osu.Game/Screens/Edit/NewDifficultyCreationParameters.cs b/osu.Game/Screens/Edit/NewDifficultyCreationParameters.cs
index dd03fd3644..aa7dac609b 100644
--- a/osu.Game/Screens/Edit/NewDifficultyCreationParameters.cs
+++ b/osu.Game/Screens/Edit/NewDifficultyCreationParameters.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.
 
+#nullable enable
+
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets;
+using osu.Game.Skinning;
 
 namespace osu.Game.Screens.Edit
 {
@@ -11,26 +14,47 @@ namespace osu.Game.Screens.Edit
         /// <summary>
         /// The <see cref="BeatmapSetInfo"/> that should contain the newly-created difficulty.
         /// </summary>
-        public BeatmapSetInfo BeatmapSet { get; set; }
+        public BeatmapSetInfo BeatmapSet { get; }
 
         /// <summary>
         /// The <see cref="RulesetInfo"/> that the new difficulty should be playable for.
         /// </summary>
-        public RulesetInfo Ruleset { get; set; }
+        public RulesetInfo Ruleset { get; }
 
         /// <summary>
         /// A reference <see cref="IBeatmap"/> upon which the new difficulty should be based.
         /// </summary>
-        public IBeatmap ReferenceBeatmap { get; set; }
+        public IBeatmap ReferenceBeatmap { get; }
+
+        /// <summary>
+        /// A reference <see cref="ISkin"/> that the new difficulty should base its own skin upon.
+        /// </summary>
+        public ISkin? ReferenceBeatmapSkin { get; }
 
         /// <summary>
         /// Whether all objects should be cleared from the new difficulty.
         /// </summary>
-        public bool ClearAllObjects { get; set; }
+        public bool ClearAllObjects { get; }
 
         /// <summary>
         /// The saved state of the previous <see cref="Editor"/> which should be restored upon opening the newly-created difficulty.
         /// </summary>
-        public EditorState EditorState { get; set; }
+        public EditorState EditorState { get; }
+
+        public NewDifficultyCreationParameters(
+            BeatmapSetInfo beatmapSet,
+            RulesetInfo ruleset,
+            IBeatmap referenceBeatmap,
+            ISkin? referenceBeatmapSkin,
+            bool clearAllObjects,
+            EditorState editorState)
+        {
+            BeatmapSet = beatmapSet;
+            Ruleset = ruleset;
+            ReferenceBeatmap = referenceBeatmap;
+            ReferenceBeatmapSkin = referenceBeatmapSkin;
+            ClearAllObjects = clearAllObjects;
+            EditorState = editorState;
+        }
     }
 }

From 6fd663a718b30de3b3064edc4a986d4cc61dfa2f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 6 Feb 2022 19:51:02 +0100
Subject: [PATCH 2870/5547] Apply some renames to convey difference between
 creation options better

---
 osu.Game/Beatmaps/BeatmapManager.cs                 |  4 ++--
 osu.Game/Screens/Edit/CreateNewDifficultyDialog.cs  |  2 +-
 osu.Game/Screens/Edit/EditorLoader.cs               |  2 +-
 .../Screens/Edit/NewDifficultyCreationParameters.cs | 13 +++++++++----
 osu.Game/Tests/Visual/EditorTestScene.cs            |  2 +-
 5 files changed, 14 insertions(+), 9 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index a9d0576696..87051ef650 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -113,7 +113,7 @@ namespace osu.Game.Beatmaps
         /// The new difficulty will be backed by a <see cref="BeatmapInfo"/> model
         /// and represented by the returned <see cref="WorkingBeatmap"/>.
         /// </summary>
-        public virtual WorkingBeatmap CreateNewBlankDifficulty(NewDifficultyCreationParameters creationParameters)
+        public virtual WorkingBeatmap CreateNewDifficulty(NewDifficultyCreationParameters creationParameters)
         {
             var referenceBeatmap = creationParameters.ReferenceBeatmap;
             var targetBeatmapSet = creationParameters.BeatmapSet;
@@ -121,7 +121,7 @@ namespace osu.Game.Beatmaps
             BeatmapInfo newBeatmapInfo;
             IBeatmap newBeatmap;
 
-            if (creationParameters.ClearAllObjects)
+            if (creationParameters.CreateBlank)
             {
                 newBeatmapInfo = new BeatmapInfo(creationParameters.Ruleset, new BeatmapDifficulty(), referenceBeatmap.Metadata.DeepClone());
                 newBeatmap = new Beatmap { BeatmapInfo = newBeatmapInfo };
diff --git a/osu.Game/Screens/Edit/CreateNewDifficultyDialog.cs b/osu.Game/Screens/Edit/CreateNewDifficultyDialog.cs
index 472f0e8948..138e13bda1 100644
--- a/osu.Game/Screens/Edit/CreateNewDifficultyDialog.cs
+++ b/osu.Game/Screens/Edit/CreateNewDifficultyDialog.cs
@@ -18,7 +18,7 @@ namespace osu.Game.Screens.Edit
 
         public CreateNewDifficultyDialog(CreateNewDifficulty createNewDifficulty)
         {
-            HeaderText = "Would you like to clear all objects?";
+            HeaderText = "Would you like to create a blank difficulty?";
 
             Icon = FontAwesome.Regular.Clone;
 
diff --git a/osu.Game/Screens/Edit/EditorLoader.cs b/osu.Game/Screens/Edit/EditorLoader.cs
index 169b601a94..be3e68c857 100644
--- a/osu.Game/Screens/Edit/EditorLoader.cs
+++ b/osu.Game/Screens/Edit/EditorLoader.cs
@@ -84,7 +84,7 @@ namespace osu.Game.Screens.Edit
             {
                 try
                 {
-                    return beatmapManager.CreateNewBlankDifficulty(creationParameters);
+                    return beatmapManager.CreateNewDifficulty(creationParameters);
                 }
                 catch (Exception ex)
                 {
diff --git a/osu.Game/Screens/Edit/NewDifficultyCreationParameters.cs b/osu.Game/Screens/Edit/NewDifficultyCreationParameters.cs
index aa7dac609b..a6458a9456 100644
--- a/osu.Game/Screens/Edit/NewDifficultyCreationParameters.cs
+++ b/osu.Game/Screens/Edit/NewDifficultyCreationParameters.cs
@@ -32,9 +32,14 @@ namespace osu.Game.Screens.Edit
         public ISkin? ReferenceBeatmapSkin { get; }
 
         /// <summary>
-        /// Whether all objects should be cleared from the new difficulty.
+        /// Whether the new difficulty should be blank.
         /// </summary>
-        public bool ClearAllObjects { get; }
+        /// <remarks>
+        /// A blank difficulty will have no objects, no control points other than timing points taken from <see cref="ReferenceBeatmap"/>
+        /// and will not share <see cref="BeatmapInfo"/> values with <see cref="ReferenceBeatmap"/>,
+        /// but it will share metadata and timing information with <see cref="ReferenceBeatmap"/>.
+        /// </remarks>
+        public bool CreateBlank { get; }
 
         /// <summary>
         /// The saved state of the previous <see cref="Editor"/> which should be restored upon opening the newly-created difficulty.
@@ -46,14 +51,14 @@ namespace osu.Game.Screens.Edit
             RulesetInfo ruleset,
             IBeatmap referenceBeatmap,
             ISkin? referenceBeatmapSkin,
-            bool clearAllObjects,
+            bool createBlank,
             EditorState editorState)
         {
             BeatmapSet = beatmapSet;
             Ruleset = ruleset;
             ReferenceBeatmap = referenceBeatmap;
             ReferenceBeatmapSkin = referenceBeatmapSkin;
-            ClearAllObjects = clearAllObjects;
+            CreateBlank = createBlank;
             EditorState = editorState;
         }
     }
diff --git a/osu.Game/Tests/Visual/EditorTestScene.cs b/osu.Game/Tests/Visual/EditorTestScene.cs
index ff09598eef..8c8a106791 100644
--- a/osu.Game/Tests/Visual/EditorTestScene.cs
+++ b/osu.Game/Tests/Visual/EditorTestScene.cs
@@ -136,7 +136,7 @@ namespace osu.Game.Tests.Visual
                 return new TestWorkingBeatmapCache(this, audioManager, resources, storage, defaultBeatmap, host);
             }
 
-            public override WorkingBeatmap CreateNewBlankDifficulty(NewDifficultyCreationParameters creationParameters)
+            public override WorkingBeatmap CreateNewDifficulty(NewDifficultyCreationParameters creationParameters)
             {
                 // don't actually care about properly creating a difficulty for this context.
                 return TestBeatmap;

From 90c48de9f8d68d2cdafcdde863ea671320449e94 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 6 Feb 2022 20:01:47 +0100
Subject: [PATCH 2871/5547] Add failing test coverage for save of copied
 beatmap keeping old beatmap file

---
 .../Editing/TestSceneEditorBeatmapCreation.cs | 23 +++++++++++++------
 1 file changed, 16 insertions(+), 7 deletions(-)

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneEditorBeatmapCreation.cs b/osu.Game.Tests/Visual/Editing/TestSceneEditorBeatmapCreation.cs
index 90b1d3a6f9..0025e88e62 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneEditorBeatmapCreation.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneEditorBeatmapCreation.cs
@@ -12,6 +12,7 @@ using osu.Framework.Screens;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.ControlPoints;
+using osu.Game.Database;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Catch;
 using osu.Game.Rulesets.Osu;
@@ -236,16 +237,24 @@ namespace osu.Game.Tests.Visual.Editing
 
             AddStep("set unique difficulty name", () => EditorBeatmap.BeatmapInfo.DifficultyName = secondDifficultyName);
             AddStep("save beatmap", () => Editor.Save());
+
+            BeatmapInfo refetchedBeatmap = null;
+            Live<BeatmapSetInfo> refetchedBeatmapSet = null;
+
+            AddStep("refetch from database", () =>
+            {
+                refetchedBeatmap = beatmapManager.QueryBeatmap(b => b.DifficultyName == secondDifficultyName);
+                refetchedBeatmapSet = beatmapManager.QueryBeatmapSet(s => s.ID == EditorBeatmap.BeatmapInfo.BeatmapSet.ID);
+            });
+
             AddAssert("new beatmap persisted", () =>
             {
-                var beatmap = beatmapManager.QueryBeatmap(b => b.DifficultyName == secondDifficultyName);
-                var set = beatmapManager.QueryBeatmapSet(s => s.ID == EditorBeatmap.BeatmapInfo.BeatmapSet.ID);
-
-                return beatmap != null
-                       && beatmap.DifficultyName == secondDifficultyName
-                       && set != null
-                       && set.PerformRead(s => s.Beatmaps.Count == 2 && s.Beatmaps.Any(b => b.DifficultyName == secondDifficultyName));
+                return refetchedBeatmap != null
+                       && refetchedBeatmap.DifficultyName == secondDifficultyName
+                       && refetchedBeatmapSet != null
+                       && refetchedBeatmapSet.PerformRead(s => s.Beatmaps.Count == 2 && s.Beatmaps.Any(b => b.DifficultyName == secondDifficultyName));
             });
+            AddAssert("old beatmap file not deleted", () => refetchedBeatmapSet.AsNonNull().PerformRead(s => s.Files.Count == 2));
         }
 
         [Test]

From ecd6a68c6f0814cbd9a646f4dca4abf758162276 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 6 Feb 2022 20:05:32 +0100
Subject: [PATCH 2872/5547] Clear hash when creating copy of existing
 difficulty

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

diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index 87051ef650..4fa07ff518 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -136,6 +136,8 @@ namespace osu.Game.Beatmaps
                 newBeatmapInfo.ID = Guid.NewGuid();
                 // clear difficulty name to avoid clashes on save.
                 newBeatmapInfo.DifficultyName = string.Empty;
+                // also clear the hash, as that's what is used to match .osu files with their corresponding realm beatmaps.
+                newBeatmapInfo.Hash = string.Empty;
             }
 
             // populate circular beatmap set info <-> beatmap info references manually.

From 13abc392bd139305ac876df335139580ce2f4035 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 13 Feb 2022 18:54:52 +0100
Subject: [PATCH 2873/5547] Add failing test coverage for not copying online
 properties

---
 .../Visual/Editing/TestSceneEditorBeatmapCreation.cs      | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneEditorBeatmapCreation.cs b/osu.Game.Tests/Visual/Editing/TestSceneEditorBeatmapCreation.cs
index 0025e88e62..b4559ac9fa 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneEditorBeatmapCreation.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneEditorBeatmapCreation.cs
@@ -201,6 +201,11 @@ namespace osu.Game.Tests.Visual.Editing
                     new Colour4(0, 0, 255, 255)
                 });
             });
+            AddStep("set status & online ID", () =>
+            {
+                EditorBeatmap.BeatmapInfo.OnlineID = 123456;
+                EditorBeatmap.BeatmapInfo.Status = BeatmapOnlineStatus.WIP;
+            });
 
             AddStep("save beatmap", () => Editor.Save());
             AddAssert("new beatmap persisted", () =>
@@ -235,6 +240,9 @@ namespace osu.Game.Tests.Visual.Editing
             AddAssert("approach rate correctly copied", () => EditorBeatmap.Difficulty.ApproachRate == 4);
             AddAssert("combo colours correctly copied", () => EditorBeatmap.BeatmapSkin.AsNonNull().ComboColours.Count == 2);
 
+            AddAssert("status not copied", () => EditorBeatmap.BeatmapInfo.Status == BeatmapOnlineStatus.None);
+            AddAssert("online ID not copied", () => EditorBeatmap.BeatmapInfo.OnlineID == -1);
+
             AddStep("set unique difficulty name", () => EditorBeatmap.BeatmapInfo.DifficultyName = secondDifficultyName);
             AddStep("save beatmap", () => Editor.Save());
 

From 5dabc9282c0e1e3be5538cd4c7996d67eae6197e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 13 Feb 2022 19:04:11 +0100
Subject: [PATCH 2874/5547] Change `BeatmapInfo` copy logic to be opt-in rather
 than opt-out

---
 osu.Game/Beatmaps/BeatmapManager.cs | 29 ++++++++++++++++++++++-------
 1 file changed, 22 insertions(+), 7 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index 4fa07ff518..4dd0e08dab 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -131,13 +131,28 @@ namespace osu.Game.Beatmaps
             else
             {
                 newBeatmap = referenceBeatmap.Clone();
-                newBeatmap.BeatmapInfo = newBeatmapInfo = referenceBeatmap.BeatmapInfo.Clone();
-                // assign a new ID to the clone.
-                newBeatmapInfo.ID = Guid.NewGuid();
-                // clear difficulty name to avoid clashes on save.
-                newBeatmapInfo.DifficultyName = string.Empty;
-                // also clear the hash, as that's what is used to match .osu files with their corresponding realm beatmaps.
-                newBeatmapInfo.Hash = string.Empty;
+
+                var referenceBeatmapInfo = referenceBeatmap.BeatmapInfo;
+                newBeatmap.BeatmapInfo = newBeatmapInfo = new BeatmapInfo(referenceBeatmapInfo.Ruleset, referenceBeatmapInfo.Difficulty.Clone(), referenceBeatmapInfo.Metadata.DeepClone())
+                {
+                    // Only selected appropriate properties are copied over.
+                    // Things like database ID, online status/ID, MD5 hash, star rating, etc. are omitted
+                    // because they should not be copied over and/or they will be recomputed on save.
+                    AudioLeadIn = referenceBeatmapInfo.AudioLeadIn,
+                    StackLeniency = referenceBeatmapInfo.StackLeniency,
+                    SpecialStyle = referenceBeatmapInfo.SpecialStyle,
+                    LetterboxInBreaks = referenceBeatmapInfo.LetterboxInBreaks,
+                    WidescreenStoryboard = referenceBeatmapInfo.WidescreenStoryboard,
+                    EpilepsyWarning = referenceBeatmapInfo.EpilepsyWarning,
+                    SamplesMatchPlaybackRate = referenceBeatmapInfo.SamplesMatchPlaybackRate,
+                    DistanceSpacing = referenceBeatmapInfo.DistanceSpacing,
+                    BeatDivisor = referenceBeatmapInfo.BeatDivisor,
+                    GridSize = referenceBeatmapInfo.GridSize,
+                    TimelineZoom = referenceBeatmapInfo.TimelineZoom,
+                    Countdown = referenceBeatmapInfo.Countdown,
+                    CountdownOffset = referenceBeatmapInfo.CountdownOffset,
+                    Bookmarks = (int[])referenceBeatmapInfo.Bookmarks.Clone()
+                };
             }
 
             // populate circular beatmap set info <-> beatmap info references manually.

From df9535d195700205380bc624f2a9999cfa9e228c Mon Sep 17 00:00:00 2001
From: Kaleb <sh0ck.04@outlook.com>
Date: Sun, 13 Feb 2022 14:28:40 -0500
Subject: [PATCH 2875/5547] Update RPM calculation for readability

Multiply the 1.01 factor to the resulting RPM, not to the duration.
---
 osu.Game.Rulesets.Osu/Mods/OsuModSpunOut.cs | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModSpunOut.cs b/osu.Game.Rulesets.Osu/Mods/OsuModSpunOut.cs
index 4725a43a77..9be0dc748a 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModSpunOut.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModSpunOut.cs
@@ -45,7 +45,10 @@ namespace osu.Game.Rulesets.Osu.Mods
             // for that reason using ElapsedFrameTime directly leads to fewer SPM with Half Time and more SPM with Double Time.
             // for spinners we want the real (wall clock) elapsed time; to achieve that, unapply the clock rate locally here.
             double rateIndependentElapsedTime = spinner.Clock.ElapsedFrameTime / spinner.Clock.Rate;
-            float rotationSpeed = (float)(spinner.HitObject.SpinsRequired / (spinner.HitObject.Duration / 1.01));
+
+            // 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));
         }
     }

From c1777f20e114da75a51c6e3fc38ad5f637b4900d Mon Sep 17 00:00:00 2001
From: Kaleb <sh0ck.04@outlook.com>
Date: Mon, 14 Feb 2022 03:11:44 -0500
Subject: [PATCH 2876/5547] Fix Spun Out tests

Change 'unaffected by mods' test to use dynamic RPM value instead of a fixed value
---
 .../Mods/TestSceneOsuModSpunOut.cs                 | 14 +++++++++++++-
 1 file changed, 13 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModSpunOut.cs b/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModSpunOut.cs
index 24e69703a6..29d7e7b4d6 100644
--- a/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModSpunOut.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModSpunOut.cs
@@ -48,7 +48,19 @@ namespace osu.Game.Rulesets.Osu.Tests.Mods
                 PassCondition = () =>
                 {
                     var counter = Player.ChildrenOfType<SpinnerSpmCalculator>().SingleOrDefault();
-                    return counter != null && Precision.AlmostEquals(counter.Result.Value, 286, 1);
+                    var spinner = Player.ChildrenOfType<DrawableSpinner>().FirstOrDefault();
+
+                    if (counter == null || spinner == null)
+                        return false;
+
+                    // ignore cases where the spinner hasn't started as these lead to false-positives
+                    if (Precision.AlmostEquals(counter.Result.Value, 0, 1))
+                        return false;
+
+                    double rateIndependentElapsedTime = spinner.Clock.ElapsedFrameTime / spinner.Clock.Rate;
+                    float rotationSpeed = (float)(1.01 * spinner.HitObject.SpinsRequired / spinner.HitObject.Duration);
+
+                    return Precision.AlmostEquals(counter.Result.Value, rotationSpeed * 1000 * 60, 1);
                 }
             });
         }

From 95b1bffffeceff678762ccb32e329a0b9277af6a Mon Sep 17 00:00:00 2001
From: Kaleb <sh0ck.04@outlook.com>
Date: Mon, 14 Feb 2022 03:45:02 -0500
Subject: [PATCH 2877/5547] Add test to ensure spinners only complete

No bonus or a non-300 judgement
---
 .../Mods/TestSceneOsuModSpunOut.cs            | 23 ++++++++++++++++++-
 1 file changed, 22 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModSpunOut.cs b/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModSpunOut.cs
index 29d7e7b4d6..e71377a505 100644
--- a/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModSpunOut.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModSpunOut.cs
@@ -14,6 +14,7 @@ using osu.Game.Rulesets.Osu.Mods;
 using osu.Game.Rulesets.Osu.Objects;
 using osu.Game.Rulesets.Osu.Objects.Drawables;
 using osu.Game.Rulesets.Osu.Skinning.Default;
+using osu.Game.Screens.Play;
 using osuTK;
 
 namespace osu.Game.Rulesets.Osu.Tests.Mods
@@ -57,7 +58,6 @@ namespace osu.Game.Rulesets.Osu.Tests.Mods
                     if (Precision.AlmostEquals(counter.Result.Value, 0, 1))
                         return false;
 
-                    double rateIndependentElapsedTime = spinner.Clock.ElapsedFrameTime / spinner.Clock.Rate;
                     float rotationSpeed = (float)(1.01 * spinner.HitObject.SpinsRequired / spinner.HitObject.Duration);
 
                     return Precision.AlmostEquals(counter.Result.Value, rotationSpeed * 1000 * 60, 1);
@@ -65,6 +65,27 @@ namespace osu.Game.Rulesets.Osu.Tests.Mods
             });
         }
 
+        [Test]
+        public void TestSpinnerOnlyComplete() => CreateModTest(new ModTestData
+        {
+            Mod = new OsuModSpunOut(),
+            Autoplay = false,
+            Beatmap = singleSpinnerBeatmap,
+            PassCondition = () =>
+            {
+                var spinner = Player.ChildrenOfType<DrawableSpinner>().SingleOrDefault();
+                var gameplayClockContainer = Player.ChildrenOfType<GameplayClockContainer>().SingleOrDefault();
+
+                if (spinner == null || gameplayClockContainer == null)
+                    return false;
+
+                if (!Precision.AlmostEquals(gameplayClockContainer.CurrentTime, spinner.HitObject.StartTime + spinner.HitObject.Duration, 200.0f))
+                    return false;
+
+                return Precision.AlmostEquals(spinner.Progress, 1.0f, 0.05f) && Precision.AlmostEquals(spinner.GainedBonus.Value, 0, 1);
+            }
+        });
+
         private Beatmap singleSpinnerBeatmap => new Beatmap
         {
             HitObjects = new List<HitObject>

From b9d9fc56afa5f579389201f8d06bfa41b3c3980b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 14 Feb 2022 17:51:39 +0900
Subject: [PATCH 2878/5547] Move files to UI namespace

---
 .../Visual/UserInterface/TestSceneExpandingContainer.cs       | 2 ++
 .../Containers}/ExpandingButtonContainer.cs                   | 2 +-
 .../{Overlays => Graphics/Containers}/ExpandingContainer.cs   | 3 +--
 osu.Game/{Overlays => Graphics/Containers}/IExpandable.cs     | 2 +-
 .../{Overlays => Graphics/Containers}/IExpandingContainer.cs  | 3 ++-
 .../{Overlays => Graphics/UserInterface}/ExpandableSlider.cs  | 4 ++--
 osu.Game/Overlays/Settings/SettingsSidebar.cs                 | 1 +
 osu.Game/Overlays/SettingsToolboxGroup.cs                     | 1 +
 osu.Game/Rulesets/Edit/HitObjectComposer.cs                   | 2 +-
 9 files changed, 12 insertions(+), 8 deletions(-)
 rename osu.Game/{Overlays => Graphics/Containers}/ExpandingButtonContainer.cs (94%)
 rename osu.Game/{Overlays => Graphics/Containers}/ExpandingContainer.cs (97%)
 rename osu.Game/{Overlays => Graphics/Containers}/IExpandable.cs (93%)
 rename osu.Game/{Overlays => Graphics/Containers}/IExpandingContainer.cs (88%)
 rename osu.Game/{Overlays => Graphics/UserInterface}/ExpandableSlider.cs (97%)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneExpandingContainer.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneExpandingContainer.cs
index f63591311f..f4920b4412 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneExpandingContainer.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneExpandingContainer.cs
@@ -4,6 +4,8 @@
 using NUnit.Framework;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
+using osu.Game.Graphics.Containers;
+using osu.Game.Graphics.UserInterface;
 using osu.Game.Overlays;
 using osu.Game.Overlays.Settings.Sections;
 using osuTK;
diff --git a/osu.Game/Overlays/ExpandingButtonContainer.cs b/osu.Game/Graphics/Containers/ExpandingButtonContainer.cs
similarity index 94%
rename from osu.Game/Overlays/ExpandingButtonContainer.cs
rename to osu.Game/Graphics/Containers/ExpandingButtonContainer.cs
index 8fb3e1b550..b79af22bd2 100644
--- a/osu.Game/Overlays/ExpandingButtonContainer.cs
+++ b/osu.Game/Graphics/Containers/ExpandingButtonContainer.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.
 
-namespace osu.Game.Overlays
+namespace osu.Game.Graphics.Containers
 {
     /// <summary>
     /// An <see cref="ExpandingContainer"/> with a long hover expansion delay.
diff --git a/osu.Game/Overlays/ExpandingContainer.cs b/osu.Game/Graphics/Containers/ExpandingContainer.cs
similarity index 97%
rename from osu.Game/Overlays/ExpandingContainer.cs
rename to osu.Game/Graphics/Containers/ExpandingContainer.cs
index ea3fffcb78..b50e008362 100644
--- a/osu.Game/Overlays/ExpandingContainer.cs
+++ b/osu.Game/Graphics/Containers/ExpandingContainer.cs
@@ -6,9 +6,8 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Input.Events;
 using osu.Framework.Threading;
-using osu.Game.Graphics.Containers;
 
-namespace osu.Game.Overlays
+namespace osu.Game.Graphics.Containers
 {
     /// <summary>
     /// Represents a <see cref="Container"/> with the ability to expand/contract on hover.
diff --git a/osu.Game/Overlays/IExpandable.cs b/osu.Game/Graphics/Containers/IExpandable.cs
similarity index 93%
rename from osu.Game/Overlays/IExpandable.cs
rename to osu.Game/Graphics/Containers/IExpandable.cs
index 770ac97847..593564a2f9 100644
--- a/osu.Game/Overlays/IExpandable.cs
+++ b/osu.Game/Graphics/Containers/IExpandable.cs
@@ -4,7 +4,7 @@
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 
-namespace osu.Game.Overlays
+namespace osu.Game.Graphics.Containers
 {
     /// <summary>
     /// An interface for drawables with ability to expand/contract.
diff --git a/osu.Game/Overlays/IExpandingContainer.cs b/osu.Game/Graphics/Containers/IExpandingContainer.cs
similarity index 88%
rename from osu.Game/Overlays/IExpandingContainer.cs
rename to osu.Game/Graphics/Containers/IExpandingContainer.cs
index ec5f0c90f4..a82faa3cd1 100644
--- a/osu.Game/Overlays/IExpandingContainer.cs
+++ b/osu.Game/Graphics/Containers/IExpandingContainer.cs
@@ -3,8 +3,9 @@
 
 using osu.Framework.Allocation;
 using osu.Framework.Graphics.Containers;
+using osu.Game.Overlays;
 
-namespace osu.Game.Overlays
+namespace osu.Game.Graphics.Containers
 {
     /// <summary>
     /// A target expanding container that should be resolved by children <see cref="IExpandable"/>s to propagate state changes.
diff --git a/osu.Game/Overlays/ExpandableSlider.cs b/osu.Game/Graphics/UserInterface/ExpandableSlider.cs
similarity index 97%
rename from osu.Game/Overlays/ExpandableSlider.cs
rename to osu.Game/Graphics/UserInterface/ExpandableSlider.cs
index 062de98659..60e83f9c81 100644
--- a/osu.Game/Overlays/ExpandableSlider.cs
+++ b/osu.Game/Graphics/UserInterface/ExpandableSlider.cs
@@ -8,11 +8,11 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.UserInterface;
 using osu.Framework.Localisation;
+using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
-using osu.Game.Graphics.UserInterface;
 using osuTK;
 
-namespace osu.Game.Overlays
+namespace osu.Game.Graphics.UserInterface
 {
     /// <summary>
     /// An <see cref="IExpandable"/> implementation for the UI slider bar control.
diff --git a/osu.Game/Overlays/Settings/SettingsSidebar.cs b/osu.Game/Overlays/Settings/SettingsSidebar.cs
index e6ce90c33e..4e6a1eb914 100644
--- a/osu.Game/Overlays/Settings/SettingsSidebar.cs
+++ b/osu.Game/Overlays/Settings/SettingsSidebar.cs
@@ -4,6 +4,7 @@
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Shapes;
+using osu.Game.Graphics.Containers;
 
 namespace osu.Game.Overlays.Settings
 {
diff --git a/osu.Game/Overlays/SettingsToolboxGroup.cs b/osu.Game/Overlays/SettingsToolboxGroup.cs
index 9e7223df9d..08321f68fe 100644
--- a/osu.Game/Overlays/SettingsToolboxGroup.cs
+++ b/osu.Game/Overlays/SettingsToolboxGroup.cs
@@ -12,6 +12,7 @@ using osu.Framework.Graphics.Sprites;
 using osu.Framework.Input.Events;
 using osu.Framework.Layout;
 using osu.Game.Graphics;
+using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.UserInterface;
 using osuTK;
diff --git a/osu.Game/Rulesets/Edit/HitObjectComposer.cs b/osu.Game/Rulesets/Edit/HitObjectComposer.cs
index 92ea2db338..39783cc8bb 100644
--- a/osu.Game/Rulesets/Edit/HitObjectComposer.cs
+++ b/osu.Game/Rulesets/Edit/HitObjectComposer.cs
@@ -13,7 +13,7 @@ using osu.Framework.Input;
 using osu.Framework.Input.Events;
 using osu.Framework.Logging;
 using osu.Game.Beatmaps;
-using osu.Game.Overlays;
+using osu.Game.Graphics.Containers;
 using osu.Game.Rulesets.Configuration;
 using osu.Game.Rulesets.Edit.Tools;
 using osu.Game.Rulesets.Mods;

From 3aa5908de8d0bd691c5a5839130e3ce66fabe107 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 14 Feb 2022 18:01:56 +0900
Subject: [PATCH 2879/5547] Remove unused using statement

---
 osu.Game/Graphics/Containers/IExpandingContainer.cs | 1 -
 1 file changed, 1 deletion(-)

diff --git a/osu.Game/Graphics/Containers/IExpandingContainer.cs b/osu.Game/Graphics/Containers/IExpandingContainer.cs
index a82faa3cd1..eb186c96a8 100644
--- a/osu.Game/Graphics/Containers/IExpandingContainer.cs
+++ b/osu.Game/Graphics/Containers/IExpandingContainer.cs
@@ -3,7 +3,6 @@
 
 using osu.Framework.Allocation;
 using osu.Framework.Graphics.Containers;
-using osu.Game.Overlays;
 
 namespace osu.Game.Graphics.Containers
 {

From e324287f796128a722a4d94435b02b90f356076e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 14 Feb 2022 18:08:16 +0900
Subject: [PATCH 2880/5547] Reduce expansion delay on
 `ExpandingButtonContainer`

Felt too long.
---
 osu.Game/Graphics/Containers/ExpandingButtonContainer.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Graphics/Containers/ExpandingButtonContainer.cs b/osu.Game/Graphics/Containers/ExpandingButtonContainer.cs
index b79af22bd2..859850e771 100644
--- a/osu.Game/Graphics/Containers/ExpandingButtonContainer.cs
+++ b/osu.Game/Graphics/Containers/ExpandingButtonContainer.cs
@@ -16,6 +16,6 @@ namespace osu.Game.Graphics.Containers
         {
         }
 
-        protected override double HoverExpansionDelay => 750;
+        protected override double HoverExpansionDelay => 400;
     }
 }

From e304c031dcdffdcbd66f0f896ee160f79ee7a86d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 14 Feb 2022 21:53:56 +0900
Subject: [PATCH 2881/5547] Update framework

---
 osu.Android.props        | 2 +-
 osu.Game/osu.Game.csproj | 2 +-
 osu.iOS.props            | 4 ++--
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Android.props b/osu.Android.props
index 1a2859c851..6b3142fbdc 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -52,7 +52,7 @@
   </ItemGroup>
   <ItemGroup>
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.211.0" />
-    <PackageReference Include="ppy.osu.Framework.Android" Version="2022.204.0" />
+    <PackageReference Include="ppy.osu.Framework.Android" Version="2022.214.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
     <!-- Realm needs to be directly referenced in all Xamarin projects, as it will not pull in its transitive dependencies otherwise. -->
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index a9c0226951..847832f8ac 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="10.8.0" />
-    <PackageReference Include="ppy.osu.Framework" Version="2022.204.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2022.214.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.211.0" />
     <PackageReference Include="Sentry" Version="3.13.0" />
     <PackageReference Include="SharpCompress" Version="0.30.1" />
diff --git a/osu.iOS.props b/osu.iOS.props
index 4a1dc53281..00c9653146 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -60,7 +60,7 @@
     <Reference Include="System.Net.Http" />
   </ItemGroup>
   <ItemGroup Label="Package References">
-    <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.204.0" />
+    <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.214.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.211.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net6.0) -->
@@ -83,7 +83,7 @@
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="2.2.6" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.Core" Version="2.2.6" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
-    <PackageReference Include="ppy.osu.Framework" Version="2022.204.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2022.214.0" />
     <PackageReference Include="SharpCompress" Version="0.30.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
     <PackageReference Include="System.ComponentModel.Annotations" Version="5.0.0" />

From c5019fefb0c9ed0a212167851acc082fe5f4e618 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 14 Feb 2022 22:35:08 +0900
Subject: [PATCH 2882/5547] Update CI runs to target net6.0

---
 .github/workflows/ci.yml | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 3c52802cf6..ec3816d541 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -20,10 +20,10 @@ jobs:
       - name: Checkout
         uses: actions/checkout@v2
 
-      - name: Install .NET 5.0.x
+      - name: Install .NET 6.0.x
         uses: actions/setup-dotnet@v1
         with:
-          dotnet-version: "5.0.x"
+          dotnet-version: "6.0.x"
 
       # FIXME: libavformat is not included in Ubuntu. Let's fix that.
       # https://github.com/ppy/osu-framework/issues/4349
@@ -65,10 +65,10 @@ jobs:
         run: |
             $VM_ASSETS/select-xamarin-sdk-v2.sh --mono=6.12 --android=11.2
 
-      - name: Install .NET 5.0.x
+      - name: Install .NET 6.0.x
         uses: actions/setup-dotnet@v1
         with:
-          dotnet-version: "5.0.x"
+          dotnet-version: "6.0.x"
 
       # Contrary to seemingly any other msbuild, msbuild running on macOS/Mono
       # cannot accept .sln(f) files as arguments.
@@ -84,10 +84,10 @@ jobs:
       - name: Checkout
         uses: actions/checkout@v2
 
-      - name: Install .NET 5.0.x
+      - name: Install .NET 6.0.x
         uses: actions/setup-dotnet@v1
         with:
-          dotnet-version: "5.0.x"
+          dotnet-version: "6.0.x"
 
       # Contrary to seemingly any other msbuild, msbuild running on macOS/Mono
       # cannot accept .sln(f) files as arguments.
@@ -102,17 +102,17 @@ jobs:
       - name: Checkout
         uses: actions/checkout@v2
 
-      # FIXME: Tools won't run in .NET 5.0 unless you install 3.1.x LTS side by side.
+      # FIXME: Tools won't run in .NET 6.0 unless you install 3.1.x LTS side by side.
       # https://itnext.io/how-to-support-multiple-net-sdks-in-github-actions-workflows-b988daa884e
       - name: Install .NET 3.1.x LTS
         uses: actions/setup-dotnet@v1
         with:
           dotnet-version: "3.1.x"
 
-      - name: Install .NET 5.0.x
+      - name: Install .NET 6.0.x
         uses: actions/setup-dotnet@v1
         with:
-          dotnet-version: "5.0.x"
+          dotnet-version: "6.0.x"
 
       - name: Restore Tools
         run: dotnet tool restore

From 70ba6fb7dc2e48712886a6ae3ad4eb22079e4136 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 14 Feb 2022 22:35:30 +0900
Subject: [PATCH 2883/5547] Update .NET version in README

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index b1dfcab416..7ace47a74f 100644
--- a/README.md
+++ b/README.md
@@ -48,7 +48,7 @@ You can see some examples of custom rulesets by visiting the [custom ruleset dir
 
 Please make sure you have the following prerequisites:
 
-- A desktop platform with the [.NET 5.0 SDK](https://dotnet.microsoft.com/download) installed.
+- A desktop platform with the [.NET 6.0 SDK](https://dotnet.microsoft.com/download) installed.
 - When developing with mobile, [Xamarin](https://docs.microsoft.com/en-us/xamarin/) is required, which is shipped together with Visual Studio or [Visual Studio for Mac](https://visualstudio.microsoft.com/vs/mac/).
 - When working with the codebase, we recommend using an IDE with intelligent code completion and syntax highlighting, such as [Visual Studio 2019+](https://visualstudio.microsoft.com/vs/), [JetBrains Rider](https://www.jetbrains.com/rider/) or [Visual Studio Code](https://code.visualstudio.com/).
 - When running on Linux, please have a system-wide FFmpeg installation available to support video decoding.

From 9b7d9d42bcd01f84375cc38d5f6bf4ab74f996a3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 14 Feb 2022 22:48:04 +0900
Subject: [PATCH 2884/5547] Update reference to `NetAnalyzers`

---
 Directory.Build.props | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Directory.Build.props b/Directory.Build.props
index 894ea25c8b..6e7015fa26 100644
--- a/Directory.Build.props
+++ b/Directory.Build.props
@@ -18,7 +18,7 @@
   <ItemGroup Label="Code Analysis">
     <PackageReference Include="Microsoft.CodeAnalysis.BannedApiAnalyzers" Version="3.3.3" PrivateAssets="All" />
     <AdditionalFiles Include="$(MSBuildThisFileDirectory)CodeAnalysis\BannedSymbols.txt" />
-    <PackageReference Include="Microsoft.CodeAnalysis.NetAnalyzers" Version="5.0.3" PrivateAssets="All" />
+    <PackageReference Include="Microsoft.CodeAnalysis.NetAnalyzers" Version="6.0.0" PrivateAssets="All" />
   </ItemGroup>
   <PropertyGroup Label="Code Analysis">
     <CodeAnalysisRuleSet>$(MSBuildThisFileDirectory)CodeAnalysis\osu.ruleset</CodeAnalysisRuleSet>

From 9ad7b5d51caab9433c2eaaecbce6a1e4dc687516 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 14 Feb 2022 22:52:30 +0900
Subject: [PATCH 2885/5547] Remove no longer required `NoWarn` spec

---
 Directory.Build.props | 7 +------
 1 file changed, 1 insertion(+), 6 deletions(-)

diff --git a/Directory.Build.props b/Directory.Build.props
index 6e7015fa26..c1682638c2 100644
--- a/Directory.Build.props
+++ b/Directory.Build.props
@@ -32,13 +32,8 @@
     NU1701:
       DeepEqual is not netstandard-compatible. This is fine since we run tests with .NET Framework anyway.
       This is required due to https://github.com/NuGet/Home/issues/5740
-
-    CA9998:
-      Microsoft.CodeAnalysis.FxCopAnalyzers has been deprecated.
-      The entire package will be able to be removed after migrating to .NET 5,
-      as analysers are shipped as part of the .NET 5 SDK anyway.
     -->
-    <NoWarn>$(NoWarn);NU1701;CA9998</NoWarn>
+    <NoWarn>$(NoWarn);NU1701</NoWarn>
   </PropertyGroup>
   <PropertyGroup Label="Nuget">
     <IsPackable>false</IsPackable>

From b581ca14cca29e7c8fb28bcfbb55e0aec0ae7389 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 15 Feb 2022 02:32:38 +0900
Subject: [PATCH 2886/5547] Update usages in line with `BorderColour` type
 change

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

diff --git a/osu.Game/Graphics/UserInterfaceV2/SwitchButton.cs b/osu.Game/Graphics/UserInterfaceV2/SwitchButton.cs
index deb2e6baf6..c6477d1781 100644
--- a/osu.Game/Graphics/UserInterfaceV2/SwitchButton.cs
+++ b/osu.Game/Graphics/UserInterfaceV2/SwitchButton.cs
@@ -114,7 +114,7 @@ namespace osu.Game.Graphics.UserInterfaceV2
 
         private class CircularBorderContainer : CircularContainer
         {
-            public void TransformBorderTo(SRGBColour colour)
+            public void TransformBorderTo(ColourInfo colour)
                 => this.TransformTo(nameof(BorderColour), colour, 250, Easing.OutQuint);
         }
     }

From 02f58a82fc4682df861a6069a12316d3bf474084 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 15 Feb 2022 02:35:08 +0900
Subject: [PATCH 2887/5547] Use `WaitSafely()` in tests where it was not
 already being used

---
 .../Visual/Multiplayer/TestSceneHostOnlyQueueMode.cs |  3 ++-
 .../Multiplayer/TestSceneMultiplayerPlaylist.cs      | 10 +++++-----
 .../Multiplayer/TestSceneMultiplayerQueueList.cs     | 12 ++++++------
 .../Visual/Multiplayer/TestSceneTeamVersus.cs        |  2 +-
 4 files changed, 14 insertions(+), 13 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneHostOnlyQueueMode.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneHostOnlyQueueMode.cs
index c7eeff81fe..cd14a98751 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneHostOnlyQueueMode.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneHostOnlyQueueMode.cs
@@ -4,6 +4,7 @@
 using System;
 using System.Linq;
 using NUnit.Framework;
+using osu.Framework.Extensions;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
 using osu.Game.Online.Multiplayer;
@@ -71,7 +72,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddStep("change queue mode", () => Client.ChangeSettings(new MultiplayerRoomSettings
             {
                 QueueMode = QueueMode.AllPlayers
-            }));
+            }).WaitSafely());
 
             AddUntilStep("api room updated", () => Client.APIRoom?.QueueMode.Value == QueueMode.AllPlayers);
         }
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs
index 936798e6b4..5dd9fb9fe2 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs
@@ -60,7 +60,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 importedBeatmap = importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0);
             });
 
-            AddStep("change to all players mode", () => Client.ChangeSettings(new MultiplayerRoomSettings { QueueMode = QueueMode.AllPlayers }));
+            AddStep("change to all players mode", () => Client.ChangeSettings(new MultiplayerRoomSettings { QueueMode = QueueMode.AllPlayers }).WaitSafely());
         }
 
         [Test]
@@ -97,19 +97,19 @@ namespace osu.Game.Tests.Visual.Multiplayer
             addItemStep();
             addItemStep();
 
-            AddStep("finish current item", () => Client.FinishCurrentItem());
+            AddStep("finish current item", () => Client.FinishCurrentItem().WaitSafely());
 
             assertItemInHistoryListStep(1, 0);
             assertItemInQueueListStep(2, 0);
             assertItemInQueueListStep(3, 1);
 
-            AddStep("finish current item", () => Client.FinishCurrentItem());
+            AddStep("finish current item", () => Client.FinishCurrentItem().WaitSafely());
 
             assertItemInHistoryListStep(2, 0);
             assertItemInHistoryListStep(1, 1);
             assertItemInQueueListStep(3, 0);
 
-            AddStep("finish current item", () => Client.FinishCurrentItem());
+            AddStep("finish current item", () => Client.FinishCurrentItem().WaitSafely());
 
             assertItemInHistoryListStep(3, 0);
             assertItemInHistoryListStep(2, 1);
@@ -120,7 +120,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         public void TestListsClearedWhenRoomLeft()
         {
             addItemStep();
-            AddStep("finish current item", () => Client.FinishCurrentItem());
+            AddStep("finish current item", () => Client.FinishCurrentItem().WaitSafely());
 
             AddStep("leave room", () => RoomManager.PartRoom());
             AddUntilStep("wait for room part", () => !RoomJoined);
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs
index ddf794b437..80b20ed59f 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs
@@ -65,13 +65,13 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 importedBeatmap = importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0);
             });
 
-            AddStep("change to all players mode", () => Client.ChangeSettings(new MultiplayerRoomSettings { QueueMode = QueueMode.AllPlayers }));
+            AddStep("change to all players mode", () => Client.ChangeSettings(new MultiplayerRoomSettings { QueueMode = QueueMode.AllPlayers }).WaitSafely());
         }
 
         [Test]
         public void TestDeleteButtonAlwaysVisibleForHost()
         {
-            AddStep("set all players queue mode", () => Client.ChangeSettings(new MultiplayerRoomSettings { QueueMode = QueueMode.AllPlayers }));
+            AddStep("set all players queue mode", () => Client.ChangeSettings(new MultiplayerRoomSettings { QueueMode = QueueMode.AllPlayers }).WaitSafely());
             AddUntilStep("wait for queue mode change", () => Client.APIRoom?.QueueMode.Value == QueueMode.AllPlayers);
 
             addPlaylistItem(() => API.LocalUser.Value.OnlineID);
@@ -83,7 +83,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [Test]
         public void TestDeleteButtonOnlyVisibleForItemOwnerIfNotHost()
         {
-            AddStep("set all players queue mode", () => Client.ChangeSettings(new MultiplayerRoomSettings { QueueMode = QueueMode.AllPlayers }));
+            AddStep("set all players queue mode", () => Client.ChangeSettings(new MultiplayerRoomSettings { QueueMode = QueueMode.AllPlayers }).WaitSafely());
             AddUntilStep("wait for queue mode change", () => Client.APIRoom?.QueueMode.Value == QueueMode.AllPlayers);
 
             AddStep("join other user", () => Client.AddUser(new APIUser { Id = 1234 }));
@@ -102,7 +102,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [Test]
         public void TestCurrentItemDoesNotHaveDeleteButton()
         {
-            AddStep("set all players queue mode", () => Client.ChangeSettings(new MultiplayerRoomSettings { QueueMode = QueueMode.AllPlayers }));
+            AddStep("set all players queue mode", () => Client.ChangeSettings(new MultiplayerRoomSettings { QueueMode = QueueMode.AllPlayers }).WaitSafely());
             AddUntilStep("wait for queue mode change", () => Client.APIRoom?.QueueMode.Value == QueueMode.AllPlayers);
 
             addPlaylistItem(() => API.LocalUser.Value.OnlineID);
@@ -110,7 +110,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             assertDeleteButtonVisibility(0, false);
             assertDeleteButtonVisibility(1, true);
 
-            AddStep("finish current item", () => Client.FinishCurrentItem());
+            AddStep("finish current item", () => Client.FinishCurrentItem().WaitSafely());
             AddUntilStep("wait for next item to be selected", () => Client.Room?.Settings.PlaylistItemId == 2);
             AddUntilStep("wait for two items in playlist", () => playlist.ChildrenOfType<DrawableRoomPlaylistItem>().Count() == 2);
 
@@ -130,7 +130,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     BeatmapID = importedBeatmap.OnlineID,
                 });
 
-                Client.AddUserPlaylistItem(userId(), item);
+                Client.AddUserPlaylistItem(userId(), item).WaitSafely();
 
                 itemId = item.ID;
             });
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs
index 781f0a1824..2837d75553 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs
@@ -143,7 +143,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddStep("change match type", () => client.ChangeSettings(new MultiplayerRoomSettings
             {
                 MatchType = MatchType.TeamVersus
-            }));
+            }).WaitSafely());
 
             AddUntilStep("api room updated to team versus", () => client.APIRoom?.Type.Value == MatchType.TeamVersus);
         }

From 8da0800d7fc70d213ab5401e97d537f308d75cf5 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 15 Feb 2022 02:47:35 +0900
Subject: [PATCH 2888/5547] Update `ChangeFocus` usage in line with framework
 changes

---
 osu.Game/Screens/OnlinePlay/Lounge/DrawableLoungeRoom.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Screens/OnlinePlay/Lounge/DrawableLoungeRoom.cs b/osu.Game/Screens/OnlinePlay/Lounge/DrawableLoungeRoom.cs
index 3fd56ece58..27743e709f 100644
--- a/osu.Game/Screens/OnlinePlay/Lounge/DrawableLoungeRoom.cs
+++ b/osu.Game/Screens/OnlinePlay/Lounge/DrawableLoungeRoom.cs
@@ -246,7 +246,7 @@ namespace osu.Game.Screens.OnlinePlay.Lounge
             {
                 base.LoadComplete();
 
-                Schedule(() => GetContainingInputManager().ChangeFocus(passwordTextBox));
+                ScheduleAfterChildren(() => GetContainingInputManager().ChangeFocus(passwordTextBox));
                 passwordTextBox.OnCommit += (_, __) => performJoin();
             }
 

From 4bd58cfde160398726aaffb80e93d630a34029f2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 14 Feb 2022 18:52:19 +0100
Subject: [PATCH 2889/5547] Update one more custom transform with
 `BorderColour` type change

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

diff --git a/osu.Game/Overlays/Volume/MuteButton.cs b/osu.Game/Overlays/Volume/MuteButton.cs
index bcc9394aba..e9d3b31207 100644
--- a/osu.Game/Overlays/Volume/MuteButton.cs
+++ b/osu.Game/Overlays/Volume/MuteButton.cs
@@ -79,13 +79,13 @@ namespace osu.Game.Overlays.Volume
 
         protected override bool OnHover(HoverEvent e)
         {
-            Content.TransformTo<Container<Drawable>, SRGBColour>("BorderColour", hoveredColour, 500, Easing.OutQuint);
+            Content.TransformTo<Container<Drawable>, ColourInfo>("BorderColour", hoveredColour, 500, Easing.OutQuint);
             return false;
         }
 
         protected override void OnHoverLost(HoverLostEvent e)
         {
-            Content.TransformTo<Container<Drawable>, SRGBColour>("BorderColour", unhoveredColour, 500, Easing.OutQuint);
+            Content.TransformTo<Container<Drawable>, ColourInfo>("BorderColour", unhoveredColour, 500, Easing.OutQuint);
         }
     }
 }

From db74a226c0b3e5d59493075b124b4dc1e8fdb0a3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 15 Feb 2022 02:54:45 +0900
Subject: [PATCH 2890/5547] Fix test regression due to mouse overlapping
 settings overlay

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

diff --git a/osu.Game.Tests/Visual/Menus/TestSceneSideOverlays.cs b/osu.Game.Tests/Visual/Menus/TestSceneSideOverlays.cs
index e34ec6c46a..bbab6380ba 100644
--- a/osu.Game.Tests/Visual/Menus/TestSceneSideOverlays.cs
+++ b/osu.Game.Tests/Visual/Menus/TestSceneSideOverlays.cs
@@ -19,6 +19,10 @@ namespace osu.Game.Tests.Visual.Menus
             base.SetUpSteps();
 
             AddAssert("no screen offset applied", () => Game.ScreenOffsetContainer.X == 0f);
+
+            // avoids mouse interacting with settings overlay.
+            AddStep("move mouse to centre", () => InputManager.MoveMouseTo(Game.ScreenSpaceDrawQuad.Centre));
+
             AddUntilStep("wait for overlays", () => Game.Settings.IsLoaded && Game.Notifications.IsLoaded);
         }
 

From 7e75fa7117ebabf0e5cb1c8ad1b5e5d79349047a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 14 Feb 2022 19:52:08 +0100
Subject: [PATCH 2891/5547] Revert "Change `BeatmapInfo` copy logic to be
 opt-in rather than opt-out"

This reverts commit 5dabc9282c0e1e3be5538cd4c7996d67eae6197e.
---
 osu.Game/Beatmaps/BeatmapManager.cs | 29 +++++++----------------------
 1 file changed, 7 insertions(+), 22 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index 4dd0e08dab..4fa07ff518 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -131,28 +131,13 @@ namespace osu.Game.Beatmaps
             else
             {
                 newBeatmap = referenceBeatmap.Clone();
-
-                var referenceBeatmapInfo = referenceBeatmap.BeatmapInfo;
-                newBeatmap.BeatmapInfo = newBeatmapInfo = new BeatmapInfo(referenceBeatmapInfo.Ruleset, referenceBeatmapInfo.Difficulty.Clone(), referenceBeatmapInfo.Metadata.DeepClone())
-                {
-                    // Only selected appropriate properties are copied over.
-                    // Things like database ID, online status/ID, MD5 hash, star rating, etc. are omitted
-                    // because they should not be copied over and/or they will be recomputed on save.
-                    AudioLeadIn = referenceBeatmapInfo.AudioLeadIn,
-                    StackLeniency = referenceBeatmapInfo.StackLeniency,
-                    SpecialStyle = referenceBeatmapInfo.SpecialStyle,
-                    LetterboxInBreaks = referenceBeatmapInfo.LetterboxInBreaks,
-                    WidescreenStoryboard = referenceBeatmapInfo.WidescreenStoryboard,
-                    EpilepsyWarning = referenceBeatmapInfo.EpilepsyWarning,
-                    SamplesMatchPlaybackRate = referenceBeatmapInfo.SamplesMatchPlaybackRate,
-                    DistanceSpacing = referenceBeatmapInfo.DistanceSpacing,
-                    BeatDivisor = referenceBeatmapInfo.BeatDivisor,
-                    GridSize = referenceBeatmapInfo.GridSize,
-                    TimelineZoom = referenceBeatmapInfo.TimelineZoom,
-                    Countdown = referenceBeatmapInfo.Countdown,
-                    CountdownOffset = referenceBeatmapInfo.CountdownOffset,
-                    Bookmarks = (int[])referenceBeatmapInfo.Bookmarks.Clone()
-                };
+                newBeatmap.BeatmapInfo = newBeatmapInfo = referenceBeatmap.BeatmapInfo.Clone();
+                // assign a new ID to the clone.
+                newBeatmapInfo.ID = Guid.NewGuid();
+                // clear difficulty name to avoid clashes on save.
+                newBeatmapInfo.DifficultyName = string.Empty;
+                // also clear the hash, as that's what is used to match .osu files with their corresponding realm beatmaps.
+                newBeatmapInfo.Hash = string.Empty;
             }
 
             // populate circular beatmap set info <-> beatmap info references manually.

From 40cfee34211387866835612abf142b893b5498c0 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 14 Feb 2022 19:54:40 +0100
Subject: [PATCH 2892/5547] Explicitly reset online ID and beatmap status on
 copy

---
 osu.Game/Beatmaps/BeatmapManager.cs | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index 4fa07ff518..884209ee56 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -136,8 +136,11 @@ namespace osu.Game.Beatmaps
                 newBeatmapInfo.ID = Guid.NewGuid();
                 // clear difficulty name to avoid clashes on save.
                 newBeatmapInfo.DifficultyName = string.Empty;
-                // also clear the hash, as that's what is used to match .osu files with their corresponding realm beatmaps.
+                // clear the hash, as that's what is used to match .osu files with their corresponding realm beatmaps.
                 newBeatmapInfo.Hash = string.Empty;
+                // clear online properties.
+                newBeatmapInfo.OnlineID = -1;
+                newBeatmapInfo.Status = BeatmapOnlineStatus.None;
             }
 
             // populate circular beatmap set info <-> beatmap info references manually.

From 1685e214d36463e225971c6ffef3fad73aae0735 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 14 Feb 2022 19:59:54 +0100
Subject: [PATCH 2893/5547] Adjust test coverage to cover desired copy naming
 scheme

---
 .../Editing/TestSceneEditorBeatmapCreation.cs | 23 +++++++++++--------
 1 file changed, 13 insertions(+), 10 deletions(-)

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneEditorBeatmapCreation.cs b/osu.Game.Tests/Visual/Editing/TestSceneEditorBeatmapCreation.cs
index b4559ac9fa..0a2f622da1 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneEditorBeatmapCreation.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneEditorBeatmapCreation.cs
@@ -172,10 +172,10 @@ namespace osu.Game.Tests.Visual.Editing
         [Test]
         public void TestCopyDifficulty()
         {
-            string firstDifficultyName = Guid.NewGuid().ToString();
-            string secondDifficultyName = Guid.NewGuid().ToString();
+            string originalDifficultyName = Guid.NewGuid().ToString();
+            string copyDifficultyName = $"{originalDifficultyName} (copy)";
 
-            AddStep("set unique difficulty name", () => EditorBeatmap.BeatmapInfo.DifficultyName = firstDifficultyName);
+            AddStep("set unique difficulty name", () => EditorBeatmap.BeatmapInfo.DifficultyName = originalDifficultyName);
             AddStep("add timing point", () => EditorBeatmap.ControlPointInfo.Add(0, new TimingControlPoint { BeatLength = 1000 }));
             AddStep("add hitobjects", () => EditorBeatmap.AddRange(new[]
             {
@@ -210,11 +210,11 @@ namespace osu.Game.Tests.Visual.Editing
             AddStep("save beatmap", () => Editor.Save());
             AddAssert("new beatmap persisted", () =>
             {
-                var beatmap = beatmapManager.QueryBeatmap(b => b.DifficultyName == firstDifficultyName);
+                var beatmap = beatmapManager.QueryBeatmap(b => b.DifficultyName == originalDifficultyName);
                 var set = beatmapManager.QueryBeatmapSet(s => s.ID == EditorBeatmap.BeatmapInfo.BeatmapSet.ID);
 
                 return beatmap != null
-                       && beatmap.DifficultyName == firstDifficultyName
+                       && beatmap.DifficultyName == originalDifficultyName
                        && set != null
                        && set.PerformRead(s => s.Beatmaps.Single().ID == beatmap.ID);
             });
@@ -228,9 +228,10 @@ namespace osu.Game.Tests.Visual.Editing
             AddUntilStep("wait for created", () =>
             {
                 string difficultyName = Editor.ChildrenOfType<EditorBeatmap>().SingleOrDefault()?.BeatmapInfo.DifficultyName;
-                return difficultyName != null && difficultyName != firstDifficultyName;
+                return difficultyName != null && difficultyName != originalDifficultyName;
             });
 
+            AddAssert("created difficulty has copy suffix in name", () => EditorBeatmap.BeatmapInfo.DifficultyName == copyDifficultyName);
             AddAssert("created difficulty has timing point", () =>
             {
                 var timingPoint = EditorBeatmap.ControlPointInfo.TimingPoints.Single();
@@ -243,7 +244,6 @@ namespace osu.Game.Tests.Visual.Editing
             AddAssert("status not copied", () => EditorBeatmap.BeatmapInfo.Status == BeatmapOnlineStatus.None);
             AddAssert("online ID not copied", () => EditorBeatmap.BeatmapInfo.OnlineID == -1);
 
-            AddStep("set unique difficulty name", () => EditorBeatmap.BeatmapInfo.DifficultyName = secondDifficultyName);
             AddStep("save beatmap", () => Editor.Save());
 
             BeatmapInfo refetchedBeatmap = null;
@@ -251,16 +251,19 @@ namespace osu.Game.Tests.Visual.Editing
 
             AddStep("refetch from database", () =>
             {
-                refetchedBeatmap = beatmapManager.QueryBeatmap(b => b.DifficultyName == secondDifficultyName);
+                refetchedBeatmap = beatmapManager.QueryBeatmap(b => b.DifficultyName == copyDifficultyName);
                 refetchedBeatmapSet = beatmapManager.QueryBeatmapSet(s => s.ID == EditorBeatmap.BeatmapInfo.BeatmapSet.ID);
             });
 
             AddAssert("new beatmap persisted", () =>
             {
                 return refetchedBeatmap != null
-                       && refetchedBeatmap.DifficultyName == secondDifficultyName
+                       && refetchedBeatmap.DifficultyName == copyDifficultyName
                        && refetchedBeatmapSet != null
-                       && refetchedBeatmapSet.PerformRead(s => s.Beatmaps.Count == 2 && s.Beatmaps.Any(b => b.DifficultyName == secondDifficultyName));
+                       && refetchedBeatmapSet.PerformRead(s =>
+                           s.Beatmaps.Count == 2
+                           && s.Beatmaps.Any(b => b.DifficultyName == originalDifficultyName)
+                           && s.Beatmaps.Any(b => b.DifficultyName == copyDifficultyName));
             });
             AddAssert("old beatmap file not deleted", () => refetchedBeatmapSet.AsNonNull().PerformRead(s => s.Files.Count == 2));
         }

From 62214471647382ff03bf1449db2c03bde8cfa9de Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 14 Feb 2022 20:19:12 +0100
Subject: [PATCH 2894/5547] Append copy suffix on creating copy of difficulty

---
 osu.Game/Beatmaps/BeatmapManager.cs   | 4 ++--
 osu.Game/Screens/Edit/Editor.cs       | 2 +-
 osu.Game/Screens/Edit/EditorLoader.cs | 9 ++++++++-
 3 files changed, 11 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index 884209ee56..d1b8e88743 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -134,8 +134,8 @@ namespace osu.Game.Beatmaps
                 newBeatmap.BeatmapInfo = newBeatmapInfo = referenceBeatmap.BeatmapInfo.Clone();
                 // assign a new ID to the clone.
                 newBeatmapInfo.ID = Guid.NewGuid();
-                // clear difficulty name to avoid clashes on save.
-                newBeatmapInfo.DifficultyName = string.Empty;
+                // add "(copy)" suffix to difficulty name to avoid clashes on save.
+                newBeatmapInfo.DifficultyName += " (copy)";
                 // clear the hash, as that's what is used to match .osu files with their corresponding realm beatmaps.
                 newBeatmapInfo.Hash = string.Empty;
                 // clear online properties.
diff --git a/osu.Game/Screens/Edit/Editor.cs b/osu.Game/Screens/Edit/Editor.cs
index 37d4dce60e..7a3c4f2a19 100644
--- a/osu.Game/Screens/Edit/Editor.cs
+++ b/osu.Game/Screens/Edit/Editor.cs
@@ -857,7 +857,7 @@ namespace osu.Game.Screens.Edit
             (
                 editorBeatmap.BeatmapInfo.BeatmapSet.AsNonNull(),
                 rulesetInfo,
-                playableBeatmap,
+                editorBeatmap,
                 editorBeatmap.BeatmapSkin,
                 clearAllObjects,
                 GetState()
diff --git a/osu.Game/Screens/Edit/EditorLoader.cs b/osu.Game/Screens/Edit/EditorLoader.cs
index be3e68c857..505a57f157 100644
--- a/osu.Game/Screens/Edit/EditorLoader.cs
+++ b/osu.Game/Screens/Edit/EditorLoader.cs
@@ -84,7 +84,14 @@ namespace osu.Game.Screens.Edit
             {
                 try
                 {
-                    return beatmapManager.CreateNewDifficulty(creationParameters);
+                    var refetchedBeatmap = beatmapManager.GetWorkingBeatmap(creationParameters.ReferenceBeatmap.BeatmapInfo);
+                    return beatmapManager.CreateNewDifficulty(new NewDifficultyCreationParameters(
+                        refetchedBeatmap.BeatmapSetInfo,
+                        refetchedBeatmap.BeatmapInfo.Ruleset,
+                        refetchedBeatmap.Beatmap,
+                        refetchedBeatmap.Skin,
+                        creationParameters.CreateBlank,
+                        creationParameters.EditorState));
                 }
                 catch (Exception ex)
                 {

From e45a2ae0fc9b24af51454589be31923cb80543ca Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 14 Feb 2022 20:56:05 +0100
Subject: [PATCH 2895/5547] Restructure difficulty copy flow to adapt to latest
 changes

---
 osu.Game/Beatmaps/BeatmapManager.cs           | 83 +++++++++++--------
 .../Screens/Edit/CreateNewDifficultyDialog.cs | 12 +--
 osu.Game/Screens/Edit/Editor.cs               | 27 ++----
 osu.Game/Screens/Edit/EditorLoader.cs         | 21 ++---
 .../Edit/NewDifficultyCreationParameters.cs   | 65 ---------------
 osu.Game/Tests/Visual/EditorTestScene.cs      |  8 +-
 6 files changed, 83 insertions(+), 133 deletions(-)
 delete mode 100644 osu.Game/Screens/Edit/NewDifficultyCreationParameters.cs

diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index d1b8e88743..777d5db2ad 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -20,7 +20,6 @@ using osu.Game.Online.API;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays.Notifications;
 using osu.Game.Rulesets;
-using osu.Game.Screens.Edit;
 using osu.Game.Skinning;
 using osu.Game.Stores;
 
@@ -109,55 +108,73 @@ namespace osu.Game.Beatmaps
         }
 
         /// <summary>
-        /// Add a new difficulty to the beatmap set represented by the provided <see cref="BeatmapSetInfo"/>.
+        /// Add a new difficulty to the provided <paramref name="targetBeatmapSet"/> based on the provided <paramref name="referenceWorkingBeatmap"/>.
         /// The new difficulty will be backed by a <see cref="BeatmapInfo"/> model
         /// and represented by the returned <see cref="WorkingBeatmap"/>.
         /// </summary>
-        public virtual WorkingBeatmap CreateNewDifficulty(NewDifficultyCreationParameters creationParameters)
+        /// <remarks>
+        /// Contrary to <see cref="CopyExistingDifficulty"/>, this method does not preserve hitobjects and beatmap-level settings from <paramref name="referenceWorkingBeatmap"/>.
+        /// The created beatmap will have zero hitobjects and will have default settings (including difficulty settings), but will preserve metadata and existing timing points.
+        /// </remarks>
+        /// <param name="targetBeatmapSet">The <see cref="BeatmapSetInfo"/> to add the new difficulty to.</param>
+        /// <param name="referenceWorkingBeatmap">The <see cref="WorkingBeatmap"/> to use as a baseline reference when creating the new difficulty.</param>
+        /// <param name="rulesetInfo">The ruleset with which the new difficulty should be created.</param>
+        public virtual WorkingBeatmap CreateNewDifficulty(BeatmapSetInfo targetBeatmapSet, WorkingBeatmap referenceWorkingBeatmap, RulesetInfo rulesetInfo)
         {
-            var referenceBeatmap = creationParameters.ReferenceBeatmap;
-            var targetBeatmapSet = creationParameters.BeatmapSet;
+            var playableBeatmap = referenceWorkingBeatmap.GetPlayableBeatmap(rulesetInfo);
 
+            var newBeatmapInfo = new BeatmapInfo(rulesetInfo, new BeatmapDifficulty(), playableBeatmap.Metadata.DeepClone());
+            var newBeatmap = new Beatmap { BeatmapInfo = newBeatmapInfo };
+            foreach (var timingPoint in playableBeatmap.ControlPointInfo.TimingPoints)
+                newBeatmap.ControlPointInfo.Add(timingPoint.Time, timingPoint.DeepClone());
+
+            return addDifficultyToSet(targetBeatmapSet, newBeatmap, referenceWorkingBeatmap.Skin);
+        }
+
+        /// <summary>
+        /// Add a copy of the provided <paramref name="referenceWorkingBeatmap"/> to the provided <paramref name="targetBeatmapSet"/>.
+        /// The new difficulty will be backed by a <see cref="BeatmapInfo"/> model
+        /// and represented by the returned <see cref="WorkingBeatmap"/>.
+        /// </summary>
+        /// <remarks>
+        /// Contrary to <see cref="CreateNewDifficulty"/>, this method creates a nearly-exact copy of <paramref name="referenceWorkingBeatmap"/>
+        /// (with the exception of a few key properties that cannot be copied under any circumstance, like difficulty name, beatmap hash, or online status).
+        /// </remarks>
+        /// <param name="targetBeatmapSet">The <see cref="BeatmapSetInfo"/> to add the copy to.</param>
+        /// <param name="referenceWorkingBeatmap">The <see cref="WorkingBeatmap"/> to be copied.</param>
+        public virtual WorkingBeatmap CopyExistingDifficulty(BeatmapSetInfo targetBeatmapSet, WorkingBeatmap referenceWorkingBeatmap)
+        {
+            var newBeatmap = referenceWorkingBeatmap.GetPlayableBeatmap(referenceWorkingBeatmap.BeatmapInfo.Ruleset).Clone();
             BeatmapInfo newBeatmapInfo;
-            IBeatmap newBeatmap;
 
-            if (creationParameters.CreateBlank)
-            {
-                newBeatmapInfo = new BeatmapInfo(creationParameters.Ruleset, new BeatmapDifficulty(), referenceBeatmap.Metadata.DeepClone());
-                newBeatmap = new Beatmap { BeatmapInfo = newBeatmapInfo };
-                foreach (var timingPoint in referenceBeatmap.ControlPointInfo.TimingPoints)
-                    newBeatmap.ControlPointInfo.Add(timingPoint.Time, timingPoint.DeepClone());
-            }
-            else
-            {
-                newBeatmap = referenceBeatmap.Clone();
-                newBeatmap.BeatmapInfo = newBeatmapInfo = referenceBeatmap.BeatmapInfo.Clone();
-                // assign a new ID to the clone.
-                newBeatmapInfo.ID = Guid.NewGuid();
-                // add "(copy)" suffix to difficulty name to avoid clashes on save.
-                newBeatmapInfo.DifficultyName += " (copy)";
-                // clear the hash, as that's what is used to match .osu files with their corresponding realm beatmaps.
-                newBeatmapInfo.Hash = string.Empty;
-                // clear online properties.
-                newBeatmapInfo.OnlineID = -1;
-                newBeatmapInfo.Status = BeatmapOnlineStatus.None;
-            }
+            newBeatmap.BeatmapInfo = newBeatmapInfo = referenceWorkingBeatmap.BeatmapInfo.Clone();
+            // assign a new ID to the clone.
+            newBeatmapInfo.ID = Guid.NewGuid();
+            // add "(copy)" suffix to difficulty name to avoid clashes on save.
+            newBeatmapInfo.DifficultyName += " (copy)";
+            // clear the hash, as that's what is used to match .osu files with their corresponding realm beatmaps.
+            newBeatmapInfo.Hash = string.Empty;
+            // clear online properties.
+            newBeatmapInfo.OnlineID = -1;
+            newBeatmapInfo.Status = BeatmapOnlineStatus.None;
 
+            return addDifficultyToSet(targetBeatmapSet, newBeatmap, referenceWorkingBeatmap.Skin);
+        }
+
+        private WorkingBeatmap addDifficultyToSet(BeatmapSetInfo targetBeatmapSet, IBeatmap newBeatmap, ISkin beatmapSkin)
+        {
             // populate circular beatmap set info <-> beatmap info references manually.
             // several places like `BeatmapModelManager.Save()` or `GetWorkingBeatmap()`
             // rely on them being freely traversable in both directions for correct operation.
-            targetBeatmapSet.Beatmaps.Add(newBeatmapInfo);
-            newBeatmapInfo.BeatmapSet = targetBeatmapSet;
+            targetBeatmapSet.Beatmaps.Add(newBeatmap.BeatmapInfo);
+            newBeatmap.BeatmapInfo.BeatmapSet = targetBeatmapSet;
 
-            beatmapModelManager.Save(newBeatmapInfo, newBeatmap, creationParameters.ReferenceBeatmapSkin);
+            beatmapModelManager.Save(newBeatmap.BeatmapInfo, newBeatmap, beatmapSkin);
 
             workingBeatmapCache.Invalidate(targetBeatmapSet);
             return GetWorkingBeatmap(newBeatmap.BeatmapInfo);
         }
 
-        // TODO: add back support for making a copy of another difficulty
-        // (likely via a separate `CopyDifficulty()` method).
-
         /// <summary>
         /// Delete a beatmap difficulty.
         /// </summary>
diff --git a/osu.Game/Screens/Edit/CreateNewDifficultyDialog.cs b/osu.Game/Screens/Edit/CreateNewDifficultyDialog.cs
index 138e13bda1..aa6ca280ee 100644
--- a/osu.Game/Screens/Edit/CreateNewDifficultyDialog.cs
+++ b/osu.Game/Screens/Edit/CreateNewDifficultyDialog.cs
@@ -10,11 +10,11 @@ namespace osu.Game.Screens.Edit
     {
         /// <summary>
         /// Delegate used to create new difficulties.
-        /// A value of <see langword="true"/> in the <c>clearAllObjects</c> parameter
-        /// indicates that the new difficulty should have its hitobjects cleared;
-        /// otherwise, the new difficulty should be an exact copy of an existing one.
+        /// A value of <see langword="true"/> in the <c>createCopy</c> parameter
+        /// indicates that the new difficulty should be an exact copy of an existing one;
+        /// otherwise, the new difficulty should have its hitobjects and beatmap-level settings cleared.
         /// </summary>
-        public delegate void CreateNewDifficulty(bool clearAllObjects);
+        public delegate void CreateNewDifficulty(bool createCopy);
 
         public CreateNewDifficultyDialog(CreateNewDifficulty createNewDifficulty)
         {
@@ -27,12 +27,12 @@ namespace osu.Game.Screens.Edit
                 new PopupDialogOkButton
                 {
                     Text = "Yeah, let's start from scratch!",
-                    Action = () => createNewDifficulty.Invoke(true)
+                    Action = () => createNewDifficulty.Invoke(false)
                 },
                 new PopupDialogCancelButton
                 {
                     Text = "No, create an exact copy of this difficulty",
-                    Action = () => createNewDifficulty.Invoke(false)
+                    Action = () => createNewDifficulty.Invoke(true)
                 },
                 new PopupDialogCancelButton
                 {
diff --git a/osu.Game/Screens/Edit/Editor.cs b/osu.Game/Screens/Edit/Editor.cs
index 7a3c4f2a19..c2775ae101 100644
--- a/osu.Game/Screens/Edit/Editor.cs
+++ b/osu.Game/Screens/Edit/Editor.cs
@@ -9,7 +9,6 @@ using JetBrains.Annotations;
 using osu.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
-using osu.Framework.Extensions.ObjectExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
@@ -359,14 +358,14 @@ namespace osu.Game.Screens.Edit
         /// <summary>
         /// Creates an <see cref="EditorState"/> instance representing the current state of the editor.
         /// </summary>
-        /// <param name="nextBeatmap">
-        /// The next beatmap to be shown, in the case of difficulty switch.
+        /// <param name="nextRuleset">
+        /// The ruleset of the next beatmap to be shown, in the case of difficulty switch.
         /// <see langword="null"/> indicates that the beatmap will not be changing.
         /// </param>
-        public EditorState GetState([CanBeNull] BeatmapInfo nextBeatmap = null) => new EditorState
+        public EditorState GetState([CanBeNull] RulesetInfo nextRuleset = null) => new EditorState
         {
             Time = clock.CurrentTimeAccurate,
-            ClipboardContent = nextBeatmap == null || editorBeatmap.BeatmapInfo.Ruleset.ShortName == nextBeatmap.Ruleset.ShortName ? Clipboard.Content.Value : string.Empty
+            ClipboardContent = nextRuleset == null || editorBeatmap.BeatmapInfo.Ruleset.ShortName == nextRuleset.ShortName ? Clipboard.Content.Value : string.Empty
         };
 
         /// <summary>
@@ -845,23 +844,15 @@ namespace osu.Game.Screens.Edit
         {
             if (!rulesetInfo.Equals(editorBeatmap.BeatmapInfo.Ruleset))
             {
-                switchToNewDifficulty(rulesetInfo, true);
+                switchToNewDifficulty(rulesetInfo, false);
                 return;
             }
 
-            dialogOverlay.Push(new CreateNewDifficultyDialog(clearAllObjects => switchToNewDifficulty(rulesetInfo, clearAllObjects)));
+            dialogOverlay.Push(new CreateNewDifficultyDialog(createCopy => switchToNewDifficulty(rulesetInfo, createCopy)));
         }
 
-        private void switchToNewDifficulty(RulesetInfo rulesetInfo, bool clearAllObjects)
-            => loader?.ScheduleSwitchToNewDifficulty(new NewDifficultyCreationParameters
-            (
-                editorBeatmap.BeatmapInfo.BeatmapSet.AsNonNull(),
-                rulesetInfo,
-                editorBeatmap,
-                editorBeatmap.BeatmapSkin,
-                clearAllObjects,
-                GetState()
-            ));
+        private void switchToNewDifficulty(RulesetInfo rulesetInfo, bool createCopy)
+            => loader?.ScheduleSwitchToNewDifficulty(editorBeatmap.BeatmapInfo, rulesetInfo, createCopy, GetState(rulesetInfo));
 
         private EditorMenuItem createDifficultySwitchMenu()
         {
@@ -886,7 +877,7 @@ namespace osu.Game.Screens.Edit
             return new EditorMenuItem("Change difficulty") { Items = difficultyItems };
         }
 
-        protected void SwitchToDifficulty(BeatmapInfo nextBeatmap) => loader?.ScheduleSwitchToExistingDifficulty(nextBeatmap, GetState(nextBeatmap));
+        protected void SwitchToDifficulty(BeatmapInfo nextBeatmap) => loader?.ScheduleSwitchToExistingDifficulty(nextBeatmap, GetState(nextBeatmap.Ruleset));
 
         private void cancelExit()
         {
diff --git a/osu.Game/Screens/Edit/EditorLoader.cs b/osu.Game/Screens/Edit/EditorLoader.cs
index 505a57f157..0a2b8437fa 100644
--- a/osu.Game/Screens/Edit/EditorLoader.cs
+++ b/osu.Game/Screens/Edit/EditorLoader.cs
@@ -4,6 +4,7 @@
 using System;
 using JetBrains.Annotations;
 using osu.Framework.Allocation;
+using osu.Framework.Extensions.ObjectExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Logging;
@@ -11,6 +12,7 @@ using osu.Framework.Screens;
 using osu.Framework.Threading;
 using osu.Game.Beatmaps;
 using osu.Game.Graphics.UserInterface;
+using osu.Game.Rulesets;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Screens.Menu;
 using osu.Game.Screens.Play;
@@ -79,19 +81,18 @@ namespace osu.Game.Screens.Edit
             }
         }
 
-        public void ScheduleSwitchToNewDifficulty(NewDifficultyCreationParameters creationParameters)
+        public void ScheduleSwitchToNewDifficulty(BeatmapInfo referenceBeatmapInfo, RulesetInfo rulesetInfo, bool createCopy, EditorState editorState)
             => scheduleDifficultySwitch(() =>
             {
                 try
                 {
-                    var refetchedBeatmap = beatmapManager.GetWorkingBeatmap(creationParameters.ReferenceBeatmap.BeatmapInfo);
-                    return beatmapManager.CreateNewDifficulty(new NewDifficultyCreationParameters(
-                        refetchedBeatmap.BeatmapSetInfo,
-                        refetchedBeatmap.BeatmapInfo.Ruleset,
-                        refetchedBeatmap.Beatmap,
-                        refetchedBeatmap.Skin,
-                        creationParameters.CreateBlank,
-                        creationParameters.EditorState));
+                    // fetch a fresh detached reference from database to avoid polluting model instances attached to cached working beatmaps.
+                    var targetBeatmapSet = beatmapManager.QueryBeatmap(b => b.ID == referenceBeatmapInfo.ID).AsNonNull().BeatmapSet.AsNonNull();
+                    var referenceWorkingBeatmap = beatmapManager.GetWorkingBeatmap(referenceBeatmapInfo);
+
+                    return createCopy
+                        ? beatmapManager.CopyExistingDifficulty(targetBeatmapSet, referenceWorkingBeatmap)
+                        : beatmapManager.CreateNewDifficulty(targetBeatmapSet, referenceWorkingBeatmap, rulesetInfo);
                 }
                 catch (Exception ex)
                 {
@@ -100,7 +101,7 @@ namespace osu.Game.Screens.Edit
                     Logger.Error(ex, ex.Message);
                     return Beatmap.Value;
                 }
-            }, creationParameters.EditorState);
+            }, editorState);
 
         public void ScheduleSwitchToExistingDifficulty(BeatmapInfo beatmapInfo, EditorState editorState)
             => scheduleDifficultySwitch(() => beatmapManager.GetWorkingBeatmap(beatmapInfo), editorState);
diff --git a/osu.Game/Screens/Edit/NewDifficultyCreationParameters.cs b/osu.Game/Screens/Edit/NewDifficultyCreationParameters.cs
deleted file mode 100644
index a6458a9456..0000000000
--- a/osu.Game/Screens/Edit/NewDifficultyCreationParameters.cs
+++ /dev/null
@@ -1,65 +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 enable
-
-using osu.Game.Beatmaps;
-using osu.Game.Rulesets;
-using osu.Game.Skinning;
-
-namespace osu.Game.Screens.Edit
-{
-    public class NewDifficultyCreationParameters
-    {
-        /// <summary>
-        /// The <see cref="BeatmapSetInfo"/> that should contain the newly-created difficulty.
-        /// </summary>
-        public BeatmapSetInfo BeatmapSet { get; }
-
-        /// <summary>
-        /// The <see cref="RulesetInfo"/> that the new difficulty should be playable for.
-        /// </summary>
-        public RulesetInfo Ruleset { get; }
-
-        /// <summary>
-        /// A reference <see cref="IBeatmap"/> upon which the new difficulty should be based.
-        /// </summary>
-        public IBeatmap ReferenceBeatmap { get; }
-
-        /// <summary>
-        /// A reference <see cref="ISkin"/> that the new difficulty should base its own skin upon.
-        /// </summary>
-        public ISkin? ReferenceBeatmapSkin { get; }
-
-        /// <summary>
-        /// Whether the new difficulty should be blank.
-        /// </summary>
-        /// <remarks>
-        /// A blank difficulty will have no objects, no control points other than timing points taken from <see cref="ReferenceBeatmap"/>
-        /// and will not share <see cref="BeatmapInfo"/> values with <see cref="ReferenceBeatmap"/>,
-        /// but it will share metadata and timing information with <see cref="ReferenceBeatmap"/>.
-        /// </remarks>
-        public bool CreateBlank { get; }
-
-        /// <summary>
-        /// The saved state of the previous <see cref="Editor"/> which should be restored upon opening the newly-created difficulty.
-        /// </summary>
-        public EditorState EditorState { get; }
-
-        public NewDifficultyCreationParameters(
-            BeatmapSetInfo beatmapSet,
-            RulesetInfo ruleset,
-            IBeatmap referenceBeatmap,
-            ISkin? referenceBeatmapSkin,
-            bool createBlank,
-            EditorState editorState)
-        {
-            BeatmapSet = beatmapSet;
-            Ruleset = ruleset;
-            ReferenceBeatmap = referenceBeatmap;
-            ReferenceBeatmapSkin = referenceBeatmapSkin;
-            CreateBlank = createBlank;
-            EditorState = editorState;
-        }
-    }
-}
diff --git a/osu.Game/Tests/Visual/EditorTestScene.cs b/osu.Game/Tests/Visual/EditorTestScene.cs
index 8c8a106791..24015590e2 100644
--- a/osu.Game/Tests/Visual/EditorTestScene.cs
+++ b/osu.Game/Tests/Visual/EditorTestScene.cs
@@ -136,7 +136,13 @@ namespace osu.Game.Tests.Visual
                 return new TestWorkingBeatmapCache(this, audioManager, resources, storage, defaultBeatmap, host);
             }
 
-            public override WorkingBeatmap CreateNewDifficulty(NewDifficultyCreationParameters creationParameters)
+            public override WorkingBeatmap CreateNewDifficulty(BeatmapSetInfo targetBeatmapSet, WorkingBeatmap referenceWorkingBeatmap, RulesetInfo rulesetInfo)
+            {
+                // don't actually care about properly creating a difficulty for this context.
+                return TestBeatmap;
+            }
+
+            public override WorkingBeatmap CopyExistingDifficulty(BeatmapSetInfo targetBeatmapSet, WorkingBeatmap referenceWorkingBeatmap)
             {
                 // don't actually care about properly creating a difficulty for this context.
                 return TestBeatmap;

From 19ee05c232eb86710001bdad3bef2e135f7bc97a Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Mon, 17 Jan 2022 20:09:02 +0300
Subject: [PATCH 2896/5547] Add "distance spacing" multiplier for osu! ruleset

While osu!catch also implements a distance snap grid, it doesn't rely on
`GetBeatSnapDistanceAt` (unlike osu!), therefore it can't have the
"distance spacing" multiplier yet.
---
 .../Edit/CatchHitObjectComposer.cs            |   2 +
 .../Edit/ManiaHitObjectComposer.cs            |   2 +
 .../Edit/OsuHitObjectComposer.cs              |   2 +
 .../Edit/TaikoHitObjectComposer.cs            |   2 +
 .../UserInterface/ExpandableSlider.cs         |   9 ++
 osu.Game/Rulesets/Edit/HitObjectComposer.cs   | 101 +++++++++++++++++-
 6 files changed, 116 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Rulesets.Catch/Edit/CatchHitObjectComposer.cs b/osu.Game.Rulesets.Catch/Edit/CatchHitObjectComposer.cs
index 164f465438..19595de3b1 100644
--- a/osu.Game.Rulesets.Catch/Edit/CatchHitObjectComposer.cs
+++ b/osu.Game.Rulesets.Catch/Edit/CatchHitObjectComposer.cs
@@ -32,6 +32,8 @@ namespace osu.Game.Rulesets.Catch.Edit
 
         private readonly Bindable<TernaryState> distanceSnapToggle = new Bindable<TernaryState>();
 
+        protected override bool SupportsDistanceSpacing => false;
+
         private InputManager inputManager;
 
         public CatchHitObjectComposer(CatchRuleset ruleset)
diff --git a/osu.Game.Rulesets.Mania/Edit/ManiaHitObjectComposer.cs b/osu.Game.Rulesets.Mania/Edit/ManiaHitObjectComposer.cs
index 2baec95c94..5752f9f014 100644
--- a/osu.Game.Rulesets.Mania/Edit/ManiaHitObjectComposer.cs
+++ b/osu.Game.Rulesets.Mania/Edit/ManiaHitObjectComposer.cs
@@ -26,6 +26,8 @@ namespace osu.Game.Rulesets.Mania.Edit
         private ManiaBeatSnapGrid beatSnapGrid;
         private InputManager inputManager;
 
+        protected override bool SupportsDistanceSpacing => false;
+
         public ManiaHitObjectComposer(Ruleset ruleset)
             : base(ruleset)
         {
diff --git a/osu.Game.Rulesets.Osu/Edit/OsuHitObjectComposer.cs b/osu.Game.Rulesets.Osu/Edit/OsuHitObjectComposer.cs
index 1e84ec80e1..e7eabdc748 100644
--- a/osu.Game.Rulesets.Osu/Edit/OsuHitObjectComposer.cs
+++ b/osu.Game.Rulesets.Osu/Edit/OsuHitObjectComposer.cs
@@ -26,6 +26,8 @@ namespace osu.Game.Rulesets.Osu.Edit
 {
     public class OsuHitObjectComposer : HitObjectComposer<OsuHitObject>
     {
+        protected override bool SupportsDistanceSpacing => true;
+
         public OsuHitObjectComposer(Ruleset ruleset)
             : base(ruleset)
         {
diff --git a/osu.Game.Rulesets.Taiko/Edit/TaikoHitObjectComposer.cs b/osu.Game.Rulesets.Taiko/Edit/TaikoHitObjectComposer.cs
index 161799c980..af9bc6c3a3 100644
--- a/osu.Game.Rulesets.Taiko/Edit/TaikoHitObjectComposer.cs
+++ b/osu.Game.Rulesets.Taiko/Edit/TaikoHitObjectComposer.cs
@@ -11,6 +11,8 @@ namespace osu.Game.Rulesets.Taiko.Edit
 {
     public class TaikoHitObjectComposer : HitObjectComposer<TaikoHitObject>
     {
+        protected override bool SupportsDistanceSpacing => false;
+
         public TaikoHitObjectComposer(TaikoRuleset ruleset)
             : base(ruleset)
         {
diff --git a/osu.Game/Graphics/UserInterface/ExpandableSlider.cs b/osu.Game/Graphics/UserInterface/ExpandableSlider.cs
index 60e83f9c81..a05c0cfab0 100644
--- a/osu.Game/Graphics/UserInterface/ExpandableSlider.cs
+++ b/osu.Game/Graphics/UserInterface/ExpandableSlider.cs
@@ -70,6 +70,15 @@ namespace osu.Game.Graphics.UserInterface
             set => slider.Current = value;
         }
 
+        /// <summary>
+        /// A custom step value for each key press which actuates a change on this control.
+        /// </summary>
+        public float KeyboardStep
+        {
+            get => slider.KeyboardStep;
+            set => slider.KeyboardStep = value;
+        }
+
         public BindableBool Expanded { get; } = new BindableBool();
 
         public override bool HandlePositionalInput => true;
diff --git a/osu.Game/Rulesets/Edit/HitObjectComposer.cs b/osu.Game/Rulesets/Edit/HitObjectComposer.cs
index 39783cc8bb..528ba2fb8b 100644
--- a/osu.Game/Rulesets/Edit/HitObjectComposer.cs
+++ b/osu.Game/Rulesets/Edit/HitObjectComposer.cs
@@ -14,6 +14,8 @@ using osu.Framework.Input.Events;
 using osu.Framework.Logging;
 using osu.Game.Beatmaps;
 using osu.Game.Graphics.Containers;
+using osu.Game.Graphics.UserInterface;
+using osu.Game.Overlays.Settings.Sections;
 using osu.Game.Rulesets.Configuration;
 using osu.Game.Rulesets.Edit.Tools;
 using osu.Game.Rulesets.Mods;
@@ -56,6 +58,26 @@ namespace osu.Game.Rulesets.Edit
         [Resolved]
         protected IBeatSnapProvider BeatSnapProvider { get; private set; }
 
+        /// <summary>
+        /// Whether this composer supports a "distance spacing" multiplier for distance snap grids.
+        /// </summary>
+        /// <remarks>
+        /// Setting this to <see langword="true"/> displays a "distance spacing" slider and allows this composer to configure the value of <see cref="BeatmapInfo.DistanceSpacing"/>.
+        /// </remarks>
+        protected abstract bool SupportsDistanceSpacing { get; }
+
+        private readonly BindableFloat distanceSpacing = new BindableFloat
+        {
+            Default = 1.0f,
+            MinValue = 0.1f,
+            MaxValue = 6.0f,
+            Precision = 0.01f,
+        };
+
+        public override IBindable<float> DistanceSpacingMultiplier => distanceSpacing;
+
+        private SnappingToolboxContainer snappingToolboxContainer;
+
         protected ComposeBlueprintContainer BlueprintContainer { get; private set; }
 
         private DrawableEditorRulesetWrapper<TObject> drawableRulesetWrapper;
@@ -117,6 +139,8 @@ namespace osu.Game.Rulesets.Edit
                 },
                 new LeftToolboxFlow
                 {
+                    Anchor = Anchor.TopLeft,
+                    Origin = Anchor.TopLeft,
                     Children = new Drawable[]
                     {
                         new EditorToolboxGroup("toolbox (1-9)")
@@ -132,11 +156,41 @@ namespace osu.Game.Rulesets.Edit
                                 Direction = FillDirection.Vertical,
                                 Spacing = new Vector2(0, 5),
                             },
-                        }
+                        },
                     }
                 },
             };
 
+            distanceSpacing.Value = (float)EditorBeatmap.BeatmapInfo.DistanceSpacing;
+
+            if (SupportsDistanceSpacing)
+            {
+                ExpandableSlider<float, SizeSlider> distanceSpacingSlider;
+
+                AddInternal(snappingToolboxContainer = new SnappingToolboxContainer
+                {
+                    Anchor = Anchor.TopRight,
+                    Origin = Anchor.TopRight,
+                    Child = new EditorToolboxGroup("snapping")
+                    {
+                        Child = distanceSpacingSlider = new ExpandableSlider<float, SizeSlider>
+                        {
+                            Current = { BindTarget = distanceSpacing },
+                            KeyboardStep = 0.01f,
+                        }
+                    }
+                });
+
+                distanceSpacing.BindValueChanged(v =>
+                {
+                    distanceSpacingSlider.ContractedLabelText = $"D. S. ({v.NewValue:0.##x})";
+                    distanceSpacingSlider.ExpandedLabelText = $"Distance Spacing ({v.NewValue:0.##x})";
+                    EditorBeatmap.BeatmapInfo.DistanceSpacing = v.NewValue;
+                }, true);
+            }
+            else
+                distanceSpacing.Disabled = true;
+
             toolboxCollection.Items = CompositionTools
                                       .Prepend(new SelectTool())
                                       .Select(t => new RadioButton(t.Name, () => toolSelected(t), t.CreateIcon))
@@ -211,8 +265,17 @@ namespace osu.Game.Rulesets.Edit
 
         #region Tool selection logic
 
+        private bool distanceSpacingScrollActive;
+
         protected override bool OnKeyDown(KeyDownEvent e)
         {
+            if (SupportsDistanceSpacing && e.AltPressed && e.Key == Key.D && !e.Repeat)
+            {
+                snappingToolboxContainer.Expanded.Value = true;
+                distanceSpacingScrollActive = true;
+                return true;
+            }
+
             if (e.ControlPressed || e.AltPressed || e.SuperPressed)
                 return false;
 
@@ -242,6 +305,28 @@ namespace osu.Game.Rulesets.Edit
             return base.OnKeyDown(e);
         }
 
+        protected override void OnKeyUp(KeyUpEvent e)
+        {
+            if (distanceSpacingScrollActive && (e.Key == Key.AltLeft || e.Key == Key.AltRight || e.Key == Key.D))
+            {
+                snappingToolboxContainer.Expanded.Value = false;
+                distanceSpacingScrollActive = false;
+            }
+
+            base.OnKeyUp(e);
+        }
+
+        protected override bool OnScroll(ScrollEvent e)
+        {
+            if (distanceSpacingScrollActive)
+            {
+                distanceSpacing.Value += e.ScrollDelta.Y * (e.ShiftPressed || e.IsPrecise ? 0.01f : 0.1f);
+                return true;
+            }
+
+            return base.OnScroll(e);
+        }
+
         private bool checkLeftToggleFromKey(Key key, out int index)
         {
             if (key < Key.Number1 || key > Key.Number9)
@@ -383,7 +468,7 @@ namespace osu.Game.Rulesets.Edit
 
         public override float GetBeatSnapDistanceAt(HitObject referenceObject)
         {
-            return (float)(100 * EditorBeatmap.Difficulty.SliderMultiplier * referenceObject.DifficultyControlPoint.SliderVelocity / BeatSnapProvider.BeatDivisor);
+            return (float)(100 * referenceObject.DifficultyControlPoint.SliderVelocity * EditorBeatmap.Difficulty.SliderMultiplier * distanceSpacing.Value / BeatSnapProvider.BeatDivisor);
         }
 
         public override float DurationToDistance(HitObject referenceObject, double duration)
@@ -432,6 +517,18 @@ namespace osu.Game.Rulesets.Edit
                 FillFlow.Spacing = new Vector2(10);
             }
         }
+
+        private class SnappingToolboxContainer : ExpandingContainer
+        {
+            public SnappingToolboxContainer()
+                : base(130, 250)
+            {
+                RelativeSizeAxes = Axes.Y;
+                Padding = new MarginPadding { Left = 10 };
+
+                FillFlow.Spacing = new Vector2(10);
+            }
+        }
     }
 
     /// <summary>

From 528dc03b8c06b94d1b45c0d07e8b681ba109fe00 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Tue, 18 Jan 2022 15:25:32 +0300
Subject: [PATCH 2897/5547] Expose distance spacing in `IPositionSnapProvider`
 for updating distance grid

Alternate method is to expose a `SnapDistancesChanged` event in
`IPositionSnapProvider` instead, but I chose this way as an analogue to
`IBeatSnapProvider.BeatDivisor`, which might even make sense to be
exposed as `BindableBeatDivisor` instead of caching that separately.
---
 .../Editor/TestSceneManiaBeatSnapGrid.cs                  | 3 +++
 .../Editor/TestSceneOsuDistanceSnapGrid.cs                | 3 +++
 .../Visual/Editing/TestSceneDistanceSnapGrid.cs           | 3 +++
 osu.Game/Rulesets/Edit/HitObjectComposer.cs               | 2 ++
 osu.Game/Rulesets/Edit/IPositionSnapProvider.cs           | 8 ++++++++
 .../Screens/Edit/Compose/Components/DistanceSnapGrid.cs   | 6 ++++++
 .../Screens/Edit/Compose/Components/Timeline/Timeline.cs  | 2 ++
 7 files changed, 27 insertions(+)

diff --git a/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneManiaBeatSnapGrid.cs b/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneManiaBeatSnapGrid.cs
index 50be13c4e0..38779ab47b 100644
--- a/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneManiaBeatSnapGrid.cs
+++ b/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneManiaBeatSnapGrid.cs
@@ -4,6 +4,7 @@
 using System.Collections.Generic;
 using System.Linq;
 using osu.Framework.Allocation;
+using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Input.Events;
 using osu.Framework.Timing;
@@ -98,6 +99,8 @@ namespace osu.Game.Rulesets.Mania.Tests.Editor
             set => InternalChild = value;
         }
 
+        public override IBindable<float> DistanceSpacingMultiplier => throw new System.NotImplementedException();
+
         public override SnapResult SnapScreenSpacePositionToValidTime(Vector2 screenSpacePosition)
         {
             throw new System.NotImplementedException();
diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuDistanceSnapGrid.cs b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuDistanceSnapGrid.cs
index c770e2d96f..c5829d5351 100644
--- a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuDistanceSnapGrid.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuDistanceSnapGrid.cs
@@ -4,6 +4,7 @@
 using System;
 using NUnit.Framework;
 using osu.Framework.Allocation;
+using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
@@ -186,6 +187,8 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
 
             public SnapResult SnapScreenSpacePositionToValidTime(Vector2 screenSpacePosition) => new SnapResult(screenSpacePosition, 0);
 
+            public IBindable<float> DistanceSpacingMultiplier { get; } = new BindableFloat(1);
+
             public float GetBeatSnapDistanceAt(HitObject referenceObject) => (float)beat_length;
 
             public float DurationToDistance(HitObject referenceObject, double duration) => (float)duration;
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneDistanceSnapGrid.cs b/osu.Game.Tests/Visual/Editing/TestSceneDistanceSnapGrid.cs
index 0d9e06e471..cba6d7692d 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneDistanceSnapGrid.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneDistanceSnapGrid.cs
@@ -3,6 +3,7 @@
 
 using NUnit.Framework;
 using osu.Framework.Allocation;
+using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Shapes;
 using osu.Game.Beatmaps.ControlPoints;
@@ -166,6 +167,8 @@ namespace osu.Game.Tests.Visual.Editing
 
             public SnapResult SnapScreenSpacePositionToValidTime(Vector2 screenSpacePosition) => new SnapResult(screenSpacePosition, 0);
 
+            public IBindable<float> DistanceSpacingMultiplier { get; } = new BindableFloat(1);
+
             public float GetBeatSnapDistanceAt(HitObject referenceObject) => 10;
 
             public float DurationToDistance(HitObject referenceObject, double duration) => (float)duration;
diff --git a/osu.Game/Rulesets/Edit/HitObjectComposer.cs b/osu.Game/Rulesets/Edit/HitObjectComposer.cs
index 528ba2fb8b..6cdc2699aa 100644
--- a/osu.Game/Rulesets/Edit/HitObjectComposer.cs
+++ b/osu.Game/Rulesets/Edit/HitObjectComposer.cs
@@ -563,6 +563,8 @@ namespace osu.Game.Rulesets.Edit
 
         #region IPositionSnapProvider
 
+        public abstract IBindable<float> DistanceSpacingMultiplier { get; }
+
         public abstract SnapResult SnapScreenSpacePositionToValidTime(Vector2 screenSpacePosition);
 
         public virtual SnapResult SnapScreenSpacePositionToValidPosition(Vector2 screenSpacePosition) =>
diff --git a/osu.Game/Rulesets/Edit/IPositionSnapProvider.cs b/osu.Game/Rulesets/Edit/IPositionSnapProvider.cs
index 743a2f41fc..1cfcb86e10 100644
--- a/osu.Game/Rulesets/Edit/IPositionSnapProvider.cs
+++ b/osu.Game/Rulesets/Edit/IPositionSnapProvider.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.Framework.Bindables;
+using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Objects;
 using osuTK;
 
@@ -8,6 +10,12 @@ namespace osu.Game.Rulesets.Edit
 {
     public interface IPositionSnapProvider
     {
+        /// <summary>
+        /// The spacing multiplier applied to beat snap distances.
+        /// </summary>
+        /// <seealso cref="BeatmapInfo.DistanceSpacing"/>
+        IBindable<float> DistanceSpacingMultiplier { get; }
+
         /// <summary>
         /// Given a position, find a valid time and position snap.
         /// </summary>
diff --git a/osu.Game/Screens/Edit/Compose/Components/DistanceSnapGrid.cs b/osu.Game/Screens/Edit/Compose/Components/DistanceSnapGrid.cs
index 05bf405f3c..afbe83ec83 100644
--- a/osu.Game/Screens/Edit/Compose/Components/DistanceSnapGrid.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/DistanceSnapGrid.cs
@@ -3,6 +3,7 @@
 
 using System;
 using osu.Framework.Allocation;
+using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Colour;
 using osu.Framework.Graphics.Containers;
@@ -52,6 +53,8 @@ namespace osu.Game.Screens.Edit.Compose.Components
         [Resolved]
         private BindableBeatDivisor beatDivisor { get; set; }
 
+        private IBindable<float> distanceSpacingMultiplier;
+
         private readonly LayoutValue gridCache = new LayoutValue(Invalidation.RequiredParentSizeToFit);
         private readonly double? endTime;
 
@@ -82,6 +85,9 @@ namespace osu.Game.Screens.Edit.Compose.Components
             base.LoadComplete();
 
             beatDivisor.BindValueChanged(_ => updateSpacing(), true);
+
+            distanceSpacingMultiplier = SnapProvider.DistanceSpacingMultiplier.GetBoundCopy();
+            distanceSpacingMultiplier.BindValueChanged(_ => updateSpacing(), true);
         }
 
         private void updateSpacing()
diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/Timeline.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/Timeline.cs
index 51cca4ceff..f3a328c6bc 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/Timeline.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/Timeline.cs
@@ -317,6 +317,8 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
         private double getTimeFromPosition(Vector2 localPosition) =>
             (localPosition.X / Content.DrawWidth) * track.Length;
 
+        public IBindable<float> DistanceSpacingMultiplier => throw new NotImplementedException();
+
         public float GetBeatSnapDistanceAt(HitObject referenceObject) => throw new NotImplementedException();
 
         public float DurationToDistance(HitObject referenceObject, double duration) => throw new NotImplementedException();

From 9504942cfda38af4e6c5c15450a8258f1082de8c Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Tue, 18 Jan 2022 18:30:31 +0300
Subject: [PATCH 2898/5547] Add test case for distance spacing hotkeys
 scrolling behaviour

---
 .../Editing/TestSceneHitObjectComposer.cs     | 24 +++++++++++++++++++
 osu.Game/Overlays/SettingsToolboxGroup.cs     |  7 ++++++
 2 files changed, 31 insertions(+)

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneHitObjectComposer.cs b/osu.Game.Tests/Visual/Editing/TestSceneHitObjectComposer.cs
index 145d738f60..7ac511e761 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneHitObjectComposer.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneHitObjectComposer.cs
@@ -8,6 +8,7 @@ using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Testing;
+using osu.Framework.Utils;
 using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.ControlPoints;
 using osu.Game.Rulesets.Edit;
@@ -21,6 +22,7 @@ using osu.Game.Screens.Edit;
 using osu.Game.Screens.Edit.Components.RadioButtons;
 using osu.Game.Screens.Edit.Compose.Components;
 using osuTK;
+using osuTK.Input;
 
 namespace osu.Game.Tests.Visual.Editing
 {
@@ -86,6 +88,28 @@ namespace osu.Game.Tests.Visual.Editing
             AddAssert("Tool changed", () => hitObjectComposer.ChildrenOfType<ComposeBlueprintContainer>().First().CurrentTool is HitCircleCompositionTool);
         }
 
+        [Test]
+        public void TestDistanceSpacingHotkeys()
+        {
+            float originalSpacing = 0;
+
+            AddStep("retrieve original spacing", () => originalSpacing = (float)editorBeatmap.BeatmapInfo.DistanceSpacing);
+
+            AddStep("hold alt", () => InputManager.PressKey(Key.LAlt));
+            AddStep("hold D", () => InputManager.PressKey(Key.D));
+
+            AddStep("scroll mouse 5 steps", () => InputManager.ScrollVerticalBy(5));
+            AddAssert("distance spacing increased by 0.5", () => Precision.AlmostEquals(editorBeatmap.BeatmapInfo.DistanceSpacing, originalSpacing + 0.5f));
+
+            AddStep("hold shift", () => InputManager.PressKey(Key.LShift));
+            AddStep("scroll mouse 5 steps", () => InputManager.ScrollVerticalBy(5));
+            AddAssert("distance spacing increased by 0.05", () => Precision.AlmostEquals(editorBeatmap.BeatmapInfo.DistanceSpacing, originalSpacing + 0.55f));
+
+            AddStep("release shift", () => InputManager.ReleaseKey(Key.LShift));
+            AddStep("release alt", () => InputManager.ReleaseKey(Key.LAlt));
+            AddStep("release D", () => InputManager.ReleaseKey(Key.D));
+        }
+
         public class EditorBeatmapContainer : Container
         {
             private readonly IWorkingBeatmap working;
diff --git a/osu.Game/Overlays/SettingsToolboxGroup.cs b/osu.Game/Overlays/SettingsToolboxGroup.cs
index 08321f68fe..509410ec20 100644
--- a/osu.Game/Overlays/SettingsToolboxGroup.cs
+++ b/osu.Game/Overlays/SettingsToolboxGroup.cs
@@ -22,6 +22,11 @@ namespace osu.Game.Overlays
 {
     public class SettingsToolboxGroup : Container, IExpandable
     {
+        /// <summary>
+        /// The title of this toolbox group.
+        /// </summary>
+        public string Title { get; }
+
         private const float transition_duration = 250;
         private const int container_width = 270;
         private const int border_thickness = 2;
@@ -48,6 +53,8 @@ namespace osu.Game.Overlays
         /// <param name="title">The title to be displayed in the header of this group.</param>
         public SettingsToolboxGroup(string title)
         {
+            Title = title;
+
             AutoSizeAxes = Axes.Y;
             Width = container_width;
             Masking = true;

From 500322ff214753e17a78ca5bb601412ba27e7447 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sun, 23 Jan 2022 06:13:56 +0300
Subject: [PATCH 2899/5547] Update failing snap test scenes

---
 .../Editor/TestSceneObjectObjectSnap.cs                |  7 +++++++
 .../Editor/TestSceneSliderSnapping.cs                  | 10 +++++++++-
 .../TestSceneHitObjectComposerDistanceSnapping.cs      |  1 +
 3 files changed, 17 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneObjectObjectSnap.cs b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneObjectObjectSnap.cs
index 7bdf131e0d..41304dcd24 100644
--- a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneObjectObjectSnap.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneObjectObjectSnap.cs
@@ -3,9 +3,11 @@
 
 using System.Linq;
 using NUnit.Framework;
+using osu.Framework.Bindables;
 using osu.Framework.Testing;
 using osu.Framework.Utils;
 using osu.Game.Beatmaps;
+using osu.Game.Rulesets.Edit;
 using osu.Game.Rulesets.Osu.Objects;
 using osu.Game.Rulesets.Osu.UI;
 using osu.Game.Tests.Beatmaps;
@@ -26,6 +28,11 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
             base.SetUpSteps();
             AddStep("get playfield", () => playfield = Editor.ChildrenOfType<OsuPlayfield>().First());
             AddStep("seek to first control point", () => EditorClock.Seek(Beatmap.Value.Beatmap.ControlPointInfo.TimingPoints.First().Time));
+            AddStep("set distance spacing to 1", () =>
+            {
+                var distanceSpacing = (BindableFloat)Editor.ChildrenOfType<HitObjectComposer>().Single().DistanceSpacingMultiplier;
+                distanceSpacing.Value = 1;
+            });
         }
 
         [TestCase(true)]
diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderSnapping.cs b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderSnapping.cs
index b43b2b1461..23131668a0 100644
--- a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderSnapping.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderSnapping.cs
@@ -3,12 +3,15 @@
 
 using System.Linq;
 using NUnit.Framework;
+using osu.Framework.Allocation;
+using osu.Framework.Bindables;
 using osu.Framework.Input.Events;
 using osu.Framework.Testing;
 using osu.Framework.Utils;
 using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.ControlPoints;
 using osu.Game.Input.Bindings;
+using osu.Game.Rulesets.Edit;
 using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Osu.Edit;
 using osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders.Components;
@@ -61,9 +64,14 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
             }));
             AddStep("set beat divisor to 1/1", () =>
             {
-                var beatDivisor = (BindableBeatDivisor)Editor.Dependencies.Get(typeof(BindableBeatDivisor));
+                var beatDivisor = Editor.Dependencies.Get<BindableBeatDivisor>();
                 beatDivisor.Value = 1;
             });
+            AddStep("set distance spacing to 1", () =>
+            {
+                var distanceSpacing = (BindableFloat)Editor.ChildrenOfType<HitObjectComposer>().Single().DistanceSpacingMultiplier;
+                distanceSpacing.Value = 1;
+            });
         }
 
         [Test]
diff --git a/osu.Game.Tests/Editing/TestSceneHitObjectComposerDistanceSnapping.cs b/osu.Game.Tests/Editing/TestSceneHitObjectComposerDistanceSnapping.cs
index 43f22e4e90..d9312cb7ae 100644
--- a/osu.Game.Tests/Editing/TestSceneHitObjectComposerDistanceSnapping.cs
+++ b/osu.Game.Tests/Editing/TestSceneHitObjectComposerDistanceSnapping.cs
@@ -61,6 +61,7 @@ namespace osu.Game.Tests.Editing
             BeatDivisor.Value = 1;
 
             composer.EditorBeatmap.Difficulty.SliderMultiplier = 1;
+            composer.EditorBeatmap.BeatmapInfo.DistanceSpacing = 1;
             composer.EditorBeatmap.ControlPointInfo.Clear();
             composer.EditorBeatmap.ControlPointInfo.Add(0, new TimingControlPoint { BeatLength = 1000 });
         });

From 868dcd20f56d208d41bdc769f4266b91fd355c84 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 26 Jan 2022 11:39:31 +0300
Subject: [PATCH 2900/5547] Remove `e.ShiftPressed` handling for now

Broken on macOS, will be handled differently later on as discussed.
---
 osu.Game/Rulesets/Edit/HitObjectComposer.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Rulesets/Edit/HitObjectComposer.cs b/osu.Game/Rulesets/Edit/HitObjectComposer.cs
index 6cdc2699aa..948e1d770f 100644
--- a/osu.Game/Rulesets/Edit/HitObjectComposer.cs
+++ b/osu.Game/Rulesets/Edit/HitObjectComposer.cs
@@ -320,7 +320,7 @@ namespace osu.Game.Rulesets.Edit
         {
             if (distanceSpacingScrollActive)
             {
-                distanceSpacing.Value += e.ScrollDelta.Y * (e.ShiftPressed || e.IsPrecise ? 0.01f : 0.1f);
+                distanceSpacing.Value += e.ScrollDelta.Y * (e.IsPrecise ? 0.01f : 0.1f);
                 return true;
             }
 

From cbc8f7ff90e95b0d0b1876ac8f0634ac5575f643 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Tue, 15 Feb 2022 02:29:09 +0300
Subject: [PATCH 2901/5547] Remove test coverage of "shift" hotkey behaviour

---
 osu.Game.Tests/Visual/Editing/TestSceneHitObjectComposer.cs | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneHitObjectComposer.cs b/osu.Game.Tests/Visual/Editing/TestSceneHitObjectComposer.cs
index 7ac511e761..d542732e19 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneHitObjectComposer.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneHitObjectComposer.cs
@@ -101,11 +101,6 @@ namespace osu.Game.Tests.Visual.Editing
             AddStep("scroll mouse 5 steps", () => InputManager.ScrollVerticalBy(5));
             AddAssert("distance spacing increased by 0.5", () => Precision.AlmostEquals(editorBeatmap.BeatmapInfo.DistanceSpacing, originalSpacing + 0.5f));
 
-            AddStep("hold shift", () => InputManager.PressKey(Key.LShift));
-            AddStep("scroll mouse 5 steps", () => InputManager.ScrollVerticalBy(5));
-            AddAssert("distance spacing increased by 0.05", () => Precision.AlmostEquals(editorBeatmap.BeatmapInfo.DistanceSpacing, originalSpacing + 0.55f));
-
-            AddStep("release shift", () => InputManager.ReleaseKey(Key.LShift));
             AddStep("release alt", () => InputManager.ReleaseKey(Key.LAlt));
             AddStep("release D", () => InputManager.ReleaseKey(Key.D));
         }

From f5d0eb41cb1041c999921ada5c271411de00513f Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Tue, 15 Feb 2022 02:42:37 +0300
Subject: [PATCH 2902/5547] Update further `ChangeFocus` usages

---
 osu.Game/Overlays/Login/LoginPanel.cs          | 3 ++-
 osu.Game/Overlays/LoginOverlay.cs              | 2 +-
 osu.Game/Screens/Edit/Setup/MetadataSection.cs | 2 +-
 3 files changed, 4 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Overlays/Login/LoginPanel.cs b/osu.Game/Overlays/Login/LoginPanel.cs
index d1e5bfe809..481abd48ab 100644
--- a/osu.Game/Overlays/Login/LoginPanel.cs
+++ b/osu.Game/Overlays/Login/LoginPanel.cs
@@ -183,7 +183,8 @@ namespace osu.Game.Overlays.Login
                     break;
             }
 
-            if (form != null) GetContainingInputManager()?.ChangeFocus(form);
+            if (form != null)
+                ScheduleAfterChildren(() => GetContainingInputManager()?.ChangeFocus(form));
         });
 
         public override bool AcceptsFocus => true;
diff --git a/osu.Game/Overlays/LoginOverlay.cs b/osu.Game/Overlays/LoginOverlay.cs
index f3562aa6d9..9b2d7ca1ee 100644
--- a/osu.Game/Overlays/LoginOverlay.cs
+++ b/osu.Game/Overlays/LoginOverlay.cs
@@ -78,7 +78,7 @@ namespace osu.Game.Overlays
             panel.Bounding = true;
             this.FadeIn(transition_time, Easing.OutQuint);
 
-            GetContainingInputManager().ChangeFocus(panel);
+            ScheduleAfterChildren(() => GetContainingInputManager().ChangeFocus(panel));
         }
 
         protected override void PopOut()
diff --git a/osu.Game/Screens/Edit/Setup/MetadataSection.cs b/osu.Game/Screens/Edit/Setup/MetadataSection.cs
index f0ca3e1bbc..571dfb3f6f 100644
--- a/osu.Game/Screens/Edit/Setup/MetadataSection.cs
+++ b/osu.Game/Screens/Edit/Setup/MetadataSection.cs
@@ -71,7 +71,7 @@ namespace osu.Game.Screens.Edit.Setup
             base.LoadComplete();
 
             if (string.IsNullOrEmpty(ArtistTextBox.Current.Value))
-                GetContainingInputManager().ChangeFocus(ArtistTextBox);
+                ScheduleAfterChildren(() => GetContainingInputManager().ChangeFocus(ArtistTextBox));
 
             ArtistTextBox.Current.BindValueChanged(artist => transferIfRomanised(artist.NewValue, RomanisedArtistTextBox));
             TitleTextBox.Current.BindValueChanged(title => transferIfRomanised(title.NewValue, RomanisedTitleTextBox));

From 60153bb69df75819e7e2830596884bbab8b04624 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 15 Feb 2022 13:22:14 +0900
Subject: [PATCH 2903/5547] Update nuget packages to highest usable versions

EF packages are intentionally pinned to 5.0.14 as higher versions no
longer support `netstandard2.1`, which we require for xamarin projects.
---
 ...u.Game.Rulesets.EmptyFreeform.Tests.csproj |  2 +-
 .../osu.Game.Rulesets.Pippidon.Tests.csproj   |  2 +-
 ....Game.Rulesets.EmptyScrolling.Tests.csproj |  2 +-
 .../osu.Game.Rulesets.Pippidon.Tests.csproj   |  2 +-
 osu.Desktop/osu.Desktop.csproj                |  9 +++++---
 .../osu.Game.Benchmarks.csproj                |  2 +-
 .../osu.Game.Rulesets.Catch.Tests.csproj      |  2 +-
 .../osu.Game.Rulesets.Mania.Tests.csproj      |  2 +-
 .../osu.Game.Rulesets.Osu.Tests.csproj        |  2 +-
 .../osu.Game.Rulesets.Taiko.Tests.csproj      |  2 +-
 osu.Game.Tests/osu.Game.Tests.csproj          |  2 +-
 .../osu.Game.Tournament.Tests.csproj          |  2 +-
 osu.Game/osu.Game.csproj                      | 22 +++++++++----------
 13 files changed, 28 insertions(+), 25 deletions(-)

diff --git a/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform.Tests/osu.Game.Rulesets.EmptyFreeform.Tests.csproj b/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform.Tests/osu.Game.Rulesets.EmptyFreeform.Tests.csproj
index cb922c5a58..c305872288 100644
--- a/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform.Tests/osu.Game.Rulesets.EmptyFreeform.Tests.csproj
+++ b/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform.Tests/osu.Game.Rulesets.EmptyFreeform.Tests.csproj
@@ -12,7 +12,7 @@
     <PackageReference Include="Appveyor.TestLogger" Version="2.0.0" />
     <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.0.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
-    <PackageReference Include="NUnit3TestAdapter" Version="4.1.0" />
+    <PackageReference Include="NUnit3TestAdapter" Version="4.2.1" />
     <PackageReference Update="Microsoft.EntityFrameworkCore.Sqlite" Version="2.1.4" />
   </ItemGroup>
   <ItemGroup>
diff --git a/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon.Tests/osu.Game.Rulesets.Pippidon.Tests.csproj b/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon.Tests/osu.Game.Rulesets.Pippidon.Tests.csproj
index 5ecd9cc675..ec90885cd9 100644
--- a/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon.Tests/osu.Game.Rulesets.Pippidon.Tests.csproj
+++ b/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon.Tests/osu.Game.Rulesets.Pippidon.Tests.csproj
@@ -12,7 +12,7 @@
     <PackageReference Include="Appveyor.TestLogger" Version="2.0.0" />
     <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.0.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
-    <PackageReference Include="NUnit3TestAdapter" Version="4.1.0" />
+    <PackageReference Include="NUnit3TestAdapter" Version="4.2.1" />
     <PackageReference Update="Microsoft.EntityFrameworkCore.Sqlite" Version="2.1.4" />
   </ItemGroup>
   <ItemGroup>
diff --git a/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling.Tests/osu.Game.Rulesets.EmptyScrolling.Tests.csproj b/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling.Tests/osu.Game.Rulesets.EmptyScrolling.Tests.csproj
index 33ad0ac4f7..f2e143a9c5 100644
--- a/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling.Tests/osu.Game.Rulesets.EmptyScrolling.Tests.csproj
+++ b/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling.Tests/osu.Game.Rulesets.EmptyScrolling.Tests.csproj
@@ -12,7 +12,7 @@
     <PackageReference Include="Appveyor.TestLogger" Version="2.0.0" />
     <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.0.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
-    <PackageReference Include="NUnit3TestAdapter" Version="4.1.0" />
+    <PackageReference Include="NUnit3TestAdapter" Version="4.2.1" />
     <PackageReference Update="Microsoft.EntityFrameworkCore.Sqlite" Version="2.1.4" />
   </ItemGroup>
   <ItemGroup>
diff --git a/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon.Tests/osu.Game.Rulesets.Pippidon.Tests.csproj b/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon.Tests/osu.Game.Rulesets.Pippidon.Tests.csproj
index 5ecd9cc675..ec90885cd9 100644
--- a/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon.Tests/osu.Game.Rulesets.Pippidon.Tests.csproj
+++ b/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon.Tests/osu.Game.Rulesets.Pippidon.Tests.csproj
@@ -12,7 +12,7 @@
     <PackageReference Include="Appveyor.TestLogger" Version="2.0.0" />
     <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.0.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
-    <PackageReference Include="NUnit3TestAdapter" Version="4.1.0" />
+    <PackageReference Include="NUnit3TestAdapter" Version="4.2.1" />
     <PackageReference Update="Microsoft.EntityFrameworkCore.Sqlite" Version="2.1.4" />
   </ItemGroup>
   <ItemGroup>
diff --git a/osu.Desktop/osu.Desktop.csproj b/osu.Desktop/osu.Desktop.csproj
index 5e203af1f2..b1117bf796 100644
--- a/osu.Desktop/osu.Desktop.csproj
+++ b/osu.Desktop/osu.Desktop.csproj
@@ -26,10 +26,13 @@
   <ItemGroup Label="Package References">
     <PackageReference Include="Microsoft.NETCore.Targets" Version="5.0.0" />
     <PackageReference Include="Mono.Posix.NETStandard" Version="1.0.0" />
-    <PackageReference Include="System.IO.Packaging" Version="5.0.0" />
+    <PackageReference Include="System.IO.Packaging" Version="6.0.0" />
     <PackageReference Include="ppy.squirrel.windows" Version="1.9.0.5" />
-    <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="2.2.6" />
-    <PackageReference Include="Microsoft.EntityFrameworkCore.Design" Version="2.2.6" />
+    <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="5.0.14" />
+    <PackageReference Include="Microsoft.EntityFrameworkCore.Design" Version="5.0.14">
+      <PrivateAssets>all</PrivateAssets>
+      <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
+    </PackageReference>
     <PackageReference Include="Microsoft.Win32.Registry" Version="5.0.0" />
     <PackageReference Include="DiscordRichPresence" Version="1.0.175" />
   </ItemGroup>
diff --git a/osu.Game.Benchmarks/osu.Game.Benchmarks.csproj b/osu.Game.Benchmarks/osu.Game.Benchmarks.csproj
index 434c0e0367..2bdb6a650c 100644
--- a/osu.Game.Benchmarks/osu.Game.Benchmarks.csproj
+++ b/osu.Game.Benchmarks/osu.Game.Benchmarks.csproj
@@ -9,7 +9,7 @@
   <ItemGroup>
     <PackageReference Include="BenchmarkDotNet" Version="0.13.1" />
     <PackageReference Include="nunit" Version="3.13.2" />
-    <PackageReference Include="NUnit3TestAdapter" Version="4.1.0" />
+    <PackageReference Include="NUnit3TestAdapter" Version="4.2.1" />
   </ItemGroup>
 
   <ItemGroup>
diff --git a/osu.Game.Rulesets.Catch.Tests/osu.Game.Rulesets.Catch.Tests.csproj b/osu.Game.Rulesets.Catch.Tests/osu.Game.Rulesets.Catch.Tests.csproj
index fc6d900567..a6c614f22f 100644
--- a/osu.Game.Rulesets.Catch.Tests/osu.Game.Rulesets.Catch.Tests.csproj
+++ b/osu.Game.Rulesets.Catch.Tests/osu.Game.Rulesets.Catch.Tests.csproj
@@ -4,7 +4,7 @@
     <PackageReference Include="Appveyor.TestLogger" Version="2.0.0" />
     <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.0.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
-    <PackageReference Include="NUnit3TestAdapter" Version="4.1.0" />
+    <PackageReference Include="NUnit3TestAdapter" Version="4.2.1" />
     <PackageReference Update="Microsoft.EntityFrameworkCore.Sqlite" Version="2.1.4" />
   </ItemGroup>
   <PropertyGroup Label="Project">
diff --git a/osu.Game.Rulesets.Mania.Tests/osu.Game.Rulesets.Mania.Tests.csproj b/osu.Game.Rulesets.Mania.Tests/osu.Game.Rulesets.Mania.Tests.csproj
index ddad2adfea..ff49d6d4dd 100644
--- a/osu.Game.Rulesets.Mania.Tests/osu.Game.Rulesets.Mania.Tests.csproj
+++ b/osu.Game.Rulesets.Mania.Tests/osu.Game.Rulesets.Mania.Tests.csproj
@@ -4,7 +4,7 @@
     <PackageReference Include="Appveyor.TestLogger" Version="2.0.0" />
     <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.0.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
-    <PackageReference Include="NUnit3TestAdapter" Version="4.1.0" />
+    <PackageReference Include="NUnit3TestAdapter" Version="4.2.1" />
     <PackageReference Update="Microsoft.EntityFrameworkCore.Sqlite" Version="2.1.4" />
   </ItemGroup>
   <PropertyGroup Label="Project">
diff --git a/osu.Game.Rulesets.Osu.Tests/osu.Game.Rulesets.Osu.Tests.csproj b/osu.Game.Rulesets.Osu.Tests/osu.Game.Rulesets.Osu.Tests.csproj
index bd4c3d3345..a2e54f5cdc 100644
--- a/osu.Game.Rulesets.Osu.Tests/osu.Game.Rulesets.Osu.Tests.csproj
+++ b/osu.Game.Rulesets.Osu.Tests/osu.Game.Rulesets.Osu.Tests.csproj
@@ -5,7 +5,7 @@
     <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.0.0" />
     <PackageReference Include="Moq" Version="4.16.1" />
     <PackageReference Include="NUnit" Version="3.13.2" />
-    <PackageReference Include="NUnit3TestAdapter" Version="4.1.0" />
+    <PackageReference Include="NUnit3TestAdapter" Version="4.2.1" />
     <PackageReference Update="Microsoft.EntityFrameworkCore.Sqlite" Version="2.1.4" />
   </ItemGroup>
   <PropertyGroup Label="Project">
diff --git a/osu.Game.Rulesets.Taiko.Tests/osu.Game.Rulesets.Taiko.Tests.csproj b/osu.Game.Rulesets.Taiko.Tests/osu.Game.Rulesets.Taiko.Tests.csproj
index a6b8eb8651..debddae037 100644
--- a/osu.Game.Rulesets.Taiko.Tests/osu.Game.Rulesets.Taiko.Tests.csproj
+++ b/osu.Game.Rulesets.Taiko.Tests/osu.Game.Rulesets.Taiko.Tests.csproj
@@ -4,7 +4,7 @@
     <PackageReference Include="Appveyor.TestLogger" Version="2.0.0" />
     <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.0.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
-    <PackageReference Include="NUnit3TestAdapter" Version="4.1.0" />
+    <PackageReference Include="NUnit3TestAdapter" Version="4.2.1" />
     <PackageReference Update="Microsoft.EntityFrameworkCore.Sqlite" Version="2.1.4" />
   </ItemGroup>
   <PropertyGroup Label="Project">
diff --git a/osu.Game.Tests/osu.Game.Tests.csproj b/osu.Game.Tests/osu.Game.Tests.csproj
index acf1e8470b..40969c8b29 100644
--- a/osu.Game.Tests/osu.Game.Tests.csproj
+++ b/osu.Game.Tests/osu.Game.Tests.csproj
@@ -6,7 +6,7 @@
     <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.0.0" />
     <PackageReference Include="Nito.AsyncEx" Version="5.1.2" />
     <PackageReference Include="NUnit" Version="3.13.2" />
-    <PackageReference Include="NUnit3TestAdapter" Version="4.1.0" />
+    <PackageReference Include="NUnit3TestAdapter" Version="4.2.1" />
     <PackageReference Update="Microsoft.EntityFrameworkCore.Sqlite" Version="2.1.4" />
     <PackageReference Include="Moq" Version="4.16.1" />
   </ItemGroup>
diff --git a/osu.Game.Tournament.Tests/osu.Game.Tournament.Tests.csproj b/osu.Game.Tournament.Tests/osu.Game.Tournament.Tests.csproj
index c7314a4969..9fd73f2c1b 100644
--- a/osu.Game.Tournament.Tests/osu.Game.Tournament.Tests.csproj
+++ b/osu.Game.Tournament.Tests/osu.Game.Tournament.Tests.csproj
@@ -7,7 +7,7 @@
     <PackageReference Include="Appveyor.TestLogger" Version="2.0.0" />
     <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.0.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
-    <PackageReference Include="NUnit3TestAdapter" Version="4.1.0" />
+    <PackageReference Include="NUnit3TestAdapter" Version="4.2.1" />
   </ItemGroup>
   <PropertyGroup Label="Project">
     <OutputType>WinExe</OutputType>
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 847832f8ac..7b50c804ff 100644
--- a/osu.Game/osu.Game.csproj
+++ b/osu.Game/osu.Game.csproj
@@ -18,27 +18,27 @@
     </None>
   </ItemGroup>
   <ItemGroup Label="Package References">
-    <PackageReference Include="AutoMapper" Version="11.0.0" />
+    <PackageReference Include="AutoMapper" Version="11.0.1" />
     <PackageReference Include="DiffPlex" Version="1.7.0" />
-    <PackageReference Include="HtmlAgilityPack" Version="1.11.40" />
-    <PackageReference Include="Humanizer" Version="2.13.14" />
+    <PackageReference Include="HtmlAgilityPack" Version="1.11.42" />
+    <PackageReference Include="Humanizer" Version="2.14.1" />
     <PackageReference Include="MessagePack" Version="2.3.85" />
-    <PackageReference Include="Microsoft.AspNetCore.SignalR.Client" Version="5.0.11" />
-    <PackageReference Include="Microsoft.AspNetCore.SignalR.Protocols.MessagePack" Version="5.0.11" />
-    <PackageReference Include="Microsoft.AspNetCore.SignalR.Protocols.NewtonsoftJson" Version="5.0.11" />
-    <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="2.2.6" />
-    <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.Core" Version="2.2.6" />
-    <PackageReference Include="Microsoft.Extensions.Configuration.Abstractions" Version="5.0.0" />
+    <PackageReference Include="Microsoft.AspNetCore.SignalR.Client" Version="6.0.2" />
+    <PackageReference Include="Microsoft.AspNetCore.SignalR.Protocols.MessagePack" Version="6.0.2" />
+    <PackageReference Include="Microsoft.AspNetCore.SignalR.Protocols.NewtonsoftJson" Version="6.0.2" />
+    <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="5.0.14" />
+    <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.Core" Version="5.0.14" />
+    <PackageReference Include="Microsoft.Extensions.Configuration.Abstractions" Version="6.0.0" />
     <PackageReference Include="Microsoft.NETCore.Targets" Version="3.1.0" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
     <PackageReference Include="ppy.LocalisationAnalyser" Version="2021.1210.0">
       <PrivateAssets>all</PrivateAssets>
       <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
     </PackageReference>
-    <PackageReference Include="Realm" Version="10.8.0" />
+    <PackageReference Include="Realm" Version="10.9.0" />
     <PackageReference Include="ppy.osu.Framework" Version="2022.214.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.211.0" />
-    <PackageReference Include="Sentry" Version="3.13.0" />
+    <PackageReference Include="Sentry" Version="3.14.0" />
     <PackageReference Include="SharpCompress" Version="0.30.1" />
     <PackageReference Include="NUnit" Version="3.13.2" />
     <PackageReference Include="System.ComponentModel.Annotations" Version="5.0.0" />

From 28b45fa8999ba897fa93c0f4a4a5fc1e3700a71e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 15 Feb 2022 13:40:58 +0900
Subject: [PATCH 2904/5547] Add assertions against null reference for
 connection usages

---
 .../Multiplayer/OnlineMultiplayerClient.cs    | 29 +++++++++++++++++++
 .../Online/Spectator/OnlineSpectatorClient.cs | 11 +++++++
 2 files changed, 40 insertions(+)

diff --git a/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs b/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs
index 3794bec228..ad898759ff 100644
--- a/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs
@@ -4,6 +4,7 @@
 #nullable enable
 
 using System.Collections.Generic;
+using System.Diagnostics;
 using System.Threading;
 using System.Threading.Tasks;
 using Microsoft.AspNetCore.SignalR.Client;
@@ -79,6 +80,8 @@ namespace osu.Game.Online.Multiplayer
             if (!IsConnected.Value)
                 return Task.FromCanceled<MultiplayerRoom>(new CancellationToken(true));
 
+            Debug.Assert(connection != null);
+
             return connection.InvokeAsync<MultiplayerRoom>(nameof(IMultiplayerServer.JoinRoomWithPassword), roomId, password ?? string.Empty);
         }
 
@@ -87,6 +90,8 @@ namespace osu.Game.Online.Multiplayer
             if (!IsConnected.Value)
                 return Task.FromCanceled(new CancellationToken(true));
 
+            Debug.Assert(connection != null);
+
             return connection.InvokeAsync(nameof(IMultiplayerServer.LeaveRoom));
         }
 
@@ -95,6 +100,8 @@ namespace osu.Game.Online.Multiplayer
             if (!IsConnected.Value)
                 return Task.CompletedTask;
 
+            Debug.Assert(connection != null);
+
             return connection.InvokeAsync(nameof(IMultiplayerServer.TransferHost), userId);
         }
 
@@ -103,6 +110,8 @@ namespace osu.Game.Online.Multiplayer
             if (!IsConnected.Value)
                 return Task.CompletedTask;
 
+            Debug.Assert(connection != null);
+
             return connection.InvokeAsync(nameof(IMultiplayerServer.KickUser), userId);
         }
 
@@ -111,6 +120,8 @@ namespace osu.Game.Online.Multiplayer
             if (!IsConnected.Value)
                 return Task.CompletedTask;
 
+            Debug.Assert(connection != null);
+
             return connection.InvokeAsync(nameof(IMultiplayerServer.ChangeSettings), settings);
         }
 
@@ -119,6 +130,8 @@ namespace osu.Game.Online.Multiplayer
             if (!IsConnected.Value)
                 return Task.CompletedTask;
 
+            Debug.Assert(connection != null);
+
             return connection.InvokeAsync(nameof(IMultiplayerServer.ChangeState), newState);
         }
 
@@ -127,6 +140,8 @@ namespace osu.Game.Online.Multiplayer
             if (!IsConnected.Value)
                 return Task.CompletedTask;
 
+            Debug.Assert(connection != null);
+
             return connection.InvokeAsync(nameof(IMultiplayerServer.ChangeBeatmapAvailability), newBeatmapAvailability);
         }
 
@@ -135,6 +150,8 @@ namespace osu.Game.Online.Multiplayer
             if (!IsConnected.Value)
                 return Task.CompletedTask;
 
+            Debug.Assert(connection != null);
+
             return connection.InvokeAsync(nameof(IMultiplayerServer.ChangeUserMods), newMods);
         }
 
@@ -143,6 +160,8 @@ namespace osu.Game.Online.Multiplayer
             if (!IsConnected.Value)
                 return Task.CompletedTask;
 
+            Debug.Assert(connection != null);
+
             return connection.InvokeAsync(nameof(IMultiplayerServer.SendMatchRequest), request);
         }
 
@@ -151,6 +170,8 @@ namespace osu.Game.Online.Multiplayer
             if (!IsConnected.Value)
                 return Task.CompletedTask;
 
+            Debug.Assert(connection != null);
+
             return connection.InvokeAsync(nameof(IMultiplayerServer.StartMatch));
         }
 
@@ -159,6 +180,8 @@ namespace osu.Game.Online.Multiplayer
             if (!IsConnected.Value)
                 return Task.CompletedTask;
 
+            Debug.Assert(connection != null);
+
             return connection.InvokeAsync(nameof(IMultiplayerServer.AbortGameplay));
         }
 
@@ -167,6 +190,8 @@ namespace osu.Game.Online.Multiplayer
             if (!IsConnected.Value)
                 return Task.CompletedTask;
 
+            Debug.Assert(connection != null);
+
             return connection.InvokeAsync(nameof(IMultiplayerServer.AddPlaylistItem), item);
         }
 
@@ -175,6 +200,8 @@ namespace osu.Game.Online.Multiplayer
             if (!IsConnected.Value)
                 return Task.CompletedTask;
 
+            Debug.Assert(connection != null);
+
             return connection.InvokeAsync(nameof(IMultiplayerServer.EditPlaylistItem), item);
         }
 
@@ -183,6 +210,8 @@ namespace osu.Game.Online.Multiplayer
             if (!IsConnected.Value)
                 return Task.CompletedTask;
 
+            Debug.Assert(connection != null);
+
             return connection.InvokeAsync(nameof(IMultiplayerServer.RemovePlaylistItem), playlistItemId);
         }
 
diff --git a/osu.Game/Online/Spectator/OnlineSpectatorClient.cs b/osu.Game/Online/Spectator/OnlineSpectatorClient.cs
index 753796158e..ddde69c627 100644
--- a/osu.Game/Online/Spectator/OnlineSpectatorClient.cs
+++ b/osu.Game/Online/Spectator/OnlineSpectatorClient.cs
@@ -3,6 +3,7 @@
 
 #nullable enable
 
+using System.Diagnostics;
 using System.Threading.Tasks;
 using Microsoft.AspNetCore.SignalR.Client;
 using osu.Framework.Allocation;
@@ -51,6 +52,8 @@ namespace osu.Game.Online.Spectator
             if (!IsConnected.Value)
                 return Task.CompletedTask;
 
+            Debug.Assert(connection != null);
+
             return connection.SendAsync(nameof(ISpectatorServer.BeginPlaySession), state);
         }
 
@@ -59,6 +62,8 @@ namespace osu.Game.Online.Spectator
             if (!IsConnected.Value)
                 return Task.CompletedTask;
 
+            Debug.Assert(connection != null);
+
             return connection.SendAsync(nameof(ISpectatorServer.SendFrameData), data);
         }
 
@@ -67,6 +72,8 @@ namespace osu.Game.Online.Spectator
             if (!IsConnected.Value)
                 return Task.CompletedTask;
 
+            Debug.Assert(connection != null);
+
             return connection.SendAsync(nameof(ISpectatorServer.EndPlaySession), state);
         }
 
@@ -75,6 +82,8 @@ namespace osu.Game.Online.Spectator
             if (!IsConnected.Value)
                 return Task.CompletedTask;
 
+            Debug.Assert(connection != null);
+
             return connection.SendAsync(nameof(ISpectatorServer.StartWatchingUser), userId);
         }
 
@@ -83,6 +92,8 @@ namespace osu.Game.Online.Spectator
             if (!IsConnected.Value)
                 return Task.CompletedTask;
 
+            Debug.Assert(connection != null);
+
             return connection.SendAsync(nameof(ISpectatorServer.EndWatchingUser), userId);
         }
     }

From 8ec28dc8bcc1ab691af17e3124b046a6a27a1037 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 15 Feb 2022 13:41:10 +0900
Subject: [PATCH 2905/5547] Update `OsuDbContext` in line with EF changes

---
 osu.Game/Database/OsuDbContext.cs | 9 ++++-----
 1 file changed, 4 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Database/OsuDbContext.cs b/osu.Game/Database/OsuDbContext.cs
index 441b090a6e..79183b6f0e 100644
--- a/osu.Game/Database/OsuDbContext.cs
+++ b/osu.Game/Database/OsuDbContext.cs
@@ -3,7 +3,6 @@
 
 using System;
 using Microsoft.EntityFrameworkCore;
-using Microsoft.EntityFrameworkCore.Diagnostics;
 using Microsoft.Extensions.Logging;
 using osu.Framework.Logging;
 using osu.Framework.Statistics;
@@ -12,8 +11,9 @@ using osu.Game.Configuration;
 using osu.Game.IO;
 using osu.Game.Rulesets;
 using osu.Game.Scoring;
-using LogLevel = Microsoft.Extensions.Logging.LogLevel;
 using osu.Game.Skinning;
+using SQLitePCL;
+using LogLevel = Microsoft.Extensions.Logging.LogLevel;
 
 namespace osu.Game.Database
 {
@@ -40,10 +40,10 @@ namespace osu.Game.Database
         static OsuDbContext()
         {
             // required to initialise native SQLite libraries on some platforms.
-            SQLitePCL.Batteries_V2.Init();
+            Batteries_V2.Init();
 
             // https://github.com/aspnet/EntityFrameworkCore/issues/9994#issuecomment-508588678
-            SQLitePCL.raw.sqlite3_config(2 /*SQLITE_CONFIG_MULTITHREAD*/);
+            raw.sqlite3_config(2 /*SQLITE_CONFIG_MULTITHREAD*/);
         }
 
         /// <summary>
@@ -116,7 +116,6 @@ namespace osu.Game.Database
             optionsBuilder
                 // this is required for the time being due to the way we are querying in places like BeatmapStore.
                 // if we ever move to having consumers file their own .Includes, or get eager loading support, this could be re-enabled.
-                .ConfigureWarnings(warnings => warnings.Ignore(CoreEventId.IncludeIgnoredWarning))
                 .UseSqlite(connectionString, sqliteOptions => sqliteOptions.CommandTimeout(10))
                 .UseLoggerFactory(logger.Value);
         }

From 334fe1f1203ac02f507132bd1d64f00139dfb81d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 15 Feb 2022 15:23:14 +0900
Subject: [PATCH 2906/5547] Add `AsSplitQuery` specification to avoid
 optimisation recommendation log messages

---
 osu.Game/Database/EFToRealmMigrator.cs | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Database/EFToRealmMigrator.cs b/osu.Game/Database/EFToRealmMigrator.cs
index 0bb5388d55..c9deee19fe 100644
--- a/osu.Game/Database/EFToRealmMigrator.cs
+++ b/osu.Game/Database/EFToRealmMigrator.cs
@@ -215,7 +215,8 @@ namespace osu.Game.Database
                                         .Include(s => s.Beatmaps).ThenInclude(b => b.Metadata)
                                         .Include(s => s.Beatmaps).ThenInclude(b => b.BaseDifficulty)
                                         .Include(s => s.Files).ThenInclude(f => f.FileInfo)
-                                        .Include(s => s.Metadata);
+                                        .Include(s => s.Metadata)
+                                        .AsSplitQuery();
 
             log("Beginning beatmaps migration to realm");
 
@@ -344,7 +345,8 @@ namespace osu.Game.Database
                                    .Include(s => s.Ruleset)
                                    .Include(s => s.BeatmapInfo)
                                    .Include(s => s.Files)
-                                   .ThenInclude(f => f.FileInfo);
+                                   .ThenInclude(f => f.FileInfo)
+                                   .AsSplitQuery();
 
             log("Beginning scores migration to realm");
 
@@ -434,6 +436,7 @@ namespace osu.Game.Database
             var existingSkins = db.SkinInfo
                                   .Include(s => s.Files)
                                   .ThenInclude(f => f.FileInfo)
+                                  .AsSplitQuery()
                                   .ToList();
 
             // previous entries in EF are removed post migration.

From 2c3e50a450359d76c95fc4628b391733dc354f4c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 15 Feb 2022 15:46:25 +0900
Subject: [PATCH 2907/5547] Update package references in xamarin `props` files

---
 osu.Android.props |  2 +-
 osu.iOS.props     | 12 ++++++------
 2 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/osu.Android.props b/osu.Android.props
index 6b3142fbdc..eab2be1b72 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -56,6 +56,6 @@
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
     <!-- Realm needs to be directly referenced in all Xamarin projects, as it will not pull in its transitive dependencies otherwise. -->
-    <PackageReference Include="Realm" Version="10.8.0" />
+    <PackageReference Include="Realm" Version="10.9.0" />
   </ItemGroup>
 </Project>
diff --git a/osu.iOS.props b/osu.iOS.props
index 00c9653146..03a105673c 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -79,15 +79,15 @@
   <!-- Xamarin.iOS does not automatically handle transitive dependencies from NuGet packages. -->
   <ItemGroup Label="Transitive Dependencies">
     <PackageReference Include="DiffPlex" Version="1.7.0" />
-    <PackageReference Include="Humanizer" Version="2.13.14" />
-    <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="2.2.6" />
-    <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.Core" Version="2.2.6" />
+    <PackageReference Include="Humanizer" Version="2.14.1" />
+    <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="5.0.14" />
+    <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.Core" Version="5.0.14" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
     <PackageReference Include="ppy.osu.Framework" Version="2022.214.0" />
-    <PackageReference Include="SharpCompress" Version="0.30.0" />
+    <PackageReference Include="SharpCompress" Version="0.30.1" />
     <PackageReference Include="NUnit" Version="3.13.2" />
     <PackageReference Include="System.ComponentModel.Annotations" Version="5.0.0" />
-    <PackageReference Include="ppy.osu.Framework.NativeLibs" Version="2021.805.0" ExcludeAssets="all" />
-    <PackageReference Include="Realm" Version="10.8.0" />
+    <PackageReference Include="ppy.osu.Framework.NativeLibs" Version="2021.1221.0" ExcludeAssets="all" />
+    <PackageReference Include="Realm" Version="10.9.0" />
   </ItemGroup>
 </Project>

From efeba30b9fe0976fd99c89841029323f88c2f243 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 15 Feb 2022 16:01:14 +0900
Subject: [PATCH 2908/5547] Remove ruleset and mod bindables from PlaylistItem

---
 ...eneOnlinePlayBeatmapAvailabilityTracker.cs |  2 +-
 .../Visual/Multiplayer/QueueModeTestScene.cs  |  2 +-
 .../TestSceneDrawableRoomPlaylist.cs          | 41 +++++++-------
 .../TestSceneMatchBeatmapDetailArea.cs        | 11 ++--
 .../Multiplayer/TestSceneMultiplayer.cs       | 49 ++++++++--------
 .../TestSceneMultiplayerMatchSubScreen.cs     | 11 ++--
 .../Multiplayer/TestSceneMultiplayerPlayer.cs |  2 +-
 .../TestSceneMultiplayerPlaylist.cs           |  4 +-
 .../TestSceneMultiplayerReadyButton.cs        |  2 +-
 .../TestSceneMultiplayerSpectateButton.cs     |  2 +-
 .../TestScenePlaylistsRoomSettingsPlaylist.cs | 11 ++--
 .../TestScenePlaylistsSongSelect.cs           | 19 ++++++-
 .../Visual/Multiplayer/TestSceneTeamVersus.cs |  8 +--
 .../TestScenePlaylistsResultsScreen.cs        |  2 +-
 .../TestScenePlaylistsRoomCreation.cs         |  8 +--
 .../Online/Multiplayer/MultiplayerClient.cs   | 34 ++++-------
 .../Online/Rooms/MultiplayerPlaylistItem.cs   |  4 +-
 osu.Game/Online/Rooms/MultiplayerScore.cs     |  6 +-
 osu.Game/Online/Rooms/PlaylistItem.cs         | 56 ++-----------------
 .../OnlinePlay/Components/ModeTypeInfo.cs     | 11 +++-
 .../OnlinePlay/Components/RoomManager.cs      |  6 +-
 .../OnlinePlay/DrawableRoomPlaylistItem.cs    | 19 ++++---
 .../Lounge/Components/RoomsContainer.cs       |  3 +-
 .../Screens/OnlinePlay/Match/RoomSubScreen.cs |  4 +-
 .../Multiplayer/MultiplayerMatchSongSelect.cs |  5 +-
 .../Multiplayer/MultiplayerMatchSubScreen.cs  |  2 +-
 .../OnlinePlay/OnlinePlaySongSelect.cs        | 27 +++++----
 .../OnlinePlay/Playlists/PlaylistsPlayer.cs   |  6 +-
 .../Playlists/PlaylistsSongSelect.cs          | 24 +++-----
 .../Multiplayer/MultiplayerTestScene.cs       |  2 +-
 .../Visual/OnlinePlay/TestRoomManager.cs      |  2 +-
 31 files changed, 178 insertions(+), 207 deletions(-)

diff --git a/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs b/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
index 343fc7e6e0..9aa04dda92 100644
--- a/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
+++ b/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
@@ -66,7 +66,7 @@ namespace osu.Game.Tests.Online
             selectedItem.Value = new PlaylistItem
             {
                 Beatmap = { Value = testBeatmapInfo },
-                Ruleset = { Value = testBeatmapInfo.Ruleset },
+                RulesetID = testBeatmapInfo.Ruleset.OnlineID,
             };
 
             Child = availabilityTracker = new OnlinePlayBeatmapAvailabilityTracker
diff --git a/osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs b/osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs
index c79395b343..36d6c6a306 100644
--- a/osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs
@@ -78,7 +78,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     new PlaylistItem
                     {
                         Beatmap = { Value = InitialBeatmap },
-                        Ruleset = { Value = new OsuRuleset().RulesetInfo },
+                        RulesetID = new OsuRuleset().RulesetInfo.OnlineID
                     }
                 }
             }));
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
index 5c8c90e166..659cc22350 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
@@ -17,6 +17,7 @@ using osu.Game.Beatmaps.Drawables;
 using osu.Game.Database;
 using osu.Game.Graphics.Containers;
 using osu.Game.Models;
+using osu.Game.Online.API;
 using osu.Game.Online.Rooms;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Osu;
@@ -215,25 +216,25 @@ namespace osu.Game.Tests.Visual.Multiplayer
                         {
                             ID = 0,
                             Beatmap = { Value = new TestBeatmap(new OsuRuleset().RulesetInfo).BeatmapInfo },
-                            Ruleset = { Value = new OsuRuleset().RulesetInfo },
+                            RulesetID = new OsuRuleset().RulesetInfo.OnlineID,
                             Expired = true,
-                            RequiredMods =
+                            RequiredMods = new[]
                             {
-                                new OsuModHardRock(),
-                                new OsuModDoubleTime(),
-                                new OsuModAutoplay()
+                                new APIMod(new OsuModHardRock()),
+                                new APIMod(new OsuModDoubleTime()),
+                                new APIMod(new OsuModAutoplay())
                             }
                         },
                         new PlaylistItem
                         {
                             ID = 1,
                             Beatmap = { Value = new TestBeatmap(new OsuRuleset().RulesetInfo).BeatmapInfo },
-                            Ruleset = { Value = new OsuRuleset().RulesetInfo },
-                            RequiredMods =
+                            RulesetID = new OsuRuleset().RulesetInfo.OnlineID,
+                            RequiredMods = new[]
                             {
-                                new OsuModHardRock(),
-                                new OsuModDoubleTime(),
-                                new OsuModAutoplay()
+                                new APIMod(new OsuModHardRock()),
+                                new APIMod(new OsuModDoubleTime()),
+                                new APIMod(new OsuModAutoplay())
                             }
                         }
                     }
@@ -314,12 +315,12 @@ namespace osu.Game.Tests.Visual.Multiplayer
                                     BeatmapSet = new BeatmapSetInfo()
                                 }
                         },
-                        Ruleset = { Value = new OsuRuleset().RulesetInfo },
-                        RequiredMods =
+                        RulesetID = new OsuRuleset().RulesetInfo.OnlineID,
+                        RequiredMods = new[]
                         {
-                            new OsuModHardRock(),
-                            new OsuModDoubleTime(),
-                            new OsuModAutoplay()
+                            new APIMod(new OsuModHardRock()),
+                            new APIMod(new OsuModDoubleTime()),
+                            new APIMod(new OsuModAutoplay())
                         }
                     });
                 }
@@ -348,12 +349,12 @@ namespace osu.Game.Tests.Visual.Multiplayer
                         ID = index++,
                         OwnerID = 2,
                         Beatmap = { Value = b },
-                        Ruleset = { Value = new OsuRuleset().RulesetInfo },
-                        RequiredMods =
+                        RulesetID = new OsuRuleset().RulesetInfo.OnlineID,
+                        RequiredMods = new[]
                         {
-                            new OsuModHardRock(),
-                            new OsuModDoubleTime(),
-                            new OsuModAutoplay()
+                            new APIMod(new OsuModHardRock()),
+                            new APIMod(new OsuModDoubleTime()),
+                            new APIMod(new OsuModAutoplay())
                         }
                     });
                 }
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchBeatmapDetailArea.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchBeatmapDetailArea.cs
index 1d61a5d496..6144824ba0 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchBeatmapDetailArea.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchBeatmapDetailArea.cs
@@ -3,6 +3,7 @@
 
 using NUnit.Framework;
 using osu.Framework.Graphics;
+using osu.Game.Online.API;
 using osu.Game.Online.Rooms;
 using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Osu.Mods;
@@ -35,12 +36,12 @@ namespace osu.Game.Tests.Visual.Multiplayer
             {
                 ID = SelectedRoom.Value.Playlist.Count,
                 Beatmap = { Value = new TestBeatmap(new OsuRuleset().RulesetInfo).BeatmapInfo },
-                Ruleset = { Value = new OsuRuleset().RulesetInfo },
-                RequiredMods =
+                RulesetID = new OsuRuleset().RulesetInfo.OnlineID,
+                RequiredMods = new[]
                 {
-                    new OsuModHardRock(),
-                    new OsuModDoubleTime(),
-                    new OsuModAutoplay()
+                    new APIMod(new OsuModHardRock()),
+                    new APIMod(new OsuModDoubleTime()),
+                    new APIMod(new OsuModAutoplay())
                 }
             });
         }
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
index 8f6ba6375f..41715f6cfb 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
@@ -19,6 +19,7 @@ using osu.Framework.Utils;
 using osu.Game.Beatmaps;
 using osu.Game.Database;
 using osu.Game.Graphics.UserInterface;
+using osu.Game.Online.API;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Rooms;
@@ -99,7 +100,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     new PlaylistItem
                     {
                         Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo },
-                        Ruleset = { Value = new OsuRuleset().RulesetInfo },
+                        RulesetID = new OsuRuleset().RulesetInfo.OnlineID
                     }
                 }
             });
@@ -235,7 +236,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     new PlaylistItem
                     {
                         Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo },
-                        Ruleset = { Value = new OsuRuleset().RulesetInfo },
+                        RulesetID = new OsuRuleset().RulesetInfo.OnlineID
                     }
                 }
             });
@@ -257,7 +258,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                         new PlaylistItem
                         {
                             Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo },
-                            Ruleset = { Value = new OsuRuleset().RulesetInfo },
+                            RulesetID = new OsuRuleset().RulesetInfo.OnlineID
                         }
                     }
                 }, API.LocalUser.Value);
@@ -287,7 +288,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                         new PlaylistItem
                         {
                             Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo },
-                            Ruleset = { Value = new OsuRuleset().RulesetInfo },
+                            RulesetID = new OsuRuleset().RulesetInfo.OnlineID
                         }
                     }
                 }, API.LocalUser.Value);
@@ -318,7 +319,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     new PlaylistItem
                     {
                         Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo },
-                        Ruleset = { Value = new OsuRuleset().RulesetInfo },
+                        RulesetID = new OsuRuleset().RulesetInfo.OnlineID
                     }
                 }
             });
@@ -340,7 +341,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                         new PlaylistItem
                         {
                             Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo },
-                            Ruleset = { Value = new OsuRuleset().RulesetInfo },
+                            RulesetID = new OsuRuleset().RulesetInfo.OnlineID
                         }
                     }
                 }, API.LocalUser.Value);
@@ -373,7 +374,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     new PlaylistItem
                     {
                         Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo },
-                        Ruleset = { Value = new OsuRuleset().RulesetInfo },
+                        RulesetID = new OsuRuleset().RulesetInfo.OnlineID
                     }
                 }
             });
@@ -393,7 +394,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     new PlaylistItem
                     {
                         Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo },
-                        Ruleset = { Value = new OsuRuleset().RulesetInfo },
+                        RulesetID = new OsuRuleset().RulesetInfo.OnlineID
                     }
                 }
             });
@@ -415,7 +416,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     new PlaylistItem
                     {
                         Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo },
-                        Ruleset = { Value = new OsuRuleset().RulesetInfo },
+                        RulesetID = new OsuRuleset().RulesetInfo.OnlineID
                     }
                 }
             });
@@ -454,7 +455,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     new PlaylistItem
                     {
                         Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo },
-                        Ruleset = { Value = new OsuRuleset().RulesetInfo },
+                        RulesetID = new OsuRuleset().RulesetInfo.OnlineID
                     }
                 }
             });
@@ -493,7 +494,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     new PlaylistItem
                     {
                         Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo },
-                        Ruleset = { Value = new OsuRuleset().RulesetInfo },
+                        RulesetID = new OsuRuleset().RulesetInfo.OnlineID
                     }
                 }
             });
@@ -532,7 +533,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     new PlaylistItem
                     {
                         Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo },
-                        Ruleset = { Value = new OsuRuleset().RulesetInfo },
+                        RulesetID = new OsuRuleset().RulesetInfo.OnlineID
                     }
                 }
             });
@@ -566,7 +567,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     new PlaylistItem
                     {
                         Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo },
-                        Ruleset = { Value = new OsuRuleset().RulesetInfo },
+                        RulesetID = new OsuRuleset().RulesetInfo.OnlineID
                     }
                 }
             });
@@ -606,7 +607,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     new PlaylistItem
                     {
                         Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo },
-                        Ruleset = { Value = new OsuRuleset().RulesetInfo },
+                        RulesetID = new OsuRuleset().RulesetInfo.OnlineID
                     }
                 }
             });
@@ -626,8 +627,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     new PlaylistItem
                     {
                         Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo },
-                        Ruleset = { Value = new OsuRuleset().RulesetInfo },
-                        AllowedMods = { new OsuModHidden() }
+                        RulesetID = new OsuRuleset().RulesetInfo.OnlineID,
+                        AllowedMods = new[] { new APIMod(new OsuModHidden()) }
                     }
                 }
             });
@@ -666,7 +667,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     new PlaylistItem
                     {
                         Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo },
-                        Ruleset = { Value = new OsuRuleset().RulesetInfo },
+                        RulesetID = new OsuRuleset().RulesetInfo.OnlineID
                     }
                 }
             });
@@ -697,7 +698,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                         new PlaylistItem
                         {
                             Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo },
-                            Ruleset = { Value = new OsuRuleset().RulesetInfo },
+                            RulesetID = new OsuRuleset().RulesetInfo.OnlineID
                         }
                     }
                 }, API.LocalUser.Value);
@@ -715,7 +716,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 {
                     ID = 2,
                     Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo },
-                    Ruleset = { Value = new OsuRuleset().RulesetInfo },
+                    RulesetID = new OsuRuleset().RulesetInfo.OnlineID
                 });
             });
 
@@ -743,7 +744,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     new PlaylistItem
                     {
                         Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo },
-                        Ruleset = { Value = new OsuRuleset().RulesetInfo },
+                        RulesetID = new OsuRuleset().RulesetInfo.OnlineID
                     }
                 }
             });
@@ -779,7 +780,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     new PlaylistItem
                     {
                         Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo },
-                        Ruleset = { Value = new OsuRuleset().RulesetInfo },
+                        RulesetID = new OsuRuleset().RulesetInfo.OnlineID
                     }
                 }
             });
@@ -818,7 +819,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     new PlaylistItem
                     {
                         Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo },
-                        Ruleset = { Value = new OsuRuleset().RulesetInfo },
+                        RulesetID = new OsuRuleset().RulesetInfo.OnlineID
                     }
                 }
             });
@@ -849,7 +850,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     new PlaylistItem
                     {
                         Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo },
-                        Ruleset = { Value = new OsuRuleset().RulesetInfo },
+                        RulesetID = new OsuRuleset().RulesetInfo.OnlineID
                     }
                 }
             });
@@ -882,7 +883,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     new PlaylistItem
                     {
                         Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo },
-                        Ruleset = { Value = new OsuRuleset().RulesetInfo },
+                        RulesetID = new OsuRuleset().RulesetInfo.OnlineID
                     }
                 }
             });
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs
index 869fb17317..a6151198cf 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs
@@ -10,6 +10,7 @@ using osu.Framework.Platform;
 using osu.Framework.Screens;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
+using osu.Game.Online.API;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Rooms;
@@ -72,7 +73,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 SelectedRoom.Value.Playlist.Add(new PlaylistItem
                 {
                     Beatmap = { Value = new TestBeatmap(new OsuRuleset().RulesetInfo).BeatmapInfo },
-                    Ruleset = { Value = new OsuRuleset().RulesetInfo },
+                    RulesetID = new OsuRuleset().RulesetInfo.OnlineID
                 });
             });
 
@@ -89,8 +90,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 SelectedRoom.Value.Playlist.Add(new PlaylistItem
                 {
                     Beatmap = { Value = new TestBeatmap(new TaikoRuleset().RulesetInfo).BeatmapInfo },
-                    Ruleset = { Value = new TaikoRuleset().RulesetInfo },
-                    AllowedMods = { new TaikoModSwap() }
+                    RulesetID = new TaikoRuleset().RulesetInfo.OnlineID,
+                    AllowedMods = new[] { new APIMod(new TaikoModSwap()) }
                 });
             });
 
@@ -112,7 +113,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 SelectedRoom.Value.Playlist.Add(new PlaylistItem
                 {
                     Beatmap = { Value = new TestBeatmap(new OsuRuleset().RulesetInfo).BeatmapInfo },
-                    Ruleset = { Value = new OsuRuleset().RulesetInfo },
+                    RulesetID = new OsuRuleset().RulesetInfo.OnlineID
                 });
             });
 
@@ -127,7 +128,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 SelectedRoom.Value.Playlist.Add(new PlaylistItem
                 {
                     Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First()).BeatmapInfo },
-                    Ruleset = { Value = new OsuRuleset().RulesetInfo },
+                    RulesetID = new OsuRuleset().RulesetInfo.OnlineID
                 });
             });
 
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlayer.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlayer.cs
index 73f2ed5b39..010e9dc078 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlayer.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlayer.cs
@@ -31,7 +31,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 Stack.Push(player = new MultiplayerPlayer(Client.APIRoom, new PlaylistItem
                 {
                     Beatmap = { Value = Beatmap.Value.BeatmapInfo },
-                    Ruleset = { Value = Beatmap.Value.BeatmapInfo.Ruleset }
+                    RulesetID = Beatmap.Value.BeatmapInfo.Ruleset.OnlineID,
                 }, Client.Room?.Users.ToArray()));
             });
 
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs
index 936798e6b4..361178bfe4 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs
@@ -146,12 +146,12 @@ namespace osu.Game.Tests.Visual.Multiplayer
                         new PlaylistItem
                         {
                             Beatmap = { Value = new TestBeatmap(Ruleset.Value).BeatmapInfo },
-                            Ruleset = { Value = Ruleset.Value }
+                            RulesetID = Ruleset.Value.OnlineID,
                         },
                         new PlaylistItem
                         {
                             Beatmap = { Value = new TestBeatmap(Ruleset.Value).BeatmapInfo },
-                            Ruleset = { Value = Ruleset.Value },
+                            RulesetID = Ruleset.Value.OnlineID,
                             Expired = true
                         }
                     }
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs
index 9867e5225e..7834226f15 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs
@@ -57,7 +57,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             selectedItem.Value = new PlaylistItem
             {
                 Beatmap = { Value = Beatmap.Value.BeatmapInfo },
-                Ruleset = { Value = Beatmap.Value.BeatmapInfo.Ruleset },
+                RulesetID = Beatmap.Value.BeatmapInfo.Ruleset.OnlineID
             };
 
             if (button != null)
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerSpectateButton.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerSpectateButton.cs
index 42ae279667..70d4d9dd55 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerSpectateButton.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerSpectateButton.cs
@@ -58,7 +58,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             selectedItem.Value = new PlaylistItem
             {
                 Beatmap = { Value = Beatmap.Value.BeatmapInfo },
-                Ruleset = { Value = Beatmap.Value.BeatmapInfo.Ruleset },
+                RulesetID = Beatmap.Value.BeatmapInfo.Ruleset.OnlineID,
             };
 
             Child = new FillFlowContainer
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsRoomSettingsPlaylist.cs b/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsRoomSettingsPlaylist.cs
index e63e58824f..8bfdda29d5 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsRoomSettingsPlaylist.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsRoomSettingsPlaylist.cs
@@ -13,6 +13,7 @@ using osu.Game.Beatmaps.Drawables;
 using osu.Game.Database;
 using osu.Game.Graphics.Containers;
 using osu.Game.Models;
+using osu.Game.Online.API;
 using osu.Game.Online.Rooms;
 using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Osu.Mods;
@@ -161,12 +162,12 @@ namespace osu.Game.Tests.Visual.Multiplayer
                                     BeatmapSet = new BeatmapSetInfo()
                                 }
                         },
-                        Ruleset = { Value = new OsuRuleset().RulesetInfo },
-                        RequiredMods =
+                        RulesetID = new OsuRuleset().RulesetInfo.OnlineID,
+                        RequiredMods = new[]
                         {
-                            new OsuModHardRock(),
-                            new OsuModDoubleTime(),
-                            new OsuModAutoplay()
+                            new APIMod(new OsuModHardRock()),
+                            new APIMod(new OsuModDoubleTime()),
+                            new APIMod(new OsuModAutoplay())
                         }
                     });
                 }
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsSongSelect.cs b/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsSongSelect.cs
index d933491ab6..3333afc88b 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsSongSelect.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsSongSelect.cs
@@ -115,8 +115,17 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddStep("change mod rate", () => ((OsuModDoubleTime)SelectedMods.Value[0]).SpeedChange.Value = 2);
             AddStep("create item", () => songSelect.BeatmapDetails.CreateNewItem());
 
-            AddAssert("item 1 has rate 1.5", () => Precision.AlmostEquals(1.5, ((OsuModDoubleTime)SelectedRoom.Value.Playlist.First().RequiredMods[0]).SpeedChange.Value));
-            AddAssert("item 2 has rate 2", () => Precision.AlmostEquals(2, ((OsuModDoubleTime)SelectedRoom.Value.Playlist.Last().RequiredMods[0]).SpeedChange.Value));
+            AddAssert("item 1 has rate 1.5", () =>
+            {
+                var mod = (OsuModDoubleTime)SelectedRoom.Value.Playlist.First().RequiredMods[0].ToMod(new OsuRuleset());
+                return Precision.AlmostEquals(1.5, mod.SpeedChange.Value);
+            });
+
+            AddAssert("item 2 has rate 2", () =>
+            {
+                var mod = (OsuModDoubleTime)SelectedRoom.Value.Playlist.Last().RequiredMods[0].ToMod(new OsuRuleset());
+                return Precision.AlmostEquals(2, mod.SpeedChange.Value);
+            });
         }
 
         /// <summary>
@@ -138,7 +147,11 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddStep("create item", () => songSelect.BeatmapDetails.CreateNewItem());
 
             AddStep("change stored mod rate", () => mod.SpeedChange.Value = 2);
-            AddAssert("item has rate 1.5", () => Precision.AlmostEquals(1.5, ((OsuModDoubleTime)SelectedRoom.Value.Playlist.First().RequiredMods[0]).SpeedChange.Value));
+            AddAssert("item has rate 1.5", () =>
+            {
+                var m = (OsuModDoubleTime)SelectedRoom.Value.Playlist.First().RequiredMods[0].ToMod(new OsuRuleset());
+                return Precision.AlmostEquals(1.5, m.SpeedChange.Value);
+            });
         }
 
         private class TestPlaylistsSongSelect : PlaylistsSongSelect
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs
index 781f0a1824..513c1413fa 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs
@@ -74,7 +74,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     new PlaylistItem
                     {
                         Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo },
-                        Ruleset = { Value = new OsuRuleset().RulesetInfo },
+                        RulesetID = new OsuRuleset().RulesetInfo.OnlineID
                     }
                 }
             });
@@ -95,7 +95,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     new PlaylistItem
                     {
                         Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo },
-                        Ruleset = { Value = new OsuRuleset().RulesetInfo },
+                        RulesetID = new OsuRuleset().RulesetInfo.OnlineID
                     }
                 }
             });
@@ -133,7 +133,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     new PlaylistItem
                     {
                         Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo },
-                        Ruleset = { Value = new OsuRuleset().RulesetInfo },
+                        RulesetID = new OsuRuleset().RulesetInfo.OnlineID
                     }
                 }
             });
@@ -159,7 +159,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     new PlaylistItem
                     {
                         Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo },
-                        Ruleset = { Value = new OsuRuleset().RulesetInfo },
+                        RulesetID = new OsuRuleset().RulesetInfo.OnlineID
                     }
                 }
             });
diff --git a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsResultsScreen.cs b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsResultsScreen.cs
index 11df115b1a..a05d01613c 100644
--- a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsResultsScreen.cs
+++ b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsResultsScreen.cs
@@ -168,7 +168,7 @@ namespace osu.Game.Tests.Visual.Playlists
                 LoadScreen(resultsScreen = new TestResultsScreen(getScore?.Invoke(), 1, new PlaylistItem
                 {
                     Beatmap = { Value = new TestBeatmap(new OsuRuleset().RulesetInfo).BeatmapInfo },
-                    Ruleset = { Value = new OsuRuleset().RulesetInfo }
+                    RulesetID = new OsuRuleset().RulesetInfo.OnlineID
                 }));
             });
 
diff --git a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs
index 68225f6d64..578ea63b4e 100644
--- a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs
+++ b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs
@@ -67,7 +67,7 @@ namespace osu.Game.Tests.Visual.Playlists
                 room.Playlist.Add(new PlaylistItem
                 {
                     Beatmap = { Value = importedBeatmap.Beatmaps.First() },
-                    Ruleset = { Value = new OsuRuleset().RulesetInfo }
+                    RulesetID = new OsuRuleset().RulesetInfo.OnlineID
                 });
             });
 
@@ -92,7 +92,7 @@ namespace osu.Game.Tests.Visual.Playlists
                 room.Playlist.Add(new PlaylistItem
                 {
                     Beatmap = { Value = importedBeatmap.Beatmaps.First() },
-                    Ruleset = { Value = new OsuRuleset().RulesetInfo }
+                    RulesetID = new OsuRuleset().RulesetInfo.OnlineID
                 });
             });
 
@@ -109,7 +109,7 @@ namespace osu.Game.Tests.Visual.Playlists
                 room.Playlist.Add(new PlaylistItem
                 {
                     Beatmap = { Value = importedBeatmap.Beatmaps.First() },
-                    Ruleset = { Value = new OsuRuleset().RulesetInfo }
+                    RulesetID = new OsuRuleset().RulesetInfo.OnlineID
                 });
             });
 
@@ -173,7 +173,7 @@ namespace osu.Game.Tests.Visual.Playlists
                             }
                         }
                     },
-                    Ruleset = { Value = new OsuRuleset().RulesetInfo }
+                    RulesetID = new OsuRuleset().RulesetInfo.OnlineID
                 });
             });
 
diff --git a/osu.Game/Online/Multiplayer/MultiplayerClient.cs b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
index 903aaa89e3..9d45229961 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
@@ -727,30 +727,18 @@ namespace osu.Game.Online.Multiplayer
             RoomUpdated?.Invoke();
         }
 
-        private PlaylistItem createPlaylistItem(MultiplayerPlaylistItem item)
+        private PlaylistItem createPlaylistItem(MultiplayerPlaylistItem item) => new PlaylistItem
         {
-            var ruleset = Rulesets.GetRuleset(item.RulesetID);
-
-            Debug.Assert(ruleset != null);
-
-            var rulesetInstance = ruleset.CreateInstance();
-
-            var playlistItem = new PlaylistItem
-            {
-                ID = item.ID,
-                BeatmapID = item.BeatmapID,
-                OwnerID = item.OwnerID,
-                Ruleset = { Value = ruleset },
-                Expired = item.Expired,
-                PlaylistOrder = item.PlaylistOrder,
-                PlayedAt = item.PlayedAt
-            };
-
-            playlistItem.RequiredMods.AddRange(item.RequiredMods.Select(m => m.ToMod(rulesetInstance)));
-            playlistItem.AllowedMods.AddRange(item.AllowedMods.Select(m => m.ToMod(rulesetInstance)));
-
-            return playlistItem;
-        }
+            ID = item.ID,
+            BeatmapID = item.BeatmapID,
+            OwnerID = item.OwnerID,
+            RulesetID = item.RulesetID,
+            Expired = item.Expired,
+            PlaylistOrder = item.PlaylistOrder,
+            PlayedAt = item.PlayedAt,
+            RequiredMods = item.RequiredMods.ToArray(),
+            AllowedMods = item.AllowedMods.ToArray()
+        };
 
         /// <summary>
         /// Retrieves a <see cref="APIBeatmap"/> from an online source.
diff --git a/osu.Game/Online/Rooms/MultiplayerPlaylistItem.cs b/osu.Game/Online/Rooms/MultiplayerPlaylistItem.cs
index 8ec073ff1e..d74cdd8c34 100644
--- a/osu.Game/Online/Rooms/MultiplayerPlaylistItem.cs
+++ b/osu.Game/Online/Rooms/MultiplayerPlaylistItem.cs
@@ -66,8 +66,8 @@ namespace osu.Game.Online.Rooms
             BeatmapID = item.BeatmapID;
             BeatmapChecksum = item.Beatmap.Value?.MD5Hash ?? string.Empty;
             RulesetID = item.RulesetID;
-            RequiredMods = item.RequiredMods.Select(m => new APIMod(m)).ToArray();
-            AllowedMods = item.AllowedMods.Select(m => new APIMod(m)).ToArray();
+            RequiredMods = item.RequiredMods.ToArray();
+            AllowedMods = item.AllowedMods.ToArray();
             Expired = item.Expired;
             PlaylistOrder = item.PlaylistOrder ?? 0;
             PlayedAt = item.PlayedAt;
diff --git a/osu.Game/Online/Rooms/MultiplayerScore.cs b/osu.Game/Online/Rooms/MultiplayerScore.cs
index f1bb57bd9d..85327be037 100644
--- a/osu.Game/Online/Rooms/MultiplayerScore.cs
+++ b/osu.Game/Online/Rooms/MultiplayerScore.cs
@@ -65,7 +65,11 @@ namespace osu.Game.Online.Rooms
 
         public ScoreInfo CreateScoreInfo(RulesetStore rulesets, PlaylistItem playlistItem, [NotNull] BeatmapInfo beatmap)
         {
-            var rulesetInstance = playlistItem.Ruleset.Value.CreateInstance();
+            var ruleset = rulesets.GetRuleset(playlistItem.RulesetID);
+            if (ruleset == null)
+                throw new InvalidOperationException($"Couldn't create score with unknown ruleset: {playlistItem.RulesetID}");
+
+            var rulesetInstance = ruleset.CreateInstance();
 
             var scoreInfo = new ScoreInfo
             {
diff --git a/osu.Game/Online/Rooms/PlaylistItem.cs b/osu.Game/Online/Rooms/PlaylistItem.cs
index 83a70c405b..c082babb01 100644
--- a/osu.Game/Online/Rooms/PlaylistItem.cs
+++ b/osu.Game/Online/Rooms/PlaylistItem.cs
@@ -2,7 +2,6 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
-using System.Diagnostics;
 using System.Linq;
 using JetBrains.Annotations;
 using Newtonsoft.Json;
@@ -10,8 +9,6 @@ using osu.Framework.Bindables;
 using osu.Game.Beatmaps;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests.Responses;
-using osu.Game.Rulesets;
-using osu.Game.Rulesets.Mods;
 
 namespace osu.Game.Online.Rooms
 {
@@ -49,68 +46,25 @@ namespace osu.Game.Online.Rooms
         [JsonIgnore]
         public readonly Bindable<IBeatmapInfo> Beatmap = new Bindable<IBeatmapInfo>();
 
-        [JsonIgnore]
-        public readonly Bindable<IRulesetInfo> Ruleset = new Bindable<IRulesetInfo>();
-
-        [JsonIgnore]
-        public readonly BindableList<Mod> AllowedMods = new BindableList<Mod>();
-
-        [JsonIgnore]
-        public readonly BindableList<Mod> RequiredMods = new BindableList<Mod>();
-
         [JsonProperty("beatmap")]
         private APIBeatmap apiBeatmap { get; set; }
 
-        private APIMod[] allowedModsBacking;
-
         [JsonProperty("allowed_mods")]
-        private APIMod[] allowedMods
-        {
-            get => AllowedMods.Select(m => new APIMod(m)).ToArray();
-            set => allowedModsBacking = value;
-        }
-
-        private APIMod[] requiredModsBacking;
+        public APIMod[] AllowedMods { get; set; } = Array.Empty<APIMod>();
 
         [JsonProperty("required_mods")]
-        private APIMod[] requiredMods
-        {
-            get => RequiredMods.Select(m => new APIMod(m)).ToArray();
-            set => requiredModsBacking = value;
-        }
+        public APIMod[] RequiredMods { get; set; } = Array.Empty<APIMod>();
 
         public PlaylistItem()
         {
             Beatmap.BindValueChanged(beatmap => BeatmapID = beatmap.NewValue?.OnlineID ?? -1);
-            Ruleset.BindValueChanged(ruleset => RulesetID = ruleset.NewValue?.OnlineID ?? 0);
         }
 
         public void MarkInvalid() => valid.Value = false;
 
-        public void MapObjects(IRulesetStore rulesets)
+        public void MapObjects()
         {
             Beatmap.Value ??= apiBeatmap;
-            Ruleset.Value ??= rulesets.GetRuleset(RulesetID);
-
-            Debug.Assert(Ruleset.Value != null);
-
-            Ruleset rulesetInstance = Ruleset.Value.CreateInstance();
-
-            if (allowedModsBacking != null)
-            {
-                AllowedMods.Clear();
-                AllowedMods.AddRange(allowedModsBacking.Select(m => m.ToMod(rulesetInstance)));
-
-                allowedModsBacking = null;
-            }
-
-            if (requiredModsBacking != null)
-            {
-                RequiredMods.Clear();
-                RequiredMods.AddRange(requiredModsBacking.Select(m => m.ToMod(rulesetInstance)));
-
-                requiredModsBacking = null;
-            }
         }
 
         #region Newtonsoft.Json implicit ShouldSerialize() methods
@@ -133,7 +87,7 @@ namespace osu.Game.Online.Rooms
                && BeatmapID == other.BeatmapID
                && RulesetID == other.RulesetID
                && Expired == other.Expired
-               && allowedMods.SequenceEqual(other.allowedMods)
-               && requiredMods.SequenceEqual(other.requiredMods);
+               && AllowedMods.SequenceEqual(other.AllowedMods)
+               && RequiredMods.SequenceEqual(other.RequiredMods);
     }
 }
diff --git a/osu.Game/Screens/OnlinePlay/Components/ModeTypeInfo.cs b/osu.Game/Screens/OnlinePlay/Components/ModeTypeInfo.cs
index 2026106c42..d534a1e374 100644
--- a/osu.Game/Screens/OnlinePlay/Components/ModeTypeInfo.cs
+++ b/osu.Game/Screens/OnlinePlay/Components/ModeTypeInfo.cs
@@ -6,6 +6,7 @@ using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Beatmaps.Drawables;
+using osu.Game.Rulesets;
 using osuTK;
 
 namespace osu.Game.Screens.OnlinePlay.Components
@@ -15,6 +16,9 @@ namespace osu.Game.Screens.OnlinePlay.Components
         private const float height = 28;
         private const float transition_duration = 100;
 
+        [Resolved]
+        private RulesetStore rulesets { get; set; }
+
         private Container drawableRuleset;
 
         public ModeTypeInfo()
@@ -56,11 +60,14 @@ namespace osu.Game.Screens.OnlinePlay.Components
         private void updateBeatmap()
         {
             var item = Playlist.FirstOrDefault();
+            var ruleset = item == null ? null : rulesets.GetRuleset(item.RulesetID)?.CreateInstance();
 
-            if (item?.Beatmap != null)
+            if (item?.Beatmap != null && ruleset != null)
             {
+                var mods = item.RequiredMods.Select(m => m.ToMod(ruleset)).ToArray();
+
                 drawableRuleset.FadeIn(transition_duration);
-                drawableRuleset.Child = new DifficultyIcon(item.Beatmap.Value, item.Ruleset.Value, item.RequiredMods) { Size = new Vector2(height) };
+                drawableRuleset.Child = new DifficultyIcon(item.Beatmap.Value, ruleset.RulesetInfo, mods) { Size = new Vector2(height) };
             }
             else
                 drawableRuleset.FadeOut(transition_duration);
diff --git a/osu.Game/Screens/OnlinePlay/Components/RoomManager.cs b/osu.Game/Screens/OnlinePlay/Components/RoomManager.cs
index 238aa4059d..21b64b61bb 100644
--- a/osu.Game/Screens/OnlinePlay/Components/RoomManager.cs
+++ b/osu.Game/Screens/OnlinePlay/Components/RoomManager.cs
@@ -12,7 +12,6 @@ using osu.Framework.Graphics;
 using osu.Framework.Logging;
 using osu.Game.Online.API;
 using osu.Game.Online.Rooms;
-using osu.Game.Rulesets;
 
 namespace osu.Game.Screens.OnlinePlay.Components
 {
@@ -27,9 +26,6 @@ namespace osu.Game.Screens.OnlinePlay.Components
         protected IBindable<Room> JoinedRoom => joinedRoom;
         private readonly Bindable<Room> joinedRoom = new Bindable<Room>();
 
-        [Resolved]
-        private IRulesetStore rulesets { get; set; }
-
         [Resolved]
         private IAPIProvider api { get; set; }
 
@@ -117,7 +113,7 @@ namespace osu.Game.Screens.OnlinePlay.Components
             try
             {
                 foreach (var pi in room.Playlist)
-                    pi.MapObjects(rulesets);
+                    pi.MapObjects();
 
                 var existing = rooms.FirstOrDefault(e => e.RoomID.Value == room.RoomID.Value);
                 if (existing == null)
diff --git a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
index e1f7ea5e92..dcf2a5a480 100644
--- a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
+++ b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
@@ -69,8 +69,9 @@ namespace osu.Game.Screens.OnlinePlay
         private readonly DelayedLoadWrapper onScreenLoader = new DelayedLoadWrapper(Empty) { RelativeSizeAxes = Axes.Both };
         private readonly IBindable<bool> valid = new Bindable<bool>();
         private readonly Bindable<IBeatmapInfo> beatmap = new Bindable<IBeatmapInfo>();
-        private readonly Bindable<IRulesetInfo> ruleset = new Bindable<IRulesetInfo>();
-        private readonly BindableList<Mod> requiredMods = new BindableList<Mod>();
+
+        private IRulesetInfo ruleset;
+        private Mod[] requiredMods;
 
         private Container maskingContainer;
         private Container difficultyIconContainer;
@@ -86,6 +87,9 @@ namespace osu.Game.Screens.OnlinePlay
         private PanelBackground panelBackground;
         private FillFlowContainer mainFillFlow;
 
+        [Resolved]
+        private RulesetStore rulesets { get; set; }
+
         [Resolved]
         private OsuColour colours { get; set; }
 
@@ -108,8 +112,6 @@ namespace osu.Game.Screens.OnlinePlay
 
             beatmap.BindTo(item.Beatmap);
             valid.BindTo(item.Valid);
-            ruleset.BindTo(item.Ruleset);
-            requiredMods.BindTo(item.RequiredMods);
 
             if (item.Expired)
                 Colour = OsuColour.Gray(0.5f);
@@ -119,6 +121,11 @@ namespace osu.Game.Screens.OnlinePlay
         private void load()
         {
             maskingContainer.BorderColour = colours.Yellow;
+
+            ruleset = rulesets.GetRuleset(Item.RulesetID);
+            var rulesetInstance = ruleset?.CreateInstance();
+
+            requiredMods = Item.RequiredMods.Select(m => m.ToMod(rulesetInstance)).ToArray();
         }
 
         protected override void LoadComplete()
@@ -145,9 +152,7 @@ namespace osu.Game.Screens.OnlinePlay
             }, true);
 
             beatmap.BindValueChanged(_ => Scheduler.AddOnce(refresh));
-            ruleset.BindValueChanged(_ => Scheduler.AddOnce(refresh));
             valid.BindValueChanged(_ => Scheduler.AddOnce(refresh));
-            requiredMods.CollectionChanged += (_, __) => Scheduler.AddOnce(refresh);
 
             onScreenLoader.DelayedLoadStarted += _ =>
             {
@@ -276,7 +281,7 @@ namespace osu.Game.Screens.OnlinePlay
             }
 
             if (Item.Beatmap.Value != null)
-                difficultyIconContainer.Child = new DifficultyIcon(Item.Beatmap.Value, ruleset.Value, requiredMods, performBackgroundDifficultyLookup: false) { Size = new Vector2(icon_height) };
+                difficultyIconContainer.Child = new DifficultyIcon(Item.Beatmap.Value, ruleset, requiredMods, performBackgroundDifficultyLookup: false) { Size = new Vector2(icon_height) };
             else
                 difficultyIconContainer.Clear();
 
diff --git a/osu.Game/Screens/OnlinePlay/Lounge/Components/RoomsContainer.cs b/osu.Game/Screens/OnlinePlay/Lounge/Components/RoomsContainer.cs
index f4d7823fcc..9f917c978c 100644
--- a/osu.Game/Screens/OnlinePlay/Lounge/Components/RoomsContainer.cs
+++ b/osu.Game/Screens/OnlinePlay/Lounge/Components/RoomsContainer.cs
@@ -12,7 +12,6 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Input.Bindings;
 using osu.Framework.Input.Events;
-using osu.Game.Extensions;
 using osu.Game.Graphics.Cursor;
 using osu.Game.Input.Bindings;
 using osu.Game.Online.Rooms;
@@ -78,7 +77,7 @@ namespace osu.Game.Screens.OnlinePlay.Lounge.Components
                 {
                     bool matchingFilter = true;
 
-                    matchingFilter &= r.Room.Playlist.Count == 0 || criteria.Ruleset == null || r.Room.Playlist.Any(i => i.Ruleset.Value.MatchesOnlineID(criteria.Ruleset));
+                    matchingFilter &= r.Room.Playlist.Count == 0 || criteria.Ruleset == null || r.Room.Playlist.Any(i => i.RulesetID == criteria.Ruleset.OnlineID);
 
                     if (!string.IsNullOrEmpty(criteria.SearchString))
                         matchingFilter &= r.FilterTerms.Any(term => term.Contains(criteria.SearchString, StringComparison.InvariantCultureIgnoreCase));
diff --git a/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs b/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
index 2d5225639f..02e1b115a0 100644
--- a/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
@@ -386,7 +386,9 @@ namespace osu.Game.Screens.OnlinePlay.Match
             if (SelectedItem.Value == null || !this.IsCurrentScreen())
                 return;
 
-            Mods.Value = UserMods.Value.Concat(SelectedItem.Value.RequiredMods).ToList();
+            var rulesetInstance = rulesets.GetRuleset(SelectedItem.Value.RulesetID)?.CreateInstance();
+            Debug.Assert(rulesetInstance != null);
+            Mods.Value = UserMods.Value.Concat(SelectedItem.Value.RequiredMods.Select(m => m.ToMod(rulesetInstance))).ToList();
         }
 
         private void updateRuleset()
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs
index 073497e1ce..12caf1fde1 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs
@@ -11,7 +11,6 @@ using osu.Framework.Logging;
 using osu.Framework.Screens;
 using osu.Game.Beatmaps;
 using osu.Game.Graphics.UserInterface;
-using osu.Game.Online.API;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Rooms;
 using osu.Game.Rulesets;
@@ -71,8 +70,8 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
                     BeatmapID = item.BeatmapID,
                     BeatmapChecksum = item.Beatmap.Value.MD5Hash,
                     RulesetID = item.RulesetID,
-                    RequiredMods = item.RequiredMods.Select(m => new APIMod(m)).ToArray(),
-                    AllowedMods = item.AllowedMods.Select(m => new APIMod(m)).ToArray()
+                    RequiredMods = item.RequiredMods.ToArray(),
+                    AllowedMods = item.AllowedMods.ToArray()
                 };
 
                 Task task = itemToEdit != null ? client.EditPlaylistItem(multiplayerItem) : client.AddPlaylistItem(multiplayerItem);
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
index a397493bab..cb50a56052 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
@@ -247,7 +247,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
             // update local mods based on room's reported status for the local user (omitting the base call implementation).
             // this makes the server authoritative, and avoids the local user potentially setting mods that the server is not aware of (ie. if the match was started during the selection being changed).
             var ruleset = Ruleset.Value.CreateInstance();
-            Mods.Value = client.LocalUser.Mods.Select(m => m.ToMod(ruleset)).Concat(SelectedItem.Value.RequiredMods).ToList();
+            Mods.Value = client.LocalUser.Mods.Select(m => m.ToMod(ruleset)).Concat(SelectedItem.Value.RequiredMods.Select(m => m.ToMod(ruleset))).ToList();
         }
 
         [Resolved(canBeNull: true)]
diff --git a/osu.Game/Screens/OnlinePlay/OnlinePlaySongSelect.cs b/osu.Game/Screens/OnlinePlay/OnlinePlaySongSelect.cs
index 63957caee3..eab1f83967 100644
--- a/osu.Game/Screens/OnlinePlay/OnlinePlaySongSelect.cs
+++ b/osu.Game/Screens/OnlinePlay/OnlinePlaySongSelect.cs
@@ -12,6 +12,7 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Screens;
 using osu.Game.Beatmaps;
+using osu.Game.Online.API;
 using osu.Game.Online.Rooms;
 using osu.Game.Overlays.Mods;
 using osu.Game.Rulesets;
@@ -37,6 +38,9 @@ namespace osu.Game.Screens.OnlinePlay
         [Resolved(CanBeNull = true)]
         protected IBindable<PlaylistItem> SelectedItem { get; private set; }
 
+        [Resolved]
+        private RulesetStore rulesets { get; set; }
+
         protected override UserActivity InitialActivity => new UserActivity.InLobby(room);
 
         protected readonly Bindable<IReadOnlyList<Mod>> FreeMods = new Bindable<IReadOnlyList<Mod>>(Array.Empty<Mod>());
@@ -78,10 +82,15 @@ namespace osu.Game.Screens.OnlinePlay
         {
             base.LoadComplete();
 
-            // At this point, Mods contains both the required and allowed mods. For selection purposes, it should only contain the required mods.
-            // Similarly, freeMods is currently empty but should only contain the allowed mods.
-            Mods.Value = SelectedItem?.Value?.RequiredMods.Select(m => m.DeepClone()).ToArray() ?? Array.Empty<Mod>();
-            FreeMods.Value = SelectedItem?.Value?.AllowedMods.Select(m => m.DeepClone()).ToArray() ?? Array.Empty<Mod>();
+            var rulesetInstance = SelectedItem?.Value?.RulesetID == null ? null : rulesets.GetRuleset(SelectedItem.Value.RulesetID)?.CreateInstance();
+
+            if (rulesetInstance != null)
+            {
+                // At this point, Mods contains both the required and allowed mods. For selection purposes, it should only contain the required mods.
+                // Similarly, freeMods is currently empty but should only contain the allowed mods.
+                Mods.Value = SelectedItem.Value.RequiredMods.Select(m => m.ToMod(rulesetInstance)).ToArray();
+                FreeMods.Value = SelectedItem.Value.AllowedMods.Select(m => m.ToMod(rulesetInstance)).ToArray();
+            }
 
             Mods.BindValueChanged(onModsChanged);
             Ruleset.BindValueChanged(onRulesetChanged);
@@ -110,15 +119,11 @@ namespace osu.Game.Screens.OnlinePlay
                 {
                     Value = Beatmap.Value.BeatmapInfo
                 },
-                Ruleset =
-                {
-                    Value = Ruleset.Value
-                }
+                RulesetID = Ruleset.Value.OnlineID,
+                RequiredMods = Mods.Value.Select(m => new APIMod(m)).ToArray(),
+                AllowedMods = FreeMods.Value.Select(m => new APIMod(m)).ToArray()
             };
 
-            item.RequiredMods.AddRange(Mods.Value.Select(m => m.DeepClone()));
-            item.AllowedMods.AddRange(FreeMods.Value.Select(m => m.DeepClone()));
-
             SelectItem(item);
             return true;
         }
diff --git a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsPlayer.cs b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsPlayer.cs
index 35d417520e..2b071175d5 100644
--- a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsPlayer.cs
+++ b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsPlayer.cs
@@ -9,6 +9,7 @@ using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Screens;
 using osu.Game.Extensions;
+using osu.Game.Online.API;
 using osu.Game.Online.Rooms;
 using osu.Game.Rulesets;
 using osu.Game.Scoring;
@@ -36,10 +37,11 @@ namespace osu.Game.Screens.OnlinePlay.Playlists
             if (!Beatmap.Value.BeatmapInfo.MatchesOnlineID(PlaylistItem.Beatmap.Value))
                 throw new InvalidOperationException("Current Beatmap does not match PlaylistItem's Beatmap");
 
-            if (!ruleset.Value.MatchesOnlineID(PlaylistItem.Ruleset.Value))
+            if (ruleset.Value.OnlineID != PlaylistItem.RulesetID)
                 throw new InvalidOperationException("Current Ruleset does not match PlaylistItem's Ruleset");
 
-            if (!PlaylistItem.RequiredMods.All(m => Mods.Value.Any(m.Equals)))
+            var localMods = Mods.Value.Select(m => new APIMod(m)).ToArray();
+            if (!PlaylistItem.RequiredMods.All(m => localMods.Any(m.Equals)))
                 throw new InvalidOperationException("Current Mods do not match PlaylistItem's RequiredMods");
         }
 
diff --git a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsSongSelect.cs b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsSongSelect.cs
index 0fd76f7e25..3ac576b18e 100644
--- a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsSongSelect.cs
+++ b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsSongSelect.cs
@@ -3,6 +3,7 @@
 
 using System.Linq;
 using osu.Framework.Screens;
+using osu.Game.Online.API;
 using osu.Game.Online.Rooms;
 using osu.Game.Screens.OnlinePlay.Components;
 using osu.Game.Screens.Select;
@@ -30,7 +31,8 @@ namespace osu.Game.Screens.OnlinePlay.Playlists
                     break;
 
                 case 1:
-                    populateItemFromCurrent(Playlist.Single());
+                    Playlist.Clear();
+                    createNewItem();
                     break;
             }
 
@@ -41,24 +43,14 @@ namespace osu.Game.Screens.OnlinePlay.Playlists
         {
             PlaylistItem item = new PlaylistItem
             {
-                ID = Playlist.Count == 0 ? 0 : Playlist.Max(p => p.ID) + 1
+                ID = Playlist.Count == 0 ? 0 : Playlist.Max(p => p.ID) + 1,
+                Beatmap = { Value = Beatmap.Value.BeatmapInfo },
+                RulesetID = Ruleset.Value.OnlineID,
+                RequiredMods = Mods.Value.Select(m => new APIMod(m)).ToArray(),
+                AllowedMods = FreeMods.Value.Select(m => new APIMod(m)).ToArray()
             };
 
-            populateItemFromCurrent(item);
-
             Playlist.Add(item);
         }
-
-        private void populateItemFromCurrent(PlaylistItem item)
-        {
-            item.Beatmap.Value = Beatmap.Value.BeatmapInfo;
-            item.Ruleset.Value = Ruleset.Value;
-
-            item.RequiredMods.Clear();
-            item.RequiredMods.AddRange(Mods.Value.Select(m => m.DeepClone()));
-
-            item.AllowedMods.Clear();
-            item.AllowedMods.AddRange(FreeMods.Value.Select(m => m.DeepClone()));
-        }
     }
 }
diff --git a/osu.Game/Tests/Visual/Multiplayer/MultiplayerTestScene.cs b/osu.Game/Tests/Visual/Multiplayer/MultiplayerTestScene.cs
index 7607122ef0..ed86d572b9 100644
--- a/osu.Game/Tests/Visual/Multiplayer/MultiplayerTestScene.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/MultiplayerTestScene.cs
@@ -50,7 +50,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     new PlaylistItem
                     {
                         Beatmap = { Value = new TestBeatmap(Ruleset.Value).BeatmapInfo },
-                        Ruleset = { Value = Ruleset.Value }
+                        RulesetID = Ruleset.Value.OnlineID
                     }
                 }
             };
diff --git a/osu.Game/Tests/Visual/OnlinePlay/TestRoomManager.cs b/osu.Game/Tests/Visual/OnlinePlay/TestRoomManager.cs
index 4cbc6174c9..73d0df2c36 100644
--- a/osu.Game/Tests/Visual/OnlinePlay/TestRoomManager.cs
+++ b/osu.Game/Tests/Visual/OnlinePlay/TestRoomManager.cs
@@ -45,7 +45,7 @@ namespace osu.Game.Tests.Visual.OnlinePlay
                 {
                     room.Playlist.Add(new PlaylistItem
                     {
-                        Ruleset = { Value = ruleset },
+                        RulesetID = ruleset.OnlineID,
                         Beatmap =
                         {
                             Value = new BeatmapInfo

From 5b765581d83b9d7613e507697d68392c034d8ebe Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 15 Feb 2022 16:18:40 +0900
Subject: [PATCH 2909/5547] Fix free mod selection not showing allowed mods

---
 .../TestSceneMultiplayerMatchSubScreen.cs     | 25 +++++++++++++++++++
 .../Screens/OnlinePlay/Match/RoomSubScreen.cs | 11 +++++---
 2 files changed, 32 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs
index a6151198cf..4dd3427bee 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs
@@ -14,11 +14,14 @@ 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.Mods;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Osu;
+using osu.Game.Rulesets.Osu.Mods;
 using osu.Game.Rulesets.Taiko;
 using osu.Game.Rulesets.Taiko.Mods;
 using osu.Game.Rulesets.UI;
+using osu.Game.Screens.OnlinePlay.Match;
 using osu.Game.Screens.OnlinePlay.Multiplayer;
 using osu.Game.Screens.OnlinePlay.Multiplayer.Match;
 using osu.Game.Screens.OnlinePlay.Multiplayer.Participants;
@@ -150,5 +153,27 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             AddUntilStep("match started", () => Client.Room?.State == MultiplayerRoomState.WaitingForLoad);
         }
+
+        [Test]
+        public void TestFreeModSelectionHasAllowedMods()
+        {
+            AddStep("add playlist item with allowed mod", () =>
+            {
+                SelectedRoom.Value.Playlist.Add(new PlaylistItem
+                {
+                    Beatmap = { Value = new TestBeatmap(new OsuRuleset().RulesetInfo).BeatmapInfo },
+                    RulesetID = new OsuRuleset().RulesetInfo.OnlineID,
+                    AllowedMods = new[] { new APIMod(new OsuModDoubleTime()) }
+                });
+            });
+
+            ClickButtonWhenEnabled<MultiplayerMatchSettingsOverlay.CreateOrUpdateButton>();
+
+            AddUntilStep("wait for join", () => RoomJoined);
+
+            ClickButtonWhenEnabled<RoomSubScreen.UserModSelectButton>();
+
+            AddAssert("mod select contains only double time mod", () => this.ChildrenOfType<UserModSelectOverlay>().Single().ChildrenOfType<ModButton>().Single().Mod is OsuModDoubleTime);
+        }
     }
 }
diff --git a/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs b/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
index 02e1b115a0..836629ada0 100644
--- a/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.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;
@@ -350,10 +351,12 @@ namespace osu.Game.Screens.OnlinePlay.Match
             if (selected == null)
                 return;
 
+            var rulesetInstance = rulesets.GetRuleset(SelectedItem.Value.RulesetID)?.CreateInstance();
+            Debug.Assert(rulesetInstance != null);
+            var allowedMods = SelectedItem.Value.AllowedMods.Select(m => m.ToMod(rulesetInstance));
+
             // Remove any user mods that are no longer allowed.
-            UserMods.Value = UserMods.Value
-                                     .Where(m => selected.AllowedMods.Any(a => m.GetType() == a.GetType()))
-                                     .ToList();
+            UserMods.Value = UserMods.Value.Where(m => allowedMods.Any(a => m.GetType() == a.GetType())).ToList();
 
             UpdateMods();
             updateRuleset();
@@ -367,7 +370,7 @@ namespace osu.Game.Screens.OnlinePlay.Match
             else
             {
                 UserModsSection?.Show();
-                userModsSelectOverlay.IsValidMod = m => selected.AllowedMods.Any(a => a.GetType() == m.GetType());
+                userModsSelectOverlay.IsValidMod = m => allowedMods.Any(a => a.GetType() == m.GetType());
             }
         }
 

From f03de16ee5a46deac3b5f2ca1edfba5c4c5dca7d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 15 Feb 2022 16:27:10 +0900
Subject: [PATCH 2910/5547] Add a test EF database

Created on d8a23aad4 (just before skins were migrated to realm).

This contains:
- 2 beatmap sets (intro and disco prince)
- 1 score (set on disco prince using autopilot/DT)
- 1 skin (haxwell)

- 322 named files (from skin)
- 5 named files (from beatmaps)

- 270 total file infos
---
 osu.Game.Tests/Resources/client.db | Bin 0 -> 266240 bytes
 1 file changed, 0 insertions(+), 0 deletions(-)
 create mode 100644 osu.Game.Tests/Resources/client.db

diff --git a/osu.Game.Tests/Resources/client.db b/osu.Game.Tests/Resources/client.db
new file mode 100644
index 0000000000000000000000000000000000000000..079d5af3b7454bcd1c3acfdd199ce1a15c33567f
GIT binary patch
literal 266240
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%0AIS*{2p$_Webaed|cdzP^yMTaF-b
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

literal 0
HcmV?d00001


From b1cf014dc21a2dd61040522df015de5e4b6ed02a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 15 Feb 2022 16:18:39 +0900
Subject: [PATCH 2911/5547] Add test coverage of EF to Realm migration process

---
 .../Navigation/TestEFToRealmMigration.cs      | 43 +++++++++++++++++++
 1 file changed, 43 insertions(+)
 create mode 100644 osu.Game.Tests/Visual/Navigation/TestEFToRealmMigration.cs

diff --git a/osu.Game.Tests/Visual/Navigation/TestEFToRealmMigration.cs b/osu.Game.Tests/Visual/Navigation/TestEFToRealmMigration.cs
new file mode 100644
index 0000000000..00a06d420e
--- /dev/null
+++ b/osu.Game.Tests/Visual/Navigation/TestEFToRealmMigration.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.IO;
+using System.Linq;
+using NUnit.Framework;
+using osu.Framework.Allocation;
+using osu.Game.Beatmaps;
+using osu.Game.Database;
+using osu.Game.Models;
+using osu.Game.Scoring;
+using osu.Game.Skinning;
+using osu.Game.Tests.Resources;
+
+namespace osu.Game.Tests.Visual.Navigation
+{
+    public class TestEFToRealmMigration : OsuGameTestScene
+    {
+        public override void RecycleLocalStorage(bool isDisposing)
+        {
+            base.RecycleLocalStorage(isDisposing);
+
+            if (isDisposing)
+                return;
+
+            using (var outStream = LocalStorage.GetStream(DatabaseContextFactory.DATABASE_NAME, FileAccess.Write, FileMode.Create))
+            using (var stream = TestResources.OpenResource(DatabaseContextFactory.DATABASE_NAME))
+                stream.CopyTo(outStream);
+        }
+
+        [Test]
+        public void TestMigration()
+        {
+            // Numbers are taken from the test database (see commit f03de16ee5a46deac3b5f2ca1edfba5c4c5dca7d).
+            AddAssert("Check beatmaps", () => Game.Dependencies.Get<RealmAccess>().Run(r => r.All<BeatmapSetInfo>().Count(s => !s.Protected) == 1));
+            AddAssert("Check skins", () => Game.Dependencies.Get<RealmAccess>().Run(r => r.All<SkinInfo>().Count(s => !s.Protected) == 1));
+            AddAssert("Check scores", () => Game.Dependencies.Get<RealmAccess>().Run(r => r.All<ScoreInfo>().Count() == 1));
+
+            // One extra file is created during realm migration / startup due to the circles intro import.
+            AddAssert("Check files", () => Game.Dependencies.Get<RealmAccess>().Run(r => r.All<RealmFile>().Count() == 271));
+        }
+    }
+}

From d79845fb1df28e63545aa0f4bf9552e16965d9bd Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 15 Feb 2022 17:06:33 +0900
Subject: [PATCH 2912/5547] Revert `NUnit3TestAdaptor` (again)

Console output is still broken. See
https://github.com/ppy/osu/runs/5196023462?check_suite_focus=true.
---
 osu.Game.Benchmarks/osu.Game.Benchmarks.csproj                  | 2 +-
 .../osu.Game.Rulesets.Catch.Tests.csproj                        | 2 +-
 .../osu.Game.Rulesets.Mania.Tests.csproj                        | 2 +-
 osu.Game.Rulesets.Osu.Tests/osu.Game.Rulesets.Osu.Tests.csproj  | 2 +-
 .../osu.Game.Rulesets.Taiko.Tests.csproj                        | 2 +-
 osu.Game.Tests/osu.Game.Tests.csproj                            | 2 +-
 osu.Game.Tournament.Tests/osu.Game.Tournament.Tests.csproj      | 2 +-
 7 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/osu.Game.Benchmarks/osu.Game.Benchmarks.csproj b/osu.Game.Benchmarks/osu.Game.Benchmarks.csproj
index 2bdb6a650c..434c0e0367 100644
--- a/osu.Game.Benchmarks/osu.Game.Benchmarks.csproj
+++ b/osu.Game.Benchmarks/osu.Game.Benchmarks.csproj
@@ -9,7 +9,7 @@
   <ItemGroup>
     <PackageReference Include="BenchmarkDotNet" Version="0.13.1" />
     <PackageReference Include="nunit" Version="3.13.2" />
-    <PackageReference Include="NUnit3TestAdapter" Version="4.2.1" />
+    <PackageReference Include="NUnit3TestAdapter" Version="4.1.0" />
   </ItemGroup>
 
   <ItemGroup>
diff --git a/osu.Game.Rulesets.Catch.Tests/osu.Game.Rulesets.Catch.Tests.csproj b/osu.Game.Rulesets.Catch.Tests/osu.Game.Rulesets.Catch.Tests.csproj
index a6c614f22f..fc6d900567 100644
--- a/osu.Game.Rulesets.Catch.Tests/osu.Game.Rulesets.Catch.Tests.csproj
+++ b/osu.Game.Rulesets.Catch.Tests/osu.Game.Rulesets.Catch.Tests.csproj
@@ -4,7 +4,7 @@
     <PackageReference Include="Appveyor.TestLogger" Version="2.0.0" />
     <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.0.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
-    <PackageReference Include="NUnit3TestAdapter" Version="4.2.1" />
+    <PackageReference Include="NUnit3TestAdapter" Version="4.1.0" />
     <PackageReference Update="Microsoft.EntityFrameworkCore.Sqlite" Version="2.1.4" />
   </ItemGroup>
   <PropertyGroup Label="Project">
diff --git a/osu.Game.Rulesets.Mania.Tests/osu.Game.Rulesets.Mania.Tests.csproj b/osu.Game.Rulesets.Mania.Tests/osu.Game.Rulesets.Mania.Tests.csproj
index ff49d6d4dd..ddad2adfea 100644
--- a/osu.Game.Rulesets.Mania.Tests/osu.Game.Rulesets.Mania.Tests.csproj
+++ b/osu.Game.Rulesets.Mania.Tests/osu.Game.Rulesets.Mania.Tests.csproj
@@ -4,7 +4,7 @@
     <PackageReference Include="Appveyor.TestLogger" Version="2.0.0" />
     <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.0.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
-    <PackageReference Include="NUnit3TestAdapter" Version="4.2.1" />
+    <PackageReference Include="NUnit3TestAdapter" Version="4.1.0" />
     <PackageReference Update="Microsoft.EntityFrameworkCore.Sqlite" Version="2.1.4" />
   </ItemGroup>
   <PropertyGroup Label="Project">
diff --git a/osu.Game.Rulesets.Osu.Tests/osu.Game.Rulesets.Osu.Tests.csproj b/osu.Game.Rulesets.Osu.Tests/osu.Game.Rulesets.Osu.Tests.csproj
index a2e54f5cdc..bd4c3d3345 100644
--- a/osu.Game.Rulesets.Osu.Tests/osu.Game.Rulesets.Osu.Tests.csproj
+++ b/osu.Game.Rulesets.Osu.Tests/osu.Game.Rulesets.Osu.Tests.csproj
@@ -5,7 +5,7 @@
     <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.0.0" />
     <PackageReference Include="Moq" Version="4.16.1" />
     <PackageReference Include="NUnit" Version="3.13.2" />
-    <PackageReference Include="NUnit3TestAdapter" Version="4.2.1" />
+    <PackageReference Include="NUnit3TestAdapter" Version="4.1.0" />
     <PackageReference Update="Microsoft.EntityFrameworkCore.Sqlite" Version="2.1.4" />
   </ItemGroup>
   <PropertyGroup Label="Project">
diff --git a/osu.Game.Rulesets.Taiko.Tests/osu.Game.Rulesets.Taiko.Tests.csproj b/osu.Game.Rulesets.Taiko.Tests/osu.Game.Rulesets.Taiko.Tests.csproj
index debddae037..a6b8eb8651 100644
--- a/osu.Game.Rulesets.Taiko.Tests/osu.Game.Rulesets.Taiko.Tests.csproj
+++ b/osu.Game.Rulesets.Taiko.Tests/osu.Game.Rulesets.Taiko.Tests.csproj
@@ -4,7 +4,7 @@
     <PackageReference Include="Appveyor.TestLogger" Version="2.0.0" />
     <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.0.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
-    <PackageReference Include="NUnit3TestAdapter" Version="4.2.1" />
+    <PackageReference Include="NUnit3TestAdapter" Version="4.1.0" />
     <PackageReference Update="Microsoft.EntityFrameworkCore.Sqlite" Version="2.1.4" />
   </ItemGroup>
   <PropertyGroup Label="Project">
diff --git a/osu.Game.Tests/osu.Game.Tests.csproj b/osu.Game.Tests/osu.Game.Tests.csproj
index 40969c8b29..acf1e8470b 100644
--- a/osu.Game.Tests/osu.Game.Tests.csproj
+++ b/osu.Game.Tests/osu.Game.Tests.csproj
@@ -6,7 +6,7 @@
     <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.0.0" />
     <PackageReference Include="Nito.AsyncEx" Version="5.1.2" />
     <PackageReference Include="NUnit" Version="3.13.2" />
-    <PackageReference Include="NUnit3TestAdapter" Version="4.2.1" />
+    <PackageReference Include="NUnit3TestAdapter" Version="4.1.0" />
     <PackageReference Update="Microsoft.EntityFrameworkCore.Sqlite" Version="2.1.4" />
     <PackageReference Include="Moq" Version="4.16.1" />
   </ItemGroup>
diff --git a/osu.Game.Tournament.Tests/osu.Game.Tournament.Tests.csproj b/osu.Game.Tournament.Tests/osu.Game.Tournament.Tests.csproj
index 9fd73f2c1b..c7314a4969 100644
--- a/osu.Game.Tournament.Tests/osu.Game.Tournament.Tests.csproj
+++ b/osu.Game.Tournament.Tests/osu.Game.Tournament.Tests.csproj
@@ -7,7 +7,7 @@
     <PackageReference Include="Appveyor.TestLogger" Version="2.0.0" />
     <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.0.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
-    <PackageReference Include="NUnit3TestAdapter" Version="4.2.1" />
+    <PackageReference Include="NUnit3TestAdapter" Version="4.1.0" />
   </ItemGroup>
   <PropertyGroup Label="Project">
     <OutputType>WinExe</OutputType>

From 03106e846c6a6a70c944253a333aa922c1c2bde7 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 15 Feb 2022 17:13:31 +0900
Subject: [PATCH 2913/5547] Fix test failures due to async mod icon loads

---
 .../Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs   | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs
index 4dd3427bee..7c18ed2572 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs
@@ -173,7 +173,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             ClickButtonWhenEnabled<RoomSubScreen.UserModSelectButton>();
 
-            AddAssert("mod select contains only double time mod", () => this.ChildrenOfType<UserModSelectOverlay>().Single().ChildrenOfType<ModButton>().Single().Mod is OsuModDoubleTime);
+            AddUntilStep("mod select contains only double time mod",
+                () => this.ChildrenOfType<UserModSelectOverlay>().SingleOrDefault()?.ChildrenOfType<ModButton>().SingleOrDefault()?.Mod is OsuModDoubleTime);
         }
     }
 }

From b2276baf71bf461c0ba67d2ca6eb634c1ba9299a Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 15 Feb 2022 20:55:56 +0900
Subject: [PATCH 2914/5547] Seal OnlinePlayTestScene.CreateChildDependencies()

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

diff --git a/osu.Game/Tests/Visual/OnlinePlay/OnlinePlayTestScene.cs b/osu.Game/Tests/Visual/OnlinePlay/OnlinePlayTestScene.cs
index 430aae72f8..df2b4f6192 100644
--- a/osu.Game/Tests/Visual/OnlinePlay/OnlinePlayTestScene.cs
+++ b/osu.Game/Tests/Visual/OnlinePlay/OnlinePlayTestScene.cs
@@ -46,7 +46,7 @@ namespace osu.Game.Tests.Visual.OnlinePlay
             });
         }
 
-        protected override IReadOnlyDependencyContainer CreateChildDependencies(IReadOnlyDependencyContainer parent)
+        protected sealed override IReadOnlyDependencyContainer CreateChildDependencies(IReadOnlyDependencyContainer parent)
         {
             dependencies = new DelegatedDependencyContainer(base.CreateChildDependencies(parent));
             return dependencies;

From c48a0dc993e4b5621ba9f92625f486d93229ea94 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 15 Feb 2022 20:56:46 +0900
Subject: [PATCH 2915/5547] Move UserLookupCache to online play test
 dependencies

---
 .../Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs  | 4 ++--
 .../TestSceneMultiplayerGameplayLeaderboardTeams.cs         | 2 +-
 .../Visual/Multiplayer/IMultiplayerTestSceneDependencies.cs | 6 ------
 osu.Game/Tests/Visual/Multiplayer/MultiplayerTestScene.cs   | 1 -
 .../Visual/Multiplayer/MultiplayerTestSceneDependencies.cs  | 4 ----
 .../Visual/OnlinePlay/IOnlinePlayTestSceneDependencies.cs   | 5 +++++
 osu.Game/Tests/Visual/OnlinePlay/OnlinePlayTestScene.cs     | 1 +
 .../Visual/OnlinePlay/OnlinePlayTestSceneDependencies.cs    | 4 ++++
 8 files changed, 13 insertions(+), 14 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs
index 1322fbc96e..437f4e3308 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs
@@ -44,7 +44,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             base.SetUpSteps();
 
-            AddStep("set local user", () => ((DummyAPIAccess)API).LocalUser.Value = LookupCache.GetUserAsync(1).GetResultSafely());
+            AddStep("set local user", () => ((DummyAPIAccess)API).LocalUser.Value = UserLookupCache.GetUserAsync(1).GetResultSafely());
 
             AddStep("create leaderboard", () =>
             {
@@ -91,7 +91,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         public void TestUserQuit()
         {
             foreach (int user in users)
-                AddStep($"mark user {user} quit", () => Client.RemoveUser(LookupCache.GetUserAsync(user).GetResultSafely().AsNonNull()));
+                AddStep($"mark user {user} quit", () => Client.RemoveUser(UserLookupCache.GetUserAsync(user).GetResultSafely().AsNonNull()));
         }
 
         [Test]
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboardTeams.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboardTeams.cs
index 8a78c12042..cd3ae50dab 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboardTeams.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboardTeams.cs
@@ -48,7 +48,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             base.SetUpSteps();
 
-            AddStep("set local user", () => ((DummyAPIAccess)API).LocalUser.Value = LookupCache.GetUserAsync(1).GetResultSafely());
+            AddStep("set local user", () => ((DummyAPIAccess)API).LocalUser.Value = UserLookupCache.GetUserAsync(1).GetResultSafely());
 
             AddStep("create leaderboard", () =>
             {
diff --git a/osu.Game/Tests/Visual/Multiplayer/IMultiplayerTestSceneDependencies.cs b/osu.Game/Tests/Visual/Multiplayer/IMultiplayerTestSceneDependencies.cs
index 204c189591..f166154103 100644
--- a/osu.Game/Tests/Visual/Multiplayer/IMultiplayerTestSceneDependencies.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/IMultiplayerTestSceneDependencies.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.Game.Database;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Screens.OnlinePlay;
 using osu.Game.Tests.Visual.OnlinePlay;
@@ -24,11 +23,6 @@ namespace osu.Game.Tests.Visual.Multiplayer
         /// </summary>
         new TestMultiplayerRoomManager RoomManager { get; }
 
-        /// <summary>
-        /// The cached <see cref="UserLookupCache"/>.
-        /// </summary>
-        TestUserLookupCache LookupCache { get; }
-
         /// <summary>
         /// The cached <see cref="osu.Game.Online.Spectator.SpectatorClient"/>.
         /// </summary>
diff --git a/osu.Game/Tests/Visual/Multiplayer/MultiplayerTestScene.cs b/osu.Game/Tests/Visual/Multiplayer/MultiplayerTestScene.cs
index ed86d572b9..a9b3ca4991 100644
--- a/osu.Game/Tests/Visual/Multiplayer/MultiplayerTestScene.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/MultiplayerTestScene.cs
@@ -19,7 +19,6 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
         public TestMultiplayerClient Client => OnlinePlayDependencies.Client;
         public new TestMultiplayerRoomManager RoomManager => OnlinePlayDependencies.RoomManager;
-        public TestUserLookupCache LookupCache => OnlinePlayDependencies?.LookupCache;
         public TestSpectatorClient SpectatorClient => OnlinePlayDependencies?.SpectatorClient;
 
         protected new MultiplayerTestSceneDependencies OnlinePlayDependencies => (MultiplayerTestSceneDependencies)base.OnlinePlayDependencies;
diff --git a/osu.Game/Tests/Visual/Multiplayer/MultiplayerTestSceneDependencies.cs b/osu.Game/Tests/Visual/Multiplayer/MultiplayerTestSceneDependencies.cs
index ed349a7103..d9fe77ae44 100644
--- a/osu.Game/Tests/Visual/Multiplayer/MultiplayerTestSceneDependencies.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/MultiplayerTestSceneDependencies.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.Game.Database;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Spectator;
 using osu.Game.Screens.OnlinePlay;
@@ -16,18 +15,15 @@ namespace osu.Game.Tests.Visual.Multiplayer
     public class MultiplayerTestSceneDependencies : OnlinePlayTestSceneDependencies, IMultiplayerTestSceneDependencies
     {
         public TestMultiplayerClient Client { get; }
-        public TestUserLookupCache LookupCache { get; }
         public TestSpectatorClient SpectatorClient { get; }
         public new TestMultiplayerRoomManager RoomManager => (TestMultiplayerRoomManager)base.RoomManager;
 
         public MultiplayerTestSceneDependencies()
         {
             Client = new TestMultiplayerClient(RoomManager);
-            LookupCache = new TestUserLookupCache();
             SpectatorClient = CreateSpectatorClient();
 
             CacheAs<MultiplayerClient>(Client);
-            CacheAs<UserLookupCache>(LookupCache);
             CacheAs<SpectatorClient>(SpectatorClient);
         }
 
diff --git a/osu.Game/Tests/Visual/OnlinePlay/IOnlinePlayTestSceneDependencies.cs b/osu.Game/Tests/Visual/OnlinePlay/IOnlinePlayTestSceneDependencies.cs
index 71acefb158..feb9b55743 100644
--- a/osu.Game/Tests/Visual/OnlinePlay/IOnlinePlayTestSceneDependencies.cs
+++ b/osu.Game/Tests/Visual/OnlinePlay/IOnlinePlayTestSceneDependencies.cs
@@ -31,5 +31,10 @@ namespace osu.Game.Tests.Visual.OnlinePlay
         /// The cached <see cref="OnlinePlayBeatmapAvailabilityTracker"/>.
         /// </summary>
         OnlinePlayBeatmapAvailabilityTracker AvailabilityTracker { get; }
+
+        /// <summary>
+        /// The cached <see cref="UserLookupCache"/>.
+        /// </summary>
+        TestUserLookupCache UserLookupCache { get; }
     }
 }
diff --git a/osu.Game/Tests/Visual/OnlinePlay/OnlinePlayTestScene.cs b/osu.Game/Tests/Visual/OnlinePlay/OnlinePlayTestScene.cs
index df2b4f6192..99a492cd6d 100644
--- a/osu.Game/Tests/Visual/OnlinePlay/OnlinePlayTestScene.cs
+++ b/osu.Game/Tests/Visual/OnlinePlay/OnlinePlayTestScene.cs
@@ -22,6 +22,7 @@ namespace osu.Game.Tests.Visual.OnlinePlay
         public IRoomManager RoomManager => OnlinePlayDependencies?.RoomManager;
         public OngoingOperationTracker OngoingOperationTracker => OnlinePlayDependencies?.OngoingOperationTracker;
         public OnlinePlayBeatmapAvailabilityTracker AvailabilityTracker => OnlinePlayDependencies?.AvailabilityTracker;
+        public TestUserLookupCache UserLookupCache => OnlinePlayDependencies?.UserLookupCache;
 
         /// <summary>
         /// All dependencies required for online play components and screens.
diff --git a/osu.Game/Tests/Visual/OnlinePlay/OnlinePlayTestSceneDependencies.cs b/osu.Game/Tests/Visual/OnlinePlay/OnlinePlayTestSceneDependencies.cs
index 24c4ff79d4..47893519c7 100644
--- a/osu.Game/Tests/Visual/OnlinePlay/OnlinePlayTestSceneDependencies.cs
+++ b/osu.Game/Tests/Visual/OnlinePlay/OnlinePlayTestSceneDependencies.cs
@@ -6,6 +6,7 @@ using System.Collections.Generic;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
+using osu.Game.Database;
 using osu.Game.Online.Rooms;
 using osu.Game.Overlays;
 using osu.Game.Screens.OnlinePlay;
@@ -22,6 +23,7 @@ namespace osu.Game.Tests.Visual.OnlinePlay
         public OngoingOperationTracker OngoingOperationTracker { get; }
         public OnlinePlayBeatmapAvailabilityTracker AvailabilityTracker { get; }
         public TestRoomRequestsHandler RequestsHandler { get; }
+        public TestUserLookupCache UserLookupCache { get; }
 
         /// <summary>
         /// All cached dependencies which are also <see cref="Drawable"/> components.
@@ -38,6 +40,7 @@ namespace osu.Game.Tests.Visual.OnlinePlay
             OngoingOperationTracker = new OngoingOperationTracker();
             AvailabilityTracker = new OnlinePlayBeatmapAvailabilityTracker();
             RoomManager = CreateRoomManager();
+            UserLookupCache = new TestUserLookupCache();
 
             dependencies = new DependencyContainer(new CachedModelDependencyContainer<Room>(null) { Model = { BindTarget = SelectedRoom } });
 
@@ -47,6 +50,7 @@ namespace osu.Game.Tests.Visual.OnlinePlay
             CacheAs(OngoingOperationTracker);
             CacheAs(AvailabilityTracker);
             CacheAs(new OverlayColourProvider(OverlayColourScheme.Plum));
+            CacheAs<UserLookupCache>(UserLookupCache);
         }
 
         public object Get(Type type)

From 2675bb87ff3009322be4dcad2e3244ef33425fd3 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 15 Feb 2022 21:05:05 +0900
Subject: [PATCH 2916/5547] Add BeatmapLookupCache as another dependency

---
 .../Visual/OnlinePlay/IOnlinePlayTestSceneDependencies.cs   | 6 ++++++
 osu.Game/Tests/Visual/OnlinePlay/OnlinePlayTestScene.cs     | 2 ++
 .../Visual/OnlinePlay/OnlinePlayTestSceneDependencies.cs    | 3 +++
 3 files changed, 11 insertions(+)

diff --git a/osu.Game/Tests/Visual/OnlinePlay/IOnlinePlayTestSceneDependencies.cs b/osu.Game/Tests/Visual/OnlinePlay/IOnlinePlayTestSceneDependencies.cs
index feb9b55743..c94e288e11 100644
--- a/osu.Game/Tests/Visual/OnlinePlay/IOnlinePlayTestSceneDependencies.cs
+++ b/osu.Game/Tests/Visual/OnlinePlay/IOnlinePlayTestSceneDependencies.cs
@@ -2,6 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using osu.Framework.Bindables;
+using osu.Game.Database;
 using osu.Game.Online.Rooms;
 using osu.Game.Screens.OnlinePlay;
 
@@ -36,5 +37,10 @@ namespace osu.Game.Tests.Visual.OnlinePlay
         /// The cached <see cref="UserLookupCache"/>.
         /// </summary>
         TestUserLookupCache UserLookupCache { get; }
+
+        /// <summary>
+        /// The cached <see cref="BeatmapLookupCache"/>.
+        /// </summary>
+        BeatmapLookupCache BeatmapLookupCache { get; }
     }
 }
diff --git a/osu.Game/Tests/Visual/OnlinePlay/OnlinePlayTestScene.cs b/osu.Game/Tests/Visual/OnlinePlay/OnlinePlayTestScene.cs
index 99a492cd6d..baff7c168f 100644
--- a/osu.Game/Tests/Visual/OnlinePlay/OnlinePlayTestScene.cs
+++ b/osu.Game/Tests/Visual/OnlinePlay/OnlinePlayTestScene.cs
@@ -7,6 +7,7 @@ using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
+using osu.Game.Database;
 using osu.Game.Online.API;
 using osu.Game.Online.Rooms;
 using osu.Game.Screens.OnlinePlay;
@@ -23,6 +24,7 @@ namespace osu.Game.Tests.Visual.OnlinePlay
         public OngoingOperationTracker OngoingOperationTracker => OnlinePlayDependencies?.OngoingOperationTracker;
         public OnlinePlayBeatmapAvailabilityTracker AvailabilityTracker => OnlinePlayDependencies?.AvailabilityTracker;
         public TestUserLookupCache UserLookupCache => OnlinePlayDependencies?.UserLookupCache;
+        public BeatmapLookupCache BeatmapLookupCache => OnlinePlayDependencies?.BeatmapLookupCache;
 
         /// <summary>
         /// All dependencies required for online play components and screens.
diff --git a/osu.Game/Tests/Visual/OnlinePlay/OnlinePlayTestSceneDependencies.cs b/osu.Game/Tests/Visual/OnlinePlay/OnlinePlayTestSceneDependencies.cs
index 47893519c7..7c8bc2d535 100644
--- a/osu.Game/Tests/Visual/OnlinePlay/OnlinePlayTestSceneDependencies.cs
+++ b/osu.Game/Tests/Visual/OnlinePlay/OnlinePlayTestSceneDependencies.cs
@@ -24,6 +24,7 @@ namespace osu.Game.Tests.Visual.OnlinePlay
         public OnlinePlayBeatmapAvailabilityTracker AvailabilityTracker { get; }
         public TestRoomRequestsHandler RequestsHandler { get; }
         public TestUserLookupCache UserLookupCache { get; }
+        public BeatmapLookupCache BeatmapLookupCache { get; }
 
         /// <summary>
         /// All cached dependencies which are also <see cref="Drawable"/> components.
@@ -41,6 +42,7 @@ namespace osu.Game.Tests.Visual.OnlinePlay
             AvailabilityTracker = new OnlinePlayBeatmapAvailabilityTracker();
             RoomManager = CreateRoomManager();
             UserLookupCache = new TestUserLookupCache();
+            BeatmapLookupCache = new BeatmapLookupCache();
 
             dependencies = new DependencyContainer(new CachedModelDependencyContainer<Room>(null) { Model = { BindTarget = SelectedRoom } });
 
@@ -51,6 +53,7 @@ namespace osu.Game.Tests.Visual.OnlinePlay
             CacheAs(AvailabilityTracker);
             CacheAs(new OverlayColourProvider(OverlayColourScheme.Plum));
             CacheAs<UserLookupCache>(UserLookupCache);
+            CacheAs(BeatmapLookupCache);
         }
 
         public object Get(Type type)

From 539cbe62c6be88f6da5b6cabc1df39f845f8b58b Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 15 Feb 2022 21:08:27 +0900
Subject: [PATCH 2917/5547] Fix incorrect usages of user lookup cache in tests

---
 .../Visual/Gameplay/TestSceneSpectator.cs     | 25 +++++++++----------
 .../Visual/Multiplayer/QueueModeTestScene.cs  |  4 ---
 .../TestSceneDrawableRoomPlaylist.cs          |  5 +---
 .../Multiplayer/TestSceneMultiplayer.cs       |  4 ---
 .../TestSceneMultiplayerQueueList.cs          |  4 ---
 .../TestScenePlaylistsRoomSettingsPlaylist.cs |  8 ++----
 .../Visual/Multiplayer/TestSceneTeamVersus.cs |  4 ---
 .../Visual/TestMultiplayerComponents.cs       |  9 +++++++
 8 files changed, 24 insertions(+), 39 deletions(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs
index 157c248d69..6dca256d31 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs
@@ -39,7 +39,8 @@ namespace osu.Game.Tests.Visual.Gameplay
         [Resolved]
         private OsuGameBase game { get; set; }
 
-        private TestSpectatorClient spectatorClient;
+        private TestSpectatorClient spectatorClient => dependenciesScreen.Client;
+        private DependenciesScreen dependenciesScreen;
         private SoloSpectator spectatorScreen;
 
         private BeatmapSetInfo importedBeatmap;
@@ -48,16 +49,16 @@ namespace osu.Game.Tests.Visual.Gameplay
         [SetUpSteps]
         public void SetupSteps()
         {
-            DependenciesScreen dependenciesScreen = null;
-
             AddStep("load dependencies", () =>
             {
-                spectatorClient = new TestSpectatorClient();
+                LoadScreen(dependenciesScreen = new DependenciesScreen());
 
-                // The screen gets suspended so it stops receiving updates.
-                Child = spectatorClient;
-
-                LoadScreen(dependenciesScreen = new DependenciesScreen(spectatorClient));
+                // The dependencies screen gets suspended so it stops receiving updates. So its children are manually added to the test scene instead.
+                Children = new Drawable[]
+                {
+                    dependenciesScreen.UserLookupCache,
+                    dependenciesScreen.Client,
+                };
             });
 
             AddUntilStep("wait for dependencies to load", () => dependenciesScreen.IsLoaded);
@@ -335,12 +336,10 @@ namespace osu.Game.Tests.Visual.Gameplay
         private class DependenciesScreen : OsuScreen
         {
             [Cached(typeof(SpectatorClient))]
-            public readonly TestSpectatorClient Client;
+            public readonly TestSpectatorClient Client = new TestSpectatorClient();
 
-            public DependenciesScreen(TestSpectatorClient client)
-            {
-                Client = client;
-            }
+            [Cached(typeof(UserLookupCache))]
+            public readonly TestUserLookupCache UserLookupCache = new TestUserLookupCache();
         }
     }
 }
diff --git a/osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs b/osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs
index 36d6c6a306..52801dd57a 100644
--- a/osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs
@@ -10,7 +10,6 @@ using osu.Framework.Platform;
 using osu.Framework.Screens;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
-using osu.Game.Database;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Rooms;
 using osu.Game.Rulesets;
@@ -41,9 +40,6 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
         protected TestMultiplayerClient Client => multiplayerComponents.Client;
 
-        [Cached(typeof(UserLookupCache))]
-        private UserLookupCache lookupCache = new TestUserLookupCache();
-
         [BackgroundDependencyLoader]
         private void load(GameHost host, AudioManager audio)
         {
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
index 659cc22350..8c10a0d0d9 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
@@ -30,16 +30,13 @@ using osuTK.Input;
 
 namespace osu.Game.Tests.Visual.Multiplayer
 {
-    public class TestSceneDrawableRoomPlaylist : OsuManualInputManagerTestScene
+    public class TestSceneDrawableRoomPlaylist : MultiplayerTestScene
     {
         private TestPlaylist playlist;
 
         private BeatmapManager manager;
         private RulesetStore rulesets;
 
-        [Cached(typeof(UserLookupCache))]
-        private readonly TestUserLookupCache userLookupCache = new TestUserLookupCache();
-
         [BackgroundDependencyLoader]
         private void load(GameHost host, AudioManager audio)
         {
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
index 41715f6cfb..b04bf5e860 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
@@ -17,7 +17,6 @@ using osu.Framework.Screens;
 using osu.Framework.Testing;
 using osu.Framework.Utils;
 using osu.Game.Beatmaps;
-using osu.Game.Database;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests.Responses;
@@ -56,9 +55,6 @@ namespace osu.Game.Tests.Visual.Multiplayer
         private TestMultiplayerClient client => multiplayerComponents.Client;
         private TestMultiplayerRoomManager roomManager => multiplayerComponents.RoomManager;
 
-        [Cached(typeof(UserLookupCache))]
-        private UserLookupCache lookupCache = new TestUserLookupCache();
-
         [BackgroundDependencyLoader]
         private void load(GameHost host, AudioManager audio)
         {
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs
index ddf794b437..4040707c41 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs
@@ -12,7 +12,6 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Platform;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
-using osu.Game.Database;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Rooms;
@@ -26,9 +25,6 @@ namespace osu.Game.Tests.Visual.Multiplayer
 {
     public class TestSceneMultiplayerQueueList : MultiplayerTestScene
     {
-        [Cached(typeof(UserLookupCache))]
-        private readonly TestUserLookupCache userLookupCache = new TestUserLookupCache();
-
         private MultiplayerQueueList playlist;
         private BeatmapManager beatmaps;
         private RulesetStore rulesets;
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsRoomSettingsPlaylist.cs b/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsRoomSettingsPlaylist.cs
index 8bfdda29d5..9adf2c0370 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsRoomSettingsPlaylist.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsRoomSettingsPlaylist.cs
@@ -4,13 +4,11 @@
 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.Framework.Testing;
 using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.Drawables;
-using osu.Game.Database;
 using osu.Game.Graphics.Containers;
 using osu.Game.Models;
 using osu.Game.Online.API;
@@ -20,18 +18,16 @@ using osu.Game.Rulesets.Osu.Mods;
 using osu.Game.Screens.OnlinePlay;
 using osu.Game.Screens.OnlinePlay.Playlists;
 using osu.Game.Tests.Beatmaps;
+using osu.Game.Tests.Visual.OnlinePlay;
 using osuTK;
 using osuTK.Input;
 
 namespace osu.Game.Tests.Visual.Multiplayer
 {
-    public class TestScenePlaylistsRoomSettingsPlaylist : OsuManualInputManagerTestScene
+    public class TestScenePlaylistsRoomSettingsPlaylist : OnlinePlayTestScene
     {
         private TestPlaylist playlist;
 
-        [Cached(typeof(UserLookupCache))]
-        private readonly TestUserLookupCache userLookupCache = new TestUserLookupCache();
-
         [Test]
         public void TestItemRemovedOnDeletion()
         {
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs
index 513c1413fa..b66657728e 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs
@@ -10,7 +10,6 @@ using osu.Framework.Extensions;
 using osu.Framework.Platform;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
-using osu.Game.Database;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Multiplayer.MatchTypes.TeamVersus;
@@ -36,9 +35,6 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
         private TestMultiplayerClient client => multiplayerComponents.Client;
 
-        [Cached(typeof(UserLookupCache))]
-        private UserLookupCache lookupCache = new TestUserLookupCache();
-
         [BackgroundDependencyLoader]
         private void load(GameHost host, AudioManager audio)
         {
diff --git a/osu.Game.Tests/Visual/TestMultiplayerComponents.cs b/osu.Game.Tests/Visual/TestMultiplayerComponents.cs
index cd7a936778..bd8fb8e58e 100644
--- a/osu.Game.Tests/Visual/TestMultiplayerComponents.cs
+++ b/osu.Game.Tests/Visual/TestMultiplayerComponents.cs
@@ -4,6 +4,7 @@
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Screens;
+using osu.Game.Database;
 using osu.Game.Online.API;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Screens;
@@ -39,6 +40,12 @@ namespace osu.Game.Tests.Visual
         [Cached(typeof(MultiplayerClient))]
         public readonly TestMultiplayerClient Client;
 
+        [Cached(typeof(UserLookupCache))]
+        private readonly UserLookupCache userLookupCache = new TestUserLookupCache();
+
+        [Cached]
+        private readonly BeatmapLookupCache beatmapLookupCache = new BeatmapLookupCache();
+
         private readonly OsuScreenStack screenStack;
         private readonly TestMultiplayer multiplayerScreen;
 
@@ -48,6 +55,8 @@ namespace osu.Game.Tests.Visual
 
             InternalChildren = new Drawable[]
             {
+                userLookupCache,
+                beatmapLookupCache,
                 Client = new TestMultiplayerClient(RoomManager),
                 screenStack = new OsuScreenStack
                 {

From a5183cec77caaa7a8fdb64a8d7a8a7418b7c7f42 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 15 Feb 2022 21:53:56 +0900
Subject: [PATCH 2918/5547] Add helper to construct APIBeatmap

---
 osu.Game/Tests/Visual/OsuTestScene.cs | 62 ++++++++++++++++-----------
 1 file changed, 36 insertions(+), 26 deletions(-)

diff --git a/osu.Game/Tests/Visual/OsuTestScene.cs b/osu.Game/Tests/Visual/OsuTestScene.cs
index ec02655544..f287a04d71 100644
--- a/osu.Game/Tests/Visual/OsuTestScene.cs
+++ b/osu.Game/Tests/Visual/OsuTestScene.cs
@@ -225,12 +225,24 @@ namespace osu.Game.Tests.Visual
         protected virtual IBeatmap CreateBeatmap(RulesetInfo ruleset) => new TestBeatmap(ruleset);
 
         /// <summary>
-        /// Returns a sample API Beatmap with BeatmapSet populated.
+        /// Returns a sample API beatmap with a populated beatmap set.
         /// </summary>
         /// <param name="ruleset">The ruleset to create the sample model using. osu! ruleset will be used if not specified.</param>
-        protected APIBeatmap CreateAPIBeatmap(RulesetInfo ruleset = null)
+        protected APIBeatmap CreateAPIBeatmap(RulesetInfo ruleset = null) => CreateAPIBeatmap(CreateBeatmap(ruleset ?? Ruleset.Value).BeatmapInfo);
+
+        /// <summary>
+        /// Constructs a sample API beatmap set containing a beatmap.
+        /// </summary>
+        /// <param name="ruleset">The ruleset to create the sample model using. osu! ruleset will be used if not specified.</param>
+        protected APIBeatmapSet CreateAPIBeatmapSet(RulesetInfo ruleset = null) => CreateAPIBeatmapSet(CreateBeatmap(ruleset ?? Ruleset.Value).BeatmapInfo);
+
+        /// <summary>
+        /// Constructs a sample API beatmap with a populated beatmap set from a given source beatmap.
+        /// </summary>
+        /// <param name="original">The source beatmap.</param>
+        public static APIBeatmap CreateAPIBeatmap(IBeatmapInfo original)
         {
-            var beatmapSet = CreateAPIBeatmapSet(ruleset ?? Ruleset.Value);
+            var beatmapSet = CreateAPIBeatmapSet(original);
 
             // Avoid circular reference.
             var beatmap = beatmapSet.Beatmaps.First();
@@ -243,18 +255,16 @@ namespace osu.Game.Tests.Visual
         }
 
         /// <summary>
-        /// Returns a sample API BeatmapSet with beatmaps populated.
+        /// Constructs a sample API beatmap set containing a beatmap from a given source beatmap.
         /// </summary>
-        /// <param name="ruleset">The ruleset to create the sample model using. osu! ruleset will be used if not specified.</param>
-        protected APIBeatmapSet CreateAPIBeatmapSet(RulesetInfo ruleset = null)
+        /// <param name="original">The source beatmap.</param>
+        public static APIBeatmapSet CreateAPIBeatmapSet(IBeatmapInfo original)
         {
-            var beatmap = CreateBeatmap(ruleset ?? Ruleset.Value).BeatmapInfo;
-
-            Debug.Assert(beatmap.BeatmapSet != null);
+            Debug.Assert(original.BeatmapSet != null);
 
             return new APIBeatmapSet
             {
-                OnlineID = ((IBeatmapSetInfo)beatmap.BeatmapSet).OnlineID,
+                OnlineID = original.BeatmapSet.OnlineID,
                 Status = BeatmapOnlineStatus.Ranked,
                 Covers = new BeatmapSetOnlineCovers
                 {
@@ -262,29 +272,29 @@ namespace osu.Game.Tests.Visual
                     Card = "https://assets.ppy.sh/beatmaps/163112/covers/card.jpg",
                     List = "https://assets.ppy.sh/beatmaps/163112/covers/list.jpg"
                 },
-                Title = beatmap.Metadata.Title,
-                TitleUnicode = beatmap.Metadata.TitleUnicode,
-                Artist = beatmap.Metadata.Artist,
-                ArtistUnicode = beatmap.Metadata.ArtistUnicode,
+                Title = original.Metadata.Title,
+                TitleUnicode = original.Metadata.TitleUnicode,
+                Artist = original.Metadata.Artist,
+                ArtistUnicode = original.Metadata.ArtistUnicode,
                 Author = new APIUser
                 {
-                    Username = beatmap.Metadata.Author.Username,
-                    Id = beatmap.Metadata.Author.OnlineID
+                    Username = original.Metadata.Author.Username,
+                    Id = original.Metadata.Author.OnlineID
                 },
-                Source = beatmap.Metadata.Source,
-                Tags = beatmap.Metadata.Tags,
+                Source = original.Metadata.Source,
+                Tags = original.Metadata.Tags,
                 Beatmaps = new[]
                 {
                     new APIBeatmap
                     {
-                        OnlineID = ((IBeatmapInfo)beatmap).OnlineID,
-                        OnlineBeatmapSetID = ((IBeatmapSetInfo)beatmap.BeatmapSet).OnlineID,
-                        Status = beatmap.Status,
-                        Checksum = beatmap.MD5Hash,
-                        AuthorID = beatmap.Metadata.Author.OnlineID,
-                        RulesetID = beatmap.Ruleset.OnlineID,
-                        StarRating = beatmap.StarRating,
-                        DifficultyName = beatmap.DifficultyName,
+                        OnlineID = original.OnlineID,
+                        OnlineBeatmapSetID = original.BeatmapSet.OnlineID,
+                        Status = ((BeatmapInfo)original).Status,
+                        Checksum = original.MD5Hash,
+                        AuthorID = original.Metadata.Author.OnlineID,
+                        RulesetID = original.Ruleset.OnlineID,
+                        StarRating = original.StarRating,
+                        DifficultyName = original.DifficultyName,
                     }
                 }
             };

From ccd265ebe7237e50ecb7241dca5e3f3703b47a86 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 15 Feb 2022 22:02:33 +0900
Subject: [PATCH 2919/5547] Handle beatmap lookup requests in
 TestRoomRequestsHandler

---
 .../Visual/TestMultiplayerComponents.cs       |  8 ++++--
 .../Online/API/Requests/GetBeatmapsRequest.cs |  6 ++--
 .../Visual/OnlinePlay/OnlinePlayTestScene.cs  | 11 +++++---
 .../OnlinePlay/TestRoomRequestsHandler.cs     | 28 +++++++++++++++++--
 4 files changed, 42 insertions(+), 11 deletions(-)

diff --git a/osu.Game.Tests/Visual/TestMultiplayerComponents.cs b/osu.Game.Tests/Visual/TestMultiplayerComponents.cs
index bd8fb8e58e..2e551947b6 100644
--- a/osu.Game.Tests/Visual/TestMultiplayerComponents.cs
+++ b/osu.Game.Tests/Visual/TestMultiplayerComponents.cs
@@ -5,6 +5,7 @@ using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Screens;
 using osu.Game.Database;
+using osu.Game.Beatmaps;
 using osu.Game.Online.API;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Screens;
@@ -46,6 +47,9 @@ namespace osu.Game.Tests.Visual
         [Cached]
         private readonly BeatmapLookupCache beatmapLookupCache = new BeatmapLookupCache();
 
+        [Resolved]
+        private BeatmapManager beatmapManager { get; set; }
+
         private readonly OsuScreenStack screenStack;
         private readonly TestMultiplayer multiplayerScreen;
 
@@ -69,9 +73,9 @@ namespace osu.Game.Tests.Visual
         }
 
         [BackgroundDependencyLoader]
-        private void load(IAPIProvider api, OsuGameBase game)
+        private void load(IAPIProvider api)
         {
-            ((DummyAPIAccess)api).HandleRequest = request => multiplayerScreen.RequestsHandler.HandleRequest(request, api.LocalUser.Value, game);
+            ((DummyAPIAccess)api).HandleRequest = request => multiplayerScreen.RequestsHandler.HandleRequest(request, api.LocalUser.Value, beatmapManager);
         }
 
         public override bool OnBackButton() => (screenStack.CurrentScreen as OsuScreen)?.OnBackButton() ?? base.OnBackButton();
diff --git a/osu.Game/Online/API/Requests/GetBeatmapsRequest.cs b/osu.Game/Online/API/Requests/GetBeatmapsRequest.cs
index 1d71e22b77..c07e5ef1c2 100644
--- a/osu.Game/Online/API/Requests/GetBeatmapsRequest.cs
+++ b/osu.Game/Online/API/Requests/GetBeatmapsRequest.cs
@@ -7,7 +7,7 @@ namespace osu.Game.Online.API.Requests
 {
     public class GetBeatmapsRequest : APIRequest<GetBeatmapsResponse>
     {
-        private readonly int[] beatmapIds;
+        public readonly int[] BeatmapIds;
 
         private const int max_ids_per_request = 50;
 
@@ -16,9 +16,9 @@ namespace osu.Game.Online.API.Requests
             if (beatmapIds.Length > max_ids_per_request)
                 throw new ArgumentException($"{nameof(GetBeatmapsRequest)} calls only support up to {max_ids_per_request} IDs at once");
 
-            this.beatmapIds = beatmapIds;
+            BeatmapIds = beatmapIds;
         }
 
-        protected override string Target => "beatmaps/?ids[]=" + string.Join("&ids[]=", beatmapIds);
+        protected override string Target => "beatmaps/?ids[]=" + string.Join("&ids[]=", BeatmapIds);
     }
 }
diff --git a/osu.Game/Tests/Visual/OnlinePlay/OnlinePlayTestScene.cs b/osu.Game/Tests/Visual/OnlinePlay/OnlinePlayTestScene.cs
index baff7c168f..448ec5e3d9 100644
--- a/osu.Game/Tests/Visual/OnlinePlay/OnlinePlayTestScene.cs
+++ b/osu.Game/Tests/Visual/OnlinePlay/OnlinePlayTestScene.cs
@@ -8,6 +8,7 @@ using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Database;
+using osu.Game.Beatmaps;
 using osu.Game.Online.API;
 using osu.Game.Online.Rooms;
 using osu.Game.Screens.OnlinePlay;
@@ -33,9 +34,6 @@ namespace osu.Game.Tests.Visual.OnlinePlay
 
         protected override Container<Drawable> Content => content;
 
-        [Resolved]
-        private OsuGameBase game { get; set; }
-
         private readonly Container content;
         private readonly Container drawableDependenciesContainer;
         private DelegatedDependencyContainer dependencies;
@@ -71,7 +69,12 @@ namespace osu.Game.Tests.Visual.OnlinePlay
             AddStep("setup API", () =>
             {
                 var handler = OnlinePlayDependencies.RequestsHandler;
-                ((DummyAPIAccess)API).HandleRequest = request => handler.HandleRequest(request, API.LocalUser.Value, game);
+
+                // Resolving the BeatmapManager in the test scene will inject the game-wide BeatmapManager, while many test scenes cache their own BeatmapManager instead.
+                // To get around this, the BeatmapManager is looked up from the dependencies provided to the children of the test scene instead.
+                var beatmapManager = dependencies.Get<BeatmapManager>();
+
+                ((DummyAPIAccess)API).HandleRequest = request => handler.HandleRequest(request, API.LocalUser.Value, beatmapManager);
             });
         }
 
diff --git a/osu.Game/Tests/Visual/OnlinePlay/TestRoomRequestsHandler.cs b/osu.Game/Tests/Visual/OnlinePlay/TestRoomRequestsHandler.cs
index 5a0a7e71d4..8290af8f78 100644
--- a/osu.Game/Tests/Visual/OnlinePlay/TestRoomRequestsHandler.cs
+++ b/osu.Game/Tests/Visual/OnlinePlay/TestRoomRequestsHandler.cs
@@ -4,12 +4,16 @@
 using System;
 using System.Collections.Generic;
 using System.Linq;
+using osu.Game.Beatmaps;
 using osu.Game.Online.API;
+using osu.Game.Online.API.Requests;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Rooms;
+using osu.Game.Rulesets;
 using osu.Game.Rulesets.Scoring;
 using osu.Game.Scoring;
 using osu.Game.Screens.OnlinePlay.Components;
+using osu.Game.Tests.Beatmaps;
 
 namespace osu.Game.Tests.Visual.OnlinePlay
 {
@@ -33,9 +37,9 @@ namespace osu.Game.Tests.Visual.OnlinePlay
         /// </summary>
         /// <param name="request">The API request to handle.</param>
         /// <param name="localUser">The local user to store in responses where required.</param>
-        /// <param name="game">The game base for cases where actual online requests need to be sent.</param>
+        /// <param name="beatmapManager">The beatmap manager to attempt to retrieve beatmaps from, prior to returning dummy beatmaps.</param>
         /// <returns>Whether the request was successfully handled.</returns>
-        public bool HandleRequest(APIRequest request, APIUser localUser, OsuGameBase game)
+        public bool HandleRequest(APIRequest request, APIUser localUser, BeatmapManager beatmapManager)
         {
             switch (request)
             {
@@ -128,6 +132,26 @@ namespace osu.Game.Tests.Visual.OnlinePlay
                         Statistics = new Dictionary<HitResult, int>()
                     });
                     return true;
+
+                case GetBeatmapsRequest getBeatmapsRequest:
+                    var result = new List<APIBeatmap>();
+
+                    foreach (int id in getBeatmapsRequest.BeatmapIds)
+                    {
+                        var baseBeatmap = beatmapManager.QueryBeatmap(b => b.OnlineID == id);
+
+                        if (baseBeatmap == null)
+                        {
+                            baseBeatmap = new TestBeatmap(new RulesetInfo { OnlineID = 0 }).BeatmapInfo;
+                            baseBeatmap.OnlineID = id;
+                            baseBeatmap.BeatmapSet!.OnlineID = id;
+                        }
+
+                        result.Add(OsuTestScene.CreateAPIBeatmap(baseBeatmap));
+                    }
+
+                    getBeatmapsRequest.TriggerSuccess(new GetBeatmapsResponse { Beatmaps = result });
+                    return true;
             }
 
             return false;

From 73ce1b324e84e5eef58ddf9ef5010e69a36938c7 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 15 Feb 2022 22:44:20 +0900
Subject: [PATCH 2920/5547] Make DrawableRoom look up the online beatmap

---
 .../Lounge/Components/DrawableRoom.cs         | 39 +++++++++++++------
 1 file changed, 28 insertions(+), 11 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Lounge/Components/DrawableRoom.cs b/osu.Game/Screens/OnlinePlay/Lounge/Components/DrawableRoom.cs
index a87f21630c..60f65fbd9f 100644
--- a/osu.Game/Screens/OnlinePlay/Lounge/Components/DrawableRoom.cs
+++ b/osu.Game/Screens/OnlinePlay/Lounge/Components/DrawableRoom.cs
@@ -2,8 +2,10 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System.Collections.Generic;
+using System.Threading;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
+using osu.Framework.Extensions;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Colour;
@@ -12,6 +14,7 @@ using osu.Framework.Graphics.Effects;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Graphics.Sprites;
 using osu.Game.Beatmaps;
+using osu.Game.Database;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
@@ -328,6 +331,9 @@ namespace osu.Game.Screens.OnlinePlay.Lounge.Components
             [Resolved]
             private OsuColour colours { get; set; }
 
+            [Resolved]
+            private BeatmapLookupCache beatmapLookupCache { get; set; }
+
             private SpriteText statusText;
             private LinkFlowContainer beatmapText;
 
@@ -385,8 +391,11 @@ namespace osu.Game.Screens.OnlinePlay.Lounge.Components
                 SelectedItem.BindValueChanged(onSelectedItemChanged, true);
             }
 
+            private CancellationTokenSource beatmapLookupCancellation;
+
             private void onSelectedItemChanged(ValueChangedEvent<PlaylistItem> item)
             {
+                beatmapLookupCancellation?.Cancel();
                 beatmapText.Clear();
 
                 if (Type.Value == MatchType.Playlists)
@@ -395,17 +404,25 @@ namespace osu.Game.Screens.OnlinePlay.Lounge.Components
                     return;
                 }
 
-                if (item.NewValue?.Beatmap.Value != null)
-                {
-                    statusText.Text = "Currently playing ";
-                    beatmapText.AddLink(item.NewValue.Beatmap.Value.GetDisplayTitleRomanisable(),
-                        LinkAction.OpenBeatmap,
-                        item.NewValue.Beatmap.Value.OnlineID.ToString(),
-                        creationParameters: s =>
-                        {
-                            s.Truncate = true;
-                        });
-                }
+                var beatmap = item.NewValue?.Beatmap;
+                if (beatmap == null)
+                    return;
+
+                var cancellationSource = beatmapLookupCancellation = new CancellationTokenSource();
+                beatmapLookupCache.GetBeatmapAsync(beatmap.Value.OnlineID, cancellationSource.Token)
+                                  .ContinueWith(task => Schedule(() =>
+                                  {
+                                      if (cancellationSource.IsCancellationRequested)
+                                          return;
+
+                                      var retrievedBeatmap = task.GetResultSafely();
+
+                                      statusText.Text = "Currently playing ";
+                                      beatmapText.AddLink(retrievedBeatmap.GetDisplayTitleRomanisable(),
+                                          LinkAction.OpenBeatmap,
+                                          retrievedBeatmap.OnlineID.ToString(),
+                                          creationParameters: s => s.Truncate = true);
+                                  }), cancellationSource.Token);
             }
         }
 

From afcb7a463061756988648e60f06a0ad9173f43ba Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 15 Feb 2022 23:11:33 +0900
Subject: [PATCH 2921/5547] Make DrawableRoomPlaylistItem look up the online
 beatmap

---
 .../OnlinePlayBeatmapAvailabilityTracker.cs   |  23 ++--
 .../OnlinePlay/DrawableRoomPlaylistItem.cs    | 102 ++++++++----------
 2 files changed, 57 insertions(+), 68 deletions(-)

diff --git a/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs b/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs
index c67cbade6a..51e77694a1 100644
--- a/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs
+++ b/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs
@@ -78,7 +78,7 @@ namespace osu.Game.Online.Rooms
 
                 // handles changes to hash that didn't occur from the import process (ie. a user editing the beatmap in the editor, somehow).
                 realmSubscription?.Dispose();
-                realmSubscription = realm.RegisterForNotifications(r => filteredBeatmaps(), (items, changes, ___) =>
+                realmSubscription = realm.RegisterForNotifications(r => QueryBeatmapForOnlinePlay(r, SelectedItem.Value.Beatmap.Value), (items, changes, ___) =>
                 {
                     if (changes == null)
                         return;
@@ -108,12 +108,12 @@ namespace osu.Game.Online.Rooms
                     break;
 
                 case DownloadState.LocallyAvailable:
-                    bool hashMatches = filteredBeatmaps().Any();
+                    bool available = QueryBeatmapForOnlinePlay(realm.Realm, SelectedItem.Value.Beatmap.Value).Any();
 
-                    availability.Value = hashMatches ? BeatmapAvailability.LocallyAvailable() : BeatmapAvailability.NotDownloaded();
+                    availability.Value = available ? BeatmapAvailability.LocallyAvailable() : BeatmapAvailability.NotDownloaded();
 
                     // only display a message to the user if a download seems to have just completed.
-                    if (!hashMatches && downloadTracker.Progress.Value == 1)
+                    if (!available && downloadTracker.Progress.Value == 1)
                         Logger.Log("The imported beatmap set does not match the online version.", LoggingTarget.Runtime, LogLevel.Important);
 
                     break;
@@ -123,14 +123,15 @@ namespace osu.Game.Online.Rooms
             }
         }
 
-        private IQueryable<BeatmapInfo> filteredBeatmaps()
+        /// <summary>
+        /// Performs a query for a local <see cref="BeatmapInfo"/> matching a requested one for the purpose of online play.
+        /// </summary>
+        /// <param name="realm">The realm to query from.</param>
+        /// <param name="beatmap">The requested beatmap.</param>
+        /// <returns>A beatmap query.</returns>
+        public static IQueryable<BeatmapInfo> QueryBeatmapForOnlinePlay(Realm realm, IBeatmapInfo beatmap)
         {
-            int onlineId = SelectedItem.Value.Beatmap.Value.OnlineID;
-            string checksum = SelectedItem.Value.Beatmap.Value.MD5Hash;
-
-            return realm.Realm
-                        .All<BeatmapInfo>()
-                        .Filter("OnlineID == $0 && MD5Hash == $1 && BeatmapSet.DeletePending == false", onlineId, checksum);
+            return realm.All<BeatmapInfo>().Filter("OnlineID == $0 && MD5Hash == $1 && BeatmapSet.DeletePending == false", beatmap.OnlineID, beatmap.MD5Hash);
         }
 
         protected override void Dispose(bool isDisposing)
diff --git a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
index dcf2a5a480..7674fac88e 100644
--- a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
+++ b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
@@ -5,7 +5,6 @@ using System;
 using System.Collections.Generic;
 using System.Linq;
 using System.Threading.Tasks;
-using JetBrains.Annotations;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
@@ -25,7 +24,6 @@ using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Online;
 using osu.Game.Online.Chat;
-using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Rooms;
 using osu.Game.Overlays.BeatmapSet;
 using osu.Game.Rulesets;
@@ -68,8 +66,8 @@ namespace osu.Game.Screens.OnlinePlay
 
         private readonly DelayedLoadWrapper onScreenLoader = new DelayedLoadWrapper(Empty) { RelativeSizeAxes = Axes.Both };
         private readonly IBindable<bool> valid = new Bindable<bool>();
-        private readonly Bindable<IBeatmapInfo> beatmap = new Bindable<IBeatmapInfo>();
 
+        private IBeatmapInfo beatmap;
         private IRulesetInfo ruleset;
         private Mod[] requiredMods;
 
@@ -96,13 +94,12 @@ namespace osu.Game.Screens.OnlinePlay
         [Resolved]
         private UserLookupCache userLookupCache { get; set; }
 
-        [CanBeNull]
-        [Resolved(CanBeNull = true)]
-        private MultiplayerClient multiplayerClient { get; set; }
-
         [Resolved]
         private BeatmapLookupCache beatmapLookupCache { get; set; }
 
+        [Resolved]
+        private RealmAccess realm { get; set; }
+
         protected override bool ShouldBeConsideredForInput(Drawable child) => AllowReordering || AllowDeletion || !AllowSelection || SelectedItem.Value == Model;
 
         public DrawableRoomPlaylistItem(PlaylistItem item)
@@ -110,7 +107,6 @@ namespace osu.Game.Screens.OnlinePlay
         {
             Item = item;
 
-            beatmap.BindTo(item.Beatmap);
             valid.BindTo(item.Valid);
 
             if (item.Expired)
@@ -151,7 +147,6 @@ namespace osu.Game.Screens.OnlinePlay
                 maskingContainer.BorderThickness = isCurrent ? 5 : 0;
             }, true);
 
-            beatmap.BindValueChanged(_ => Scheduler.AddOnce(refresh));
             valid.BindValueChanged(_ => Scheduler.AddOnce(refresh));
 
             onScreenLoader.DelayedLoadStarted += _ =>
@@ -166,19 +161,9 @@ namespace osu.Game.Screens.OnlinePlay
                             Schedule(() => ownerAvatar.User = foundUser);
                         }
 
-                        if (Item.Beatmap.Value == null)
-                        {
-                            IBeatmapInfo foundBeatmap;
+                        beatmap = await beatmapLookupCache.GetBeatmapAsync(Item.Beatmap.Value.OnlineID).ConfigureAwait(false);
 
-                            if (multiplayerClient != null)
-                                // This call can eventually go away (and use the else case below).
-                                // Currently required only due to the method being overridden to provide special behaviour in tests.
-                                foundBeatmap = await multiplayerClient.GetAPIBeatmap(Item.BeatmapID).ConfigureAwait(false);
-                            else
-                                foundBeatmap = await beatmapLookupCache.GetBeatmapAsync(Item.BeatmapID).ConfigureAwait(false);
-
-                            Schedule(() => Item.Beatmap.Value = foundBeatmap);
-                        }
+                        Scheduler.AddOnce(refresh);
                     }
                     catch (Exception e)
                     {
@@ -280,18 +265,18 @@ namespace osu.Game.Screens.OnlinePlay
                 maskingContainer.BorderColour = colours.Red;
             }
 
-            if (Item.Beatmap.Value != null)
-                difficultyIconContainer.Child = new DifficultyIcon(Item.Beatmap.Value, ruleset, requiredMods, performBackgroundDifficultyLookup: false) { Size = new Vector2(icon_height) };
+            if (beatmap != null)
+                difficultyIconContainer.Child = new DifficultyIcon(beatmap, ruleset, requiredMods, performBackgroundDifficultyLookup: false) { Size = new Vector2(icon_height) };
             else
                 difficultyIconContainer.Clear();
 
-            panelBackground.Beatmap.Value = Item.Beatmap.Value;
+            panelBackground.Beatmap.Value = beatmap;
 
             beatmapText.Clear();
 
-            if (Item.Beatmap.Value != null)
+            if (beatmap != null)
             {
-                beatmapText.AddLink(Item.Beatmap.Value.GetDisplayTitleRomanisable(), LinkAction.OpenBeatmap, Item.Beatmap.Value.OnlineID.ToString(), null, text =>
+                beatmapText.AddLink(beatmap.GetDisplayTitleRomanisable(), LinkAction.OpenBeatmap, beatmap.OnlineID.ToString(), null, text =>
                 {
                     text.Truncate = true;
                 });
@@ -299,13 +284,13 @@ namespace osu.Game.Screens.OnlinePlay
 
             authorText.Clear();
 
-            if (!string.IsNullOrEmpty(Item.Beatmap.Value?.Metadata.Author.Username))
+            if (!string.IsNullOrEmpty(beatmap?.Metadata.Author.Username))
             {
                 authorText.AddText("mapped by ");
-                authorText.AddUserLink(Item.Beatmap.Value.Metadata.Author);
+                authorText.AddUserLink(beatmap.Metadata.Author);
             }
 
-            bool hasExplicitContent = (Item.Beatmap.Value?.BeatmapSet as IBeatmapSetOnlineInfo)?.HasExplicitContent == true;
+            bool hasExplicitContent = (beatmap?.BeatmapSet as IBeatmapSetOnlineInfo)?.HasExplicitContent == true;
             explicitContentPill.Alpha = hasExplicitContent ? 1 : 0;
 
             modDisplay.Current.Value = requiredMods.ToArray();
@@ -448,31 +433,34 @@ namespace osu.Game.Screens.OnlinePlay
             };
         }
 
-        private IEnumerable<Drawable> createButtons() => new[]
+        private IEnumerable<Drawable> createButtons()
         {
-            showResultsButton = new GrayButton(FontAwesome.Solid.ChartPie)
+            return new[]
             {
-                Size = new Vector2(30, 30),
-                Action = () => RequestResults?.Invoke(Item),
-                Alpha = AllowShowingResults ? 1 : 0,
-                TooltipText = "View results"
-            },
-            Item.Beatmap.Value == null ? Empty() : new PlaylistDownloadButton(Item),
-            editButton = new PlaylistEditButton
-            {
-                Size = new Vector2(30, 30),
-                Alpha = AllowEditing ? 1 : 0,
-                Action = () => RequestEdit?.Invoke(Item),
-                TooltipText = "Edit"
-            },
-            removeButton = new PlaylistRemoveButton
-            {
-                Size = new Vector2(30, 30),
-                Alpha = AllowDeletion ? 1 : 0,
-                Action = () => RequestDeletion?.Invoke(Item),
-                TooltipText = "Remove from playlist"
-            },
-        };
+                showResultsButton = new GrayButton(FontAwesome.Solid.ChartPie)
+                {
+                    Size = new Vector2(30, 30),
+                    Action = () => RequestResults?.Invoke(Item),
+                    Alpha = AllowShowingResults ? 1 : 0,
+                    TooltipText = "View results"
+                },
+                OnlinePlayBeatmapAvailabilityTracker.QueryBeatmapForOnlinePlay(realm.Realm, beatmap).Any() ? Empty() : new PlaylistDownloadButton(beatmap),
+                editButton = new PlaylistEditButton
+                {
+                    Size = new Vector2(30, 30),
+                    Alpha = AllowEditing ? 1 : 0,
+                    Action = () => RequestEdit?.Invoke(Item),
+                    TooltipText = "Edit"
+                },
+                removeButton = new PlaylistRemoveButton
+                {
+                    Size = new Vector2(30, 30),
+                    Alpha = AllowDeletion ? 1 : 0,
+                    Action = () => RequestDeletion?.Invoke(Item),
+                    TooltipText = "Remove from playlist"
+                },
+            };
+        }
 
         protected override bool OnClick(ClickEvent e)
         {
@@ -499,7 +487,7 @@ namespace osu.Game.Screens.OnlinePlay
 
         private sealed class PlaylistDownloadButton : BeatmapDownloadButton
         {
-            private readonly PlaylistItem playlistItem;
+            private readonly IBeatmapInfo beatmap;
 
             [Resolved]
             private BeatmapManager beatmapManager { get; set; }
@@ -509,10 +497,10 @@ namespace osu.Game.Screens.OnlinePlay
 
             private const float width = 50;
 
-            public PlaylistDownloadButton(PlaylistItem playlistItem)
-                : base(playlistItem.Beatmap.Value.BeatmapSet)
+            public PlaylistDownloadButton(IBeatmapInfo beatmap)
+                : base(beatmap.BeatmapSet)
             {
-                this.playlistItem = playlistItem;
+                this.beatmap = beatmap;
 
                 Size = new Vector2(width, 30);
                 Alpha = 0;
@@ -532,7 +520,7 @@ namespace osu.Game.Screens.OnlinePlay
                 {
                     case DownloadState.LocallyAvailable:
                         // Perform a local query of the beatmap by beatmap checksum, and reset the state if not matching.
-                        if (beatmapManager.QueryBeatmap(b => b.MD5Hash == playlistItem.Beatmap.Value.MD5Hash) == null)
+                        if (beatmapManager.QueryBeatmap(b => b.MD5Hash == beatmap.MD5Hash) == null)
                             State.Value = DownloadState.NotDownloaded;
                         else
                         {

From 94a974e1c97ea36318488ba9c4c17db1d7ea9c67 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 15 Feb 2022 23:30:39 +0900
Subject: [PATCH 2922/5547] Make OnlinePlayBeatmapAvailabilityTracker look up
 the online beatmap

---
 ...eneOnlinePlayBeatmapAvailabilityTracker.cs | 57 ++++++++++++---
 .../OnlinePlayBeatmapAvailabilityTracker.cs   | 73 ++++++++++++-------
 2 files changed, 93 insertions(+), 37 deletions(-)

diff --git a/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs b/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
index 9aa04dda92..4b98385a51 100644
--- a/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
+++ b/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
@@ -2,6 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
+using System.Collections.Generic;
 using System.Diagnostics;
 using System.IO;
 using System.Threading;
@@ -12,6 +13,7 @@ using osu.Framework.Allocation;
 using osu.Framework.Audio;
 using osu.Framework.Bindables;
 using osu.Framework.Extensions;
+using osu.Framework.Graphics;
 using osu.Framework.IO.Stores;
 using osu.Framework.Platform;
 using osu.Framework.Testing;
@@ -21,6 +23,8 @@ using osu.Game.Database;
 using osu.Game.IO;
 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.Online.Rooms;
 using osu.Game.Rulesets;
 using osu.Game.Tests.Resources;
@@ -53,6 +57,25 @@ namespace osu.Game.Tests.Online
         [SetUp]
         public void SetUp() => Schedule(() =>
         {
+            ((DummyAPIAccess)API).HandleRequest = req =>
+            {
+                switch (req)
+                {
+                    case GetBeatmapsRequest beatmapsReq:
+                        var beatmap = CreateAPIBeatmap();
+                        beatmap.OnlineID = testBeatmapInfo.OnlineID;
+                        beatmap.OnlineBeatmapSetID = testBeatmapSet.OnlineID;
+                        beatmap.Checksum = testBeatmapInfo.MD5Hash;
+                        beatmap.BeatmapSet!.OnlineID = testBeatmapSet.OnlineID;
+
+                        beatmapsReq.TriggerSuccess(new GetBeatmapsResponse { Beatmaps = new List<APIBeatmap> { beatmap } });
+                        return true;
+
+                    default:
+                        return false;
+                }
+            };
+
             beatmaps.AllowImport = new TaskCompletionSource<bool>();
 
             testBeatmapFile = TestResources.GetQuickTestBeatmapForImport();
@@ -69,12 +92,30 @@ namespace osu.Game.Tests.Online
                 RulesetID = testBeatmapInfo.Ruleset.OnlineID,
             };
 
-            Child = availabilityTracker = new OnlinePlayBeatmapAvailabilityTracker
-            {
-                SelectedItem = { BindTarget = selectedItem, }
-            };
+            recreateChildren();
         });
 
+        private void recreateChildren()
+        {
+            var beatmapLookupCache = new BeatmapLookupCache();
+
+            Child = new DependencyProvidingContainer
+            {
+                CachedDependencies = new[]
+                {
+                    (typeof(BeatmapLookupCache), (object)beatmapLookupCache)
+                },
+                Children = new Drawable[]
+                {
+                    beatmapLookupCache,
+                    availabilityTracker = new OnlinePlayBeatmapAvailabilityTracker
+                    {
+                        SelectedItem = { BindTarget = selectedItem, }
+                    }
+                }
+            };
+        }
+
         [Test]
         public void TestBeatmapDownloadingFlow()
         {
@@ -123,10 +164,7 @@ namespace osu.Game.Tests.Online
             });
             addAvailabilityCheckStep("state not downloaded", BeatmapAvailability.NotDownloaded);
 
-            AddStep("recreate tracker", () => Child = availabilityTracker = new OnlinePlayBeatmapAvailabilityTracker
-            {
-                SelectedItem = { BindTarget = selectedItem }
-            });
+            AddStep("recreate tracker", recreateChildren);
             addAvailabilityCheckStep("state not downloaded as well", BeatmapAvailability.NotDownloaded);
 
             AddStep("reimport original beatmap", () => beatmaps.Import(TestResources.GetQuickTestBeatmapForImport()).WaitSafely());
@@ -167,7 +205,8 @@ namespace osu.Game.Tests.Online
 
             public Live<BeatmapSetInfo> CurrentImport { get; private set; }
 
-            public TestBeatmapManager(Storage storage, RealmAccess realm, RulesetStore rulesets, IAPIProvider api, [NotNull] AudioManager audioManager, IResourceStore<byte[]> resources, GameHost host = null, WorkingBeatmap defaultBeatmap = null)
+            public TestBeatmapManager(Storage storage, RealmAccess realm, RulesetStore rulesets, IAPIProvider api, [NotNull] AudioManager audioManager, IResourceStore<byte[]> resources,
+                                      GameHost host = null, WorkingBeatmap defaultBeatmap = null)
                 : base(storage, realm, rulesets, api, audioManager, resources, host, defaultBeatmap)
             {
             }
diff --git a/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs b/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs
index 51e77694a1..90532d88b8 100644
--- a/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs
+++ b/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs
@@ -4,14 +4,17 @@
 using System;
 using System.Diagnostics;
 using System.Linq;
+using System.Threading.Tasks;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
+using osu.Framework.Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Logging;
 using osu.Framework.Threading;
 using osu.Game.Beatmaps;
 using osu.Game.Database;
+using osu.Game.Online.API.Requests.Responses;
 using Realms;
 
 namespace osu.Game.Online.Rooms
@@ -32,6 +35,9 @@ namespace osu.Game.Online.Rooms
         [Resolved]
         private RealmAccess realm { get; set; } = null!;
 
+        [Resolved]
+        private BeatmapLookupCache beatmapLookupCache { get; set; } = null!;
+
         /// <summary>
         /// The availability state of the currently selected playlist item.
         /// </summary>
@@ -58,39 +64,50 @@ namespace osu.Game.Online.Rooms
 
                 downloadTracker?.RemoveAndDisposeImmediately();
 
-                Debug.Assert(item.NewValue.Beatmap.Value.BeatmapSet != null);
-
-                downloadTracker = new BeatmapDownloadTracker(item.NewValue.Beatmap.Value.BeatmapSet);
-
-                AddInternal(downloadTracker);
-
-                downloadTracker.State.BindValueChanged(_ => Scheduler.AddOnce(updateAvailability), true);
-                downloadTracker.Progress.BindValueChanged(_ =>
+                beatmapLookupCache.GetBeatmapAsync(item.NewValue.Beatmap.Value.OnlineID).ContinueWith(task => Schedule(() =>
                 {
-                    if (downloadTracker.State.Value != DownloadState.Downloading)
-                        return;
+                    var beatmap = task.GetResultSafely();
 
-                    // incoming progress changes are going to be at a very high rate.
-                    // we don't want to flood the network with this, so rate limit how often we send progress updates.
-                    if (progressUpdate?.Completed != false)
-                        progressUpdate = Scheduler.AddDelayed(updateAvailability, progressUpdate == null ? 0 : 500);
-                }, true);
-
-                // handles changes to hash that didn't occur from the import process (ie. a user editing the beatmap in the editor, somehow).
-                realmSubscription?.Dispose();
-                realmSubscription = realm.RegisterForNotifications(r => QueryBeatmapForOnlinePlay(r, SelectedItem.Value.Beatmap.Value), (items, changes, ___) =>
-                {
-                    if (changes == null)
-                        return;
-
-                    Scheduler.AddOnce(updateAvailability);
-                });
+                    if (SelectedItem.Value?.Beatmap.Value.OnlineID == beatmap.OnlineID)
+                        beginTracking(beatmap);
+                }), TaskContinuationOptions.OnlyOnRanToCompletion);
             }, true);
         }
 
-        private void updateAvailability()
+        private void beginTracking(APIBeatmap beatmap)
         {
-            if (downloadTracker == null || SelectedItem.Value == null)
+            Debug.Assert(beatmap.BeatmapSet != null);
+
+            downloadTracker = new BeatmapDownloadTracker(beatmap.BeatmapSet);
+
+            AddInternal(downloadTracker);
+
+            downloadTracker.State.BindValueChanged(_ => Scheduler.AddOnce(updateAvailability, beatmap), true);
+            downloadTracker.Progress.BindValueChanged(_ =>
+            {
+                if (downloadTracker.State.Value != DownloadState.Downloading)
+                    return;
+
+                // incoming progress changes are going to be at a very high rate.
+                // we don't want to flood the network with this, so rate limit how often we send progress updates.
+                if (progressUpdate?.Completed != false)
+                    progressUpdate = Scheduler.AddDelayed(updateAvailability, beatmap, progressUpdate == null ? 0 : 500);
+            }, true);
+
+            // handles changes to hash that didn't occur from the import process (ie. a user editing the beatmap in the editor, somehow).
+            realmSubscription?.Dispose();
+            realmSubscription = realm.RegisterForNotifications(r => QueryBeatmapForOnlinePlay(r, SelectedItem.Value.Beatmap.Value), (items, changes, ___) =>
+            {
+                if (changes == null)
+                    return;
+
+                Scheduler.AddOnce(updateAvailability, beatmap);
+            });
+        }
+
+        private void updateAvailability(APIBeatmap beatmap)
+        {
+            if (downloadTracker == null)
                 return;
 
             switch (downloadTracker.State.Value)
@@ -108,7 +125,7 @@ namespace osu.Game.Online.Rooms
                     break;
 
                 case DownloadState.LocallyAvailable:
-                    bool available = QueryBeatmapForOnlinePlay(realm.Realm, SelectedItem.Value.Beatmap.Value).Any();
+                    bool available = QueryBeatmapForOnlinePlay(realm.Realm, beatmap).Any();
 
                     availability.Value = available ? BeatmapAvailability.LocallyAvailable() : BeatmapAvailability.NotDownloaded();
 

From bdc3b76df0b58406796e2b08db13be7f2140fa7e Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 15 Feb 2022 23:33:26 +0900
Subject: [PATCH 2923/5547] Remove beatmap bindable from PlaylistItem

---
 ...eneOnlinePlayBeatmapAvailabilityTracker.cs |   3 +-
 .../OnlinePlay/PlaylistExtensionsTest.cs      |  25 ++---
 .../Visual/Multiplayer/QueueModeTestScene.cs  |   3 +-
 .../Multiplayer/TestSceneDrawableRoom.cs      |  68 ++++--------
 .../TestSceneDrawableRoomPlaylist.cs          |  37 +++----
 .../Multiplayer/TestSceneHostOnlyQueueMode.cs |   8 +-
 .../TestSceneMatchBeatmapDetailArea.cs        |   3 +-
 .../Multiplayer/TestSceneMultiplayer.cs       | 101 +++++++-----------
 .../TestSceneMultiplayerMatchSubScreen.cs     |  15 +--
 .../Multiplayer/TestSceneMultiplayerPlayer.cs |   3 +-
 .../TestSceneMultiplayerPlaylist.cs           |  12 +--
 .../TestSceneMultiplayerQueueList.cs          |   6 +-
 .../TestSceneMultiplayerReadyButton.cs        |   3 +-
 .../TestSceneMultiplayerResults.cs            |   7 +-
 .../TestSceneMultiplayerSpectateButton.cs     |   3 +-
 .../TestSceneMultiplayerTeamResults.cs        |   7 +-
 .../TestScenePlaylistsRoomSettingsPlaylist.cs |  38 +++----
 .../TestSceneStarRatingRangeDisplay.cs        |   4 +-
 .../Visual/Multiplayer/TestSceneTeamVersus.cs |  16 ++-
 .../TestScenePlaylistsMatchSettingsOverlay.cs |   8 +-
 .../TestScenePlaylistsResultsScreen.cs        |   3 +-
 .../TestScenePlaylistsRoomCreation.cs         |  31 +++---
 .../Online/Multiplayer/MultiplayerClient.cs   |  11 +-
 .../Multiplayer/OnlineMultiplayerClient.cs    |  10 --
 .../Online/Rooms/MultiplayerPlaylistItem.cs   |   4 +-
 .../OnlinePlayBeatmapAvailabilityTracker.cs   |   6 +-
 osu.Game/Online/Rooms/PlaylistExtensions.cs   |   2 +-
 osu.Game/Online/Rooms/PlaylistItem.cs         |  74 +++++++++----
 .../OnlinePlay/Components/BeatmapTitle.cs     |   4 +-
 .../OnlinePlay/Components/ModeTypeInfo.cs     |   2 +-
 .../Components/OnlinePlayBackgroundScreen.cs  |   2 +-
 .../Components/OnlinePlayBackgroundSprite.cs  |   2 +-
 .../Components/PlaylistItemBackground.cs      |   2 +-
 .../OnlinePlay/Components/RoomManager.cs      |   3 -
 .../Components/StarRatingRangeDisplay.cs      |   2 +-
 .../OnlinePlay/DrawableRoomPlaylistItem.cs    |   2 +-
 .../Lounge/Components/DrawableRoom.cs         |   2 +-
 .../OnlinePlay/Match/DrawableMatchRoom.cs     |   2 +-
 .../Screens/OnlinePlay/Match/RoomSubScreen.cs |   2 +-
 .../Multiplayer/MultiplayerMatchSongSelect.cs |   4 +-
 .../Multiplayer/MultiplayerMatchSubScreen.cs  |  34 +-----
 .../OnlinePlay/OnlinePlaySongSelect.cs        |   6 +-
 .../OnlinePlay/Playlists/PlaylistsPlayer.cs   |   2 +-
 .../Playlists/PlaylistsRoomSettingsOverlay.cs |   2 +-
 .../Playlists/PlaylistsSongSelect.cs          |   3 +-
 .../Multiplayer/MultiplayerTestScene.cs       |   3 +-
 .../Multiplayer/TestMultiplayerClient.cs      |  23 ----
 .../Visual/OnlinePlay/TestRoomManager.cs      |   9 +-
 48 files changed, 227 insertions(+), 395 deletions(-)

diff --git a/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs b/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
index 4b98385a51..dd7feb6699 100644
--- a/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
+++ b/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
@@ -86,9 +86,8 @@ namespace osu.Game.Tests.Online
             Realm.Write(r => r.RemoveAll<BeatmapSetInfo>());
             Realm.Write(r => r.RemoveAll<BeatmapInfo>());
 
-            selectedItem.Value = new PlaylistItem
+            selectedItem.Value = new PlaylistItem(testBeatmapInfo)
             {
-                Beatmap = { Value = testBeatmapInfo },
                 RulesetID = testBeatmapInfo.Ruleset.OnlineID,
             };
 
diff --git a/osu.Game.Tests/OnlinePlay/PlaylistExtensionsTest.cs b/osu.Game.Tests/OnlinePlay/PlaylistExtensionsTest.cs
index d33081662d..9e7ea02101 100644
--- a/osu.Game.Tests/OnlinePlay/PlaylistExtensionsTest.cs
+++ b/osu.Game.Tests/OnlinePlay/PlaylistExtensionsTest.cs
@@ -3,6 +3,7 @@
 
 using System;
 using NUnit.Framework;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Rooms;
 
 namespace osu.Game.Tests.OnlinePlay
@@ -29,9 +30,9 @@ namespace osu.Game.Tests.OnlinePlay
         {
             var items = new[]
             {
-                new PlaylistItem { ID = 1, BeatmapID = 1001, PlaylistOrder = 1 },
-                new PlaylistItem { ID = 2, BeatmapID = 1002, PlaylistOrder = 2 },
-                new PlaylistItem { ID = 3, BeatmapID = 1003, PlaylistOrder = 3 },
+                new PlaylistItem(new APIBeatmap { OnlineID = 1001 }) { ID = 1, PlaylistOrder = 1 },
+                new PlaylistItem(new APIBeatmap { OnlineID = 1002 }) { ID = 2, PlaylistOrder = 2 },
+                new PlaylistItem(new APIBeatmap { OnlineID = 1003 }) { ID = 3, PlaylistOrder = 3 },
             };
 
             Assert.Multiple(() =>
@@ -47,9 +48,9 @@ namespace osu.Game.Tests.OnlinePlay
         {
             var items = new[]
             {
-                new PlaylistItem { ID = 2, BeatmapID = 1002, PlaylistOrder = 2 },
-                new PlaylistItem { ID = 1, BeatmapID = 1001, PlaylistOrder = 1 },
-                new PlaylistItem { ID = 3, BeatmapID = 1003, PlaylistOrder = 3 },
+                new PlaylistItem(new APIBeatmap { OnlineID = 1002 }) { ID = 2, PlaylistOrder = 2 },
+                new PlaylistItem(new APIBeatmap { OnlineID = 1001 }) { ID = 1, PlaylistOrder = 1 },
+                new PlaylistItem(new APIBeatmap { OnlineID = 1003 }) { ID = 3, PlaylistOrder = 3 },
             };
 
             Assert.Multiple(() =>
@@ -65,9 +66,9 @@ namespace osu.Game.Tests.OnlinePlay
         {
             var items = new[]
             {
-                new PlaylistItem { ID = 1, BeatmapID = 1001, Expired = true, PlayedAt = new DateTimeOffset(2021, 12, 21, 7, 55, 0, TimeSpan.Zero) },
-                new PlaylistItem { ID = 2, BeatmapID = 1002, Expired = true, PlayedAt = new DateTimeOffset(2021, 12, 21, 7, 53, 0, TimeSpan.Zero) },
-                new PlaylistItem { ID = 3, BeatmapID = 1003, PlaylistOrder = 3 },
+                new PlaylistItem(new APIBeatmap { OnlineID = 1001 }) { ID = 1, Expired = true, PlayedAt = new DateTimeOffset(2021, 12, 21, 7, 55, 0, TimeSpan.Zero) },
+                new PlaylistItem(new APIBeatmap { OnlineID = 1002 }) { ID = 2, Expired = true, PlayedAt = new DateTimeOffset(2021, 12, 21, 7, 53, 0, TimeSpan.Zero) },
+                new PlaylistItem(new APIBeatmap { OnlineID = 1003 }) { ID = 3, PlaylistOrder = 3 },
             };
 
             Assert.Multiple(() =>
@@ -83,9 +84,9 @@ namespace osu.Game.Tests.OnlinePlay
         {
             var items = new[]
             {
-                new PlaylistItem { ID = 1, BeatmapID = 1001, Expired = true, PlayedAt = new DateTimeOffset(2021, 12, 21, 7, 55, 0, TimeSpan.Zero) },
-                new PlaylistItem { ID = 2, BeatmapID = 1002, Expired = true, PlayedAt = new DateTimeOffset(2021, 12, 21, 7, 53, 0, TimeSpan.Zero) },
-                new PlaylistItem { ID = 3, BeatmapID = 1002, Expired = true, PlayedAt = new DateTimeOffset(2021, 12, 21, 7, 57, 0, TimeSpan.Zero) },
+                new PlaylistItem(new APIBeatmap { OnlineID = 1001 }) { ID = 1, Expired = true, PlayedAt = new DateTimeOffset(2021, 12, 21, 7, 55, 0, TimeSpan.Zero) },
+                new PlaylistItem(new APIBeatmap { OnlineID = 1002 }) { ID = 2, Expired = true, PlayedAt = new DateTimeOffset(2021, 12, 21, 7, 53, 0, TimeSpan.Zero) },
+                new PlaylistItem(new APIBeatmap { OnlineID = 1002 }) { ID = 3, Expired = true, PlayedAt = new DateTimeOffset(2021, 12, 21, 7, 57, 0, TimeSpan.Zero) },
             };
 
             Assert.Multiple(() =>
diff --git a/osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs b/osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs
index 52801dd57a..5a211e7bec 100644
--- a/osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs
@@ -71,9 +71,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 QueueMode = { Value = Mode },
                 Playlist =
                 {
-                    new PlaylistItem
+                    new PlaylistItem(InitialBeatmap)
                     {
-                        Beatmap = { Value = InitialBeatmap },
                         RulesetID = new OsuRuleset().RulesetInfo.OnlineID
                     }
                 }
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoom.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoom.cs
index 423822cbe4..d8ec0ad1f0 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoom.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoom.cs
@@ -53,19 +53,13 @@ namespace osu.Game.Tests.Visual.Multiplayer
                             Type = { Value = MatchType.HeadToHead },
                             Playlist =
                             {
-                                new PlaylistItem
+                                new PlaylistItem(new TestBeatmap(new OsuRuleset().RulesetInfo)
                                 {
-                                    Beatmap =
+                                    BeatmapInfo =
                                     {
-                                        Value = new TestBeatmap(new OsuRuleset().RulesetInfo)
-                                        {
-                                            BeatmapInfo =
-                                            {
-                                                StarRating = 2.5
-                                            }
-                                        }.BeatmapInfo,
+                                        StarRating = 2.5
                                     }
-                                }
+                                }.BeatmapInfo)
                             }
                         }),
                         createLoungeRoom(new Room
@@ -76,26 +70,20 @@ namespace osu.Game.Tests.Visual.Multiplayer
                             Type = { Value = MatchType.HeadToHead },
                             Playlist =
                             {
-                                new PlaylistItem
+                                new PlaylistItem(new TestBeatmap(new OsuRuleset().RulesetInfo)
                                 {
-                                    Beatmap =
+                                    BeatmapInfo =
                                     {
-                                        Value = new TestBeatmap(new OsuRuleset().RulesetInfo)
+                                        StarRating = 2.5,
+                                        Metadata =
                                         {
-                                            BeatmapInfo =
-                                            {
-                                                StarRating = 2.5,
-                                                Metadata =
-                                                {
-                                                    Artist = "very very very very very very very very very long artist",
-                                                    ArtistUnicode = "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",
-                                                }
-                                            }
-                                        }.BeatmapInfo,
+                                            Artist = "very very very very very very very very very long artist",
+                                            ArtistUnicode = "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",
+                                        }
                                     }
-                                }
+                                }.BeatmapInfo)
                             }
                         }),
                         createLoungeRoom(new Room
@@ -105,32 +93,20 @@ namespace osu.Game.Tests.Visual.Multiplayer
                             EndDate = { Value = DateTimeOffset.Now.AddDays(1) },
                             Playlist =
                             {
-                                new PlaylistItem
+                                new PlaylistItem(new TestBeatmap(new OsuRuleset().RulesetInfo)
                                 {
-                                    Beatmap =
+                                    BeatmapInfo =
                                     {
-                                        Value = new TestBeatmap(new OsuRuleset().RulesetInfo)
-                                        {
-                                            BeatmapInfo =
-                                            {
-                                                StarRating = 2.5
-                                            }
-                                        }.BeatmapInfo,
+                                        StarRating = 2.5
                                     }
-                                },
-                                new PlaylistItem
+                                }.BeatmapInfo),
+                                new PlaylistItem(new TestBeatmap(new OsuRuleset().RulesetInfo)
                                 {
-                                    Beatmap =
+                                    BeatmapInfo =
                                     {
-                                        Value = new TestBeatmap(new OsuRuleset().RulesetInfo)
-                                        {
-                                            BeatmapInfo =
-                                            {
-                                                StarRating = 4.5
-                                            }
-                                        }.BeatmapInfo,
+                                        StarRating = 4.5
                                     }
-                                }
+                                }.BeatmapInfo)
                             }
                         }),
                         createLoungeRoom(new Room
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
index 8c10a0d0d9..bea15e6e58 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
@@ -209,10 +209,9 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     Size = new Vector2(500, 300),
                     Items =
                     {
-                        new PlaylistItem
+                        new PlaylistItem(new TestBeatmap(new OsuRuleset().RulesetInfo).BeatmapInfo)
                         {
                             ID = 0,
-                            Beatmap = { Value = new TestBeatmap(new OsuRuleset().RulesetInfo).BeatmapInfo },
                             RulesetID = new OsuRuleset().RulesetInfo.OnlineID,
                             Expired = true,
                             RequiredMods = new[]
@@ -222,10 +221,9 @@ namespace osu.Game.Tests.Visual.Multiplayer
                                 new APIMod(new OsuModAutoplay())
                             }
                         },
-                        new PlaylistItem
+                        new PlaylistItem(new TestBeatmap(new OsuRuleset().RulesetInfo).BeatmapInfo)
                         {
                             ID = 1,
-                            Beatmap = { Value = new TestBeatmap(new OsuRuleset().RulesetInfo).BeatmapInfo },
                             RulesetID = new OsuRuleset().RulesetInfo.OnlineID,
                             RequiredMods = new[]
                             {
@@ -293,25 +291,21 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
                 for (int i = 0; i < 20; i++)
                 {
-                    playlist.Items.Add(new PlaylistItem
+                    playlist.Items.Add(new PlaylistItem(i % 2 == 1
+                        ? new TestBeatmap(new OsuRuleset().RulesetInfo).BeatmapInfo
+                        : new BeatmapInfo
+                        {
+                            Metadata = new BeatmapMetadata
+                            {
+                                Artist = "Artist",
+                                Author = new RealmUser { Username = "Creator name here" },
+                                Title = "Long title used to check background colour",
+                            },
+                            BeatmapSet = new BeatmapSetInfo()
+                        })
                     {
                         ID = i,
                         OwnerID = 2,
-                        Beatmap =
-                        {
-                            Value = i % 2 == 1
-                                ? new TestBeatmap(new OsuRuleset().RulesetInfo).BeatmapInfo
-                                : new BeatmapInfo
-                                {
-                                    Metadata = new BeatmapMetadata
-                                    {
-                                        Artist = "Artist",
-                                        Author = new RealmUser { Username = "Creator name here" },
-                                        Title = "Long title used to check background colour",
-                                    },
-                                    BeatmapSet = new BeatmapSetInfo()
-                                }
-                        },
                         RulesetID = new OsuRuleset().RulesetInfo.OnlineID,
                         RequiredMods = new[]
                         {
@@ -341,11 +335,10 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
                 foreach (var b in beatmaps())
                 {
-                    playlist.Items.Add(new PlaylistItem
+                    playlist.Items.Add(new PlaylistItem(b)
                     {
                         ID = index++,
                         OwnerID = 2,
-                        Beatmap = { Value = b },
                         RulesetID = new OsuRuleset().RulesetInfo.OnlineID,
                         RequiredMods = new[]
                         {
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneHostOnlyQueueMode.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneHostOnlyQueueMode.cs
index c7eeff81fe..7614e52218 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneHostOnlyQueueMode.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneHostOnlyQueueMode.cs
@@ -57,12 +57,12 @@ namespace osu.Game.Tests.Visual.Multiplayer
             RunGameplay();
 
             IBeatmapInfo firstBeatmap = null;
-            AddStep("get first playlist item beatmap", () => firstBeatmap = Client.APIRoom?.Playlist[0].Beatmap.Value);
+            AddStep("get first playlist item beatmap", () => firstBeatmap = Client.APIRoom?.Playlist[0].Beatmap);
 
             selectNewItem(() => OtherBeatmap);
 
-            AddAssert("first playlist item hasn't changed", () => Client.APIRoom?.Playlist[0].Beatmap.Value == firstBeatmap);
-            AddAssert("second playlist item changed", () => Client.APIRoom?.Playlist[1].Beatmap.Value != firstBeatmap);
+            AddAssert("first playlist item hasn't changed", () => Client.APIRoom?.Playlist[0].Beatmap == firstBeatmap);
+            AddAssert("second playlist item changed", () => Client.APIRoom?.Playlist[1].Beatmap != firstBeatmap);
         }
 
         [Test]
@@ -104,7 +104,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddStep("select other beatmap", () => ((Screens.Select.SongSelect)CurrentSubScreen).FinaliseSelection(otherBeatmap = beatmap()));
 
             AddUntilStep("wait for return to match", () => CurrentSubScreen is MultiplayerMatchSubScreen);
-            AddUntilStep("selected item is new beatmap", () => (CurrentSubScreen as MultiplayerMatchSubScreen)?.SelectedItem.Value?.BeatmapID == otherBeatmap.OnlineID);
+            AddUntilStep("selected item is new beatmap", () => (CurrentSubScreen as MultiplayerMatchSubScreen)?.SelectedItem.Value?.Beatmap.OnlineID == otherBeatmap.OnlineID);
         }
 
         private void addItem(Func<BeatmapInfo> beatmap)
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchBeatmapDetailArea.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchBeatmapDetailArea.cs
index 6144824ba0..6f43511e8a 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchBeatmapDetailArea.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchBeatmapDetailArea.cs
@@ -32,10 +32,9 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
         private void createNewItem()
         {
-            SelectedRoom.Value.Playlist.Add(new PlaylistItem
+            SelectedRoom.Value.Playlist.Add(new PlaylistItem(new TestBeatmap(new OsuRuleset().RulesetInfo).BeatmapInfo)
             {
                 ID = SelectedRoom.Value.Playlist.Count,
-                Beatmap = { Value = new TestBeatmap(new OsuRuleset().RulesetInfo).BeatmapInfo },
                 RulesetID = new OsuRuleset().RulesetInfo.OnlineID,
                 RequiredMods = new[]
                 {
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
index b04bf5e860..4d87480841 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
@@ -93,9 +93,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 Name = { Value = "Test Room" },
                 Playlist =
                 {
-                    new PlaylistItem
+                    new PlaylistItem(beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo)
                     {
-                        Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo },
                         RulesetID = new OsuRuleset().RulesetInfo.OnlineID
                     }
                 }
@@ -229,9 +228,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 Name = { Value = "Test Room" },
                 Playlist =
                 {
-                    new PlaylistItem
+                    new PlaylistItem(beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo)
                     {
-                        Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo },
                         RulesetID = new OsuRuleset().RulesetInfo.OnlineID
                     }
                 }
@@ -251,9 +249,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     Name = { Value = "Test Room" },
                     Playlist =
                     {
-                        new PlaylistItem
+                        new PlaylistItem(beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo)
                         {
-                            Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo },
                             RulesetID = new OsuRuleset().RulesetInfo.OnlineID
                         }
                     }
@@ -281,9 +278,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     Name = { Value = "Test Room" },
                     Playlist =
                     {
-                        new PlaylistItem
+                        new PlaylistItem(beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo)
                         {
-                            Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo },
                             RulesetID = new OsuRuleset().RulesetInfo.OnlineID
                         }
                     }
@@ -312,9 +308,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 Password = { Value = "password" },
                 Playlist =
                 {
-                    new PlaylistItem
+                    new PlaylistItem(beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo)
                     {
-                        Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo },
                         RulesetID = new OsuRuleset().RulesetInfo.OnlineID
                     }
                 }
@@ -334,9 +329,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     Password = { Value = "password" },
                     Playlist =
                     {
-                        new PlaylistItem
+                        new PlaylistItem(beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo)
                         {
-                            Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo },
                             RulesetID = new OsuRuleset().RulesetInfo.OnlineID
                         }
                     }
@@ -367,9 +361,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 Password = { Value = "password" },
                 Playlist =
                 {
-                    new PlaylistItem
+                    new PlaylistItem(beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo)
                     {
-                        Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo },
                         RulesetID = new OsuRuleset().RulesetInfo.OnlineID
                     }
                 }
@@ -387,9 +380,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 Name = { Value = "Test Room" },
                 Playlist =
                 {
-                    new PlaylistItem
+                    new PlaylistItem(beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo)
                     {
-                        Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo },
                         RulesetID = new OsuRuleset().RulesetInfo.OnlineID
                     }
                 }
@@ -409,9 +401,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 Name = { Value = "Test Room" },
                 Playlist =
                 {
-                    new PlaylistItem
+                    new PlaylistItem(beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo)
                     {
-                        Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo },
                         RulesetID = new OsuRuleset().RulesetInfo.OnlineID
                     }
                 }
@@ -448,9 +439,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 Name = { Value = "Test Room" },
                 Playlist =
                 {
-                    new PlaylistItem
+                    new PlaylistItem(beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo)
                     {
-                        Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo },
                         RulesetID = new OsuRuleset().RulesetInfo.OnlineID
                     }
                 }
@@ -487,9 +477,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 Name = { Value = "Test Room" },
                 Playlist =
                 {
-                    new PlaylistItem
+                    new PlaylistItem(beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo)
                     {
-                        Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo },
                         RulesetID = new OsuRuleset().RulesetInfo.OnlineID
                     }
                 }
@@ -526,9 +515,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 Name = { Value = "Test Room" },
                 Playlist =
                 {
-                    new PlaylistItem
+                    new PlaylistItem(beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo)
                     {
-                        Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo },
                         RulesetID = new OsuRuleset().RulesetInfo.OnlineID
                     }
                 }
@@ -560,9 +548,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 Name = { Value = "Test Room" },
                 Playlist =
                 {
-                    new PlaylistItem
+                    new PlaylistItem(beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo)
                     {
-                        Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo },
                         RulesetID = new OsuRuleset().RulesetInfo.OnlineID
                     }
                 }
@@ -600,9 +587,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 Name = { Value = "Test Room" },
                 Playlist =
                 {
-                    new PlaylistItem
+                    new PlaylistItem(beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo)
                     {
-                        Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo },
                         RulesetID = new OsuRuleset().RulesetInfo.OnlineID
                     }
                 }
@@ -620,9 +606,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 Name = { Value = "Test Room" },
                 Playlist =
                 {
-                    new PlaylistItem
+                    new PlaylistItem(beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo)
                     {
-                        Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo },
                         RulesetID = new OsuRuleset().RulesetInfo.OnlineID,
                         AllowedMods = new[] { new APIMod(new OsuModHidden()) }
                     }
@@ -660,10 +645,9 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 Name = { Value = "Test Room" },
                 Playlist =
                 {
-                    new PlaylistItem
+                    new PlaylistItem(beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo)
                     {
-                        Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo },
-                        RulesetID = new OsuRuleset().RulesetInfo.OnlineID
+                        RulesetID = new OsuRuleset().RulesetInfo.OnlineID,
                     }
                 }
             });
@@ -691,10 +675,9 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     QueueMode = { Value = QueueMode.AllPlayers },
                     Playlist =
                     {
-                        new PlaylistItem
+                        new PlaylistItem(beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo)
                         {
-                            Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo },
-                            RulesetID = new OsuRuleset().RulesetInfo.OnlineID
+                            RulesetID = new OsuRuleset().RulesetInfo.OnlineID,
                         }
                     }
                 }, API.LocalUser.Value);
@@ -708,11 +691,10 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddStep("change server-side settings", () =>
             {
                 roomManager.ServerSideRooms[0].Name.Value = "New name";
-                roomManager.ServerSideRooms[0].Playlist.Add(new PlaylistItem
+                roomManager.ServerSideRooms[0].Playlist.Add(new PlaylistItem(beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo)
                 {
                     ID = 2,
-                    Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo },
-                    RulesetID = new OsuRuleset().RulesetInfo.OnlineID
+                    RulesetID = new OsuRuleset().RulesetInfo.OnlineID,
                 });
             });
 
@@ -737,10 +719,9 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 QueueMode = { Value = QueueMode.AllPlayers },
                 Playlist =
                 {
-                    new PlaylistItem
+                    new PlaylistItem(beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo)
                     {
-                        Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo },
-                        RulesetID = new OsuRuleset().RulesetInfo.OnlineID
+                        RulesetID = new OsuRuleset().RulesetInfo.OnlineID,
                     }
                 }
             });
@@ -773,10 +754,9 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 QueueMode = { Value = QueueMode.AllPlayers },
                 Playlist =
                 {
-                    new PlaylistItem
+                    new PlaylistItem(beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo)
                     {
-                        Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo },
-                        RulesetID = new OsuRuleset().RulesetInfo.OnlineID
+                        RulesetID = new OsuRuleset().RulesetInfo.OnlineID,
                     }
                 }
             });
@@ -812,10 +792,9 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 QueueMode = { Value = QueueMode.AllPlayers },
                 Playlist =
                 {
-                    new PlaylistItem
+                    new PlaylistItem(beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo)
                     {
-                        Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo },
-                        RulesetID = new OsuRuleset().RulesetInfo.OnlineID
+                        RulesetID = new OsuRuleset().RulesetInfo.OnlineID,
                     }
                 }
             });
@@ -823,10 +802,11 @@ namespace osu.Game.Tests.Visual.Multiplayer
             enterGameplay();
 
             AddStep("join other user", () => client.AddUser(new APIUser { Id = 1234 }));
-            AddStep("add item as other user", () => client.AddUserPlaylistItem(1234, new MultiplayerPlaylistItem(new PlaylistItem
-            {
-                BeatmapID = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo.OnlineID
-            })));
+            AddStep("add item as other user", () => client.AddUserPlaylistItem(1234, new MultiplayerPlaylistItem(
+                new PlaylistItem(beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo)
+                {
+                    RulesetID = new OsuRuleset().RulesetInfo.OnlineID,
+                })));
 
             AddUntilStep("item arrived in playlist", () => client.Room?.Playlist.Count == 2);
 
@@ -843,10 +823,9 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 QueueMode = { Value = QueueMode.AllPlayers },
                 Playlist =
                 {
-                    new PlaylistItem
+                    new PlaylistItem(beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo)
                     {
-                        Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo },
-                        RulesetID = new OsuRuleset().RulesetInfo.OnlineID
+                        RulesetID = new OsuRuleset().RulesetInfo.OnlineID,
                     }
                 }
             });
@@ -854,10 +833,11 @@ namespace osu.Game.Tests.Visual.Multiplayer
             enterGameplay();
 
             AddStep("join other user", () => client.AddUser(new APIUser { Id = 1234 }));
-            AddStep("add item as other user", () => client.AddUserPlaylistItem(1234, new MultiplayerPlaylistItem(new PlaylistItem
-            {
-                BeatmapID = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo.OnlineID
-            })));
+            AddStep("add item as other user", () => client.AddUserPlaylistItem(1234, new MultiplayerPlaylistItem(
+                new PlaylistItem(beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo)
+                {
+                    RulesetID = new OsuRuleset().RulesetInfo.OnlineID,
+                })));
 
             AddUntilStep("item arrived in playlist", () => client.Room?.Playlist.Count == 2);
 
@@ -876,9 +856,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 Name = { Value = "Test Room" },
                 Playlist =
                 {
-                    new PlaylistItem
+                    new PlaylistItem(beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo)
                     {
-                        Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo },
                         RulesetID = new OsuRuleset().RulesetInfo.OnlineID
                     }
                 }
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs
index 7c18ed2572..e137bf83e4 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs
@@ -73,9 +73,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             AddStep("add playlist item", () =>
             {
-                SelectedRoom.Value.Playlist.Add(new PlaylistItem
+                SelectedRoom.Value.Playlist.Add(new PlaylistItem(new TestBeatmap(new OsuRuleset().RulesetInfo).BeatmapInfo)
                 {
-                    Beatmap = { Value = new TestBeatmap(new OsuRuleset().RulesetInfo).BeatmapInfo },
                     RulesetID = new OsuRuleset().RulesetInfo.OnlineID
                 });
             });
@@ -90,9 +89,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             AddStep("add playlist item", () =>
             {
-                SelectedRoom.Value.Playlist.Add(new PlaylistItem
+                SelectedRoom.Value.Playlist.Add(new PlaylistItem(new TestBeatmap(new TaikoRuleset().RulesetInfo).BeatmapInfo)
                 {
-                    Beatmap = { Value = new TestBeatmap(new TaikoRuleset().RulesetInfo).BeatmapInfo },
                     RulesetID = new TaikoRuleset().RulesetInfo.OnlineID,
                     AllowedMods = new[] { new APIMod(new TaikoModSwap()) }
                 });
@@ -113,9 +111,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             AddStep("set playlist", () =>
             {
-                SelectedRoom.Value.Playlist.Add(new PlaylistItem
+                SelectedRoom.Value.Playlist.Add(new PlaylistItem(new TestBeatmap(new OsuRuleset().RulesetInfo).BeatmapInfo)
                 {
-                    Beatmap = { Value = new TestBeatmap(new OsuRuleset().RulesetInfo).BeatmapInfo },
                     RulesetID = new OsuRuleset().RulesetInfo.OnlineID
                 });
             });
@@ -128,9 +125,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             AddStep("set playlist", () =>
             {
-                SelectedRoom.Value.Playlist.Add(new PlaylistItem
+                SelectedRoom.Value.Playlist.Add(new PlaylistItem(beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First()).BeatmapInfo)
                 {
-                    Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First()).BeatmapInfo },
                     RulesetID = new OsuRuleset().RulesetInfo.OnlineID
                 });
             });
@@ -159,9 +155,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             AddStep("add playlist item with allowed mod", () =>
             {
-                SelectedRoom.Value.Playlist.Add(new PlaylistItem
+                SelectedRoom.Value.Playlist.Add(new PlaylistItem(new TestBeatmap(new OsuRuleset().RulesetInfo).BeatmapInfo)
                 {
-                    Beatmap = { Value = new TestBeatmap(new OsuRuleset().RulesetInfo).BeatmapInfo },
                     RulesetID = new OsuRuleset().RulesetInfo.OnlineID,
                     AllowedMods = new[] { new APIMod(new OsuModDoubleTime()) }
                 });
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlayer.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlayer.cs
index 010e9dc078..c402aff771 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlayer.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlayer.cs
@@ -28,9 +28,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             AddStep("initialise gameplay", () =>
             {
-                Stack.Push(player = new MultiplayerPlayer(Client.APIRoom, new PlaylistItem
+                Stack.Push(player = new MultiplayerPlayer(Client.APIRoom, new PlaylistItem(Beatmap.Value.BeatmapInfo)
                 {
-                    Beatmap = { Value = Beatmap.Value.BeatmapInfo },
                     RulesetID = Beatmap.Value.BeatmapInfo.Ruleset.OnlineID,
                 }, Client.Room?.Users.ToArray()));
             });
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs
index 361178bfe4..57f1c31589 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs
@@ -143,14 +143,12 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     Name = { Value = "test name" },
                     Playlist =
                     {
-                        new PlaylistItem
+                        new PlaylistItem(new TestBeatmap(Ruleset.Value).BeatmapInfo)
                         {
-                            Beatmap = { Value = new TestBeatmap(Ruleset.Value).BeatmapInfo },
-                            RulesetID = Ruleset.Value.OnlineID,
+                            RulesetID = Ruleset.Value.OnlineID
                         },
-                        new PlaylistItem
+                        new PlaylistItem(new TestBeatmap(Ruleset.Value).BeatmapInfo)
                         {
-                            Beatmap = { Value = new TestBeatmap(Ruleset.Value).BeatmapInfo },
                             RulesetID = Ruleset.Value.OnlineID,
                             Expired = true
                         }
@@ -167,10 +165,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
         /// <summary>
         /// Adds a step to create a new playlist item.
         /// </summary>
-        private void addItemStep(bool expired = false) => AddStep("add item", () => Client.AddPlaylistItem(new MultiplayerPlaylistItem(new PlaylistItem
+        private void addItemStep(bool expired = false) => AddStep("add item", () => Client.AddPlaylistItem(new MultiplayerPlaylistItem(new PlaylistItem(importedBeatmap)
         {
-            Beatmap = { Value = importedBeatmap },
-            BeatmapID = importedBeatmap.OnlineID,
             Expired = expired,
             PlayedAt = DateTimeOffset.Now
         })));
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs
index 4040707c41..02bd93ed28 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs
@@ -120,11 +120,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             AddStep("add playlist item", () =>
             {
-                MultiplayerPlaylistItem item = new MultiplayerPlaylistItem(new PlaylistItem
-                {
-                    Beatmap = { Value = importedBeatmap },
-                    BeatmapID = importedBeatmap.OnlineID,
-                });
+                MultiplayerPlaylistItem item = new MultiplayerPlaylistItem(new PlaylistItem(importedBeatmap));
 
                 Client.AddUserPlaylistItem(userId(), item);
 
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs
index 7834226f15..d486a69061 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs
@@ -54,9 +54,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             importedSet = beatmaps.GetAllUsableBeatmapSets().First();
             Beatmap.Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First());
-            selectedItem.Value = new PlaylistItem
+            selectedItem.Value = new PlaylistItem(Beatmap.Value.BeatmapInfo)
             {
-                Beatmap = { Value = Beatmap.Value.BeatmapInfo },
                 RulesetID = Beatmap.Value.BeatmapInfo.Ruleset.OnlineID
             };
 
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerResults.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerResults.cs
index 44a1745eee..cc08135939 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerResults.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerResults.cs
@@ -22,12 +22,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 var beatmapInfo = CreateBeatmap(rulesetInfo).BeatmapInfo;
                 var score = TestResources.CreateTestScoreInfo(beatmapInfo);
 
-                PlaylistItem playlistItem = new PlaylistItem
-                {
-                    BeatmapID = beatmapInfo.OnlineID,
-                };
-
-                Stack.Push(screen = new MultiplayerResultsScreen(score, 1, playlistItem));
+                Stack.Push(screen = new MultiplayerResultsScreen(score, 1, new PlaylistItem(beatmapInfo)));
             });
 
             AddUntilStep("wait for loaded", () => screen.IsLoaded);
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerSpectateButton.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerSpectateButton.cs
index 70d4d9dd55..c8077a49dc 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerSpectateButton.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerSpectateButton.cs
@@ -55,9 +55,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             importedSet = beatmaps.GetAllUsableBeatmapSets().First();
             Beatmap.Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First());
-            selectedItem.Value = new PlaylistItem
+            selectedItem.Value = new PlaylistItem(Beatmap.Value.BeatmapInfo)
             {
-                Beatmap = { Value = Beatmap.Value.BeatmapInfo },
                 RulesetID = Beatmap.Value.BeatmapInfo.Ruleset.OnlineID,
             };
 
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerTeamResults.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerTeamResults.cs
index dfc16c44f2..bdc348b043 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerTeamResults.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerTeamResults.cs
@@ -26,18 +26,13 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 var beatmapInfo = CreateBeatmap(rulesetInfo).BeatmapInfo;
                 var score = TestResources.CreateTestScoreInfo(beatmapInfo);
 
-                PlaylistItem playlistItem = new PlaylistItem
-                {
-                    BeatmapID = beatmapInfo.OnlineID,
-                };
-
                 SortedDictionary<int, BindableInt> teamScores = new SortedDictionary<int, BindableInt>
                 {
                     { 0, new BindableInt(team1Score) },
                     { 1, new BindableInt(team2Score) }
                 };
 
-                Stack.Push(screen = new MultiplayerTeamResultsScreen(score, 1, playlistItem, teamScores));
+                Stack.Push(screen = new MultiplayerTeamResultsScreen(score, 1, new PlaylistItem(beatmapInfo), teamScores));
             });
 
             AddUntilStep("wait for loaded", () => screen.IsLoaded);
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsRoomSettingsPlaylist.cs b/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsRoomSettingsPlaylist.cs
index 9adf2c0370..0ef8b16f68 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsRoomSettingsPlaylist.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsRoomSettingsPlaylist.cs
@@ -107,16 +107,6 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddAssert("item 0 is selected", () => playlist.SelectedItem.Value == playlist.Items[0]);
         }
 
-        [Test]
-        public void TestChangeBeatmapAndRemove()
-        {
-            createPlaylist();
-
-            AddStep("change beatmap of first item", () => playlist.Items[0].BeatmapID = 30);
-            moveToDeleteButton(0);
-            AddStep("click delete button", () => InputManager.Click(MouseButton.Left));
-        }
-
         private void moveToItem(int index, Vector2? offset = null)
             => AddStep($"move mouse to item {index}", () => InputManager.MoveMouseTo(playlist.ChildrenOfType<DifficultyIcon>().ElementAt(index), offset));
 
@@ -139,25 +129,21 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
                 for (int i = 0; i < 20; i++)
                 {
-                    playlist.Items.Add(new PlaylistItem
+                    playlist.Items.Add(new PlaylistItem(i % 2 == 1
+                        ? new TestBeatmap(new OsuRuleset().RulesetInfo).BeatmapInfo
+                        : new BeatmapInfo
+                        {
+                            Metadata = new BeatmapMetadata
+                            {
+                                Artist = "Artist",
+                                Author = new RealmUser { Username = "Creator name here" },
+                                Title = "Long title used to check background colour",
+                            },
+                            BeatmapSet = new BeatmapSetInfo()
+                        })
                     {
                         ID = i,
                         OwnerID = 2,
-                        Beatmap =
-                        {
-                            Value = i % 2 == 1
-                                ? new TestBeatmap(new OsuRuleset().RulesetInfo).BeatmapInfo
-                                : new BeatmapInfo
-                                {
-                                    Metadata = new BeatmapMetadata
-                                    {
-                                        Artist = "Artist",
-                                        Author = new RealmUser { Username = "Creator name here" },
-                                        Title = "Long title used to check background colour",
-                                    },
-                                    BeatmapSet = new BeatmapSetInfo()
-                                }
-                        },
                         RulesetID = new OsuRuleset().RulesetInfo.OnlineID,
                         RequiredMods = new[]
                         {
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneStarRatingRangeDisplay.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneStarRatingRangeDisplay.cs
index 20db922122..5e4013b0f1 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneStarRatingRangeDisplay.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneStarRatingRangeDisplay.cs
@@ -31,8 +31,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
             {
                 SelectedRoom.Value.Playlist.AddRange(new[]
                 {
-                    new PlaylistItem { Beatmap = { Value = new BeatmapInfo { StarRating = min } } },
-                    new PlaylistItem { Beatmap = { Value = new BeatmapInfo { StarRating = max } } },
+                    new PlaylistItem(new BeatmapInfo { StarRating = min }),
+                    new PlaylistItem(new BeatmapInfo { StarRating = max }),
                 });
             });
         }
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs
index b66657728e..bd57c8afa5 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs
@@ -67,9 +67,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 Type = { Value = MatchType.TeamVersus },
                 Playlist =
                 {
-                    new PlaylistItem
+                    new PlaylistItem(beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo)
                     {
-                        Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo },
                         RulesetID = new OsuRuleset().RulesetInfo.OnlineID
                     }
                 }
@@ -88,9 +87,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 Type = { Value = MatchType.TeamVersus },
                 Playlist =
                 {
-                    new PlaylistItem
+                    new PlaylistItem(beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo)
                     {
-                        Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo },
                         RulesetID = new OsuRuleset().RulesetInfo.OnlineID
                     }
                 }
@@ -126,10 +124,9 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 Type = { Value = MatchType.HeadToHead },
                 Playlist =
                 {
-                    new PlaylistItem
+                    new PlaylistItem(beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo)
                     {
-                        Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo },
-                        RulesetID = new OsuRuleset().RulesetInfo.OnlineID
+                        RulesetID = new OsuRuleset().RulesetInfo.OnlineID,
                     }
                 }
             });
@@ -152,10 +149,9 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 Name = { Value = "Test Room" },
                 Playlist =
                 {
-                    new PlaylistItem
+                    new PlaylistItem(beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo)
                     {
-                        Beatmap = { Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo },
-                        RulesetID = new OsuRuleset().RulesetInfo.OnlineID
+                        RulesetID = new OsuRuleset().RulesetInfo.OnlineID,
                     }
                 }
             });
diff --git a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsMatchSettingsOverlay.cs b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsMatchSettingsOverlay.cs
index ca3387392a..666e32d1d0 100644
--- a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsMatchSettingsOverlay.cs
+++ b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsMatchSettingsOverlay.cs
@@ -49,7 +49,7 @@ namespace osu.Game.Tests.Visual.Playlists
             AddStep("set name", () => SelectedRoom.Value.Name.Value = "Room name");
             AddAssert("button disabled", () => !settings.ApplyButton.Enabled.Value);
 
-            AddStep("set beatmap", () => SelectedRoom.Value.Playlist.Add(new PlaylistItem { Beatmap = { Value = CreateBeatmap(Ruleset.Value).BeatmapInfo } }));
+            AddStep("set beatmap", () => SelectedRoom.Value.Playlist.Add(new PlaylistItem(CreateBeatmap(Ruleset.Value).BeatmapInfo)));
             AddAssert("button enabled", () => settings.ApplyButton.Enabled.Value);
 
             AddStep("clear name", () => SelectedRoom.Value.Name.Value = "");
@@ -68,7 +68,7 @@ namespace osu.Game.Tests.Visual.Playlists
             {
                 settings.NameField.Current.Value = expected_name;
                 settings.DurationField.Current.Value = expectedDuration;
-                SelectedRoom.Value.Playlist.Add(new PlaylistItem { Beatmap = { Value = CreateBeatmap(Ruleset.Value).BeatmapInfo } });
+                SelectedRoom.Value.Playlist.Add(new PlaylistItem(CreateBeatmap(Ruleset.Value).BeatmapInfo));
 
                 RoomManager.CreateRequested = r =>
                 {
@@ -94,7 +94,7 @@ namespace osu.Game.Tests.Visual.Playlists
                 var beatmap = CreateBeatmap(Ruleset.Value).BeatmapInfo;
 
                 SelectedRoom.Value.Name.Value = "Test Room";
-                SelectedRoom.Value.Playlist.Add(new PlaylistItem { Beatmap = { Value = beatmap } });
+                SelectedRoom.Value.Playlist.Add(new PlaylistItem(beatmap));
 
                 errorMessage = $"{not_found_prefix} {beatmap.OnlineID}";
 
@@ -121,7 +121,7 @@ namespace osu.Game.Tests.Visual.Playlists
             AddStep("setup", () =>
             {
                 SelectedRoom.Value.Name.Value = "Test Room";
-                SelectedRoom.Value.Playlist.Add(new PlaylistItem { Beatmap = { Value = CreateBeatmap(Ruleset.Value).BeatmapInfo } });
+                SelectedRoom.Value.Playlist.Add(new PlaylistItem(CreateBeatmap(Ruleset.Value).BeatmapInfo));
 
                 RoomManager.CreateRequested = _ => failText;
             });
diff --git a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsResultsScreen.cs b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsResultsScreen.cs
index a05d01613c..161624413d 100644
--- a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsResultsScreen.cs
+++ b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsResultsScreen.cs
@@ -165,9 +165,8 @@ namespace osu.Game.Tests.Visual.Playlists
         {
             AddStep("load results", () =>
             {
-                LoadScreen(resultsScreen = new TestResultsScreen(getScore?.Invoke(), 1, new PlaylistItem
+                LoadScreen(resultsScreen = new TestResultsScreen(getScore?.Invoke(), 1, new PlaylistItem(new TestBeatmap(new OsuRuleset().RulesetInfo).BeatmapInfo)
                 {
-                    Beatmap = { Value = new TestBeatmap(new OsuRuleset().RulesetInfo).BeatmapInfo },
                     RulesetID = new OsuRuleset().RulesetInfo.OnlineID
                 }));
             });
diff --git a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs
index 578ea63b4e..28b1f6eff5 100644
--- a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs
+++ b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs
@@ -64,9 +64,8 @@ namespace osu.Game.Tests.Visual.Playlists
                 room.Host.Value = API.LocalUser.Value;
                 room.RecentParticipants.Add(room.Host.Value);
                 room.EndDate.Value = DateTimeOffset.Now.AddMinutes(5);
-                room.Playlist.Add(new PlaylistItem
+                room.Playlist.Add(new PlaylistItem(importedBeatmap.Beatmaps.First())
                 {
-                    Beatmap = { Value = importedBeatmap.Beatmaps.First() },
                     RulesetID = new OsuRuleset().RulesetInfo.OnlineID
                 });
             });
@@ -89,9 +88,8 @@ namespace osu.Game.Tests.Visual.Playlists
                 room.Host.Value = API.LocalUser.Value;
                 room.RecentParticipants.Add(room.Host.Value);
                 room.EndDate.Value = DateTimeOffset.Now.AddMinutes(5);
-                room.Playlist.Add(new PlaylistItem
+                room.Playlist.Add(new PlaylistItem(importedBeatmap.Beatmaps.First())
                 {
-                    Beatmap = { Value = importedBeatmap.Beatmaps.First() },
                     RulesetID = new OsuRuleset().RulesetInfo.OnlineID
                 });
             });
@@ -106,9 +104,8 @@ namespace osu.Game.Tests.Visual.Playlists
             {
                 room.Name.Value = "my awesome room";
                 room.Host.Value = API.LocalUser.Value;
-                room.Playlist.Add(new PlaylistItem
+                room.Playlist.Add(new PlaylistItem(importedBeatmap.Beatmaps.First())
                 {
-                    Beatmap = { Value = importedBeatmap.Beatmaps.First() },
                     RulesetID = new OsuRuleset().RulesetInfo.OnlineID
                 });
             });
@@ -158,21 +155,17 @@ namespace osu.Game.Tests.Visual.Playlists
             {
                 room.Name.Value = "my awesome room";
                 room.Host.Value = API.LocalUser.Value;
-                room.Playlist.Add(new PlaylistItem
+                room.Playlist.Add(new PlaylistItem(new BeatmapInfo
                 {
-                    Beatmap =
+                    MD5Hash = realHash,
+                    OnlineID = realOnlineId,
+                    Metadata = new BeatmapMetadata(),
+                    BeatmapSet = new BeatmapSetInfo
                     {
-                        Value = new BeatmapInfo
-                        {
-                            MD5Hash = realHash,
-                            OnlineID = realOnlineId,
-                            Metadata = new BeatmapMetadata(),
-                            BeatmapSet = new BeatmapSetInfo
-                            {
-                                OnlineID = realOnlineSetId,
-                            }
-                        }
-                    },
+                        OnlineID = realOnlineSetId,
+                    }
+                })
+                {
                     RulesetID = new OsuRuleset().RulesetInfo.OnlineID
                 });
             });
diff --git a/osu.Game/Online/Multiplayer/MultiplayerClient.cs b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
index 9d45229961..a56cc7f8d6 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
@@ -727,10 +727,9 @@ namespace osu.Game.Online.Multiplayer
             RoomUpdated?.Invoke();
         }
 
-        private PlaylistItem createPlaylistItem(MultiplayerPlaylistItem item) => new PlaylistItem
+        private PlaylistItem createPlaylistItem(MultiplayerPlaylistItem item) => new PlaylistItem(new APIBeatmap { OnlineID = item.BeatmapID })
         {
             ID = item.ID,
-            BeatmapID = item.BeatmapID,
             OwnerID = item.OwnerID,
             RulesetID = item.RulesetID,
             Expired = item.Expired,
@@ -740,14 +739,6 @@ namespace osu.Game.Online.Multiplayer
             AllowedMods = item.AllowedMods.ToArray()
         };
 
-        /// <summary>
-        /// Retrieves a <see cref="APIBeatmap"/> from an online source.
-        /// </summary>
-        /// <param name="beatmapId">The beatmap ID.</param>
-        /// <param name="cancellationToken">A token to cancel the request.</param>
-        /// <returns>The <see cref="APIBeatmap"/> retrieval task.</returns>
-        public abstract Task<APIBeatmap> GetAPIBeatmap(int beatmapId, CancellationToken cancellationToken = default);
-
         /// <summary>
         /// For the provided user ID, update whether the user is included in <see cref="CurrentMatchPlayingUserIds"/>.
         /// </summary>
diff --git a/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs b/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs
index 3794bec228..e92bcd9769 100644
--- a/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs
@@ -9,9 +9,7 @@ using System.Threading.Tasks;
 using Microsoft.AspNetCore.SignalR.Client;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
-using osu.Game.Database;
 using osu.Game.Online.API;
-using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Rooms;
 
 namespace osu.Game.Online.Multiplayer
@@ -29,9 +27,6 @@ namespace osu.Game.Online.Multiplayer
 
         private HubConnection? connection => connector?.CurrentConnection;
 
-        [Resolved]
-        private BeatmapLookupCache beatmapLookupCache { get; set; } = null!;
-
         public OnlineMultiplayerClient(EndpointConfiguration endpoints)
         {
             endpoint = endpoints.MultiplayerEndpointUrl;
@@ -186,11 +181,6 @@ namespace osu.Game.Online.Multiplayer
             return connection.InvokeAsync(nameof(IMultiplayerServer.RemovePlaylistItem), playlistItemId);
         }
 
-        public override Task<APIBeatmap> GetAPIBeatmap(int beatmapId, CancellationToken cancellationToken = default)
-        {
-            return beatmapLookupCache.GetBeatmapAsync(beatmapId, cancellationToken);
-        }
-
         protected override void Dispose(bool isDisposing)
         {
             base.Dispose(isDisposing);
diff --git a/osu.Game/Online/Rooms/MultiplayerPlaylistItem.cs b/osu.Game/Online/Rooms/MultiplayerPlaylistItem.cs
index d74cdd8c34..388a02f798 100644
--- a/osu.Game/Online/Rooms/MultiplayerPlaylistItem.cs
+++ b/osu.Game/Online/Rooms/MultiplayerPlaylistItem.cs
@@ -63,8 +63,8 @@ namespace osu.Game.Online.Rooms
         {
             ID = item.ID;
             OwnerID = item.OwnerID;
-            BeatmapID = item.BeatmapID;
-            BeatmapChecksum = item.Beatmap.Value?.MD5Hash ?? string.Empty;
+            BeatmapID = item.Beatmap.OnlineID;
+            BeatmapChecksum = item.Beatmap.MD5Hash;
             RulesetID = item.RulesetID;
             RequiredMods = item.RequiredMods.ToArray();
             AllowedMods = item.AllowedMods.ToArray();
diff --git a/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs b/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs
index 90532d88b8..3620e703ae 100644
--- a/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs
+++ b/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs
@@ -64,11 +64,11 @@ namespace osu.Game.Online.Rooms
 
                 downloadTracker?.RemoveAndDisposeImmediately();
 
-                beatmapLookupCache.GetBeatmapAsync(item.NewValue.Beatmap.Value.OnlineID).ContinueWith(task => Schedule(() =>
+                beatmapLookupCache.GetBeatmapAsync(item.NewValue.Beatmap.OnlineID).ContinueWith(task => Schedule(() =>
                 {
                     var beatmap = task.GetResultSafely();
 
-                    if (SelectedItem.Value?.Beatmap.Value.OnlineID == beatmap.OnlineID)
+                    if (SelectedItem.Value?.Beatmap.OnlineID == beatmap.OnlineID)
                         beginTracking(beatmap);
                 }), TaskContinuationOptions.OnlyOnRanToCompletion);
             }, true);
@@ -96,7 +96,7 @@ namespace osu.Game.Online.Rooms
 
             // handles changes to hash that didn't occur from the import process (ie. a user editing the beatmap in the editor, somehow).
             realmSubscription?.Dispose();
-            realmSubscription = realm.RegisterForNotifications(r => QueryBeatmapForOnlinePlay(r, SelectedItem.Value.Beatmap.Value), (items, changes, ___) =>
+            realmSubscription = realm.RegisterForNotifications(r => QueryBeatmapForOnlinePlay(r, SelectedItem.Value.Beatmap), (items, changes, ___) =>
             {
                 if (changes == null)
                     return;
diff --git a/osu.Game/Online/Rooms/PlaylistExtensions.cs b/osu.Game/Online/Rooms/PlaylistExtensions.cs
index e78f91f20b..34c93bd9e0 100644
--- a/osu.Game/Online/Rooms/PlaylistExtensions.cs
+++ b/osu.Game/Online/Rooms/PlaylistExtensions.cs
@@ -41,6 +41,6 @@ namespace osu.Game.Online.Rooms
         }
 
         public static string GetTotalDuration(this BindableList<PlaylistItem> playlist) =>
-            playlist.Select(p => p.Beatmap.Value.Length).Sum().Milliseconds().Humanize(minUnit: TimeUnit.Second, maxUnit: TimeUnit.Hour, precision: 2);
+            playlist.Select(p => p.Beatmap.Length).Sum().Milliseconds().Humanize(minUnit: TimeUnit.Second, maxUnit: TimeUnit.Hour, precision: 2);
     }
 }
diff --git a/osu.Game/Online/Rooms/PlaylistItem.cs b/osu.Game/Online/Rooms/PlaylistItem.cs
index c082babb01..33718f050b 100644
--- a/osu.Game/Online/Rooms/PlaylistItem.cs
+++ b/osu.Game/Online/Rooms/PlaylistItem.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.
 
+#nullable enable
+
 using System;
 using System.Linq;
 using JetBrains.Annotations;
@@ -12,6 +14,7 @@ using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Online.Rooms
 {
+    [JsonObject(MemberSerialization.OptIn)]
     public class PlaylistItem : IEquatable<PlaylistItem>
     {
         [JsonProperty("id")]
@@ -20,9 +23,6 @@ namespace osu.Game.Online.Rooms
         [JsonProperty("owner_id")]
         public int OwnerID { get; set; }
 
-        [JsonProperty("beatmap_id")]
-        public int BeatmapID { get; set; }
-
         [JsonProperty("ruleset_id")]
         public int RulesetID { get; set; }
 
@@ -38,35 +38,50 @@ namespace osu.Game.Online.Rooms
         [JsonProperty("played_at")]
         public DateTimeOffset? PlayedAt { get; set; }
 
-        [JsonIgnore]
-        public IBindable<bool> Valid => valid;
-
-        private readonly Bindable<bool> valid = new BindableBool(true);
-
-        [JsonIgnore]
-        public readonly Bindable<IBeatmapInfo> Beatmap = new Bindable<IBeatmapInfo>();
-
-        [JsonProperty("beatmap")]
-        private APIBeatmap apiBeatmap { get; set; }
-
         [JsonProperty("allowed_mods")]
         public APIMod[] AllowedMods { get; set; } = Array.Empty<APIMod>();
 
         [JsonProperty("required_mods")]
         public APIMod[] RequiredMods { get; set; } = Array.Empty<APIMod>();
 
-        public PlaylistItem()
+        /// <summary>
+        /// Used for deserialising from the API.
+        /// </summary>
+        [JsonProperty("beatmap")]
+        private APIBeatmap apiBeatmap
         {
-            Beatmap.BindValueChanged(beatmap => BeatmapID = beatmap.NewValue?.OnlineID ?? -1);
+            // This getter is required/used internally by JSON.NET during deserialisation to do default-value comparisons. It is never used during serialisation (see: ShouldSerializeapiBeatmap()).
+            // It will always return a null value on deserialisation, which JSON.NET will handle gracefully.
+            get => (APIBeatmap)Beatmap;
+            set => Beatmap = value;
+        }
+
+        /// <summary>
+        /// Used for serialising to the API.
+        /// </summary>
+        [JsonProperty("beatmap_id")]
+        private int onlineBeatmapId => Beatmap.OnlineID;
+
+        [JsonIgnore]
+        public IBeatmapInfo Beatmap { get; set; } = null!;
+
+        [JsonIgnore]
+        public IBindable<bool> Valid => valid;
+
+        private readonly Bindable<bool> valid = new BindableBool(true);
+
+        [JsonConstructor]
+        private PlaylistItem()
+        {
+        }
+
+        public PlaylistItem(IBeatmapInfo beatmap)
+        {
+            Beatmap = beatmap;
         }
 
         public void MarkInvalid() => valid.Value = false;
 
-        public void MapObjects()
-        {
-            Beatmap.Value ??= apiBeatmap;
-        }
-
         #region Newtonsoft.Json implicit ShouldSerialize() methods
 
         // The properties in this region are used implicitly by Newtonsoft.Json to not serialise certain fields in some cases.
@@ -82,9 +97,22 @@ namespace osu.Game.Online.Rooms
 
         #endregion
 
-        public bool Equals(PlaylistItem other)
+        public PlaylistItem With(IBeatmapInfo beatmap) => new PlaylistItem(beatmap)
+        {
+            ID = ID,
+            OwnerID = OwnerID,
+            RulesetID = RulesetID,
+            Expired = Expired,
+            PlaylistOrder = PlaylistOrder,
+            PlayedAt = PlayedAt,
+            AllowedMods = AllowedMods,
+            RequiredMods = RequiredMods,
+            valid = { Value = Valid.Value },
+        };
+
+        public bool Equals(PlaylistItem? other)
             => ID == other?.ID
-               && BeatmapID == other.BeatmapID
+               && Beatmap.OnlineID == other.Beatmap.OnlineID
                && RulesetID == other.RulesetID
                && Expired == other.Expired
                && AllowedMods.SequenceEqual(other.AllowedMods)
diff --git a/osu.Game/Screens/OnlinePlay/Components/BeatmapTitle.cs b/osu.Game/Screens/OnlinePlay/Components/BeatmapTitle.cs
index e948c1adae..7cbe1a9017 100644
--- a/osu.Game/Screens/OnlinePlay/Components/BeatmapTitle.cs
+++ b/osu.Game/Screens/OnlinePlay/Components/BeatmapTitle.cs
@@ -68,14 +68,14 @@ namespace osu.Game.Screens.OnlinePlay.Components
             }
             else
             {
-                var metadataInfo = beatmap.Value.Metadata;
+                var metadataInfo = beatmap.Metadata;
 
                 string artistUnicode = string.IsNullOrEmpty(metadataInfo.ArtistUnicode) ? metadataInfo.Artist : metadataInfo.ArtistUnicode;
                 string titleUnicode = string.IsNullOrEmpty(metadataInfo.TitleUnicode) ? metadataInfo.Title : metadataInfo.TitleUnicode;
 
                 var title = new RomanisableString($"{artistUnicode} - {titleUnicode}".Trim(), $"{metadataInfo.Artist} - {metadataInfo.Title}".Trim());
 
-                textFlow.AddLink(title, LinkAction.OpenBeatmap, beatmap.Value.OnlineID.ToString(), "Open beatmap");
+                textFlow.AddLink(title, LinkAction.OpenBeatmap, beatmap.OnlineID.ToString(), "Open beatmap");
             }
         }
     }
diff --git a/osu.Game/Screens/OnlinePlay/Components/ModeTypeInfo.cs b/osu.Game/Screens/OnlinePlay/Components/ModeTypeInfo.cs
index d534a1e374..8402619ebc 100644
--- a/osu.Game/Screens/OnlinePlay/Components/ModeTypeInfo.cs
+++ b/osu.Game/Screens/OnlinePlay/Components/ModeTypeInfo.cs
@@ -67,7 +67,7 @@ namespace osu.Game.Screens.OnlinePlay.Components
                 var mods = item.RequiredMods.Select(m => m.ToMod(ruleset)).ToArray();
 
                 drawableRuleset.FadeIn(transition_duration);
-                drawableRuleset.Child = new DifficultyIcon(item.Beatmap.Value, ruleset.RulesetInfo, mods) { Size = new Vector2(height) };
+                drawableRuleset.Child = new DifficultyIcon(item.Beatmap, ruleset.RulesetInfo, mods) { Size = new Vector2(height) };
             }
             else
                 drawableRuleset.FadeOut(transition_duration);
diff --git a/osu.Game/Screens/OnlinePlay/Components/OnlinePlayBackgroundScreen.cs b/osu.Game/Screens/OnlinePlay/Components/OnlinePlayBackgroundScreen.cs
index ffc5c07d4e..8906bebf0e 100644
--- a/osu.Game/Screens/OnlinePlay/Components/OnlinePlayBackgroundScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Components/OnlinePlayBackgroundScreen.cs
@@ -60,7 +60,7 @@ namespace osu.Game.Screens.OnlinePlay.Components
         {
             Schedule(() =>
             {
-                var beatmap = playlistItem?.Beatmap.Value;
+                var beatmap = playlistItem?.Beatmap;
 
                 string? lastCover = (background?.Beatmap?.BeatmapSet as IBeatmapSetOnlineInfo)?.Covers.Cover;
                 string? newCover = (beatmap?.BeatmapSet as IBeatmapSetOnlineInfo)?.Covers.Cover;
diff --git a/osu.Game/Screens/OnlinePlay/Components/OnlinePlayBackgroundSprite.cs b/osu.Game/Screens/OnlinePlay/Components/OnlinePlayBackgroundSprite.cs
index d144e1e3a9..d46ff12279 100644
--- a/osu.Game/Screens/OnlinePlay/Components/OnlinePlayBackgroundSprite.cs
+++ b/osu.Game/Screens/OnlinePlay/Components/OnlinePlayBackgroundSprite.cs
@@ -30,7 +30,7 @@ namespace osu.Game.Screens.OnlinePlay.Components
 
         private void updateBeatmap()
         {
-            sprite.Beatmap.Value = Playlist.GetCurrentItem()?.Beatmap.Value;
+            sprite.Beatmap.Value = Playlist.GetCurrentItem()?.Beatmap;
         }
 
         protected virtual UpdateableBeatmapBackgroundSprite CreateBackgroundSprite() => new UpdateableBeatmapBackgroundSprite(BeatmapSetCoverType) { RelativeSizeAxes = Axes.Both };
diff --git a/osu.Game/Screens/OnlinePlay/Components/PlaylistItemBackground.cs b/osu.Game/Screens/OnlinePlay/Components/PlaylistItemBackground.cs
index f3e90aa396..7e31591389 100644
--- a/osu.Game/Screens/OnlinePlay/Components/PlaylistItemBackground.cs
+++ b/osu.Game/Screens/OnlinePlay/Components/PlaylistItemBackground.cs
@@ -17,7 +17,7 @@ namespace osu.Game.Screens.OnlinePlay.Components
 
         public PlaylistItemBackground(PlaylistItem? playlistItem)
         {
-            Beatmap = playlistItem?.Beatmap.Value;
+            Beatmap = playlistItem?.Beatmap;
         }
 
         [BackgroundDependencyLoader]
diff --git a/osu.Game/Screens/OnlinePlay/Components/RoomManager.cs b/osu.Game/Screens/OnlinePlay/Components/RoomManager.cs
index 21b64b61bb..4242886e66 100644
--- a/osu.Game/Screens/OnlinePlay/Components/RoomManager.cs
+++ b/osu.Game/Screens/OnlinePlay/Components/RoomManager.cs
@@ -112,9 +112,6 @@ namespace osu.Game.Screens.OnlinePlay.Components
 
             try
             {
-                foreach (var pi in room.Playlist)
-                    pi.MapObjects();
-
                 var existing = rooms.FirstOrDefault(e => e.RoomID.Value == room.RoomID.Value);
                 if (existing == null)
                     rooms.Add(room);
diff --git a/osu.Game/Screens/OnlinePlay/Components/StarRatingRangeDisplay.cs b/osu.Game/Screens/OnlinePlay/Components/StarRatingRangeDisplay.cs
index edf9c5d155..95ecadd21a 100644
--- a/osu.Game/Screens/OnlinePlay/Components/StarRatingRangeDisplay.cs
+++ b/osu.Game/Screens/OnlinePlay/Components/StarRatingRangeDisplay.cs
@@ -80,7 +80,7 @@ namespace osu.Game.Screens.OnlinePlay.Components
 
         private void updateRange(object sender, NotifyCollectionChangedEventArgs e)
         {
-            var orderedDifficulties = Playlist.Where(p => p.Beatmap.Value != null).Select(p => p.Beatmap.Value).OrderBy(b => b.StarRating).ToArray();
+            var orderedDifficulties = Playlist.Select(p => p.Beatmap).OrderBy(b => b.StarRating).ToArray();
 
             StarDifficulty minDifficulty = new StarDifficulty(orderedDifficulties.Length > 0 ? orderedDifficulties[0].StarRating : 0, 0);
             StarDifficulty maxDifficulty = new StarDifficulty(orderedDifficulties.Length > 0 ? orderedDifficulties[^1].StarRating : 0, 0);
diff --git a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
index 7674fac88e..4be1927e57 100644
--- a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
+++ b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
@@ -161,7 +161,7 @@ namespace osu.Game.Screens.OnlinePlay
                             Schedule(() => ownerAvatar.User = foundUser);
                         }
 
-                        beatmap = await beatmapLookupCache.GetBeatmapAsync(Item.Beatmap.Value.OnlineID).ConfigureAwait(false);
+                        beatmap = await beatmapLookupCache.GetBeatmapAsync(Item.Beatmap.OnlineID).ConfigureAwait(false);
 
                         Scheduler.AddOnce(refresh);
                     }
diff --git a/osu.Game/Screens/OnlinePlay/Lounge/Components/DrawableRoom.cs b/osu.Game/Screens/OnlinePlay/Lounge/Components/DrawableRoom.cs
index 60f65fbd9f..a1a82c907a 100644
--- a/osu.Game/Screens/OnlinePlay/Lounge/Components/DrawableRoom.cs
+++ b/osu.Game/Screens/OnlinePlay/Lounge/Components/DrawableRoom.cs
@@ -409,7 +409,7 @@ namespace osu.Game.Screens.OnlinePlay.Lounge.Components
                     return;
 
                 var cancellationSource = beatmapLookupCancellation = new CancellationTokenSource();
-                beatmapLookupCache.GetBeatmapAsync(beatmap.Value.OnlineID, cancellationSource.Token)
+                beatmapLookupCache.GetBeatmapAsync(beatmap.OnlineID, cancellationSource.Token)
                                   .ContinueWith(task => Schedule(() =>
                                   {
                                       if (cancellationSource.IsCancellationRequested)
diff --git a/osu.Game/Screens/OnlinePlay/Match/DrawableMatchRoom.cs b/osu.Game/Screens/OnlinePlay/Match/DrawableMatchRoom.cs
index a7b907c7d2..cdd2ae0c9c 100644
--- a/osu.Game/Screens/OnlinePlay/Match/DrawableMatchRoom.cs
+++ b/osu.Game/Screens/OnlinePlay/Match/DrawableMatchRoom.cs
@@ -62,7 +62,7 @@ namespace osu.Game.Screens.OnlinePlay.Match
             if (editButton != null)
                 host.BindValueChanged(h => editButton.Alpha = h.NewValue?.Equals(api.LocalUser.Value) == true ? 1 : 0, true);
 
-            SelectedItem.BindValueChanged(item => background.Beatmap.Value = item.NewValue?.Beatmap.Value, true);
+            SelectedItem.BindValueChanged(item => background.Beatmap.Value = item.NewValue?.Beatmap, true);
         }
 
         protected override Drawable CreateBackground() => background = new BackgroundSprite();
diff --git a/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs b/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
index 836629ada0..e297c90491 100644
--- a/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
@@ -376,7 +376,7 @@ namespace osu.Game.Screens.OnlinePlay.Match
 
         private void updateWorkingBeatmap()
         {
-            var beatmap = SelectedItem.Value?.Beatmap.Value;
+            var beatmap = SelectedItem.Value?.Beatmap;
 
             // Retrieve the corresponding local beatmap, since we can't directly use the playlist's beatmap info
             var localBeatmap = beatmap == null ? null : beatmapManager.QueryBeatmap(b => b.OnlineID == beatmap.OnlineID);
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs
index 12caf1fde1..e30ec36e9c 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs
@@ -67,8 +67,8 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
                 var multiplayerItem = new MultiplayerPlaylistItem
                 {
                     ID = itemToEdit ?? 0,
-                    BeatmapID = item.BeatmapID,
-                    BeatmapChecksum = item.Beatmap.Value.MD5Hash,
+                    BeatmapID = item.Beatmap.OnlineID,
+                    BeatmapChecksum = item.Beatmap.MD5Hash,
                     RulesetID = item.RulesetID,
                     RequiredMods = item.RequiredMods.ToArray(),
                     AllowedMods = item.AllowedMods.ToArray()
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
index cb50a56052..429b0ad89b 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
@@ -5,7 +5,6 @@ using System;
 using System.Collections.Generic;
 using System.Diagnostics;
 using System.Linq;
-using System.Threading.Tasks;
 using JetBrains.Annotations;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
@@ -398,38 +397,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
         private void updateCurrentItem()
         {
             Debug.Assert(client.Room != null);
-
-            var expectedSelectedItem = Room.Playlist.SingleOrDefault(i => i.ID == client.Room.Settings.PlaylistItemId);
-
-            if (expectedSelectedItem == null)
-                return;
-
-            // There's no reason to renew the selected item if its content hasn't changed.
-            if (SelectedItem.Value?.Equals(expectedSelectedItem) == true && expectedSelectedItem.Beatmap.Value != null)
-                return;
-
-            // Clear the selected item while the lookup is performed, so components like the ready button can enter their disabled states.
-            SelectedItem.Value = null;
-
-            if (expectedSelectedItem.Beatmap.Value == null)
-            {
-                Task.Run(async () =>
-                {
-                    var beatmap = await client.GetAPIBeatmap(expectedSelectedItem.BeatmapID).ConfigureAwait(false);
-
-                    Schedule(() =>
-                    {
-                        expectedSelectedItem.Beatmap.Value = beatmap;
-
-                        if (Room.Playlist.SingleOrDefault(i => i.ID == client.Room?.Settings.PlaylistItemId)?.Equals(expectedSelectedItem) == true)
-                            applyCurrentItem();
-                    });
-                });
-            }
-            else
-                applyCurrentItem();
-
-            void applyCurrentItem() => SelectedItem.Value = expectedSelectedItem;
+            SelectedItem.Value = Room.Playlist.SingleOrDefault(i => i.ID == client.Room.Settings.PlaylistItemId);
         }
 
         private void handleRoomLost() => Schedule(() =>
diff --git a/osu.Game/Screens/OnlinePlay/OnlinePlaySongSelect.cs b/osu.Game/Screens/OnlinePlay/OnlinePlaySongSelect.cs
index eab1f83967..7b64784316 100644
--- a/osu.Game/Screens/OnlinePlay/OnlinePlaySongSelect.cs
+++ b/osu.Game/Screens/OnlinePlay/OnlinePlaySongSelect.cs
@@ -113,12 +113,8 @@ namespace osu.Game.Screens.OnlinePlay
         {
             itemSelected = true;
 
-            var item = new PlaylistItem
+            var item = new PlaylistItem(Beatmap.Value.BeatmapInfo)
             {
-                Beatmap =
-                {
-                    Value = Beatmap.Value.BeatmapInfo
-                },
                 RulesetID = Ruleset.Value.OnlineID,
                 RequiredMods = Mods.Value.Select(m => new APIMod(m)).ToArray(),
                 AllowedMods = FreeMods.Value.Select(m => new APIMod(m)).ToArray()
diff --git a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsPlayer.cs b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsPlayer.cs
index 2b071175d5..8403e1e0fe 100644
--- a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsPlayer.cs
+++ b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsPlayer.cs
@@ -34,7 +34,7 @@ namespace osu.Game.Screens.OnlinePlay.Playlists
         private void load(IBindable<RulesetInfo> ruleset)
         {
             // Sanity checks to ensure that PlaylistsPlayer matches the settings for the current PlaylistItem
-            if (!Beatmap.Value.BeatmapInfo.MatchesOnlineID(PlaylistItem.Beatmap.Value))
+            if (!Beatmap.Value.BeatmapInfo.MatchesOnlineID(PlaylistItem.Beatmap))
                 throw new InvalidOperationException("Current Beatmap does not match PlaylistItem's Beatmap");
 
             if (ruleset.Value.OnlineID != PlaylistItem.RulesetID)
diff --git a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSettingsOverlay.cs b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSettingsOverlay.cs
index 6c8ab52d22..6674a37c3c 100644
--- a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSettingsOverlay.cs
+++ b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSettingsOverlay.cs
@@ -392,7 +392,7 @@ namespace osu.Game.Screens.OnlinePlay.Playlists
 
                     foreach (var item in Playlist)
                     {
-                        if (invalidBeatmapIDs.Contains(item.BeatmapID))
+                        if (invalidBeatmapIDs.Contains(item.Beatmap.OnlineID))
                             item.MarkInvalid();
                     }
                 }
diff --git a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsSongSelect.cs b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsSongSelect.cs
index 3ac576b18e..86591c1d6d 100644
--- a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsSongSelect.cs
+++ b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsSongSelect.cs
@@ -41,10 +41,9 @@ namespace osu.Game.Screens.OnlinePlay.Playlists
 
         private void createNewItem()
         {
-            PlaylistItem item = new PlaylistItem
+            PlaylistItem item = new PlaylistItem(Beatmap.Value.BeatmapInfo)
             {
                 ID = Playlist.Count == 0 ? 0 : Playlist.Max(p => p.ID) + 1,
-                Beatmap = { Value = Beatmap.Value.BeatmapInfo },
                 RulesetID = Ruleset.Value.OnlineID,
                 RequiredMods = Mods.Value.Select(m => new APIMod(m)).ToArray(),
                 AllowedMods = FreeMods.Value.Select(m => new APIMod(m)).ToArray()
diff --git a/osu.Game/Tests/Visual/Multiplayer/MultiplayerTestScene.cs b/osu.Game/Tests/Visual/Multiplayer/MultiplayerTestScene.cs
index a9b3ca4991..2fecf0a4cc 100644
--- a/osu.Game/Tests/Visual/Multiplayer/MultiplayerTestScene.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/MultiplayerTestScene.cs
@@ -46,9 +46,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 Name = { Value = "test name" },
                 Playlist =
                 {
-                    new PlaylistItem
+                    new PlaylistItem(new TestBeatmap(Ruleset.Value).BeatmapInfo)
                     {
-                        Beatmap = { Value = new TestBeatmap(Ruleset.Value).BeatmapInfo },
                         RulesetID = Ruleset.Value.OnlineID
                     }
                 }
diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
index 15ede6cc26..6dc5159b6f 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
@@ -7,14 +7,11 @@ using System;
 using System.Collections.Generic;
 using System.Diagnostics;
 using System.Linq;
-using System.Threading;
 using System.Threading.Tasks;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Extensions;
-using osu.Game.Beatmaps;
 using osu.Game.Online.API;
-using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Multiplayer.MatchTypes.TeamVersus;
 using osu.Game.Online.Rooms;
@@ -39,9 +36,6 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [Resolved]
         private IAPIProvider api { get; set; } = null!;
 
-        [Resolved]
-        private BeatmapManager beatmaps { get; set; } = null!;
-
         private readonly TestMultiplayerRoomManager roomManager;
 
         /// <summary>
@@ -407,23 +401,6 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
         public override Task RemovePlaylistItem(long playlistItemId) => RemoveUserPlaylistItem(api.LocalUser.Value.OnlineID, playlistItemId);
 
-        public override Task<APIBeatmap> GetAPIBeatmap(int beatmapId, CancellationToken cancellationToken = default)
-        {
-            IBeatmapInfo? beatmap = roomManager.ServerSideRooms.SelectMany(r => r.Playlist)
-                                               .FirstOrDefault(p => p.BeatmapID == beatmapId)?.Beatmap.Value
-                                    ?? beatmaps.QueryBeatmap(b => b.OnlineID == beatmapId);
-
-            if (beatmap == null)
-                throw new InvalidOperationException("Beatmap not found.");
-
-            return Task.FromResult(new APIBeatmap
-            {
-                BeatmapSet = new APIBeatmapSet { OnlineID = beatmap.BeatmapSet?.OnlineID ?? -1 },
-                OnlineID = beatmapId,
-                Checksum = beatmap.MD5Hash
-            });
-        }
-
         private async Task changeMatchType(MatchType type)
         {
             Debug.Assert(Room != null);
diff --git a/osu.Game/Tests/Visual/OnlinePlay/TestRoomManager.cs b/osu.Game/Tests/Visual/OnlinePlay/TestRoomManager.cs
index 73d0df2c36..8dfd969c51 100644
--- a/osu.Game/Tests/Visual/OnlinePlay/TestRoomManager.cs
+++ b/osu.Game/Tests/Visual/OnlinePlay/TestRoomManager.cs
@@ -43,16 +43,9 @@ namespace osu.Game.Tests.Visual.OnlinePlay
 
                 if (ruleset != null)
                 {
-                    room.Playlist.Add(new PlaylistItem
+                    room.Playlist.Add(new PlaylistItem(new BeatmapInfo { Metadata = new BeatmapMetadata() })
                     {
                         RulesetID = ruleset.OnlineID,
-                        Beatmap =
-                        {
-                            Value = new BeatmapInfo
-                            {
-                                Metadata = new BeatmapMetadata()
-                            }
-                        }
                     });
                 }
 

From 48573d2401d33434399f9abaf98659ac2776fa81 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 15 Feb 2022 23:42:37 +0900
Subject: [PATCH 2924/5547] Move test request handling earlier in setup

---
 .../Visual/OnlinePlay/OnlinePlayTestScene.cs  | 24 +++++++------------
 1 file changed, 8 insertions(+), 16 deletions(-)

diff --git a/osu.Game/Tests/Visual/OnlinePlay/OnlinePlayTestScene.cs b/osu.Game/Tests/Visual/OnlinePlay/OnlinePlayTestScene.cs
index 448ec5e3d9..b6a347a896 100644
--- a/osu.Game/Tests/Visual/OnlinePlay/OnlinePlayTestScene.cs
+++ b/osu.Game/Tests/Visual/OnlinePlay/OnlinePlayTestScene.cs
@@ -60,24 +60,16 @@ namespace osu.Game.Tests.Visual.OnlinePlay
             drawableDependenciesContainer.Clear();
             dependencies.OnlinePlayDependencies = CreateOnlinePlayDependencies();
             drawableDependenciesContainer.AddRange(OnlinePlayDependencies.DrawableComponents);
+
+            var handler = OnlinePlayDependencies.RequestsHandler;
+
+            // Resolving the BeatmapManager in the test scene will inject the game-wide BeatmapManager, while many test scenes cache their own BeatmapManager instead.
+            // To get around this, the BeatmapManager is looked up from the dependencies provided to the children of the test scene instead.
+            var beatmapManager = dependencies.Get<BeatmapManager>();
+
+            ((DummyAPIAccess)API).HandleRequest = request => handler.HandleRequest(request, API.LocalUser.Value, beatmapManager);
         });
 
-        public override void SetUpSteps()
-        {
-            base.SetUpSteps();
-
-            AddStep("setup API", () =>
-            {
-                var handler = OnlinePlayDependencies.RequestsHandler;
-
-                // Resolving the BeatmapManager in the test scene will inject the game-wide BeatmapManager, while many test scenes cache their own BeatmapManager instead.
-                // To get around this, the BeatmapManager is looked up from the dependencies provided to the children of the test scene instead.
-                var beatmapManager = dependencies.Get<BeatmapManager>();
-
-                ((DummyAPIAccess)API).HandleRequest = request => handler.HandleRequest(request, API.LocalUser.Value, beatmapManager);
-            });
-        }
-
         /// <summary>
         /// Creates the room dependencies. Called every <see cref="Setup"/>.
         /// </summary>

From b1dbd4abfe6697134717439d1fbe06eb91c94cf5 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 15 Feb 2022 23:50:07 +0900
Subject: [PATCH 2925/5547] Fix incorrect playlist item <-> availability
 tracker logic

Results in revert to some prior logic for the tracker implementation.
---
 .../OnlinePlayBeatmapAvailabilityTracker.cs   | 19 +++++++++----------
 .../OnlinePlay/DrawableRoomPlaylistItem.cs    |  5 +----
 2 files changed, 10 insertions(+), 14 deletions(-)

diff --git a/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs b/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs
index 3620e703ae..02bcd1f30c 100644
--- a/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs
+++ b/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs
@@ -96,7 +96,7 @@ namespace osu.Game.Online.Rooms
 
             // handles changes to hash that didn't occur from the import process (ie. a user editing the beatmap in the editor, somehow).
             realmSubscription?.Dispose();
-            realmSubscription = realm.RegisterForNotifications(r => QueryBeatmapForOnlinePlay(r, SelectedItem.Value.Beatmap), (items, changes, ___) =>
+            realmSubscription = realm.RegisterForNotifications(r => filteredBeatmaps(beatmap), (items, changes, ___) =>
             {
                 if (changes == null)
                     return;
@@ -125,7 +125,7 @@ namespace osu.Game.Online.Rooms
                     break;
 
                 case DownloadState.LocallyAvailable:
-                    bool available = QueryBeatmapForOnlinePlay(realm.Realm, beatmap).Any();
+                    bool available = filteredBeatmaps(beatmap).Any();
 
                     availability.Value = available ? BeatmapAvailability.LocallyAvailable() : BeatmapAvailability.NotDownloaded();
 
@@ -140,15 +140,14 @@ namespace osu.Game.Online.Rooms
             }
         }
 
-        /// <summary>
-        /// Performs a query for a local <see cref="BeatmapInfo"/> matching a requested one for the purpose of online play.
-        /// </summary>
-        /// <param name="realm">The realm to query from.</param>
-        /// <param name="beatmap">The requested beatmap.</param>
-        /// <returns>A beatmap query.</returns>
-        public static IQueryable<BeatmapInfo> QueryBeatmapForOnlinePlay(Realm realm, IBeatmapInfo beatmap)
+        private IQueryable<BeatmapInfo> filteredBeatmaps(APIBeatmap beatmap)
         {
-            return realm.All<BeatmapInfo>().Filter("OnlineID == $0 && MD5Hash == $1 && BeatmapSet.DeletePending == false", beatmap.OnlineID, beatmap.MD5Hash);
+            int onlineId = beatmap.OnlineID;
+            string checksum = beatmap.MD5Hash;
+
+            return realm.Realm
+                        .All<BeatmapInfo>()
+                        .Filter("OnlineID == $0 && MD5Hash == $1 && BeatmapSet.DeletePending == false", onlineId, checksum);
         }
 
         protected override void Dispose(bool isDisposing)
diff --git a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
index 4be1927e57..faeb73cfa3 100644
--- a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
+++ b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
@@ -97,9 +97,6 @@ namespace osu.Game.Screens.OnlinePlay
         [Resolved]
         private BeatmapLookupCache beatmapLookupCache { get; set; }
 
-        [Resolved]
-        private RealmAccess realm { get; set; }
-
         protected override bool ShouldBeConsideredForInput(Drawable child) => AllowReordering || AllowDeletion || !AllowSelection || SelectedItem.Value == Model;
 
         public DrawableRoomPlaylistItem(PlaylistItem item)
@@ -444,7 +441,7 @@ namespace osu.Game.Screens.OnlinePlay
                     Alpha = AllowShowingResults ? 1 : 0,
                     TooltipText = "View results"
                 },
-                OnlinePlayBeatmapAvailabilityTracker.QueryBeatmapForOnlinePlay(realm.Realm, beatmap).Any() ? Empty() : new PlaylistDownloadButton(beatmap),
+                beatmap == null ? Empty() : new PlaylistDownloadButton(beatmap),
                 editButton = new PlaylistEditButton
                 {
                     Size = new Vector2(30, 30),

From f5b34e03139a7d098fe30e44c9e6fcad3cd890ca Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 15 Feb 2022 23:51:44 +0900
Subject: [PATCH 2926/5547] Fix some test failures due to now-async lookups

---
 .../Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs       | 4 ++--
 .../Multiplayer/TestScenePlaylistsRoomSettingsPlaylist.cs     | 3 +--
 2 files changed, 3 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
index bea15e6e58..4f01c14659 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
@@ -168,7 +168,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             assertDownloadButtonVisible(false);
 
             void assertDownloadButtonVisible(bool visible) => AddUntilStep($"download button {(visible ? "shown" : "hidden")}",
-                () => playlist.ChildrenOfType<BeatmapDownloadButton>().Single().Alpha == (visible ? 1 : 0));
+                () => playlist.ChildrenOfType<BeatmapDownloadButton>().SingleOrDefault()?.Alpha == (visible ? 1 : 0));
         }
 
         [Test]
@@ -260,7 +260,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         }
 
         private void moveToItem(int index, Vector2? offset = null)
-            => AddStep($"move mouse to item {index}", () => InputManager.MoveMouseTo(playlist.ChildrenOfType<DifficultyIcon>().ElementAt(index), offset));
+            => AddStep($"move mouse to item {index}", () => InputManager.MoveMouseTo(playlist.ChildrenOfType<DrawableRoomPlaylistItem>().ElementAt(index), offset));
 
         private void moveToDragger(int index, Vector2? offset = null) => AddStep($"move mouse to dragger {index}", () =>
         {
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsRoomSettingsPlaylist.cs b/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsRoomSettingsPlaylist.cs
index 0ef8b16f68..98dc243ab5 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsRoomSettingsPlaylist.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsRoomSettingsPlaylist.cs
@@ -8,7 +8,6 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
-using osu.Game.Beatmaps.Drawables;
 using osu.Game.Graphics.Containers;
 using osu.Game.Models;
 using osu.Game.Online.API;
@@ -108,7 +107,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         }
 
         private void moveToItem(int index, Vector2? offset = null)
-            => AddStep($"move mouse to item {index}", () => InputManager.MoveMouseTo(playlist.ChildrenOfType<DifficultyIcon>().ElementAt(index), offset));
+            => AddStep($"move mouse to item {index}", () => InputManager.MoveMouseTo(playlist.ChildrenOfType<DrawableRoomPlaylistItem>().ElementAt(index), offset));
 
         private void moveToDeleteButton(int index, Vector2? offset = null) => AddStep($"move mouse to delete button {index}", () =>
         {

From 6e99fe04c3b71ce5a36609062ceb08bd6fb1e400 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 16 Feb 2022 00:39:43 +0900
Subject: [PATCH 2927/5547] Revert more NUnit test adapter bumps

---
 .../osu.Game.Rulesets.EmptyFreeform.Tests.csproj                | 2 +-
 .../osu.Game.Rulesets.Pippidon.Tests.csproj                     | 2 +-
 .../osu.Game.Rulesets.EmptyScrolling.Tests.csproj               | 2 +-
 .../osu.Game.Rulesets.Pippidon.Tests.csproj                     | 2 +-
 4 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform.Tests/osu.Game.Rulesets.EmptyFreeform.Tests.csproj b/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform.Tests/osu.Game.Rulesets.EmptyFreeform.Tests.csproj
index c305872288..cb922c5a58 100644
--- a/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform.Tests/osu.Game.Rulesets.EmptyFreeform.Tests.csproj
+++ b/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform.Tests/osu.Game.Rulesets.EmptyFreeform.Tests.csproj
@@ -12,7 +12,7 @@
     <PackageReference Include="Appveyor.TestLogger" Version="2.0.0" />
     <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.0.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
-    <PackageReference Include="NUnit3TestAdapter" Version="4.2.1" />
+    <PackageReference Include="NUnit3TestAdapter" Version="4.1.0" />
     <PackageReference Update="Microsoft.EntityFrameworkCore.Sqlite" Version="2.1.4" />
   </ItemGroup>
   <ItemGroup>
diff --git a/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon.Tests/osu.Game.Rulesets.Pippidon.Tests.csproj b/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon.Tests/osu.Game.Rulesets.Pippidon.Tests.csproj
index ec90885cd9..5ecd9cc675 100644
--- a/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon.Tests/osu.Game.Rulesets.Pippidon.Tests.csproj
+++ b/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon.Tests/osu.Game.Rulesets.Pippidon.Tests.csproj
@@ -12,7 +12,7 @@
     <PackageReference Include="Appveyor.TestLogger" Version="2.0.0" />
     <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.0.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
-    <PackageReference Include="NUnit3TestAdapter" Version="4.2.1" />
+    <PackageReference Include="NUnit3TestAdapter" Version="4.1.0" />
     <PackageReference Update="Microsoft.EntityFrameworkCore.Sqlite" Version="2.1.4" />
   </ItemGroup>
   <ItemGroup>
diff --git a/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling.Tests/osu.Game.Rulesets.EmptyScrolling.Tests.csproj b/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling.Tests/osu.Game.Rulesets.EmptyScrolling.Tests.csproj
index f2e143a9c5..33ad0ac4f7 100644
--- a/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling.Tests/osu.Game.Rulesets.EmptyScrolling.Tests.csproj
+++ b/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling.Tests/osu.Game.Rulesets.EmptyScrolling.Tests.csproj
@@ -12,7 +12,7 @@
     <PackageReference Include="Appveyor.TestLogger" Version="2.0.0" />
     <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.0.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
-    <PackageReference Include="NUnit3TestAdapter" Version="4.2.1" />
+    <PackageReference Include="NUnit3TestAdapter" Version="4.1.0" />
     <PackageReference Update="Microsoft.EntityFrameworkCore.Sqlite" Version="2.1.4" />
   </ItemGroup>
   <ItemGroup>
diff --git a/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon.Tests/osu.Game.Rulesets.Pippidon.Tests.csproj b/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon.Tests/osu.Game.Rulesets.Pippidon.Tests.csproj
index ec90885cd9..5ecd9cc675 100644
--- a/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon.Tests/osu.Game.Rulesets.Pippidon.Tests.csproj
+++ b/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon.Tests/osu.Game.Rulesets.Pippidon.Tests.csproj
@@ -12,7 +12,7 @@
     <PackageReference Include="Appveyor.TestLogger" Version="2.0.0" />
     <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.0.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
-    <PackageReference Include="NUnit3TestAdapter" Version="4.2.1" />
+    <PackageReference Include="NUnit3TestAdapter" Version="4.1.0" />
     <PackageReference Update="Microsoft.EntityFrameworkCore.Sqlite" Version="2.1.4" />
   </ItemGroup>
   <ItemGroup>

From f7edf25d4c84e2bc61a3f95efd22de52409fc66b Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 16 Feb 2022 03:23:02 +0300
Subject: [PATCH 2928/5547] Remove no longer required property

---
 osu.Game/Overlays/SettingsToolboxGroup.cs | 7 -------
 1 file changed, 7 deletions(-)

diff --git a/osu.Game/Overlays/SettingsToolboxGroup.cs b/osu.Game/Overlays/SettingsToolboxGroup.cs
index 509410ec20..08321f68fe 100644
--- a/osu.Game/Overlays/SettingsToolboxGroup.cs
+++ b/osu.Game/Overlays/SettingsToolboxGroup.cs
@@ -22,11 +22,6 @@ namespace osu.Game.Overlays
 {
     public class SettingsToolboxGroup : Container, IExpandable
     {
-        /// <summary>
-        /// The title of this toolbox group.
-        /// </summary>
-        public string Title { get; }
-
         private const float transition_duration = 250;
         private const int container_width = 270;
         private const int border_thickness = 2;
@@ -53,8 +48,6 @@ namespace osu.Game.Overlays
         /// <param name="title">The title to be displayed in the header of this group.</param>
         public SettingsToolboxGroup(string title)
         {
-            Title = title;
-
             AutoSizeAxes = Axes.Y;
             Width = container_width;
             Masking = true;

From 7654584e40e8860a20f6bfce1322d6b331da92af Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 16 Feb 2022 03:25:03 +0300
Subject: [PATCH 2929/5547] Allow using `SizeSlider` on different value types

---
 .../Visual/UserInterface/TestSceneExpandingContainer.cs     | 4 ++--
 .../Overlays/Settings/Sections/Gameplay/InputSettings.cs    | 2 +-
 osu.Game/Overlays/Settings/Sections/SizeSlider.cs           | 6 ++++--
 .../Settings/Sections/UserInterface/GeneralSettings.cs      | 2 +-
 4 files changed, 8 insertions(+), 6 deletions(-)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneExpandingContainer.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneExpandingContainer.cs
index f4920b4412..288c0cb140 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneExpandingContainer.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneExpandingContainer.cs
@@ -17,7 +17,7 @@ namespace osu.Game.Tests.Visual.UserInterface
         private TestExpandingContainer container;
         private SettingsToolboxGroup toolboxGroup;
 
-        private ExpandableSlider<float, SizeSlider> slider1;
+        private ExpandableSlider<float, SizeSlider<float>> slider1;
         private ExpandableSlider<double> slider2;
 
         [SetUp]
@@ -34,7 +34,7 @@ namespace osu.Game.Tests.Visual.UserInterface
                     Width = 1,
                     Children = new Drawable[]
                     {
-                        slider1 = new ExpandableSlider<float, SizeSlider>
+                        slider1 = new ExpandableSlider<float, SizeSlider<float>>
                         {
                             Current = new BindableFloat
                             {
diff --git a/osu.Game/Overlays/Settings/Sections/Gameplay/InputSettings.cs b/osu.Game/Overlays/Settings/Sections/Gameplay/InputSettings.cs
index 962572ca6e..83ea655601 100644
--- a/osu.Game/Overlays/Settings/Sections/Gameplay/InputSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Gameplay/InputSettings.cs
@@ -19,7 +19,7 @@ namespace osu.Game.Overlays.Settings.Sections.Gameplay
         {
             Children = new Drawable[]
             {
-                new SettingsSlider<float, SizeSlider>
+                new SettingsSlider<float, SizeSlider<float>>
                 {
                     LabelText = SkinSettingsStrings.GameplayCursorSize,
                     Current = config.GetBindable<float>(OsuSetting.GameplayCursorSize),
diff --git a/osu.Game/Overlays/Settings/Sections/SizeSlider.cs b/osu.Game/Overlays/Settings/Sections/SizeSlider.cs
index 8aeb440be1..cc2c77adf2 100644
--- a/osu.Game/Overlays/Settings/Sections/SizeSlider.cs
+++ b/osu.Game/Overlays/Settings/Sections/SizeSlider.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.Localisation;
 using osu.Game.Graphics.UserInterface;
 
@@ -9,8 +10,9 @@ namespace osu.Game.Overlays.Settings.Sections
     /// <summary>
     /// A slider intended to show a "size" multiplier number, where 1x is 1.0.
     /// </summary>
-    internal class SizeSlider : OsuSliderBar<float>
+    internal class SizeSlider<T> : OsuSliderBar<T>
+        where T : struct, IEquatable<T>, IComparable<T>, IConvertible, IFormattable
     {
-        public override LocalisableString TooltipText => Current.Value.ToString(@"0.##x");
+        public override LocalisableString TooltipText => Current.Value.ToString(@"0.##x", null);
     }
 }
diff --git a/osu.Game/Overlays/Settings/Sections/UserInterface/GeneralSettings.cs b/osu.Game/Overlays/Settings/Sections/UserInterface/GeneralSettings.cs
index 0afbed5df5..66702744d3 100644
--- a/osu.Game/Overlays/Settings/Sections/UserInterface/GeneralSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/UserInterface/GeneralSettings.cs
@@ -24,7 +24,7 @@ namespace osu.Game.Overlays.Settings.Sections.UserInterface
                     LabelText = UserInterfaceStrings.CursorRotation,
                     Current = config.GetBindable<bool>(OsuSetting.CursorRotation)
                 },
-                new SettingsSlider<float, SizeSlider>
+                new SettingsSlider<float, SizeSlider<float>>
                 {
                     LabelText = UserInterfaceStrings.MenuCursorSize,
                     Current = config.GetBindable<float>(OsuSetting.MenuCursorSize),

From 0992bec2c849d9e5a7be97d1d9396027a1f8f4e1 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 16 Feb 2022 03:28:05 +0300
Subject: [PATCH 2930/5547] Change "distance spacing" multipler type to
 `double`

Avoids losing precision on initial load, causing an unnecessary
hash change in `EditorChangeHandler`.

Resolves test failures in `TestSceneEditorChangeStates`
(https://github.com/ppy/osu/runs/5192493482?check_suite_focus=true).
---
 .../Editor/TestSceneManiaBeatSnapGrid.cs      |  2 +-
 .../Editor/TestSceneOsuDistanceSnapGrid.cs    |  2 +-
 .../Editing/TestSceneDistanceSnapGrid.cs      |  2 +-
 osu.Game/Rulesets/Edit/HitObjectComposer.cs   | 20 +++++++++----------
 .../Rulesets/Edit/IPositionSnapProvider.cs    |  2 +-
 .../Compose/Components/DistanceSnapGrid.cs    |  2 +-
 .../Compose/Components/Timeline/Timeline.cs   |  2 +-
 7 files changed, 16 insertions(+), 16 deletions(-)

diff --git a/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneManiaBeatSnapGrid.cs b/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneManiaBeatSnapGrid.cs
index 38779ab47b..f32a1a823e 100644
--- a/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneManiaBeatSnapGrid.cs
+++ b/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneManiaBeatSnapGrid.cs
@@ -99,7 +99,7 @@ namespace osu.Game.Rulesets.Mania.Tests.Editor
             set => InternalChild = value;
         }
 
-        public override IBindable<float> DistanceSpacingMultiplier => throw new System.NotImplementedException();
+        public override IBindable<double> DistanceSpacingMultiplier => throw new System.NotImplementedException();
 
         public override SnapResult SnapScreenSpacePositionToValidTime(Vector2 screenSpacePosition)
         {
diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuDistanceSnapGrid.cs b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuDistanceSnapGrid.cs
index c5829d5351..38a442d48b 100644
--- a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuDistanceSnapGrid.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuDistanceSnapGrid.cs
@@ -187,7 +187,7 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
 
             public SnapResult SnapScreenSpacePositionToValidTime(Vector2 screenSpacePosition) => new SnapResult(screenSpacePosition, 0);
 
-            public IBindable<float> DistanceSpacingMultiplier { get; } = new BindableFloat(1);
+            public IBindable<double> DistanceSpacingMultiplier { get; } = new BindableDouble(1);
 
             public float GetBeatSnapDistanceAt(HitObject referenceObject) => (float)beat_length;
 
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneDistanceSnapGrid.cs b/osu.Game.Tests/Visual/Editing/TestSceneDistanceSnapGrid.cs
index cba6d7692d..69fd642143 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneDistanceSnapGrid.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneDistanceSnapGrid.cs
@@ -167,7 +167,7 @@ namespace osu.Game.Tests.Visual.Editing
 
             public SnapResult SnapScreenSpacePositionToValidTime(Vector2 screenSpacePosition) => new SnapResult(screenSpacePosition, 0);
 
-            public IBindable<float> DistanceSpacingMultiplier { get; } = new BindableFloat(1);
+            public IBindable<double> DistanceSpacingMultiplier { get; } = new BindableDouble(1);
 
             public float GetBeatSnapDistanceAt(HitObject referenceObject) => 10;
 
diff --git a/osu.Game/Rulesets/Edit/HitObjectComposer.cs b/osu.Game/Rulesets/Edit/HitObjectComposer.cs
index 948e1d770f..ab82fbad04 100644
--- a/osu.Game/Rulesets/Edit/HitObjectComposer.cs
+++ b/osu.Game/Rulesets/Edit/HitObjectComposer.cs
@@ -66,15 +66,15 @@ namespace osu.Game.Rulesets.Edit
         /// </remarks>
         protected abstract bool SupportsDistanceSpacing { get; }
 
-        private readonly BindableFloat distanceSpacing = new BindableFloat
+        private readonly BindableDouble distanceSpacing = new BindableDouble
         {
-            Default = 1.0f,
-            MinValue = 0.1f,
-            MaxValue = 6.0f,
-            Precision = 0.01f,
+            Default = 1.0,
+            MinValue = 0.1,
+            MaxValue = 6.0,
+            Precision = 0.01,
         };
 
-        public override IBindable<float> DistanceSpacingMultiplier => distanceSpacing;
+        public override IBindable<double> DistanceSpacingMultiplier => distanceSpacing;
 
         private SnappingToolboxContainer snappingToolboxContainer;
 
@@ -161,11 +161,11 @@ namespace osu.Game.Rulesets.Edit
                 },
             };
 
-            distanceSpacing.Value = (float)EditorBeatmap.BeatmapInfo.DistanceSpacing;
+            distanceSpacing.Value = EditorBeatmap.BeatmapInfo.DistanceSpacing;
 
             if (SupportsDistanceSpacing)
             {
-                ExpandableSlider<float, SizeSlider> distanceSpacingSlider;
+                ExpandableSlider<double, SizeSlider<double>> distanceSpacingSlider;
 
                 AddInternal(snappingToolboxContainer = new SnappingToolboxContainer
                 {
@@ -173,7 +173,7 @@ namespace osu.Game.Rulesets.Edit
                     Origin = Anchor.TopRight,
                     Child = new EditorToolboxGroup("snapping")
                     {
-                        Child = distanceSpacingSlider = new ExpandableSlider<float, SizeSlider>
+                        Child = distanceSpacingSlider = new ExpandableSlider<double, SizeSlider<double>>
                         {
                             Current = { BindTarget = distanceSpacing },
                             KeyboardStep = 0.01f,
@@ -563,7 +563,7 @@ namespace osu.Game.Rulesets.Edit
 
         #region IPositionSnapProvider
 
-        public abstract IBindable<float> DistanceSpacingMultiplier { get; }
+        public abstract IBindable<double> DistanceSpacingMultiplier { get; }
 
         public abstract SnapResult SnapScreenSpacePositionToValidTime(Vector2 screenSpacePosition);
 
diff --git a/osu.Game/Rulesets/Edit/IPositionSnapProvider.cs b/osu.Game/Rulesets/Edit/IPositionSnapProvider.cs
index 1cfcb86e10..e4adbba47d 100644
--- a/osu.Game/Rulesets/Edit/IPositionSnapProvider.cs
+++ b/osu.Game/Rulesets/Edit/IPositionSnapProvider.cs
@@ -14,7 +14,7 @@ namespace osu.Game.Rulesets.Edit
         /// The spacing multiplier applied to beat snap distances.
         /// </summary>
         /// <seealso cref="BeatmapInfo.DistanceSpacing"/>
-        IBindable<float> DistanceSpacingMultiplier { get; }
+        IBindable<double> DistanceSpacingMultiplier { get; }
 
         /// <summary>
         /// Given a position, find a valid time and position snap.
diff --git a/osu.Game/Screens/Edit/Compose/Components/DistanceSnapGrid.cs b/osu.Game/Screens/Edit/Compose/Components/DistanceSnapGrid.cs
index afbe83ec83..f9e4ef086c 100644
--- a/osu.Game/Screens/Edit/Compose/Components/DistanceSnapGrid.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/DistanceSnapGrid.cs
@@ -53,7 +53,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
         [Resolved]
         private BindableBeatDivisor beatDivisor { get; set; }
 
-        private IBindable<float> distanceSpacingMultiplier;
+        private IBindable<double> distanceSpacingMultiplier;
 
         private readonly LayoutValue gridCache = new LayoutValue(Invalidation.RequiredParentSizeToFit);
         private readonly double? endTime;
diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/Timeline.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/Timeline.cs
index f3a328c6bc..8832c4e89c 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/Timeline.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/Timeline.cs
@@ -317,7 +317,7 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
         private double getTimeFromPosition(Vector2 localPosition) =>
             (localPosition.X / Content.DrawWidth) * track.Length;
 
-        public IBindable<float> DistanceSpacingMultiplier => throw new NotImplementedException();
+        public IBindable<double> DistanceSpacingMultiplier => throw new NotImplementedException();
 
         public float GetBeatSnapDistanceAt(HitObject referenceObject) => throw new NotImplementedException();
 

From 6a08fd57efb0012a723d658bc279d88292f3754e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 16 Feb 2022 09:43:28 +0900
Subject: [PATCH 2931/5547] Rename "client" fields in tests to specify whether
 spectator or multiplayer

---
 .../StatefulMultiplayerClientTest.cs          |  28 +--
 .../Visual/Gameplay/TestSceneSpectator.cs     |   6 +-
 .../Visual/Multiplayer/QueueModeTestScene.cs  |  10 +-
 .../TestSceneAllPlayersQueueMode.cs           |  38 ++--
 .../TestSceneCreateMultiplayerMatchButton.cs  |   4 +-
 .../Multiplayer/TestSceneHostOnlyQueueMode.cs |  26 +--
 .../TestSceneMultiSpectatorLeaderboard.cs     |   2 +-
 .../TestSceneMultiSpectatorScreen.cs          |  12 +-
 .../Multiplayer/TestSceneMultiplayer.cs       | 180 +++++++++---------
 ...TestSceneMultiplayerGameplayLeaderboard.cs |   6 +-
 ...ceneMultiplayerGameplayLeaderboardTeams.cs |   4 +-
 .../TestSceneMultiplayerMatchSubScreen.cs     |  10 +-
 .../TestSceneMultiplayerParticipantsList.cs   |  98 +++++-----
 .../Multiplayer/TestSceneMultiplayerPlayer.cs |   6 +-
 .../TestSceneMultiplayerPlaylist.cs           |  12 +-
 .../TestSceneMultiplayerQueueList.cs          |  28 +--
 .../TestSceneMultiplayerReadyButton.cs        |  56 +++---
 .../TestSceneMultiplayerSpectateButton.cs     |  26 +--
 .../Multiplayer/TestSceneRankRangePill.cs     |  18 +-
 .../Visual/Multiplayer/TestSceneTeamVersus.cs |  30 +--
 .../Visual/TestMultiplayerComponents.cs       |   4 +-
 .../IMultiplayerTestSceneDependencies.cs      |   5 +-
 .../Multiplayer/MultiplayerTestScene.cs       |   4 +-
 .../MultiplayerTestSceneDependencies.cs       |   6 +-
 24 files changed, 309 insertions(+), 310 deletions(-)

diff --git a/osu.Game.Tests/NonVisual/Multiplayer/StatefulMultiplayerClientTest.cs b/osu.Game.Tests/NonVisual/Multiplayer/StatefulMultiplayerClientTest.cs
index 0c49a18c8f..4adb7002a0 100644
--- a/osu.Game.Tests/NonVisual/Multiplayer/StatefulMultiplayerClientTest.cs
+++ b/osu.Game.Tests/NonVisual/Multiplayer/StatefulMultiplayerClientTest.cs
@@ -21,8 +21,8 @@ namespace osu.Game.Tests.NonVisual.Multiplayer
         {
             var user = new APIUser { Id = 33 };
 
-            AddRepeatStep("add user multiple times", () => Client.AddUser(user), 3);
-            AddAssert("room has 2 users", () => Client.Room?.Users.Count == 2);
+            AddRepeatStep("add user multiple times", () => MultiplayerClient.AddUser(user), 3);
+            AddAssert("room has 2 users", () => MultiplayerClient.Room?.Users.Count == 2);
         }
 
         [Test]
@@ -30,11 +30,11 @@ namespace osu.Game.Tests.NonVisual.Multiplayer
         {
             var user = new APIUser { Id = 44 };
 
-            AddStep("add user", () => Client.AddUser(user));
-            AddAssert("room has 2 users", () => Client.Room?.Users.Count == 2);
+            AddStep("add user", () => MultiplayerClient.AddUser(user));
+            AddAssert("room has 2 users", () => MultiplayerClient.Room?.Users.Count == 2);
 
-            AddRepeatStep("remove user multiple times", () => Client.RemoveUser(user), 3);
-            AddAssert("room has 1 user", () => Client.Room?.Users.Count == 1);
+            AddRepeatStep("remove user multiple times", () => MultiplayerClient.RemoveUser(user), 3);
+            AddAssert("room has 1 user", () => MultiplayerClient.Room?.Users.Count == 1);
         }
 
         [Test]
@@ -42,7 +42,7 @@ namespace osu.Game.Tests.NonVisual.Multiplayer
         {
             int id = 2000;
 
-            AddRepeatStep("add some users", () => Client.AddUser(new APIUser { Id = id++ }), 5);
+            AddRepeatStep("add some users", () => MultiplayerClient.AddUser(new APIUser { Id = id++ }), 5);
             checkPlayingUserCount(0);
 
             changeState(3, MultiplayerUserState.WaitingForLoad);
@@ -57,17 +57,17 @@ namespace osu.Game.Tests.NonVisual.Multiplayer
             changeState(6, MultiplayerUserState.WaitingForLoad);
             checkPlayingUserCount(6);
 
-            AddStep("another user left", () => Client.RemoveUser((Client.Room?.Users.Last().User).AsNonNull()));
+            AddStep("another user left", () => MultiplayerClient.RemoveUser((MultiplayerClient.Room?.Users.Last().User).AsNonNull()));
             checkPlayingUserCount(5);
 
-            AddStep("leave room", () => Client.LeaveRoom());
+            AddStep("leave room", () => MultiplayerClient.LeaveRoom());
             checkPlayingUserCount(0);
         }
 
         [Test]
         public void TestPlayingUsersUpdatedOnJoin()
         {
-            AddStep("leave room", () => Client.LeaveRoom());
+            AddStep("leave room", () => MultiplayerClient.LeaveRoom());
             AddUntilStep("wait for room part", () => !RoomJoined);
 
             AddStep("create room initially in gameplay", () =>
@@ -76,7 +76,7 @@ namespace osu.Game.Tests.NonVisual.Multiplayer
                 newRoom.CopyFrom(SelectedRoom.Value);
 
                 newRoom.RoomID.Value = null;
-                Client.RoomSetupAction = room =>
+                MultiplayerClient.RoomSetupAction = room =>
                 {
                     room.State = MultiplayerRoomState.Playing;
                     room.Users.Add(new MultiplayerRoomUser(PLAYER_1_ID)
@@ -94,15 +94,15 @@ namespace osu.Game.Tests.NonVisual.Multiplayer
         }
 
         private void checkPlayingUserCount(int expectedCount)
-            => AddAssert($"{"user".ToQuantity(expectedCount)} playing", () => Client.CurrentMatchPlayingUserIds.Count == expectedCount);
+            => AddAssert($"{"user".ToQuantity(expectedCount)} playing", () => MultiplayerClient.CurrentMatchPlayingUserIds.Count == expectedCount);
 
         private void changeState(int userCount, MultiplayerUserState state)
             => AddStep($"{"user".ToQuantity(userCount)} in {state}", () =>
             {
                 for (int i = 0; i < userCount; ++i)
                 {
-                    int userId = Client.Room?.Users[i].UserID ?? throw new AssertionException("Room cannot be null!");
-                    Client.ChangeUserState(userId, state);
+                    int userId = MultiplayerClient.Room?.Users[i].UserID ?? throw new AssertionException("Room cannot be null!");
+                    MultiplayerClient.ChangeUserState(userId, state);
                 }
             });
     }
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs
index 6dca256d31..d47ebf9f0d 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs
@@ -39,7 +39,7 @@ namespace osu.Game.Tests.Visual.Gameplay
         [Resolved]
         private OsuGameBase game { get; set; }
 
-        private TestSpectatorClient spectatorClient => dependenciesScreen.Client;
+        private TestSpectatorClient spectatorClient => dependenciesScreen.SpectatorClient;
         private DependenciesScreen dependenciesScreen;
         private SoloSpectator spectatorScreen;
 
@@ -57,7 +57,7 @@ namespace osu.Game.Tests.Visual.Gameplay
                 Children = new Drawable[]
                 {
                     dependenciesScreen.UserLookupCache,
-                    dependenciesScreen.Client,
+                    dependenciesScreen.SpectatorClient,
                 };
             });
 
@@ -336,7 +336,7 @@ namespace osu.Game.Tests.Visual.Gameplay
         private class DependenciesScreen : OsuScreen
         {
             [Cached(typeof(SpectatorClient))]
-            public readonly TestSpectatorClient Client = new TestSpectatorClient();
+            public readonly TestSpectatorClient SpectatorClient = new TestSpectatorClient();
 
             [Cached(typeof(UserLookupCache))]
             public readonly TestUserLookupCache UserLookupCache = new TestUserLookupCache();
diff --git a/osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs b/osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs
index 52801dd57a..2a3b44d619 100644
--- a/osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs
@@ -38,7 +38,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
         private TestMultiplayerComponents multiplayerComponents;
 
-        protected TestMultiplayerClient Client => multiplayerComponents.Client;
+        protected TestMultiplayerClient MultiplayerClient => multiplayerComponents.MultiplayerClient;
 
         [BackgroundDependencyLoader]
         private void load(GameHost host, AudioManager audio)
@@ -84,21 +84,21 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             ClickButtonWhenEnabled<MultiplayerMatchSettingsOverlay.CreateOrUpdateButton>();
 
-            AddUntilStep("wait for join", () => Client.RoomJoined);
+            AddUntilStep("wait for join", () => MultiplayerClient.RoomJoined);
         }
 
         [Test]
         public void TestCreatedWithCorrectMode()
         {
-            AddAssert("room created with correct mode", () => Client.APIRoom?.QueueMode.Value == Mode);
+            AddAssert("room created with correct mode", () => MultiplayerClient.APIRoom?.QueueMode.Value == Mode);
         }
 
         protected void RunGameplay()
         {
-            AddUntilStep("wait for idle", () => Client.LocalUser?.State == MultiplayerUserState.Idle);
+            AddUntilStep("wait for idle", () => MultiplayerClient.LocalUser?.State == MultiplayerUserState.Idle);
             ClickButtonWhenEnabled<MultiplayerReadyButton>();
 
-            AddUntilStep("wait for ready", () => Client.LocalUser?.State == MultiplayerUserState.Ready);
+            AddUntilStep("wait for ready", () => MultiplayerClient.LocalUser?.State == MultiplayerUserState.Ready);
             ClickButtonWhenEnabled<MultiplayerReadyButton>();
 
             AddUntilStep("wait for player", () => multiplayerComponents.CurrentScreen is Player player && player.IsLoaded);
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneAllPlayersQueueMode.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneAllPlayersQueueMode.cs
index ad60ac824d..0785315b26 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneAllPlayersQueueMode.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneAllPlayersQueueMode.cs
@@ -31,19 +31,19 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [Test]
         public void TestFirstItemSelectedByDefault()
         {
-            AddAssert("first item selected", () => Client.Room?.Settings.PlaylistItemId == Client.APIRoom?.Playlist[0].ID);
+            AddAssert("first item selected", () => MultiplayerClient.Room?.Settings.PlaylistItemId == MultiplayerClient.APIRoom?.Playlist[0].ID);
         }
 
         [Test]
         public void TestItemAddedToTheEndOfQueue()
         {
             addItem(() => OtherBeatmap);
-            AddAssert("playlist has 2 items", () => Client.APIRoom?.Playlist.Count == 2);
+            AddAssert("playlist has 2 items", () => MultiplayerClient.APIRoom?.Playlist.Count == 2);
 
             addItem(() => InitialBeatmap);
-            AddAssert("playlist has 3 items", () => Client.APIRoom?.Playlist.Count == 3);
+            AddAssert("playlist has 3 items", () => MultiplayerClient.APIRoom?.Playlist.Count == 3);
 
-            AddAssert("first item still selected", () => Client.Room?.Settings.PlaylistItemId == Client.APIRoom?.Playlist[0].ID);
+            AddAssert("first item still selected", () => MultiplayerClient.Room?.Settings.PlaylistItemId == MultiplayerClient.APIRoom?.Playlist[0].ID);
         }
 
         [Test]
@@ -51,9 +51,9 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             RunGameplay();
 
-            AddAssert("playlist has only one item", () => Client.APIRoom?.Playlist.Count == 1);
-            AddAssert("playlist item is expired", () => Client.APIRoom?.Playlist[0].Expired == true);
-            AddAssert("last item selected", () => Client.Room?.Settings.PlaylistItemId == Client.APIRoom?.Playlist[0].ID);
+            AddAssert("playlist has only one item", () => MultiplayerClient.APIRoom?.Playlist.Count == 1);
+            AddAssert("playlist item is expired", () => MultiplayerClient.APIRoom?.Playlist[0].Expired == true);
+            AddAssert("last item selected", () => MultiplayerClient.Room?.Settings.PlaylistItemId == MultiplayerClient.APIRoom?.Playlist[0].ID);
         }
 
         [Test]
@@ -64,13 +64,13 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             RunGameplay();
 
-            AddAssert("first item expired", () => Client.APIRoom?.Playlist[0].Expired == true);
-            AddAssert("next item selected", () => Client.Room?.Settings.PlaylistItemId == Client.APIRoom?.Playlist[1].ID);
+            AddAssert("first item expired", () => MultiplayerClient.APIRoom?.Playlist[0].Expired == true);
+            AddAssert("next item selected", () => MultiplayerClient.Room?.Settings.PlaylistItemId == MultiplayerClient.APIRoom?.Playlist[1].ID);
 
             RunGameplay();
 
-            AddAssert("second item expired", () => Client.APIRoom?.Playlist[1].Expired == true);
-            AddAssert("next item selected", () => Client.Room?.Settings.PlaylistItemId == Client.APIRoom?.Playlist[2].ID);
+            AddAssert("second item expired", () => MultiplayerClient.APIRoom?.Playlist[1].Expired == true);
+            AddAssert("next item selected", () => MultiplayerClient.Room?.Settings.PlaylistItemId == MultiplayerClient.APIRoom?.Playlist[2].ID);
         }
 
         [Test]
@@ -82,10 +82,10 @@ namespace osu.Game.Tests.Visual.Multiplayer
             // Move to the "other" beatmap.
             RunGameplay();
 
-            AddStep("change queue mode", () => Client.ChangeSettings(queueMode: QueueMode.HostOnly));
-            AddAssert("playlist has 3 items", () => Client.APIRoom?.Playlist.Count == 3);
-            AddAssert("item 2 is not expired", () => Client.APIRoom?.Playlist[1].Expired == false);
-            AddAssert("current item is the other beatmap", () => Client.Room?.Settings.PlaylistItemId == 2);
+            AddStep("change queue mode", () => MultiplayerClient.ChangeSettings(queueMode: QueueMode.HostOnly));
+            AddAssert("playlist has 3 items", () => MultiplayerClient.APIRoom?.Playlist.Count == 3);
+            AddAssert("item 2 is not expired", () => MultiplayerClient.APIRoom?.Playlist[1].Expired == false);
+            AddAssert("current item is the other beatmap", () => MultiplayerClient.Room?.Settings.PlaylistItemId == 2);
         }
 
         [Test]
@@ -101,10 +101,10 @@ namespace osu.Game.Tests.Visual.Multiplayer
             addItem(() => OtherBeatmap, new CatchRuleset().RulesetInfo);
             AddUntilStep("selected beatmap is initial beatmap", () => Beatmap.Value.BeatmapInfo.OnlineID == InitialBeatmap.OnlineID);
 
-            AddUntilStep("wait for idle", () => Client.LocalUser?.State == MultiplayerUserState.Idle);
+            AddUntilStep("wait for idle", () => MultiplayerClient.LocalUser?.State == MultiplayerUserState.Idle);
             ClickButtonWhenEnabled<MultiplayerReadyButton>();
 
-            AddUntilStep("wait for ready", () => Client.LocalUser?.State == MultiplayerUserState.Ready);
+            AddUntilStep("wait for ready", () => MultiplayerClient.LocalUser?.State == MultiplayerUserState.Ready);
             ClickButtonWhenEnabled<MultiplayerReadyButton>();
 
             AddUntilStep("wait for player", () => CurrentScreen is Player player && player.IsLoaded);
@@ -118,10 +118,10 @@ namespace osu.Game.Tests.Visual.Multiplayer
             addItem(() => OtherBeatmap, mods: new Mod[] { new OsuModDoubleTime() });
             AddUntilStep("selected beatmap is initial beatmap", () => Beatmap.Value.BeatmapInfo.OnlineID == InitialBeatmap.OnlineID);
 
-            AddUntilStep("wait for idle", () => Client.LocalUser?.State == MultiplayerUserState.Idle);
+            AddUntilStep("wait for idle", () => MultiplayerClient.LocalUser?.State == MultiplayerUserState.Idle);
             ClickButtonWhenEnabled<MultiplayerReadyButton>();
 
-            AddUntilStep("wait for ready", () => Client.LocalUser?.State == MultiplayerUserState.Ready);
+            AddUntilStep("wait for ready", () => MultiplayerClient.LocalUser?.State == MultiplayerUserState.Ready);
             ClickButtonWhenEnabled<MultiplayerReadyButton>();
 
             AddUntilStep("wait for player", () => CurrentScreen is Player player && player.IsLoaded);
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneCreateMultiplayerMatchButton.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneCreateMultiplayerMatchButton.cs
index 2f0398c6ef..0674fc7a39 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneCreateMultiplayerMatchButton.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneCreateMultiplayerMatchButton.cs
@@ -37,10 +37,10 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddStep("end joining room", () => joiningRoomOperation.Dispose());
             assertButtonEnableState(true);
 
-            AddStep("disconnect client", () => Client.Disconnect());
+            AddStep("disconnect client", () => MultiplayerClient.Disconnect());
             assertButtonEnableState(false);
 
-            AddStep("re-connect client", () => Client.Connect());
+            AddStep("re-connect client", () => MultiplayerClient.Connect());
             assertButtonEnableState(true);
         }
 
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneHostOnlyQueueMode.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneHostOnlyQueueMode.cs
index cd14a98751..a308d60cf1 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneHostOnlyQueueMode.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneHostOnlyQueueMode.cs
@@ -22,7 +22,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [Test]
         public void TestFirstItemSelectedByDefault()
         {
-            AddAssert("first item selected", () => Client.Room?.Settings.PlaylistItemId == Client.APIRoom?.Playlist[0].ID);
+            AddAssert("first item selected", () => MultiplayerClient.Room?.Settings.PlaylistItemId == MultiplayerClient.APIRoom?.Playlist[0].ID);
         }
 
         [Test]
@@ -30,7 +30,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             selectNewItem(() => InitialBeatmap);
 
-            AddAssert("playlist item still selected", () => Client.Room?.Settings.PlaylistItemId == Client.APIRoom?.Playlist[0].ID);
+            AddAssert("playlist item still selected", () => MultiplayerClient.Room?.Settings.PlaylistItemId == MultiplayerClient.APIRoom?.Playlist[0].ID);
         }
 
         [Test]
@@ -38,7 +38,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             selectNewItem(() => OtherBeatmap);
 
-            AddAssert("playlist item still selected", () => Client.Room?.Settings.PlaylistItemId == Client.APIRoom?.Playlist[0].ID);
+            AddAssert("playlist item still selected", () => MultiplayerClient.Room?.Settings.PlaylistItemId == MultiplayerClient.APIRoom?.Playlist[0].ID);
         }
 
         [Test]
@@ -46,10 +46,10 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             RunGameplay();
 
-            AddAssert("playlist contains two items", () => Client.APIRoom?.Playlist.Count == 2);
-            AddAssert("first playlist item expired", () => Client.APIRoom?.Playlist[0].Expired == true);
-            AddAssert("second playlist item not expired", () => Client.APIRoom?.Playlist[1].Expired == false);
-            AddAssert("second playlist item selected", () => Client.Room?.Settings.PlaylistItemId == Client.APIRoom?.Playlist[1].ID);
+            AddAssert("playlist contains two items", () => MultiplayerClient.APIRoom?.Playlist.Count == 2);
+            AddAssert("first playlist item expired", () => MultiplayerClient.APIRoom?.Playlist[0].Expired == true);
+            AddAssert("second playlist item not expired", () => MultiplayerClient.APIRoom?.Playlist[1].Expired == false);
+            AddAssert("second playlist item selected", () => MultiplayerClient.Room?.Settings.PlaylistItemId == MultiplayerClient.APIRoom?.Playlist[1].ID);
         }
 
         [Test]
@@ -58,23 +58,23 @@ namespace osu.Game.Tests.Visual.Multiplayer
             RunGameplay();
 
             IBeatmapInfo firstBeatmap = null;
-            AddStep("get first playlist item beatmap", () => firstBeatmap = Client.APIRoom?.Playlist[0].Beatmap.Value);
+            AddStep("get first playlist item beatmap", () => firstBeatmap = MultiplayerClient.APIRoom?.Playlist[0].Beatmap.Value);
 
             selectNewItem(() => OtherBeatmap);
 
-            AddAssert("first playlist item hasn't changed", () => Client.APIRoom?.Playlist[0].Beatmap.Value == firstBeatmap);
-            AddAssert("second playlist item changed", () => Client.APIRoom?.Playlist[1].Beatmap.Value != firstBeatmap);
+            AddAssert("first playlist item hasn't changed", () => MultiplayerClient.APIRoom?.Playlist[0].Beatmap.Value == firstBeatmap);
+            AddAssert("second playlist item changed", () => MultiplayerClient.APIRoom?.Playlist[1].Beatmap.Value != firstBeatmap);
         }
 
         [Test]
         public void TestSettingsUpdatedWhenChangingQueueMode()
         {
-            AddStep("change queue mode", () => Client.ChangeSettings(new MultiplayerRoomSettings
+            AddStep("change queue mode", () => MultiplayerClient.ChangeSettings(new MultiplayerRoomSettings
             {
                 QueueMode = QueueMode.AllPlayers
             }).WaitSafely());
 
-            AddUntilStep("api room updated", () => Client.APIRoom?.QueueMode.Value == QueueMode.AllPlayers);
+            AddUntilStep("api room updated", () => MultiplayerClient.APIRoom?.QueueMode.Value == QueueMode.AllPlayers);
         }
 
         [Test]
@@ -82,7 +82,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             addItem(() => OtherBeatmap);
 
-            AddAssert("playlist contains two items", () => Client.APIRoom?.Playlist.Count == 2);
+            AddAssert("playlist contains two items", () => MultiplayerClient.APIRoom?.Playlist.Count == 2);
         }
 
         private void selectNewItem(Func<BeatmapInfo> beatmap)
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorLeaderboard.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorLeaderboard.cs
index 543e6a91d0..6b3573b3cb 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorLeaderboard.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorLeaderboard.cs
@@ -35,7 +35,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 foreach ((int userId, var _) in clocks)
                 {
                     SpectatorClient.StartPlay(userId, 0);
-                    OnlinePlayDependencies.Client.AddUser(new APIUser { Id = userId });
+                    OnlinePlayDependencies.MultiplayerClient.AddUser(new APIUser { Id = userId });
                 }
             });
 
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs
index 56cb6036c7..7ce0c6a94d 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs
@@ -60,8 +60,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             AddStep("start players silently", () =>
             {
-                OnlinePlayDependencies.Client.AddUser(new APIUser { Id = PLAYER_1_ID }, true);
-                OnlinePlayDependencies.Client.AddUser(new APIUser { Id = PLAYER_2_ID }, true);
+                OnlinePlayDependencies.MultiplayerClient.AddUser(new APIUser { Id = PLAYER_1_ID }, true);
+                OnlinePlayDependencies.MultiplayerClient.AddUser(new APIUser { Id = PLAYER_2_ID }, true);
 
                 playingUsers.Add(new MultiplayerRoomUser(PLAYER_1_ID));
                 playingUsers.Add(new MultiplayerRoomUser(PLAYER_2_ID));
@@ -121,13 +121,13 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             AddStep("start players", () =>
             {
-                var player1 = OnlinePlayDependencies.Client.AddUser(new APIUser { Id = PLAYER_1_ID }, true);
+                var player1 = OnlinePlayDependencies.MultiplayerClient.AddUser(new APIUser { Id = PLAYER_1_ID }, true);
                 player1.MatchState = new TeamVersusUserState
                 {
                     TeamID = 0,
                 };
 
-                var player2 = OnlinePlayDependencies.Client.AddUser(new APIUser { Id = PLAYER_2_ID }, true);
+                var player2 = OnlinePlayDependencies.MultiplayerClient.AddUser(new APIUser { Id = PLAYER_2_ID }, true);
                 player2.MatchState = new TeamVersusUserState
                 {
                     TeamID = 1,
@@ -396,7 +396,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                         User = new APIUser { Id = id },
                     };
 
-                    OnlinePlayDependencies.Client.AddUser(user.User, true);
+                    OnlinePlayDependencies.MultiplayerClient.AddUser(user.User, true);
                     SpectatorClient.StartPlay(id, beatmapId ?? importedBeatmapId);
 
                     playingUsers.Add(user);
@@ -410,7 +410,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             {
                 var user = playingUsers.Single(u => u.UserID == userId);
 
-                OnlinePlayDependencies.Client.RemoveUser(user.User.AsNonNull());
+                OnlinePlayDependencies.MultiplayerClient.RemoveUser(user.User.AsNonNull());
                 SpectatorClient.EndPlay(userId);
 
                 playingUsers.Remove(user);
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
index 5439b3eeea..3f9aec3a42 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
@@ -52,7 +52,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
         private TestMultiplayerComponents multiplayerComponents;
 
-        private TestMultiplayerClient client => multiplayerComponents.Client;
+        private TestMultiplayerClient multiplayerClient => multiplayerComponents.MultiplayerClient;
         private TestMultiplayerRoomManager roomManager => multiplayerComponents.RoomManager;
 
         [BackgroundDependencyLoader]
@@ -109,66 +109,66 @@ namespace osu.Game.Tests.Visual.Multiplayer
             // all ready
             AddUntilStep("all players ready", () =>
             {
-                var nextUnready = client.Room?.Users.FirstOrDefault(c => c.State == MultiplayerUserState.Idle);
+                var nextUnready = multiplayerClient.Room?.Users.FirstOrDefault(c => c.State == MultiplayerUserState.Idle);
                 if (nextUnready != null)
-                    client.ChangeUserState(nextUnready.UserID, MultiplayerUserState.Ready);
+                    multiplayerClient.ChangeUserState(nextUnready.UserID, MultiplayerUserState.Ready);
 
-                return client.Room?.Users.All(u => u.State == MultiplayerUserState.Ready) == true;
+                return multiplayerClient.Room?.Users.All(u => u.State == MultiplayerUserState.Ready) == true;
             });
 
             AddStep("unready all players at once", () =>
             {
-                Debug.Assert(client.Room != null);
+                Debug.Assert(multiplayerClient.Room != null);
 
-                foreach (var u in client.Room.Users) client.ChangeUserState(u.UserID, MultiplayerUserState.Idle);
+                foreach (var u in multiplayerClient.Room.Users) multiplayerClient.ChangeUserState(u.UserID, MultiplayerUserState.Idle);
             });
 
             AddStep("ready all players at once", () =>
             {
-                Debug.Assert(client.Room != null);
+                Debug.Assert(multiplayerClient.Room != null);
 
-                foreach (var u in client.Room.Users) client.ChangeUserState(u.UserID, MultiplayerUserState.Ready);
+                foreach (var u in multiplayerClient.Room.Users) multiplayerClient.ChangeUserState(u.UserID, MultiplayerUserState.Ready);
             });
         }
 
         private void addRandomPlayer()
         {
             int randomUser = RNG.Next(200000, 500000);
-            client.AddUser(new APIUser { Id = randomUser, Username = $"user {randomUser}" });
+            multiplayerClient.AddUser(new APIUser { Id = randomUser, Username = $"user {randomUser}" });
         }
 
         private void removeLastUser()
         {
-            APIUser lastUser = client.Room?.Users.Last().User;
+            APIUser lastUser = multiplayerClient.Room?.Users.Last().User;
 
-            if (lastUser == null || lastUser == client.LocalUser?.User)
+            if (lastUser == null || lastUser == multiplayerClient.LocalUser?.User)
                 return;
 
-            client.RemoveUser(lastUser);
+            multiplayerClient.RemoveUser(lastUser);
         }
 
         private void kickLastUser()
         {
-            APIUser lastUser = client.Room?.Users.Last().User;
+            APIUser lastUser = multiplayerClient.Room?.Users.Last().User;
 
-            if (lastUser == null || lastUser == client.LocalUser?.User)
+            if (lastUser == null || lastUser == multiplayerClient.LocalUser?.User)
                 return;
 
-            client.KickUser(lastUser.Id);
+            multiplayerClient.KickUser(lastUser.Id);
         }
 
         private void markNextPlayerReady()
         {
-            var nextUnready = client.Room?.Users.FirstOrDefault(c => c.State == MultiplayerUserState.Idle);
+            var nextUnready = multiplayerClient.Room?.Users.FirstOrDefault(c => c.State == MultiplayerUserState.Idle);
             if (nextUnready != null)
-                client.ChangeUserState(nextUnready.UserID, MultiplayerUserState.Ready);
+                multiplayerClient.ChangeUserState(nextUnready.UserID, MultiplayerUserState.Ready);
         }
 
         private void markNextPlayerIdle()
         {
-            var nextUnready = client.Room?.Users.FirstOrDefault(c => c.State == MultiplayerUserState.Ready);
+            var nextUnready = multiplayerClient.Room?.Users.FirstOrDefault(c => c.State == MultiplayerUserState.Ready);
             if (nextUnready != null)
-                client.ChangeUserState(nextUnready.UserID, MultiplayerUserState.Idle);
+                multiplayerClient.ChangeUserState(nextUnready.UserID, MultiplayerUserState.Idle);
         }
 
         private void performRandomAction()
@@ -218,7 +218,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddStep("Press select", () => InputManager.Key(Key.Enter));
 
             AddUntilStep("wait for room open", () => this.ChildrenOfType<MultiplayerMatchSubScreen>().FirstOrDefault()?.IsLoaded == true);
-            AddUntilStep("wait for join", () => client.RoomJoined);
+            AddUntilStep("wait for join", () => multiplayerClient.RoomJoined);
         }
 
         [Test]
@@ -237,8 +237,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 }
             });
 
-            AddAssert("Check participant count correct", () => client.APIRoom?.ParticipantCount.Value == 1);
-            AddAssert("Check participant list contains user", () => client.APIRoom?.RecentParticipants.Count(u => u.Id == API.LocalUser.Value.Id) == 1);
+            AddAssert("Check participant count correct", () => multiplayerClient.APIRoom?.ParticipantCount.Value == 1);
+            AddAssert("Check participant list contains user", () => multiplayerClient.APIRoom?.RecentParticipants.Count(u => u.Id == API.LocalUser.Value.Id) == 1);
         }
 
         [Test]
@@ -297,10 +297,10 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddStep("join room", () => InputManager.Key(Key.Enter));
 
             AddUntilStep("wait for room open", () => this.ChildrenOfType<MultiplayerMatchSubScreen>().FirstOrDefault()?.IsLoaded == true);
-            AddUntilStep("wait for join", () => client.RoomJoined);
+            AddUntilStep("wait for join", () => multiplayerClient.RoomJoined);
 
-            AddAssert("Check participant count correct", () => client.APIRoom?.ParticipantCount.Value == 1);
-            AddAssert("Check participant list contains user", () => client.APIRoom?.RecentParticipants.Count(u => u.Id == API.LocalUser.Value.Id) == 1);
+            AddAssert("Check participant count correct", () => multiplayerClient.APIRoom?.ParticipantCount.Value == 1);
+            AddAssert("Check participant list contains user", () => multiplayerClient.APIRoom?.RecentParticipants.Count(u => u.Id == API.LocalUser.Value.Id) == 1);
         }
 
         [Test]
@@ -320,7 +320,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 }
             });
 
-            AddAssert("room has password", () => client.APIRoom?.Password.Value == "password");
+            AddAssert("room has password", () => multiplayerClient.APIRoom?.Password.Value == "password");
         }
 
         [Test]
@@ -355,7 +355,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddStep("press join room button", () => passwordEntryPopover.ChildrenOfType<OsuButton>().First().TriggerClick());
 
             AddUntilStep("wait for room open", () => this.ChildrenOfType<MultiplayerMatchSubScreen>().FirstOrDefault()?.IsLoaded == true);
-            AddUntilStep("wait for join", () => client.RoomJoined);
+            AddUntilStep("wait for join", () => multiplayerClient.RoomJoined);
         }
 
         [Test]
@@ -375,8 +375,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 }
             });
 
-            AddStep("change password", () => client.ChangeSettings(password: "password2"));
-            AddUntilStep("local password changed", () => client.APIRoom?.Password.Value == "password2");
+            AddStep("change password", () => multiplayerClient.ChangeSettings(password: "password2"));
+            AddUntilStep("local password changed", () => multiplayerClient.APIRoom?.Password.Value == "password2");
         }
 
         [Test]
@@ -398,7 +398,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             pressReadyButton();
 
             AddStep("delete beatmap", () => beatmaps.Delete(importedSet));
-            AddUntilStep("user state is idle", () => client.LocalUser?.State == MultiplayerUserState.Idle);
+            AddUntilStep("user state is idle", () => multiplayerClient.LocalUser?.State == MultiplayerUserState.Idle);
         }
 
         [Test]
@@ -422,22 +422,22 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddStep("Enter song select", () =>
             {
                 var currentSubScreen = ((Screens.OnlinePlay.Multiplayer.Multiplayer)multiplayerComponents.CurrentScreen).CurrentSubScreen;
-                ((MultiplayerMatchSubScreen)currentSubScreen).OpenSongSelection(client.Room?.Settings.PlaylistItemId);
+                ((MultiplayerMatchSubScreen)currentSubScreen).OpenSongSelection(multiplayerClient.Room?.Settings.PlaylistItemId);
             });
 
             AddUntilStep("wait for song select", () => this.ChildrenOfType<MultiplayerMatchSongSelect>().FirstOrDefault()?.BeatmapSetsLoaded == true);
 
-            AddAssert("Beatmap matches current item", () => Beatmap.Value.BeatmapInfo.OnlineID == client.Room?.Playlist.First().BeatmapID);
+            AddAssert("Beatmap matches current item", () => Beatmap.Value.BeatmapInfo.OnlineID == multiplayerClient.Room?.Playlist.First().BeatmapID);
 
             AddStep("Select next beatmap", () => InputManager.Key(Key.Down));
 
-            AddUntilStep("Beatmap doesn't match current item", () => Beatmap.Value.BeatmapInfo.OnlineID != client.Room?.Playlist.First().BeatmapID);
+            AddUntilStep("Beatmap doesn't match current item", () => Beatmap.Value.BeatmapInfo.OnlineID != multiplayerClient.Room?.Playlist.First().BeatmapID);
 
-            AddStep("start match externally", () => client.StartMatch());
+            AddStep("start match externally", () => multiplayerClient.StartMatch());
 
             AddUntilStep("play started", () => multiplayerComponents.CurrentScreen is Player);
 
-            AddAssert("Beatmap matches current item", () => Beatmap.Value.BeatmapInfo.OnlineID == client.Room?.Playlist.First().BeatmapID);
+            AddAssert("Beatmap matches current item", () => Beatmap.Value.BeatmapInfo.OnlineID == multiplayerClient.Room?.Playlist.First().BeatmapID);
         }
 
         [Test]
@@ -461,22 +461,22 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddStep("Enter song select", () =>
             {
                 var currentSubScreen = ((Screens.OnlinePlay.Multiplayer.Multiplayer)multiplayerComponents.CurrentScreen).CurrentSubScreen;
-                ((MultiplayerMatchSubScreen)currentSubScreen).OpenSongSelection(client.Room?.Settings.PlaylistItemId);
+                ((MultiplayerMatchSubScreen)currentSubScreen).OpenSongSelection(multiplayerClient.Room?.Settings.PlaylistItemId);
             });
 
             AddUntilStep("wait for song select", () => this.ChildrenOfType<MultiplayerMatchSongSelect>().FirstOrDefault()?.BeatmapSetsLoaded == true);
 
-            AddAssert("Ruleset matches current item", () => Ruleset.Value.OnlineID == client.Room?.Playlist.First().RulesetID);
+            AddAssert("Ruleset matches current item", () => Ruleset.Value.OnlineID == multiplayerClient.Room?.Playlist.First().RulesetID);
 
             AddStep("Switch ruleset", () => ((MultiplayerMatchSongSelect)multiplayerComponents.MultiplayerScreen.CurrentSubScreen).Ruleset.Value = new CatchRuleset().RulesetInfo);
 
-            AddUntilStep("Ruleset doesn't match current item", () => Ruleset.Value.OnlineID != client.Room?.Playlist.First().RulesetID);
+            AddUntilStep("Ruleset doesn't match current item", () => Ruleset.Value.OnlineID != multiplayerClient.Room?.Playlist.First().RulesetID);
 
-            AddStep("start match externally", () => client.StartMatch());
+            AddStep("start match externally", () => multiplayerClient.StartMatch());
 
             AddUntilStep("play started", () => multiplayerComponents.CurrentScreen is Player);
 
-            AddAssert("Ruleset matches current item", () => Ruleset.Value.OnlineID == client.Room?.Playlist.First().RulesetID);
+            AddAssert("Ruleset matches current item", () => Ruleset.Value.OnlineID == multiplayerClient.Room?.Playlist.First().RulesetID);
         }
 
         [Test]
@@ -500,22 +500,22 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddStep("Enter song select", () =>
             {
                 var currentSubScreen = ((Screens.OnlinePlay.Multiplayer.Multiplayer)multiplayerComponents.CurrentScreen).CurrentSubScreen;
-                ((MultiplayerMatchSubScreen)currentSubScreen).OpenSongSelection(client.Room?.Settings.PlaylistItemId);
+                ((MultiplayerMatchSubScreen)currentSubScreen).OpenSongSelection(multiplayerClient.Room?.Settings.PlaylistItemId);
             });
 
             AddUntilStep("wait for song select", () => this.ChildrenOfType<MultiplayerMatchSongSelect>().FirstOrDefault()?.BeatmapSetsLoaded == true);
 
-            AddAssert("Mods match current item", () => SelectedMods.Value.Select(m => m.Acronym).SequenceEqual(client.Room.AsNonNull().Playlist.First().RequiredMods.Select(m => m.Acronym)));
+            AddAssert("Mods match current item", () => SelectedMods.Value.Select(m => m.Acronym).SequenceEqual(multiplayerClient.Room.AsNonNull().Playlist.First().RequiredMods.Select(m => m.Acronym)));
 
             AddStep("Switch required mods", () => ((MultiplayerMatchSongSelect)multiplayerComponents.MultiplayerScreen.CurrentSubScreen).Mods.Value = new Mod[] { new OsuModDoubleTime() });
 
-            AddAssert("Mods don't match current item", () => !SelectedMods.Value.Select(m => m.Acronym).SequenceEqual(client.Room.AsNonNull().Playlist.First().RequiredMods.Select(m => m.Acronym)));
+            AddAssert("Mods don't match current item", () => !SelectedMods.Value.Select(m => m.Acronym).SequenceEqual(multiplayerClient.Room.AsNonNull().Playlist.First().RequiredMods.Select(m => m.Acronym)));
 
-            AddStep("start match externally", () => client.StartMatch());
+            AddStep("start match externally", () => multiplayerClient.StartMatch());
 
             AddUntilStep("play started", () => multiplayerComponents.CurrentScreen is Player);
 
-            AddAssert("Mods match current item", () => SelectedMods.Value.Select(m => m.Acronym).SequenceEqual(client.Room.AsNonNull().Playlist.First().RequiredMods.Select(m => m.Acronym)));
+            AddAssert("Mods match current item", () => SelectedMods.Value.Select(m => m.Acronym).SequenceEqual(multiplayerClient.Room.AsNonNull().Playlist.First().RequiredMods.Select(m => m.Acronym)));
         }
 
         [Test]
@@ -536,18 +536,18 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             AddStep("join other user (ready, host)", () =>
             {
-                client.AddUser(new APIUser { Id = MultiplayerTestScene.PLAYER_1_ID, Username = "Other" });
-                client.TransferHost(MultiplayerTestScene.PLAYER_1_ID);
-                client.ChangeUserState(MultiplayerTestScene.PLAYER_1_ID, MultiplayerUserState.Ready);
+                multiplayerClient.AddUser(new APIUser { Id = MultiplayerTestScene.PLAYER_1_ID, Username = "Other" });
+                multiplayerClient.TransferHost(MultiplayerTestScene.PLAYER_1_ID);
+                multiplayerClient.ChangeUserState(MultiplayerTestScene.PLAYER_1_ID, MultiplayerUserState.Ready);
             });
 
             AddStep("delete beatmap", () => beatmaps.Delete(importedSet));
 
             ClickButtonWhenEnabled<MultiplayerSpectateButton>();
 
-            AddUntilStep("wait for spectating user state", () => client.LocalUser?.State == MultiplayerUserState.Spectating);
+            AddUntilStep("wait for spectating user state", () => multiplayerClient.LocalUser?.State == MultiplayerUserState.Spectating);
 
-            AddStep("start match externally", () => client.StartMatch());
+            AddStep("start match externally", () => multiplayerClient.StartMatch());
 
             AddAssert("play not started", () => multiplayerComponents.IsCurrentScreen());
         }
@@ -572,16 +572,16 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             AddStep("join other user (ready, host)", () =>
             {
-                client.AddUser(new APIUser { Id = MultiplayerTestScene.PLAYER_1_ID, Username = "Other" });
-                client.TransferHost(MultiplayerTestScene.PLAYER_1_ID);
-                client.ChangeUserState(MultiplayerTestScene.PLAYER_1_ID, MultiplayerUserState.Ready);
+                multiplayerClient.AddUser(new APIUser { Id = MultiplayerTestScene.PLAYER_1_ID, Username = "Other" });
+                multiplayerClient.TransferHost(MultiplayerTestScene.PLAYER_1_ID);
+                multiplayerClient.ChangeUserState(MultiplayerTestScene.PLAYER_1_ID, MultiplayerUserState.Ready);
             });
 
             ClickButtonWhenEnabled<MultiplayerSpectateButton>();
 
-            AddUntilStep("wait for spectating user state", () => client.LocalUser?.State == MultiplayerUserState.Spectating);
+            AddUntilStep("wait for spectating user state", () => multiplayerClient.LocalUser?.State == MultiplayerUserState.Spectating);
 
-            AddStep("start match externally", () => client.StartMatch());
+            AddStep("start match externally", () => multiplayerClient.StartMatch());
 
             AddStep("restore beatmap", () =>
             {
@@ -608,7 +608,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 }
             });
 
-            AddStep("disconnect", () => client.Disconnect());
+            AddStep("disconnect", () => multiplayerClient.Disconnect());
             AddUntilStep("back in lounge", () => this.ChildrenOfType<LoungeSubScreen>().FirstOrDefault()?.IsCurrentScreen() == true);
         }
 
@@ -718,7 +718,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             AddStep("join room", () => InputManager.Key(Key.Enter));
             AddUntilStep("wait for room open", () => this.ChildrenOfType<MultiplayerMatchSubScreen>().FirstOrDefault()?.IsLoaded == true);
-            AddUntilStep("wait for join", () => client.RoomJoined);
+            AddUntilStep("wait for join", () => multiplayerClient.RoomJoined);
 
             AddAssert("local room has correct settings", () =>
             {
@@ -745,11 +745,11 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 }
             });
 
-            AddStep("set spectating state", () => client.ChangeUserState(API.LocalUser.Value.OnlineID, MultiplayerUserState.Spectating));
-            AddUntilStep("state set to spectating", () => client.LocalUser?.State == MultiplayerUserState.Spectating);
+            AddStep("set spectating state", () => multiplayerClient.ChangeUserState(API.LocalUser.Value.OnlineID, MultiplayerUserState.Spectating));
+            AddUntilStep("state set to spectating", () => multiplayerClient.LocalUser?.State == MultiplayerUserState.Spectating);
 
-            AddStep("join other user", () => client.AddUser(new APIUser { Id = 1234 }));
-            AddStep("set other user ready", () => client.ChangeUserState(1234, MultiplayerUserState.Ready));
+            AddStep("join other user", () => multiplayerClient.AddUser(new APIUser { Id = 1234 }));
+            AddStep("set other user ready", () => multiplayerClient.ChangeUserState(1234, MultiplayerUserState.Ready));
 
             pressReadyButton(1234);
             AddUntilStep("wait for gameplay", () => (multiplayerComponents.CurrentScreen as MultiSpectatorScreen)?.IsLoaded == true);
@@ -761,7 +761,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             });
 
             AddUntilStep("wait for return to match subscreen", () => multiplayerComponents.MultiplayerScreen.IsCurrentScreen());
-            AddUntilStep("user state is idle", () => client.LocalUser?.State == MultiplayerUserState.Idle);
+            AddUntilStep("user state is idle", () => multiplayerClient.LocalUser?.State == MultiplayerUserState.Idle);
         }
 
         [Test]
@@ -781,16 +781,16 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 }
             });
 
-            AddStep("set spectating state", () => client.ChangeUserState(API.LocalUser.Value.OnlineID, MultiplayerUserState.Spectating));
-            AddUntilStep("state set to spectating", () => client.LocalUser?.State == MultiplayerUserState.Spectating);
+            AddStep("set spectating state", () => multiplayerClient.ChangeUserState(API.LocalUser.Value.OnlineID, MultiplayerUserState.Spectating));
+            AddUntilStep("state set to spectating", () => multiplayerClient.LocalUser?.State == MultiplayerUserState.Spectating);
 
-            AddStep("join other user", () => client.AddUser(new APIUser { Id = 1234 }));
-            AddStep("set other user ready", () => client.ChangeUserState(1234, MultiplayerUserState.Ready));
+            AddStep("join other user", () => multiplayerClient.AddUser(new APIUser { Id = 1234 }));
+            AddStep("set other user ready", () => multiplayerClient.ChangeUserState(1234, MultiplayerUserState.Ready));
 
             pressReadyButton(1234);
             AddUntilStep("wait for gameplay", () => (multiplayerComponents.CurrentScreen as MultiSpectatorScreen)?.IsLoaded == true);
-            AddStep("set other user loaded", () => client.ChangeUserState(1234, MultiplayerUserState.Loaded));
-            AddStep("set other user finished play", () => client.ChangeUserState(1234, MultiplayerUserState.FinishedPlay));
+            AddStep("set other user loaded", () => multiplayerClient.ChangeUserState(1234, MultiplayerUserState.Loaded));
+            AddStep("set other user finished play", () => multiplayerClient.ChangeUserState(1234, MultiplayerUserState.FinishedPlay));
 
             AddStep("press back button and exit", () =>
             {
@@ -800,7 +800,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             AddUntilStep("wait for return to match subscreen", () => multiplayerComponents.MultiplayerScreen.IsCurrentScreen());
             AddWaitStep("wait for possible state change", 5);
-            AddUntilStep("user state is spectating", () => client.LocalUser?.State == MultiplayerUserState.Spectating);
+            AddUntilStep("user state is spectating", () => multiplayerClient.LocalUser?.State == MultiplayerUserState.Spectating);
         }
 
         [Test]
@@ -822,13 +822,13 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             enterGameplay();
 
-            AddStep("join other user", () => client.AddUser(new APIUser { Id = 1234 }));
-            AddStep("add item as other user", () => client.AddUserPlaylistItem(1234, new MultiplayerPlaylistItem(new PlaylistItem
+            AddStep("join other user", () => multiplayerClient.AddUser(new APIUser { Id = 1234 }));
+            AddStep("add item as other user", () => multiplayerClient.AddUserPlaylistItem(1234, new MultiplayerPlaylistItem(new PlaylistItem
             {
                 BeatmapID = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo.OnlineID
             })).WaitSafely());
 
-            AddUntilStep("item arrived in playlist", () => client.Room?.Playlist.Count == 2);
+            AddUntilStep("item arrived in playlist", () => multiplayerClient.Room?.Playlist.Count == 2);
 
             AddStep("exit gameplay as initial user", () => multiplayerComponents.MultiplayerScreen.MakeCurrent());
             AddUntilStep("queue contains item", () => this.ChildrenOfType<MultiplayerQueueList>().Single().Items.Single().ID == 2);
@@ -853,16 +853,16 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             enterGameplay();
 
-            AddStep("join other user", () => client.AddUser(new APIUser { Id = 1234 }));
-            AddStep("add item as other user", () => client.AddUserPlaylistItem(1234, new MultiplayerPlaylistItem(new PlaylistItem
+            AddStep("join other user", () => multiplayerClient.AddUser(new APIUser { Id = 1234 }));
+            AddStep("add item as other user", () => multiplayerClient.AddUserPlaylistItem(1234, new MultiplayerPlaylistItem(new PlaylistItem
             {
                 BeatmapID = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo.OnlineID
             })).WaitSafely());
 
-            AddUntilStep("item arrived in playlist", () => client.Room?.Playlist.Count == 2);
+            AddUntilStep("item arrived in playlist", () => multiplayerClient.Room?.Playlist.Count == 2);
 
-            AddStep("delete item as other user", () => client.RemoveUserPlaylistItem(1234, 2).WaitSafely());
-            AddUntilStep("item removed from playlist", () => client.Room?.Playlist.Count == 1);
+            AddStep("delete item as other user", () => multiplayerClient.RemoveUserPlaylistItem(1234, 2).WaitSafely());
+            AddUntilStep("item removed from playlist", () => multiplayerClient.Room?.Playlist.Count == 1);
 
             AddStep("exit gameplay as initial user", () => multiplayerComponents.MultiplayerScreen.MakeCurrent());
             AddUntilStep("queue is empty", () => this.ChildrenOfType<MultiplayerQueueList>().Single().Items.Count == 0);
@@ -886,17 +886,17 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             AddStep("join other user and make host", () =>
             {
-                client.AddUser(new APIUser { Id = 1234 });
-                client.TransferHost(1234);
+                multiplayerClient.AddUser(new APIUser { Id = 1234 });
+                multiplayerClient.TransferHost(1234);
             });
 
-            AddStep("set local user spectating", () => client.ChangeUserState(API.LocalUser.Value.OnlineID, MultiplayerUserState.Spectating));
-            AddUntilStep("wait for spectating state", () => client.LocalUser?.State == MultiplayerUserState.Spectating);
+            AddStep("set local user spectating", () => multiplayerClient.ChangeUserState(API.LocalUser.Value.OnlineID, MultiplayerUserState.Spectating));
+            AddUntilStep("wait for spectating state", () => multiplayerClient.LocalUser?.State == MultiplayerUserState.Spectating);
 
             runGameplay();
 
-            AddStep("exit gameplay for other user", () => client.ChangeUserState(1234, MultiplayerUserState.Idle));
-            AddUntilStep("wait for room to be idle", () => client.Room?.State == MultiplayerRoomState.Open);
+            AddStep("exit gameplay for other user", () => multiplayerClient.ChangeUserState(1234, MultiplayerUserState.Idle));
+            AddUntilStep("wait for room to be idle", () => multiplayerClient.Room?.State == MultiplayerRoomState.Open);
 
             runGameplay();
 
@@ -904,13 +904,13 @@ namespace osu.Game.Tests.Visual.Multiplayer
             {
                 AddStep("start match by other user", () =>
                 {
-                    client.ChangeUserState(1234, MultiplayerUserState.Ready);
-                    client.StartMatch();
+                    multiplayerClient.ChangeUserState(1234, MultiplayerUserState.Ready);
+                    multiplayerClient.StartMatch();
                 });
 
-                AddUntilStep("wait for loading", () => client.Room?.State == MultiplayerRoomState.WaitingForLoad);
-                AddStep("set player loaded", () => client.ChangeUserState(1234, MultiplayerUserState.Loaded));
-                AddUntilStep("wait for gameplay to start", () => client.Room?.State == MultiplayerRoomState.Playing);
+                AddUntilStep("wait for loading", () => multiplayerClient.Room?.State == MultiplayerRoomState.WaitingForLoad);
+                AddStep("set player loaded", () => multiplayerClient.ChangeUserState(1234, MultiplayerUserState.Loaded));
+                AddUntilStep("wait for gameplay to start", () => multiplayerClient.Room?.State == MultiplayerRoomState.Playing);
                 AddUntilStep("wait for local user to enter spectator", () => multiplayerComponents.CurrentScreen is MultiSpectatorScreen);
             }
         }
@@ -935,7 +935,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             AddStep("click ready button", () =>
             {
-                user = playingUserId == null ? client.LocalUser : client.Room?.Users.Single(u => u.UserID == playingUserId);
+                user = playingUserId == null ? multiplayerClient.LocalUser : multiplayerClient.Room?.Users.Single(u => u.UserID == playingUserId);
                 lastState = user?.State ?? MultiplayerUserState.Idle;
 
                 InputManager.MoveMouseTo(readyButton);
@@ -955,7 +955,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             ClickButtonWhenEnabled<MultiplayerMatchSettingsOverlay.CreateOrUpdateButton>();
 
-            AddUntilStep("wait for join", () => client.RoomJoined);
+            AddUntilStep("wait for join", () => multiplayerClient.RoomJoined);
         }
     }
 }
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs
index 437f4e3308..6605f82d5c 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs
@@ -59,7 +59,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 foreach (int user in users)
                 {
                     SpectatorClient.StartPlay(user, Beatmap.Value.BeatmapInfo.OnlineID);
-                    multiplayerUsers.Add(OnlinePlayDependencies.Client.AddUser(new APIUser { Id = user }, true));
+                    multiplayerUsers.Add(OnlinePlayDependencies.MultiplayerClient.AddUser(new APIUser { Id = user }, true));
                 }
 
                 Children = new Drawable[]
@@ -77,7 +77,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             });
 
             AddUntilStep("wait for load", () => leaderboard.IsLoaded);
-            AddUntilStep("wait for user population", () => Client.CurrentMatchPlayingUserIds.Count > 0);
+            AddUntilStep("wait for user population", () => MultiplayerClient.CurrentMatchPlayingUserIds.Count > 0);
         }
 
         [Test]
@@ -91,7 +91,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         public void TestUserQuit()
         {
             foreach (int user in users)
-                AddStep($"mark user {user} quit", () => Client.RemoveUser(UserLookupCache.GetUserAsync(user).GetResultSafely().AsNonNull()));
+                AddStep($"mark user {user} quit", () => MultiplayerClient.RemoveUser(UserLookupCache.GetUserAsync(user).GetResultSafely().AsNonNull()));
         }
 
         [Test]
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboardTeams.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboardTeams.cs
index cd3ae50dab..dabc1c1e5a 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboardTeams.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboardTeams.cs
@@ -63,7 +63,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 foreach (int user in users)
                 {
                     SpectatorClient.StartPlay(user, Beatmap.Value.BeatmapInfo.OnlineID);
-                    var roomUser = OnlinePlayDependencies.Client.AddUser(new APIUser { Id = user }, true);
+                    var roomUser = OnlinePlayDependencies.MultiplayerClient.AddUser(new APIUser { Id = user }, true);
 
                     roomUser.MatchState = new TeamVersusUserState
                     {
@@ -105,7 +105,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             });
 
             AddUntilStep("wait for load", () => leaderboard.IsLoaded);
-            AddUntilStep("wait for user population", () => Client.CurrentMatchPlayingUserIds.Count > 0);
+            AddUntilStep("wait for user population", () => MultiplayerClient.CurrentMatchPlayingUserIds.Count > 0);
         }
 
         [Test]
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs
index 7c18ed2572..7d2ef8276d 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs
@@ -102,7 +102,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             AddUntilStep("wait for join", () => RoomJoined);
 
-            AddStep("select swap mod", () => Client.ChangeUserMods(API.LocalUser.Value.OnlineID, new[] { new TaikoModSwap() }));
+            AddStep("select swap mod", () => MultiplayerClient.ChangeUserMods(API.LocalUser.Value.OnlineID, new[] { new TaikoModSwap() }));
             AddUntilStep("participant panel has mod", () => this.ChildrenOfType<ParticipantPanel>().Any(p => p.ChildrenOfType<ModIcon>().Any(m => m.Mod is TaikoModSwap)));
         }
 
@@ -141,17 +141,17 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             AddStep("join other user (ready)", () =>
             {
-                Client.AddUser(new APIUser { Id = PLAYER_1_ID });
-                Client.ChangeUserState(PLAYER_1_ID, MultiplayerUserState.Ready);
+                MultiplayerClient.AddUser(new APIUser { Id = PLAYER_1_ID });
+                MultiplayerClient.ChangeUserState(PLAYER_1_ID, MultiplayerUserState.Ready);
             });
 
             ClickButtonWhenEnabled<MultiplayerSpectateButton>();
 
-            AddUntilStep("wait for spectating user state", () => Client.LocalUser?.State == MultiplayerUserState.Spectating);
+            AddUntilStep("wait for spectating user state", () => MultiplayerClient.LocalUser?.State == MultiplayerUserState.Spectating);
 
             ClickButtonWhenEnabled<MultiplayerReadyButton>();
 
-            AddUntilStep("match started", () => Client.Room?.State == MultiplayerRoomState.WaitingForLoad);
+            AddUntilStep("match started", () => MultiplayerClient.Room?.State == MultiplayerRoomState.WaitingForLoad);
         }
 
         [Test]
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerParticipantsList.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerParticipantsList.cs
index 671b85164b..292319171d 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerParticipantsList.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerParticipantsList.cs
@@ -35,7 +35,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             AddAssert("one unique panel", () => this.ChildrenOfType<ParticipantPanel>().Select(p => p.User).Distinct().Count() == 1);
 
-            AddStep("add user", () => Client.AddUser(new APIUser
+            AddStep("add user", () => MultiplayerClient.AddUser(new APIUser
             {
                 Id = 3,
                 Username = "Second",
@@ -50,15 +50,15 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             AddAssert("one unique panel", () => this.ChildrenOfType<ParticipantPanel>().Select(p => p.User).Distinct().Count() == 1);
 
-            AddStep("add non-resolvable user", () => Client.TestAddUnresolvedUser());
-            AddAssert("null user added", () => Client.Room.AsNonNull().Users.Count(u => u.User == null) == 1);
+            AddStep("add non-resolvable user", () => MultiplayerClient.TestAddUnresolvedUser());
+            AddAssert("null user added", () => MultiplayerClient.Room.AsNonNull().Users.Count(u => u.User == null) == 1);
 
             AddUntilStep("two unique panels", () => this.ChildrenOfType<ParticipantPanel>().Select(p => p.User).Distinct().Count() == 2);
 
             AddStep("kick null user", () => this.ChildrenOfType<ParticipantPanel>().Single(p => p.User.User == null)
                                                 .ChildrenOfType<ParticipantPanel.KickButton>().Single().TriggerClick());
 
-            AddAssert("null user kicked", () => Client.Room.AsNonNull().Users.Count == 1);
+            AddAssert("null user kicked", () => MultiplayerClient.Room.AsNonNull().Users.Count == 1);
         }
 
         [Test]
@@ -68,7 +68,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             AddStep("add a user", () =>
             {
-                Client.AddUser(secondUser = new APIUser
+                MultiplayerClient.AddUser(secondUser = new APIUser
                 {
                     Id = 3,
                     Username = "Second",
@@ -76,7 +76,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 });
             });
 
-            AddStep("remove host", () => Client.RemoveUser(API.LocalUser.Value));
+            AddStep("remove host", () => MultiplayerClient.RemoveUser(API.LocalUser.Value));
 
             AddAssert("single panel is for second user", () => this.ChildrenOfType<ParticipantPanel>().Single().User.User == secondUser);
         }
@@ -84,21 +84,21 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [Test]
         public void TestGameStateHasPriorityOverDownloadState()
         {
-            AddStep("set to downloading map", () => Client.ChangeBeatmapAvailability(BeatmapAvailability.Downloading(0)));
+            AddStep("set to downloading map", () => MultiplayerClient.ChangeBeatmapAvailability(BeatmapAvailability.Downloading(0)));
             checkProgressBarVisibility(true);
 
-            AddStep("make user ready", () => Client.ChangeState(MultiplayerUserState.Results));
+            AddStep("make user ready", () => MultiplayerClient.ChangeState(MultiplayerUserState.Results));
             checkProgressBarVisibility(false);
             AddUntilStep("ready mark visible", () => this.ChildrenOfType<StateDisplay>().Single().IsPresent);
 
-            AddStep("make user ready", () => Client.ChangeState(MultiplayerUserState.Idle));
+            AddStep("make user ready", () => MultiplayerClient.ChangeState(MultiplayerUserState.Idle));
             checkProgressBarVisibility(true);
         }
 
         [Test]
         public void TestCorrectInitialState()
         {
-            AddStep("set to downloading map", () => Client.ChangeBeatmapAvailability(BeatmapAvailability.Downloading(0)));
+            AddStep("set to downloading map", () => MultiplayerClient.ChangeBeatmapAvailability(BeatmapAvailability.Downloading(0)));
             createNewParticipantsList();
             checkProgressBarVisibility(true);
         }
@@ -106,23 +106,23 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [Test]
         public void TestBeatmapDownloadingStates()
         {
-            AddStep("set to no map", () => Client.ChangeBeatmapAvailability(BeatmapAvailability.NotDownloaded()));
-            AddStep("set to downloading map", () => Client.ChangeBeatmapAvailability(BeatmapAvailability.Downloading(0)));
+            AddStep("set to no map", () => MultiplayerClient.ChangeBeatmapAvailability(BeatmapAvailability.NotDownloaded()));
+            AddStep("set to downloading map", () => MultiplayerClient.ChangeBeatmapAvailability(BeatmapAvailability.Downloading(0)));
 
             checkProgressBarVisibility(true);
 
             AddRepeatStep("increment progress", () =>
             {
                 float progress = this.ChildrenOfType<ParticipantPanel>().Single().User.BeatmapAvailability.DownloadProgress ?? 0;
-                Client.ChangeBeatmapAvailability(BeatmapAvailability.Downloading(progress + RNG.NextSingle(0.1f)));
+                MultiplayerClient.ChangeBeatmapAvailability(BeatmapAvailability.Downloading(progress + RNG.NextSingle(0.1f)));
             }, 25);
 
             AddAssert("progress bar increased", () => this.ChildrenOfType<ProgressBar>().Single().Current.Value > 0);
 
-            AddStep("set to importing map", () => Client.ChangeBeatmapAvailability(BeatmapAvailability.Importing()));
+            AddStep("set to importing map", () => MultiplayerClient.ChangeBeatmapAvailability(BeatmapAvailability.Importing()));
             checkProgressBarVisibility(false);
 
-            AddStep("set to available", () => Client.ChangeBeatmapAvailability(BeatmapAvailability.LocallyAvailable()));
+            AddStep("set to available", () => MultiplayerClient.ChangeBeatmapAvailability(BeatmapAvailability.LocallyAvailable()));
         }
 
         [Test]
@@ -130,24 +130,24 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             AddAssert("ready mark invisible", () => !this.ChildrenOfType<StateDisplay>().Single().IsPresent);
 
-            AddStep("make user ready", () => Client.ChangeState(MultiplayerUserState.Ready));
+            AddStep("make user ready", () => MultiplayerClient.ChangeState(MultiplayerUserState.Ready));
             AddUntilStep("ready mark visible", () => this.ChildrenOfType<StateDisplay>().Single().IsPresent);
 
-            AddStep("make user idle", () => Client.ChangeState(MultiplayerUserState.Idle));
+            AddStep("make user idle", () => MultiplayerClient.ChangeState(MultiplayerUserState.Idle));
             AddUntilStep("ready mark invisible", () => !this.ChildrenOfType<StateDisplay>().Single().IsPresent);
         }
 
         [Test]
         public void TestToggleSpectateState()
         {
-            AddStep("make user spectating", () => Client.ChangeState(MultiplayerUserState.Spectating));
-            AddStep("make user idle", () => Client.ChangeState(MultiplayerUserState.Idle));
+            AddStep("make user spectating", () => MultiplayerClient.ChangeState(MultiplayerUserState.Spectating));
+            AddStep("make user idle", () => MultiplayerClient.ChangeState(MultiplayerUserState.Idle));
         }
 
         [Test]
         public void TestCrownChangesStateWhenHostTransferred()
         {
-            AddStep("add user", () => Client.AddUser(new APIUser
+            AddStep("add user", () => MultiplayerClient.AddUser(new APIUser
             {
                 Id = 3,
                 Username = "Second",
@@ -157,7 +157,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddUntilStep("first user crown visible", () => this.ChildrenOfType<ParticipantPanel>().ElementAt(0).ChildrenOfType<SpriteIcon>().First().Alpha == 1);
             AddUntilStep("second user crown hidden", () => this.ChildrenOfType<ParticipantPanel>().ElementAt(1).ChildrenOfType<SpriteIcon>().First().Alpha == 0);
 
-            AddStep("make second user host", () => Client.TransferHost(3));
+            AddStep("make second user host", () => MultiplayerClient.TransferHost(3));
 
             AddUntilStep("first user crown hidden", () => this.ChildrenOfType<ParticipantPanel>().ElementAt(0).ChildrenOfType<SpriteIcon>().First().Alpha == 0);
             AddUntilStep("second user crown visible", () => this.ChildrenOfType<ParticipantPanel>().ElementAt(1).ChildrenOfType<SpriteIcon>().First().Alpha == 1);
@@ -166,7 +166,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [Test]
         public void TestKickButtonOnlyPresentWhenHost()
         {
-            AddStep("add user", () => Client.AddUser(new APIUser
+            AddStep("add user", () => MultiplayerClient.AddUser(new APIUser
             {
                 Id = 3,
                 Username = "Second",
@@ -175,11 +175,11 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             AddUntilStep("kick buttons visible", () => this.ChildrenOfType<ParticipantPanel.KickButton>().Count(d => d.IsPresent) == 1);
 
-            AddStep("make second user host", () => Client.TransferHost(3));
+            AddStep("make second user host", () => MultiplayerClient.TransferHost(3));
 
             AddUntilStep("kick buttons not visible", () => this.ChildrenOfType<ParticipantPanel.KickButton>().Count(d => d.IsPresent) == 0);
 
-            AddStep("make local user host again", () => Client.TransferHost(API.LocalUser.Value.Id));
+            AddStep("make local user host again", () => MultiplayerClient.TransferHost(API.LocalUser.Value.Id));
 
             AddUntilStep("kick buttons visible", () => this.ChildrenOfType<ParticipantPanel.KickButton>().Count(d => d.IsPresent) == 1);
         }
@@ -187,7 +187,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [Test]
         public void TestKickButtonKicks()
         {
-            AddStep("add user", () => Client.AddUser(new APIUser
+            AddStep("add user", () => MultiplayerClient.AddUser(new APIUser
             {
                 Id = 3,
                 Username = "Second",
@@ -196,7 +196,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             AddStep("kick second user", () => this.ChildrenOfType<ParticipantPanel.KickButton>().Single(d => d.IsPresent).TriggerClick());
 
-            AddAssert("second user kicked", () => Client.Room?.Users.Single().UserID == API.LocalUser.Value.Id);
+            AddAssert("second user kicked", () => MultiplayerClient.Room?.Users.Single().UserID == API.LocalUser.Value.Id);
         }
 
         [Test]
@@ -206,7 +206,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             {
                 for (int i = 0; i < 20; i++)
                 {
-                    Client.AddUser(new APIUser
+                    MultiplayerClient.AddUser(new APIUser
                     {
                         Id = i,
                         Username = $"User {i}",
@@ -220,7 +220,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                         CoverUrl = @"https://osu.ppy.sh/images/headers/profile-covers/c3.jpg",
                     });
 
-                    Client.ChangeUserState(i, (MultiplayerUserState)RNG.Next(0, (int)MultiplayerUserState.Results + 1));
+                    MultiplayerClient.ChangeUserState(i, (MultiplayerUserState)RNG.Next(0, (int)MultiplayerUserState.Results + 1));
 
                     if (RNG.NextBool())
                     {
@@ -229,15 +229,15 @@ namespace osu.Game.Tests.Visual.Multiplayer
                         switch (beatmapState)
                         {
                             case DownloadState.NotDownloaded:
-                                Client.ChangeUserBeatmapAvailability(i, BeatmapAvailability.NotDownloaded());
+                                MultiplayerClient.ChangeUserBeatmapAvailability(i, BeatmapAvailability.NotDownloaded());
                                 break;
 
                             case DownloadState.Downloading:
-                                Client.ChangeUserBeatmapAvailability(i, BeatmapAvailability.Downloading(RNG.NextSingle()));
+                                MultiplayerClient.ChangeUserBeatmapAvailability(i, BeatmapAvailability.Downloading(RNG.NextSingle()));
                                 break;
 
                             case DownloadState.Importing:
-                                Client.ChangeUserBeatmapAvailability(i, BeatmapAvailability.Importing());
+                                MultiplayerClient.ChangeUserBeatmapAvailability(i, BeatmapAvailability.Importing());
                                 break;
                         }
                     }
@@ -250,7 +250,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             AddStep("add user", () =>
             {
-                Client.AddUser(new APIUser
+                MultiplayerClient.AddUser(new APIUser
                 {
                     Id = 0,
                     Username = "User 0",
@@ -264,7 +264,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     CoverUrl = @"https://osu.ppy.sh/images/headers/profile-covers/c3.jpg",
                 });
 
-                Client.ChangeUserMods(0, new Mod[]
+                MultiplayerClient.ChangeUserMods(0, new Mod[]
                 {
                     new OsuModHardRock(),
                     new OsuModDifficultyAdjust { ApproachRate = { Value = 1 } }
@@ -274,12 +274,12 @@ namespace osu.Game.Tests.Visual.Multiplayer
             for (var i = MultiplayerUserState.Idle; i < MultiplayerUserState.Results; i++)
             {
                 var state = i;
-                AddStep($"set state: {state}", () => Client.ChangeUserState(0, state));
+                AddStep($"set state: {state}", () => MultiplayerClient.ChangeUserState(0, state));
             }
 
-            AddStep("set state: downloading", () => Client.ChangeUserBeatmapAvailability(0, BeatmapAvailability.Downloading(0)));
+            AddStep("set state: downloading", () => MultiplayerClient.ChangeUserBeatmapAvailability(0, BeatmapAvailability.Downloading(0)));
 
-            AddStep("set state: locally available", () => Client.ChangeUserBeatmapAvailability(0, BeatmapAvailability.LocallyAvailable()));
+            AddStep("set state: locally available", () => MultiplayerClient.ChangeUserBeatmapAvailability(0, BeatmapAvailability.LocallyAvailable()));
         }
 
         [Test]
@@ -287,7 +287,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             AddStep("add dummy mods", () =>
             {
-                Client.ChangeUserMods(new Mod[]
+                MultiplayerClient.ChangeUserMods(new Mod[]
                 {
                     new OsuModNoFail(),
                     new OsuModDoubleTime()
@@ -296,7 +296,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             AddStep("add user with mods", () =>
             {
-                Client.AddUser(new APIUser
+                MultiplayerClient.AddUser(new APIUser
                 {
                     Id = 0,
                     Username = "Baka",
@@ -309,34 +309,34 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     },
                     CoverUrl = @"https://osu.ppy.sh/images/headers/profile-covers/c3.jpg",
                 });
-                Client.ChangeUserMods(0, new Mod[]
+                MultiplayerClient.ChangeUserMods(0, new Mod[]
                 {
                     new OsuModHardRock(),
                     new OsuModDoubleTime()
                 });
             });
 
-            AddStep("set 0 ready", () => Client.ChangeState(MultiplayerUserState.Ready));
+            AddStep("set 0 ready", () => MultiplayerClient.ChangeState(MultiplayerUserState.Ready));
 
-            AddStep("set 1 spectate", () => Client.ChangeUserState(0, MultiplayerUserState.Spectating));
+            AddStep("set 1 spectate", () => MultiplayerClient.ChangeUserState(0, MultiplayerUserState.Spectating));
 
             // Have to set back to idle due to status priority.
             AddStep("set 0 no map, 1 ready", () =>
             {
-                Client.ChangeState(MultiplayerUserState.Idle);
-                Client.ChangeBeatmapAvailability(BeatmapAvailability.NotDownloaded());
-                Client.ChangeUserState(0, MultiplayerUserState.Ready);
+                MultiplayerClient.ChangeState(MultiplayerUserState.Idle);
+                MultiplayerClient.ChangeBeatmapAvailability(BeatmapAvailability.NotDownloaded());
+                MultiplayerClient.ChangeUserState(0, MultiplayerUserState.Ready);
             });
 
-            AddStep("set 0 downloading", () => Client.ChangeBeatmapAvailability(BeatmapAvailability.Downloading(0)));
+            AddStep("set 0 downloading", () => MultiplayerClient.ChangeBeatmapAvailability(BeatmapAvailability.Downloading(0)));
 
-            AddStep("set 0 spectate", () => Client.ChangeUserState(0, MultiplayerUserState.Spectating));
+            AddStep("set 0 spectate", () => MultiplayerClient.ChangeUserState(0, MultiplayerUserState.Spectating));
 
             AddStep("make both default", () =>
             {
-                Client.ChangeBeatmapAvailability(BeatmapAvailability.LocallyAvailable());
-                Client.ChangeUserState(0, MultiplayerUserState.Idle);
-                Client.ChangeState(MultiplayerUserState.Idle);
+                MultiplayerClient.ChangeBeatmapAvailability(BeatmapAvailability.LocallyAvailable());
+                MultiplayerClient.ChangeUserState(0, MultiplayerUserState.Idle);
+                MultiplayerClient.ChangeState(MultiplayerUserState.Idle);
             });
         }
 
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlayer.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlayer.cs
index 010e9dc078..d391fbcf8f 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlayer.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlayer.cs
@@ -28,15 +28,15 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             AddStep("initialise gameplay", () =>
             {
-                Stack.Push(player = new MultiplayerPlayer(Client.APIRoom, new PlaylistItem
+                Stack.Push(player = new MultiplayerPlayer(MultiplayerClient.APIRoom, new PlaylistItem
                 {
                     Beatmap = { Value = Beatmap.Value.BeatmapInfo },
                     RulesetID = Beatmap.Value.BeatmapInfo.Ruleset.OnlineID,
-                }, Client.Room?.Users.ToArray()));
+                }, MultiplayerClient.Room?.Users.ToArray()));
             });
 
             AddUntilStep("wait for player to be current", () => player.IsCurrentScreen() && player.IsLoaded);
-            AddStep("start gameplay", () => ((IMultiplayerClient)Client).MatchStarted());
+            AddStep("start gameplay", () => ((IMultiplayerClient)MultiplayerClient).MatchStarted());
         }
 
         [Test]
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs
index 7bc5990c32..f84abc7443 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs
@@ -60,7 +60,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 importedBeatmap = importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0);
             });
 
-            AddStep("change to all players mode", () => Client.ChangeSettings(new MultiplayerRoomSettings { QueueMode = QueueMode.AllPlayers }).WaitSafely());
+            AddStep("change to all players mode", () => MultiplayerClient.ChangeSettings(new MultiplayerRoomSettings { QueueMode = QueueMode.AllPlayers }).WaitSafely());
         }
 
         [Test]
@@ -97,19 +97,19 @@ namespace osu.Game.Tests.Visual.Multiplayer
             addItemStep();
             addItemStep();
 
-            AddStep("finish current item", () => Client.FinishCurrentItem().WaitSafely());
+            AddStep("finish current item", () => MultiplayerClient.FinishCurrentItem().WaitSafely());
 
             assertItemInHistoryListStep(1, 0);
             assertItemInQueueListStep(2, 0);
             assertItemInQueueListStep(3, 1);
 
-            AddStep("finish current item", () => Client.FinishCurrentItem().WaitSafely());
+            AddStep("finish current item", () => MultiplayerClient.FinishCurrentItem().WaitSafely());
 
             assertItemInHistoryListStep(2, 0);
             assertItemInHistoryListStep(1, 1);
             assertItemInQueueListStep(3, 0);
 
-            AddStep("finish current item", () => Client.FinishCurrentItem().WaitSafely());
+            AddStep("finish current item", () => MultiplayerClient.FinishCurrentItem().WaitSafely());
 
             assertItemInHistoryListStep(3, 0);
             assertItemInHistoryListStep(2, 1);
@@ -120,7 +120,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         public void TestListsClearedWhenRoomLeft()
         {
             addItemStep();
-            AddStep("finish current item", () => Client.FinishCurrentItem().WaitSafely());
+            AddStep("finish current item", () => MultiplayerClient.FinishCurrentItem().WaitSafely());
 
             AddStep("leave room", () => RoomManager.PartRoom());
             AddUntilStep("wait for room part", () => !RoomJoined);
@@ -167,7 +167,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         /// <summary>
         /// Adds a step to create a new playlist item.
         /// </summary>
-        private void addItemStep(bool expired = false) => AddStep("add item", () => Client.AddPlaylistItem(new MultiplayerPlaylistItem(new PlaylistItem
+        private void addItemStep(bool expired = false) => AddStep("add item", () => MultiplayerClient.AddPlaylistItem(new MultiplayerPlaylistItem(new PlaylistItem
         {
             Beatmap = { Value = importedBeatmap },
             BeatmapID = importedBeatmap.OnlineID,
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs
index 0b3e1ba20a..bf06b6ad73 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs
@@ -50,7 +50,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     Anchor = Anchor.Centre,
                     Origin = Anchor.Centre,
                     Size = new Vector2(500, 300),
-                    Items = { BindTarget = Client.APIRoom!.Playlist }
+                    Items = { BindTarget = MultiplayerClient.APIRoom!.Playlist }
                 };
             });
 
@@ -61,14 +61,14 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 importedBeatmap = importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0);
             });
 
-            AddStep("change to all players mode", () => Client.ChangeSettings(new MultiplayerRoomSettings { QueueMode = QueueMode.AllPlayers }).WaitSafely());
+            AddStep("change to all players mode", () => MultiplayerClient.ChangeSettings(new MultiplayerRoomSettings { QueueMode = QueueMode.AllPlayers }).WaitSafely());
         }
 
         [Test]
         public void TestDeleteButtonAlwaysVisibleForHost()
         {
-            AddStep("set all players queue mode", () => Client.ChangeSettings(new MultiplayerRoomSettings { QueueMode = QueueMode.AllPlayers }).WaitSafely());
-            AddUntilStep("wait for queue mode change", () => Client.APIRoom?.QueueMode.Value == QueueMode.AllPlayers);
+            AddStep("set all players queue mode", () => MultiplayerClient.ChangeSettings(new MultiplayerRoomSettings { QueueMode = QueueMode.AllPlayers }).WaitSafely());
+            AddUntilStep("wait for queue mode change", () => MultiplayerClient.APIRoom?.QueueMode.Value == QueueMode.AllPlayers);
 
             addPlaylistItem(() => API.LocalUser.Value.OnlineID);
             assertDeleteButtonVisibility(1, true);
@@ -79,18 +79,18 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [Test]
         public void TestDeleteButtonOnlyVisibleForItemOwnerIfNotHost()
         {
-            AddStep("set all players queue mode", () => Client.ChangeSettings(new MultiplayerRoomSettings { QueueMode = QueueMode.AllPlayers }).WaitSafely());
-            AddUntilStep("wait for queue mode change", () => Client.APIRoom?.QueueMode.Value == QueueMode.AllPlayers);
+            AddStep("set all players queue mode", () => MultiplayerClient.ChangeSettings(new MultiplayerRoomSettings { QueueMode = QueueMode.AllPlayers }).WaitSafely());
+            AddUntilStep("wait for queue mode change", () => MultiplayerClient.APIRoom?.QueueMode.Value == QueueMode.AllPlayers);
 
-            AddStep("join other user", () => Client.AddUser(new APIUser { Id = 1234 }));
-            AddStep("set other user as host", () => Client.TransferHost(1234));
+            AddStep("join other user", () => MultiplayerClient.AddUser(new APIUser { Id = 1234 }));
+            AddStep("set other user as host", () => MultiplayerClient.TransferHost(1234));
 
             addPlaylistItem(() => API.LocalUser.Value.OnlineID);
             assertDeleteButtonVisibility(1, true);
             addPlaylistItem(() => 1234);
             assertDeleteButtonVisibility(2, false);
 
-            AddStep("set local user as host", () => Client.TransferHost(API.LocalUser.Value.OnlineID));
+            AddStep("set local user as host", () => MultiplayerClient.TransferHost(API.LocalUser.Value.OnlineID));
             assertDeleteButtonVisibility(1, true);
             assertDeleteButtonVisibility(2, true);
         }
@@ -98,16 +98,16 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [Test]
         public void TestCurrentItemDoesNotHaveDeleteButton()
         {
-            AddStep("set all players queue mode", () => Client.ChangeSettings(new MultiplayerRoomSettings { QueueMode = QueueMode.AllPlayers }).WaitSafely());
-            AddUntilStep("wait for queue mode change", () => Client.APIRoom?.QueueMode.Value == QueueMode.AllPlayers);
+            AddStep("set all players queue mode", () => MultiplayerClient.ChangeSettings(new MultiplayerRoomSettings { QueueMode = QueueMode.AllPlayers }).WaitSafely());
+            AddUntilStep("wait for queue mode change", () => MultiplayerClient.APIRoom?.QueueMode.Value == QueueMode.AllPlayers);
 
             addPlaylistItem(() => API.LocalUser.Value.OnlineID);
 
             assertDeleteButtonVisibility(0, false);
             assertDeleteButtonVisibility(1, true);
 
-            AddStep("finish current item", () => Client.FinishCurrentItem().WaitSafely());
-            AddUntilStep("wait for next item to be selected", () => Client.Room?.Settings.PlaylistItemId == 2);
+            AddStep("finish current item", () => MultiplayerClient.FinishCurrentItem().WaitSafely());
+            AddUntilStep("wait for next item to be selected", () => MultiplayerClient.Room?.Settings.PlaylistItemId == 2);
             AddUntilStep("wait for two items in playlist", () => playlist.ChildrenOfType<DrawableRoomPlaylistItem>().Count() == 2);
 
             assertDeleteButtonVisibility(0, false);
@@ -126,7 +126,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     BeatmapID = importedBeatmap.OnlineID,
                 });
 
-                Client.AddUserPlaylistItem(userId(), item).WaitSafely();
+                MultiplayerClient.AddUserPlaylistItem(userId(), item).WaitSafely();
 
                 itemId = item.ID;
             });
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs
index 7834226f15..609693e54b 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs
@@ -74,13 +74,13 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
                     Task.Run(async () =>
                     {
-                        if (Client.IsHost && Client.LocalUser?.State == MultiplayerUserState.Ready)
+                        if (MultiplayerClient.IsHost && MultiplayerClient.LocalUser?.State == MultiplayerUserState.Ready)
                         {
-                            await Client.StartMatch();
+                            await MultiplayerClient.StartMatch();
                             return;
                         }
 
-                        await Client.ToggleReady();
+                        await MultiplayerClient.ToggleReady();
 
                         readyClickOperation.Dispose();
                     });
@@ -110,15 +110,15 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             AddStep("add second user as host", () =>
             {
-                Client.AddUser(new APIUser { Id = 2, Username = "Another user" });
-                Client.TransferHost(2);
+                MultiplayerClient.AddUser(new APIUser { Id = 2, Username = "Another user" });
+                MultiplayerClient.TransferHost(2);
             });
 
             ClickButtonWhenEnabled<MultiplayerReadyButton>();
-            AddUntilStep("user is ready", () => Client.Room?.Users[0].State == MultiplayerUserState.Ready);
+            AddUntilStep("user is ready", () => MultiplayerClient.Room?.Users[0].State == MultiplayerUserState.Ready);
 
             ClickButtonWhenEnabled<MultiplayerReadyButton>();
-            AddUntilStep("user is idle", () => Client.Room?.Users[0].State == MultiplayerUserState.Idle);
+            AddUntilStep("user is idle", () => MultiplayerClient.Room?.Users[0].State == MultiplayerUserState.Idle);
         }
 
         [TestCase(true)]
@@ -127,14 +127,14 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             AddStep("setup", () =>
             {
-                Client.TransferHost(Client.Room?.Users[0].UserID ?? 0);
+                MultiplayerClient.TransferHost(MultiplayerClient.Room?.Users[0].UserID ?? 0);
 
                 if (!allReady)
-                    Client.AddUser(new APIUser { Id = 2, Username = "Another user" });
+                    MultiplayerClient.AddUser(new APIUser { Id = 2, Username = "Another user" });
             });
 
             ClickButtonWhenEnabled<MultiplayerReadyButton>();
-            AddUntilStep("user is ready", () => Client.Room?.Users[0].State == MultiplayerUserState.Ready);
+            AddUntilStep("user is ready", () => MultiplayerClient.Room?.Users[0].State == MultiplayerUserState.Ready);
 
             verifyGameplayStartFlow();
         }
@@ -144,12 +144,12 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             AddStep("add host", () =>
             {
-                Client.AddUser(new APIUser { Id = 2, Username = "Another user" });
-                Client.TransferHost(2);
+                MultiplayerClient.AddUser(new APIUser { Id = 2, Username = "Another user" });
+                MultiplayerClient.TransferHost(2);
             });
 
             ClickButtonWhenEnabled<MultiplayerReadyButton>();
-            AddStep("make user host", () => Client.TransferHost(Client.Room?.Users[0].UserID ?? 0));
+            AddStep("make user host", () => MultiplayerClient.TransferHost(MultiplayerClient.Room?.Users[0].UserID ?? 0));
 
             verifyGameplayStartFlow();
         }
@@ -159,17 +159,17 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             AddStep("setup", () =>
             {
-                Client.TransferHost(Client.Room?.Users[0].UserID ?? 0);
-                Client.AddUser(new APIUser { Id = 2, Username = "Another user" });
+                MultiplayerClient.TransferHost(MultiplayerClient.Room?.Users[0].UserID ?? 0);
+                MultiplayerClient.AddUser(new APIUser { Id = 2, Username = "Another user" });
             });
 
             ClickButtonWhenEnabled<MultiplayerReadyButton>();
-            AddUntilStep("user is ready", () => Client.Room?.Users[0].State == MultiplayerUserState.Ready);
+            AddUntilStep("user is ready", () => MultiplayerClient.Room?.Users[0].State == MultiplayerUserState.Ready);
 
-            AddStep("transfer host", () => Client.TransferHost(Client.Room?.Users[1].UserID ?? 0));
+            AddStep("transfer host", () => MultiplayerClient.TransferHost(MultiplayerClient.Room?.Users[1].UserID ?? 0));
 
             ClickButtonWhenEnabled<MultiplayerReadyButton>();
-            AddUntilStep("user is idle (match not started)", () => Client.Room?.Users[0].State == MultiplayerUserState.Idle);
+            AddUntilStep("user is idle (match not started)", () => MultiplayerClient.Room?.Users[0].State == MultiplayerUserState.Idle);
             AddAssert("ready button enabled", () => button.ChildrenOfType<OsuButton>().Single().Enabled.Value);
         }
 
@@ -180,42 +180,42 @@ namespace osu.Game.Tests.Visual.Multiplayer
             const int users = 10;
             AddStep("setup", () =>
             {
-                Client.TransferHost(Client.Room?.Users[0].UserID ?? 0);
+                MultiplayerClient.TransferHost(MultiplayerClient.Room?.Users[0].UserID ?? 0);
                 for (int i = 0; i < users; i++)
-                    Client.AddUser(new APIUser { Id = i, Username = "Another user" });
+                    MultiplayerClient.AddUser(new APIUser { Id = i, Username = "Another user" });
             });
 
             if (!isHost)
-                AddStep("transfer host", () => Client.TransferHost(2));
+                AddStep("transfer host", () => MultiplayerClient.TransferHost(2));
 
             ClickButtonWhenEnabled<MultiplayerReadyButton>();
 
             AddRepeatStep("change user ready state", () =>
             {
-                Client.ChangeUserState(RNG.Next(0, users), RNG.NextBool() ? MultiplayerUserState.Ready : MultiplayerUserState.Idle);
+                MultiplayerClient.ChangeUserState(RNG.Next(0, users), RNG.NextBool() ? MultiplayerUserState.Ready : MultiplayerUserState.Idle);
             }, 20);
 
             AddRepeatStep("ready all users", () =>
             {
-                var nextUnready = Client.Room?.Users.FirstOrDefault(c => c.State == MultiplayerUserState.Idle);
+                var nextUnready = MultiplayerClient.Room?.Users.FirstOrDefault(c => c.State == MultiplayerUserState.Idle);
                 if (nextUnready != null)
-                    Client.ChangeUserState(nextUnready.UserID, MultiplayerUserState.Ready);
+                    MultiplayerClient.ChangeUserState(nextUnready.UserID, MultiplayerUserState.Ready);
             }, users);
         }
 
         private void verifyGameplayStartFlow()
         {
-            AddUntilStep("user is ready", () => Client.Room?.Users[0].State == MultiplayerUserState.Ready);
+            AddUntilStep("user is ready", () => MultiplayerClient.Room?.Users[0].State == MultiplayerUserState.Ready);
             ClickButtonWhenEnabled<MultiplayerReadyButton>();
-            AddUntilStep("user waiting for load", () => Client.Room?.Users[0].State == MultiplayerUserState.WaitingForLoad);
+            AddUntilStep("user waiting for load", () => MultiplayerClient.Room?.Users[0].State == MultiplayerUserState.WaitingForLoad);
 
             AddAssert("ready button disabled", () => !button.ChildrenOfType<OsuButton>().Single().Enabled.Value);
             AddStep("transitioned to gameplay", () => readyClickOperation.Dispose());
 
             AddStep("finish gameplay", () =>
             {
-                Client.ChangeUserState(Client.Room?.Users[0].UserID ?? 0, MultiplayerUserState.Loaded);
-                Client.ChangeUserState(Client.Room?.Users[0].UserID ?? 0, MultiplayerUserState.FinishedPlay);
+                MultiplayerClient.ChangeUserState(MultiplayerClient.Room?.Users[0].UserID ?? 0, MultiplayerUserState.Loaded);
+                MultiplayerClient.ChangeUserState(MultiplayerClient.Room?.Users[0].UserID ?? 0, MultiplayerUserState.FinishedPlay);
             });
 
             AddUntilStep("ready button enabled", () => button.ChildrenOfType<OsuButton>().Single().Enabled.Value);
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerSpectateButton.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerSpectateButton.cs
index 70d4d9dd55..c4ea78116a 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerSpectateButton.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerSpectateButton.cs
@@ -78,7 +78,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
                             Task.Run(async () =>
                             {
-                                await Client.ToggleSpectate();
+                                await MultiplayerClient.ToggleSpectate();
                                 readyClickOperation.Dispose();
                             });
                         }
@@ -94,13 +94,13 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
                             Task.Run(async () =>
                             {
-                                if (Client.IsHost && Client.LocalUser?.State == MultiplayerUserState.Ready)
+                                if (MultiplayerClient.IsHost && MultiplayerClient.LocalUser?.State == MultiplayerUserState.Ready)
                                 {
-                                    await Client.StartMatch();
+                                    await MultiplayerClient.StartMatch();
                                     return;
                                 }
 
-                                await Client.ToggleReady();
+                                await MultiplayerClient.ToggleReady();
 
                                 readyClickOperation.Dispose();
                             });
@@ -115,7 +115,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [TestCase(MultiplayerRoomState.Playing)]
         public void TestEnabledWhenRoomOpenOrInGameplay(MultiplayerRoomState roomState)
         {
-            AddStep($"change room to {roomState}", () => Client.ChangeRoomState(roomState));
+            AddStep($"change room to {roomState}", () => MultiplayerClient.ChangeRoomState(roomState));
             assertSpectateButtonEnablement(true);
         }
 
@@ -124,16 +124,16 @@ namespace osu.Game.Tests.Visual.Multiplayer
         public void TestToggleWhenIdle(MultiplayerUserState initialState)
         {
             ClickButtonWhenEnabled<MultiplayerSpectateButton>();
-            AddUntilStep("user is spectating", () => Client.Room?.Users[0].State == MultiplayerUserState.Spectating);
+            AddUntilStep("user is spectating", () => MultiplayerClient.Room?.Users[0].State == MultiplayerUserState.Spectating);
 
             ClickButtonWhenEnabled<MultiplayerSpectateButton>();
-            AddUntilStep("user is idle", () => Client.Room?.Users[0].State == MultiplayerUserState.Idle);
+            AddUntilStep("user is idle", () => MultiplayerClient.Room?.Users[0].State == MultiplayerUserState.Idle);
         }
 
         [TestCase(MultiplayerRoomState.Closed)]
         public void TestDisabledWhenClosed(MultiplayerRoomState roomState)
         {
-            AddStep($"change room to {roomState}", () => Client.ChangeRoomState(roomState));
+            AddStep($"change room to {roomState}", () => MultiplayerClient.ChangeRoomState(roomState));
             assertSpectateButtonEnablement(false);
         }
 
@@ -147,8 +147,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [Test]
         public void TestReadyButtonEnabledWhenHostAndUsersReady()
         {
-            AddStep("add user", () => Client.AddUser(new APIUser { Id = PLAYER_1_ID }));
-            AddStep("set user ready", () => Client.ChangeUserState(PLAYER_1_ID, MultiplayerUserState.Ready));
+            AddStep("add user", () => MultiplayerClient.AddUser(new APIUser { Id = PLAYER_1_ID }));
+            AddStep("set user ready", () => MultiplayerClient.ChangeUserState(PLAYER_1_ID, MultiplayerUserState.Ready));
 
             ClickButtonWhenEnabled<MultiplayerSpectateButton>();
             assertReadyButtonEnablement(true);
@@ -159,11 +159,11 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             AddStep("add user and transfer host", () =>
             {
-                Client.AddUser(new APIUser { Id = PLAYER_1_ID });
-                Client.TransferHost(PLAYER_1_ID);
+                MultiplayerClient.AddUser(new APIUser { Id = PLAYER_1_ID });
+                MultiplayerClient.TransferHost(PLAYER_1_ID);
             });
 
-            AddStep("set user ready", () => Client.ChangeUserState(PLAYER_1_ID, MultiplayerUserState.Ready));
+            AddStep("set user ready", () => MultiplayerClient.ChangeUserState(PLAYER_1_ID, MultiplayerUserState.Ready));
 
             ClickButtonWhenEnabled<MultiplayerSpectateButton>();
             assertReadyButtonEnablement(false);
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneRankRangePill.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneRankRangePill.cs
index 823ac07cf7..f95e73ff3c 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneRankRangePill.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneRankRangePill.cs
@@ -25,14 +25,14 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             AddStep("add user", () =>
             {
-                Client.AddUser(new APIUser
+                MultiplayerClient.AddUser(new APIUser
                 {
                     Id = 2,
                     Statistics = { GlobalRank = 1234 }
                 });
 
                 // Remove the local user so only the one above is displayed.
-                Client.RemoveUser(API.LocalUser.Value);
+                MultiplayerClient.RemoveUser(API.LocalUser.Value);
             });
         }
 
@@ -41,26 +41,26 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             AddStep("add users", () =>
             {
-                Client.AddUser(new APIUser
+                MultiplayerClient.AddUser(new APIUser
                 {
                     Id = 2,
                     Statistics = { GlobalRank = 1234 }
                 });
 
-                Client.AddUser(new APIUser
+                MultiplayerClient.AddUser(new APIUser
                 {
                     Id = 3,
                     Statistics = { GlobalRank = 3333 }
                 });
 
-                Client.AddUser(new APIUser
+                MultiplayerClient.AddUser(new APIUser
                 {
                     Id = 4,
                     Statistics = { GlobalRank = 4321 }
                 });
 
                 // Remove the local user so only the ones above are displayed.
-                Client.RemoveUser(API.LocalUser.Value);
+                MultiplayerClient.RemoveUser(API.LocalUser.Value);
             });
         }
 
@@ -75,20 +75,20 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             AddStep("add users", () =>
             {
-                Client.AddUser(new APIUser
+                MultiplayerClient.AddUser(new APIUser
                 {
                     Id = 2,
                     Statistics = { GlobalRank = min }
                 });
 
-                Client.AddUser(new APIUser
+                MultiplayerClient.AddUser(new APIUser
                 {
                     Id = 3,
                     Statistics = { GlobalRank = max }
                 });
 
                 // Remove the local user so only the ones above are displayed.
-                Client.RemoveUser(API.LocalUser.Value);
+                MultiplayerClient.RemoveUser(API.LocalUser.Value);
             });
         }
     }
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs
index 7a5bd0b8f4..50b3f52047 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs
@@ -33,7 +33,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
         private TestMultiplayerComponents multiplayerComponents;
 
-        private TestMultiplayerClient client => multiplayerComponents.Client;
+        private TestMultiplayerClient multiplayerClient => multiplayerComponents.MultiplayerClient;
 
         [BackgroundDependencyLoader]
         private void load(GameHost host, AudioManager audio)
@@ -75,8 +75,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 }
             });
 
-            AddUntilStep("room type is team vs", () => client.Room?.Settings.MatchType == MatchType.TeamVersus);
-            AddAssert("user state arrived", () => client.Room?.Users.FirstOrDefault()?.MatchState is TeamVersusUserState);
+            AddUntilStep("room type is team vs", () => multiplayerClient.Room?.Settings.MatchType == MatchType.TeamVersus);
+            AddAssert("user state arrived", () => multiplayerClient.Room?.Users.FirstOrDefault()?.MatchState is TeamVersusUserState);
         }
 
         [Test]
@@ -96,25 +96,25 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 }
             });
 
-            AddAssert("user on team 0", () => (client.Room?.Users.FirstOrDefault()?.MatchState as TeamVersusUserState)?.TeamID == 0);
-            AddStep("add another user", () => client.AddUser(new APIUser { Username = "otheruser", Id = 44 }));
+            AddAssert("user on team 0", () => (multiplayerClient.Room?.Users.FirstOrDefault()?.MatchState as TeamVersusUserState)?.TeamID == 0);
+            AddStep("add another user", () => multiplayerClient.AddUser(new APIUser { Username = "otheruser", Id = 44 }));
 
             AddStep("press own button", () =>
             {
                 InputManager.MoveMouseTo(multiplayerComponents.ChildrenOfType<TeamDisplay>().First());
                 InputManager.Click(MouseButton.Left);
             });
-            AddAssert("user on team 1", () => (client.Room?.Users.FirstOrDefault()?.MatchState as TeamVersusUserState)?.TeamID == 1);
+            AddAssert("user on team 1", () => (multiplayerClient.Room?.Users.FirstOrDefault()?.MatchState as TeamVersusUserState)?.TeamID == 1);
 
             AddStep("press own button again", () => InputManager.Click(MouseButton.Left));
-            AddAssert("user on team 0", () => (client.Room?.Users.FirstOrDefault()?.MatchState as TeamVersusUserState)?.TeamID == 0);
+            AddAssert("user on team 0", () => (multiplayerClient.Room?.Users.FirstOrDefault()?.MatchState as TeamVersusUserState)?.TeamID == 0);
 
             AddStep("press other user's button", () =>
             {
                 InputManager.MoveMouseTo(multiplayerComponents.ChildrenOfType<TeamDisplay>().ElementAt(1));
                 InputManager.Click(MouseButton.Left);
             });
-            AddAssert("user still on team 0", () => (client.Room?.Users.FirstOrDefault()?.MatchState as TeamVersusUserState)?.TeamID == 0);
+            AddAssert("user still on team 0", () => (multiplayerClient.Room?.Users.FirstOrDefault()?.MatchState as TeamVersusUserState)?.TeamID == 0);
         }
 
         [Test]
@@ -134,14 +134,14 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 }
             });
 
-            AddUntilStep("match type head to head", () => client.APIRoom?.Type.Value == MatchType.HeadToHead);
+            AddUntilStep("match type head to head", () => multiplayerClient.APIRoom?.Type.Value == MatchType.HeadToHead);
 
-            AddStep("change match type", () => client.ChangeSettings(new MultiplayerRoomSettings
+            AddStep("change match type", () => multiplayerClient.ChangeSettings(new MultiplayerRoomSettings
             {
                 MatchType = MatchType.TeamVersus
             }).WaitSafely());
 
-            AddUntilStep("api room updated to team versus", () => client.APIRoom?.Type.Value == MatchType.TeamVersus);
+            AddUntilStep("api room updated to team versus", () => multiplayerClient.APIRoom?.Type.Value == MatchType.TeamVersus);
         }
 
         [Test]
@@ -160,13 +160,13 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 }
             });
 
-            AddUntilStep("room type is head to head", () => client.Room?.Settings.MatchType == MatchType.HeadToHead);
+            AddUntilStep("room type is head to head", () => multiplayerClient.Room?.Settings.MatchType == MatchType.HeadToHead);
 
             AddUntilStep("team displays are not displaying teams", () => multiplayerComponents.ChildrenOfType<TeamDisplay>().All(d => d.DisplayedTeam == null));
 
-            AddStep("change to team vs", () => client.ChangeSettings(matchType: MatchType.TeamVersus));
+            AddStep("change to team vs", () => multiplayerClient.ChangeSettings(matchType: MatchType.TeamVersus));
 
-            AddUntilStep("room type is team vs", () => client.Room?.Settings.MatchType == MatchType.TeamVersus);
+            AddUntilStep("room type is team vs", () => multiplayerClient.Room?.Settings.MatchType == MatchType.TeamVersus);
 
             AddUntilStep("team displays are displaying teams", () => multiplayerComponents.ChildrenOfType<TeamDisplay>().All(d => d.DisplayedTeam != null));
         }
@@ -185,7 +185,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 InputManager.Click(MouseButton.Left);
             });
 
-            AddUntilStep("wait for join", () => client.RoomJoined);
+            AddUntilStep("wait for join", () => multiplayerClient.RoomJoined);
         }
     }
 }
diff --git a/osu.Game.Tests/Visual/TestMultiplayerComponents.cs b/osu.Game.Tests/Visual/TestMultiplayerComponents.cs
index bd8fb8e58e..062aa33b99 100644
--- a/osu.Game.Tests/Visual/TestMultiplayerComponents.cs
+++ b/osu.Game.Tests/Visual/TestMultiplayerComponents.cs
@@ -38,7 +38,7 @@ namespace osu.Game.Tests.Visual
         public new bool IsLoaded => base.IsLoaded && MultiplayerScreen.IsLoaded;
 
         [Cached(typeof(MultiplayerClient))]
-        public readonly TestMultiplayerClient Client;
+        public readonly TestMultiplayerClient MultiplayerClient;
 
         [Cached(typeof(UserLookupCache))]
         private readonly UserLookupCache userLookupCache = new TestUserLookupCache();
@@ -57,7 +57,7 @@ namespace osu.Game.Tests.Visual
             {
                 userLookupCache,
                 beatmapLookupCache,
-                Client = new TestMultiplayerClient(RoomManager),
+                MultiplayerClient = new TestMultiplayerClient(RoomManager),
                 screenStack = new OsuScreenStack
                 {
                     Name = nameof(TestMultiplayerComponents),
diff --git a/osu.Game/Tests/Visual/Multiplayer/IMultiplayerTestSceneDependencies.cs b/osu.Game/Tests/Visual/Multiplayer/IMultiplayerTestSceneDependencies.cs
index f166154103..62d1c9ceca 100644
--- a/osu.Game/Tests/Visual/Multiplayer/IMultiplayerTestSceneDependencies.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/IMultiplayerTestSceneDependencies.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.Game.Online.Multiplayer;
 using osu.Game.Screens.OnlinePlay;
 using osu.Game.Tests.Visual.OnlinePlay;
 using osu.Game.Tests.Visual.Spectator;
@@ -14,9 +13,9 @@ namespace osu.Game.Tests.Visual.Multiplayer
     public interface IMultiplayerTestSceneDependencies : IOnlinePlayTestSceneDependencies
     {
         /// <summary>
-        /// The cached <see cref="MultiplayerClient"/>.
+        /// The cached <see cref="Online.Multiplayer.MultiplayerClient"/>.
         /// </summary>
-        TestMultiplayerClient Client { get; }
+        TestMultiplayerClient MultiplayerClient { get; }
 
         /// <summary>
         /// The cached <see cref="IRoomManager"/>.
diff --git a/osu.Game/Tests/Visual/Multiplayer/MultiplayerTestScene.cs b/osu.Game/Tests/Visual/Multiplayer/MultiplayerTestScene.cs
index a9b3ca4991..19f9952d14 100644
--- a/osu.Game/Tests/Visual/Multiplayer/MultiplayerTestScene.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/MultiplayerTestScene.cs
@@ -17,13 +17,13 @@ namespace osu.Game.Tests.Visual.Multiplayer
         public const int PLAYER_1_ID = 55;
         public const int PLAYER_2_ID = 56;
 
-        public TestMultiplayerClient Client => OnlinePlayDependencies.Client;
+        public TestMultiplayerClient MultiplayerClient => OnlinePlayDependencies.MultiplayerClient;
         public new TestMultiplayerRoomManager RoomManager => OnlinePlayDependencies.RoomManager;
         public TestSpectatorClient SpectatorClient => OnlinePlayDependencies?.SpectatorClient;
 
         protected new MultiplayerTestSceneDependencies OnlinePlayDependencies => (MultiplayerTestSceneDependencies)base.OnlinePlayDependencies;
 
-        public bool RoomJoined => Client.RoomJoined;
+        public bool RoomJoined => MultiplayerClient.RoomJoined;
 
         private readonly bool joinRoom;
 
diff --git a/osu.Game/Tests/Visual/Multiplayer/MultiplayerTestSceneDependencies.cs b/osu.Game/Tests/Visual/Multiplayer/MultiplayerTestSceneDependencies.cs
index d9fe77ae44..6b4e01b673 100644
--- a/osu.Game/Tests/Visual/Multiplayer/MultiplayerTestSceneDependencies.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/MultiplayerTestSceneDependencies.cs
@@ -14,16 +14,16 @@ namespace osu.Game.Tests.Visual.Multiplayer
     /// </summary>
     public class MultiplayerTestSceneDependencies : OnlinePlayTestSceneDependencies, IMultiplayerTestSceneDependencies
     {
-        public TestMultiplayerClient Client { get; }
+        public TestMultiplayerClient MultiplayerClient { get; }
         public TestSpectatorClient SpectatorClient { get; }
         public new TestMultiplayerRoomManager RoomManager => (TestMultiplayerRoomManager)base.RoomManager;
 
         public MultiplayerTestSceneDependencies()
         {
-            Client = new TestMultiplayerClient(RoomManager);
+            MultiplayerClient = new TestMultiplayerClient(RoomManager);
             SpectatorClient = CreateSpectatorClient();
 
-            CacheAs<MultiplayerClient>(Client);
+            CacheAs<MultiplayerClient>(MultiplayerClient);
             CacheAs<SpectatorClient>(SpectatorClient);
         }
 

From 5db63a8751e38d9701b9987ae30508b9be516475 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 16 Feb 2022 11:30:03 +0900
Subject: [PATCH 2932/5547] Expose read-only list from request

---
 osu.Game/Online/API/Requests/GetBeatmapsRequest.cs | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Online/API/Requests/GetBeatmapsRequest.cs b/osu.Game/Online/API/Requests/GetBeatmapsRequest.cs
index c07e5ef1c2..22af022659 100644
--- a/osu.Game/Online/API/Requests/GetBeatmapsRequest.cs
+++ b/osu.Game/Online/API/Requests/GetBeatmapsRequest.cs
@@ -2,12 +2,13 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
+using System.Collections.Generic;
 
 namespace osu.Game.Online.API.Requests
 {
     public class GetBeatmapsRequest : APIRequest<GetBeatmapsResponse>
     {
-        public readonly int[] BeatmapIds;
+        public readonly IReadOnlyList<int> BeatmapIds;
 
         private const int max_ids_per_request = 50;
 

From 215da7e933ded0423618e6fb6f58e28c65ea2339 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 16 Feb 2022 12:05:55 +0900
Subject: [PATCH 2933/5547] Reimplement as extension method on IBeatmap

Implementation has changed slightly to support arbitrary levels of
nested hitobjects.
---
 .../Difficulty/OsuDifficultyCalculator.cs     | 17 +------------
 osu.Game/Beatmaps/IBeatmap.cs                 | 24 +++++++++++++++++++
 2 files changed, 25 insertions(+), 16 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs b/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs
index d04d0872d8..df6fd19d36 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs
@@ -9,7 +9,6 @@ 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.Osu.Difficulty.Preprocessing;
 using osu.Game.Rulesets.Osu.Difficulty.Skills;
 using osu.Game.Rulesets.Osu.Mods;
@@ -62,21 +61,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty
 
             double preempt = IBeatmapDifficultyInfo.DifficultyRange(beatmap.Difficulty.ApproachRate, 1800, 1200, 450) / clockRate;
             double drainRate = beatmap.Difficulty.DrainRate;
-
-            int maxCombo = 0;
-
-            void countCombo(HitObject ho)
-            {
-                if (ho.CreateJudgement().MaxResult.AffectsCombo())
-                    maxCombo++;
-            }
-
-            foreach (HitObject ho in beatmap.HitObjects)
-            {
-                countCombo(ho);
-                foreach (HitObject nested in ho.NestedHitObjects)
-                    countCombo(nested);
-            }
+            int maxCombo = beatmap.GetMaxCombo();
 
             int hitCirclesCount = beatmap.HitObjects.Count(h => h is HitCircle);
             int sliderCount = beatmap.HitObjects.Count(h => h is Slider);
diff --git a/osu.Game/Beatmaps/IBeatmap.cs b/osu.Game/Beatmaps/IBeatmap.cs
index 3f598cd1e5..dec1ef4294 100644
--- a/osu.Game/Beatmaps/IBeatmap.cs
+++ b/osu.Game/Beatmaps/IBeatmap.cs
@@ -5,6 +5,7 @@ using System.Collections.Generic;
 using osu.Game.Beatmaps.ControlPoints;
 using osu.Game.Beatmaps.Timing;
 using osu.Game.Rulesets.Objects;
+using osu.Game.Rulesets.Scoring;
 
 namespace osu.Game.Beatmaps
 {
@@ -70,4 +71,27 @@ namespace osu.Game.Beatmaps
         /// </summary>
         new IReadOnlyList<T> HitObjects { get; }
     }
+
+    public static class BeatmapExtensions
+    {
+        /// <summary>
+        /// Finds the maximum achievable combo by hitting all <see cref="HitObject"/>s in a beatmap.
+        /// </summary>
+        public static int GetMaxCombo(this IBeatmap beatmap)
+        {
+            int combo = 0;
+            foreach (var h in beatmap.HitObjects)
+                addCombo(h, ref combo);
+            return combo;
+
+            static void addCombo(HitObject hitObject, ref int combo)
+            {
+                if (hitObject.CreateJudgement().MaxResult.AffectsCombo())
+                    combo++;
+
+                foreach (var nested in hitObject.NestedHitObjects)
+                    addCombo(nested, ref combo);
+            }
+        }
+    }
 }

From 84e82ef5e466d1802f1273e72a389cdf1f54c6fd Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 16 Feb 2022 14:09:19 +0900
Subject: [PATCH 2934/5547] Add XMLDocs to difficulty attribute properties

---
 .../Difficulty/CatchDifficultyAttributes.cs   |  6 +++
 .../Difficulty/ManiaDifficultyAttributes.cs   |  9 +++++
 .../Difficulty/OsuDifficultyAttributes.cs     | 38 +++++++++++++++++++
 .../Difficulty/TaikoDifficultyAttributes.cs   | 21 ++++++++++
 .../Difficulty/DifficultyAttributes.cs        |  2 +-
 5 files changed, 75 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Catch/Difficulty/CatchDifficultyAttributes.cs b/osu.Game.Rulesets.Catch/Difficulty/CatchDifficultyAttributes.cs
index 39a58d336d..8e069d7d16 100644
--- a/osu.Game.Rulesets.Catch/Difficulty/CatchDifficultyAttributes.cs
+++ b/osu.Game.Rulesets.Catch/Difficulty/CatchDifficultyAttributes.cs
@@ -9,6 +9,12 @@ namespace osu.Game.Rulesets.Catch.Difficulty
 {
     public class CatchDifficultyAttributes : DifficultyAttributes
     {
+        /// <summary>
+        /// The perceived approach rate inclusive of rate-adjusting mods (DT/HT/etc).
+        /// </summary>
+        /// <remarks>
+        /// Rate-adjusting mods don't directly affect the approach rate difficulty value, but have a perceived effect as a result of adjusting audio timing.
+        /// </remarks>
         [JsonProperty("approach_rate")]
         public double ApproachRate { get; set; }
 
diff --git a/osu.Game.Rulesets.Mania/Difficulty/ManiaDifficultyAttributes.cs b/osu.Game.Rulesets.Mania/Difficulty/ManiaDifficultyAttributes.cs
index 979a04ddf8..efd5868504 100644
--- a/osu.Game.Rulesets.Mania/Difficulty/ManiaDifficultyAttributes.cs
+++ b/osu.Game.Rulesets.Mania/Difficulty/ManiaDifficultyAttributes.cs
@@ -9,9 +9,18 @@ namespace osu.Game.Rulesets.Mania.Difficulty
 {
     public class ManiaDifficultyAttributes : DifficultyAttributes
     {
+        /// <summary>
+        /// The perceived hit window for a GREAT hit inclusive of rate-adjusting mods (DT/HT/etc).
+        /// </summary>
+        /// <remarks>
+        /// Rate-adjusting mods don't directly affect the hit window, but have a perceived effect as a result of adjusting audio timing.
+        /// </remarks>
         [JsonProperty("great_hit_window")]
         public double GreatHitWindow { get; set; }
 
+        /// <summary>
+        /// The score multiplier applied via score-reducing mods.
+        /// </summary>
         [JsonProperty("score_multiplier")]
         public double ScoreMultiplier { get; set; }
 
diff --git a/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyAttributes.cs b/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyAttributes.cs
index 126a9b0183..3deed4ea3d 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyAttributes.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyAttributes.cs
@@ -12,30 +12,68 @@ namespace osu.Game.Rulesets.Osu.Difficulty
 {
     public class OsuDifficultyAttributes : DifficultyAttributes
     {
+        /// <summary>
+        /// The difficulty corresponding to the aim skill.
+        /// </summary>
         [JsonProperty("aim_difficulty")]
         public double AimDifficulty { get; set; }
 
+        /// <summary>
+        /// The difficulty corresponding to the speed skill.
+        /// </summary>
         [JsonProperty("speed_difficulty")]
         public double SpeedDifficulty { get; set; }
 
+        /// <summary>
+        /// The difficulty corresponding to the flashlight skill.
+        /// </summary>
         [JsonProperty("flashlight_difficulty")]
         public double FlashlightDifficulty { get; set; }
 
+        /// <summary>
+        /// Describes how much of <see cref="AimDifficulty"/> is contributed to by hitcircles or sliders.
+        /// A value closer to 1.0 indicates most of <see cref="AimDifficulty"/> is contributed by hitcircles.
+        /// A value closer to 0.0 indicates most of <see cref="AimDifficulty"/> is contributed by sliders.
+        /// </summary>
         [JsonProperty("slider_factor")]
         public double SliderFactor { get; set; }
 
+        /// <summary>
+        /// The perceived approach rate inclusive of rate-adjusting mods (DT/HT/etc).
+        /// </summary>
+        /// <remarks>
+        /// Rate-adjusting mods don't directly affect the approach rate difficulty value, but have a perceived effect as a result of adjusting audio timing.
+        /// </remarks>
         [JsonProperty("approach_rate")]
         public double ApproachRate { get; set; }
 
+        /// <summary>
+        /// The perceived overall difficulty inclusive of rate-adjusting mods (DT/HT/etc).
+        /// </summary>
+        /// <remarks>
+        /// Rate-adjusting mods don't directly affect the overall difficulty value, but have a perceived effect as a result of adjusting audio timing.
+        /// </remarks>
         [JsonProperty("overall_difficulty")]
         public double OverallDifficulty { get; set; }
 
+        /// <summary>
+        /// The beatmap's drain rate. This doesn't scale with rate-adjusting mods.
+        /// </summary>
         public double DrainRate { get; set; }
 
+        /// <summary>
+        /// The number of hitcircles in the beatmap.
+        /// </summary>
         public int HitCircleCount { get; set; }
 
+        /// <summary>
+        /// The number of sliders in the beatmap.
+        /// </summary>
         public int SliderCount { get; set; }
 
+        /// <summary>
+        /// The number of spinners in the beatmap.
+        /// </summary>
         public int SpinnerCount { get; set; }
 
         public override IEnumerable<(int attributeId, object value)> ToDatabaseAttributes()
diff --git a/osu.Game.Rulesets.Taiko/Difficulty/TaikoDifficultyAttributes.cs b/osu.Game.Rulesets.Taiko/Difficulty/TaikoDifficultyAttributes.cs
index 31f5a6f570..3dc5438072 100644
--- a/osu.Game.Rulesets.Taiko/Difficulty/TaikoDifficultyAttributes.cs
+++ b/osu.Game.Rulesets.Taiko/Difficulty/TaikoDifficultyAttributes.cs
@@ -9,18 +9,39 @@ namespace osu.Game.Rulesets.Taiko.Difficulty
 {
     public class TaikoDifficultyAttributes : DifficultyAttributes
     {
+        /// <summary>
+        /// The difficulty corresponding to the stamina skill.
+        /// </summary>
         [JsonProperty("stamina_difficulty")]
         public double StaminaDifficulty { get; set; }
 
+        /// <summary>
+        /// The difficulty corresponding to the rhythm skill.
+        /// </summary>
         [JsonProperty("rhythm_difficulty")]
         public double RhythmDifficulty { get; set; }
 
+        /// <summary>
+        /// The difficulty corresponding to the colour skill.
+        /// </summary>
         [JsonProperty("colour_difficulty")]
         public double ColourDifficulty { get; set; }
 
+        /// <summary>
+        /// The perceived approach rate inclusive of rate-adjusting mods (DT/HT/etc).
+        /// </summary>
+        /// <remarks>
+        /// Rate-adjusting mods don't directly affect the approach rate difficulty value, but have a perceived effect as a result of adjusting audio timing.
+        /// </remarks>
         [JsonProperty("approach_rate")]
         public double ApproachRate { get; set; }
 
+        /// <summary>
+        /// The perceived hit window for a GREAT hit inclusive of rate-adjusting mods (DT/HT/etc).
+        /// </summary>
+        /// <remarks>
+        /// Rate-adjusting mods don't directly affect the hit window, but have a perceived effect as a result of adjusting audio timing.
+        /// </remarks>
         [JsonProperty("great_hit_window")]
         public double GreatHitWindow { get; set; }
 
diff --git a/osu.Game/Rulesets/Difficulty/DifficultyAttributes.cs b/osu.Game/Rulesets/Difficulty/DifficultyAttributes.cs
index 991b567f57..ec3d22b67a 100644
--- a/osu.Game/Rulesets/Difficulty/DifficultyAttributes.cs
+++ b/osu.Game/Rulesets/Difficulty/DifficultyAttributes.cs
@@ -31,7 +31,7 @@ namespace osu.Game.Rulesets.Difficulty
         public Mod[] Mods { get; set; }
 
         /// <summary>
-        /// The combined star rating of all skill.
+        /// The combined star rating of all skills.
         /// </summary>
         [JsonProperty("star_rating", Order = -3)]
         public double StarRating { get; set; }

From 8b30c847f9ab3829b8fc8bc0e5f944a217cba8e5 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 16 Feb 2022 08:39:08 +0300
Subject: [PATCH 2935/5547] Update outdated bindable casts in tests

---
 osu.Game.Rulesets.Osu.Tests/Editor/TestSceneObjectObjectSnap.cs | 2 +-
 osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderSnapping.cs   | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneObjectObjectSnap.cs b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneObjectObjectSnap.cs
index 41304dcd24..aa0e35102e 100644
--- a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneObjectObjectSnap.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneObjectObjectSnap.cs
@@ -30,7 +30,7 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
             AddStep("seek to first control point", () => EditorClock.Seek(Beatmap.Value.Beatmap.ControlPointInfo.TimingPoints.First().Time));
             AddStep("set distance spacing to 1", () =>
             {
-                var distanceSpacing = (BindableFloat)Editor.ChildrenOfType<HitObjectComposer>().Single().DistanceSpacingMultiplier;
+                var distanceSpacing = (BindableDouble)Editor.ChildrenOfType<HitObjectComposer>().Single().DistanceSpacingMultiplier;
                 distanceSpacing.Value = 1;
             });
         }
diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderSnapping.cs b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderSnapping.cs
index 23131668a0..13ce340362 100644
--- a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderSnapping.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderSnapping.cs
@@ -69,7 +69,7 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
             });
             AddStep("set distance spacing to 1", () =>
             {
-                var distanceSpacing = (BindableFloat)Editor.ChildrenOfType<HitObjectComposer>().Single().DistanceSpacingMultiplier;
+                var distanceSpacing = (BindableDouble)Editor.ChildrenOfType<HitObjectComposer>().Single().DistanceSpacingMultiplier;
                 distanceSpacing.Value = 1;
             });
         }

From f703828e1bc17e3ec5421dbc09ea9a62ca3f8437 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 16 Feb 2022 15:27:48 +0900
Subject: [PATCH 2936/5547] Clarify ambiguous conditionals in
 `LegacyStageBackground`

---
 .../Skinning/Legacy/LegacyStageBackground.cs                   | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/osu.Game.Rulesets.Mania/Skinning/Legacy/LegacyStageBackground.cs b/osu.Game.Rulesets.Mania/Skinning/Legacy/LegacyStageBackground.cs
index 952fc7ddd6..fdacc75c92 100644
--- a/osu.Game.Rulesets.Mania/Skinning/Legacy/LegacyStageBackground.cs
+++ b/osu.Game.Rulesets.Mania/Skinning/Legacy/LegacyStageBackground.cs
@@ -98,8 +98,7 @@ namespace osu.Game.Rulesets.Mania.Skinning.Legacy
                 float rightLineWidth = skin.GetManiaSkinConfig<float>(LegacyManiaSkinConfigurationLookups.RightLineWidth, columnIndex)?.Value ?? 1;
 
                 bool hasLeftLine = leftLineWidth > 0;
-                bool hasRightLine = rightLineWidth > 0 && skin.GetConfig<SkinConfiguration.LegacySetting, decimal>(SkinConfiguration.LegacySetting.Version)?.Value >= 2.4m
-                                    || isLastColumn;
+                bool hasRightLine = (rightLineWidth > 0 && skin.GetConfig<SkinConfiguration.LegacySetting, decimal>(SkinConfiguration.LegacySetting.Version)?.Value >= 2.4m) || isLastColumn;
 
                 Color4 lineColour = skin.GetManiaSkinConfig<Color4>(LegacyManiaSkinConfigurationLookups.ColumnLineColour, columnIndex)?.Value ?? Color4.White;
                 Color4 backgroundColour = skin.GetManiaSkinConfig<Color4>(LegacyManiaSkinConfigurationLookups.ColumnBackgroundColour, columnIndex)?.Value ?? Color4.Black;

From edd31bf3aa913a7b01306538f88a6c44d160d729 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 16 Feb 2022 15:51:18 +0900
Subject: [PATCH 2937/5547] Revert styling change

---
 .../OnlinePlay/DrawableRoomPlaylistItem.cs    | 49 +++++++++----------
 1 file changed, 23 insertions(+), 26 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
index faeb73cfa3..8d840280b3 100644
--- a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
+++ b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
@@ -430,34 +430,31 @@ namespace osu.Game.Screens.OnlinePlay
             };
         }
 
-        private IEnumerable<Drawable> createButtons()
+        private IEnumerable<Drawable> createButtons() => new[]
         {
-            return new[]
+            showResultsButton = new GrayButton(FontAwesome.Solid.ChartPie)
             {
-                showResultsButton = new GrayButton(FontAwesome.Solid.ChartPie)
-                {
-                    Size = new Vector2(30, 30),
-                    Action = () => RequestResults?.Invoke(Item),
-                    Alpha = AllowShowingResults ? 1 : 0,
-                    TooltipText = "View results"
-                },
-                beatmap == null ? Empty() : new PlaylistDownloadButton(beatmap),
-                editButton = new PlaylistEditButton
-                {
-                    Size = new Vector2(30, 30),
-                    Alpha = AllowEditing ? 1 : 0,
-                    Action = () => RequestEdit?.Invoke(Item),
-                    TooltipText = "Edit"
-                },
-                removeButton = new PlaylistRemoveButton
-                {
-                    Size = new Vector2(30, 30),
-                    Alpha = AllowDeletion ? 1 : 0,
-                    Action = () => RequestDeletion?.Invoke(Item),
-                    TooltipText = "Remove from playlist"
-                },
-            };
-        }
+                Size = new Vector2(30, 30),
+                Action = () => RequestResults?.Invoke(Item),
+                Alpha = AllowShowingResults ? 1 : 0,
+                TooltipText = "View results"
+            },
+            beatmap == null ? Empty() : new PlaylistDownloadButton(beatmap),
+            editButton = new PlaylistEditButton
+            {
+                Size = new Vector2(30, 30),
+                Alpha = AllowEditing ? 1 : 0,
+                Action = () => RequestEdit?.Invoke(Item),
+                TooltipText = "Edit"
+            },
+            removeButton = new PlaylistRemoveButton
+            {
+                Size = new Vector2(30, 30),
+                Alpha = AllowDeletion ? 1 : 0,
+                Action = () => RequestDeletion?.Invoke(Item),
+                TooltipText = "Remove from playlist"
+            },
+        };
 
         protected override bool OnClick(ClickEvent e)
         {

From 55d9f0b44b507d4ff8140271e7fb3807ad2c4ef2 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 16 Feb 2022 16:03:08 +0900
Subject: [PATCH 2938/5547] Store beatmap to a field instead

---
 .../OnlinePlayBeatmapAvailabilityTracker.cs   | 35 ++++++++++---------
 1 file changed, 19 insertions(+), 16 deletions(-)

diff --git a/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs b/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs
index 02bcd1f30c..07506ba1f0 100644
--- a/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs
+++ b/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs
@@ -46,10 +46,9 @@ namespace osu.Game.Online.Rooms
         private readonly Bindable<BeatmapAvailability> availability = new Bindable<BeatmapAvailability>(BeatmapAvailability.NotDownloaded());
 
         private ScheduledDelegate progressUpdate;
-
         private BeatmapDownloadTracker downloadTracker;
-
         private IDisposable realmSubscription;
+        private APIBeatmap selectedBeatmap;
 
         protected override void LoadComplete()
         {
@@ -63,26 +62,30 @@ namespace osu.Game.Online.Rooms
                     return;
 
                 downloadTracker?.RemoveAndDisposeImmediately();
+                selectedBeatmap = null;
 
                 beatmapLookupCache.GetBeatmapAsync(item.NewValue.Beatmap.OnlineID).ContinueWith(task => Schedule(() =>
                 {
                     var beatmap = task.GetResultSafely();
 
                     if (SelectedItem.Value?.Beatmap.OnlineID == beatmap.OnlineID)
-                        beginTracking(beatmap);
+                    {
+                        selectedBeatmap = beatmap;
+                        beginTracking();
+                    }
                 }), TaskContinuationOptions.OnlyOnRanToCompletion);
             }, true);
         }
 
-        private void beginTracking(APIBeatmap beatmap)
+        private void beginTracking()
         {
-            Debug.Assert(beatmap.BeatmapSet != null);
+            Debug.Assert(selectedBeatmap.BeatmapSet != null);
 
-            downloadTracker = new BeatmapDownloadTracker(beatmap.BeatmapSet);
+            downloadTracker = new BeatmapDownloadTracker(selectedBeatmap.BeatmapSet);
 
             AddInternal(downloadTracker);
 
-            downloadTracker.State.BindValueChanged(_ => Scheduler.AddOnce(updateAvailability, beatmap), true);
+            downloadTracker.State.BindValueChanged(_ => Scheduler.AddOnce(updateAvailability), true);
             downloadTracker.Progress.BindValueChanged(_ =>
             {
                 if (downloadTracker.State.Value != DownloadState.Downloading)
@@ -91,23 +94,23 @@ namespace osu.Game.Online.Rooms
                 // incoming progress changes are going to be at a very high rate.
                 // we don't want to flood the network with this, so rate limit how often we send progress updates.
                 if (progressUpdate?.Completed != false)
-                    progressUpdate = Scheduler.AddDelayed(updateAvailability, beatmap, progressUpdate == null ? 0 : 500);
+                    progressUpdate = Scheduler.AddDelayed(updateAvailability, progressUpdate == null ? 0 : 500);
             }, true);
 
             // handles changes to hash that didn't occur from the import process (ie. a user editing the beatmap in the editor, somehow).
             realmSubscription?.Dispose();
-            realmSubscription = realm.RegisterForNotifications(r => filteredBeatmaps(beatmap), (items, changes, ___) =>
+            realmSubscription = realm.RegisterForNotifications(r => filteredBeatmaps(), (items, changes, ___) =>
             {
                 if (changes == null)
                     return;
 
-                Scheduler.AddOnce(updateAvailability, beatmap);
+                Scheduler.AddOnce(updateAvailability);
             });
         }
 
-        private void updateAvailability(APIBeatmap beatmap)
+        private void updateAvailability()
         {
-            if (downloadTracker == null)
+            if (downloadTracker == null || selectedBeatmap == null)
                 return;
 
             switch (downloadTracker.State.Value)
@@ -125,7 +128,7 @@ namespace osu.Game.Online.Rooms
                     break;
 
                 case DownloadState.LocallyAvailable:
-                    bool available = filteredBeatmaps(beatmap).Any();
+                    bool available = filteredBeatmaps().Any();
 
                     availability.Value = available ? BeatmapAvailability.LocallyAvailable() : BeatmapAvailability.NotDownloaded();
 
@@ -140,10 +143,10 @@ namespace osu.Game.Online.Rooms
             }
         }
 
-        private IQueryable<BeatmapInfo> filteredBeatmaps(APIBeatmap beatmap)
+        private IQueryable<BeatmapInfo> filteredBeatmaps()
         {
-            int onlineId = beatmap.OnlineID;
-            string checksum = beatmap.MD5Hash;
+            int onlineId = selectedBeatmap.OnlineID;
+            string checksum = selectedBeatmap.MD5Hash;
 
             return realm.Realm
                         .All<BeatmapInfo>()

From d4bf335fccd31e921447b999a91d722998d51417 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 16 Feb 2022 16:24:39 +0900
Subject: [PATCH 2939/5547] Use score multiplier attribute in
 ManiaPerformanceCalculator

---
 .../Difficulty/ManiaPerformanceCalculator.cs     | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/osu.Game.Rulesets.Mania/Difficulty/ManiaPerformanceCalculator.cs b/osu.Game.Rulesets.Mania/Difficulty/ManiaPerformanceCalculator.cs
index 8a8c41bb8a..beba29b8bb 100644
--- a/osu.Game.Rulesets.Mania/Difficulty/ManiaPerformanceCalculator.cs
+++ b/osu.Game.Rulesets.Mania/Difficulty/ManiaPerformanceCalculator.cs
@@ -43,14 +43,11 @@ namespace osu.Game.Rulesets.Mania.Difficulty
             countMeh = Score.Statistics.GetValueOrDefault(HitResult.Meh);
             countMiss = Score.Statistics.GetValueOrDefault(HitResult.Miss);
 
-            IEnumerable<Mod> scoreIncreaseMods = Ruleset.GetModsFor(ModType.DifficultyIncrease);
-
-            double scoreMultiplier = 1.0;
-            foreach (var m in mods.Where(m => !scoreIncreaseMods.Contains(m)))
-                scoreMultiplier *= m.ScoreMultiplier;
-
-            // Scale score up, so it's comparable to other keymods
-            scaledScore *= 1.0 / scoreMultiplier;
+            if (Attributes.ScoreMultiplier > 0)
+            {
+                // Scale score up, so it's comparable to other keymods
+                scaledScore *= 1.0 / Attributes.ScoreMultiplier;
+            }
 
             // Arbitrary initial value for scaling pp in order to standardize distributions across game modes.
             // The specific number has no intrinsic meaning and can be adjusted as needed.
@@ -80,6 +77,9 @@ namespace osu.Game.Rulesets.Mania.Difficulty
 
         private double computeDifficultyValue()
         {
+            if (Attributes.ScoreMultiplier <= 0)
+                return 0;
+
             double difficultyValue = Math.Pow(5 * Math.Max(1, Attributes.StarRating / 0.2) - 4.0, 2.2) / 135.0;
 
             difficultyValue *= 1.0 + 0.1 * Math.Min(1.0, totalHits / 1500.0);

From 5dd9771c5fbb2ae68efe146b769375a6210b00d7 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 16 Feb 2022 16:27:27 +0900
Subject: [PATCH 2940/5547] Remove mod multipliers from being applied to scores

---
 .../TestSceneFooterButtonMods.cs              | 27 ++-----------------
 osu.Game/Rulesets/Scoring/ScoreProcessor.cs   | 13 +--------
 osu.Game/Screens/Select/FooterButtonMods.cs   | 25 -----------------
 3 files changed, 3 insertions(+), 62 deletions(-)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneFooterButtonMods.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneFooterButtonMods.cs
index 0631059d1a..e9014c0941 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneFooterButtonMods.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneFooterButtonMods.cs
@@ -3,9 +3,7 @@
 
 using System;
 using System.Collections.Generic;
-using System.Linq;
 using NUnit.Framework;
-using osu.Game.Graphics.Sprites;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Osu.Mods;
 using osu.Game.Screens.Select;
@@ -14,11 +12,11 @@ namespace osu.Game.Tests.Visual.UserInterface
 {
     public class TestSceneFooterButtonMods : OsuTestScene
     {
-        private readonly TestFooterButtonMods footerButtonMods;
+        private readonly FooterButtonMods footerButtonMods;
 
         public TestSceneFooterButtonMods()
         {
-            Add(footerButtonMods = new TestFooterButtonMods());
+            Add(footerButtonMods = new FooterButtonMods());
         }
 
         [Test]
@@ -26,19 +24,15 @@ namespace osu.Game.Tests.Visual.UserInterface
         {
             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]
@@ -46,15 +40,12 @@ namespace osu.Game.Tests.Visual.UserInterface
         {
             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]
@@ -63,25 +54,11 @@ namespace osu.Game.Tests.Visual.UserInterface
             var multipleMods = new Mod[] { new OsuModDoubleTime(), new OsuModFlashlight() };
             AddStep(@"Add mods", () => changeMods(multipleMods));
             AddStep(@"Clear selected mod", () => changeMods(Array.Empty<Mod>()));
-            AddAssert(@"Check empty multiplier", () => assertModsMultiplier(Array.Empty<Mod>()));
         }
 
         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 = multiplier.Equals(1.0) ? string.Empty : $"{multiplier:N2}x";
-
-            return expectedValue == footerButtonMods.MultiplierText.Current.Value;
-        }
-
-        private class TestFooterButtonMods : FooterButtonMods
-        {
-            public new OsuSpriteText MultiplierText => base.MultiplierText;
-        }
     }
 }
diff --git a/osu.Game/Rulesets/Scoring/ScoreProcessor.cs b/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
index 79861c0ecc..ce1486b02f 100644
--- a/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
+++ b/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
@@ -92,8 +92,6 @@ namespace osu.Game.Rulesets.Scoring
         private readonly List<HitEvent> hitEvents = new List<HitEvent>();
         private HitObject lastHitObject;
 
-        private double scoreMultiplier = 1;
-
         public ScoreProcessor()
         {
             accuracyPortion = DefaultAccuracyPortion;
@@ -111,15 +109,6 @@ namespace osu.Game.Rulesets.Scoring
             };
 
             Mode.ValueChanged += _ => updateScore();
-            Mods.ValueChanged += mods =>
-            {
-                scoreMultiplier = 1;
-
-                foreach (var m in mods.NewValue)
-                    scoreMultiplier *= m.ScoreMultiplier;
-
-                updateScore();
-            };
         }
 
         private readonly Dictionary<HitResult, int> scoreResultCounts = new Dictionary<HitResult, int>();
@@ -235,7 +224,7 @@ namespace osu.Game.Rulesets.Scoring
                 case ScoringMode.Standardised:
                     double accuracyScore = accuracyPortion * accuracyRatio;
                     double comboScore = comboPortion * comboRatio;
-                    return (max_score * (accuracyScore + comboScore) + getBonusScore(statistics)) * scoreMultiplier;
+                    return (max_score * (accuracyScore + comboScore) + getBonusScore(statistics));
 
                 case ScoringMode.Classic:
                     // This gives a similar feeling to osu!stable scoring (ScoreV1) while keeping classic scoring as only a constant multiple of standardised scoring.
diff --git a/osu.Game/Screens/Select/FooterButtonMods.cs b/osu.Game/Screens/Select/FooterButtonMods.cs
index 5bbca5ca1a..1f1aa4c4b3 100644
--- a/osu.Game/Screens/Select/FooterButtonMods.cs
+++ b/osu.Game/Screens/Select/FooterButtonMods.cs
@@ -6,14 +6,11 @@ using osu.Framework.Graphics;
 using osu.Game.Screens.Play.HUD;
 using osu.Game.Rulesets.Mods;
 using System.Collections.Generic;
-using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics.UserInterface;
 using osu.Game.Graphics;
-using osu.Game.Graphics.Sprites;
 using osuTK;
-using osuTK.Graphics;
 using osu.Game.Input.Bindings;
 
 namespace osu.Game.Screens.Select
@@ -26,10 +23,7 @@ namespace osu.Game.Screens.Select
             set => modDisplay.Current = value;
         }
 
-        protected readonly OsuSpriteText MultiplierText;
         private readonly ModDisplay modDisplay;
-        private Color4 lowMultiplierColour;
-        private Color4 highMultiplierColour;
 
         public FooterButtonMods()
         {
@@ -40,12 +34,6 @@ namespace osu.Game.Screens.Select
                 Scale = new Vector2(0.8f),
                 ExpansionMode = ExpansionMode.AlwaysContracted,
             });
-            ButtonContentContainer.Add(MultiplierText = new OsuSpriteText
-            {
-                Anchor = Anchor.Centre,
-                Origin = Anchor.Centre,
-                Font = OsuFont.GetFont(weight: FontWeight.Bold),
-            });
         }
 
         [BackgroundDependencyLoader]
@@ -53,8 +41,6 @@ namespace osu.Game.Screens.Select
         {
             SelectedColour = colours.Yellow;
             DeselectedColour = SelectedColour.Opacity(0.5f);
-            lowMultiplierColour = colours.Red;
-            highMultiplierColour = colours.Green;
             Text = @"mods";
             Hotkey = GlobalAction.ToggleModSelection;
         }
@@ -68,17 +54,6 @@ namespace osu.Game.Screens.Select
 
         private void updateMultiplierText()
         {
-            double multiplier = Current.Value?.Aggregate(1.0, (current, mod) => current * mod.ScoreMultiplier) ?? 1;
-
-            MultiplierText.Text = multiplier.Equals(1.0) ? string.Empty : $"{multiplier:N2}x";
-
-            if (multiplier > 1.0)
-                MultiplierText.FadeColour(highMultiplierColour, 200);
-            else if (multiplier < 1.0)
-                MultiplierText.FadeColour(lowMultiplierColour, 200);
-            else
-                MultiplierText.FadeColour(Color4.White, 200);
-
             if (Current.Value?.Count > 0)
                 modDisplay.FadeIn();
             else

From b66566e96d4f22d7e4351443ea8d999fd7f9bce7 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 16 Feb 2022 10:35:57 +0300
Subject: [PATCH 2941/5547] Use explicit culture info rather than `null`

---
 osu.Game/Overlays/Settings/Sections/SizeSlider.cs | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/Settings/Sections/SizeSlider.cs b/osu.Game/Overlays/Settings/Sections/SizeSlider.cs
index cc2c77adf2..26db1aa755 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.Globalization;
 using osu.Framework.Localisation;
 using osu.Game.Graphics.UserInterface;
 
@@ -13,6 +14,6 @@ namespace osu.Game.Overlays.Settings.Sections
     internal class SizeSlider<T> : OsuSliderBar<T>
         where T : struct, IEquatable<T>, IComparable<T>, IConvertible, IFormattable
     {
-        public override LocalisableString TooltipText => Current.Value.ToString(@"0.##x", null);
+        public override LocalisableString TooltipText => Current.Value.ToString(@"0.##x", NumberFormatInfo.CurrentInfo);
     }
 }

From 4c1413e0c793995d5a9ea4802419d9131d9abe53 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 16 Feb 2022 16:36:02 +0900
Subject: [PATCH 2942/5547] No longer require Mod implementation

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

diff --git a/osu.Game/Rulesets/Mods/Mod.cs b/osu.Game/Rulesets/Mods/Mod.cs
index 7136795461..5555770822 100644
--- a/osu.Game/Rulesets/Mods/Mod.cs
+++ b/osu.Game/Rulesets/Mods/Mod.cs
@@ -83,7 +83,7 @@ namespace osu.Game.Rulesets.Mods
         /// The score multiplier of this mod.
         /// </summary>
         [JsonIgnore]
-        public abstract double ScoreMultiplier { get; }
+        public virtual double ScoreMultiplier => 1;
 
         /// <summary>
         /// Returns true if this mod is implemented (and playable).

From 3d3f0a89c2c1b933eff1a7f8575ba7ac6a890f52 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 16 Feb 2022 16:46:53 +0900
Subject: [PATCH 2943/5547] Remove legacy `RulesetID` property from
 `BeatmapInfo`

---
 osu.Game/Beatmaps/BeatmapInfo.cs | 12 ------------
 1 file changed, 12 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapInfo.cs b/osu.Game/Beatmaps/BeatmapInfo.cs
index e4bfd768b7..305b3979a0 100644
--- a/osu.Game/Beatmaps/BeatmapInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapInfo.cs
@@ -152,18 +152,6 @@ namespace osu.Game.Beatmaps
 
         #region Compatibility properties
 
-        [Ignored]
-        public int RulesetID
-        {
-            set
-            {
-                if (!string.IsNullOrEmpty(Ruleset.InstantiationInfo))
-                    throw new InvalidOperationException($"Cannot set a {nameof(RulesetID)} when {nameof(Ruleset)} is already set to an actual ruleset.");
-
-                Ruleset.OnlineID = value;
-            }
-        }
-
         [Ignored]
         [Obsolete("Use BeatmapInfo.Difficulty instead.")] // can be removed 20220719
         public BeatmapDifficulty BaseDifficulty

From 7a69de0060c2c55d731fd89f3a62d72eeb93c424 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 16 Feb 2022 16:57:28 +0900
Subject: [PATCH 2944/5547] Split out realm portion of `RulesetStore`

---
 osu.Game/OsuGameBase.cs                |   7 +-
 osu.Game/Rulesets/RealmRulesetStore.cs | 101 +++++++++++++++++++++++++
 osu.Game/Rulesets/RulesetStore.cs      | 101 +++----------------------
 3 files changed, 115 insertions(+), 94 deletions(-)
 create mode 100644 osu.Game/Rulesets/RealmRulesetStore.cs

diff --git a/osu.Game/OsuGameBase.cs b/osu.Game/OsuGameBase.cs
index 0b2644d5ba..d89e1e8193 100644
--- a/osu.Game/OsuGameBase.cs
+++ b/osu.Game/OsuGameBase.cs
@@ -22,6 +22,7 @@ using osu.Framework.Logging;
 using osu.Framework.Platform;
 using osu.Game.Audio;
 using osu.Game.Beatmaps;
+using osu.Game.Beatmaps.Formats;
 using osu.Game.Configuration;
 using osu.Game.Database;
 using osu.Game.Graphics;
@@ -109,7 +110,7 @@ namespace osu.Game
 
         protected SkinManager SkinManager { get; private set; }
 
-        protected RulesetStore RulesetStore { get; private set; }
+        protected RealmRulesetStore RulesetStore { get; private set; }
 
         protected RealmKeyBindingStore KeyBindingStore { get; private set; }
 
@@ -200,9 +201,11 @@ namespace osu.Game
 
             dependencies.Cache(realm = new RealmAccess(Storage, "client", EFContextFactory));
 
-            dependencies.Cache(RulesetStore = new RulesetStore(realm, Storage));
+            dependencies.CacheAs<RulesetStore>(RulesetStore = new RealmRulesetStore(realm, Storage));
             dependencies.CacheAs<IRulesetStore>(RulesetStore);
 
+            Decoder.RegisterDependencies(RulesetStore);
+
             // Backup is taken here rather than in EFToRealmMigrator to avoid recycling realm contexts
             // after initial usages below. It can be moved once a direction is established for handling re-subscription.
             // See https://github.com/ppy/osu/pull/16547 for more discussion.
diff --git a/osu.Game/Rulesets/RealmRulesetStore.cs b/osu.Game/Rulesets/RealmRulesetStore.cs
new file mode 100644
index 0000000000..f42bf06da4
--- /dev/null
+++ b/osu.Game/Rulesets/RealmRulesetStore.cs
@@ -0,0 +1,101 @@
+// 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.Extensions.ObjectExtensions;
+using osu.Framework.Logging;
+using osu.Framework.Platform;
+using osu.Game.Database;
+
+#nullable enable
+
+namespace osu.Game.Rulesets
+{
+    public class RealmRulesetStore : RulesetStore
+    {
+        public override IEnumerable<RulesetInfo> AvailableRulesets => availableRulesets;
+
+        private readonly List<RulesetInfo> availableRulesets = new List<RulesetInfo>();
+
+        public RealmRulesetStore(RealmAccess realm, Storage? storage = null)
+            : base(storage)
+        {
+            prepareDetachedRulesets(realm);
+        }
+
+        private void prepareDetachedRulesets(RealmAccess realmAccess)
+        {
+            realmAccess.Write(realm =>
+            {
+                var rulesets = realm.All<RulesetInfo>();
+
+                List<Ruleset> instances = LoadedAssemblies.Values
+                                                          .Select(r => Activator.CreateInstance(r) as Ruleset)
+                                                          .Where(r => r != null)
+                                                          .Select(r => r.AsNonNull())
+                                                          .ToList();
+
+                // add all legacy rulesets first to ensure they have exclusive choice of primary key.
+                foreach (var r in instances.Where(r => r is ILegacyRuleset))
+                {
+                    if (realm.All<RulesetInfo>().FirstOrDefault(rr => rr.OnlineID == r.RulesetInfo.OnlineID) == null)
+                        realm.Add(new RulesetInfo(r.RulesetInfo.ShortName, r.RulesetInfo.Name, r.RulesetInfo.InstantiationInfo, r.RulesetInfo.OnlineID));
+                }
+
+                // add any other rulesets which have assemblies present but are not yet in the database.
+                foreach (var r in instances.Where(r => !(r is ILegacyRuleset)))
+                {
+                    if (rulesets.FirstOrDefault(ri => ri.InstantiationInfo.Equals(r.RulesetInfo.InstantiationInfo, StringComparison.Ordinal)) == null)
+                    {
+                        var existingSameShortName = rulesets.FirstOrDefault(ri => ri.ShortName == r.RulesetInfo.ShortName);
+
+                        if (existingSameShortName != null)
+                        {
+                            // even if a matching InstantiationInfo was not found, there may be an existing ruleset with the same ShortName.
+                            // this generally means the user or ruleset provider has renamed their dll but the underlying ruleset is *likely* the same one.
+                            // in such cases, update the instantiation info of the existing entry to point to the new one.
+                            existingSameShortName.InstantiationInfo = r.RulesetInfo.InstantiationInfo;
+                        }
+                        else
+                            realm.Add(new RulesetInfo(r.RulesetInfo.ShortName, r.RulesetInfo.Name, r.RulesetInfo.InstantiationInfo, r.RulesetInfo.OnlineID));
+                    }
+                }
+
+                List<RulesetInfo> detachedRulesets = new List<RulesetInfo>();
+
+                // perform a consistency check and detach final rulesets from realm for cross-thread runtime usage.
+                foreach (var r in rulesets.OrderBy(r => r.OnlineID))
+                {
+                    try
+                    {
+                        var resolvedType = Type.GetType(r.InstantiationInfo)
+                                           ?? throw new RulesetLoadException(@"Type could not be resolved");
+
+                        var instanceInfo = (Activator.CreateInstance(resolvedType) as Ruleset)?.RulesetInfo
+                                           ?? throw new RulesetLoadException(@"Instantiation failure");
+
+                        // If a ruleset isn't up-to-date with the API, it could cause a crash at an arbitrary point of execution.
+                        // To eagerly handle cases of missing implementations, enumerate all types here and mark as non-available on throw.
+                        resolvedType.Assembly.GetTypes();
+
+                        r.Name = instanceInfo.Name;
+                        r.ShortName = instanceInfo.ShortName;
+                        r.InstantiationInfo = instanceInfo.InstantiationInfo;
+                        r.Available = true;
+
+                        detachedRulesets.Add(r.Clone());
+                    }
+                    catch (Exception ex)
+                    {
+                        r.Available = false;
+                        Logger.Log($"Could not load ruleset {r}: {ex.Message}");
+                    }
+                }
+
+                availableRulesets.AddRange(detachedRulesets.OrderBy(r => r));
+            });
+        }
+    }
+}
diff --git a/osu.Game/Rulesets/RulesetStore.cs b/osu.Game/Rulesets/RulesetStore.cs
index dd25005006..6f88d97a58 100644
--- a/osu.Game/Rulesets/RulesetStore.cs
+++ b/osu.Game/Rulesets/RulesetStore.cs
@@ -7,34 +7,26 @@ using System.IO;
 using System.Linq;
 using System.Reflection;
 using osu.Framework;
-using osu.Framework.Extensions.ObjectExtensions;
 using osu.Framework.Logging;
 using osu.Framework.Platform;
-using osu.Game.Database;
 
 #nullable enable
 
 namespace osu.Game.Rulesets
 {
-    public class RulesetStore : IDisposable, IRulesetStore
+    public abstract class RulesetStore : IDisposable, IRulesetStore
     {
-        private readonly RealmAccess realmAccess;
-
         private const string ruleset_library_prefix = @"osu.Game.Rulesets";
 
-        private readonly Dictionary<Assembly, Type> loadedAssemblies = new Dictionary<Assembly, Type>();
+        protected readonly Dictionary<Assembly, Type> LoadedAssemblies = new Dictionary<Assembly, Type>();
 
         /// <summary>
         /// All available rulesets.
         /// </summary>
-        public IEnumerable<RulesetInfo> AvailableRulesets => availableRulesets;
+        public abstract IEnumerable<RulesetInfo> AvailableRulesets { get; }
 
-        private readonly List<RulesetInfo> availableRulesets = new List<RulesetInfo>();
-
-        public RulesetStore(RealmAccess realm, Storage? storage = null)
+        protected RulesetStore(Storage? storage = null)
         {
-            realmAccess = realm;
-
             // On android in release configuration assemblies are loaded from the apk directly into memory.
             // We cannot read assemblies from cwd, so should check loaded assemblies instead.
             loadFromAppDomain();
@@ -53,8 +45,6 @@ namespace osu.Game.Rulesets
             var rulesetStorage = storage?.GetStorageForDirectory(@"rulesets");
             if (rulesetStorage != null)
                 loadUserRulesets(rulesetStorage);
-
-            addMissingRulesets();
         }
 
         /// <summary>
@@ -95,80 +85,7 @@ namespace osu.Game.Rulesets
             if (domainAssembly != null)
                 return domainAssembly;
 
-            return loadedAssemblies.Keys.FirstOrDefault(a => a.FullName == asm.FullName);
-        }
-
-        private void addMissingRulesets()
-        {
-            realmAccess.Write(realm =>
-            {
-                var rulesets = realm.All<RulesetInfo>();
-
-                List<Ruleset> instances = loadedAssemblies.Values
-                                                          .Select(r => Activator.CreateInstance(r) as Ruleset)
-                                                          .Where(r => r != null)
-                                                          .Select(r => r.AsNonNull())
-                                                          .ToList();
-
-                // add all legacy rulesets first to ensure they have exclusive choice of primary key.
-                foreach (var r in instances.Where(r => r is ILegacyRuleset))
-                {
-                    if (realm.All<RulesetInfo>().FirstOrDefault(rr => rr.OnlineID == r.RulesetInfo.OnlineID) == null)
-                        realm.Add(new RulesetInfo(r.RulesetInfo.ShortName, r.RulesetInfo.Name, r.RulesetInfo.InstantiationInfo, r.RulesetInfo.OnlineID));
-                }
-
-                // add any other rulesets which have assemblies present but are not yet in the database.
-                foreach (var r in instances.Where(r => !(r is ILegacyRuleset)))
-                {
-                    if (rulesets.FirstOrDefault(ri => ri.InstantiationInfo.Equals(r.RulesetInfo.InstantiationInfo, StringComparison.Ordinal)) == null)
-                    {
-                        var existingSameShortName = rulesets.FirstOrDefault(ri => ri.ShortName == r.RulesetInfo.ShortName);
-
-                        if (existingSameShortName != null)
-                        {
-                            // even if a matching InstantiationInfo was not found, there may be an existing ruleset with the same ShortName.
-                            // this generally means the user or ruleset provider has renamed their dll but the underlying ruleset is *likely* the same one.
-                            // in such cases, update the instantiation info of the existing entry to point to the new one.
-                            existingSameShortName.InstantiationInfo = r.RulesetInfo.InstantiationInfo;
-                        }
-                        else
-                            realm.Add(new RulesetInfo(r.RulesetInfo.ShortName, r.RulesetInfo.Name, r.RulesetInfo.InstantiationInfo, r.RulesetInfo.OnlineID));
-                    }
-                }
-
-                List<RulesetInfo> detachedRulesets = new List<RulesetInfo>();
-
-                // perform a consistency check and detach final rulesets from realm for cross-thread runtime usage.
-                foreach (var r in rulesets.OrderBy(r => r.OnlineID))
-                {
-                    try
-                    {
-                        var resolvedType = Type.GetType(r.InstantiationInfo)
-                                           ?? throw new RulesetLoadException(@"Type could not be resolved");
-
-                        var instanceInfo = (Activator.CreateInstance(resolvedType) as Ruleset)?.RulesetInfo
-                                           ?? throw new RulesetLoadException(@"Instantiation failure");
-
-                        // If a ruleset isn't up-to-date with the API, it could cause a crash at an arbitrary point of execution.
-                        // To eagerly handle cases of missing implementations, enumerate all types here and mark as non-available on throw.
-                        resolvedType.Assembly.GetTypes();
-
-                        r.Name = instanceInfo.Name;
-                        r.ShortName = instanceInfo.ShortName;
-                        r.InstantiationInfo = instanceInfo.InstantiationInfo;
-                        r.Available = true;
-
-                        detachedRulesets.Add(r.Clone());
-                    }
-                    catch (Exception ex)
-                    {
-                        r.Available = false;
-                        Logger.Log($"Could not load ruleset {r}: {ex.Message}");
-                    }
-                }
-
-                availableRulesets.AddRange(detachedRulesets.OrderBy(r => r));
-            });
+            return LoadedAssemblies.Keys.FirstOrDefault(a => a.FullName == asm.FullName);
         }
 
         private void loadFromAppDomain()
@@ -214,7 +131,7 @@ namespace osu.Game.Rulesets
         {
             string? filename = Path.GetFileNameWithoutExtension(file);
 
-            if (loadedAssemblies.Values.Any(t => Path.GetFileNameWithoutExtension(t.Assembly.Location) == filename))
+            if (LoadedAssemblies.Values.Any(t => Path.GetFileNameWithoutExtension(t.Assembly.Location) == filename))
                 return;
 
             try
@@ -229,17 +146,17 @@ namespace osu.Game.Rulesets
 
         private void addRuleset(Assembly assembly)
         {
-            if (loadedAssemblies.ContainsKey(assembly))
+            if (LoadedAssemblies.ContainsKey(assembly))
                 return;
 
             // the same assembly may be loaded twice in the same AppDomain (currently a thing in certain Rider versions https://youtrack.jetbrains.com/issue/RIDER-48799).
             // as a failsafe, also compare by FullName.
-            if (loadedAssemblies.Any(a => a.Key.FullName == assembly.FullName))
+            if (LoadedAssemblies.Any(a => a.Key.FullName == assembly.FullName))
                 return;
 
             try
             {
-                loadedAssemblies[assembly] = assembly.GetTypes().First(t => t.IsPublic && t.IsSubclassOf(typeof(Ruleset)));
+                LoadedAssemblies[assembly] = assembly.GetTypes().First(t => t.IsPublic && t.IsSubclassOf(typeof(Ruleset)));
             }
             catch (Exception e)
             {

From 0138f22c8d12b81cc6343798c8be1661a45f8524 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 16 Feb 2022 17:13:51 +0900
Subject: [PATCH 2945/5547] Update existing usages to point to
 `RealmRulesetStore`

---
 .../Database/BeatmapImporterTests.cs          | 50 +++++++++----------
 osu.Game.Tests/Database/RulesetStoreTests.cs  |  8 +--
 ...eneOnlinePlayBeatmapAvailabilityTracker.cs |  2 +-
 .../Background/TestSceneUserDimBackgrounds.cs |  2 +-
 .../TestSceneManageCollectionsDialog.cs       |  2 +-
 .../Visual/Multiplayer/QueueModeTestScene.cs  |  2 +-
 .../TestSceneDrawableRoomPlaylist.cs          |  2 +-
 .../Multiplayer/TestSceneMultiplayer.cs       |  2 +-
 .../TestSceneMultiplayerMatchSongSelect.cs    |  2 +-
 .../TestSceneMultiplayerMatchSubScreen.cs     |  2 +-
 .../TestSceneMultiplayerPlaylist.cs           |  2 +-
 .../TestSceneMultiplayerQueueList.cs          |  2 +-
 .../TestSceneMultiplayerReadyButton.cs        |  2 +-
 .../TestSceneMultiplayerSpectateButton.cs     |  2 +-
 .../TestScenePlaylistsSongSelect.cs           |  2 +-
 .../Visual/Multiplayer/TestSceneTeamVersus.cs |  2 +-
 .../TestScenePlaylistsRoomCreation.cs         |  2 +-
 .../SongSelect/TestSceneBeatmapLeaderboard.cs |  2 +-
 .../SongSelect/TestSceneFilterControl.cs      |  2 +-
 .../SongSelect/TestScenePlaySongSelect.cs     |  2 +-
 .../SongSelect/TestSceneTopLocalRank.cs       |  2 +-
 .../TestSceneDeleteLocalScore.cs              |  2 +-
 22 files changed, 49 insertions(+), 49 deletions(-)

diff --git a/osu.Game.Tests/Database/BeatmapImporterTests.cs b/osu.Game.Tests/Database/BeatmapImporterTests.cs
index 2c7d0211a0..9d67381b5a 100644
--- a/osu.Game.Tests/Database/BeatmapImporterTests.cs
+++ b/osu.Game.Tests/Database/BeatmapImporterTests.cs
@@ -41,7 +41,7 @@ namespace osu.Game.Tests.Database
             RunTestWithRealmAsync(async (realm, storage) =>
             {
                 using (var importer = new BeatmapModelManager(realm, storage))
-                using (new RulesetStore(realm, storage))
+                using (new RealmRulesetStore(realm, storage))
                 {
                     Live<BeatmapSetInfo>? beatmapSet;
 
@@ -85,7 +85,7 @@ namespace osu.Game.Tests.Database
             RunTestWithRealmAsync(async (realm, storage) =>
             {
                 using (var importer = new BeatmapModelManager(realm, storage))
-                using (new RulesetStore(realm, storage))
+                using (new RealmRulesetStore(realm, storage))
                 {
                     Live<BeatmapSetInfo>? beatmapSet;
 
@@ -142,7 +142,7 @@ namespace osu.Game.Tests.Database
             RunTestWithRealmAsync(async (realm, storage) =>
             {
                 using (var importer = new BeatmapModelManager(realm, storage))
-                using (new RulesetStore(realm, storage))
+                using (new RealmRulesetStore(realm, storage))
                 {
                     Live<BeatmapSetInfo>? imported;
 
@@ -171,7 +171,7 @@ namespace osu.Game.Tests.Database
             RunTestWithRealmAsync(async (realm, storage) =>
             {
                 using var importer = new BeatmapModelManager(realm, storage);
-                using var store = new RulesetStore(realm, storage);
+                using var store = new RealmRulesetStore(realm, storage);
 
                 await LoadOszIntoStore(importer, realm.Realm);
             });
@@ -183,7 +183,7 @@ namespace osu.Game.Tests.Database
             RunTestWithRealmAsync(async (realm, storage) =>
             {
                 using var importer = new BeatmapModelManager(realm, storage);
-                using var store = new RulesetStore(realm, storage);
+                using var store = new RealmRulesetStore(realm, storage);
 
                 var imported = await LoadOszIntoStore(importer, realm.Realm);
 
@@ -201,7 +201,7 @@ namespace osu.Game.Tests.Database
             RunTestWithRealmAsync(async (realm, storage) =>
             {
                 using var importer = new BeatmapModelManager(realm, storage);
-                using var store = new RulesetStore(realm, storage);
+                using var store = new RealmRulesetStore(realm, storage);
 
                 var imported = await LoadOszIntoStore(importer, realm.Realm);
 
@@ -215,7 +215,7 @@ namespace osu.Game.Tests.Database
             RunTestWithRealmAsync(async (realm, storage) =>
             {
                 using var importer = new BeatmapModelManager(realm, storage);
-                using var store = new RulesetStore(realm, storage);
+                using var store = new RealmRulesetStore(realm, storage);
 
                 string? tempPath = TestResources.GetTestBeatmapForImport();
 
@@ -245,7 +245,7 @@ namespace osu.Game.Tests.Database
             RunTestWithRealmAsync(async (realm, storage) =>
             {
                 using var importer = new BeatmapModelManager(realm, storage);
-                using var store = new RulesetStore(realm, storage);
+                using var store = new RealmRulesetStore(realm, storage);
 
                 var imported = await LoadOszIntoStore(importer, realm.Realm);
                 var importedSecondTime = await LoadOszIntoStore(importer, realm.Realm);
@@ -265,7 +265,7 @@ namespace osu.Game.Tests.Database
             RunTestWithRealmAsync(async (realm, storage) =>
             {
                 using var importer = new BeatmapModelManager(realm, storage);
-                using var store = new RulesetStore(realm, storage);
+                using var store = new RealmRulesetStore(realm, storage);
 
                 string? temp = TestResources.GetTestBeatmapForImport();
 
@@ -314,7 +314,7 @@ namespace osu.Game.Tests.Database
             RunTestWithRealmAsync(async (realm, storage) =>
             {
                 using var importer = new BeatmapModelManager(realm, storage);
-                using var store = new RulesetStore(realm, storage);
+                using var store = new RealmRulesetStore(realm, storage);
 
                 string? temp = TestResources.GetTestBeatmapForImport();
 
@@ -366,7 +366,7 @@ namespace osu.Game.Tests.Database
             RunTestWithRealmAsync(async (realm, storage) =>
             {
                 using var importer = new BeatmapModelManager(realm, storage);
-                using var store = new RulesetStore(realm, storage);
+                using var store = new RealmRulesetStore(realm, storage);
 
                 string? temp = TestResources.GetTestBeatmapForImport();
 
@@ -414,7 +414,7 @@ namespace osu.Game.Tests.Database
             RunTestWithRealmAsync(async (realm, storage) =>
             {
                 using var importer = new BeatmapModelManager(realm, storage);
-                using var store = new RulesetStore(realm, storage);
+                using var store = new RealmRulesetStore(realm, storage);
 
                 string? temp = TestResources.GetTestBeatmapForImport();
 
@@ -463,7 +463,7 @@ namespace osu.Game.Tests.Database
             RunTestWithRealmAsync(async (realm, storage) =>
             {
                 using var importer = new BeatmapModelManager(realm, storage);
-                using var store = new RulesetStore(realm, storage);
+                using var store = new RealmRulesetStore(realm, storage);
 
                 var imported = await LoadOszIntoStore(importer, realm.Realm);
 
@@ -496,7 +496,7 @@ namespace osu.Game.Tests.Database
             RunTestWithRealmAsync(async (realm, storage) =>
             {
                 using var importer = new BeatmapModelManager(realm, storage);
-                using var store = new RulesetStore(realm, storage);
+                using var store = new RealmRulesetStore(realm, storage);
 
                 var progressNotification = new ImportProgressNotification();
 
@@ -532,7 +532,7 @@ namespace osu.Game.Tests.Database
                 };
 
                 using var importer = new BeatmapModelManager(realm, storage);
-                using var store = new RulesetStore(realm, storage);
+                using var store = new RealmRulesetStore(realm, storage);
 
                 var imported = await LoadOszIntoStore(importer, realm.Realm);
 
@@ -582,7 +582,7 @@ namespace osu.Game.Tests.Database
             RunTestWithRealmAsync(async (realm, storage) =>
             {
                 using var importer = new BeatmapModelManager(realm, storage);
-                using var store = new RulesetStore(realm, storage);
+                using var store = new RealmRulesetStore(realm, storage);
 
                 var imported = await LoadOszIntoStore(importer, realm.Realm);
 
@@ -606,7 +606,7 @@ namespace osu.Game.Tests.Database
             RunTestWithRealmAsync(async (realmFactory, storage) =>
             {
                 using var importer = new BeatmapModelManager(realmFactory, storage);
-                using var store = new RulesetStore(realmFactory, storage);
+                using var store = new RealmRulesetStore(realmFactory, storage);
 
                 var imported = await LoadOszIntoStore(importer, realmFactory.Realm);
 
@@ -638,7 +638,7 @@ namespace osu.Game.Tests.Database
             RunTestWithRealmAsync(async (realm, storage) =>
             {
                 using var importer = new NonOptimisedBeatmapImporter(realm, storage);
-                using var store = new RulesetStore(realm, storage);
+                using var store = new RealmRulesetStore(realm, storage);
 
                 var imported = await LoadOszIntoStore(importer, realm.Realm);
 
@@ -662,7 +662,7 @@ namespace osu.Game.Tests.Database
             RunTestWithRealmAsync(async (realm, storage) =>
             {
                 using var importer = new BeatmapModelManager(realm, storage);
-                using var store = new RulesetStore(realm, storage);
+                using var store = new RealmRulesetStore(realm, storage);
 
                 var imported = await LoadOszIntoStore(importer, realm.Realm);
 
@@ -688,7 +688,7 @@ namespace osu.Game.Tests.Database
             RunTestWithRealm((realm, storage) =>
             {
                 using var importer = new BeatmapModelManager(realm, storage);
-                using var store = new RulesetStore(realm, storage);
+                using var store = new RealmRulesetStore(realm, storage);
 
                 var metadata = new BeatmapMetadata
                 {
@@ -734,7 +734,7 @@ namespace osu.Game.Tests.Database
             RunTestWithRealmAsync(async (realm, storage) =>
             {
                 using var importer = new BeatmapModelManager(realm, storage);
-                using var store = new RulesetStore(realm, storage);
+                using var store = new RealmRulesetStore(realm, storage);
 
                 string? temp = TestResources.GetTestBeatmapForImport();
                 using (File.OpenRead(temp))
@@ -751,7 +751,7 @@ namespace osu.Game.Tests.Database
             RunTestWithRealmAsync(async (realm, storage) =>
             {
                 using var importer = new BeatmapModelManager(realm, storage);
-                using var store = new RulesetStore(realm, storage);
+                using var store = new RealmRulesetStore(realm, storage);
 
                 string? temp = TestResources.GetTestBeatmapForImport();
 
@@ -787,7 +787,7 @@ namespace osu.Game.Tests.Database
             RunTestWithRealmAsync(async (realm, storage) =>
             {
                 using var importer = new BeatmapModelManager(realm, storage);
-                using var store = new RulesetStore(realm, storage);
+                using var store = new RealmRulesetStore(realm, storage);
 
                 string? temp = TestResources.GetTestBeatmapForImport();
 
@@ -829,7 +829,7 @@ namespace osu.Game.Tests.Database
             RunTestWithRealmAsync(async (realm, storage) =>
             {
                 using var importer = new BeatmapModelManager(realm, storage);
-                using var store = new RulesetStore(realm, storage);
+                using var store = new RealmRulesetStore(realm, storage);
 
                 string? temp = TestResources.GetTestBeatmapForImport();
 
@@ -880,7 +880,7 @@ namespace osu.Game.Tests.Database
             RunTestWithRealmAsync(async (realm, storage) =>
             {
                 using var importer = new BeatmapModelManager(realm, storage);
-                using var store = new RulesetStore(realm, storage);
+                using var store = new RealmRulesetStore(realm, storage);
 
                 string? temp = TestResources.GetTestBeatmapForImport();
                 await importer.Import(temp);
diff --git a/osu.Game.Tests/Database/RulesetStoreTests.cs b/osu.Game.Tests/Database/RulesetStoreTests.cs
index 7544142b70..f48b5cba11 100644
--- a/osu.Game.Tests/Database/RulesetStoreTests.cs
+++ b/osu.Game.Tests/Database/RulesetStoreTests.cs
@@ -14,7 +14,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealm((realm, storage) =>
             {
-                var rulesets = new RulesetStore(realm, storage);
+                var rulesets = new RealmRulesetStore(realm, storage);
 
                 Assert.AreEqual(4, rulesets.AvailableRulesets.Count());
                 Assert.AreEqual(4, realm.Realm.All<RulesetInfo>().Count());
@@ -26,8 +26,8 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealm((realm, storage) =>
             {
-                var rulesets = new RulesetStore(realm, storage);
-                var rulesets2 = new RulesetStore(realm, storage);
+                var rulesets = new RealmRulesetStore(realm, storage);
+                var rulesets2 = new RealmRulesetStore(realm, storage);
 
                 Assert.AreEqual(4, rulesets.AvailableRulesets.Count());
                 Assert.AreEqual(4, rulesets2.AvailableRulesets.Count());
@@ -42,7 +42,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealm((realm, storage) =>
             {
-                var rulesets = new RulesetStore(realm, storage);
+                var rulesets = new RealmRulesetStore(realm, storage);
 
                 Assert.IsFalse(rulesets.AvailableRulesets.First().IsManaged);
                 Assert.IsFalse(rulesets.GetRuleset(0)?.IsManaged);
diff --git a/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs b/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
index 9aa04dda92..c4bffbc0ab 100644
--- a/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
+++ b/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
@@ -45,7 +45,7 @@ namespace osu.Game.Tests.Online
         [BackgroundDependencyLoader]
         private void load(AudioManager audio, GameHost host)
         {
-            Dependencies.Cache(rulesets = new RulesetStore(Realm));
+            Dependencies.Cache(rulesets = new RealmRulesetStore(Realm));
             Dependencies.CacheAs<BeatmapManager>(beatmaps = new TestBeatmapManager(LocalStorage, Realm, rulesets, API, audio, Resources, host, Beatmap.Default));
             Dependencies.CacheAs<BeatmapModelDownloader>(beatmapDownloader = new TestBeatmapModelDownloader(beatmaps, API));
         }
diff --git a/osu.Game.Tests/Visual/Background/TestSceneUserDimBackgrounds.cs b/osu.Game.Tests/Visual/Background/TestSceneUserDimBackgrounds.cs
index 40e7c0a844..9f708ace70 100644
--- a/osu.Game.Tests/Visual/Background/TestSceneUserDimBackgrounds.cs
+++ b/osu.Game.Tests/Visual/Background/TestSceneUserDimBackgrounds.cs
@@ -47,7 +47,7 @@ namespace osu.Game.Tests.Visual.Background
         [BackgroundDependencyLoader]
         private void load(GameHost host, AudioManager audio)
         {
-            Dependencies.Cache(rulesets = new RulesetStore(Realm));
+            Dependencies.Cache(rulesets = new RealmRulesetStore(Realm));
             Dependencies.Cache(manager = new BeatmapManager(LocalStorage, Realm, rulesets, null, audio, Resources, host, Beatmap.Default));
             Dependencies.Cache(new OsuConfigManager(LocalStorage));
             Dependencies.Cache(Realm);
diff --git a/osu.Game.Tests/Visual/Collections/TestSceneManageCollectionsDialog.cs b/osu.Game.Tests/Visual/Collections/TestSceneManageCollectionsDialog.cs
index d4c13059da..e40dd58663 100644
--- a/osu.Game.Tests/Visual/Collections/TestSceneManageCollectionsDialog.cs
+++ b/osu.Game.Tests/Visual/Collections/TestSceneManageCollectionsDialog.cs
@@ -36,7 +36,7 @@ namespace osu.Game.Tests.Visual.Collections
         [BackgroundDependencyLoader]
         private void load(GameHost host)
         {
-            Dependencies.Cache(rulesets = new RulesetStore(Realm));
+            Dependencies.Cache(rulesets = new RealmRulesetStore(Realm));
             Dependencies.Cache(beatmapManager = new BeatmapManager(LocalStorage, Realm, rulesets, null, Audio, Resources, host, Beatmap.Default));
             Dependencies.Cache(Realm);
 
diff --git a/osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs b/osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs
index 2a3b44d619..2c994576f3 100644
--- a/osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs
@@ -43,7 +43,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [BackgroundDependencyLoader]
         private void load(GameHost host, AudioManager audio)
         {
-            Dependencies.Cache(rulesets = new RulesetStore(Realm));
+            Dependencies.Cache(rulesets = new RealmRulesetStore(Realm));
             Dependencies.Cache(beatmaps = new BeatmapManager(LocalStorage, Realm, rulesets, null, audio, Resources, host, Beatmap.Default));
             Dependencies.Cache(Realm);
         }
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
index 8c10a0d0d9..4dc7dc1c42 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
@@ -40,7 +40,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [BackgroundDependencyLoader]
         private void load(GameHost host, AudioManager audio)
         {
-            Dependencies.Cache(rulesets = new RulesetStore(Realm));
+            Dependencies.Cache(rulesets = new RealmRulesetStore(Realm));
             Dependencies.Cache(manager = new BeatmapManager(LocalStorage, Realm, rulesets, null, audio, Resources, host, Beatmap.Default));
             Dependencies.Cache(Realm);
         }
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
index 3f9aec3a42..fc8c3f7f58 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
@@ -58,7 +58,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [BackgroundDependencyLoader]
         private void load(GameHost host, AudioManager audio)
         {
-            Dependencies.Cache(rulesets = new RulesetStore(Realm));
+            Dependencies.Cache(rulesets = new RealmRulesetStore(Realm));
             Dependencies.Cache(beatmaps = new BeatmapManager(LocalStorage, Realm, rulesets, API, audio, Resources, host, Beatmap.Default));
             Dependencies.Cache(Realm);
         }
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs
index 457b53ae61..381b9b58bd 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs
@@ -42,7 +42,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [BackgroundDependencyLoader]
         private void load(GameHost host, AudioManager audio)
         {
-            Dependencies.Cache(rulesets = new RulesetStore(Realm));
+            Dependencies.Cache(rulesets = new RealmRulesetStore(Realm));
             Dependencies.Cache(manager = new BeatmapManager(LocalStorage, Realm, rulesets, null, audio, Resources, host, Beatmap.Default));
             Dependencies.Cache(Realm);
 
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs
index 7d2ef8276d..1eebe781f1 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs
@@ -46,7 +46,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [BackgroundDependencyLoader]
         private void load(GameHost host, AudioManager audio)
         {
-            Dependencies.Cache(rulesets = new RulesetStore(Realm));
+            Dependencies.Cache(rulesets = new RealmRulesetStore(Realm));
             Dependencies.Cache(beatmaps = new BeatmapManager(LocalStorage, Realm, rulesets, null, audio, Resources, host, Beatmap.Default));
             Dependencies.Cache(Realm);
 
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs
index f84abc7443..af12046d76 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs
@@ -33,7 +33,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [BackgroundDependencyLoader]
         private void load(GameHost host, AudioManager audio)
         {
-            Dependencies.Cache(rulesets = new RulesetStore(Realm));
+            Dependencies.Cache(rulesets = new RealmRulesetStore(Realm));
             Dependencies.Cache(beatmaps = new BeatmapManager(LocalStorage, Realm, rulesets, null, audio, Resources, host, Beatmap.Default));
             Dependencies.Cache(Realm);
         }
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs
index bf06b6ad73..397c2d16d1 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs
@@ -34,7 +34,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [BackgroundDependencyLoader]
         private void load(GameHost host, AudioManager audio)
         {
-            Dependencies.Cache(rulesets = new RulesetStore(Realm));
+            Dependencies.Cache(rulesets = new RealmRulesetStore(Realm));
             Dependencies.Cache(beatmaps = new BeatmapManager(LocalStorage, Realm, rulesets, API, audio, Resources, host, Beatmap.Default));
             Dependencies.Cache(Realm);
         }
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs
index 609693e54b..6851dba721 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs
@@ -40,7 +40,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [BackgroundDependencyLoader]
         private void load(GameHost host, AudioManager audio)
         {
-            Dependencies.Cache(rulesets = new RulesetStore(Realm));
+            Dependencies.Cache(rulesets = new RealmRulesetStore(Realm));
             Dependencies.Cache(beatmaps = new BeatmapManager(LocalStorage, Realm, rulesets, null, audio, Resources, host, Beatmap.Default));
             Dependencies.Cache(Realm);
 
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerSpectateButton.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerSpectateButton.cs
index c4ea78116a..0033a4ca74 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerSpectateButton.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerSpectateButton.cs
@@ -41,7 +41,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [BackgroundDependencyLoader]
         private void load(GameHost host, AudioManager audio)
         {
-            Dependencies.Cache(rulesets = new RulesetStore(Realm));
+            Dependencies.Cache(rulesets = new RealmRulesetStore(Realm));
             Dependencies.Cache(beatmaps = new BeatmapManager(LocalStorage, Realm, rulesets, null, audio, Resources, host, Beatmap.Default));
             Dependencies.Cache(Realm);
 
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsSongSelect.cs b/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsSongSelect.cs
index 3333afc88b..f8d62c9840 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsSongSelect.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsSongSelect.cs
@@ -33,7 +33,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [BackgroundDependencyLoader]
         private void load(GameHost host, AudioManager audio)
         {
-            Dependencies.Cache(rulesets = new RulesetStore(Realm));
+            Dependencies.Cache(rulesets = new RealmRulesetStore(Realm));
             Dependencies.Cache(manager = new BeatmapManager(LocalStorage, Realm, rulesets, null, audio, Resources, host, Beatmap.Default));
             Dependencies.Cache(Realm);
 
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs
index 50b3f52047..05b97e333f 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs
@@ -38,7 +38,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [BackgroundDependencyLoader]
         private void load(GameHost host, AudioManager audio)
         {
-            Dependencies.Cache(rulesets = new RulesetStore(Realm));
+            Dependencies.Cache(rulesets = new RealmRulesetStore(Realm));
             Dependencies.Cache(beatmaps = new BeatmapManager(LocalStorage, Realm, rulesets, null, audio, Resources, host, Beatmap.Default));
             Dependencies.Cache(Realm);
         }
diff --git a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs
index 578ea63b4e..a6f1762cb3 100644
--- a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs
+++ b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs
@@ -39,7 +39,7 @@ namespace osu.Game.Tests.Visual.Playlists
         [BackgroundDependencyLoader]
         private void load(GameHost host, AudioManager audio)
         {
-            Dependencies.Cache(rulesets = new RulesetStore(Realm));
+            Dependencies.Cache(rulesets = new RealmRulesetStore(Realm));
             Dependencies.Cache(manager = new BeatmapManager(LocalStorage, Realm, rulesets, API, audio, Resources, host, Beatmap.Default));
             Dependencies.Cache(Realm);
         }
diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
index 667fd08084..8c3cc02c83 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
@@ -43,7 +43,7 @@ namespace osu.Game.Tests.Visual.SongSelect
         {
             var dependencies = new DependencyContainer(base.CreateChildDependencies(parent));
 
-            dependencies.Cache(rulesetStore = new RulesetStore(Realm));
+            dependencies.Cache(rulesetStore = new RealmRulesetStore(Realm));
             dependencies.Cache(beatmapManager = new BeatmapManager(LocalStorage, Realm, rulesetStore, null, dependencies.Get<AudioManager>(), Resources, dependencies.Get<GameHost>(), Beatmap.Default));
             dependencies.Cache(scoreManager = new ScoreManager(rulesetStore, () => beatmapManager, LocalStorage, Realm, Scheduler));
             Dependencies.Cache(Realm);
diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneFilterControl.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneFilterControl.cs
index b384061531..b7ec128596 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneFilterControl.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneFilterControl.cs
@@ -36,7 +36,7 @@ namespace osu.Game.Tests.Visual.SongSelect
         [BackgroundDependencyLoader]
         private void load(GameHost host)
         {
-            Dependencies.Cache(rulesets = new RulesetStore(Realm));
+            Dependencies.Cache(rulesets = new RealmRulesetStore(Realm));
             Dependencies.Cache(beatmapManager = new BeatmapManager(LocalStorage, Realm, rulesets, null, Audio, Resources, host, Beatmap.Default));
             Dependencies.Cache(Realm);
 
diff --git a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
index d34aff8a23..e2b50e38c2 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
@@ -47,7 +47,7 @@ namespace osu.Game.Tests.Visual.SongSelect
         {
             // These DI caches are required to ensure for interactive runs this test scene doesn't nuke all user beatmaps in the local install.
             // At a point we have isolated interactive test runs enough, this can likely be removed.
-            Dependencies.Cache(rulesets = new RulesetStore(Realm));
+            Dependencies.Cache(rulesets = new RealmRulesetStore(Realm));
             Dependencies.Cache(Realm);
             Dependencies.Cache(manager = new BeatmapManager(LocalStorage, Realm, rulesets, null, audio, Resources, host, defaultBeatmap = Beatmap.Default));
 
diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneTopLocalRank.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneTopLocalRank.cs
index 8e5f76a2eb..39680d157b 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneTopLocalRank.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneTopLocalRank.cs
@@ -28,7 +28,7 @@ namespace osu.Game.Tests.Visual.SongSelect
         [BackgroundDependencyLoader]
         private void load(GameHost host, AudioManager audio)
         {
-            Dependencies.Cache(rulesets = new RulesetStore(Realm));
+            Dependencies.Cache(rulesets = new RealmRulesetStore(Realm));
             Dependencies.Cache(beatmapManager = new BeatmapManager(LocalStorage, Realm, rulesets, null, audio, Resources, host, Beatmap.Default));
             Dependencies.Cache(scoreManager = new ScoreManager(rulesets, () => beatmapManager, LocalStorage, Realm, Scheduler));
             Dependencies.Cache(Realm);
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
index da4cf9c6e3..a0a1feff36 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
@@ -87,7 +87,7 @@ namespace osu.Game.Tests.Visual.UserInterface
         {
             var dependencies = new DependencyContainer(base.CreateChildDependencies(parent));
 
-            dependencies.Cache(rulesetStore = new RulesetStore(Realm));
+            dependencies.Cache(rulesetStore = new RealmRulesetStore(Realm));
             dependencies.Cache(beatmapManager = new BeatmapManager(LocalStorage, Realm, rulesetStore, null, dependencies.Get<AudioManager>(), Resources, dependencies.Get<GameHost>(), Beatmap.Default));
             dependencies.Cache(scoreManager = new ScoreManager(dependencies.Get<RulesetStore>(), () => beatmapManager, LocalStorage, Realm, Scheduler));
             Dependencies.Cache(Realm);

From 13086541f0884a4baec68afd1ee874830d6c366f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 16 Feb 2022 17:12:57 +0900
Subject: [PATCH 2946/5547] Add static `RulesetStore` to `LegacyBeatmapDecoder`

---
 osu.Game/Beatmaps/Formats/Decoder.cs              | 10 ++++++++++
 osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs |  9 ++++++++-
 2 files changed, 18 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Beatmaps/Formats/Decoder.cs b/osu.Game/Beatmaps/Formats/Decoder.cs
index 845ac20db0..8eb238a184 100644
--- a/osu.Game/Beatmaps/Formats/Decoder.cs
+++ b/osu.Game/Beatmaps/Formats/Decoder.cs
@@ -6,6 +6,7 @@ using System.Collections.Generic;
 using System.IO;
 using System.Linq;
 using osu.Game.IO;
+using osu.Game.Rulesets;
 
 namespace osu.Game.Beatmaps.Formats
 {
@@ -37,6 +38,15 @@ namespace osu.Game.Beatmaps.Formats
             LegacyStoryboardDecoder.Register();
         }
 
+        /// <summary>
+        /// Register dependencies for use with static decoder classes.
+        /// </summary>
+        /// <param name="rulesets">A store containing all available rulesets (used by <see cref="LegacyBeatmapDecoder"/>).</param>
+        public static void RegisterDependencies(RulesetStore rulesets)
+        {
+            LegacyBeatmapDecoder.RulesetStore = rulesets;
+        }
+
         /// <summary>
         /// Retrieves a <see cref="Decoder"/> to parse a <see cref="Beatmap"/>.
         /// </summary>
diff --git a/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs b/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
index 07ada8ecc4..fb7882c182 100644
--- a/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
+++ b/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
@@ -3,6 +3,7 @@
 
 using System;
 using System.Collections.Generic;
+using System.Data;
 using System.IO;
 using System.Linq;
 using osu.Framework.Extensions;
@@ -11,12 +12,15 @@ using osu.Game.Beatmaps.ControlPoints;
 using osu.Game.Beatmaps.Legacy;
 using osu.Game.Beatmaps.Timing;
 using osu.Game.IO;
+using osu.Game.Rulesets;
 using osu.Game.Rulesets.Objects.Legacy;
 
 namespace osu.Game.Beatmaps.Formats
 {
     public class LegacyBeatmapDecoder : LegacyDecoder<Beatmap>
     {
+        protected internal static RulesetStore RulesetStore;
+
         private Beatmap beatmap;
 
         private ConvertHitObjectParser parser;
@@ -40,6 +44,9 @@ namespace osu.Game.Beatmaps.Formats
         public LegacyBeatmapDecoder(int version = LATEST_VERSION)
             : base(version)
         {
+            if (RulesetStore == null)
+                throw new InvalidOperationException($"Call {nameof(Decoder)}.{nameof(RegisterDependencies)} before using {nameof(LegacyBeatmapDecoder)}.");
+
             // BeatmapVersion 4 and lower had an incorrect offset (stable has this set as 24ms off)
             offset = FormatVersion < 5 ? 24 : 0;
         }
@@ -158,7 +165,7 @@ namespace osu.Game.Beatmaps.Formats
                 case @"Mode":
                     int rulesetID = Parsing.ParseInt(pair.Value);
 
-                    beatmap.BeatmapInfo.RulesetID = rulesetID;
+                    beatmap.BeatmapInfo.Ruleset = RulesetStore.GetRuleset(rulesetID) ?? throw new ArgumentException("Ruleset is not available locally.");
 
                     switch (rulesetID)
                     {

From d0efecfc9cff723d92a7e9289842737152e6dc61 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 16 Feb 2022 17:13:25 +0900
Subject: [PATCH 2947/5547] Add `RulesetStore` for use where realm is not
 present (ie. other projects)

---
 osu.Game/Rulesets/AssemblyRulesetStore.cs | 35 +++++++++++++++++++++++
 1 file changed, 35 insertions(+)
 create mode 100644 osu.Game/Rulesets/AssemblyRulesetStore.cs

diff --git a/osu.Game/Rulesets/AssemblyRulesetStore.cs b/osu.Game/Rulesets/AssemblyRulesetStore.cs
new file mode 100644
index 0000000000..b7378ccf61
--- /dev/null
+++ b/osu.Game/Rulesets/AssemblyRulesetStore.cs
@@ -0,0 +1,35 @@
+// 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.Extensions.ObjectExtensions;
+using osu.Framework.Platform;
+
+#nullable enable
+
+namespace osu.Game.Rulesets
+{
+    public class AssemblyRulesetStore : RulesetStore
+    {
+        public override IEnumerable<RulesetInfo> AvailableRulesets => availableRulesets;
+
+        private readonly List<RulesetInfo> availableRulesets = new List<RulesetInfo>();
+
+        public AssemblyRulesetStore(Storage? storage = null)
+            : base(storage)
+
+        {
+            List<Ruleset> instances = LoadedAssemblies.Values
+                                                      .Select(r => Activator.CreateInstance(r) as Ruleset)
+                                                      .Where(r => r != null)
+                                                      .Select(r => r.AsNonNull())
+                                                      .ToList();
+
+            // add all legacy rulesets first to ensure they have exclusive choice of primary key.
+            foreach (var r in instances.Where(r => r is ILegacyRuleset))
+                availableRulesets.Add(new RulesetInfo(r.RulesetInfo.ShortName, r.RulesetInfo.Name, r.RulesetInfo.InstantiationInfo, r.RulesetInfo.OnlineID));
+        }
+    }
+}

From 5477af08c5d972988df03b7834ff5ff0f039a9cf Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 16 Feb 2022 17:21:06 +0900
Subject: [PATCH 2948/5547] Register an `AssemblyRulesetStore` in tests which
 don't use `OsuGameBase`

---
 osu.Game.Benchmarks/BenchmarkBeatmapParsing.cs             | 3 +++
 osu.Game.Rulesets.Osu.Tests/StackingTest.cs                | 6 ++++++
 .../Beatmaps/Formats/LegacyBeatmapDecoderTest.cs           | 7 +++++++
 osu.Game.Tests/Beatmaps/Formats/OsuJsonDecoderTest.cs      | 7 +++++++
 osu.Game.Tests/Beatmaps/IO/OszArchiveReaderTest.cs         | 7 +++++++
 osu.Game.Tests/Editing/LegacyEditorBeatmapPatcherTest.cs   | 3 +++
 osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs          | 1 -
 osu.Game/Tests/Beatmaps/BeatmapConversionTest.cs           | 6 ++++++
 osu.Game/Tests/Beatmaps/DifficultyCalculatorTest.cs        | 6 ++++++
 9 files changed, 45 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Benchmarks/BenchmarkBeatmapParsing.cs b/osu.Game.Benchmarks/BenchmarkBeatmapParsing.cs
index 1d207d04c7..0dd66be0b4 100644
--- a/osu.Game.Benchmarks/BenchmarkBeatmapParsing.cs
+++ b/osu.Game.Benchmarks/BenchmarkBeatmapParsing.cs
@@ -8,6 +8,7 @@ using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.Formats;
 using osu.Game.IO;
 using osu.Game.IO.Archives;
+using osu.Game.Rulesets;
 using osu.Game.Tests.Resources;
 
 namespace osu.Game.Benchmarks
@@ -18,6 +19,8 @@ namespace osu.Game.Benchmarks
 
         public override void SetUp()
         {
+            Decoder.RegisterDependencies(new AssemblyRulesetStore());
+
             using (var resources = new DllResourceStore(typeof(TestResources).Assembly))
             using (var archive = resources.GetStream("Resources/Archives/241526 Soleily - Renatus.osz"))
             using (var reader = new ZipArchiveReader(archive))
diff --git a/osu.Game.Rulesets.Osu.Tests/StackingTest.cs b/osu.Game.Rulesets.Osu.Tests/StackingTest.cs
index 871afdb09d..927c0c3e1e 100644
--- a/osu.Game.Rulesets.Osu.Tests/StackingTest.cs
+++ b/osu.Game.Rulesets.Osu.Tests/StackingTest.cs
@@ -18,6 +18,12 @@ namespace osu.Game.Rulesets.Osu.Tests
     [TestFixture]
     public class StackingTest
     {
+        [SetUp]
+        public void SetUp()
+        {
+            Decoder.RegisterDependencies(new AssemblyRulesetStore());
+        }
+
         [Test]
         public void TestStacking()
         {
diff --git a/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs b/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs
index 468cb7683c..ad088d298b 100644
--- a/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs
+++ b/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs
@@ -11,6 +11,7 @@ using osu.Game.Beatmaps.Formats;
 using osu.Game.Beatmaps.Legacy;
 using osu.Game.Beatmaps.Timing;
 using osu.Game.IO;
+using osu.Game.Rulesets;
 using osu.Game.Rulesets.Catch;
 using osu.Game.Rulesets.Catch.Beatmaps;
 using osu.Game.Rulesets.Mods;
@@ -29,6 +30,12 @@ namespace osu.Game.Tests.Beatmaps.Formats
     [TestFixture]
     public class LegacyBeatmapDecoderTest
     {
+        [SetUp]
+        public void SetUp()
+        {
+            Decoder.RegisterDependencies(new AssemblyRulesetStore());
+        }
+
         [Test]
         public void TestDecodeBeatmapVersion()
         {
diff --git a/osu.Game.Tests/Beatmaps/Formats/OsuJsonDecoderTest.cs b/osu.Game.Tests/Beatmaps/Formats/OsuJsonDecoderTest.cs
index 2eb75259d9..b7989adcb8 100644
--- a/osu.Game.Tests/Beatmaps/Formats/OsuJsonDecoderTest.cs
+++ b/osu.Game.Tests/Beatmaps/Formats/OsuJsonDecoderTest.cs
@@ -10,6 +10,7 @@ using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.Formats;
 using osu.Game.IO;
 using osu.Game.IO.Serialization;
+using osu.Game.Rulesets;
 using osu.Game.Rulesets.Objects.Types;
 using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Osu.Beatmaps;
@@ -22,6 +23,12 @@ namespace osu.Game.Tests.Beatmaps.Formats
     [TestFixture]
     public class OsuJsonDecoderTest
     {
+        [SetUp]
+        public void SetUp()
+        {
+            Decoder.RegisterDependencies(new AssemblyRulesetStore());
+        }
+
         private const string normal = "Soleily - Renatus (Gamu) [Insane].osu";
         private const string marathon = "Within Temptation - The Unforgiving (Armin) [Marathon].osu";
         private const string with_sb = "Kozato snow - Rengetsu Ouka (_Kiva) [Yuki YukI].osu";
diff --git a/osu.Game.Tests/Beatmaps/IO/OszArchiveReaderTest.cs b/osu.Game.Tests/Beatmaps/IO/OszArchiveReaderTest.cs
index 810ea5dbd0..64a52b2b01 100644
--- a/osu.Game.Tests/Beatmaps/IO/OszArchiveReaderTest.cs
+++ b/osu.Game.Tests/Beatmaps/IO/OszArchiveReaderTest.cs
@@ -9,12 +9,19 @@ using osu.Game.Tests.Resources;
 using osu.Game.Beatmaps.Formats;
 using osu.Game.IO;
 using osu.Game.IO.Archives;
+using osu.Game.Rulesets;
 
 namespace osu.Game.Tests.Beatmaps.IO
 {
     [TestFixture]
     public class OszArchiveReaderTest
     {
+        [SetUp]
+        public void SetUp()
+        {
+            Decoder.RegisterDependencies(new AssemblyRulesetStore());
+        }
+
         [Test]
         public void TestReadBeatmaps()
         {
diff --git a/osu.Game.Tests/Editing/LegacyEditorBeatmapPatcherTest.cs b/osu.Game.Tests/Editing/LegacyEditorBeatmapPatcherTest.cs
index 44a908b756..6cf760723a 100644
--- a/osu.Game.Tests/Editing/LegacyEditorBeatmapPatcherTest.cs
+++ b/osu.Game.Tests/Editing/LegacyEditorBeatmapPatcherTest.cs
@@ -8,6 +8,7 @@ using osu.Game.Audio;
 using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.Formats;
 using osu.Game.IO;
+using osu.Game.Rulesets;
 using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Objects.Types;
 using osu.Game.Rulesets.Osu;
@@ -28,6 +29,8 @@ namespace osu.Game.Tests.Editing
         [SetUp]
         public void Setup()
         {
+            Decoder.RegisterDependencies(new AssemblyRulesetStore());
+
             patcher = new LegacyEditorBeatmapPatcher(current = new EditorBeatmap(new OsuBeatmap
             {
                 BeatmapInfo =
diff --git a/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs b/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
index fb7882c182..9626f39ec3 100644
--- a/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
+++ b/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
@@ -3,7 +3,6 @@
 
 using System;
 using System.Collections.Generic;
-using System.Data;
 using System.IO;
 using System.Linq;
 using osu.Framework.Extensions;
diff --git a/osu.Game/Tests/Beatmaps/BeatmapConversionTest.cs b/osu.Game/Tests/Beatmaps/BeatmapConversionTest.cs
index 8d622955b7..d5b7e3152b 100644
--- a/osu.Game/Tests/Beatmaps/BeatmapConversionTest.cs
+++ b/osu.Game/Tests/Beatmaps/BeatmapConversionTest.cs
@@ -34,6 +34,12 @@ namespace osu.Game.Tests.Beatmaps
 
         protected abstract string ResourceAssembly { get; }
 
+        [SetUp]
+        public void Setup()
+        {
+            Decoder.RegisterDependencies(new AssemblyRulesetStore());
+        }
+
         protected void Test(string name, params Type[] mods)
         {
             var ourResult = convert(name, mods.Select(m => (Mod)Activator.CreateInstance(m)).ToArray());
diff --git a/osu.Game/Tests/Beatmaps/DifficultyCalculatorTest.cs b/osu.Game/Tests/Beatmaps/DifficultyCalculatorTest.cs
index 9f8811c7f9..78b2558640 100644
--- a/osu.Game/Tests/Beatmaps/DifficultyCalculatorTest.cs
+++ b/osu.Game/Tests/Beatmaps/DifficultyCalculatorTest.cs
@@ -22,6 +22,12 @@ namespace osu.Game.Tests.Beatmaps
 
         protected abstract string ResourceAssembly { get; }
 
+        [SetUp]
+        public void Setup()
+        {
+            Decoder.RegisterDependencies(new AssemblyRulesetStore());
+        }
+
         protected void Test(double expected, string name, params Mod[] mods)
         {
             // Platform-dependent math functions (Pow, Cbrt, Exp, etc) may result in minute differences.

From 5ffd3ff82acbf76acc91accf666b76ab1255b3e1 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 16 Feb 2022 17:25:16 +0900
Subject: [PATCH 2949/5547] Add xmldoc and allow constructing an
 `AssemblyRulesetStore` with a directory path

---
 osu.Game/Rulesets/AssemblyRulesetStore.cs | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/osu.Game/Rulesets/AssemblyRulesetStore.cs b/osu.Game/Rulesets/AssemblyRulesetStore.cs
index b7378ccf61..7313a77aa5 100644
--- a/osu.Game/Rulesets/AssemblyRulesetStore.cs
+++ b/osu.Game/Rulesets/AssemblyRulesetStore.cs
@@ -11,12 +11,28 @@ using osu.Framework.Platform;
 
 namespace osu.Game.Rulesets
 {
+    /// <summary>
+    /// A ruleset store that populates from loaded assemblies (and optionally, assemblies in a storage).
+    /// </summary>
     public class AssemblyRulesetStore : RulesetStore
     {
         public override IEnumerable<RulesetInfo> AvailableRulesets => availableRulesets;
 
         private readonly List<RulesetInfo> availableRulesets = new List<RulesetInfo>();
 
+        /// <summary>
+        /// Create an assembly ruleset store that populates from loaded assemblies and an external location.
+        /// </summary>
+        /// <param name="path">An path containing ruleset DLLs.</param>
+        public AssemblyRulesetStore(string path)
+            : this(new NativeStorage(path))
+        {
+        }
+
+        /// <summary>
+        /// Create an assembly ruleset store that populates from loaded assemblies and an optional storage source.
+        /// </summary>
+        /// <param name="storage">An optional storage containing ruleset DLLs.</param>
         public AssemblyRulesetStore(Storage? storage = null)
             : base(storage)
 

From 23933fc881f07c2cc96b10589531387e6b2658bc Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 16 Feb 2022 17:32:22 +0900
Subject: [PATCH 2950/5547] Update xmldoc to mention that multipliers are not
 applied anywhere

---
 osu.Game/Rulesets/Mods/Mod.cs | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Rulesets/Mods/Mod.cs b/osu.Game/Rulesets/Mods/Mod.cs
index 5555770822..9a45e2458d 100644
--- a/osu.Game/Rulesets/Mods/Mod.cs
+++ b/osu.Game/Rulesets/Mods/Mod.cs
@@ -80,8 +80,11 @@ namespace osu.Game.Rulesets.Mods
         }
 
         /// <summary>
-        /// The score multiplier of this mod.
+        /// The (legacy) score multiplier of this mod.
         /// </summary>
+        /// <remarks>
+        /// This is not applied for newly set scores, but may be required for display purposes when showing legacy scores.
+        /// </remarks>
         [JsonIgnore]
         public virtual double ScoreMultiplier => 1;
 

From 28fcad92810097c4e4fb0cce0757bea2ec43d7b5 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 16 Feb 2022 17:33:55 +0900
Subject: [PATCH 2951/5547] Update failing test to not account for
 no-longer-existing multiplier

---
 osu.Game.Rulesets.Osu.Tests/TestSceneSpinnerRotation.cs | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/osu.Game.Rulesets.Osu.Tests/TestSceneSpinnerRotation.cs b/osu.Game.Rulesets.Osu.Tests/TestSceneSpinnerRotation.cs
index de795241bf..0b9db8e20a 100644
--- a/osu.Game.Rulesets.Osu.Tests/TestSceneSpinnerRotation.cs
+++ b/osu.Game.Rulesets.Osu.Tests/TestSceneSpinnerRotation.cs
@@ -147,8 +147,7 @@ namespace osu.Game.Rulesets.Osu.Tests
 
             AddAssert("player score matching expected bonus score", () =>
             {
-                // multipled by 2 to nullify the score multiplier. (autoplay mod selected)
-                double totalScore = ((ScoreExposedPlayer)Player).ScoreProcessor.TotalScore.Value * 2;
+                double totalScore = ((ScoreExposedPlayer)Player).ScoreProcessor.TotalScore.Value;
                 return totalScore == (int)(drawableSpinner.Result.RateAdjustedRotation / 360) * new SpinnerTick().CreateJudgement().MaxNumericResult;
             });
 

From a0ee86ddd2761e0e901235939bed9e3f6d4f1334 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 16 Feb 2022 19:50:27 +0900
Subject: [PATCH 2952/5547] Fix improperly considering rate adjustment mods

---
 .../Difficulty/ManiaDifficultyAttributes.cs         |  4 ++--
 .../Difficulty/ManiaDifficultyCalculator.cs         | 13 ++++---------
 2 files changed, 6 insertions(+), 11 deletions(-)

diff --git a/osu.Game.Rulesets.Mania/Difficulty/ManiaDifficultyAttributes.cs b/osu.Game.Rulesets.Mania/Difficulty/ManiaDifficultyAttributes.cs
index efd5868504..5b7a460079 100644
--- a/osu.Game.Rulesets.Mania/Difficulty/ManiaDifficultyAttributes.cs
+++ b/osu.Game.Rulesets.Mania/Difficulty/ManiaDifficultyAttributes.cs
@@ -10,10 +10,10 @@ namespace osu.Game.Rulesets.Mania.Difficulty
     public class ManiaDifficultyAttributes : DifficultyAttributes
     {
         /// <summary>
-        /// The perceived hit window for a GREAT hit inclusive of rate-adjusting mods (DT/HT/etc).
+        /// The hit window for a GREAT hit inclusive of rate-adjusting mods (DT/HT/etc).
         /// </summary>
         /// <remarks>
-        /// Rate-adjusting mods don't directly affect the hit window, but have a perceived effect as a result of adjusting audio timing.
+        /// Rate-adjusting mods do not affect the hit window at all in osu-stable.
         /// </remarks>
         [JsonProperty("great_hit_window")]
         public double GreatHitWindow { get; set; }
diff --git a/osu.Game.Rulesets.Mania/Difficulty/ManiaDifficultyCalculator.cs b/osu.Game.Rulesets.Mania/Difficulty/ManiaDifficultyCalculator.cs
index 1f82eb7ccd..d200daa7fa 100644
--- a/osu.Game.Rulesets.Mania/Difficulty/ManiaDifficultyCalculator.cs
+++ b/osu.Game.Rulesets.Mania/Difficulty/ManiaDifficultyCalculator.cs
@@ -48,7 +48,7 @@ namespace osu.Game.Rulesets.Mania.Difficulty
             {
                 StarRating = skills[0].DifficultyValue() * star_scaling_factor,
                 Mods = mods,
-                GreatHitWindow = Math.Ceiling(getHitWindow300(mods) / clockRate),
+                GreatHitWindow = Math.Ceiling((int)(getHitWindow300(mods) * clockRate) / clockRate),
                 ScoreMultiplier = getScoreMultiplier(mods),
                 MaxCombo = beatmap.HitObjects.Sum(h => h is HoldNote ? 2 : 1),
             };
@@ -108,7 +108,7 @@ namespace osu.Game.Rulesets.Mania.Difficulty
             }
         }
 
-        private int getHitWindow300(Mod[] mods)
+        private double getHitWindow300(Mod[] mods)
         {
             if (isForCurrentRuleset)
             {
@@ -121,19 +121,14 @@ namespace osu.Game.Rulesets.Mania.Difficulty
 
             return applyModAdjustments(47, mods);
 
-            static int applyModAdjustments(double value, Mod[] mods)
+            static double applyModAdjustments(double value, Mod[] mods)
             {
                 if (mods.Any(m => m is ManiaModHardRock))
                     value /= 1.4;
                 else if (mods.Any(m => m is ManiaModEasy))
                     value *= 1.4;
 
-                if (mods.Any(m => m is ManiaModDoubleTime))
-                    value *= 1.5;
-                else if (mods.Any(m => m is ManiaModHalfTime))
-                    value *= 0.75;
-
-                return (int)value;
+                return value;
             }
         }
 

From 0b37efc9850f57a6ddf456b0e68fc879a536a2e0 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 16 Feb 2022 20:07:26 +0900
Subject: [PATCH 2953/5547] Add explanatory note

---
 osu.Game.Rulesets.Mania/Difficulty/ManiaDifficultyCalculator.cs | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/osu.Game.Rulesets.Mania/Difficulty/ManiaDifficultyCalculator.cs b/osu.Game.Rulesets.Mania/Difficulty/ManiaDifficultyCalculator.cs
index d200daa7fa..b17aa7fc4d 100644
--- a/osu.Game.Rulesets.Mania/Difficulty/ManiaDifficultyCalculator.cs
+++ b/osu.Game.Rulesets.Mania/Difficulty/ManiaDifficultyCalculator.cs
@@ -48,6 +48,8 @@ namespace osu.Game.Rulesets.Mania.Difficulty
             {
                 StarRating = skills[0].DifficultyValue() * star_scaling_factor,
                 Mods = mods,
+                // In osu-stable mania, rate-adjustment mods don't affect the hit window.
+                // This is done the way it is to introduce fractional differences in order to match osu-stable for the time being.
                 GreatHitWindow = Math.Ceiling((int)(getHitWindow300(mods) * clockRate) / clockRate),
                 ScoreMultiplier = getScoreMultiplier(mods),
                 MaxCombo = beatmap.HitObjects.Sum(h => h is HoldNote ? 2 : 1),

From c124034cf3f671cc44b950851bb6a2f3900524cc Mon Sep 17 00:00:00 2001
From: dekrain <dawidkrainski8@gmail.com>
Date: Wed, 16 Feb 2022 23:18:14 +0100
Subject: [PATCH 2954/5547] Add text displaying recent score time

---
 .../Online/Leaderboards/LeaderboardScore.cs   | 43 ++++++++++++++++++-
 1 file changed, 42 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Online/Leaderboards/LeaderboardScore.cs b/osu.Game/Online/Leaderboards/LeaderboardScore.cs
index c2393a5de5..f77982535d 100644
--- a/osu.Game/Online/Leaderboards/LeaderboardScore.cs
+++ b/osu.Game/Online/Leaderboards/LeaderboardScore.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.Framework.Allocation;
@@ -29,6 +30,7 @@ using osuTK;
 using osuTK.Graphics;
 using osu.Game.Online.API;
 using osu.Game.Utils;
+using osu.Game.Resources.Localisation.Web;
 
 namespace osu.Game.Online.Leaderboards
 {
@@ -42,6 +44,7 @@ namespace osu.Game.Online.Leaderboards
         private const float edge_margin = 5;
         private const float background_alpha = 0.25f;
         private const float rank_width = 35;
+        private const float date_width = 35;
 
         protected Container RankContainer { get; private set; }
 
@@ -100,10 +103,18 @@ namespace osu.Game.Online.Leaderboards
                     RelativeSizeAxes = Axes.Y,
                     Width = rank_width,
                 },
+                new Container
+                {
+                    Anchor = Anchor.TopRight,
+                    Origin = Anchor.TopRight,
+                    RelativeSizeAxes = Axes.Y,
+                    Width = date_width,
+                    Child = new DateLabel(Score.Date),
+                },
                 content = new Container
                 {
                     RelativeSizeAxes = Axes.Both,
-                    Padding = new MarginPadding { Left = rank_width, },
+                    Padding = new MarginPadding { Left = rank_width, Right = date_width, },
                     Children = new Drawable[]
                     {
                         new Container
@@ -377,6 +388,36 @@ namespace osu.Game.Online.Leaderboards
             public LocalisableString TooltipText { get; }
         }
 
+        private class DateLabel : DrawableDate
+        {
+            public DateLabel(DateTimeOffset date)
+                : base(date, 20)
+            {
+                Anchor = Anchor.Centre;
+                Origin = Anchor.Centre;
+            }
+
+            protected override string Format()
+            {
+                var now = DateTime.Now;
+                var difference = now - Date;
+
+                // TODO(optional): support localisation (probably via `CommonStrings.CountHours()` etc.)
+                // requires pluralisable string support framework-side
+
+                if (difference.TotalMinutes < 1)
+                    return CommonStrings.TimeNow.ToString();
+                if (difference.TotalHours < 1)
+                    return $@"{Math.Ceiling(difference.TotalMinutes)}min";
+                if (difference.TotalDays < 1)
+                    return $@"{Math.Ceiling(difference.TotalHours)}h";
+                if (difference.TotalDays < 7)
+                    return $@"{Math.Ceiling(difference.TotalDays)}d";
+
+                return string.Empty;
+            }
+        }
+
         public class LeaderboardScoreStatistic
         {
             public IconUsage Icon;

From 333a305af3dcabba5591b17140be49ba4c5c14f3 Mon Sep 17 00:00:00 2001
From: dekrain <dawidkrainski8@gmail.com>
Date: Thu, 17 Feb 2022 00:09:17 +0100
Subject: [PATCH 2955/5547] Use floor instead of ceiling

---
 osu.Game/Online/Leaderboards/LeaderboardScore.cs | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Online/Leaderboards/LeaderboardScore.cs b/osu.Game/Online/Leaderboards/LeaderboardScore.cs
index f77982535d..9ac1ab8075 100644
--- a/osu.Game/Online/Leaderboards/LeaderboardScore.cs
+++ b/osu.Game/Online/Leaderboards/LeaderboardScore.cs
@@ -408,11 +408,11 @@ namespace osu.Game.Online.Leaderboards
                 if (difference.TotalMinutes < 1)
                     return CommonStrings.TimeNow.ToString();
                 if (difference.TotalHours < 1)
-                    return $@"{Math.Ceiling(difference.TotalMinutes)}min";
+                    return $@"{Math.Floor(difference.TotalMinutes)}min";
                 if (difference.TotalDays < 1)
-                    return $@"{Math.Ceiling(difference.TotalHours)}h";
+                    return $@"{Math.Floor(difference.TotalHours)}h";
                 if (difference.TotalDays < 7)
-                    return $@"{Math.Ceiling(difference.TotalDays)}d";
+                    return $@"{Math.Floor(difference.TotalDays)}d";
 
                 return string.Empty;
             }

From cb9ffc655acf4509ce174c770788b9bfeb715339 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 16 Feb 2022 22:32:42 +0100
Subject: [PATCH 2956/5547] Add tests showing expected behaviour of naming
 helper

---
 osu.Game.Tests/Utils/NamingUtilsTest.cs | 132 ++++++++++++++++++++++++
 osu.Game/Utils/NamingUtils.cs           |  15 +++
 2 files changed, 147 insertions(+)
 create mode 100644 osu.Game.Tests/Utils/NamingUtilsTest.cs
 create mode 100644 osu.Game/Utils/NamingUtils.cs

diff --git a/osu.Game.Tests/Utils/NamingUtilsTest.cs b/osu.Game.Tests/Utils/NamingUtilsTest.cs
new file mode 100644
index 0000000000..62e688db90
--- /dev/null
+++ b/osu.Game.Tests/Utils/NamingUtilsTest.cs
@@ -0,0 +1,132 @@
+// 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.Utils;
+
+namespace osu.Game.Tests.Utils
+{
+    [TestFixture]
+    public class NamingUtilsTest
+    {
+        [Test]
+        public void TestEmptySet()
+        {
+            string nextBestName = NamingUtils.GetNextBestName(Enumerable.Empty<string>(), "New Difficulty");
+
+            Assert.AreEqual("New Difficulty", nextBestName);
+        }
+
+        [Test]
+        public void TestNotTaken()
+        {
+            string[] existingNames =
+            {
+                "Something",
+                "Entirely",
+                "Different"
+            };
+
+            string nextBestName = NamingUtils.GetNextBestName(existingNames, "New Difficulty");
+
+            Assert.AreEqual("New Difficulty", nextBestName);
+        }
+
+        [Test]
+        public void TestNotTakenButClose()
+        {
+            string[] existingNames =
+            {
+                "New Difficulty(1)",
+                "New Difficulty (abcd)",
+                "New Difficulty but not really"
+            };
+
+            string nextBestName = NamingUtils.GetNextBestName(existingNames, "New Difficulty");
+
+            Assert.AreEqual("New Difficulty", nextBestName);
+        }
+
+        [Test]
+        public void TestAlreadyTaken()
+        {
+            string[] existingNames =
+            {
+                "New Difficulty"
+            };
+
+            string nextBestName = NamingUtils.GetNextBestName(existingNames, "New Difficulty");
+
+            Assert.AreEqual("New Difficulty (1)", nextBestName);
+        }
+
+        [Test]
+        public void TestAlreadyTakenWithDifferentCase()
+        {
+            string[] existingNames =
+            {
+                "new difficulty"
+            };
+
+            string nextBestName = NamingUtils.GetNextBestName(existingNames, "New Difficulty");
+
+            Assert.AreEqual("New Difficulty (1)", nextBestName);
+        }
+
+        [Test]
+        public void TestAlreadyTakenWithBrackets()
+        {
+            string[] existingNames =
+            {
+                "new difficulty (copy)"
+            };
+
+            string nextBestName = NamingUtils.GetNextBestName(existingNames, "New Difficulty (copy)");
+
+            Assert.AreEqual("New Difficulty (copy) (1)", nextBestName);
+        }
+
+        [Test]
+        public void TestMultipleAlreadyTaken()
+        {
+            string[] existingNames =
+            {
+                "New Difficulty",
+                "New difficulty (1)",
+                "new Difficulty (2)",
+                "New DIFFICULTY (3)"
+            };
+
+            string nextBestName = NamingUtils.GetNextBestName(existingNames, "New Difficulty");
+
+            Assert.AreEqual("New Difficulty (4)", nextBestName);
+        }
+
+        [Test]
+        public void TestEvenMoreAlreadyTaken()
+        {
+            string[] existingNames = Enumerable.Range(1, 30).Select(i => $"New Difficulty ({i})").Append("New Difficulty").ToArray();
+
+            string nextBestName = NamingUtils.GetNextBestName(existingNames, "New Difficulty");
+
+            Assert.AreEqual("New Difficulty (31)", nextBestName);
+        }
+
+        [Test]
+        public void TestMultipleAlreadyTakenWithGaps()
+        {
+            string[] existingNames =
+            {
+                "New Difficulty",
+                "New Difficulty (1)",
+                "New Difficulty (4)",
+                "New Difficulty (9)"
+            };
+
+            string nextBestName = NamingUtils.GetNextBestName(existingNames, "New Difficulty");
+
+            Assert.AreEqual("New Difficulty (2)", nextBestName);
+        }
+    }
+}
diff --git a/osu.Game/Utils/NamingUtils.cs b/osu.Game/Utils/NamingUtils.cs
new file mode 100644
index 0000000000..1b48f57932
--- /dev/null
+++ b/osu.Game/Utils/NamingUtils.cs
@@ -0,0 +1,15 @@
+// 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;
+
+namespace osu.Game.Utils
+{
+    public static class NamingUtils
+    {
+        public static string GetNextBestName(IEnumerable<string> existingNames, string desiredName)
+        {
+            return null;
+        }
+    }
+}

From e09570c31bf18af340d529fc59448b1b694db270 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 16 Feb 2022 23:00:45 +0100
Subject: [PATCH 2957/5547] Implement best-name-finding helper method

---
 osu.Game/Utils/NamingUtils.cs | 48 ++++++++++++++++++++++++++++++++++-
 1 file changed, 47 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Utils/NamingUtils.cs b/osu.Game/Utils/NamingUtils.cs
index 1b48f57932..482e3d0954 100644
--- a/osu.Game/Utils/NamingUtils.cs
+++ b/osu.Game/Utils/NamingUtils.cs
@@ -2,14 +2,60 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System.Collections.Generic;
+using System.Text.RegularExpressions;
 
 namespace osu.Game.Utils
 {
     public static class NamingUtils
     {
+        /// <summary>
+        /// Given a set of <paramref name="existingNames"/> and a target <paramref name="desiredName"/>,
+        /// finds a "best" name closest to <paramref name="desiredName"/> that is not in <paramref name="existingNames"/>.
+        /// </summary>
+        /// <remarks>
+        /// <para>
+        /// This helper is most useful in scenarios when creating new objects in a set
+        /// (such as adding new difficulties to a beatmap set, or creating a clone of an existing object that needs a unique name).
+        /// If <paramref name="desiredName"/> is already present in <paramref name="existingNames"/>,
+        /// this method will append the lowest possible number in brackets that doesn't conflict with <paramref name="existingNames"/>
+        /// to <paramref name="desiredName"/> and return that.
+        /// See <c>osu.Game.Tests.Utils.NamingUtilsTest</c> for concrete examples of behaviour.
+        /// </para>
+        /// <para>
+        /// <paramref name="desiredName"/> and <paramref name="existingNames"/> are compared in a case-insensitive manner,
+        /// so this method is safe to use for naming files in a platform-invariant manner.
+        /// </para>
+        /// </remarks>
         public static string GetNextBestName(IEnumerable<string> existingNames, string desiredName)
         {
-            return null;
+            string pattern = $@"^(?i){Regex.Escape(desiredName)}(?-i)( \((?<copyNumber>[1-9][0-9]*)\))?$";
+            var regex = new Regex(pattern, RegexOptions.Compiled);
+            var takenNumbers = new HashSet<int>();
+
+            foreach (string name in existingNames)
+            {
+                var match = regex.Match(name);
+                if (!match.Success)
+                    continue;
+
+                string copyNumberString = match.Groups[@"copyNumber"].Value;
+
+                if (string.IsNullOrEmpty(copyNumberString))
+                {
+                    takenNumbers.Add(0);
+                    continue;
+                }
+
+                takenNumbers.Add(int.Parse(copyNumberString));
+            }
+
+            int bestNumber = 0;
+            while (takenNumbers.Contains(bestNumber))
+                bestNumber += 1;
+
+            return bestNumber == 0
+                ? desiredName
+                : $"{desiredName} ({bestNumber})";
         }
     }
 }

From 8a08bb7aaf88ec33c64c01659cd0ea9c42f93f8e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 16 Feb 2022 23:12:13 +0100
Subject: [PATCH 2958/5547] Use best-name-finding helper in new difficulty
 creation flow

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

diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index 777d5db2ad..5f7de0d762 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -22,6 +22,7 @@ using osu.Game.Overlays.Notifications;
 using osu.Game.Rulesets;
 using osu.Game.Skinning;
 using osu.Game.Stores;
+using osu.Game.Utils;
 
 #nullable enable
 
@@ -123,7 +124,10 @@ namespace osu.Game.Beatmaps
         {
             var playableBeatmap = referenceWorkingBeatmap.GetPlayableBeatmap(rulesetInfo);
 
-            var newBeatmapInfo = new BeatmapInfo(rulesetInfo, new BeatmapDifficulty(), playableBeatmap.Metadata.DeepClone());
+            var newBeatmapInfo = new BeatmapInfo(rulesetInfo, new BeatmapDifficulty(), playableBeatmap.Metadata.DeepClone())
+            {
+                DifficultyName = NamingUtils.GetNextBestName(targetBeatmapSet.Beatmaps.Select(b => b.DifficultyName), "New Difficulty")
+            };
             var newBeatmap = new Beatmap { BeatmapInfo = newBeatmapInfo };
             foreach (var timingPoint in playableBeatmap.ControlPointInfo.TimingPoints)
                 newBeatmap.ControlPointInfo.Add(timingPoint.Time, timingPoint.DeepClone());
@@ -150,8 +154,10 @@ namespace osu.Game.Beatmaps
             newBeatmap.BeatmapInfo = newBeatmapInfo = referenceWorkingBeatmap.BeatmapInfo.Clone();
             // assign a new ID to the clone.
             newBeatmapInfo.ID = Guid.NewGuid();
-            // add "(copy)" suffix to difficulty name to avoid clashes on save.
-            newBeatmapInfo.DifficultyName += " (copy)";
+            // add "(copy)" suffix to difficulty name, and additionally ensure that it doesn't conflict with any other potentially pre-existing copies.
+            newBeatmapInfo.DifficultyName = NamingUtils.GetNextBestName(
+                targetBeatmapSet.Beatmaps.Select(b => b.DifficultyName),
+                $"{newBeatmapInfo.DifficultyName} (copy)");
             // clear the hash, as that's what is used to match .osu files with their corresponding realm beatmaps.
             newBeatmapInfo.Hash = string.Empty;
             // clear online properties.

From e459523afe5cd351e98a8558f41ca933ef3374b1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 16 Feb 2022 23:13:43 +0100
Subject: [PATCH 2959/5547] Adjust beatmap creation test cases to new behaviour

---
 .../Editing/TestSceneEditorBeatmapCreation.cs  | 18 ++++++++++++++----
 1 file changed, 14 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneEditorBeatmapCreation.cs b/osu.Game.Tests/Visual/Editing/TestSceneEditorBeatmapCreation.cs
index 0a2f622da1..ecd4035edd 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneEditorBeatmapCreation.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneEditorBeatmapCreation.cs
@@ -269,11 +269,12 @@ namespace osu.Game.Tests.Visual.Editing
         }
 
         [Test]
-        public void TestCreateNewBeatmapFailsWithBlankNamedDifficulties()
+        public void TestCreateMultipleNewDifficultiesSucceeds()
         {
             Guid setId = Guid.Empty;
 
             AddStep("retrieve set ID", () => setId = EditorBeatmap.BeatmapInfo.BeatmapSet!.ID);
+            AddStep("set difficulty name", () => EditorBeatmap.BeatmapInfo.DifficultyName = "New Difficulty");
             AddStep("save beatmap", () => Editor.Save());
             AddAssert("new beatmap persisted", () =>
             {
@@ -282,15 +283,24 @@ namespace osu.Game.Tests.Visual.Editing
             });
 
             AddStep("try to create new difficulty", () => Editor.CreateNewDifficulty(new OsuRuleset().RulesetInfo));
-            AddAssert("beatmap set unchanged", () =>
+            AddUntilStep("wait for dialog", () => DialogOverlay.CurrentDialog is CreateNewDifficultyDialog);
+            AddStep("confirm creation with no objects", () => DialogOverlay.CurrentDialog.PerformOkAction());
+
+            AddUntilStep("wait for created", () =>
+            {
+                string difficultyName = Editor.ChildrenOfType<EditorBeatmap>().SingleOrDefault()?.BeatmapInfo.DifficultyName;
+                return difficultyName != null && difficultyName != "New Difficulty";
+            });
+            AddAssert("new difficulty has correct name", () => EditorBeatmap.BeatmapInfo.DifficultyName == "New Difficulty (1)");
+            AddAssert("new difficulty persisted", () =>
             {
                 var set = beatmapManager.QueryBeatmapSet(s => s.ID == setId);
-                return set != null && set.PerformRead(s => s.Beatmaps.Count == 1 && s.Files.Count == 1);
+                return set != null && set.PerformRead(s => s.Beatmaps.Count == 2 && s.Files.Count == 2);
             });
         }
 
         [Test]
-        public void TestCreateNewBeatmapFailsWithSameNamedDifficulties([Values] bool sameRuleset)
+        public void TestSavingBeatmapFailsWithSameNamedDifficulties([Values] bool sameRuleset)
         {
             Guid setId = Guid.Empty;
             const string duplicate_difficulty_name = "duplicate";

From aac1c53b060cc1885297baa3fc5709b6a5749097 Mon Sep 17 00:00:00 2001
From: Stedoss <29103029+Stedoss@users.noreply.github.com>
Date: Thu, 17 Feb 2022 03:04:16 +0000
Subject: [PATCH 2960/5547] Remove creator name from playlist item panel
 beatmap text

---
 .../Screens/OnlinePlay/DrawableRoomPlaylistItem.cs   | 12 ++++++++----
 1 file changed, 8 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
index dcf2a5a480..7533bfc8b6 100644
--- a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
+++ b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
@@ -291,10 +291,14 @@ namespace osu.Game.Screens.OnlinePlay
 
             if (Item.Beatmap.Value != null)
             {
-                beatmapText.AddLink(Item.Beatmap.Value.GetDisplayTitleRomanisable(), LinkAction.OpenBeatmap, Item.Beatmap.Value.OnlineID.ToString(), null, text =>
-                {
-                    text.Truncate = true;
-                });
+                beatmapText.AddLink(Item.Beatmap.Value.GetDisplayTitleRomanisable(includeCreator: false),
+                    LinkAction.OpenBeatmap,
+                    Item.Beatmap.Value.OnlineID.ToString(),
+                    null,
+                    text =>
+                    {
+                        text.Truncate = true;
+                    });
             }
 
             authorText.Clear();

From 7307e68e9c55bf1be4bde2e94d912e6a9df24f63 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 17 Feb 2022 13:26:12 +0900
Subject: [PATCH 2961/5547] Revert "Merge pull request #16889 from
 smoogipoo/remove-mod-multiplier"

This reverts commit 252b945d3b0cd4e6f33ac334f23bcf119a119c2a, reversing
changes made to a1b39a96cfe3f4d0f02652ded5ebca09ba1d24e1.
---
 .../Difficulty/ManiaPerformanceCalculator.cs  | 16 +++++------
 .../TestSceneSpinnerRotation.cs               |  3 ++-
 .../TestSceneFooterButtonMods.cs              | 27 +++++++++++++++++--
 osu.Game/Rulesets/Mods/Mod.cs                 |  7 ++---
 osu.Game/Rulesets/Scoring/ScoreProcessor.cs   | 13 ++++++++-
 osu.Game/Screens/Select/FooterButtonMods.cs   | 25 +++++++++++++++++
 6 files changed, 74 insertions(+), 17 deletions(-)

diff --git a/osu.Game.Rulesets.Mania/Difficulty/ManiaPerformanceCalculator.cs b/osu.Game.Rulesets.Mania/Difficulty/ManiaPerformanceCalculator.cs
index beba29b8bb..8a8c41bb8a 100644
--- a/osu.Game.Rulesets.Mania/Difficulty/ManiaPerformanceCalculator.cs
+++ b/osu.Game.Rulesets.Mania/Difficulty/ManiaPerformanceCalculator.cs
@@ -43,11 +43,14 @@ namespace osu.Game.Rulesets.Mania.Difficulty
             countMeh = Score.Statistics.GetValueOrDefault(HitResult.Meh);
             countMiss = Score.Statistics.GetValueOrDefault(HitResult.Miss);
 
-            if (Attributes.ScoreMultiplier > 0)
-            {
-                // Scale score up, so it's comparable to other keymods
-                scaledScore *= 1.0 / Attributes.ScoreMultiplier;
-            }
+            IEnumerable<Mod> scoreIncreaseMods = Ruleset.GetModsFor(ModType.DifficultyIncrease);
+
+            double scoreMultiplier = 1.0;
+            foreach (var m in mods.Where(m => !scoreIncreaseMods.Contains(m)))
+                scoreMultiplier *= m.ScoreMultiplier;
+
+            // Scale score up, so it's comparable to other keymods
+            scaledScore *= 1.0 / scoreMultiplier;
 
             // Arbitrary initial value for scaling pp in order to standardize distributions across game modes.
             // The specific number has no intrinsic meaning and can be adjusted as needed.
@@ -77,9 +80,6 @@ namespace osu.Game.Rulesets.Mania.Difficulty
 
         private double computeDifficultyValue()
         {
-            if (Attributes.ScoreMultiplier <= 0)
-                return 0;
-
             double difficultyValue = Math.Pow(5 * Math.Max(1, Attributes.StarRating / 0.2) - 4.0, 2.2) / 135.0;
 
             difficultyValue *= 1.0 + 0.1 * Math.Min(1.0, totalHits / 1500.0);
diff --git a/osu.Game.Rulesets.Osu.Tests/TestSceneSpinnerRotation.cs b/osu.Game.Rulesets.Osu.Tests/TestSceneSpinnerRotation.cs
index 0b9db8e20a..de795241bf 100644
--- a/osu.Game.Rulesets.Osu.Tests/TestSceneSpinnerRotation.cs
+++ b/osu.Game.Rulesets.Osu.Tests/TestSceneSpinnerRotation.cs
@@ -147,7 +147,8 @@ namespace osu.Game.Rulesets.Osu.Tests
 
             AddAssert("player score matching expected bonus score", () =>
             {
-                double totalScore = ((ScoreExposedPlayer)Player).ScoreProcessor.TotalScore.Value;
+                // multipled by 2 to nullify the score multiplier. (autoplay mod selected)
+                double totalScore = ((ScoreExposedPlayer)Player).ScoreProcessor.TotalScore.Value * 2;
                 return totalScore == (int)(drawableSpinner.Result.RateAdjustedRotation / 360) * new SpinnerTick().CreateJudgement().MaxNumericResult;
             });
 
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneFooterButtonMods.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneFooterButtonMods.cs
index e9014c0941..0631059d1a 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneFooterButtonMods.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneFooterButtonMods.cs
@@ -3,7 +3,9 @@
 
 using System;
 using System.Collections.Generic;
+using System.Linq;
 using NUnit.Framework;
+using osu.Game.Graphics.Sprites;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Osu.Mods;
 using osu.Game.Screens.Select;
@@ -12,11 +14,11 @@ namespace osu.Game.Tests.Visual.UserInterface
 {
     public class TestSceneFooterButtonMods : OsuTestScene
     {
-        private readonly FooterButtonMods footerButtonMods;
+        private readonly TestFooterButtonMods footerButtonMods;
 
         public TestSceneFooterButtonMods()
         {
-            Add(footerButtonMods = new FooterButtonMods());
+            Add(footerButtonMods = new TestFooterButtonMods());
         }
 
         [Test]
@@ -24,15 +26,19 @@ namespace osu.Game.Tests.Visual.UserInterface
         {
             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]
@@ -40,12 +46,15 @@ namespace osu.Game.Tests.Visual.UserInterface
         {
             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]
@@ -54,11 +63,25 @@ namespace osu.Game.Tests.Visual.UserInterface
             var multipleMods = new Mod[] { new OsuModDoubleTime(), new OsuModFlashlight() };
             AddStep(@"Add mods", () => changeMods(multipleMods));
             AddStep(@"Clear selected mod", () => changeMods(Array.Empty<Mod>()));
+            AddAssert(@"Check empty multiplier", () => assertModsMultiplier(Array.Empty<Mod>()));
         }
 
         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 = multiplier.Equals(1.0) ? string.Empty : $"{multiplier:N2}x";
+
+            return expectedValue == footerButtonMods.MultiplierText.Current.Value;
+        }
+
+        private class TestFooterButtonMods : FooterButtonMods
+        {
+            public new OsuSpriteText MultiplierText => base.MultiplierText;
+        }
     }
 }
diff --git a/osu.Game/Rulesets/Mods/Mod.cs b/osu.Game/Rulesets/Mods/Mod.cs
index 9a45e2458d..7136795461 100644
--- a/osu.Game/Rulesets/Mods/Mod.cs
+++ b/osu.Game/Rulesets/Mods/Mod.cs
@@ -80,13 +80,10 @@ namespace osu.Game.Rulesets.Mods
         }
 
         /// <summary>
-        /// The (legacy) score multiplier of this mod.
+        /// The score multiplier of this mod.
         /// </summary>
-        /// <remarks>
-        /// This is not applied for newly set scores, but may be required for display purposes when showing legacy scores.
-        /// </remarks>
         [JsonIgnore]
-        public virtual double ScoreMultiplier => 1;
+        public abstract double ScoreMultiplier { get; }
 
         /// <summary>
         /// Returns true if this mod is implemented (and playable).
diff --git a/osu.Game/Rulesets/Scoring/ScoreProcessor.cs b/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
index ce1486b02f..79861c0ecc 100644
--- a/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
+++ b/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
@@ -92,6 +92,8 @@ namespace osu.Game.Rulesets.Scoring
         private readonly List<HitEvent> hitEvents = new List<HitEvent>();
         private HitObject lastHitObject;
 
+        private double scoreMultiplier = 1;
+
         public ScoreProcessor()
         {
             accuracyPortion = DefaultAccuracyPortion;
@@ -109,6 +111,15 @@ namespace osu.Game.Rulesets.Scoring
             };
 
             Mode.ValueChanged += _ => updateScore();
+            Mods.ValueChanged += mods =>
+            {
+                scoreMultiplier = 1;
+
+                foreach (var m in mods.NewValue)
+                    scoreMultiplier *= m.ScoreMultiplier;
+
+                updateScore();
+            };
         }
 
         private readonly Dictionary<HitResult, int> scoreResultCounts = new Dictionary<HitResult, int>();
@@ -224,7 +235,7 @@ namespace osu.Game.Rulesets.Scoring
                 case ScoringMode.Standardised:
                     double accuracyScore = accuracyPortion * accuracyRatio;
                     double comboScore = comboPortion * comboRatio;
-                    return (max_score * (accuracyScore + comboScore) + getBonusScore(statistics));
+                    return (max_score * (accuracyScore + comboScore) + getBonusScore(statistics)) * scoreMultiplier;
 
                 case ScoringMode.Classic:
                     // This gives a similar feeling to osu!stable scoring (ScoreV1) while keeping classic scoring as only a constant multiple of standardised scoring.
diff --git a/osu.Game/Screens/Select/FooterButtonMods.cs b/osu.Game/Screens/Select/FooterButtonMods.cs
index 1f1aa4c4b3..5bbca5ca1a 100644
--- a/osu.Game/Screens/Select/FooterButtonMods.cs
+++ b/osu.Game/Screens/Select/FooterButtonMods.cs
@@ -6,11 +6,14 @@ using osu.Framework.Graphics;
 using osu.Game.Screens.Play.HUD;
 using osu.Game.Rulesets.Mods;
 using System.Collections.Generic;
+using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics.UserInterface;
 using osu.Game.Graphics;
+using osu.Game.Graphics.Sprites;
 using osuTK;
+using osuTK.Graphics;
 using osu.Game.Input.Bindings;
 
 namespace osu.Game.Screens.Select
@@ -23,7 +26,10 @@ namespace osu.Game.Screens.Select
             set => modDisplay.Current = value;
         }
 
+        protected readonly OsuSpriteText MultiplierText;
         private readonly ModDisplay modDisplay;
+        private Color4 lowMultiplierColour;
+        private Color4 highMultiplierColour;
 
         public FooterButtonMods()
         {
@@ -34,6 +40,12 @@ namespace osu.Game.Screens.Select
                 Scale = new Vector2(0.8f),
                 ExpansionMode = ExpansionMode.AlwaysContracted,
             });
+            ButtonContentContainer.Add(MultiplierText = new OsuSpriteText
+            {
+                Anchor = Anchor.Centre,
+                Origin = Anchor.Centre,
+                Font = OsuFont.GetFont(weight: FontWeight.Bold),
+            });
         }
 
         [BackgroundDependencyLoader]
@@ -41,6 +53,8 @@ namespace osu.Game.Screens.Select
         {
             SelectedColour = colours.Yellow;
             DeselectedColour = SelectedColour.Opacity(0.5f);
+            lowMultiplierColour = colours.Red;
+            highMultiplierColour = colours.Green;
             Text = @"mods";
             Hotkey = GlobalAction.ToggleModSelection;
         }
@@ -54,6 +68,17 @@ namespace osu.Game.Screens.Select
 
         private void updateMultiplierText()
         {
+            double multiplier = Current.Value?.Aggregate(1.0, (current, mod) => current * mod.ScoreMultiplier) ?? 1;
+
+            MultiplierText.Text = multiplier.Equals(1.0) ? string.Empty : $"{multiplier:N2}x";
+
+            if (multiplier > 1.0)
+                MultiplierText.FadeColour(highMultiplierColour, 200);
+            else if (multiplier < 1.0)
+                MultiplierText.FadeColour(lowMultiplierColour, 200);
+            else
+                MultiplierText.FadeColour(Color4.White, 200);
+
             if (Current.Value?.Count > 0)
                 modDisplay.FadeIn();
             else

From 39a7bbdb9ad0cd23ccffc45b0760b228a078393d Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 17 Feb 2022 14:03:38 +0900
Subject: [PATCH 2962/5547] Fix mania PP calculator applying incorrect score
 multiplier

---
 .../Difficulty/ManiaPerformanceCalculator.cs        | 13 +++++--------
 1 file changed, 5 insertions(+), 8 deletions(-)

diff --git a/osu.Game.Rulesets.Mania/Difficulty/ManiaPerformanceCalculator.cs b/osu.Game.Rulesets.Mania/Difficulty/ManiaPerformanceCalculator.cs
index 8a8c41bb8a..722cb55036 100644
--- a/osu.Game.Rulesets.Mania/Difficulty/ManiaPerformanceCalculator.cs
+++ b/osu.Game.Rulesets.Mania/Difficulty/ManiaPerformanceCalculator.cs
@@ -43,14 +43,11 @@ namespace osu.Game.Rulesets.Mania.Difficulty
             countMeh = Score.Statistics.GetValueOrDefault(HitResult.Meh);
             countMiss = Score.Statistics.GetValueOrDefault(HitResult.Miss);
 
-            IEnumerable<Mod> scoreIncreaseMods = Ruleset.GetModsFor(ModType.DifficultyIncrease);
-
-            double scoreMultiplier = 1.0;
-            foreach (var m in mods.Where(m => !scoreIncreaseMods.Contains(m)))
-                scoreMultiplier *= m.ScoreMultiplier;
-
-            // Scale score up, so it's comparable to other keymods
-            scaledScore *= 1.0 / scoreMultiplier;
+            if (Attributes.ScoreMultiplier > 0)
+            {
+                // Scale score up, so it's comparable to other keymods
+                scaledScore *= 1.0 / Attributes.ScoreMultiplier;
+            }
 
             // Arbitrary initial value for scaling pp in order to standardize distributions across game modes.
             // The specific number has no intrinsic meaning and can be adjusted as needed.

From dc74d17478605d1fbb03b434623a49a2f72970b0 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 17 Feb 2022 16:45:20 +0900
Subject: [PATCH 2963/5547] Update framework

---
 osu.Android.props        | 2 +-
 osu.Game/osu.Game.csproj | 2 +-
 osu.iOS.props            | 4 ++--
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Android.props b/osu.Android.props
index eab2be1b72..24a0d20874 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -52,7 +52,7 @@
   </ItemGroup>
   <ItemGroup>
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.211.0" />
-    <PackageReference Include="ppy.osu.Framework.Android" Version="2022.214.0" />
+    <PackageReference Include="ppy.osu.Framework.Android" Version="2022.217.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
     <!-- Realm needs to be directly referenced in all Xamarin projects, as it will not pull in its transitive dependencies otherwise. -->
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 7b50c804ff..4c6f81defa 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="10.9.0" />
-    <PackageReference Include="ppy.osu.Framework" Version="2022.214.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2022.217.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.211.0" />
     <PackageReference Include="Sentry" Version="3.14.0" />
     <PackageReference Include="SharpCompress" Version="0.30.1" />
diff --git a/osu.iOS.props b/osu.iOS.props
index 03a105673c..99b9de3fe2 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -60,7 +60,7 @@
     <Reference Include="System.Net.Http" />
   </ItemGroup>
   <ItemGroup Label="Package References">
-    <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.214.0" />
+    <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.217.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.211.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net6.0) -->
@@ -83,7 +83,7 @@
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="5.0.14" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.Core" Version="5.0.14" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
-    <PackageReference Include="ppy.osu.Framework" Version="2022.214.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2022.217.0" />
     <PackageReference Include="SharpCompress" Version="0.30.1" />
     <PackageReference Include="NUnit" Version="3.13.2" />
     <PackageReference Include="System.ComponentModel.Annotations" Version="5.0.0" />

From 7bd731ae08210e58d2101aa3afef7807e15e4fa0 Mon Sep 17 00:00:00 2001
From: dekrain <dawidkrainski8@gmail.com>
Date: Thu, 17 Feb 2022 10:12:35 +0100
Subject: [PATCH 2964/5547] Move the date next to the flag icon

---
 .../Online/Leaderboards/LeaderboardScore.cs   | 32 ++++++++-----------
 1 file changed, 14 insertions(+), 18 deletions(-)

diff --git a/osu.Game/Online/Leaderboards/LeaderboardScore.cs b/osu.Game/Online/Leaderboards/LeaderboardScore.cs
index 9ac1ab8075..a13d8eeffd 100644
--- a/osu.Game/Online/Leaderboards/LeaderboardScore.cs
+++ b/osu.Game/Online/Leaderboards/LeaderboardScore.cs
@@ -44,7 +44,6 @@ namespace osu.Game.Online.Leaderboards
         private const float edge_margin = 5;
         private const float background_alpha = 0.25f;
         private const float rank_width = 35;
-        private const float date_width = 35;
 
         protected Container RankContainer { get; private set; }
 
@@ -59,7 +58,7 @@ namespace osu.Game.Online.Leaderboards
 
         public GlowingSpriteText ScoreText { get; private set; }
 
-        private Container flagBadgeContainer;
+        private FillFlowContainer flagBadgeAndDateContainer;
         private FillFlowContainer<ModIcon> modsContainer;
 
         private List<ScoreComponentLabel> statisticsLabels;
@@ -103,18 +102,10 @@ namespace osu.Game.Online.Leaderboards
                     RelativeSizeAxes = Axes.Y,
                     Width = rank_width,
                 },
-                new Container
-                {
-                    Anchor = Anchor.TopRight,
-                    Origin = Anchor.TopRight,
-                    RelativeSizeAxes = Axes.Y,
-                    Width = date_width,
-                    Child = new DateLabel(Score.Date),
-                },
                 content = new Container
                 {
                     RelativeSizeAxes = Axes.Both,
-                    Padding = new MarginPadding { Left = rank_width, Right = date_width, },
+                    Padding = new MarginPadding { Left = rank_width },
                     Children = new Drawable[]
                     {
                         new Container
@@ -176,10 +167,12 @@ namespace osu.Game.Online.Leaderboards
                                             Spacing = new Vector2(10f, 0f),
                                             Children = new Drawable[]
                                             {
-                                                flagBadgeContainer = new Container
+                                                flagBadgeAndDateContainer = new FillFlowContainer
                                                 {
                                                     Origin = Anchor.BottomLeft,
                                                     Anchor = Anchor.BottomLeft,
+                                                    Direction = FillDirection.Horizontal,
+                                                    Spacing = new Vector2(5f, 0f),
                                                     Size = new Vector2(87f, 20f),
                                                     Masking = true,
                                                     Children = new Drawable[]
@@ -189,6 +182,10 @@ namespace osu.Game.Online.Leaderboards
                                                             Width = 30,
                                                             RelativeSizeAxes = Axes.Y,
                                                         },
+                                                        new DateLabel(Score.Date)
+                                                        {
+                                                            RelativeSizeAxes = Axes.Y,
+                                                        },
                                                     },
                                                 },
                                                 new FillFlowContainer
@@ -254,7 +251,7 @@ namespace osu.Game.Online.Leaderboards
 
         public override void Show()
         {
-            foreach (var d in new[] { avatar, nameLabel, ScoreText, scoreRank, flagBadgeContainer, modsContainer }.Concat(statisticsLabels))
+            foreach (var d in new[] { avatar, nameLabel, ScoreText, scoreRank, flagBadgeAndDateContainer, modsContainer }.Concat(statisticsLabels))
                 d.FadeOut();
 
             Alpha = 0;
@@ -281,7 +278,7 @@ namespace osu.Game.Online.Leaderboards
 
                     using (BeginDelayedSequence(50))
                     {
-                        var drawables = new Drawable[] { flagBadgeContainer, modsContainer }.Concat(statisticsLabels).ToArray();
+                        var drawables = new Drawable[] { flagBadgeAndDateContainer, modsContainer }.Concat(statisticsLabels).ToArray();
                         for (int i = 0; i < drawables.Length; i++)
                             drawables[i].FadeIn(100 + i * 50);
                     }
@@ -391,10 +388,9 @@ namespace osu.Game.Online.Leaderboards
         private class DateLabel : DrawableDate
         {
             public DateLabel(DateTimeOffset date)
-                : base(date, 20)
+                : base(date)
             {
-                Anchor = Anchor.Centre;
-                Origin = Anchor.Centre;
+                Font = OsuFont.GetFont(size: 17, weight: FontWeight.Bold, italics: true);
             }
 
             protected override string Format()
@@ -411,7 +407,7 @@ namespace osu.Game.Online.Leaderboards
                     return $@"{Math.Floor(difference.TotalMinutes)}min";
                 if (difference.TotalDays < 1)
                     return $@"{Math.Floor(difference.TotalHours)}h";
-                if (difference.TotalDays < 7)
+                if (difference.TotalDays < 3)
                     return $@"{Math.Floor(difference.TotalDays)}d";
 
                 return string.Empty;

From f4d1e6f600343fda0ca9446297e9f8d0e5073ce6 Mon Sep 17 00:00:00 2001
From: dekrain <dawidkrainski8@gmail.com>
Date: Thu, 17 Feb 2022 10:38:29 +0100
Subject: [PATCH 2965/5547] Add tests for timerefs

---
 .../Visual/SongSelect/TestSceneBeatmapLeaderboard.cs      | 8 ++++++++
 osu.Game/Online/Leaderboards/LeaderboardScore.cs          | 4 +++-
 2 files changed, 11 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
index 667fd08084..2f44633f4d 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
@@ -197,6 +197,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                     Accuracy = 1,
                     MaxCombo = 244,
                     TotalScore = 1707827,
+                    Date = DateTime.Now,
                     Mods = new Mod[]
                     {
                         new OsuModHidden(),
@@ -234,6 +235,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                     Accuracy = 1,
                     MaxCombo = 244,
                     TotalScore = 1707827,
+                    Date = DateTime.Now.AddSeconds(-30),
                     Mods = new Mod[] { new OsuModHidden(), new OsuModHardRock(), },
                     BeatmapInfo = beatmapInfo,
                     Ruleset = new OsuRuleset().RulesetInfo,
@@ -254,6 +256,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                     Accuracy = 1,
                     MaxCombo = 244,
                     TotalScore = 1707827,
+                    Date = DateTime.Now.AddSeconds(-70),
                     Mods = new Mod[] { new OsuModHidden(), new OsuModHardRock(), },
                     BeatmapInfo = beatmapInfo,
                     Ruleset = new OsuRuleset().RulesetInfo,
@@ -275,6 +278,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                     Accuracy = 1,
                     MaxCombo = 244,
                     TotalScore = 1707827,
+                    Date = DateTime.Now.AddMinutes(-40),
                     Mods = new Mod[] { new OsuModHidden(), new OsuModHardRock(), },
                     BeatmapInfo = beatmapInfo,
                     Ruleset = new OsuRuleset().RulesetInfo,
@@ -296,6 +300,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                     Accuracy = 1,
                     MaxCombo = 244,
                     TotalScore = 1707827,
+                    Date = DateTime.Now.AddHours(-2),
                     Mods = new Mod[] { new OsuModHidden(), new OsuModHardRock(), },
                     BeatmapInfo = beatmapInfo,
                     Ruleset = new OsuRuleset().RulesetInfo,
@@ -317,6 +322,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                     Accuracy = 0.9826,
                     MaxCombo = 244,
                     TotalScore = 1707827,
+                    Date = DateTime.Now.AddHours(-25),
                     Mods = new Mod[] { new OsuModHidden(), new OsuModHardRock(), },
                     BeatmapInfo = beatmapInfo,
                     Ruleset = new OsuRuleset().RulesetInfo,
@@ -338,6 +344,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                     Accuracy = 0.9654,
                     MaxCombo = 244,
                     TotalScore = 1707827,
+                    Date = DateTime.Now.AddHours(-50),
                     Mods = new Mod[] { new OsuModHidden(), new OsuModHardRock(), },
                     BeatmapInfo = beatmapInfo,
                     Ruleset = new OsuRuleset().RulesetInfo,
@@ -359,6 +366,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                     Accuracy = 0.6025,
                     MaxCombo = 244,
                     TotalScore = 1707827,
+                    Date = DateTime.Now.AddHours(-72),
                     Mods = new Mod[] { new OsuModHidden(), new OsuModHardRock(), },
                     BeatmapInfo = beatmapInfo,
                     Ruleset = new OsuRuleset().RulesetInfo,
diff --git a/osu.Game/Online/Leaderboards/LeaderboardScore.cs b/osu.Game/Online/Leaderboards/LeaderboardScore.cs
index a13d8eeffd..8cfba68ea6 100644
--- a/osu.Game/Online/Leaderboards/LeaderboardScore.cs
+++ b/osu.Game/Online/Leaderboards/LeaderboardScore.cs
@@ -401,8 +401,10 @@ namespace osu.Game.Online.Leaderboards
                 // TODO(optional): support localisation (probably via `CommonStrings.CountHours()` etc.)
                 // requires pluralisable string support framework-side
 
-                if (difference.TotalMinutes < 1)
+                if (difference.TotalSeconds < 10)
                     return CommonStrings.TimeNow.ToString();
+                if (difference.TotalMinutes < 1)
+                    return $@"{Math.Floor(difference.TotalSeconds)}s";
                 if (difference.TotalHours < 1)
                     return $@"{Math.Floor(difference.TotalMinutes)}min";
                 if (difference.TotalDays < 1)

From 3d5ed24e206a43990f36880464917045e8cdf2be Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 17 Feb 2022 21:04:59 +0900
Subject: [PATCH 2966/5547] Fix beatmap overlay leaderboards and links not
 working

Completely aware that this isn't how it should be done, but would like
to get this out in a hotfix release today. Maybe changes opinions on
https://github.com/ppy/osu/pull/16890 structure?
---
 .../API/Requests/Responses/APIBeatmap.cs      | 22 ++++++++++++++++++-
 1 file changed, 21 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs b/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs
index dca60e54cb..c53fab48ae 100644
--- a/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs
@@ -112,7 +112,27 @@ namespace osu.Game.Online.API.Requests.Responses
             public int OnlineID { get; set; } = -1;
 
             public string Name => $@"{nameof(APIRuleset)} (ID: {OnlineID})";
-            public string ShortName => nameof(APIRuleset);
+
+            public string ShortName
+            {
+                get
+                {
+                    // TODO: this should really not exist.
+                    switch (OnlineID)
+                    {
+                        case 0: return "osu";
+
+                        case 1: return "taiko";
+
+                        case 2: return "catch";
+
+                        case 3: return "fruits";
+
+                        default: throw new ArgumentOutOfRangeException();
+                    }
+                }
+            }
+
             public string InstantiationInfo => string.Empty;
 
             public Ruleset CreateInstance() => throw new NotImplementedException();

From 9d0023c750a85c2cc78a6d6d5004f50231916a92 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 17 Feb 2022 21:12:51 +0900
Subject: [PATCH 2967/5547] Fix incorrect mappings

---
 osu.Game/Online/API/Requests/Responses/APIBeatmap.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs b/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs
index c53fab48ae..f5795141c5 100644
--- a/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs
@@ -124,9 +124,9 @@ namespace osu.Game.Online.API.Requests.Responses
 
                         case 1: return "taiko";
 
-                        case 2: return "catch";
+                        case 2: return "fruits";
 
-                        case 3: return "fruits";
+                        case 3: return "mania";
 
                         default: throw new ArgumentOutOfRangeException();
                     }

From 3945cd24ebb84579fe1492c083d820155581f652 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 17 Feb 2022 21:14:49 +0900
Subject: [PATCH 2968/5547] wip

---
 .../Rulesets/Difficulty/DifficultyCalculator.cs    | 14 ++++++++++----
 1 file changed, 10 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs b/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs
index 6b61dd3efb..7d6c235fc1 100644
--- a/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs
+++ b/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs
@@ -15,6 +15,7 @@ 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.Utils;
 
 namespace osu.Game.Rulesets.Difficulty
 {
@@ -122,12 +123,17 @@ namespace osu.Game.Rulesets.Difficulty
         /// <returns>A collection of structures describing the difficulty of the beatmap for each mod combination.</returns>
         public IEnumerable<DifficultyAttributes> CalculateAll(CancellationToken cancellationToken = default)
         {
+            var rulesetInstance = ruleset.CreateInstance();
+
             foreach (var combination in CreateDifficultyAdjustmentModCombinations())
             {
-                if (combination is MultiMod multi)
-                    yield return Calculate(multi.Mods, cancellationToken);
-                else
-                    yield return Calculate(combination.Yield(), cancellationToken);
+                Mod classicMod = rulesetInstance.CreateAllMods().SingleOrDefault(m => m is ModClassic);
+
+                var finalCombination = ModUtils.FlattenMod(combination);
+                if (classicMod != null)
+                    finalCombination = finalCombination.Append(classicMod);
+
+                yield return Calculate(finalCombination.ToArray(), cancellationToken);
             }
         }
 

From 08317b4265c94a6f6b30a6629d002175a7945309 Mon Sep 17 00:00:00 2001
From: OctopuSSX <vladik0701@gmail.com>
Date: Thu, 17 Feb 2022 20:43:36 +0300
Subject: [PATCH 2969/5547] Update ScreenshotManager.cs

---
 osu.Game/Graphics/ScreenshotManager.cs | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/osu.Game/Graphics/ScreenshotManager.cs b/osu.Game/Graphics/ScreenshotManager.cs
index a39d7bfb47..b0f20de685 100644
--- a/osu.Game/Graphics/ScreenshotManager.cs
+++ b/osu.Game/Graphics/ScreenshotManager.cs
@@ -112,6 +112,8 @@ namespace osu.Game.Graphics
                 if (Interlocked.Decrement(ref screenShotTasks) == 0 && cursorVisibility.Value == false)
                     cursorVisibility.Value = true;
 
+                host.GetClipboard()?.SetImage(image);
+
                 string filename = getFilename();
 
                 if (filename == null) return;

From 1abbb9ab39675f4caeba0b9700aa9fb4fd9ca0be Mon Sep 17 00:00:00 2001
From: dekrain <dawidkrainski8@gmail.com>
Date: Thu, 17 Feb 2022 21:26:59 +0100
Subject: [PATCH 2970/5547] Align the bar to be on baseline of score components
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>
---
 .../Online/Leaderboards/LeaderboardScore.cs   | 21 +++++++++++--------
 1 file changed, 12 insertions(+), 9 deletions(-)

diff --git a/osu.Game/Online/Leaderboards/LeaderboardScore.cs b/osu.Game/Online/Leaderboards/LeaderboardScore.cs
index 8cfba68ea6..4f7670f098 100644
--- a/osu.Game/Online/Leaderboards/LeaderboardScore.cs
+++ b/osu.Game/Online/Leaderboards/LeaderboardScore.cs
@@ -160,8 +160,8 @@ namespace osu.Game.Online.Leaderboards
                                         },
                                         new FillFlowContainer
                                         {
-                                            Origin = Anchor.BottomLeft,
                                             Anchor = Anchor.BottomLeft,
+                                            Origin = Anchor.BottomLeft,
                                             AutoSizeAxes = Axes.Both,
                                             Direction = FillDirection.Horizontal,
                                             Spacing = new Vector2(10f, 0f),
@@ -169,29 +169,32 @@ namespace osu.Game.Online.Leaderboards
                                             {
                                                 flagBadgeAndDateContainer = new FillFlowContainer
                                                 {
-                                                    Origin = Anchor.BottomLeft,
-                                                    Anchor = Anchor.BottomLeft,
+                                                    Anchor = Anchor.CentreLeft,
+                                                    Origin = Anchor.CentreLeft,
+                                                    RelativeSizeAxes = Axes.Y,
                                                     Direction = FillDirection.Horizontal,
                                                     Spacing = new Vector2(5f, 0f),
-                                                    Size = new Vector2(87f, 20f),
+                                                    Width = 87f,
                                                     Masking = true,
                                                     Children = new Drawable[]
                                                     {
                                                         new UpdateableFlag(user.Country)
                                                         {
-                                                            Width = 30,
-                                                            RelativeSizeAxes = Axes.Y,
+                                                            Anchor = Anchor.CentreLeft,
+                                                            Origin = Anchor.CentreLeft,
+                                                            Size = new Vector2(30f, 20f),
                                                         },
                                                         new DateLabel(Score.Date)
                                                         {
-                                                            RelativeSizeAxes = Axes.Y,
+                                                            Anchor = Anchor.CentreLeft,
+                                                            Origin = Anchor.CentreLeft,
                                                         },
                                                     },
                                                 },
                                                 new FillFlowContainer
                                                 {
-                                                    Origin = Anchor.BottomLeft,
-                                                    Anchor = Anchor.BottomLeft,
+                                                    Origin = Anchor.CentreLeft,
+                                                    Anchor = Anchor.CentreLeft,
                                                     AutoSizeAxes = Axes.Both,
                                                     Direction = FillDirection.Horizontal,
                                                     Margin = new MarginPadding { Left = edge_margin },

From 98aaf83177ee1cb8777619936e31926b2167b399 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 18 Feb 2022 15:57:37 +0900
Subject: [PATCH 2971/5547] Add a centralised constant for the osu URL schema
 protocol

---
 osu.Game.Tests/Chat/MessageFormatterTests.cs      | 12 ++++++------
 osu.Game.Tests/Visual/Online/TestSceneChatLink.cs |  4 ++--
 osu.Game/Online/Chat/MessageFormatter.cs          |  4 ++--
 osu.Game/OsuGameBase.cs                           |  2 ++
 4 files changed, 12 insertions(+), 10 deletions(-)

diff --git a/osu.Game.Tests/Chat/MessageFormatterTests.cs b/osu.Game.Tests/Chat/MessageFormatterTests.cs
index 8def8005f1..cea4d510c1 100644
--- a/osu.Game.Tests/Chat/MessageFormatterTests.cs
+++ b/osu.Game.Tests/Chat/MessageFormatterTests.cs
@@ -409,26 +409,26 @@ namespace osu.Game.Tests.Chat
 
             Assert.AreEqual(result.Content, result.DisplayContent);
             Assert.AreEqual(2, result.Links.Count);
-            Assert.AreEqual("osu://chan/#english", result.Links[0].Url);
-            Assert.AreEqual("osu://chan/#japanese", result.Links[1].Url);
+            Assert.AreEqual($"{OsuGameBase.OSU_PROTOCOL}chan/#english", result.Links[0].Url);
+            Assert.AreEqual($"{OsuGameBase.OSU_PROTOCOL}chan/#japanese", result.Links[1].Url);
         }
 
         [Test]
         public void TestOsuProtocol()
         {
-            Message result = MessageFormatter.FormatMessage(new Message { Content = "This is a custom protocol osu://chan/#english." });
+            Message result = MessageFormatter.FormatMessage(new Message { Content = $"This is a custom protocol {OsuGameBase.OSU_PROTOCOL}chan/#english." });
 
             Assert.AreEqual(result.Content, result.DisplayContent);
             Assert.AreEqual(1, result.Links.Count);
-            Assert.AreEqual("osu://chan/#english", result.Links[0].Url);
+            Assert.AreEqual($"{OsuGameBase.OSU_PROTOCOL}chan/#english", result.Links[0].Url);
             Assert.AreEqual(26, result.Links[0].Index);
             Assert.AreEqual(19, result.Links[0].Length);
 
-            result = MessageFormatter.FormatMessage(new Message { Content = "This is a [custom protocol](osu://chan/#english)." });
+            result = MessageFormatter.FormatMessage(new Message { Content = $"This is a [custom protocol]({OsuGameBase.OSU_PROTOCOL}chan/#english)." });
 
             Assert.AreEqual("This is a custom protocol.", result.DisplayContent);
             Assert.AreEqual(1, result.Links.Count);
-            Assert.AreEqual("osu://chan/#english", result.Links[0].Url);
+            Assert.AreEqual($"{OsuGameBase.OSU_PROTOCOL}chan/#english", result.Links[0].Url);
             Assert.AreEqual("#english", result.Links[0].Argument);
             Assert.AreEqual(10, result.Links[0].Index);
             Assert.AreEqual(15, result.Links[0].Length);
diff --git a/osu.Game.Tests/Visual/Online/TestSceneChatLink.cs b/osu.Game.Tests/Visual/Online/TestSceneChatLink.cs
index 12b5f64559..d077868175 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneChatLink.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneChatLink.cs
@@ -87,8 +87,8 @@ namespace osu.Game.Tests.Visual.Online
             addMessageWithChecks("likes to post this [https://dev.ppy.sh/home link].", 1, true, true, expectedActions: LinkAction.External);
             addMessageWithChecks("Join my multiplayer game osump://12346.", 1, expectedActions: LinkAction.JoinMultiplayerMatch);
             addMessageWithChecks("Join my [multiplayer game](osump://12346).", 1, expectedActions: LinkAction.JoinMultiplayerMatch);
-            addMessageWithChecks("Join my [#english](osu://chan/#english).", 1, expectedActions: LinkAction.OpenChannel);
-            addMessageWithChecks("Join my osu://chan/#english.", 1, expectedActions: LinkAction.OpenChannel);
+            addMessageWithChecks($"Join my [#english]({OsuGameBase.OSU_PROTOCOL}chan/#english).", 1, expectedActions: LinkAction.OpenChannel);
+            addMessageWithChecks($"Join my {OsuGameBase.OSU_PROTOCOL}chan/#english.", 1, expectedActions: LinkAction.OpenChannel);
             addMessageWithChecks("Join my #english or #japanese channels.", 2, expectedActions: new[] { LinkAction.OpenChannel, LinkAction.OpenChannel });
             addMessageWithChecks("Join my #english or #nonexistent #hashtag channels.", 1, expectedActions: LinkAction.OpenChannel);
 
diff --git a/osu.Game/Online/Chat/MessageFormatter.cs b/osu.Game/Online/Chat/MessageFormatter.cs
index d7974004b1..4c477d58b6 100644
--- a/osu.Game/Online/Chat/MessageFormatter.cs
+++ b/osu.Game/Online/Chat/MessageFormatter.cs
@@ -269,10 +269,10 @@ namespace osu.Game.Online.Chat
             handleAdvanced(advanced_link_regex, result, startIndex);
 
             // handle editor times
-            handleMatches(time_regex, "{0}", "osu://edit/{0}", result, startIndex, LinkAction.OpenEditorTimestamp);
+            handleMatches(time_regex, "{0}", $"{OsuGameBase.OSU_PROTOCOL}edit/{0}", result, startIndex, LinkAction.OpenEditorTimestamp);
 
             // handle channels
-            handleMatches(channel_regex, "{0}", "osu://chan/{0}", result, startIndex, LinkAction.OpenChannel);
+            handleMatches(channel_regex, "{0}", $"{OsuGameBase.OSU_PROTOCOL}chan/{0}", result, startIndex, LinkAction.OpenChannel);
 
             string empty = "";
             while (space-- > 0)
diff --git a/osu.Game/OsuGameBase.cs b/osu.Game/OsuGameBase.cs
index 0b2644d5ba..86390e7630 100644
--- a/osu.Game/OsuGameBase.cs
+++ b/osu.Game/OsuGameBase.cs
@@ -52,6 +52,8 @@ namespace osu.Game
     /// </summary>
     public partial class OsuGameBase : Framework.Game, ICanAcceptFiles
     {
+        public const string OSU_PROTOCOL = "osu://";
+
         public const string CLIENT_STREAM_NAME = @"lazer";
 
         public const int SAMPLE_CONCURRENCY = 6;

From 29c5683ba3ce2e7de362cac68949b3a46424cd12 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 18 Feb 2022 16:06:38 +0900
Subject: [PATCH 2972/5547] Add handling of beatmap links on startup

---
 .../TestSceneStartupBeatmapDisplay.cs         | 22 ++++++++++++
 .../TestSceneStartupBeatmapSetDisplay.cs      | 22 ++++++++++++
 osu.Game/OsuGame.cs                           | 36 ++++++++++++++++++-
 3 files changed, 79 insertions(+), 1 deletion(-)
 create mode 100644 osu.Game.Tests/Visual/Navigation/TestSceneStartupBeatmapDisplay.cs
 create mode 100644 osu.Game.Tests/Visual/Navigation/TestSceneStartupBeatmapSetDisplay.cs

diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneStartupBeatmapDisplay.cs b/osu.Game.Tests/Visual/Navigation/TestSceneStartupBeatmapDisplay.cs
new file mode 100644
index 0000000000..1efa24435e
--- /dev/null
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneStartupBeatmapDisplay.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 System.Linq;
+using NUnit.Framework;
+using osu.Framework.Graphics.Containers;
+using osu.Framework.Testing;
+using osu.Game.Overlays;
+
+namespace osu.Game.Tests.Visual.Navigation
+{
+    public class TestSceneStartupBeatmapDisplay : OsuGameTestScene
+    {
+        protected override TestOsuGame CreateTestGame() => new TestOsuGame(LocalStorage, API, new[] { "osu://b/75" });
+
+        [Test]
+        public void TestBeatmapLink()
+        {
+            AddUntilStep("Beatmap overlay displayed", () => Game.ChildrenOfType<BeatmapSetOverlay>().FirstOrDefault()?.State.Value == Visibility.Visible);
+        }
+    }
+}
diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneStartupBeatmapSetDisplay.cs b/osu.Game.Tests/Visual/Navigation/TestSceneStartupBeatmapSetDisplay.cs
new file mode 100644
index 0000000000..1339c514e4
--- /dev/null
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneStartupBeatmapSetDisplay.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 System.Linq;
+using NUnit.Framework;
+using osu.Framework.Graphics.Containers;
+using osu.Framework.Testing;
+using osu.Game.Overlays;
+
+namespace osu.Game.Tests.Visual.Navigation
+{
+    public class TestSceneStartupBeatmapSetDisplay : OsuGameTestScene
+    {
+        protected override TestOsuGame CreateTestGame() => new TestOsuGame(LocalStorage, API, new[] { "osu://s/1" });
+
+        [Test]
+        public void TestBeatmapSetLink()
+        {
+            AddUntilStep("Beatmap overlay displayed", () => Game.ChildrenOfType<BeatmapSetOverlay>().FirstOrDefault()?.State.Value == Visibility.Visible);
+        }
+    }
+}
diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index 5b58dec0c3..390e96d768 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -150,6 +150,7 @@ namespace osu.Game
         protected SettingsOverlay Settings;
 
         private VolumeOverlay volume;
+
         private OsuLogo osuLogo;
 
         private MainMenu menuScreen;
@@ -898,8 +899,41 @@ namespace osu.Game
             if (args?.Length > 0)
             {
                 string[] paths = args.Where(a => !a.StartsWith('-')).ToArray();
+
                 if (paths.Length > 0)
-                    Task.Run(() => Import(paths));
+                {
+                    string firstPath = paths.First();
+
+                    if (firstPath.StartsWith(OSU_PROTOCOL, StringComparison.Ordinal))
+                    {
+                        handleOsuProtocolUrl(firstPath);
+                    }
+                    else
+                    {
+                        Task.Run(() => Import(paths));
+                    }
+                }
+            }
+        }
+
+        private void handleOsuProtocolUrl(string url)
+        {
+            if (!url.StartsWith(OSU_PROTOCOL, StringComparison.Ordinal))
+                throw new ArgumentException("Invalid osu URL provided.", nameof(url));
+
+            string[] pieces = url.Split('/');
+
+            switch (pieces[2])
+            {
+                case "s":
+                    if (int.TryParse(pieces[3], out int beatmapSetId))
+                        ShowBeatmapSet(beatmapSetId);
+                    break;
+
+                case "b":
+                    if (int.TryParse(pieces[3], out int beatmapId))
+                        ShowBeatmap(beatmapId);
+                    break;
             }
         }
 

From e49da2948d15d4d175d3de7ca7e47656e85e41b9 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 18 Feb 2022 16:24:18 +0900
Subject: [PATCH 2973/5547] Fix storyboard background replacement logic not
 working for beatmaps with multiple backgrounds

In the case where the background image of individual difficulties is
different, querying the beatmap *set*'s metadata as we were will cause
issues.

I haven't added test coverage for this but can if required. Can be
manually tested using https://osu.ppy.sh/beatmapsets/1595773#osu/3377474
(specifically the highest difficulty).

Closes https://github.com/ppy/osu/discussions/16873.
---
 osu.Game/Storyboards/Storyboard.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Storyboards/Storyboard.cs b/osu.Game/Storyboards/Storyboard.cs
index b86deeab89..c4864c0334 100644
--- a/osu.Game/Storyboards/Storyboard.cs
+++ b/osu.Game/Storyboards/Storyboard.cs
@@ -78,7 +78,7 @@ namespace osu.Game.Storyboards
         {
             get
             {
-                string backgroundPath = BeatmapInfo.BeatmapSet?.Metadata.BackgroundFile;
+                string backgroundPath = BeatmapInfo.Metadata.BackgroundFile;
 
                 if (string.IsNullOrEmpty(backgroundPath))
                     return false;

From 420e2c538f01b1a1f387b7401a39d828698f83aa Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 18 Feb 2022 16:48:30 +0900
Subject: [PATCH 2974/5547] Automatically use an `AssemblyRulesetStore` if no
 custom store is registered

---
 osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs b/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
index 9626f39ec3..9dd2f27be5 100644
--- a/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
+++ b/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
@@ -7,6 +7,7 @@ using System.IO;
 using System.Linq;
 using osu.Framework.Extensions;
 using osu.Framework.Extensions.EnumExtensions;
+using osu.Framework.Logging;
 using osu.Game.Beatmaps.ControlPoints;
 using osu.Game.Beatmaps.Legacy;
 using osu.Game.Beatmaps.Timing;
@@ -44,7 +45,10 @@ namespace osu.Game.Beatmaps.Formats
             : base(version)
         {
             if (RulesetStore == null)
-                throw new InvalidOperationException($"Call {nameof(Decoder)}.{nameof(RegisterDependencies)} before using {nameof(LegacyBeatmapDecoder)}.");
+            {
+                Logger.Log($"A {nameof(RulesetStore)} was not provided via {nameof(Decoder)}.{nameof(RegisterDependencies)}; falling back to default {nameof(AssemblyRulesetStore)}.");
+                RulesetStore = new AssemblyRulesetStore();
+            }
 
             // BeatmapVersion 4 and lower had an incorrect offset (stable has this set as 24ms off)
             offset = FormatVersion < 5 ? 24 : 0;

From cf1dd1ebd3fd4b849ed5249017363949f2112ea7 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 18 Feb 2022 16:48:42 +0900
Subject: [PATCH 2975/5547] Disallow registering a null `RulesetStore`

---
 osu.Game/Beatmaps/Formats/Decoder.cs | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Beatmaps/Formats/Decoder.cs b/osu.Game/Beatmaps/Formats/Decoder.cs
index 8eb238a184..c1537d7240 100644
--- a/osu.Game/Beatmaps/Formats/Decoder.cs
+++ b/osu.Game/Beatmaps/Formats/Decoder.cs
@@ -5,6 +5,7 @@ using System;
 using System.Collections.Generic;
 using System.IO;
 using System.Linq;
+using JetBrains.Annotations;
 using osu.Game.IO;
 using osu.Game.Rulesets;
 
@@ -42,9 +43,9 @@ namespace osu.Game.Beatmaps.Formats
         /// Register dependencies for use with static decoder classes.
         /// </summary>
         /// <param name="rulesets">A store containing all available rulesets (used by <see cref="LegacyBeatmapDecoder"/>).</param>
-        public static void RegisterDependencies(RulesetStore rulesets)
+        public static void RegisterDependencies([NotNull] RulesetStore rulesets)
         {
-            LegacyBeatmapDecoder.RulesetStore = rulesets;
+            LegacyBeatmapDecoder.RulesetStore = rulesets ?? throw new ArgumentNullException(nameof(rulesets));
         }
 
         /// <summary>

From 3abbf07fb3391d13e617409e1bfe16b5919243d3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 18 Feb 2022 16:52:14 +0900
Subject: [PATCH 2976/5547] Revert local registrations in test scenes

---
 osu.Game.Benchmarks/BenchmarkBeatmapParsing.cs             | 3 ---
 osu.Game.Rulesets.Osu.Tests/StackingTest.cs                | 6 ------
 .../Beatmaps/Formats/LegacyBeatmapDecoderTest.cs           | 7 -------
 osu.Game.Tests/Beatmaps/Formats/OsuJsonDecoderTest.cs      | 7 -------
 osu.Game.Tests/Beatmaps/IO/OszArchiveReaderTest.cs         | 7 -------
 osu.Game.Tests/Editing/LegacyEditorBeatmapPatcherTest.cs   | 3 ---
 osu.Game/Tests/Beatmaps/BeatmapConversionTest.cs           | 6 ------
 osu.Game/Tests/Beatmaps/DifficultyCalculatorTest.cs        | 6 ------
 8 files changed, 45 deletions(-)

diff --git a/osu.Game.Benchmarks/BenchmarkBeatmapParsing.cs b/osu.Game.Benchmarks/BenchmarkBeatmapParsing.cs
index 0dd66be0b4..1d207d04c7 100644
--- a/osu.Game.Benchmarks/BenchmarkBeatmapParsing.cs
+++ b/osu.Game.Benchmarks/BenchmarkBeatmapParsing.cs
@@ -8,7 +8,6 @@ using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.Formats;
 using osu.Game.IO;
 using osu.Game.IO.Archives;
-using osu.Game.Rulesets;
 using osu.Game.Tests.Resources;
 
 namespace osu.Game.Benchmarks
@@ -19,8 +18,6 @@ namespace osu.Game.Benchmarks
 
         public override void SetUp()
         {
-            Decoder.RegisterDependencies(new AssemblyRulesetStore());
-
             using (var resources = new DllResourceStore(typeof(TestResources).Assembly))
             using (var archive = resources.GetStream("Resources/Archives/241526 Soleily - Renatus.osz"))
             using (var reader = new ZipArchiveReader(archive))
diff --git a/osu.Game.Rulesets.Osu.Tests/StackingTest.cs b/osu.Game.Rulesets.Osu.Tests/StackingTest.cs
index 927c0c3e1e..871afdb09d 100644
--- a/osu.Game.Rulesets.Osu.Tests/StackingTest.cs
+++ b/osu.Game.Rulesets.Osu.Tests/StackingTest.cs
@@ -18,12 +18,6 @@ namespace osu.Game.Rulesets.Osu.Tests
     [TestFixture]
     public class StackingTest
     {
-        [SetUp]
-        public void SetUp()
-        {
-            Decoder.RegisterDependencies(new AssemblyRulesetStore());
-        }
-
         [Test]
         public void TestStacking()
         {
diff --git a/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs b/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs
index ad088d298b..468cb7683c 100644
--- a/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs
+++ b/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs
@@ -11,7 +11,6 @@ using osu.Game.Beatmaps.Formats;
 using osu.Game.Beatmaps.Legacy;
 using osu.Game.Beatmaps.Timing;
 using osu.Game.IO;
-using osu.Game.Rulesets;
 using osu.Game.Rulesets.Catch;
 using osu.Game.Rulesets.Catch.Beatmaps;
 using osu.Game.Rulesets.Mods;
@@ -30,12 +29,6 @@ namespace osu.Game.Tests.Beatmaps.Formats
     [TestFixture]
     public class LegacyBeatmapDecoderTest
     {
-        [SetUp]
-        public void SetUp()
-        {
-            Decoder.RegisterDependencies(new AssemblyRulesetStore());
-        }
-
         [Test]
         public void TestDecodeBeatmapVersion()
         {
diff --git a/osu.Game.Tests/Beatmaps/Formats/OsuJsonDecoderTest.cs b/osu.Game.Tests/Beatmaps/Formats/OsuJsonDecoderTest.cs
index b7989adcb8..2eb75259d9 100644
--- a/osu.Game.Tests/Beatmaps/Formats/OsuJsonDecoderTest.cs
+++ b/osu.Game.Tests/Beatmaps/Formats/OsuJsonDecoderTest.cs
@@ -10,7 +10,6 @@ using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.Formats;
 using osu.Game.IO;
 using osu.Game.IO.Serialization;
-using osu.Game.Rulesets;
 using osu.Game.Rulesets.Objects.Types;
 using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Osu.Beatmaps;
@@ -23,12 +22,6 @@ namespace osu.Game.Tests.Beatmaps.Formats
     [TestFixture]
     public class OsuJsonDecoderTest
     {
-        [SetUp]
-        public void SetUp()
-        {
-            Decoder.RegisterDependencies(new AssemblyRulesetStore());
-        }
-
         private const string normal = "Soleily - Renatus (Gamu) [Insane].osu";
         private const string marathon = "Within Temptation - The Unforgiving (Armin) [Marathon].osu";
         private const string with_sb = "Kozato snow - Rengetsu Ouka (_Kiva) [Yuki YukI].osu";
diff --git a/osu.Game.Tests/Beatmaps/IO/OszArchiveReaderTest.cs b/osu.Game.Tests/Beatmaps/IO/OszArchiveReaderTest.cs
index 64a52b2b01..810ea5dbd0 100644
--- a/osu.Game.Tests/Beatmaps/IO/OszArchiveReaderTest.cs
+++ b/osu.Game.Tests/Beatmaps/IO/OszArchiveReaderTest.cs
@@ -9,19 +9,12 @@ using osu.Game.Tests.Resources;
 using osu.Game.Beatmaps.Formats;
 using osu.Game.IO;
 using osu.Game.IO.Archives;
-using osu.Game.Rulesets;
 
 namespace osu.Game.Tests.Beatmaps.IO
 {
     [TestFixture]
     public class OszArchiveReaderTest
     {
-        [SetUp]
-        public void SetUp()
-        {
-            Decoder.RegisterDependencies(new AssemblyRulesetStore());
-        }
-
         [Test]
         public void TestReadBeatmaps()
         {
diff --git a/osu.Game.Tests/Editing/LegacyEditorBeatmapPatcherTest.cs b/osu.Game.Tests/Editing/LegacyEditorBeatmapPatcherTest.cs
index 6cf760723a..44a908b756 100644
--- a/osu.Game.Tests/Editing/LegacyEditorBeatmapPatcherTest.cs
+++ b/osu.Game.Tests/Editing/LegacyEditorBeatmapPatcherTest.cs
@@ -8,7 +8,6 @@ using osu.Game.Audio;
 using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.Formats;
 using osu.Game.IO;
-using osu.Game.Rulesets;
 using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Objects.Types;
 using osu.Game.Rulesets.Osu;
@@ -29,8 +28,6 @@ namespace osu.Game.Tests.Editing
         [SetUp]
         public void Setup()
         {
-            Decoder.RegisterDependencies(new AssemblyRulesetStore());
-
             patcher = new LegacyEditorBeatmapPatcher(current = new EditorBeatmap(new OsuBeatmap
             {
                 BeatmapInfo =
diff --git a/osu.Game/Tests/Beatmaps/BeatmapConversionTest.cs b/osu.Game/Tests/Beatmaps/BeatmapConversionTest.cs
index d5b7e3152b..8d622955b7 100644
--- a/osu.Game/Tests/Beatmaps/BeatmapConversionTest.cs
+++ b/osu.Game/Tests/Beatmaps/BeatmapConversionTest.cs
@@ -34,12 +34,6 @@ namespace osu.Game.Tests.Beatmaps
 
         protected abstract string ResourceAssembly { get; }
 
-        [SetUp]
-        public void Setup()
-        {
-            Decoder.RegisterDependencies(new AssemblyRulesetStore());
-        }
-
         protected void Test(string name, params Type[] mods)
         {
             var ourResult = convert(name, mods.Select(m => (Mod)Activator.CreateInstance(m)).ToArray());
diff --git a/osu.Game/Tests/Beatmaps/DifficultyCalculatorTest.cs b/osu.Game/Tests/Beatmaps/DifficultyCalculatorTest.cs
index 78b2558640..9f8811c7f9 100644
--- a/osu.Game/Tests/Beatmaps/DifficultyCalculatorTest.cs
+++ b/osu.Game/Tests/Beatmaps/DifficultyCalculatorTest.cs
@@ -22,12 +22,6 @@ namespace osu.Game.Tests.Beatmaps
 
         protected abstract string ResourceAssembly { get; }
 
-        [SetUp]
-        public void Setup()
-        {
-            Decoder.RegisterDependencies(new AssemblyRulesetStore());
-        }
-
         protected void Test(double expected, string name, params Mod[] mods)
         {
             // Platform-dependent math functions (Pow, Cbrt, Exp, etc) may result in minute differences.

From a029e418cfef55371f956f3b4e39be6126596e99 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 18 Feb 2022 17:06:04 +0900
Subject: [PATCH 2977/5547] Use `internal` instead of `protected internal`

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

diff --git a/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs b/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
index 9dd2f27be5..e2a043490f 100644
--- a/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
+++ b/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
@@ -19,7 +19,7 @@ namespace osu.Game.Beatmaps.Formats
 {
     public class LegacyBeatmapDecoder : LegacyDecoder<Beatmap>
     {
-        protected internal static RulesetStore RulesetStore;
+        internal static RulesetStore RulesetStore;
 
         private Beatmap beatmap;
 

From c869be87d1c817af8a4ae5382d5c17e124fb40ae Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 19 Feb 2022 20:53:04 +0900
Subject: [PATCH 2978/5547] Update `FlatFileWorkingBeatmap` to not require a
 ruleset store

---
 osu.Desktop/LegacyIpc/LegacyTcpIpcProvider.cs | 5 ++---
 osu.Game/Beatmaps/FlatFileWorkingBeatmap.cs   | 9 +++------
 2 files changed, 5 insertions(+), 9 deletions(-)

diff --git a/osu.Desktop/LegacyIpc/LegacyTcpIpcProvider.cs b/osu.Desktop/LegacyIpc/LegacyTcpIpcProvider.cs
index 97a4c57bf0..10761bc315 100644
--- a/osu.Desktop/LegacyIpc/LegacyTcpIpcProvider.cs
+++ b/osu.Desktop/LegacyIpc/LegacyTcpIpcProvider.cs
@@ -77,10 +77,9 @@ namespace osu.Desktop.LegacyIpc
                 case LegacyIpcDifficultyCalculationRequest req:
                     try
                     {
-                        var ruleset = getLegacyRulesetFromID(req.RulesetId);
-
+                        WorkingBeatmap beatmap = new FlatFileWorkingBeatmap(req.BeatmapFile);
+                        var ruleset = beatmap.BeatmapInfo.Ruleset.CreateInstance();
                         Mod[] mods = ruleset.ConvertFromLegacyMods((LegacyMods)req.Mods).ToArray();
-                        WorkingBeatmap beatmap = new FlatFileWorkingBeatmap(req.BeatmapFile, _ => ruleset);
 
                         return new LegacyIpcDifficultyCalculationResponse
                         {
diff --git a/osu.Game/Beatmaps/FlatFileWorkingBeatmap.cs b/osu.Game/Beatmaps/FlatFileWorkingBeatmap.cs
index 163da12b2e..cd8aa31ead 100644
--- a/osu.Game/Beatmaps/FlatFileWorkingBeatmap.cs
+++ b/osu.Game/Beatmaps/FlatFileWorkingBeatmap.cs
@@ -7,7 +7,6 @@ using osu.Framework.Audio.Track;
 using osu.Framework.Graphics.Textures;
 using osu.Game.Beatmaps.Formats;
 using osu.Game.IO;
-using osu.Game.Rulesets;
 using osu.Game.Skinning;
 
 namespace osu.Game.Beatmaps
@@ -20,18 +19,16 @@ namespace osu.Game.Beatmaps
     {
         private readonly Beatmap beatmap;
 
-        public FlatFileWorkingBeatmap(string file, Func<int, Ruleset> rulesetProvider, int? beatmapId = null)
-            : this(readFromFile(file), rulesetProvider, beatmapId)
+        public FlatFileWorkingBeatmap(string file, int? beatmapId = null)
+            : this(readFromFile(file), beatmapId)
         {
         }
 
-        private FlatFileWorkingBeatmap(Beatmap beatmap, Func<int, Ruleset> rulesetProvider, int? beatmapId = null)
+        private FlatFileWorkingBeatmap(Beatmap beatmap, int? beatmapId = null)
             : base(beatmap.BeatmapInfo, null)
         {
             this.beatmap = beatmap;
 
-            beatmap.BeatmapInfo.Ruleset = rulesetProvider(beatmap.BeatmapInfo.Ruleset.OnlineID).RulesetInfo;
-
             if (beatmapId.HasValue)
                 beatmap.BeatmapInfo.OnlineID = beatmapId.Value;
         }

From 7ef710de2205e1af671fa5f4f0af76efc16373c5 Mon Sep 17 00:00:00 2001
From: Susko3 <16479013+Susko3@users.noreply.github.com>
Date: Sat, 19 Feb 2022 18:14:56 +0100
Subject: [PATCH 2979/5547] Allow exiting/minimizing on Android when on the
 initial cookie screen

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

diff --git a/osu.Game/Screens/Menu/MainMenu.cs b/osu.Game/Screens/Menu/MainMenu.cs
index 8b1bab52b3..2391903861 100644
--- a/osu.Game/Screens/Menu/MainMenu.cs
+++ b/osu.Game/Screens/Menu/MainMenu.cs
@@ -70,12 +70,16 @@ namespace osu.Game.Screens.Menu
         private ParallaxContainer buttonsContainer;
         private SongTicker songTicker;
 
+        private readonly BindableBool allowExitingAndroid = new BindableBool(true);
+
         [BackgroundDependencyLoader(true)]
         private void load(BeatmapListingOverlay beatmapListing, SettingsOverlay settings, OsuConfigManager config, SessionStatics statics)
         {
             holdDelay = config.GetBindable<float>(OsuSetting.UIHoldActivationDelay);
             loginDisplayed = statics.GetBindable<bool>(Static.LoginOverlayDisplayed);
 
+            host.AllowExitingAndroid.AddSource(allowExitingAndroid);
+
             if (host.CanExit)
             {
                 AddInternal(exitConfirmOverlay = new ExitConfirmOverlay
@@ -134,6 +138,8 @@ namespace osu.Game.Screens.Menu
                         ApplyToBackground(b => b.FadeColour(OsuColour.Gray(0.8f), 500, Easing.OutSine));
                         break;
                 }
+
+                allowExitingAndroid.Value = state == ButtonSystemState.Initial;
             };
 
             buttons.OnSettings = () => settings?.ToggleVisibility();
@@ -297,5 +303,11 @@ namespace osu.Game.Screens.Menu
 
             Schedule(loadSoloSongSelect);
         }
+
+        protected override void Dispose(bool isDisposing)
+        {
+            host.AllowExitingAndroid.RemoveSource(allowExitingAndroid);
+            base.Dispose(isDisposing);
+        }
     }
 }

From 11a11802edf98e666b25182e6740c31bc9c13981 Mon Sep 17 00:00:00 2001
From: Susko3 <16479013+Susko3@users.noreply.github.com>
Date: Sat, 19 Feb 2022 19:28:17 +0100
Subject: [PATCH 2980/5547] Ensure exiting is disallowed if we're not at the
 main menu

---
 osu.Android/OsuGameAndroid.cs | 35 +++++++++++++++++++++++++++++++++++
 1 file changed, 35 insertions(+)

diff --git a/osu.Android/OsuGameAndroid.cs b/osu.Android/OsuGameAndroid.cs
index 050bf2b787..914a6f7502 100644
--- a/osu.Android/OsuGameAndroid.cs
+++ b/osu.Android/OsuGameAndroid.cs
@@ -5,7 +5,11 @@ using System;
 using Android.App;
 using Android.OS;
 using osu.Framework.Allocation;
+using osu.Framework.Bindables;
+using osu.Framework.Platform;
+using osu.Framework.Screens;
 using osu.Game;
+using osu.Game.Screens.Menu;
 using osu.Game.Updater;
 using osu.Game.Utils;
 using Xamarin.Essentials;
@@ -17,6 +21,8 @@ namespace osu.Android
         [Cached]
         private readonly OsuGameActivity gameActivity;
 
+        private readonly BindableBool allowExiting = new BindableBool();
+
         public OsuGameAndroid(OsuGameActivity activity)
             : base(null)
         {
@@ -67,16 +73,45 @@ namespace osu.Android
             }
         }
 
+        public override void SetHost(GameHost host)
+        {
+            base.SetHost(host);
+            host.AllowExitingAndroid.AddSource(allowExiting);
+        }
+
         protected override void LoadComplete()
         {
             base.LoadComplete();
             LoadComponentAsync(new GameplayScreenRotationLocker(), Add);
         }
 
+        protected override void ScreenChanged(IScreen current, IScreen newScreen)
+        {
+            base.ScreenChanged(current, newScreen);
+
+            switch (newScreen)
+            {
+                case MainMenu _:
+                    // allow the MainMenu to (dis)allow exiting based on its ButtonSystemState.
+                    allowExiting.Value = true;
+                    break;
+
+                default:
+                    allowExiting.Value = false;
+                    break;
+            }
+        }
+
         protected override UpdateManager CreateUpdateManager() => new SimpleUpdateManager();
 
         protected override BatteryInfo CreateBatteryInfo() => new AndroidBatteryInfo();
 
+        protected override void Dispose(bool isDisposing)
+        {
+            Host.AllowExitingAndroid.RemoveSource(allowExiting);
+            base.Dispose(isDisposing);
+        }
+
         private class AndroidBatteryInfo : BatteryInfo
         {
             public override double ChargeLevel => Battery.ChargeLevel;

From 15ed9ec4fa725f08c6e49ca0192542f2b7aee6ac Mon Sep 17 00:00:00 2001
From: dekrain <dawidkrainski8@gmail.com>
Date: Sat, 19 Feb 2022 20:47:02 +0100
Subject: [PATCH 2981/5547] Merge scoreboard and leaderboard implementations
 together

---
 .../SongSelect/TestSceneBeatmapLeaderboard.cs |  2 +
 .../Online/Leaderboards/LeaderboardScore.cs   | 23 +------
 .../BeatmapSet/Scores/ScoreboardTime.cs       | 40 +----------
 osu.Game/Utils/ScoreboardTimeUtils.cs         | 66 +++++++++++++++++++
 4 files changed, 73 insertions(+), 58 deletions(-)
 create mode 100644 osu.Game/Utils/ScoreboardTimeUtils.cs

diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
index 2f44633f4d..c4178143f8 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
@@ -388,6 +388,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                     Accuracy = 0.5140,
                     MaxCombo = 244,
                     TotalScore = 1707827,
+                    Date = DateTime.Now.AddMonths(-3),
                     Mods = new Mod[] { new OsuModHidden(), new OsuModHardRock(), },
                     BeatmapInfo = beatmapInfo,
                     Ruleset = new OsuRuleset().RulesetInfo,
@@ -409,6 +410,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                     Accuracy = 0.4222,
                     MaxCombo = 244,
                     TotalScore = 1707827,
+                    Date = DateTime.Now.AddYears(-2),
                     Mods = new Mod[] { new OsuModHidden(), new OsuModHardRock(), },
                     BeatmapInfo = beatmapInfo,
                     Ruleset = new OsuRuleset().RulesetInfo,
diff --git a/osu.Game/Online/Leaderboards/LeaderboardScore.cs b/osu.Game/Online/Leaderboards/LeaderboardScore.cs
index 4f7670f098..faec0abce6 100644
--- a/osu.Game/Online/Leaderboards/LeaderboardScore.cs
+++ b/osu.Game/Online/Leaderboards/LeaderboardScore.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;
@@ -30,7 +30,7 @@ using osuTK;
 using osuTK.Graphics;
 using osu.Game.Online.API;
 using osu.Game.Utils;
-using osu.Game.Resources.Localisation.Web;
+using osu.Framework.Utils;
 
 namespace osu.Game.Online.Leaderboards
 {
@@ -398,24 +398,7 @@ namespace osu.Game.Online.Leaderboards
 
             protected override string Format()
             {
-                var now = DateTime.Now;
-                var difference = now - Date;
-
-                // TODO(optional): support localisation (probably via `CommonStrings.CountHours()` etc.)
-                // requires pluralisable string support framework-side
-
-                if (difference.TotalSeconds < 10)
-                    return CommonStrings.TimeNow.ToString();
-                if (difference.TotalMinutes < 1)
-                    return $@"{Math.Floor(difference.TotalSeconds)}s";
-                if (difference.TotalHours < 1)
-                    return $@"{Math.Floor(difference.TotalMinutes)}min";
-                if (difference.TotalDays < 1)
-                    return $@"{Math.Floor(difference.TotalHours)}h";
-                if (difference.TotalDays < 3)
-                    return $@"{Math.Floor(difference.TotalDays)}d";
-
-                return string.Empty;
+                return ScoreboardTimeUtils.FormatDate(Date, TimeSpan.FromSeconds(30));
             }
         }
 
diff --git a/osu.Game/Overlays/BeatmapSet/Scores/ScoreboardTime.cs b/osu.Game/Overlays/BeatmapSet/Scores/ScoreboardTime.cs
index ff1d3490b4..ceb446f310 100644
--- a/osu.Game/Overlays/BeatmapSet/Scores/ScoreboardTime.cs
+++ b/osu.Game/Overlays/BeatmapSet/Scores/ScoreboardTime.cs
@@ -2,9 +2,8 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
-using Humanizer;
 using osu.Game.Graphics;
-using osu.Game.Resources.Localisation.Web;
+using osu.Game.Utils;
 
 namespace osu.Game.Overlays.BeatmapSet.Scores
 {
@@ -16,41 +15,6 @@ namespace osu.Game.Overlays.BeatmapSet.Scores
         }
 
         protected override string Format()
-        {
-            var now = DateTime.Now;
-            var difference = now - Date;
-
-            // web uses momentjs's custom locales to format the date for the purposes of the scoreboard.
-            // this is intended to be a best-effort, more legible approximation of that.
-            // compare:
-            // * https://github.com/ppy/osu-web/blob/a8f5a68fb435cb19a4faa4c7c4bce08c4f096933/resources/assets/lib/scoreboard-time.tsx
-            // * https://momentjs.com/docs/#/customization/ (reference for the customisation format)
-
-            // TODO: support localisation (probably via `CommonStrings.CountHours()` etc.)
-            // requires pluralisable string support framework-side
-
-            if (difference.TotalHours < 1)
-                return CommonStrings.TimeNow.ToString();
-            if (difference.TotalDays < 1)
-                return "hr".ToQuantity((int)difference.TotalHours);
-
-            // this is where this gets more complicated because of how the calendar works.
-            // since there's no `TotalMonths` / `TotalYears`, we have to iteratively add months/years
-            // and test against cutoff dates to determine how many months/years to show.
-
-            if (Date > now.AddMonths(-1))
-                return difference.TotalDays < 2 ? "1dy" : $"{(int)difference.TotalDays}dys";
-
-            for (int months = 1; months <= 11; ++months)
-            {
-                if (Date > now.AddMonths(-(months + 1)))
-                    return months == 1 ? "1mo" : $"{months}mos";
-            }
-
-            int years = 1;
-            while (Date <= now.AddYears(-(years + 1)))
-                years += 1;
-            return years == 1 ? "1yr" : $"{years}yrs";
-        }
+            => ScoreboardTimeUtils.FormatDate(Date, TimeSpan.FromHours(1));
     }
 }
diff --git a/osu.Game/Utils/ScoreboardTimeUtils.cs b/osu.Game/Utils/ScoreboardTimeUtils.cs
new file mode 100644
index 0000000000..7e84b8f2d0
--- /dev/null
+++ b/osu.Game/Utils/ScoreboardTimeUtils.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 System;
+using osu.Game.Resources.Localisation.Web;
+
+#nullable enable
+
+namespace osu.Game.Utils
+{
+    public static class ScoreboardTimeUtils
+    {
+        public static string FormatQuantity(string template, int quantity)
+        {
+            if (quantity <= 1)
+                return $@"{quantity}{template}";
+            return $@"{quantity}{template}s";
+        }
+
+        public static string FormatDate(DateTimeOffset time, TimeSpan lowerCutoff)
+        {
+            // This function fails if the passed in time is something close to an epoch
+
+            // web uses momentjs's custom locales to format the date for the purposes of the scoreboard.
+            // this is intended to be a best-effort, more legible approximation of that.
+            // compare:
+            // * https://github.com/ppy/osu-web/blob/a8f5a68fb435cb19a4faa4c7c4bce08c4f096933/resources/assets/lib/scoreboard-time.tsx
+            // * https://momentjs.com/docs/#/customization/ (reference for the customisation format)
+
+            // TODO: support localisation (probably via `CommonStrings.CountHours()` etc.)
+            // requires pluralisable string support framework-side
+
+            var now = DateTime.Now;
+            var span = now - time;
+
+            if (span < lowerCutoff)
+                return CommonStrings.TimeNow.ToString();
+
+            if (span.TotalMinutes < 1)
+                return FormatQuantity("sec", (int)span.TotalSeconds);
+            if (span.TotalHours < 1)
+                return FormatQuantity("min", (int)span.TotalMinutes);
+            if (span.TotalDays < 1)
+                return FormatQuantity("hr", (int)span.TotalHours);
+
+            // this is where this gets more complicated because of how the calendar works.
+            // since there's no `TotalMonths` / `TotalYears`, we have to iteratively add months/years
+            // and test against cutoff dates to determine how many months/years to show.
+
+            if (time > now.AddMonths(-1))
+                return FormatQuantity("dy", (int)span.TotalDays);
+
+            for (int months = 1; months <= 11; ++months)
+            {
+                if (time > now.AddMonths(-(months + 1)))
+                    return FormatQuantity("mo", months);
+            }
+
+            int years = 1;
+            // DateTime causes a crash here for epoch
+            while (time <= now.AddYears(-(years + 1)))
+                years += 1;
+            return FormatQuantity("yr", years);
+        }
+    }
+}

From 0d83c5a39a02581c3eb5d702c143ec55c904f461 Mon Sep 17 00:00:00 2001
From: dekrain <dawidkrainski8@gmail.com>
Date: Sat, 19 Feb 2022 20:47:30 +0100
Subject: [PATCH 2982/5547] Add colour highlighting recent scores

---
 osu.Game/Online/Leaderboards/LeaderboardScore.cs | 14 +++++++++++++-
 1 file changed, 13 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Online/Leaderboards/LeaderboardScore.cs b/osu.Game/Online/Leaderboards/LeaderboardScore.cs
index faec0abce6..217be5a024 100644
--- a/osu.Game/Online/Leaderboards/LeaderboardScore.cs
+++ b/osu.Game/Online/Leaderboards/LeaderboardScore.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;
@@ -390,6 +390,9 @@ namespace osu.Game.Online.Leaderboards
 
         private class DateLabel : DrawableDate
         {
+            public static readonly Colour4 COLOUR_SATURATED = Colour4.Lime;
+            public static readonly Colour4 COLOUR_UNSATURATED = Colour4.White;
+
             public DateLabel(DateTimeOffset date)
                 : base(date)
             {
@@ -398,6 +401,15 @@ namespace osu.Game.Online.Leaderboards
 
             protected override string Format()
             {
+                var now = DateTime.Now;
+                var difference = now - Date;
+
+                const double seconds_to_blank = 60*45;
+                const double tense_factor = 2.325;
+
+                double tf = Math.Pow(difference.TotalSeconds / seconds_to_blank, tense_factor);
+                Colour = Interpolation.ValueAt(tf, COLOUR_SATURATED, COLOUR_UNSATURATED, 0, 1);
+
                 return ScoreboardTimeUtils.FormatDate(Date, TimeSpan.FromSeconds(30));
             }
         }

From 31b7ce053d24cef175f3b4b399d1a9e79b86fc32 Mon Sep 17 00:00:00 2001
From: dekrain <dawidkrainski8@gmail.com>
Date: Sat, 19 Feb 2022 21:18:26 +0100
Subject: [PATCH 2983/5547] Fix CI issues

---
 osu.Game/Online/Leaderboards/LeaderboardScore.cs |  2 +-
 osu.Game/Utils/ScoreboardTimeUtils.cs            | 12 +++++++-----
 2 files changed, 8 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Online/Leaderboards/LeaderboardScore.cs b/osu.Game/Online/Leaderboards/LeaderboardScore.cs
index 217be5a024..aaf889d06c 100644
--- a/osu.Game/Online/Leaderboards/LeaderboardScore.cs
+++ b/osu.Game/Online/Leaderboards/LeaderboardScore.cs
@@ -404,7 +404,7 @@ namespace osu.Game.Online.Leaderboards
                 var now = DateTime.Now;
                 var difference = now - Date;
 
-                const double seconds_to_blank = 60*45;
+                const double seconds_to_blank = 60 * 45;
                 const double tense_factor = 2.325;
 
                 double tf = Math.Pow(difference.TotalSeconds / seconds_to_blank, tense_factor);
diff --git a/osu.Game/Utils/ScoreboardTimeUtils.cs b/osu.Game/Utils/ScoreboardTimeUtils.cs
index 7e84b8f2d0..86639c1034 100644
--- a/osu.Game/Utils/ScoreboardTimeUtils.cs
+++ b/osu.Game/Utils/ScoreboardTimeUtils.cs
@@ -14,13 +14,12 @@ namespace osu.Game.Utils
         {
             if (quantity <= 1)
                 return $@"{quantity}{template}";
+
             return $@"{quantity}{template}s";
         }
 
         public static string FormatDate(DateTimeOffset time, TimeSpan lowerCutoff)
         {
-            // This function fails if the passed in time is something close to an epoch
-
             // web uses momentjs's custom locales to format the date for the purposes of the scoreboard.
             // this is intended to be a best-effort, more legible approximation of that.
             // compare:
@@ -57,10 +56,13 @@ namespace osu.Game.Utils
             }
 
             int years = 1;
-            // DateTime causes a crash here for epoch
-            while (time <= now.AddYears(-(years + 1)))
+            // Add upper bound to prevent a crash
+            while (years < 20 && time <= now.AddYears(-(years + 1)))
                 years += 1;
-            return FormatQuantity("yr", years);
+            if (years < 20)
+                return FormatQuantity("yr", years);
+
+            return "never";
         }
     }
 }

From 262751a98a22d87ef5406203d5b38f94e65d30e0 Mon Sep 17 00:00:00 2001
From: dekrain <dawidkrainski8@gmail.com>
Date: Sat, 19 Feb 2022 21:23:35 +0100
Subject: [PATCH 2984/5547] Revert highlighting recent scores

---
 .../Online/Leaderboards/LeaderboardScore.cs     | 17 +----------------
 1 file changed, 1 insertion(+), 16 deletions(-)

diff --git a/osu.Game/Online/Leaderboards/LeaderboardScore.cs b/osu.Game/Online/Leaderboards/LeaderboardScore.cs
index aaf889d06c..a8b508829d 100644
--- a/osu.Game/Online/Leaderboards/LeaderboardScore.cs
+++ b/osu.Game/Online/Leaderboards/LeaderboardScore.cs
@@ -390,28 +390,13 @@ namespace osu.Game.Online.Leaderboards
 
         private class DateLabel : DrawableDate
         {
-            public static readonly Colour4 COLOUR_SATURATED = Colour4.Lime;
-            public static readonly Colour4 COLOUR_UNSATURATED = Colour4.White;
-
             public DateLabel(DateTimeOffset date)
                 : base(date)
             {
                 Font = OsuFont.GetFont(size: 17, weight: FontWeight.Bold, italics: true);
             }
 
-            protected override string Format()
-            {
-                var now = DateTime.Now;
-                var difference = now - Date;
-
-                const double seconds_to_blank = 60 * 45;
-                const double tense_factor = 2.325;
-
-                double tf = Math.Pow(difference.TotalSeconds / seconds_to_blank, tense_factor);
-                Colour = Interpolation.ValueAt(tf, COLOUR_SATURATED, COLOUR_UNSATURATED, 0, 1);
-
-                return ScoreboardTimeUtils.FormatDate(Date, TimeSpan.FromSeconds(30));
-            }
+            protected override string Format() => ScoreboardTimeUtils.FormatDate(Date, TimeSpan.FromSeconds(30));
         }
 
         public class LeaderboardScoreStatistic

From e20ae5b87100a387045471902547cd2296841519 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 17 Feb 2022 23:54:29 +0100
Subject: [PATCH 2985/5547] Add all colour constants for "basic" colour theme
 to `OsuColour`

---
 osu.Game/Graphics/OsuColour.cs | 57 +++++++++++++++++++++++-----------
 1 file changed, 39 insertions(+), 18 deletions(-)

diff --git a/osu.Game/Graphics/OsuColour.cs b/osu.Game/Graphics/OsuColour.cs
index f63bd53549..567d665e81 100644
--- a/osu.Game/Graphics/OsuColour.cs
+++ b/osu.Game/Graphics/OsuColour.cs
@@ -264,32 +264,53 @@ namespace osu.Game.Graphics
         public readonly Color4 GrayE = Color4Extensions.FromHex(@"eee");
         public readonly Color4 GrayF = Color4Extensions.FromHex(@"fff");
 
-        /// <summary>
-        /// Equivalent to <see cref="OverlayColourProvider.Pink"/>'s <see cref="OverlayColourProvider.Colour3"/>.
-        /// </summary>
-        public readonly Color4 Pink3 = Color4Extensions.FromHex(@"cc3378");
+        #region "Basic" colour theme
 
-        /// <summary>
-        /// Equivalent to <see cref="OverlayColourProvider.Blue"/>'s <see cref="OverlayColourProvider.Colour3"/>.
-        /// </summary>
+        // Reference: https://www.figma.com/file/VIkXMYNPMtQem2RJg9k2iQ/Asset%2FColours?node-id=1838%3A3
+
+        public readonly Color4 Pink0 = Color4Extensions.FromHex(@"ff99c7");
+        public readonly Color4 Pink1 = Color4Extensions.FromHex(@"ff66ab");
+        public readonly Color4 Pink2 = Color4Extensions.FromHex(@"eb4791");
+        public readonly Color4 Pink3 = Color4Extensions.FromHex(@"cc3378");
+        public readonly Color4 Pink4 = Color4Extensions.FromHex(@"6b2e49");
+
+        public readonly Color4 Purple0 = Color4Extensions.FromHex(@"b299ff");
+        public readonly Color4 Purple1 = Color4Extensions.FromHex(@"8c66ff");
+        public readonly Color4 Purple2 = Color4Extensions.FromHex(@"7047eb");
+        public readonly Color4 Purple3 = Color4Extensions.FromHex(@"5933cc");
+        public readonly Color4 Purple4 = Color4Extensions.FromHex(@"3d2e6b");
+
+        public readonly Color4 Blue0 = Color4Extensions.FromHex(@"99ddff");
+        public readonly Color4 Blue1 = Color4Extensions.FromHex(@"66ccff");
+        public readonly Color4 Blue2 = Color4Extensions.FromHex(@"47b4eb");
         public readonly Color4 Blue3 = Color4Extensions.FromHex(@"3399cc");
+        public readonly Color4 Blue4 = Color4Extensions.FromHex(@"2e576b");
+
+        public readonly Color4 Green0 = Color4Extensions.FromHex(@"99ffa2");
+        public readonly Color4 Green1 = Color4Extensions.FromHex(@"66ff73");
+        public readonly Color4 Green2 = Color4Extensions.FromHex(@"47eb55");
+        public readonly Color4 Green3 = Color4Extensions.FromHex(@"33cc40");
+        public readonly Color4 Green4 = Color4Extensions.FromHex(@"2e6b33");
 
         public readonly Color4 Lime0 = Color4Extensions.FromHex(@"ccff99");
-
-        /// <summary>
-        /// Equivalent to <see cref="OverlayColourProvider.Lime"/>'s <see cref="OverlayColourProvider.Colour1"/>.
-        /// </summary>
         public readonly Color4 Lime1 = Color4Extensions.FromHex(@"b2ff66");
-
-        /// <summary>
-        /// Equivalent to <see cref="OverlayColourProvider.Lime"/>'s <see cref="OverlayColourProvider.Colour3"/>.
-        /// </summary>
+        public readonly Color4 Lime2 = Color4Extensions.FromHex(@"99eb47");
         public readonly Color4 Lime3 = Color4Extensions.FromHex(@"7fcc33");
+        public readonly Color4 Lime4 = Color4Extensions.FromHex(@"4c6b2e");
 
-        /// <summary>
-        /// Equivalent to <see cref="OverlayColourProvider.Orange"/>'s <see cref="OverlayColourProvider.Colour1"/>.
-        /// </summary>
+        public readonly Color4 Orange0 = Color4Extensions.FromHex(@"ffe699");
         public readonly Color4 Orange1 = Color4Extensions.FromHex(@"ffd966");
+        public readonly Color4 Orange2 = Color4Extensions.FromHex(@"ebc247");
+        public readonly Color4 Orange3 = Color4Extensions.FromHex(@"cca633");
+        public readonly Color4 Orange4 = Color4Extensions.FromHex(@"6b5c2e");
+
+        public readonly Color4 Red0 = Color4Extensions.FromHex(@"ff9b9b");
+        public readonly Color4 Red1 = Color4Extensions.FromHex(@"ff6666");
+        public readonly Color4 Red2 = Color4Extensions.FromHex(@"eb4747");
+        public readonly Color4 Red3 = Color4Extensions.FromHex(@"cc3333");
+        public readonly Color4 Red4 = Color4Extensions.FromHex(@"6b2e2e");
+
+        #endregion
 
         // Content Background
         public readonly Color4 B5 = Color4Extensions.FromHex(@"222a28");

From 2592f0900d384e958cfbb6b99a638cb8089be134 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 20 Feb 2022 20:40:08 +0100
Subject: [PATCH 2986/5547] Add comments about `OverlayColourProvider` vs
 `OsuColour` distinction

---
 osu.Game/Graphics/OsuColour.cs             | 5 +++++
 osu.Game/Overlays/OverlayColourProvider.cs | 4 ++++
 2 files changed, 9 insertions(+)

diff --git a/osu.Game/Graphics/OsuColour.cs b/osu.Game/Graphics/OsuColour.cs
index 567d665e81..886ba7ef92 100644
--- a/osu.Game/Graphics/OsuColour.cs
+++ b/osu.Game/Graphics/OsuColour.cs
@@ -268,6 +268,11 @@ namespace osu.Game.Graphics
 
         // Reference: https://www.figma.com/file/VIkXMYNPMtQem2RJg9k2iQ/Asset%2FColours?node-id=1838%3A3
 
+        // Note that the colours in this region are also defined in `OverlayColourProvider` as `Colour{0,1,2,3,4}`.
+        // The difference as to which should be used where comes down to context.
+        // If the colour in question is supposed to always match the view in which it is displayed theme-wise, use `OverlayColourProvider`.
+        // If the colour usage is special and in general differs from the surrounding view in choice of hue, use the `OsuColour` constants.
+
         public readonly Color4 Pink0 = Color4Extensions.FromHex(@"ff99c7");
         public readonly Color4 Pink1 = Color4Extensions.FromHex(@"ff66ab");
         public readonly Color4 Pink2 = Color4Extensions.FromHex(@"eb4791");
diff --git a/osu.Game/Overlays/OverlayColourProvider.cs b/osu.Game/Overlays/OverlayColourProvider.cs
index e7b3e6d873..730ca09411 100644
--- a/osu.Game/Overlays/OverlayColourProvider.cs
+++ b/osu.Game/Overlays/OverlayColourProvider.cs
@@ -25,6 +25,10 @@ namespace osu.Game.Overlays
             this.colourScheme = colourScheme;
         }
 
+        // Note that the following five colours are also defined in `OsuColour` as `{colourScheme}{0,1,2,3,4}`.
+        // The difference as to which should be used where comes down to context.
+        // If the colour in question is supposed to always match the view in which it is displayed theme-wise, use `OverlayColourProvider`.
+        // If the colour usage is special and in general differs from the surrounding view in choice of hue, use the `OsuColour` constants.
         public Color4 Colour1 => getColour(1, 0.7f);
         public Color4 Colour2 => getColour(0.8f, 0.6f);
         public Color4 Colour3 => getColour(0.6f, 0.5f);

From 79ba37bbabc1fdd1acffcef16c4caac092066665 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 20 Feb 2022 20:40:39 +0100
Subject: [PATCH 2987/5547] Add `Colour0` to `OverlayColourProvider`

---
 osu.Game/Overlays/OverlayColourProvider.cs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Game/Overlays/OverlayColourProvider.cs b/osu.Game/Overlays/OverlayColourProvider.cs
index 730ca09411..c2ceef57e8 100644
--- a/osu.Game/Overlays/OverlayColourProvider.cs
+++ b/osu.Game/Overlays/OverlayColourProvider.cs
@@ -29,6 +29,7 @@ namespace osu.Game.Overlays
         // The difference as to which should be used where comes down to context.
         // If the colour in question is supposed to always match the view in which it is displayed theme-wise, use `OverlayColourProvider`.
         // If the colour usage is special and in general differs from the surrounding view in choice of hue, use the `OsuColour` constants.
+        public Color4 Colour0 => getColour(1, 0.8f);
         public Color4 Colour1 => getColour(1, 0.7f);
         public Color4 Colour2 => getColour(0.8f, 0.6f);
         public Color4 Colour3 => getColour(0.6f, 0.5f);

From ce0db9d4dbd7a0b030558002331dea4312be728a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 20 Feb 2022 20:46:12 +0100
Subject: [PATCH 2988/5547] Remove all references to static
 `OverlayColourProvider`s

---
 .../BeatmapListing/BeatmapSearchGeneralFilterRow.cs        | 7 ++++++-
 osu.Game/Overlays/BeatmapListing/FilterTabItem.cs          | 7 +++++++
 osu.Game/Overlays/BeatmapSet/ExplicitContentBeatmapPill.cs | 2 +-
 osu.Game/Overlays/BeatmapSet/FeaturedArtistBeatmapPill.cs  | 2 +-
 4 files changed, 15 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Overlays/BeatmapListing/BeatmapSearchGeneralFilterRow.cs b/osu.Game/Overlays/BeatmapListing/BeatmapSearchGeneralFilterRow.cs
index fb9e1c0420..51dad100c2 100644
--- a/osu.Game/Overlays/BeatmapListing/BeatmapSearchGeneralFilterRow.cs
+++ b/osu.Game/Overlays/BeatmapListing/BeatmapSearchGeneralFilterRow.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.Framework.Allocation;
+using osu.Game.Graphics;
 using osu.Game.Resources.Localisation.Web;
 using osuTK.Graphics;
 
@@ -33,7 +35,10 @@ namespace osu.Game.Overlays.BeatmapListing
             {
             }
 
-            protected override Color4 GetStateColour() => OverlayColourProvider.Orange.Colour1;
+            [Resolved]
+            private OsuColour colours { get; set; }
+
+            protected override Color4 GetStateColour() => colours.Orange1;
         }
     }
 }
diff --git a/osu.Game/Overlays/BeatmapListing/FilterTabItem.cs b/osu.Game/Overlays/BeatmapListing/FilterTabItem.cs
index 9274cf20aa..52dfcad2cc 100644
--- a/osu.Game/Overlays/BeatmapListing/FilterTabItem.cs
+++ b/osu.Game/Overlays/BeatmapListing/FilterTabItem.cs
@@ -44,7 +44,14 @@ namespace osu.Game.Overlays.BeatmapListing
             });
 
             Enabled.Value = true;
+        }
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
             updateState();
+            FinishTransforms(true);
         }
 
         protected override bool OnHover(HoverEvent e)
diff --git a/osu.Game/Overlays/BeatmapSet/ExplicitContentBeatmapPill.cs b/osu.Game/Overlays/BeatmapSet/ExplicitContentBeatmapPill.cs
index ba78592ed2..21d1d1172c 100644
--- a/osu.Game/Overlays/BeatmapSet/ExplicitContentBeatmapPill.cs
+++ b/osu.Game/Overlays/BeatmapSet/ExplicitContentBeatmapPill.cs
@@ -38,7 +38,7 @@ namespace osu.Game.Overlays.BeatmapSet
                         Margin = new MarginPadding { Horizontal = 10f, Vertical = 2f },
                         Text = BeatmapsetsStrings.NsfwBadgeLabel.ToUpper(),
                         Font = OsuFont.GetFont(size: 10, weight: FontWeight.SemiBold),
-                        Colour = OverlayColourProvider.Orange.Colour2,
+                        Colour = colours.Orange2
                     }
                 }
             };
diff --git a/osu.Game/Overlays/BeatmapSet/FeaturedArtistBeatmapPill.cs b/osu.Game/Overlays/BeatmapSet/FeaturedArtistBeatmapPill.cs
index fdee0799ff..1be987cde2 100644
--- a/osu.Game/Overlays/BeatmapSet/FeaturedArtistBeatmapPill.cs
+++ b/osu.Game/Overlays/BeatmapSet/FeaturedArtistBeatmapPill.cs
@@ -38,7 +38,7 @@ namespace osu.Game.Overlays.BeatmapSet
                         Margin = new MarginPadding { Horizontal = 10f, Vertical = 2f },
                         Text = BeatmapsetsStrings.FeaturedArtistBadgeLabel.ToUpper(),
                         Font = OsuFont.GetFont(size: 10, weight: FontWeight.SemiBold),
-                        Colour = OverlayColourProvider.Blue.Colour1,
+                        Colour = colours.Blue1
                     }
                 }
             };

From 36a00c1ee238b13cfe857882110e1917cef5c49d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 20 Feb 2022 20:46:33 +0100
Subject: [PATCH 2989/5547] Remove static `OverlayColourProvider`s

---
 osu.Game/Overlays/OverlayColourProvider.cs | 9 ---------
 1 file changed, 9 deletions(-)

diff --git a/osu.Game/Overlays/OverlayColourProvider.cs b/osu.Game/Overlays/OverlayColourProvider.cs
index c2ceef57e8..7bddb924a0 100644
--- a/osu.Game/Overlays/OverlayColourProvider.cs
+++ b/osu.Game/Overlays/OverlayColourProvider.cs
@@ -11,15 +11,6 @@ namespace osu.Game.Overlays
     {
         private readonly OverlayColourScheme colourScheme;
 
-        public static OverlayColourProvider Red { get; } = new OverlayColourProvider(OverlayColourScheme.Red);
-        public static OverlayColourProvider Pink { get; } = new OverlayColourProvider(OverlayColourScheme.Pink);
-        public static OverlayColourProvider Orange { get; } = new OverlayColourProvider(OverlayColourScheme.Orange);
-        public static OverlayColourProvider Lime { get; } = new OverlayColourProvider(OverlayColourScheme.Lime);
-        public static OverlayColourProvider Green { get; } = new OverlayColourProvider(OverlayColourScheme.Green);
-        public static OverlayColourProvider Purple { get; } = new OverlayColourProvider(OverlayColourScheme.Purple);
-        public static OverlayColourProvider Blue { get; } = new OverlayColourProvider(OverlayColourScheme.Blue);
-        public static OverlayColourProvider Plum { get; } = new OverlayColourProvider(OverlayColourScheme.Plum);
-
         public OverlayColourProvider(OverlayColourScheme colourScheme)
         {
             this.colourScheme = colourScheme;

From 2ded7d281b4b36e8d92ec12d72f1ba19ee33f935 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 21 Feb 2022 13:17:19 +0900
Subject: [PATCH 2990/5547] Remove unused using statement

---
 osu.Game/Online/Leaderboards/LeaderboardScore.cs | 1 -
 1 file changed, 1 deletion(-)

diff --git a/osu.Game/Online/Leaderboards/LeaderboardScore.cs b/osu.Game/Online/Leaderboards/LeaderboardScore.cs
index a8b508829d..0e9968f27f 100644
--- a/osu.Game/Online/Leaderboards/LeaderboardScore.cs
+++ b/osu.Game/Online/Leaderboards/LeaderboardScore.cs
@@ -30,7 +30,6 @@ using osuTK;
 using osuTK.Graphics;
 using osu.Game.Online.API;
 using osu.Game.Utils;
-using osu.Framework.Utils;
 
 namespace osu.Game.Online.Leaderboards
 {

From 79408f6afcfd778e84c59ae329c73faf253dfa56 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 21 Feb 2022 13:30:58 +0900
Subject: [PATCH 2991/5547] Add xmldoc and clean up `ScoreboardTimeUtils`
 extension methods a touch

---
 .../Online/Leaderboards/LeaderboardScore.cs   |  2 +-
 .../BeatmapSet/Scores/ScoreboardTime.cs       |  2 +-
 osu.Game/Utils/ScoreboardTimeUtils.cs         | 36 +++++++++++--------
 3 files changed, 23 insertions(+), 17 deletions(-)

diff --git a/osu.Game/Online/Leaderboards/LeaderboardScore.cs b/osu.Game/Online/Leaderboards/LeaderboardScore.cs
index 0e9968f27f..a9f03e5c9f 100644
--- a/osu.Game/Online/Leaderboards/LeaderboardScore.cs
+++ b/osu.Game/Online/Leaderboards/LeaderboardScore.cs
@@ -395,7 +395,7 @@ namespace osu.Game.Online.Leaderboards
                 Font = OsuFont.GetFont(size: 17, weight: FontWeight.Bold, italics: true);
             }
 
-            protected override string Format() => ScoreboardTimeUtils.FormatDate(Date, TimeSpan.FromSeconds(30));
+            protected override string Format() => ScoreboardTimeUtils.FormatRelativeTime(Date, TimeSpan.FromSeconds(30));
         }
 
         public class LeaderboardScoreStatistic
diff --git a/osu.Game/Overlays/BeatmapSet/Scores/ScoreboardTime.cs b/osu.Game/Overlays/BeatmapSet/Scores/ScoreboardTime.cs
index ceb446f310..1927e66edb 100644
--- a/osu.Game/Overlays/BeatmapSet/Scores/ScoreboardTime.cs
+++ b/osu.Game/Overlays/BeatmapSet/Scores/ScoreboardTime.cs
@@ -15,6 +15,6 @@ namespace osu.Game.Overlays.BeatmapSet.Scores
         }
 
         protected override string Format()
-            => ScoreboardTimeUtils.FormatDate(Date, TimeSpan.FromHours(1));
+            => ScoreboardTimeUtils.FormatRelativeTime(Date, TimeSpan.FromHours(1));
     }
 }
diff --git a/osu.Game/Utils/ScoreboardTimeUtils.cs b/osu.Game/Utils/ScoreboardTimeUtils.cs
index 86639c1034..4e079ff39f 100644
--- a/osu.Game/Utils/ScoreboardTimeUtils.cs
+++ b/osu.Game/Utils/ScoreboardTimeUtils.cs
@@ -10,15 +10,13 @@ namespace osu.Game.Utils
 {
     public static class ScoreboardTimeUtils
     {
-        public static string FormatQuantity(string template, int quantity)
-        {
-            if (quantity <= 1)
-                return $@"{quantity}{template}";
-
-            return $@"{quantity}{template}s";
-        }
-
-        public static string FormatDate(DateTimeOffset time, TimeSpan lowerCutoff)
+        /// <summary>
+        /// Formats a provided date to a short relative string version for compact display.
+        /// </summary>
+        /// <param name="time">The time to be displayed.</param>
+        /// <param name="lowerCutoff">A timespan denoting the time length beneath which "now" should be displayed.</param>
+        /// <returns>A short relative string representing the input time.</returns>
+        public static string FormatRelativeTime(DateTimeOffset time, TimeSpan lowerCutoff)
         {
             // web uses momentjs's custom locales to format the date for the purposes of the scoreboard.
             // this is intended to be a best-effort, more legible approximation of that.
@@ -36,23 +34,23 @@ namespace osu.Game.Utils
                 return CommonStrings.TimeNow.ToString();
 
             if (span.TotalMinutes < 1)
-                return FormatQuantity("sec", (int)span.TotalSeconds);
+                return formatQuantity("sec", (int)span.TotalSeconds);
             if (span.TotalHours < 1)
-                return FormatQuantity("min", (int)span.TotalMinutes);
+                return formatQuantity("min", (int)span.TotalMinutes);
             if (span.TotalDays < 1)
-                return FormatQuantity("hr", (int)span.TotalHours);
+                return formatQuantity("hr", (int)span.TotalHours);
 
             // this is where this gets more complicated because of how the calendar works.
             // since there's no `TotalMonths` / `TotalYears`, we have to iteratively add months/years
             // and test against cutoff dates to determine how many months/years to show.
 
             if (time > now.AddMonths(-1))
-                return FormatQuantity("dy", (int)span.TotalDays);
+                return formatQuantity("dy", (int)span.TotalDays);
 
             for (int months = 1; months <= 11; ++months)
             {
                 if (time > now.AddMonths(-(months + 1)))
-                    return FormatQuantity("mo", months);
+                    return formatQuantity("mo", months);
             }
 
             int years = 1;
@@ -60,9 +58,17 @@ namespace osu.Game.Utils
             while (years < 20 && time <= now.AddYears(-(years + 1)))
                 years += 1;
             if (years < 20)
-                return FormatQuantity("yr", years);
+                return formatQuantity("yr", years);
 
             return "never";
         }
+
+        private static string formatQuantity(string template, int quantity)
+        {
+            if (quantity <= 1)
+                return $@"{quantity}{template}";
+
+            return $@"{quantity}{template}s";
+        }
     }
 }

From c3b365cf6b79c8cfd618982fb163e6b7e72ed21e Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Mon, 21 Feb 2022 13:31:02 +0900
Subject: [PATCH 2992/5547] Scale classic score by hitobject count

---
 osu.Game/Rulesets/Scoring/ScoreProcessor.cs | 15 ++++++++-------
 osu.Game/Scoring/ScoreManager.cs            |  2 +-
 2 files changed, 9 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Rulesets/Scoring/ScoreProcessor.cs b/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
index 79861c0ecc..42ab30d4d0 100644
--- a/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
+++ b/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
@@ -212,7 +212,7 @@ namespace osu.Game.Rulesets.Scoring
 
         private double getScore(ScoringMode mode)
         {
-            return GetScore(mode, maxAchievableCombo,
+            return GetScore(mode,
                 calculateAccuracyRatio(baseScore),
                 calculateComboRatio(HighestCombo.Value),
                 scoreResultCounts);
@@ -222,12 +222,11 @@ namespace osu.Game.Rulesets.Scoring
         /// Computes the total score.
         /// </summary>
         /// <param name="mode">The <see cref="ScoringMode"/> to compute the total score in.</param>
-        /// <param name="maxCombo">The maximum combo achievable in the beatmap.</param>
         /// <param name="accuracyRatio">The accuracy percentage achieved by the player.</param>
-        /// <param name="comboRatio">The proportion of <paramref name="maxCombo"/> achieved by the player.</param>
+        /// <param name="comboRatio">The proportion of the max combo achieved by the player.</param>
         /// <param name="statistics">Any statistics to be factored in.</param>
         /// <returns>The total score.</returns>
-        public double GetScore(ScoringMode mode, int maxCombo, double accuracyRatio, double comboRatio, Dictionary<HitResult, int> statistics)
+        public double GetScore(ScoringMode mode, double accuracyRatio, double comboRatio, Dictionary<HitResult, int> statistics)
         {
             switch (mode)
             {
@@ -238,10 +237,12 @@ namespace osu.Game.Rulesets.Scoring
                     return (max_score * (accuracyScore + comboScore) + getBonusScore(statistics)) * scoreMultiplier;
 
                 case ScoringMode.Classic:
+                    int totalHitObjects = statistics.Where(k => k.Key >= HitResult.Miss && k.Key <= HitResult.Perfect).Sum(k => k.Value);
+
                     // This gives a similar feeling to osu!stable scoring (ScoreV1) while keeping classic scoring as only a constant multiple of standardised scoring.
                     // The invariant is important to ensure that scores don't get re-ordered on leaderboards between the two scoring modes.
-                    double scaledStandardised = GetScore(ScoringMode.Standardised, maxCombo, accuracyRatio, comboRatio, statistics) / max_score;
-                    return Math.Pow(scaledStandardised * (maxCombo + 1), 2) * 18;
+                    double scaledStandardised = GetScore(ScoringMode.Standardised, accuracyRatio, comboRatio, statistics) / max_score;
+                    return Math.Pow(scaledStandardised * totalHitObjects, 2) * 36;
             }
         }
 
@@ -265,7 +266,7 @@ namespace osu.Game.Rulesets.Scoring
                 computedBaseScore += Judgement.ToNumericResult(pair.Key) * pair.Value;
             }
 
-            return GetScore(mode, maxAchievableCombo, calculateAccuracyRatio(computedBaseScore), calculateComboRatio(maxCombo), statistics);
+            return GetScore(mode, calculateAccuracyRatio(computedBaseScore), calculateComboRatio(maxCombo), statistics);
         }
 
         /// <summary>
diff --git a/osu.Game/Scoring/ScoreManager.cs b/osu.Game/Scoring/ScoreManager.cs
index 532c6b42a3..963c4a77ca 100644
--- a/osu.Game/Scoring/ScoreManager.cs
+++ b/osu.Game/Scoring/ScoreManager.cs
@@ -184,7 +184,7 @@ namespace osu.Game.Scoring
             var scoreProcessor = ruleset.CreateScoreProcessor();
             scoreProcessor.Mods.Value = score.Mods;
 
-            return (long)Math.Round(scoreProcessor.GetScore(mode, beatmapMaxCombo, accuracy, (double)score.MaxCombo / beatmapMaxCombo, score.Statistics));
+            return (long)Math.Round(scoreProcessor.GetScore(mode, accuracy, (double)score.MaxCombo / beatmapMaxCombo, score.Statistics));
         }
 
         /// <summary>

From fc1877b6faea3ad3bb9a476fc744d85dd6a463c2 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 21 Feb 2022 13:42:26 +0900
Subject: [PATCH 2993/5547] Move to extension method and revert logic to match
 previous implementation

---
 osu.Game/Extensions/TimeDisplayExtensions.cs  | 51 ++++++++++++++++++
 .../Online/Leaderboards/LeaderboardScore.cs   |  3 +-
 .../BeatmapSet/Scores/ScoreboardTime.cs       |  4 +-
 osu.Game/Utils/ScoreboardTimeUtils.cs         | 52 -------------------
 4 files changed, 55 insertions(+), 55 deletions(-)

diff --git a/osu.Game/Extensions/TimeDisplayExtensions.cs b/osu.Game/Extensions/TimeDisplayExtensions.cs
index dc05482a05..ee6f458398 100644
--- a/osu.Game/Extensions/TimeDisplayExtensions.cs
+++ b/osu.Game/Extensions/TimeDisplayExtensions.cs
@@ -2,7 +2,9 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
+using Humanizer;
 using osu.Framework.Localisation;
+using osu.Game.Resources.Localisation.Web;
 
 namespace osu.Game.Extensions
 {
@@ -47,5 +49,54 @@ namespace osu.Game.Extensions
 
             return new LocalisableFormattableString(timeSpan, @"mm\:ss");
         }
+
+        /// <summary>
+        /// Formats a provided date to a short relative string version for compact display.
+        /// </summary>
+        /// <param name="time">The time to be displayed.</param>
+        /// <param name="lowerCutoff">A timespan denoting the time length beneath which "now" should be displayed.</param>
+        /// <returns>A short relative string representing the input time.</returns>
+        public static string ToShortRelativeTime(this DateTimeOffset time, TimeSpan lowerCutoff)
+        {
+            var now = DateTime.Now;
+            var difference = now - time;
+
+            // web uses momentjs's custom locales to format the date for the purposes of the scoreboard.
+            // this is intended to be a best-effort, more legible approximation of that.
+            // compare:
+            // * https://github.com/ppy/osu-web/blob/a8f5a68fb435cb19a4faa4c7c4bce08c4f096933/resources/assets/lib/scoreboard-time.tsx
+            // * https://momentjs.com/docs/#/customization/ (reference for the customisation format)
+
+            // TODO: support localisation (probably via `CommonStrings.CountHours()` etc.)
+            // requires pluralisable string support framework-side
+
+            if (difference < lowerCutoff)
+                return CommonStrings.TimeNow.ToString();
+
+            if (difference.TotalMinutes < 1)
+                return "sec".ToQuantity((int)difference.TotalSeconds);
+            if (difference.TotalHours < 1)
+                return "min".ToQuantity((int)difference.TotalMinutes);
+            if (difference.TotalDays < 1)
+                return "hr".ToQuantity((int)difference.TotalHours);
+
+            // this is where this gets more complicated because of how the calendar works.
+            // since there's no `TotalMonths` / `TotalYears`, we have to iteratively add months/years
+            // and test against cutoff dates to determine how many months/years to show.
+
+            if (time > now.AddMonths(-1))
+                return difference.TotalDays < 2 ? "1dy" : $"{(int)difference.TotalDays}dys";
+
+            for (int months = 1; months <= 11; ++months)
+            {
+                if (time > now.AddMonths(-(months + 1)))
+                    return months == 1 ? "1mo" : $"{months}mos";
+            }
+
+            int years = 1;
+            while (time <= now.AddYears(-(years + 1)))
+                years += 1;
+            return years == 1 ? "1yr" : $"{years}yrs";
+        }
     }
 }
diff --git a/osu.Game/Online/Leaderboards/LeaderboardScore.cs b/osu.Game/Online/Leaderboards/LeaderboardScore.cs
index a9f03e5c9f..ddd9d9a2b2 100644
--- a/osu.Game/Online/Leaderboards/LeaderboardScore.cs
+++ b/osu.Game/Online/Leaderboards/LeaderboardScore.cs
@@ -17,6 +17,7 @@ using osu.Framework.Input.Events;
 using osu.Framework.Localisation;
 using osu.Framework.Platform;
 using osu.Game.Database;
+using osu.Game.Extensions;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
@@ -395,7 +396,7 @@ namespace osu.Game.Online.Leaderboards
                 Font = OsuFont.GetFont(size: 17, weight: FontWeight.Bold, italics: true);
             }
 
-            protected override string Format() => ScoreboardTimeUtils.FormatRelativeTime(Date, TimeSpan.FromSeconds(30));
+            protected override string Format() => Date.ToShortRelativeTime(TimeSpan.FromSeconds(30));
         }
 
         public class LeaderboardScoreStatistic
diff --git a/osu.Game/Overlays/BeatmapSet/Scores/ScoreboardTime.cs b/osu.Game/Overlays/BeatmapSet/Scores/ScoreboardTime.cs
index 1927e66edb..5018fb8c70 100644
--- a/osu.Game/Overlays/BeatmapSet/Scores/ScoreboardTime.cs
+++ b/osu.Game/Overlays/BeatmapSet/Scores/ScoreboardTime.cs
@@ -2,8 +2,8 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
+using osu.Game.Extensions;
 using osu.Game.Graphics;
-using osu.Game.Utils;
 
 namespace osu.Game.Overlays.BeatmapSet.Scores
 {
@@ -15,6 +15,6 @@ namespace osu.Game.Overlays.BeatmapSet.Scores
         }
 
         protected override string Format()
-            => ScoreboardTimeUtils.FormatRelativeTime(Date, TimeSpan.FromHours(1));
+            => Date.ToShortRelativeTime(TimeSpan.FromHours(1));
     }
 }
diff --git a/osu.Game/Utils/ScoreboardTimeUtils.cs b/osu.Game/Utils/ScoreboardTimeUtils.cs
index 4e079ff39f..ec222de018 100644
--- a/osu.Game/Utils/ScoreboardTimeUtils.cs
+++ b/osu.Game/Utils/ScoreboardTimeUtils.cs
@@ -10,58 +10,6 @@ namespace osu.Game.Utils
 {
     public static class ScoreboardTimeUtils
     {
-        /// <summary>
-        /// Formats a provided date to a short relative string version for compact display.
-        /// </summary>
-        /// <param name="time">The time to be displayed.</param>
-        /// <param name="lowerCutoff">A timespan denoting the time length beneath which "now" should be displayed.</param>
-        /// <returns>A short relative string representing the input time.</returns>
-        public static string FormatRelativeTime(DateTimeOffset time, TimeSpan lowerCutoff)
-        {
-            // web uses momentjs's custom locales to format the date for the purposes of the scoreboard.
-            // this is intended to be a best-effort, more legible approximation of that.
-            // compare:
-            // * https://github.com/ppy/osu-web/blob/a8f5a68fb435cb19a4faa4c7c4bce08c4f096933/resources/assets/lib/scoreboard-time.tsx
-            // * https://momentjs.com/docs/#/customization/ (reference for the customisation format)
-
-            // TODO: support localisation (probably via `CommonStrings.CountHours()` etc.)
-            // requires pluralisable string support framework-side
-
-            var now = DateTime.Now;
-            var span = now - time;
-
-            if (span < lowerCutoff)
-                return CommonStrings.TimeNow.ToString();
-
-            if (span.TotalMinutes < 1)
-                return formatQuantity("sec", (int)span.TotalSeconds);
-            if (span.TotalHours < 1)
-                return formatQuantity("min", (int)span.TotalMinutes);
-            if (span.TotalDays < 1)
-                return formatQuantity("hr", (int)span.TotalHours);
-
-            // this is where this gets more complicated because of how the calendar works.
-            // since there's no `TotalMonths` / `TotalYears`, we have to iteratively add months/years
-            // and test against cutoff dates to determine how many months/years to show.
-
-            if (time > now.AddMonths(-1))
-                return formatQuantity("dy", (int)span.TotalDays);
-
-            for (int months = 1; months <= 11; ++months)
-            {
-                if (time > now.AddMonths(-(months + 1)))
-                    return formatQuantity("mo", months);
-            }
-
-            int years = 1;
-            // Add upper bound to prevent a crash
-            while (years < 20 && time <= now.AddYears(-(years + 1)))
-                years += 1;
-            if (years < 20)
-                return formatQuantity("yr", years);
-
-            return "never";
-        }
 
         private static string formatQuantity(string template, int quantity)
         {

From 3d0caa44c84f908a013eeac29bc126cfa20bacf8 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 21 Feb 2022 13:43:30 +0900
Subject: [PATCH 2994/5547] Remove unused utils class

---
 osu.Game/Utils/ScoreboardTimeUtils.cs | 22 ----------------------
 1 file changed, 22 deletions(-)
 delete mode 100644 osu.Game/Utils/ScoreboardTimeUtils.cs

diff --git a/osu.Game/Utils/ScoreboardTimeUtils.cs b/osu.Game/Utils/ScoreboardTimeUtils.cs
deleted file mode 100644
index ec222de018..0000000000
--- a/osu.Game/Utils/ScoreboardTimeUtils.cs
+++ /dev/null
@@ -1,22 +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 osu.Game.Resources.Localisation.Web;
-
-#nullable enable
-
-namespace osu.Game.Utils
-{
-    public static class ScoreboardTimeUtils
-    {
-
-        private static string formatQuantity(string template, int quantity)
-        {
-            if (quantity <= 1)
-                return $@"{quantity}{template}";
-
-            return $@"{quantity}{template}s";
-        }
-    }
-}

From 656c58567dbe8068d7d4f7dfabcdf2b0818fbb87 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 21 Feb 2022 16:21:36 +0900
Subject: [PATCH 2995/5547] Add safeties to skip attempted import of the intro
 beatmap when osu! ruleset not present
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

In general running this import will not cause any critical failures, but
the import itself *will* fail – and more loudly with the upcoming
changes to `RulesetStore` (https://github.com/ppy/osu/pull/16890). Due
to it being a loud failure, it will cause the notification overlay to
display a parsing error, which can interrupt the flow of some tests.

See test failure at
https://github.com/ppy/osu/runs/5268848949?check_suite_focus=true as an
example (video coverage at
https://github.com/ppy/osu/pull/16890#issuecomment-1046542243).
---
 osu.Game/Screens/Menu/IntroScreen.cs | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Menu/IntroScreen.cs b/osu.Game/Screens/Menu/IntroScreen.cs
index 98c4b15f7f..afe75c5ef7 100644
--- a/osu.Game/Screens/Menu/IntroScreen.cs
+++ b/osu.Game/Screens/Menu/IntroScreen.cs
@@ -19,6 +19,7 @@ using osu.Game.Database;
 using osu.Game.IO.Archives;
 using osu.Game.Overlays;
 using osu.Game.Overlays.Notifications;
+using osu.Game.Rulesets;
 using osu.Game.Screens.Backgrounds;
 using osuTK;
 using osuTK.Graphics;
@@ -71,6 +72,9 @@ namespace osu.Game.Screens.Menu
         [CanBeNull]
         private readonly Func<OsuScreen> createNextScreen;
 
+        [Resolved]
+        private RulesetStore rulesets { get; set; }
+
         /// <summary>
         /// Whether the <see cref="Track"/> is provided by osu! resources, rather than a user beatmap.
         /// Only valid during or after <see cref="LogoArriving"/>.
@@ -117,7 +121,11 @@ namespace osu.Game.Screens.Menu
             // we generally want a song to be playing on startup, so use the intro music even if a user has specified not to if no other track is available.
             if (initialBeatmap == null)
             {
-                if (!loadThemedIntro())
+                // Intro beatmaps are generally made using the osu! ruleset.
+                // It might not be present in test projects for other rulesets.
+                bool osuRulesetPresent = rulesets.GetRuleset(0) != null;
+
+                if (!loadThemedIntro() && osuRulesetPresent)
                 {
                     // if we detect that the theme track or beatmap is unavailable this is either first startup or things are in a bad state.
                     // this could happen if a user has nuked their files store. for now, reimport to repair this.

From 2f6e65a9a268bf3c4b29a4005556cae95d524a31 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 21 Feb 2022 16:35:39 +0900
Subject: [PATCH 2996/5547] Gracefully handle undefined `DateTimeOffset` values

Only seems to happen in tests, but best to safeguard against this
regardless.
---
 osu.Game/Extensions/TimeDisplayExtensions.cs | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/osu.Game/Extensions/TimeDisplayExtensions.cs b/osu.Game/Extensions/TimeDisplayExtensions.cs
index ee6f458398..54af6a5942 100644
--- a/osu.Game/Extensions/TimeDisplayExtensions.cs
+++ b/osu.Game/Extensions/TimeDisplayExtensions.cs
@@ -58,6 +58,9 @@ namespace osu.Game.Extensions
         /// <returns>A short relative string representing the input time.</returns>
         public static string ToShortRelativeTime(this DateTimeOffset time, TimeSpan lowerCutoff)
         {
+            if (time == default)
+                return "-";
+
             var now = DateTime.Now;
             var difference = now - time;
 

From c466d6df94e741a5def1a4395a5d6d03b29240c9 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Mon, 21 Feb 2022 17:19:35 +0900
Subject: [PATCH 2997/5547] Ensure to not multiply by 0

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

diff --git a/osu.Game/Rulesets/Scoring/ScoreProcessor.cs b/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
index 42ab30d4d0..d5a5aa4592 100644
--- a/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
+++ b/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
@@ -239,6 +239,10 @@ namespace osu.Game.Rulesets.Scoring
                 case ScoringMode.Classic:
                     int totalHitObjects = statistics.Where(k => k.Key >= HitResult.Miss && k.Key <= HitResult.Perfect).Sum(k => k.Value);
 
+                    // If there are no hitobjects then the beatmap can be composed of only ticks or spinners, so ensure we don't multiply by 0 at all times.
+                    if (totalHitObjects == 0)
+                        totalHitObjects = 1;
+
                     // This gives a similar feeling to osu!stable scoring (ScoreV1) while keeping classic scoring as only a constant multiple of standardised scoring.
                     // The invariant is important to ensure that scores don't get re-ordered on leaderboards between the two scoring modes.
                     double scaledStandardised = GetScore(ScoringMode.Standardised, accuracyRatio, comboRatio, statistics) / max_score;

From 1737128334db2da3095f52e5fbcbb1c3fd169b8a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 21 Feb 2022 17:45:57 +0900
Subject: [PATCH 2998/5547] Allow room category to be copied even if
 `Spotlight`

I remember that this conditional copy was added to support making copies
of spotlight rooms without carrying across the `Spotlight` type, but in
testing this is already handled web side to the point that it's not
required.

The rationale for allowing the copy is that this method is used for
tests, where it was not being copied correctly from the input as
expected (used at
https://github.com/ppy/osu/blob/bdc3b76df0b58406796e2b08db13be7f2140fa7e/osu.Game/Tests/Visual/OnlinePlay/TestRoomManager.cs#L38).
---
 osu.Game/Online/Rooms/Room.cs | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/osu.Game/Online/Rooms/Room.cs b/osu.Game/Online/Rooms/Room.cs
index bbe854f2dd..a328f8e8c0 100644
--- a/osu.Game/Online/Rooms/Room.cs
+++ b/osu.Game/Online/Rooms/Room.cs
@@ -168,8 +168,7 @@ namespace osu.Game.Online.Rooms
             RoomID.Value = other.RoomID.Value;
             Name.Value = other.Name.Value;
 
-            if (other.Category.Value != RoomCategory.Spotlight)
-                Category.Value = other.Category.Value;
+            Category.Value = other.Category.Value;
 
             if (other.Host.Value != null && Host.Value?.Id != other.Host.Value.Id)
                 Host.Value = other.Host.Value;

From ab8b502709f5da93709bcfc0f26a6e0053a9ccdc Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 21 Feb 2022 17:59:51 +0900
Subject: [PATCH 2999/5547] Add test coverage of spotlights being at the top of
 the listing

---
 .../Multiplayer/TestSceneLoungeRoomsContainer.cs  | 15 ++++++++++-----
 1 file changed, 10 insertions(+), 5 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneLoungeRoomsContainer.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneLoungeRoomsContainer.cs
index c3d5f7ec23..9a66a2b05c 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneLoungeRoomsContainer.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneLoungeRoomsContainer.cs
@@ -44,15 +44,20 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [Test]
         public void TestBasicListChanges()
         {
-            AddStep("add rooms", () => RoomManager.AddRooms(3));
+            AddStep("add rooms", () => RoomManager.AddRooms(5));
 
-            AddAssert("has 3 rooms", () => container.Rooms.Count == 3);
-            AddStep("remove first room", () => RoomManager.RemoveRoom(RoomManager.Rooms.FirstOrDefault()));
-            AddAssert("has 2 rooms", () => container.Rooms.Count == 2);
+            AddAssert("has 5 rooms", () => container.Rooms.Count == 5);
+
+            AddAssert("all spotlights at top", () => container.Rooms
+                                                              .SkipWhile(r => r.Room.Category.Value == RoomCategory.Spotlight)
+                                                              .All(r => r.Room.Category.Value == RoomCategory.Normal));
+
+            AddStep("remove first room", () => RoomManager.RemoveRoom(RoomManager.Rooms.FirstOrDefault(r => r.RoomID.Value == 0)));
+            AddAssert("has 4 rooms", () => container.Rooms.Count == 4);
             AddAssert("first room removed", () => container.Rooms.All(r => r.Room.RoomID.Value != 0));
 
             AddStep("select first room", () => container.Rooms.First().TriggerClick());
-            AddAssert("first room selected", () => checkRoomSelected(RoomManager.Rooms.First()));
+            AddAssert("first spotlight selected", () => checkRoomSelected(RoomManager.Rooms.First(r => r.Category.Value == RoomCategory.Spotlight)));
         }
 
         [Test]

From 02a85005004ae66dc4477bfd38932badc16ec894 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 21 Feb 2022 17:59:09 +0900
Subject: [PATCH 3000/5547] Ensure spotlights always show at the top of the
 lounge listing

As proposed at https://github.com/ppy/osu/discussions/16936. Spotlights
are intended to have focus, so let's make sure they are the first thing
the user sees for the time being.
---
 .../Screens/OnlinePlay/Lounge/Components/RoomsContainer.cs | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Screens/OnlinePlay/Lounge/Components/RoomsContainer.cs b/osu.Game/Screens/OnlinePlay/Lounge/Components/RoomsContainer.cs
index 9f917c978c..3260427192 100644
--- a/osu.Game/Screens/OnlinePlay/Lounge/Components/RoomsContainer.cs
+++ b/osu.Game/Screens/OnlinePlay/Lounge/Components/RoomsContainer.cs
@@ -124,7 +124,12 @@ namespace osu.Game.Screens.OnlinePlay.Lounge.Components
         private void updateSorting()
         {
             foreach (var room in roomFlow)
-                roomFlow.SetLayoutPosition(room, -(room.Room.RoomID.Value ?? 0));
+            {
+                roomFlow.SetLayoutPosition(room, room.Room.Category.Value == RoomCategory.Spotlight
+                    // Always show spotlight playlists at the top of the listing.
+                    ? float.MinValue
+                    : -(room.Room.RoomID.Value ?? 0));
+            }
         }
 
         protected override bool OnClick(ClickEvent e)

From 46b408be75b21c3fe872227c298d696851150d3e Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Mon, 21 Feb 2022 17:59:50 +0900
Subject: [PATCH 3001/5547] Update tests to match new behaviour

---
 .../Rulesets/Scoring/ScoreProcessorTest.cs    | 30 +++++++++----------
 1 file changed, 15 insertions(+), 15 deletions(-)

diff --git a/osu.Game.Tests/Rulesets/Scoring/ScoreProcessorTest.cs b/osu.Game.Tests/Rulesets/Scoring/ScoreProcessorTest.cs
index f0d9ece06f..c6e7988543 100644
--- a/osu.Game.Tests/Rulesets/Scoring/ScoreProcessorTest.cs
+++ b/osu.Game.Tests/Rulesets/Scoring/ScoreProcessorTest.cs
@@ -36,9 +36,9 @@ namespace osu.Game.Tests.Rulesets.Scoring
         [TestCase(ScoringMode.Standardised, HitResult.Meh, 750_000)]
         [TestCase(ScoringMode.Standardised, HitResult.Ok, 800_000)]
         [TestCase(ScoringMode.Standardised, HitResult.Great, 1_000_000)]
-        [TestCase(ScoringMode.Classic, HitResult.Meh, 41)]
-        [TestCase(ScoringMode.Classic, HitResult.Ok, 46)]
-        [TestCase(ScoringMode.Classic, HitResult.Great, 72)]
+        [TestCase(ScoringMode.Classic, HitResult.Meh, 20)]
+        [TestCase(ScoringMode.Classic, HitResult.Ok, 23)]
+        [TestCase(ScoringMode.Classic, HitResult.Great, 36)]
         public void TestSingleOsuHit(ScoringMode scoringMode, HitResult hitResult, int expectedScore)
         {
             scoreProcessor.Mode.Value = scoringMode;
@@ -86,17 +86,17 @@ namespace osu.Game.Tests.Rulesets.Scoring
         [TestCase(ScoringMode.Standardised, HitResult.SmallBonus, HitResult.SmallBonus, 1_000_030)] // 1 * 300_000 + 700_000 (max combo 0) + 3 * 10 (bonus points)
         [TestCase(ScoringMode.Standardised, HitResult.LargeBonus, HitResult.LargeBonus, 1_000_150)] // 1 * 300_000 + 700_000 (max combo 0) + 3 * 50 (bonus points)
         [TestCase(ScoringMode.Classic, HitResult.Miss, HitResult.Great, 0)]
-        [TestCase(ScoringMode.Classic, HitResult.Meh, HitResult.Great, 68)]
-        [TestCase(ScoringMode.Classic, HitResult.Ok, HitResult.Great, 81)]
-        [TestCase(ScoringMode.Classic, HitResult.Good, HitResult.Perfect, 109)]
-        [TestCase(ScoringMode.Classic, HitResult.Great, HitResult.Great, 149)]
-        [TestCase(ScoringMode.Classic, HitResult.Perfect, HitResult.Perfect, 149)]
-        [TestCase(ScoringMode.Classic, HitResult.SmallTickMiss, HitResult.SmallTickHit, 9)]
-        [TestCase(ScoringMode.Classic, HitResult.SmallTickHit, HitResult.SmallTickHit, 15)]
+        [TestCase(ScoringMode.Classic, HitResult.Meh, HitResult.Great, 86)]
+        [TestCase(ScoringMode.Classic, HitResult.Ok, HitResult.Great, 104)]
+        [TestCase(ScoringMode.Classic, HitResult.Good, HitResult.Perfect, 140)]
+        [TestCase(ScoringMode.Classic, HitResult.Great, HitResult.Great, 190)]
+        [TestCase(ScoringMode.Classic, HitResult.Perfect, HitResult.Perfect, 190)]
+        [TestCase(ScoringMode.Classic, HitResult.SmallTickMiss, HitResult.SmallTickHit, 18)]
+        [TestCase(ScoringMode.Classic, HitResult.SmallTickHit, HitResult.SmallTickHit, 31)]
         [TestCase(ScoringMode.Classic, HitResult.LargeTickMiss, HitResult.LargeTickHit, 0)]
-        [TestCase(ScoringMode.Classic, HitResult.LargeTickHit, HitResult.LargeTickHit, 149)]
-        [TestCase(ScoringMode.Classic, HitResult.SmallBonus, HitResult.SmallBonus, 18)]
-        [TestCase(ScoringMode.Classic, HitResult.LargeBonus, HitResult.LargeBonus, 18)]
+        [TestCase(ScoringMode.Classic, HitResult.LargeTickHit, HitResult.LargeTickHit, 12)]
+        [TestCase(ScoringMode.Classic, HitResult.SmallBonus, HitResult.SmallBonus, 36)]
+        [TestCase(ScoringMode.Classic, HitResult.LargeBonus, HitResult.LargeBonus, 36)]
         public void TestFourVariousResultsOneMiss(ScoringMode scoringMode, HitResult hitResult, HitResult maxResult, int expectedScore)
         {
             var minResult = new TestJudgement(hitResult).MinResult;
@@ -128,8 +128,8 @@ namespace osu.Game.Tests.Rulesets.Scoring
         /// </remarks>
         [TestCase(ScoringMode.Standardised, HitResult.SmallTickHit, 978_571)] // (3 * 10 + 100) / (4 * 10 + 100) * 300_000 + (1 / 1) * 700_000
         [TestCase(ScoringMode.Standardised, HitResult.SmallTickMiss, 914_286)] // (3 * 0 + 100) / (4 * 10 + 100) * 300_000 + (1 / 1) * 700_000
-        [TestCase(ScoringMode.Classic, HitResult.SmallTickHit, 69)] // (((3 * 10 + 100) / (4 * 10 + 100)) * 1 * 300) * (1 + 0 / 25)
-        [TestCase(ScoringMode.Classic, HitResult.SmallTickMiss, 60)] // (((3 * 0 + 100) / (4 * 10 + 100)) * 1 * 300) * (1 + 0 / 25)
+        [TestCase(ScoringMode.Classic, HitResult.SmallTickHit, 34)]
+        [TestCase(ScoringMode.Classic, HitResult.SmallTickMiss, 30)]
         public void TestSmallTicksAccuracy(ScoringMode scoringMode, HitResult hitResult, int expectedScore)
         {
             IEnumerable<HitObject> hitObjects = Enumerable

From 7f4cc221d25c9d9733c5ec6189db61a3a0f0e2f7 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 17 Feb 2022 18:33:27 +0900
Subject: [PATCH 3002/5547] Add API versioning

---
 osu.Game/Online/API/APIAccess.cs      | 2 ++
 osu.Game/Online/API/APIRequest.cs     | 4 ++++
 osu.Game/Online/API/DummyAPIAccess.cs | 2 ++
 osu.Game/Online/API/IAPIProvider.cs   | 5 +++++
 4 files changed, 13 insertions(+)

diff --git a/osu.Game/Online/API/APIAccess.cs b/osu.Game/Online/API/APIAccess.cs
index c5302a393c..8c9741b98b 100644
--- a/osu.Game/Online/API/APIAccess.cs
+++ b/osu.Game/Online/API/APIAccess.cs
@@ -36,6 +36,8 @@ namespace osu.Game.Online.API
 
         public string WebsiteRootUrl { get; }
 
+        public int APIVersion => 20220217; // We may want to pull this from the game version eventually.
+
         public Exception LastLoginError { get; private set; }
 
         public string ProvidedUsername { get; private set; }
diff --git a/osu.Game/Online/API/APIRequest.cs b/osu.Game/Online/API/APIRequest.cs
index 91148c177f..776ff5fd8f 100644
--- a/osu.Game/Online/API/APIRequest.cs
+++ b/osu.Game/Online/API/APIRequest.cs
@@ -2,6 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
+using System.Globalization;
 using JetBrains.Annotations;
 using Newtonsoft.Json;
 using osu.Framework.IO.Network;
@@ -112,6 +113,9 @@ namespace osu.Game.Online.API
             WebRequest = CreateWebRequest();
             WebRequest.Failed += Fail;
             WebRequest.AllowRetryOnTimeout = false;
+
+            WebRequest.AddHeader("x-api-version", API.APIVersion.ToString(CultureInfo.InvariantCulture));
+
             if (!string.IsNullOrEmpty(API.AccessToken))
                 WebRequest.AddHeader("Authorization", $"Bearer {API.AccessToken}");
 
diff --git a/osu.Game/Online/API/DummyAPIAccess.cs b/osu.Game/Online/API/DummyAPIAccess.cs
index 7131c3a7d4..f292e95bd1 100644
--- a/osu.Game/Online/API/DummyAPIAccess.cs
+++ b/osu.Game/Online/API/DummyAPIAccess.cs
@@ -33,6 +33,8 @@ namespace osu.Game.Online.API
 
         public string WebsiteRootUrl => "http://localhost";
 
+        public int APIVersion => int.Parse(DateTime.Now.ToString("yyyyMMdd"));
+
         public Exception LastLoginError { get; private set; }
 
         /// <summary>
diff --git a/osu.Game/Online/API/IAPIProvider.cs b/osu.Game/Online/API/IAPIProvider.cs
index a97eae77e3..470d46cd7f 100644
--- a/osu.Game/Online/API/IAPIProvider.cs
+++ b/osu.Game/Online/API/IAPIProvider.cs
@@ -57,6 +57,11 @@ namespace osu.Game.Online.API
         /// </summary>
         string WebsiteRootUrl { get; }
 
+        /// <summary>
+        /// The version of the API.
+        /// </summary>
+        int APIVersion { get; }
+
         /// <summary>
         /// The last login error that occurred, if any.
         /// </summary>

From 39d64e779cd576f5e0a7e62705c7063ceb49930a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 17 Feb 2022 19:15:09 +0900
Subject: [PATCH 3003/5547] Handle API returned difficulty range for rooms

---
 osu.Game/Online/Rooms/Room.cs                 | 13 ++++++++++++
 .../Components/StarRatingRangeDisplay.cs      | 21 ++++++++++++++++---
 2 files changed, 31 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Online/Rooms/Room.cs b/osu.Game/Online/Rooms/Room.cs
index bbe854f2dd..6722dac51d 100644
--- a/osu.Game/Online/Rooms/Room.cs
+++ b/osu.Game/Online/Rooms/Room.cs
@@ -37,6 +37,9 @@ namespace osu.Game.Online.Rooms
         [JsonProperty("channel_id")]
         public readonly Bindable<int> ChannelId = new Bindable<int>();
 
+        [JsonProperty("difficulty_range")]
+        public readonly Bindable<RoomDifficultyRange> DifficultyRange = new Bindable<RoomDifficultyRange>();
+
         [Cached]
         [JsonIgnore]
         public readonly Bindable<RoomCategory> Category = new Bindable<RoomCategory>();
@@ -228,5 +231,15 @@ namespace osu.Game.Online.Rooms
         public bool ShouldSerializeEndDate() => false;
 
         #endregion
+
+        [JsonObject(MemberSerialization.OptIn)]
+        public class RoomDifficultyRange
+        {
+            [JsonProperty("min")]
+            public double Min;
+
+            [JsonProperty("max")]
+            public double Max;
+        }
     }
 }
diff --git a/osu.Game/Screens/OnlinePlay/Components/StarRatingRangeDisplay.cs b/osu.Game/Screens/OnlinePlay/Components/StarRatingRangeDisplay.cs
index 95ecadd21a..f27f5d6741 100644
--- a/osu.Game/Screens/OnlinePlay/Components/StarRatingRangeDisplay.cs
+++ b/osu.Game/Screens/OnlinePlay/Components/StarRatingRangeDisplay.cs
@@ -12,6 +12,7 @@ using osu.Framework.Utils;
 using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.Drawables;
 using osu.Game.Graphics;
+using osu.Game.Online.Rooms;
 using osuTK;
 
 namespace osu.Game.Screens.OnlinePlay.Components
@@ -71,6 +72,9 @@ namespace osu.Game.Screens.OnlinePlay.Components
             };
         }
 
+        [Resolved]
+        private Room room { get; set; }
+
         protected override void LoadComplete()
         {
             base.LoadComplete();
@@ -80,10 +84,21 @@ namespace osu.Game.Screens.OnlinePlay.Components
 
         private void updateRange(object sender, NotifyCollectionChangedEventArgs e)
         {
-            var orderedDifficulties = Playlist.Select(p => p.Beatmap).OrderBy(b => b.StarRating).ToArray();
+            StarDifficulty minDifficulty;
+            StarDifficulty maxDifficulty;
 
-            StarDifficulty minDifficulty = new StarDifficulty(orderedDifficulties.Length > 0 ? orderedDifficulties[0].StarRating : 0, 0);
-            StarDifficulty maxDifficulty = new StarDifficulty(orderedDifficulties.Length > 0 ? orderedDifficulties[^1].StarRating : 0, 0);
+            if (room.DifficultyRange != null)
+            {
+                minDifficulty = new StarDifficulty(room.DifficultyRange.Value.Min, 0);
+                maxDifficulty = new StarDifficulty(room.DifficultyRange.Value.Max, 0);
+            }
+            else
+            {
+                var orderedDifficulties = Playlist.Select(p => p.Beatmap).OrderBy(b => b.StarRating).ToArray();
+
+                minDifficulty = new StarDifficulty(orderedDifficulties.Length > 0 ? orderedDifficulties[0].StarRating : 0, 0);
+                maxDifficulty = new StarDifficulty(orderedDifficulties.Length > 0 ? orderedDifficulties[^1].StarRating : 0, 0);
+            }
 
             minDisplay.Current.Value = minDifficulty;
             maxDisplay.Current.Value = maxDifficulty;

From b43008b9f6ffc796e5927bf218230d9a4e806dc6 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 21 Feb 2022 19:02:21 +0900
Subject: [PATCH 3004/5547] Add cover and count handling from newer response
 version

---
 osu.Game/Online/Rooms/Room.cs                 | 21 +++++++++++++++++++
 .../Components/OnlinePlayBackgroundSprite.cs  |  3 ++-
 .../Lounge/Components/PlaylistCountPill.cs    | 13 +++++++-----
 .../Screens/OnlinePlay/OnlinePlayComposite.cs |  6 ++++++
 4 files changed, 37 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Online/Rooms/Room.cs b/osu.Game/Online/Rooms/Room.cs
index 6722dac51d..db24eeea41 100644
--- a/osu.Game/Online/Rooms/Room.cs
+++ b/osu.Game/Online/Rooms/Room.cs
@@ -37,6 +37,14 @@ namespace osu.Game.Online.Rooms
         [JsonProperty("channel_id")]
         public readonly Bindable<int> ChannelId = new Bindable<int>();
 
+        [JsonProperty("current_playlist_item")]
+        [Cached]
+        public readonly Bindable<PlaylistItem> CurrentPlaylistItem = new Bindable<PlaylistItem>();
+
+        [JsonProperty("playlist_item_stats")]
+        [Cached]
+        public readonly Bindable<RoomPlaylistItemStats> PlaylistItemStats = new Bindable<RoomPlaylistItemStats>();
+
         [JsonProperty("difficulty_range")]
         public readonly Bindable<RoomDifficultyRange> DifficultyRange = new Bindable<RoomDifficultyRange>();
 
@@ -232,6 +240,19 @@ namespace osu.Game.Online.Rooms
 
         #endregion
 
+        [JsonObject(MemberSerialization.OptIn)]
+        public class RoomPlaylistItemStats
+        {
+            [JsonProperty("count_active")]
+            public int CountActive;
+
+            [JsonProperty("count_total")]
+            public int CountTotal;
+
+            [JsonProperty("ruleset_ids")]
+            public int[] RulesetIDs;
+        }
+
         [JsonObject(MemberSerialization.OptIn)]
         public class RoomDifficultyRange
         {
diff --git a/osu.Game/Screens/OnlinePlay/Components/OnlinePlayBackgroundSprite.cs b/osu.Game/Screens/OnlinePlay/Components/OnlinePlayBackgroundSprite.cs
index d46ff12279..2faa46e622 100644
--- a/osu.Game/Screens/OnlinePlay/Components/OnlinePlayBackgroundSprite.cs
+++ b/osu.Game/Screens/OnlinePlay/Components/OnlinePlayBackgroundSprite.cs
@@ -23,6 +23,7 @@ namespace osu.Game.Screens.OnlinePlay.Components
         {
             InternalChild = sprite = CreateBackgroundSprite();
 
+            CurrentPlaylistItem.BindValueChanged(_ => updateBeatmap());
             Playlist.CollectionChanged += (_, __) => updateBeatmap();
 
             updateBeatmap();
@@ -30,7 +31,7 @@ namespace osu.Game.Screens.OnlinePlay.Components
 
         private void updateBeatmap()
         {
-            sprite.Beatmap.Value = Playlist.GetCurrentItem()?.Beatmap;
+            sprite.Beatmap.Value = CurrentPlaylistItem.Value?.Beatmap ?? Playlist.GetCurrentItem()?.Beatmap;
         }
 
         protected virtual UpdateableBeatmapBackgroundSprite CreateBackgroundSprite() => new UpdateableBeatmapBackgroundSprite(BeatmapSetCoverType) { RelativeSizeAxes = Axes.Both };
diff --git a/osu.Game/Screens/OnlinePlay/Lounge/Components/PlaylistCountPill.cs b/osu.Game/Screens/OnlinePlay/Lounge/Components/PlaylistCountPill.cs
index ef2c2df4a6..f387adfeb0 100644
--- a/osu.Game/Screens/OnlinePlay/Lounge/Components/PlaylistCountPill.cs
+++ b/osu.Game/Screens/OnlinePlay/Lounge/Components/PlaylistCountPill.cs
@@ -1,13 +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.Specialized;
 using Humanizer;
 using osu.Framework.Allocation;
+using osu.Framework.Bindables;
 using osu.Framework.Extensions.LocalisationExtensions;
 using osu.Framework.Graphics;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
+using osu.Game.Online.Rooms;
 
 namespace osu.Game.Screens.OnlinePlay.Lounge.Components
 {
@@ -41,15 +42,17 @@ namespace osu.Game.Screens.OnlinePlay.Lounge.Components
         {
             base.LoadComplete();
 
-            Playlist.BindCollectionChanged(updateCount, true);
+            PlaylistItemStats.BindValueChanged(updateCount, true);
         }
 
-        private void updateCount(object sender, NotifyCollectionChangedEventArgs e)
+        private void updateCount(ValueChangedEvent<Room.RoomPlaylistItemStats> valueChangedEvent)
         {
+            int activeItems = valueChangedEvent.NewValue.CountActive;
+
             count.Clear();
-            count.AddText(Playlist.Count.ToLocalisableString(), s => s.Font = s.Font.With(weight: FontWeight.Bold));
+            count.AddText(activeItems.ToLocalisableString(), s => s.Font = s.Font.With(weight: FontWeight.Bold));
             count.AddText(" ");
-            count.AddText("Beatmap".ToQuantity(Playlist.Count, ShowQuantityAs.None));
+            count.AddText("Beatmap".ToQuantity(activeItems, ShowQuantityAs.None));
         }
     }
 }
diff --git a/osu.Game/Screens/OnlinePlay/OnlinePlayComposite.cs b/osu.Game/Screens/OnlinePlay/OnlinePlayComposite.cs
index c833621fbc..3148b74c9c 100644
--- a/osu.Game/Screens/OnlinePlay/OnlinePlayComposite.cs
+++ b/osu.Game/Screens/OnlinePlay/OnlinePlayComposite.cs
@@ -32,6 +32,12 @@ namespace osu.Game.Screens.OnlinePlay
         [Resolved(typeof(Room))]
         protected Bindable<MatchType> Type { get; private set; }
 
+        [Resolved(typeof(Room))]
+        protected Bindable<PlaylistItem> CurrentPlaylistItem { get; private set; }
+
+        [Resolved(typeof(Room))]
+        protected Bindable<Room.RoomPlaylistItemStats> PlaylistItemStats { get; private set; }
+
         [Resolved(typeof(Room))]
         protected BindableList<PlaylistItem> Playlist { get; private set; }
 

From b5348e04077910c65f497a88b5287d402dcf6427 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 21 Feb 2022 19:05:32 +0900
Subject: [PATCH 3005/5547] Update ruleset filtering to use newly provided
 array return

---
 osu.Game/Screens/OnlinePlay/Lounge/Components/RoomsContainer.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Screens/OnlinePlay/Lounge/Components/RoomsContainer.cs b/osu.Game/Screens/OnlinePlay/Lounge/Components/RoomsContainer.cs
index 9f917c978c..a521306d7e 100644
--- a/osu.Game/Screens/OnlinePlay/Lounge/Components/RoomsContainer.cs
+++ b/osu.Game/Screens/OnlinePlay/Lounge/Components/RoomsContainer.cs
@@ -77,7 +77,7 @@ namespace osu.Game.Screens.OnlinePlay.Lounge.Components
                 {
                     bool matchingFilter = true;
 
-                    matchingFilter &= r.Room.Playlist.Count == 0 || criteria.Ruleset == null || r.Room.Playlist.Any(i => i.RulesetID == criteria.Ruleset.OnlineID);
+                    matchingFilter &= criteria.Ruleset == null || r.Room.PlaylistItemStats.Value.RulesetIDs.Any(id => id == criteria.Ruleset.OnlineID);
 
                     if (!string.IsNullOrEmpty(criteria.SearchString))
                         matchingFilter &= r.FilterTerms.Any(term => term.Contains(criteria.SearchString, StringComparison.InvariantCultureIgnoreCase));

From ffa5291b74b76c3083a4694a0a5961b631fba3d5 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 21 Feb 2022 19:37:36 +0900
Subject: [PATCH 3006/5547] Add fallback handling for item count to support
 different request types

---
 .../OnlinePlay/Lounge/Components/PlaylistCountPill.cs    | 9 ++++-----
 1 file changed, 4 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Lounge/Components/PlaylistCountPill.cs b/osu.Game/Screens/OnlinePlay/Lounge/Components/PlaylistCountPill.cs
index f387adfeb0..1aef41efbd 100644
--- a/osu.Game/Screens/OnlinePlay/Lounge/Components/PlaylistCountPill.cs
+++ b/osu.Game/Screens/OnlinePlay/Lounge/Components/PlaylistCountPill.cs
@@ -3,12 +3,10 @@
 
 using Humanizer;
 using osu.Framework.Allocation;
-using osu.Framework.Bindables;
 using osu.Framework.Extensions.LocalisationExtensions;
 using osu.Framework.Graphics;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
-using osu.Game.Online.Rooms;
 
 namespace osu.Game.Screens.OnlinePlay.Lounge.Components
 {
@@ -42,12 +40,13 @@ namespace osu.Game.Screens.OnlinePlay.Lounge.Components
         {
             base.LoadComplete();
 
-            PlaylistItemStats.BindValueChanged(updateCount, true);
+            PlaylistItemStats.BindValueChanged(_ => updateCount(), true);
+            Playlist.BindCollectionChanged((_, __) => updateCount(), true);
         }
 
-        private void updateCount(ValueChangedEvent<Room.RoomPlaylistItemStats> valueChangedEvent)
+        private void updateCount()
         {
-            int activeItems = valueChangedEvent.NewValue.CountActive;
+            int activeItems = PlaylistItemStats.Value?.CountActive ?? Playlist.Count;
 
             count.Clear();
             count.AddText(activeItems.ToLocalisableString(), s => s.Font = s.Font.With(weight: FontWeight.Bold));

From c7e9cf904bbd777bdc878f893fd37624a321e39f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 21 Feb 2022 19:38:26 +0900
Subject: [PATCH 3007/5547] Fix incorrect null check on now-bindable
 `DifficultyRange`

---
 .../Screens/OnlinePlay/Components/StarRatingRangeDisplay.cs     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Screens/OnlinePlay/Components/StarRatingRangeDisplay.cs b/osu.Game/Screens/OnlinePlay/Components/StarRatingRangeDisplay.cs
index f27f5d6741..de56e6ff86 100644
--- a/osu.Game/Screens/OnlinePlay/Components/StarRatingRangeDisplay.cs
+++ b/osu.Game/Screens/OnlinePlay/Components/StarRatingRangeDisplay.cs
@@ -87,7 +87,7 @@ namespace osu.Game.Screens.OnlinePlay.Components
             StarDifficulty minDifficulty;
             StarDifficulty maxDifficulty;
 
-            if (room.DifficultyRange != null)
+            if (room.DifficultyRange.Value != null)
             {
                 minDifficulty = new StarDifficulty(room.DifficultyRange.Value.Min, 0);
                 maxDifficulty = new StarDifficulty(room.DifficultyRange.Value.Max, 0);

From 655b23f408c483afb04916e16bfd4b15ebfbaf3a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 21 Feb 2022 19:46:31 +0900
Subject: [PATCH 3008/5547] Update playlist room display to a three column
 layout

Similar to the changes made to multiplayer.
---
 .../Playlists/PlaylistsRoomSubScreen.cs       | 227 ++++++++++--------
 1 file changed, 125 insertions(+), 102 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSubScreen.cs b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSubScreen.cs
index 542851cb0f..338a9c856f 100644
--- a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSubScreen.cs
@@ -69,132 +69,155 @@ namespace osu.Game.Screens.OnlinePlay.Playlists
             Room.MaxAttempts.BindValueChanged(attempts => progressSection.Alpha = Room.MaxAttempts.Value != null ? 1 : 0, true);
         }
 
-        protected override Drawable CreateMainContent() => new GridContainer
+        protected override Drawable CreateMainContent() => new Container
         {
             RelativeSizeAxes = Axes.Both,
-            Content = new[]
+            Padding = new MarginPadding { Horizontal = 5, Vertical = 10 },
+            Child = new GridContainer
             {
-                new Drawable[]
+                RelativeSizeAxes = Axes.Both,
+                ColumnDimensions = new[]
                 {
-                    new Container
+                    new Dimension(),
+                    new Dimension(GridSizeMode.Absolute, 10),
+                    new Dimension(),
+                    new Dimension(GridSizeMode.Absolute, 10),
+                    new Dimension(),
+                },
+                Content = new[]
+                {
+                    new Drawable[]
                     {
-                        RelativeSizeAxes = Axes.Both,
-                        Padding = new MarginPadding { Right = 5 },
-                        Child = new GridContainer
+                        // Playlist items column
+                        new Container
+                        {
+                            RelativeSizeAxes = Axes.Both,
+                            Padding = new MarginPadding { Right = 5 },
+                            Child = new GridContainer
+                            {
+                                RelativeSizeAxes = Axes.Both,
+                                Content = new[]
+                                {
+                                    new Drawable[] { new OverlinedPlaylistHeader(), },
+                                    new Drawable[]
+                                    {
+                                        new DrawableRoomPlaylist
+                                        {
+                                            RelativeSizeAxes = Axes.Both,
+                                            Items = { BindTarget = Room.Playlist },
+                                            SelectedItem = { BindTarget = SelectedItem },
+                                            AllowSelection = true,
+                                            AllowShowingResults = true,
+                                            RequestResults = item =>
+                                            {
+                                                Debug.Assert(RoomId.Value != null);
+                                                ParentScreen?.Push(new PlaylistsResultsScreen(null, RoomId.Value.Value, item, false));
+                                            }
+                                        }
+                                    },
+                                },
+                                RowDimensions = new[]
+                                {
+                                    new Dimension(GridSizeMode.AutoSize),
+                                    new Dimension(),
+                                }
+                            }
+                        },
+                        // Spacer
+                        null,
+                        // Middle column (mods and leaderboard)
+                        new GridContainer
                         {
                             RelativeSizeAxes = Axes.Both,
                             Content = new[]
                             {
-                                new Drawable[] { new OverlinedPlaylistHeader(), },
+                                new[]
+                                {
+                                    UserModsSection = new FillFlowContainer
+                                    {
+                                        RelativeSizeAxes = Axes.X,
+                                        AutoSizeAxes = Axes.Y,
+                                        Alpha = 0,
+                                        Margin = new MarginPadding { Bottom = 10 },
+                                        Children = new Drawable[]
+                                        {
+                                            new OverlinedHeader("Extra mods"),
+                                            new FillFlowContainer
+                                            {
+                                                AutoSizeAxes = Axes.Both,
+                                                Direction = FillDirection.Horizontal,
+                                                Spacing = new Vector2(10, 0),
+                                                Children = new Drawable[]
+                                                {
+                                                    new UserModSelectButton
+                                                    {
+                                                        Anchor = Anchor.CentreLeft,
+                                                        Origin = Anchor.CentreLeft,
+                                                        Width = 90,
+                                                        Text = "Select",
+                                                        Action = ShowUserModSelect,
+                                                    },
+                                                    new ModDisplay
+                                                    {
+                                                        Anchor = Anchor.CentreLeft,
+                                                        Origin = Anchor.CentreLeft,
+                                                        Current = UserMods,
+                                                        Scale = new Vector2(0.8f),
+                                                    },
+                                                }
+                                            }
+                                        }
+                                    },
+                                },
                                 new Drawable[]
                                 {
-                                    new DrawableRoomPlaylist
+                                    progressSection = new FillFlowContainer
                                     {
-                                        RelativeSizeAxes = Axes.Both,
-                                        Items = { BindTarget = Room.Playlist },
-                                        SelectedItem = { BindTarget = SelectedItem },
-                                        AllowSelection = true,
-                                        AllowShowingResults = true,
-                                        RequestResults = item =>
+                                        RelativeSizeAxes = Axes.X,
+                                        AutoSizeAxes = Axes.Y,
+                                        Alpha = 0,
+                                        Margin = new MarginPadding { Bottom = 10 },
+                                        Direction = FillDirection.Vertical,
+                                        Children = new Drawable[]
                                         {
-                                            Debug.Assert(RoomId.Value != null);
-                                            ParentScreen?.Push(new PlaylistsResultsScreen(null, RoomId.Value.Value, item, false));
+                                            new OverlinedHeader("Progress"),
+                                            new RoomLocalUserInfo(),
                                         }
-                                    }
+                                    },
                                 },
+                                new Drawable[]
+                                {
+                                    new OverlinedHeader("Leaderboard")
+                                },
+                                new Drawable[] { leaderboard = new MatchLeaderboard { RelativeSizeAxes = Axes.Both }, },
+                            },
+                            RowDimensions = new[]
+                            {
+                                new Dimension(GridSizeMode.AutoSize),
+                                new Dimension(GridSizeMode.AutoSize),
+                                new Dimension(GridSizeMode.AutoSize),
+                                new Dimension(),
+                            }
+                        },
+                        // Spacer
+                        null,
+                        // Main right column
+                        new GridContainer
+                        {
+                            RelativeSizeAxes = Axes.Both,
+                            Content = new[]
+                            {
+                                new Drawable[] { new OverlinedHeader("Chat") },
+                                new Drawable[] { new MatchChatDisplay(Room) { RelativeSizeAxes = Axes.Both } }
                             },
                             RowDimensions = new[]
                             {
                                 new Dimension(GridSizeMode.AutoSize),
                                 new Dimension(),
                             }
-                        }
-                    },
-                    null,
-                    new GridContainer
-                    {
-                        RelativeSizeAxes = Axes.Both,
-                        Content = new[]
-                        {
-                            new[]
-                            {
-                                UserModsSection = new FillFlowContainer
-                                {
-                                    RelativeSizeAxes = Axes.X,
-                                    AutoSizeAxes = Axes.Y,
-                                    Alpha = 0,
-                                    Margin = new MarginPadding { Bottom = 10 },
-                                    Children = new Drawable[]
-                                    {
-                                        new OverlinedHeader("Extra mods"),
-                                        new FillFlowContainer
-                                        {
-                                            AutoSizeAxes = Axes.Both,
-                                            Direction = FillDirection.Horizontal,
-                                            Spacing = new Vector2(10, 0),
-                                            Children = new Drawable[]
-                                            {
-                                                new UserModSelectButton
-                                                {
-                                                    Anchor = Anchor.CentreLeft,
-                                                    Origin = Anchor.CentreLeft,
-                                                    Width = 90,
-                                                    Text = "Select",
-                                                    Action = ShowUserModSelect,
-                                                },
-                                                new ModDisplay
-                                                {
-                                                    Anchor = Anchor.CentreLeft,
-                                                    Origin = Anchor.CentreLeft,
-                                                    Current = UserMods,
-                                                    Scale = new Vector2(0.8f),
-                                                },
-                                            }
-                                        }
-                                    }
-                                },
-                            },
-                            new Drawable[]
-                            {
-                                progressSection = new FillFlowContainer
-                                {
-                                    RelativeSizeAxes = Axes.X,
-                                    AutoSizeAxes = Axes.Y,
-                                    Alpha = 0,
-                                    Margin = new MarginPadding { Bottom = 10 },
-                                    Direction = FillDirection.Vertical,
-                                    Children = new Drawable[]
-                                    {
-                                        new OverlinedHeader("Progress"),
-                                        new RoomLocalUserInfo(),
-                                    }
-                                },
-                            },
-                            new Drawable[]
-                            {
-                                new OverlinedHeader("Leaderboard")
-                            },
-                            new Drawable[] { leaderboard = new MatchLeaderboard { RelativeSizeAxes = Axes.Both }, },
-                            new Drawable[] { new OverlinedHeader("Chat"), },
-                            new Drawable[] { new MatchChatDisplay(Room) { RelativeSizeAxes = Axes.Both } }
                         },
-                        RowDimensions = new[]
-                        {
-                            new Dimension(GridSizeMode.AutoSize),
-                            new Dimension(GridSizeMode.AutoSize),
-                            new Dimension(GridSizeMode.AutoSize),
-                            new Dimension(),
-                            new Dimension(GridSizeMode.AutoSize),
-                            new Dimension(GridSizeMode.Relative, size: 0.4f, minSize: 120),
-                        }
                     },
                 },
-            },
-            ColumnDimensions = new[]
-            {
-                new Dimension(GridSizeMode.Relative, size: 0.5f, maxSize: 400),
-                new Dimension(),
-                new Dimension(GridSizeMode.Relative, size: 0.5f, maxSize: 600),
             }
         };
 

From 98c008b95f49ac3c1676619aa9195cce4ad46c54 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 21 Feb 2022 19:48:39 +0900
Subject: [PATCH 3009/5547] Fix test failures due to order change

---
 .../Visual/Multiplayer/TestSceneLoungeRoomsContainer.cs       | 2 +-
 osu.Game/Tests/Visual/OnlinePlay/TestRoomManager.cs           | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneLoungeRoomsContainer.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneLoungeRoomsContainer.cs
index 9a66a2b05c..93cd281bc5 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneLoungeRoomsContainer.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneLoungeRoomsContainer.cs
@@ -44,7 +44,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [Test]
         public void TestBasicListChanges()
         {
-            AddStep("add rooms", () => RoomManager.AddRooms(5));
+            AddStep("add rooms", () => RoomManager.AddRooms(5, withSpotlightRooms: true));
 
             AddAssert("has 5 rooms", () => container.Rooms.Count == 5);
 
diff --git a/osu.Game/Tests/Visual/OnlinePlay/TestRoomManager.cs b/osu.Game/Tests/Visual/OnlinePlay/TestRoomManager.cs
index 8dfd969c51..6abcb2924c 100644
--- a/osu.Game/Tests/Visual/OnlinePlay/TestRoomManager.cs
+++ b/osu.Game/Tests/Visual/OnlinePlay/TestRoomManager.cs
@@ -25,7 +25,7 @@ namespace osu.Game.Tests.Visual.OnlinePlay
             base.JoinRoom(room, password, onSuccess, onError);
         }
 
-        public void AddRooms(int count, RulesetInfo ruleset = null, bool withPassword = false)
+        public void AddRooms(int count, RulesetInfo ruleset = null, bool withPassword = false, bool withSpotlightRooms = false)
         {
             for (int i = 0; i < count; i++)
             {
@@ -35,7 +35,7 @@ namespace osu.Game.Tests.Visual.OnlinePlay
                     Name = { Value = $@"Room {currentRoomId}" },
                     Host = { Value = new APIUser { Username = @"Host" } },
                     EndDate = { Value = DateTimeOffset.Now + TimeSpan.FromSeconds(10) },
-                    Category = { Value = i % 2 == 0 ? RoomCategory.Spotlight : RoomCategory.Normal },
+                    Category = { Value = withSpotlightRooms && i % 2 == 0 ? RoomCategory.Spotlight : RoomCategory.Normal },
                 };
 
                 if (withPassword)

From 2aa0364092819f821cd1be69c4d56e2150a1218d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 22 Feb 2022 00:14:33 +0900
Subject: [PATCH 3010/5547] Fix null reference in tests during attempted
 ruleset filtering

---
 osu.Game/Screens/OnlinePlay/Lounge/Components/RoomsContainer.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Screens/OnlinePlay/Lounge/Components/RoomsContainer.cs b/osu.Game/Screens/OnlinePlay/Lounge/Components/RoomsContainer.cs
index a521306d7e..f57bff13ca 100644
--- a/osu.Game/Screens/OnlinePlay/Lounge/Components/RoomsContainer.cs
+++ b/osu.Game/Screens/OnlinePlay/Lounge/Components/RoomsContainer.cs
@@ -77,7 +77,7 @@ namespace osu.Game.Screens.OnlinePlay.Lounge.Components
                 {
                     bool matchingFilter = true;
 
-                    matchingFilter &= criteria.Ruleset == null || r.Room.PlaylistItemStats.Value.RulesetIDs.Any(id => id == criteria.Ruleset.OnlineID);
+                    matchingFilter &= criteria.Ruleset == null || r.Room.PlaylistItemStats.Value?.RulesetIDs.Any(id => id == criteria.Ruleset.OnlineID) != false;
 
                     if (!string.IsNullOrEmpty(criteria.SearchString))
                         matchingFilter &= r.FilterTerms.Any(term => term.Contains(criteria.SearchString, StringComparison.InvariantCultureIgnoreCase));

From 113153e6a34becbae3934939172511b2f8ee591a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 22 Feb 2022 00:25:00 +0900
Subject: [PATCH 3011/5547] Fix remaining filter tests

---
 osu.Game/Tests/Visual/OnlinePlay/TestRoomManager.cs | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/osu.Game/Tests/Visual/OnlinePlay/TestRoomManager.cs b/osu.Game/Tests/Visual/OnlinePlay/TestRoomManager.cs
index 8dfd969c51..7ade173c9c 100644
--- a/osu.Game/Tests/Visual/OnlinePlay/TestRoomManager.cs
+++ b/osu.Game/Tests/Visual/OnlinePlay/TestRoomManager.cs
@@ -43,6 +43,11 @@ namespace osu.Game.Tests.Visual.OnlinePlay
 
                 if (ruleset != null)
                 {
+                    room.PlaylistItemStats.Value = new Room.RoomPlaylistItemStats
+                    {
+                        RulesetIDs = new[] { ruleset.OnlineID },
+                    };
+
                     room.Playlist.Add(new PlaylistItem(new BeatmapInfo { Metadata = new BeatmapMetadata() })
                     {
                         RulesetID = ruleset.OnlineID,

From 8d70b85e41c8bba1aa2c056554c66a59d0002f56 Mon Sep 17 00:00:00 2001
From: Susko3 <16479013+Susko3@users.noreply.github.com>
Date: Mon, 21 Feb 2022 20:20:24 +0100
Subject: [PATCH 3012/5547] Revert changes

---
 osu.Android/OsuGameAndroid.cs     | 35 -------------------------------
 osu.Game/Screens/Menu/MainMenu.cs | 12 -----------
 2 files changed, 47 deletions(-)

diff --git a/osu.Android/OsuGameAndroid.cs b/osu.Android/OsuGameAndroid.cs
index 914a6f7502..050bf2b787 100644
--- a/osu.Android/OsuGameAndroid.cs
+++ b/osu.Android/OsuGameAndroid.cs
@@ -5,11 +5,7 @@ using System;
 using Android.App;
 using Android.OS;
 using osu.Framework.Allocation;
-using osu.Framework.Bindables;
-using osu.Framework.Platform;
-using osu.Framework.Screens;
 using osu.Game;
-using osu.Game.Screens.Menu;
 using osu.Game.Updater;
 using osu.Game.Utils;
 using Xamarin.Essentials;
@@ -21,8 +17,6 @@ namespace osu.Android
         [Cached]
         private readonly OsuGameActivity gameActivity;
 
-        private readonly BindableBool allowExiting = new BindableBool();
-
         public OsuGameAndroid(OsuGameActivity activity)
             : base(null)
         {
@@ -73,45 +67,16 @@ namespace osu.Android
             }
         }
 
-        public override void SetHost(GameHost host)
-        {
-            base.SetHost(host);
-            host.AllowExitingAndroid.AddSource(allowExiting);
-        }
-
         protected override void LoadComplete()
         {
             base.LoadComplete();
             LoadComponentAsync(new GameplayScreenRotationLocker(), Add);
         }
 
-        protected override void ScreenChanged(IScreen current, IScreen newScreen)
-        {
-            base.ScreenChanged(current, newScreen);
-
-            switch (newScreen)
-            {
-                case MainMenu _:
-                    // allow the MainMenu to (dis)allow exiting based on its ButtonSystemState.
-                    allowExiting.Value = true;
-                    break;
-
-                default:
-                    allowExiting.Value = false;
-                    break;
-            }
-        }
-
         protected override UpdateManager CreateUpdateManager() => new SimpleUpdateManager();
 
         protected override BatteryInfo CreateBatteryInfo() => new AndroidBatteryInfo();
 
-        protected override void Dispose(bool isDisposing)
-        {
-            Host.AllowExitingAndroid.RemoveSource(allowExiting);
-            base.Dispose(isDisposing);
-        }
-
         private class AndroidBatteryInfo : BatteryInfo
         {
             public override double ChargeLevel => Battery.ChargeLevel;
diff --git a/osu.Game/Screens/Menu/MainMenu.cs b/osu.Game/Screens/Menu/MainMenu.cs
index 2391903861..8b1bab52b3 100644
--- a/osu.Game/Screens/Menu/MainMenu.cs
+++ b/osu.Game/Screens/Menu/MainMenu.cs
@@ -70,16 +70,12 @@ namespace osu.Game.Screens.Menu
         private ParallaxContainer buttonsContainer;
         private SongTicker songTicker;
 
-        private readonly BindableBool allowExitingAndroid = new BindableBool(true);
-
         [BackgroundDependencyLoader(true)]
         private void load(BeatmapListingOverlay beatmapListing, SettingsOverlay settings, OsuConfigManager config, SessionStatics statics)
         {
             holdDelay = config.GetBindable<float>(OsuSetting.UIHoldActivationDelay);
             loginDisplayed = statics.GetBindable<bool>(Static.LoginOverlayDisplayed);
 
-            host.AllowExitingAndroid.AddSource(allowExitingAndroid);
-
             if (host.CanExit)
             {
                 AddInternal(exitConfirmOverlay = new ExitConfirmOverlay
@@ -138,8 +134,6 @@ namespace osu.Game.Screens.Menu
                         ApplyToBackground(b => b.FadeColour(OsuColour.Gray(0.8f), 500, Easing.OutSine));
                         break;
                 }
-
-                allowExitingAndroid.Value = state == ButtonSystemState.Initial;
             };
 
             buttons.OnSettings = () => settings?.ToggleVisibility();
@@ -303,11 +297,5 @@ namespace osu.Game.Screens.Menu
 
             Schedule(loadSoloSongSelect);
         }
-
-        protected override void Dispose(bool isDisposing)
-        {
-            host.AllowExitingAndroid.RemoveSource(allowExitingAndroid);
-            base.Dispose(isDisposing);
-        }
     }
 }

From 3eee505aa26569059ca0fddf35c202518a484453 Mon Sep 17 00:00:00 2001
From: Susko3 <16479013+Susko3@users.noreply.github.com>
Date: Mon, 21 Feb 2022 20:24:17 +0100
Subject: [PATCH 3013/5547] Update "exit" flow when pressing back on Android

---
 osu.Game/Screens/Menu/ExitConfirmOverlay.cs | 23 ++++++++++++++++++
 osu.Game/Screens/Menu/MainMenu.cs           | 27 +++++++++++++++++++++
 2 files changed, 50 insertions(+)

diff --git a/osu.Game/Screens/Menu/ExitConfirmOverlay.cs b/osu.Game/Screens/Menu/ExitConfirmOverlay.cs
index a90b83c5fe..253ec17c28 100644
--- a/osu.Game/Screens/Menu/ExitConfirmOverlay.cs
+++ b/osu.Game/Screens/Menu/ExitConfirmOverlay.cs
@@ -3,6 +3,7 @@
 
 using osu.Framework.Input.Bindings;
 using osu.Framework.Input.Events;
+using osu.Game.Configuration;
 using osu.Game.Input.Bindings;
 using osu.Game.Overlays;
 
@@ -42,4 +43,26 @@ namespace osu.Game.Screens.Menu
             }
         }
     }
+
+    /// <summary>
+    /// An <see cref="ExitConfirmOverlay"/> that behaves as if the <see cref="OsuSetting.UIHoldActivationDelay"/> is always <c>0</c>.
+    /// </summary>
+    /// <remarks>This is useful for mobile devices using gesture navigation, where holding to confirm is not possible.</remarks>
+    public class NoHoldExitConfirmOverlay : ExitConfirmOverlay, IKeyBindingHandler<GlobalAction>
+    {
+        public new bool OnPressed(KeyBindingPressEvent<GlobalAction> e)
+        {
+            if (e.Repeat)
+                return false;
+
+            if (e.Action == GlobalAction.Back)
+            {
+                Progress.Value = 1;
+                Confirm();
+                return true;
+            }
+
+            return false;
+        }
+    }
 }
diff --git a/osu.Game/Screens/Menu/MainMenu.cs b/osu.Game/Screens/Menu/MainMenu.cs
index 8b1bab52b3..7bc0cb48bf 100644
--- a/osu.Game/Screens/Menu/MainMenu.cs
+++ b/osu.Game/Screens/Menu/MainMenu.cs
@@ -3,6 +3,7 @@
 
 using System;
 using osu.Framework.Allocation;
+using osu.Framework.Audio;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Platform;
@@ -89,6 +90,14 @@ namespace osu.Game.Screens.Menu
                     }
                 });
             }
+            else if (host.CanSuspendToBackground)
+            {
+                AddInternal(exitConfirmOverlay = new NoHoldExitConfirmOverlay
+                {
+                    // treat as if the UIHoldActivationDelay is always 0. see NoHoldExitConfirmOverlay xmldoc for more info.
+                    Action = this.Exit
+                });
+            }
 
             AddRangeInternal(new[]
             {
@@ -148,6 +157,24 @@ namespace osu.Game.Screens.Menu
 
         private void confirmAndExit()
         {
+            if (host.CanSuspendToBackground)
+            {
+                // cancel the overlay as we're not actually exiting.
+                // this is the same action as 'onCancel' in `ConfirmExitDialog`.
+                exitConfirmOverlay.Abort();
+
+                // fade the track so the Bass.Pause() on suspend isn't as jarring.
+                const double fade_time = 500;
+                musicController.CurrentTrack
+                               .VolumeTo(0, fade_time, Easing.Out).Then()
+                               .VolumeTo(1, fade_time, Easing.In);
+
+                host.SuspendToBackground();
+
+                // on hosts that can only suspend, we don't ever want to exit the game.
+                return;
+            }
+
             if (exitConfirmed) return;
 
             exitConfirmed = true;

From cd3641137bc920ef042396125c0c323fd7875fd7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 22 Feb 2022 00:02:54 +0100
Subject: [PATCH 3014/5547] Add `OsuColour` method mapping colours from basic
 theme to mod types

---
 osu.Game/Graphics/OsuColour.cs | 31 +++++++++++++++++++++++++++++++
 1 file changed, 31 insertions(+)

diff --git a/osu.Game/Graphics/OsuColour.cs b/osu.Game/Graphics/OsuColour.cs
index 886ba7ef92..afedf36cad 100644
--- a/osu.Game/Graphics/OsuColour.cs
+++ b/osu.Game/Graphics/OsuColour.cs
@@ -5,6 +5,7 @@ using System;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Game.Beatmaps;
 using osu.Game.Overlays;
+using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Scoring;
 using osu.Game.Scoring;
 using osu.Game.Utils;
@@ -157,6 +158,36 @@ namespace osu.Game.Graphics
             }
         }
 
+        /// <summary>
+        /// Retrieves the main accent colour for a <see cref="ModType"/>.
+        /// </summary>
+        public Color4 ForModType(ModType modType)
+        {
+            switch (modType)
+            {
+                case ModType.Automation:
+                    return Blue1;
+
+                case ModType.DifficultyIncrease:
+                    return Red1;
+
+                case ModType.DifficultyReduction:
+                    return Lime1;
+
+                case ModType.Conversion:
+                    return Purple1;
+
+                case ModType.Fun:
+                    return Pink1;
+
+                case ModType.System:
+                    return Gray7;
+
+                default:
+                    throw new ArgumentOutOfRangeException(nameof(modType), modType, "Unknown mod type");
+            }
+        }
+
         /// <summary>
         /// Returns a foreground text colour that is supposed to contrast well with
         /// the supplied <paramref name="backgroundColour"/>.

From 5186693dad42b370b115da9a304b3fc7873470a8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 22 Feb 2022 00:03:07 +0100
Subject: [PATCH 3015/5547] Implement tiny mod switch

---
 .../UserInterface/TestSceneModSwitchTiny.cs   | 85 +++++++++++++++++
 osu.Game/Rulesets/UI/ModSwitchTiny.cs         | 91 +++++++++++++++++++
 2 files changed, 176 insertions(+)
 create mode 100644 osu.Game.Tests/Visual/UserInterface/TestSceneModSwitchTiny.cs
 create mode 100644 osu.Game/Rulesets/UI/ModSwitchTiny.cs

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneModSwitchTiny.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneModSwitchTiny.cs
new file mode 100644
index 0000000000..dbde7ce425
--- /dev/null
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneModSwitchTiny.cs
@@ -0,0 +1,85 @@
+// 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.Extensions.IEnumerableExtensions;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
+using osu.Framework.Testing;
+using osu.Game.Overlays;
+using osu.Game.Rulesets;
+using osu.Game.Rulesets.Catch;
+using osu.Game.Rulesets.Mania;
+using osu.Game.Rulesets.Osu;
+using osu.Game.Rulesets.Taiko;
+using osu.Game.Rulesets.UI;
+using osuTK;
+
+namespace osu.Game.Tests.Visual.UserInterface
+{
+    [TestFixture]
+    public class TestSceneModSwitchTiny : OsuTestScene
+    {
+        [Test]
+        public void TestOsu() => createSwitchTestFor(new OsuRuleset());
+
+        [Test]
+        public void TestTaiko() => createSwitchTestFor(new TaikoRuleset());
+
+        [Test]
+        public void TestCatch() => createSwitchTestFor(new CatchRuleset());
+
+        [Test]
+        public void TestMania() => createSwitchTestFor(new ManiaRuleset());
+
+        private void createSwitchTestFor(Ruleset ruleset)
+        {
+            AddStep("no colour scheme", () => Child = createContent(ruleset, null));
+
+            foreach (var scheme in Enum.GetValues(typeof(OverlayColourScheme)).Cast<OverlayColourScheme>())
+            {
+                AddStep($"{scheme} colour scheme", () => Child = createContent(ruleset, scheme));
+            }
+
+            AddToggleStep("toggle active", active => this.ChildrenOfType<ModSwitchTiny>().ForEach(s => s.Active.Value = active));
+        }
+
+        private static Drawable createContent(Ruleset ruleset, OverlayColourScheme? colourScheme)
+        {
+            var switchFlow = new FillFlowContainer
+            {
+                RelativeSizeAxes = Axes.Both,
+                Direction = FillDirection.Vertical,
+                Spacing = new Vector2(10),
+                Padding = new MarginPadding(20),
+                ChildrenEnumerable = ruleset.CreateAllMods()
+                                            .GroupBy(mod => mod.Type)
+                                            .Select(group => new FillFlowContainer
+                                            {
+                                                RelativeSizeAxes = Axes.X,
+                                                AutoSizeAxes = Axes.Y,
+                                                Direction = FillDirection.Full,
+                                                Spacing = new Vector2(5),
+                                                ChildrenEnumerable = group.Select(mod => new ModSwitchTiny(mod))
+                                            })
+            };
+
+            if (colourScheme != null)
+            {
+                return new DependencyProvidingContainer
+                {
+                    RelativeSizeAxes = Axes.Both,
+                    CachedDependencies = new (Type, object)[]
+                    {
+                        (typeof(OverlayColourProvider), new OverlayColourProvider(colourScheme.Value))
+                    },
+                    Child = switchFlow
+                };
+            }
+
+            return switchFlow;
+        }
+    }
+}
diff --git a/osu.Game/Rulesets/UI/ModSwitchTiny.cs b/osu.Game/Rulesets/UI/ModSwitchTiny.cs
new file mode 100644
index 0000000000..093c2271b6
--- /dev/null
+++ b/osu.Game/Rulesets/UI/ModSwitchTiny.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.
+
+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.Utils;
+using osu.Game.Graphics;
+using osu.Game.Graphics.Sprites;
+using osu.Game.Overlays;
+using osu.Game.Rulesets.Mods;
+using osuTK;
+using osuTK.Graphics;
+
+#nullable enable
+
+namespace osu.Game.Rulesets.UI
+{
+    public class ModSwitchTiny : CompositeDrawable
+    {
+        public BindableBool Active { get; } = new BindableBool();
+
+        private readonly IMod mod;
+
+        private readonly Box background;
+        private readonly OsuSpriteText acronymText;
+
+        private Color4 activeForegroundColour;
+        private Color4 inactiveForegroundColour;
+
+        private Color4 activeBackgroundColour;
+        private Color4 inactiveBackgroundColour;
+
+        public ModSwitchTiny(IMod mod)
+        {
+            this.mod = mod;
+            Size = new Vector2(73, 30);
+
+            InternalChild = new CircularContainer
+            {
+                RelativeSizeAxes = Axes.Both,
+                Masking = true,
+                Children = new Drawable[]
+                {
+                    background = new Box
+                    {
+                        RelativeSizeAxes = Axes.Both
+                    },
+                    acronymText = new OsuSpriteText
+                    {
+                        Anchor = Anchor.Centre,
+                        Origin = Anchor.Centre,
+                        Shadow = false,
+                        Font = OsuFont.Numeric.With(size: 24, weight: FontWeight.Black),
+                        Text = mod.Acronym,
+                        Margin = new MarginPadding
+                        {
+                            Top = 4
+                        }
+                    }
+                }
+            };
+        }
+
+        [BackgroundDependencyLoader(true)]
+        private void load(OsuColour colours, OverlayColourProvider? colourProvider)
+        {
+            inactiveBackgroundColour = colourProvider?.Background5 ?? colours.Gray3;
+            activeBackgroundColour = colours.ForModType(mod.Type);
+
+            inactiveForegroundColour = colourProvider?.Background2 ?? colours.Gray5;
+            activeForegroundColour = Interpolation.ValueAt<Colour4>(0.1f, Colour4.Black, activeForegroundColour, 0, 1);
+        }
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            Active.BindValueChanged(_ => updateState(), true);
+            FinishTransforms(true);
+        }
+
+        private void updateState()
+        {
+            acronymText.FadeColour(Active.Value ? activeForegroundColour : inactiveForegroundColour, 200, Easing.OutQuint);
+            background.FadeColour(Active.Value ? activeBackgroundColour : inactiveBackgroundColour, 200, Easing.OutQuint);
+        }
+    }
+}

From cfc41a0a366cc0c311cbee0cf1aa9ea37d87784a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 22 Feb 2022 00:03:12 +0100
Subject: [PATCH 3016/5547] Implement small mod switch

---
 .../UserInterface/TestSceneModSwitchSmall.cs  |  85 ++++++++++++++
 osu.Game/Rulesets/UI/ModSwitchSmall.cs        | 109 ++++++++++++++++++
 2 files changed, 194 insertions(+)
 create mode 100644 osu.Game.Tests/Visual/UserInterface/TestSceneModSwitchSmall.cs
 create mode 100644 osu.Game/Rulesets/UI/ModSwitchSmall.cs

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneModSwitchSmall.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneModSwitchSmall.cs
new file mode 100644
index 0000000000..447352b7a6
--- /dev/null
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneModSwitchSmall.cs
@@ -0,0 +1,85 @@
+// 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.Extensions.IEnumerableExtensions;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
+using osu.Framework.Testing;
+using osu.Game.Overlays;
+using osu.Game.Rulesets;
+using osu.Game.Rulesets.Catch;
+using osu.Game.Rulesets.Mania;
+using osu.Game.Rulesets.Osu;
+using osu.Game.Rulesets.Taiko;
+using osu.Game.Rulesets.UI;
+using osuTK;
+
+namespace osu.Game.Tests.Visual.UserInterface
+{
+    [TestFixture]
+    public class TestSceneModSwitchSmall : OsuTestScene
+    {
+        [Test]
+        public void TestOsu() => createSwitchTestFor(new OsuRuleset());
+
+        [Test]
+        public void TestTaiko() => createSwitchTestFor(new TaikoRuleset());
+
+        [Test]
+        public void TestCatch() => createSwitchTestFor(new CatchRuleset());
+
+        [Test]
+        public void TestMania() => createSwitchTestFor(new ManiaRuleset());
+
+        private void createSwitchTestFor(Ruleset ruleset)
+        {
+            AddStep("no colour scheme", () => Child = createContent(ruleset, null));
+
+            foreach (var scheme in Enum.GetValues(typeof(OverlayColourScheme)).Cast<OverlayColourScheme>())
+            {
+                AddStep($"{scheme} colour scheme", () => Child = createContent(ruleset, scheme));
+            }
+
+            AddToggleStep("toggle active", active => this.ChildrenOfType<ModSwitchTiny>().ForEach(s => s.Active.Value = active));
+        }
+
+        private static Drawable createContent(Ruleset ruleset, OverlayColourScheme? colourScheme)
+        {
+            var switchFlow = new FillFlowContainer
+            {
+                RelativeSizeAxes = Axes.Both,
+                Direction = FillDirection.Vertical,
+                Spacing = new Vector2(10),
+                Padding = new MarginPadding(20),
+                ChildrenEnumerable = ruleset.CreateAllMods()
+                                            .GroupBy(mod => mod.Type)
+                                            .Select(group => new FillFlowContainer
+                                            {
+                                                RelativeSizeAxes = Axes.X,
+                                                AutoSizeAxes = Axes.Y,
+                                                Direction = FillDirection.Full,
+                                                Spacing = new Vector2(5),
+                                                ChildrenEnumerable = group.Select(mod => new ModSwitchSmall(mod))
+                                            })
+            };
+
+            if (colourScheme != null)
+            {
+                return new DependencyProvidingContainer
+                {
+                    RelativeSizeAxes = Axes.Both,
+                    CachedDependencies = new (Type, object)[]
+                    {
+                        (typeof(OverlayColourProvider), new OverlayColourProvider(colourScheme.Value))
+                    },
+                    Child = switchFlow
+                };
+            }
+
+            return switchFlow;
+        }
+    }
+}
diff --git a/osu.Game/Rulesets/UI/ModSwitchSmall.cs b/osu.Game/Rulesets/UI/ModSwitchSmall.cs
new file mode 100644
index 0000000000..5d9d9075bc
--- /dev/null
+++ b/osu.Game/Rulesets/UI/ModSwitchSmall.cs
@@ -0,0 +1,109 @@
+// 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.Sprites;
+using osu.Framework.Utils;
+using osu.Game.Graphics;
+using osu.Game.Overlays;
+using osu.Game.Rulesets.Mods;
+using osuTK;
+using osuTK.Graphics;
+
+#nullable enable
+
+namespace osu.Game.Rulesets.UI
+{
+    public class ModSwitchSmall : CompositeDrawable
+    {
+        public BindableBool Active { get; } = new BindableBool();
+
+        private readonly IMod mod;
+
+        private const float size = 60;
+
+        private readonly SpriteIcon background;
+        private readonly SpriteIcon? modIcon;
+
+        private Color4 activeForegroundColour;
+        private Color4 inactiveForegroundColour;
+
+        private Color4 activeBackgroundColour;
+        private Color4 inactiveBackgroundColour;
+
+        public ModSwitchSmall(IMod mod)
+        {
+            this.mod = mod;
+
+            AutoSizeAxes = Axes.Both;
+
+            FillFlowContainer contentFlow;
+            ModSwitchTiny tinySwitch;
+
+            InternalChildren = new Drawable[]
+            {
+                background = new SpriteIcon
+                {
+                    Anchor = Anchor.Centre,
+                    Origin = Anchor.Centre,
+                    Size = new Vector2(size),
+                    Icon = OsuIcon.ModBg
+                },
+                contentFlow = new FillFlowContainer
+                {
+                    AutoSizeAxes = Axes.Both,
+                    Anchor = Anchor.Centre,
+                    Origin = Anchor.Centre,
+                    Spacing = new Vector2(0, 4),
+                    Direction = FillDirection.Vertical,
+                    Child = tinySwitch = new ModSwitchTiny(mod)
+                    {
+                        Anchor = Anchor.TopCentre,
+                        Origin = Anchor.TopCentre,
+                        Scale = new Vector2(0.6f),
+                        Active = { BindTarget = Active }
+                    }
+                }
+            };
+
+            if (mod.Icon != null)
+            {
+                contentFlow.Insert(-1, modIcon = new SpriteIcon
+                {
+                    Anchor = Anchor.TopCentre,
+                    Origin = Anchor.TopCentre,
+                    Size = new Vector2(21),
+                    Icon = mod.Icon.Value
+                });
+                tinySwitch.Scale = new Vector2(0.3f);
+            }
+        }
+
+        [BackgroundDependencyLoader(true)]
+        private void load(OsuColour colours, OverlayColourProvider? colourProvider)
+        {
+            inactiveForegroundColour = colourProvider?.Background5 ?? colours.Gray3;
+            activeForegroundColour = colours.ForModType(mod.Type);
+
+            inactiveBackgroundColour = colourProvider?.Background2 ?? colours.Gray5;
+            activeBackgroundColour = Interpolation.ValueAt<Colour4>(0.1f, Colour4.Black, activeForegroundColour, 0, 1);
+        }
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            Active.BindValueChanged(_ => updateState(), true);
+            FinishTransforms(true);
+        }
+
+        private void updateState()
+        {
+            modIcon?.FadeColour(Active.Value ? activeForegroundColour : inactiveForegroundColour, 200, Easing.OutQuint);
+            background.FadeColour(Active.Value ? activeBackgroundColour : inactiveBackgroundColour, 200, Easing.OutQuint);
+        }
+    }
+}

From 0d56693b7aee6221d16ac2341d86d70b5a805a55 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 22 Feb 2022 14:11:22 +0900
Subject: [PATCH 3017/5547] Fix test not always checking the final bonus value

Due to the previous logic not waiting until the spinner had completed,
there could be false negatives as the check runs too early, with a
potential additional bonus spin occurring afterwards.
---
 .../Mods/TestSceneOsuModSpunOut.cs            | 52 +++++++++++++------
 1 file changed, 37 insertions(+), 15 deletions(-)

diff --git a/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModSpunOut.cs b/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModSpunOut.cs
index e71377a505..cb8eceb213 100644
--- a/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModSpunOut.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModSpunOut.cs
@@ -8,13 +8,15 @@ using NUnit.Framework;
 using osu.Framework.Testing;
 using osu.Framework.Utils;
 using osu.Game.Beatmaps;
+using osu.Game.Rulesets.Judgements;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Objects;
+using osu.Game.Rulesets.Osu.Judgements;
 using osu.Game.Rulesets.Osu.Mods;
 using osu.Game.Rulesets.Osu.Objects;
 using osu.Game.Rulesets.Osu.Objects.Drawables;
 using osu.Game.Rulesets.Osu.Skinning.Default;
-using osu.Game.Screens.Play;
+using osu.Game.Rulesets.Scoring;
 using osuTK;
 
 namespace osu.Game.Rulesets.Osu.Tests.Mods
@@ -66,25 +68,45 @@ namespace osu.Game.Rulesets.Osu.Tests.Mods
         }
 
         [Test]
-        public void TestSpinnerOnlyComplete() => CreateModTest(new ModTestData
+        public void TestSpinnerGetsNoBonusScore()
         {
-            Mod = new OsuModSpunOut(),
-            Autoplay = false,
-            Beatmap = singleSpinnerBeatmap,
-            PassCondition = () =>
+            DrawableSpinner spinner = null;
+            List<JudgementResult> results = new List<JudgementResult>();
+
+            CreateModTest(new ModTestData
             {
-                var spinner = Player.ChildrenOfType<DrawableSpinner>().SingleOrDefault();
-                var gameplayClockContainer = Player.ChildrenOfType<GameplayClockContainer>().SingleOrDefault();
+                Mod = new OsuModSpunOut(),
+                Autoplay = false,
+                Beatmap = singleSpinnerBeatmap,
+                PassCondition = () =>
+                {
+                    // Bind to the first spinner's results for further tracking.
+                    if (spinner == null)
+                    {
+                        // We only care about the first spinner we encounter for this test.
+                        var nextSpinner = Player.ChildrenOfType<DrawableSpinner>().SingleOrDefault();
 
-                if (spinner == null || gameplayClockContainer == null)
-                    return false;
+                        if (nextSpinner == null)
+                            return false;
 
-                if (!Precision.AlmostEquals(gameplayClockContainer.CurrentTime, spinner.HitObject.StartTime + spinner.HitObject.Duration, 200.0f))
-                    return false;
+                        spinner = nextSpinner;
+                        spinner.OnNewResult += (o, result) => results.Add(result);
 
-                return Precision.AlmostEquals(spinner.Progress, 1.0f, 0.05f) && Precision.AlmostEquals(spinner.GainedBonus.Value, 0, 1);
-            }
-        });
+                        results.Clear();
+                    }
+
+                    // we should only be checking the bonus/progress after the spinner has fully completed.
+                    if (!results.OfType<OsuSpinnerJudgementResult>().Any(r => r.TimeCompleted != null))
+                        return false;
+
+                    return
+                        results.Any(r => r.Type == HitResult.SmallTickHit)
+                        && !results.Any(r => r.Type == HitResult.LargeTickHit)
+                        && Precision.AlmostEquals(spinner.Progress, 1.0f, 0.05f)
+                        && Precision.AlmostEquals(spinner.GainedBonus.Value, 0, 1);
+                }
+            });
+        }
 
         private Beatmap singleSpinnerBeatmap => new Beatmap
         {

From 91acc9eec6a8859f665f64338420efc564faf33b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 22 Feb 2022 14:36:08 +0900
Subject: [PATCH 3018/5547] Remove checks which are still going to occasionally
 fail due to pooling

---
 osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModSpunOut.cs | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModSpunOut.cs b/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModSpunOut.cs
index cb8eceb213..93c4bd96de 100644
--- a/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModSpunOut.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModSpunOut.cs
@@ -101,9 +101,7 @@ namespace osu.Game.Rulesets.Osu.Tests.Mods
 
                     return
                         results.Any(r => r.Type == HitResult.SmallTickHit)
-                        && !results.Any(r => r.Type == HitResult.LargeTickHit)
-                        && Precision.AlmostEquals(spinner.Progress, 1.0f, 0.05f)
-                        && Precision.AlmostEquals(spinner.GainedBonus.Value, 0, 1);
+                        && !results.Any(r => r.Type == HitResult.LargeTickHit);
                 }
             });
         }

From 9e279c3ebc9cdc23ba5d4a1d192642b314019de8 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 22 Feb 2022 14:37:52 +0900
Subject: [PATCH 3019/5547] Fix completely incorrect judgement specification

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

diff --git a/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModSpunOut.cs b/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModSpunOut.cs
index 93c4bd96de..e61720d8b9 100644
--- a/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModSpunOut.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModSpunOut.cs
@@ -100,8 +100,8 @@ namespace osu.Game.Rulesets.Osu.Tests.Mods
                         return false;
 
                     return
-                        results.Any(r => r.Type == HitResult.SmallTickHit)
-                        && !results.Any(r => r.Type == HitResult.LargeTickHit);
+                        results.Any(r => r.Type == HitResult.SmallBonus)
+                        && !results.Any(r => r.Type == HitResult.LargeBonus);
                 }
             });
         }

From d6032a2335e0de00dae43ce7f6fcef95ffbbe50e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 22 Feb 2022 14:55:52 +0900
Subject: [PATCH 3020/5547] Fix beatmap overlay not re-fetching results after
 login

---
 .../BeatmapListing/BeatmapListingFilterControl.cs      | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/BeatmapListing/BeatmapListingFilterControl.cs b/osu.Game/Overlays/BeatmapListing/BeatmapListingFilterControl.cs
index 157753c09f..0f87f04270 100644
--- a/osu.Game/Overlays/BeatmapListing/BeatmapListingFilterControl.cs
+++ b/osu.Game/Overlays/BeatmapListing/BeatmapListingFilterControl.cs
@@ -67,6 +67,8 @@ namespace osu.Game.Overlays.BeatmapListing
         [Resolved]
         private IAPIProvider api { get; set; }
 
+        private IBindable<APIUser> apiUser;
+
         public BeatmapListingFilterControl()
         {
             RelativeSizeAxes = Axes.X;
@@ -127,7 +129,7 @@ namespace osu.Game.Overlays.BeatmapListing
         }
 
         [BackgroundDependencyLoader]
-        private void load(OverlayColourProvider colourProvider)
+        private void load(OverlayColourProvider colourProvider, IAPIProvider api)
         {
             sortControlBackground.Colour = colourProvider.Background4;
         }
@@ -161,6 +163,9 @@ namespace osu.Game.Overlays.BeatmapListing
 
             sortCriteria.BindValueChanged(_ => queueUpdateSearch());
             sortDirection.BindValueChanged(_ => queueUpdateSearch());
+
+            apiUser = api.LocalUser.GetBoundCopy();
+            apiUser.BindValueChanged(_ => queueUpdateSearch());
         }
 
         public void TakeFocus() => searchControl.TakeFocus();
@@ -190,6 +195,9 @@ namespace osu.Game.Overlays.BeatmapListing
 
             resetSearch();
 
+            if (!api.IsLoggedIn)
+                return;
+
             queryChangedDebounce = Scheduler.AddDelayed(() =>
             {
                 resetSearch();

From e744840d07aec8f0f6a75abb81ba1bc9dd9dbba8 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 22 Feb 2022 14:56:04 +0900
Subject: [PATCH 3021/5547] Ensure old results are cleared from beatmap overlay
 on logout

---
 osu.Game/Overlays/BeatmapListingOverlay.cs | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/osu.Game/Overlays/BeatmapListingOverlay.cs b/osu.Game/Overlays/BeatmapListingOverlay.cs
index fbed234cc7..3476968ded 100644
--- a/osu.Game/Overlays/BeatmapListingOverlay.cs
+++ b/osu.Game/Overlays/BeatmapListingOverlay.cs
@@ -6,6 +6,7 @@ using System.Linq;
 using System.Threading;
 using System.Threading.Tasks;
 using osu.Framework.Allocation;
+using osu.Framework.Bindables;
 using osu.Framework.Extensions.IEnumerableExtensions;
 using osu.Framework.Localisation;
 using osu.Framework.Graphics;
@@ -19,6 +20,7 @@ using osu.Game.Beatmaps.Drawables.Cards;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.Containers;
+using osu.Game.Online.API;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays.BeatmapListing;
 using osu.Game.Resources.Localisation.Web;
@@ -32,6 +34,11 @@ namespace osu.Game.Overlays
         [Resolved]
         private PreviewTrackManager previewTrackManager { get; set; }
 
+        [Resolved]
+        private IAPIProvider api { get; set; }
+
+        private IBindable<APIUser> apiUser;
+
         private Drawable currentContent;
         private Container panelTarget;
         private FillFlowContainer<BeatmapCard> foundContent;
@@ -93,6 +100,13 @@ namespace osu.Game.Overlays
         {
             base.LoadComplete();
             filterControl.CardSize.BindValueChanged(_ => onCardSizeChanged());
+
+            apiUser = api.LocalUser.GetBoundCopy();
+            apiUser.BindValueChanged(_ =>
+            {
+                if (api.IsLoggedIn)
+                    addContentToResultsArea(Drawable.Empty());
+            });
         }
 
         public void ShowWithSearch(string query)

From cde3d9c08ba8e3b9af8e8e6192c9febdfa306baa Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 22 Feb 2022 15:15:57 +0900
Subject: [PATCH 3022/5547] Change precedence order to favour playlist as a
 source for beatmap count

---
 .../OnlinePlay/Lounge/Components/PlaylistCountPill.cs      | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Screens/OnlinePlay/Lounge/Components/PlaylistCountPill.cs b/osu.Game/Screens/OnlinePlay/Lounge/Components/PlaylistCountPill.cs
index 1aef41efbd..e21439e931 100644
--- a/osu.Game/Screens/OnlinePlay/Lounge/Components/PlaylistCountPill.cs
+++ b/osu.Game/Screens/OnlinePlay/Lounge/Components/PlaylistCountPill.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 Humanizer;
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.LocalisationExtensions;
@@ -46,7 +47,11 @@ namespace osu.Game.Screens.OnlinePlay.Lounge.Components
 
         private void updateCount()
         {
-            int activeItems = PlaylistItemStats.Value?.CountActive ?? Playlist.Count;
+            int activeItems = Playlist.Count > 0 || PlaylistItemStats.Value == null
+                // For now, use the playlist as the source of truth if it has any items.
+                // This allows the count to display correctly on the room screen (after joining a room).
+                ? Playlist.Count(i => !i.Expired)
+                : PlaylistItemStats.Value.CountActive;
 
             count.Clear();
             count.AddText(activeItems.ToLocalisableString(), s => s.Font = s.Font.With(weight: FontWeight.Bold));

From f12044b03e97da4bbb883dd026c267f796345fe6 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 22 Feb 2022 15:31:08 +0900
Subject: [PATCH 3023/5547] Add mention of `PlaylistItem.Beatmap` being a
 placeholder in many cases

---
 osu.Game/Online/Rooms/PlaylistItem.cs | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/osu.Game/Online/Rooms/PlaylistItem.cs b/osu.Game/Online/Rooms/PlaylistItem.cs
index 33718f050b..f696362cbb 100644
--- a/osu.Game/Online/Rooms/PlaylistItem.cs
+++ b/osu.Game/Online/Rooms/PlaylistItem.cs
@@ -62,6 +62,10 @@ namespace osu.Game.Online.Rooms
         [JsonProperty("beatmap_id")]
         private int onlineBeatmapId => Beatmap.OnlineID;
 
+        /// <summary>
+        /// A beatmap representing this playlist item.
+        /// In many cases, this will *not* contain any usable information apart from OnlineID.
+        /// </summary>
         [JsonIgnore]
         public IBeatmapInfo Beatmap { get; set; } = null!;
 

From 057fd6c352c354367ba5056dc7ed8c92976391de Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 22 Feb 2022 15:37:42 +0900
Subject: [PATCH 3024/5547] Add mention of `StarRatingRangeDisplay` fallback
 scenario being wrong for multiplayer

---
 .../Screens/OnlinePlay/Components/StarRatingRangeDisplay.cs     | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/osu.Game/Screens/OnlinePlay/Components/StarRatingRangeDisplay.cs b/osu.Game/Screens/OnlinePlay/Components/StarRatingRangeDisplay.cs
index de56e6ff86..0b673006ef 100644
--- a/osu.Game/Screens/OnlinePlay/Components/StarRatingRangeDisplay.cs
+++ b/osu.Game/Screens/OnlinePlay/Components/StarRatingRangeDisplay.cs
@@ -94,6 +94,8 @@ namespace osu.Game.Screens.OnlinePlay.Components
             }
             else
             {
+                // In multiplayer rooms, the beatmaps of playlist items will not be populated to a point this can be correct.
+                // Either populating them via BeatmapLookupCache or polling the API for the room's DifficultyRange will be required.
                 var orderedDifficulties = Playlist.Select(p => p.Beatmap).OrderBy(b => b.StarRating).ToArray();
 
                 minDifficulty = new StarDifficulty(orderedDifficulties.Length > 0 ? orderedDifficulties[0].StarRating : 0, 0);

From 347a2346b9d73352a482b882d81ad49cf8ed4176 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 22 Feb 2022 15:40:30 +0900
Subject: [PATCH 3025/5547] Fix `TestSceneEditorSaving` not waiting for
 timeline load

As seen at
https://github.com/ppy/osu/runs/5276431764?check_suite_focus=true.
---
 osu.Game.Tests/Visual/Editing/TestSceneEditorSaving.cs | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneEditorSaving.cs b/osu.Game.Tests/Visual/Editing/TestSceneEditorSaving.cs
index adaa24d542..d1c1558003 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneEditorSaving.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneEditorSaving.cs
@@ -49,6 +49,8 @@ namespace osu.Game.Tests.Visual.Editing
             double originalTimelineZoom = 0;
             double changedTimelineZoom = 0;
 
+            AddUntilStep("wait for timeline load", () => Editor.ChildrenOfType<Timeline>().SingleOrDefault()?.IsLoaded == true);
+
             AddStep("Set beat divisor", () => Editor.Dependencies.Get<BindableBeatDivisor>().Value = 16);
             AddStep("Set timeline zoom", () =>
             {

From 61b3280de157b86d6b6ad61558902c491e617fc5 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 22 Feb 2022 15:47:00 +0900
Subject: [PATCH 3026/5547] Add missing property copies in `Room.CopyFrom`
 implementation

---
 osu.Game/Online/Rooms/Room.cs | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/osu.Game/Online/Rooms/Room.cs b/osu.Game/Online/Rooms/Room.cs
index d24cb7e74b..8ed37ad6b5 100644
--- a/osu.Game/Online/Rooms/Room.cs
+++ b/osu.Game/Online/Rooms/Room.cs
@@ -194,6 +194,8 @@ namespace osu.Game.Online.Rooms
             EndDate.Value = other.EndDate.Value;
             UserScore.Value = other.UserScore.Value;
             QueueMode.Value = other.QueueMode.Value;
+            DifficultyRange.Value = other.DifficultyRange.Value;
+            PlaylistItemStats.Value = other.PlaylistItemStats.Value;
 
             if (EndDate.Value != null && DateTimeOffset.Now >= EndDate.Value)
                 Status.Value = new RoomStatusEnded();

From ca0a04115374368184ca8363ac7026384b9c9dcf Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 22 Feb 2022 16:45:04 +0900
Subject: [PATCH 3027/5547] Fix missing escaping causing test failures
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/Online/Chat/MessageFormatter.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Online/Chat/MessageFormatter.cs b/osu.Game/Online/Chat/MessageFormatter.cs
index 4c477d58b6..39a51876c2 100644
--- a/osu.Game/Online/Chat/MessageFormatter.cs
+++ b/osu.Game/Online/Chat/MessageFormatter.cs
@@ -269,7 +269,7 @@ namespace osu.Game.Online.Chat
             handleAdvanced(advanced_link_regex, result, startIndex);
 
             // handle editor times
-            handleMatches(time_regex, "{0}", $"{OsuGameBase.OSU_PROTOCOL}edit/{0}", result, startIndex, LinkAction.OpenEditorTimestamp);
+            handleMatches(time_regex, "{0}", $@"{OsuGameBase.OSU_PROTOCOL}edit/{{0}}", result, startIndex, LinkAction.OpenEditorTimestamp);
 
             // handle channels
             handleMatches(channel_regex, "{0}", $"{OsuGameBase.OSU_PROTOCOL}chan/{0}", result, startIndex, LinkAction.OpenChannel);

From ed008267d7a932c64dac5a3566af1bcdd145e415 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 22 Feb 2022 16:45:18 +0900
Subject: [PATCH 3028/5547] Fix one more case of escaping not being present
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/Online/Chat/MessageFormatter.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Online/Chat/MessageFormatter.cs b/osu.Game/Online/Chat/MessageFormatter.cs
index 39a51876c2..333c554d44 100644
--- a/osu.Game/Online/Chat/MessageFormatter.cs
+++ b/osu.Game/Online/Chat/MessageFormatter.cs
@@ -272,7 +272,7 @@ namespace osu.Game.Online.Chat
             handleMatches(time_regex, "{0}", $@"{OsuGameBase.OSU_PROTOCOL}edit/{{0}}", result, startIndex, LinkAction.OpenEditorTimestamp);
 
             // handle channels
-            handleMatches(channel_regex, "{0}", $"{OsuGameBase.OSU_PROTOCOL}chan/{0}", result, startIndex, LinkAction.OpenChannel);
+            handleMatches(channel_regex, "{0}", $@"{OsuGameBase.OSU_PROTOCOL}chan/{{0}}", result, startIndex, LinkAction.OpenChannel);
 
             string empty = "";
             while (space-- > 0)

From 5efffa208acc118d8acf16cae9a609318e85b7b1 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 22 Feb 2022 17:08:09 +0900
Subject: [PATCH 3029/5547] Add test coverage of beatmap set overlay actually
 showing requested beatmap

---
 .../TestSceneStartupBeatmapDisplay.cs         | 34 ++++++++++++++++++-
 .../TestSceneStartupBeatmapSetDisplay.cs      | 32 ++++++++++++++++-
 2 files changed, 64 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneStartupBeatmapDisplay.cs b/osu.Game.Tests/Visual/Navigation/TestSceneStartupBeatmapDisplay.cs
index 1efa24435e..961b7dedc3 100644
--- a/osu.Game.Tests/Visual/Navigation/TestSceneStartupBeatmapDisplay.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneStartupBeatmapDisplay.cs
@@ -5,18 +5,50 @@ using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Testing;
+using osu.Game.Online.API;
+using osu.Game.Online.API.Requests;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays;
+using osu.Game.Overlays.BeatmapSet;
 
 namespace osu.Game.Tests.Visual.Navigation
 {
     public class TestSceneStartupBeatmapDisplay : OsuGameTestScene
     {
-        protected override TestOsuGame CreateTestGame() => new TestOsuGame(LocalStorage, API, new[] { "osu://b/75" });
+        private const int requested_beatmap_id = 75;
+        private const int requested_beatmap_set_id = 1;
+
+        protected override TestOsuGame CreateTestGame() => new TestOsuGame(LocalStorage, API, new[] { $"osu://b/{requested_beatmap_id}" });
+
+        [SetUp]
+        public void Setup() => Schedule(() =>
+        {
+            ((DummyAPIAccess)API).HandleRequest = request =>
+            {
+                switch (request)
+                {
+                    case GetBeatmapSetRequest gbr:
+                        var apiBeatmapSet = CreateAPIBeatmapSet();
+                        apiBeatmapSet.OnlineID = requested_beatmap_set_id;
+                        apiBeatmapSet.Beatmaps = apiBeatmapSet.Beatmaps.Append(new APIBeatmap
+                        {
+                            DifficultyName = "Target difficulty",
+                            OnlineID = requested_beatmap_id,
+                        }).ToArray();
+
+                        gbr.TriggerSuccess(apiBeatmapSet);
+                        return true;
+                }
+
+                return false;
+            };
+        });
 
         [Test]
         public void TestBeatmapLink()
         {
             AddUntilStep("Beatmap overlay displayed", () => Game.ChildrenOfType<BeatmapSetOverlay>().FirstOrDefault()?.State.Value == Visibility.Visible);
+            AddUntilStep("Beatmap overlay showing content", () => Game.ChildrenOfType<BeatmapPicker>().FirstOrDefault()?.Beatmap.Value.OnlineID == requested_beatmap_id);
         }
     }
 }
diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneStartupBeatmapSetDisplay.cs b/osu.Game.Tests/Visual/Navigation/TestSceneStartupBeatmapSetDisplay.cs
index 1339c514e4..1aa56896d3 100644
--- a/osu.Game.Tests/Visual/Navigation/TestSceneStartupBeatmapSetDisplay.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneStartupBeatmapSetDisplay.cs
@@ -5,18 +5,48 @@ using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Testing;
+using osu.Game.Online.API;
+using osu.Game.Online.API.Requests;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays;
 
 namespace osu.Game.Tests.Visual.Navigation
 {
     public class TestSceneStartupBeatmapSetDisplay : OsuGameTestScene
     {
-        protected override TestOsuGame CreateTestGame() => new TestOsuGame(LocalStorage, API, new[] { "osu://s/1" });
+        private const int requested_beatmap_set_id = 1;
+
+        protected override TestOsuGame CreateTestGame() => new TestOsuGame(LocalStorage, API, new[] { $"osu://s/{requested_beatmap_set_id}" });
+
+        [SetUp]
+        public void Setup() => Schedule(() =>
+        {
+            ((DummyAPIAccess)API).HandleRequest = request =>
+            {
+                switch (request)
+                {
+                    case GetBeatmapSetRequest gbr:
+
+                        var apiBeatmapSet = CreateAPIBeatmapSet();
+                        apiBeatmapSet.OnlineID = requested_beatmap_set_id;
+                        apiBeatmapSet.Beatmaps = apiBeatmapSet.Beatmaps.Append(new APIBeatmap
+                        {
+                            DifficultyName = "Target difficulty",
+                            OnlineID = 75,
+                        }).ToArray();
+                        gbr.TriggerSuccess(apiBeatmapSet);
+                        return true;
+                }
+
+                return false;
+            };
+        });
 
         [Test]
         public void TestBeatmapSetLink()
         {
             AddUntilStep("Beatmap overlay displayed", () => Game.ChildrenOfType<BeatmapSetOverlay>().FirstOrDefault()?.State.Value == Visibility.Visible);
+            AddUntilStep("Beatmap overlay showing content", () => Game.ChildrenOfType<BeatmapSetOverlay>().FirstOrDefault()?.Header.BeatmapSet.Value.OnlineID == requested_beatmap_set_id);
         }
     }
 }

From 6de4e05e492aa7ff03e068000ffdf83cb2dd65d5 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 22 Feb 2022 17:14:00 +0900
Subject: [PATCH 3030/5547] Fix current selection not being correctly
 maintained when `BeatmapPicker` updates its display

---
 osu.Game/Overlays/BeatmapSet/BeatmapPicker.cs | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/BeatmapSet/BeatmapPicker.cs b/osu.Game/Overlays/BeatmapSet/BeatmapPicker.cs
index 59e8e8db3c..031442814d 100644
--- a/osu.Game/Overlays/BeatmapSet/BeatmapPicker.cs
+++ b/osu.Game/Overlays/BeatmapSet/BeatmapPicker.cs
@@ -183,7 +183,14 @@ namespace osu.Game.Overlays.BeatmapSet
             }
 
             starRatingContainer.FadeOut(100);
-            Beatmap.Value = Difficulties.FirstOrDefault()?.Beatmap;
+
+            // If a selection is already made, try and maintain it.
+            if (Beatmap.Value != null)
+                Beatmap.Value = Difficulties.FirstOrDefault(b => b.Beatmap.OnlineID == Beatmap.Value.OnlineID)?.Beatmap;
+
+            // Else just choose the first available difficulty for now.
+            Beatmap.Value ??= Difficulties.FirstOrDefault()?.Beatmap;
+
             plays.Value = BeatmapSet?.PlayCount ?? 0;
             favourites.Value = BeatmapSet?.FavouriteCount ?? 0;
 

From bedd07d2e4dca93e160949614f9f1a75f03a2fe2 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 22 Feb 2022 18:12:55 +0900
Subject: [PATCH 3031/5547] Add remark about usage of CalculateAll()

---
 osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs b/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs
index 7d6c235fc1..0935f26de6 100644
--- a/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs
+++ b/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs
@@ -120,6 +120,9 @@ namespace osu.Game.Rulesets.Difficulty
         /// <summary>
         /// Calculates the difficulty of the beatmap using all mod combinations applicable to the beatmap.
         /// </summary>
+        /// <remarks>
+        /// This should only be used to compute difficulties for legacy mod combinations.
+        /// </remarks>
         /// <returns>A collection of structures describing the difficulty of the beatmap for each mod combination.</returns>
         public IEnumerable<DifficultyAttributes> CalculateAll(CancellationToken cancellationToken = default)
         {

From d1d6847d3205d5ea1226dc063d7315b95cd47491 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 22 Feb 2022 22:24:37 +0100
Subject: [PATCH 3032/5547] Add comment about split usage in osu:// protocol
 link handling

---
 osu.Game/OsuGame.cs | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index 390e96d768..77eec004c0 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -921,6 +921,9 @@ namespace osu.Game
             if (!url.StartsWith(OSU_PROTOCOL, StringComparison.Ordinal))
                 throw new ArgumentException("Invalid osu URL provided.", nameof(url));
 
+            // note that `StringSplitOptions.RemoveEmptyEntries` is not explicitly specified here
+            // in order to ensure that the protocol URL is valid (i.e. it has two slashes in the `osu://` part,
+            // causing the link content to be stored to the 2nd index rather than the 1st).
             string[] pieces = url.Split('/');
 
             switch (pieces[2])

From d8fa443ea0eb21f607253aa9d8de679d94a51800 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 22 Feb 2022 23:22:00 +0100
Subject: [PATCH 3033/5547] Extract default mod switch measurements to
 constants

For use later when specific sizes/scales of the mod switches are
desired.
---
 osu.Game/Rulesets/UI/ModSwitchSmall.cs | 6 +++---
 osu.Game/Rulesets/UI/ModSwitchTiny.cs  | 4 +++-
 2 files changed, 6 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Rulesets/UI/ModSwitchSmall.cs b/osu.Game/Rulesets/UI/ModSwitchSmall.cs
index 5d9d9075bc..676bbac95c 100644
--- a/osu.Game/Rulesets/UI/ModSwitchSmall.cs
+++ b/osu.Game/Rulesets/UI/ModSwitchSmall.cs
@@ -21,9 +21,9 @@ namespace osu.Game.Rulesets.UI
     {
         public BindableBool Active { get; } = new BindableBool();
 
-        private readonly IMod mod;
+        public const float DEFAULT_SIZE = 60;
 
-        private const float size = 60;
+        private readonly IMod mod;
 
         private readonly SpriteIcon background;
         private readonly SpriteIcon? modIcon;
@@ -49,7 +49,7 @@ namespace osu.Game.Rulesets.UI
                 {
                     Anchor = Anchor.Centre,
                     Origin = Anchor.Centre,
-                    Size = new Vector2(size),
+                    Size = new Vector2(DEFAULT_SIZE),
                     Icon = OsuIcon.ModBg
                 },
                 contentFlow = new FillFlowContainer
diff --git a/osu.Game/Rulesets/UI/ModSwitchTiny.cs b/osu.Game/Rulesets/UI/ModSwitchTiny.cs
index 093c2271b6..b1d453f588 100644
--- a/osu.Game/Rulesets/UI/ModSwitchTiny.cs
+++ b/osu.Game/Rulesets/UI/ModSwitchTiny.cs
@@ -22,6 +22,8 @@ namespace osu.Game.Rulesets.UI
     {
         public BindableBool Active { get; } = new BindableBool();
 
+        public const float DEFAULT_HEIGHT = 30;
+
         private readonly IMod mod;
 
         private readonly Box background;
@@ -36,7 +38,7 @@ namespace osu.Game.Rulesets.UI
         public ModSwitchTiny(IMod mod)
         {
             this.mod = mod;
-            Size = new Vector2(73, 30);
+            Size = new Vector2(73, DEFAULT_HEIGHT);
 
             InternalChild = new CircularContainer
             {

From 7bdcb5952ed67bc895da12833767bc3746326d85 Mon Sep 17 00:00:00 2001
From: Susko3 <16479013+Susko3@users.noreply.github.com>
Date: Wed, 23 Feb 2022 00:36:56 +0100
Subject: [PATCH 3034/5547] Fix handling badly-formatted osu:// urls

---
 osu.Game/Online/Chat/MessageFormatter.cs | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/osu.Game/Online/Chat/MessageFormatter.cs b/osu.Game/Online/Chat/MessageFormatter.cs
index d7974004b1..3517777325 100644
--- a/osu.Game/Online/Chat/MessageFormatter.cs
+++ b/osu.Game/Online/Chat/MessageFormatter.cs
@@ -236,8 +236,7 @@ namespace osu.Game.Online.Chat
                             break;
 
                         default:
-                            linkType = LinkAction.External;
-                            break;
+                            return new LinkDetails(LinkAction.External, url);
                     }
 
                     return new LinkDetails(linkType, args[2]);

From 2bea485af8da9bddd5fe404dd71e967a3c9b631b Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 23 Feb 2022 13:37:45 +0900
Subject: [PATCH 3035/5547] Fix currently playing text not showing in lounge

---
 osu.Game/Screens/OnlinePlay/OnlinePlayComposite.cs | 14 ++++++++++----
 1 file changed, 10 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/OnlinePlayComposite.cs b/osu.Game/Screens/OnlinePlay/OnlinePlayComposite.cs
index 3148b74c9c..7d1feb0316 100644
--- a/osu.Game/Screens/OnlinePlay/OnlinePlayComposite.cs
+++ b/osu.Game/Screens/OnlinePlay/OnlinePlayComposite.cs
@@ -91,9 +91,15 @@ namespace osu.Game.Screens.OnlinePlay
             Playlist.BindCollectionChanged((_, __) => UpdateSelectedItem(), true);
         }
 
-        protected virtual void UpdateSelectedItem()
-            => SelectedItem.Value = RoomID.Value == null || subScreenSelectedItem == null
-                ? Playlist.GetCurrentItem()
-                : subScreenSelectedItem.Value;
+        protected void UpdateSelectedItem()
+        {
+            if (RoomID.Value == null || subScreenSelectedItem == null)
+            {
+                SelectedItem.Value = CurrentPlaylistItem.Value ?? Playlist.GetCurrentItem();
+                return;
+            }
+
+            SelectedItem.Value = subScreenSelectedItem.Value;
+        }
     }
 }

From 71a012bea6021ad559da8ccce2f92413bff80c21 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 23 Feb 2022 13:42:47 +0900
Subject: [PATCH 3036/5547] Don't update count twice immediately
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>
---
 .../Screens/OnlinePlay/Lounge/Components/PlaylistCountPill.cs   | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Screens/OnlinePlay/Lounge/Components/PlaylistCountPill.cs b/osu.Game/Screens/OnlinePlay/Lounge/Components/PlaylistCountPill.cs
index e21439e931..a6bbcd548d 100644
--- a/osu.Game/Screens/OnlinePlay/Lounge/Components/PlaylistCountPill.cs
+++ b/osu.Game/Screens/OnlinePlay/Lounge/Components/PlaylistCountPill.cs
@@ -41,7 +41,7 @@ namespace osu.Game.Screens.OnlinePlay.Lounge.Components
         {
             base.LoadComplete();
 
-            PlaylistItemStats.BindValueChanged(_ => updateCount(), true);
+            PlaylistItemStats.BindValueChanged(_ => updateCount());
             Playlist.BindCollectionChanged((_, __) => updateCount(), true);
         }
 

From 87da650dfb5651c608562865a37db35a0e04c32e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 23 Feb 2022 13:51:25 +0900
Subject: [PATCH 3037/5547] Update framework

---
 osu.Android.props                           | 2 +-
 osu.Game/Tests/Visual/SkinnableTestScene.cs | 2 +-
 osu.Game/osu.Game.csproj                    | 2 +-
 osu.iOS.props                               | 4 ++--
 4 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/osu.Android.props b/osu.Android.props
index 24a0d20874..526ce959a6 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -52,7 +52,7 @@
   </ItemGroup>
   <ItemGroup>
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.211.0" />
-    <PackageReference Include="ppy.osu.Framework.Android" Version="2022.217.0" />
+    <PackageReference Include="ppy.osu.Framework.Android" Version="2022.223.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
     <!-- Realm needs to be directly referenced in all Xamarin projects, as it will not pull in its transitive dependencies otherwise. -->
diff --git a/osu.Game/Tests/Visual/SkinnableTestScene.cs b/osu.Game/Tests/Visual/SkinnableTestScene.cs
index cd675e467b..1107089a46 100644
--- a/osu.Game/Tests/Visual/SkinnableTestScene.cs
+++ b/osu.Game/Tests/Visual/SkinnableTestScene.cs
@@ -43,7 +43,7 @@ namespace osu.Game.Tests.Visual
         [BackgroundDependencyLoader]
         private void load()
         {
-            var dllStore = new DllResourceStore(DynamicCompilationOriginal.GetType().Assembly);
+            var dllStore = new DllResourceStore(GetType().Assembly);
 
             metricsSkin = new TestLegacySkin(new SkinInfo { Name = "metrics-skin" }, new NamespacedResourceStore<byte[]>(dllStore, "Resources/metrics_skin"), this, true);
             defaultSkin = new DefaultLegacySkin(this);
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 4c6f81defa..7dfd099df1 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="10.9.0" />
-    <PackageReference Include="ppy.osu.Framework" Version="2022.217.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2022.223.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.211.0" />
     <PackageReference Include="Sentry" Version="3.14.0" />
     <PackageReference Include="SharpCompress" Version="0.30.1" />
diff --git a/osu.iOS.props b/osu.iOS.props
index 99b9de3fe2..9d0e1790f0 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -60,7 +60,7 @@
     <Reference Include="System.Net.Http" />
   </ItemGroup>
   <ItemGroup Label="Package References">
-    <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.217.0" />
+    <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.223.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.211.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net6.0) -->
@@ -83,7 +83,7 @@
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="5.0.14" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.Core" Version="5.0.14" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
-    <PackageReference Include="ppy.osu.Framework" Version="2022.217.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2022.223.0" />
     <PackageReference Include="SharpCompress" Version="0.30.1" />
     <PackageReference Include="NUnit" Version="3.13.2" />
     <PackageReference Include="System.ComponentModel.Annotations" Version="5.0.0" />

From a6b6644c2e441513bfba493fbe56e307996bd4ad Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 23 Feb 2022 16:22:13 +0900
Subject: [PATCH 3038/5547] Replace LINQ queries with recommendations

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

diff --git a/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModSpunOut.cs b/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModSpunOut.cs
index e61720d8b9..70b7d1f740 100644
--- a/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModSpunOut.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModSpunOut.cs
@@ -96,12 +96,12 @@ namespace osu.Game.Rulesets.Osu.Tests.Mods
                     }
 
                     // we should only be checking the bonus/progress after the spinner has fully completed.
-                    if (!results.OfType<OsuSpinnerJudgementResult>().Any(r => r.TimeCompleted != null))
+                    if (results.OfType<OsuSpinnerJudgementResult>().All(r => r.TimeCompleted == null))
                         return false;
 
                     return
                         results.Any(r => r.Type == HitResult.SmallBonus)
-                        && !results.Any(r => r.Type == HitResult.LargeBonus);
+                        && results.All(r => r.Type != HitResult.LargeBonus);
                 }
             });
         }

From 054ed546e3800e6aa0425b362b68dacf9e19fb75 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 23 Feb 2022 16:56:50 +0900
Subject: [PATCH 3039/5547] Fix intermittent failures in remaining test method

---
 .../Mods/TestSceneOsuModSpunOut.cs            | 36 +++++++++++++++----
 1 file changed, 30 insertions(+), 6 deletions(-)

diff --git a/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModSpunOut.cs b/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModSpunOut.cs
index 70b7d1f740..a8953c1a6f 100644
--- a/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModSpunOut.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModSpunOut.cs
@@ -26,13 +26,37 @@ namespace osu.Game.Rulesets.Osu.Tests.Mods
         protected override bool AllowFail => true;
 
         [Test]
-        public void TestSpinnerAutoCompleted() => CreateModTest(new ModTestData
+        public void TestSpinnerAutoCompleted()
         {
-            Mod = new OsuModSpunOut(),
-            Autoplay = false,
-            Beatmap = singleSpinnerBeatmap,
-            PassCondition = () => Player.ChildrenOfType<DrawableSpinner>().SingleOrDefault()?.Progress >= 1
-        });
+            DrawableSpinner spinner = null;
+            JudgementResult lastResult = null;
+
+            CreateModTest(new ModTestData
+            {
+                Mod = new OsuModSpunOut(),
+                Autoplay = false,
+                Beatmap = singleSpinnerBeatmap,
+                PassCondition = () =>
+                {
+                    // Bind to the first spinner's results for further tracking.
+                    if (spinner == null)
+                    {
+                        // We only care about the first spinner we encounter for this test.
+                        var nextSpinner = Player.ChildrenOfType<DrawableSpinner>().SingleOrDefault();
+
+                        if (nextSpinner == null)
+                            return false;
+
+                        lastResult = null;
+
+                        spinner = nextSpinner;
+                        spinner.OnNewResult += (o, result) => lastResult = result;
+                    }
+
+                    return lastResult?.Type == HitResult.Great;
+                }
+            });
+        }
 
         [TestCase(null)]
         [TestCase(typeof(OsuModDoubleTime))]

From 5d73691de4e13ed827d0a731ea909e7b33d115d7 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 23 Feb 2022 17:02:39 +0900
Subject: [PATCH 3040/5547] Use existing `HandleLink` flow rather than
 reimplmenting

---
 osu.Game/OsuGame.cs | 26 +-------------------------
 1 file changed, 1 insertion(+), 25 deletions(-)

diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index 77eec004c0..fa5a336b7c 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -906,7 +906,7 @@ namespace osu.Game
 
                     if (firstPath.StartsWith(OSU_PROTOCOL, StringComparison.Ordinal))
                     {
-                        handleOsuProtocolUrl(firstPath);
+                        HandleLink(firstPath);
                     }
                     else
                     {
@@ -916,30 +916,6 @@ namespace osu.Game
             }
         }
 
-        private void handleOsuProtocolUrl(string url)
-        {
-            if (!url.StartsWith(OSU_PROTOCOL, StringComparison.Ordinal))
-                throw new ArgumentException("Invalid osu URL provided.", nameof(url));
-
-            // note that `StringSplitOptions.RemoveEmptyEntries` is not explicitly specified here
-            // in order to ensure that the protocol URL is valid (i.e. it has two slashes in the `osu://` part,
-            // causing the link content to be stored to the 2nd index rather than the 1st).
-            string[] pieces = url.Split('/');
-
-            switch (pieces[2])
-            {
-                case "s":
-                    if (int.TryParse(pieces[3], out int beatmapSetId))
-                        ShowBeatmapSet(beatmapSetId);
-                    break;
-
-                case "b":
-                    if (int.TryParse(pieces[3], out int beatmapId))
-                        ShowBeatmap(beatmapId);
-                    break;
-            }
-        }
-
         private void showOverlayAboveOthers(OverlayContainer overlay, OverlayContainer[] otherOverlays)
         {
             otherOverlays.Where(o => o != overlay).ForEach(o => o.Hide());

From 28c9c5ab6a0ac889223a7f46ba6b16504cc9a3ae Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 23 Feb 2022 17:05:46 +0900
Subject: [PATCH 3041/5547] Remove unnecessary `ShouldSerialize` rules in
 `Room`

---
 osu.Game/Online/Rooms/Room.cs | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/osu.Game/Online/Rooms/Room.cs b/osu.Game/Online/Rooms/Room.cs
index 8ed37ad6b5..7512d4fcf9 100644
--- a/osu.Game/Online/Rooms/Room.cs
+++ b/osu.Game/Online/Rooms/Room.cs
@@ -230,15 +230,9 @@ namespace osu.Game.Online.Rooms
         // They rely on being named exactly the same as the corresponding fields (casing included) and as such should NOT be renamed
         // unless the fields are also renamed.
 
-        [UsedImplicitly]
-        public bool ShouldSerializeRoomID() => false;
-
         [UsedImplicitly]
         public bool ShouldSerializeHost() => false;
 
-        [UsedImplicitly]
-        public bool ShouldSerializeEndDate() => false;
-
         #endregion
 
         [JsonObject(MemberSerialization.OptIn)]

From f14a9af801c53552356f798a74e68fb6a18b4a3d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 23 Feb 2022 17:06:40 +0900
Subject: [PATCH 3042/5547] Make `Room` opt-in rather than opt-out for json
 serialization

---
 osu.Game/Online/Rooms/Room.cs | 9 +--------
 1 file changed, 1 insertion(+), 8 deletions(-)

diff --git a/osu.Game/Online/Rooms/Room.cs b/osu.Game/Online/Rooms/Room.cs
index 7512d4fcf9..5deedaaa6b 100644
--- a/osu.Game/Online/Rooms/Room.cs
+++ b/osu.Game/Online/Rooms/Room.cs
@@ -15,6 +15,7 @@ using osu.Game.Utils;
 
 namespace osu.Game.Online.Rooms
 {
+    [JsonObject(MemberSerialization.OptIn)]
     public class Room : IDeepCloneable<Room>
     {
         [Cached]
@@ -49,7 +50,6 @@ namespace osu.Game.Online.Rooms
         public readonly Bindable<RoomDifficultyRange> DifficultyRange = new Bindable<RoomDifficultyRange>();
 
         [Cached]
-        [JsonIgnore]
         public readonly Bindable<RoomCategory> Category = new Bindable<RoomCategory>();
 
         // Todo: osu-framework bug (https://github.com/ppy/osu-framework/issues/4106)
@@ -62,19 +62,15 @@ namespace osu.Game.Online.Rooms
         }
 
         [Cached]
-        [JsonIgnore]
         public readonly Bindable<int?> MaxAttempts = new Bindable<int?>();
 
         [Cached]
-        [JsonIgnore]
         public readonly Bindable<RoomStatus> Status = new Bindable<RoomStatus>(new RoomStatusOpen());
 
         [Cached]
-        [JsonIgnore]
         public readonly Bindable<RoomAvailability> Availability = new Bindable<RoomAvailability>();
 
         [Cached]
-        [JsonIgnore]
         public readonly Bindable<MatchType> Type = new Bindable<MatchType>();
 
         // Todo: osu-framework bug (https://github.com/ppy/osu-framework/issues/4106)
@@ -87,7 +83,6 @@ namespace osu.Game.Online.Rooms
         }
 
         [Cached]
-        [JsonIgnore]
         public readonly Bindable<QueueMode> QueueMode = new Bindable<QueueMode>();
 
         [JsonConverter(typeof(SnakeCaseStringEnumConverter))]
@@ -99,7 +94,6 @@ namespace osu.Game.Online.Rooms
         }
 
         [Cached]
-        [JsonIgnore]
         public readonly Bindable<int?> MaxParticipants = new Bindable<int?>();
 
         [Cached]
@@ -124,7 +118,6 @@ namespace osu.Game.Online.Rooms
         public readonly Bindable<string> Password = new Bindable<string>();
 
         [Cached]
-        [JsonIgnore]
         public readonly Bindable<TimeSpan?> Duration = new Bindable<TimeSpan?>();
 
         [JsonProperty("duration")]

From 43c83d2de1cd2cb861ba57f80dc903c837cb8181 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 23 Feb 2022 17:07:29 +0900
Subject: [PATCH 3043/5547] Add note about why `RoomID` is nulled in
 `DeepClone`

---
 osu.Game/Online/Rooms/Room.cs | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/osu.Game/Online/Rooms/Room.cs b/osu.Game/Online/Rooms/Room.cs
index 5deedaaa6b..b301c81921 100644
--- a/osu.Game/Online/Rooms/Room.cs
+++ b/osu.Game/Online/Rooms/Room.cs
@@ -162,6 +162,8 @@ namespace osu.Game.Online.Rooms
             var copy = new Room();
 
             copy.CopyFrom(this);
+
+            // ID must be unset as we use this as a marker for whether this is a client-side (not-yet-created) room or not.
             copy.RoomID.Value = null;
 
             return copy;

From 53bbd0067545fbfc99e131de0a1bb6918980ed4e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 23 Feb 2022 17:12:38 +0900
Subject: [PATCH 3044/5547] Also make `APIUser` opt-in and remove the remaining
 serialization exclusion rule

---
 osu.Game/Online/API/Requests/Responses/APIUser.cs |  1 +
 osu.Game/Online/Rooms/Room.cs                     | 12 ------------
 2 files changed, 1 insertion(+), 12 deletions(-)

diff --git a/osu.Game/Online/API/Requests/Responses/APIUser.cs b/osu.Game/Online/API/Requests/Responses/APIUser.cs
index 2b64e5de06..a53ac1cd9b 100644
--- a/osu.Game/Online/API/Requests/Responses/APIUser.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIUser.cs
@@ -12,6 +12,7 @@ using osu.Game.Users;
 
 namespace osu.Game.Online.API.Requests.Responses
 {
+    [JsonObject(MemberSerialization.OptIn)]
     public class APIUser : IEquatable<APIUser>, IUser
     {
         [JsonProperty(@"id")]
diff --git a/osu.Game/Online/Rooms/Room.cs b/osu.Game/Online/Rooms/Room.cs
index b301c81921..c7f34905e2 100644
--- a/osu.Game/Online/Rooms/Room.cs
+++ b/osu.Game/Online/Rooms/Room.cs
@@ -3,7 +3,6 @@
 
 using System;
 using System.Linq;
-using JetBrains.Annotations;
 using Newtonsoft.Json;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
@@ -219,17 +218,6 @@ namespace osu.Game.Online.Rooms
                 Playlist.RemoveAll(i => i.Expired);
         }
 
-        #region Newtonsoft.Json implicit ShouldSerialize() methods
-
-        // The properties in this region are used implicitly by Newtonsoft.Json to not serialise certain fields in some cases.
-        // They rely on being named exactly the same as the corresponding fields (casing included) and as such should NOT be renamed
-        // unless the fields are also renamed.
-
-        [UsedImplicitly]
-        public bool ShouldSerializeHost() => false;
-
-        #endregion
-
         [JsonObject(MemberSerialization.OptIn)]
         public class RoomPlaylistItemStats
         {

From 5dd0d48df968594b86f4463fc1634dc9c93abbe0 Mon Sep 17 00:00:00 2001
From: Susko3 <16479013+Susko3@users.noreply.github.com>
Date: Wed, 23 Feb 2022 14:06:22 +0100
Subject: [PATCH 3045/5547] Move the key handling logic to MainMenu and
 simplify it

Also makes use of the host.SuspendToBackground() return value.
---
 osu.Game/Screens/Menu/ExitConfirmOverlay.cs | 23 --------
 osu.Game/Screens/Menu/MainMenu.cs           | 59 +++++++++++----------
 2 files changed, 32 insertions(+), 50 deletions(-)

diff --git a/osu.Game/Screens/Menu/ExitConfirmOverlay.cs b/osu.Game/Screens/Menu/ExitConfirmOverlay.cs
index 253ec17c28..a90b83c5fe 100644
--- a/osu.Game/Screens/Menu/ExitConfirmOverlay.cs
+++ b/osu.Game/Screens/Menu/ExitConfirmOverlay.cs
@@ -3,7 +3,6 @@
 
 using osu.Framework.Input.Bindings;
 using osu.Framework.Input.Events;
-using osu.Game.Configuration;
 using osu.Game.Input.Bindings;
 using osu.Game.Overlays;
 
@@ -43,26 +42,4 @@ namespace osu.Game.Screens.Menu
             }
         }
     }
-
-    /// <summary>
-    /// An <see cref="ExitConfirmOverlay"/> that behaves as if the <see cref="OsuSetting.UIHoldActivationDelay"/> is always <c>0</c>.
-    /// </summary>
-    /// <remarks>This is useful for mobile devices using gesture navigation, where holding to confirm is not possible.</remarks>
-    public class NoHoldExitConfirmOverlay : ExitConfirmOverlay, IKeyBindingHandler<GlobalAction>
-    {
-        public new bool OnPressed(KeyBindingPressEvent<GlobalAction> e)
-        {
-            if (e.Repeat)
-                return false;
-
-            if (e.Action == GlobalAction.Back)
-            {
-                Progress.Value = 1;
-                Confirm();
-                return true;
-            }
-
-            return false;
-        }
-    }
 }
diff --git a/osu.Game/Screens/Menu/MainMenu.cs b/osu.Game/Screens/Menu/MainMenu.cs
index 7bc0cb48bf..a2cb448d40 100644
--- a/osu.Game/Screens/Menu/MainMenu.cs
+++ b/osu.Game/Screens/Menu/MainMenu.cs
@@ -6,12 +6,15 @@ using osu.Framework.Allocation;
 using osu.Framework.Audio;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
+using osu.Framework.Input.Bindings;
+using osu.Framework.Input.Events;
 using osu.Framework.Platform;
 using osu.Framework.Screens;
 using osu.Game.Beatmaps;
 using osu.Game.Configuration;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
+using osu.Game.Input.Bindings;
 using osu.Game.IO;
 using osu.Game.Online.API;
 using osu.Game.Overlays;
@@ -26,7 +29,7 @@ using osuTK.Graphics;
 
 namespace osu.Game.Screens.Menu
 {
-    public class MainMenu : OsuScreen, IHandlePresentBeatmap
+    public class MainMenu : OsuScreen, IHandlePresentBeatmap, IKeyBindingHandler<GlobalAction>
     {
         public const float FADE_IN_DURATION = 300;
 
@@ -90,14 +93,6 @@ namespace osu.Game.Screens.Menu
                     }
                 });
             }
-            else if (host.CanSuspendToBackground)
-            {
-                AddInternal(exitConfirmOverlay = new NoHoldExitConfirmOverlay
-                {
-                    // treat as if the UIHoldActivationDelay is always 0. see NoHoldExitConfirmOverlay xmldoc for more info.
-                    Action = this.Exit
-                });
-            }
 
             AddRangeInternal(new[]
             {
@@ -157,24 +152,6 @@ namespace osu.Game.Screens.Menu
 
         private void confirmAndExit()
         {
-            if (host.CanSuspendToBackground)
-            {
-                // cancel the overlay as we're not actually exiting.
-                // this is the same action as 'onCancel' in `ConfirmExitDialog`.
-                exitConfirmOverlay.Abort();
-
-                // fade the track so the Bass.Pause() on suspend isn't as jarring.
-                const double fade_time = 500;
-                musicController.CurrentTrack
-                               .VolumeTo(0, fade_time, Easing.Out).Then()
-                               .VolumeTo(1, fade_time, Easing.In);
-
-                host.SuspendToBackground();
-
-                // on hosts that can only suspend, we don't ever want to exit the game.
-                return;
-            }
-
             if (exitConfirmed) return;
 
             exitConfirmed = true;
@@ -324,5 +301,33 @@ namespace osu.Game.Screens.Menu
 
             Schedule(loadSoloSongSelect);
         }
+
+        public bool OnPressed(KeyBindingPressEvent<GlobalAction> e)
+        {
+            if (e.Repeat)
+                return false;
+
+            if (e.Action == GlobalAction.Back && host.CanSuspendToBackground)
+            {
+                bool didSuspend = host.SuspendToBackground();
+
+                if (didSuspend)
+                {
+                    // fade the track so the Bass.Pause() on suspend isn't as jarring.
+                    const double fade_time = 500;
+                    musicController.CurrentTrack
+                                   .VolumeTo(0, fade_time, Easing.Out).Then()
+                                   .VolumeTo(1, fade_time, Easing.In);
+
+                    return true;
+                }
+            }
+
+            return false;
+        }
+
+        public void OnReleased(KeyBindingReleaseEvent<GlobalAction> e)
+        {
+        }
     }
 }

From 5ff4d3f8e5fca93f662bf4d0d0d171b712a7c43f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 15 Feb 2022 19:05:46 +0900
Subject: [PATCH 3046/5547] Add support to `SpectatorClient` to resend failed
 frame bundles

---
 osu.Game/Online/Spectator/SpectatorClient.cs | 48 ++++++++++++++------
 1 file changed, 33 insertions(+), 15 deletions(-)

diff --git a/osu.Game/Online/Spectator/SpectatorClient.cs b/osu.Game/Online/Spectator/SpectatorClient.cs
index a54ea0d9ee..ba0a9a77a0 100644
--- a/osu.Game/Online/Spectator/SpectatorClient.cs
+++ b/osu.Game/Online/Spectator/SpectatorClient.cs
@@ -168,8 +168,6 @@ namespace osu.Game.Online.Spectator
             });
         }
 
-        public void SendFrames(FrameDataBundle data) => lastSend = SendFramesInternal(data);
-
         public void EndPlaying(GameplayState state)
         {
             // This method is most commonly called via Dispose(), which is can be asynchronous (via the AsyncDisposalQueue).
@@ -180,7 +178,7 @@ namespace osu.Game.Online.Spectator
                     return;
 
                 if (pendingFrames.Count > 0)
-                    purgePendingFrames(true);
+                    purgePendingFrames();
 
                 IsPlaying = false;
                 currentBeatmap = null;
@@ -230,9 +228,11 @@ namespace osu.Game.Online.Spectator
 
         protected abstract Task StopWatchingUserInternal(int userId);
 
+        private readonly Queue<FrameDataBundle> pendingFrameBundles = new Queue<FrameDataBundle>();
+
         private readonly Queue<LegacyReplayFrame> pendingFrames = new Queue<LegacyReplayFrame>();
 
-        private double lastSendTime;
+        private double lastPurgeTime;
 
         private Task? lastSend;
 
@@ -242,7 +242,7 @@ namespace osu.Game.Online.Spectator
         {
             base.Update();
 
-            if (pendingFrames.Count > 0 && Time.Current - lastSendTime > TIME_BETWEEN_SENDS)
+            if (pendingFrames.Count > 0 && Time.Current - lastPurgeTime > TIME_BETWEEN_SENDS)
                 purgePendingFrames();
         }
 
@@ -260,23 +260,41 @@ namespace osu.Game.Online.Spectator
                 purgePendingFrames();
         }
 
-        private void purgePendingFrames(bool force = false)
+        private void purgePendingFrames()
         {
-            if (lastSend?.IsCompleted == false && !force)
-                return;
-
             if (pendingFrames.Count == 0)
                 return;
 
-            var frames = pendingFrames.ToArray();
-
-            pendingFrames.Clear();
-
             Debug.Assert(currentScore != null);
 
-            SendFrames(new FrameDataBundle(currentScore.ScoreInfo, frames));
+            var frames = pendingFrames.ToArray();
+            var bundle = new FrameDataBundle(currentScore.ScoreInfo, frames);
 
-            lastSendTime = Time.Current;
+            pendingFrames.Clear();
+            lastPurgeTime = Time.Current;
+
+            pendingFrameBundles.Enqueue(bundle);
+
+            sendNextBundleIfRequired();
+        }
+
+        private void sendNextBundleIfRequired()
+        {
+            if (lastSend?.IsCompleted == false)
+                return;
+
+            if (!pendingFrameBundles.TryPeek(out var bundle))
+                return;
+
+            lastSend = SendFramesInternal(bundle);
+            lastSend.ContinueWith(t => Schedule(() =>
+            {
+                // If the last bundle send wasn't successful, try again without dequeuing.
+                if (t.IsCompletedSuccessfully)
+                    pendingFrameBundles.Dequeue();
+
+                sendNextBundleIfRequired();
+            }));
         }
     }
 }

From cff6f854724c8ce4f8ba8935734664a5e5f7c048 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 15 Feb 2022 19:08:32 +0900
Subject: [PATCH 3047/5547] Add note about reconnection being insufficient
 currently

---
 osu.Game/Online/Spectator/SpectatorClient.cs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Game/Online/Spectator/SpectatorClient.cs b/osu.Game/Online/Spectator/SpectatorClient.cs
index ba0a9a77a0..7afceb41a4 100644
--- a/osu.Game/Online/Spectator/SpectatorClient.cs
+++ b/osu.Game/Online/Spectator/SpectatorClient.cs
@@ -94,6 +94,7 @@ namespace osu.Game.Online.Spectator
 
                     // re-send state in case it wasn't received
                     if (IsPlaying)
+                        // TODO: this is likely sent out of order after a reconnect scenario. needs further consideration.
                         BeginPlayingInternal(currentState);
                 }
                 else

From 14c8ce50a0849fb97882db3f9dd2a9553ac118bc Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 22 Feb 2022 17:56:07 +0900
Subject: [PATCH 3048/5547] Prefix all test send methods in
 `TestSpectatorClient` with `Send`

---
 osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs | 10 +++++-----
 .../TestSceneMultiSpectatorLeaderboard.cs            |  2 +-
 .../Multiplayer/TestSceneMultiSpectatorScreen.cs     | 12 ++++++------
 .../TestSceneMultiplayerGameplayLeaderboard.cs       |  2 +-
 .../TestSceneMultiplayerGameplayLeaderboardTeams.cs  |  2 +-
 .../Online/TestSceneCurrentlyPlayingDisplay.cs       |  4 ++--
 .../Tests/Visual/Spectator/TestSpectatorClient.cs    |  7 ++-----
 7 files changed, 18 insertions(+), 21 deletions(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs
index d47ebf9f0d..d6f8c7addf 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs
@@ -257,7 +257,7 @@ namespace osu.Game.Tests.Visual.Gameplay
             sendFrames();
             waitForPlayer();
 
-            AddStep("send passed", () => spectatorClient.EndPlay(streamingUser.Id, SpectatedUserState.Passed));
+            AddStep("send passed", () => spectatorClient.SendEndPlay(streamingUser.Id, SpectatedUserState.Passed));
             AddUntilStep("state is passed", () => spectatorClient.WatchedUserStates[streamingUser.Id].State == SpectatedUserState.Passed);
 
             start();
@@ -275,7 +275,7 @@ namespace osu.Game.Tests.Visual.Gameplay
             sendFrames();
             waitForPlayer();
 
-            AddStep("send quit", () => spectatorClient.EndPlay(streamingUser.Id));
+            AddStep("send quit", () => spectatorClient.SendEndPlay(streamingUser.Id));
             AddUntilStep("state is quit", () => spectatorClient.WatchedUserStates[streamingUser.Id].State == SpectatedUserState.Quit);
 
             start();
@@ -293,7 +293,7 @@ namespace osu.Game.Tests.Visual.Gameplay
             sendFrames();
             waitForPlayer();
 
-            AddStep("send failed", () => spectatorClient.EndPlay(streamingUser.Id, SpectatedUserState.Failed));
+            AddStep("send failed", () => spectatorClient.SendEndPlay(streamingUser.Id, SpectatedUserState.Failed));
             AddUntilStep("state is failed", () => spectatorClient.WatchedUserStates[streamingUser.Id].State == SpectatedUserState.Failed);
 
             start();
@@ -312,9 +312,9 @@ namespace osu.Game.Tests.Visual.Gameplay
 
         private void waitForPlayer() => AddUntilStep("wait for player", () => (Stack.CurrentScreen as Player)?.IsLoaded == true);
 
-        private void start(int? beatmapId = null) => AddStep("start play", () => spectatorClient.StartPlay(streamingUser.Id, beatmapId ?? importedBeatmapId));
+        private void start(int? beatmapId = null) => AddStep("start play", () => spectatorClient.SendStartPlay(streamingUser.Id, beatmapId ?? importedBeatmapId));
 
-        private void finish(SpectatedUserState state = SpectatedUserState.Quit) => AddStep("end play", () => spectatorClient.EndPlay(streamingUser.Id, state));
+        private void finish(SpectatedUserState state = SpectatedUserState.Quit) => AddStep("end play", () => spectatorClient.SendEndPlay(streamingUser.Id, state));
 
         private void checkPaused(bool state) =>
             AddUntilStep($"game is {(state ? "paused" : "playing")}", () => player.ChildrenOfType<DrawableRuleset>().First().IsPaused.Value == state);
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorLeaderboard.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorLeaderboard.cs
index 6b3573b3cb..488ecdb8af 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorLeaderboard.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorLeaderboard.cs
@@ -34,7 +34,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
                 foreach ((int userId, var _) in clocks)
                 {
-                    SpectatorClient.StartPlay(userId, 0);
+                    SpectatorClient.SendStartPlay(userId, 0);
                     OnlinePlayDependencies.MultiplayerClient.AddUser(new APIUser { Id = userId });
                 }
             });
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs
index 7ce0c6a94d..a785301f62 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs
@@ -70,11 +70,11 @@ namespace osu.Game.Tests.Visual.Multiplayer
             loadSpectateScreen(false);
 
             AddWaitStep("wait a bit", 10);
-            AddStep("load player first_player_id", () => SpectatorClient.StartPlay(PLAYER_1_ID, importedBeatmapId));
+            AddStep("load player first_player_id", () => SpectatorClient.SendStartPlay(PLAYER_1_ID, importedBeatmapId));
             AddUntilStep("one player added", () => spectatorScreen.ChildrenOfType<Player>().Count() == 1);
 
             AddWaitStep("wait a bit", 10);
-            AddStep("load player second_player_id", () => SpectatorClient.StartPlay(PLAYER_2_ID, importedBeatmapId));
+            AddStep("load player second_player_id", () => SpectatorClient.SendStartPlay(PLAYER_2_ID, importedBeatmapId));
             AddUntilStep("two players added", () => spectatorScreen.ChildrenOfType<Player>().Count() == 2);
         }
 
@@ -133,8 +133,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     TeamID = 1,
                 };
 
-                SpectatorClient.StartPlay(player1.UserID, importedBeatmapId);
-                SpectatorClient.StartPlay(player2.UserID, importedBeatmapId);
+                SpectatorClient.SendStartPlay(player1.UserID, importedBeatmapId);
+                SpectatorClient.SendStartPlay(player2.UserID, importedBeatmapId);
 
                 playingUsers.Add(player1);
                 playingUsers.Add(player2);
@@ -397,7 +397,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     };
 
                     OnlinePlayDependencies.MultiplayerClient.AddUser(user.User, true);
-                    SpectatorClient.StartPlay(id, beatmapId ?? importedBeatmapId);
+                    SpectatorClient.SendStartPlay(id, beatmapId ?? importedBeatmapId);
 
                     playingUsers.Add(user);
                 }
@@ -411,7 +411,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 var user = playingUsers.Single(u => u.UserID == userId);
 
                 OnlinePlayDependencies.MultiplayerClient.RemoveUser(user.User.AsNonNull());
-                SpectatorClient.EndPlay(userId);
+                SpectatorClient.SendEndPlay(userId);
 
                 playingUsers.Remove(user);
             });
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs
index 6605f82d5c..cfac5da4ff 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs
@@ -58,7 +58,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
                 foreach (int user in users)
                 {
-                    SpectatorClient.StartPlay(user, Beatmap.Value.BeatmapInfo.OnlineID);
+                    SpectatorClient.SendStartPlay(user, Beatmap.Value.BeatmapInfo.OnlineID);
                     multiplayerUsers.Add(OnlinePlayDependencies.MultiplayerClient.AddUser(new APIUser { Id = user }, true));
                 }
 
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboardTeams.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboardTeams.cs
index dabc1c1e5a..f751b162d1 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboardTeams.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboardTeams.cs
@@ -62,7 +62,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
                 foreach (int user in users)
                 {
-                    SpectatorClient.StartPlay(user, Beatmap.Value.BeatmapInfo.OnlineID);
+                    SpectatorClient.SendStartPlay(user, Beatmap.Value.BeatmapInfo.OnlineID);
                     var roomUser = OnlinePlayDependencies.MultiplayerClient.AddUser(new APIUser { Id = user }, true);
 
                     roomUser.MatchState = new TeamVersusUserState
diff --git a/osu.Game.Tests/Visual/Online/TestSceneCurrentlyPlayingDisplay.cs b/osu.Game.Tests/Visual/Online/TestSceneCurrentlyPlayingDisplay.cs
index b5a03b558d..35a4f8cf2d 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneCurrentlyPlayingDisplay.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneCurrentlyPlayingDisplay.cs
@@ -56,9 +56,9 @@ namespace osu.Game.Tests.Visual.Online
         [Test]
         public void TestBasicDisplay()
         {
-            AddStep("Add playing user", () => spectatorClient.StartPlay(streamingUser.Id, 0));
+            AddStep("Add playing user", () => spectatorClient.SendStartPlay(streamingUser.Id, 0));
             AddUntilStep("Panel loaded", () => currentlyPlaying.ChildrenOfType<UserGridPanel>()?.FirstOrDefault()?.User.Id == 2);
-            AddStep("Remove playing user", () => spectatorClient.EndPlay(streamingUser.Id));
+            AddStep("Remove playing user", () => spectatorClient.SendEndPlay(streamingUser.Id));
             AddUntilStep("Panel no longer present", () => !currentlyPlaying.ChildrenOfType<UserGridPanel>().Any());
         }
 
diff --git a/osu.Game/Tests/Visual/Spectator/TestSpectatorClient.cs b/osu.Game/Tests/Visual/Spectator/TestSpectatorClient.cs
index 1322a99ea7..741b489d95 100644
--- a/osu.Game/Tests/Visual/Spectator/TestSpectatorClient.cs
+++ b/osu.Game/Tests/Visual/Spectator/TestSpectatorClient.cs
@@ -3,7 +3,6 @@
 
 #nullable enable
 
-using System;
 using System.Collections.Generic;
 using System.Diagnostics;
 using System.Threading.Tasks;
@@ -47,7 +46,7 @@ namespace osu.Game.Tests.Visual.Spectator
         /// </summary>
         /// <param name="userId">The user to start play for.</param>
         /// <param name="beatmapId">The playing beatmap id.</param>
-        public void StartPlay(int userId, int beatmapId)
+        public void SendStartPlay(int userId, int beatmapId)
         {
             userBeatmapDictionary[userId] = beatmapId;
             userNextFrameDictionary[userId] = 0;
@@ -59,7 +58,7 @@ namespace osu.Game.Tests.Visual.Spectator
         /// </summary>
         /// <param name="userId">The user to end play for.</param>
         /// <param name="state">The spectator state to end play with.</param>
-        public void EndPlay(int userId, SpectatedUserState state = SpectatedUserState.Quit)
+        public void SendEndPlay(int userId, SpectatedUserState state = SpectatedUserState.Quit)
         {
             if (!userBeatmapDictionary.ContainsKey(userId))
                 return;
@@ -74,8 +73,6 @@ namespace osu.Game.Tests.Visual.Spectator
             userBeatmapDictionary.Remove(userId);
         }
 
-        public new void Schedule(Action action) => base.Schedule(action);
-
         /// <summary>
         /// Sends frames for an arbitrary user, in bundles containing 10 frames each.
         /// </summary>

From c94e7e2abe98799d9372b2d0ba4f5fc91fc668a7 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 24 Feb 2022 02:18:35 +0900
Subject: [PATCH 3049/5547] Add ability to simulate network failures to
 `TestSpectatorClient`

---
 .../Visual/Gameplay/TestSceneSpectator.cs     |  2 +-
 .../TestSceneMultiSpectatorLeaderboard.cs     |  4 ++--
 .../TestSceneMultiSpectatorScreen.cs          |  4 ++--
 .../Visual/Spectator/TestSpectatorClient.cs   | 20 ++++++++++++++++---
 4 files changed, 22 insertions(+), 8 deletions(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs
index d6f8c7addf..d614815316 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs
@@ -321,7 +321,7 @@ namespace osu.Game.Tests.Visual.Gameplay
 
         private void sendFrames(int count = 10)
         {
-            AddStep("send frames", () => spectatorClient.SendFrames(streamingUser.Id, count));
+            AddStep("send frames", () => spectatorClient.SendFramesFromUser(streamingUser.Id, count));
         }
 
         private void loadSpectatingScreen()
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorLeaderboard.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorLeaderboard.cs
index 488ecdb8af..42bb99de24 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorLeaderboard.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorLeaderboard.cs
@@ -68,10 +68,10 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 // For player 2, send frames in sets of 10.
                 for (int i = 0; i < 100; i++)
                 {
-                    SpectatorClient.SendFrames(PLAYER_1_ID, 1);
+                    SpectatorClient.SendFramesFromUser(PLAYER_1_ID, 1);
 
                     if (i % 10 == 0)
-                        SpectatorClient.SendFrames(PLAYER_2_ID, 10);
+                        SpectatorClient.SendFramesFromUser(PLAYER_2_ID, 10);
                 }
             });
 
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs
index a785301f62..4b89efe858 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs
@@ -360,7 +360,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             // to ensure negative gameplay start time does not affect spectator, send frames exactly after StartGameplay().
             // (similar to real spectating sessions in which the first frames get sent between StartGameplay() and player load complete)
-            AddStep("send frames at gameplay start", () => getInstance(PLAYER_1_ID).OnGameplayStarted += () => SpectatorClient.SendFrames(PLAYER_1_ID, 100));
+            AddStep("send frames at gameplay start", () => getInstance(PLAYER_1_ID).OnGameplayStarted += () => SpectatorClient.SendFramesFromUser(PLAYER_1_ID, 100));
 
             AddUntilStep("wait for player load", () => spectatorScreen.AllPlayersLoaded);
 
@@ -424,7 +424,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddStep("send frames", () =>
             {
                 foreach (int id in userIds)
-                    SpectatorClient.SendFrames(id, count);
+                    SpectatorClient.SendFramesFromUser(id, count);
             });
         }
 
diff --git a/osu.Game/Tests/Visual/Spectator/TestSpectatorClient.cs b/osu.Game/Tests/Visual/Spectator/TestSpectatorClient.cs
index 741b489d95..ae5d20f4f4 100644
--- a/osu.Game/Tests/Visual/Spectator/TestSpectatorClient.cs
+++ b/osu.Game/Tests/Visual/Spectator/TestSpectatorClient.cs
@@ -3,6 +3,7 @@
 
 #nullable enable
 
+using System;
 using System.Collections.Generic;
 using System.Diagnostics;
 using System.Threading.Tasks;
@@ -20,10 +21,15 @@ namespace osu.Game.Tests.Visual.Spectator
     public class TestSpectatorClient : SpectatorClient
     {
         /// <summary>
-        /// Maximum number of frames sent per bundle via <see cref="SendFrames"/>.
+        /// Maximum number of frames sent per bundle via <see cref="SendFramesFromUser"/>.
         /// </summary>
         public const int FRAME_BUNDLE_SIZE = 10;
 
+        /// <summary>
+        /// Whether to force send operations to fail (simulating a network issue).
+        /// </summary>
+        public bool ShouldFailSendingFrames { get; set; }
+
         public override IBindable<bool> IsConnected { get; } = new Bindable<bool>(true);
 
         public IReadOnlyDictionary<int, ReplayFrame> LastReceivedUserFrames => lastReceivedUserFrames;
@@ -75,10 +81,12 @@ namespace osu.Game.Tests.Visual.Spectator
 
         /// <summary>
         /// Sends frames for an arbitrary user, in bundles containing 10 frames each.
+        /// This bypasses the standard queueing mechanism completely and should only be used to test cases where multiple users need to be sending data.
+        /// Importantly, <see cref="ShouldFailSendingFrames"/> will have no effect.
         /// </summary>
         /// <param name="userId">The user to send frames for.</param>
         /// <param name="count">The total number of frames to send.</param>
-        public void SendFrames(int userId, int count)
+        public void SendFramesFromUser(int userId, int count)
         {
             var frames = new List<LegacyReplayFrame>();
 
@@ -120,7 +128,13 @@ namespace osu.Game.Tests.Visual.Spectator
             return ((ISpectatorClient)this).UserBeganPlaying(api.LocalUser.Value.Id, state);
         }
 
-        protected override Task SendFramesInternal(FrameDataBundle data) => ((ISpectatorClient)this).UserSentFrames(api.LocalUser.Value.Id, data);
+        protected override Task SendFramesInternal(FrameDataBundle bundle)
+        {
+            if (ShouldFailSendingFrames)
+                return Task.FromException(new InvalidOperationException());
+
+            return ((ISpectatorClient)this).UserSentFrames(api.LocalUser.Value.Id, bundle);
+        }
 
         protected override Task EndPlayingInternal(SpectatorState state) => ((ISpectatorClient)this).UserFinishedPlaying(api.LocalUser.Value.Id, state);
 

From 47b84295a6c32c4b9ac4ae4a8cd6d3d26d5206be Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 24 Feb 2022 02:19:12 +0900
Subject: [PATCH 3050/5547] Fix bundle send logic not correctly waiting for
 task completion (due to nested schedule)

---
 osu.Game/Online/Spectator/SpectatorClient.cs | 17 ++++++++++++-----
 1 file changed, 12 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Online/Spectator/SpectatorClient.cs b/osu.Game/Online/Spectator/SpectatorClient.cs
index 7afceb41a4..428a4cdbdb 100644
--- a/osu.Game/Online/Spectator/SpectatorClient.cs
+++ b/osu.Game/Online/Spectator/SpectatorClient.cs
@@ -221,8 +221,7 @@ namespace osu.Game.Online.Spectator
 
         protected abstract Task BeginPlayingInternal(SpectatorState state);
 
-        protected abstract Task SendFramesInternal(FrameDataBundle data);
-
+        protected abstract Task SendFramesInternal(FrameDataBundle bundle);
         protected abstract Task EndPlayingInternal(SpectatorState state);
 
         protected abstract Task WatchUserInternal(int userId);
@@ -281,19 +280,27 @@ namespace osu.Game.Online.Spectator
 
         private void sendNextBundleIfRequired()
         {
+            Debug.Assert(ThreadSafety.IsUpdateThread);
+
             if (lastSend?.IsCompleted == false)
                 return;
 
             if (!pendingFrameBundles.TryPeek(out var bundle))
                 return;
 
-            lastSend = SendFramesInternal(bundle);
-            lastSend.ContinueWith(t => Schedule(() =>
+            TaskCompletionSource<bool> tcs = new TaskCompletionSource<bool>();
+
+            lastSend = tcs.Task;
+
+            SendFramesInternal(bundle).ContinueWith(t => Schedule(() =>
             {
+                bool wasSuccessful = t.Exception == null;
+
                 // If the last bundle send wasn't successful, try again without dequeuing.
-                if (t.IsCompletedSuccessfully)
+                if (wasSuccessful)
                     pendingFrameBundles.Dequeue();
 
+                tcs.SetResult(wasSuccessful);
                 sendNextBundleIfRequired();
             }));
         }

From 260cf793fefe2e3f862373e2f35c7c1bf18de8ef Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 24 Feb 2022 02:18:42 +0900
Subject: [PATCH 3051/5547] Add test coverage of more advanced frame delivery
 scenarios to `TestSceneSpectatorPlayback`

---
 .../Gameplay/TestSceneSpectatorPlayback.cs    | 57 +++++++++++++++----
 .../Visual/Spectator/TestSpectatorClient.cs   |  4 ++
 2 files changed, 51 insertions(+), 10 deletions(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorPlayback.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorPlayback.cs
index a4d8460846..4ec46036f6 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorPlayback.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorPlayback.cs
@@ -41,8 +41,12 @@ namespace osu.Game.Tests.Visual.Gameplay
 
         private Replay replay;
 
+        private TestSpectatorClient spectatorClient;
+
         private ManualClock manualClock;
 
+        private TestReplayRecorder recorder;
+
         private OsuSpriteText latencyDisplay;
 
         private TestFramedReplayInputHandler replayHandler;
@@ -54,7 +58,6 @@ namespace osu.Game.Tests.Visual.Gameplay
             {
                 replay = new Replay();
                 manualClock = new ManualClock();
-                SpectatorClient spectatorClient;
 
                 Child = new DependencyProvidingContainer
                 {
@@ -76,7 +79,7 @@ namespace osu.Game.Tests.Visual.Gameplay
                                 {
                                     recordingManager = new TestRulesetInputManager(TestSceneModSettings.CreateTestRulesetInfo(), 0, SimultaneousBindingMode.Unique)
                                     {
-                                        Recorder = new TestReplayRecorder
+                                        Recorder = recorder = new TestReplayRecorder
                                         {
                                             ScreenSpaceToGamefield = pos => recordingManager.ToLocalSpace(pos),
                                         },
@@ -143,22 +146,52 @@ namespace osu.Game.Tests.Visual.Gameplay
             });
         }
 
+        [Test]
+        public void TestBasic()
+        {
+            AddUntilStep("received frames", () => replay.Frames.Count > 50);
+            AddStep("stop sending frames", () => recorder.Expire());
+            AddUntilStep("wait for all frames received", () => replay.Frames.Count == recorder.SentFrames.Count);
+        }
+
+        [Test]
+        public void TestWithSendFailure()
+        {
+            AddUntilStep("received frames", () => replay.Frames.Count > 50);
+
+            int framesReceivedSoFar = 0;
+            int frameSendAttemptsSoFar = 0;
+
+            AddStep("start failing sends", () =>
+            {
+                spectatorClient.ShouldFailSendingFrames = true;
+                framesReceivedSoFar = replay.Frames.Count;
+                frameSendAttemptsSoFar = spectatorClient.FrameSendAttempts;
+            });
+
+            AddUntilStep("wait for send attempts", () => spectatorClient.FrameSendAttempts > frameSendAttemptsSoFar + 5);
+            AddAssert("frames did not increase", () => framesReceivedSoFar == replay.Frames.Count);
+
+            AddStep("stop failing sends", () => spectatorClient.ShouldFailSendingFrames = false);
+
+            AddUntilStep("wait for next frames", () => framesReceivedSoFar < replay.Frames.Count);
+
+            AddStep("stop sending frames", () => recorder.Expire());
+
+            AddUntilStep("wait for all frames received", () => replay.Frames.Count == recorder.SentFrames.Count);
+            AddAssert("ensure frames were received in the correct sequence", () => replay.Frames.Select(f => f.Time).SequenceEqual(recorder.SentFrames.Select(f => f.Time)));
+        }
+
         private void onNewFrames(int userId, FrameDataBundle frames)
         {
-            Logger.Log($"Received {frames.Frames.Count} new frames ({string.Join(',', frames.Frames.Select(f => ((int)f.Time).ToString()))})");
-
             foreach (var legacyFrame in frames.Frames)
             {
                 var frame = new TestReplayFrame();
                 frame.FromLegacy(legacyFrame, null);
                 replay.Frames.Add(frame);
             }
-        }
 
-        [Test]
-        public void TestBasic()
-        {
-            AddStep("Wait for user input", () => { });
+            Logger.Log($"Received {frames.Frames.Count} new frames (total {replay.Frames.Count} of {recorder.SentFrames.Count})");
         }
 
         private double latency = SpectatorClient.TIME_BETWEEN_SENDS;
@@ -318,6 +351,8 @@ namespace osu.Game.Tests.Visual.Gameplay
 
         internal class TestReplayRecorder : ReplayRecorder<TestAction>
         {
+            public List<ReplayFrame> SentFrames = new List<ReplayFrame>();
+
             public TestReplayRecorder()
                 : base(new Score
                 {
@@ -332,7 +367,9 @@ namespace osu.Game.Tests.Visual.Gameplay
 
             protected override ReplayFrame HandleFrame(Vector2 mousePosition, List<TestAction> actions, ReplayFrame previousFrame)
             {
-                return new TestReplayFrame(Time.Current, mousePosition, actions.ToArray());
+                var testReplayFrame = new TestReplayFrame(Time.Current, mousePosition, actions.ToArray());
+                SentFrames.Add(testReplayFrame);
+                return testReplayFrame;
             }
         }
     }
diff --git a/osu.Game/Tests/Visual/Spectator/TestSpectatorClient.cs b/osu.Game/Tests/Visual/Spectator/TestSpectatorClient.cs
index ae5d20f4f4..f5da95bd7b 100644
--- a/osu.Game/Tests/Visual/Spectator/TestSpectatorClient.cs
+++ b/osu.Game/Tests/Visual/Spectator/TestSpectatorClient.cs
@@ -30,6 +30,8 @@ namespace osu.Game.Tests.Visual.Spectator
         /// </summary>
         public bool ShouldFailSendingFrames { get; set; }
 
+        public int FrameSendAttempts { get; private set; }
+
         public override IBindable<bool> IsConnected { get; } = new Bindable<bool>(true);
 
         public IReadOnlyDictionary<int, ReplayFrame> LastReceivedUserFrames => lastReceivedUserFrames;
@@ -130,6 +132,8 @@ namespace osu.Game.Tests.Visual.Spectator
 
         protected override Task SendFramesInternal(FrameDataBundle bundle)
         {
+            FrameSendAttempts++;
+
             if (ShouldFailSendingFrames)
                 return Task.FromException(new InvalidOperationException());
 

From 694c6ad872c87aeabdc1d430fbadf082f24463bc Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 24 Feb 2022 00:59:25 +0900
Subject: [PATCH 3052/5547] Fix frames potentially getting lost due to
 non-matching `Schedule` usage

---
 osu.Game/Online/Spectator/SpectatorClient.cs | 38 ++++++++++++--------
 1 file changed, 24 insertions(+), 14 deletions(-)

diff --git a/osu.Game/Online/Spectator/SpectatorClient.cs b/osu.Game/Online/Spectator/SpectatorClient.cs
index 428a4cdbdb..0620643bc3 100644
--- a/osu.Game/Online/Spectator/SpectatorClient.cs
+++ b/osu.Game/Online/Spectator/SpectatorClient.cs
@@ -12,6 +12,7 @@ using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Development;
 using osu.Framework.Graphics;
+using osu.Framework.Logging;
 using osu.Game.Beatmaps;
 using osu.Game.Online.API;
 using osu.Game.Replays.Legacy;
@@ -156,6 +157,8 @@ namespace osu.Game.Online.Spectator
 
                 IsPlaying = true;
 
+                totalBundledFrames = 0;
+
                 // transfer state at point of beginning play
                 currentState.BeatmapID = score.ScoreInfo.BeatmapInfo.OnlineID;
                 currentState.RulesetID = score.ScoreInfo.RulesetID;
@@ -169,6 +172,21 @@ namespace osu.Game.Online.Spectator
             });
         }
 
+        public void HandleFrame(ReplayFrame frame) => Schedule(() =>
+        {
+            if (!IsPlaying)
+            {
+                Logger.Log($"Frames arrived at {nameof(SpectatorClient)} outside of gameplay scope and will be ignored.");
+                return;
+            }
+
+            if (frame is IConvertibleReplayFrame convertible)
+                pendingFrames.Enqueue(convertible.ToLegacy(currentBeatmap));
+
+            if (pendingFrames.Count > max_pending_frames)
+                purgePendingFrames();
+        });
+
         public void EndPlaying(GameplayState state)
         {
             // This method is most commonly called via Dispose(), which is can be asynchronous (via the AsyncDisposalQueue).
@@ -236,6 +254,8 @@ namespace osu.Game.Online.Spectator
 
         private Task? lastSend;
 
+        private int totalBundledFrames;
+
         private const int max_pending_frames = 30;
 
         protected override void Update()
@@ -246,20 +266,6 @@ namespace osu.Game.Online.Spectator
                 purgePendingFrames();
         }
 
-        public void HandleFrame(ReplayFrame frame)
-        {
-            Debug.Assert(ThreadSafety.IsUpdateThread);
-
-            if (!IsPlaying)
-                return;
-
-            if (frame is IConvertibleReplayFrame convertible)
-                pendingFrames.Enqueue(convertible.ToLegacy(currentBeatmap));
-
-            if (pendingFrames.Count > max_pending_frames)
-                purgePendingFrames();
-        }
-
         private void purgePendingFrames()
         {
             if (pendingFrames.Count == 0)
@@ -270,6 +276,10 @@ namespace osu.Game.Online.Spectator
             var frames = pendingFrames.ToArray();
             var bundle = new FrameDataBundle(currentScore.ScoreInfo, frames);
 
+            totalBundledFrames += frames.Length;
+
+            Console.WriteLine($"Purging {pendingFrames.Count} frames (total {totalBundledFrames})");
+
             pendingFrames.Clear();
             lastPurgeTime = Time.Current;
 

From 5ffdd57895bd61652855683e2064713006ae7fda Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 24 Feb 2022 02:19:37 +0900
Subject: [PATCH 3053/5547] Rename weirdly named parameter

---
 osu.Game/Online/Spectator/OnlineSpectatorClient.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Online/Spectator/OnlineSpectatorClient.cs b/osu.Game/Online/Spectator/OnlineSpectatorClient.cs
index ddde69c627..4d6ca0b311 100644
--- a/osu.Game/Online/Spectator/OnlineSpectatorClient.cs
+++ b/osu.Game/Online/Spectator/OnlineSpectatorClient.cs
@@ -57,14 +57,14 @@ namespace osu.Game.Online.Spectator
             return connection.SendAsync(nameof(ISpectatorServer.BeginPlaySession), state);
         }
 
-        protected override Task SendFramesInternal(FrameDataBundle data)
+        protected override Task SendFramesInternal(FrameDataBundle bundle)
         {
             if (!IsConnected.Value)
                 return Task.CompletedTask;
 
             Debug.Assert(connection != null);
 
-            return connection.SendAsync(nameof(ISpectatorServer.SendFrameData), data);
+            return connection.SendAsync(nameof(ISpectatorServer.SendFrameData), bundle);
         }
 
         protected override Task EndPlayingInternal(SpectatorState state)

From 3f2ef030e4a1d82978643b8e31a080629c8654a2 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 24 Feb 2022 02:29:49 +0900
Subject: [PATCH 3054/5547] Group `SpectatorClient` private fields together

---
 osu.Game/Online/Spectator/SpectatorClient.cs | 49 ++++++++++----------
 1 file changed, 25 insertions(+), 24 deletions(-)

diff --git a/osu.Game/Online/Spectator/SpectatorClient.cs b/osu.Game/Online/Spectator/SpectatorClient.cs
index 0620643bc3..d0b89e981d 100644
--- a/osu.Game/Online/Spectator/SpectatorClient.cs
+++ b/osu.Game/Online/Spectator/SpectatorClient.cs
@@ -46,18 +46,6 @@ namespace osu.Game.Online.Spectator
         /// </summary>
         public IBindableList<int> PlayingUsers => playingUsers;
 
-        /// <summary>
-        /// All users currently being watched.
-        /// </summary>
-        private readonly List<int> watchedUsers = new List<int>();
-
-        private readonly BindableDictionary<int, SpectatorState> watchedUserStates = new BindableDictionary<int, SpectatorState>();
-        private readonly BindableList<int> playingUsers = new BindableList<int>();
-        private readonly SpectatorState currentState = new SpectatorState();
-
-        private IBeatmap? currentBeatmap;
-        private Score? currentScore;
-
         /// <summary>
         /// Whether the local user is playing.
         /// </summary>
@@ -78,6 +66,30 @@ namespace osu.Game.Online.Spectator
         /// </summary>
         public event Action<int, SpectatorState>? OnUserFinishedPlaying;
 
+        /// <summary>
+        /// All users currently being watched.
+        /// </summary>
+        private readonly List<int> watchedUsers = new List<int>();
+
+        private readonly BindableDictionary<int, SpectatorState> watchedUserStates = new BindableDictionary<int, SpectatorState>();
+        private readonly BindableList<int> playingUsers = new BindableList<int>();
+        private readonly SpectatorState currentState = new SpectatorState();
+
+        private IBeatmap? currentBeatmap;
+        private Score? currentScore;
+
+        private readonly Queue<FrameDataBundle> pendingFrameBundles = new Queue<FrameDataBundle>();
+
+        private readonly Queue<LegacyReplayFrame> pendingFrames = new Queue<LegacyReplayFrame>();
+
+        private double lastPurgeTime;
+
+        private Task? lastSend;
+
+        private int totalBundledFrames;
+
+        private const int max_pending_frames = 30;
+
         [BackgroundDependencyLoader]
         private void load()
         {
@@ -240,24 +252,13 @@ namespace osu.Game.Online.Spectator
         protected abstract Task BeginPlayingInternal(SpectatorState state);
 
         protected abstract Task SendFramesInternal(FrameDataBundle bundle);
+
         protected abstract Task EndPlayingInternal(SpectatorState state);
 
         protected abstract Task WatchUserInternal(int userId);
 
         protected abstract Task StopWatchingUserInternal(int userId);
 
-        private readonly Queue<FrameDataBundle> pendingFrameBundles = new Queue<FrameDataBundle>();
-
-        private readonly Queue<LegacyReplayFrame> pendingFrames = new Queue<LegacyReplayFrame>();
-
-        private double lastPurgeTime;
-
-        private Task? lastSend;
-
-        private int totalBundledFrames;
-
-        private const int max_pending_frames = 30;
-
         protected override void Update()
         {
             base.Update();

From 8a0aba6c596bcadf1c0e15ef661e8846503841d1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 23 Feb 2022 23:11:12 +0100
Subject: [PATCH 3055/5547] Implement mod panel for new mod select screen

---
 .../Visual/UserInterface/TestSceneModPanel.cs |  42 +++
 osu.Game/Overlays/Mods/ModPanel.cs            | 272 ++++++++++++++++++
 2 files changed, 314 insertions(+)
 create mode 100644 osu.Game.Tests/Visual/UserInterface/TestSceneModPanel.cs
 create mode 100644 osu.Game/Overlays/Mods/ModPanel.cs

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneModPanel.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneModPanel.cs
new file mode 100644
index 0000000000..bdf3f98863
--- /dev/null
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneModPanel.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 NUnit.Framework;
+using osu.Framework.Allocation;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
+using osu.Game.Overlays;
+using osu.Game.Overlays.Mods;
+using osu.Game.Rulesets.Osu.Mods;
+using osuTK;
+
+namespace osu.Game.Tests.Visual.UserInterface
+{
+    [TestFixture]
+    public class TestSceneModPanel : OsuManualInputManagerTestScene
+    {
+        [Cached]
+        private OverlayColourProvider colourProvider = new OverlayColourProvider(OverlayColourScheme.Green);
+
+        [Test]
+        public void TestVariousPanels()
+        {
+            AddStep("create content", () => Child = new FillFlowContainer
+            {
+                Width = 300,
+                AutoSizeAxes = Axes.Y,
+                Anchor = Anchor.Centre,
+                Origin = Anchor.Centre,
+                Spacing = new Vector2(0, 5),
+                Children = new[]
+                {
+                    new ModPanel(new OsuModHalfTime()),
+                    new ModPanel(new OsuModFlashlight()),
+                    new ModPanel(new OsuModAutoplay()),
+                    new ModPanel(new OsuModAlternate()),
+                    new ModPanel(new OsuModApproachDifferent())
+                }
+            });
+        }
+    }
+}
diff --git a/osu.Game/Overlays/Mods/ModPanel.cs b/osu.Game/Overlays/Mods/ModPanel.cs
new file mode 100644
index 0000000000..4d08b22017
--- /dev/null
+++ b/osu.Game/Overlays/Mods/ModPanel.cs
@@ -0,0 +1,272 @@
+// 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.Audio;
+using osu.Framework.Audio.Sample;
+using osu.Framework.Bindables;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Colour;
+using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.Shapes;
+using osu.Framework.Input.Events;
+using osu.Framework.Utils;
+using osu.Game.Graphics;
+using osu.Game.Graphics.Containers;
+using osu.Game.Graphics.Sprites;
+using osu.Game.Graphics.UserInterface;
+using osu.Game.Rulesets.Mods;
+using osu.Game.Rulesets.UI;
+using osuTK;
+using osuTK.Input;
+
+#nullable enable
+
+namespace osu.Game.Overlays.Mods
+{
+    public class ModPanel : OsuClickableContainer
+    {
+        public Mod Mod { get; }
+        public BindableBool Active { get; } = new BindableBool();
+
+        protected readonly Box Background;
+        protected readonly Container SwitchContainer;
+        protected readonly Container MainContentContainer;
+        protected readonly Box TextBackground;
+        protected readonly FillFlowContainer TextFlow;
+
+        [Resolved]
+        protected OverlayColourProvider ColourProvider { get; private set; } = null!;
+
+        protected const double TRANSITION_DURATION = 150;
+        protected const float SHEAR_X = 0.2f;
+
+        protected const float HEIGHT = 42;
+        protected const float CORNER_RADIUS = 7;
+        protected const float IDLE_SWITCH_WIDTH = 54;
+        protected const float EXPANDED_SWITCH_WIDTH = 70;
+
+        private Colour4 activeColour;
+        private Colour4 activeHoverColour;
+
+        private Sample? sampleOff;
+        private Sample? sampleOn;
+
+        public ModPanel(Mod mod)
+        {
+            Mod = mod;
+
+            RelativeSizeAxes = Axes.X;
+            Height = 42;
+
+            // all below properties are applied to `Content` rather than the `ModPanel` in its entirety
+            // to allow external components to set these properties on the panel without affecting
+            // its "internal" appearance.
+            Content.Masking = true;
+            Content.CornerRadius = CORNER_RADIUS;
+            Content.BorderThickness = 2;
+            Content.Shear = new Vector2(SHEAR_X, 0);
+
+            Children = new Drawable[]
+            {
+                Background = new Box
+                {
+                    RelativeSizeAxes = Axes.Both
+                },
+                SwitchContainer = new Container
+                {
+                    RelativeSizeAxes = Axes.Y,
+                    Child = new ModSwitchSmall(mod)
+                    {
+                        Anchor = Anchor.Centre,
+                        Origin = Anchor.Centre,
+                        Active = { BindTarget = Active },
+                        Shear = new Vector2(-SHEAR_X, 0),
+                        Scale = new Vector2(HEIGHT / ModSwitchSmall.DEFAULT_SIZE)
+                    }
+                },
+                MainContentContainer = new Container
+                {
+                    RelativeSizeAxes = Axes.Both,
+                    Child = new Container
+                    {
+                        RelativeSizeAxes = Axes.Both,
+                        Masking = true,
+                        CornerRadius = CORNER_RADIUS,
+                        Children = new Drawable[]
+                        {
+                            TextBackground = new Box
+                            {
+                                RelativeSizeAxes = Axes.Both
+                            },
+                            TextFlow = new FillFlowContainer
+                            {
+                                RelativeSizeAxes = Axes.Both,
+                                Padding = new MarginPadding
+                                {
+                                    Horizontal = 17.5f,
+                                    Vertical = 4
+                                },
+                                Direction = FillDirection.Vertical,
+                                Children = new[]
+                                {
+                                    new OsuSpriteText
+                                    {
+                                        Text = mod.Name,
+                                        Font = OsuFont.TorusAlternate.With(size: 18, weight: FontWeight.SemiBold),
+                                        Shear = new Vector2(-SHEAR_X, 0),
+                                        Margin = new MarginPadding
+                                        {
+                                            Left = -18 * SHEAR_X
+                                        }
+                                    },
+                                    new OsuSpriteText
+                                    {
+                                        Text = mod.Description,
+                                        Font = OsuFont.Default.With(size: 12),
+                                        RelativeSizeAxes = Axes.X,
+                                        Truncate = true,
+                                        Shear = new Vector2(-SHEAR_X, 0)
+                                    }
+                                }
+                            }
+                        }
+                    }
+                }
+            };
+
+            Action = Active.Toggle;
+        }
+
+        [BackgroundDependencyLoader]
+        private void load(AudioManager audio, OsuColour colours)
+        {
+            sampleOn = audio.Samples.Get(@"UI/check-on");
+            sampleOff = audio.Samples.Get(@"UI/check-off");
+
+            activeColour = colours.ForModType(Mod.Type);
+            activeHoverColour = activeColour.Lighten(0.3f);
+        }
+
+        protected override HoverSounds CreateHoverSounds(HoverSampleSet sampleSet) => new HoverSounds(sampleSet);
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+            Active.BindValueChanged(_ =>
+            {
+                playStateChangeSamples();
+                UpdateState();
+            });
+
+            UpdateState();
+            FinishTransforms(true);
+        }
+
+        private void playStateChangeSamples()
+        {
+            if (Active.Value)
+                sampleOn?.Play();
+            else
+                sampleOff?.Play();
+        }
+
+        protected override bool OnHover(HoverEvent e)
+        {
+            UpdateState();
+            return base.OnHover(e);
+        }
+
+        protected override void OnHoverLost(HoverLostEvent e)
+        {
+            UpdateState();
+            base.OnHoverLost(e);
+        }
+
+        private double? mouseDownTime;
+
+        protected override bool OnMouseDown(MouseDownEvent e)
+        {
+            if (e.Button == MouseButton.Left)
+                mouseDownTime = Time.Current;
+            return true;
+        }
+
+        protected override void OnMouseUp(MouseUpEvent e)
+        {
+            mouseDownTime = null;
+            base.OnMouseUp(e);
+        }
+
+        protected override bool OnDragStart(DragStartEvent e)
+        {
+            mouseDownTime = null;
+            return true;
+        }
+
+        protected override void Update()
+        {
+            base.Update();
+
+            if (mouseDownTime != null)
+            {
+                double startTime = mouseDownTime.Value;
+                double endTime = startTime + 600;
+
+                float startValue = Active.Value ? EXPANDED_SWITCH_WIDTH : IDLE_SWITCH_WIDTH;
+                float endValue = IDLE_SWITCH_WIDTH + (EXPANDED_SWITCH_WIDTH - IDLE_SWITCH_WIDTH) * (Active.Value ? 0.2f : 0.8f);
+
+                float targetWidth = Interpolation.ValueAt<float>(Math.Clamp(Time.Current, startTime, endTime), startValue, endValue, startTime, endTime, Easing.OutQuint);
+
+                SwitchContainer.Width = targetWidth;
+                MainContentContainer.Padding = new MarginPadding
+                {
+                    Left = targetWidth,
+                    Right = CORNER_RADIUS
+                };
+            }
+        }
+
+        protected virtual void UpdateState()
+        {
+            if (Active.Value)
+            {
+                Colour4 backgroundTextColour = IsHovered ? activeHoverColour : activeColour;
+                Colour4 backgroundColour = Interpolation.ValueAt<Colour4>(0.7f, Colour4.Black, backgroundTextColour, 0, 1);
+
+                Content.TransformTo(nameof(BorderColour), (ColourInfo)backgroundColour, TRANSITION_DURATION, Easing.OutQuint);
+                Background.FadeColour(backgroundColour, TRANSITION_DURATION, Easing.OutQuint);
+                SwitchContainer.ResizeWidthTo(EXPANDED_SWITCH_WIDTH, TRANSITION_DURATION, Easing.OutQuint);
+                MainContentContainer.TransformTo(nameof(Padding), new MarginPadding
+                {
+                    Left = EXPANDED_SWITCH_WIDTH,
+                    Right = CORNER_RADIUS
+                }, TRANSITION_DURATION, Easing.OutQuint);
+                TextBackground.FadeColour(backgroundTextColour, TRANSITION_DURATION, Easing.OutQuint);
+                TextFlow.FadeColour(ColourProvider.Background6, TRANSITION_DURATION, Easing.OutQuint);
+            }
+            else
+            {
+                Colour4 backgroundColour = ColourProvider.Background3;
+                if (IsHovered)
+                    backgroundColour = Interpolation.ValueAt<Colour4>(0.25f, backgroundColour, activeColour, 0, 1);
+
+                Colour4 textBackgroundColour = ColourProvider.Background2;
+                if (IsHovered)
+                    textBackgroundColour = Interpolation.ValueAt<Colour4>(0.25f, textBackgroundColour, activeColour, 0, 1);
+
+                Content.TransformTo(nameof(BorderColour), ColourInfo.GradientVertical(backgroundColour, textBackgroundColour), TRANSITION_DURATION, Easing.OutQuint);
+                Background.FadeColour(backgroundColour, TRANSITION_DURATION, Easing.OutQuint);
+                SwitchContainer.ResizeWidthTo(IDLE_SWITCH_WIDTH, TRANSITION_DURATION, Easing.OutQuint);
+                MainContentContainer.TransformTo(nameof(Padding), new MarginPadding
+                {
+                    Left = IDLE_SWITCH_WIDTH,
+                    Right = CORNER_RADIUS
+                }, TRANSITION_DURATION, Easing.OutQuint);
+                TextBackground.FadeColour(textBackgroundColour, TRANSITION_DURATION, Easing.OutQuint);
+                TextFlow.FadeColour(Colour4.White, TRANSITION_DURATION, Easing.OutQuint);
+            }
+        }
+    }
+}

From bbe2dfa458c5c0a0dfa56d68717c8c625c4fd01a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 23 Feb 2022 23:11:26 +0100
Subject: [PATCH 3056/5547] Move out incompatibility displaying tooltip to own
 class

---
 .../IncompatibilityDisplayingModButton.cs     | 51 ---------------
 .../Mods/IncompatibilityDisplayingTooltip.cs  | 64 +++++++++++++++++++
 2 files changed, 64 insertions(+), 51 deletions(-)
 create mode 100644 osu.Game/Overlays/Mods/IncompatibilityDisplayingTooltip.cs

diff --git a/osu.Game/Overlays/Mods/IncompatibilityDisplayingModButton.cs b/osu.Game/Overlays/Mods/IncompatibilityDisplayingModButton.cs
index 0f51439252..6e2cb40596 100644
--- a/osu.Game/Overlays/Mods/IncompatibilityDisplayingModButton.cs
+++ b/osu.Game/Overlays/Mods/IncompatibilityDisplayingModButton.cs
@@ -8,11 +8,7 @@ using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Cursor;
-using osu.Game.Graphics;
-using osu.Game.Graphics.Sprites;
-using osu.Game.Rulesets;
 using osu.Game.Rulesets.Mods;
-using osu.Game.Screens.Play.HUD;
 using osu.Game.Utils;
 using osuTK;
 
@@ -66,52 +62,5 @@ namespace osu.Game.Overlays.Mods
         }
 
         public override ITooltip<Mod> GetCustomTooltip() => new IncompatibilityDisplayingTooltip();
-
-        private class IncompatibilityDisplayingTooltip : ModButtonTooltip
-        {
-            private readonly OsuSpriteText incompatibleText;
-
-            private readonly Bindable<IReadOnlyList<Mod>> incompatibleMods = new Bindable<IReadOnlyList<Mod>>();
-
-            [Resolved]
-            private Bindable<RulesetInfo> ruleset { get; set; }
-
-            public IncompatibilityDisplayingTooltip()
-            {
-                AddRange(new Drawable[]
-                {
-                    incompatibleText = new OsuSpriteText
-                    {
-                        Margin = new MarginPadding { Top = 5 },
-                        Font = OsuFont.GetFont(weight: FontWeight.Regular),
-                        Text = "Incompatible with:"
-                    },
-                    new ModDisplay
-                    {
-                        Current = incompatibleMods,
-                        ExpansionMode = ExpansionMode.AlwaysExpanded,
-                        Scale = new Vector2(0.7f)
-                    }
-                });
-            }
-
-            [BackgroundDependencyLoader]
-            private void load(OsuColour colours)
-            {
-                incompatibleText.Colour = colours.BlueLight;
-            }
-
-            protected override void UpdateDisplay(Mod mod)
-            {
-                base.UpdateDisplay(mod);
-
-                var incompatibleTypes = mod.IncompatibleMods;
-
-                var allMods = ruleset.Value.CreateInstance().AllMods;
-
-                incompatibleMods.Value = allMods.Where(m => m.GetType() != mod.GetType() && incompatibleTypes.Any(t => t.IsInstanceOfType(m))).Select(m => m.CreateInstance()).ToList();
-                incompatibleText.Text = incompatibleMods.Value.Any() ? "Incompatible with:" : "Compatible with all mods";
-            }
-        }
     }
 }
diff --git a/osu.Game/Overlays/Mods/IncompatibilityDisplayingTooltip.cs b/osu.Game/Overlays/Mods/IncompatibilityDisplayingTooltip.cs
new file mode 100644
index 0000000000..d8117c8f00
--- /dev/null
+++ b/osu.Game/Overlays/Mods/IncompatibilityDisplayingTooltip.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.Collections.Generic;
+using System.Linq;
+using osu.Framework.Allocation;
+using osu.Framework.Bindables;
+using osu.Framework.Graphics;
+using osu.Game.Graphics;
+using osu.Game.Graphics.Sprites;
+using osu.Game.Rulesets;
+using osu.Game.Rulesets.Mods;
+using osu.Game.Screens.Play.HUD;
+using osuTK;
+
+namespace osu.Game.Overlays.Mods
+{
+    internal class IncompatibilityDisplayingTooltip : ModButtonTooltip
+    {
+        private readonly OsuSpriteText incompatibleText;
+
+        private readonly Bindable<IReadOnlyList<Mod>> incompatibleMods = new Bindable<IReadOnlyList<Mod>>();
+
+        [Resolved]
+        private Bindable<RulesetInfo> ruleset { get; set; }
+
+        public IncompatibilityDisplayingTooltip()
+        {
+            AddRange(new Drawable[]
+            {
+                incompatibleText = new OsuSpriteText
+                {
+                    Margin = new MarginPadding { Top = 5 },
+                    Font = OsuFont.GetFont(weight: FontWeight.Regular),
+                    Text = "Incompatible with:"
+                },
+                new ModDisplay
+                {
+                    Current = incompatibleMods,
+                    ExpansionMode = ExpansionMode.AlwaysExpanded,
+                    Scale = new Vector2(0.7f)
+                }
+            });
+        }
+
+        [BackgroundDependencyLoader]
+        private void load(OsuColour colours)
+        {
+            incompatibleText.Colour = colours.BlueLight;
+        }
+
+        protected override void UpdateDisplay(Mod mod)
+        {
+            base.UpdateDisplay(mod);
+
+            var incompatibleTypes = mod.IncompatibleMods;
+
+            var allMods = ruleset.Value.CreateInstance().AllMods;
+
+            incompatibleMods.Value = allMods.Where(m => m.GetType() != mod.GetType() && incompatibleTypes.Any(t => t.IsInstanceOfType(m))).Select(m => m.CreateInstance()).ToList();
+            incompatibleText.Text = incompatibleMods.Value.Any() ? "Incompatible with:" : "Compatible with all mods";
+        }
+    }
+}

From 713f89a59c7d0c964d5c4f1c0760dd45fe596bdf Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 23 Feb 2022 23:11:38 +0100
Subject: [PATCH 3057/5547] Implement incompatibility-displaying variant of mod
 panel

---
 .../Visual/UserInterface/TestSceneModPanel.cs | 39 ++++++++
 .../Mods/IncompatibilityDisplayingModPanel.cs | 88 +++++++++++++++++++
 2 files changed, 127 insertions(+)
 create mode 100644 osu.Game/Overlays/Mods/IncompatibilityDisplayingModPanel.cs

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneModPanel.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneModPanel.cs
index bdf3f98863..95323e5dfa 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneModPanel.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneModPanel.cs
@@ -1,14 +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;
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Overlays;
 using osu.Game.Overlays.Mods;
+using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Osu.Mods;
 using osuTK;
+using osuTK.Input;
 
 namespace osu.Game.Tests.Visual.UserInterface
 {
@@ -38,5 +41,41 @@ namespace osu.Game.Tests.Visual.UserInterface
                 }
             });
         }
+
+        [Test]
+        public void TestIncompatibilityDisplay()
+        {
+            IncompatibilityDisplayingModPanel panel = null;
+
+            AddStep("create panel with DT", () => Child = panel = new IncompatibilityDisplayingModPanel(new OsuModDoubleTime())
+            {
+                Anchor = Anchor.Centre,
+                Origin = Anchor.Centre,
+                RelativeSizeAxes = Axes.None,
+                Width = 300
+            });
+
+            clickPanel();
+            AddAssert("panel active", () => panel.Active.Value);
+
+            clickPanel();
+            AddAssert("panel not active", () => !panel.Active.Value);
+
+            AddStep("set incompatible mod", () => SelectedMods.Value = new[] { new OsuModHalfTime() });
+
+            clickPanel();
+            AddAssert("panel not active", () => !panel.Active.Value);
+
+            AddStep("reset mods", () => SelectedMods.Value = Array.Empty<Mod>());
+
+            clickPanel();
+            AddAssert("panel active", () => panel.Active.Value);
+
+            void clickPanel() => AddStep("click panel", () =>
+            {
+                InputManager.MoveMouseTo(panel);
+                InputManager.Click(MouseButton.Left);
+            });
+        }
     }
 }
diff --git a/osu.Game/Overlays/Mods/IncompatibilityDisplayingModPanel.cs b/osu.Game/Overlays/Mods/IncompatibilityDisplayingModPanel.cs
new file mode 100644
index 0000000000..4b6759c209
--- /dev/null
+++ b/osu.Game/Overlays/Mods/IncompatibilityDisplayingModPanel.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 System;
+using System.Collections.Generic;
+using System.Linq;
+using osu.Framework.Allocation;
+using osu.Framework.Bindables;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Colour;
+using osu.Framework.Graphics.Cursor;
+using osu.Framework.Input.Events;
+using osu.Game.Rulesets.Mods;
+using osu.Game.Utils;
+
+namespace osu.Game.Overlays.Mods
+{
+    public class IncompatibilityDisplayingModPanel : ModPanel, IHasCustomTooltip<Mod>
+    {
+        private readonly BindableBool incompatible = new BindableBool();
+
+        [Resolved]
+        private Bindable<IReadOnlyList<Mod>> selectedMods { get; set; }
+
+        public IncompatibilityDisplayingModPanel(Mod mod)
+            : base(mod)
+        {
+        }
+
+        protected override void LoadComplete()
+        {
+            selectedMods.BindValueChanged(_ => updateIncompatibility(), true);
+            incompatible.BindValueChanged(_ => Scheduler.AddOnce(UpdateState));
+            // base call will run `UpdateState()` first time and finish transforms.
+            base.LoadComplete();
+        }
+
+        private void updateIncompatibility()
+        {
+            incompatible.Value = selectedMods.Value.Count > 0 && !selectedMods.Value.Contains(Mod) && !ModUtils.CheckCompatibleSet(selectedMods.Value.Append(Mod));
+        }
+
+        protected override void UpdateState()
+        {
+            Action = incompatible.Value ? () => { } : (Action)Active.Toggle;
+
+            if (incompatible.Value)
+            {
+                Colour4 backgroundColour = ColourProvider.Background5;
+                Colour4 textBackgroundColour = ColourProvider.Background4;
+
+                Content.TransformTo(nameof(BorderColour), ColourInfo.GradientVertical(backgroundColour, textBackgroundColour), TRANSITION_DURATION, Easing.OutQuint);
+                Background.FadeColour(backgroundColour, TRANSITION_DURATION, Easing.OutQuint);
+
+                SwitchContainer.ResizeWidthTo(IDLE_SWITCH_WIDTH, TRANSITION_DURATION, Easing.OutQuint);
+                SwitchContainer.FadeColour(Colour4.Gray, TRANSITION_DURATION, Easing.OutQuint);
+                MainContentContainer.TransformTo(nameof(Padding), new MarginPadding
+                {
+                    Left = IDLE_SWITCH_WIDTH,
+                    Right = CORNER_RADIUS
+                }, TRANSITION_DURATION, Easing.OutQuint);
+
+                TextBackground.FadeColour(textBackgroundColour, TRANSITION_DURATION, Easing.OutQuint);
+                TextFlow.FadeColour(Colour4.White.Opacity(0.5f), TRANSITION_DURATION, Easing.OutQuint);
+                return;
+            }
+
+            SwitchContainer.FadeColour(Colour4.White, TRANSITION_DURATION, Easing.OutQuint);
+            base.UpdateState();
+        }
+
+        protected override bool OnMouseDown(MouseDownEvent e)
+        {
+            if (incompatible.Value)
+                return true; // bypasses base call purposely in order to not play out the intermediate state animation.
+
+            return base.OnMouseDown(e);
+        }
+
+        #region IHasCustomTooltip
+
+        public ITooltip<Mod> GetCustomTooltip() => new IncompatibilityDisplayingTooltip();
+
+        public Mod TooltipContent => Mod;
+
+        #endregion
+    }
+}

From 435bdd0b4a68d7abf66b2f7eb0c5d70f16246580 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 24 Feb 2022 14:55:35 +0900
Subject: [PATCH 3058/5547] Combine and simplify state management logic

This makes a few changes to bring things into a better shape during
mouse interactions with the mod panels:

- Dragging away from the panel now works in line with other buttons (ie.
  `OsuButton`)
- Hovering now uses a lightened version of the current state, rather
  than always using the active colour. I think this feels better.
- Mouse down now uses a transform point of 0.5. This is to give the
  button a feeling of one of those latching light switches which resists
until reaching a point of overcoming the spring and switching state. I
think 0.4 (non-active) and 0.6 (from active) may work better, but left
at 0.5 for simplicity of implementation and I think it's good enough?
- Border always uses the gradiented version. I did this for simplicity
  of implementation, but also think it looks better.
- Adjusted transform durations to feel better to me.
---
 osu.Game/Overlays/Mods/ModPanel.cs | 102 ++++++++++-------------------
 1 file changed, 35 insertions(+), 67 deletions(-)

diff --git a/osu.Game/Overlays/Mods/ModPanel.cs b/osu.Game/Overlays/Mods/ModPanel.cs
index 4d08b22017..13e2b5bb0b 100644
--- a/osu.Game/Overlays/Mods/ModPanel.cs
+++ b/osu.Game/Overlays/Mods/ModPanel.cs
@@ -40,6 +40,7 @@ namespace osu.Game.Overlays.Mods
         protected OverlayColourProvider ColourProvider { get; private set; } = null!;
 
         protected const double TRANSITION_DURATION = 150;
+
         protected const float SHEAR_X = 0.2f;
 
         protected const float HEIGHT = 42;
@@ -48,7 +49,6 @@ namespace osu.Game.Overlays.Mods
         protected const float EXPANDED_SWITCH_WIDTH = 70;
 
         private Colour4 activeColour;
-        private Colour4 activeHoverColour;
 
         private Sample? sampleOff;
         private Sample? sampleOn;
@@ -146,7 +146,6 @@ namespace osu.Game.Overlays.Mods
             sampleOff = audio.Samples.Get(@"UI/check-off");
 
             activeColour = colours.ForModType(Mod.Type);
-            activeHoverColour = activeColour.Lighten(0.3f);
         }
 
         protected override HoverSounds CreateHoverSounds(HoverSampleSet sampleSet) => new HoverSounds(sampleSet);
@@ -184,89 +183,58 @@ namespace osu.Game.Overlays.Mods
             base.OnHoverLost(e);
         }
 
-        private double? mouseDownTime;
+        private bool mouseDown;
 
         protected override bool OnMouseDown(MouseDownEvent e)
         {
             if (e.Button == MouseButton.Left)
-                mouseDownTime = Time.Current;
+                mouseDown = true;
+
+            UpdateState();
             return true;
         }
 
         protected override void OnMouseUp(MouseUpEvent e)
         {
-            mouseDownTime = null;
+            mouseDown = false;
+
+            UpdateState();
             base.OnMouseUp(e);
         }
 
-        protected override bool OnDragStart(DragStartEvent e)
-        {
-            mouseDownTime = null;
-            return true;
-        }
-
-        protected override void Update()
-        {
-            base.Update();
-
-            if (mouseDownTime != null)
-            {
-                double startTime = mouseDownTime.Value;
-                double endTime = startTime + 600;
-
-                float startValue = Active.Value ? EXPANDED_SWITCH_WIDTH : IDLE_SWITCH_WIDTH;
-                float endValue = IDLE_SWITCH_WIDTH + (EXPANDED_SWITCH_WIDTH - IDLE_SWITCH_WIDTH) * (Active.Value ? 0.2f : 0.8f);
-
-                float targetWidth = Interpolation.ValueAt<float>(Math.Clamp(Time.Current, startTime, endTime), startValue, endValue, startTime, endTime, Easing.OutQuint);
-
-                SwitchContainer.Width = targetWidth;
-                MainContentContainer.Padding = new MarginPadding
-                {
-                    Left = targetWidth,
-                    Right = CORNER_RADIUS
-                };
-            }
-        }
-
         protected virtual void UpdateState()
         {
-            if (Active.Value)
+            float targetWidth = Active.Value ? EXPANDED_SWITCH_WIDTH : IDLE_SWITCH_WIDTH;
+            double transitionDuration = TRANSITION_DURATION;
+
+            Colour4 textBackgroundColour = Active.Value ? activeColour : (Colour4)ColourProvider.Background2;
+            Colour4 mainBackgroundColour = Active.Value ? activeColour.Darken(0.3f) : (Colour4)ColourProvider.Background3;
+            Colour4 textColour = Active.Value ? (Colour4)ColourProvider.Background6 : Colour4.White;
+
+            // Hover affects colour of button background
+            if (IsHovered)
             {
-                Colour4 backgroundTextColour = IsHovered ? activeHoverColour : activeColour;
-                Colour4 backgroundColour = Interpolation.ValueAt<Colour4>(0.7f, Colour4.Black, backgroundTextColour, 0, 1);
-
-                Content.TransformTo(nameof(BorderColour), (ColourInfo)backgroundColour, TRANSITION_DURATION, Easing.OutQuint);
-                Background.FadeColour(backgroundColour, TRANSITION_DURATION, Easing.OutQuint);
-                SwitchContainer.ResizeWidthTo(EXPANDED_SWITCH_WIDTH, TRANSITION_DURATION, Easing.OutQuint);
-                MainContentContainer.TransformTo(nameof(Padding), new MarginPadding
-                {
-                    Left = EXPANDED_SWITCH_WIDTH,
-                    Right = CORNER_RADIUS
-                }, TRANSITION_DURATION, Easing.OutQuint);
-                TextBackground.FadeColour(backgroundTextColour, TRANSITION_DURATION, Easing.OutQuint);
-                TextFlow.FadeColour(ColourProvider.Background6, TRANSITION_DURATION, Easing.OutQuint);
+                textBackgroundColour = textBackgroundColour.Lighten(0.1f);
+                mainBackgroundColour = mainBackgroundColour.Lighten(0.1f);
             }
-            else
+
+            // Mouse down adds a halfway tween of the movement
+            if (mouseDown)
             {
-                Colour4 backgroundColour = ColourProvider.Background3;
-                if (IsHovered)
-                    backgroundColour = Interpolation.ValueAt<Colour4>(0.25f, backgroundColour, activeColour, 0, 1);
-
-                Colour4 textBackgroundColour = ColourProvider.Background2;
-                if (IsHovered)
-                    textBackgroundColour = Interpolation.ValueAt<Colour4>(0.25f, textBackgroundColour, activeColour, 0, 1);
-
-                Content.TransformTo(nameof(BorderColour), ColourInfo.GradientVertical(backgroundColour, textBackgroundColour), TRANSITION_DURATION, Easing.OutQuint);
-                Background.FadeColour(backgroundColour, TRANSITION_DURATION, Easing.OutQuint);
-                SwitchContainer.ResizeWidthTo(IDLE_SWITCH_WIDTH, TRANSITION_DURATION, Easing.OutQuint);
-                MainContentContainer.TransformTo(nameof(Padding), new MarginPadding
-                {
-                    Left = IDLE_SWITCH_WIDTH,
-                    Right = CORNER_RADIUS
-                }, TRANSITION_DURATION, Easing.OutQuint);
-                TextBackground.FadeColour(textBackgroundColour, TRANSITION_DURATION, Easing.OutQuint);
-                TextFlow.FadeColour(Colour4.White, TRANSITION_DURATION, Easing.OutQuint);
+                targetWidth = (float)Interpolation.Lerp(IDLE_SWITCH_WIDTH, EXPANDED_SWITCH_WIDTH, 0.5f);
+                transitionDuration *= 4;
             }
+
+            Content.TransformTo(nameof(BorderColour), ColourInfo.GradientVertical(mainBackgroundColour, textBackgroundColour), transitionDuration, Easing.OutQuint);
+            Background.FadeColour(mainBackgroundColour, transitionDuration, Easing.OutQuint);
+            SwitchContainer.ResizeWidthTo(targetWidth, transitionDuration, Easing.OutQuint);
+            MainContentContainer.TransformTo(nameof(Padding), new MarginPadding
+            {
+                Left = targetWidth,
+                Right = CORNER_RADIUS
+            }, transitionDuration, Easing.OutQuint);
+            TextBackground.FadeColour(textBackgroundColour, transitionDuration, Easing.OutQuint);
+            TextFlow.FadeColour(textColour, transitionDuration, Easing.OutQuint);
         }
     }
 }

From 3f6bdc5585de6653642d8c6ec119e6917dcb67d2 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 24 Feb 2022 15:40:06 +0900
Subject: [PATCH 3059/5547] Don't expose "mark as read" errors to the user via
 notifications

This can happen if the user leaves the channel before the request is
fired. You can't mark a channel as read when you're not in the channel.

Addresses https://github.com/ppy/osu/discussions/16973.
---
 osu.Game/Online/Chat/ChannelManager.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Online/Chat/ChannelManager.cs b/osu.Game/Online/Chat/ChannelManager.cs
index 77b52c34d9..38e655db71 100644
--- a/osu.Game/Online/Chat/ChannelManager.cs
+++ b/osu.Game/Online/Chat/ChannelManager.cs
@@ -618,7 +618,7 @@ namespace osu.Game.Online.Chat
             var req = new MarkChannelAsReadRequest(channel, message);
 
             req.Success += () => channel.LastReadId = message.Id;
-            req.Failure += e => Logger.Error(e, $"Failed to mark channel {channel} up to '{message}' as read");
+            req.Failure += e => Logger.Log($"Failed to mark channel {channel} up to '{message}' as read ({e.Message})", LoggingTarget.Network, LogLevel.Verbose);
 
             api.Queue(req);
         }

From 401cf2a955eb82d45afa03105090df7ecf6931eb Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 24 Feb 2022 15:54:45 +0900
Subject: [PATCH 3060/5547] Allow pausing game-wide audio via hotkey as long as
 `LocalUserPlaying` is not set

`Player` seems to handle this correctly locally already, which is to say
if the user attempts to toggle the pause state incorrectly, it will
still recover.

The logic stoppic this operation was only in the key binding handler,
which meant it was already possible from the now playing overlay this
whole time, so I *think* this should be quite safe.
---
 osu.Game/Overlays/Music/MusicKeyBindingHandler.cs | 15 ++++++++++++---
 1 file changed, 12 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Overlays/Music/MusicKeyBindingHandler.cs b/osu.Game/Overlays/Music/MusicKeyBindingHandler.cs
index baee17fb00..6b33c9200e 100644
--- a/osu.Game/Overlays/Music/MusicKeyBindingHandler.cs
+++ b/osu.Game/Overlays/Music/MusicKeyBindingHandler.cs
@@ -30,17 +30,20 @@ namespace osu.Game.Overlays.Music
         [Resolved(canBeNull: true)]
         private OnScreenDisplay onScreenDisplay { get; set; }
 
+        [Resolved]
+        private OsuGame game { get; set; }
+
         public bool OnPressed(KeyBindingPressEvent<GlobalAction> e)
         {
             if (e.Repeat)
                 return false;
 
-            if (beatmap.Disabled)
-                return false;
-
             switch (e.Action)
             {
                 case GlobalAction.MusicPlay:
+                    if (game.LocalUserPlaying.Value)
+                        return false;
+
                     // use previous state as TogglePause may not update the track's state immediately (state update is run on the audio thread see https://github.com/ppy/osu/issues/9880#issuecomment-674668842)
                     bool wasPlaying = musicController.IsPlaying;
 
@@ -49,11 +52,17 @@ namespace osu.Game.Overlays.Music
                     return true;
 
                 case GlobalAction.MusicNext:
+                    if (beatmap.Disabled)
+                        return false;
+
                     musicController.NextTrack(() => onScreenDisplay?.Display(new MusicActionToast(GlobalActionKeyBindingStrings.MusicNext, e.Action)));
 
                     return true;
 
                 case GlobalAction.MusicPrev:
+                    if (beatmap.Disabled)
+                        return false;
+
                     musicController.PreviousTrack(res =>
                     {
                         switch (res)

From b4a54b38e71a960bcb6382aadc32f1cbe2ade358 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 24 Feb 2022 16:02:16 +0900
Subject: [PATCH 3061/5547] Remove redundant parameter specification

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

diff --git a/osu.Game/Online/Chat/ChannelManager.cs b/osu.Game/Online/Chat/ChannelManager.cs
index 38e655db71..47e45e67d1 100644
--- a/osu.Game/Online/Chat/ChannelManager.cs
+++ b/osu.Game/Online/Chat/ChannelManager.cs
@@ -618,7 +618,7 @@ namespace osu.Game.Online.Chat
             var req = new MarkChannelAsReadRequest(channel, message);
 
             req.Success += () => channel.LastReadId = message.Id;
-            req.Failure += e => Logger.Log($"Failed to mark channel {channel} up to '{message}' as read ({e.Message})", LoggingTarget.Network, LogLevel.Verbose);
+            req.Failure += e => Logger.Log($"Failed to mark channel {channel} up to '{message}' as read ({e.Message})", LoggingTarget.Network);
 
             api.Queue(req);
         }

From c6d78b93257b172d044cc8932bd857555a82571d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 24 Feb 2022 16:12:15 +0900
Subject: [PATCH 3062/5547] Fix several oversights in data linking causing
 drawable rooms not updating as expected

---
 osu.Game/Online/Rooms/Room.cs                    |  2 ++
 .../Components/StarRatingRangeDisplay.cs         | 16 ++++++----------
 .../Screens/OnlinePlay/OnlinePlayComposite.cs    |  3 +++
 3 files changed, 11 insertions(+), 10 deletions(-)

diff --git a/osu.Game/Online/Rooms/Room.cs b/osu.Game/Online/Rooms/Room.cs
index c7f34905e2..a33150fe08 100644
--- a/osu.Game/Online/Rooms/Room.cs
+++ b/osu.Game/Online/Rooms/Room.cs
@@ -46,6 +46,7 @@ namespace osu.Game.Online.Rooms
         public readonly Bindable<RoomPlaylistItemStats> PlaylistItemStats = new Bindable<RoomPlaylistItemStats>();
 
         [JsonProperty("difficulty_range")]
+        [Cached]
         public readonly Bindable<RoomDifficultyRange> DifficultyRange = new Bindable<RoomDifficultyRange>();
 
         [Cached]
@@ -190,6 +191,7 @@ namespace osu.Game.Online.Rooms
             QueueMode.Value = other.QueueMode.Value;
             DifficultyRange.Value = other.DifficultyRange.Value;
             PlaylistItemStats.Value = other.PlaylistItemStats.Value;
+            CurrentPlaylistItem.Value = other.CurrentPlaylistItem.Value;
 
             if (EndDate.Value != null && DateTimeOffset.Now >= EndDate.Value)
                 Status.Value = new RoomStatusEnded();
diff --git a/osu.Game/Screens/OnlinePlay/Components/StarRatingRangeDisplay.cs b/osu.Game/Screens/OnlinePlay/Components/StarRatingRangeDisplay.cs
index 0b673006ef..7425e46bd3 100644
--- a/osu.Game/Screens/OnlinePlay/Components/StarRatingRangeDisplay.cs
+++ b/osu.Game/Screens/OnlinePlay/Components/StarRatingRangeDisplay.cs
@@ -2,7 +2,6 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
-using System.Collections.Specialized;
 using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
@@ -12,7 +11,6 @@ using osu.Framework.Utils;
 using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.Drawables;
 using osu.Game.Graphics;
-using osu.Game.Online.Rooms;
 using osuTK;
 
 namespace osu.Game.Screens.OnlinePlay.Components
@@ -72,25 +70,23 @@ namespace osu.Game.Screens.OnlinePlay.Components
             };
         }
 
-        [Resolved]
-        private Room room { get; set; }
-
         protected override void LoadComplete()
         {
             base.LoadComplete();
 
-            Playlist.BindCollectionChanged(updateRange, true);
+            DifficultyRange.BindValueChanged(_ => updateRange());
+            Playlist.BindCollectionChanged((_, __) => updateRange(), true);
         }
 
-        private void updateRange(object sender, NotifyCollectionChangedEventArgs e)
+        private void updateRange()
         {
             StarDifficulty minDifficulty;
             StarDifficulty maxDifficulty;
 
-            if (room.DifficultyRange.Value != null)
+            if (DifficultyRange.Value != null)
             {
-                minDifficulty = new StarDifficulty(room.DifficultyRange.Value.Min, 0);
-                maxDifficulty = new StarDifficulty(room.DifficultyRange.Value.Max, 0);
+                minDifficulty = new StarDifficulty(DifficultyRange.Value.Min, 0);
+                maxDifficulty = new StarDifficulty(DifficultyRange.Value.Max, 0);
             }
             else
             {
diff --git a/osu.Game/Screens/OnlinePlay/OnlinePlayComposite.cs b/osu.Game/Screens/OnlinePlay/OnlinePlayComposite.cs
index 7d1feb0316..984880dc3c 100644
--- a/osu.Game/Screens/OnlinePlay/OnlinePlayComposite.cs
+++ b/osu.Game/Screens/OnlinePlay/OnlinePlayComposite.cs
@@ -41,6 +41,9 @@ namespace osu.Game.Screens.OnlinePlay
         [Resolved(typeof(Room))]
         protected BindableList<PlaylistItem> Playlist { get; private set; }
 
+        [Resolved(typeof(Room))]
+        protected Bindable<Room.RoomDifficultyRange> DifficultyRange { get; private set; }
+
         [Resolved(typeof(Room))]
         protected Bindable<RoomCategory> Category { get; private set; }
 

From bb1aa032bdd70c62abb6d6fe3833dacde8b32a71 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 24 Feb 2022 16:20:40 +0900
Subject: [PATCH 3063/5547] Combine `SelectedItem` and `CurrentPlaylistItem`
 into same storage

---
 .../Lounge/Components/DrawableRoom.cs         |  2 +-
 .../Match/MultiplayerMatchSettingsOverlay.cs  |  4 ++--
 .../Match/MultiplayerReadyButton.cs           |  4 ++--
 .../Match/Playlist/MultiplayerPlaylist.cs     |  4 ++--
 .../Screens/OnlinePlay/OnlinePlayComposite.cs | 22 ++++++++-----------
 5 files changed, 16 insertions(+), 20 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Lounge/Components/DrawableRoom.cs b/osu.Game/Screens/OnlinePlay/Lounge/Components/DrawableRoom.cs
index a1a82c907a..5adce862a0 100644
--- a/osu.Game/Screens/OnlinePlay/Lounge/Components/DrawableRoom.cs
+++ b/osu.Game/Screens/OnlinePlay/Lounge/Components/DrawableRoom.cs
@@ -388,7 +388,7 @@ namespace osu.Game.Screens.OnlinePlay.Lounge.Components
             protected override void LoadComplete()
             {
                 base.LoadComplete();
-                SelectedItem.BindValueChanged(onSelectedItemChanged, true);
+                CurrentPlaylistItem.BindValueChanged(onSelectedItemChanged, true);
             }
 
             private CancellationTokenSource beatmapLookupCancellation;
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs
index 7f1db733b3..be98a9d4e9 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs
@@ -343,7 +343,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
                 base.LoadComplete();
 
                 drawablePlaylist.Items.BindTo(Playlist);
-                drawablePlaylist.SelectedItem.BindTo(SelectedItem);
+                drawablePlaylist.SelectedItem.BindTo(CurrentPlaylistItem);
             }
 
             protected override void Update()
@@ -419,7 +419,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
                 if (text.StartsWith(not_found_prefix, StringComparison.Ordinal))
                 {
                     ErrorText.Text = "The selected beatmap is not available online.";
-                    SelectedItem.Value.MarkInvalid();
+                    CurrentPlaylistItem.Value.MarkInvalid();
                 }
                 else
                 {
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
index 06959d942f..023af85f3b 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
@@ -67,7 +67,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
         {
             base.LoadComplete();
 
-            SelectedItem.BindValueChanged(_ => updateState());
+            CurrentPlaylistItem.BindValueChanged(_ => updateState());
         }
 
         protected override void OnRoomUpdated()
@@ -111,7 +111,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
 
             bool enableButton =
                 Room?.State == MultiplayerRoomState.Open
-                && SelectedItem.Value?.ID == Room.Settings.PlaylistItemId
+                && CurrentPlaylistItem.Value?.ID == Room.Settings.PlaylistItemId
                 && !Room.Playlist.Single(i => i.ID == Room.Settings.PlaylistItemId).Expired
                 && !operationInProgress.Value;
 
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylist.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylist.cs
index 7b90532cce..eeafebfec0 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylist.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylist.cs
@@ -52,14 +52,14 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist
                         queueList = new MultiplayerQueueList
                         {
                             RelativeSizeAxes = Axes.Both,
-                            SelectedItem = { BindTarget = SelectedItem },
+                            SelectedItem = { BindTarget = CurrentPlaylistItem },
                             RequestEdit = item => RequestEdit?.Invoke(item)
                         },
                         historyList = new MultiplayerHistoryList
                         {
                             RelativeSizeAxes = Axes.Both,
                             Alpha = 0,
-                            SelectedItem = { BindTarget = SelectedItem }
+                            SelectedItem = { BindTarget = CurrentPlaylistItem }
                         }
                     }
                 }
diff --git a/osu.Game/Screens/OnlinePlay/OnlinePlayComposite.cs b/osu.Game/Screens/OnlinePlay/OnlinePlayComposite.cs
index 984880dc3c..95d9b2af15 100644
--- a/osu.Game/Screens/OnlinePlay/OnlinePlayComposite.cs
+++ b/osu.Game/Screens/OnlinePlay/OnlinePlayComposite.cs
@@ -32,6 +32,10 @@ namespace osu.Game.Screens.OnlinePlay
         [Resolved(typeof(Room))]
         protected Bindable<MatchType> Type { get; private set; }
 
+        /// <summary>
+        /// The currently selected item in the <see cref="RoomSubScreen"/>, or the current item from <see cref="Playlist"/>
+        /// if this <see cref="OnlinePlayComposite"/> is not within a <see cref="RoomSubScreen"/>.
+        /// </summary>
         [Resolved(typeof(Room))]
         protected Bindable<PlaylistItem> CurrentPlaylistItem { get; private set; }
 
@@ -80,12 +84,6 @@ namespace osu.Game.Screens.OnlinePlay
         [Resolved(CanBeNull = true)]
         private IBindable<PlaylistItem> subScreenSelectedItem { get; set; }
 
-        /// <summary>
-        /// The currently selected item in the <see cref="RoomSubScreen"/>, or the current item from <see cref="Playlist"/>
-        /// if this <see cref="OnlinePlayComposite"/> is not within a <see cref="RoomSubScreen"/>.
-        /// </summary>
-        protected readonly Bindable<PlaylistItem> SelectedItem = new Bindable<PlaylistItem>();
-
         protected override void LoadComplete()
         {
             base.LoadComplete();
@@ -96,13 +94,11 @@ namespace osu.Game.Screens.OnlinePlay
 
         protected void UpdateSelectedItem()
         {
-            if (RoomID.Value == null || subScreenSelectedItem == null)
-            {
-                SelectedItem.Value = CurrentPlaylistItem.Value ?? Playlist.GetCurrentItem();
-                return;
-            }
-
-            SelectedItem.Value = subScreenSelectedItem.Value;
+            // null room ID means this is a room in the process of being created.
+            if (RoomID.Value == null)
+                CurrentPlaylistItem.Value = Playlist.GetCurrentItem();
+            else if (subScreenSelectedItem != null)
+                CurrentPlaylistItem.Value = subScreenSelectedItem.Value;
         }
     }
 }

From 328166f0d56043199ce8e1de9e6af080dc22de35 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 24 Feb 2022 17:01:04 +0900
Subject: [PATCH 3064/5547] Add failing test

---
 osu.Game.Tests/Online/TestAPIModJsonSerialization.cs | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/osu.Game.Tests/Online/TestAPIModJsonSerialization.cs b/osu.Game.Tests/Online/TestAPIModJsonSerialization.cs
index 1b7a7656b5..d5ea3e492c 100644
--- a/osu.Game.Tests/Online/TestAPIModJsonSerialization.cs
+++ b/osu.Game.Tests/Online/TestAPIModJsonSerialization.cs
@@ -121,6 +121,17 @@ namespace osu.Game.Tests.Online
             Assert.That((deserialised?.Mods[0])?.Settings["speed_change"], Is.EqualTo(2));
         }
 
+        [Test]
+        public void TestAPIModDetachedFromSource()
+        {
+            var mod = new OsuModDoubleTime { SpeedChange = { Value = 1.01 } };
+            var apiMod = new APIMod(mod);
+
+            mod.SpeedChange.Value = 1.5;
+
+            Assert.That(apiMod.Settings["speed_change"], Is.EqualTo(1.01d));
+        }
+
         private class TestRuleset : Ruleset
         {
             public override IEnumerable<Mod> GetModsFor(ModType type) => new Mod[]

From 2acaffd5e72b80bbb90ae0a0b2e250527db7365c Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 24 Feb 2022 17:01:11 +0900
Subject: [PATCH 3065/5547] Fix APIMod storing bindables instead of value

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

diff --git a/osu.Game/Online/API/APIMod.cs b/osu.Game/Online/API/APIMod.cs
index 62f9976c0f..67041cae07 100644
--- a/osu.Game/Online/API/APIMod.cs
+++ b/osu.Game/Online/API/APIMod.cs
@@ -42,7 +42,7 @@ namespace osu.Game.Online.API
                 var bindable = (IBindable)property.GetValue(mod);
 
                 if (!bindable.IsDefault)
-                    Settings.Add(property.Name.Underscore(), bindable);
+                    Settings.Add(property.Name.Underscore(), ModUtils.GetSettingUnderlyingValue(bindable));
             }
         }
 

From 7193bc8554a0fb3db8cc2fd08fb31f3082fc91fa Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 24 Feb 2022 17:01:43 +0900
Subject: [PATCH 3066/5547] Fix playlists comparing mod equality via APIMod

---
 osu.Game/Screens/OnlinePlay/Playlists/PlaylistsPlayer.cs | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsPlayer.cs b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsPlayer.cs
index 8403e1e0fe..7efeae8129 100644
--- a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsPlayer.cs
+++ b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsPlayer.cs
@@ -9,7 +9,6 @@ using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Screens;
 using osu.Game.Extensions;
-using osu.Game.Online.API;
 using osu.Game.Online.Rooms;
 using osu.Game.Rulesets;
 using osu.Game.Scoring;
@@ -40,8 +39,8 @@ namespace osu.Game.Screens.OnlinePlay.Playlists
             if (ruleset.Value.OnlineID != PlaylistItem.RulesetID)
                 throw new InvalidOperationException("Current Ruleset does not match PlaylistItem's Ruleset");
 
-            var localMods = Mods.Value.Select(m => new APIMod(m)).ToArray();
-            if (!PlaylistItem.RequiredMods.All(m => localMods.Any(m.Equals)))
+            var requiredLocalMods = PlaylistItem.RequiredMods.Select(m => m.ToMod(GameplayState.Ruleset));
+            if (!requiredLocalMods.All(m => Mods.Value.Any(m.Equals)))
                 throw new InvalidOperationException("Current Mods do not match PlaylistItem's RequiredMods");
         }
 

From 255b3b067b3774b39a4f0cbf6f07555b5d3fbd2b Mon Sep 17 00:00:00 2001
From: Susko3 <16479013+Susko3@users.noreply.github.com>
Date: Thu, 24 Feb 2022 10:13:27 +0100
Subject: [PATCH 3067/5547] Remove track fade

---
 osu.Game/Screens/Menu/MainMenu.cs | 12 +-----------
 1 file changed, 1 insertion(+), 11 deletions(-)

diff --git a/osu.Game/Screens/Menu/MainMenu.cs b/osu.Game/Screens/Menu/MainMenu.cs
index a2cb448d40..81e03b94ae 100644
--- a/osu.Game/Screens/Menu/MainMenu.cs
+++ b/osu.Game/Screens/Menu/MainMenu.cs
@@ -309,18 +309,8 @@ namespace osu.Game.Screens.Menu
 
             if (e.Action == GlobalAction.Back && host.CanSuspendToBackground)
             {
-                bool didSuspend = host.SuspendToBackground();
-
-                if (didSuspend)
-                {
-                    // fade the track so the Bass.Pause() on suspend isn't as jarring.
-                    const double fade_time = 500;
-                    musicController.CurrentTrack
-                                   .VolumeTo(0, fade_time, Easing.Out).Then()
-                                   .VolumeTo(1, fade_time, Easing.In);
-
+                if (host.SuspendToBackground())
                     return true;
-                }
             }
 
             return false;

From 6f29cbccd140cd222d3c72e8c2b17c94080ae43c Mon Sep 17 00:00:00 2001
From: Susko3 <16479013+Susko3@users.noreply.github.com>
Date: Thu, 24 Feb 2022 10:36:10 +0100
Subject: [PATCH 3068/5547] Remove unused using

---
 osu.Game/Screens/Menu/MainMenu.cs | 1 -
 1 file changed, 1 deletion(-)

diff --git a/osu.Game/Screens/Menu/MainMenu.cs b/osu.Game/Screens/Menu/MainMenu.cs
index 81e03b94ae..0357332cf6 100644
--- a/osu.Game/Screens/Menu/MainMenu.cs
+++ b/osu.Game/Screens/Menu/MainMenu.cs
@@ -3,7 +3,6 @@
 
 using System;
 using osu.Framework.Allocation;
-using osu.Framework.Audio;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Input.Bindings;

From c5b1e5cbf84d9c7f2ea52caa8b5e83b67c54b7d7 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 24 Feb 2022 20:11:58 +0900
Subject: [PATCH 3069/5547] Fix union resolver failing on multiple derived
 types

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

diff --git a/osu.Game/Online/SignalRUnionWorkaroundResolver.cs b/osu.Game/Online/SignalRUnionWorkaroundResolver.cs
index e64f9ed91c..c96f93df78 100644
--- a/osu.Game/Online/SignalRUnionWorkaroundResolver.cs
+++ b/osu.Game/Online/SignalRUnionWorkaroundResolver.cs
@@ -27,7 +27,7 @@ namespace osu.Game.Online
 
             // This should not be required. The fallback should work. But something is weird with the way caching is done.
             // For future adventurers, I would not advise looking into this further. It's likely not worth the effort.
-            baseMap = baseMap.Concat(baseMap.Select(t => (t.baseType, t.baseType)));
+            baseMap = baseMap.Concat(baseMap.Select(t => (t.baseType, t.baseType)).Distinct());
 
             return new Dictionary<Type, IMessagePackFormatter>(baseMap.Select(t =>
             {

From cd8190b2e744f635e86fe197cd6b360c9460963d Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 24 Feb 2022 20:45:15 +0900
Subject: [PATCH 3070/5547] Remove Microsoft.CodeAnalysis.NetAnalyzers package

---
 Directory.Build.props | 1 -
 1 file changed, 1 deletion(-)

diff --git a/Directory.Build.props b/Directory.Build.props
index c1682638c2..5bdf12218c 100644
--- a/Directory.Build.props
+++ b/Directory.Build.props
@@ -18,7 +18,6 @@
   <ItemGroup Label="Code Analysis">
     <PackageReference Include="Microsoft.CodeAnalysis.BannedApiAnalyzers" Version="3.3.3" PrivateAssets="All" />
     <AdditionalFiles Include="$(MSBuildThisFileDirectory)CodeAnalysis\BannedSymbols.txt" />
-    <PackageReference Include="Microsoft.CodeAnalysis.NetAnalyzers" Version="6.0.0" PrivateAssets="All" />
   </ItemGroup>
   <PropertyGroup Label="Code Analysis">
     <CodeAnalysisRuleSet>$(MSBuildThisFileDirectory)CodeAnalysis\osu.ruleset</CodeAnalysisRuleSet>

From c189cc5d002c0a14ab15b83cdc6c462c2d03f78f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 24 Feb 2022 21:01:37 +0100
Subject: [PATCH 3071/5547] Remove unused using directive

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

diff --git a/osu.Game/Overlays/Mods/ModPanel.cs b/osu.Game/Overlays/Mods/ModPanel.cs
index 13e2b5bb0b..af8ad3eb18 100644
--- a/osu.Game/Overlays/Mods/ModPanel.cs
+++ b/osu.Game/Overlays/Mods/ModPanel.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.Audio;
 using osu.Framework.Audio.Sample;

From 33a87976a8ac17f8ac0d559b254c6c4a0862c35e Mon Sep 17 00:00:00 2001
From: Susko3 <16479013+Susko3@users.noreply.github.com>
Date: Thu, 24 Feb 2022 21:11:49 +0100
Subject: [PATCH 3072/5547] Rewrite to read better

Co-authored-by: Dean Herbert <pe@ppy.sh>
---
 osu.Game/Screens/Menu/MainMenu.cs | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Screens/Menu/MainMenu.cs b/osu.Game/Screens/Menu/MainMenu.cs
index 0357332cf6..b0208a0ae8 100644
--- a/osu.Game/Screens/Menu/MainMenu.cs
+++ b/osu.Game/Screens/Menu/MainMenu.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.Bindables;
 using osu.Framework.Graphics;
@@ -306,10 +307,13 @@ namespace osu.Game.Screens.Menu
             if (e.Repeat)
                 return false;
 
-            if (e.Action == GlobalAction.Back && host.CanSuspendToBackground)
+            switch (e.Action)
             {
-                if (host.SuspendToBackground())
-                    return true;
+                case GlobalAction.Back:
+                    // In the case of a host being able to exit, the back action is handled by ExitConfirmOverlay.
+                    Debug.Assert(!host.CanExit);
+
+                    return host.SuspendToBackground();
             }
 
             return false;

From f9d9ad388b565a517bc2ad918368265a6a05fe56 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 25 Feb 2022 16:03:28 +0900
Subject: [PATCH 3073/5547] Add chat display to multiplayer spectator screen

---
 .../TestSceneMultiSpectatorScreen.cs          |  7 ++---
 .../Multiplayer/MultiplayerMatchSubScreen.cs  |  2 +-
 .../Spectate/MultiSpectatorScreen.cs          | 27 +++++++++++++------
 3 files changed, 24 insertions(+), 12 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs
index 7ce0c6a94d..77a06e5746 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs
@@ -15,6 +15,7 @@ using osu.Game.Configuration;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Multiplayer.MatchTypes.TeamVersus;
+using osu.Game.Online.Rooms;
 using osu.Game.Rulesets.UI;
 using osu.Game.Screens.OnlinePlay.Multiplayer.Spectate;
 using osu.Game.Screens.Play;
@@ -377,7 +378,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 Beatmap.Value = beatmapManager.GetWorkingBeatmap(importedBeatmap);
                 Ruleset.Value = importedBeatmap.Ruleset;
 
-                LoadScreen(spectatorScreen = new TestMultiSpectatorScreen(playingUsers.ToArray(), gameplayStartTime));
+                LoadScreen(spectatorScreen = new TestMultiSpectatorScreen(SelectedRoom.Value, playingUsers.ToArray(), gameplayStartTime));
             });
 
             AddUntilStep("wait for screen load", () => spectatorScreen.LoadState == LoadState.Loaded && (!waitForPlayerLoad || spectatorScreen.AllPlayersLoaded));
@@ -465,8 +466,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             private readonly double? gameplayStartTime;
 
-            public TestMultiSpectatorScreen(MultiplayerRoomUser[] users, double? gameplayStartTime = null)
-                : base(users)
+            public TestMultiSpectatorScreen(Room room, MultiplayerRoomUser[] users, double? gameplayStartTime = null)
+                : base(room, users)
             {
                 this.gameplayStartTime = gameplayStartTime;
             }
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
index 429b0ad89b..c78dcb7cb6 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
@@ -449,7 +449,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
             switch (client.LocalUser.State)
             {
                 case MultiplayerUserState.Spectating:
-                    return new MultiSpectatorScreen(users.Take(PlayerGrid.MAX_PLAYERS).ToArray());
+                    return new MultiSpectatorScreen(Room, users.Take(PlayerGrid.MAX_PLAYERS).ToArray());
 
                 default:
                     return new MultiplayerPlayerLoader(() => new MultiplayerPlayer(Room, SelectedItem.Value, users));
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorScreen.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorScreen.cs
index e5eeeb3448..1cc4497675 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorScreen.cs
@@ -11,10 +11,12 @@ using osu.Framework.Graphics.Containers;
 using osu.Game.Beatmaps;
 using osu.Game.Graphics;
 using osu.Game.Online.Multiplayer;
+using osu.Game.Online.Rooms;
 using osu.Game.Online.Spectator;
 using osu.Game.Screens.Play;
 using osu.Game.Screens.Play.HUD;
 using osu.Game.Screens.Spectate;
+using osuTK;
 
 namespace osu.Game.Screens.OnlinePlay.Multiplayer.Spectate
 {
@@ -48,15 +50,18 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Spectate
         private PlayerArea currentAudioSource;
         private bool canStartMasterClock;
 
+        private readonly Room room;
         private readonly MultiplayerRoomUser[] users;
 
         /// <summary>
         /// Creates a new <see cref="MultiSpectatorScreen"/>.
         /// </summary>
+        /// <param name="room">The room.</param>
         /// <param name="users">The players to spectate.</param>
-        public MultiSpectatorScreen(MultiplayerRoomUser[] users)
+        public MultiSpectatorScreen(Room room, MultiplayerRoomUser[] users)
             : base(users.Select(u => u.UserID).ToArray())
         {
+            this.room = room;
             this.users = users;
 
             instances = new PlayerArea[Users.Count];
@@ -65,7 +70,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Spectate
         [BackgroundDependencyLoader]
         private void load()
         {
-            Container leaderboardContainer;
+            FillFlowContainer leaderboardFlow;
             Container scoreDisplayContainer;
 
             masterClockContainer = CreateMasterGameplayClockContainer(Beatmap.Value);
@@ -97,10 +102,13 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Spectate
                                 {
                                     new Drawable[]
                                     {
-                                        leaderboardContainer = new Container
+                                        leaderboardFlow = new FillFlowContainer
                                         {
-                                            RelativeSizeAxes = Axes.Y,
-                                            AutoSizeAxes = Axes.X
+                                            Anchor = Anchor.CentreLeft,
+                                            Origin = Anchor.CentreLeft,
+                                            AutoSizeAxes = Axes.Both,
+                                            Direction = FillDirection.Vertical,
+                                            Spacing = new Vector2(5)
                                         },
                                         grid = new PlayerGrid { RelativeSizeAxes = Axes.Both }
                                     }
@@ -125,14 +133,12 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Spectate
             LoadComponentAsync(leaderboard = new MultiSpectatorLeaderboard(scoreProcessor, users)
             {
                 Expanded = { Value = true },
-                Anchor = Anchor.CentreLeft,
-                Origin = Anchor.CentreLeft,
             }, l =>
             {
                 foreach (var instance in instances)
                     leaderboard.AddClock(instance.UserId, instance.GameplayClock);
 
-                leaderboardContainer.Add(leaderboard);
+                leaderboardFlow.Insert(0, leaderboard);
 
                 if (leaderboard.TeamScores.Count == 2)
                 {
@@ -143,6 +149,11 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Spectate
                     }, scoreDisplayContainer.Add);
                 }
             });
+
+            LoadComponentAsync(new GameplayChatDisplay(room)
+            {
+                Expanded = { Value = true },
+            }, chat => leaderboardFlow.Insert(1, chat));
         }
 
         protected override void LoadComplete()

From 48ed9c61442ca05bb7fda4eaf8d7c64f8a37cdad Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 25 Feb 2022 16:03:46 +0900
Subject: [PATCH 3074/5547] Enable high chat polling rate

---
 osu.Game/OsuGame.cs                                    |  3 ++-
 .../Multiplayer/Spectate/MultiSpectatorScreen.cs       |  3 +++
 osu.Game/Users/UserActivity.cs                         | 10 ++++++++++
 3 files changed, 15 insertions(+), 1 deletion(-)

diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index fa5a336b7c..fb81e4fd14 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -838,7 +838,8 @@ namespace osu.Game
                 channelManager.HighPollRate.Value =
                     chatOverlay.State.Value == Visibility.Visible
                     || API.Activity.Value is UserActivity.InLobby
-                    || API.Activity.Value is UserActivity.InMultiplayerGame;
+                    || API.Activity.Value is UserActivity.InMultiplayerGame
+                    || API.Activity.Value is UserActivity.SpectatingMultiplayerGame;
             }
 
             Add(difficultyRecommender);
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorScreen.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorScreen.cs
index 1cc4497675..3bb76c4a76 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorScreen.cs
@@ -16,6 +16,7 @@ using osu.Game.Online.Spectator;
 using osu.Game.Screens.Play;
 using osu.Game.Screens.Play.HUD;
 using osu.Game.Screens.Spectate;
+using osu.Game.Users;
 using osuTK;
 
 namespace osu.Game.Screens.OnlinePlay.Multiplayer.Spectate
@@ -36,6 +37,8 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Spectate
         /// </summary>
         public bool AllPlayersLoaded => instances.All(p => p?.PlayerLoaded == true);
 
+        protected override UserActivity InitialActivity => new UserActivity.SpectatingMultiplayerGame(Beatmap.Value.BeatmapInfo, Ruleset.Value);
+
         [Resolved]
         private OsuColour colours { get; set; }
 
diff --git a/osu.Game/Users/UserActivity.cs b/osu.Game/Users/UserActivity.cs
index 516aa80652..2f945d6e1c 100644
--- a/osu.Game/Users/UserActivity.cs
+++ b/osu.Game/Users/UserActivity.cs
@@ -50,6 +50,16 @@ namespace osu.Game.Users
             public override string Status => $@"{base.Status} with others";
         }
 
+        public class SpectatingMultiplayerGame : InGame
+        {
+            public SpectatingMultiplayerGame(IBeatmapInfo beatmapInfo, IRulesetInfo ruleset)
+                : base(beatmapInfo, ruleset)
+            {
+            }
+
+            public override string Status => $"Watching others {base.Status.ToLowerInvariant()}";
+        }
+
         public class InPlaylistGame : InGame
         {
             public InPlaylistGame(IBeatmapInfo beatmapInfo, IRulesetInfo ruleset)

From 387ae59bc4108372afaa75f3050b10eb04ee26dc Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 25 Feb 2022 16:12:25 +0900
Subject: [PATCH 3075/5547] Fix nullref in tests

---
 .../OnlinePlay/Multiplayer/GameplayChatDisplay.cs      | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/GameplayChatDisplay.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/GameplayChatDisplay.cs
index 53fd111c27..d08a63e21f 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/GameplayChatDisplay.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/GameplayChatDisplay.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 JetBrains.Annotations;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
@@ -15,10 +16,11 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
 {
     public class GameplayChatDisplay : MatchChatDisplay, IKeyBindingHandler<GlobalAction>
     {
-        [Resolved]
+        [Resolved(CanBeNull = true)]
+        [CanBeNull]
         private ILocalUserPlayInfo localUserInfo { get; set; }
 
-        private IBindable<bool> localUserPlaying = new Bindable<bool>();
+        private readonly IBindable<bool> localUserPlaying = new Bindable<bool>();
 
         public override bool PropagatePositionalInputSubTree => !localUserPlaying.Value;
 
@@ -46,7 +48,9 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
         {
             base.LoadComplete();
 
-            localUserPlaying = localUserInfo.IsPlaying.GetBoundCopy();
+            if (localUserInfo != null)
+                localUserPlaying.BindTo(localUserInfo.IsPlaying);
+
             localUserPlaying.BindValueChanged(playing =>
             {
                 // for now let's never hold focus. this avoid misdirected gameplay keys entering chat.

From 8eef1774d5b2b6a58f67a17d1ca3804ce2dbbf76 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 25 Feb 2022 20:18:22 +0900
Subject: [PATCH 3076/5547] Use Logger.Log instead of console

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

diff --git a/osu.Game/Online/Spectator/SpectatorClient.cs b/osu.Game/Online/Spectator/SpectatorClient.cs
index d0b89e981d..70baf69037 100644
--- a/osu.Game/Online/Spectator/SpectatorClient.cs
+++ b/osu.Game/Online/Spectator/SpectatorClient.cs
@@ -279,7 +279,7 @@ namespace osu.Game.Online.Spectator
 
             totalBundledFrames += frames.Length;
 
-            Console.WriteLine($"Purging {pendingFrames.Count} frames (total {totalBundledFrames})");
+            Logger.Log($"Purging {pendingFrames.Count} frames (total {totalBundledFrames})");
 
             pendingFrames.Clear();
             lastPurgeTime = Time.Current;

From 67082b8c5de9d97d353ea973f34bc6773af4029f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 25 Feb 2022 22:25:36 +0900
Subject: [PATCH 3077/5547] Remove verbose logging from `SpectatorClient` for
 now

---
 osu.Game/Online/Spectator/SpectatorClient.cs | 8 --------
 1 file changed, 8 deletions(-)

diff --git a/osu.Game/Online/Spectator/SpectatorClient.cs b/osu.Game/Online/Spectator/SpectatorClient.cs
index 70baf69037..8f22078010 100644
--- a/osu.Game/Online/Spectator/SpectatorClient.cs
+++ b/osu.Game/Online/Spectator/SpectatorClient.cs
@@ -86,8 +86,6 @@ namespace osu.Game.Online.Spectator
 
         private Task? lastSend;
 
-        private int totalBundledFrames;
-
         private const int max_pending_frames = 30;
 
         [BackgroundDependencyLoader]
@@ -169,8 +167,6 @@ namespace osu.Game.Online.Spectator
 
                 IsPlaying = true;
 
-                totalBundledFrames = 0;
-
                 // transfer state at point of beginning play
                 currentState.BeatmapID = score.ScoreInfo.BeatmapInfo.OnlineID;
                 currentState.RulesetID = score.ScoreInfo.RulesetID;
@@ -277,10 +273,6 @@ namespace osu.Game.Online.Spectator
             var frames = pendingFrames.ToArray();
             var bundle = new FrameDataBundle(currentScore.ScoreInfo, frames);
 
-            totalBundledFrames += frames.Length;
-
-            Logger.Log($"Purging {pendingFrames.Count} frames (total {totalBundledFrames})");
-
             pendingFrames.Clear();
             lastPurgeTime = Time.Current;
 

From 926108af7da97c9f0114702ba94adc0f3643c4c7 Mon Sep 17 00:00:00 2001
From: Shivam <s.r.v.ramkisoen@umail.leidenuniv.nl>
Date: Fri, 25 Feb 2022 14:15:19 +0100
Subject: [PATCH 3078/5547] Change launch args from dotnet 5 to dotnet 6

---
 .vscode/launch.json | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/.vscode/launch.json b/.vscode/launch.json
index 1b590008cd..d93fddf42d 100644
--- a/.vscode/launch.json
+++ b/.vscode/launch.json
@@ -7,7 +7,7 @@
             "request": "launch",
             "program": "dotnet",
             "args": [
-                "${workspaceRoot}/osu.Desktop/bin/Debug/net5.0/osu!.dll"
+                "${workspaceRoot}/osu.Desktop/bin/Debug/net6.0/osu!.dll"
             ],
             "cwd": "${workspaceRoot}",
             "preLaunchTask": "Build osu! (Debug)",
@@ -19,7 +19,7 @@
             "request": "launch",
             "program": "dotnet",
             "args": [
-                "${workspaceRoot}/osu.Desktop/bin/Release/net5.0/osu!.dll"
+                "${workspaceRoot}/osu.Desktop/bin/Release/net6.0/osu!.dll"
             ],
             "cwd": "${workspaceRoot}",
             "preLaunchTask": "Build osu! (Release)",
@@ -31,7 +31,7 @@
             "request": "launch",
             "program": "dotnet",
             "args": [
-                "${workspaceRoot}/osu.Game.Tests/bin/Debug/net5.0/osu.Game.Tests.dll"
+                "${workspaceRoot}/osu.Game.Tests/bin/Debug/net6.0/osu.Game.Tests.dll"
             ],
             "cwd": "${workspaceRoot}",
             "preLaunchTask": "Build tests (Debug)",
@@ -43,7 +43,7 @@
             "request": "launch",
             "program": "dotnet",
             "args": [
-                "${workspaceRoot}/osu.Game.Tests/bin/Release/net5.0/osu.Game.Tests.dll"
+                "${workspaceRoot}/osu.Game.Tests/bin/Release/net6.0/osu.Game.Tests.dll"
             ],
             "cwd": "${workspaceRoot}",
             "preLaunchTask": "Build tests (Release)",
@@ -55,7 +55,7 @@
             "request": "launch",
             "program": "dotnet",
             "args": [
-                "${workspaceRoot}/osu.Desktop/bin/Debug/net5.0/osu!.dll",
+                "${workspaceRoot}/osu.Desktop/bin/Debug/net6.0/osu!.dll",
                 "--tournament"
             ],
             "cwd": "${workspaceRoot}",
@@ -68,7 +68,7 @@
             "request": "launch",
             "program": "dotnet",
             "args": [
-                "${workspaceRoot}/osu.Desktop/bin/Release/net5.0/osu!.dll",
+                "${workspaceRoot}/osu.Desktop/bin/Release/net6.0/osu!.dll",
                 "--tournament"
             ],
             "cwd": "${workspaceRoot}",
@@ -81,7 +81,7 @@
             "request": "launch",
             "program": "dotnet",
             "args": [
-                "${workspaceRoot}/osu.Game.Tournament.Tests/bin/Debug/net5.0/osu.Game.Tournament.Tests.dll",
+                "${workspaceRoot}/osu.Game.Tournament.Tests/bin/Debug/net6.0/osu.Game.Tournament.Tests.dll",
                 "--tournament"
             ],
             "cwd": "${workspaceRoot}",
@@ -94,7 +94,7 @@
             "request": "launch",
             "program": "dotnet",
             "args": [
-                "${workspaceRoot}/osu.Game.Tournament.Tests/bin/Debug/net5.0/osu.Game.Tournament.Tests.dll",
+                "${workspaceRoot}/osu.Game.Tournament.Tests/bin/Debug/net6.0/osu.Game.Tournament.Tests.dll",
                 "--tournament"
             ],
             "cwd": "${workspaceRoot}",
@@ -105,7 +105,7 @@
             "name": "Benchmark",
             "type": "coreclr",
             "request": "launch",
-            "program": "${workspaceRoot}/osu.Game.Benchmarks/bin/Release/net5.0/osu.Game.Benchmarks.dll",
+            "program": "${workspaceRoot}/osu.Game.Benchmarks/bin/Release/net6.0/osu.Game.Benchmarks.dll",
             "args": [
                 "--filter",
                 "*"

From 1a7a160f0a5a10345fd1537bf106022589038b18 Mon Sep 17 00:00:00 2001
From: Shivam <s.r.v.ramkisoen@umail.leidenuniv.nl>
Date: Fri, 25 Feb 2022 14:26:44 +0100
Subject: [PATCH 3079/5547] Update vscode launch.json files for all other
 projects

---
 .../osu.Game.Rulesets.EmptyFreeform.Tests/.vscode/launch.json | 4 ++--
 .../osu.Game.Rulesets.Pippidon.Tests/.vscode/launch.json      | 4 ++--
 .../.vscode/launch.json                                       | 4 ++--
 .../osu.Game.Rulesets.Pippidon.Tests/.vscode/launch.json      | 4 ++--
 osu.Game.Rulesets.Catch.Tests/.vscode/launch.json             | 4 ++--
 osu.Game.Rulesets.Mania.Tests/.vscode/launch.json             | 4 ++--
 osu.Game.Rulesets.Osu.Tests/.vscode/launch.json               | 4 ++--
 osu.Game.Rulesets.Taiko.Tests/.vscode/launch.json             | 4 ++--
 osu.Game.Tournament.Tests/.vscode/launch.json                 | 4 ++--
 9 files changed, 18 insertions(+), 18 deletions(-)

diff --git a/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform.Tests/.vscode/launch.json b/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform.Tests/.vscode/launch.json
index fd03878699..b433819346 100644
--- a/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform.Tests/.vscode/launch.json
+++ b/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform.Tests/.vscode/launch.json
@@ -7,7 +7,7 @@
             "request": "launch",
             "program": "dotnet",
             "args": [
-                "${workspaceRoot}/bin/Debug/net5.0/osu.Game.Rulesets.EmptyFreeformRuleset.Tests.dll"
+                "${workspaceRoot}/bin/Debug/net6.0/osu.Game.Rulesets.EmptyFreeformRuleset.Tests.dll"
             ],
             "cwd": "${workspaceRoot}",
             "preLaunchTask": "Build (Debug)",
@@ -20,7 +20,7 @@
             "request": "launch",
             "program": "dotnet",
             "args": [
-                "${workspaceRoot}/bin/Release/net5.0/osu.Game.Rulesets.EmptyFreeformRuleset.Tests.dll"
+                "${workspaceRoot}/bin/Release/net6.0/osu.Game.Rulesets.EmptyFreeformRuleset.Tests.dll"
             ],
             "cwd": "${workspaceRoot}",
             "preLaunchTask": "Build (Release)",
diff --git a/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon.Tests/.vscode/launch.json b/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon.Tests/.vscode/launch.json
index bd9db14259..d60bc2571d 100644
--- a/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon.Tests/.vscode/launch.json
+++ b/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon.Tests/.vscode/launch.json
@@ -7,7 +7,7 @@
             "request": "launch",
             "program": "dotnet",
             "args": [
-                "${workspaceRoot}/bin/Debug/net5.0/osu.Game.Rulesets.Pippidon.Tests.dll"
+                "${workspaceRoot}/bin/Debug/net6.0/osu.Game.Rulesets.Pippidon.Tests.dll"
             ],
             "cwd": "${workspaceRoot}",
             "preLaunchTask": "Build (Debug)",
@@ -20,7 +20,7 @@
             "request": "launch",
             "program": "dotnet",
             "args": [
-                "${workspaceRoot}/bin/Release/net5.0/osu.Game.Rulesets.Pippidon.Tests.dll"
+                "${workspaceRoot}/bin/Release/net6.0/osu.Game.Rulesets.Pippidon.Tests.dll"
             ],
             "cwd": "${workspaceRoot}",
             "preLaunchTask": "Build (Release)",
diff --git a/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling.Tests/.vscode/launch.json b/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling.Tests/.vscode/launch.json
index 24e4873ed6..f1f37f6363 100644
--- a/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling.Tests/.vscode/launch.json
+++ b/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling.Tests/.vscode/launch.json
@@ -7,7 +7,7 @@
             "request": "launch",
             "program": "dotnet",
             "args": [
-                "${workspaceRoot}/bin/Debug/net5.0/osu.Game.Rulesets.EmptyScrolling.Tests.dll"
+                "${workspaceRoot}/bin/Debug/net6.0/osu.Game.Rulesets.EmptyScrolling.Tests.dll"
             ],
             "cwd": "${workspaceRoot}",
             "preLaunchTask": "Build (Debug)",
@@ -20,7 +20,7 @@
             "request": "launch",
             "program": "dotnet",
             "args": [
-                "${workspaceRoot}/bin/Release/net5.0/osu.Game.Rulesets.EmptyScrolling.Tests.dll"
+                "${workspaceRoot}/bin/Release/net6.0/osu.Game.Rulesets.EmptyScrolling.Tests.dll"
             ],
             "cwd": "${workspaceRoot}",
             "preLaunchTask": "Build (Release)",
diff --git a/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon.Tests/.vscode/launch.json b/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon.Tests/.vscode/launch.json
index bd9db14259..d60bc2571d 100644
--- a/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon.Tests/.vscode/launch.json
+++ b/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon.Tests/.vscode/launch.json
@@ -7,7 +7,7 @@
             "request": "launch",
             "program": "dotnet",
             "args": [
-                "${workspaceRoot}/bin/Debug/net5.0/osu.Game.Rulesets.Pippidon.Tests.dll"
+                "${workspaceRoot}/bin/Debug/net6.0/osu.Game.Rulesets.Pippidon.Tests.dll"
             ],
             "cwd": "${workspaceRoot}",
             "preLaunchTask": "Build (Debug)",
@@ -20,7 +20,7 @@
             "request": "launch",
             "program": "dotnet",
             "args": [
-                "${workspaceRoot}/bin/Release/net5.0/osu.Game.Rulesets.Pippidon.Tests.dll"
+                "${workspaceRoot}/bin/Release/net6.0/osu.Game.Rulesets.Pippidon.Tests.dll"
             ],
             "cwd": "${workspaceRoot}",
             "preLaunchTask": "Build (Release)",
diff --git a/osu.Game.Rulesets.Catch.Tests/.vscode/launch.json b/osu.Game.Rulesets.Catch.Tests/.vscode/launch.json
index 9aaaf418c2..201343a036 100644
--- a/osu.Game.Rulesets.Catch.Tests/.vscode/launch.json
+++ b/osu.Game.Rulesets.Catch.Tests/.vscode/launch.json
@@ -7,7 +7,7 @@
             "request": "launch",
             "program": "dotnet",
             "args": [
-                "${workspaceRoot}/bin/Debug/net5.0/osu.Game.Rulesets.Catch.Tests.dll"
+                "${workspaceRoot}/bin/Debug/net6.0/osu.Game.Rulesets.Catch.Tests.dll"
             ],
             "cwd": "${workspaceRoot}",
             "preLaunchTask": "Build (Debug)",
@@ -20,7 +20,7 @@
             "request": "launch",
             "program": "dotnet",
             "args": [
-                "${workspaceRoot}/bin/Release/net5.0/osu.Game.Rulesets.Catch.Tests.dll"
+                "${workspaceRoot}/bin/Release/net6.0/osu.Game.Rulesets.Catch.Tests.dll"
             ],
             "cwd": "${workspaceRoot}",
             "preLaunchTask": "Build (Release)",
diff --git a/osu.Game.Rulesets.Mania.Tests/.vscode/launch.json b/osu.Game.Rulesets.Mania.Tests/.vscode/launch.json
index e3d7956e85..f6a067a831 100644
--- a/osu.Game.Rulesets.Mania.Tests/.vscode/launch.json
+++ b/osu.Game.Rulesets.Mania.Tests/.vscode/launch.json
@@ -7,7 +7,7 @@
             "request": "launch",
             "program": "dotnet",
             "args": [
-                "${workspaceRoot}/bin/Debug/net5.0/osu.Game.Rulesets.Mania.Tests.dll"
+                "${workspaceRoot}/bin/Debug/net6.0/osu.Game.Rulesets.Mania.Tests.dll"
             ],
             "cwd": "${workspaceRoot}",
             "preLaunchTask": "Build (Debug)",
@@ -20,7 +20,7 @@
             "request": "launch",
             "program": "dotnet",
             "args": [
-                "${workspaceRoot}/bin/Release/net5.0/osu.Game.Rulesets.Mania.Tests.dll"
+                "${workspaceRoot}/bin/Release/net6.0/osu.Game.Rulesets.Mania.Tests.dll"
             ],
             "cwd": "${workspaceRoot}",
             "preLaunchTask": "Build (Release)",
diff --git a/osu.Game.Rulesets.Osu.Tests/.vscode/launch.json b/osu.Game.Rulesets.Osu.Tests/.vscode/launch.json
index 01a5985464..61be25b845 100644
--- a/osu.Game.Rulesets.Osu.Tests/.vscode/launch.json
+++ b/osu.Game.Rulesets.Osu.Tests/.vscode/launch.json
@@ -7,7 +7,7 @@
             "request": "launch",
             "program": "dotnet",
             "args": [
-                "${workspaceRoot}/bin/Debug/net5.0/osu.Game.Rulesets.Osu.Tests.dll"
+                "${workspaceRoot}/bin/Debug/net6.0/osu.Game.Rulesets.Osu.Tests.dll"
             ],
             "cwd": "${workspaceRoot}",
             "preLaunchTask": "Build (Debug)",
@@ -20,7 +20,7 @@
             "request": "launch",
             "program": "dotnet",
             "args": [
-                "${workspaceRoot}/bin/Release/net5.0/osu.Game.Rulesets.Osu.Tests.dll"
+                "${workspaceRoot}/bin/Release/net6.0/osu.Game.Rulesets.Osu.Tests.dll"
             ],
             "cwd": "${workspaceRoot}",
             "preLaunchTask": "Build (Release)",
diff --git a/osu.Game.Rulesets.Taiko.Tests/.vscode/launch.json b/osu.Game.Rulesets.Taiko.Tests/.vscode/launch.json
index 779ebba9ae..56ec7d8d9c 100644
--- a/osu.Game.Rulesets.Taiko.Tests/.vscode/launch.json
+++ b/osu.Game.Rulesets.Taiko.Tests/.vscode/launch.json
@@ -7,7 +7,7 @@
             "request": "launch",
             "program": "dotnet",
             "args": [
-                "${workspaceRoot}/bin/Debug/net5.0/osu.Game.Rulesets.Taiko.Tests.dll"
+                "${workspaceRoot}/bin/Debug/net6.0/osu.Game.Rulesets.Taiko.Tests.dll"
             ],
             "cwd": "${workspaceRoot}",
             "preLaunchTask": "Build (Debug)",
@@ -20,7 +20,7 @@
             "request": "launch",
             "program": "dotnet",
             "args": [
-                "${workspaceRoot}/bin/Release/net5.0/osu.Game.Rulesets.Taiko.Tests.dll"
+                "${workspaceRoot}/bin/Release/net6.0/osu.Game.Rulesets.Taiko.Tests.dll"
             ],
             "cwd": "${workspaceRoot}",
             "preLaunchTask": "Build (Release)",
diff --git a/osu.Game.Tournament.Tests/.vscode/launch.json b/osu.Game.Tournament.Tests/.vscode/launch.json
index 28532d3ed3..51aa541811 100644
--- a/osu.Game.Tournament.Tests/.vscode/launch.json
+++ b/osu.Game.Tournament.Tests/.vscode/launch.json
@@ -7,7 +7,7 @@
             "request": "launch",
             "program": "dotnet",
             "args": [
-                "${workspaceRoot}/bin/Debug/net5.0/osu.Game.Tournament.Tests.dll"
+                "${workspaceRoot}/bin/Debug/net6.0/osu.Game.Tournament.Tests.dll"
             ],
             "cwd": "${workspaceRoot}",
             "preLaunchTask": "Build (Debug)",
@@ -20,7 +20,7 @@
             "request": "launch",
             "program": "dotnet",
             "args": [
-                "${workspaceRoot}/bin/Release/net5.0/osu.Game.Tournament.Tests.dll"
+                "${workspaceRoot}/bin/Release/net6.0/osu.Game.Tournament.Tests.dll"
             ],
             "cwd": "${workspaceRoot}",
             "preLaunchTask": "Build (Release)",

From c7f2759eb92385acb9e80f1cfd5addc79ad28ab7 Mon Sep 17 00:00:00 2001
From: Shivam <s.r.v.ramkisoen@umail.leidenuniv.nl>
Date: Fri, 25 Feb 2022 14:27:54 +0100
Subject: [PATCH 3080/5547] Update build configurations for Rider to net6.0
 paths

---
 .../.idea/runConfigurations/Benchmarks.xml                  | 6 +++---
 .../.idea/runConfigurations/CatchRuleset__Tests_.xml        | 6 +++---
 .../.idea/runConfigurations/ManiaRuleset__Tests_.xml        | 6 +++---
 .../.idea/runConfigurations/OsuRuleset__Tests_.xml          | 6 +++---
 .../.idea/runConfigurations/TaikoRuleset__Tests_.xml        | 6 +++---
 .../.idea/runConfigurations/Tournament.xml                  | 6 +++---
 .../.idea/runConfigurations/Tournament__Tests_.xml          | 6 +++---
 .idea/.idea.osu.Desktop/.idea/runConfigurations/osu_.xml    | 6 +++---
 .../.idea/runConfigurations/osu___Tests_.xml                | 6 +++---
 9 files changed, 27 insertions(+), 27 deletions(-)

diff --git a/.idea/.idea.osu.Desktop/.idea/runConfigurations/Benchmarks.xml b/.idea/.idea.osu.Desktop/.idea/runConfigurations/Benchmarks.xml
index 498a710df9..d500c595c0 100644
--- a/.idea/.idea.osu.Desktop/.idea/runConfigurations/Benchmarks.xml
+++ b/.idea/.idea.osu.Desktop/.idea/runConfigurations/Benchmarks.xml
@@ -1,8 +1,8 @@
 <component name="ProjectRunConfigurationManager">
   <configuration default="false" name="Benchmarks" type="DotNetProject" factoryName=".NET Project">
-    <option name="EXE_PATH" value="$PROJECT_DIR$/osu.Game.Benchmarks/bin/Debug/net5.0/osu.Game.Benchmarks.dll" />
+    <option name="EXE_PATH" value="$PROJECT_DIR$/osu.Game.Benchmarks/bin/Debug/net6.0/osu.Game.Benchmarks.dll" />
     <option name="PROGRAM_PARAMETERS" value="" />
-    <option name="WORKING_DIRECTORY" value="$PROJECT_DIR$/osu.Game.Benchmarks/bin/Debug/net5.0" />
+    <option name="WORKING_DIRECTORY" value="$PROJECT_DIR$/osu.Game.Benchmarks/bin/Debug/net6.0" />
     <option name="PASS_PARENT_ENVS" value="1" />
     <option name="USE_EXTERNAL_CONSOLE" value="0" />
     <option name="USE_MONO" value="0" />
@@ -12,7 +12,7 @@
     <option name="PROJECT_ARGUMENTS_TRACKING" value="1" />
     <option name="PROJECT_WORKING_DIRECTORY_TRACKING" value="1" />
     <option name="PROJECT_KIND" value="DotNetCore" />
-    <option name="PROJECT_TFM" value="net5.0" />
+    <option name="PROJECT_TFM" value="net6.0" />
     <method v="2">
       <option name="Build" />
     </method>
diff --git a/.idea/.idea.osu.Desktop/.idea/runConfigurations/CatchRuleset__Tests_.xml b/.idea/.idea.osu.Desktop/.idea/runConfigurations/CatchRuleset__Tests_.xml
index 657b885df1..6da760dead 100644
--- a/.idea/.idea.osu.Desktop/.idea/runConfigurations/CatchRuleset__Tests_.xml
+++ b/.idea/.idea.osu.Desktop/.idea/runConfigurations/CatchRuleset__Tests_.xml
@@ -1,8 +1,8 @@
 <component name="ProjectRunConfigurationManager">
   <configuration default="false" name="CatchRuleset (Tests)" type="DotNetProject" factoryName=".NET Project" folderName="Ruleset" activateToolWindowBeforeRun="false">
-    <option name="EXE_PATH" value="$PROJECT_DIR$/osu.Game.Rulesets.Catch.Tests/bin/Debug/net5.0/osu.Game.Rulesets.Catch.Tests.dll" />
+    <option name="EXE_PATH" value="$PROJECT_DIR$/osu.Game.Rulesets.Catch.Tests/bin/Debug/net6.0/osu.Game.Rulesets.Catch.Tests.dll" />
     <option name="PROGRAM_PARAMETERS" value="" />
-    <option name="WORKING_DIRECTORY" value="$PROJECT_DIR$/osu.Game.Rulesets.Catch.Tests/bin/Debug/net5.0" />
+    <option name="WORKING_DIRECTORY" value="$PROJECT_DIR$/osu.Game.Rulesets.Catch.Tests/bin/Debug/net6.0" />
     <option name="PASS_PARENT_ENVS" value="1" />
     <option name="USE_EXTERNAL_CONSOLE" value="0" />
     <option name="USE_MONO" value="0" />
@@ -12,7 +12,7 @@
     <option name="PROJECT_ARGUMENTS_TRACKING" value="1" />
     <option name="PROJECT_WORKING_DIRECTORY_TRACKING" value="1" />
     <option name="PROJECT_KIND" value="DotNetCore" />
-    <option name="PROJECT_TFM" value="net5.0" />
+    <option name="PROJECT_TFM" value="net6.0" />
     <browser url="http://localhost:5000" />
     <method v="2">
       <option name="Build" />
diff --git a/.idea/.idea.osu.Desktop/.idea/runConfigurations/ManiaRuleset__Tests_.xml b/.idea/.idea.osu.Desktop/.idea/runConfigurations/ManiaRuleset__Tests_.xml
index 847dcf822c..741679707a 100644
--- a/.idea/.idea.osu.Desktop/.idea/runConfigurations/ManiaRuleset__Tests_.xml
+++ b/.idea/.idea.osu.Desktop/.idea/runConfigurations/ManiaRuleset__Tests_.xml
@@ -1,8 +1,8 @@
 <component name="ProjectRunConfigurationManager">
   <configuration default="false" name="ManiaRuleset (Tests)" type="DotNetProject" factoryName=".NET Project" folderName="Ruleset" activateToolWindowBeforeRun="false">
-    <option name="EXE_PATH" value="$PROJECT_DIR$/osu.Game.Rulesets.Mania.Tests/bin/Debug/net5.0/osu.Game.Rulesets.Mania.Tests.dll" />
+    <option name="EXE_PATH" value="$PROJECT_DIR$/osu.Game.Rulesets.Mania.Tests/bin/Debug/net6.0/osu.Game.Rulesets.Mania.Tests.dll" />
     <option name="PROGRAM_PARAMETERS" value="" />
-    <option name="WORKING_DIRECTORY" value="$PROJECT_DIR$/osu.Game.Rulesets.Mania.Tests/bin/Debug/net5.0" />
+    <option name="WORKING_DIRECTORY" value="$PROJECT_DIR$/osu.Game.Rulesets.Mania.Tests/bin/Debug/net6.0" />
     <option name="PASS_PARENT_ENVS" value="1" />
     <option name="USE_EXTERNAL_CONSOLE" value="0" />
     <option name="USE_MONO" value="0" />
@@ -12,7 +12,7 @@
     <option name="PROJECT_ARGUMENTS_TRACKING" value="1" />
     <option name="PROJECT_WORKING_DIRECTORY_TRACKING" value="1" />
     <option name="PROJECT_KIND" value="DotNetCore" />
-    <option name="PROJECT_TFM" value="net5.0" />
+    <option name="PROJECT_TFM" value="net6.0" />
     <browser url="http://localhost:5000" />
     <method v="2">
       <option name="Build" />
diff --git a/.idea/.idea.osu.Desktop/.idea/runConfigurations/OsuRuleset__Tests_.xml b/.idea/.idea.osu.Desktop/.idea/runConfigurations/OsuRuleset__Tests_.xml
index 5dc1168e35..104b1266ca 100644
--- a/.idea/.idea.osu.Desktop/.idea/runConfigurations/OsuRuleset__Tests_.xml
+++ b/.idea/.idea.osu.Desktop/.idea/runConfigurations/OsuRuleset__Tests_.xml
@@ -1,8 +1,8 @@
 <component name="ProjectRunConfigurationManager">
   <configuration default="false" name="OsuRuleset (Tests)" type="DotNetProject" factoryName=".NET Project" folderName="Ruleset" activateToolWindowBeforeRun="false">
-    <option name="EXE_PATH" value="$PROJECT_DIR$/osu.Game.Rulesets.Osu.Tests/bin/Debug/net5.0/osu.Game.Rulesets.Osu.Tests.dll" />
+    <option name="EXE_PATH" value="$PROJECT_DIR$/osu.Game.Rulesets.Osu.Tests/bin/Debug/net6.0/osu.Game.Rulesets.Osu.Tests.dll" />
     <option name="PROGRAM_PARAMETERS" value="" />
-    <option name="WORKING_DIRECTORY" value="$PROJECT_DIR$/osu.Game.Rulesets.Osu.Tests/bin/Debug/net5.0" />
+    <option name="WORKING_DIRECTORY" value="$PROJECT_DIR$/osu.Game.Rulesets.Osu.Tests/bin/Debug/net6.0" />
     <option name="PASS_PARENT_ENVS" value="1" />
     <option name="USE_EXTERNAL_CONSOLE" value="0" />
     <option name="USE_MONO" value="0" />
@@ -12,7 +12,7 @@
     <option name="PROJECT_ARGUMENTS_TRACKING" value="1" />
     <option name="PROJECT_WORKING_DIRECTORY_TRACKING" value="1" />
     <option name="PROJECT_KIND" value="DotNetCore" />
-    <option name="PROJECT_TFM" value="net5.0" />
+    <option name="PROJECT_TFM" value="net6.0" />
     <browser url="http://localhost:5000" />
     <method v="2">
       <option name="Build" />
diff --git a/.idea/.idea.osu.Desktop/.idea/runConfigurations/TaikoRuleset__Tests_.xml b/.idea/.idea.osu.Desktop/.idea/runConfigurations/TaikoRuleset__Tests_.xml
index ab4ce5a9cc..f58f9d4ae2 100644
--- a/.idea/.idea.osu.Desktop/.idea/runConfigurations/TaikoRuleset__Tests_.xml
+++ b/.idea/.idea.osu.Desktop/.idea/runConfigurations/TaikoRuleset__Tests_.xml
@@ -1,8 +1,8 @@
 <component name="ProjectRunConfigurationManager">
   <configuration default="false" name="TaikoRuleset (Tests)" type="DotNetProject" factoryName=".NET Project" folderName="Ruleset" activateToolWindowBeforeRun="false">
-    <option name="EXE_PATH" value="$PROJECT_DIR$/osu.Game.Rulesets.Taiko.Tests/bin/Debug/net5.0/osu.Game.Rulesets.Taiko.Tests.dll" />
+    <option name="EXE_PATH" value="$PROJECT_DIR$/osu.Game.Rulesets.Taiko.Tests/bin/Debug/net6.0/osu.Game.Rulesets.Taiko.Tests.dll" />
     <option name="PROGRAM_PARAMETERS" value="" />
-    <option name="WORKING_DIRECTORY" value="$PROJECT_DIR$/osu.Game.Rulesets.Taiko.Tests/bin/Debug/net5.0" />
+    <option name="WORKING_DIRECTORY" value="$PROJECT_DIR$/osu.Game.Rulesets.Taiko.Tests/bin/Debug/net6.0" />
     <option name="PASS_PARENT_ENVS" value="1" />
     <option name="USE_EXTERNAL_CONSOLE" value="0" />
     <option name="USE_MONO" value="0" />
@@ -12,7 +12,7 @@
     <option name="PROJECT_ARGUMENTS_TRACKING" value="1" />
     <option name="PROJECT_WORKING_DIRECTORY_TRACKING" value="1" />
     <option name="PROJECT_KIND" value="DotNetCore" />
-    <option name="PROJECT_TFM" value="net5.0" />
+    <option name="PROJECT_TFM" value="net6.0" />
     <browser url="http://localhost:5000" />
     <method v="2">
       <option name="Build" />
diff --git a/.idea/.idea.osu.Desktop/.idea/runConfigurations/Tournament.xml b/.idea/.idea.osu.Desktop/.idea/runConfigurations/Tournament.xml
index 61331944a8..0f2c390328 100644
--- a/.idea/.idea.osu.Desktop/.idea/runConfigurations/Tournament.xml
+++ b/.idea/.idea.osu.Desktop/.idea/runConfigurations/Tournament.xml
@@ -1,8 +1,8 @@
 <component name="ProjectRunConfigurationManager">
   <configuration default="false" name="Tournament" type="DotNetProject" factoryName=".NET Project" folderName="Tournament" activateToolWindowBeforeRun="false">
-    <option name="EXE_PATH" value="$PROJECT_DIR$/osu.Desktop/bin/Debug/net5.0/osu!.dll" />
+    <option name="EXE_PATH" value="$PROJECT_DIR$/osu.Desktop/bin/Debug/net6.0/osu!.dll" />
     <option name="PROGRAM_PARAMETERS" value="--tournament" />
-    <option name="WORKING_DIRECTORY" value="$PROJECT_DIR$/osu.Desktop/bin/Debug/net5.0" />
+    <option name="WORKING_DIRECTORY" value="$PROJECT_DIR$/osu.Desktop/bin/Debug/net6.0" />
     <option name="PASS_PARENT_ENVS" value="1" />
     <option name="USE_EXTERNAL_CONSOLE" value="0" />
     <option name="USE_MONO" value="0" />
@@ -12,7 +12,7 @@
     <option name="PROJECT_ARGUMENTS_TRACKING" value="1" />
     <option name="PROJECT_WORKING_DIRECTORY_TRACKING" value="1" />
     <option name="PROJECT_KIND" value="DotNetCore" />
-    <option name="PROJECT_TFM" value="net5.0" />
+    <option name="PROJECT_TFM" value="net6.0" />
     <method v="2">
       <option name="Build" />
     </method>
diff --git a/.idea/.idea.osu.Desktop/.idea/runConfigurations/Tournament__Tests_.xml b/.idea/.idea.osu.Desktop/.idea/runConfigurations/Tournament__Tests_.xml
index 9a00f58c3b..898aec880c 100644
--- a/.idea/.idea.osu.Desktop/.idea/runConfigurations/Tournament__Tests_.xml
+++ b/.idea/.idea.osu.Desktop/.idea/runConfigurations/Tournament__Tests_.xml
@@ -1,8 +1,8 @@
 <component name="ProjectRunConfigurationManager">
   <configuration default="false" name="Tournament (Tests)" type="DotNetProject" factoryName=".NET Project" folderName="Tournament" activateToolWindowBeforeRun="false">
-    <option name="EXE_PATH" value="$PROJECT_DIR$/osu.Game.Tournament.Tests/bin/Debug/net5.0/osu.Game.Tournament.Tests.dll" />
+    <option name="EXE_PATH" value="$PROJECT_DIR$/osu.Game.Tournament.Tests/bin/Debug/net6.0/osu.Game.Tournament.Tests.dll" />
     <option name="PROGRAM_PARAMETERS" value="" />
-    <option name="WORKING_DIRECTORY" value="$PROJECT_DIR$/osu.Game.Tournament.Tests/bin/Debug/net5.0" />
+    <option name="WORKING_DIRECTORY" value="$PROJECT_DIR$/osu.Game.Tournament.Tests/bin/Debug/net6.0" />
     <option name="PASS_PARENT_ENVS" value="1" />
     <option name="USE_EXTERNAL_CONSOLE" value="0" />
     <option name="USE_MONO" value="0" />
@@ -12,7 +12,7 @@
     <option name="PROJECT_ARGUMENTS_TRACKING" value="1" />
     <option name="PROJECT_WORKING_DIRECTORY_TRACKING" value="1" />
     <option name="PROJECT_KIND" value="DotNetCore" />
-    <option name="PROJECT_TFM" value="net5.0" />
+    <option name="PROJECT_TFM" value="net6.0" />
     <browser url="http://localhost:5000" />
     <method v="2">
       <option name="Build" />
diff --git a/.idea/.idea.osu.Desktop/.idea/runConfigurations/osu_.xml b/.idea/.idea.osu.Desktop/.idea/runConfigurations/osu_.xml
index 4ae656b6d8..dae6e032b1 100644
--- a/.idea/.idea.osu.Desktop/.idea/runConfigurations/osu_.xml
+++ b/.idea/.idea.osu.Desktop/.idea/runConfigurations/osu_.xml
@@ -1,8 +1,8 @@
 <component name="ProjectRunConfigurationManager">
   <configuration default="false" name="osu!" type="DotNetProject" factoryName=".NET Project" folderName="osu!" activateToolWindowBeforeRun="false">
-    <option name="EXE_PATH" value="$PROJECT_DIR$/osu.Desktop/bin/Debug/net5.0/osu!.dll" />
+    <option name="EXE_PATH" value="$PROJECT_DIR$/osu.Desktop/bin/Debug/net6.0/osu!.dll" />
     <option name="PROGRAM_PARAMETERS" value="" />
-    <option name="WORKING_DIRECTORY" value="$PROJECT_DIR$/osu.Desktop/bin/Debug/net5.0" />
+    <option name="WORKING_DIRECTORY" value="$PROJECT_DIR$/osu.Desktop/bin/Debug/net6.0" />
     <option name="PASS_PARENT_ENVS" value="1" />
     <option name="USE_EXTERNAL_CONSOLE" value="0" />
     <option name="USE_MONO" value="0" />
@@ -12,7 +12,7 @@
     <option name="PROJECT_ARGUMENTS_TRACKING" value="1" />
     <option name="PROJECT_WORKING_DIRECTORY_TRACKING" value="1" />
     <option name="PROJECT_KIND" value="DotNetCore" />
-    <option name="PROJECT_TFM" value="net5.0" />
+    <option name="PROJECT_TFM" value="net6.0" />
     <method v="2">
       <option name="Build" />
     </method>
diff --git a/.idea/.idea.osu.Desktop/.idea/runConfigurations/osu___Tests_.xml b/.idea/.idea.osu.Desktop/.idea/runConfigurations/osu___Tests_.xml
index e58c602962..519107b5e3 100644
--- a/.idea/.idea.osu.Desktop/.idea/runConfigurations/osu___Tests_.xml
+++ b/.idea/.idea.osu.Desktop/.idea/runConfigurations/osu___Tests_.xml
@@ -1,8 +1,8 @@
 <component name="ProjectRunConfigurationManager">
   <configuration default="false" name="osu! (Tests)" type="DotNetProject" factoryName=".NET Project" folderName="osu!" activateToolWindowBeforeRun="false">
-    <option name="EXE_PATH" value="$PROJECT_DIR$/osu.Game.Tests/bin/Debug/net5.0/osu.Game.Tests.dll" />
+    <option name="EXE_PATH" value="$PROJECT_DIR$/osu.Game.Tests/bin/Debug/net6.0/osu.Game.Tests.dll" />
     <option name="PROGRAM_PARAMETERS" value="" />
-    <option name="WORKING_DIRECTORY" value="$PROJECT_DIR$/osu.Game.Tests/bin/Debug/net5.0" />
+    <option name="WORKING_DIRECTORY" value="$PROJECT_DIR$/osu.Game.Tests/bin/Debug/net6.0" />
     <option name="PASS_PARENT_ENVS" value="1" />
     <option name="USE_EXTERNAL_CONSOLE" value="0" />
     <option name="USE_MONO" value="0" />
@@ -12,7 +12,7 @@
     <option name="PROJECT_ARGUMENTS_TRACKING" value="1" />
     <option name="PROJECT_WORKING_DIRECTORY_TRACKING" value="1" />
     <option name="PROJECT_KIND" value="DotNetCore" />
-    <option name="PROJECT_TFM" value="net5.0" />
+    <option name="PROJECT_TFM" value="net6.0" />
     <method v="2">
       <option name="Build" />
     </method>

From 333c0cd4f9c717187cc8a15f6ba93207a02ffbbf Mon Sep 17 00:00:00 2001
From: Shivam <s.r.v.ramkisoen@umail.leidenuniv.nl>
Date: Fri, 25 Feb 2022 14:16:18 +0100
Subject: [PATCH 3081/5547] Add open folder button to open currently selected
 tournament

---
 osu.Game.Tournament/Screens/Setup/TournamentSwitcher.cs | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/osu.Game.Tournament/Screens/Setup/TournamentSwitcher.cs b/osu.Game.Tournament/Screens/Setup/TournamentSwitcher.cs
index 74c872646c..2134dbf9d3 100644
--- a/osu.Game.Tournament/Screens/Setup/TournamentSwitcher.cs
+++ b/osu.Game.Tournament/Screens/Setup/TournamentSwitcher.cs
@@ -11,6 +11,7 @@ namespace osu.Game.Tournament.Screens.Setup
     internal class TournamentSwitcher : ActionableInfo
     {
         private OsuDropdown<string> dropdown;
+        private OsuButton folderButton;
 
         [Resolved]
         private TournamentGameBase game { get; set; }
@@ -25,6 +26,7 @@ namespace osu.Game.Tournament.Screens.Setup
             dropdown.Current.BindValueChanged(v => Button.Enabled.Value = v.NewValue != startupTournament, true);
 
             Action = () => game.GracefullyExit();
+            folderButton.Action = storage.PresentExternally;
 
             ButtonText = "Close osu!";
         }
@@ -38,6 +40,12 @@ namespace osu.Game.Tournament.Screens.Setup
                 Width = 510
             });
 
+            FlowContainer.Insert(-2, folderButton = new TriangleButton
+            {
+                Text = "Open folder",
+                Width = 100
+            });
+
             return drawable;
         }
     }

From 4c564581739a13e1de73ef75054bd7c825dca384 Mon Sep 17 00:00:00 2001
From: Shivam <s.r.v.ramkisoen@umail.leidenuniv.nl>
Date: Fri, 25 Feb 2022 15:13:32 +0100
Subject: [PATCH 3082/5547] Change button location to the right side of
 dropdown

---
 .../Screens/Setup/TournamentSwitcher.cs              | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/osu.Game.Tournament/Screens/Setup/TournamentSwitcher.cs b/osu.Game.Tournament/Screens/Setup/TournamentSwitcher.cs
index 2134dbf9d3..93cfa9634e 100644
--- a/osu.Game.Tournament/Screens/Setup/TournamentSwitcher.cs
+++ b/osu.Game.Tournament/Screens/Setup/TournamentSwitcher.cs
@@ -35,17 +35,17 @@ namespace osu.Game.Tournament.Screens.Setup
         {
             var drawable = base.CreateComponent();
 
-            FlowContainer.Insert(-1, dropdown = new OsuDropdown<string>
-            {
-                Width = 510
-            });
-
-            FlowContainer.Insert(-2, folderButton = new TriangleButton
+            FlowContainer.Insert(-1, folderButton = new TriangleButton
             {
                 Text = "Open folder",
                 Width = 100
             });
 
+            FlowContainer.Insert(-2, dropdown = new OsuDropdown<string>
+            {
+                Width = 510
+            });
+
             return drawable;
         }
     }

From 297e5ec62eba47257363514b825fec92f3474656 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 27 Feb 2022 23:16:04 +0900
Subject: [PATCH 3083/5547] Remove unused constants

---
 osu.Game.Tournament/Components/TournamentBeatmapPanel.cs | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/osu.Game.Tournament/Components/TournamentBeatmapPanel.cs b/osu.Game.Tournament/Components/TournamentBeatmapPanel.cs
index 4189f3ccb5..b064d3dd79 100644
--- a/osu.Game.Tournament/Components/TournamentBeatmapPanel.cs
+++ b/osu.Game.Tournament/Components/TournamentBeatmapPanel.cs
@@ -24,9 +24,6 @@ namespace osu.Game.Tournament.Components
 
         private readonly string mod;
 
-        private const float horizontal_padding = 10;
-        private const float vertical_padding = 10;
-
         public const float HEIGHT = 50;
 
         private readonly Bindable<TournamentMatch> currentMatch = new Bindable<TournamentMatch>();

From df4170b9396695b02c1efb02e0c0c6bf9096073d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 27 Feb 2022 23:17:04 +0900
Subject: [PATCH 3084/5547] Display star ratings in tournament mode using two
 decimal places

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

diff --git a/osu.Game.Tournament/Components/SongBar.cs b/osu.Game.Tournament/Components/SongBar.cs
index a7f0d58145..a45582a7c0 100644
--- a/osu.Game.Tournament/Components/SongBar.cs
+++ b/osu.Game.Tournament/Components/SongBar.cs
@@ -186,7 +186,7 @@ namespace osu.Game.Tournament.Components
                                         Children = new Drawable[]
                                         {
                                             new DiffPiece(stats),
-                                            new DiffPiece(("Star Rating", $"{beatmap.StarRating:0.#}{srExtra}"))
+                                            new DiffPiece(("Star Rating", $"{beatmap.StarRating:0.##}{srExtra}"))
                                         }
                                     },
                                     new FillFlowContainer

From 746f28c8487d05b697db217f0a66849c16132396 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 27 Feb 2022 15:31:34 +0100
Subject: [PATCH 3085/5547] Add test scene for song bar component

---
 .../Components/TestSceneSongBar.cs            | 45 +++++++++++++++++++
 1 file changed, 45 insertions(+)
 create mode 100644 osu.Game.Tournament.Tests/Components/TestSceneSongBar.cs

diff --git a/osu.Game.Tournament.Tests/Components/TestSceneSongBar.cs b/osu.Game.Tournament.Tests/Components/TestSceneSongBar.cs
new file mode 100644
index 0000000000..868946d80f
--- /dev/null
+++ b/osu.Game.Tournament.Tests/Components/TestSceneSongBar.cs
@@ -0,0 +1,45 @@
+// 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.Game.Beatmaps.Legacy;
+using osu.Game.Tests.Visual;
+using osu.Game.Tournament.Components;
+
+namespace osu.Game.Tournament.Tests.Components
+{
+    [TestFixture]
+    public class TestSceneSongBar : OsuTestScene
+    {
+        [Test]
+        public void TestSongBar()
+        {
+            SongBar songBar = null;
+
+            AddStep("create bar", () => Child = songBar = new SongBar
+            {
+                RelativeSizeAxes = Axes.X,
+                Anchor = Anchor.Centre,
+                Origin = Anchor.Centre
+            });
+            AddUntilStep("wait for loaded", () => songBar.IsLoaded);
+
+            AddStep("set beatmap", () =>
+            {
+                var beatmap = CreateAPIBeatmap(Ruleset.Value);
+                beatmap.CircleSize = 3.4f;
+                beatmap.ApproachRate = 6.8f;
+                beatmap.OverallDifficulty = 5.5f;
+                beatmap.StarRating = 4.56f;
+                beatmap.Length = 123456;
+                beatmap.BPM = 133;
+
+                songBar.Beatmap = beatmap;
+            });
+            AddStep("set mods to HR", () => songBar.Mods = LegacyMods.HardRock);
+            AddStep("set mods to DT", () => songBar.Mods = LegacyMods.DoubleTime);
+            AddStep("unset mods", () => songBar.Mods = LegacyMods.None);
+        }
+    }
+}

From 36137e06197c1b083873cadb3cfec7e64dd6d858 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 13 Feb 2022 14:37:37 +0100
Subject: [PATCH 3086/5547] Add simple carousel divisor type selector

---
 .../Compose/Components/BeatDivisorControl.cs  | 101 +++++++++++++++---
 .../Compose/Components/BeatDivisorType.cs     |  25 +++++
 2 files changed, 112 insertions(+), 14 deletions(-)
 create mode 100644 osu.Game/Screens/Edit/Compose/Components/BeatDivisorType.cs

diff --git a/osu.Game/Screens/Edit/Compose/Components/BeatDivisorControl.cs b/osu.Game/Screens/Edit/Compose/Components/BeatDivisorControl.cs
index de63b265d2..f1779c0d18 100644
--- a/osu.Game/Screens/Edit/Compose/Components/BeatDivisorControl.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/BeatDivisorControl.cs
@@ -2,7 +2,9 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
+using System.Diagnostics;
 using System.Linq;
+using Humanizer;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Extensions.Color4Extensions;
@@ -14,6 +16,7 @@ using osu.Framework.Graphics.Sprites;
 using osu.Framework.Graphics.UserInterface;
 using osu.Framework.Input.Events;
 using osu.Game.Graphics;
+using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.UserInterface;
 using osuTK;
 using osuTK.Graphics;
@@ -24,6 +27,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
     public class BeatDivisorControl : CompositeDrawable
     {
         private readonly BindableBeatDivisor beatDivisor = new BindableBeatDivisor();
+        private readonly Bindable<BeatDivisorType> divisorType = new Bindable<BeatDivisorType>();
 
         public BeatDivisorControl(BindableBeatDivisor beatDivisor)
         {
@@ -84,7 +88,6 @@ namespace osu.Game.Screens.Edit.Compose.Components
                                     new Container
                                     {
                                         RelativeSizeAxes = Axes.Both,
-                                        Padding = new MarginPadding { Horizontal = 5 },
                                         Child = new GridContainer
                                         {
                                             RelativeSizeAxes = Axes.Both,
@@ -92,13 +95,13 @@ namespace osu.Game.Screens.Edit.Compose.Components
                                             {
                                                 new Drawable[]
                                                 {
-                                                    new DivisorButton
+                                                    new ChevronButton
                                                     {
                                                         Icon = FontAwesome.Solid.ChevronLeft,
                                                         Action = beatDivisor.Previous
                                                     },
-                                                    new DivisorText(beatDivisor),
-                                                    new DivisorButton
+                                                    new DivisorText { BeatDivisor = { BindTarget = beatDivisor } },
+                                                    new ChevronButton
                                                     {
                                                         Icon = FontAwesome.Solid.ChevronRight,
                                                         Action = beatDivisor.Next
@@ -121,29 +124,80 @@ namespace osu.Game.Screens.Edit.Compose.Components
                             new TextFlowContainer(s => s.Font = s.Font.With(size: 14))
                             {
                                 Padding = new MarginPadding { Horizontal = 15 },
-                                Text = "beat snap divisor",
+                                Text = "beat snap",
                                 RelativeSizeAxes = Axes.X,
                                 TextAnchor = Anchor.TopCentre
                             },
-                        }
+                        },
+                        new Drawable[]
+                        {
+                            new Container
+                            {
+                                RelativeSizeAxes = Axes.Both,
+                                Children = new Drawable[]
+                                {
+                                    new Box
+                                    {
+                                        RelativeSizeAxes = Axes.Both,
+                                        Colour = colours.Gray4
+                                    },
+                                    new Container
+                                    {
+                                        RelativeSizeAxes = Axes.Both,
+                                        Child = new GridContainer
+                                        {
+                                            RelativeSizeAxes = Axes.Both,
+                                            Content = new[]
+                                            {
+                                                new Drawable[]
+                                                {
+                                                    new ChevronButton
+                                                    {
+                                                        Icon = FontAwesome.Solid.ChevronLeft,
+                                                        Action = () => cycleDivisorType(-1)
+                                                    },
+                                                    new DivisorTypeText { BeatDivisorType = { BindTarget = divisorType } },
+                                                    new ChevronButton
+                                                    {
+                                                        Icon = FontAwesome.Solid.ChevronRight,
+                                                        Action = () => cycleDivisorType(1)
+                                                    }
+                                                },
+                                            },
+                                            ColumnDimensions = new[]
+                                            {
+                                                new Dimension(GridSizeMode.Absolute, 20),
+                                                new Dimension(),
+                                                new Dimension(GridSizeMode.Absolute, 20)
+                                            }
+                                        }
+                                    }
+                                }
+                            }
+                        },
                     },
                     RowDimensions = new[]
                     {
                         new Dimension(GridSizeMode.Absolute, 30),
-                        new Dimension(GridSizeMode.Absolute, 25),
+                        new Dimension(GridSizeMode.Absolute, 20),
+                        new Dimension(GridSizeMode.Absolute, 15)
                     }
                 }
             };
         }
 
+        private void cycleDivisorType(int direction)
+        {
+            Debug.Assert(Math.Abs(direction) == 1);
+            divisorType.Value = (BeatDivisorType)(((int)divisorType.Value + direction) % (int)(BeatDivisorType.Last + 1));
+        }
+
         private class DivisorText : SpriteText
         {
-            private readonly Bindable<int> beatDivisor = new Bindable<int>();
+            public Bindable<int> BeatDivisor { get; } = new Bindable<int>();
 
-            public DivisorText(BindableBeatDivisor beatDivisor)
+            public DivisorText()
             {
-                this.beatDivisor.BindTo(beatDivisor);
-
                 Anchor = Anchor.Centre;
                 Origin = Anchor.Centre;
             }
@@ -157,13 +211,32 @@ namespace osu.Game.Screens.Edit.Compose.Components
             protected override void LoadComplete()
             {
                 base.LoadComplete();
-                beatDivisor.BindValueChanged(val => Text = $"1/{val.NewValue}", true);
+                BeatDivisor.BindValueChanged(val => Text = $"1/{val.NewValue}", true);
             }
         }
 
-        private class DivisorButton : IconButton
+        private class DivisorTypeText : OsuSpriteText
         {
-            public DivisorButton()
+            public Bindable<BeatDivisorType> BeatDivisorType { get; } = new Bindable<BeatDivisorType>();
+
+            public DivisorTypeText()
+            {
+                Anchor = Anchor.Centre;
+                Origin = Anchor.Centre;
+
+                Font = OsuFont.Default.With(size: 14);
+            }
+
+            protected override void LoadComplete()
+            {
+                base.LoadComplete();
+                BeatDivisorType.BindValueChanged(val => Text = val.NewValue.Humanize(LetterCasing.LowerCase), true);
+            }
+        }
+
+        private class ChevronButton : IconButton
+        {
+            public ChevronButton()
             {
                 Anchor = Anchor.Centre;
                 Origin = Anchor.Centre;
diff --git a/osu.Game/Screens/Edit/Compose/Components/BeatDivisorType.cs b/osu.Game/Screens/Edit/Compose/Components/BeatDivisorType.cs
new file mode 100644
index 0000000000..2a7774118e
--- /dev/null
+++ b/osu.Game/Screens/Edit/Compose/Components/BeatDivisorType.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.
+
+namespace osu.Game.Screens.Edit.Compose.Components
+{
+    public enum BeatDivisorType
+    {
+        /// <summary>
+        /// Most common divisors, all with denominators being powers of two.
+        /// </summary>
+        Common,
+
+        /// <summary>
+        /// Divisors with denominators divisible by 3.
+        /// </summary>
+        Triplets,
+
+        /// <summary>
+        /// Fully arbitrary/custom beat divisors.
+        /// </summary>
+        Custom,
+
+        Last = Custom
+    }
+}

From d0c01afc2e7610e7797b929be4acc97510e45043 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 13 Feb 2022 15:50:40 +0100
Subject: [PATCH 3087/5547] Add flow for changing set of valid divisors between
 presets

---
 .../Editing/TestSceneBeatDivisorControl.cs    |  7 +-
 .../ControlPoints/ControlPointInfo.cs         |  2 +-
 osu.Game/Screens/Edit/BindableBeatDivisor.cs  | 57 ++++++++++------
 .../Compose/Components/BeatDivisorControl.cs  | 66 ++++++++++++-------
 .../Components/BeatDivisorPresetCollection.cs | 41 ++++++++++++
 .../Compose/Components/BeatDivisorType.cs     |  1 +
 .../Timeline/TimelineTickDisplay.cs           |  2 +-
 7 files changed, 127 insertions(+), 49 deletions(-)
 create mode 100644 osu.Game/Screens/Edit/Compose/Components/BeatDivisorPresetCollection.cs

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneBeatDivisorControl.cs b/osu.Game.Tests/Visual/Editing/TestSceneBeatDivisorControl.cs
index ed7bb9e301..131bfde86e 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneBeatDivisorControl.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneBeatDivisorControl.cs
@@ -20,8 +20,8 @@ namespace osu.Game.Tests.Visual.Editing
         private BeatDivisorControl beatDivisorControl;
         private BindableBeatDivisor bindableBeatDivisor;
 
-        private SliderBar<int> tickSliderBar;
-        private EquilateralTriangle tickMarkerHead;
+        private SliderBar<int> tickSliderBar => beatDivisorControl.ChildrenOfType<SliderBar<int>>().Single();
+        private EquilateralTriangle tickMarkerHead => tickSliderBar.ChildrenOfType<EquilateralTriangle>().Single();
 
         [SetUp]
         public void SetUp() => Schedule(() =>
@@ -32,9 +32,6 @@ namespace osu.Game.Tests.Visual.Editing
                 Origin = Anchor.Centre,
                 Size = new Vector2(90, 90)
             };
-
-            tickSliderBar = beatDivisorControl.ChildrenOfType<SliderBar<int>>().Single();
-            tickMarkerHead = tickSliderBar.ChildrenOfType<EquilateralTriangle>().Single();
         });
 
         [Test]
diff --git a/osu.Game/Beatmaps/ControlPoints/ControlPointInfo.cs b/osu.Game/Beatmaps/ControlPoints/ControlPointInfo.cs
index 246d1f8af5..af03d639be 100644
--- a/osu.Game/Beatmaps/ControlPoints/ControlPointInfo.cs
+++ b/osu.Game/Beatmaps/ControlPoints/ControlPointInfo.cs
@@ -164,7 +164,7 @@ namespace osu.Game.Beatmaps.ControlPoints
             int closestDivisor = 0;
             double closestTime = double.MaxValue;
 
-            foreach (int divisor in BindableBeatDivisor.VALID_DIVISORS)
+            foreach (int divisor in BindableBeatDivisor.PREDEFINED_DIVISORS)
             {
                 double distanceFromSnap = Math.Abs(time - getClosestSnappedTime(timingPoint, time, divisor));
 
diff --git a/osu.Game/Screens/Edit/BindableBeatDivisor.cs b/osu.Game/Screens/Edit/BindableBeatDivisor.cs
index 1a350d7261..9077898ec8 100644
--- a/osu.Game/Screens/Edit/BindableBeatDivisor.cs
+++ b/osu.Game/Screens/Edit/BindableBeatDivisor.cs
@@ -1,46 +1,63 @@
 // 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.Bindables;
 using osu.Game.Graphics;
+using osu.Game.Screens.Edit.Compose.Components;
 using osuTK.Graphics;
 
 namespace osu.Game.Screens.Edit
 {
     public class BindableBeatDivisor : BindableInt
     {
-        public static readonly int[] VALID_DIVISORS = { 1, 2, 3, 4, 6, 8, 12, 16 };
+        public static readonly int[] PREDEFINED_DIVISORS = { 1, 2, 3, 4, 6, 8, 12, 16 };
+
+        public Bindable<BeatDivisorPresetCollection> ValidDivisors { get; } = new Bindable<BeatDivisorPresetCollection>(BeatDivisorPresetCollection.COMMON);
 
         public BindableBeatDivisor(int value = 1)
             : base(value)
         {
+            ValidDivisors.BindValueChanged(_ => updateBindableProperties(), true);
+            BindValueChanged(_ => ensureValidDivisor());
         }
 
-        public void Next() => Value = VALID_DIVISORS[Math.Min(VALID_DIVISORS.Length - 1, Array.IndexOf(VALID_DIVISORS, Value) + 1)];
-
-        public void Previous() => Value = VALID_DIVISORS[Math.Max(0, Array.IndexOf(VALID_DIVISORS, Value) - 1)];
-
-        public override int Value
+        private void updateBindableProperties()
         {
-            get => base.Value;
-            set
-            {
-                if (!VALID_DIVISORS.Contains(value))
-                {
-                    // If it doesn't match, value will be 0, but will be clamped to the valid range via DefaultMinValue
-                    value = Array.FindLast(VALID_DIVISORS, d => d < value);
-                }
+            ensureValidDivisor();
 
-                base.Value = value;
-            }
+            MinValue = ValidDivisors.Value.Presets.Min();
+            MaxValue = ValidDivisors.Value.Presets.Max();
+        }
+
+        private void ensureValidDivisor()
+        {
+            if (!ValidDivisors.Value.Presets.Contains(Value))
+                Value = 1;
+        }
+
+        public void Next()
+        {
+            var presets = ValidDivisors.Value.Presets;
+            Value = presets.Cast<int?>().SkipWhile(preset => preset != Value).ElementAtOrDefault(1) ?? presets[0];
+        }
+
+        public void Previous()
+        {
+            var presets = ValidDivisors.Value.Presets;
+            Value = presets.Cast<int?>().TakeWhile(preset => preset != Value).LastOrDefault() ?? presets[^1];
         }
 
-        protected override int DefaultMinValue => VALID_DIVISORS.First();
-        protected override int DefaultMaxValue => VALID_DIVISORS.Last();
         protected override int DefaultPrecision => 1;
 
+        public override void BindTo(Bindable<int> them)
+        {
+            base.BindTo(them);
+
+            if (them is BindableBeatDivisor otherBeatDivisor)
+                ValidDivisors.BindTo(otherBeatDivisor.ValidDivisors);
+        }
+
         protected override Bindable<int> CreateInstance() => new BindableBeatDivisor();
 
         /// <summary>
@@ -92,7 +109,7 @@ namespace osu.Game.Screens.Edit
         {
             int beat = index % beatDivisor;
 
-            foreach (int divisor in BindableBeatDivisor.VALID_DIVISORS)
+            foreach (int divisor in PREDEFINED_DIVISORS)
             {
                 if ((beat * divisor) % beatDivisor == 0)
                     return divisor;
diff --git a/osu.Game/Screens/Edit/Compose/Components/BeatDivisorControl.cs b/osu.Game/Screens/Edit/Compose/Components/BeatDivisorControl.cs
index f1779c0d18..a9b1213738 100644
--- a/osu.Game/Screens/Edit/Compose/Components/BeatDivisorControl.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/BeatDivisorControl.cs
@@ -27,7 +27,6 @@ namespace osu.Game.Screens.Edit.Compose.Components
     public class BeatDivisorControl : CompositeDrawable
     {
         private readonly BindableBeatDivisor beatDivisor = new BindableBeatDivisor();
-        private readonly Bindable<BeatDivisorType> divisorType = new Bindable<BeatDivisorType>();
 
         public BeatDivisorControl(BindableBeatDivisor beatDivisor)
         {
@@ -66,7 +65,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
                                         RelativeSizeAxes = Axes.Both,
                                         Colour = Color4.Black
                                     },
-                                    new TickSliderBar(beatDivisor, BindableBeatDivisor.VALID_DIVISORS)
+                                    new TickSliderBar(beatDivisor)
                                     {
                                         RelativeSizeAxes = Axes.Both,
                                     }
@@ -156,7 +155,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
                                                         Icon = FontAwesome.Solid.ChevronLeft,
                                                         Action = () => cycleDivisorType(-1)
                                                     },
-                                                    new DivisorTypeText { BeatDivisorType = { BindTarget = divisorType } },
+                                                    new DivisorTypeText { BeatDivisor = { BindTarget = beatDivisor } },
                                                     new ChevronButton
                                                     {
                                                         Icon = FontAwesome.Solid.ChevronRight,
@@ -189,7 +188,26 @@ namespace osu.Game.Screens.Edit.Compose.Components
         private void cycleDivisorType(int direction)
         {
             Debug.Assert(Math.Abs(direction) == 1);
-            divisorType.Value = (BeatDivisorType)(((int)divisorType.Value + direction) % (int)(BeatDivisorType.Last + 1));
+            int nextDivisorType = (int)beatDivisor.ValidDivisors.Value.Type + direction;
+            if (nextDivisorType > (int)BeatDivisorType.Last)
+                nextDivisorType = (int)BeatDivisorType.First;
+            else if (nextDivisorType < (int)BeatDivisorType.First)
+                nextDivisorType = (int)BeatDivisorType.Last;
+
+            switch ((BeatDivisorType)nextDivisorType)
+            {
+                case BeatDivisorType.Common:
+                    beatDivisor.ValidDivisors.Value = BeatDivisorPresetCollection.COMMON;
+                    break;
+
+                case BeatDivisorType.Triplets:
+                    beatDivisor.ValidDivisors.Value = BeatDivisorPresetCollection.TRIPLETS;
+                    break;
+
+                case BeatDivisorType.Custom:
+                    beatDivisor.ValidDivisors.Value = BeatDivisorPresetCollection.Custom(18); // todo
+                    break;
+            }
         }
 
         private class DivisorText : SpriteText
@@ -217,7 +235,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
 
         private class DivisorTypeText : OsuSpriteText
         {
-            public Bindable<BeatDivisorType> BeatDivisorType { get; } = new Bindable<BeatDivisorType>();
+            public BindableBeatDivisor BeatDivisor { get; } = new BindableBeatDivisor();
 
             public DivisorTypeText()
             {
@@ -230,7 +248,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
             protected override void LoadComplete()
             {
                 base.LoadComplete();
-                BeatDivisorType.BindValueChanged(val => Text = val.NewValue.Humanize(LetterCasing.LowerCase), true);
+                BeatDivisor.ValidDivisors.BindValueChanged(val => Text = val.NewValue.Type.Humanize(LetterCasing.LowerCase), true);
             }
         }
 
@@ -265,20 +283,27 @@ namespace osu.Game.Screens.Edit.Compose.Components
             private OsuColour colours { get; set; }
 
             private readonly BindableBeatDivisor beatDivisor;
-            private readonly int[] availableDivisors;
 
-            public TickSliderBar(BindableBeatDivisor beatDivisor, params int[] divisors)
+            public TickSliderBar(BindableBeatDivisor beatDivisor)
             {
                 CurrentNumber.BindTo(this.beatDivisor = beatDivisor);
-                availableDivisors = divisors;
 
                 Padding = new MarginPadding { Horizontal = 5 };
             }
 
-            [BackgroundDependencyLoader]
-            private void load()
+            protected override void LoadComplete()
             {
-                foreach (int t in availableDivisors)
+                base.LoadComplete();
+
+                beatDivisor.ValidDivisors.BindValueChanged(_ => updateDivisors(), true);
+            }
+
+            private void updateDivisors()
+            {
+                ClearInternal();
+                CurrentNumber.ValueChanged -= moveMarker;
+
+                foreach (int t in beatDivisor.ValidDivisors.Value.Presets)
                 {
                     AddInternal(new Tick
                     {
@@ -291,17 +316,14 @@ namespace osu.Game.Screens.Edit.Compose.Components
                 }
 
                 AddInternal(marker = new Marker());
+                CurrentNumber.ValueChanged += moveMarker;
+                CurrentNumber.TriggerChange();
             }
 
-            protected override void LoadComplete()
+            private void moveMarker(ValueChangedEvent<int> divisor)
             {
-                base.LoadComplete();
-
-                CurrentNumber.BindValueChanged(div =>
-                {
-                    marker.MoveToX(getMappedPosition(div.NewValue), 100, Easing.OutQuint);
-                    marker.Flash();
-                }, true);
+                marker.MoveToX(getMappedPosition(divisor.NewValue), 100, Easing.OutQuint);
+                marker.Flash();
             }
 
             protected override void UpdateValue(float value)
@@ -362,11 +384,11 @@ namespace osu.Game.Screens.Edit.Compose.Components
                 // copied from SliderBar so we can do custom spacing logic.
                 float xPosition = (ToLocalSpace(screenSpaceMousePosition).X - RangePadding) / UsableWidth;
 
-                CurrentNumber.Value = availableDivisors.OrderBy(d => Math.Abs(getMappedPosition(d) - xPosition)).First();
+                CurrentNumber.Value = beatDivisor.ValidDivisors.Value.Presets.OrderBy(d => Math.Abs(getMappedPosition(d) - xPosition)).First();
                 OnUserChange(Current.Value);
             }
 
-            private float getMappedPosition(float divisor) => MathF.Pow((divisor - 1) / (availableDivisors.Last() - 1), 0.90f);
+            private float getMappedPosition(float divisor) => MathF.Pow((divisor - 1) / (beatDivisor.ValidDivisors.Value.Presets.Last() - 1), 0.90f);
 
             private class Tick : CompositeDrawable
             {
diff --git a/osu.Game/Screens/Edit/Compose/Components/BeatDivisorPresetCollection.cs b/osu.Game/Screens/Edit/Compose/Components/BeatDivisorPresetCollection.cs
new file mode 100644
index 0000000000..4616669c6d
--- /dev/null
+++ b/osu.Game/Screens/Edit/Compose/Components/BeatDivisorPresetCollection.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 System;
+using System.Collections.Generic;
+using System.Linq;
+
+namespace osu.Game.Screens.Edit.Compose.Components
+{
+    public class BeatDivisorPresetCollection
+    {
+        public BeatDivisorType Type { get; }
+        public IReadOnlyList<int> Presets { get; }
+
+        private BeatDivisorPresetCollection(BeatDivisorType type, IEnumerable<int> presets)
+        {
+            Type = type;
+            Presets = presets.ToArray();
+        }
+
+        public static readonly BeatDivisorPresetCollection COMMON = new BeatDivisorPresetCollection(BeatDivisorType.Common, new[] { 1, 2, 4, 8, 16 });
+
+        public static readonly BeatDivisorPresetCollection TRIPLETS = new BeatDivisorPresetCollection(BeatDivisorType.Triplets, new[] { 1, 3, 6, 12 });
+
+        public static BeatDivisorPresetCollection Custom(int maxDivisor)
+        {
+            var presets = new List<int>();
+
+            for (int candidate = 1; candidate <= Math.Sqrt(maxDivisor); ++candidate)
+            {
+                if (maxDivisor % candidate != 0)
+                    continue;
+
+                presets.Add(candidate);
+                presets.Add(maxDivisor / candidate);
+            }
+
+            return new BeatDivisorPresetCollection(BeatDivisorType.Custom, presets.Distinct().OrderBy(d => d));
+        }
+    }
+}
diff --git a/osu.Game/Screens/Edit/Compose/Components/BeatDivisorType.cs b/osu.Game/Screens/Edit/Compose/Components/BeatDivisorType.cs
index 2a7774118e..15a8c504c5 100644
--- a/osu.Game/Screens/Edit/Compose/Components/BeatDivisorType.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/BeatDivisorType.cs
@@ -20,6 +20,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
         /// </summary>
         Custom,
 
+        First = Common,
         Last = Custom
     }
 }
diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineTickDisplay.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineTickDisplay.cs
index cc4041394d..3a32dc18e5 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineTickDisplay.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineTickDisplay.cs
@@ -31,7 +31,7 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
         [Resolved]
         private OsuColour colours { get; set; }
 
-        private static readonly int highest_divisor = BindableBeatDivisor.VALID_DIVISORS.Last();
+        private static readonly int highest_divisor = BindableBeatDivisor.PREDEFINED_DIVISORS.Last();
 
         public TimelineTickDisplay()
         {

From 423838a649fe8400829a2cbee6de186135799936 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 13 Feb 2022 16:27:12 +0100
Subject: [PATCH 3088/5547] Add flow for specifying entirely custom snaps

---
 .../Editing/TestSceneBeatDivisorControl.cs    |  13 +-
 osu.Game/Screens/Edit/BindableBeatDivisor.cs  |   5 +-
 .../Compose/Components/BeatDivisorControl.cs  | 117 ++++++++++++++++--
 .../Compose/Components/BeatDivisorType.cs     |   3 -
 4 files changed, 118 insertions(+), 20 deletions(-)

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneBeatDivisorControl.cs b/osu.Game.Tests/Visual/Editing/TestSceneBeatDivisorControl.cs
index 131bfde86e..e37019e5d3 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneBeatDivisorControl.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneBeatDivisorControl.cs
@@ -5,6 +5,7 @@ using System;
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Graphics;
+using osu.Framework.Graphics.Cursor;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Graphics.UserInterface;
 using osu.Framework.Testing;
@@ -26,11 +27,15 @@ namespace osu.Game.Tests.Visual.Editing
         [SetUp]
         public void SetUp() => Schedule(() =>
         {
-            Child = beatDivisorControl = new BeatDivisorControl(bindableBeatDivisor = new BindableBeatDivisor(16))
+            Child = new PopoverContainer
             {
-                Anchor = Anchor.Centre,
-                Origin = Anchor.Centre,
-                Size = new Vector2(90, 90)
+                RelativeSizeAxes = Axes.Both,
+                Child = beatDivisorControl = new BeatDivisorControl(bindableBeatDivisor = new BindableBeatDivisor(16))
+                {
+                    Anchor = Anchor.Centre,
+                    Origin = Anchor.Centre,
+                    Size = new Vector2(90, 90)
+                }
             };
         });
 
diff --git a/osu.Game/Screens/Edit/BindableBeatDivisor.cs b/osu.Game/Screens/Edit/BindableBeatDivisor.cs
index 9077898ec8..af958e3448 100644
--- a/osu.Game/Screens/Edit/BindableBeatDivisor.cs
+++ b/osu.Game/Screens/Edit/BindableBeatDivisor.cs
@@ -52,10 +52,11 @@ namespace osu.Game.Screens.Edit
 
         public override void BindTo(Bindable<int> them)
         {
-            base.BindTo(them);
-
+            // bind to valid divisors first (if applicable) to ensure correct transfer of the actual divisor.
             if (them is BindableBeatDivisor otherBeatDivisor)
                 ValidDivisors.BindTo(otherBeatDivisor.ValidDivisors);
+
+            base.BindTo(them);
         }
 
         protected override Bindable<int> CreateInstance() => new BindableBeatDivisor();
diff --git a/osu.Game/Screens/Edit/Compose/Components/BeatDivisorControl.cs b/osu.Game/Screens/Edit/Compose/Components/BeatDivisorControl.cs
index a9b1213738..04e9ac842c 100644
--- a/osu.Game/Screens/Edit/Compose/Components/BeatDivisorControl.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/BeatDivisorControl.cs
@@ -7,17 +7,21 @@ using System.Linq;
 using Humanizer;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
+using osu.Framework.Extensions;
 using osu.Framework.Extensions.Color4Extensions;
 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.Graphics.Sprites;
 using osu.Framework.Graphics.UserInterface;
 using osu.Framework.Input.Events;
 using osu.Game.Graphics;
+using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.UserInterface;
+using osu.Game.Graphics.UserInterfaceV2;
 using osuTK;
 using osuTK.Graphics;
 using osuTK.Input;
@@ -99,7 +103,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
                                                         Icon = FontAwesome.Solid.ChevronLeft,
                                                         Action = beatDivisor.Previous
                                                     },
-                                                    new DivisorText { BeatDivisor = { BindTarget = beatDivisor } },
+                                                    new DivisorDisplay { BeatDivisor = { BindTarget = beatDivisor } },
                                                     new ChevronButton
                                                     {
                                                         Icon = FontAwesome.Solid.ChevronRight,
@@ -189,10 +193,10 @@ namespace osu.Game.Screens.Edit.Compose.Components
         {
             Debug.Assert(Math.Abs(direction) == 1);
             int nextDivisorType = (int)beatDivisor.ValidDivisors.Value.Type + direction;
-            if (nextDivisorType > (int)BeatDivisorType.Last)
-                nextDivisorType = (int)BeatDivisorType.First;
-            else if (nextDivisorType < (int)BeatDivisorType.First)
-                nextDivisorType = (int)BeatDivisorType.Last;
+            if (nextDivisorType > (int)BeatDivisorType.Triplets)
+                nextDivisorType = (int)BeatDivisorType.Common;
+            else if (nextDivisorType < (int)BeatDivisorType.Common)
+                nextDivisorType = (int)BeatDivisorType.Triplets;
 
             switch ((BeatDivisorType)nextDivisorType)
             {
@@ -205,31 +209,122 @@ namespace osu.Game.Screens.Edit.Compose.Components
                     break;
 
                 case BeatDivisorType.Custom:
-                    beatDivisor.ValidDivisors.Value = BeatDivisorPresetCollection.Custom(18); // todo
+                    beatDivisor.ValidDivisors.Value = BeatDivisorPresetCollection.Custom(beatDivisor.ValidDivisors.Value.Presets.Max());
                     break;
             }
         }
 
-        private class DivisorText : SpriteText
+        private class DivisorDisplay : OsuAnimatedButton, IHasPopover
         {
-            public Bindable<int> BeatDivisor { get; } = new Bindable<int>();
+            public BindableBeatDivisor BeatDivisor { get; } = new BindableBeatDivisor();
 
-            public DivisorText()
+            private readonly OsuSpriteText divisorText;
+
+            public DivisorDisplay()
             {
                 Anchor = Anchor.Centre;
                 Origin = Anchor.Centre;
+
+                AutoSizeAxes = Axes.Both;
+
+                Add(divisorText = new OsuSpriteText
+                {
+                    Font = OsuFont.Default.With(size: 20),
+                    Anchor = Anchor.Centre,
+                    Origin = Anchor.Centre,
+                    Margin = new MarginPadding
+                    {
+                        Horizontal = 5
+                    }
+                });
+
+                Action = this.ShowPopover;
             }
 
             [BackgroundDependencyLoader]
             private void load(OsuColour colours)
             {
-                Colour = colours.BlueLighter;
+                divisorText.Colour = colours.BlueLighter;
             }
 
             protected override void LoadComplete()
             {
                 base.LoadComplete();
-                BeatDivisor.BindValueChanged(val => Text = $"1/{val.NewValue}", true);
+                updateState();
+            }
+
+            private void updateState()
+            {
+                BeatDivisor.BindValueChanged(val => divisorText.Text = $"1/{val.NewValue}", true);
+            }
+
+            public Popover GetPopover() => new CustomDivisorPopover
+            {
+                BeatDivisor = { BindTarget = BeatDivisor }
+            };
+        }
+
+        private class CustomDivisorPopover : OsuPopover
+        {
+            public BindableBeatDivisor BeatDivisor { get; } = new BindableBeatDivisor();
+
+            private readonly OsuNumberBox divisorTextBox;
+
+            public CustomDivisorPopover()
+            {
+                Child = new FillFlowContainer
+                {
+                    Width = 150,
+                    AutoSizeAxes = Axes.Y,
+                    Spacing = new Vector2(10),
+                    Children = new Drawable[]
+                    {
+                        divisorTextBox = new OsuNumberBox
+                        {
+                            RelativeSizeAxes = Axes.X,
+                            PlaceholderText = "Beat divisor"
+                        },
+                        new OsuTextFlowContainer
+                        {
+                            RelativeSizeAxes = Axes.X,
+                            AutoSizeAxes = Axes.Y,
+                            Text = "All other applicable smaller divisors will be automatically added to the list of presets."
+                        }
+                    }
+                };
+            }
+
+            protected override void LoadComplete()
+            {
+                base.LoadComplete();
+                BeatDivisor.BindValueChanged(_ => updateState(), true);
+                divisorTextBox.OnCommit += (_, __) => setPresets();
+            }
+
+            private void setPresets()
+            {
+                if (!int.TryParse(divisorTextBox.Text, out int divisor) || divisor < 1 || divisor > 64)
+                {
+                    updateState();
+                    return;
+                }
+
+                if (!BeatDivisor.ValidDivisors.Value.Presets.Contains(divisor))
+                {
+                    if (BeatDivisorPresetCollection.COMMON.Presets.Contains(divisor))
+                        BeatDivisor.ValidDivisors.Value = BeatDivisorPresetCollection.COMMON;
+                    else if (BeatDivisorPresetCollection.TRIPLETS.Presets.Contains(divisor))
+                        BeatDivisor.ValidDivisors.Value = BeatDivisorPresetCollection.TRIPLETS;
+                    else
+                        BeatDivisor.ValidDivisors.Value = BeatDivisorPresetCollection.Custom(divisor);
+                }
+
+                BeatDivisor.Value = divisor;
+            }
+
+            private void updateState()
+            {
+                divisorTextBox.Text = BeatDivisor.Value.ToString();
             }
         }
 
diff --git a/osu.Game/Screens/Edit/Compose/Components/BeatDivisorType.cs b/osu.Game/Screens/Edit/Compose/Components/BeatDivisorType.cs
index 15a8c504c5..4a25144881 100644
--- a/osu.Game/Screens/Edit/Compose/Components/BeatDivisorType.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/BeatDivisorType.cs
@@ -19,8 +19,5 @@ namespace osu.Game.Screens.Edit.Compose.Components
         /// Fully arbitrary/custom beat divisors.
         /// </summary>
         Custom,
-
-        First = Common,
-        Last = Custom
     }
 }

From 7de5dad4f0ae616c7b3803f3a4b1d2d260b33bf1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 27 Feb 2022 19:23:02 +0100
Subject: [PATCH 3089/5547] Add test coverage for divisor behaviour

---
 .../Editing/TestSceneBeatDivisorControl.cs    | 115 ++++++++++++++++++
 .../Compose/Components/BeatDivisorControl.cs  |   6 +-
 2 files changed, 118 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneBeatDivisorControl.cs b/osu.Game.Tests/Visual/Editing/TestSceneBeatDivisorControl.cs
index e37019e5d3..4503b1a5f6 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneBeatDivisorControl.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneBeatDivisorControl.cs
@@ -2,6 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
+using System.Diagnostics;
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Graphics;
@@ -81,5 +82,119 @@ namespace osu.Game.Tests.Visual.Editing
                 sliderDrawQuad.Centre.Y
             );
         }
+
+        [Test]
+        public void TestBeatChevronNavigation()
+        {
+            switchBeatSnap(1);
+            assertBeatSnap(1);
+
+            switchBeatSnap(3);
+            assertBeatSnap(8);
+
+            switchBeatSnap(-1);
+            assertBeatSnap(4);
+
+            switchBeatSnap(-3);
+            assertBeatSnap(16);
+        }
+
+        [Test]
+        public void TestBeatPresetNavigation()
+        {
+            assertPreset(BeatDivisorType.Common);
+
+            switchPresets(1);
+            assertPreset(BeatDivisorType.Triplets);
+
+            switchPresets(1);
+            assertPreset(BeatDivisorType.Common);
+
+            switchPresets(-1);
+            assertPreset(BeatDivisorType.Triplets);
+
+            switchPresets(-1);
+            assertPreset(BeatDivisorType.Common);
+
+            setDivisorViaInput(3);
+            assertPreset(BeatDivisorType.Triplets);
+
+            setDivisorViaInput(8);
+            assertPreset(BeatDivisorType.Common);
+
+            setDivisorViaInput(15);
+            assertPreset(BeatDivisorType.Custom, 15);
+
+            switchBeatSnap(-1);
+            assertBeatSnap(5);
+
+            switchBeatSnap(-1);
+            assertBeatSnap(3);
+
+            setDivisorViaInput(5);
+            assertPreset(BeatDivisorType.Custom, 15);
+
+            switchPresets(1);
+            assertPreset(BeatDivisorType.Common);
+
+            switchPresets(-1);
+            assertPreset(BeatDivisorType.Triplets);
+        }
+
+        private void switchBeatSnap(int direction) => AddRepeatStep($"move snap {(direction > 0 ? "forward" : "backward")}", () =>
+        {
+            int chevronIndex = direction > 0 ? 1 : 0;
+            var chevronButton = beatDivisorControl.ChildrenOfType<BeatDivisorControl.ChevronButton>().ElementAt(chevronIndex);
+            InputManager.MoveMouseTo(chevronButton);
+            InputManager.Click(MouseButton.Left);
+        }, Math.Abs(direction));
+
+        private void assertBeatSnap(int expected) => AddAssert($"beat snap is {expected}",
+            () => bindableBeatDivisor.Value == expected);
+
+        private void switchPresets(int direction) => AddRepeatStep($"move presets {(direction > 0 ? "forward" : "backward")}", () =>
+        {
+            int chevronIndex = direction > 0 ? 3 : 2;
+            var chevronButton = beatDivisorControl.ChildrenOfType<BeatDivisorControl.ChevronButton>().ElementAt(chevronIndex);
+            InputManager.MoveMouseTo(chevronButton);
+            InputManager.Click(MouseButton.Left);
+        }, Math.Abs(direction));
+
+        private void assertPreset(BeatDivisorType type, int? maxDivisor = null)
+        {
+            AddAssert($"preset is {type}", () => bindableBeatDivisor.ValidDivisors.Value.Type == type);
+
+            if (type == BeatDivisorType.Custom)
+            {
+                Debug.Assert(maxDivisor != null);
+                AddAssert($"max divisor is {maxDivisor}", () => bindableBeatDivisor.ValidDivisors.Value.Presets.Max() == maxDivisor.Value);
+            }
+        }
+
+        private void setDivisorViaInput(int divisor)
+        {
+            AddStep("open divisor input popover", () =>
+            {
+                var button = beatDivisorControl.ChildrenOfType<BeatDivisorControl.DivisorDisplay>().Single();
+                InputManager.MoveMouseTo(button);
+                InputManager.Click(MouseButton.Left);
+            });
+
+            BeatDivisorControl.CustomDivisorPopover popover = null;
+            AddUntilStep("wait for popover", () => (popover = this.ChildrenOfType<BeatDivisorControl.CustomDivisorPopover>().SingleOrDefault()) != null && popover.IsLoaded);
+            AddStep($"set divisor to {divisor}", () =>
+            {
+                var textBox = popover.ChildrenOfType<TextBox>().Single();
+                InputManager.MoveMouseTo(textBox);
+                InputManager.Click(MouseButton.Left);
+                textBox.Text = divisor.ToString();
+                InputManager.Key(Key.Enter);
+            });
+            AddStep("dismiss popover", () =>
+            {
+                InputManager.Key(Key.Escape);
+            });
+            AddUntilStep("wait for dismiss", () => !this.ChildrenOfType<BeatDivisorControl.CustomDivisorPopover>().Any());
+        }
     }
 }
diff --git a/osu.Game/Screens/Edit/Compose/Components/BeatDivisorControl.cs b/osu.Game/Screens/Edit/Compose/Components/BeatDivisorControl.cs
index 04e9ac842c..d5b0ab19aa 100644
--- a/osu.Game/Screens/Edit/Compose/Components/BeatDivisorControl.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/BeatDivisorControl.cs
@@ -214,7 +214,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
             }
         }
 
-        private class DivisorDisplay : OsuAnimatedButton, IHasPopover
+        internal class DivisorDisplay : OsuAnimatedButton, IHasPopover
         {
             public BindableBeatDivisor BeatDivisor { get; } = new BindableBeatDivisor();
 
@@ -264,7 +264,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
             };
         }
 
-        private class CustomDivisorPopover : OsuPopover
+        internal class CustomDivisorPopover : OsuPopover
         {
             public BindableBeatDivisor BeatDivisor { get; } = new BindableBeatDivisor();
 
@@ -347,7 +347,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
             }
         }
 
-        private class ChevronButton : IconButton
+        internal class ChevronButton : IconButton
         {
             public ChevronButton()
             {

From a5600516f0200a8e596fa2011ba488106259bc1e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 27 Feb 2022 20:13:44 +0100
Subject: [PATCH 3090/5547] Fix test failures

---
 .../Visual/Editing/TestSceneBeatDivisorControl.cs           | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneBeatDivisorControl.cs b/osu.Game.Tests/Visual/Editing/TestSceneBeatDivisorControl.cs
index 4503b1a5f6..94c0822235 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneBeatDivisorControl.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneBeatDivisorControl.cs
@@ -43,10 +43,10 @@ namespace osu.Game.Tests.Visual.Editing
         [Test]
         public void TestBindableBeatDivisor()
         {
-            AddRepeatStep("move previous", () => bindableBeatDivisor.Previous(), 4);
+            AddRepeatStep("move previous", () => bindableBeatDivisor.Previous(), 2);
             AddAssert("divisor is 4", () => bindableBeatDivisor.Value == 4);
-            AddRepeatStep("move next", () => bindableBeatDivisor.Next(), 3);
-            AddAssert("divisor is 12", () => bindableBeatDivisor.Value == 12);
+            AddRepeatStep("move next", () => bindableBeatDivisor.Next(), 1);
+            AddAssert("divisor is 12", () => bindableBeatDivisor.Value == 8);
         }
 
         [Test]

From 2e04a83554b982d3468e3692dbd70bef36e6c46a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 19 Feb 2022 17:52:16 +0100
Subject: [PATCH 3091/5547] Implement column display for new mod design

---
 .../UserInterface/TestSceneModColumn.cs       |  48 +++++
 osu.Game/Overlays/Mods/ModColumn.cs           | 196 ++++++++++++++++++
 osu.Game/Overlays/Mods/ModPanel.cs            |   4 +-
 3 files changed, 246 insertions(+), 2 deletions(-)
 create mode 100644 osu.Game.Tests/Visual/UserInterface/TestSceneModColumn.cs
 create mode 100644 osu.Game/Overlays/Mods/ModColumn.cs

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneModColumn.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneModColumn.cs
new file mode 100644
index 0000000000..59641ae000
--- /dev/null
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneModColumn.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 NUnit.Framework;
+using osu.Framework.Allocation;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
+using osu.Game.Overlays;
+using osu.Game.Overlays.Mods;
+using osu.Game.Rulesets.Catch;
+using osu.Game.Rulesets.Mania;
+using osu.Game.Rulesets.Mods;
+using osu.Game.Rulesets.Osu;
+using osu.Game.Rulesets.Taiko;
+
+namespace osu.Game.Tests.Visual.UserInterface
+{
+    [TestFixture]
+    public class TestSceneModColumn : OsuTestScene
+    {
+        [Cached]
+        private OverlayColourProvider colourProvider = new OverlayColourProvider(OverlayColourScheme.Green);
+
+        [TestCase(ModType.DifficultyReduction)]
+        [TestCase(ModType.DifficultyIncrease)]
+        [TestCase(ModType.Conversion)]
+        [TestCase(ModType.Automation)]
+        [TestCase(ModType.Fun)]
+        public void TestBasic(ModType modType)
+        {
+            AddStep("create content", () => Child = new Container
+            {
+                RelativeSizeAxes = Axes.Both,
+                Padding = new MarginPadding(30),
+                Child = new ModColumn(modType)
+                {
+                    Anchor = Anchor.Centre,
+                    Origin = Anchor.Centre
+                }
+            });
+
+            AddStep("change ruleset to osu!", () => Ruleset.Value = new OsuRuleset().RulesetInfo);
+            AddStep("change ruleset to taiko", () => Ruleset.Value = new TaikoRuleset().RulesetInfo);
+            AddStep("change ruleset to catch", () => Ruleset.Value = new CatchRuleset().RulesetInfo);
+            AddStep("change ruleset to mania", () => Ruleset.Value = new ManiaRuleset().RulesetInfo);
+        }
+    }
+}
diff --git a/osu.Game/Overlays/Mods/ModColumn.cs b/osu.Game/Overlays/Mods/ModColumn.cs
new file mode 100644
index 0000000000..03ef3b889a
--- /dev/null
+++ b/osu.Game/Overlays/Mods/ModColumn.cs
@@ -0,0 +1,196 @@
+// 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 Humanizer;
+using osu.Framework.Allocation;
+using osu.Framework.Bindables;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Colour;
+using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.Shapes;
+using osu.Game.Graphics;
+using osu.Game.Graphics.Containers;
+using osu.Game.Rulesets.Mods;
+using osu.Game.Utils;
+using osuTK;
+
+#nullable enable
+
+namespace osu.Game.Overlays.Mods
+{
+    public class ModColumn : CompositeDrawable
+    {
+        private readonly ModType modType;
+
+        private readonly Bindable<Dictionary<ModType, IReadOnlyList<Mod>>> availableMods = new Bindable<Dictionary<ModType, IReadOnlyList<Mod>>>();
+
+        private readonly TextFlowContainer headerText;
+        private readonly Box headerBackground;
+        private readonly Container contentContainer;
+        private readonly Box contentBackground;
+        private readonly FillFlowContainer<ModPanel> panelFlow;
+
+        private Colour4 accentColour;
+
+        private const float header_height = 60;
+
+        public ModColumn(ModType modType)
+        {
+            this.modType = modType;
+
+            Width = 450;
+            RelativeSizeAxes = Axes.Y;
+            Shear = new Vector2(ModPanel.SHEAR_X, 0);
+            CornerRadius = ModPanel.CORNER_RADIUS;
+            Masking = true;
+
+            InternalChildren = new Drawable[]
+            {
+                new Container
+                {
+                    RelativeSizeAxes = Axes.X,
+                    Height = header_height + ModPanel.CORNER_RADIUS,
+                    Children = new Drawable[]
+                    {
+                        headerBackground = new Box
+                        {
+                            RelativeSizeAxes = Axes.X,
+                            Height = header_height + ModPanel.CORNER_RADIUS
+                        },
+                        headerText = new OsuTextFlowContainer(t =>
+                        {
+                            t.Font = OsuFont.TorusAlternate.With(size: 24);
+                            t.Shadow = false;
+                            t.Colour = Colour4.Black;
+                        })
+                        {
+                            RelativeSizeAxes = Axes.X,
+                            AutoSizeAxes = Axes.Y,
+                            Anchor = Anchor.CentreLeft,
+                            Origin = Anchor.CentreLeft,
+                            Shear = new Vector2(-ModPanel.SHEAR_X, 0),
+                            Padding = new MarginPadding
+                            {
+                                Horizontal = 15,
+                                Bottom = ModPanel.CORNER_RADIUS
+                            }
+                        }
+                    }
+                },
+                new Container
+                {
+                    RelativeSizeAxes = Axes.Both,
+                    Padding = new MarginPadding { Top = header_height },
+                    Child = contentContainer = new Container
+                    {
+                        RelativeSizeAxes = Axes.Both,
+                        Masking = true,
+                        CornerRadius = ModPanel.CORNER_RADIUS,
+                        BorderThickness = 4,
+                        Children = new Drawable[]
+                        {
+                            contentBackground = new Box
+                            {
+                                RelativeSizeAxes = Axes.Both
+                            },
+                            new GridContainer
+                            {
+                                RelativeSizeAxes = Axes.Both,
+                                RowDimensions = new[]
+                                {
+                                    new Dimension(GridSizeMode.Absolute, 50),
+                                    new Dimension(),
+                                    new Dimension(GridSizeMode.Absolute, 10)
+                                },
+                                Content = new[]
+                                {
+                                    new[]
+                                    {
+                                        Empty()
+                                    },
+                                    new Drawable[]
+                                    {
+                                        new OsuScrollContainer
+                                        {
+                                            RelativeSizeAxes = Axes.Both,
+                                            ScrollbarOverlapsContent = false,
+                                            Child = panelFlow = new FillFlowContainer<ModPanel>
+                                            {
+                                                RelativeSizeAxes = Axes.X,
+                                                AutoSizeAxes = Axes.Y,
+                                                Spacing = new Vector2(0, 10),
+                                                Padding = new MarginPadding
+                                                {
+                                                    Horizontal = 10
+                                                },
+                                            }
+                                        }
+                                    },
+                                    new[] { Empty() }
+                                }
+                            }
+                        }
+                    }
+                }
+            };
+
+            createHeaderText();
+        }
+
+        private void createHeaderText()
+        {
+            IEnumerable<string> headerTextWords = modType.Humanize(LetterCasing.Title).Split(' ');
+
+            if (headerTextWords.Count() > 1)
+            {
+                headerText.AddText($"{headerTextWords.First()} ", t => t.Font = t.Font.With(weight: FontWeight.SemiBold));
+                headerTextWords = headerTextWords.Skip(1);
+            }
+
+            headerText.AddText(string.Join(' ', headerTextWords));
+        }
+
+        [BackgroundDependencyLoader]
+        private void load(OsuGameBase game, OverlayColourProvider colourProvider, OsuColour colours)
+        {
+            availableMods.BindTo(game.AvailableMods);
+
+            headerBackground.Colour = accentColour = colours.ForModType(modType);
+
+            contentContainer.BorderColour = ColourInfo.GradientVertical(colourProvider.Background4, colourProvider.Background3);
+            contentBackground.Colour = colourProvider.Background4;
+        }
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+            availableMods.BindValueChanged(_ => Scheduler.AddOnce(updateMods), true);
+        }
+
+        private CancellationTokenSource? cancellationTokenSource;
+
+        private void updateMods()
+        {
+            var newMods = ModUtils.FlattenMods(availableMods.Value.GetValueOrDefault(modType) ?? Array.Empty<Mod>()).ToList();
+
+            if (newMods.SequenceEqual(panelFlow.Children.Select(p => p.Mod)))
+                return;
+
+            cancellationTokenSource?.Cancel();
+
+            var panels = newMods.Select(mod => new ModPanel(mod)
+            {
+                Shear = new Vector2(-ModPanel.SHEAR_X, 0)
+            });
+
+            LoadComponentsAsync(panels, loaded =>
+            {
+                panelFlow.ChildrenEnumerable = loaded;
+            }, (cancellationTokenSource = new CancellationTokenSource()).Token);
+        }
+    }
+}
diff --git a/osu.Game/Overlays/Mods/ModPanel.cs b/osu.Game/Overlays/Mods/ModPanel.cs
index af8ad3eb18..446ebe12c5 100644
--- a/osu.Game/Overlays/Mods/ModPanel.cs
+++ b/osu.Game/Overlays/Mods/ModPanel.cs
@@ -40,10 +40,10 @@ namespace osu.Game.Overlays.Mods
 
         protected const double TRANSITION_DURATION = 150;
 
-        protected const float SHEAR_X = 0.2f;
+        public const float SHEAR_X = 0.2f;
+        public const float CORNER_RADIUS = 7;
 
         protected const float HEIGHT = 42;
-        protected const float CORNER_RADIUS = 7;
         protected const float IDLE_SWITCH_WIDTH = 54;
         protected const float EXPANDED_SWITCH_WIDTH = 70;
 

From f40bd394871ddff25ef2a50827500663c747df8c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 19 Feb 2022 18:33:13 +0100
Subject: [PATCH 3092/5547] Add toggle all checkbox to column display

---
 osu.Game/Overlays/Mods/ModColumn.cs | 85 ++++++++++++++++++++++++++++-
 1 file changed, 82 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Overlays/Mods/ModColumn.cs b/osu.Game/Overlays/Mods/ModColumn.cs
index 03ef3b889a..a42b2bcb96 100644
--- a/osu.Game/Overlays/Mods/ModColumn.cs
+++ b/osu.Game/Overlays/Mods/ModColumn.cs
@@ -8,15 +8,19 @@ using System.Threading;
 using Humanizer;
 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.Shapes;
+using osu.Framework.Graphics.Sprites;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
+using osu.Game.Graphics.UserInterface;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Utils;
 using osuTK;
+using osuTK.Graphics;
 
 #nullable enable
 
@@ -33,12 +37,13 @@ namespace osu.Game.Overlays.Mods
         private readonly Container contentContainer;
         private readonly Box contentBackground;
         private readonly FillFlowContainer<ModPanel> panelFlow;
+        private readonly ToggleAllCheckbox? toggleAllCheckbox;
 
         private Colour4 accentColour;
 
         private const float header_height = 60;
 
-        public ModColumn(ModType modType)
+        public ModColumn(ModType modType, bool allowBulkSelection)
         {
             this.modType = modType;
 
@@ -48,6 +53,7 @@ namespace osu.Game.Overlays.Mods
             CornerRadius = ModPanel.CORNER_RADIUS;
             Masking = true;
 
+            Container controlContainer;
             InternalChildren = new Drawable[]
             {
                 new Container
@@ -108,9 +114,13 @@ namespace osu.Game.Overlays.Mods
                                 },
                                 Content = new[]
                                 {
-                                    new[]
+                                    new Drawable[]
                                     {
-                                        Empty()
+                                        controlContainer = new Container
+                                        {
+                                            RelativeSizeAxes = Axes.Both,
+                                            Padding = new MarginPadding { Horizontal = 20 }
+                                        }
                                     },
                                     new Drawable[]
                                     {
@@ -139,6 +149,18 @@ namespace osu.Game.Overlays.Mods
             };
 
             createHeaderText();
+
+            if (allowBulkSelection)
+            {
+                controlContainer.Add(toggleAllCheckbox = new ToggleAllCheckbox
+                {
+                    Anchor = Anchor.CentreLeft,
+                    Origin = Anchor.CentreLeft,
+                    RelativeSizeAxes = Axes.X,
+                    LabelText = "Enable All",
+                    Shear = new Vector2(-ModPanel.SHEAR_X, 0)
+                });
+            }
         }
 
         private void createHeaderText()
@@ -161,6 +183,12 @@ namespace osu.Game.Overlays.Mods
 
             headerBackground.Colour = accentColour = colours.ForModType(modType);
 
+            if (toggleAllCheckbox != null)
+            {
+                toggleAllCheckbox.AccentColour = accentColour;
+                toggleAllCheckbox.AccentHoverColour = accentColour.Lighten(0.3f);
+            }
+
             contentContainer.BorderColour = ColourInfo.GradientVertical(colourProvider.Background4, colourProvider.Background3);
             contentBackground.Colour = colourProvider.Background4;
         }
@@ -192,5 +220,56 @@ namespace osu.Game.Overlays.Mods
                 panelFlow.ChildrenEnumerable = loaded;
             }, (cancellationTokenSource = new CancellationTokenSource()).Token);
         }
+
+        private class ToggleAllCheckbox : OsuCheckbox
+        {
+            private Color4 accentColour;
+
+            public Color4 AccentColour
+            {
+                get => accentColour;
+                set
+                {
+                    accentColour = value;
+                    updateState();
+                }
+            }
+
+            private Color4 accentHoverColour;
+
+            public Color4 AccentHoverColour
+            {
+                get => accentHoverColour;
+                set
+                {
+                    accentHoverColour = value;
+                    updateState();
+                }
+            }
+
+            public ToggleAllCheckbox()
+                : base(false)
+            {
+            }
+
+            protected override void ApplyLabelParameters(SpriteText text)
+            {
+                base.ApplyLabelParameters(text);
+                text.Font = text.Font.With(weight: FontWeight.SemiBold);
+            }
+
+            [BackgroundDependencyLoader]
+            private void load()
+            {
+                updateState();
+            }
+
+            private void updateState()
+            {
+                Nub.AccentColour = AccentColour;
+                Nub.GlowingAccentColour = AccentHoverColour;
+                Nub.GlowColour = AccentHoverColour.Opacity(0.2f);
+            }
+        }
     }
 }

From 53e8072632ae3302ec6ee56c0f45e2fddecf7946 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 19 Feb 2022 18:45:04 +0100
Subject: [PATCH 3093/5547] Port multiselection from previous design

---
 .../UserInterface/TestSceneModColumn.cs       | 17 +++-
 osu.Game/Overlays/Mods/ModColumn.cs           | 81 ++++++++++++++++++-
 2 files changed, 95 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneModColumn.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneModColumn.cs
index 59641ae000..e58649d989 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneModColumn.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneModColumn.cs
@@ -32,7 +32,7 @@ namespace osu.Game.Tests.Visual.UserInterface
             {
                 RelativeSizeAxes = Axes.Both,
                 Padding = new MarginPadding(30),
-                Child = new ModColumn(modType)
+                Child = new ModColumn(modType, false)
                 {
                     Anchor = Anchor.Centre,
                     Origin = Anchor.Centre
@@ -44,5 +44,20 @@ namespace osu.Game.Tests.Visual.UserInterface
             AddStep("change ruleset to catch", () => Ruleset.Value = new CatchRuleset().RulesetInfo);
             AddStep("change ruleset to mania", () => Ruleset.Value = new ManiaRuleset().RulesetInfo);
         }
+
+        [Test]
+        public void TestMultiSelection()
+        {
+            AddStep("create content", () => Child = new Container
+            {
+                RelativeSizeAxes = Axes.Both,
+                Padding = new MarginPadding(30),
+                Child = new ModColumn(ModType.DifficultyIncrease, true)
+                {
+                    Anchor = Anchor.Centre,
+                    Origin = Anchor.Centre
+                }
+            });
+        }
     }
 }
diff --git a/osu.Game/Overlays/Mods/ModColumn.cs b/osu.Game/Overlays/Mods/ModColumn.cs
index a42b2bcb96..8ca968368e 100644
--- a/osu.Game/Overlays/Mods/ModColumn.cs
+++ b/osu.Game/Overlays/Mods/ModColumn.cs
@@ -152,7 +152,8 @@ namespace osu.Game.Overlays.Mods
 
             if (allowBulkSelection)
             {
-                controlContainer.Add(toggleAllCheckbox = new ToggleAllCheckbox
+                controlContainer.Height = 50;
+                controlContainer.Add(toggleAllCheckbox = new ToggleAllCheckbox(this)
                 {
                     Anchor = Anchor.CentreLeft,
                     Origin = Anchor.CentreLeft,
@@ -218,9 +219,72 @@ namespace osu.Game.Overlays.Mods
             LoadComponentsAsync(panels, loaded =>
             {
                 panelFlow.ChildrenEnumerable = loaded;
+                foreach (var panel in panelFlow)
+                    panel.Active.BindValueChanged(_ => updateToggleState());
+                updateToggleState();
             }, (cancellationTokenSource = new CancellationTokenSource()).Token);
         }
 
+        #region Bulk select / deselect
+
+        private const double initial_multiple_selection_delay = 120;
+
+        private double selectionDelay = initial_multiple_selection_delay;
+        private double lastSelection;
+
+        private readonly Queue<Action> pendingSelectionOperations = new Queue<Action>();
+
+        protected override void Update()
+        {
+            base.Update();
+
+            if (selectionDelay == initial_multiple_selection_delay || Time.Current - lastSelection >= selectionDelay)
+            {
+                if (pendingSelectionOperations.TryDequeue(out var dequeuedAction))
+                {
+                    dequeuedAction();
+
+                    // each time we play an animation, we decrease the time until the next animation (to ramp the visual and audible elements).
+                    selectionDelay = Math.Max(30, selectionDelay * 0.8f);
+                    lastSelection = Time.Current;
+                }
+                else
+                {
+                    // reset the selection delay after all animations have been completed.
+                    // this will cause the next action to be immediately performed.
+                    selectionDelay = initial_multiple_selection_delay;
+                }
+            }
+        }
+
+        private void updateToggleState()
+        {
+            if (toggleAllCheckbox != null && pendingSelectionOperations.Count == 0)
+                toggleAllCheckbox.Current.Value = panelFlow.All(panel => panel.Active.Value);
+        }
+
+        /// <summary>
+        /// Selects all mods.
+        /// </summary>
+        public void SelectAll()
+        {
+            pendingSelectionOperations.Clear();
+
+            foreach (var button in panelFlow.Where(b => !b.Active.Value))
+                pendingSelectionOperations.Enqueue(() => button.Active.Value = true);
+        }
+
+        /// <summary>
+        /// Deselects all mods.
+        /// </summary>
+        public void DeselectAll()
+        {
+            pendingSelectionOperations.Clear();
+
+            foreach (var button in panelFlow.Where(b => b.Active.Value))
+                pendingSelectionOperations.Enqueue(() => button.Active.Value = false);
+        }
+
         private class ToggleAllCheckbox : OsuCheckbox
         {
             private Color4 accentColour;
@@ -247,9 +311,12 @@ namespace osu.Game.Overlays.Mods
                 }
             }
 
-            public ToggleAllCheckbox()
+            private readonly ModColumn column;
+
+            public ToggleAllCheckbox(ModColumn column)
                 : base(false)
             {
+                this.column = column;
             }
 
             protected override void ApplyLabelParameters(SpriteText text)
@@ -270,6 +337,16 @@ namespace osu.Game.Overlays.Mods
                 Nub.GlowingAccentColour = AccentHoverColour;
                 Nub.GlowColour = AccentHoverColour.Opacity(0.2f);
             }
+
+            protected override void OnUserChange(bool value)
+            {
+                if (value)
+                    column.SelectAll();
+                else
+                    column.DeselectAll();
+            }
         }
+
+        #endregion
     }
 }

From a80b4334ff841c5e09662159589b9354c39f40ce Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 20 Feb 2022 12:18:59 +0100
Subject: [PATCH 3094/5547] Tweak layout of column display for better spacing

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

diff --git a/osu.Game/Overlays/Mods/ModColumn.cs b/osu.Game/Overlays/Mods/ModColumn.cs
index 8ca968368e..15b2874edb 100644
--- a/osu.Game/Overlays/Mods/ModColumn.cs
+++ b/osu.Game/Overlays/Mods/ModColumn.cs
@@ -108,9 +108,8 @@ namespace osu.Game.Overlays.Mods
                                 RelativeSizeAxes = Axes.Both,
                                 RowDimensions = new[]
                                 {
-                                    new Dimension(GridSizeMode.Absolute, 50),
-                                    new Dimension(),
-                                    new Dimension(GridSizeMode.Absolute, 10)
+                                    new Dimension(GridSizeMode.AutoSize),
+                                    new Dimension()
                                 },
                                 Content = new[]
                                 {
@@ -118,7 +117,7 @@ namespace osu.Game.Overlays.Mods
                                     {
                                         controlContainer = new Container
                                         {
-                                            RelativeSizeAxes = Axes.Both,
+                                            RelativeSizeAxes = Axes.X,
                                             Padding = new MarginPadding { Horizontal = 20 }
                                         }
                                     },
@@ -133,14 +132,10 @@ namespace osu.Game.Overlays.Mods
                                                 RelativeSizeAxes = Axes.X,
                                                 AutoSizeAxes = Axes.Y,
                                                 Spacing = new Vector2(0, 10),
-                                                Padding = new MarginPadding
-                                                {
-                                                    Horizontal = 10
-                                                },
+                                                Padding = new MarginPadding(10)
                                             }
                                         }
-                                    },
-                                    new[] { Empty() }
+                                    }
                                 }
                             }
                         }
@@ -161,6 +156,12 @@ namespace osu.Game.Overlays.Mods
                     LabelText = "Enable All",
                     Shear = new Vector2(-ModPanel.SHEAR_X, 0)
                 });
+                panelFlow.Padding = new MarginPadding
+                {
+                    Top = 0,
+                    Bottom = 10,
+                    Horizontal = 10
+                };
             }
         }
 

From fe4e4bf9c5295d04bfcbac3e38e9127b3855b0b2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 20 Feb 2022 13:09:06 +0100
Subject: [PATCH 3095/5547] Add test coverage of multiselection behaviour

---
 .../UserInterface/TestSceneModColumn.cs       | 26 ++++++++++++++++++-
 1 file changed, 25 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneModColumn.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneModColumn.cs
index e58649d989..0401d516ed 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneModColumn.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneModColumn.cs
@@ -1,10 +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.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
+using osu.Framework.Extensions.IEnumerableExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
+using osu.Framework.Testing;
+using osu.Game.Graphics.UserInterface;
 using osu.Game.Overlays;
 using osu.Game.Overlays.Mods;
 using osu.Game.Rulesets.Catch;
@@ -12,11 +16,12 @@ using osu.Game.Rulesets.Mania;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Taiko;
+using osuTK.Input;
 
 namespace osu.Game.Tests.Visual.UserInterface
 {
     [TestFixture]
-    public class TestSceneModColumn : OsuTestScene
+    public class TestSceneModColumn : OsuManualInputManagerTestScene
     {
         [Cached]
         private OverlayColourProvider colourProvider = new OverlayColourProvider(OverlayColourScheme.Green);
@@ -58,6 +63,25 @@ namespace osu.Game.Tests.Visual.UserInterface
                     Origin = Anchor.Centre
                 }
             });
+
+            clickToggle();
+            AddUntilStep("all panels selected", () => this.ChildrenOfType<ModPanel>().All(panel => panel.Active.Value));
+
+            clickToggle();
+            AddUntilStep("all panels deselected", () => this.ChildrenOfType<ModPanel>().All(panel => !panel.Active.Value));
+
+            AddStep("manually activate all panels", () => this.ChildrenOfType<ModPanel>().ForEach(panel => panel.Active.Value = true));
+            AddUntilStep("checkbox selected", () => this.ChildrenOfType<OsuCheckbox>().Single().Current.Value);
+
+            AddStep("deselect first panel", () => this.ChildrenOfType<ModPanel>().First().Active.Value = false);
+            AddUntilStep("checkbox selected", () => !this.ChildrenOfType<OsuCheckbox>().Single().Current.Value);
+
+            void clickToggle() => AddStep("click toggle", () =>
+            {
+                var checkbox = this.ChildrenOfType<OsuCheckbox>().Single();
+                InputManager.MoveMouseTo(checkbox);
+                InputManager.Click(MouseButton.Left);
+            });
         }
     }
 }

From a83f96b026a9d5657d60eda44b594ef090014d6f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 20 Feb 2022 13:40:52 +0100
Subject: [PATCH 3096/5547] Add filtering support to mod column

---
 .../UserInterface/TestSceneModColumn.cs       | 50 +++++++++++++++++++
 osu.Game/Overlays/Mods/ModColumn.cs           | 37 ++++++++++++--
 osu.Game/Overlays/Mods/ModPanel.cs            | 17 +++++++
 3 files changed, 100 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneModColumn.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneModColumn.cs
index 0401d516ed..71a974da7d 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneModColumn.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneModColumn.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.Allocation;
@@ -83,5 +84,54 @@ namespace osu.Game.Tests.Visual.UserInterface
                 InputManager.Click(MouseButton.Left);
             });
         }
+
+        [Test]
+        public void TestFiltering()
+        {
+            TestModColumn column = null;
+
+            AddStep("create content", () => Child = new Container
+            {
+                RelativeSizeAxes = Axes.Both,
+                Padding = new MarginPadding(30),
+                Child = column = new TestModColumn(ModType.Fun, true)
+                {
+                    Anchor = Anchor.Centre,
+                    Origin = Anchor.Centre
+                }
+            });
+
+            AddStep("set filter", () => column.Filter = mod => mod.Name.Contains("Wind", StringComparison.CurrentCultureIgnoreCase));
+            AddUntilStep("two panels visible", () => column.ChildrenOfType<ModPanel>().Count(panel => !panel.Filtered.Value) == 2);
+
+            clickToggle();
+            AddUntilStep("wait for animation", () => !column.SelectionAnimationRunning);
+            AddAssert("only visible items selected", () => column.ChildrenOfType<ModPanel>().Where(panel => panel.Active.Value).All(panel => !panel.Filtered.Value));
+
+            AddStep("unset filter", () => column.Filter = null);
+            AddUntilStep("all panels visible", () => column.ChildrenOfType<ModPanel>().All(panel => !panel.Filtered.Value));
+            AddAssert("checkbox not selected", () => !column.ChildrenOfType<OsuCheckbox>().Single().Current.Value);
+
+            AddStep("set filter", () => column.Filter = mod => mod.Name.Contains("Wind", StringComparison.CurrentCultureIgnoreCase));
+            AddUntilStep("two panels visible", () => column.ChildrenOfType<ModPanel>().Count(panel => !panel.Filtered.Value) == 2);
+            AddAssert("checkbox selected", () => column.ChildrenOfType<OsuCheckbox>().Single().Current.Value);
+
+            void clickToggle() => AddStep("click toggle", () =>
+            {
+                var checkbox = this.ChildrenOfType<OsuCheckbox>().Single();
+                InputManager.MoveMouseTo(checkbox);
+                InputManager.Click(MouseButton.Left);
+            });
+        }
+
+        private class TestModColumn : ModColumn
+        {
+            public new bool SelectionAnimationRunning => base.SelectionAnimationRunning;
+
+            public TestModColumn(ModType modType, bool allowBulkSelection)
+                : base(modType, allowBulkSelection)
+            {
+            }
+        }
     }
 }
diff --git a/osu.Game/Overlays/Mods/ModColumn.cs b/osu.Game/Overlays/Mods/ModColumn.cs
index 15b2874edb..eae57f3574 100644
--- a/osu.Game/Overlays/Mods/ModColumn.cs
+++ b/osu.Game/Overlays/Mods/ModColumn.cs
@@ -28,6 +28,18 @@ namespace osu.Game.Overlays.Mods
 {
     public class ModColumn : CompositeDrawable
     {
+        private Func<Mod, bool>? filter;
+
+        public Func<Mod, bool>? Filter
+        {
+            get => filter;
+            set
+            {
+                filter = value;
+                updateFilter();
+            }
+        }
+
         private readonly ModType modType;
 
         private readonly Bindable<Dictionary<ModType, IReadOnlyList<Mod>>> availableMods = new Bindable<Dictionary<ModType, IReadOnlyList<Mod>>>();
@@ -220,9 +232,12 @@ namespace osu.Game.Overlays.Mods
             LoadComponentsAsync(panels, loaded =>
             {
                 panelFlow.ChildrenEnumerable = loaded;
+
                 foreach (var panel in panelFlow)
                     panel.Active.BindValueChanged(_ => updateToggleState());
                 updateToggleState();
+
+                updateFilter();
             }, (cancellationTokenSource = new CancellationTokenSource()).Token);
         }
 
@@ -235,6 +250,8 @@ namespace osu.Game.Overlays.Mods
 
         private readonly Queue<Action> pendingSelectionOperations = new Queue<Action>();
 
+        protected bool SelectionAnimationRunning => pendingSelectionOperations.Count > 0;
+
         protected override void Update()
         {
             base.Update();
@@ -260,8 +277,8 @@ namespace osu.Game.Overlays.Mods
 
         private void updateToggleState()
         {
-            if (toggleAllCheckbox != null && pendingSelectionOperations.Count == 0)
-                toggleAllCheckbox.Current.Value = panelFlow.All(panel => panel.Active.Value);
+            if (toggleAllCheckbox != null && !SelectionAnimationRunning)
+                toggleAllCheckbox.Current.Value = panelFlow.Where(panel => !panel.Filtered.Value).All(panel => panel.Active.Value);
         }
 
         /// <summary>
@@ -271,7 +288,7 @@ namespace osu.Game.Overlays.Mods
         {
             pendingSelectionOperations.Clear();
 
-            foreach (var button in panelFlow.Where(b => !b.Active.Value))
+            foreach (var button in panelFlow.Where(b => !b.Active.Value && !b.Filtered.Value))
                 pendingSelectionOperations.Enqueue(() => button.Active.Value = true);
         }
 
@@ -282,7 +299,7 @@ namespace osu.Game.Overlays.Mods
         {
             pendingSelectionOperations.Clear();
 
-            foreach (var button in panelFlow.Where(b => b.Active.Value))
+            foreach (var button in panelFlow.Where(b => b.Active.Value && !b.Filtered.Value))
                 pendingSelectionOperations.Enqueue(() => button.Active.Value = false);
         }
 
@@ -349,5 +366,17 @@ namespace osu.Game.Overlays.Mods
         }
 
         #endregion
+
+        #region Filtering support
+
+        private void updateFilter()
+        {
+            foreach (var modPanel in panelFlow)
+                modPanel.ApplyFilter(Filter);
+
+            updateToggleState();
+        }
+
+        #endregion
     }
 }
diff --git a/osu.Game/Overlays/Mods/ModPanel.cs b/osu.Game/Overlays/Mods/ModPanel.cs
index 446ebe12c5..7e4d19850d 100644
--- a/osu.Game/Overlays/Mods/ModPanel.cs
+++ b/osu.Game/Overlays/Mods/ModPanel.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.Allocation;
 using osu.Framework.Audio;
 using osu.Framework.Audio.Sample;
@@ -28,6 +29,7 @@ namespace osu.Game.Overlays.Mods
     {
         public Mod Mod { get; }
         public BindableBool Active { get; } = new BindableBool();
+        public BindableBool Filtered { get; } = new BindableBool();
 
         protected readonly Box Background;
         protected readonly Container SwitchContainer;
@@ -157,6 +159,7 @@ namespace osu.Game.Overlays.Mods
                 playStateChangeSamples();
                 UpdateState();
             });
+            Filtered.BindValueChanged(_ => updateFilterState());
 
             UpdateState();
             FinishTransforms(true);
@@ -235,5 +238,19 @@ namespace osu.Game.Overlays.Mods
             TextBackground.FadeColour(textBackgroundColour, transitionDuration, Easing.OutQuint);
             TextFlow.FadeColour(textColour, transitionDuration, Easing.OutQuint);
         }
+
+        #region Filtering support
+
+        public void ApplyFilter(Func<Mod, bool>? filter)
+        {
+            Filtered.Value = filter != null && !filter.Invoke(Mod);
+        }
+
+        private void updateFilterState()
+        {
+            this.FadeTo(Filtered.Value ? 0 : 1);
+        }
+
+        #endregion
     }
 }

From b690df05de195561d8d691d476982323087aee93 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 20 Feb 2022 14:14:19 +0100
Subject: [PATCH 3097/5547] Hide multiselection checkbox if everything is
 filtered

---
 osu.Game.Tests/Visual/UserInterface/TestSceneModColumn.cs | 8 ++++++++
 osu.Game/Overlays/Mods/ModColumn.cs                       | 3 +++
 2 files changed, 11 insertions(+)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneModColumn.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneModColumn.cs
index 71a974da7d..534e9e0144 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneModColumn.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneModColumn.cs
@@ -116,6 +116,14 @@ namespace osu.Game.Tests.Visual.UserInterface
             AddUntilStep("two panels visible", () => column.ChildrenOfType<ModPanel>().Count(panel => !panel.Filtered.Value) == 2);
             AddAssert("checkbox selected", () => column.ChildrenOfType<OsuCheckbox>().Single().Current.Value);
 
+            AddStep("filter out everything", () => column.Filter = _ => false);
+            AddUntilStep("no panels visible", () => column.ChildrenOfType<ModPanel>().All(panel => panel.Filtered.Value));
+            AddUntilStep("checkbox hidden", () => !column.ChildrenOfType<OsuCheckbox>().Single().IsPresent);
+
+            AddStep("inset filter", () => column.Filter = null);
+            AddUntilStep("no panels visible", () => column.ChildrenOfType<ModPanel>().All(panel => !panel.Filtered.Value));
+            AddUntilStep("checkbox hidden", () => column.ChildrenOfType<OsuCheckbox>().Single().IsPresent);
+
             void clickToggle() => AddStep("click toggle", () =>
             {
                 var checkbox = this.ChildrenOfType<OsuCheckbox>().Single();
diff --git a/osu.Game/Overlays/Mods/ModColumn.cs b/osu.Game/Overlays/Mods/ModColumn.cs
index eae57f3574..649f54a96a 100644
--- a/osu.Game/Overlays/Mods/ModColumn.cs
+++ b/osu.Game/Overlays/Mods/ModColumn.cs
@@ -278,7 +278,10 @@ namespace osu.Game.Overlays.Mods
         private void updateToggleState()
         {
             if (toggleAllCheckbox != null && !SelectionAnimationRunning)
+            {
+                toggleAllCheckbox.Alpha = panelFlow.Any(panel => !panel.Filtered.Value) ? 1 : 0;
                 toggleAllCheckbox.Current.Value = panelFlow.Where(panel => !panel.Filtered.Value).All(panel => panel.Active.Value);
+            }
         }
 
         /// <summary>

From 16c6b9b3b315096d0a8be6638aaac445a475f124 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 20 Feb 2022 14:10:35 +0100
Subject: [PATCH 3098/5547] Add keyboard selection support to mod column

---
 .../UserInterface/TestSceneModColumn.cs       | 37 +++++++++++++++++++
 osu.Game/Overlays/Mods/ModColumn.cs           | 25 ++++++++++++-
 2 files changed, 61 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneModColumn.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneModColumn.cs
index 534e9e0144..01ef4b4b60 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneModColumn.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneModColumn.cs
@@ -132,6 +132,43 @@ namespace osu.Game.Tests.Visual.UserInterface
             });
         }
 
+        [Test]
+        public void TestKeyboardSelection()
+        {
+            ModColumn column = null;
+            AddStep("create content", () => Child = new Container
+            {
+                RelativeSizeAxes = Axes.Both,
+                Padding = new MarginPadding(30),
+                Child = column = new ModColumn(ModType.DifficultyReduction, true, new Key[] { Key.Q, Key.W, Key.E, Key.R, Key.T, Key.Y, Key.U, Key.I, Key.O, Key.P })
+                {
+                    Anchor = Anchor.Centre,
+                    Origin = Anchor.Centre
+                }
+            });
+
+            AddStep("press W", () => InputManager.Key(Key.W));
+            AddAssert("NF panel selected", () => this.ChildrenOfType<ModPanel>().Single(panel => panel.Mod.Acronym == "NF").Active.Value);
+
+            AddStep("press W again", () => InputManager.Key(Key.W));
+            AddAssert("NF panel deselected", () => !this.ChildrenOfType<ModPanel>().Single(panel => panel.Mod.Acronym == "NF").Active.Value);
+
+            AddStep("set filter to NF", () => column.Filter = mod => mod.Acronym == "NF");
+
+            AddStep("press W", () => InputManager.Key(Key.W));
+            AddAssert("NF panel selected", () => this.ChildrenOfType<ModPanel>().Single(panel => panel.Mod.Acronym == "NF").Active.Value);
+
+            AddStep("press W again", () => InputManager.Key(Key.W));
+            AddAssert("NF panel deselected", () => !this.ChildrenOfType<ModPanel>().Single(panel => panel.Mod.Acronym == "NF").Active.Value);
+
+            AddStep("filter out everything", () => column.Filter = _ => false);
+
+            AddStep("press W", () => InputManager.Key(Key.W));
+            AddAssert("NF panel not selected", () => !this.ChildrenOfType<ModPanel>().Single(panel => panel.Mod.Acronym == "NF").Active.Value);
+
+            AddStep("clear filter", () => column.Filter = null);
+        }
+
         private class TestModColumn : ModColumn
         {
             public new bool SelectionAnimationRunning => base.SelectionAnimationRunning;
diff --git a/osu.Game/Overlays/Mods/ModColumn.cs b/osu.Game/Overlays/Mods/ModColumn.cs
index 649f54a96a..dd3b7274fa 100644
--- a/osu.Game/Overlays/Mods/ModColumn.cs
+++ b/osu.Game/Overlays/Mods/ModColumn.cs
@@ -14,6 +14,7 @@ using osu.Framework.Graphics.Colour;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Graphics.Sprites;
+using osu.Framework.Input.Events;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.UserInterface;
@@ -21,6 +22,7 @@ using osu.Game.Rulesets.Mods;
 using osu.Game.Utils;
 using osuTK;
 using osuTK.Graphics;
+using osuTK.Input;
 
 #nullable enable
 
@@ -41,6 +43,7 @@ namespace osu.Game.Overlays.Mods
         }
 
         private readonly ModType modType;
+        private readonly Key[]? toggleKeys;
 
         private readonly Bindable<Dictionary<ModType, IReadOnlyList<Mod>>> availableMods = new Bindable<Dictionary<ModType, IReadOnlyList<Mod>>>();
 
@@ -55,9 +58,10 @@ namespace osu.Game.Overlays.Mods
 
         private const float header_height = 60;
 
-        public ModColumn(ModType modType, bool allowBulkSelection)
+        public ModColumn(ModType modType, bool allowBulkSelection, Key[]? toggleKeys = null)
         {
             this.modType = modType;
+            this.toggleKeys = toggleKeys;
 
             Width = 450;
             RelativeSizeAxes = Axes.Y;
@@ -381,5 +385,24 @@ namespace osu.Game.Overlays.Mods
         }
 
         #endregion
+
+        #region Keyboard selection support
+
+        protected override bool OnKeyDown(KeyDownEvent e)
+        {
+            if (e.ControlPressed || e.AltPressed) return false;
+            if (toggleKeys == null) return false;
+
+            int index = Array.IndexOf(toggleKeys, e.Key);
+            if (index < 0) return false;
+
+            var panel = panelFlow.ElementAtOrDefault(index);
+            if (panel == null || panel.Filtered.Value) return false;
+
+            panel.Active.Toggle();
+            return true;
+        }
+
+        #endregion
     }
 }

From 774952addaf2c2f65a59b470a8c3475cd0024f22 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 27 Feb 2022 23:08:31 +0100
Subject: [PATCH 3099/5547] Rescale components from figma to real dimensions

---
 osu.Game/Overlays/Mods/ModColumn.cs | 23 ++++++++++++-----------
 1 file changed, 12 insertions(+), 11 deletions(-)

diff --git a/osu.Game/Overlays/Mods/ModColumn.cs b/osu.Game/Overlays/Mods/ModColumn.cs
index dd3b7274fa..7f3cc8249f 100644
--- a/osu.Game/Overlays/Mods/ModColumn.cs
+++ b/osu.Game/Overlays/Mods/ModColumn.cs
@@ -56,14 +56,14 @@ namespace osu.Game.Overlays.Mods
 
         private Colour4 accentColour;
 
-        private const float header_height = 60;
+        private const float header_height = 42;
 
         public ModColumn(ModType modType, bool allowBulkSelection, Key[]? toggleKeys = null)
         {
             this.modType = modType;
             this.toggleKeys = toggleKeys;
 
-            Width = 450;
+            Width = 320;
             RelativeSizeAxes = Axes.Y;
             Shear = new Vector2(ModPanel.SHEAR_X, 0);
             CornerRadius = ModPanel.CORNER_RADIUS;
@@ -85,7 +85,7 @@ namespace osu.Game.Overlays.Mods
                         },
                         headerText = new OsuTextFlowContainer(t =>
                         {
-                            t.Font = OsuFont.TorusAlternate.With(size: 24);
+                            t.Font = OsuFont.TorusAlternate.With(size: 17);
                             t.Shadow = false;
                             t.Colour = Colour4.Black;
                         })
@@ -97,7 +97,7 @@ namespace osu.Game.Overlays.Mods
                             Shear = new Vector2(-ModPanel.SHEAR_X, 0),
                             Padding = new MarginPadding
                             {
-                                Horizontal = 15,
+                                Horizontal = 17,
                                 Bottom = ModPanel.CORNER_RADIUS
                             }
                         }
@@ -112,7 +112,7 @@ namespace osu.Game.Overlays.Mods
                         RelativeSizeAxes = Axes.Both,
                         Masking = true,
                         CornerRadius = ModPanel.CORNER_RADIUS,
-                        BorderThickness = 4,
+                        BorderThickness = 3,
                         Children = new Drawable[]
                         {
                             contentBackground = new Box
@@ -134,7 +134,7 @@ namespace osu.Game.Overlays.Mods
                                         controlContainer = new Container
                                         {
                                             RelativeSizeAxes = Axes.X,
-                                            Padding = new MarginPadding { Horizontal = 20 }
+                                            Padding = new MarginPadding { Horizontal = 14 }
                                         }
                                     },
                                     new Drawable[]
@@ -147,8 +147,8 @@ namespace osu.Game.Overlays.Mods
                                             {
                                                 RelativeSizeAxes = Axes.X,
                                                 AutoSizeAxes = Axes.Y,
-                                                Spacing = new Vector2(0, 10),
-                                                Padding = new MarginPadding(10)
+                                                Spacing = new Vector2(0, 7),
+                                                Padding = new MarginPadding(7)
                                             }
                                         }
                                     }
@@ -163,11 +163,12 @@ namespace osu.Game.Overlays.Mods
 
             if (allowBulkSelection)
             {
-                controlContainer.Height = 50;
+                controlContainer.Height = 35;
                 controlContainer.Add(toggleAllCheckbox = new ToggleAllCheckbox(this)
                 {
                     Anchor = Anchor.CentreLeft,
                     Origin = Anchor.CentreLeft,
+                    Scale = new Vector2(0.8f),
                     RelativeSizeAxes = Axes.X,
                     LabelText = "Enable All",
                     Shear = new Vector2(-ModPanel.SHEAR_X, 0)
@@ -175,8 +176,8 @@ namespace osu.Game.Overlays.Mods
                 panelFlow.Padding = new MarginPadding
                 {
                     Top = 0,
-                    Bottom = 10,
-                    Horizontal = 10
+                    Bottom = 7,
+                    Horizontal = 7
                 };
             }
         }

From a1786f62d71999fc9b8991d3c43161932a0eeeb5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 27 Feb 2022 23:10:22 +0100
Subject: [PATCH 3100/5547] Fix test failure due to attempting to set
 non-present divisor

With the latest changes permitting fully custom beat snapping, the 1/3
snap divisor isn't immediately available in editor, requiring a switch
to "triplets" mode first.
---
 .../Editor/TestSceneSliderStreamConversion.cs              | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderStreamConversion.cs b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderStreamConversion.cs
index 559d612037..70a9c03e65 100644
--- a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderStreamConversion.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderStreamConversion.cs
@@ -7,6 +7,7 @@ using osu.Framework.Utils;
 using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Osu.Objects;
 using osu.Game.Screens.Edit;
+using osu.Game.Screens.Edit.Compose.Components;
 using osuTK;
 using osuTK.Input;
 
@@ -72,7 +73,11 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
                 EditorClock.Seek(slider.StartTime);
                 EditorBeatmap.SelectedHitObjects.Add(slider);
             });
-            AddStep("change beat divisor", () => beatDivisor.Value = 3);
+            AddStep("change beat divisor", () =>
+            {
+                beatDivisor.ValidDivisors.Value = BeatDivisorPresetCollection.TRIPLETS;
+                beatDivisor.Value = 3;
+            });
 
             convertToStream();
 

From fe63a09a0f2bb4a640ad92fad039c1f6a1fc323e Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Mon, 28 Feb 2022 11:59:10 +0900
Subject: [PATCH 3101/5547] Fix missing dependency in test

---
 osu.Game.Tournament.Tests/Components/TestSceneSongBar.cs | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/osu.Game.Tournament.Tests/Components/TestSceneSongBar.cs b/osu.Game.Tournament.Tests/Components/TestSceneSongBar.cs
index 868946d80f..b6004c651b 100644
--- a/osu.Game.Tournament.Tests/Components/TestSceneSongBar.cs
+++ b/osu.Game.Tournament.Tests/Components/TestSceneSongBar.cs
@@ -2,16 +2,21 @@
 // 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.Game.Beatmaps.Legacy;
 using osu.Game.Tests.Visual;
 using osu.Game.Tournament.Components;
+using osu.Game.Tournament.Models;
 
 namespace osu.Game.Tournament.Tests.Components
 {
     [TestFixture]
     public class TestSceneSongBar : OsuTestScene
     {
+        [Cached]
+        private readonly LadderInfo ladder = new LadderInfo();
+
         [Test]
         public void TestSongBar()
         {

From 4a555d067da4804d307b74c7bfd90fb7fbb6635c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 28 Feb 2022 14:32:50 +0900
Subject: [PATCH 3102/5547] Change `ModPanel` to not handle `OnMouseDown` to
 allow drag scrolling in `ModColumn`

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

diff --git a/osu.Game/Overlays/Mods/ModPanel.cs b/osu.Game/Overlays/Mods/ModPanel.cs
index 7e4d19850d..312171cf74 100644
--- a/osu.Game/Overlays/Mods/ModPanel.cs
+++ b/osu.Game/Overlays/Mods/ModPanel.cs
@@ -193,7 +193,7 @@ namespace osu.Game.Overlays.Mods
                 mouseDown = true;
 
             UpdateState();
-            return true;
+            return false;
         }
 
         protected override void OnMouseUp(MouseUpEvent e)

From 3634e12e66ff499831a441d5ff27f7ceab1e8627 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 28 Feb 2022 15:21:01 +0900
Subject: [PATCH 3103/5547] Automatically focus divisor textbox and hide
 popover after successful change

---
 osu.Game.Tests/Visual/Editing/TestSceneBeatDivisorControl.cs | 4 ----
 .../Screens/Edit/Compose/Components/BeatDivisorControl.cs    | 5 +++++
 2 files changed, 5 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneBeatDivisorControl.cs b/osu.Game.Tests/Visual/Editing/TestSceneBeatDivisorControl.cs
index 94c0822235..6a0950c6dd 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneBeatDivisorControl.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneBeatDivisorControl.cs
@@ -190,10 +190,6 @@ namespace osu.Game.Tests.Visual.Editing
                 textBox.Text = divisor.ToString();
                 InputManager.Key(Key.Enter);
             });
-            AddStep("dismiss popover", () =>
-            {
-                InputManager.Key(Key.Escape);
-            });
             AddUntilStep("wait for dismiss", () => !this.ChildrenOfType<BeatDivisorControl.CustomDivisorPopover>().Any());
         }
     }
diff --git a/osu.Game/Screens/Edit/Compose/Components/BeatDivisorControl.cs b/osu.Game/Screens/Edit/Compose/Components/BeatDivisorControl.cs
index d5b0ab19aa..c65423ef9f 100644
--- a/osu.Game/Screens/Edit/Compose/Components/BeatDivisorControl.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/BeatDivisorControl.cs
@@ -16,6 +16,7 @@ using osu.Framework.Graphics.Cursor;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Graphics.UserInterface;
+using osu.Framework.Input;
 using osu.Framework.Input.Events;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
@@ -299,6 +300,8 @@ namespace osu.Game.Screens.Edit.Compose.Components
                 base.LoadComplete();
                 BeatDivisor.BindValueChanged(_ => updateState(), true);
                 divisorTextBox.OnCommit += (_, __) => setPresets();
+
+                Schedule(() => GetContainingInputManager().ChangeFocus(divisorTextBox));
             }
 
             private void setPresets()
@@ -320,6 +323,8 @@ namespace osu.Game.Screens.Edit.Compose.Components
                 }
 
                 BeatDivisor.Value = divisor;
+
+                this.HidePopover();
             }
 
             private void updateState()

From 368eadd8d1f02ac7263b093835cb4d98d69ec27b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 28 Feb 2022 15:24:02 +0900
Subject: [PATCH 3104/5547] Remove unused using statement

---
 osu.Game/Screens/Edit/Compose/Components/BeatDivisorControl.cs | 1 -
 1 file changed, 1 deletion(-)

diff --git a/osu.Game/Screens/Edit/Compose/Components/BeatDivisorControl.cs b/osu.Game/Screens/Edit/Compose/Components/BeatDivisorControl.cs
index c65423ef9f..bea72b7447 100644
--- a/osu.Game/Screens/Edit/Compose/Components/BeatDivisorControl.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/BeatDivisorControl.cs
@@ -16,7 +16,6 @@ using osu.Framework.Graphics.Cursor;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Graphics.UserInterface;
-using osu.Framework.Input;
 using osu.Framework.Input.Events;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;

From 2be40f36f77c81501d5530ff136908111ce3ddb8 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 28 Feb 2022 15:26:09 +0900
Subject: [PATCH 3105/5547] Reword popup text to read better (or more vaguely)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Removed some words but also don't mention "smaller" because it's...
musically incorrect and also functionally incorrect – entering 1/[8]
will result in 1/16 also being populated for instance.
---
 osu.Game/Screens/Edit/Compose/Components/BeatDivisorControl.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Edit/Compose/Components/BeatDivisorControl.cs b/osu.Game/Screens/Edit/Compose/Components/BeatDivisorControl.cs
index bea72b7447..370c9016c7 100644
--- a/osu.Game/Screens/Edit/Compose/Components/BeatDivisorControl.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/BeatDivisorControl.cs
@@ -288,7 +288,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
                         {
                             RelativeSizeAxes = Axes.X,
                             AutoSizeAxes = Axes.Y,
-                            Text = "All other applicable smaller divisors will be automatically added to the list of presets."
+                            Text = "Related divisors will be added to the list of presets."
                         }
                     }
                 };

From 2e96f74c94a008e62a523e9ca15cf0b21ba05a71 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 28 Feb 2022 16:37:14 +0900
Subject: [PATCH 3106/5547] Allow `LegacyScoreEncoder` to be used without a
 beatmap if frames are already legacy frames

---
 osu.Game/Scoring/Legacy/LegacyScoreEncoder.cs | 15 +++++++++++++--
 1 file changed, 13 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Scoring/Legacy/LegacyScoreEncoder.cs b/osu.Game/Scoring/Legacy/LegacyScoreEncoder.cs
index 9460ec680c..14a6495282 100644
--- a/osu.Game/Scoring/Legacy/LegacyScoreEncoder.cs
+++ b/osu.Game/Scoring/Legacy/LegacyScoreEncoder.cs
@@ -5,9 +5,11 @@ using System;
 using System.IO;
 using System.Linq;
 using System.Text;
+using JetBrains.Annotations;
 using osu.Framework.Extensions;
 using osu.Game.Beatmaps;
 using osu.Game.IO.Legacy;
+using osu.Game.Replays.Legacy;
 using osu.Game.Rulesets.Replays.Types;
 using SharpCompress.Compressors.LZMA;
 
@@ -29,12 +31,21 @@ namespace osu.Game.Scoring.Legacy
         private readonly Score score;
         private readonly IBeatmap beatmap;
 
-        public LegacyScoreEncoder(Score score, IBeatmap beatmap)
+        /// <summary>
+        /// Create a new score encoder for a specific score.
+        /// </summary>
+        /// <param name="score">The score to be encoded.</param>
+        /// <param name="beatmap">The beatmap used to convert frames for the score. May be null if the frames are already <see cref="LegacyReplayFrame"/>s.</param>
+        /// <exception cref="ArgumentException"></exception>
+        public LegacyScoreEncoder(Score score, [CanBeNull] IBeatmap beatmap)
         {
             this.score = score;
             this.beatmap = beatmap;
 
-            if (score.ScoreInfo.BeatmapInfo.Ruleset.OnlineID < 0 || score.ScoreInfo.BeatmapInfo.Ruleset.OnlineID > 3)
+            if (beatmap == null && !score.Replay.Frames.All(f => f is LegacyReplayFrame))
+                throw new ArgumentException("Beatmap must be provided if frames are not already legacy frames.", nameof(beatmap));
+
+            if (score.ScoreInfo.Ruleset.OnlineID < 0 || score.ScoreInfo.Ruleset.OnlineID > 3)
                 throw new ArgumentException("Only scores in the osu, taiko, catch, or mania rulesets can be encoded to the legacy score format.", nameof(score));
         }
 

From 723e96309ae8b75b3a89a940ddebeef8e0ea45cd Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 28 Feb 2022 16:40:00 +0900
Subject: [PATCH 3107/5547] Only convert non-legacy frames (and throw on
 conversion failure)

---
 osu.Game/Scoring/Legacy/LegacyScoreEncoder.cs | 20 ++++++++++++++++---
 1 file changed, 17 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Scoring/Legacy/LegacyScoreEncoder.cs b/osu.Game/Scoring/Legacy/LegacyScoreEncoder.cs
index 14a6495282..3355efc830 100644
--- a/osu.Game/Scoring/Legacy/LegacyScoreEncoder.cs
+++ b/osu.Game/Scoring/Legacy/LegacyScoreEncoder.cs
@@ -10,6 +10,7 @@ using osu.Framework.Extensions;
 using osu.Game.Beatmaps;
 using osu.Game.IO.Legacy;
 using osu.Game.Replays.Legacy;
+using osu.Game.Rulesets.Replays;
 using osu.Game.Rulesets.Replays.Types;
 using SharpCompress.Compressors.LZMA;
 
@@ -112,11 +113,16 @@ namespace osu.Game.Scoring.Legacy
                 {
                     int lastTime = 0;
 
-                    foreach (var f in score.Replay.Frames.OfType<IConvertibleReplayFrame>().Select(f => f.ToLegacy(beatmap)))
+                    foreach (var f in score.Replay.Frames)
                     {
+                        var legacyFrame = getLegacyFrame(f);
+
+                        if (legacyFrame == null)
+                            throw new ArgumentException("One or more frames could not be converted to legacy frames");
+
                         // Rounding because stable could only parse integral values
-                        int time = (int)Math.Round(f.Time);
-                        replayData.Append(FormattableString.Invariant($"{time - lastTime}|{f.MouseX ?? 0}|{f.MouseY ?? 0}|{(int)f.ButtonState},"));
+                        int time = (int)Math.Round(legacyFrame.Time);
+                        replayData.Append(FormattableString.Invariant($"{time - lastTime}|{legacyFrame.MouseX ?? 0}|{legacyFrame.MouseY ?? 0}|{(int)legacyFrame.ButtonState},"));
                         lastTime = time;
                     }
                 }
@@ -128,6 +134,14 @@ namespace osu.Game.Scoring.Legacy
             }
         }
 
+        private LegacyReplayFrame getLegacyFrame(ReplayFrame replayFrame)
+        {
+            if (replayFrame is LegacyReplayFrame legacyFrame)
+                return legacyFrame;
+
+            return (replayFrame as IConvertibleReplayFrame)?.ToLegacy(beatmap);
+        }
+
         private string getHpGraphFormatted()
         {
             // todo: implement, maybe?

From 52e50db6b94ca11aa8df4ca2b14dbbb39c68ac47 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 28 Feb 2022 16:41:39 +0900
Subject: [PATCH 3108/5547] Enable `nullable` for `LegacyScoreEncoder`

---
 osu.Game/Scoring/Legacy/LegacyScoreEncoder.cs | 27 +++++++++++--------
 1 file changed, 16 insertions(+), 11 deletions(-)

diff --git a/osu.Game/Scoring/Legacy/LegacyScoreEncoder.cs b/osu.Game/Scoring/Legacy/LegacyScoreEncoder.cs
index 3355efc830..1e39b66ead 100644
--- a/osu.Game/Scoring/Legacy/LegacyScoreEncoder.cs
+++ b/osu.Game/Scoring/Legacy/LegacyScoreEncoder.cs
@@ -5,7 +5,6 @@ using System;
 using System.IO;
 using System.Linq;
 using System.Text;
-using JetBrains.Annotations;
 using osu.Framework.Extensions;
 using osu.Game.Beatmaps;
 using osu.Game.IO.Legacy;
@@ -14,6 +13,8 @@ using osu.Game.Rulesets.Replays;
 using osu.Game.Rulesets.Replays.Types;
 using SharpCompress.Compressors.LZMA;
 
+#nullable enable
+
 namespace osu.Game.Scoring.Legacy
 {
     public class LegacyScoreEncoder
@@ -30,7 +31,7 @@ namespace osu.Game.Scoring.Legacy
         public const int FIRST_LAZER_VERSION = 30000000;
 
         private readonly Score score;
-        private readonly IBeatmap beatmap;
+        private readonly IBeatmap? beatmap;
 
         /// <summary>
         /// Create a new score encoder for a specific score.
@@ -38,16 +39,16 @@ namespace osu.Game.Scoring.Legacy
         /// <param name="score">The score to be encoded.</param>
         /// <param name="beatmap">The beatmap used to convert frames for the score. May be null if the frames are already <see cref="LegacyReplayFrame"/>s.</param>
         /// <exception cref="ArgumentException"></exception>
-        public LegacyScoreEncoder(Score score, [CanBeNull] IBeatmap beatmap)
+        public LegacyScoreEncoder(Score score, IBeatmap? beatmap)
         {
             this.score = score;
             this.beatmap = beatmap;
 
             if (beatmap == null && !score.Replay.Frames.All(f => f is LegacyReplayFrame))
-                throw new ArgumentException("Beatmap must be provided if frames are not already legacy frames.", nameof(beatmap));
+                throw new ArgumentException(@"Beatmap must be provided if frames are not already legacy frames.", nameof(beatmap));
 
             if (score.ScoreInfo.Ruleset.OnlineID < 0 || score.ScoreInfo.Ruleset.OnlineID > 3)
-                throw new ArgumentException("Only scores in the osu, taiko, catch, or mania rulesets can be encoded to the legacy score format.", nameof(score));
+                throw new ArgumentException(@"Only scores in the osu, taiko, catch, or mania rulesets can be encoded to the legacy score format.", nameof(score));
         }
 
         public void Encode(Stream stream)
@@ -117,9 +118,6 @@ namespace osu.Game.Scoring.Legacy
                     {
                         var legacyFrame = getLegacyFrame(f);
 
-                        if (legacyFrame == null)
-                            throw new ArgumentException("One or more frames could not be converted to legacy frames");
-
                         // Rounding because stable could only parse integral values
                         int time = (int)Math.Round(legacyFrame.Time);
                         replayData.Append(FormattableString.Invariant($"{time - lastTime}|{legacyFrame.MouseX ?? 0}|{legacyFrame.MouseY ?? 0}|{(int)legacyFrame.ButtonState},"));
@@ -136,10 +134,17 @@ namespace osu.Game.Scoring.Legacy
 
         private LegacyReplayFrame getLegacyFrame(ReplayFrame replayFrame)
         {
-            if (replayFrame is LegacyReplayFrame legacyFrame)
-                return legacyFrame;
+            switch (replayFrame)
+            {
+                case LegacyReplayFrame legacyFrame:
+                    return legacyFrame;
 
-            return (replayFrame as IConvertibleReplayFrame)?.ToLegacy(beatmap);
+                case IConvertibleReplayFrame convertibleFrame:
+                    return convertibleFrame.ToLegacy(beatmap);
+
+                default:
+                    throw new ArgumentException(@"Frame could not be converted to legacy frames", nameof(replayFrame));
+            }
         }
 
         private string getHpGraphFormatted()

From a41e1c80f18b2b37f46963096bbc9c3082336bd4 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 28 Feb 2022 19:11:06 +0900
Subject: [PATCH 3109/5547] Show hit error on results screen

Leading up to implementation of "local offset", this feels like a good
thing to have visible first and foremost.
---
 osu.Game.Rulesets.Mania/ManiaRuleset.cs       |  1 +
 osu.Game.Rulesets.Osu/OsuRuleset.cs           |  1 +
 osu.Game.Rulesets.Taiko/TaikoRuleset.cs       |  1 +
 .../Rulesets/Scoring/HitEventExtensions.cs    |  3 +++
 .../Ranking/Statistics/AverageHitError.cs     | 27 +++++++++++++++++++
 5 files changed, 33 insertions(+)
 create mode 100644 osu.Game/Screens/Ranking/Statistics/AverageHitError.cs

diff --git a/osu.Game.Rulesets.Mania/ManiaRuleset.cs b/osu.Game.Rulesets.Mania/ManiaRuleset.cs
index 180b9ef71b..859b6cfe76 100644
--- a/osu.Game.Rulesets.Mania/ManiaRuleset.cs
+++ b/osu.Game.Rulesets.Mania/ManiaRuleset.cs
@@ -394,6 +394,7 @@ namespace osu.Game.Rulesets.Mania
                 {
                     new StatisticItem(string.Empty, () => new SimpleStatisticTable(3, new SimpleStatisticItem[]
                     {
+                        new AverageHitError(score.HitEvents),
                         new UnstableRate(score.HitEvents)
                     }), true)
                 }
diff --git a/osu.Game.Rulesets.Osu/OsuRuleset.cs b/osu.Game.Rulesets.Osu/OsuRuleset.cs
index ad00a025a1..5ade164566 100644
--- a/osu.Game.Rulesets.Osu/OsuRuleset.cs
+++ b/osu.Game.Rulesets.Osu/OsuRuleset.cs
@@ -314,6 +314,7 @@ namespace osu.Game.Rulesets.Osu
                     {
                         new StatisticItem(string.Empty, () => new SimpleStatisticTable(3, new SimpleStatisticItem[]
                         {
+                            new AverageHitError(timedHitEvents),
                             new UnstableRate(timedHitEvents)
                         }), true)
                     }
diff --git a/osu.Game.Rulesets.Taiko/TaikoRuleset.cs b/osu.Game.Rulesets.Taiko/TaikoRuleset.cs
index e56aabaf9d..de0ef8d95b 100644
--- a/osu.Game.Rulesets.Taiko/TaikoRuleset.cs
+++ b/osu.Game.Rulesets.Taiko/TaikoRuleset.cs
@@ -237,6 +237,7 @@ namespace osu.Game.Rulesets.Taiko
                     {
                         new StatisticItem(string.Empty, () => new SimpleStatisticTable(3, new SimpleStatisticItem[]
                         {
+                            new AverageHitError(timedHitEvents),
                             new UnstableRate(timedHitEvents)
                         }), true)
                     }
diff --git a/osu.Game/Rulesets/Scoring/HitEventExtensions.cs b/osu.Game/Rulesets/Scoring/HitEventExtensions.cs
index f645b12483..5c0b4ecac3 100644
--- a/osu.Game/Rulesets/Scoring/HitEventExtensions.cs
+++ b/osu.Game/Rulesets/Scoring/HitEventExtensions.cs
@@ -22,6 +22,9 @@ namespace osu.Game.Rulesets.Scoring
             return 10 * standardDeviation(timeOffsets);
         }
 
+        public static double? CalculateAverageHitError(this IEnumerable<HitEvent> hitEvents) =>
+            hitEvents.Where(affectsUnstableRate).Select(ev => ev.TimeOffset).Average();
+
         private static bool affectsUnstableRate(HitEvent e) => !(e.HitObject.HitWindows is HitWindows.EmptyHitWindows) && e.Result.IsHit();
 
         private static double? standardDeviation(double[] timeOffsets)
diff --git a/osu.Game/Screens/Ranking/Statistics/AverageHitError.cs b/osu.Game/Screens/Ranking/Statistics/AverageHitError.cs
new file mode 100644
index 0000000000..d0e70251e7
--- /dev/null
+++ b/osu.Game/Screens/Ranking/Statistics/AverageHitError.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 System;
+using System.Collections.Generic;
+using osu.Game.Rulesets.Scoring;
+
+namespace osu.Game.Screens.Ranking.Statistics
+{
+    /// <summary>
+    /// Displays the unstable rate statistic for a given play.
+    /// </summary>
+    public class AverageHitError : SimpleStatisticItem<double?>
+    {
+        /// <summary>
+        /// Creates and computes an <see cref="AverageHitError"/> statistic.
+        /// </summary>
+        /// <param name="hitEvents">Sequence of <see cref="HitEvent"/>s to calculate the unstable rate based on.</param>
+        public AverageHitError(IEnumerable<HitEvent> hitEvents)
+            : base("Average Hit Error")
+        {
+            Value = hitEvents.CalculateAverageHitError();
+        }
+
+        protected override string DisplayValue(double? value) => value == null ? "(not available)" : $"{Math.Abs(value.Value):N2} ms {(value.Value < 0 ? "early" : "late")}";
+    }
+}

From 159db38f8a5ff2ffac1b75c9aa67e6c782356d0b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 28 Feb 2022 19:14:43 +0900
Subject: [PATCH 3110/5547] Add missing xmldoc

---
 osu.Game/Rulesets/Scoring/HitEventExtensions.cs | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/osu.Game/Rulesets/Scoring/HitEventExtensions.cs b/osu.Game/Rulesets/Scoring/HitEventExtensions.cs
index 5c0b4ecac3..637d0a872a 100644
--- a/osu.Game/Rulesets/Scoring/HitEventExtensions.cs
+++ b/osu.Game/Rulesets/Scoring/HitEventExtensions.cs
@@ -22,6 +22,13 @@ namespace osu.Game.Rulesets.Scoring
             return 10 * standardDeviation(timeOffsets);
         }
 
+        /// <summary>
+        /// Calculates the average hit offset/error for a sequence of <see cref="HitEvent"/>s, where negative numbers mean the user hit too early on average.
+        /// </summary>
+        /// <returns>
+        /// A non-null <see langword="double"/> value if unstable rate could be calculated,
+        /// and <see langword="null"/> if unstable rate cannot be calculated due to <paramref name="hitEvents"/> being empty.
+        /// </returns>
         public static double? CalculateAverageHitError(this IEnumerable<HitEvent> hitEvents) =>
             hitEvents.Where(affectsUnstableRate).Select(ev => ev.TimeOffset).Average();
 

From f95b7b992b618d621157b92b6a31e59b798a1cba Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Mon, 28 Feb 2022 17:16:02 +0300
Subject: [PATCH 3111/5547] Disable running `mono-cil-strip` during iOS builds

---
 osu.iOS.props | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/osu.iOS.props b/osu.iOS.props
index 9d0e1790f0..80600655aa 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -15,7 +15,8 @@
   <PropertyGroup>
     <!-- Generated via osu.Framework.iOS/generate-symbol-strip-flags.sh -->
     <GeneratedMtouchSymbolStripFlags>--nosymbolstrip=BASS_FX_BPM_BeatCallbackReset --nosymbolstrip=BASS_FX_BPM_BeatCallbackSet --nosymbolstrip=BASS_FX_BPM_BeatDecodeGet --nosymbolstrip=BASS_FX_BPM_BeatFree --nosymbolstrip=BASS_FX_BPM_BeatGetParameters --nosymbolstrip=BASS_FX_BPM_BeatSetParameters --nosymbolstrip=BASS_FX_BPM_CallbackReset --nosymbolstrip=BASS_FX_BPM_CallbackSet --nosymbolstrip=BASS_FX_BPM_DecodeGet --nosymbolstrip=BASS_FX_BPM_Free --nosymbolstrip=BASS_FX_BPM_Translate --nosymbolstrip=BASS_FX_GetVersion --nosymbolstrip=BASS_FX_ReverseCreate --nosymbolstrip=BASS_FX_ReverseGetSource --nosymbolstrip=BASS_FX_TempoCreate --nosymbolstrip=BASS_FX_TempoGetRateRatio --nosymbolstrip=BASS_FX_TempoGetSource --nosymbolstrip=BASS_Mixer_ChannelFlags --nosymbolstrip=BASS_Mixer_ChannelGetData --nosymbolstrip=BASS_Mixer_ChannelGetEnvelopePos --nosymbolstrip=BASS_Mixer_ChannelGetLevel --nosymbolstrip=BASS_Mixer_ChannelGetLevelEx --nosymbolstrip=BASS_Mixer_ChannelGetMatrix --nosymbolstrip=BASS_Mixer_ChannelGetMixer --nosymbolstrip=BASS_Mixer_ChannelGetPosition --nosymbolstrip=BASS_Mixer_ChannelGetPositionEx --nosymbolstrip=BASS_Mixer_ChannelIsActive --nosymbolstrip=BASS_Mixer_ChannelRemove --nosymbolstrip=BASS_Mixer_ChannelRemoveSync --nosymbolstrip=BASS_Mixer_ChannelSetEnvelope --nosymbolstrip=BASS_Mixer_ChannelSetEnvelopePos --nosymbolstrip=BASS_Mixer_ChannelSetMatrix --nosymbolstrip=BASS_Mixer_ChannelSetMatrixEx --nosymbolstrip=BASS_Mixer_ChannelSetPosition --nosymbolstrip=BASS_Mixer_ChannelSetSync --nosymbolstrip=BASS_Mixer_GetVersion --nosymbolstrip=BASS_Mixer_StreamAddChannel --nosymbolstrip=BASS_Mixer_StreamAddChannelEx --nosymbolstrip=BASS_Mixer_StreamCreate --nosymbolstrip=BASS_Mixer_StreamGetChannels --nosymbolstrip=BASS_Split_StreamCreate --nosymbolstrip=BASS_Split_StreamGetAvailable --nosymbolstrip=BASS_Split_StreamGetSource --nosymbolstrip=BASS_Split_StreamGetSplits --nosymbolstrip=BASS_Split_StreamReset --nosymbolstrip=BASS_Split_StreamResetEx</GeneratedMtouchSymbolStripFlags>
-    <MtouchExtraArgs>--nolinkaway $(GeneratedMtouchSymbolStripFlags)</MtouchExtraArgs>
+    <!-- Disable mono-cil-strip (nostrip) to avoid random attributes potentially stripped out from certain members. -->
+    <MtouchExtraArgs>--nolinkaway --nostrip $(GeneratedMtouchSymbolStripFlags)</MtouchExtraArgs>
   </PropertyGroup>
   <PropertyGroup Condition="'$(Configuration)' == 'Debug'">
     <DebugSymbols>true</DebugSymbols>

From 42b27e305081884b3442b01e1b6de3e7ecbaee74 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 28 Feb 2022 20:44:13 +0100
Subject: [PATCH 3112/5547] Clean up test step names

---
 osu.Game.Tests/Visual/UserInterface/TestSceneModColumn.cs | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneModColumn.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneModColumn.cs
index 01ef4b4b60..01afde8f7e 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneModColumn.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneModColumn.cs
@@ -75,7 +75,7 @@ namespace osu.Game.Tests.Visual.UserInterface
             AddUntilStep("checkbox selected", () => this.ChildrenOfType<OsuCheckbox>().Single().Current.Value);
 
             AddStep("deselect first panel", () => this.ChildrenOfType<ModPanel>().First().Active.Value = false);
-            AddUntilStep("checkbox selected", () => !this.ChildrenOfType<OsuCheckbox>().Single().Current.Value);
+            AddUntilStep("checkbox not selected", () => !this.ChildrenOfType<OsuCheckbox>().Single().Current.Value);
 
             void clickToggle() => AddStep("click toggle", () =>
             {
@@ -121,8 +121,8 @@ namespace osu.Game.Tests.Visual.UserInterface
             AddUntilStep("checkbox hidden", () => !column.ChildrenOfType<OsuCheckbox>().Single().IsPresent);
 
             AddStep("inset filter", () => column.Filter = null);
-            AddUntilStep("no panels visible", () => column.ChildrenOfType<ModPanel>().All(panel => !panel.Filtered.Value));
-            AddUntilStep("checkbox hidden", () => column.ChildrenOfType<OsuCheckbox>().Single().IsPresent);
+            AddUntilStep("all panels visible", () => column.ChildrenOfType<ModPanel>().All(panel => !panel.Filtered.Value));
+            AddUntilStep("checkbox visible", () => column.ChildrenOfType<OsuCheckbox>().Single().IsPresent);
 
             void clickToggle() => AddStep("click toggle", () =>
             {

From 6cc972aa6afc457ca0815ed11194d9d5ce07a79c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 28 Feb 2022 21:36:13 +0100
Subject: [PATCH 3113/5547] Fix test failures by waiting for panel load

---
 .../Visual/UserInterface/TestSceneModColumn.cs      |  9 +++++++--
 osu.Game/Overlays/Mods/ModColumn.cs                 | 13 ++++++++++++-
 2 files changed, 19 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneModColumn.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneModColumn.cs
index 01afde8f7e..e47ae860c6 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneModColumn.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneModColumn.cs
@@ -54,17 +54,20 @@ namespace osu.Game.Tests.Visual.UserInterface
         [Test]
         public void TestMultiSelection()
         {
+            ModColumn column = null;
             AddStep("create content", () => Child = new Container
             {
                 RelativeSizeAxes = Axes.Both,
                 Padding = new MarginPadding(30),
-                Child = new ModColumn(ModType.DifficultyIncrease, true)
+                Child = column = new ModColumn(ModType.DifficultyIncrease, true)
                 {
                     Anchor = Anchor.Centre,
                     Origin = Anchor.Centre
                 }
             });
 
+            AddUntilStep("wait for panel load", () => column.IsLoaded && column.ItemsLoaded);
+
             clickToggle();
             AddUntilStep("all panels selected", () => this.ChildrenOfType<ModPanel>().All(panel => panel.Active.Value));
 
@@ -140,13 +143,15 @@ namespace osu.Game.Tests.Visual.UserInterface
             {
                 RelativeSizeAxes = Axes.Both,
                 Padding = new MarginPadding(30),
-                Child = column = new ModColumn(ModType.DifficultyReduction, true, new Key[] { Key.Q, Key.W, Key.E, Key.R, Key.T, Key.Y, Key.U, Key.I, Key.O, Key.P })
+                Child = column = new ModColumn(ModType.DifficultyReduction, true, new[] { Key.Q, Key.W, Key.E, Key.R, Key.T, Key.Y, Key.U, Key.I, Key.O, Key.P })
                 {
                     Anchor = Anchor.Centre,
                     Origin = Anchor.Centre
                 }
             });
 
+            AddUntilStep("wait for panel load", () => column.IsLoaded && column.ItemsLoaded);
+
             AddStep("press W", () => InputManager.Key(Key.W));
             AddAssert("NF panel selected", () => this.ChildrenOfType<ModPanel>().Single(panel => panel.Mod.Acronym == "NF").Active.Value);
 
diff --git a/osu.Game/Overlays/Mods/ModColumn.cs b/osu.Game/Overlays/Mods/ModColumn.cs
index 7f3cc8249f..b615b7bd32 100644
--- a/osu.Game/Overlays/Mods/ModColumn.cs
+++ b/osu.Game/Overlays/Mods/ModColumn.cs
@@ -5,6 +5,7 @@ using System;
 using System.Collections.Generic;
 using System.Linq;
 using System.Threading;
+using System.Threading.Tasks;
 using Humanizer;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
@@ -56,6 +57,9 @@ namespace osu.Game.Overlays.Mods
 
         private Colour4 accentColour;
 
+        private Task? latestLoadTask;
+        internal bool ItemsLoaded => latestLoadTask == null;
+
         private const float header_height = 42;
 
         public ModColumn(ModType modType, bool allowBulkSelection, Key[]? toggleKeys = null)
@@ -234,7 +238,9 @@ namespace osu.Game.Overlays.Mods
                 Shear = new Vector2(-ModPanel.SHEAR_X, 0)
             });
 
-            LoadComponentsAsync(panels, loaded =>
+            Task? loadTask;
+
+            latestLoadTask = loadTask = LoadComponentsAsync(panels, loaded =>
             {
                 panelFlow.ChildrenEnumerable = loaded;
 
@@ -244,6 +250,11 @@ namespace osu.Game.Overlays.Mods
 
                 updateFilter();
             }, (cancellationTokenSource = new CancellationTokenSource()).Token);
+            loadTask.ContinueWith(_ =>
+            {
+                if (loadTask == latestLoadTask)
+                    latestLoadTask = null;
+            });
         }
 
         #region Bulk select / deselect

From e8701f46f115348b502686916cc9f27fbbd5df01 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 28 Feb 2022 21:39:21 +0100
Subject: [PATCH 3114/5547] Add xmldoc to `Filter` to explain usage

---
 osu.Game/Overlays/Mods/ModColumn.cs | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/osu.Game/Overlays/Mods/ModColumn.cs b/osu.Game/Overlays/Mods/ModColumn.cs
index b615b7bd32..3654f5246d 100644
--- a/osu.Game/Overlays/Mods/ModColumn.cs
+++ b/osu.Game/Overlays/Mods/ModColumn.cs
@@ -33,6 +33,11 @@ namespace osu.Game.Overlays.Mods
     {
         private Func<Mod, bool>? filter;
 
+        /// <summary>
+        /// 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.
+        /// A return value of <see langword="false"/> means that the mod is filtered out and therefore its corresponding panel should be hidden.
+        /// </summary>
         public Func<Mod, bool>? Filter
         {
             get => filter;

From 899b95e61bfb7d0a21a58cd2a9ede511fe554408 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 28 Feb 2022 21:46:58 +0100
Subject: [PATCH 3115/5547] Do not delay inital mod update by a frame

---
 osu.Game/Overlays/Mods/ModColumn.cs | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/Mods/ModColumn.cs b/osu.Game/Overlays/Mods/ModColumn.cs
index 3654f5246d..736a0205e2 100644
--- a/osu.Game/Overlays/Mods/ModColumn.cs
+++ b/osu.Game/Overlays/Mods/ModColumn.cs
@@ -224,7 +224,8 @@ namespace osu.Game.Overlays.Mods
         protected override void LoadComplete()
         {
             base.LoadComplete();
-            availableMods.BindValueChanged(_ => Scheduler.AddOnce(updateMods), true);
+            availableMods.BindValueChanged(_ => Scheduler.AddOnce(updateMods));
+            updateMods();
         }
 
         private CancellationTokenSource? cancellationTokenSource;

From eb75a29b2024b1001001fe4ef7b523624e33ef3d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 1 Mar 2022 12:07:03 +0900
Subject: [PATCH 3116/5547] Use constant for maximum legacy ruleset id

---
 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 1e39b66ead..1326395695 100644
--- a/osu.Game/Scoring/Legacy/LegacyScoreEncoder.cs
+++ b/osu.Game/Scoring/Legacy/LegacyScoreEncoder.cs
@@ -9,6 +9,7 @@ using osu.Framework.Extensions;
 using osu.Game.Beatmaps;
 using osu.Game.IO.Legacy;
 using osu.Game.Replays.Legacy;
+using osu.Game.Rulesets;
 using osu.Game.Rulesets.Replays;
 using osu.Game.Rulesets.Replays.Types;
 using SharpCompress.Compressors.LZMA;
@@ -47,7 +48,7 @@ namespace osu.Game.Scoring.Legacy
             if (beatmap == null && !score.Replay.Frames.All(f => f is LegacyReplayFrame))
                 throw new ArgumentException(@"Beatmap must be provided if frames are not already legacy frames.", nameof(beatmap));
 
-            if (score.ScoreInfo.Ruleset.OnlineID < 0 || score.ScoreInfo.Ruleset.OnlineID > 3)
+            if (score.ScoreInfo.Ruleset.OnlineID < 0 || score.ScoreInfo.Ruleset.OnlineID > ILegacyRuleset.MAX_LEGACY_RULESET_ID)
                 throw new ArgumentException(@"Only scores in the osu, taiko, catch, or mania rulesets can be encoded to the legacy score format.", nameof(score));
         }
 

From 7fa58427832e5dfaa6f9743650be7df15645a414 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 1 Mar 2022 18:30:55 +0900
Subject: [PATCH 3117/5547] Add global statistics output for all realm
 reads/writes

---
 osu.Game/Database/RealmAccess.cs | 27 ++++++++++++++++++++++++---
 1 file changed, 24 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Database/RealmAccess.cs b/osu.Game/Database/RealmAccess.cs
index 9bdbebfe89..f63e858b6f 100644
--- a/osu.Game/Database/RealmAccess.cs
+++ b/osu.Game/Database/RealmAccess.cs
@@ -14,14 +14,14 @@ using osu.Framework.Input.Bindings;
 using osu.Framework.Logging;
 using osu.Framework.Platform;
 using osu.Framework.Statistics;
-using osu.Game.Configuration;
 using osu.Game.Beatmaps;
+using osu.Game.Configuration;
 using osu.Game.Input.Bindings;
 using osu.Game.Models;
-using osu.Game.Skinning;
-using osu.Game.Stores;
 using osu.Game.Rulesets;
 using osu.Game.Scoring;
+using osu.Game.Skinning;
+using osu.Game.Stores;
 using Realms;
 using Realms.Exceptions;
 
@@ -85,6 +85,14 @@ namespace osu.Game.Database
 
         private static readonly GlobalStatistic<int> total_subscriptions = GlobalStatistics.Get<int>(@"Realm", @"Subscriptions");
 
+        private static readonly GlobalStatistic<int> total_reads_update = GlobalStatistics.Get<int>(@"Realm", @"Reads (Update)");
+
+        private static readonly GlobalStatistic<int> total_reads_async = GlobalStatistics.Get<int>(@"Realm", @"Reads (Async)");
+
+        private static readonly GlobalStatistic<int> total_writes_update = GlobalStatistics.Get<int>(@"Realm", @"Writes (Update)");
+
+        private static readonly GlobalStatistic<int> total_writes_async = GlobalStatistics.Get<int>(@"Realm", @"Writes (Async)");
+
         private readonly object realmLock = new object();
 
         private Realm? updateRealm;
@@ -213,8 +221,12 @@ namespace osu.Game.Database
         public T Run<T>(Func<Realm, T> action)
         {
             if (ThreadSafety.IsUpdateThread)
+            {
+                total_reads_update.Value++;
                 return action(Realm);
+            }
 
+            total_reads_async.Value++;
             using (var realm = getRealmInstance())
                 return action(realm);
         }
@@ -226,9 +238,13 @@ namespace osu.Game.Database
         public void Run(Action<Realm> action)
         {
             if (ThreadSafety.IsUpdateThread)
+            {
+                total_reads_update.Value++;
                 action(Realm);
+            }
             else
             {
+                total_reads_async.Value++;
                 using (var realm = getRealmInstance())
                     action(realm);
             }
@@ -241,9 +257,14 @@ namespace osu.Game.Database
         public void Write(Action<Realm> action)
         {
             if (ThreadSafety.IsUpdateThread)
+            {
+                total_writes_update.Value++;
                 Realm.Write(action);
+            }
             else
             {
+                total_writes_async.Value++;
+
                 using (var realm = getRealmInstance())
                     realm.Write(action);
             }

From 9a117467b5ea36389da063102c051ce7eef86ed2 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 1 Mar 2022 18:31:33 +0900
Subject: [PATCH 3118/5547] Add `RealmAccess.WriteAsync` method

---
 .../RealmSubscriptionRegistrationTests.cs     | 29 +++++++++++++++++++
 osu.Game/Database/RealmAccess.cs              | 12 ++++++++
 2 files changed, 41 insertions(+)

diff --git a/osu.Game.Tests/Database/RealmSubscriptionRegistrationTests.cs b/osu.Game.Tests/Database/RealmSubscriptionRegistrationTests.cs
index d62ce3b585..02d617d0e0 100644
--- a/osu.Game.Tests/Database/RealmSubscriptionRegistrationTests.cs
+++ b/osu.Game.Tests/Database/RealmSubscriptionRegistrationTests.cs
@@ -4,8 +4,10 @@
 using System;
 using System.Collections.Generic;
 using System.Linq;
+using System.Threading.Tasks;
 using NUnit.Framework;
 using osu.Framework.Allocation;
+using osu.Framework.Extensions;
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets;
 using osu.Game.Tests.Resources;
@@ -18,6 +20,33 @@ namespace osu.Game.Tests.Database
     [TestFixture]
     public class RealmSubscriptionRegistrationTests : RealmTest
     {
+        [Test]
+        public void TestSubscriptionWithAsyncWrite()
+        {
+            ChangeSet? lastChanges = null;
+
+            RunTestWithRealm((realm, _) =>
+            {
+                var registration = realm.RegisterForNotifications(r => r.All<BeatmapSetInfo>(), onChanged);
+
+                realm.Run(r => r.Refresh());
+
+                // Without forcing the write onto its own thread, realm will internally run the operation synchronously, which can cause a deadlock with `WaitSafely`.
+                Task.Run(async () =>
+                {
+                    await realm.WriteAsync(r => r.Add(TestResources.CreateTestBeatmapSetInfo()));
+                }).WaitSafely();
+
+                realm.Run(r => r.Refresh());
+
+                Assert.That(lastChanges?.InsertedIndices, Has.One.Items);
+
+                registration.Dispose();
+            });
+
+            void onChanged(IRealmCollection<BeatmapSetInfo> sender, ChangeSet? changes, Exception error) => lastChanges = changes;
+        }
+
         [Test]
         public void TestSubscriptionWithContextLoss()
         {
diff --git a/osu.Game/Database/RealmAccess.cs b/osu.Game/Database/RealmAccess.cs
index f63e858b6f..bf2b48ea52 100644
--- a/osu.Game/Database/RealmAccess.cs
+++ b/osu.Game/Database/RealmAccess.cs
@@ -8,6 +8,7 @@ using System.IO;
 using System.Linq;
 using System.Reflection;
 using System.Threading;
+using System.Threading.Tasks;
 using osu.Framework.Allocation;
 using osu.Framework.Development;
 using osu.Framework.Input.Bindings;
@@ -270,6 +271,17 @@ namespace osu.Game.Database
             }
         }
 
+        /// <summary>
+        /// Write changes to realm asynchronously, guaranteeing order of execution.
+        /// </summary>
+        /// <param name="action">The work to run.</param>
+        public async Task WriteAsync(Action<Realm> action)
+        {
+            total_writes_async.Value++;
+            using (var realm = getRealmInstance())
+                await realm.WriteAsync(action);
+        }
+
         /// <summary>
         /// Subscribe to a realm collection and begin watching for asynchronous changes.
         /// </summary>

From 4117a6adf757afa89277246396d2c5e6f59b7cfa Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 1 Mar 2022 14:13:27 +0900
Subject: [PATCH 3119/5547] Move player loader audio settings to new group

---
 osu.Game/Screens/Play/PlayerLoader.cs         |  1 +
 .../Play/PlayerSettings/AudioSettings.cs      | 29 +++++++++++++++++++
 .../Play/PlayerSettings/VisualSettings.cs     |  3 --
 3 files changed, 30 insertions(+), 3 deletions(-)
 create mode 100644 osu.Game/Screens/Play/PlayerSettings/AudioSettings.cs

diff --git a/osu.Game/Screens/Play/PlayerLoader.cs b/osu.Game/Screens/Play/PlayerLoader.cs
index 6009c85583..20c41958c9 100644
--- a/osu.Game/Screens/Play/PlayerLoader.cs
+++ b/osu.Game/Screens/Play/PlayerLoader.cs
@@ -167,6 +167,7 @@ namespace osu.Game.Screens.Play
                         Children = new PlayerSettingsGroup[]
                         {
                             VisualSettings = new VisualSettings(),
+                            new AudioSettings(),
                             new InputSettings()
                         }
                     },
diff --git a/osu.Game/Screens/Play/PlayerSettings/AudioSettings.cs b/osu.Game/Screens/Play/PlayerSettings/AudioSettings.cs
new file mode 100644
index 0000000000..93457980f3
--- /dev/null
+++ b/osu.Game/Screens/Play/PlayerSettings/AudioSettings.cs
@@ -0,0 +1,29 @@
+// 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.Game.Configuration;
+
+namespace osu.Game.Screens.Play.PlayerSettings
+{
+    public class AudioSettings : PlayerSettingsGroup
+    {
+        private readonly PlayerCheckbox beatmapHitsoundsToggle;
+
+        public AudioSettings()
+            : base("Audio Settings")
+        {
+            Children = new Drawable[]
+            {
+                beatmapHitsoundsToggle = new PlayerCheckbox { LabelText = "Beatmap hitsounds" }
+            };
+        }
+
+        [BackgroundDependencyLoader]
+        private void load(OsuConfigManager config)
+        {
+            beatmapHitsoundsToggle.Current = config.GetBindable<bool>(OsuSetting.BeatmapHitsounds);
+        }
+    }
+}
diff --git a/osu.Game/Screens/Play/PlayerSettings/VisualSettings.cs b/osu.Game/Screens/Play/PlayerSettings/VisualSettings.cs
index a97078c461..81950efa9e 100644
--- a/osu.Game/Screens/Play/PlayerSettings/VisualSettings.cs
+++ b/osu.Game/Screens/Play/PlayerSettings/VisualSettings.cs
@@ -15,7 +15,6 @@ namespace osu.Game.Screens.Play.PlayerSettings
         private readonly PlayerCheckbox showStoryboardToggle;
         private readonly PlayerCheckbox beatmapSkinsToggle;
         private readonly PlayerCheckbox beatmapColorsToggle;
-        private readonly PlayerCheckbox beatmapHitsoundsToggle;
 
         public VisualSettings()
             : base("Visual Settings")
@@ -45,7 +44,6 @@ namespace osu.Game.Screens.Play.PlayerSettings
                 showStoryboardToggle = new PlayerCheckbox { LabelText = "Storyboard / Video" },
                 beatmapSkinsToggle = new PlayerCheckbox { LabelText = "Beatmap skins" },
                 beatmapColorsToggle = new PlayerCheckbox { LabelText = "Beatmap colours" },
-                beatmapHitsoundsToggle = new PlayerCheckbox { LabelText = "Beatmap hitsounds" }
             };
         }
 
@@ -57,7 +55,6 @@ namespace osu.Game.Screens.Play.PlayerSettings
             showStoryboardToggle.Current = config.GetBindable<bool>(OsuSetting.ShowStoryboard);
             beatmapSkinsToggle.Current = config.GetBindable<bool>(OsuSetting.BeatmapSkins);
             beatmapColorsToggle.Current = config.GetBindable<bool>(OsuSetting.BeatmapColours);
-            beatmapHitsoundsToggle.Current = config.GetBindable<bool>(OsuSetting.BeatmapHitsounds);
         }
     }
 }

From 5e47e35f0d2b9d85b3f01eeaa54e40db1b3fa998 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 1 Mar 2022 15:40:37 +0900
Subject: [PATCH 3120/5547] Add ability to change distribution of test
 `HitEvent`s

---
 .../Ranking/TestSceneHitEventTimingDistributionGraph.cs   | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Tests/Visual/Ranking/TestSceneHitEventTimingDistributionGraph.cs b/osu.Game.Tests/Visual/Ranking/TestSceneHitEventTimingDistributionGraph.cs
index 4bc843096f..221001e40b 100644
--- a/osu.Game.Tests/Visual/Ranking/TestSceneHitEventTimingDistributionGraph.cs
+++ b/osu.Game.Tests/Visual/Ranking/TestSceneHitEventTimingDistributionGraph.cs
@@ -71,16 +71,16 @@ namespace osu.Game.Tests.Visual.Ranking
             };
         });
 
-        public static List<HitEvent> CreateDistributedHitEvents()
+        public static List<HitEvent> CreateDistributedHitEvents(double centre = 0, double range = 25)
         {
             var hitEvents = new List<HitEvent>();
 
-            for (int i = 0; i < 50; i++)
+            for (int i = 0; i < range * 2; i++)
             {
-                int count = (int)(Math.Pow(25 - Math.Abs(i - 25), 2));
+                int count = (int)(Math.Pow(range - Math.Abs(i - range), 2));
 
                 for (int j = 0; j < count; j++)
-                    hitEvents.Add(new HitEvent(i - 25, HitResult.Perfect, new HitCircle(), new HitCircle(), null));
+                    hitEvents.Add(new HitEvent(centre + i - range, HitResult.Perfect, new HitCircle(), new HitCircle(), null));
             }
 
             return hitEvents;

From 1847f69bf95a95fe7dce07ebb2d4119e946aa470 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 1 Mar 2022 15:40:19 +0900
Subject: [PATCH 3121/5547] Add basic beatmap offset adjustment control

---
 .../Gameplay/TestSceneBeatmapOffsetControl.cs | 27 ++++++
 .../PlayerSettings/BeatmapOffsetControl.cs    | 88 +++++++++++++++++++
 2 files changed, 115 insertions(+)
 create mode 100644 osu.Game.Tests/Visual/Gameplay/TestSceneBeatmapOffsetControl.cs
 create mode 100644 osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneBeatmapOffsetControl.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneBeatmapOffsetControl.cs
new file mode 100644
index 0000000000..bd87039797
--- /dev/null
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneBeatmapOffsetControl.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 NUnit.Framework;
+using osu.Framework.Graphics;
+using osu.Game.Screens.Play.PlayerSettings;
+using osu.Game.Tests.Visual.Ranking;
+
+namespace osu.Game.Tests.Visual.Gameplay
+{
+    public class TestSceneBeatmapOffsetControl : OsuTestScene
+    {
+        [Test]
+        public void TestDisplay()
+        {
+            Child = new PlayerSettingsGroup("Some settings")
+            {
+                Anchor = Anchor.Centre,
+                Origin = Anchor.Centre,
+                Children = new Drawable[]
+                {
+                    new BeatmapOffsetControl(TestSceneHitEventTimingDistributionGraph.CreateDistributedHitEvents(-4.5))
+                }
+            };
+        }
+    }
+}
diff --git a/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs b/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
new file mode 100644
index 0000000000..c05c5beb31
--- /dev/null
+++ b/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.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 System.Collections.Generic;
+using osu.Framework.Bindables;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
+using osu.Game.Graphics.Sprites;
+using osu.Game.Overlays.Settings;
+using osu.Game.Rulesets.Scoring;
+using osu.Game.Screens.Ranking.Statistics;
+using osuTK;
+
+namespace osu.Game.Screens.Play.PlayerSettings
+{
+    public class BeatmapOffsetControl : CompositeDrawable
+    {
+        private readonly SettingsButton useAverageButton;
+
+        private readonly double lastPlayAverage;
+
+        public Bindable<double> Current { get; } = new BindableDouble
+        {
+            Default = 0,
+            Value = 0,
+            MinValue = -50,
+            MaxValue = 50,
+            Precision = 0.1,
+        };
+
+        public BeatmapOffsetControl(IReadOnlyList<HitEvent> hitEvents)
+        {
+            RelativeSizeAxes = Axes.X;
+            AutoSizeAxes = Axes.Y;
+
+            FillFlowContainer flow;
+
+            InternalChild = flow = new FillFlowContainer
+            {
+                RelativeSizeAxes = Axes.X,
+                AutoSizeAxes = Axes.Y,
+                Direction = FillDirection.Vertical,
+                Spacing = new Vector2(10),
+                Children = new Drawable[]
+                {
+                    new PlayerSliderBar<double>
+                    {
+                        KeyboardStep = 5,
+                        LabelText = "Beatmap offset",
+                        Current = Current,
+                    },
+                }
+            };
+
+            if (hitEvents.CalculateAverageHitError() is double average)
+            {
+                lastPlayAverage = average;
+
+                flow.AddRange(new Drawable[]
+                {
+                    new OsuSpriteText
+                    {
+                        Text = "Last play:"
+                    },
+                    new HitEventTimingDistributionGraph(hitEvents)
+                    {
+                        RelativeSizeAxes = Axes.X,
+                        Height = 50,
+                    },
+                    new AverageHitError(hitEvents),
+                    useAverageButton = new SettingsButton
+                    {
+                        Text = "Calibrate using last play",
+                        Action = () => Current.Value = lastPlayAverage
+                    },
+                });
+            }
+
+            Current.BindValueChanged(offset =>
+            {
+                if (useAverageButton != null)
+                {
+                    useAverageButton.Enabled.Value = offset.NewValue != lastPlayAverage;
+                }
+            }, true);
+        }
+    }
+}

From 350b0b488c048d114cb25adc4353517d75ac2081 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 1 Mar 2022 14:47:06 +0900
Subject: [PATCH 3122/5547] TODO: Get score from previous play session for
 further analysis

---
 osu.Game/Screens/Play/Player.cs       | 6 +++++-
 osu.Game/Screens/Play/PlayerLoader.cs | 9 +++++++++
 2 files changed, 14 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Play/Player.cs b/osu.Game/Screens/Play/Player.cs
index d4b02622d3..86ea412488 100644
--- a/osu.Game/Screens/Play/Player.cs
+++ b/osu.Game/Screens/Play/Player.cs
@@ -136,7 +136,11 @@ namespace osu.Game.Screens.Play
 
         public readonly PlayerConfiguration Configuration;
 
-        protected Score Score { get; private set; }
+        /// <summary>
+        /// The score for the current play session.
+        /// Available only after the player is loaded.
+        /// </summary>
+        public Score Score { get; private set; }
 
         /// <summary>
         /// Create a new player instance.
diff --git a/osu.Game/Screens/Play/PlayerLoader.cs b/osu.Game/Screens/Play/PlayerLoader.cs
index 20c41958c9..863246cd05 100644
--- a/osu.Game/Screens/Play/PlayerLoader.cs
+++ b/osu.Game/Screens/Play/PlayerLoader.cs
@@ -23,6 +23,7 @@ using osu.Game.Graphics.Containers;
 using osu.Game.Input;
 using osu.Game.Overlays;
 using osu.Game.Overlays.Notifications;
+using osu.Game.Rulesets.Scoring;
 using osu.Game.Screens.Menu;
 using osu.Game.Screens.Play.PlayerSettings;
 using osu.Game.Users;
@@ -226,6 +227,14 @@ namespace osu.Game.Screens.Play
         {
             base.OnResuming(last);
 
+            var lastScore = player.Score;
+
+            if (lastScore != null)
+            {
+                // TODO: use this
+                double? lastPlayHitError = lastScore.ScoreInfo.HitEvents.CalculateAverageHitError();
+            }
+
             // prepare for a retry.
             player = null;
             playerConsumed = false;

From 7215f3f66b6c7891f7d9b8de14ff6ba7fe155ed8 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 1 Mar 2022 16:02:48 +0900
Subject: [PATCH 3123/5547] Fix `CalculateAverageHitError` throwing if there
 are zero `HitEvent`s

---
 osu.Game/Rulesets/Scoring/HitEventExtensions.cs | 11 +++++++++--
 1 file changed, 9 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Rulesets/Scoring/HitEventExtensions.cs b/osu.Game/Rulesets/Scoring/HitEventExtensions.cs
index 637d0a872a..fea13cf4b6 100644
--- a/osu.Game/Rulesets/Scoring/HitEventExtensions.cs
+++ b/osu.Game/Rulesets/Scoring/HitEventExtensions.cs
@@ -29,8 +29,15 @@ namespace osu.Game.Rulesets.Scoring
         /// A non-null <see langword="double"/> value if unstable rate could be calculated,
         /// and <see langword="null"/> if unstable rate cannot be calculated due to <paramref name="hitEvents"/> being empty.
         /// </returns>
-        public static double? CalculateAverageHitError(this IEnumerable<HitEvent> hitEvents) =>
-            hitEvents.Where(affectsUnstableRate).Select(ev => ev.TimeOffset).Average();
+        public static double? CalculateAverageHitError(this IEnumerable<HitEvent> hitEvents)
+        {
+            double[] timeOffsets = hitEvents.Where(affectsUnstableRate).Select(ev => ev.TimeOffset).ToArray();
+
+            if (timeOffsets.Length == 0)
+                return null;
+
+            return timeOffsets.Average();
+        }
 
         private static bool affectsUnstableRate(HitEvent e) => !(e.HitObject.HitWindows is HitWindows.EmptyHitWindows) && e.Result.IsHit();
 

From 2901d2a6505c6a1a44ee86101635cd35837cc231 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 1 Mar 2022 16:14:57 +0900
Subject: [PATCH 3124/5547] Hook offset adjustment control up to last play via
 `PlayerLoader`

---
 osu.Game/Screens/Play/PlayerLoader.cs         | 11 +--
 .../Play/PlayerSettings/AudioSettings.cs      | 10 ++-
 .../PlayerSettings/BeatmapOffsetControl.cs    | 79 +++++++++++--------
 3 files changed, 61 insertions(+), 39 deletions(-)

diff --git a/osu.Game/Screens/Play/PlayerLoader.cs b/osu.Game/Screens/Play/PlayerLoader.cs
index 863246cd05..f6d63a8ec5 100644
--- a/osu.Game/Screens/Play/PlayerLoader.cs
+++ b/osu.Game/Screens/Play/PlayerLoader.cs
@@ -23,7 +23,6 @@ using osu.Game.Graphics.Containers;
 using osu.Game.Input;
 using osu.Game.Overlays;
 using osu.Game.Overlays.Notifications;
-using osu.Game.Rulesets.Scoring;
 using osu.Game.Screens.Menu;
 using osu.Game.Screens.Play.PlayerSettings;
 using osu.Game.Users;
@@ -62,6 +61,8 @@ namespace osu.Game.Screens.Play
 
         protected VisualSettings VisualSettings { get; private set; }
 
+        protected AudioSettings AudioSettings { get; private set; }
+
         protected Task LoadTask { get; private set; }
 
         protected Task DisposalTask { get; private set; }
@@ -168,7 +169,7 @@ namespace osu.Game.Screens.Play
                         Children = new PlayerSettingsGroup[]
                         {
                             VisualSettings = new VisualSettings(),
-                            new AudioSettings(),
+                            AudioSettings = new AudioSettings(),
                             new InputSettings()
                         }
                     },
@@ -229,11 +230,7 @@ namespace osu.Game.Screens.Play
 
             var lastScore = player.Score;
 
-            if (lastScore != null)
-            {
-                // TODO: use this
-                double? lastPlayHitError = lastScore.ScoreInfo.HitEvents.CalculateAverageHitError();
-            }
+            AudioSettings.ReferenceScore.Value = lastScore?.ScoreInfo;
 
             // prepare for a retry.
             player = null;
diff --git a/osu.Game/Screens/Play/PlayerSettings/AudioSettings.cs b/osu.Game/Screens/Play/PlayerSettings/AudioSettings.cs
index 93457980f3..32de5333e1 100644
--- a/osu.Game/Screens/Play/PlayerSettings/AudioSettings.cs
+++ b/osu.Game/Screens/Play/PlayerSettings/AudioSettings.cs
@@ -2,13 +2,17 @@
 // 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.Configuration;
+using osu.Game.Scoring;
 
 namespace osu.Game.Screens.Play.PlayerSettings
 {
     public class AudioSettings : PlayerSettingsGroup
     {
+        public Bindable<ScoreInfo> ReferenceScore { get; } = new Bindable<ScoreInfo>();
+
         private readonly PlayerCheckbox beatmapHitsoundsToggle;
 
         public AudioSettings()
@@ -16,7 +20,11 @@ namespace osu.Game.Screens.Play.PlayerSettings
         {
             Children = new Drawable[]
             {
-                beatmapHitsoundsToggle = new PlayerCheckbox { LabelText = "Beatmap hitsounds" }
+                beatmapHitsoundsToggle = new PlayerCheckbox { LabelText = "Beatmap hitsounds" },
+                new BeatmapOffsetControl
+                {
+                    ReferenceScore = { BindTarget = ReferenceScore },
+                },
             };
         }
 
diff --git a/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs b/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
index c05c5beb31..5d287a3730 100644
--- a/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
+++ b/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.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 osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Overlays.Settings;
 using osu.Game.Rulesets.Scoring;
+using osu.Game.Scoring;
 using osu.Game.Screens.Ranking.Statistics;
 using osuTK;
 
@@ -15,9 +15,7 @@ namespace osu.Game.Screens.Play.PlayerSettings
 {
     public class BeatmapOffsetControl : CompositeDrawable
     {
-        private readonly SettingsButton useAverageButton;
-
-        private readonly double lastPlayAverage;
+        public Bindable<ScoreInfo> ReferenceScore { get; } = new Bindable<ScoreInfo>();
 
         public Bindable<double> Current { get; } = new BindableDouble
         {
@@ -28,14 +26,18 @@ namespace osu.Game.Screens.Play.PlayerSettings
             Precision = 0.1,
         };
 
-        public BeatmapOffsetControl(IReadOnlyList<HitEvent> hitEvents)
+        private SettingsButton useAverageButton;
+
+        private double lastPlayAverage;
+
+        private readonly FillFlowContainer referenceScoreContainer;
+
+        public BeatmapOffsetControl()
         {
             RelativeSizeAxes = Axes.X;
             AutoSizeAxes = Axes.Y;
 
-            FillFlowContainer flow;
-
-            InternalChild = flow = new FillFlowContainer
+            InternalChild = new FillFlowContainer
             {
                 RelativeSizeAxes = Axes.X,
                 AutoSizeAxes = Axes.Y,
@@ -49,32 +51,17 @@ namespace osu.Game.Screens.Play.PlayerSettings
                         LabelText = "Beatmap offset",
                         Current = Current,
                     },
+                    referenceScoreContainer = new FillFlowContainer
+                    {
+                        Spacing = new Vector2(10),
+                        Direction = FillDirection.Vertical,
+                        RelativeSizeAxes = Axes.X,
+                        AutoSizeAxes = Axes.Y,
+                    },
                 }
             };
 
-            if (hitEvents.CalculateAverageHitError() is double average)
-            {
-                lastPlayAverage = average;
-
-                flow.AddRange(new Drawable[]
-                {
-                    new OsuSpriteText
-                    {
-                        Text = "Last play:"
-                    },
-                    new HitEventTimingDistributionGraph(hitEvents)
-                    {
-                        RelativeSizeAxes = Axes.X,
-                        Height = 50,
-                    },
-                    new AverageHitError(hitEvents),
-                    useAverageButton = new SettingsButton
-                    {
-                        Text = "Calibrate using last play",
-                        Action = () => Current.Value = lastPlayAverage
-                    },
-                });
-            }
+            ReferenceScore.BindValueChanged(scoreChanged, true);
 
             Current.BindValueChanged(offset =>
             {
@@ -84,5 +71,35 @@ namespace osu.Game.Screens.Play.PlayerSettings
                 }
             }, true);
         }
+
+        private void scoreChanged(ValueChangedEvent<ScoreInfo> score)
+        {
+            if (!(score.NewValue?.HitEvents.CalculateAverageHitError() is double average))
+            {
+                referenceScoreContainer.Clear();
+                return;
+            }
+
+            lastPlayAverage = average;
+
+            referenceScoreContainer.Children = new Drawable[]
+            {
+                new OsuSpriteText
+                {
+                    Text = "Last play:"
+                },
+                new HitEventTimingDistributionGraph(score.NewValue.HitEvents)
+                {
+                    RelativeSizeAxes = Axes.X,
+                    Height = 50,
+                },
+                new AverageHitError(score.NewValue.HitEvents),
+                useAverageButton = new SettingsButton
+                {
+                    Text = "Calibrate using last play",
+                    Action = () => Current.Value = lastPlayAverage
+                },
+            };
+        }
     }
 }

From fab09575ec30d2cec7aef5487f59b6b8fa10732a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 1 Mar 2022 16:15:13 +0900
Subject: [PATCH 3125/5547] Add full testing flow for `BeatmapOffsetControl`

---
 .../Gameplay/TestSceneBeatmapOffsetControl.cs | 46 ++++++++++++++++---
 1 file changed, 39 insertions(+), 7 deletions(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneBeatmapOffsetControl.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneBeatmapOffsetControl.cs
index bd87039797..3fb10b2d5c 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneBeatmapOffsetControl.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneBeatmapOffsetControl.cs
@@ -1,8 +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.Linq;
 using NUnit.Framework;
 using osu.Framework.Graphics;
+using osu.Framework.Testing;
+using osu.Game.Overlays.Settings;
+using osu.Game.Scoring;
 using osu.Game.Screens.Play.PlayerSettings;
 using osu.Game.Tests.Visual.Ranking;
 
@@ -10,18 +14,46 @@ namespace osu.Game.Tests.Visual.Gameplay
 {
     public class TestSceneBeatmapOffsetControl : OsuTestScene
     {
+        private BeatmapOffsetControl offsetControl;
+
+        [SetUpSteps]
+        public void SetUpSteps()
+        {
+            AddStep("Create control", () =>
+            {
+                Child = new PlayerSettingsGroup("Some settings")
+                {
+                    Anchor = Anchor.Centre,
+                    Origin = Anchor.Centre,
+                    Children = new Drawable[]
+                    {
+                        offsetControl = new BeatmapOffsetControl()
+                    }
+                };
+            });
+        }
+
         [Test]
         public void TestDisplay()
         {
-            Child = new PlayerSettingsGroup("Some settings")
+            const double average_error = -4.5;
+
+            AddAssert("Offset is neutral", () => offsetControl.Current.Value == 0);
+            AddAssert("No calibration button", () => !offsetControl.ChildrenOfType<SettingsButton>().Any());
+            AddStep("Set reference score", () =>
             {
-                Anchor = Anchor.Centre,
-                Origin = Anchor.Centre,
-                Children = new Drawable[]
+                offsetControl.ReferenceScore.Value = new ScoreInfo
                 {
-                    new BeatmapOffsetControl(TestSceneHitEventTimingDistributionGraph.CreateDistributedHitEvents(-4.5))
-                }
-            };
+                    HitEvents = TestSceneHitEventTimingDistributionGraph.CreateDistributedHitEvents(average_error)
+                };
+            });
+
+            AddAssert("Has calibration button", () => offsetControl.ChildrenOfType<SettingsButton>().Any());
+            AddStep("Press button", () => offsetControl.ChildrenOfType<SettingsButton>().Single().TriggerClick());
+            AddAssert("Offset is adjusted", () => offsetControl.Current.Value == average_error);
+
+            AddStep("Remove reference score", () => offsetControl.ReferenceScore.Value = null);
+            AddAssert("No calibration button", () => !offsetControl.ChildrenOfType<SettingsButton>().Any());
         }
     }
 }

From acf8db13acad60857ed919f00399f0f50c80f869 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 1 Mar 2022 16:22:51 +0900
Subject: [PATCH 3126/5547] Store user settings to realm

---
 osu.Game/Beatmaps/BeatmapInfo.cs         |  3 +++
 osu.Game/Beatmaps/BeatmapUserSettings.cs | 19 +++++++++++++++++++
 osu.Game/Database/RealmAccess.cs         |  3 ++-
 3 files changed, 24 insertions(+), 1 deletion(-)
 create mode 100644 osu.Game/Beatmaps/BeatmapUserSettings.cs

diff --git a/osu.Game/Beatmaps/BeatmapInfo.cs b/osu.Game/Beatmaps/BeatmapInfo.cs
index 305b3979a0..c6f69286cd 100644
--- a/osu.Game/Beatmaps/BeatmapInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapInfo.cs
@@ -40,6 +40,8 @@ namespace osu.Game.Beatmaps
         [Backlink(nameof(ScoreInfo.BeatmapInfo))]
         public IQueryable<ScoreInfo> Scores { get; } = null!;
 
+        public BeatmapUserSettings UserSettings { get; set; } = null!;
+
         public BeatmapInfo(RulesetInfo? ruleset = null, BeatmapDifficulty? difficulty = null, BeatmapMetadata? metadata = null)
         {
             ID = Guid.NewGuid();
@@ -51,6 +53,7 @@ namespace osu.Game.Beatmaps
             };
             Difficulty = difficulty ?? new BeatmapDifficulty();
             Metadata = metadata ?? new BeatmapMetadata();
+            UserSettings = new BeatmapUserSettings();
         }
 
         [UsedImplicitly]
diff --git a/osu.Game/Beatmaps/BeatmapUserSettings.cs b/osu.Game/Beatmaps/BeatmapUserSettings.cs
new file mode 100644
index 0000000000..5c71bf34b1
--- /dev/null
+++ b/osu.Game/Beatmaps/BeatmapUserSettings.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.
+
+#nullable enable
+using Realms;
+
+namespace osu.Game.Beatmaps
+{
+    /// <summary>
+    /// User settings overrides that are attached to a beatmap.
+    /// </summary>
+    public class BeatmapUserSettings : EmbeddedObject
+    {
+        /// <summary>
+        /// An audio offset that can be used for timing adjustments.
+        /// </summary>
+        public double Offset { get; set; }
+    }
+}
diff --git a/osu.Game/Database/RealmAccess.cs b/osu.Game/Database/RealmAccess.cs
index bf2b48ea52..fc2f519ead 100644
--- a/osu.Game/Database/RealmAccess.cs
+++ b/osu.Game/Database/RealmAccess.cs
@@ -54,8 +54,9 @@ namespace osu.Game.Database
         /// 11   2021-11-22    Use ShortName instead of RulesetID for ruleset key bindings.
         /// 12   2021-11-24    Add Status to RealmBeatmapSet.
         /// 13   2022-01-13    Final migration of beatmaps and scores to realm (multiple new storage fields).
+        /// 14   2022-03-01    Added BeatmapUserSettings to BeatmapInfo.
         /// </summary>
-        private const int schema_version = 13;
+        private const int schema_version = 14;
 
         /// <summary>
         /// Lock object which is held during <see cref="BlockAllOperations"/> sections, blocking realm retrieval during blocking periods.

From 047e801da9f9fe31b9a13d6c8c59b6240626fcc2 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 1 Mar 2022 16:59:33 +0900
Subject: [PATCH 3127/5547] Store and retrieve offset from realm

---
 osu.Game/Database/RealmAccess.cs              |  5 +++
 .../Play/MasterGameplayClockContainer.cs      | 17 +++++----
 .../PlayerSettings/BeatmapOffsetControl.cs    | 36 +++++++++++++++----
 3 files changed, 46 insertions(+), 12 deletions(-)

diff --git a/osu.Game/Database/RealmAccess.cs b/osu.Game/Database/RealmAccess.cs
index fc2f519ead..fb3052d850 100644
--- a/osu.Game/Database/RealmAccess.cs
+++ b/osu.Game/Database/RealmAccess.cs
@@ -565,6 +565,11 @@ namespace osu.Game.Database
                     }
 
                     break;
+
+                case 14:
+                    foreach (var beatmap in migration.NewRealm.All<BeatmapInfo>())
+                        beatmap.UserSettings = new BeatmapUserSettings();
+                    break;
             }
         }
 
diff --git a/osu.Game/Screens/Play/MasterGameplayClockContainer.cs b/osu.Game/Screens/Play/MasterGameplayClockContainer.cs
index 200921680e..d27a989067 100644
--- a/osu.Game/Screens/Play/MasterGameplayClockContainer.cs
+++ b/osu.Game/Screens/Play/MasterGameplayClockContainer.cs
@@ -13,6 +13,7 @@ using osu.Framework.Graphics;
 using osu.Framework.Timing;
 using osu.Game.Beatmaps;
 using osu.Game.Configuration;
+using osu.Game.Database;
 
 namespace osu.Game.Screens.Play
 {
@@ -43,7 +44,7 @@ namespace osu.Game.Screens.Play
             Precision = 0.1,
         };
 
-        private double totalAppliedOffset => userOffsetClock.RateAdjustedOffset + platformOffsetClock.RateAdjustedOffset;
+        private double totalAppliedOffset => userBeatmapOffsetClock.RateAdjustedOffset + userGlobalOffsetClock.RateAdjustedOffset + platformOffsetClock.RateAdjustedOffset;
 
         private readonly BindableDouble pauseFreqAdjust = new BindableDouble(1);
 
@@ -52,7 +53,8 @@ namespace osu.Game.Screens.Play
         private readonly bool startAtGameplayStart;
         private readonly double firstHitObjectTime;
 
-        private HardwareCorrectionOffsetClock userOffsetClock;
+        private HardwareCorrectionOffsetClock userGlobalOffsetClock;
+        private HardwareCorrectionOffsetClock userBeatmapOffsetClock;
         private HardwareCorrectionOffsetClock platformOffsetClock;
         private MasterGameplayClock masterGameplayClock;
         private Bindable<double> userAudioOffset;
@@ -69,10 +71,12 @@ namespace osu.Game.Screens.Play
         }
 
         [BackgroundDependencyLoader]
-        private void load(OsuConfigManager config)
+        private void load(OsuConfigManager config, RealmAccess realm)
         {
             userAudioOffset = config.GetBindable<double>(OsuSetting.AudioOffset);
-            userAudioOffset.BindValueChanged(offset => userOffsetClock.Offset = offset.NewValue, true);
+            userAudioOffset.BindValueChanged(offset => userGlobalOffsetClock.Offset = offset.NewValue, true);
+
+            userBeatmapOffsetClock.Offset = realm.Run(r => r.Find<BeatmapInfo>(beatmap.BeatmapInfo.ID).UserSettings?.Offset) ?? 0;
 
             // sane default provided by ruleset.
             startOffset = gameplayStartTime;
@@ -161,9 +165,10 @@ namespace osu.Game.Screens.Play
             platformOffsetClock = new HardwareCorrectionOffsetClock(source, pauseFreqAdjust) { Offset = RuntimeInfo.OS == RuntimeInfo.Platform.Windows ? 15 : 0 };
 
             // the final usable gameplay clock with user-set offsets applied.
-            userOffsetClock = new HardwareCorrectionOffsetClock(platformOffsetClock, pauseFreqAdjust);
+            userGlobalOffsetClock = new HardwareCorrectionOffsetClock(platformOffsetClock, pauseFreqAdjust);
+            userBeatmapOffsetClock = new HardwareCorrectionOffsetClock(userGlobalOffsetClock, pauseFreqAdjust);
 
-            return masterGameplayClock = new MasterGameplayClock(userOffsetClock);
+            return masterGameplayClock = new MasterGameplayClock(userBeatmapOffsetClock);
         }
 
         /// <summary>
diff --git a/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs b/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
index 5d287a3730..75f8c89d34 100644
--- a/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
+++ b/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
@@ -1,9 +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.Game.Beatmaps;
+using osu.Game.Database;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Overlays.Settings;
 using osu.Game.Rulesets.Scoring;
@@ -60,16 +63,37 @@ namespace osu.Game.Screens.Play.PlayerSettings
                     },
                 }
             };
+        }
+
+        [Resolved]
+        private RealmAccess realm { get; set; }
+
+        [Resolved]
+        private IBindable<WorkingBeatmap> beatmap { get; set; }
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
 
             ReferenceScore.BindValueChanged(scoreChanged, true);
 
-            Current.BindValueChanged(offset =>
+            Current.BindValueChanged(currentChanged);
+            Current.Value = realm.Run(r => r.Find<BeatmapInfo>(beatmap.Value.BeatmapInfo.ID).UserSettings?.Offset) ?? 0;
+        }
+
+        private void currentChanged(ValueChangedEvent<double> offset)
+        {
+            if (useAverageButton != null)
             {
-                if (useAverageButton != null)
-                {
-                    useAverageButton.Enabled.Value = offset.NewValue != lastPlayAverage;
-                }
-            }, true);
+                useAverageButton.Enabled.Value = offset.NewValue != lastPlayAverage;
+            }
+
+            realm.Write(r =>
+            {
+                var settings = r.Find<BeatmapInfo>(beatmap.Value.BeatmapInfo.ID).UserSettings;
+
+                settings.Offset = offset.NewValue;
+            });
         }
 
         private void scoreChanged(ValueChangedEvent<ScoreInfo> score)

From 071ba5c1dfbf785d45a12713bf3a2d3d3121a710 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 1 Mar 2022 18:28:53 +0900
Subject: [PATCH 3128/5547] Make writes asynchronously to avoid synchronous
 overhead

---
 .../PlayerSettings/BeatmapOffsetControl.cs    | 29 +++++++++++++++----
 1 file changed, 23 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs b/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
index 75f8c89d34..2f2d1b81e5 100644
--- a/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
+++ b/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.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.Threading.Tasks;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
+using osu.Framework.Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Beatmaps;
@@ -78,9 +80,11 @@ namespace osu.Game.Screens.Play.PlayerSettings
             ReferenceScore.BindValueChanged(scoreChanged, true);
 
             Current.BindValueChanged(currentChanged);
-            Current.Value = realm.Run(r => r.Find<BeatmapInfo>(beatmap.Value.BeatmapInfo.ID).UserSettings?.Offset) ?? 0;
+            Current.Value = realm.Run(r => r.Find<BeatmapInfo>(beatmap.Value.BeatmapInfo.ID).UserSettings.Offset);
         }
 
+        private Task realmWrite;
+
         private void currentChanged(ValueChangedEvent<double> offset)
         {
             if (useAverageButton != null)
@@ -88,12 +92,25 @@ namespace osu.Game.Screens.Play.PlayerSettings
                 useAverageButton.Enabled.Value = offset.NewValue != lastPlayAverage;
             }
 
-            realm.Write(r =>
-            {
-                var settings = r.Find<BeatmapInfo>(beatmap.Value.BeatmapInfo.ID).UserSettings;
+            Scheduler.AddOnce(updateOffset);
 
-                settings.Offset = offset.NewValue;
-            });
+            void updateOffset()
+            {
+                // ensure the previous write has completed.
+                if (realmWrite?.IsCompleted == false)
+                {
+                    Scheduler.AddOnce(updateOffset);
+                    return;
+                }
+
+                realmWrite?.WaitSafely();
+                realmWrite = realm.WriteAsync(r =>
+                {
+                    var settings = r.Find<BeatmapInfo>(beatmap.Value.BeatmapInfo.ID).UserSettings;
+
+                    settings.Offset = offset.NewValue;
+                });
+            }
         }
 
         private void scoreChanged(ValueChangedEvent<ScoreInfo> score)

From bb8caabb8be3e0391fee7adede8f0bed09948737 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 1 Mar 2022 18:29:04 +0900
Subject: [PATCH 3129/5547] Subscribe to changes in offset

---
 .../Play/MasterGameplayClockContainer.cs      | 33 +++++++++++++++++--
 1 file changed, 30 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Screens/Play/MasterGameplayClockContainer.cs b/osu.Game/Screens/Play/MasterGameplayClockContainer.cs
index d27a989067..6a90e7adea 100644
--- a/osu.Game/Screens/Play/MasterGameplayClockContainer.cs
+++ b/osu.Game/Screens/Play/MasterGameplayClockContainer.cs
@@ -3,6 +3,7 @@
 
 using System;
 using System.Collections.Generic;
+using System.ComponentModel;
 using System.Linq;
 using osu.Framework;
 using osu.Framework.Allocation;
@@ -70,13 +71,38 @@ namespace osu.Game.Screens.Play
             firstHitObjectTime = beatmap.Beatmap.HitObjects.First().StartTime;
         }
 
-        [BackgroundDependencyLoader]
-        private void load(OsuConfigManager config, RealmAccess realm)
+        [Resolved]
+        private RealmAccess realm { get; set; }
+
+        [Resolved]
+        private OsuConfigManager config { get; set; }
+
+        private IDisposable beatmapOffsetSubscription;
+
+        protected override void LoadComplete()
         {
+            base.LoadComplete();
+
             userAudioOffset = config.GetBindable<double>(OsuSetting.AudioOffset);
             userAudioOffset.BindValueChanged(offset => userGlobalOffsetClock.Offset = offset.NewValue, true);
 
-            userBeatmapOffsetClock.Offset = realm.Run(r => r.Find<BeatmapInfo>(beatmap.BeatmapInfo.ID).UserSettings?.Offset) ?? 0;
+            beatmapOffsetSubscription = realm.RegisterCustomSubscription(r =>
+            {
+                var userSettings = r.Find<BeatmapInfo>(beatmap.BeatmapInfo.ID).UserSettings;
+
+                void onUserSettingsOnPropertyChanged(object sender, PropertyChangedEventArgs args)
+                {
+                    if (args.PropertyName == nameof(BeatmapUserSettings.Offset))
+                        updateOffset();
+                }
+
+                updateOffset();
+                userSettings.PropertyChanged += onUserSettingsOnPropertyChanged;
+
+                return new InvokeOnDisposal(() => userSettings.PropertyChanged -= onUserSettingsOnPropertyChanged);
+
+                void updateOffset() => userBeatmapOffsetClock.Offset = userSettings.Offset;
+            });
 
             // sane default provided by ruleset.
             startOffset = gameplayStartTime;
@@ -214,6 +240,7 @@ namespace osu.Game.Screens.Play
         protected override void Dispose(bool isDisposing)
         {
             base.Dispose(isDisposing);
+            beatmapOffsetSubscription?.Dispose();
             removeSourceClockAdjustments();
         }
 

From 99c1ba19aa22f5f88f21f136a27cb3b2c63a392f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 1 Mar 2022 19:13:40 +0900
Subject: [PATCH 3130/5547] Allow `BeatmapOffsetControl` to react to external
 changes to offset

---
 .../PlayerSettings/BeatmapOffsetControl.cs    | 47 ++++++++++++++-----
 1 file changed, 36 insertions(+), 11 deletions(-)

diff --git a/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs b/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
index 2f2d1b81e5..487d044f5b 100644
--- a/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
+++ b/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
@@ -1,12 +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.ComponentModel;
 using System.Threading.Tasks;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
-using osu.Framework.Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
+using osu.Framework.Utils;
 using osu.Game.Beatmaps;
 using osu.Game.Database;
 using osu.Game.Graphics.Sprites;
@@ -22,7 +24,7 @@ namespace osu.Game.Screens.Play.PlayerSettings
     {
         public Bindable<ScoreInfo> ReferenceScore { get; } = new Bindable<ScoreInfo>();
 
-        public Bindable<double> Current { get; } = new BindableDouble
+        public BindableDouble Current { get; } = new BindableDouble
         {
             Default = 0,
             Value = 0,
@@ -73,42 +75,59 @@ namespace osu.Game.Screens.Play.PlayerSettings
         [Resolved]
         private IBindable<WorkingBeatmap> beatmap { get; set; }
 
+        private IDisposable beatmapOffsetSubscription;
+
         protected override void LoadComplete()
         {
             base.LoadComplete();
 
             ReferenceScore.BindValueChanged(scoreChanged, true);
 
+            beatmapOffsetSubscription = realm.RegisterCustomSubscription(r =>
+            {
+                var userSettings = r.Find<BeatmapInfo>(beatmap.Value.BeatmapInfo.ID).UserSettings;
+
+                Current.Value = userSettings.Offset;
+                userSettings.PropertyChanged += onUserSettingsOnPropertyChanged;
+
+                return new InvokeOnDisposal(() => userSettings.PropertyChanged -= onUserSettingsOnPropertyChanged);
+
+                void onUserSettingsOnPropertyChanged(object sender, PropertyChangedEventArgs args)
+                {
+                    if (args.PropertyName == nameof(BeatmapUserSettings.Offset))
+                        Current.Value = userSettings.Offset;
+                }
+            });
+
             Current.BindValueChanged(currentChanged);
-            Current.Value = realm.Run(r => r.Find<BeatmapInfo>(beatmap.Value.BeatmapInfo.ID).UserSettings.Offset);
         }
 
         private Task realmWrite;
 
         private void currentChanged(ValueChangedEvent<double> offset)
         {
-            if (useAverageButton != null)
-            {
-                useAverageButton.Enabled.Value = offset.NewValue != lastPlayAverage;
-            }
-
             Scheduler.AddOnce(updateOffset);
 
             void updateOffset()
             {
-                // ensure the previous write has completed.
+                // ensure the previous write has completed. ignoring performance concerns, if we don't do this, the async writes could be out of sequence.
                 if (realmWrite?.IsCompleted == false)
                 {
                     Scheduler.AddOnce(updateOffset);
                     return;
                 }
 
-                realmWrite?.WaitSafely();
+                if (useAverageButton != null)
+                    useAverageButton.Enabled.Value = !Precision.AlmostEquals(lastPlayAverage, Current.Value, Current.Precision);
+
                 realmWrite = realm.WriteAsync(r =>
                 {
                     var settings = r.Find<BeatmapInfo>(beatmap.Value.BeatmapInfo.ID).UserSettings;
 
-                    settings.Offset = offset.NewValue;
+                    if (Precision.AlmostEquals(settings.Offset, Current.Value))
+                        return;
+
+                    settings.Offset = Current.Value;
                 });
             }
         }
@@ -142,5 +161,11 @@ namespace osu.Game.Screens.Play.PlayerSettings
                 },
             };
         }
+
+        protected override void Dispose(bool isDisposing)
+        {
+            base.Dispose(isDisposing);
+            beatmapOffsetSubscription?.Dispose();
+        }
     }
 }

From bc2a15db96f945cb0660617027901a4bb784da37 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 1 Mar 2022 19:20:18 +0900
Subject: [PATCH 3131/5547] Handle cases of beatmaps not existing in realm for
 tests

---
 osu.Game/Screens/Play/MasterGameplayClockContainer.cs  |  5 ++++-
 .../Play/PlayerSettings/BeatmapOffsetControl.cs        | 10 ++++++++--
 2 files changed, 12 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Screens/Play/MasterGameplayClockContainer.cs b/osu.Game/Screens/Play/MasterGameplayClockContainer.cs
index 6a90e7adea..c7c967abfd 100644
--- a/osu.Game/Screens/Play/MasterGameplayClockContainer.cs
+++ b/osu.Game/Screens/Play/MasterGameplayClockContainer.cs
@@ -88,7 +88,10 @@ namespace osu.Game.Screens.Play
 
             beatmapOffsetSubscription = realm.RegisterCustomSubscription(r =>
             {
-                var userSettings = r.Find<BeatmapInfo>(beatmap.BeatmapInfo.ID).UserSettings;
+                var userSettings = r.Find<BeatmapInfo>(beatmap.BeatmapInfo.ID)?.UserSettings;
+
+                if (userSettings == null) // only the case for tests.
+                    return null;
 
                 void onUserSettingsOnPropertyChanged(object sender, PropertyChangedEventArgs args)
                 {
diff --git a/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs b/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
index 487d044f5b..7fbaaaeffc 100644
--- a/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
+++ b/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
@@ -85,7 +85,10 @@ namespace osu.Game.Screens.Play.PlayerSettings
 
             beatmapOffsetSubscription = realm.RegisterCustomSubscription(r =>
             {
-                var userSettings = r.Find<BeatmapInfo>(beatmap.Value.BeatmapInfo.ID).UserSettings;
+                var userSettings = r.Find<BeatmapInfo>(beatmap.Value.BeatmapInfo.ID)?.UserSettings;
+
+                if (userSettings == null) // only the case for tests.
+                    return null;
 
                 Current.Value = userSettings.Offset;
                 userSettings.PropertyChanged += onUserSettingsOnPropertyChanged;
@@ -122,7 +125,10 @@ namespace osu.Game.Screens.Play.PlayerSettings
 
                 realmWrite = realm.WriteAsync(r =>
                 {
-                    var settings = r.Find<BeatmapInfo>(beatmap.Value.BeatmapInfo.ID).UserSettings;
+                    var settings = r.Find<BeatmapInfo>(beatmap.Value.BeatmapInfo.ID)?.UserSettings;
+
+                    if (settings == null) // only the case for tests.
+                        return;
 
                     if (Precision.AlmostEquals(settings.Offset, Current.Value))
                         return;

From 4d9efe771bd5aab0db19e057410a2d678b882ca5 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 1 Mar 2022 19:31:11 +0900
Subject: [PATCH 3132/5547] Don't display calibration options when the previous
 play was too short to be useful

---
 .../Gameplay/TestSceneBeatmapOffsetControl.cs | 14 ++++++
 .../PlayerSettings/BeatmapOffsetControl.cs    | 46 +++++++++++++++----
 2 files changed, 50 insertions(+), 10 deletions(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneBeatmapOffsetControl.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneBeatmapOffsetControl.cs
index 3fb10b2d5c..7704233adf 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneBeatmapOffsetControl.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneBeatmapOffsetControl.cs
@@ -33,6 +33,20 @@ namespace osu.Game.Tests.Visual.Gameplay
             });
         }
 
+        [Test]
+        public void TestTooShortToDisplay()
+        {
+            AddStep("Set short reference score", () =>
+            {
+                offsetControl.ReferenceScore.Value = new ScoreInfo
+                {
+                    HitEvents = TestSceneHitEventTimingDistributionGraph.CreateDistributedHitEvents(0, 2)
+                };
+            });
+
+            AddAssert("No calibration button", () => !offsetControl.ChildrenOfType<SettingsButton>().Any());
+        }
+
         [Test]
         public void TestDisplay()
         {
diff --git a/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs b/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
index 7fbaaaeffc..a8ed3f562b 100644
--- a/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
+++ b/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
@@ -11,6 +11,8 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Utils;
 using osu.Game.Beatmaps;
 using osu.Game.Database;
+using osu.Game.Graphics;
+using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Overlays.Settings;
 using osu.Game.Rulesets.Scoring;
@@ -75,6 +77,9 @@ namespace osu.Game.Screens.Play.PlayerSettings
         [Resolved]
         private IBindable<WorkingBeatmap> beatmap { get; set; }
 
+        [Resolved]
+        private OsuColour colours { get; set; }
+
         private IDisposable beatmapOffsetSubscription;
 
         protected override void LoadComplete()
@@ -140,32 +145,53 @@ namespace osu.Game.Screens.Play.PlayerSettings
 
         private void scoreChanged(ValueChangedEvent<ScoreInfo> score)
         {
-            if (!(score.NewValue?.HitEvents.CalculateAverageHitError() is double average))
-            {
-                referenceScoreContainer.Clear();
-                return;
-            }
+            var hitEvents = score.NewValue?.HitEvents;
 
-            lastPlayAverage = average;
+            referenceScoreContainer.Clear();
+
+            if (!(hitEvents?.CalculateAverageHitError() is double average))
+                return;
 
             referenceScoreContainer.Children = new Drawable[]
             {
                 new OsuSpriteText
                 {
-                    Text = "Last play:"
+                    Text = "Previous play:"
                 },
-                new HitEventTimingDistributionGraph(score.NewValue.HitEvents)
+            };
+
+            if (hitEvents.Count < 10)
+            {
+                referenceScoreContainer.AddRange(new Drawable[]
+                {
+                    new OsuTextFlowContainer
+                    {
+                        RelativeSizeAxes = Axes.X,
+                        AutoSizeAxes = Axes.Y,
+                        Colour = colours.Red1,
+                        Text = "Previous play too short to use for calibration"
+                    },
+                });
+
+                return;
+            }
+
+            lastPlayAverage = average;
+
+            referenceScoreContainer.AddRange(new Drawable[]
+            {
+                new HitEventTimingDistributionGraph(hitEvents)
                 {
                     RelativeSizeAxes = Axes.X,
                     Height = 50,
                 },
-                new AverageHitError(score.NewValue.HitEvents),
+                new AverageHitError(hitEvents),
                 useAverageButton = new SettingsButton
                 {
                     Text = "Calibrate using last play",
                     Action = () => Current.Value = lastPlayAverage
                 },
-            };
+            });
         }
 
         protected override void Dispose(bool isDisposing)

From 4aee57c9c1f4700116fc740ef6db0c1dddd40860 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 1 Mar 2022 19:33:30 +0900
Subject: [PATCH 3133/5547] Add localisation of all beatmap offset strings

---
 .../BeatmapOffsetControlStrings.cs            | 34 +++++++++++++++++++
 .../PlayerSettings/BeatmapOffsetControl.cs    |  9 ++---
 2 files changed, 39 insertions(+), 4 deletions(-)
 create mode 100644 osu.Game/Localisation/BeatmapOffsetControlStrings.cs

diff --git a/osu.Game/Localisation/BeatmapOffsetControlStrings.cs b/osu.Game/Localisation/BeatmapOffsetControlStrings.cs
new file mode 100644
index 0000000000..7b2a9e50b2
--- /dev/null
+++ b/osu.Game/Localisation/BeatmapOffsetControlStrings.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 osu.Framework.Localisation;
+
+namespace osu.Game.Localisation
+{
+    public static class BeatmapOffsetControlStrings
+    {
+        private const string prefix = @"osu.Game.Resources.Localisation.BeatmapOffsetControl";
+
+        /// <summary>
+        /// "Beatmap offset"
+        /// </summary>
+        public static LocalisableString BeatmapOffset => new TranslatableString(getKey(@"beatmap_offset"), @"Beatmap offset");
+
+        /// <summary>
+        /// "Previous play:"
+        /// </summary>
+        public static LocalisableString PreviousPlay => new TranslatableString(getKey(@"previous_play"), @"Previous play:");
+
+        /// <summary>
+        /// "Previous play too short to use for calibration"
+        /// </summary>
+        public static LocalisableString PreviousPlayTooShortToUseForCalibration => new TranslatableString(getKey(@"previous_play_too_short_to_use_for_calibration"), @"Previous play too short to use for calibration");
+
+        /// <summary>
+        /// "Calibrate using last play"
+        /// </summary>
+        public static LocalisableString CalibrateUsingLastPlay => new TranslatableString(getKey(@"calibrate_using_last_play"), @"Calibrate using last play");
+
+        private static string getKey(string key) => $@"{prefix}:{key}";
+    }
+}
\ No newline at end of file
diff --git a/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs b/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
index a8ed3f562b..864a46fc8f 100644
--- a/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
+++ b/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
@@ -19,6 +19,7 @@ using osu.Game.Rulesets.Scoring;
 using osu.Game.Scoring;
 using osu.Game.Screens.Ranking.Statistics;
 using osuTK;
+using osu.Game.Localisation;
 
 namespace osu.Game.Screens.Play.PlayerSettings
 {
@@ -57,7 +58,7 @@ namespace osu.Game.Screens.Play.PlayerSettings
                     new PlayerSliderBar<double>
                     {
                         KeyboardStep = 5,
-                        LabelText = "Beatmap offset",
+                        LabelText = BeatmapOffsetControlStrings.BeatmapOffset,
                         Current = Current,
                     },
                     referenceScoreContainer = new FillFlowContainer
@@ -156,7 +157,7 @@ namespace osu.Game.Screens.Play.PlayerSettings
             {
                 new OsuSpriteText
                 {
-                    Text = "Previous play:"
+                    Text = BeatmapOffsetControlStrings.PreviousPlay
                 },
             };
 
@@ -169,7 +170,7 @@ namespace osu.Game.Screens.Play.PlayerSettings
                         RelativeSizeAxes = Axes.X,
                         AutoSizeAxes = Axes.Y,
                         Colour = colours.Red1,
-                        Text = "Previous play too short to use for calibration"
+                        Text = BeatmapOffsetControlStrings.PreviousPlayTooShortToUseForCalibration
                     },
                 });
 
@@ -188,7 +189,7 @@ namespace osu.Game.Screens.Play.PlayerSettings
                 new AverageHitError(hitEvents),
                 useAverageButton = new SettingsButton
                 {
-                    Text = "Calibrate using last play",
+                    Text = BeatmapOffsetControlStrings.CalibrateUsingLastPlay,
                     Action = () => Current.Value = lastPlayAverage
                 },
             });

From 9792f0653ad46fe0b324fa16d341ede9f5f0d0d5 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 1 Mar 2022 19:41:51 +0900
Subject: [PATCH 3134/5547] Don't show calibration controls for autoplay

---
 .../Play/PlayerSettings/BeatmapOffsetControl.cs    | 14 +++++++++++---
 1 file changed, 11 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs b/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
index 864a46fc8f..1cd89f691e 100644
--- a/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
+++ b/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
@@ -3,6 +3,7 @@
 
 using System;
 using System.ComponentModel;
+using System.Linq;
 using System.Threading.Tasks;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
@@ -20,6 +21,7 @@ using osu.Game.Scoring;
 using osu.Game.Screens.Ranking.Statistics;
 using osuTK;
 using osu.Game.Localisation;
+using osu.Game.Rulesets.Mods;
 
 namespace osu.Game.Screens.Play.PlayerSettings
 {
@@ -146,11 +148,17 @@ namespace osu.Game.Screens.Play.PlayerSettings
 
         private void scoreChanged(ValueChangedEvent<ScoreInfo> score)
         {
-            var hitEvents = score.NewValue?.HitEvents;
-
             referenceScoreContainer.Clear();
 
-            if (!(hitEvents?.CalculateAverageHitError() is double average))
+            if (score.NewValue == null)
+                return;
+
+            if (score.NewValue.Mods.Any(m => m is ModAutoplay))
+                return;
+
+            var hitEvents = score.NewValue.HitEvents;
+
+            if (!(hitEvents.CalculateAverageHitError() is double average))
                 return;
 
             referenceScoreContainer.Children = new Drawable[]

From 7d11cfb301249b20f49ca9f150eaec936f5389fc Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 1 Mar 2022 19:51:15 +0900
Subject: [PATCH 3135/5547] Add detach mapping for `BeatmapUserSettings`

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

diff --git a/osu.Game/Database/RealmObjectExtensions.cs b/osu.Game/Database/RealmObjectExtensions.cs
index f89bbbe19d..6dc18df9e0 100644
--- a/osu.Game/Database/RealmObjectExtensions.cs
+++ b/osu.Game/Database/RealmObjectExtensions.cs
@@ -38,6 +38,7 @@ namespace osu.Game.Database
             c.CreateMap<BeatmapInfo, BeatmapInfo>()
              .ForMember(s => s.Ruleset, cc => cc.Ignore())
              .ForMember(s => s.Metadata, cc => cc.Ignore())
+             .ForMember(s => s.UserSettings, cc => cc.Ignore())
              .ForMember(s => s.Difficulty, cc => cc.Ignore())
              .ForMember(s => s.BeatmapSet, cc => cc.Ignore())
              .AfterMap((s, d) =>
@@ -154,6 +155,7 @@ namespace osu.Game.Database
 
             c.CreateMap<RealmKeyBinding, RealmKeyBinding>();
             c.CreateMap<BeatmapMetadata, BeatmapMetadata>();
+            c.CreateMap<BeatmapUserSettings, BeatmapUserSettings>();
             c.CreateMap<BeatmapDifficulty, BeatmapDifficulty>();
             c.CreateMap<RulesetInfo, RulesetInfo>();
             c.CreateMap<ScoreInfo, ScoreInfo>();

From 6c09237956c6535c54c37ef4ee2877af3cd0f10a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 1 Mar 2022 19:57:09 +0900
Subject: [PATCH 3136/5547] Reorder fields in `BeatmapOffsetControl` and
 `MasterGameplayClockContainer`

---
 .../Play/MasterGameplayClockContainer.cs      | 16 +++++++-------
 .../PlayerSettings/BeatmapOffsetControl.cs    | 22 +++++++++----------
 2 files changed, 19 insertions(+), 19 deletions(-)

diff --git a/osu.Game/Screens/Play/MasterGameplayClockContainer.cs b/osu.Game/Screens/Play/MasterGameplayClockContainer.cs
index c7c967abfd..2b6db5f59e 100644
--- a/osu.Game/Screens/Play/MasterGameplayClockContainer.cs
+++ b/osu.Game/Screens/Play/MasterGameplayClockContainer.cs
@@ -61,6 +61,14 @@ namespace osu.Game.Screens.Play
         private Bindable<double> userAudioOffset;
         private double startOffset;
 
+        private IDisposable beatmapOffsetSubscription;
+
+        [Resolved]
+        private RealmAccess realm { get; set; }
+
+        [Resolved]
+        private OsuConfigManager config { get; set; }
+
         public MasterGameplayClockContainer(WorkingBeatmap beatmap, double gameplayStartTime, bool startAtGameplayStart = false)
             : base(beatmap.Track)
         {
@@ -71,14 +79,6 @@ namespace osu.Game.Screens.Play
             firstHitObjectTime = beatmap.Beatmap.HitObjects.First().StartTime;
         }
 
-        [Resolved]
-        private RealmAccess realm { get; set; }
-
-        [Resolved]
-        private OsuConfigManager config { get; set; }
-
-        private IDisposable beatmapOffsetSubscription;
-
         protected override void LoadComplete()
         {
             base.LoadComplete();
diff --git a/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs b/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
index 1cd89f691e..02359afd16 100644
--- a/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
+++ b/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
@@ -44,6 +44,17 @@ namespace osu.Game.Screens.Play.PlayerSettings
 
         private readonly FillFlowContainer referenceScoreContainer;
 
+        private IDisposable beatmapOffsetSubscription;
+
+        [Resolved]
+        private RealmAccess realm { get; set; }
+
+        [Resolved]
+        private IBindable<WorkingBeatmap> beatmap { get; set; }
+
+        [Resolved]
+        private OsuColour colours { get; set; }
+
         public BeatmapOffsetControl()
         {
             RelativeSizeAxes = Axes.X;
@@ -74,17 +85,6 @@ namespace osu.Game.Screens.Play.PlayerSettings
             };
         }
 
-        [Resolved]
-        private RealmAccess realm { get; set; }
-
-        [Resolved]
-        private IBindable<WorkingBeatmap> beatmap { get; set; }
-
-        [Resolved]
-        private OsuColour colours { get; set; }
-
-        private IDisposable beatmapOffsetSubscription;
-
         protected override void LoadComplete()
         {
             base.LoadComplete();

From 222f50d2119b9041c430ba7f4a54ab4c87d86dfe Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 1 Mar 2022 20:41:54 +0900
Subject: [PATCH 3137/5547] Fix calibration being back-to-front

---
 osu.Game.Tests/Visual/Gameplay/TestSceneBeatmapOffsetControl.cs | 2 +-
 osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs    | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneBeatmapOffsetControl.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneBeatmapOffsetControl.cs
index 7704233adf..42b579bc89 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneBeatmapOffsetControl.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneBeatmapOffsetControl.cs
@@ -64,7 +64,7 @@ namespace osu.Game.Tests.Visual.Gameplay
 
             AddAssert("Has calibration button", () => offsetControl.ChildrenOfType<SettingsButton>().Any());
             AddStep("Press button", () => offsetControl.ChildrenOfType<SettingsButton>().Single().TriggerClick());
-            AddAssert("Offset is adjusted", () => offsetControl.Current.Value == average_error);
+            AddAssert("Offset is adjusted", () => offsetControl.Current.Value == -average_error);
 
             AddStep("Remove reference score", () => offsetControl.ReferenceScore.Value = null);
             AddAssert("No calibration button", () => !offsetControl.ChildrenOfType<SettingsButton>().Any());
diff --git a/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs b/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
index 02359afd16..e6bc510564 100644
--- a/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
+++ b/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
@@ -198,7 +198,7 @@ namespace osu.Game.Screens.Play.PlayerSettings
                 useAverageButton = new SettingsButton
                 {
                     Text = BeatmapOffsetControlStrings.CalibrateUsingLastPlay,
-                    Action = () => Current.Value = lastPlayAverage
+                    Action = () => Current.Value = -lastPlayAverage
                 },
             });
         }

From 2767dda9d63bf11a9eff75737cd47b53bb705649 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Tue, 1 Mar 2022 20:21:32 +0300
Subject: [PATCH 3138/5547] Add failing test case

---
 .../Visual/Ranking/TestSceneResultsScreen.cs  | 25 +++++++++++++++++++
 1 file changed, 25 insertions(+)

diff --git a/osu.Game.Tests/Visual/Ranking/TestSceneResultsScreen.cs b/osu.Game.Tests/Visual/Ranking/TestSceneResultsScreen.cs
index 167acc94c4..cc380df183 100644
--- a/osu.Game.Tests/Visual/Ranking/TestSceneResultsScreen.cs
+++ b/osu.Game.Tests/Visual/Ranking/TestSceneResultsScreen.cs
@@ -17,10 +17,13 @@ using osu.Game.Database;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Online.API;
 using osu.Game.Rulesets;
+using osu.Game.Rulesets.Difficulty;
+using osu.Game.Rulesets.Osu;
 using osu.Game.Scoring;
 using osu.Game.Screens;
 using osu.Game.Screens.Play;
 using osu.Game.Screens.Ranking;
+using osu.Game.Screens.Ranking.Expanded.Statistics;
 using osu.Game.Screens.Ranking.Statistics;
 using osu.Game.Tests.Resources;
 using osuTK;
@@ -256,6 +259,23 @@ namespace osu.Game.Tests.Visual.Ranking
             AddAssert("download button is enabled", () => screen.ChildrenOfType<DownloadButton>().Last().Enabled.Value);
         }
 
+        [Test]
+        public void TestRulesetWithNoPerformanceCalculator()
+        {
+            var ruleset = new RulesetWithNoPerformanceCalculator();
+            var score = TestResources.CreateTestScoreInfo(ruleset.RulesetInfo);
+
+            AddStep("load results", () => Child = new TestResultsContainer(createResultsScreen(score)));
+            AddUntilStep("wait for load", () => this.ChildrenOfType<ScorePanelList>().Single().AllPanelsVisible);
+
+            AddAssert("PP displayed as 0", () =>
+            {
+                var performance = this.ChildrenOfType<PerformanceStatistic>().Single();
+                var counter = performance.ChildrenOfType<StatisticCounter>().Single();
+                return counter.Current.Value == 0;
+            });
+        }
+
         private TestResultsScreen createResultsScreen(ScoreInfo score = null) => new TestResultsScreen(score ?? TestResources.CreateTestScoreInfo());
 
         private UnrankedSoloResultsScreen createUnrankedSoloResultsScreen() => new UnrankedSoloResultsScreen(TestResources.CreateTestScoreInfo());
@@ -367,5 +387,10 @@ namespace osu.Game.Tests.Visual.Ranking
                 RetryOverlay = InternalChildren.OfType<HotkeyRetryOverlay>().SingleOrDefault();
             }
         }
+
+        private class RulesetWithNoPerformanceCalculator : OsuRuleset
+        {
+            public override PerformanceCalculator CreatePerformanceCalculator(DifficultyAttributes attributes, ScoreInfo score) => null;
+        }
     }
 }

From 97c54de3bff4787aa8161b4a33dd53500dd3bfdc Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Tue, 1 Mar 2022 20:43:20 +0300
Subject: [PATCH 3139/5547] Fix performance statistic not handling rulesets
 with unimplemented calculator

---
 .../Screens/Ranking/Expanded/Statistics/PerformanceStatistic.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatistic.cs b/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatistic.cs
index 859b42d66d..95f017d625 100644
--- a/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatistic.cs
+++ b/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatistic.cs
@@ -38,7 +38,7 @@ namespace osu.Game.Screens.Ranking.Expanded.Statistics
             else
             {
                 performanceCache.CalculatePerformanceAsync(score, cancellationTokenSource.Token)
-                                .ContinueWith(t => Schedule(() => setPerformanceValue(t.GetResultSafely().Total)), cancellationTokenSource.Token);
+                                .ContinueWith(t => Schedule(() => setPerformanceValue(t.GetResultSafely()?.Total)), cancellationTokenSource.Token);
             }
         }
 

From c9b205afeb64f721e228ee51adb8eabc0cb93327 Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Tue, 1 Mar 2022 21:12:06 +0800
Subject: [PATCH 3140/5547] Add adaptive speed mod

---
 osu.Game.Rulesets.Mania/ManiaRuleset.cs    |   1 +
 osu.Game.Rulesets.Osu/OsuRuleset.cs        |   1 +
 osu.Game.Rulesets.Taiko/TaikoRuleset.cs    |   1 +
 osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs | 122 +++++++++++++++++++++
 osu.Game/Rulesets/Mods/ModRateAdjust.cs    |   2 +-
 osu.Game/Rulesets/Mods/ModTimeRamp.cs      |   2 +-
 6 files changed, 127 insertions(+), 2 deletions(-)
 create mode 100644 osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs

diff --git a/osu.Game.Rulesets.Mania/ManiaRuleset.cs b/osu.Game.Rulesets.Mania/ManiaRuleset.cs
index 859b6cfe76..f139a88f50 100644
--- a/osu.Game.Rulesets.Mania/ManiaRuleset.cs
+++ b/osu.Game.Rulesets.Mania/ManiaRuleset.cs
@@ -258,6 +258,7 @@ namespace osu.Game.Rulesets.Mania
                     {
                         new MultiMod(new ModWindUp(), new ModWindDown()),
                         new ManiaModMuted(),
+                        new ModAdaptiveSpeed()
                     };
 
                 default:
diff --git a/osu.Game.Rulesets.Osu/OsuRuleset.cs b/osu.Game.Rulesets.Osu/OsuRuleset.cs
index 5ade164566..5b936b1bf1 100644
--- a/osu.Game.Rulesets.Osu/OsuRuleset.cs
+++ b/osu.Game.Rulesets.Osu/OsuRuleset.cs
@@ -195,6 +195,7 @@ namespace osu.Game.Rulesets.Osu
                         new OsuModMuted(),
                         new OsuModNoScope(),
                         new OsuModAimAssist(),
+                        new ModAdaptiveSpeed()
                     };
 
                 case ModType.System:
diff --git a/osu.Game.Rulesets.Taiko/TaikoRuleset.cs b/osu.Game.Rulesets.Taiko/TaikoRuleset.cs
index de0ef8d95b..dc90845d92 100644
--- a/osu.Game.Rulesets.Taiko/TaikoRuleset.cs
+++ b/osu.Game.Rulesets.Taiko/TaikoRuleset.cs
@@ -151,6 +151,7 @@ namespace osu.Game.Rulesets.Taiko
                     {
                         new MultiMod(new ModWindUp(), new ModWindDown()),
                         new TaikoModMuted(),
+                        new ModAdaptiveSpeed()
                     };
 
                 default:
diff --git a/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs b/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs
new file mode 100644
index 0000000000..1c6fbe88cc
--- /dev/null
+++ b/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs
@@ -0,0 +1,122 @@
+// 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.Audio;
+using osu.Framework.Audio.Track;
+using osu.Framework.Bindables;
+using osu.Framework.Graphics.Audio;
+using osu.Framework.Utils;
+using osu.Game.Beatmaps;
+using osu.Game.Configuration;
+using osu.Game.Rulesets.Objects;
+using osu.Game.Rulesets.Objects.Drawables;
+
+namespace osu.Game.Rulesets.Mods
+{
+    public class ModAdaptiveSpeed : Mod, IApplicableToRate, IApplicableToDrawableHitObject, IApplicableToBeatmap
+    {
+        private const double fastest_rate = 2f;
+
+        private const double slowest_rate = 0.5f;
+
+        /// <summary>
+        /// Adjust track rate using the average speed of the last x hits
+        /// </summary>
+        private const int average_count = 10;
+
+        public override string Name => "Adaptive Speed";
+
+        public override string Acronym => "AS";
+
+        public override string Description => "Let track speed adapt to you.";
+
+        public override ModType Type => ModType.Fun;
+
+        public override double ScoreMultiplier => 1;
+
+        public override Type[] IncompatibleMods => new[] { typeof(ModRateAdjust), typeof(ModTimeRamp) };
+
+        [SettingSource("Adjust pitch", "Should pitch be adjusted with speed")]
+        public BindableBool AdjustPitch { get; } = new BindableBool
+        {
+            Default = true,
+            Value = true
+        };
+
+        public BindableNumber<double> SpeedChange { get; } = new BindableDouble
+        {
+            Default = 1,
+            Value = 1,
+            Precision = 0.01,
+        };
+
+        private ITrack track;
+
+        private readonly List<double> recentRates = Enumerable.Range(0, average_count).Select(x => 1d).ToList();
+
+        // rates are calculated using the end time of the previous hit object
+        // caching them here for easy access
+        private readonly Dictionary<HitObject, double> previousEndTimes = new Dictionary<HitObject, double>();
+
+        public ModAdaptiveSpeed()
+        {
+            AdjustPitch.BindValueChanged(applyPitchAdjustment);
+        }
+
+        public void ApplyToTrack(ITrack track)
+        {
+            this.track = track;
+
+            AdjustPitch.TriggerChange();
+        }
+
+        public void ApplyToSample(DrawableSample sample)
+        {
+            sample.AddAdjustment(AdjustableProperty.Frequency, SpeedChange);
+        }
+
+        public double ApplyToRate(double time, double rate = 1) => rate;
+
+        private void applyPitchAdjustment(ValueChangedEvent<bool> adjustPitchSetting)
+        {
+            // remove existing old adjustment
+            track?.RemoveAdjustment(adjustmentForPitchSetting(adjustPitchSetting.OldValue), SpeedChange);
+
+            track?.AddAdjustment(adjustmentForPitchSetting(adjustPitchSetting.NewValue), SpeedChange);
+        }
+
+        private AdjustableProperty adjustmentForPitchSetting(bool adjustPitchSettingValue)
+            => adjustPitchSettingValue ? AdjustableProperty.Frequency : AdjustableProperty.Tempo;
+
+        public void ApplyToDrawableHitObject(DrawableHitObject drawable)
+        {
+            drawable.OnNewResult += (o, result) =>
+            {
+                if (!result.IsHit) return;
+                if (!previousEndTimes.ContainsKey(result.HitObject)) return;
+
+                double prevEndTime = previousEndTimes[result.HitObject];
+
+                recentRates.Add(Math.Clamp((result.HitObject.GetEndTime() - prevEndTime) / (result.TimeAbsolute - prevEndTime) * SpeedChange.Value, slowest_rate, fastest_rate));
+                if (recentRates.Count > average_count)
+                    recentRates.RemoveAt(0);
+
+                SpeedChange.Value = recentRates.Average();
+            };
+        }
+
+        public void ApplyToBeatmap(IBeatmap beatmap)
+        {
+            for (int i = 1; i < beatmap.HitObjects.Count; i++)
+            {
+                var hitObject = beatmap.HitObjects[i];
+                var previousObject = beatmap.HitObjects.Take(i).LastOrDefault(o => !Precision.AlmostBigger(o.GetEndTime(), hitObject.GetEndTime()));
+
+                if (previousObject != null)
+                    previousEndTimes.Add(hitObject, previousObject.GetEndTime());
+            }
+        }
+    }
+}
diff --git a/osu.Game/Rulesets/Mods/ModRateAdjust.cs b/osu.Game/Rulesets/Mods/ModRateAdjust.cs
index e66650f7b4..ebe18f2188 100644
--- a/osu.Game/Rulesets/Mods/ModRateAdjust.cs
+++ b/osu.Game/Rulesets/Mods/ModRateAdjust.cs
@@ -25,7 +25,7 @@ namespace osu.Game.Rulesets.Mods
 
         public double ApplyToRate(double time, double rate) => rate * SpeedChange.Value;
 
-        public override Type[] IncompatibleMods => new[] { typeof(ModTimeRamp) };
+        public override Type[] IncompatibleMods => new[] { typeof(ModTimeRamp), typeof(ModAdaptiveSpeed) };
 
         public override string SettingDescription => SpeedChange.IsDefault ? string.Empty : $"{SpeedChange.Value:N2}x";
     }
diff --git a/osu.Game/Rulesets/Mods/ModTimeRamp.cs b/osu.Game/Rulesets/Mods/ModTimeRamp.cs
index b5cd64dafa..b6b2decede 100644
--- a/osu.Game/Rulesets/Mods/ModTimeRamp.cs
+++ b/osu.Game/Rulesets/Mods/ModTimeRamp.cs
@@ -30,7 +30,7 @@ namespace osu.Game.Rulesets.Mods
         [SettingSource("Adjust pitch", "Should pitch be adjusted with speed")]
         public abstract BindableBool AdjustPitch { get; }
 
-        public override Type[] IncompatibleMods => new[] { typeof(ModRateAdjust) };
+        public override Type[] IncompatibleMods => new[] { typeof(ModRateAdjust), typeof(ModAdaptiveSpeed) };
 
         public override string SettingDescription => $"{InitialRate.Value:N2}x to {FinalRate.Value:N2}x";
 

From 783f43ccfbc53199f7f88b37c4bea8cbd486345f Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Tue, 1 Mar 2022 21:50:17 +0800
Subject: [PATCH 3141/5547] Add initial rate setting

---
 osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs | 16 +++++++++++++++-
 1 file changed, 15 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs b/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs
index 1c6fbe88cc..8847420995 100644
--- a/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs
+++ b/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs
@@ -38,6 +38,16 @@ namespace osu.Game.Rulesets.Mods
 
         public override Type[] IncompatibleMods => new[] { typeof(ModRateAdjust), typeof(ModTimeRamp) };
 
+        [SettingSource("Initial rate", "The starting speed of the track")]
+        public BindableNumber<double> InitialRate { get; } = new BindableDouble
+        {
+            MinValue = 0.5,
+            MaxValue = 2,
+            Default = 1,
+            Value = 1,
+            Precision = 0.01,
+        };
+
         [SettingSource("Adjust pitch", "Should pitch be adjusted with speed")]
         public BindableBool AdjustPitch { get; } = new BindableBool
         {
@@ -54,7 +64,7 @@ namespace osu.Game.Rulesets.Mods
 
         private ITrack track;
 
-        private readonly List<double> recentRates = Enumerable.Range(0, average_count).Select(x => 1d).ToList();
+        private readonly List<double> recentRates = Enumerable.Range(0, average_count).Select(_ => 1d).ToList();
 
         // rates are calculated using the end time of the previous hit object
         // caching them here for easy access
@@ -62,6 +72,7 @@ namespace osu.Game.Rulesets.Mods
 
         public ModAdaptiveSpeed()
         {
+            InitialRate.BindValueChanged(val => SpeedChange.Value = val.NewValue);
             AdjustPitch.BindValueChanged(applyPitchAdjustment);
         }
 
@@ -69,7 +80,10 @@ namespace osu.Game.Rulesets.Mods
         {
             this.track = track;
 
+            InitialRate.TriggerChange();
             AdjustPitch.TriggerChange();
+            recentRates.Clear();
+            recentRates.AddRange(Enumerable.Range(0, average_count).Select(_ => InitialRate.Value));
         }
 
         public void ApplyToSample(DrawableSample sample)

From c6934b4bce3d6a68ff82da111dacb38731bde479 Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Wed, 2 Mar 2022 09:53:28 +0800
Subject: [PATCH 3142/5547] Improve adaptive speed algorithm and add rewind
 support

---
 osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs | 63 ++++++++++++++++++----
 1 file changed, 53 insertions(+), 10 deletions(-)

diff --git a/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs b/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs
index 8847420995..9a6705ea09 100644
--- a/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs
+++ b/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs
@@ -1,5 +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.Linq;
@@ -12,14 +13,15 @@ using osu.Game.Beatmaps;
 using osu.Game.Configuration;
 using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Objects.Drawables;
+using osu.Game.Rulesets.Scoring;
 
 namespace osu.Game.Rulesets.Mods
 {
     public class ModAdaptiveSpeed : Mod, IApplicableToRate, IApplicableToDrawableHitObject, IApplicableToBeatmap
     {
-        private const double fastest_rate = 2f;
-
-        private const double slowest_rate = 0.5f;
+        // use a wider range so there's still room for adjustment when the initial rate is extreme
+        private const double fastest_rate = 2.5f;
+        private const double slowest_rate = 0.4f;
 
         /// <summary>
         /// Adjust track rate using the average speed of the last x hits
@@ -45,7 +47,7 @@ namespace osu.Game.Rulesets.Mods
             MaxValue = 2,
             Default = 1,
             Value = 1,
-            Precision = 0.01,
+            Precision = 0.01
         };
 
         [SettingSource("Adjust pitch", "Should pitch be adjusted with speed")]
@@ -59,17 +61,21 @@ namespace osu.Game.Rulesets.Mods
         {
             Default = 1,
             Value = 1,
-            Precision = 0.01,
+            Precision = 0.01
         };
 
         private ITrack track;
 
         private readonly List<double> recentRates = Enumerable.Range(0, average_count).Select(_ => 1d).ToList();
 
-        // rates are calculated using the end time of the previous hit object
+        // rate for a hit is calculated using the end time of another hit object earlier in time
         // caching them here for easy access
         private readonly Dictionary<HitObject, double> previousEndTimes = new Dictionary<HitObject, double>();
 
+        // record the value removed from recentRates when an object is hit
+        // for rewind support
+        private readonly Dictionary<HitObject, double> dequeuedRates = new Dictionary<HitObject, double>();
+
         public ModAdaptiveSpeed()
         {
             InitialRate.BindValueChanged(val => SpeedChange.Value = val.NewValue);
@@ -91,7 +97,7 @@ namespace osu.Game.Rulesets.Mods
             sample.AddAdjustment(AdjustableProperty.Frequency, SpeedChange);
         }
 
-        public double ApplyToRate(double time, double rate = 1) => rate;
+        public double ApplyToRate(double time, double rate = 1) => rate * InitialRate.Value;
 
         private void applyPitchAdjustment(ValueChangedEvent<bool> adjustPitchSetting)
         {
@@ -114,8 +120,31 @@ namespace osu.Game.Rulesets.Mods
                 double prevEndTime = previousEndTimes[result.HitObject];
 
                 recentRates.Add(Math.Clamp((result.HitObject.GetEndTime() - prevEndTime) / (result.TimeAbsolute - prevEndTime) * SpeedChange.Value, slowest_rate, fastest_rate));
+
                 if (recentRates.Count > average_count)
+                {
+                    dequeuedRates.Add(result.HitObject, recentRates[0]);
                     recentRates.RemoveAt(0);
+                }
+
+                SpeedChange.Value = recentRates.Average();
+            };
+            drawable.OnRevertResult += (o, result) =>
+            {
+                if (!result.IsHit) return;
+                if (!previousEndTimes.ContainsKey(result.HitObject)) return;
+
+                if (dequeuedRates.ContainsKey(result.HitObject))
+                {
+                    recentRates.Insert(0, dequeuedRates[result.HitObject]);
+                    recentRates.RemoveAt(recentRates.Count - 1);
+                    dequeuedRates.Remove(result.HitObject);
+                }
+                else
+                {
+                    recentRates.Insert(0, InitialRate.Value);
+                    recentRates.RemoveAt(recentRates.Count - 1);
+                }
 
                 SpeedChange.Value = recentRates.Average();
             };
@@ -123,13 +152,27 @@ namespace osu.Game.Rulesets.Mods
 
         public void ApplyToBeatmap(IBeatmap beatmap)
         {
+            var endTimes = getEndTimes(beatmap.HitObjects).OrderBy(x => x).ToList();
+
             for (int i = 1; i < beatmap.HitObjects.Count; i++)
             {
                 var hitObject = beatmap.HitObjects[i];
-                var previousObject = beatmap.HitObjects.Take(i).LastOrDefault(o => !Precision.AlmostBigger(o.GetEndTime(), hitObject.GetEndTime()));
+                double prevEndTime = endTimes.LastOrDefault(ht => !Precision.AlmostBigger(ht, hitObject.GetEndTime()));
 
-                if (previousObject != null)
-                    previousEndTimes.Add(hitObject, previousObject.GetEndTime());
+                if (prevEndTime != default)
+                    previousEndTimes.Add(hitObject, prevEndTime);
+            }
+        }
+
+        private IEnumerable<double> getEndTimes(IEnumerable<HitObject> hitObjects)
+        {
+            foreach (var hitObject in hitObjects)
+            {
+                if (!(hitObject.HitWindows is HitWindows.EmptyHitWindows))
+                    yield return hitObject.GetEndTime();
+
+                foreach (double hitTime in getEndTimes(hitObject.NestedHitObjects))
+                    yield return hitTime;
             }
         }
     }

From c342030b2c084790724021aca3b0b3557c54fb76 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 2 Mar 2022 14:10:59 +0900
Subject: [PATCH 3143/5547] Add specific placeholder message for custom
 rulesets rather than showing network error

---
 .../Visual/SongSelect/TestSceneBeatmapLeaderboard.cs  |  3 ++-
 osu.Game/Online/Leaderboards/Leaderboard.cs           |  5 ++++-
 osu.Game/Online/Leaderboards/LeaderboardState.cs      |  3 ++-
 .../Screens/Select/Leaderboards/BeatmapLeaderboard.cs | 11 +++++++++--
 4 files changed, 17 insertions(+), 5 deletions(-)

diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
index 31bd3a203c..1ed6648131 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
@@ -119,7 +119,8 @@ namespace osu.Game.Tests.Visual.SongSelect
             AddStep(@"Network failure", () => leaderboard.SetErrorState(LeaderboardState.NetworkFailure));
             AddStep(@"No supporter", () => leaderboard.SetErrorState(LeaderboardState.NotSupporter));
             AddStep(@"Not logged in", () => leaderboard.SetErrorState(LeaderboardState.NotLoggedIn));
-            AddStep(@"Unavailable", () => leaderboard.SetErrorState(LeaderboardState.Unavailable));
+            AddStep(@"Ruleset unavailable", () => leaderboard.SetErrorState(LeaderboardState.RulesetUnavailable));
+            AddStep(@"Beatmap unavailable", () => leaderboard.SetErrorState(LeaderboardState.BeatmapUnavailable));
             AddStep(@"None selected", () => leaderboard.SetErrorState(LeaderboardState.NoneSelected));
         }
 
diff --git a/osu.Game/Online/Leaderboards/Leaderboard.cs b/osu.Game/Online/Leaderboards/Leaderboard.cs
index 5dd3e46b4a..dde53c39e4 100644
--- a/osu.Game/Online/Leaderboards/Leaderboard.cs
+++ b/osu.Game/Online/Leaderboards/Leaderboard.cs
@@ -319,7 +319,10 @@ namespace osu.Game.Online.Leaderboards
                 case LeaderboardState.NoneSelected:
                     return new MessagePlaceholder(@"Please select a beatmap!");
 
-                case LeaderboardState.Unavailable:
+                case LeaderboardState.RulesetUnavailable:
+                    return new MessagePlaceholder(@"Leaderboards are not available for this ruleset!");
+
+                case LeaderboardState.BeatmapUnavailable:
                     return new MessagePlaceholder(@"Leaderboards are not available for this beatmap!");
 
                 case LeaderboardState.NoScores:
diff --git a/osu.Game/Online/Leaderboards/LeaderboardState.cs b/osu.Game/Online/Leaderboards/LeaderboardState.cs
index 75e2c6e6db..6b07500a98 100644
--- a/osu.Game/Online/Leaderboards/LeaderboardState.cs
+++ b/osu.Game/Online/Leaderboards/LeaderboardState.cs
@@ -8,7 +8,8 @@ namespace osu.Game.Online.Leaderboards
         Success,
         Retrieving,
         NetworkFailure,
-        Unavailable,
+        BeatmapUnavailable,
+        RulesetUnavailable,
         NoneSelected,
         NoScores,
         NotLoggedIn,
diff --git a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
index 907a2c9bda..6daaae9d04 100644
--- a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
+++ b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
@@ -98,6 +98,7 @@ namespace osu.Game.Screens.Select.Leaderboards
         protected override APIRequest FetchScores(CancellationToken cancellationToken)
         {
             var fetchBeatmapInfo = BeatmapInfo;
+            var fetchRuleset = ruleset.Value ?? fetchBeatmapInfo.Ruleset;
 
             if (fetchBeatmapInfo == null)
             {
@@ -117,9 +118,15 @@ namespace osu.Game.Screens.Select.Leaderboards
                 return null;
             }
 
+            if (fetchRuleset.OnlineID <= 0 || fetchRuleset.OnlineID > ILegacyRuleset.MAX_LEGACY_RULESET_ID)
+            {
+                SetErrorState(LeaderboardState.RulesetUnavailable);
+                return null;
+            }
+
             if (fetchBeatmapInfo.OnlineID <= 0 || fetchBeatmapInfo.Status <= BeatmapOnlineStatus.Pending)
             {
-                SetErrorState(LeaderboardState.Unavailable);
+                SetErrorState(LeaderboardState.BeatmapUnavailable);
                 return null;
             }
 
@@ -137,7 +144,7 @@ namespace osu.Game.Screens.Select.Leaderboards
             else if (filterMods)
                 requestMods = mods.Value;
 
-            var req = new GetScoresRequest(fetchBeatmapInfo, ruleset.Value ?? fetchBeatmapInfo.Ruleset, Scope, requestMods);
+            var req = new GetScoresRequest(fetchBeatmapInfo, fetchRuleset, Scope, requestMods);
 
             req.Success += r =>
             {

From d4a2645510d2a7e133d60a664d7950244e9dedaa Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 2 Mar 2022 14:14:44 +0900
Subject: [PATCH 3144/5547] Add localisation support for leaderboard error text

---
 osu.Game/Localisation/LeaderboardStrings.cs   | 49 +++++++++++++++++++
 osu.Game/Online/Leaderboards/Leaderboard.cs   | 15 +++---
 .../Online/Placeholders/LoginPlaceholder.cs   |  3 +-
 3 files changed, 59 insertions(+), 8 deletions(-)
 create mode 100644 osu.Game/Localisation/LeaderboardStrings.cs

diff --git a/osu.Game/Localisation/LeaderboardStrings.cs b/osu.Game/Localisation/LeaderboardStrings.cs
new file mode 100644
index 0000000000..8e53f8e88c
--- /dev/null
+++ b/osu.Game/Localisation/LeaderboardStrings.cs
@@ -0,0 +1,49 @@
+// 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 LeaderboardStrings
+    {
+        private const string prefix = @"osu.Game.Resources.Localisation.Leaderboard";
+
+        /// <summary>
+        /// "Couldn't fetch scores!"
+        /// </summary>
+        public static LocalisableString CouldntFetchScores => new TranslatableString(getKey(@"couldnt_fetch_scores"), @"Couldn't fetch scores!");
+
+        /// <summary>
+        /// "Please select a beatmap!"
+        /// </summary>
+        public static LocalisableString PleaseSelectABeatmap => new TranslatableString(getKey(@"please_select_a_beatmap"), @"Please select a beatmap!");
+
+        /// <summary>
+        /// "Leaderboards are not available for this ruleset!"
+        /// </summary>
+        public static LocalisableString LeaderboardsAreNotAvailableForThisRuleset => new TranslatableString(getKey(@"leaderboards_are_not_available_for_this_ruleset"), @"Leaderboards are not available for this ruleset!");
+
+        /// <summary>
+        /// "Leaderboards are not available for this beatmap!"
+        /// </summary>
+        public static LocalisableString LeaderboardsAreNotAvailableForThisBeatmap => new TranslatableString(getKey(@"leaderboards_are_not_available_for_this_beatmap"), @"Leaderboards are not available for this beatmap!");
+
+        /// <summary>
+        /// "No records yet!"
+        /// </summary>
+        public static LocalisableString NoRecordsYet => new TranslatableString(getKey(@"no_records_yet"), @"No records yet!");
+
+        /// <summary>
+        /// "Please sign in to view online leaderboards!"
+        /// </summary>
+        public static LocalisableString PleaseSignInToViewOnlineLeaderboards => new TranslatableString(getKey(@"please_sign_in_to_view_online_leaderboards"), @"Please sign in to view online leaderboards!");
+
+        /// <summary>
+        /// "Please invest in an osu!supporter tag to view this leaderboard!"
+        /// </summary>
+        public static LocalisableString PleaseInvestInAnOsuSupporterTagToViewThisLeaderboard => new TranslatableString(getKey(@"please_invest_in_an_osu_supporter_tag_to_view_this_leaderboard"), @"Please invest in an osu!supporter tag to view this leaderboard!");
+
+        private static string getKey(string key) => $@"{prefix}:{key}";
+    }
+}
diff --git a/osu.Game/Online/Leaderboards/Leaderboard.cs b/osu.Game/Online/Leaderboards/Leaderboard.cs
index dde53c39e4..c94a6d3361 100644
--- a/osu.Game/Online/Leaderboards/Leaderboard.cs
+++ b/osu.Game/Online/Leaderboards/Leaderboard.cs
@@ -22,6 +22,7 @@ using osu.Game.Online.API;
 using osu.Game.Online.Placeholders;
 using osuTK;
 using osuTK.Graphics;
+using osu.Game.Localisation;
 
 namespace osu.Game.Online.Leaderboards
 {
@@ -311,28 +312,28 @@ namespace osu.Game.Online.Leaderboards
             switch (state)
             {
                 case LeaderboardState.NetworkFailure:
-                    return new ClickablePlaceholder(@"Couldn't fetch scores!", FontAwesome.Solid.Sync)
+                    return new ClickablePlaceholder(LeaderboardStrings.CouldntFetchScores, FontAwesome.Solid.Sync)
                     {
                         Action = RefetchScores
                     };
 
                 case LeaderboardState.NoneSelected:
-                    return new MessagePlaceholder(@"Please select a beatmap!");
+                    return new MessagePlaceholder(LeaderboardStrings.PleaseSelectABeatmap);
 
                 case LeaderboardState.RulesetUnavailable:
-                    return new MessagePlaceholder(@"Leaderboards are not available for this ruleset!");
+                    return new MessagePlaceholder(LeaderboardStrings.LeaderboardsAreNotAvailableForThisRuleset);
 
                 case LeaderboardState.BeatmapUnavailable:
-                    return new MessagePlaceholder(@"Leaderboards are not available for this beatmap!");
+                    return new MessagePlaceholder(LeaderboardStrings.LeaderboardsAreNotAvailableForThisBeatmap);
 
                 case LeaderboardState.NoScores:
-                    return new MessagePlaceholder(@"No records yet!");
+                    return new MessagePlaceholder(LeaderboardStrings.NoRecordsYet);
 
                 case LeaderboardState.NotLoggedIn:
-                    return new LoginPlaceholder(@"Please sign in to view online leaderboards!");
+                    return new LoginPlaceholder(LeaderboardStrings.PleaseSignInToViewOnlineLeaderboards);
 
                 case LeaderboardState.NotSupporter:
-                    return new MessagePlaceholder(@"Please invest in an osu!supporter tag to view this leaderboard!");
+                    return new MessagePlaceholder(LeaderboardStrings.PleaseInvestInAnOsuSupporterTagToViewThisLeaderboard);
 
                 case LeaderboardState.Retrieving:
                     return null;
diff --git a/osu.Game/Online/Placeholders/LoginPlaceholder.cs b/osu.Game/Online/Placeholders/LoginPlaceholder.cs
index f8a326a52e..d03b3d8ffc 100644
--- a/osu.Game/Online/Placeholders/LoginPlaceholder.cs
+++ b/osu.Game/Online/Placeholders/LoginPlaceholder.cs
@@ -3,6 +3,7 @@
 
 using osu.Framework.Allocation;
 using osu.Framework.Graphics.Sprites;
+using osu.Framework.Localisation;
 using osu.Game.Overlays;
 
 namespace osu.Game.Online.Placeholders
@@ -12,7 +13,7 @@ namespace osu.Game.Online.Placeholders
         [Resolved(CanBeNull = true)]
         private LoginOverlay login { get; set; }
 
-        public LoginPlaceholder(string actionMessage)
+        public LoginPlaceholder(LocalisableString actionMessage)
             : base(actionMessage, FontAwesome.Solid.UserLock)
         {
             Action = () => login?.Show();

From c07f7545653edc5efd3f4f90b1faa292774cc9b2 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 2 Mar 2022 14:34:24 +0900
Subject: [PATCH 3145/5547] Enable `nullable` on `BeatmapOffsetControl`

---
 .../PlayerSettings/BeatmapOffsetControl.cs    | 32 ++++++++++---------
 1 file changed, 17 insertions(+), 15 deletions(-)

diff --git a/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs b/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
index e6bc510564..98820cabf8 100644
--- a/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
+++ b/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
@@ -23,6 +23,8 @@ using osuTK;
 using osu.Game.Localisation;
 using osu.Game.Rulesets.Mods;
 
+#nullable enable
+
 namespace osu.Game.Screens.Play.PlayerSettings
 {
     public class BeatmapOffsetControl : CompositeDrawable
@@ -38,22 +40,24 @@ namespace osu.Game.Screens.Play.PlayerSettings
             Precision = 0.1,
         };
 
-        private SettingsButton useAverageButton;
+        private readonly FillFlowContainer referenceScoreContainer;
+
+        [Resolved]
+        private RealmAccess realm { get; set; } = null!;
+
+        [Resolved]
+        private IBindable<WorkingBeatmap> beatmap { get; set; } = null!;
+
+        [Resolved]
+        private OsuColour colours { get; set; } = null!;
 
         private double lastPlayAverage;
 
-        private readonly FillFlowContainer referenceScoreContainer;
+        private SettingsButton? useAverageButton;
 
-        private IDisposable beatmapOffsetSubscription;
+        private IDisposable? beatmapOffsetSubscription;
 
-        [Resolved]
-        private RealmAccess realm { get; set; }
-
-        [Resolved]
-        private IBindable<WorkingBeatmap> beatmap { get; set; }
-
-        [Resolved]
-        private OsuColour colours { get; set; }
+        private Task? realmWriteTask;
 
         public BeatmapOffsetControl()
         {
@@ -113,8 +117,6 @@ namespace osu.Game.Screens.Play.PlayerSettings
             Current.BindValueChanged(currentChanged);
         }
 
-        private Task realmWrite;
-
         private void currentChanged(ValueChangedEvent<double> offset)
         {
             Scheduler.AddOnce(updateOffset);
@@ -122,7 +124,7 @@ namespace osu.Game.Screens.Play.PlayerSettings
             void updateOffset()
             {
                 // ensure the previous write has completed. ignoring performance concerns, if we don't do this, the async writes could be out of sequence.
-                if (realmWrite?.IsCompleted == false)
+                if (realmWriteTask?.IsCompleted == false)
                 {
                     Scheduler.AddOnce(updateOffset);
                     return;
@@ -131,7 +133,7 @@ namespace osu.Game.Screens.Play.PlayerSettings
                 if (useAverageButton != null)
                     useAverageButton.Enabled.Value = !Precision.AlmostEquals(lastPlayAverage, Current.Value, Current.Precision);
 
-                realmWrite = realm.WriteAsync(r =>
+                realmWriteTask = realm.WriteAsync(r =>
                 {
                     var settings = r.Find<BeatmapInfo>(beatmap.Value.BeatmapInfo.ID)?.UserSettings;
 

From 3cbcb702f6f4aa9d3d165f63735d6c57b2cf829c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 2 Mar 2022 14:36:15 +0900
Subject: [PATCH 3146/5547] Fix calibration button disabled state not checking
 in corrrect direction

---
 osu.Game.Tests/Visual/Gameplay/TestSceneBeatmapOffsetControl.cs | 1 +
 osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs    | 2 +-
 2 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneBeatmapOffsetControl.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneBeatmapOffsetControl.cs
index 42b579bc89..67f5db548b 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneBeatmapOffsetControl.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneBeatmapOffsetControl.cs
@@ -66,6 +66,7 @@ namespace osu.Game.Tests.Visual.Gameplay
             AddStep("Press button", () => offsetControl.ChildrenOfType<SettingsButton>().Single().TriggerClick());
             AddAssert("Offset is adjusted", () => offsetControl.Current.Value == -average_error);
 
+            AddAssert("Button is disabled", () => !offsetControl.ChildrenOfType<SettingsButton>().Single().Enabled.Value);
             AddStep("Remove reference score", () => offsetControl.ReferenceScore.Value = null);
             AddAssert("No calibration button", () => !offsetControl.ChildrenOfType<SettingsButton>().Any());
         }
diff --git a/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs b/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
index 98820cabf8..ca683cec66 100644
--- a/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
+++ b/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
@@ -131,7 +131,7 @@ namespace osu.Game.Screens.Play.PlayerSettings
                 }
 
                 if (useAverageButton != null)
-                    useAverageButton.Enabled.Value = !Precision.AlmostEquals(lastPlayAverage, Current.Value, Current.Precision);
+                    useAverageButton.Enabled.Value = !Precision.AlmostEquals(lastPlayAverage, -Current.Value, Current.Precision);
 
                 realmWriteTask = realm.WriteAsync(r =>
                 {

From 8bd66f1ed7302577801926dc55baeeac4d1720d4 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 2 Mar 2022 14:36:49 +0900
Subject: [PATCH 3147/5547] Fix incorrect precision specification for button
 disable check

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

diff --git a/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs b/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
index ca683cec66..63045013b5 100644
--- a/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
+++ b/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
@@ -131,7 +131,7 @@ namespace osu.Game.Screens.Play.PlayerSettings
                 }
 
                 if (useAverageButton != null)
-                    useAverageButton.Enabled.Value = !Precision.AlmostEquals(lastPlayAverage, -Current.Value, Current.Precision);
+                    useAverageButton.Enabled.Value = !Precision.AlmostEquals(lastPlayAverage, -Current.Value, Current.Precision / 2);
 
                 realmWriteTask = realm.WriteAsync(r =>
                 {

From e184b26cdd67101488bbbcdf8c03940997a13da3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 2 Mar 2022 14:39:28 +0900
Subject: [PATCH 3148/5547] Remove `Precision` call for database write
 shortcutting

Shouldn't be required.
---
 osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs b/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
index 63045013b5..f19a326cdf 100644
--- a/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
+++ b/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
@@ -140,7 +140,7 @@ namespace osu.Game.Screens.Play.PlayerSettings
                     if (settings == null) // only the case for tests.
                         return;
 
-                    if (Precision.AlmostEquals(settings.Offset, Current.Value))
+                    if (settings.Offset == Current.Value)
                         return;
 
                     settings.Offset = Current.Value;

From 763f881d4a0ade9930cfffafb974883c6f6e2385 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 2 Mar 2022 14:42:08 +0900
Subject: [PATCH 3149/5547] Use more correct mod check to encompass more than
 just autoplay

---
 osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs b/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
index f19a326cdf..dc3e80d695 100644
--- a/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
+++ b/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
@@ -15,13 +15,12 @@ using osu.Game.Database;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
+using osu.Game.Localisation;
 using osu.Game.Overlays.Settings;
 using osu.Game.Rulesets.Scoring;
 using osu.Game.Scoring;
 using osu.Game.Screens.Ranking.Statistics;
 using osuTK;
-using osu.Game.Localisation;
-using osu.Game.Rulesets.Mods;
 
 #nullable enable
 
@@ -155,7 +154,7 @@ namespace osu.Game.Screens.Play.PlayerSettings
             if (score.NewValue == null)
                 return;
 
-            if (score.NewValue.Mods.Any(m => m is ModAutoplay))
+            if (score.NewValue.Mods.Any(m => !m.UserPlayable))
                 return;
 
             var hitEvents = score.NewValue.HitEvents;

From ed9ecd695114e1afabd51213767a206798791c92 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 2 Mar 2022 14:45:39 +0900
Subject: [PATCH 3150/5547] Fix test scene failures by ensuring that first
 `GameplayClock` frame has processed first

---
 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 e03c8d7561..b195d2aa74 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneLeadIn.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneLeadIn.cs
@@ -131,9 +131,9 @@ namespace osu.Game.Tests.Visual.Gameplay
 
             public double GameplayClockTime => GameplayClockContainer.GameplayClock.CurrentTime;
 
-            protected override void Update()
+            protected override void UpdateAfterChildren()
             {
-                base.Update();
+                base.UpdateAfterChildren();
 
                 if (!FirstFrameClockTime.HasValue)
                 {

From 411252e004f15f51488b67cab5909372f99490d4 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 2 Mar 2022 17:01:27 +0900
Subject: [PATCH 3151/5547] Replace squirrel fork with `Clowd.Squirrel`

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

diff --git a/osu.Desktop/osu.Desktop.csproj b/osu.Desktop/osu.Desktop.csproj
index b1117bf796..32ead231c7 100644
--- a/osu.Desktop/osu.Desktop.csproj
+++ b/osu.Desktop/osu.Desktop.csproj
@@ -24,10 +24,10 @@
     <ProjectReference Include="..\osu.Game.Rulesets.Taiko\osu.Game.Rulesets.Taiko.csproj" />
   </ItemGroup>
   <ItemGroup Label="Package References">
+    <PackageReference Include="Clowd.Squirrel" Version="2.8.15-pre" />
     <PackageReference Include="Microsoft.NETCore.Targets" Version="5.0.0" />
     <PackageReference Include="Mono.Posix.NETStandard" Version="1.0.0" />
     <PackageReference Include="System.IO.Packaging" Version="6.0.0" />
-    <PackageReference Include="ppy.squirrel.windows" Version="1.9.0.5" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="5.0.14" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Design" Version="5.0.14">
       <PrivateAssets>all</PrivateAssets>

From 6a4d731eb3a94c991cdea9a4f461ead85f31d5d9 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 2 Mar 2022 17:11:24 +0900
Subject: [PATCH 3152/5547] Update obsolete usages in line with
 `Clowd.Squirrel` changes

---
 osu.Desktop/OsuGameDesktop.cs                |  3 +++
 osu.Desktop/Updater/SquirrelUpdateManager.cs | 18 ++++++++++++------
 2 files changed, 15 insertions(+), 6 deletions(-)

diff --git a/osu.Desktop/OsuGameDesktop.cs b/osu.Desktop/OsuGameDesktop.cs
index cd3fb7eb61..be8159a7cc 100644
--- a/osu.Desktop/OsuGameDesktop.cs
+++ b/osu.Desktop/OsuGameDesktop.cs
@@ -3,6 +3,7 @@
 
 using System;
 using System.Collections.Generic;
+using System.Diagnostics;
 using System.IO;
 using System.Linq;
 using System.Reflection;
@@ -96,6 +97,8 @@ namespace osu.Desktop
             switch (RuntimeInfo.OS)
             {
                 case RuntimeInfo.Platform.Windows:
+                    Debug.Assert(OperatingSystem.IsWindows());
+
                     return new SquirrelUpdateManager();
 
                 default:
diff --git a/osu.Desktop/Updater/SquirrelUpdateManager.cs b/osu.Desktop/Updater/SquirrelUpdateManager.cs
index 7b60bc03e4..b307146b10 100644
--- a/osu.Desktop/Updater/SquirrelUpdateManager.cs
+++ b/osu.Desktop/Updater/SquirrelUpdateManager.cs
@@ -2,6 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
+using System.Runtime.Versioning;
 using System.Threading.Tasks;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
@@ -16,10 +17,11 @@ using osu.Game.Overlays.Notifications;
 using osuTK;
 using osuTK.Graphics;
 using Squirrel;
-using LogLevel = Splat.LogLevel;
+using Squirrel.SimpleSplat;
 
 namespace osu.Desktop.Updater
 {
+    [SupportedOSPlatform("windows")]
     public class SquirrelUpdateManager : osu.Game.Updater.UpdateManager
     {
         private UpdateManager updateManager;
@@ -34,12 +36,14 @@ namespace osu.Desktop.Updater
         /// </summary>
         private bool updatePending;
 
+        private readonly SquirrelLogger squirrelLogger = new SquirrelLogger();
+
         [BackgroundDependencyLoader]
         private void load(NotificationOverlay notification)
         {
             notificationOverlay = notification;
 
-            Splat.Locator.CurrentMutable.Register(() => new SquirrelLogger(), typeof(Splat.ILogger));
+            SquirrelLocator.CurrentMutable.Register(() => squirrelLogger, typeof(ILogger));
         }
 
         protected override async Task<bool> PerformUpdateCheck() => await checkForUpdateAsync().ConfigureAwait(false);
@@ -49,9 +53,11 @@ namespace osu.Desktop.Updater
             // should we schedule a retry on completion of this check?
             bool scheduleRecheck = true;
 
+            const string github_token = null; // TODO: populate.
+
             try
             {
-                updateManager ??= await UpdateManager.GitHubUpdateManager(@"https://github.com/ppy/osu", @"osulazer", null, null, true).ConfigureAwait(false);
+                updateManager ??= new GithubUpdateManager(@"https://github.com/ppy/osu", false, github_token, @"osulazer");
 
                 var info = await updateManager.CheckForUpdate(!useDeltaPatching).ConfigureAwait(false);
 
@@ -201,11 +207,11 @@ namespace osu.Desktop.Updater
             }
         }
 
-        private class SquirrelLogger : Splat.ILogger, IDisposable
+        private class SquirrelLogger : ILogger, IDisposable
         {
-            public LogLevel Level { get; set; } = LogLevel.Info;
+            public Squirrel.SimpleSplat.LogLevel Level { get; set; } = Squirrel.SimpleSplat.LogLevel.Info;
 
-            public void Write(string message, LogLevel logLevel)
+            public void Write(string message, Squirrel.SimpleSplat.LogLevel logLevel)
             {
                 if (logLevel < Level)
                     return;

From 1c705f3b331e4fab9e33f4465ab3a4611c4f5916 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 2 Mar 2022 17:31:45 +0900
Subject: [PATCH 3153/5547] Mark `osu.Desktop` as squirrel-aware

---
 osu.Desktop/app.manifest | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/osu.Desktop/app.manifest b/osu.Desktop/app.manifest
index 2e9127bf44..a11cee132c 100644
--- a/osu.Desktop/app.manifest
+++ b/osu.Desktop/app.manifest
@@ -1,6 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
 <asmv1:assembly manifestVersion="1.0" xmlns="urn:schemas-microsoft-com:asm.v1" xmlns:asmv1="urn:schemas-microsoft-com:asm.v1" xmlns:asmv2="urn:schemas-microsoft-com:asm.v2" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:asmv3="urn:schemas-microsoft-com:asm.v3">
   <assemblyIdentity version="1.0.0.0" name="osu!" />
+  <SquirrelAwareVersion xmlns="urn:schema-squirrel-com:asm.v1">1</SquirrelAwareVersion>
   <trustInfo xmlns="urn:schemas-microsoft-com:asm.v2">
     <security>
       <requestedPrivileges xmlns="urn:schemas-microsoft-com:asm.v3">
@@ -17,4 +18,4 @@
       <dpiAware>true</dpiAware>
     </asmv3:windowsSettings>
   </asmv3:application>
-</asmv1:assembly>
\ No newline at end of file
+</asmv1:assembly>

From 3aa2d4548ab40cca9b023a913c49719a43a57c6e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 2 Mar 2022 17:54:33 +0900
Subject: [PATCH 3154/5547] Add startup squirrel icon/association handling

---
 osu.Desktop/Program.cs | 25 +++++++++++++++++++++++++
 1 file changed, 25 insertions(+)

diff --git a/osu.Desktop/Program.cs b/osu.Desktop/Program.cs
index b944068e78..0e11e172e1 100644
--- a/osu.Desktop/Program.cs
+++ b/osu.Desktop/Program.cs
@@ -3,6 +3,7 @@
 
 using System;
 using System.IO;
+using System.Runtime.Versioning;
 using System.Threading;
 using System.Threading.Tasks;
 using osu.Desktop.LegacyIpc;
@@ -12,6 +13,7 @@ using osu.Framework.Logging;
 using osu.Framework.Platform;
 using osu.Game.IPC;
 using osu.Game.Tournament;
+using Squirrel;
 
 namespace osu.Desktop
 {
@@ -24,6 +26,10 @@ namespace osu.Desktop
         [STAThread]
         public static void Main(string[] args)
         {
+            // run Squirrel first, as the app may exit after these run
+            if (OperatingSystem.IsWindows())
+                setupSquirrel();
+
             // Back up the cwd before DesktopGameHost changes it
             string cwd = Environment.CurrentDirectory;
 
@@ -104,6 +110,25 @@ namespace osu.Desktop
             }
         }
 
+        [SupportedOSPlatform("windows")]
+        private static void setupSquirrel()
+        {
+            SquirrelAwareApp.HandleEvents(onInitialInstall: (version, tools) =>
+            {
+                tools.CreateShortcutForThisExe();
+            }, onAppUninstall: (version, tools) =>
+            {
+                tools.RemoveShortcutForThisExe();
+                tools.RemoveUninstallerRegistryEntry();
+            }, onEveryRun: (version, tools, firstRun) =>
+            {
+                tools.SetProcessAppUserModelId();
+
+                if (firstRun)
+                    tools.CreateUninstallerRegistryEntry();
+            });
+        }
+
         private static int allowableExceptions = DebugUtils.IsDebugBuild ? 0 : 1;
 
         /// <summary>

From c06703d662b1b887330e28bee4c439c48d913d8b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 2 Mar 2022 18:29:07 +0900
Subject: [PATCH 3155/5547] Add ability to select which display the game runs
 on

---
 .../Localisation/GraphicsSettingsStrings.cs   |  5 +++
 .../Sections/Graphics/LayoutSettings.cs       | 33 ++++++++++++++++---
 2 files changed, 34 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Localisation/GraphicsSettingsStrings.cs b/osu.Game/Localisation/GraphicsSettingsStrings.cs
index 996a1350eb..1c9aa64df5 100644
--- a/osu.Game/Localisation/GraphicsSettingsStrings.cs
+++ b/osu.Game/Localisation/GraphicsSettingsStrings.cs
@@ -54,6 +54,11 @@ namespace osu.Game.Localisation
         /// </summary>
         public static LocalisableString Resolution => new TranslatableString(getKey(@"resolution"), @"Resolution");
 
+        /// <summary>
+        /// "Display"
+        /// </summary>
+        public static LocalisableString Display => new TranslatableString(getKey(@"display"), @"Display");
+
         /// <summary>
         /// "UI scaling"
         /// </summary>
diff --git a/osu.Game/Overlays/Settings/Sections/Graphics/LayoutSettings.cs b/osu.Game/Overlays/Settings/Sections/Graphics/LayoutSettings.cs
index adf1453d1a..a1688b87cc 100644
--- a/osu.Game/Overlays/Settings/Sections/Graphics/LayoutSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Graphics/LayoutSettings.cs
@@ -27,7 +27,7 @@ namespace osu.Game.Overlays.Settings.Sections.Graphics
 
         private FillFlowContainer<SettingsSlider<float>> scalingSettings;
 
-        private readonly IBindable<Display> currentDisplay = new Bindable<Display>();
+        private readonly Bindable<Display> currentDisplay = new Bindable<Display>();
         private readonly IBindableList<WindowMode> windowModes = new BindableList<WindowMode>();
 
         private Bindable<ScalingMode> scalingMode;
@@ -39,6 +39,7 @@ namespace osu.Game.Overlays.Settings.Sections.Graphics
         private OsuGameBase game { get; set; }
 
         private SettingsDropdown<Size> resolutionDropdown;
+        private SettingsDropdown<Display> displayDropdown;
         private SettingsDropdown<WindowMode> windowModeDropdown;
 
         private Bindable<float> scalingPositionX;
@@ -72,6 +73,12 @@ namespace osu.Game.Overlays.Settings.Sections.Graphics
                     ItemSource = windowModes,
                     Current = config.GetBindable<WindowMode>(FrameworkSetting.WindowMode),
                 },
+                displayDropdown = new DisplaySettingsDropdown
+                {
+                    LabelText = GraphicsSettingsStrings.Display,
+                    Items = host.Window?.Displays,
+                    Current = currentDisplay,
+                },
                 resolutionDropdown = new ResolutionSettingsDropdown
                 {
                     LabelText = GraphicsSettingsStrings.Resolution,
@@ -142,7 +149,7 @@ namespace osu.Game.Overlays.Settings.Sections.Graphics
 
             windowModeDropdown.Current.BindValueChanged(mode =>
             {
-                updateResolutionDropdown();
+                updateFullscreenDropdowns();
 
                 windowModeDropdown.WarningText = mode.NewValue != WindowMode.Fullscreen ? GraphicsSettingsStrings.NotFullscreenNote : default;
             }, true);
@@ -168,7 +175,7 @@ namespace osu.Game.Overlays.Settings.Sections.Graphics
                                                 .Distinct());
                 }
 
-                updateResolutionDropdown();
+                updateFullscreenDropdowns();
             }), true);
 
             scalingMode.BindValueChanged(mode =>
@@ -183,12 +190,17 @@ namespace osu.Game.Overlays.Settings.Sections.Graphics
             // initial update bypasses transforms
             updateScalingModeVisibility();
 
-            void updateResolutionDropdown()
+            void updateFullscreenDropdowns()
             {
                 if (resolutions.Count > 1 && windowModeDropdown.Current.Value == WindowMode.Fullscreen)
                     resolutionDropdown.Show();
                 else
                     resolutionDropdown.Hide();
+
+                if (displayDropdown.Items.Count() > 1)
+                    displayDropdown.Show();
+                else
+                    displayDropdown.Hide();
             }
 
             void updateScalingModeVisibility()
@@ -243,6 +255,19 @@ namespace osu.Game.Overlays.Settings.Sections.Graphics
             public override LocalisableString TooltipText => base.TooltipText + "x";
         }
 
+        private class DisplaySettingsDropdown : SettingsDropdown<Display>
+        {
+            protected override OsuDropdown<Display> CreateDropdown() => new DisplaySettingsDropdownControl();
+
+            private class DisplaySettingsDropdownControl : DropdownControl
+            {
+                protected override LocalisableString GenerateItemText(Display item)
+                {
+                    return $"{item.Index}: {item.Name} ({item.Bounds.Width}x{item.Bounds.Height})";
+                }
+            }
+        }
+
         private class ResolutionSettingsDropdown : SettingsDropdown<Size>
         {
             protected override OsuDropdown<Size> CreateDropdown() => new ResolutionDropdownControl();

From 1a474592625ccc97b47b11bdb953dcdbf3fdd8a9 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 2 Mar 2022 18:38:17 +0900
Subject: [PATCH 3156/5547] Fix taiko difficulty adjust scroll speed being
 shown with too low precision

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

diff --git a/osu.Game.Rulesets.Taiko/Mods/TaikoModDifficultyAdjust.cs b/osu.Game.Rulesets.Taiko/Mods/TaikoModDifficultyAdjust.cs
index 9540e35780..99a064d35f 100644
--- a/osu.Game.Rulesets.Taiko/Mods/TaikoModDifficultyAdjust.cs
+++ b/osu.Game.Rulesets.Taiko/Mods/TaikoModDifficultyAdjust.cs
@@ -23,7 +23,7 @@ namespace osu.Game.Rulesets.Taiko.Mods
         {
             get
             {
-                string scrollSpeed = ScrollSpeed.IsDefault ? string.Empty : $"Scroll x{ScrollSpeed.Value:N1}";
+                string scrollSpeed = ScrollSpeed.IsDefault ? string.Empty : $"Scroll x{ScrollSpeed.Value:N2}";
 
                 return string.Join(", ", new[]
                 {

From f15b8781bb92e9d74c89357a10b32e77a0de84b0 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 2 Mar 2022 19:19:39 +0900
Subject: [PATCH 3157/5547] Move editor mode selector out of `EditorMenuBar` to
 allow for better reuse

---
 .../Editing/TestSceneEditorScreenModes.cs     |  4 +-
 .../Edit/Components/Menus/EditorMenuBar.cs    | 22 -----
 osu.Game/Screens/Edit/Editor.cs               | 82 +++++++++++--------
 3 files changed, 47 insertions(+), 61 deletions(-)

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneEditorScreenModes.cs b/osu.Game.Tests/Visual/Editing/TestSceneEditorScreenModes.cs
index 98d8a41674..2efd125f81 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneEditorScreenModes.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneEditorScreenModes.cs
@@ -4,11 +4,9 @@
 using System;
 using System.Linq;
 using NUnit.Framework;
-using osu.Framework.Testing;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Osu;
 using osu.Game.Screens.Edit;
-using osu.Game.Screens.Edit.Components.Menus;
 
 namespace osu.Game.Tests.Visual.Editing
 {
@@ -22,7 +20,7 @@ namespace osu.Game.Tests.Visual.Editing
             AddStep("switch between all screens at once", () =>
             {
                 foreach (var screen in Enum.GetValues(typeof(EditorScreenMode)).Cast<EditorScreenMode>())
-                    Editor.ChildrenOfType<EditorMenuBar>().Single().Mode.Value = screen;
+                    Editor.Mode.Value = screen;
             });
         }
     }
diff --git a/osu.Game/Screens/Edit/Components/Menus/EditorMenuBar.cs b/osu.Game/Screens/Edit/Components/Menus/EditorMenuBar.cs
index c6787a1fb1..2a8435ff47 100644
--- a/osu.Game/Screens/Edit/Components/Menus/EditorMenuBar.cs
+++ b/osu.Game/Screens/Edit/Components/Menus/EditorMenuBar.cs
@@ -2,7 +2,6 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using osu.Framework.Allocation;
-using osu.Framework.Bindables;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
@@ -18,8 +17,6 @@ namespace osu.Game.Screens.Edit.Components.Menus
 {
     public class EditorMenuBar : OsuMenu
     {
-        public readonly Bindable<EditorScreenMode> Mode = new Bindable<EditorScreenMode>();
-
         public EditorMenuBar()
             : base(Direction.Horizontal, true)
         {
@@ -28,25 +25,6 @@ namespace osu.Game.Screens.Edit.Components.Menus
             MaskingContainer.CornerRadius = 0;
             ItemsContainer.Padding = new MarginPadding { Left = 100 };
             BackgroundColour = Color4Extensions.FromHex("111");
-
-            ScreenSelectionTabControl tabControl;
-            AddRangeInternal(new Drawable[]
-            {
-                tabControl = new ScreenSelectionTabControl
-                {
-                    Anchor = Anchor.BottomRight,
-                    Origin = Anchor.BottomRight,
-                    X = -15
-                }
-            });
-
-            Mode.BindTo(tabControl.Current);
-        }
-
-        protected override void LoadComplete()
-        {
-            base.LoadComplete();
-            Mode.TriggerChange();
         }
 
         protected override Framework.Graphics.UserInterface.Menu CreateSubMenu() => new SubMenu();
diff --git a/osu.Game/Screens/Edit/Editor.cs b/osu.Game/Screens/Edit/Editor.cs
index c2775ae101..dcb7e3a282 100644
--- a/osu.Game/Screens/Edit/Editor.cs
+++ b/osu.Game/Screens/Edit/Editor.cs
@@ -89,6 +89,8 @@ namespace osu.Game.Screens.Edit
         [Resolved(canBeNull: true)]
         private NotificationOverlay notifications { get; set; }
 
+        public readonly Bindable<EditorScreenMode> Mode = new Bindable<EditorScreenMode>();
+
         public IBindable<bool> SamplePlaybackDisabled => samplePlaybackDisabled;
 
         private readonly Bindable<bool> samplePlaybackDisabled = new Bindable<bool>();
@@ -115,8 +117,6 @@ namespace osu.Game.Screens.Edit
         [CanBeNull] // Should be non-null once it can support custom rulesets.
         private EditorChangeHandler changeHandler;
 
-        private EditorMenuBar menuBar;
-
         private DependencyContainer dependencies;
 
         private TestGameplayButton testGameplayButton;
@@ -239,40 +239,49 @@ namespace osu.Game.Screens.Edit
                         Name = "Top bar",
                         RelativeSizeAxes = Axes.X,
                         Height = 40,
-                        Child = menuBar = new EditorMenuBar
+                        Children = new Drawable[]
                         {
-                            Anchor = Anchor.CentreLeft,
-                            Origin = Anchor.CentreLeft,
-                            RelativeSizeAxes = Axes.Both,
-                            Mode = { Value = isNewBeatmap ? EditorScreenMode.SongSetup : EditorScreenMode.Compose },
-                            Items = new[]
+                            new EditorMenuBar
                             {
-                                new MenuItem("File")
+                                Anchor = Anchor.CentreLeft,
+                                Origin = Anchor.CentreLeft,
+                                RelativeSizeAxes = Axes.Both,
+                                Items = new[]
                                 {
-                                    Items = createFileMenuItems()
-                                },
-                                new MenuItem("Edit")
-                                {
-                                    Items = new[]
+                                    new MenuItem("File")
                                     {
-                                        undoMenuItem = new EditorMenuItem("Undo", MenuItemType.Standard, Undo),
-                                        redoMenuItem = new EditorMenuItem("Redo", MenuItemType.Standard, Redo),
-                                        new EditorMenuItemSpacer(),
-                                        cutMenuItem = new EditorMenuItem("Cut", MenuItemType.Standard, Cut),
-                                        copyMenuItem = new EditorMenuItem("Copy", MenuItemType.Standard, Copy),
-                                        pasteMenuItem = new EditorMenuItem("Paste", MenuItemType.Standard, Paste),
-                                    }
-                                },
-                                new MenuItem("View")
-                                {
-                                    Items = new MenuItem[]
+                                        Items = createFileMenuItems()
+                                    },
+                                    new MenuItem("Edit")
                                     {
-                                        new WaveformOpacityMenuItem(config.GetBindable<float>(OsuSetting.EditorWaveformOpacity)),
-                                        new HitAnimationsMenuItem(config.GetBindable<bool>(OsuSetting.EditorHitAnimations))
+                                        Items = new[]
+                                        {
+                                            undoMenuItem = new EditorMenuItem("Undo", MenuItemType.Standard, Undo),
+                                            redoMenuItem = new EditorMenuItem("Redo", MenuItemType.Standard, Redo),
+                                            new EditorMenuItemSpacer(),
+                                            cutMenuItem = new EditorMenuItem("Cut", MenuItemType.Standard, Cut),
+                                            copyMenuItem = new EditorMenuItem("Copy", MenuItemType.Standard, Copy),
+                                            pasteMenuItem = new EditorMenuItem("Paste", MenuItemType.Standard, Paste),
+                                        }
+                                    },
+                                    new MenuItem("View")
+                                    {
+                                        Items = new MenuItem[]
+                                        {
+                                            new WaveformOpacityMenuItem(config.GetBindable<float>(OsuSetting.EditorWaveformOpacity)),
+                                            new HitAnimationsMenuItem(config.GetBindable<bool>(OsuSetting.EditorHitAnimations))
+                                        }
                                     }
                                 }
-                            }
-                        }
+                            },
+                            new ScreenSelectionTabControl
+                            {
+                                Anchor = Anchor.BottomRight,
+                                Origin = Anchor.BottomRight,
+                                X = -15,
+                                Current = Mode,
+                            },
+                        },
                     },
                     new Container
                     {
@@ -340,14 +349,15 @@ namespace osu.Game.Screens.Edit
 
             changeHandler?.CanUndo.BindValueChanged(v => undoMenuItem.Action.Disabled = !v.NewValue, true);
             changeHandler?.CanRedo.BindValueChanged(v => redoMenuItem.Action.Disabled = !v.NewValue, true);
-
-            menuBar.Mode.ValueChanged += onModeChanged;
         }
 
         protected override void LoadComplete()
         {
             base.LoadComplete();
             setUpClipboardActionAvailability();
+
+            Mode.Value = isNewBeatmap ? EditorScreenMode.SongSetup : EditorScreenMode.Compose;
+            Mode.BindValueChanged(onModeChanged, true);
         }
 
         /// <summary>
@@ -517,23 +527,23 @@ namespace osu.Game.Screens.Edit
                     return true;
 
                 case GlobalAction.EditorComposeMode:
-                    menuBar.Mode.Value = EditorScreenMode.Compose;
+                    Mode.Value = EditorScreenMode.Compose;
                     return true;
 
                 case GlobalAction.EditorDesignMode:
-                    menuBar.Mode.Value = EditorScreenMode.Design;
+                    Mode.Value = EditorScreenMode.Design;
                     return true;
 
                 case GlobalAction.EditorTimingMode:
-                    menuBar.Mode.Value = EditorScreenMode.Timing;
+                    Mode.Value = EditorScreenMode.Timing;
                     return true;
 
                 case GlobalAction.EditorSetupMode:
-                    menuBar.Mode.Value = EditorScreenMode.SongSetup;
+                    Mode.Value = EditorScreenMode.SongSetup;
                     return true;
 
                 case GlobalAction.EditorVerifyMode:
-                    menuBar.Mode.Value = EditorScreenMode.Verify;
+                    Mode.Value = EditorScreenMode.Verify;
                     return true;
 
                 case GlobalAction.EditorTestGameplay:

From 1916011ebff0064370a5589a948caa33fcafde91 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 2 Mar 2022 19:41:47 +0900
Subject: [PATCH 3158/5547] Tween corner radius when scaling container becomes
 non-fullscreen

---
 osu.Game/Graphics/Containers/ScalingContainer.cs | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Graphics/Containers/ScalingContainer.cs b/osu.Game/Graphics/Containers/ScalingContainer.cs
index 0d543bdbc8..781e85f82e 100644
--- a/osu.Game/Graphics/Containers/ScalingContainer.cs
+++ b/osu.Game/Graphics/Containers/ScalingContainer.cs
@@ -56,6 +56,8 @@ namespace osu.Game.Graphics.Containers
             }
         }
 
+        private const float corner_radius = 10;
+
         /// <summary>
         /// Create a new instance.
         /// </summary>
@@ -69,7 +71,7 @@ namespace osu.Game.Graphics.Containers
             {
                 RelativeSizeAxes = Axes.Both,
                 RelativePositionAxes = Axes.Both,
-                CornerRadius = 10,
+                CornerRadius = corner_radius,
                 Child = content = new ScalingDrawSizePreservingFillContainer(targetMode != ScalingMode.Gameplay)
             };
         }
@@ -176,6 +178,7 @@ namespace osu.Game.Graphics.Containers
 
             sizableContainer.MoveTo(targetPosition, 500, Easing.OutQuart);
             sizableContainer.ResizeTo(targetSize, 500, Easing.OutQuart).OnComplete(_ => { sizableContainer.Masking = requiresMasking; });
+            sizableContainer.TransformTo(nameof(CornerRadius), requiresMasking ? corner_radius : 0, 500, requiresMasking ? Easing.OutQuart : Easing.None);
         }
 
         private class ScalingBackgroundScreen : BackgroundScreenDefault

From ff7db4f4059f70a67d91f6c37fb683c6a7effa23 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 2 Mar 2022 20:05:37 +0900
Subject: [PATCH 3159/5547] Replace jank buttons with menu in skin editor

---
 osu.Game/Skinning/Editor/SkinEditor.cs | 88 ++++++++++++--------------
 1 file changed, 39 insertions(+), 49 deletions(-)

diff --git a/osu.Game/Skinning/Editor/SkinEditor.cs b/osu.Game/Skinning/Editor/SkinEditor.cs
index 8052f82c93..ae5cbc95f0 100644
--- a/osu.Game/Skinning/Editor/SkinEditor.cs
+++ b/osu.Game/Skinning/Editor/SkinEditor.cs
@@ -8,14 +8,14 @@ using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.UserInterface;
 using osu.Framework.Input.Events;
 using osu.Framework.Testing;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Cursor;
 using osu.Game.Graphics.UserInterface;
-using osu.Game.Resources.Localisation.Web;
-using osuTK;
+using osu.Game.Screens.Edit.Components.Menus;
 
 namespace osu.Game.Skinning.Editor
 {
@@ -57,13 +57,43 @@ namespace osu.Game.Skinning.Editor
                 RelativeSizeAxes = Axes.Both,
                 Children = new Drawable[]
                 {
-                    headerText = new OsuTextFlowContainer
+                    new Container
                     {
-                        TextAnchor = Anchor.TopCentre,
-                        Padding = new MarginPadding(20),
-                        Anchor = Anchor.TopCentre,
-                        Origin = Anchor.TopCentre,
-                        RelativeSizeAxes = Axes.X
+                        Name = "Top bar",
+                        RelativeSizeAxes = Axes.X,
+                        Depth = float.MinValue,
+                        Height = 40,
+                        Children = new Drawable[]
+                        {
+                            new EditorMenuBar
+                            {
+                                Anchor = Anchor.CentreLeft,
+                                Origin = Anchor.CentreLeft,
+                                RelativeSizeAxes = Axes.Both,
+                                Items = new[]
+                                {
+                                    new MenuItem("File")
+                                    {
+                                        Items = new[]
+                                        {
+                                            new EditorMenuItem("Save", MenuItemType.Standard, Save),
+                                            new EditorMenuItem("Revert to default", MenuItemType.Destructive, revert),
+                                            new EditorMenuItemSpacer(),
+                                            new EditorMenuItem("Exit", MenuItemType.Standard, Hide),
+                                        },
+                                    },
+                                }
+                            },
+                            headerText = new OsuTextFlowContainer
+                            {
+                                TextAnchor = Anchor.TopRight,
+                                Padding = new MarginPadding(5),
+                                Anchor = Anchor.TopRight,
+                                Origin = Anchor.TopRight,
+                                AutoSizeAxes = Axes.X,
+                                RelativeSizeAxes = Axes.Y,
+                            },
+                        },
                     },
                     new GridContainer
                     {
@@ -89,46 +119,6 @@ namespace osu.Game.Skinning.Editor
                                     Children = new Drawable[]
                                     {
                                         new SkinBlueprintContainer(targetScreen),
-                                        new TriangleButton
-                                        {
-                                            Margin = new MarginPadding(10),
-                                            Text = CommonStrings.ButtonsClose,
-                                            Width = 100,
-                                            Action = Hide,
-                                        },
-                                        new FillFlowContainer
-                                        {
-                                            Direction = FillDirection.Horizontal,
-                                            AutoSizeAxes = Axes.Both,
-                                            Anchor = Anchor.TopRight,
-                                            Origin = Anchor.TopRight,
-                                            Spacing = new Vector2(5),
-                                            Padding = new MarginPadding
-                                            {
-                                                Top = 10,
-                                                Left = 10,
-                                            },
-                                            Margin = new MarginPadding
-                                            {
-                                                Right = 10,
-                                                Bottom = 10,
-                                            },
-                                            Children = new Drawable[]
-                                            {
-                                                new TriangleButton
-                                                {
-                                                    Text = "Save Changes",
-                                                    Width = 140,
-                                                    Action = Save,
-                                                },
-                                                new DangerousTriangleButton
-                                                {
-                                                    Text = "Revert to default",
-                                                    Width = 140,
-                                                    Action = revert,
-                                                },
-                                            }
-                                        },
                                     }
                                 },
                             }
@@ -161,7 +151,7 @@ namespace osu.Game.Skinning.Editor
         {
             headerText.Clear();
 
-            headerText.AddParagraph("Skin editor", cp => cp.Font = OsuFont.Default.With(size: 24));
+            headerText.AddParagraph("Skin editor", cp => cp.Font = OsuFont.Default.With(size: 16));
             headerText.NewParagraph();
             headerText.AddText("Currently editing ", cp =>
             {

From 29ed419d537f140943e77b23a4a965a757b7ca1b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 2 Mar 2022 20:04:53 +0900
Subject: [PATCH 3160/5547] Change how custom scales are applied to
 `ScalingContainer` to allow for better transitions

---
 .../Graphics/Containers/ScalingContainer.cs   | 45 ++++++++++++-------
 .../Skinning/Editor/SkinComponentToolbox.cs   |  4 +-
 osu.Game/Skinning/Editor/SkinEditorOverlay.cs | 21 ++-------
 3 files changed, 34 insertions(+), 36 deletions(-)

diff --git a/osu.Game/Graphics/Containers/ScalingContainer.cs b/osu.Game/Graphics/Containers/ScalingContainer.cs
index 781e85f82e..5888be2ae7 100644
--- a/osu.Game/Graphics/Containers/ScalingContainer.cs
+++ b/osu.Game/Graphics/Containers/ScalingContainer.cs
@@ -5,6 +5,7 @@ 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.Screens;
 using osu.Game.Configuration;
 using osu.Game.Screens;
@@ -38,22 +39,18 @@ namespace osu.Game.Graphics.Containers
 
         private BackgroundScreenStack backgroundStack;
 
-        private bool allowScaling = true;
+        private RectangleF? customScale;
+        private bool customScaleIsRelativePosition;
 
         /// <summary>
-        /// Whether user scaling preferences should be applied. Enabled by default.
+        /// Set a custom position and scale which overrides any user specification.
         /// </summary>
-        public bool AllowScaling
+        public void SetCustomScale(RectangleF? scale, bool relativePosition = false)
         {
-            get => allowScaling;
-            set
-            {
-                if (value == allowScaling)
-                    return;
+            customScale = scale;
+            customScaleIsRelativePosition = relativePosition;
 
-                allowScaling = value;
-                if (IsLoaded) Scheduler.AddOnce(updateSize);
-            }
+            if (IsLoaded) Scheduler.AddOnce(updateSize);
         }
 
         private const float corner_radius = 10;
@@ -164,11 +161,25 @@ namespace osu.Game.Graphics.Containers
                     backgroundStack?.FadeOut(fade_time);
             }
 
-            bool scaling = AllowScaling && (targetMode == null || scalingMode.Value == targetMode);
+            RectangleF targetSize = new RectangleF(Vector2.Zero, Vector2.One);
 
-            var targetSize = scaling ? new Vector2(sizeX.Value, sizeY.Value) : Vector2.One;
-            var targetPosition = scaling ? new Vector2(posX.Value, posY.Value) * (Vector2.One - targetSize) : Vector2.Zero;
-            bool requiresMasking = (scaling && targetSize != Vector2.One)
+            if (customScale != null)
+            {
+                sizableContainer.RelativePositionAxes = customScaleIsRelativePosition ? Axes.Both : Axes.None;
+
+                targetSize = customScale.Value;
+            }
+            else if (targetMode == null || scalingMode.Value == targetMode)
+            {
+                sizableContainer.RelativePositionAxes = Axes.Both;
+
+                Vector2 scale = new Vector2(sizeX.Value, sizeY.Value);
+                Vector2 pos = new Vector2(posX.Value, posY.Value) * (Vector2.One - scale);
+
+                targetSize = new RectangleF(pos, scale);
+            }
+
+            bool requiresMasking = targetSize.Size != Vector2.One
                                    // For the top level scaling container, for now we apply masking if safe areas are in use.
                                    // In the future this can likely be removed as more of the actual UI supports overflowing into the safe areas.
                                    || (targetMode == ScalingMode.Everything && safeAreaPadding.Value.Total != Vector2.Zero);
@@ -176,8 +187,8 @@ namespace osu.Game.Graphics.Containers
             if (requiresMasking)
                 sizableContainer.Masking = true;
 
-            sizableContainer.MoveTo(targetPosition, 500, Easing.OutQuart);
-            sizableContainer.ResizeTo(targetSize, 500, Easing.OutQuart).OnComplete(_ => { sizableContainer.Masking = requiresMasking; });
+            sizableContainer.MoveTo(targetSize.Location, 500, Easing.OutQuart);
+            sizableContainer.ResizeTo(targetSize.Size, 500, Easing.OutQuart).OnComplete(_ => { sizableContainer.Masking = requiresMasking; });
             sizableContainer.TransformTo(nameof(CornerRadius), requiresMasking ? corner_radius : 0, 500, requiresMasking ? Easing.OutQuart : Easing.None);
         }
 
diff --git a/osu.Game/Skinning/Editor/SkinComponentToolbox.cs b/osu.Game/Skinning/Editor/SkinComponentToolbox.cs
index 935d2756fb..ce9afd650a 100644
--- a/osu.Game/Skinning/Editor/SkinComponentToolbox.cs
+++ b/osu.Game/Skinning/Editor/SkinComponentToolbox.cs
@@ -23,6 +23,8 @@ namespace osu.Game.Skinning.Editor
 {
     public class SkinComponentToolbox : ScrollingToolboxGroup
     {
+        public const float WIDTH = 200;
+
         public Action<Type> RequestPlacement;
 
         private const float component_display_scale = 0.8f;
@@ -41,7 +43,7 @@ namespace osu.Game.Skinning.Editor
             : base("Components", height)
         {
             RelativeSizeAxes = Axes.None;
-            Width = 200;
+            Width = WIDTH;
         }
 
         [BackgroundDependencyLoader]
diff --git a/osu.Game/Skinning/Editor/SkinEditorOverlay.cs b/osu.Game/Skinning/Editor/SkinEditorOverlay.cs
index 86854ab6ff..dcfe28aaea 100644
--- a/osu.Game/Skinning/Editor/SkinEditorOverlay.cs
+++ b/osu.Game/Skinning/Editor/SkinEditorOverlay.cs
@@ -5,6 +5,7 @@ using JetBrains.Annotations;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.Primitives;
 using osu.Framework.Input.Bindings;
 using osu.Framework.Input.Events;
 using osu.Game.Graphics.Containers;
@@ -100,30 +101,14 @@ namespace osu.Game.Skinning.Editor
         {
             if (visibility.NewValue == Visibility.Visible)
             {
-                updateMasking();
-                target.AllowScaling = false;
-                target.RelativePositionAxes = Axes.Both;
-
-                target.ScaleTo(VISIBLE_TARGET_SCALE, SkinEditor.TRANSITION_DURATION, Easing.OutQuint);
-                target.MoveToX(0.095f, SkinEditor.TRANSITION_DURATION, Easing.OutQuint);
+                target.SetCustomScale(new RectangleF(0.18f, 0.1f, VISIBLE_TARGET_SCALE, VISIBLE_TARGET_SCALE), true);
             }
             else
             {
-                target.AllowScaling = true;
-
-                target.ScaleTo(1, SkinEditor.TRANSITION_DURATION, Easing.OutQuint).OnComplete(_ => updateMasking());
-                target.MoveToX(0f, SkinEditor.TRANSITION_DURATION, Easing.OutQuint);
+                target.SetCustomScale(null);
             }
         }
 
-        private void updateMasking()
-        {
-            if (skinEditor == null)
-                return;
-
-            target.Masking = skinEditor.State.Value == Visibility.Visible;
-        }
-
         public void OnReleased(KeyBindingReleaseEvent<GlobalAction> e)
         {
         }

From 8d7cdbd8833ba4db7990bd5d5fcbf808d5c65d21 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 2 Mar 2022 20:25:34 +0900
Subject: [PATCH 3161/5547] Add note about nested masking case

---
 .../Graphics/Containers/ScalingContainer.cs     | 17 +++++++++++------
 1 file changed, 11 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Graphics/Containers/ScalingContainer.cs b/osu.Game/Graphics/Containers/ScalingContainer.cs
index 5888be2ae7..df27c561d5 100644
--- a/osu.Game/Graphics/Containers/ScalingContainer.cs
+++ b/osu.Game/Graphics/Containers/ScalingContainer.cs
@@ -136,7 +136,7 @@ namespace osu.Game.Graphics.Containers
 
         private void updateSize()
         {
-            const float fade_time = 500;
+            const float duration = 500;
 
             if (targetMode == ScalingMode.Everything)
             {
@@ -155,10 +155,10 @@ namespace osu.Game.Graphics.Containers
                         backgroundStack.Push(new ScalingBackgroundScreen());
                     }
 
-                    backgroundStack.FadeIn(fade_time);
+                    backgroundStack.FadeIn(duration);
                 }
                 else
-                    backgroundStack?.FadeOut(fade_time);
+                    backgroundStack?.FadeOut(duration);
             }
 
             RectangleF targetSize = new RectangleF(Vector2.Zero, Vector2.One);
@@ -187,9 +187,14 @@ namespace osu.Game.Graphics.Containers
             if (requiresMasking)
                 sizableContainer.Masking = true;
 
-            sizableContainer.MoveTo(targetSize.Location, 500, Easing.OutQuart);
-            sizableContainer.ResizeTo(targetSize.Size, 500, Easing.OutQuart).OnComplete(_ => { sizableContainer.Masking = requiresMasking; });
-            sizableContainer.TransformTo(nameof(CornerRadius), requiresMasking ? corner_radius : 0, 500, requiresMasking ? Easing.OutQuart : Easing.None);
+            sizableContainer.MoveTo(targetSize.Location, duration, Easing.OutQuart);
+            sizableContainer.ResizeTo(targetSize.Size, duration, Easing.OutQuart);
+
+            // Of note, this will not working great in the case of nested ScalingContainers where multiple are applying corner radius.
+            // There should likely only be masking and corner radius applied at one point in the full game stack to fix this.
+            // An example of how this can occur is it the skin editor is visible and the game screen scaling is set to "Everything".
+            sizableContainer.TransformTo(nameof(CornerRadius), requiresMasking ? corner_radius : 0, duration, requiresMasking ? Easing.OutQuart : Easing.None)
+                            .OnComplete(_ => { sizableContainer.Masking = requiresMasking; });
         }
 
         private class ScalingBackgroundScreen : BackgroundScreenDefault

From b5684aaa76d8b345397eb1fff8c60dd2c25fcd60 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 2 Mar 2022 20:33:28 +0900
Subject: [PATCH 3162/5547] Scale -> Rect to read better

---
 .../Graphics/Containers/ScalingContainer.cs   | 26 +++++++++----------
 osu.Game/Skinning/Editor/SkinEditorOverlay.cs |  4 +--
 2 files changed, 15 insertions(+), 15 deletions(-)

diff --git a/osu.Game/Graphics/Containers/ScalingContainer.cs b/osu.Game/Graphics/Containers/ScalingContainer.cs
index df27c561d5..dd611b0904 100644
--- a/osu.Game/Graphics/Containers/ScalingContainer.cs
+++ b/osu.Game/Graphics/Containers/ScalingContainer.cs
@@ -39,16 +39,16 @@ namespace osu.Game.Graphics.Containers
 
         private BackgroundScreenStack backgroundStack;
 
-        private RectangleF? customScale;
-        private bool customScaleIsRelativePosition;
+        private RectangleF? customRect;
+        private bool customRectIsRelativePosition;
 
         /// <summary>
         /// Set a custom position and scale which overrides any user specification.
         /// </summary>
-        public void SetCustomScale(RectangleF? scale, bool relativePosition = false)
+        public void SetCustomRect(RectangleF? rect, bool relativePosition = false)
         {
-            customScale = scale;
-            customScaleIsRelativePosition = relativePosition;
+            customRect = rect;
+            customRectIsRelativePosition = relativePosition;
 
             if (IsLoaded) Scheduler.AddOnce(updateSize);
         }
@@ -161,13 +161,13 @@ namespace osu.Game.Graphics.Containers
                     backgroundStack?.FadeOut(duration);
             }
 
-            RectangleF targetSize = new RectangleF(Vector2.Zero, Vector2.One);
+            RectangleF targetRect = new RectangleF(Vector2.Zero, Vector2.One);
 
-            if (customScale != null)
+            if (customRect != null)
             {
-                sizableContainer.RelativePositionAxes = customScaleIsRelativePosition ? Axes.Both : Axes.None;
+                sizableContainer.RelativePositionAxes = customRectIsRelativePosition ? Axes.Both : Axes.None;
 
-                targetSize = customScale.Value;
+                targetRect = customRect.Value;
             }
             else if (targetMode == null || scalingMode.Value == targetMode)
             {
@@ -176,10 +176,10 @@ namespace osu.Game.Graphics.Containers
                 Vector2 scale = new Vector2(sizeX.Value, sizeY.Value);
                 Vector2 pos = new Vector2(posX.Value, posY.Value) * (Vector2.One - scale);
 
-                targetSize = new RectangleF(pos, scale);
+                targetRect = new RectangleF(pos, scale);
             }
 
-            bool requiresMasking = targetSize.Size != Vector2.One
+            bool requiresMasking = targetRect.Size != Vector2.One
                                    // For the top level scaling container, for now we apply masking if safe areas are in use.
                                    // In the future this can likely be removed as more of the actual UI supports overflowing into the safe areas.
                                    || (targetMode == ScalingMode.Everything && safeAreaPadding.Value.Total != Vector2.Zero);
@@ -187,8 +187,8 @@ namespace osu.Game.Graphics.Containers
             if (requiresMasking)
                 sizableContainer.Masking = true;
 
-            sizableContainer.MoveTo(targetSize.Location, duration, Easing.OutQuart);
-            sizableContainer.ResizeTo(targetSize.Size, duration, Easing.OutQuart);
+            sizableContainer.MoveTo(targetRect.Location, duration, Easing.OutQuart);
+            sizableContainer.ResizeTo(targetRect.Size, duration, Easing.OutQuart);
 
             // Of note, this will not working great in the case of nested ScalingContainers where multiple are applying corner radius.
             // There should likely only be masking and corner radius applied at one point in the full game stack to fix this.
diff --git a/osu.Game/Skinning/Editor/SkinEditorOverlay.cs b/osu.Game/Skinning/Editor/SkinEditorOverlay.cs
index dcfe28aaea..61c363b019 100644
--- a/osu.Game/Skinning/Editor/SkinEditorOverlay.cs
+++ b/osu.Game/Skinning/Editor/SkinEditorOverlay.cs
@@ -101,11 +101,11 @@ namespace osu.Game.Skinning.Editor
         {
             if (visibility.NewValue == Visibility.Visible)
             {
-                target.SetCustomScale(new RectangleF(0.18f, 0.1f, VISIBLE_TARGET_SCALE, VISIBLE_TARGET_SCALE), true);
+                target.SetCustomRect(new RectangleF(0.18f, 0.1f, VISIBLE_TARGET_SCALE, VISIBLE_TARGET_SCALE), true);
             }
             else
             {
-                target.SetCustomScale(null);
+                target.SetCustomRect(null);
             }
         }
 

From 6caecf79a012f988a9f08ab94fe6930631e6fd8f Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Wed, 2 Mar 2022 20:06:28 +0800
Subject: [PATCH 3163/5547] Use smooth speed change

---
 osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs | 15 ++++++++++++---
 1 file changed, 12 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs b/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs
index 9a6705ea09..b6df56dd76 100644
--- a/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs
+++ b/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs
@@ -7,6 +7,7 @@ using System.Linq;
 using osu.Framework.Audio;
 using osu.Framework.Audio.Track;
 using osu.Framework.Bindables;
+using osu.Framework.Graphics;
 using osu.Framework.Graphics.Audio;
 using osu.Framework.Utils;
 using osu.Game.Beatmaps;
@@ -14,10 +15,11 @@ using osu.Game.Configuration;
 using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Objects.Drawables;
 using osu.Game.Rulesets.Scoring;
+using osu.Game.Screens.Play;
 
 namespace osu.Game.Rulesets.Mods
 {
-    public class ModAdaptiveSpeed : Mod, IApplicableToRate, IApplicableToDrawableHitObject, IApplicableToBeatmap
+    public class ModAdaptiveSpeed : Mod, IApplicableToRate, IApplicableToDrawableHitObject, IApplicableToBeatmap, IApplicableToHUD
     {
         // use a wider range so there's still room for adjustment when the initial rate is extreme
         private const double fastest_rate = 2.5f;
@@ -65,6 +67,7 @@ namespace osu.Game.Rulesets.Mods
         };
 
         private ITrack track;
+        private HUDOverlay overlay;
 
         private readonly List<double> recentRates = Enumerable.Range(0, average_count).Select(_ => 1d).ToList();
 
@@ -82,6 +85,12 @@ namespace osu.Game.Rulesets.Mods
             AdjustPitch.BindValueChanged(applyPitchAdjustment);
         }
 
+        public void ApplyToHUD(HUDOverlay overlay)
+        {
+            // this is only used to transform the SpeedChange bindable
+            this.overlay = overlay;
+        }
+
         public void ApplyToTrack(ITrack track)
         {
             this.track = track;
@@ -127,7 +136,7 @@ namespace osu.Game.Rulesets.Mods
                     recentRates.RemoveAt(0);
                 }
 
-                SpeedChange.Value = recentRates.Average();
+                overlay.TransformBindableTo(SpeedChange, recentRates.Average(), 100);
             };
             drawable.OnRevertResult += (o, result) =>
             {
@@ -146,7 +155,7 @@ namespace osu.Game.Rulesets.Mods
                     recentRates.RemoveAt(recentRates.Count - 1);
                 }
 
-                SpeedChange.Value = recentRates.Average();
+                overlay.TransformBindableTo(SpeedChange, recentRates.Average(), 100);
             };
         }
 

From 17bc7142979d43fedcd23cfe1f67c7d87c6300d0 Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Wed, 2 Mar 2022 20:48:57 +0800
Subject: [PATCH 3164/5547] Allow the mod to properly react to nested hit
 objects

---
 osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs | 41 ++++++++++------------
 1 file changed, 18 insertions(+), 23 deletions(-)

diff --git a/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs b/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs
index b6df56dd76..db631520ab 100644
--- a/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs
+++ b/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs
@@ -123,37 +123,32 @@ namespace osu.Game.Rulesets.Mods
         {
             drawable.OnNewResult += (o, result) =>
             {
+                if (dequeuedRates.ContainsKey(result.HitObject)) return;
+
                 if (!result.IsHit) return;
+                if (!result.Type.AffectsAccuracy()) return;
                 if (!previousEndTimes.ContainsKey(result.HitObject)) return;
 
                 double prevEndTime = previousEndTimes[result.HitObject];
 
                 recentRates.Add(Math.Clamp((result.HitObject.GetEndTime() - prevEndTime) / (result.TimeAbsolute - prevEndTime) * SpeedChange.Value, slowest_rate, fastest_rate));
 
-                if (recentRates.Count > average_count)
-                {
-                    dequeuedRates.Add(result.HitObject, recentRates[0]);
-                    recentRates.RemoveAt(0);
-                }
+                dequeuedRates.Add(result.HitObject, recentRates[0]);
+                recentRates.RemoveAt(0);
 
                 overlay.TransformBindableTo(SpeedChange, recentRates.Average(), 100);
             };
             drawable.OnRevertResult += (o, result) =>
             {
+                if (!dequeuedRates.ContainsKey(result.HitObject)) return;
+
                 if (!result.IsHit) return;
+                if (!result.Type.AffectsAccuracy()) return;
                 if (!previousEndTimes.ContainsKey(result.HitObject)) return;
 
-                if (dequeuedRates.ContainsKey(result.HitObject))
-                {
-                    recentRates.Insert(0, dequeuedRates[result.HitObject]);
-                    recentRates.RemoveAt(recentRates.Count - 1);
-                    dequeuedRates.Remove(result.HitObject);
-                }
-                else
-                {
-                    recentRates.Insert(0, InitialRate.Value);
-                    recentRates.RemoveAt(recentRates.Count - 1);
-                }
+                recentRates.Insert(0, dequeuedRates[result.HitObject]);
+                recentRates.RemoveAt(recentRates.Count - 1);
+                dequeuedRates.Remove(result.HitObject);
 
                 overlay.TransformBindableTo(SpeedChange, recentRates.Average(), 100);
             };
@@ -161,11 +156,11 @@ namespace osu.Game.Rulesets.Mods
 
         public void ApplyToBeatmap(IBeatmap beatmap)
         {
-            var endTimes = getEndTimes(beatmap.HitObjects).OrderBy(x => x).ToList();
+            var hitObjects = getAllApplicableHitObjects(beatmap.HitObjects).ToList();
+            var endTimes = hitObjects.Select(x => x.GetEndTime()).OrderBy(x => x).ToList();
 
-            for (int i = 1; i < beatmap.HitObjects.Count; i++)
+            foreach (HitObject hitObject in hitObjects)
             {
-                var hitObject = beatmap.HitObjects[i];
                 double prevEndTime = endTimes.LastOrDefault(ht => !Precision.AlmostBigger(ht, hitObject.GetEndTime()));
 
                 if (prevEndTime != default)
@@ -173,15 +168,15 @@ namespace osu.Game.Rulesets.Mods
             }
         }
 
-        private IEnumerable<double> getEndTimes(IEnumerable<HitObject> hitObjects)
+        private IEnumerable<HitObject> getAllApplicableHitObjects(IEnumerable<HitObject> hitObjects)
         {
             foreach (var hitObject in hitObjects)
             {
                 if (!(hitObject.HitWindows is HitWindows.EmptyHitWindows))
-                    yield return hitObject.GetEndTime();
+                    yield return hitObject;
 
-                foreach (double hitTime in getEndTimes(hitObject.NestedHitObjects))
-                    yield return hitTime;
+                foreach (HitObject nested in getAllApplicableHitObjects(hitObject.NestedHitObjects))
+                    yield return nested;
             }
         }
     }

From d335a2229f448a7a9f30f6b144910aafe398be83 Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Wed, 2 Mar 2022 21:07:57 +0800
Subject: [PATCH 3165/5547] Tweak `average_count`

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

diff --git a/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs b/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs
index db631520ab..7c92bd8141 100644
--- a/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs
+++ b/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs
@@ -28,7 +28,7 @@ namespace osu.Game.Rulesets.Mods
         /// <summary>
         /// Adjust track rate using the average speed of the last x hits
         /// </summary>
-        private const int average_count = 10;
+        private const int average_count = 6;
 
         public override string Name => "Adaptive Speed";
 

From e14a35b469de3841c3d573758b9a5266d99abb93 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 2 Mar 2022 20:32:03 +0300
Subject: [PATCH 3166/5547] Add failing test case

---
 .../Gameplay/TestSceneStoryboardSamples.cs    | 59 -------------
 .../TestSceneStoryboardSamplePlayback.cs      | 83 +++++++++++++++++--
 osu.Game/Tests/Visual/TestPlayer.cs           |  3 -
 3 files changed, 78 insertions(+), 67 deletions(-)

diff --git a/osu.Game.Tests/Gameplay/TestSceneStoryboardSamples.cs b/osu.Game.Tests/Gameplay/TestSceneStoryboardSamples.cs
index 88862ea28b..6457a23a1b 100644
--- a/osu.Game.Tests/Gameplay/TestSceneStoryboardSamples.cs
+++ b/osu.Game.Tests/Gameplay/TestSceneStoryboardSamples.cs
@@ -1,29 +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 System;
 using System.Collections.Generic;
 using System.IO;
-using System.Linq;
 using System.Threading;
 using System.Threading.Tasks;
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
 using osu.Framework.Audio.Sample;
-using osu.Framework.Graphics.Audio;
 using osu.Framework.Graphics.Textures;
 using osu.Framework.IO.Stores;
 using osu.Framework.Testing;
-using osu.Framework.Utils;
 using osu.Game.Audio;
 using osu.Game.Configuration;
 using osu.Game.Database;
 using osu.Game.IO;
 using osu.Game.Rulesets;
-using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Osu;
-using osu.Game.Rulesets.Osu.Mods;
 using osu.Game.Rulesets.UI;
 using osu.Game.Screens.Play;
 using osu.Game.Skinning;
@@ -118,59 +112,6 @@ namespace osu.Game.Tests.Gameplay
             AddUntilStep("sample has lifetime end", () => sample.LifetimeEnd < double.MaxValue);
         }
 
-        [TestCase(typeof(OsuModDoubleTime), 1.5)]
-        [TestCase(typeof(OsuModHalfTime), 0.75)]
-        [TestCase(typeof(ModWindUp), 1.5)]
-        [TestCase(typeof(ModWindDown), 0.75)]
-        [TestCase(typeof(OsuModDoubleTime), 2)]
-        [TestCase(typeof(OsuModHalfTime), 0.5)]
-        [TestCase(typeof(ModWindUp), 2)]
-        [TestCase(typeof(ModWindDown), 0.5)]
-        public void TestSamplePlaybackWithRateMods(Type expectedMod, double expectedRate)
-        {
-            GameplayClockContainer gameplayContainer = null;
-            StoryboardSampleInfo sampleInfo = null;
-            TestDrawableStoryboardSample sample = null;
-
-            Mod testedMod = Activator.CreateInstance(expectedMod) as Mod;
-
-            switch (testedMod)
-            {
-                case ModRateAdjust m:
-                    m.SpeedChange.Value = expectedRate;
-                    break;
-
-                case ModTimeRamp m:
-                    m.FinalRate.Value = m.InitialRate.Value = expectedRate;
-                    break;
-            }
-
-            AddStep("setup storyboard sample", () =>
-            {
-                Beatmap.Value = new TestCustomSkinWorkingBeatmap(new OsuRuleset().RulesetInfo, this);
-                SelectedMods.Value = new[] { testedMod };
-
-                var beatmapSkinSourceContainer = new BeatmapSkinProvidingContainer(Beatmap.Value.Skin);
-
-                Add(gameplayContainer = new MasterGameplayClockContainer(Beatmap.Value, 0)
-                {
-                    Child = beatmapSkinSourceContainer
-                });
-
-                beatmapSkinSourceContainer.Add(sample = new TestDrawableStoryboardSample(sampleInfo = new StoryboardSampleInfo("test-sample", 1, 1))
-                {
-                    Clock = gameplayContainer.GameplayClock
-                });
-            });
-
-            AddStep("start", () => gameplayContainer.Start());
-
-            AddAssert("sample playback rate matches mod rates", () =>
-                testedMod != null && Precision.AlmostEquals(
-                    sample.ChildrenOfType<DrawableSample>().First().AggregateFrequency.Value,
-                    ((IApplicableToRate)testedMod).ApplyToRate(sampleInfo.StartTime)));
-        }
-
         [Test]
         public void TestSamplePlaybackWithBeatmapHitsoundsOff()
         {
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboardSamplePlayback.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboardSamplePlayback.cs
index 95603b5c04..7a74a00c68 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboardSamplePlayback.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboardSamplePlayback.cs
@@ -1,17 +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 System;
 using System.Collections.Generic;
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
+using osu.Framework.Extensions.ObjectExtensions;
+using osu.Framework.Graphics.Audio;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
 using osu.Game.Configuration;
 using osu.Game.Rulesets;
+using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Osu;
+using osu.Game.Rulesets.Osu.Mods;
 using osu.Game.Storyboards;
 using osu.Game.Storyboards.Drawables;
+using osuTK.Input;
 
 namespace osu.Game.Tests.Visual.Gameplay
 {
@@ -19,6 +25,10 @@ namespace osu.Game.Tests.Visual.Gameplay
     {
         private Storyboard storyboard;
 
+        private IReadOnlyList<Mod> storyboardMods;
+
+        protected override bool HasCustomSteps => true;
+
         [BackgroundDependencyLoader]
         private void load(OsuConfigManager config)
         {
@@ -31,10 +41,13 @@ namespace osu.Game.Tests.Visual.Gameplay
             backgroundLayer.Add(new StoryboardSampleInfo("Intro/welcome.mp3", time: 0, volume: 20));
         }
 
+        [SetUp]
+        public void SetUp() => Schedule(() => storyboardMods = Array.Empty<Mod>());
+
         [Test]
         public void TestStoryboardSamplesStopDuringPause()
         {
-            checkForFirstSamplePlayback();
+            createPlayerTest();
 
             AddStep("player paused", () => Player.Pause());
             AddAssert("player is currently paused", () => Player.GameplayClockContainer.IsPaused.Value);
@@ -47,26 +60,86 @@ namespace osu.Game.Tests.Visual.Gameplay
         [Test]
         public void TestStoryboardSamplesStopOnSkip()
         {
-            checkForFirstSamplePlayback();
+            createPlayerTest(true);
 
-            AddStep("skip intro", () => InputManager.Key(osuTK.Input.Key.Space));
             AddAssert("all storyboard samples stopped immediately", () => allStoryboardSamples.All(sound => !sound.IsPlaying));
 
             AddUntilStep("any storyboard samples playing after skip", () => allStoryboardSamples.Any(sound => sound.IsPlaying));
         }
 
-        private void checkForFirstSamplePlayback()
+        [TestCase(typeof(OsuModDoubleTime), 1.5)]
+        [TestCase(typeof(OsuModDoubleTime), 2)]
+        [TestCase(typeof(OsuModHalfTime), 0.75)]
+        [TestCase(typeof(OsuModHalfTime), 0.5)]
+        public void TestStoryboardSamplesPlaybackWithRateAdjustMods(Type expectedMod, double expectedRate)
         {
+            AddStep("setup mod", () =>
+            {
+                ModRateAdjust testedMod = (ModRateAdjust)Activator.CreateInstance(expectedMod).AsNonNull();
+                testedMod.SpeedChange.Value = expectedRate;
+                storyboardMods = new[] { testedMod };
+            });
+
+            createPlayerTest(true);
+
+            AddAssert("sample playback rate matches mod rates", () => allStoryboardSamples.All(sound =>
+            {
+                return sound.ChildrenOfType<DrawableSample>().All(s => s.AggregateFrequency.Value == expectedRate);
+            }));
+        }
+
+        [TestCase(typeof(ModWindUp), 0.5, 2)]
+        [TestCase(typeof(ModWindUp), 1.51, 2)]
+        [TestCase(typeof(ModWindDown), 2, 0.5)]
+        [TestCase(typeof(ModWindDown), 0.99, 0.5)]
+        public void TestStoryboardSamplesPlaybackWithTimeRampMods(Type expectedMod, double initialRate, double finalRate)
+        {
+            AddStep("setup mod", () =>
+            {
+                ModTimeRamp testedMod = (ModTimeRamp)Activator.CreateInstance(expectedMod).AsNonNull();
+                testedMod.InitialRate.Value = initialRate;
+                testedMod.FinalRate.Value = finalRate;
+                storyboardMods = new[] { testedMod };
+            });
+
+            createPlayerTest(true);
+
+            ModTimeRamp gameplayMod = null;
+
+            AddUntilStep("mod speed change updated", () =>
+            {
+                gameplayMod = Player.GameplayState.Mods.OfType<ModTimeRamp>().Single();
+                return gameplayMod.SpeedChange.Value != initialRate;
+            });
+
+            AddAssert("sample playback rate matches mod rates", () => allStoryboardSamples.All(sound =>
+            {
+                return sound.ChildrenOfType<DrawableSample>().All(s => s.AggregateFrequency.Value == gameplayMod.SpeedChange.Value);
+            }));
+        }
+
+        private void createPlayerTest(bool skipIntro = false)
+        {
+            CreateTest(null);
+
             AddAssert("storyboard loaded", () => Player.Beatmap.Value.Storyboard != null);
             AddUntilStep("any storyboard samples playing", () => allStoryboardSamples.Any(sound => sound.IsPlaying));
+
+            if (skipIntro)
+                AddStep("skip intro", () => InputManager.Key(Key.Space));
         }
 
         private IEnumerable<DrawableStoryboardSample> allStoryboardSamples => Player.ChildrenOfType<DrawableStoryboardSample>();
 
         protected override bool AllowFail => false;
 
+        protected override TestPlayer CreatePlayer(Ruleset ruleset)
+        {
+            SelectedMods.Value = SelectedMods.Value.Concat(storyboardMods).ToArray();
+            return new TestPlayer(true, false);
+        }
+
         protected override Ruleset CreatePlayerRuleset() => new OsuRuleset();
-        protected override TestPlayer CreatePlayer(Ruleset ruleset) => new TestPlayer(true, false);
 
         protected override WorkingBeatmap CreateWorkingBeatmap(IBeatmap beatmap, Storyboard storyboard = null) =>
             new ClockBackedTestWorkingBeatmap(beatmap, storyboard ?? this.storyboard, Clock, Audio);
diff --git a/osu.Game/Tests/Visual/TestPlayer.cs b/osu.Game/Tests/Visual/TestPlayer.cs
index 368f792e28..d463905cf4 100644
--- a/osu.Game/Tests/Visual/TestPlayer.cs
+++ b/osu.Game/Tests/Visual/TestPlayer.cs
@@ -26,9 +26,6 @@ namespace osu.Game.Tests.Visual
 
         public new DrawableRuleset DrawableRuleset => base.DrawableRuleset;
 
-        /// <summary>
-        /// Mods from *player* (not OsuScreen).
-        /// </summary>
         public new Bindable<IReadOnlyList<Mod>> Mods => base.Mods;
 
         public new HUDOverlay HUDOverlay => base.HUDOverlay;

From cbb8dc28914a4c7a8cb636ea5b58534869eea934 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 2 Mar 2022 20:33:46 +0300
Subject: [PATCH 3167/5547] Fix storyboard samples rate not adjusted from
 actual gameplay mods

---
 .../Visual/Gameplay/TestSceneStoryboard.cs          |  4 ++--
 .../Backgrounds/BeatmapBackgroundWithStoryboard.cs  |  8 +++++++-
 osu.Game/Screens/Play/DimmableStoryboard.cs         |  9 +++++++--
 osu.Game/Screens/Play/Player.cs                     |  2 +-
 .../Storyboards/Drawables/DrawableStoryboard.cs     |  9 ++++++++-
 .../Drawables/DrawableStoryboardSample.cs           | 13 ++++++++-----
 osu.Game/Storyboards/Storyboard.cs                  |  5 +++--
 7 files changed, 36 insertions(+), 14 deletions(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboard.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboard.cs
index 3b6d02c67c..014ccb1652 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboard.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboard.cs
@@ -94,7 +94,7 @@ namespace osu.Game.Tests.Visual.Gameplay
             var decoupledClock = new DecoupleableInterpolatingFramedClock { IsCoupled = true };
             storyboardContainer.Clock = decoupledClock;
 
-            storyboard = working.Storyboard.CreateDrawable(Beatmap.Value);
+            storyboard = working.Storyboard.CreateDrawable(SelectedMods.Value);
             storyboard.Passing = false;
 
             storyboardContainer.Add(storyboard);
@@ -118,7 +118,7 @@ namespace osu.Game.Tests.Visual.Gameplay
                 sb = decoder.Decode(bfr);
             }
 
-            storyboard = sb.CreateDrawable(Beatmap.Value);
+            storyboard = sb.CreateDrawable(SelectedMods.Value);
 
             storyboardContainer.Add(storyboard);
             decoupledClock.ChangeSource(Beatmap.Value.Track);
diff --git a/osu.Game/Graphics/Backgrounds/BeatmapBackgroundWithStoryboard.cs b/osu.Game/Graphics/Backgrounds/BeatmapBackgroundWithStoryboard.cs
index 56ef87c1f4..7aed442800 100644
--- a/osu.Game/Graphics/Backgrounds/BeatmapBackgroundWithStoryboard.cs
+++ b/osu.Game/Graphics/Backgrounds/BeatmapBackgroundWithStoryboard.cs
@@ -3,12 +3,15 @@
 
 #nullable enable
 
+using System.Collections.Generic;
 using osu.Framework.Allocation;
+using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Timing;
 using osu.Game.Beatmaps;
 using osu.Game.Overlays;
+using osu.Game.Rulesets.Mods;
 using osu.Game.Storyboards.Drawables;
 
 namespace osu.Game.Graphics.Backgrounds
@@ -20,6 +23,9 @@ namespace osu.Game.Graphics.Backgrounds
         [Resolved(CanBeNull = true)]
         private MusicController? musicController { get; set; }
 
+        [Resolved]
+        private IBindable<IReadOnlyList<Mod>> mods { get; set; } = null!;
+
         public BeatmapBackgroundWithStoryboard(WorkingBeatmap beatmap, string fallbackTextureName = "Backgrounds/bg1")
             : base(beatmap, fallbackTextureName)
         {
@@ -39,7 +45,7 @@ namespace osu.Game.Graphics.Backgrounds
             {
                 RelativeSizeAxes = Axes.Both,
                 Volume = { Value = 0 },
-                Child = new DrawableStoryboard(Beatmap.Storyboard) { Clock = storyboardClock }
+                Child = new DrawableStoryboard(Beatmap.Storyboard, mods.Value) { Clock = storyboardClock }
             }, AddInternal);
         }
 
diff --git a/osu.Game/Screens/Play/DimmableStoryboard.cs b/osu.Game/Screens/Play/DimmableStoryboard.cs
index f8cedddfbe..5a3ef1e9d3 100644
--- a/osu.Game/Screens/Play/DimmableStoryboard.cs
+++ b/osu.Game/Screens/Play/DimmableStoryboard.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.Collections.Generic;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Graphics.Containers;
+using osu.Game.Rulesets.Mods;
 using osu.Game.Storyboards;
 using osu.Game.Storyboards.Drawables;
 
@@ -18,6 +20,8 @@ namespace osu.Game.Screens.Play
         public Container OverlayLayerContainer { get; private set; }
 
         private readonly Storyboard storyboard;
+        private readonly IReadOnlyList<Mod> mods;
+
         private DrawableStoryboard drawableStoryboard;
 
         /// <summary>
@@ -28,9 +32,10 @@ namespace osu.Game.Screens.Play
         /// </remarks>
         public IBindable<bool> HasStoryboardEnded = new BindableBool(true);
 
-        public DimmableStoryboard(Storyboard storyboard)
+        public DimmableStoryboard(Storyboard storyboard, IReadOnlyList<Mod> mods)
         {
             this.storyboard = storyboard;
+            this.mods = mods;
         }
 
         [BackgroundDependencyLoader]
@@ -57,7 +62,7 @@ namespace osu.Game.Screens.Play
             if (!ShowStoryboard.Value && !IgnoreUserSettings.Value)
                 return;
 
-            drawableStoryboard = storyboard.CreateDrawable();
+            drawableStoryboard = storyboard.CreateDrawable(mods);
             HasStoryboardEnded.BindTo(drawableStoryboard.HasStoryboardEnded);
 
             if (async)
diff --git a/osu.Game/Screens/Play/Player.cs b/osu.Game/Screens/Play/Player.cs
index d4b02622d3..8ce3f1587d 100644
--- a/osu.Game/Screens/Play/Player.cs
+++ b/osu.Game/Screens/Play/Player.cs
@@ -355,7 +355,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) { RelativeSizeAxes = Axes.Both };
+            DimmableStoryboard = new DimmableStoryboard(Beatmap.Value.Storyboard, GameplayState.Mods) { RelativeSizeAxes = Axes.Both };
 
         private Drawable createGameplayComponents(IWorkingBeatmap working) => new ScalingContainer(ScalingMode.Gameplay)
         {
diff --git a/osu.Game/Storyboards/Drawables/DrawableStoryboard.cs b/osu.Game/Storyboards/Drawables/DrawableStoryboard.cs
index e6528a83bd..840500347f 100644
--- a/osu.Game/Storyboards/Drawables/DrawableStoryboard.cs
+++ b/osu.Game/Storyboards/Drawables/DrawableStoryboard.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 System.Threading;
 using osuTK;
@@ -11,6 +13,7 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Textures;
 using osu.Framework.Platform;
 using osu.Game.Database;
+using osu.Game.Rulesets.Mods;
 using osu.Game.Screens.Play;
 using osu.Game.Stores;
 
@@ -50,14 +53,18 @@ namespace osu.Game.Storyboards.Drawables
 
         private double? lastEventEndTime;
 
+        [Cached(typeof(IReadOnlyList<Mod>))]
+        public IReadOnlyList<Mod> Mods { get; }
+
         private DependencyContainer dependencies;
 
         protected override IReadOnlyDependencyContainer CreateChildDependencies(IReadOnlyDependencyContainer parent) =>
             dependencies = new DependencyContainer(base.CreateChildDependencies(parent));
 
-        public DrawableStoryboard(Storyboard storyboard)
+        public DrawableStoryboard(Storyboard storyboard, IReadOnlyList<Mod> mods)
         {
             Storyboard = storyboard;
+            Mods = mods ?? Array.Empty<Mod>();
 
             Size = new Vector2(640, 480);
 
diff --git a/osu.Game/Storyboards/Drawables/DrawableStoryboardSample.cs b/osu.Game/Storyboards/Drawables/DrawableStoryboardSample.cs
index 672274a2ad..4e3f72512c 100644
--- a/osu.Game/Storyboards/Drawables/DrawableStoryboardSample.cs
+++ b/osu.Game/Storyboards/Drawables/DrawableStoryboardSample.cs
@@ -28,17 +28,20 @@ namespace osu.Game.Storyboards.Drawables
             LifetimeStart = sampleInfo.StartTime;
         }
 
-        [Resolved]
-        private IBindable<IReadOnlyList<Mod>> mods { get; set; }
+        [Resolved(CanBeNull = true)]
+        private IReadOnlyList<Mod> mods { get; set; }
 
         protected override void SkinChanged(ISkinSource skin)
         {
             base.SkinChanged(skin);
 
-            foreach (var mod in mods.Value.OfType<IApplicableToSample>())
+            if (mods != null)
             {
-                foreach (var sample in DrawableSamples)
-                    mod.ApplyToSample(sample);
+                foreach (var mod in mods.OfType<IApplicableToSample>())
+                {
+                    foreach (var sample in DrawableSamples)
+                        mod.ApplyToSample(sample);
+                }
             }
         }
 
diff --git a/osu.Game/Storyboards/Storyboard.cs b/osu.Game/Storyboards/Storyboard.cs
index c4864c0334..2faed98ae0 100644
--- a/osu.Game/Storyboards/Storyboard.cs
+++ b/osu.Game/Storyboards/Storyboard.cs
@@ -9,6 +9,7 @@ using osu.Framework.Graphics.Sprites;
 using osu.Framework.Graphics.Textures;
 using osu.Game.Beatmaps;
 using osu.Game.Extensions;
+using osu.Game.Rulesets.Mods;
 using osu.Game.Skinning;
 using osu.Game.Storyboards.Drawables;
 
@@ -90,8 +91,8 @@ namespace osu.Game.Storyboards
             }
         }
 
-        public DrawableStoryboard CreateDrawable(IWorkingBeatmap working = null) =>
-            new DrawableStoryboard(this);
+        public DrawableStoryboard CreateDrawable(IReadOnlyList<Mod> mods = null) =>
+            new DrawableStoryboard(this, mods);
 
         public Drawable CreateSpriteFromResourcePath(string path, TextureStore textureStore)
         {

From b286122413b21be910bf29c8349f3030d3e4b2f3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 3 Mar 2022 03:54:39 +0900
Subject: [PATCH 3168/5547] Move uninstaller registry operation to
 `onInitialInstall`

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

diff --git a/osu.Desktop/Program.cs b/osu.Desktop/Program.cs
index 0e11e172e1..e317a44bc3 100644
--- a/osu.Desktop/Program.cs
+++ b/osu.Desktop/Program.cs
@@ -116,6 +116,7 @@ namespace osu.Desktop
             SquirrelAwareApp.HandleEvents(onInitialInstall: (version, tools) =>
             {
                 tools.CreateShortcutForThisExe();
+                tools.CreateUninstallerRegistryEntry();
             }, onAppUninstall: (version, tools) =>
             {
                 tools.RemoveShortcutForThisExe();
@@ -123,9 +124,6 @@ namespace osu.Desktop
             }, onEveryRun: (version, tools, firstRun) =>
             {
                 tools.SetProcessAppUserModelId();
-
-                if (firstRun)
-                    tools.CreateUninstallerRegistryEntry();
             });
         }
 

From a812ed4462a5126ff9ba2eb2d858814e59a2ddee Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 2 Mar 2022 23:40:14 +0300
Subject: [PATCH 3169/5547] Ensure there is at least one sample during rate
 assertion

---
 .../Visual/Gameplay/TestSceneStoryboardSamplePlayback.cs  | 8 ++------
 1 file changed, 2 insertions(+), 6 deletions(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboardSamplePlayback.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboardSamplePlayback.cs
index 7a74a00c68..44529aa78c 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboardSamplePlayback.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboardSamplePlayback.cs
@@ -83,9 +83,7 @@ namespace osu.Game.Tests.Visual.Gameplay
             createPlayerTest(true);
 
             AddAssert("sample playback rate matches mod rates", () => allStoryboardSamples.All(sound =>
-            {
-                return sound.ChildrenOfType<DrawableSample>().All(s => s.AggregateFrequency.Value == expectedRate);
-            }));
+                sound.ChildrenOfType<DrawableSample>().First().AggregateFrequency.Value == expectedRate));
         }
 
         [TestCase(typeof(ModWindUp), 0.5, 2)]
@@ -113,9 +111,7 @@ namespace osu.Game.Tests.Visual.Gameplay
             });
 
             AddAssert("sample playback rate matches mod rates", () => allStoryboardSamples.All(sound =>
-            {
-                return sound.ChildrenOfType<DrawableSample>().All(s => s.AggregateFrequency.Value == gameplayMod.SpeedChange.Value);
-            }));
+                sound.ChildrenOfType<DrawableSample>().First().AggregateFrequency.Value == gameplayMod.SpeedChange.Value));
         }
 
         private void createPlayerTest(bool skipIntro = false)

From 82bbc32d74147ce99680e4a5c99e4ffed1bb00b9 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 2 Mar 2022 23:44:58 +0300
Subject: [PATCH 3170/5547] Remove unnecessary `Schedule` during setup

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

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboardSamplePlayback.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboardSamplePlayback.cs
index 44529aa78c..1d50901fec 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboardSamplePlayback.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboardSamplePlayback.cs
@@ -42,7 +42,7 @@ namespace osu.Game.Tests.Visual.Gameplay
         }
 
         [SetUp]
-        public void SetUp() => Schedule(() => storyboardMods = Array.Empty<Mod>());
+        public void SetUp() => storyboardMods = Array.Empty<Mod>();
 
         [Test]
         public void TestStoryboardSamplesStopDuringPause()

From bb94d68139478a11054f76dc0258e590997e6b4c Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 2 Mar 2022 23:55:42 +0300
Subject: [PATCH 3171/5547] Separate storyboard samples and skip intro steps to
 own methods

---
 .../TestSceneStoryboardSamplePlayback.cs      | 30 +++++++++++--------
 1 file changed, 18 insertions(+), 12 deletions(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboardSamplePlayback.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboardSamplePlayback.cs
index 1d50901fec..6b74868944 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboardSamplePlayback.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboardSamplePlayback.cs
@@ -51,20 +51,21 @@ namespace osu.Game.Tests.Visual.Gameplay
 
             AddStep("player paused", () => Player.Pause());
             AddAssert("player is currently paused", () => Player.GameplayClockContainer.IsPaused.Value);
-            AddAssert("all storyboard samples stopped immediately", () => allStoryboardSamples.All(sound => !sound.IsPlaying));
+            allStoryobardSamplesStopped();
 
             AddStep("player resume", () => Player.Resume());
-            AddUntilStep("any storyboard samples playing after resume", () => allStoryboardSamples.Any(sound => sound.IsPlaying));
+            waitUntilStoryboardSamplesPlay();
         }
 
         [Test]
         public void TestStoryboardSamplesStopOnSkip()
         {
-            createPlayerTest(true);
+            createPlayerTest();
 
-            AddAssert("all storyboard samples stopped immediately", () => allStoryboardSamples.All(sound => !sound.IsPlaying));
+            skipIntro();
+            allStoryobardSamplesStopped();
 
-            AddUntilStep("any storyboard samples playing after skip", () => allStoryboardSamples.Any(sound => sound.IsPlaying));
+            waitUntilStoryboardSamplesPlay();
         }
 
         [TestCase(typeof(OsuModDoubleTime), 1.5)]
@@ -80,7 +81,8 @@ namespace osu.Game.Tests.Visual.Gameplay
                 storyboardMods = new[] { testedMod };
             });
 
-            createPlayerTest(true);
+            createPlayerTest();
+            skipIntro();
 
             AddAssert("sample playback rate matches mod rates", () => allStoryboardSamples.All(sound =>
                 sound.ChildrenOfType<DrawableSample>().First().AggregateFrequency.Value == expectedRate));
@@ -100,7 +102,8 @@ namespace osu.Game.Tests.Visual.Gameplay
                 storyboardMods = new[] { testedMod };
             });
 
-            createPlayerTest(true);
+            createPlayerTest();
+            skipIntro();
 
             ModTimeRamp gameplayMod = null;
 
@@ -114,17 +117,20 @@ namespace osu.Game.Tests.Visual.Gameplay
                 sound.ChildrenOfType<DrawableSample>().First().AggregateFrequency.Value == gameplayMod.SpeedChange.Value));
         }
 
-        private void createPlayerTest(bool skipIntro = false)
+        private void createPlayerTest()
         {
             CreateTest(null);
 
             AddAssert("storyboard loaded", () => Player.Beatmap.Value.Storyboard != null);
-            AddUntilStep("any storyboard samples playing", () => allStoryboardSamples.Any(sound => sound.IsPlaying));
-
-            if (skipIntro)
-                AddStep("skip intro", () => InputManager.Key(Key.Space));
+            waitUntilStoryboardSamplesPlay();
         }
 
+        private void waitUntilStoryboardSamplesPlay() => AddUntilStep("any storyboard samples playing", () => allStoryboardSamples.Any(sound => sound.IsPlaying));
+
+        private void allStoryobardSamplesStopped() => AddAssert("all storyboard samples stopped immediately", () => allStoryboardSamples.All(sound => !sound.IsPlaying));
+
+        private void skipIntro() => AddStep("skip intro", () => InputManager.Key(Key.Space));
+
         private IEnumerable<DrawableStoryboardSample> allStoryboardSamples => Player.ChildrenOfType<DrawableStoryboardSample>();
 
         protected override bool AllowFail => false;

From 2ce4faa3564f13d334e5ed282560488257f19c22 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 3 Mar 2022 00:02:36 +0300
Subject: [PATCH 3172/5547] Fix typo in method name

---
 .../Visual/Gameplay/TestSceneStoryboardSamplePlayback.cs    | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboardSamplePlayback.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboardSamplePlayback.cs
index 6b74868944..909cab5e3d 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboardSamplePlayback.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboardSamplePlayback.cs
@@ -51,7 +51,7 @@ namespace osu.Game.Tests.Visual.Gameplay
 
             AddStep("player paused", () => Player.Pause());
             AddAssert("player is currently paused", () => Player.GameplayClockContainer.IsPaused.Value);
-            allStoryobardSamplesStopped();
+            allStoryboardSamplesStopped();
 
             AddStep("player resume", () => Player.Resume());
             waitUntilStoryboardSamplesPlay();
@@ -63,7 +63,7 @@ namespace osu.Game.Tests.Visual.Gameplay
             createPlayerTest();
 
             skipIntro();
-            allStoryobardSamplesStopped();
+            allStoryboardSamplesStopped();
 
             waitUntilStoryboardSamplesPlay();
         }
@@ -127,7 +127,7 @@ namespace osu.Game.Tests.Visual.Gameplay
 
         private void waitUntilStoryboardSamplesPlay() => AddUntilStep("any storyboard samples playing", () => allStoryboardSamples.Any(sound => sound.IsPlaying));
 
-        private void allStoryobardSamplesStopped() => AddAssert("all storyboard samples stopped immediately", () => allStoryboardSamples.All(sound => !sound.IsPlaying));
+        private void allStoryboardSamplesStopped() => AddAssert("all storyboard samples stopped immediately", () => allStoryboardSamples.All(sound => !sound.IsPlaying));
 
         private void skipIntro() => AddStep("skip intro", () => InputManager.Key(Key.Space));
 

From 3630ab2db2da2ee6b0291bf0e3cedfd47a8f020f Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 3 Mar 2022 00:09:12 +0300
Subject: [PATCH 3173/5547] Remove unnecessary nullability of storyboard mods
 list

---
 osu.Game/Storyboards/Drawables/DrawableStoryboard.cs | 3 +--
 osu.Game/Storyboards/Storyboard.cs                   | 2 +-
 2 files changed, 2 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Storyboards/Drawables/DrawableStoryboard.cs b/osu.Game/Storyboards/Drawables/DrawableStoryboard.cs
index 840500347f..01e4dfca02 100644
--- a/osu.Game/Storyboards/Drawables/DrawableStoryboard.cs
+++ b/osu.Game/Storyboards/Drawables/DrawableStoryboard.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.Linq;
 using System.Threading;
@@ -64,7 +63,7 @@ namespace osu.Game.Storyboards.Drawables
         public DrawableStoryboard(Storyboard storyboard, IReadOnlyList<Mod> mods)
         {
             Storyboard = storyboard;
-            Mods = mods ?? Array.Empty<Mod>();
+            Mods = mods;
 
             Size = new Vector2(640, 480);
 
diff --git a/osu.Game/Storyboards/Storyboard.cs b/osu.Game/Storyboards/Storyboard.cs
index 2faed98ae0..844950336d 100644
--- a/osu.Game/Storyboards/Storyboard.cs
+++ b/osu.Game/Storyboards/Storyboard.cs
@@ -91,7 +91,7 @@ namespace osu.Game.Storyboards
             }
         }
 
-        public DrawableStoryboard CreateDrawable(IReadOnlyList<Mod> mods = null) =>
+        public DrawableStoryboard CreateDrawable(IReadOnlyList<Mod> mods) =>
             new DrawableStoryboard(this, mods);
 
         public Drawable CreateSpriteFromResourcePath(string path, TextureStore textureStore)

From 55737226a31ba2f190abeb88953a99e6d704be54 Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Thu, 3 Mar 2022 10:18:36 +0800
Subject: [PATCH 3174/5547] Use `Enumerable.Repeat`

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

diff --git a/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs b/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs
index 7c92bd8141..f155005f67 100644
--- a/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs
+++ b/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs
@@ -69,7 +69,7 @@ namespace osu.Game.Rulesets.Mods
         private ITrack track;
         private HUDOverlay overlay;
 
-        private readonly List<double> recentRates = Enumerable.Range(0, average_count).Select(_ => 1d).ToList();
+        private readonly List<double> recentRates = Enumerable.Repeat(1d, average_count).ToList();
 
         // rate for a hit is calculated using the end time of another hit object earlier in time
         // caching them here for easy access
@@ -98,7 +98,7 @@ namespace osu.Game.Rulesets.Mods
             InitialRate.TriggerChange();
             AdjustPitch.TriggerChange();
             recentRates.Clear();
-            recentRates.AddRange(Enumerable.Range(0, average_count).Select(_ => InitialRate.Value));
+            recentRates.AddRange(Enumerable.Repeat(InitialRate.Value, average_count));
         }
 
         public void ApplyToSample(DrawableSample sample)

From ff7f65de2712200496499ac647fc7fa8a9193cda Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Thu, 3 Mar 2022 10:43:04 +0800
Subject: [PATCH 3175/5547] Extract duplicated conditionals

---
 osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs | 20 ++++++++++++--------
 1 file changed, 12 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs b/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs
index f155005f67..69d5a956d9 100644
--- a/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs
+++ b/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs
@@ -12,6 +12,7 @@ using osu.Framework.Graphics.Audio;
 using osu.Framework.Utils;
 using osu.Game.Beatmaps;
 using osu.Game.Configuration;
+using osu.Game.Rulesets.Judgements;
 using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Objects.Drawables;
 using osu.Game.Rulesets.Scoring;
@@ -124,10 +125,7 @@ namespace osu.Game.Rulesets.Mods
             drawable.OnNewResult += (o, result) =>
             {
                 if (dequeuedRates.ContainsKey(result.HitObject)) return;
-
-                if (!result.IsHit) return;
-                if (!result.Type.AffectsAccuracy()) return;
-                if (!previousEndTimes.ContainsKey(result.HitObject)) return;
+                if (!shouldProcessResult(result)) return;
 
                 double prevEndTime = previousEndTimes[result.HitObject];
 
@@ -141,10 +139,7 @@ namespace osu.Game.Rulesets.Mods
             drawable.OnRevertResult += (o, result) =>
             {
                 if (!dequeuedRates.ContainsKey(result.HitObject)) return;
-
-                if (!result.IsHit) return;
-                if (!result.Type.AffectsAccuracy()) return;
-                if (!previousEndTimes.ContainsKey(result.HitObject)) return;
+                if (!shouldProcessResult(result)) return;
 
                 recentRates.Insert(0, dequeuedRates[result.HitObject]);
                 recentRates.RemoveAt(recentRates.Count - 1);
@@ -179,5 +174,14 @@ namespace osu.Game.Rulesets.Mods
                     yield return nested;
             }
         }
+
+        private bool shouldProcessResult(JudgementResult result)
+        {
+            if (!result.IsHit) return false;
+            if (!result.Type.AffectsAccuracy()) return false;
+            if (!previousEndTimes.ContainsKey(result.HitObject)) return false;
+
+            return true;
+        }
     }
 }

From 95a40c5dc561fbc55d7d4fe60ce6a34c57326149 Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Thu, 3 Mar 2022 10:43:30 +0800
Subject: [PATCH 3176/5547] Remove pointless comment

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

diff --git a/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs b/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs
index 69d5a956d9..946d25172c 100644
--- a/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs
+++ b/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs
@@ -111,7 +111,6 @@ namespace osu.Game.Rulesets.Mods
 
         private void applyPitchAdjustment(ValueChangedEvent<bool> adjustPitchSetting)
         {
-            // remove existing old adjustment
             track?.RemoveAdjustment(adjustmentForPitchSetting(adjustPitchSetting.OldValue), SpeedChange);
 
             track?.AddAdjustment(adjustmentForPitchSetting(adjustPitchSetting.NewValue), SpeedChange);

From 51258dbab4fca3c77cdeb767bf616fab633b16e2 Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Thu, 3 Mar 2022 11:21:20 +0800
Subject: [PATCH 3177/5547] Use binary search in `ApplyToBeatmap`

---
 osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs b/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs
index 946d25172c..276f3466f4 100644
--- a/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs
+++ b/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs
@@ -9,7 +9,6 @@ using osu.Framework.Audio.Track;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Audio;
-using osu.Framework.Utils;
 using osu.Game.Beatmaps;
 using osu.Game.Configuration;
 using osu.Game.Rulesets.Judgements;
@@ -151,14 +150,16 @@ namespace osu.Game.Rulesets.Mods
         public void ApplyToBeatmap(IBeatmap beatmap)
         {
             var hitObjects = getAllApplicableHitObjects(beatmap.HitObjects).ToList();
-            var endTimes = hitObjects.Select(x => x.GetEndTime()).OrderBy(x => x).ToList();
+            var endTimes = hitObjects.Select(x => x.GetEndTime()).OrderBy(x => x).Distinct().ToList();
 
             foreach (HitObject hitObject in hitObjects)
             {
-                double prevEndTime = endTimes.LastOrDefault(ht => !Precision.AlmostBigger(ht, hitObject.GetEndTime()));
+                int index = endTimes.BinarySearch(hitObject.GetEndTime());
+                if (index < 0) index = ~index; // BinarySearch returns the next larger element in bitwise complement if there's no exact match
+                index -= 1;
 
-                if (prevEndTime != default)
-                    previousEndTimes.Add(hitObject, prevEndTime);
+                if (index >= 0)
+                    previousEndTimes.Add(hitObject, endTimes[index]);
             }
         }
 

From 09254407fe894b0da3dae1a4ac9cacfa0bac8be2 Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Thu, 3 Mar 2022 12:02:39 +0800
Subject: [PATCH 3178/5547] Interpolate speed change using
 `IUpdatableByPlayfield`

---
 osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs | 33 +++++++++++-----------
 1 file changed, 17 insertions(+), 16 deletions(-)

diff --git a/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs b/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs
index 276f3466f4..0ad31ebb9c 100644
--- a/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs
+++ b/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs
@@ -1,25 +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;
 using System.Collections.Generic;
 using System.Linq;
 using osu.Framework.Audio;
 using osu.Framework.Audio.Track;
 using osu.Framework.Bindables;
-using osu.Framework.Graphics;
 using osu.Framework.Graphics.Audio;
+using osu.Framework.Utils;
 using osu.Game.Beatmaps;
 using osu.Game.Configuration;
 using osu.Game.Rulesets.Judgements;
 using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Objects.Drawables;
 using osu.Game.Rulesets.Scoring;
-using osu.Game.Screens.Play;
+using osu.Game.Rulesets.UI;
 
 namespace osu.Game.Rulesets.Mods
 {
-    public class ModAdaptiveSpeed : Mod, IApplicableToRate, IApplicableToDrawableHitObject, IApplicableToBeatmap, IApplicableToHUD
+    public class ModAdaptiveSpeed : Mod, IApplicableToRate, IApplicableToDrawableHitObject, IApplicableToBeatmap, IUpdatableByPlayfield
     {
         // use a wider range so there's still room for adjustment when the initial rate is extreme
         private const double fastest_rate = 2.5f;
@@ -62,12 +61,11 @@ namespace osu.Game.Rulesets.Mods
         public BindableNumber<double> SpeedChange { get; } = new BindableDouble
         {
             Default = 1,
-            Value = 1,
-            Precision = 0.01
+            Value = 1
         };
 
         private ITrack track;
-        private HUDOverlay overlay;
+        private double targetRate = 1d;
 
         private readonly List<double> recentRates = Enumerable.Repeat(1d, average_count).ToList();
 
@@ -81,16 +79,14 @@ namespace osu.Game.Rulesets.Mods
 
         public ModAdaptiveSpeed()
         {
-            InitialRate.BindValueChanged(val => SpeedChange.Value = val.NewValue);
+            InitialRate.BindValueChanged(val =>
+            {
+                SpeedChange.Value = val.NewValue;
+                targetRate = val.NewValue;
+            });
             AdjustPitch.BindValueChanged(applyPitchAdjustment);
         }
 
-        public void ApplyToHUD(HUDOverlay overlay)
-        {
-            // this is only used to transform the SpeedChange bindable
-            this.overlay = overlay;
-        }
-
         public void ApplyToTrack(ITrack track)
         {
             this.track = track;
@@ -106,6 +102,11 @@ namespace osu.Game.Rulesets.Mods
             sample.AddAdjustment(AdjustableProperty.Frequency, SpeedChange);
         }
 
+        public void Update(Playfield playfield)
+        {
+            SpeedChange.Value = Interpolation.DampContinuously(SpeedChange.Value, targetRate, 50, playfield.Clock.ElapsedFrameTime);
+        }
+
         public double ApplyToRate(double time, double rate = 1) => rate * InitialRate.Value;
 
         private void applyPitchAdjustment(ValueChangedEvent<bool> adjustPitchSetting)
@@ -132,7 +133,7 @@ namespace osu.Game.Rulesets.Mods
                 dequeuedRates.Add(result.HitObject, recentRates[0]);
                 recentRates.RemoveAt(0);
 
-                overlay.TransformBindableTo(SpeedChange, recentRates.Average(), 100);
+                targetRate = recentRates.Average();
             };
             drawable.OnRevertResult += (o, result) =>
             {
@@ -143,7 +144,7 @@ namespace osu.Game.Rulesets.Mods
                 recentRates.RemoveAt(recentRates.Count - 1);
                 dequeuedRates.Remove(result.HitObject);
 
-                overlay.TransformBindableTo(SpeedChange, recentRates.Average(), 100);
+                targetRate = recentRates.Average();
             };
         }
 

From ae71dcceeb0d7478210eaf631f62732352e4debd Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Thu, 3 Mar 2022 13:03:53 +0800
Subject: [PATCH 3179/5547] Convert comments to xmldoc

---
 osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs | 11 +++++++----
 1 file changed, 7 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs b/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs
index 0ad31ebb9c..5a2edfa17d 100644
--- a/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs
+++ b/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs
@@ -69,12 +69,15 @@ namespace osu.Game.Rulesets.Mods
 
         private readonly List<double> recentRates = Enumerable.Repeat(1d, average_count).ToList();
 
-        // rate for a hit is calculated using the end time of another hit object earlier in time
-        // caching them here for easy access
+        /// <summary>
+        /// Rate for a hit is calculated using the end time of another hit object earlier in time,
+        /// caching them here for easy access
+        /// </summary>
         private readonly Dictionary<HitObject, double> previousEndTimes = new Dictionary<HitObject, double>();
 
-        // record the value removed from recentRates when an object is hit
-        // for rewind support
+        /// <summary>
+        /// Record the value removed from <see cref="recentRates"/> when an object is hit for rewind support
+        /// </summary>
         private readonly Dictionary<HitObject, double> dequeuedRates = new Dictionary<HitObject, double>();
 
         public ModAdaptiveSpeed()

From 9c2aa511943c3b89279beb00aa954e1204539d98 Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Thu, 3 Mar 2022 13:07:30 +0800
Subject: [PATCH 3180/5547] Rename `applyPitchAdjustment` to
 `adjustPitchChanged`

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

diff --git a/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs b/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs
index 5a2edfa17d..2e77b7c6fc 100644
--- a/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs
+++ b/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs
@@ -87,7 +87,7 @@ namespace osu.Game.Rulesets.Mods
                 SpeedChange.Value = val.NewValue;
                 targetRate = val.NewValue;
             });
-            AdjustPitch.BindValueChanged(applyPitchAdjustment);
+            AdjustPitch.BindValueChanged(adjustPitchChanged);
         }
 
         public void ApplyToTrack(ITrack track)
@@ -112,7 +112,7 @@ namespace osu.Game.Rulesets.Mods
 
         public double ApplyToRate(double time, double rate = 1) => rate * InitialRate.Value;
 
-        private void applyPitchAdjustment(ValueChangedEvent<bool> adjustPitchSetting)
+        private void adjustPitchChanged(ValueChangedEvent<bool> adjustPitchSetting)
         {
             track?.RemoveAdjustment(adjustmentForPitchSetting(adjustPitchSetting.OldValue), SpeedChange);
 

From fab9323707655e3ce08145290bfeb84f886e0f8d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 3 Mar 2022 14:08:48 +0900
Subject: [PATCH 3181/5547] Replace all legacy ruleset checks with a helper
 property call

---
 osu.Desktop/DiscordRichPresence.cs                         | 5 +----
 osu.Game/Beatmaps/DifficultyRecommender.cs                 | 2 +-
 osu.Game/Rulesets/IRulesetInfo.cs                          | 5 +++++
 osu.Game/Rulesets/RulesetInfo.cs                           | 5 +++++
 osu.Game/Screens/Play/SoloPlayer.cs                        | 3 +--
 osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs | 2 +-
 6 files changed, 14 insertions(+), 8 deletions(-)

diff --git a/osu.Desktop/DiscordRichPresence.cs b/osu.Desktop/DiscordRichPresence.cs
index 3642f70a56..fe687e8dab 100644
--- a/osu.Desktop/DiscordRichPresence.cs
+++ b/osu.Desktop/DiscordRichPresence.cs
@@ -108,10 +108,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
-            int onlineID = ruleset.Value.OnlineID;
-            bool isLegacyRuleset = onlineID >= 0 && onlineID <= ILegacyRuleset.MAX_LEGACY_RULESET_ID;
-
-            presence.Assets.SmallImageKey = isLegacyRuleset ? $"mode_{onlineID}" : "mode_custom";
+            presence.Assets.SmallImageKey = ruleset.Value.IsLegacyRuleset ? $"mode_{ruleset.Value.OnlineID}" : "mode_custom";
             presence.Assets.SmallImageText = ruleset.Value.Name;
 
             client.SetPresence(presence);
diff --git a/osu.Game/Beatmaps/DifficultyRecommender.cs b/osu.Game/Beatmaps/DifficultyRecommender.cs
index 3949e84f4a..8c3e832293 100644
--- a/osu.Game/Beatmaps/DifficultyRecommender.cs
+++ b/osu.Game/Beatmaps/DifficultyRecommender.cs
@@ -83,7 +83,7 @@ namespace osu.Game.Beatmaps
             requestedUserId = api.LocalUser.Value.Id;
 
             // only query API for built-in rulesets
-            rulesets.AvailableRulesets.Where(ruleset => ruleset.OnlineID >= 0 && ruleset.OnlineID <= ILegacyRuleset.MAX_LEGACY_RULESET_ID).ForEach(rulesetInfo =>
+            rulesets.AvailableRulesets.Where(ruleset => ruleset.IsLegacyRuleset).ForEach(rulesetInfo =>
             {
                 var req = new GetUserRequest(api.LocalUser.Value.Id, rulesetInfo);
 
diff --git a/osu.Game/Rulesets/IRulesetInfo.cs b/osu.Game/Rulesets/IRulesetInfo.cs
index 60a02212fc..a8ed1683c2 100644
--- a/osu.Game/Rulesets/IRulesetInfo.cs
+++ b/osu.Game/Rulesets/IRulesetInfo.cs
@@ -29,5 +29,10 @@ namespace osu.Game.Rulesets
         string InstantiationInfo { get; }
 
         Ruleset CreateInstance();
+
+        /// <summary>
+        /// Whether this ruleset's online ID is within the range that defines it as a legacy ruleset (ie. either osu!, osu!taiko, osu!catch or osu!mania).
+        /// </summary>
+        public bool IsLegacyRuleset => OnlineID >= 0 && OnlineID <= ILegacyRuleset.MAX_LEGACY_RULESET_ID;
     }
 }
diff --git a/osu.Game/Rulesets/RulesetInfo.cs b/osu.Game/Rulesets/RulesetInfo.cs
index 88e3988431..cf7d84c2b4 100644
--- a/osu.Game/Rulesets/RulesetInfo.cs
+++ b/osu.Game/Rulesets/RulesetInfo.cs
@@ -91,6 +91,11 @@ namespace osu.Game.Rulesets
             Available = Available
         };
 
+        /// <summary>
+        /// Whether this ruleset's online ID is within the range that defines it as a legacy ruleset (ie. either osu!, osu!taiko, osu!catch or osu!mania).
+        /// </summary>
+        public bool IsLegacyRuleset => ((IRulesetInfo)this).IsLegacyRuleset;
+
         public Ruleset CreateInstance()
         {
             if (!Available)
diff --git a/osu.Game/Screens/Play/SoloPlayer.cs b/osu.Game/Screens/Play/SoloPlayer.cs
index 824c0072e3..b877ee1c11 100644
--- a/osu.Game/Screens/Play/SoloPlayer.cs
+++ b/osu.Game/Screens/Play/SoloPlayer.cs
@@ -7,7 +7,6 @@ using osu.Game.Beatmaps;
 using osu.Game.Online.API;
 using osu.Game.Online.Rooms;
 using osu.Game.Online.Solo;
-using osu.Game.Rulesets;
 using osu.Game.Scoring;
 
 namespace osu.Game.Screens.Play
@@ -32,7 +31,7 @@ namespace osu.Game.Screens.Play
             if (beatmapId <= 0)
                 return null;
 
-            if (rulesetId < 0 || rulesetId > ILegacyRuleset.MAX_LEGACY_RULESET_ID)
+            if (!Ruleset.Value.IsLegacyRuleset)
                 return null;
 
             return new CreateSoloScoreRequest(beatmapId, rulesetId, Game.VersionHash);
diff --git a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
index 6daaae9d04..95910ed0aa 100644
--- a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
+++ b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
@@ -118,7 +118,7 @@ namespace osu.Game.Screens.Select.Leaderboards
                 return null;
             }
 
-            if (fetchRuleset.OnlineID <= 0 || fetchRuleset.OnlineID > ILegacyRuleset.MAX_LEGACY_RULESET_ID)
+            if (!fetchRuleset.IsLegacyRuleset)
             {
                 SetErrorState(LeaderboardState.RulesetUnavailable);
                 return null;

From 4ce2044e4c842f50f0beb7ea62a8b2b493439a37 Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Thu, 3 Mar 2022 13:09:29 +0800
Subject: [PATCH 3182/5547] Reorder members

---
 osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs | 21 +++++++++++----------
 1 file changed, 11 insertions(+), 10 deletions(-)

diff --git a/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs b/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs
index 2e77b7c6fc..b3a318e307 100644
--- a/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs
+++ b/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs
@@ -1,5 +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.Linq;
@@ -112,16 +113,6 @@ namespace osu.Game.Rulesets.Mods
 
         public double ApplyToRate(double time, double rate = 1) => rate * InitialRate.Value;
 
-        private void adjustPitchChanged(ValueChangedEvent<bool> adjustPitchSetting)
-        {
-            track?.RemoveAdjustment(adjustmentForPitchSetting(adjustPitchSetting.OldValue), SpeedChange);
-
-            track?.AddAdjustment(adjustmentForPitchSetting(adjustPitchSetting.NewValue), SpeedChange);
-        }
-
-        private AdjustableProperty adjustmentForPitchSetting(bool adjustPitchSettingValue)
-            => adjustPitchSettingValue ? AdjustableProperty.Frequency : AdjustableProperty.Tempo;
-
         public void ApplyToDrawableHitObject(DrawableHitObject drawable)
         {
             drawable.OnNewResult += (o, result) =>
@@ -167,6 +158,16 @@ namespace osu.Game.Rulesets.Mods
             }
         }
 
+        private void adjustPitchChanged(ValueChangedEvent<bool> adjustPitchSetting)
+        {
+            track?.RemoveAdjustment(adjustmentForPitchSetting(adjustPitchSetting.OldValue), SpeedChange);
+
+            track?.AddAdjustment(adjustmentForPitchSetting(adjustPitchSetting.NewValue), SpeedChange);
+        }
+
+        private AdjustableProperty adjustmentForPitchSetting(bool adjustPitchSettingValue)
+            => adjustPitchSettingValue ? AdjustableProperty.Frequency : AdjustableProperty.Tempo;
+
         private IEnumerable<HitObject> getAllApplicableHitObjects(IEnumerable<HitObject> hitObjects)
         {
             foreach (var hitObject in hitObjects)

From 42e07b7308c05bd0792ceee0ae691a54f74f8e0d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 3 Mar 2022 14:15:25 +0900
Subject: [PATCH 3183/5547] Convert to extension method to avoid recursive
 calls

---
 osu.Desktop/DiscordRichPresence.cs                         | 3 ++-
 osu.Game/Beatmaps/DifficultyRecommender.cs                 | 3 ++-
 osu.Game/Extensions/ModelExtensions.cs                     | 5 +++++
 osu.Game/Rulesets/IRulesetInfo.cs                          | 5 -----
 osu.Game/Rulesets/RulesetInfo.cs                           | 5 -----
 osu.Game/Screens/Play/SoloPlayer.cs                        | 3 ++-
 osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs | 3 ++-
 7 files changed, 13 insertions(+), 14 deletions(-)

diff --git a/osu.Desktop/DiscordRichPresence.cs b/osu.Desktop/DiscordRichPresence.cs
index fe687e8dab..d87b25a4c7 100644
--- a/osu.Desktop/DiscordRichPresence.cs
+++ b/osu.Desktop/DiscordRichPresence.cs
@@ -10,6 +10,7 @@ using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Logging;
 using osu.Game.Configuration;
+using osu.Game.Extensions;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets;
@@ -108,7 +109,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
-            presence.Assets.SmallImageKey = ruleset.Value.IsLegacyRuleset ? $"mode_{ruleset.Value.OnlineID}" : "mode_custom";
+            presence.Assets.SmallImageKey = ruleset.Value.IsLegacyRuleset() ? $"mode_{ruleset.Value.OnlineID}" : "mode_custom";
             presence.Assets.SmallImageText = ruleset.Value.Name;
 
             client.SetPresence(presence);
diff --git a/osu.Game/Beatmaps/DifficultyRecommender.cs b/osu.Game/Beatmaps/DifficultyRecommender.cs
index 8c3e832293..93c2fccbc7 100644
--- a/osu.Game/Beatmaps/DifficultyRecommender.cs
+++ b/osu.Game/Beatmaps/DifficultyRecommender.cs
@@ -9,6 +9,7 @@ using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Extensions.IEnumerableExtensions;
 using osu.Framework.Graphics;
+using osu.Game.Extensions;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests;
 using osu.Game.Rulesets;
@@ -83,7 +84,7 @@ namespace osu.Game.Beatmaps
             requestedUserId = api.LocalUser.Value.Id;
 
             // only query API for built-in rulesets
-            rulesets.AvailableRulesets.Where(ruleset => ruleset.IsLegacyRuleset).ForEach(rulesetInfo =>
+            rulesets.AvailableRulesets.Where(ruleset => ruleset.IsLegacyRuleset()).ForEach(rulesetInfo =>
             {
                 var req = new GetUserRequest(api.LocalUser.Value.Id, rulesetInfo);
 
diff --git a/osu.Game/Extensions/ModelExtensions.cs b/osu.Game/Extensions/ModelExtensions.cs
index f178a5c97b..13c25e45c8 100644
--- a/osu.Game/Extensions/ModelExtensions.cs
+++ b/osu.Game/Extensions/ModelExtensions.cs
@@ -72,6 +72,11 @@ namespace osu.Game.Extensions
             return result;
         }
 
+        /// <summary>
+        /// Check whether this <see cref="IRulesetInfo"/>'s online ID is within the range that defines it as a legacy ruleset (ie. either osu!, osu!taiko, osu!catch or osu!mania).
+        /// </summary>
+        public static bool IsLegacyRuleset(this IRulesetInfo ruleset) => ruleset.OnlineID >= 0 && ruleset.OnlineID <= ILegacyRuleset.MAX_LEGACY_RULESET_ID;
+
         /// <summary>
         /// Check whether the online ID of two <see cref="IBeatmapSetInfo"/>s match.
         /// </summary>
diff --git a/osu.Game/Rulesets/IRulesetInfo.cs b/osu.Game/Rulesets/IRulesetInfo.cs
index a8ed1683c2..60a02212fc 100644
--- a/osu.Game/Rulesets/IRulesetInfo.cs
+++ b/osu.Game/Rulesets/IRulesetInfo.cs
@@ -29,10 +29,5 @@ namespace osu.Game.Rulesets
         string InstantiationInfo { get; }
 
         Ruleset CreateInstance();
-
-        /// <summary>
-        /// Whether this ruleset's online ID is within the range that defines it as a legacy ruleset (ie. either osu!, osu!taiko, osu!catch or osu!mania).
-        /// </summary>
-        public bool IsLegacyRuleset => OnlineID >= 0 && OnlineID <= ILegacyRuleset.MAX_LEGACY_RULESET_ID;
     }
 }
diff --git a/osu.Game/Rulesets/RulesetInfo.cs b/osu.Game/Rulesets/RulesetInfo.cs
index cf7d84c2b4..88e3988431 100644
--- a/osu.Game/Rulesets/RulesetInfo.cs
+++ b/osu.Game/Rulesets/RulesetInfo.cs
@@ -91,11 +91,6 @@ namespace osu.Game.Rulesets
             Available = Available
         };
 
-        /// <summary>
-        /// Whether this ruleset's online ID is within the range that defines it as a legacy ruleset (ie. either osu!, osu!taiko, osu!catch or osu!mania).
-        /// </summary>
-        public bool IsLegacyRuleset => ((IRulesetInfo)this).IsLegacyRuleset;
-
         public Ruleset CreateInstance()
         {
             if (!Available)
diff --git a/osu.Game/Screens/Play/SoloPlayer.cs b/osu.Game/Screens/Play/SoloPlayer.cs
index b877ee1c11..a935ce49eb 100644
--- a/osu.Game/Screens/Play/SoloPlayer.cs
+++ b/osu.Game/Screens/Play/SoloPlayer.cs
@@ -4,6 +4,7 @@
 using System;
 using System.Diagnostics;
 using osu.Game.Beatmaps;
+using osu.Game.Extensions;
 using osu.Game.Online.API;
 using osu.Game.Online.Rooms;
 using osu.Game.Online.Solo;
@@ -31,7 +32,7 @@ namespace osu.Game.Screens.Play
             if (beatmapId <= 0)
                 return null;
 
-            if (!Ruleset.Value.IsLegacyRuleset)
+            if (!Ruleset.Value.IsLegacyRuleset())
                 return null;
 
             return new CreateSoloScoreRequest(beatmapId, rulesetId, Game.VersionHash);
diff --git a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
index 95910ed0aa..eb0addd377 100644
--- a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
+++ b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
@@ -11,6 +11,7 @@ using osu.Framework.Bindables;
 using osu.Framework.Extensions;
 using osu.Game.Beatmaps;
 using osu.Game.Database;
+using osu.Game.Extensions;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests;
 using osu.Game.Online.Leaderboards;
@@ -118,7 +119,7 @@ namespace osu.Game.Screens.Select.Leaderboards
                 return null;
             }
 
-            if (!fetchRuleset.IsLegacyRuleset)
+            if (!fetchRuleset.IsLegacyRuleset())
             {
                 SetErrorState(LeaderboardState.RulesetUnavailable);
                 return null;

From 29bf7d0bde958ca2d7e30515ae4086a5bfddd2ec Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 3 Mar 2022 14:35:52 +0900
Subject: [PATCH 3184/5547] Fix shocking grammar and typos in block comment
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/Graphics/Containers/ScalingContainer.cs | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Graphics/Containers/ScalingContainer.cs b/osu.Game/Graphics/Containers/ScalingContainer.cs
index dd611b0904..248bb8ca1f 100644
--- a/osu.Game/Graphics/Containers/ScalingContainer.cs
+++ b/osu.Game/Graphics/Containers/ScalingContainer.cs
@@ -190,9 +190,9 @@ namespace osu.Game.Graphics.Containers
             sizableContainer.MoveTo(targetRect.Location, duration, Easing.OutQuart);
             sizableContainer.ResizeTo(targetRect.Size, duration, Easing.OutQuart);
 
-            // Of note, this will not working great in the case of nested ScalingContainers where multiple are applying corner radius.
-            // There should likely only be masking and corner radius applied at one point in the full game stack to fix this.
-            // An example of how this can occur is it the skin editor is visible and the game screen scaling is set to "Everything".
+            // Of note, this will not work great in the case of nested ScalingContainers where multiple are applying corner radius.
+            // Masking and corner radius should likely only be applied at one point in the full game stack to fix this.
+            // An example of how this can occur is when the skin editor is visible and the game screen scaling is set to "Everything".
             sizableContainer.TransformTo(nameof(CornerRadius), requiresMasking ? corner_radius : 0, duration, requiresMasking ? Easing.OutQuart : Easing.None)
                             .OnComplete(_ => { sizableContainer.Masking = requiresMasking; });
         }

From cb0d643f7047d0f594a4baf76f7751cb895166ab Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 3 Mar 2022 14:38:20 +0900
Subject: [PATCH 3185/5547] Add parameter xmldoc to explain what a null rect
 does

---
 osu.Game/Graphics/Containers/ScalingContainer.cs | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/osu.Game/Graphics/Containers/ScalingContainer.cs b/osu.Game/Graphics/Containers/ScalingContainer.cs
index 248bb8ca1f..d331b818a1 100644
--- a/osu.Game/Graphics/Containers/ScalingContainer.cs
+++ b/osu.Game/Graphics/Containers/ScalingContainer.cs
@@ -45,6 +45,8 @@ namespace osu.Game.Graphics.Containers
         /// <summary>
         /// Set a custom position and scale which overrides any user specification.
         /// </summary>
+        /// <param name="rect">A rectangle with positional and sizing information for this container to conform to. <c>null</c> will clear the custom rect and revert to user settings.</param>
+        /// <param name="relativePosition">Whether the position portion of the provided rect is in relative coordinate space or not.</param>
         public void SetCustomRect(RectangleF? rect, bool relativePosition = false)
         {
             customRect = rect;

From ab0ee265408ad406cdbd71de743c9ab1ef9e6d99 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 3 Mar 2022 15:13:42 +0900
Subject: [PATCH 3186/5547] Remove padding from distribution graph bars to fix
 some bars becoming invisible at low sizes

---
 .../Ranking/Statistics/HitEventTimingDistributionGraph.cs       | 2 --
 1 file changed, 2 deletions(-)

diff --git a/osu.Game/Screens/Ranking/Statistics/HitEventTimingDistributionGraph.cs b/osu.Game/Screens/Ranking/Statistics/HitEventTimingDistributionGraph.cs
index 93885b6e02..372c0d4849 100644
--- a/osu.Game/Screens/Ranking/Statistics/HitEventTimingDistributionGraph.cs
+++ b/osu.Game/Screens/Ranking/Statistics/HitEventTimingDistributionGraph.cs
@@ -160,8 +160,6 @@ namespace osu.Game.Screens.Ranking.Statistics
 
                 RelativeSizeAxes = Axes.Both;
 
-                Padding = new MarginPadding { Horizontal = 1 };
-
                 InternalChild = new Circle
                 {
                     RelativeSizeAxes = Axes.Both,

From 464be6e64c52b129e36c0e412b00d5f29a4205a1 Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Thu, 3 Mar 2022 14:37:39 +0800
Subject: [PATCH 3187/5547] Only call `IUpdatableByPlayfield.Update` if the
 playfield isn't nested

---
 osu.Game/Rulesets/Mods/IUpdatableByPlayfield.cs | 11 +++++++++++
 osu.Game/Rulesets/UI/Playfield.cs               |  9 ++++++++-
 2 files changed, 19 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Rulesets/Mods/IUpdatableByPlayfield.cs b/osu.Game/Rulesets/Mods/IUpdatableByPlayfield.cs
index 9baa252caf..7cf480a11b 100644
--- a/osu.Game/Rulesets/Mods/IUpdatableByPlayfield.cs
+++ b/osu.Game/Rulesets/Mods/IUpdatableByPlayfield.cs
@@ -5,8 +5,19 @@ using osu.Game.Rulesets.UI;
 
 namespace osu.Game.Rulesets.Mods
 {
+    /// <summary>
+    /// An interface for <see cref="Mod"/>s that are updated every frame by a <see cref="Playfield"/>.
+    /// </summary>
     public interface IUpdatableByPlayfield : IApplicableMod
     {
+        /// <summary>
+        /// Update this <see cref="Mod"/>.
+        /// </summary>
+        /// <param name="playfield">The main <see cref="Playfield"/></param>
+        /// <remarks>
+        /// This method is called once per frame during gameplay by the main <see cref="Playfield"/> only.
+        /// To access nested <see cref="Playfield"/>s, use <see cref="Playfield.NestedPlayfields"/>.
+        /// </remarks>
         void Update(Playfield playfield);
     }
 }
diff --git a/osu.Game/Rulesets/UI/Playfield.cs b/osu.Game/Rulesets/UI/Playfield.cs
index d0bbf859af..30e71dde1c 100644
--- a/osu.Game/Rulesets/UI/Playfield.cs
+++ b/osu.Game/Rulesets/UI/Playfield.cs
@@ -79,6 +79,11 @@ namespace osu.Game.Rulesets.UI
 
         private readonly List<Playfield> nestedPlayfields = new List<Playfield>();
 
+        /// <summary>
+        /// Whether this <see cref="Playfield"/> is nested in another <see cref="Playfield"/>.
+        /// </summary>
+        public bool IsNested { get; private set; }
+
         /// <summary>
         /// Whether judgements should be displayed by this and and all nested <see cref="Playfield"/>s.
         /// </summary>
@@ -206,6 +211,8 @@ namespace osu.Game.Rulesets.UI
         /// <param name="otherPlayfield">The <see cref="Playfield"/> to add.</param>
         protected void AddNested(Playfield otherPlayfield)
         {
+            otherPlayfield.IsNested = true;
+
             otherPlayfield.DisplayJudgements.BindTo(DisplayJudgements);
 
             otherPlayfield.NewResult += (d, r) => NewResult?.Invoke(d, r);
@@ -229,7 +236,7 @@ namespace osu.Game.Rulesets.UI
         {
             base.Update();
 
-            if (mods != null)
+            if (!IsNested && mods != null)
             {
                 foreach (var mod in mods)
                 {

From a06d806fb911ddb1531eda8f5415c0e9a86dc7ff Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 3 Mar 2022 15:43:01 +0900
Subject: [PATCH 3188/5547] Fix hit distribution graph midpoint rounding not
 looking great around zero

Not sure this will be accepted and it's likely only ever going to show
in tests, but seems to be a better approach to midpoint rounding for
this case?
---
 .../TestSceneHitEventTimingDistributionGraph.cs  |  6 ++++++
 .../HitEventTimingDistributionGraph.cs           | 16 ++++++++++++++--
 2 files changed, 20 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Visual/Ranking/TestSceneHitEventTimingDistributionGraph.cs b/osu.Game.Tests/Visual/Ranking/TestSceneHitEventTimingDistributionGraph.cs
index 221001e40b..f31aec8975 100644
--- a/osu.Game.Tests/Visual/Ranking/TestSceneHitEventTimingDistributionGraph.cs
+++ b/osu.Game.Tests/Visual/Ranking/TestSceneHitEventTimingDistributionGraph.cs
@@ -23,6 +23,12 @@ namespace osu.Game.Tests.Visual.Ranking
             createTest(CreateDistributedHitEvents());
         }
 
+        [Test]
+        public void TestManyDistributedEventsOffset()
+        {
+            createTest(CreateDistributedHitEvents(-3.5));
+        }
+
         [Test]
         public void TestAroundCentre()
         {
diff --git a/osu.Game/Screens/Ranking/Statistics/HitEventTimingDistributionGraph.cs b/osu.Game/Screens/Ranking/Statistics/HitEventTimingDistributionGraph.cs
index 93885b6e02..3a4641cba9 100644
--- a/osu.Game/Screens/Ranking/Statistics/HitEventTimingDistributionGraph.cs
+++ b/osu.Game/Screens/Ranking/Statistics/HitEventTimingDistributionGraph.cs
@@ -64,10 +64,22 @@ namespace osu.Game.Screens.Ranking.Statistics
             // Prevent div-by-0 by enforcing a minimum bin size
             binSize = Math.Max(1, binSize);
 
+            bool roundUp = true;
+
             foreach (var e in hitEvents)
             {
-                int binOffset = (int)Math.Round(e.TimeOffset / binSize, MidpointRounding.AwayFromZero);
-                bins[timing_distribution_centre_bin_index + binOffset]++;
+                double binOffset = e.TimeOffset / binSize;
+
+                // .NET's round midpoint handling doesn't provide a behaviour that works amazingly for display
+                // purposes here. We want midpoint rounding to roughly distribute evenly to each adjacent bucket
+                // so the easiest way is to cycle between downwards and upwards rounding as we process events.
+                if (Math.Abs(binOffset - (int)binOffset) == 0.5)
+                {
+                    binOffset += Math.Sign(binOffset) * (roundUp ? 1 : 0);
+                    roundUp = !roundUp;
+                }
+
+                bins[timing_distribution_centre_bin_index + (int)binOffset]++;
             }
 
             int maxCount = bins.Max();

From 9c43500ad358cc50ea399af79d47fa4f7f6ace5b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 3 Mar 2022 16:23:30 +0900
Subject: [PATCH 3189/5547] Add ability for player loading screen settings to
 scroll

As we add more items here this is going to become necessary. Until the design no doubt gets changed.
---
 osu.Game/Overlays/SettingsToolboxGroup.cs |  7 +++---
 osu.Game/Screens/Play/PlayerLoader.cs     | 29 +++++++++++++++--------
 2 files changed, 22 insertions(+), 14 deletions(-)

diff --git a/osu.Game/Overlays/SettingsToolboxGroup.cs b/osu.Game/Overlays/SettingsToolboxGroup.cs
index 08321f68fe..b4178359a4 100644
--- a/osu.Game/Overlays/SettingsToolboxGroup.cs
+++ b/osu.Game/Overlays/SettingsToolboxGroup.cs
@@ -22,8 +22,9 @@ namespace osu.Game.Overlays
 {
     public class SettingsToolboxGroup : Container, IExpandable
     {
+        public const int CONTAINER_WIDTH = 270;
+
         private const float transition_duration = 250;
-        private const int container_width = 270;
         private const int border_thickness = 2;
         private const int header_height = 30;
         private const int corner_radius = 5;
@@ -49,7 +50,7 @@ namespace osu.Game.Overlays
         public SettingsToolboxGroup(string title)
         {
             AutoSizeAxes = Axes.Y;
-            Width = container_width;
+            Width = CONTAINER_WIDTH;
             Masking = true;
             CornerRadius = corner_radius;
             BorderColour = Color4.Black;
@@ -201,7 +202,5 @@ namespace osu.Game.Overlays
         }
 
         protected override Container<Drawable> Content => content;
-
-        protected override bool OnMouseDown(MouseDownEvent e) => true;
     }
 }
diff --git a/osu.Game/Screens/Play/PlayerLoader.cs b/osu.Game/Screens/Play/PlayerLoader.cs
index f6d63a8ec5..41eb822e39 100644
--- a/osu.Game/Screens/Play/PlayerLoader.cs
+++ b/osu.Game/Screens/Play/PlayerLoader.cs
@@ -143,6 +143,8 @@ namespace osu.Game.Screens.Play
             muteWarningShownOnce = sessionStatics.GetBindable<bool>(Static.MutedAudioNotificationShownOnce);
             batteryWarningShownOnce = sessionStatics.GetBindable<bool>(Static.LowBatteryNotificationShownOnce);
 
+            const float padding = 25;
+
             InternalChildren = new Drawable[]
             {
                 (content = new LogoTrackingContainer
@@ -158,20 +160,27 @@ namespace osu.Game.Screens.Play
                         Anchor = Anchor.Centre,
                         Origin = Anchor.Centre,
                     },
-                    PlayerSettings = new FillFlowContainer<PlayerSettingsGroup>
+                    new OsuScrollContainer
                     {
                         Anchor = Anchor.TopRight,
                         Origin = Anchor.TopRight,
-                        AutoSizeAxes = Axes.Both,
-                        Direction = FillDirection.Vertical,
-                        Spacing = new Vector2(0, 20),
-                        Margin = new MarginPadding(25),
-                        Children = new PlayerSettingsGroup[]
+                        RelativeSizeAxes = Axes.Y,
+                        Width = SettingsToolboxGroup.CONTAINER_WIDTH + padding * 2,
+                        Padding = new MarginPadding { Vertical = padding },
+                        Masking = false,
+                        Child = PlayerSettings = new FillFlowContainer<PlayerSettingsGroup>
                         {
-                            VisualSettings = new VisualSettings(),
-                            AudioSettings = new AudioSettings(),
-                            new InputSettings()
-                        }
+                            AutoSizeAxes = Axes.Both,
+                            Direction = FillDirection.Vertical,
+                            Spacing = new Vector2(0, 20),
+                            Padding = new MarginPadding { Horizontal = padding },
+                            Children = new PlayerSettingsGroup[]
+                            {
+                                VisualSettings = new VisualSettings(),
+                                AudioSettings = new AudioSettings(),
+                                new InputSettings()
+                            }
+                        },
                     },
                     idleTracker = new IdleTracker(750),
                 }),

From f09a4e9c5b0e5507d9d3a22b92682a2190030832 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 3 Mar 2022 16:28:32 +0900
Subject: [PATCH 3190/5547] Fix potential crash in tests when attempting to
 lookup key bindings in cases the lookup is not available

---
 osu.Game/Configuration/DevelopmentOsuConfigManager.cs | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/osu.Game/Configuration/DevelopmentOsuConfigManager.cs b/osu.Game/Configuration/DevelopmentOsuConfigManager.cs
index ff19dd874c..f1cb0731fe 100644
--- a/osu.Game/Configuration/DevelopmentOsuConfigManager.cs
+++ b/osu.Game/Configuration/DevelopmentOsuConfigManager.cs
@@ -14,6 +14,8 @@ namespace osu.Game.Configuration
         public DevelopmentOsuConfigManager(Storage storage)
             : base(storage)
         {
+            LookupKeyBindings = _ => "unknown";
+            LookupSkinName = _ => "unknown";
         }
     }
 }

From 7ee30024e881387b8ab089d2b6153a901d7cafc8 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 3 Mar 2022 16:59:10 +0900
Subject: [PATCH 3191/5547] Restructure `OsuSliderBar` to allow for custom
 tooltips

---
 .../Graphics/UserInterface/OsuSliderBar.cs    | 34 ++++++++-----------
 1 file changed, 14 insertions(+), 20 deletions(-)

diff --git a/osu.Game/Graphics/UserInterface/OsuSliderBar.cs b/osu.Game/Graphics/UserInterface/OsuSliderBar.cs
index 333ae4f832..17dce10cf6 100644
--- a/osu.Game/Graphics/UserInterface/OsuSliderBar.cs
+++ b/osu.Game/Graphics/UserInterface/OsuSliderBar.cs
@@ -40,7 +40,7 @@ namespace osu.Game.Graphics.UserInterface
         private readonly Box rightBox;
         private readonly Container nubContainer;
 
-        public virtual LocalisableString TooltipText { get; private set; }
+        public virtual LocalisableString TooltipText { get; protected set; }
 
         /// <summary>
         /// Whether to format the tooltip as a percentage or the actual value.
@@ -148,7 +148,7 @@ namespace osu.Game.Graphics.UserInterface
         protected override void LoadComplete()
         {
             base.LoadComplete();
-            CurrentNumber.BindValueChanged(current => updateTooltipText(current.NewValue), true);
+            CurrentNumber.BindValueChanged(current => TooltipText = GetTooltipText(current.NewValue), true);
         }
 
         protected override bool OnHover(HoverEvent e)
@@ -178,7 +178,7 @@ namespace osu.Game.Graphics.UserInterface
         {
             base.OnUserChange(value);
             playSample(value);
-            updateTooltipText(value);
+            TooltipText = GetTooltipText(value);
         }
 
         private void playSample(T value)
@@ -203,28 +203,22 @@ namespace osu.Game.Graphics.UserInterface
             channel.Play();
         }
 
-        private void updateTooltipText(T value)
+        protected virtual LocalisableString GetTooltipText(T value)
         {
             if (CurrentNumber.IsInteger)
-                TooltipText = value.ToInt32(NumberFormatInfo.InvariantInfo).ToString("N0");
-            else
-            {
-                double floatValue = value.ToDouble(NumberFormatInfo.InvariantInfo);
+                return value.ToInt32(NumberFormatInfo.InvariantInfo).ToString("N0");
 
-                if (DisplayAsPercentage)
-                {
-                    TooltipText = floatValue.ToString("0%");
-                }
-                else
-                {
-                    decimal decimalPrecision = normalise(CurrentNumber.Precision.ToDecimal(NumberFormatInfo.InvariantInfo), max_decimal_digits);
+            double floatValue = value.ToDouble(NumberFormatInfo.InvariantInfo);
 
-                    // Find the number of significant digits (we could have less than 5 after normalize())
-                    int significantDigits = FormatUtils.FindPrecision(decimalPrecision);
+            if (DisplayAsPercentage)
+                return floatValue.ToString("0%");
 
-                    TooltipText = floatValue.ToString($"N{significantDigits}");
-                }
-            }
+            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);
+
+            return floatValue.ToString($"N{significantDigits}");
         }
 
         protected override void UpdateAfterChildren()

From 3848964faa4050465e8ff5db0156294e8d971336 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 3 Mar 2022 17:07:46 +0900
Subject: [PATCH 3192/5547] Add tooltip text for offset adjustment slider

---
 .../BeatmapOffsetControlStrings.cs            | 12 +++++++-
 .../PlayerSettings/BeatmapOffsetControl.cs    | 28 ++++++++++++++++++-
 .../Play/PlayerSettings/PlayerSliderBar.cs    | 12 ++++----
 3 files changed, 45 insertions(+), 7 deletions(-)

diff --git a/osu.Game/Localisation/BeatmapOffsetControlStrings.cs b/osu.Game/Localisation/BeatmapOffsetControlStrings.cs
index 7b2a9e50b2..632a1ad0ea 100644
--- a/osu.Game/Localisation/BeatmapOffsetControlStrings.cs
+++ b/osu.Game/Localisation/BeatmapOffsetControlStrings.cs
@@ -29,6 +29,16 @@ namespace osu.Game.Localisation
         /// </summary>
         public static LocalisableString CalibrateUsingLastPlay => new TranslatableString(getKey(@"calibrate_using_last_play"), @"Calibrate using last play");
 
+        /// <summary>
+        /// "(hit objects appear later)"
+        /// </summary>
+        public static LocalisableString HitObjectsAppearLater => new TranslatableString(getKey(@"hit_objects_appear_later"), @"(hit objects appear later)");
+
+        /// <summary>
+        /// "(hit objects appear earlier)"
+        /// </summary>
+        public static LocalisableString HitObjectsAppearEarlier => new TranslatableString(getKey(@"hit_objects_appear_earlier"), @"(hit objects appear earlier)");
+
         private static string getKey(string key) => $@"{prefix}:{key}";
     }
-}
\ No newline at end of file
+}
diff --git a/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs b/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
index dc3e80d695..201e431367 100644
--- a/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
+++ b/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
@@ -3,12 +3,14 @@
 
 using System;
 using System.ComponentModel;
+using System.Diagnostics;
 using System.Linq;
 using System.Threading.Tasks;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
+using osu.Framework.Localisation;
 using osu.Framework.Utils;
 using osu.Game.Beatmaps;
 using osu.Game.Database;
@@ -71,7 +73,7 @@ namespace osu.Game.Screens.Play.PlayerSettings
                 Spacing = new Vector2(10),
                 Children = new Drawable[]
                 {
-                    new PlayerSliderBar<double>
+                    new OffsetSliderBar
                     {
                         KeyboardStep = 5,
                         LabelText = BeatmapOffsetControlStrings.BeatmapOffset,
@@ -88,6 +90,30 @@ namespace osu.Game.Screens.Play.PlayerSettings
             };
         }
 
+        public class OffsetSliderBar : PlayerSliderBar<double>
+        {
+            protected override Drawable CreateControl() => new CustomSliderBar();
+
+            protected class CustomSliderBar : SliderBar
+            {
+                protected override LocalisableString GetTooltipText(double value)
+                {
+                    return value == 0
+                        ? new TranslatableString("_", @"{0} ms", base.GetTooltipText(value))
+                        : new TranslatableString("_", @"{0} ms {1}", base.GetTooltipText(value), getEarlyLateText(value));
+                }
+
+                private LocalisableString getEarlyLateText(double value)
+                {
+                    Debug.Assert(value != 0);
+
+                    return value > 0
+                        ? BeatmapOffsetControlStrings.HitObjectsAppearLater
+                        : BeatmapOffsetControlStrings.HitObjectsAppearEarlier;
+                }
+            }
+        }
+
         protected override void LoadComplete()
         {
             base.LoadComplete();
diff --git a/osu.Game/Screens/Play/PlayerSettings/PlayerSliderBar.cs b/osu.Game/Screens/Play/PlayerSettings/PlayerSliderBar.cs
index 57ffe16f76..3f1a5bc0ac 100644
--- a/osu.Game/Screens/Play/PlayerSettings/PlayerSliderBar.cs
+++ b/osu.Game/Screens/Play/PlayerSettings/PlayerSliderBar.cs
@@ -15,13 +15,15 @@ namespace osu.Game.Screens.Play.PlayerSettings
     {
         public OsuSliderBar<T> Bar => (OsuSliderBar<T>)Control;
 
-        protected override Drawable CreateControl() => new SliderBar
-        {
-            RelativeSizeAxes = Axes.X
-        };
+        protected override Drawable CreateControl() => new SliderBar();
 
-        private class SliderBar : OsuSliderBar<T>
+        protected class SliderBar : OsuSliderBar<T>
         {
+            public SliderBar()
+            {
+                RelativeSizeAxes = Axes.X;
+            }
+
             [BackgroundDependencyLoader]
             private void load(OsuColour colours)
             {

From 35f532fefa88662a0b536c9dbd4d1341586353be Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 3 Mar 2022 17:42:40 +0900
Subject: [PATCH 3193/5547] Add ability to watch properties via a `RealmAccess`
 helper method

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

diff --git a/osu.Game/Database/RealmAccess.cs b/osu.Game/Database/RealmAccess.cs
index fb3052d850..b093c1ed56 100644
--- a/osu.Game/Database/RealmAccess.cs
+++ b/osu.Game/Database/RealmAccess.cs
@@ -3,9 +3,11 @@
 
 using System;
 using System.Collections.Generic;
+using System.ComponentModel;
 using System.Diagnostics;
 using System.IO;
 using System.Linq;
+using System.Linq.Expressions;
 using System.Reflection;
 using System.Threading;
 using System.Threading.Tasks;
@@ -318,6 +320,66 @@ namespace osu.Game.Database
             }
         }
 
+        /// <summary>
+        /// Subscribe to the property of a realm object to watch for changes.
+        /// </summary>
+        /// <remarks>
+        /// On subscribing, unless the <paramref name="modelAccessor"/> does not match an object, an initial invocation of <paramref name="onChanged"/> will occur immediately.
+        /// Further invocations will occur when the value changes, but may also fire on a realm recycle with no actual value change.
+        /// </remarks>
+        /// <param name="modelAccessor">A function to retrieve the relevant model from realm.</param>
+        /// <param name="propertyLookup">A function to traverse to the relevant property from the model.</param>
+        /// <param name="onChanged">A function to be invoked when a change of value occurs.</param>
+        /// <typeparam name="TModel">The type of the model.</typeparam>
+        /// <typeparam name="TProperty">The type of the property to be watched.</typeparam>
+        /// <returns>
+        /// A subscription token. It must be kept alive for as long as you want to receive change notifications.
+        /// To stop receiving notifications, call <see cref="IDisposable.Dispose"/>.
+        /// </returns>
+        public IDisposable SubscribeToPropertyChanged<TModel, TProperty>(Func<Realm, TModel?> modelAccessor, Expression<Func<TModel, TProperty>> propertyLookup, Action<TProperty> onChanged)
+            where TModel : RealmObjectBase
+        {
+            return RegisterCustomSubscription(r =>
+            {
+                string propertyName = getMemberName(propertyLookup);
+
+                var model = Run(modelAccessor);
+                var propLookupCompiled = propertyLookup.Compile();
+
+                if (model == null)
+                    return null;
+
+                model.PropertyChanged += onPropertyChanged;
+
+                // Update initial value immediately.
+                onChanged(propLookupCompiled(model));
+
+                return new InvokeOnDisposal(() => model.PropertyChanged -= onPropertyChanged);
+
+                void onPropertyChanged(object sender, PropertyChangedEventArgs args)
+                {
+                    if (args.PropertyName == propertyName)
+                        onChanged(propLookupCompiled(model));
+                }
+            });
+
+            static string getMemberName(Expression<Func<TModel, TProperty>> expression)
+            {
+                if (!(expression is LambdaExpression lambda))
+                    throw new ArgumentException($"Outermost expression must be a lambda expression", nameof(expression));
+
+                if (!(lambda.Body is MemberExpression memberExpression))
+                    throw new ArgumentException($"Lambda body must be a member access expression", nameof(expression));
+
+                // TODO: nested access can be supported, with more iteration here
+                // (need to iteratively soft-cast `memberExpression.Expression` into `MemberExpression`s until `lambda.Parameters[0]` is hit)
+                if (memberExpression.Expression != lambda.Parameters[0])
+                    throw new ArgumentException($"Nested access expressions are not supported", nameof(expression));
+
+                return memberExpression.Member.Name;
+            }
+        }
+
         /// <summary>
         /// Run work on realm that will be run every time the update thread realm instance gets recycled.
         /// </summary>

From cecc746f9e3431ba2b1ae54e89072a262413bda9 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 3 Mar 2022 17:42:50 +0900
Subject: [PATCH 3194/5547] Update existing usages to use
 `SubscribeToPropertyChanged`

---
 .../Play/MasterGameplayClockContainer.cs      | 24 +++---------------
 .../PlayerSettings/BeatmapOffsetControl.cs    | 25 ++++++-------------
 2 files changed, 11 insertions(+), 38 deletions(-)

diff --git a/osu.Game/Screens/Play/MasterGameplayClockContainer.cs b/osu.Game/Screens/Play/MasterGameplayClockContainer.cs
index 2b6db5f59e..7febec5737 100644
--- a/osu.Game/Screens/Play/MasterGameplayClockContainer.cs
+++ b/osu.Game/Screens/Play/MasterGameplayClockContainer.cs
@@ -86,26 +86,10 @@ namespace osu.Game.Screens.Play
             userAudioOffset = config.GetBindable<double>(OsuSetting.AudioOffset);
             userAudioOffset.BindValueChanged(offset => userGlobalOffsetClock.Offset = offset.NewValue, true);
 
-            beatmapOffsetSubscription = realm.RegisterCustomSubscription(r =>
-            {
-                var userSettings = r.Find<BeatmapInfo>(beatmap.BeatmapInfo.ID)?.UserSettings;
-
-                if (userSettings == null) // only the case for tests.
-                    return null;
-
-                void onUserSettingsOnPropertyChanged(object sender, PropertyChangedEventArgs args)
-                {
-                    if (args.PropertyName == nameof(BeatmapUserSettings.Offset))
-                        updateOffset();
-                }
-
-                updateOffset();
-                userSettings.PropertyChanged += onUserSettingsOnPropertyChanged;
-
-                return new InvokeOnDisposal(() => userSettings.PropertyChanged -= onUserSettingsOnPropertyChanged);
-
-                void updateOffset() => userBeatmapOffsetClock.Offset = userSettings.Offset;
-            });
+            beatmapOffsetSubscription = realm.SubscribeToPropertyChanged(
+                r => r.Find<BeatmapInfo>(beatmap.BeatmapInfo.ID)?.UserSettings,
+                settings => settings.Offset,
+                val => userBeatmapOffsetClock.Offset = val);
 
             // sane default provided by ruleset.
             startOffset = gameplayStartTime;
diff --git a/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs b/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
index dc3e80d695..23d7c626da 100644
--- a/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
+++ b/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
@@ -2,13 +2,13 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
-using System.ComponentModel;
 using System.Linq;
 using System.Threading.Tasks;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
+using osu.Framework.Logging;
 using osu.Framework.Utils;
 using osu.Game.Beatmaps;
 using osu.Game.Database;
@@ -94,24 +94,13 @@ namespace osu.Game.Screens.Play.PlayerSettings
 
             ReferenceScore.BindValueChanged(scoreChanged, true);
 
-            beatmapOffsetSubscription = realm.RegisterCustomSubscription(r =>
-            {
-                var userSettings = r.Find<BeatmapInfo>(beatmap.Value.BeatmapInfo.ID)?.UserSettings;
-
-                if (userSettings == null) // only the case for tests.
-                    return null;
-
-                Current.Value = userSettings.Offset;
-                userSettings.PropertyChanged += onUserSettingsOnPropertyChanged;
-
-                return new InvokeOnDisposal(() => userSettings.PropertyChanged -= onUserSettingsOnPropertyChanged);
-
-                void onUserSettingsOnPropertyChanged(object sender, PropertyChangedEventArgs args)
+            beatmapOffsetSubscription = realm.SubscribeToPropertyChanged(
+                realm => realm.Find<BeatmapInfo>(beatmap.Value.BeatmapInfo.ID)?.UserSettings,
+                settings => settings.Offset,
+                val =>
                 {
-                    if (args.PropertyName == nameof(BeatmapUserSettings.Offset))
-                        Current.Value = userSettings.Offset;
-                }
-            });
+                    Current.Value = val;
+                });
 
             Current.BindValueChanged(currentChanged);
         }

From 1485a3a28a5ada0a04aedcb50ea9790331064b3e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 3 Mar 2022 17:56:49 +0900
Subject: [PATCH 3195/5547] Add test coverage of proeprty changed subscriptions

---
 .../RealmSubscriptionRegistrationTests.cs     | 58 +++++++++++++++++++
 1 file changed, 58 insertions(+)

diff --git a/osu.Game.Tests/Database/RealmSubscriptionRegistrationTests.cs b/osu.Game.Tests/Database/RealmSubscriptionRegistrationTests.cs
index 02d617d0e0..363a189f6e 100644
--- a/osu.Game.Tests/Database/RealmSubscriptionRegistrationTests.cs
+++ b/osu.Game.Tests/Database/RealmSubscriptionRegistrationTests.cs
@@ -47,6 +47,28 @@ namespace osu.Game.Tests.Database
             void onChanged(IRealmCollection<BeatmapSetInfo> sender, ChangeSet? changes, Exception error) => lastChanges = changes;
         }
 
+        [Test]
+        public void TestPropertyChangedSubscription()
+        {
+            RunTestWithRealm((realm, _) =>
+            {
+                bool? receivedValue = null;
+
+                realm.Write(r => r.Add(TestResources.CreateTestBeatmapSetInfo()));
+
+                using (realm.SubscribeToPropertyChanged(r => r.All<BeatmapSetInfo>().First(), setInfo => setInfo.Protected, val => receivedValue = val))
+                {
+                    Assert.That(receivedValue, Is.False);
+
+                    realm.Write(r => r.All<BeatmapSetInfo>().First().Protected = true);
+
+                    realm.Run(r => r.Refresh());
+
+                    Assert.That(receivedValue, Is.True);
+                }
+            });
+        }
+
         [Test]
         public void TestSubscriptionWithContextLoss()
         {
@@ -163,5 +185,41 @@ namespace osu.Game.Tests.Database
                 Assert.That(beatmapSetInfo, Is.Null);
             });
         }
+
+        [Test]
+        public void TestPropertyChangedSubscriptionWithContextLoss()
+        {
+            RunTestWithRealm((realm, _) =>
+            {
+                bool? receivedValue = null;
+
+                realm.Write(r => r.Add(TestResources.CreateTestBeatmapSetInfo()));
+
+                var subscription = realm.SubscribeToPropertyChanged(
+                    r => r.All<BeatmapSetInfo>().First(),
+                    setInfo => setInfo.Protected,
+                    val => receivedValue = val);
+
+                Assert.That(receivedValue, Is.Not.Null);
+                receivedValue = null;
+
+                using (realm.BlockAllOperations())
+                {
+                }
+
+                // re-registration after context restore.
+                realm.Run(r => r.Refresh());
+                Assert.That(receivedValue, Is.Not.Null);
+
+                subscription.Dispose();
+                receivedValue = null;
+
+                using (realm.BlockAllOperations())
+                    Assert.That(receivedValue, Is.Null);
+
+                realm.Run(r => r.Refresh());
+                Assert.That(receivedValue, Is.Null);
+            });
+        }
     }
 }

From 5cfa8b88211d819f70375e005d531843d1b1dac1 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 3 Mar 2022 21:31:56 +0900
Subject: [PATCH 3196/5547] Revert back to `private set`

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

diff --git a/osu.Game/Graphics/UserInterface/OsuSliderBar.cs b/osu.Game/Graphics/UserInterface/OsuSliderBar.cs
index 17dce10cf6..a5bc02246d 100644
--- a/osu.Game/Graphics/UserInterface/OsuSliderBar.cs
+++ b/osu.Game/Graphics/UserInterface/OsuSliderBar.cs
@@ -40,7 +40,7 @@ namespace osu.Game.Graphics.UserInterface
         private readonly Box rightBox;
         private readonly Container nubContainer;
 
-        public virtual LocalisableString TooltipText { get; protected set; }
+        public virtual LocalisableString TooltipText { get; private set; }
 
         /// <summary>
         /// Whether to format the tooltip as a percentage or the actual value.

From ffaf5b729f4da8af9b5061f2ea037c1e4ad5d640 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 3 Mar 2022 17:07:36 +0100
Subject: [PATCH 3197/5547] Move and reword docs of allowable rate range
 constants

---
 osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs | 14 +++++++++-----
 1 file changed, 9 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs b/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs
index b3a318e307..bde85c60ad 100644
--- a/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs
+++ b/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs
@@ -21,10 +21,6 @@ namespace osu.Game.Rulesets.Mods
 {
     public class ModAdaptiveSpeed : Mod, IApplicableToRate, IApplicableToDrawableHitObject, IApplicableToBeatmap, IUpdatableByPlayfield
     {
-        // use a wider range so there's still room for adjustment when the initial rate is extreme
-        private const double fastest_rate = 2.5f;
-        private const double slowest_rate = 0.4f;
-
         /// <summary>
         /// Adjust track rate using the average speed of the last x hits
         /// </summary>
@@ -61,10 +57,18 @@ namespace osu.Game.Rulesets.Mods
 
         public BindableNumber<double> SpeedChange { get; } = new BindableDouble
         {
+            MinValue = min_allowable_rate,
+            MaxValue = max_allowable_rate,
             Default = 1,
             Value = 1
         };
 
+        // The two constants below denote the maximum allowable range of rates that `SpeedChange` can take.
+        // The range is purposefully wider than the range of values that `InitialRate` allows
+        // in order to give some leeway for change even when extreme initial rates are chosen.
+        private const double min_allowable_rate = 0.4f;
+        private const double max_allowable_rate = 2.5f;
+
         private ITrack track;
         private double targetRate = 1d;
 
@@ -122,7 +126,7 @@ namespace osu.Game.Rulesets.Mods
 
                 double prevEndTime = previousEndTimes[result.HitObject];
 
-                recentRates.Add(Math.Clamp((result.HitObject.GetEndTime() - prevEndTime) / (result.TimeAbsolute - prevEndTime) * SpeedChange.Value, slowest_rate, fastest_rate));
+                recentRates.Add(Math.Clamp((result.HitObject.GetEndTime() - prevEndTime) / (result.TimeAbsolute - prevEndTime) * SpeedChange.Value, min_allowable_rate, max_allowable_rate));
 
                 dequeuedRates.Add(result.HitObject, recentRates[0]);
                 recentRates.RemoveAt(0);

From 3797871aa08aa836134a450fc03ab2431b3a47c6 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 3 Mar 2022 17:25:49 +0100
Subject: [PATCH 3198/5547] Add extended documentation of adaptive speed mod
 machinations

---
 osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs | 73 ++++++++++++++++------
 1 file changed, 53 insertions(+), 20 deletions(-)

diff --git a/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs b/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs
index bde85c60ad..78839ea692 100644
--- a/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs
+++ b/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs
@@ -21,11 +21,6 @@ namespace osu.Game.Rulesets.Mods
 {
     public class ModAdaptiveSpeed : Mod, IApplicableToRate, IApplicableToDrawableHitObject, IApplicableToBeatmap, IUpdatableByPlayfield
     {
-        /// <summary>
-        /// Adjust track rate using the average speed of the last x hits
-        /// </summary>
-        private const int average_count = 6;
-
         public override string Name => "Adaptive Speed";
 
         public override string Acronym => "AS";
@@ -55,6 +50,10 @@ namespace osu.Game.Rulesets.Mods
             Value = true
         };
 
+        /// <summary>
+        /// The instantaneous rate of the track.
+        /// Every frame this mod will attempt to smoothly adjust this to meet <see cref="targetRate"/>.
+        /// </summary>
         public BindableNumber<double> SpeedChange { get; } = new BindableDouble
         {
             MinValue = min_allowable_rate,
@@ -72,18 +71,52 @@ namespace osu.Game.Rulesets.Mods
         private ITrack track;
         private double targetRate = 1d;
 
-        private readonly List<double> recentRates = Enumerable.Repeat(1d, average_count).ToList();
+        /// <summary>
+        /// The number of most recent track rates (approximated from how early/late each object was hit relative to the previous object)
+        /// which should be averaged to calculate the instantaneous value of <see cref="SpeedChange"/>.
+        /// </summary>
+        private const int recent_rate_count = 6;
 
         /// <summary>
-        /// Rate for a hit is calculated using the end time of another hit object earlier in time,
-        /// caching them here for easy access
+        /// Stores the most recent <see cref="recent_rate_count"/> approximated track rates
+        /// which are averaged to calculate the instantaneous value of <see cref="SpeedChange"/>.
         /// </summary>
-        private readonly Dictionary<HitObject, double> previousEndTimes = new Dictionary<HitObject, double>();
+        /// <remarks>
+        /// This list is used as a double-ended queue with fixed capacity
+        /// (items can be enqueued/dequeued at either end of the list).
+        /// When time is elapsing forward, items are dequeued from the start and enqueued onto the end of the list.
+        /// When time is being rewound, items are dequeued from the end and enqueued onto the start of the list.
+        /// </remarks>
+        private readonly List<double> recentRates = Enumerable.Repeat(1d, recent_rate_count).ToList();
 
         /// <summary>
-        /// Record the value removed from <see cref="recentRates"/> when an object is hit for rewind support
+        /// For each given <see cref="HitObject"/> in the map, this dictionary maps the object onto the latest end time of any other object
+        /// that precedes the end time of the given object.
+        /// This can be loosely interpreted as the end time of the preceding hit object in rulesets that do not have overlapping hit objects.
         /// </summary>
-        private readonly Dictionary<HitObject, double> dequeuedRates = new Dictionary<HitObject, double>();
+        private readonly Dictionary<HitObject, double> precedingEndTimes = new Dictionary<HitObject, double>();
+
+        /// <summary>
+        /// For each given <see cref="HitObject"/> in the map, this dictionary maps the object onto the approximated track rate with which the user hit it.
+        /// </summary>
+        /// <example>
+        /// <para>
+        /// The approximation is calculated as follows:
+        /// </para>
+        /// <para>
+        /// Consider a hitobject which ends at 1000ms, and assume that its preceding hitobject ends at 500ms.
+        /// This gives a time difference of 1000 - 500 = 500ms.
+        /// </para>
+        /// <para>
+        /// Now assume that the user hit this object at 980ms rather than 1000ms.
+        /// When compared to the preceding hitobject, this gives 980 - 500 = 480ms.
+        /// </para>
+        /// <para>
+        /// With the above assumptions, the player is rushing / hitting early, which means that the track should speed up to match.
+        /// Therefore, the approximated target rate for this object would be equal to 500 / 480 * <see cref="InitialRate"/>.
+        /// </para>
+        /// </example>
+        private readonly Dictionary<HitObject, double> approximatedRates = new Dictionary<HitObject, double>();
 
         public ModAdaptiveSpeed()
         {
@@ -102,7 +135,7 @@ namespace osu.Game.Rulesets.Mods
             InitialRate.TriggerChange();
             AdjustPitch.TriggerChange();
             recentRates.Clear();
-            recentRates.AddRange(Enumerable.Repeat(InitialRate.Value, average_count));
+            recentRates.AddRange(Enumerable.Repeat(InitialRate.Value, recent_rate_count));
         }
 
         public void ApplyToSample(DrawableSample sample)
@@ -121,26 +154,26 @@ namespace osu.Game.Rulesets.Mods
         {
             drawable.OnNewResult += (o, result) =>
             {
-                if (dequeuedRates.ContainsKey(result.HitObject)) return;
+                if (approximatedRates.ContainsKey(result.HitObject)) return;
                 if (!shouldProcessResult(result)) return;
 
-                double prevEndTime = previousEndTimes[result.HitObject];
+                double prevEndTime = precedingEndTimes[result.HitObject];
 
                 recentRates.Add(Math.Clamp((result.HitObject.GetEndTime() - prevEndTime) / (result.TimeAbsolute - prevEndTime) * SpeedChange.Value, min_allowable_rate, max_allowable_rate));
 
-                dequeuedRates.Add(result.HitObject, recentRates[0]);
+                approximatedRates.Add(result.HitObject, recentRates[0]);
                 recentRates.RemoveAt(0);
 
                 targetRate = recentRates.Average();
             };
             drawable.OnRevertResult += (o, result) =>
             {
-                if (!dequeuedRates.ContainsKey(result.HitObject)) return;
+                if (!approximatedRates.ContainsKey(result.HitObject)) return;
                 if (!shouldProcessResult(result)) return;
 
-                recentRates.Insert(0, dequeuedRates[result.HitObject]);
+                recentRates.Insert(0, approximatedRates[result.HitObject]);
                 recentRates.RemoveAt(recentRates.Count - 1);
-                dequeuedRates.Remove(result.HitObject);
+                approximatedRates.Remove(result.HitObject);
 
                 targetRate = recentRates.Average();
             };
@@ -158,7 +191,7 @@ namespace osu.Game.Rulesets.Mods
                 index -= 1;
 
                 if (index >= 0)
-                    previousEndTimes.Add(hitObject, endTimes[index]);
+                    precedingEndTimes.Add(hitObject, endTimes[index]);
             }
         }
 
@@ -188,7 +221,7 @@ namespace osu.Game.Rulesets.Mods
         {
             if (!result.IsHit) return false;
             if (!result.Type.AffectsAccuracy()) return false;
-            if (!previousEndTimes.ContainsKey(result.HitObject)) return false;
+            if (!precedingEndTimes.ContainsKey(result.HitObject)) return false;
 
             return true;
         }

From fcefd3c72544ce153c870734de1b384b411ee1d4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 3 Mar 2022 17:39:47 +0100
Subject: [PATCH 3199/5547] Fix slightly wrong references in xmldocs

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

diff --git a/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs b/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs
index 78839ea692..c28283d0bb 100644
--- a/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs
+++ b/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs
@@ -73,13 +73,13 @@ namespace osu.Game.Rulesets.Mods
 
         /// <summary>
         /// The number of most recent track rates (approximated from how early/late each object was hit relative to the previous object)
-        /// which should be averaged to calculate the instantaneous value of <see cref="SpeedChange"/>.
+        /// which should be averaged to calculate <see cref="targetRate"/>.
         /// </summary>
         private const int recent_rate_count = 6;
 
         /// <summary>
         /// Stores the most recent <see cref="recent_rate_count"/> approximated track rates
-        /// which are averaged to calculate the instantaneous value of <see cref="SpeedChange"/>.
+        /// which are averaged to calculate the value of <see cref="targetRate"/>.
         /// </summary>
         /// <remarks>
         /// This list is used as a double-ended queue with fixed capacity

From 0fbc018a4267d55b63b44a1d185fae4f569229d5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 3 Mar 2022 20:21:09 +0100
Subject: [PATCH 3200/5547] Remove redundant string interpolation prefixes

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

diff --git a/osu.Game/Database/RealmAccess.cs b/osu.Game/Database/RealmAccess.cs
index b093c1ed56..af7c485c57 100644
--- a/osu.Game/Database/RealmAccess.cs
+++ b/osu.Game/Database/RealmAccess.cs
@@ -366,15 +366,15 @@ namespace osu.Game.Database
             static string getMemberName(Expression<Func<TModel, TProperty>> expression)
             {
                 if (!(expression is LambdaExpression lambda))
-                    throw new ArgumentException($"Outermost expression must be a lambda expression", nameof(expression));
+                    throw new ArgumentException("Outermost expression must be a lambda expression", nameof(expression));
 
                 if (!(lambda.Body is MemberExpression memberExpression))
-                    throw new ArgumentException($"Lambda body must be a member access expression", nameof(expression));
+                    throw new ArgumentException("Lambda body must be a member access expression", nameof(expression));
 
                 // TODO: nested access can be supported, with more iteration here
                 // (need to iteratively soft-cast `memberExpression.Expression` into `MemberExpression`s until `lambda.Parameters[0]` is hit)
                 if (memberExpression.Expression != lambda.Parameters[0])
-                    throw new ArgumentException($"Nested access expressions are not supported", nameof(expression));
+                    throw new ArgumentException("Nested access expressions are not supported", nameof(expression));
 
                 return memberExpression.Member.Name;
             }

From edd361d256a2428f9ce0f5a16aa2dc1ceaa2ba96 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 3 Mar 2022 20:21:46 +0100
Subject: [PATCH 3201/5547] Trim unused using directives

---
 osu.Game/Screens/Play/MasterGameplayClockContainer.cs        | 1 -
 osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs | 1 -
 2 files changed, 2 deletions(-)

diff --git a/osu.Game/Screens/Play/MasterGameplayClockContainer.cs b/osu.Game/Screens/Play/MasterGameplayClockContainer.cs
index 7febec5737..af58e9d910 100644
--- a/osu.Game/Screens/Play/MasterGameplayClockContainer.cs
+++ b/osu.Game/Screens/Play/MasterGameplayClockContainer.cs
@@ -3,7 +3,6 @@
 
 using System;
 using System.Collections.Generic;
-using System.ComponentModel;
 using System.Linq;
 using osu.Framework;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs b/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
index 23d7c626da..72c2292624 100644
--- a/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
+++ b/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
@@ -8,7 +8,6 @@ using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
-using osu.Framework.Logging;
 using osu.Framework.Utils;
 using osu.Game.Beatmaps;
 using osu.Game.Database;

From 2e24e7ef56b61320f8516773b2cb5441bc6da3ac Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 3 Mar 2022 20:28:00 +0100
Subject: [PATCH 3202/5547] Use property expression rather than block

---
 osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs | 5 +----
 1 file changed, 1 insertion(+), 4 deletions(-)

diff --git a/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs b/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
index 72c2292624..d09e2cae92 100644
--- a/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
+++ b/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
@@ -96,10 +96,7 @@ namespace osu.Game.Screens.Play.PlayerSettings
             beatmapOffsetSubscription = realm.SubscribeToPropertyChanged(
                 realm => realm.Find<BeatmapInfo>(beatmap.Value.BeatmapInfo.ID)?.UserSettings,
                 settings => settings.Offset,
-                val =>
-                {
-                    Current.Value = val;
-                });
+                val => Current.Value = val);
 
             Current.BindValueChanged(currentChanged);
         }

From 15f65c7897da7f5e3102f00262c2bd8617877135 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 3 Mar 2022 20:28:19 +0100
Subject: [PATCH 3203/5547] Rename lambda param to avoid name shadowing

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

diff --git a/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs b/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
index d09e2cae92..c05c5af10d 100644
--- a/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
+++ b/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
@@ -94,7 +94,7 @@ namespace osu.Game.Screens.Play.PlayerSettings
             ReferenceScore.BindValueChanged(scoreChanged, true);
 
             beatmapOffsetSubscription = realm.SubscribeToPropertyChanged(
-                realm => realm.Find<BeatmapInfo>(beatmap.Value.BeatmapInfo.ID)?.UserSettings,
+                r => r.Find<BeatmapInfo>(beatmap.Value.BeatmapInfo.ID)?.UserSettings,
                 settings => settings.Offset,
                 val => Current.Value = val);
 

From 36263b4dbf09bcbcaed7559be689314d40434e34 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 3 Mar 2022 23:09:56 +0100
Subject: [PATCH 3204/5547] Replace remaining manual online ID check with
 extension method

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

diff --git a/osu.Game/Scoring/Legacy/LegacyScoreEncoder.cs b/osu.Game/Scoring/Legacy/LegacyScoreEncoder.cs
index 1326395695..f0ead05280 100644
--- a/osu.Game/Scoring/Legacy/LegacyScoreEncoder.cs
+++ b/osu.Game/Scoring/Legacy/LegacyScoreEncoder.cs
@@ -7,9 +7,9 @@ using System.Linq;
 using System.Text;
 using osu.Framework.Extensions;
 using osu.Game.Beatmaps;
+using osu.Game.Extensions;
 using osu.Game.IO.Legacy;
 using osu.Game.Replays.Legacy;
-using osu.Game.Rulesets;
 using osu.Game.Rulesets.Replays;
 using osu.Game.Rulesets.Replays.Types;
 using SharpCompress.Compressors.LZMA;
@@ -48,7 +48,7 @@ namespace osu.Game.Scoring.Legacy
             if (beatmap == null && !score.Replay.Frames.All(f => f is LegacyReplayFrame))
                 throw new ArgumentException(@"Beatmap must be provided if frames are not already legacy frames.", nameof(beatmap));
 
-            if (score.ScoreInfo.Ruleset.OnlineID < 0 || score.ScoreInfo.Ruleset.OnlineID > ILegacyRuleset.MAX_LEGACY_RULESET_ID)
+            if (!score.ScoreInfo.Ruleset.IsLegacyRuleset())
                 throw new ArgumentException(@"Only scores in the osu, taiko, catch, or mania rulesets can be encoded to the legacy score format.", nameof(score));
         }
 

From 17729f060582ed948ec6ba32a186549dc651f6c7 Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Thu, 3 Mar 2022 14:53:49 -0800
Subject: [PATCH 3205/5547] Reword ide section of readme to always use latest
 version

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 7ace47a74f..67e28dad97 100644
--- a/README.md
+++ b/README.md
@@ -50,7 +50,7 @@ Please make sure you have the following prerequisites:
 
 - A desktop platform with the [.NET 6.0 SDK](https://dotnet.microsoft.com/download) installed.
 - When developing with mobile, [Xamarin](https://docs.microsoft.com/en-us/xamarin/) is required, which is shipped together with Visual Studio or [Visual Studio for Mac](https://visualstudio.microsoft.com/vs/mac/).
-- When working with the codebase, we recommend using an IDE with intelligent code completion and syntax highlighting, such as [Visual Studio 2019+](https://visualstudio.microsoft.com/vs/), [JetBrains Rider](https://www.jetbrains.com/rider/) or [Visual Studio Code](https://code.visualstudio.com/).
+- When working with the codebase, we recommend using an IDE with intelligent code completion and syntax highlighting, such as the latest version of [Visual Studio](https://visualstudio.microsoft.com/vs/), [JetBrains Rider](https://www.jetbrains.com/rider/) or [Visual Studio Code](https://code.visualstudio.com/).
 - When running on Linux, please have a system-wide FFmpeg installation available to support video decoding.
 
 ### Downloading the source code

From 53f23a429bcf56f426513a5625b98937193bd380 Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Thu, 3 Mar 2022 15:01:21 -0800
Subject: [PATCH 3206/5547] Fix full stop being inside code backticks

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 67e28dad97..f64240f67a 100644
--- a/README.md
+++ b/README.md
@@ -72,7 +72,7 @@ git pull
 
 Build configurations for the recommended IDEs (listed above) are included. You should use the provided Build/Run functionality of your IDE to get things going. When testing or building new components, it's highly encouraged you use the `VisualTests` project/configuration. More information on this is provided [below](#contributing).
 
-- Visual Studio / Rider users should load the project via one of the platform-specific `.slnf` files, rather than the main `.sln.` This will allow access to template run configurations.
+- Visual Studio / Rider users should load the project via one of the platform-specific `.slnf` files, rather than the main `.sln`. This will allow access to template run configurations.
 
 You can also build and run *osu!* from the command-line with a single command:
 

From 18b207400d267d655621511ec89e7ef77a331c59 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 4 Mar 2022 11:34:25 +0900
Subject: [PATCH 3207/5547] Update framework

---
 osu.Android.props        | 2 +-
 osu.Game/osu.Game.csproj | 2 +-
 osu.iOS.props            | 4 ++--
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Android.props b/osu.Android.props
index 526ce959a6..ab1bd553a8 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -52,7 +52,7 @@
   </ItemGroup>
   <ItemGroup>
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.211.0" />
-    <PackageReference Include="ppy.osu.Framework.Android" Version="2022.223.0" />
+    <PackageReference Include="ppy.osu.Framework.Android" Version="2022.304.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
     <!-- Realm needs to be directly referenced in all Xamarin projects, as it will not pull in its transitive dependencies otherwise. -->
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 7dfd099df1..a2739c527b 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="10.9.0" />
-    <PackageReference Include="ppy.osu.Framework" Version="2022.223.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2022.304.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.211.0" />
     <PackageReference Include="Sentry" Version="3.14.0" />
     <PackageReference Include="SharpCompress" Version="0.30.1" />
diff --git a/osu.iOS.props b/osu.iOS.props
index 80600655aa..14824a5af6 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -61,7 +61,7 @@
     <Reference Include="System.Net.Http" />
   </ItemGroup>
   <ItemGroup Label="Package References">
-    <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.223.0" />
+    <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.304.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.211.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net6.0) -->
@@ -84,7 +84,7 @@
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="5.0.14" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.Core" Version="5.0.14" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
-    <PackageReference Include="ppy.osu.Framework" Version="2022.223.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2022.304.0" />
     <PackageReference Include="SharpCompress" Version="0.30.1" />
     <PackageReference Include="NUnit" Version="3.13.2" />
     <PackageReference Include="System.ComponentModel.Annotations" Version="5.0.0" />

From 3a37e6e8b181389426cdcff800f35817ab842a00 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 4 Mar 2022 12:00:02 +0900
Subject: [PATCH 3208/5547] Fix profile badges potentially showing on incorrect
 profile when switching users

Closes https://github.com/ppy/osu/issues/17081.
---
 osu.Game/Overlays/Profile/Header/MedalHeaderContainer.cs | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/Profile/Header/MedalHeaderContainer.cs b/osu.Game/Overlays/Profile/Header/MedalHeaderContainer.cs
index 5f513582e5..6333802549 100644
--- a/osu.Game/Overlays/Profile/Header/MedalHeaderContainer.cs
+++ b/osu.Game/Overlays/Profile/Header/MedalHeaderContainer.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.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Extensions.Color4Extensions;
@@ -63,11 +64,15 @@ namespace osu.Game.Overlays.Profile.Header
             };
         }
 
+        private CancellationTokenSource cancellationTokenSource;
+
         private void updateDisplay(APIUser user)
         {
             var badges = user.Badges;
             badgeFlowContainer.Clear();
 
+            cancellationTokenSource?.Cancel();
+
             if (badges?.Length > 0)
             {
                 Show();
@@ -79,7 +84,7 @@ namespace osu.Game.Overlays.Profile.Header
                     {
                         // load in stable order regardless of async load order.
                         badgeFlowContainer.Insert(displayIndex, asyncBadge);
-                    });
+                    }, (cancellationTokenSource = new CancellationTokenSource()).Token);
                 }
             }
             else

From b66af7edf419823ae63105bb48d78640d615c001 Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Fri, 4 Mar 2022 11:03:57 +0800
Subject: [PATCH 3209/5547] Rename `approximatedRates` to `ratesForRewinding`
 and update xmldoc

---
 osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs | 45 ++++++++++++----------
 1 file changed, 24 insertions(+), 21 deletions(-)

diff --git a/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs b/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs
index c28283d0bb..428d605a99 100644
--- a/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs
+++ b/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs
@@ -87,21 +87,9 @@ namespace osu.Game.Rulesets.Mods
         /// When time is elapsing forward, items are dequeued from the start and enqueued onto the end of the list.
         /// When time is being rewound, items are dequeued from the end and enqueued onto the start of the list.
         /// </remarks>
-        private readonly List<double> recentRates = Enumerable.Repeat(1d, recent_rate_count).ToList();
-
-        /// <summary>
-        /// For each given <see cref="HitObject"/> in the map, this dictionary maps the object onto the latest end time of any other object
-        /// that precedes the end time of the given object.
-        /// This can be loosely interpreted as the end time of the preceding hit object in rulesets that do not have overlapping hit objects.
-        /// </summary>
-        private readonly Dictionary<HitObject, double> precedingEndTimes = new Dictionary<HitObject, double>();
-
-        /// <summary>
-        /// For each given <see cref="HitObject"/> in the map, this dictionary maps the object onto the approximated track rate with which the user hit it.
-        /// </summary>
         /// <example>
         /// <para>
-        /// The approximation is calculated as follows:
+        /// The track rate approximation is calculated as follows:
         /// </para>
         /// <para>
         /// Consider a hitobject which ends at 1000ms, and assume that its preceding hitobject ends at 500ms.
@@ -116,7 +104,21 @@ namespace osu.Game.Rulesets.Mods
         /// Therefore, the approximated target rate for this object would be equal to 500 / 480 * <see cref="InitialRate"/>.
         /// </para>
         /// </example>
-        private readonly Dictionary<HitObject, double> approximatedRates = new Dictionary<HitObject, double>();
+        private readonly List<double> recentRates = Enumerable.Repeat(1d, recent_rate_count).ToList();
+
+        /// <summary>
+        /// For each given <see cref="HitObject"/> in the map, this dictionary maps the object onto the latest end time of any other object
+        /// that precedes the end time of the given object.
+        /// This can be loosely interpreted as the end time of the preceding hit object in rulesets that do not have overlapping hit objects.
+        /// </summary>
+        private readonly Dictionary<HitObject, double> precedingEndTimes = new Dictionary<HitObject, double>();
+
+        /// <summary>
+        /// For each given <see cref="HitObject"/> in the map, this dictionary maps the object onto the track rate dequeued from
+        /// <see cref="recentRates"/> (i.e. the oldest value in the queue) when the object is hit. If the hit is then reverted,
+        /// the mapped value can be re-introduced to <see cref="recentRates"/> to properly rewind the queue.
+        /// </summary>
+        private readonly Dictionary<HitObject, double> ratesForRewinding = new Dictionary<HitObject, double>();
 
         public ModAdaptiveSpeed()
         {
@@ -154,26 +156,27 @@ namespace osu.Game.Rulesets.Mods
         {
             drawable.OnNewResult += (o, result) =>
             {
-                if (approximatedRates.ContainsKey(result.HitObject)) return;
+                if (ratesForRewinding.ContainsKey(result.HitObject)) return;
                 if (!shouldProcessResult(result)) return;
 
                 double prevEndTime = precedingEndTimes[result.HitObject];
 
-                recentRates.Add(Math.Clamp((result.HitObject.GetEndTime() - prevEndTime) / (result.TimeAbsolute - prevEndTime) * SpeedChange.Value, min_allowable_rate, max_allowable_rate));
-
-                approximatedRates.Add(result.HitObject, recentRates[0]);
+                ratesForRewinding.Add(result.HitObject, recentRates[0]);
                 recentRates.RemoveAt(0);
 
+                recentRates.Add(Math.Clamp((result.HitObject.GetEndTime() - prevEndTime) / (result.TimeAbsolute - prevEndTime) * SpeedChange.Value, min_allowable_rate, max_allowable_rate));
+
                 targetRate = recentRates.Average();
             };
             drawable.OnRevertResult += (o, result) =>
             {
-                if (!approximatedRates.ContainsKey(result.HitObject)) return;
+                if (!ratesForRewinding.ContainsKey(result.HitObject)) return;
                 if (!shouldProcessResult(result)) return;
 
-                recentRates.Insert(0, approximatedRates[result.HitObject]);
+                recentRates.Insert(0, ratesForRewinding[result.HitObject]);
+                ratesForRewinding.Remove(result.HitObject);
+
                 recentRates.RemoveAt(recentRates.Count - 1);
-                approximatedRates.Remove(result.HitObject);
 
                 targetRate = recentRates.Average();
             };

From c38126ba9d708fe8250dbb76c5a8fe91cff464d3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 4 Mar 2022 12:05:02 +0900
Subject: [PATCH 3210/5547] Make mods argument optional for storyboard
 construction

---
 osu.Game/Storyboards/Drawables/DrawableStoryboard.cs | 5 +++--
 osu.Game/Storyboards/Storyboard.cs                   | 2 +-
 2 files changed, 4 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Storyboards/Drawables/DrawableStoryboard.cs b/osu.Game/Storyboards/Drawables/DrawableStoryboard.cs
index 01e4dfca02..a0fb7b0b4a 100644
--- a/osu.Game/Storyboards/Drawables/DrawableStoryboard.cs
+++ b/osu.Game/Storyboards/Drawables/DrawableStoryboard.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 System.Threading;
@@ -60,10 +61,10 @@ namespace osu.Game.Storyboards.Drawables
         protected override IReadOnlyDependencyContainer CreateChildDependencies(IReadOnlyDependencyContainer parent) =>
             dependencies = new DependencyContainer(base.CreateChildDependencies(parent));
 
-        public DrawableStoryboard(Storyboard storyboard, IReadOnlyList<Mod> mods)
+        public DrawableStoryboard(Storyboard storyboard, IReadOnlyList<Mod> mods = null)
         {
             Storyboard = storyboard;
-            Mods = mods;
+            Mods = mods ?? Array.Empty<Mod>();
 
             Size = new Vector2(640, 480);
 
diff --git a/osu.Game/Storyboards/Storyboard.cs b/osu.Game/Storyboards/Storyboard.cs
index 844950336d..2faed98ae0 100644
--- a/osu.Game/Storyboards/Storyboard.cs
+++ b/osu.Game/Storyboards/Storyboard.cs
@@ -91,7 +91,7 @@ namespace osu.Game.Storyboards
             }
         }
 
-        public DrawableStoryboard CreateDrawable(IReadOnlyList<Mod> mods) =>
+        public DrawableStoryboard CreateDrawable(IReadOnlyList<Mod> mods = null) =>
             new DrawableStoryboard(this, mods);
 
         public Drawable CreateSpriteFromResourcePath(string path, TextureStore textureStore)

From abba49fd8f8bbe15b93ace48809bc342b486488a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 4 Mar 2022 12:16:05 +0900
Subject: [PATCH 3211/5547] Update all usages of `OsuSlider.TooltipText`
 overrides to instead implement `GetTooltipText`

---
 osu.Game.Rulesets.Mania/ManiaSettingsSubsection.cs          | 2 +-
 osu.Game/Graphics/UserInterface/OsuSliderBar.cs             | 2 +-
 osu.Game/Overlays/Settings/Sections/Audio/OffsetSettings.cs | 2 +-
 .../Overlays/Settings/Sections/Graphics/LayoutSettings.cs   | 2 +-
 osu.Game/Overlays/Settings/Sections/Input/MouseSettings.cs  | 4 +++-
 osu.Game/Overlays/Settings/Sections/SizeSlider.cs           | 2 +-
 .../Settings/Sections/UserInterface/GeneralSettings.cs      | 2 +-
 .../Settings/Sections/UserInterface/SongSelectSettings.cs   | 6 ++++--
 osu.Game/Rulesets/Mods/ModMuted.cs                          | 2 +-
 osu.Game/Rulesets/Mods/ModNoScope.cs                        | 2 +-
 10 files changed, 15 insertions(+), 11 deletions(-)

diff --git a/osu.Game.Rulesets.Mania/ManiaSettingsSubsection.cs b/osu.Game.Rulesets.Mania/ManiaSettingsSubsection.cs
index 36fa336d0c..ae3c279d98 100644
--- a/osu.Game.Rulesets.Mania/ManiaSettingsSubsection.cs
+++ b/osu.Game.Rulesets.Mania/ManiaSettingsSubsection.cs
@@ -48,7 +48,7 @@ namespace osu.Game.Rulesets.Mania
 
         private class TimeSlider : OsuSliderBar<double>
         {
-            public override LocalisableString TooltipText => Current.Value.ToString(@"N0") + "ms";
+            protected override LocalisableString GetTooltipText(double value) => $"{value:N0} ms";
         }
     }
 }
diff --git a/osu.Game/Graphics/UserInterface/OsuSliderBar.cs b/osu.Game/Graphics/UserInterface/OsuSliderBar.cs
index a5bc02246d..747a56f636 100644
--- a/osu.Game/Graphics/UserInterface/OsuSliderBar.cs
+++ b/osu.Game/Graphics/UserInterface/OsuSliderBar.cs
@@ -40,7 +40,7 @@ namespace osu.Game.Graphics.UserInterface
         private readonly Box rightBox;
         private readonly Container nubContainer;
 
-        public virtual LocalisableString TooltipText { get; private set; }
+        public LocalisableString TooltipText { get; private set; }
 
         /// <summary>
         /// Whether to format the tooltip as a percentage or the actual value.
diff --git a/osu.Game/Overlays/Settings/Sections/Audio/OffsetSettings.cs b/osu.Game/Overlays/Settings/Sections/Audio/OffsetSettings.cs
index 9345d3fcc7..1aaee5b540 100644
--- a/osu.Game/Overlays/Settings/Sections/Audio/OffsetSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Audio/OffsetSettings.cs
@@ -38,7 +38,7 @@ namespace osu.Game.Overlays.Settings.Sections.Audio
 
         private class OffsetSlider : OsuSliderBar<double>
         {
-            public override LocalisableString TooltipText => Current.Value.ToString(@"0ms");
+            protected override LocalisableString GetTooltipText(double value) => value.ToString(@"0ms");
         }
     }
 }
diff --git a/osu.Game/Overlays/Settings/Sections/Graphics/LayoutSettings.cs b/osu.Game/Overlays/Settings/Sections/Graphics/LayoutSettings.cs
index adf1453d1a..b572f1c6a0 100644
--- a/osu.Game/Overlays/Settings/Sections/Graphics/LayoutSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Graphics/LayoutSettings.cs
@@ -240,7 +240,7 @@ namespace osu.Game.Overlays.Settings.Sections.Graphics
 
         private class UIScaleSlider : OsuSliderBar<float>
         {
-            public override LocalisableString TooltipText => base.TooltipText + "x";
+            protected override LocalisableString GetTooltipText(float value) => $"{base.GetTooltipText(value)}x";
         }
 
         private class ResolutionSettingsDropdown : SettingsDropdown<Size>
diff --git a/osu.Game/Overlays/Settings/Sections/Input/MouseSettings.cs b/osu.Game/Overlays/Settings/Sections/Input/MouseSettings.cs
index 4235dc0a05..971b19ca6c 100644
--- a/osu.Game/Overlays/Settings/Sections/Input/MouseSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Input/MouseSettings.cs
@@ -135,7 +135,9 @@ namespace osu.Game.Overlays.Settings.Sections.Input
 
         private class SensitivitySlider : OsuSliderBar<double>
         {
-            public override LocalisableString TooltipText => Current.Disabled ? MouseSettingsStrings.EnableHighPrecisionForSensitivityAdjust : $"{base.TooltipText}x";
+            protected override LocalisableString GetTooltipText(double value) => Current.Disabled
+                ? MouseSettingsStrings.EnableHighPrecisionForSensitivityAdjust
+                : $"{base.GetTooltipText(value)}x";
         }
     }
 }
diff --git a/osu.Game/Overlays/Settings/Sections/SizeSlider.cs b/osu.Game/Overlays/Settings/Sections/SizeSlider.cs
index 8aeb440be1..c80b330db6 100644
--- a/osu.Game/Overlays/Settings/Sections/SizeSlider.cs
+++ b/osu.Game/Overlays/Settings/Sections/SizeSlider.cs
@@ -11,6 +11,6 @@ namespace osu.Game.Overlays.Settings.Sections
     /// </summary>
     internal class SizeSlider : OsuSliderBar<float>
     {
-        public override LocalisableString TooltipText => Current.Value.ToString(@"0.##x");
+        protected override LocalisableString GetTooltipText(float value) => value.ToString(@"0.##x");
     }
 }
diff --git a/osu.Game/Overlays/Settings/Sections/UserInterface/GeneralSettings.cs b/osu.Game/Overlays/Settings/Sections/UserInterface/GeneralSettings.cs
index 0afbed5df5..ca59095875 100644
--- a/osu.Game/Overlays/Settings/Sections/UserInterface/GeneralSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/UserInterface/GeneralSettings.cs
@@ -46,7 +46,7 @@ namespace osu.Game.Overlays.Settings.Sections.UserInterface
 
         private class TimeSlider : OsuSliderBar<float>
         {
-            public override LocalisableString TooltipText => Current.Value.ToString(@"N0") + "ms";
+            protected override LocalisableString GetTooltipText(float value) => $"{value:N0} ms";
         }
     }
 }
diff --git a/osu.Game/Overlays/Settings/Sections/UserInterface/SongSelectSettings.cs b/osu.Game/Overlays/Settings/Sections/UserInterface/SongSelectSettings.cs
index 6290046987..c24513e7b4 100644
--- a/osu.Game/Overlays/Settings/Sections/UserInterface/SongSelectSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/UserInterface/SongSelectSettings.cs
@@ -64,12 +64,14 @@ namespace osu.Game.Overlays.Settings.Sections.UserInterface
 
         private class MaximumStarsSlider : StarsSlider
         {
-            public override LocalisableString TooltipText => Current.IsDefault ? UserInterfaceStrings.NoLimit : base.TooltipText;
+            protected override LocalisableString GetTooltipText(double value) => Current.IsDefault
+                ? UserInterfaceStrings.NoLimit
+                : base.GetTooltipText(value);
         }
 
         private class StarsSlider : OsuSliderBar<double>
         {
-            public override LocalisableString TooltipText => Current.Value.ToString(@"0.## stars");
+            protected override LocalisableString GetTooltipText(double value) => $"{value:0.##} stars";
         }
     }
 }
diff --git a/osu.Game/Rulesets/Mods/ModMuted.cs b/osu.Game/Rulesets/Mods/ModMuted.cs
index 1d33b44812..e528d8214e 100644
--- a/osu.Game/Rulesets/Mods/ModMuted.cs
+++ b/osu.Game/Rulesets/Mods/ModMuted.cs
@@ -111,6 +111,6 @@ namespace osu.Game.Rulesets.Mods
 
     public class MuteComboSlider : OsuSliderBar<int>
     {
-        public override LocalisableString TooltipText => Current.Value == 0 ? "always muted" : base.TooltipText;
+        protected override LocalisableString GetTooltipText(int value) => value == 0 ? "always muted" : base.GetTooltipText(value);
     }
 }
diff --git a/osu.Game/Rulesets/Mods/ModNoScope.cs b/osu.Game/Rulesets/Mods/ModNoScope.cs
index 7a935eb38f..c71239ea5a 100644
--- a/osu.Game/Rulesets/Mods/ModNoScope.cs
+++ b/osu.Game/Rulesets/Mods/ModNoScope.cs
@@ -57,6 +57,6 @@ namespace osu.Game.Rulesets.Mods
 
     public class HiddenComboSlider : OsuSliderBar<int>
     {
-        public override LocalisableString TooltipText => Current.Value == 0 ? "always hidden" : base.TooltipText;
+        protected override LocalisableString GetTooltipText(int value) => value == 0 ? "always hidden" : base.GetTooltipText(value);
     }
 }

From 7854a0a9132ddfd3f8deee5ee6c3a62dcb8000e9 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 4 Mar 2022 12:21:05 +0900
Subject: [PATCH 3212/5547] Use `double` instead of `float` for
 `UIHoldActivationDelay` configuration value

All times use double, so let's also use double here.
---
 osu.Game/Configuration/OsuConfigManager.cs                | 2 +-
 osu.Game/Graphics/Containers/HoldToConfirmContainer.cs    | 4 ++--
 .../Settings/Sections/UserInterface/GeneralSettings.cs    | 8 ++++----
 osu.Game/Screens/Menu/MainMenu.cs                         | 4 ++--
 osu.Game/Screens/Play/HUD/HoldForMenuButton.cs            | 4 ++--
 5 files changed, 11 insertions(+), 11 deletions(-)

diff --git a/osu.Game/Configuration/OsuConfigManager.cs b/osu.Game/Configuration/OsuConfigManager.cs
index 07d2026c65..35638a025c 100644
--- a/osu.Game/Configuration/OsuConfigManager.cs
+++ b/osu.Game/Configuration/OsuConfigManager.cs
@@ -140,7 +140,7 @@ namespace osu.Game.Configuration
 
             SetDefault(OsuSetting.UIScale, 1f, 0.8f, 1.6f, 0.01f);
 
-            SetDefault(OsuSetting.UIHoldActivationDelay, 200f, 0f, 500f, 50f);
+            SetDefault(OsuSetting.UIHoldActivationDelay, 200.0, 0.0, 500.0, 50.0);
 
             SetDefault(OsuSetting.IntroSequence, IntroSequence.Triangles);
 
diff --git a/osu.Game/Graphics/Containers/HoldToConfirmContainer.cs b/osu.Game/Graphics/Containers/HoldToConfirmContainer.cs
index fcf445a878..999dd183aa 100644
--- a/osu.Game/Graphics/Containers/HoldToConfirmContainer.cs
+++ b/osu.Game/Graphics/Containers/HoldToConfirmContainer.cs
@@ -30,12 +30,12 @@ namespace osu.Game.Graphics.Containers
 
         public Bindable<double> Progress = new BindableDouble();
 
-        private Bindable<float> holdActivationDelay;
+        private Bindable<double> holdActivationDelay;
 
         [BackgroundDependencyLoader]
         private void load(OsuConfigManager config)
         {
-            holdActivationDelay = config.GetBindable<float>(OsuSetting.UIHoldActivationDelay);
+            holdActivationDelay = config.GetBindable<double>(OsuSetting.UIHoldActivationDelay);
         }
 
         protected void BeginConfirm()
diff --git a/osu.Game/Overlays/Settings/Sections/UserInterface/GeneralSettings.cs b/osu.Game/Overlays/Settings/Sections/UserInterface/GeneralSettings.cs
index ca59095875..c9d3b72add 100644
--- a/osu.Game/Overlays/Settings/Sections/UserInterface/GeneralSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/UserInterface/GeneralSettings.cs
@@ -35,18 +35,18 @@ namespace osu.Game.Overlays.Settings.Sections.UserInterface
                     LabelText = UserInterfaceStrings.Parallax,
                     Current = config.GetBindable<bool>(OsuSetting.MenuParallax)
                 },
-                new SettingsSlider<float, TimeSlider>
+                new SettingsSlider<double, TimeSlider>
                 {
                     LabelText = UserInterfaceStrings.HoldToConfirmActivationTime,
-                    Current = config.GetBindable<float>(OsuSetting.UIHoldActivationDelay),
+                    Current = config.GetBindable<double>(OsuSetting.UIHoldActivationDelay),
                     KeyboardStep = 50
                 },
             };
         }
 
-        private class TimeSlider : OsuSliderBar<float>
+        private class TimeSlider : OsuSliderBar<double>
         {
-            protected override LocalisableString GetTooltipText(float value) => $"{value:N0} ms";
+            protected override LocalisableString GetTooltipText(double value) => $"{value:N0} ms";
         }
     }
 }
diff --git a/osu.Game/Screens/Menu/MainMenu.cs b/osu.Game/Screens/Menu/MainMenu.cs
index b0208a0ae8..e2d79b4015 100644
--- a/osu.Game/Screens/Menu/MainMenu.cs
+++ b/osu.Game/Screens/Menu/MainMenu.cs
@@ -66,7 +66,7 @@ namespace osu.Game.Screens.Menu
 
         protected override BackgroundScreen CreateBackground() => background;
 
-        private Bindable<float> holdDelay;
+        private Bindable<double> holdDelay;
         private Bindable<bool> loginDisplayed;
 
         private ExitConfirmOverlay exitConfirmOverlay;
@@ -77,7 +77,7 @@ namespace osu.Game.Screens.Menu
         [BackgroundDependencyLoader(true)]
         private void load(BeatmapListingOverlay beatmapListing, SettingsOverlay settings, OsuConfigManager config, SessionStatics statics)
         {
-            holdDelay = config.GetBindable<float>(OsuSetting.UIHoldActivationDelay);
+            holdDelay = config.GetBindable<double>(OsuSetting.UIHoldActivationDelay);
             loginDisplayed = statics.GetBindable<bool>(Static.LoginOverlayDisplayed);
 
             if (host.CanExit)
diff --git a/osu.Game/Screens/Play/HUD/HoldForMenuButton.cs b/osu.Game/Screens/Play/HUD/HoldForMenuButton.cs
index 430f001427..4087011933 100644
--- a/osu.Game/Screens/Play/HUD/HoldForMenuButton.cs
+++ b/osu.Game/Screens/Play/HUD/HoldForMenuButton.cs
@@ -63,11 +63,11 @@ namespace osu.Game.Screens.Play.HUD
         [Resolved]
         private OsuConfigManager config { get; set; }
 
-        private Bindable<float> activationDelay;
+        private Bindable<double> activationDelay;
 
         protected override void LoadComplete()
         {
-            activationDelay = config.GetBindable<float>(OsuSetting.UIHoldActivationDelay);
+            activationDelay = config.GetBindable<double>(OsuSetting.UIHoldActivationDelay);
             activationDelay.BindValueChanged(v =>
             {
                 text.Text = v.NewValue > 0

From 33862fc0dbc3bca229f2cf719cd3271cf5d131ff Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 4 Mar 2022 12:25:19 +0900
Subject: [PATCH 3213/5547] Centralise implementation of slider bars which
 display millisecond time values

---
 .../ManiaSettingsSubsection.cs                    |  5 -----
 osu.Game/Graphics/UserInterface/TimeSlider.cs     | 15 +++++++++++++++
 .../Settings/Sections/Audio/OffsetSettings.cs     |  7 +------
 .../Sections/UserInterface/GeneralSettings.cs     |  5 -----
 4 files changed, 16 insertions(+), 16 deletions(-)
 create mode 100644 osu.Game/Graphics/UserInterface/TimeSlider.cs

diff --git a/osu.Game.Rulesets.Mania/ManiaSettingsSubsection.cs b/osu.Game.Rulesets.Mania/ManiaSettingsSubsection.cs
index ae3c279d98..bd3b8c3b10 100644
--- a/osu.Game.Rulesets.Mania/ManiaSettingsSubsection.cs
+++ b/osu.Game.Rulesets.Mania/ManiaSettingsSubsection.cs
@@ -45,10 +45,5 @@ namespace osu.Game.Rulesets.Mania
                 }
             };
         }
-
-        private class TimeSlider : OsuSliderBar<double>
-        {
-            protected override LocalisableString GetTooltipText(double value) => $"{value:N0} ms";
-        }
     }
 }
diff --git a/osu.Game/Graphics/UserInterface/TimeSlider.cs b/osu.Game/Graphics/UserInterface/TimeSlider.cs
new file mode 100644
index 0000000000..e99345f147
--- /dev/null
+++ b/osu.Game/Graphics/UserInterface/TimeSlider.cs
@@ -0,0 +1,15 @@
+// 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.Graphics.UserInterface
+{
+    /// <summary>
+    /// A slider bar which displays a millisecond time value.
+    /// </summary>
+    public class TimeSlider : OsuSliderBar<double>
+    {
+        protected override LocalisableString GetTooltipText(double value) => $"{value:N0} ms";
+    }
+}
diff --git a/osu.Game/Overlays/Settings/Sections/Audio/OffsetSettings.cs b/osu.Game/Overlays/Settings/Sections/Audio/OffsetSettings.cs
index 1aaee5b540..673252a99e 100644
--- a/osu.Game/Overlays/Settings/Sections/Audio/OffsetSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Audio/OffsetSettings.cs
@@ -23,7 +23,7 @@ namespace osu.Game.Overlays.Settings.Sections.Audio
         {
             Children = new Drawable[]
             {
-                new SettingsSlider<double, OffsetSlider>
+                new SettingsSlider<double, TimeSlider>
                 {
                     LabelText = AudioSettingsStrings.AudioOffset,
                     Current = config.GetBindable<double>(OsuSetting.AudioOffset),
@@ -35,10 +35,5 @@ namespace osu.Game.Overlays.Settings.Sections.Audio
                 }
             };
         }
-
-        private class OffsetSlider : OsuSliderBar<double>
-        {
-            protected override LocalisableString GetTooltipText(double value) => value.ToString(@"0ms");
-        }
     }
 }
diff --git a/osu.Game/Overlays/Settings/Sections/UserInterface/GeneralSettings.cs b/osu.Game/Overlays/Settings/Sections/UserInterface/GeneralSettings.cs
index c9d3b72add..59894cbcae 100644
--- a/osu.Game/Overlays/Settings/Sections/UserInterface/GeneralSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/UserInterface/GeneralSettings.cs
@@ -43,10 +43,5 @@ namespace osu.Game.Overlays.Settings.Sections.UserInterface
                 },
             };
         }
-
-        private class TimeSlider : OsuSliderBar<double>
-        {
-            protected override LocalisableString GetTooltipText(double value) => $"{value:N0} ms";
-        }
     }
 }

From ac914878b80a5efef642d1158954258bcd4af42d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 4 Mar 2022 12:31:57 +0900
Subject: [PATCH 3214/5547] Move default function specifications to
 `OsuConfigManager`

This ensures that running tests in release configuration will not fail
due to the same issue being fixed in this PR.
---
 osu.Game/Configuration/DevelopmentOsuConfigManager.cs | 2 --
 osu.Game/Configuration/OsuConfigManager.cs            | 4 ++--
 2 files changed, 2 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Configuration/DevelopmentOsuConfigManager.cs b/osu.Game/Configuration/DevelopmentOsuConfigManager.cs
index f1cb0731fe..ff19dd874c 100644
--- a/osu.Game/Configuration/DevelopmentOsuConfigManager.cs
+++ b/osu.Game/Configuration/DevelopmentOsuConfigManager.cs
@@ -14,8 +14,6 @@ namespace osu.Game.Configuration
         public DevelopmentOsuConfigManager(Storage storage)
             : base(storage)
         {
-            LookupKeyBindings = _ => "unknown";
-            LookupSkinName = _ => "unknown";
         }
     }
 }
diff --git a/osu.Game/Configuration/OsuConfigManager.cs b/osu.Game/Configuration/OsuConfigManager.cs
index 07d2026c65..1358b41ad2 100644
--- a/osu.Game/Configuration/OsuConfigManager.cs
+++ b/osu.Game/Configuration/OsuConfigManager.cs
@@ -240,9 +240,9 @@ namespace osu.Game.Configuration
             };
         }
 
-        public Func<Guid, string> LookupSkinName { private get; set; }
+        public Func<Guid, string> LookupSkinName { private get; set; } = _ => @"unknown";
 
-        public Func<GlobalAction, LocalisableString> LookupKeyBindings { get; set; }
+        public Func<GlobalAction, LocalisableString> LookupKeyBindings { get; set; } = _ => @"unknown";
     }
 
     // IMPORTANT: These are used in user configuration files.

From 8b504bb5ac2944efffcd3a7e0a378a26db83abda Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 4 Mar 2022 12:42:07 +0900
Subject: [PATCH 3215/5547] Ensure rounding is still applied in non-midpoint
 cases

---
 .../Ranking/Statistics/HitEventTimingDistributionGraph.cs     | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/Ranking/Statistics/HitEventTimingDistributionGraph.cs b/osu.Game/Screens/Ranking/Statistics/HitEventTimingDistributionGraph.cs
index 3a4641cba9..235eac7f78 100644
--- a/osu.Game/Screens/Ranking/Statistics/HitEventTimingDistributionGraph.cs
+++ b/osu.Game/Screens/Ranking/Statistics/HitEventTimingDistributionGraph.cs
@@ -75,11 +75,11 @@ namespace osu.Game.Screens.Ranking.Statistics
                 // so the easiest way is to cycle between downwards and upwards rounding as we process events.
                 if (Math.Abs(binOffset - (int)binOffset) == 0.5)
                 {
-                    binOffset += Math.Sign(binOffset) * (roundUp ? 1 : 0);
+                    binOffset = (int)binOffset + Math.Sign(binOffset) * (roundUp ? 1 : 0);
                     roundUp = !roundUp;
                 }
 
-                bins[timing_distribution_centre_bin_index + (int)binOffset]++;
+                bins[timing_distribution_centre_bin_index + (int)Math.Round(binOffset, MidpointRounding.AwayFromZero)]++;
             }
 
             int maxCount = bins.Max();

From 8115a4bb8fd9e2d53c40b8607c7ad99f0f62e9a0 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 3 Mar 2022 16:28:32 +0900
Subject: [PATCH 3216/5547] Fix potential crash in tests when attempting to
 lookup key bindings in cases the lookup is not available

---
 osu.Game/Configuration/DevelopmentOsuConfigManager.cs | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/osu.Game/Configuration/DevelopmentOsuConfigManager.cs b/osu.Game/Configuration/DevelopmentOsuConfigManager.cs
index ff19dd874c..f1cb0731fe 100644
--- a/osu.Game/Configuration/DevelopmentOsuConfigManager.cs
+++ b/osu.Game/Configuration/DevelopmentOsuConfigManager.cs
@@ -14,6 +14,8 @@ namespace osu.Game.Configuration
         public DevelopmentOsuConfigManager(Storage storage)
             : base(storage)
         {
+            LookupKeyBindings = _ => "unknown";
+            LookupSkinName = _ => "unknown";
         }
     }
 }

From 657f2ebb9dbd355428bb6b48845b0edd83155e13 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 3 Mar 2022 16:59:10 +0900
Subject: [PATCH 3217/5547] Restructure `OsuSliderBar` to allow for custom
 tooltips

---
 .../Graphics/UserInterface/OsuSliderBar.cs    | 34 ++++++++-----------
 1 file changed, 14 insertions(+), 20 deletions(-)

diff --git a/osu.Game/Graphics/UserInterface/OsuSliderBar.cs b/osu.Game/Graphics/UserInterface/OsuSliderBar.cs
index 333ae4f832..17dce10cf6 100644
--- a/osu.Game/Graphics/UserInterface/OsuSliderBar.cs
+++ b/osu.Game/Graphics/UserInterface/OsuSliderBar.cs
@@ -40,7 +40,7 @@ namespace osu.Game.Graphics.UserInterface
         private readonly Box rightBox;
         private readonly Container nubContainer;
 
-        public virtual LocalisableString TooltipText { get; private set; }
+        public virtual LocalisableString TooltipText { get; protected set; }
 
         /// <summary>
         /// Whether to format the tooltip as a percentage or the actual value.
@@ -148,7 +148,7 @@ namespace osu.Game.Graphics.UserInterface
         protected override void LoadComplete()
         {
             base.LoadComplete();
-            CurrentNumber.BindValueChanged(current => updateTooltipText(current.NewValue), true);
+            CurrentNumber.BindValueChanged(current => TooltipText = GetTooltipText(current.NewValue), true);
         }
 
         protected override bool OnHover(HoverEvent e)
@@ -178,7 +178,7 @@ namespace osu.Game.Graphics.UserInterface
         {
             base.OnUserChange(value);
             playSample(value);
-            updateTooltipText(value);
+            TooltipText = GetTooltipText(value);
         }
 
         private void playSample(T value)
@@ -203,28 +203,22 @@ namespace osu.Game.Graphics.UserInterface
             channel.Play();
         }
 
-        private void updateTooltipText(T value)
+        protected virtual LocalisableString GetTooltipText(T value)
         {
             if (CurrentNumber.IsInteger)
-                TooltipText = value.ToInt32(NumberFormatInfo.InvariantInfo).ToString("N0");
-            else
-            {
-                double floatValue = value.ToDouble(NumberFormatInfo.InvariantInfo);
+                return value.ToInt32(NumberFormatInfo.InvariantInfo).ToString("N0");
 
-                if (DisplayAsPercentage)
-                {
-                    TooltipText = floatValue.ToString("0%");
-                }
-                else
-                {
-                    decimal decimalPrecision = normalise(CurrentNumber.Precision.ToDecimal(NumberFormatInfo.InvariantInfo), max_decimal_digits);
+            double floatValue = value.ToDouble(NumberFormatInfo.InvariantInfo);
 
-                    // Find the number of significant digits (we could have less than 5 after normalize())
-                    int significantDigits = FormatUtils.FindPrecision(decimalPrecision);
+            if (DisplayAsPercentage)
+                return floatValue.ToString("0%");
 
-                    TooltipText = floatValue.ToString($"N{significantDigits}");
-                }
-            }
+            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);
+
+            return floatValue.ToString($"N{significantDigits}");
         }
 
         protected override void UpdateAfterChildren()

From cc4f89eef429160c4304841ef735a0b79d048820 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 3 Mar 2022 17:07:46 +0900
Subject: [PATCH 3218/5547] Add tooltip text for offset adjustment slider

---
 .../BeatmapOffsetControlStrings.cs            | 12 +++++++-
 .../PlayerSettings/BeatmapOffsetControl.cs    | 28 ++++++++++++++++++-
 .../Play/PlayerSettings/PlayerSliderBar.cs    | 12 ++++----
 3 files changed, 45 insertions(+), 7 deletions(-)

diff --git a/osu.Game/Localisation/BeatmapOffsetControlStrings.cs b/osu.Game/Localisation/BeatmapOffsetControlStrings.cs
index 7b2a9e50b2..632a1ad0ea 100644
--- a/osu.Game/Localisation/BeatmapOffsetControlStrings.cs
+++ b/osu.Game/Localisation/BeatmapOffsetControlStrings.cs
@@ -29,6 +29,16 @@ namespace osu.Game.Localisation
         /// </summary>
         public static LocalisableString CalibrateUsingLastPlay => new TranslatableString(getKey(@"calibrate_using_last_play"), @"Calibrate using last play");
 
+        /// <summary>
+        /// "(hit objects appear later)"
+        /// </summary>
+        public static LocalisableString HitObjectsAppearLater => new TranslatableString(getKey(@"hit_objects_appear_later"), @"(hit objects appear later)");
+
+        /// <summary>
+        /// "(hit objects appear earlier)"
+        /// </summary>
+        public static LocalisableString HitObjectsAppearEarlier => new TranslatableString(getKey(@"hit_objects_appear_earlier"), @"(hit objects appear earlier)");
+
         private static string getKey(string key) => $@"{prefix}:{key}";
     }
-}
\ No newline at end of file
+}
diff --git a/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs b/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
index dc3e80d695..201e431367 100644
--- a/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
+++ b/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
@@ -3,12 +3,14 @@
 
 using System;
 using System.ComponentModel;
+using System.Diagnostics;
 using System.Linq;
 using System.Threading.Tasks;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
+using osu.Framework.Localisation;
 using osu.Framework.Utils;
 using osu.Game.Beatmaps;
 using osu.Game.Database;
@@ -71,7 +73,7 @@ namespace osu.Game.Screens.Play.PlayerSettings
                 Spacing = new Vector2(10),
                 Children = new Drawable[]
                 {
-                    new PlayerSliderBar<double>
+                    new OffsetSliderBar
                     {
                         KeyboardStep = 5,
                         LabelText = BeatmapOffsetControlStrings.BeatmapOffset,
@@ -88,6 +90,30 @@ namespace osu.Game.Screens.Play.PlayerSettings
             };
         }
 
+        public class OffsetSliderBar : PlayerSliderBar<double>
+        {
+            protected override Drawable CreateControl() => new CustomSliderBar();
+
+            protected class CustomSliderBar : SliderBar
+            {
+                protected override LocalisableString GetTooltipText(double value)
+                {
+                    return value == 0
+                        ? new TranslatableString("_", @"{0} ms", base.GetTooltipText(value))
+                        : new TranslatableString("_", @"{0} ms {1}", base.GetTooltipText(value), getEarlyLateText(value));
+                }
+
+                private LocalisableString getEarlyLateText(double value)
+                {
+                    Debug.Assert(value != 0);
+
+                    return value > 0
+                        ? BeatmapOffsetControlStrings.HitObjectsAppearLater
+                        : BeatmapOffsetControlStrings.HitObjectsAppearEarlier;
+                }
+            }
+        }
+
         protected override void LoadComplete()
         {
             base.LoadComplete();
diff --git a/osu.Game/Screens/Play/PlayerSettings/PlayerSliderBar.cs b/osu.Game/Screens/Play/PlayerSettings/PlayerSliderBar.cs
index 57ffe16f76..3f1a5bc0ac 100644
--- a/osu.Game/Screens/Play/PlayerSettings/PlayerSliderBar.cs
+++ b/osu.Game/Screens/Play/PlayerSettings/PlayerSliderBar.cs
@@ -15,13 +15,15 @@ namespace osu.Game.Screens.Play.PlayerSettings
     {
         public OsuSliderBar<T> Bar => (OsuSliderBar<T>)Control;
 
-        protected override Drawable CreateControl() => new SliderBar
-        {
-            RelativeSizeAxes = Axes.X
-        };
+        protected override Drawable CreateControl() => new SliderBar();
 
-        private class SliderBar : OsuSliderBar<T>
+        protected class SliderBar : OsuSliderBar<T>
         {
+            public SliderBar()
+            {
+                RelativeSizeAxes = Axes.X;
+            }
+
             [BackgroundDependencyLoader]
             private void load(OsuColour colours)
             {

From 5dca0e3377fbb69667648709022db0440fe09394 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 3 Mar 2022 21:31:56 +0900
Subject: [PATCH 3219/5547] Revert back to `private set`

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

diff --git a/osu.Game/Graphics/UserInterface/OsuSliderBar.cs b/osu.Game/Graphics/UserInterface/OsuSliderBar.cs
index 17dce10cf6..a5bc02246d 100644
--- a/osu.Game/Graphics/UserInterface/OsuSliderBar.cs
+++ b/osu.Game/Graphics/UserInterface/OsuSliderBar.cs
@@ -40,7 +40,7 @@ namespace osu.Game.Graphics.UserInterface
         private readonly Box rightBox;
         private readonly Container nubContainer;
 
-        public virtual LocalisableString TooltipText { get; protected set; }
+        public virtual LocalisableString TooltipText { get; private set; }
 
         /// <summary>
         /// Whether to format the tooltip as a percentage or the actual value.

From c1c9482077655d9315803cd5239aa66c16604928 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 4 Mar 2022 00:14:24 +0900
Subject: [PATCH 3220/5547] Add note about how global audio offset is currently
 applied

---
 osu.Game/Configuration/OsuConfigManager.cs | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/osu.Game/Configuration/OsuConfigManager.cs b/osu.Game/Configuration/OsuConfigManager.cs
index 07d2026c65..5f9cd0470c 100644
--- a/osu.Game/Configuration/OsuConfigManager.cs
+++ b/osu.Game/Configuration/OsuConfigManager.cs
@@ -270,7 +270,13 @@ namespace osu.Game.Configuration
         MouseDisableButtons,
         MouseDisableWheel,
         ConfineMouseMode,
+
+        /// <summary>
+        /// Globally applied audio offset.
+        /// This is added to the audio track's current time. Higher values will cause gameplay to occur earlier, relative to the audio track.
+        /// </summary>
         AudioOffset,
+
         VolumeInactive,
         MenuMusic,
         MenuVoice,

From f72c9a1f410de9b456567b2366b4dd4dce7eb624 Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Fri, 4 Mar 2022 11:48:48 +0800
Subject: [PATCH 3221/5547] Cap speed change per hit and apply a speed decrease
 on miss

---
 osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs | 30 +++++++++++++++++-----
 1 file changed, 24 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs b/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs
index 428d605a99..e7ca1d3150 100644
--- a/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs
+++ b/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs
@@ -65,8 +65,16 @@ namespace osu.Game.Rulesets.Mods
         // The two constants below denote the maximum allowable range of rates that `SpeedChange` can take.
         // The range is purposefully wider than the range of values that `InitialRate` allows
         // in order to give some leeway for change even when extreme initial rates are chosen.
-        private const double min_allowable_rate = 0.4f;
-        private const double max_allowable_rate = 2.5f;
+        private const double min_allowable_rate = 0.4d;
+        private const double max_allowable_rate = 2.5d;
+
+        // The two constants below denote the maximum allowable change in rate caused by a single hit
+        // This prevents sudden jolts caused by a badly-timed hit.
+        private const double min_allowable_rate_change = 0.8d;
+        private const double max_allowable_rate_change = 1.25d;
+
+        // Apply a fixed rate change when missing, allowing the player to catch up when the rate is too fast.
+        private const double rate_change_on_miss = 0.95d;
 
         private ITrack track;
         private double targetRate = 1d;
@@ -159,12 +167,10 @@ namespace osu.Game.Rulesets.Mods
                 if (ratesForRewinding.ContainsKey(result.HitObject)) return;
                 if (!shouldProcessResult(result)) return;
 
-                double prevEndTime = precedingEndTimes[result.HitObject];
-
                 ratesForRewinding.Add(result.HitObject, recentRates[0]);
                 recentRates.RemoveAt(0);
 
-                recentRates.Add(Math.Clamp((result.HitObject.GetEndTime() - prevEndTime) / (result.TimeAbsolute - prevEndTime) * SpeedChange.Value, min_allowable_rate, max_allowable_rate));
+                recentRates.Add(Math.Clamp(getRelativeRateChange(result) * SpeedChange.Value, min_allowable_rate, max_allowable_rate));
 
                 targetRate = recentRates.Average();
             };
@@ -222,11 +228,23 @@ namespace osu.Game.Rulesets.Mods
 
         private bool shouldProcessResult(JudgementResult result)
         {
-            if (!result.IsHit) return false;
             if (!result.Type.AffectsAccuracy()) return false;
             if (!precedingEndTimes.ContainsKey(result.HitObject)) return false;
 
             return true;
         }
+
+        private double getRelativeRateChange(JudgementResult result)
+        {
+            if (!result.IsHit)
+                return rate_change_on_miss;
+
+            double prevEndTime = precedingEndTimes[result.HitObject];
+            return Math.Clamp(
+                (result.HitObject.GetEndTime() - prevEndTime) / (result.TimeAbsolute - prevEndTime),
+                min_allowable_rate_change,
+                max_allowable_rate_change
+            );
+        }
     }
 }

From e09dd7d8fe79ed1019f99b76946931db152eebc1 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 4 Mar 2022 12:55:35 +0900
Subject: [PATCH 3222/5547] Fix calibrating offset from previous non-zero
 offset not applying adjustment correctly

---
 .../Gameplay/TestSceneBeatmapOffsetControl.cs | 30 ++++++++++++++++++-
 .../PlayerSettings/BeatmapOffsetControl.cs    |  6 ++--
 2 files changed, 33 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneBeatmapOffsetControl.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneBeatmapOffsetControl.cs
index 67f5db548b..4b079cbb2c 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneBeatmapOffsetControl.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneBeatmapOffsetControl.cs
@@ -48,7 +48,7 @@ namespace osu.Game.Tests.Visual.Gameplay
         }
 
         [Test]
-        public void TestDisplay()
+        public void TestCalibrationFromZero()
         {
             const double average_error = -4.5;
 
@@ -70,5 +70,33 @@ namespace osu.Game.Tests.Visual.Gameplay
             AddStep("Remove reference score", () => offsetControl.ReferenceScore.Value = null);
             AddAssert("No calibration button", () => !offsetControl.ChildrenOfType<SettingsButton>().Any());
         }
+
+        /// <summary>
+        /// When a beatmap offset was already set, the calibration should take it into account.
+        /// </summary>
+        [Test]
+        public void TestCalibrationFromNonZero()
+        {
+            const double average_error = -4.5;
+            const double initial_offset = -2;
+
+            AddStep("Set offset non-neutral", () => offsetControl.Current.Value = initial_offset);
+            AddAssert("No calibration button", () => !offsetControl.ChildrenOfType<SettingsButton>().Any());
+            AddStep("Set reference score", () =>
+            {
+                offsetControl.ReferenceScore.Value = new ScoreInfo
+                {
+                    HitEvents = TestSceneHitEventTimingDistributionGraph.CreateDistributedHitEvents(average_error)
+                };
+            });
+
+            AddAssert("Has calibration button", () => offsetControl.ChildrenOfType<SettingsButton>().Any());
+            AddStep("Press button", () => offsetControl.ChildrenOfType<SettingsButton>().Single().TriggerClick());
+            AddAssert("Offset is adjusted", () => offsetControl.Current.Value == initial_offset - average_error);
+
+            AddAssert("Button is disabled", () => !offsetControl.ChildrenOfType<SettingsButton>().Single().Enabled.Value);
+            AddStep("Remove reference score", () => offsetControl.ReferenceScore.Value = null);
+            AddAssert("No calibration button", () => !offsetControl.ChildrenOfType<SettingsButton>().Any());
+        }
     }
 }
diff --git a/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs b/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
index 201e431367..1d6d0acb76 100644
--- a/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
+++ b/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
@@ -53,6 +53,7 @@ namespace osu.Game.Screens.Play.PlayerSettings
         private OsuColour colours { get; set; } = null!;
 
         private double lastPlayAverage;
+        private double lastPlayBeatmapOffset;
 
         private SettingsButton? useAverageButton;
 
@@ -156,7 +157,7 @@ namespace osu.Game.Screens.Play.PlayerSettings
                 }
 
                 if (useAverageButton != null)
-                    useAverageButton.Enabled.Value = !Precision.AlmostEquals(lastPlayAverage, -Current.Value, Current.Precision / 2);
+                    useAverageButton.Enabled.Value = !Precision.AlmostEquals(lastPlayAverage, -Current.Value + lastPlayBeatmapOffset, Current.Precision / 2);
 
                 realmWriteTask = realm.WriteAsync(r =>
                 {
@@ -213,6 +214,7 @@ namespace osu.Game.Screens.Play.PlayerSettings
             }
 
             lastPlayAverage = average;
+            lastPlayBeatmapOffset = Current.Value;
 
             referenceScoreContainer.AddRange(new Drawable[]
             {
@@ -225,7 +227,7 @@ namespace osu.Game.Screens.Play.PlayerSettings
                 useAverageButton = new SettingsButton
                 {
                     Text = BeatmapOffsetControlStrings.CalibrateUsingLastPlay,
-                    Action = () => Current.Value = -lastPlayAverage
+                    Action = () => Current.Value = lastPlayBeatmapOffset - lastPlayAverage
                 },
             });
         }

From 010fa7ed0185dcce7192c50abb972fb864ac1e78 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 4 Mar 2022 13:09:19 +0900
Subject: [PATCH 3223/5547] Allow an offset to be shown on the timing
 distribution graph

---
 .../PlayerSettings/BeatmapOffsetControl.cs    | 17 ++++++--
 .../HitEventTimingDistributionGraph.cs        | 42 ++++++++++++++++---
 2 files changed, 50 insertions(+), 9 deletions(-)

diff --git a/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs b/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
index 1d6d0acb76..4af2de6409 100644
--- a/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
+++ b/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
@@ -54,6 +54,7 @@ namespace osu.Game.Screens.Play.PlayerSettings
 
         private double lastPlayAverage;
         private double lastPlayBeatmapOffset;
+        private HitEventTimingDistributionGraph? lastPlayGraph;
 
         private SettingsButton? useAverageButton;
 
@@ -109,8 +110,8 @@ namespace osu.Game.Screens.Play.PlayerSettings
                     Debug.Assert(value != 0);
 
                     return value > 0
-                        ? BeatmapOffsetControlStrings.HitObjectsAppearLater
-                        : BeatmapOffsetControlStrings.HitObjectsAppearEarlier;
+                        ? BeatmapOffsetControlStrings.HitObjectsAppearEarlier
+                        : BeatmapOffsetControlStrings.HitObjectsAppearLater;
                 }
             }
         }
@@ -149,6 +150,12 @@ namespace osu.Game.Screens.Play.PlayerSettings
 
             void updateOffset()
             {
+                // the last play graph is relative to the offset at the point of the last play, so we need to factor that out.
+                double adjustmentSinceLastPlay = lastPlayBeatmapOffset - Current.Value;
+
+                // Negative is applied here because the play graph is considering a hit offset, not track (as we currently use for clocks).
+                lastPlayGraph?.UpdateOffset(-adjustmentSinceLastPlay);
+
                 // ensure the previous write has completed. ignoring performance concerns, if we don't do this, the async writes could be out of sequence.
                 if (realmWriteTask?.IsCompleted == false)
                 {
@@ -157,7 +164,9 @@ namespace osu.Game.Screens.Play.PlayerSettings
                 }
 
                 if (useAverageButton != null)
-                    useAverageButton.Enabled.Value = !Precision.AlmostEquals(lastPlayAverage, -Current.Value + lastPlayBeatmapOffset, Current.Precision / 2);
+                {
+                    useAverageButton.Enabled.Value = !Precision.AlmostEquals(lastPlayAverage, adjustmentSinceLastPlay, Current.Precision / 2);
+                }
 
                 realmWriteTask = realm.WriteAsync(r =>
                 {
@@ -218,7 +227,7 @@ namespace osu.Game.Screens.Play.PlayerSettings
 
             referenceScoreContainer.AddRange(new Drawable[]
             {
-                new HitEventTimingDistributionGraph(hitEvents)
+                lastPlayGraph = new HitEventTimingDistributionGraph(hitEvents)
                 {
                     RelativeSizeAxes = Axes.X,
                     Height = 50,
diff --git a/osu.Game/Screens/Ranking/Statistics/HitEventTimingDistributionGraph.cs b/osu.Game/Screens/Ranking/Statistics/HitEventTimingDistributionGraph.cs
index b32b11c028..48c18deaec 100644
--- a/osu.Game/Screens/Ranking/Statistics/HitEventTimingDistributionGraph.cs
+++ b/osu.Game/Screens/Ranking/Statistics/HitEventTimingDistributionGraph.cs
@@ -40,6 +40,9 @@ namespace osu.Game.Screens.Ranking.Statistics
         /// </summary>
         private const float axis_points = 5;
 
+        /// <summary>
+        /// The currently displayed hit events.
+        /// </summary>
         private readonly IReadOnlyList<HitEvent> hitEvents;
 
         /// <summary>
@@ -51,24 +54,43 @@ namespace osu.Game.Screens.Ranking.Statistics
             this.hitEvents = hitEvents.Where(e => !(e.HitObject.HitWindows is HitWindows.EmptyHitWindows) && e.Result.IsHit()).ToList();
         }
 
+        private int[] bins;
+        private double binSize;
+        private double hitOffset;
+
         [BackgroundDependencyLoader]
         private void load()
         {
             if (hitEvents == null || hitEvents.Count == 0)
                 return;
 
-            int[] bins = new int[total_timing_distribution_bins];
+            bins = new int[total_timing_distribution_bins];
 
-            double binSize = Math.Ceiling(hitEvents.Max(e => Math.Abs(e.TimeOffset)) / timing_distribution_bins);
+            binSize = Math.Ceiling(hitEvents.Max(e => Math.Abs(e.TimeOffset)) / timing_distribution_bins);
 
             // Prevent div-by-0 by enforcing a minimum bin size
             binSize = Math.Max(1, binSize);
 
+            Scheduler.AddOnce(updateDisplay);
+        }
+
+        public void UpdateOffset(double hitOffset)
+        {
+            this.hitOffset = hitOffset;
+            Scheduler.AddOnce(updateDisplay);
+        }
+
+        private void updateDisplay()
+        {
             bool roundUp = true;
 
+            Array.Clear(bins, 0, bins.Length);
+
             foreach (var e in hitEvents)
             {
-                double binOffset = e.TimeOffset / binSize;
+                double time = e.TimeOffset + hitOffset;
+
+                double binOffset = time / binSize;
 
                 // .NET's round midpoint handling doesn't provide a behaviour that works amazingly for display
                 // purposes here. We want midpoint rounding to roughly distribute evenly to each adjacent bucket
@@ -79,13 +101,23 @@ namespace osu.Game.Screens.Ranking.Statistics
                     roundUp = !roundUp;
                 }
 
-                bins[timing_distribution_centre_bin_index + (int)Math.Round(binOffset, MidpointRounding.AwayFromZero)]++;
+                int index = timing_distribution_centre_bin_index + (int)Math.Round(binOffset, MidpointRounding.AwayFromZero);
+
+                // may be out of range when applying an offset. for such cases we can just drop the results.
+                if (index >= 0 && index < bins.Length)
+                    bins[index]++;
             }
 
             int maxCount = bins.Max();
             var bars = new Drawable[total_timing_distribution_bins];
+
             for (int i = 0; i < bars.Length; i++)
-                bars[i] = new Bar { Height = Math.Max(0.05f, (float)bins[i] / maxCount) };
+            {
+                bars[i] = new Bar
+                {
+                    Height = Math.Max(0.05f, (float)bins[i] / maxCount)
+                };
+            }
 
             Container axisFlow;
 

From c063a73742c14494e17231b1d6d933a3cc17dbf9 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 4 Mar 2022 13:48:42 +0900
Subject: [PATCH 3224/5547] Fix autosize weirdness by specifying a constant
 size for the x axis

---
 .../Statistics/HitEventTimingDistributionGraph.cs      | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Screens/Ranking/Statistics/HitEventTimingDistributionGraph.cs b/osu.Game/Screens/Ranking/Statistics/HitEventTimingDistributionGraph.cs
index 48c18deaec..d83422a7b6 100644
--- a/osu.Game/Screens/Ranking/Statistics/HitEventTimingDistributionGraph.cs
+++ b/osu.Game/Screens/Ranking/Statistics/HitEventTimingDistributionGraph.cs
@@ -121,6 +121,8 @@ namespace osu.Game.Screens.Ranking.Statistics
 
             Container axisFlow;
 
+            const float axis_font_size = 12;
+
             InternalChild = new GridContainer
             {
                 Anchor = Anchor.Centre,
@@ -142,7 +144,7 @@ namespace osu.Game.Screens.Ranking.Statistics
                         axisFlow = new Container
                         {
                             RelativeSizeAxes = Axes.X,
-                            AutoSizeAxes = Axes.Y
+                            Height = axis_font_size,
                         }
                     },
                 },
@@ -162,7 +164,7 @@ namespace osu.Game.Screens.Ranking.Statistics
                 Anchor = Anchor.Centre,
                 Origin = Anchor.Centre,
                 Text = "0",
-                Font = OsuFont.GetFont(size: 12, weight: FontWeight.SemiBold)
+                Font = OsuFont.GetFont(size: axis_font_size, weight: FontWeight.SemiBold)
             });
 
             for (int i = 1; i <= axis_points; i++)
@@ -179,7 +181,7 @@ namespace osu.Game.Screens.Ranking.Statistics
                     X = -position / 2,
                     Alpha = alpha,
                     Text = axisValue.ToString("-0"),
-                    Font = OsuFont.GetFont(size: 12, weight: FontWeight.SemiBold)
+                    Font = OsuFont.GetFont(size: axis_font_size, weight: FontWeight.SemiBold)
                 });
 
                 axisFlow.Add(new OsuSpriteText
@@ -190,7 +192,7 @@ namespace osu.Game.Screens.Ranking.Statistics
                     X = position / 2,
                     Alpha = alpha,
                     Text = axisValue.ToString("+0"),
-                    Font = OsuFont.GetFont(size: 12, weight: FontWeight.SemiBold)
+                    Font = OsuFont.GetFont(size: axis_font_size, weight: FontWeight.SemiBold)
                 });
             }
         }

From d3e04fe594fe6e3a4c827aef0e9f16efd5ad9420 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 4 Mar 2022 14:09:27 +0900
Subject: [PATCH 3225/5547] Colour centre bin in distribution graph differently

---
 .../Statistics/HitEventTimingDistributionGraph.cs     | 11 ++++++++---
 1 file changed, 8 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Screens/Ranking/Statistics/HitEventTimingDistributionGraph.cs b/osu.Game/Screens/Ranking/Statistics/HitEventTimingDistributionGraph.cs
index d83422a7b6..72d53e5d1b 100644
--- a/osu.Game/Screens/Ranking/Statistics/HitEventTimingDistributionGraph.cs
+++ b/osu.Game/Screens/Ranking/Statistics/HitEventTimingDistributionGraph.cs
@@ -113,7 +113,7 @@ namespace osu.Game.Screens.Ranking.Statistics
 
             for (int i = 0; i < bars.Length; i++)
             {
-                bars[i] = new Bar
+                bars[i] = new Bar(i == timing_distribution_centre_bin_index)
                 {
                     Height = Math.Max(0.05f, (float)bins[i] / maxCount)
                 };
@@ -199,17 +199,22 @@ namespace osu.Game.Screens.Ranking.Statistics
 
         private class Bar : CompositeDrawable
         {
-            public Bar()
+            public Bar(bool isCentre)
             {
                 Anchor = Anchor.BottomCentre;
                 Origin = Anchor.BottomCentre;
 
                 RelativeSizeAxes = Axes.Both;
 
+                var colour = Color4Extensions.FromHex("#66FFCC");
+
+                if (isCentre)
+                    colour = colour.Lighten(1);
+
                 InternalChild = new Circle
                 {
                     RelativeSizeAxes = Axes.Both,
-                    Colour = Color4Extensions.FromHex("#66FFCC")
+                    Colour = colour
                 };
             }
         }

From 540d7d0e2c1b58be41d03c6026df9077f17af440 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 4 Mar 2022 14:34:33 +0900
Subject: [PATCH 3226/5547] Add the ability to set and show an offset value on
 timing distribution graph

---
 ...estSceneHitEventTimingDistributionGraph.cs |   5 +-
 .../HitEventTimingDistributionGraph.cs        | 205 +++++++++++-------
 2 files changed, 126 insertions(+), 84 deletions(-)

diff --git a/osu.Game.Tests/Visual/Ranking/TestSceneHitEventTimingDistributionGraph.cs b/osu.Game.Tests/Visual/Ranking/TestSceneHitEventTimingDistributionGraph.cs
index f31aec8975..48ce6145c0 100644
--- a/osu.Game.Tests/Visual/Ranking/TestSceneHitEventTimingDistributionGraph.cs
+++ b/osu.Game.Tests/Visual/Ranking/TestSceneHitEventTimingDistributionGraph.cs
@@ -17,10 +17,13 @@ namespace osu.Game.Tests.Visual.Ranking
 {
     public class TestSceneHitEventTimingDistributionGraph : OsuTestScene
     {
+        private HitEventTimingDistributionGraph graph;
+
         [Test]
         public void TestManyDistributedEvents()
         {
             createTest(CreateDistributedHitEvents());
+            AddStep("add adjustment", () => graph.UpdateOffset(10));
         }
 
         [Test]
@@ -68,7 +71,7 @@ namespace osu.Game.Tests.Visual.Ranking
                     RelativeSizeAxes = Axes.Both,
                     Colour = Color4Extensions.FromHex("#333")
                 },
-                new HitEventTimingDistributionGraph(events)
+                graph = new HitEventTimingDistributionGraph(events)
                 {
                     Anchor = Anchor.Centre,
                     Origin = Anchor.Centre,
diff --git a/osu.Game/Screens/Ranking/Statistics/HitEventTimingDistributionGraph.cs b/osu.Game/Screens/Ranking/Statistics/HitEventTimingDistributionGraph.cs
index 72d53e5d1b..d510d995e2 100644
--- a/osu.Game/Screens/Ranking/Statistics/HitEventTimingDistributionGraph.cs
+++ b/osu.Game/Screens/Ranking/Statistics/HitEventTimingDistributionGraph.cs
@@ -12,6 +12,7 @@ using osu.Framework.Graphics.Shapes;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Rulesets.Scoring;
+using osuTK.Graphics;
 
 namespace osu.Game.Screens.Ranking.Statistics
 {
@@ -58,6 +59,8 @@ namespace osu.Game.Screens.Ranking.Statistics
         private double binSize;
         private double hitOffset;
 
+        private Bar[] barDrawables;
+
         [BackgroundDependencyLoader]
         private void load()
         {
@@ -108,115 +111,151 @@ namespace osu.Game.Screens.Ranking.Statistics
                     bins[index]++;
             }
 
-            int maxCount = bins.Max();
-            var bars = new Drawable[total_timing_distribution_bins];
-
-            for (int i = 0; i < bars.Length; i++)
+            if (barDrawables != null)
             {
-                bars[i] = new Bar(i == timing_distribution_centre_bin_index)
+                for (int i = 0; i < barDrawables.Length; i++)
                 {
-                    Height = Math.Max(0.05f, (float)bins[i] / maxCount)
-                };
-            }
-
-            Container axisFlow;
-
-            const float axis_font_size = 12;
-
-            InternalChild = new GridContainer
-            {
-                Anchor = Anchor.Centre,
-                Origin = Anchor.Centre,
-                RelativeSizeAxes = Axes.Both,
-                Width = 0.8f,
-                Content = new[]
-                {
-                    new Drawable[]
-                    {
-                        new GridContainer
-                        {
-                            RelativeSizeAxes = Axes.Both,
-                            Content = new[] { bars }
-                        }
-                    },
-                    new Drawable[]
-                    {
-                        axisFlow = new Container
-                        {
-                            RelativeSizeAxes = Axes.X,
-                            Height = axis_font_size,
-                        }
-                    },
-                },
-                RowDimensions = new[]
-                {
-                    new Dimension(),
-                    new Dimension(GridSizeMode.AutoSize),
+                    barDrawables[i].UpdateOffset(bins[i]);
                 }
-            };
-
-            // Our axis will contain one centre element + 5 points on each side, each with a value depending on the number of bins * bin size.
-            double maxValue = timing_distribution_bins * binSize;
-            double axisValueStep = maxValue / axis_points;
-
-            axisFlow.Add(new OsuSpriteText
+            }
+            else
             {
-                Anchor = Anchor.Centre,
-                Origin = Anchor.Centre,
-                Text = "0",
-                Font = OsuFont.GetFont(size: axis_font_size, weight: FontWeight.SemiBold)
-            });
+                int maxCount = bins.Max();
+                barDrawables = new Bar[total_timing_distribution_bins];
 
-            for (int i = 1; i <= axis_points; i++)
-            {
-                double axisValue = i * axisValueStep;
-                float position = (float)(axisValue / maxValue);
-                float alpha = 1f - position * 0.8f;
+                for (int i = 0; i < barDrawables.Length; i++)
+                    barDrawables[i] = new Bar(bins[i], maxCount, i == timing_distribution_centre_bin_index);
+
+                Container axisFlow;
+
+                const float axis_font_size = 12;
+
+                InternalChild = new GridContainer
+                {
+                    Anchor = Anchor.Centre,
+                    Origin = Anchor.Centre,
+                    RelativeSizeAxes = Axes.Both,
+                    Width = 0.8f,
+                    Content = new[]
+                    {
+                        new Drawable[]
+                        {
+                            new GridContainer
+                            {
+                                RelativeSizeAxes = Axes.Both,
+                                Content = new[] { barDrawables }
+                            }
+                        },
+                        new Drawable[]
+                        {
+                            axisFlow = new Container
+                            {
+                                RelativeSizeAxes = Axes.X,
+                                Height = axis_font_size,
+                            }
+                        },
+                    },
+                    RowDimensions = new[]
+                    {
+                        new Dimension(),
+                        new Dimension(GridSizeMode.AutoSize),
+                    }
+                };
+
+                // Our axis will contain one centre element + 5 points on each side, each with a value depending on the number of bins * bin size.
+                double maxValue = timing_distribution_bins * binSize;
+                double axisValueStep = maxValue / axis_points;
 
                 axisFlow.Add(new OsuSpriteText
                 {
                     Anchor = Anchor.Centre,
                     Origin = Anchor.Centre,
-                    RelativePositionAxes = Axes.X,
-                    X = -position / 2,
-                    Alpha = alpha,
-                    Text = axisValue.ToString("-0"),
+                    Text = "0",
                     Font = OsuFont.GetFont(size: axis_font_size, weight: FontWeight.SemiBold)
                 });
 
-                axisFlow.Add(new OsuSpriteText
+                for (int i = 1; i <= axis_points; i++)
                 {
-                    Anchor = Anchor.Centre,
-                    Origin = Anchor.Centre,
-                    RelativePositionAxes = Axes.X,
-                    X = position / 2,
-                    Alpha = alpha,
-                    Text = axisValue.ToString("+0"),
-                    Font = OsuFont.GetFont(size: axis_font_size, weight: FontWeight.SemiBold)
-                });
+                    double axisValue = i * axisValueStep;
+                    float position = (float)(axisValue / maxValue);
+                    float alpha = 1f - position * 0.8f;
+
+                    axisFlow.Add(new OsuSpriteText
+                    {
+                        Anchor = Anchor.Centre,
+                        Origin = Anchor.Centre,
+                        RelativePositionAxes = Axes.X,
+                        X = -position / 2,
+                        Alpha = alpha,
+                        Text = axisValue.ToString("-0"),
+                        Font = OsuFont.GetFont(size: axis_font_size, weight: FontWeight.SemiBold)
+                    });
+
+                    axisFlow.Add(new OsuSpriteText
+                    {
+                        Anchor = Anchor.Centre,
+                        Origin = Anchor.Centre,
+                        RelativePositionAxes = Axes.X,
+                        X = position / 2,
+                        Alpha = alpha,
+                        Text = axisValue.ToString("+0"),
+                        Font = OsuFont.GetFont(size: axis_font_size, weight: FontWeight.SemiBold)
+                    });
+                }
             }
         }
 
         private class Bar : CompositeDrawable
         {
-            public Bar(bool isCentre)
+            private readonly float value;
+            private readonly float maxValue;
+
+            private readonly Circle boxOriginal;
+            private readonly Circle boxAdjustment;
+
+            public Bar(float value, float maxValue, bool isCentre)
             {
-                Anchor = Anchor.BottomCentre;
-                Origin = Anchor.BottomCentre;
+                this.value = value;
+                this.maxValue = maxValue;
 
                 RelativeSizeAxes = Axes.Both;
+                Masking = true;
 
-                var colour = Color4Extensions.FromHex("#66FFCC");
-
-                if (isCentre)
-                    colour = colour.Lighten(1);
-
-                InternalChild = new Circle
+                InternalChildren = new Drawable[]
                 {
-                    RelativeSizeAxes = Axes.Both,
-                    Colour = colour
+                    boxOriginal = new Circle
+                    {
+                        RelativeSizeAxes = Axes.Both,
+                        Anchor = Anchor.BottomCentre,
+                        Origin = Anchor.BottomCentre,
+                        Colour = isCentre ? Color4.White : Color4Extensions.FromHex("#66FFCC"),
+                        Height = 0,
+                    },
+                    boxAdjustment = new Circle
+                    {
+                        RelativeSizeAxes = Axes.Both,
+                        Anchor = Anchor.BottomCentre,
+                        Origin = Anchor.BottomCentre,
+                        Colour = Color4.Yellow,
+                        Blending = BlendingParameters.Additive,
+                        Alpha = 0.6f,
+                        Height = 0,
+                    },
                 };
             }
+
+            private const double duration = 300;
+
+            protected override void LoadComplete()
+            {
+                base.LoadComplete();
+                boxOriginal.ResizeHeightTo(Math.Clamp(value / maxValue, 0.05f, 1), duration, Easing.OutQuint);
+            }
+
+            public void UpdateOffset(float adjustment)
+            {
+                boxAdjustment.ResizeHeightTo(Math.Clamp(adjustment / maxValue, 0.05f, 1), duration, Easing.OutQuint);
+            }
         }
     }
 }

From 81a49057ec7e1fa089d40b103f55fbc2ae5c7f8f Mon Sep 17 00:00:00 2001
From: Riley Quinn <merileyquinn@gmail.com>
Date: Thu, 3 Mar 2022 22:30:08 -0600
Subject: [PATCH 3227/5547] Fix wiki links containing locale not loading when
 opened from chat.

---
 osu.Game/Overlays/WikiOverlay.cs | 12 +++++++++++-
 1 file changed, 11 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/WikiOverlay.cs b/osu.Game/Overlays/WikiOverlay.cs
index 44713d637d..63191900d8 100644
--- a/osu.Game/Overlays/WikiOverlay.cs
+++ b/osu.Game/Overlays/WikiOverlay.cs
@@ -7,6 +7,7 @@ using System.Threading;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
+using osu.Game.Extensions;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests;
 using osu.Game.Online.API.Requests.Responses;
@@ -100,7 +101,16 @@ namespace osu.Game.Overlays
             cancellationToken?.Cancel();
             request?.Cancel();
 
-            request = new GetWikiRequest(e.NewValue);
+            string[] values = e.NewValue.Split('/', 2);
+
+            if (values.Length > 1 && LanguageExtensions.TryParseCultureCode(values[0], out _))
+            {
+                request = new GetWikiRequest(values[1], values[0]);
+            }
+            else
+            {
+                request = new GetWikiRequest(e.NewValue);
+            }
 
             Loading.Show();
 

From 92cd8ee29faf693bc6e02c87abc16b4e14ef40ff Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 4 Mar 2022 14:56:46 +0900
Subject: [PATCH 3228/5547] Decrease overhead of hit event distribution tests

---
 .../TestSceneHitEventTimingDistributionGraph.cs   | 15 +++++++++------
 1 file changed, 9 insertions(+), 6 deletions(-)

diff --git a/osu.Game.Tests/Visual/Ranking/TestSceneHitEventTimingDistributionGraph.cs b/osu.Game.Tests/Visual/Ranking/TestSceneHitEventTimingDistributionGraph.cs
index 48ce6145c0..7471b6acf2 100644
--- a/osu.Game.Tests/Visual/Ranking/TestSceneHitEventTimingDistributionGraph.cs
+++ b/osu.Game.Tests/Visual/Ranking/TestSceneHitEventTimingDistributionGraph.cs
@@ -8,6 +8,7 @@ using NUnit.Framework;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Shapes;
+using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Osu.Objects;
 using osu.Game.Rulesets.Scoring;
 using osu.Game.Screens.Ranking.Statistics;
@@ -19,6 +20,8 @@ namespace osu.Game.Tests.Visual.Ranking
     {
         private HitEventTimingDistributionGraph graph;
 
+        private static readonly HitObject placeholder_object = new HitCircle();
+
         [Test]
         public void TestManyDistributedEvents()
         {
@@ -35,13 +38,13 @@ namespace osu.Game.Tests.Visual.Ranking
         [Test]
         public void TestAroundCentre()
         {
-            createTest(Enumerable.Range(-150, 300).Select(i => new HitEvent(i / 50f, HitResult.Perfect, new HitCircle(), new HitCircle(), null)).ToList());
+            createTest(Enumerable.Range(-150, 300).Select(i => new HitEvent(i / 50f, HitResult.Perfect, placeholder_object, placeholder_object, null)).ToList());
         }
 
         [Test]
         public void TestZeroTimeOffset()
         {
-            createTest(Enumerable.Range(0, 100).Select(_ => new HitEvent(0, HitResult.Perfect, new HitCircle(), new HitCircle(), null)).ToList());
+            createTest(Enumerable.Range(0, 100).Select(_ => new HitEvent(0, HitResult.Perfect, placeholder_object, placeholder_object, null)).ToList());
         }
 
         [Test]
@@ -56,9 +59,9 @@ namespace osu.Game.Tests.Visual.Ranking
             createTest(Enumerable.Range(0, 100).Select(i =>
             {
                 if (i % 2 == 0)
-                    return new HitEvent(0, HitResult.Perfect, new HitCircle(), new HitCircle(), null);
+                    return new HitEvent(0, HitResult.Perfect, placeholder_object, placeholder_object, null);
 
-                return new HitEvent(30, HitResult.Miss, new HitCircle(), new HitCircle(), null);
+                return new HitEvent(30, HitResult.Miss, placeholder_object, placeholder_object, null);
             }).ToList());
         }
 
@@ -86,10 +89,10 @@ namespace osu.Game.Tests.Visual.Ranking
 
             for (int i = 0; i < range * 2; i++)
             {
-                int count = (int)(Math.Pow(range - Math.Abs(i - range), 2));
+                int count = (int)(Math.Pow(range - Math.Abs(i - range), 2)) / 10;
 
                 for (int j = 0; j < count; j++)
-                    hitEvents.Add(new HitEvent(centre + i - range, HitResult.Perfect, new HitCircle(), new HitCircle(), null));
+                    hitEvents.Add(new HitEvent(centre + i - range, HitResult.Perfect, placeholder_object, placeholder_object, null));
             }
 
             return hitEvents;

From 2785218b7932e93e61a654388e9dea6ccdaccac9 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 4 Mar 2022 14:59:53 +0900
Subject: [PATCH 3229/5547] Only apply animation if the bar is going to be
 larger than the minimum height

---
 .../Statistics/HitEventTimingDistributionGraph.cs      | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/Ranking/Statistics/HitEventTimingDistributionGraph.cs b/osu.Game/Screens/Ranking/Statistics/HitEventTimingDistributionGraph.cs
index d510d995e2..d475556c84 100644
--- a/osu.Game/Screens/Ranking/Statistics/HitEventTimingDistributionGraph.cs
+++ b/osu.Game/Screens/Ranking/Statistics/HitEventTimingDistributionGraph.cs
@@ -213,6 +213,8 @@ namespace osu.Game.Screens.Ranking.Statistics
             private readonly Circle boxOriginal;
             private readonly Circle boxAdjustment;
 
+            private const float minimum_height = 0.05f;
+
             public Bar(float value, float maxValue, bool isCentre)
             {
                 this.value = value;
@@ -229,7 +231,7 @@ namespace osu.Game.Screens.Ranking.Statistics
                         Anchor = Anchor.BottomCentre,
                         Origin = Anchor.BottomCentre,
                         Colour = isCentre ? Color4.White : Color4Extensions.FromHex("#66FFCC"),
-                        Height = 0,
+                        Height = minimum_height,
                     },
                     boxAdjustment = new Circle
                     {
@@ -249,7 +251,11 @@ namespace osu.Game.Screens.Ranking.Statistics
             protected override void LoadComplete()
             {
                 base.LoadComplete();
-                boxOriginal.ResizeHeightTo(Math.Clamp(value / maxValue, 0.05f, 1), duration, Easing.OutQuint);
+
+                float height = Math.Clamp(value / maxValue, minimum_height, 1);
+
+                if (height > minimum_height)
+                    boxOriginal.ResizeHeightTo(height, duration, Easing.OutQuint);
             }
 
             public void UpdateOffset(float adjustment)

From 8c7b1e0aa8dcaf5a48134d53ea4a3d23a2054111 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 4 Mar 2022 15:01:54 +0900
Subject: [PATCH 3230/5547] Only construct the adjustment portion of bars when
 required

---
 .../HitEventTimingDistributionGraph.cs        | 26 +++++++++++--------
 1 file changed, 15 insertions(+), 11 deletions(-)

diff --git a/osu.Game/Screens/Ranking/Statistics/HitEventTimingDistributionGraph.cs b/osu.Game/Screens/Ranking/Statistics/HitEventTimingDistributionGraph.cs
index d475556c84..c823ed1f4c 100644
--- a/osu.Game/Screens/Ranking/Statistics/HitEventTimingDistributionGraph.cs
+++ b/osu.Game/Screens/Ranking/Statistics/HitEventTimingDistributionGraph.cs
@@ -211,7 +211,7 @@ namespace osu.Game.Screens.Ranking.Statistics
             private readonly float maxValue;
 
             private readonly Circle boxOriginal;
-            private readonly Circle boxAdjustment;
+            private Circle boxAdjustment;
 
             private const float minimum_height = 0.05f;
 
@@ -233,16 +233,6 @@ namespace osu.Game.Screens.Ranking.Statistics
                         Colour = isCentre ? Color4.White : Color4Extensions.FromHex("#66FFCC"),
                         Height = minimum_height,
                     },
-                    boxAdjustment = new Circle
-                    {
-                        RelativeSizeAxes = Axes.Both,
-                        Anchor = Anchor.BottomCentre,
-                        Origin = Anchor.BottomCentre,
-                        Colour = Color4.Yellow,
-                        Blending = BlendingParameters.Additive,
-                        Alpha = 0.6f,
-                        Height = 0,
-                    },
                 };
             }
 
@@ -260,6 +250,20 @@ namespace osu.Game.Screens.Ranking.Statistics
 
             public void UpdateOffset(float adjustment)
             {
+                if (boxAdjustment == null)
+                {
+                    AddInternal(boxAdjustment = new Circle
+                    {
+                        RelativeSizeAxes = Axes.Both,
+                        Anchor = Anchor.BottomCentre,
+                        Origin = Anchor.BottomCentre,
+                        Colour = Color4.Yellow,
+                        Blending = BlendingParameters.Additive,
+                        Alpha = 0.6f,
+                        Height = 0,
+                    });
+                }
+
                 boxAdjustment.ResizeHeightTo(Math.Clamp(adjustment / maxValue, 0.05f, 1), duration, Easing.OutQuint);
             }
         }

From e9e92b991e0de0921e0b040be63813c951911dae Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 4 Mar 2022 12:55:35 +0900
Subject: [PATCH 3231/5547] Fix calibrating offset from previous non-zero
 offset not applying adjustment correctly

---
 .../Gameplay/TestSceneBeatmapOffsetControl.cs | 30 ++++++++++++++++++-
 .../PlayerSettings/BeatmapOffsetControl.cs    |  6 ++--
 2 files changed, 33 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneBeatmapOffsetControl.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneBeatmapOffsetControl.cs
index 67f5db548b..4b079cbb2c 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneBeatmapOffsetControl.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneBeatmapOffsetControl.cs
@@ -48,7 +48,7 @@ namespace osu.Game.Tests.Visual.Gameplay
         }
 
         [Test]
-        public void TestDisplay()
+        public void TestCalibrationFromZero()
         {
             const double average_error = -4.5;
 
@@ -70,5 +70,33 @@ namespace osu.Game.Tests.Visual.Gameplay
             AddStep("Remove reference score", () => offsetControl.ReferenceScore.Value = null);
             AddAssert("No calibration button", () => !offsetControl.ChildrenOfType<SettingsButton>().Any());
         }
+
+        /// <summary>
+        /// When a beatmap offset was already set, the calibration should take it into account.
+        /// </summary>
+        [Test]
+        public void TestCalibrationFromNonZero()
+        {
+            const double average_error = -4.5;
+            const double initial_offset = -2;
+
+            AddStep("Set offset non-neutral", () => offsetControl.Current.Value = initial_offset);
+            AddAssert("No calibration button", () => !offsetControl.ChildrenOfType<SettingsButton>().Any());
+            AddStep("Set reference score", () =>
+            {
+                offsetControl.ReferenceScore.Value = new ScoreInfo
+                {
+                    HitEvents = TestSceneHitEventTimingDistributionGraph.CreateDistributedHitEvents(average_error)
+                };
+            });
+
+            AddAssert("Has calibration button", () => offsetControl.ChildrenOfType<SettingsButton>().Any());
+            AddStep("Press button", () => offsetControl.ChildrenOfType<SettingsButton>().Single().TriggerClick());
+            AddAssert("Offset is adjusted", () => offsetControl.Current.Value == initial_offset - average_error);
+
+            AddAssert("Button is disabled", () => !offsetControl.ChildrenOfType<SettingsButton>().Single().Enabled.Value);
+            AddStep("Remove reference score", () => offsetControl.ReferenceScore.Value = null);
+            AddAssert("No calibration button", () => !offsetControl.ChildrenOfType<SettingsButton>().Any());
+        }
     }
 }
diff --git a/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs b/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
index dc3e80d695..fc5c50f32f 100644
--- a/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
+++ b/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
@@ -51,6 +51,7 @@ namespace osu.Game.Screens.Play.PlayerSettings
         private OsuColour colours { get; set; } = null!;
 
         private double lastPlayAverage;
+        private double lastPlayBeatmapOffset;
 
         private SettingsButton? useAverageButton;
 
@@ -130,7 +131,7 @@ namespace osu.Game.Screens.Play.PlayerSettings
                 }
 
                 if (useAverageButton != null)
-                    useAverageButton.Enabled.Value = !Precision.AlmostEquals(lastPlayAverage, -Current.Value, Current.Precision / 2);
+                    useAverageButton.Enabled.Value = !Precision.AlmostEquals(lastPlayAverage, -Current.Value + lastPlayBeatmapOffset, Current.Precision / 2);
 
                 realmWriteTask = realm.WriteAsync(r =>
                 {
@@ -187,6 +188,7 @@ namespace osu.Game.Screens.Play.PlayerSettings
             }
 
             lastPlayAverage = average;
+            lastPlayBeatmapOffset = Current.Value;
 
             referenceScoreContainer.AddRange(new Drawable[]
             {
@@ -199,7 +201,7 @@ namespace osu.Game.Screens.Play.PlayerSettings
                 useAverageButton = new SettingsButton
                 {
                     Text = BeatmapOffsetControlStrings.CalibrateUsingLastPlay,
-                    Action = () => Current.Value = -lastPlayAverage
+                    Action = () => Current.Value = lastPlayBeatmapOffset - lastPlayAverage
                 },
             });
         }

From 5a164e4520aef238009bc95d398bb04c3ccaf8b2 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 4 Mar 2022 15:19:55 +0900
Subject: [PATCH 3232/5547] Hide adjustment when no adjustment is applied

---
 .../Ranking/Statistics/HitEventTimingDistributionGraph.cs   | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/osu.Game/Screens/Ranking/Statistics/HitEventTimingDistributionGraph.cs b/osu.Game/Screens/Ranking/Statistics/HitEventTimingDistributionGraph.cs
index c823ed1f4c..bb42dda597 100644
--- a/osu.Game/Screens/Ranking/Statistics/HitEventTimingDistributionGraph.cs
+++ b/osu.Game/Screens/Ranking/Statistics/HitEventTimingDistributionGraph.cs
@@ -250,8 +250,13 @@ namespace osu.Game.Screens.Ranking.Statistics
 
             public void UpdateOffset(float adjustment)
             {
+                bool hasAdjustment = adjustment != value;
+
                 if (boxAdjustment == null)
                 {
+                    if (!hasAdjustment)
+                        return;
+
                     AddInternal(boxAdjustment = new Circle
                     {
                         RelativeSizeAxes = Axes.Both,
@@ -265,6 +270,7 @@ namespace osu.Game.Screens.Ranking.Statistics
                 }
 
                 boxAdjustment.ResizeHeightTo(Math.Clamp(adjustment / maxValue, 0.05f, 1), duration, Easing.OutQuint);
+                boxAdjustment.FadeTo(!hasAdjustment ? 0 : 1, duration, Easing.OutQuint);
             }
         }
     }

From 8491bab77c47391f0f7ee386787befcb4d5dafbf Mon Sep 17 00:00:00 2001
From: Riley Quinn <merileyquinn@gmail.com>
Date: Fri, 4 Mar 2022 00:57:13 -0600
Subject: [PATCH 3233/5547] Replace string locale with Language

---
 osu.Game/Online/API/Requests/GetWikiRequest.cs | 10 ++++++----
 osu.Game/Overlays/WikiOverlay.cs               |  4 ++--
 2 files changed, 8 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Online/API/Requests/GetWikiRequest.cs b/osu.Game/Online/API/Requests/GetWikiRequest.cs
index 248fcc03e3..09571ab0a8 100644
--- a/osu.Game/Online/API/Requests/GetWikiRequest.cs
+++ b/osu.Game/Online/API/Requests/GetWikiRequest.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.Extensions;
+using osu.Game.Localisation;
 using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Online.API.Requests
@@ -8,14 +10,14 @@ namespace osu.Game.Online.API.Requests
     public class GetWikiRequest : APIRequest<APIWikiPage>
     {
         private readonly string path;
-        private readonly string locale;
+        private readonly Language language;
 
-        public GetWikiRequest(string path, string locale = "en")
+        public GetWikiRequest(string path, Language language = Language.en)
         {
             this.path = path;
-            this.locale = locale;
+            this.language = language;
         }
 
-        protected override string Target => $"wiki/{locale}/{path}";
+        protected override string Target => $"wiki/{language.ToCultureCode()}/{path}";
     }
 }
diff --git a/osu.Game/Overlays/WikiOverlay.cs b/osu.Game/Overlays/WikiOverlay.cs
index 63191900d8..d6a379dc56 100644
--- a/osu.Game/Overlays/WikiOverlay.cs
+++ b/osu.Game/Overlays/WikiOverlay.cs
@@ -103,9 +103,9 @@ namespace osu.Game.Overlays
 
             string[] values = e.NewValue.Split('/', 2);
 
-            if (values.Length > 1 && LanguageExtensions.TryParseCultureCode(values[0], out _))
+            if (values.Length > 1 && LanguageExtensions.TryParseCultureCode(values[0], out var language))
             {
-                request = new GetWikiRequest(values[1], values[0]);
+                request = new GetWikiRequest(values[1], language);
             }
             else
             {

From 76c293b9e982650e6b9b6edb576b37e427b95089 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 4 Mar 2022 10:00:56 +0300
Subject: [PATCH 3234/5547] Fix cancellation token source recreated on every
 medal

---
 osu.Game/Overlays/Profile/Header/MedalHeaderContainer.cs | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Overlays/Profile/Header/MedalHeaderContainer.cs b/osu.Game/Overlays/Profile/Header/MedalHeaderContainer.cs
index 6333802549..9341ad63fc 100644
--- a/osu.Game/Overlays/Profile/Header/MedalHeaderContainer.cs
+++ b/osu.Game/Overlays/Profile/Header/MedalHeaderContainer.cs
@@ -68,10 +68,12 @@ namespace osu.Game.Overlays.Profile.Header
 
         private void updateDisplay(APIUser user)
         {
-            var badges = user.Badges;
+            cancellationTokenSource?.Cancel();
+            cancellationTokenSource = new CancellationTokenSource();
+
             badgeFlowContainer.Clear();
 
-            cancellationTokenSource?.Cancel();
+            var badges = user.Badges;
 
             if (badges?.Length > 0)
             {
@@ -84,7 +86,7 @@ namespace osu.Game.Overlays.Profile.Header
                     {
                         // load in stable order regardless of async load order.
                         badgeFlowContainer.Insert(displayIndex, asyncBadge);
-                    }, (cancellationTokenSource = new CancellationTokenSource()).Token);
+                    }, cancellationTokenSource.Token);
                 }
             }
             else

From 129c290ca07d3d23608615d84b0e80f3337ca96e Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 4 Mar 2022 10:01:07 +0300
Subject: [PATCH 3235/5547] Dispose cancellation token source on disposal

---
 osu.Game/Overlays/Profile/Header/MedalHeaderContainer.cs | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/osu.Game/Overlays/Profile/Header/MedalHeaderContainer.cs b/osu.Game/Overlays/Profile/Header/MedalHeaderContainer.cs
index 9341ad63fc..922f3832e4 100644
--- a/osu.Game/Overlays/Profile/Header/MedalHeaderContainer.cs
+++ b/osu.Game/Overlays/Profile/Header/MedalHeaderContainer.cs
@@ -94,5 +94,11 @@ namespace osu.Game.Overlays.Profile.Header
                 Hide();
             }
         }
+
+        protected override void Dispose(bool isDisposing)
+        {
+            cancellationTokenSource?.Cancel();
+            base.Dispose(isDisposing);
+        }
     }
 }

From 3fdc7ed9d2b80533cda71a9e4829706eab1ded51 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 4 Mar 2022 10:14:19 +0300
Subject: [PATCH 3236/5547] Remove brackets surrounding one-line statements

---
 osu.Game/Overlays/WikiOverlay.cs | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/osu.Game/Overlays/WikiOverlay.cs b/osu.Game/Overlays/WikiOverlay.cs
index d6a379dc56..4015d8e196 100644
--- a/osu.Game/Overlays/WikiOverlay.cs
+++ b/osu.Game/Overlays/WikiOverlay.cs
@@ -104,13 +104,9 @@ namespace osu.Game.Overlays
             string[] values = e.NewValue.Split('/', 2);
 
             if (values.Length > 1 && LanguageExtensions.TryParseCultureCode(values[0], out var language))
-            {
                 request = new GetWikiRequest(values[1], language);
-            }
             else
-            {
                 request = new GetWikiRequest(e.NewValue);
-            }
 
             Loading.Show();
 

From 1c40fcb79e65b31c46dbd7fb49cbde6ce2e389b1 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 4 Mar 2022 17:54:04 +0900
Subject: [PATCH 3237/5547] Reorder math to be easier to pass

Co-authored-by: Salman Ahmed <frenzibyte@gmail.com>
---
 osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs b/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
index fc5c50f32f..8253c2e38e 100644
--- a/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
+++ b/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
@@ -131,7 +131,7 @@ namespace osu.Game.Screens.Play.PlayerSettings
                 }
 
                 if (useAverageButton != null)
-                    useAverageButton.Enabled.Value = !Precision.AlmostEquals(lastPlayAverage, -Current.Value + lastPlayBeatmapOffset, Current.Precision / 2);
+                    useAverageButton.Enabled.Value = !Precision.AlmostEquals(Current.Value, lastPlayBeatmapOffset - lastPlayAverage, Current.Precision / 2);
 
                 realmWriteTask = realm.WriteAsync(r =>
                 {

From 1e246bf5608676b0ca7f2c95eae5881421bc81f6 Mon Sep 17 00:00:00 2001
From: Jamie Taylor <me@nekodex.net>
Date: Fri, 4 Mar 2022 20:14:14 +0900
Subject: [PATCH 3238/5547] Reduce 'cursor-tap' sample playback volume on
 MouseUp

---
 osu.Game/Graphics/Cursor/MenuCursor.cs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Game/Graphics/Cursor/MenuCursor.cs b/osu.Game/Graphics/Cursor/MenuCursor.cs
index 0cc751ea21..03fad00e41 100644
--- a/osu.Game/Graphics/Cursor/MenuCursor.cs
+++ b/osu.Game/Graphics/Cursor/MenuCursor.cs
@@ -140,6 +140,7 @@ namespace osu.Game.Graphics.Cursor
             // Scale to [-0.75, 0.75] so that the sample isn't fully panned left or right (sounds weird)
             channel.Balance.Value = ((activeCursor.X / DrawWidth) * 2 - 1) * 0.75;
             channel.Frequency.Value = baseFrequency - (random_range / 2f) + RNG.NextDouble(random_range);
+            channel.Volume.Value = baseFrequency;
 
             channel.Play();
         }

From 76e64f501357db6a95a472c34a5389199c459aae Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 4 Mar 2022 14:22:39 +0300
Subject: [PATCH 3239/5547] Use manual framed clock for lead-in player test
 scene

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

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneLeadIn.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneLeadIn.cs
index b195d2aa74..5a1fc1b1e5 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneLeadIn.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneLeadIn.cs
@@ -5,6 +5,7 @@ using System.Diagnostics;
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Graphics;
+using osu.Framework.Timing;
 using osu.Framework.Utils;
 using osu.Game.Beatmaps;
 using osu.Game.Graphics.Sprites;
@@ -107,7 +108,7 @@ namespace osu.Game.Tests.Visual.Gameplay
         {
             AddStep("create player", () =>
             {
-                Beatmap.Value = CreateWorkingBeatmap(beatmap, storyboard);
+                Beatmap.Value = new ClockBackedTestWorkingBeatmap(beatmap, storyboard, new FramedClock(new ManualClock { Rate = 1 }), Audio);
                 LoadScreen(player = new LeadInPlayer());
             });
 

From c132fc19e75752191dda416d38474f2bac0a94dc Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 4 Mar 2022 22:59:33 +0900
Subject: [PATCH 3240/5547] Update resources

---
 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 526ce959a6..d418dcaccf 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -51,7 +51,7 @@
     <Reference Include="Java.Interop" />
   </ItemGroup>
   <ItemGroup>
-    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.211.0" />
+    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.304.0" />
     <PackageReference Include="ppy.osu.Framework.Android" Version="2022.223.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 7dfd099df1..64785ab566 100644
--- a/osu.Game/osu.Game.csproj
+++ b/osu.Game/osu.Game.csproj
@@ -37,7 +37,7 @@
     </PackageReference>
     <PackageReference Include="Realm" Version="10.9.0" />
     <PackageReference Include="ppy.osu.Framework" Version="2022.223.0" />
-    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.211.0" />
+    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.304.0" />
     <PackageReference Include="Sentry" Version="3.14.0" />
     <PackageReference Include="SharpCompress" Version="0.30.1" />
     <PackageReference Include="NUnit" Version="3.13.2" />
diff --git a/osu.iOS.props b/osu.iOS.props
index 80600655aa..a7bffd28b5 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -62,7 +62,7 @@
   </ItemGroup>
   <ItemGroup Label="Package References">
     <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.223.0" />
-    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.211.0" />
+    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.304.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net6.0) -->
   <PropertyGroup>

From 524b8e02ef5a60ac17a030983095c46259e1d6b2 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 5 Mar 2022 22:37:36 +0900
Subject: [PATCH 3241/5547] Revert "Update all usages of
 `OsuSlider.TooltipText` overrides to instead implement `GetTooltipText`"

This reverts commit abba49fd8f8bbe15b93ace48809bc342b486488a.
---
 osu.Game.Rulesets.Mania/ManiaSettingsSubsection.cs          | 2 +-
 osu.Game/Graphics/UserInterface/OsuSliderBar.cs             | 2 +-
 osu.Game/Overlays/Settings/Sections/Audio/OffsetSettings.cs | 2 +-
 .../Overlays/Settings/Sections/Graphics/LayoutSettings.cs   | 2 +-
 osu.Game/Overlays/Settings/Sections/Input/MouseSettings.cs  | 4 +---
 osu.Game/Overlays/Settings/Sections/SizeSlider.cs           | 2 +-
 .../Settings/Sections/UserInterface/GeneralSettings.cs      | 2 +-
 .../Settings/Sections/UserInterface/SongSelectSettings.cs   | 6 ++----
 osu.Game/Rulesets/Mods/ModMuted.cs                          | 2 +-
 osu.Game/Rulesets/Mods/ModNoScope.cs                        | 2 +-
 10 files changed, 11 insertions(+), 15 deletions(-)

diff --git a/osu.Game.Rulesets.Mania/ManiaSettingsSubsection.cs b/osu.Game.Rulesets.Mania/ManiaSettingsSubsection.cs
index ae3c279d98..36fa336d0c 100644
--- a/osu.Game.Rulesets.Mania/ManiaSettingsSubsection.cs
+++ b/osu.Game.Rulesets.Mania/ManiaSettingsSubsection.cs
@@ -48,7 +48,7 @@ namespace osu.Game.Rulesets.Mania
 
         private class TimeSlider : OsuSliderBar<double>
         {
-            protected override LocalisableString GetTooltipText(double value) => $"{value:N0} ms";
+            public override LocalisableString TooltipText => Current.Value.ToString(@"N0") + "ms";
         }
     }
 }
diff --git a/osu.Game/Graphics/UserInterface/OsuSliderBar.cs b/osu.Game/Graphics/UserInterface/OsuSliderBar.cs
index 747a56f636..a5bc02246d 100644
--- a/osu.Game/Graphics/UserInterface/OsuSliderBar.cs
+++ b/osu.Game/Graphics/UserInterface/OsuSliderBar.cs
@@ -40,7 +40,7 @@ namespace osu.Game.Graphics.UserInterface
         private readonly Box rightBox;
         private readonly Container nubContainer;
 
-        public LocalisableString TooltipText { get; private set; }
+        public virtual LocalisableString TooltipText { get; private set; }
 
         /// <summary>
         /// Whether to format the tooltip as a percentage or the actual value.
diff --git a/osu.Game/Overlays/Settings/Sections/Audio/OffsetSettings.cs b/osu.Game/Overlays/Settings/Sections/Audio/OffsetSettings.cs
index 1aaee5b540..9345d3fcc7 100644
--- a/osu.Game/Overlays/Settings/Sections/Audio/OffsetSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Audio/OffsetSettings.cs
@@ -38,7 +38,7 @@ namespace osu.Game.Overlays.Settings.Sections.Audio
 
         private class OffsetSlider : OsuSliderBar<double>
         {
-            protected override LocalisableString GetTooltipText(double value) => value.ToString(@"0ms");
+            public override LocalisableString TooltipText => Current.Value.ToString(@"0ms");
         }
     }
 }
diff --git a/osu.Game/Overlays/Settings/Sections/Graphics/LayoutSettings.cs b/osu.Game/Overlays/Settings/Sections/Graphics/LayoutSettings.cs
index b572f1c6a0..adf1453d1a 100644
--- a/osu.Game/Overlays/Settings/Sections/Graphics/LayoutSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Graphics/LayoutSettings.cs
@@ -240,7 +240,7 @@ namespace osu.Game.Overlays.Settings.Sections.Graphics
 
         private class UIScaleSlider : OsuSliderBar<float>
         {
-            protected override LocalisableString GetTooltipText(float value) => $"{base.GetTooltipText(value)}x";
+            public override LocalisableString TooltipText => base.TooltipText + "x";
         }
 
         private class ResolutionSettingsDropdown : SettingsDropdown<Size>
diff --git a/osu.Game/Overlays/Settings/Sections/Input/MouseSettings.cs b/osu.Game/Overlays/Settings/Sections/Input/MouseSettings.cs
index 971b19ca6c..4235dc0a05 100644
--- a/osu.Game/Overlays/Settings/Sections/Input/MouseSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Input/MouseSettings.cs
@@ -135,9 +135,7 @@ namespace osu.Game.Overlays.Settings.Sections.Input
 
         private class SensitivitySlider : OsuSliderBar<double>
         {
-            protected override LocalisableString GetTooltipText(double value) => Current.Disabled
-                ? MouseSettingsStrings.EnableHighPrecisionForSensitivityAdjust
-                : $"{base.GetTooltipText(value)}x";
+            public override LocalisableString TooltipText => Current.Disabled ? MouseSettingsStrings.EnableHighPrecisionForSensitivityAdjust : $"{base.TooltipText}x";
         }
     }
 }
diff --git a/osu.Game/Overlays/Settings/Sections/SizeSlider.cs b/osu.Game/Overlays/Settings/Sections/SizeSlider.cs
index c80b330db6..8aeb440be1 100644
--- a/osu.Game/Overlays/Settings/Sections/SizeSlider.cs
+++ b/osu.Game/Overlays/Settings/Sections/SizeSlider.cs
@@ -11,6 +11,6 @@ namespace osu.Game.Overlays.Settings.Sections
     /// </summary>
     internal class SizeSlider : OsuSliderBar<float>
     {
-        protected override LocalisableString GetTooltipText(float value) => value.ToString(@"0.##x");
+        public override LocalisableString TooltipText => Current.Value.ToString(@"0.##x");
     }
 }
diff --git a/osu.Game/Overlays/Settings/Sections/UserInterface/GeneralSettings.cs b/osu.Game/Overlays/Settings/Sections/UserInterface/GeneralSettings.cs
index ca59095875..0afbed5df5 100644
--- a/osu.Game/Overlays/Settings/Sections/UserInterface/GeneralSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/UserInterface/GeneralSettings.cs
@@ -46,7 +46,7 @@ namespace osu.Game.Overlays.Settings.Sections.UserInterface
 
         private class TimeSlider : OsuSliderBar<float>
         {
-            protected override LocalisableString GetTooltipText(float value) => $"{value:N0} ms";
+            public override LocalisableString TooltipText => Current.Value.ToString(@"N0") + "ms";
         }
     }
 }
diff --git a/osu.Game/Overlays/Settings/Sections/UserInterface/SongSelectSettings.cs b/osu.Game/Overlays/Settings/Sections/UserInterface/SongSelectSettings.cs
index c24513e7b4..6290046987 100644
--- a/osu.Game/Overlays/Settings/Sections/UserInterface/SongSelectSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/UserInterface/SongSelectSettings.cs
@@ -64,14 +64,12 @@ namespace osu.Game.Overlays.Settings.Sections.UserInterface
 
         private class MaximumStarsSlider : StarsSlider
         {
-            protected override LocalisableString GetTooltipText(double value) => Current.IsDefault
-                ? UserInterfaceStrings.NoLimit
-                : base.GetTooltipText(value);
+            public override LocalisableString TooltipText => Current.IsDefault ? UserInterfaceStrings.NoLimit : base.TooltipText;
         }
 
         private class StarsSlider : OsuSliderBar<double>
         {
-            protected override LocalisableString GetTooltipText(double value) => $"{value:0.##} stars";
+            public override LocalisableString TooltipText => Current.Value.ToString(@"0.## stars");
         }
     }
 }
diff --git a/osu.Game/Rulesets/Mods/ModMuted.cs b/osu.Game/Rulesets/Mods/ModMuted.cs
index e528d8214e..1d33b44812 100644
--- a/osu.Game/Rulesets/Mods/ModMuted.cs
+++ b/osu.Game/Rulesets/Mods/ModMuted.cs
@@ -111,6 +111,6 @@ namespace osu.Game.Rulesets.Mods
 
     public class MuteComboSlider : OsuSliderBar<int>
     {
-        protected override LocalisableString GetTooltipText(int value) => value == 0 ? "always muted" : base.GetTooltipText(value);
+        public override LocalisableString TooltipText => Current.Value == 0 ? "always muted" : base.TooltipText;
     }
 }
diff --git a/osu.Game/Rulesets/Mods/ModNoScope.cs b/osu.Game/Rulesets/Mods/ModNoScope.cs
index c71239ea5a..7a935eb38f 100644
--- a/osu.Game/Rulesets/Mods/ModNoScope.cs
+++ b/osu.Game/Rulesets/Mods/ModNoScope.cs
@@ -57,6 +57,6 @@ namespace osu.Game.Rulesets.Mods
 
     public class HiddenComboSlider : OsuSliderBar<int>
     {
-        protected override LocalisableString GetTooltipText(int value) => value == 0 ? "always hidden" : base.GetTooltipText(value);
+        public override LocalisableString TooltipText => Current.Value == 0 ? "always hidden" : base.TooltipText;
     }
 }

From 1e34aca984061824993b490cd2b4b70e4242af5d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 5 Mar 2022 14:38:15 +0100
Subject: [PATCH 3242/5547] Rename method to better fit purpose

---
 .../Overlays/Settings/Sections/Graphics/LayoutSettings.cs   | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Overlays/Settings/Sections/Graphics/LayoutSettings.cs b/osu.Game/Overlays/Settings/Sections/Graphics/LayoutSettings.cs
index a1688b87cc..602ace6dea 100644
--- a/osu.Game/Overlays/Settings/Sections/Graphics/LayoutSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Graphics/LayoutSettings.cs
@@ -149,7 +149,7 @@ namespace osu.Game.Overlays.Settings.Sections.Graphics
 
             windowModeDropdown.Current.BindValueChanged(mode =>
             {
-                updateFullscreenDropdowns();
+                updateDisplayModeDropdowns();
 
                 windowModeDropdown.WarningText = mode.NewValue != WindowMode.Fullscreen ? GraphicsSettingsStrings.NotFullscreenNote : default;
             }, true);
@@ -175,7 +175,7 @@ namespace osu.Game.Overlays.Settings.Sections.Graphics
                                                 .Distinct());
                 }
 
-                updateFullscreenDropdowns();
+                updateDisplayModeDropdowns();
             }), true);
 
             scalingMode.BindValueChanged(mode =>
@@ -190,7 +190,7 @@ namespace osu.Game.Overlays.Settings.Sections.Graphics
             // initial update bypasses transforms
             updateScalingModeVisibility();
 
-            void updateFullscreenDropdowns()
+            void updateDisplayModeDropdowns()
             {
                 if (resolutions.Count > 1 && windowModeDropdown.Current.Value == WindowMode.Fullscreen)
                     resolutionDropdown.Show();

From ce51ce49cf1cf4cf109ec92a180314af93d41d63 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 5 Mar 2022 22:46:13 +0900
Subject: [PATCH 3243/5547] Revert changes to `GetTooltipText` and use
 `TooltipText` override directly

---
 osu.Game/Graphics/UserInterface/OsuSliderBar.cs        |  6 +++---
 .../Play/PlayerSettings/BeatmapOffsetControl.cs        | 10 ++++------
 2 files changed, 7 insertions(+), 9 deletions(-)

diff --git a/osu.Game/Graphics/UserInterface/OsuSliderBar.cs b/osu.Game/Graphics/UserInterface/OsuSliderBar.cs
index a5bc02246d..21c8dfcfa4 100644
--- a/osu.Game/Graphics/UserInterface/OsuSliderBar.cs
+++ b/osu.Game/Graphics/UserInterface/OsuSliderBar.cs
@@ -148,7 +148,7 @@ namespace osu.Game.Graphics.UserInterface
         protected override void LoadComplete()
         {
             base.LoadComplete();
-            CurrentNumber.BindValueChanged(current => TooltipText = GetTooltipText(current.NewValue), true);
+            CurrentNumber.BindValueChanged(current => TooltipText = getTooltipText(current.NewValue), true);
         }
 
         protected override bool OnHover(HoverEvent e)
@@ -178,7 +178,7 @@ namespace osu.Game.Graphics.UserInterface
         {
             base.OnUserChange(value);
             playSample(value);
-            TooltipText = GetTooltipText(value);
+            TooltipText = getTooltipText(value);
         }
 
         private void playSample(T value)
@@ -203,7 +203,7 @@ namespace osu.Game.Graphics.UserInterface
             channel.Play();
         }
 
-        protected virtual LocalisableString GetTooltipText(T value)
+        private LocalisableString getTooltipText(T value)
         {
             if (CurrentNumber.IsInteger)
                 return value.ToInt32(NumberFormatInfo.InvariantInfo).ToString("N0");
diff --git a/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs b/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
index 2e14480e2b..bb8dcf566d 100644
--- a/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
+++ b/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
@@ -97,12 +97,10 @@ namespace osu.Game.Screens.Play.PlayerSettings
 
             protected class CustomSliderBar : SliderBar
             {
-                protected override LocalisableString GetTooltipText(double value)
-                {
-                    return value == 0
-                        ? new TranslatableString("_", @"{0} ms", base.GetTooltipText(value))
-                        : new TranslatableString("_", @"{0} ms {1}", base.GetTooltipText(value), getEarlyLateText(value));
-                }
+                public override LocalisableString TooltipText =>
+                    Current.Value == 0
+                        ? new TranslatableString("_", @"{0} ms", base.TooltipText)
+                        : new TranslatableString("_", @"{0} ms {1}", base.TooltipText, getEarlyLateText(Current.Value));
 
                 private LocalisableString getEarlyLateText(double value)
                 {

From 8b8b54b58ffc2f82c22e775cffc855964c1d77e3 Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Sat, 5 Mar 2022 21:48:57 +0800
Subject: [PATCH 3244/5547] Scale rate adjustments based on hit timing
 consistency and tweak some related numbers

---
 osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs | 29 ++++++++++++++++++----
 1 file changed, 24 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs b/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs
index e7ca1d3150..1115b95e6f 100644
--- a/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs
+++ b/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs
@@ -70,8 +70,8 @@ namespace osu.Game.Rulesets.Mods
 
         // The two constants below denote the maximum allowable change in rate caused by a single hit
         // This prevents sudden jolts caused by a badly-timed hit.
-        private const double min_allowable_rate_change = 0.8d;
-        private const double max_allowable_rate_change = 1.25d;
+        private const double min_allowable_rate_change = 0.9d;
+        private const double max_allowable_rate_change = 1.11d;
 
         // Apply a fixed rate change when missing, allowing the player to catch up when the rate is too fast.
         private const double rate_change_on_miss = 0.95d;
@@ -83,7 +83,7 @@ namespace osu.Game.Rulesets.Mods
         /// The number of most recent track rates (approximated from how early/late each object was hit relative to the previous object)
         /// which should be averaged to calculate <see cref="targetRate"/>.
         /// </summary>
-        private const int recent_rate_count = 6;
+        private const int recent_rate_count = 8;
 
         /// <summary>
         /// Stores the most recent <see cref="recent_rate_count"/> approximated track rates
@@ -172,7 +172,7 @@ namespace osu.Game.Rulesets.Mods
 
                 recentRates.Add(Math.Clamp(getRelativeRateChange(result) * SpeedChange.Value, min_allowable_rate, max_allowable_rate));
 
-                targetRate = recentRates.Average();
+                updateTargetRate();
             };
             drawable.OnRevertResult += (o, result) =>
             {
@@ -184,7 +184,7 @@ namespace osu.Game.Rulesets.Mods
 
                 recentRates.RemoveAt(recentRates.Count - 1);
 
-                targetRate = recentRates.Average();
+                updateTargetRate();
             };
         }
 
@@ -246,5 +246,24 @@ namespace osu.Game.Rulesets.Mods
                 max_allowable_rate_change
             );
         }
+
+        /// <summary>
+        /// Update <see cref="targetRate"/> based on the values in <see cref="recentRates"/>.
+        /// </summary>
+        private void updateTargetRate()
+        {
+            // Compare values in recentRates to see how consistent the player's speed is
+            // If the player hits half of the notes too fast and the other half too slow:  Abs(consistency) = 0
+            // If the player hits all their notes too fast or too slow:                    Abs(consistency) = recent_rate_count - 1
+            int consistency = 0;
+
+            for (int i = 1; i < recentRates.Count; i++)
+            {
+                consistency += Math.Sign(recentRates[i] - recentRates[i - 1]);
+            }
+
+            // Scale the rate adjustment based on consistency
+            targetRate = Interpolation.Lerp(targetRate, recentRates.Average(), Math.Abs(consistency) / (recent_rate_count - 1d));
+        }
     }
 }

From 08b3bc222d79a8d2a846ee11c1e300832d91a9d6 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 5 Mar 2022 16:42:51 +0100
Subject: [PATCH 3245/5547] Revert "Fix potential crash in tests when
 attempting to lookup key bindings in cases the lookup is not available"

This reverts commit 8115a4bb8fd9e2d53c40b8607c7ad99f0f62e9a0.

Commit was cherrypicked out to a separate pull on a different merge
base, then reverted in that pull, so it should be reverted here too.
---
 osu.Game/Configuration/DevelopmentOsuConfigManager.cs | 2 --
 1 file changed, 2 deletions(-)

diff --git a/osu.Game/Configuration/DevelopmentOsuConfigManager.cs b/osu.Game/Configuration/DevelopmentOsuConfigManager.cs
index f1cb0731fe..ff19dd874c 100644
--- a/osu.Game/Configuration/DevelopmentOsuConfigManager.cs
+++ b/osu.Game/Configuration/DevelopmentOsuConfigManager.cs
@@ -14,8 +14,6 @@ namespace osu.Game.Configuration
         public DevelopmentOsuConfigManager(Storage storage)
             : base(storage)
         {
-            LookupKeyBindings = _ => "unknown";
-            LookupSkinName = _ => "unknown";
         }
     }
 }

From f8ef352306a133d935bd9c441a6419de62a5d825 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 6 Mar 2022 01:00:47 +0900
Subject: [PATCH 3246/5547] Don't consider judgements beneath the minimum
 height as being applicable
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>
---
 .../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 bb42dda597..61b0cff8dd 100644
--- a/osu.Game/Screens/Ranking/Statistics/HitEventTimingDistributionGraph.cs
+++ b/osu.Game/Screens/Ranking/Statistics/HitEventTimingDistributionGraph.cs
@@ -250,7 +250,7 @@ namespace osu.Game.Screens.Ranking.Statistics
 
             public void UpdateOffset(float adjustment)
             {
-                bool hasAdjustment = adjustment != value;
+                bool hasAdjustment = adjustment != value && adjustment / maxValue >= minimum_height;
 
                 if (boxAdjustment == null)
                 {

From 06512e8bd90d96ee62daa1866841e73499608505 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 6 Mar 2022 01:01:22 +0900
Subject: [PATCH 3247/5547] Use `const` for minimum height specification in
 final usage location
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>
---
 .../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 61b0cff8dd..f7c9d36cc4 100644
--- a/osu.Game/Screens/Ranking/Statistics/HitEventTimingDistributionGraph.cs
+++ b/osu.Game/Screens/Ranking/Statistics/HitEventTimingDistributionGraph.cs
@@ -269,7 +269,7 @@ namespace osu.Game.Screens.Ranking.Statistics
                     });
                 }
 
-                boxAdjustment.ResizeHeightTo(Math.Clamp(adjustment / maxValue, 0.05f, 1), duration, Easing.OutQuint);
+                boxAdjustment.ResizeHeightTo(Math.Clamp(adjustment / maxValue, minimum_height, 1), duration, Easing.OutQuint);
                 boxAdjustment.FadeTo(!hasAdjustment ? 0 : 1, duration, Easing.OutQuint);
             }
         }

From 0e8ad4b143785b571206729846856a1512c2e4e5 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 6 Mar 2022 01:50:25 +0900
Subject: [PATCH 3248/5547] Switch step to `Until` steps due to `AddOnce`
 firing logic

---
 .../Visual/Gameplay/TestSceneBeatmapOffsetControl.cs      | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneBeatmapOffsetControl.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneBeatmapOffsetControl.cs
index 4b079cbb2c..8ca49837da 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneBeatmapOffsetControl.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneBeatmapOffsetControl.cs
@@ -62,11 +62,11 @@ namespace osu.Game.Tests.Visual.Gameplay
                 };
             });
 
-            AddAssert("Has calibration button", () => offsetControl.ChildrenOfType<SettingsButton>().Any());
+            AddUntilStep("Has calibration button", () => offsetControl.ChildrenOfType<SettingsButton>().Any());
             AddStep("Press button", () => offsetControl.ChildrenOfType<SettingsButton>().Single().TriggerClick());
             AddAssert("Offset is adjusted", () => offsetControl.Current.Value == -average_error);
 
-            AddAssert("Button is disabled", () => !offsetControl.ChildrenOfType<SettingsButton>().Single().Enabled.Value);
+            AddUntilStep("Button is disabled", () => !offsetControl.ChildrenOfType<SettingsButton>().Single().Enabled.Value);
             AddStep("Remove reference score", () => offsetControl.ReferenceScore.Value = null);
             AddAssert("No calibration button", () => !offsetControl.ChildrenOfType<SettingsButton>().Any());
         }
@@ -90,11 +90,11 @@ namespace osu.Game.Tests.Visual.Gameplay
                 };
             });
 
-            AddAssert("Has calibration button", () => offsetControl.ChildrenOfType<SettingsButton>().Any());
+            AddUntilStep("Has calibration button", () => offsetControl.ChildrenOfType<SettingsButton>().Any());
             AddStep("Press button", () => offsetControl.ChildrenOfType<SettingsButton>().Single().TriggerClick());
             AddAssert("Offset is adjusted", () => offsetControl.Current.Value == initial_offset - average_error);
 
-            AddAssert("Button is disabled", () => !offsetControl.ChildrenOfType<SettingsButton>().Single().Enabled.Value);
+            AddUntilStep("Button is disabled", () => !offsetControl.ChildrenOfType<SettingsButton>().Single().Enabled.Value);
             AddStep("Remove reference score", () => offsetControl.ReferenceScore.Value = null);
             AddAssert("No calibration button", () => !offsetControl.ChildrenOfType<SettingsButton>().Any());
         }

From 5b3ffb12b7c978f4ec1a4c8de8f346b854a5b9d3 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 4 Mar 2022 23:23:58 +0300
Subject: [PATCH 3249/5547] Refactor channel scrolling container to handle
 manual scrolls resiliently

---
 .../Online/TestSceneStandAloneChatDisplay.cs  | 27 ++++++++++++++++---
 .../Containers/UserTrackingScrollContainer.cs | 21 ++++++++++-----
 osu.Game/Overlays/Chat/DrawableChannel.cs     | 19 ++++++-------
 3 files changed, 49 insertions(+), 18 deletions(-)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneStandAloneChatDisplay.cs b/osu.Game.Tests/Visual/Online/TestSceneStandAloneChatDisplay.cs
index 779d72190d..9b9ee0e084 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneStandAloneChatDisplay.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneStandAloneChatDisplay.cs
@@ -207,7 +207,28 @@ namespace osu.Game.Tests.Visual.Online
         }
 
         [Test]
-        public void TestUserScrollOverride()
+        public void TestOverrideChatScrolling()
+        {
+            fillChat();
+
+            sendMessage();
+            checkScrolledToBottom();
+
+            AddStep("Scroll to start", () => chatDisplay.ScrollContainer.ScrollToStart());
+
+            checkNotScrolledToBottom();
+            sendMessage();
+            checkNotScrolledToBottom();
+
+            AddStep("Scroll to bottom", () => chatDisplay.ScrollContainer.ScrollToEnd());
+
+            checkScrolledToBottom();
+            sendMessage();
+            checkScrolledToBottom();
+        }
+
+        [Test]
+        public void TestOverrideChatScrollingByUser()
         {
             fillChat();
 
@@ -314,9 +335,9 @@ namespace osu.Game.Tests.Visual.Online
             {
             }
 
-            protected DrawableChannel DrawableChannel => InternalChildren.OfType<DrawableChannel>().First();
+            public DrawableChannel DrawableChannel => InternalChildren.OfType<DrawableChannel>().First();
 
-            protected UserTrackingScrollContainer ScrollContainer => (UserTrackingScrollContainer)((Container)DrawableChannel.Child).Child;
+            public UserTrackingScrollContainer ScrollContainer => (UserTrackingScrollContainer)((Container)DrawableChannel.Child).Child;
 
             public FillFlowContainer FillFlow => (FillFlowContainer)ScrollContainer.Child;
 
diff --git a/osu.Game/Graphics/Containers/UserTrackingScrollContainer.cs b/osu.Game/Graphics/Containers/UserTrackingScrollContainer.cs
index 0561051e35..988695c380 100644
--- a/osu.Game/Graphics/Containers/UserTrackingScrollContainer.cs
+++ b/osu.Game/Graphics/Containers/UserTrackingScrollContainer.cs
@@ -25,8 +25,6 @@ namespace osu.Game.Graphics.Containers
         /// </summary>
         public bool UserScrolling { get; private set; }
 
-        public void CancelUserScroll() => UserScrolling = false;
-
         public UserTrackingScrollContainer()
         {
         }
@@ -38,26 +36,37 @@ namespace osu.Game.Graphics.Containers
 
         protected override void OnUserScroll(float value, bool animated = true, double? distanceDecay = default)
         {
-            UserScrolling = true;
             base.OnUserScroll(value, animated, distanceDecay);
+            OnScrollChange(true);
         }
 
         public new void ScrollIntoView(Drawable target, bool animated = true)
         {
-            UserScrolling = false;
             base.ScrollIntoView(target, animated);
+            OnScrollChange(false);
         }
 
         public new void ScrollTo(float value, bool animated = true, double? distanceDecay = null)
         {
-            UserScrolling = false;
             base.ScrollTo(value, animated, distanceDecay);
+            OnScrollChange(false);
+        }
+
+        public new void ScrollToStart(bool animated = true, bool allowDuringDrag = false)
+        {
+            base.ScrollToStart(animated, allowDuringDrag);
+            OnScrollChange(false);
         }
 
         public new void ScrollToEnd(bool animated = true, bool allowDuringDrag = false)
         {
-            UserScrolling = false;
             base.ScrollToEnd(animated, allowDuringDrag);
+            OnScrollChange(false);
         }
+
+        /// <summary>
+        /// Invoked when any scroll has been performed either automatically or by user.
+        /// </summary>
+        protected virtual void OnScrollChange(bool byUser) => UserScrolling = byUser;
     }
 }
diff --git a/osu.Game/Overlays/Chat/DrawableChannel.cs b/osu.Game/Overlays/Chat/DrawableChannel.cs
index 41e70bbfae..ccad55b809 100644
--- a/osu.Game/Overlays/Chat/DrawableChannel.cs
+++ b/osu.Game/Overlays/Chat/DrawableChannel.cs
@@ -249,31 +249,32 @@ namespace osu.Game.Overlays.Chat
             /// </summary>
             private const float auto_scroll_leniency = 10f;
 
+            private bool trackNewContent = true;
             private float? lastExtent;
 
-            protected override void OnUserScroll(float value, bool animated = true, double? distanceDecay = default)
+            protected override void OnScrollChange(bool byUser)
             {
-                base.OnUserScroll(value, animated, distanceDecay);
-                lastExtent = null;
+                base.OnScrollChange(byUser);
+
+                if (byUser)
+                    lastExtent = null;
+
+                trackNewContent = IsScrolledToEnd(auto_scroll_leniency);
             }
 
             protected override void Update()
             {
                 base.Update();
 
-                // If the user has scrolled to the bottom of the container, we should resume tracking new content.
-                if (UserScrolling && IsScrolledToEnd(auto_scroll_leniency))
-                    CancelUserScroll();
-
                 // If the user hasn't overridden our behaviour and there has been new content added to the container, we should update our scroll position to track it.
-                bool requiresScrollUpdate = !UserScrolling && (lastExtent == null || Precision.AlmostBigger(ScrollableExtent, lastExtent.Value));
+                bool requiresScrollUpdate = trackNewContent && (lastExtent == null || Precision.AlmostBigger(ScrollableExtent, lastExtent.Value));
 
                 if (requiresScrollUpdate)
                 {
                     // Schedule required to allow FillFlow to be the correct size.
                     Schedule(() =>
                     {
-                        if (!UserScrolling)
+                        if (trackNewContent)
                         {
                             if (Current < ScrollableExtent)
                                 ScrollToEnd();

From 634821e49f4485882539534e6e1df7fdb0259f1f Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sun, 6 Mar 2022 00:01:45 +0300
Subject: [PATCH 3250/5547] Use the term "programmatically" instead

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

diff --git a/osu.Game/Graphics/Containers/UserTrackingScrollContainer.cs b/osu.Game/Graphics/Containers/UserTrackingScrollContainer.cs
index 988695c380..887aeb0c54 100644
--- a/osu.Game/Graphics/Containers/UserTrackingScrollContainer.cs
+++ b/osu.Game/Graphics/Containers/UserTrackingScrollContainer.cs
@@ -65,7 +65,7 @@ namespace osu.Game.Graphics.Containers
         }
 
         /// <summary>
-        /// Invoked when any scroll has been performed either automatically or by user.
+        /// Invoked when any scroll has been performed either programmatically or by user.
         /// </summary>
         protected virtual void OnScrollChange(bool byUser) => UserScrolling = byUser;
     }

From e1eeb9c6bbaead86f6ce482a69700d6e3ec2144a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 6 Mar 2022 01:43:56 +0100
Subject: [PATCH 3251/5547] Allow tabbing between textboxes in sample point
 popover

---
 osu.Game/Graphics/UserInterfaceV2/LabelledTextBox.cs       | 2 +-
 .../Edit/Compose/Components/Timeline/SamplePointPiece.cs   | 7 ++++++-
 .../Edit/Timing/IndeterminateSliderWithTextBoxInput.cs     | 5 +++++
 3 files changed, 12 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Graphics/UserInterfaceV2/LabelledTextBox.cs b/osu.Game/Graphics/UserInterfaceV2/LabelledTextBox.cs
index 4da8d6a554..fd64cc2056 100644
--- a/osu.Game/Graphics/UserInterfaceV2/LabelledTextBox.cs
+++ b/osu.Game/Graphics/UserInterfaceV2/LabelledTextBox.cs
@@ -35,7 +35,7 @@ namespace osu.Game.Graphics.UserInterfaceV2
             set => Component.Text = value;
         }
 
-        public Container TabbableContentContainer
+        public CompositeDrawable TabbableContentContainer
         {
             set => Component.TabbableContentContainer = value;
         }
diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/SamplePointPiece.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/SamplePointPiece.cs
index 7d52645aa1..fc0952d4f0 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/SamplePointPiece.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/SamplePointPiece.cs
@@ -75,9 +75,11 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
             [BackgroundDependencyLoader]
             private void load()
             {
+                FillFlowContainer flow;
+
                 Children = new Drawable[]
                 {
-                    new FillFlowContainer
+                    flow = new FillFlowContainer
                     {
                         Width = 200,
                         Direction = FillDirection.Vertical,
@@ -94,6 +96,9 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
                     }
                 };
 
+                bank.TabbableContentContainer = flow;
+                volume.TabbableContentContainer = flow;
+
                 // if the piece belongs to a currently selected object, assume that the user wants to change all selected objects.
                 // if the piece belongs to an unselected object, operate on that object alone, independently of the selection.
                 var relevantObjects = (beatmap.SelectedHitObjects.Contains(hitObject) ? beatmap.SelectedHitObjects : hitObject.Yield()).ToArray();
diff --git a/osu.Game/Screens/Edit/Timing/IndeterminateSliderWithTextBoxInput.cs b/osu.Game/Screens/Edit/Timing/IndeterminateSliderWithTextBoxInput.cs
index e25d83cfb0..0cf2cf6c54 100644
--- a/osu.Game/Screens/Edit/Timing/IndeterminateSliderWithTextBoxInput.cs
+++ b/osu.Game/Screens/Edit/Timing/IndeterminateSliderWithTextBoxInput.cs
@@ -32,6 +32,11 @@ namespace osu.Game.Screens.Edit.Timing
             set => slider.KeyboardStep = value;
         }
 
+        public CompositeDrawable TabbableContentContainer
+        {
+            set => textBox.TabbableContentContainer = value;
+        }
+
         private readonly BindableWithCurrent<T?> current = new BindableWithCurrent<T?>();
 
         public Bindable<T?> Current

From df0617f34c33a31050c94cd113dd94819d064ff3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 20 Feb 2022 15:03:21 +0100
Subject: [PATCH 3252/5547] Implement popup screen title component

---
 .../TestScenePopupScreenTitle.cs              |  44 +++++
 .../UserInterface/PopupScreenTitle.cs         | 151 ++++++++++++++++++
 2 files changed, 195 insertions(+)
 create mode 100644 osu.Game.Tests/Visual/UserInterface/TestScenePopupScreenTitle.cs
 create mode 100644 osu.Game/Graphics/UserInterface/PopupScreenTitle.cs

diff --git a/osu.Game.Tests/Visual/UserInterface/TestScenePopupScreenTitle.cs b/osu.Game.Tests/Visual/UserInterface/TestScenePopupScreenTitle.cs
new file mode 100644
index 0000000000..c214c158a4
--- /dev/null
+++ b/osu.Game.Tests/Visual/UserInterface/TestScenePopupScreenTitle.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.Game.Graphics.UserInterface;
+using osu.Game.Overlays;
+
+namespace osu.Game.Tests.Visual.UserInterface
+{
+    [TestFixture]
+    public class TestScenePopupScreenTitle : OsuTestScene
+    {
+        [Cached]
+        private OverlayColourProvider colourProvider = new OverlayColourProvider(OverlayColourScheme.Green);
+
+        [Test]
+        public void TestPopupScreenTitle()
+        {
+            AddStep("create content", () =>
+            {
+                Child = new PopupScreenTitle
+                {
+                    Title = "Popup Screen Title",
+                    Description = "This is a description.",
+                    Close = () => { }
+                };
+            });
+        }
+
+        [Test]
+        public void TestDisabledExit()
+        {
+            AddStep("create content", () =>
+            {
+                Child = new PopupScreenTitle
+                {
+                    Title = "Popup Screen Title",
+                    Description = "This is a description."
+                };
+            });
+        }
+    }
+}
diff --git a/osu.Game/Graphics/UserInterface/PopupScreenTitle.cs b/osu.Game/Graphics/UserInterface/PopupScreenTitle.cs
new file mode 100644
index 0000000000..8d5aef7427
--- /dev/null
+++ b/osu.Game/Graphics/UserInterface/PopupScreenTitle.cs
@@ -0,0 +1,151 @@
+// 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 enable
+
+using System;
+using osu.Framework.Allocation;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Colour;
+using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.Effects;
+using osu.Framework.Graphics.Shapes;
+using osu.Framework.Graphics.Sprites;
+using osu.Framework.Localisation;
+using osu.Game.Graphics.Sprites;
+using osu.Game.Overlays;
+using osuTK;
+
+namespace osu.Game.Graphics.UserInterface
+{
+    public class PopupScreenTitle : CompositeDrawable
+    {
+        public LocalisableString Title
+        {
+            get => titleSpriteText.Text;
+            set => titleSpriteText.Text = value;
+        }
+
+        public LocalisableString Description
+        {
+            get => descriptionSpriteText.Text;
+            set => descriptionSpriteText.Text = value;
+        }
+
+        public Action? Close
+        {
+            get => closeButton.Action;
+            set => closeButton.Action = value;
+        }
+
+        private const float corner_radius = 14;
+        private const float main_area_height = 70;
+
+        private readonly Container underlayContainer;
+        private readonly Box underlayBackground;
+        private readonly Container contentContainer;
+        private readonly Box contentBackground;
+        private readonly OsuSpriteText titleSpriteText;
+        private readonly OsuSpriteText descriptionSpriteText;
+        private readonly IconButton closeButton;
+
+        public PopupScreenTitle()
+        {
+            RelativeSizeAxes = Axes.X;
+            AutoSizeAxes = Axes.Y;
+
+            InternalChild = new Container
+            {
+                RelativeSizeAxes = Axes.X,
+                AutoSizeAxes = Axes.Y,
+                Padding = new MarginPadding
+                {
+                    Horizontal = 70,
+                    Top = -corner_radius
+                },
+                Children = new Drawable[]
+                {
+                    underlayContainer = new Container
+                    {
+                        RelativeSizeAxes = Axes.X,
+                        Height = main_area_height + 2 * corner_radius,
+                        CornerRadius = corner_radius,
+                        Masking = true,
+                        BorderThickness = 2,
+                        Child = underlayBackground = new Box
+                        {
+                            RelativeSizeAxes = Axes.Both
+                        }
+                    },
+                    contentContainer = new Container
+                    {
+                        RelativeSizeAxes = Axes.X,
+                        Height = main_area_height + corner_radius,
+                        CornerRadius = corner_radius,
+                        Masking = true,
+                        BorderThickness = 2,
+                        EdgeEffect = new EdgeEffectParameters
+                        {
+                            Type = EdgeEffectType.Shadow,
+                            Colour = Colour4.Black.Opacity(0.1f),
+                            Offset = new Vector2(0, 1),
+                            Radius = 3
+                        },
+                        Children = new Drawable[]
+                        {
+                            contentBackground = new Box
+                            {
+                                RelativeSizeAxes = Axes.Both
+                            },
+                            new FillFlowContainer
+                            {
+                                RelativeSizeAxes = Axes.X,
+                                AutoSizeAxes = Axes.Y,
+                                Direction = FillDirection.Vertical,
+                                Anchor = Anchor.CentreLeft,
+                                Origin = Anchor.CentreLeft,
+                                Margin = new MarginPadding { Top = corner_radius },
+                                Padding = new MarginPadding { Horizontal = 100 },
+                                Children = new Drawable[]
+                                {
+                                    titleSpriteText = new OsuSpriteText
+                                    {
+                                        Font = OsuFont.TorusAlternate.With(size: 20)
+                                    },
+                                    descriptionSpriteText = new OsuSpriteText
+                                    {
+                                        Font = OsuFont.Default.With(size: 12)
+                                    }
+                                }
+                            },
+                            closeButton = new IconButton
+                            {
+                                Icon = FontAwesome.Solid.Times,
+                                Scale = new Vector2(0.6f),
+                                Anchor = Anchor.CentreRight,
+                                Origin = Anchor.CentreRight,
+                                Margin = new MarginPadding
+                                {
+                                    Right = 21,
+                                    Top = corner_radius
+                                }
+                            }
+                        }
+                    }
+                }
+            };
+        }
+
+        [BackgroundDependencyLoader]
+        private void load(OverlayColourProvider colourProvider)
+        {
+            underlayContainer.BorderColour = ColourInfo.GradientVertical(Colour4.Black, colourProvider.Dark4);
+            underlayBackground.Colour = colourProvider.Dark4;
+
+            contentContainer.BorderColour = ColourInfo.GradientVertical(colourProvider.Dark3, colourProvider.Dark1);
+            contentBackground.Colour = colourProvider.Dark3;
+
+            closeButton.IconHoverColour = colourProvider.Highlight1;
+        }
+    }
+}

From 54275813b57e88d8709d1fbf1c3e33d329ed7cb7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 20 Feb 2022 18:10:30 +0100
Subject: [PATCH 3253/5547] Use text flow container in popup screen title

---
 .../UserInterface/TestScenePopupScreenTitle.cs    |  3 ++-
 .../Graphics/UserInterface/PopupScreenTitle.cs    | 15 +++++++++------
 2 files changed, 11 insertions(+), 7 deletions(-)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestScenePopupScreenTitle.cs b/osu.Game.Tests/Visual/UserInterface/TestScenePopupScreenTitle.cs
index c214c158a4..22a8fa8a46 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestScenePopupScreenTitle.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestScenePopupScreenTitle.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.Game.Graphics.UserInterface;
@@ -22,7 +23,7 @@ namespace osu.Game.Tests.Visual.UserInterface
                 Child = new PopupScreenTitle
                 {
                     Title = "Popup Screen Title",
-                    Description = "This is a description.",
+                    Description = string.Join(" ", Enumerable.Repeat("This is a description.", 20)),
                     Close = () => { }
                 };
             });
diff --git a/osu.Game/Graphics/UserInterface/PopupScreenTitle.cs b/osu.Game/Graphics/UserInterface/PopupScreenTitle.cs
index 8d5aef7427..5b7db09e77 100644
--- a/osu.Game/Graphics/UserInterface/PopupScreenTitle.cs
+++ b/osu.Game/Graphics/UserInterface/PopupScreenTitle.cs
@@ -12,6 +12,7 @@ using osu.Framework.Graphics.Effects;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Localisation;
+using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Overlays;
 using osuTK;
@@ -22,14 +23,12 @@ namespace osu.Game.Graphics.UserInterface
     {
         public LocalisableString Title
         {
-            get => titleSpriteText.Text;
             set => titleSpriteText.Text = value;
         }
 
         public LocalisableString Description
         {
-            get => descriptionSpriteText.Text;
-            set => descriptionSpriteText.Text = value;
+            set => descriptionText.Text = value;
         }
 
         public Action? Close
@@ -46,7 +45,7 @@ namespace osu.Game.Graphics.UserInterface
         private readonly Container contentContainer;
         private readonly Box contentBackground;
         private readonly OsuSpriteText titleSpriteText;
-        private readonly OsuSpriteText descriptionSpriteText;
+        private readonly OsuTextFlowContainer descriptionText;
         private readonly IconButton closeButton;
 
         public PopupScreenTitle()
@@ -112,9 +111,13 @@ namespace osu.Game.Graphics.UserInterface
                                     {
                                         Font = OsuFont.TorusAlternate.With(size: 20)
                                     },
-                                    descriptionSpriteText = new OsuSpriteText
+                                    descriptionText = new OsuTextFlowContainer(t =>
                                     {
-                                        Font = OsuFont.Default.With(size: 12)
+                                        t.Font = OsuFont.Default.With(size: 12);
+                                    })
+                                    {
+                                        RelativeSizeAxes = Axes.X,
+                                        AutoSizeAxes = Axes.Y
                                     }
                                 }
                             },

From 9bc1f3f014178f19c5c174ba60bcff8d617762d7 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sun, 6 Mar 2022 23:34:12 +0300
Subject: [PATCH 3254/5547] Further refactor and simplify
 `ChannelScrollContainer`

---
 .../Online/TestSceneStandAloneChatDisplay.cs  |  3 +-
 .../Overlays/Chat/ChannelScrollContainer.cs   | 78 +++++++++++++++++++
 osu.Game/Overlays/Chat/DrawableChannel.cs     | 50 ------------
 3 files changed, 79 insertions(+), 52 deletions(-)
 create mode 100644 osu.Game/Overlays/Chat/ChannelScrollContainer.cs

diff --git a/osu.Game.Tests/Visual/Online/TestSceneStandAloneChatDisplay.cs b/osu.Game.Tests/Visual/Online/TestSceneStandAloneChatDisplay.cs
index 9b9ee0e084..a21647712d 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneStandAloneChatDisplay.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneStandAloneChatDisplay.cs
@@ -9,7 +9,6 @@ using System;
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Graphics.Containers;
-using osu.Game.Graphics.Containers;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays.Chat;
 using osuTK.Input;
@@ -337,7 +336,7 @@ namespace osu.Game.Tests.Visual.Online
 
             public DrawableChannel DrawableChannel => InternalChildren.OfType<DrawableChannel>().First();
 
-            public UserTrackingScrollContainer ScrollContainer => (UserTrackingScrollContainer)((Container)DrawableChannel.Child).Child;
+            public ChannelScrollContainer ScrollContainer => (ChannelScrollContainer)((Container)DrawableChannel.Child).Child;
 
             public FillFlowContainer FillFlow => (FillFlowContainer)ScrollContainer.Child;
 
diff --git a/osu.Game/Overlays/Chat/ChannelScrollContainer.cs b/osu.Game/Overlays/Chat/ChannelScrollContainer.cs
new file mode 100644
index 0000000000..23bc683661
--- /dev/null
+++ b/osu.Game/Overlays/Chat/ChannelScrollContainer.cs
@@ -0,0 +1,78 @@
+// 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.Utils;
+using osu.Game.Graphics.Containers;
+
+namespace osu.Game.Overlays.Chat
+{
+    /// <summary>
+    /// An <see cref="OsuScrollContainer"/> with functionality to automatically scroll whenever the maximum scrollable distance increases.
+    /// </summary>
+    public class ChannelScrollContainer : OsuScrollContainer
+    {
+        /// <summary>
+        /// The chat will be automatically scrolled to end if and only if
+        /// the distance between the current scroll position and the end of the scroll
+        /// is less than this value.
+        /// </summary>
+        private const float auto_scroll_leniency = 10f;
+
+        private bool trackNewContent = true;
+
+        protected override void Update()
+        {
+            base.Update();
+
+            // If our behaviour hasn't been overriden and there has been new content added to the container, we should update our scroll position to track it.
+            bool requiresScrollUpdate = trackNewContent && !IsScrolledToEnd();
+
+            if (requiresScrollUpdate)
+            {
+                // Schedule required to allow FillFlow to be the correct size.
+                Schedule(() =>
+                {
+                    if (trackNewContent)
+                    {
+                        if (Current < ScrollableExtent)
+                            ScrollToEnd();
+                    }
+                });
+            }
+        }
+
+        private void updateTrackState() => trackNewContent = IsScrolledToEnd(auto_scroll_leniency);
+
+        // todo: we may eventually want this encapsulated in a "OnScrollChange" event handler method provided by ScrollContainer.
+        // important to note that this intentionally doesn't consider OffsetScrollPosition, but could make it do so with side changes.
+
+        #region Scroll handling
+
+        protected override void OnUserScroll(float value, bool animated = true, double? distanceDecay = null)
+        {
+            base.OnUserScroll(value, animated, distanceDecay);
+            updateTrackState();
+        }
+
+        public new void ScrollIntoView(Drawable d, bool animated = true)
+        {
+            base.ScrollIntoView(d, animated);
+            updateTrackState();
+        }
+
+        public new void ScrollToStart(bool animated = true, bool allowDuringDrag = false)
+        {
+            base.ScrollToStart(animated, allowDuringDrag);
+            updateTrackState();
+        }
+
+        public new void ScrollToEnd(bool animated = true, bool allowDuringDrag = false)
+        {
+            base.ScrollToEnd(animated, allowDuringDrag);
+            updateTrackState();
+        }
+
+        #endregion
+    }
+}
diff --git a/osu.Game/Overlays/Chat/DrawableChannel.cs b/osu.Game/Overlays/Chat/DrawableChannel.cs
index ccad55b809..6220beeb82 100644
--- a/osu.Game/Overlays/Chat/DrawableChannel.cs
+++ b/osu.Game/Overlays/Chat/DrawableChannel.cs
@@ -11,9 +11,7 @@ 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.Graphics;
-using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Cursor;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Online.Chat;
@@ -236,53 +234,5 @@ namespace osu.Game.Overlays.Chat
                 };
             }
         }
-
-        /// <summary>
-        /// An <see cref="OsuScrollContainer"/> with functionality to automatically scroll whenever the maximum scrollable distance increases.
-        /// </summary>
-        private class ChannelScrollContainer : UserTrackingScrollContainer
-        {
-            /// <summary>
-            /// The chat will be automatically scrolled to end if and only if
-            /// the distance between the current scroll position and the end of the scroll
-            /// is less than this value.
-            /// </summary>
-            private const float auto_scroll_leniency = 10f;
-
-            private bool trackNewContent = true;
-            private float? lastExtent;
-
-            protected override void OnScrollChange(bool byUser)
-            {
-                base.OnScrollChange(byUser);
-
-                if (byUser)
-                    lastExtent = null;
-
-                trackNewContent = IsScrolledToEnd(auto_scroll_leniency);
-            }
-
-            protected override void Update()
-            {
-                base.Update();
-
-                // If the user hasn't overridden our behaviour and there has been new content added to the container, we should update our scroll position to track it.
-                bool requiresScrollUpdate = trackNewContent && (lastExtent == null || Precision.AlmostBigger(ScrollableExtent, lastExtent.Value));
-
-                if (requiresScrollUpdate)
-                {
-                    // Schedule required to allow FillFlow to be the correct size.
-                    Schedule(() =>
-                    {
-                        if (trackNewContent)
-                        {
-                            if (Current < ScrollableExtent)
-                                ScrollToEnd();
-                            lastExtent = ScrollableExtent;
-                        }
-                    });
-                }
-            }
-        }
     }
 }

From 9ec0e7481332cc69e018f7c4ca6d60059cb4cd42 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sun, 6 Mar 2022 23:50:57 +0300
Subject: [PATCH 3255/5547] Move scrolling to `UpdateAfterChildren` to avoid
 scheduling

At least that's what I believe "let FillFlow update to new size" means.
---
 .../Overlays/Chat/ChannelScrollContainer.cs   | 22 ++++---------------
 1 file changed, 4 insertions(+), 18 deletions(-)

diff --git a/osu.Game/Overlays/Chat/ChannelScrollContainer.cs b/osu.Game/Overlays/Chat/ChannelScrollContainer.cs
index 23bc683661..1d1d35dc34 100644
--- a/osu.Game/Overlays/Chat/ChannelScrollContainer.cs
+++ b/osu.Game/Overlays/Chat/ChannelScrollContainer.cs
@@ -2,7 +2,6 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using osu.Framework.Graphics;
-using osu.Framework.Utils;
 using osu.Game.Graphics.Containers;
 
 namespace osu.Game.Overlays.Chat
@@ -21,25 +20,12 @@ namespace osu.Game.Overlays.Chat
 
         private bool trackNewContent = true;
 
-        protected override void Update()
+        protected override void UpdateAfterChildren()
         {
-            base.Update();
+            base.UpdateAfterChildren();
 
-            // If our behaviour hasn't been overriden and there has been new content added to the container, we should update our scroll position to track it.
-            bool requiresScrollUpdate = trackNewContent && !IsScrolledToEnd();
-
-            if (requiresScrollUpdate)
-            {
-                // Schedule required to allow FillFlow to be the correct size.
-                Schedule(() =>
-                {
-                    if (trackNewContent)
-                    {
-                        if (Current < ScrollableExtent)
-                            ScrollToEnd();
-                    }
-                });
-            }
+            if (trackNewContent && !IsScrolledToEnd())
+                ScrollToEnd();
         }
 
         private void updateTrackState() => trackNewContent = IsScrolledToEnd(auto_scroll_leniency);

From a13a087f5dda13342fe9707a63d4421dbbdcdfb0 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sun, 6 Mar 2022 23:51:27 +0300
Subject: [PATCH 3256/5547] Add xmldoc to `trackNewContent` to explain its
 purpose

---
 osu.Game/Overlays/Chat/ChannelScrollContainer.cs | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/osu.Game/Overlays/Chat/ChannelScrollContainer.cs b/osu.Game/Overlays/Chat/ChannelScrollContainer.cs
index 1d1d35dc34..58b2b9a075 100644
--- a/osu.Game/Overlays/Chat/ChannelScrollContainer.cs
+++ b/osu.Game/Overlays/Chat/ChannelScrollContainer.cs
@@ -18,6 +18,12 @@ namespace osu.Game.Overlays.Chat
         /// </summary>
         private const float auto_scroll_leniency = 10f;
 
+        /// <summary>
+        /// Whether to keep this container scrolled to end on new content.
+        /// </summary>
+        /// <remarks>
+        /// This is specifically controlled by whether the latest scroll operation made the container scrolled to end.
+        /// </remarks>
         private bool trackNewContent = true;
 
         protected override void UpdateAfterChildren()

From 60334046e4dd7dface21e505d9ea929627993433 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sun, 6 Mar 2022 23:57:51 +0300
Subject: [PATCH 3257/5547] Revert `UserTrackingScrollContainer` changes

---
 .../Containers/UserTrackingScrollContainer.cs | 21 ++++++-------------
 1 file changed, 6 insertions(+), 15 deletions(-)

diff --git a/osu.Game/Graphics/Containers/UserTrackingScrollContainer.cs b/osu.Game/Graphics/Containers/UserTrackingScrollContainer.cs
index 887aeb0c54..0561051e35 100644
--- a/osu.Game/Graphics/Containers/UserTrackingScrollContainer.cs
+++ b/osu.Game/Graphics/Containers/UserTrackingScrollContainer.cs
@@ -25,6 +25,8 @@ namespace osu.Game.Graphics.Containers
         /// </summary>
         public bool UserScrolling { get; private set; }
 
+        public void CancelUserScroll() => UserScrolling = false;
+
         public UserTrackingScrollContainer()
         {
         }
@@ -36,37 +38,26 @@ namespace osu.Game.Graphics.Containers
 
         protected override void OnUserScroll(float value, bool animated = true, double? distanceDecay = default)
         {
+            UserScrolling = true;
             base.OnUserScroll(value, animated, distanceDecay);
-            OnScrollChange(true);
         }
 
         public new void ScrollIntoView(Drawable target, bool animated = true)
         {
+            UserScrolling = false;
             base.ScrollIntoView(target, animated);
-            OnScrollChange(false);
         }
 
         public new void ScrollTo(float value, bool animated = true, double? distanceDecay = null)
         {
+            UserScrolling = false;
             base.ScrollTo(value, animated, distanceDecay);
-            OnScrollChange(false);
-        }
-
-        public new void ScrollToStart(bool animated = true, bool allowDuringDrag = false)
-        {
-            base.ScrollToStart(animated, allowDuringDrag);
-            OnScrollChange(false);
         }
 
         public new void ScrollToEnd(bool animated = true, bool allowDuringDrag = false)
         {
+            UserScrolling = false;
             base.ScrollToEnd(animated, allowDuringDrag);
-            OnScrollChange(false);
         }
-
-        /// <summary>
-        /// Invoked when any scroll has been performed either programmatically or by user.
-        /// </summary>
-        protected virtual void OnScrollChange(bool byUser) => UserScrolling = byUser;
     }
 }

From d9be65ea39fc20af1f991f99940539da37b5e815 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sun, 6 Mar 2022 23:58:06 +0300
Subject: [PATCH 3258/5547] Remove no longer necessary `CancelUserScroll`
 method

---
 osu.Game/Graphics/Containers/UserTrackingScrollContainer.cs | 2 --
 1 file changed, 2 deletions(-)

diff --git a/osu.Game/Graphics/Containers/UserTrackingScrollContainer.cs b/osu.Game/Graphics/Containers/UserTrackingScrollContainer.cs
index 0561051e35..44afaf77ea 100644
--- a/osu.Game/Graphics/Containers/UserTrackingScrollContainer.cs
+++ b/osu.Game/Graphics/Containers/UserTrackingScrollContainer.cs
@@ -25,8 +25,6 @@ namespace osu.Game.Graphics.Containers
         /// </summary>
         public bool UserScrolling { get; private set; }
 
-        public void CancelUserScroll() => UserScrolling = false;
-
         public UserTrackingScrollContainer()
         {
         }

From 30b38345aad33a37419f32528cc1ff831e70699a Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 4 Mar 2022 23:21:29 +0300
Subject: [PATCH 3259/5547] Add ability to highlight chat lines

---
 osu.Game/Overlays/Chat/ChatLine.cs        | 43 +++++++++++++++++------
 osu.Game/Overlays/Chat/DrawableChannel.cs | 22 ++++++++++++
 2 files changed, 54 insertions(+), 11 deletions(-)

diff --git a/osu.Game/Overlays/Chat/ChatLine.cs b/osu.Game/Overlays/Chat/ChatLine.cs
index 87d1b1a3ad..e7b349b313 100644
--- a/osu.Game/Overlays/Chat/ChatLine.cs
+++ b/osu.Game/Overlays/Chat/ChatLine.cs
@@ -42,7 +42,9 @@ namespace osu.Game.Overlays.Chat
 
         protected virtual float TextSize => 20;
 
-        private Color4 customUsernameColour;
+        private Container lineBackground;
+
+        private Color4 usernameColour;
 
         private OsuSpriteText timestamp;
 
@@ -78,19 +80,22 @@ namespace osu.Game.Overlays.Chat
             }
         }
 
-        private bool senderHasBackground => !string.IsNullOrEmpty(message.Sender.Colour);
+        private bool senderHasColour => !string.IsNullOrEmpty(message.Sender.Colour);
+
+        [Resolved]
+        private OsuColour colours { get; set; }
 
         [BackgroundDependencyLoader]
-        private void load(OsuColour colours)
+        private void load()
         {
-            customUsernameColour = colours.ChatBlue;
-
-            bool hasBackground = senderHasBackground;
+            usernameColour = senderHasColour
+                ? Color4Extensions.FromHex(message.Sender.Colour)
+                : username_colours[message.Sender.Id % username_colours.Length];
 
             Drawable effectedUsername = username = new OsuSpriteText
             {
                 Shadow = false,
-                Colour = hasBackground ? customUsernameColour : username_colours[message.Sender.Id % username_colours.Length],
+                Colour = senderHasColour ? colours.ChatBlue : usernameColour,
                 Truncate = true,
                 EllipsisString = "… :",
                 Font = OsuFont.GetFont(size: TextSize, weight: FontWeight.Bold, italics: true),
@@ -99,7 +104,7 @@ namespace osu.Game.Overlays.Chat
                 MaxWidth = MessagePadding - TimestampPadding
             };
 
-            if (hasBackground)
+            if (senderHasColour)
             {
                 // Background effect
                 effectedUsername = new Container
@@ -126,7 +131,7 @@ namespace osu.Game.Overlays.Chat
                             new Box
                             {
                                 RelativeSizeAxes = Axes.Both,
-                                Colour = Color4Extensions.FromHex(message.Sender.Colour),
+                                Colour = usernameColour,
                             },
                             new Container
                             {
@@ -141,6 +146,14 @@ namespace osu.Game.Overlays.Chat
 
             InternalChildren = new Drawable[]
             {
+                lineBackground = new Container
+                {
+                    RelativeSizeAxes = Axes.Both,
+                    Colour = Color4.Black.Opacity(0.0f),
+                    CornerRadius = 2f,
+                    Masking = true,
+                    Child = new Box { RelativeSizeAxes = Axes.Both }
+                },
                 new Container
                 {
                     Size = new Vector2(MessagePadding, TextSize),
@@ -177,7 +190,7 @@ namespace osu.Game.Overlays.Chat
                             {
                                 t.Font = OsuFont.GetFont(italics: true);
 
-                                if (senderHasBackground)
+                                if (senderHasColour)
                                     t.Colour = Color4Extensions.FromHex(message.Sender.Colour);
                             }
 
@@ -200,13 +213,21 @@ namespace osu.Game.Overlays.Chat
             FinishTransforms(true);
         }
 
+        /// <summary>
+        /// Schedules a message highlight animation.
+        /// </summary>
+        /// <remarks>
+        /// Scheduling is required to ensure the animation doesn't play until the chat line is in view and not scrolled away.
+        /// </remarks>
+        public void ScheduleHighlight() => Schedule(() => lineBackground.FlashColour(usernameColour.Darken(1f).Opacity(0.5f), 1000, Easing.InQuint));
+
         private void updateMessageContent()
         {
             this.FadeTo(message is LocalEchoMessage ? 0.4f : 1.0f, 500, Easing.OutQuint);
             timestamp.FadeTo(message is LocalEchoMessage ? 0 : 1, 500, Easing.OutQuint);
 
             timestamp.Text = $@"{message.Timestamp.LocalDateTime:HH:mm:ss}";
-            username.Text = $@"{message.Sender.Username}" + (senderHasBackground || message.IsAction ? "" : ":");
+            username.Text = $@"{message.Sender.Username}" + (senderHasColour || message.IsAction ? "" : ":");
 
             // remove non-existent channels from the link list
             message.Links.RemoveAll(link => link.Action == LinkAction.OpenChannel && chatManager?.AvailableChannels.Any(c => c.Name == link.Argument.ToString()) != true);
diff --git a/osu.Game/Overlays/Chat/DrawableChannel.cs b/osu.Game/Overlays/Chat/DrawableChannel.cs
index 6220beeb82..cca089873f 100644
--- a/osu.Game/Overlays/Chat/DrawableChannel.cs
+++ b/osu.Game/Overlays/Chat/DrawableChannel.cs
@@ -79,6 +79,28 @@ namespace osu.Game.Overlays.Chat
             Channel.PendingMessageResolved += pendingMessageResolved;
         }
 
+        /// <summary>
+        /// Highlights a specific message in this drawable channel.
+        /// </summary>
+        /// <param name="message">The message to highlight.</param>
+        public void HighlightMessage(Message message)
+        {
+            if (IsLoaded)
+                highlightMessage(message);
+            else
+                Schedule(highlightMessage, message);
+        }
+
+        private void highlightMessage(Message message)
+        {
+            var chatLine = chatLines.SingleOrDefault(c => c.Message == message);
+            if (chatLine == null)
+                return;
+
+            scroll.ScrollIntoView(chatLine);
+            chatLine.ScheduleHighlight();
+        }
+
         protected override void Dispose(bool isDisposing)
         {
             base.Dispose(isDisposing);

From cb2133944dfdd6cd212fbbfb8385f4e97fa51ce1 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 4 Mar 2022 23:27:09 +0300
Subject: [PATCH 3260/5547] Add test coverage for channel message highlighting

---
 .../Online/TestSceneStandAloneChatDisplay.cs  | 147 +++++++++++++-----
 1 file changed, 104 insertions(+), 43 deletions(-)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneStandAloneChatDisplay.cs b/osu.Game.Tests/Visual/Online/TestSceneStandAloneChatDisplay.cs
index a21647712d..89ee8b03e9 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneStandAloneChatDisplay.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneStandAloneChatDisplay.cs
@@ -9,6 +9,8 @@ using System;
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Graphics.Containers;
+using osu.Framework.Testing;
+using osu.Framework.Utils;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays.Chat;
 using osuTK.Input;
@@ -107,49 +109,7 @@ namespace osu.Game.Tests.Visual.Online
         [Test]
         public void TestManyMessages()
         {
-            AddStep("message from admin", () => testChannel.AddNewMessages(new Message(messageIdSequence++)
-            {
-                Sender = admin,
-                Content = "I am a wang!"
-            }));
-
-            AddStep("message from team red", () => testChannel.AddNewMessages(new Message(messageIdSequence++)
-            {
-                Sender = redUser,
-                Content = "I am team red."
-            }));
-
-            AddStep("message from team red", () => testChannel.AddNewMessages(new Message(messageIdSequence++)
-            {
-                Sender = redUser,
-                Content = "I plan to win!"
-            }));
-
-            AddStep("message from team blue", () => testChannel.AddNewMessages(new Message(messageIdSequence++)
-            {
-                Sender = blueUser,
-                Content = "Not on my watch. Prepare to eat saaaaaaaaaand. Lots and lots of saaaaaaand."
-            }));
-
-            AddStep("message from admin", () => testChannel.AddNewMessages(new Message(messageIdSequence++)
-            {
-                Sender = admin,
-                Content = "Okay okay, calm down guys. Let's do this!"
-            }));
-
-            AddStep("message from long username", () => testChannel.AddNewMessages(new Message(messageIdSequence++)
-            {
-                Sender = longUsernameUser,
-                Content = "Hi guys, my new username is lit!"
-            }));
-
-            AddStep("message with new date", () => testChannel.AddNewMessages(new Message(messageIdSequence++)
-            {
-                Sender = longUsernameUser,
-                Content = "Message from the future!",
-                Timestamp = DateTimeOffset.Now
-            }));
-
+            sendRegularMessages();
             checkScrolledToBottom();
 
             const int messages_per_call = 10;
@@ -182,6 +142,61 @@ namespace osu.Game.Tests.Visual.Online
             checkScrolledToBottom();
         }
 
+        [Test]
+        public void TestMessageHighlighting()
+        {
+            Message highlighted = null;
+
+            sendRegularMessages();
+
+            AddStep("highlight first message", () =>
+            {
+                highlighted = testChannel.Messages[0];
+                chatDisplay.DrawableChannel.HighlightMessage(highlighted);
+            });
+
+            AddUntilStep("chat scrolled to first message", () =>
+            {
+                var line = chatDisplay.ChildrenOfType<ChatLine>().Single(c => c.Message == highlighted);
+                return chatDisplay.ScrollContainer.ScreenSpaceDrawQuad.Contains(line.ScreenSpaceDrawQuad.Centre);
+            });
+
+            sendMessage();
+            checkNotScrolledToBottom();
+
+            AddStep("highlight last message", () =>
+            {
+                highlighted = testChannel.Messages[^1];
+                chatDisplay.DrawableChannel.HighlightMessage(highlighted);
+            });
+
+            AddUntilStep("chat scrolled to last message", () =>
+            {
+                var line = chatDisplay.ChildrenOfType<ChatLine>().Single(c => c.Message == highlighted);
+                return chatDisplay.ScrollContainer.ScreenSpaceDrawQuad.Contains(line.ScreenSpaceDrawQuad.Centre);
+            });
+
+            sendMessage();
+            checkScrolledToBottom();
+
+            AddRepeatStep("highlight other random messages", () =>
+            {
+                highlighted = testChannel.Messages[RNG.Next(0, testChannel.Messages.Count - 1)];
+                chatDisplay.DrawableChannel.HighlightMessage(highlighted);
+            }, 10);
+        }
+
+        [Test]
+        public void TestMessageHighlightingOnFilledChat()
+        {
+            fillChat();
+
+            AddRepeatStep("highlight random messages", () =>
+            {
+                chatDisplay.DrawableChannel.HighlightMessage(testChannel.Messages[RNG.Next(0, testChannel.Messages.Count - 1)]);
+            }, 10);
+        }
+
         /// <summary>
         /// Tests that when a message gets wrapped by the chat display getting contracted while scrolled to bottom, the chat will still keep scrolling down.
         /// </summary>
@@ -321,6 +336,52 @@ namespace osu.Game.Tests.Visual.Online
             }));
         }
 
+        private void sendRegularMessages()
+        {
+            AddStep("message from admin", () => testChannel.AddNewMessages(new Message(messageIdSequence++)
+            {
+                Sender = admin,
+                Content = "I am a wang!"
+            }));
+
+            AddStep("message from team red", () => testChannel.AddNewMessages(new Message(messageIdSequence++)
+            {
+                Sender = redUser,
+                Content = "I am team red."
+            }));
+
+            AddStep("message from team red", () => testChannel.AddNewMessages(new Message(messageIdSequence++)
+            {
+                Sender = redUser,
+                Content = "I plan to win!"
+            }));
+
+            AddStep("message from team blue", () => testChannel.AddNewMessages(new Message(messageIdSequence++)
+            {
+                Sender = blueUser,
+                Content = "Not on my watch. Prepare to eat saaaaaaaaaand. Lots and lots of saaaaaaand."
+            }));
+
+            AddStep("message from admin", () => testChannel.AddNewMessages(new Message(messageIdSequence++)
+            {
+                Sender = admin,
+                Content = "Okay okay, calm down guys. Let's do this!"
+            }));
+
+            AddStep("message from long username", () => testChannel.AddNewMessages(new Message(messageIdSequence++)
+            {
+                Sender = longUsernameUser,
+                Content = "Hi guys, my new username is lit!"
+            }));
+
+            AddStep("message with new date", () => testChannel.AddNewMessages(new Message(messageIdSequence++)
+            {
+                Sender = longUsernameUser,
+                Content = "Message from the future!",
+                Timestamp = DateTimeOffset.Now
+            }));
+        }
+
         private void checkScrolledToBottom() =>
             AddUntilStep("is scrolled to bottom", () => chatDisplay.ScrolledToBottom);
 

From f4fa80c1e3bd9ae5056185a087f7ee4d65c071c8 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 4 Mar 2022 23:28:40 +0300
Subject: [PATCH 3261/5547] Add support to highlight messages in chat overlay

---
 osu.Game/Overlays/ChatOverlay.cs | 41 ++++++++++++++++++++++++++++++++
 1 file changed, 41 insertions(+)

diff --git a/osu.Game/Overlays/ChatOverlay.cs b/osu.Game/Overlays/ChatOverlay.cs
index fde9d28b43..d642bf3bb2 100644
--- a/osu.Game/Overlays/ChatOverlay.cs
+++ b/osu.Game/Overlays/ChatOverlay.cs
@@ -4,6 +4,7 @@
 using System.Collections.Generic;
 using System.Collections.Specialized;
 using System.Linq;
+using JetBrains.Annotations;
 using osuTK;
 using osuTK.Graphics;
 using osu.Framework.Allocation;
@@ -46,6 +47,8 @@ namespace osu.Game.Overlays
 
         private Container<DrawableChannel> currentChannelContainer;
 
+        private DrawableChannel currentDrawableChannel => currentChannelContainer.SingleOrDefault();
+
         private readonly List<DrawableChannel> loadedChannels = new List<DrawableChannel>();
 
         private LoadingSpinner loading;
@@ -249,6 +252,9 @@ namespace osu.Game.Overlays
 
         private Bindable<Channel> currentChannel;
 
+        [CanBeNull]
+        private Message messagePendingHighlight;
+
         private void currentChannelChanged(ValueChangedEvent<Channel> e)
         {
             if (e.NewValue == null)
@@ -290,12 +296,24 @@ namespace osu.Game.Overlays
                     currentChannelContainer.Clear(false);
                     currentChannelContainer.Add(loaded);
                     currentChannelContainer.FadeIn(500, Easing.OutQuint);
+
+                    if (messagePendingHighlight != null)
+                    {
+                        tryHighlightMessage(messagePendingHighlight);
+                        messagePendingHighlight = null;
+                    }
                 });
             }
             else
             {
                 currentChannelContainer.Clear(false);
                 currentChannelContainer.Add(loaded);
+
+                if (messagePendingHighlight != null)
+                {
+                    tryHighlightMessage(messagePendingHighlight);
+                    messagePendingHighlight = null;
+                }
             }
 
             // mark channel as read when channel switched
@@ -303,6 +321,29 @@ namespace osu.Game.Overlays
                 channelManager.MarkChannelAsRead(e.NewValue);
         }
 
+        /// <summary>
+        /// Highlights a certain message in the specified channel.
+        /// </summary>
+        /// <param name="message">The message to highlight.</param>
+        public void HighlightMessage(Message message)
+        {
+            if (currentDrawableChannel?.Channel.Id == message.ChannelId)
+                tryHighlightMessage(message);
+            else
+            {
+                messagePendingHighlight = message;
+                currentChannel.Value = channelManager.JoinedChannels.Single(c => c.Id == message.ChannelId);
+            }
+        }
+
+        private void tryHighlightMessage(Message message)
+        {
+            if (message.ChannelId != currentChannel.Value.Id)
+                return;
+
+            currentDrawableChannel.HighlightMessage(message);
+        }
+
         private float startDragChatHeight;
         private bool isDragging;
 

From 741702549b6d45e8e7abb52c7fbd28b52057148d Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 4 Mar 2022 23:31:03 +0300
Subject: [PATCH 3262/5547] Add test coverage for chat overlay message
 highlighting

---
 .../Visual/Online/TestSceneChatOverlay.cs     | 53 +++++++++++++++++++
 1 file changed, 53 insertions(+)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneChatOverlay.cs b/osu.Game.Tests/Visual/Online/TestSceneChatOverlay.cs
index 14f32df653..a91cd53ec1 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneChatOverlay.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneChatOverlay.cs
@@ -412,6 +412,59 @@ namespace osu.Game.Tests.Visual.Online
             AddAssert("channel left", () => !channelManager.JoinedChannels.Contains(multiplayerChannel));
         }
 
+        [Test]
+        public void TestHighlightOnCurrentChannel()
+        {
+            Message message = null;
+
+            AddStep("Join channel 1", () => channelManager.JoinChannel(channel1));
+            AddStep("Select channel 1", () => clickDrawable(chatOverlay.TabMap[channel1]));
+
+            AddStep("Send message in channel 1", () =>
+            {
+                channel1.AddNewMessages(message = new Message
+                {
+                    ChannelId = channel1.Id,
+                    Content = "Message to highlight!",
+                    Timestamp = DateTimeOffset.Now,
+                    Sender = new APIUser
+                    {
+                        Id = 2,
+                        Username = "Someone",
+                    }
+                });
+            });
+
+            AddStep("Highlight message", () => chatOverlay.HighlightMessage(message));
+        }
+
+        [Test]
+        public void TestHighlightOnAnotherChannel()
+        {
+            Message message = null;
+
+            AddStep("Join channel 1", () => channelManager.JoinChannel(channel1));
+            AddStep("Select channel 1", () => clickDrawable(chatOverlay.TabMap[channel1]));
+
+            AddStep("Join channel 2", () => channelManager.JoinChannel(channel2));
+            AddStep("Send message in channel 2", () =>
+            {
+                channel2.AddNewMessages(message = new Message
+                {
+                    ChannelId = channel2.Id,
+                    Content = "Message to highlight!",
+                    Timestamp = DateTimeOffset.Now,
+                    Sender = new APIUser
+                    {
+                        Id = 2,
+                        Username = "Someone",
+                    }
+                });
+            });
+
+            AddStep("Highlight message", () => chatOverlay.HighlightMessage(message));
+        }
+
         private void pressChannelHotkey(int number)
         {
             var channelKey = Key.Number0 + number;

From 32d242dd627412a38aff0340ae6ba8039e68d84f Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 4 Mar 2022 23:31:32 +0300
Subject: [PATCH 3263/5547] Hook up message notifications to chat message
 highlighting logic

---
 osu.Game/Online/Chat/MessageNotifier.cs | 28 ++++++++++++-------------
 1 file changed, 14 insertions(+), 14 deletions(-)

diff --git a/osu.Game/Online/Chat/MessageNotifier.cs b/osu.Game/Online/Chat/MessageNotifier.cs
index 2c99e9f9b9..de3b9f71ad 100644
--- a/osu.Game/Online/Chat/MessageNotifier.cs
+++ b/osu.Game/Online/Chat/MessageNotifier.cs
@@ -99,7 +99,7 @@ namespace osu.Game.Online.Chat
                 if (checkForPMs(channel, message))
                     continue;
 
-                checkForMentions(channel, message);
+                checkForMentions(message);
             }
         }
 
@@ -114,15 +114,15 @@ namespace osu.Game.Online.Chat
             if (!notifyOnPrivateMessage.Value || channel.Type != ChannelType.PM)
                 return false;
 
-            notifications.Post(new PrivateMessageNotification(message.Sender.Username, channel));
+            notifications.Post(new PrivateMessageNotification(message));
             return true;
         }
 
-        private void checkForMentions(Channel channel, Message message)
+        private void checkForMentions(Message message)
         {
             if (!notifyOnUsername.Value || !CheckContainsUsername(message.Content, localUser.Value.Username)) return;
 
-            notifications.Post(new MentionNotification(message.Sender.Username, channel));
+            notifications.Post(new MentionNotification(message));
         }
 
         /// <summary>
@@ -138,32 +138,32 @@ namespace osu.Game.Online.Chat
 
         public class PrivateMessageNotification : OpenChannelNotification
         {
-            public PrivateMessageNotification(string username, Channel channel)
-                : base(channel)
+            public PrivateMessageNotification(Message message)
+                : base(message)
             {
                 Icon = FontAwesome.Solid.Envelope;
-                Text = $"You received a private message from '{username}'. Click to read it!";
+                Text = $"You received a private message from '{message.Sender.Username}'. Click to read it!";
             }
         }
 
         public class MentionNotification : OpenChannelNotification
         {
-            public MentionNotification(string username, Channel channel)
-                : base(channel)
+            public MentionNotification(Message message)
+                : base(message)
             {
                 Icon = FontAwesome.Solid.At;
-                Text = $"Your name was mentioned in chat by '{username}'. Click to find out why!";
+                Text = $"Your name was mentioned in chat by '{message.Sender.Username}'. Click to find out why!";
             }
         }
 
         public abstract class OpenChannelNotification : SimpleNotification
         {
-            protected OpenChannelNotification(Channel channel)
+            protected OpenChannelNotification(Message message)
             {
-                this.channel = channel;
+                this.message = message;
             }
 
-            private readonly Channel channel;
+            private readonly Message message;
 
             public override bool IsImportant => false;
 
@@ -175,8 +175,8 @@ namespace osu.Game.Online.Chat
                 Activated = delegate
                 {
                     notificationOverlay.Hide();
+                    chatOverlay.HighlightMessage(message);
                     chatOverlay.Show();
-                    channelManager.CurrentChannel.Value = channel;
 
                     return true;
                 };

From da29947ecd36fc3479d6e82ee8ca45aba4c1338a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 7 Mar 2022 11:34:06 +0900
Subject: [PATCH 3264/5547] Disallow interaction with carousel set difficulty
 icons unless selected

I kinda liked this flow, but from multiple reports from users it
definitely seems in the way. We can revisit after the new design is
applied to song select.

Note that this means the tooltips also don't display. If it is preferred
that they should (arguable from a UX perspective, since I'd expect to be
able to click at that point) then the issue can be addressed using a
slightly different path (a few more lines - nothing too complex).
---
 osu.Game/Screens/Select/Carousel/SetPanelContent.cs | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/osu.Game/Screens/Select/Carousel/SetPanelContent.cs b/osu.Game/Screens/Select/Carousel/SetPanelContent.cs
index 760915b528..a000cfd5fc 100644
--- a/osu.Game/Screens/Select/Carousel/SetPanelContent.cs
+++ b/osu.Game/Screens/Select/Carousel/SetPanelContent.cs
@@ -16,6 +16,9 @@ namespace osu.Game.Screens.Select.Carousel
 {
     public class SetPanelContent : CompositeDrawable
     {
+        // Disallow interacting with difficulty icons on a panel until the panel has been selected.
+        public override bool PropagatePositionalInputSubTree => carouselSet.State.Value == CarouselItemState.Selected;
+
         private readonly CarouselBeatmapSet carouselSet;
 
         public SetPanelContent(CarouselBeatmapSet carouselSet)

From a02adfdbd4efb69dd44d0ed872da398bb8ba09df Mon Sep 17 00:00:00 2001
From: Siim Pender <pendersiim@gmail.com>
Date: Mon, 7 Mar 2022 20:36:09 +0200
Subject: [PATCH 3265/5547] Fix crash on super high bpm kiai sections

---
 osu.Game.Rulesets.Osu/Skinning/Default/KiaiFlash.cs | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu/Skinning/Default/KiaiFlash.cs b/osu.Game.Rulesets.Osu/Skinning/Default/KiaiFlash.cs
index d49b1713f6..46e0030034 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Default/KiaiFlash.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Default/KiaiFlash.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.Audio.Track;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Shapes;
@@ -37,7 +38,7 @@ namespace osu.Game.Rulesets.Osu.Skinning.Default
             Child
                 .FadeTo(flash_opacity, EarlyActivationMilliseconds, Easing.OutQuint)
                 .Then()
-                .FadeOut(timingPoint.BeatLength - fade_length, Easing.OutSine);
+                .FadeOut(Math.Max(0, timingPoint.BeatLength - fade_length), Easing.OutSine);
         }
     }
 }

From 78a3b5961e8590e85a9303fb362d3ab8d1993c52 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 20 Feb 2022 15:48:33 +0100
Subject: [PATCH 3266/5547] Implement basic difficulty multiplier display

---
 .../TestSceneDifficultyMultiplierDisplay.cs   |  40 +++++
 .../Mods/DifficultyMultiplierDisplay.cs       | 166 ++++++++++++++++++
 2 files changed, 206 insertions(+)
 create mode 100644 osu.Game.Tests/Visual/UserInterface/TestSceneDifficultyMultiplierDisplay.cs
 create mode 100644 osu.Game/Overlays/Mods/DifficultyMultiplierDisplay.cs

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneDifficultyMultiplierDisplay.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneDifficultyMultiplierDisplay.cs
new file mode 100644
index 0000000000..cd84f8b380
--- /dev/null
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneDifficultyMultiplierDisplay.cs
@@ -0,0 +1,40 @@
+// 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.Game.Overlays;
+using osu.Game.Overlays.Mods;
+
+namespace osu.Game.Tests.Visual.UserInterface
+{
+    [TestFixture]
+    public class TestSceneDifficultyMultiplierDisplay : OsuTestScene
+    {
+        [Cached]
+        private OverlayColourProvider colourProvider = new OverlayColourProvider(OverlayColourScheme.Green);
+
+        [Test]
+        public void TestDifficultyMultiplierDisplay()
+        {
+            DifficultyMultiplierDisplay multiplierDisplay = null;
+
+            AddStep("create content", () => Child = multiplierDisplay = new DifficultyMultiplierDisplay
+            {
+                Anchor = Anchor.Centre,
+                Origin = Anchor.Centre
+            });
+
+            AddStep("set multiplier below 1", () => multiplierDisplay.Current.Value = 0.5);
+            AddStep("set multiplier to 1", () => multiplierDisplay.Current.Value = 1);
+            AddStep("set multiplier above 1", () => multiplierDisplay.Current.Value = 1.5);
+
+            AddSliderStep("set multiplier", 0, 2, 1d, multiplier =>
+            {
+                if (multiplierDisplay != null)
+                    multiplierDisplay.Current.Value = multiplier;
+            });
+        }
+    }
+}
diff --git a/osu.Game/Overlays/Mods/DifficultyMultiplierDisplay.cs b/osu.Game/Overlays/Mods/DifficultyMultiplierDisplay.cs
new file mode 100644
index 0000000000..1d4aa9e0f5
--- /dev/null
+++ b/osu.Game/Overlays/Mods/DifficultyMultiplierDisplay.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 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.Shapes;
+using osu.Framework.Graphics.Sprites;
+using osu.Framework.Graphics.UserInterface;
+using osu.Game.Graphics;
+using osu.Game.Graphics.Sprites;
+using osu.Game.Rulesets.Mods;
+using osuTK;
+
+namespace osu.Game.Overlays.Mods
+{
+    public class DifficultyMultiplierDisplay : CompositeDrawable, IHasCurrentValue<double>
+    {
+        public Bindable<double> Current
+        {
+            get => current.Current;
+            set => current.Current = value;
+        }
+
+        private readonly BindableNumberWithCurrent<double> current = new BindableNumberWithCurrent<double>(1);
+
+        private readonly Box underlayBackground;
+        private readonly Box contentBackground;
+        private readonly FillFlowContainer multiplierFlow;
+        private readonly OsuSpriteText multiplierText;
+
+        [Resolved]
+        private OsuColour colours { get; set; }
+
+        [Resolved]
+        private OverlayColourProvider colourProvider { get; set; }
+
+        private const float height = 42;
+        private const float transition_duration = 200;
+
+        public DifficultyMultiplierDisplay()
+        {
+            Height = height;
+            AutoSizeAxes = Axes.X;
+
+            InternalChild = new Container
+            {
+                RelativeSizeAxes = Axes.Y,
+                AutoSizeAxes = Axes.X,
+                Masking = true,
+                CornerRadius = ModPanel.CORNER_RADIUS,
+                Shear = new Vector2(ModPanel.SHEAR_X, 0),
+                Children = new Drawable[]
+                {
+                    underlayBackground = new Box
+                    {
+                        Anchor = Anchor.CentreRight,
+                        Origin = Anchor.CentreRight,
+                        RelativeSizeAxes = Axes.Y,
+                        Width = height + ModPanel.CORNER_RADIUS
+                    },
+                    new GridContainer
+                    {
+                        RelativeSizeAxes = Axes.Y,
+                        AutoSizeAxes = Axes.X,
+                        ColumnDimensions = new[]
+                        {
+                            new Dimension(GridSizeMode.AutoSize),
+                            new Dimension(GridSizeMode.Absolute, height)
+                        },
+                        Content = new[]
+                        {
+                            new Drawable[]
+                            {
+                                new Container
+                                {
+                                    RelativeSizeAxes = Axes.Y,
+                                    AutoSizeAxes = Axes.X,
+                                    Masking = true,
+                                    CornerRadius = ModPanel.CORNER_RADIUS,
+                                    Children = new Drawable[]
+                                    {
+                                        contentBackground = new Box
+                                        {
+                                            RelativeSizeAxes = Axes.Both
+                                        },
+                                        new OsuSpriteText
+                                        {
+                                            Anchor = Anchor.Centre,
+                                            Origin = Anchor.Centre,
+                                            Margin = new MarginPadding { Horizontal = 18 },
+                                            Shear = new Vector2(-ModPanel.SHEAR_X, 0),
+                                            Text = "Difficulty Multiplier",
+                                            Font = OsuFont.Default.With(size: 17, weight: FontWeight.SemiBold)
+                                        }
+                                    }
+                                },
+                                multiplierFlow = new FillFlowContainer
+                                {
+                                    AutoSizeAxes = Axes.Both,
+                                    Anchor = Anchor.Centre,
+                                    Origin = Anchor.Centre,
+                                    Shear = new Vector2(-ModPanel.SHEAR_X, 0),
+                                    Direction = FillDirection.Horizontal,
+                                    Spacing = new Vector2(2, 0),
+                                    Children = new Drawable[]
+                                    {
+                                        multiplierText = new OsuSpriteText
+                                        {
+                                            Anchor = Anchor.CentreLeft,
+                                            Origin = Anchor.CentreLeft,
+                                            Font = OsuFont.Default.With(size: 17, weight: FontWeight.SemiBold)
+                                        },
+                                        new SpriteIcon
+                                        {
+                                            Anchor = Anchor.CentreLeft,
+                                            Origin = Anchor.CentreLeft,
+                                            Icon = FontAwesome.Solid.Times,
+                                            Size = new Vector2(7),
+                                            Margin = new MarginPadding { Top = 1 }
+                                        }
+                                    }
+                                }
+                            }
+                        }
+                    }
+                }
+            };
+        }
+
+        [BackgroundDependencyLoader]
+        private void load()
+        {
+            contentBackground.Colour = colourProvider.Background4;
+        }
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+            current.BindValueChanged(_ => updateState(), true);
+            FinishTransforms(true);
+        }
+
+        private void updateState()
+        {
+            multiplierText.Text = current.Value.ToLocalisableString(@"N1");
+
+            if (Current.IsDefault)
+            {
+                underlayBackground.FadeColour(colourProvider.Background3, transition_duration, Easing.OutQuint);
+                multiplierFlow.FadeColour(Colour4.White, transition_duration, Easing.OutQuint);
+            }
+            else
+            {
+                var backgroundColour = Current.Value < 1
+                    ? colours.ForModType(ModType.DifficultyReduction)
+                    : colours.ForModType(ModType.DifficultyIncrease);
+
+                underlayBackground.FadeColour(backgroundColour, transition_duration, Easing.OutQuint);
+                multiplierFlow.FadeColour(colourProvider.Background5, transition_duration, Easing.OutQuint);
+            }
+        }
+    }
+}

From c25d7a1c75f0b964ff0434f58f621a2a22645d22 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 20 Feb 2022 16:02:46 +0100
Subject: [PATCH 3267/5547] Use rolling counter for multiplier display

---
 .../Mods/DifficultyMultiplierDisplay.cs       | 28 +++++++++++++++----
 1 file changed, 22 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Overlays/Mods/DifficultyMultiplierDisplay.cs b/osu.Game/Overlays/Mods/DifficultyMultiplierDisplay.cs
index 1d4aa9e0f5..3fbba0b8ed 100644
--- a/osu.Game/Overlays/Mods/DifficultyMultiplierDisplay.cs
+++ b/osu.Game/Overlays/Mods/DifficultyMultiplierDisplay.cs
@@ -9,8 +9,10 @@ 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.Game.Graphics;
 using osu.Game.Graphics.Sprites;
+using osu.Game.Graphics.UserInterface;
 using osu.Game.Rulesets.Mods;
 using osuTK;
 
@@ -24,12 +26,15 @@ namespace osu.Game.Overlays.Mods
             set => current.Current = value;
         }
 
-        private readonly BindableNumberWithCurrent<double> current = new BindableNumberWithCurrent<double>(1);
+        private readonly BindableNumberWithCurrent<double> current = new BindableNumberWithCurrent<double>(1)
+        {
+            Precision = 0.1
+        };
 
         private readonly Box underlayBackground;
         private readonly Box contentBackground;
         private readonly FillFlowContainer multiplierFlow;
-        private readonly OsuSpriteText multiplierText;
+        private readonly MultiplierCounter multiplierCounter;
 
         [Resolved]
         private OsuColour colours { get; set; }
@@ -107,11 +112,11 @@ namespace osu.Game.Overlays.Mods
                                     Spacing = new Vector2(2, 0),
                                     Children = new Drawable[]
                                     {
-                                        multiplierText = new OsuSpriteText
+                                        multiplierCounter = new MultiplierCounter
                                         {
                                             Anchor = Anchor.CentreLeft,
                                             Origin = Anchor.CentreLeft,
-                                            Font = OsuFont.Default.With(size: 17, weight: FontWeight.SemiBold)
+                                            Current = { BindTarget = Current }
                                         },
                                         new SpriteIcon
                                         {
@@ -141,12 +146,11 @@ namespace osu.Game.Overlays.Mods
             base.LoadComplete();
             current.BindValueChanged(_ => updateState(), true);
             FinishTransforms(true);
+            multiplierCounter.StopRolling();
         }
 
         private void updateState()
         {
-            multiplierText.Text = current.Value.ToLocalisableString(@"N1");
-
             if (Current.IsDefault)
             {
                 underlayBackground.FadeColour(colourProvider.Background3, transition_duration, Easing.OutQuint);
@@ -162,5 +166,17 @@ namespace osu.Game.Overlays.Mods
                 multiplierFlow.FadeColour(colourProvider.Background5, transition_duration, Easing.OutQuint);
             }
         }
+
+        private class MultiplierCounter : RollingCounter<double>
+        {
+            protected override double RollingDuration => 500;
+
+            protected override LocalisableString FormatCount(double count) => count.ToLocalisableString(@"N1");
+
+            protected override OsuSpriteText CreateSpriteText() => new OsuSpriteText
+            {
+                Font = OsuFont.Default.With(size: 17, weight: FontWeight.SemiBold)
+            };
+        }
     }
 }

From 019f4d965de8165675aae9027105b2e54730f7b6 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 7 Mar 2022 22:55:55 +0100
Subject: [PATCH 3268/5547] Show two decimal digits on mod multiplier rather
 than one

---
 osu.Game/Overlays/Mods/DifficultyMultiplierDisplay.cs | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Overlays/Mods/DifficultyMultiplierDisplay.cs b/osu.Game/Overlays/Mods/DifficultyMultiplierDisplay.cs
index 3fbba0b8ed..e10edb1ebc 100644
--- a/osu.Game/Overlays/Mods/DifficultyMultiplierDisplay.cs
+++ b/osu.Game/Overlays/Mods/DifficultyMultiplierDisplay.cs
@@ -28,7 +28,7 @@ namespace osu.Game.Overlays.Mods
 
         private readonly BindableNumberWithCurrent<double> current = new BindableNumberWithCurrent<double>(1)
         {
-            Precision = 0.1
+            Precision = 0.01
         };
 
         private readonly Box underlayBackground;
@@ -43,6 +43,7 @@ namespace osu.Game.Overlays.Mods
         private OverlayColourProvider colourProvider { get; set; }
 
         private const float height = 42;
+        private const float multiplier_value_area_width = 56;
         private const float transition_duration = 200;
 
         public DifficultyMultiplierDisplay()
@@ -64,7 +65,7 @@ namespace osu.Game.Overlays.Mods
                         Anchor = Anchor.CentreRight,
                         Origin = Anchor.CentreRight,
                         RelativeSizeAxes = Axes.Y,
-                        Width = height + ModPanel.CORNER_RADIUS
+                        Width = multiplier_value_area_width + ModPanel.CORNER_RADIUS
                     },
                     new GridContainer
                     {
@@ -73,7 +74,7 @@ namespace osu.Game.Overlays.Mods
                         ColumnDimensions = new[]
                         {
                             new Dimension(GridSizeMode.AutoSize),
-                            new Dimension(GridSizeMode.Absolute, height)
+                            new Dimension(GridSizeMode.Absolute, multiplier_value_area_width)
                         },
                         Content = new[]
                         {
@@ -171,7 +172,7 @@ namespace osu.Game.Overlays.Mods
         {
             protected override double RollingDuration => 500;
 
-            protected override LocalisableString FormatCount(double count) => count.ToLocalisableString(@"N1");
+            protected override LocalisableString FormatCount(double count) => count.ToLocalisableString(@"N2");
 
             protected override OsuSpriteText CreateSpriteText() => new OsuSpriteText
             {

From 643f68e8447d7cf946508c7632fab0e239303eb7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 7 Mar 2022 23:11:20 +0100
Subject: [PATCH 3269/5547] Better annotate initial rolling counter value set

---
 osu.Game/Overlays/Mods/DifficultyMultiplierDisplay.cs | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/Mods/DifficultyMultiplierDisplay.cs b/osu.Game/Overlays/Mods/DifficultyMultiplierDisplay.cs
index e10edb1ebc..4fc3a904fa 100644
--- a/osu.Game/Overlays/Mods/DifficultyMultiplierDisplay.cs
+++ b/osu.Game/Overlays/Mods/DifficultyMultiplierDisplay.cs
@@ -147,7 +147,9 @@ namespace osu.Game.Overlays.Mods
             base.LoadComplete();
             current.BindValueChanged(_ => updateState(), true);
             FinishTransforms(true);
-            multiplierCounter.StopRolling();
+            // required to prevent the counter initially rolling up from 0 to 1
+            // due to `Current.Value` having a nonstandard default value of 1.
+            multiplierCounter.SetCountWithoutRolling(Current.Value);
         }
 
         private void updateState()

From 22a2ef42c5e855e95df6970eb3659ac6c43ee0f0 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Tue, 8 Mar 2022 01:22:47 +0300
Subject: [PATCH 3270/5547] Check channel ID on message highlight using
 `currentDrawableChannel`

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

diff --git a/osu.Game/Overlays/ChatOverlay.cs b/osu.Game/Overlays/ChatOverlay.cs
index d642bf3bb2..39513f7963 100644
--- a/osu.Game/Overlays/ChatOverlay.cs
+++ b/osu.Game/Overlays/ChatOverlay.cs
@@ -338,7 +338,7 @@ namespace osu.Game.Overlays
 
         private void tryHighlightMessage(Message message)
         {
-            if (message.ChannelId != currentChannel.Value.Id)
+            if (message.ChannelId != currentDrawableChannel.Channel.Id)
                 return;
 
             currentDrawableChannel.HighlightMessage(message);

From 5764c53c1789acbdf37e129ecd0a490c698c589d Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Tue, 8 Mar 2022 01:22:58 +0300
Subject: [PATCH 3271/5547] OpenChannelNotification ->
 HighlightMessageNotification

---
 osu.Game/Online/Chat/MessageNotifier.cs | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Online/Chat/MessageNotifier.cs b/osu.Game/Online/Chat/MessageNotifier.cs
index de3b9f71ad..90b6d927c7 100644
--- a/osu.Game/Online/Chat/MessageNotifier.cs
+++ b/osu.Game/Online/Chat/MessageNotifier.cs
@@ -136,7 +136,7 @@ namespace osu.Game.Online.Chat
             return Regex.IsMatch(message, $@"(^|\W)({fullName}|{underscoreName})($|\W)", RegexOptions.IgnoreCase);
         }
 
-        public class PrivateMessageNotification : OpenChannelNotification
+        public class PrivateMessageNotification : HighlightMessageNotification
         {
             public PrivateMessageNotification(Message message)
                 : base(message)
@@ -146,7 +146,7 @@ namespace osu.Game.Online.Chat
             }
         }
 
-        public class MentionNotification : OpenChannelNotification
+        public class MentionNotification : HighlightMessageNotification
         {
             public MentionNotification(Message message)
                 : base(message)
@@ -156,9 +156,9 @@ namespace osu.Game.Online.Chat
             }
         }
 
-        public abstract class OpenChannelNotification : SimpleNotification
+        public abstract class HighlightMessageNotification : SimpleNotification
         {
-            protected OpenChannelNotification(Message message)
+            protected HighlightMessageNotification(Message message)
             {
                 this.message = message;
             }
@@ -168,7 +168,7 @@ namespace osu.Game.Online.Chat
             public override bool IsImportant => false;
 
             [BackgroundDependencyLoader]
-            private void load(OsuColour colours, ChatOverlay chatOverlay, NotificationOverlay notificationOverlay, ChannelManager channelManager)
+            private void load(OsuColour colours, ChatOverlay chatOverlay, NotificationOverlay notificationOverlay)
             {
                 IconBackground.Colour = colours.PurpleDark;
 

From 7f47be4680ee16ca16d6bd59185852623306c971 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Tue, 8 Mar 2022 03:19:35 +0300
Subject: [PATCH 3272/5547] Refactor message highlighting logic to rely on a
 `Channel` data bindable

---
 .../Online/TestSceneStandAloneChatDisplay.cs  |  8 +-
 osu.Game/Online/Chat/Channel.cs               |  7 ++
 osu.Game/Overlays/Chat/DrawableChannel.cs     | 95 ++++++++++---------
 osu.Game/Overlays/ChatOverlay.cs              | 33 +------
 4 files changed, 63 insertions(+), 80 deletions(-)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneStandAloneChatDisplay.cs b/osu.Game.Tests/Visual/Online/TestSceneStandAloneChatDisplay.cs
index 89ee8b03e9..c9837be934 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneStandAloneChatDisplay.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneStandAloneChatDisplay.cs
@@ -152,7 +152,7 @@ namespace osu.Game.Tests.Visual.Online
             AddStep("highlight first message", () =>
             {
                 highlighted = testChannel.Messages[0];
-                chatDisplay.DrawableChannel.HighlightMessage(highlighted);
+                chatDisplay.DrawableChannel.Channel.HighlightedMessage.Value = highlighted;
             });
 
             AddUntilStep("chat scrolled to first message", () =>
@@ -167,7 +167,7 @@ namespace osu.Game.Tests.Visual.Online
             AddStep("highlight last message", () =>
             {
                 highlighted = testChannel.Messages[^1];
-                chatDisplay.DrawableChannel.HighlightMessage(highlighted);
+                chatDisplay.DrawableChannel.Channel.HighlightedMessage.Value = highlighted;
             });
 
             AddUntilStep("chat scrolled to last message", () =>
@@ -182,7 +182,7 @@ namespace osu.Game.Tests.Visual.Online
             AddRepeatStep("highlight other random messages", () =>
             {
                 highlighted = testChannel.Messages[RNG.Next(0, testChannel.Messages.Count - 1)];
-                chatDisplay.DrawableChannel.HighlightMessage(highlighted);
+                chatDisplay.DrawableChannel.Channel.HighlightedMessage.Value = highlighted;
             }, 10);
         }
 
@@ -193,7 +193,7 @@ namespace osu.Game.Tests.Visual.Online
 
             AddRepeatStep("highlight random messages", () =>
             {
-                chatDisplay.DrawableChannel.HighlightMessage(testChannel.Messages[RNG.Next(0, testChannel.Messages.Count - 1)]);
+                chatDisplay.DrawableChannel.Channel.HighlightedMessage.Value = testChannel.Messages[RNG.Next(0, testChannel.Messages.Count - 1)];
             }, 10);
         }
 
diff --git a/osu.Game/Online/Chat/Channel.cs b/osu.Game/Online/Chat/Channel.cs
index 9cbb2f37e4..a37d3084f0 100644
--- a/osu.Game/Online/Chat/Channel.cs
+++ b/osu.Game/Online/Chat/Channel.cs
@@ -9,6 +9,7 @@ using Newtonsoft.Json;
 using osu.Framework.Bindables;
 using osu.Framework.Lists;
 using osu.Game.Online.API.Requests.Responses;
+using osu.Game.Overlays.Chat;
 
 namespace osu.Game.Online.Chat
 {
@@ -89,6 +90,12 @@ namespace osu.Game.Online.Chat
         /// </summary>
         public Bindable<bool> Joined = new Bindable<bool>();
 
+        /// <summary>
+        /// Signals if there is a message to highlight.
+        /// This is automatically cleared by the associated <see cref="DrawableChannel"/> after highlighting.
+        /// </summary>
+        public Bindable<Message> HighlightedMessage = new Bindable<Message>();
+
         [JsonConstructor]
         public Channel()
         {
diff --git a/osu.Game/Overlays/Chat/DrawableChannel.cs b/osu.Game/Overlays/Chat/DrawableChannel.cs
index cca089873f..6ff7cccd65 100644
--- a/osu.Game/Overlays/Chat/DrawableChannel.cs
+++ b/osu.Game/Overlays/Chat/DrawableChannel.cs
@@ -6,6 +6,7 @@ using System.Collections.Generic;
 using System.Diagnostics;
 using System.Linq;
 using osu.Framework.Allocation;
+using osu.Framework.Bindables;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
@@ -48,6 +49,8 @@ namespace osu.Game.Overlays.Chat
             RelativeSizeAxes = Axes.Both;
         }
 
+        private Bindable<Message> highlightedMessage;
+
         [BackgroundDependencyLoader]
         private void load()
         {
@@ -71,34 +74,34 @@ namespace osu.Game.Overlays.Chat
                     }
                 },
             };
+        }
 
-            newMessagesArrived(Channel.Messages);
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            addChatLines(Channel.Messages);
 
             Channel.NewMessagesArrived += newMessagesArrived;
             Channel.MessageRemoved += messageRemoved;
             Channel.PendingMessageResolved += pendingMessageResolved;
-        }
 
-        /// <summary>
-        /// Highlights a specific message in this drawable channel.
-        /// </summary>
-        /// <param name="message">The message to highlight.</param>
-        public void HighlightMessage(Message message)
-        {
-            if (IsLoaded)
-                highlightMessage(message);
-            else
-                Schedule(highlightMessage, message);
-        }
+            highlightedMessage = Channel.HighlightedMessage.GetBoundCopy();
+            highlightedMessage.BindValueChanged(m =>
+            {
+                if (m.NewValue == null)
+                    return;
 
-        private void highlightMessage(Message message)
-        {
-            var chatLine = chatLines.SingleOrDefault(c => c.Message == message);
-            if (chatLine == null)
-                return;
+                var chatLine = chatLines.SingleOrDefault(c => c.Message == m.NewValue);
 
-            scroll.ScrollIntoView(chatLine);
-            chatLine.ScheduleHighlight();
+                if (chatLine != null)
+                {
+                    scroll.ScrollIntoView(chatLine);
+                    chatLine.ScheduleHighlight();
+                }
+
+                highlightedMessage.Value = null;
+            }, true);
         }
 
         protected override void Dispose(bool isDisposing)
@@ -118,18 +121,39 @@ namespace osu.Game.Overlays.Chat
             Colour = colours.ChatBlue.Lighten(0.7f),
         };
 
-        private void newMessagesArrived(IEnumerable<Message> newMessages) => Schedule(() =>
+        private void newMessagesArrived(IEnumerable<Message> newMessages) => Schedule(addChatLines, newMessages);
+
+        private void pendingMessageResolved(Message existing, Message updated) => Schedule(() =>
         {
-            if (newMessages.Min(m => m.Id) < chatLines.Max(c => c.Message.Id))
+            var found = chatLines.LastOrDefault(c => c.Message == existing);
+
+            if (found != null)
+            {
+                Trace.Assert(updated.Id.HasValue, "An updated message was returned with no ID.");
+
+                ChatLineFlow.Remove(found);
+                found.Message = updated;
+                ChatLineFlow.Add(found);
+            }
+        });
+
+        private void messageRemoved(Message removed) => Schedule(() =>
+        {
+            chatLines.FirstOrDefault(c => c.Message == removed)?.FadeColour(Color4.Red, 400).FadeOut(600).Expire();
+        });
+
+        private void addChatLines(IEnumerable<Message> messages)
+        {
+            if (messages.Min(m => m.Id) < chatLines.Max(c => c.Message.Id))
             {
                 // there is a case (on initial population) that we may receive past messages and need to reorder.
                 // easiest way is to just combine messages and recreate drawables (less worrying about day separators etc.)
-                newMessages = newMessages.Concat(chatLines.Select(c => c.Message)).OrderBy(m => m.Id).ToList();
+                messages = messages.Concat(chatLines.Select(c => c.Message)).OrderBy(m => m.Id).ToList();
                 ChatLineFlow.Clear();
             }
 
             // Add up to last Channel.MAX_HISTORY messages
-            var displayMessages = newMessages.Skip(Math.Max(0, newMessages.Count() - Channel.MAX_HISTORY));
+            var displayMessages = messages.Skip(Math.Max(0, messages.Count() - Channel.MAX_HISTORY));
 
             Message lastMessage = chatLines.LastOrDefault()?.Message;
 
@@ -168,28 +192,9 @@ namespace osu.Game.Overlays.Chat
 
             // due to the scroll adjusts from old messages removal above, a scroll-to-end must be enforced,
             // to avoid making the container think the user has scrolled back up and unwantedly disable auto-scrolling.
-            if (newMessages.Any(m => m is LocalMessage))
+            if (messages.Any(m => m is LocalMessage))
                 scroll.ScrollToEnd();
-        });
-
-        private void pendingMessageResolved(Message existing, Message updated) => Schedule(() =>
-        {
-            var found = chatLines.LastOrDefault(c => c.Message == existing);
-
-            if (found != null)
-            {
-                Trace.Assert(updated.Id.HasValue, "An updated message was returned with no ID.");
-
-                ChatLineFlow.Remove(found);
-                found.Message = updated;
-                ChatLineFlow.Add(found);
-            }
-        });
-
-        private void messageRemoved(Message removed) => Schedule(() =>
-        {
-            chatLines.FirstOrDefault(c => c.Message == removed)?.FadeColour(Color4.Red, 400).FadeOut(600).Expire();
-        });
+        }
 
         private IEnumerable<ChatLine> chatLines => ChatLineFlow.Children.OfType<ChatLine>();
 
diff --git a/osu.Game/Overlays/ChatOverlay.cs b/osu.Game/Overlays/ChatOverlay.cs
index 39513f7963..d5e8b209f0 100644
--- a/osu.Game/Overlays/ChatOverlay.cs
+++ b/osu.Game/Overlays/ChatOverlay.cs
@@ -4,7 +4,6 @@
 using System.Collections.Generic;
 using System.Collections.Specialized;
 using System.Linq;
-using JetBrains.Annotations;
 using osuTK;
 using osuTK.Graphics;
 using osu.Framework.Allocation;
@@ -47,8 +46,6 @@ namespace osu.Game.Overlays
 
         private Container<DrawableChannel> currentChannelContainer;
 
-        private DrawableChannel currentDrawableChannel => currentChannelContainer.SingleOrDefault();
-
         private readonly List<DrawableChannel> loadedChannels = new List<DrawableChannel>();
 
         private LoadingSpinner loading;
@@ -252,9 +249,6 @@ namespace osu.Game.Overlays
 
         private Bindable<Channel> currentChannel;
 
-        [CanBeNull]
-        private Message messagePendingHighlight;
-
         private void currentChannelChanged(ValueChangedEvent<Channel> e)
         {
             if (e.NewValue == null)
@@ -296,24 +290,12 @@ namespace osu.Game.Overlays
                     currentChannelContainer.Clear(false);
                     currentChannelContainer.Add(loaded);
                     currentChannelContainer.FadeIn(500, Easing.OutQuint);
-
-                    if (messagePendingHighlight != null)
-                    {
-                        tryHighlightMessage(messagePendingHighlight);
-                        messagePendingHighlight = null;
-                    }
                 });
             }
             else
             {
                 currentChannelContainer.Clear(false);
                 currentChannelContainer.Add(loaded);
-
-                if (messagePendingHighlight != null)
-                {
-                    tryHighlightMessage(messagePendingHighlight);
-                    messagePendingHighlight = null;
-                }
             }
 
             // mark channel as read when channel switched
@@ -327,21 +309,10 @@ namespace osu.Game.Overlays
         /// <param name="message">The message to highlight.</param>
         public void HighlightMessage(Message message)
         {
-            if (currentDrawableChannel?.Channel.Id == message.ChannelId)
-                tryHighlightMessage(message);
-            else
-            {
-                messagePendingHighlight = message;
+            if (currentChannel.Value.Id != message.ChannelId)
                 currentChannel.Value = channelManager.JoinedChannels.Single(c => c.Id == message.ChannelId);
-            }
-        }
 
-        private void tryHighlightMessage(Message message)
-        {
-            if (message.ChannelId != currentDrawableChannel.Channel.Id)
-                return;
-
-            currentDrawableChannel.HighlightMessage(message);
+            currentChannel.Value.HighlightedMessage.Value = message;
         }
 
         private float startDragChatHeight;

From f8e5570e4152b2ac52c859f086a73abb8ec0f3f0 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Tue, 8 Mar 2022 03:20:20 +0300
Subject: [PATCH 3273/5547] Fix `Message` equality not passing on equal
 references

---
 osu.Game/Online/Chat/Message.cs | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Online/Chat/Message.cs b/osu.Game/Online/Chat/Message.cs
index dcd15f9028..3db63c3fca 100644
--- a/osu.Game/Online/Chat/Message.cs
+++ b/osu.Game/Online/Chat/Message.cs
@@ -59,7 +59,13 @@ namespace osu.Game.Online.Chat
             return Id.Value.CompareTo(other.Id.Value);
         }
 
-        public virtual bool Equals(Message other) => Id.HasValue && Id == other?.Id;
+        public virtual bool Equals(Message other)
+        {
+            if (ReferenceEquals(null, other)) return false;
+            if (ReferenceEquals(this, other)) return true;
+
+            return Id.HasValue && Id == other?.Id;
+        }
 
         // ReSharper disable once ImpureMethodCallOnReadonlyValueField
         public override int GetHashCode() => Id.GetHashCode();

From f64586995888b1b2d05a9e586d9dd888107954c1 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Tue, 8 Mar 2022 03:42:17 +0300
Subject: [PATCH 3274/5547] Update `ChannelManager.CurrentChannel` directly to
 handle non-loaded chat scenario

`currentChannel` gets instantiated once the chat overlay is open, while
`HighlightMessage` could be called while the chat overlay has never been
open.

This will all be rewritten with the new chat overlay design anyways, so
should be fine for now.
---
 osu.Game/Overlays/ChatOverlay.cs | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Overlays/ChatOverlay.cs b/osu.Game/Overlays/ChatOverlay.cs
index d5e8b209f0..d6a1b23c46 100644
--- a/osu.Game/Overlays/ChatOverlay.cs
+++ b/osu.Game/Overlays/ChatOverlay.cs
@@ -309,10 +309,10 @@ namespace osu.Game.Overlays
         /// <param name="message">The message to highlight.</param>
         public void HighlightMessage(Message message)
         {
-            if (currentChannel.Value.Id != message.ChannelId)
-                currentChannel.Value = channelManager.JoinedChannels.Single(c => c.Id == message.ChannelId);
+            if (channelManager.CurrentChannel.Value.Id != message.ChannelId)
+                channelManager.CurrentChannel.Value = channelManager.JoinedChannels.Single(c => c.Id == message.ChannelId);
 
-            currentChannel.Value.HighlightedMessage.Value = message;
+            channelManager.CurrentChannel.Value.HighlightedMessage.Value = message;
         }
 
         private float startDragChatHeight;

From d74064b94b93d229e39b4c2ebc6161bb8d5ff000 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Tue, 8 Mar 2022 03:56:27 +0300
Subject: [PATCH 3275/5547] Use `Equals` instead of reference equality operator

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

diff --git a/osu.Game/Overlays/Chat/DrawableChannel.cs b/osu.Game/Overlays/Chat/DrawableChannel.cs
index 6ff7cccd65..a73e61c52b 100644
--- a/osu.Game/Overlays/Chat/DrawableChannel.cs
+++ b/osu.Game/Overlays/Chat/DrawableChannel.cs
@@ -92,7 +92,7 @@ namespace osu.Game.Overlays.Chat
                 if (m.NewValue == null)
                     return;
 
-                var chatLine = chatLines.SingleOrDefault(c => c.Message == m.NewValue);
+                var chatLine = chatLines.SingleOrDefault(c => c.Message.Equals(m.NewValue));
 
                 if (chatLine != null)
                 {

From 5e0882df8de12a0229f6d0c39910ebd6ebb1b94b Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Tue, 8 Mar 2022 04:00:11 +0300
Subject: [PATCH 3276/5547] Simplify message highlighting transforms

---
 osu.Game/Overlays/Chat/ChatLine.cs | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Overlays/Chat/ChatLine.cs b/osu.Game/Overlays/Chat/ChatLine.cs
index e7b349b313..97fda80492 100644
--- a/osu.Game/Overlays/Chat/ChatLine.cs
+++ b/osu.Game/Overlays/Chat/ChatLine.cs
@@ -42,7 +42,7 @@ namespace osu.Game.Overlays.Chat
 
         protected virtual float TextSize => 20;
 
-        private Container lineBackground;
+        private Container lineHighlightBackground;
 
         private Color4 usernameColour;
 
@@ -146,10 +146,11 @@ namespace osu.Game.Overlays.Chat
 
             InternalChildren = new Drawable[]
             {
-                lineBackground = new Container
+                lineHighlightBackground = new Container
                 {
+                    Alpha = 0f,
                     RelativeSizeAxes = Axes.Both,
-                    Colour = Color4.Black.Opacity(0.0f),
+                    Colour = usernameColour.Darken(1f),
                     CornerRadius = 2f,
                     Masking = true,
                     Child = new Box { RelativeSizeAxes = Axes.Both }
@@ -219,7 +220,7 @@ namespace osu.Game.Overlays.Chat
         /// <remarks>
         /// Scheduling is required to ensure the animation doesn't play until the chat line is in view and not scrolled away.
         /// </remarks>
-        public void ScheduleHighlight() => Schedule(() => lineBackground.FlashColour(usernameColour.Darken(1f).Opacity(0.5f), 1000, Easing.InQuint));
+        public void ScheduleHighlight() => Schedule(() => lineHighlightBackground.FadeTo(0.5f).FadeOut(1000, Easing.InQuint));
 
         private void updateMessageContent()
         {

From ded84cab3ff0f5a8dd0e79639fa77b828a70cc61 Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Tue, 8 Mar 2022 11:45:16 +0800
Subject: [PATCH 3277/5547] Separate randomisation and object positioning logic

---
 osu.Game.Rulesets.Osu/Mods/OsuModRandom.cs | 101 +++++++++++++--------
 1 file changed, 62 insertions(+), 39 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModRandom.cs b/osu.Game.Rulesets.Osu/Mods/OsuModRandom.cs
index 9b9ebcad04..1d0442438e 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModRandom.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModRandom.cs
@@ -25,6 +25,7 @@ namespace osu.Game.Rulesets.Osu.Mods
         public override string Description => "It never gets boring!";
 
         private static readonly float playfield_diagonal = OsuPlayfield.BASE_SIZE.LengthFast;
+        private static readonly Vector2 playfield_centre = OsuPlayfield.BASE_SIZE / 2;
 
         /// <summary>
         /// Number of previous hitobjects to be shifted together when another object is being moved.
@@ -44,20 +45,15 @@ namespace osu.Game.Rulesets.Osu.Mods
 
             rng = new Random((int)Seed.Value);
 
-            RandomObjectInfo previous = null;
+            var randomObjects = randomiseObjects(hitObjects);
 
-            float rateOfChangeMultiplier = 0;
+            RandomObjectInfo previous = null;
 
             for (int i = 0; i < hitObjects.Count; i++)
             {
                 var hitObject = hitObjects[i];
 
-                var current = new RandomObjectInfo(hitObject);
-
-                // rateOfChangeMultiplier only changes every 5 iterations in a combo
-                // to prevent shaky-line-shaped streams
-                if (hitObject.IndexInCurrentCombo % 5 == 0)
-                    rateOfChangeMultiplier = (float)rng.NextDouble() * 2 - 1;
+                var current = randomObjects[i];
 
                 if (hitObject is Spinner)
                 {
@@ -65,7 +61,7 @@ namespace osu.Game.Rulesets.Osu.Mods
                     continue;
                 }
 
-                applyRandomisation(rateOfChangeMultiplier, previous, current);
+                applyRandomisation(getAbsoluteAngle(hitObjects, i - 1), previous, current);
 
                 // Move hit objects back into the playfield if they are outside of it
                 Vector2 shift = Vector2.Zero;
@@ -101,45 +97,72 @@ namespace osu.Game.Rulesets.Osu.Mods
             }
         }
 
+        private List<RandomObjectInfo> randomiseObjects(IEnumerable<OsuHitObject> hitObjects)
+        {
+            var randomObjects = new List<RandomObjectInfo>();
+            RandomObjectInfo previous = null;
+            float rateOfChangeMultiplier = 0;
+
+            foreach (OsuHitObject hitObject in hitObjects)
+            {
+                var current = new RandomObjectInfo(hitObject);
+                randomObjects.Add(current);
+
+                // rateOfChangeMultiplier only changes every 5 iterations in a combo
+                // to prevent shaky-line-shaped streams
+                if (hitObject.IndexInCurrentCombo % 5 == 0)
+                    rateOfChangeMultiplier = (float)rng.NextDouble() * 2 - 1;
+
+                if (previous == null)
+                {
+                    current.Distance = (float)(rng.NextDouble() * OsuPlayfield.BASE_SIZE.X / 2);
+                    current.RelativeAngle = (float)(rng.NextDouble() * 2 * Math.PI - Math.PI);
+                }
+                else
+                {
+                    current.Distance = Vector2.Distance(previous.EndPositionOriginal, current.PositionOriginal);
+
+                    // The max. angle (relative to the angle of the vector pointing from the 2nd last to the last hit object)
+                    // is proportional to the distance between the last and the current hit object
+                    // to allow jumps and prevent too sharp turns during streams.
+
+                    // Allow maximum jump angle when jump distance is more than half of playfield diagonal length
+                    current.RelativeAngle = rateOfChangeMultiplier * 2 * (float)Math.PI * Math.Min(1f, current.Distance / (playfield_diagonal * 0.5f));
+                }
+
+                previous = current;
+            }
+
+            return randomObjects;
+        }
+
+        private float getAbsoluteAngle(IReadOnlyList<OsuHitObject> hitObjects, int hitObjectIndex)
+        {
+            if (hitObjectIndex < 0) return 0;
+
+            Vector2 previousPosition = hitObjectIndex == 0 ? playfield_centre : hitObjects[hitObjectIndex - 1].EndPosition;
+            Vector2 relativePosition = hitObjects[hitObjectIndex].Position - previousPosition;
+            return (float)Math.Atan2(relativePosition.Y, relativePosition.X);
+        }
+
         /// <summary>
         /// Returns the final position of the hit object
         /// </summary>
         /// <returns>Final position of the hit object</returns>
-        private void applyRandomisation(float rateOfChangeMultiplier, RandomObjectInfo previous, RandomObjectInfo current)
+        private void applyRandomisation(float previousAbsoluteAngle, RandomObjectInfo previous, RandomObjectInfo current)
         {
-            if (previous == null)
-            {
-                var playfieldSize = OsuPlayfield.BASE_SIZE;
-
-                current.AngleRad = (float)(rng.NextDouble() * 2 * Math.PI - Math.PI);
-                current.PositionRandomised = new Vector2((float)rng.NextDouble() * playfieldSize.X, (float)rng.NextDouble() * playfieldSize.Y);
-
-                return;
-            }
-
-            float distanceToPrev = Vector2.Distance(previous.EndPositionOriginal, current.PositionOriginal);
-
-            // The max. angle (relative to the angle of the vector pointing from the 2nd last to the last hit object)
-            // is proportional to the distance between the last and the current hit object
-            // to allow jumps and prevent too sharp turns during streams.
-
-            // Allow maximum jump angle when jump distance is more than half of playfield diagonal length
-            double randomAngleRad = rateOfChangeMultiplier * 2 * Math.PI * Math.Min(1f, distanceToPrev / (playfield_diagonal * 0.5f));
-
-            current.AngleRad = (float)randomAngleRad + previous.AngleRad;
-            if (current.AngleRad < 0)
-                current.AngleRad += 2 * (float)Math.PI;
+            float absoluteAngle = previousAbsoluteAngle + current.RelativeAngle;
 
             var posRelativeToPrev = new Vector2(
-                distanceToPrev * (float)Math.Cos(current.AngleRad),
-                distanceToPrev * (float)Math.Sin(current.AngleRad)
+                current.Distance * (float)Math.Cos(absoluteAngle),
+                current.Distance * (float)Math.Sin(absoluteAngle)
             );
 
-            posRelativeToPrev = OsuHitObjectGenerationUtils.RotateAwayFromEdge(previous.EndPositionRandomised, posRelativeToPrev);
+            Vector2 lastEndPosition = previous?.EndPositionRandomised ?? playfield_centre;
 
-            current.AngleRad = (float)Math.Atan2(posRelativeToPrev.Y, posRelativeToPrev.X);
+            posRelativeToPrev = OsuHitObjectGenerationUtils.RotateAwayFromEdge(lastEndPosition, posRelativeToPrev);
 
-            current.PositionRandomised = previous.EndPositionRandomised + posRelativeToPrev;
+            current.PositionRandomised = lastEndPosition + posRelativeToPrev;
         }
 
         /// <summary>
@@ -287,7 +310,8 @@ namespace osu.Game.Rulesets.Osu.Mods
 
         private class RandomObjectInfo
         {
-            public float AngleRad { get; set; }
+            public float RelativeAngle { get; set; }
+            public float Distance { get; set; }
 
             public Vector2 PositionOriginal { get; }
             public Vector2 PositionRandomised { get; set; }
@@ -299,7 +323,6 @@ namespace osu.Game.Rulesets.Osu.Mods
             {
                 PositionRandomised = PositionOriginal = hitObject.Position;
                 EndPositionRandomised = EndPositionOriginal = hitObject.EndPosition;
-                AngleRad = 0;
             }
         }
     }

From 8cfeffc085def6f9f063b3c6d7bf75e78e864bc7 Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Tue, 8 Mar 2022 11:50:30 +0800
Subject: [PATCH 3278/5547] Extract a major part of `ApplyToBeatmap` to a new
 method

---
 osu.Game.Rulesets.Osu/Mods/OsuModRandom.cs | 103 +++++++++++----------
 1 file changed, 54 insertions(+), 49 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModRandom.cs b/osu.Game.Rulesets.Osu/Mods/OsuModRandom.cs
index 1d0442438e..76183fe0aa 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModRandom.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModRandom.cs
@@ -47,54 +47,7 @@ namespace osu.Game.Rulesets.Osu.Mods
 
             var randomObjects = randomiseObjects(hitObjects);
 
-            RandomObjectInfo previous = null;
-
-            for (int i = 0; i < hitObjects.Count; i++)
-            {
-                var hitObject = hitObjects[i];
-
-                var current = randomObjects[i];
-
-                if (hitObject is Spinner)
-                {
-                    previous = null;
-                    continue;
-                }
-
-                applyRandomisation(getAbsoluteAngle(hitObjects, i - 1), previous, current);
-
-                // Move hit objects back into the playfield if they are outside of it
-                Vector2 shift = Vector2.Zero;
-
-                switch (hitObject)
-                {
-                    case HitCircle circle:
-                        shift = clampHitCircleToPlayfield(circle, current);
-                        break;
-
-                    case Slider slider:
-                        shift = clampSliderToPlayfield(slider, current);
-                        break;
-                }
-
-                if (shift != Vector2.Zero)
-                {
-                    var toBeShifted = new List<OsuHitObject>();
-
-                    for (int j = i - 1; j >= i - preceding_hitobjects_to_shift && j >= 0; j--)
-                    {
-                        // only shift hit circles
-                        if (!(hitObjects[j] is HitCircle)) break;
-
-                        toBeShifted.Add(hitObjects[j]);
-                    }
-
-                    if (toBeShifted.Count > 0)
-                        applyDecreasingShift(toBeShifted, shift);
-                }
-
-                previous = current;
-            }
+            applyRandomisation(hitObjects, randomObjects);
         }
 
         private List<RandomObjectInfo> randomiseObjects(IEnumerable<OsuHitObject> hitObjects)
@@ -136,6 +89,58 @@ namespace osu.Game.Rulesets.Osu.Mods
             return randomObjects;
         }
 
+        private void applyRandomisation(IReadOnlyList<OsuHitObject> hitObjects, IReadOnlyList<RandomObjectInfo> randomObjects)
+        {
+            RandomObjectInfo previous = null;
+
+            for (int i = 0; i < hitObjects.Count; i++)
+            {
+                var hitObject = hitObjects[i];
+
+                var current = randomObjects[i];
+
+                if (hitObject is Spinner)
+                {
+                    previous = null;
+                    continue;
+                }
+
+                computeRandomisedPosition(getAbsoluteAngle(hitObjects, i - 1), previous, current);
+
+                // Move hit objects back into the playfield if they are outside of it
+                Vector2 shift = Vector2.Zero;
+
+                switch (hitObject)
+                {
+                    case HitCircle circle:
+                        shift = clampHitCircleToPlayfield(circle, current);
+                        break;
+
+                    case Slider slider:
+                        shift = clampSliderToPlayfield(slider, current);
+                        break;
+                }
+
+                if (shift != Vector2.Zero)
+                {
+                    var toBeShifted = new List<OsuHitObject>();
+
+                    for (int j = i - 1; j >= i - preceding_hitobjects_to_shift && j >= 0; j--)
+                    {
+                        // only shift hit circles
+                        if (!(hitObjects[j] is HitCircle)) break;
+
+                        toBeShifted.Add(hitObjects[j]);
+                    }
+
+                    if (toBeShifted.Count > 0)
+                        applyDecreasingShift(toBeShifted, shift);
+                }
+
+                previous = current;
+            }
+        }
+
         private float getAbsoluteAngle(IReadOnlyList<OsuHitObject> hitObjects, int hitObjectIndex)
         {
             if (hitObjectIndex < 0) return 0;
@@ -149,7 +154,7 @@ namespace osu.Game.Rulesets.Osu.Mods
         /// Returns the final position of the hit object
         /// </summary>
         /// <returns>Final position of the hit object</returns>
-        private void applyRandomisation(float previousAbsoluteAngle, RandomObjectInfo previous, RandomObjectInfo current)
+        private void computeRandomisedPosition(float previousAbsoluteAngle, RandomObjectInfo previous, RandomObjectInfo current)
         {
             float absoluteAngle = previousAbsoluteAngle + current.RelativeAngle;
 

From ae1c65c38dfd48e57be107f31da80ac7be62db5f Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Tue, 8 Mar 2022 12:07:10 +0800
Subject: [PATCH 3279/5547] Add xmldoc

---
 osu.Game.Rulesets.Osu/Mods/OsuModRandom.cs | 39 ++++++++++++++++++++--
 1 file changed, 37 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModRandom.cs b/osu.Game.Rulesets.Osu/Mods/OsuModRandom.cs
index 76183fe0aa..babc4311ee 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModRandom.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModRandom.cs
@@ -50,6 +50,11 @@ namespace osu.Game.Rulesets.Osu.Mods
             applyRandomisation(hitObjects, randomObjects);
         }
 
+        /// <summary>
+        /// Randomise the position of each hit object and return a list of <see cref="RandomObjectInfo"/>s describing how each hit object should be placed.
+        /// </summary>
+        /// <param name="hitObjects">A list of <see cref="OsuHitObject"/>s to have their positions randomised.</param>
+        /// <returns>A list of <see cref="RandomObjectInfo"/>s describing how each hit object should be placed.</returns>
         private List<RandomObjectInfo> randomiseObjects(IEnumerable<OsuHitObject> hitObjects)
         {
             var randomObjects = new List<RandomObjectInfo>();
@@ -89,6 +94,11 @@ namespace osu.Game.Rulesets.Osu.Mods
             return randomObjects;
         }
 
+        /// <summary>
+        /// Reposition the hit objects according to the information in <paramref name="randomObjects"/>.
+        /// </summary>
+        /// <param name="hitObjects">The hit objects to be repositioned.</param>
+        /// <param name="randomObjects">A list of <see cref="RandomObjectInfo"/> describing how each hit object should be placed.</param>
         private void applyRandomisation(IReadOnlyList<OsuHitObject> hitObjects, IReadOnlyList<RandomObjectInfo> randomObjects)
         {
             RandomObjectInfo previous = null;
@@ -141,6 +151,12 @@ namespace osu.Game.Rulesets.Osu.Mods
             }
         }
 
+        /// <summary>
+        /// Get the absolute angle of a vector pointing from the previous hit object to the one denoted by <paramref name="hitObjectIndex"/>.
+        /// </summary>
+        /// <param name="hitObjects">A list of all hit objects in the beatmap.</param>
+        /// <param name="hitObjectIndex">The hit object that the vector should point to.</param>
+        /// <returns>The absolute angle of the aforementioned vector.</returns>
         private float getAbsoluteAngle(IReadOnlyList<OsuHitObject> hitObjects, int hitObjectIndex)
         {
             if (hitObjectIndex < 0) return 0;
@@ -151,9 +167,11 @@ namespace osu.Game.Rulesets.Osu.Mods
         }
 
         /// <summary>
-        /// Returns the final position of the hit object
+        /// Compute the randomised position of a hit object while attempting to keep it inside the playfield.
         /// </summary>
-        /// <returns>Final position of the hit object</returns>
+        /// <param name="previousAbsoluteAngle">The direction of movement of the player's cursor before it starts to approach the current hit object.</param>
+        /// <param name="previous">The <see cref="RandomObjectInfo"/> representing the hit object immediately preceding the current one.</param>
+        /// <param name="current">The <see cref="RandomObjectInfo"/> representing the hit object to have the randomised position computed for.</param>
         private void computeRandomisedPosition(float previousAbsoluteAngle, RandomObjectInfo previous, RandomObjectInfo current)
         {
             float absoluteAngle = previousAbsoluteAngle + current.RelativeAngle;
@@ -315,7 +333,24 @@ namespace osu.Game.Rulesets.Osu.Mods
 
         private class RandomObjectInfo
         {
+            /// <summary>
+            /// The jump angle from the previous hit object to this one, relative to the previous hit object's jump angle.
+            /// </summary>
+            /// <remarks>
+            /// <see cref="RelativeAngle"/> of the first hit object in a beatmap represents the absolute angle from playfield center to the object.
+            /// </remarks>
+            /// <example>
+            /// If <see cref="RelativeAngle"/> is 0, the player's cursor doesn't need to change its direction of movement when passing
+            /// the previous object to reach this one.
+            /// </example>
             public float RelativeAngle { get; set; }
+
+            /// <summary>
+            /// The jump distance from the previous hit object to this one.
+            /// </summary>
+            /// <remarks>
+            /// <see cref="Distance"/> of the first hit object in a beatmap is relative to the playfield center.
+            /// </remarks>
             public float Distance { get; set; }
 
             public Vector2 PositionOriginal { get; }

From 2a55c5e02e6ddebe06ece01d067d037fc057a785 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 8 Mar 2022 14:42:59 +0900
Subject: [PATCH 3280/5547] Add extension method to detect and isolate realm
 collection-level changes

---
 .../RealmSubscriptionRegistrationTests.cs     | 59 ++++++++++++++++++-
 osu.Game/Database/RealmExtensions.cs          | 11 ++++
 2 files changed, 68 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Database/RealmSubscriptionRegistrationTests.cs b/osu.Game.Tests/Database/RealmSubscriptionRegistrationTests.cs
index 363a189f6e..d99bcc092d 100644
--- a/osu.Game.Tests/Database/RealmSubscriptionRegistrationTests.cs
+++ b/osu.Game.Tests/Database/RealmSubscriptionRegistrationTests.cs
@@ -1,25 +1,80 @@
 // 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 enable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
+using System.Threading;
 using System.Threading.Tasks;
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Extensions;
 using osu.Game.Beatmaps;
+using osu.Game.Database;
 using osu.Game.Rulesets;
 using osu.Game.Tests.Resources;
 using Realms;
 
-#nullable enable
-
 namespace osu.Game.Tests.Database
 {
     [TestFixture]
     public class RealmSubscriptionRegistrationTests : RealmTest
     {
+        [Test]
+        public void TestSubscriptionCollectionAndPropertyChanges()
+        {
+            int collectionChanges = 0;
+            int propertyChanges = 0;
+
+            ChangeSet? lastChanges = null;
+
+            RunTestWithRealm((realm, _) =>
+            {
+                var registration = realm.RegisterForNotifications(r => r.All<BeatmapSetInfo>(), onChanged);
+
+                realm.Run(r => r.Refresh());
+
+                realm.Write(r => r.Add(TestResources.CreateTestBeatmapSetInfo()));
+                realm.Run(r => r.Refresh());
+
+                Assert.That(collectionChanges, Is.EqualTo(1));
+                Assert.That(propertyChanges, Is.EqualTo(0));
+                Assert.That(lastChanges?.InsertedIndices, Has.One.Items);
+                Assert.That(lastChanges?.ModifiedIndices, Is.Empty);
+                Assert.That(lastChanges?.NewModifiedIndices, Is.Empty);
+
+                realm.Write(r => r.All<BeatmapSetInfo>().First().Beatmaps.First().CountdownOffset = 5);
+                realm.Run(r => r.Refresh());
+
+                Assert.That(collectionChanges, Is.EqualTo(1));
+                Assert.That(propertyChanges, Is.EqualTo(1));
+                Assert.That(lastChanges?.InsertedIndices, Is.Empty);
+                Assert.That(lastChanges?.ModifiedIndices, Has.One.Items);
+                Assert.That(lastChanges?.NewModifiedIndices, Has.One.Items);
+
+                registration.Dispose();
+            });
+
+            void onChanged(IRealmCollection<BeatmapSetInfo> sender, ChangeSet? changes, Exception error)
+            {
+                lastChanges = changes;
+
+                if (changes == null)
+                    return;
+
+                if (changes.HasCollectionChanges())
+                {
+                    Interlocked.Increment(ref collectionChanges);
+                }
+                else
+                {
+                    Interlocked.Increment(ref propertyChanges);
+                }
+            }
+        }
+
         [Test]
         public void TestSubscriptionWithAsyncWrite()
         {
diff --git a/osu.Game/Database/RealmExtensions.cs b/osu.Game/Database/RealmExtensions.cs
index e6f3dba39f..551b84f7b6 100644
--- a/osu.Game/Database/RealmExtensions.cs
+++ b/osu.Game/Database/RealmExtensions.cs
@@ -4,6 +4,8 @@
 using System;
 using Realms;
 
+#nullable enable
+
 namespace osu.Game.Database
 {
     public static class RealmExtensions
@@ -22,5 +24,14 @@ namespace osu.Game.Database
             transaction.Commit();
             return result;
         }
+
+        /// <summary>
+        /// Whether the provided change set has changes to the top level collection.
+        /// </summary>
+        /// <remarks>
+        /// Realm subscriptions fire on both collection and property changes (including *all* nested properties).
+        /// Quite often we only care about changes at a collection level. This can be used to guard and early-return when no such changes are in a callback.
+        /// </remarks>
+        public static bool HasCollectionChanges(this ChangeSet changes) => changes.InsertedIndices.Length > 0 || changes.DeletedIndices.Length > 0 || changes.Moves.Length > 0;
     }
 }

From 622ec531300f0369f37e711936b2dcec56601b72 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 8 Mar 2022 14:43:14 +0900
Subject: [PATCH 3281/5547] Fix `BeatmapLeaderboard` refreshing on unrelated
 changes to a beatmap

---
 osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
index eb0addd377..8d1654eb1d 100644
--- a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
+++ b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
@@ -191,6 +191,11 @@ namespace osu.Game.Screens.Select.Leaderboards
                 if (cancellationToken.IsCancellationRequested)
                     return;
 
+                // This subscription may fire from changes to linked beatmaps, which we don't care about.
+                // It's currently not possible for a score to be modified after insertion, so we can safely ignore callbacks with only modifications.
+                if (changes?.HasCollectionChanges() == false)
+                    return;
+
                 var scores = sender.AsEnumerable();
 
                 if (filterMods && !mods.Value.Any())

From 589a40ca2d48cb14da5e859c3d6669337eb0910c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 8 Mar 2022 17:58:37 +0900
Subject: [PATCH 3282/5547] Add `EnumMember` naming to `HitResult` to allow for
 correct json serialisation

---
 osu.Game/Rulesets/Scoring/HitResult.cs | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/osu.Game/Rulesets/Scoring/HitResult.cs b/osu.Game/Rulesets/Scoring/HitResult.cs
index a254f9b760..68a03fa061 100644
--- a/osu.Game/Rulesets/Scoring/HitResult.cs
+++ b/osu.Game/Rulesets/Scoring/HitResult.cs
@@ -5,6 +5,7 @@ using System;
 using System.ComponentModel;
 using System.Diagnostics;
 using System.Linq;
+using System.Runtime.Serialization;
 using osu.Framework.Utils;
 
 namespace osu.Game.Rulesets.Scoring
@@ -16,6 +17,7 @@ namespace osu.Game.Rulesets.Scoring
         /// Indicates that the object has not been judged yet.
         /// </summary>
         [Description(@"")]
+        [EnumMember(Value = "none")]
         [Order(14)]
         None,
 
@@ -27,32 +29,39 @@ namespace osu.Game.Rulesets.Scoring
         /// "too far in the future). It should also define when a forced miss should be triggered (as a result of no user input in time).
         /// </remarks>
         [Description(@"Miss")]
+        [EnumMember(Value = "miss")]
         [Order(5)]
         Miss,
 
         [Description(@"Meh")]
+        [EnumMember(Value = "meh")]
         [Order(4)]
         Meh,
 
         [Description(@"OK")]
+        [EnumMember(Value = "ok")]
         [Order(3)]
         Ok,
 
         [Description(@"Good")]
+        [EnumMember(Value = "good")]
         [Order(2)]
         Good,
 
         [Description(@"Great")]
+        [EnumMember(Value = "great")]
         [Order(1)]
         Great,
 
         [Description(@"Perfect")]
+        [EnumMember(Value = "perfect")]
         [Order(0)]
         Perfect,
 
         /// <summary>
         /// Indicates small tick miss.
         /// </summary>
+        [EnumMember(Value = "small_tick_miss")]
         [Order(11)]
         SmallTickMiss,
 
@@ -60,12 +69,14 @@ namespace osu.Game.Rulesets.Scoring
         /// Indicates a small tick hit.
         /// </summary>
         [Description(@"S Tick")]
+        [EnumMember(Value = "small_tick_hit")]
         [Order(7)]
         SmallTickHit,
 
         /// <summary>
         /// Indicates a large tick miss.
         /// </summary>
+        [EnumMember(Value = "large_tick_miss")]
         [Order(10)]
         LargeTickMiss,
 
@@ -73,6 +84,7 @@ namespace osu.Game.Rulesets.Scoring
         /// Indicates a large tick hit.
         /// </summary>
         [Description(@"L Tick")]
+        [EnumMember(Value = "large_tick_hit")]
         [Order(6)]
         LargeTickHit,
 
@@ -80,6 +92,7 @@ namespace osu.Game.Rulesets.Scoring
         /// Indicates a small bonus.
         /// </summary>
         [Description("S Bonus")]
+        [EnumMember(Value = "small_bonus")]
         [Order(9)]
         SmallBonus,
 
@@ -87,18 +100,21 @@ namespace osu.Game.Rulesets.Scoring
         /// Indicates a large bonus.
         /// </summary>
         [Description("L Bonus")]
+        [EnumMember(Value = "large_bonus")]
         [Order(8)]
         LargeBonus,
 
         /// <summary>
         /// Indicates a miss that should be ignored for scoring purposes.
         /// </summary>
+        [EnumMember(Value = "ignore_miss")]
         [Order(13)]
         IgnoreMiss,
 
         /// <summary>
         /// Indicates a hit that should be ignored for scoring purposes.
         /// </summary>
+        [EnumMember(Value = "ignore_hit")]
         [Order(12)]
         IgnoreHit,
     }

From 9a347af5c79e5f57decfa6be8a420a7f4ef6872e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 8 Mar 2022 17:58:52 +0900
Subject: [PATCH 3283/5547] Add test coverage of `SubmittableScore`
 serialisation to (roughly) match spec

---
 .../TestSubmittableScoreJsonSerialization.cs  | 40 +++++++++++++++++++
 1 file changed, 40 insertions(+)
 create mode 100644 osu.Game.Tests/Online/TestSubmittableScoreJsonSerialization.cs

diff --git a/osu.Game.Tests/Online/TestSubmittableScoreJsonSerialization.cs b/osu.Game.Tests/Online/TestSubmittableScoreJsonSerialization.cs
new file mode 100644
index 0000000000..662660bce4
--- /dev/null
+++ b/osu.Game.Tests/Online/TestSubmittableScoreJsonSerialization.cs
@@ -0,0 +1,40 @@
+// 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;
+using NUnit.Framework;
+using osu.Game.IO.Serialization;
+using osu.Game.Online.Solo;
+using osu.Game.Tests.Resources;
+
+namespace osu.Game.Tests.Online
+{
+    /// <summary>
+    /// Basic testing to ensure our attribute-based naming is correctly working.
+    /// </summary>
+    [TestFixture]
+    public class TestSubmittableScoreJsonSerialization
+    {
+        [Test]
+        public void TestScoreSerialisationViaExtensionMethod()
+        {
+            var score = new SubmittableScore(TestResources.CreateTestScoreInfo());
+
+            string serialised = score.Serialize();
+
+            Assert.That(serialised, Contains.Substring("large_tick_hit"));
+            Assert.That(serialised, Contains.Substring("\"rank\": \"S\""));
+        }
+
+        [Test]
+        public void TestScoreSerialisationWithoutSettings()
+        {
+            var score = new SubmittableScore(TestResources.CreateTestScoreInfo());
+
+            string serialised = JsonConvert.SerializeObject(score);
+
+            Assert.That(serialised, Contains.Substring("large_tick_hit"));
+            Assert.That(serialised, Contains.Substring("\"rank\":\"S\""));
+        }
+    }
+}

From 0718a55ad0d86e9c5715f67499b6f8b8e2b9f5d0 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 8 Mar 2022 16:06:42 +0900
Subject: [PATCH 3284/5547] Add flow to allow recovery after running an older
 release (with a different realm database version)

As brought up in https://github.com/ppy/osu/discussions/17148
---
 osu.Game/Database/RealmAccess.cs | 86 +++++++++++++++++++++++++++++---
 1 file changed, 79 insertions(+), 7 deletions(-)

diff --git a/osu.Game/Database/RealmAccess.cs b/osu.Game/Database/RealmAccess.cs
index af7c485c57..e7ca045702 100644
--- a/osu.Game/Database/RealmAccess.cs
+++ b/osu.Game/Database/RealmAccess.cs
@@ -105,6 +105,8 @@ namespace osu.Game.Database
 
         public Realm Realm => ensureUpdateRealm();
 
+        private const string realm_extension = @".realm";
+
         private Realm ensureUpdateRealm()
         {
             if (isSendingNotificationResetEvents)
@@ -149,11 +151,18 @@ namespace osu.Game.Database
 
             Filename = filename;
 
-            const string realm_extension = @".realm";
-
             if (!Filename.EndsWith(realm_extension, StringComparison.Ordinal))
                 Filename += realm_extension;
 
+            string newerVersionFilename = $"{Filename.Replace(realm_extension, string.Empty)}_newer_version{realm_extension}";
+
+            // Attempt to recover a newer database version if available.
+            if (storage.Exists(newerVersionFilename))
+            {
+                Logger.Log(@"A newer realm database has been found, attempting recovery...", LoggingTarget.Database);
+                attemptRecoverFromFile(newerVersionFilename);
+            }
+
             try
             {
                 // This method triggers the first `getRealmInstance` call, which will implicitly run realm migrations and bring the schema up-to-date.
@@ -161,15 +170,78 @@ namespace osu.Game.Database
             }
             catch (Exception e)
             {
-                Logger.Error(e, "Realm startup failed with unrecoverable error; starting with a fresh database. A backup of your database has been made.");
+                // See https://github.com/realm/realm-core/blob/master/src%2Frealm%2Fobject-store%2Fobject_store.cpp#L1016-L1022
+                // This is the best way we can detect a schema version downgrade.
+                if (e.Message.StartsWith(@"Provided schema version", StringComparison.Ordinal))
+                {
+                    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.");
 
-                CreateBackup($"{Filename.Replace(realm_extension, string.Empty)}_{DateTimeOffset.UtcNow.ToUnixTimeSeconds()}_corrupt{realm_extension}");
-                storage.Delete(Filename);
+                    // 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 (!storage.Exists(newerVersionFilename))
+                        CreateBackup(newerVersionFilename);
+
+                    storage.Delete(Filename);
+                }
+                else
+                {
+                    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}");
+                    storage.Delete(Filename);
+                }
 
                 cleanupPendingDeletions();
             }
         }
 
+        private void attemptRecoverFromFile(string recoveryFilename)
+        {
+            Logger.Log($@"Performing recovery from {recoveryFilename}", LoggingTarget.Database);
+
+            // First check the user hasn't started to use the database that is in place..
+            try
+            {
+                using (var realm = Realm.GetInstance(getConfiguration()))
+                {
+                    if (realm.All<ScoreInfo>().Any())
+                    {
+                        Logger.Log(@"Recovery aborted as the existing database has scores set already.", LoggingTarget.Database);
+                        Logger.Log(@"To perform recovery, delete client.realm while osu! is not running.", LoggingTarget.Database);
+                        return;
+                    }
+                }
+            }
+            catch
+            {
+                // Even if reading the in place database fails, still attempt to recover.
+            }
+
+            // Then check that the database we are about to attempt recovery can actually be recovered on this version..
+            try
+            {
+                using (var realm = Realm.GetInstance(getConfiguration(recoveryFilename)))
+                {
+                    // Don't need to do anything, just check that opening the realm works correctly.
+                }
+            }
+            catch
+            {
+                Logger.Log(@"Recovery aborted as the newer version could not be loaded by this osu! version.", LoggingTarget.Database);
+                return;
+            }
+
+            // For extra safety, also store the temporarily-used database which we are about to replace.
+            CreateBackup($"{Filename.Replace(realm_extension, string.Empty)}_{DateTimeOffset.UtcNow.ToUnixTimeSeconds()}_newer_version_before_recovery{realm_extension}");
+
+            storage.Delete(Filename);
+
+            using (var inputStream = storage.GetStream(recoveryFilename))
+            using (var outputStream = storage.GetStream(Filename, FileAccess.Write, FileMode.Create))
+                inputStream.CopyTo(outputStream);
+
+            storage.Delete(recoveryFilename);
+            Logger.Log(@"Recovery complete!", LoggingTarget.Database);
+        }
+
         private void cleanupPendingDeletions()
         {
             using (var realm = getRealmInstance())
@@ -476,7 +548,7 @@ namespace osu.Game.Database
             }
         }
 
-        private RealmConfiguration getConfiguration()
+        private RealmConfiguration getConfiguration(string? filename = null)
         {
             // This is currently the only usage of temporary files at the osu! side.
             // If we use the temporary folder in more situations in the future, this should be moved to a higher level (helper method or OsuGameBase).
@@ -484,7 +556,7 @@ namespace osu.Game.Database
             if (!Directory.Exists(tempPathLocation))
                 Directory.CreateDirectory(tempPathLocation);
 
-            return new RealmConfiguration(storage.GetFullPath(Filename, true))
+            return new RealmConfiguration(storage.GetFullPath(filename ?? Filename, true))
             {
                 SchemaVersion = schema_version,
                 MigrationCallback = onMigration,

From a172fc6cb8eb212a17a586279656ceacfac4efd5 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 8 Mar 2022 18:19:11 +0900
Subject: [PATCH 3285/5547] Add IsBasic() and IsTick() extensions on HitResult

---
 osu.Game/Rulesets/Scoring/HitResult.cs | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/osu.Game/Rulesets/Scoring/HitResult.cs b/osu.Game/Rulesets/Scoring/HitResult.cs
index a254f9b760..ddddf70cc6 100644
--- a/osu.Game/Rulesets/Scoring/HitResult.cs
+++ b/osu.Game/Rulesets/Scoring/HitResult.cs
@@ -133,6 +133,30 @@ namespace osu.Game.Rulesets.Scoring
         public static bool AffectsAccuracy(this HitResult result)
             => IsScorable(result) && !IsBonus(result);
 
+        /// <summary>
+        /// Whether a <see cref="HitResult"/> is a non-tick and non-bonus result.
+        /// </summary>
+        public static bool IsBasic(this HitResult result)
+            => IsScorable(result) && !IsTick(result) && !IsBonus(result);
+
+        /// <summary>
+        /// Whether a <see cref="HitResult"/> should be counted as a tick.
+        /// </summary>
+        public static bool IsTick(this HitResult result)
+        {
+            switch (result)
+            {
+                case HitResult.LargeTickHit:
+                case HitResult.LargeTickMiss:
+                case HitResult.SmallTickHit:
+                case HitResult.SmallTickMiss:
+                    return true;
+
+                default:
+                    return false;
+            }
+        }
+
         /// <summary>
         /// Whether a <see cref="HitResult"/> should be counted as bonus score.
         /// </summary>

From 6565c95b176a8808cd3d8fd1987e31bdbae3952a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 8 Mar 2022 18:19:54 +0900
Subject: [PATCH 3286/5547] Remove unused variable

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

diff --git a/osu.Game/Database/RealmAccess.cs b/osu.Game/Database/RealmAccess.cs
index e7ca045702..f0d4011ab8 100644
--- a/osu.Game/Database/RealmAccess.cs
+++ b/osu.Game/Database/RealmAccess.cs
@@ -218,7 +218,7 @@ namespace osu.Game.Database
             // Then check that the database we are about to attempt recovery can actually be recovered on this version..
             try
             {
-                using (var realm = Realm.GetInstance(getConfiguration(recoveryFilename)))
+                using (Realm.GetInstance(getConfiguration(recoveryFilename)))
                 {
                     // Don't need to do anything, just check that opening the realm works correctly.
                 }

From b0f40d9e4562898a488cdd3b643553aa7099a4e0 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 8 Mar 2022 18:38:24 +0900
Subject: [PATCH 3287/5547] Remove `user` from `SubmittableScore`

This wasn't being used by osu-web, and included far too much unnecessary
data. Of note, `pp` and `ruleset_id` are also not strictly required, but
there's no harm in sending them so I've left them be for now.
---
 osu.Game/Online/Solo/SubmittableScore.cs | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/osu.Game/Online/Solo/SubmittableScore.cs b/osu.Game/Online/Solo/SubmittableScore.cs
index 4e4dae5157..9b6da1844a 100644
--- a/osu.Game/Online/Solo/SubmittableScore.cs
+++ b/osu.Game/Online/Solo/SubmittableScore.cs
@@ -46,9 +46,6 @@ namespace osu.Game.Online.Solo
         [JsonProperty("mods")]
         public APIMod[] Mods { get; set; }
 
-        [JsonProperty("user")]
-        public APIUser User { get; set; }
-
         [JsonProperty("statistics")]
         public Dictionary<HitResult, int> Statistics { get; set; }
 
@@ -67,7 +64,6 @@ namespace osu.Game.Online.Solo
             RulesetID = score.RulesetID;
             Passed = score.Passed;
             Mods = score.APIMods;
-            User = score.User;
             Statistics = score.Statistics;
         }
     }

From f5cd9676353c9bdcd6c6a30d0069612e36528cc2 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 8 Mar 2022 19:07:39 +0900
Subject: [PATCH 3288/5547] Fix scores not being recalculated in beatmap
 listing

---
 osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.cs | 3 ++-
 osu.Game/Scoring/ScoreManager.cs                       | 2 +-
 2 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.cs b/osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.cs
index 00dedc892b..6f07b20049 100644
--- a/osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.cs
+++ b/osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.cs
@@ -79,7 +79,8 @@ namespace osu.Game.Overlays.BeatmapSet.Scores
                 var beatmapInfo = new BeatmapInfo
                 {
                     MaxCombo = apiBeatmap.MaxCombo,
-                    Status = apiBeatmap.Status
+                    Status = apiBeatmap.Status,
+                    MD5Hash = apiBeatmap.MD5Hash
                 };
 
                 scoreManager.OrderByTotalScoreAsync(value.Scores.Select(s => s.CreateScoreInfo(rulesets, beatmapInfo)).ToArray(), loadCancellationSource.Token)
diff --git a/osu.Game/Scoring/ScoreManager.cs b/osu.Game/Scoring/ScoreManager.cs
index 963c4a77ca..87345a06fb 100644
--- a/osu.Game/Scoring/ScoreManager.cs
+++ b/osu.Game/Scoring/ScoreManager.cs
@@ -132,7 +132,7 @@ namespace osu.Game.Scoring
         public async Task<long> GetTotalScoreAsync([NotNull] ScoreInfo score, ScoringMode mode = ScoringMode.Standardised, CancellationToken cancellationToken = default)
         {
             // TODO: This is required for playlist aggregate scores. They should likely not be getting here in the first place.
-            if (string.IsNullOrEmpty(score.BeatmapInfo.Hash))
+            if (string.IsNullOrEmpty(score.BeatmapInfo.MD5Hash))
                 return score.TotalScore;
 
             int beatmapMaxCombo;

From daa42584f43214c8e0939b512bf00d59b785704b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 8 Mar 2022 19:36:08 +0900
Subject: [PATCH 3289/5547] Fix feedback from realm writes causing offset
 slider to jump around

---
 .../Play/PlayerSettings/BeatmapOffsetControl.cs   | 15 ++++++++++++---
 1 file changed, 12 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs b/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
index c00b2f56dc..d4babe3e9f 100644
--- a/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
+++ b/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.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.
 
+#nullable enable
+
 using System;
 using System.Diagnostics;
 using System.Linq;
@@ -23,8 +25,6 @@ using osu.Game.Scoring;
 using osu.Game.Screens.Ranking.Statistics;
 using osuTK;
 
-#nullable enable
-
 namespace osu.Game.Screens.Play.PlayerSettings
 {
     public class BeatmapOffsetControl : CompositeDrawable
@@ -122,7 +122,16 @@ namespace osu.Game.Screens.Play.PlayerSettings
             beatmapOffsetSubscription = realm.SubscribeToPropertyChanged(
                 r => r.Find<BeatmapInfo>(beatmap.Value.BeatmapInfo.ID)?.UserSettings,
                 settings => settings.Offset,
-                val => Current.Value = val);
+                val =>
+                {
+                    // At the point we reach here, it's not guaranteed that all realm writes have taken place (there may be some in-flight).
+                    // We are only aware of writes that originated from our own flow, so if we do see one that's active we can avoid handling the feedback value arriving.
+                    if (realmWriteTask == null)
+                        Current.Value = val;
+
+                    // we can also mark any in-flight write that is managed locally as "seen" and start handling any incoming changes again.
+                    realmWriteTask = null;
+                });
 
             Current.BindValueChanged(currentChanged);
         }

From 960b6528cad6209f20180f84586940ec9d8cc79f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 8 Mar 2022 19:36:23 +0900
Subject: [PATCH 3290/5547] Ensure the value used during realm async write is
 the same as whe compared for equality

---
 .../Screens/Play/PlayerSettings/BeatmapOffsetControl.cs     | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs b/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
index d4babe3e9f..9e280fdca2 100644
--- a/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
+++ b/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
@@ -167,10 +167,12 @@ namespace osu.Game.Screens.Play.PlayerSettings
                     if (settings == null) // only the case for tests.
                         return;
 
-                    if (settings.Offset == Current.Value)
+                    double val = Current.Value;
+
+                    if (settings.Offset == val)
                         return;
 
-                    settings.Offset = Current.Value;
+                    settings.Offset = val;
                 });
             }
         }

From d13a66a96cb147a7dba1fdbfa1be75f8533440e7 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 8 Mar 2022 20:11:56 +0900
Subject: [PATCH 3291/5547] Rework test scene by only relying on OnlineID

---
 .../TestScenePlaylistsResultsScreen.cs        | 76 +++++--------------
 1 file changed, 21 insertions(+), 55 deletions(-)

diff --git a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsResultsScreen.cs b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsResultsScreen.cs
index 161624413d..67894bab38 100644
--- a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsResultsScreen.cs
+++ b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsResultsScreen.cs
@@ -33,16 +33,25 @@ namespace osu.Game.Tests.Visual.Playlists
 
         private TestResultsScreen resultsScreen;
 
-        private int currentScoreId;
+        private int lowestScoreId; // Score ID of the lowest score in the list.
+        private int highestScoreId; // Score ID of the highest score in the list.
+
         private bool requestComplete;
         private int totalCount;
+        private ScoreInfo userScore;
 
         [SetUp]
         public void Setup() => Schedule(() =>
         {
-            currentScoreId = 1;
+            lowestScoreId = 1;
+            highestScoreId = 1;
             requestComplete = false;
             totalCount = 0;
+
+            userScore = TestResources.CreateTestScoreInfo();
+            userScore.TotalScore = 0;
+            userScore.Statistics = new Dictionary<HitResult, int>();
+
             bindHandler();
 
             // beatmap is required to be an actual beatmap so the scores can get their scores correctly calculated for standardised scoring.
@@ -53,15 +62,7 @@ namespace osu.Game.Tests.Visual.Playlists
         [Test]
         public void TestShowWithUserScore()
         {
-            ScoreInfo userScore = null;
-
-            AddStep("bind user score info handler", () =>
-            {
-                userScore = TestResources.CreateTestScoreInfo();
-                userScore.OnlineID = currentScoreId++;
-
-                bindHandler(userScore: userScore);
-            });
+            AddStep("bind user score info handler", () => bindHandler(userScore: userScore));
 
             createResults(() => userScore);
 
@@ -81,15 +82,7 @@ namespace osu.Game.Tests.Visual.Playlists
         [Test]
         public void TestShowUserScoreWithDelay()
         {
-            ScoreInfo userScore = null;
-
-            AddStep("bind user score info handler", () =>
-            {
-                userScore = TestResources.CreateTestScoreInfo();
-                userScore.OnlineID = currentScoreId++;
-
-                bindHandler(true, userScore);
-            });
+            AddStep("bind user score info handler", () => bindHandler(true, userScore));
 
             createResults(() => userScore);
 
@@ -124,7 +117,7 @@ namespace osu.Game.Tests.Visual.Playlists
                 AddAssert("right loading spinner shown", () => resultsScreen.RightSpinner.State.Value == Visibility.Visible);
                 waitForDisplay();
 
-                AddAssert($"count increased by {scores_per_result}", () => this.ChildrenOfType<ScorePanel>().Count() == beforePanelCount + scores_per_result);
+                AddAssert($"count increased by {scores_per_result}", () => this.ChildrenOfType<ScorePanel>().Count() >= beforePanelCount + scores_per_result);
                 AddAssert("right loading spinner hidden", () => resultsScreen.RightSpinner.State.Value == Visibility.Hidden);
             }
         }
@@ -132,15 +125,7 @@ namespace osu.Game.Tests.Visual.Playlists
         [Test]
         public void TestFetchWhenScrolledToTheLeft()
         {
-            ScoreInfo userScore = null;
-
-            AddStep("bind user score info handler", () =>
-            {
-                userScore = TestResources.CreateTestScoreInfo();
-                userScore.OnlineID = currentScoreId++;
-
-                bindHandler(userScore: userScore);
-            });
+            AddStep("bind user score info handler", () => bindHandler(userScore: userScore));
 
             createResults(() => userScore);
 
@@ -156,7 +141,7 @@ namespace osu.Game.Tests.Visual.Playlists
                 AddAssert("left loading spinner shown", () => resultsScreen.LeftSpinner.State.Value == Visibility.Visible);
                 waitForDisplay();
 
-                AddAssert($"count increased by {scores_per_result}", () => this.ChildrenOfType<ScorePanel>().Count() == beforePanelCount + scores_per_result);
+                AddAssert($"count increased by {scores_per_result}", () => this.ChildrenOfType<ScorePanel>().Count() >= beforePanelCount + scores_per_result);
                 AddAssert("left loading spinner hidden", () => resultsScreen.LeftSpinner.State.Value == Visibility.Hidden);
             }
         }
@@ -245,16 +230,13 @@ namespace osu.Game.Tests.Visual.Playlists
         {
             var multiplayerUserScore = new MultiplayerScore
             {
-                ID = (int)(userScore.OnlineID > 0 ? userScore.OnlineID : currentScoreId++),
+                ID = highestScoreId,
                 Accuracy = userScore.Accuracy,
-                EndedAt = userScore.Date,
                 Passed = userScore.Passed,
                 Rank = userScore.Rank,
                 Position = real_user_position,
                 MaxCombo = userScore.MaxCombo,
-                TotalScore = userScore.TotalScore,
                 User = userScore.User,
-                Statistics = userScore.Statistics,
                 ScoresAround = new MultiplayerScoresAround
                 {
                     Higher = new MultiplayerScores(),
@@ -268,38 +250,32 @@ namespace osu.Game.Tests.Visual.Playlists
             {
                 multiplayerUserScore.ScoresAround.Lower.Scores.Add(new MultiplayerScore
                 {
-                    ID = currentScoreId++,
+                    ID = --highestScoreId,
                     Accuracy = userScore.Accuracy,
-                    EndedAt = userScore.Date,
                     Passed = true,
                     Rank = userScore.Rank,
                     MaxCombo = userScore.MaxCombo,
-                    TotalScore = userScore.TotalScore - i,
                     User = new APIUser
                     {
                         Id = 2,
                         Username = $"peppy{i}",
                         CoverUrl = "https://osu.ppy.sh/images/headers/profile-covers/c3.jpg",
                     },
-                    Statistics = userScore.Statistics
                 });
 
                 multiplayerUserScore.ScoresAround.Higher.Scores.Add(new MultiplayerScore
                 {
-                    ID = currentScoreId++,
+                    ID = ++lowestScoreId,
                     Accuracy = userScore.Accuracy,
-                    EndedAt = userScore.Date,
                     Passed = true,
                     Rank = userScore.Rank,
                     MaxCombo = userScore.MaxCombo,
-                    TotalScore = userScore.TotalScore + i,
                     User = new APIUser
                     {
                         Id = 2,
                         Username = $"peppy{i}",
                         CoverUrl = "https://osu.ppy.sh/images/headers/profile-covers/c3.jpg",
                     },
-                    Statistics = userScore.Statistics
                 });
 
                 totalCount += 2;
@@ -315,33 +291,23 @@ namespace osu.Game.Tests.Visual.Playlists
         {
             var result = new IndexedMultiplayerScores();
 
-            long startTotalScore = req.Cursor?.Properties["total_score"].ToObject<long>() ?? 1000000;
             string sort = req.IndexParams?.Properties["sort"].ToObject<string>() ?? "score_desc";
 
             for (int i = 1; i <= scores_per_result; i++)
             {
                 result.Scores.Add(new MultiplayerScore
                 {
-                    ID = currentScoreId++,
+                    ID = sort == "score_asc" ? --highestScoreId : ++lowestScoreId,
                     Accuracy = 1,
-                    EndedAt = DateTimeOffset.Now,
                     Passed = true,
                     Rank = ScoreRank.X,
                     MaxCombo = 1000,
-                    TotalScore = startTotalScore + (sort == "score_asc" ? i : -i),
                     User = new APIUser
                     {
                         Id = 2,
                         Username = $"peppy{i}",
                         CoverUrl = "https://osu.ppy.sh/images/headers/profile-covers/c3.jpg",
                     },
-                    Statistics = new Dictionary<HitResult, int>
-                    {
-                        { HitResult.Miss, 1 },
-                        { HitResult.Meh, 50 },
-                        { HitResult.Good, 100 },
-                        { HitResult.Great, 300 }
-                    }
                 });
 
                 totalCount++;
@@ -367,7 +333,7 @@ namespace osu.Game.Tests.Visual.Playlists
             {
                 Properties = new Dictionary<string, JToken>
                 {
-                    { "sort", JToken.FromObject(scores.Scores[^1].TotalScore > scores.Scores[^2].TotalScore ? "score_asc" : "score_desc") }
+                    { "sort", JToken.FromObject(scores.Scores[^1].ID > scores.Scores[^2].ID ? "score_asc" : "score_desc") }
                 }
             };
         }

From c867068cae9fbf589327ed4616939b1e91c1a0a7 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 8 Mar 2022 21:15:14 +0900
Subject: [PATCH 3292/5547] Update framework

---
 osu.Android.props        | 2 +-
 osu.Game/osu.Game.csproj | 2 +-
 osu.iOS.props            | 4 ++--
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Android.props b/osu.Android.props
index 5b26b8f36e..c2788f9a48 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -52,7 +52,7 @@
   </ItemGroup>
   <ItemGroup>
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.304.0" />
-    <PackageReference Include="ppy.osu.Framework.Android" Version="2022.304.0" />
+    <PackageReference Include="ppy.osu.Framework.Android" Version="2022.308.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
     <!-- Realm needs to be directly referenced in all Xamarin projects, as it will not pull in its transitive dependencies otherwise. -->
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index d86fbc693e..14cb751958 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="10.9.0" />
-    <PackageReference Include="ppy.osu.Framework" Version="2022.304.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2022.308.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.304.0" />
     <PackageReference Include="Sentry" Version="3.14.0" />
     <PackageReference Include="SharpCompress" Version="0.30.1" />
diff --git a/osu.iOS.props b/osu.iOS.props
index c37692f0d8..e485c69096 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -61,7 +61,7 @@
     <Reference Include="System.Net.Http" />
   </ItemGroup>
   <ItemGroup Label="Package References">
-    <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.304.0" />
+    <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.308.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.304.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net6.0) -->
@@ -84,7 +84,7 @@
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="5.0.14" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.Core" Version="5.0.14" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
-    <PackageReference Include="ppy.osu.Framework" Version="2022.304.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2022.308.0" />
     <PackageReference Include="SharpCompress" Version="0.30.1" />
     <PackageReference Include="NUnit" Version="3.13.2" />
     <PackageReference Include="System.ComponentModel.Annotations" Version="5.0.0" />

From 2c382bd1d9acdad5fa0e9ba4d80f996c36d5044e Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 8 Mar 2022 11:26:07 +0900
Subject: [PATCH 3293/5547] Rename GetImmediateScore() as overload of
 GetScore()

---
 .../Rulesets/Scoring/ScoreProcessorTest.cs    |  2 +-
 .../PerformanceBreakdownCalculator.cs         |  2 +-
 osu.Game/Rulesets/Scoring/ScoreProcessor.cs   | 46 +++++++++----------
 .../HUD/MultiplayerGameplayLeaderboard.cs     |  2 +-
 4 files changed, 26 insertions(+), 26 deletions(-)

diff --git a/osu.Game.Tests/Rulesets/Scoring/ScoreProcessorTest.cs b/osu.Game.Tests/Rulesets/Scoring/ScoreProcessorTest.cs
index c6e7988543..e96ff1f7f1 100644
--- a/osu.Game.Tests/Rulesets/Scoring/ScoreProcessorTest.cs
+++ b/osu.Game.Tests/Rulesets/Scoring/ScoreProcessorTest.cs
@@ -300,7 +300,7 @@ namespace osu.Game.Tests.Rulesets.Scoring
                 HitObjects = { new TestHitObject(result) }
             });
 
-            Assert.That(scoreProcessor.GetImmediateScore(ScoringMode.Standardised, result.AffectsCombo() ? 1 : 0, statistic), Is.EqualTo(expectedScore).Within(0.5d));
+            Assert.That(scoreProcessor.GetScore(ScoringMode.Standardised, result.AffectsCombo() ? 1 : 0, statistic), Is.EqualTo(expectedScore).Within(0.5d));
         }
 
         private class TestJudgement : Judgement
diff --git a/osu.Game/Rulesets/Difficulty/PerformanceBreakdownCalculator.cs b/osu.Game/Rulesets/Difficulty/PerformanceBreakdownCalculator.cs
index 3d384f5914..dfb8066b28 100644
--- a/osu.Game/Rulesets/Difficulty/PerformanceBreakdownCalculator.cs
+++ b/osu.Game/Rulesets/Difficulty/PerformanceBreakdownCalculator.cs
@@ -65,7 +65,7 @@ namespace osu.Game.Rulesets.Difficulty
                 ScoreProcessor scoreProcessor = ruleset.CreateScoreProcessor();
                 scoreProcessor.HighestCombo.Value = perfectPlay.MaxCombo;
                 scoreProcessor.Mods.Value = perfectPlay.Mods;
-                perfectPlay.TotalScore = (long)scoreProcessor.GetImmediateScore(ScoringMode.Standardised, perfectPlay.MaxCombo, statistics);
+                perfectPlay.TotalScore = (long)scoreProcessor.GetScore(ScoringMode.Standardised, perfectPlay.MaxCombo, statistics);
 
                 // compute rank achieved
                 // default to SS, then adjust the rank with mods
diff --git a/osu.Game/Rulesets/Scoring/ScoreProcessor.cs b/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
index d5a5aa4592..af9b4db5ca 100644
--- a/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
+++ b/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
@@ -218,6 +218,29 @@ namespace osu.Game.Rulesets.Scoring
                 scoreResultCounts);
         }
 
+        /// <summary>
+        /// Given a minimal set of inputs, return the computed score for the tracked beatmap / mods combination, at the current point in time.
+        /// </summary>
+        /// <param name="mode">The <see cref="ScoringMode"/> to compute the total score in.</param>
+        /// <param name="maxCombo">The maximum combo achievable in the beatmap.</param>
+        /// <param name="statistics">Statistics to be used for calculating accuracy, bonus score, etc.</param>
+        /// <returns>The computed score for provided inputs.</returns>
+        public double GetScore(ScoringMode mode, int maxCombo, Dictionary<HitResult, int> statistics)
+        {
+            // calculate base score from statistics pairs
+            int computedBaseScore = 0;
+
+            foreach (var pair in statistics)
+            {
+                if (!pair.Key.AffectsAccuracy())
+                    continue;
+
+                computedBaseScore += Judgement.ToNumericResult(pair.Key) * pair.Value;
+            }
+
+            return GetScore(mode, calculateAccuracyRatio(computedBaseScore), calculateComboRatio(maxCombo), statistics);
+        }
+
         /// <summary>
         /// Computes the total score.
         /// </summary>
@@ -250,29 +273,6 @@ namespace osu.Game.Rulesets.Scoring
             }
         }
 
-        /// <summary>
-        /// Given a minimal set of inputs, return the computed score for the tracked beatmap / mods combination, at the current point in time.
-        /// </summary>
-        /// <param name="mode">The <see cref="ScoringMode"/> to compute the total score in.</param>
-        /// <param name="maxCombo">The maximum combo achievable in the beatmap.</param>
-        /// <param name="statistics">Statistics to be used for calculating accuracy, bonus score, etc.</param>
-        /// <returns>The computed score for provided inputs.</returns>
-        public double GetImmediateScore(ScoringMode mode, int maxCombo, Dictionary<HitResult, int> statistics)
-        {
-            // calculate base score from statistics pairs
-            int computedBaseScore = 0;
-
-            foreach (var pair in statistics)
-            {
-                if (!pair.Key.AffectsAccuracy())
-                    continue;
-
-                computedBaseScore += Judgement.ToNumericResult(pair.Key) * pair.Value;
-            }
-
-            return GetScore(mode, calculateAccuracyRatio(computedBaseScore), calculateComboRatio(maxCombo), statistics);
-        }
-
         /// <summary>
         /// Get the accuracy fraction for the provided base score.
         /// </summary>
diff --git a/osu.Game/Screens/Play/HUD/MultiplayerGameplayLeaderboard.cs b/osu.Game/Screens/Play/HUD/MultiplayerGameplayLeaderboard.cs
index 83c73e5a70..0516e00b8b 100644
--- a/osu.Game/Screens/Play/HUD/MultiplayerGameplayLeaderboard.cs
+++ b/osu.Game/Screens/Play/HUD/MultiplayerGameplayLeaderboard.cs
@@ -244,7 +244,7 @@ namespace osu.Game.Screens.Play.HUD
             {
                 var header = frame.Header;
 
-                Score.Value = ScoreProcessor.GetImmediateScore(ScoringMode.Value, header.MaxCombo, header.Statistics);
+                Score.Value = ScoreProcessor.GetScore(ScoringMode.Value, header.MaxCombo, header.Statistics);
                 Accuracy.Value = header.Accuracy;
                 CurrentCombo.Value = header.Combo;
             }

From 6654977a7b73c19d2250b030e519055c8be7cbae Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 8 Mar 2022 11:28:14 +0900
Subject: [PATCH 3294/5547] Add GetScore() overload with total hitobject count

---
 osu.Game/Rulesets/Scoring/ScoreProcessor.cs | 17 +++++++++++------
 1 file changed, 11 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Rulesets/Scoring/ScoreProcessor.cs b/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
index af9b4db5ca..67b78d5230 100644
--- a/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
+++ b/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
@@ -250,6 +250,17 @@ namespace osu.Game.Rulesets.Scoring
         /// <param name="statistics">Any statistics to be factored in.</param>
         /// <returns>The total score.</returns>
         public double GetScore(ScoringMode mode, double accuracyRatio, double comboRatio, Dictionary<HitResult, int> statistics)
+        {
+            int totalHitObjects = statistics.Where(k => k.Key >= HitResult.Miss && k.Key <= HitResult.Perfect).Sum(k => k.Value);
+
+            // If there are no hitobjects then the beatmap can be composed of only ticks or spinners, so ensure we don't multiply by 0 at all times.
+            if (totalHitObjects == 0)
+                totalHitObjects = 1;
+
+            return GetScore(mode, accuracyRatio, comboRatio, statistics, totalHitObjects);
+        }
+
+        public double GetScore(ScoringMode mode, double accuracyRatio, double comboRatio, Dictionary<HitResult, int> statistics, int totalHitObjects)
         {
             switch (mode)
             {
@@ -260,12 +271,6 @@ namespace osu.Game.Rulesets.Scoring
                     return (max_score * (accuracyScore + comboScore) + getBonusScore(statistics)) * scoreMultiplier;
 
                 case ScoringMode.Classic:
-                    int totalHitObjects = statistics.Where(k => k.Key >= HitResult.Miss && k.Key <= HitResult.Perfect).Sum(k => k.Value);
-
-                    // If there are no hitobjects then the beatmap can be composed of only ticks or spinners, so ensure we don't multiply by 0 at all times.
-                    if (totalHitObjects == 0)
-                        totalHitObjects = 1;
-
                     // This gives a similar feeling to osu!stable scoring (ScoreV1) while keeping classic scoring as only a constant multiple of standardised scoring.
                     // The invariant is important to ensure that scores don't get re-ordered on leaderboards between the two scoring modes.
                     double scaledStandardised = GetScore(ScoringMode.Standardised, accuracyRatio, comboRatio, statistics) / max_score;

From 5b6b8d1fa95c32f10500b838b95cf116dbe59abf Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 8 Mar 2022 11:29:47 +0900
Subject: [PATCH 3295/5547] Remove GetStandardisedScore() proxy method

---
 osu.Game/Rulesets/Scoring/ScoreProcessor.cs        | 14 +++-----------
 .../OnlinePlay/Playlists/PlaylistsPlayer.cs        |  3 ++-
 2 files changed, 5 insertions(+), 12 deletions(-)

diff --git a/osu.Game/Rulesets/Scoring/ScoreProcessor.cs b/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
index 67b78d5230..422b29601a 100644
--- a/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
+++ b/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
@@ -207,16 +207,10 @@ namespace osu.Game.Rulesets.Scoring
             if (rollingMaxBaseScore != 0)
                 Accuracy.Value = calculateAccuracyRatio(baseScore, true);
 
-            TotalScore.Value = getScore(Mode.Value);
+            TotalScore.Value = GetScore(Mode.Value);
         }
 
-        private double getScore(ScoringMode mode)
-        {
-            return GetScore(mode,
-                calculateAccuracyRatio(baseScore),
-                calculateComboRatio(HighestCombo.Value),
-                scoreResultCounts);
-        }
+        public double GetScore(ScoringMode mode) => GetScore(mode, calculateAccuracyRatio(baseScore), calculateComboRatio(HighestCombo.Value), scoreResultCounts);
 
         /// <summary>
         /// Given a minimal set of inputs, return the computed score for the tracked beatmap / mods combination, at the current point in time.
@@ -316,8 +310,6 @@ namespace osu.Game.Rulesets.Scoring
 
         public int GetStatistic(HitResult result) => scoreResultCounts.GetValueOrDefault(result);
 
-        public double GetStandardisedScore() => getScore(ScoringMode.Standardised);
-
         /// <summary>
         /// Resets this ScoreProcessor to a default state.
         /// </summary>
@@ -351,7 +343,7 @@ namespace osu.Game.Rulesets.Scoring
         /// </summary>
         public virtual void PopulateScore(ScoreInfo score)
         {
-            score.TotalScore = (long)Math.Round(GetStandardisedScore());
+            score.TotalScore = (long)Math.Round(GetScore(ScoringMode.Standardised));
             score.Combo = Combo.Value;
             score.MaxCombo = HighestCombo.Value;
             score.Accuracy = Accuracy.Value;
diff --git a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsPlayer.cs b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsPlayer.cs
index 7efeae8129..77eaf133c7 100644
--- a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsPlayer.cs
+++ b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsPlayer.cs
@@ -11,6 +11,7 @@ using osu.Framework.Screens;
 using osu.Game.Extensions;
 using osu.Game.Online.Rooms;
 using osu.Game.Rulesets;
+using osu.Game.Rulesets.Scoring;
 using osu.Game.Scoring;
 using osu.Game.Screens.Play;
 using osu.Game.Screens.Ranking;
@@ -64,7 +65,7 @@ namespace osu.Game.Screens.OnlinePlay.Playlists
         {
             await base.PrepareScoreForResultsAsync(score).ConfigureAwait(false);
 
-            Score.ScoreInfo.TotalScore = (int)Math.Round(ScoreProcessor.GetStandardisedScore());
+            Score.ScoreInfo.TotalScore = (int)Math.Round(ScoreProcessor.GetScore(ScoringMode.Standardised));
         }
 
         protected override void Dispose(bool isDisposing)

From a8e99f1a9521bdc528aaf66817183bc5f1e6b085 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 8 Mar 2022 11:45:04 +0900
Subject: [PATCH 3296/5547] Calculate classic score using total basic hitobject
 count

---
 osu.Game/Rulesets/Scoring/ScoreProcessor.cs | 93 +++++++++++++++------
 1 file changed, 66 insertions(+), 27 deletions(-)

diff --git a/osu.Game/Rulesets/Scoring/ScoreProcessor.cs b/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
index 422b29601a..b0656e270e 100644
--- a/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
+++ b/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
@@ -7,6 +7,7 @@ using System.Diagnostics;
 using System.Linq;
 using osu.Framework.Bindables;
 using osu.Framework.Utils;
+using osu.Game.Beatmaps;
 using osu.Game.Extensions;
 using osu.Game.Rulesets.Judgements;
 using osu.Game.Rulesets.Mods;
@@ -86,9 +87,22 @@ namespace osu.Game.Rulesets.Scoring
         /// </summary>
         private double maxBaseScore;
 
+        /// <summary>
+        /// The maximum number of basic (non-tick and non-bonus) hitobjects.
+        /// </summary>
+        private int maxBasicHitObjects;
+
+        /// <summary>
+        /// Maximum <see cref="HitResult"/> for a normal hit (i.e. not tick/bonus) for this ruleset.
+        /// Only populated via <see cref="ResetFromReplayFrame"/>.
+        /// </summary>
+        private HitResult? maxBasicHitResult;
+
         private double rollingMaxBaseScore;
         private double baseScore;
+        private int basicHitObjects;
 
+        private readonly Dictionary<HitResult, int> scoreResultCounts = new Dictionary<HitResult, int>();
         private readonly List<HitEvent> hitEvents = new List<HitEvent>();
         private HitObject lastHitObject;
 
@@ -122,8 +136,6 @@ namespace osu.Game.Rulesets.Scoring
             };
         }
 
-        private readonly Dictionary<HitResult, int> scoreResultCounts = new Dictionary<HitResult, int>();
-
         protected sealed override void ApplyResultInternal(JudgementResult result)
         {
             result.ComboAtJudgement = Combo.Value;
@@ -160,6 +172,9 @@ namespace osu.Game.Rulesets.Scoring
                 rollingMaxBaseScore += result.Judgement.MaxNumericResult;
             }
 
+            if (result.Type.IsBasic())
+                basicHitObjects++;
+
             hitEvents.Add(CreateHitEvent(result));
             lastHitObject = result.HitObject;
 
@@ -195,6 +210,9 @@ namespace osu.Game.Rulesets.Scoring
                 rollingMaxBaseScore -= result.Judgement.MaxNumericResult;
             }
 
+            if (result.Type.IsBasic())
+                basicHitObjects--;
+
             Debug.Assert(hitEvents.Count > 0);
             lastHitObject = hitEvents[^1].LastHitObject;
             hitEvents.RemoveAt(hitEvents.Count - 1);
@@ -210,15 +228,30 @@ namespace osu.Game.Rulesets.Scoring
             TotalScore.Value = GetScore(Mode.Value);
         }
 
-        public double GetScore(ScoringMode mode) => GetScore(mode, calculateAccuracyRatio(baseScore), calculateComboRatio(HighestCombo.Value), scoreResultCounts);
+        /// <summary>
+        /// Computes the total score from judgements that have been applied to this <see cref="ScoreProcessor"/>
+        /// through <see cref="JudgementProcessor.ApplyResult"/> and <see cref="JudgementProcessor.RevertResult"/>.
+        /// </summary>
+        /// <remarks>
+        /// Requires an <see cref="IBeatmap"/> to have been applied via <see cref="JudgementProcessor.ApplyBeatmap"/> before use.
+        /// </remarks>
+        /// <param name="mode">The <see cref="ScoringMode"/> to represent the score as.</param>
+        /// <returns>The total score in the given <see cref="ScoringMode"/>.</returns>
+        public double GetScore(ScoringMode mode)
+        {
+            return GetScore(mode, calculateAccuracyRatio(baseScore), calculateComboRatio(HighestCombo.Value), scoreResultCounts);
+        }
 
         /// <summary>
-        /// Given a minimal set of inputs, return the computed score for the tracked beatmap / mods combination, at the current point in time.
+        /// Computes the total score from judgements counts in a statistics dictionary.
         /// </summary>
-        /// <param name="mode">The <see cref="ScoringMode"/> to compute the total score in.</param>
+        /// <remarks>
+        /// Requires an <see cref="IBeatmap"/> to have been applied via <see cref="JudgementProcessor.ApplyBeatmap"/> before use.
+        /// </remarks>
+        /// <param name="mode">The <see cref="ScoringMode"/> to represent the score as.</param>
         /// <param name="maxCombo">The maximum combo achievable in the beatmap.</param>
-        /// <param name="statistics">Statistics to be used for calculating accuracy, bonus score, etc.</param>
-        /// <returns>The computed score for provided inputs.</returns>
+        /// <param name="statistics">The statistics to compute the score for.</param>
+        /// <returns>The total score computed from judgements in the statistics dictionary.</returns>
         public double GetScore(ScoringMode mode, int maxCombo, Dictionary<HitResult, int> statistics)
         {
             // calculate base score from statistics pairs
@@ -236,25 +269,34 @@ namespace osu.Game.Rulesets.Scoring
         }
 
         /// <summary>
-        /// Computes the total score.
+        /// Computes the total score from given scoring component ratios.
         /// </summary>
-        /// <param name="mode">The <see cref="ScoringMode"/> to compute the total score in.</param>
+        /// <remarks>
+        /// Requires an <see cref="IBeatmap"/> to have been applied via <see cref="JudgementProcessor.ApplyBeatmap"/> before use.
+        /// </remarks>
+        /// <param name="mode">The <see cref="ScoringMode"/> to represent the score as.</param>
         /// <param name="accuracyRatio">The accuracy percentage achieved by the player.</param>
-        /// <param name="comboRatio">The proportion of the max combo achieved by the player.</param>
-        /// <param name="statistics">Any statistics to be factored in.</param>
-        /// <returns>The total score.</returns>
+        /// <param name="comboRatio">The portion of the max combo achieved by the player.</param>
+        /// <param name="statistics">Any additional statistics to be factored in.</param>
+        /// <returns>The total score computed from the given scoring component ratios.</returns>
         public double GetScore(ScoringMode mode, double accuracyRatio, double comboRatio, Dictionary<HitResult, int> statistics)
         {
-            int totalHitObjects = statistics.Where(k => k.Key >= HitResult.Miss && k.Key <= HitResult.Perfect).Sum(k => k.Value);
-
-            // If there are no hitobjects then the beatmap can be composed of only ticks or spinners, so ensure we don't multiply by 0 at all times.
-            if (totalHitObjects == 0)
-                totalHitObjects = 1;
-
-            return GetScore(mode, accuracyRatio, comboRatio, statistics, totalHitObjects);
+            return GetScore(mode, accuracyRatio, comboRatio, maxBasicHitObjects, statistics);
         }
 
-        public double GetScore(ScoringMode mode, double accuracyRatio, double comboRatio, Dictionary<HitResult, int> statistics, int totalHitObjects)
+        /// <summary>
+        /// Computes the total score from given scoring component ratios.
+        /// </summary>
+        /// <remarks>
+        /// Does not require an <see cref="IBeatmap"/> to have been applied via <see cref="JudgementProcessor.ApplyBeatmap"/> before use.
+        /// </remarks>
+        /// <param name="mode">The <see cref="ScoringMode"/> to represent the score as.</param>
+        /// <param name="accuracyRatio">The accuracy percentage achieved by the player.</param>
+        /// <param name="comboRatio">The portion of the max combo achieved by the player.</param>
+        /// <param name="statistics">Any additional statistics to be factored in.</param>
+        /// <param name="totalBasicHitObjects">The total number of basic (non-tick and non-bonus) hitobjects in the beatmap.</param>
+        /// <returns>The total score computed from the given scoring component ratios.</returns>
+        public double GetScore(ScoringMode mode, double accuracyRatio, double comboRatio, int totalBasicHitObjects, Dictionary<HitResult, int> statistics)
         {
             switch (mode)
             {
@@ -268,7 +310,7 @@ namespace osu.Game.Rulesets.Scoring
                     // This gives a similar feeling to osu!stable scoring (ScoreV1) while keeping classic scoring as only a constant multiple of standardised scoring.
                     // The invariant is important to ensure that scores don't get re-ordered on leaderboards between the two scoring modes.
                     double scaledStandardised = GetScore(ScoringMode.Standardised, accuracyRatio, comboRatio, statistics) / max_score;
-                    return Math.Pow(scaledStandardised * totalHitObjects, 2) * 36;
+                    return Math.Pow(scaledStandardised * totalBasicHitObjects, 2) * 36;
             }
         }
 
@@ -326,10 +368,12 @@ namespace osu.Game.Rulesets.Scoring
             {
                 maxAchievableCombo = HighestCombo.Value;
                 maxBaseScore = baseScore;
+                maxBasicHitObjects = basicHitObjects;
             }
 
             baseScore = 0;
             rollingMaxBaseScore = 0;
+            basicHitObjects = 0;
 
             TotalScore.Value = 0;
             Accuracy.Value = 1;
@@ -355,11 +399,6 @@ namespace osu.Game.Rulesets.Scoring
             score.HitEvents = hitEvents;
         }
 
-        /// <summary>
-        /// Maximum <see cref="HitResult"/> for a normal hit (i.e. not tick/bonus) for this ruleset. Only populated via <see cref="ResetFromReplayFrame"/>.
-        /// </summary>
-        private HitResult? maxNormalResult;
-
         public override void ResetFromReplayFrame(Ruleset ruleset, ReplayFrame frame)
         {
             base.ResetFromReplayFrame(ruleset, frame);
@@ -394,7 +433,7 @@ namespace osu.Game.Rulesets.Scoring
                         break;
 
                     default:
-                        maxResult = maxNormalResult ??= ruleset.GetHitResults().OrderByDescending(kvp => Judgement.ToNumericResult(kvp.result)).First().result;
+                        maxResult = maxBasicHitResult ??= ruleset.GetHitResults().OrderByDescending(kvp => Judgement.ToNumericResult(kvp.result)).First().result;
                         break;
                 }
 

From f1c40bd9eda6dfda1bcd6669c548b8e078c8396f Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 8 Mar 2022 12:57:59 +0900
Subject: [PATCH 3297/5547] Rework GetScore() method signatures +
 implementations

Rename legacy-facing overload to mention as much
---
 .../Rulesets/Scoring/ScoreProcessorTest.cs    |  25 ++-
 .../Visual/Gameplay/TestSceneFailJudgement.cs |   2 +-
 .../TestSceneMultiSpectatorLeaderboard.cs     |   5 +-
 ...TestSceneMultiplayerGameplayLeaderboard.cs |   2 +-
 ...ceneMultiplayerGameplayLeaderboardTeams.cs |   2 +-
 .../PerformanceBreakdownCalculator.cs         |   3 +-
 osu.Game/Rulesets/Scoring/ScoreProcessor.cs   | 190 ++++++++++--------
 osu.Game/Scoring/ScoreManager.cs              |  15 +-
 .../Multiplayer/MultiplayerPlayer.cs          |   2 +-
 .../Spectate/MultiSpectatorLeaderboard.cs     |  11 +-
 .../Spectate/MultiSpectatorScreen.cs          |   2 +-
 .../OnlinePlay/Playlists/PlaylistsPlayer.cs   |   2 +-
 .../HUD/MultiplayerGameplayLeaderboard.cs     |  25 ++-
 13 files changed, 173 insertions(+), 113 deletions(-)

diff --git a/osu.Game.Tests/Rulesets/Scoring/ScoreProcessorTest.cs b/osu.Game.Tests/Rulesets/Scoring/ScoreProcessorTest.cs
index e96ff1f7f1..d327f4844e 100644
--- a/osu.Game.Tests/Rulesets/Scoring/ScoreProcessorTest.cs
+++ b/osu.Game.Tests/Rulesets/Scoring/ScoreProcessorTest.cs
@@ -6,11 +6,15 @@ using System.Linq;
 using NUnit.Framework;
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets;
+using osu.Game.Rulesets.Difficulty;
 using osu.Game.Rulesets.Judgements;
+using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Osu.Judgements;
 using osu.Game.Rulesets.Osu.Objects;
 using osu.Game.Rulesets.Scoring;
+using osu.Game.Rulesets.UI;
+using osu.Game.Scoring;
 using osu.Game.Tests.Beatmaps;
 
 namespace osu.Game.Tests.Rulesets.Scoring
@@ -300,7 +304,26 @@ namespace osu.Game.Tests.Rulesets.Scoring
                 HitObjects = { new TestHitObject(result) }
             });
 
-            Assert.That(scoreProcessor.GetScore(ScoringMode.Standardised, result.AffectsCombo() ? 1 : 0, statistic), Is.EqualTo(expectedScore).Within(0.5d));
+            Assert.That(scoreProcessor.ComputeFinalScore(ScoringMode.Standardised, new ScoreInfo
+            {
+                Ruleset = new TestRuleset().RulesetInfo,
+                MaxCombo = result.AffectsCombo() ? 1 : 0,
+                Statistics = statistic
+            }), Is.EqualTo(expectedScore).Within(0.5d));
+        }
+
+        private class TestRuleset : Ruleset
+        {
+            public override IEnumerable<Mod> GetModsFor(ModType type) => throw new System.NotImplementedException();
+
+            public override DrawableRuleset CreateDrawableRulesetWith(IBeatmap beatmap, IReadOnlyList<Mod> mods = null) => throw new System.NotImplementedException();
+
+            public override IBeatmapConverter CreateBeatmapConverter(IBeatmap beatmap) => throw new System.NotImplementedException();
+
+            public override DifficultyCalculator CreateDifficultyCalculator(IWorkingBeatmap beatmap) => throw new System.NotImplementedException();
+
+            public override string Description { get; }
+            public override string ShortName { get; }
         }
 
         private class TestJudgement : Judgement
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneFailJudgement.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneFailJudgement.cs
index 6430c29dfa..79d7bb366d 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneFailJudgement.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneFailJudgement.cs
@@ -25,7 +25,7 @@ namespace osu.Game.Tests.Visual.Gameplay
             AddUntilStep("wait for multiple judgements", () => ((FailPlayer)Player).ScoreProcessor.JudgedHits > 1);
             AddAssert("total number of results == 1", () =>
             {
-                var score = new ScoreInfo();
+                var score = new ScoreInfo { Ruleset = Ruleset.Value };
 
                 ((FailPlayer)Player).ScoreProcessor.PopulateScore(score);
 
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorLeaderboard.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorLeaderboard.cs
index 42bb99de24..f57a54d84c 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorLeaderboard.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorLeaderboard.cs
@@ -46,7 +46,10 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 var scoreProcessor = new OsuScoreProcessor();
                 scoreProcessor.ApplyBeatmap(playable);
 
-                LoadComponentAsync(leaderboard = new MultiSpectatorLeaderboard(scoreProcessor, clocks.Keys.Select(id => new MultiplayerRoomUser(id)).ToArray()) { Expanded = { Value = true } }, Add);
+                LoadComponentAsync(leaderboard = new MultiSpectatorLeaderboard(Ruleset.Value, scoreProcessor, clocks.Keys.Select(id => new MultiplayerRoomUser(id)).ToArray())
+                {
+                    Expanded = { Value = true }
+                }, Add);
             });
 
             AddUntilStep("wait for load", () => leaderboard.IsLoaded);
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs
index cfac5da4ff..bcd4474876 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs
@@ -69,7 +69,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
                 scoreProcessor.ApplyBeatmap(playableBeatmap);
 
-                LoadComponentAsync(leaderboard = new MultiplayerGameplayLeaderboard(scoreProcessor, multiplayerUsers.ToArray())
+                LoadComponentAsync(leaderboard = new MultiplayerGameplayLeaderboard(Ruleset.Value, scoreProcessor, multiplayerUsers.ToArray())
                 {
                     Anchor = Anchor.Centre,
                     Origin = Anchor.Centre,
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboardTeams.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboardTeams.cs
index f751b162d1..7f5aced925 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboardTeams.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboardTeams.cs
@@ -80,7 +80,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
                 scoreProcessor.ApplyBeatmap(playableBeatmap);
 
-                LoadComponentAsync(leaderboard = new MultiplayerGameplayLeaderboard(scoreProcessor, multiplayerUsers.ToArray())
+                LoadComponentAsync(leaderboard = new MultiplayerGameplayLeaderboard(Ruleset.Value, scoreProcessor, multiplayerUsers.ToArray())
                 {
                     Anchor = Anchor.Centre,
                     Origin = Anchor.Centre,
diff --git a/osu.Game/Rulesets/Difficulty/PerformanceBreakdownCalculator.cs b/osu.Game/Rulesets/Difficulty/PerformanceBreakdownCalculator.cs
index dfb8066b28..fc38ed0298 100644
--- a/osu.Game/Rulesets/Difficulty/PerformanceBreakdownCalculator.cs
+++ b/osu.Game/Rulesets/Difficulty/PerformanceBreakdownCalculator.cs
@@ -63,9 +63,8 @@ namespace osu.Game.Rulesets.Difficulty
 
                 // calculate total score
                 ScoreProcessor scoreProcessor = ruleset.CreateScoreProcessor();
-                scoreProcessor.HighestCombo.Value = perfectPlay.MaxCombo;
                 scoreProcessor.Mods.Value = perfectPlay.Mods;
-                perfectPlay.TotalScore = (long)scoreProcessor.GetScore(ScoringMode.Standardised, perfectPlay.MaxCombo, statistics);
+                perfectPlay.TotalScore = (long)scoreProcessor.ComputeFinalScore(ScoringMode.Standardised, perfectPlay);
 
                 // compute rank achieved
                 // default to SS, then adjust the rank with mods
diff --git a/osu.Game/Rulesets/Scoring/ScoreProcessor.cs b/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
index b0656e270e..3004464df7 100644
--- a/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
+++ b/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
@@ -7,7 +7,6 @@ using System.Diagnostics;
 using System.Linq;
 using osu.Framework.Bindables;
 using osu.Framework.Utils;
-using osu.Game.Beatmaps;
 using osu.Game.Extensions;
 using osu.Game.Rulesets.Judgements;
 using osu.Game.Rulesets.Mods;
@@ -93,10 +92,10 @@ namespace osu.Game.Rulesets.Scoring
         private int maxBasicHitObjects;
 
         /// <summary>
-        /// Maximum <see cref="HitResult"/> for a normal hit (i.e. not tick/bonus) for this ruleset.
-        /// Only populated via <see cref="ResetFromReplayFrame"/>.
+        /// The maximum <see cref="HitResult"/> of a basic (non-tick and non-bonus) hitobject.
+        /// Only populated via <see cref="ComputeFinalScore"/> or <see cref="ResetFromReplayFrame"/>.
         /// </summary>
-        private HitResult? maxBasicHitResult;
+        private HitResult? maxBasicResult;
 
         private double rollingMaxBaseScore;
         private double baseScore;
@@ -222,81 +221,110 @@ namespace osu.Game.Rulesets.Scoring
 
         private void updateScore()
         {
-            if (rollingMaxBaseScore != 0)
-                Accuracy.Value = calculateAccuracyRatio(baseScore, true);
+            double rollingAccuracyRatio = rollingMaxBaseScore > 0 ? baseScore / rollingMaxBaseScore : 1;
+            double accuracyRatio = maxBaseScore > 0 ? baseScore / maxBaseScore : 1;
+            double comboRatio = maxAchievableCombo > 0 ? (double)HighestCombo.Value / maxAchievableCombo : 1;
 
-            TotalScore.Value = GetScore(Mode.Value);
+            Accuracy.Value = rollingAccuracyRatio;
+            TotalScore.Value = ComputeScore(Mode.Value, accuracyRatio, comboRatio, getBonusScore(scoreResultCounts), maxBasicHitObjects);
         }
 
         /// <summary>
-        /// Computes the total score from judgements that have been applied to this <see cref="ScoreProcessor"/>
-        /// through <see cref="JudgementProcessor.ApplyResult"/> and <see cref="JudgementProcessor.RevertResult"/>.
+        /// Computes the total score of a given finalised <see cref="ScoreInfo"/>. This should be used when a score is known to be complete.
         /// </summary>
         /// <remarks>
-        /// Requires an <see cref="IBeatmap"/> to have been applied via <see cref="JudgementProcessor.ApplyBeatmap"/> before use.
+        /// Does not require <see cref="JudgementProcessor.ApplyBeatmap"/> to have been called before use.
         /// </remarks>
         /// <param name="mode">The <see cref="ScoringMode"/> to represent the score as.</param>
+        /// <param name="scoreInfo">The <see cref="ScoreInfo"/> to compute the total score of.</param>
         /// <returns>The total score in the given <see cref="ScoringMode"/>.</returns>
-        public double GetScore(ScoringMode mode)
+        public double ComputeFinalScore(ScoringMode mode, ScoreInfo scoreInfo)
         {
-            return GetScore(mode, calculateAccuracyRatio(baseScore), calculateComboRatio(HighestCombo.Value), scoreResultCounts);
+            extractFromStatistics(scoreInfo.Ruleset.CreateInstance(),
+                scoreInfo.Statistics,
+                out double extractedBaseScore,
+                out double extractedMaxBaseScore,
+                out int extractedMaxCombo,
+                out int extractedBasicHitObjects);
+
+            double accuracyRatio = extractedMaxBaseScore > 0 ? extractedBaseScore / extractedMaxBaseScore : 1;
+            double comboRatio = extractedMaxCombo > 0 ? (double)scoreInfo.MaxCombo / extractedMaxCombo : 1;
+
+            return ComputeScore(mode, accuracyRatio, comboRatio, getBonusScore(scoreInfo.Statistics), extractedBasicHitObjects);
         }
 
         /// <summary>
-        /// Computes the total score from judgements counts in a statistics dictionary.
+        /// Computes the total score of a partially-completed <see cref="ScoreInfo"/>. This should be used when it is unknown whether a score is complete.
         /// </summary>
         /// <remarks>
-        /// Requires an <see cref="IBeatmap"/> to have been applied via <see cref="JudgementProcessor.ApplyBeatmap"/> before use.
+        /// Requires <see cref="JudgementProcessor.ApplyBeatmap"/> to have been called before use.
         /// </remarks>
         /// <param name="mode">The <see cref="ScoringMode"/> to represent the score as.</param>
-        /// <param name="maxCombo">The maximum combo achievable in the beatmap.</param>
-        /// <param name="statistics">The statistics to compute the score for.</param>
-        /// <returns>The total score computed from judgements in the statistics dictionary.</returns>
-        public double GetScore(ScoringMode mode, int maxCombo, Dictionary<HitResult, int> statistics)
+        /// <param name="scoreInfo">The <see cref="ScoreInfo"/> to compute the total score of.</param>
+        /// <returns>The total score in the given <see cref="ScoringMode"/>.</returns>
+        public double ComputePartialScore(ScoringMode mode, ScoreInfo scoreInfo)
         {
-            // calculate base score from statistics pairs
-            int computedBaseScore = 0;
+            extractFromStatistics(scoreInfo.Ruleset.CreateInstance(),
+                scoreInfo.Statistics,
+                out double extractedBaseScore,
+                out _,
+                out _,
+                out _);
 
-            foreach (var pair in statistics)
+            double accuracyRatio = maxBaseScore > 0 ? extractedBaseScore / maxBaseScore : 1;
+            double comboRatio = maxAchievableCombo > 0 ? (double)scoreInfo.MaxCombo / maxAchievableCombo : 1;
+
+            return ComputeScore(mode, accuracyRatio, comboRatio, getBonusScore(scoreInfo.Statistics), maxBasicHitObjects);
+        }
+
+        /// <summary>
+        /// Computes the total score of a given <see cref="ScoreInfo"/> with a given custom max achievable combo.
+        /// </summary>
+        /// <remarks>
+        /// This is useful for processing legacy scores in which the maximum achievable combo can be more accurately determined via external means (e.g. database values or difficulty calculation).
+        /// <p>Does not require <see cref="JudgementProcessor.ApplyBeatmap"/> to have been called before use.</p>
+        /// </remarks>
+        /// <param name="mode">The <see cref="ScoringMode"/> to represent the score as.</param>
+        /// <param name="scoreInfo">The <see cref="ScoreInfo"/> to compute the total score of.</param>
+        /// <param name="maxAchievableCombo">The maximum achievable combo for the provided beatmap.</param>
+        /// <returns>The total score in the given <see cref="ScoringMode"/>.</returns>
+        public double ComputeFinalLegacyScore(ScoringMode mode, ScoreInfo scoreInfo, int maxAchievableCombo)
+        {
+            double accuracyRatio = scoreInfo.Accuracy;
+            double comboRatio = maxAchievableCombo > 0 ? (double)scoreInfo.MaxCombo / maxAchievableCombo : 1;
+
+            // For legacy osu!mania scores, a full-GREAT score has 100% accuracy. If combined with a full-combo, the score becomes indistinguishable from a full-PERFECT score.
+            // To get around this, the accuracy ratio is always recalculated based on the hit statistics rather than trusting the score.
+            // Note: This cannot be applied universally to all legacy scores, as some rulesets (e.g. catch) group multiple judgements together.
+            if (scoreInfo.IsLegacyScore && scoreInfo.Ruleset.OnlineID == 3)
             {
-                if (!pair.Key.AffectsAccuracy())
-                    continue;
+                extractFromStatistics(
+                    scoreInfo.Ruleset.CreateInstance(),
+                    scoreInfo.Statistics,
+                    out double computedBaseScore,
+                    out double computedMaxBaseScore,
+                    out _,
+                    out _);
 
-                computedBaseScore += Judgement.ToNumericResult(pair.Key) * pair.Value;
+                if (computedMaxBaseScore > 0)
+                    accuracyRatio = computedBaseScore / computedMaxBaseScore;
             }
 
-            return GetScore(mode, calculateAccuracyRatio(computedBaseScore), calculateComboRatio(maxCombo), statistics);
+            int computedBasicHitObjects = scoreInfo.Statistics.Where(kvp => kvp.Key.IsBasic()).Select(kvp => kvp.Value).Sum();
+
+            return ComputeScore(mode, accuracyRatio, comboRatio, getBonusScore(scoreInfo.Statistics), computedBasicHitObjects);
         }
 
         /// <summary>
-        /// Computes the total score from given scoring component ratios.
+        /// Computes the total score from individual scoring components.
         /// </summary>
-        /// <remarks>
-        /// Requires an <see cref="IBeatmap"/> to have been applied via <see cref="JudgementProcessor.ApplyBeatmap"/> before use.
-        /// </remarks>
         /// <param name="mode">The <see cref="ScoringMode"/> to represent the score as.</param>
         /// <param name="accuracyRatio">The accuracy percentage achieved by the player.</param>
         /// <param name="comboRatio">The portion of the max combo achieved by the player.</param>
-        /// <param name="statistics">Any additional statistics to be factored in.</param>
-        /// <returns>The total score computed from the given scoring component ratios.</returns>
-        public double GetScore(ScoringMode mode, double accuracyRatio, double comboRatio, Dictionary<HitResult, int> statistics)
-        {
-            return GetScore(mode, accuracyRatio, comboRatio, maxBasicHitObjects, statistics);
-        }
-
-        /// <summary>
-        /// Computes the total score from given scoring component ratios.
-        /// </summary>
-        /// <remarks>
-        /// Does not require an <see cref="IBeatmap"/> to have been applied via <see cref="JudgementProcessor.ApplyBeatmap"/> before use.
-        /// </remarks>
-        /// <param name="mode">The <see cref="ScoringMode"/> to represent the score as.</param>
-        /// <param name="accuracyRatio">The accuracy percentage achieved by the player.</param>
-        /// <param name="comboRatio">The portion of the max combo achieved by the player.</param>
-        /// <param name="statistics">Any additional statistics to be factored in.</param>
+        /// <param name="bonusScore">The total bonus score.</param>
         /// <param name="totalBasicHitObjects">The total number of basic (non-tick and non-bonus) hitobjects in the beatmap.</param>
         /// <returns>The total score computed from the given scoring component ratios.</returns>
-        public double GetScore(ScoringMode mode, double accuracyRatio, double comboRatio, int totalBasicHitObjects, Dictionary<HitResult, int> statistics)
+        public double ComputeScore(ScoringMode mode, double accuracyRatio, double comboRatio, double bonusScore, int totalBasicHitObjects)
         {
             switch (mode)
             {
@@ -304,33 +332,22 @@ namespace osu.Game.Rulesets.Scoring
                 case ScoringMode.Standardised:
                     double accuracyScore = accuracyPortion * accuracyRatio;
                     double comboScore = comboPortion * comboRatio;
-                    return (max_score * (accuracyScore + comboScore) + getBonusScore(statistics)) * scoreMultiplier;
+                    return (max_score * (accuracyScore + comboScore) + bonusScore) * scoreMultiplier;
 
                 case ScoringMode.Classic:
                     // This gives a similar feeling to osu!stable scoring (ScoreV1) while keeping classic scoring as only a constant multiple of standardised scoring.
                     // The invariant is important to ensure that scores don't get re-ordered on leaderboards between the two scoring modes.
-                    double scaledStandardised = GetScore(ScoringMode.Standardised, accuracyRatio, comboRatio, statistics) / max_score;
-                    return Math.Pow(scaledStandardised * totalBasicHitObjects, 2) * 36;
+                    double scaledStandardised = ComputeScore(ScoringMode.Standardised, accuracyRatio, comboRatio, bonusScore, totalBasicHitObjects) / max_score;
+                    return Math.Pow(scaledStandardised * Math.Max(1, totalBasicHitObjects), 2) * 36;
             }
         }
 
         /// <summary>
-        /// Get the accuracy fraction for the provided base score.
+        /// Calculates the total bonus score from score statistics.
         /// </summary>
-        /// <param name="baseScore">The score to be used for accuracy calculation.</param>
-        /// <param name="preferRolling">Whether the rolling base score should be used (ie. for the current point in time based on Apply/Reverted results).</param>
-        /// <returns>The computed accuracy.</returns>
-        private double calculateAccuracyRatio(double baseScore, bool preferRolling = false)
-        {
-            if (preferRolling && rollingMaxBaseScore != 0)
-                return baseScore / rollingMaxBaseScore;
-
-            return maxBaseScore > 0 ? baseScore / maxBaseScore : 1;
-        }
-
-        private double calculateComboRatio(int maxCombo) => maxAchievableCombo > 0 ? (double)maxCombo / maxAchievableCombo : 1;
-
-        private double getBonusScore(Dictionary<HitResult, int> statistics)
+        /// <param name="statistics">The score statistics.</param>
+        /// <returns>The total bonus score.</returns>
+        private double getBonusScore(IReadOnlyDictionary<HitResult, int> statistics)
             => statistics.GetValueOrDefault(HitResult.SmallBonus) * Judgement.SMALL_BONUS_SCORE
                + statistics.GetValueOrDefault(HitResult.LargeBonus) * Judgement.LARGE_BONUS_SCORE;
 
@@ -387,16 +404,17 @@ namespace osu.Game.Rulesets.Scoring
         /// </summary>
         public virtual void PopulateScore(ScoreInfo score)
         {
-            score.TotalScore = (long)Math.Round(GetScore(ScoringMode.Standardised));
             score.Combo = Combo.Value;
             score.MaxCombo = HighestCombo.Value;
             score.Accuracy = Accuracy.Value;
             score.Rank = Rank.Value;
+            score.HitEvents = hitEvents;
 
             foreach (var result in HitResultExtensions.ALL_TYPES)
                 score.Statistics[result] = GetStatistic(result);
 
-            score.HitEvents = hitEvents;
+            // Populate total score after everything else.
+            score.TotalScore = (long)Math.Round(ComputeFinalScore(ScoringMode.Standardised, score));
         }
 
         public override void ResetFromReplayFrame(Ruleset ruleset, ReplayFrame frame)
@@ -406,11 +424,26 @@ namespace osu.Game.Rulesets.Scoring
             if (frame.Header == null)
                 return;
 
-            baseScore = 0;
-            rollingMaxBaseScore = 0;
+            extractFromStatistics(ruleset, frame.Header.Statistics, out baseScore, out rollingMaxBaseScore, out _, out _);
             HighestCombo.Value = frame.Header.MaxCombo;
 
-            foreach ((HitResult result, int count) in frame.Header.Statistics)
+            scoreResultCounts.Clear();
+            scoreResultCounts.AddRange(frame.Header.Statistics);
+
+            updateScore();
+
+            OnResetFromReplayFrame?.Invoke();
+        }
+
+        private void extractFromStatistics(Ruleset ruleset, IReadOnlyDictionary<HitResult, int> statistics, out double baseScore, out double maxBaseScore, out int maxCombo,
+                                           out int basicHitObjects)
+        {
+            baseScore = 0;
+            maxBaseScore = 0;
+            maxCombo = 0;
+            basicHitObjects = 0;
+
+            foreach ((HitResult result, int count) in statistics)
             {
                 // Bonus scores are counted separately directly from the statistics dictionary later on.
                 if (!result.IsScorable() || result.IsBonus())
@@ -433,20 +466,19 @@ namespace osu.Game.Rulesets.Scoring
                         break;
 
                     default:
-                        maxResult = maxBasicHitResult ??= ruleset.GetHitResults().OrderByDescending(kvp => Judgement.ToNumericResult(kvp.result)).First().result;
+                        maxResult = maxBasicResult ??= ruleset.GetHitResults().OrderByDescending(kvp => Judgement.ToNumericResult(kvp.result)).First().result;
                         break;
                 }
 
                 baseScore += count * Judgement.ToNumericResult(result);
-                rollingMaxBaseScore += count * Judgement.ToNumericResult(maxResult);
+                maxBaseScore += count * Judgement.ToNumericResult(maxResult);
+
+                if (result.AffectsCombo())
+                    maxCombo += count;
+
+                if (result.IsBasic())
+                    basicHitObjects += count;
             }
-
-            scoreResultCounts.Clear();
-            scoreResultCounts.AddRange(frame.Header.Statistics);
-
-            updateScore();
-
-            OnResetFromReplayFrame?.Invoke();
         }
 
         protected override void Dispose(bool isDisposing)
diff --git a/osu.Game/Scoring/ScoreManager.cs b/osu.Game/Scoring/ScoreManager.cs
index 963c4a77ca..6e49e3c9af 100644
--- a/osu.Game/Scoring/ScoreManager.cs
+++ b/osu.Game/Scoring/ScoreManager.cs
@@ -18,7 +18,6 @@ using osu.Game.Database;
 using osu.Game.IO.Archives;
 using osu.Game.Overlays.Notifications;
 using osu.Game.Rulesets;
-using osu.Game.Rulesets.Judgements;
 using osu.Game.Rulesets.Scoring;
 
 namespace osu.Game.Scoring
@@ -136,21 +135,9 @@ namespace osu.Game.Scoring
                 return score.TotalScore;
 
             int beatmapMaxCombo;
-            double accuracy = score.Accuracy;
 
             if (score.IsLegacyScore)
             {
-                if (score.RulesetID == 3)
-                {
-                    // In osu!stable, a full-GREAT score has 100% accuracy in mania. Along with a full combo, the score becomes indistinguishable from a full-PERFECT score.
-                    // To get around this, recalculate accuracy based on the hit statistics.
-                    // Note: This cannot be applied universally to all legacy scores, as some rulesets (e.g. catch) group multiple judgements together.
-                    double maxBaseScore = score.Statistics.Select(kvp => kvp.Value).Sum() * Judgement.ToNumericResult(HitResult.Perfect);
-                    double baseScore = score.Statistics.Select(kvp => Judgement.ToNumericResult(kvp.Key) * kvp.Value).Sum();
-                    if (maxBaseScore > 0)
-                        accuracy = baseScore / maxBaseScore;
-                }
-
                 // This score is guaranteed to be an osu!stable score.
                 // The combo must be determined through either the beatmap's max combo value or the difficulty calculator, as lazer's scoring has changed and the score statistics cannot be used.
                 if (score.BeatmapInfo.MaxCombo != null)
@@ -184,7 +171,7 @@ namespace osu.Game.Scoring
             var scoreProcessor = ruleset.CreateScoreProcessor();
             scoreProcessor.Mods.Value = score.Mods;
 
-            return (long)Math.Round(scoreProcessor.GetScore(mode, accuracy, (double)score.MaxCombo / beatmapMaxCombo, score.Statistics));
+            return (long)Math.Round(scoreProcessor.ComputeFinalLegacyScore(mode, score, beatmapMaxCombo));
         }
 
         /// <summary>
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayer.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayer.cs
index bd2f49a9e5..d8fb448437 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayer.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayer.cs
@@ -76,7 +76,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
             });
 
             // todo: this should be implemented via a custom HUD implementation, and correctly masked to the main content area.
-            LoadComponentAsync(leaderboard = new MultiplayerGameplayLeaderboard(ScoreProcessor, users), l =>
+            LoadComponentAsync(leaderboard = new MultiplayerGameplayLeaderboard(GameplayState.Ruleset.RulesetInfo, ScoreProcessor, users), l =>
             {
                 if (!LoadedBeatmapSuccessfully)
                     return;
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorLeaderboard.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorLeaderboard.cs
index 1614828a78..4545913db8 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorLeaderboard.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorLeaderboard.cs
@@ -5,6 +5,7 @@ using System;
 using JetBrains.Annotations;
 using osu.Framework.Timing;
 using osu.Game.Online.Multiplayer;
+using osu.Game.Rulesets;
 using osu.Game.Rulesets.Scoring;
 using osu.Game.Screens.Play.HUD;
 
@@ -12,8 +13,8 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Spectate
 {
     public class MultiSpectatorLeaderboard : MultiplayerGameplayLeaderboard
     {
-        public MultiSpectatorLeaderboard([NotNull] ScoreProcessor scoreProcessor, MultiplayerRoomUser[] users)
-            : base(scoreProcessor, users)
+        public MultiSpectatorLeaderboard(RulesetInfo ruleset, [NotNull] ScoreProcessor scoreProcessor, MultiplayerRoomUser[] users)
+            : base(ruleset, scoreProcessor, users)
         {
         }
 
@@ -33,7 +34,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Spectate
             ((SpectatingTrackedUserData)data).Clock = null;
         }
 
-        protected override TrackedUserData CreateUserData(MultiplayerRoomUser user, ScoreProcessor scoreProcessor) => new SpectatingTrackedUserData(user, scoreProcessor);
+        protected override TrackedUserData CreateUserData(MultiplayerRoomUser user, RulesetInfo ruleset, ScoreProcessor scoreProcessor) => new SpectatingTrackedUserData(user, ruleset, scoreProcessor);
 
         protected override void Update()
         {
@@ -48,8 +49,8 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Spectate
             [CanBeNull]
             public IClock Clock;
 
-            public SpectatingTrackedUserData(MultiplayerRoomUser user, ScoreProcessor scoreProcessor)
-                : base(user, scoreProcessor)
+            public SpectatingTrackedUserData(MultiplayerRoomUser user, RulesetInfo ruleset, ScoreProcessor scoreProcessor)
+                : base(user, ruleset, scoreProcessor)
             {
             }
 
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorScreen.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorScreen.cs
index 3bb76c4a76..6747b8fc66 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorScreen.cs
@@ -133,7 +133,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Spectate
             var scoreProcessor = Ruleset.Value.CreateInstance().CreateScoreProcessor();
             scoreProcessor.ApplyBeatmap(playableBeatmap);
 
-            LoadComponentAsync(leaderboard = new MultiSpectatorLeaderboard(scoreProcessor, users)
+            LoadComponentAsync(leaderboard = new MultiSpectatorLeaderboard(Ruleset.Value, scoreProcessor, users)
             {
                 Expanded = { Value = true },
             }, l =>
diff --git a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsPlayer.cs b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsPlayer.cs
index 77eaf133c7..5a7762a3d8 100644
--- a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsPlayer.cs
+++ b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsPlayer.cs
@@ -65,7 +65,7 @@ namespace osu.Game.Screens.OnlinePlay.Playlists
         {
             await base.PrepareScoreForResultsAsync(score).ConfigureAwait(false);
 
-            Score.ScoreInfo.TotalScore = (int)Math.Round(ScoreProcessor.GetScore(ScoringMode.Standardised));
+            Score.ScoreInfo.TotalScore = (int)Math.Round(ScoreProcessor.ComputeFinalScore(ScoringMode.Standardised, Score.ScoreInfo));
         }
 
         protected override void Dispose(bool isDisposing)
diff --git a/osu.Game/Screens/Play/HUD/MultiplayerGameplayLeaderboard.cs b/osu.Game/Screens/Play/HUD/MultiplayerGameplayLeaderboard.cs
index 0516e00b8b..71998622ef 100644
--- a/osu.Game/Screens/Play/HUD/MultiplayerGameplayLeaderboard.cs
+++ b/osu.Game/Screens/Play/HUD/MultiplayerGameplayLeaderboard.cs
@@ -17,7 +17,9 @@ using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Multiplayer.MatchTypes.TeamVersus;
 using osu.Game.Online.Spectator;
+using osu.Game.Rulesets;
 using osu.Game.Rulesets.Scoring;
+using osu.Game.Scoring;
 using osuTK.Graphics;
 
 namespace osu.Game.Screens.Play.HUD
@@ -41,6 +43,7 @@ namespace osu.Game.Screens.Play.HUD
         [Resolved]
         private UserLookupCache userLookupCache { get; set; }
 
+        private readonly RulesetInfo ruleset;
         private readonly ScoreProcessor scoreProcessor;
         private readonly MultiplayerRoomUser[] playingUsers;
         private Bindable<ScoringMode> scoringMode;
@@ -52,11 +55,13 @@ namespace osu.Game.Screens.Play.HUD
         /// <summary>
         /// Construct a new leaderboard.
         /// </summary>
+        /// <param name="ruleset">The ruleset.</param>
         /// <param name="scoreProcessor">A score processor instance to handle score calculation for scores of users in the match.</param>
         /// <param name="users">IDs of all users in this match.</param>
-        public MultiplayerGameplayLeaderboard(ScoreProcessor scoreProcessor, MultiplayerRoomUser[] users)
+        public MultiplayerGameplayLeaderboard(RulesetInfo ruleset, ScoreProcessor scoreProcessor, MultiplayerRoomUser[] users)
         {
             // todo: this will eventually need to be created per user to support different mod combinations.
+            this.ruleset = ruleset;
             this.scoreProcessor = scoreProcessor;
 
             playingUsers = users;
@@ -69,7 +74,7 @@ namespace osu.Game.Screens.Play.HUD
 
             foreach (var user in playingUsers)
             {
-                var trackedUser = CreateUserData(user, scoreProcessor);
+                var trackedUser = CreateUserData(user, ruleset, scoreProcessor);
                 trackedUser.ScoringMode.BindTo(scoringMode);
                 UserScores[user.UserID] = trackedUser;
 
@@ -119,7 +124,7 @@ namespace osu.Game.Screens.Play.HUD
             spectatorClient.OnNewFrames += handleIncomingFrames;
         }
 
-        protected virtual TrackedUserData CreateUserData(MultiplayerRoomUser user, ScoreProcessor scoreProcessor) => new TrackedUserData(user, scoreProcessor);
+        protected virtual TrackedUserData CreateUserData(MultiplayerRoomUser user, RulesetInfo ruleset, ScoreProcessor scoreProcessor) => new TrackedUserData(user, ruleset, scoreProcessor);
 
         protected override GameplayLeaderboardScore CreateLeaderboardScoreDrawable(APIUser user, bool isTracked)
         {
@@ -222,8 +227,12 @@ namespace osu.Game.Screens.Play.HUD
 
             public int? Team => (User.MatchState as TeamVersusUserState)?.TeamID;
 
-            public TrackedUserData(MultiplayerRoomUser user, ScoreProcessor scoreProcessor)
+            private readonly RulesetInfo ruleset;
+
+            public TrackedUserData(MultiplayerRoomUser user, RulesetInfo ruleset, ScoreProcessor scoreProcessor)
             {
+                this.ruleset = ruleset;
+
                 User = user;
                 ScoreProcessor = scoreProcessor;
 
@@ -244,7 +253,13 @@ namespace osu.Game.Screens.Play.HUD
             {
                 var header = frame.Header;
 
-                Score.Value = ScoreProcessor.GetScore(ScoringMode.Value, header.MaxCombo, header.Statistics);
+                Score.Value = ScoreProcessor.ComputePartialScore(ScoringMode.Value, new ScoreInfo
+                {
+                    Ruleset = ruleset,
+                    MaxCombo = header.MaxCombo,
+                    Statistics = header.Statistics
+                });
+
                 Accuracy.Value = header.Accuracy;
                 CurrentCombo.Value = header.Combo;
             }

From 6fd8b4d8918f9095c9651cf88047c5467c10b06e Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 8 Mar 2022 22:14:58 +0900
Subject: [PATCH 3298/5547] Safeguard method against invalid invocation

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

diff --git a/osu.Game/Rulesets/Scoring/ScoreProcessor.cs b/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
index 3004464df7..5e11d4da72 100644
--- a/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
+++ b/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
@@ -7,6 +7,7 @@ using System.Diagnostics;
 using System.Linq;
 using osu.Framework.Bindables;
 using osu.Framework.Utils;
+using osu.Game.Beatmaps;
 using osu.Game.Extensions;
 using osu.Game.Rulesets.Judgements;
 using osu.Game.Rulesets.Mods;
@@ -100,6 +101,7 @@ namespace osu.Game.Rulesets.Scoring
         private double rollingMaxBaseScore;
         private double baseScore;
         private int basicHitObjects;
+        private bool beatmapApplied;
 
         private readonly Dictionary<HitResult, int> scoreResultCounts = new Dictionary<HitResult, int>();
         private readonly List<HitEvent> hitEvents = new List<HitEvent>();
@@ -135,6 +137,12 @@ namespace osu.Game.Rulesets.Scoring
             };
         }
 
+        public override void ApplyBeatmap(IBeatmap beatmap)
+        {
+            base.ApplyBeatmap(beatmap);
+            beatmapApplied = true;
+        }
+
         protected sealed override void ApplyResultInternal(JudgementResult result)
         {
             result.ComboAtJudgement = Combo.Value;
@@ -264,6 +272,9 @@ namespace osu.Game.Rulesets.Scoring
         /// <returns>The total score in the given <see cref="ScoringMode"/>.</returns>
         public double ComputePartialScore(ScoringMode mode, ScoreInfo scoreInfo)
         {
+            if (!beatmapApplied)
+                throw new InvalidOperationException($"Cannot compute partial score without calling {nameof(ApplyBeatmap)}.");
+
             extractFromStatistics(scoreInfo.Ruleset.CreateInstance(),
                 scoreInfo.Statistics,
                 out double extractedBaseScore,

From 512536f5fe3465b329c1ccb6f7a2a7e23d8d6a65 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 8 Mar 2022 23:25:51 +0900
Subject: [PATCH 3299/5547] Fix unconditional null in `Equals` implementation

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

diff --git a/osu.Game/Online/Chat/Message.cs b/osu.Game/Online/Chat/Message.cs
index 3db63c3fca..ad004e2881 100644
--- a/osu.Game/Online/Chat/Message.cs
+++ b/osu.Game/Online/Chat/Message.cs
@@ -64,7 +64,7 @@ namespace osu.Game.Online.Chat
             if (ReferenceEquals(null, other)) return false;
             if (ReferenceEquals(this, other)) return true;
 
-            return Id.HasValue && Id == other?.Id;
+            return Id.HasValue && Id == other.Id;
         }
 
         // ReSharper disable once ImpureMethodCallOnReadonlyValueField

From e9a2d235420c87ef3c45d06e82997fc7248a426f Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 8 Mar 2022 23:35:35 +0900
Subject: [PATCH 3300/5547] Fix score order related test failure

---
 .../Visual/Ranking/TestSceneScorePanelList.cs      | 14 +++++++++++---
 1 file changed, 11 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Tests/Visual/Ranking/TestSceneScorePanelList.cs b/osu.Game.Tests/Visual/Ranking/TestSceneScorePanelList.cs
index e786b85f78..c65587d433 100644
--- a/osu.Game.Tests/Visual/Ranking/TestSceneScorePanelList.cs
+++ b/osu.Game.Tests/Visual/Ranking/TestSceneScorePanelList.cs
@@ -2,12 +2,14 @@
 // 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.Graphics;
 using osu.Framework.Testing;
 using osu.Framework.Utils;
 using osu.Game.Models;
+using osu.Game.Rulesets.Scoring;
 using osu.Game.Scoring;
 using osu.Game.Screens.Ranking;
 using osu.Game.Tests.Resources;
@@ -208,13 +210,19 @@ namespace osu.Game.Tests.Visual.Ranking
         public void TestKeyboardNavigation()
         {
             var lowestScore = TestResources.CreateTestScoreInfo();
-            lowestScore.MaxCombo = 100;
+            lowestScore.OnlineID = 3;
+            lowestScore.TotalScore = 0;
+            lowestScore.Statistics = new Dictionary<HitResult, int>();
 
             var middleScore = TestResources.CreateTestScoreInfo();
-            middleScore.MaxCombo = 200;
+            middleScore.OnlineID = 2;
+            middleScore.TotalScore = 0;
+            middleScore.Statistics = new Dictionary<HitResult, int>();
 
             var highestScore = TestResources.CreateTestScoreInfo();
-            highestScore.MaxCombo = 300;
+            highestScore.OnlineID = 1;
+            highestScore.TotalScore = 0;
+            highestScore.Statistics = new Dictionary<HitResult, int>();
 
             createListStep(() => new ScorePanelList());
 

From 94d5e2f2642a531a08e5f31c932bf9be779d2afb Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 9 Mar 2022 00:48:03 +0900
Subject: [PATCH 3301/5547] Fix test failure ripple through entire TestScene

---
 .../Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs     | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs
index 35992a0b38..5490c1e056 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs
@@ -43,8 +43,6 @@ namespace osu.Game.Tests.Visual.Multiplayer
             Dependencies.Cache(rulesets = new RealmRulesetStore(Realm));
             Dependencies.Cache(beatmaps = new BeatmapManager(LocalStorage, Realm, rulesets, null, audio, Resources, host, Beatmap.Default));
             Dependencies.Cache(Realm);
-
-            beatmaps.Import(TestResources.GetQuickTestBeatmapForImport()).WaitSafely();
         }
 
         [SetUp]
@@ -52,8 +50,10 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             AvailabilityTracker.SelectedItem.BindTo(selectedItem);
 
+            beatmaps.Import(TestResources.GetQuickTestBeatmapForImport()).WaitSafely();
             importedSet = beatmaps.GetAllUsableBeatmapSets().First();
             Beatmap.Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First());
+
             selectedItem.Value = new PlaylistItem(Beatmap.Value.BeatmapInfo)
             {
                 RulesetID = Beatmap.Value.BeatmapInfo.Ruleset.OnlineID

From 729af28a64c866f5eed51e9335ec151f5238d4b6 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 9 Mar 2022 00:48:12 +0900
Subject: [PATCH 3302/5547] Fix intermittent test failure

---
 .../Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs   | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs
index 5490c1e056..c86d5e482a 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs
@@ -92,16 +92,16 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             OsuButton readyButton = null;
 
-            AddAssert("ensure ready button enabled", () =>
+            AddUntilStep("ensure ready button enabled", () =>
             {
                 readyButton = button.ChildrenOfType<OsuButton>().Single();
                 return readyButton.Enabled.Value;
             });
 
             AddStep("delete beatmap", () => beatmaps.Delete(importedSet));
-            AddAssert("ready button disabled", () => !readyButton.Enabled.Value);
+            AddUntilStep("ready button disabled", () => !readyButton.Enabled.Value);
             AddStep("undelete beatmap", () => beatmaps.Undelete(importedSet));
-            AddAssert("ready button enabled back", () => readyButton.Enabled.Value);
+            AddUntilStep("ready button enabled back", () => readyButton.Enabled.Value);
         }
 
         [Test]

From a2ef086c1f23ebf9873ef55b6c4766983d9be455 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 9 Mar 2022 01:08:11 +0900
Subject: [PATCH 3303/5547] Fix potential crash on rare incorrect firing of
 skin dropdown update methods

As brought to light by https://gist.github.com/smoogipoo/56eda7ab56b9d1966556f2ca7a80a847.

There's a chance that the dropdown is not populated by the time
`updateSelectedSkinFromConfig` is fired via an external means (config
changes).
---
 osu.Game/Overlays/Settings/Sections/SkinSection.cs | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/osu.Game/Overlays/Settings/Sections/SkinSection.cs b/osu.Game/Overlays/Settings/Sections/SkinSection.cs
index 1dfe49945f..475c4bff8d 100644
--- a/osu.Game/Overlays/Settings/Sections/SkinSection.cs
+++ b/osu.Game/Overlays/Settings/Sections/SkinSection.cs
@@ -134,6 +134,9 @@ namespace osu.Game.Overlays.Settings.Sections
 
         private void updateSelectedSkinFromConfig()
         {
+            if (!skinDropdown.Items.Any())
+                return;
+
             Live<SkinInfo> skin = null;
 
             if (Guid.TryParse(configBindable.Value, out var configId))

From 56ad684f5b72271476ed430e78d45fb3e0c8e40a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 9 Mar 2022 01:11:34 +0900
Subject: [PATCH 3304/5547] Fix potential test failure on slow realm callback
 in `TestSceneBeatmapDownloadButton`

As brought to light by https://gist.github.com/smoogipoo/56eda7ab56b9d1966556f2ca7a80a847.
---
 .../Visual/Online/TestSceneBeatmapDownloadButton.cs           | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneBeatmapDownloadButton.cs b/osu.Game.Tests/Visual/Online/TestSceneBeatmapDownloadButton.cs
index d9f01622da..8d8879490d 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneBeatmapDownloadButton.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneBeatmapDownloadButton.cs
@@ -41,7 +41,7 @@ namespace osu.Game.Tests.Visual.Online
             AddUntilStep("ensure manager loaded", () => beatmaps != null);
             ensureSoleilyRemoved();
             createButtonWithBeatmap(createSoleily());
-            AddAssert("button state not downloaded", () => downloadButton.DownloadState == DownloadState.NotDownloaded);
+            AddUntilStep("button state not downloaded", () => downloadButton.DownloadState == DownloadState.NotDownloaded);
             AddStep("import soleily", () => beatmaps.Import(TestResources.GetQuickTestBeatmapForImport()));
 
             AddUntilStep("wait for beatmap import", () => beatmaps.GetAllUsableBeatmapSets().Any(b => b.OnlineID == 241526));
@@ -50,7 +50,7 @@ namespace osu.Game.Tests.Visual.Online
             createButtonWithBeatmap(createSoleily());
             AddUntilStep("button state downloaded", () => downloadButton.DownloadState == DownloadState.LocallyAvailable);
             ensureSoleilyRemoved();
-            AddAssert("button state not downloaded", () => downloadButton.DownloadState == DownloadState.NotDownloaded);
+            AddUntilStep("button state not downloaded", () => downloadButton.DownloadState == DownloadState.NotDownloaded);
         }
 
         private void ensureSoleilyRemoved()

From 286bafe326cf1f9b5bf35cd1e9c1f1867ad09781 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 9 Mar 2022 01:18:53 +0900
Subject: [PATCH 3305/5547] Refactor multiple `TestScenePlaySongSelect` test
 methods to be resilient to slow realm callbacks

---
 .../Visual/SongSelect/TestScenePlaySongSelect.cs   | 14 +++++++++-----
 1 file changed, 9 insertions(+), 5 deletions(-)

diff --git a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
index e2b50e38c2..c0c1e6b7a4 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
@@ -284,14 +284,13 @@ namespace osu.Game.Tests.Visual.SongSelect
         public void TestDummy()
         {
             createSongSelect();
-            AddAssert("dummy selected", () => songSelect.CurrentBeatmap == defaultBeatmap);
+            AddUntilStep("dummy selected", () => songSelect.CurrentBeatmap == defaultBeatmap);
 
             AddUntilStep("dummy shown on wedge", () => songSelect.CurrentBeatmapDetailsBeatmap == defaultBeatmap);
 
             addManyTestMaps();
-            AddWaitStep("wait for select", 3);
 
-            AddAssert("random map selected", () => songSelect.CurrentBeatmap != defaultBeatmap);
+            AddUntilStep("random map selected", () => songSelect.CurrentBeatmap != defaultBeatmap);
         }
 
         [Test]
@@ -299,9 +298,8 @@ namespace osu.Game.Tests.Visual.SongSelect
         {
             createSongSelect();
             addManyTestMaps();
-            AddWaitStep("wait for add", 3);
 
-            AddAssert("random map selected", () => songSelect.CurrentBeatmap != defaultBeatmap);
+            AddUntilStep("random map selected", () => songSelect.CurrentBeatmap != defaultBeatmap);
 
             AddStep(@"Sort by Artist", () => config.SetValue(OsuSetting.SongSelectSortingMode, SortMode.Artist));
             AddStep(@"Sort by Title", () => config.SetValue(OsuSetting.SongSelectSortingMode, SortMode.Title));
@@ -571,6 +569,8 @@ namespace osu.Game.Tests.Visual.SongSelect
 
             createSongSelect();
 
+            AddUntilStep("wait for selection", () => !Beatmap.IsDefault);
+
             AddStep("press ctrl+enter", () =>
             {
                 InputManager.PressKey(Key.ControlLeft);
@@ -605,6 +605,8 @@ namespace osu.Game.Tests.Visual.SongSelect
             addRulesetImportStep(0);
             createSongSelect();
 
+            AddUntilStep("wait for selection", () => !Beatmap.IsDefault);
+
             DrawableCarouselBeatmapSet set = null;
             AddStep("Find the DrawableCarouselBeatmapSet", () =>
             {
@@ -844,6 +846,8 @@ namespace osu.Game.Tests.Visual.SongSelect
 
             createSongSelect();
 
+            AddUntilStep("wait for selection", () => !Beatmap.IsDefault);
+
             AddStep("present score", () =>
             {
                 // this beatmap change should be overridden by the present.

From 233c8232d3c782f22f5352a442ed6c76de25a73c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 9 Mar 2022 01:21:46 +0900
Subject: [PATCH 3306/5547] Fix `TestSceneTopLocalRank.TestHighScoreSet` not
 waiting for potentially slow realm callback

As brought to light by https://gist.github.com/smoogipoo/56eda7ab56b9d1966556f2ca7a80a847.
---
 osu.Game.Tests/Visual/SongSelect/TestSceneTopLocalRank.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneTopLocalRank.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneTopLocalRank.cs
index 39680d157b..7bef7c8fce 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneTopLocalRank.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneTopLocalRank.cs
@@ -124,7 +124,7 @@ namespace osu.Game.Tests.Visual.SongSelect
             });
 
             AddUntilStep("Became present", () => topLocalRank.IsPresent);
-            AddAssert("Correct rank", () => topLocalRank.Rank == ScoreRank.B);
+            AddUntilStep("Correct rank", () => topLocalRank.Rank == ScoreRank.B);
 
             AddStep("Add higher score for current user", () =>
             {
@@ -137,7 +137,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                 scoreManager.Import(testScoreInfo2);
             });
 
-            AddAssert("Correct rank", () => topLocalRank.Rank == ScoreRank.S);
+            AddUntilStep("Correct rank", () => topLocalRank.Rank == ScoreRank.S);
         }
     }
 }

From e91226f5786e1d481c7bffcbe778a77056e6eed7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 8 Mar 2022 21:41:10 +0100
Subject: [PATCH 3307/5547] Fix 'auto-property never assigned to' inspections

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

diff --git a/osu.Game.Tests/Rulesets/Scoring/ScoreProcessorTest.cs b/osu.Game.Tests/Rulesets/Scoring/ScoreProcessorTest.cs
index d327f4844e..2a19d51c9d 100644
--- a/osu.Game.Tests/Rulesets/Scoring/ScoreProcessorTest.cs
+++ b/osu.Game.Tests/Rulesets/Scoring/ScoreProcessorTest.cs
@@ -322,8 +322,8 @@ namespace osu.Game.Tests.Rulesets.Scoring
 
             public override DifficultyCalculator CreateDifficultyCalculator(IWorkingBeatmap beatmap) => throw new System.NotImplementedException();
 
-            public override string Description { get; }
-            public override string ShortName { get; }
+            public override string Description => string.Empty;
+            public override string ShortName => string.Empty;
         }
 
         private class TestJudgement : Judgement

From e2001148d570ca139df57cf7cbd606adf8f50363 Mon Sep 17 00:00:00 2001
From: apollo-dw <83023433+apollo-dw@users.noreply.github.com>
Date: Tue, 8 Mar 2022 21:47:54 +0000
Subject: [PATCH 3308/5547] Implement strict tracking mod

---
 osu.Game.Rulesets.Osu/Mods/OsuModClassic.cs   |  3 +
 .../Mods/OsuModStrictTracking.cs              | 59 +++++++++++++++++++
 .../Objects/SliderTailCircle.cs               |  4 +-
 osu.Game.Rulesets.Osu/OsuRuleset.cs           |  1 +
 4 files changed, 66 insertions(+), 1 deletion(-)
 create mode 100644 osu.Game.Rulesets.Osu/Mods/OsuModStrictTracking.cs

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModClassic.cs b/osu.Game.Rulesets.Osu/Mods/OsuModClassic.cs
index e04a30d06c..f46573c494 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModClassic.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModClassic.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 osu.Framework.Bindables;
 using osu.Game.Configuration;
@@ -16,6 +17,8 @@ namespace osu.Game.Rulesets.Osu.Mods
 {
     public class OsuModClassic : ModClassic, IApplicableToHitObject, IApplicableToDrawableHitObject, IApplicableToDrawableRuleset<OsuHitObject>
     {
+        public override Type[] IncompatibleMods => new[] { typeof(OsuModStrictTracking) };
+
         [SettingSource("No slider head accuracy requirement", "Scores sliders proportionally to the number of ticks hit.")]
         public Bindable<bool> NoSliderHeadAccuracy { get; } = new BindableBool(true);
 
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModStrictTracking.cs b/osu.Game.Rulesets.Osu/Mods/OsuModStrictTracking.cs
new file mode 100644
index 0000000000..13da422049
--- /dev/null
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModStrictTracking.cs
@@ -0,0 +1,59 @@
+// 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.Sprites;
+using osu.Game.Beatmaps;
+using osu.Game.Rulesets.Mods;
+using osu.Game.Rulesets.Objects;
+using osu.Game.Rulesets.Objects.Drawables;
+using osu.Game.Rulesets.Osu.Objects;
+using osu.Game.Rulesets.Osu.Objects.Drawables;
+
+namespace osu.Game.Rulesets.Osu.Mods
+{
+    public class OsuModStrictTracking : Mod, IApplicableToDifficulty, IApplicableToDrawableHitObject, IApplicableToHitObject
+    {
+        public override string Name => @"Strict Tracking";
+        public override string Acronym => @"ST";
+        public override IconUsage? Icon => FontAwesome.Solid.PenFancy;
+        public override ModType Type => ModType.DifficultyIncrease;
+        public override string Description => @"Follow circles just got serious...";
+        public override double ScoreMultiplier => 1.0;
+        public override Type[] IncompatibleMods => new[] { typeof(ModClassic) };
+
+        public void ApplyToDifficulty(BeatmapDifficulty difficulty)
+        {
+            difficulty.SliderTickRate = 0.0;
+        }
+
+        public void ApplyToDrawableHitObject(DrawableHitObject drawable)
+        {
+            if (drawable is DrawableSlider slider)
+            {
+                slider.Tracking.ValueChanged += e =>
+                {
+                    if (e.NewValue || slider.Judged) return;
+
+                    slider.MissForcefully();
+
+                    foreach (var o in slider.NestedHitObjects)
+                    {
+                        if (o is DrawableOsuHitObject h && !o.Judged)
+                            h.MissForcefully();
+                    }
+                };
+            }
+        }
+
+        public void ApplyToHitObject(HitObject hitObject)
+        {
+            switch (hitObject)
+            {
+                case Slider slider:
+                    slider.TailCircle.JudgeAsSliderTick = true;
+                    break;
+            }
+        }
+    }
+}
diff --git a/osu.Game.Rulesets.Osu/Objects/SliderTailCircle.cs b/osu.Game.Rulesets.Osu/Objects/SliderTailCircle.cs
index f9450062f4..70459dc432 100644
--- a/osu.Game.Rulesets.Osu/Objects/SliderTailCircle.cs
+++ b/osu.Game.Rulesets.Osu/Objects/SliderTailCircle.cs
@@ -14,12 +14,14 @@ namespace osu.Game.Rulesets.Osu.Objects
     /// </summary>
     public class SliderTailCircle : SliderEndCircle
     {
+        public bool JudgeAsSliderTick = false;
+
         public SliderTailCircle(Slider slider)
             : base(slider)
         {
         }
 
-        public override Judgement CreateJudgement() => new SliderTailJudgement();
+        public override Judgement CreateJudgement() => JudgeAsSliderTick ? (OsuJudgement)new SliderTickJudgement() : new SliderTailJudgement();
 
         public class SliderTailJudgement : OsuJudgement
         {
diff --git a/osu.Game.Rulesets.Osu/OsuRuleset.cs b/osu.Game.Rulesets.Osu/OsuRuleset.cs
index 5ade164566..faaab1a8e2 100644
--- a/osu.Game.Rulesets.Osu/OsuRuleset.cs
+++ b/osu.Game.Rulesets.Osu/OsuRuleset.cs
@@ -159,6 +159,7 @@ namespace osu.Game.Rulesets.Osu
                         new MultiMod(new OsuModDoubleTime(), new OsuModNightcore()),
                         new OsuModHidden(),
                         new MultiMod(new OsuModFlashlight(), new OsuModBlinds()),
+                        new OsuModStrictTracking()
                     };
 
                 case ModType.Conversion:

From a3477c3841d4c85f81a5fe5546e695c8ebbd836c Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Tue, 8 Mar 2022 22:30:58 +0000
Subject: [PATCH 3309/5547] Implement `ChannelListing` for new chat design

Adds components `ChannelListing` and `ChannelListing` item with visual
test. Essentially a more simplified version of the existing
`ChannelSelectionOverlay` component.

Correctly implements `IFilterable` behaviour to filter child channel
items. Channel joined state is based on the underlying `Joined` bindable
of the `Channel` class.

Channel join/leave events are exposed via `OnRequestJoin` and
`OnRequestLeave` events which should be handled by parent component.

Requires a cached `OverlayColourScheme` instance to be provided by the
parent overlay component when added.
---
 .../Online/NewChat/TestSceneChannelListing.cs |  90 +++++++++
 osu.Game/Overlays/NewChat/ChannelListing.cs   |  85 +++++++++
 .../Overlays/NewChat/ChannelListingItem.cs    | 175 ++++++++++++++++++
 3 files changed, 350 insertions(+)
 create mode 100644 osu.Game.Tests/Visual/Online/NewChat/TestSceneChannelListing.cs
 create mode 100644 osu.Game/Overlays/NewChat/ChannelListing.cs
 create mode 100644 osu.Game/Overlays/NewChat/ChannelListingItem.cs

diff --git a/osu.Game.Tests/Visual/Online/NewChat/TestSceneChannelListing.cs b/osu.Game.Tests/Visual/Online/NewChat/TestSceneChannelListing.cs
new file mode 100644
index 0000000000..cbec23a305
--- /dev/null
+++ b/osu.Game.Tests/Visual/Online/NewChat/TestSceneChannelListing.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.Collections.Generic;
+using System.Linq;
+using NUnit.Framework;
+using osu.Framework.Allocation;
+using osu.Framework.Graphics;
+using osu.Framework.Testing;
+using osu.Framework.Utils;
+using osu.Game.Graphics.UserInterface;
+using osu.Game.Online.Chat;
+using osu.Game.Overlays;
+using osu.Game.Overlays.NewChat;
+using osuTK;
+
+namespace osu.Game.Tests.Visual.Online.NewChat
+{
+    [TestFixture]
+    public class TestSceneChannelListing : OsuTestScene
+    {
+        [Cached]
+        private readonly OverlayColourProvider overlayColours = new OverlayColourProvider(OverlayColourScheme.Pink);
+
+        private SearchTextBox search;
+        private ChannelListing listing;
+
+        [SetUp]
+        public void SetUp()
+        {
+            Schedule(() =>
+            {
+                Children = new Drawable[]
+                {
+                    search = new SearchTextBox
+                    {
+                        Anchor = Anchor.TopCentre,
+                        Origin = Anchor.TopCentre,
+                        Width = 300,
+                        Margin = new MarginPadding { Top = 100 },
+                    },
+                    listing = new ChannelListing
+                    {
+                        Size = new Vector2(800, 400),
+                        Anchor = Anchor.Centre,
+                        Origin = Anchor.Centre,
+                    },
+                };
+                listing.Show();
+                search.Current.ValueChanged += term => listing.SearchTerm = term.NewValue;
+            });
+        }
+
+        [SetUpSteps]
+        public void SetUpSteps()
+        {
+            AddStep("Add Join/Leave callbacks", () =>
+            {
+                listing.OnRequestJoin += channel => channel.Joined.Value = true;
+                listing.OnRequestLeave += channel => channel.Joined.Value = false;
+            });
+        }
+
+        [Test]
+        public void TestAddRandomChannels()
+        {
+            AddStep("Add Random Channels", () =>
+            {
+                listing.UpdateAvailableChannels(createRandomChannels(20));
+            });
+        }
+
+        private Channel createRandomChannel()
+        {
+            var id = RNG.Next(0, 10000);
+            return new Channel
+            {
+                Name = $"#channel-{id}",
+                Topic = RNG.Next(4) < 3 ? $"We talk about the number {id} here" : null,
+                Type = ChannelType.Public,
+                Id = id,
+            };
+        }
+
+        private List<Channel> createRandomChannels(int num)
+            => Enumerable.Range(0, num)
+                         .Select(_ => createRandomChannel())
+                         .ToList();
+    }
+}
diff --git a/osu.Game/Overlays/NewChat/ChannelListing.cs b/osu.Game/Overlays/NewChat/ChannelListing.cs
new file mode 100644
index 0000000000..79371d0fed
--- /dev/null
+++ b/osu.Game/Overlays/NewChat/ChannelListing.cs
@@ -0,0 +1,85 @@
+// 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 enable
+
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using osu.Framework.Allocation;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.Shapes;
+using osu.Game.Graphics.Containers;
+using osu.Game.Online.Chat;
+using osuTK;
+
+namespace osu.Game.Overlays.NewChat
+{
+    public class ChannelListing : VisibilityContainer
+    {
+        public event Action<Channel>? OnRequestJoin;
+        public event Action<Channel>? OnRequestLeave;
+
+        public string SearchTerm
+        {
+            get => flow.SearchTerm;
+            set => flow.SearchTerm = value;
+        }
+
+        private SearchContainer<ChannelListingItem> flow = null!;
+
+        [Resolved]
+        private OverlayColourProvider overlayColours { get; set; } = null!;
+
+        public ChannelListing()
+        {
+            Masking = true;
+        }
+
+        protected override void PopIn() => this.FadeIn();
+        protected override void PopOut() => this.FadeOut();
+
+        public void UpdateAvailableChannels(IEnumerable<Channel> newChannels)
+        {
+            flow.ChildrenEnumerable = newChannels.Where(c => c.Type == ChannelType.Public)
+                                                 .Select(c => new ChannelListingItem(c));
+
+            foreach (var item in flow.Children)
+            {
+                item.OnRequestJoin += channel => OnRequestJoin?.Invoke(channel);
+                item.OnRequestLeave += channel => OnRequestLeave?.Invoke(channel);
+            }
+        }
+
+        [BackgroundDependencyLoader]
+        private void load()
+        {
+            Children = new Drawable[]
+            {
+                new Box
+                {
+                    RelativeSizeAxes = Axes.Both,
+                    Colour = overlayColours.Background4,
+                },
+                new OsuScrollContainer
+                {
+                    RelativeSizeAxes = Axes.Both,
+                    ScrollbarAnchor = Anchor.TopRight,
+                    Child = flow = new SearchContainer<ChannelListingItem>
+                    {
+                        Direction = FillDirection.Vertical,
+                        RelativeSizeAxes = Axes.X,
+                        AutoSizeAxes = Axes.Y,
+                        Spacing = new Vector2(3),
+                        Padding = new MarginPadding
+                        {
+                            Vertical = 13,
+                            Horizontal = 15,
+                        },
+                    },
+                },
+            };
+        }
+    }
+}
diff --git a/osu.Game/Overlays/NewChat/ChannelListingItem.cs b/osu.Game/Overlays/NewChat/ChannelListingItem.cs
new file mode 100644
index 0000000000..845db4e802
--- /dev/null
+++ b/osu.Game/Overlays/NewChat/ChannelListingItem.cs
@@ -0,0 +1,175 @@
+// 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 enable
+
+using System;
+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.Graphics.Sprites;
+using osu.Framework.Input.Events;
+using osu.Game.Graphics;
+using osu.Game.Graphics.Containers;
+using osu.Game.Graphics.Sprites;
+using osu.Game.Online.Chat;
+using osuTK;
+
+namespace osu.Game.Overlays.NewChat
+{
+    public class ChannelListingItem : OsuClickableContainer, IFilterable
+    {
+        public event Action<Channel>? OnRequestJoin;
+        public event Action<Channel>? OnRequestLeave;
+
+        public bool FilteringActive { get; set; }
+        public IEnumerable<string> FilterTerms => new[] { channel.Name, channel.Topic ?? string.Empty };
+        public bool MatchingFilter
+        {
+            set => this.FadeTo(value ? 1f : 0f, 100);
+        }
+
+        private readonly float TEXT_SIZE = 18;
+        private readonly float ICON_SIZE = 14;
+        private readonly Channel channel;
+
+        private Colour4 selectedColour;
+        private Colour4 normalColour;
+
+        private Box hoverBox = null!;
+        private SpriteIcon checkbox = null!;
+        private OsuSpriteText channelText = null!;
+        private IBindable<bool> channelJoined = null!;
+
+        [Resolved]
+        private OverlayColourProvider overlayColours { get; set; } = null!;
+
+        public ChannelListingItem(Channel channel)
+        {
+            this.channel = channel;
+
+            Masking = true;
+            CornerRadius = 5;
+            RelativeSizeAxes = Axes.X;
+            Height = 20;
+        }
+
+        protected override bool OnHover(HoverEvent e)
+        {
+            hoverBox.Show();
+            return base.OnHover(e);
+        }
+
+        protected override void OnHoverLost(HoverLostEvent e)
+        {
+            hoverBox.Hide();
+            base.OnHoverLost(e);
+        }
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            // Set colours
+            normalColour = overlayColours.Light3;
+            selectedColour = Colour4.White;
+
+            // Set handlers for state display
+            channelJoined = channel.Joined.GetBoundCopy();
+            channelJoined.BindValueChanged(change =>
+            {
+                if (change.NewValue)
+                {
+                    checkbox.Show();
+                    channelText.Colour = selectedColour;
+                }
+                else
+                {
+                    checkbox.Hide();
+                    channelText.Colour = normalColour;
+                }
+            }, true);
+
+            // Set action on click
+            Action = () => (channelJoined.Value ? OnRequestLeave : OnRequestJoin)?.Invoke(channel);
+        }
+
+        [BackgroundDependencyLoader]
+        private void load()
+        {
+            Children = new Drawable[]
+            {
+                hoverBox = new Box
+                {
+                    RelativeSizeAxes = Axes.Both,
+                    Colour = overlayColours.Background3,
+                    Alpha = 0f,
+                },
+                new GridContainer
+                {
+                    RelativeSizeAxes = Axes.Both,
+                    ColumnDimensions = new Dimension[]
+                    {
+                        new Dimension(GridSizeMode.Absolute, 40),
+                        new Dimension(GridSizeMode.Absolute, 200),
+                        new Dimension(GridSizeMode.Absolute, 400),
+                        new Dimension(GridSizeMode.AutoSize),
+                        new Dimension(),
+                    },
+                    Content = new[]
+                    {
+                        new Drawable[]
+                        {
+                            checkbox = new SpriteIcon
+                            {
+                                Anchor = Anchor.CentreLeft,
+                                Origin = Anchor.CentreLeft,
+                                Margin = new MarginPadding { Left = 15 },
+                                Icon = FontAwesome.Solid.Check,
+                                Size = new Vector2(ICON_SIZE),
+                            },
+                            channelText = new OsuSpriteText
+                            {
+                                Anchor = Anchor.CentreLeft,
+                                Origin = Anchor.CentreLeft,
+                                Text = $"# {channel.Name.Substring(1)}",
+                                Font = OsuFont.Torus.With(size: TEXT_SIZE, weight: FontWeight.Medium),
+                                Margin = new MarginPadding { Bottom = 2 },
+                            },
+                            new OsuSpriteText
+                            {
+                                Anchor = Anchor.CentreLeft,
+                                Origin = Anchor.CentreLeft,
+                                Text = channel.Topic,
+                                Font = OsuFont.Torus.With(size: TEXT_SIZE),
+                                Margin = new MarginPadding { Bottom = 2 },
+                                Colour = Colour4.White,
+                            },
+                            new SpriteIcon
+                            {
+                                Anchor = Anchor.CentreLeft,
+                                Origin = Anchor.CentreLeft,
+                                Icon = FontAwesome.Solid.User,
+                                Size = new Vector2(ICON_SIZE),
+                                Margin = new MarginPadding { Right = 5 },
+                                Colour = overlayColours.Light3,
+                            },
+                            new OsuSpriteText
+                            {
+                                Anchor = Anchor.CentreLeft,
+                                Origin = Anchor.CentreLeft,
+                                Text = "0",
+                                Font = OsuFont.Numeric.With(size: TEXT_SIZE, weight: FontWeight.Medium),
+                                Margin = new MarginPadding { Bottom = 2 },
+                                Colour = overlayColours.Light3,
+                            },
+                        },
+                    },
+                },
+            };
+        }
+    }
+}

From 7dd51a9c4a69ab6b6ef2618bc25c4eec08689002 Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Wed, 9 Mar 2022 00:12:44 +0000
Subject: [PATCH 3310/5547] Reorder class attributes

---
 osu.Game/Overlays/NewChat/ChannelListing.cs   |  40 +++----
 .../Overlays/NewChat/ChannelListingItem.cs    | 110 +++++++++---------
 2 files changed, 72 insertions(+), 78 deletions(-)

diff --git a/osu.Game/Overlays/NewChat/ChannelListing.cs b/osu.Game/Overlays/NewChat/ChannelListing.cs
index 79371d0fed..3de6364303 100644
--- a/osu.Game/Overlays/NewChat/ChannelListing.cs
+++ b/osu.Game/Overlays/NewChat/ChannelListing.cs
@@ -30,27 +30,7 @@ namespace osu.Game.Overlays.NewChat
         private SearchContainer<ChannelListingItem> flow = null!;
 
         [Resolved]
-        private OverlayColourProvider overlayColours { get; set; } = null!;
-
-        public ChannelListing()
-        {
-            Masking = true;
-        }
-
-        protected override void PopIn() => this.FadeIn();
-        protected override void PopOut() => this.FadeOut();
-
-        public void UpdateAvailableChannels(IEnumerable<Channel> newChannels)
-        {
-            flow.ChildrenEnumerable = newChannels.Where(c => c.Type == ChannelType.Public)
-                                                 .Select(c => new ChannelListingItem(c));
-
-            foreach (var item in flow.Children)
-            {
-                item.OnRequestJoin += channel => OnRequestJoin?.Invoke(channel);
-                item.OnRequestLeave += channel => OnRequestLeave?.Invoke(channel);
-            }
-        }
+        private OverlayColourProvider colourProvider { get; set; } = null!;
 
         [BackgroundDependencyLoader]
         private void load()
@@ -60,7 +40,7 @@ namespace osu.Game.Overlays.NewChat
                 new Box
                 {
                     RelativeSizeAxes = Axes.Both,
-                    Colour = overlayColours.Background4,
+                    Colour = colourProvider.Background4,
                 },
                 new OsuScrollContainer
                 {
@@ -81,5 +61,21 @@ namespace osu.Game.Overlays.NewChat
                 },
             };
         }
+
+        public void UpdateAvailableChannels(IEnumerable<Channel> newChannels)
+        {
+            flow.ChildrenEnumerable = newChannels.Where(c => c.Type == ChannelType.Public)
+                                                 .Select(c => new ChannelListingItem(c));
+
+            foreach (var item in flow.Children)
+            {
+                item.OnRequestJoin += channel => OnRequestJoin?.Invoke(channel);
+                item.OnRequestLeave += channel => OnRequestLeave?.Invoke(channel);
+            }
+        }
+
+        protected override void PopIn() => this.FadeIn();
+
+        protected override void PopOut() => this.FadeOut();
     }
 }
diff --git a/osu.Game/Overlays/NewChat/ChannelListingItem.cs b/osu.Game/Overlays/NewChat/ChannelListingItem.cs
index 845db4e802..7e7cf36e91 100644
--- a/osu.Game/Overlays/NewChat/ChannelListingItem.cs
+++ b/osu.Game/Overlays/NewChat/ChannelListingItem.cs
@@ -27,15 +27,13 @@ namespace osu.Game.Overlays.NewChat
 
         public bool FilteringActive { get; set; }
         public IEnumerable<string> FilterTerms => new[] { channel.Name, channel.Topic ?? string.Empty };
-        public bool MatchingFilter
-        {
-            set => this.FadeTo(value ? 1f : 0f, 100);
-        }
+        public bool MatchingFilter { set => this.FadeTo(value ? 1f : 0f, 100); }
 
-        private readonly float TEXT_SIZE = 18;
-        private readonly float ICON_SIZE = 14;
         private readonly Channel channel;
 
+        private const float TEXT_SIZE = 18;
+        private const float ICON_SIZE = 14;
+
         private Colour4 selectedColour;
         private Colour4 normalColour;
 
@@ -45,73 +43,33 @@ namespace osu.Game.Overlays.NewChat
         private IBindable<bool> channelJoined = null!;
 
         [Resolved]
-        private OverlayColourProvider overlayColours { get; set; } = null!;
+        private OverlayColourProvider colourProvider { get; set; } = null!;
 
         public ChannelListingItem(Channel channel)
         {
             this.channel = channel;
-
-            Masking = true;
-            CornerRadius = 5;
-            RelativeSizeAxes = Axes.X;
-            Height = 20;
-        }
-
-        protected override bool OnHover(HoverEvent e)
-        {
-            hoverBox.Show();
-            return base.OnHover(e);
-        }
-
-        protected override void OnHoverLost(HoverLostEvent e)
-        {
-            hoverBox.Hide();
-            base.OnHoverLost(e);
-        }
-
-        protected override void LoadComplete()
-        {
-            base.LoadComplete();
-
-            // Set colours
-            normalColour = overlayColours.Light3;
-            selectedColour = Colour4.White;
-
-            // Set handlers for state display
-            channelJoined = channel.Joined.GetBoundCopy();
-            channelJoined.BindValueChanged(change =>
-            {
-                if (change.NewValue)
-                {
-                    checkbox.Show();
-                    channelText.Colour = selectedColour;
-                }
-                else
-                {
-                    checkbox.Hide();
-                    channelText.Colour = normalColour;
-                }
-            }, true);
-
-            // Set action on click
-            Action = () => (channelJoined.Value ? OnRequestLeave : OnRequestJoin)?.Invoke(channel);
         }
 
         [BackgroundDependencyLoader]
         private void load()
         {
+            Masking = true;
+            CornerRadius = 5;
+            RelativeSizeAxes = Axes.X;
+            Height = 20;
+
             Children = new Drawable[]
             {
                 hoverBox = new Box
                 {
                     RelativeSizeAxes = Axes.Both,
-                    Colour = overlayColours.Background3,
+                    Colour = colourProvider.Background3,
                     Alpha = 0f,
                 },
                 new GridContainer
                 {
                     RelativeSizeAxes = Axes.Both,
-                    ColumnDimensions = new Dimension[]
+                    ColumnDimensions = new[]
                     {
                         new Dimension(GridSizeMode.Absolute, 40),
                         new Dimension(GridSizeMode.Absolute, 200),
@@ -155,7 +113,7 @@ namespace osu.Game.Overlays.NewChat
                                 Icon = FontAwesome.Solid.User,
                                 Size = new Vector2(ICON_SIZE),
                                 Margin = new MarginPadding { Right = 5 },
-                                Colour = overlayColours.Light3,
+                                Colour = colourProvider.Light3,
                             },
                             new OsuSpriteText
                             {
@@ -164,12 +122,52 @@ namespace osu.Game.Overlays.NewChat
                                 Text = "0",
                                 Font = OsuFont.Numeric.With(size: TEXT_SIZE, weight: FontWeight.Medium),
                                 Margin = new MarginPadding { Bottom = 2 },
-                                Colour = overlayColours.Light3,
+                                Colour = colourProvider.Light3,
                             },
                         },
                     },
                 },
             };
         }
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            // Set colours
+            normalColour = colourProvider.Light3;
+            selectedColour = Colour4.White;
+
+            // Set handlers for state display
+            channelJoined = channel.Joined.GetBoundCopy();
+            channelJoined.BindValueChanged(change =>
+            {
+                if (change.NewValue)
+                {
+                    checkbox.Show();
+                    channelText.Colour = selectedColour;
+                }
+                else
+                {
+                    checkbox.Hide();
+                    channelText.Colour = normalColour;
+                }
+            }, true);
+
+            // Set action on click
+            Action = () => (channelJoined.Value ? OnRequestLeave : OnRequestJoin)?.Invoke(channel);
+        }
+
+        protected override bool OnHover(HoverEvent e)
+        {
+            hoverBox.Show();
+            return base.OnHover(e);
+        }
+
+        protected override void OnHoverLost(HoverLostEvent e)
+        {
+            hoverBox.Hide();
+            base.OnHoverLost(e);
+        }
     }
 }

From 7daa2d0ea4dd67f4aea73274ee2db9198f8b1871 Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Wed, 9 Mar 2022 00:33:46 +0000
Subject: [PATCH 3311/5547] Use correct fonts and colours in ChannelListingItem

---
 .../Overlays/NewChat/ChannelListingItem.cs    | 37 ++++++++-----------
 1 file changed, 15 insertions(+), 22 deletions(-)

diff --git a/osu.Game/Overlays/NewChat/ChannelListingItem.cs b/osu.Game/Overlays/NewChat/ChannelListingItem.cs
index 7e7cf36e91..77d5599c9b 100644
--- a/osu.Game/Overlays/NewChat/ChannelListingItem.cs
+++ b/osu.Game/Overlays/NewChat/ChannelListingItem.cs
@@ -31,20 +31,18 @@ namespace osu.Game.Overlays.NewChat
 
         private readonly Channel channel;
 
-        private const float TEXT_SIZE = 18;
-        private const float ICON_SIZE = 14;
-
-        private Colour4 selectedColour;
-        private Colour4 normalColour;
-
         private Box hoverBox = null!;
         private SpriteIcon checkbox = null!;
         private OsuSpriteText channelText = null!;
+        private OsuSpriteText topicText = null!;
         private IBindable<bool> channelJoined = null!;
 
         [Resolved]
         private OverlayColourProvider colourProvider { get; set; } = null!;
 
+        private const float text_size = 18;
+        private const float icon_size = 14;
+
         public ChannelListingItem(Channel channel)
         {
             this.channel = channel;
@@ -87,31 +85,30 @@ namespace osu.Game.Overlays.NewChat
                                 Origin = Anchor.CentreLeft,
                                 Margin = new MarginPadding { Left = 15 },
                                 Icon = FontAwesome.Solid.Check,
-                                Size = new Vector2(ICON_SIZE),
+                                Size = new Vector2(icon_size),
                             },
                             channelText = new OsuSpriteText
                             {
                                 Anchor = Anchor.CentreLeft,
                                 Origin = Anchor.CentreLeft,
-                                Text = $"# {channel.Name.Substring(1)}",
-                                Font = OsuFont.Torus.With(size: TEXT_SIZE, weight: FontWeight.Medium),
+                                Text = channel.Name,
+                                Font = OsuFont.Torus.With(size: text_size, weight: FontWeight.SemiBold),
                                 Margin = new MarginPadding { Bottom = 2 },
                             },
-                            new OsuSpriteText
+                            topicText = new OsuSpriteText
                             {
                                 Anchor = Anchor.CentreLeft,
                                 Origin = Anchor.CentreLeft,
                                 Text = channel.Topic,
-                                Font = OsuFont.Torus.With(size: TEXT_SIZE),
+                                Font = OsuFont.Torus.With(size: text_size),
                                 Margin = new MarginPadding { Bottom = 2 },
-                                Colour = Colour4.White,
                             },
                             new SpriteIcon
                             {
                                 Anchor = Anchor.CentreLeft,
                                 Origin = Anchor.CentreLeft,
                                 Icon = FontAwesome.Solid.User,
-                                Size = new Vector2(ICON_SIZE),
+                                Size = new Vector2(icon_size),
                                 Margin = new MarginPadding { Right = 5 },
                                 Colour = colourProvider.Light3,
                             },
@@ -120,7 +117,7 @@ namespace osu.Game.Overlays.NewChat
                                 Anchor = Anchor.CentreLeft,
                                 Origin = Anchor.CentreLeft,
                                 Text = "0",
-                                Font = OsuFont.Numeric.With(size: TEXT_SIZE, weight: FontWeight.Medium),
+                                Font = OsuFont.Torus.With(size: text_size),
                                 Margin = new MarginPadding { Bottom = 2 },
                                 Colour = colourProvider.Light3,
                             },
@@ -134,27 +131,23 @@ namespace osu.Game.Overlays.NewChat
         {
             base.LoadComplete();
 
-            // Set colours
-            normalColour = colourProvider.Light3;
-            selectedColour = Colour4.White;
-
-            // Set handlers for state display
             channelJoined = channel.Joined.GetBoundCopy();
             channelJoined.BindValueChanged(change =>
             {
                 if (change.NewValue)
                 {
                     checkbox.Show();
-                    channelText.Colour = selectedColour;
+                    channelText.Colour = Colour4.White;
+                    topicText.Colour = Colour4.White;
                 }
                 else
                 {
                     checkbox.Hide();
-                    channelText.Colour = normalColour;
+                    channelText.Colour = colourProvider.Light3;
+                    topicText.Colour = colourProvider.Content2;
                 }
             }, true);
 
-            // Set action on click
             Action = () => (channelJoined.Value ? OnRequestLeave : OnRequestJoin)?.Invoke(channel);
         }
 

From 9720a06b16105f23fc9f151e67d3af0cce63004d Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Wed, 9 Mar 2022 00:52:33 +0000
Subject: [PATCH 3312/5547] Use `int` in ChannelListing test

---
 osu.Game.Tests/Visual/Online/NewChat/TestSceneChannelListing.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/Online/NewChat/TestSceneChannelListing.cs b/osu.Game.Tests/Visual/Online/NewChat/TestSceneChannelListing.cs
index cbec23a305..8f955c0520 100644
--- a/osu.Game.Tests/Visual/Online/NewChat/TestSceneChannelListing.cs
+++ b/osu.Game.Tests/Visual/Online/NewChat/TestSceneChannelListing.cs
@@ -72,7 +72,7 @@ namespace osu.Game.Tests.Visual.Online.NewChat
 
         private Channel createRandomChannel()
         {
-            var id = RNG.Next(0, 10000);
+            int id = RNG.Next(0, 10000);
             return new Channel
             {
                 Name = $"#channel-{id}",

From 6bf436cd62d0c844d74964837fb2387ebe112725 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 9 Mar 2022 13:52:58 +0900
Subject: [PATCH 3313/5547] Only null the realm write task if it actually
 completed

---
 .../Screens/Play/PlayerSettings/BeatmapOffsetControl.cs    | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs b/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
index 9e280fdca2..42091c521f 100644
--- a/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
+++ b/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
@@ -129,8 +129,11 @@ namespace osu.Game.Screens.Play.PlayerSettings
                     if (realmWriteTask == null)
                         Current.Value = val;
 
-                    // we can also mark any in-flight write that is managed locally as "seen" and start handling any incoming changes again.
-                    realmWriteTask = null;
+                    if (realmWriteTask?.IsCompleted == true)
+                    {
+                        // we can also mark any in-flight write that is managed locally as "seen" and start handling any incoming changes again.
+                        realmWriteTask = null;
+                    }
                 });
 
             Current.BindValueChanged(currentChanged);

From 3ced5e7904877e7b989984bff414b1ce2c83dd47 Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Wed, 9 Mar 2022 13:09:33 +0800
Subject: [PATCH 3314/5547] Rename `Distance` to `DistanceFromPrevious`

---
 osu.Game.Rulesets.Osu/Mods/OsuModRandom.cs | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModRandom.cs b/osu.Game.Rulesets.Osu/Mods/OsuModRandom.cs
index babc4311ee..e450127488 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModRandom.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModRandom.cs
@@ -73,19 +73,19 @@ namespace osu.Game.Rulesets.Osu.Mods
 
                 if (previous == null)
                 {
-                    current.Distance = (float)(rng.NextDouble() * OsuPlayfield.BASE_SIZE.X / 2);
+                    current.DistanceFromPrevious = (float)(rng.NextDouble() * OsuPlayfield.BASE_SIZE.X / 2);
                     current.RelativeAngle = (float)(rng.NextDouble() * 2 * Math.PI - Math.PI);
                 }
                 else
                 {
-                    current.Distance = Vector2.Distance(previous.EndPositionOriginal, current.PositionOriginal);
+                    current.DistanceFromPrevious = Vector2.Distance(previous.EndPositionOriginal, current.PositionOriginal);
 
                     // The max. angle (relative to the angle of the vector pointing from the 2nd last to the last hit object)
                     // is proportional to the distance between the last and the current hit object
                     // to allow jumps and prevent too sharp turns during streams.
 
                     // Allow maximum jump angle when jump distance is more than half of playfield diagonal length
-                    current.RelativeAngle = rateOfChangeMultiplier * 2 * (float)Math.PI * Math.Min(1f, current.Distance / (playfield_diagonal * 0.5f));
+                    current.RelativeAngle = rateOfChangeMultiplier * 2 * (float)Math.PI * Math.Min(1f, current.DistanceFromPrevious / (playfield_diagonal * 0.5f));
                 }
 
                 previous = current;
@@ -177,8 +177,8 @@ namespace osu.Game.Rulesets.Osu.Mods
             float absoluteAngle = previousAbsoluteAngle + current.RelativeAngle;
 
             var posRelativeToPrev = new Vector2(
-                current.Distance * (float)Math.Cos(absoluteAngle),
-                current.Distance * (float)Math.Sin(absoluteAngle)
+                current.DistanceFromPrevious * (float)Math.Cos(absoluteAngle),
+                current.DistanceFromPrevious * (float)Math.Sin(absoluteAngle)
             );
 
             Vector2 lastEndPosition = previous?.EndPositionRandomised ?? playfield_centre;
@@ -349,9 +349,9 @@ namespace osu.Game.Rulesets.Osu.Mods
             /// The jump distance from the previous hit object to this one.
             /// </summary>
             /// <remarks>
-            /// <see cref="Distance"/> of the first hit object in a beatmap is relative to the playfield center.
+            /// <see cref="DistanceFromPrevious"/> of the first hit object in a beatmap is relative to the playfield center.
             /// </remarks>
-            public float Distance { get; set; }
+            public float DistanceFromPrevious { get; set; }
 
             public Vector2 PositionOriginal { get; }
             public Vector2 PositionRandomised { get; set; }

From e3cf2c6acd3e0aecd307e458acbe5f251258f488 Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Wed, 9 Mar 2022 13:18:57 +0800
Subject: [PATCH 3315/5547] Merge `getAbsoluteAngle` into
 `computeRandomisedPosition`

---
 osu.Game.Rulesets.Osu/Mods/OsuModRandom.cs | 36 ++++++++++------------
 1 file changed, 17 insertions(+), 19 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModRandom.cs b/osu.Game.Rulesets.Osu/Mods/OsuModRandom.cs
index e450127488..895dc9a506 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModRandom.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModRandom.cs
@@ -4,6 +4,7 @@
 using System;
 using System.Collections.Generic;
 using System.Linq;
+using JetBrains.Annotations;
 using osu.Framework.Graphics.Primitives;
 using osu.Framework.Utils;
 using osu.Game.Beatmaps;
@@ -115,7 +116,7 @@ namespace osu.Game.Rulesets.Osu.Mods
                     continue;
                 }
 
-                computeRandomisedPosition(getAbsoluteAngle(hitObjects, i - 1), previous, current);
+                computeRandomisedPosition(current, previous, i > 1 ? randomObjects[i - 2] : null);
 
                 // Move hit objects back into the playfield if they are outside of it
                 Vector2 shift = Vector2.Zero;
@@ -151,29 +152,23 @@ namespace osu.Game.Rulesets.Osu.Mods
             }
         }
 
-        /// <summary>
-        /// Get the absolute angle of a vector pointing from the previous hit object to the one denoted by <paramref name="hitObjectIndex"/>.
-        /// </summary>
-        /// <param name="hitObjects">A list of all hit objects in the beatmap.</param>
-        /// <param name="hitObjectIndex">The hit object that the vector should point to.</param>
-        /// <returns>The absolute angle of the aforementioned vector.</returns>
-        private float getAbsoluteAngle(IReadOnlyList<OsuHitObject> hitObjects, int hitObjectIndex)
-        {
-            if (hitObjectIndex < 0) return 0;
-
-            Vector2 previousPosition = hitObjectIndex == 0 ? playfield_centre : hitObjects[hitObjectIndex - 1].EndPosition;
-            Vector2 relativePosition = hitObjects[hitObjectIndex].Position - previousPosition;
-            return (float)Math.Atan2(relativePosition.Y, relativePosition.X);
-        }
-
         /// <summary>
         /// Compute the randomised position of a hit object while attempting to keep it inside the playfield.
         /// </summary>
-        /// <param name="previousAbsoluteAngle">The direction of movement of the player's cursor before it starts to approach the current hit object.</param>
-        /// <param name="previous">The <see cref="RandomObjectInfo"/> representing the hit object immediately preceding the current one.</param>
         /// <param name="current">The <see cref="RandomObjectInfo"/> representing the hit object to have the randomised position computed for.</param>
-        private void computeRandomisedPosition(float previousAbsoluteAngle, RandomObjectInfo previous, RandomObjectInfo current)
+        /// <param name="previous">The <see cref="RandomObjectInfo"/> representing the hit object immediately preceding the current one.</param>
+        /// <param name="beforePrevious">The <see cref="RandomObjectInfo"/> representing the hit object immediately preceding the <paramref name="previous"/> one.</param>
+        private void computeRandomisedPosition(RandomObjectInfo current, [CanBeNull] RandomObjectInfo previous, [CanBeNull] RandomObjectInfo beforePrevious)
         {
+            float previousAbsoluteAngle = 0f;
+
+            if (previous != null)
+            {
+                Vector2 earliestPosition = beforePrevious == null ? playfield_centre : beforePrevious.HitObject.EndPosition;
+                Vector2 relativePosition = previous.HitObject.Position - earliestPosition;
+                previousAbsoluteAngle = (float)Math.Atan2(relativePosition.Y, relativePosition.X);
+            }
+
             float absoluteAngle = previousAbsoluteAngle + current.RelativeAngle;
 
             var posRelativeToPrev = new Vector2(
@@ -359,10 +354,13 @@ namespace osu.Game.Rulesets.Osu.Mods
             public Vector2 EndPositionOriginal { get; }
             public Vector2 EndPositionRandomised { get; set; }
 
+            public OsuHitObject HitObject { get; }
+
             public RandomObjectInfo(OsuHitObject hitObject)
             {
                 PositionRandomised = PositionOriginal = hitObject.Position;
                 EndPositionRandomised = EndPositionOriginal = hitObject.EndPosition;
+                HitObject = hitObject;
             }
         }
     }

From ad0ca5673a445f5a1e7fb38da44af8050ae7fa38 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 9 Mar 2022 14:39:02 +0900
Subject: [PATCH 3316/5547] Fix avatar not clickable after watching replay

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

diff --git a/osu.Game/Users/Drawables/ClickableAvatar.cs b/osu.Game/Users/Drawables/ClickableAvatar.cs
index e3cfaf1d14..34c87568a1 100644
--- a/osu.Game/Users/Drawables/ClickableAvatar.cs
+++ b/osu.Game/Users/Drawables/ClickableAvatar.cs
@@ -64,7 +64,7 @@ namespace osu.Game.Users.Drawables
 
         private void openProfile()
         {
-            if (user?.Id > 1)
+            if (user?.Id > 1 || !string.IsNullOrEmpty(user?.Username))
                 game?.ShowUser(user);
         }
 

From b07a1e8d09b50bd8511dabcbc75c49a55439687c Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 9 Mar 2022 15:38:00 +0900
Subject: [PATCH 3317/5547] Fix unable to copy playlist rooms without first
 opening

---
 osu.Game/Online/Rooms/Room.cs                 | 19 +--------
 .../OnlinePlay/Lounge/DrawableLoungeRoom.cs   |  2 +-
 .../OnlinePlay/Lounge/LoungeSubScreen.cs      | 39 +++++++++++++++++++
 3 files changed, 41 insertions(+), 19 deletions(-)

diff --git a/osu.Game/Online/Rooms/Room.cs b/osu.Game/Online/Rooms/Room.cs
index a33150fe08..543b176b51 100644
--- a/osu.Game/Online/Rooms/Room.cs
+++ b/osu.Game/Online/Rooms/Room.cs
@@ -10,12 +10,11 @@ using osu.Game.IO.Serialization.Converters;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Rooms.RoomStatuses;
-using osu.Game.Utils;
 
 namespace osu.Game.Online.Rooms
 {
     [JsonObject(MemberSerialization.OptIn)]
-    public class Room : IDeepCloneable<Room>
+    public class Room
     {
         [Cached]
         [JsonProperty("id")]
@@ -153,22 +152,6 @@ namespace osu.Game.Online.Rooms
             Password.BindValueChanged(p => HasPassword.Value = !string.IsNullOrEmpty(p.NewValue));
         }
 
-        /// <summary>
-        /// Create a copy of this room without online information.
-        /// Should be used to create a local copy of a room for submitting in the future.
-        /// </summary>
-        public Room DeepClone()
-        {
-            var copy = new Room();
-
-            copy.CopyFrom(this);
-
-            // ID must be unset as we use this as a marker for whether this is a client-side (not-yet-created) room or not.
-            copy.RoomID.Value = null;
-
-            return copy;
-        }
-
         public void CopyFrom(Room other)
         {
             RoomID.Value = other.RoomID.Value;
diff --git a/osu.Game/Screens/OnlinePlay/Lounge/DrawableLoungeRoom.cs b/osu.Game/Screens/OnlinePlay/Lounge/DrawableLoungeRoom.cs
index 27743e709f..7baa346c6f 100644
--- a/osu.Game/Screens/OnlinePlay/Lounge/DrawableLoungeRoom.cs
+++ b/osu.Game/Screens/OnlinePlay/Lounge/DrawableLoungeRoom.cs
@@ -128,7 +128,7 @@ namespace osu.Game.Screens.OnlinePlay.Lounge
         {
             new OsuMenuItem("Create copy", MenuItemType.Standard, () =>
             {
-                lounge?.Open(Room.DeepClone());
+                lounge?.OpenCopy(Room);
             })
         };
 
diff --git a/osu.Game/Screens/OnlinePlay/Lounge/LoungeSubScreen.cs b/osu.Game/Screens/OnlinePlay/Lounge/LoungeSubScreen.cs
index cd1c8a0a64..08b4ae9db2 100644
--- a/osu.Game/Screens/OnlinePlay/Lounge/LoungeSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Lounge/LoungeSubScreen.cs
@@ -20,6 +20,7 @@ using osu.Framework.Threading;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Input;
+using osu.Game.Online.API;
 using osu.Game.Online.Rooms;
 using osu.Game.Overlays;
 using osu.Game.Rulesets;
@@ -63,6 +64,9 @@ namespace osu.Game.Screens.OnlinePlay.Lounge
         [Resolved]
         private IBindable<RulesetInfo> ruleset { get; set; }
 
+        [Resolved]
+        private IAPIProvider api { get; set; }
+
         [CanBeNull]
         private IDisposable joiningRoomOperation { get; set; }
 
@@ -310,6 +314,41 @@ namespace osu.Game.Screens.OnlinePlay.Lounge
             });
         });
 
+        /// <summary>
+        /// Copies a room and opens it as a fresh (not-yet-created) one.
+        /// </summary>
+        /// <param name="room">The room to copy.</param>
+        public void OpenCopy(Room room)
+        {
+            Debug.Assert(room.RoomID.Value != null);
+
+            if (joiningRoomOperation != null)
+                return;
+
+            joiningRoomOperation = ongoingOperationTracker?.BeginOperation();
+
+            var req = new GetRoomRequest(room.RoomID.Value.Value);
+
+            req.Success += r =>
+            {
+                // ID must be unset as we use this as a marker for whether this is a client-side (not-yet-created) room or not.
+                r.RoomID.Value = null;
+
+                Open(r);
+
+                joiningRoomOperation?.Dispose();
+                joiningRoomOperation = null;
+            };
+
+            req.Failure += _ =>
+            {
+                joiningRoomOperation?.Dispose();
+                joiningRoomOperation = null;
+            };
+
+            api.Queue(req);
+        }
+
         /// <summary>
         /// Push a room as a new subscreen.
         /// </summary>

From 520d2d6cfa4b7e3206083e5c68ea8c04879d10b9 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 9 Mar 2022 16:06:39 +0900
Subject: [PATCH 3318/5547] Fix beatmap carousel panels accepting input while
 marked as not-visible

This is an issue as carousel panels manage their own animated state. If
they are marked as not-visible (done at a higher level, from filtering
or update pathways) but clicked while fading out, they will animate back
to a visible state but not be marked as visible.

No tests for this one as it's probably not worthwhile to test (and hard
to do so). Manual testing can be done with the following patch:

```diff
diff --git a/osu.Game/Screens/Select/BeatmapCarousel.cs
b/osu.Game/Screens/Select/BeatmapCarousel.cs
index c3d340ac61..3372242acc 100644
--- a/osu.Game/Screens/Select/BeatmapCarousel.cs
+++ b/osu.Game/Screens/Select/BeatmapCarousel.cs
@@ -255,7 +255,7 @@ private void
beatmapSetsChanged(IRealmCollection<BeatmapSetInfo> sender, ChangeS
             }

             foreach (int i in changes.NewModifiedIndices)
-                UpdateBeatmapSet(sender[i].Detach());
+                Scheduler.AddDelayed(() =>
                 UpdateBeatmapSet(sender[i].Detach()), 100, true);

             foreach (int i in changes.InsertedIndices)
                 UpdateBeatmapSet(sender[i].Detach());

```

- Enter gameplay and adjust beatmap offset then return to song select
  and click the flashing panel.
OR
- Enter editor and save then return to song select and click the
  flashing panel.

Closes https://github.com/ppy/osu/discussions/17171.
---
 osu.Game/Screens/Select/Carousel/DrawableCarouselItem.cs | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/osu.Game/Screens/Select/Carousel/DrawableCarouselItem.cs b/osu.Game/Screens/Select/Carousel/DrawableCarouselItem.cs
index cde3edad39..75bcdedec4 100644
--- a/osu.Game/Screens/Select/Carousel/DrawableCarouselItem.cs
+++ b/osu.Game/Screens/Select/Carousel/DrawableCarouselItem.cs
@@ -17,6 +17,9 @@ namespace osu.Game.Screens.Select.Carousel
 
         public override bool IsPresent => base.IsPresent || Item?.Visible == true;
 
+        public override bool HandlePositionalInput => Item?.Visible == true;
+        public override bool PropagatePositionalInputSubTree => Item?.Visible == true;
+
         public readonly CarouselHeader Header;
 
         /// <summary>

From 4839bd804466fb410884ee1f94eec40a84c86785 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 9 Mar 2022 16:47:47 +0900
Subject: [PATCH 3319/5547] Notify if copying room fails

Co-authored-by: Dean Herbert <pe@ppy.sh>
---
 osu.Game/Screens/OnlinePlay/Lounge/LoungeSubScreen.cs | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Screens/OnlinePlay/Lounge/LoungeSubScreen.cs b/osu.Game/Screens/OnlinePlay/Lounge/LoungeSubScreen.cs
index 08b4ae9db2..fb8647284f 100644
--- a/osu.Game/Screens/OnlinePlay/Lounge/LoungeSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Lounge/LoungeSubScreen.cs
@@ -340,8 +340,9 @@ namespace osu.Game.Screens.OnlinePlay.Lounge
                 joiningRoomOperation = null;
             };
 
-            req.Failure += _ =>
+            req.Failure += exception =>
             {
+                Logger.Error(exception, "Couldn't create a copy of this room.");
                 joiningRoomOperation?.Dispose();
                 joiningRoomOperation = null;
             };

From 75c6a676b42b4d51bd15b74a2254e0a559269169 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 9 Mar 2022 16:58:36 +0900
Subject: [PATCH 3320/5547] Apply `nullable` to `OsuModRandom` rather than
 using jetbrains annotations

---
 osu.Game.Rulesets.Osu/Mods/OsuModRandom.cs | 14 +++++++++-----
 1 file changed, 9 insertions(+), 5 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModRandom.cs b/osu.Game.Rulesets.Osu/Mods/OsuModRandom.cs
index 895dc9a506..8ccfbf0da5 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModRandom.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModRandom.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.
 
+#nullable enable
+
 using System;
 using System.Collections.Generic;
+using System.Diagnostics;
 using System.Linq;
-using JetBrains.Annotations;
 using osu.Framework.Graphics.Primitives;
 using osu.Framework.Utils;
 using osu.Game.Beatmaps;
@@ -33,7 +35,7 @@ namespace osu.Game.Rulesets.Osu.Mods
         /// </summary>
         private const int preceding_hitobjects_to_shift = 10;
 
-        private Random rng;
+        private Random? rng;
 
         public void ApplyToBeatmap(IBeatmap beatmap)
         {
@@ -58,8 +60,10 @@ namespace osu.Game.Rulesets.Osu.Mods
         /// <returns>A list of <see cref="RandomObjectInfo"/>s describing how each hit object should be placed.</returns>
         private List<RandomObjectInfo> randomiseObjects(IEnumerable<OsuHitObject> hitObjects)
         {
+            Debug.Assert(rng != null, $"{nameof(ApplyToBeatmap)} was not called before randomising objects");
+
             var randomObjects = new List<RandomObjectInfo>();
-            RandomObjectInfo previous = null;
+            RandomObjectInfo? previous = null;
             float rateOfChangeMultiplier = 0;
 
             foreach (OsuHitObject hitObject in hitObjects)
@@ -102,7 +106,7 @@ namespace osu.Game.Rulesets.Osu.Mods
         /// <param name="randomObjects">A list of <see cref="RandomObjectInfo"/> describing how each hit object should be placed.</param>
         private void applyRandomisation(IReadOnlyList<OsuHitObject> hitObjects, IReadOnlyList<RandomObjectInfo> randomObjects)
         {
-            RandomObjectInfo previous = null;
+            RandomObjectInfo? previous = null;
 
             for (int i = 0; i < hitObjects.Count; i++)
             {
@@ -158,7 +162,7 @@ namespace osu.Game.Rulesets.Osu.Mods
         /// <param name="current">The <see cref="RandomObjectInfo"/> representing the hit object to have the randomised position computed for.</param>
         /// <param name="previous">The <see cref="RandomObjectInfo"/> representing the hit object immediately preceding the current one.</param>
         /// <param name="beforePrevious">The <see cref="RandomObjectInfo"/> representing the hit object immediately preceding the <paramref name="previous"/> one.</param>
-        private void computeRandomisedPosition(RandomObjectInfo current, [CanBeNull] RandomObjectInfo previous, [CanBeNull] RandomObjectInfo beforePrevious)
+        private void computeRandomisedPosition(RandomObjectInfo current, RandomObjectInfo? previous, RandomObjectInfo? beforePrevious)
         {
             float previousAbsoluteAngle = 0f;
 

From 353b251d3887e6a71dd82ada40a8205fdf6611a4 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 9 Mar 2022 17:46:41 +0900
Subject: [PATCH 3321/5547] Attempt to merge conditional expression

Hoping to fix CI error, caused by older R# version.
---
 osu.Game.Rulesets.Osu/Mods/OsuModRandom.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModRandom.cs b/osu.Game.Rulesets.Osu/Mods/OsuModRandom.cs
index 8ccfbf0da5..7479c3120a 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModRandom.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModRandom.cs
@@ -168,7 +168,7 @@ namespace osu.Game.Rulesets.Osu.Mods
 
             if (previous != null)
             {
-                Vector2 earliestPosition = beforePrevious == null ? playfield_centre : beforePrevious.HitObject.EndPosition;
+                Vector2 earliestPosition = beforePrevious?.HitObject.EndPosition ?? playfield_centre;
                 Vector2 relativePosition = previous.HitObject.Position - earliestPosition;
                 previousAbsoluteAngle = (float)Math.Atan2(relativePosition.Y, relativePosition.X);
             }

From 0267aed846cdccaf08b9b382cf7363248a44c659 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 9 Mar 2022 17:13:51 +0900
Subject: [PATCH 3322/5547] Change `ToMod` to return an `UnknownMod` rather
 than throw if a mod isn't available

As seen by this kind of crash, having the `.ToMod` method throw can be
very problematic and also hidden (as it is used inside of models in
places where exceptions are not expected to occur).

Given there are tens of usages of this method, returning a placeholder
mod seems like a better idea than outright throwing.

```
 An unhandled has occurred.
 System.InvalidOperationException:
There is no mod in the ruleset (osu) matching the acronym AS.
 at osu.Game.Online.API.APIMod.ToMod(Ruleset ruleset) in /Users/dean/Projects/osu/osu.Game/Online/API/APIMod.cs:line 54
 at osu.Game.Scoring.ScoreInfo.<get_Mods>b__117_0(APIMod m) in /Users/dean/Projects/osu/osu.Game/Scoring/ScoreInfo.cs:line 193
 at System.Linq.Enumerable.SelectArrayIterator`2.ToArray()
 at osu.Game.Scoring.ScoreInfo.get_Mods() in /Users/dean/Projects/osu/osu.Game/Scoring/ScoreInfo.cs:line 193
 at osu.Game.Screens.Select.Leaderboards.BeatmapLeaderboard.<>c.<subscribeToLocalScores>b__40_2(ScoreInfo s) in /Users/dean/Projects/osu/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs:line 199
 at System.Linq.Enumerable.WhereEnumerableIterator`1.MoveNext()
 at osu.Game.Database.RealmObjectExtensions.Detach[T](IEnumerable`1 items) in /Users/dean/Projects/osu/osu.Game/Database/RealmObjectExtensions.cs:line 180
 at osu.Game.Screens.Select.Leaderboards.BeatmapLeaderboard.<>c__DisplayClass40_0.<subscribeToLocalScores>g__localScoresChanged|1(IRealmCollection`1 sender, ChangeSet changes, Exception exception) in /Users/dean/Projects/osu/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs:line
209
 at Realms.RealmCollectionBase`1.Realms.INotifiable<Realms.NotifiableObjectHandleBase.CollectionChangeSet>.NotifyCallbacks(Nullable`1 changes, Nullable`1 exception)
 at Realms.NotifiableObjectHandleBase.NotifyObjectChanged(IntPtr managedHandle, IntPtr changes, IntPtr exception)
```
---
 .../Online/TestAPIModJsonSerialization.cs     | 14 ++++++++++
 osu.Game/Online/API/APIMod.cs                 |  7 ++++-
 osu.Game/Rulesets/Mods/UnknownMod.cs          | 27 +++++++++++++++++++
 3 files changed, 47 insertions(+), 1 deletion(-)
 create mode 100644 osu.Game/Rulesets/Mods/UnknownMod.cs

diff --git a/osu.Game.Tests/Online/TestAPIModJsonSerialization.cs b/osu.Game.Tests/Online/TestAPIModJsonSerialization.cs
index d5ea3e492c..e98ea98bb2 100644
--- a/osu.Game.Tests/Online/TestAPIModJsonSerialization.cs
+++ b/osu.Game.Tests/Online/TestAPIModJsonSerialization.cs
@@ -24,6 +24,20 @@ namespace osu.Game.Tests.Online
     [TestFixture]
     public class TestAPIModJsonSerialization
     {
+        [Test]
+        public void TestUnknownMod()
+        {
+            var apiMod = new APIMod { Acronym = "WNG" };
+
+            var deserialized = JsonConvert.DeserializeObject<APIMod>(JsonConvert.SerializeObject(apiMod));
+
+            var converted = deserialized?.ToMod(new TestRuleset());
+
+            Assert.That(converted, Is.TypeOf(typeof(UnknownMod)));
+            Assert.That(converted?.Type, Is.EqualTo(ModType.System));
+            Assert.That(converted?.Acronym, Is.EqualTo("WNG??"));
+        }
+
         [Test]
         public void TestAcronymIsPreserved()
         {
diff --git a/osu.Game/Online/API/APIMod.cs b/osu.Game/Online/API/APIMod.cs
index 67041cae07..ef8637b8ed 100644
--- a/osu.Game/Online/API/APIMod.cs
+++ b/osu.Game/Online/API/APIMod.cs
@@ -8,6 +8,7 @@ using Humanizer;
 using MessagePack;
 using Newtonsoft.Json;
 using osu.Framework.Bindables;
+using osu.Framework.Logging;
 using osu.Game.Configuration;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Mods;
@@ -51,7 +52,10 @@ namespace osu.Game.Online.API
             Mod resultMod = ruleset.CreateModFromAcronym(Acronym);
 
             if (resultMod == null)
-                throw new InvalidOperationException($"There is no mod in the ruleset ({ruleset.ShortName}) matching the acronym {Acronym}.");
+            {
+                Logger.Log($"There is no mod in the ruleset ({ruleset.ShortName}) matching the acronym {Acronym}.");
+                return new UnknownMod(Acronym);
+            }
 
             if (Settings.Count > 0)
             {
@@ -98,4 +102,5 @@ namespace osu.Game.Online.API
             public int GetHashCode(KeyValuePair<string, object> obj) => HashCode.Combine(obj.Key, ModUtils.GetSettingUnderlyingValue(obj.Value));
         }
     }
+
 }
diff --git a/osu.Game/Rulesets/Mods/UnknownMod.cs b/osu.Game/Rulesets/Mods/UnknownMod.cs
new file mode 100644
index 0000000000..013725e227
--- /dev/null
+++ b/osu.Game/Rulesets/Mods/UnknownMod.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.
+
+namespace osu.Game.Rulesets.Mods
+{
+    public class UnknownMod : Mod
+    {
+        /// <summary>
+        /// The acronym of the mod which could not be resolved.
+        /// </summary>
+        public readonly string OriginalAcronym;
+
+        public override string Name => $"Unknown mod ({OriginalAcronym})";
+        public override string Acronym => $"{OriginalAcronym}??";
+        public override string Description => "This mod could not be resolved by the game.";
+        public override double ScoreMultiplier => 0;
+
+        public override ModType Type => ModType.System;
+
+        public UnknownMod(string acronym)
+        {
+            OriginalAcronym = acronym;
+        }
+
+        public override Mod DeepClone() => new UnknownMod(OriginalAcronym);
+    }
+}

From 1ee0be5e39c613e7bff13cac6bf65dc50dcd02b7 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 9 Mar 2022 17:38:56 +0900
Subject: [PATCH 3323/5547] Ensure gameplay can't start when an `UnknownMod` is
 present

---
 .../Visual/Gameplay/UnknownModTestScene.cs    | 26 +++++++++++++++++++
 osu.Game/Screens/Play/Player.cs               |  6 +++++
 2 files changed, 32 insertions(+)
 create mode 100644 osu.Game.Tests/Visual/Gameplay/UnknownModTestScene.cs

diff --git a/osu.Game.Tests/Visual/Gameplay/UnknownModTestScene.cs b/osu.Game.Tests/Visual/Gameplay/UnknownModTestScene.cs
new file mode 100644
index 0000000000..d3e52a0ed4
--- /dev/null
+++ b/osu.Game.Tests/Visual/Gameplay/UnknownModTestScene.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 NUnit.Framework;
+using osu.Game.Rulesets;
+using osu.Game.Rulesets.Mods;
+using osu.Game.Rulesets.Osu;
+
+namespace osu.Game.Tests.Visual.Gameplay
+{
+    public class TestSceneUnknownMod : ModTestScene
+    {
+        protected override Ruleset CreatePlayerRuleset() => new OsuRuleset();
+
+        [Test]
+        public void TestUnknownModDoesntEnterGameplay()
+        {
+            CreateModTest(new ModTestData
+            {
+                Beatmap = CreateWorkingBeatmap(new OsuRuleset().RulesetInfo).Beatmap,
+                Mod = new UnknownMod("WNG"),
+                PassCondition = () => Player.IsLoaded && !Player.LoadedBeatmapSuccessfully
+            });
+        }
+    }
+}
diff --git a/osu.Game/Screens/Play/Player.cs b/osu.Game/Screens/Play/Player.cs
index b6f576ff2b..875a96c810 100644
--- a/osu.Game/Screens/Play/Player.cs
+++ b/osu.Game/Screens/Play/Player.cs
@@ -185,6 +185,12 @@ namespace osu.Game.Screens.Play
         {
             var gameplayMods = Mods.Value.Select(m => m.DeepClone()).ToArray();
 
+            if (gameplayMods.Any(m => m is UnknownMod))
+            {
+                Logger.Log("Gameplay was started with an unknown mod applied.", level: LogLevel.Important);
+                return;
+            }
+
             if (Beatmap.Value is DummyWorkingBeatmap)
                 return;
 

From 2eb3365f463618a8679a2ba4a06418bc44b1e4c8 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 9 Mar 2022 17:50:05 +0900
Subject: [PATCH 3324/5547] Fix regressing issues when attempting to exit
 `Player` after an unsuccessful beatmap load

---
 .../Visual/Gameplay/UnknownModTestScene.cs    |  3 ++
 osu.Game/Screens/Play/Player.cs               | 29 ++++++++++---------
 osu.Game/Screens/Play/SubmittingPlayer.cs     |  3 +-
 3 files changed, 21 insertions(+), 14 deletions(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/UnknownModTestScene.cs b/osu.Game.Tests/Visual/Gameplay/UnknownModTestScene.cs
index d3e52a0ed4..c0f1112905 100644
--- a/osu.Game.Tests/Visual/Gameplay/UnknownModTestScene.cs
+++ b/osu.Game.Tests/Visual/Gameplay/UnknownModTestScene.cs
@@ -12,6 +12,9 @@ namespace osu.Game.Tests.Visual.Gameplay
     {
         protected override Ruleset CreatePlayerRuleset() => new OsuRuleset();
 
+        /// <summary>
+        /// This test also covers the scenario of exiting Player after an unsuccessful beatmap load.
+        /// </summary>
         [Test]
         public void TestUnknownModDoesntEnterGameplay()
         {
diff --git a/osu.Game/Screens/Play/Player.cs b/osu.Game/Screens/Play/Player.cs
index 875a96c810..cb8f4b6020 100644
--- a/osu.Game/Screens/Play/Player.cs
+++ b/osu.Game/Screens/Play/Player.cs
@@ -994,24 +994,27 @@ namespace osu.Game.Screens.Play
 
         public override bool OnExiting(IScreen next)
         {
-            if (!GameplayState.HasPassed && !GameplayState.HasFailed)
-                GameplayState.HasQuit = true;
-
             screenSuspension?.RemoveAndDisposeImmediately();
             failAnimationLayer?.RemoveFilters();
 
-            // if arriving here and the results screen preparation task hasn't run, it's safe to say the user has not completed the beatmap.
-            if (prepareScoreForDisplayTask == null)
+            if (LoadedBeatmapSuccessfully)
             {
-                Score.ScoreInfo.Passed = false;
-                // potentially should be ScoreRank.F instead? this is the best alternative for now.
-                Score.ScoreInfo.Rank = ScoreRank.D;
-            }
+                if (!GameplayState.HasPassed && !GameplayState.HasFailed)
+                    GameplayState.HasQuit = true;
 
-            // EndPlaying() is typically called from ReplayRecorder.Dispose(). Disposal is currently asynchronous.
-            // To resolve test failures, forcefully end playing synchronously when this screen exits.
-            // Todo: Replace this with a more permanent solution once osu-framework has a synchronous cleanup method.
-            spectatorClient.EndPlaying(GameplayState);
+                // if arriving here and the results screen preparation task hasn't run, it's safe to say the user has not completed the beatmap.
+                if (prepareScoreForDisplayTask == null)
+                {
+                    Score.ScoreInfo.Passed = false;
+                    // potentially should be ScoreRank.F instead? this is the best alternative for now.
+                    Score.ScoreInfo.Rank = ScoreRank.D;
+                }
+
+                // EndPlaying() is typically called from ReplayRecorder.Dispose(). Disposal is currently asynchronous.
+                // To resolve test failures, forcefully end playing synchronously when this screen exits.
+                // Todo: Replace this with a more permanent solution once osu-framework has a synchronous cleanup method.
+                spectatorClient.EndPlaying(GameplayState);
+            }
 
             // GameplayClockContainer performs seeks / start / stop operations on the beatmap's track.
             // as we are no longer the current screen, we cannot guarantee the track is still usable.
diff --git a/osu.Game/Screens/Play/SubmittingPlayer.cs b/osu.Game/Screens/Play/SubmittingPlayer.cs
index 2cf56be659..b1f2bccddf 100644
--- a/osu.Game/Screens/Play/SubmittingPlayer.cs
+++ b/osu.Game/Screens/Play/SubmittingPlayer.cs
@@ -119,7 +119,8 @@ namespace osu.Game.Screens.Play
         {
             bool exiting = base.OnExiting(next);
 
-            submitScore(Score.DeepClone());
+            if (LoadedBeatmapSuccessfully)
+                submitScore(Score.DeepClone());
 
             return exiting;
         }

From 2e350a91ccc40487678c6b7ceff7d7c31aa93241 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 9 Mar 2022 18:07:37 +0900
Subject: [PATCH 3325/5547] Fix non-matching filename

---
 .../Gameplay/{UnknownModTestScene.cs => TestSceneUnknownMod.cs}   | 0
 1 file changed, 0 insertions(+), 0 deletions(-)
 rename osu.Game.Tests/Visual/Gameplay/{UnknownModTestScene.cs => TestSceneUnknownMod.cs} (100%)

diff --git a/osu.Game.Tests/Visual/Gameplay/UnknownModTestScene.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneUnknownMod.cs
similarity index 100%
rename from osu.Game.Tests/Visual/Gameplay/UnknownModTestScene.cs
rename to osu.Game.Tests/Visual/Gameplay/TestSceneUnknownMod.cs

From 5fb51b578f52adf7a426f5871de0c1f0a833cc3c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 9 Mar 2022 19:09:50 +0900
Subject: [PATCH 3326/5547] Update dependencies

Mainly for a `Clowd.Squirrel` bump to fix https://github.com/ppy/osu/discussions/17190.
---
 osu.Desktop/osu.Desktop.csproj                     |  2 +-
 .../osu.Game.Rulesets.Osu.Tests.csproj             |  2 +-
 osu.Game.Tests/osu.Game.Tests.csproj               |  2 +-
 osu.Game/osu.Game.csproj                           | 14 +++++++-------
 4 files changed, 10 insertions(+), 10 deletions(-)

diff --git a/osu.Desktop/osu.Desktop.csproj b/osu.Desktop/osu.Desktop.csproj
index 32ead231c7..a06484214b 100644
--- a/osu.Desktop/osu.Desktop.csproj
+++ b/osu.Desktop/osu.Desktop.csproj
@@ -24,7 +24,7 @@
     <ProjectReference Include="..\osu.Game.Rulesets.Taiko\osu.Game.Rulesets.Taiko.csproj" />
   </ItemGroup>
   <ItemGroup Label="Package References">
-    <PackageReference Include="Clowd.Squirrel" Version="2.8.15-pre" />
+    <PackageReference Include="Clowd.Squirrel" Version="2.8.28-pre" />
     <PackageReference Include="Microsoft.NETCore.Targets" Version="5.0.0" />
     <PackageReference Include="Mono.Posix.NETStandard" Version="1.0.0" />
     <PackageReference Include="System.IO.Packaging" Version="6.0.0" />
diff --git a/osu.Game.Rulesets.Osu.Tests/osu.Game.Rulesets.Osu.Tests.csproj b/osu.Game.Rulesets.Osu.Tests/osu.Game.Rulesets.Osu.Tests.csproj
index bd4c3d3345..4ce29ab5c7 100644
--- a/osu.Game.Rulesets.Osu.Tests/osu.Game.Rulesets.Osu.Tests.csproj
+++ b/osu.Game.Rulesets.Osu.Tests/osu.Game.Rulesets.Osu.Tests.csproj
@@ -3,7 +3,7 @@
   <ItemGroup Label="Package References">
     <PackageReference Include="Appveyor.TestLogger" Version="2.0.0" />
     <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.0.0" />
-    <PackageReference Include="Moq" Version="4.16.1" />
+    <PackageReference Include="Moq" Version="4.17.2" />
     <PackageReference Include="NUnit" Version="3.13.2" />
     <PackageReference Include="NUnit3TestAdapter" Version="4.1.0" />
     <PackageReference Update="Microsoft.EntityFrameworkCore.Sqlite" Version="2.1.4" />
diff --git a/osu.Game.Tests/osu.Game.Tests.csproj b/osu.Game.Tests/osu.Game.Tests.csproj
index acf1e8470b..0bcf533653 100644
--- a/osu.Game.Tests/osu.Game.Tests.csproj
+++ b/osu.Game.Tests/osu.Game.Tests.csproj
@@ -8,7 +8,7 @@
     <PackageReference Include="NUnit" Version="3.13.2" />
     <PackageReference Include="NUnit3TestAdapter" Version="4.1.0" />
     <PackageReference Update="Microsoft.EntityFrameworkCore.Sqlite" Version="2.1.4" />
-    <PackageReference Include="Moq" Version="4.16.1" />
+    <PackageReference Include="Moq" Version="4.17.2" />
   </ItemGroup>
   <PropertyGroup Label="Project">
     <OutputType>WinExe</OutputType>
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index d86fbc693e..c106c373c4 100644
--- a/osu.Game/osu.Game.csproj
+++ b/osu.Game/osu.Game.csproj
@@ -19,13 +19,13 @@
   </ItemGroup>
   <ItemGroup Label="Package References">
     <PackageReference Include="AutoMapper" Version="11.0.1" />
-    <PackageReference Include="DiffPlex" Version="1.7.0" />
+    <PackageReference Include="DiffPlex" Version="1.7.1" />
     <PackageReference Include="HtmlAgilityPack" Version="1.11.42" />
     <PackageReference Include="Humanizer" Version="2.14.1" />
     <PackageReference Include="MessagePack" Version="2.3.85" />
-    <PackageReference Include="Microsoft.AspNetCore.SignalR.Client" Version="6.0.2" />
-    <PackageReference Include="Microsoft.AspNetCore.SignalR.Protocols.MessagePack" Version="6.0.2" />
-    <PackageReference Include="Microsoft.AspNetCore.SignalR.Protocols.NewtonsoftJson" Version="6.0.2" />
+    <PackageReference Include="Microsoft.AspNetCore.SignalR.Client" Version="6.0.3" />
+    <PackageReference Include="Microsoft.AspNetCore.SignalR.Protocols.MessagePack" Version="6.0.3" />
+    <PackageReference Include="Microsoft.AspNetCore.SignalR.Protocols.NewtonsoftJson" Version="6.0.3" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="5.0.14" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.Core" Version="5.0.14" />
     <PackageReference Include="Microsoft.Extensions.Configuration.Abstractions" Version="6.0.0" />
@@ -35,10 +35,10 @@
       <PrivateAssets>all</PrivateAssets>
       <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
     </PackageReference>
-    <PackageReference Include="Realm" Version="10.9.0" />
-    <PackageReference Include="ppy.osu.Framework" Version="2022.304.0" />
+    <PackageReference Include="Realm" Version="10.10.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2022.308.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.304.0" />
-    <PackageReference Include="Sentry" Version="3.14.0" />
+    <PackageReference Include="Sentry" Version="3.14.1" />
     <PackageReference Include="SharpCompress" Version="0.30.1" />
     <PackageReference Include="NUnit" Version="3.13.2" />
     <PackageReference Include="System.ComponentModel.Annotations" Version="5.0.0" />

From 8539f619c50eb06dc320fc1902e2c3cd0afd23f8 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 9 Mar 2022 21:16:40 +0900
Subject: [PATCH 3327/5547] Update framework

---
 osu.Android.props | 2 +-
 osu.iOS.props     | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Android.props b/osu.Android.props
index 5b26b8f36e..c2788f9a48 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -52,7 +52,7 @@
   </ItemGroup>
   <ItemGroup>
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.304.0" />
-    <PackageReference Include="ppy.osu.Framework.Android" Version="2022.304.0" />
+    <PackageReference Include="ppy.osu.Framework.Android" Version="2022.308.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
     <!-- Realm needs to be directly referenced in all Xamarin projects, as it will not pull in its transitive dependencies otherwise. -->
diff --git a/osu.iOS.props b/osu.iOS.props
index c37692f0d8..e485c69096 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -61,7 +61,7 @@
     <Reference Include="System.Net.Http" />
   </ItemGroup>
   <ItemGroup Label="Package References">
-    <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.304.0" />
+    <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.308.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.304.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net6.0) -->
@@ -84,7 +84,7 @@
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="5.0.14" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.Core" Version="5.0.14" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
-    <PackageReference Include="ppy.osu.Framework" Version="2022.304.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2022.308.0" />
     <PackageReference Include="SharpCompress" Version="0.30.1" />
     <PackageReference Include="NUnit" Version="3.13.2" />
     <PackageReference Include="System.ComponentModel.Annotations" Version="5.0.0" />

From 37328f8d245fc9d50e3a14bfe57a3d9c73d0f1d1 Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Wed, 9 Mar 2022 20:36:31 +0800
Subject: [PATCH 3328/5547] Extract hit object positioning logic to a separate
 class

It is intentional to not rename the identifiers at this point to produce a cleaner diff.
---
 .../Mods/OsuHitObjectPositionModifier.cs      | 346 ++++++++++++++++++
 osu.Game.Rulesets.Osu/Mods/OsuModRandom.cs    | 325 +---------------
 2 files changed, 354 insertions(+), 317 deletions(-)
 create mode 100644 osu.Game.Rulesets.Osu/Mods/OsuHitObjectPositionModifier.cs

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuHitObjectPositionModifier.cs b/osu.Game.Rulesets.Osu/Mods/OsuHitObjectPositionModifier.cs
new file mode 100644
index 0000000000..3242b99755
--- /dev/null
+++ b/osu.Game.Rulesets.Osu/Mods/OsuHitObjectPositionModifier.cs
@@ -0,0 +1,346 @@
+// 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.Primitives;
+using osu.Game.Rulesets.Osu.Objects;
+using osu.Game.Rulesets.Osu.UI;
+using osu.Game.Rulesets.Osu.Utils;
+using osuTK;
+
+#nullable enable
+
+namespace osu.Game.Rulesets.Osu.Mods
+{
+    /// <summary>
+    /// Places hit objects according to information in <see cref="RandomObjects"/> while keeping objects inside the playfield.
+    /// </summary>
+    public class OsuHitObjectPositionModifier
+    {
+        /// <summary>
+        /// Number of previous hitobjects to be shifted together when an object is being moved.
+        /// </summary>
+        private const int preceding_hitobjects_to_shift = 10;
+
+        private static readonly Vector2 playfield_centre = OsuPlayfield.BASE_SIZE / 2;
+
+        private readonly List<OsuHitObject> hitObjects;
+
+        private readonly List<RandomObjectInfo> randomObjects = new List<RandomObjectInfo>();
+
+        /// <summary>
+        /// Contains information specifying how each hit object should be placed.
+        /// <para>The default values correspond to how objects are originally placed in the beatmap.</para>
+        /// </summary>
+        public IReadOnlyList<IRandomObjectInfo> RandomObjects => randomObjects;
+
+        public OsuHitObjectPositionModifier(List<OsuHitObject> hitObjects)
+        {
+            this.hitObjects = hitObjects;
+            populateHitObjectPositions();
+        }
+
+        private void populateHitObjectPositions()
+        {
+            Vector2 previousPosition = playfield_centre;
+            float previousAngle = 0;
+
+            foreach (OsuHitObject hitObject in hitObjects)
+            {
+                Vector2 relativePosition = hitObject.Position - previousPosition;
+                float absoluteAngle = (float)Math.Atan2(relativePosition.Y, relativePosition.X);
+                float relativeAngle = absoluteAngle - previousAngle;
+
+                randomObjects.Add(new RandomObjectInfo(hitObject)
+                {
+                    RelativeAngle = relativeAngle,
+                    DistanceFromPrevious = relativePosition.Length
+                });
+
+                previousPosition = hitObject.EndPosition;
+                previousAngle = absoluteAngle;
+            }
+        }
+
+        /// <summary>
+        /// Reposition the hit objects according to the information in <see cref="RandomObjects"/>.
+        /// </summary>
+        public void ApplyRandomisation()
+        {
+            RandomObjectInfo? previous = null;
+
+            for (int i = 0; i < hitObjects.Count; i++)
+            {
+                var hitObject = hitObjects[i];
+
+                var current = randomObjects[i];
+
+                if (hitObject is Spinner)
+                {
+                    previous = null;
+                    continue;
+                }
+
+                computeRandomisedPosition(current, previous, i > 1 ? randomObjects[i - 2] : null);
+
+                // Move hit objects back into the playfield if they are outside of it
+                Vector2 shift = Vector2.Zero;
+
+                switch (hitObject)
+                {
+                    case HitCircle circle:
+                        shift = clampHitCircleToPlayfield(circle, current);
+                        break;
+
+                    case Slider slider:
+                        shift = clampSliderToPlayfield(slider, current);
+                        break;
+                }
+
+                if (shift != Vector2.Zero)
+                {
+                    var toBeShifted = new List<OsuHitObject>();
+
+                    for (int j = i - 1; j >= i - preceding_hitobjects_to_shift && j >= 0; j--)
+                    {
+                        // only shift hit circles
+                        if (!(hitObjects[j] is HitCircle)) break;
+
+                        toBeShifted.Add(hitObjects[j]);
+                    }
+
+                    if (toBeShifted.Count > 0)
+                        applyDecreasingShift(toBeShifted, shift);
+                }
+
+                previous = current;
+            }
+        }
+
+        /// <summary>
+        /// Compute the randomised position of a hit object while attempting to keep it inside the playfield.
+        /// </summary>
+        /// <param name="current">The <see cref="RandomObjectInfo"/> representing the hit object to have the randomised position computed for.</param>
+        /// <param name="previous">The <see cref="RandomObjectInfo"/> representing the hit object immediately preceding the current one.</param>
+        /// <param name="beforePrevious">The <see cref="RandomObjectInfo"/> representing the hit object immediately preceding the <paramref name="previous"/> one.</param>
+        private void computeRandomisedPosition(RandomObjectInfo current, RandomObjectInfo? previous, RandomObjectInfo? beforePrevious)
+        {
+            float previousAbsoluteAngle = 0f;
+
+            if (previous != null)
+            {
+                Vector2 earliestPosition = beforePrevious?.HitObject.EndPosition ?? playfield_centre;
+                Vector2 relativePosition = previous.HitObject.Position - earliestPosition;
+                previousAbsoluteAngle = (float)Math.Atan2(relativePosition.Y, relativePosition.X);
+            }
+
+            float absoluteAngle = previousAbsoluteAngle + current.RelativeAngle;
+
+            var posRelativeToPrev = new Vector2(
+                current.DistanceFromPrevious * (float)Math.Cos(absoluteAngle),
+                current.DistanceFromPrevious * (float)Math.Sin(absoluteAngle)
+            );
+
+            Vector2 lastEndPosition = previous?.EndPositionRandomised ?? playfield_centre;
+
+            posRelativeToPrev = OsuHitObjectGenerationUtils.RotateAwayFromEdge(lastEndPosition, posRelativeToPrev);
+
+            current.PositionRandomised = lastEndPosition + posRelativeToPrev;
+        }
+
+        /// <summary>
+        /// Move the randomised position of a hit circle so that it fits inside the playfield.
+        /// </summary>
+        /// <returns>The deviation from the original randomised position in order to fit within the playfield.</returns>
+        private Vector2 clampHitCircleToPlayfield(HitCircle circle, RandomObjectInfo objectInfo)
+        {
+            var previousPosition = objectInfo.PositionRandomised;
+            objectInfo.EndPositionRandomised = objectInfo.PositionRandomised = clampToPlayfieldWithPadding(
+                objectInfo.PositionRandomised,
+                (float)circle.Radius
+            );
+
+            circle.Position = objectInfo.PositionRandomised;
+
+            return objectInfo.PositionRandomised - previousPosition;
+        }
+
+        /// <summary>
+        /// Moves the <see cref="Slider"/> and all necessary nested <see cref="OsuHitObject"/>s into the <see cref="OsuPlayfield"/> if they aren't already.
+        /// </summary>
+        /// <returns>The deviation from the original randomised position in order to fit within the playfield.</returns>
+        private Vector2 clampSliderToPlayfield(Slider slider, RandomObjectInfo objectInfo)
+        {
+            var possibleMovementBounds = calculatePossibleMovementBounds(slider);
+
+            var previousPosition = objectInfo.PositionRandomised;
+
+            // Clamp slider position to the placement area
+            // If the slider is larger than the playfield, force it to stay at the original position
+            float newX = possibleMovementBounds.Width < 0
+                ? objectInfo.PositionOriginal.X
+                : Math.Clamp(previousPosition.X, possibleMovementBounds.Left, possibleMovementBounds.Right);
+
+            float newY = possibleMovementBounds.Height < 0
+                ? objectInfo.PositionOriginal.Y
+                : Math.Clamp(previousPosition.Y, possibleMovementBounds.Top, possibleMovementBounds.Bottom);
+
+            slider.Position = objectInfo.PositionRandomised = new Vector2(newX, newY);
+            objectInfo.EndPositionRandomised = slider.EndPosition;
+
+            shiftNestedObjects(slider, objectInfo.PositionRandomised - objectInfo.PositionOriginal);
+
+            return objectInfo.PositionRandomised - previousPosition;
+        }
+
+        /// <summary>
+        /// Decreasingly shift a list of <see cref="OsuHitObject"/>s by a specified amount.
+        /// The first item in the list is shifted by the largest amount, while the last item is shifted by the smallest amount.
+        /// </summary>
+        /// <param name="hitObjects">The list of hit objects to be shifted.</param>
+        /// <param name="shift">The amount to be shifted.</param>
+        private void applyDecreasingShift(IList<OsuHitObject> hitObjects, Vector2 shift)
+        {
+            for (int i = 0; i < hitObjects.Count; i++)
+            {
+                var hitObject = hitObjects[i];
+                // The first object is shifted by a vector slightly smaller than shift
+                // The last object is shifted by a vector slightly larger than zero
+                Vector2 position = hitObject.Position + shift * ((hitObjects.Count - i) / (float)(hitObjects.Count + 1));
+
+                hitObject.Position = clampToPlayfieldWithPadding(position, (float)hitObject.Radius);
+            }
+        }
+
+        /// <summary>
+        /// Calculates a <see cref="RectangleF"/> which contains all of the possible movements of the slider (in relative X/Y coordinates)
+        /// such that the entire slider is inside the playfield.
+        /// </summary>
+        /// <remarks>
+        /// If the slider is larger than the playfield, the returned <see cref="RectangleF"/> may have negative width/height.
+        /// </remarks>
+        private RectangleF calculatePossibleMovementBounds(Slider slider)
+        {
+            var pathPositions = new List<Vector2>();
+            slider.Path.GetPathToProgress(pathPositions, 0, 1);
+
+            float minX = float.PositiveInfinity;
+            float maxX = float.NegativeInfinity;
+
+            float minY = float.PositiveInfinity;
+            float maxY = float.NegativeInfinity;
+
+            // Compute the bounding box of the slider.
+            foreach (var pos in pathPositions)
+            {
+                minX = MathF.Min(minX, pos.X);
+                maxX = MathF.Max(maxX, pos.X);
+
+                minY = MathF.Min(minY, pos.Y);
+                maxY = MathF.Max(maxY, pos.Y);
+            }
+
+            // Take the circle radius into account.
+            float radius = (float)slider.Radius;
+
+            minX -= radius;
+            minY -= radius;
+
+            maxX += radius;
+            maxY += radius;
+
+            // Given the bounding box of the slider (via min/max X/Y),
+            // the amount that the slider can move to the left is minX (with the sign flipped, since positive X is to the right),
+            // and the amount that it can move to the right is WIDTH - maxX.
+            // Same calculation applies for the Y axis.
+            float left = -minX;
+            float right = OsuPlayfield.BASE_SIZE.X - maxX;
+            float top = -minY;
+            float bottom = OsuPlayfield.BASE_SIZE.Y - maxY;
+
+            return new RectangleF(left, top, right - left, bottom - top);
+        }
+
+        /// <summary>
+        /// Shifts all nested <see cref="SliderTick"/>s and <see cref="SliderRepeat"/>s by the specified shift.
+        /// </summary>
+        /// <param name="slider"><see cref="Slider"/> whose nested <see cref="SliderTick"/>s and <see cref="SliderRepeat"/>s should be shifted</param>
+        /// <param name="shift">The <see cref="Vector2"/> the <see cref="Slider"/>'s nested <see cref="SliderTick"/>s and <see cref="SliderRepeat"/>s should be shifted by</param>
+        private void shiftNestedObjects(Slider slider, Vector2 shift)
+        {
+            foreach (var hitObject in slider.NestedHitObjects.Where(o => o is SliderTick || o is SliderRepeat))
+            {
+                if (!(hitObject is OsuHitObject osuHitObject))
+                    continue;
+
+                osuHitObject.Position += shift;
+            }
+        }
+
+        /// <summary>
+        /// Clamp a position to playfield, keeping a specified distance from the edges.
+        /// </summary>
+        /// <param name="position">The position to be clamped.</param>
+        /// <param name="padding">The minimum distance allowed from playfield edges.</param>
+        /// <returns>The clamped position.</returns>
+        private Vector2 clampToPlayfieldWithPadding(Vector2 position, float padding)
+        {
+            return new Vector2(
+                Math.Clamp(position.X, padding, OsuPlayfield.BASE_SIZE.X - padding),
+                Math.Clamp(position.Y, padding, OsuPlayfield.BASE_SIZE.Y - padding)
+            );
+        }
+
+        public interface IRandomObjectInfo
+        {
+            /// <summary>
+            /// The jump angle from the previous hit object to this one, relative to the previous hit object's jump angle.
+            /// </summary>
+            /// <remarks>
+            /// <see cref="RelativeAngle"/> of the first hit object in a beatmap represents the absolute angle from playfield center to the object.
+            /// </remarks>
+            /// <example>
+            /// If <see cref="RelativeAngle"/> is 0, the player's cursor doesn't need to change its direction of movement when passing
+            /// the previous object to reach this one.
+            /// </example>
+            float RelativeAngle { get; set; }
+
+            /// <summary>
+            /// The jump distance from the previous hit object to this one.
+            /// </summary>
+            /// <remarks>
+            /// <see cref="DistanceFromPrevious"/> of the first hit object in a beatmap is relative to the playfield center.
+            /// </remarks>
+            float DistanceFromPrevious { get; set; }
+
+            /// <summary>
+            /// The hit object associated with this <see cref="IRandomObjectInfo"/>.
+            /// </summary>
+            OsuHitObject HitObject { get; }
+        }
+
+        private class RandomObjectInfo : IRandomObjectInfo
+        {
+            public float RelativeAngle { get; set; }
+
+            public float DistanceFromPrevious { get; set; }
+
+            public Vector2 PositionOriginal { get; }
+            public Vector2 PositionRandomised { get; set; }
+
+            public Vector2 EndPositionOriginal { get; }
+            public Vector2 EndPositionRandomised { get; set; }
+
+            public OsuHitObject HitObject { get; }
+
+            public RandomObjectInfo(OsuHitObject hitObject)
+            {
+                PositionRandomised = PositionOriginal = hitObject.Position;
+                EndPositionRandomised = EndPositionOriginal = hitObject.EndPosition;
+                HitObject = hitObject;
+            }
+        }
+    }
+}
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModRandom.cs b/osu.Game.Rulesets.Osu/Mods/OsuModRandom.cs
index 7479c3120a..2c38be6c16 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModRandom.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModRandom.cs
@@ -4,19 +4,13 @@
 #nullable enable
 
 using System;
-using System.Collections.Generic;
-using System.Diagnostics;
 using System.Linq;
-using osu.Framework.Graphics.Primitives;
 using osu.Framework.Utils;
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Osu.Beatmaps;
-using osu.Game.Rulesets.Osu.Objects;
 using osu.Game.Rulesets.Osu.UI;
-using osu.Game.Rulesets.Osu.Utils;
-using osuTK;
 
 namespace osu.Game.Rulesets.Osu.Mods
 {
@@ -28,12 +22,6 @@ namespace osu.Game.Rulesets.Osu.Mods
         public override string Description => "It never gets boring!";
 
         private static readonly float playfield_diagonal = OsuPlayfield.BASE_SIZE.LengthFast;
-        private static readonly Vector2 playfield_centre = OsuPlayfield.BASE_SIZE / 2;
-
-        /// <summary>
-        /// Number of previous hitobjects to be shifted together when another object is being moved.
-        /// </summary>
-        private const int preceding_hitobjects_to_shift = 10;
 
         private Random? rng;
 
@@ -42,330 +30,33 @@ namespace osu.Game.Rulesets.Osu.Mods
             if (!(beatmap is OsuBeatmap osuBeatmap))
                 return;
 
-            var hitObjects = osuBeatmap.HitObjects;
-
             Seed.Value ??= RNG.Next();
 
             rng = new Random((int)Seed.Value);
 
-            var randomObjects = randomiseObjects(hitObjects);
+            var positionModifier = new OsuHitObjectPositionModifier(osuBeatmap.HitObjects);
 
-            applyRandomisation(hitObjects, randomObjects);
-        }
-
-        /// <summary>
-        /// Randomise the position of each hit object and return a list of <see cref="RandomObjectInfo"/>s describing how each hit object should be placed.
-        /// </summary>
-        /// <param name="hitObjects">A list of <see cref="OsuHitObject"/>s to have their positions randomised.</param>
-        /// <returns>A list of <see cref="RandomObjectInfo"/>s describing how each hit object should be placed.</returns>
-        private List<RandomObjectInfo> randomiseObjects(IEnumerable<OsuHitObject> hitObjects)
-        {
-            Debug.Assert(rng != null, $"{nameof(ApplyToBeatmap)} was not called before randomising objects");
-
-            var randomObjects = new List<RandomObjectInfo>();
-            RandomObjectInfo? previous = null;
             float rateOfChangeMultiplier = 0;
 
-            foreach (OsuHitObject hitObject in hitObjects)
+            foreach (var positionInfo in positionModifier.RandomObjects)
             {
-                var current = new RandomObjectInfo(hitObject);
-                randomObjects.Add(current);
-
                 // rateOfChangeMultiplier only changes every 5 iterations in a combo
                 // to prevent shaky-line-shaped streams
-                if (hitObject.IndexInCurrentCombo % 5 == 0)
+                if (positionInfo.HitObject.IndexInCurrentCombo % 5 == 0)
                     rateOfChangeMultiplier = (float)rng.NextDouble() * 2 - 1;
 
-                if (previous == null)
+                if (positionInfo == positionModifier.RandomObjects.First())
                 {
-                    current.DistanceFromPrevious = (float)(rng.NextDouble() * OsuPlayfield.BASE_SIZE.X / 2);
-                    current.RelativeAngle = (float)(rng.NextDouble() * 2 * Math.PI - Math.PI);
+                    positionInfo.DistanceFromPrevious = (float)rng.NextDouble() * OsuPlayfield.BASE_SIZE.Y / 2;
+                    positionInfo.RelativeAngle = (float)(rng.NextDouble() * 2 * Math.PI - Math.PI);
                 }
                 else
                 {
-                    current.DistanceFromPrevious = Vector2.Distance(previous.EndPositionOriginal, current.PositionOriginal);
-
-                    // The max. angle (relative to the angle of the vector pointing from the 2nd last to the last hit object)
-                    // is proportional to the distance between the last and the current hit object
-                    // to allow jumps and prevent too sharp turns during streams.
-
-                    // Allow maximum jump angle when jump distance is more than half of playfield diagonal length
-                    current.RelativeAngle = rateOfChangeMultiplier * 2 * (float)Math.PI * Math.Min(1f, current.DistanceFromPrevious / (playfield_diagonal * 0.5f));
+                    positionInfo.RelativeAngle = (float)(rateOfChangeMultiplier * 2 * Math.PI * Math.Min(1f, positionInfo.DistanceFromPrevious / (playfield_diagonal * 0.5f)));
                 }
-
-                previous = current;
             }
 
-            return randomObjects;
-        }
-
-        /// <summary>
-        /// Reposition the hit objects according to the information in <paramref name="randomObjects"/>.
-        /// </summary>
-        /// <param name="hitObjects">The hit objects to be repositioned.</param>
-        /// <param name="randomObjects">A list of <see cref="RandomObjectInfo"/> describing how each hit object should be placed.</param>
-        private void applyRandomisation(IReadOnlyList<OsuHitObject> hitObjects, IReadOnlyList<RandomObjectInfo> randomObjects)
-        {
-            RandomObjectInfo? previous = null;
-
-            for (int i = 0; i < hitObjects.Count; i++)
-            {
-                var hitObject = hitObjects[i];
-
-                var current = randomObjects[i];
-
-                if (hitObject is Spinner)
-                {
-                    previous = null;
-                    continue;
-                }
-
-                computeRandomisedPosition(current, previous, i > 1 ? randomObjects[i - 2] : null);
-
-                // Move hit objects back into the playfield if they are outside of it
-                Vector2 shift = Vector2.Zero;
-
-                switch (hitObject)
-                {
-                    case HitCircle circle:
-                        shift = clampHitCircleToPlayfield(circle, current);
-                        break;
-
-                    case Slider slider:
-                        shift = clampSliderToPlayfield(slider, current);
-                        break;
-                }
-
-                if (shift != Vector2.Zero)
-                {
-                    var toBeShifted = new List<OsuHitObject>();
-
-                    for (int j = i - 1; j >= i - preceding_hitobjects_to_shift && j >= 0; j--)
-                    {
-                        // only shift hit circles
-                        if (!(hitObjects[j] is HitCircle)) break;
-
-                        toBeShifted.Add(hitObjects[j]);
-                    }
-
-                    if (toBeShifted.Count > 0)
-                        applyDecreasingShift(toBeShifted, shift);
-                }
-
-                previous = current;
-            }
-        }
-
-        /// <summary>
-        /// Compute the randomised position of a hit object while attempting to keep it inside the playfield.
-        /// </summary>
-        /// <param name="current">The <see cref="RandomObjectInfo"/> representing the hit object to have the randomised position computed for.</param>
-        /// <param name="previous">The <see cref="RandomObjectInfo"/> representing the hit object immediately preceding the current one.</param>
-        /// <param name="beforePrevious">The <see cref="RandomObjectInfo"/> representing the hit object immediately preceding the <paramref name="previous"/> one.</param>
-        private void computeRandomisedPosition(RandomObjectInfo current, RandomObjectInfo? previous, RandomObjectInfo? beforePrevious)
-        {
-            float previousAbsoluteAngle = 0f;
-
-            if (previous != null)
-            {
-                Vector2 earliestPosition = beforePrevious?.HitObject.EndPosition ?? playfield_centre;
-                Vector2 relativePosition = previous.HitObject.Position - earliestPosition;
-                previousAbsoluteAngle = (float)Math.Atan2(relativePosition.Y, relativePosition.X);
-            }
-
-            float absoluteAngle = previousAbsoluteAngle + current.RelativeAngle;
-
-            var posRelativeToPrev = new Vector2(
-                current.DistanceFromPrevious * (float)Math.Cos(absoluteAngle),
-                current.DistanceFromPrevious * (float)Math.Sin(absoluteAngle)
-            );
-
-            Vector2 lastEndPosition = previous?.EndPositionRandomised ?? playfield_centre;
-
-            posRelativeToPrev = OsuHitObjectGenerationUtils.RotateAwayFromEdge(lastEndPosition, posRelativeToPrev);
-
-            current.PositionRandomised = lastEndPosition + posRelativeToPrev;
-        }
-
-        /// <summary>
-        /// Move the randomised position of a hit circle so that it fits inside the playfield.
-        /// </summary>
-        /// <returns>The deviation from the original randomised position in order to fit within the playfield.</returns>
-        private Vector2 clampHitCircleToPlayfield(HitCircle circle, RandomObjectInfo objectInfo)
-        {
-            var previousPosition = objectInfo.PositionRandomised;
-            objectInfo.EndPositionRandomised = objectInfo.PositionRandomised = clampToPlayfieldWithPadding(
-                objectInfo.PositionRandomised,
-                (float)circle.Radius
-            );
-
-            circle.Position = objectInfo.PositionRandomised;
-
-            return objectInfo.PositionRandomised - previousPosition;
-        }
-
-        /// <summary>
-        /// Moves the <see cref="Slider"/> and all necessary nested <see cref="OsuHitObject"/>s into the <see cref="OsuPlayfield"/> if they aren't already.
-        /// </summary>
-        /// <returns>The deviation from the original randomised position in order to fit within the playfield.</returns>
-        private Vector2 clampSliderToPlayfield(Slider slider, RandomObjectInfo objectInfo)
-        {
-            var possibleMovementBounds = calculatePossibleMovementBounds(slider);
-
-            var previousPosition = objectInfo.PositionRandomised;
-
-            // Clamp slider position to the placement area
-            // If the slider is larger than the playfield, force it to stay at the original position
-            float newX = possibleMovementBounds.Width < 0
-                ? objectInfo.PositionOriginal.X
-                : Math.Clamp(previousPosition.X, possibleMovementBounds.Left, possibleMovementBounds.Right);
-
-            float newY = possibleMovementBounds.Height < 0
-                ? objectInfo.PositionOriginal.Y
-                : Math.Clamp(previousPosition.Y, possibleMovementBounds.Top, possibleMovementBounds.Bottom);
-
-            slider.Position = objectInfo.PositionRandomised = new Vector2(newX, newY);
-            objectInfo.EndPositionRandomised = slider.EndPosition;
-
-            shiftNestedObjects(slider, objectInfo.PositionRandomised - objectInfo.PositionOriginal);
-
-            return objectInfo.PositionRandomised - previousPosition;
-        }
-
-        /// <summary>
-        /// Decreasingly shift a list of <see cref="OsuHitObject"/>s by a specified amount.
-        /// The first item in the list is shifted by the largest amount, while the last item is shifted by the smallest amount.
-        /// </summary>
-        /// <param name="hitObjects">The list of hit objects to be shifted.</param>
-        /// <param name="shift">The amount to be shifted.</param>
-        private void applyDecreasingShift(IList<OsuHitObject> hitObjects, Vector2 shift)
-        {
-            for (int i = 0; i < hitObjects.Count; i++)
-            {
-                var hitObject = hitObjects[i];
-                // The first object is shifted by a vector slightly smaller than shift
-                // The last object is shifted by a vector slightly larger than zero
-                Vector2 position = hitObject.Position + shift * ((hitObjects.Count - i) / (float)(hitObjects.Count + 1));
-
-                hitObject.Position = clampToPlayfieldWithPadding(position, (float)hitObject.Radius);
-            }
-        }
-
-        /// <summary>
-        /// Calculates a <see cref="RectangleF"/> which contains all of the possible movements of the slider (in relative X/Y coordinates)
-        /// such that the entire slider is inside the playfield.
-        /// </summary>
-        /// <remarks>
-        /// If the slider is larger than the playfield, the returned <see cref="RectangleF"/> may have negative width/height.
-        /// </remarks>
-        private RectangleF calculatePossibleMovementBounds(Slider slider)
-        {
-            var pathPositions = new List<Vector2>();
-            slider.Path.GetPathToProgress(pathPositions, 0, 1);
-
-            float minX = float.PositiveInfinity;
-            float maxX = float.NegativeInfinity;
-
-            float minY = float.PositiveInfinity;
-            float maxY = float.NegativeInfinity;
-
-            // Compute the bounding box of the slider.
-            foreach (var pos in pathPositions)
-            {
-                minX = MathF.Min(minX, pos.X);
-                maxX = MathF.Max(maxX, pos.X);
-
-                minY = MathF.Min(minY, pos.Y);
-                maxY = MathF.Max(maxY, pos.Y);
-            }
-
-            // Take the circle radius into account.
-            float radius = (float)slider.Radius;
-
-            minX -= radius;
-            minY -= radius;
-
-            maxX += radius;
-            maxY += radius;
-
-            // Given the bounding box of the slider (via min/max X/Y),
-            // the amount that the slider can move to the left is minX (with the sign flipped, since positive X is to the right),
-            // and the amount that it can move to the right is WIDTH - maxX.
-            // Same calculation applies for the Y axis.
-            float left = -minX;
-            float right = OsuPlayfield.BASE_SIZE.X - maxX;
-            float top = -minY;
-            float bottom = OsuPlayfield.BASE_SIZE.Y - maxY;
-
-            return new RectangleF(left, top, right - left, bottom - top);
-        }
-
-        /// <summary>
-        /// Shifts all nested <see cref="SliderTick"/>s and <see cref="SliderRepeat"/>s by the specified shift.
-        /// </summary>
-        /// <param name="slider"><see cref="Slider"/> whose nested <see cref="SliderTick"/>s and <see cref="SliderRepeat"/>s should be shifted</param>
-        /// <param name="shift">The <see cref="Vector2"/> the <see cref="Slider"/>'s nested <see cref="SliderTick"/>s and <see cref="SliderRepeat"/>s should be shifted by</param>
-        private void shiftNestedObjects(Slider slider, Vector2 shift)
-        {
-            foreach (var hitObject in slider.NestedHitObjects.Where(o => o is SliderTick || o is SliderRepeat))
-            {
-                if (!(hitObject is OsuHitObject osuHitObject))
-                    continue;
-
-                osuHitObject.Position += shift;
-            }
-        }
-
-        /// <summary>
-        /// Clamp a position to playfield, keeping a specified distance from the edges.
-        /// </summary>
-        /// <param name="position">The position to be clamped.</param>
-        /// <param name="padding">The minimum distance allowed from playfield edges.</param>
-        /// <returns>The clamped position.</returns>
-        private Vector2 clampToPlayfieldWithPadding(Vector2 position, float padding)
-        {
-            return new Vector2(
-                Math.Clamp(position.X, padding, OsuPlayfield.BASE_SIZE.X - padding),
-                Math.Clamp(position.Y, padding, OsuPlayfield.BASE_SIZE.Y - padding)
-            );
-        }
-
-        private class RandomObjectInfo
-        {
-            /// <summary>
-            /// The jump angle from the previous hit object to this one, relative to the previous hit object's jump angle.
-            /// </summary>
-            /// <remarks>
-            /// <see cref="RelativeAngle"/> of the first hit object in a beatmap represents the absolute angle from playfield center to the object.
-            /// </remarks>
-            /// <example>
-            /// If <see cref="RelativeAngle"/> is 0, the player's cursor doesn't need to change its direction of movement when passing
-            /// the previous object to reach this one.
-            /// </example>
-            public float RelativeAngle { get; set; }
-
-            /// <summary>
-            /// The jump distance from the previous hit object to this one.
-            /// </summary>
-            /// <remarks>
-            /// <see cref="DistanceFromPrevious"/> of the first hit object in a beatmap is relative to the playfield center.
-            /// </remarks>
-            public float DistanceFromPrevious { get; set; }
-
-            public Vector2 PositionOriginal { get; }
-            public Vector2 PositionRandomised { get; set; }
-
-            public Vector2 EndPositionOriginal { get; }
-            public Vector2 EndPositionRandomised { get; set; }
-
-            public OsuHitObject HitObject { get; }
-
-            public RandomObjectInfo(OsuHitObject hitObject)
-            {
-                PositionRandomised = PositionOriginal = hitObject.Position;
-                EndPositionRandomised = EndPositionOriginal = hitObject.EndPosition;
-                HitObject = hitObject;
-            }
+            positionModifier.ApplyRandomisation();
         }
     }
 }

From b59117caf643d04e1f35d8814811dc7c3bce2791 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 9 Mar 2022 21:42:02 +0900
Subject: [PATCH 3329/5547] Update silly iOS dependencies

---
 osu.iOS.props | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.iOS.props b/osu.iOS.props
index e485c69096..86cf1b229c 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -79,7 +79,7 @@
   </ItemGroup>
   <!-- Xamarin.iOS does not automatically handle transitive dependencies from NuGet packages. -->
   <ItemGroup Label="Transitive Dependencies">
-    <PackageReference Include="DiffPlex" Version="1.7.0" />
+    <PackageReference Include="DiffPlex" Version="1.7.1" />
     <PackageReference Include="Humanizer" Version="2.14.1" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="5.0.14" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.Core" Version="5.0.14" />
@@ -89,6 +89,6 @@
     <PackageReference Include="NUnit" Version="3.13.2" />
     <PackageReference Include="System.ComponentModel.Annotations" Version="5.0.0" />
     <PackageReference Include="ppy.osu.Framework.NativeLibs" Version="2021.1221.0" ExcludeAssets="all" />
-    <PackageReference Include="Realm" Version="10.9.0" />
+    <PackageReference Include="Realm" Version="10.10.0" />
   </ItemGroup>
 </Project>

From 6a507ca11bdf4c95cba876be61bacbc4a9e1a9d5 Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Wed, 9 Mar 2022 20:52:11 +0800
Subject: [PATCH 3330/5547] Rename identifiers to remove references to random
 mod

---
 .../Mods/OsuHitObjectPositionModifier.cs      | 86 +++++++++----------
 osu.Game.Rulesets.Osu/Mods/OsuModRandom.cs    |  6 +-
 2 files changed, 46 insertions(+), 46 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuHitObjectPositionModifier.cs b/osu.Game.Rulesets.Osu/Mods/OsuHitObjectPositionModifier.cs
index 3242b99755..84ad198951 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuHitObjectPositionModifier.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuHitObjectPositionModifier.cs
@@ -15,7 +15,7 @@ using osuTK;
 namespace osu.Game.Rulesets.Osu.Mods
 {
     /// <summary>
-    /// Places hit objects according to information in <see cref="RandomObjects"/> while keeping objects inside the playfield.
+    /// Places hit objects according to information in <see cref="ObjectPositionInfos"/> while keeping objects inside the playfield.
     /// </summary>
     public class OsuHitObjectPositionModifier
     {
@@ -28,21 +28,21 @@ namespace osu.Game.Rulesets.Osu.Mods
 
         private readonly List<OsuHitObject> hitObjects;
 
-        private readonly List<RandomObjectInfo> randomObjects = new List<RandomObjectInfo>();
+        private readonly List<ObjectPositionInfo> objectPositionInfos = new List<ObjectPositionInfo>();
 
         /// <summary>
         /// Contains information specifying how each hit object should be placed.
         /// <para>The default values correspond to how objects are originally placed in the beatmap.</para>
         /// </summary>
-        public IReadOnlyList<IRandomObjectInfo> RandomObjects => randomObjects;
+        public IReadOnlyList<IObjectPositionInfo> ObjectPositionInfos => objectPositionInfos;
 
         public OsuHitObjectPositionModifier(List<OsuHitObject> hitObjects)
         {
             this.hitObjects = hitObjects;
-            populateHitObjectPositions();
+            populateObjectPositionInfos();
         }
 
-        private void populateHitObjectPositions()
+        private void populateObjectPositionInfos()
         {
             Vector2 previousPosition = playfield_centre;
             float previousAngle = 0;
@@ -53,7 +53,7 @@ namespace osu.Game.Rulesets.Osu.Mods
                 float absoluteAngle = (float)Math.Atan2(relativePosition.Y, relativePosition.X);
                 float relativeAngle = absoluteAngle - previousAngle;
 
-                randomObjects.Add(new RandomObjectInfo(hitObject)
+                objectPositionInfos.Add(new ObjectPositionInfo(hitObject)
                 {
                     RelativeAngle = relativeAngle,
                     DistanceFromPrevious = relativePosition.Length
@@ -65,17 +65,17 @@ namespace osu.Game.Rulesets.Osu.Mods
         }
 
         /// <summary>
-        /// Reposition the hit objects according to the information in <see cref="RandomObjects"/>.
+        /// Reposition the hit objects according to the information in <see cref="ObjectPositionInfos"/>.
         /// </summary>
-        public void ApplyRandomisation()
+        public void ApplyModifications()
         {
-            RandomObjectInfo? previous = null;
+            ObjectPositionInfo? previous = null;
 
             for (int i = 0; i < hitObjects.Count; i++)
             {
                 var hitObject = hitObjects[i];
 
-                var current = randomObjects[i];
+                var current = objectPositionInfos[i];
 
                 if (hitObject is Spinner)
                 {
@@ -83,7 +83,7 @@ namespace osu.Game.Rulesets.Osu.Mods
                     continue;
                 }
 
-                computeRandomisedPosition(current, previous, i > 1 ? randomObjects[i - 2] : null);
+                computeModifiedPosition(current, previous, i > 1 ? objectPositionInfos[i - 2] : null);
 
                 // Move hit objects back into the playfield if they are outside of it
                 Vector2 shift = Vector2.Zero;
@@ -120,12 +120,12 @@ namespace osu.Game.Rulesets.Osu.Mods
         }
 
         /// <summary>
-        /// Compute the randomised position of a hit object while attempting to keep it inside the playfield.
+        /// Compute the modified position of a hit object while attempting to keep it inside the playfield.
         /// </summary>
-        /// <param name="current">The <see cref="RandomObjectInfo"/> representing the hit object to have the randomised position computed for.</param>
-        /// <param name="previous">The <see cref="RandomObjectInfo"/> representing the hit object immediately preceding the current one.</param>
-        /// <param name="beforePrevious">The <see cref="RandomObjectInfo"/> representing the hit object immediately preceding the <paramref name="previous"/> one.</param>
-        private void computeRandomisedPosition(RandomObjectInfo current, RandomObjectInfo? previous, RandomObjectInfo? beforePrevious)
+        /// <param name="current">The <see cref="ObjectPositionInfo"/> representing the hit object to have the modified position computed for.</param>
+        /// <param name="previous">The <see cref="ObjectPositionInfo"/> representing the hit object immediately preceding the current one.</param>
+        /// <param name="beforePrevious">The <see cref="ObjectPositionInfo"/> representing the hit object immediately preceding the <paramref name="previous"/> one.</param>
+        private void computeModifiedPosition(ObjectPositionInfo current, ObjectPositionInfo? previous, ObjectPositionInfo? beforePrevious)
         {
             float previousAbsoluteAngle = 0f;
 
@@ -143,56 +143,56 @@ namespace osu.Game.Rulesets.Osu.Mods
                 current.DistanceFromPrevious * (float)Math.Sin(absoluteAngle)
             );
 
-            Vector2 lastEndPosition = previous?.EndPositionRandomised ?? playfield_centre;
+            Vector2 lastEndPosition = previous?.EndPositionModified ?? playfield_centre;
 
             posRelativeToPrev = OsuHitObjectGenerationUtils.RotateAwayFromEdge(lastEndPosition, posRelativeToPrev);
 
-            current.PositionRandomised = lastEndPosition + posRelativeToPrev;
+            current.PositionModified = lastEndPosition + posRelativeToPrev;
         }
 
         /// <summary>
-        /// Move the randomised position of a hit circle so that it fits inside the playfield.
+        /// Move the modified position of a hit circle so that it fits inside the playfield.
         /// </summary>
-        /// <returns>The deviation from the original randomised position in order to fit within the playfield.</returns>
-        private Vector2 clampHitCircleToPlayfield(HitCircle circle, RandomObjectInfo objectInfo)
+        /// <returns>The deviation from the original modified position in order to fit within the playfield.</returns>
+        private Vector2 clampHitCircleToPlayfield(HitCircle circle, ObjectPositionInfo objectPositionInfo)
         {
-            var previousPosition = objectInfo.PositionRandomised;
-            objectInfo.EndPositionRandomised = objectInfo.PositionRandomised = clampToPlayfieldWithPadding(
-                objectInfo.PositionRandomised,
+            var previousPosition = objectPositionInfo.PositionModified;
+            objectPositionInfo.EndPositionModified = objectPositionInfo.PositionModified = clampToPlayfieldWithPadding(
+                objectPositionInfo.PositionModified,
                 (float)circle.Radius
             );
 
-            circle.Position = objectInfo.PositionRandomised;
+            circle.Position = objectPositionInfo.PositionModified;
 
-            return objectInfo.PositionRandomised - previousPosition;
+            return objectPositionInfo.PositionModified - previousPosition;
         }
 
         /// <summary>
         /// Moves the <see cref="Slider"/> and all necessary nested <see cref="OsuHitObject"/>s into the <see cref="OsuPlayfield"/> if they aren't already.
         /// </summary>
-        /// <returns>The deviation from the original randomised position in order to fit within the playfield.</returns>
-        private Vector2 clampSliderToPlayfield(Slider slider, RandomObjectInfo objectInfo)
+        /// <returns>The deviation from the original modified position in order to fit within the playfield.</returns>
+        private Vector2 clampSliderToPlayfield(Slider slider, ObjectPositionInfo objectPositionInfo)
         {
             var possibleMovementBounds = calculatePossibleMovementBounds(slider);
 
-            var previousPosition = objectInfo.PositionRandomised;
+            var previousPosition = objectPositionInfo.PositionModified;
 
             // Clamp slider position to the placement area
             // If the slider is larger than the playfield, force it to stay at the original position
             float newX = possibleMovementBounds.Width < 0
-                ? objectInfo.PositionOriginal.X
+                ? objectPositionInfo.PositionOriginal.X
                 : Math.Clamp(previousPosition.X, possibleMovementBounds.Left, possibleMovementBounds.Right);
 
             float newY = possibleMovementBounds.Height < 0
-                ? objectInfo.PositionOriginal.Y
+                ? objectPositionInfo.PositionOriginal.Y
                 : Math.Clamp(previousPosition.Y, possibleMovementBounds.Top, possibleMovementBounds.Bottom);
 
-            slider.Position = objectInfo.PositionRandomised = new Vector2(newX, newY);
-            objectInfo.EndPositionRandomised = slider.EndPosition;
+            slider.Position = objectPositionInfo.PositionModified = new Vector2(newX, newY);
+            objectPositionInfo.EndPositionModified = slider.EndPosition;
 
-            shiftNestedObjects(slider, objectInfo.PositionRandomised - objectInfo.PositionOriginal);
+            shiftNestedObjects(slider, objectPositionInfo.PositionModified - objectPositionInfo.PositionOriginal);
 
-            return objectInfo.PositionRandomised - previousPosition;
+            return objectPositionInfo.PositionModified - previousPosition;
         }
 
         /// <summary>
@@ -293,7 +293,7 @@ namespace osu.Game.Rulesets.Osu.Mods
             );
         }
 
-        public interface IRandomObjectInfo
+        public interface IObjectPositionInfo
         {
             /// <summary>
             /// The jump angle from the previous hit object to this one, relative to the previous hit object's jump angle.
@@ -316,29 +316,29 @@ namespace osu.Game.Rulesets.Osu.Mods
             float DistanceFromPrevious { get; set; }
 
             /// <summary>
-            /// The hit object associated with this <see cref="IRandomObjectInfo"/>.
+            /// The hit object associated with this <see cref="IObjectPositionInfo"/>.
             /// </summary>
             OsuHitObject HitObject { get; }
         }
 
-        private class RandomObjectInfo : IRandomObjectInfo
+        private class ObjectPositionInfo : IObjectPositionInfo
         {
             public float RelativeAngle { get; set; }
 
             public float DistanceFromPrevious { get; set; }
 
             public Vector2 PositionOriginal { get; }
-            public Vector2 PositionRandomised { get; set; }
+            public Vector2 PositionModified { get; set; }
 
             public Vector2 EndPositionOriginal { get; }
-            public Vector2 EndPositionRandomised { get; set; }
+            public Vector2 EndPositionModified { get; set; }
 
             public OsuHitObject HitObject { get; }
 
-            public RandomObjectInfo(OsuHitObject hitObject)
+            public ObjectPositionInfo(OsuHitObject hitObject)
             {
-                PositionRandomised = PositionOriginal = hitObject.Position;
-                EndPositionRandomised = EndPositionOriginal = hitObject.EndPosition;
+                PositionModified = PositionOriginal = hitObject.Position;
+                EndPositionModified = EndPositionOriginal = hitObject.EndPosition;
                 HitObject = hitObject;
             }
         }
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModRandom.cs b/osu.Game.Rulesets.Osu/Mods/OsuModRandom.cs
index 2c38be6c16..59abc73ed9 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModRandom.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModRandom.cs
@@ -38,14 +38,14 @@ namespace osu.Game.Rulesets.Osu.Mods
 
             float rateOfChangeMultiplier = 0;
 
-            foreach (var positionInfo in positionModifier.RandomObjects)
+            foreach (var positionInfo in positionModifier.ObjectPositionInfos)
             {
                 // rateOfChangeMultiplier only changes every 5 iterations in a combo
                 // to prevent shaky-line-shaped streams
                 if (positionInfo.HitObject.IndexInCurrentCombo % 5 == 0)
                     rateOfChangeMultiplier = (float)rng.NextDouble() * 2 - 1;
 
-                if (positionInfo == positionModifier.RandomObjects.First())
+                if (positionInfo == positionModifier.ObjectPositionInfos.First())
                 {
                     positionInfo.DistanceFromPrevious = (float)rng.NextDouble() * OsuPlayfield.BASE_SIZE.Y / 2;
                     positionInfo.RelativeAngle = (float)(rng.NextDouble() * 2 * Math.PI - Math.PI);
@@ -56,7 +56,7 @@ namespace osu.Game.Rulesets.Osu.Mods
                 }
             }
 
-            positionModifier.ApplyRandomisation();
+            positionModifier.ApplyModifications();
         }
     }
 }

From 8e12a067dfb1695c984d1d4705aff15c5af18b8b Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Wed, 9 Mar 2022 21:04:35 +0800
Subject: [PATCH 3331/5547] Remove an unused property

---
 osu.Game.Rulesets.Osu/Mods/OsuHitObjectPositionModifier.cs | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuHitObjectPositionModifier.cs b/osu.Game.Rulesets.Osu/Mods/OsuHitObjectPositionModifier.cs
index 84ad198951..16ec25f389 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuHitObjectPositionModifier.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuHitObjectPositionModifier.cs
@@ -329,8 +329,6 @@ namespace osu.Game.Rulesets.Osu.Mods
 
             public Vector2 PositionOriginal { get; }
             public Vector2 PositionModified { get; set; }
-
-            public Vector2 EndPositionOriginal { get; }
             public Vector2 EndPositionModified { get; set; }
 
             public OsuHitObject HitObject { get; }
@@ -338,7 +336,7 @@ namespace osu.Game.Rulesets.Osu.Mods
             public ObjectPositionInfo(OsuHitObject hitObject)
             {
                 PositionModified = PositionOriginal = hitObject.Position;
-                EndPositionModified = EndPositionOriginal = hitObject.EndPosition;
+                EndPositionModified = hitObject.EndPosition;
                 HitObject = hitObject;
             }
         }

From e8dbed738e4b819f5a68bf9b1df6a2d1b2a824a7 Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Wed, 9 Mar 2022 21:52:15 +0800
Subject: [PATCH 3332/5547] Move `OsuHitObjectPositionModifier` to `Utils/`

---
 osu.Game.Rulesets.Osu/Mods/OsuModRandom.cs                     | 1 +
 .../{Mods => Utils}/OsuHitObjectPositionModifier.cs            | 3 +--
 2 files changed, 2 insertions(+), 2 deletions(-)
 rename osu.Game.Rulesets.Osu/{Mods => Utils}/OsuHitObjectPositionModifier.cs (99%)

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModRandom.cs b/osu.Game.Rulesets.Osu/Mods/OsuModRandom.cs
index 59abc73ed9..cdaa8fa3d5 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModRandom.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModRandom.cs
@@ -11,6 +11,7 @@ using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Osu.Beatmaps;
 using osu.Game.Rulesets.Osu.UI;
+using osu.Game.Rulesets.Osu.Utils;
 
 namespace osu.Game.Rulesets.Osu.Mods
 {
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuHitObjectPositionModifier.cs b/osu.Game.Rulesets.Osu/Utils/OsuHitObjectPositionModifier.cs
similarity index 99%
rename from osu.Game.Rulesets.Osu/Mods/OsuHitObjectPositionModifier.cs
rename to osu.Game.Rulesets.Osu/Utils/OsuHitObjectPositionModifier.cs
index 16ec25f389..428866623f 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuHitObjectPositionModifier.cs
+++ b/osu.Game.Rulesets.Osu/Utils/OsuHitObjectPositionModifier.cs
@@ -7,12 +7,11 @@ using System.Linq;
 using osu.Framework.Graphics.Primitives;
 using osu.Game.Rulesets.Osu.Objects;
 using osu.Game.Rulesets.Osu.UI;
-using osu.Game.Rulesets.Osu.Utils;
 using osuTK;
 
 #nullable enable
 
-namespace osu.Game.Rulesets.Osu.Mods
+namespace osu.Game.Rulesets.Osu.Utils
 {
     /// <summary>
     /// Places hit objects according to information in <see cref="ObjectPositionInfos"/> while keeping objects inside the playfield.

From b67f9269f919d47647be5a72d71f1667500194bb Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Wed, 9 Mar 2022 18:13:56 +0000
Subject: [PATCH 3333/5547] Remove `NewChat` namespace

---
 .../Visual/Online/{NewChat => }/TestSceneChannelListing.cs    | 4 ++--
 osu.Game/Overlays/{NewChat => Chat/Listing}/ChannelListing.cs | 2 +-
 .../Overlays/{NewChat => Chat/Listing}/ChannelListingItem.cs  | 2 +-
 3 files changed, 4 insertions(+), 4 deletions(-)
 rename osu.Game.Tests/Visual/Online/{NewChat => }/TestSceneChannelListing.cs (97%)
 rename osu.Game/Overlays/{NewChat => Chat/Listing}/ChannelListing.cs (98%)
 rename osu.Game/Overlays/{NewChat => Chat/Listing}/ChannelListingItem.cs (99%)

diff --git a/osu.Game.Tests/Visual/Online/NewChat/TestSceneChannelListing.cs b/osu.Game.Tests/Visual/Online/TestSceneChannelListing.cs
similarity index 97%
rename from osu.Game.Tests/Visual/Online/NewChat/TestSceneChannelListing.cs
rename to osu.Game.Tests/Visual/Online/TestSceneChannelListing.cs
index 8f955c0520..e521db1c9d 100644
--- a/osu.Game.Tests/Visual/Online/NewChat/TestSceneChannelListing.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneChannelListing.cs
@@ -11,10 +11,10 @@ using osu.Framework.Utils;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Online.Chat;
 using osu.Game.Overlays;
-using osu.Game.Overlays.NewChat;
+using osu.Game.Overlays.Chat.Listing;
 using osuTK;
 
-namespace osu.Game.Tests.Visual.Online.NewChat
+namespace osu.Game.Tests.Visual.Online
 {
     [TestFixture]
     public class TestSceneChannelListing : OsuTestScene
diff --git a/osu.Game/Overlays/NewChat/ChannelListing.cs b/osu.Game/Overlays/Chat/Listing/ChannelListing.cs
similarity index 98%
rename from osu.Game/Overlays/NewChat/ChannelListing.cs
rename to osu.Game/Overlays/Chat/Listing/ChannelListing.cs
index 3de6364303..9b8b45c85f 100644
--- a/osu.Game/Overlays/NewChat/ChannelListing.cs
+++ b/osu.Game/Overlays/Chat/Listing/ChannelListing.cs
@@ -14,7 +14,7 @@ using osu.Game.Graphics.Containers;
 using osu.Game.Online.Chat;
 using osuTK;
 
-namespace osu.Game.Overlays.NewChat
+namespace osu.Game.Overlays.Chat.Listing
 {
     public class ChannelListing : VisibilityContainer
     {
diff --git a/osu.Game/Overlays/NewChat/ChannelListingItem.cs b/osu.Game/Overlays/Chat/Listing/ChannelListingItem.cs
similarity index 99%
rename from osu.Game/Overlays/NewChat/ChannelListingItem.cs
rename to osu.Game/Overlays/Chat/Listing/ChannelListingItem.cs
index 77d5599c9b..9586730c6b 100644
--- a/osu.Game/Overlays/NewChat/ChannelListingItem.cs
+++ b/osu.Game/Overlays/Chat/Listing/ChannelListingItem.cs
@@ -18,7 +18,7 @@ using osu.Game.Graphics.Sprites;
 using osu.Game.Online.Chat;
 using osuTK;
 
-namespace osu.Game.Overlays.NewChat
+namespace osu.Game.Overlays.Chat.Listing
 {
     public class ChannelListingItem : OsuClickableContainer, IFilterable
     {

From d2983b74d53714176600b02387a8f2370b2d264f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 9 Mar 2022 20:15:34 +0100
Subject: [PATCH 3334/5547] Bump Moq in mobile test projects for parity

---
 osu.Game.Tests.Android/osu.Game.Tests.Android.csproj | 2 +-
 osu.Game.Tests.iOS/osu.Game.Tests.iOS.csproj         | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests.Android/osu.Game.Tests.Android.csproj b/osu.Game.Tests.Android/osu.Game.Tests.Android.csproj
index b45a3249ff..afafec6b1f 100644
--- a/osu.Game.Tests.Android/osu.Game.Tests.Android.csproj
+++ b/osu.Game.Tests.Android/osu.Game.Tests.Android.csproj
@@ -79,7 +79,7 @@
   </ItemGroup>
   <ItemGroup Label="Package References">
     <PackageReference Include="DeepEqual" Version="2.0.0" />
-    <PackageReference Include="Moq" Version="4.16.1" />
+    <PackageReference Include="Moq" Version="4.17.2" />
     <PackageReference Include="System.Formats.Asn1">
       <Version>5.0.0</Version>
     </PackageReference>
diff --git a/osu.Game.Tests.iOS/osu.Game.Tests.iOS.csproj b/osu.Game.Tests.iOS/osu.Game.Tests.iOS.csproj
index 97df9b2cd5..05b3cad6da 100644
--- a/osu.Game.Tests.iOS/osu.Game.Tests.iOS.csproj
+++ b/osu.Game.Tests.iOS/osu.Game.Tests.iOS.csproj
@@ -48,7 +48,7 @@
   </ItemGroup>
   <ItemGroup Label="Package References">
     <PackageReference Include="DeepEqual" Version="2.0.0" />
-    <PackageReference Include="Moq" Version="4.16.1" />
+    <PackageReference Include="Moq" Version="4.17.2" />
   </ItemGroup>
   <Import Project="$(MSBuildExtensionsPath)\Xamarin\iOS\Xamarin.iOS.CSharp.targets" />
 </Project>

From 5cb058a17d636ef70e2ea833a9401fd6dd41d332 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 9 Mar 2022 20:17:46 +0100
Subject: [PATCH 3335/5547] Bump Realm in Android test project for parity

---
 osu.Android.props | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Android.props b/osu.Android.props
index c2788f9a48..839f7882bf 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -56,6 +56,6 @@
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
     <!-- Realm needs to be directly referenced in all Xamarin projects, as it will not pull in its transitive dependencies otherwise. -->
-    <PackageReference Include="Realm" Version="10.9.0" />
+    <PackageReference Include="Realm" Version="10.10.0" />
   </ItemGroup>
 </Project>

From 2d8983383a02a830b4e1d84af34c795d077eb562 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Tue, 8 Mar 2022 04:43:40 +0300
Subject: [PATCH 3336/5547] Revert `newMessagesArrived` changes and always
 schedule highlight

In the case a message arrives and the chat overlay is hidden, clicking
on the mention notification will not work as the `HighlightedMessage`
bindable callback will execute before the scheduled `newMessagesArrived`
logic (which was hanging since the message arrived until the chat
overlay became open because of the notification).

Simplify things by always scheduling the `HighlightedMessage` bindable
callback.
---
 osu.Game/Overlays/Chat/DrawableChannel.cs | 82 ++++++++++++-----------
 1 file changed, 42 insertions(+), 40 deletions(-)

diff --git a/osu.Game/Overlays/Chat/DrawableChannel.cs b/osu.Game/Overlays/Chat/DrawableChannel.cs
index a73e61c52b..0cc3260e60 100644
--- a/osu.Game/Overlays/Chat/DrawableChannel.cs
+++ b/osu.Game/Overlays/Chat/DrawableChannel.cs
@@ -74,33 +74,37 @@ namespace osu.Game.Overlays.Chat
                     }
                 },
             };
+
+            newMessagesArrived(Channel.Messages);
+
+            Channel.NewMessagesArrived += newMessagesArrived;
+            Channel.MessageRemoved += messageRemoved;
+            Channel.PendingMessageResolved += pendingMessageResolved;
         }
 
         protected override void LoadComplete()
         {
             base.LoadComplete();
 
-            addChatLines(Channel.Messages);
-
-            Channel.NewMessagesArrived += newMessagesArrived;
-            Channel.MessageRemoved += messageRemoved;
-            Channel.PendingMessageResolved += pendingMessageResolved;
-
             highlightedMessage = Channel.HighlightedMessage.GetBoundCopy();
             highlightedMessage.BindValueChanged(m =>
             {
                 if (m.NewValue == null)
                     return;
 
-                var chatLine = chatLines.SingleOrDefault(c => c.Message.Equals(m.NewValue));
-
-                if (chatLine != null)
+                // schedule highlight to ensure it performs after any pending "newMessagesArrived" calls.
+                Schedule(() =>
                 {
-                    scroll.ScrollIntoView(chatLine);
-                    chatLine.ScheduleHighlight();
-                }
+                    var chatLine = chatLines.SingleOrDefault(c => c.Message.Equals(m.NewValue));
 
-                highlightedMessage.Value = null;
+                    if (chatLine != null)
+                    {
+                        scroll.ScrollIntoView(chatLine);
+                        chatLine.ScheduleHighlight();
+                    }
+
+                    highlightedMessage.Value = null;
+                });
             }, true);
         }
 
@@ -121,39 +125,18 @@ namespace osu.Game.Overlays.Chat
             Colour = colours.ChatBlue.Lighten(0.7f),
         };
 
-        private void newMessagesArrived(IEnumerable<Message> newMessages) => Schedule(addChatLines, newMessages);
-
-        private void pendingMessageResolved(Message existing, Message updated) => Schedule(() =>
+        private void newMessagesArrived(IEnumerable<Message> newMessages) => Schedule(() =>
         {
-            var found = chatLines.LastOrDefault(c => c.Message == existing);
-
-            if (found != null)
-            {
-                Trace.Assert(updated.Id.HasValue, "An updated message was returned with no ID.");
-
-                ChatLineFlow.Remove(found);
-                found.Message = updated;
-                ChatLineFlow.Add(found);
-            }
-        });
-
-        private void messageRemoved(Message removed) => Schedule(() =>
-        {
-            chatLines.FirstOrDefault(c => c.Message == removed)?.FadeColour(Color4.Red, 400).FadeOut(600).Expire();
-        });
-
-        private void addChatLines(IEnumerable<Message> messages)
-        {
-            if (messages.Min(m => m.Id) < chatLines.Max(c => c.Message.Id))
+            if (newMessages.Min(m => m.Id) < chatLines.Max(c => c.Message.Id))
             {
                 // there is a case (on initial population) that we may receive past messages and need to reorder.
                 // easiest way is to just combine messages and recreate drawables (less worrying about day separators etc.)
-                messages = messages.Concat(chatLines.Select(c => c.Message)).OrderBy(m => m.Id).ToList();
+                newMessages = newMessages.Concat(chatLines.Select(c => c.Message)).OrderBy(m => m.Id).ToList();
                 ChatLineFlow.Clear();
             }
 
             // Add up to last Channel.MAX_HISTORY messages
-            var displayMessages = messages.Skip(Math.Max(0, messages.Count() - Channel.MAX_HISTORY));
+            var displayMessages = newMessages.Skip(Math.Max(0, newMessages.Count() - Channel.MAX_HISTORY));
 
             Message lastMessage = chatLines.LastOrDefault()?.Message;
 
@@ -192,9 +175,28 @@ namespace osu.Game.Overlays.Chat
 
             // due to the scroll adjusts from old messages removal above, a scroll-to-end must be enforced,
             // to avoid making the container think the user has scrolled back up and unwantedly disable auto-scrolling.
-            if (messages.Any(m => m is LocalMessage))
+            if (newMessages.Any(m => m is LocalMessage))
                 scroll.ScrollToEnd();
-        }
+        });
+
+        private void pendingMessageResolved(Message existing, Message updated) => Schedule(() =>
+        {
+            var found = chatLines.LastOrDefault(c => c.Message == existing);
+
+            if (found != null)
+            {
+                Trace.Assert(updated.Id.HasValue, "An updated message was returned with no ID.");
+
+                ChatLineFlow.Remove(found);
+                found.Message = updated;
+                ChatLineFlow.Add(found);
+            }
+        });
+
+        private void messageRemoved(Message removed) => Schedule(() =>
+        {
+            chatLines.FirstOrDefault(c => c.Message == removed)?.FadeColour(Color4.Red, 400).FadeOut(600).Expire();
+        });
 
         private IEnumerable<ChatLine> chatLines => ChatLineFlow.Children.OfType<ChatLine>();
 

From 93cf93943f5ff339443e7cffba97c09f51113ec9 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 10 Mar 2022 02:48:33 +0300
Subject: [PATCH 3337/5547] Schedule chat line highlight after children to
 handle non-loaded lines

---
 osu.Game/Overlays/Chat/DrawableChannel.cs | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/Chat/DrawableChannel.cs b/osu.Game/Overlays/Chat/DrawableChannel.cs
index 0cc3260e60..d5df6102f2 100644
--- a/osu.Game/Overlays/Chat/DrawableChannel.cs
+++ b/osu.Game/Overlays/Chat/DrawableChannel.cs
@@ -93,7 +93,8 @@ namespace osu.Game.Overlays.Chat
                     return;
 
                 // schedule highlight to ensure it performs after any pending "newMessagesArrived" calls.
-                Schedule(() =>
+                // also schedule after children to ensure the scroll flow is updated with any new chat lines.
+                ScheduleAfterChildren(() =>
                 {
                     var chatLine = chatLines.SingleOrDefault(c => c.Message.Equals(m.NewValue));
 

From 80c0df6af578962b91757d36e8a9de53664acfc3 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 10 Mar 2022 02:49:23 +0300
Subject: [PATCH 3338/5547] Scroll chat line to channel center

We may eventually want that encapsulated within `ScrollIntoView`, as it
would also come in handy for `GameplayLeaderboard`.
---
 .../Online/TestSceneStandAloneChatDisplay.cs    | 17 ++++++++++-------
 .../Overlays/Chat/ChannelScrollContainer.cs     |  6 ++++++
 osu.Game/Overlays/Chat/DrawableChannel.cs       |  3 ++-
 3 files changed, 18 insertions(+), 8 deletions(-)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneStandAloneChatDisplay.cs b/osu.Game.Tests/Visual/Online/TestSceneStandAloneChatDisplay.cs
index c9837be934..17c818963e 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneStandAloneChatDisplay.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneStandAloneChatDisplay.cs
@@ -152,7 +152,7 @@ namespace osu.Game.Tests.Visual.Online
             AddStep("highlight first message", () =>
             {
                 highlighted = testChannel.Messages[0];
-                chatDisplay.DrawableChannel.Channel.HighlightedMessage.Value = highlighted;
+                testChannel.HighlightedMessage.Value = highlighted;
             });
 
             AddUntilStep("chat scrolled to first message", () =>
@@ -167,7 +167,7 @@ namespace osu.Game.Tests.Visual.Online
             AddStep("highlight last message", () =>
             {
                 highlighted = testChannel.Messages[^1];
-                chatDisplay.DrawableChannel.Channel.HighlightedMessage.Value = highlighted;
+                testChannel.HighlightedMessage.Value = highlighted;
             });
 
             AddUntilStep("chat scrolled to last message", () =>
@@ -182,19 +182,22 @@ namespace osu.Game.Tests.Visual.Online
             AddRepeatStep("highlight other random messages", () =>
             {
                 highlighted = testChannel.Messages[RNG.Next(0, testChannel.Messages.Count - 1)];
-                chatDisplay.DrawableChannel.Channel.HighlightedMessage.Value = highlighted;
+                testChannel.HighlightedMessage.Value = highlighted;
             }, 10);
         }
 
         [Test]
         public void TestMessageHighlightingOnFilledChat()
         {
+            int index = 0;
+
             fillChat();
 
-            AddRepeatStep("highlight random messages", () =>
-            {
-                chatDisplay.DrawableChannel.Channel.HighlightedMessage.Value = testChannel.Messages[RNG.Next(0, testChannel.Messages.Count - 1)];
-            }, 10);
+            AddStep("highlight first message", () => testChannel.HighlightedMessage.Value = testChannel.Messages[index = 0]);
+            AddStep("highlight next message", () => testChannel.HighlightedMessage.Value = testChannel.Messages[index = Math.Min(index + 1, testChannel.Messages.Count - 1)]);
+            AddStep("highlight last message", () => testChannel.HighlightedMessage.Value = testChannel.Messages[index = testChannel.Messages.Count - 1]);
+            AddStep("highlight previous message", () => testChannel.HighlightedMessage.Value = testChannel.Messages[index = Math.Max(index - 1, 0)]);
+            AddRepeatStep("highlight random messages", () => testChannel.HighlightedMessage.Value = testChannel.Messages[index = RNG.Next(0, testChannel.Messages.Count - 1)], 10);
         }
 
         /// <summary>
diff --git a/osu.Game/Overlays/Chat/ChannelScrollContainer.cs b/osu.Game/Overlays/Chat/ChannelScrollContainer.cs
index 58b2b9a075..139c091f03 100644
--- a/osu.Game/Overlays/Chat/ChannelScrollContainer.cs
+++ b/osu.Game/Overlays/Chat/ChannelScrollContainer.cs
@@ -47,6 +47,12 @@ namespace osu.Game.Overlays.Chat
             updateTrackState();
         }
 
+        public new void ScrollTo(float value, bool animated = true, double? distanceDecay = null)
+        {
+            base.ScrollTo(value, animated, distanceDecay);
+            updateTrackState();
+        }
+
         public new void ScrollIntoView(Drawable d, bool animated = true)
         {
             base.ScrollIntoView(d, animated);
diff --git a/osu.Game/Overlays/Chat/DrawableChannel.cs b/osu.Game/Overlays/Chat/DrawableChannel.cs
index d5df6102f2..433fb2ced7 100644
--- a/osu.Game/Overlays/Chat/DrawableChannel.cs
+++ b/osu.Game/Overlays/Chat/DrawableChannel.cs
@@ -100,7 +100,8 @@ namespace osu.Game.Overlays.Chat
 
                     if (chatLine != null)
                     {
-                        scroll.ScrollIntoView(chatLine);
+                        float center = scroll.GetChildPosInContent(chatLine, chatLine.DrawSize / 2) - scroll.DisplayableContent / 2;
+                        scroll.ScrollTo(Math.Clamp(center, 0, scroll.ScrollableExtent));
                         chatLine.ScheduleHighlight();
                     }
 

From cf9671cafbe9f85dd8612a5a545360b534906fa8 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 10 Mar 2022 02:50:07 +0300
Subject: [PATCH 3339/5547] Increase highlight delay to 1500ms

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

diff --git a/osu.Game/Overlays/Chat/ChatLine.cs b/osu.Game/Overlays/Chat/ChatLine.cs
index 97fda80492..9ae80a4e2b 100644
--- a/osu.Game/Overlays/Chat/ChatLine.cs
+++ b/osu.Game/Overlays/Chat/ChatLine.cs
@@ -220,7 +220,7 @@ namespace osu.Game.Overlays.Chat
         /// <remarks>
         /// Scheduling is required to ensure the animation doesn't play until the chat line is in view and not scrolled away.
         /// </remarks>
-        public void ScheduleHighlight() => Schedule(() => lineHighlightBackground.FadeTo(0.5f).FadeOut(1000, Easing.InQuint));
+        public void ScheduleHighlight() => Schedule(() => lineHighlightBackground.FadeTo(0.5f).FadeOut(1500, Easing.InQuint));
 
         private void updateMessageContent()
         {

From d4de435eb2f228696d29147d351764114c1745ed Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 10 Mar 2022 02:50:27 +0300
Subject: [PATCH 3340/5547] Add test case for highlighting while chat overlay
 is hidden

---
 .../Visual/Online/TestSceneChatOverlay.cs     | 32 +++++++++++++++++++
 1 file changed, 32 insertions(+)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneChatOverlay.cs b/osu.Game.Tests/Visual/Online/TestSceneChatOverlay.cs
index a91cd53ec1..5ee17f80bd 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneChatOverlay.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneChatOverlay.cs
@@ -465,6 +465,38 @@ namespace osu.Game.Tests.Visual.Online
             AddStep("Highlight message", () => chatOverlay.HighlightMessage(message));
         }
 
+        [Test]
+        public void TestHighlightWhileChatHidden()
+        {
+            Message message = null;
+
+            AddStep("hide chat", () => chatOverlay.Hide());
+
+            AddStep("Join channel 1", () => channelManager.JoinChannel(channel1));
+            AddStep("Select channel 1", () => clickDrawable(chatOverlay.TabMap[channel1]));
+
+            AddStep("Send message in channel 1", () =>
+            {
+                channel1.AddNewMessages(message = new Message
+                {
+                    ChannelId = channel1.Id,
+                    Content = "Message to highlight!",
+                    Timestamp = DateTimeOffset.Now,
+                    Sender = new APIUser
+                    {
+                        Id = 2,
+                        Username = "Someone",
+                    }
+                });
+            });
+
+            AddStep("Highlight message and show chat", () =>
+            {
+                chatOverlay.HighlightMessage(message);
+                chatOverlay.Show();
+            });
+        }
+
         private void pressChannelHotkey(int number)
         {
             var channelKey = Key.Number0 + number;

From b25c37ce62d96a3cb2640480cb203ff6d7741280 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 10 Mar 2022 03:47:48 +0300
Subject: [PATCH 3341/5547] Instantiate highlight background container on
 animation

Also removes the necessity of scheduling as it actually never worked as
intended, `Scheduler` will still update even when the chat line is
masked away, and the animation will never be held anyways.

The new duration of the animation should be enough for long scrolls
either way.
---
 osu.Game/Overlays/Chat/ChatLine.cs        | 37 +++++++++++++----------
 osu.Game/Overlays/Chat/DrawableChannel.cs |  2 +-
 2 files changed, 22 insertions(+), 17 deletions(-)

diff --git a/osu.Game/Overlays/Chat/ChatLine.cs b/osu.Game/Overlays/Chat/ChatLine.cs
index 9ae80a4e2b..a1d8cd5d38 100644
--- a/osu.Game/Overlays/Chat/ChatLine.cs
+++ b/osu.Game/Overlays/Chat/ChatLine.cs
@@ -42,8 +42,6 @@ namespace osu.Game.Overlays.Chat
 
         protected virtual float TextSize => 20;
 
-        private Container lineHighlightBackground;
-
         private Color4 usernameColour;
 
         private OsuSpriteText timestamp;
@@ -146,15 +144,6 @@ namespace osu.Game.Overlays.Chat
 
             InternalChildren = new Drawable[]
             {
-                lineHighlightBackground = new Container
-                {
-                    Alpha = 0f,
-                    RelativeSizeAxes = Axes.Both,
-                    Colour = usernameColour.Darken(1f),
-                    CornerRadius = 2f,
-                    Masking = true,
-                    Child = new Box { RelativeSizeAxes = Axes.Both }
-                },
                 new Container
                 {
                     Size = new Vector2(MessagePadding, TextSize),
@@ -214,13 +203,29 @@ namespace osu.Game.Overlays.Chat
             FinishTransforms(true);
         }
 
+        private Container highlight;
+
         /// <summary>
-        /// Schedules a message highlight animation.
+        /// Performs a highlight animation on this <see cref="ChatLine"/>.
         /// </summary>
-        /// <remarks>
-        /// Scheduling is required to ensure the animation doesn't play until the chat line is in view and not scrolled away.
-        /// </remarks>
-        public void ScheduleHighlight() => Schedule(() => lineHighlightBackground.FadeTo(0.5f).FadeOut(1500, Easing.InQuint));
+        public void Highlight()
+        {
+            if (highlight?.IsAlive != true)
+            {
+                AddInternal(highlight = new Container
+                {
+                    CornerRadius = 2f,
+                    Masking = true,
+                    RelativeSizeAxes = Axes.Both,
+                    Colour = usernameColour.Darken(1f),
+                    Depth = float.MaxValue,
+                    Child = new Box { RelativeSizeAxes = Axes.Both }
+                });
+            }
+
+            highlight.FadeTo(0.5f).FadeOut(1500, Easing.InQuint);
+            highlight.Expire();
+        }
 
         private void updateMessageContent()
         {
diff --git a/osu.Game/Overlays/Chat/DrawableChannel.cs b/osu.Game/Overlays/Chat/DrawableChannel.cs
index 433fb2ced7..5086d08e91 100644
--- a/osu.Game/Overlays/Chat/DrawableChannel.cs
+++ b/osu.Game/Overlays/Chat/DrawableChannel.cs
@@ -102,7 +102,7 @@ namespace osu.Game.Overlays.Chat
                     {
                         float center = scroll.GetChildPosInContent(chatLine, chatLine.DrawSize / 2) - scroll.DisplayableContent / 2;
                         scroll.ScrollTo(Math.Clamp(center, 0, scroll.ScrollableExtent));
-                        chatLine.ScheduleHighlight();
+                        chatLine.Highlight();
                     }
 
                     highlightedMessage.Value = null;

From f229447453821c387da151c73eeee15cb3a47601 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 10 Mar 2022 04:01:07 +0300
Subject: [PATCH 3342/5547] Add too many messages to better test long scrolls

---
 .../Visual/Online/TestSceneStandAloneChatDisplay.cs         | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneStandAloneChatDisplay.cs b/osu.Game.Tests/Visual/Online/TestSceneStandAloneChatDisplay.cs
index 17c818963e..860ef5d565 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneStandAloneChatDisplay.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneStandAloneChatDisplay.cs
@@ -191,7 +191,7 @@ namespace osu.Game.Tests.Visual.Online
         {
             int index = 0;
 
-            fillChat();
+            fillChat(100);
 
             AddStep("highlight first message", () => testChannel.HighlightedMessage.Value = testChannel.Messages[index = 0]);
             AddStep("highlight next message", () => testChannel.HighlightedMessage.Value = testChannel.Messages[index = Math.Min(index + 1, testChannel.Messages.Count - 1)]);
@@ -304,11 +304,11 @@ namespace osu.Game.Tests.Visual.Online
             checkScrolledToBottom();
         }
 
-        private void fillChat()
+        private void fillChat(int count = 10)
         {
             AddStep("fill chat", () =>
             {
-                for (int i = 0; i < 10; i++)
+                for (int i = 0; i < count; i++)
                 {
                     testChannel.AddNewMessages(new Message(messageIdSequence++)
                     {

From c36badab4bf9c636c9c5e516c805923d96ba5b31 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 10 Mar 2022 10:26:09 +0900
Subject: [PATCH 3343/5547] Add per-ruleset score multipliers for classic
 scoring

---
 osu.Game.Rulesets.Catch/Scoring/CatchScoreProcessor.cs | 1 +
 osu.Game.Rulesets.Mania/Scoring/ManiaScoreProcessor.cs | 2 ++
 osu.Game.Rulesets.Osu/Scoring/OsuScoreProcessor.cs     | 2 ++
 osu.Game.Rulesets.Taiko/Scoring/TaikoScoreProcessor.cs | 2 ++
 osu.Game/Rulesets/Scoring/ScoreProcessor.cs            | 7 ++++++-
 5 files changed, 13 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Catch/Scoring/CatchScoreProcessor.cs b/osu.Game.Rulesets.Catch/Scoring/CatchScoreProcessor.cs
index 2cc05826b4..9cd03dc869 100644
--- a/osu.Game.Rulesets.Catch/Scoring/CatchScoreProcessor.cs
+++ b/osu.Game.Rulesets.Catch/Scoring/CatchScoreProcessor.cs
@@ -7,5 +7,6 @@ namespace osu.Game.Rulesets.Catch.Scoring
 {
     public class CatchScoreProcessor : ScoreProcessor
     {
+        protected override double ClassicScoreMultiplier => 28;
     }
 }
diff --git a/osu.Game.Rulesets.Mania/Scoring/ManiaScoreProcessor.cs b/osu.Game.Rulesets.Mania/Scoring/ManiaScoreProcessor.cs
index 48b377c794..e0b19d87e8 100644
--- a/osu.Game.Rulesets.Mania/Scoring/ManiaScoreProcessor.cs
+++ b/osu.Game.Rulesets.Mania/Scoring/ManiaScoreProcessor.cs
@@ -10,5 +10,7 @@ namespace osu.Game.Rulesets.Mania.Scoring
         protected override double DefaultAccuracyPortion => 0.99;
 
         protected override double DefaultComboPortion => 0.01;
+
+        protected override double ClassicScoreMultiplier => 16;
     }
 }
diff --git a/osu.Game.Rulesets.Osu/Scoring/OsuScoreProcessor.cs b/osu.Game.Rulesets.Osu/Scoring/OsuScoreProcessor.cs
index 44118227d9..df38f0204a 100644
--- a/osu.Game.Rulesets.Osu/Scoring/OsuScoreProcessor.cs
+++ b/osu.Game.Rulesets.Osu/Scoring/OsuScoreProcessor.cs
@@ -11,6 +11,8 @@ namespace osu.Game.Rulesets.Osu.Scoring
 {
     public class OsuScoreProcessor : ScoreProcessor
     {
+        protected override double ClassicScoreMultiplier => 36;
+
         protected override HitEvent CreateHitEvent(JudgementResult result)
             => base.CreateHitEvent(result).With((result as OsuHitCircleJudgementResult)?.CursorPositionAtHit);
 
diff --git a/osu.Game.Rulesets.Taiko/Scoring/TaikoScoreProcessor.cs b/osu.Game.Rulesets.Taiko/Scoring/TaikoScoreProcessor.cs
index 1829ea2513..849b9c14bd 100644
--- a/osu.Game.Rulesets.Taiko/Scoring/TaikoScoreProcessor.cs
+++ b/osu.Game.Rulesets.Taiko/Scoring/TaikoScoreProcessor.cs
@@ -10,5 +10,7 @@ namespace osu.Game.Rulesets.Taiko.Scoring
         protected override double DefaultAccuracyPortion => 0.75;
 
         protected override double DefaultComboPortion => 0.25;
+
+        protected override double ClassicScoreMultiplier => 22;
     }
 }
diff --git a/osu.Game/Rulesets/Scoring/ScoreProcessor.cs b/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
index d5a5aa4592..7ca8a0fecf 100644
--- a/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
+++ b/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
@@ -76,6 +76,11 @@ namespace osu.Game.Rulesets.Scoring
         /// </summary>
         protected virtual double DefaultComboPortion => 0.7;
 
+        /// <summary>
+        /// An arbitrary multiplier to scale scores in the <see cref="ScoringMode.Classic"/> scoring mode.
+        /// </summary>
+        protected virtual double ClassicScoreMultiplier => 36;
+
         private readonly double accuracyPortion;
         private readonly double comboPortion;
 
@@ -246,7 +251,7 @@ namespace osu.Game.Rulesets.Scoring
                     // This gives a similar feeling to osu!stable scoring (ScoreV1) while keeping classic scoring as only a constant multiple of standardised scoring.
                     // The invariant is important to ensure that scores don't get re-ordered on leaderboards between the two scoring modes.
                     double scaledStandardised = GetScore(ScoringMode.Standardised, accuracyRatio, comboRatio, statistics) / max_score;
-                    return Math.Pow(scaledStandardised * totalHitObjects, 2) * 36;
+                    return Math.Pow(scaledStandardised * totalHitObjects, 2) * ClassicScoreMultiplier;
             }
         }
 

From b38de6e580e61cc125d3305fbccdd4bf7b4da40c Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 10 Mar 2022 05:51:54 +0300
Subject: [PATCH 3344/5547] Add skinning support for welcome sprite text

---
 osu.Game/Screens/Menu/IntroWelcome.cs | 18 ++++++++++--------
 1 file changed, 10 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Screens/Menu/IntroWelcome.cs b/osu.Game/Screens/Menu/IntroWelcome.cs
index 639591cfef..f85dbe9abe 100644
--- a/osu.Game/Screens/Menu/IntroWelcome.cs
+++ b/osu.Game/Screens/Menu/IntroWelcome.cs
@@ -100,13 +100,13 @@ namespace osu.Game.Screens.Menu
 
         private class WelcomeIntroSequence : Container
         {
-            private Sprite welcomeText;
+            private Drawable welcomeText;
             private Container scaleContainer;
 
             public LogoVisualisation LogoVisualisation { get; private set; }
 
             [BackgroundDependencyLoader]
-            private void load(TextureStore textures)
+            private void load(TextureStore textures, IAPIProvider api)
             {
                 Origin = Anchor.Centre;
                 Anchor = Anchor.Centre;
@@ -135,15 +135,17 @@ namespace osu.Game.Screens.Menu
                                 Size = new Vector2(480),
                                 Colour = Color4.Black
                             },
-                            welcomeText = new Sprite
-                            {
-                                Anchor = Anchor.Centre,
-                                Origin = Anchor.Centre,
-                                Texture = textures.Get(@"Intro/Welcome/welcome_text")
-                            },
                         }
                     },
                 };
+
+                if (api.LocalUser.Value.IsSupporter)
+                    scaleContainer.Add(welcomeText = new SkinnableSprite(@"Intro/Welcome/welcome_text"));
+                else
+                    scaleContainer.Add(welcomeText = new Sprite { Texture = textures.Get(@"Intro/Welcome/welcome_text") });
+
+                welcomeText.Anchor = Anchor.Centre;
+                welcomeText.Origin = Anchor.Centre;
             }
 
             protected override void LoadComplete()

From b8ee786d774f2c504491ef41875f79b01c3636e0 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 10 Mar 2022 05:52:12 +0300
Subject: [PATCH 3345/5547] Add skinning support for "welcome" sample

---
 osu.Game/Screens/Menu/IntroWelcome.cs | 24 +++++++++++++++++++-----
 1 file changed, 19 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Screens/Menu/IntroWelcome.cs b/osu.Game/Screens/Menu/IntroWelcome.cs
index f85dbe9abe..27eaa7eb3a 100644
--- a/osu.Game/Screens/Menu/IntroWelcome.cs
+++ b/osu.Game/Screens/Menu/IntroWelcome.cs
@@ -13,7 +13,10 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Graphics.Textures;
+using osu.Game.Audio;
+using osu.Game.Online.API;
 using osu.Game.Screens.Backgrounds;
+using osu.Game.Skinning;
 using osuTK.Graphics;
 
 namespace osu.Game.Screens.Menu
@@ -23,8 +26,11 @@ namespace osu.Game.Screens.Menu
         protected override string BeatmapHash => "64e00d7022195959bfa3109d09c2e2276c8f12f486b91fcf6175583e973b48f2";
         protected override string BeatmapFile => "welcome.osz";
         private const double delay_step_two = 2142;
-        private Sample welcome;
-        private Sample pianoReverb;
+
+        private SkinnableSound skinnableWelcome;
+        private ISample welcome;
+
+        private ISample pianoReverb;
         protected override string SeeyaSampleName => "Intro/Welcome/seeya";
 
         protected override BackgroundScreen CreateBackground() => background = new BackgroundScreenDefault(false)
@@ -40,10 +46,15 @@ namespace osu.Game.Screens.Menu
         }
 
         [BackgroundDependencyLoader]
-        private void load(AudioManager audio)
+        private void load(AudioManager audio, IAPIProvider api)
         {
             if (MenuVoice.Value)
-                welcome = audio.Samples.Get(@"Intro/Welcome/welcome");
+            {
+                if (api.LocalUser.Value.IsSupporter)
+                    AddInternal(skinnableWelcome = new SkinnableSound(new SampleInfo(@"Intro/Welcome/welcome")));
+                else
+                    welcome = audio.Samples.Get(@"Intro/Welcome/welcome");
+            }
 
             pianoReverb = audio.Samples.Get(@"Intro/Welcome/welcome_piano");
         }
@@ -65,7 +76,10 @@ namespace osu.Game.Screens.Menu
 
                     AddInternal(intro);
 
-                    welcome?.Play();
+                    if (skinnableWelcome != null)
+                        skinnableWelcome.Play();
+                    else
+                        welcome?.Play();
 
                     var reverbChannel = pianoReverb?.Play();
                     if (reverbChannel != null)

From 2c1589e068dcc0af8d40ece788ed248fed782c8a Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 10 Mar 2022 05:52:20 +0300
Subject: [PATCH 3346/5547] Add skinning support for "seeya" sample

---
 osu.Game/Screens/Menu/IntroScreen.cs | 23 +++++++++++++++++++----
 1 file changed, 19 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Screens/Menu/IntroScreen.cs b/osu.Game/Screens/Menu/IntroScreen.cs
index afe75c5ef7..65f9dde1f9 100644
--- a/osu.Game/Screens/Menu/IntroScreen.cs
+++ b/osu.Game/Screens/Menu/IntroScreen.cs
@@ -13,14 +13,17 @@ using osu.Framework.Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Screens;
 using osu.Framework.Utils;
+using osu.Game.Audio;
 using osu.Game.Beatmaps;
 using osu.Game.Configuration;
 using osu.Game.Database;
 using osu.Game.IO.Archives;
+using osu.Game.Online.API;
 using osu.Game.Overlays;
 using osu.Game.Overlays.Notifications;
 using osu.Game.Rulesets;
 using osu.Game.Screens.Backgrounds;
+using osu.Game.Skinning;
 using osuTK;
 using osuTK.Graphics;
 using Realms;
@@ -55,7 +58,8 @@ namespace osu.Game.Screens.Menu
 
         private const int exit_delay = 3000;
 
-        private Sample seeya;
+        private SkinnableSound skinnableSeeya;
+        private ISample seeya;
 
         protected virtual string SeeyaSampleName => "Intro/seeya";
 
@@ -90,14 +94,18 @@ namespace osu.Game.Screens.Menu
         private BeatmapManager beatmaps { get; set; }
 
         [BackgroundDependencyLoader]
-        private void load(OsuConfigManager config, Framework.Game game, RealmAccess realm)
+        private void load(OsuConfigManager config, Framework.Game game, RealmAccess realm, IAPIProvider api)
         {
             // prevent user from changing beatmap while the intro is still running.
             beatmap = Beatmap.BeginLease(false);
 
             MenuVoice = config.GetBindable<bool>(OsuSetting.MenuVoice);
             MenuMusic = config.GetBindable<bool>(OsuSetting.MenuMusic);
-            seeya = audio.Samples.Get(SeeyaSampleName);
+
+            if (api.LocalUser.Value.IsSupporter)
+                AddInternal(skinnableSeeya = new SkinnableSound(new SampleInfo(SeeyaSampleName)));
+            else
+                seeya = audio.Samples.Get(SeeyaSampleName);
 
             // if the user has requested not to play theme music, we should attempt to find a random beatmap from their collection.
             if (!MenuMusic.Value)
@@ -201,7 +209,14 @@ namespace osu.Game.Screens.Menu
             // we also handle the exit transition.
             if (MenuVoice.Value)
             {
-                seeya.Play();
+                // ensure samples have been updated after resume before playing.
+                ScheduleAfterChildren(() =>
+                {
+                    if (skinnableSeeya != null)
+                        skinnableSeeya.Play();
+                    else
+                        seeya.Play();
+                });
 
                 // if playing the outro voice, we have more time to have fun with the background track.
                 // initially fade to almost silent then ramp out over the remaining time.

From ede838c4b3ebaa2fa2471de68ec11bbf7fbd21e5 Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Thu, 10 Mar 2022 11:23:52 +0800
Subject: [PATCH 3347/5547] Use `ObjectPositionInfo.HitObject`

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

diff --git a/osu.Game.Rulesets.Osu/Utils/OsuHitObjectPositionModifier.cs b/osu.Game.Rulesets.Osu/Utils/OsuHitObjectPositionModifier.cs
index 428866623f..32f547dfe7 100644
--- a/osu.Game.Rulesets.Osu/Utils/OsuHitObjectPositionModifier.cs
+++ b/osu.Game.Rulesets.Osu/Utils/OsuHitObjectPositionModifier.cs
@@ -70,11 +70,10 @@ namespace osu.Game.Rulesets.Osu.Utils
         {
             ObjectPositionInfo? previous = null;
 
-            for (int i = 0; i < hitObjects.Count; i++)
+            for (int i = 0; i < objectPositionInfos.Count; i++)
             {
-                var hitObject = hitObjects[i];
-
                 var current = objectPositionInfos[i];
+                var hitObject = current.HitObject;
 
                 if (hitObject is Spinner)
                 {

From 3a71d817758e8387568a0a8f974f6c8ac22e43e7 Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Thu, 10 Mar 2022 11:53:03 +0800
Subject: [PATCH 3348/5547] Convert the position modifier to stateless methods

---
 osu.Game.Rulesets.Osu/Mods/OsuModRandom.cs    |  8 +--
 .../Utils/OsuHitObjectGenerationUtils.cs      |  2 +-
 ...OsuHitObjectGenerationUtils_Reposition.cs} | 65 +++++++++----------
 3 files changed, 35 insertions(+), 40 deletions(-)
 rename osu.Game.Rulesets.Osu/Utils/{OsuHitObjectPositionModifier.cs => OsuHitObjectGenerationUtils_Reposition.cs} (84%)

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModRandom.cs b/osu.Game.Rulesets.Osu/Mods/OsuModRandom.cs
index cdaa8fa3d5..3c2c5d7759 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModRandom.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModRandom.cs
@@ -35,18 +35,18 @@ namespace osu.Game.Rulesets.Osu.Mods
 
             rng = new Random((int)Seed.Value);
 
-            var positionModifier = new OsuHitObjectPositionModifier(osuBeatmap.HitObjects);
+            var positionInfos = OsuHitObjectGenerationUtils.GeneratePositionInfos(osuBeatmap.HitObjects);
 
             float rateOfChangeMultiplier = 0;
 
-            foreach (var positionInfo in positionModifier.ObjectPositionInfos)
+            foreach (var positionInfo in positionInfos)
             {
                 // rateOfChangeMultiplier only changes every 5 iterations in a combo
                 // to prevent shaky-line-shaped streams
                 if (positionInfo.HitObject.IndexInCurrentCombo % 5 == 0)
                     rateOfChangeMultiplier = (float)rng.NextDouble() * 2 - 1;
 
-                if (positionInfo == positionModifier.ObjectPositionInfos.First())
+                if (positionInfo == positionInfos.First())
                 {
                     positionInfo.DistanceFromPrevious = (float)rng.NextDouble() * OsuPlayfield.BASE_SIZE.Y / 2;
                     positionInfo.RelativeAngle = (float)(rng.NextDouble() * 2 * Math.PI - Math.PI);
@@ -57,7 +57,7 @@ namespace osu.Game.Rulesets.Osu.Mods
                 }
             }
 
-            positionModifier.ApplyModifications();
+            osuBeatmap.HitObjects = OsuHitObjectGenerationUtils.RepositionHitObjects(positionInfos);
         }
     }
 }
diff --git a/osu.Game.Rulesets.Osu/Utils/OsuHitObjectGenerationUtils.cs b/osu.Game.Rulesets.Osu/Utils/OsuHitObjectGenerationUtils.cs
index 97a4b14a62..da73c2addb 100644
--- a/osu.Game.Rulesets.Osu/Utils/OsuHitObjectGenerationUtils.cs
+++ b/osu.Game.Rulesets.Osu/Utils/OsuHitObjectGenerationUtils.cs
@@ -11,7 +11,7 @@ using osuTK;
 
 namespace osu.Game.Rulesets.Osu.Utils
 {
-    public static class OsuHitObjectGenerationUtils
+    public static partial class OsuHitObjectGenerationUtils
     {
         // The relative distance to the edge of the playfield before objects' positions should start to "turn around" and curve towards the middle.
         // The closer the hit objects draw to the border, the sharper the turn
diff --git a/osu.Game.Rulesets.Osu/Utils/OsuHitObjectPositionModifier.cs b/osu.Game.Rulesets.Osu/Utils/OsuHitObjectGenerationUtils_Reposition.cs
similarity index 84%
rename from osu.Game.Rulesets.Osu/Utils/OsuHitObjectPositionModifier.cs
rename to osu.Game.Rulesets.Osu/Utils/OsuHitObjectGenerationUtils_Reposition.cs
index 32f547dfe7..2a735c89d9 100644
--- a/osu.Game.Rulesets.Osu/Utils/OsuHitObjectPositionModifier.cs
+++ b/osu.Game.Rulesets.Osu/Utils/OsuHitObjectGenerationUtils_Reposition.cs
@@ -13,10 +13,7 @@ using osuTK;
 
 namespace osu.Game.Rulesets.Osu.Utils
 {
-    /// <summary>
-    /// Places hit objects according to information in <see cref="ObjectPositionInfos"/> while keeping objects inside the playfield.
-    /// </summary>
-    public class OsuHitObjectPositionModifier
+    public static partial class OsuHitObjectGenerationUtils
     {
         /// <summary>
         /// Number of previous hitobjects to be shifted together when an object is being moved.
@@ -25,24 +22,15 @@ namespace osu.Game.Rulesets.Osu.Utils
 
         private static readonly Vector2 playfield_centre = OsuPlayfield.BASE_SIZE / 2;
 
-        private readonly List<OsuHitObject> hitObjects;
-
-        private readonly List<ObjectPositionInfo> objectPositionInfos = new List<ObjectPositionInfo>();
-
         /// <summary>
-        /// Contains information specifying how each hit object should be placed.
-        /// <para>The default values correspond to how objects are originally placed in the beatmap.</para>
+        /// Generate a list of <see cref="IObjectPositionInfo"/>s containing information for how the given list of
+        /// <see cref="OsuHitObject"/>s are positioned.
         /// </summary>
-        public IReadOnlyList<IObjectPositionInfo> ObjectPositionInfos => objectPositionInfos;
-
-        public OsuHitObjectPositionModifier(List<OsuHitObject> hitObjects)
-        {
-            this.hitObjects = hitObjects;
-            populateObjectPositionInfos();
-        }
-
-        private void populateObjectPositionInfos()
+        /// <param name="hitObjects">A list of <see cref="OsuHitObject"/>s to process.</param>
+        /// <returns>A list of <see cref="IObjectPositionInfo"/>s describing how each hit object is positioned relative to the previous one.</returns>
+        public static List<IObjectPositionInfo> GeneratePositionInfos(IEnumerable<OsuHitObject> hitObjects)
         {
+            var positionInfos = new List<IObjectPositionInfo>();
             Vector2 previousPosition = playfield_centre;
             float previousAngle = 0;
 
@@ -52,7 +40,7 @@ namespace osu.Game.Rulesets.Osu.Utils
                 float absoluteAngle = (float)Math.Atan2(relativePosition.Y, relativePosition.X);
                 float relativeAngle = absoluteAngle - previousAngle;
 
-                objectPositionInfos.Add(new ObjectPositionInfo(hitObject)
+                positionInfos.Add(new ObjectPositionInfo(hitObject)
                 {
                     RelativeAngle = relativeAngle,
                     DistanceFromPrevious = relativePosition.Length
@@ -61,18 +49,23 @@ namespace osu.Game.Rulesets.Osu.Utils
                 previousPosition = hitObject.EndPosition;
                 previousAngle = absoluteAngle;
             }
+
+            return positionInfos;
         }
 
         /// <summary>
-        /// Reposition the hit objects according to the information in <see cref="ObjectPositionInfos"/>.
+        /// Reposition the hit objects according to the information in <paramref name="objectPositionInfos"/>.
         /// </summary>
-        public void ApplyModifications()
+        /// <param name="objectPositionInfos"></param>
+        /// <returns>The repositioned hit objects.</returns>
+        public static List<OsuHitObject> RepositionHitObjects(IEnumerable<IObjectPositionInfo> objectPositionInfos)
         {
+            List<ObjectPositionInfo> positionInfos = objectPositionInfos.Cast<ObjectPositionInfo>().ToList();
             ObjectPositionInfo? previous = null;
 
-            for (int i = 0; i < objectPositionInfos.Count; i++)
+            for (int i = 0; i < positionInfos.Count; i++)
             {
-                var current = objectPositionInfos[i];
+                var current = positionInfos[i];
                 var hitObject = current.HitObject;
 
                 if (hitObject is Spinner)
@@ -81,7 +74,7 @@ namespace osu.Game.Rulesets.Osu.Utils
                     continue;
                 }
 
-                computeModifiedPosition(current, previous, i > 1 ? objectPositionInfos[i - 2] : null);
+                computeModifiedPosition(current, previous, i > 1 ? positionInfos[i - 2] : null);
 
                 // Move hit objects back into the playfield if they are outside of it
                 Vector2 shift = Vector2.Zero;
@@ -104,9 +97,9 @@ namespace osu.Game.Rulesets.Osu.Utils
                     for (int j = i - 1; j >= i - preceding_hitobjects_to_shift && j >= 0; j--)
                     {
                         // only shift hit circles
-                        if (!(hitObjects[j] is HitCircle)) break;
+                        if (!(positionInfos[j].HitObject is HitCircle)) break;
 
-                        toBeShifted.Add(hitObjects[j]);
+                        toBeShifted.Add(positionInfos[j].HitObject);
                     }
 
                     if (toBeShifted.Count > 0)
@@ -115,6 +108,8 @@ namespace osu.Game.Rulesets.Osu.Utils
 
                 previous = current;
             }
+
+            return positionInfos.Select(p => p.HitObject).ToList();
         }
 
         /// <summary>
@@ -123,7 +118,7 @@ namespace osu.Game.Rulesets.Osu.Utils
         /// <param name="current">The <see cref="ObjectPositionInfo"/> representing the hit object to have the modified position computed for.</param>
         /// <param name="previous">The <see cref="ObjectPositionInfo"/> representing the hit object immediately preceding the current one.</param>
         /// <param name="beforePrevious">The <see cref="ObjectPositionInfo"/> representing the hit object immediately preceding the <paramref name="previous"/> one.</param>
-        private void computeModifiedPosition(ObjectPositionInfo current, ObjectPositionInfo? previous, ObjectPositionInfo? beforePrevious)
+        private static void computeModifiedPosition(ObjectPositionInfo current, ObjectPositionInfo? previous, ObjectPositionInfo? beforePrevious)
         {
             float previousAbsoluteAngle = 0f;
 
@@ -143,7 +138,7 @@ namespace osu.Game.Rulesets.Osu.Utils
 
             Vector2 lastEndPosition = previous?.EndPositionModified ?? playfield_centre;
 
-            posRelativeToPrev = OsuHitObjectGenerationUtils.RotateAwayFromEdge(lastEndPosition, posRelativeToPrev);
+            posRelativeToPrev = RotateAwayFromEdge(lastEndPosition, posRelativeToPrev);
 
             current.PositionModified = lastEndPosition + posRelativeToPrev;
         }
@@ -152,7 +147,7 @@ namespace osu.Game.Rulesets.Osu.Utils
         /// Move the modified position of a hit circle so that it fits inside the playfield.
         /// </summary>
         /// <returns>The deviation from the original modified position in order to fit within the playfield.</returns>
-        private Vector2 clampHitCircleToPlayfield(HitCircle circle, ObjectPositionInfo objectPositionInfo)
+        private static Vector2 clampHitCircleToPlayfield(HitCircle circle, ObjectPositionInfo objectPositionInfo)
         {
             var previousPosition = objectPositionInfo.PositionModified;
             objectPositionInfo.EndPositionModified = objectPositionInfo.PositionModified = clampToPlayfieldWithPadding(
@@ -169,7 +164,7 @@ namespace osu.Game.Rulesets.Osu.Utils
         /// Moves the <see cref="Slider"/> and all necessary nested <see cref="OsuHitObject"/>s into the <see cref="OsuPlayfield"/> if they aren't already.
         /// </summary>
         /// <returns>The deviation from the original modified position in order to fit within the playfield.</returns>
-        private Vector2 clampSliderToPlayfield(Slider slider, ObjectPositionInfo objectPositionInfo)
+        private static Vector2 clampSliderToPlayfield(Slider slider, ObjectPositionInfo objectPositionInfo)
         {
             var possibleMovementBounds = calculatePossibleMovementBounds(slider);
 
@@ -199,7 +194,7 @@ namespace osu.Game.Rulesets.Osu.Utils
         /// </summary>
         /// <param name="hitObjects">The list of hit objects to be shifted.</param>
         /// <param name="shift">The amount to be shifted.</param>
-        private void applyDecreasingShift(IList<OsuHitObject> hitObjects, Vector2 shift)
+        private static void applyDecreasingShift(IList<OsuHitObject> hitObjects, Vector2 shift)
         {
             for (int i = 0; i < hitObjects.Count; i++)
             {
@@ -219,7 +214,7 @@ namespace osu.Game.Rulesets.Osu.Utils
         /// <remarks>
         /// If the slider is larger than the playfield, the returned <see cref="RectangleF"/> may have negative width/height.
         /// </remarks>
-        private RectangleF calculatePossibleMovementBounds(Slider slider)
+        private static RectangleF calculatePossibleMovementBounds(Slider slider)
         {
             var pathPositions = new List<Vector2>();
             slider.Path.GetPathToProgress(pathPositions, 0, 1);
@@ -266,7 +261,7 @@ namespace osu.Game.Rulesets.Osu.Utils
         /// </summary>
         /// <param name="slider"><see cref="Slider"/> whose nested <see cref="SliderTick"/>s and <see cref="SliderRepeat"/>s should be shifted</param>
         /// <param name="shift">The <see cref="Vector2"/> the <see cref="Slider"/>'s nested <see cref="SliderTick"/>s and <see cref="SliderRepeat"/>s should be shifted by</param>
-        private void shiftNestedObjects(Slider slider, Vector2 shift)
+        private static void shiftNestedObjects(Slider slider, Vector2 shift)
         {
             foreach (var hitObject in slider.NestedHitObjects.Where(o => o is SliderTick || o is SliderRepeat))
             {
@@ -283,7 +278,7 @@ namespace osu.Game.Rulesets.Osu.Utils
         /// <param name="position">The position to be clamped.</param>
         /// <param name="padding">The minimum distance allowed from playfield edges.</param>
         /// <returns>The clamped position.</returns>
-        private Vector2 clampToPlayfieldWithPadding(Vector2 position, float padding)
+        private static Vector2 clampToPlayfieldWithPadding(Vector2 position, float padding)
         {
             return new Vector2(
                 Math.Clamp(position.X, padding, OsuPlayfield.BASE_SIZE.X - padding),

From 5e36383258b8a5cb01ab6298d6d2283ef86e6c4f Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Thu, 10 Mar 2022 12:02:25 +0800
Subject: [PATCH 3349/5547] Convert `IObjectPositionInfo` to a class

---
 .../OsuHitObjectGenerationUtils_Reposition.cs | 69 ++++++++++---------
 1 file changed, 35 insertions(+), 34 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Utils/OsuHitObjectGenerationUtils_Reposition.cs b/osu.Game.Rulesets.Osu/Utils/OsuHitObjectGenerationUtils_Reposition.cs
index 2a735c89d9..37a12b20b4 100644
--- a/osu.Game.Rulesets.Osu/Utils/OsuHitObjectGenerationUtils_Reposition.cs
+++ b/osu.Game.Rulesets.Osu/Utils/OsuHitObjectGenerationUtils_Reposition.cs
@@ -23,14 +23,14 @@ namespace osu.Game.Rulesets.Osu.Utils
         private static readonly Vector2 playfield_centre = OsuPlayfield.BASE_SIZE / 2;
 
         /// <summary>
-        /// Generate a list of <see cref="IObjectPositionInfo"/>s containing information for how the given list of
+        /// Generate a list of <see cref="ObjectPositionInfo"/>s containing information for how the given list of
         /// <see cref="OsuHitObject"/>s are positioned.
         /// </summary>
         /// <param name="hitObjects">A list of <see cref="OsuHitObject"/>s to process.</param>
-        /// <returns>A list of <see cref="IObjectPositionInfo"/>s describing how each hit object is positioned relative to the previous one.</returns>
-        public static List<IObjectPositionInfo> GeneratePositionInfos(IEnumerable<OsuHitObject> hitObjects)
+        /// <returns>A list of <see cref="ObjectPositionInfo"/>s describing how each hit object is positioned relative to the previous one.</returns>
+        public static List<ObjectPositionInfo> GeneratePositionInfos(IEnumerable<OsuHitObject> hitObjects)
         {
-            var positionInfos = new List<IObjectPositionInfo>();
+            var positionInfos = new List<ObjectPositionInfo>();
             Vector2 previousPosition = playfield_centre;
             float previousAngle = 0;
 
@@ -56,12 +56,12 @@ namespace osu.Game.Rulesets.Osu.Utils
         /// <summary>
         /// Reposition the hit objects according to the information in <paramref name="objectPositionInfos"/>.
         /// </summary>
-        /// <param name="objectPositionInfos"></param>
+        /// <param name="objectPositionInfos">Position information for each hit object.</param>
         /// <returns>The repositioned hit objects.</returns>
-        public static List<OsuHitObject> RepositionHitObjects(IEnumerable<IObjectPositionInfo> objectPositionInfos)
+        public static List<OsuHitObject> RepositionHitObjects(IEnumerable<ObjectPositionInfo> objectPositionInfos)
         {
-            List<ObjectPositionInfo> positionInfos = objectPositionInfos.Cast<ObjectPositionInfo>().ToList();
-            ObjectPositionInfo? previous = null;
+            List<ObjectPositionInfoInternal> positionInfos = objectPositionInfos.Select(o => new ObjectPositionInfoInternal(o)).ToList();
+            ObjectPositionInfoInternal? previous = null;
 
             for (int i = 0; i < positionInfos.Count; i++)
             {
@@ -115,10 +115,10 @@ namespace osu.Game.Rulesets.Osu.Utils
         /// <summary>
         /// Compute the modified position of a hit object while attempting to keep it inside the playfield.
         /// </summary>
-        /// <param name="current">The <see cref="ObjectPositionInfo"/> representing the hit object to have the modified position computed for.</param>
-        /// <param name="previous">The <see cref="ObjectPositionInfo"/> representing the hit object immediately preceding the current one.</param>
-        /// <param name="beforePrevious">The <see cref="ObjectPositionInfo"/> representing the hit object immediately preceding the <paramref name="previous"/> one.</param>
-        private static void computeModifiedPosition(ObjectPositionInfo current, ObjectPositionInfo? previous, ObjectPositionInfo? beforePrevious)
+        /// <param name="current">The <see cref="ObjectPositionInfoInternal"/> representing the hit object to have the modified position computed for.</param>
+        /// <param name="previous">The <see cref="ObjectPositionInfoInternal"/> representing the hit object immediately preceding the current one.</param>
+        /// <param name="beforePrevious">The <see cref="ObjectPositionInfoInternal"/> representing the hit object immediately preceding the <paramref name="previous"/> one.</param>
+        private static void computeModifiedPosition(ObjectPositionInfoInternal current, ObjectPositionInfoInternal? previous, ObjectPositionInfoInternal? beforePrevious)
         {
             float previousAbsoluteAngle = 0f;
 
@@ -147,7 +147,7 @@ namespace osu.Game.Rulesets.Osu.Utils
         /// Move the modified position of a hit circle so that it fits inside the playfield.
         /// </summary>
         /// <returns>The deviation from the original modified position in order to fit within the playfield.</returns>
-        private static Vector2 clampHitCircleToPlayfield(HitCircle circle, ObjectPositionInfo objectPositionInfo)
+        private static Vector2 clampHitCircleToPlayfield(HitCircle circle, ObjectPositionInfoInternal objectPositionInfo)
         {
             var previousPosition = objectPositionInfo.PositionModified;
             objectPositionInfo.EndPositionModified = objectPositionInfo.PositionModified = clampToPlayfieldWithPadding(
@@ -164,7 +164,7 @@ namespace osu.Game.Rulesets.Osu.Utils
         /// Moves the <see cref="Slider"/> and all necessary nested <see cref="OsuHitObject"/>s into the <see cref="OsuPlayfield"/> if they aren't already.
         /// </summary>
         /// <returns>The deviation from the original modified position in order to fit within the playfield.</returns>
-        private static Vector2 clampSliderToPlayfield(Slider slider, ObjectPositionInfo objectPositionInfo)
+        private static Vector2 clampSliderToPlayfield(Slider slider, ObjectPositionInfoInternal objectPositionInfo)
         {
             var possibleMovementBounds = calculatePossibleMovementBounds(slider);
 
@@ -286,7 +286,7 @@ namespace osu.Game.Rulesets.Osu.Utils
             );
         }
 
-        public interface IObjectPositionInfo
+        public class ObjectPositionInfo
         {
             /// <summary>
             /// The jump angle from the previous hit object to this one, relative to the previous hit object's jump angle.
@@ -298,7 +298,7 @@ namespace osu.Game.Rulesets.Osu.Utils
             /// If <see cref="RelativeAngle"/> is 0, the player's cursor doesn't need to change its direction of movement when passing
             /// the previous object to reach this one.
             /// </example>
-            float RelativeAngle { get; set; }
+            public float RelativeAngle { get; set; }
 
             /// <summary>
             /// The jump distance from the previous hit object to this one.
@@ -306,32 +306,33 @@ namespace osu.Game.Rulesets.Osu.Utils
             /// <remarks>
             /// <see cref="DistanceFromPrevious"/> of the first hit object in a beatmap is relative to the playfield center.
             /// </remarks>
-            float DistanceFromPrevious { get; set; }
-
-            /// <summary>
-            /// The hit object associated with this <see cref="IObjectPositionInfo"/>.
-            /// </summary>
-            OsuHitObject HitObject { get; }
-        }
-
-        private class ObjectPositionInfo : IObjectPositionInfo
-        {
-            public float RelativeAngle { get; set; }
-
             public float DistanceFromPrevious { get; set; }
 
-            public Vector2 PositionOriginal { get; }
-            public Vector2 PositionModified { get; set; }
-            public Vector2 EndPositionModified { get; set; }
-
+            /// <summary>
+            /// The hit object associated with this <see cref="ObjectPositionInfo"/>.
+            /// </summary>
             public OsuHitObject HitObject { get; }
 
             public ObjectPositionInfo(OsuHitObject hitObject)
             {
-                PositionModified = PositionOriginal = hitObject.Position;
-                EndPositionModified = hitObject.EndPosition;
                 HitObject = hitObject;
             }
         }
+
+        private class ObjectPositionInfoInternal : ObjectPositionInfo
+        {
+            public Vector2 PositionOriginal { get; }
+            public Vector2 PositionModified { get; set; }
+            public Vector2 EndPositionModified { get; set; }
+
+            public ObjectPositionInfoInternal(ObjectPositionInfo original)
+                : base(original.HitObject)
+            {
+                RelativeAngle = original.RelativeAngle;
+                DistanceFromPrevious = original.DistanceFromPrevious;
+                PositionModified = PositionOriginal = HitObject.Position;
+                EndPositionModified = HitObject.EndPosition;
+            }
+        }
     }
 }

From eaef27595c71e8412f449345e9b81528fc6b60e9 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 10 Mar 2022 15:33:50 +0900
Subject: [PATCH 3350/5547] Also mark `UnknownMod` as not user-playable

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

diff --git a/osu.Game/Rulesets/Mods/UnknownMod.cs b/osu.Game/Rulesets/Mods/UnknownMod.cs
index 013725e227..b426386d7a 100644
--- a/osu.Game/Rulesets/Mods/UnknownMod.cs
+++ b/osu.Game/Rulesets/Mods/UnknownMod.cs
@@ -15,6 +15,8 @@ namespace osu.Game.Rulesets.Mods
         public override string Description => "This mod could not be resolved by the game.";
         public override double ScoreMultiplier => 0;
 
+        public override bool UserPlayable => false;
+
         public override ModType Type => ModType.System;
 
         public UnknownMod(string acronym)

From 1a187d4dec553a0563e6baa75a5c15e282c34a7b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 10 Mar 2022 15:49:18 +0900
Subject: [PATCH 3351/5547] Add animation to checkbox when joning/leaving a
 channel

---
 .../Overlays/Chat/Listing/ChannelListingItem.cs  | 16 ++++++++++------
 1 file changed, 10 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Overlays/Chat/Listing/ChannelListingItem.cs b/osu.Game/Overlays/Chat/Listing/ChannelListingItem.cs
index 9586730c6b..83362bc79d 100644
--- a/osu.Game/Overlays/Chat/Listing/ChannelListingItem.cs
+++ b/osu.Game/Overlays/Chat/Listing/ChannelListingItem.cs
@@ -81,9 +81,9 @@ namespace osu.Game.Overlays.Chat.Listing
                         {
                             checkbox = new SpriteIcon
                             {
-                                Anchor = Anchor.CentreLeft,
-                                Origin = Anchor.CentreLeft,
-                                Margin = new MarginPadding { Left = 15 },
+                                Alpha = 0,
+                                Anchor = Anchor.Centre,
+                                Origin = Anchor.Centre,
                                 Icon = FontAwesome.Solid.Check,
                                 Size = new Vector2(icon_size),
                             },
@@ -134,15 +134,19 @@ namespace osu.Game.Overlays.Chat.Listing
             channelJoined = channel.Joined.GetBoundCopy();
             channelJoined.BindValueChanged(change =>
             {
+                const double duration = 500;
+
                 if (change.NewValue)
                 {
-                    checkbox.Show();
+                    checkbox.FadeIn(duration, Easing.OutQuint);
+                    checkbox.ScaleTo(1f, duration, Easing.OutElastic);
                     channelText.Colour = Colour4.White;
                     topicText.Colour = Colour4.White;
                 }
                 else
                 {
-                    checkbox.Hide();
+                    checkbox.FadeOut(duration, Easing.OutQuint);
+                    checkbox.ScaleTo(0.8f, duration, Easing.OutQuint);
                     channelText.Colour = colourProvider.Light3;
                     topicText.Colour = colourProvider.Content2;
                 }
@@ -159,7 +163,7 @@ namespace osu.Game.Overlays.Chat.Listing
 
         protected override void OnHoverLost(HoverLostEvent e)
         {
-            hoverBox.Hide();
+            hoverBox.FadeOut(300, Easing.OutQuint);
             base.OnHoverLost(e);
         }
     }

From 46f2db1712beda4ae0a33d2c5fe54b6b10f19b0a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 10 Mar 2022 15:58:19 +0900
Subject: [PATCH 3352/5547] Move `ChannelListingItem` spacing into item so
 input is always handled by an item in the list

Without this change, there would be a couple of pixels between each list
item where nothing would be hovered. This is a pretty annoying UX which
we should be avoiding we possible.
---
 osu.Game/Overlays/Chat/Listing/ChannelListing.cs     | 2 --
 osu.Game/Overlays/Chat/Listing/ChannelListingItem.cs | 5 ++++-
 2 files changed, 4 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Overlays/Chat/Listing/ChannelListing.cs b/osu.Game/Overlays/Chat/Listing/ChannelListing.cs
index 9b8b45c85f..732c78de15 100644
--- a/osu.Game/Overlays/Chat/Listing/ChannelListing.cs
+++ b/osu.Game/Overlays/Chat/Listing/ChannelListing.cs
@@ -12,7 +12,6 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
 using osu.Game.Graphics.Containers;
 using osu.Game.Online.Chat;
-using osuTK;
 
 namespace osu.Game.Overlays.Chat.Listing
 {
@@ -51,7 +50,6 @@ namespace osu.Game.Overlays.Chat.Listing
                         Direction = FillDirection.Vertical,
                         RelativeSizeAxes = Axes.X,
                         AutoSizeAxes = Axes.Y,
-                        Spacing = new Vector2(3),
                         Padding = new MarginPadding
                         {
                             Vertical = 13,
diff --git a/osu.Game/Overlays/Chat/Listing/ChannelListingItem.cs b/osu.Game/Overlays/Chat/Listing/ChannelListingItem.cs
index 83362bc79d..526cbcda87 100644
--- a/osu.Game/Overlays/Chat/Listing/ChannelListingItem.cs
+++ b/osu.Game/Overlays/Chat/Listing/ChannelListingItem.cs
@@ -43,6 +43,8 @@ namespace osu.Game.Overlays.Chat.Listing
         private const float text_size = 18;
         private const float icon_size = 14;
 
+        private const float vertical_margin = 1.5f;
+
         public ChannelListingItem(Channel channel)
         {
             this.channel = channel;
@@ -54,7 +56,7 @@ namespace osu.Game.Overlays.Chat.Listing
             Masking = true;
             CornerRadius = 5;
             RelativeSizeAxes = Axes.X;
-            Height = 20;
+            Height = 20 + (vertical_margin * 2);
 
             Children = new Drawable[]
             {
@@ -62,6 +64,7 @@ namespace osu.Game.Overlays.Chat.Listing
                 {
                     RelativeSizeAxes = Axes.Both,
                     Colour = colourProvider.Background3,
+                    Margin = new MarginPadding { Vertical = vertical_margin },
                     Alpha = 0f,
                 },
                 new GridContainer

From c61397cc22c9ba9a1a78ab8ec1ba0ab64526a799 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 10 Mar 2022 16:22:27 +0900
Subject: [PATCH 3353/5547] Fix whitespace/inspection

---
 osu.Game/Online/API/APIMod.cs | 1 -
 1 file changed, 1 deletion(-)

diff --git a/osu.Game/Online/API/APIMod.cs b/osu.Game/Online/API/APIMod.cs
index ef8637b8ed..44b1c460d5 100644
--- a/osu.Game/Online/API/APIMod.cs
+++ b/osu.Game/Online/API/APIMod.cs
@@ -102,5 +102,4 @@ namespace osu.Game.Online.API
             public int GetHashCode(KeyValuePair<string, object> obj) => HashCode.Combine(obj.Key, ModUtils.GetSettingUnderlyingValue(obj.Value));
         }
     }
-
 }

From a1b7bf3986666e7ec07a226988386a3b84b75507 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 10 Mar 2022 16:47:02 +0900
Subject: [PATCH 3354/5547] Use a minimum fade length for clamping rather than
 zero
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.Osu/Skinning/Default/KiaiFlash.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu/Skinning/Default/KiaiFlash.cs b/osu.Game.Rulesets.Osu/Skinning/Default/KiaiFlash.cs
index 46e0030034..506f679836 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Default/KiaiFlash.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Default/KiaiFlash.cs
@@ -38,7 +38,7 @@ namespace osu.Game.Rulesets.Osu.Skinning.Default
             Child
                 .FadeTo(flash_opacity, EarlyActivationMilliseconds, Easing.OutQuint)
                 .Then()
-                .FadeOut(Math.Max(0, timingPoint.BeatLength - fade_length), Easing.OutSine);
+                .FadeOut(Math.Max(fade_length, timingPoint.BeatLength - fade_length), Easing.OutSine);
         }
     }
 }

From 671d614c92bde69e6465cc718fd69e561b34c42d Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 10 Mar 2022 17:54:31 +0900
Subject: [PATCH 3355/5547] Fix beatmap wedge mutating transforms incorrectly

---
 osu.Game/Screens/Select/BeatmapInfoWedge.cs | 40 +++++++++++----------
 1 file changed, 21 insertions(+), 19 deletions(-)

diff --git a/osu.Game/Screens/Select/BeatmapInfoWedge.cs b/osu.Game/Screens/Select/BeatmapInfoWedge.cs
index ea531e89c8..59a48f4f9d 100644
--- a/osu.Game/Screens/Select/BeatmapInfoWedge.cs
+++ b/osu.Game/Screens/Select/BeatmapInfoWedge.cs
@@ -152,7 +152,6 @@ namespace osu.Game.Screens.Select
             public OsuSpriteText VersionLabel { get; private set; }
             public OsuSpriteText TitleLabel { get; private set; }
             public OsuSpriteText ArtistLabel { get; private set; }
-            public BeatmapSetOnlineStatusPill StatusPill { get; private set; }
             public FillFlowContainer MapperContainer { get; private set; }
 
             private Container difficultyColourBar;
@@ -169,6 +168,12 @@ namespace osu.Game.Screens.Select
             [Resolved]
             private IBindable<IReadOnlyList<Mod>> mods { get; set; }
 
+            [Resolved]
+            private BeatmapDifficultyCache difficultyCache { get; set; }
+
+            [Resolved]
+            private OsuColour colours { get; set; }
+
             private ModSettingChangeTracker settingChangeTracker;
 
             public WedgeInfoText(WorkingBeatmap working, RulesetInfo userRuleset)
@@ -181,7 +186,7 @@ namespace osu.Game.Screens.Select
             private IBindable<StarDifficulty?> starDifficulty;
 
             [BackgroundDependencyLoader]
-            private void load(OsuColour colours, LocalisationManager localisation, BeatmapDifficultyCache difficultyCache)
+            private void load(LocalisationManager localisation)
             {
                 var beatmapInfo = working.BeatmapInfo;
                 var metadata = beatmapInfo.Metadata;
@@ -255,7 +260,7 @@ namespace osu.Game.Screens.Select
                                 Shear = -wedged_container_shear,
                                 Alpha = 0f,
                             },
-                            StatusPill = new BeatmapSetOnlineStatusPill
+                            new BeatmapSetOnlineStatusPill
                             {
                                 AutoSizeAxes = Axes.Both,
                                 Anchor = Anchor.TopRight,
@@ -264,6 +269,7 @@ namespace osu.Game.Screens.Select
                                 TextSize = 11,
                                 TextPadding = new MarginPadding { Horizontal = 8, Vertical = 2 },
                                 Status = beatmapInfo.Status,
+                                Alpha = string.IsNullOrEmpty(beatmapInfo.DifficultyName) ? 0 : 1
                             }
                         }
                     },
@@ -311,22 +317,6 @@ namespace osu.Game.Screens.Select
                 titleBinding.BindValueChanged(_ => setMetadata(metadata.Source));
                 artistBinding.BindValueChanged(_ => setMetadata(metadata.Source), true);
 
-                starRatingDisplay.DisplayedStars.BindValueChanged(s =>
-                {
-                    difficultyColourBar.Colour = colours.ForStarDifficulty(s.NewValue);
-                }, true);
-
-                starDifficulty = difficultyCache.GetBindableDifficulty(beatmapInfo, (cancellationSource = new CancellationTokenSource()).Token);
-                starDifficulty.BindValueChanged(s =>
-                {
-                    starRatingDisplay.FadeIn(transition_duration);
-                    starRatingDisplay.Current.Value = s.NewValue ?? default;
-                });
-
-                // no difficulty means it can't have a status to show
-                if (string.IsNullOrEmpty(beatmapInfo.DifficultyName))
-                    StatusPill.Hide();
-
                 addInfoLabels();
             }
 
@@ -334,6 +324,18 @@ namespace osu.Game.Screens.Select
             {
                 base.LoadComplete();
 
+                starRatingDisplay.DisplayedStars.BindValueChanged(s =>
+                {
+                    difficultyColourBar.Colour = colours.ForStarDifficulty(s.NewValue);
+                }, true);
+
+                starDifficulty = difficultyCache.GetBindableDifficulty(working.BeatmapInfo, (cancellationSource = new CancellationTokenSource()).Token);
+                starDifficulty.BindValueChanged(s =>
+                {
+                    starRatingDisplay.FadeIn(transition_duration);
+                    starRatingDisplay.Current.Value = s.NewValue ?? default;
+                });
+
                 mods.BindValueChanged(m =>
                 {
                     settingChangeTracker?.Dispose();

From d5eca16b69eb01ec42a3b747e1367a3510f4775f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 10 Mar 2022 18:08:07 +0900
Subject: [PATCH 3356/5547] Fix potential test failures due to slow realm
 refresh in `TestSceneScreenNavigation`

As seen at https://github.com/ppy/osu/runs/5492345983?check_suite_focus=true.
---
 osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs b/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
index 8debb95f38..f2e6aa1e16 100644
--- a/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
@@ -133,7 +133,7 @@ namespace osu.Game.Tests.Visual.Navigation
             AddStep("confirm deletion", () => InputManager.Key(Key.Number1));
             AddUntilStep("wait for dialog dismissed", () => Game.Dependencies.Get<DialogOverlay>().CurrentDialog == null);
 
-            AddAssert("ensure score is pending deletion", () => Game.Realm.Run(r => r.Find<ScoreInfo>(score.ID)?.DeletePending == true));
+            AddUntilStep("ensure score is pending deletion", () => Game.Realm.Run(r => r.Find<ScoreInfo>(score.ID)?.DeletePending == true));
 
             AddUntilStep("wait for score panel removal", () => scorePanel.Parent == null);
         }
@@ -178,7 +178,7 @@ namespace osu.Game.Tests.Visual.Navigation
             AddStep("confirm deletion", () => InputManager.Key(Key.Number1));
             AddUntilStep("wait for dialog dismissed", () => Game.Dependencies.Get<DialogOverlay>().CurrentDialog == null);
 
-            AddAssert("ensure score is pending deletion", () => Game.Realm.Run(r => r.Find<ScoreInfo>(score.ID)?.DeletePending == true));
+            AddUntilStep("ensure score is pending deletion", () => Game.Realm.Run(r => r.Find<ScoreInfo>(score.ID)?.DeletePending == true));
 
             AddUntilStep("wait for score panel removal", () => scorePanel.Parent == null);
         }

From 45d537ef727e787afeaf044b9cfc12af50c29bf9 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 10 Mar 2022 18:50:53 +0900
Subject: [PATCH 3357/5547] Fix potential multiplayer crash with async disposal

---
 osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayer.cs | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayer.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayer.cs
index d8fb448437..b49f373c7b 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayer.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayer.cs
@@ -175,7 +175,10 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
             base.StartGameplay();
         });
 
-        private void onResultsReady() => resultsReady.SetResult(true);
+        private void onResultsReady() => Scheduler.Add(() =>
+        {
+            resultsReady.SetResult(true);
+        });
 
         protected override async Task PrepareScoreForResultsAsync(Score score)
         {

From 2d135e5be61e2615fe045747a34c834d31d3c7fb Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 10 Mar 2022 19:52:08 +0900
Subject: [PATCH 3358/5547] Explain purpose of `Schedule` call in
 `MultiplayerPlayer.onResultsReady`

---
 .../Screens/OnlinePlay/Multiplayer/MultiplayerPlayer.cs   | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayer.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayer.cs
index b49f373c7b..78e7f3d987 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayer.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayer.cs
@@ -175,10 +175,12 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
             base.StartGameplay();
         });
 
-        private void onResultsReady() => Scheduler.Add(() =>
+        private void onResultsReady()
         {
-            resultsReady.SetResult(true);
-        });
+            // Schedule is required to ensure that `TaskCompletionSource.SetResult` is not called more than once.
+            // A scenario where this can occur is if this instance is not immediately disposed (ie. async disposal queue).
+            Schedule(() => resultsReady.SetResult(true));
+        }
 
         protected override async Task PrepareScoreForResultsAsync(Score score)
         {

From 2de779584482cb5a0795a338ad7666982ca6335a Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 10 Mar 2022 19:59:05 +0900
Subject: [PATCH 3359/5547] Fix always rolling up from zero

Co-authored-by: Dean Herbert <pe@ppy.sh>
---
 osu.Game/Screens/Select/BeatmapInfoWedge.cs | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Select/BeatmapInfoWedge.cs b/osu.Game/Screens/Select/BeatmapInfoWedge.cs
index 59a48f4f9d..1e0aaf9c27 100644
--- a/osu.Game/Screens/Select/BeatmapInfoWedge.cs
+++ b/osu.Game/Screens/Select/BeatmapInfoWedge.cs
@@ -332,8 +332,13 @@ namespace osu.Game.Screens.Select
                 starDifficulty = difficultyCache.GetBindableDifficulty(working.BeatmapInfo, (cancellationSource = new CancellationTokenSource()).Token);
                 starDifficulty.BindValueChanged(s =>
                 {
-                    starRatingDisplay.FadeIn(transition_duration);
                     starRatingDisplay.Current.Value = s.NewValue ?? default;
+
+                    // Don't roll the counter on initial display (but still allow it to roll on applying mods etc.)
+                    if (!starRatingDisplay.IsPresent)
+                        starRatingDisplay.FinishTransforms(true);
+
+                    starRatingDisplay.FadeIn(transition_duration);
                 });
 
                 mods.BindValueChanged(m =>

From 885cb3ce5bc0768a3e434436a5e540bfaff4a5b4 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 10 Mar 2022 20:02:58 +0900
Subject: [PATCH 3360/5547] Add current screen checks for added safety

---
 .../OnlinePlay/Multiplayer/MultiplayerPlayer.cs      | 12 +++++++++++-
 1 file changed, 11 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayer.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayer.cs
index 78e7f3d987..043315c790 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayer.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayer.cs
@@ -10,6 +10,7 @@ using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Logging;
+using osu.Framework.Screens;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Rooms;
@@ -171,6 +172,9 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
 
         private void onMatchStarted() => Scheduler.Add(() =>
         {
+            if (!this.IsCurrentScreen())
+                return;
+
             loadingDisplay.Hide();
             base.StartGameplay();
         });
@@ -179,7 +183,13 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
         {
             // Schedule is required to ensure that `TaskCompletionSource.SetResult` is not called more than once.
             // A scenario where this can occur is if this instance is not immediately disposed (ie. async disposal queue).
-            Schedule(() => resultsReady.SetResult(true));
+            Schedule(() =>
+            {
+                if (!this.IsCurrentScreen())
+                    return;
+
+                resultsReady.SetResult(true);
+            });
         }
 
         protected override async Task PrepareScoreForResultsAsync(Score score)

From e4ef540b5b321c2eef6932d44d6508055a851e52 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 10 Mar 2022 20:33:14 +0900
Subject: [PATCH 3361/5547] Fix intermittent failures on
 `TestBeatmapDownloadingFlow` due to slow realm refresh

---
 .../Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs   | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs b/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
index 2521d570f2..db988a544d 100644
--- a/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
+++ b/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
@@ -118,7 +118,7 @@ namespace osu.Game.Tests.Online
         [Test]
         public void TestBeatmapDownloadingFlow()
         {
-            AddAssert("ensure beatmap unavailable", () => !beatmaps.IsAvailableLocally(testBeatmapSet));
+            AddUntilStep("ensure beatmap unavailable", () => !beatmaps.IsAvailableLocally(testBeatmapSet));
             addAvailabilityCheckStep("state not downloaded", BeatmapAvailability.NotDownloaded);
 
             AddStep("start downloading", () => beatmapDownloader.Download(testBeatmapSet));
@@ -132,7 +132,7 @@ namespace osu.Game.Tests.Online
 
             AddStep("allow importing", () => beatmaps.AllowImport.SetResult(true));
             AddUntilStep("wait for import", () => beatmaps.CurrentImport != null);
-            AddAssert("ensure beatmap available", () => beatmaps.IsAvailableLocally(testBeatmapSet));
+            AddUntilStep("ensure beatmap available", () => beatmaps.IsAvailableLocally(testBeatmapSet));
             addAvailabilityCheckStep("state is locally available", BeatmapAvailability.LocallyAvailable);
         }
 

From 717ddbba4e0eb4e4a1f3a96ea83dfc17273d48f9 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 10 Mar 2022 16:30:20 +0300
Subject: [PATCH 3362/5547] Fix skin components toolbox not autosizing properly

---
 osu.Game/Overlays/SettingsToolboxGroup.cs | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/SettingsToolboxGroup.cs b/osu.Game/Overlays/SettingsToolboxGroup.cs
index b4178359a4..b9e5283a44 100644
--- a/osu.Game/Overlays/SettingsToolboxGroup.cs
+++ b/osu.Game/Overlays/SettingsToolboxGroup.cs
@@ -162,7 +162,9 @@ namespace osu.Game.Overlays
 
             Expanded.BindValueChanged(v =>
             {
-                content.ClearTransforms();
+                // clearing transforms can break autosizing, see: https://github.com/ppy/osu-framework/issues/5064
+                if (v.NewValue != v.OldValue)
+                    content.ClearTransforms();
 
                 if (v.NewValue)
                     content.AutoSizeAxes = Axes.Y;

From 68aedd63a7c9e0234de549988d876f1a2b8817d6 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 10 Mar 2022 20:22:36 +0900
Subject: [PATCH 3363/5547] Move `SelectionHandler`'s `SelectedItems` binding
 to the base implementation

Until now it was up to each implementation to connect
`BlueprintContainer` to its `SelectionHandler`, which didn't make much
sense at all.
---
 .../Screens/Edit/Compose/Components/BlueprintContainer.cs   | 1 +
 .../Edit/Compose/Components/EditorSelectionHandler.cs       | 6 +-----
 2 files changed, 2 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Screens/Edit/Compose/Components/BlueprintContainer.cs b/osu.Game/Screens/Edit/Compose/Components/BlueprintContainer.cs
index 130d7a015f..6dc6f20cfe 100644
--- a/osu.Game/Screens/Edit/Compose/Components/BlueprintContainer.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/BlueprintContainer.cs
@@ -73,6 +73,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
 
             SelectionHandler = CreateSelectionHandler();
             SelectionHandler.DeselectAll = deselectAll;
+            SelectionHandler.SelectedItems.BindTo(SelectedItems);
 
             AddRangeInternal(new[]
             {
diff --git a/osu.Game/Screens/Edit/Compose/Components/EditorSelectionHandler.cs b/osu.Game/Screens/Edit/Compose/Components/EditorSelectionHandler.cs
index 5f6e8de557..7f693996a4 100644
--- a/osu.Game/Screens/Edit/Compose/Components/EditorSelectionHandler.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/EditorSelectionHandler.cs
@@ -29,11 +29,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
             // bring in updates from selection changes
             EditorBeatmap.HitObjectUpdated += _ => Scheduler.AddOnce(UpdateTernaryStates);
 
-            SelectedItems.BindTo(EditorBeatmap.SelectedHitObjects);
-            SelectedItems.CollectionChanged += (sender, args) =>
-            {
-                Scheduler.AddOnce(UpdateTernaryStates);
-            };
+            SelectedItems.CollectionChanged += (sender, args) => Scheduler.AddOnce(UpdateTernaryStates);
         }
 
         protected override void DeleteItems(IEnumerable<HitObject> items) => EditorBeatmap.RemoveRange(items);

From 8cbc8b944f1ec39622cabc2388db53bdacea3e9f Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 10 Mar 2022 17:25:13 +0300
Subject: [PATCH 3364/5547] Rescope scheduling and improve comment

---
 osu.Game/Screens/Menu/IntroScreen.cs | 15 ++++++++-------
 1 file changed, 8 insertions(+), 7 deletions(-)

diff --git a/osu.Game/Screens/Menu/IntroScreen.cs b/osu.Game/Screens/Menu/IntroScreen.cs
index 65f9dde1f9..a6b54dd1f2 100644
--- a/osu.Game/Screens/Menu/IntroScreen.cs
+++ b/osu.Game/Screens/Menu/IntroScreen.cs
@@ -209,14 +209,15 @@ namespace osu.Game.Screens.Menu
             // we also handle the exit transition.
             if (MenuVoice.Value)
             {
-                // ensure samples have been updated after resume before playing.
-                ScheduleAfterChildren(() =>
+                if (skinnableSeeya != null)
                 {
-                    if (skinnableSeeya != null)
-                        skinnableSeeya.Play();
-                    else
-                        seeya.Play();
-                });
+                    // resuming a screen (i.e. calling OnResume) happens before the screen itself becomes alive,
+                    // therefore skinnable samples may not be updated yet with the recently selected skin.
+                    // schedule after children to ensure skinnable samples have processed skin changes before playing.
+                    ScheduleAfterChildren(() => skinnableSeeya.Play());
+                }
+                else
+                    seeya.Play();
 
                 // if playing the outro voice, we have more time to have fun with the background track.
                 // initially fade to almost silent then ramp out over the remaining time.

From c72e8a8b5e37d3e959a491e926422ded94dd931a Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 10 Mar 2022 21:28:38 +0300
Subject: [PATCH 3365/5547] Add functionality to switch to successfully joined
 channel

---
 osu.Game/Online/Chat/ChannelManager.cs | 12 +++++++-----
 1 file changed, 7 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Online/Chat/ChannelManager.cs b/osu.Game/Online/Chat/ChannelManager.cs
index 47e45e67d1..1404c0f333 100644
--- a/osu.Game/Online/Chat/ChannelManager.cs
+++ b/osu.Game/Online/Chat/ChannelManager.cs
@@ -420,10 +420,11 @@ namespace osu.Game.Online.Chat
         /// Joins a channel if it has not already been joined. Must be called from the update thread.
         /// </summary>
         /// <param name="channel">The channel to join.</param>
+        /// <param name="switchToJoined">Switch <see cref="CurrentChannel"/> to the joined channel on successful request.</param>
         /// <returns>The joined channel. Note that this may not match the parameter channel as it is a backed object.</returns>
-        public Channel JoinChannel(Channel channel) => joinChannel(channel, true);
+        public Channel JoinChannel(Channel channel, bool switchToJoined = false) => joinChannel(channel, switchToJoined, true);
 
-        private Channel joinChannel(Channel channel, bool fetchInitialMessages = false)
+        private Channel joinChannel(Channel channel, bool switchToJoined = false, bool fetchInitialMessages = false)
         {
             if (channel == null) return null;
 
@@ -439,7 +440,7 @@ namespace osu.Game.Online.Chat
                     case ChannelType.Multiplayer:
                         // join is implicit. happens when you join a multiplayer game.
                         // this will probably change in the future.
-                        joinChannel(channel, fetchInitialMessages);
+                        joinChannel(channel, switchToJoined, fetchInitialMessages);
                         return channel;
 
                     case ChannelType.PM:
@@ -460,7 +461,7 @@ namespace osu.Game.Online.Chat
 
                     default:
                         var req = new JoinChannelRequest(channel);
-                        req.Success += () => joinChannel(channel, fetchInitialMessages);
+                        req.Success += () => joinChannel(channel, switchToJoined, fetchInitialMessages);
                         req.Failure += ex => LeaveChannel(channel);
                         api.Queue(req);
                         return channel;
@@ -472,7 +473,8 @@ namespace osu.Game.Online.Chat
                     this.fetchInitialMessages(channel);
             }
 
-            CurrentChannel.Value ??= channel;
+            if (switchToJoined || CurrentChannel.Value == null)
+                CurrentChannel.Value = channel;
 
             return channel;
         }

From 5315ff794a30295e5f018d23a8e5c4026782d97c Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 10 Mar 2022 21:29:32 +0300
Subject: [PATCH 3366/5547] Handle non-existing channels on message
 highlighting gracefully

---
 osu.Game/Overlays/ChatOverlay.cs | 17 ++++++++++++++---
 1 file changed, 14 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Overlays/ChatOverlay.cs b/osu.Game/Overlays/ChatOverlay.cs
index d6a1b23c46..a0b5e55014 100644
--- a/osu.Game/Overlays/ChatOverlay.cs
+++ b/osu.Game/Overlays/ChatOverlay.cs
@@ -309,10 +309,21 @@ namespace osu.Game.Overlays
         /// <param name="message">The message to highlight.</param>
         public void HighlightMessage(Message message)
         {
-            if (channelManager.CurrentChannel.Value.Id != message.ChannelId)
-                channelManager.CurrentChannel.Value = channelManager.JoinedChannels.Single(c => c.Id == message.ChannelId);
+            Channel targetChannel;
 
-            channelManager.CurrentChannel.Value.HighlightedMessage.Value = message;
+            if (channelManager.CurrentChannel.Value.Id == message.ChannelId)
+                targetChannel = channelManager.CurrentChannel.Value;
+            else
+            {
+                targetChannel = channelManager.JoinedChannels.SingleOrDefault(c => c.Id == message.ChannelId);
+
+                if (targetChannel != null)
+                    channelManager.CurrentChannel.Value = targetChannel;
+                else
+                    targetChannel = channelManager.JoinChannel(channelManager.AvailableChannels.SingleOrDefault(c => c.Id == message.ChannelId), true);
+            }
+
+            targetChannel.HighlightedMessage.Value = message;
         }
 
         private float startDragChatHeight;

From e41937083003a2b9c13ac0abd449c8068e574686 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 10 Mar 2022 21:30:02 +0300
Subject: [PATCH 3367/5547] Add test coverage for highlighting message on left
 channel

---
 .../Visual/Online/TestSceneChatOverlay.cs     | 30 +++++++++++++++++++
 1 file changed, 30 insertions(+)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneChatOverlay.cs b/osu.Game.Tests/Visual/Online/TestSceneChatOverlay.cs
index 5ee17f80bd..906b3faa98 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneChatOverlay.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneChatOverlay.cs
@@ -463,6 +463,36 @@ namespace osu.Game.Tests.Visual.Online
             });
 
             AddStep("Highlight message", () => chatOverlay.HighlightMessage(message));
+            AddAssert("Switched to channel 2", () => channelManager.CurrentChannel.Value == channel2);
+        }
+
+        [Test]
+        public void TestHighlightOnLeftChannel()
+        {
+            Message message = null;
+
+            AddStep("Join channel 1", () => channelManager.JoinChannel(channel1));
+            AddStep("Select channel 1", () => clickDrawable(chatOverlay.TabMap[channel1]));
+
+            AddStep("Join channel 2", () => channelManager.JoinChannel(channel2));
+            AddStep("Send message in channel 2", () =>
+            {
+                channel2.AddNewMessages(message = new Message
+                {
+                    ChannelId = channel2.Id,
+                    Content = "Message to highlight!",
+                    Timestamp = DateTimeOffset.Now,
+                    Sender = new APIUser
+                    {
+                        Id = 2,
+                        Username = "Someone",
+                    }
+                });
+            });
+            AddStep("Leave channel 2", () => channelManager.LeaveChannel(channel2));
+
+            AddStep("Highlight message", () => chatOverlay.HighlightMessage(message));
+            AddAssert("Switched to channel 2", () => channelManager.CurrentChannel.Value == channel2);
         }
 
         [Test]

From 8086f734514ba70ae9997fd2927af2e5dd432a45 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 10 Mar 2022 22:50:02 +0300
Subject: [PATCH 3368/5547] Revert "Add functionality to switch to successfully
 joined channel"

This reverts commit c72e8a8b5e37d3e959a491e926422ded94dd931a.
---
 osu.Game/Online/Chat/ChannelManager.cs | 12 +++++-------
 1 file changed, 5 insertions(+), 7 deletions(-)

diff --git a/osu.Game/Online/Chat/ChannelManager.cs b/osu.Game/Online/Chat/ChannelManager.cs
index 1404c0f333..47e45e67d1 100644
--- a/osu.Game/Online/Chat/ChannelManager.cs
+++ b/osu.Game/Online/Chat/ChannelManager.cs
@@ -420,11 +420,10 @@ namespace osu.Game.Online.Chat
         /// Joins a channel if it has not already been joined. Must be called from the update thread.
         /// </summary>
         /// <param name="channel">The channel to join.</param>
-        /// <param name="switchToJoined">Switch <see cref="CurrentChannel"/> to the joined channel on successful request.</param>
         /// <returns>The joined channel. Note that this may not match the parameter channel as it is a backed object.</returns>
-        public Channel JoinChannel(Channel channel, bool switchToJoined = false) => joinChannel(channel, switchToJoined, true);
+        public Channel JoinChannel(Channel channel) => joinChannel(channel, true);
 
-        private Channel joinChannel(Channel channel, bool switchToJoined = false, bool fetchInitialMessages = false)
+        private Channel joinChannel(Channel channel, bool fetchInitialMessages = false)
         {
             if (channel == null) return null;
 
@@ -440,7 +439,7 @@ namespace osu.Game.Online.Chat
                     case ChannelType.Multiplayer:
                         // join is implicit. happens when you join a multiplayer game.
                         // this will probably change in the future.
-                        joinChannel(channel, switchToJoined, fetchInitialMessages);
+                        joinChannel(channel, fetchInitialMessages);
                         return channel;
 
                     case ChannelType.PM:
@@ -461,7 +460,7 @@ namespace osu.Game.Online.Chat
 
                     default:
                         var req = new JoinChannelRequest(channel);
-                        req.Success += () => joinChannel(channel, switchToJoined, fetchInitialMessages);
+                        req.Success += () => joinChannel(channel, fetchInitialMessages);
                         req.Failure += ex => LeaveChannel(channel);
                         api.Queue(req);
                         return channel;
@@ -473,8 +472,7 @@ namespace osu.Game.Online.Chat
                     this.fetchInitialMessages(channel);
             }
 
-            if (switchToJoined || CurrentChannel.Value == null)
-                CurrentChannel.Value = channel;
+            CurrentChannel.Value ??= channel;
 
             return channel;
         }

From a31611bdec45c0378e9486cfb090733f7d12b2e0 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 10 Mar 2022 22:54:47 +0300
Subject: [PATCH 3369/5547] Improve channel switching flow in
 `HighlightMessage`

---
 .../Visual/Online/TestSceneChatOverlay.cs     |  8 +++----
 osu.Game/Online/Chat/MessageNotifier.cs       | 22 ++++++++++---------
 osu.Game/Overlays/ChatOverlay.cs              | 20 ++++++++---------
 3 files changed, 25 insertions(+), 25 deletions(-)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneChatOverlay.cs b/osu.Game.Tests/Visual/Online/TestSceneChatOverlay.cs
index 906b3faa98..00ff6a9576 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneChatOverlay.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneChatOverlay.cs
@@ -435,7 +435,7 @@ namespace osu.Game.Tests.Visual.Online
                 });
             });
 
-            AddStep("Highlight message", () => chatOverlay.HighlightMessage(message));
+            AddStep("Highlight message", () => chatOverlay.HighlightMessage(message, channel1));
         }
 
         [Test]
@@ -462,7 +462,7 @@ namespace osu.Game.Tests.Visual.Online
                 });
             });
 
-            AddStep("Highlight message", () => chatOverlay.HighlightMessage(message));
+            AddStep("Highlight message", () => chatOverlay.HighlightMessage(message, channel2));
             AddAssert("Switched to channel 2", () => channelManager.CurrentChannel.Value == channel2);
         }
 
@@ -491,7 +491,7 @@ namespace osu.Game.Tests.Visual.Online
             });
             AddStep("Leave channel 2", () => channelManager.LeaveChannel(channel2));
 
-            AddStep("Highlight message", () => chatOverlay.HighlightMessage(message));
+            AddStep("Highlight message", () => chatOverlay.HighlightMessage(message, channel2));
             AddAssert("Switched to channel 2", () => channelManager.CurrentChannel.Value == channel2);
         }
 
@@ -522,7 +522,7 @@ namespace osu.Game.Tests.Visual.Online
 
             AddStep("Highlight message and show chat", () =>
             {
-                chatOverlay.HighlightMessage(message);
+                chatOverlay.HighlightMessage(message, channel1);
                 chatOverlay.Show();
             });
         }
diff --git a/osu.Game/Online/Chat/MessageNotifier.cs b/osu.Game/Online/Chat/MessageNotifier.cs
index 90b6d927c7..bcfec3cc0f 100644
--- a/osu.Game/Online/Chat/MessageNotifier.cs
+++ b/osu.Game/Online/Chat/MessageNotifier.cs
@@ -99,7 +99,7 @@ namespace osu.Game.Online.Chat
                 if (checkForPMs(channel, message))
                     continue;
 
-                checkForMentions(message);
+                checkForMentions(channel, message);
             }
         }
 
@@ -114,15 +114,15 @@ namespace osu.Game.Online.Chat
             if (!notifyOnPrivateMessage.Value || channel.Type != ChannelType.PM)
                 return false;
 
-            notifications.Post(new PrivateMessageNotification(message));
+            notifications.Post(new PrivateMessageNotification(message, channel));
             return true;
         }
 
-        private void checkForMentions(Message message)
+        private void checkForMentions(Channel channel, Message message)
         {
             if (!notifyOnUsername.Value || !CheckContainsUsername(message.Content, localUser.Value.Username)) return;
 
-            notifications.Post(new MentionNotification(message));
+            notifications.Post(new MentionNotification(message, channel));
         }
 
         /// <summary>
@@ -138,8 +138,8 @@ namespace osu.Game.Online.Chat
 
         public class PrivateMessageNotification : HighlightMessageNotification
         {
-            public PrivateMessageNotification(Message message)
-                : base(message)
+            public PrivateMessageNotification(Message message, Channel channel)
+                : base(message, channel)
             {
                 Icon = FontAwesome.Solid.Envelope;
                 Text = $"You received a private message from '{message.Sender.Username}'. Click to read it!";
@@ -148,8 +148,8 @@ namespace osu.Game.Online.Chat
 
         public class MentionNotification : HighlightMessageNotification
         {
-            public MentionNotification(Message message)
-                : base(message)
+            public MentionNotification(Message message, Channel channel)
+                : base(message, channel)
             {
                 Icon = FontAwesome.Solid.At;
                 Text = $"Your name was mentioned in chat by '{message.Sender.Username}'. Click to find out why!";
@@ -158,12 +158,14 @@ namespace osu.Game.Online.Chat
 
         public abstract class HighlightMessageNotification : SimpleNotification
         {
-            protected HighlightMessageNotification(Message message)
+            protected HighlightMessageNotification(Message message, Channel channel)
             {
                 this.message = message;
+                this.channel = channel;
             }
 
             private readonly Message message;
+            private readonly Channel channel;
 
             public override bool IsImportant => false;
 
@@ -175,7 +177,7 @@ namespace osu.Game.Online.Chat
                 Activated = delegate
                 {
                     notificationOverlay.Hide();
-                    chatOverlay.HighlightMessage(message);
+                    chatOverlay.HighlightMessage(message, channel);
                     chatOverlay.Show();
 
                     return true;
diff --git a/osu.Game/Overlays/ChatOverlay.cs b/osu.Game/Overlays/ChatOverlay.cs
index a0b5e55014..3764ac42fc 100644
--- a/osu.Game/Overlays/ChatOverlay.cs
+++ b/osu.Game/Overlays/ChatOverlay.cs
@@ -3,6 +3,7 @@
 
 using System.Collections.Generic;
 using System.Collections.Specialized;
+using System.Diagnostics;
 using System.Linq;
 using osuTK;
 using osuTK.Graphics;
@@ -307,23 +308,20 @@ namespace osu.Game.Overlays
         /// Highlights a certain message in the specified channel.
         /// </summary>
         /// <param name="message">The message to highlight.</param>
-        public void HighlightMessage(Message message)
+        /// <param name="channel">The channel containing the message.</param>
+        public void HighlightMessage(Message message, Channel channel)
         {
-            Channel targetChannel;
+            Debug.Assert(channel.Id == message.ChannelId);
 
-            if (channelManager.CurrentChannel.Value.Id == message.ChannelId)
-                targetChannel = channelManager.CurrentChannel.Value;
-            else
+            if (currentChannel.Value.Id != channel.Id)
             {
-                targetChannel = channelManager.JoinedChannels.SingleOrDefault(c => c.Id == message.ChannelId);
+                if (!channel.Joined.Value)
+                    channel = channelManager.JoinChannel(channel);
 
-                if (targetChannel != null)
-                    channelManager.CurrentChannel.Value = targetChannel;
-                else
-                    targetChannel = channelManager.JoinChannel(channelManager.AvailableChannels.SingleOrDefault(c => c.Id == message.ChannelId), true);
+                channelManager.CurrentChannel.Value = channel;
             }
 
-            targetChannel.HighlightedMessage.Value = message;
+            channel.HighlightedMessage.Value = message;
         }
 
         private float startDragChatHeight;

From d07e3101ea5a040b00c3fc1f66bf1b131aa2dba8 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 10 Mar 2022 23:06:58 +0300
Subject: [PATCH 3370/5547] Improve message highlight handling in
 `DrawableChannel`

---
 osu.Game/Overlays/Chat/DrawableChannel.cs | 46 ++++++++++++-----------
 1 file changed, 25 insertions(+), 21 deletions(-)

diff --git a/osu.Game/Overlays/Chat/DrawableChannel.cs b/osu.Game/Overlays/Chat/DrawableChannel.cs
index 5086d08e91..1d9f8c7ab7 100644
--- a/osu.Game/Overlays/Chat/DrawableChannel.cs
+++ b/osu.Game/Overlays/Chat/DrawableChannel.cs
@@ -87,29 +87,31 @@ namespace osu.Game.Overlays.Chat
             base.LoadComplete();
 
             highlightedMessage = Channel.HighlightedMessage.GetBoundCopy();
-            highlightedMessage.BindValueChanged(m =>
-            {
-                if (m.NewValue == null)
-                    return;
-
-                // schedule highlight to ensure it performs after any pending "newMessagesArrived" calls.
-                // also schedule after children to ensure the scroll flow is updated with any new chat lines.
-                ScheduleAfterChildren(() =>
-                {
-                    var chatLine = chatLines.SingleOrDefault(c => c.Message.Equals(m.NewValue));
-
-                    if (chatLine != null)
-                    {
-                        float center = scroll.GetChildPosInContent(chatLine, chatLine.DrawSize / 2) - scroll.DisplayableContent / 2;
-                        scroll.ScrollTo(Math.Clamp(center, 0, scroll.ScrollableExtent));
-                        chatLine.Highlight();
-                    }
-
-                    highlightedMessage.Value = null;
-                });
-            }, true);
+            highlightedMessage.BindValueChanged(_ => processMessageHighlighting(), true);
         }
 
+        /// <summary>
+        /// Processes any pending message in <see cref="highlightedMessage"/>.
+        /// </summary>
+        /// <remarks>
+        /// <see cref="CompositeDrawable.ScheduleAfterChildren"/> is for ensuring the scroll flow has updated with any new chat lines.
+        /// </remarks>
+        private void processMessageHighlighting() => ScheduleAfterChildren(() =>
+        {
+            if (highlightedMessage.Value == null)
+                return;
+
+            var chatLine = chatLines.SingleOrDefault(c => c.Message.Equals(highlightedMessage.Value));
+            if (chatLine == null)
+                return;
+
+            float center = scroll.GetChildPosInContent(chatLine, chatLine.DrawSize / 2) - scroll.DisplayableContent / 2;
+            scroll.ScrollTo(Math.Clamp(center, 0, scroll.ScrollableExtent));
+            chatLine.Highlight();
+
+            highlightedMessage.Value = null;
+        });
+
         protected override void Dispose(bool isDisposing)
         {
             base.Dispose(isDisposing);
@@ -179,6 +181,8 @@ namespace osu.Game.Overlays.Chat
             // to avoid making the container think the user has scrolled back up and unwantedly disable auto-scrolling.
             if (newMessages.Any(m => m is LocalMessage))
                 scroll.ScrollToEnd();
+
+            processMessageHighlighting();
         });
 
         private void pendingMessageResolved(Message existing, Message updated) => Schedule(() =>

From 32c7a023f8206ec6cde60e4d1d2dc9641eb06a66 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 11 Mar 2022 19:54:13 +0900
Subject: [PATCH 3371/5547] Make `OsuGame.ScreenChanged` `private` and
 non-`virtual`

Just reducing complexity scope here.
---
 osu.Game/OsuGame.cs | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index fb81e4fd14..7cd043083a 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -1140,7 +1140,7 @@ namespace osu.Game
             MenuCursorContainer.CanShowCursor = (ScreenStack.CurrentScreen as IOsuScreen)?.CursorVisible ?? false;
         }
 
-        protected virtual void ScreenChanged(IScreen current, IScreen newScreen)
+        private void screenChanged(IScreen current, IScreen newScreen)
         {
             skinEditor.Reset();
 
@@ -1187,11 +1187,11 @@ namespace osu.Game
             }
         }
 
-        private void screenPushed(IScreen lastScreen, IScreen newScreen) => ScreenChanged(lastScreen, newScreen);
+        private void screenPushed(IScreen lastScreen, IScreen newScreen) => screenChanged(lastScreen, newScreen);
 
         private void screenExited(IScreen lastScreen, IScreen newScreen)
         {
-            ScreenChanged(lastScreen, newScreen);
+            screenChanged(lastScreen, newScreen);
 
             if (newScreen == null)
                 Exit();

From ac55fea3c953a6c81326308200d4b905cd921c3b Mon Sep 17 00:00:00 2001
From: Susko3 <16479013+Susko3@users.noreply.github.com>
Date: Fri, 11 Mar 2022 14:04:12 +0100
Subject: [PATCH 3372/5547] Confine the host cursor to area of 'everything'
 scaling container

---
 .../Graphics/Containers/ScalingContainer.cs   | 45 +++++++++++++++++--
 1 file changed, 42 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Graphics/Containers/ScalingContainer.cs b/osu.Game/Graphics/Containers/ScalingContainer.cs
index d331b818a1..58d18e1b21 100644
--- a/osu.Game/Graphics/Containers/ScalingContainer.cs
+++ b/osu.Game/Graphics/Containers/ScalingContainer.cs
@@ -6,6 +6,8 @@ using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Primitives;
+using osu.Framework.Layout;
+using osu.Framework.Platform;
 using osu.Framework.Screens;
 using osu.Game.Configuration;
 using osu.Game.Screens;
@@ -66,7 +68,7 @@ namespace osu.Game.Graphics.Containers
             this.targetMode = targetMode;
             RelativeSizeAxes = Axes.Both;
 
-            InternalChild = sizableContainer = new AlwaysInputContainer
+            InternalChild = sizableContainer = new SizeableAlwaysInputContainer(targetMode == ScalingMode.Everything)
             {
                 RelativeSizeAxes = Axes.Both,
                 RelativePositionAxes = Axes.Both,
@@ -209,13 +211,50 @@ namespace osu.Game.Graphics.Containers
             }
         }
 
-        private class AlwaysInputContainer : Container
+        private class SizeableAlwaysInputContainer : Container
         {
+            [Resolved]
+            private GameHost host { get; set; }
+
+            [Resolved]
+            private ISafeArea safeArea { get; set; }
+
+            private readonly bool confineHostCursor;
+            private readonly LayoutValue cursorRectCache = new LayoutValue(Invalidation.RequiredParentSizeToFit);
+
             public override bool ReceivePositionalInputAt(Vector2 screenSpacePos) => true;
 
-            public AlwaysInputContainer()
+            /// <summary>
+            /// Container used for sizing/positioning purposes in <see cref="ScalingContainer"/>. Always receives mouse input.
+            /// </summary>
+            /// <param name="confineHostCursor">Whether to confine the host cursor to the draw area of this container.</param>
+            /// <remarks>Cursor confinement will abide by the <see cref="OsuSetting.ConfineMouseMode"/> setting.</remarks>
+            public SizeableAlwaysInputContainer(bool confineHostCursor)
             {
                 RelativeSizeAxes = Axes.Both;
+                this.confineHostCursor = confineHostCursor;
+
+                if (confineHostCursor)
+                    AddLayout(cursorRectCache);
+            }
+
+            protected override void Update()
+            {
+                base.Update();
+
+                if (confineHostCursor && !cursorRectCache.IsValid)
+                {
+                    updateHostCursorConfineRect();
+                    cursorRectCache.Validate();
+                }
+            }
+
+            private void updateHostCursorConfineRect()
+            {
+                if (host.Window == null) return;
+
+                bool coversWholeScreen = Size == Vector2.One && safeArea.SafeAreaPadding.Value.Total == Vector2.Zero;
+                host.Window.CursorConfineRect = coversWholeScreen ? (RectangleF?)null : ToScreenSpace(DrawRectangle).AABBFloat;
             }
         }
     }

From 9a1ade4f7907b695aeaa0d5ca19d18e63c4fa554 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 11 Mar 2022 23:08:40 +0900
Subject: [PATCH 3373/5547] Refactor `SkinEditor` to support switching target
 screens without full reload

---
 osu.Game/OsuGame.cs                           |  4 +--
 osu.Game/Skinning/Editor/SkinEditor.cs        | 29 ++++++++++-----
 osu.Game/Skinning/Editor/SkinEditorOverlay.cs | 35 +++++++++++++++----
 3 files changed, 52 insertions(+), 16 deletions(-)

diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index 7cd043083a..ae117d03d2 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -1142,8 +1142,6 @@ namespace osu.Game
 
         private void screenChanged(IScreen current, IScreen newScreen)
         {
-            skinEditor.Reset();
-
             switch (newScreen)
             {
                 case IntroScreen intro:
@@ -1185,6 +1183,8 @@ namespace osu.Game
                 else
                     BackButton.Hide();
             }
+
+            skinEditor.SetTarget((Screen)newScreen);
         }
 
         private void screenPushed(IScreen lastScreen, IScreen newScreen) => screenChanged(lastScreen, newScreen);
diff --git a/osu.Game/Skinning/Editor/SkinEditor.cs b/osu.Game/Skinning/Editor/SkinEditor.cs
index ae5cbc95f0..cd21507128 100644
--- a/osu.Game/Skinning/Editor/SkinEditor.cs
+++ b/osu.Game/Skinning/Editor/SkinEditor.cs
@@ -28,7 +28,7 @@ namespace osu.Game.Skinning.Editor
 
         protected override bool StartHidden => true;
 
-        private readonly Drawable targetScreen;
+        private Drawable targetScreen;
 
         private OsuTextFlowContainer headerText;
 
@@ -42,11 +42,13 @@ namespace osu.Game.Skinning.Editor
 
         private bool hasBegunMutating;
 
+        private Container blueprintContainerContainer;
+
         public SkinEditor(Drawable targetScreen)
         {
-            this.targetScreen = targetScreen;
-
             RelativeSizeAxes = Axes.Both;
+
+            UpdateTargetScreen(targetScreen);
         }
 
         [BackgroundDependencyLoader]
@@ -113,13 +115,9 @@ namespace osu.Game.Skinning.Editor
                                     Origin = Anchor.CentreLeft,
                                     RequestPlacement = placeComponent
                                 },
-                                new Container
+                                blueprintContainerContainer = new Container
                                 {
                                     RelativeSizeAxes = Axes.Both,
-                                    Children = new Drawable[]
-                                    {
-                                        new SkinBlueprintContainer(targetScreen),
-                                    }
                                 },
                             }
                         }
@@ -147,6 +145,21 @@ namespace osu.Game.Skinning.Editor
             }, true);
         }
 
+        public void UpdateTargetScreen(Drawable targetScreen)
+        {
+            this.targetScreen = targetScreen;
+
+            Scheduler.AddOnce(loadBlueprintContainer);
+
+            void loadBlueprintContainer()
+            {
+                blueprintContainerContainer.Children = new Drawable[]
+                {
+                    new SkinBlueprintContainer(targetScreen),
+                };
+            }
+        }
+
         private void skinChanged()
         {
             headerText.Clear();
diff --git a/osu.Game/Skinning/Editor/SkinEditorOverlay.cs b/osu.Game/Skinning/Editor/SkinEditorOverlay.cs
index 61c363b019..08dad2a146 100644
--- a/osu.Game/Skinning/Editor/SkinEditorOverlay.cs
+++ b/osu.Game/Skinning/Editor/SkinEditorOverlay.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.Diagnostics;
 using JetBrains.Annotations;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
@@ -8,6 +9,7 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Primitives;
 using osu.Framework.Input.Bindings;
 using osu.Framework.Input.Events;
+using osu.Framework.Screens;
 using osu.Game.Graphics.Containers;
 using osu.Game.Input.Bindings;
 
@@ -114,15 +116,36 @@ namespace osu.Game.Skinning.Editor
         }
 
         /// <summary>
-        /// Exit any existing skin editor due to the game state changing.
+        /// Set a new target screen which will be used to find skinnable components.
         /// </summary>
-        public void Reset()
+        public void SetTarget(Screen screen)
         {
-            skinEditor?.Save();
-            skinEditor?.Hide();
-            skinEditor?.Expire();
+            if (skinEditor == null) return;
 
-            skinEditor = null;
+            skinEditor.Save();
+
+            // AddOnce with paramter will ensure the newest target is loaded if there is any overlap.
+            Scheduler.AddOnce(setTarget, screen);
+        }
+
+        private void setTarget(Screen target)
+        {
+            Debug.Assert(skinEditor != null);
+
+            if (!target.IsLoaded)
+            {
+                Scheduler.AddOnce(setTarget, target);
+                return;
+            }
+
+            if (skinEditor.State.Value == Visibility.Visible)
+                skinEditor.UpdateTargetScreen(target);
+            else
+            {
+                skinEditor.Hide();
+                skinEditor.Expire();
+                skinEditor = null;
+            }
         }
     }
 }

From 3db42dd77254df799efa9334a2389efacf31e622 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 8 Mar 2022 20:00:32 +0900
Subject: [PATCH 3374/5547] Allow skin editor to target different target
 containers for placement purposes

---
 osu.Game/Skinning/Editor/SkinEditor.cs | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Skinning/Editor/SkinEditor.cs b/osu.Game/Skinning/Editor/SkinEditor.cs
index ae5cbc95f0..36b06f01d2 100644
--- a/osu.Game/Skinning/Editor/SkinEditor.cs
+++ b/osu.Game/Skinning/Editor/SkinEditor.cs
@@ -171,7 +171,12 @@ namespace osu.Game.Skinning.Editor
 
         private void placeComponent(Type type)
         {
-            var targetContainer = getTarget(SkinnableTarget.MainHUDComponents);
+            var target = availableTargets.FirstOrDefault()?.Target;
+
+            if (target == null)
+                return;
+
+            var targetContainer = getTarget(target.Value);
 
             if (targetContainer == null)
                 return;

From 5b70139b333bbe03fa6781423f3bec955a4fa6c1 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 11 Mar 2022 18:32:32 +0300
Subject: [PATCH 3375/5547] Avoid running message highlight processing more
 than once

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

diff --git a/osu.Game/Overlays/Chat/DrawableChannel.cs b/osu.Game/Overlays/Chat/DrawableChannel.cs
index 1d9f8c7ab7..52878199f0 100644
--- a/osu.Game/Overlays/Chat/DrawableChannel.cs
+++ b/osu.Game/Overlays/Chat/DrawableChannel.cs
@@ -96,7 +96,7 @@ namespace osu.Game.Overlays.Chat
         /// <remarks>
         /// <see cref="CompositeDrawable.ScheduleAfterChildren"/> is for ensuring the scroll flow has updated with any new chat lines.
         /// </remarks>
-        private void processMessageHighlighting() => ScheduleAfterChildren(() =>
+        private void processMessageHighlighting() => SchedulerAfterChildren.AddOnce(() =>
         {
             if (highlightedMessage.Value == null)
                 return;

From 53c57661c70a1da9836fd2eb4418ad58a0b45df9 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 11 Mar 2022 18:34:22 +0300
Subject: [PATCH 3376/5547] Move implementtaion detail to inline comment

---
 osu.Game/Overlays/Chat/DrawableChannel.cs | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/osu.Game/Overlays/Chat/DrawableChannel.cs b/osu.Game/Overlays/Chat/DrawableChannel.cs
index 52878199f0..632517aa31 100644
--- a/osu.Game/Overlays/Chat/DrawableChannel.cs
+++ b/osu.Game/Overlays/Chat/DrawableChannel.cs
@@ -93,9 +93,7 @@ namespace osu.Game.Overlays.Chat
         /// <summary>
         /// Processes any pending message in <see cref="highlightedMessage"/>.
         /// </summary>
-        /// <remarks>
-        /// <see cref="CompositeDrawable.ScheduleAfterChildren"/> is for ensuring the scroll flow has updated with any new chat lines.
-        /// </remarks>
+        // ScheduleAfterChildren is for ensuring the scroll flow has updated with any new chat lines.
         private void processMessageHighlighting() => SchedulerAfterChildren.AddOnce(() =>
         {
             if (highlightedMessage.Value == null)

From 0b74bde653c2e8be85b4467b8e3ed3db5fe4f5ed Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sun, 13 Mar 2022 08:21:52 +0300
Subject: [PATCH 3377/5547] Disable taiko playfield aspect ratio lock on
 "Classic" mod

---
 osu.Game.Rulesets.Taiko/Mods/TaikoModClassic.cs    |  1 +
 osu.Game.Rulesets.Taiko/UI/DrawableTaikoRuleset.cs |  7 ++++++-
 .../UI/TaikoPlayfieldAdjustmentContainer.cs        | 14 ++++++++++----
 3 files changed, 17 insertions(+), 5 deletions(-)

diff --git a/osu.Game.Rulesets.Taiko/Mods/TaikoModClassic.cs b/osu.Game.Rulesets.Taiko/Mods/TaikoModClassic.cs
index 6520517039..5a6f57bc36 100644
--- a/osu.Game.Rulesets.Taiko/Mods/TaikoModClassic.cs
+++ b/osu.Game.Rulesets.Taiko/Mods/TaikoModClassic.cs
@@ -15,6 +15,7 @@ namespace osu.Game.Rulesets.Taiko.Mods
         public void ApplyToDrawableRuleset(DrawableRuleset<TaikoHitObject> drawableRuleset)
         {
             drawableTaikoRuleset = (DrawableTaikoRuleset)drawableRuleset;
+            drawableTaikoRuleset.LockPlayfieldAspect.Value = false;
         }
 
         public void Update(Playfield playfield)
diff --git a/osu.Game.Rulesets.Taiko/UI/DrawableTaikoRuleset.cs b/osu.Game.Rulesets.Taiko/UI/DrawableTaikoRuleset.cs
index 824b95639b..2efc4176f5 100644
--- a/osu.Game.Rulesets.Taiko/UI/DrawableTaikoRuleset.cs
+++ b/osu.Game.Rulesets.Taiko/UI/DrawableTaikoRuleset.cs
@@ -29,6 +29,8 @@ namespace osu.Game.Rulesets.Taiko.UI
     {
         public new BindableDouble TimeRange => base.TimeRange;
 
+        public readonly BindableBool LockPlayfieldAspect = new BindableBool(true);
+
         protected override ScrollVisualisationMethod VisualisationMethod => ScrollVisualisationMethod.Overlapping;
 
         protected override bool UserScrollSpeedAdjustment => false;
@@ -70,7 +72,10 @@ namespace osu.Game.Rulesets.Taiko.UI
             return ControlPoints[result];
         }
 
-        public override PlayfieldAdjustmentContainer CreatePlayfieldAdjustmentContainer() => new TaikoPlayfieldAdjustmentContainer();
+        public override PlayfieldAdjustmentContainer CreatePlayfieldAdjustmentContainer() => new TaikoPlayfieldAdjustmentContainer
+        {
+            LockPlayfieldAspect = { BindTarget = LockPlayfieldAspect }
+        };
 
         protected override PassThroughInputManager CreateInputManager() => new TaikoInputManager(Ruleset.RulesetInfo);
 
diff --git a/osu.Game.Rulesets.Taiko/UI/TaikoPlayfieldAdjustmentContainer.cs b/osu.Game.Rulesets.Taiko/UI/TaikoPlayfieldAdjustmentContainer.cs
index 1041456020..9cf530e903 100644
--- a/osu.Game.Rulesets.Taiko/UI/TaikoPlayfieldAdjustmentContainer.cs
+++ b/osu.Game.Rulesets.Taiko/UI/TaikoPlayfieldAdjustmentContainer.cs
@@ -2,9 +2,9 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
+using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Game.Rulesets.UI;
-using osuTK;
 
 namespace osu.Game.Rulesets.Taiko.UI
 {
@@ -13,16 +13,22 @@ namespace osu.Game.Rulesets.Taiko.UI
         private const float default_relative_height = TaikoPlayfield.DEFAULT_HEIGHT / 768;
         private const float default_aspect = 16f / 9f;
 
+        public readonly IBindable<bool> LockPlayfieldAspect = new BindableBool(true);
+
         protected override void Update()
         {
             base.Update();
 
-            float aspectAdjust = Math.Clamp(Parent.ChildSize.X / Parent.ChildSize.Y, 0.4f, 4) / default_aspect;
-            Size = new Vector2(1, default_relative_height * aspectAdjust);
+            float height = default_relative_height;
+
+            if (LockPlayfieldAspect.Value)
+                height *= Math.Clamp(Parent.ChildSize.X / Parent.ChildSize.Y, 0.4f, 4) / default_aspect;
+
+            Height = height;
 
             // Position the taiko playfield exactly one playfield from the top of the screen.
             RelativePositionAxes = Axes.Y;
-            Y = Size.Y;
+            Y = height;
         }
     }
 }

From d1a9b88fe7756e6925b26511459840009b3180c5 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 13 Mar 2022 16:05:45 +0900
Subject: [PATCH 3378/5547] Fix typo in comment

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

diff --git a/osu.Game/Skinning/Editor/SkinEditorOverlay.cs b/osu.Game/Skinning/Editor/SkinEditorOverlay.cs
index 08dad2a146..abd8272633 100644
--- a/osu.Game/Skinning/Editor/SkinEditorOverlay.cs
+++ b/osu.Game/Skinning/Editor/SkinEditorOverlay.cs
@@ -124,7 +124,7 @@ namespace osu.Game.Skinning.Editor
 
             skinEditor.Save();
 
-            // AddOnce with paramter will ensure the newest target is loaded if there is any overlap.
+            // AddOnce with parameter will ensure the newest target is loaded if there is any overlap.
             Scheduler.AddOnce(setTarget, screen);
         }
 

From f95e753adbfb170317c68ba19155f16e1b3a10a1 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 13 Mar 2022 16:10:06 +0900
Subject: [PATCH 3379/5547] Rename double-container variable name

---
 osu.Game/Skinning/Editor/SkinEditor.cs | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Skinning/Editor/SkinEditor.cs b/osu.Game/Skinning/Editor/SkinEditor.cs
index cd21507128..829faab116 100644
--- a/osu.Game/Skinning/Editor/SkinEditor.cs
+++ b/osu.Game/Skinning/Editor/SkinEditor.cs
@@ -42,7 +42,7 @@ namespace osu.Game.Skinning.Editor
 
         private bool hasBegunMutating;
 
-        private Container blueprintContainerContainer;
+        private Container content;
 
         public SkinEditor(Drawable targetScreen)
         {
@@ -115,7 +115,7 @@ namespace osu.Game.Skinning.Editor
                                     Origin = Anchor.CentreLeft,
                                     RequestPlacement = placeComponent
                                 },
-                                blueprintContainerContainer = new Container
+                                content = new Container
                                 {
                                     RelativeSizeAxes = Axes.Both,
                                 },
@@ -153,7 +153,7 @@ namespace osu.Game.Skinning.Editor
 
             void loadBlueprintContainer()
             {
-                blueprintContainerContainer.Children = new Drawable[]
+                content.Children = new Drawable[]
                 {
                     new SkinBlueprintContainer(targetScreen),
                 };

From c99397f75abc9b431954f7b90176e1d44dd6e51e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 11 Mar 2022 23:27:27 +0900
Subject: [PATCH 3380/5547] Add the ability to add settings to skinnable
 elements

---
 osu.Game/Extensions/DrawableExtensions.cs  | 13 +++++++++++++
 osu.Game/Screens/Play/HUD/SkinnableInfo.cs | 14 ++++++++++++++
 osu.Game/Skinning/ISkinnableDrawable.cs    | 20 ++++++++++++++++++++
 3 files changed, 47 insertions(+)

diff --git a/osu.Game/Extensions/DrawableExtensions.cs b/osu.Game/Extensions/DrawableExtensions.cs
index 005804789e..d1aba2bfe3 100644
--- a/osu.Game/Extensions/DrawableExtensions.cs
+++ b/osu.Game/Extensions/DrawableExtensions.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 Humanizer;
+using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
+using osu.Game.Configuration;
 using osu.Game.Screens.Play.HUD;
 using osu.Game.Skinning;
 using osuTK;
@@ -59,8 +62,18 @@ namespace osu.Game.Extensions
             component.Origin = info.Origin;
 
             if (component is ISkinnableDrawable skinnable)
+            {
                 skinnable.UsesFixedAnchor = info.UsesFixedAnchor;
 
+                foreach (var (_, property) in component.GetSettingsSourceProperties())
+                {
+                    if (!info.Settings.TryGetValue(property.Name.Underscore(), out object settingValue))
+                        continue;
+
+                    skinnable.CopyAdjustedSetting((IBindable)property.GetValue(component), settingValue);
+                }
+            }
+
             if (component is Container container)
             {
                 foreach (var child in info.Children)
diff --git a/osu.Game/Screens/Play/HUD/SkinnableInfo.cs b/osu.Game/Screens/Play/HUD/SkinnableInfo.cs
index a2b84c79af..5a51e7f455 100644
--- a/osu.Game/Screens/Play/HUD/SkinnableInfo.cs
+++ b/osu.Game/Screens/Play/HUD/SkinnableInfo.cs
@@ -4,11 +4,15 @@
 using System;
 using System.Collections.Generic;
 using System.Linq;
+using Humanizer;
 using Newtonsoft.Json;
+using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
+using osu.Game.Configuration;
 using osu.Game.Extensions;
 using osu.Game.Skinning;
+using osu.Game.Utils;
 using osuTK;
 
 namespace osu.Game.Screens.Play.HUD
@@ -34,6 +38,8 @@ namespace osu.Game.Screens.Play.HUD
         /// <inheritdoc cref="ISkinnableDrawable.UsesFixedAnchor"/>
         public bool UsesFixedAnchor { get; set; }
 
+        public Dictionary<string, object> Settings { get; set; } = new Dictionary<string, object>();
+
         public List<SkinnableInfo> Children { get; } = new List<SkinnableInfo>();
 
         [JsonConstructor]
@@ -58,6 +64,14 @@ namespace osu.Game.Screens.Play.HUD
             if (component is ISkinnableDrawable skinnable)
                 UsesFixedAnchor = skinnable.UsesFixedAnchor;
 
+            foreach (var (_, property) in component.GetSettingsSourceProperties())
+            {
+                var bindable = (IBindable)property.GetValue(component);
+
+                if (!bindable.IsDefault)
+                    Settings.Add(property.Name.Underscore(), ModUtils.GetSettingUnderlyingValue(bindable));
+            }
+
             if (component is Container<Drawable> container)
             {
                 foreach (var child in container.OfType<ISkinnableDrawable>().OfType<Drawable>())
diff --git a/osu.Game/Skinning/ISkinnableDrawable.cs b/osu.Game/Skinning/ISkinnableDrawable.cs
index 60b40982e5..3fc6a2fdd8 100644
--- a/osu.Game/Skinning/ISkinnableDrawable.cs
+++ b/osu.Game/Skinning/ISkinnableDrawable.cs
@@ -1,6 +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;
+using osu.Framework.Bindables;
+using osu.Framework.Extensions.TypeExtensions;
 using osu.Framework.Graphics;
 
 namespace osu.Game.Skinning
@@ -21,5 +24,22 @@ namespace osu.Game.Skinning
         /// If <see langword="true"/>, a fixed anchor point has been defined.
         /// </summary>
         bool UsesFixedAnchor { get; set; }
+
+        void CopyAdjustedSetting(IBindable target, object source)
+        {
+            if (source is IBindable sourceBindable)
+            {
+                // copy including transfer of default values.
+                target.BindTo(sourceBindable);
+                target.UnbindFrom(sourceBindable);
+            }
+            else
+            {
+                if (!(target is IParseable parseable))
+                    throw new InvalidOperationException($"Bindable type {target.GetType().ReadableName()} is not {nameof(IParseable)}.");
+
+                parseable.Parse(source);
+            }
+        }
     }
 }

From 8d1ee28e6711eec49735625f8e148993aebbec4a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 11 Mar 2022 23:30:46 +0900
Subject: [PATCH 3381/5547] Add settings modification UI to skin editor

---
 .../Rulesets/Edit/ScrollingToolboxGroup.cs    |  4 ++-
 osu.Game/Skinning/Editor/SkinEditor.cs        | 28 ++++++++++++++++++-
 osu.Game/Skinning/Editor/SkinEditorOverlay.cs |  4 ++-
 .../Skinning/Editor/SkinSettingsToolbox.cs    | 23 +++++++++++++++
 4 files changed, 56 insertions(+), 3 deletions(-)
 create mode 100644 osu.Game/Skinning/Editor/SkinSettingsToolbox.cs

diff --git a/osu.Game/Rulesets/Edit/ScrollingToolboxGroup.cs b/osu.Game/Rulesets/Edit/ScrollingToolboxGroup.cs
index 9998a997b3..98e026c49a 100644
--- a/osu.Game/Rulesets/Edit/ScrollingToolboxGroup.cs
+++ b/osu.Game/Rulesets/Edit/ScrollingToolboxGroup.cs
@@ -11,6 +11,8 @@ namespace osu.Game.Rulesets.Edit
     {
         protected readonly OsuScrollContainer Scroll;
 
+        protected readonly FillFlowContainer FillFlow;
+
         protected override Container<Drawable> Content { get; }
 
         public ScrollingToolboxGroup(string title, float scrollAreaHeight)
@@ -20,7 +22,7 @@ namespace osu.Game.Rulesets.Edit
             {
                 RelativeSizeAxes = Axes.X,
                 Height = scrollAreaHeight,
-                Child = Content = new FillFlowContainer
+                Child = Content = FillFlow = new FillFlowContainer
                 {
                     RelativeSizeAxes = Axes.X,
                     AutoSizeAxes = Axes.Y,
diff --git a/osu.Game/Skinning/Editor/SkinEditor.cs b/osu.Game/Skinning/Editor/SkinEditor.cs
index 459fbf3be5..ef26682c03 100644
--- a/osu.Game/Skinning/Editor/SkinEditor.cs
+++ b/osu.Game/Skinning/Editor/SkinEditor.cs
@@ -3,6 +3,7 @@
 
 using System;
 using System.Collections.Generic;
+using System.Collections.Specialized;
 using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
@@ -11,10 +12,12 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.UserInterface;
 using osu.Framework.Input.Events;
 using osu.Framework.Testing;
+using osu.Game.Configuration;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Cursor;
 using osu.Game.Graphics.UserInterface;
+using osu.Game.Rulesets.Edit;
 using osu.Game.Screens.Edit.Components.Menus;
 
 namespace osu.Game.Skinning.Editor
@@ -44,6 +47,8 @@ namespace osu.Game.Skinning.Editor
 
         private Container content;
 
+        private EditorToolboxGroup settingsToolbox;
+
         public SkinEditor(Drawable targetScreen)
         {
             RelativeSizeAxes = Axes.Both;
@@ -103,7 +108,8 @@ namespace osu.Game.Skinning.Editor
                         ColumnDimensions = new[]
                         {
                             new Dimension(GridSizeMode.AutoSize),
-                            new Dimension()
+                            new Dimension(),
+                            new Dimension(GridSizeMode.AutoSize),
                         },
                         Content = new[]
                         {
@@ -119,6 +125,11 @@ namespace osu.Game.Skinning.Editor
                                 {
                                     RelativeSizeAxes = Axes.Both,
                                 },
+                                settingsToolbox = new SkinSettingsToolbox
+                                {
+                                    Anchor = Anchor.CentreRight,
+                                    Origin = Anchor.CentreRight,
+                                }
                             }
                         }
                     }
@@ -143,12 +154,15 @@ namespace osu.Game.Skinning.Editor
                 hasBegunMutating = false;
                 Scheduler.AddOnce(skinChanged);
             }, true);
+
+            SelectedComponents.BindCollectionChanged(selectionChanged);
         }
 
         public void UpdateTargetScreen(Drawable targetScreen)
         {
             this.targetScreen = targetScreen;
 
+            SelectedComponents.Clear();
             Scheduler.AddOnce(loadBlueprintContainer);
 
             void loadBlueprintContainer()
@@ -210,6 +224,18 @@ namespace osu.Game.Skinning.Editor
             SelectedComponents.Add(component);
         }
 
+        private void selectionChanged(object sender, NotifyCollectionChangedEventArgs e)
+        {
+            settingsToolbox.Clear();
+
+            var first = SelectedComponents.OfType<Drawable>().FirstOrDefault();
+
+            if (first != null)
+            {
+                settingsToolbox.Children = first.CreateSettingsControls().ToArray();
+            }
+        }
+
         private IEnumerable<ISkinnableTarget> availableTargets => targetScreen.ChildrenOfType<ISkinnableTarget>();
 
         private ISkinnableTarget getTarget(SkinnableTarget target)
diff --git a/osu.Game/Skinning/Editor/SkinEditorOverlay.cs b/osu.Game/Skinning/Editor/SkinEditorOverlay.cs
index abd8272633..08cdbf0aa9 100644
--- a/osu.Game/Skinning/Editor/SkinEditorOverlay.cs
+++ b/osu.Game/Skinning/Editor/SkinEditorOverlay.cs
@@ -101,9 +101,11 @@ namespace osu.Game.Skinning.Editor
 
         private void editorVisibilityChanged(ValueChangedEvent<Visibility> visibility)
         {
+            const float toolbar_padding_requirement = 0.18f;
+
             if (visibility.NewValue == Visibility.Visible)
             {
-                target.SetCustomRect(new RectangleF(0.18f, 0.1f, VISIBLE_TARGET_SCALE, VISIBLE_TARGET_SCALE), true);
+                target.SetCustomRect(new RectangleF(toolbar_padding_requirement, 0.1f, 0.8f - toolbar_padding_requirement, 0.7f), true);
             }
             else
             {
diff --git a/osu.Game/Skinning/Editor/SkinSettingsToolbox.cs b/osu.Game/Skinning/Editor/SkinSettingsToolbox.cs
new file mode 100644
index 0000000000..c0ef8e7316
--- /dev/null
+++ b/osu.Game/Skinning/Editor/SkinSettingsToolbox.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.Game.Rulesets.Edit;
+using osuTK;
+
+namespace osu.Game.Skinning.Editor
+{
+    internal class SkinSettingsToolbox : ScrollingToolboxGroup
+    {
+        public const float WIDTH = 200;
+
+        public SkinSettingsToolbox()
+            : base("Settings", 600)
+        {
+            RelativeSizeAxes = Axes.None;
+            Width = WIDTH;
+
+            FillFlow.Spacing = new Vector2(10);
+        }
+    }
+}

From 458136dfe779b7daa83bbaf9c76bb0f37d14cc58 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 8 Mar 2022 19:55:25 +0900
Subject: [PATCH 3382/5547] Add `BigBlackBox` for skinning testing purposes

---
 osu.Game/Skinning/Components/BigBlackBox.cs | 47 +++++++++++++++++++++
 1 file changed, 47 insertions(+)
 create mode 100644 osu.Game/Skinning/Components/BigBlackBox.cs

diff --git a/osu.Game/Skinning/Components/BigBlackBox.cs b/osu.Game/Skinning/Components/BigBlackBox.cs
new file mode 100644
index 0000000000..b86a863766
--- /dev/null
+++ b/osu.Game/Skinning/Components/BigBlackBox.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 JetBrains.Annotations;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.Shapes;
+using osu.Game.Graphics.Sprites;
+using osuTK;
+using osuTK.Graphics;
+
+namespace osu.Game.Skinning.Components
+{
+    /// <summary>
+    /// Intended to be a test bed for skinning. May be removed at some point in the future.
+    /// </summary>
+    [UsedImplicitly]
+    public class BigBlackBox : CompositeDrawable, ISkinnableDrawable
+    {
+        public bool UsesFixedAnchor { get; set; }
+
+        public BigBlackBox()
+        {
+            Size = new Vector2(150);
+
+            Masking = true;
+            CornerRadius = 20;
+            CornerExponent = 5;
+
+            InternalChildren = new Drawable[]
+            {
+                new Box
+                {
+                    Colour = Color4.Black,
+                    RelativeSizeAxes = Axes.Both,
+                },
+
+                new OsuSpriteText
+                {
+                    Text = "Big Black Box",
+                    Anchor = Anchor.Centre,
+                    Origin = Anchor.Centre,
+                }
+            };
+        }
+    }
+}

From e4211104b0fb93ff266cae340b2fc02e54be24be Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 8 Mar 2022 20:33:15 +0900
Subject: [PATCH 3383/5547] Add new settings to the big black box

---
 osu.Game/Skinning/Components/BigBlackBox.cs | 34 +++++++++++++++++++--
 1 file changed, 31 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Skinning/Components/BigBlackBox.cs b/osu.Game/Skinning/Components/BigBlackBox.cs
index b86a863766..fc6c652343 100644
--- a/osu.Game/Skinning/Components/BigBlackBox.cs
+++ b/osu.Game/Skinning/Components/BigBlackBox.cs
@@ -2,9 +2,11 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using JetBrains.Annotations;
+using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
+using osu.Game.Configuration;
 using osu.Game.Graphics.Sprites;
 using osuTK;
 using osuTK.Graphics;
@@ -19,6 +21,19 @@ namespace osu.Game.Skinning.Components
     {
         public bool UsesFixedAnchor { get; set; }
 
+        [SettingSource("Spin", "Should the text spin")]
+        public Bindable<bool> TextSpin { get; } = new BindableBool();
+
+        [SettingSource("Alpha", "The alpha value of this box")]
+        public BindableNumber<float> BoxAlpha { get; } = new BindableNumber<float>(1)
+        {
+            MinValue = 0,
+            MaxValue = 1,
+        };
+
+        private readonly Box box;
+        private readonly OsuSpriteText text;
+
         public BigBlackBox()
         {
             Size = new Vector2(150);
@@ -29,13 +44,12 @@ namespace osu.Game.Skinning.Components
 
             InternalChildren = new Drawable[]
             {
-                new Box
+                box = new Box
                 {
                     Colour = Color4.Black,
                     RelativeSizeAxes = Axes.Both,
                 },
-
-                new OsuSpriteText
+                text = new OsuSpriteText
                 {
                     Text = "Big Black Box",
                     Anchor = Anchor.Centre,
@@ -43,5 +57,19 @@ namespace osu.Game.Skinning.Components
                 }
             };
         }
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            BoxAlpha.BindValueChanged(alpha => box.Alpha = alpha.NewValue, true);
+            TextSpin.BindValueChanged(spin =>
+            {
+                if (spin.NewValue)
+                    text.Spin(1000, RotationDirection.Clockwise);
+                else
+                    text.ClearTransforms();
+            }, true);
+        }
     }
 }

From 7d2752185dfbf6261a240e35ca539afd1e902485 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 13 Mar 2022 16:47:08 +0900
Subject: [PATCH 3384/5547] Add disclaimer and adjust metrics of `BigBlackBox`

---
 osu.Game/Skinning/Components/BigBlackBox.cs | 21 +++++++++++++++++++--
 1 file changed, 19 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Skinning/Components/BigBlackBox.cs b/osu.Game/Skinning/Components/BigBlackBox.cs
index fc6c652343..8e57143a12 100644
--- a/osu.Game/Skinning/Components/BigBlackBox.cs
+++ b/osu.Game/Skinning/Components/BigBlackBox.cs
@@ -7,6 +7,8 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
 using osu.Game.Configuration;
+using osu.Game.Graphics;
+using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
 using osuTK;
 using osuTK.Graphics;
@@ -21,7 +23,7 @@ namespace osu.Game.Skinning.Components
     {
         public bool UsesFixedAnchor { get; set; }
 
-        [SettingSource("Spin", "Should the text spin")]
+        [SettingSource("Spining text", "Whether the big text should spin")]
         public Bindable<bool> TextSpin { get; } = new BindableBool();
 
         [SettingSource("Alpha", "The alpha value of this box")]
@@ -29,14 +31,16 @@ namespace osu.Game.Skinning.Components
         {
             MinValue = 0,
             MaxValue = 1,
+            Precision = 0.01f,
         };
 
         private readonly Box box;
         private readonly OsuSpriteText text;
+        private readonly OsuTextFlowContainer disclaimer;
 
         public BigBlackBox()
         {
-            Size = new Vector2(150);
+            Size = new Vector2(250);
 
             Masking = true;
             CornerRadius = 20;
@@ -54,6 +58,17 @@ namespace osu.Game.Skinning.Components
                     Text = "Big Black Box",
                     Anchor = Anchor.Centre,
                     Origin = Anchor.Centre,
+                    Font = OsuFont.Default.With(size: 40)
+                },
+                disclaimer = new OsuTextFlowContainer(st => st.Font = OsuFont.Default.With(size: 10))
+                {
+                    Text = "This is intended to be a test component and may disappear in the future!",
+                    RelativeSizeAxes = Axes.X,
+                    AutoSizeAxes = Axes.Y,
+                    Margin = new MarginPadding(10),
+                    Anchor = Anchor.BottomCentre,
+                    Origin = Anchor.BottomCentre,
+                    TextAnchor = Anchor.TopCentre,
                 }
             };
         }
@@ -70,6 +85,8 @@ namespace osu.Game.Skinning.Components
                 else
                     text.ClearTransforms();
             }, true);
+
+            disclaimer.FadeOutFromOne(5000, Easing.InQuint);
         }
     }
 }

From 4a8aa72d1ba96dcb60f545250800ef71437a4cf3 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Mon, 14 Mar 2022 01:03:08 +0300
Subject: [PATCH 3385/5547] Nudge osu!taiko playfield's height to perfectly
 match with osu!(stable)

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

diff --git a/osu.Game.Rulesets.Taiko/UI/TaikoPlayfield.cs b/osu.Game.Rulesets.Taiko/UI/TaikoPlayfield.cs
index d650cab729..504b10e9bc 100644
--- a/osu.Game.Rulesets.Taiko/UI/TaikoPlayfield.cs
+++ b/osu.Game.Rulesets.Taiko/UI/TaikoPlayfield.cs
@@ -29,7 +29,7 @@ namespace osu.Game.Rulesets.Taiko.UI
         /// <summary>
         /// Default height of a <see cref="TaikoPlayfield"/> when inside a <see cref="DrawableTaikoRuleset"/>.
         /// </summary>
-        public const float DEFAULT_HEIGHT = 212;
+        public const float DEFAULT_HEIGHT = 200;
 
         private Container<HitExplosion> hitExplosionContainer;
         private Container<KiaiHitExplosion> kiaiExplosionContainer;

From dbc26c3534e37108497ae64e040ba32101988fa6 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Mon, 14 Mar 2022 03:46:05 +0300
Subject: [PATCH 3386/5547] Add failing test assertion

---
 .../Gameplay/TestSceneDrawableStoryboardSprite.cs     | 11 ++++++++---
 1 file changed, 8 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneDrawableStoryboardSprite.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneDrawableStoryboardSprite.cs
index 52bedc328d..4011a6bc82 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneDrawableStoryboardSprite.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneDrawableStoryboardSprite.cs
@@ -1,11 +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 NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Testing;
+using osu.Framework.Utils;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Osu;
 using osu.Game.Skinning;
@@ -22,6 +24,8 @@ namespace osu.Game.Tests.Visual.Gameplay
         [Cached]
         private Storyboard storyboard { get; set; } = new Storyboard();
 
+        private IEnumerable<DrawableStoryboardSprite> sprites => this.ChildrenOfType<DrawableStoryboardSprite>();
+
         [Test]
         public void TestSkinSpriteDisallowedByDefault()
         {
@@ -41,9 +45,11 @@ namespace osu.Game.Tests.Visual.Gameplay
 
             AddStep("allow skin lookup", () => storyboard.UseSkinSprites = true);
 
-            AddStep("create sprites", () => SetContents(_ => createSprite(lookup_name, Anchor.Centre, Vector2.Zero)));
+            AddStep("create sprites", () => SetContents(_ => createSprite(lookup_name, Anchor.TopLeft, Vector2.Zero)));
 
             assertSpritesFromSkin(true);
+
+            AddAssert("skinnable sprite has correct size", () => sprites.Any(s => Precision.AlmostEquals(s.ChildrenOfType<SkinnableSprite>().Single().Size, new Vector2(128, 128))));
         }
 
         private DrawableStoryboardSprite createSprite(string lookupName, Anchor origin, Vector2 initialPosition)
@@ -57,7 +63,6 @@ namespace osu.Game.Tests.Visual.Gameplay
 
         private void assertSpritesFromSkin(bool fromSkin) =>
             AddAssert($"sprites are {(fromSkin ? "from skin" : "from storyboard")}",
-                () => this.ChildrenOfType<DrawableStoryboardSprite>()
-                          .All(sprite => sprite.ChildrenOfType<SkinnableSprite>().Any() == fromSkin));
+                () => sprites.All(sprite => sprite.ChildrenOfType<SkinnableSprite>().Any() == fromSkin));
     }
 }

From c9d54834be09429edc2a96a99ea579e15ac83870 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Mon, 14 Mar 2022 03:35:08 +0300
Subject: [PATCH 3387/5547] Fix `SkinnableSprite`s in storyboards not
 autosizing to their textures

---
 osu.Game/Storyboards/Storyboard.cs | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Storyboards/Storyboard.cs b/osu.Game/Storyboards/Storyboard.cs
index 2faed98ae0..b662b98e4e 100644
--- a/osu.Game/Storyboards/Storyboard.cs
+++ b/osu.Game/Storyboards/Storyboard.cs
@@ -104,7 +104,13 @@ namespace osu.Game.Storyboards
                 drawable = new Sprite { Texture = textureStore.Get(storyboardPath) };
             // if the texture isn't available locally in the beatmap, some storyboards choose to source from the underlying skin lookup hierarchy.
             else if (UseSkinSprites)
-                drawable = new SkinnableSprite(path);
+            {
+                drawable = new SkinnableSprite(path)
+                {
+                    RelativeSizeAxes = Axes.None,
+                    AutoSizeAxes = Axes.Both,
+                };
+            }
 
             return drawable;
         }

From 720e1cd206154fc40f8889ef813f1e31d01d1e0a Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Mon, 14 Mar 2022 03:35:23 +0300
Subject: [PATCH 3388/5547] Add failing test cases

---
 .../TestSceneDrawableStoryboardSprite.cs      | 44 +++++++++++++++++++
 1 file changed, 44 insertions(+)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneDrawableStoryboardSprite.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneDrawableStoryboardSprite.cs
index 4011a6bc82..34e6d1996d 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneDrawableStoryboardSprite.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneDrawableStoryboardSprite.cs
@@ -5,6 +5,7 @@ using System.Collections.Generic;
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
+using osu.Framework.Extensions.IEnumerableExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Testing;
 using osu.Framework.Utils;
@@ -52,6 +53,49 @@ namespace osu.Game.Tests.Visual.Gameplay
             AddAssert("skinnable sprite has correct size", () => sprites.Any(s => Precision.AlmostEquals(s.ChildrenOfType<SkinnableSprite>().Single().Size, new Vector2(128, 128))));
         }
 
+        [Test]
+        public void TestFlippedSprite()
+        {
+            const string lookup_name = "hitcircleoverlay";
+
+            AddStep("allow skin lookup", () => storyboard.UseSkinSprites = true);
+            AddStep("create sprites", () => SetContents(_ => createSprite(lookup_name, Anchor.TopLeft, Vector2.Zero)));
+            AddStep("flip sprites", () => sprites.ForEach(s =>
+            {
+                s.FlipH = true;
+                s.FlipV = true;
+            }));
+            AddAssert("origin flipped", () => sprites.All(s => s.Origin == Anchor.BottomRight));
+        }
+
+        [Test]
+        public void TestNegativeScale()
+        {
+            const string lookup_name = "hitcircleoverlay";
+
+            AddStep("allow skin lookup", () => storyboard.UseSkinSprites = true);
+            AddStep("create sprites", () => SetContents(_ => createSprite(lookup_name, Anchor.TopLeft, Vector2.Zero)));
+            AddStep("scale sprite", () => sprites.ForEach(s => s.VectorScale = new Vector2(-1)));
+            AddAssert("origin flipped", () => sprites.All(s => s.Origin == Anchor.BottomRight));
+        }
+
+        [Test]
+        public void TestNegativeScaleWithFlippedSprite()
+        {
+            const string lookup_name = "hitcircleoverlay";
+
+            AddStep("allow skin lookup", () => storyboard.UseSkinSprites = true);
+            AddStep("create sprites", () => SetContents(_ => createSprite(lookup_name, Anchor.TopLeft, Vector2.Zero)));
+            AddStep("scale sprite", () => sprites.ForEach(s => s.VectorScale = new Vector2(-1)));
+            AddAssert("origin flipped", () => sprites.All(s => s.Origin == Anchor.BottomRight));
+            AddStep("flip sprites", () => sprites.ForEach(s =>
+            {
+                s.FlipH = true;
+                s.FlipV = true;
+            }));
+            AddAssert("origin back", () => sprites.All(s => s.Origin == Anchor.TopLeft));
+        }
+
         private DrawableStoryboardSprite createSprite(string lookupName, Anchor origin, Vector2 initialPosition)
             => new DrawableStoryboardSprite(
                 new StoryboardSprite(lookupName, origin, initialPosition)

From 0b8c89bfa81c88019f629c8941d542f15d06fc6d Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Mon, 14 Mar 2022 03:50:12 +0300
Subject: [PATCH 3389/5547] Fix drawable storyboard sprites not flipping origin
 on negative scale

---
 osu.Game/Storyboards/Drawables/DrawableStoryboardSprite.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Storyboards/Drawables/DrawableStoryboardSprite.cs b/osu.Game/Storyboards/Drawables/DrawableStoryboardSprite.cs
index eb877f3dff..ad4402dcc4 100644
--- a/osu.Game/Storyboards/Drawables/DrawableStoryboardSprite.cs
+++ b/osu.Game/Storyboards/Drawables/DrawableStoryboardSprite.cs
@@ -79,7 +79,7 @@ namespace osu.Game.Storyboards.Drawables
             {
                 var origin = base.Origin;
 
-                if (FlipH)
+                if ((FlipH || VectorScale.X < 0) && !(FlipH && VectorScale.X < 0))
                 {
                     if (origin.HasFlagFast(Anchor.x0))
                         origin = Anchor.x2 | (origin & (Anchor.y0 | Anchor.y1 | Anchor.y2));
@@ -87,7 +87,7 @@ namespace osu.Game.Storyboards.Drawables
                         origin = Anchor.x0 | (origin & (Anchor.y0 | Anchor.y1 | Anchor.y2));
                 }
 
-                if (FlipV)
+                if ((FlipV || VectorScale.Y < 0) && !(FlipV && VectorScale.Y < 0))
                 {
                     if (origin.HasFlagFast(Anchor.y0))
                         origin = Anchor.y2 | (origin & (Anchor.x0 | Anchor.x1 | Anchor.x2));

From 9cf05080da2bb0125eaf3483326d1ab4fa0ab66c Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Mon, 14 Mar 2022 04:40:24 +0300
Subject: [PATCH 3390/5547] Simplify conditionals to one XOR operations with
 comments

---
 osu.Game/Storyboards/Drawables/DrawableStoryboardSprite.cs | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Storyboards/Drawables/DrawableStoryboardSprite.cs b/osu.Game/Storyboards/Drawables/DrawableStoryboardSprite.cs
index ad4402dcc4..f3173497e8 100644
--- a/osu.Game/Storyboards/Drawables/DrawableStoryboardSprite.cs
+++ b/osu.Game/Storyboards/Drawables/DrawableStoryboardSprite.cs
@@ -79,7 +79,8 @@ namespace osu.Game.Storyboards.Drawables
             {
                 var origin = base.Origin;
 
-                if ((FlipH || VectorScale.X < 0) && !(FlipH && VectorScale.X < 0))
+                // Either flip horizontally or negative X scale, but not both.
+                if (FlipH ^ (VectorScale.X < 0))
                 {
                     if (origin.HasFlagFast(Anchor.x0))
                         origin = Anchor.x2 | (origin & (Anchor.y0 | Anchor.y1 | Anchor.y2));
@@ -87,7 +88,8 @@ namespace osu.Game.Storyboards.Drawables
                         origin = Anchor.x0 | (origin & (Anchor.y0 | Anchor.y1 | Anchor.y2));
                 }
 
-                if ((FlipV || VectorScale.Y < 0) && !(FlipV && VectorScale.Y < 0))
+                // Either flip vertically or negative Y scale, but not both.
+                if (FlipV ^ (VectorScale.Y < 0))
                 {
                     if (origin.HasFlagFast(Anchor.y0))
                         origin = Anchor.y2 | (origin & (Anchor.x0 | Anchor.x1 | Anchor.x2));

From 740a72e16d07b380177c331096780043ded35da1 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Mon, 14 Mar 2022 05:44:34 +0300
Subject: [PATCH 3391/5547] Share origin adjustment logic between storyboard
 sprite and animation

---
 .../Drawables/DrawableStoryboardAnimation.cs  | 30 +------------
 osu.Game/Storyboards/StoryboardExtensions.cs  | 43 +++++++++++++++++++
 2 files changed, 45 insertions(+), 28 deletions(-)
 create mode 100644 osu.Game/Storyboards/StoryboardExtensions.cs

diff --git a/osu.Game/Storyboards/Drawables/DrawableStoryboardAnimation.cs b/osu.Game/Storyboards/Drawables/DrawableStoryboardAnimation.cs
index 81623a9307..28ac83a25c 100644
--- a/osu.Game/Storyboards/Drawables/DrawableStoryboardAnimation.cs
+++ b/osu.Game/Storyboards/Drawables/DrawableStoryboardAnimation.cs
@@ -3,7 +3,6 @@
 
 using System;
 using osu.Framework.Allocation;
-using osu.Framework.Extensions.EnumExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Animations;
 using osu.Framework.Graphics.Textures;
@@ -70,34 +69,9 @@ namespace osu.Game.Storyboards.Drawables
 
         public override bool RemoveWhenNotAlive => false;
 
-        protected override Vector2 DrawScale
-            => new Vector2(FlipH ? -base.DrawScale.X : base.DrawScale.X, FlipV ? -base.DrawScale.Y : base.DrawScale.Y) * VectorScale;
+        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
-        {
-            get
-            {
-                var origin = base.Origin;
-
-                if (FlipH)
-                {
-                    if (origin.HasFlagFast(Anchor.x0))
-                        origin = Anchor.x2 | (origin & (Anchor.y0 | Anchor.y1 | Anchor.y2));
-                    else if (origin.HasFlagFast(Anchor.x2))
-                        origin = Anchor.x0 | (origin & (Anchor.y0 | Anchor.y1 | Anchor.y2));
-                }
-
-                if (FlipV)
-                {
-                    if (origin.HasFlagFast(Anchor.y0))
-                        origin = Anchor.y2 | (origin & (Anchor.x0 | Anchor.x1 | Anchor.x2));
-                    else if (origin.HasFlagFast(Anchor.y2))
-                        origin = Anchor.y0 | (origin & (Anchor.x0 | Anchor.x1 | Anchor.x2));
-                }
-
-                return origin;
-            }
-        }
+        public override Anchor Origin => StoryboardExtensions.AdjustOrigin(base.Origin, VectorScale, FlipH, FlipV);
 
         public override bool IsPresent
             => !float.IsNaN(DrawPosition.X) && !float.IsNaN(DrawPosition.Y) && base.IsPresent;
diff --git a/osu.Game/Storyboards/StoryboardExtensions.cs b/osu.Game/Storyboards/StoryboardExtensions.cs
new file mode 100644
index 0000000000..4e8251c9e7
--- /dev/null
+++ b/osu.Game/Storyboards/StoryboardExtensions.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 osu.Framework.Extensions.EnumExtensions;
+using osu.Framework.Graphics;
+using osuTK;
+
+namespace osu.Game.Storyboards
+{
+    public static class StoryboardExtensions
+    {
+        /// <summary>
+        /// Given an origin and a set of properties, adjust the origin to display the sprite/animation correctly.
+        /// </summary>
+        /// <param name="origin">The current origin.</param>
+        /// <param name="vectorScale">The vector scale.</param>
+        /// <param name="flipH">Whether the element is flipped horizontally.</param>
+        /// <param name="flipV">Whether the element is flipped vertically.</param>
+        /// <returns>The adjusted origin.</returns>
+        public static Anchor AdjustOrigin(Anchor origin, Vector2 vectorScale, bool flipH, bool flipV)
+        {
+            // Either flip horizontally or negative X scale, but not both.
+            if (flipH ^ (vectorScale.X < 0))
+            {
+                if (origin.HasFlagFast(Anchor.x0))
+                    origin = Anchor.x2 | (origin & (Anchor.y0 | Anchor.y1 | Anchor.y2));
+                else if (origin.HasFlagFast(Anchor.x2))
+                    origin = Anchor.x0 | (origin & (Anchor.y0 | Anchor.y1 | Anchor.y2));
+            }
+
+            // Either flip vertically or negative Y scale, but not both.
+            if (flipV ^ (vectorScale.Y < 0))
+            {
+                if (origin.HasFlagFast(Anchor.y0))
+                    origin = Anchor.y2 | (origin & (Anchor.x0 | Anchor.x1 | Anchor.x2));
+                else if (origin.HasFlagFast(Anchor.y2))
+                    origin = Anchor.y0 | (origin & (Anchor.x0 | Anchor.x1 | Anchor.x2));
+            }
+
+            return origin;
+        }
+    }
+}

From c1697c7621358e02dccb710d79842696a983c669 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Mon, 14 Mar 2022 06:29:49 +0300
Subject: [PATCH 3392/5547] Update `DrawableStoryboardSprite` to use helper
 method

---
 .../Drawables/DrawableStoryboardAnimation.cs  |  3 +-
 .../Drawables/DrawableStoryboardSprite.cs     | 29 +------------------
 2 files changed, 3 insertions(+), 29 deletions(-)

diff --git a/osu.Game/Storyboards/Drawables/DrawableStoryboardAnimation.cs b/osu.Game/Storyboards/Drawables/DrawableStoryboardAnimation.cs
index 28ac83a25c..88cb5f40a1 100644
--- a/osu.Game/Storyboards/Drawables/DrawableStoryboardAnimation.cs
+++ b/osu.Game/Storyboards/Drawables/DrawableStoryboardAnimation.cs
@@ -69,7 +69,8 @@ namespace osu.Game.Storyboards.Drawables
 
         public override bool RemoveWhenNotAlive => false;
 
-        protected override Vector2 DrawScale => new Vector2(FlipH ? -base.DrawScale.X : base.DrawScale.X, FlipV ? -base.DrawScale.Y : base.DrawScale.Y) * VectorScale;
+        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);
 
diff --git a/osu.Game/Storyboards/Drawables/DrawableStoryboardSprite.cs b/osu.Game/Storyboards/Drawables/DrawableStoryboardSprite.cs
index f3173497e8..db10f13896 100644
--- a/osu.Game/Storyboards/Drawables/DrawableStoryboardSprite.cs
+++ b/osu.Game/Storyboards/Drawables/DrawableStoryboardSprite.cs
@@ -3,7 +3,6 @@
 
 using System;
 using osu.Framework.Allocation;
-using osu.Framework.Extensions.EnumExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Textures;
@@ -73,33 +72,7 @@ namespace osu.Game.Storyboards.Drawables
         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
-        {
-            get
-            {
-                var origin = base.Origin;
-
-                // Either flip horizontally or negative X scale, but not both.
-                if (FlipH ^ (VectorScale.X < 0))
-                {
-                    if (origin.HasFlagFast(Anchor.x0))
-                        origin = Anchor.x2 | (origin & (Anchor.y0 | Anchor.y1 | Anchor.y2));
-                    else if (origin.HasFlagFast(Anchor.x2))
-                        origin = Anchor.x0 | (origin & (Anchor.y0 | Anchor.y1 | Anchor.y2));
-                }
-
-                // Either flip vertically or negative Y scale, but not both.
-                if (FlipV ^ (VectorScale.Y < 0))
-                {
-                    if (origin.HasFlagFast(Anchor.y0))
-                        origin = Anchor.y2 | (origin & (Anchor.x0 | Anchor.x1 | Anchor.x2));
-                    else if (origin.HasFlagFast(Anchor.y2))
-                        origin = Anchor.y0 | (origin & (Anchor.x0 | Anchor.x1 | Anchor.x2));
-                }
-
-                return origin;
-            }
-        }
+        public override Anchor Origin => StoryboardExtensions.AdjustOrigin(base.Origin, VectorScale, FlipH, FlipV);
 
         public override bool IsPresent
             => !float.IsNaN(DrawPosition.X) && !float.IsNaN(DrawPosition.Y) && base.IsPresent;

From 4ae6cba080d707402399b295f4a41b9503545991 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Mon, 14 Mar 2022 13:49:38 +0900
Subject: [PATCH 3393/5547] Expose UseDevelopmentServer as virtual

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

diff --git a/osu.Game/OsuGameBase.cs b/osu.Game/OsuGameBase.cs
index 8b75de9718..602f84b0e1 100644
--- a/osu.Game/OsuGameBase.cs
+++ b/osu.Game/OsuGameBase.cs
@@ -69,7 +69,7 @@ namespace osu.Game
         /// </summary>
         private const double global_track_volume_adjust = 0.8;
 
-        public bool UseDevelopmentServer { get; }
+        public virtual bool UseDevelopmentServer { get; }
 
         public virtual Version AssemblyVersion => Assembly.GetEntryAssembly()?.GetName().Version ?? new Version();
 

From 21beb8774d5d3d95bbcd19e524e571e181512048 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Mon, 14 Mar 2022 13:54:54 +0900
Subject: [PATCH 3394/5547] Change to lambda method

---
 osu.Game/OsuGameBase.cs | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/osu.Game/OsuGameBase.cs b/osu.Game/OsuGameBase.cs
index 602f84b0e1..5468db348e 100644
--- a/osu.Game/OsuGameBase.cs
+++ b/osu.Game/OsuGameBase.cs
@@ -69,7 +69,7 @@ namespace osu.Game
         /// </summary>
         private const double global_track_volume_adjust = 0.8;
 
-        public virtual bool UseDevelopmentServer { get; }
+        public virtual bool UseDevelopmentServer => DebugUtils.IsDebugBuild;
 
         public virtual Version AssemblyVersion => Assembly.GetEntryAssembly()?.GetName().Version ?? new Version();
 
@@ -177,7 +177,6 @@ namespace osu.Game
 
         public OsuGameBase()
         {
-            UseDevelopmentServer = DebugUtils.IsDebugBuild;
             Name = @"osu!";
         }
 

From 4a3e3aba65a1cece80e164fefc7622f853637d8c Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Mon, 14 Mar 2022 14:25:26 +0900
Subject: [PATCH 3395/5547] Restructure PerformanceCalculator to not require
 ScoreInfo argument

---
 osu.Game.Rulesets.Catch/CatchRuleset.cs       |   3 +-
 .../Difficulty/CatchPerformanceCalculator.cs  |  36 +++--
 .../Difficulty/ManiaPerformanceCalculator.cs  |  49 +++----
 osu.Game.Rulesets.Mania/ManiaRuleset.cs       |   2 +-
 .../Difficulty/OsuPerformanceCalculator.cs    | 132 +++++++++---------
 osu.Game.Rulesets.Osu/OsuRuleset.cs           |   2 +-
 .../Difficulty/TaikoPerformanceCalculator.cs  |  44 +++---
 osu.Game.Rulesets.Taiko/TaikoRuleset.cs       |   2 +-
 .../Visual/Ranking/TestSceneResultsScreen.cs  |   2 +-
 .../PerformanceBreakdownCalculator.cs         |   2 +-
 .../Difficulty/PerformanceCalculator.cs       |  36 ++---
 osu.Game/Rulesets/Ruleset.cs                  |  18 +--
 osu.Game/Scoring/ScorePerformanceCache.cs     |   4 +-
 .../Play/HUD/PerformancePointsCounter.cs      |   4 +-
 14 files changed, 147 insertions(+), 189 deletions(-)

diff --git a/osu.Game.Rulesets.Catch/CatchRuleset.cs b/osu.Game.Rulesets.Catch/CatchRuleset.cs
index 70d11c42e5..3a7efb6263 100644
--- a/osu.Game.Rulesets.Catch/CatchRuleset.cs
+++ b/osu.Game.Rulesets.Catch/CatchRuleset.cs
@@ -19,7 +19,6 @@ using osu.Game.Rulesets.Catch.Difficulty;
 using osu.Game.Rulesets.Catch.Scoring;
 using osu.Game.Rulesets.Difficulty;
 using osu.Game.Rulesets.Scoring;
-using osu.Game.Scoring;
 using System;
 using osu.Framework.Extensions.EnumExtensions;
 using osu.Game.Rulesets.Catch.Edit;
@@ -182,7 +181,7 @@ namespace osu.Game.Rulesets.Catch
 
         public override ISkin CreateLegacySkinProvider(ISkin skin, IBeatmap beatmap) => new CatchLegacySkinTransformer(skin);
 
-        public override PerformanceCalculator CreatePerformanceCalculator(DifficultyAttributes attributes, ScoreInfo score) => new CatchPerformanceCalculator(this, attributes, score);
+        public override PerformanceCalculator CreatePerformanceCalculator() => new CatchPerformanceCalculator(this);
 
         public int LegacyID => 2;
 
diff --git a/osu.Game.Rulesets.Catch/Difficulty/CatchPerformanceCalculator.cs b/osu.Game.Rulesets.Catch/Difficulty/CatchPerformanceCalculator.cs
index 8cdbe500f0..6fefb2e5bb 100644
--- a/osu.Game.Rulesets.Catch/Difficulty/CatchPerformanceCalculator.cs
+++ b/osu.Game.Rulesets.Catch/Difficulty/CatchPerformanceCalculator.cs
@@ -13,33 +13,29 @@ namespace osu.Game.Rulesets.Catch.Difficulty
 {
     public class CatchPerformanceCalculator : PerformanceCalculator
     {
-        protected new CatchDifficultyAttributes Attributes => (CatchDifficultyAttributes)base.Attributes;
-
-        private Mod[] mods;
-
         private int fruitsHit;
         private int ticksHit;
         private int tinyTicksHit;
         private int tinyTicksMissed;
         private int misses;
 
-        public CatchPerformanceCalculator(Ruleset ruleset, DifficultyAttributes attributes, ScoreInfo score)
-            : base(ruleset, attributes, score)
+        public CatchPerformanceCalculator(Ruleset ruleset)
+            : base(ruleset)
         {
         }
 
-        public override PerformanceAttributes Calculate()
+        protected override PerformanceAttributes CreatePerformanceAttributes(ScoreInfo score, DifficultyAttributes attributes)
         {
-            mods = Score.Mods;
+            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);
+            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);
 
             // We are heavily relying on aim in catch the beat
-            double value = Math.Pow(5.0 * Math.Max(1.0, Attributes.StarRating / 0.0049) - 4.0, 2.0) / 100000.0;
+            double value = Math.Pow(5.0 * Math.Max(1.0, catchAttributes.StarRating / 0.0049) - 4.0, 2.0) / 100000.0;
 
             // Longer maps are worth more. "Longer" means how many hits there are which can contribute to combo
             int numTotalHits = totalComboHits();
@@ -52,10 +48,10 @@ namespace osu.Game.Rulesets.Catch.Difficulty
             value *= Math.Pow(0.97, misses);
 
             // Combo scaling
-            if (Attributes.MaxCombo > 0)
-                value *= Math.Min(Math.Pow(Score.MaxCombo, 0.8) / Math.Pow(Attributes.MaxCombo, 0.8), 1.0);
+            if (catchAttributes.MaxCombo > 0)
+                value *= Math.Min(Math.Pow(score.MaxCombo, 0.8) / Math.Pow(catchAttributes.MaxCombo, 0.8), 1.0);
 
-            double approachRate = Attributes.ApproachRate;
+            double approachRate = catchAttributes.ApproachRate;
             double approachRateFactor = 1.0;
             if (approachRate > 9.0)
                 approachRateFactor += 0.1 * (approachRate - 9.0); // 10% for each AR above 9
@@ -66,7 +62,7 @@ namespace osu.Game.Rulesets.Catch.Difficulty
 
             value *= approachRateFactor;
 
-            if (mods.Any(m => m is ModHidden))
+            if (score.Mods.Any(m => m is ModHidden))
             {
                 // Hiddens gives almost nothing on max approach rate, and more the lower it is
                 if (approachRate <= 10.0)
@@ -75,12 +71,12 @@ namespace osu.Game.Rulesets.Catch.Difficulty
                     value *= 1.01 + 0.04 * (11.0 - Math.Min(11.0, approachRate)); // 5% at AR 10, 1% at AR 11
             }
 
-            if (mods.Any(m => m is ModFlashlight))
+            if (score.Mods.Any(m => m is ModFlashlight))
                 value *= 1.35 * lengthBonus;
 
             value *= Math.Pow(accuracy(), 5.5);
 
-            if (mods.Any(m => m is ModNoFail))
+            if (score.Mods.Any(m => m is ModNoFail))
                 value *= 0.90;
 
             return new CatchPerformanceAttributes
diff --git a/osu.Game.Rulesets.Mania/Difficulty/ManiaPerformanceCalculator.cs b/osu.Game.Rulesets.Mania/Difficulty/ManiaPerformanceCalculator.cs
index 722cb55036..1eaf45e54a 100644
--- a/osu.Game.Rulesets.Mania/Difficulty/ManiaPerformanceCalculator.cs
+++ b/osu.Game.Rulesets.Mania/Difficulty/ManiaPerformanceCalculator.cs
@@ -13,10 +13,6 @@ namespace osu.Game.Rulesets.Mania.Difficulty
 {
     public class ManiaPerformanceCalculator : PerformanceCalculator
     {
-        protected new ManiaDifficultyAttributes Attributes => (ManiaDifficultyAttributes)base.Attributes;
-
-        private Mod[] mods;
-
         // Score after being scaled by non-difficulty-increasing mods
         private double scaledScore;
 
@@ -27,39 +23,40 @@ namespace osu.Game.Rulesets.Mania.Difficulty
         private int countMeh;
         private int countMiss;
 
-        public ManiaPerformanceCalculator(Ruleset ruleset, DifficultyAttributes attributes, ScoreInfo score)
-            : base(ruleset, attributes, score)
+        public ManiaPerformanceCalculator(Ruleset ruleset)
+            : base(ruleset)
         {
         }
 
-        public override PerformanceAttributes Calculate()
+        protected override PerformanceAttributes CreatePerformanceAttributes(ScoreInfo score, DifficultyAttributes attributes)
         {
-            mods = Score.Mods;
-            scaledScore = Score.TotalScore;
-            countPerfect = Score.Statistics.GetValueOrDefault(HitResult.Perfect);
-            countGreat = Score.Statistics.GetValueOrDefault(HitResult.Great);
-            countGood = Score.Statistics.GetValueOrDefault(HitResult.Good);
-            countOk = Score.Statistics.GetValueOrDefault(HitResult.Ok);
-            countMeh = Score.Statistics.GetValueOrDefault(HitResult.Meh);
-            countMiss = Score.Statistics.GetValueOrDefault(HitResult.Miss);
+            var maniaAttributes = (ManiaDifficultyAttributes)attributes;
 
-            if (Attributes.ScoreMultiplier > 0)
+            scaledScore = score.TotalScore;
+            countPerfect = score.Statistics.GetValueOrDefault(HitResult.Perfect);
+            countGreat = score.Statistics.GetValueOrDefault(HitResult.Great);
+            countGood = score.Statistics.GetValueOrDefault(HitResult.Good);
+            countOk = score.Statistics.GetValueOrDefault(HitResult.Ok);
+            countMeh = score.Statistics.GetValueOrDefault(HitResult.Meh);
+            countMiss = score.Statistics.GetValueOrDefault(HitResult.Miss);
+
+            if (maniaAttributes.ScoreMultiplier > 0)
             {
                 // Scale score up, so it's comparable to other keymods
-                scaledScore *= 1.0 / Attributes.ScoreMultiplier;
+                scaledScore *= 1.0 / maniaAttributes.ScoreMultiplier;
             }
 
             // Arbitrary initial value for scaling pp in order to standardize distributions across game modes.
             // The specific number has no intrinsic meaning and can be adjusted as needed.
             double multiplier = 0.8;
 
-            if (mods.Any(m => m is ModNoFail))
+            if (score.Mods.Any(m => m is ModNoFail))
                 multiplier *= 0.9;
-            if (mods.Any(m => m is ModEasy))
+            if (score.Mods.Any(m => m is ModEasy))
                 multiplier *= 0.5;
 
-            double difficultyValue = computeDifficultyValue();
-            double accValue = computeAccuracyValue(difficultyValue);
+            double difficultyValue = computeDifficultyValue(maniaAttributes);
+            double accValue = computeAccuracyValue(difficultyValue, maniaAttributes);
             double totalValue =
                 Math.Pow(
                     Math.Pow(difficultyValue, 1.1) +
@@ -75,9 +72,9 @@ namespace osu.Game.Rulesets.Mania.Difficulty
             };
         }
 
-        private double computeDifficultyValue()
+        private double computeDifficultyValue(ManiaDifficultyAttributes attributes)
         {
-            double difficultyValue = Math.Pow(5 * Math.Max(1, Attributes.StarRating / 0.2) - 4.0, 2.2) / 135.0;
+            double difficultyValue = Math.Pow(5 * Math.Max(1, attributes.StarRating / 0.2) - 4.0, 2.2) / 135.0;
 
             difficultyValue *= 1.0 + 0.1 * Math.Min(1.0, totalHits / 1500.0);
 
@@ -97,14 +94,14 @@ namespace osu.Game.Rulesets.Mania.Difficulty
             return difficultyValue;
         }
 
-        private double computeAccuracyValue(double difficultyValue)
+        private double computeAccuracyValue(double difficultyValue, ManiaDifficultyAttributes attributes)
         {
-            if (Attributes.GreatHitWindow <= 0)
+            if (attributes.GreatHitWindow <= 0)
                 return 0;
 
             // Lots of arbitrary values from testing.
             // Considering to use derivation from perfect accuracy in a probabilistic manner - assume normal distribution
-            double accuracyValue = Math.Max(0.0, 0.2 - (Attributes.GreatHitWindow - 34) * 0.006667)
+            double accuracyValue = Math.Max(0.0, 0.2 - (attributes.GreatHitWindow - 34) * 0.006667)
                                    * difficultyValue
                                    * Math.Pow(Math.Max(0.0, scaledScore - 960000) / 40000, 1.1);
 
diff --git a/osu.Game.Rulesets.Mania/ManiaRuleset.cs b/osu.Game.Rulesets.Mania/ManiaRuleset.cs
index f139a88f50..d04ef69dd2 100644
--- a/osu.Game.Rulesets.Mania/ManiaRuleset.cs
+++ b/osu.Game.Rulesets.Mania/ManiaRuleset.cs
@@ -53,7 +53,7 @@ namespace osu.Game.Rulesets.Mania
 
         public override IBeatmapConverter CreateBeatmapConverter(IBeatmap beatmap) => new ManiaBeatmapConverter(beatmap, this);
 
-        public override PerformanceCalculator CreatePerformanceCalculator(DifficultyAttributes attributes, ScoreInfo score) => new ManiaPerformanceCalculator(this, attributes, score);
+        public override PerformanceCalculator CreatePerformanceCalculator() => new ManiaPerformanceCalculator(this);
 
         public const string SHORT_NAME = "mania";
 
diff --git a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
index 604ab73454..5644b2009d 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
@@ -5,7 +5,6 @@ using System;
 using System.Collections.Generic;
 using System.Linq;
 using osu.Game.Rulesets.Difficulty;
-using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Osu.Mods;
 using osu.Game.Rulesets.Scoring;
 using osu.Game.Scoring;
@@ -14,10 +13,6 @@ namespace osu.Game.Rulesets.Osu.Difficulty
 {
     public class OsuPerformanceCalculator : PerformanceCalculator
     {
-        public new OsuDifficultyAttributes Attributes => (OsuDifficultyAttributes)base.Attributes;
-
-        private Mod[] mods;
-
         private double accuracy;
         private int scoreMaxCombo;
         private int countGreat;
@@ -27,31 +22,32 @@ namespace osu.Game.Rulesets.Osu.Difficulty
 
         private double effectiveMissCount;
 
-        public OsuPerformanceCalculator(Ruleset ruleset, DifficultyAttributes attributes, ScoreInfo score)
-            : base(ruleset, attributes, score)
+        public OsuPerformanceCalculator(Ruleset ruleset)
+            : base(ruleset)
         {
         }
 
-        public override PerformanceAttributes Calculate()
+        protected override PerformanceAttributes CreatePerformanceAttributes(ScoreInfo score, DifficultyAttributes attributes)
         {
-            mods = Score.Mods;
-            accuracy = Score.Accuracy;
-            scoreMaxCombo = Score.MaxCombo;
-            countGreat = Score.Statistics.GetValueOrDefault(HitResult.Great);
-            countOk = Score.Statistics.GetValueOrDefault(HitResult.Ok);
-            countMeh = Score.Statistics.GetValueOrDefault(HitResult.Meh);
-            countMiss = Score.Statistics.GetValueOrDefault(HitResult.Miss);
-            effectiveMissCount = calculateEffectiveMissCount();
+            var osuAttributes = (OsuDifficultyAttributes)attributes;
+
+            accuracy = score.Accuracy;
+            scoreMaxCombo = score.MaxCombo;
+            countGreat = score.Statistics.GetValueOrDefault(HitResult.Great);
+            countOk = score.Statistics.GetValueOrDefault(HitResult.Ok);
+            countMeh = score.Statistics.GetValueOrDefault(HitResult.Meh);
+            countMiss = score.Statistics.GetValueOrDefault(HitResult.Miss);
+            effectiveMissCount = calculateEffectiveMissCount(osuAttributes);
 
             double multiplier = 1.12; // This is being adjusted to keep the final pp value scaled around what it used to be when changing things.
 
-            if (mods.Any(m => m is OsuModNoFail))
+            if (score.Mods.Any(m => m is OsuModNoFail))
                 multiplier *= Math.Max(0.90, 1.0 - 0.02 * effectiveMissCount);
 
-            if (mods.Any(m => m is OsuModSpunOut) && totalHits > 0)
-                multiplier *= 1.0 - Math.Pow((double)Attributes.SpinnerCount / totalHits, 0.85);
+            if (score.Mods.Any(m => m is OsuModSpunOut) && totalHits > 0)
+                multiplier *= 1.0 - Math.Pow((double)osuAttributes.SpinnerCount / totalHits, 0.85);
 
-            if (mods.Any(h => h is OsuModRelax))
+            if (score.Mods.Any(h => h is OsuModRelax))
             {
                 // As we're adding Oks and Mehs to an approximated number of combo breaks the result can be higher than total hits in specific scenarios (which breaks some calculations) so we need to clamp it.
                 effectiveMissCount = Math.Min(effectiveMissCount + countOk + countMeh, totalHits);
@@ -59,10 +55,10 @@ namespace osu.Game.Rulesets.Osu.Difficulty
                 multiplier *= 0.6;
             }
 
-            double aimValue = computeAimValue();
-            double speedValue = computeSpeedValue();
-            double accuracyValue = computeAccuracyValue();
-            double flashlightValue = computeFlashlightValue();
+            double aimValue = computeAimValue(score, osuAttributes);
+            double speedValue = computeSpeedValue(score, osuAttributes);
+            double accuracyValue = computeAccuracyValue(score, osuAttributes);
+            double flashlightValue = computeFlashlightValue(score, osuAttributes);
             double totalValue =
                 Math.Pow(
                     Math.Pow(aimValue, 1.1) +
@@ -82,11 +78,11 @@ namespace osu.Game.Rulesets.Osu.Difficulty
             };
         }
 
-        private double computeAimValue()
+        private double computeAimValue(ScoreInfo score, OsuDifficultyAttributes attributes)
         {
-            double rawAim = Attributes.AimDifficulty;
+            double rawAim = attributes.AimDifficulty;
 
-            if (mods.Any(m => m is OsuModTouchDevice))
+            if (score.Mods.Any(m => m is OsuModTouchDevice))
                 rawAim = Math.Pow(rawAim, 0.8);
 
             double aimValue = Math.Pow(5.0 * Math.Max(1.0, rawAim / 0.0675) - 4.0, 3.0) / 100000.0;
@@ -99,44 +95,44 @@ namespace osu.Game.Rulesets.Osu.Difficulty
             if (effectiveMissCount > 0)
                 aimValue *= 0.97 * Math.Pow(1 - Math.Pow(effectiveMissCount / totalHits, 0.775), effectiveMissCount);
 
-            aimValue *= getComboScalingFactor();
+            aimValue *= getComboScalingFactor(attributes);
 
             double approachRateFactor = 0.0;
-            if (Attributes.ApproachRate > 10.33)
-                approachRateFactor = 0.3 * (Attributes.ApproachRate - 10.33);
-            else if (Attributes.ApproachRate < 8.0)
-                approachRateFactor = 0.1 * (8.0 - Attributes.ApproachRate);
+            if (attributes.ApproachRate > 10.33)
+                approachRateFactor = 0.3 * (attributes.ApproachRate - 10.33);
+            else if (attributes.ApproachRate < 8.0)
+                approachRateFactor = 0.1 * (8.0 - attributes.ApproachRate);
 
             aimValue *= 1.0 + approachRateFactor * lengthBonus; // Buff for longer maps with high AR.
 
-            if (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 (mods.Any(h => h is OsuModHidden))
+            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))
             {
                 // 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);
+                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;
+            double estimateDifficultSliders = attributes.SliderCount * 0.15;
 
-            if (Attributes.SliderCount > 0)
+            if (attributes.SliderCount > 0)
             {
-                double estimateSliderEndsDropped = Math.Clamp(Math.Min(countOk + countMeh + countMiss, Attributes.MaxCombo - scoreMaxCombo), 0, estimateDifficultSliders);
-                double sliderNerfFactor = (1 - Attributes.SliderFactor) * Math.Pow(1 - estimateSliderEndsDropped / estimateDifficultSliders, 3) + Attributes.SliderFactor;
+                double estimateSliderEndsDropped = Math.Clamp(Math.Min(countOk + countMeh + countMiss, attributes.MaxCombo - scoreMaxCombo), 0, estimateDifficultSliders);
+                double sliderNerfFactor = (1 - attributes.SliderFactor) * Math.Pow(1 - estimateSliderEndsDropped / estimateDifficultSliders, 3) + attributes.SliderFactor;
                 aimValue *= sliderNerfFactor;
             }
 
             aimValue *= accuracy;
             // It is important to consider accuracy difficulty when scaling with accuracy.
-            aimValue *= 0.98 + Math.Pow(Attributes.OverallDifficulty, 2) / 2500;
+            aimValue *= 0.98 + Math.Pow(attributes.OverallDifficulty, 2) / 2500;
 
             return aimValue;
         }
 
-        private double computeSpeedValue()
+        private double computeSpeedValue(ScoreInfo score, OsuDifficultyAttributes attributes)
         {
-            double speedValue = Math.Pow(5.0 * Math.Max(1.0, Attributes.SpeedDifficulty / 0.0675) - 4.0, 3.0) / 100000.0;
+            double speedValue = Math.Pow(5.0 * Math.Max(1.0, attributes.SpeedDifficulty / 0.0675) - 4.0, 3.0) / 100000.0;
 
             double lengthBonus = 0.95 + 0.4 * Math.Min(1.0, totalHits / 2000.0) +
                                  (totalHits > 2000 ? Math.Log10(totalHits / 2000.0) * 0.5 : 0.0);
@@ -146,27 +142,27 @@ namespace osu.Game.Rulesets.Osu.Difficulty
             if (effectiveMissCount > 0)
                 speedValue *= 0.97 * Math.Pow(1 - Math.Pow(effectiveMissCount / totalHits, 0.775), Math.Pow(effectiveMissCount, .875));
 
-            speedValue *= getComboScalingFactor();
+            speedValue *= getComboScalingFactor(attributes);
 
             double approachRateFactor = 0.0;
-            if (Attributes.ApproachRate > 10.33)
-                approachRateFactor = 0.3 * (Attributes.ApproachRate - 10.33);
+            if (attributes.ApproachRate > 10.33)
+                approachRateFactor = 0.3 * (attributes.ApproachRate - 10.33);
 
             speedValue *= 1.0 + approachRateFactor * lengthBonus; // Buff for longer maps with high AR.
 
-            if (mods.Any(m => m is OsuModBlinds))
+            if (score.Mods.Any(m => m is OsuModBlinds))
             {
                 // Increasing the speed value by object count for Blinds isn't ideal, so the minimum buff is given.
                 speedValue *= 1.12;
             }
-            else if (mods.Any(m => m is OsuModHidden))
+            else if (score.Mods.Any(m => m is OsuModHidden))
             {
                 // 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);
+                speedValue *= 1.0 + 0.04 * (12.0 - attributes.ApproachRate);
             }
 
             // Scale the speed value with accuracy and OD.
-            speedValue *= (0.95 + Math.Pow(Attributes.OverallDifficulty, 2) / 750) * Math.Pow(accuracy, (14.5 - Math.Max(Attributes.OverallDifficulty, 8)) / 2);
+            speedValue *= (0.95 + Math.Pow(attributes.OverallDifficulty, 2) / 750) * Math.Pow(accuracy, (14.5 - Math.Max(attributes.OverallDifficulty, 8)) / 2);
 
             // Scale the speed value with # of 50s to punish doubletapping.
             speedValue *= Math.Pow(0.98, countMeh < totalHits / 500.0 ? 0 : countMeh - totalHits / 500.0);
@@ -174,14 +170,14 @@ namespace osu.Game.Rulesets.Osu.Difficulty
             return speedValue;
         }
 
-        private double computeAccuracyValue()
+        private double computeAccuracyValue(ScoreInfo score, OsuDifficultyAttributes attributes)
         {
-            if (mods.Any(h => h is OsuModRelax))
+            if (score.Mods.Any(h => h is OsuModRelax))
                 return 0.0;
 
             // This percentage only considers HitCircles of any value - in this part of the calculation we focus on hitting the timing hit window.
             double betterAccuracyPercentage;
-            int amountHitObjectsWithAccuracy = Attributes.HitCircleCount;
+            int amountHitObjectsWithAccuracy = attributes.HitCircleCount;
 
             if (amountHitObjectsWithAccuracy > 0)
                 betterAccuracyPercentage = ((countGreat - (totalHits - amountHitObjectsWithAccuracy)) * 6 + countOk * 2 + countMeh) / (double)(amountHitObjectsWithAccuracy * 6);
@@ -194,43 +190,43 @@ namespace osu.Game.Rulesets.Osu.Difficulty
 
             // Lots of arbitrary values from testing.
             // Considering to use derivation from perfect accuracy in a probabilistic manner - assume normal distribution.
-            double accuracyValue = Math.Pow(1.52163, Attributes.OverallDifficulty) * Math.Pow(betterAccuracyPercentage, 24) * 2.83;
+            double accuracyValue = Math.Pow(1.52163, attributes.OverallDifficulty) * Math.Pow(betterAccuracyPercentage, 24) * 2.83;
 
             // Bonus for many hitcircles - it's harder to keep good accuracy up for longer.
             accuracyValue *= Math.Min(1.15, Math.Pow(amountHitObjectsWithAccuracy / 1000.0, 0.3));
 
             // Increasing the accuracy value by object count for Blinds isn't ideal, so the minimum buff is given.
-            if (mods.Any(m => m is OsuModBlinds))
+            if (score.Mods.Any(m => m is OsuModBlinds))
                 accuracyValue *= 1.14;
-            else if (mods.Any(m => m is OsuModHidden))
+            else if (score.Mods.Any(m => m is OsuModHidden))
                 accuracyValue *= 1.08;
 
-            if (mods.Any(m => m is OsuModFlashlight))
+            if (score.Mods.Any(m => m is OsuModFlashlight))
                 accuracyValue *= 1.02;
 
             return accuracyValue;
         }
 
-        private double computeFlashlightValue()
+        private double computeFlashlightValue(ScoreInfo score, OsuDifficultyAttributes attributes)
         {
-            if (!mods.Any(h => h is OsuModFlashlight))
+            if (!score.Mods.Any(h => h is OsuModFlashlight))
                 return 0.0;
 
-            double rawFlashlight = Attributes.FlashlightDifficulty;
+            double rawFlashlight = attributes.FlashlightDifficulty;
 
-            if (mods.Any(m => m is OsuModTouchDevice))
+            if (score.Mods.Any(m => m is OsuModTouchDevice))
                 rawFlashlight = Math.Pow(rawFlashlight, 0.8);
 
             double flashlightValue = Math.Pow(rawFlashlight, 2.0) * 25.0;
 
-            if (mods.Any(h => h is OsuModHidden))
+            if (score.Mods.Any(h => h is OsuModHidden))
                 flashlightValue *= 1.3;
 
             // Penalize misses by assessing # of misses relative to the total # of objects. Default a 3% reduction for any # of misses.
             if (effectiveMissCount > 0)
                 flashlightValue *= 0.97 * Math.Pow(1 - Math.Pow(effectiveMissCount / totalHits, 0.775), Math.Pow(effectiveMissCount, .875));
 
-            flashlightValue *= getComboScalingFactor();
+            flashlightValue *= getComboScalingFactor(attributes);
 
             // Account for shorter maps having a higher ratio of 0 combo/100 combo flashlight radius.
             flashlightValue *= 0.7 + 0.1 * Math.Min(1.0, totalHits / 200.0) +
@@ -239,19 +235,19 @@ namespace osu.Game.Rulesets.Osu.Difficulty
             // Scale the flashlight value with accuracy _slightly_.
             flashlightValue *= 0.5 + accuracy / 2.0;
             // It is important to also consider accuracy difficulty when doing that.
-            flashlightValue *= 0.98 + Math.Pow(Attributes.OverallDifficulty, 2) / 2500;
+            flashlightValue *= 0.98 + Math.Pow(attributes.OverallDifficulty, 2) / 2500;
 
             return flashlightValue;
         }
 
-        private double calculateEffectiveMissCount()
+        private double calculateEffectiveMissCount(OsuDifficultyAttributes attributes)
         {
             // Guess the number of misses + slider breaks from combo
             double comboBasedMissCount = 0.0;
 
-            if (Attributes.SliderCount > 0)
+            if (attributes.SliderCount > 0)
             {
-                double fullComboThreshold = Attributes.MaxCombo - 0.1 * Attributes.SliderCount;
+                double fullComboThreshold = attributes.MaxCombo - 0.1 * attributes.SliderCount;
                 if (scoreMaxCombo < fullComboThreshold)
                     comboBasedMissCount = fullComboThreshold / Math.Max(1.0, scoreMaxCombo);
             }
@@ -262,7 +258,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty
             return Math.Max(countMiss, comboBasedMissCount);
         }
 
-        private double getComboScalingFactor() => Attributes.MaxCombo <= 0 ? 1.0 : Math.Min(Math.Pow(scoreMaxCombo, 0.8) / Math.Pow(Attributes.MaxCombo, 0.8), 1.0);
+        private double getComboScalingFactor(OsuDifficultyAttributes attributes) => attributes.MaxCombo <= 0 ? 1.0 : Math.Min(Math.Pow(scoreMaxCombo, 0.8) / Math.Pow(attributes.MaxCombo, 0.8), 1.0);
         private int totalHits => countGreat + countOk + countMeh + countMiss;
         private int totalSuccessfulHits => countGreat + countOk + countMeh;
     }
diff --git a/osu.Game.Rulesets.Osu/OsuRuleset.cs b/osu.Game.Rulesets.Osu/OsuRuleset.cs
index 5b936b1bf1..92b90339f9 100644
--- a/osu.Game.Rulesets.Osu/OsuRuleset.cs
+++ b/osu.Game.Rulesets.Osu/OsuRuleset.cs
@@ -213,7 +213,7 @@ namespace osu.Game.Rulesets.Osu
 
         public override DifficultyCalculator CreateDifficultyCalculator(IWorkingBeatmap beatmap) => new OsuDifficultyCalculator(RulesetInfo, beatmap);
 
-        public override PerformanceCalculator CreatePerformanceCalculator(DifficultyAttributes attributes, ScoreInfo score) => new OsuPerformanceCalculator(this, attributes, score);
+        public override PerformanceCalculator CreatePerformanceCalculator() => new OsuPerformanceCalculator(this);
 
         public override HitObjectComposer CreateHitObjectComposer() => new OsuHitObjectComposer(this);
 
diff --git a/osu.Game.Rulesets.Taiko/Difficulty/TaikoPerformanceCalculator.cs b/osu.Game.Rulesets.Taiko/Difficulty/TaikoPerformanceCalculator.cs
index bcd55f8fae..9e73390fad 100644
--- a/osu.Game.Rulesets.Taiko/Difficulty/TaikoPerformanceCalculator.cs
+++ b/osu.Game.Rulesets.Taiko/Difficulty/TaikoPerformanceCalculator.cs
@@ -14,37 +14,35 @@ namespace osu.Game.Rulesets.Taiko.Difficulty
 {
     public class TaikoPerformanceCalculator : PerformanceCalculator
     {
-        protected new TaikoDifficultyAttributes Attributes => (TaikoDifficultyAttributes)base.Attributes;
-
-        private Mod[] mods;
         private int countGreat;
         private int countOk;
         private int countMeh;
         private int countMiss;
 
-        public TaikoPerformanceCalculator(Ruleset ruleset, DifficultyAttributes attributes, ScoreInfo score)
-            : base(ruleset, attributes, score)
+        public TaikoPerformanceCalculator(Ruleset ruleset)
+            : base(ruleset)
         {
         }
 
-        public override PerformanceAttributes Calculate()
+        protected override PerformanceAttributes CreatePerformanceAttributes(ScoreInfo score, DifficultyAttributes attributes)
         {
-            mods = Score.Mods;
-            countGreat = Score.Statistics.GetValueOrDefault(HitResult.Great);
-            countOk = Score.Statistics.GetValueOrDefault(HitResult.Ok);
-            countMeh = Score.Statistics.GetValueOrDefault(HitResult.Meh);
-            countMiss = Score.Statistics.GetValueOrDefault(HitResult.Miss);
+            var taikoAttributes = (TaikoDifficultyAttributes)attributes;
+
+            countGreat = score.Statistics.GetValueOrDefault(HitResult.Great);
+            countOk = score.Statistics.GetValueOrDefault(HitResult.Ok);
+            countMeh = score.Statistics.GetValueOrDefault(HitResult.Meh);
+            countMiss = score.Statistics.GetValueOrDefault(HitResult.Miss);
 
             double multiplier = 1.1; // This is being adjusted to keep the final pp value scaled around what it used to be when changing things
 
-            if (mods.Any(m => m is ModNoFail))
+            if (score.Mods.Any(m => m is ModNoFail))
                 multiplier *= 0.90;
 
-            if (mods.Any(m => m is ModHidden))
+            if (score.Mods.Any(m => m is ModHidden))
                 multiplier *= 1.10;
 
-            double difficultyValue = computeDifficultyValue();
-            double accuracyValue = computeAccuracyValue();
+            double difficultyValue = computeDifficultyValue(score, taikoAttributes);
+            double accuracyValue = computeAccuracyValue(score, taikoAttributes);
             double totalValue =
                 Math.Pow(
                     Math.Pow(difficultyValue, 1.1) +
@@ -59,30 +57,30 @@ namespace osu.Game.Rulesets.Taiko.Difficulty
             };
         }
 
-        private double computeDifficultyValue()
+        private double computeDifficultyValue(ScoreInfo score, TaikoDifficultyAttributes attributes)
         {
-            double difficultyValue = Math.Pow(5.0 * Math.Max(1.0, Attributes.StarRating / 0.0075) - 4.0, 2.0) / 100000.0;
+            double difficultyValue = Math.Pow(5.0 * Math.Max(1.0, attributes.StarRating / 0.0075) - 4.0, 2.0) / 100000.0;
 
             double lengthBonus = 1 + 0.1 * Math.Min(1.0, totalHits / 1500.0);
             difficultyValue *= lengthBonus;
 
             difficultyValue *= Math.Pow(0.985, countMiss);
 
-            if (mods.Any(m => m is ModHidden))
+            if (score.Mods.Any(m => m is ModHidden))
                 difficultyValue *= 1.025;
 
-            if (mods.Any(m => m is ModFlashlight<TaikoHitObject>))
+            if (score.Mods.Any(m => m is ModFlashlight<TaikoHitObject>))
                 difficultyValue *= 1.05 * lengthBonus;
 
-            return difficultyValue * Score.Accuracy;
+            return difficultyValue * score.Accuracy;
         }
 
-        private double computeAccuracyValue()
+        private double computeAccuracyValue(ScoreInfo score, TaikoDifficultyAttributes attributes)
         {
-            if (Attributes.GreatHitWindow <= 0)
+            if (attributes.GreatHitWindow <= 0)
                 return 0;
 
-            double accValue = Math.Pow(150.0 / Attributes.GreatHitWindow, 1.1) * Math.Pow(Score.Accuracy, 15) * 22.0;
+            double accValue = Math.Pow(150.0 / attributes.GreatHitWindow, 1.1) * Math.Pow(score.Accuracy, 15) * 22.0;
 
             // Bonus for many objects - it's harder to keep good accuracy up for longer
             return accValue * Math.Min(1.15, Math.Pow(totalHits / 1500.0, 0.3));
diff --git a/osu.Game.Rulesets.Taiko/TaikoRuleset.cs b/osu.Game.Rulesets.Taiko/TaikoRuleset.cs
index dc90845d92..8934b64ca5 100644
--- a/osu.Game.Rulesets.Taiko/TaikoRuleset.cs
+++ b/osu.Game.Rulesets.Taiko/TaikoRuleset.cs
@@ -171,7 +171,7 @@ namespace osu.Game.Rulesets.Taiko
 
         public override DifficultyCalculator CreateDifficultyCalculator(IWorkingBeatmap beatmap) => new TaikoDifficultyCalculator(RulesetInfo, beatmap);
 
-        public override PerformanceCalculator CreatePerformanceCalculator(DifficultyAttributes attributes, ScoreInfo score) => new TaikoPerformanceCalculator(this, attributes, score);
+        public override PerformanceCalculator CreatePerformanceCalculator() => new TaikoPerformanceCalculator(this);
 
         public int LegacyID => 1;
 
diff --git a/osu.Game.Tests/Visual/Ranking/TestSceneResultsScreen.cs b/osu.Game.Tests/Visual/Ranking/TestSceneResultsScreen.cs
index cc380df183..4eed2a25f5 100644
--- a/osu.Game.Tests/Visual/Ranking/TestSceneResultsScreen.cs
+++ b/osu.Game.Tests/Visual/Ranking/TestSceneResultsScreen.cs
@@ -390,7 +390,7 @@ namespace osu.Game.Tests.Visual.Ranking
 
         private class RulesetWithNoPerformanceCalculator : OsuRuleset
         {
-            public override PerformanceCalculator CreatePerformanceCalculator(DifficultyAttributes attributes, ScoreInfo score) => null;
+            public override PerformanceCalculator CreatePerformanceCalculator() => null;
         }
     }
 }
diff --git a/osu.Game/Rulesets/Difficulty/PerformanceBreakdownCalculator.cs b/osu.Game/Rulesets/Difficulty/PerformanceBreakdownCalculator.cs
index fc38ed0298..1e5dda253f 100644
--- a/osu.Game/Rulesets/Difficulty/PerformanceBreakdownCalculator.cs
+++ b/osu.Game/Rulesets/Difficulty/PerformanceBreakdownCalculator.cs
@@ -84,7 +84,7 @@ namespace osu.Game.Rulesets.Difficulty
                 ).ConfigureAwait(false);
 
                 // ScorePerformanceCache is not used to avoid caching multiple copies of essentially identical perfect performance attributes
-                return difficulty == null ? null : ruleset.CreatePerformanceCalculator(difficulty.Value.Attributes, perfectPlay)?.Calculate();
+                return difficulty == null ? null : ruleset.CreatePerformanceCalculator()?.Calculate(perfectPlay, difficulty.Value.Attributes);
             }, cancellationToken);
         }
 
diff --git a/osu.Game/Rulesets/Difficulty/PerformanceCalculator.cs b/osu.Game/Rulesets/Difficulty/PerformanceCalculator.cs
index 6358ec18b7..4c55249661 100644
--- a/osu.Game/Rulesets/Difficulty/PerformanceCalculator.cs
+++ b/osu.Game/Rulesets/Difficulty/PerformanceCalculator.cs
@@ -1,41 +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 System;
-using System.Linq;
-using osu.Framework.Audio.Track;
-using osu.Framework.Extensions.IEnumerableExtensions;
-using osu.Game.Rulesets.Mods;
+using osu.Game.Beatmaps;
 using osu.Game.Scoring;
 
 namespace osu.Game.Rulesets.Difficulty
 {
     public abstract class PerformanceCalculator
     {
-        protected readonly DifficultyAttributes Attributes;
-
         protected readonly Ruleset Ruleset;
-        protected readonly ScoreInfo Score;
 
-        protected double TimeRate { get; private set; } = 1;
-
-        protected PerformanceCalculator(Ruleset ruleset, DifficultyAttributes attributes, ScoreInfo score)
+        protected PerformanceCalculator(Ruleset ruleset)
         {
             Ruleset = ruleset;
-            Score = score;
-
-            Attributes = attributes ?? throw new ArgumentNullException(nameof(attributes));
-
-            ApplyMods(score.Mods);
         }
 
-        protected virtual void ApplyMods(Mod[] mods)
-        {
-            var track = new TrackVirtual(10000);
-            mods.OfType<IApplicableToTrack>().ForEach(m => m.ApplyToTrack(track));
-            TimeRate = track.Rate;
-        }
+        public PerformanceAttributes Calculate(ScoreInfo score, DifficultyAttributes attributes)
+            => CreatePerformanceAttributes(score, attributes);
 
-        public abstract PerformanceAttributes Calculate();
+        public PerformanceAttributes Calculate(ScoreInfo score, IWorkingBeatmap beatmap)
+            => Calculate(score, Ruleset.CreateDifficultyCalculator(beatmap).Calculate(score.Mods));
+
+        /// <summary>
+        /// Creates <see cref="PerformanceAttributes"/> to describe a score's performance.
+        /// </summary>
+        /// <param name="score">The score to create the attributes for.</param>
+        /// <param name="attributes">The difficulty attributes for the beatmap relating to the score.</param>
+        protected abstract PerformanceAttributes CreatePerformanceAttributes(ScoreInfo score, DifficultyAttributes attributes);
     }
 }
diff --git a/osu.Game/Rulesets/Ruleset.cs b/osu.Game/Rulesets/Ruleset.cs
index 616540b59c..d5926386e8 100644
--- a/osu.Game/Rulesets/Ruleset.cs
+++ b/osu.Game/Rulesets/Ruleset.cs
@@ -228,25 +228,9 @@ namespace osu.Game.Rulesets
         /// <summary>
         /// Optionally creates a <see cref="PerformanceCalculator"/> to generate performance data from the provided score.
         /// </summary>
-        /// <param name="attributes">Difficulty attributes for the beatmap related to the provided score.</param>
-        /// <param name="score">The score to be processed.</param>
         /// <returns>A performance calculator instance for the provided score.</returns>
         [CanBeNull]
-        public virtual PerformanceCalculator CreatePerformanceCalculator(DifficultyAttributes attributes, ScoreInfo score) => null;
-
-        /// <summary>
-        /// Optionally creates a <see cref="PerformanceCalculator"/> to generate performance data from the provided score.
-        /// </summary>
-        /// <param name="beatmap">The beatmap to use as a source for generating <see cref="DifficultyAttributes"/>.</param>
-        /// <param name="score">The score to be processed.</param>
-        /// <returns>A performance calculator instance for the provided score.</returns>
-        [CanBeNull]
-        public PerformanceCalculator CreatePerformanceCalculator(IWorkingBeatmap beatmap, ScoreInfo score)
-        {
-            var difficultyCalculator = CreateDifficultyCalculator(beatmap);
-            var difficultyAttributes = difficultyCalculator.Calculate(score.Mods);
-            return CreatePerformanceCalculator(difficultyAttributes, score);
-        }
+        public virtual PerformanceCalculator CreatePerformanceCalculator() => null;
 
         public virtual HitObjectComposer CreateHitObjectComposer() => null;
 
diff --git a/osu.Game/Scoring/ScorePerformanceCache.cs b/osu.Game/Scoring/ScorePerformanceCache.cs
index a428a66aae..e15d59e648 100644
--- a/osu.Game/Scoring/ScorePerformanceCache.cs
+++ b/osu.Game/Scoring/ScorePerformanceCache.cs
@@ -43,9 +43,7 @@ namespace osu.Game.Scoring
 
             token.ThrowIfCancellationRequested();
 
-            var calculator = score.Ruleset.CreateInstance().CreatePerformanceCalculator(attributes.Value.Attributes, score);
-
-            return calculator?.Calculate();
+            return score.Ruleset.CreateInstance().CreatePerformanceCalculator()?.Calculate(score, attributes.Value.Attributes);
         }
 
         public readonly struct PerformanceCacheLookup
diff --git a/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs b/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs
index 21a7698248..67a8aaabdc 100644
--- a/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs
+++ b/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs
@@ -130,9 +130,9 @@ namespace osu.Game.Screens.Play.HUD
             var scoreInfo = gameplayState.Score.ScoreInfo.DeepClone();
             scoreInfo.Mods = clonedMods;
 
-            var calculator = gameplayState.Ruleset.CreatePerformanceCalculator(attrib, scoreInfo);
+            var calculator = gameplayState.Ruleset.CreatePerformanceCalculator();
 
-            Current.Value = (int)Math.Round(calculator?.Calculate().Total ?? 0, MidpointRounding.AwayFromZero);
+            Current.Value = (int)Math.Round(calculator?.Calculate(scoreInfo, attrib).Total ?? 0, MidpointRounding.AwayFromZero);
             IsValid = true;
         }
 

From 926827207abc22efc5819b168a6ed94ea91562d8 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Mon, 14 Mar 2022 14:44:04 +0900
Subject: [PATCH 3396/5547] Reduce calculator allocations in counter

---
 osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs b/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs
index 67a8aaabdc..a9b5544921 100644
--- a/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs
+++ b/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs
@@ -55,6 +55,7 @@ namespace osu.Game.Screens.Play.HUD
         private readonly CancellationTokenSource loadCancellationSource = new CancellationTokenSource();
 
         private JudgementResult lastJudgement;
+        private PerformanceCalculator performanceCalculator;
 
         public PerformancePointsCounter()
         {
@@ -70,6 +71,8 @@ namespace osu.Game.Screens.Play.HUD
 
             if (gameplayState != null)
             {
+                performanceCalculator = gameplayState.Ruleset.CreatePerformanceCalculator();
+
                 clonedMods = gameplayState.Mods.Select(m => m.DeepClone()).ToArray();
 
                 var gameplayWorkingBeatmap = new GameplayWorkingBeatmap(gameplayState.Beatmap);
@@ -130,9 +133,7 @@ namespace osu.Game.Screens.Play.HUD
             var scoreInfo = gameplayState.Score.ScoreInfo.DeepClone();
             scoreInfo.Mods = clonedMods;
 
-            var calculator = gameplayState.Ruleset.CreatePerformanceCalculator();
-
-            Current.Value = (int)Math.Round(calculator?.Calculate(scoreInfo, attrib).Total ?? 0, MidpointRounding.AwayFromZero);
+            Current.Value = (int)Math.Round(performanceCalculator?.Calculate(scoreInfo, attrib).Total ?? 0, MidpointRounding.AwayFromZero);
             IsValid = true;
         }
 

From 9cc7f70872a00d15c91836114fda6b72781eb652 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Mon, 14 Mar 2022 15:38:00 +0900
Subject: [PATCH 3397/5547] Nullable annotate classes

---
 osu.Game/Rulesets/Scoring/HealthProcessor.cs    |  6 ++++--
 osu.Game/Rulesets/Scoring/JudgementProcessor.cs | 10 ++++++----
 osu.Game/Rulesets/Scoring/ScoreProcessor.cs     |  6 ++++--
 3 files changed, 14 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Rulesets/Scoring/HealthProcessor.cs b/osu.Game/Rulesets/Scoring/HealthProcessor.cs
index 1535fe4d00..a92c30e593 100644
--- a/osu.Game/Rulesets/Scoring/HealthProcessor.cs
+++ b/osu.Game/Rulesets/Scoring/HealthProcessor.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.
 
+#nullable enable
+
 using System;
 using osu.Framework.Bindables;
 using osu.Framework.Utils;
@@ -14,12 +16,12 @@ namespace osu.Game.Rulesets.Scoring
         /// Invoked when the <see cref="ScoreProcessor"/> is in a failed state.
         /// Return true if the fail was permitted.
         /// </summary>
-        public event Func<bool> Failed;
+        public event Func<bool>? Failed;
 
         /// <summary>
         /// Additional conditions on top of <see cref="DefaultFailCondition"/> that cause a failing state.
         /// </summary>
-        public event Func<HealthProcessor, JudgementResult, bool> FailConditions;
+        public event Func<HealthProcessor, JudgementResult, bool>? FailConditions;
 
         /// <summary>
         /// The current health.
diff --git a/osu.Game/Rulesets/Scoring/JudgementProcessor.cs b/osu.Game/Rulesets/Scoring/JudgementProcessor.cs
index a643c31daa..3017841c9d 100644
--- a/osu.Game/Rulesets/Scoring/JudgementProcessor.cs
+++ b/osu.Game/Rulesets/Scoring/JudgementProcessor.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.
 
+#nullable enable
+
 using System;
 using osu.Framework.Bindables;
 using osu.Framework.Extensions.TypeExtensions;
@@ -17,12 +19,12 @@ namespace osu.Game.Rulesets.Scoring
         /// <summary>
         /// Invoked when a new judgement has occurred. This occurs after the judgement has been processed by this <see cref="JudgementProcessor"/>.
         /// </summary>
-        public event Action<JudgementResult> NewJudgement;
+        public event Action<JudgementResult>? NewJudgement;
 
         /// <summary>
         /// Invoked when a judgement is reverted, usually due to rewinding gameplay.
         /// </summary>
-        public event Action<JudgementResult> JudgementReverted;
+        public event Action<JudgementResult>? JudgementReverted;
 
         /// <summary>
         /// The maximum number of hits that can be judged.
@@ -34,7 +36,7 @@ namespace osu.Game.Rulesets.Scoring
         /// </summary>
         public int JudgedHits { get; private set; }
 
-        private JudgementResult lastAppliedResult;
+        private JudgementResult? lastAppliedResult;
 
         private readonly BindableBool hasCompleted = new BindableBool();
 
@@ -163,7 +165,7 @@ namespace osu.Game.Rulesets.Scoring
         protected override void Update()
         {
             base.Update();
-            hasCompleted.Value = JudgedHits == MaxHits && (JudgedHits == 0 || lastAppliedResult.TimeAbsolute < Clock.CurrentTime);
+            hasCompleted.Value = JudgedHits == MaxHits && (JudgedHits == 0 || lastAppliedResult?.TimeAbsolute < Clock.CurrentTime);
         }
 
         /// <summary>
diff --git a/osu.Game/Rulesets/Scoring/ScoreProcessor.cs b/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
index db53e3130c..a7fe8b354b 100644
--- a/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
+++ b/osu.Game/Rulesets/Scoring/ScoreProcessor.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.
 
+#nullable enable
+
 using System;
 using System.Collections.Generic;
 using System.Diagnostics;
@@ -24,7 +26,7 @@ namespace osu.Game.Rulesets.Scoring
         /// <summary>
         /// Invoked when this <see cref="ScoreProcessor"/> was reset from a replay frame.
         /// </summary>
-        public event Action OnResetFromReplayFrame;
+        public event Action? OnResetFromReplayFrame;
 
         /// <summary>
         /// The current total score.
@@ -110,7 +112,7 @@ namespace osu.Game.Rulesets.Scoring
 
         private readonly Dictionary<HitResult, int> scoreResultCounts = new Dictionary<HitResult, int>();
         private readonly List<HitEvent> hitEvents = new List<HitEvent>();
-        private HitObject lastHitObject;
+        private HitObject? lastHitObject;
 
         private double scoreMultiplier = 1;
 

From 3fff7f4b7e9a5921be5928752840e59531090de4 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Mon, 14 Mar 2022 15:51:10 +0900
Subject: [PATCH 3398/5547] Require ScoreProcessor to receive ruleset

---
 .../Scoring/PippidonScoreProcessor.cs          | 11 -----------
 .../TestSceneComboCounter.cs                   |  2 +-
 osu.Game.Rulesets.Catch/CatchRuleset.cs        |  2 +-
 .../Scoring/CatchScoreProcessor.cs             |  5 +++++
 osu.Game.Rulesets.Mania/ManiaRuleset.cs        |  2 +-
 .../Scoring/ManiaScoreProcessor.cs             |  5 +++++
 osu.Game.Rulesets.Osu/OsuRuleset.cs            |  2 +-
 .../Scoring/OsuScoreProcessor.cs               |  5 +++++
 .../Skinning/TestSceneDrawableTaikoMascot.cs   |  2 +-
 .../Scoring/TaikoScoreProcessor.cs             |  5 +++++
 osu.Game.Rulesets.Taiko/TaikoRuleset.cs        |  2 +-
 .../Gameplay/TestSceneScoreProcessor.cs        |  6 +++---
 .../Rulesets/Scoring/ScoreProcessorTest.cs     |  3 ++-
 .../Gameplay/TestSceneBeatmapSkinFallbacks.cs  |  2 +-
 .../Visual/Gameplay/TestSceneHUDOverlay.cs     |  3 ++-
 .../Visual/Gameplay/TestSceneHitErrorMeter.cs  |  5 +++++
 .../TestScenePerformancePointsCounter.cs       |  2 +-
 .../TestSceneSkinEditorMultipleSkins.cs        |  2 +-
 .../TestSceneSkinnableAccuracyCounter.cs       |  3 ++-
 .../Gameplay/TestSceneSkinnableComboCounter.cs |  3 ++-
 .../Gameplay/TestSceneSkinnableHUDOverlay.cs   |  2 +-
 .../Gameplay/TestSceneSkinnableScoreCounter.cs |  3 ++-
 .../Gameplay/TestSceneUnstableRateCounter.cs   |  6 ++++++
 .../TestSceneMultiSpectatorLeaderboard.cs      |  2 +-
 .../TestSceneMultiplayerGameplayLeaderboard.cs |  2 +-
 ...SceneMultiplayerGameplayLeaderboardTeams.cs |  2 +-
 osu.Game/Rulesets/Ruleset.cs                   |  2 +-
 osu.Game/Rulesets/Scoring/ScoreProcessor.cs    | 11 +++++++----
 .../Play/HUD/PerformancePointsCounter.cs       | 12 ++++++------
 .../Skinning/Editor/SkinComponentToolbox.cs    | 18 +++++++++++++++++-
 30 files changed, 88 insertions(+), 44 deletions(-)
 delete mode 100644 Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon/Scoring/PippidonScoreProcessor.cs

diff --git a/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon/Scoring/PippidonScoreProcessor.cs b/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon/Scoring/PippidonScoreProcessor.cs
deleted file mode 100644
index 1c4fe698c2..0000000000
--- a/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon/Scoring/PippidonScoreProcessor.cs
+++ /dev/null
@@ -1,11 +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.Scoring;
-
-namespace osu.Game.Rulesets.Pippidon.Scoring
-{
-    public class PippidonScoreProcessor : ScoreProcessor
-    {
-    }
-}
diff --git a/osu.Game.Rulesets.Catch.Tests/TestSceneComboCounter.cs b/osu.Game.Rulesets.Catch.Tests/TestSceneComboCounter.cs
index 064a84cb98..b720ab1e97 100644
--- a/osu.Game.Rulesets.Catch.Tests/TestSceneComboCounter.cs
+++ b/osu.Game.Rulesets.Catch.Tests/TestSceneComboCounter.cs
@@ -24,7 +24,7 @@ namespace osu.Game.Rulesets.Catch.Tests
         [SetUp]
         public void SetUp() => Schedule(() =>
         {
-            scoreProcessor = new ScoreProcessor();
+            scoreProcessor = new ScoreProcessor(new CatchRuleset());
 
             SetContents(_ => new CatchComboDisplay
             {
diff --git a/osu.Game.Rulesets.Catch/CatchRuleset.cs b/osu.Game.Rulesets.Catch/CatchRuleset.cs
index 3a7efb6263..45198fa0ca 100644
--- a/osu.Game.Rulesets.Catch/CatchRuleset.cs
+++ b/osu.Game.Rulesets.Catch/CatchRuleset.cs
@@ -32,7 +32,7 @@ namespace osu.Game.Rulesets.Catch
     {
         public override DrawableRuleset CreateDrawableRulesetWith(IBeatmap beatmap, IReadOnlyList<Mod> mods = null) => new DrawableCatchRuleset(this, beatmap, mods);
 
-        public override ScoreProcessor CreateScoreProcessor() => new CatchScoreProcessor();
+        public override ScoreProcessor CreateScoreProcessor() => new CatchScoreProcessor(this);
 
         public override IBeatmapConverter CreateBeatmapConverter(IBeatmap beatmap) => new CatchBeatmapConverter(beatmap, this);
 
diff --git a/osu.Game.Rulesets.Catch/Scoring/CatchScoreProcessor.cs b/osu.Game.Rulesets.Catch/Scoring/CatchScoreProcessor.cs
index 9cd03dc869..2c183f5d94 100644
--- a/osu.Game.Rulesets.Catch/Scoring/CatchScoreProcessor.cs
+++ b/osu.Game.Rulesets.Catch/Scoring/CatchScoreProcessor.cs
@@ -7,6 +7,11 @@ namespace osu.Game.Rulesets.Catch.Scoring
 {
     public class CatchScoreProcessor : ScoreProcessor
     {
+        public CatchScoreProcessor(Ruleset ruleset)
+            : base(ruleset)
+        {
+        }
+
         protected override double ClassicScoreMultiplier => 28;
     }
 }
diff --git a/osu.Game.Rulesets.Mania/ManiaRuleset.cs b/osu.Game.Rulesets.Mania/ManiaRuleset.cs
index d04ef69dd2..92c77f405b 100644
--- a/osu.Game.Rulesets.Mania/ManiaRuleset.cs
+++ b/osu.Game.Rulesets.Mania/ManiaRuleset.cs
@@ -47,7 +47,7 @@ namespace osu.Game.Rulesets.Mania
 
         public override DrawableRuleset CreateDrawableRulesetWith(IBeatmap beatmap, IReadOnlyList<Mod> mods = null) => new DrawableManiaRuleset(this, beatmap, mods);
 
-        public override ScoreProcessor CreateScoreProcessor() => new ManiaScoreProcessor();
+        public override ScoreProcessor CreateScoreProcessor() => new ManiaScoreProcessor(this);
 
         public override HealthProcessor CreateHealthProcessor(double drainStartTime) => new ManiaHealthProcessor(drainStartTime, 0.5);
 
diff --git a/osu.Game.Rulesets.Mania/Scoring/ManiaScoreProcessor.cs b/osu.Game.Rulesets.Mania/Scoring/ManiaScoreProcessor.cs
index e0b19d87e8..0ffee809fc 100644
--- a/osu.Game.Rulesets.Mania/Scoring/ManiaScoreProcessor.cs
+++ b/osu.Game.Rulesets.Mania/Scoring/ManiaScoreProcessor.cs
@@ -7,6 +7,11 @@ namespace osu.Game.Rulesets.Mania.Scoring
 {
     internal class ManiaScoreProcessor : ScoreProcessor
     {
+        public ManiaScoreProcessor(Ruleset ruleset)
+            : base(ruleset)
+        {
+        }
+
         protected override double DefaultAccuracyPortion => 0.99;
 
         protected override double DefaultComboPortion => 0.01;
diff --git a/osu.Game.Rulesets.Osu/OsuRuleset.cs b/osu.Game.Rulesets.Osu/OsuRuleset.cs
index 92b90339f9..87ffe8983f 100644
--- a/osu.Game.Rulesets.Osu/OsuRuleset.cs
+++ b/osu.Game.Rulesets.Osu/OsuRuleset.cs
@@ -43,7 +43,7 @@ namespace osu.Game.Rulesets.Osu
     {
         public override DrawableRuleset CreateDrawableRulesetWith(IBeatmap beatmap, IReadOnlyList<Mod> mods = null) => new DrawableOsuRuleset(this, beatmap, mods);
 
-        public override ScoreProcessor CreateScoreProcessor() => new OsuScoreProcessor();
+        public override ScoreProcessor CreateScoreProcessor() => new OsuScoreProcessor(this);
 
         public override IBeatmapConverter CreateBeatmapConverter(IBeatmap beatmap) => new OsuBeatmapConverter(beatmap, this);
 
diff --git a/osu.Game.Rulesets.Osu/Scoring/OsuScoreProcessor.cs b/osu.Game.Rulesets.Osu/Scoring/OsuScoreProcessor.cs
index df38f0204a..e397fea0ed 100644
--- a/osu.Game.Rulesets.Osu/Scoring/OsuScoreProcessor.cs
+++ b/osu.Game.Rulesets.Osu/Scoring/OsuScoreProcessor.cs
@@ -11,6 +11,11 @@ namespace osu.Game.Rulesets.Osu.Scoring
 {
     public class OsuScoreProcessor : ScoreProcessor
     {
+        public OsuScoreProcessor(Ruleset ruleset)
+            : base(ruleset)
+        {
+        }
+
         protected override double ClassicScoreMultiplier => 36;
 
         protected override HitEvent CreateHitEvent(JudgementResult result)
diff --git a/osu.Game.Rulesets.Taiko.Tests/Skinning/TestSceneDrawableTaikoMascot.cs b/osu.Game.Rulesets.Taiko.Tests/Skinning/TestSceneDrawableTaikoMascot.cs
index 920a7cd1a1..b7e1c9586a 100644
--- a/osu.Game.Rulesets.Taiko.Tests/Skinning/TestSceneDrawableTaikoMascot.cs
+++ b/osu.Game.Rulesets.Taiko.Tests/Skinning/TestSceneDrawableTaikoMascot.cs
@@ -46,7 +46,7 @@ namespace osu.Game.Rulesets.Taiko.Tests.Skinning
         [SetUp]
         public void SetUp()
         {
-            scoreProcessor = new TaikoScoreProcessor();
+            scoreProcessor = new TaikoScoreProcessor(new TaikoRuleset());
         }
 
         [Test]
diff --git a/osu.Game.Rulesets.Taiko/Scoring/TaikoScoreProcessor.cs b/osu.Game.Rulesets.Taiko/Scoring/TaikoScoreProcessor.cs
index 849b9c14bd..ddf6587022 100644
--- a/osu.Game.Rulesets.Taiko/Scoring/TaikoScoreProcessor.cs
+++ b/osu.Game.Rulesets.Taiko/Scoring/TaikoScoreProcessor.cs
@@ -7,6 +7,11 @@ namespace osu.Game.Rulesets.Taiko.Scoring
 {
     internal class TaikoScoreProcessor : ScoreProcessor
     {
+        public TaikoScoreProcessor(Ruleset ruleset)
+            : base(ruleset)
+        {
+        }
+
         protected override double DefaultAccuracyPortion => 0.75;
 
         protected override double DefaultComboPortion => 0.25;
diff --git a/osu.Game.Rulesets.Taiko/TaikoRuleset.cs b/osu.Game.Rulesets.Taiko/TaikoRuleset.cs
index 8934b64ca5..a3a2858bd5 100644
--- a/osu.Game.Rulesets.Taiko/TaikoRuleset.cs
+++ b/osu.Game.Rulesets.Taiko/TaikoRuleset.cs
@@ -36,7 +36,7 @@ namespace osu.Game.Rulesets.Taiko
     {
         public override DrawableRuleset CreateDrawableRulesetWith(IBeatmap beatmap, IReadOnlyList<Mod> mods = null) => new DrawableTaikoRuleset(this, beatmap, mods);
 
-        public override ScoreProcessor CreateScoreProcessor() => new TaikoScoreProcessor();
+        public override ScoreProcessor CreateScoreProcessor() => new TaikoScoreProcessor(this);
 
         public override HealthProcessor CreateHealthProcessor(double drainStartTime) => new TaikoHealthProcessor();
 
diff --git a/osu.Game.Tests/Gameplay/TestSceneScoreProcessor.cs b/osu.Game.Tests/Gameplay/TestSceneScoreProcessor.cs
index 70ba868de6..9c307341bd 100644
--- a/osu.Game.Tests/Gameplay/TestSceneScoreProcessor.cs
+++ b/osu.Game.Tests/Gameplay/TestSceneScoreProcessor.cs
@@ -25,7 +25,7 @@ namespace osu.Game.Tests.Gameplay
         {
             var beatmap = new Beatmap<HitObject> { HitObjects = { new HitObject() } };
 
-            var scoreProcessor = new ScoreProcessor();
+            var scoreProcessor = new ScoreProcessor(new OsuRuleset());
             scoreProcessor.ApplyBeatmap(beatmap);
 
             // Apply a miss judgement
@@ -39,7 +39,7 @@ namespace osu.Game.Tests.Gameplay
         {
             var beatmap = new Beatmap<HitObject> { HitObjects = { new HitObject() } };
 
-            var scoreProcessor = new ScoreProcessor();
+            var scoreProcessor = new ScoreProcessor(new OsuRuleset());
             scoreProcessor.ApplyBeatmap(beatmap);
 
             // Apply a judgement
@@ -53,7 +53,7 @@ namespace osu.Game.Tests.Gameplay
         {
             var beatmap = new Beatmap<HitObject> { HitObjects = { new HitCircle() } };
 
-            var scoreProcessor = new ScoreProcessor();
+            var scoreProcessor = new ScoreProcessor(new OsuRuleset());
             scoreProcessor.ApplyBeatmap(beatmap);
 
             scoreProcessor.ApplyResult(new JudgementResult(beatmap.HitObjects[0], new TestJudgement(HitResult.Great)) { Type = HitResult.Great });
diff --git a/osu.Game.Tests/Rulesets/Scoring/ScoreProcessorTest.cs b/osu.Game.Tests/Rulesets/Scoring/ScoreProcessorTest.cs
index 2a19d51c9d..5c01950bea 100644
--- a/osu.Game.Tests/Rulesets/Scoring/ScoreProcessorTest.cs
+++ b/osu.Game.Tests/Rulesets/Scoring/ScoreProcessorTest.cs
@@ -10,6 +10,7 @@ using osu.Game.Rulesets.Difficulty;
 using osu.Game.Rulesets.Judgements;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Objects;
+using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Osu.Judgements;
 using osu.Game.Rulesets.Osu.Objects;
 using osu.Game.Rulesets.Scoring;
@@ -27,7 +28,7 @@ namespace osu.Game.Tests.Rulesets.Scoring
         [SetUp]
         public void SetUp()
         {
-            scoreProcessor = new ScoreProcessor();
+            scoreProcessor = new ScoreProcessor(new OsuRuleset());
             beatmap = new TestBeatmap(new RulesetInfo())
             {
                 HitObjects = new List<HitObject>
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneBeatmapSkinFallbacks.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneBeatmapSkinFallbacks.cs
index c5f56cae9e..c5ea9e6204 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneBeatmapSkinFallbacks.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneBeatmapSkinFallbacks.cs
@@ -32,7 +32,7 @@ namespace osu.Game.Tests.Visual.Gameplay
         private SkinManager skinManager { get; set; }
 
         [Cached]
-        private ScoreProcessor scoreProcessor = new ScoreProcessor();
+        private ScoreProcessor scoreProcessor = new ScoreProcessor(new OsuRuleset());
 
         [Cached(typeof(HealthProcessor))]
         private HealthProcessor healthProcessor = new DrainingHealthProcessor(0);
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneHUDOverlay.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneHUDOverlay.cs
index 4b54cd3510..505f73159f 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneHUDOverlay.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneHUDOverlay.cs
@@ -10,6 +10,7 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Testing;
 using osu.Game.Configuration;
 using osu.Game.Rulesets.Mods;
+using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Scoring;
 using osu.Game.Screens.Play;
 using osu.Game.Skinning;
@@ -24,7 +25,7 @@ namespace osu.Game.Tests.Visual.Gameplay
         private HUDOverlay hudOverlay;
 
         [Cached]
-        private ScoreProcessor scoreProcessor = new ScoreProcessor();
+        private ScoreProcessor scoreProcessor = new ScoreProcessor(new OsuRuleset());
 
         [Cached(typeof(HealthProcessor))]
         private HealthProcessor healthProcessor = new DrainingHealthProcessor(0);
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneHitErrorMeter.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneHitErrorMeter.cs
index c1260f0231..ab9758a2ee 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneHitErrorMeter.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneHitErrorMeter.cs
@@ -273,6 +273,11 @@ namespace osu.Game.Tests.Visual.Gameplay
 
         private class TestScoreProcessor : ScoreProcessor
         {
+            public TestScoreProcessor()
+                : base(new OsuRuleset())
+            {
+            }
+
             public void Reset() => base.Reset(false);
         }
     }
diff --git a/osu.Game.Tests/Visual/Gameplay/TestScenePerformancePointsCounter.cs b/osu.Game.Tests/Visual/Gameplay/TestScenePerformancePointsCounter.cs
index 84c7f611af..aefe0db36a 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestScenePerformancePointsCounter.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestScenePerformancePointsCounter.cs
@@ -45,7 +45,7 @@ namespace osu.Game.Tests.Visual.Gameplay
             gameplayState = new GameplayState(beatmap, ruleset);
             gameplayState.LastJudgementResult.BindTo(lastJudgementResult);
 
-            scoreProcessor = new ScoreProcessor();
+            scoreProcessor = new ScoreProcessor(ruleset);
 
             Child = dependencyContainer = new DependencyProvidingContainer
             {
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSkinEditorMultipleSkins.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSkinEditorMultipleSkins.cs
index 856747ad19..8f33f6fac5 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSkinEditorMultipleSkins.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSkinEditorMultipleSkins.cs
@@ -17,7 +17,7 @@ namespace osu.Game.Tests.Visual.Gameplay
     public class TestSceneSkinEditorMultipleSkins : SkinnableTestScene
     {
         [Cached]
-        private readonly ScoreProcessor scoreProcessor = new ScoreProcessor();
+        private readonly ScoreProcessor scoreProcessor = new ScoreProcessor(new OsuRuleset());
 
         [Cached(typeof(HealthProcessor))]
         private HealthProcessor healthProcessor = new DrainingHealthProcessor(0);
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableAccuracyCounter.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableAccuracyCounter.cs
index 80eb887894..9c713b4616 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableAccuracyCounter.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableAccuracyCounter.cs
@@ -5,6 +5,7 @@ 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;
 using osu.Game.Skinning;
@@ -14,7 +15,7 @@ namespace osu.Game.Tests.Visual.Gameplay
     public class TestSceneSkinnableAccuracyCounter : SkinnableHUDComponentTestScene
     {
         [Cached]
-        private ScoreProcessor scoreProcessor = new ScoreProcessor();
+        private ScoreProcessor scoreProcessor = new ScoreProcessor(new OsuRuleset());
 
         protected override Drawable CreateDefaultImplementation() => new DefaultAccuracyCounter();
         protected override Drawable CreateLegacyImplementation() => new LegacyAccuracyCounter();
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableComboCounter.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableComboCounter.cs
index bd1fe050af..f507172931 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableComboCounter.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableComboCounter.cs
@@ -5,6 +5,7 @@ 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;
 
@@ -13,7 +14,7 @@ namespace osu.Game.Tests.Visual.Gameplay
     public class TestSceneSkinnableComboCounter : SkinnableHUDComponentTestScene
     {
         [Cached]
-        private ScoreProcessor scoreProcessor = new ScoreProcessor();
+        private ScoreProcessor scoreProcessor = new ScoreProcessor(new OsuRuleset());
 
         protected override Drawable CreateDefaultImplementation() => new DefaultComboCounter();
         protected override Drawable CreateLegacyImplementation() => new LegacyComboCounter();
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableHUDOverlay.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableHUDOverlay.cs
index 3074a91dc6..cdf349ff7f 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableHUDOverlay.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableHUDOverlay.cs
@@ -24,7 +24,7 @@ namespace osu.Game.Tests.Visual.Gameplay
         private HUDOverlay hudOverlay;
 
         [Cached]
-        private ScoreProcessor scoreProcessor = new ScoreProcessor();
+        private ScoreProcessor scoreProcessor = new ScoreProcessor(new OsuRuleset());
 
         [Cached(typeof(HealthProcessor))]
         private HealthProcessor healthProcessor = new DrainingHealthProcessor(0);
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableScoreCounter.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableScoreCounter.cs
index 1700886263..a871e37ad4 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableScoreCounter.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableScoreCounter.cs
@@ -4,6 +4,7 @@
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
+using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Scoring;
 using osu.Game.Screens.Play.HUD;
 using osu.Game.Skinning;
@@ -13,7 +14,7 @@ namespace osu.Game.Tests.Visual.Gameplay
     public class TestSceneSkinnableScoreCounter : SkinnableHUDComponentTestScene
     {
         [Cached]
-        private ScoreProcessor scoreProcessor = new ScoreProcessor();
+        private ScoreProcessor scoreProcessor = new ScoreProcessor(new OsuRuleset());
 
         protected override Drawable CreateDefaultImplementation() => new DefaultScoreCounter();
         protected override Drawable CreateLegacyImplementation() => new LegacyScoreCounter();
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneUnstableRateCounter.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneUnstableRateCounter.cs
index be20799479..ca8ecd490d 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneUnstableRateCounter.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneUnstableRateCounter.cs
@@ -6,6 +6,7 @@ using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Testing;
 using osu.Game.Rulesets.Judgements;
+using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Osu.Objects;
 using osu.Game.Rulesets.Osu.Scoring;
 using osu.Game.Rulesets.Scoring;
@@ -102,6 +103,11 @@ namespace osu.Game.Tests.Visual.Gameplay
 
         private class TestScoreProcessor : ScoreProcessor
         {
+            public TestScoreProcessor()
+                : base(new OsuRuleset())
+            {
+            }
+
             public void Reset() => base.Reset(false);
         }
     }
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorLeaderboard.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorLeaderboard.cs
index f57a54d84c..0cc1257a07 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorLeaderboard.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorLeaderboard.cs
@@ -43,7 +43,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             {
                 Beatmap.Value = CreateWorkingBeatmap(Ruleset.Value);
                 var playable = Beatmap.Value.GetPlayableBeatmap(Ruleset.Value);
-                var scoreProcessor = new OsuScoreProcessor();
+                var scoreProcessor = new OsuScoreProcessor(Ruleset.Value.CreateInstance());
                 scoreProcessor.ApplyBeatmap(playable);
 
                 LoadComponentAsync(leaderboard = new MultiSpectatorLeaderboard(Ruleset.Value, scoreProcessor, clocks.Keys.Select(id => new MultiplayerRoomUser(id)).ToArray())
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs
index bcd4474876..0edc56f5d3 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs
@@ -64,7 +64,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
                 Children = new Drawable[]
                 {
-                    scoreProcessor = new OsuScoreProcessor(),
+                    scoreProcessor = new OsuScoreProcessor(Ruleset.Value.CreateInstance()),
                 };
 
                 scoreProcessor.ApplyBeatmap(playableBeatmap);
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboardTeams.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboardTeams.cs
index 7f5aced925..60a5785b31 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboardTeams.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboardTeams.cs
@@ -75,7 +75,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
                 Children = new Drawable[]
                 {
-                    scoreProcessor = new OsuScoreProcessor(),
+                    scoreProcessor = new OsuScoreProcessor(Ruleset.Value.CreateInstance()),
                 };
 
                 scoreProcessor.ApplyBeatmap(playableBeatmap);
diff --git a/osu.Game/Rulesets/Ruleset.cs b/osu.Game/Rulesets/Ruleset.cs
index d5926386e8..b7c6132bdb 100644
--- a/osu.Game/Rulesets/Ruleset.cs
+++ b/osu.Game/Rulesets/Ruleset.cs
@@ -201,7 +201,7 @@ namespace osu.Game.Rulesets
         /// Creates a <see cref="ScoreProcessor"/> for this <see cref="Ruleset"/>.
         /// </summary>
         /// <returns>The score processor.</returns>
-        public virtual ScoreProcessor CreateScoreProcessor() => new ScoreProcessor();
+        public virtual ScoreProcessor CreateScoreProcessor() => new ScoreProcessor(this);
 
         /// <summary>
         /// Creates a <see cref="HealthProcessor"/> for this <see cref="Ruleset"/>.
diff --git a/osu.Game/Rulesets/Scoring/ScoreProcessor.cs b/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
index a7fe8b354b..b982c6ece2 100644
--- a/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
+++ b/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
@@ -84,6 +84,7 @@ namespace osu.Game.Rulesets.Scoring
         /// </summary>
         protected virtual double ClassicScoreMultiplier => 36;
 
+        private readonly Ruleset ruleset;
         private readonly double accuracyPortion;
         private readonly double comboPortion;
 
@@ -116,8 +117,10 @@ namespace osu.Game.Rulesets.Scoring
 
         private double scoreMultiplier = 1;
 
-        public ScoreProcessor()
+        public ScoreProcessor(Ruleset ruleset)
         {
+            this.ruleset = ruleset;
+
             accuracyPortion = DefaultAccuracyPortion;
             comboPortion = DefaultComboPortion;
 
@@ -255,7 +258,7 @@ namespace osu.Game.Rulesets.Scoring
         /// <returns>The total score in the given <see cref="ScoringMode"/>.</returns>
         public double ComputeFinalScore(ScoringMode mode, ScoreInfo scoreInfo)
         {
-            extractFromStatistics(scoreInfo.Ruleset.CreateInstance(),
+            extractFromStatistics(ruleset,
                 scoreInfo.Statistics,
                 out double extractedBaseScore,
                 out double extractedMaxBaseScore,
@@ -282,7 +285,7 @@ namespace osu.Game.Rulesets.Scoring
             if (!beatmapApplied)
                 throw new InvalidOperationException($"Cannot compute partial score without calling {nameof(ApplyBeatmap)}.");
 
-            extractFromStatistics(scoreInfo.Ruleset.CreateInstance(),
+            extractFromStatistics(ruleset,
                 scoreInfo.Statistics,
                 out double extractedBaseScore,
                 out _,
@@ -317,7 +320,7 @@ namespace osu.Game.Rulesets.Scoring
             if (scoreInfo.IsLegacyScore && scoreInfo.Ruleset.OnlineID == 3)
             {
                 extractFromStatistics(
-                    scoreInfo.Ruleset.CreateInstance(),
+                    ruleset,
                     scoreInfo.Statistics,
                     out double computedBaseScore,
                     out double computedMaxBaseScore,
diff --git a/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs b/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs
index a9b5544921..af360b42bb 100644
--- a/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs
+++ b/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs
@@ -26,6 +26,7 @@ using osu.Game.Rulesets.Judgements;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Scoring;
+using osu.Game.Scoring;
 using osu.Game.Skinning;
 using osuTK;
 
@@ -56,6 +57,7 @@ namespace osu.Game.Screens.Play.HUD
 
         private JudgementResult lastJudgement;
         private PerformanceCalculator performanceCalculator;
+        private ScoreInfo scoreInfo;
 
         public PerformancePointsCounter()
         {
@@ -72,9 +74,10 @@ namespace osu.Game.Screens.Play.HUD
             if (gameplayState != null)
             {
                 performanceCalculator = gameplayState.Ruleset.CreatePerformanceCalculator();
-
                 clonedMods = gameplayState.Mods.Select(m => m.DeepClone()).ToArray();
 
+                scoreInfo = new ScoreInfo(gameplayState.Score.ScoreInfo.BeatmapInfo, gameplayState.Score.ScoreInfo.Ruleset);
+
                 var gameplayWorkingBeatmap = new GameplayWorkingBeatmap(gameplayState.Beatmap);
                 difficultyCache.GetTimedDifficultyAttributesAsync(gameplayWorkingBeatmap, gameplayState.Ruleset, clonedMods, loadCancellationSource.Token)
                                .ContinueWith(task => Schedule(() =>
@@ -123,16 +126,13 @@ namespace osu.Game.Screens.Play.HUD
 
             var attrib = getAttributeAtTime(judgement);
 
-            if (gameplayState == null || attrib == null)
+            if (gameplayState == null || attrib == null || scoreProcessor == null)
             {
                 IsValid = false;
                 return;
             }
 
-            // awkward but we need to make sure the true mods are not passed to PerformanceCalculator as it makes a mess of track applications.
-            var scoreInfo = gameplayState.Score.ScoreInfo.DeepClone();
-            scoreInfo.Mods = clonedMods;
-
+            scoreProcessor.PopulateScore(scoreInfo);
             Current.Value = (int)Math.Round(performanceCalculator?.Calculate(scoreInfo, attrib).Total ?? 0, MidpointRounding.AwayFromZero);
             IsValid = true;
         }
diff --git a/osu.Game/Skinning/Editor/SkinComponentToolbox.cs b/osu.Game/Skinning/Editor/SkinComponentToolbox.cs
index ce9afd650a..a9dcf705a9 100644
--- a/osu.Game/Skinning/Editor/SkinComponentToolbox.cs
+++ b/osu.Game/Skinning/Editor/SkinComponentToolbox.cs
@@ -2,6 +2,7 @@
 // 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;
@@ -11,11 +12,16 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Effects;
 using osu.Framework.Input.Events;
 using osu.Framework.Utils;
+using osu.Game.Beatmaps;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.UserInterface;
+using osu.Game.Rulesets;
+using osu.Game.Rulesets.Difficulty;
 using osu.Game.Rulesets.Edit;
+using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Scoring;
+using osu.Game.Rulesets.UI;
 using osuTK;
 using osuTK.Graphics;
 
@@ -30,7 +36,7 @@ namespace osu.Game.Skinning.Editor
         private const float component_display_scale = 0.8f;
 
         [Cached]
-        private ScoreProcessor scoreProcessor = new ScoreProcessor
+        private ScoreProcessor scoreProcessor = new ScoreProcessor(new DummyRuleset())
         {
             Combo = { Value = RNG.Next(1, 1000) },
             TotalScore = { Value = RNG.Next(1000, 10000000) }
@@ -171,5 +177,15 @@ namespace osu.Game.Skinning.Editor
                 return true;
             }
         }
+
+        private class DummyRuleset : Ruleset
+        {
+            public override IEnumerable<Mod> GetModsFor(ModType type) => throw new NotImplementedException();
+            public override DrawableRuleset CreateDrawableRulesetWith(IBeatmap beatmap, IReadOnlyList<Mod> mods = null) => throw new NotImplementedException();
+            public override IBeatmapConverter CreateBeatmapConverter(IBeatmap beatmap) => throw new NotImplementedException();
+            public override DifficultyCalculator CreateDifficultyCalculator(IWorkingBeatmap beatmap) => throw new NotImplementedException();
+            public override string Description { get; }
+            public override string ShortName { get; }
+        }
     }
 }

From 028750936c1243f0da0627416cddc067154238e2 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Mon, 14 Mar 2022 17:10:37 +0900
Subject: [PATCH 3399/5547] Apply review suggestions

---
 osu.Game/Rulesets/Scoring/JudgementProcessor.cs       | 8 +++++++-
 osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs | 2 +-
 2 files changed, 8 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Rulesets/Scoring/JudgementProcessor.cs b/osu.Game/Rulesets/Scoring/JudgementProcessor.cs
index 3017841c9d..94ddc32bb7 100644
--- a/osu.Game/Rulesets/Scoring/JudgementProcessor.cs
+++ b/osu.Game/Rulesets/Scoring/JudgementProcessor.cs
@@ -5,6 +5,7 @@
 
 using System;
 using osu.Framework.Bindables;
+using osu.Framework.Extensions.ObjectExtensions;
 using osu.Framework.Extensions.TypeExtensions;
 using osu.Framework.Graphics;
 using osu.Game.Beatmaps;
@@ -165,7 +166,12 @@ namespace osu.Game.Rulesets.Scoring
         protected override void Update()
         {
             base.Update();
-            hasCompleted.Value = JudgedHits == MaxHits && (JudgedHits == 0 || lastAppliedResult?.TimeAbsolute < Clock.CurrentTime);
+
+            hasCompleted.Value =
+                JudgedHits == MaxHits
+                && (JudgedHits == 0
+                    // Last applied result is guaranteed to be non-null when JudgedHits > 0.
+                    || lastAppliedResult.AsNonNull().TimeAbsolute < Clock.CurrentTime);
         }
 
         /// <summary>
diff --git a/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs b/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs
index af360b42bb..c0d0ea0721 100644
--- a/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs
+++ b/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs
@@ -76,7 +76,7 @@ namespace osu.Game.Screens.Play.HUD
                 performanceCalculator = gameplayState.Ruleset.CreatePerformanceCalculator();
                 clonedMods = gameplayState.Mods.Select(m => m.DeepClone()).ToArray();
 
-                scoreInfo = new ScoreInfo(gameplayState.Score.ScoreInfo.BeatmapInfo, gameplayState.Score.ScoreInfo.Ruleset);
+                scoreInfo = new ScoreInfo(gameplayState.Score.ScoreInfo.BeatmapInfo, gameplayState.Score.ScoreInfo.Ruleset) { Mods = clonedMods };
 
                 var gameplayWorkingBeatmap = new GameplayWorkingBeatmap(gameplayState.Beatmap);
                 difficultyCache.GetTimedDifficultyAttributesAsync(gameplayWorkingBeatmap, gameplayState.Ruleset, clonedMods, loadCancellationSource.Token)

From 8676a2587c12c2a200d6122d53736a611401e1a6 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 14 Mar 2022 15:45:43 +0900
Subject: [PATCH 3400/5547] Add the ability for `HitObject`s to specify
 auxiliary samples

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

diff --git a/osu.Game/Rulesets/Objects/HitObject.cs b/osu.Game/Rulesets/Objects/HitObject.cs
index c590cc302f..57b897e5b5 100644
--- a/osu.Game/Rulesets/Objects/HitObject.cs
+++ b/osu.Game/Rulesets/Objects/HitObject.cs
@@ -3,6 +3,7 @@
 
 using System;
 using System.Collections.Generic;
+using System.Collections.Immutable;
 using System.Threading;
 using JetBrains.Annotations;
 using Newtonsoft.Json;
@@ -67,6 +68,12 @@ namespace osu.Game.Rulesets.Objects
             }
         }
 
+        /// <summary>
+        /// Any samples which may be used by this hit object that are non-standard.
+        /// This is used only to preload these samples ahead of time.
+        /// </summary>
+        public virtual IList<HitSampleInfo> AuxiliarySamples => ImmutableList<HitSampleInfo>.Empty;
+
         public SampleControlPoint SampleControlPoint = SampleControlPoint.DEFAULT;
         public DifficultyControlPoint DifficultyControlPoint = DifficultyControlPoint.DEFAULT;
 

From 90e34d7686b9a9762ba153ca841c5ad685497f3b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 14 Mar 2022 15:45:57 +0900
Subject: [PATCH 3401/5547] Move slider slide samples to auxiliary
 specification

---
 .../Objects/Drawables/DrawableSlider.cs       | 22 +++++--------------
 osu.Game.Rulesets.Osu/Objects/Slider.cs       | 17 ++++++++++++++
 2 files changed, 22 insertions(+), 17 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSlider.cs b/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSlider.cs
index 3acec4498d..1447f131c6 100644
--- a/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSlider.cs
+++ b/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSlider.cs
@@ -2,23 +2,22 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
-using System.Collections.Generic;
 using System.Linq;
 using JetBrains.Annotations;
-using osuTK;
-using osu.Framework.Graphics;
-using osu.Game.Rulesets.Objects.Drawables;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
+using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Audio;
 using osu.Game.Rulesets.Objects;
+using osu.Game.Rulesets.Objects.Drawables;
 using osu.Game.Rulesets.Osu.Skinning;
 using osu.Game.Rulesets.Osu.Skinning.Default;
 using osu.Game.Rulesets.Osu.UI;
 using osu.Game.Rulesets.Scoring;
-using osuTK.Graphics;
 using osu.Game.Skinning;
+using osuTK;
+using osuTK.Graphics;
 
 namespace osu.Game.Rulesets.Osu.Objects.Drawables
 {
@@ -126,18 +125,7 @@ namespace osu.Game.Rulesets.Osu.Objects.Drawables
             }
 
             Samples.Samples = HitObject.TailSamples.Select(s => HitObject.SampleControlPoint.ApplyTo(s)).Cast<ISampleInfo>().ToArray();
-
-            var slidingSamples = new List<ISampleInfo>();
-
-            var normalSample = HitObject.Samples.FirstOrDefault(s => s.Name == HitSampleInfo.HIT_NORMAL);
-            if (normalSample != null)
-                slidingSamples.Add(HitObject.SampleControlPoint.ApplyTo(normalSample).With("sliderslide"));
-
-            var whistleSample = HitObject.Samples.FirstOrDefault(s => s.Name == HitSampleInfo.HIT_WHISTLE);
-            if (whistleSample != null)
-                slidingSamples.Add(HitObject.SampleControlPoint.ApplyTo(whistleSample).With("sliderwhistle"));
-
-            slidingSample.Samples = slidingSamples.ToArray();
+            slidingSample.Samples = HitObject.CreateSlidingSamples().Select(s => HitObject.SampleControlPoint.ApplyTo(s)).Cast<ISampleInfo>().ToArray();
         }
 
         public override void StopAllSamples()
diff --git a/osu.Game.Rulesets.Osu/Objects/Slider.cs b/osu.Game.Rulesets.Osu/Objects/Slider.cs
index 5c1c3fd253..601311694d 100644
--- a/osu.Game.Rulesets.Osu/Objects/Slider.cs
+++ b/osu.Game.Rulesets.Osu/Objects/Slider.cs
@@ -29,6 +29,23 @@ namespace osu.Game.Rulesets.Osu.Objects
             set => throw new System.NotSupportedException($"Adjust via {nameof(RepeatCount)} instead"); // can be implemented if/when needed.
         }
 
+        public override IList<HitSampleInfo> AuxiliarySamples => CreateSlidingSamples();
+
+        public IList<HitSampleInfo> CreateSlidingSamples()
+        {
+            var slidingSamples = new List<HitSampleInfo>();
+
+            var normalSample = Samples.FirstOrDefault(s => s.Name == HitSampleInfo.HIT_NORMAL);
+            if (normalSample != null)
+                slidingSamples.Add(normalSample.With("sliderslide"));
+
+            var whistleSample = Samples.FirstOrDefault(s => s.Name == HitSampleInfo.HIT_WHISTLE);
+            if (whistleSample != null)
+                slidingSamples.Add(whistleSample.With("sliderwhistle"));
+
+            return slidingSamples;
+        }
+
         private readonly Cached<Vector2> endPositionCache = new Cached<Vector2>();
 
         public override Vector2 EndPosition => endPositionCache.IsValid ? endPositionCache.Value : endPositionCache.Value = Position + this.CurvePositionAt(1);

From be9920218805cc3280fb1e16d3816774305ca069 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 14 Mar 2022 17:08:04 +0900
Subject: [PATCH 3402/5547] Move spinner spin samples to auxiliary
 specification

---
 .../Objects/Drawables/DrawableSpinner.cs      | 11 ++---------
 osu.Game.Rulesets.Osu/Objects/Spinner.cs      | 19 +++++++++++++++++++
 2 files changed, 21 insertions(+), 9 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSpinner.cs b/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSpinner.cs
index c6db02ee02..a904658a4c 100644
--- a/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSpinner.cs
+++ b/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSpinner.cs
@@ -121,15 +121,8 @@ namespace osu.Game.Rulesets.Osu.Objects.Drawables
         {
             base.LoadSamples();
 
-            var firstSample = HitObject.Samples.FirstOrDefault();
-
-            if (firstSample != null)
-            {
-                var clone = HitObject.SampleControlPoint.ApplyTo(firstSample).With("spinnerspin");
-
-                spinningSample.Samples = new ISampleInfo[] { clone };
-                spinningSample.Frequency.Value = spinning_sample_initial_frequency;
-            }
+            spinningSample.Samples = HitObject.CreateSpinningSamples().Select(s => HitObject.SampleControlPoint.ApplyTo(s)).Cast<ISampleInfo>().ToArray();
+            spinningSample.Frequency.Value = spinning_sample_initial_frequency;
         }
 
         private void updateSpinningSample(ValueChangedEvent<bool> tracking)
diff --git a/osu.Game.Rulesets.Osu/Objects/Spinner.cs b/osu.Game.Rulesets.Osu/Objects/Spinner.cs
index 1eddfb7fef..ddee4d3ebd 100644
--- a/osu.Game.Rulesets.Osu/Objects/Spinner.cs
+++ b/osu.Game.Rulesets.Osu/Objects/Spinner.cs
@@ -1,7 +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 System.Collections.Generic;
+using System.Linq;
 using System.Threading;
+using osu.Game.Audio;
 using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.ControlPoints;
 using osu.Game.Rulesets.Judgements;
@@ -73,5 +77,20 @@ namespace osu.Game.Rulesets.Osu.Objects
         public override Judgement CreateJudgement() => new OsuJudgement();
 
         protected override HitWindows CreateHitWindows() => HitWindows.Empty;
+
+        public override IList<HitSampleInfo> AuxiliarySamples => CreateSpinningSamples();
+
+        public HitSampleInfo[] CreateSpinningSamples()
+        {
+            var referenceSample = Samples.FirstOrDefault();
+
+            if (referenceSample == null)
+                return Array.Empty<HitSampleInfo>();
+
+            return new[]
+            {
+                SampleControlPoint.ApplyTo(referenceSample).With("spinnerspin")
+            };
+        }
     }
 }

From 6d6f73e0168d6c7d5c447e0b32c6d8566d5b4761 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 14 Mar 2022 17:08:26 +0900
Subject: [PATCH 3403/5547] Add overrides in `DrawableSliderTail` to
 explain/warn that this class never plays its own samples

---
 .../Objects/Drawables/DrawableSliderTail.cs          | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSliderTail.cs b/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSliderTail.cs
index ec1387eb54..64964ed396 100644
--- a/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSliderTail.cs
+++ b/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSliderTail.cs
@@ -74,6 +74,18 @@ namespace osu.Game.Rulesets.Osu.Objects.Drawables
             ScaleBindable.BindValueChanged(scale => scaleContainer.Scale = new Vector2(scale.NewValue));
         }
 
+        protected override void LoadSamples()
+        {
+            // Tail models don't actually get samples, as the playback is handled by DrawableSlider.
+            // This override is only here for visibility in explaining this weird flow.
+        }
+
+        public override void PlaySamples()
+        {
+            // Tail models don't actually get samples, as the playback is handled by DrawableSlider.
+            // This override is only here for visibility in explaining this weird flow.
+        }
+
         protected override void UpdateInitialTransforms()
         {
             base.UpdateInitialTransforms();

From 45233932089ea26d9e329c47f1893137d2d4bcaf Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 14 Mar 2022 17:08:57 +0900
Subject: [PATCH 3404/5547] Remove `IsLayered` from `LegacyHitSampleInfo`
 comparison

The equality of samples is generally used to compare the sample
equality, not its full properties. For instance, we don't compare
`Volume` in the base implementation.

Having `IsLayered` here breaks actual usages of equality, ie. for
pooling purposes.
---
 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 b091803406..47fe9032f0 100644
--- a/osu.Game/Rulesets/Objects/Legacy/ConvertHitObjectParser.cs
+++ b/osu.Game/Rulesets/Objects/Legacy/ConvertHitObjectParser.cs
@@ -500,7 +500,7 @@ namespace osu.Game.Rulesets.Objects.Legacy
                 => new LegacyHitSampleInfo(newName.GetOr(Name), newBank.GetOr(Bank), newVolume.GetOr(Volume), newCustomSampleBank.GetOr(CustomSampleBank), newIsLayered.GetOr(IsLayered));
 
             public bool Equals(LegacyHitSampleInfo? other)
-                => base.Equals(other) && CustomSampleBank == other.CustomSampleBank && IsLayered == other.IsLayered;
+                => base.Equals(other) && CustomSampleBank == other.CustomSampleBank;
 
             public override bool Equals(object? obj)
                 => obj is LegacyHitSampleInfo other && Equals(other);

From 1b8c632b878b6d5c30a7a5693dc5834d0aa987b9 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 14 Mar 2022 17:17:14 +0900
Subject: [PATCH 3405/5547] Add `TailSamples` to auxiliary samples list

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

diff --git a/osu.Game.Rulesets.Osu/Objects/Slider.cs b/osu.Game.Rulesets.Osu/Objects/Slider.cs
index 601311694d..776165cfb4 100644
--- a/osu.Game.Rulesets.Osu/Objects/Slider.cs
+++ b/osu.Game.Rulesets.Osu/Objects/Slider.cs
@@ -29,7 +29,7 @@ namespace osu.Game.Rulesets.Osu.Objects
             set => throw new System.NotSupportedException($"Adjust via {nameof(RepeatCount)} instead"); // can be implemented if/when needed.
         }
 
-        public override IList<HitSampleInfo> AuxiliarySamples => CreateSlidingSamples();
+        public override IList<HitSampleInfo> AuxiliarySamples => CreateSlidingSamples().Concat(TailSamples).ToArray();
 
         public IList<HitSampleInfo> CreateSlidingSamples()
         {

From 39d95aa8cf412b1a5ef66e1cd1d05541fef4f3bb Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 14 Mar 2022 17:19:23 +0900
Subject: [PATCH 3406/5547] Add automatic preloading of sample pools at a
 `Playfield` level

---
 osu.Game/Rulesets/UI/Playfield.cs | 73 +++++++++++++++++++++----------
 1 file changed, 49 insertions(+), 24 deletions(-)

diff --git a/osu.Game/Rulesets/UI/Playfield.cs b/osu.Game/Rulesets/UI/Playfield.cs
index 30e71dde1c..cd8f99db8b 100644
--- a/osu.Game/Rulesets/UI/Playfield.cs
+++ b/osu.Game/Rulesets/UI/Playfield.cs
@@ -3,22 +3,22 @@
 
 using System;
 using System.Collections.Generic;
+using System.Diagnostics;
 using System.Linq;
 using JetBrains.Annotations;
-using osu.Framework.Graphics;
-using osu.Game.Rulesets.Objects.Drawables;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Extensions.IEnumerableExtensions;
+using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Pooling;
 using osu.Game.Audio;
 using osu.Game.Rulesets.Judgements;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Objects;
+using osu.Game.Rulesets.Objects.Drawables;
 using osu.Game.Skinning;
 using osuTK;
-using System.Diagnostics;
 
 namespace osu.Game.Rulesets.UI
 {
@@ -264,10 +264,25 @@ namespace osu.Game.Rulesets.UI
             var entry = CreateLifetimeEntry(hitObject);
             lifetimeEntryMap[entry.HitObject] = entry;
 
+            preloadSamples(hitObject);
+
             HitObjectContainer.Add(entry);
             OnHitObjectAdded(entry.HitObject);
         }
 
+        private void preloadSamples(HitObject hitObject)
+        {
+            // prepare sample pools ahead of time so we're not initialising at runtime.
+            foreach (var sample in hitObject.Samples)
+                prepareSamplePool(hitObject.SampleControlPoint.ApplyTo(sample));
+
+            foreach (var sample in hitObject.AuxiliarySamples)
+                prepareSamplePool(hitObject.SampleControlPoint.ApplyTo(sample));
+
+            foreach (var nestedObject in hitObject.NestedHitObjects)
+                preloadSamples(nestedObject);
+        }
+
         /// <summary>
         /// Removes a <see cref="HitObjectLifetimeEntry"/> for a pooled <see cref="HitObject"/> from this <see cref="Playfield"/>.
         /// </summary>
@@ -330,22 +345,7 @@ namespace osu.Game.Rulesets.UI
 
         DrawableHitObject IPooledHitObjectProvider.GetPooledDrawableRepresentation(HitObject hitObject, DrawableHitObject parent)
         {
-            var lookupType = hitObject.GetType();
-
-            IDrawablePool pool;
-
-            // Tests may add derived hitobject instances for which pools don't exist. Try to find any applicable pool and dynamically assign the type if the pool exists.
-            if (!pools.TryGetValue(lookupType, out pool))
-            {
-                foreach (var (t, p) in pools)
-                {
-                    if (!t.IsInstanceOfType(hitObject))
-                        continue;
-
-                    pools[lookupType] = pool = p;
-                    break;
-                }
-            }
+            var pool = prepareDrawableHitObjectPool(hitObject);
 
             return (DrawableHitObject)pool?.Get(d =>
             {
@@ -372,14 +372,39 @@ namespace osu.Game.Rulesets.UI
             });
         }
 
+        private IDrawablePool prepareDrawableHitObjectPool(HitObject hitObject)
+        {
+            var lookupType = hitObject.GetType();
+
+            IDrawablePool pool;
+
+            // Tests may add derived hitobject instances for which pools don't exist. Try to find any applicable pool and dynamically assign the type if the pool exists.
+            if (!pools.TryGetValue(lookupType, out pool))
+            {
+                foreach (var (t, p) in pools)
+                {
+                    if (!t.IsInstanceOfType(hitObject))
+                        continue;
+
+                    pools[lookupType] = pool = p;
+                    break;
+                }
+            }
+
+            return pool;
+        }
+
         private readonly Dictionary<ISampleInfo, DrawablePool<PoolableSkinnableSample>> samplePools = new Dictionary<ISampleInfo, DrawablePool<PoolableSkinnableSample>>();
 
-        public PoolableSkinnableSample GetPooledSample(ISampleInfo sampleInfo)
-        {
-            if (!samplePools.TryGetValue(sampleInfo, out var existingPool))
-                AddInternal(samplePools[sampleInfo] = existingPool = new DrawableSamplePool(sampleInfo, 1));
+        public PoolableSkinnableSample GetPooledSample(ISampleInfo sampleInfo) => prepareSamplePool(sampleInfo).Get();
 
-            return existingPool.Get();
+        private DrawablePool<PoolableSkinnableSample> prepareSamplePool(ISampleInfo sampleInfo)
+        {
+            if (samplePools.TryGetValue(sampleInfo, out var pool)) return pool;
+
+            AddInternal(samplePools[sampleInfo] = pool = new DrawableSamplePool(sampleInfo, 1));
+
+            return pool;
         }
 
         private class DrawableSamplePool : DrawablePool<PoolableSkinnableSample>

From 3c5fda5f23fce4a384cf286b4cab2ff180cfaa33 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 14 Mar 2022 17:24:31 +0900
Subject: [PATCH 3407/5547] Add early exist if the target screen is no longer
 current

---
 osu.Game/Skinning/Editor/SkinEditorOverlay.cs | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/osu.Game/Skinning/Editor/SkinEditorOverlay.cs b/osu.Game/Skinning/Editor/SkinEditorOverlay.cs
index abd8272633..73af2591c8 100644
--- a/osu.Game/Skinning/Editor/SkinEditorOverlay.cs
+++ b/osu.Game/Skinning/Editor/SkinEditorOverlay.cs
@@ -132,6 +132,9 @@ namespace osu.Game.Skinning.Editor
         {
             Debug.Assert(skinEditor != null);
 
+            if (!target.IsCurrentScreen())
+                return;
+
             if (!target.IsLoaded)
             {
                 Scheduler.AddOnce(setTarget, target);

From 16ee6b5fc7700b2a46359fb6b814e9c56eafaa53 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 14 Mar 2022 18:12:04 +0900
Subject: [PATCH 3408/5547] Remove `IsLayered` from `GetHasCode` implementation

---
 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 47fe9032f0..8dc037c7c8 100644
--- a/osu.Game/Rulesets/Objects/Legacy/ConvertHitObjectParser.cs
+++ b/osu.Game/Rulesets/Objects/Legacy/ConvertHitObjectParser.cs
@@ -505,7 +505,7 @@ namespace osu.Game.Rulesets.Objects.Legacy
             public override bool Equals(object? obj)
                 => obj is LegacyHitSampleInfo other && Equals(other);
 
-            public override int GetHashCode() => HashCode.Combine(base.GetHashCode(), CustomSampleBank, IsLayered);
+            public override int GetHashCode() => HashCode.Combine(base.GetHashCode(), CustomSampleBank);
         }
 
         private class FileHitSampleInfo : LegacyHitSampleInfo, IEquatable<FileHitSampleInfo>

From b31ff679fb1af632f8b40d980a3d3528a08e43a8 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 14 Mar 2022 19:16:19 +0900
Subject: [PATCH 3409/5547] Provide correct `HitResult` type for random
 judgements in `TestSceneHitErrorMeter`

---
 osu.Game.Tests/Visual/Gameplay/TestSceneHitErrorMeter.cs | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneHitErrorMeter.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneHitErrorMeter.cs
index c1260f0231..a93ab6810d 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneHitErrorMeter.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneHitErrorMeter.cs
@@ -48,7 +48,11 @@ namespace osu.Game.Tests.Visual.Gameplay
         {
             AddStep("create display", () => recreateDisplay(new OsuHitWindows(), 5));
 
-            AddRepeatStep("New random judgement", () => newJudgement(), 40);
+            AddRepeatStep("New random judgement", () =>
+            {
+                double offset = RNG.Next(-150, 150);
+                newJudgement(offset, drawableRuleset.HitWindows.ResultFor(offset));
+            }, 400);
 
             AddRepeatStep("New max negative", () => newJudgement(-drawableRuleset.HitWindows.WindowFor(HitResult.Meh)), 20);
             AddRepeatStep("New max positive", () => newJudgement(drawableRuleset.HitWindows.WindowFor(HitResult.Meh)), 20);

From 6eed2c35a4cb79877ced63626745d8768fb196a9 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 14 Mar 2022 19:16:38 +0900
Subject: [PATCH 3410/5547] Adjust visual appearance of `BarHitErrorMeter` for
 easier reading

---
 .../HUD/HitErrorMeters/BarHitErrorMeter.cs    | 157 ++++++++++--------
 1 file changed, 89 insertions(+), 68 deletions(-)

diff --git a/osu.Game/Screens/Play/HUD/HitErrorMeters/BarHitErrorMeter.cs b/osu.Game/Screens/Play/HUD/HitErrorMeters/BarHitErrorMeter.cs
index 7903e54960..2f9206e0fb 100644
--- a/osu.Game/Screens/Play/HUD/HitErrorMeters/BarHitErrorMeter.cs
+++ b/osu.Game/Screens/Play/HUD/HitErrorMeters/BarHitErrorMeter.cs
@@ -13,7 +13,6 @@ using osu.Framework.Graphics.Sprites;
 using osu.Game.Rulesets.Judgements;
 using osu.Game.Rulesets.Scoring;
 using osuTK;
-using osuTK.Graphics;
 
 namespace osu.Game.Screens.Play.HUD.HitErrorMeters
 {
@@ -21,14 +20,15 @@ namespace osu.Game.Screens.Play.HUD.HitErrorMeters
     {
         private const int arrow_move_duration = 400;
 
-        private const int judgement_line_width = 6;
+        private const int judgement_line_width = 10;
+        private const int judgement_line_height = 3;
+
+        private const int centre_marker_size = 6;
 
         private const int bar_height = 200;
 
         private const int bar_width = 2;
 
-        private const int spacing = 2;
-
         private const float chevron_size = 8;
 
         private SpriteIcon arrow;
@@ -50,54 +50,25 @@ namespace osu.Game.Screens.Play.HUD.HitErrorMeters
         [BackgroundDependencyLoader]
         private void load()
         {
-            InternalChild = new FillFlowContainer
+            var hitWindows = HitWindows.GetAllAvailableWindows().ToArray();
+
+            InternalChild = new Container
             {
                 AutoSizeAxes = Axes.X,
                 Height = bar_height,
-                Direction = FillDirection.Horizontal,
-                Spacing = new Vector2(spacing, 0),
                 Margin = new MarginPadding(2),
                 Children = new Drawable[]
                 {
-                    new Container
-                    {
-                        Anchor = Anchor.CentreLeft,
-                        Origin = Anchor.CentreLeft,
-                        Width = chevron_size,
-                        RelativeSizeAxes = Axes.Y,
-                        Child = arrow = new SpriteIcon
-                        {
-                            Anchor = Anchor.TopCentre,
-                            Origin = Anchor.Centre,
-                            RelativePositionAxes = Axes.Y,
-                            Y = 0.5f,
-                            Icon = FontAwesome.Solid.ChevronRight,
-                            Size = new Vector2(chevron_size),
-                        }
-                    },
                     colourBars = new Container
                     {
-                        Width = bar_width,
-                        RelativeSizeAxes = Axes.Y,
+                        Name = "colour axis",
+                        X = chevron_size,
                         Anchor = Anchor.CentreLeft,
                         Origin = Anchor.CentreLeft,
+                        Width = judgement_line_width,
+                        RelativeSizeAxes = Axes.Y,
                         Children = new Drawable[]
                         {
-                            colourBarsEarly = new Container
-                            {
-                                Anchor = Anchor.CentreLeft,
-                                Origin = Anchor.TopRight,
-                                RelativeSizeAxes = Axes.Both,
-                                Height = 0.5f,
-                                Scale = new Vector2(1, -1),
-                            },
-                            colourBarsLate = new Container
-                            {
-                                Anchor = Anchor.CentreLeft,
-                                Origin = Anchor.TopRight,
-                                RelativeSizeAxes = Axes.Both,
-                                Height = 0.5f,
-                            },
                             iconEarly = new SpriteIcon
                             {
                                 Y = -10,
@@ -113,20 +84,72 @@ namespace osu.Game.Screens.Play.HUD.HitErrorMeters
                                 Icon = FontAwesome.Solid.Bicycle,
                                 Anchor = Anchor.BottomCentre,
                                 Origin = Anchor.Centre,
-                            }
+                            },
+                            colourBarsEarly = new Container
+                            {
+                                Anchor = Anchor.Centre,
+                                Origin = Anchor.TopCentre,
+                                Width = bar_width,
+                                RelativeSizeAxes = Axes.Y,
+                                Height = 0.5f,
+                                Scale = new Vector2(1, -1),
+                            },
+                            colourBarsLate = new Container
+                            {
+                                Anchor = Anchor.Centre,
+                                Origin = Anchor.TopCentre,
+                                Width = bar_width,
+                                RelativeSizeAxes = Axes.Y,
+                                Height = 0.5f,
+                            },
+                            judgementsContainer = new Container
+                            {
+                                Name = "judgements",
+                                Anchor = Anchor.TopCentre,
+                                Origin = Anchor.TopCentre,
+                                RelativeSizeAxes = Axes.Y,
+                                Width = judgement_line_width,
+                            },
+                            new Circle
+                            {
+                                Name = "middle marker behind",
+                                Colour = GetColourForHitResult(hitWindows.Last().result),
+                                Anchor = Anchor.Centre,
+                                Origin = Anchor.Centre,
+                                Size = new Vector2(centre_marker_size),
+                            },
+                            new Circle
+                            {
+                                Name = "middle marker in front",
+                                Colour = GetColourForHitResult(hitWindows.Last().result).Darken(0.5f),
+                                Anchor = Anchor.Centre,
+                                Origin = Anchor.Centre,
+                                Size = new Vector2(centre_marker_size),
+                                Scale = new Vector2(0.5f),
+                            },
                         }
                     },
-                    judgementsContainer = new Container
+                    new Container
                     {
+                        Name = "average chevron",
                         Anchor = Anchor.CentreLeft,
                         Origin = Anchor.CentreLeft,
-                        Width = judgement_line_width,
+                        Width = chevron_size,
                         RelativeSizeAxes = Axes.Y,
+                        Child = arrow = new SpriteIcon
+                        {
+                            Anchor = Anchor.TopCentre,
+                            Origin = Anchor.Centre,
+                            RelativePositionAxes = Axes.Y,
+                            Y = 0.5f,
+                            Icon = FontAwesome.Solid.ChevronRight,
+                            Size = new Vector2(chevron_size),
+                        }
                     },
                 }
             };
 
-            createColourBars();
+            createColourBars(hitWindows);
         }
 
         protected override void LoadComplete()
@@ -149,10 +172,8 @@ namespace osu.Game.Screens.Play.HUD.HitErrorMeters
             iconLate.Rotation = -Rotation;
         }
 
-        private void createColourBars()
+        private void createColourBars((HitResult result, double length)[] windows)
         {
-            var windows = HitWindows.GetAllAvailableWindows().ToArray();
-
             // max to avoid div-by-zero.
             maxHitWindow = Math.Max(1, windows.First().length);
 
@@ -166,17 +187,11 @@ namespace osu.Game.Screens.Play.HUD.HitErrorMeters
                 colourBarsLate.Add(createColourBar(result, hitWindow, i == 0));
             }
 
-            // a little nub to mark the centre point.
-            var centre = createColourBar(windows.Last().result, 0.01f);
-            centre.Anchor = centre.Origin = Anchor.CentreLeft;
-            centre.Width = 2.5f;
-            colourBars.Add(centre);
-
-            Drawable createColourBar(HitResult result, float height, bool first = false)
+            Drawable createColourBar(HitResult result, float height, bool requireGradient = false)
             {
                 var colour = GetColourForHitResult(result);
 
-                if (first)
+                if (requireGradient)
                 {
                     // the first bar needs gradient rendering.
                     const float gradient_start = 0.8f;
@@ -243,7 +258,7 @@ namespace osu.Game.Screens.Play.HUD.HitErrorMeters
             judgementsContainer.Add(new JudgementLine
             {
                 Y = getRelativeJudgementPosition(judgement.TimeOffset),
-                Origin = Anchor.CentreLeft,
+                Colour = GetColourForHitResult(judgement.Type),
             });
 
             arrow.MoveToY(
@@ -255,34 +270,40 @@ namespace osu.Game.Screens.Play.HUD.HitErrorMeters
 
         internal class JudgementLine : CompositeDrawable
         {
-            private const int judgement_fade_duration = 5000;
-
             public JudgementLine()
             {
                 RelativeSizeAxes = Axes.X;
                 RelativePositionAxes = Axes.Y;
-                Height = 3;
+                Height = judgement_line_height;
 
-                InternalChild = new CircularContainer
+                Blending = BlendingParameters.Additive;
+
+                Origin = Anchor.Centre;
+                Anchor = Anchor.TopCentre;
+
+                InternalChild = new Circle
                 {
-                    Masking = true,
                     RelativeSizeAxes = Axes.Both,
-                    Child = new Box
-                    {
-                        RelativeSizeAxes = Axes.Both,
-                        Colour = Color4.White,
-                    }
                 };
             }
 
             protected override void LoadComplete()
             {
+                const int judgement_fade_in_duration = 100;
+                const int judgement_fade_out_duration = 5000;
+
                 base.LoadComplete();
 
+                Alpha = 0;
                 Width = 0;
 
-                this.ResizeWidthTo(1, 200, Easing.OutElasticHalf);
-                this.FadeTo(0.8f, 150).Then().FadeOut(judgement_fade_duration).Expire();
+                this
+                    .FadeTo(0.8f, judgement_fade_in_duration, Easing.OutQuint)
+                    .ResizeWidthTo(1, judgement_fade_in_duration, Easing.OutQuint)
+                    .Then()
+                    .FadeOut(judgement_fade_out_duration, Easing.In)
+                    .ResizeWidthTo(0, judgement_fade_out_duration, Easing.In)
+                    .Expire();
             }
         }
 

From e91b3ae5f19fa70fa4062be6aef4e726f12ba10c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 14 Mar 2022 19:18:47 +0900
Subject: [PATCH 3411/5547] Move constants closer to usages

---
 .../HUD/HitErrorMeters/BarHitErrorMeter.cs    | 22 +++++++++----------
 1 file changed, 10 insertions(+), 12 deletions(-)

diff --git a/osu.Game/Screens/Play/HUD/HitErrorMeters/BarHitErrorMeter.cs b/osu.Game/Screens/Play/HUD/HitErrorMeters/BarHitErrorMeter.cs
index 2f9206e0fb..521d8c01b1 100644
--- a/osu.Game/Screens/Play/HUD/HitErrorMeters/BarHitErrorMeter.cs
+++ b/osu.Game/Screens/Play/HUD/HitErrorMeters/BarHitErrorMeter.cs
@@ -18,19 +18,9 @@ namespace osu.Game.Screens.Play.HUD.HitErrorMeters
 {
     public class BarHitErrorMeter : HitErrorMeter
     {
-        private const int arrow_move_duration = 400;
-
         private const int judgement_line_width = 10;
         private const int judgement_line_height = 3;
 
-        private const int centre_marker_size = 6;
-
-        private const int bar_height = 200;
-
-        private const int bar_width = 2;
-
-        private const float chevron_size = 8;
-
         private SpriteIcon arrow;
         private SpriteIcon iconEarly;
         private SpriteIcon iconLate;
@@ -50,6 +40,12 @@ namespace osu.Game.Screens.Play.HUD.HitErrorMeters
         [BackgroundDependencyLoader]
         private void load()
         {
+            const int centre_marker_size = 6;
+            const int bar_height = 200;
+            const int bar_width = 2;
+            const float chevron_size = 8;
+            const float icon_size = 14;
+
             var hitWindows = HitWindows.GetAllAvailableWindows().ToArray();
 
             InternalChild = new Container
@@ -72,7 +68,7 @@ namespace osu.Game.Screens.Play.HUD.HitErrorMeters
                             iconEarly = new SpriteIcon
                             {
                                 Y = -10,
-                                Size = new Vector2(10),
+                                Size = new Vector2(icon_size),
                                 Icon = FontAwesome.Solid.ShippingFast,
                                 Anchor = Anchor.TopCentre,
                                 Origin = Anchor.Centre,
@@ -80,7 +76,7 @@ namespace osu.Game.Screens.Play.HUD.HitErrorMeters
                             iconLate = new SpriteIcon
                             {
                                 Y = 10,
-                                Size = new Vector2(10),
+                                Size = new Vector2(icon_size),
                                 Icon = FontAwesome.Solid.Bicycle,
                                 Anchor = Anchor.BottomCentre,
                                 Origin = Anchor.Centre,
@@ -235,6 +231,8 @@ namespace osu.Game.Screens.Play.HUD.HitErrorMeters
 
         protected override void OnNewJudgement(JudgementResult judgement)
         {
+            const int arrow_move_duration = 400;
+
             if (!judgement.IsHit || judgement.HitObject.HitWindows?.WindowFor(HitResult.Miss) == 0)
                 return;
 

From 163cd48bf63ec43c3b9677340976544b109eca2f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 14 Mar 2022 19:27:53 +0900
Subject: [PATCH 3412/5547] Further metrics tweaking

---
 .../HUD/HitErrorMeters/BarHitErrorMeter.cs    | 34 +++++++++----------
 1 file changed, 17 insertions(+), 17 deletions(-)

diff --git a/osu.Game/Screens/Play/HUD/HitErrorMeters/BarHitErrorMeter.cs b/osu.Game/Screens/Play/HUD/HitErrorMeters/BarHitErrorMeter.cs
index 521d8c01b1..542731cf93 100644
--- a/osu.Game/Screens/Play/HUD/HitErrorMeters/BarHitErrorMeter.cs
+++ b/osu.Game/Screens/Play/HUD/HitErrorMeters/BarHitErrorMeter.cs
@@ -18,8 +18,8 @@ namespace osu.Game.Screens.Play.HUD.HitErrorMeters
 {
     public class BarHitErrorMeter : HitErrorMeter
     {
-        private const int judgement_line_width = 10;
-        private const int judgement_line_height = 3;
+        private const int judgement_line_width = 14;
+        private const int judgement_line_height = 4;
 
         private SpriteIcon arrow;
         private SpriteIcon iconEarly;
@@ -40,7 +40,7 @@ namespace osu.Game.Screens.Play.HUD.HitErrorMeters
         [BackgroundDependencyLoader]
         private void load()
         {
-            const int centre_marker_size = 6;
+            const int centre_marker_size = 8;
             const int bar_height = 200;
             const int bar_width = 2;
             const float chevron_size = 8;
@@ -98,6 +98,14 @@ namespace osu.Game.Screens.Play.HUD.HitErrorMeters
                                 RelativeSizeAxes = Axes.Y,
                                 Height = 0.5f,
                             },
+                            new Circle
+                            {
+                                Name = "middle marker behind",
+                                Colour = GetColourForHitResult(hitWindows.Last().result),
+                                Anchor = Anchor.Centre,
+                                Origin = Anchor.Centre,
+                                Size = new Vector2(centre_marker_size),
+                            },
                             judgementsContainer = new Container
                             {
                                 Name = "judgements",
@@ -107,17 +115,9 @@ namespace osu.Game.Screens.Play.HUD.HitErrorMeters
                                 Width = judgement_line_width,
                             },
                             new Circle
-                            {
-                                Name = "middle marker behind",
-                                Colour = GetColourForHitResult(hitWindows.Last().result),
-                                Anchor = Anchor.Centre,
-                                Origin = Anchor.Centre,
-                                Size = new Vector2(centre_marker_size),
-                            },
-                            new Circle
                             {
                                 Name = "middle marker in front",
-                                Colour = GetColourForHitResult(hitWindows.Last().result).Darken(0.5f),
+                                Colour = GetColourForHitResult(hitWindows.Last().result).Darken(0.3f),
                                 Anchor = Anchor.Centre,
                                 Origin = Anchor.Centre,
                                 Size = new Vector2(centre_marker_size),
@@ -231,7 +231,7 @@ namespace osu.Game.Screens.Play.HUD.HitErrorMeters
 
         protected override void OnNewJudgement(JudgementResult judgement)
         {
-            const int arrow_move_duration = 400;
+            const int arrow_move_duration = 800;
 
             if (!judgement.IsHit || judgement.HitObject.HitWindows?.WindowFor(HitResult.Miss) == 0)
                 return;
@@ -261,7 +261,7 @@ namespace osu.Game.Screens.Play.HUD.HitErrorMeters
 
             arrow.MoveToY(
                 getRelativeJudgementPosition(floatingAverage = floatingAverage * 0.9 + judgement.TimeOffset * 0.1)
-                , arrow_move_duration, Easing.Out);
+                , arrow_move_duration, Easing.OutQuint);
         }
 
         private float getRelativeJudgementPosition(double value) => Math.Clamp((float)((value / maxHitWindow) + 1) / 2, 0, 1);
@@ -296,11 +296,11 @@ namespace osu.Game.Screens.Play.HUD.HitErrorMeters
                 Width = 0;
 
                 this
-                    .FadeTo(0.8f, judgement_fade_in_duration, Easing.OutQuint)
+                    .FadeTo(0.6f, judgement_fade_in_duration, Easing.OutQuint)
                     .ResizeWidthTo(1, judgement_fade_in_duration, Easing.OutQuint)
                     .Then()
-                    .FadeOut(judgement_fade_out_duration, Easing.In)
-                    .ResizeWidthTo(0, judgement_fade_out_duration, Easing.In)
+                    .FadeOut(judgement_fade_out_duration)
+                    .ResizeWidthTo(0, judgement_fade_out_duration, Easing.InQuint)
                     .Expire();
             }
         }

From 6657d93b29e2dbeda325333c674fd53c572b0d66 Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Mon, 14 Mar 2022 20:18:30 +0800
Subject: [PATCH 3413/5547] Separate the two nested classes

---
 .../OsuHitObjectGenerationUtils_Reposition.cs | 45 ++++++++++---------
 1 file changed, 23 insertions(+), 22 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Utils/OsuHitObjectGenerationUtils_Reposition.cs b/osu.Game.Rulesets.Osu/Utils/OsuHitObjectGenerationUtils_Reposition.cs
index 37a12b20b4..94f4f154bd 100644
--- a/osu.Game.Rulesets.Osu/Utils/OsuHitObjectGenerationUtils_Reposition.cs
+++ b/osu.Game.Rulesets.Osu/Utils/OsuHitObjectGenerationUtils_Reposition.cs
@@ -60,12 +60,12 @@ namespace osu.Game.Rulesets.Osu.Utils
         /// <returns>The repositioned hit objects.</returns>
         public static List<OsuHitObject> RepositionHitObjects(IEnumerable<ObjectPositionInfo> objectPositionInfos)
         {
-            List<ObjectPositionInfoInternal> positionInfos = objectPositionInfos.Select(o => new ObjectPositionInfoInternal(o)).ToList();
-            ObjectPositionInfoInternal? previous = null;
+            List<WorkingObject> workingObjects = objectPositionInfos.Select(o => new WorkingObject(o)).ToList();
+            WorkingObject? previous = null;
 
-            for (int i = 0; i < positionInfos.Count; i++)
+            for (int i = 0; i < workingObjects.Count; i++)
             {
-                var current = positionInfos[i];
+                var current = workingObjects[i];
                 var hitObject = current.HitObject;
 
                 if (hitObject is Spinner)
@@ -74,7 +74,7 @@ namespace osu.Game.Rulesets.Osu.Utils
                     continue;
                 }
 
-                computeModifiedPosition(current, previous, i > 1 ? positionInfos[i - 2] : null);
+                computeModifiedPosition(current, previous, i > 1 ? workingObjects[i - 2] : null);
 
                 // Move hit objects back into the playfield if they are outside of it
                 Vector2 shift = Vector2.Zero;
@@ -97,9 +97,9 @@ namespace osu.Game.Rulesets.Osu.Utils
                     for (int j = i - 1; j >= i - preceding_hitobjects_to_shift && j >= 0; j--)
                     {
                         // only shift hit circles
-                        if (!(positionInfos[j].HitObject is HitCircle)) break;
+                        if (!(workingObjects[j].HitObject is HitCircle)) break;
 
-                        toBeShifted.Add(positionInfos[j].HitObject);
+                        toBeShifted.Add(workingObjects[j].HitObject);
                     }
 
                     if (toBeShifted.Count > 0)
@@ -109,16 +109,16 @@ namespace osu.Game.Rulesets.Osu.Utils
                 previous = current;
             }
 
-            return positionInfos.Select(p => p.HitObject).ToList();
+            return workingObjects.Select(p => p.HitObject).ToList();
         }
 
         /// <summary>
         /// Compute the modified position of a hit object while attempting to keep it inside the playfield.
         /// </summary>
-        /// <param name="current">The <see cref="ObjectPositionInfoInternal"/> representing the hit object to have the modified position computed for.</param>
-        /// <param name="previous">The <see cref="ObjectPositionInfoInternal"/> representing the hit object immediately preceding the current one.</param>
-        /// <param name="beforePrevious">The <see cref="ObjectPositionInfoInternal"/> representing the hit object immediately preceding the <paramref name="previous"/> one.</param>
-        private static void computeModifiedPosition(ObjectPositionInfoInternal current, ObjectPositionInfoInternal? previous, ObjectPositionInfoInternal? beforePrevious)
+        /// <param name="current">The <see cref="WorkingObject"/> representing the hit object to have the modified position computed for.</param>
+        /// <param name="previous">The <see cref="WorkingObject"/> representing the hit object immediately preceding the current one.</param>
+        /// <param name="beforePrevious">The <see cref="WorkingObject"/> representing the hit object immediately preceding the <paramref name="previous"/> one.</param>
+        private static void computeModifiedPosition(WorkingObject current, WorkingObject? previous, WorkingObject? beforePrevious)
         {
             float previousAbsoluteAngle = 0f;
 
@@ -129,11 +129,11 @@ namespace osu.Game.Rulesets.Osu.Utils
                 previousAbsoluteAngle = (float)Math.Atan2(relativePosition.Y, relativePosition.X);
             }
 
-            float absoluteAngle = previousAbsoluteAngle + current.RelativeAngle;
+            float absoluteAngle = previousAbsoluteAngle + current.PositionInfo.RelativeAngle;
 
             var posRelativeToPrev = new Vector2(
-                current.DistanceFromPrevious * (float)Math.Cos(absoluteAngle),
-                current.DistanceFromPrevious * (float)Math.Sin(absoluteAngle)
+                current.PositionInfo.DistanceFromPrevious * (float)Math.Cos(absoluteAngle),
+                current.PositionInfo.DistanceFromPrevious * (float)Math.Sin(absoluteAngle)
             );
 
             Vector2 lastEndPosition = previous?.EndPositionModified ?? playfield_centre;
@@ -147,7 +147,7 @@ namespace osu.Game.Rulesets.Osu.Utils
         /// Move the modified position of a hit circle so that it fits inside the playfield.
         /// </summary>
         /// <returns>The deviation from the original modified position in order to fit within the playfield.</returns>
-        private static Vector2 clampHitCircleToPlayfield(HitCircle circle, ObjectPositionInfoInternal objectPositionInfo)
+        private static Vector2 clampHitCircleToPlayfield(HitCircle circle, WorkingObject objectPositionInfo)
         {
             var previousPosition = objectPositionInfo.PositionModified;
             objectPositionInfo.EndPositionModified = objectPositionInfo.PositionModified = clampToPlayfieldWithPadding(
@@ -164,7 +164,7 @@ namespace osu.Game.Rulesets.Osu.Utils
         /// Moves the <see cref="Slider"/> and all necessary nested <see cref="OsuHitObject"/>s into the <see cref="OsuPlayfield"/> if they aren't already.
         /// </summary>
         /// <returns>The deviation from the original modified position in order to fit within the playfield.</returns>
-        private static Vector2 clampSliderToPlayfield(Slider slider, ObjectPositionInfoInternal objectPositionInfo)
+        private static Vector2 clampSliderToPlayfield(Slider slider, WorkingObject objectPositionInfo)
         {
             var possibleMovementBounds = calculatePossibleMovementBounds(slider);
 
@@ -319,17 +319,18 @@ namespace osu.Game.Rulesets.Osu.Utils
             }
         }
 
-        private class ObjectPositionInfoInternal : ObjectPositionInfo
+        private class WorkingObject
         {
             public Vector2 PositionOriginal { get; }
             public Vector2 PositionModified { get; set; }
             public Vector2 EndPositionModified { get; set; }
 
-            public ObjectPositionInfoInternal(ObjectPositionInfo original)
-                : base(original.HitObject)
+            public ObjectPositionInfo PositionInfo { get; }
+            public OsuHitObject HitObject => PositionInfo.HitObject;
+
+            public WorkingObject(ObjectPositionInfo positionInfo)
             {
-                RelativeAngle = original.RelativeAngle;
-                DistanceFromPrevious = original.DistanceFromPrevious;
+                PositionInfo = positionInfo;
                 PositionModified = PositionOriginal = HitObject.Position;
                 EndPositionModified = HitObject.EndPosition;
             }

From 76021c76278cf3a91a6f38e6b9b047a93f5dadad Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Mon, 14 Mar 2022 20:23:35 +0800
Subject: [PATCH 3414/5547] Remove extra parameters

---
 .../OsuHitObjectGenerationUtils_Reposition.cs | 41 ++++++++++---------
 1 file changed, 21 insertions(+), 20 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Utils/OsuHitObjectGenerationUtils_Reposition.cs b/osu.Game.Rulesets.Osu/Utils/OsuHitObjectGenerationUtils_Reposition.cs
index 94f4f154bd..d1bc3b45df 100644
--- a/osu.Game.Rulesets.Osu/Utils/OsuHitObjectGenerationUtils_Reposition.cs
+++ b/osu.Game.Rulesets.Osu/Utils/OsuHitObjectGenerationUtils_Reposition.cs
@@ -81,12 +81,12 @@ namespace osu.Game.Rulesets.Osu.Utils
 
                 switch (hitObject)
                 {
-                    case HitCircle circle:
-                        shift = clampHitCircleToPlayfield(circle, current);
+                    case HitCircle _:
+                        shift = clampHitCircleToPlayfield(current);
                         break;
 
-                    case Slider slider:
-                        shift = clampSliderToPlayfield(slider, current);
+                    case Slider _:
+                        shift = clampSliderToPlayfield(current);
                         break;
                 }
 
@@ -144,48 +144,49 @@ namespace osu.Game.Rulesets.Osu.Utils
         }
 
         /// <summary>
-        /// Move the modified position of a hit circle so that it fits inside the playfield.
+        /// Move the modified position of a <see cref="HitCircle"/> so that it fits inside the playfield.
         /// </summary>
         /// <returns>The deviation from the original modified position in order to fit within the playfield.</returns>
-        private static Vector2 clampHitCircleToPlayfield(HitCircle circle, WorkingObject objectPositionInfo)
+        private static Vector2 clampHitCircleToPlayfield(WorkingObject workingObject)
         {
-            var previousPosition = objectPositionInfo.PositionModified;
-            objectPositionInfo.EndPositionModified = objectPositionInfo.PositionModified = clampToPlayfieldWithPadding(
-                objectPositionInfo.PositionModified,
-                (float)circle.Radius
+            var previousPosition = workingObject.PositionModified;
+            workingObject.EndPositionModified = workingObject.PositionModified = clampToPlayfieldWithPadding(
+                workingObject.PositionModified,
+                (float)workingObject.HitObject.Radius
             );
 
-            circle.Position = objectPositionInfo.PositionModified;
+            workingObject.HitObject.Position = workingObject.PositionModified;
 
-            return objectPositionInfo.PositionModified - previousPosition;
+            return workingObject.PositionModified - previousPosition;
         }
 
         /// <summary>
         /// Moves the <see cref="Slider"/> and all necessary nested <see cref="OsuHitObject"/>s into the <see cref="OsuPlayfield"/> if they aren't already.
         /// </summary>
         /// <returns>The deviation from the original modified position in order to fit within the playfield.</returns>
-        private static Vector2 clampSliderToPlayfield(Slider slider, WorkingObject objectPositionInfo)
+        private static Vector2 clampSliderToPlayfield(WorkingObject workingObject)
         {
+            var slider = (Slider)workingObject.HitObject;
             var possibleMovementBounds = calculatePossibleMovementBounds(slider);
 
-            var previousPosition = objectPositionInfo.PositionModified;
+            var previousPosition = workingObject.PositionModified;
 
             // Clamp slider position to the placement area
             // If the slider is larger than the playfield, force it to stay at the original position
             float newX = possibleMovementBounds.Width < 0
-                ? objectPositionInfo.PositionOriginal.X
+                ? workingObject.PositionOriginal.X
                 : Math.Clamp(previousPosition.X, possibleMovementBounds.Left, possibleMovementBounds.Right);
 
             float newY = possibleMovementBounds.Height < 0
-                ? objectPositionInfo.PositionOriginal.Y
+                ? workingObject.PositionOriginal.Y
                 : Math.Clamp(previousPosition.Y, possibleMovementBounds.Top, possibleMovementBounds.Bottom);
 
-            slider.Position = objectPositionInfo.PositionModified = new Vector2(newX, newY);
-            objectPositionInfo.EndPositionModified = slider.EndPosition;
+            slider.Position = workingObject.PositionModified = new Vector2(newX, newY);
+            workingObject.EndPositionModified = slider.EndPosition;
 
-            shiftNestedObjects(slider, objectPositionInfo.PositionModified - objectPositionInfo.PositionOriginal);
+            shiftNestedObjects(slider, workingObject.PositionModified - workingObject.PositionOriginal);
 
-            return objectPositionInfo.PositionModified - previousPosition;
+            return workingObject.PositionModified - previousPosition;
         }
 
         /// <summary>

From 8fdf2b13ac2d83b206d88940e7582ae80c91a645 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 14 Mar 2022 22:23:50 +0900
Subject: [PATCH 3415/5547] Update framework

---
 osu.Android.props        | 2 +-
 osu.Game/osu.Game.csproj | 2 +-
 osu.iOS.props            | 4 ++--
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Android.props b/osu.Android.props
index 839f7882bf..1b5461959a 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -52,7 +52,7 @@
   </ItemGroup>
   <ItemGroup>
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.304.0" />
-    <PackageReference Include="ppy.osu.Framework.Android" Version="2022.308.0" />
+    <PackageReference Include="ppy.osu.Framework.Android" Version="2022.314.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
     <!-- Realm needs to be directly referenced in all Xamarin projects, as it will not pull in its transitive dependencies otherwise. -->
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index c106c373c4..5e194e2aca 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="10.10.0" />
-    <PackageReference Include="ppy.osu.Framework" Version="2022.308.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2022.314.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.304.0" />
     <PackageReference Include="Sentry" Version="3.14.1" />
     <PackageReference Include="SharpCompress" Version="0.30.1" />
diff --git a/osu.iOS.props b/osu.iOS.props
index 86cf1b229c..23101c5af6 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -61,7 +61,7 @@
     <Reference Include="System.Net.Http" />
   </ItemGroup>
   <ItemGroup Label="Package References">
-    <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.308.0" />
+    <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.314.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.304.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net6.0) -->
@@ -84,7 +84,7 @@
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="5.0.14" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.Core" Version="5.0.14" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
-    <PackageReference Include="ppy.osu.Framework" Version="2022.308.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2022.314.0" />
     <PackageReference Include="SharpCompress" Version="0.30.1" />
     <PackageReference Include="NUnit" Version="3.13.2" />
     <PackageReference Include="System.ComponentModel.Annotations" Version="5.0.0" />

From 39c30516d0874b025d3e8e0610bd6ab096ebd2a6 Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Mon, 14 Mar 2022 18:31:13 +0000
Subject: [PATCH 3416/5547] Implement `ChannelControlItem` for new chat design

Adds new component `ChannelControlItem` and it's child components to be
used as the clickable control in the new chat sidebar for joined
channels.

Has public properties `HasUnread` and `MentionCount` to control the
display of the channel having unread messages or mentions of the user.

Channel select/join requests are exposed via `OnRequestSelect` and
`OnRequestLeave` events respectively which should be handled by a parent
component.

Requires a cached `Bindable<Channel>` instance to be managed by a parent
component.

Requires a cached `OveralayColourScheme` instance to be provided by a
parent component.
---
 .../Online/TestSceneChannelControlItem.cs     | 145 +++++++++++++++
 .../Chat/ChannelControl/ControlItem.cs        | 167 ++++++++++++++++++
 .../Chat/ChannelControl/ControlItemAvatar.cs  |  60 +++++++
 .../Chat/ChannelControl/ControlItemClose.cs   |  55 ++++++
 .../Chat/ChannelControl/ControlItemMention.cs |  77 ++++++++
 .../Chat/ChannelControl/ControlItemText.cs    |  71 ++++++++
 6 files changed, 575 insertions(+)
 create mode 100644 osu.Game.Tests/Visual/Online/TestSceneChannelControlItem.cs
 create mode 100644 osu.Game/Overlays/Chat/ChannelControl/ControlItem.cs
 create mode 100644 osu.Game/Overlays/Chat/ChannelControl/ControlItemAvatar.cs
 create mode 100644 osu.Game/Overlays/Chat/ChannelControl/ControlItemClose.cs
 create mode 100644 osu.Game/Overlays/Chat/ChannelControl/ControlItemMention.cs
 create mode 100644 osu.Game/Overlays/Chat/ChannelControl/ControlItemText.cs

diff --git a/osu.Game.Tests/Visual/Online/TestSceneChannelControlItem.cs b/osu.Game.Tests/Visual/Online/TestSceneChannelControlItem.cs
new file mode 100644
index 0000000000..a1431f696b
--- /dev/null
+++ b/osu.Game.Tests/Visual/Online/TestSceneChannelControlItem.cs
@@ -0,0 +1,145 @@
+// 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 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.Game.Graphics.Sprites;
+using osu.Game.Online.API.Requests.Responses;
+using osu.Game.Online.Chat;
+using osu.Game.Overlays;
+using osu.Game.Overlays.Chat.ChannelControl;
+using osuTK;
+
+namespace osu.Game.Tests.Visual.Online
+{
+    [TestFixture]
+    public class TestSceneChannelControlItem : OsuTestScene
+    {
+        [Cached]
+        private readonly OverlayColourProvider colourProvider = new OverlayColourProvider(OverlayColourScheme.Pink);
+
+        [Cached]
+        private readonly Bindable<Channel> selected = new Bindable<Channel>();
+
+        private static List<Channel> channels = new List<Channel>
+        {
+            createPublicChannel("#public-channel"),
+            createPublicChannel("#public-channel-long-name"),
+            createPrivateChannel("test user", 2),
+            createPrivateChannel("test user long name", 3),
+        };
+
+        private readonly Dictionary<Channel, ControlItem> channelMap = new Dictionary<Channel, ControlItem>();
+
+        private FillFlowContainer flow;
+        private OsuSpriteText selectedText;
+        private OsuSpriteText leaveText;
+
+        [SetUp]
+        public void SetUp()
+        {
+            Schedule(() =>
+            {
+                Children = new Drawable[]
+                {
+                    selectedText = new OsuSpriteText
+                    {
+                        Anchor = Anchor.Centre,
+                        Origin = Anchor.Centre,
+                        Y = -140,
+                    },
+                    leaveText = new OsuSpriteText
+                    {
+                        Anchor = Anchor.Centre,
+                        Origin = Anchor.Centre,
+                        Y = -120,
+                    },
+                    new Container
+                    {
+                        Anchor = Anchor.Centre,
+                        Origin = Anchor.Centre,
+                        Size = new Vector2(190, 200),
+                        Children = new Drawable[]
+                        {
+                            new Box
+                            {
+                                RelativeSizeAxes = Axes.Both,
+                                Colour = colourProvider.Background6,
+                            },
+                            flow = new FillFlowContainer
+                            {
+                                Spacing = new Vector2(20),
+                                RelativeSizeAxes = Axes.Both,
+                            },
+                        },
+                    },
+                };
+
+                selected.BindValueChanged(change =>
+                {
+                    selectedText.Text = $"Selected Channel: {change.NewValue?.Name ?? "[null]"}";
+                }, true);
+
+                foreach (var channel in channels)
+                {
+                    var item = new ControlItem(channel);
+                    flow.Add(item);
+                    channelMap.Add(channel, item);
+                    item.OnRequestSelect += channel => selected.Value = channel;
+                    item.OnRequestLeave += leaveChannel;
+                }
+            });
+        }
+
+        [Test]
+        public void TestVisual()
+        {
+            AddStep("Unread Selected", () =>
+            {
+                if (selected.Value != null)
+                    channelMap[selected.Value].HasUnread = true;
+            });
+
+            AddStep("Read Selected", () =>
+            {
+                if (selected.Value != null)
+                    channelMap[selected.Value].HasUnread = false;
+            });
+
+            AddStep("Add Mention Selected", () =>
+            {
+                if (selected.Value != null)
+                    channelMap[selected.Value].MentionCount++;
+            });
+
+            AddStep("Add 98 Mentions Selected", () =>
+            {
+                if (selected.Value != null)
+                    channelMap[selected.Value].MentionCount += 98;
+            });
+
+            AddStep("Clear Mentions Selected", () =>
+            {
+                if (selected.Value != null)
+                    channelMap[selected.Value].MentionCount = 0;
+            });
+        }
+
+        private void leaveChannel(Channel channel)
+        {
+            leaveText.Text = $"OnRequestLeave: {channel.Name}";
+            leaveText.FadeIn().Then().FadeOut(1000, Easing.InQuint);
+        }
+
+        private static Channel createPublicChannel(string name) =>
+            new Channel { Name = name, Type = ChannelType.Public, Id = 1234 };
+
+        private static Channel createPrivateChannel(string username, int id)
+            => new Channel(new APIUser { Id = id, Username = username });
+    }
+}
diff --git a/osu.Game/Overlays/Chat/ChannelControl/ControlItem.cs b/osu.Game/Overlays/Chat/ChannelControl/ControlItem.cs
new file mode 100644
index 0000000000..559f75f198
--- /dev/null
+++ b/osu.Game/Overlays/Chat/ChannelControl/ControlItem.cs
@@ -0,0 +1,167 @@
+// 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 enable
+
+using System;
+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.Graphics.Containers;
+using osu.Game.Online.Chat;
+
+namespace osu.Game.Overlays.Chat.ChannelControl
+{
+    public class ControlItem : OsuClickableContainer
+    {
+        public event Action<Channel>? OnRequestSelect;
+        public event Action<Channel>? OnRequestLeave;
+
+        public int MentionCount
+        {
+            get => mention?.MentionCount ?? 0;
+            set
+            {
+                if (mention != null)
+                    mention.MentionCount = value;
+            }
+        }
+
+        public bool HasUnread
+        {
+            get => text?.HasUnread ?? false;
+            set
+            {
+                if (text != null)
+                    text.HasUnread = value;
+            }
+        }
+
+        private Box? hoverBox;
+        private Box? selectBox;
+        private ControlItemText? text;
+        private ControlItemMention? mention;
+        private ControlItemClose? close;
+
+        [Resolved]
+        private Bindable<Channel>? selectedChannel { get; set; }
+
+        [Resolved]
+        private OverlayColourProvider? colourProvider { get; set; }
+
+        private readonly Channel channel;
+
+        public ControlItem(Channel channel)
+        {
+            this.channel = channel;
+        }
+
+        [BackgroundDependencyLoader]
+        private void load()
+        {
+            Height = 30;
+            RelativeSizeAxes = Axes.X;
+
+            Children = new Drawable[]
+            {
+                hoverBox = new Box
+                {
+                    RelativeSizeAxes = Axes.Both,
+                    Colour = colourProvider!.Background3,
+                    Alpha = 0f,
+                },
+                selectBox = new Box
+                {
+                    RelativeSizeAxes = Axes.Both,
+                    Colour = colourProvider!.Background4,
+                    Alpha = 0f,
+                },
+                new Container
+                {
+                    RelativeSizeAxes = Axes.Both,
+                    Padding = new MarginPadding { Left = 18, Right = 5 },
+                    Child = new GridContainer
+                    {
+                        RelativeSizeAxes = Axes.Both,
+                        ColumnDimensions = new[]
+                        {
+                            new Dimension(GridSizeMode.AutoSize),
+                            new Dimension(),
+                            new Dimension(GridSizeMode.AutoSize),
+                            new Dimension(GridSizeMode.AutoSize),
+                        },
+                        Content = new[]
+                        {
+                            new Drawable[]
+                            {
+                                createAvatar(),
+                                text = new ControlItemText(channel)
+                                {
+                                    Anchor = Anchor.CentreLeft,
+                                    Origin = Anchor.CentreLeft,
+                                },
+                                mention = new ControlItemMention
+                                {
+                                    Anchor = Anchor.CentreLeft,
+                                    Origin = Anchor.CentreLeft,
+                                    Margin = new MarginPadding { Right = 3 },
+                                },
+                                close = new ControlItemClose
+                                {
+                                    Anchor = Anchor.CentreLeft,
+                                    Origin = Anchor.CentreLeft,
+                                    Margin = new MarginPadding { Right = 3 },
+                                }
+                            }
+                        },
+                    },
+                },
+            };
+        }
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            selectedChannel?.BindValueChanged(change =>
+            {
+                if (change.NewValue == channel)
+                    selectBox?.Show();
+                else
+                    selectBox?.Hide();
+            }, true);
+
+            Action = () => OnRequestSelect?.Invoke(channel);
+            close!.Action = () => OnRequestLeave?.Invoke(channel);
+        }
+
+        protected override bool OnHover(HoverEvent e)
+        {
+            hoverBox?.Show();
+            close?.Show();
+            return base.OnHover(e);
+        }
+
+        protected override void OnHoverLost(HoverLostEvent e)
+        {
+            hoverBox?.Hide();
+            close?.Hide();
+            base.OnHoverLost(e);
+        }
+
+        private Drawable createAvatar()
+        {
+            if (channel.Type != ChannelType.PM)
+                return Drawable.Empty();
+
+            return new ControlItemAvatar(channel)
+            {
+                Anchor = Anchor.CentreLeft,
+                Origin = Anchor.CentreLeft,
+            };
+        }
+    }
+}
diff --git a/osu.Game/Overlays/Chat/ChannelControl/ControlItemAvatar.cs b/osu.Game/Overlays/Chat/ChannelControl/ControlItemAvatar.cs
new file mode 100644
index 0000000000..9192f20cb1
--- /dev/null
+++ b/osu.Game/Overlays/Chat/ChannelControl/ControlItemAvatar.cs
@@ -0,0 +1,60 @@
+// 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 enable
+
+using System.Linq;
+using osu.Framework.Allocation;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.Sprites;
+using osu.Game.Online.Chat;
+using osu.Game.Users.Drawables;
+using osuTK;
+
+namespace osu.Game.Overlays.Chat.ChannelControl
+{
+    public class ControlItemAvatar : CircularContainer
+    {
+        private DrawableAvatar? avatar;
+        private readonly Channel channel;
+
+        public ControlItemAvatar(Channel channel)
+        {
+            this.channel = channel;
+        }
+
+        [BackgroundDependencyLoader]
+        private void load()
+        {
+            Size = new Vector2(20);
+            Margin = new MarginPadding { Right = 5 };
+            Masking = true;
+
+            Children = new Drawable[]
+            {
+                new SpriteIcon
+                {
+                    Icon = FontAwesome.Solid.At,
+                    Anchor = Anchor.Centre,
+                    Origin = Anchor.Centre,
+                    Colour = Colour4.Black,
+                    RelativeSizeAxes = Axes.Both,
+                    Alpha = 0.2f,
+                },
+                new DelayedLoadWrapper(avatar = new DrawableAvatar(channel.Users.First())
+                {
+                    RelativeSizeAxes = Axes.Both,
+                    Anchor = Anchor.Centre,
+                    Origin = Anchor.Centre,
+                }),
+            };
+        }
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+            avatar!.OnLoadComplete += d => d.FadeInFromZero(300, Easing.OutQuint);
+        }
+    }
+}
diff --git a/osu.Game/Overlays/Chat/ChannelControl/ControlItemClose.cs b/osu.Game/Overlays/Chat/ChannelControl/ControlItemClose.cs
new file mode 100644
index 0000000000..4b190e18fd
--- /dev/null
+++ b/osu.Game/Overlays/Chat/ChannelControl/ControlItemClose.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 osu.Framework.Graphics;
+using osu.Framework.Graphics.Sprites;
+using osu.Framework.Input.Events;
+using osu.Game.Graphics.Containers;
+using osuTK;
+using osuTK.Graphics;
+
+namespace osu.Game.Overlays.Chat.ChannelControl
+{
+    public class ControlItemClose : OsuClickableContainer
+    {
+        private readonly SpriteIcon icon;
+
+        public ControlItemClose()
+        {
+            Alpha = 0f;
+            Size = new Vector2(20);
+            Child = icon = new SpriteIcon
+            {
+                Anchor = Anchor.Centre,
+                Origin = Anchor.Centre,
+                Scale = new Vector2(0.75f),
+                Icon = FontAwesome.Solid.TimesCircle,
+                RelativeSizeAxes = Axes.Both,
+            };
+        }
+
+        protected override bool OnMouseDown(MouseDownEvent e)
+        {
+            icon.ScaleTo(0.5f, 1000, Easing.OutQuint);
+            return base.OnMouseDown(e);
+        }
+
+        protected override void OnMouseUp(MouseUpEvent e)
+        {
+            icon.ScaleTo(0.75f, 1000, Easing.OutElastic);
+            base.OnMouseUp(e);
+        }
+
+        protected override bool OnHover(HoverEvent e)
+        {
+            icon.FadeColour(Color4.Red, 200, Easing.OutQuint);
+            return base.OnHover(e);
+        }
+
+        protected override void OnHoverLost(HoverLostEvent e)
+        {
+            icon.FadeColour(Color4.White, 200, Easing.OutQuint);
+            base.OnHoverLost(e);
+        }
+    }
+}
diff --git a/osu.Game/Overlays/Chat/ChannelControl/ControlItemMention.cs b/osu.Game/Overlays/Chat/ChannelControl/ControlItemMention.cs
new file mode 100644
index 0000000000..12de154faa
--- /dev/null
+++ b/osu.Game/Overlays/Chat/ChannelControl/ControlItemMention.cs
@@ -0,0 +1,77 @@
+// 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 enable
+
+using osu.Framework.Allocation;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.Shapes;
+using osu.Game.Graphics;
+using osu.Game.Graphics.Sprites;
+using osuTK;
+
+namespace osu.Game.Overlays.Chat.ChannelControl
+{
+    public class ControlItemMention : CircularContainer
+    {
+        private int mentionCount = 0;
+        public int MentionCount
+        {
+            get => mentionCount;
+            set
+            {
+                if (value == mentionCount)
+                    return;
+
+                mentionCount = value;
+                updateText();
+            }
+        }
+
+        private OsuSpriteText? countText;
+
+        [Resolved]
+        private OverlayColourProvider? colourProvider { get; set; }
+
+        [BackgroundDependencyLoader]
+        private void load()
+        {
+            Masking = true;
+            Size = new Vector2(20, 12);
+            Alpha = 0f;
+
+            Children = new Drawable[]
+            {
+                new Box
+                {
+                    RelativeSizeAxes = Axes.Both,
+                    Colour = colourProvider!.Colour1,
+                },
+                countText = new OsuSpriteText
+                {
+                    Anchor = Anchor.Centre,
+                    Origin = Anchor.Centre,
+                    Font = OsuFont.Torus.With(size: 11, weight: FontWeight.Bold),
+                    Margin = new MarginPadding { Bottom = 1 },
+                    Colour = colourProvider.Background5,
+                },
+            };
+
+            updateText();
+        }
+
+        private void updateText()
+        {
+            if (mentionCount > 99)
+                countText!.Text = "99+";
+            else
+                countText!.Text = mentionCount.ToString();
+
+            if (mentionCount > 0)
+                this.Show();
+            else
+                this.Hide();
+        }
+    }
+}
diff --git a/osu.Game/Overlays/Chat/ChannelControl/ControlItemText.cs b/osu.Game/Overlays/Chat/ChannelControl/ControlItemText.cs
new file mode 100644
index 0000000000..2b8f50e184
--- /dev/null
+++ b/osu.Game/Overlays/Chat/ChannelControl/ControlItemText.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.
+
+#nullable enable
+
+using osu.Framework.Allocation;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
+using osu.Game.Graphics;
+using osu.Game.Graphics.Sprites;
+using osu.Game.Online.Chat;
+
+namespace osu.Game.Overlays.Chat.ChannelControl
+{
+    public class ControlItemText : Container
+    {
+        public bool HasUnread
+        {
+            get => hasUnread;
+            set
+            {
+                if (hasUnread == value)
+                    return;
+
+                hasUnread = value;
+                updateText();
+            }
+        }
+
+        private bool hasUnread = false;
+        private OsuSpriteText? text;
+
+        [Resolved]
+        private OverlayColourProvider? colourProvider { get; set; }
+
+        private readonly Channel channel;
+
+        public ControlItemText(Channel channel)
+        {
+            this.channel = channel;
+        }
+
+        [BackgroundDependencyLoader]
+        private void load()
+        {
+            RelativeSizeAxes = Axes.Both;
+            Child = text = new OsuSpriteText
+            {
+                Anchor = Anchor.CentreLeft,
+                Origin = Anchor.CentreLeft,
+                Text = channel.Type == ChannelType.Public ? $"# {channel.Name.Substring(1)}" : channel.Name,
+                Font = OsuFont.Torus.With(size: 17, weight: FontWeight.SemiBold),
+                Colour = colourProvider!.Light3,
+                Margin = new MarginPadding { Bottom = 2 },
+                RelativeSizeAxes = Axes.X,
+                Truncate = true,
+            };
+        }
+
+        private void updateText()
+        {
+            if (!IsLoaded)
+                return;
+
+            if (HasUnread)
+                text!.Colour = Colour4.White;
+            else
+                text!.Colour = colourProvider!.Light3;
+        }
+    }
+}

From c0d82dfb41478a97e633a60fe847930bf85bf7ca Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Mon, 14 Mar 2022 19:42:55 +0000
Subject: [PATCH 3417/5547] Code quality fixes

---
 .../Visual/Online/TestSceneChannelControlItem.cs     |  4 ++--
 osu.Game/Overlays/Chat/ChannelControl/ControlItem.cs |  2 +-
 .../Chat/ChannelControl/ControlItemMention.cs        | 12 +++++-------
 .../Overlays/Chat/ChannelControl/ControlItemText.cs  |  3 ++-
 4 files changed, 10 insertions(+), 11 deletions(-)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneChannelControlItem.cs b/osu.Game.Tests/Visual/Online/TestSceneChannelControlItem.cs
index a1431f696b..64ad924ecb 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneChannelControlItem.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneChannelControlItem.cs
@@ -26,7 +26,7 @@ namespace osu.Game.Tests.Visual.Online
         [Cached]
         private readonly Bindable<Channel> selected = new Bindable<Channel>();
 
-        private static List<Channel> channels = new List<Channel>
+        private static readonly List<Channel> channels = new List<Channel>
         {
             createPublicChannel("#public-channel"),
             createPublicChannel("#public-channel-long-name"),
@@ -90,7 +90,7 @@ namespace osu.Game.Tests.Visual.Online
                     var item = new ControlItem(channel);
                     flow.Add(item);
                     channelMap.Add(channel, item);
-                    item.OnRequestSelect += channel => selected.Value = channel;
+                    item.OnRequestSelect += c => selected.Value = c;
                     item.OnRequestLeave += leaveChannel;
                 }
             });
diff --git a/osu.Game/Overlays/Chat/ChannelControl/ControlItem.cs b/osu.Game/Overlays/Chat/ChannelControl/ControlItem.cs
index 559f75f198..e475ac7821 100644
--- a/osu.Game/Overlays/Chat/ChannelControl/ControlItem.cs
+++ b/osu.Game/Overlays/Chat/ChannelControl/ControlItem.cs
@@ -95,7 +95,7 @@ namespace osu.Game.Overlays.Chat.ChannelControl
                         },
                         Content = new[]
                         {
-                            new Drawable[]
+                            new[]
                             {
                                 createAvatar(),
                                 text = new ControlItemText(channel)
diff --git a/osu.Game/Overlays/Chat/ChannelControl/ControlItemMention.cs b/osu.Game/Overlays/Chat/ChannelControl/ControlItemMention.cs
index 12de154faa..6af2e26af8 100644
--- a/osu.Game/Overlays/Chat/ChannelControl/ControlItemMention.cs
+++ b/osu.Game/Overlays/Chat/ChannelControl/ControlItemMention.cs
@@ -15,7 +15,8 @@ namespace osu.Game.Overlays.Chat.ChannelControl
 {
     public class ControlItemMention : CircularContainer
     {
-        private int mentionCount = 0;
+        private int mentionCount;
+
         public int MentionCount
         {
             get => mentionCount;
@@ -63,15 +64,12 @@ namespace osu.Game.Overlays.Chat.ChannelControl
 
         private void updateText()
         {
-            if (mentionCount > 99)
-                countText!.Text = "99+";
-            else
-                countText!.Text = mentionCount.ToString();
+            countText!.Text = MentionCount > 99 ? "99+" : MentionCount.ToString();
 
             if (mentionCount > 0)
-                this.Show();
+                Show();
             else
-                this.Hide();
+                Hide();
         }
     }
 }
diff --git a/osu.Game/Overlays/Chat/ChannelControl/ControlItemText.cs b/osu.Game/Overlays/Chat/ChannelControl/ControlItemText.cs
index 2b8f50e184..bb88d733d4 100644
--- a/osu.Game/Overlays/Chat/ChannelControl/ControlItemText.cs
+++ b/osu.Game/Overlays/Chat/ChannelControl/ControlItemText.cs
@@ -14,6 +14,8 @@ namespace osu.Game.Overlays.Chat.ChannelControl
 {
     public class ControlItemText : Container
     {
+        private bool hasUnread;
+
         public bool HasUnread
         {
             get => hasUnread;
@@ -27,7 +29,6 @@ namespace osu.Game.Overlays.Chat.ChannelControl
             }
         }
 
-        private bool hasUnread = false;
         private OsuSpriteText? text;
 
         [Resolved]

From e9f0ad33efca61ccbbb0a09c14f88615d3e2f819 Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Mon, 14 Mar 2022 20:06:31 +0000
Subject: [PATCH 3418/5547] Use autosizing for ChannelControlItem test scene

---
 .../Online/TestSceneChannelControlItem.cs     | 63 +++++++++++--------
 1 file changed, 37 insertions(+), 26 deletions(-)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneChannelControlItem.cs b/osu.Game.Tests/Visual/Online/TestSceneChannelControlItem.cs
index 64ad924ecb..7f76dca013 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneChannelControlItem.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneChannelControlItem.cs
@@ -45,36 +45,47 @@ namespace osu.Game.Tests.Visual.Online
         {
             Schedule(() =>
             {
-                Children = new Drawable[]
+                Child = new FillFlowContainer
                 {
-                    selectedText = new OsuSpriteText
+                    Direction = FillDirection.Vertical,
+                    Anchor = Anchor.Centre,
+                    Origin = Anchor.Centre,
+                    AutoSizeAxes = Axes.Both,
+                    Spacing = new Vector2(10),
+                    Children = new Drawable[]
                     {
-                        Anchor = Anchor.Centre,
-                        Origin = Anchor.Centre,
-                        Y = -140,
-                    },
-                    leaveText = new OsuSpriteText
-                    {
-                        Anchor = Anchor.Centre,
-                        Origin = Anchor.Centre,
-                        Y = -120,
-                    },
-                    new Container
-                    {
-                        Anchor = Anchor.Centre,
-                        Origin = Anchor.Centre,
-                        Size = new Vector2(190, 200),
-                        Children = new Drawable[]
+                        selectedText = new OsuSpriteText
                         {
-                            new Box
+                            Anchor = Anchor.TopCentre,
+                            Origin = Anchor.TopCentre,
+                        },
+                        leaveText = new OsuSpriteText
+                        {
+                            Anchor = Anchor.TopCentre,
+                            Origin = Anchor.TopCentre,
+                            Height = 16,
+                            AlwaysPresent = true,
+                        },
+                        new Container
+                        {
+                            Anchor = Anchor.TopCentre,
+                            Origin = Anchor.TopCentre,
+                            AutoSizeAxes = Axes.Y,
+                            Width = 190,
+                            Children = new Drawable[]
                             {
-                                RelativeSizeAxes = Axes.Both,
-                                Colour = colourProvider.Background6,
-                            },
-                            flow = new FillFlowContainer
-                            {
-                                Spacing = new Vector2(20),
-                                RelativeSizeAxes = Axes.Both,
+                                new Box
+                                {
+                                    RelativeSizeAxes = Axes.Both,
+                                    Colour = colourProvider.Background6,
+                                },
+                                flow = new FillFlowContainer
+                                {
+                                    Direction = FillDirection.Vertical,
+                                    Spacing = new Vector2(20),
+                                    RelativeSizeAxes = Axes.X,
+                                    AutoSizeAxes = Axes.Y,
+                                },
                             },
                         },
                     },

From 12472593cc4f2c7b36a8682c7d63d17315e7a9cf Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Mon, 14 Mar 2022 20:14:04 +0000
Subject: [PATCH 3419/5547] Mark required dependencies as non-nullable

---
 .../Overlays/Chat/ChannelControl/ControlItem.cs    | 14 +++++++-------
 .../Chat/ChannelControl/ControlItemAvatar.cs       |  3 ++-
 .../Chat/ChannelControl/ControlItemMention.cs      |  4 ++--
 .../Chat/ChannelControl/ControlItemText.cs         |  8 ++++----
 4 files changed, 15 insertions(+), 14 deletions(-)

diff --git a/osu.Game/Overlays/Chat/ChannelControl/ControlItem.cs b/osu.Game/Overlays/Chat/ChannelControl/ControlItem.cs
index e475ac7821..073173f2ff 100644
--- a/osu.Game/Overlays/Chat/ChannelControl/ControlItem.cs
+++ b/osu.Game/Overlays/Chat/ChannelControl/ControlItem.cs
@@ -40,6 +40,8 @@ namespace osu.Game.Overlays.Chat.ChannelControl
             }
         }
 
+        private readonly Channel channel;
+
         private Box? hoverBox;
         private Box? selectBox;
         private ControlItemText? text;
@@ -47,12 +49,10 @@ namespace osu.Game.Overlays.Chat.ChannelControl
         private ControlItemClose? close;
 
         [Resolved]
-        private Bindable<Channel>? selectedChannel { get; set; }
+        private Bindable<Channel> selectedChannel { get; set; } = null!;
 
         [Resolved]
-        private OverlayColourProvider? colourProvider { get; set; }
-
-        private readonly Channel channel;
+        private OverlayColourProvider colourProvider { get; set; } = null!;
 
         public ControlItem(Channel channel)
         {
@@ -70,13 +70,13 @@ namespace osu.Game.Overlays.Chat.ChannelControl
                 hoverBox = new Box
                 {
                     RelativeSizeAxes = Axes.Both,
-                    Colour = colourProvider!.Background3,
+                    Colour = colourProvider.Background3,
                     Alpha = 0f,
                 },
                 selectBox = new Box
                 {
                     RelativeSizeAxes = Axes.Both,
-                    Colour = colourProvider!.Background4,
+                    Colour = colourProvider.Background4,
                     Alpha = 0f,
                 },
                 new Container
@@ -126,7 +126,7 @@ namespace osu.Game.Overlays.Chat.ChannelControl
         {
             base.LoadComplete();
 
-            selectedChannel?.BindValueChanged(change =>
+            selectedChannel.BindValueChanged(change =>
             {
                 if (change.NewValue == channel)
                     selectBox?.Show();
diff --git a/osu.Game/Overlays/Chat/ChannelControl/ControlItemAvatar.cs b/osu.Game/Overlays/Chat/ChannelControl/ControlItemAvatar.cs
index 9192f20cb1..62b893f3bc 100644
--- a/osu.Game/Overlays/Chat/ChannelControl/ControlItemAvatar.cs
+++ b/osu.Game/Overlays/Chat/ChannelControl/ControlItemAvatar.cs
@@ -16,9 +16,10 @@ namespace osu.Game.Overlays.Chat.ChannelControl
 {
     public class ControlItemAvatar : CircularContainer
     {
-        private DrawableAvatar? avatar;
         private readonly Channel channel;
 
+        private DrawableAvatar? avatar;
+
         public ControlItemAvatar(Channel channel)
         {
             this.channel = channel;
diff --git a/osu.Game/Overlays/Chat/ChannelControl/ControlItemMention.cs b/osu.Game/Overlays/Chat/ChannelControl/ControlItemMention.cs
index 6af2e26af8..693fb68217 100644
--- a/osu.Game/Overlays/Chat/ChannelControl/ControlItemMention.cs
+++ b/osu.Game/Overlays/Chat/ChannelControl/ControlItemMention.cs
@@ -33,7 +33,7 @@ namespace osu.Game.Overlays.Chat.ChannelControl
         private OsuSpriteText? countText;
 
         [Resolved]
-        private OverlayColourProvider? colourProvider { get; set; }
+        private OverlayColourProvider colourProvider { get; set; } = null!;
 
         [BackgroundDependencyLoader]
         private void load()
@@ -47,7 +47,7 @@ namespace osu.Game.Overlays.Chat.ChannelControl
                 new Box
                 {
                     RelativeSizeAxes = Axes.Both,
-                    Colour = colourProvider!.Colour1,
+                    Colour = colourProvider.Colour1,
                 },
                 countText = new OsuSpriteText
                 {
diff --git a/osu.Game/Overlays/Chat/ChannelControl/ControlItemText.cs b/osu.Game/Overlays/Chat/ChannelControl/ControlItemText.cs
index bb88d733d4..9b0f5011fc 100644
--- a/osu.Game/Overlays/Chat/ChannelControl/ControlItemText.cs
+++ b/osu.Game/Overlays/Chat/ChannelControl/ControlItemText.cs
@@ -29,12 +29,12 @@ namespace osu.Game.Overlays.Chat.ChannelControl
             }
         }
 
+        private readonly Channel channel;
+
         private OsuSpriteText? text;
 
         [Resolved]
-        private OverlayColourProvider? colourProvider { get; set; }
-
-        private readonly Channel channel;
+        private OverlayColourProvider colourProvider { get; set; } = null!;
 
         public ControlItemText(Channel channel)
         {
@@ -51,7 +51,7 @@ namespace osu.Game.Overlays.Chat.ChannelControl
                 Origin = Anchor.CentreLeft,
                 Text = channel.Type == ChannelType.Public ? $"# {channel.Name.Substring(1)}" : channel.Name,
                 Font = OsuFont.Torus.With(size: 17, weight: FontWeight.SemiBold),
-                Colour = colourProvider!.Light3,
+                Colour = colourProvider.Light3,
                 Margin = new MarginPadding { Bottom = 2 },
                 RelativeSizeAxes = Axes.X,
                 Truncate = true,

From e91af664ef080c250fbfd6997dd5aa1033f502d1 Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Mon, 14 Mar 2022 20:37:54 +0000
Subject: [PATCH 3420/5547] Adjust ControlItemAvatar placeholder animation and
 colour

---
 .../Overlays/Chat/ChannelControl/ControlItemAvatar.cs    | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Overlays/Chat/ChannelControl/ControlItemAvatar.cs b/osu.Game/Overlays/Chat/ChannelControl/ControlItemAvatar.cs
index 62b893f3bc..bb3109ec1f 100644
--- a/osu.Game/Overlays/Chat/ChannelControl/ControlItemAvatar.cs
+++ b/osu.Game/Overlays/Chat/ChannelControl/ControlItemAvatar.cs
@@ -18,6 +18,7 @@ namespace osu.Game.Overlays.Chat.ChannelControl
     {
         private readonly Channel channel;
 
+        private SpriteIcon? placeholder;
         private DrawableAvatar? avatar;
 
         public ControlItemAvatar(Channel channel)
@@ -34,14 +35,14 @@ namespace osu.Game.Overlays.Chat.ChannelControl
 
             Children = new Drawable[]
             {
-                new SpriteIcon
+                placeholder = new SpriteIcon
                 {
                     Icon = FontAwesome.Solid.At,
                     Anchor = Anchor.Centre,
                     Origin = Anchor.Centre,
-                    Colour = Colour4.Black,
+                    Colour = Colour4.White,
                     RelativeSizeAxes = Axes.Both,
-                    Alpha = 0.2f,
+                    Alpha = 0.5f,
                 },
                 new DelayedLoadWrapper(avatar = new DrawableAvatar(channel.Users.First())
                 {
@@ -55,7 +56,7 @@ namespace osu.Game.Overlays.Chat.ChannelControl
         protected override void LoadComplete()
         {
             base.LoadComplete();
-            avatar!.OnLoadComplete += d => d.FadeInFromZero(300, Easing.OutQuint);
+            avatar!.OnLoadComplete += _ => placeholder!.FadeOut(250);
         }
     }
 }

From 9621ef9437ca389fde4295e507d8681ee14ee3bb Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Mon, 14 Mar 2022 21:10:39 +0000
Subject: [PATCH 3421/5547] Use OsuColour.Red1 for ControlItemClose hover
 colour

---
 .../Visual/Online/TestSceneChannelControlItem.cs       |  4 ++++
 .../Overlays/Chat/ChannelControl/ControlItemClose.cs   | 10 +++++++---
 2 files changed, 11 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneChannelControlItem.cs b/osu.Game.Tests/Visual/Online/TestSceneChannelControlItem.cs
index 7f76dca013..9464d244be 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneChannelControlItem.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneChannelControlItem.cs
@@ -8,6 +8,7 @@ using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
+using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Chat;
@@ -23,6 +24,9 @@ namespace osu.Game.Tests.Visual.Online
         [Cached]
         private readonly OverlayColourProvider colourProvider = new OverlayColourProvider(OverlayColourScheme.Pink);
 
+        [Cached]
+        private readonly OsuColour osuColour = new OsuColour();
+
         [Cached]
         private readonly Bindable<Channel> selected = new Bindable<Channel>();
 
diff --git a/osu.Game/Overlays/Chat/ChannelControl/ControlItemClose.cs b/osu.Game/Overlays/Chat/ChannelControl/ControlItemClose.cs
index 4b190e18fd..4730d7b72d 100644
--- a/osu.Game/Overlays/Chat/ChannelControl/ControlItemClose.cs
+++ b/osu.Game/Overlays/Chat/ChannelControl/ControlItemClose.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 osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Input.Events;
+using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osuTK;
-using osuTK.Graphics;
 
 namespace osu.Game.Overlays.Chat.ChannelControl
 {
@@ -14,6 +15,9 @@ namespace osu.Game.Overlays.Chat.ChannelControl
     {
         private readonly SpriteIcon icon;
 
+        [Resolved]
+        private OsuColour osuColour { get; set; } = null!;
+
         public ControlItemClose()
         {
             Alpha = 0f;
@@ -42,13 +46,13 @@ namespace osu.Game.Overlays.Chat.ChannelControl
 
         protected override bool OnHover(HoverEvent e)
         {
-            icon.FadeColour(Color4.Red, 200, Easing.OutQuint);
+            icon.FadeColour(osuColour.Red1, 200, Easing.OutQuint);
             return base.OnHover(e);
         }
 
         protected override void OnHoverLost(HoverLostEvent e)
         {
-            icon.FadeColour(Color4.White, 200, Easing.OutQuint);
+            icon.FadeColour(Colour4.White, 200, Easing.OutQuint);
             base.OnHoverLost(e);
         }
     }

From 3aa343b9870dc3487013151889880f282b29cafe Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Mon, 14 Mar 2022 21:14:33 +0000
Subject: [PATCH 3422/5547] Use OsuColour.YellowLight for ControlItemMention
 background

---
 osu.Game/Overlays/Chat/ChannelControl/ControlItemMention.cs | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/Chat/ChannelControl/ControlItemMention.cs b/osu.Game/Overlays/Chat/ChannelControl/ControlItemMention.cs
index 693fb68217..370c435266 100644
--- a/osu.Game/Overlays/Chat/ChannelControl/ControlItemMention.cs
+++ b/osu.Game/Overlays/Chat/ChannelControl/ControlItemMention.cs
@@ -32,6 +32,9 @@ namespace osu.Game.Overlays.Chat.ChannelControl
 
         private OsuSpriteText? countText;
 
+        [Resolved]
+        private OsuColour osuColour { get; set; } = null!;
+
         [Resolved]
         private OverlayColourProvider colourProvider { get; set; } = null!;
 
@@ -47,7 +50,7 @@ namespace osu.Game.Overlays.Chat.ChannelControl
                 new Box
                 {
                     RelativeSizeAxes = Axes.Both,
-                    Colour = colourProvider.Colour1,
+                    Colour = osuColour.YellowLight,
                 },
                 countText = new OsuSpriteText
                 {

From 1f0f6990f096d15a064eda731bd2dbad876ff786 Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Mon, 14 Mar 2022 21:16:28 +0000
Subject: [PATCH 3423/5547] Use ColourProvider.Content1 for ControlItemText
 colour

---
 osu.Game/Overlays/Chat/ChannelControl/ControlItemText.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Overlays/Chat/ChannelControl/ControlItemText.cs b/osu.Game/Overlays/Chat/ChannelControl/ControlItemText.cs
index 9b0f5011fc..0c91903f6b 100644
--- a/osu.Game/Overlays/Chat/ChannelControl/ControlItemText.cs
+++ b/osu.Game/Overlays/Chat/ChannelControl/ControlItemText.cs
@@ -64,9 +64,9 @@ namespace osu.Game.Overlays.Chat.ChannelControl
                 return;
 
             if (HasUnread)
-                text!.Colour = Colour4.White;
+                text!.Colour = colourProvider.Content1;
             else
-                text!.Colour = colourProvider!.Light3;
+                text!.Colour = colourProvider.Light3;
         }
     }
 }

From b01a809d551efcb342e59046ae087d46309323fe Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Mon, 14 Mar 2022 21:26:33 +0000
Subject: [PATCH 3424/5547] Refactor ControlItemMention to use bindable flow

---
 .../Online/TestSceneChannelControlItem.cs     |  6 +--
 .../Chat/ChannelControl/ControlItem.cs        | 11 +----
 .../Chat/ChannelControl/ControlItemMention.cs | 41 ++++++++-----------
 3 files changed, 23 insertions(+), 35 deletions(-)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneChannelControlItem.cs b/osu.Game.Tests/Visual/Online/TestSceneChannelControlItem.cs
index 9464d244be..2e5c2cc2cb 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneChannelControlItem.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneChannelControlItem.cs
@@ -129,19 +129,19 @@ namespace osu.Game.Tests.Visual.Online
             AddStep("Add Mention Selected", () =>
             {
                 if (selected.Value != null)
-                    channelMap[selected.Value].MentionCount++;
+                    channelMap[selected.Value].Mentions.Value++;
             });
 
             AddStep("Add 98 Mentions Selected", () =>
             {
                 if (selected.Value != null)
-                    channelMap[selected.Value].MentionCount += 98;
+                    channelMap[selected.Value].Mentions.Value += 98;
             });
 
             AddStep("Clear Mentions Selected", () =>
             {
                 if (selected.Value != null)
-                    channelMap[selected.Value].MentionCount = 0;
+                    channelMap[selected.Value].Mentions.Value = 0;
             });
         }
 
diff --git a/osu.Game/Overlays/Chat/ChannelControl/ControlItem.cs b/osu.Game/Overlays/Chat/ChannelControl/ControlItem.cs
index 073173f2ff..d88a99c484 100644
--- a/osu.Game/Overlays/Chat/ChannelControl/ControlItem.cs
+++ b/osu.Game/Overlays/Chat/ChannelControl/ControlItem.cs
@@ -20,15 +20,8 @@ namespace osu.Game.Overlays.Chat.ChannelControl
         public event Action<Channel>? OnRequestSelect;
         public event Action<Channel>? OnRequestLeave;
 
-        public int MentionCount
-        {
-            get => mention?.MentionCount ?? 0;
-            set
-            {
-                if (mention != null)
-                    mention.MentionCount = value;
-            }
-        }
+        [Cached]
+        public readonly BindableInt Mentions = new BindableInt();
 
         public bool HasUnread
         {
diff --git a/osu.Game/Overlays/Chat/ChannelControl/ControlItemMention.cs b/osu.Game/Overlays/Chat/ChannelControl/ControlItemMention.cs
index 370c435266..594a52b8a7 100644
--- a/osu.Game/Overlays/Chat/ChannelControl/ControlItemMention.cs
+++ b/osu.Game/Overlays/Chat/ChannelControl/ControlItemMention.cs
@@ -4,6 +4,7 @@
 #nullable enable
 
 using osu.Framework.Allocation;
+using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
@@ -15,23 +16,11 @@ namespace osu.Game.Overlays.Chat.ChannelControl
 {
     public class ControlItemMention : CircularContainer
     {
-        private int mentionCount;
-
-        public int MentionCount
-        {
-            get => mentionCount;
-            set
-            {
-                if (value == mentionCount)
-                    return;
-
-                mentionCount = value;
-                updateText();
-            }
-        }
-
         private OsuSpriteText? countText;
 
+        [Resolved]
+        private BindableInt mentions { get; set; } = null!;
+
         [Resolved]
         private OsuColour osuColour { get; set; } = null!;
 
@@ -61,18 +50,24 @@ namespace osu.Game.Overlays.Chat.ChannelControl
                     Colour = colourProvider.Background5,
                 },
             };
-
-            updateText();
         }
 
-        private void updateText()
+        protected override void LoadComplete()
         {
-            countText!.Text = MentionCount > 99 ? "99+" : MentionCount.ToString();
+            base.LoadComplete();
 
-            if (mentionCount > 0)
-                Show();
-            else
-                Hide();
+            mentions.BindValueChanged(change =>
+            {
+                int mentionCount = change.NewValue;
+
+                countText!.Text = mentionCount > 99 ? "99+" : mentionCount.ToString();
+
+                if (mentionCount > 0)
+                    Show();
+                else
+                    Hide();
+            }, true);
         }
+
     }
 }

From 75958bf2702778784caee4c70ed3040170f16a5e Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Mon, 14 Mar 2022 21:32:30 +0000
Subject: [PATCH 3425/5547] Refactor ControlItemText to use bindable flow for
 unread state

---
 .../Online/TestSceneChannelControlItem.cs     |  4 +--
 .../Chat/ChannelControl/ControlItem.cs        | 11 ++----
 .../Chat/ChannelControl/ControlItemText.cs    | 35 +++++++------------
 3 files changed, 17 insertions(+), 33 deletions(-)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneChannelControlItem.cs b/osu.Game.Tests/Visual/Online/TestSceneChannelControlItem.cs
index 2e5c2cc2cb..9af3b7613b 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneChannelControlItem.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneChannelControlItem.cs
@@ -117,13 +117,13 @@ namespace osu.Game.Tests.Visual.Online
             AddStep("Unread Selected", () =>
             {
                 if (selected.Value != null)
-                    channelMap[selected.Value].HasUnread = true;
+                    channelMap[selected.Value].Unread.Value = true;
             });
 
             AddStep("Read Selected", () =>
             {
                 if (selected.Value != null)
-                    channelMap[selected.Value].HasUnread = false;
+                    channelMap[selected.Value].Unread.Value = false;
             });
 
             AddStep("Add Mention Selected", () =>
diff --git a/osu.Game/Overlays/Chat/ChannelControl/ControlItem.cs b/osu.Game/Overlays/Chat/ChannelControl/ControlItem.cs
index d88a99c484..4b1bbaec82 100644
--- a/osu.Game/Overlays/Chat/ChannelControl/ControlItem.cs
+++ b/osu.Game/Overlays/Chat/ChannelControl/ControlItem.cs
@@ -23,15 +23,8 @@ namespace osu.Game.Overlays.Chat.ChannelControl
         [Cached]
         public readonly BindableInt Mentions = new BindableInt();
 
-        public bool HasUnread
-        {
-            get => text?.HasUnread ?? false;
-            set
-            {
-                if (text != null)
-                    text.HasUnread = value;
-            }
-        }
+        [Cached]
+        public readonly BindableBool Unread = new BindableBool();
 
         private readonly Channel channel;
 
diff --git a/osu.Game/Overlays/Chat/ChannelControl/ControlItemText.cs b/osu.Game/Overlays/Chat/ChannelControl/ControlItemText.cs
index 0c91903f6b..3573c72846 100644
--- a/osu.Game/Overlays/Chat/ChannelControl/ControlItemText.cs
+++ b/osu.Game/Overlays/Chat/ChannelControl/ControlItemText.cs
@@ -4,6 +4,7 @@
 #nullable enable
 
 using osu.Framework.Allocation;
+using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Graphics;
@@ -14,25 +15,13 @@ namespace osu.Game.Overlays.Chat.ChannelControl
 {
     public class ControlItemText : Container
     {
-        private bool hasUnread;
-
-        public bool HasUnread
-        {
-            get => hasUnread;
-            set
-            {
-                if (hasUnread == value)
-                    return;
-
-                hasUnread = value;
-                updateText();
-            }
-        }
-
         private readonly Channel channel;
 
         private OsuSpriteText? text;
 
+        [Resolved]
+        private BindableBool unread { get; set; } = null!;
+
         [Resolved]
         private OverlayColourProvider colourProvider { get; set; } = null!;
 
@@ -58,15 +47,17 @@ namespace osu.Game.Overlays.Chat.ChannelControl
             };
         }
 
-        private void updateText()
+        protected override void LoadComplete()
         {
-            if (!IsLoaded)
-                return;
+            base.LoadComplete();
 
-            if (HasUnread)
-                text!.Colour = colourProvider.Content1;
-            else
-                text!.Colour = colourProvider.Light3;
+            unread.BindValueChanged(change =>
+            {
+                if (change.NewValue)
+                    text!.Colour = colourProvider.Content1;
+                else
+                    text!.Colour = colourProvider.Light3;
+            }, true);
         }
     }
 }

From ec61b88ec27796836ae380c5e845101e1f06f589 Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Mon, 14 Mar 2022 21:39:57 +0000
Subject: [PATCH 3426/5547] Adjust ControlItem padding

---
 osu.Game/Overlays/Chat/ChannelControl/ControlItem.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/Chat/ChannelControl/ControlItem.cs b/osu.Game/Overlays/Chat/ChannelControl/ControlItem.cs
index 4b1bbaec82..e944bf4c28 100644
--- a/osu.Game/Overlays/Chat/ChannelControl/ControlItem.cs
+++ b/osu.Game/Overlays/Chat/ChannelControl/ControlItem.cs
@@ -68,7 +68,7 @@ namespace osu.Game.Overlays.Chat.ChannelControl
                 new Container
                 {
                     RelativeSizeAxes = Axes.Both,
-                    Padding = new MarginPadding { Left = 18, Right = 5 },
+                    Padding = new MarginPadding { Left = 18, Right = 10 },
                     Child = new GridContainer
                     {
                         RelativeSizeAxes = Axes.Both,

From 73a0373b4ed0d2de982c84b236dafae6c02ee677 Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Mon, 14 Mar 2022 21:56:56 +0000
Subject: [PATCH 3427/5547] Code quality fixes

---
 osu.Game/Overlays/Chat/ChannelControl/ControlItem.cs        | 6 ++----
 osu.Game/Overlays/Chat/ChannelControl/ControlItemMention.cs | 1 -
 osu.Game/Overlays/Chat/ChannelControl/ControlItemText.cs    | 5 +----
 3 files changed, 3 insertions(+), 9 deletions(-)

diff --git a/osu.Game/Overlays/Chat/ChannelControl/ControlItem.cs b/osu.Game/Overlays/Chat/ChannelControl/ControlItem.cs
index e944bf4c28..f2bab64371 100644
--- a/osu.Game/Overlays/Chat/ChannelControl/ControlItem.cs
+++ b/osu.Game/Overlays/Chat/ChannelControl/ControlItem.cs
@@ -30,8 +30,6 @@ namespace osu.Game.Overlays.Chat.ChannelControl
 
         private Box? hoverBox;
         private Box? selectBox;
-        private ControlItemText? text;
-        private ControlItemMention? mention;
         private ControlItemClose? close;
 
         [Resolved]
@@ -84,12 +82,12 @@ namespace osu.Game.Overlays.Chat.ChannelControl
                             new[]
                             {
                                 createAvatar(),
-                                text = new ControlItemText(channel)
+                                new ControlItemText(channel)
                                 {
                                     Anchor = Anchor.CentreLeft,
                                     Origin = Anchor.CentreLeft,
                                 },
-                                mention = new ControlItemMention
+                                new ControlItemMention
                                 {
                                     Anchor = Anchor.CentreLeft,
                                     Origin = Anchor.CentreLeft,
diff --git a/osu.Game/Overlays/Chat/ChannelControl/ControlItemMention.cs b/osu.Game/Overlays/Chat/ChannelControl/ControlItemMention.cs
index 594a52b8a7..e9172d99ba 100644
--- a/osu.Game/Overlays/Chat/ChannelControl/ControlItemMention.cs
+++ b/osu.Game/Overlays/Chat/ChannelControl/ControlItemMention.cs
@@ -68,6 +68,5 @@ namespace osu.Game.Overlays.Chat.ChannelControl
                     Hide();
             }, true);
         }
-
     }
 }
diff --git a/osu.Game/Overlays/Chat/ChannelControl/ControlItemText.cs b/osu.Game/Overlays/Chat/ChannelControl/ControlItemText.cs
index 3573c72846..89845dfef8 100644
--- a/osu.Game/Overlays/Chat/ChannelControl/ControlItemText.cs
+++ b/osu.Game/Overlays/Chat/ChannelControl/ControlItemText.cs
@@ -53,10 +53,7 @@ namespace osu.Game.Overlays.Chat.ChannelControl
 
             unread.BindValueChanged(change =>
             {
-                if (change.NewValue)
-                    text!.Colour = colourProvider.Content1;
-                else
-                    text!.Colour = colourProvider.Light3;
+                text!.Colour = change.NewValue ? colourProvider.Content1 : colourProvider.Light3;
             }, true);
         }
     }

From 6628b7c654789619617475f7114c84b35acde86a Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Mon, 14 Mar 2022 22:21:18 +0000
Subject: [PATCH 3428/5547] Ensure existing items are expired and cleared in
 ChannelControlItem test setup

---
 osu.Game.Tests/Visual/Online/TestSceneChannelControlItem.cs | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneChannelControlItem.cs b/osu.Game.Tests/Visual/Online/TestSceneChannelControlItem.cs
index 9af3b7613b..e496ef60d7 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneChannelControlItem.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneChannelControlItem.cs
@@ -49,6 +49,11 @@ namespace osu.Game.Tests.Visual.Online
         {
             Schedule(() =>
             {
+                foreach (var item in channelMap.Values)
+                    item.Expire();
+
+                channelMap.Clear();
+
                 Child = new FillFlowContainer
                 {
                     Direction = FillDirection.Vertical,

From 59d57a44d4c1b7901aab454671ccc9d611379bca Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 15 Mar 2022 09:11:57 +0900
Subject: [PATCH 3429/5547] Prevent incorrect usages by hard-typing ctor type

---
 osu.Game.Rulesets.Catch/Scoring/CatchScoreProcessor.cs         | 2 +-
 osu.Game.Rulesets.Mania/Scoring/ManiaScoreProcessor.cs         | 2 +-
 osu.Game.Rulesets.Osu/Scoring/OsuScoreProcessor.cs             | 2 +-
 osu.Game.Rulesets.Taiko/Scoring/TaikoScoreProcessor.cs         | 2 +-
 .../Visual/Multiplayer/TestSceneMultiSpectatorLeaderboard.cs   | 3 ++-
 .../Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs     | 3 ++-
 .../TestSceneMultiplayerGameplayLeaderboardTeams.cs            | 3 ++-
 7 files changed, 10 insertions(+), 7 deletions(-)

diff --git a/osu.Game.Rulesets.Catch/Scoring/CatchScoreProcessor.cs b/osu.Game.Rulesets.Catch/Scoring/CatchScoreProcessor.cs
index 2c183f5d94..3de86c3fb1 100644
--- a/osu.Game.Rulesets.Catch/Scoring/CatchScoreProcessor.cs
+++ b/osu.Game.Rulesets.Catch/Scoring/CatchScoreProcessor.cs
@@ -7,7 +7,7 @@ namespace osu.Game.Rulesets.Catch.Scoring
 {
     public class CatchScoreProcessor : ScoreProcessor
     {
-        public CatchScoreProcessor(Ruleset ruleset)
+        public CatchScoreProcessor(CatchRuleset ruleset)
             : base(ruleset)
         {
         }
diff --git a/osu.Game.Rulesets.Mania/Scoring/ManiaScoreProcessor.cs b/osu.Game.Rulesets.Mania/Scoring/ManiaScoreProcessor.cs
index 0ffee809fc..7251c58eba 100644
--- a/osu.Game.Rulesets.Mania/Scoring/ManiaScoreProcessor.cs
+++ b/osu.Game.Rulesets.Mania/Scoring/ManiaScoreProcessor.cs
@@ -7,7 +7,7 @@ namespace osu.Game.Rulesets.Mania.Scoring
 {
     internal class ManiaScoreProcessor : ScoreProcessor
     {
-        public ManiaScoreProcessor(Ruleset ruleset)
+        public ManiaScoreProcessor(ManiaRuleset ruleset)
             : base(ruleset)
         {
         }
diff --git a/osu.Game.Rulesets.Osu/Scoring/OsuScoreProcessor.cs b/osu.Game.Rulesets.Osu/Scoring/OsuScoreProcessor.cs
index e397fea0ed..8acb1cb59b 100644
--- a/osu.Game.Rulesets.Osu/Scoring/OsuScoreProcessor.cs
+++ b/osu.Game.Rulesets.Osu/Scoring/OsuScoreProcessor.cs
@@ -11,7 +11,7 @@ namespace osu.Game.Rulesets.Osu.Scoring
 {
     public class OsuScoreProcessor : ScoreProcessor
     {
-        public OsuScoreProcessor(Ruleset ruleset)
+        public OsuScoreProcessor(OsuRuleset ruleset)
             : base(ruleset)
         {
         }
diff --git a/osu.Game.Rulesets.Taiko/Scoring/TaikoScoreProcessor.cs b/osu.Game.Rulesets.Taiko/Scoring/TaikoScoreProcessor.cs
index ddf6587022..fb33ad25d9 100644
--- a/osu.Game.Rulesets.Taiko/Scoring/TaikoScoreProcessor.cs
+++ b/osu.Game.Rulesets.Taiko/Scoring/TaikoScoreProcessor.cs
@@ -7,7 +7,7 @@ namespace osu.Game.Rulesets.Taiko.Scoring
 {
     internal class TaikoScoreProcessor : ScoreProcessor
     {
-        public TaikoScoreProcessor(Ruleset ruleset)
+        public TaikoScoreProcessor(TaikoRuleset ruleset)
             : base(ruleset)
         {
         }
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorLeaderboard.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorLeaderboard.cs
index 0cc1257a07..1c0af829be 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorLeaderboard.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorLeaderboard.cs
@@ -8,6 +8,7 @@ using osu.Framework.Testing;
 using osu.Framework.Timing;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Multiplayer;
+using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Osu.Scoring;
 using osu.Game.Screens.OnlinePlay.Multiplayer.Spectate;
 using osu.Game.Screens.Play.HUD;
@@ -43,7 +44,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             {
                 Beatmap.Value = CreateWorkingBeatmap(Ruleset.Value);
                 var playable = Beatmap.Value.GetPlayableBeatmap(Ruleset.Value);
-                var scoreProcessor = new OsuScoreProcessor(Ruleset.Value.CreateInstance());
+                var scoreProcessor = new OsuScoreProcessor(new OsuRuleset());
                 scoreProcessor.ApplyBeatmap(playable);
 
                 LoadComponentAsync(leaderboard = new MultiSpectatorLeaderboard(Ruleset.Value, scoreProcessor, clocks.Keys.Select(id => new MultiplayerRoomUser(id)).ToArray())
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs
index 0edc56f5d3..6663180802 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs
@@ -16,6 +16,7 @@ using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Spectator;
 using osu.Game.Replays.Legacy;
+using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Osu.Scoring;
 using osu.Game.Rulesets.Scoring;
 using osu.Game.Scoring;
@@ -64,7 +65,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
                 Children = new Drawable[]
                 {
-                    scoreProcessor = new OsuScoreProcessor(Ruleset.Value.CreateInstance()),
+                    scoreProcessor = new OsuScoreProcessor(new OsuRuleset()),
                 };
 
                 scoreProcessor.ApplyBeatmap(playableBeatmap);
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboardTeams.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboardTeams.cs
index 60a5785b31..62130ca5be 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboardTeams.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboardTeams.cs
@@ -12,6 +12,7 @@ using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Multiplayer.MatchTypes.TeamVersus;
 using osu.Game.Online.Rooms;
+using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Osu.Scoring;
 using osu.Game.Screens.OnlinePlay.Multiplayer;
 using osu.Game.Screens.Play.HUD;
@@ -75,7 +76,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
                 Children = new Drawable[]
                 {
-                    scoreProcessor = new OsuScoreProcessor(Ruleset.Value.CreateInstance()),
+                    scoreProcessor = new OsuScoreProcessor(new OsuRuleset()),
                 };
 
                 scoreProcessor.ApplyBeatmap(playableBeatmap);

From 3a6d254d1f87a80a081346353ce8fe71d3a58ee3 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 15 Mar 2022 09:15:52 +0900
Subject: [PATCH 3430/5547] Add safeguards around incorrect ruleset sources

---
 osu.Game/Rulesets/Scoring/ScoreProcessor.cs | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/osu.Game/Rulesets/Scoring/ScoreProcessor.cs b/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
index b982c6ece2..0c585fac98 100644
--- a/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
+++ b/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
@@ -258,6 +258,9 @@ namespace osu.Game.Rulesets.Scoring
         /// <returns>The total score in the given <see cref="ScoringMode"/>.</returns>
         public double ComputeFinalScore(ScoringMode mode, ScoreInfo scoreInfo)
         {
+            if (!ruleset.RulesetInfo.Equals(scoreInfo.Ruleset))
+                throw new ArgumentException($"Unexpected score ruleset. Expected \"{ruleset.RulesetInfo.ShortName}\" but was \"{scoreInfo.Ruleset.ShortName}\".");
+
             extractFromStatistics(ruleset,
                 scoreInfo.Statistics,
                 out double extractedBaseScore,
@@ -282,6 +285,9 @@ namespace osu.Game.Rulesets.Scoring
         /// <returns>The total score in the given <see cref="ScoringMode"/>.</returns>
         public double ComputePartialScore(ScoringMode mode, ScoreInfo scoreInfo)
         {
+            if (!ruleset.RulesetInfo.Equals(scoreInfo.Ruleset))
+                throw new ArgumentException($"Unexpected score ruleset. Expected \"{ruleset.RulesetInfo.ShortName}\" but was \"{scoreInfo.Ruleset.ShortName}\".");
+
             if (!beatmapApplied)
                 throw new InvalidOperationException($"Cannot compute partial score without calling {nameof(ApplyBeatmap)}.");
 
@@ -311,6 +317,9 @@ namespace osu.Game.Rulesets.Scoring
         /// <returns>The total score in the given <see cref="ScoringMode"/>.</returns>
         public double ComputeFinalLegacyScore(ScoringMode mode, ScoreInfo scoreInfo, int maxAchievableCombo)
         {
+            if (!ruleset.RulesetInfo.Equals(scoreInfo.Ruleset))
+                throw new ArgumentException($"Unexpected score ruleset. Expected \"{ruleset.RulesetInfo.ShortName}\" but was \"{scoreInfo.Ruleset.ShortName}\".");
+
             double accuracyRatio = scoreInfo.Accuracy;
             double comboRatio = maxAchievableCombo > 0 ? (double)scoreInfo.MaxCombo / maxAchievableCombo : 1;
 

From ca6256049558e15a9266b0553afd91573ab42235 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 15 Mar 2022 09:16:39 +0900
Subject: [PATCH 3431/5547] Resolve inspections

---
 osu.Game/Skinning/Editor/SkinComponentToolbox.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Skinning/Editor/SkinComponentToolbox.cs b/osu.Game/Skinning/Editor/SkinComponentToolbox.cs
index a9dcf705a9..2781f1958f 100644
--- a/osu.Game/Skinning/Editor/SkinComponentToolbox.cs
+++ b/osu.Game/Skinning/Editor/SkinComponentToolbox.cs
@@ -184,8 +184,8 @@ namespace osu.Game.Skinning.Editor
             public override DrawableRuleset CreateDrawableRulesetWith(IBeatmap beatmap, IReadOnlyList<Mod> mods = null) => throw new NotImplementedException();
             public override IBeatmapConverter CreateBeatmapConverter(IBeatmap beatmap) => throw new NotImplementedException();
             public override DifficultyCalculator CreateDifficultyCalculator(IWorkingBeatmap beatmap) => throw new NotImplementedException();
-            public override string Description { get; }
-            public override string ShortName { get; }
+            public override string Description => string.Empty;
+            public override string ShortName => string.Empty;
         }
     }
 }

From faf145742fc67bd22be37f9a3604c97a58a226bc Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 15 Mar 2022 09:21:09 +0900
Subject: [PATCH 3432/5547] Fix incorrect provided ruleset in test

---
 osu.Game.Tests/Rulesets/Scoring/ScoreProcessorTest.cs | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Rulesets/Scoring/ScoreProcessorTest.cs b/osu.Game.Tests/Rulesets/Scoring/ScoreProcessorTest.cs
index 5c01950bea..7ecd509193 100644
--- a/osu.Game.Tests/Rulesets/Scoring/ScoreProcessorTest.cs
+++ b/osu.Game.Tests/Rulesets/Scoring/ScoreProcessorTest.cs
@@ -10,7 +10,6 @@ using osu.Game.Rulesets.Difficulty;
 using osu.Game.Rulesets.Judgements;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Objects;
-using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Osu.Judgements;
 using osu.Game.Rulesets.Osu.Objects;
 using osu.Game.Rulesets.Scoring;
@@ -28,7 +27,7 @@ namespace osu.Game.Tests.Rulesets.Scoring
         [SetUp]
         public void SetUp()
         {
-            scoreProcessor = new ScoreProcessor(new OsuRuleset());
+            scoreProcessor = new ScoreProcessor(new TestRuleset());
             beatmap = new TestBeatmap(new RulesetInfo())
             {
                 HitObjects = new List<HitObject>

From 4ff6879b85baed3b42560431b7c4962b7804c0d0 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 15 Mar 2022 11:30:57 +0900
Subject: [PATCH 3433/5547] Fix incorrect copied room end dates

---
 osu.Game/Screens/OnlinePlay/Lounge/LoungeSubScreen.cs | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/osu.Game/Screens/OnlinePlay/Lounge/LoungeSubScreen.cs b/osu.Game/Screens/OnlinePlay/Lounge/LoungeSubScreen.cs
index fb8647284f..a2d3b7f4fc 100644
--- a/osu.Game/Screens/OnlinePlay/Lounge/LoungeSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Lounge/LoungeSubScreen.cs
@@ -334,6 +334,10 @@ namespace osu.Game.Screens.OnlinePlay.Lounge
                 // ID must be unset as we use this as a marker for whether this is a client-side (not-yet-created) room or not.
                 r.RoomID.Value = null;
 
+                // Null out dates because end date is not supported client-side and the settings overlay will populate a duration.
+                r.EndDate.Value = null;
+                r.Duration.Value = null;
+
                 Open(r);
 
                 joiningRoomOperation?.Dispose();

From daac93349864ee975aab450fd6b7d4b48e77bac6 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 15 Mar 2022 12:34:58 +0900
Subject: [PATCH 3434/5547] Remove unnecessary ctor arguments

---
 osu.Game.Rulesets.Catch/CatchRuleset.cs                       | 2 +-
 osu.Game.Rulesets.Catch/Scoring/CatchScoreProcessor.cs        | 4 ++--
 osu.Game.Rulesets.Mania/ManiaRuleset.cs                       | 2 +-
 osu.Game.Rulesets.Mania/Scoring/ManiaScoreProcessor.cs        | 4 ++--
 osu.Game.Rulesets.Osu/OsuRuleset.cs                           | 2 +-
 osu.Game.Rulesets.Osu/Scoring/OsuScoreProcessor.cs            | 4 ++--
 .../Skinning/TestSceneDrawableTaikoMascot.cs                  | 2 +-
 osu.Game.Rulesets.Taiko/Scoring/TaikoScoreProcessor.cs        | 4 ++--
 osu.Game.Rulesets.Taiko/TaikoRuleset.cs                       | 2 +-
 .../Visual/Multiplayer/TestSceneMultiSpectatorLeaderboard.cs  | 3 +--
 .../Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs    | 3 +--
 .../TestSceneMultiplayerGameplayLeaderboardTeams.cs           | 3 +--
 12 files changed, 16 insertions(+), 19 deletions(-)

diff --git a/osu.Game.Rulesets.Catch/CatchRuleset.cs b/osu.Game.Rulesets.Catch/CatchRuleset.cs
index 45198fa0ca..3a7efb6263 100644
--- a/osu.Game.Rulesets.Catch/CatchRuleset.cs
+++ b/osu.Game.Rulesets.Catch/CatchRuleset.cs
@@ -32,7 +32,7 @@ namespace osu.Game.Rulesets.Catch
     {
         public override DrawableRuleset CreateDrawableRulesetWith(IBeatmap beatmap, IReadOnlyList<Mod> mods = null) => new DrawableCatchRuleset(this, beatmap, mods);
 
-        public override ScoreProcessor CreateScoreProcessor() => new CatchScoreProcessor(this);
+        public override ScoreProcessor CreateScoreProcessor() => new CatchScoreProcessor();
 
         public override IBeatmapConverter CreateBeatmapConverter(IBeatmap beatmap) => new CatchBeatmapConverter(beatmap, this);
 
diff --git a/osu.Game.Rulesets.Catch/Scoring/CatchScoreProcessor.cs b/osu.Game.Rulesets.Catch/Scoring/CatchScoreProcessor.cs
index 3de86c3fb1..51b1ccaaba 100644
--- a/osu.Game.Rulesets.Catch/Scoring/CatchScoreProcessor.cs
+++ b/osu.Game.Rulesets.Catch/Scoring/CatchScoreProcessor.cs
@@ -7,8 +7,8 @@ namespace osu.Game.Rulesets.Catch.Scoring
 {
     public class CatchScoreProcessor : ScoreProcessor
     {
-        public CatchScoreProcessor(CatchRuleset ruleset)
-            : base(ruleset)
+        public CatchScoreProcessor()
+            : base(new CatchRuleset())
         {
         }
 
diff --git a/osu.Game.Rulesets.Mania/ManiaRuleset.cs b/osu.Game.Rulesets.Mania/ManiaRuleset.cs
index 92c77f405b..d04ef69dd2 100644
--- a/osu.Game.Rulesets.Mania/ManiaRuleset.cs
+++ b/osu.Game.Rulesets.Mania/ManiaRuleset.cs
@@ -47,7 +47,7 @@ namespace osu.Game.Rulesets.Mania
 
         public override DrawableRuleset CreateDrawableRulesetWith(IBeatmap beatmap, IReadOnlyList<Mod> mods = null) => new DrawableManiaRuleset(this, beatmap, mods);
 
-        public override ScoreProcessor CreateScoreProcessor() => new ManiaScoreProcessor(this);
+        public override ScoreProcessor CreateScoreProcessor() => new ManiaScoreProcessor();
 
         public override HealthProcessor CreateHealthProcessor(double drainStartTime) => new ManiaHealthProcessor(drainStartTime, 0.5);
 
diff --git a/osu.Game.Rulesets.Mania/Scoring/ManiaScoreProcessor.cs b/osu.Game.Rulesets.Mania/Scoring/ManiaScoreProcessor.cs
index 7251c58eba..02d62a090b 100644
--- a/osu.Game.Rulesets.Mania/Scoring/ManiaScoreProcessor.cs
+++ b/osu.Game.Rulesets.Mania/Scoring/ManiaScoreProcessor.cs
@@ -7,8 +7,8 @@ namespace osu.Game.Rulesets.Mania.Scoring
 {
     internal class ManiaScoreProcessor : ScoreProcessor
     {
-        public ManiaScoreProcessor(ManiaRuleset ruleset)
-            : base(ruleset)
+        public ManiaScoreProcessor()
+            : base(new ManiaRuleset())
         {
         }
 
diff --git a/osu.Game.Rulesets.Osu/OsuRuleset.cs b/osu.Game.Rulesets.Osu/OsuRuleset.cs
index 87ffe8983f..92b90339f9 100644
--- a/osu.Game.Rulesets.Osu/OsuRuleset.cs
+++ b/osu.Game.Rulesets.Osu/OsuRuleset.cs
@@ -43,7 +43,7 @@ namespace osu.Game.Rulesets.Osu
     {
         public override DrawableRuleset CreateDrawableRulesetWith(IBeatmap beatmap, IReadOnlyList<Mod> mods = null) => new DrawableOsuRuleset(this, beatmap, mods);
 
-        public override ScoreProcessor CreateScoreProcessor() => new OsuScoreProcessor(this);
+        public override ScoreProcessor CreateScoreProcessor() => new OsuScoreProcessor();
 
         public override IBeatmapConverter CreateBeatmapConverter(IBeatmap beatmap) => new OsuBeatmapConverter(beatmap, this);
 
diff --git a/osu.Game.Rulesets.Osu/Scoring/OsuScoreProcessor.cs b/osu.Game.Rulesets.Osu/Scoring/OsuScoreProcessor.cs
index 8acb1cb59b..ab0c0850dc 100644
--- a/osu.Game.Rulesets.Osu/Scoring/OsuScoreProcessor.cs
+++ b/osu.Game.Rulesets.Osu/Scoring/OsuScoreProcessor.cs
@@ -11,8 +11,8 @@ namespace osu.Game.Rulesets.Osu.Scoring
 {
     public class OsuScoreProcessor : ScoreProcessor
     {
-        public OsuScoreProcessor(OsuRuleset ruleset)
-            : base(ruleset)
+        public OsuScoreProcessor()
+            : base(new OsuRuleset())
         {
         }
 
diff --git a/osu.Game.Rulesets.Taiko.Tests/Skinning/TestSceneDrawableTaikoMascot.cs b/osu.Game.Rulesets.Taiko.Tests/Skinning/TestSceneDrawableTaikoMascot.cs
index b7e1c9586a..920a7cd1a1 100644
--- a/osu.Game.Rulesets.Taiko.Tests/Skinning/TestSceneDrawableTaikoMascot.cs
+++ b/osu.Game.Rulesets.Taiko.Tests/Skinning/TestSceneDrawableTaikoMascot.cs
@@ -46,7 +46,7 @@ namespace osu.Game.Rulesets.Taiko.Tests.Skinning
         [SetUp]
         public void SetUp()
         {
-            scoreProcessor = new TaikoScoreProcessor(new TaikoRuleset());
+            scoreProcessor = new TaikoScoreProcessor();
         }
 
         [Test]
diff --git a/osu.Game.Rulesets.Taiko/Scoring/TaikoScoreProcessor.cs b/osu.Game.Rulesets.Taiko/Scoring/TaikoScoreProcessor.cs
index fb33ad25d9..bacc22714e 100644
--- a/osu.Game.Rulesets.Taiko/Scoring/TaikoScoreProcessor.cs
+++ b/osu.Game.Rulesets.Taiko/Scoring/TaikoScoreProcessor.cs
@@ -7,8 +7,8 @@ namespace osu.Game.Rulesets.Taiko.Scoring
 {
     internal class TaikoScoreProcessor : ScoreProcessor
     {
-        public TaikoScoreProcessor(TaikoRuleset ruleset)
-            : base(ruleset)
+        public TaikoScoreProcessor()
+            : base(new TaikoRuleset())
         {
         }
 
diff --git a/osu.Game.Rulesets.Taiko/TaikoRuleset.cs b/osu.Game.Rulesets.Taiko/TaikoRuleset.cs
index a3a2858bd5..8934b64ca5 100644
--- a/osu.Game.Rulesets.Taiko/TaikoRuleset.cs
+++ b/osu.Game.Rulesets.Taiko/TaikoRuleset.cs
@@ -36,7 +36,7 @@ namespace osu.Game.Rulesets.Taiko
     {
         public override DrawableRuleset CreateDrawableRulesetWith(IBeatmap beatmap, IReadOnlyList<Mod> mods = null) => new DrawableTaikoRuleset(this, beatmap, mods);
 
-        public override ScoreProcessor CreateScoreProcessor() => new TaikoScoreProcessor(this);
+        public override ScoreProcessor CreateScoreProcessor() => new TaikoScoreProcessor();
 
         public override HealthProcessor CreateHealthProcessor(double drainStartTime) => new TaikoHealthProcessor();
 
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorLeaderboard.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorLeaderboard.cs
index 1c0af829be..f57a54d84c 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorLeaderboard.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorLeaderboard.cs
@@ -8,7 +8,6 @@ using osu.Framework.Testing;
 using osu.Framework.Timing;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Multiplayer;
-using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Osu.Scoring;
 using osu.Game.Screens.OnlinePlay.Multiplayer.Spectate;
 using osu.Game.Screens.Play.HUD;
@@ -44,7 +43,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             {
                 Beatmap.Value = CreateWorkingBeatmap(Ruleset.Value);
                 var playable = Beatmap.Value.GetPlayableBeatmap(Ruleset.Value);
-                var scoreProcessor = new OsuScoreProcessor(new OsuRuleset());
+                var scoreProcessor = new OsuScoreProcessor();
                 scoreProcessor.ApplyBeatmap(playable);
 
                 LoadComponentAsync(leaderboard = new MultiSpectatorLeaderboard(Ruleset.Value, scoreProcessor, clocks.Keys.Select(id => new MultiplayerRoomUser(id)).ToArray())
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs
index 6663180802..bcd4474876 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs
@@ -16,7 +16,6 @@ using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Spectator;
 using osu.Game.Replays.Legacy;
-using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Osu.Scoring;
 using osu.Game.Rulesets.Scoring;
 using osu.Game.Scoring;
@@ -65,7 +64,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
                 Children = new Drawable[]
                 {
-                    scoreProcessor = new OsuScoreProcessor(new OsuRuleset()),
+                    scoreProcessor = new OsuScoreProcessor(),
                 };
 
                 scoreProcessor.ApplyBeatmap(playableBeatmap);
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboardTeams.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboardTeams.cs
index 62130ca5be..7f5aced925 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboardTeams.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboardTeams.cs
@@ -12,7 +12,6 @@ using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Multiplayer.MatchTypes.TeamVersus;
 using osu.Game.Online.Rooms;
-using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Osu.Scoring;
 using osu.Game.Screens.OnlinePlay.Multiplayer;
 using osu.Game.Screens.Play.HUD;
@@ -76,7 +75,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
                 Children = new Drawable[]
                 {
-                    scoreProcessor = new OsuScoreProcessor(new OsuRuleset()),
+                    scoreProcessor = new OsuScoreProcessor(),
                 };
 
                 scoreProcessor.ApplyBeatmap(playableBeatmap);

From 523f668c8cae5211cab71fcc711d34aac70fdd94 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 15 Mar 2022 12:37:39 +0900
Subject: [PATCH 3435/5547] Remove unnecessary ctor argument

---
 osu.Game.Rulesets.Catch/CatchRuleset.cs                       | 2 +-
 .../Difficulty/CatchPerformanceCalculator.cs                  | 4 ++--
 .../Difficulty/ManiaPerformanceCalculator.cs                  | 4 ++--
 osu.Game.Rulesets.Mania/ManiaRuleset.cs                       | 2 +-
 osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs  | 4 ++--
 osu.Game.Rulesets.Osu/OsuRuleset.cs                           | 2 +-
 .../Difficulty/TaikoPerformanceCalculator.cs                  | 4 ++--
 osu.Game.Rulesets.Taiko/TaikoRuleset.cs                       | 2 +-
 8 files changed, 12 insertions(+), 12 deletions(-)

diff --git a/osu.Game.Rulesets.Catch/CatchRuleset.cs b/osu.Game.Rulesets.Catch/CatchRuleset.cs
index 3a7efb6263..80b9436b2c 100644
--- a/osu.Game.Rulesets.Catch/CatchRuleset.cs
+++ b/osu.Game.Rulesets.Catch/CatchRuleset.cs
@@ -181,7 +181,7 @@ namespace osu.Game.Rulesets.Catch
 
         public override ISkin CreateLegacySkinProvider(ISkin skin, IBeatmap beatmap) => new CatchLegacySkinTransformer(skin);
 
-        public override PerformanceCalculator CreatePerformanceCalculator() => new CatchPerformanceCalculator(this);
+        public override PerformanceCalculator CreatePerformanceCalculator() => new CatchPerformanceCalculator();
 
         public int LegacyID => 2;
 
diff --git a/osu.Game.Rulesets.Catch/Difficulty/CatchPerformanceCalculator.cs b/osu.Game.Rulesets.Catch/Difficulty/CatchPerformanceCalculator.cs
index 6fefb2e5bb..b30b85be2d 100644
--- a/osu.Game.Rulesets.Catch/Difficulty/CatchPerformanceCalculator.cs
+++ b/osu.Game.Rulesets.Catch/Difficulty/CatchPerformanceCalculator.cs
@@ -19,8 +19,8 @@ namespace osu.Game.Rulesets.Catch.Difficulty
         private int tinyTicksMissed;
         private int misses;
 
-        public CatchPerformanceCalculator(Ruleset ruleset)
-            : base(ruleset)
+        public CatchPerformanceCalculator()
+            : base(new CatchRuleset())
         {
         }
 
diff --git a/osu.Game.Rulesets.Mania/Difficulty/ManiaPerformanceCalculator.cs b/osu.Game.Rulesets.Mania/Difficulty/ManiaPerformanceCalculator.cs
index 1eaf45e54a..b347cc9ae2 100644
--- a/osu.Game.Rulesets.Mania/Difficulty/ManiaPerformanceCalculator.cs
+++ b/osu.Game.Rulesets.Mania/Difficulty/ManiaPerformanceCalculator.cs
@@ -23,8 +23,8 @@ namespace osu.Game.Rulesets.Mania.Difficulty
         private int countMeh;
         private int countMiss;
 
-        public ManiaPerformanceCalculator(Ruleset ruleset)
-            : base(ruleset)
+        public ManiaPerformanceCalculator()
+            : base(new ManiaRuleset())
         {
         }
 
diff --git a/osu.Game.Rulesets.Mania/ManiaRuleset.cs b/osu.Game.Rulesets.Mania/ManiaRuleset.cs
index d04ef69dd2..bd6a67bf67 100644
--- a/osu.Game.Rulesets.Mania/ManiaRuleset.cs
+++ b/osu.Game.Rulesets.Mania/ManiaRuleset.cs
@@ -53,7 +53,7 @@ namespace osu.Game.Rulesets.Mania
 
         public override IBeatmapConverter CreateBeatmapConverter(IBeatmap beatmap) => new ManiaBeatmapConverter(beatmap, this);
 
-        public override PerformanceCalculator CreatePerformanceCalculator() => new ManiaPerformanceCalculator(this);
+        public override PerformanceCalculator CreatePerformanceCalculator() => new ManiaPerformanceCalculator();
 
         public const string SHORT_NAME = "mania";
 
diff --git a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
index 5644b2009d..a93a1641a1 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
@@ -22,8 +22,8 @@ namespace osu.Game.Rulesets.Osu.Difficulty
 
         private double effectiveMissCount;
 
-        public OsuPerformanceCalculator(Ruleset ruleset)
-            : base(ruleset)
+        public OsuPerformanceCalculator()
+            : base(new OsuRuleset())
         {
         }
 
diff --git a/osu.Game.Rulesets.Osu/OsuRuleset.cs b/osu.Game.Rulesets.Osu/OsuRuleset.cs
index 92b90339f9..2fdf42fca1 100644
--- a/osu.Game.Rulesets.Osu/OsuRuleset.cs
+++ b/osu.Game.Rulesets.Osu/OsuRuleset.cs
@@ -213,7 +213,7 @@ namespace osu.Game.Rulesets.Osu
 
         public override DifficultyCalculator CreateDifficultyCalculator(IWorkingBeatmap beatmap) => new OsuDifficultyCalculator(RulesetInfo, beatmap);
 
-        public override PerformanceCalculator CreatePerformanceCalculator() => new OsuPerformanceCalculator(this);
+        public override PerformanceCalculator CreatePerformanceCalculator() => new OsuPerformanceCalculator();
 
         public override HitObjectComposer CreateHitObjectComposer() => new OsuHitObjectComposer(this);
 
diff --git a/osu.Game.Rulesets.Taiko/Difficulty/TaikoPerformanceCalculator.cs b/osu.Game.Rulesets.Taiko/Difficulty/TaikoPerformanceCalculator.cs
index 9e73390fad..a8122551ff 100644
--- a/osu.Game.Rulesets.Taiko/Difficulty/TaikoPerformanceCalculator.cs
+++ b/osu.Game.Rulesets.Taiko/Difficulty/TaikoPerformanceCalculator.cs
@@ -19,8 +19,8 @@ namespace osu.Game.Rulesets.Taiko.Difficulty
         private int countMeh;
         private int countMiss;
 
-        public TaikoPerformanceCalculator(Ruleset ruleset)
-            : base(ruleset)
+        public TaikoPerformanceCalculator()
+            : base(new TaikoRuleset())
         {
         }
 
diff --git a/osu.Game.Rulesets.Taiko/TaikoRuleset.cs b/osu.Game.Rulesets.Taiko/TaikoRuleset.cs
index 8934b64ca5..615fbf093f 100644
--- a/osu.Game.Rulesets.Taiko/TaikoRuleset.cs
+++ b/osu.Game.Rulesets.Taiko/TaikoRuleset.cs
@@ -171,7 +171,7 @@ namespace osu.Game.Rulesets.Taiko
 
         public override DifficultyCalculator CreateDifficultyCalculator(IWorkingBeatmap beatmap) => new TaikoDifficultyCalculator(RulesetInfo, beatmap);
 
-        public override PerformanceCalculator CreatePerformanceCalculator() => new TaikoPerformanceCalculator(this);
+        public override PerformanceCalculator CreatePerformanceCalculator() => new TaikoPerformanceCalculator();
 
         public int LegacyID => 1;
 

From 6d5692fcecc3e4c88b0bd7395b7b5a6258821885 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 15 Mar 2022 14:25:05 +0900
Subject: [PATCH 3436/5547] Fix typo in setting name
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/Skinning/Components/BigBlackBox.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Skinning/Components/BigBlackBox.cs b/osu.Game/Skinning/Components/BigBlackBox.cs
index 8e57143a12..373e6467e8 100644
--- a/osu.Game/Skinning/Components/BigBlackBox.cs
+++ b/osu.Game/Skinning/Components/BigBlackBox.cs
@@ -23,7 +23,7 @@ namespace osu.Game.Skinning.Components
     {
         public bool UsesFixedAnchor { get; set; }
 
-        [SettingSource("Spining text", "Whether the big text should spin")]
+        [SettingSource("Spinning text", "Whether the big text should spin")]
         public Bindable<bool> TextSpin { get; } = new BindableBool();
 
         [SettingSource("Alpha", "The alpha value of this box")]

From 1814a325d8aef692bb174adf9266710f87b445ef Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 15 Mar 2022 14:53:50 +0900
Subject: [PATCH 3437/5547] Move `GetSettingUnderlyingValue` to a
 `SettingSource` extension method

---
 .../Configuration/SettingSourceAttribute.cs   | 34 ++++++++++++++++
 osu.Game/Online/API/APIMod.cs                 |  9 ++---
 .../API/ModSettingsDictionaryFormatter.cs     |  4 +-
 osu.Game/Rulesets/Mods/Mod.cs                 |  8 ++--
 osu.Game/Screens/Play/HUD/SkinnableInfo.cs    |  3 +-
 osu.Game/Utils/ModUtils.cs                    | 39 +------------------
 6 files changed, 47 insertions(+), 50 deletions(-)

diff --git a/osu.Game/Configuration/SettingSourceAttribute.cs b/osu.Game/Configuration/SettingSourceAttribute.cs
index 5db502804d..4111a67b24 100644
--- a/osu.Game/Configuration/SettingSourceAttribute.cs
+++ b/osu.Game/Configuration/SettingSourceAttribute.cs
@@ -6,6 +6,7 @@
 using System;
 using System.Collections.Concurrent;
 using System.Collections.Generic;
+using System.Diagnostics;
 using System.Linq;
 using System.Reflection;
 using JetBrains.Annotations;
@@ -170,6 +171,39 @@ namespace osu.Game.Configuration
 
         private static readonly ConcurrentDictionary<Type, (SettingSourceAttribute, PropertyInfo)[]> property_info_cache = new ConcurrentDictionary<Type, (SettingSourceAttribute, PropertyInfo)[]>();
 
+        /// <summary>
+        /// Returns the underlying value of the given mod setting object.
+        /// Can be used for serialization and equality comparison purposes.
+        /// </summary>
+        /// <param name="setting">A <see cref="SettingSourceAttribute"/> bindable.</param>
+        public static object GetUnderlyingSettingValue(this object setting)
+        {
+            switch (setting)
+            {
+                case Bindable<double> d:
+                    return d.Value;
+
+                case Bindable<int> i:
+                    return i.Value;
+
+                case Bindable<float> f:
+                    return f.Value;
+
+                case Bindable<bool> b:
+                    return b.Value;
+
+                case IBindable u:
+                    // An unknown (e.g. enum) generic type.
+                    var valueMethod = u.GetType().GetProperty(nameof(IBindable<int>.Value));
+                    Debug.Assert(valueMethod != null);
+                    return valueMethod.GetValue(u);
+
+                default:
+                    // fall back for non-bindable cases.
+                    return setting;
+            }
+        }
+
         public static IEnumerable<(SettingSourceAttribute, PropertyInfo)> GetSettingsSourceProperties(this object obj)
         {
             var type = obj.GetType();
diff --git a/osu.Game/Online/API/APIMod.cs b/osu.Game/Online/API/APIMod.cs
index 44b1c460d5..524f7b7108 100644
--- a/osu.Game/Online/API/APIMod.cs
+++ b/osu.Game/Online/API/APIMod.cs
@@ -12,7 +12,6 @@ using osu.Framework.Logging;
 using osu.Game.Configuration;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Mods;
-using osu.Game.Utils;
 
 namespace osu.Game.Online.API
 {
@@ -43,7 +42,7 @@ namespace osu.Game.Online.API
                 var bindable = (IBindable)property.GetValue(mod);
 
                 if (!bindable.IsDefault)
-                    Settings.Add(property.Name.Underscore(), ModUtils.GetSettingUnderlyingValue(bindable));
+                    Settings.Add(property.Name.Underscore(), bindable.GetUnderlyingSettingValue());
             }
         }
 
@@ -93,13 +92,13 @@ namespace osu.Game.Online.API
 
             public bool Equals(KeyValuePair<string, object> x, KeyValuePair<string, object> y)
             {
-                object xValue = ModUtils.GetSettingUnderlyingValue(x.Value);
-                object yValue = ModUtils.GetSettingUnderlyingValue(y.Value);
+                object xValue = x.Value.GetUnderlyingSettingValue();
+                object yValue = y.Value.GetUnderlyingSettingValue();
 
                 return x.Key == y.Key && EqualityComparer<object>.Default.Equals(xValue, yValue);
             }
 
-            public int GetHashCode(KeyValuePair<string, object> obj) => HashCode.Combine(obj.Key, ModUtils.GetSettingUnderlyingValue(obj.Value));
+            public int GetHashCode(KeyValuePair<string, object> obj) => HashCode.Combine(obj.Key, obj.Value.GetUnderlyingSettingValue());
         }
     }
 }
diff --git a/osu.Game/Online/API/ModSettingsDictionaryFormatter.cs b/osu.Game/Online/API/ModSettingsDictionaryFormatter.cs
index 81ecc74ddb..a7c63c17f9 100644
--- a/osu.Game/Online/API/ModSettingsDictionaryFormatter.cs
+++ b/osu.Game/Online/API/ModSettingsDictionaryFormatter.cs
@@ -6,7 +6,7 @@ using System.Collections.Generic;
 using System.Text;
 using MessagePack;
 using MessagePack.Formatters;
-using osu.Game.Utils;
+using osu.Game.Configuration;
 
 namespace osu.Game.Online.API
 {
@@ -23,7 +23,7 @@ namespace osu.Game.Online.API
                 var stringBytes = new ReadOnlySequence<byte>(Encoding.UTF8.GetBytes(kvp.Key));
                 writer.WriteString(in stringBytes);
 
-                primitiveFormatter.Serialize(ref writer, ModUtils.GetSettingUnderlyingValue(kvp.Value), options);
+                primitiveFormatter.Serialize(ref writer, kvp.Value.GetUnderlyingSettingValue(), options);
             }
         }
 
diff --git a/osu.Game/Rulesets/Mods/Mod.cs b/osu.Game/Rulesets/Mods/Mod.cs
index 7136795461..b2d4be54ce 100644
--- a/osu.Game/Rulesets/Mods/Mod.cs
+++ b/osu.Game/Rulesets/Mods/Mod.cs
@@ -192,7 +192,7 @@ namespace osu.Game.Rulesets.Mods
             hashCode.Add(GetType());
 
             foreach (var setting in Settings)
-                hashCode.Add(ModUtils.GetSettingUnderlyingValue(setting));
+                hashCode.Add(setting.GetUnderlyingSettingValue());
 
             return hashCode.ToHashCode();
         }
@@ -208,13 +208,13 @@ namespace osu.Game.Rulesets.Mods
 
             public bool Equals(IBindable x, IBindable y)
             {
-                object xValue = x == null ? null : ModUtils.GetSettingUnderlyingValue(x);
-                object yValue = y == null ? null : ModUtils.GetSettingUnderlyingValue(y);
+                object xValue = x?.GetUnderlyingSettingValue();
+                object yValue = y?.GetUnderlyingSettingValue();
 
                 return EqualityComparer<object>.Default.Equals(xValue, yValue);
             }
 
-            public int GetHashCode(IBindable obj) => ModUtils.GetSettingUnderlyingValue(obj).GetHashCode();
+            public int GetHashCode(IBindable obj) => obj.GetUnderlyingSettingValue().GetHashCode();
         }
     }
 }
diff --git a/osu.Game/Screens/Play/HUD/SkinnableInfo.cs b/osu.Game/Screens/Play/HUD/SkinnableInfo.cs
index 5a51e7f455..95395f8181 100644
--- a/osu.Game/Screens/Play/HUD/SkinnableInfo.cs
+++ b/osu.Game/Screens/Play/HUD/SkinnableInfo.cs
@@ -12,7 +12,6 @@ using osu.Framework.Graphics.Containers;
 using osu.Game.Configuration;
 using osu.Game.Extensions;
 using osu.Game.Skinning;
-using osu.Game.Utils;
 using osuTK;
 
 namespace osu.Game.Screens.Play.HUD
@@ -69,7 +68,7 @@ namespace osu.Game.Screens.Play.HUD
                 var bindable = (IBindable)property.GetValue(component);
 
                 if (!bindable.IsDefault)
-                    Settings.Add(property.Name.Underscore(), ModUtils.GetSettingUnderlyingValue(bindable));
+                    Settings.Add(property.Name.Underscore(), bindable.GetUnderlyingSettingValue());
             }
 
             if (component is Container<Drawable> container)
diff --git a/osu.Game/Utils/ModUtils.cs b/osu.Game/Utils/ModUtils.cs
index cdca277dd8..d5ea74c404 100644
--- a/osu.Game/Utils/ModUtils.cs
+++ b/osu.Game/Utils/ModUtils.cs
@@ -1,18 +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.
 
+#nullable enable
+
 using System;
 using System.Collections.Generic;
-using System.Diagnostics;
 using System.Diagnostics.CodeAnalysis;
 using System.Linq;
-using osu.Framework.Bindables;
 using osu.Game.Online.API;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Mods;
 
-#nullable enable
-
 namespace osu.Game.Utils
 {
     /// <summary>
@@ -154,39 +152,6 @@ namespace osu.Game.Utils
                 yield return mod;
         }
 
-        /// <summary>
-        /// Returns the underlying value of the given mod setting object.
-        /// Used in <see cref="APIMod"/> for serialization and equality comparison purposes.
-        /// </summary>
-        /// <param name="setting">The mod setting.</param>
-        public static object GetSettingUnderlyingValue(object setting)
-        {
-            switch (setting)
-            {
-                case Bindable<double> d:
-                    return d.Value;
-
-                case Bindable<int> i:
-                    return i.Value;
-
-                case Bindable<float> f:
-                    return f.Value;
-
-                case Bindable<bool> b:
-                    return b.Value;
-
-                case IBindable u:
-                    // A mod with unknown (e.g. enum) generic type.
-                    var valueMethod = u.GetType().GetProperty(nameof(IBindable<int>.Value));
-                    Debug.Assert(valueMethod != null);
-                    return valueMethod.GetValue(u);
-
-                default:
-                    // fall back for non-bindable cases.
-                    return setting;
-            }
-        }
-
         /// <summary>
         /// Verifies all proposed mods are valid for a given ruleset and returns instantiated <see cref="Mod"/>s for further processing.
         /// </summary>

From 2b02a6555b2616dceadb941d0b5f01473547ef9b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 15 Mar 2022 15:40:26 +0900
Subject: [PATCH 3438/5547] Remove current screen check from skin editor
 changes

---
 osu.Game/Skinning/Editor/SkinEditorOverlay.cs | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/osu.Game/Skinning/Editor/SkinEditorOverlay.cs b/osu.Game/Skinning/Editor/SkinEditorOverlay.cs
index 73af2591c8..abd8272633 100644
--- a/osu.Game/Skinning/Editor/SkinEditorOverlay.cs
+++ b/osu.Game/Skinning/Editor/SkinEditorOverlay.cs
@@ -132,9 +132,6 @@ namespace osu.Game.Skinning.Editor
         {
             Debug.Assert(skinEditor != null);
 
-            if (!target.IsCurrentScreen())
-                return;
-
             if (!target.IsLoaded)
             {
                 Scheduler.AddOnce(setTarget, target);

From 9e476ced63eba9e4ad3e7e2f62d74faf67f079ff Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 15 Mar 2022 16:35:46 +0900
Subject: [PATCH 3439/5547] Add `EditorSidebar` component

---
 .../UserInterface/TestSceneEditorSidebar.cs   | 97 +++++++++++++++++++
 .../Screens/Edit/Components/EditorSidebar.cs  | 52 ++++++++++
 .../Edit/Components/EditorSidebarSection.cs   | 73 ++++++++++++++
 3 files changed, 222 insertions(+)
 create mode 100644 osu.Game.Tests/Visual/UserInterface/TestSceneEditorSidebar.cs
 create mode 100644 osu.Game/Screens/Edit/Components/EditorSidebar.cs
 create mode 100644 osu.Game/Screens/Edit/Components/EditorSidebarSection.cs

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneEditorSidebar.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneEditorSidebar.cs
new file mode 100644
index 0000000000..7e2b5e0bad
--- /dev/null
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneEditorSidebar.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 System.Linq;
+using NUnit.Framework;
+using osu.Framework.Allocation;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.Shapes;
+using osu.Game.Overlays;
+using osu.Game.Screens.Edit.Components;
+using osuTK;
+using osuTK.Graphics;
+
+namespace osu.Game.Tests.Visual.UserInterface
+{
+    public class TestSceneEditorSidebar : OsuTestScene
+    {
+        [Cached]
+        private readonly OverlayColourProvider colourProvider = new OverlayColourProvider(OverlayColourScheme.Blue);
+
+        [Test]
+        public void TestSidebars()
+        {
+            AddStep("Add sidebars", () =>
+            {
+                Children = new Drawable[]
+                {
+                    new GridContainer
+                    {
+                        RelativeSizeAxes = Axes.Both,
+                        ColumnDimensions = new[]
+                        {
+                            new Dimension(GridSizeMode.AutoSize),
+                            new Dimension(),
+                            new Dimension(GridSizeMode.AutoSize),
+                        },
+                        Content = new[]
+                        {
+                            new Drawable[]
+                            {
+                                new EditorSidebar
+                                {
+                                    Children = new[]
+                                    {
+                                        new EditorSidebarSection("Section 1")
+                                        {
+                                            Child = new FillFlowContainer
+                                            {
+                                                RelativeSizeAxes = Axes.X,
+                                                AutoSizeAxes = Axes.Y,
+                                                Direction = FillDirection.Full,
+                                                Spacing = new Vector2(3),
+                                                ChildrenEnumerable = Enumerable.Range(0, 10).Select(_ => new Box
+                                                {
+                                                    Colour = Color4.White,
+                                                    Size = new Vector2(32),
+                                                })
+                                            },
+                                        },
+                                        new EditorSidebarSection("Section 2")
+                                        {
+                                            Child = new FillFlowContainer
+                                            {
+                                                RelativeSizeAxes = Axes.X,
+                                                AutoSizeAxes = Axes.Y,
+                                                Direction = FillDirection.Full,
+                                                Spacing = new Vector2(3),
+                                                ChildrenEnumerable = Enumerable.Range(0, 400).Select(_ => new Box
+                                                {
+                                                    Colour = Color4.Gray,
+                                                    Size = new Vector2(32),
+                                                })
+                                            },
+                                        },
+                                    },
+                                },
+                                new Container
+                                {
+                                    RelativeSizeAxes = Axes.Both,
+                                },
+                                new EditorSidebar
+                                {
+                                    Children = new[]
+                                    {
+                                        new EditorSidebarSection("Section 1"),
+                                        new EditorSidebarSection("Section 2"),
+                                    },
+                                },
+                            }
+                        }
+                    }
+                };
+            });
+        }
+    }
+}
diff --git a/osu.Game/Screens/Edit/Components/EditorSidebar.cs b/osu.Game/Screens/Edit/Components/EditorSidebar.cs
new file mode 100644
index 0000000000..cd7ef98401
--- /dev/null
+++ b/osu.Game/Screens/Edit/Components/EditorSidebar.cs
@@ -0,0 +1,52 @@
+using osu.Framework.Allocation;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.Shapes;
+using osu.Game.Graphics.Containers;
+using osu.Game.Overlays;
+
+namespace osu.Game.Screens.Edit.Components
+{
+    /// <summary>
+    /// A sidebar area that can be attached to the left or right edge of the screen.
+    /// Houses scrolling sectionised content.
+    /// </summary>
+    internal class EditorSidebar : Container<EditorSidebarSection>
+    {
+        private readonly Box background;
+
+        protected override Container<EditorSidebarSection> Content { get; }
+
+        public EditorSidebar()
+        {
+            Width = 250;
+            RelativeSizeAxes = Axes.Y;
+
+            InternalChildren = new Drawable[]
+            {
+                background = new Box
+                {
+                    RelativeSizeAxes = Axes.Both,
+                },
+                new OsuScrollContainer
+                {
+                    Padding = new MarginPadding { Left = 20 },
+                    ScrollbarOverlapsContent = false,
+                    RelativeSizeAxes = Axes.Both,
+                    Child = Content = new FillFlowContainer<EditorSidebarSection>
+                    {
+                        RelativeSizeAxes = Axes.X,
+                        AutoSizeAxes = Axes.Y,
+                        Direction = FillDirection.Vertical,
+                    },
+                }
+            };
+        }
+
+        [BackgroundDependencyLoader]
+        private void load(OverlayColourProvider colourProvider)
+        {
+            background.Colour = colourProvider.Background5;
+        }
+    }
+}
diff --git a/osu.Game/Screens/Edit/Components/EditorSidebarSection.cs b/osu.Game/Screens/Edit/Components/EditorSidebarSection.cs
new file mode 100644
index 0000000000..5c000471a6
--- /dev/null
+++ b/osu.Game/Screens/Edit/Components/EditorSidebarSection.cs
@@ -0,0 +1,73 @@
+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.Graphics.Sprites;
+using osu.Game.Overlays;
+using osuTK;
+
+namespace osu.Game.Screens.Edit.Components
+{
+    public class EditorSidebarSection : Container
+    {
+        protected override Container<Drawable> Content { get; }
+
+        public EditorSidebarSection(LocalisableString sectionName)
+        {
+            RelativeSizeAxes = Axes.X;
+            AutoSizeAxes = Axes.Y;
+
+            InternalChild = new FillFlowContainer
+            {
+                RelativeSizeAxes = Axes.X,
+                AutoSizeAxes = Axes.Y,
+                Direction = FillDirection.Vertical,
+                Children = new Drawable[]
+                {
+                    new SectionHeader(sectionName),
+                    Content = new FillFlowContainer
+                    {
+                        RelativeSizeAxes = Axes.X,
+                        AutoSizeAxes = Axes.Y,
+                        Direction = FillDirection.Vertical,
+                    },
+                }
+            };
+        }
+
+        public class SectionHeader : CompositeDrawable
+        {
+            private readonly LocalisableString text;
+
+            public SectionHeader(LocalisableString text)
+            {
+                this.text = text;
+
+                Margin = new MarginPadding { Vertical = 10, Horizontal = 5 };
+
+                AutoSizeAxes = Axes.Both;
+            }
+
+            [BackgroundDependencyLoader]
+            private void load(OverlayColourProvider colourProvider)
+            {
+                InternalChildren = new Drawable[]
+                {
+                    new OsuSpriteText
+                    {
+                        Text = text,
+                        Font = OsuFont.Default.With(size: 16, weight: FontWeight.SemiBold),
+                    },
+                    new Circle
+                    {
+                        Y = 18,
+                        Colour = colourProvider.Highlight1,
+                        Size = new Vector2(28, 2),
+                    }
+                };
+            }
+        }
+    }
+}
\ No newline at end of file

From 4ab5d6e3f0b76ad04067fdfb274b188b2c29c0f8 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 15 Mar 2022 16:46:57 +0900
Subject: [PATCH 3440/5547] Remove unnecessary `FillFlowContainer` from section

---
 osu.Game/Screens/Edit/Components/EditorSidebarSection.cs | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Screens/Edit/Components/EditorSidebarSection.cs b/osu.Game/Screens/Edit/Components/EditorSidebarSection.cs
index 5c000471a6..319ad82b79 100644
--- a/osu.Game/Screens/Edit/Components/EditorSidebarSection.cs
+++ b/osu.Game/Screens/Edit/Components/EditorSidebarSection.cs
@@ -27,11 +27,10 @@ namespace osu.Game.Screens.Edit.Components
                 Children = new Drawable[]
                 {
                     new SectionHeader(sectionName),
-                    Content = new FillFlowContainer
+                    Content = new Container
                     {
                         RelativeSizeAxes = Axes.X,
                         AutoSizeAxes = Axes.Y,
-                        Direction = FillDirection.Vertical,
                     },
                 }
             };
@@ -70,4 +69,4 @@ namespace osu.Game.Screens.Edit.Components
             }
         }
     }
-}
\ No newline at end of file
+}

From a0a033520f17b765f91a9a09d346a0cbc115c2b5 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 15 Mar 2022 16:48:14 +0900
Subject: [PATCH 3441/5547] Rider no add licence headers

---
 osu.Game/Screens/Edit/Components/EditorSidebar.cs        | 3 +++
 osu.Game/Screens/Edit/Components/EditorSidebarSection.cs | 3 +++
 2 files changed, 6 insertions(+)

diff --git a/osu.Game/Screens/Edit/Components/EditorSidebar.cs b/osu.Game/Screens/Edit/Components/EditorSidebar.cs
index cd7ef98401..4edcef41b1 100644
--- a/osu.Game/Screens/Edit/Components/EditorSidebar.cs
+++ b/osu.Game/Screens/Edit/Components/EditorSidebar.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 osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Screens/Edit/Components/EditorSidebarSection.cs b/osu.Game/Screens/Edit/Components/EditorSidebarSection.cs
index 319ad82b79..d403694bde 100644
--- a/osu.Game/Screens/Edit/Components/EditorSidebarSection.cs
+++ b/osu.Game/Screens/Edit/Components/EditorSidebarSection.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 osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;

From c56df80106c50e4281aa8a28291c852b99cafecc Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Tue, 15 Mar 2022 20:38:04 +0000
Subject: [PATCH 3442/5547] Fix `PlaylistResultsScreen` test failures

As seen: https://github.com/ppy/osu/pull/17252/checks?check_run_id=5545717506

The `PlaylistsResultsScreen` takes a lease on the `Beatmap` bindable
when entered. During `SetUp`, the `Beatmap` bindable is reassigned but
fails in cases where an existing test instance of the screen hasn't been
exited yet. This fix moves the assignment into the `SetUpSteps` function
after `base.SetUpSteps` is called which will exit the existing screens
first.
---
 .../TestScenePlaylistsResultsScreen.cs        | 19 +++++++++++++++----
 1 file changed, 15 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsResultsScreen.cs b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsResultsScreen.cs
index 67894bab38..82cca1f61e 100644
--- a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsResultsScreen.cs
+++ b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsResultsScreen.cs
@@ -53,12 +53,23 @@ namespace osu.Game.Tests.Visual.Playlists
             userScore.Statistics = new Dictionary<HitResult, int>();
 
             bindHandler();
-
-            // beatmap is required to be an actual beatmap so the scores can get their scores correctly calculated for standardised scoring.
-            // else the tests that rely on ordering will fall over.
-            Beatmap.Value = CreateWorkingBeatmap(Ruleset.Value);
         });
 
+        [SetUpSteps]
+        public override void SetUpSteps()
+        {
+            base.SetUpSteps();
+
+            // Existing test instances of the results screen hold a leased bindable of the beatmap,
+            // so wait for those screens to be cleaned up by the base SetUpSteps before re-assigning
+            AddStep("Create Working Beatmap", () =>
+            {
+                // Beatmap is required to be an actual beatmap so the scores can get their scores correctly calculated for standardised scoring.
+                // else the tests that rely on ordering will fall over.
+                Beatmap.Value = CreateWorkingBeatmap(Ruleset.Value);
+            });
+        }
+
         [Test]
         public void TestShowWithUserScore()
         {

From 1c79083f96dfb6bd9eb848caf02f180f8ff761da Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Tue, 15 Mar 2022 22:15:35 +0000
Subject: [PATCH 3443/5547] Move all `PlaylistResultScreen` test state
 initialisation into `SetUpSteps`

---
 .../TestScenePlaylistsResultsScreen.cs        | 38 +++++++++----------
 1 file changed, 18 insertions(+), 20 deletions(-)

diff --git a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsResultsScreen.cs b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsResultsScreen.cs
index 82cca1f61e..ee9a0e263b 100644
--- a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsResultsScreen.cs
+++ b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsResultsScreen.cs
@@ -40,32 +40,30 @@ namespace osu.Game.Tests.Visual.Playlists
         private int totalCount;
         private ScoreInfo userScore;
 
-        [SetUp]
-        public void Setup() => Schedule(() =>
-        {
-            lowestScoreId = 1;
-            highestScoreId = 1;
-            requestComplete = false;
-            totalCount = 0;
-
-            userScore = TestResources.CreateTestScoreInfo();
-            userScore.TotalScore = 0;
-            userScore.Statistics = new Dictionary<HitResult, int>();
-
-            bindHandler();
-        });
-
         [SetUpSteps]
         public override void SetUpSteps()
         {
             base.SetUpSteps();
 
-            // Existing test instances of the results screen hold a leased bindable of the beatmap,
-            // so wait for those screens to be cleaned up by the base SetUpSteps before re-assigning
-            AddStep("Create Working Beatmap", () =>
+            // Previous test instances of the results screen may still exist at this point so wait for
+            // those screens to be cleaned up by the base SetUpSteps before re-initialising test state.
+            // The the screen also holds a leased Beatmap bindable so reassigning it must happen after
+            // the screen as been exited.
+            AddStep("initialise user scores and beatmap", () =>
             {
-                // Beatmap is required to be an actual beatmap so the scores can get their scores correctly calculated for standardised scoring.
-                // else the tests that rely on ordering will fall over.
+                lowestScoreId = 1;
+                highestScoreId = 1;
+                requestComplete = false;
+                totalCount = 0;
+
+                userScore = TestResources.CreateTestScoreInfo();
+                userScore.TotalScore = 0;
+                userScore.Statistics = new Dictionary<HitResult, int>();
+
+                bindHandler();
+
+                // Beatmap is required to be an actual beatmap so the scores can get their scores correctly
+                // calculated for standardised scoring, else the tests that rely on ordering will fall over.
                 Beatmap.Value = CreateWorkingBeatmap(Ruleset.Value);
             });
         }

From 7621e779fa8667110e1b477c5fba3481627ea7f1 Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Tue, 15 Mar 2022 22:19:58 +0000
Subject: [PATCH 3444/5547] Move `ControlItem` Action assignments into BDL

---
 osu.Game/Overlays/Chat/ChannelControl/ControlItem.cs | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Overlays/Chat/ChannelControl/ControlItem.cs b/osu.Game/Overlays/Chat/ChannelControl/ControlItem.cs
index f2bab64371..d886e8b45a 100644
--- a/osu.Game/Overlays/Chat/ChannelControl/ControlItem.cs
+++ b/osu.Game/Overlays/Chat/ChannelControl/ControlItem.cs
@@ -98,12 +98,15 @@ namespace osu.Game.Overlays.Chat.ChannelControl
                                     Anchor = Anchor.CentreLeft,
                                     Origin = Anchor.CentreLeft,
                                     Margin = new MarginPadding { Right = 3 },
+                                    Action = () => OnRequestLeave?.Invoke(channel),
                                 }
                             }
                         },
                     },
                 },
             };
+
+            Action = () => OnRequestSelect?.Invoke(channel);
         }
 
         protected override void LoadComplete()
@@ -117,9 +120,6 @@ namespace osu.Game.Overlays.Chat.ChannelControl
                 else
                     selectBox?.Hide();
             }, true);
-
-            Action = () => OnRequestSelect?.Invoke(channel);
-            close!.Action = () => OnRequestLeave?.Invoke(channel);
         }
 
         protected override bool OnHover(HoverEvent e)

From 481b8fe80bc043b6a70ad1b799fefd94ba58af06 Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Tue, 15 Mar 2022 22:22:32 +0000
Subject: [PATCH 3445/5547] Use `Orange1` for `ControlItemMention` background
 colour

---
 osu.Game/Overlays/Chat/ChannelControl/ControlItemMention.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/Chat/ChannelControl/ControlItemMention.cs b/osu.Game/Overlays/Chat/ChannelControl/ControlItemMention.cs
index e9172d99ba..5118386977 100644
--- a/osu.Game/Overlays/Chat/ChannelControl/ControlItemMention.cs
+++ b/osu.Game/Overlays/Chat/ChannelControl/ControlItemMention.cs
@@ -39,7 +39,7 @@ namespace osu.Game.Overlays.Chat.ChannelControl
                 new Box
                 {
                     RelativeSizeAxes = Axes.Both,
-                    Colour = osuColour.YellowLight,
+                    Colour = osuColour.Orange1,
                 },
                 countText = new OsuSpriteText
                 {

From 49b74d78670d85ef7a3b159b43b9504c5ff7156a Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Tue, 15 Mar 2022 22:33:36 +0000
Subject: [PATCH 3446/5547] Use `BindTarget` instead of caching for
 `ControlItem` mentions bindable flow

---
 osu.Game/Overlays/Chat/ChannelControl/ControlItem.cs       | 2 +-
 .../Overlays/Chat/ChannelControl/ControlItemMention.cs     | 7 +++----
 2 files changed, 4 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Overlays/Chat/ChannelControl/ControlItem.cs b/osu.Game/Overlays/Chat/ChannelControl/ControlItem.cs
index d886e8b45a..d73ebed817 100644
--- a/osu.Game/Overlays/Chat/ChannelControl/ControlItem.cs
+++ b/osu.Game/Overlays/Chat/ChannelControl/ControlItem.cs
@@ -20,7 +20,6 @@ namespace osu.Game.Overlays.Chat.ChannelControl
         public event Action<Channel>? OnRequestSelect;
         public event Action<Channel>? OnRequestLeave;
 
-        [Cached]
         public readonly BindableInt Mentions = new BindableInt();
 
         [Cached]
@@ -92,6 +91,7 @@ namespace osu.Game.Overlays.Chat.ChannelControl
                                     Anchor = Anchor.CentreLeft,
                                     Origin = Anchor.CentreLeft,
                                     Margin = new MarginPadding { Right = 3 },
+                                    Mentions = { BindTarget = Mentions },
                                 },
                                 close = new ControlItemClose
                                 {
diff --git a/osu.Game/Overlays/Chat/ChannelControl/ControlItemMention.cs b/osu.Game/Overlays/Chat/ChannelControl/ControlItemMention.cs
index 5118386977..beb2713c92 100644
--- a/osu.Game/Overlays/Chat/ChannelControl/ControlItemMention.cs
+++ b/osu.Game/Overlays/Chat/ChannelControl/ControlItemMention.cs
@@ -16,10 +16,9 @@ namespace osu.Game.Overlays.Chat.ChannelControl
 {
     public class ControlItemMention : CircularContainer
     {
-        private OsuSpriteText? countText;
+        public readonly BindableInt Mentions = new BindableInt();
 
-        [Resolved]
-        private BindableInt mentions { get; set; } = null!;
+        private OsuSpriteText? countText;
 
         [Resolved]
         private OsuColour osuColour { get; set; } = null!;
@@ -56,7 +55,7 @@ namespace osu.Game.Overlays.Chat.ChannelControl
         {
             base.LoadComplete();
 
-            mentions.BindValueChanged(change =>
+            Mentions.BindValueChanged(change =>
             {
                 int mentionCount = change.NewValue;
 

From e38d9eafa053a4ddc0e374cbead1063a3f194d8c Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Tue, 15 Mar 2022 22:37:15 +0000
Subject: [PATCH 3447/5547] Use `BindTarget` instead of caching for
 `ControlItem` unread flow

---
 osu.Game/Overlays/Chat/ChannelControl/ControlItem.cs     | 2 +-
 osu.Game/Overlays/Chat/ChannelControl/ControlItemText.cs | 7 +++----
 2 files changed, 4 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Overlays/Chat/ChannelControl/ControlItem.cs b/osu.Game/Overlays/Chat/ChannelControl/ControlItem.cs
index d73ebed817..cc00550965 100644
--- a/osu.Game/Overlays/Chat/ChannelControl/ControlItem.cs
+++ b/osu.Game/Overlays/Chat/ChannelControl/ControlItem.cs
@@ -22,7 +22,6 @@ namespace osu.Game.Overlays.Chat.ChannelControl
 
         public readonly BindableInt Mentions = new BindableInt();
 
-        [Cached]
         public readonly BindableBool Unread = new BindableBool();
 
         private readonly Channel channel;
@@ -85,6 +84,7 @@ namespace osu.Game.Overlays.Chat.ChannelControl
                                 {
                                     Anchor = Anchor.CentreLeft,
                                     Origin = Anchor.CentreLeft,
+                                    Unread = { BindTarget = Unread },
                                 },
                                 new ControlItemMention
                                 {
diff --git a/osu.Game/Overlays/Chat/ChannelControl/ControlItemText.cs b/osu.Game/Overlays/Chat/ChannelControl/ControlItemText.cs
index 89845dfef8..490edb5d28 100644
--- a/osu.Game/Overlays/Chat/ChannelControl/ControlItemText.cs
+++ b/osu.Game/Overlays/Chat/ChannelControl/ControlItemText.cs
@@ -15,13 +15,12 @@ namespace osu.Game.Overlays.Chat.ChannelControl
 {
     public class ControlItemText : Container
     {
+        public readonly BindableBool Unread = new BindableBool();
+
         private readonly Channel channel;
 
         private OsuSpriteText? text;
 
-        [Resolved]
-        private BindableBool unread { get; set; } = null!;
-
         [Resolved]
         private OverlayColourProvider colourProvider { get; set; } = null!;
 
@@ -51,7 +50,7 @@ namespace osu.Game.Overlays.Chat.ChannelControl
         {
             base.LoadComplete();
 
-            unread.BindValueChanged(change =>
+            Unread.BindValueChanged(change =>
             {
                 text!.Colour = change.NewValue ? colourProvider.Content1 : colourProvider.Light3;
             }, true);

From ba1642a680d34ffc5c1f26953735965031542f22 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 16 Mar 2022 17:19:08 +0900
Subject: [PATCH 3448/5547] Allow section headers to wrap

---
 .../UserInterface/TestSceneEditorSidebar.cs   |  2 +-
 .../Edit/Components/EditorSidebarSection.cs   | 32 ++++++++++++-------
 2 files changed, 21 insertions(+), 13 deletions(-)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneEditorSidebar.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneEditorSidebar.cs
index 7e2b5e0bad..f2f475e063 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneEditorSidebar.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneEditorSidebar.cs
@@ -58,7 +58,7 @@ namespace osu.Game.Tests.Visual.UserInterface
                                                 })
                                             },
                                         },
-                                        new EditorSidebarSection("Section 2")
+                                        new EditorSidebarSection("Section with a really long section header")
                                         {
                                             Child = new FillFlowContainer
                                             {
diff --git a/osu.Game/Screens/Edit/Components/EditorSidebarSection.cs b/osu.Game/Screens/Edit/Components/EditorSidebarSection.cs
index d403694bde..3871720562 100644
--- a/osu.Game/Screens/Edit/Components/EditorSidebarSection.cs
+++ b/osu.Game/Screens/Edit/Components/EditorSidebarSection.cs
@@ -7,7 +7,7 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Localisation;
 using osu.Game.Graphics;
-using osu.Game.Graphics.Sprites;
+using osu.Game.Graphics.Containers;
 using osu.Game.Overlays;
 using osuTK;
 
@@ -49,24 +49,32 @@ namespace osu.Game.Screens.Edit.Components
 
                 Margin = new MarginPadding { Vertical = 10, Horizontal = 5 };
 
-                AutoSizeAxes = Axes.Both;
+                RelativeSizeAxes = Axes.X;
+                AutoSizeAxes = Axes.Y;
             }
 
             [BackgroundDependencyLoader]
             private void load(OverlayColourProvider colourProvider)
             {
-                InternalChildren = new Drawable[]
+                InternalChild = new FillFlowContainer
                 {
-                    new OsuSpriteText
+                    RelativeSizeAxes = Axes.X,
+                    AutoSizeAxes = Axes.Y,
+                    Direction = FillDirection.Vertical,
+                    Spacing = new Vector2(2),
+                    Children = new Drawable[]
                     {
-                        Text = text,
-                        Font = OsuFont.Default.With(size: 16, weight: FontWeight.SemiBold),
-                    },
-                    new Circle
-                    {
-                        Y = 18,
-                        Colour = colourProvider.Highlight1,
-                        Size = new Vector2(28, 2),
+                        new OsuTextFlowContainer(cp => cp.Font = OsuFont.Default.With(size: 16, weight: FontWeight.SemiBold))
+                        {
+                            Text = text,
+                            RelativeSizeAxes = Axes.X,
+                            AutoSizeAxes = Axes.Y,
+                        },
+                        new Circle
+                        {
+                            Colour = colourProvider.Highlight1,
+                            Size = new Vector2(28, 2),
+                        }
                     }
                 };
             }

From 1025e1939ba90b96595c3ab0d9fc5a86a3f0527a Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 16 Mar 2022 11:54:18 +0300
Subject: [PATCH 3449/5547] Disable "Adaptive Speed" mod in multiplayer

---
 .../OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs        | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs
index e30ec36e9c..5ccf89e703 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs
@@ -117,6 +117,8 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
 
         protected override BeatmapDetailArea CreateBeatmapDetailArea() => new PlayBeatmapDetailArea();
 
+        protected override bool IsValidMod(Mod mod) => base.IsValidMod(mod) && !(mod is ModAdaptiveSpeed);
+
         protected override bool IsValidFreeMod(Mod mod) => base.IsValidFreeMod(mod) && !(mod is ModTimeRamp) && !(mod is ModRateAdjust);
     }
 }

From 603527d72d09eaf0e727cf075e98fb9cdc78d51c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 16 Mar 2022 18:38:01 +0900
Subject: [PATCH 3450/5547] Fix potential crash when highlighting chat messages

Test failed locally in `TestPublicChannelMention`. This test seems to
specify that the same message may arrive twice with the same ID, so
rather than overthinking this one I propose we just use `FirstOrDefault`.

```csharp
TearDown : System.AggregateException : One or more errors occurred.
(Sequence contains more than one matching element)
  ----> System.InvalidOperationException : Sequence contains more than
one matching element
--TearDown
   at System.Threading.Tasks.Task.ThrowIfExceptional(Boolean
includeTaskCanceledExceptions)
   at System.Threading.Tasks.Task.Wait(Int32 millisecondsTimeout,
CancellationToken cancellationToken)
   at osu.Framework.Extensions.TaskExtensions.WaitSafely(Task task)
   at osu.Framework.Testing.TestScene.checkForErrors()
--InvalidOperationException
   at System.Linq.ThrowHelper.ThrowMoreThanOneMatchException()
   at System.Linq.Enumerable.TryGetSingle[TSource](IEnumerable`1 source,
Func`2 predicate, Boolean& found)
   at System.Linq.Enumerable.SingleOrDefault[TSource](IEnumerable`1
source, Func`2 predicate)
   at
osu.Game.Overlays.Chat.DrawableChannel.<processMessageHighlighting>b__14_0()
in
/Users/dean/Projects/osu/osu.Game/Overlays/Chat/DrawableChannel.cs:line
102
   at osu.Framework.Threading.ScheduledDelegate.RunTaskInternal()
```
---
 osu.Game/Overlays/Chat/DrawableChannel.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/Chat/DrawableChannel.cs b/osu.Game/Overlays/Chat/DrawableChannel.cs
index 632517aa31..161fe1d5be 100644
--- a/osu.Game/Overlays/Chat/DrawableChannel.cs
+++ b/osu.Game/Overlays/Chat/DrawableChannel.cs
@@ -99,7 +99,7 @@ namespace osu.Game.Overlays.Chat
             if (highlightedMessage.Value == null)
                 return;
 
-            var chatLine = chatLines.SingleOrDefault(c => c.Message.Equals(highlightedMessage.Value));
+            var chatLine = chatLines.FirstOrDefault(c => c.Message.Equals(highlightedMessage.Value));
             if (chatLine == null)
                 return;
 

From 2452d84e98fab4a975caef4af19fac619143047d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 16 Mar 2022 18:44:30 +0900
Subject: [PATCH 3451/5547] Add missing `Schedule` call to allow individual
 tests from `TestSceneMessageNotifier` to pass

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

diff --git a/osu.Game.Tests/Visual/Online/TestSceneMessageNotifier.cs b/osu.Game.Tests/Visual/Online/TestSceneMessageNotifier.cs
index 175d2ea36b..2c253650d5 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneMessageNotifier.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneMessageNotifier.cs
@@ -30,7 +30,7 @@ namespace osu.Game.Tests.Visual.Online
         private int messageIdCounter;
 
         [SetUp]
-        public void Setup()
+        public void Setup() => Schedule(() =>
         {
             if (API is DummyAPIAccess daa)
             {
@@ -50,7 +50,7 @@ namespace osu.Game.Tests.Visual.Online
 
                 testContainer.ChatOverlay.Show();
             });
-        }
+        });
 
         private bool dummyAPIHandleRequest(APIRequest request)
         {

From 99e3161cf0a40e6e6bfc70d201a967df29f2bcf2 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 15 Mar 2022 18:00:32 +0900
Subject: [PATCH 3452/5547] Fix `SkinEditor`'s initial target not being a
 `Screen`

---
 osu.Game/Skinning/Editor/SkinEditor.cs        | 14 +++++++++-----
 osu.Game/Skinning/Editor/SkinEditorOverlay.cs | 18 ++++++++++++------
 2 files changed, 21 insertions(+), 11 deletions(-)

diff --git a/osu.Game/Skinning/Editor/SkinEditor.cs b/osu.Game/Skinning/Editor/SkinEditor.cs
index ef26682c03..19c39d23d5 100644
--- a/osu.Game/Skinning/Editor/SkinEditor.cs
+++ b/osu.Game/Skinning/Editor/SkinEditor.cs
@@ -3,7 +3,6 @@
 
 using System;
 using System.Collections.Generic;
-using System.Collections.Specialized;
 using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
@@ -49,16 +48,20 @@ namespace osu.Game.Skinning.Editor
 
         private EditorToolboxGroup settingsToolbox;
 
+        public SkinEditor()
+        {
+        }
+
         public SkinEditor(Drawable targetScreen)
         {
-            RelativeSizeAxes = Axes.Both;
-
             UpdateTargetScreen(targetScreen);
         }
 
         [BackgroundDependencyLoader]
         private void load()
         {
+            RelativeSizeAxes = Axes.Both;
+
             InternalChild = new OsuContextMenuContainer
             {
                 RelativeSizeAxes = Axes.Both,
@@ -155,7 +158,7 @@ namespace osu.Game.Skinning.Editor
                 Scheduler.AddOnce(skinChanged);
             }, true);
 
-            SelectedComponents.BindCollectionChanged(selectionChanged);
+            SelectedComponents.BindCollectionChanged((_, __) => Scheduler.AddOnce(populateSettings), true);
         }
 
         public void UpdateTargetScreen(Drawable targetScreen)
@@ -163,6 +166,7 @@ namespace osu.Game.Skinning.Editor
             this.targetScreen = targetScreen;
 
             SelectedComponents.Clear();
+
             Scheduler.AddOnce(loadBlueprintContainer);
 
             void loadBlueprintContainer()
@@ -224,7 +228,7 @@ namespace osu.Game.Skinning.Editor
             SelectedComponents.Add(component);
         }
 
-        private void selectionChanged(object sender, NotifyCollectionChangedEventArgs e)
+        private void populateSettings()
         {
             settingsToolbox.Clear();
 
diff --git a/osu.Game/Skinning/Editor/SkinEditorOverlay.cs b/osu.Game/Skinning/Editor/SkinEditorOverlay.cs
index 08cdbf0aa9..1bab499979 100644
--- a/osu.Game/Skinning/Editor/SkinEditorOverlay.cs
+++ b/osu.Game/Skinning/Editor/SkinEditorOverlay.cs
@@ -21,16 +21,18 @@ namespace osu.Game.Skinning.Editor
     /// </summary>
     public class SkinEditorOverlay : CompositeDrawable, IKeyBindingHandler<GlobalAction>
     {
-        private readonly ScalingContainer target;
+        private readonly ScalingContainer scalingContainer;
 
         [CanBeNull]
         private SkinEditor skinEditor;
 
         public const float VISIBLE_TARGET_SCALE = 0.8f;
 
-        public SkinEditorOverlay(ScalingContainer target)
+        private Screen lastTargetScreen;
+
+        public SkinEditorOverlay(ScalingContainer scalingContainer)
         {
-            this.target = target;
+            this.scalingContainer = scalingContainer;
             RelativeSizeAxes = Axes.Both;
         }
 
@@ -77,7 +79,7 @@ namespace osu.Game.Skinning.Editor
                 return;
             }
 
-            var editor = new SkinEditor(target);
+            var editor = new SkinEditor();
             editor.State.BindValueChanged(editorVisibilityChanged);
 
             skinEditor = editor;
@@ -95,6 +97,8 @@ namespace osu.Game.Skinning.Editor
                         return;
 
                     AddInternal(editor);
+
+                    SetTarget(lastTargetScreen);
                 });
             });
         }
@@ -105,11 +109,11 @@ namespace osu.Game.Skinning.Editor
 
             if (visibility.NewValue == Visibility.Visible)
             {
-                target.SetCustomRect(new RectangleF(toolbar_padding_requirement, 0.1f, 0.8f - toolbar_padding_requirement, 0.7f), true);
+                scalingContainer.SetCustomRect(new RectangleF(toolbar_padding_requirement, 0.1f, 0.8f - toolbar_padding_requirement, 0.7f), true);
             }
             else
             {
-                target.SetCustomRect(null);
+                scalingContainer.SetCustomRect(null);
             }
         }
 
@@ -122,6 +126,8 @@ namespace osu.Game.Skinning.Editor
         /// </summary>
         public void SetTarget(Screen screen)
         {
+            lastTargetScreen = screen;
+
             if (skinEditor == null) return;
 
             skinEditor.Save();

From 86960c791f783c614ada963bc105f065f42e3cfb Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 15 Mar 2022 18:10:30 +0900
Subject: [PATCH 3453/5547] Close overlays and toolbar on entering the skin
 editor

---
 osu.Game/OsuGame.cs                           |  2 +-
 osu.Game/Skinning/Editor/SkinEditorOverlay.cs | 20 +++++++++++++++----
 2 files changed, 17 insertions(+), 5 deletions(-)

diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index ae117d03d2..25bd3d71de 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -1184,7 +1184,7 @@ namespace osu.Game
                     BackButton.Hide();
             }
 
-            skinEditor.SetTarget((Screen)newScreen);
+            skinEditor.SetTarget((OsuScreen)newScreen);
         }
 
         private void screenPushed(IScreen lastScreen, IScreen newScreen) => screenChanged(lastScreen, newScreen);
diff --git a/osu.Game/Skinning/Editor/SkinEditorOverlay.cs b/osu.Game/Skinning/Editor/SkinEditorOverlay.cs
index 1bab499979..2fdb16abfc 100644
--- a/osu.Game/Skinning/Editor/SkinEditorOverlay.cs
+++ b/osu.Game/Skinning/Editor/SkinEditorOverlay.cs
@@ -3,15 +3,16 @@
 
 using System.Diagnostics;
 using JetBrains.Annotations;
+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.Input.Bindings;
 using osu.Framework.Input.Events;
-using osu.Framework.Screens;
 using osu.Game.Graphics.Containers;
 using osu.Game.Input.Bindings;
+using osu.Game.Screens;
 
 namespace osu.Game.Skinning.Editor
 {
@@ -28,7 +29,10 @@ namespace osu.Game.Skinning.Editor
 
         public const float VISIBLE_TARGET_SCALE = 0.8f;
 
-        private Screen lastTargetScreen;
+        [Resolved(canBeNull: true)]
+        private OsuGame game { get; set; }
+
+        private OsuScreen lastTargetScreen;
 
         public SkinEditorOverlay(ScalingContainer scalingContainer)
         {
@@ -105,15 +109,23 @@ namespace osu.Game.Skinning.Editor
 
         private void editorVisibilityChanged(ValueChangedEvent<Visibility> visibility)
         {
+            Debug.Assert(skinEditor != null);
+
             const float toolbar_padding_requirement = 0.18f;
 
             if (visibility.NewValue == Visibility.Visible)
             {
                 scalingContainer.SetCustomRect(new RectangleF(toolbar_padding_requirement, 0.1f, 0.8f - toolbar_padding_requirement, 0.7f), true);
+
+                game?.Toolbar.Hide();
+                game?.CloseAllOverlays();
             }
             else
             {
                 scalingContainer.SetCustomRect(null);
+
+                if (lastTargetScreen?.HideOverlaysOnEnter != true)
+                    game?.Toolbar.Show();
             }
         }
 
@@ -124,7 +136,7 @@ namespace osu.Game.Skinning.Editor
         /// <summary>
         /// Set a new target screen which will be used to find skinnable components.
         /// </summary>
-        public void SetTarget(Screen screen)
+        public void SetTarget(OsuScreen screen)
         {
             lastTargetScreen = screen;
 
@@ -136,7 +148,7 @@ namespace osu.Game.Skinning.Editor
             Scheduler.AddOnce(setTarget, screen);
         }
 
-        private void setTarget(Screen target)
+        private void setTarget(OsuScreen target)
         {
             Debug.Assert(skinEditor != null);
 

From c807ad7e4ee131563ed45079bfde1e00d4226ae3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 16 Mar 2022 19:11:17 +0900
Subject: [PATCH 3454/5547] Ensure toolbar is hidden even when the active
 screen is changed while the editor is open

---
 osu.Game/Skinning/Editor/SkinEditorOverlay.cs | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Skinning/Editor/SkinEditorOverlay.cs b/osu.Game/Skinning/Editor/SkinEditorOverlay.cs
index 2fdb16abfc..780e3d5b67 100644
--- a/osu.Game/Skinning/Editor/SkinEditorOverlay.cs
+++ b/osu.Game/Skinning/Editor/SkinEditorOverlay.cs
@@ -4,7 +4,6 @@
 using System.Diagnostics;
 using JetBrains.Annotations;
 using osu.Framework.Allocation;
-using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Primitives;
@@ -84,7 +83,7 @@ namespace osu.Game.Skinning.Editor
             }
 
             var editor = new SkinEditor();
-            editor.State.BindValueChanged(editorVisibilityChanged);
+            editor.State.BindValueChanged(visibility => updateComponentVisibility());
 
             skinEditor = editor;
 
@@ -107,13 +106,13 @@ namespace osu.Game.Skinning.Editor
             });
         }
 
-        private void editorVisibilityChanged(ValueChangedEvent<Visibility> visibility)
+        private void updateComponentVisibility()
         {
             Debug.Assert(skinEditor != null);
 
             const float toolbar_padding_requirement = 0.18f;
 
-            if (visibility.NewValue == Visibility.Visible)
+            if (skinEditor.State.Value == Visibility.Visible)
             {
                 scalingContainer.SetCustomRect(new RectangleF(toolbar_padding_requirement, 0.1f, 0.8f - toolbar_padding_requirement, 0.7f), true);
 
@@ -144,6 +143,9 @@ namespace osu.Game.Skinning.Editor
 
             skinEditor.Save();
 
+            // ensure the toolbar is re-hidden even if a new screen decides to try and show it.
+            updateComponentVisibility();
+
             // AddOnce with parameter will ensure the newest target is loaded if there is any overlap.
             Scheduler.AddOnce(setTarget, screen);
         }

From d062810ff2b4c04019f2523faa58e2d3cecca758 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 11 Mar 2022 23:30:46 +0900
Subject: [PATCH 3455/5547] Add basic scene selector

---
 .../Visual/Gameplay/TestSceneSkinEditor.cs    |  2 +-
 osu.Game/Skinning/Editor/SkinEditor.cs        | 53 +++++++++++++++++++
 osu.Game/Skinning/Editor/SkinEditorOverlay.cs |  2 +-
 3 files changed, 55 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSkinEditor.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSkinEditor.cs
index a0602e21b9..9012492028 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSkinEditor.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSkinEditor.cs
@@ -24,7 +24,7 @@ namespace osu.Game.Tests.Visual.Gameplay
             AddStep("reload skin editor", () =>
             {
                 skinEditor?.Expire();
-                Player.ScaleTo(SkinEditorOverlay.VISIBLE_TARGET_SCALE);
+                Player.ScaleTo(0.8f);
                 LoadComponentAsync(skinEditor = new SkinEditor(Player), Add);
             });
         }
diff --git a/osu.Game/Skinning/Editor/SkinEditor.cs b/osu.Game/Skinning/Editor/SkinEditor.cs
index 19c39d23d5..37900d9920 100644
--- a/osu.Game/Skinning/Editor/SkinEditor.cs
+++ b/osu.Game/Skinning/Editor/SkinEditor.cs
@@ -10,14 +10,20 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.UserInterface;
 using osu.Framework.Input.Events;
+using osu.Framework.Screens;
 using osu.Framework.Testing;
 using osu.Game.Configuration;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Cursor;
 using osu.Game.Graphics.UserInterface;
+using osu.Game.Rulesets;
 using osu.Game.Rulesets.Edit;
 using osu.Game.Screens.Edit.Components.Menus;
+using osu.Game.Screens.OnlinePlay.Match.Components;
+using osu.Game.Screens.Play;
+using osu.Game.Screens.Select;
+using osuTK;
 
 namespace osu.Game.Skinning.Editor
 {
@@ -42,6 +48,12 @@ namespace osu.Game.Skinning.Editor
         [Resolved]
         private OsuColour colours { get; set; }
 
+        [Resolved]
+        private IBindable<RulesetInfo> ruleset { get; set; }
+
+        [Resolved(canBeNull: true)]
+        private OsuGame game { get; set; }
+
         private bool hasBegunMutating;
 
         private Container content;
@@ -105,6 +117,47 @@ namespace osu.Game.Skinning.Editor
                             },
                         },
                     },
+                    new FillFlowContainer
+                    {
+                        RelativeSizeAxes = Axes.X,
+                        Y = 45,
+                        Height = 30,
+                        Name = "Scene library",
+                        Spacing = new Vector2(10),
+                        Padding = new MarginPadding(10),
+                        Direction = FillDirection.Horizontal,
+                        Children = new Drawable[]
+                        {
+                            new PurpleTriangleButton
+                            {
+                                Text = "Song Select",
+                                Width = 100,
+                                Height = 30,
+                                Action = () => game?.PerformFromScreen(screen =>
+                                {
+                                    if (screen is SongSelect)
+                                        return;
+
+                                    screen.Push(new PlaySongSelect());
+                                }, new[] { typeof(SongSelect) })
+                            },
+                            new PurpleTriangleButton
+                            {
+                                Text = "Gameplay",
+                                Width = 100,
+                                Height = 30,
+                                Action = () => game?.PerformFromScreen(screen =>
+                                {
+                                    if (screen is Player)
+                                        return;
+
+                                    var replayGeneratingMod = ruleset.Value.CreateInstance().GetAutoplayMod();
+                                    if (replayGeneratingMod != null)
+                                        screen.Push(new ReplayPlayer((beatmap, mods) => replayGeneratingMod.CreateReplayScore(beatmap, mods)));
+                                }, new[] { typeof(Player) })
+                            },
+                        }
+                    },
                     new GridContainer
                     {
                         RelativeSizeAxes = Axes.Both,
diff --git a/osu.Game/Skinning/Editor/SkinEditorOverlay.cs b/osu.Game/Skinning/Editor/SkinEditorOverlay.cs
index 780e3d5b67..9fc233d3e3 100644
--- a/osu.Game/Skinning/Editor/SkinEditorOverlay.cs
+++ b/osu.Game/Skinning/Editor/SkinEditorOverlay.cs
@@ -114,7 +114,7 @@ namespace osu.Game.Skinning.Editor
 
             if (skinEditor.State.Value == Visibility.Visible)
             {
-                scalingContainer.SetCustomRect(new RectangleF(toolbar_padding_requirement, 0.1f, 0.8f - toolbar_padding_requirement, 0.7f), true);
+                scalingContainer.SetCustomRect(new RectangleF(toolbar_padding_requirement, 0.2f, 0.8f - toolbar_padding_requirement, 0.7f), true);
 
                 game?.Toolbar.Hide();
                 game?.CloseAllOverlays();

From 8d85723a62f1e0ad3f0d6b9e2e2480ce877b0b72 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 7 Mar 2022 19:23:57 +0900
Subject: [PATCH 3456/5547] Split out `SceneLibrary` into its own component

---
 osu.Game/Skinning/Editor/SkinEditor.cs | 126 ++++++++++++++++---------
 1 file changed, 82 insertions(+), 44 deletions(-)

diff --git a/osu.Game/Skinning/Editor/SkinEditor.cs b/osu.Game/Skinning/Editor/SkinEditor.cs
index 37900d9920..9d5d496837 100644
--- a/osu.Game/Skinning/Editor/SkinEditor.cs
+++ b/osu.Game/Skinning/Editor/SkinEditor.cs
@@ -6,8 +6,10 @@ using System.Collections.Generic;
 using System.Linq;
 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.Shapes;
 using osu.Framework.Graphics.UserInterface;
 using osu.Framework.Input.Events;
 using osu.Framework.Screens;
@@ -24,6 +26,7 @@ using osu.Game.Screens.OnlinePlay.Match.Components;
 using osu.Game.Screens.Play;
 using osu.Game.Screens.Select;
 using osuTK;
+using osuTK.Graphics;
 
 namespace osu.Game.Skinning.Editor
 {
@@ -48,12 +51,6 @@ namespace osu.Game.Skinning.Editor
         [Resolved]
         private OsuColour colours { get; set; }
 
-        [Resolved]
-        private IBindable<RulesetInfo> ruleset { get; set; }
-
-        [Resolved(canBeNull: true)]
-        private OsuGame game { get; set; }
-
         private bool hasBegunMutating;
 
         private Container content;
@@ -117,47 +114,12 @@ namespace osu.Game.Skinning.Editor
                             },
                         },
                     },
-                    new FillFlowContainer
+                    new SceneLibrary
                     {
                         RelativeSizeAxes = Axes.X,
                         Y = 45,
-                        Height = 30,
-                        Name = "Scene library",
-                        Spacing = new Vector2(10),
-                        Padding = new MarginPadding(10),
-                        Direction = FillDirection.Horizontal,
-                        Children = new Drawable[]
-                        {
-                            new PurpleTriangleButton
-                            {
-                                Text = "Song Select",
-                                Width = 100,
-                                Height = 30,
-                                Action = () => game?.PerformFromScreen(screen =>
-                                {
-                                    if (screen is SongSelect)
-                                        return;
-
-                                    screen.Push(new PlaySongSelect());
-                                }, new[] { typeof(SongSelect) })
-                            },
-                            new PurpleTriangleButton
-                            {
-                                Text = "Gameplay",
-                                Width = 100,
-                                Height = 30,
-                                Action = () => game?.PerformFromScreen(screen =>
-                                {
-                                    if (screen is Player)
-                                        return;
-
-                                    var replayGeneratingMod = ruleset.Value.CreateInstance().GetAutoplayMod();
-                                    if (replayGeneratingMod != null)
-                                        screen.Push(new ReplayPlayer((beatmap, mods) => replayGeneratingMod.CreateReplayScore(beatmap, mods)));
-                                }, new[] { typeof(Player) })
-                            },
-                        }
                     },
+
                     new GridContainer
                     {
                         RelativeSizeAxes = Axes.Both,
@@ -226,7 +188,10 @@ namespace osu.Game.Skinning.Editor
             {
                 content.Children = new Drawable[]
                 {
-                    new SkinBlueprintContainer(targetScreen),
+                    new SkinBlueprintContainer(targetScreen)
+                    {
+                        Margin = new MarginPadding { Top = 100 },
+                    }
                 };
             }
         }
@@ -345,5 +310,78 @@ namespace osu.Game.Skinning.Editor
             foreach (var item in items)
                 availableTargets.FirstOrDefault(t => t.Components.Contains(item))?.Remove(item);
         }
+
+        private class SceneLibrary : CompositeDrawable
+        {
+            public const float HEIGHT = 30;
+            private const float padding = 10;
+
+            [Resolved(canBeNull: true)]
+            private OsuGame game { get; set; }
+
+            [Resolved]
+            private IBindable<RulesetInfo> ruleset { get; set; }
+
+            [BackgroundDependencyLoader]
+            private void load()
+            {
+                InternalChildren = new Drawable[]
+                {
+                    new OsuScrollContainer(Direction.Horizontal)
+                    {
+                        RelativeSizeAxes = Axes.X,
+                        Height = HEIGHT + padding * 2,
+                        Children = new Drawable[]
+                        {
+                            new Box
+                            {
+                                RelativeSizeAxes = Axes.Both,
+                                Colour = Color4.Black.Opacity(0.5f)
+                            },
+                            new FillFlowContainer
+                            {
+                                Name = "Scene library",
+                                AutoSizeAxes = Axes.X,
+                                RelativeSizeAxes = Axes.Y,
+                                Spacing = new Vector2(padding),
+                                Padding = new MarginPadding(padding),
+                                Direction = FillDirection.Horizontal,
+                                Children = new Drawable[]
+                                {
+                                    new PurpleTriangleButton
+                                    {
+                                        Text = "Song Select",
+                                        Width = 100,
+                                        Height = HEIGHT,
+                                        Action = () => game?.PerformFromScreen(screen =>
+                                        {
+                                            if (screen is SongSelect)
+                                                return;
+
+                                            screen.Push(new PlaySongSelect());
+                                        }, new[] { typeof(SongSelect) })
+                                    },
+                                    new PurpleTriangleButton
+                                    {
+                                        Text = "Gameplay",
+                                        Width = 100,
+                                        Height = HEIGHT,
+                                        Action = () => game?.PerformFromScreen(screen =>
+                                        {
+                                            if (screen is Player)
+                                                return;
+
+                                            var replayGeneratingMod = ruleset.Value.CreateInstance().GetAutoplayMod();
+                                            if (replayGeneratingMod != null)
+                                                screen.Push(new ReplayPlayer((beatmap, mods) => replayGeneratingMod.CreateReplayScore(beatmap, mods)));
+                                        }, new[] { typeof(Player), typeof(SongSelect) })
+                                    },
+                                }
+                            },
+                        }
+                    }
+                };
+            }
+        }
     }
 }

From c6aa32a003925fcde04c258409e7685016e9b95e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 7 Mar 2022 23:26:27 +0900
Subject: [PATCH 3457/5547] Add basic song select setup for skinnability

---
 osu.Game/Screens/Select/SongSelect.cs | 5 +++++
 osu.Game/Skinning/DefaultSkin.cs      | 8 ++++++++
 osu.Game/Skinning/SkinnableTarget.cs  | 3 ++-
 3 files changed, 15 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Select/SongSelect.cs b/osu.Game/Screens/Select/SongSelect.cs
index f5b11448f8..2d1a2bce4e 100644
--- a/osu.Game/Screens/Select/SongSelect.cs
+++ b/osu.Game/Screens/Select/SongSelect.cs
@@ -37,6 +37,7 @@ using osu.Game.Graphics.UserInterface;
 using System.Diagnostics;
 using osu.Game.Screens.Play;
 using osu.Game.Database;
+using osu.Game.Skinning;
 
 namespace osu.Game.Screens.Select
 {
@@ -235,6 +236,10 @@ namespace osu.Game.Screens.Select
                         }
                     }
                 },
+                new SkinnableTargetContainer(SkinnableTarget.SongSelect)
+                {
+                    RelativeSizeAxes = Axes.Both,
+                },
             });
 
             if (ShowFooter)
diff --git a/osu.Game/Skinning/DefaultSkin.cs b/osu.Game/Skinning/DefaultSkin.cs
index 951e3f9cc5..7c6d138f4c 100644
--- a/osu.Game/Skinning/DefaultSkin.cs
+++ b/osu.Game/Skinning/DefaultSkin.cs
@@ -70,6 +70,14 @@ namespace osu.Game.Skinning
                 case SkinnableTargetComponent target:
                     switch (target.Target)
                     {
+                        case SkinnableTarget.SongSelect:
+                            var songSelectComponents = new SkinnableTargetComponentsContainer(container =>
+                            {
+                                // do stuff when we need to.
+                            });
+
+                            return songSelectComponents;
+
                         case SkinnableTarget.MainHUDComponents:
                             var skinnableTargetWrapper = new SkinnableTargetComponentsContainer(container =>
                             {
diff --git a/osu.Game/Skinning/SkinnableTarget.cs b/osu.Game/Skinning/SkinnableTarget.cs
index 7b1eae126c..09de8a5d71 100644
--- a/osu.Game/Skinning/SkinnableTarget.cs
+++ b/osu.Game/Skinning/SkinnableTarget.cs
@@ -5,6 +5,7 @@ namespace osu.Game.Skinning
 {
     public enum SkinnableTarget
     {
-        MainHUDComponents
+        MainHUDComponents,
+        SongSelect
     }
 }

From aff6a5a428d6ff232835d844066161b45b0f7f45 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 15 Mar 2022 15:11:47 +0900
Subject: [PATCH 3458/5547] Better align scene selector with menu bar

---
 osu.Game/Skinning/Editor/SkinEditor.cs | 27 +++++++++++++++-----------
 1 file changed, 16 insertions(+), 11 deletions(-)

diff --git a/osu.Game/Skinning/Editor/SkinEditor.cs b/osu.Game/Skinning/Editor/SkinEditor.cs
index 9d5d496837..921849c0aa 100644
--- a/osu.Game/Skinning/Editor/SkinEditor.cs
+++ b/osu.Game/Skinning/Editor/SkinEditor.cs
@@ -26,7 +26,6 @@ using osu.Game.Screens.OnlinePlay.Match.Components;
 using osu.Game.Screens.Play;
 using osu.Game.Screens.Select;
 using osuTK;
-using osuTK.Graphics;
 
 namespace osu.Game.Skinning.Editor
 {
@@ -71,6 +70,8 @@ namespace osu.Game.Skinning.Editor
         {
             RelativeSizeAxes = Axes.Both;
 
+            const float menu_height = 40;
+
             InternalChild = new OsuContextMenuContainer
             {
                 RelativeSizeAxes = Axes.Both,
@@ -78,10 +79,10 @@ namespace osu.Game.Skinning.Editor
                 {
                     new Container
                     {
-                        Name = "Top bar",
+                        Name = "Menu container",
                         RelativeSizeAxes = Axes.X,
                         Depth = float.MinValue,
-                        Height = 40,
+                        Height = menu_height,
                         Children = new Drawable[]
                         {
                             new EditorMenuBar
@@ -117,7 +118,7 @@ namespace osu.Game.Skinning.Editor
                     new SceneLibrary
                     {
                         RelativeSizeAxes = Axes.X,
-                        Y = 45,
+                        Y = menu_height,
                     },
 
                     new GridContainer
@@ -322,22 +323,26 @@ namespace osu.Game.Skinning.Editor
             [Resolved]
             private IBindable<RulesetInfo> ruleset { get; set; }
 
+            public SceneLibrary()
+            {
+                Height = HEIGHT + padding * 2;
+            }
+
             [BackgroundDependencyLoader]
             private void load()
             {
                 InternalChildren = new Drawable[]
                 {
+                    new Box
+                    {
+                        RelativeSizeAxes = Axes.Both,
+                        Colour = Color4Extensions.FromHex("222")
+                    },
                     new OsuScrollContainer(Direction.Horizontal)
                     {
-                        RelativeSizeAxes = Axes.X,
-                        Height = HEIGHT + padding * 2,
+                        RelativeSizeAxes = Axes.Both,
                         Children = new Drawable[]
                         {
-                            new Box
-                            {
-                                RelativeSizeAxes = Axes.Both,
-                                Colour = Color4.Black.Opacity(0.5f)
-                            },
                             new FillFlowContainer
                             {
                                 Name = "Scene library",

From ee3715f5cfe7e10f1f44d4a564ea0977aebc7bbf Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 15 Mar 2022 15:33:01 +0900
Subject: [PATCH 3459/5547] Use `OverlayColourProvider` and adjust metrics to
 roughly match new designs

---
 osu.Game/Skinning/Editor/SkinEditor.cs | 52 ++++++++++++++++++++------
 1 file changed, 40 insertions(+), 12 deletions(-)

diff --git a/osu.Game/Skinning/Editor/SkinEditor.cs b/osu.Game/Skinning/Editor/SkinEditor.cs
index 921849c0aa..b891d63da3 100644
--- a/osu.Game/Skinning/Editor/SkinEditor.cs
+++ b/osu.Game/Skinning/Editor/SkinEditor.cs
@@ -4,9 +4,9 @@
 using System;
 using System.Collections.Generic;
 using System.Linq;
+using JetBrains.Annotations;
 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.Shapes;
@@ -18,11 +18,12 @@ using osu.Game.Configuration;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Cursor;
+using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.UserInterface;
+using osu.Game.Overlays;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Edit;
 using osu.Game.Screens.Edit.Components.Menus;
-using osu.Game.Screens.OnlinePlay.Match.Components;
 using osu.Game.Screens.Play;
 using osu.Game.Screens.Select;
 using osuTK;
@@ -50,6 +51,9 @@ namespace osu.Game.Skinning.Editor
         [Resolved]
         private OsuColour colours { get; set; }
 
+        [Cached]
+        private readonly OverlayColourProvider colourProvider = new OverlayColourProvider(OverlayColourScheme.Blue);
+
         private bool hasBegunMutating;
 
         private Container content;
@@ -314,7 +318,8 @@ namespace osu.Game.Skinning.Editor
 
         private class SceneLibrary : CompositeDrawable
         {
-            public const float HEIGHT = 30;
+            public const float BUTTON_HEIGHT = 40;
+
             private const float padding = 10;
 
             [Resolved(canBeNull: true)]
@@ -325,18 +330,18 @@ namespace osu.Game.Skinning.Editor
 
             public SceneLibrary()
             {
-                Height = HEIGHT + padding * 2;
+                Height = BUTTON_HEIGHT + padding * 2;
             }
 
             [BackgroundDependencyLoader]
-            private void load()
+            private void load(OverlayColourProvider overlayColourProvider)
             {
                 InternalChildren = new Drawable[]
                 {
                     new Box
                     {
                         RelativeSizeAxes = Axes.Both,
-                        Colour = Color4Extensions.FromHex("222")
+                        Colour = overlayColourProvider.Background5,
                     },
                     new OsuScrollContainer(Direction.Horizontal)
                     {
@@ -353,11 +358,18 @@ namespace osu.Game.Skinning.Editor
                                 Direction = FillDirection.Horizontal,
                                 Children = new Drawable[]
                                 {
-                                    new PurpleTriangleButton
+                                    new OsuSpriteText
+                                    {
+                                        Text = "Scene library",
+                                        Anchor = Anchor.CentreLeft,
+                                        Origin = Anchor.CentreLeft,
+                                        Margin = new MarginPadding(10),
+                                    },
+                                    new SceneButton
                                     {
                                         Text = "Song Select",
-                                        Width = 100,
-                                        Height = HEIGHT,
+                                        Anchor = Anchor.CentreLeft,
+                                        Origin = Anchor.CentreLeft,
                                         Action = () => game?.PerformFromScreen(screen =>
                                         {
                                             if (screen is SongSelect)
@@ -366,11 +378,11 @@ namespace osu.Game.Skinning.Editor
                                             screen.Push(new PlaySongSelect());
                                         }, new[] { typeof(SongSelect) })
                                     },
-                                    new PurpleTriangleButton
+                                    new SceneButton
                                     {
                                         Text = "Gameplay",
-                                        Width = 100,
-                                        Height = HEIGHT,
+                                        Anchor = Anchor.CentreLeft,
+                                        Origin = Anchor.CentreLeft,
                                         Action = () => game?.PerformFromScreen(screen =>
                                         {
                                             if (screen is Player)
@@ -387,6 +399,22 @@ namespace osu.Game.Skinning.Editor
                     }
                 };
             }
+
+            private class SceneButton : OsuButton
+            {
+                public SceneButton()
+                {
+                    Width = 100;
+                    Height = BUTTON_HEIGHT;
+                }
+
+                [BackgroundDependencyLoader(true)]
+                private void load([CanBeNull] OverlayColourProvider overlayColourProvider, OsuColour colours)
+                {
+                    BackgroundColour = overlayColourProvider?.Background3 ?? colours.Blue3;
+                    Content.CornerRadius = 5;
+                }
+            }
         }
     }
 }

From b08d4bb8eb12c6d8f7337aa1445b821203cd1c95 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 15 Mar 2022 15:34:04 +0900
Subject: [PATCH 3460/5547] Move `SceneLibrary` implementation to its own file

---
 osu.Game/Skinning/Editor/SkinEditor.cs        | 111 +---------------
 .../Skinning/Editor/SkinEditorSceneLibrary.cs | 123 ++++++++++++++++++
 2 files changed, 124 insertions(+), 110 deletions(-)
 create mode 100644 osu.Game/Skinning/Editor/SkinEditorSceneLibrary.cs

diff --git a/osu.Game/Skinning/Editor/SkinEditor.cs b/osu.Game/Skinning/Editor/SkinEditor.cs
index b891d63da3..acae09ee71 100644
--- a/osu.Game/Skinning/Editor/SkinEditor.cs
+++ b/osu.Game/Skinning/Editor/SkinEditor.cs
@@ -4,29 +4,21 @@
 using System;
 using System.Collections.Generic;
 using System.Linq;
-using JetBrains.Annotations;
 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.Graphics.UserInterface;
 using osu.Framework.Input.Events;
-using osu.Framework.Screens;
 using osu.Framework.Testing;
 using osu.Game.Configuration;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Cursor;
-using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Overlays;
-using osu.Game.Rulesets;
 using osu.Game.Rulesets.Edit;
 using osu.Game.Screens.Edit.Components.Menus;
-using osu.Game.Screens.Play;
-using osu.Game.Screens.Select;
-using osuTK;
 
 namespace osu.Game.Skinning.Editor
 {
@@ -119,7 +111,7 @@ namespace osu.Game.Skinning.Editor
                             },
                         },
                     },
-                    new SceneLibrary
+                    new SkinEditorSceneLibrary
                     {
                         RelativeSizeAxes = Axes.X,
                         Y = menu_height,
@@ -315,106 +307,5 @@ namespace osu.Game.Skinning.Editor
             foreach (var item in items)
                 availableTargets.FirstOrDefault(t => t.Components.Contains(item))?.Remove(item);
         }
-
-        private class SceneLibrary : CompositeDrawable
-        {
-            public const float BUTTON_HEIGHT = 40;
-
-            private const float padding = 10;
-
-            [Resolved(canBeNull: true)]
-            private OsuGame game { get; set; }
-
-            [Resolved]
-            private IBindable<RulesetInfo> ruleset { get; set; }
-
-            public SceneLibrary()
-            {
-                Height = BUTTON_HEIGHT + padding * 2;
-            }
-
-            [BackgroundDependencyLoader]
-            private void load(OverlayColourProvider overlayColourProvider)
-            {
-                InternalChildren = new Drawable[]
-                {
-                    new Box
-                    {
-                        RelativeSizeAxes = Axes.Both,
-                        Colour = overlayColourProvider.Background5,
-                    },
-                    new OsuScrollContainer(Direction.Horizontal)
-                    {
-                        RelativeSizeAxes = Axes.Both,
-                        Children = new Drawable[]
-                        {
-                            new FillFlowContainer
-                            {
-                                Name = "Scene library",
-                                AutoSizeAxes = Axes.X,
-                                RelativeSizeAxes = Axes.Y,
-                                Spacing = new Vector2(padding),
-                                Padding = new MarginPadding(padding),
-                                Direction = FillDirection.Horizontal,
-                                Children = new Drawable[]
-                                {
-                                    new OsuSpriteText
-                                    {
-                                        Text = "Scene library",
-                                        Anchor = Anchor.CentreLeft,
-                                        Origin = Anchor.CentreLeft,
-                                        Margin = new MarginPadding(10),
-                                    },
-                                    new SceneButton
-                                    {
-                                        Text = "Song Select",
-                                        Anchor = Anchor.CentreLeft,
-                                        Origin = Anchor.CentreLeft,
-                                        Action = () => game?.PerformFromScreen(screen =>
-                                        {
-                                            if (screen is SongSelect)
-                                                return;
-
-                                            screen.Push(new PlaySongSelect());
-                                        }, new[] { typeof(SongSelect) })
-                                    },
-                                    new SceneButton
-                                    {
-                                        Text = "Gameplay",
-                                        Anchor = Anchor.CentreLeft,
-                                        Origin = Anchor.CentreLeft,
-                                        Action = () => game?.PerformFromScreen(screen =>
-                                        {
-                                            if (screen is Player)
-                                                return;
-
-                                            var replayGeneratingMod = ruleset.Value.CreateInstance().GetAutoplayMod();
-                                            if (replayGeneratingMod != null)
-                                                screen.Push(new ReplayPlayer((beatmap, mods) => replayGeneratingMod.CreateReplayScore(beatmap, mods)));
-                                        }, new[] { typeof(Player), typeof(SongSelect) })
-                                    },
-                                }
-                            },
-                        }
-                    }
-                };
-            }
-
-            private class SceneButton : OsuButton
-            {
-                public SceneButton()
-                {
-                    Width = 100;
-                    Height = BUTTON_HEIGHT;
-                }
-
-                [BackgroundDependencyLoader(true)]
-                private void load([CanBeNull] OverlayColourProvider overlayColourProvider, OsuColour colours)
-                {
-                    BackgroundColour = overlayColourProvider?.Background3 ?? colours.Blue3;
-                    Content.CornerRadius = 5;
-                }
-            }
-        }
     }
 }
diff --git a/osu.Game/Skinning/Editor/SkinEditorSceneLibrary.cs b/osu.Game/Skinning/Editor/SkinEditorSceneLibrary.cs
new file mode 100644
index 0000000000..5da6147e4c
--- /dev/null
+++ b/osu.Game/Skinning/Editor/SkinEditorSceneLibrary.cs
@@ -0,0 +1,123 @@
+// 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 JetBrains.Annotations;
+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.Screens;
+using osu.Game.Graphics;
+using osu.Game.Graphics.Containers;
+using osu.Game.Graphics.Sprites;
+using osu.Game.Graphics.UserInterface;
+using osu.Game.Overlays;
+using osu.Game.Rulesets;
+using osu.Game.Screens.Play;
+using osu.Game.Screens.Select;
+using osuTK;
+
+namespace osu.Game.Skinning.Editor
+{
+    public class SkinEditorSceneLibrary : CompositeDrawable
+    {
+        public const float BUTTON_HEIGHT = 40;
+
+        private const float padding = 10;
+
+        [Resolved(canBeNull: true)]
+        private OsuGame game { get; set; }
+
+        [Resolved]
+        private IBindable<RulesetInfo> ruleset { get; set; }
+
+        public SkinEditorSceneLibrary()
+        {
+            Height = BUTTON_HEIGHT + padding * 2;
+        }
+
+        [BackgroundDependencyLoader]
+        private void load(OverlayColourProvider overlayColourProvider)
+        {
+            InternalChildren = new Drawable[]
+            {
+                new Box
+                {
+                    RelativeSizeAxes = Axes.Both,
+                    Colour = overlayColourProvider.Background6,
+                },
+                new OsuScrollContainer(Direction.Horizontal)
+                {
+                    RelativeSizeAxes = Axes.Both,
+                    Children = new Drawable[]
+                    {
+                        new FillFlowContainer
+                        {
+                            Name = "Scene library",
+                            AutoSizeAxes = Axes.X,
+                            RelativeSizeAxes = Axes.Y,
+                            Spacing = new Vector2(padding),
+                            Padding = new MarginPadding(padding),
+                            Direction = FillDirection.Horizontal,
+                            Children = new Drawable[]
+                            {
+                                new OsuSpriteText
+                                {
+                                    Text = "Scene library",
+                                    Anchor = Anchor.CentreLeft,
+                                    Origin = Anchor.CentreLeft,
+                                    Margin = new MarginPadding(10),
+                                },
+                                new SceneButton
+                                {
+                                    Text = "Song Select",
+                                    Anchor = Anchor.CentreLeft,
+                                    Origin = Anchor.CentreLeft,
+                                    Action = () => game?.PerformFromScreen(screen =>
+                                    {
+                                        if (screen is SongSelect)
+                                            return;
+
+                                        screen.Push(new PlaySongSelect());
+                                    }, new[] { typeof(SongSelect) })
+                                },
+                                new SceneButton
+                                {
+                                    Text = "Gameplay",
+                                    Anchor = Anchor.CentreLeft,
+                                    Origin = Anchor.CentreLeft,
+                                    Action = () => game?.PerformFromScreen(screen =>
+                                    {
+                                        if (screen is Player)
+                                            return;
+
+                                        var replayGeneratingMod = ruleset.Value.CreateInstance().GetAutoplayMod();
+                                        if (replayGeneratingMod != null)
+                                            screen.Push(new ReplayPlayer((beatmap, mods) => replayGeneratingMod.CreateReplayScore(beatmap, mods)));
+                                    }, new[] { typeof(Player), typeof(SongSelect) })
+                                },
+                            }
+                        },
+                    }
+                }
+            };
+        }
+
+        private class SceneButton : OsuButton
+        {
+            public SceneButton()
+            {
+                Width = 100;
+                Height = BUTTON_HEIGHT;
+            }
+
+            [BackgroundDependencyLoader(true)]
+            private void load([CanBeNull] OverlayColourProvider overlayColourProvider, OsuColour colours)
+            {
+                BackgroundColour = overlayColourProvider?.Background3 ?? colours.Blue3;
+                Content.CornerRadius = 5;
+            }
+        }
+    }
+}

From fdb411c0f3dcd9bf7ea7e5ec4a13028dac551160 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 15 Mar 2022 17:19:20 +0900
Subject: [PATCH 3461/5547] Update skin editor toolbox design to suck less

---
 .../Skinning/Editor/SkinComponentToolbox.cs   | 62 +++++++++----------
 1 file changed, 29 insertions(+), 33 deletions(-)

diff --git a/osu.Game/Skinning/Editor/SkinComponentToolbox.cs b/osu.Game/Skinning/Editor/SkinComponentToolbox.cs
index 2781f1958f..e5fe13b64d 100644
--- a/osu.Game/Skinning/Editor/SkinComponentToolbox.cs
+++ b/osu.Game/Skinning/Editor/SkinComponentToolbox.cs
@@ -6,16 +6,15 @@ using System.Collections.Generic;
 using System.Diagnostics;
 using System.Linq;
 using osu.Framework.Allocation;
-using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
-using osu.Framework.Graphics.Effects;
 using osu.Framework.Input.Events;
 using osu.Framework.Utils;
 using osu.Game.Beatmaps;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.UserInterface;
+using osu.Game.Overlays;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Difficulty;
 using osu.Game.Rulesets.Edit;
@@ -23,7 +22,6 @@ using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Scoring;
 using osu.Game.Rulesets.UI;
 using osuTK;
-using osuTK.Graphics;
 
 namespace osu.Game.Skinning.Editor
 {
@@ -33,8 +31,6 @@ namespace osu.Game.Skinning.Editor
 
         public Action<Type> RequestPlacement;
 
-        private const float component_display_scale = 0.8f;
-
         [Cached]
         private ScoreProcessor scoreProcessor = new ScoreProcessor(new DummyRuleset())
         {
@@ -62,7 +58,7 @@ namespace osu.Game.Skinning.Editor
                 RelativeSizeAxes = Axes.X,
                 AutoSizeAxes = Axes.Y,
                 Direction = FillDirection.Vertical,
-                Spacing = new Vector2(20)
+                Spacing = new Vector2(2)
             };
 
             var skinnableTypes = typeof(OsuGame).Assembly.GetTypes()
@@ -120,39 +116,36 @@ namespace osu.Game.Skinning.Editor
                 Enabled.Value = true;
 
                 RelativeSizeAxes = Axes.X;
-                Height = 70;
+                Height = 60;
             }
 
             [BackgroundDependencyLoader]
-            private void load(OsuColour colours)
+            private void load(OverlayColourProvider colourProvider, OsuColour colours)
             {
-                BackgroundColour = colours.Gray3;
-                Content.EdgeEffect = new EdgeEffectParameters
-                {
-                    Type = EdgeEffectType.Shadow,
-                    Radius = 2,
-                    Offset = new Vector2(0, 1),
-                    Colour = Color4.Black.Opacity(0.5f)
-                };
+                BackgroundColour = colourProvider.Background3;
 
                 AddRange(new Drawable[]
                 {
+                    new Container
+                    {
+                        RelativeSizeAxes = Axes.Both,
+                        Padding = new MarginPadding(10) { Bottom = 20 },
+                        Masking = true,
+                        Child = innerContainer = new Container
+                        {
+                            RelativeSizeAxes = Axes.Both,
+                            Anchor = Anchor.Centre,
+                            Origin = Anchor.Centre,
+                            Child = component
+                        },
+                    },
                     new OsuSpriteText
                     {
                         Text = component.GetType().Name,
-                        Anchor = Anchor.TopCentre,
-                        Origin = Anchor.TopCentre,
+                        Anchor = Anchor.BottomCentre,
+                        Origin = Anchor.BottomCentre,
+                        Margin = new MarginPadding(5),
                     },
-                    innerContainer = new Container
-                    {
-                        Y = 10,
-                        Anchor = Anchor.Centre,
-                        Origin = Anchor.Centre,
-                        RelativeSizeAxes = Axes.Both,
-                        Scale = new Vector2(component_display_scale),
-                        Masking = true,
-                        Child = component
-                    }
                 });
 
                 // adjust provided component to fit / display in a known state.
@@ -160,14 +153,17 @@ namespace osu.Game.Skinning.Editor
                 component.Origin = Anchor.Centre;
             }
 
-            protected override void LoadComplete()
+            protected override void Update()
             {
-                base.LoadComplete();
+                base.Update();
 
-                if (component.RelativeSizeAxes != Axes.None)
+                if (component.DrawSize != Vector2.Zero)
                 {
-                    innerContainer.AutoSizeAxes = Axes.None;
-                    innerContainer.Height = 100;
+                    float bestScale = Math.Min(
+                        innerContainer.DrawWidth / component.DrawWidth,
+                        innerContainer.DrawHeight / component.DrawHeight);
+
+                    innerContainer.Scale = new Vector2(bestScale);
                 }
             }
 

From e4a6b7ae9139ec2b8600accc717fcad1e525a3cc Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 15 Mar 2022 17:33:06 +0900
Subject: [PATCH 3462/5547] Expand toolbox component items on hover

---
 .../Skinning/Editor/SkinComponentToolbox.cs     | 17 ++++++++++++++++-
 1 file changed, 16 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Skinning/Editor/SkinComponentToolbox.cs b/osu.Game/Skinning/Editor/SkinComponentToolbox.cs
index e5fe13b64d..3980163a9d 100644
--- a/osu.Game/Skinning/Editor/SkinComponentToolbox.cs
+++ b/osu.Game/Skinning/Editor/SkinComponentToolbox.cs
@@ -109,6 +109,9 @@ namespace osu.Game.Skinning.Editor
 
             private Container innerContainer;
 
+            private const float contracted_size = 60;
+            private const float expanded_size = 120;
+
             public ToolboxComponentButton(Drawable component)
             {
                 this.component = component;
@@ -116,7 +119,19 @@ namespace osu.Game.Skinning.Editor
                 Enabled.Value = true;
 
                 RelativeSizeAxes = Axes.X;
-                Height = 60;
+                Height = contracted_size;
+            }
+
+            protected override bool OnHover(HoverEvent e)
+            {
+                this.Delay(300).ResizeHeightTo(expanded_size, 500, Easing.OutQuint);
+                return base.OnHover(e);
+            }
+
+            protected override void OnHoverLost(HoverLostEvent e)
+            {
+                base.OnHoverLost(e);
+                this.ResizeHeightTo(contracted_size, 500, Easing.OutQuint);
             }
 
             [BackgroundDependencyLoader]

From 59cb1ac126bed54c93ccc600cc134696d7d82482 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 15 Mar 2022 17:35:25 +0900
Subject: [PATCH 3463/5547] Order components by name for now

---
 osu.Game/Skinning/Editor/SkinComponentToolbox.cs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Game/Skinning/Editor/SkinComponentToolbox.cs b/osu.Game/Skinning/Editor/SkinComponentToolbox.cs
index 3980163a9d..98fdc7c93f 100644
--- a/osu.Game/Skinning/Editor/SkinComponentToolbox.cs
+++ b/osu.Game/Skinning/Editor/SkinComponentToolbox.cs
@@ -64,6 +64,7 @@ namespace osu.Game.Skinning.Editor
             var skinnableTypes = typeof(OsuGame).Assembly.GetTypes()
                                                 .Where(t => !t.IsInterface)
                                                 .Where(t => typeof(ISkinnableDrawable).IsAssignableFrom(t))
+                                                .OrderBy(t => t.Name)
                                                 .ToArray();
 
             foreach (var type in skinnableTypes)

From 4525ed645c4c844c21774eeb6b2ced2e0028c3e9 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 15 Mar 2022 16:36:04 +0900
Subject: [PATCH 3464/5547] Update skin editor to use `EditorSidebar`

---
 .../TestSceneSkinEditorComponentsList.cs      | 12 ++++++---
 .../Skinning/Editor/SkinComponentToolbox.cs   | 12 +++------
 osu.Game/Skinning/Editor/SkinEditor.cs        | 27 +++++++++++++------
 .../Skinning/Editor/SkinSettingsToolbox.cs    | 20 ++++++++------
 4 files changed, 44 insertions(+), 27 deletions(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSkinEditorComponentsList.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSkinEditorComponentsList.cs
index 58c89411c0..5385a9983b 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSkinEditorComponentsList.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSkinEditorComponentsList.cs
@@ -2,7 +2,9 @@
 // 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.Game.Overlays;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Osu;
 using osu.Game.Skinning.Editor;
@@ -11,13 +13,17 @@ namespace osu.Game.Tests.Visual.Gameplay
 {
     public class TestSceneSkinEditorComponentsList : SkinnableTestScene
     {
+        [Cached]
+        private readonly OverlayColourProvider colourProvider = new OverlayColourProvider(OverlayColourScheme.Blue);
+
         [Test]
         public void TestToggleEditor()
         {
-            AddStep("show available components", () => SetContents(_ => new SkinComponentToolbox(300)
+            AddStep("show available components", () => SetContents(_ => new SkinComponentToolbox
             {
-                Anchor = Anchor.TopCentre,
-                Origin = Anchor.TopCentre,
+                Anchor = Anchor.TopRight,
+                Origin = Anchor.TopRight,
+                Width = 0.6f,
             }));
         }
 
diff --git a/osu.Game/Skinning/Editor/SkinComponentToolbox.cs b/osu.Game/Skinning/Editor/SkinComponentToolbox.cs
index 2781f1958f..05da229c3e 100644
--- a/osu.Game/Skinning/Editor/SkinComponentToolbox.cs
+++ b/osu.Game/Skinning/Editor/SkinComponentToolbox.cs
@@ -18,19 +18,17 @@ using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Difficulty;
-using osu.Game.Rulesets.Edit;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Scoring;
 using osu.Game.Rulesets.UI;
+using osu.Game.Screens.Edit.Components;
 using osuTK;
 using osuTK.Graphics;
 
 namespace osu.Game.Skinning.Editor
 {
-    public class SkinComponentToolbox : ScrollingToolboxGroup
+    public class SkinComponentToolbox : EditorSidebarSection
     {
-        public const float WIDTH = 200;
-
         public Action<Type> RequestPlacement;
 
         private const float component_display_scale = 0.8f;
@@ -45,11 +43,9 @@ namespace osu.Game.Skinning.Editor
         [Cached(typeof(HealthProcessor))]
         private HealthProcessor healthProcessor = new DrainingHealthProcessor(0);
 
-        public SkinComponentToolbox(float height)
-            : base("Components", height)
+        public SkinComponentToolbox()
+            : base("Components")
         {
-            RelativeSizeAxes = Axes.None;
-            Width = WIDTH;
         }
 
         [BackgroundDependencyLoader]
diff --git a/osu.Game/Skinning/Editor/SkinEditor.cs b/osu.Game/Skinning/Editor/SkinEditor.cs
index acae09ee71..381f7a1cc3 100644
--- a/osu.Game/Skinning/Editor/SkinEditor.cs
+++ b/osu.Game/Skinning/Editor/SkinEditor.cs
@@ -18,6 +18,7 @@ using osu.Game.Graphics.Cursor;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Overlays;
 using osu.Game.Rulesets.Edit;
+using osu.Game.Screens.Edit.Components;
 using osu.Game.Screens.Edit.Components.Menus;
 
 namespace osu.Game.Skinning.Editor
@@ -130,21 +131,31 @@ namespace osu.Game.Skinning.Editor
                         {
                             new Drawable[]
                             {
-                                new SkinComponentToolbox(600)
+                                new EditorSidebar
                                 {
-                                    Anchor = Anchor.CentreLeft,
-                                    Origin = Anchor.CentreLeft,
-                                    RequestPlacement = placeComponent
+                                    Children = new[]
+                                    {
+                                        new SkinComponentToolbox
+                                        {
+                                            RequestPlacement = placeComponent
+                                        },
+                                    }
                                 },
                                 content = new Container
                                 {
                                     RelativeSizeAxes = Axes.Both,
                                 },
-                                settingsToolbox = new SkinSettingsToolbox
+                                new EditorSidebar
                                 {
-                                    Anchor = Anchor.CentreRight,
-                                    Origin = Anchor.CentreRight,
-                                }
+                                    Children = new[]
+                                    {
+                                        settingsToolbox = new SkinSettingsToolbox
+                                        {
+                                            Anchor = Anchor.CentreRight,
+                                            Origin = Anchor.CentreRight,
+                                        }
+                                    }
+                                },
                             }
                         }
                     }
diff --git a/osu.Game/Skinning/Editor/SkinSettingsToolbox.cs b/osu.Game/Skinning/Editor/SkinSettingsToolbox.cs
index c0ef8e7316..fc06d3647a 100644
--- a/osu.Game/Skinning/Editor/SkinSettingsToolbox.cs
+++ b/osu.Game/Skinning/Editor/SkinSettingsToolbox.cs
@@ -2,22 +2,26 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using osu.Framework.Graphics;
-using osu.Game.Rulesets.Edit;
+using osu.Framework.Graphics.Containers;
+using osu.Game.Screens.Edit.Components;
 using osuTK;
 
 namespace osu.Game.Skinning.Editor
 {
-    internal class SkinSettingsToolbox : ScrollingToolboxGroup
+    internal class SkinSettingsToolbox : EditorSidebarSection
     {
-        public const float WIDTH = 200;
+        protected override Container<Drawable> Content { get; }
 
         public SkinSettingsToolbox()
-            : base("Settings", 600)
+            : base("Settings")
         {
-            RelativeSizeAxes = Axes.None;
-            Width = WIDTH;
-
-            FillFlow.Spacing = new Vector2(10);
+            base.Content.Add(Content = new FillFlowContainer
+            {
+                RelativeSizeAxes = Axes.X,
+                AutoSizeAxes = Axes.Y,
+                Direction = FillDirection.Vertical,
+                Spacing = new Vector2(10),
+            });
         }
     }
 }

From 54e351efe9e6dfe53fe13034108a454ff480ab03 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 15 Mar 2022 16:57:39 +0900
Subject: [PATCH 3465/5547] Convert top level skin editor layout to use grid
 container

Fix `SkinEditor`'s initial target not being a `Screen`
---
 osu.Game/Skinning/Editor/SkinEditor.cs | 180 +++++++++++++------------
 1 file changed, 95 insertions(+), 85 deletions(-)

diff --git a/osu.Game/Skinning/Editor/SkinEditor.cs b/osu.Game/Skinning/Editor/SkinEditor.cs
index 381f7a1cc3..f7e5aeecdf 100644
--- a/osu.Game/Skinning/Editor/SkinEditor.cs
+++ b/osu.Game/Skinning/Editor/SkinEditor.cs
@@ -17,7 +17,6 @@ using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Cursor;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Overlays;
-using osu.Game.Rulesets.Edit;
 using osu.Game.Screens.Edit.Components;
 using osu.Game.Screens.Edit.Components.Menus;
 
@@ -51,7 +50,7 @@ namespace osu.Game.Skinning.Editor
 
         private Container content;
 
-        private EditorToolboxGroup settingsToolbox;
+        private EditorSidebarSection settingsToolbox;
 
         public SkinEditor()
         {
@@ -72,92 +71,111 @@ namespace osu.Game.Skinning.Editor
             InternalChild = new OsuContextMenuContainer
             {
                 RelativeSizeAxes = Axes.Both,
-                Children = new Drawable[]
+                Child = new GridContainer
                 {
-                    new Container
+                    RelativeSizeAxes = Axes.Both,
+                    RowDimensions = new[]
                     {
-                        Name = "Menu container",
-                        RelativeSizeAxes = Axes.X,
-                        Depth = float.MinValue,
-                        Height = menu_height,
-                        Children = new Drawable[]
-                        {
-                            new EditorMenuBar
-                            {
-                                Anchor = Anchor.CentreLeft,
-                                Origin = Anchor.CentreLeft,
-                                RelativeSizeAxes = Axes.Both,
-                                Items = new[]
-                                {
-                                    new MenuItem("File")
-                                    {
-                                        Items = new[]
-                                        {
-                                            new EditorMenuItem("Save", MenuItemType.Standard, Save),
-                                            new EditorMenuItem("Revert to default", MenuItemType.Destructive, revert),
-                                            new EditorMenuItemSpacer(),
-                                            new EditorMenuItem("Exit", MenuItemType.Standard, Hide),
-                                        },
-                                    },
-                                }
-                            },
-                            headerText = new OsuTextFlowContainer
-                            {
-                                TextAnchor = Anchor.TopRight,
-                                Padding = new MarginPadding(5),
-                                Anchor = Anchor.TopRight,
-                                Origin = Anchor.TopRight,
-                                AutoSizeAxes = Axes.X,
-                                RelativeSizeAxes = Axes.Y,
-                            },
-                        },
-                    },
-                    new SkinEditorSceneLibrary
-                    {
-                        RelativeSizeAxes = Axes.X,
-                        Y = menu_height,
+                        new Dimension(GridSizeMode.AutoSize),
+                        new Dimension(GridSizeMode.AutoSize),
+                        new Dimension(),
                     },
 
-                    new GridContainer
+                    Content = new[]
                     {
-                        RelativeSizeAxes = Axes.Both,
-                        ColumnDimensions = new[]
+                        new Drawable[]
                         {
-                            new Dimension(GridSizeMode.AutoSize),
-                            new Dimension(),
-                            new Dimension(GridSizeMode.AutoSize),
-                        },
-                        Content = new[]
-                        {
-                            new Drawable[]
+                            new Container
                             {
-                                new EditorSidebar
+                                Name = "Menu container",
+                                RelativeSizeAxes = Axes.X,
+                                Depth = float.MinValue,
+                                Height = menu_height,
+                                Children = new Drawable[]
                                 {
-                                    Children = new[]
+                                    new EditorMenuBar
                                     {
-                                        new SkinComponentToolbox
+                                        Anchor = Anchor.CentreLeft,
+                                        Origin = Anchor.CentreLeft,
+                                        RelativeSizeAxes = Axes.Both,
+                                        Items = new[]
                                         {
-                                            RequestPlacement = placeComponent
+                                            new MenuItem("File")
+                                            {
+                                                Items = new[]
+                                                {
+                                                    new EditorMenuItem("Save", MenuItemType.Standard, Save),
+                                                    new EditorMenuItem("Revert to default", MenuItemType.Destructive, revert),
+                                                    new EditorMenuItemSpacer(),
+                                                    new EditorMenuItem("Exit", MenuItemType.Standard, Hide),
+                                                },
+                                            },
+                                        }
+                                    },
+                                    headerText = new OsuTextFlowContainer
+                                    {
+                                        TextAnchor = Anchor.TopRight,
+                                        Padding = new MarginPadding(5),
+                                        Anchor = Anchor.TopRight,
+                                        Origin = Anchor.TopRight,
+                                        AutoSizeAxes = Axes.X,
+                                        RelativeSizeAxes = Axes.Y,
+                                    },
+                                },
+                            },
+                        },
+                        new Drawable[]
+                        {
+                            new SkinEditorSceneLibrary
+                            {
+                                RelativeSizeAxes = Axes.X,
+                            },
+                        },
+                        new Drawable[]
+                        {
+                            new GridContainer
+                            {
+                                RelativeSizeAxes = Axes.Both,
+                                ColumnDimensions = new[]
+                                {
+                                    new Dimension(GridSizeMode.AutoSize),
+                                    new Dimension(),
+                                    new Dimension(GridSizeMode.AutoSize),
+                                },
+                                Content = new[]
+                                {
+                                    new Drawable[]
+                                    {
+                                        new EditorSidebar
+                                        {
+                                            Children = new[]
+                                            {
+                                                new SkinComponentToolbox
+                                                {
+                                                    RequestPlacement = placeComponent
+                                                },
+                                            }
+                                        },
+                                        content = new Container
+                                        {
+                                            Depth = float.MaxValue,
+                                            RelativeSizeAxes = Axes.Both,
+                                        },
+                                        new EditorSidebar
+                                        {
+                                            Children = new[]
+                                            {
+                                                settingsToolbox = new SkinSettingsToolbox
+                                                {
+                                                    Anchor = Anchor.CentreRight,
+                                                    Origin = Anchor.CentreRight,
+                                                }
+                                            }
                                         },
                                     }
-                                },
-                                content = new Container
-                                {
-                                    RelativeSizeAxes = Axes.Both,
-                                },
-                                new EditorSidebar
-                                {
-                                    Children = new[]
-                                    {
-                                        settingsToolbox = new SkinSettingsToolbox
-                                        {
-                                            Anchor = Anchor.CentreRight,
-                                            Origin = Anchor.CentreRight,
-                                        }
-                                    }
-                                },
+                                }
                             }
-                        }
+                        },
                     }
                 }
             };
@@ -191,17 +209,9 @@ namespace osu.Game.Skinning.Editor
             SelectedComponents.Clear();
 
             Scheduler.AddOnce(loadBlueprintContainer);
+            Scheduler.AddOnce(populateSettings);
 
-            void loadBlueprintContainer()
-            {
-                content.Children = new Drawable[]
-                {
-                    new SkinBlueprintContainer(targetScreen)
-                    {
-                        Margin = new MarginPadding { Top = 100 },
-                    }
-                };
-            }
+            void loadBlueprintContainer() => content.Child = new SkinBlueprintContainer(targetScreen);
         }
 
         private void skinChanged()

From 27122c17c91e1b2e0e5cc14a5f13c37d6123ef64 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 15 Mar 2022 17:41:20 +0900
Subject: [PATCH 3466/5547] Show settings for multiple components in a
 selection

---
 osu.Game/Skinning/Editor/SkinEditor.cs        | 25 ++++---------------
 .../Skinning/Editor/SkinSettingsToolbox.cs    |  7 ++++--
 2 files changed, 10 insertions(+), 22 deletions(-)

diff --git a/osu.Game/Skinning/Editor/SkinEditor.cs b/osu.Game/Skinning/Editor/SkinEditor.cs
index f7e5aeecdf..6fe3df6e8a 100644
--- a/osu.Game/Skinning/Editor/SkinEditor.cs
+++ b/osu.Game/Skinning/Editor/SkinEditor.cs
@@ -11,7 +11,6 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.UserInterface;
 using osu.Framework.Input.Events;
 using osu.Framework.Testing;
-using osu.Game.Configuration;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Cursor;
@@ -50,7 +49,7 @@ namespace osu.Game.Skinning.Editor
 
         private Container content;
 
-        private EditorSidebarSection settingsToolbox;
+        private EditorSidebar settingsSidebar;
 
         public SkinEditor()
         {
@@ -161,17 +160,7 @@ namespace osu.Game.Skinning.Editor
                                             Depth = float.MaxValue,
                                             RelativeSizeAxes = Axes.Both,
                                         },
-                                        new EditorSidebar
-                                        {
-                                            Children = new[]
-                                            {
-                                                settingsToolbox = new SkinSettingsToolbox
-                                                {
-                                                    Anchor = Anchor.CentreRight,
-                                                    Origin = Anchor.CentreRight,
-                                                }
-                                            }
-                                        },
+                                        settingsSidebar = new EditorSidebar(),
                                     }
                                 }
                             }
@@ -266,14 +255,10 @@ namespace osu.Game.Skinning.Editor
 
         private void populateSettings()
         {
-            settingsToolbox.Clear();
+            settingsSidebar.Clear();
 
-            var first = SelectedComponents.OfType<Drawable>().FirstOrDefault();
-
-            if (first != null)
-            {
-                settingsToolbox.Children = first.CreateSettingsControls().ToArray();
-            }
+            foreach (var component in SelectedComponents.OfType<Drawable>())
+                settingsSidebar.Add(new SkinSettingsToolbox(component));
         }
 
         private IEnumerable<ISkinnableTarget> availableTargets => targetScreen.ChildrenOfType<ISkinnableTarget>();
diff --git a/osu.Game/Skinning/Editor/SkinSettingsToolbox.cs b/osu.Game/Skinning/Editor/SkinSettingsToolbox.cs
index fc06d3647a..d2823ed0e4 100644
--- a/osu.Game/Skinning/Editor/SkinSettingsToolbox.cs
+++ b/osu.Game/Skinning/Editor/SkinSettingsToolbox.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.Linq;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
+using osu.Game.Configuration;
 using osu.Game.Screens.Edit.Components;
 using osuTK;
 
@@ -12,8 +14,8 @@ namespace osu.Game.Skinning.Editor
     {
         protected override Container<Drawable> Content { get; }
 
-        public SkinSettingsToolbox()
-            : base("Settings")
+        public SkinSettingsToolbox(Drawable component)
+            : base($"Settings ({component.GetType().Name})")
         {
             base.Content.Add(Content = new FillFlowContainer
             {
@@ -21,6 +23,7 @@ namespace osu.Game.Skinning.Editor
                 AutoSizeAxes = Axes.Y,
                 Direction = FillDirection.Vertical,
                 Spacing = new Vector2(10),
+                Children = component.CreateSettingsControls().ToArray()
             });
         }
     }

From cc356bcfe4afacb6392e22bdfa665cf4f3249cc9 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 15 Mar 2022 18:57:53 +0900
Subject: [PATCH 3467/5547] Show components available for current screen only
 (using actual live dependencies)

---
 .../Skinning/Editor/SkinComponentToolbox.cs   | 76 ++++++++-----------
 osu.Game/Skinning/Editor/SkinEditor.cs        | 31 ++++----
 2 files changed, 47 insertions(+), 60 deletions(-)

diff --git a/osu.Game/Skinning/Editor/SkinComponentToolbox.cs b/osu.Game/Skinning/Editor/SkinComponentToolbox.cs
index 483e365e78..9c4a369c1d 100644
--- a/osu.Game/Skinning/Editor/SkinComponentToolbox.cs
+++ b/osu.Game/Skinning/Editor/SkinComponentToolbox.cs
@@ -2,24 +2,16 @@
 // 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.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Input.Events;
-using osu.Framework.Utils;
-using osu.Game.Beatmaps;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Overlays;
-using osu.Game.Rulesets;
-using osu.Game.Rulesets.Difficulty;
-using osu.Game.Rulesets.Mods;
-using osu.Game.Rulesets.Scoring;
-using osu.Game.Rulesets.UI;
 using osu.Game.Screens.Edit.Components;
 using osuTK;
 
@@ -29,26 +21,19 @@ namespace osu.Game.Skinning.Editor
     {
         public Action<Type> RequestPlacement;
 
-        [Cached]
-        private ScoreProcessor scoreProcessor = new ScoreProcessor(new DummyRuleset())
-        {
-            Combo = { Value = RNG.Next(1, 1000) },
-            TotalScore = { Value = RNG.Next(1000, 10000000) }
-        };
+        private readonly CompositeDrawable target;
 
-        [Cached(typeof(HealthProcessor))]
-        private HealthProcessor healthProcessor = new DrainingHealthProcessor(0);
-
-        public SkinComponentToolbox()
+        public SkinComponentToolbox(CompositeDrawable target = null)
             : base("Components")
         {
+            this.target = target;
         }
 
+        private FillFlowContainer fill;
+
         [BackgroundDependencyLoader]
         private void load()
         {
-            FillFlowContainer fill;
-
             Child = fill = new FillFlowContainer
             {
                 RelativeSizeAxes = Axes.X,
@@ -57,6 +42,13 @@ namespace osu.Game.Skinning.Editor
                 Spacing = new Vector2(2)
             };
 
+            reloadComponents();
+        }
+
+        private void reloadComponents()
+        {
+            fill.Clear();
+
             var skinnableTypes = typeof(OsuGame).Assembly.GetTypes()
                                                 .Where(t => !t.IsInterface)
                                                 .Where(t => typeof(ISkinnableDrawable).IsAssignableFrom(t))
@@ -64,18 +56,10 @@ namespace osu.Game.Skinning.Editor
                                                 .ToArray();
 
             foreach (var type in skinnableTypes)
-            {
-                var component = attemptAddComponent(type);
-
-                if (component != null)
-                {
-                    component.RequestPlacement = t => RequestPlacement?.Invoke(t);
-                    fill.Add(component);
-                }
-            }
+                attemptAddComponent(type);
         }
 
-        private static ToolboxComponentButton attemptAddComponent(Type type)
+        private void attemptAddComponent(Type type)
         {
             try
             {
@@ -83,14 +67,15 @@ namespace osu.Game.Skinning.Editor
 
                 Debug.Assert(instance != null);
 
-                if (!((ISkinnableDrawable)instance).IsEditable)
-                    return null;
+                if (!((ISkinnableDrawable)instance).IsEditable) return;
 
-                return new ToolboxComponentButton(instance);
+                fill.Add(new ToolboxComponentButton(instance, target)
+                {
+                    RequestPlacement = t => RequestPlacement?.Invoke(t)
+                });
             }
             catch
             {
-                return null;
             }
         }
 
@@ -101,6 +86,7 @@ namespace osu.Game.Skinning.Editor
             public override bool PropagateNonPositionalInputSubTree => false;
 
             private readonly Drawable component;
+            private readonly CompositeDrawable dependencySource;
 
             public Action<Type> RequestPlacement;
 
@@ -109,9 +95,10 @@ namespace osu.Game.Skinning.Editor
             private const float contracted_size = 60;
             private const float expanded_size = 120;
 
-            public ToolboxComponentButton(Drawable component)
+            public ToolboxComponentButton(Drawable component, CompositeDrawable dependencySource)
             {
                 this.component = component;
+                this.dependencySource = dependencySource;
 
                 Enabled.Value = true;
 
@@ -143,7 +130,7 @@ namespace osu.Game.Skinning.Editor
                         RelativeSizeAxes = Axes.Both,
                         Padding = new MarginPadding(10) { Bottom = 20 },
                         Masking = true,
-                        Child = innerContainer = new Container
+                        Child = innerContainer = new DependencyBorrowingContainer(dependencySource)
                         {
                             RelativeSizeAxes = Axes.Both,
                             Anchor = Anchor.Centre,
@@ -186,14 +173,17 @@ namespace osu.Game.Skinning.Editor
             }
         }
 
-        private class DummyRuleset : Ruleset
+        public class DependencyBorrowingContainer : Container
         {
-            public override IEnumerable<Mod> GetModsFor(ModType type) => throw new NotImplementedException();
-            public override DrawableRuleset CreateDrawableRulesetWith(IBeatmap beatmap, IReadOnlyList<Mod> mods = null) => throw new NotImplementedException();
-            public override IBeatmapConverter CreateBeatmapConverter(IBeatmap beatmap) => throw new NotImplementedException();
-            public override DifficultyCalculator CreateDifficultyCalculator(IWorkingBeatmap beatmap) => throw new NotImplementedException();
-            public override string Description => string.Empty;
-            public override string ShortName => string.Empty;
+            private readonly CompositeDrawable donor;
+
+            public DependencyBorrowingContainer(CompositeDrawable donor)
+            {
+                this.donor = donor;
+            }
+
+            protected override IReadOnlyDependencyContainer CreateChildDependencies(IReadOnlyDependencyContainer parent) =>
+                new DependencyContainer(donor?.Dependencies ?? base.CreateChildDependencies(parent));
         }
     }
 }
diff --git a/osu.Game/Skinning/Editor/SkinEditor.cs b/osu.Game/Skinning/Editor/SkinEditor.cs
index f7e5aeecdf..2a7e3439c0 100644
--- a/osu.Game/Skinning/Editor/SkinEditor.cs
+++ b/osu.Game/Skinning/Editor/SkinEditor.cs
@@ -51,6 +51,7 @@ namespace osu.Game.Skinning.Editor
         private Container content;
 
         private EditorSidebarSection settingsToolbox;
+        private EditorSidebar componentsSidebar;
 
         public SkinEditor()
         {
@@ -146,16 +147,7 @@ namespace osu.Game.Skinning.Editor
                                 {
                                     new Drawable[]
                                     {
-                                        new EditorSidebar
-                                        {
-                                            Children = new[]
-                                            {
-                                                new SkinComponentToolbox
-                                                {
-                                                    RequestPlacement = placeComponent
-                                                },
-                                            }
-                                        },
+                                        componentsSidebar = new EditorSidebar(),
                                         content = new Container
                                         {
                                             Depth = float.MaxValue,
@@ -211,7 +203,15 @@ namespace osu.Game.Skinning.Editor
             Scheduler.AddOnce(loadBlueprintContainer);
             Scheduler.AddOnce(populateSettings);
 
-            void loadBlueprintContainer() => content.Child = new SkinBlueprintContainer(targetScreen);
+            void loadBlueprintContainer()
+            {
+                content.Child = new SkinBlueprintContainer(targetScreen);
+
+                componentsSidebar.Child = new SkinComponentToolbox(getFirstTarget() as CompositeDrawable)
+                {
+                    RequestPlacement = placeComponent
+                };
+            }
         }
 
         private void skinChanged()
@@ -238,12 +238,7 @@ namespace osu.Game.Skinning.Editor
 
         private void placeComponent(Type type)
         {
-            var target = availableTargets.FirstOrDefault()?.Target;
-
-            if (target == null)
-                return;
-
-            var targetContainer = getTarget(target.Value);
+            var targetContainer = getFirstTarget();
 
             if (targetContainer == null)
                 return;
@@ -278,6 +273,8 @@ namespace osu.Game.Skinning.Editor
 
         private IEnumerable<ISkinnableTarget> availableTargets => targetScreen.ChildrenOfType<ISkinnableTarget>();
 
+        private ISkinnableTarget getFirstTarget() => availableTargets.FirstOrDefault();
+
         private ISkinnableTarget getTarget(SkinnableTarget target)
         {
             return availableTargets.FirstOrDefault(c => c.Target == target);

From 7e5262364525dc4cd0685b3ef8bc4287e8092b74 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 16 Mar 2022 20:02:52 +0900
Subject: [PATCH 3468/5547] Add "Reset position" menu item in skin editor

---
 osu.Game/Skinning/Editor/SkinSelectionHandler.cs | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/osu.Game/Skinning/Editor/SkinSelectionHandler.cs b/osu.Game/Skinning/Editor/SkinSelectionHandler.cs
index bd6d097eb2..46755728a7 100644
--- a/osu.Game/Skinning/Editor/SkinSelectionHandler.cs
+++ b/osu.Game/Skinning/Editor/SkinSelectionHandler.cs
@@ -6,6 +6,7 @@ using System.Collections.Generic;
 using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.EnumExtensions;
+using osu.Framework.Extensions.IEnumerableExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Primitives;
 using osu.Framework.Graphics.UserInterface;
@@ -199,6 +200,12 @@ namespace osu.Game.Skinning.Editor
                 Items = createAnchorItems((d, o) => ((Drawable)d).Origin == o, applyOrigins).ToArray()
             };
 
+            yield return new OsuMenuItem("Reset position", MenuItemType.Standard, () =>
+            {
+                foreach (var blueprint in SelectedBlueprints)
+                    ((Drawable)blueprint.Item).Position = Vector2.Zero;
+            });
+
             foreach (var item in base.GetContextMenuItemsForSelection(selection))
                 yield return item;
 

From c2e4779c2ed429a5e54dd405938e80347f1d2bab Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Wed, 16 Mar 2022 11:57:11 +0000
Subject: [PATCH 3469/5547] Remove redundant spacing in `ControlItem` test
 scene

---
 osu.Game.Tests/Visual/Online/TestSceneChannelControlItem.cs | 1 -
 1 file changed, 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneChannelControlItem.cs b/osu.Game.Tests/Visual/Online/TestSceneChannelControlItem.cs
index e496ef60d7..8289be033a 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneChannelControlItem.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneChannelControlItem.cs
@@ -91,7 +91,6 @@ namespace osu.Game.Tests.Visual.Online
                                 flow = new FillFlowContainer
                                 {
                                     Direction = FillDirection.Vertical,
-                                    Spacing = new Vector2(20),
                                     RelativeSizeAxes = Axes.X,
                                     AutoSizeAxes = Axes.Y,
                                 },

From 3f61b0d9688e99221c51522563be6aee7939c5aa Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 16 Mar 2022 22:23:19 +0900
Subject: [PATCH 3470/5547] Add missing `OverlayColourProvider` to `SkinEditor`
 test

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

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSkinEditor.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSkinEditor.cs
index 9012492028..e74345aae9 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSkinEditor.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSkinEditor.cs
@@ -2,8 +2,10 @@
 // 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.Testing;
+using osu.Game.Overlays;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Osu;
 using osu.Game.Skinning.Editor;
@@ -16,6 +18,9 @@ namespace osu.Game.Tests.Visual.Gameplay
 
         protected override bool Autoplay => true;
 
+        [Cached]
+        private readonly OverlayColourProvider colourProvider = new OverlayColourProvider(OverlayColourScheme.Blue);
+
         [SetUpSteps]
         public override void SetUpSteps()
         {

From 03d3969b38ebd37e03e8b09c4f6eed5218f4766d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 16 Mar 2022 21:46:02 +0100
Subject: [PATCH 3471/5547] Remove unnecessary `OsuColour` cache

One is already cached at `OsuGameBase` level.
---
 osu.Game.Tests/Visual/Online/TestSceneChannelControlItem.cs | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneChannelControlItem.cs b/osu.Game.Tests/Visual/Online/TestSceneChannelControlItem.cs
index 8289be033a..3465e7dfec 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneChannelControlItem.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneChannelControlItem.cs
@@ -8,7 +8,6 @@ using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
-using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Chat;
@@ -24,9 +23,6 @@ namespace osu.Game.Tests.Visual.Online
         [Cached]
         private readonly OverlayColourProvider colourProvider = new OverlayColourProvider(OverlayColourScheme.Pink);
 
-        [Cached]
-        private readonly OsuColour osuColour = new OsuColour();
-
         [Cached]
         private readonly Bindable<Channel> selected = new Bindable<Channel>();
 

From a8cefca685f9ec5faed81112a70f894c838f7f54 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 16 Mar 2022 21:49:04 +0100
Subject: [PATCH 3472/5547] Simplify fade-out transform

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

diff --git a/osu.Game.Tests/Visual/Online/TestSceneChannelControlItem.cs b/osu.Game.Tests/Visual/Online/TestSceneChannelControlItem.cs
index 3465e7dfec..e66092bf27 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneChannelControlItem.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneChannelControlItem.cs
@@ -148,7 +148,7 @@ namespace osu.Game.Tests.Visual.Online
         private void leaveChannel(Channel channel)
         {
             leaveText.Text = $"OnRequestLeave: {channel.Name}";
-            leaveText.FadeIn().Then().FadeOut(1000, Easing.InQuint);
+            leaveText.FadeOutFromOne(1000, Easing.InQuint);
         }
 
         private static Channel createPublicChannel(string name) =>

From b21fa78cbfa57b749138fdcd36a256ea727bc610 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 16 Mar 2022 21:55:36 +0100
Subject: [PATCH 3473/5547] Move dependencies out of fields to BDL args where
 possible

---
 osu.Game/Overlays/Chat/ChannelControl/ControlItem.cs      | 5 +----
 .../Overlays/Chat/ChannelControl/ControlItemMention.cs    | 8 +-------
 2 files changed, 2 insertions(+), 11 deletions(-)

diff --git a/osu.Game/Overlays/Chat/ChannelControl/ControlItem.cs b/osu.Game/Overlays/Chat/ChannelControl/ControlItem.cs
index cc00550965..c27d5fdf5d 100644
--- a/osu.Game/Overlays/Chat/ChannelControl/ControlItem.cs
+++ b/osu.Game/Overlays/Chat/ChannelControl/ControlItem.cs
@@ -33,16 +33,13 @@ namespace osu.Game.Overlays.Chat.ChannelControl
         [Resolved]
         private Bindable<Channel> selectedChannel { get; set; } = null!;
 
-        [Resolved]
-        private OverlayColourProvider colourProvider { get; set; } = null!;
-
         public ControlItem(Channel channel)
         {
             this.channel = channel;
         }
 
         [BackgroundDependencyLoader]
-        private void load()
+        private void load(OverlayColourProvider colourProvider)
         {
             Height = 30;
             RelativeSizeAxes = Axes.X;
diff --git a/osu.Game/Overlays/Chat/ChannelControl/ControlItemMention.cs b/osu.Game/Overlays/Chat/ChannelControl/ControlItemMention.cs
index beb2713c92..34e1e33c87 100644
--- a/osu.Game/Overlays/Chat/ChannelControl/ControlItemMention.cs
+++ b/osu.Game/Overlays/Chat/ChannelControl/ControlItemMention.cs
@@ -20,14 +20,8 @@ namespace osu.Game.Overlays.Chat.ChannelControl
 
         private OsuSpriteText? countText;
 
-        [Resolved]
-        private OsuColour osuColour { get; set; } = null!;
-
-        [Resolved]
-        private OverlayColourProvider colourProvider { get; set; } = null!;
-
         [BackgroundDependencyLoader]
-        private void load()
+        private void load(OsuColour osuColour, OverlayColourProvider colourProvider)
         {
             Masking = true;
             Size = new Vector2(20, 12);

From 624f9fc774732ae8c7ee795968414d3f7f97926b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 16 Mar 2022 22:41:28 +0100
Subject: [PATCH 3474/5547] Implement mod settings area component

---
 .../UserInterface/TestSceneModSettingsArea.cs |  40 ++++
 osu.Game/Overlays/Mods/ModSettingsArea.cs     | 176 ++++++++++++++++++
 2 files changed, 216 insertions(+)
 create mode 100644 osu.Game.Tests/Visual/UserInterface/TestSceneModSettingsArea.cs
 create mode 100644 osu.Game/Overlays/Mods/ModSettingsArea.cs

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneModSettingsArea.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneModSettingsArea.cs
new file mode 100644
index 0000000000..ddc1c8c128
--- /dev/null
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneModSettingsArea.cs
@@ -0,0 +1,40 @@
+// 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.Framework.Graphics.Containers;
+using osu.Game.Overlays;
+using osu.Game.Overlays.Mods;
+using osu.Game.Rulesets.Mods;
+using osu.Game.Rulesets.Osu.Mods;
+
+namespace osu.Game.Tests.Visual.UserInterface
+{
+    [TestFixture]
+    public class TestSceneModSettingsArea : OsuTestScene
+    {
+        [Cached]
+        private OverlayColourProvider colourProvider = new OverlayColourProvider(OverlayColourScheme.Green);
+
+        [Test]
+        public void TestModToggleArea()
+        {
+            ModSettingsArea modSettingsArea = null;
+
+            AddStep("create content", () => Child = new Container
+            {
+                RelativeSizeAxes = Axes.Both,
+                Anchor = Anchor.Centre,
+                Origin = Anchor.Centre,
+                Child = modSettingsArea = new ModSettingsArea()
+            });
+            AddStep("set DT", () => modSettingsArea.SelectedMods.Value = new[] { new OsuModDoubleTime() });
+            AddStep("set DA", () => modSettingsArea.SelectedMods.Value = new Mod[] { new OsuModDifficultyAdjust() });
+            AddStep("set FL+WU+DA+AD", () => modSettingsArea.SelectedMods.Value = new Mod[] { new OsuModFlashlight(), new ModWindUp(), new OsuModDifficultyAdjust(), new OsuModApproachDifferent() });
+            AddStep("set empty", () => modSettingsArea.SelectedMods.Value = Array.Empty<Mod>());
+        }
+    }
+}
diff --git a/osu.Game/Overlays/Mods/ModSettingsArea.cs b/osu.Game/Overlays/Mods/ModSettingsArea.cs
new file mode 100644
index 0000000000..e0a30f60c2
--- /dev/null
+++ b/osu.Game/Overlays/Mods/ModSettingsArea.cs
@@ -0,0 +1,176 @@
+// 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.Graphics.Containers;
+using osu.Framework.Graphics.Shapes;
+using osu.Framework.Input.Events;
+using osu.Game.Configuration;
+using osu.Game.Graphics;
+using osu.Game.Graphics.Containers;
+using osu.Game.Graphics.Sprites;
+using osu.Game.Rulesets.Mods;
+using osu.Game.Rulesets.UI;
+using osuTK;
+
+namespace osu.Game.Overlays.Mods
+{
+    public class ModSettingsArea : CompositeDrawable
+    {
+        public Bindable<IReadOnlyList<Mod>> SelectedMods { get; } = new Bindable<IReadOnlyList<Mod>>();
+
+        private readonly Box background;
+        private readonly FillFlowContainer modSettingsFlow;
+
+        [Resolved]
+        private OverlayColourProvider colourProvider { get; set; }
+
+        public ModSettingsArea()
+        {
+            RelativeSizeAxes = Axes.X;
+            Height = 250;
+
+            Anchor = Anchor.BottomRight;
+            Origin = Anchor.BottomRight;
+
+            InternalChild = new Container
+            {
+                RelativeSizeAxes = Axes.Both,
+                Masking = true,
+                BorderThickness = 2,
+                Children = new Drawable[]
+                {
+                    background = new Box
+                    {
+                        RelativeSizeAxes = Axes.Both
+                    },
+                    new OsuScrollContainer(Direction.Horizontal)
+                    {
+                        RelativeSizeAxes = Axes.Both,
+                        ScrollbarOverlapsContent = false,
+                        Child = modSettingsFlow = new FillFlowContainer
+                        {
+                            AutoSizeAxes = Axes.X,
+                            RelativeSizeAxes = Axes.Y,
+                            Padding = new MarginPadding { Vertical = 7, Horizontal = 70 },
+                            Spacing = new Vector2(7),
+                            Direction = FillDirection.Horizontal
+                        }
+                    }
+                }
+            };
+        }
+
+        [BackgroundDependencyLoader]
+        private void load()
+        {
+            background.Colour = colourProvider.Dark3;
+        }
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+            SelectedMods.BindValueChanged(_ => updateMods());
+        }
+
+        private void updateMods()
+        {
+            modSettingsFlow.Clear();
+
+            foreach (var mod in SelectedMods.Value.OrderBy(mod => mod.Type).ThenBy(mod => mod.Acronym))
+            {
+                var settings = mod.CreateSettingsControls().ToList();
+
+                if (settings.Count > 0)
+                {
+                    if (modSettingsFlow.Any())
+                    {
+                        modSettingsFlow.Add(new Box
+                        {
+                            RelativeSizeAxes = Axes.Y,
+                            Width = 2,
+                            Colour = colourProvider.Dark4,
+                        });
+                    }
+
+                    modSettingsFlow.Add(new ModSettingsColumn(mod, settings));
+                }
+            }
+        }
+
+        protected override bool OnMouseDown(MouseDownEvent e) => true;
+        protected override bool OnHover(HoverEvent e) => true;
+
+        private class ModSettingsColumn : CompositeDrawable
+        {
+            public ModSettingsColumn(Mod mod, IEnumerable<Drawable> settingsControls)
+            {
+                Width = 250;
+                RelativeSizeAxes = Axes.Y;
+                Padding = new MarginPadding { Bottom = 7 };
+
+                InternalChild = new GridContainer
+                {
+                    RelativeSizeAxes = Axes.Both,
+                    RowDimensions = new[]
+                    {
+                        new Dimension(GridSizeMode.AutoSize),
+                        new Dimension(GridSizeMode.Absolute, 10),
+                        new Dimension()
+                    },
+                    Content = new[]
+                    {
+                        new Drawable[]
+                        {
+                            new FillFlowContainer
+                            {
+                                RelativeSizeAxes = Axes.X,
+                                AutoSizeAxes = Axes.Y,
+                                Direction = FillDirection.Horizontal,
+                                Spacing = new Vector2(7),
+                                Children = new Drawable[]
+                                {
+                                    new ModSwitchTiny(mod)
+                                    {
+                                        Active = { Value = true },
+                                        Scale = new Vector2(0.6f),
+                                        Origin = Anchor.CentreLeft,
+                                        Anchor = Anchor.CentreLeft
+                                    },
+                                    new OsuSpriteText
+                                    {
+                                        Text = mod.Name,
+                                        Font = OsuFont.Default.With(size: 16, weight: FontWeight.SemiBold),
+                                        Origin = Anchor.CentreLeft,
+                                        Anchor = Anchor.CentreLeft,
+                                        Margin = new MarginPadding { Bottom = 2 }
+                                    }
+                                }
+                            }
+                        },
+                        new[] { Empty() },
+                        new Drawable[]
+                        {
+                            new OsuScrollContainer(Direction.Vertical)
+                            {
+                                RelativeSizeAxes = Axes.Both,
+                                Child = new FillFlowContainer
+                                {
+                                    RelativeSizeAxes = Axes.X,
+                                    AutoSizeAxes = Axes.Y,
+                                    Padding = new MarginPadding { Right = 7 },
+                                    ChildrenEnumerable = settingsControls,
+                                    Spacing = new Vector2(0, 7)
+                                }
+                            }
+                        }
+                    }
+                };
+            }
+        }
+    }
+}

From d90a33485318f926e51c6f9da270876756bfab30 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 17 Mar 2022 03:40:15 +0300
Subject: [PATCH 3475/5547] Introduce multiplayer playability and free mod
 validity in `Mod`

---
 osu.Game/Rulesets/Mods/IMod.cs | 12 ++++++++++++
 osu.Game/Rulesets/Mods/Mod.cs  |  6 ++++++
 2 files changed, 18 insertions(+)

diff --git a/osu.Game/Rulesets/Mods/IMod.cs b/osu.Game/Rulesets/Mods/IMod.cs
index d5d1de91de..cda59bae55 100644
--- a/osu.Game/Rulesets/Mods/IMod.cs
+++ b/osu.Game/Rulesets/Mods/IMod.cs
@@ -39,6 +39,18 @@ namespace osu.Game.Rulesets.Mods
         /// </summary>
         bool UserPlayable { get; }
 
+        /// <summary>
+        /// Whether this mod is playable in a multiplayer match.
+        /// Should be <c>false</c> for mods that affect the gameplay progress based on user input (e.g. <see cref="ModAdaptiveSpeed"/>).
+        /// </summary>
+        bool PlayableInMultiplayer { get; }
+
+        /// <summary>
+        /// Whether this mod is valid to be a "free mod" in a multiplayer match.
+        /// Should be <c>false</c> for mods that affect the gameplay progress (e.g. <see cref="ModRateAdjust"/> and <see cref="ModTimeRamp"/>).
+        /// </summary>
+        bool ValidFreeModInMultiplayer { get; }
+
         /// <summary>
         /// Create a fresh <see cref="Mod"/> instance based on this mod.
         /// </summary>
diff --git a/osu.Game/Rulesets/Mods/Mod.cs b/osu.Game/Rulesets/Mods/Mod.cs
index b2d4be54ce..a6562b4f4c 100644
--- a/osu.Game/Rulesets/Mods/Mod.cs
+++ b/osu.Game/Rulesets/Mods/Mod.cs
@@ -94,6 +94,12 @@ namespace osu.Game.Rulesets.Mods
         [JsonIgnore]
         public virtual bool UserPlayable => true;
 
+        [JsonIgnore]
+        public virtual bool PlayableInMultiplayer => UserPlayable;
+
+        [JsonIgnore]
+        public virtual bool ValidFreeModInMultiplayer => PlayableInMultiplayer;
+
         [Obsolete("Going forward, the concept of \"ranked\" doesn't exist. The only exceptions are automation mods, which should now override and set UserPlayable to false.")] // Can be removed 20211009
         public virtual bool Ranked => false;
 

From 187059a37f69ed4ceff8ea4e2e2a0b8dda3b0085 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 17 Mar 2022 03:40:40 +0300
Subject: [PATCH 3476/5547] Replace hardcoded overrides with the newly
 introduced `Mod` properties

---
 osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs                    | 2 ++
 osu.Game/Rulesets/Mods/ModRateAdjust.cs                       | 2 ++
 osu.Game/Rulesets/Mods/ModTimeRamp.cs                         | 2 ++
 .../OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs      | 4 ++--
 4 files changed, 8 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs b/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs
index 1115b95e6f..54a4c054c9 100644
--- a/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs
+++ b/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs
@@ -31,6 +31,8 @@ namespace osu.Game.Rulesets.Mods
 
         public override double ScoreMultiplier => 1;
 
+        public override bool PlayableInMultiplayer => false;
+
         public override Type[] IncompatibleMods => new[] { typeof(ModRateAdjust), typeof(ModTimeRamp) };
 
         [SettingSource("Initial rate", "The starting speed of the track")]
diff --git a/osu.Game/Rulesets/Mods/ModRateAdjust.cs b/osu.Game/Rulesets/Mods/ModRateAdjust.cs
index ebe18f2188..3a11c3034b 100644
--- a/osu.Game/Rulesets/Mods/ModRateAdjust.cs
+++ b/osu.Game/Rulesets/Mods/ModRateAdjust.cs
@@ -11,6 +11,8 @@ namespace osu.Game.Rulesets.Mods
 {
     public abstract class ModRateAdjust : Mod, IApplicableToRate
     {
+        public override bool ValidFreeModInMultiplayer => false;
+
         public abstract BindableNumber<double> SpeedChange { get; }
 
         public virtual void ApplyToTrack(ITrack track)
diff --git a/osu.Game/Rulesets/Mods/ModTimeRamp.cs b/osu.Game/Rulesets/Mods/ModTimeRamp.cs
index b6b2decede..59aac62686 100644
--- a/osu.Game/Rulesets/Mods/ModTimeRamp.cs
+++ b/osu.Game/Rulesets/Mods/ModTimeRamp.cs
@@ -30,6 +30,8 @@ namespace osu.Game.Rulesets.Mods
         [SettingSource("Adjust pitch", "Should pitch be adjusted with speed")]
         public abstract BindableBool AdjustPitch { get; }
 
+        public override bool ValidFreeModInMultiplayer => false;
+
         public override Type[] IncompatibleMods => new[] { typeof(ModRateAdjust), typeof(ModAdaptiveSpeed) };
 
         public override string SettingDescription => $"{InitialRate.Value:N2}x to {FinalRate.Value:N2}x";
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs
index 5ccf89e703..e4f1d9587d 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs
@@ -117,8 +117,8 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
 
         protected override BeatmapDetailArea CreateBeatmapDetailArea() => new PlayBeatmapDetailArea();
 
-        protected override bool IsValidMod(Mod mod) => base.IsValidMod(mod) && !(mod is ModAdaptiveSpeed);
+        protected override bool IsValidMod(Mod mod) => base.IsValidMod(mod) && mod.PlayableInMultiplayer;
 
-        protected override bool IsValidFreeMod(Mod mod) => base.IsValidFreeMod(mod) && !(mod is ModTimeRamp) && !(mod is ModRateAdjust);
+        protected override bool IsValidFreeMod(Mod mod) => base.IsValidFreeMod(mod) && mod.ValidFreeModInMultiplayer;
     }
 }

From 59741ccee60d9b05466d9b7a1fea6157106ba5d8 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 17 Mar 2022 05:15:05 +0300
Subject: [PATCH 3477/5547] Add multiplayer mod validity check methods for
 server consumption

---
 osu.Game/OsuGame.cs        | 15 ++++++++++-----
 osu.Game/Utils/ModUtils.cs | 26 +++++++++++++++++++++++---
 2 files changed, 33 insertions(+), 8 deletions(-)

diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index ae117d03d2..bc2d2083fe 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -575,11 +575,16 @@ namespace osu.Game
             if (SelectedMods.Disabled)
                 return;
 
-            if (!ModUtils.CheckValidForGameplay(mods.NewValue, out var invalid))
-            {
-                // ensure we always have a valid set of mods.
-                SelectedMods.Value = mods.NewValue.Except(invalid).ToArray();
-            }
+            var validMods = mods.NewValue;
+
+            if (!ModUtils.CheckCompatibleSet(validMods, out var incompatible))
+                validMods = validMods.Except(incompatible).ToArray();
+
+            if (!ModUtils.CheckValidForGameplay(validMods, out var invalid))
+                validMods = validMods.Except(invalid).ToArray();
+
+            // ensure we always have a valid set of mods.
+            SelectedMods.Value = validMods;
         }
 
         #endregion
diff --git a/osu.Game/Utils/ModUtils.cs b/osu.Game/Utils/ModUtils.cs
index d5ea74c404..d169ace80a 100644
--- a/osu.Game/Utils/ModUtils.cs
+++ b/osu.Game/Utils/ModUtils.cs
@@ -112,14 +112,34 @@ namespace osu.Game.Utils
         /// <param name="invalidMods">Invalid mods, if any were found. Can be null if all mods were valid.</param>
         /// <returns>Whether the input mods were all valid. If false, <paramref name="invalidMods"/> will contain all invalid entries.</returns>
         public static bool CheckValidForGameplay(IEnumerable<Mod> mods, [NotNullWhen(false)] out List<Mod>? invalidMods)
+            => checkValid(mods, m => m.Type != ModType.System && m.HasImplementation && !(m is MultiMod), out invalidMods);
+
+        /// <summary>
+        /// Check the provided combination of mods are valid for a multiplayer match session.
+        /// </summary>
+        /// <param name="mods">The mods to check.</param>
+        /// <param name="invalidMods">Invalid mods, if any were found. Can be null if all mods were valid.</param>
+        /// <returns>Whether the input mods were all valid. If false, <paramref name="invalidMods"/> will contain all invalid entries.</returns>
+        public static bool CheckValidForMultiplayer(IEnumerable<Mod> mods, [NotNullWhen(false)] out List<Mod>? invalidMods)
+            => checkValid(mods, m => m.PlayableInMultiplayer, out invalidMods);
+
+        /// <summary>
+        /// Check the provided combination of mods are valid as "free mods" in a multiplayer match session.
+        /// </summary>
+        /// <param name="mods">The mods to check.</param>
+        /// <param name="invalidMods">Invalid mods, if any were found. Can be null if all mods were valid.</param>
+        /// <returns>Whether the input mods were all valid. If false, <paramref name="invalidMods"/> will contain all invalid entries.</returns>
+        public static bool CheckValidFreeModsForMultiplayer(IEnumerable<Mod> mods, [NotNullWhen(false)] out List<Mod>? invalidMods)
+            => checkValid(mods, m => m.ValidFreeModInMultiplayer, out invalidMods);
+
+        private static bool checkValid(IEnumerable<Mod> mods, Predicate<Mod> valid, [NotNullWhen(false)] out List<Mod>? invalidMods)
         {
             mods = mods.ToArray();
-
-            CheckCompatibleSet(mods, out invalidMods);
+            invalidMods = null;
 
             foreach (var mod in mods)
             {
-                if (mod.Type == ModType.System || !mod.HasImplementation || mod is MultiMod)
+                if (!valid(mod))
                 {
                     invalidMods ??= new List<Mod>();
                     invalidMods.Add(mod);

From 07e9f3780a8335ca07d3e076193c0b7cbdc80982 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 17 Mar 2022 05:15:48 +0300
Subject: [PATCH 3478/5547] Consider `UnknownMod` to be "playable in
 multiplayer"

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

diff --git a/osu.Game/Rulesets/Mods/UnknownMod.cs b/osu.Game/Rulesets/Mods/UnknownMod.cs
index b426386d7a..790306c0ca 100644
--- a/osu.Game/Rulesets/Mods/UnknownMod.cs
+++ b/osu.Game/Rulesets/Mods/UnknownMod.cs
@@ -16,6 +16,7 @@ namespace osu.Game.Rulesets.Mods
         public override double ScoreMultiplier => 0;
 
         public override bool UserPlayable => false;
+        public override bool PlayableInMultiplayer => true;
 
         public override ModType Type => ModType.System;
 

From 1a04260807bfaf54675e753b4a0b7561d7349fad Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 17 Mar 2022 05:51:12 +0300
Subject: [PATCH 3479/5547] Update mod instantiaton utility method to no longer
 check for validity

---
 osu.Game/Utils/ModUtils.cs | 26 ++++++--------------------
 1 file changed, 6 insertions(+), 20 deletions(-)

diff --git a/osu.Game/Utils/ModUtils.cs b/osu.Game/Utils/ModUtils.cs
index d5ea74c404..bccb706842 100644
--- a/osu.Game/Utils/ModUtils.cs
+++ b/osu.Game/Utils/ModUtils.cs
@@ -153,31 +153,17 @@ namespace osu.Game.Utils
         }
 
         /// <summary>
-        /// Verifies all proposed mods are valid for a given ruleset and returns instantiated <see cref="Mod"/>s for further processing.
+        /// Returns an instantiated list of all proposed mods on a given ruleset.
         /// </summary>
-        /// <param name="ruleset">The ruleset to verify mods against.</param>
+        /// <param name="ruleset">The ruleset to instantiate mods.</param>
         /// <param name="proposedMods">The proposed mods.</param>
-        /// <param name="valid">Mods instantiated from <paramref name="proposedMods"/> which were valid for the given <paramref name="ruleset"/>.</param>
-        /// <returns>Whether all <paramref name="proposedMods"/> were valid for the given <paramref name="ruleset"/>.</returns>
-        public static bool InstantiateValidModsForRuleset(Ruleset ruleset, IEnumerable<APIMod> proposedMods, out List<Mod> valid)
+        /// <param name="mods">Mods instantiated from <paramref name="proposedMods"/> on the given <paramref name="ruleset"/>.</param>
+        public static void InstantiateModsForRuleset(Ruleset ruleset, IEnumerable<APIMod> proposedMods, out List<Mod> mods)
         {
-            valid = new List<Mod>();
-            bool proposedWereValid = true;
+            mods = new List<Mod>();
 
             foreach (var apiMod in proposedMods)
-            {
-                try
-                {
-                    // will throw if invalid
-                    valid.Add(apiMod.ToMod(ruleset));
-                }
-                catch
-                {
-                    proposedWereValid = false;
-                }
-            }
-
-            return proposedWereValid;
+                mods.Add(apiMod.ToMod(ruleset));
         }
     }
 }

From 83189d1f07dc21af413f74f48e38c52082d6d005 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 17 Mar 2022 06:24:55 +0300
Subject: [PATCH 3480/5547] Revert "Update mod instantiaton utility method to
 no longer check for validity"

This reverts commit 1a04260807bfaf54675e753b4a0b7561d7349fad.
---
 osu.Game/Utils/ModUtils.cs | 26 ++++++++++++++++++++------
 1 file changed, 20 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Utils/ModUtils.cs b/osu.Game/Utils/ModUtils.cs
index bccb706842..d5ea74c404 100644
--- a/osu.Game/Utils/ModUtils.cs
+++ b/osu.Game/Utils/ModUtils.cs
@@ -153,17 +153,31 @@ namespace osu.Game.Utils
         }
 
         /// <summary>
-        /// Returns an instantiated list of all proposed mods on a given ruleset.
+        /// Verifies all proposed mods are valid for a given ruleset and returns instantiated <see cref="Mod"/>s for further processing.
         /// </summary>
-        /// <param name="ruleset">The ruleset to instantiate mods.</param>
+        /// <param name="ruleset">The ruleset to verify mods against.</param>
         /// <param name="proposedMods">The proposed mods.</param>
-        /// <param name="mods">Mods instantiated from <paramref name="proposedMods"/> on the given <paramref name="ruleset"/>.</param>
-        public static void InstantiateModsForRuleset(Ruleset ruleset, IEnumerable<APIMod> proposedMods, out List<Mod> mods)
+        /// <param name="valid">Mods instantiated from <paramref name="proposedMods"/> which were valid for the given <paramref name="ruleset"/>.</param>
+        /// <returns>Whether all <paramref name="proposedMods"/> were valid for the given <paramref name="ruleset"/>.</returns>
+        public static bool InstantiateValidModsForRuleset(Ruleset ruleset, IEnumerable<APIMod> proposedMods, out List<Mod> valid)
         {
-            mods = new List<Mod>();
+            valid = new List<Mod>();
+            bool proposedWereValid = true;
 
             foreach (var apiMod in proposedMods)
-                mods.Add(apiMod.ToMod(ruleset));
+            {
+                try
+                {
+                    // will throw if invalid
+                    valid.Add(apiMod.ToMod(ruleset));
+                }
+                catch
+                {
+                    proposedWereValid = false;
+                }
+            }
+
+            return proposedWereValid;
         }
     }
 }

From e0a06bf5d931ceffb4ff0a42d4269483896d99df Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 17 Mar 2022 06:28:10 +0300
Subject: [PATCH 3481/5547] Update mod instantiation utility method inline with
 `APIMod.ToMod` changes

---
 osu.Game/Utils/ModUtils.cs | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Utils/ModUtils.cs b/osu.Game/Utils/ModUtils.cs
index d5ea74c404..ff8e04cc58 100644
--- a/osu.Game/Utils/ModUtils.cs
+++ b/osu.Game/Utils/ModUtils.cs
@@ -166,15 +166,15 @@ namespace osu.Game.Utils
 
             foreach (var apiMod in proposedMods)
             {
-                try
-                {
-                    // will throw if invalid
-                    valid.Add(apiMod.ToMod(ruleset));
-                }
-                catch
+                var mod = apiMod.ToMod(ruleset);
+
+                if (mod is UnknownMod)
                 {
                     proposedWereValid = false;
+                    continue;
                 }
+
+                valid.Add(mod);
             }
 
             return proposedWereValid;

From b3ac544d655e6846a94b6bf2d31332b471d90de4 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 17 Mar 2022 06:31:51 +0300
Subject: [PATCH 3482/5547] Revert "Consider `UnknownMod` to be "playable in
 multiplayer""

This reverts commit 07e9f3780a8335ca07d3e076193c0b7cbdc80982.
---
 osu.Game/Rulesets/Mods/UnknownMod.cs | 1 -
 1 file changed, 1 deletion(-)

diff --git a/osu.Game/Rulesets/Mods/UnknownMod.cs b/osu.Game/Rulesets/Mods/UnknownMod.cs
index 790306c0ca..b426386d7a 100644
--- a/osu.Game/Rulesets/Mods/UnknownMod.cs
+++ b/osu.Game/Rulesets/Mods/UnknownMod.cs
@@ -16,7 +16,6 @@ namespace osu.Game.Rulesets.Mods
         public override double ScoreMultiplier => 0;
 
         public override bool UserPlayable => false;
-        public override bool PlayableInMultiplayer => true;
 
         public override ModType Type => ModType.System;
 

From 1eac0f41bf4e624e32d125de2635561a8ff01e14 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 17 Mar 2022 13:44:54 +0900
Subject: [PATCH 3483/5547] Remove unused using

---
 osu.Game/Skinning/Editor/SkinSelectionHandler.cs | 1 -
 1 file changed, 1 deletion(-)

diff --git a/osu.Game/Skinning/Editor/SkinSelectionHandler.cs b/osu.Game/Skinning/Editor/SkinSelectionHandler.cs
index 46755728a7..d7fb5c0498 100644
--- a/osu.Game/Skinning/Editor/SkinSelectionHandler.cs
+++ b/osu.Game/Skinning/Editor/SkinSelectionHandler.cs
@@ -6,7 +6,6 @@ using System.Collections.Generic;
 using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.EnumExtensions;
-using osu.Framework.Extensions.IEnumerableExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Primitives;
 using osu.Framework.Graphics.UserInterface;

From 46e66e66e477507c3c7564930b2c615ed81f47da Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 17 Mar 2022 08:19:38 +0300
Subject: [PATCH 3484/5547] Make opening chat overlay opt-in to add coverage
 for unloaded chat overlays

Causes `TestHighlightWhileChatNeverOpen` to fail as expected.
---
 .../Visual/Online/TestSceneChatOverlay.cs     | 26 ++++++++++++++-----
 1 file changed, 19 insertions(+), 7 deletions(-)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneChatOverlay.cs b/osu.Game.Tests/Visual/Online/TestSceneChatOverlay.cs
index 00ff6a9576..80a6698761 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneChatOverlay.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneChatOverlay.cs
@@ -122,6 +122,8 @@ namespace osu.Game.Tests.Visual.Online
         [Test]
         public void TestHideOverlay()
         {
+            AddStep("Open chat overlay", () => chatOverlay.Show());
+
             AddAssert("Chat overlay is visible", () => chatOverlay.State.Value == Visibility.Visible);
             AddAssert("Selector is visible", () => chatOverlay.SelectionOverlayState == Visibility.Visible);
 
@@ -134,6 +136,7 @@ namespace osu.Game.Tests.Visual.Online
         [Test]
         public void TestChannelSelection()
         {
+            AddStep("Open chat overlay", () => chatOverlay.Show());
             AddAssert("Selector is visible", () => chatOverlay.SelectionOverlayState == Visibility.Visible);
             AddStep("Setup get message response", () => onGetMessages = channel =>
             {
@@ -169,6 +172,7 @@ namespace osu.Game.Tests.Visual.Online
         [Test]
         public void TestSearchInSelector()
         {
+            AddStep("Open chat overlay", () => chatOverlay.Show());
             AddStep("Search for 'no. 2'", () => chatOverlay.ChildrenOfType<SearchTextBox>().First().Text = "no. 2");
             AddUntilStep("Only channel 2 visible", () =>
             {
@@ -180,6 +184,7 @@ namespace osu.Game.Tests.Visual.Online
         [Test]
         public void TestChannelShortcutKeys()
         {
+            AddStep("Open chat overlay", () => chatOverlay.Show());
             AddStep("Join channels", () => channels.ForEach(channel => channelManager.JoinChannel(channel)));
             AddStep("Close channel selector", () => InputManager.Key(Key.Escape));
             AddUntilStep("Wait for close", () => chatOverlay.SelectionOverlayState == Visibility.Hidden);
@@ -199,6 +204,7 @@ namespace osu.Game.Tests.Visual.Online
         [Test]
         public void TestCloseChannelBehaviour()
         {
+            AddStep("Open chat overlay", () => chatOverlay.Show());
             AddUntilStep("Join until dropdown has channels", () =>
             {
                 if (visibleChannels.Count() < joinedChannels.Count())
@@ -269,6 +275,7 @@ namespace osu.Game.Tests.Visual.Online
         [Test]
         public void TestChannelCloseButton()
         {
+            AddStep("Open chat overlay", () => chatOverlay.Show());
             AddStep("Join 2 channels", () =>
             {
                 channelManager.JoinChannel(channel1);
@@ -289,6 +296,7 @@ namespace osu.Game.Tests.Visual.Online
         [Test]
         public void TestCloseTabShortcut()
         {
+            AddStep("Open chat overlay", () => chatOverlay.Show());
             AddStep("Join 2 channels", () =>
             {
                 channelManager.JoinChannel(channel1);
@@ -314,6 +322,7 @@ namespace osu.Game.Tests.Visual.Online
         [Test]
         public void TestNewTabShortcut()
         {
+            AddStep("Open chat overlay", () => chatOverlay.Show());
             AddStep("Join 2 channels", () =>
             {
                 channelManager.JoinChannel(channel1);
@@ -330,6 +339,7 @@ namespace osu.Game.Tests.Visual.Online
         [Test]
         public void TestRestoreTabShortcut()
         {
+            AddStep("Open chat overlay", () => chatOverlay.Show());
             AddStep("Join 3 channels", () =>
             {
                 channelManager.JoinChannel(channel1);
@@ -375,6 +385,7 @@ namespace osu.Game.Tests.Visual.Online
         [Test]
         public void TestChatCommand()
         {
+            AddStep("Open chat overlay", () => chatOverlay.Show());
             AddStep("Join channel 1", () => channelManager.JoinChannel(channel1));
             AddStep("Select channel 1", () => clickDrawable(chatOverlay.TabMap[channel1]));
 
@@ -398,6 +409,8 @@ namespace osu.Game.Tests.Visual.Online
         {
             Channel multiplayerChannel = null;
 
+            AddStep("open chat overlay", () => chatOverlay.Show());
+
             AddStep("join multiplayer channel", () => channelManager.JoinChannel(multiplayerChannel = new Channel(new APIUser())
             {
                 Name = "#mp_1",
@@ -417,6 +430,7 @@ namespace osu.Game.Tests.Visual.Online
         {
             Message message = null;
 
+            AddStep("Open chat overlay", () => chatOverlay.Show());
             AddStep("Join channel 1", () => channelManager.JoinChannel(channel1));
             AddStep("Select channel 1", () => clickDrawable(chatOverlay.TabMap[channel1]));
 
@@ -443,6 +457,7 @@ namespace osu.Game.Tests.Visual.Online
         {
             Message message = null;
 
+            AddStep("Open chat overlay", () => chatOverlay.Show());
             AddStep("Join channel 1", () => channelManager.JoinChannel(channel1));
             AddStep("Select channel 1", () => clickDrawable(chatOverlay.TabMap[channel1]));
 
@@ -471,6 +486,8 @@ namespace osu.Game.Tests.Visual.Online
         {
             Message message = null;
 
+            AddStep("Open chat overlay", () => chatOverlay.Show());
+
             AddStep("Join channel 1", () => channelManager.JoinChannel(channel1));
             AddStep("Select channel 1", () => clickDrawable(chatOverlay.TabMap[channel1]));
 
@@ -496,14 +513,11 @@ namespace osu.Game.Tests.Visual.Online
         }
 
         [Test]
-        public void TestHighlightWhileChatHidden()
+        public void TestHighlightWhileChatNeverOpen()
         {
             Message message = null;
 
-            AddStep("hide chat", () => chatOverlay.Hide());
-
             AddStep("Join channel 1", () => channelManager.JoinChannel(channel1));
-            AddStep("Select channel 1", () => clickDrawable(chatOverlay.TabMap[channel1]));
 
             AddStep("Send message in channel 1", () =>
             {
@@ -520,7 +534,7 @@ namespace osu.Game.Tests.Visual.Online
                 });
             });
 
-            AddStep("Highlight message and show chat", () =>
+            AddStep("Highlight message and open chat", () =>
             {
                 chatOverlay.HighlightMessage(message, channel1);
                 chatOverlay.Show();
@@ -571,8 +585,6 @@ namespace osu.Game.Tests.Visual.Online
                     ChannelManager,
                     ChatOverlay = new TestChatOverlay { RelativeSizeAxes = Axes.Both, },
                 };
-
-                ChatOverlay.Show();
             }
         }
 

From 7aae9bbd1b33943fab4301934db6d3d20322660e Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 17 Mar 2022 08:31:38 +0300
Subject: [PATCH 3485/5547] Improve channel bindable logic in `ChatOverlay` to
 avoid potential nullrefs

---
 osu.Game/Overlays/ChatOverlay.cs | 38 ++++++++++++--------------------
 1 file changed, 14 insertions(+), 24 deletions(-)

diff --git a/osu.Game/Overlays/ChatOverlay.cs b/osu.Game/Overlays/ChatOverlay.cs
index 3764ac42fc..3d39c7ce3a 100644
--- a/osu.Game/Overlays/ChatOverlay.cs
+++ b/osu.Game/Overlays/ChatOverlay.cs
@@ -73,6 +73,10 @@ namespace osu.Game.Overlays
         private Container channelSelectionContainer;
         protected ChannelSelectionOverlay ChannelSelectionOverlay;
 
+        private readonly IBindableList<Channel> availableChannels = new BindableList<Channel>();
+        private readonly IBindableList<Channel> joinedChannels = new BindableList<Channel>();
+        private readonly Bindable<Channel> currentChannel = new Bindable<Channel>();
+
         public override bool Contains(Vector2 screenSpacePos) => chatContainer.ReceivePositionalInputAt(screenSpacePos)
                                                                  || (ChannelSelectionOverlay.State.Value == Visibility.Visible && ChannelSelectionOverlay.ReceivePositionalInputAt(screenSpacePos));
 
@@ -198,9 +202,13 @@ namespace osu.Game.Overlays
                 },
             };
 
+            availableChannels.BindTo(channelManager.AvailableChannels);
+            joinedChannels.BindTo(channelManager.JoinedChannels);
+            currentChannel.BindTo(channelManager.CurrentChannel);
+
             textBox.OnCommit += postMessage;
 
-            ChannelTabControl.Current.ValueChanged += current => channelManager.CurrentChannel.Value = current.NewValue;
+            ChannelTabControl.Current.ValueChanged += current => currentChannel.Value = current.NewValue;
             ChannelTabControl.ChannelSelectorActive.ValueChanged += active => ChannelSelectionOverlay.State.Value = active.NewValue ? Visibility.Visible : Visibility.Hidden;
             ChannelSelectionOverlay.State.ValueChanged += state =>
             {
@@ -238,18 +246,12 @@ namespace osu.Game.Overlays
             Schedule(() =>
             {
                 // TODO: consider scheduling bindable callbacks to not perform when overlay is not present.
-                channelManager.JoinedChannels.BindCollectionChanged(joinedChannelsChanged, true);
-
-                channelManager.AvailableChannels.CollectionChanged += availableChannelsChanged;
-                availableChannelsChanged(null, null);
-
-                currentChannel = channelManager.CurrentChannel.GetBoundCopy();
+                joinedChannels.BindCollectionChanged(joinedChannelsChanged, true);
+                availableChannels.BindCollectionChanged(availableChannelsChanged, true);
                 currentChannel.BindValueChanged(currentChannelChanged, true);
             });
         }
 
-        private Bindable<Channel> currentChannel;
-
         private void currentChannelChanged(ValueChangedEvent<Channel> e)
         {
             if (e.NewValue == null)
@@ -318,7 +320,7 @@ namespace osu.Game.Overlays
                 if (!channel.Joined.Value)
                     channel = channelManager.JoinChannel(channel);
 
-                channelManager.CurrentChannel.Value = channel;
+                currentChannel.Value = channel;
             }
 
             channel.HighlightedMessage.Value = message;
@@ -407,7 +409,7 @@ namespace osu.Game.Overlays
                     return true;
 
                 case PlatformAction.DocumentClose:
-                    channelManager.LeaveChannel(channelManager.CurrentChannel.Value);
+                    channelManager.LeaveChannel(currentChannel.Value);
                     return true;
             }
 
@@ -487,19 +489,7 @@ namespace osu.Game.Overlays
 
         private void availableChannelsChanged(object sender, NotifyCollectionChangedEventArgs args)
         {
-            ChannelSelectionOverlay.UpdateAvailableChannels(channelManager.AvailableChannels);
-        }
-
-        protected override void Dispose(bool isDisposing)
-        {
-            base.Dispose(isDisposing);
-
-            if (channelManager != null)
-            {
-                channelManager.CurrentChannel.ValueChanged -= currentChannelChanged;
-                channelManager.JoinedChannels.CollectionChanged -= joinedChannelsChanged;
-                channelManager.AvailableChannels.CollectionChanged -= availableChannelsChanged;
-            }
+            ChannelSelectionOverlay.UpdateAvailableChannels(availableChannels);
         }
 
         private void postMessage(TextBox textBox, bool newText)

From ac739c9dae7a6ab6ca09eac1e9a9b93eeeac5ce4 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 15 Mar 2022 22:55:47 +0900
Subject: [PATCH 3486/5547] Change `PerformancePointsCounter` resolution
 requirements to be required

All other similar UI components have required dependencies, so this is
mainly to bring things in line with expectations. I am using this fact
in the skin editor to only show components which can be used in the
current editor context (by `try-catch`ing their
`Activator.CreateInstance`).
---
 .../Visual/Gameplay/TestSceneBeatmapSkinFallbacks.cs        | 5 +++++
 osu.Game.Tests/Visual/Gameplay/TestSceneHUDOverlay.cs       | 4 ++++
 .../Visual/Gameplay/TestSceneSkinEditorMultipleSkins.cs     | 4 ++++
 .../Visual/Gameplay/TestSceneSkinnableHUDOverlay.cs         | 4 ++++
 osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs       | 6 ++----
 5 files changed, 19 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneBeatmapSkinFallbacks.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneBeatmapSkinFallbacks.cs
index c5ea9e6204..c70313ee8a 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneBeatmapSkinFallbacks.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneBeatmapSkinFallbacks.cs
@@ -18,9 +18,11 @@ using osu.Game.Rulesets;
 using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Osu.Skinning.Legacy;
 using osu.Game.Rulesets.Scoring;
+using osu.Game.Screens.Play;
 using osu.Game.Screens.Play.HUD;
 using osu.Game.Skinning;
 using osu.Game.Storyboards;
+using osu.Game.Tests.Beatmaps;
 
 namespace osu.Game.Tests.Visual.Gameplay
 {
@@ -37,6 +39,9 @@ namespace osu.Game.Tests.Visual.Gameplay
         [Cached(typeof(HealthProcessor))]
         private HealthProcessor healthProcessor = new DrainingHealthProcessor(0);
 
+        [Cached]
+        private GameplayState gameplayState = new GameplayState(new TestBeatmap(new OsuRuleset().RulesetInfo), new OsuRuleset());
+
         protected override bool HasCustomSteps => true;
 
         [Test]
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneHUDOverlay.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneHUDOverlay.cs
index 505f73159f..d6a4d9bf79 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneHUDOverlay.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneHUDOverlay.cs
@@ -14,6 +14,7 @@ using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Scoring;
 using osu.Game.Screens.Play;
 using osu.Game.Skinning;
+using osu.Game.Tests.Beatmaps;
 using osuTK.Input;
 
 namespace osu.Game.Tests.Visual.Gameplay
@@ -30,6 +31,9 @@ namespace osu.Game.Tests.Visual.Gameplay
         [Cached(typeof(HealthProcessor))]
         private HealthProcessor healthProcessor = new DrainingHealthProcessor(0);
 
+        [Cached]
+        private GameplayState gameplayState = new GameplayState(new TestBeatmap(new OsuRuleset().RulesetInfo), new OsuRuleset());
+
         // best way to check without exposing.
         private Drawable hideTarget => hudOverlay.KeyCounter;
         private FillFlowContainer<KeyCounter> keyCounterFlow => hudOverlay.KeyCounter.ChildrenOfType<FillFlowContainer<KeyCounter>>().First();
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSkinEditorMultipleSkins.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSkinEditorMultipleSkins.cs
index 8f33f6fac5..5dc4bdb041 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSkinEditorMultipleSkins.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSkinEditorMultipleSkins.cs
@@ -10,6 +10,7 @@ using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Scoring;
 using osu.Game.Screens.Play;
 using osu.Game.Skinning.Editor;
+using osu.Game.Tests.Beatmaps;
 using osuTK.Input;
 
 namespace osu.Game.Tests.Visual.Gameplay
@@ -22,6 +23,9 @@ namespace osu.Game.Tests.Visual.Gameplay
         [Cached(typeof(HealthProcessor))]
         private HealthProcessor healthProcessor = new DrainingHealthProcessor(0);
 
+        [Cached]
+        private GameplayState gameplayState = new GameplayState(new TestBeatmap(new OsuRuleset().RulesetInfo), new OsuRuleset());
+
         [SetUpSteps]
         public void SetUpSteps()
         {
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableHUDOverlay.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableHUDOverlay.cs
index cdf349ff7f..da443a6c92 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableHUDOverlay.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableHUDOverlay.cs
@@ -15,6 +15,7 @@ using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Scoring;
 using osu.Game.Screens.Play;
+using osu.Game.Tests.Beatmaps;
 using osuTK.Input;
 
 namespace osu.Game.Tests.Visual.Gameplay
@@ -29,6 +30,9 @@ namespace osu.Game.Tests.Visual.Gameplay
         [Cached(typeof(HealthProcessor))]
         private HealthProcessor healthProcessor = new DrainingHealthProcessor(0);
 
+        [Cached]
+        private GameplayState gameplayState = new GameplayState(new TestBeatmap(new OsuRuleset().RulesetInfo), new OsuRuleset());
+
         private IEnumerable<HUDOverlay> hudOverlays => CreatedDrawables.OfType<HUDOverlay>();
 
         // best way to check without exposing.
diff --git a/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs b/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs
index c0d0ea0721..7a1f724cfb 100644
--- a/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs
+++ b/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs
@@ -42,12 +42,10 @@ namespace osu.Game.Screens.Play.HUD
 
         private const float alpha_when_invalid = 0.3f;
 
-        [CanBeNull]
-        [Resolved(CanBeNull = true)]
+        [Resolved]
         private ScoreProcessor scoreProcessor { get; set; }
 
-        [Resolved(CanBeNull = true)]
-        [CanBeNull]
+        [Resolved]
         private GameplayState gameplayState { get; set; }
 
         [CanBeNull]

From fd71aa4a4d321078f0da1194db47f18590052c8f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 17 Mar 2022 15:05:51 +0900
Subject: [PATCH 3487/5547] Change `SongProgress` resolution requirements to be
 required

---
 osu.Game/Screens/Play/SongProgress.cs | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/Play/SongProgress.cs b/osu.Game/Screens/Play/SongProgress.cs
index b27a9c5f5d..694b5ec628 100644
--- a/osu.Game/Screens/Play/SongProgress.cs
+++ b/osu.Game/Screens/Play/SongProgress.cs
@@ -73,9 +73,12 @@ namespace osu.Game.Screens.Play
         [Resolved(canBeNull: true)]
         private Player player { get; set; }
 
-        [Resolved(canBeNull: true)]
+        [Resolved]
         private GameplayClock gameplayClock { get; set; }
 
+        [Resolved]
+        private DrawableRuleset drawableRuleset { get; set; }
+
         private IClock referenceClock;
 
         public bool UsesFixedAnchor { get; set; }
@@ -113,7 +116,7 @@ namespace osu.Game.Screens.Play
         }
 
         [BackgroundDependencyLoader(true)]
-        private void load(OsuColour colours, OsuConfigManager config, DrawableRuleset drawableRuleset)
+        private void load(OsuColour colours, OsuConfigManager config)
         {
             base.LoadComplete();
 

From 93bc0ac86966bed11fd59ce02df600e4cf717844 Mon Sep 17 00:00:00 2001
From: Jamie Taylor <me@nekodex.net>
Date: Thu, 17 Mar 2022 17:49:35 +0900
Subject: [PATCH 3488/5547] Update download links in README.md for macOS (to
 add Apple Silicon)

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index f64240f67a..dba0b2670d 100644
--- a/README.md
+++ b/README.md
@@ -31,7 +31,7 @@ If you are looking to install or test osu! without setting up a development envi
 
 **Latest build:**
 
-| [Windows 8.1+ (x64)](https://github.com/ppy/osu/releases/latest/download/install.exe) | [macOS 10.15+](https://github.com/ppy/osu/releases/latest/download/osu.app.zip) | [Linux (x64)](https://github.com/ppy/osu/releases/latest/download/osu.AppImage) | [iOS 10+](https://osu.ppy.sh/home/testflight) | [Android 5+](https://github.com/ppy/osu/releases/latest/download/sh.ppy.osulazer.apk)
+| [Windows 8.1+ (x64)](https://github.com/ppy/osu/releases/latest/download/install.exe) | macOS 10.15+ ([Intel](https://github.com/ppy/osu/releases/latest/download/osu.app.Intel.zip), [Apple Silicon](https://github.com/ppy/osu/releases/latest/download/osu.app.Apple.Silicon.zip)) | [Linux (x64)](https://github.com/ppy/osu/releases/latest/download/osu.AppImage) | [iOS 10+](https://osu.ppy.sh/home/testflight) | [Android 5+](https://github.com/ppy/osu/releases/latest/download/sh.ppy.osulazer.apk)
 | ------------- | ------------- | ------------- | ------------- | ------------- |
 
 - The iOS testflight link may fill up (Apple has a hard limit of 10,000 users). We reset it occasionally when this happens. Please do not ask about this. Check back regularly for link resets or follow [peppy](https://twitter.com/ppy) on twitter for announcements of link resets.

From 7b8fb341a54e9a5dab83bf363aec810cc466782e Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 17 Mar 2022 17:59:26 +0900
Subject: [PATCH 3489/5547] Fix not handling IconButtons

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

diff --git a/osu.Game/Tests/Visual/OsuManualInputManagerTestScene.cs b/osu.Game/Tests/Visual/OsuManualInputManagerTestScene.cs
index b7aa8af4aa..2deb8686cc 100644
--- a/osu.Game/Tests/Visual/OsuManualInputManagerTestScene.cs
+++ b/osu.Game/Tests/Visual/OsuManualInputManagerTestScene.cs
@@ -127,9 +127,9 @@ namespace osu.Game.Tests.Visual
             where T : Drawable
         {
             if (typeof(T) == typeof(Button))
-                AddUntilStep($"wait for {typeof(T).Name} enabled", () => (this.ChildrenOfType<T>().Single() as Button)?.Enabled.Value == true);
+                AddUntilStep($"wait for {typeof(T).Name} enabled", () => (this.ChildrenOfType<T>().Single() as ClickableContainer)?.Enabled.Value == true);
             else
-                AddUntilStep($"wait for {typeof(T).Name} enabled", () => this.ChildrenOfType<T>().Single().ChildrenOfType<Button>().Single().Enabled.Value);
+                AddUntilStep($"wait for {typeof(T).Name} enabled", () => this.ChildrenOfType<T>().Single().ChildrenOfType<ClickableContainer>().Single().Enabled.Value);
 
             AddStep($"click {typeof(T).Name}", () =>
             {

From 461d41529b081d276e9c85aa1fe1975f042f9f26 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 17 Mar 2022 18:36:33 +0900
Subject: [PATCH 3490/5547] Integrate spectate button implementation

---
 .../TestSceneMultiplayerSpectateButton.cs        | 10 ----------
 .../Multiplayer/Match/MultiplayerMatchFooter.cs  |  8 +-------
 .../Match/MultiplayerSpectateButton.cs           | 16 ++++++++++------
 .../Multiplayer/MultiplayerMatchSubScreen.cs     | 15 ---------------
 4 files changed, 11 insertions(+), 38 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerSpectateButton.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerSpectateButton.cs
index 956d40a456..31f8e00772 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerSpectateButton.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerSpectateButton.cs
@@ -71,16 +71,6 @@ namespace osu.Game.Tests.Visual.Multiplayer
                         Anchor = Anchor.Centre,
                         Origin = Anchor.Centre,
                         Size = new Vector2(200, 50),
-                        OnSpectateClick = () =>
-                        {
-                            readyClickOperation = OngoingOperationTracker.BeginOperation();
-
-                            Task.Run(async () =>
-                            {
-                                await MultiplayerClient.ToggleSpectate();
-                                readyClickOperation.Dispose();
-                            });
-                        }
                     },
                     readyButton = new MultiplayerReadyButton
                     {
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchFooter.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchFooter.cs
index 036e37ddfd..4d4cff021d 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchFooter.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchFooter.cs
@@ -17,13 +17,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
             set => readyButton.OnReadyClick = value;
         }
 
-        public Action OnSpectateClick
-        {
-            set => spectateButton.OnSpectateClick = value;
-        }
-
         private readonly MultiplayerReadyButton readyButton;
-        private readonly MultiplayerSpectateButton spectateButton;
 
         public MultiplayerMatchFooter()
         {
@@ -37,7 +31,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
                     new Drawable[]
                     {
                         null,
-                        spectateButton = new MultiplayerSpectateButton
+                        new MultiplayerSpectateButton
                         {
                             RelativeSizeAxes = Axes.Both,
                         },
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerSpectateButton.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerSpectateButton.cs
index db99c6a5d5..d939fbf400 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerSpectateButton.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerSpectateButton.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.Bindables;
 using osu.Framework.Graphics;
@@ -15,11 +14,6 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
 {
     public class MultiplayerSpectateButton : MultiplayerRoomComposite
     {
-        public Action OnSpectateClick
-        {
-            set => button.Action = value;
-        }
-
         [Resolved]
         private OngoingOperationTracker ongoingOperationTracker { get; set; }
 
@@ -37,9 +31,19 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
                 RelativeSizeAxes = Axes.Both,
                 Size = Vector2.One,
                 Enabled = { Value = true },
+                Action = onClick
             };
         }
 
+        private void onClick()
+        {
+            var clickOperation = ongoingOperationTracker.BeginOperation();
+
+            Client.ToggleSpectate().ContinueWith(t => endOperation());
+
+            void endOperation() => clickOperation?.Dispose();
+        }
+
         [BackgroundDependencyLoader]
         private void load()
         {
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
index c78dcb7cb6..3a8816de99 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
@@ -233,7 +233,6 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
         protected override Drawable CreateFooter() => new MultiplayerMatchFooter
         {
             OnReadyClick = onReadyClick,
-            OnSpectateClick = onSpectateClick
         };
 
         protected override RoomSettingsOverlay CreateRoomSettingsOverlay(Room room) => new MultiplayerMatchSettingsOverlay(room);
@@ -364,20 +363,6 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
             }
         }
 
-        private void onSpectateClick()
-        {
-            Debug.Assert(readyClickOperation == null);
-            readyClickOperation = ongoingOperationTracker.BeginOperation();
-
-            client.ToggleSpectate().ContinueWith(t => endOperation());
-
-            void endOperation()
-            {
-                readyClickOperation?.Dispose();
-                readyClickOperation = null;
-            }
-        }
-
         private void onRoomUpdated()
         {
             // may happen if the client is kicked or otherwise removed from the room.

From e252f1a3cd109e0cc758ff8b30af9b3a2541adbb Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 17 Mar 2022 18:40:26 +0900
Subject: [PATCH 3491/5547] Add explanation about try-catch logic in
 `SkinComponentToolbox`

---
 osu.Game/Skinning/Editor/SkinComponentToolbox.cs | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Skinning/Editor/SkinComponentToolbox.cs b/osu.Game/Skinning/Editor/SkinComponentToolbox.cs
index 9c4a369c1d..a586cdcd54 100644
--- a/osu.Game/Skinning/Editor/SkinComponentToolbox.cs
+++ b/osu.Game/Skinning/Editor/SkinComponentToolbox.cs
@@ -8,6 +8,7 @@ using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Input.Events;
+using osu.Framework.Logging;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.UserInterface;
@@ -74,8 +75,14 @@ namespace osu.Game.Skinning.Editor
                     RequestPlacement = t => RequestPlacement?.Invoke(t)
                 });
             }
-            catch
+            catch (DependencyNotRegisteredException)
             {
+                // This loading code relies on try-catching any dependency injection errors to know which components are valid for the current target screen.
+                // If a screen can't provide the required dependencies, a skinnable component should not be displayed in the list.
+            }
+            catch (Exception e)
+            {
+                Logger.Error(e, $"Skin component {type} could not be loaded in the editor component list due to an error");
             }
         }
 

From da0ffab14ece4e273620593d8d128b026fc100e7 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 17 Mar 2022 18:43:04 +0900
Subject: [PATCH 3492/5547] Integrate ready button implementation

---
 .../TestSceneMultiplayerReadyButton.cs        | 24 -------
 .../TestSceneMultiplayerSpectateButton.cs     | 21 -------
 .../Match/MultiplayerMatchFooter.cs           | 10 +--
 .../Match/MultiplayerReadyButton.cs           | 62 ++++++++++++++++---
 .../Multiplayer/MultiplayerMatchSubScreen.cs  | 48 +-------------
 .../Multiplayer/MultiplayerRoomComposite.cs   |  9 +++
 6 files changed, 64 insertions(+), 110 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs
index c86d5e482a..f34f7c6c91 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs
@@ -1,9 +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 System.Threading.Tasks;
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
@@ -35,8 +33,6 @@ namespace osu.Game.Tests.Visual.Multiplayer
         private BeatmapManager beatmaps;
         private RulesetStore rulesets;
 
-        private IDisposable readyClickOperation;
-
         [BackgroundDependencyLoader]
         private void load(GameHost host, AudioManager audio)
         {
@@ -67,23 +63,6 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 Anchor = Anchor.Centre,
                 Origin = Anchor.Centre,
                 Size = new Vector2(200, 50),
-                OnReadyClick = () =>
-                {
-                    readyClickOperation = OngoingOperationTracker.BeginOperation();
-
-                    Task.Run(async () =>
-                    {
-                        if (MultiplayerClient.IsHost && MultiplayerClient.LocalUser?.State == MultiplayerUserState.Ready)
-                        {
-                            await MultiplayerClient.StartMatch();
-                            return;
-                        }
-
-                        await MultiplayerClient.ToggleReady();
-
-                        readyClickOperation.Dispose();
-                    });
-                }
             });
         });
 
@@ -208,9 +187,6 @@ namespace osu.Game.Tests.Visual.Multiplayer
             ClickButtonWhenEnabled<MultiplayerReadyButton>();
             AddUntilStep("user waiting for load", () => MultiplayerClient.Room?.Users[0].State == MultiplayerUserState.WaitingForLoad);
 
-            AddAssert("ready button disabled", () => !button.ChildrenOfType<OsuButton>().Single().Enabled.Value);
-            AddStep("transitioned to gameplay", () => readyClickOperation.Dispose());
-
             AddStep("finish gameplay", () =>
             {
                 MultiplayerClient.ChangeUserState(MultiplayerClient.Room?.Users[0].UserID ?? 0, MultiplayerUserState.Loaded);
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerSpectateButton.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerSpectateButton.cs
index 31f8e00772..33ad0fd1de 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerSpectateButton.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerSpectateButton.cs
@@ -1,9 +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 System.Threading.Tasks;
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
@@ -36,8 +34,6 @@ namespace osu.Game.Tests.Visual.Multiplayer
         private BeatmapManager beatmaps;
         private RulesetStore rulesets;
 
-        private IDisposable readyClickOperation;
-
         [BackgroundDependencyLoader]
         private void load(GameHost host, AudioManager audio)
         {
@@ -77,23 +73,6 @@ namespace osu.Game.Tests.Visual.Multiplayer
                         Anchor = Anchor.Centre,
                         Origin = Anchor.Centre,
                         Size = new Vector2(200, 50),
-                        OnReadyClick = () =>
-                        {
-                            readyClickOperation = OngoingOperationTracker.BeginOperation();
-
-                            Task.Run(async () =>
-                            {
-                                if (MultiplayerClient.IsHost && MultiplayerClient.LocalUser?.State == MultiplayerUserState.Ready)
-                                {
-                                    await MultiplayerClient.StartMatch();
-                                    return;
-                                }
-
-                                await MultiplayerClient.ToggleReady();
-
-                                readyClickOperation.Dispose();
-                            });
-                        }
                     }
                 }
             };
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchFooter.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchFooter.cs
index 4d4cff021d..b4fce5903b 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchFooter.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchFooter.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.Graphics;
 using osu.Framework.Graphics.Containers;
 
@@ -12,13 +11,6 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
         private const float ready_button_width = 600;
         private const float spectate_button_width = 200;
 
-        public Action OnReadyClick
-        {
-            set => readyButton.OnReadyClick = value;
-        }
-
-        private readonly MultiplayerReadyButton readyButton;
-
         public MultiplayerMatchFooter()
         {
             RelativeSizeAxes = Axes.Both;
@@ -36,7 +28,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
                             RelativeSizeAxes = Axes.Both,
                         },
                         null,
-                        readyButton = new MultiplayerReadyButton
+                        new MultiplayerReadyButton
                         {
                             RelativeSizeAxes = Axes.Both,
                         },
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
index 023af85f3b..0c80f6ef5b 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
@@ -2,7 +2,9 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
+using System.Diagnostics;
 using System.Linq;
+using JetBrains.Annotations;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
 using osu.Framework.Audio.Sample;
@@ -19,28 +21,23 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
 {
     public class MultiplayerReadyButton : MultiplayerRoomComposite
     {
-        public Action OnReadyClick
-        {
-            set => button.Action = value;
-        }
-
         [Resolved]
         private OsuColour colours { get; set; }
 
         [Resolved]
         private OngoingOperationTracker ongoingOperationTracker { get; set; }
 
-        private IBindable<bool> operationInProgress;
+        [CanBeNull]
+        private IDisposable clickOperation;
 
         private Sample sampleReady;
         private Sample sampleReadyAll;
         private Sample sampleUnready;
 
         private readonly ButtonWithTrianglesExposed button;
-
         private int countReady;
-
         private ScheduledDelegate readySampleDelegate;
+        private IBindable<bool> operationInProgress;
 
         public MultiplayerReadyButton()
         {
@@ -48,6 +45,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
             {
                 RelativeSizeAxes = Axes.Both,
                 Size = Vector2.One,
+                Action = onReadyClick,
                 Enabled = { Value = true },
             };
         }
@@ -73,10 +71,56 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
         protected override void OnRoomUpdated()
         {
             base.OnRoomUpdated();
-
             updateState();
         }
 
+        protected override void OnRoomLoadRequested()
+        {
+            base.OnRoomLoadRequested();
+            endOperation();
+        }
+
+        private void onReadyClick()
+        {
+            if (Room == null)
+                return;
+
+            Debug.Assert(clickOperation == null);
+            clickOperation = ongoingOperationTracker.BeginOperation();
+
+            // Ensure the current user becomes ready before being able to do anything else (start match, stop countdown, unready).
+            if (!isReady() || !Client.IsHost)
+            {
+                toggleReady();
+                return;
+            }
+
+            // And if a countdown isn't running, start the match.
+            startMatch();
+
+            bool isReady() => Client.LocalUser?.State == MultiplayerUserState.Ready || Client.LocalUser?.State == MultiplayerUserState.Spectating;
+
+            void toggleReady() => Client.ToggleReady().ContinueWith(_ => endOperation());
+
+            void startMatch() => Client.StartMatch().ContinueWith(t =>
+            {
+                // accessing Exception here silences any potential errors from the antecedent task
+                if (t.Exception != null)
+                {
+                    // gameplay was not started due to an exception; unblock button.
+                    endOperation();
+                }
+
+                // gameplay is starting, the button will be unblocked on load requested.
+            });
+        }
+
+        private void endOperation()
+        {
+            clickOperation?.Dispose();
+            clickOperation = null;
+        }
+
         private void updateState()
         {
             var localUser = Client.LocalUser;
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
index 3a8816de99..e53153e017 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
@@ -1,11 +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;
 using System.Collections.Generic;
 using System.Diagnostics;
 using System.Linq;
-using JetBrains.Annotations;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
@@ -46,14 +44,8 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
         [Resolved]
         private MultiplayerClient client { get; set; }
 
-        [Resolved]
-        private OngoingOperationTracker ongoingOperationTracker { get; set; }
-
         private readonly IBindable<bool> isConnected = new Bindable<bool>();
 
-        [CanBeNull]
-        private IDisposable readyClickOperation;
-
         private AddItemButton addItemButton;
 
         public MultiplayerMatchSubScreen(Room room)
@@ -230,10 +222,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
             this.Push(new MultiplayerMatchSongSelect(Room, itemToEdit));
         }
 
-        protected override Drawable CreateFooter() => new MultiplayerMatchFooter
-        {
-            OnReadyClick = onReadyClick,
-        };
+        protected override Drawable CreateFooter() => new MultiplayerMatchFooter();
 
         protected override RoomSettingsOverlay CreateRoomSettingsOverlay(Room room) => new MultiplayerMatchSettingsOverlay(room);
 
@@ -331,38 +320,6 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
             }
         }
 
-        private void onReadyClick()
-        {
-            Debug.Assert(readyClickOperation == null);
-            readyClickOperation = ongoingOperationTracker.BeginOperation();
-
-            if (client.IsHost && (client.LocalUser?.State == MultiplayerUserState.Ready || client.LocalUser?.State == MultiplayerUserState.Spectating))
-            {
-                client.StartMatch()
-                      .ContinueWith(t =>
-                      {
-                          // accessing Exception here silences any potential errors from the antecedent task
-                          if (t.Exception != null)
-                          {
-                              // gameplay was not started due to an exception; unblock button.
-                              endOperation();
-                          }
-
-                          // gameplay is starting, the button will be unblocked on load requested.
-                      });
-                return;
-            }
-
-            client.ToggleReady()
-                  .ContinueWith(t => endOperation());
-
-            void endOperation()
-            {
-                readyClickOperation?.Dispose();
-                readyClickOperation = null;
-            }
-        }
-
         private void onRoomUpdated()
         {
             // may happen if the client is kicked or otherwise removed from the room.
@@ -418,9 +375,6 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
                 return;
 
             StartPlay();
-
-            readyClickOperation?.Dispose();
-            readyClickOperation = null;
         }
 
         protected override Screen CreateGameplayScreen()
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerRoomComposite.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerRoomComposite.cs
index 7d2fe44c4e..f6f815a3cb 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerRoomComposite.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerRoomComposite.cs
@@ -21,6 +21,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
             base.LoadComplete();
 
             Client.RoomUpdated += invokeOnRoomUpdated;
+            Client.LoadRequested += invokeOnRoomLoadRequested;
             Client.UserLeft += invokeUserLeft;
             Client.UserKicked += invokeUserKicked;
             Client.UserJoined += invokeUserJoined;
@@ -38,6 +39,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
         private void invokeItemAdded(MultiplayerPlaylistItem item) => Schedule(() => PlaylistItemAdded(item));
         private void invokeItemRemoved(long item) => Schedule(() => PlaylistItemRemoved(item));
         private void invokeItemChanged(MultiplayerPlaylistItem item) => Schedule(() => PlaylistItemChanged(item));
+        private void invokeOnRoomLoadRequested() => Scheduler.AddOnce(OnRoomLoadRequested);
 
         /// <summary>
         /// Invoked when a user has joined the room.
@@ -94,6 +96,13 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
         {
         }
 
+        /// <summary>
+        /// Invoked when the room requests the local user to load into gameplay.
+        /// </summary>
+        protected virtual void OnRoomLoadRequested()
+        {
+        }
+
         protected override void Dispose(bool isDisposing)
         {
             if (Client != null)

From 0d79dd5e62bd40d850a2eba9fd20eda870d2d790 Mon Sep 17 00:00:00 2001
From: Jamie Taylor <me@nekodex.net>
Date: Thu, 17 Mar 2022 18:45:31 +0900
Subject: [PATCH 3493/5547] Update SimpleUpdateManager to handle new macOS
 build naming scheme

---
 osu.Game/Updater/SimpleUpdateManager.cs | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Updater/SimpleUpdateManager.cs b/osu.Game/Updater/SimpleUpdateManager.cs
index 61ca68a1ab..c57a7c768e 100644
--- a/osu.Game/Updater/SimpleUpdateManager.cs
+++ b/osu.Game/Updater/SimpleUpdateManager.cs
@@ -3,6 +3,7 @@
 
 using System;
 using System.Linq;
+using System.Runtime.InteropServices;
 using System.Threading.Tasks;
 using osu.Framework;
 using osu.Framework.Allocation;
@@ -82,7 +83,8 @@ namespace osu.Game.Updater
                     break;
 
                 case RuntimeInfo.Platform.macOS:
-                    bestAsset = release.Assets?.Find(f => f.Name.EndsWith(".app.zip", StringComparison.Ordinal));
+                    string arch = RuntimeInformation.OSArchitecture == Architecture.Arm64 ? "Apple.Silicon" : "Intel";
+                    bestAsset = release.Assets?.Find(f => f.Name.EndsWith($".app.{arch}.zip", StringComparison.Ordinal));
                     break;
 
                 case RuntimeInfo.Platform.Linux:

From 4650c197a30dc311a072dc292f4fb6a5f5929ba4 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 17 Mar 2022 18:45:35 +0900
Subject: [PATCH 3494/5547] Make `SongProgress.DrawableRuleset` nullable to
 allow test scene to work

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

diff --git a/osu.Game/Screens/Play/SongProgress.cs b/osu.Game/Screens/Play/SongProgress.cs
index 694b5ec628..e620abb90f 100644
--- a/osu.Game/Screens/Play/SongProgress.cs
+++ b/osu.Game/Screens/Play/SongProgress.cs
@@ -76,7 +76,7 @@ namespace osu.Game.Screens.Play
         [Resolved]
         private GameplayClock gameplayClock { get; set; }
 
-        [Resolved]
+        [Resolved(canBeNull: true)]
         private DrawableRuleset drawableRuleset { get; set; }
 
         private IClock referenceClock;

From e3a5299b1acc6bba39f5b9de2726159add8ecb89 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 17 Mar 2022 19:23:43 +0900
Subject: [PATCH 3495/5547] Expose the loading player in `PlayerLoader`

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

diff --git a/osu.Game/Screens/Play/PlayerLoader.cs b/osu.Game/Screens/Play/PlayerLoader.cs
index 41eb822e39..384561d616 100644
--- a/osu.Game/Screens/Play/PlayerLoader.cs
+++ b/osu.Game/Screens/Play/PlayerLoader.cs
@@ -90,7 +90,7 @@ namespace osu.Game.Screens.Play
         private bool readyForPush =>
             !playerConsumed
             // don't push unless the player is completely loaded
-            && player?.LoadState == LoadState.Ready
+            && CurrentPlayer?.LoadState == LoadState.Ready
             // don't push if the user is hovering one of the panes, unless they are idle.
             && (IsHovered || idleTracker.IsIdle.Value)
             // don't push if the user is dragging a slider or otherwise.
@@ -100,10 +100,14 @@ namespace osu.Game.Screens.Play
 
         private readonly Func<Player> createPlayer;
 
-        private Player player;
+        /// <summary>
+        /// The <see cref="Player"/> instance being loaded by this screen.
+        /// </summary>
+        [CanBeNull]
+        public Player CurrentPlayer { get; private set; }
 
         /// <summary>
-        /// Whether the curent player instance has been consumed via <see cref="consumePlayer"/>.
+        /// Whether the current player instance has been consumed via <see cref="consumePlayer"/>.
         /// </summary>
         private bool playerConsumed;
 
@@ -237,12 +241,12 @@ namespace osu.Game.Screens.Play
         {
             base.OnResuming(last);
 
-            var lastScore = player.Score;
+            var lastScore = CurrentPlayer.Score;
 
             AudioSettings.ReferenceScore.Value = lastScore?.ScoreInfo;
 
             // prepare for a retry.
-            player = null;
+            CurrentPlayer = null;
             playerConsumed = false;
             cancelLoad();
 
@@ -346,7 +350,7 @@ namespace osu.Game.Screens.Play
             Debug.Assert(!playerConsumed);
 
             playerConsumed = true;
-            return player;
+            return CurrentPlayer;
         }
 
         private void prepareNewPlayer()
@@ -354,11 +358,11 @@ namespace osu.Game.Screens.Play
             if (!this.IsCurrentScreen())
                 return;
 
-            player = createPlayer();
-            player.RestartCount = restartCount++;
-            player.RestartRequested = restartRequested;
+            CurrentPlayer = createPlayer();
+            CurrentPlayer.RestartCount = restartCount++;
+            CurrentPlayer.RestartRequested = restartRequested;
 
-            LoadTask = LoadComponentAsync(player, _ => MetadataInfo.Loading = false);
+            LoadTask = LoadComponentAsync(CurrentPlayer, _ => MetadataInfo.Loading = false);
         }
 
         private void restartRequested()
@@ -472,7 +476,7 @@ namespace osu.Game.Screens.Play
             if (isDisposing)
             {
                 // if the player never got pushed, we should explicitly dispose it.
-                DisposalTask = LoadTask?.ContinueWith(_ => player?.Dispose());
+                DisposalTask = LoadTask?.ContinueWith(_ => CurrentPlayer?.Dispose());
             }
         }
 

From ef29de997135db93b9fe1405a2ba14d34857ed17 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 17 Mar 2022 19:50:43 +0900
Subject: [PATCH 3496/5547] Add one more missing dependency required by
 `SongProgress`

---
 .../Visual/Gameplay/TestSceneBeatmapSkinFallbacks.cs           | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneBeatmapSkinFallbacks.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneBeatmapSkinFallbacks.cs
index c70313ee8a..eb1695b3df 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneBeatmapSkinFallbacks.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneBeatmapSkinFallbacks.cs
@@ -42,6 +42,9 @@ namespace osu.Game.Tests.Visual.Gameplay
         [Cached]
         private GameplayState gameplayState = new GameplayState(new TestBeatmap(new OsuRuleset().RulesetInfo), new OsuRuleset());
 
+        [Cached]
+        private readonly GameplayClock gameplayClock = new GameplayClock(new FramedClock());
+
         protected override bool HasCustomSteps => true;
 
         [Test]

From 5164b4d6403bcb83fedbd8f83a35999eb1eeb58f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 17 Mar 2022 19:36:33 +0900
Subject: [PATCH 3497/5547] Use `nullable` in `PlayerLoader`

---
 osu.Game/Screens/Play/PlayerLoader.cs | 54 ++++++++++++++-------------
 1 file changed, 28 insertions(+), 26 deletions(-)

diff --git a/osu.Game/Screens/Play/PlayerLoader.cs b/osu.Game/Screens/Play/PlayerLoader.cs
index 384561d616..ba720af2a1 100644
--- a/osu.Game/Screens/Play/PlayerLoader.cs
+++ b/osu.Game/Screens/Play/PlayerLoader.cs
@@ -1,10 +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 enable
+
 using System;
 using System.Diagnostics;
 using System.Threading.Tasks;
-using JetBrains.Annotations;
 using ManagedBass.Fx;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
@@ -48,31 +49,31 @@ namespace osu.Game.Screens.Play
         public override bool HandlePositionalInput => true;
 
         // We show the previous screen status
-        protected override UserActivity InitialActivity => null;
+        protected override UserActivity? InitialActivity => null;
 
         protected override bool PlayResumeSound => false;
 
-        protected BeatmapMetadataDisplay MetadataInfo { get; private set; }
+        protected BeatmapMetadataDisplay MetadataInfo { get; private set; } = null!;
 
         /// <summary>
         /// A fill flow containing the player settings groups, exposed for the ability to hide it from inheritors of the player loader.
         /// </summary>
-        protected FillFlowContainer<PlayerSettingsGroup> PlayerSettings { get; private set; }
+        protected FillFlowContainer<PlayerSettingsGroup> PlayerSettings { get; private set; } = null!;
 
-        protected VisualSettings VisualSettings { get; private set; }
+        protected VisualSettings VisualSettings { get; private set; } = null!;
 
-        protected AudioSettings AudioSettings { get; private set; }
+        protected AudioSettings AudioSettings { get; private set; } = null!;
 
-        protected Task LoadTask { get; private set; }
+        protected Task? LoadTask { get; private set; }
 
-        protected Task DisposalTask { get; private set; }
+        protected Task? DisposalTask { get; private set; }
 
         private bool backgroundBrightnessReduction;
 
         private readonly BindableDouble volumeAdjustment = new BindableDouble(1);
 
-        private AudioFilter lowPassFilter;
-        private AudioFilter highPassFilter;
+        private AudioFilter lowPassFilter = null!;
+        private AudioFilter highPassFilter = null!;
 
         protected bool BackgroundBrightnessReduction
         {
@@ -94,47 +95,45 @@ namespace osu.Game.Screens.Play
             // don't push if the user is hovering one of the panes, unless they are idle.
             && (IsHovered || idleTracker.IsIdle.Value)
             // don't push if the user is dragging a slider or otherwise.
-            && inputManager?.DraggedDrawable == null
+            && inputManager.DraggedDrawable == null
             // don't push if a focused overlay is visible, like settings.
-            && inputManager?.FocusedDrawable == null;
+            && inputManager.FocusedDrawable == null;
 
         private readonly Func<Player> createPlayer;
 
         /// <summary>
         /// The <see cref="Player"/> instance being loaded by this screen.
         /// </summary>
-        [CanBeNull]
-        public Player CurrentPlayer { get; private set; }
+        public Player? CurrentPlayer { get; private set; }
 
         /// <summary>
         /// Whether the current player instance has been consumed via <see cref="consumePlayer"/>.
         /// </summary>
         private bool playerConsumed;
 
-        private LogoTrackingContainer content;
+        private LogoTrackingContainer content = null!;
 
         private bool hideOverlays;
 
-        private InputManager inputManager;
+        private InputManager inputManager = null!;
 
-        private IdleTracker idleTracker;
+        private IdleTracker idleTracker = null!;
 
-        private ScheduledDelegate scheduledPushPlayer;
+        private ScheduledDelegate? scheduledPushPlayer;
 
-        [CanBeNull]
-        private EpilepsyWarning epilepsyWarning;
+        private EpilepsyWarning? epilepsyWarning;
 
         [Resolved(CanBeNull = true)]
-        private NotificationOverlay notificationOverlay { get; set; }
+        private NotificationOverlay? notificationOverlay { get; set; }
 
         [Resolved(CanBeNull = true)]
-        private VolumeOverlay volumeOverlay { get; set; }
+        private VolumeOverlay? volumeOverlay { get; set; }
 
         [Resolved]
-        private AudioManager audioManager { get; set; }
+        private AudioManager audioManager { get; set; } = null!;
 
         [Resolved(CanBeNull = true)]
-        private BatteryInfo batteryInfo { get; set; }
+        private BatteryInfo? batteryInfo { get; set; }
 
         public PlayerLoader(Func<Player> createPlayer)
         {
@@ -241,6 +240,8 @@ namespace osu.Game.Screens.Play
         {
             base.OnResuming(last);
 
+            Debug.Assert(CurrentPlayer != null);
+
             var lastScore = CurrentPlayer.Score;
 
             AudioSettings.ReferenceScore.Value = lastScore?.ScoreInfo;
@@ -348,6 +349,7 @@ namespace osu.Game.Screens.Play
         private Player consumePlayer()
         {
             Debug.Assert(!playerConsumed);
+            Debug.Assert(CurrentPlayer != null);
 
             playerConsumed = true;
             return CurrentPlayer;
@@ -484,7 +486,7 @@ namespace osu.Game.Screens.Play
 
         #region Mute warning
 
-        private Bindable<bool> muteWarningShownOnce;
+        private Bindable<bool> muteWarningShownOnce = null!;
 
         private int restartCount;
 
@@ -539,7 +541,7 @@ namespace osu.Game.Screens.Play
 
         #region Low battery warning
 
-        private Bindable<bool> batteryWarningShownOnce;
+        private Bindable<bool> batteryWarningShownOnce = null!;
 
         private void showBatteryWarningIfNeeded()
         {

From e3a8bb2d1c36c4995177a2826126e47dc2a0c6eb Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 17 Mar 2022 19:23:49 +0900
Subject: [PATCH 3498/5547] Add test coverage of `SpectatorPlayer` failing to
 seek on inopportune frame arrival time

---
 .../Visual/Gameplay/TestSceneSpectator.cs     | 54 ++++++++++++++++++-
 .../Visual/Spectator/TestSpectatorClient.cs   |  5 +-
 2 files changed, 55 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs
index d614815316..8b420cebc8 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs
@@ -70,6 +70,56 @@ namespace osu.Game.Tests.Visual.Gameplay
             });
         }
 
+        [Test]
+        public void TestSeekToGameplayStartFramesArriveAfterPlayerLoad()
+        {
+            const double gameplay_start = 10000;
+
+            loadSpectatingScreen();
+
+            start();
+
+            waitForPlayer();
+
+            sendFrames(startTime: gameplay_start);
+
+            AddAssert("time is greater than seek target", () => currentFrameStableTime > gameplay_start);
+        }
+
+        /// <summary>
+        /// Tests the same as <see cref="TestSeekToGameplayStartFramesArriveAfterPlayerLoad"/> but with the frames arriving just as <see cref="Player"/> is transitioning into existence.
+        /// </summary>
+        [Test]
+        public void TestSeekToGameplayStartFramesArriveAsPlayerLoaded()
+        {
+            const double gameplay_start = 10000;
+
+            loadSpectatingScreen();
+
+            start();
+
+            AddUntilStep("wait for player loader", () => (Stack.CurrentScreen as PlayerLoader)?.IsLoaded == true);
+
+            AddUntilStep("queue send frames on player load", () =>
+            {
+                var loadingPlayer = (Stack.CurrentScreen as PlayerLoader)?.CurrentPlayer;
+
+                if (loadingPlayer == null)
+                    return false;
+
+                loadingPlayer.OnLoadComplete += _ =>
+                {
+                    spectatorClient.SendFramesFromUser(streamingUser.Id, 10, gameplay_start);
+                };
+                return true;
+            });
+
+            waitForPlayer();
+
+            AddUntilStep("state is playing", () => spectatorClient.WatchedUserStates[streamingUser.Id].State == SpectatedUserState.Playing);
+            AddAssert("time is greater than seek target", () => currentFrameStableTime > gameplay_start);
+        }
+
         [Test]
         public void TestFrameStarvationAndResume()
         {
@@ -319,9 +369,9 @@ namespace osu.Game.Tests.Visual.Gameplay
         private void checkPaused(bool state) =>
             AddUntilStep($"game is {(state ? "paused" : "playing")}", () => player.ChildrenOfType<DrawableRuleset>().First().IsPaused.Value == state);
 
-        private void sendFrames(int count = 10)
+        private void sendFrames(int count = 10, double startTime = 0)
         {
-            AddStep("send frames", () => spectatorClient.SendFramesFromUser(streamingUser.Id, count));
+            AddStep("send frames", () => spectatorClient.SendFramesFromUser(streamingUser.Id, count, startTime));
         }
 
         private void loadSpectatingScreen()
diff --git a/osu.Game/Tests/Visual/Spectator/TestSpectatorClient.cs b/osu.Game/Tests/Visual/Spectator/TestSpectatorClient.cs
index f5da95bd7b..ac7cb43e02 100644
--- a/osu.Game/Tests/Visual/Spectator/TestSpectatorClient.cs
+++ b/osu.Game/Tests/Visual/Spectator/TestSpectatorClient.cs
@@ -88,7 +88,8 @@ namespace osu.Game.Tests.Visual.Spectator
         /// </summary>
         /// <param name="userId">The user to send frames for.</param>
         /// <param name="count">The total number of frames to send.</param>
-        public void SendFramesFromUser(int userId, int count)
+        /// <param name="startTime">The time to start gameplay frames from.</param>
+        public void SendFramesFromUser(int userId, int count, double startTime = 0)
         {
             var frames = new List<LegacyReplayFrame>();
 
@@ -102,7 +103,7 @@ namespace osu.Game.Tests.Visual.Spectator
                     flush();
 
                 var buttonState = currentFrameIndex == lastFrameIndex ? ReplayButtonState.None : ReplayButtonState.Left1;
-                frames.Add(new LegacyReplayFrame(currentFrameIndex * 100, RNG.Next(0, 512), RNG.Next(0, 512), buttonState));
+                frames.Add(new LegacyReplayFrame(currentFrameIndex * 100 + startTime, RNG.Next(0, 512), RNG.Next(0, 512), buttonState));
             }
 
             flush();

From a4a0241800934b62349ac11b913e5e0a1c94c929 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 17 Mar 2022 20:54:42 +0900
Subject: [PATCH 3499/5547] Use a more explicit flow to set and reset
 `GameplayClockContainer` start time

---
 .../Screens/Play/GameplayClockContainer.cs    | 20 ++++++--
 .../Play/MasterGameplayClockContainer.cs      | 49 ++++++++++---------
 osu.Game/Screens/Play/Player.cs               | 10 ++--
 osu.Game/Screens/Play/SpectatorPlayer.cs      |  2 +-
 4 files changed, 48 insertions(+), 33 deletions(-)

diff --git a/osu.Game/Screens/Play/GameplayClockContainer.cs b/osu.Game/Screens/Play/GameplayClockContainer.cs
index 0fd524f976..b60a3e306e 100644
--- a/osu.Game/Screens/Play/GameplayClockContainer.cs
+++ b/osu.Game/Screens/Play/GameplayClockContainer.cs
@@ -41,6 +41,15 @@ namespace osu.Game.Screens.Play
         /// </summary>
         public event Action OnSeek;
 
+        /// <summary>
+        /// The time from which gameplay should start. Will be seeked to on calling <see cref="Reset"/>.
+        /// </summary>
+        /// <remarks>
+        /// If not set, a value of zero will be used.
+        /// Importantly, the value will be inferred from the current ruleset in <see cref="MasterGameplayClockContainer"/> unless specified.
+        /// </remarks>
+        protected double? GameplayStartTime { get; private set; }
+
         /// <summary>
         /// Creates a new <see cref="GameplayClockContainer"/>.
         /// </summary>
@@ -106,15 +115,20 @@ namespace osu.Game.Screens.Play
         /// <summary>
         /// Resets this <see cref="GameplayClockContainer"/> and the source to an initial state ready for gameplay.
         /// </summary>
-        public virtual void Reset()
+        /// <param name="startClock">Whether to start the clock immediately.</param>
+        /// <param name="gameplayStartTime">A time to use for future <see cref="Reset"/> calls as the definite start of gameplay.</param>
+        public void Reset(bool startClock = false, double? gameplayStartTime = null)
         {
+            if (gameplayStartTime != null)
+                GameplayStartTime = gameplayStartTime;
+
             ensureSourceClockSet();
-            Seek(0);
+            Seek(GameplayStartTime ?? 0);
 
             // Manually stop the source in order to not affect the IsPaused state.
             AdjustableSource.Stop();
 
-            if (!IsPaused.Value)
+            if (!IsPaused.Value && startClock)
                 Start();
         }
 
diff --git a/osu.Game/Screens/Play/MasterGameplayClockContainer.cs b/osu.Game/Screens/Play/MasterGameplayClockContainer.cs
index af58e9d910..ce7b6ef7f0 100644
--- a/osu.Game/Screens/Play/MasterGameplayClockContainer.cs
+++ b/osu.Game/Screens/Play/MasterGameplayClockContainer.cs
@@ -58,7 +58,6 @@ namespace osu.Game.Screens.Play
         private HardwareCorrectionOffsetClock platformOffsetClock;
         private MasterGameplayClock masterGameplayClock;
         private Bindable<double> userAudioOffset;
-        private double startOffset;
 
         private IDisposable beatmapOffsetSubscription;
 
@@ -90,26 +89,33 @@ namespace osu.Game.Screens.Play
                 settings => settings.Offset,
                 val => userBeatmapOffsetClock.Offset = val);
 
-            // sane default provided by ruleset.
-            startOffset = gameplayStartTime;
-
-            if (!startAtGameplayStart)
+            if (GameplayStartTime == null)
             {
-                startOffset = Math.Min(0, startOffset);
+                // sane default provided by ruleset.
+                double offset = gameplayStartTime;
 
-                // if a storyboard is present, it may dictate the appropriate start time by having events in negative time space.
-                // this is commonly used to display an intro before the audio track start.
-                double? firstStoryboardEvent = beatmap.Storyboard.EarliestEventTime;
-                if (firstStoryboardEvent != null)
-                    startOffset = Math.Min(startOffset, firstStoryboardEvent.Value);
+                if (!startAtGameplayStart)
+                {
+                    offset = Math.Min(0, offset);
 
-                // some beatmaps specify a current lead-in time which should be used instead of the ruleset-provided value when available.
-                // this is not available as an option in the live editor but can still be applied via .osu editing.
-                if (beatmap.BeatmapInfo.AudioLeadIn > 0)
-                    startOffset = Math.Min(startOffset, firstHitObjectTime - beatmap.BeatmapInfo.AudioLeadIn);
+                    // if a storyboard is present, it may dictate the appropriate start time by having events in negative time space.
+                    // this is commonly used to display an intro before the audio track start.
+                    double? firstStoryboardEvent = beatmap.Storyboard.EarliestEventTime;
+                    if (firstStoryboardEvent != null)
+                        offset = Math.Min(offset, firstStoryboardEvent.Value);
+
+                    // some beatmaps specify a current lead-in time which should be used instead of the ruleset-provided value when available.
+                    // this is not available as an option in the live editor but can still be applied via .osu editing.
+                    if (beatmap.BeatmapInfo.AudioLeadIn > 0)
+                        offset = Math.Min(offset, firstHitObjectTime - beatmap.BeatmapInfo.AudioLeadIn);
+                }
+
+                // Reset may have been called externally before LoadComplete.
+                // If it was and the clock is in a playing state, we want to ensure that it isn't stopped here.
+                bool isStarted = !IsPaused.Value;
+
+                Reset(startClock: isStarted, gameplayStartTime: offset);
             }
-
-            Seek(startOffset);
         }
 
         protected override void OnIsPausedChanged(ValueChangedEvent<bool> isPaused)
@@ -164,12 +170,6 @@ namespace osu.Game.Screens.Play
             Seek(skipTarget);
         }
 
-        public override void Reset()
-        {
-            base.Reset();
-            Seek(startOffset);
-        }
-
         protected override GameplayClock CreateGameplayClock(IFrameBasedClock source)
         {
             // Lazer's audio timings in general doesn't match stable. This is the result of user testing, albeit limited.
@@ -231,6 +231,7 @@ namespace osu.Game.Screens.Play
         }
 
         private class HardwareCorrectionOffsetClock : FramedOffsetClock
+
         {
             private readonly BindableDouble pauseRateAdjust;
 
@@ -276,9 +277,9 @@ namespace osu.Game.Screens.Play
         }
 
         private class MasterGameplayClock : GameplayClock
+
         {
             public readonly List<Bindable<double>> MutableNonGameplayAdjustments = new List<Bindable<double>>();
-
             public override IEnumerable<Bindable<double>> NonGameplayAdjustments => MutableNonGameplayAdjustments;
 
             public MasterGameplayClock(FramedOffsetClock underlyingClock)
diff --git a/osu.Game/Screens/Play/Player.cs b/osu.Game/Screens/Play/Player.cs
index cb8f4b6020..6ec21ef924 100644
--- a/osu.Game/Screens/Play/Player.cs
+++ b/osu.Game/Screens/Play/Player.cs
@@ -607,13 +607,13 @@ namespace osu.Game.Screens.Play
         private ScheduledDelegate frameStablePlaybackResetDelegate;
 
         /// <summary>
-        /// Seeks to a specific time in gameplay, bypassing frame stability.
+        /// Specify and seek to a custom start time from which gameplay should be observed.
         /// </summary>
         /// <remarks>
-        /// Intermediate hitobject judgements may not be applied or reverted correctly during this seek.
+        /// This performance a non-frame-stable seek. Intermediate hitobject judgements may not be applied or reverted correctly during this seek.
         /// </remarks>
         /// <param name="time">The destination time to seek to.</param>
-        internal void NonFrameStableSeek(double time)
+        protected void SetGameplayStartTime(double time)
         {
             if (frameStablePlaybackResetDelegate?.Cancelled == false && !frameStablePlaybackResetDelegate.Completed)
                 frameStablePlaybackResetDelegate.RunTask();
@@ -621,7 +621,7 @@ namespace osu.Game.Screens.Play
             bool wasFrameStable = DrawableRuleset.FrameStablePlayback;
             DrawableRuleset.FrameStablePlayback = false;
 
-            Seek(time);
+            GameplayClockContainer.Reset(gameplayStartTime: time);
 
             // Delay resetting frame-stable playback for one frame to give the FrameStabilityContainer a chance to seek.
             frameStablePlaybackResetDelegate = ScheduleAfterChildren(() => DrawableRuleset.FrameStablePlayback = wasFrameStable);
@@ -981,7 +981,7 @@ namespace osu.Game.Screens.Play
             if (GameplayClockContainer.GameplayClock.IsRunning)
                 throw new InvalidOperationException($"{nameof(StartGameplay)} should not be called when the gameplay clock is already running");
 
-            GameplayClockContainer.Reset();
+            GameplayClockContainer.Reset(true);
         }
 
         public override void OnSuspending(IScreen next)
diff --git a/osu.Game/Screens/Play/SpectatorPlayer.cs b/osu.Game/Screens/Play/SpectatorPlayer.cs
index c415041081..c0682952c3 100644
--- a/osu.Game/Screens/Play/SpectatorPlayer.cs
+++ b/osu.Game/Screens/Play/SpectatorPlayer.cs
@@ -78,7 +78,7 @@ namespace osu.Game.Screens.Play
             }
 
             if (isFirstBundle && score.Replay.Frames.Count > 0)
-                NonFrameStableSeek(score.Replay.Frames[0].Time);
+                SetGameplayStartTime(score.Replay.Frames[0].Time);
         }
 
         protected override Score CreateScore(IBeatmap beatmap) => score;

From e3ab5de8cd944a35228d47bba2623fbd5ee712ba Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 17 Mar 2022 23:39:45 +0900
Subject: [PATCH 3500/5547] Tidy up constructor logic overlap with
 `gameplayStartTime`

---
 .../TestSceneMultiSpectatorScreen.cs          |  2 +-
 .../Screens/Play/GameplayClockContainer.cs    |  8 +--
 .../Play/MasterGameplayClockContainer.cs      | 69 ++++++++++---------
 3 files changed, 43 insertions(+), 36 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs
index e5e3fecd06..ed8b0bdd96 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs
@@ -473,7 +473,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             }
 
             protected override MasterGameplayClockContainer CreateMasterGameplayClockContainer(WorkingBeatmap beatmap)
-                => new MasterGameplayClockContainer(beatmap, gameplayStartTime ?? 0, gameplayStartTime.HasValue);
+                => new MasterGameplayClockContainer(beatmap, gameplayStartTime ?? 0);
         }
     }
 }
diff --git a/osu.Game/Screens/Play/GameplayClockContainer.cs b/osu.Game/Screens/Play/GameplayClockContainer.cs
index b60a3e306e..66f5cb0bd4 100644
--- a/osu.Game/Screens/Play/GameplayClockContainer.cs
+++ b/osu.Game/Screens/Play/GameplayClockContainer.cs
@@ -42,13 +42,13 @@ namespace osu.Game.Screens.Play
         public event Action OnSeek;
 
         /// <summary>
-        /// The time from which gameplay should start. Will be seeked to on calling <see cref="Reset"/>.
+        /// The time from which the clock should start. Will be seeked to on calling <see cref="Reset"/>.
         /// </summary>
         /// <remarks>
         /// If not set, a value of zero will be used.
         /// Importantly, the value will be inferred from the current ruleset in <see cref="MasterGameplayClockContainer"/> unless specified.
         /// </remarks>
-        protected double? GameplayStartTime { get; private set; }
+        protected double? StartTime { get; set; }
 
         /// <summary>
         /// Creates a new <see cref="GameplayClockContainer"/>.
@@ -120,10 +120,10 @@ namespace osu.Game.Screens.Play
         public void Reset(bool startClock = false, double? gameplayStartTime = null)
         {
             if (gameplayStartTime != null)
-                GameplayStartTime = gameplayStartTime;
+                StartTime = gameplayStartTime;
 
             ensureSourceClockSet();
-            Seek(GameplayStartTime ?? 0);
+            Seek(StartTime ?? 0);
 
             // Manually stop the source in order to not affect the IsPaused state.
             AdjustableSource.Stop();
diff --git a/osu.Game/Screens/Play/MasterGameplayClockContainer.cs b/osu.Game/Screens/Play/MasterGameplayClockContainer.cs
index ce7b6ef7f0..58e8b5f1ad 100644
--- a/osu.Game/Screens/Play/MasterGameplayClockContainer.cs
+++ b/osu.Game/Screens/Play/MasterGameplayClockContainer.cs
@@ -49,9 +49,6 @@ namespace osu.Game.Screens.Play
         private readonly BindableDouble pauseFreqAdjust = new BindableDouble(1);
 
         private readonly WorkingBeatmap beatmap;
-        private readonly double gameplayStartTime;
-        private readonly bool startAtGameplayStart;
-        private readonly double firstHitObjectTime;
 
         private HardwareCorrectionOffsetClock userGlobalOffsetClock;
         private HardwareCorrectionOffsetClock userBeatmapOffsetClock;
@@ -61,20 +58,29 @@ namespace osu.Game.Screens.Play
 
         private IDisposable beatmapOffsetSubscription;
 
+        private readonly double latestGameplayStartTime;
+
         [Resolved]
         private RealmAccess realm { get; set; }
 
         [Resolved]
         private OsuConfigManager config { get; set; }
 
-        public MasterGameplayClockContainer(WorkingBeatmap beatmap, double gameplayStartTime, bool startAtGameplayStart = false)
+        /// <summary>
+        /// Create a new master gameplay clock container.
+        /// </summary>
+        /// <param name="beatmap">The beatmap to be used for time and metadata references.</param>
+        /// <param name="latestGameplayStartTime">The latest time which should be used when introducing gameplay. Will be used when skipping forward.</param>
+        /// <param name="startFromLatestStartTime">Whether to start from the provided latest start time rather than zero.</param>
+        public MasterGameplayClockContainer(WorkingBeatmap beatmap, double latestGameplayStartTime, bool startFromLatestStartTime = false)
             : base(beatmap.Track)
         {
             this.beatmap = beatmap;
-            this.gameplayStartTime = gameplayStartTime;
-            this.startAtGameplayStart = startAtGameplayStart;
 
-            firstHitObjectTime = beatmap.Beatmap.HitObjects.First().StartTime;
+            this.latestGameplayStartTime = latestGameplayStartTime;
+
+            if (startFromLatestStartTime)
+                StartTime = latestGameplayStartTime;
         }
 
         protected override void LoadComplete()
@@ -89,33 +95,34 @@ namespace osu.Game.Screens.Play
                 settings => settings.Offset,
                 val => userBeatmapOffsetClock.Offset = val);
 
-            if (GameplayStartTime == null)
-            {
-                // sane default provided by ruleset.
-                double offset = gameplayStartTime;
+            // Reset may have been called externally before LoadComplete.
+            // If it was, and the clock is in a playing state, we want to ensure that it isn't stopped here.
+            bool isStarted = !IsPaused.Value;
 
-                if (!startAtGameplayStart)
-                {
-                    offset = Math.Min(0, offset);
+            // If a custom start time was not specified, calculate the best value to use.
+            double gameplayStartTime = StartTime ?? findBeatmapStartTime();
 
-                    // if a storyboard is present, it may dictate the appropriate start time by having events in negative time space.
-                    // this is commonly used to display an intro before the audio track start.
-                    double? firstStoryboardEvent = beatmap.Storyboard.EarliestEventTime;
-                    if (firstStoryboardEvent != null)
-                        offset = Math.Min(offset, firstStoryboardEvent.Value);
+            Reset(startClock: isStarted, gameplayStartTime: gameplayStartTime);
+        }
 
-                    // some beatmaps specify a current lead-in time which should be used instead of the ruleset-provided value when available.
-                    // this is not available as an option in the live editor but can still be applied via .osu editing.
-                    if (beatmap.BeatmapInfo.AudioLeadIn > 0)
-                        offset = Math.Min(offset, firstHitObjectTime - beatmap.BeatmapInfo.AudioLeadIn);
-                }
+        private double findBeatmapStartTime()
+        {
+            // start with the originally provided latest time as a sane default.
+            double time = latestGameplayStartTime;
 
-                // Reset may have been called externally before LoadComplete.
-                // If it was and the clock is in a playing state, we want to ensure that it isn't stopped here.
-                bool isStarted = !IsPaused.Value;
+            // if a storyboard is present, it may dictate the appropriate start time by having events in negative time space.
+            // this is commonly used to display an intro before the audio track start.
+            double? firstStoryboardEvent = beatmap.Storyboard.EarliestEventTime;
+            if (firstStoryboardEvent != null)
+                time = Math.Min(time, firstStoryboardEvent.Value);
 
-                Reset(startClock: isStarted, gameplayStartTime: offset);
-            }
+            // some beatmaps specify a current lead-in time which should be used instead of the ruleset-provided value when available.
+            // this is not available as an option in the live editor but can still be applied via .osu editing.
+            double firstHitObjectTime = beatmap.Beatmap.HitObjects.First().StartTime;
+            if (beatmap.BeatmapInfo.AudioLeadIn > 0)
+                time = Math.Min(time, firstHitObjectTime - beatmap.BeatmapInfo.AudioLeadIn);
+
+            return time;
         }
 
         protected override void OnIsPausedChanged(ValueChangedEvent<bool> isPaused)
@@ -158,10 +165,10 @@ namespace osu.Game.Screens.Play
         /// </summary>
         public void Skip()
         {
-            if (GameplayClock.CurrentTime > gameplayStartTime - MINIMUM_SKIP_TIME)
+            if (GameplayClock.CurrentTime > latestGameplayStartTime - MINIMUM_SKIP_TIME)
                 return;
 
-            double skipTarget = gameplayStartTime - MINIMUM_SKIP_TIME;
+            double skipTarget = latestGameplayStartTime - MINIMUM_SKIP_TIME;
 
             if (GameplayClock.CurrentTime < 0 && skipTarget > 6000)
                 // double skip exception for storyboards with very long intros

From c6be26eb018a4f26701f0b2bcbe58c742fa4a2e1 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 18 Mar 2022 01:15:17 +0900
Subject: [PATCH 3501/5547] Rename start time calculation method and add more
 commenting to explain purpose better

---
 osu.Game/Screens/Play/MasterGameplayClockContainer.cs | 11 +++++++----
 1 file changed, 7 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Screens/Play/MasterGameplayClockContainer.cs b/osu.Game/Screens/Play/MasterGameplayClockContainer.cs
index 58e8b5f1ad..529503e020 100644
--- a/osu.Game/Screens/Play/MasterGameplayClockContainer.cs
+++ b/osu.Game/Screens/Play/MasterGameplayClockContainer.cs
@@ -100,15 +100,18 @@ namespace osu.Game.Screens.Play
             bool isStarted = !IsPaused.Value;
 
             // If a custom start time was not specified, calculate the best value to use.
-            double gameplayStartTime = StartTime ?? findBeatmapStartTime();
+            double gameplayStartTime = StartTime ?? findEarliestStartTime();
 
             Reset(startClock: isStarted, gameplayStartTime: gameplayStartTime);
         }
 
-        private double findBeatmapStartTime()
+        private double findEarliestStartTime()
         {
-            // start with the originally provided latest time as a sane default.
-            double time = latestGameplayStartTime;
+            // here we are trying to find the time to start playback from the "zero" point.
+            // generally this is either zero, or some point earlier than zero in the case of storyboards, lead-ins etc.
+
+            // start with the originally provided latest time (if before zero).
+            double time = Math.Min(0, latestGameplayStartTime);
 
             // if a storyboard is present, it may dictate the appropriate start time by having events in negative time space.
             // this is commonly used to display an intro before the audio track start.

From a8bb696e5b28e5f87c663f7315c9c819608e7ab0 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 17 Mar 2022 21:22:07 +0100
Subject: [PATCH 3502/5547] Cache gameplay clock in more places to fix song
 progress related tests

---
 osu.Game.Tests/Visual/Gameplay/TestSceneHUDOverlay.cs         | 4 ++++
 .../Visual/Gameplay/TestSceneSkinEditorMultipleSkins.cs       | 4 ++++
 .../Visual/Gameplay/TestSceneSkinnableHUDOverlay.cs           | 4 ++++
 3 files changed, 12 insertions(+)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneHUDOverlay.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneHUDOverlay.cs
index d6a4d9bf79..2d12645811 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneHUDOverlay.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneHUDOverlay.cs
@@ -8,6 +8,7 @@ using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Testing;
+using osu.Framework.Timing;
 using osu.Game.Configuration;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Osu;
@@ -34,6 +35,9 @@ namespace osu.Game.Tests.Visual.Gameplay
         [Cached]
         private GameplayState gameplayState = new GameplayState(new TestBeatmap(new OsuRuleset().RulesetInfo), new OsuRuleset());
 
+        [Cached]
+        private readonly GameplayClock gameplayClock = new GameplayClock(new FramedClock());
+
         // best way to check without exposing.
         private Drawable hideTarget => hudOverlay.KeyCounter;
         private FillFlowContainer<KeyCounter> keyCounterFlow => hudOverlay.KeyCounter.ChildrenOfType<FillFlowContainer<KeyCounter>>().First();
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSkinEditorMultipleSkins.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSkinEditorMultipleSkins.cs
index 5dc4bdb041..8150252d45 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSkinEditorMultipleSkins.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSkinEditorMultipleSkins.cs
@@ -5,6 +5,7 @@ using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Testing;
+using osu.Framework.Timing;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Scoring;
@@ -26,6 +27,9 @@ namespace osu.Game.Tests.Visual.Gameplay
         [Cached]
         private GameplayState gameplayState = new GameplayState(new TestBeatmap(new OsuRuleset().RulesetInfo), new OsuRuleset());
 
+        [Cached]
+        private readonly GameplayClock gameplayClock = new GameplayClock(new FramedClock());
+
         [SetUpSteps]
         public void SetUpSteps()
         {
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableHUDOverlay.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableHUDOverlay.cs
index da443a6c92..ac5e408d90 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableHUDOverlay.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableHUDOverlay.cs
@@ -10,6 +10,7 @@ using osu.Framework.Extensions.IEnumerableExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Testing;
+using osu.Framework.Timing;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Osu;
@@ -33,6 +34,9 @@ namespace osu.Game.Tests.Visual.Gameplay
         [Cached]
         private GameplayState gameplayState = new GameplayState(new TestBeatmap(new OsuRuleset().RulesetInfo), new OsuRuleset());
 
+        [Cached]
+        private readonly GameplayClock gameplayClock = new GameplayClock(new FramedClock());
+
         private IEnumerable<HUDOverlay> hudOverlays => CreatedDrawables.OfType<HUDOverlay>();
 
         // best way to check without exposing.

From d90f21e140bea785d07fd33c8ef1af126c16a16b Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 18 Mar 2022 00:13:40 +0300
Subject: [PATCH 3503/5547] Reword mod documentation
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/Mods/IMod.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Rulesets/Mods/IMod.cs b/osu.Game/Rulesets/Mods/IMod.cs
index cda59bae55..5f4fecb649 100644
--- a/osu.Game/Rulesets/Mods/IMod.cs
+++ b/osu.Game/Rulesets/Mods/IMod.cs
@@ -41,13 +41,13 @@ namespace osu.Game.Rulesets.Mods
 
         /// <summary>
         /// Whether this mod is playable in a multiplayer match.
-        /// Should be <c>false</c> for mods that affect the gameplay progress based on user input (e.g. <see cref="ModAdaptiveSpeed"/>).
+        /// Should be <c>false</c> for mods that make gameplay duration dependent on user input (e.g. <see cref="ModAdaptiveSpeed"/>).
         /// </summary>
         bool PlayableInMultiplayer { get; }
 
         /// <summary>
         /// Whether this mod is valid to be a "free mod" in a multiplayer match.
-        /// Should be <c>false</c> for mods that affect the gameplay progress (e.g. <see cref="ModRateAdjust"/> and <see cref="ModTimeRamp"/>).
+        /// Should be <c>false</c> for mods that affect the gameplay duration (e.g. <see cref="ModRateAdjust"/> and <see cref="ModTimeRamp"/>).
         /// </summary>
         bool ValidFreeModInMultiplayer { get; }
 

From b0d04a78f7d2e4b7fadaee32841dca3387c44f34 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 18 Mar 2022 00:21:16 +0300
Subject: [PATCH 3504/5547] Reword mod utility documentation regarding
 nullability

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

diff --git a/osu.Game/Utils/ModUtils.cs b/osu.Game/Utils/ModUtils.cs
index d169ace80a..81b78c18ac 100644
--- a/osu.Game/Utils/ModUtils.cs
+++ b/osu.Game/Utils/ModUtils.cs
@@ -109,7 +109,7 @@ namespace osu.Game.Utils
         /// Check the provided combination of mods are valid for a local gameplay session.
         /// </summary>
         /// <param name="mods">The mods to check.</param>
-        /// <param name="invalidMods">Invalid mods, if any were found. Can be null if all mods were valid.</param>
+        /// <param name="invalidMods">Invalid mods, if any were found. Will be null if all mods were valid.</param>
         /// <returns>Whether the input mods were all valid. If false, <paramref name="invalidMods"/> will contain all invalid entries.</returns>
         public static bool CheckValidForGameplay(IEnumerable<Mod> mods, [NotNullWhen(false)] out List<Mod>? invalidMods)
             => checkValid(mods, m => m.Type != ModType.System && m.HasImplementation && !(m is MultiMod), out invalidMods);
@@ -118,7 +118,7 @@ namespace osu.Game.Utils
         /// Check the provided combination of mods are valid for a multiplayer match session.
         /// </summary>
         /// <param name="mods">The mods to check.</param>
-        /// <param name="invalidMods">Invalid mods, if any were found. Can be null if all mods were valid.</param>
+        /// <param name="invalidMods">Invalid mods, if any were found. Will be null if all mods were valid.</param>
         /// <returns>Whether the input mods were all valid. If false, <paramref name="invalidMods"/> will contain all invalid entries.</returns>
         public static bool CheckValidForMultiplayer(IEnumerable<Mod> mods, [NotNullWhen(false)] out List<Mod>? invalidMods)
             => checkValid(mods, m => m.PlayableInMultiplayer, out invalidMods);
@@ -127,7 +127,7 @@ namespace osu.Game.Utils
         /// Check the provided combination of mods are valid as "free mods" in a multiplayer match session.
         /// </summary>
         /// <param name="mods">The mods to check.</param>
-        /// <param name="invalidMods">Invalid mods, if any were found. Can be null if all mods were valid.</param>
+        /// <param name="invalidMods">Invalid mods, if any were found. Will be null if all mods were valid.</param>
         /// <returns>Whether the input mods were all valid. If false, <paramref name="invalidMods"/> will contain all invalid entries.</returns>
         public static bool CheckValidFreeModsForMultiplayer(IEnumerable<Mod> mods, [NotNullWhen(false)] out List<Mod>? invalidMods)
             => checkValid(mods, m => m.ValidFreeModInMultiplayer, out invalidMods);

From 51e5dd7d0e58fb681db6da9e34e9d435e1026a58 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 18 Mar 2022 02:08:11 +0300
Subject: [PATCH 3505/5547] Introduce `IsPlayable(...)` and obsolete
 `UserPlayable`

---
 .../BeatmapSet/LeaderboardModSelector.cs      |  2 +-
 osu.Game/Rulesets/Mods/IMod.cs                | 26 ++++++++++---------
 osu.Game/Rulesets/Mods/Mod.cs                 | 11 +++-----
 osu.Game/Rulesets/Mods/ModUsage.cs            | 26 +++++++++++++++++++
 4 files changed, 45 insertions(+), 20 deletions(-)
 create mode 100644 osu.Game/Rulesets/Mods/ModUsage.cs

diff --git a/osu.Game/Overlays/BeatmapSet/LeaderboardModSelector.cs b/osu.Game/Overlays/BeatmapSet/LeaderboardModSelector.cs
index 25aed4c980..97b89c6f74 100644
--- a/osu.Game/Overlays/BeatmapSet/LeaderboardModSelector.cs
+++ b/osu.Game/Overlays/BeatmapSet/LeaderboardModSelector.cs
@@ -63,7 +63,7 @@ namespace osu.Game.Overlays.BeatmapSet
                 return;
 
             modsContainer.Add(new ModButton(new ModNoMod()));
-            modsContainer.AddRange(rulesetInstance.AllMods.Where(m => m.UserPlayable).Select(m => new ModButton(m)));
+            modsContainer.AddRange(rulesetInstance.AllMods.Where(m => m.IsPlayable(ModUsage.Solo)).Select(m => new ModButton(m)));
 
             modsContainer.ForEach(button =>
             {
diff --git a/osu.Game/Rulesets/Mods/IMod.cs b/osu.Game/Rulesets/Mods/IMod.cs
index 5f4fecb649..bdfb273b13 100644
--- a/osu.Game/Rulesets/Mods/IMod.cs
+++ b/osu.Game/Rulesets/Mods/IMod.cs
@@ -33,24 +33,26 @@ namespace osu.Game.Rulesets.Mods
         /// </summary>
         IconUsage? Icon { get; }
 
+        /// <summary>
+        /// Whether this mod is playable for the given usage.
+        /// </summary>
+        /// <remarks>
+        /// <list type="bullet">
+        /// <item>Should be always <c>false</c> for cases where the user is not interacting with the game.</item>
+        /// <item>Should be <c>false</c> in <see cref="ModUsage.MultiplayerRequired"/> for mods that make gameplay duration dependent on user input (e.g. <see cref="ModAdaptiveSpeed"/>).</item>
+        /// <item>Should be <c>false</c> in <see cref="ModUsage.MultiplayerFree"/> for mods that affect the gameplay duration (e.g. <see cref="ModRateAdjust"/> and <see cref="ModTimeRamp"/>).</item>
+        /// </list>
+        /// </remarks>
+        /// <param name="usage">The mod usage.</param>
+        bool IsPlayable(ModUsage usage);
+
         /// <summary>
         /// Whether this mod is playable by an end user.
         /// Should be <c>false</c> for cases where the user is not interacting with the game (so it can be excluded from multiplayer selection, for example).
         /// </summary>
+        [Obsolete("Override IsPlayable instead.")] // Can be removed 20220918
         bool UserPlayable { get; }
 
-        /// <summary>
-        /// Whether this mod is playable in a multiplayer match.
-        /// Should be <c>false</c> for mods that make gameplay duration dependent on user input (e.g. <see cref="ModAdaptiveSpeed"/>).
-        /// </summary>
-        bool PlayableInMultiplayer { get; }
-
-        /// <summary>
-        /// Whether this mod is valid to be a "free mod" in a multiplayer match.
-        /// Should be <c>false</c> for mods that affect the gameplay duration (e.g. <see cref="ModRateAdjust"/> and <see cref="ModTimeRamp"/>).
-        /// </summary>
-        bool ValidFreeModInMultiplayer { get; }
-
         /// <summary>
         /// Create a fresh <see cref="Mod"/> instance based on this mod.
         /// </summary>
diff --git a/osu.Game/Rulesets/Mods/Mod.cs b/osu.Game/Rulesets/Mods/Mod.cs
index a6562b4f4c..00aef1a598 100644
--- a/osu.Game/Rulesets/Mods/Mod.cs
+++ b/osu.Game/Rulesets/Mods/Mod.cs
@@ -91,16 +91,13 @@ namespace osu.Game.Rulesets.Mods
         [JsonIgnore]
         public virtual bool HasImplementation => this is IApplicableMod;
 
+        public virtual bool IsPlayable(ModUsage usage) => true;
+
         [JsonIgnore]
+        [Obsolete("Override IsPlayable instead.")] // Can be removed 20220918
         public virtual bool UserPlayable => true;
 
-        [JsonIgnore]
-        public virtual bool PlayableInMultiplayer => UserPlayable;
-
-        [JsonIgnore]
-        public virtual bool ValidFreeModInMultiplayer => PlayableInMultiplayer;
-
-        [Obsolete("Going forward, the concept of \"ranked\" doesn't exist. The only exceptions are automation mods, which should now override and set UserPlayable to false.")] // Can be removed 20211009
+        [Obsolete("Going forward, the concept of \"ranked\" doesn't exist. The only exceptions are automation mods, which should now override IsPlayable to false.")] // Can be removed 20211009
         public virtual bool Ranked => false;
 
         /// <summary>
diff --git a/osu.Game/Rulesets/Mods/ModUsage.cs b/osu.Game/Rulesets/Mods/ModUsage.cs
new file mode 100644
index 0000000000..82ff6bc418
--- /dev/null
+++ b/osu.Game/Rulesets/Mods/ModUsage.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.
+
+namespace osu.Game.Rulesets.Mods
+{
+    /// <summary>
+    /// The usage of this mod to determine its playability.
+    /// </summary>
+    public enum ModUsage
+    {
+        /// <summary>
+        /// In a solo gameplay session.
+        /// </summary>
+        Solo,
+
+        /// <summary>
+        /// In a multiplayer match, as a required mod.
+        /// </summary>
+        MultiplayerRequired,
+
+        /// <summary>
+        /// In a multiplayer match, as a "free" mod.
+        /// </summary>
+        MultiplayerFree,
+    }
+}

From f2248ecc08000c1c259e306ad8d599b0a1c48c8c Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 18 Mar 2022 02:11:18 +0300
Subject: [PATCH 3506/5547] Update usages to use `IsPlayable` instead

---
 osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs                | 2 +-
 osu.Game/Rulesets/Mods/ModAutoplay.cs                     | 2 +-
 osu.Game/Rulesets/Mods/ModRateAdjust.cs                   | 2 +-
 osu.Game/Rulesets/Mods/ModTimeRamp.cs                     | 2 +-
 osu.Game/Rulesets/Mods/UnknownMod.cs                      | 2 +-
 osu.Game/Screens/OnlinePlay/FreeModSelectOverlay.cs       | 2 +-
 .../OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs  | 4 ++--
 osu.Game/Screens/OnlinePlay/OnlinePlaySongSelect.cs       | 2 +-
 .../Screens/Play/PlayerSettings/BeatmapOffsetControl.cs   | 3 ++-
 osu.Game/Screens/Play/SubmittingPlayer.cs                 | 3 ++-
 osu.Game/Screens/Ranking/ResultsScreen.cs                 | 3 ++-
 osu.Game/Utils/ModUtils.cs                                | 8 ++++----
 12 files changed, 19 insertions(+), 16 deletions(-)

diff --git a/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs b/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs
index 54a4c054c9..17ef9f926e 100644
--- a/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs
+++ b/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs
@@ -31,7 +31,7 @@ namespace osu.Game.Rulesets.Mods
 
         public override double ScoreMultiplier => 1;
 
-        public override bool PlayableInMultiplayer => false;
+        public override bool IsPlayable(ModUsage usage) => usage == ModUsage.Solo;
 
         public override Type[] IncompatibleMods => new[] { typeof(ModRateAdjust), typeof(ModTimeRamp) };
 
diff --git a/osu.Game/Rulesets/Mods/ModAutoplay.cs b/osu.Game/Rulesets/Mods/ModAutoplay.cs
index 60b9c29fe0..5491cbec07 100644
--- a/osu.Game/Rulesets/Mods/ModAutoplay.cs
+++ b/osu.Game/Rulesets/Mods/ModAutoplay.cs
@@ -24,7 +24,7 @@ namespace osu.Game.Rulesets.Mods
 
         public bool RestartOnFail => false;
 
-        public override bool UserPlayable => false;
+        public override bool IsPlayable(ModUsage usage) => false;
 
         public override Type[] IncompatibleMods => new[] { typeof(ModRelax), typeof(ModFailCondition), typeof(ModNoFail) };
 
diff --git a/osu.Game/Rulesets/Mods/ModRateAdjust.cs b/osu.Game/Rulesets/Mods/ModRateAdjust.cs
index 3a11c3034b..810b93c4dd 100644
--- a/osu.Game/Rulesets/Mods/ModRateAdjust.cs
+++ b/osu.Game/Rulesets/Mods/ModRateAdjust.cs
@@ -11,7 +11,7 @@ namespace osu.Game.Rulesets.Mods
 {
     public abstract class ModRateAdjust : Mod, IApplicableToRate
     {
-        public override bool ValidFreeModInMultiplayer => false;
+        public override bool IsPlayable(ModUsage usage) => usage != ModUsage.MultiplayerFree;
 
         public abstract BindableNumber<double> SpeedChange { get; }
 
diff --git a/osu.Game/Rulesets/Mods/ModTimeRamp.cs b/osu.Game/Rulesets/Mods/ModTimeRamp.cs
index 59aac62686..fa6a9f3e5b 100644
--- a/osu.Game/Rulesets/Mods/ModTimeRamp.cs
+++ b/osu.Game/Rulesets/Mods/ModTimeRamp.cs
@@ -30,7 +30,7 @@ namespace osu.Game.Rulesets.Mods
         [SettingSource("Adjust pitch", "Should pitch be adjusted with speed")]
         public abstract BindableBool AdjustPitch { get; }
 
-        public override bool ValidFreeModInMultiplayer => false;
+        public override bool IsPlayable(ModUsage usage) => usage != ModUsage.MultiplayerFree;
 
         public override Type[] IncompatibleMods => new[] { typeof(ModRateAdjust), typeof(ModAdaptiveSpeed) };
 
diff --git a/osu.Game/Rulesets/Mods/UnknownMod.cs b/osu.Game/Rulesets/Mods/UnknownMod.cs
index b426386d7a..75d86e67bc 100644
--- a/osu.Game/Rulesets/Mods/UnknownMod.cs
+++ b/osu.Game/Rulesets/Mods/UnknownMod.cs
@@ -15,7 +15,7 @@ namespace osu.Game.Rulesets.Mods
         public override string Description => "This mod could not be resolved by the game.";
         public override double ScoreMultiplier => 0;
 
-        public override bool UserPlayable => false;
+        public override bool IsPlayable(ModUsage usage) => false;
 
         public override ModType Type => ModType.System;
 
diff --git a/osu.Game/Screens/OnlinePlay/FreeModSelectOverlay.cs b/osu.Game/Screens/OnlinePlay/FreeModSelectOverlay.cs
index d5abaaab4e..974e2b9305 100644
--- a/osu.Game/Screens/OnlinePlay/FreeModSelectOverlay.cs
+++ b/osu.Game/Screens/OnlinePlay/FreeModSelectOverlay.cs
@@ -25,7 +25,7 @@ namespace osu.Game.Screens.OnlinePlay
         public new Func<Mod, bool> IsValidMod
         {
             get => base.IsValidMod;
-            set => base.IsValidMod = m => m.HasImplementation && m.UserPlayable && value(m);
+            set => base.IsValidMod = m => m.HasImplementation && m.IsPlayable(ModUsage.Solo) && value(m);
         }
 
         public FreeModSelectOverlay()
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs
index e4f1d9587d..4c1350a56b 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs
@@ -117,8 +117,8 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
 
         protected override BeatmapDetailArea CreateBeatmapDetailArea() => new PlayBeatmapDetailArea();
 
-        protected override bool IsValidMod(Mod mod) => base.IsValidMod(mod) && mod.PlayableInMultiplayer;
+        protected override bool IsValidMod(Mod mod) => base.IsValidMod(mod) && mod.IsPlayable(ModUsage.MultiplayerRequired);
 
-        protected override bool IsValidFreeMod(Mod mod) => base.IsValidFreeMod(mod) && mod.ValidFreeModInMultiplayer;
+        protected override bool IsValidFreeMod(Mod mod) => base.IsValidFreeMod(mod) && mod.IsPlayable(ModUsage.MultiplayerFree);
     }
 }
diff --git a/osu.Game/Screens/OnlinePlay/OnlinePlaySongSelect.cs b/osu.Game/Screens/OnlinePlay/OnlinePlaySongSelect.cs
index 7b64784316..75e5ea60a4 100644
--- a/osu.Game/Screens/OnlinePlay/OnlinePlaySongSelect.cs
+++ b/osu.Game/Screens/OnlinePlay/OnlinePlaySongSelect.cs
@@ -170,7 +170,7 @@ namespace osu.Game.Screens.OnlinePlay
         /// </summary>
         /// <param name="mod">The <see cref="Mod"/> to check.</param>
         /// <returns>Whether <paramref name="mod"/> is a valid mod for online play.</returns>
-        protected virtual bool IsValidMod(Mod mod) => mod.HasImplementation && ModUtils.FlattenMod(mod).All(m => m.UserPlayable);
+        protected virtual bool IsValidMod(Mod mod) => mod.HasImplementation && ModUtils.FlattenMod(mod).All(m => m.IsPlayable(ModUsage.Solo));
 
         /// <summary>
         /// Checks whether a given <see cref="Mod"/> is valid for per-player free-mod selection.
diff --git a/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs b/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
index 42091c521f..27aa4fe1f1 100644
--- a/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
+++ b/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
@@ -20,6 +20,7 @@ using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Localisation;
 using osu.Game.Overlays.Settings;
+using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Scoring;
 using osu.Game.Scoring;
 using osu.Game.Screens.Ranking.Statistics;
@@ -187,7 +188,7 @@ namespace osu.Game.Screens.Play.PlayerSettings
             if (score.NewValue == null)
                 return;
 
-            if (score.NewValue.Mods.Any(m => !m.UserPlayable))
+            if (score.NewValue.Mods.Any(m => !m.IsPlayable(ModUsage.Solo)))
                 return;
 
             var hitEvents = score.NewValue.HitEvents;
diff --git a/osu.Game/Screens/Play/SubmittingPlayer.cs b/osu.Game/Screens/Play/SubmittingPlayer.cs
index b1f2bccddf..5de8aa1dc1 100644
--- a/osu.Game/Screens/Play/SubmittingPlayer.cs
+++ b/osu.Game/Screens/Play/SubmittingPlayer.cs
@@ -11,6 +11,7 @@ using osu.Framework.Logging;
 using osu.Framework.Screens;
 using osu.Game.Online.API;
 using osu.Game.Online.Rooms;
+using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Scoring;
 using osu.Game.Scoring;
 
@@ -47,7 +48,7 @@ namespace osu.Game.Screens.Play
             // Token request construction should happen post-load to allow derived classes to potentially prepare DI backings that are used to create the request.
             var tcs = new TaskCompletionSource<bool>();
 
-            if (Mods.Value.Any(m => !m.UserPlayable))
+            if (Mods.Value.Any(m => !m.IsPlayable(ModUsage.Solo)))
             {
                 handleTokenFailure(new InvalidOperationException("Non-user playable mod selected."));
                 return false;
diff --git a/osu.Game/Screens/Ranking/ResultsScreen.cs b/osu.Game/Screens/Ranking/ResultsScreen.cs
index cb842ce4a0..09b6cc0f23 100644
--- a/osu.Game/Screens/Ranking/ResultsScreen.cs
+++ b/osu.Game/Screens/Ranking/ResultsScreen.cs
@@ -18,6 +18,7 @@ using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Input.Bindings;
 using osu.Game.Online.API;
+using osu.Game.Rulesets.Mods;
 using osu.Game.Scoring;
 using osu.Game.Screens.Play;
 using osu.Game.Screens.Ranking.Statistics;
@@ -145,7 +146,7 @@ namespace osu.Game.Screens.Ranking
             if (Score != null)
             {
                 // only show flair / animation when arriving after watching a play that isn't autoplay.
-                bool shouldFlair = player != null && Score.Mods.All(m => m.UserPlayable);
+                bool shouldFlair = player != null && Score.Mods.All(m => m.IsPlayable(ModUsage.Solo));
 
                 ScorePanelList.AddScore(Score, shouldFlair);
             }
diff --git a/osu.Game/Utils/ModUtils.cs b/osu.Game/Utils/ModUtils.cs
index 81b78c18ac..4915f5bdc6 100644
--- a/osu.Game/Utils/ModUtils.cs
+++ b/osu.Game/Utils/ModUtils.cs
@@ -115,13 +115,13 @@ namespace osu.Game.Utils
             => checkValid(mods, m => m.Type != ModType.System && m.HasImplementation && !(m is MultiMod), out invalidMods);
 
         /// <summary>
-        /// Check the provided combination of mods are valid for a multiplayer match session.
+        /// Check the provided combination of mods are valid as "required mods" in a multiplayer match session.
         /// </summary>
         /// <param name="mods">The mods to check.</param>
         /// <param name="invalidMods">Invalid mods, if any were found. Will be null if all mods were valid.</param>
         /// <returns>Whether the input mods were all valid. If false, <paramref name="invalidMods"/> will contain all invalid entries.</returns>
-        public static bool CheckValidForMultiplayer(IEnumerable<Mod> mods, [NotNullWhen(false)] out List<Mod>? invalidMods)
-            => checkValid(mods, m => m.PlayableInMultiplayer, out invalidMods);
+        public static bool CheckValidRequiredModsForMultiplayer(IEnumerable<Mod> mods, [NotNullWhen(false)] out List<Mod>? invalidMods)
+            => checkValid(mods, m => m.IsPlayable(ModUsage.MultiplayerRequired), out invalidMods);
 
         /// <summary>
         /// Check the provided combination of mods are valid as "free mods" in a multiplayer match session.
@@ -130,7 +130,7 @@ namespace osu.Game.Utils
         /// <param name="invalidMods">Invalid mods, if any were found. Will be null if all mods were valid.</param>
         /// <returns>Whether the input mods were all valid. If false, <paramref name="invalidMods"/> will contain all invalid entries.</returns>
         public static bool CheckValidFreeModsForMultiplayer(IEnumerable<Mod> mods, [NotNullWhen(false)] out List<Mod>? invalidMods)
-            => checkValid(mods, m => m.ValidFreeModInMultiplayer, out invalidMods);
+            => checkValid(mods, m => m.IsPlayable(ModUsage.MultiplayerFree), out invalidMods);
 
         private static bool checkValid(IEnumerable<Mod> mods, Predicate<Mod> valid, [NotNullWhen(false)] out List<Mod>? invalidMods)
         {

From 4adb8c205f7523768f741c2b6d80f0aaa04fdf8a Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 18 Mar 2022 07:18:49 +0300
Subject: [PATCH 3507/5547] Add step to switch hosts randomly in
 `TestManyUsers`

---
 .../Multiplayer/TestSceneMultiplayerParticipantsList.cs     | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerParticipantsList.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerParticipantsList.cs
index 292319171d..bc3bce4b3f 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerParticipantsList.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerParticipantsList.cs
@@ -202,9 +202,11 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [Test]
         public void TestManyUsers()
         {
+            const int users_count = 20;
+
             AddStep("add many users", () =>
             {
-                for (int i = 0; i < 20; i++)
+                for (int i = 0; i < users_count; i++)
                 {
                     MultiplayerClient.AddUser(new APIUser
                     {
@@ -243,6 +245,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     }
                 }
             });
+
+            AddRepeatStep("switch hosts", () => MultiplayerClient.TransferHost(RNG.Next(0, users_count)), 10);
         }
 
         [Test]

From 1c899d00b92cdea921fcad9ea15cf33fbc839064 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 18 Mar 2022 07:25:03 +0300
Subject: [PATCH 3508/5547] Pin multiplayer host panel to the top of the list

---
 .../Multiplayer/Participants/ParticipantsList.cs   | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantsList.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantsList.cs
index afb2111023..6169ad6a9e 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantsList.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantsList.cs
@@ -2,6 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System.Linq;
+using JetBrains.Annotations;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
@@ -15,6 +16,9 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Participants
     {
         private FillFlowContainer<ParticipantPanel> panels;
 
+        [CanBeNull]
+        private ParticipantPanel currentHostPanel;
+
         [BackgroundDependencyLoader]
         private void load()
         {
@@ -55,6 +59,16 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Participants
                 // Add panels for all users new to the room.
                 foreach (var user in Room.Users.Except(panels.Select(p => p.User)))
                     panels.Add(new ParticipantPanel(user));
+
+                if (currentHostPanel == null || !currentHostPanel.User.Equals(Room.Host))
+                {
+                    // Reset position of previous host back to normal, if one existing.
+                    if (currentHostPanel != null && panels.Contains(currentHostPanel))
+                        panels.SetLayoutPosition(currentHostPanel, 0);
+
+                    // Change position of new host to display above all participants.
+                    panels.SetLayoutPosition(currentHostPanel = panels.Single(u => u.User.Equals(Room.Host)), -1);
+                }
             }
         }
     }

From 98b420ee6f2b256aa6e70847751fe311739b2572 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 18 Mar 2022 07:25:10 +0300
Subject: [PATCH 3509/5547] Remove no longer correct crown fade animation

Since the host is pinned to the top without any animation, it would look
jarring for the crown to fade away from the old panel (and at a 50ms
duration).
---
 .../OnlinePlay/Multiplayer/Participants/ParticipantPanel.cs  | 5 +----
 1 file changed, 1 insertion(+), 4 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantPanel.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantPanel.cs
index 96a665f33d..11dba2e52d 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantPanel.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantPanel.cs
@@ -206,10 +206,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Participants
             else
                 kickButton.FadeOut(fade_time);
 
-            if (Room.Host?.Equals(User) == true)
-                crown.FadeIn(fade_time);
-            else
-                crown.FadeOut(fade_time);
+            crown.Alpha = Room.Host?.Equals(User) == true ? 1 : 0;
 
             // If the mods are updated at the end of the frame, the flow container will skip a reflow cycle: https://github.com/ppy/osu-framework/issues/4187
             // This looks particularly jarring here, so re-schedule the update to that start of our frame as a fix.

From d0cc68bc97ade2891f3e1ee767588d0946b27507 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 18 Mar 2022 07:26:10 +0300
Subject: [PATCH 3510/5547] Add test coverage

---
 .../TestSceneMultiplayerParticipantsList.cs   | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerParticipantsList.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerParticipantsList.cs
index bc3bce4b3f..50faa0a567 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerParticipantsList.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerParticipantsList.cs
@@ -163,6 +163,25 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddUntilStep("second user crown visible", () => this.ChildrenOfType<ParticipantPanel>().ElementAt(1).ChildrenOfType<SpriteIcon>().First().Alpha == 1);
         }
 
+        [Test]
+        public void TestHostGetsPinnedToTop()
+        {
+            AddStep("add user", () => MultiplayerClient.AddUser(new APIUser
+            {
+                Id = 3,
+                Username = "Second",
+                CoverUrl = @"https://osu.ppy.sh/images/headers/profile-covers/c3.jpg",
+            }));
+
+            AddStep("make second user host", () => MultiplayerClient.TransferHost(3));
+            AddAssert("second user above first", () =>
+            {
+                var first = this.ChildrenOfType<ParticipantPanel>().ElementAt(0);
+                var second = this.ChildrenOfType<ParticipantPanel>().ElementAt(1);
+                return second.Y < first.Y;
+            });
+        }
+
         [Test]
         public void TestKickButtonOnlyPresentWhenHost()
         {

From d1fd14e287eb7ff00e36d87e3b76f53df2207912 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 18 Mar 2022 13:57:36 +0900
Subject: [PATCH 3511/5547] Add missing `nullable`

---
 osu.Game/Overlays/Chat/ChannelControl/ControlItemClose.cs | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/osu.Game/Overlays/Chat/ChannelControl/ControlItemClose.cs b/osu.Game/Overlays/Chat/ChannelControl/ControlItemClose.cs
index 4730d7b72d..c0f419f619 100644
--- a/osu.Game/Overlays/Chat/ChannelControl/ControlItemClose.cs
+++ b/osu.Game/Overlays/Chat/ChannelControl/ControlItemClose.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.
 
+#nullable enable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Sprites;

From 5d940ded09d91d1e1d217b173fa598ed5196985e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 18 Mar 2022 13:59:03 +0900
Subject: [PATCH 3512/5547] Fix incorrect usage of nullable in
 `ControlItemMention`

---
 osu.Game/Overlays/Chat/ChannelControl/ControlItemMention.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Overlays/Chat/ChannelControl/ControlItemMention.cs b/osu.Game/Overlays/Chat/ChannelControl/ControlItemMention.cs
index 34e1e33c87..f4d65e3cef 100644
--- a/osu.Game/Overlays/Chat/ChannelControl/ControlItemMention.cs
+++ b/osu.Game/Overlays/Chat/ChannelControl/ControlItemMention.cs
@@ -18,7 +18,7 @@ namespace osu.Game.Overlays.Chat.ChannelControl
     {
         public readonly BindableInt Mentions = new BindableInt();
 
-        private OsuSpriteText? countText;
+        private OsuSpriteText countText = null!;
 
         [BackgroundDependencyLoader]
         private void load(OsuColour osuColour, OverlayColourProvider colourProvider)
@@ -53,7 +53,7 @@ namespace osu.Game.Overlays.Chat.ChannelControl
             {
                 int mentionCount = change.NewValue;
 
-                countText!.Text = mentionCount > 99 ? "99+" : mentionCount.ToString();
+                countText.Text = mentionCount > 99 ? "99+" : mentionCount.ToString();
 
                 if (mentionCount > 0)
                     Show();

From dfda093f4b8a74726eb1a0dfda261c01de98e3db Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 18 Mar 2022 14:03:52 +0900
Subject: [PATCH 3513/5547] Rename icon creation method

---
 osu.Game/Overlays/Chat/ChannelControl/ControlItem.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Overlays/Chat/ChannelControl/ControlItem.cs b/osu.Game/Overlays/Chat/ChannelControl/ControlItem.cs
index c27d5fdf5d..bf4d60d4e2 100644
--- a/osu.Game/Overlays/Chat/ChannelControl/ControlItem.cs
+++ b/osu.Game/Overlays/Chat/ChannelControl/ControlItem.cs
@@ -76,7 +76,7 @@ namespace osu.Game.Overlays.Chat.ChannelControl
                         {
                             new[]
                             {
-                                createAvatar(),
+                                createIcon(),
                                 new ControlItemText(channel)
                                 {
                                     Anchor = Anchor.CentreLeft,
@@ -133,7 +133,7 @@ namespace osu.Game.Overlays.Chat.ChannelControl
             base.OnHoverLost(e);
         }
 
-        private Drawable createAvatar()
+        private Drawable createIcon()
         {
             if (channel.Type != ChannelType.PM)
                 return Drawable.Empty();

From a7ddfc7f519d2b3583814425071eccf1d4c8d5d2 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 18 Mar 2022 08:08:31 +0300
Subject: [PATCH 3514/5547] Add step for returning host back to local user

---
 .../Visual/Multiplayer/TestSceneMultiplayerParticipantsList.cs   | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerParticipantsList.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerParticipantsList.cs
index 50faa0a567..8da077cd44 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerParticipantsList.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerParticipantsList.cs
@@ -266,6 +266,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             });
 
             AddRepeatStep("switch hosts", () => MultiplayerClient.TransferHost(RNG.Next(0, users_count)), 10);
+            AddStep("give host back", () => MultiplayerClient.TransferHost(API.LocalUser.Value.Id));
         }
 
         [Test]

From 1bd08b4a4b02499a7aed551d338494d3dd0952f6 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 18 Mar 2022 08:08:45 +0300
Subject: [PATCH 3515/5547] Remove kick button fading as well to not look
 jarring

---
 .../OnlinePlay/Multiplayer/Participants/ParticipantPanel.cs | 6 +-----
 1 file changed, 1 insertion(+), 5 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantPanel.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantPanel.cs
index 11dba2e52d..e95ca4de32 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantPanel.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantPanel.cs
@@ -201,11 +201,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Participants
             else
                 userModsDisplay.FadeOut(fade_time);
 
-            if (Client.IsHost && !User.Equals(Client.LocalUser))
-                kickButton.FadeIn(fade_time);
-            else
-                kickButton.FadeOut(fade_time);
-
+            kickButton.Alpha = Client.IsHost && !User.Equals(Client.LocalUser) ? 1 : 0;
             crown.Alpha = Room.Host?.Equals(User) == true ? 1 : 0;
 
             // If the mods are updated at the end of the frame, the flow container will skip a reflow cycle: https://github.com/ppy/osu-framework/issues/4187

From b76a87e6f886401cdc34245e41b706f4a8d6595f Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 17 Mar 2022 18:58:09 +0900
Subject: [PATCH 3516/5547] Split ready button visual logic into button itself

---
 .../Visual/Multiplayer/QueueModeTestScene.cs  |   4 +-
 .../TestSceneAllPlayersQueueMode.cs           |   8 +-
 .../TestSceneMultiplayerMatchSubScreen.cs     |   2 +-
 .../TestSceneMultiplayerReadyButton.cs        |  16 +-
 .../Match/MultiplayerReadyButton.cs           | 172 ++++++++++++------
 5 files changed, 132 insertions(+), 70 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs b/osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs
index bafc579134..df8f63f6ed 100644
--- a/osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs
@@ -95,10 +95,10 @@ namespace osu.Game.Tests.Visual.Multiplayer
         protected void RunGameplay()
         {
             AddUntilStep("wait for idle", () => MultiplayerClient.LocalUser?.State == MultiplayerUserState.Idle);
-            ClickButtonWhenEnabled<MultiplayerReadyButton>();
+            ClickButtonWhenEnabled<MultiplayerReadyButton.ReadyButton>();
 
             AddUntilStep("wait for ready", () => MultiplayerClient.LocalUser?.State == MultiplayerUserState.Ready);
-            ClickButtonWhenEnabled<MultiplayerReadyButton>();
+            ClickButtonWhenEnabled<MultiplayerReadyButton.ReadyButton>();
 
             AddUntilStep("wait for player", () => multiplayerComponents.CurrentScreen is Player player && player.IsLoaded);
             AddStep("exit player", () => multiplayerComponents.MultiplayerScreen.MakeCurrent());
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneAllPlayersQueueMode.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneAllPlayersQueueMode.cs
index 0785315b26..266ac60168 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneAllPlayersQueueMode.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneAllPlayersQueueMode.cs
@@ -102,10 +102,10 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddUntilStep("selected beatmap is initial beatmap", () => Beatmap.Value.BeatmapInfo.OnlineID == InitialBeatmap.OnlineID);
 
             AddUntilStep("wait for idle", () => MultiplayerClient.LocalUser?.State == MultiplayerUserState.Idle);
-            ClickButtonWhenEnabled<MultiplayerReadyButton>();
+            ClickButtonWhenEnabled<MultiplayerReadyButton.ReadyButton>();
 
             AddUntilStep("wait for ready", () => MultiplayerClient.LocalUser?.State == MultiplayerUserState.Ready);
-            ClickButtonWhenEnabled<MultiplayerReadyButton>();
+            ClickButtonWhenEnabled<MultiplayerReadyButton.ReadyButton>();
 
             AddUntilStep("wait for player", () => CurrentScreen is Player player && player.IsLoaded);
             AddAssert("ruleset is correct", () => ((Player)CurrentScreen).Ruleset.Value.Equals(new OsuRuleset().RulesetInfo));
@@ -119,10 +119,10 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddUntilStep("selected beatmap is initial beatmap", () => Beatmap.Value.BeatmapInfo.OnlineID == InitialBeatmap.OnlineID);
 
             AddUntilStep("wait for idle", () => MultiplayerClient.LocalUser?.State == MultiplayerUserState.Idle);
-            ClickButtonWhenEnabled<MultiplayerReadyButton>();
+            ClickButtonWhenEnabled<MultiplayerReadyButton.ReadyButton>();
 
             AddUntilStep("wait for ready", () => MultiplayerClient.LocalUser?.State == MultiplayerUserState.Ready);
-            ClickButtonWhenEnabled<MultiplayerReadyButton>();
+            ClickButtonWhenEnabled<MultiplayerReadyButton.ReadyButton>();
 
             AddUntilStep("wait for player", () => CurrentScreen is Player player && player.IsLoaded);
             AddAssert("mods are correct", () => !((Player)CurrentScreen).Mods.Value.Any());
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs
index 057032c413..a51d4678fe 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs
@@ -145,7 +145,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             AddUntilStep("wait for spectating user state", () => MultiplayerClient.LocalUser?.State == MultiplayerUserState.Spectating);
 
-            ClickButtonWhenEnabled<MultiplayerReadyButton>();
+            ClickButtonWhenEnabled<MultiplayerReadyButton.ReadyButton>();
 
             AddUntilStep("match started", () => MultiplayerClient.Room?.State == MultiplayerRoomState.WaitingForLoad);
         }
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs
index f34f7c6c91..7f7a4c9c5f 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs
@@ -92,10 +92,10 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 MultiplayerClient.TransferHost(2);
             });
 
-            ClickButtonWhenEnabled<MultiplayerReadyButton>();
+            ClickButtonWhenEnabled<MultiplayerReadyButton.ReadyButton>();
             AddUntilStep("user is ready", () => MultiplayerClient.Room?.Users[0].State == MultiplayerUserState.Ready);
 
-            ClickButtonWhenEnabled<MultiplayerReadyButton>();
+            ClickButtonWhenEnabled<MultiplayerReadyButton.ReadyButton>();
             AddUntilStep("user is idle", () => MultiplayerClient.Room?.Users[0].State == MultiplayerUserState.Idle);
         }
 
@@ -111,7 +111,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     MultiplayerClient.AddUser(new APIUser { Id = 2, Username = "Another user" });
             });
 
-            ClickButtonWhenEnabled<MultiplayerReadyButton>();
+            ClickButtonWhenEnabled<MultiplayerReadyButton.ReadyButton>();
             AddUntilStep("user is ready", () => MultiplayerClient.Room?.Users[0].State == MultiplayerUserState.Ready);
 
             verifyGameplayStartFlow();
@@ -126,7 +126,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 MultiplayerClient.TransferHost(2);
             });
 
-            ClickButtonWhenEnabled<MultiplayerReadyButton>();
+            ClickButtonWhenEnabled<MultiplayerReadyButton.ReadyButton>();
             AddStep("make user host", () => MultiplayerClient.TransferHost(MultiplayerClient.Room?.Users[0].UserID ?? 0));
 
             verifyGameplayStartFlow();
@@ -141,12 +141,12 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 MultiplayerClient.AddUser(new APIUser { Id = 2, Username = "Another user" });
             });
 
-            ClickButtonWhenEnabled<MultiplayerReadyButton>();
+            ClickButtonWhenEnabled<MultiplayerReadyButton.ReadyButton>();
             AddUntilStep("user is ready", () => MultiplayerClient.Room?.Users[0].State == MultiplayerUserState.Ready);
 
             AddStep("transfer host", () => MultiplayerClient.TransferHost(MultiplayerClient.Room?.Users[1].UserID ?? 0));
 
-            ClickButtonWhenEnabled<MultiplayerReadyButton>();
+            ClickButtonWhenEnabled<MultiplayerReadyButton.ReadyButton>();
             AddUntilStep("user is idle (match not started)", () => MultiplayerClient.Room?.Users[0].State == MultiplayerUserState.Idle);
             AddAssert("ready button enabled", () => button.ChildrenOfType<OsuButton>().Single().Enabled.Value);
         }
@@ -166,7 +166,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             if (!isHost)
                 AddStep("transfer host", () => MultiplayerClient.TransferHost(2));
 
-            ClickButtonWhenEnabled<MultiplayerReadyButton>();
+            ClickButtonWhenEnabled<MultiplayerReadyButton.ReadyButton>();
 
             AddRepeatStep("change user ready state", () =>
             {
@@ -184,7 +184,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         private void verifyGameplayStartFlow()
         {
             AddUntilStep("user is ready", () => MultiplayerClient.Room?.Users[0].State == MultiplayerUserState.Ready);
-            ClickButtonWhenEnabled<MultiplayerReadyButton>();
+            ClickButtonWhenEnabled<MultiplayerReadyButton.ReadyButton>();
             AddUntilStep("user waiting for load", () => MultiplayerClient.Room?.Users[0].State == MultiplayerUserState.WaitingForLoad);
 
             AddStep("finish gameplay", () =>
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
index 0c80f6ef5b..920e23eaa1 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
@@ -14,16 +14,12 @@ using osu.Framework.Threading;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Backgrounds;
 using osu.Game.Online.Multiplayer;
-using osu.Game.Screens.OnlinePlay.Components;
 using osuTK;
 
 namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
 {
     public class MultiplayerReadyButton : MultiplayerRoomComposite
     {
-        [Resolved]
-        private OsuColour colours { get; set; }
-
         [Resolved]
         private OngoingOperationTracker ongoingOperationTracker { get; set; }
 
@@ -34,14 +30,14 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
         private Sample sampleReadyAll;
         private Sample sampleUnready;
 
-        private readonly ButtonWithTrianglesExposed button;
+        private readonly ReadyButton readyButton;
         private int countReady;
         private ScheduledDelegate readySampleDelegate;
         private IBindable<bool> operationInProgress;
 
         public MultiplayerReadyButton()
         {
-            InternalChild = button = new ButtonWithTrianglesExposed
+            InternalChild = readyButton = new ReadyButton
             {
                 RelativeSizeAxes = Axes.Both,
                 Size = Vector2.One,
@@ -123,47 +119,26 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
 
         private void updateState()
         {
-            var localUser = Client.LocalUser;
-
-            int newCountReady = Room?.Users.Count(u => u.State == MultiplayerUserState.Ready) ?? 0;
-            int newCountTotal = Room?.Users.Count(u => u.State != MultiplayerUserState.Spectating) ?? 0;
-
-            switch (localUser?.State)
+            if (Room == null)
             {
-                default:
-                    button.Text = "Ready";
-                    updateButtonColour(true);
-                    break;
-
-                case MultiplayerUserState.Spectating:
-                case MultiplayerUserState.Ready:
-                    string countText = $"({newCountReady} / {newCountTotal} ready)";
-
-                    if (Room?.Host?.Equals(localUser) == true)
-                    {
-                        button.Text = $"Start match {countText}";
-                        updateButtonColour(true);
-                    }
-                    else
-                    {
-                        button.Text = $"Waiting for host... {countText}";
-                        updateButtonColour(false);
-                    }
-
-                    break;
+                readyButton.Enabled.Value = false;
+                return;
             }
 
-            bool enableButton =
-                Room?.State == MultiplayerRoomState.Open
+            var localUser = Client.LocalUser;
+
+            int newCountReady = Room.Users.Count(u => u.State == MultiplayerUserState.Ready);
+            int newCountTotal = Room.Users.Count(u => u.State != MultiplayerUserState.Spectating);
+
+            readyButton.Enabled.Value =
+                Room.State == MultiplayerRoomState.Open
                 && CurrentPlaylistItem.Value?.ID == Room.Settings.PlaylistItemId
                 && !Room.Playlist.Single(i => i.ID == Room.Settings.PlaylistItemId).Expired
                 && !operationInProgress.Value;
 
             // When the local user is the host and spectating the match, the "start match" state should be enabled if any users are ready.
             if (localUser?.State == MultiplayerUserState.Spectating)
-                enableButton &= Room?.Host?.Equals(localUser) == true && newCountReady > 0;
-
-            button.Enabled.Value = enableButton;
+                readyButton.Enabled.Value &= Room.Host?.Equals(localUser) == true && newCountReady > 0;
 
             if (newCountReady == countReady)
                 return;
@@ -187,25 +162,112 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
             });
         }
 
-        private void updateButtonColour(bool green)
-        {
-            if (green)
-            {
-                button.BackgroundColour = colours.Green;
-                button.Triangles.ColourDark = colours.Green;
-                button.Triangles.ColourLight = colours.GreenLight;
-            }
-            else
-            {
-                button.BackgroundColour = colours.YellowDark;
-                button.Triangles.ColourDark = colours.YellowDark;
-                button.Triangles.ColourLight = colours.Yellow;
-            }
-        }
-
-        private class ButtonWithTrianglesExposed : ReadyButton
+        public class ReadyButton : Components.ReadyButton
         {
             public new Triangles Triangles => base.Triangles;
+
+            [Resolved]
+            private MultiplayerClient multiplayerClient { get; set; }
+
+            [Resolved]
+            private OsuColour colours { get; set; }
+
+            [CanBeNull]
+            private MultiplayerRoom room => multiplayerClient.Room;
+
+            protected override void LoadComplete()
+            {
+                base.LoadComplete();
+
+                multiplayerClient.RoomUpdated += () => Scheduler.AddOnce(onRoomUpdated);
+                onRoomUpdated();
+            }
+
+            private void onRoomUpdated()
+            {
+                updateButtonText();
+                updateButtonColour();
+            }
+
+            private void updateButtonText()
+            {
+                if (room == null)
+                {
+                    Text = "Ready";
+                    return;
+                }
+
+                var localUser = multiplayerClient.LocalUser;
+
+                int countReady = room.Users.Count(u => u.State == MultiplayerUserState.Ready);
+                int countTotal = room.Users.Count(u => u.State != MultiplayerUserState.Spectating);
+
+                string countText = $"({countReady} / {countTotal} ready)";
+
+                switch (localUser?.State)
+                {
+                    default:
+                        Text = "Ready";
+                        break;
+
+                    case MultiplayerUserState.Spectating:
+                    case MultiplayerUserState.Ready:
+                        Text = room.Host?.Equals(localUser) == true
+                            ? $"Start match {countText}"
+                            : $"Waiting for host... {countText}";
+
+                        break;
+                }
+            }
+
+            private void updateButtonColour()
+            {
+                if (room == null)
+                {
+                    setGreen();
+                    return;
+                }
+
+                var localUser = multiplayerClient.LocalUser;
+
+                switch (localUser?.State)
+                {
+                    default:
+                        setGreen();
+                        break;
+
+                    case MultiplayerUserState.Spectating:
+                    case MultiplayerUserState.Ready:
+                        if (room?.Host?.Equals(localUser) == true)
+                            setGreen();
+                        else
+                            setYellow();
+
+                        break;
+                }
+
+                void setYellow()
+                {
+                    BackgroundColour = colours.YellowDark;
+                    Triangles.ColourDark = colours.YellowDark;
+                    Triangles.ColourLight = colours.Yellow;
+                }
+
+                void setGreen()
+                {
+                    BackgroundColour = colours.Green;
+                    Triangles.ColourDark = colours.Green;
+                    Triangles.ColourLight = colours.GreenLight;
+                }
+            }
+
+            protected override void Dispose(bool isDisposing)
+            {
+                base.Dispose(isDisposing);
+
+                if (multiplayerClient != null)
+                    multiplayerClient.RoomUpdated -= onRoomUpdated;
+            }
         }
     }
 }

From efce471f0baacc69239aecdea135faf99586f974 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 17 Mar 2022 19:05:28 +0900
Subject: [PATCH 3517/5547] Add countdown button + popover

---
 .../TestSceneMultiplayerReadyButton.cs        |  18 +-
 .../TestSceneMultiplayerSpectateButton.cs     |  33 ++--
 .../Screens/OnlinePlay/Match/RoomSubScreen.cs | 181 +++++++++---------
 .../Match/MultiplayerReadyButton.cs           | 132 ++++++++++++-
 4 files changed, 246 insertions(+), 118 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs
index 7f7a4c9c5f..12b3b90fc4 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs
@@ -8,6 +8,7 @@ using osu.Framework.Audio;
 using osu.Framework.Bindables;
 using osu.Framework.Extensions;
 using osu.Framework.Graphics;
+using osu.Framework.Graphics.Cursor;
 using osu.Framework.Platform;
 using osu.Framework.Testing;
 using osu.Framework.Utils;
@@ -55,15 +56,16 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 RulesetID = Beatmap.Value.BeatmapInfo.Ruleset.OnlineID
             };
 
-            if (button != null)
-                Remove(button);
-
-            Add(button = new MultiplayerReadyButton
+            Child = new PopoverContainer
             {
-                Anchor = Anchor.Centre,
-                Origin = Anchor.Centre,
-                Size = new Vector2(200, 50),
-            });
+                RelativeSizeAxes = Axes.Both,
+                Child = button = new MultiplayerReadyButton
+                {
+                    Anchor = Anchor.Centre,
+                    Origin = Anchor.Centre,
+                    Size = new Vector2(200, 50),
+                }
+            };
         });
 
         [Test]
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerSpectateButton.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerSpectateButton.cs
index 33ad0fd1de..13c9e021db 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerSpectateButton.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerSpectateButton.cs
@@ -9,6 +9,7 @@ using osu.Framework.Bindables;
 using osu.Framework.Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.Cursor;
 using osu.Framework.Platform;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
@@ -56,23 +57,27 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 RulesetID = Beatmap.Value.BeatmapInfo.Ruleset.OnlineID,
             };
 
-            Child = new FillFlowContainer
+            Child = new PopoverContainer
             {
-                AutoSizeAxes = Axes.Both,
-                Direction = FillDirection.Vertical,
-                Children = new Drawable[]
+                RelativeSizeAxes = Axes.Both,
+                Child = new FillFlowContainer
                 {
-                    spectateButton = new MultiplayerSpectateButton
+                    AutoSizeAxes = Axes.Both,
+                    Direction = FillDirection.Vertical,
+                    Children = new Drawable[]
                     {
-                        Anchor = Anchor.Centre,
-                        Origin = Anchor.Centre,
-                        Size = new Vector2(200, 50),
-                    },
-                    readyButton = new MultiplayerReadyButton
-                    {
-                        Anchor = Anchor.Centre,
-                        Origin = Anchor.Centre,
-                        Size = new Vector2(200, 50),
+                        spectateButton = new MultiplayerSpectateButton
+                        {
+                            Anchor = Anchor.Centre,
+                            Origin = Anchor.Centre,
+                            Size = new Vector2(200, 50),
+                        },
+                        readyButton = new MultiplayerReadyButton
+                        {
+                            Anchor = Anchor.Centre,
+                            Origin = Anchor.Centre,
+                            Size = new Vector2(200, 50),
+                        }
                     }
                 }
             };
diff --git a/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs b/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
index e297c90491..a382f65d84 100644
--- a/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
@@ -12,6 +12,7 @@ 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.Screens;
 using osu.Game.Audio;
@@ -100,122 +101,126 @@ namespace osu.Game.Screens.OnlinePlay.Match
         {
             sampleStart = audio.Samples.Get(@"SongSelect/confirm-selection");
 
-            InternalChildren = new Drawable[]
+            InternalChild = new PopoverContainer
             {
-                beatmapAvailabilityTracker,
-                new MultiplayerRoomSounds(),
-                new GridContainer
+                RelativeSizeAxes = Axes.Both,
+                Children = new Drawable[]
                 {
-                    RelativeSizeAxes = Axes.Both,
-                    RowDimensions = new[]
+                    beatmapAvailabilityTracker,
+                    new MultiplayerRoomSounds(),
+                    new GridContainer
                     {
-                        new Dimension(),
-                        new Dimension(GridSizeMode.Absolute, 50)
-                    },
-                    Content = new[]
-                    {
-                        // Padded main content (drawable room + main content)
-                        new Drawable[]
+                        RelativeSizeAxes = Axes.Both,
+                        RowDimensions = new[]
                         {
-                            new Container
+                            new Dimension(),
+                            new Dimension(GridSizeMode.Absolute, 50)
+                        },
+                        Content = new[]
+                        {
+                            // Padded main content (drawable room + main content)
+                            new Drawable[]
                             {
-                                RelativeSizeAxes = Axes.Both,
-                                Padding = new MarginPadding
+                                new Container
                                 {
-                                    Horizontal = WaveOverlayContainer.WIDTH_PADDING,
-                                    Bottom = 30
-                                },
-                                Children = new[]
-                                {
-                                    mainContent = new GridContainer
+                                    RelativeSizeAxes = Axes.Both,
+                                    Padding = new MarginPadding
                                     {
-                                        RelativeSizeAxes = Axes.Both,
-                                        RowDimensions = new[]
+                                        Horizontal = WaveOverlayContainer.WIDTH_PADDING,
+                                        Bottom = 30
+                                    },
+                                    Children = new[]
+                                    {
+                                        mainContent = new GridContainer
                                         {
-                                            new Dimension(GridSizeMode.AutoSize),
-                                            new Dimension(GridSizeMode.Absolute, 10)
-                                        },
-                                        Content = new[]
-                                        {
-                                            new Drawable[]
+                                            RelativeSizeAxes = Axes.Both,
+                                            RowDimensions = new[]
                                             {
-                                                new DrawableMatchRoom(Room, allowEdit)
-                                                {
-                                                    OnEdit = () => settingsOverlay.Show(),
-                                                    SelectedItem = { BindTarget = SelectedItem }
-                                                }
+                                                new Dimension(GridSizeMode.AutoSize),
+                                                new Dimension(GridSizeMode.Absolute, 10)
                                             },
-                                            null,
-                                            new Drawable[]
+                                            Content = new[]
                                             {
-                                                new Container
+                                                new Drawable[]
                                                 {
-                                                    RelativeSizeAxes = Axes.Both,
-                                                    Children = new[]
+                                                    new DrawableMatchRoom(Room, allowEdit)
                                                     {
-                                                        new Container
+                                                        OnEdit = () => settingsOverlay.Show(),
+                                                        SelectedItem = { BindTarget = SelectedItem }
+                                                    }
+                                                },
+                                                null,
+                                                new Drawable[]
+                                                {
+                                                    new Container
+                                                    {
+                                                        RelativeSizeAxes = Axes.Both,
+                                                        Children = new[]
                                                         {
-                                                            RelativeSizeAxes = Axes.Both,
-                                                            Masking = true,
-                                                            CornerRadius = 10,
-                                                            Child = new Box
+                                                            new Container
                                                             {
                                                                 RelativeSizeAxes = Axes.Both,
-                                                                Colour = Color4Extensions.FromHex(@"3e3a44") // Temporary.
+                                                                Masking = true,
+                                                                CornerRadius = 10,
+                                                                Child = new Box
+                                                                {
+                                                                    RelativeSizeAxes = Axes.Both,
+                                                                    Colour = Color4Extensions.FromHex(@"3e3a44") // Temporary.
+                                                                },
                                                             },
-                                                        },
-                                                        new Container
-                                                        {
-                                                            RelativeSizeAxes = Axes.Both,
-                                                            Padding = new MarginPadding(20),
-                                                            Child = CreateMainContent(),
-                                                        },
-                                                        new Container
-                                                        {
-                                                            Anchor = Anchor.BottomLeft,
-                                                            Origin = Anchor.BottomLeft,
-                                                            RelativeSizeAxes = Axes.X,
-                                                            AutoSizeAxes = Axes.Y,
-                                                            Child = userModsSelectOverlay = new UserModSelectOverlay
+                                                            new Container
                                                             {
-                                                                SelectedMods = { BindTarget = UserMods },
-                                                                IsValidMod = _ => false
-                                                            }
-                                                        },
+                                                                RelativeSizeAxes = Axes.Both,
+                                                                Padding = new MarginPadding(20),
+                                                                Child = CreateMainContent(),
+                                                            },
+                                                            new Container
+                                                            {
+                                                                Anchor = Anchor.BottomLeft,
+                                                                Origin = Anchor.BottomLeft,
+                                                                RelativeSizeAxes = Axes.X,
+                                                                AutoSizeAxes = Axes.Y,
+                                                                Child = userModsSelectOverlay = new UserModSelectOverlay
+                                                                {
+                                                                    SelectedMods = { BindTarget = UserMods },
+                                                                    IsValidMod = _ => false
+                                                                }
+                                                            },
+                                                        }
                                                     }
                                                 }
                                             }
+                                        },
+                                        new Container
+                                        {
+                                            RelativeSizeAxes = Axes.Both,
+                                            // Resolves 1px masking errors between the settings overlay and the room panel.
+                                            Padding = new MarginPadding(-1),
+                                            Child = settingsOverlay = CreateRoomSettingsOverlay(Room)
                                         }
                                     },
-                                    new Container
-                                    {
-                                        RelativeSizeAxes = Axes.Both,
-                                        // Resolves 1px masking errors between the settings overlay and the room panel.
-                                        Padding = new MarginPadding(-1),
-                                        Child = settingsOverlay = CreateRoomSettingsOverlay(Room)
-                                    }
                                 },
                             },
-                        },
-                        // Footer
-                        new Drawable[]
-                        {
-                            new Container
+                            // Footer
+                            new Drawable[]
                             {
-                                RelativeSizeAxes = Axes.Both,
-                                Children = new Drawable[]
+                                new Container
                                 {
-                                    new Box
+                                    RelativeSizeAxes = Axes.Both,
+                                    Children = new Drawable[]
                                     {
-                                        RelativeSizeAxes = Axes.Both,
-                                        Colour = Color4Extensions.FromHex(@"28242d") // Temporary.
-                                    },
-                                    new Container
-                                    {
-                                        RelativeSizeAxes = Axes.Both,
-                                        Padding = new MarginPadding(5),
-                                        Child = CreateFooter()
-                                    },
+                                        new Box
+                                        {
+                                            RelativeSizeAxes = Axes.Both,
+                                            Colour = Color4Extensions.FromHex(@"28242d") // Temporary.
+                                        },
+                                        new Container
+                                        {
+                                            RelativeSizeAxes = Axes.Both,
+                                            Padding = new MarginPadding(5),
+                                            Child = CreateFooter()
+                                        },
+                                    }
                                 }
                             }
                         }
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
index 920e23eaa1..4e53b40075 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
@@ -4,15 +4,24 @@
 using System;
 using System.Diagnostics;
 using System.Linq;
+using Humanizer;
 using JetBrains.Annotations;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
 using osu.Framework.Audio.Sample;
 using osu.Framework.Bindables;
+using osu.Framework.Extensions;
 using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.Cursor;
+using osu.Framework.Graphics.Shapes;
+using osu.Framework.Graphics.Sprites;
+using osu.Framework.Graphics.UserInterface;
 using osu.Framework.Threading;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Backgrounds;
+using osu.Game.Graphics.UserInterface;
+using osu.Game.Graphics.UserInterfaceV2;
 using osu.Game.Online.Multiplayer;
 using osuTK;
 
@@ -30,19 +39,43 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
         private Sample sampleReadyAll;
         private Sample sampleUnready;
 
-        private readonly ReadyButton readyButton;
+        private readonly BindableBool enabled = new BindableBool();
+        private readonly CountdownButton countdownButton;
         private int countReady;
         private ScheduledDelegate readySampleDelegate;
         private IBindable<bool> operationInProgress;
 
         public MultiplayerReadyButton()
         {
-            InternalChild = readyButton = new ReadyButton
+            InternalChild = new GridContainer
             {
                 RelativeSizeAxes = Axes.Both,
-                Size = Vector2.One,
-                Action = onReadyClick,
-                Enabled = { Value = true },
+                ColumnDimensions = new[]
+                {
+                    new Dimension(),
+                    new Dimension(GridSizeMode.AutoSize)
+                },
+                Content = new[]
+                {
+                    new Drawable[]
+                    {
+                        new ReadyButton
+                        {
+                            RelativeSizeAxes = Axes.Both,
+                            Size = Vector2.One,
+                            Action = onReadyClick,
+                            Enabled = { BindTarget = enabled },
+                        },
+                        countdownButton = new CountdownButton
+                        {
+                            RelativeSizeAxes = Axes.Y,
+                            Size = new Vector2(40, 1),
+                            Alpha = 0,
+                            Action = startCountdown,
+                            Enabled = { BindTarget = enabled }
+                        }
+                    }
+                }
             };
         }
 
@@ -111,6 +144,10 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
             });
         }
 
+        private void startCountdown(TimeSpan duration)
+        {
+        }
+
         private void endOperation()
         {
             clickOperation?.Dispose();
@@ -121,7 +158,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
         {
             if (Room == null)
             {
-                readyButton.Enabled.Value = false;
+                enabled.Value = false;
                 return;
             }
 
@@ -130,7 +167,19 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
             int newCountReady = Room.Users.Count(u => u.State == MultiplayerUserState.Ready);
             int newCountTotal = Room.Users.Count(u => u.State != MultiplayerUserState.Spectating);
 
-            readyButton.Enabled.Value =
+            switch (localUser?.State)
+            {
+                default:
+                    countdownButton.Alpha = 0;
+                    break;
+
+                case MultiplayerUserState.Spectating:
+                case MultiplayerUserState.Ready:
+                    countdownButton.Alpha = Room.Host?.Equals(localUser) == true ? 1 : 0;
+                    break;
+            }
+
+            enabled.Value =
                 Room.State == MultiplayerRoomState.Open
                 && CurrentPlaylistItem.Value?.ID == Room.Settings.PlaylistItemId
                 && !Room.Playlist.Single(i => i.ID == Room.Settings.PlaylistItemId).Expired
@@ -138,7 +187,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
 
             // When the local user is the host and spectating the match, the "start match" state should be enabled if any users are ready.
             if (localUser?.State == MultiplayerUserState.Spectating)
-                readyButton.Enabled.Value &= Room.Host?.Equals(localUser) == true && newCountReady > 0;
+                enabled.Value &= Room.Host?.Equals(localUser) == true && newCountReady > 0;
 
             if (newCountReady == countReady)
                 return;
@@ -269,5 +318,72 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
                     multiplayerClient.RoomUpdated -= onRoomUpdated;
             }
         }
+
+        public class CountdownButton : IconButton, IHasPopover
+        {
+            private static readonly TimeSpan[] available_delays =
+            {
+                TimeSpan.FromSeconds(10),
+                TimeSpan.FromSeconds(30),
+                TimeSpan.FromMinutes(1),
+                TimeSpan.FromMinutes(2)
+            };
+
+            public new Action<TimeSpan> Action;
+
+            private readonly Drawable background;
+
+            public CountdownButton()
+            {
+                Icon = FontAwesome.Solid.CaretDown;
+                IconScale = new Vector2(0.6f);
+
+                Add(background = new Box
+                {
+                    RelativeSizeAxes = Axes.Both,
+                    Depth = float.MaxValue
+                });
+
+                base.Action = this.ShowPopover;
+            }
+
+            [BackgroundDependencyLoader]
+            private void load(OsuColour colours)
+            {
+                background.Colour = colours.Green;
+            }
+
+            public Popover GetPopover()
+            {
+                var flow = new FillFlowContainer
+                {
+                    Width = 200,
+                    AutoSizeAxes = Axes.Y,
+                    Direction = FillDirection.Vertical,
+                    Spacing = new Vector2(2),
+                };
+
+                foreach (var duration in available_delays)
+                {
+                    flow.Add(new PopoverButton
+                    {
+                        RelativeSizeAxes = Axes.X,
+                        Text = $"Start match in {duration.Humanize()}",
+                        BackgroundColour = background.Colour,
+                        Action = () =>
+                        {
+                            Action(duration);
+                            this.HidePopover();
+                        }
+                    });
+                }
+
+                return new OsuPopover { Child = flow };
+            }
+
+            public class PopoverButton : OsuButton
+            {
+            }
+        }
     }
 }

From 3b938865a1d3fd4ee4d9972dd37a36f2365ae7df Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 17 Mar 2022 19:14:46 +0900
Subject: [PATCH 3518/5547] Add room structure for countdown timers

---
 .../Countdown/CountdownChangedEvent.cs        | 22 +++++++++++++++++
 .../Countdown/MatchStartCountdownRequest.cs   | 23 ++++++++++++++++++
 .../Countdown/StopCountdownRequest.cs         | 17 +++++++++++++
 .../Online/Multiplayer/MatchServerEvent.cs    |  5 ++++
 .../Online/Multiplayer/MatchStartCountdown.cs | 17 +++++++++++++
 .../TeamVersus/ChangeTeamRequest.cs           |  1 +
 .../Online/Multiplayer/MatchUserRequest.cs    |  6 ++++-
 .../Multiplayer/MultiplayerCountdown.cs       | 24 +++++++++++++++++++
 .../Online/Multiplayer/MultiplayerRoom.cs     |  6 +++++
 osu.Game/Online/SignalRWorkaroundTypes.cs     |  5 ++++
 10 files changed, 125 insertions(+), 1 deletion(-)
 create mode 100644 osu.Game/Online/Multiplayer/Countdown/CountdownChangedEvent.cs
 create mode 100644 osu.Game/Online/Multiplayer/Countdown/MatchStartCountdownRequest.cs
 create mode 100644 osu.Game/Online/Multiplayer/Countdown/StopCountdownRequest.cs
 create mode 100644 osu.Game/Online/Multiplayer/MatchStartCountdown.cs
 create mode 100644 osu.Game/Online/Multiplayer/MultiplayerCountdown.cs

diff --git a/osu.Game/Online/Multiplayer/Countdown/CountdownChangedEvent.cs b/osu.Game/Online/Multiplayer/Countdown/CountdownChangedEvent.cs
new file mode 100644
index 0000000000..b067f3b235
--- /dev/null
+++ b/osu.Game/Online/Multiplayer/Countdown/CountdownChangedEvent.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.
+
+#nullable enable
+
+using MessagePack;
+
+namespace osu.Game.Online.Multiplayer.Countdown
+{
+    /// <summary>
+    /// Indicates a change to the <see cref="MultiplayerRoom"/>'s countdown.
+    /// </summary>
+    [MessagePackObject]
+    public class CountdownChangedEvent : MatchServerEvent
+    {
+        /// <summary>
+        /// The new countdown.
+        /// </summary>
+        [Key(0)]
+        public MultiplayerCountdown? Countdown { get; set; }
+    }
+}
diff --git a/osu.Game/Online/Multiplayer/Countdown/MatchStartCountdownRequest.cs b/osu.Game/Online/Multiplayer/Countdown/MatchStartCountdownRequest.cs
new file mode 100644
index 0000000000..04e7f506c2
--- /dev/null
+++ b/osu.Game/Online/Multiplayer/Countdown/MatchStartCountdownRequest.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 System;
+using MessagePack;
+
+#nullable enable
+
+namespace osu.Game.Online.Multiplayer.Countdown
+{
+    /// <summary>
+    /// A request for a countdown to start the match.
+    /// </summary>
+    [MessagePackObject]
+    public class MatchStartCountdownRequest : MatchUserRequest
+    {
+        /// <summary>
+        /// How long the countdown should last.
+        /// </summary>
+        [Key(0)]
+        public TimeSpan Delay { get; set; }
+    }
+}
diff --git a/osu.Game/Online/Multiplayer/Countdown/StopCountdownRequest.cs b/osu.Game/Online/Multiplayer/Countdown/StopCountdownRequest.cs
new file mode 100644
index 0000000000..20a0e32734
--- /dev/null
+++ b/osu.Game/Online/Multiplayer/Countdown/StopCountdownRequest.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.
+
+#nullable enable
+
+using MessagePack;
+
+namespace osu.Game.Online.Multiplayer.Countdown
+{
+    /// <summary>
+    /// Request to stop the current countdown.
+    /// </summary>
+    [MessagePackObject]
+    public class StopCountdownRequest : MatchUserRequest
+    {
+    }
+}
diff --git a/osu.Game/Online/Multiplayer/MatchServerEvent.cs b/osu.Game/Online/Multiplayer/MatchServerEvent.cs
index 891fb2cc3b..4ce55e424d 100644
--- a/osu.Game/Online/Multiplayer/MatchServerEvent.cs
+++ b/osu.Game/Online/Multiplayer/MatchServerEvent.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.
 
+#nullable enable
+
 using System;
 using MessagePack;
+using osu.Game.Online.Multiplayer.Countdown;
 
 namespace osu.Game.Online.Multiplayer
 {
@@ -11,6 +14,8 @@ namespace osu.Game.Online.Multiplayer
     /// </summary>
     [Serializable]
     [MessagePackObject]
+    // IMPORTANT: Add rules to SignalRUnionWorkaroundResolver for new derived types.
+    [Union(0, typeof(CountdownChangedEvent))]
     public abstract class MatchServerEvent
     {
     }
diff --git a/osu.Game/Online/Multiplayer/MatchStartCountdown.cs b/osu.Game/Online/Multiplayer/MatchStartCountdown.cs
new file mode 100644
index 0000000000..6c1cdd97d3
--- /dev/null
+++ b/osu.Game/Online/Multiplayer/MatchStartCountdown.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.
+
+#nullable enable
+
+using MessagePack;
+
+namespace osu.Game.Online.Multiplayer
+{
+    /// <summary>
+    /// A <see cref="MultiplayerCountdown"/> which will start the match after ending.
+    /// </summary>
+    [MessagePackObject]
+    public class MatchStartCountdown : MultiplayerCountdown
+    {
+    }
+}
diff --git a/osu.Game/Online/Multiplayer/MatchTypes/TeamVersus/ChangeTeamRequest.cs b/osu.Game/Online/Multiplayer/MatchTypes/TeamVersus/ChangeTeamRequest.cs
index 9c3b07049c..a26a2b3fc2 100644
--- a/osu.Game/Online/Multiplayer/MatchTypes/TeamVersus/ChangeTeamRequest.cs
+++ b/osu.Game/Online/Multiplayer/MatchTypes/TeamVersus/ChangeTeamRequest.cs
@@ -7,6 +7,7 @@ using MessagePack;
 
 namespace osu.Game.Online.Multiplayer.MatchTypes.TeamVersus
 {
+    [MessagePackObject]
     public class ChangeTeamRequest : MatchUserRequest
     {
         [Key(0)]
diff --git a/osu.Game/Online/Multiplayer/MatchUserRequest.cs b/osu.Game/Online/Multiplayer/MatchUserRequest.cs
index 8c6809e7f3..fa7bdd8afe 100644
--- a/osu.Game/Online/Multiplayer/MatchUserRequest.cs
+++ b/osu.Game/Online/Multiplayer/MatchUserRequest.cs
@@ -3,6 +3,7 @@
 
 using System;
 using MessagePack;
+using osu.Game.Online.Multiplayer.Countdown;
 using osu.Game.Online.Multiplayer.MatchTypes.TeamVersus;
 
 namespace osu.Game.Online.Multiplayer
@@ -12,7 +13,10 @@ namespace osu.Game.Online.Multiplayer
     /// </summary>
     [Serializable]
     [MessagePackObject]
-    [Union(0, typeof(ChangeTeamRequest))] // IMPORTANT: Add rules to SignalRUnionWorkaroundResolver for new derived types.
+    // IMPORTANT: Add rules to SignalRUnionWorkaroundResolver for new derived types.
+    [Union(0, typeof(ChangeTeamRequest))]
+    [Union(1, typeof(MatchStartCountdownRequest))]
+    [Union(2, typeof(StopCountdownRequest))]
     public abstract class MatchUserRequest
     {
     }
diff --git a/osu.Game/Online/Multiplayer/MultiplayerCountdown.cs b/osu.Game/Online/Multiplayer/MultiplayerCountdown.cs
new file mode 100644
index 0000000000..63bb47b295
--- /dev/null
+++ b/osu.Game/Online/Multiplayer/MultiplayerCountdown.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.
+
+#nullable enable
+
+using System;
+using MessagePack;
+
+namespace osu.Game.Online.Multiplayer
+{
+    /// <summary>
+    /// Describes the current countdown in a <see cref="MultiplayerRoom"/>.
+    /// </summary>
+    [MessagePackObject]
+    [Union(0, typeof(MatchStartCountdown))] // IMPORTANT: Add rules to SignalRUnionWorkaroundResolver for new derived types.
+    public abstract class MultiplayerCountdown
+    {
+        /// <summary>
+        /// The time at which the countdown will end.
+        /// </summary>
+        [Key(0)]
+        public DateTimeOffset EndTime { get; set; }
+    }
+}
diff --git a/osu.Game/Online/Multiplayer/MultiplayerRoom.cs b/osu.Game/Online/Multiplayer/MultiplayerRoom.cs
index a60e70dab3..e215498ff9 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerRoom.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerRoom.cs
@@ -54,6 +54,12 @@ namespace osu.Game.Online.Multiplayer
         [Key(6)]
         public IList<MultiplayerPlaylistItem> Playlist { get; set; } = new List<MultiplayerPlaylistItem>();
 
+        /// <summary>
+        /// The currently-running countdown.
+        /// </summary>
+        [Key(7)]
+        public MultiplayerCountdown? Countdown { get; set; }
+
         [JsonConstructor]
         [SerializationConstructor]
         public MultiplayerRoom(long roomId)
diff --git a/osu.Game/Online/SignalRWorkaroundTypes.cs b/osu.Game/Online/SignalRWorkaroundTypes.cs
index f69d23d81c..3e2b697337 100644
--- a/osu.Game/Online/SignalRWorkaroundTypes.cs
+++ b/osu.Game/Online/SignalRWorkaroundTypes.cs
@@ -4,6 +4,7 @@
 using System;
 using System.Collections.Generic;
 using osu.Game.Online.Multiplayer;
+using osu.Game.Online.Multiplayer.Countdown;
 using osu.Game.Online.Multiplayer.MatchTypes.TeamVersus;
 
 namespace osu.Game.Online
@@ -18,8 +19,12 @@ namespace osu.Game.Online
         internal static readonly IReadOnlyList<(Type derivedType, Type baseType)> BASE_TYPE_MAPPING = new[]
         {
             (typeof(ChangeTeamRequest), typeof(MatchUserRequest)),
+            (typeof(MatchStartCountdownRequest), typeof(MatchUserRequest)),
+            (typeof(StopCountdownRequest), typeof(MatchUserRequest)),
+            (typeof(CountdownChangedEvent), typeof(MatchServerEvent)),
             (typeof(TeamVersusRoomState), typeof(MatchRoomState)),
             (typeof(TeamVersusUserState), typeof(MatchUserState)),
+            (typeof(MatchStartCountdown), typeof(MultiplayerCountdown))
         };
     }
 }

From 72843a679783d6c762117398f36c6dfc26a71d2a Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 17 Mar 2022 19:26:42 +0900
Subject: [PATCH 3519/5547] Add support for starting/stopping countdowns

---
 .../TestSceneMultiplayerReadyButton.cs        | 136 ++++++++++++++++++
 .../Online/Multiplayer/MultiplayerClient.cs   |  20 ++-
 .../OnlinePlay/Components/ReadyButton.cs      |  12 +-
 .../Match/MultiplayerReadyButton.cs           | 136 ++++++++++++++----
 .../Multiplayer/TestMultiplayerClient.cs      |  89 +++++++++++-
 5 files changed, 354 insertions(+), 39 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs
index 12b3b90fc4..b4cbc40403 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.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.Allocation;
@@ -16,11 +17,13 @@ using osu.Game.Beatmaps;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Multiplayer;
+using osu.Game.Online.Multiplayer.Countdown;
 using osu.Game.Online.Rooms;
 using osu.Game.Rulesets;
 using osu.Game.Screens.OnlinePlay.Multiplayer.Match;
 using osu.Game.Tests.Resources;
 using osuTK;
+using osuTK.Input;
 
 namespace osu.Game.Tests.Visual.Multiplayer
 {
@@ -68,6 +71,139 @@ namespace osu.Game.Tests.Visual.Multiplayer
             };
         });
 
+        [Test]
+        public void TestStartWithCountdown()
+        {
+            ClickButtonWhenEnabled<MultiplayerReadyButton.ReadyButton>();
+            AddUntilStep("countdown button shown", () => this.ChildrenOfType<MultiplayerReadyButton.CountdownButton>().SingleOrDefault()?.IsPresent == true);
+            ClickButtonWhenEnabled<MultiplayerReadyButton.CountdownButton>();
+            AddStep("click the first countdown button", () =>
+            {
+                var popoverButton = this.ChildrenOfType<MultiplayerReadyButton.CountdownButton.PopoverButton>().First();
+                InputManager.MoveMouseTo(popoverButton);
+                InputManager.Click(MouseButton.Left);
+            });
+
+            AddAssert("countdown button not visible", () => !this.ChildrenOfType<MultiplayerReadyButton.CountdownButton>().Single().IsPresent);
+            AddStep("finish countdown", () => MultiplayerClient.FinishCountDown());
+            AddUntilStep("match started", () => MultiplayerClient.LocalUser?.State == MultiplayerUserState.WaitingForLoad);
+        }
+
+        [Test]
+        public void TestCancelCountdown()
+        {
+            ClickButtonWhenEnabled<MultiplayerReadyButton.ReadyButton>();
+            AddUntilStep("countdown button shown", () => this.ChildrenOfType<MultiplayerReadyButton.CountdownButton>().SingleOrDefault()?.IsPresent == true);
+            ClickButtonWhenEnabled<MultiplayerReadyButton.CountdownButton>();
+            AddStep("click the first countdown button", () =>
+            {
+                var popoverButton = this.ChildrenOfType<MultiplayerReadyButton.CountdownButton.PopoverButton>().First();
+                InputManager.MoveMouseTo(popoverButton);
+                InputManager.Click(MouseButton.Left);
+            });
+
+            ClickButtonWhenEnabled<MultiplayerReadyButton.ReadyButton>();
+
+            AddStep("finish countdown", () => MultiplayerClient.FinishCountDown());
+            AddUntilStep("match not started", () => MultiplayerClient.LocalUser?.State == MultiplayerUserState.Ready);
+        }
+
+        [Test]
+        public void TestReadyAndUnReadyDuringCountdown()
+        {
+            AddStep("add second user as host", () =>
+            {
+                MultiplayerClient.AddUser(new APIUser { Id = 2, Username = "Another user" });
+                MultiplayerClient.TransferHost(2);
+            });
+
+            AddStep("start with countdown", () => MultiplayerClient.SendMatchRequest(new MatchStartCountdownRequest { Delay = TimeSpan.FromMinutes(2) }));
+
+            ClickButtonWhenEnabled<MultiplayerReadyButton.ReadyButton>();
+            AddUntilStep("user is ready", () => MultiplayerClient.Room?.Users[0].State == MultiplayerUserState.Ready);
+
+            ClickButtonWhenEnabled<MultiplayerReadyButton.ReadyButton>();
+            AddUntilStep("user is idle", () => MultiplayerClient.Room?.Users[0].State == MultiplayerUserState.Idle);
+        }
+
+        [Test]
+        public void TestCountdownButtonEnablementAndVisibilityWhileSpectating()
+        {
+            AddStep("set spectating", () => MultiplayerClient.ChangeUserState(API.LocalUser.Value.OnlineID, MultiplayerUserState.Spectating));
+            AddUntilStep("local user is spectating", () => MultiplayerClient.LocalUser?.State == MultiplayerUserState.Spectating);
+
+            AddAssert("countdown button is visible", () => this.ChildrenOfType<MultiplayerReadyButton.CountdownButton>().Single().IsPresent);
+            AddAssert("countdown button disabled", () => !this.ChildrenOfType<MultiplayerReadyButton.CountdownButton>().Single().Enabled.Value);
+
+            AddStep("add second user", () => MultiplayerClient.AddUser(new APIUser { Id = 2, Username = "Another user" }));
+            AddAssert("countdown button disabled", () => !this.ChildrenOfType<MultiplayerReadyButton.CountdownButton>().Single().Enabled.Value);
+
+            AddStep("set second user ready", () => MultiplayerClient.ChangeUserState(2, MultiplayerUserState.Ready));
+            AddAssert("countdown button enabled", () => this.ChildrenOfType<MultiplayerReadyButton.CountdownButton>().Single().Enabled.Value);
+        }
+
+        [Test]
+        public void TestSpectatingDuringCountdownWithNoReadyUsersCancelsCountdown()
+        {
+            ClickButtonWhenEnabled<MultiplayerReadyButton.ReadyButton>();
+            AddUntilStep("countdown button shown", () => this.ChildrenOfType<MultiplayerReadyButton.CountdownButton>().SingleOrDefault()?.IsPresent == true);
+            ClickButtonWhenEnabled<MultiplayerReadyButton.CountdownButton>();
+            AddStep("click the first countdown button", () =>
+            {
+                var popoverButton = this.ChildrenOfType<MultiplayerReadyButton.CountdownButton.PopoverButton>().First();
+                InputManager.MoveMouseTo(popoverButton);
+                InputManager.Click(MouseButton.Left);
+            });
+
+            AddStep("set spectating", () => MultiplayerClient.ChangeUserState(API.LocalUser.Value.OnlineID, MultiplayerUserState.Spectating));
+            AddUntilStep("local user is spectating", () => MultiplayerClient.LocalUser?.State == MultiplayerUserState.Spectating);
+
+            AddStep("finish countdown", () => MultiplayerClient.FinishCountDown());
+            AddUntilStep("match not started", () => MultiplayerClient.Room?.State == MultiplayerRoomState.Open);
+        }
+
+        [Test]
+        public void TestReadyButtonEnabledWhileSpectatingDuringCountdown()
+        {
+            AddStep("add second user", () => MultiplayerClient.AddUser(new APIUser { Id = 2, Username = "Another user" }));
+            AddStep("set second user ready", () => MultiplayerClient.ChangeUserState(2, MultiplayerUserState.Ready));
+
+            ClickButtonWhenEnabled<MultiplayerReadyButton.ReadyButton>();
+            AddUntilStep("countdown button shown", () => this.ChildrenOfType<MultiplayerReadyButton.CountdownButton>().SingleOrDefault()?.IsPresent == true);
+            ClickButtonWhenEnabled<MultiplayerReadyButton.CountdownButton>();
+            AddStep("click the first countdown button", () =>
+            {
+                var popoverButton = this.ChildrenOfType<MultiplayerReadyButton.CountdownButton.PopoverButton>().First();
+                InputManager.MoveMouseTo(popoverButton);
+                InputManager.Click(MouseButton.Left);
+            });
+
+            AddStep("set spectating", () => MultiplayerClient.ChangeUserState(API.LocalUser.Value.OnlineID, MultiplayerUserState.Spectating));
+            AddUntilStep("local user is spectating", () => MultiplayerClient.LocalUser?.State == MultiplayerUserState.Spectating);
+
+            AddAssert("ready button enabled", () => this.ChildrenOfType<MultiplayerReadyButton.ReadyButton>().Single().Enabled.Value);
+        }
+
+        [Test]
+        public void TestBecomeHostDuringCountdownAndReady()
+        {
+            AddStep("add second user as host", () =>
+            {
+                MultiplayerClient.AddUser(new APIUser { Id = 2, Username = "Another user" });
+                MultiplayerClient.TransferHost(2);
+            });
+
+            AddStep("start countdown", () => MultiplayerClient.SendMatchRequest(new MatchStartCountdownRequest { Delay = TimeSpan.FromMinutes(1) }));
+            AddUntilStep("countdown started", () => MultiplayerClient.Room?.Countdown != null);
+
+            AddStep("transfer host to local user", () => MultiplayerClient.TransferHost(API.LocalUser.Value.OnlineID));
+            AddUntilStep("local user is host", () => MultiplayerClient.Room?.Host?.Equals(MultiplayerClient.LocalUser) == true);
+
+            ClickButtonWhenEnabled<MultiplayerReadyButton.ReadyButton>();
+            AddUntilStep("local user became ready", () => MultiplayerClient.LocalUser?.State == MultiplayerUserState.Ready);
+            AddAssert("countdown still active", () => MultiplayerClient.Room?.Countdown != null);
+        }
+
         [Test]
         public void TestDeletedBeatmapDisableReady()
         {
diff --git a/osu.Game/Online/Multiplayer/MultiplayerClient.cs b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
index a56cc7f8d6..2d5496c5c1 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
@@ -16,6 +16,7 @@ using osu.Framework.Logging;
 using osu.Game.Database;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests.Responses;
+using osu.Game.Online.Multiplayer.Countdown;
 using osu.Game.Online.Rooms;
 using osu.Game.Online.Rooms.RoomStatuses;
 using osu.Game.Rulesets;
@@ -534,7 +535,24 @@ namespace osu.Game.Online.Multiplayer
 
         public Task MatchEvent(MatchServerEvent e)
         {
-            // not used by any match types just yet.
+            if (Room == null)
+                return Task.CompletedTask;
+
+            Scheduler.Add(() =>
+            {
+                if (Room == null)
+                    return;
+
+                switch (e)
+                {
+                    case CountdownChangedEvent countdownChangedEvent:
+                        Room.Countdown = countdownChangedEvent.Countdown;
+                        break;
+                }
+
+                RoomUpdated?.Invoke();
+            }, false);
+
             return Task.CompletedTask;
         }
 
diff --git a/osu.Game/Screens/OnlinePlay/Components/ReadyButton.cs b/osu.Game/Screens/OnlinePlay/Components/ReadyButton.cs
index 9822ceaaf6..79cf5c7236 100644
--- a/osu.Game/Screens/OnlinePlay/Components/ReadyButton.cs
+++ b/osu.Game/Screens/OnlinePlay/Components/ReadyButton.cs
@@ -14,20 +14,18 @@ namespace osu.Game.Screens.OnlinePlay.Components
     public abstract class ReadyButton : TriangleButton, IHasTooltip
     {
         public new readonly BindableBool Enabled = new BindableBool();
-
-        private IBindable<BeatmapAvailability> availability;
+        protected readonly IBindable<BeatmapAvailability> Availability = new Bindable<BeatmapAvailability>();
 
         [BackgroundDependencyLoader]
         private void load(OnlinePlayBeatmapAvailabilityTracker beatmapTracker)
         {
-            availability = beatmapTracker.Availability.GetBoundCopy();
-
-            availability.BindValueChanged(_ => updateState());
+            Availability.BindTo(beatmapTracker.Availability);
+            Availability.BindValueChanged(_ => updateState());
             Enabled.BindValueChanged(_ => updateState(), true);
         }
 
         private void updateState() =>
-            base.Enabled.Value = availability.Value.State == DownloadState.LocallyAvailable && Enabled.Value;
+            base.Enabled.Value = Availability.Value.State == DownloadState.LocallyAvailable && Enabled.Value;
 
         public virtual LocalisableString TooltipText
         {
@@ -36,7 +34,7 @@ namespace osu.Game.Screens.OnlinePlay.Components
                 if (Enabled.Value)
                     return string.Empty;
 
-                if (availability.Value.State != DownloadState.LocallyAvailable)
+                if (Availability.Value.State != DownloadState.LocallyAvailable)
                     return "Beatmap not downloaded";
 
                 return string.Empty;
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
index 4e53b40075..f9f070f17a 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
@@ -17,12 +17,14 @@ using osu.Framework.Graphics.Cursor;
 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.Backgrounds;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Graphics.UserInterfaceV2;
 using osu.Game.Online.Multiplayer;
+using osu.Game.Online.Multiplayer.Countdown;
 using osuTK;
 
 namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
@@ -124,6 +126,14 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
                 return;
             }
 
+            // Local user is the room host and is in a ready state.
+            // The only action they can take is to stop a countdown if one's currently running.
+            if (Room.Countdown != null)
+            {
+                stopCountdown();
+                return;
+            }
+
             // And if a countdown isn't running, start the match.
             startMatch();
 
@@ -131,6 +141,8 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
 
             void toggleReady() => Client.ToggleReady().ContinueWith(_ => endOperation());
 
+            void stopCountdown() => Client.SendMatchRequest(new StopCountdownRequest()).ContinueWith(_ => endOperation());
+
             void startMatch() => Client.StartMatch().ContinueWith(t =>
             {
                 // accessing Exception here silences any potential errors from the antecedent task
@@ -146,6 +158,10 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
 
         private void startCountdown(TimeSpan duration)
         {
+            Debug.Assert(clickOperation == null);
+            clickOperation = ongoingOperationTracker.BeginOperation();
+
+            Client.SendMatchRequest(new MatchStartCountdownRequest { Delay = duration }).ContinueWith(_ => endOperation());
         }
 
         private void endOperation()
@@ -167,16 +183,21 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
             int newCountReady = Room.Users.Count(u => u.State == MultiplayerUserState.Ready);
             int newCountTotal = Room.Users.Count(u => u.State != MultiplayerUserState.Spectating);
 
-            switch (localUser?.State)
+            if (Room.Countdown != null)
+                countdownButton.Alpha = 0;
+            else
             {
-                default:
-                    countdownButton.Alpha = 0;
-                    break;
+                switch (localUser?.State)
+                {
+                    default:
+                        countdownButton.Alpha = 0;
+                        break;
 
-                case MultiplayerUserState.Spectating:
-                case MultiplayerUserState.Ready:
-                    countdownButton.Alpha = Room.Host?.Equals(localUser) == true ? 1 : 0;
-                    break;
+                    case MultiplayerUserState.Spectating:
+                    case MultiplayerUserState.Ready:
+                        countdownButton.Alpha = Room.Host?.Equals(localUser) == true ? 1 : 0;
+                        break;
+                }
             }
 
             enabled.Value =
@@ -232,6 +253,17 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
                 onRoomUpdated();
             }
 
+            protected override void Update()
+            {
+                base.Update();
+
+                if (room?.Countdown != null)
+                {
+                    // Update the countdown timer.
+                    onRoomUpdated();
+                }
+            }
+
             private void onRoomUpdated()
             {
                 updateButtonText();
@@ -251,21 +283,39 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
                 int countReady = room.Users.Count(u => u.State == MultiplayerUserState.Ready);
                 int countTotal = room.Users.Count(u => u.State != MultiplayerUserState.Spectating);
 
+                string countdownText = room.Countdown == null ? string.Empty : $"Starting in {room.Countdown.EndTime - DateTimeOffset.Now:mm\\:ss}";
                 string countText = $"({countReady} / {countTotal} ready)";
 
-                switch (localUser?.State)
+                if (room.Countdown != null)
                 {
-                    default:
-                        Text = "Ready";
-                        break;
+                    switch (localUser?.State)
+                    {
+                        default:
+                            Text = $"Ready ({countdownText.ToLowerInvariant()})";
+                            break;
 
-                    case MultiplayerUserState.Spectating:
-                    case MultiplayerUserState.Ready:
-                        Text = room.Host?.Equals(localUser) == true
-                            ? $"Start match {countText}"
-                            : $"Waiting for host... {countText}";
+                        case MultiplayerUserState.Spectating:
+                        case MultiplayerUserState.Ready:
+                            Text = $"{countdownText} {countText}";
+                            break;
+                    }
+                }
+                else
+                {
+                    switch (localUser?.State)
+                    {
+                        default:
+                            Text = "Ready";
+                            break;
 
-                        break;
+                        case MultiplayerUserState.Spectating:
+                        case MultiplayerUserState.Ready:
+                            Text = room.Host?.Equals(localUser) == true
+                                ? $"Start match {countText}"
+                                : $"Waiting for host... {countText}";
+
+                            break;
+                    }
                 }
             }
 
@@ -279,20 +329,37 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
 
                 var localUser = multiplayerClient.LocalUser;
 
-                switch (localUser?.State)
+                if (room.Countdown != null)
                 {
-                    default:
-                        setGreen();
-                        break;
-
-                    case MultiplayerUserState.Spectating:
-                    case MultiplayerUserState.Ready:
-                        if (room?.Host?.Equals(localUser) == true)
+                    switch (localUser?.State)
+                    {
+                        default:
                             setGreen();
-                        else
-                            setYellow();
+                            break;
 
-                        break;
+                        case MultiplayerUserState.Spectating:
+                        case MultiplayerUserState.Ready:
+                            setYellow();
+                            break;
+                    }
+                }
+                else
+                {
+                    switch (localUser?.State)
+                    {
+                        default:
+                            setGreen();
+                            break;
+
+                        case MultiplayerUserState.Spectating:
+                        case MultiplayerUserState.Ready:
+                            if (room?.Host?.Equals(localUser) == true)
+                                setGreen();
+                            else
+                                setYellow();
+
+                            break;
+                    }
                 }
 
                 void setYellow()
@@ -317,6 +384,17 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
                 if (multiplayerClient != null)
                     multiplayerClient.RoomUpdated -= onRoomUpdated;
             }
+
+            public override LocalisableString TooltipText
+            {
+                get
+                {
+                    if (room?.Countdown != null && multiplayerClient.IsHost && multiplayerClient.LocalUser?.State == MultiplayerUserState.Ready)
+                        return "Cancel countdown";
+
+                    return base.TooltipText;
+                }
+            }
         }
 
         public class CountdownButton : IconButton, IHasPopover
diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
index 6dc5159b6f..a1ae1aa171 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
@@ -7,12 +7,14 @@ using System;
 using System.Collections.Generic;
 using System.Diagnostics;
 using System.Linq;
+using System.Threading;
 using System.Threading.Tasks;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Extensions;
 using osu.Game.Online.API;
 using osu.Game.Online.Multiplayer;
+using osu.Game.Online.Multiplayer.Countdown;
 using osu.Game.Online.Multiplayer.MatchTypes.TeamVersus;
 using osu.Game.Online.Rooms;
 using osu.Game.Rulesets.Mods;
@@ -114,12 +116,24 @@ namespace osu.Game.Tests.Visual.Multiplayer
         public void ChangeUserState(int userId, MultiplayerUserState newState)
         {
             Debug.Assert(Room != null);
+
             ((IMultiplayerClient)this).UserStateChanged(userId, newState);
 
             Schedule(() =>
             {
                 switch (Room.State)
                 {
+                    case MultiplayerRoomState.Open:
+                        // If there are no remaining ready users or the host is not ready, stop any existing countdown.
+                        // Todo: When we have an "automatic start" mode, this should also start a new countdown if any users _are_ ready.
+                        // Todo: This doesn't yet support non-match-start countdowns.
+                        bool shouldStopCountdown = Room.Users.All(u => u.State != MultiplayerUserState.Ready);
+                        shouldStopCountdown |= Room.Host?.State != MultiplayerUserState.Ready && Room.Host?.State != MultiplayerUserState.Spectating;
+
+                        if (shouldStopCountdown)
+                            countdownStopSource?.Cancel();
+                        break;
+
                     case MultiplayerRoomState.WaitingForLoad:
                         if (Room.Users.All(u => u.State != MultiplayerUserState.WaitingForLoad))
                         {
@@ -282,6 +296,12 @@ namespace osu.Game.Tests.Visual.Multiplayer
             return Task.CompletedTask;
         }
 
+        private CancellationTokenSource? countdownFinishSource;
+        private CancellationTokenSource? countdownStopSource;
+        private Task countdownTask = Task.CompletedTask;
+
+        public void FinishCountDown() => countdownFinishSource?.Cancel();
+
         public override async Task SendMatchRequest(MatchUserRequest request)
         {
             Debug.Assert(Room != null);
@@ -289,6 +309,71 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             switch (request)
             {
+                case MatchStartCountdownRequest matchCountdownRequest:
+                    countdownStopSource?.Cancel();
+
+                    var stopSource = countdownStopSource = new CancellationTokenSource();
+                    var finishSource = countdownFinishSource = new CancellationTokenSource();
+                    var cancellationSource = CancellationTokenSource.CreateLinkedTokenSource(stopSource.Token, finishSource.Token);
+                    var countdown = new MatchStartCountdown { EndTime = DateTimeOffset.Now + matchCountdownRequest.Delay };
+
+                    Task lastCountdownTask = countdownTask;
+                    countdownTask = start();
+
+                    async Task start()
+                    {
+                        try
+                        {
+                            await lastCountdownTask;
+                        }
+                        catch (OperationCanceledException)
+                        {
+                        }
+
+                        Schedule(() =>
+                        {
+                            if (stopSource.IsCancellationRequested)
+                                return;
+
+                            Room.Countdown = countdown;
+                            MatchEvent(new CountdownChangedEvent { Countdown = countdown });
+                        });
+
+                        try
+                        {
+                            await Task.Delay(matchCountdownRequest.Delay, cancellationSource.Token).ConfigureAwait(false);
+                        }
+                        catch (OperationCanceledException)
+                        {
+                        }
+
+                        Schedule(() =>
+                        {
+                            if (Room.Countdown != countdown)
+                                return;
+
+                            Room.Countdown = null;
+                            MatchEvent(new CountdownChangedEvent { Countdown = null });
+
+                            using (cancellationSource)
+                            {
+                                if (stopSource.Token.IsCancellationRequested)
+                                    return;
+                            }
+
+                            StartMatch().WaitSafely();
+                        });
+                    }
+
+                    break;
+
+                case StopCountdownRequest _:
+                    countdownStopSource?.Cancel();
+
+                    Room.Countdown = null;
+                    await MatchEvent(new CountdownChangedEvent { Countdown = Room.Countdown });
+                    break;
+
                 case ChangeTeamRequest changeTeam:
 
                     TeamVersusRoomState roomState = (TeamVersusRoomState)Room.MatchState!;
@@ -307,7 +392,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             }
         }
 
-        public override Task StartMatch()
+        public override async Task StartMatch()
         {
             Debug.Assert(Room != null);
 
@@ -315,7 +400,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             foreach (var user in Room.Users.Where(u => u.State == MultiplayerUserState.Ready))
                 ChangeUserState(user.UserID, MultiplayerUserState.WaitingForLoad);
 
-            return ((IMultiplayerClient)this).LoadRequested();
+            await ((IMultiplayerClient)this).LoadRequested();
         }
 
         public override Task AbortGameplay()

From c2e7ff7e3e2dd645f46b90851307e7f3ed72dd6d Mon Sep 17 00:00:00 2001
From: hwabis <kennysun23@gmail.com>
Date: Fri, 18 Mar 2022 01:37:53 -0400
Subject: [PATCH 3520/5547] display count of listQueue

---
 .../Match/Playlist/MultiplayerPlaylist.cs            | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylist.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylist.cs
index eeafebfec0..edd6cf93e9 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylist.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylist.cs
@@ -7,6 +7,8 @@ using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
+using osu.Game.Graphics;
+using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Rooms;
@@ -29,6 +31,8 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist
         private MultiplayerHistoryList historyList;
         private bool firstPopulation = true;
 
+        private OsuSpriteText queueListCount;
+
         [BackgroundDependencyLoader]
         private void load()
         {
@@ -42,6 +46,12 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist
                     Height = tab_control_height,
                     Current = { BindTarget = DisplayMode }
                 },
+                queueListCount = new OsuSpriteText
+                {
+                    Font = OsuFont.Default.With(weight: FontWeight.Bold),
+                    Anchor = Anchor.TopCentre,
+                    Origin = Anchor.TopCentre,
+                },
                 new Container
                 {
                     RelativeSizeAxes = Axes.Both,
@@ -70,6 +80,8 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist
         {
             base.LoadComplete();
             DisplayMode.BindValueChanged(onDisplayModeChanged, true);
+            queueList.Items.BindCollectionChanged(
+                (_, __) => queueListCount.Text = queueList.Items.Count.ToString(), true);
         }
 
         private void onDisplayModeChanged(ValueChangedEvent<MultiplayerPlaylistDisplayMode> mode)

From b5ff9ed13a0d6e936d949606af3ca44fe5a00df0 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 18 Mar 2022 14:27:58 +0900
Subject: [PATCH 3521/5547] Add test coverage of multiplayer being paused when
 users are still loading

---
 .../Multiplayer/TestSceneMultiplayer.cs       | 44 +++++++++++++++++--
 1 file changed, 41 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
index e38da96bd5..2a3dbdaf95 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
@@ -494,17 +494,20 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             AddUntilStep("wait for song select", () => this.ChildrenOfType<MultiplayerMatchSongSelect>().FirstOrDefault()?.BeatmapSetsLoaded == true);
 
-            AddAssert("Mods match current item", () => SelectedMods.Value.Select(m => m.Acronym).SequenceEqual(multiplayerClient.Room.AsNonNull().Playlist.First().RequiredMods.Select(m => m.Acronym)));
+            AddAssert("Mods match current item",
+                () => SelectedMods.Value.Select(m => m.Acronym).SequenceEqual(multiplayerClient.Room.AsNonNull().Playlist.First().RequiredMods.Select(m => m.Acronym)));
 
             AddStep("Switch required mods", () => ((MultiplayerMatchSongSelect)multiplayerComponents.MultiplayerScreen.CurrentSubScreen).Mods.Value = new Mod[] { new OsuModDoubleTime() });
 
-            AddAssert("Mods don't match current item", () => !SelectedMods.Value.Select(m => m.Acronym).SequenceEqual(multiplayerClient.Room.AsNonNull().Playlist.First().RequiredMods.Select(m => m.Acronym)));
+            AddAssert("Mods don't match current item",
+                () => !SelectedMods.Value.Select(m => m.Acronym).SequenceEqual(multiplayerClient.Room.AsNonNull().Playlist.First().RequiredMods.Select(m => m.Acronym)));
 
             AddStep("start match externally", () => multiplayerClient.StartMatch());
 
             AddUntilStep("play started", () => multiplayerComponents.CurrentScreen is Player);
 
-            AddAssert("Mods match current item", () => SelectedMods.Value.Select(m => m.Acronym).SequenceEqual(multiplayerClient.Room.AsNonNull().Playlist.First().RequiredMods.Select(m => m.Acronym)));
+            AddAssert("Mods match current item",
+                () => SelectedMods.Value.Select(m => m.Acronym).SequenceEqual(multiplayerClient.Room.AsNonNull().Playlist.First().RequiredMods.Select(m => m.Acronym)));
         }
 
         [Test]
@@ -664,6 +667,41 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddUntilStep("wait for results", () => multiplayerComponents.CurrentScreen is ResultsScreen);
         }
 
+        [Test]
+        public void TestGameplayDoesntStartWithNonLoadedUser()
+        {
+            createRoom(() => new Room
+            {
+                Name = { Value = "Test Room" },
+                Playlist =
+                {
+                    new PlaylistItem(beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo)
+                    {
+                        RulesetID = new OsuRuleset().RulesetInfo.OnlineID,
+                    }
+                }
+            });
+
+            pressReadyButton();
+
+            AddStep("join other user and ready", () =>
+            {
+                multiplayerClient.AddUser(new APIUser { Id = 1234 });
+                multiplayerClient.ChangeUserState(1234, MultiplayerUserState.Ready);
+            });
+
+            AddStep("start match", () =>
+            {
+                multiplayerClient.StartMatch();
+            });
+
+            AddUntilStep("wait for player", () => multiplayerComponents.CurrentScreen is Player);
+
+            AddWaitStep("wait some", 20);
+
+            AddAssert("ensure gameplay hasn't started", () => this.ChildrenOfType<GameplayClockContainer>().SingleOrDefault()?.IsRunning == false);
+        }
+
         [Test]
         public void TestRoomSettingsReQueriedWhenJoiningRoom()
         {

From 59aef88504a8408eb49b61d7362941ef177d7520 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 18 Mar 2022 15:07:57 +0900
Subject: [PATCH 3522/5547] Simplify clock reset/start flow in
 `MultiSpectatorScreen`

---
 .../OnlinePlay/Multiplayer/Spectate/MultiSpectatorScreen.cs   | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorScreen.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorScreen.cs
index 6747b8fc66..523301f4fd 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorScreen.cs
@@ -164,7 +164,6 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Spectate
             base.LoadComplete();
 
             masterClockContainer.Reset();
-            masterClockContainer.Stop();
 
             syncManager.ReadyToStart += onReadyToStart;
             syncManager.MasterState.BindValueChanged(onMasterStateChanged, true);
@@ -198,8 +197,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Spectate
                                         .DefaultIfEmpty(0)
                                         .Min();
 
-            masterClockContainer.Seek(startTime);
-            masterClockContainer.Start();
+            masterClockContainer.Reset(true, startTime);
 
             // Although the clock has been started, this flag is set to allow for later synchronisation state changes to also be able to start it.
             canStartMasterClock = true;

From f09a9467226f335c95c823bb03b09fc99f13de4e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 18 Mar 2022 15:08:25 +0900
Subject: [PATCH 3523/5547] Start `GameplayClockContainer` paused for better
 state control

---
 .../Gameplay/TestSceneMasterGameplayClockContainer.cs       | 5 +----
 .../OnlinePlay/Multiplayer/Spectate/MultiSpectatorPlayer.cs | 2 --
 osu.Game/Screens/Play/GameplayClockContainer.cs             | 6 +++---
 3 files changed, 4 insertions(+), 9 deletions(-)

diff --git a/osu.Game.Tests/Gameplay/TestSceneMasterGameplayClockContainer.cs b/osu.Game.Tests/Gameplay/TestSceneMasterGameplayClockContainer.cs
index 77b402ad3c..0ed432bbea 100644
--- a/osu.Game.Tests/Gameplay/TestSceneMasterGameplayClockContainer.cs
+++ b/osu.Game.Tests/Gameplay/TestSceneMasterGameplayClockContainer.cs
@@ -85,10 +85,7 @@ namespace osu.Game.Tests.Gameplay
 
                 Add(gameplayClockContainer = new MasterGameplayClockContainer(working, 0));
 
-                if (whileStopped)
-                    gameplayClockContainer.Stop();
-
-                gameplayClockContainer.Reset();
+                gameplayClockContainer.Reset(startClock: !whileStopped);
             });
 
             AddStep($"set clock rate to {clockRate}", () => working.Track.AddAdjustment(AdjustableProperty.Frequency, new BindableDouble(clockRate)));
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorPlayer.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorPlayer.cs
index 615bd41f3f..ececa1e497 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorPlayer.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorPlayer.cs
@@ -55,8 +55,6 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Spectate
             public SpectatorGameplayClockContainer([NotNull] IClock sourceClock)
                 : base(sourceClock)
             {
-                // the container should initially be in a stopped state until the catch-up clock is started by the sync manager.
-                Stop();
             }
 
             protected override void Update()
diff --git a/osu.Game/Screens/Play/GameplayClockContainer.cs b/osu.Game/Screens/Play/GameplayClockContainer.cs
index 66f5cb0bd4..226f5709c7 100644
--- a/osu.Game/Screens/Play/GameplayClockContainer.cs
+++ b/osu.Game/Screens/Play/GameplayClockContainer.cs
@@ -24,7 +24,7 @@ namespace osu.Game.Screens.Play
         /// <summary>
         /// Whether gameplay is paused.
         /// </summary>
-        public readonly BindableBool IsPaused = new BindableBool();
+        public readonly BindableBool IsPaused = new BindableBool(true);
 
         /// <summary>
         /// The adjustable source clock used for gameplay. Should be used for seeks and clock control.
@@ -115,7 +115,7 @@ namespace osu.Game.Screens.Play
         /// <summary>
         /// Resets this <see cref="GameplayClockContainer"/> and the source to an initial state ready for gameplay.
         /// </summary>
-        /// <param name="startClock">Whether to start the clock immediately.</param>
+        /// <param name="startClock">Whether to start the clock immediately, if not already started.</param>
         /// <param name="gameplayStartTime">A time to use for future <see cref="Reset"/> calls as the definite start of gameplay.</param>
         public void Reset(bool startClock = false, double? gameplayStartTime = null)
         {
@@ -128,7 +128,7 @@ namespace osu.Game.Screens.Play
             // Manually stop the source in order to not affect the IsPaused state.
             AdjustableSource.Stop();
 
-            if (!IsPaused.Value && startClock)
+            if (!IsPaused.Value || startClock)
                 Start();
         }
 

From 0988c2b0fabd104792f7ebd7a4b3be49b1a26fb9 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 18 Mar 2022 15:28:48 +0900
Subject: [PATCH 3524/5547] Move `DrawableRuleset` binding to `LoadComplete` to
 avoid exceptions on `InputManager` access

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

diff --git a/osu.Game/Rulesets/UI/DrawableRuleset.cs b/osu.Game/Rulesets/UI/DrawableRuleset.cs
index 29559f5036..be1105e7ff 100644
--- a/osu.Game/Rulesets/UI/DrawableRuleset.cs
+++ b/osu.Game/Rulesets/UI/DrawableRuleset.cs
@@ -133,6 +133,11 @@ namespace osu.Game.Rulesets.UI
                 p.NewResult += (_, r) => NewResult?.Invoke(r);
                 p.RevertResult += (_, r) => RevertResult?.Invoke(r);
             }));
+        }
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
 
             IsPaused.ValueChanged += paused =>
             {

From 611562c6502aaedeeba6f1c8ff883d51fb539518 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 18 Mar 2022 16:21:14 +0900
Subject: [PATCH 3525/5547] Add more comments around catch up logic

---
 .../OnlinePlay/Multiplayer/Spectate/ISpectatorPlayerClock.cs | 5 ++++-
 .../OnlinePlay/Multiplayer/Spectate/MultiSpectatorPlayer.cs  | 1 +
 2 files changed, 5 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/ISpectatorPlayerClock.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/ISpectatorPlayerClock.cs
index 1a5231e602..de23b4fef7 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/ISpectatorPlayerClock.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/ISpectatorPlayerClock.cs
@@ -17,8 +17,11 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Spectate
         Bindable<bool> WaitingOnFrames { get; }
 
         /// <summary>
-        /// Whether this clock is resynchronising to the master clock.
+        /// Whether this clock is behind the master clock and running at a higher rate to catch up to it.
         /// </summary>
+        /// <remarks>
+        /// Of note, this will be false if this clock is *ahead* of the master clock.
+        /// </remarks>
         bool IsCatchingUp { get; set; }
 
         /// <summary>
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorPlayer.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorPlayer.cs
index ececa1e497..29afaf00d8 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorPlayer.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorPlayer.cs
@@ -59,6 +59,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Spectate
 
             protected override void Update()
             {
+                // The SourceClock here is always a CatchUpSpectatorPlayerClock.
                 // The player clock's running state is controlled externally, but the local pausing state needs to be updated to stop gameplay.
                 if (SourceClock.IsRunning)
                     Start();

From 4bc7c69bf70e7aa1bf91deec0e587523da0ea368 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 18 Mar 2022 16:27:14 +0900
Subject: [PATCH 3526/5547] Fix test regression due to missing argument

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

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs
index ed8b0bdd96..653a35417e 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs
@@ -473,7 +473,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             }
 
             protected override MasterGameplayClockContainer CreateMasterGameplayClockContainer(WorkingBeatmap beatmap)
-                => new MasterGameplayClockContainer(beatmap, gameplayStartTime ?? 0);
+                => new MasterGameplayClockContainer(beatmap, gameplayStartTime ?? 0, true);
         }
     }
 }

From 3f92bef9dfe3f58e98127705b75906bd06658aed Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 18 Mar 2022 16:50:37 +0900
Subject: [PATCH 3527/5547] Add setting for judgement line thickness

---
 .../Play/HUD/HitErrorMeters/BarHitErrorMeter.cs | 17 +++++++++++++++--
 1 file changed, 15 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/Play/HUD/HitErrorMeters/BarHitErrorMeter.cs b/osu.Game/Screens/Play/HUD/HitErrorMeters/BarHitErrorMeter.cs
index 542731cf93..068a7f96cc 100644
--- a/osu.Game/Screens/Play/HUD/HitErrorMeters/BarHitErrorMeter.cs
+++ b/osu.Game/Screens/Play/HUD/HitErrorMeters/BarHitErrorMeter.cs
@@ -4,12 +4,14 @@
 using System;
 using System.Linq;
 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.Shapes;
 using osu.Framework.Graphics.Sprites;
+using osu.Game.Configuration;
 using osu.Game.Rulesets.Judgements;
 using osu.Game.Rulesets.Scoring;
 using osuTK;
@@ -19,7 +21,14 @@ namespace osu.Game.Screens.Play.HUD.HitErrorMeters
     public class BarHitErrorMeter : HitErrorMeter
     {
         private const int judgement_line_width = 14;
-        private const int judgement_line_height = 4;
+
+        [SettingSource("Judgement line thickness", "How thick the individual lines should be.")]
+        public BindableNumber<float> JudgementLineThickness { get; } = new BindableNumber<float>(4)
+        {
+            MinValue = 1,
+            MaxValue = 8,
+            Precision = 0.1f,
+        };
 
         private SpriteIcon arrow;
         private SpriteIcon iconEarly;
@@ -255,6 +264,7 @@ namespace osu.Game.Screens.Play.HUD.HitErrorMeters
 
             judgementsContainer.Add(new JudgementLine
             {
+                JudgementLineThickness = { BindTarget = JudgementLineThickness },
                 Y = getRelativeJudgementPosition(judgement.TimeOffset),
                 Colour = GetColourForHitResult(judgement.Type),
             });
@@ -268,11 +278,12 @@ namespace osu.Game.Screens.Play.HUD.HitErrorMeters
 
         internal class JudgementLine : CompositeDrawable
         {
+            public readonly BindableNumber<float> JudgementLineThickness = new BindableFloat();
+
             public JudgementLine()
             {
                 RelativeSizeAxes = Axes.X;
                 RelativePositionAxes = Axes.Y;
-                Height = judgement_line_height;
 
                 Blending = BlendingParameters.Additive;
 
@@ -295,6 +306,8 @@ namespace osu.Game.Screens.Play.HUD.HitErrorMeters
                 Alpha = 0;
                 Width = 0;
 
+                JudgementLineThickness.BindValueChanged(thickness => Height = thickness.NewValue, true);
+
                 this
                     .FadeTo(0.6f, judgement_fade_in_duration, Easing.OutQuint)
                     .ResizeWidthTo(1, judgement_fade_in_duration, Easing.OutQuint)

From 331cb2aa800fe4f8330534da0bd59127abf56f6d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 18 Mar 2022 16:54:09 +0900
Subject: [PATCH 3528/5547] Add setting to show or hide the moving average
 arrow

---
 .../HUD/HitErrorMeters/BarHitErrorMeter.cs    | 32 +++++++++++++------
 1 file changed, 23 insertions(+), 9 deletions(-)

diff --git a/osu.Game/Screens/Play/HUD/HitErrorMeters/BarHitErrorMeter.cs b/osu.Game/Screens/Play/HUD/HitErrorMeters/BarHitErrorMeter.cs
index 068a7f96cc..c12411be64 100644
--- a/osu.Game/Screens/Play/HUD/HitErrorMeters/BarHitErrorMeter.cs
+++ b/osu.Game/Screens/Play/HUD/HitErrorMeters/BarHitErrorMeter.cs
@@ -30,6 +30,9 @@ namespace osu.Game.Screens.Play.HUD.HitErrorMeters
             Precision = 0.1f,
         };
 
+        [SettingSource("Show moving average arrow", "Whether an arrow should move beneath the bar showing the average error.")]
+        public Bindable<bool> ShowMovingAverage { get; } = new BindableBool(true);
+
         private SpriteIcon arrow;
         private SpriteIcon iconEarly;
         private SpriteIcon iconLate;
@@ -41,6 +44,12 @@ namespace osu.Game.Screens.Play.HUD.HitErrorMeters
 
         private double maxHitWindow;
 
+        private double floatingAverage;
+        private Container colourBars;
+        private Container arrowContainer;
+
+        private const int max_concurrent_judgements = 50;
+
         public BarHitErrorMeter()
         {
             AutoSizeAxes = Axes.Both;
@@ -134,13 +143,16 @@ namespace osu.Game.Screens.Play.HUD.HitErrorMeters
                             },
                         }
                     },
-                    new Container
+                    arrowContainer = new Container
                     {
                         Name = "average chevron",
                         Anchor = Anchor.CentreLeft,
-                        Origin = Anchor.CentreLeft,
+                        Origin = Anchor.CentreRight,
                         Width = chevron_size,
+                        X = chevron_size,
                         RelativeSizeAxes = Axes.Y,
+                        Alpha = 0,
+                        Scale = new Vector2(0, 1),
                         Child = arrow = new SpriteIcon
                         {
                             Anchor = Anchor.TopCentre,
@@ -164,8 +176,15 @@ namespace osu.Game.Screens.Play.HUD.HitErrorMeters
             colourBars.Height = 0;
             colourBars.ResizeHeightTo(1, 800, Easing.OutQuint);
 
-            arrow.Alpha = 0;
-            arrow.Delay(200).FadeInFromZero(600);
+            // delay the arrow appearance animation for only the initial appearance.
+            using (arrowContainer.BeginDelayedSequence(250))
+            {
+                ShowMovingAverage.BindValueChanged(visible =>
+                {
+                    arrowContainer.FadeTo(visible.NewValue ? 1 : 0, 250, Easing.OutQuint);
+                    arrowContainer.ScaleTo(visible.NewValue ? new Vector2(1) : new Vector2(0, 1), 250, Easing.OutQuint);
+                }, true);
+            }
         }
 
         protected override void Update()
@@ -233,11 +252,6 @@ namespace osu.Game.Screens.Play.HUD.HitErrorMeters
             }
         }
 
-        private double floatingAverage;
-        private Container colourBars;
-
-        private const int max_concurrent_judgements = 50;
-
         protected override void OnNewJudgement(JudgementResult judgement)
         {
             const int arrow_move_duration = 800;

From cdeab1b14e2b6130f63e3a363f0275363fc2f7a7 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 18 Mar 2022 17:16:40 +0900
Subject: [PATCH 3529/5547] Add setting to change the style of the centre
 marker

---
 .../HUD/HitErrorMeters/BarHitErrorMeter.cs    | 100 ++++++++++++++----
 1 file changed, 79 insertions(+), 21 deletions(-)

diff --git a/osu.Game/Screens/Play/HUD/HitErrorMeters/BarHitErrorMeter.cs b/osu.Game/Screens/Play/HUD/HitErrorMeters/BarHitErrorMeter.cs
index c12411be64..60b12476d1 100644
--- a/osu.Game/Screens/Play/HUD/HitErrorMeters/BarHitErrorMeter.cs
+++ b/osu.Game/Screens/Play/HUD/HitErrorMeters/BarHitErrorMeter.cs
@@ -33,6 +33,9 @@ namespace osu.Game.Screens.Play.HUD.HitErrorMeters
         [SettingSource("Show moving average arrow", "Whether an arrow should move beneath the bar showing the average error.")]
         public Bindable<bool> ShowMovingAverage { get; } = new BindableBool(true);
 
+        [SettingSource("Centre marker style", "How to signify the centre of the display")]
+        public Bindable<CentreMarker> CentreMarkerStyle { get; } = new Bindable<CentreMarker>(CentreMarker.Circle);
+
         private SpriteIcon arrow;
         private SpriteIcon iconEarly;
         private SpriteIcon iconLate;
@@ -48,8 +51,14 @@ namespace osu.Game.Screens.Play.HUD.HitErrorMeters
         private Container colourBars;
         private Container arrowContainer;
 
+        private (HitResult result, double length)[] hitWindows;
+
         private const int max_concurrent_judgements = 50;
 
+        private Drawable[] centreMarkerDrawables;
+
+        private const int centre_marker_size = 8;
+
         public BarHitErrorMeter()
         {
             AutoSizeAxes = Axes.Both;
@@ -58,13 +67,12 @@ namespace osu.Game.Screens.Play.HUD.HitErrorMeters
         [BackgroundDependencyLoader]
         private void load()
         {
-            const int centre_marker_size = 8;
             const int bar_height = 200;
             const int bar_width = 2;
             const float chevron_size = 8;
             const float icon_size = 14;
 
-            var hitWindows = HitWindows.GetAllAvailableWindows().ToArray();
+            hitWindows = HitWindows.GetAllAvailableWindows().ToArray();
 
             InternalChild = new Container
             {
@@ -116,14 +124,6 @@ namespace osu.Game.Screens.Play.HUD.HitErrorMeters
                                 RelativeSizeAxes = Axes.Y,
                                 Height = 0.5f,
                             },
-                            new Circle
-                            {
-                                Name = "middle marker behind",
-                                Colour = GetColourForHitResult(hitWindows.Last().result),
-                                Anchor = Anchor.Centre,
-                                Origin = Anchor.Centre,
-                                Size = new Vector2(centre_marker_size),
-                            },
                             judgementsContainer = new Container
                             {
                                 Name = "judgements",
@@ -132,15 +132,6 @@ namespace osu.Game.Screens.Play.HUD.HitErrorMeters
                                 RelativeSizeAxes = Axes.Y,
                                 Width = judgement_line_width,
                             },
-                            new Circle
-                            {
-                                Name = "middle marker in front",
-                                Colour = GetColourForHitResult(hitWindows.Last().result).Darken(0.3f),
-                                Anchor = Anchor.Centre,
-                                Origin = Anchor.Centre,
-                                Size = new Vector2(centre_marker_size),
-                                Scale = new Vector2(0.5f),
-                            },
                         }
                     },
                     arrowContainer = new Container
@@ -176,8 +167,10 @@ namespace osu.Game.Screens.Play.HUD.HitErrorMeters
             colourBars.Height = 0;
             colourBars.ResizeHeightTo(1, 800, Easing.OutQuint);
 
-            // delay the arrow appearance animation for only the initial appearance.
-            using (arrowContainer.BeginDelayedSequence(250))
+            CentreMarkerStyle.BindValueChanged(style => recreateCentreMarker(style.NewValue), true);
+
+            // delay the appearance animations for only the initial appearance.
+            using (arrowContainer.BeginDelayedSequence(450))
             {
                 ShowMovingAverage.BindValueChanged(visible =>
                 {
@@ -187,6 +180,65 @@ namespace osu.Game.Screens.Play.HUD.HitErrorMeters
             }
         }
 
+        private void recreateCentreMarker(CentreMarker style)
+        {
+            if (centreMarkerDrawables != null)
+            {
+                foreach (var d in centreMarkerDrawables)
+                {
+                    d.ScaleTo(0, 500, Easing.OutQuint)
+                     .FadeOut(500, Easing.OutQuint);
+
+                    d.Expire();
+                }
+
+                centreMarkerDrawables = null;
+            }
+
+            switch (style)
+            {
+                case CentreMarker.None:
+                    break;
+
+                case CentreMarker.Circle:
+                    centreMarkerDrawables = new Drawable[]
+                    {
+                        new Circle
+                        {
+                            Name = "middle marker behind",
+                            Colour = GetColourForHitResult(hitWindows.Last().result),
+                            Anchor = Anchor.Centre,
+                            Origin = Anchor.Centre,
+                            Depth = float.MaxValue,
+                            Size = new Vector2(centre_marker_size),
+                        },
+                        new Circle
+                        {
+                            Name = "middle marker in front",
+                            Colour = GetColourForHitResult(hitWindows.Last().result).Darken(0.3f),
+                            Anchor = Anchor.Centre,
+                            Origin = Anchor.Centre,
+                            Depth = float.MinValue,
+                            Size = new Vector2(centre_marker_size),
+                            Scale = new Vector2(0.5f),
+                        },
+                    };
+                    break;
+            }
+
+            if (centreMarkerDrawables != null)
+            {
+                foreach (var d in centreMarkerDrawables)
+                {
+                    colourBars.Add(d);
+
+                    Vector2 originalScale = d.Scale;
+                    d.FadeInFromZero(500, Easing.OutQuint)
+                     .ScaleTo(0).ScaleTo(originalScale, 1000, Easing.OutElasticHalf);
+                }
+            }
+        }
+
         protected override void Update()
         {
             base.Update();
@@ -333,5 +385,11 @@ namespace osu.Game.Screens.Play.HUD.HitErrorMeters
         }
 
         public override void Clear() => judgementsContainer.Clear();
+
+        public enum CentreMarker
+        {
+            None,
+            Circle
+        }
     }
 }

From 919583137e9bb2afd8514fbbbdcbe0cef043585d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 18 Mar 2022 17:23:27 +0900
Subject: [PATCH 3530/5547] Add line style for centre marker

---
 .../HUD/HitErrorMeters/BarHitErrorMeter.cs    | 48 +++++++++++++++----
 1 file changed, 38 insertions(+), 10 deletions(-)

diff --git a/osu.Game/Screens/Play/HUD/HitErrorMeters/BarHitErrorMeter.cs b/osu.Game/Screens/Play/HUD/HitErrorMeters/BarHitErrorMeter.cs
index 60b12476d1..3e583317e1 100644
--- a/osu.Game/Screens/Play/HUD/HitErrorMeters/BarHitErrorMeter.cs
+++ b/osu.Game/Screens/Play/HUD/HitErrorMeters/BarHitErrorMeter.cs
@@ -34,7 +34,7 @@ namespace osu.Game.Screens.Play.HUD.HitErrorMeters
         public Bindable<bool> ShowMovingAverage { get; } = new BindableBool(true);
 
         [SettingSource("Centre marker style", "How to signify the centre of the display")]
-        public Bindable<CentreMarker> CentreMarkerStyle { get; } = new Bindable<CentreMarker>(CentreMarker.Circle);
+        public Bindable<CentreMarkerStyles> CentreMarkerStyle { get; } = new Bindable<CentreMarkerStyles>(CentreMarkerStyles.Circle);
 
         private SpriteIcon arrow;
         private SpriteIcon iconEarly;
@@ -180,7 +180,7 @@ namespace osu.Game.Screens.Play.HUD.HitErrorMeters
             }
         }
 
-        private void recreateCentreMarker(CentreMarker style)
+        private void recreateCentreMarker(CentreMarkerStyles style)
         {
             if (centreMarkerDrawables != null)
             {
@@ -197,10 +197,10 @@ namespace osu.Game.Screens.Play.HUD.HitErrorMeters
 
             switch (style)
             {
-                case CentreMarker.None:
+                case CentreMarkerStyles.None:
                     break;
 
-                case CentreMarker.Circle:
+                case CentreMarkerStyles.Circle:
                     centreMarkerDrawables = new Drawable[]
                     {
                         new Circle
@@ -219,11 +219,39 @@ namespace osu.Game.Screens.Play.HUD.HitErrorMeters
                             Anchor = Anchor.Centre,
                             Origin = Anchor.Centre,
                             Depth = float.MinValue,
-                            Size = new Vector2(centre_marker_size),
-                            Scale = new Vector2(0.5f),
+                            Size = new Vector2(centre_marker_size / 2f),
                         },
                     };
                     break;
+
+                case CentreMarkerStyles.Line:
+                    const float border_size = 1.5f;
+
+                    centreMarkerDrawables = new Drawable[]
+                    {
+                        new Box
+                        {
+                            Name = "middle marker behind",
+                            Colour = GetColourForHitResult(hitWindows.Last().result),
+                            Anchor = Anchor.Centre,
+                            Origin = Anchor.Centre,
+                            Depth = float.MaxValue,
+                            Size = new Vector2(judgement_line_width, centre_marker_size / 3f),
+                        },
+                        new Box
+                        {
+                            Name = "middle marker in front",
+                            Colour = GetColourForHitResult(hitWindows.Last().result).Darken(0.3f),
+                            Anchor = Anchor.Centre,
+                            Origin = Anchor.Centre,
+                            Depth = float.MinValue,
+                            Size = new Vector2(judgement_line_width - border_size, centre_marker_size / 3f - border_size),
+                        },
+                    };
+                    break;
+
+                default:
+                    throw new ArgumentOutOfRangeException(nameof(style), style, null);
             }
 
             if (centreMarkerDrawables != null)
@@ -232,9 +260,8 @@ namespace osu.Game.Screens.Play.HUD.HitErrorMeters
                 {
                     colourBars.Add(d);
 
-                    Vector2 originalScale = d.Scale;
                     d.FadeInFromZero(500, Easing.OutQuint)
-                     .ScaleTo(0).ScaleTo(originalScale, 1000, Easing.OutElasticHalf);
+                     .ScaleTo(0).ScaleTo(1, 1000, Easing.OutElasticHalf);
                 }
             }
         }
@@ -386,10 +413,11 @@ namespace osu.Game.Screens.Play.HUD.HitErrorMeters
 
         public override void Clear() => judgementsContainer.Clear();
 
-        public enum CentreMarker
+        public enum CentreMarkerStyles
         {
             None,
-            Circle
+            Circle,
+            Line
         }
     }
 }

From 7c9fe4036cbde6f330c96e5da9dc55af0424d9e1 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 18 Mar 2022 17:46:22 +0900
Subject: [PATCH 3531/5547] Add setting to change the style of the early/late
 markers

---
 .../HUD/HitErrorMeters/BarHitErrorMeter.cs    | 112 ++++++++++++++----
 1 file changed, 91 insertions(+), 21 deletions(-)

diff --git a/osu.Game/Screens/Play/HUD/HitErrorMeters/BarHitErrorMeter.cs b/osu.Game/Screens/Play/HUD/HitErrorMeters/BarHitErrorMeter.cs
index 3e583317e1..02c2a36918 100644
--- a/osu.Game/Screens/Play/HUD/HitErrorMeters/BarHitErrorMeter.cs
+++ b/osu.Game/Screens/Play/HUD/HitErrorMeters/BarHitErrorMeter.cs
@@ -12,6 +12,8 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Graphics.Sprites;
 using osu.Game.Configuration;
+using osu.Game.Graphics;
+using osu.Game.Graphics.Sprites;
 using osu.Game.Rulesets.Judgements;
 using osu.Game.Rulesets.Scoring;
 using osuTK;
@@ -36,9 +38,12 @@ namespace osu.Game.Screens.Play.HUD.HitErrorMeters
         [SettingSource("Centre marker style", "How to signify the centre of the display")]
         public Bindable<CentreMarkerStyles> CentreMarkerStyle { get; } = new Bindable<CentreMarkerStyles>(CentreMarkerStyles.Circle);
 
+        [SettingSource("Label style", "How to show early/late extremities")]
+        public Bindable<LabelStyles> LabelStyle { get; } = new Bindable<LabelStyles>(LabelStyles.Icons);
+
         private SpriteIcon arrow;
-        private SpriteIcon iconEarly;
-        private SpriteIcon iconLate;
+        private Drawable labelEarly;
+        private Drawable labelLate;
 
         private Container colourBarsEarly;
         private Container colourBarsLate;
@@ -70,7 +75,6 @@ namespace osu.Game.Screens.Play.HUD.HitErrorMeters
             const int bar_height = 200;
             const int bar_width = 2;
             const float chevron_size = 8;
-            const float icon_size = 14;
 
             hitWindows = HitWindows.GetAllAvailableWindows().ToArray();
 
@@ -91,22 +95,6 @@ namespace osu.Game.Screens.Play.HUD.HitErrorMeters
                         RelativeSizeAxes = Axes.Y,
                         Children = new Drawable[]
                         {
-                            iconEarly = new SpriteIcon
-                            {
-                                Y = -10,
-                                Size = new Vector2(icon_size),
-                                Icon = FontAwesome.Solid.ShippingFast,
-                                Anchor = Anchor.TopCentre,
-                                Origin = Anchor.Centre,
-                            },
-                            iconLate = new SpriteIcon
-                            {
-                                Y = 10,
-                                Size = new Vector2(icon_size),
-                                Icon = FontAwesome.Solid.Bicycle,
-                                Anchor = Anchor.BottomCentre,
-                                Origin = Anchor.Centre,
-                            },
                             colourBarsEarly = new Container
                             {
                                 Anchor = Anchor.Centre,
@@ -168,6 +156,7 @@ namespace osu.Game.Screens.Play.HUD.HitErrorMeters
             colourBars.ResizeHeightTo(1, 800, Easing.OutQuint);
 
             CentreMarkerStyle.BindValueChanged(style => recreateCentreMarker(style.NewValue), true);
+            LabelStyle.BindValueChanged(style => recreateLabels(style.NewValue), true);
 
             // delay the appearance animations for only the initial appearance.
             using (arrowContainer.BeginDelayedSequence(450))
@@ -266,13 +255,87 @@ namespace osu.Game.Screens.Play.HUD.HitErrorMeters
             }
         }
 
+        private void recreateLabels(LabelStyles style)
+        {
+            const float icon_size = 14;
+
+            labelEarly?.Expire();
+            labelEarly = null;
+
+            labelLate?.Expire();
+            labelLate = null;
+
+            switch (style)
+            {
+                case LabelStyles.None:
+                    break;
+
+                case LabelStyles.Icons:
+                    labelEarly = new SpriteIcon
+                    {
+                        Y = -10,
+                        Size = new Vector2(icon_size),
+                        Icon = FontAwesome.Solid.ShippingFast,
+                        Anchor = Anchor.TopCentre,
+                        Origin = Anchor.Centre,
+                    };
+
+                    labelLate = new SpriteIcon
+                    {
+                        Y = 10,
+                        Size = new Vector2(icon_size),
+                        Icon = FontAwesome.Solid.Bicycle,
+                        Anchor = Anchor.BottomCentre,
+                        Origin = Anchor.Centre,
+                    };
+
+                    break;
+
+                case LabelStyles.Text:
+                    labelEarly = new OsuSpriteText
+                    {
+                        Y = -10,
+                        Text = "Early",
+                        Font = OsuFont.Default.With(size: 10),
+                        Anchor = Anchor.TopCentre,
+                        Origin = Anchor.Centre,
+                    };
+
+                    labelLate = new OsuSpriteText
+                    {
+                        Y = 10,
+                        Text = "Late",
+                        Font = OsuFont.Default.With(size: 10),
+                        Anchor = Anchor.BottomCentre,
+                        Origin = Anchor.Centre,
+                    };
+
+                    break;
+
+                default:
+                    throw new ArgumentOutOfRangeException(nameof(style), style, null);
+            }
+
+            if (labelEarly != null)
+            {
+                colourBars.Add(labelEarly);
+                labelEarly.FadeInFromZero(500);
+            }
+
+            if (labelLate != null)
+            {
+                colourBars.Add(labelLate);
+                labelLate.FadeInFromZero(500);
+            }
+        }
+
         protected override void Update()
         {
             base.Update();
 
             // undo any layout rotation to display icons in the correct orientation
-            iconEarly.Rotation = -Rotation;
-            iconLate.Rotation = -Rotation;
+            if (labelEarly != null) labelEarly.Rotation = -Rotation;
+            if (labelLate != null) labelLate.Rotation = -Rotation;
         }
 
         private void createColourBars((HitResult result, double length)[] windows)
@@ -419,5 +482,12 @@ namespace osu.Game.Screens.Play.HUD.HitErrorMeters
             Circle,
             Line
         }
+
+        public enum LabelStyles
+        {
+            None,
+            Icons,
+            Text
+        }
     }
 }

From 7cb7b03cee678db55530d8134d39295089a6a216 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 18 Mar 2022 18:16:45 +0900
Subject: [PATCH 3532/5547] Fix `TestSceneMasterGameplayClockContainer` not
 clearing previous test clocks

---
 .../Gameplay/TestSceneMasterGameplayClockContainer.cs       | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Tests/Gameplay/TestSceneMasterGameplayClockContainer.cs b/osu.Game.Tests/Gameplay/TestSceneMasterGameplayClockContainer.cs
index 0ed432bbea..b2dd6cbd97 100644
--- a/osu.Game.Tests/Gameplay/TestSceneMasterGameplayClockContainer.cs
+++ b/osu.Game.Tests/Gameplay/TestSceneMasterGameplayClockContainer.cs
@@ -36,7 +36,7 @@ namespace osu.Game.Tests.Gameplay
                 var working = CreateWorkingBeatmap(new OsuRuleset().RulesetInfo);
                 working.LoadTrack();
 
-                Add(gameplayClockContainer = new MasterGameplayClockContainer(working, 0));
+                Child = gameplayClockContainer = new MasterGameplayClockContainer(working, 0);
             });
 
             AddStep("start clock", () => gameplayClockContainer.Start());
@@ -53,7 +53,7 @@ namespace osu.Game.Tests.Gameplay
                 var working = CreateWorkingBeatmap(new OsuRuleset().RulesetInfo);
                 working.LoadTrack();
 
-                Add(gameplayClockContainer = new MasterGameplayClockContainer(working, 0));
+                Child = gameplayClockContainer = new MasterGameplayClockContainer(working, 0);
             });
 
             AddStep("start clock", () => gameplayClockContainer.Start());
@@ -83,7 +83,7 @@ namespace osu.Game.Tests.Gameplay
                 working = new ClockBackedTestWorkingBeatmap(new OsuRuleset().RulesetInfo, new FramedClock(new ManualClock()), Audio);
                 working.LoadTrack();
 
-                Add(gameplayClockContainer = new MasterGameplayClockContainer(working, 0));
+                Child = gameplayClockContainer = new MasterGameplayClockContainer(working, 0);
 
                 gameplayClockContainer.Reset(startClock: !whileStopped);
             });

From 341201ae55549c2ec4c107b259cc1193e1bf8642 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 18 Mar 2022 12:09:03 +0300
Subject: [PATCH 3533/5547] Add "bug report" issue form template

---
 .github/ISSUE_TEMPLATE/bug-issue.yml | 76 ++++++++++++++++++++++++++++
 1 file changed, 76 insertions(+)
 create mode 100644 .github/ISSUE_TEMPLATE/bug-issue.yml

diff --git a/.github/ISSUE_TEMPLATE/bug-issue.yml b/.github/ISSUE_TEMPLATE/bug-issue.yml
new file mode 100644
index 0000000000..428b749af1
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/bug-issue.yml
@@ -0,0 +1,76 @@
+name: Bug report
+description: Encountered a clear bug or crash with logs backing it? Fill it up!
+body:
+  - type: markdown
+    attributes:
+      value: |
+        # osu! bug report
+
+        Important to note that your issue may have already been reported before. Please check:
+        - Pinned issues, at the top of https://github.com/ppy/osu/issues.
+        - Current open `priority:0` issues, filterable [here](https://github.com/ppy/osu/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc+label%3Apriority%3A0).
+
+        And also search for your issue. If you find that it already exists, respond with a reaction or add any further information that may be helpful.
+
+  - type: dropdown
+    attributes:
+      label: Type
+      description: |
+          - Game behaviour bug: game gets into an unexpected state (e.g. incorrect scoring, wrong multiplayer room state, etc.).
+          - Cosmetic bug: something looks wrong (e.g. misaligned component, text not wrapping, etc.)
+      options:
+        - Crash to desktop
+        - Game behaviour bug
+        - Performance bug
+        - Cosmetic bug
+        - Other
+    validations:
+      required: true
+  - type: textarea
+    attributes:
+      label: Bug description
+      description: What are the steps for reproducing the bug? Any additional details that might be of help?
+    validations:
+      required: true
+  - type: textarea
+    attributes:
+      label: Screenshots or videos
+      description: May also help in reproducing the encountered bug, in addition to descriptions.
+      placeholder: You can attach by dragging and dropping the screenshots/videos into this box.
+    validations:
+      required: false
+  - type: input
+    attributes:
+      label: Version
+      description: The version of osu!(lazer) you encountered this bug on.
+    validations:
+      required: true
+  - type: markdown
+    attributes:
+      value: |
+        ## Logs attachments
+
+        Logs are necessary to further investigate this bug. They are reset every new game session, so you need to ensure the logs are preserved by not starting/restarting osu! after encountering the bug.
+
+        In the case this isn't a "Crash to Desktop" report, to retrieve logs:
+          1. Head on to game settings and click on "Open osu! folder"
+          2. Then open the `logs` folder located there
+
+        Otherwise, logs can *only* be retrieved via file explorer, as running the game will reset them.
+
+        Logs are, by default, located at:
+          - `%AppData%/osu/logs` *(on Windows),*
+          - `~/.local/share/osu/logs` *(on Linux & macOS).*
+          - `Android/data/sh.ppy.osulazer/files/logs` *(on Android)*,
+          - on iOS they can be obtained by connecting your device to your desktop and copying the `logs` directory from the app's own document storage using iTunes. (https://support.apple.com/en-us/HT201301#copy-to-computer)
+
+        If you have relocated your game folder, head into that location and open the `logs` folder.
+
+        Finally, select all log files and attach them in the "Logs" box below.
+
+  - type: textarea
+    attributes:
+      label: Logs
+      placeholder: You can attach by dragging and dropping the log files into this box.
+    validations:
+      required: true

From 105245a53aaa7a65bab884fd1a43073bf6f545e7 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 18 Mar 2022 12:41:34 +0300
Subject: [PATCH 3534/5547] Apply minor rewording suggestions

Co-authored-by: Dean Herbert <pe@ppy.sh>
---
 .github/ISSUE_TEMPLATE/bug-issue.yml | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/.github/ISSUE_TEMPLATE/bug-issue.yml b/.github/ISSUE_TEMPLATE/bug-issue.yml
index 428b749af1..3bd6767535 100644
--- a/.github/ISSUE_TEMPLATE/bug-issue.yml
+++ b/.github/ISSUE_TEMPLATE/bug-issue.yml
@@ -1,5 +1,5 @@
 name: Bug report
-description: Encountered a clear bug or crash with logs backing it? Fill it up!
+description: Report a very clearly broken issue.
 body:
   - type: markdown
     attributes:
@@ -20,9 +20,9 @@ body:
           - Cosmetic bug: something looks wrong (e.g. misaligned component, text not wrapping, etc.)
       options:
         - Crash to desktop
-        - Game behaviour bug
-        - Performance bug
-        - Cosmetic bug
+        - Game behaviour
+        - Performance
+        - Cosmetic
         - Other
     validations:
       required: true
@@ -35,14 +35,14 @@ body:
   - type: textarea
     attributes:
       label: Screenshots or videos
-      description: May also help in reproducing the encountered bug, in addition to descriptions.
+      description: Share any kind of visuals you can which show the bug or issue taking place.
       placeholder: You can attach by dragging and dropping the screenshots/videos into this box.
     validations:
       required: false
   - type: input
     attributes:
       label: Version
-      description: The version of osu!(lazer) you encountered this bug on.
+      description: The version you encountered this bug on. This is shown at the bottom of the main menu and also at the end of the settings screen.
     validations:
       required: true
   - type: markdown
@@ -66,7 +66,7 @@ body:
 
         If you have relocated your game folder, head into that location and open the `logs` folder.
 
-        Finally, select all log files and attach them in the "Logs" box below.
+        Finally, select all log files and drag them into the "Logs" box below.
 
   - type: textarea
     attributes:

From 32faa05b8707ecd22d4db4bc1ebb4e8536c13b96 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 18 Mar 2022 12:47:33 +0300
Subject: [PATCH 3535/5547] Include searching step as part of the bullets

---
 .github/ISSUE_TEMPLATE/bug-issue.yml | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/.github/ISSUE_TEMPLATE/bug-issue.yml b/.github/ISSUE_TEMPLATE/bug-issue.yml
index 3bd6767535..5af9a3d6da 100644
--- a/.github/ISSUE_TEMPLATE/bug-issue.yml
+++ b/.github/ISSUE_TEMPLATE/bug-issue.yml
@@ -9,8 +9,7 @@ body:
         Important to note that your issue may have already been reported before. Please check:
         - Pinned issues, at the top of https://github.com/ppy/osu/issues.
         - Current open `priority:0` issues, filterable [here](https://github.com/ppy/osu/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc+label%3Apriority%3A0).
-
-        And also search for your issue. If you find that it already exists, respond with a reaction or add any further information that may be helpful.
+        - And most importantly, search for your issue. If you find that it already exists, respond with a reaction or add any further information that may be helpful.
 
   - type: dropdown
     attributes:

From 4b0649743a5b103f91936530caa9dc0c882d7664 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 18 Mar 2022 12:47:40 +0300
Subject: [PATCH 3536/5547] Remove unnecessary description

---
 .github/ISSUE_TEMPLATE/bug-issue.yml | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/.github/ISSUE_TEMPLATE/bug-issue.yml b/.github/ISSUE_TEMPLATE/bug-issue.yml
index 5af9a3d6da..542d0dccaf 100644
--- a/.github/ISSUE_TEMPLATE/bug-issue.yml
+++ b/.github/ISSUE_TEMPLATE/bug-issue.yml
@@ -14,9 +14,6 @@ body:
   - type: dropdown
     attributes:
       label: Type
-      description: |
-          - Game behaviour bug: game gets into an unexpected state (e.g. incorrect scoring, wrong multiplayer room state, etc.).
-          - Cosmetic bug: something looks wrong (e.g. misaligned component, text not wrapping, etc.)
       options:
         - Crash to desktop
         - Game behaviour

From c97aa3a26f5c3edbc4c62e05c98d9027a00afb06 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 18 Mar 2022 18:57:34 +0900
Subject: [PATCH 3537/5547] Fix intermittent ready button test failure

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

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs
index f34f7c6c91..dd13d2b6ef 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs
@@ -148,7 +148,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             ClickButtonWhenEnabled<MultiplayerReadyButton>();
             AddUntilStep("user is idle (match not started)", () => MultiplayerClient.Room?.Users[0].State == MultiplayerUserState.Idle);
-            AddAssert("ready button enabled", () => button.ChildrenOfType<OsuButton>().Single().Enabled.Value);
+            AddUntilStep("ready button enabled", () => button.ChildrenOfType<OsuButton>().Single().Enabled.Value);
         }
 
         [TestCase(true)]

From 9215384229df6813f1decbe20f398da92ceeb588 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 18 Mar 2022 12:59:51 +0300
Subject: [PATCH 3538/5547] Display beatmap maximum combo in score panel

---
 .../Screens/Ranking/Expanded/ExpandedPanelMiddleContent.cs   | 2 +-
 .../Screens/Ranking/Expanded/Statistics/ComboStatistic.cs    | 5 +++--
 2 files changed, 4 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Screens/Ranking/Expanded/ExpandedPanelMiddleContent.cs b/osu.Game/Screens/Ranking/Expanded/ExpandedPanelMiddleContent.cs
index 7e39708e65..f43cbc11e2 100644
--- a/osu.Game/Screens/Ranking/Expanded/ExpandedPanelMiddleContent.cs
+++ b/osu.Game/Screens/Ranking/Expanded/ExpandedPanelMiddleContent.cs
@@ -68,7 +68,7 @@ namespace osu.Game.Screens.Ranking.Expanded
             var topStatistics = new List<StatisticDisplay>
             {
                 new AccuracyStatistic(score.Accuracy),
-                new ComboStatistic(score.MaxCombo, !score.Statistics.TryGetValue(HitResult.Miss, out int missCount) || missCount == 0),
+                new ComboStatistic(score.MaxCombo, beatmap.MaxCombo, !score.Statistics.TryGetValue(HitResult.Miss, out int missCount) || missCount == 0),
                 new PerformanceStatistic(score),
             };
 
diff --git a/osu.Game/Screens/Ranking/Expanded/Statistics/ComboStatistic.cs b/osu.Game/Screens/Ranking/Expanded/Statistics/ComboStatistic.cs
index b92c244174..67d580270d 100644
--- a/osu.Game/Screens/Ranking/Expanded/Statistics/ComboStatistic.cs
+++ b/osu.Game/Screens/Ranking/Expanded/Statistics/ComboStatistic.cs
@@ -25,9 +25,10 @@ namespace osu.Game.Screens.Ranking.Expanded.Statistics
         /// Creates a new <see cref="ComboStatistic"/>.
         /// </summary>
         /// <param name="combo">The combo to be displayed.</param>
+        /// <param name="maxCombo">The maximum value of <paramref name="combo"/>.</param>
         /// <param name="isPerfect">Whether this is a perfect combo.</param>
-        public ComboStatistic(int combo, bool isPerfect)
-            : base("combo", combo)
+        public ComboStatistic(int combo, int? maxCombo, bool isPerfect)
+            : base("combo", combo, maxCombo)
         {
             this.isPerfect = isPerfect;
         }

From af22e67e15af4da1e6730e88cff1f48622582bfd Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 18 Mar 2022 13:00:30 +0300
Subject: [PATCH 3539/5547] Fix perfect combo check not accounting for
 `LargeTickMiss`

`LargeTickMiss` can affect combo, see
https://github.com/ppy/osu/blob/a352a140bc145f342fadc300797a2b05ade3f920/osu.Game/Rulesets/Scoring/HitResult.cs#L124-L144.
---
 .../Screens/Ranking/Expanded/ExpandedPanelMiddleContent.cs  | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Ranking/Expanded/ExpandedPanelMiddleContent.cs b/osu.Game/Screens/Ranking/Expanded/ExpandedPanelMiddleContent.cs
index f43cbc11e2..fb8a1beb04 100644
--- a/osu.Game/Screens/Ranking/Expanded/ExpandedPanelMiddleContent.cs
+++ b/osu.Game/Screens/Ranking/Expanded/ExpandedPanelMiddleContent.cs
@@ -65,10 +65,14 @@ namespace osu.Game.Screens.Ranking.Expanded
             var metadata = beatmap.BeatmapSet?.Metadata ?? beatmap.Metadata;
             string creator = metadata.Author.Username;
 
+            bool isPerfect = true;
+            isPerfect &= !score.Statistics.TryGetValue(HitResult.Miss, out int missCount) || missCount == 0;
+            isPerfect &= !score.Statistics.TryGetValue(HitResult.LargeTickMiss, out int largeTickMissCount) || largeTickMissCount == 0;
+
             var topStatistics = new List<StatisticDisplay>
             {
                 new AccuracyStatistic(score.Accuracy),
-                new ComboStatistic(score.MaxCombo, beatmap.MaxCombo, !score.Statistics.TryGetValue(HitResult.Miss, out int missCount) || missCount == 0),
+                new ComboStatistic(score.MaxCombo, beatmap.MaxCombo, isPerfect),
                 new PerformanceStatistic(score),
             };
 

From 2cb1974a5824b59528986d9ffa5d8392217f1a18 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 18 Mar 2022 13:02:25 +0300
Subject: [PATCH 3540/5547] Add max combo to test beatmap info

---
 osu.Game.Tests/Resources/TestResources.cs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Game.Tests/Resources/TestResources.cs b/osu.Game.Tests/Resources/TestResources.cs
index 81b624f908..00bb02a937 100644
--- a/osu.Game.Tests/Resources/TestResources.cs
+++ b/osu.Game.Tests/Resources/TestResources.cs
@@ -133,6 +133,7 @@ namespace osu.Game.Tests.Resources
                         StarRating = diff,
                         Length = length,
                         BPM = bpm,
+                        MaxCombo = 1000,
                         Hash = Guid.NewGuid().ToString().ComputeMD5Hash(),
                         Ruleset = rulesetInfo,
                         Metadata = metadata,

From bd488d139d1f8431ed5c1541c159f0090590962d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 18 Mar 2022 20:11:05 +0900
Subject: [PATCH 3541/5547] Better centre text labels for hit error meter

---
 osu.Game/Screens/Play/HUD/HitErrorMeters/BarHitErrorMeter.cs | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/osu.Game/Screens/Play/HUD/HitErrorMeters/BarHitErrorMeter.cs b/osu.Game/Screens/Play/HUD/HitErrorMeters/BarHitErrorMeter.cs
index 02c2a36918..e3a8b6cae6 100644
--- a/osu.Game/Screens/Play/HUD/HitErrorMeters/BarHitErrorMeter.cs
+++ b/osu.Game/Screens/Play/HUD/HitErrorMeters/BarHitErrorMeter.cs
@@ -294,6 +294,7 @@ namespace osu.Game.Screens.Play.HUD.HitErrorMeters
                 case LabelStyles.Text:
                     labelEarly = new OsuSpriteText
                     {
+                        X = -1,
                         Y = -10,
                         Text = "Early",
                         Font = OsuFont.Default.With(size: 10),
@@ -303,6 +304,7 @@ namespace osu.Game.Screens.Play.HUD.HitErrorMeters
 
                     labelLate = new OsuSpriteText
                     {
+                        X = -1,
                         Y = 10,
                         Text = "Late",
                         Font = OsuFont.Default.With(size: 10),

From 806a16d8f6a841d3a7bf97a62b63def44a19447a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 18 Mar 2022 20:13:15 +0900
Subject: [PATCH 3542/5547] Fix `SkinComponentToolbox` attempting to create
 instances of abstract classes

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

diff --git a/osu.Game/Skinning/Editor/SkinComponentToolbox.cs b/osu.Game/Skinning/Editor/SkinComponentToolbox.cs
index a586cdcd54..756f229927 100644
--- a/osu.Game/Skinning/Editor/SkinComponentToolbox.cs
+++ b/osu.Game/Skinning/Editor/SkinComponentToolbox.cs
@@ -51,7 +51,7 @@ namespace osu.Game.Skinning.Editor
             fill.Clear();
 
             var skinnableTypes = typeof(OsuGame).Assembly.GetTypes()
-                                                .Where(t => !t.IsInterface)
+                                                .Where(t => !t.IsInterface && !t.IsAbstract)
                                                 .Where(t => typeof(ISkinnableDrawable).IsAssignableFrom(t))
                                                 .OrderBy(t => t.Name)
                                                 .ToArray();

From ed90dc6d6bba910f908ad23dca8fd5cfa227b3f6 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 18 Mar 2022 20:17:04 +0900
Subject: [PATCH 3543/5547] Fix centering of labels using `Height` instead of
 location to better handle rotations

---
 osu.Game/Screens/Play/HUD/HitErrorMeters/BarHitErrorMeter.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/Play/HUD/HitErrorMeters/BarHitErrorMeter.cs b/osu.Game/Screens/Play/HUD/HitErrorMeters/BarHitErrorMeter.cs
index e3a8b6cae6..dca50c07ad 100644
--- a/osu.Game/Screens/Play/HUD/HitErrorMeters/BarHitErrorMeter.cs
+++ b/osu.Game/Screens/Play/HUD/HitErrorMeters/BarHitErrorMeter.cs
@@ -294,20 +294,20 @@ namespace osu.Game.Screens.Play.HUD.HitErrorMeters
                 case LabelStyles.Text:
                     labelEarly = new OsuSpriteText
                     {
-                        X = -1,
                         Y = -10,
                         Text = "Early",
                         Font = OsuFont.Default.With(size: 10),
+                        Height = 12,
                         Anchor = Anchor.TopCentre,
                         Origin = Anchor.Centre,
                     };
 
                     labelLate = new OsuSpriteText
                     {
-                        X = -1,
                         Y = 10,
                         Text = "Late",
                         Font = OsuFont.Default.With(size: 10),
+                        Height = 12,
                         Anchor = Anchor.BottomCentre,
                         Origin = Anchor.Centre,
                     };

From 04f4e81852b846caee2b70e9cee1b47ac64dd7bc Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 18 Mar 2022 21:05:19 +0900
Subject: [PATCH 3544/5547] Rename start countdown request

---
 .../Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs     | 4 ++--
 ...StartCountdownRequest.cs => StartMatchCountdownRequest.cs} | 2 +-
 osu.Game/Online/Multiplayer/MatchUserRequest.cs               | 2 +-
 osu.Game/Online/SignalRWorkaroundTypes.cs                     | 2 +-
 .../OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs    | 2 +-
 osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs    | 2 +-
 6 files changed, 7 insertions(+), 7 deletions(-)
 rename osu.Game/Online/Multiplayer/Countdown/{MatchStartCountdownRequest.cs => StartMatchCountdownRequest.cs} (89%)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs
index b4cbc40403..fc47861576 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs
@@ -117,7 +117,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 MultiplayerClient.TransferHost(2);
             });
 
-            AddStep("start with countdown", () => MultiplayerClient.SendMatchRequest(new MatchStartCountdownRequest { Delay = TimeSpan.FromMinutes(2) }));
+            AddStep("start with countdown", () => MultiplayerClient.SendMatchRequest(new StartMatchCountdownRequest { Delay = TimeSpan.FromMinutes(2) }));
 
             ClickButtonWhenEnabled<MultiplayerReadyButton.ReadyButton>();
             AddUntilStep("user is ready", () => MultiplayerClient.Room?.Users[0].State == MultiplayerUserState.Ready);
@@ -193,7 +193,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 MultiplayerClient.TransferHost(2);
             });
 
-            AddStep("start countdown", () => MultiplayerClient.SendMatchRequest(new MatchStartCountdownRequest { Delay = TimeSpan.FromMinutes(1) }));
+            AddStep("start countdown", () => MultiplayerClient.SendMatchRequest(new StartMatchCountdownRequest { Delay = TimeSpan.FromMinutes(1) }));
             AddUntilStep("countdown started", () => MultiplayerClient.Room?.Countdown != null);
 
             AddStep("transfer host to local user", () => MultiplayerClient.TransferHost(API.LocalUser.Value.OnlineID));
diff --git a/osu.Game/Online/Multiplayer/Countdown/MatchStartCountdownRequest.cs b/osu.Game/Online/Multiplayer/Countdown/StartMatchCountdownRequest.cs
similarity index 89%
rename from osu.Game/Online/Multiplayer/Countdown/MatchStartCountdownRequest.cs
rename to osu.Game/Online/Multiplayer/Countdown/StartMatchCountdownRequest.cs
index 04e7f506c2..9e6967af9d 100644
--- a/osu.Game/Online/Multiplayer/Countdown/MatchStartCountdownRequest.cs
+++ b/osu.Game/Online/Multiplayer/Countdown/StartMatchCountdownRequest.cs
@@ -12,7 +12,7 @@ namespace osu.Game.Online.Multiplayer.Countdown
     /// A request for a countdown to start the match.
     /// </summary>
     [MessagePackObject]
-    public class MatchStartCountdownRequest : MatchUserRequest
+    public class StartMatchCountdownRequest : MatchUserRequest
     {
         /// <summary>
         /// How long the countdown should last.
diff --git a/osu.Game/Online/Multiplayer/MatchUserRequest.cs b/osu.Game/Online/Multiplayer/MatchUserRequest.cs
index fa7bdd8afe..888b55e428 100644
--- a/osu.Game/Online/Multiplayer/MatchUserRequest.cs
+++ b/osu.Game/Online/Multiplayer/MatchUserRequest.cs
@@ -15,7 +15,7 @@ namespace osu.Game.Online.Multiplayer
     [MessagePackObject]
     // IMPORTANT: Add rules to SignalRUnionWorkaroundResolver for new derived types.
     [Union(0, typeof(ChangeTeamRequest))]
-    [Union(1, typeof(MatchStartCountdownRequest))]
+    [Union(1, typeof(StartMatchCountdownRequest))]
     [Union(2, typeof(StopCountdownRequest))]
     public abstract class MatchUserRequest
     {
diff --git a/osu.Game/Online/SignalRWorkaroundTypes.cs b/osu.Game/Online/SignalRWorkaroundTypes.cs
index 3e2b697337..156f916cef 100644
--- a/osu.Game/Online/SignalRWorkaroundTypes.cs
+++ b/osu.Game/Online/SignalRWorkaroundTypes.cs
@@ -19,7 +19,7 @@ namespace osu.Game.Online
         internal static readonly IReadOnlyList<(Type derivedType, Type baseType)> BASE_TYPE_MAPPING = new[]
         {
             (typeof(ChangeTeamRequest), typeof(MatchUserRequest)),
-            (typeof(MatchStartCountdownRequest), typeof(MatchUserRequest)),
+            (typeof(StartMatchCountdownRequest), typeof(MatchUserRequest)),
             (typeof(StopCountdownRequest), typeof(MatchUserRequest)),
             (typeof(CountdownChangedEvent), typeof(MatchServerEvent)),
             (typeof(TeamVersusRoomState), typeof(MatchRoomState)),
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
index f9f070f17a..381c5ea712 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
@@ -161,7 +161,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
             Debug.Assert(clickOperation == null);
             clickOperation = ongoingOperationTracker.BeginOperation();
 
-            Client.SendMatchRequest(new MatchStartCountdownRequest { Delay = duration }).ContinueWith(_ => endOperation());
+            Client.SendMatchRequest(new StartMatchCountdownRequest { Delay = duration }).ContinueWith(_ => endOperation());
         }
 
         private void endOperation()
diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
index a1ae1aa171..4066cd0c4a 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
@@ -309,7 +309,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             switch (request)
             {
-                case MatchStartCountdownRequest matchCountdownRequest:
+                case StartMatchCountdownRequest matchCountdownRequest:
                     countdownStopSource?.Cancel();
 
                     var stopSource = countdownStopSource = new CancellationTokenSource();

From fc576b1369c74457c1e673000fb44f4acc7291ba Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 18 Mar 2022 15:22:00 +0300
Subject: [PATCH 3545/5547] Separate increase/break combo helper methods from
 `AffectsCombo`

---
 osu.Game/Rulesets/Scoring/HitResult.cs | 26 +++++++++++++++++++++++---
 1 file changed, 23 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Rulesets/Scoring/HitResult.cs b/osu.Game/Rulesets/Scoring/HitResult.cs
index 514232db69..decd04967f 100644
--- a/osu.Game/Rulesets/Scoring/HitResult.cs
+++ b/osu.Game/Rulesets/Scoring/HitResult.cs
@@ -122,19 +122,33 @@ namespace osu.Game.Rulesets.Scoring
     public static class HitResultExtensions
     {
         /// <summary>
-        /// Whether a <see cref="HitResult"/> increases/decreases the combo, and affects the combo portion of the score.
+        /// Whether a <see cref="HitResult"/> increases the combo.
         /// </summary>
-        public static bool AffectsCombo(this HitResult result)
+        public static bool IncreasesCombo(this HitResult result)
         {
             switch (result)
             {
-                case HitResult.Miss:
                 case HitResult.Meh:
                 case HitResult.Ok:
                 case HitResult.Good:
                 case HitResult.Great:
                 case HitResult.Perfect:
                 case HitResult.LargeTickHit:
+                    return true;
+
+                default:
+                    return false;
+            }
+        }
+
+        /// <summary>
+        /// Whether a <see cref="HitResult"/> breaks the combo and resets it back to zero.
+        /// </summary>
+        public static bool BreaksCombo(this HitResult result)
+        {
+            switch (result)
+            {
+                case HitResult.Miss:
                 case HitResult.LargeTickMiss:
                     return true;
 
@@ -143,6 +157,12 @@ namespace osu.Game.Rulesets.Scoring
             }
         }
 
+        /// <summary>
+        /// Whether a <see cref="HitResult"/> increases/breaks the combo, and affects the combo portion of the score.
+        /// </summary>
+        public static bool AffectsCombo(this HitResult result)
+            => IncreasesCombo(result) || BreaksCombo(result);
+
         /// <summary>
         /// Whether a <see cref="HitResult"/> affects the accuracy portion of the score.
         /// </summary>

From 5ec2d86c094e26f1c2663047ba895c47271b9d6c Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 18 Mar 2022 15:22:53 +0300
Subject: [PATCH 3546/5547] Update `ScoreProcessor` to use new defined helper
 methods

---
 osu.Game/Rulesets/Scoring/ScoreProcessor.cs | 18 ++++--------------
 1 file changed, 4 insertions(+), 14 deletions(-)

diff --git a/osu.Game/Rulesets/Scoring/ScoreProcessor.cs b/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
index 0c585fac98..1e268bb2eb 100644
--- a/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
+++ b/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
@@ -166,20 +166,10 @@ namespace osu.Game.Rulesets.Scoring
             if (!result.Type.IsScorable())
                 return;
 
-            if (result.Type.AffectsCombo())
-            {
-                switch (result.Type)
-                {
-                    case HitResult.Miss:
-                    case HitResult.LargeTickMiss:
-                        Combo.Value = 0;
-                        break;
-
-                    default:
-                        Combo.Value++;
-                        break;
-                }
-            }
+            if (result.Type.IncreasesCombo())
+                Combo.Value++;
+            else if (result.Type.BreaksCombo())
+                Combo.Value = 0;
 
             double scoreIncrease = result.Type.IsHit() ? result.Judgement.NumericResultFor(result) : 0;
 

From fa8eb1feec1cf57e8965a12684b4170c6c60ca9a Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 18 Mar 2022 15:23:14 +0300
Subject: [PATCH 3547/5547] Update score panel to check for all combo-breaking
 statistics

---
 .../Screens/Ranking/Expanded/ExpandedPanelMiddleContent.cs  | 6 +-----
 1 file changed, 1 insertion(+), 5 deletions(-)

diff --git a/osu.Game/Screens/Ranking/Expanded/ExpandedPanelMiddleContent.cs b/osu.Game/Screens/Ranking/Expanded/ExpandedPanelMiddleContent.cs
index fb8a1beb04..1b1aa3a684 100644
--- a/osu.Game/Screens/Ranking/Expanded/ExpandedPanelMiddleContent.cs
+++ b/osu.Game/Screens/Ranking/Expanded/ExpandedPanelMiddleContent.cs
@@ -65,14 +65,10 @@ namespace osu.Game.Screens.Ranking.Expanded
             var metadata = beatmap.BeatmapSet?.Metadata ?? beatmap.Metadata;
             string creator = metadata.Author.Username;
 
-            bool isPerfect = true;
-            isPerfect &= !score.Statistics.TryGetValue(HitResult.Miss, out int missCount) || missCount == 0;
-            isPerfect &= !score.Statistics.TryGetValue(HitResult.LargeTickMiss, out int largeTickMissCount) || largeTickMissCount == 0;
-
             var topStatistics = new List<StatisticDisplay>
             {
                 new AccuracyStatistic(score.Accuracy),
-                new ComboStatistic(score.MaxCombo, beatmap.MaxCombo, isPerfect),
+                new ComboStatistic(score.MaxCombo, beatmap.MaxCombo, score.Statistics.All(stat => !stat.Key.BreaksCombo() || stat.Value == 0)),
                 new PerformanceStatistic(score),
             };
 

From 8078a8c1f8b21709d3741e9dcb83636fecb295a9 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 18 Mar 2022 17:18:42 +0300
Subject: [PATCH 3548/5547] Simplify `IncreasesCombo`/`BreaksCombo` helper
 method implementation

---
 osu.Game/Rulesets/Scoring/HitResult.cs | 34 ++++++++++----------------
 1 file changed, 13 insertions(+), 21 deletions(-)

diff --git a/osu.Game/Rulesets/Scoring/HitResult.cs b/osu.Game/Rulesets/Scoring/HitResult.cs
index decd04967f..9f03c381ee 100644
--- a/osu.Game/Rulesets/Scoring/HitResult.cs
+++ b/osu.Game/Rulesets/Scoring/HitResult.cs
@@ -125,30 +125,28 @@ namespace osu.Game.Rulesets.Scoring
         /// Whether a <see cref="HitResult"/> increases the combo.
         /// </summary>
         public static bool IncreasesCombo(this HitResult result)
+            => AffectsCombo(result) && IsHit(result);
+
+        /// <summary>
+        /// Whether a <see cref="HitResult"/> breaks the combo and resets it back to zero.
+        /// </summary>
+        public static bool BreaksCombo(this HitResult result)
+            => AffectsCombo(result) && !IsHit(result);
+
+        /// <summary>
+        /// Whether a <see cref="HitResult"/> increases/breaks the combo, and affects the combo portion of the score.
+        /// </summary>
+        public static bool AffectsCombo(this HitResult result)
         {
             switch (result)
             {
+                case HitResult.Miss:
                 case HitResult.Meh:
                 case HitResult.Ok:
                 case HitResult.Good:
                 case HitResult.Great:
                 case HitResult.Perfect:
                 case HitResult.LargeTickHit:
-                    return true;
-
-                default:
-                    return false;
-            }
-        }
-
-        /// <summary>
-        /// Whether a <see cref="HitResult"/> breaks the combo and resets it back to zero.
-        /// </summary>
-        public static bool BreaksCombo(this HitResult result)
-        {
-            switch (result)
-            {
-                case HitResult.Miss:
                 case HitResult.LargeTickMiss:
                     return true;
 
@@ -157,12 +155,6 @@ namespace osu.Game.Rulesets.Scoring
             }
         }
 
-        /// <summary>
-        /// Whether a <see cref="HitResult"/> increases/breaks the combo, and affects the combo portion of the score.
-        /// </summary>
-        public static bool AffectsCombo(this HitResult result)
-            => IncreasesCombo(result) || BreaksCombo(result);
-
         /// <summary>
         /// Whether a <see cref="HitResult"/> affects the accuracy portion of the score.
         /// </summary>

From faa36c78e5c2c0fc80bd25ba12c82f1213fefeb2 Mon Sep 17 00:00:00 2001
From: hwabis <kennysun23@gmail.com>
Date: Fri, 18 Mar 2022 12:55:00 -0400
Subject: [PATCH 3549/5547] put count and tabs into new fillflowcontainer

---
 .../Match/Playlist/MultiplayerPlaylist.cs     | 34 ++++++++++++++-----
 1 file changed, 25 insertions(+), 9 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylist.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylist.cs
index edd6cf93e9..2b59452ff1 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylist.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylist.cs
@@ -12,6 +12,7 @@ using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Rooms;
+using osuTK;
 
 namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist
 {
@@ -34,23 +35,38 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist
         private OsuSpriteText queueListCount;
 
         [BackgroundDependencyLoader]
-        private void load()
+        private void load(OsuColour osuColour)
         {
             const float tab_control_height = 25;
 
             InternalChildren = new Drawable[]
             {
-                new OsuTabControl<MultiplayerPlaylistDisplayMode>
+                new FillFlowContainer
                 {
-                    RelativeSizeAxes = Axes.X,
-                    Height = tab_control_height,
-                    Current = { BindTarget = DisplayMode }
-                },
-                queueListCount = new OsuSpriteText
-                {
-                    Font = OsuFont.Default.With(weight: FontWeight.Bold),
                     Anchor = Anchor.TopCentre,
                     Origin = Anchor.TopCentre,
+                    Direction = FillDirection.Horizontal,
+                    RelativeSizeAxes = Axes.X,
+                    AutoSizeAxes = Axes.Y,
+                    Spacing = new Vector2(OsuTabControl<MultiplayerPlaylistDisplayMode>.HORIZONTAL_SPACING, 0),
+                    Children = new Drawable[]
+                    {
+                        queueListCount = new OsuSpriteText
+                        {
+                            Font = OsuFont.Default.With(weight: FontWeight.Bold),
+                            Anchor = Anchor.CentreLeft,
+                            Origin = Anchor.CentreLeft,
+                            Colour = osuColour.Yellow,
+                        },
+                        new OsuTabControl<MultiplayerPlaylistDisplayMode>
+                        {
+                            RelativeSizeAxes = Axes.X,
+                            Height = tab_control_height,
+                            Anchor = Anchor.CentreLeft,
+                            Origin = Anchor.CentreLeft,
+                            Current = { BindTarget = DisplayMode },
+                        },
+                    }
                 },
                 new Container
                 {

From b4a8defe1a1efce18553c2d469438be0ec15b8d8 Mon Sep 17 00:00:00 2001
From: Noah M <noahcodes@protonmail.com>
Date: Fri, 18 Mar 2022 14:12:36 -0500
Subject: [PATCH 3550/5547] Make Relax and Aim assist mods incompatible

---
 osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs | 2 +-
 osu.Game.Rulesets.Osu/Mods/OsuModRelax.cs     | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs b/osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs
index ed4b139e00..1abbd67d8f 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs
@@ -24,7 +24,7 @@ namespace osu.Game.Rulesets.Osu.Mods
         public override ModType Type => ModType.Fun;
         public override string Description => "No need to chase the circle – the circle chases you!";
         public override double ScoreMultiplier => 1;
-        public override Type[] IncompatibleMods => new[] { typeof(OsuModAutopilot), typeof(OsuModWiggle), typeof(OsuModTransform), typeof(ModAutoplay) };
+        public override Type[] IncompatibleMods => new[] { typeof(OsuModAutopilot), typeof(OsuModWiggle), typeof(OsuModTransform), typeof(ModAutoplay), typeof(OsuModRelax) };
 
         private IFrameStableClock gameplayClock;
 
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModRelax.cs b/osu.Game.Rulesets.Osu/Mods/OsuModRelax.cs
index 1bf63ef6d4..09a33e1ed9 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModRelax.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModRelax.cs
@@ -19,7 +19,7 @@ namespace osu.Game.Rulesets.Osu.Mods
     public class OsuModRelax : ModRelax, IUpdatableByPlayfield, IApplicableToDrawableRuleset<OsuHitObject>, IApplicableToPlayer
     {
         public override string Description => @"You don't need to click. Give your clicking/tapping fingers a break from the heat of things.";
-        public override Type[] IncompatibleMods => base.IncompatibleMods.Append(typeof(OsuModAutopilot)).ToArray();
+        public override Type[] IncompatibleMods => base.IncompatibleMods.Append(typeof(OsuModAutopilot)).Append(typeof(OsuModAimAssist)).ToArray();
 
         /// <summary>
         /// How early before a hitobject's start time to trigger a hit.

From 78869c462a8be7606f5d42ce1f978f120d5d5f19 Mon Sep 17 00:00:00 2001
From: Noah M <10090332+Sublimelime@users.noreply.github.com>
Date: Fri, 18 Mar 2022 14:24:36 -0500
Subject: [PATCH 3551/5547] Use `.Concat()` instead of chained Append
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.Osu/Mods/OsuModRelax.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModRelax.cs b/osu.Game.Rulesets.Osu/Mods/OsuModRelax.cs
index 09a33e1ed9..9719de441e 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModRelax.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModRelax.cs
@@ -19,7 +19,7 @@ namespace osu.Game.Rulesets.Osu.Mods
     public class OsuModRelax : ModRelax, IUpdatableByPlayfield, IApplicableToDrawableRuleset<OsuHitObject>, IApplicableToPlayer
     {
         public override string Description => @"You don't need to click. Give your clicking/tapping fingers a break from the heat of things.";
-        public override Type[] IncompatibleMods => base.IncompatibleMods.Append(typeof(OsuModAutopilot)).Append(typeof(OsuModAimAssist)).ToArray();
+        public override Type[] IncompatibleMods => base.IncompatibleMods.Concat(new[] { typeof(OsuModAutopilot), typeof(OsuModAimAssist) }).ToArray();
 
         /// <summary>
         /// How early before a hitobject's start time to trigger a hit.

From c07a906b224d5921800e0c5d1fe54cdfa5986945 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sat, 19 Mar 2022 02:27:40 +0300
Subject: [PATCH 3552/5547] Rewrite log attachment section
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>
---
 .github/ISSUE_TEMPLATE/bug-issue.yml | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/.github/ISSUE_TEMPLATE/bug-issue.yml b/.github/ISSUE_TEMPLATE/bug-issue.yml
index 542d0dccaf..84b77fc298 100644
--- a/.github/ISSUE_TEMPLATE/bug-issue.yml
+++ b/.github/ISSUE_TEMPLATE/bug-issue.yml
@@ -44,25 +44,25 @@ body:
   - type: markdown
     attributes:
       value: |
-        ## Logs attachments
+        ## Logs
 
-        Logs are necessary to further investigate this bug. They are reset every new game session, so you need to ensure the logs are preserved by not starting/restarting osu! after encountering the bug.
+        Attaching log files is required for every reported bug. Instructions how to find the log files are listed below.
 
-        In the case this isn't a "Crash to Desktop" report, to retrieve logs:
+        If the game has not yet been closed since you found the bug:
           1. Head on to game settings and click on "Open osu! folder"
           2. Then open the `logs` folder located there
 
-        Otherwise, logs can *only* be retrieved via file explorer, as running the game will reset them.
+        If the game crashed or has been closed since you found the bug, **do not** restart the game to retrieve the logs as they will reset. You must find them using the file explorer.
 
-        Logs are, by default, located at:
+        By default logs can be found in:
           - `%AppData%/osu/logs` *(on Windows),*
           - `~/.local/share/osu/logs` *(on Linux & macOS).*
           - `Android/data/sh.ppy.osulazer/files/logs` *(on Android)*,
           - on iOS they can be obtained by connecting your device to your desktop and copying the `logs` directory from the app's own document storage using iTunes. (https://support.apple.com/en-us/HT201301#copy-to-computer)
 
-        If you have relocated your game folder, head into that location and open the `logs` folder.
+        However, if you have selected a custom location for the game files via settings, you must find that custom folder and open the `logs` folder there.
 
-        Finally, select all log files and drag them into the "Logs" box below.
+        After locating the `logs` folder, select all log files inside and drag them into the "Logs" box below.
 
   - type: textarea
     attributes:

From d9b2a29c6d6d90fc568afff257652779f1e401e1 Mon Sep 17 00:00:00 2001
From: hwabis <kennysun23@gmail.com>
Date: Fri, 18 Mar 2022 20:02:26 -0400
Subject: [PATCH 3553/5547] (not working yet) add
 MultiplayerPlaylistTabControl, "Queue ({count})"

---
 .../Match/Playlist/MultiplayerPlaylist.cs     | 36 ++++---------------
 .../Playlist/MultiplayerPlaylistTabControl.cs | 34 ++++++++++++++++++
 2 files changed, 40 insertions(+), 30 deletions(-)
 create mode 100644 osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylistTabControl.cs

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylist.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylist.cs
index 2b59452ff1..c65ff1bd00 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylist.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylist.cs
@@ -8,11 +8,8 @@ using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Graphics;
-using osu.Game.Graphics.Sprites;
-using osu.Game.Graphics.UserInterface;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Rooms;
-using osuTK;
 
 namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist
 {
@@ -32,41 +29,20 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist
         private MultiplayerHistoryList historyList;
         private bool firstPopulation = true;
 
-        private OsuSpriteText queueListCount;
+        private MultiplayerPlaylistTabControl playlistTabControl;
 
         [BackgroundDependencyLoader]
-        private void load(OsuColour osuColour)
+        private void load()
         {
             const float tab_control_height = 25;
 
             InternalChildren = new Drawable[]
             {
-                new FillFlowContainer
+                playlistTabControl = new MultiplayerPlaylistTabControl
                 {
-                    Anchor = Anchor.TopCentre,
-                    Origin = Anchor.TopCentre,
-                    Direction = FillDirection.Horizontal,
                     RelativeSizeAxes = Axes.X,
-                    AutoSizeAxes = Axes.Y,
-                    Spacing = new Vector2(OsuTabControl<MultiplayerPlaylistDisplayMode>.HORIZONTAL_SPACING, 0),
-                    Children = new Drawable[]
-                    {
-                        queueListCount = new OsuSpriteText
-                        {
-                            Font = OsuFont.Default.With(weight: FontWeight.Bold),
-                            Anchor = Anchor.CentreLeft,
-                            Origin = Anchor.CentreLeft,
-                            Colour = osuColour.Yellow,
-                        },
-                        new OsuTabControl<MultiplayerPlaylistDisplayMode>
-                        {
-                            RelativeSizeAxes = Axes.X,
-                            Height = tab_control_height,
-                            Anchor = Anchor.CentreLeft,
-                            Origin = Anchor.CentreLeft,
-                            Current = { BindTarget = DisplayMode },
-                        },
-                    }
+                    Height = tab_control_height,
+                    Current = { BindTarget = DisplayMode },
                 },
                 new Container
                 {
@@ -97,7 +73,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist
             base.LoadComplete();
             DisplayMode.BindValueChanged(onDisplayModeChanged, true);
             queueList.Items.BindCollectionChanged(
-                (_, __) => queueListCount.Text = queueList.Items.Count.ToString(), true);
+                (_, __) => playlistTabControl.queueListCount = queueList.Items.Count, true);
         }
 
         private void onDisplayModeChanged(ValueChangedEvent<MultiplayerPlaylistDisplayMode> mode)
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylistTabControl.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylistTabControl.cs
new file mode 100644
index 0000000000..f6a5bfed41
--- /dev/null
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylistTabControl.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 osu.Framework.Graphics.UserInterface;
+using osu.Game.Graphics.UserInterface;
+
+namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist
+{
+    public class MultiplayerPlaylistTabControl : OsuTabControl<MultiplayerPlaylistDisplayMode>
+    {
+        public int queueListCount;
+
+        public MultiplayerPlaylistTabControl()
+        {
+            queueListCount = 0;
+        }
+
+        protected override TabItem<MultiplayerPlaylistDisplayMode> CreateTabItem(MultiplayerPlaylistDisplayMode value)
+        {
+            if (value == MultiplayerPlaylistDisplayMode.Queue)
+                return new QueueTabItem(value, queueListCount);
+            return new OsuTabItem(value);
+        }
+
+        private class QueueTabItem : OsuTabItem
+        {
+            public QueueTabItem(MultiplayerPlaylistDisplayMode value, int count)
+                : base(value)
+            {
+                Text.Text += " (" + count + ")";
+            }
+        }
+    }
+}

From 7bb8cd5411a06b8483552bea7eba617486b2c14e Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sat, 19 Mar 2022 03:22:57 +0300
Subject: [PATCH 3554/5547] Apply second pass rewordings on logs section

Co-authored-by: Walavouchey <36758269+Walavouchey@users.noreply.github.com>
---
 .github/ISSUE_TEMPLATE/bug-issue.yml | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/.github/ISSUE_TEMPLATE/bug-issue.yml b/.github/ISSUE_TEMPLATE/bug-issue.yml
index 84b77fc298..95c7a089c8 100644
--- a/.github/ISSUE_TEMPLATE/bug-issue.yml
+++ b/.github/ISSUE_TEMPLATE/bug-issue.yml
@@ -46,21 +46,21 @@ body:
       value: |
         ## Logs
 
-        Attaching log files is required for every reported bug. Instructions how to find the log files are listed below.
+        Attaching log files is required for every reported bug. See instructions below on how to find them.
 
         If the game has not yet been closed since you found the bug:
           1. Head on to game settings and click on "Open osu! folder"
           2. Then open the `logs` folder located there
 
-        If the game crashed or has been closed since you found the bug, **do not** restart the game to retrieve the logs as they will reset. You must find them using the file explorer.
+        **Logs are reset when you reopen the game.** If the game crashed or has been closed since you found the bug, retrieve the logs using the file explorer instead.
 
         By default logs can be found in:
-          - `%AppData%/osu/logs` *(on Windows),*
-          - `~/.local/share/osu/logs` *(on Linux & macOS).*
-          - `Android/data/sh.ppy.osulazer/files/logs` *(on Android)*,
+          - `%AppData%/osu/logs` *(on Windows)*
+          - `~/.local/share/osu/logs` *(on Linux & macOS)*
+          - `Android/data/sh.ppy.osulazer/files/logs` *(on Android)*
           - on iOS they can be obtained by connecting your device to your desktop and copying the `logs` directory from the app's own document storage using iTunes. (https://support.apple.com/en-us/HT201301#copy-to-computer)
 
-        However, if you have selected a custom location for the game files via settings, you must find that custom folder and open the `logs` folder there.
+        If you have selected a custom location for the game files, you can find the `logs` folder there.
 
         After locating the `logs` folder, select all log files inside and drag them into the "Logs" box below.
 

From 5e5fbc496ed25fd66029305c1665e0d23bb59759 Mon Sep 17 00:00:00 2001
From: hwabis <kennysun23@gmail.com>
Date: Fri, 18 Mar 2022 20:32:37 -0400
Subject: [PATCH 3555/5547] (still not working) try bindables instead of int

---
 .../Match/Playlist/MultiplayerPlaylist.cs            |  2 +-
 .../Match/Playlist/MultiplayerPlaylistTabControl.cs  | 12 ++++++++----
 2 files changed, 9 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylist.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylist.cs
index c65ff1bd00..a1feda9000 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylist.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylist.cs
@@ -73,7 +73,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist
             base.LoadComplete();
             DisplayMode.BindValueChanged(onDisplayModeChanged, true);
             queueList.Items.BindCollectionChanged(
-                (_, __) => playlistTabControl.queueListCount = queueList.Items.Count, true);
+                (_, __) => playlistTabControl.queueListCount.Value = queueList.Items.Count, true);
         }
 
         private void onDisplayModeChanged(ValueChangedEvent<MultiplayerPlaylistDisplayMode> mode)
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylistTabControl.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylistTabControl.cs
index f6a5bfed41..a459ec6f80 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylistTabControl.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylistTabControl.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.Bindables;
 using osu.Framework.Graphics.UserInterface;
 using osu.Game.Graphics.UserInterface;
 
@@ -8,11 +9,10 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist
 {
     public class MultiplayerPlaylistTabControl : OsuTabControl<MultiplayerPlaylistDisplayMode>
     {
-        public int queueListCount;
+        public Bindable<int> queueListCount = new Bindable<int>(0);
 
         public MultiplayerPlaylistTabControl()
         {
-            queueListCount = 0;
         }
 
         protected override TabItem<MultiplayerPlaylistDisplayMode> CreateTabItem(MultiplayerPlaylistDisplayMode value)
@@ -24,10 +24,14 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist
 
         private class QueueTabItem : OsuTabItem
         {
-            public QueueTabItem(MultiplayerPlaylistDisplayMode value, int count)
+            private Bindable<int> count;
+
+            public QueueTabItem(MultiplayerPlaylistDisplayMode value, Bindable<int> queueListCount)
                 : base(value)
             {
-                Text.Text += " (" + count + ")";
+                count = new Bindable<int>();
+                count.BindTo(queueListCount);
+                Text.Text += " (" + count.Value + ")";
             }
         }
     }

From 744cd6164379e2498704d56808408b09dac2d915 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sat, 19 Mar 2022 03:33:13 +0300
Subject: [PATCH 3556/5547] Apply further minor rewordings

Co-authored-by: Walavouchey <36758269+Walavouchey@users.noreply.github.com>
---
 .github/ISSUE_TEMPLATE/bug-issue.yml | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/.github/ISSUE_TEMPLATE/bug-issue.yml b/.github/ISSUE_TEMPLATE/bug-issue.yml
index 95c7a089c8..882b0bf6bf 100644
--- a/.github/ISSUE_TEMPLATE/bug-issue.yml
+++ b/.github/ISSUE_TEMPLATE/bug-issue.yml
@@ -54,11 +54,11 @@ body:
 
         **Logs are reset when you reopen the game.** If the game crashed or has been closed since you found the bug, retrieve the logs using the file explorer instead.
 
-        By default logs can be found in:
-          - `%AppData%/osu/logs` *(on Windows)*
-          - `~/.local/share/osu/logs` *(on Linux & macOS)*
-          - `Android/data/sh.ppy.osulazer/files/logs` *(on Android)*
-          - on iOS they can be obtained by connecting your device to your desktop and copying the `logs` directory from the app's own document storage using iTunes. (https://support.apple.com/en-us/HT201301#copy-to-computer)
+        The default places to find the logs are as follows:
+          - `%AppData%/osu/logs` *on Windows*
+          - `~/.local/share/osu/logs` *on Linux & macOS*
+          - `Android/data/sh.ppy.osulazer/files/logs` *on Android*
+          - *On iOS*, they can be obtained by connecting your device to your desktop and copying the `logs` directory from the app's own document storage using iTunes. (https://support.apple.com/en-us/HT201301#copy-to-computer)
 
         If you have selected a custom location for the game files, you can find the `logs` folder there.
 

From 5a5629eb5a50b6d5d4987167ff564403d49835eb Mon Sep 17 00:00:00 2001
From: hwabis <kennysun23@gmail.com>
Date: Fri, 18 Mar 2022 20:47:45 -0400
Subject: [PATCH 3557/5547] (works now) use BindValueChanged to set the Queue
 text

---
 .../Match/Playlist/MultiplayerPlaylistTabControl.cs        | 7 ++-----
 1 file changed, 2 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylistTabControl.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylistTabControl.cs
index a459ec6f80..f0a51eb5e1 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylistTabControl.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylistTabControl.cs
@@ -24,14 +24,11 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist
 
         private class QueueTabItem : OsuTabItem
         {
-            private Bindable<int> count;
-
             public QueueTabItem(MultiplayerPlaylistDisplayMode value, Bindable<int> queueListCount)
                 : base(value)
             {
-                count = new Bindable<int>();
-                count.BindTo(queueListCount);
-                Text.Text += " (" + count.Value + ")";
+                queueListCount.BindValueChanged(
+                    _ => Text.Text = "Queue (" + queueListCount.Value + ")", true);
             }
         }
     }

From 0adad3a599904f62a9f7908ae85b678c1b83e0c8 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sat, 19 Mar 2022 04:01:35 +0300
Subject: [PATCH 3558/5547] Handle potential null room hosts

---
 .../OnlinePlay/Multiplayer/Participants/ParticipantsList.cs  | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantsList.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantsList.cs
index 6169ad6a9e..22c9940cd4 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantsList.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantsList.cs
@@ -66,8 +66,11 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Participants
                     if (currentHostPanel != null && panels.Contains(currentHostPanel))
                         panels.SetLayoutPosition(currentHostPanel, 0);
 
+                    currentHostPanel = null;
+
                     // Change position of new host to display above all participants.
-                    panels.SetLayoutPosition(currentHostPanel = panels.Single(u => u.User.Equals(Room.Host)), -1);
+                    if (Room.Host != null)
+                        panels.SetLayoutPosition(currentHostPanel = panels.SingleOrDefault(u => u.User.Equals(Room.Host)), -1);
                 }
             }
         }

From 5bcb7c167c5ae837be46f56752dd41c1236cec0b Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sat, 19 Mar 2022 05:02:20 +0300
Subject: [PATCH 3559/5547] Swap placements of "hold for menu" and key counter

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

diff --git a/osu.Game/Screens/Play/HUDOverlay.cs b/osu.Game/Screens/Play/HUDOverlay.cs
index 628452fbc8..9edcbf3e07 100644
--- a/osu.Game/Screens/Play/HUDOverlay.cs
+++ b/osu.Game/Screens/Play/HUDOverlay.cs
@@ -111,8 +111,11 @@ namespace osu.Game.Screens.Play
                     Direction = FillDirection.Vertical,
                     Children = new Drawable[]
                     {
-                        KeyCounter = CreateKeyCounter(),
                         HoldToQuit = CreateHoldForMenuButton(),
+                        KeyCounter = CreateKeyCounter().With(k =>
+                        {
+                            k.Margin = new MarginPadding { Horizontal = 10 };
+                        }),
                     }
                 }
             };
@@ -235,13 +238,11 @@ namespace osu.Game.Screens.Play
             {
                 PlayerSettingsOverlay.Show();
                 ModDisplay.FadeIn(200);
-                KeyCounter.Margin = new MarginPadding(10) { Bottom = 30 };
             }
             else
             {
                 PlayerSettingsOverlay.Hide();
                 ModDisplay.Delay(2000).FadeOut(200);
-                KeyCounter.Margin = new MarginPadding(10);
             }
 
             updateVisibility();

From 486be831778a6b57fdb210bfe9ce646b51c0c3b8 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sat, 19 Mar 2022 05:04:11 +0300
Subject: [PATCH 3560/5547] Calculate position adjustment distance in local
 parent space

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

diff --git a/osu.Game/Screens/Play/HUD/HoldForMenuButton.cs b/osu.Game/Screens/Play/HUD/HoldForMenuButton.cs
index 4087011933..065ed0dd5f 100644
--- a/osu.Game/Screens/Play/HUD/HoldForMenuButton.cs
+++ b/osu.Game/Screens/Play/HUD/HoldForMenuButton.cs
@@ -84,7 +84,7 @@ namespace osu.Game.Screens.Play.HUD
 
         protected override bool OnMouseMove(MouseMoveEvent e)
         {
-            positionalAdjust = Vector2.Distance(e.ScreenSpaceMousePosition, button.ScreenSpaceDrawQuad.Centre) / 200;
+            positionalAdjust = Vector2.Distance(e.MousePosition, button.ToSpaceOfOtherDrawable(button.DrawRectangle.Centre, Parent)) / 200;
             return base.OnMouseMove(e);
         }
 

From ad9b119e3dd85d4207c477da59ef45366936fde9 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sat, 19 Mar 2022 05:04:54 +0300
Subject: [PATCH 3561/5547] Reduce "hold for menu" radius of visibility

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

diff --git a/osu.Game/Screens/Play/HUD/HoldForMenuButton.cs b/osu.Game/Screens/Play/HUD/HoldForMenuButton.cs
index 065ed0dd5f..3da63ec2cc 100644
--- a/osu.Game/Screens/Play/HUD/HoldForMenuButton.cs
+++ b/osu.Game/Screens/Play/HUD/HoldForMenuButton.cs
@@ -84,7 +84,7 @@ namespace osu.Game.Screens.Play.HUD
 
         protected override bool OnMouseMove(MouseMoveEvent e)
         {
-            positionalAdjust = Vector2.Distance(e.MousePosition, button.ToSpaceOfOtherDrawable(button.DrawRectangle.Centre, Parent)) / 200;
+            positionalAdjust = Vector2.Distance(e.MousePosition, button.ToSpaceOfOtherDrawable(button.DrawRectangle.Centre, Parent)) / 100;
             return base.OnMouseMove(e);
         }
 

From 5d16519a822db2eda9d8759b0a27046bbe77e891 Mon Sep 17 00:00:00 2001
From: hwabis <kennysun23@gmail.com>
Date: Fri, 18 Mar 2022 23:41:55 -0400
Subject: [PATCH 3562/5547] make code prettier

---
 .../Multiplayer/Match/Playlist/MultiplayerPlaylist.cs       | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylist.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylist.cs
index a1feda9000..3269257260 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylist.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylist.cs
@@ -7,7 +7,6 @@ using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
-using osu.Game.Graphics;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Rooms;
 
@@ -25,12 +24,11 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist
         /// </summary>
         public Action<PlaylistItem> RequestEdit;
 
+        private MultiplayerPlaylistTabControl playlistTabControl;
         private MultiplayerQueueList queueList;
         private MultiplayerHistoryList historyList;
         private bool firstPopulation = true;
 
-        private MultiplayerPlaylistTabControl playlistTabControl;
-
         [BackgroundDependencyLoader]
         private void load()
         {
@@ -42,7 +40,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist
                 {
                     RelativeSizeAxes = Axes.X,
                     Height = tab_control_height,
-                    Current = { BindTarget = DisplayMode },
+                    Current = { BindTarget = DisplayMode }
                 },
                 new Container
                 {

From 79f6e7cc1ce8723c26e30c5acb475d02b2befbad Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 19 Mar 2022 12:42:25 +0900
Subject: [PATCH 3563/5547] Simplify wording of description hint
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>
---
 .github/ISSUE_TEMPLATE/bug-issue.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/ISSUE_TEMPLATE/bug-issue.yml b/.github/ISSUE_TEMPLATE/bug-issue.yml
index 882b0bf6bf..0174a0d47f 100644
--- a/.github/ISSUE_TEMPLATE/bug-issue.yml
+++ b/.github/ISSUE_TEMPLATE/bug-issue.yml
@@ -25,7 +25,7 @@ body:
   - type: textarea
     attributes:
       label: Bug description
-      description: What are the steps for reproducing the bug? Any additional details that might be of help?
+      description: How did you find the bug? Any additional details that might help?
     validations:
       required: true
   - type: textarea

From 762385d336273e719b5a7f2930225b9350fcac09 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 19 Mar 2022 12:43:08 +0900
Subject: [PATCH 3564/5547] Simplify log drag-drop message
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>
---
 .github/ISSUE_TEMPLATE/bug-issue.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/ISSUE_TEMPLATE/bug-issue.yml b/.github/ISSUE_TEMPLATE/bug-issue.yml
index 0174a0d47f..a8b02b32ee 100644
--- a/.github/ISSUE_TEMPLATE/bug-issue.yml
+++ b/.github/ISSUE_TEMPLATE/bug-issue.yml
@@ -67,6 +67,6 @@ body:
   - type: textarea
     attributes:
       label: Logs
-      placeholder: You can attach by dragging and dropping the log files into this box.
+      placeholder: Drag and drop the log files into this box.
     validations:
       required: true

From 41ab798bbe1c0daf9f634904ec16b6658b0a425c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 19 Mar 2022 12:43:48 +0900
Subject: [PATCH 3565/5547] Simplify screenshot/video attach text
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>
---
 .github/ISSUE_TEMPLATE/bug-issue.yml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/ISSUE_TEMPLATE/bug-issue.yml b/.github/ISSUE_TEMPLATE/bug-issue.yml
index a8b02b32ee..5b19c3732c 100644
--- a/.github/ISSUE_TEMPLATE/bug-issue.yml
+++ b/.github/ISSUE_TEMPLATE/bug-issue.yml
@@ -31,8 +31,8 @@ body:
   - type: textarea
     attributes:
       label: Screenshots or videos
-      description: Share any kind of visuals you can which show the bug or issue taking place.
-      placeholder: You can attach by dragging and dropping the screenshots/videos into this box.
+      description: Add screenshots or videos that show the bug here.
+      placeholder: Drag and drop the screenshots/videos into this box.
     validations:
       required: false
   - type: input

From b99541fb5e3fccd2235bd40027ba8545e33d92ee Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sat, 19 Mar 2022 08:08:07 +0300
Subject: [PATCH 3566/5547] Revert "Swap placements of "hold for menu" and key
 counter"

This reverts commit 5bcb7c167c5ae837be46f56752dd41c1236cec0b.
---
 osu.Game/Screens/Play/HUDOverlay.cs | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Screens/Play/HUDOverlay.cs b/osu.Game/Screens/Play/HUDOverlay.cs
index 9edcbf3e07..628452fbc8 100644
--- a/osu.Game/Screens/Play/HUDOverlay.cs
+++ b/osu.Game/Screens/Play/HUDOverlay.cs
@@ -111,11 +111,8 @@ namespace osu.Game.Screens.Play
                     Direction = FillDirection.Vertical,
                     Children = new Drawable[]
                     {
+                        KeyCounter = CreateKeyCounter(),
                         HoldToQuit = CreateHoldForMenuButton(),
-                        KeyCounter = CreateKeyCounter().With(k =>
-                        {
-                            k.Margin = new MarginPadding { Horizontal = 10 };
-                        }),
                     }
                 }
             };
@@ -238,11 +235,13 @@ namespace osu.Game.Screens.Play
             {
                 PlayerSettingsOverlay.Show();
                 ModDisplay.FadeIn(200);
+                KeyCounter.Margin = new MarginPadding(10) { Bottom = 30 };
             }
             else
             {
                 PlayerSettingsOverlay.Hide();
                 ModDisplay.Delay(2000).FadeOut(200);
+                KeyCounter.Margin = new MarginPadding(10);
             }
 
             updateVisibility();

From da76358ee0530e4c5303cefc3c782ab051ec094f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 17 Mar 2022 19:23:43 +0900
Subject: [PATCH 3567/5547] Expose the loading player in `PlayerLoader`

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

diff --git a/osu.Game/Screens/Play/PlayerLoader.cs b/osu.Game/Screens/Play/PlayerLoader.cs
index 41eb822e39..384561d616 100644
--- a/osu.Game/Screens/Play/PlayerLoader.cs
+++ b/osu.Game/Screens/Play/PlayerLoader.cs
@@ -90,7 +90,7 @@ namespace osu.Game.Screens.Play
         private bool readyForPush =>
             !playerConsumed
             // don't push unless the player is completely loaded
-            && player?.LoadState == LoadState.Ready
+            && CurrentPlayer?.LoadState == LoadState.Ready
             // don't push if the user is hovering one of the panes, unless they are idle.
             && (IsHovered || idleTracker.IsIdle.Value)
             // don't push if the user is dragging a slider or otherwise.
@@ -100,10 +100,14 @@ namespace osu.Game.Screens.Play
 
         private readonly Func<Player> createPlayer;
 
-        private Player player;
+        /// <summary>
+        /// The <see cref="Player"/> instance being loaded by this screen.
+        /// </summary>
+        [CanBeNull]
+        public Player CurrentPlayer { get; private set; }
 
         /// <summary>
-        /// Whether the curent player instance has been consumed via <see cref="consumePlayer"/>.
+        /// Whether the current player instance has been consumed via <see cref="consumePlayer"/>.
         /// </summary>
         private bool playerConsumed;
 
@@ -237,12 +241,12 @@ namespace osu.Game.Screens.Play
         {
             base.OnResuming(last);
 
-            var lastScore = player.Score;
+            var lastScore = CurrentPlayer.Score;
 
             AudioSettings.ReferenceScore.Value = lastScore?.ScoreInfo;
 
             // prepare for a retry.
-            player = null;
+            CurrentPlayer = null;
             playerConsumed = false;
             cancelLoad();
 
@@ -346,7 +350,7 @@ namespace osu.Game.Screens.Play
             Debug.Assert(!playerConsumed);
 
             playerConsumed = true;
-            return player;
+            return CurrentPlayer;
         }
 
         private void prepareNewPlayer()
@@ -354,11 +358,11 @@ namespace osu.Game.Screens.Play
             if (!this.IsCurrentScreen())
                 return;
 
-            player = createPlayer();
-            player.RestartCount = restartCount++;
-            player.RestartRequested = restartRequested;
+            CurrentPlayer = createPlayer();
+            CurrentPlayer.RestartCount = restartCount++;
+            CurrentPlayer.RestartRequested = restartRequested;
 
-            LoadTask = LoadComponentAsync(player, _ => MetadataInfo.Loading = false);
+            LoadTask = LoadComponentAsync(CurrentPlayer, _ => MetadataInfo.Loading = false);
         }
 
         private void restartRequested()
@@ -472,7 +476,7 @@ namespace osu.Game.Screens.Play
             if (isDisposing)
             {
                 // if the player never got pushed, we should explicitly dispose it.
-                DisposalTask = LoadTask?.ContinueWith(_ => player?.Dispose());
+                DisposalTask = LoadTask?.ContinueWith(_ => CurrentPlayer?.Dispose());
             }
         }
 

From dae5569e367acdacc1f6ee2c6f0f7c80da15762d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 17 Mar 2022 19:36:33 +0900
Subject: [PATCH 3568/5547] Use `nullable` in `PlayerLoader`

---
 osu.Game/Screens/Play/PlayerLoader.cs | 54 ++++++++++++++-------------
 1 file changed, 28 insertions(+), 26 deletions(-)

diff --git a/osu.Game/Screens/Play/PlayerLoader.cs b/osu.Game/Screens/Play/PlayerLoader.cs
index 384561d616..ba720af2a1 100644
--- a/osu.Game/Screens/Play/PlayerLoader.cs
+++ b/osu.Game/Screens/Play/PlayerLoader.cs
@@ -1,10 +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 enable
+
 using System;
 using System.Diagnostics;
 using System.Threading.Tasks;
-using JetBrains.Annotations;
 using ManagedBass.Fx;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
@@ -48,31 +49,31 @@ namespace osu.Game.Screens.Play
         public override bool HandlePositionalInput => true;
 
         // We show the previous screen status
-        protected override UserActivity InitialActivity => null;
+        protected override UserActivity? InitialActivity => null;
 
         protected override bool PlayResumeSound => false;
 
-        protected BeatmapMetadataDisplay MetadataInfo { get; private set; }
+        protected BeatmapMetadataDisplay MetadataInfo { get; private set; } = null!;
 
         /// <summary>
         /// A fill flow containing the player settings groups, exposed for the ability to hide it from inheritors of the player loader.
         /// </summary>
-        protected FillFlowContainer<PlayerSettingsGroup> PlayerSettings { get; private set; }
+        protected FillFlowContainer<PlayerSettingsGroup> PlayerSettings { get; private set; } = null!;
 
-        protected VisualSettings VisualSettings { get; private set; }
+        protected VisualSettings VisualSettings { get; private set; } = null!;
 
-        protected AudioSettings AudioSettings { get; private set; }
+        protected AudioSettings AudioSettings { get; private set; } = null!;
 
-        protected Task LoadTask { get; private set; }
+        protected Task? LoadTask { get; private set; }
 
-        protected Task DisposalTask { get; private set; }
+        protected Task? DisposalTask { get; private set; }
 
         private bool backgroundBrightnessReduction;
 
         private readonly BindableDouble volumeAdjustment = new BindableDouble(1);
 
-        private AudioFilter lowPassFilter;
-        private AudioFilter highPassFilter;
+        private AudioFilter lowPassFilter = null!;
+        private AudioFilter highPassFilter = null!;
 
         protected bool BackgroundBrightnessReduction
         {
@@ -94,47 +95,45 @@ namespace osu.Game.Screens.Play
             // don't push if the user is hovering one of the panes, unless they are idle.
             && (IsHovered || idleTracker.IsIdle.Value)
             // don't push if the user is dragging a slider or otherwise.
-            && inputManager?.DraggedDrawable == null
+            && inputManager.DraggedDrawable == null
             // don't push if a focused overlay is visible, like settings.
-            && inputManager?.FocusedDrawable == null;
+            && inputManager.FocusedDrawable == null;
 
         private readonly Func<Player> createPlayer;
 
         /// <summary>
         /// The <see cref="Player"/> instance being loaded by this screen.
         /// </summary>
-        [CanBeNull]
-        public Player CurrentPlayer { get; private set; }
+        public Player? CurrentPlayer { get; private set; }
 
         /// <summary>
         /// Whether the current player instance has been consumed via <see cref="consumePlayer"/>.
         /// </summary>
         private bool playerConsumed;
 
-        private LogoTrackingContainer content;
+        private LogoTrackingContainer content = null!;
 
         private bool hideOverlays;
 
-        private InputManager inputManager;
+        private InputManager inputManager = null!;
 
-        private IdleTracker idleTracker;
+        private IdleTracker idleTracker = null!;
 
-        private ScheduledDelegate scheduledPushPlayer;
+        private ScheduledDelegate? scheduledPushPlayer;
 
-        [CanBeNull]
-        private EpilepsyWarning epilepsyWarning;
+        private EpilepsyWarning? epilepsyWarning;
 
         [Resolved(CanBeNull = true)]
-        private NotificationOverlay notificationOverlay { get; set; }
+        private NotificationOverlay? notificationOverlay { get; set; }
 
         [Resolved(CanBeNull = true)]
-        private VolumeOverlay volumeOverlay { get; set; }
+        private VolumeOverlay? volumeOverlay { get; set; }
 
         [Resolved]
-        private AudioManager audioManager { get; set; }
+        private AudioManager audioManager { get; set; } = null!;
 
         [Resolved(CanBeNull = true)]
-        private BatteryInfo batteryInfo { get; set; }
+        private BatteryInfo? batteryInfo { get; set; }
 
         public PlayerLoader(Func<Player> createPlayer)
         {
@@ -241,6 +240,8 @@ namespace osu.Game.Screens.Play
         {
             base.OnResuming(last);
 
+            Debug.Assert(CurrentPlayer != null);
+
             var lastScore = CurrentPlayer.Score;
 
             AudioSettings.ReferenceScore.Value = lastScore?.ScoreInfo;
@@ -348,6 +349,7 @@ namespace osu.Game.Screens.Play
         private Player consumePlayer()
         {
             Debug.Assert(!playerConsumed);
+            Debug.Assert(CurrentPlayer != null);
 
             playerConsumed = true;
             return CurrentPlayer;
@@ -484,7 +486,7 @@ namespace osu.Game.Screens.Play
 
         #region Mute warning
 
-        private Bindable<bool> muteWarningShownOnce;
+        private Bindable<bool> muteWarningShownOnce = null!;
 
         private int restartCount;
 
@@ -539,7 +541,7 @@ namespace osu.Game.Screens.Play
 
         #region Low battery warning
 
-        private Bindable<bool> batteryWarningShownOnce;
+        private Bindable<bool> batteryWarningShownOnce = null!;
 
         private void showBatteryWarningIfNeeded()
         {

From 63998ad9f121221d4ba27478c2db10aa0d61dcb8 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 17 Mar 2022 19:23:49 +0900
Subject: [PATCH 3569/5547] Add test coverage of `SpectatorPlayer` failing to
 seek on inopportune frame arrival time

---
 .../Visual/Gameplay/TestSceneSpectator.cs     | 54 ++++++++++++++++++-
 .../Visual/Spectator/TestSpectatorClient.cs   |  5 +-
 2 files changed, 55 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs
index d614815316..8b420cebc8 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs
@@ -70,6 +70,56 @@ namespace osu.Game.Tests.Visual.Gameplay
             });
         }
 
+        [Test]
+        public void TestSeekToGameplayStartFramesArriveAfterPlayerLoad()
+        {
+            const double gameplay_start = 10000;
+
+            loadSpectatingScreen();
+
+            start();
+
+            waitForPlayer();
+
+            sendFrames(startTime: gameplay_start);
+
+            AddAssert("time is greater than seek target", () => currentFrameStableTime > gameplay_start);
+        }
+
+        /// <summary>
+        /// Tests the same as <see cref="TestSeekToGameplayStartFramesArriveAfterPlayerLoad"/> but with the frames arriving just as <see cref="Player"/> is transitioning into existence.
+        /// </summary>
+        [Test]
+        public void TestSeekToGameplayStartFramesArriveAsPlayerLoaded()
+        {
+            const double gameplay_start = 10000;
+
+            loadSpectatingScreen();
+
+            start();
+
+            AddUntilStep("wait for player loader", () => (Stack.CurrentScreen as PlayerLoader)?.IsLoaded == true);
+
+            AddUntilStep("queue send frames on player load", () =>
+            {
+                var loadingPlayer = (Stack.CurrentScreen as PlayerLoader)?.CurrentPlayer;
+
+                if (loadingPlayer == null)
+                    return false;
+
+                loadingPlayer.OnLoadComplete += _ =>
+                {
+                    spectatorClient.SendFramesFromUser(streamingUser.Id, 10, gameplay_start);
+                };
+                return true;
+            });
+
+            waitForPlayer();
+
+            AddUntilStep("state is playing", () => spectatorClient.WatchedUserStates[streamingUser.Id].State == SpectatedUserState.Playing);
+            AddAssert("time is greater than seek target", () => currentFrameStableTime > gameplay_start);
+        }
+
         [Test]
         public void TestFrameStarvationAndResume()
         {
@@ -319,9 +369,9 @@ namespace osu.Game.Tests.Visual.Gameplay
         private void checkPaused(bool state) =>
             AddUntilStep($"game is {(state ? "paused" : "playing")}", () => player.ChildrenOfType<DrawableRuleset>().First().IsPaused.Value == state);
 
-        private void sendFrames(int count = 10)
+        private void sendFrames(int count = 10, double startTime = 0)
         {
-            AddStep("send frames", () => spectatorClient.SendFramesFromUser(streamingUser.Id, count));
+            AddStep("send frames", () => spectatorClient.SendFramesFromUser(streamingUser.Id, count, startTime));
         }
 
         private void loadSpectatingScreen()
diff --git a/osu.Game/Tests/Visual/Spectator/TestSpectatorClient.cs b/osu.Game/Tests/Visual/Spectator/TestSpectatorClient.cs
index f5da95bd7b..ac7cb43e02 100644
--- a/osu.Game/Tests/Visual/Spectator/TestSpectatorClient.cs
+++ b/osu.Game/Tests/Visual/Spectator/TestSpectatorClient.cs
@@ -88,7 +88,8 @@ namespace osu.Game.Tests.Visual.Spectator
         /// </summary>
         /// <param name="userId">The user to send frames for.</param>
         /// <param name="count">The total number of frames to send.</param>
-        public void SendFramesFromUser(int userId, int count)
+        /// <param name="startTime">The time to start gameplay frames from.</param>
+        public void SendFramesFromUser(int userId, int count, double startTime = 0)
         {
             var frames = new List<LegacyReplayFrame>();
 
@@ -102,7 +103,7 @@ namespace osu.Game.Tests.Visual.Spectator
                     flush();
 
                 var buttonState = currentFrameIndex == lastFrameIndex ? ReplayButtonState.None : ReplayButtonState.Left1;
-                frames.Add(new LegacyReplayFrame(currentFrameIndex * 100, RNG.Next(0, 512), RNG.Next(0, 512), buttonState));
+                frames.Add(new LegacyReplayFrame(currentFrameIndex * 100 + startTime, RNG.Next(0, 512), RNG.Next(0, 512), buttonState));
             }
 
             flush();

From 2b59eff465ef38c6e2e8c6edf1f8bb368f7eb8a9 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 19 Mar 2022 15:06:09 +0900
Subject: [PATCH 3570/5547] Fix spectator not starting from correct seek point
 (hotfix)

---
 .../Play/MasterGameplayClockContainer.cs      | 28 ++++++++++++-------
 1 file changed, 18 insertions(+), 10 deletions(-)

diff --git a/osu.Game/Screens/Play/MasterGameplayClockContainer.cs b/osu.Game/Screens/Play/MasterGameplayClockContainer.cs
index af58e9d910..410f257a44 100644
--- a/osu.Game/Screens/Play/MasterGameplayClockContainer.cs
+++ b/osu.Game/Screens/Play/MasterGameplayClockContainer.cs
@@ -78,17 +78,12 @@ namespace osu.Game.Screens.Play
             firstHitObjectTime = beatmap.Beatmap.HitObjects.First().StartTime;
         }
 
-        protected override void LoadComplete()
+        [BackgroundDependencyLoader]
+        private void load()
         {
-            base.LoadComplete();
-
-            userAudioOffset = config.GetBindable<double>(OsuSetting.AudioOffset);
-            userAudioOffset.BindValueChanged(offset => userGlobalOffsetClock.Offset = offset.NewValue, true);
-
-            beatmapOffsetSubscription = realm.SubscribeToPropertyChanged(
-                r => r.Find<BeatmapInfo>(beatmap.BeatmapInfo.ID)?.UserSettings,
-                settings => settings.Offset,
-                val => userBeatmapOffsetClock.Offset = val);
+            // TODO: This code should not be in the BDL load method, but is to avoid seeks being overwritten.
+            // See https://github.com/ppy/osu/issues/17267 for the issue.
+            // See https://github.com/ppy/osu/pull/17302 for a better fix which needs some more time.
 
             // sane default provided by ruleset.
             startOffset = gameplayStartTime;
@@ -112,6 +107,19 @@ namespace osu.Game.Screens.Play
             Seek(startOffset);
         }
 
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            userAudioOffset = config.GetBindable<double>(OsuSetting.AudioOffset);
+            userAudioOffset.BindValueChanged(offset => userGlobalOffsetClock.Offset = offset.NewValue, true);
+
+            beatmapOffsetSubscription = realm.SubscribeToPropertyChanged(
+                r => r.Find<BeatmapInfo>(beatmap.BeatmapInfo.ID)?.UserSettings,
+                settings => settings.Offset,
+                val => userBeatmapOffsetClock.Offset = val);
+        }
+
         protected override void OnIsPausedChanged(ValueChangedEvent<bool> isPaused)
         {
             // The source is stopped by a frequency fade first.

From cf2212e79464aa30c0ea721d00bf71f955fbc1a6 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 19 Mar 2022 17:20:54 +0900
Subject: [PATCH 3571/5547] Revert "Fix spectator not starting from correct
 seek point (hotfix)"

This reverts commit 2b59eff465ef38c6e2e8c6edf1f8bb368f7eb8a9.
---
 .../Play/MasterGameplayClockContainer.cs      | 28 +++++++------------
 1 file changed, 10 insertions(+), 18 deletions(-)

diff --git a/osu.Game/Screens/Play/MasterGameplayClockContainer.cs b/osu.Game/Screens/Play/MasterGameplayClockContainer.cs
index 410f257a44..af58e9d910 100644
--- a/osu.Game/Screens/Play/MasterGameplayClockContainer.cs
+++ b/osu.Game/Screens/Play/MasterGameplayClockContainer.cs
@@ -78,12 +78,17 @@ namespace osu.Game.Screens.Play
             firstHitObjectTime = beatmap.Beatmap.HitObjects.First().StartTime;
         }
 
-        [BackgroundDependencyLoader]
-        private void load()
+        protected override void LoadComplete()
         {
-            // TODO: This code should not be in the BDL load method, but is to avoid seeks being overwritten.
-            // See https://github.com/ppy/osu/issues/17267 for the issue.
-            // See https://github.com/ppy/osu/pull/17302 for a better fix which needs some more time.
+            base.LoadComplete();
+
+            userAudioOffset = config.GetBindable<double>(OsuSetting.AudioOffset);
+            userAudioOffset.BindValueChanged(offset => userGlobalOffsetClock.Offset = offset.NewValue, true);
+
+            beatmapOffsetSubscription = realm.SubscribeToPropertyChanged(
+                r => r.Find<BeatmapInfo>(beatmap.BeatmapInfo.ID)?.UserSettings,
+                settings => settings.Offset,
+                val => userBeatmapOffsetClock.Offset = val);
 
             // sane default provided by ruleset.
             startOffset = gameplayStartTime;
@@ -107,19 +112,6 @@ namespace osu.Game.Screens.Play
             Seek(startOffset);
         }
 
-        protected override void LoadComplete()
-        {
-            base.LoadComplete();
-
-            userAudioOffset = config.GetBindable<double>(OsuSetting.AudioOffset);
-            userAudioOffset.BindValueChanged(offset => userGlobalOffsetClock.Offset = offset.NewValue, true);
-
-            beatmapOffsetSubscription = realm.SubscribeToPropertyChanged(
-                r => r.Find<BeatmapInfo>(beatmap.BeatmapInfo.ID)?.UserSettings,
-                settings => settings.Offset,
-                val => userBeatmapOffsetClock.Offset = val);
-        }
-
         protected override void OnIsPausedChanged(ValueChangedEvent<bool> isPaused)
         {
             // The source is stopped by a frequency fade first.

From a903aee17e4a8c44e2d1d56b8e964a7fc9b0c459 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 19 Mar 2022 17:23:37 +0900
Subject: [PATCH 3572/5547] Use schedule to workaround seek issue instead

---
 osu.Game/Screens/Play/Player.cs | 20 +++++++++++++-------
 1 file changed, 13 insertions(+), 7 deletions(-)

diff --git a/osu.Game/Screens/Play/Player.cs b/osu.Game/Screens/Play/Player.cs
index cb8f4b6020..73bdeb5783 100644
--- a/osu.Game/Screens/Play/Player.cs
+++ b/osu.Game/Screens/Play/Player.cs
@@ -615,16 +615,22 @@ namespace osu.Game.Screens.Play
         /// <param name="time">The destination time to seek to.</param>
         internal void NonFrameStableSeek(double time)
         {
-            if (frameStablePlaybackResetDelegate?.Cancelled == false && !frameStablePlaybackResetDelegate.Completed)
-                frameStablePlaybackResetDelegate.RunTask();
+            // TODO: This schedule should not be required and is a temporary hotfix.
+            // See https://github.com/ppy/osu/issues/17267 for the issue.
+            // See https://github.com/ppy/osu/pull/17302 for a better fix which needs some more time.
+            ScheduleAfterChildren(() =>
+            {
+                if (frameStablePlaybackResetDelegate?.Cancelled == false && !frameStablePlaybackResetDelegate.Completed)
+                    frameStablePlaybackResetDelegate.RunTask();
 
-            bool wasFrameStable = DrawableRuleset.FrameStablePlayback;
-            DrawableRuleset.FrameStablePlayback = false;
+                bool wasFrameStable = DrawableRuleset.FrameStablePlayback;
+                DrawableRuleset.FrameStablePlayback = false;
 
-            Seek(time);
+                Seek(time);
 
-            // Delay resetting frame-stable playback for one frame to give the FrameStabilityContainer a chance to seek.
-            frameStablePlaybackResetDelegate = ScheduleAfterChildren(() => DrawableRuleset.FrameStablePlayback = wasFrameStable);
+                // Delay resetting frame-stable playback for one frame to give the FrameStabilityContainer a chance to seek.
+                frameStablePlaybackResetDelegate = ScheduleAfterChildren(() => DrawableRuleset.FrameStablePlayback = wasFrameStable);
+            });
         }
 
         /// <summary>

From 9afe82a0d522adb13b9c58dc40c95fbbd66e9403 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sat, 19 Mar 2022 14:54:58 +0300
Subject: [PATCH 3573/5547] Fix potentially null drawable call to
 `SetLayoutPosition`

---
 .../Multiplayer/Participants/ParticipantsList.cs           | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantsList.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantsList.cs
index 22c9940cd4..14b930f115 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantsList.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantsList.cs
@@ -70,7 +70,12 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Participants
 
                     // Change position of new host to display above all participants.
                     if (Room.Host != null)
-                        panels.SetLayoutPosition(currentHostPanel = panels.SingleOrDefault(u => u.User.Equals(Room.Host)), -1);
+                    {
+                        currentHostPanel = panels.SingleOrDefault(u => u.User.Equals(Room.Host));
+
+                        if (currentHostPanel != null)
+                            panels.SetLayoutPosition(currentHostPanel, -1);
+                    }
                 }
             }
         }

From a293e0c7664f74aec797793bb930119bc42ccba0 Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Sat, 19 Mar 2022 16:44:58 +0000
Subject: [PATCH 3574/5547] Remove redundant `ControlItemText` class

---
 .../Chat/ChannelControl/ControlItem.cs        | 22 ++++++-
 .../Chat/ChannelControl/ControlItemText.cs    | 59 -------------------
 2 files changed, 19 insertions(+), 62 deletions(-)
 delete mode 100644 osu.Game/Overlays/Chat/ChannelControl/ControlItemText.cs

diff --git a/osu.Game/Overlays/Chat/ChannelControl/ControlItem.cs b/osu.Game/Overlays/Chat/ChannelControl/ControlItem.cs
index bf4d60d4e2..df857a6dce 100644
--- a/osu.Game/Overlays/Chat/ChannelControl/ControlItem.cs
+++ b/osu.Game/Overlays/Chat/ChannelControl/ControlItem.cs
@@ -10,7 +10,9 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Input.Events;
+using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
+using osu.Game.Graphics.Sprites;
 using osu.Game.Online.Chat;
 
 namespace osu.Game.Overlays.Chat.ChannelControl
@@ -28,18 +30,22 @@ namespace osu.Game.Overlays.Chat.ChannelControl
 
         private Box? hoverBox;
         private Box? selectBox;
+        private OsuSpriteText? text;
         private ControlItemClose? close;
 
         [Resolved]
         private Bindable<Channel> selectedChannel { get; set; } = null!;
 
+        [Resolved]
+        private OverlayColourProvider colourProvider { get; set; } = null!;
+
         public ControlItem(Channel channel)
         {
             this.channel = channel;
         }
 
         [BackgroundDependencyLoader]
-        private void load(OverlayColourProvider colourProvider)
+        private void load()
         {
             Height = 30;
             RelativeSizeAxes = Axes.X;
@@ -77,11 +83,16 @@ namespace osu.Game.Overlays.Chat.ChannelControl
                             new[]
                             {
                                 createIcon(),
-                                new ControlItemText(channel)
+                                text = new OsuSpriteText
                                 {
                                     Anchor = Anchor.CentreLeft,
                                     Origin = Anchor.CentreLeft,
-                                    Unread = { BindTarget = Unread },
+                                    Text = channel.Type == ChannelType.Public ? $"# {channel.Name.Substring(1)}" : channel.Name,
+                                    Font = OsuFont.Torus.With(size: 17, weight: FontWeight.SemiBold),
+                                    Colour = colourProvider.Light3,
+                                    Margin = new MarginPadding { Bottom = 2 },
+                                    RelativeSizeAxes = Axes.X,
+                                    Truncate = true,
                                 },
                                 new ControlItemMention
                                 {
@@ -117,6 +128,11 @@ namespace osu.Game.Overlays.Chat.ChannelControl
                 else
                     selectBox?.Hide();
             }, true);
+
+            Unread.BindValueChanged(change =>
+            {
+                text!.Colour = change.NewValue ? colourProvider.Content1 : colourProvider.Light3;
+            }, true);
         }
 
         protected override bool OnHover(HoverEvent e)
diff --git a/osu.Game/Overlays/Chat/ChannelControl/ControlItemText.cs b/osu.Game/Overlays/Chat/ChannelControl/ControlItemText.cs
deleted file mode 100644
index 490edb5d28..0000000000
--- a/osu.Game/Overlays/Chat/ChannelControl/ControlItemText.cs
+++ /dev/null
@@ -1,59 +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 enable
-
-using osu.Framework.Allocation;
-using osu.Framework.Bindables;
-using osu.Framework.Graphics;
-using osu.Framework.Graphics.Containers;
-using osu.Game.Graphics;
-using osu.Game.Graphics.Sprites;
-using osu.Game.Online.Chat;
-
-namespace osu.Game.Overlays.Chat.ChannelControl
-{
-    public class ControlItemText : Container
-    {
-        public readonly BindableBool Unread = new BindableBool();
-
-        private readonly Channel channel;
-
-        private OsuSpriteText? text;
-
-        [Resolved]
-        private OverlayColourProvider colourProvider { get; set; } = null!;
-
-        public ControlItemText(Channel channel)
-        {
-            this.channel = channel;
-        }
-
-        [BackgroundDependencyLoader]
-        private void load()
-        {
-            RelativeSizeAxes = Axes.Both;
-            Child = text = new OsuSpriteText
-            {
-                Anchor = Anchor.CentreLeft,
-                Origin = Anchor.CentreLeft,
-                Text = channel.Type == ChannelType.Public ? $"# {channel.Name.Substring(1)}" : channel.Name,
-                Font = OsuFont.Torus.With(size: 17, weight: FontWeight.SemiBold),
-                Colour = colourProvider.Light3,
-                Margin = new MarginPadding { Bottom = 2 },
-                RelativeSizeAxes = Axes.X,
-                Truncate = true,
-            };
-        }
-
-        protected override void LoadComplete()
-        {
-            base.LoadComplete();
-
-            Unread.BindValueChanged(change =>
-            {
-                text!.Colour = change.NewValue ? colourProvider.Content1 : colourProvider.Light3;
-            }, true);
-        }
-    }
-}

From ef823d58a7e790d370a9e184405eedbc30f5025d Mon Sep 17 00:00:00 2001
From: hwabis <kennysun23@gmail.com>
Date: Sat, 19 Mar 2022 13:05:35 -0400
Subject: [PATCH 3575/5547] address frenzibyte review (refactor bindable flow,
 clean up CI stuff)

---
 .../Match/Playlist/MultiplayerPlaylist.cs     |  3 +-
 .../Playlist/MultiplayerPlaylistTabControl.cs | 31 ++++++++++++-------
 2 files changed, 21 insertions(+), 13 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylist.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylist.cs
index 3269257260..77076bd1cc 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylist.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylist.cs
@@ -70,8 +70,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist
         {
             base.LoadComplete();
             DisplayMode.BindValueChanged(onDisplayModeChanged, true);
-            queueList.Items.BindCollectionChanged(
-                (_, __) => playlistTabControl.queueListCount.Value = queueList.Items.Count, true);
+            playlistTabControl.QueueItems.BindTarget = queueList.Items;
         }
 
         private void onDisplayModeChanged(ValueChangedEvent<MultiplayerPlaylistDisplayMode> mode)
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylistTabControl.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylistTabControl.cs
index f0a51eb5e1..882a96c877 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylistTabControl.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylistTabControl.cs
@@ -4,31 +4,40 @@
 using osu.Framework.Bindables;
 using osu.Framework.Graphics.UserInterface;
 using osu.Game.Graphics.UserInterface;
+using osu.Game.Online.Rooms;
 
 namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist
 {
     public class MultiplayerPlaylistTabControl : OsuTabControl<MultiplayerPlaylistDisplayMode>
     {
-        public Bindable<int> queueListCount = new Bindable<int>(0);
-
-        public MultiplayerPlaylistTabControl()
-        {
-        }
+        public readonly IBindableList<PlaylistItem> QueueItems = new BindableList<PlaylistItem>();
 
         protected override TabItem<MultiplayerPlaylistDisplayMode> CreateTabItem(MultiplayerPlaylistDisplayMode value)
         {
             if (value == MultiplayerPlaylistDisplayMode.Queue)
-                return new QueueTabItem(value, queueListCount);
-            return new OsuTabItem(value);
+                return new QueueTabItem { QueueItems = { BindTarget = QueueItems } };
+
+            return base.CreateTabItem(value);
         }
 
         private class QueueTabItem : OsuTabItem
         {
-            public QueueTabItem(MultiplayerPlaylistDisplayMode value, Bindable<int> queueListCount)
-                : base(value)
+            public readonly IBindableList<PlaylistItem> QueueItems = new BindableList<PlaylistItem>();
+
+            public QueueTabItem()
+                : base(MultiplayerPlaylistDisplayMode.Queue)
             {
-                queueListCount.BindValueChanged(
-                    _ => Text.Text = "Queue (" + queueListCount.Value + ")", true);
+            }
+
+            protected override void LoadComplete()
+            {
+                base.LoadComplete();
+                QueueItems.BindCollectionChanged((_,__) =>
+                {
+                    Text.Text = $"Queue";
+                    if (QueueItems.Count != 0)
+                        Text.Text += $" ({QueueItems.Count})";
+                }, true);
             }
         }
     }

From 149cfd338dd5e77dca9cc7f612ab311914176cfd Mon Sep 17 00:00:00 2001
From: apollo-dw <83023433+apollo-dw@users.noreply.github.com>
Date: Sat, 19 Mar 2022 18:29:44 +0000
Subject: [PATCH 3576/5547] Use new mod-related object types for Strict
 Tracking

---
 .../StrictTrackingDrawableSliderTail.cs       | 12 ++++
 .../Mods/Objects/StrictTrackingSlider.cs      | 70 +++++++++++++++++++
 .../Objects/StrictTrackingSliderTailCircle.cs | 19 +++++
 .../Mods/OsuModStrictTracking.cs              | 40 +++++++----
 osu.Game.Rulesets.Osu/Objects/Slider.cs       |  6 +-
 osu.Game/Rulesets/UI/Playfield.cs             |  2 +-
 6 files changed, 132 insertions(+), 17 deletions(-)
 create mode 100644 osu.Game.Rulesets.Osu/Mods/Objects/StrictTrackingDrawableSliderTail.cs
 create mode 100644 osu.Game.Rulesets.Osu/Mods/Objects/StrictTrackingSlider.cs
 create mode 100644 osu.Game.Rulesets.Osu/Mods/Objects/StrictTrackingSliderTailCircle.cs

diff --git a/osu.Game.Rulesets.Osu/Mods/Objects/StrictTrackingDrawableSliderTail.cs b/osu.Game.Rulesets.Osu/Mods/Objects/StrictTrackingDrawableSliderTail.cs
new file mode 100644
index 0000000000..110b09f4f9
--- /dev/null
+++ b/osu.Game.Rulesets.Osu/Mods/Objects/StrictTrackingDrawableSliderTail.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 osu.Game.Rulesets.Osu.Objects.Drawables;
+
+namespace osu.Game.Rulesets.Osu.Mods.Objects
+{
+    public class StrictTrackingDrawableSliderTail : DrawableSliderTail
+    {
+        public override bool DisplayResult => true;
+    }
+}
diff --git a/osu.Game.Rulesets.Osu/Mods/Objects/StrictTrackingSlider.cs b/osu.Game.Rulesets.Osu/Mods/Objects/StrictTrackingSlider.cs
new file mode 100644
index 0000000000..bf0a57d871
--- /dev/null
+++ b/osu.Game.Rulesets.Osu/Mods/Objects/StrictTrackingSlider.cs
@@ -0,0 +1,70 @@
+// 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.Rulesets.Objects;
+using osu.Game.Rulesets.Objects.Types;
+using osu.Game.Rulesets.Osu.Objects;
+
+namespace osu.Game.Rulesets.Osu.Mods.Objects
+{
+    public class StrictTrackingSlider : Slider
+    {
+        public StrictTrackingSlider(Slider original)
+        {
+            StartTime = original.StartTime;
+            Samples = original.Samples;
+            Path = original.Path;
+            NodeSamples = original.NodeSamples;
+            RepeatCount = original.RepeatCount;
+            Position = original.Position;
+            NewCombo = original.NewCombo;
+            ComboOffset = original.ComboOffset;
+            LegacyLastTickOffset = original.LegacyLastTickOffset;
+            TickDistanceMultiplier = original.TickDistanceMultiplier;
+        }
+
+        protected override void CreateNestedHitObjects(CancellationToken cancellationToken)
+        {
+            var sliderEvents = SliderEventGenerator.Generate(StartTime, SpanDuration, Velocity, TickDistance, Path.Distance, this.SpanCount(), LegacyLastTickOffset, cancellationToken);
+
+            foreach (var e in sliderEvents)
+            {
+                switch (e.Type)
+                {
+                    case SliderEventType.Head:
+                        AddNested(HeadCircle = new SliderHeadCircle
+                        {
+                            StartTime = e.Time,
+                            Position = Position,
+                            StackHeight = StackHeight,
+                        });
+                        break;
+
+                    case SliderEventType.LegacyLastTick:
+                        AddNested(TailCircle = new StrictTrackingSliderTailCircle(this)
+                        {
+                            RepeatIndex = e.SpanIndex,
+                            StartTime = e.Time,
+                            Position = EndPosition,
+                            StackHeight = StackHeight
+                        });
+                        break;
+
+                    case SliderEventType.Repeat:
+                        AddNested(new SliderRepeat(this)
+                        {
+                            RepeatIndex = e.SpanIndex,
+                            StartTime = StartTime + (e.SpanIndex + 1) * SpanDuration,
+                            Position = Position + Path.PositionAt(e.PathProgress),
+                            StackHeight = StackHeight,
+                            Scale = Scale,
+                        });
+                        break;
+                }
+            }
+
+            UpdateNestedSamples();
+        }
+    }
+}
diff --git a/osu.Game.Rulesets.Osu/Mods/Objects/StrictTrackingSliderTailCircle.cs b/osu.Game.Rulesets.Osu/Mods/Objects/StrictTrackingSliderTailCircle.cs
new file mode 100644
index 0000000000..7d93f2cf39
--- /dev/null
+++ b/osu.Game.Rulesets.Osu/Mods/Objects/StrictTrackingSliderTailCircle.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.Game.Rulesets.Judgements;
+using osu.Game.Rulesets.Osu.Judgements;
+using osu.Game.Rulesets.Osu.Objects;
+
+namespace osu.Game.Rulesets.Osu.Mods.Objects
+{
+    public class StrictTrackingSliderTailCircle : SliderTailCircle
+    {
+        public StrictTrackingSliderTailCircle(Slider slider)
+            : base(slider)
+        {
+        }
+
+        public override Judgement CreateJudgement() => new OsuJudgement();
+    }
+}
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModStrictTracking.cs b/osu.Game.Rulesets.Osu/Mods/OsuModStrictTracking.cs
index 13da422049..255ac4fa22 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModStrictTracking.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModStrictTracking.cs
@@ -2,17 +2,20 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
+using System.Linq;
 using osu.Framework.Graphics.Sprites;
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Mods;
-using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Objects.Drawables;
+using osu.Game.Rulesets.Osu.Beatmaps;
+using osu.Game.Rulesets.Osu.Mods.Objects;
 using osu.Game.Rulesets.Osu.Objects;
 using osu.Game.Rulesets.Osu.Objects.Drawables;
+using osu.Game.Rulesets.UI;
 
 namespace osu.Game.Rulesets.Osu.Mods
 {
-    public class OsuModStrictTracking : Mod, IApplicableToDifficulty, IApplicableToDrawableHitObject, IApplicableToHitObject
+    public class OsuModStrictTracking : Mod, IApplicableAfterBeatmapConversion, IApplicableToDrawableHitObject, IApplicableToDrawableRuleset<OsuHitObject>
     {
         public override string Name => @"Strict Tracking";
         public override string Acronym => @"ST";
@@ -22,11 +25,6 @@ namespace osu.Game.Rulesets.Osu.Mods
         public override double ScoreMultiplier => 1.0;
         public override Type[] IncompatibleMods => new[] { typeof(ModClassic) };
 
-        public void ApplyToDifficulty(BeatmapDifficulty difficulty)
-        {
-            difficulty.SliderTickRate = 0.0;
-        }
-
         public void ApplyToDrawableHitObject(DrawableHitObject drawable)
         {
             if (drawable is DrawableSlider slider)
@@ -46,14 +44,30 @@ namespace osu.Game.Rulesets.Osu.Mods
             }
         }
 
-        public void ApplyToHitObject(HitObject hitObject)
+        public void ApplyToBeatmap(IBeatmap beatmap)
         {
-            switch (hitObject)
+            var osuBeatmap = (OsuBeatmap)beatmap;
+
+            if (osuBeatmap.HitObjects.Count == 0) return;
+
+            var hitObjects = osuBeatmap.HitObjects.Select(ho =>
             {
-                case Slider slider:
-                    slider.TailCircle.JudgeAsSliderTick = true;
-                    break;
-            }
+                if (ho is Slider slider)
+                {
+                    var newSlider = new StrictTrackingSlider(slider);
+                    return newSlider;
+                }
+
+                return ho;
+            }).ToList();
+
+            osuBeatmap.HitObjects = hitObjects;
+        }
+
+        public void ApplyToDrawableRuleset(DrawableRuleset<OsuHitObject> drawableRuleset)
+        {
+            drawableRuleset.Playfield.RegisterPool<StrictTrackingSlider, DrawableSlider>(10, 100);
+            drawableRuleset.Playfield.RegisterPool<StrictTrackingSliderTailCircle, StrictTrackingDrawableSliderTail>(10, 100);
         }
     }
 }
diff --git a/osu.Game.Rulesets.Osu/Objects/Slider.cs b/osu.Game.Rulesets.Osu/Objects/Slider.cs
index 5c1c3fd253..64dbab6fb8 100644
--- a/osu.Game.Rulesets.Osu/Objects/Slider.cs
+++ b/osu.Game.Rulesets.Osu/Objects/Slider.cs
@@ -137,7 +137,7 @@ namespace osu.Game.Rulesets.Osu.Objects
 
         public Slider()
         {
-            SamplesBindable.CollectionChanged += (_, __) => updateNestedSamples();
+            SamplesBindable.CollectionChanged += (_, __) => UpdateNestedSamples();
             Path.Version.ValueChanged += _ => updateNestedPositions();
         }
 
@@ -210,7 +210,7 @@ namespace osu.Game.Rulesets.Osu.Objects
                 }
             }
 
-            updateNestedSamples();
+            UpdateNestedSamples();
         }
 
         private void updateNestedPositions()
@@ -224,7 +224,7 @@ namespace osu.Game.Rulesets.Osu.Objects
                 TailCircle.Position = EndPosition;
         }
 
-        private void updateNestedSamples()
+        protected void UpdateNestedSamples()
         {
             var firstSample = Samples.FirstOrDefault(s => s.Name == HitSampleInfo.HIT_NORMAL)
                               ?? Samples.FirstOrDefault(); // TODO: remove this when guaranteed sort is present for samples (https://github.com/ppy/osu/issues/1933)
diff --git a/osu.Game/Rulesets/UI/Playfield.cs b/osu.Game/Rulesets/UI/Playfield.cs
index 30e71dde1c..940b8d1ac1 100644
--- a/osu.Game/Rulesets/UI/Playfield.cs
+++ b/osu.Game/Rulesets/UI/Playfield.cs
@@ -308,7 +308,7 @@ namespace osu.Game.Rulesets.UI
         /// </param>
         /// <typeparam name="TObject">The <see cref="HitObject"/> type.</typeparam>
         /// <typeparam name="TDrawable">The <see cref="DrawableHitObject"/> receiver for <typeparamref name="TObject"/>s.</typeparam>
-        protected void RegisterPool<TObject, TDrawable>(int initialSize, int? maximumSize = null)
+        public void RegisterPool<TObject, TDrawable>(int initialSize, int? maximumSize = null)
             where TObject : HitObject
             where TDrawable : DrawableHitObject, new()
             => RegisterPool<TObject, TDrawable>(new DrawablePool<TDrawable>(initialSize, maximumSize));

From 5373c3066ffc070476c1402b7032aa3e8f3846c6 Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Sat, 19 Mar 2022 17:23:59 +0000
Subject: [PATCH 3577/5547] Use `OsuAnimatedButton` as base for
 `ControlItemClose`

---
 .../Chat/ChannelControl/ControlItemClose.cs   | 42 ++++---------------
 1 file changed, 7 insertions(+), 35 deletions(-)

diff --git a/osu.Game/Overlays/Chat/ChannelControl/ControlItemClose.cs b/osu.Game/Overlays/Chat/ChannelControl/ControlItemClose.cs
index c0f419f619..6064e3790d 100644
--- a/osu.Game/Overlays/Chat/ChannelControl/ControlItemClose.cs
+++ b/osu.Game/Overlays/Chat/ChannelControl/ControlItemClose.cs
@@ -6,56 +6,28 @@
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Sprites;
-using osu.Framework.Input.Events;
 using osu.Game.Graphics;
-using osu.Game.Graphics.Containers;
+using osu.Game.Graphics.UserInterface;
 using osuTK;
 
 namespace osu.Game.Overlays.Chat.ChannelControl
 {
-    public class ControlItemClose : OsuClickableContainer
+    public class ControlItemClose : OsuAnimatedButton
     {
-        private readonly SpriteIcon icon;
-
-        [Resolved]
-        private OsuColour osuColour { get; set; } = null!;
-
-        public ControlItemClose()
+        [BackgroundDependencyLoader]
+        private void load(OsuColour osuColour)
         {
             Alpha = 0f;
             Size = new Vector2(20);
-            Child = icon = new SpriteIcon
+            Add(new SpriteIcon
             {
                 Anchor = Anchor.Centre,
                 Origin = Anchor.Centre,
                 Scale = new Vector2(0.75f),
                 Icon = FontAwesome.Solid.TimesCircle,
                 RelativeSizeAxes = Axes.Both,
-            };
-        }
-
-        protected override bool OnMouseDown(MouseDownEvent e)
-        {
-            icon.ScaleTo(0.5f, 1000, Easing.OutQuint);
-            return base.OnMouseDown(e);
-        }
-
-        protected override void OnMouseUp(MouseUpEvent e)
-        {
-            icon.ScaleTo(0.75f, 1000, Easing.OutElastic);
-            base.OnMouseUp(e);
-        }
-
-        protected override bool OnHover(HoverEvent e)
-        {
-            icon.FadeColour(osuColour.Red1, 200, Easing.OutQuint);
-            return base.OnHover(e);
-        }
-
-        protected override void OnHoverLost(HoverLostEvent e)
-        {
-            icon.FadeColour(Colour4.White, 200, Easing.OutQuint);
-            base.OnHoverLost(e);
+                Colour = osuColour.Red1,
+            });
         }
     }
 }

From 653bb47dd587d8feac0f48b5465a9fccd3f66ca0 Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Sat, 19 Mar 2022 21:36:11 +0000
Subject: [PATCH 3578/5547] Use `UpdateableAvatar` and remove redundant
 `ControlItemAvatar` class

---
 .../Chat/ChannelControl/ControlItem.cs        |  9 ++-
 .../Chat/ChannelControl/ControlItemAvatar.cs  | 62 -------------------
 2 files changed, 8 insertions(+), 63 deletions(-)
 delete mode 100644 osu.Game/Overlays/Chat/ChannelControl/ControlItemAvatar.cs

diff --git a/osu.Game/Overlays/Chat/ChannelControl/ControlItem.cs b/osu.Game/Overlays/Chat/ChannelControl/ControlItem.cs
index df857a6dce..a388ebc52f 100644
--- a/osu.Game/Overlays/Chat/ChannelControl/ControlItem.cs
+++ b/osu.Game/Overlays/Chat/ChannelControl/ControlItem.cs
@@ -4,6 +4,7 @@
 #nullable enable
 
 using System;
+using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
@@ -14,6 +15,8 @@ using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Online.Chat;
+using osu.Game.Users.Drawables;
+using osuTK;
 
 namespace osu.Game.Overlays.Chat.ChannelControl
 {
@@ -154,10 +157,14 @@ namespace osu.Game.Overlays.Chat.ChannelControl
             if (channel.Type != ChannelType.PM)
                 return Drawable.Empty();
 
-            return new ControlItemAvatar(channel)
+            return new UpdateableAvatar(channel.Users.First(), false, false, true)
             {
+                Size = new Vector2(20),
+                Margin = new MarginPadding { Right = 5 },
                 Anchor = Anchor.CentreLeft,
                 Origin = Anchor.CentreLeft,
+                CornerRadius = 10,
+                Masking = true,
             };
         }
     }
diff --git a/osu.Game/Overlays/Chat/ChannelControl/ControlItemAvatar.cs b/osu.Game/Overlays/Chat/ChannelControl/ControlItemAvatar.cs
deleted file mode 100644
index bb3109ec1f..0000000000
--- a/osu.Game/Overlays/Chat/ChannelControl/ControlItemAvatar.cs
+++ /dev/null
@@ -1,62 +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 enable
-
-using System.Linq;
-using osu.Framework.Allocation;
-using osu.Framework.Graphics;
-using osu.Framework.Graphics.Containers;
-using osu.Framework.Graphics.Sprites;
-using osu.Game.Online.Chat;
-using osu.Game.Users.Drawables;
-using osuTK;
-
-namespace osu.Game.Overlays.Chat.ChannelControl
-{
-    public class ControlItemAvatar : CircularContainer
-    {
-        private readonly Channel channel;
-
-        private SpriteIcon? placeholder;
-        private DrawableAvatar? avatar;
-
-        public ControlItemAvatar(Channel channel)
-        {
-            this.channel = channel;
-        }
-
-        [BackgroundDependencyLoader]
-        private void load()
-        {
-            Size = new Vector2(20);
-            Margin = new MarginPadding { Right = 5 };
-            Masking = true;
-
-            Children = new Drawable[]
-            {
-                placeholder = new SpriteIcon
-                {
-                    Icon = FontAwesome.Solid.At,
-                    Anchor = Anchor.Centre,
-                    Origin = Anchor.Centre,
-                    Colour = Colour4.White,
-                    RelativeSizeAxes = Axes.Both,
-                    Alpha = 0.5f,
-                },
-                new DelayedLoadWrapper(avatar = new DrawableAvatar(channel.Users.First())
-                {
-                    RelativeSizeAxes = Axes.Both,
-                    Anchor = Anchor.Centre,
-                    Origin = Anchor.Centre,
-                }),
-            };
-        }
-
-        protected override void LoadComplete()
-        {
-            base.LoadComplete();
-            avatar!.OnLoadComplete += _ => placeholder!.FadeOut(250);
-        }
-    }
-}

From ba5a43b5260536275e00d97720a0d05e81529bb9 Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Sat, 19 Mar 2022 21:49:14 +0000
Subject: [PATCH 3579/5547] Rename `ControlItem` -> `ChannelListItem` and
 associated classes

---
 ...nelControlItem.cs => TestSceneChannelListItem.cs} |  8 ++++----
 .../ChannelListItem.cs}                              | 12 ++++++------
 .../ChannelListItemClose.cs}                         |  4 ++--
 .../ChannelListItemMention.cs}                       |  4 ++--
 4 files changed, 14 insertions(+), 14 deletions(-)
 rename osu.Game.Tests/Visual/Online/{TestSceneChannelControlItem.cs => TestSceneChannelListItem.cs} (95%)
 rename osu.Game/Overlays/Chat/{ChannelControl/ControlItem.cs => ChannelList/ChannelListItem.cs} (94%)
 rename osu.Game/Overlays/Chat/{ChannelControl/ControlItemClose.cs => ChannelList/ChannelListItemClose.cs} (89%)
 rename osu.Game/Overlays/Chat/{ChannelControl/ControlItemMention.cs => ChannelList/ChannelListItemMention.cs} (94%)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneChannelControlItem.cs b/osu.Game.Tests/Visual/Online/TestSceneChannelListItem.cs
similarity index 95%
rename from osu.Game.Tests/Visual/Online/TestSceneChannelControlItem.cs
rename to osu.Game.Tests/Visual/Online/TestSceneChannelListItem.cs
index e66092bf27..ac829f8cbc 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneChannelControlItem.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneChannelListItem.cs
@@ -12,13 +12,13 @@ using osu.Game.Graphics.Sprites;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Chat;
 using osu.Game.Overlays;
-using osu.Game.Overlays.Chat.ChannelControl;
+using osu.Game.Overlays.Chat.ChannelList;
 using osuTK;
 
 namespace osu.Game.Tests.Visual.Online
 {
     [TestFixture]
-    public class TestSceneChannelControlItem : OsuTestScene
+    public class TestSceneChannelListItem : OsuTestScene
     {
         [Cached]
         private readonly OverlayColourProvider colourProvider = new OverlayColourProvider(OverlayColourScheme.Pink);
@@ -34,7 +34,7 @@ namespace osu.Game.Tests.Visual.Online
             createPrivateChannel("test user long name", 3),
         };
 
-        private readonly Dictionary<Channel, ControlItem> channelMap = new Dictionary<Channel, ControlItem>();
+        private readonly Dictionary<Channel, ChannelListItem> channelMap = new Dictionary<Channel, ChannelListItem>();
 
         private FillFlowContainer flow;
         private OsuSpriteText selectedText;
@@ -102,7 +102,7 @@ namespace osu.Game.Tests.Visual.Online
 
                 foreach (var channel in channels)
                 {
-                    var item = new ControlItem(channel);
+                    var item = new ChannelListItem(channel);
                     flow.Add(item);
                     channelMap.Add(channel, item);
                     item.OnRequestSelect += c => selected.Value = c;
diff --git a/osu.Game/Overlays/Chat/ChannelControl/ControlItem.cs b/osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs
similarity index 94%
rename from osu.Game/Overlays/Chat/ChannelControl/ControlItem.cs
rename to osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs
index a388ebc52f..247b04688c 100644
--- a/osu.Game/Overlays/Chat/ChannelControl/ControlItem.cs
+++ b/osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs
@@ -18,9 +18,9 @@ using osu.Game.Online.Chat;
 using osu.Game.Users.Drawables;
 using osuTK;
 
-namespace osu.Game.Overlays.Chat.ChannelControl
+namespace osu.Game.Overlays.Chat.ChannelList
 {
-    public class ControlItem : OsuClickableContainer
+    public class ChannelListItem : OsuClickableContainer
     {
         public event Action<Channel>? OnRequestSelect;
         public event Action<Channel>? OnRequestLeave;
@@ -34,7 +34,7 @@ namespace osu.Game.Overlays.Chat.ChannelControl
         private Box? hoverBox;
         private Box? selectBox;
         private OsuSpriteText? text;
-        private ControlItemClose? close;
+        private ChannelListItemClose? close;
 
         [Resolved]
         private Bindable<Channel> selectedChannel { get; set; } = null!;
@@ -42,7 +42,7 @@ namespace osu.Game.Overlays.Chat.ChannelControl
         [Resolved]
         private OverlayColourProvider colourProvider { get; set; } = null!;
 
-        public ControlItem(Channel channel)
+        public ChannelListItem(Channel channel)
         {
             this.channel = channel;
         }
@@ -97,14 +97,14 @@ namespace osu.Game.Overlays.Chat.ChannelControl
                                     RelativeSizeAxes = Axes.X,
                                     Truncate = true,
                                 },
-                                new ControlItemMention
+                                new ChannelListItemMention
                                 {
                                     Anchor = Anchor.CentreLeft,
                                     Origin = Anchor.CentreLeft,
                                     Margin = new MarginPadding { Right = 3 },
                                     Mentions = { BindTarget = Mentions },
                                 },
-                                close = new ControlItemClose
+                                close = new ChannelListItemClose
                                 {
                                     Anchor = Anchor.CentreLeft,
                                     Origin = Anchor.CentreLeft,
diff --git a/osu.Game/Overlays/Chat/ChannelControl/ControlItemClose.cs b/osu.Game/Overlays/Chat/ChannelList/ChannelListItemClose.cs
similarity index 89%
rename from osu.Game/Overlays/Chat/ChannelControl/ControlItemClose.cs
rename to osu.Game/Overlays/Chat/ChannelList/ChannelListItemClose.cs
index 6064e3790d..37a1fcdde7 100644
--- a/osu.Game/Overlays/Chat/ChannelControl/ControlItemClose.cs
+++ b/osu.Game/Overlays/Chat/ChannelList/ChannelListItemClose.cs
@@ -10,9 +10,9 @@ using osu.Game.Graphics;
 using osu.Game.Graphics.UserInterface;
 using osuTK;
 
-namespace osu.Game.Overlays.Chat.ChannelControl
+namespace osu.Game.Overlays.Chat.ChannelList
 {
-    public class ControlItemClose : OsuAnimatedButton
+    public class ChannelListItemClose : OsuAnimatedButton
     {
         [BackgroundDependencyLoader]
         private void load(OsuColour osuColour)
diff --git a/osu.Game/Overlays/Chat/ChannelControl/ControlItemMention.cs b/osu.Game/Overlays/Chat/ChannelList/ChannelListItemMention.cs
similarity index 94%
rename from osu.Game/Overlays/Chat/ChannelControl/ControlItemMention.cs
rename to osu.Game/Overlays/Chat/ChannelList/ChannelListItemMention.cs
index f4d65e3cef..3a1c3b7619 100644
--- a/osu.Game/Overlays/Chat/ChannelControl/ControlItemMention.cs
+++ b/osu.Game/Overlays/Chat/ChannelList/ChannelListItemMention.cs
@@ -12,9 +12,9 @@ using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
 using osuTK;
 
-namespace osu.Game.Overlays.Chat.ChannelControl
+namespace osu.Game.Overlays.Chat.ChannelList
 {
-    public class ControlItemMention : CircularContainer
+    public class ChannelListItemMention : CircularContainer
     {
         public readonly BindableInt Mentions = new BindableInt();
 

From f3702fbefbb9f42041d68c7d73d8a63a33f61d94 Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Sat, 19 Mar 2022 22:20:17 +0000
Subject: [PATCH 3580/5547] Pass correct params to `UpdateableAvatar` ctor in
 `ChannelListItem`

---
 osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs b/osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs
index 247b04688c..583493181b 100644
--- a/osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs
+++ b/osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs
@@ -157,7 +157,7 @@ namespace osu.Game.Overlays.Chat.ChannelList
             if (channel.Type != ChannelType.PM)
                 return Drawable.Empty();
 
-            return new UpdateableAvatar(channel.Users.First(), false, false, true)
+            return new UpdateableAvatar(channel.Users.First(), isInteractive: false)
             {
                 Size = new Vector2(20),
                 Margin = new MarginPadding { Right = 5 },

From 52d6f083dc2ab487c9fdd11905644296a3f41830 Mon Sep 17 00:00:00 2001
From: apollo-dw <83023433+apollo-dw@users.noreply.github.com>
Date: Sat, 19 Mar 2022 23:42:12 +0000
Subject: [PATCH 3581/5547] Only miss slider tail on untrack

---
 osu.Game.Rulesets.Osu/Mods/OsuModStrictTracking.cs | 10 +++-------
 1 file changed, 3 insertions(+), 7 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModStrictTracking.cs b/osu.Game.Rulesets.Osu/Mods/OsuModStrictTracking.cs
index 255ac4fa22..b8d7134e5f 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModStrictTracking.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModStrictTracking.cs
@@ -33,13 +33,10 @@ namespace osu.Game.Rulesets.Osu.Mods
                 {
                     if (e.NewValue || slider.Judged) return;
 
-                    slider.MissForcefully();
+                    var tail = slider.NestedHitObjects.OfType<StrictTrackingDrawableSliderTail>().First();
 
-                    foreach (var o in slider.NestedHitObjects)
-                    {
-                        if (o is DrawableOsuHitObject h && !o.Judged)
-                            h.MissForcefully();
-                    }
+                    if (!tail.Judged)
+                        tail.MissForcefully();
                 };
             }
         }
@@ -66,7 +63,6 @@ namespace osu.Game.Rulesets.Osu.Mods
 
         public void ApplyToDrawableRuleset(DrawableRuleset<OsuHitObject> drawableRuleset)
         {
-            drawableRuleset.Playfield.RegisterPool<StrictTrackingSlider, DrawableSlider>(10, 100);
             drawableRuleset.Playfield.RegisterPool<StrictTrackingSliderTailCircle, StrictTrackingDrawableSliderTail>(10, 100);
         }
     }

From c5cc7eec79ba4c2797c2ec5f11cf702bd8bcc49c Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sun, 20 Mar 2022 05:01:32 +0300
Subject: [PATCH 3582/5547] Add explicit todo about removing
 `BeatmapInfo.MaxCombo`

Using that property is a trap basically.
---
 osu.Game/Beatmaps/BeatmapInfo.cs | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/osu.Game/Beatmaps/BeatmapInfo.cs b/osu.Game/Beatmaps/BeatmapInfo.cs
index c6f69286cd..5a2cfd63cf 100644
--- a/osu.Game/Beatmaps/BeatmapInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapInfo.cs
@@ -9,6 +9,7 @@ using osu.Framework.Testing;
 using osu.Game.Database;
 using osu.Game.Models;
 using osu.Game.Online.API.Requests.Responses;
+using osu.Game.Overlays.BeatmapSet.Scores;
 using osu.Game.Rulesets;
 using osu.Game.Scoring;
 using Realms;
@@ -169,6 +170,10 @@ namespace osu.Game.Beatmaps
         [Ignored]
         public APIBeatmap? OnlineInfo { get; set; }
 
+        /// <summary>
+        /// The maximum achievable combo on this beatmap, populated for online info purposes only.
+        /// Todo: This should never be used nor exist, but is still relied on in <see cref="ScoresContainer.Scores"/> since <see cref="IBeatmapInfo"/> can't be used yet.
+        /// </summary>
         [Ignored]
         public int? MaxCombo { get; set; }
 

From d36f32a9c99780d183214dba8b609bf0693bb9a1 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sun, 20 Mar 2022 05:28:07 +0300
Subject: [PATCH 3583/5547] Introduce method for computing maximum achievable
 combo properly

---
 osu.Game/Scoring/ScoreManager.cs | 62 ++++++++++++++++----------------
 1 file changed, 32 insertions(+), 30 deletions(-)

diff --git a/osu.Game/Scoring/ScoreManager.cs b/osu.Game/Scoring/ScoreManager.cs
index 02a7d9a39f..0f3c991f07 100644
--- a/osu.Game/Scoring/ScoreManager.cs
+++ b/osu.Game/Scoring/ScoreManager.cs
@@ -134,35 +134,9 @@ namespace osu.Game.Scoring
             if (string.IsNullOrEmpty(score.BeatmapInfo.MD5Hash))
                 return score.TotalScore;
 
-            int beatmapMaxCombo;
-
-            if (score.IsLegacyScore)
-            {
-                // This score is guaranteed to be an osu!stable score.
-                // The combo must be determined through either the beatmap's max combo value or the difficulty calculator, as lazer's scoring has changed and the score statistics cannot be used.
-                if (score.BeatmapInfo.MaxCombo != null)
-                    beatmapMaxCombo = score.BeatmapInfo.MaxCombo.Value;
-                else
-                {
-                    if (difficulties == null)
-                        return score.TotalScore;
-
-                    // We can compute the max combo locally after the async beatmap difficulty computation.
-                    var difficulty = await difficulties().GetDifficultyAsync(score.BeatmapInfo, score.Ruleset, score.Mods, cancellationToken).ConfigureAwait(false);
-
-                    // Something failed during difficulty calculation. Fall back to provided score.
-                    if (difficulty == null)
-                        return score.TotalScore;
-
-                    beatmapMaxCombo = difficulty.Value.MaxCombo;
-                }
-            }
-            else
-            {
-                // This is guaranteed to be a non-legacy score.
-                // The combo must be determined through the score's statistics, as both the beatmap's max combo and the difficulty calculator will provide osu!stable combo values.
-                beatmapMaxCombo = Enum.GetValues(typeof(HitResult)).OfType<HitResult>().Where(r => r.AffectsCombo()).Select(r => score.Statistics.GetValueOrDefault(r)).Sum();
-            }
+            int? beatmapMaxCombo = await GetBeatmapMaximumComboAsync(score, cancellationToken).ConfigureAwait(false);
+            if (beatmapMaxCombo == null)
+                return score.TotalScore;
 
             if (beatmapMaxCombo == 0)
                 return 0;
@@ -171,7 +145,35 @@ namespace osu.Game.Scoring
             var scoreProcessor = ruleset.CreateScoreProcessor();
             scoreProcessor.Mods.Value = score.Mods;
 
-            return (long)Math.Round(scoreProcessor.ComputeFinalLegacyScore(mode, score, beatmapMaxCombo));
+            return (long)Math.Round(scoreProcessor.ComputeFinalLegacyScore(mode, score, beatmapMaxCombo.Value));
+        }
+
+        /// <summary>
+        /// Retrieves the maximum achievable combo on the beatmap of the provided score.
+        /// </summary>
+        /// <param name="score">The <see cref="ScoreInfo"/> to compute the maximum achievable combo for.</param>
+        /// <param name="cancellationToken">A <see cref="CancellationToken"/> to cancel the process.</param>
+        /// <returns>The maximum achievable combo.</returns>
+        public async Task<int?> GetBeatmapMaximumComboAsync([NotNull] ScoreInfo score, CancellationToken cancellationToken = default)
+        {
+            if (score.IsLegacyScore)
+            {
+                // This score is guaranteed to be an osu!stable score.
+                // The combo must be determined through either the beatmap's max combo value or the difficulty calculator, as lazer's scoring has changed and the score statistics cannot be used.
+                if (score.BeatmapInfo.MaxCombo != null)
+                    return score.BeatmapInfo.MaxCombo.Value;
+
+                if (difficulties == null)
+                    return null;
+
+                // We can compute the max combo locally after the async beatmap difficulty computation.
+                var difficulty = await difficulties().GetDifficultyAsync(score.BeatmapInfo, score.Ruleset, score.Mods, cancellationToken).ConfigureAwait(false);
+                return difficulty?.MaxCombo;
+            }
+
+            // This is guaranteed to be a non-legacy score.
+            // The combo must be determined through the score's statistics, as both the beatmap's max combo and the difficulty calculator will provide osu!stable combo values.
+            return Enum.GetValues(typeof(HitResult)).OfType<HitResult>().Where(r => r.AffectsCombo()).Select(r => score.Statistics.GetValueOrDefault(r)).Sum();
         }
 
         /// <summary>

From eca7975864911eb8d13062b113cc779928afcded Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sun, 20 Mar 2022 05:33:35 +0300
Subject: [PATCH 3584/5547] Compute the beatmap maximum achievable combo
 instead of `Beatmap.MaxCombo`

---
 .../Ranking/Expanded/ExpandedPanelMiddleContent.cs        | 8 +++++---
 .../Screens/Ranking/Expanded/Statistics/ComboStatistic.cs | 5 ++---
 2 files changed, 7 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Screens/Ranking/Expanded/ExpandedPanelMiddleContent.cs b/osu.Game/Screens/Ranking/Expanded/ExpandedPanelMiddleContent.cs
index 1b1aa3a684..1d80bcbbe6 100644
--- a/osu.Game/Screens/Ranking/Expanded/ExpandedPanelMiddleContent.cs
+++ b/osu.Game/Screens/Ranking/Expanded/ExpandedPanelMiddleContent.cs
@@ -65,10 +65,12 @@ namespace osu.Game.Screens.Ranking.Expanded
             var metadata = beatmap.BeatmapSet?.Metadata ?? beatmap.Metadata;
             string creator = metadata.Author.Username;
 
+            int? beatmapMaxCombo = scoreManager.GetBeatmapMaximumComboAsync(score).GetResultSafely();
+
             var topStatistics = new List<StatisticDisplay>
             {
                 new AccuracyStatistic(score.Accuracy),
-                new ComboStatistic(score.MaxCombo, beatmap.MaxCombo, score.Statistics.All(stat => !stat.Key.BreaksCombo() || stat.Value == 0)),
+                new ComboStatistic(score.MaxCombo, beatmapMaxCombo),
                 new PerformanceStatistic(score),
             };
 
@@ -80,8 +82,6 @@ namespace osu.Game.Screens.Ranking.Expanded
             statisticDisplays.AddRange(topStatistics);
             statisticDisplays.AddRange(bottomStatistics);
 
-            var starDifficulty = beatmapDifficultyCache.GetDifficultyAsync(beatmap, score.Ruleset, score.Mods).GetResultSafely();
-
             AddInternal(new FillFlowContainer
             {
                 RelativeSizeAxes = Axes.Both,
@@ -224,6 +224,8 @@ namespace osu.Game.Screens.Ranking.Expanded
             if (score.Date != default)
                 AddInternal(new PlayedOnText(score.Date));
 
+            var starDifficulty = beatmapDifficultyCache.GetDifficultyAsync(beatmap, score.Ruleset, score.Mods).GetResultSafely();
+
             if (starDifficulty != null)
             {
                 starAndModDisplay.Add(new StarRatingDisplay(starDifficulty.Value)
diff --git a/osu.Game/Screens/Ranking/Expanded/Statistics/ComboStatistic.cs b/osu.Game/Screens/Ranking/Expanded/Statistics/ComboStatistic.cs
index 67d580270d..0e42ec026a 100644
--- a/osu.Game/Screens/Ranking/Expanded/Statistics/ComboStatistic.cs
+++ b/osu.Game/Screens/Ranking/Expanded/Statistics/ComboStatistic.cs
@@ -26,11 +26,10 @@ namespace osu.Game.Screens.Ranking.Expanded.Statistics
         /// </summary>
         /// <param name="combo">The combo to be displayed.</param>
         /// <param name="maxCombo">The maximum value of <paramref name="combo"/>.</param>
-        /// <param name="isPerfect">Whether this is a perfect combo.</param>
-        public ComboStatistic(int combo, int? maxCombo, bool isPerfect)
+        public ComboStatistic(int combo, int? maxCombo)
             : base("combo", combo, maxCombo)
         {
-            this.isPerfect = isPerfect;
+            isPerfect = combo == maxCombo;
         }
 
         public override void Appear()

From 7529d6fc0078197d0f58e1c5fa0dc6cd3855a921 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sun, 20 Mar 2022 06:23:42 +0300
Subject: [PATCH 3585/5547] Bind queue items during playlist initialization

Along with where the other bindables are bound together (only bind, not
listening).
---
 .../Multiplayer/Match/Playlist/MultiplayerPlaylist.cs          | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylist.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylist.cs
index 77076bd1cc..879a21e7c1 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylist.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylist.cs
@@ -64,13 +64,14 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist
                     }
                 }
             };
+
+            playlistTabControl.QueueItems.BindTarget = queueList.Items;
         }
 
         protected override void LoadComplete()
         {
             base.LoadComplete();
             DisplayMode.BindValueChanged(onDisplayModeChanged, true);
-            playlistTabControl.QueueItems.BindTarget = queueList.Items;
         }
 
         private void onDisplayModeChanged(ValueChangedEvent<MultiplayerPlaylistDisplayMode> mode)

From e1d22e58bfbd03c6d8c198460711860ae1c23fb1 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sun, 20 Mar 2022 06:25:07 +0300
Subject: [PATCH 3586/5547] Simplify queue count text logic

---
 .../Match/Playlist/MultiplayerPlaylistTabControl.cs        | 7 +------
 1 file changed, 1 insertion(+), 6 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylistTabControl.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylistTabControl.cs
index 882a96c877..583a05839f 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylistTabControl.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylistTabControl.cs
@@ -32,12 +32,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist
             protected override void LoadComplete()
             {
                 base.LoadComplete();
-                QueueItems.BindCollectionChanged((_,__) =>
-                {
-                    Text.Text = $"Queue";
-                    if (QueueItems.Count != 0)
-                        Text.Text += $" ({QueueItems.Count})";
-                }, true);
+                QueueItems.BindCollectionChanged((_, __) => Text.Text = QueueItems.Count > 0 ? $"Queue ({QueueItems.Count})" : "Queue", true);
             }
         }
     }

From 70e943fbccb1d1e2746aeb605f63b208cf8b6a76 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sun, 20 Mar 2022 06:36:51 +0300
Subject: [PATCH 3587/5547] `ModUsage.Solo` -> `ModUsage.User`

---
 osu.Game/Overlays/BeatmapSet/LeaderboardModSelector.cs       | 2 +-
 osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs                   | 2 +-
 osu.Game/Rulesets/Mods/ModUsage.cs                           | 2 +-
 osu.Game/Screens/OnlinePlay/FreeModSelectOverlay.cs          | 2 +-
 osu.Game/Screens/OnlinePlay/OnlinePlaySongSelect.cs          | 2 +-
 osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs | 2 +-
 osu.Game/Screens/Play/SubmittingPlayer.cs                    | 2 +-
 osu.Game/Screens/Ranking/ResultsScreen.cs                    | 2 +-
 8 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Overlays/BeatmapSet/LeaderboardModSelector.cs b/osu.Game/Overlays/BeatmapSet/LeaderboardModSelector.cs
index 97b89c6f74..caeb757d7a 100644
--- a/osu.Game/Overlays/BeatmapSet/LeaderboardModSelector.cs
+++ b/osu.Game/Overlays/BeatmapSet/LeaderboardModSelector.cs
@@ -63,7 +63,7 @@ namespace osu.Game.Overlays.BeatmapSet
                 return;
 
             modsContainer.Add(new ModButton(new ModNoMod()));
-            modsContainer.AddRange(rulesetInstance.AllMods.Where(m => m.IsPlayable(ModUsage.Solo)).Select(m => new ModButton(m)));
+            modsContainer.AddRange(rulesetInstance.AllMods.Where(m => m.IsPlayable(ModUsage.User)).Select(m => new ModButton(m)));
 
             modsContainer.ForEach(button =>
             {
diff --git a/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs b/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs
index 17ef9f926e..801cd3cba7 100644
--- a/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs
+++ b/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs
@@ -31,7 +31,7 @@ namespace osu.Game.Rulesets.Mods
 
         public override double ScoreMultiplier => 1;
 
-        public override bool IsPlayable(ModUsage usage) => usage == ModUsage.Solo;
+        public override bool IsPlayable(ModUsage usage) => usage == ModUsage.User;
 
         public override Type[] IncompatibleMods => new[] { typeof(ModRateAdjust), typeof(ModTimeRamp) };
 
diff --git a/osu.Game/Rulesets/Mods/ModUsage.cs b/osu.Game/Rulesets/Mods/ModUsage.cs
index 82ff6bc418..714a99056b 100644
--- a/osu.Game/Rulesets/Mods/ModUsage.cs
+++ b/osu.Game/Rulesets/Mods/ModUsage.cs
@@ -11,7 +11,7 @@ namespace osu.Game.Rulesets.Mods
         /// <summary>
         /// In a solo gameplay session.
         /// </summary>
-        Solo,
+        User,
 
         /// <summary>
         /// In a multiplayer match, as a required mod.
diff --git a/osu.Game/Screens/OnlinePlay/FreeModSelectOverlay.cs b/osu.Game/Screens/OnlinePlay/FreeModSelectOverlay.cs
index 974e2b9305..37cffd8343 100644
--- a/osu.Game/Screens/OnlinePlay/FreeModSelectOverlay.cs
+++ b/osu.Game/Screens/OnlinePlay/FreeModSelectOverlay.cs
@@ -25,7 +25,7 @@ namespace osu.Game.Screens.OnlinePlay
         public new Func<Mod, bool> IsValidMod
         {
             get => base.IsValidMod;
-            set => base.IsValidMod = m => m.HasImplementation && m.IsPlayable(ModUsage.Solo) && value(m);
+            set => base.IsValidMod = m => m.HasImplementation && m.IsPlayable(ModUsage.User) && value(m);
         }
 
         public FreeModSelectOverlay()
diff --git a/osu.Game/Screens/OnlinePlay/OnlinePlaySongSelect.cs b/osu.Game/Screens/OnlinePlay/OnlinePlaySongSelect.cs
index 75e5ea60a4..d4f89b5206 100644
--- a/osu.Game/Screens/OnlinePlay/OnlinePlaySongSelect.cs
+++ b/osu.Game/Screens/OnlinePlay/OnlinePlaySongSelect.cs
@@ -170,7 +170,7 @@ namespace osu.Game.Screens.OnlinePlay
         /// </summary>
         /// <param name="mod">The <see cref="Mod"/> to check.</param>
         /// <returns>Whether <paramref name="mod"/> is a valid mod for online play.</returns>
-        protected virtual bool IsValidMod(Mod mod) => mod.HasImplementation && ModUtils.FlattenMod(mod).All(m => m.IsPlayable(ModUsage.Solo));
+        protected virtual bool IsValidMod(Mod mod) => mod.HasImplementation && ModUtils.FlattenMod(mod).All(m => m.IsPlayable(ModUsage.User));
 
         /// <summary>
         /// Checks whether a given <see cref="Mod"/> is valid for per-player free-mod selection.
diff --git a/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs b/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
index 27aa4fe1f1..bab391337a 100644
--- a/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
+++ b/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
@@ -188,7 +188,7 @@ namespace osu.Game.Screens.Play.PlayerSettings
             if (score.NewValue == null)
                 return;
 
-            if (score.NewValue.Mods.Any(m => !m.IsPlayable(ModUsage.Solo)))
+            if (score.NewValue.Mods.Any(m => !m.IsPlayable(ModUsage.User)))
                 return;
 
             var hitEvents = score.NewValue.HitEvents;
diff --git a/osu.Game/Screens/Play/SubmittingPlayer.cs b/osu.Game/Screens/Play/SubmittingPlayer.cs
index 5de8aa1dc1..205ee9ab9c 100644
--- a/osu.Game/Screens/Play/SubmittingPlayer.cs
+++ b/osu.Game/Screens/Play/SubmittingPlayer.cs
@@ -48,7 +48,7 @@ namespace osu.Game.Screens.Play
             // Token request construction should happen post-load to allow derived classes to potentially prepare DI backings that are used to create the request.
             var tcs = new TaskCompletionSource<bool>();
 
-            if (Mods.Value.Any(m => !m.IsPlayable(ModUsage.Solo)))
+            if (Mods.Value.Any(m => !m.IsPlayable(ModUsage.User)))
             {
                 handleTokenFailure(new InvalidOperationException("Non-user playable mod selected."));
                 return false;
diff --git a/osu.Game/Screens/Ranking/ResultsScreen.cs b/osu.Game/Screens/Ranking/ResultsScreen.cs
index 09b6cc0f23..ac3816c4ec 100644
--- a/osu.Game/Screens/Ranking/ResultsScreen.cs
+++ b/osu.Game/Screens/Ranking/ResultsScreen.cs
@@ -146,7 +146,7 @@ namespace osu.Game.Screens.Ranking
             if (Score != null)
             {
                 // only show flair / animation when arriving after watching a play that isn't autoplay.
-                bool shouldFlair = player != null && Score.Mods.All(m => m.IsPlayable(ModUsage.Solo));
+                bool shouldFlair = player != null && Score.Mods.All(m => m.IsPlayable(ModUsage.User));
 
                 ScorePanelList.AddScore(Score, shouldFlair);
             }

From 820a672940b151a43b54f510dc03b8476bd95ce9 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sun, 20 Mar 2022 06:37:08 +0300
Subject: [PATCH 3588/5547] Reword xmldoc to make more sense

---
 osu.Game/Rulesets/Mods/ModUsage.cs | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Rulesets/Mods/ModUsage.cs b/osu.Game/Rulesets/Mods/ModUsage.cs
index 714a99056b..0892f528d5 100644
--- a/osu.Game/Rulesets/Mods/ModUsage.cs
+++ b/osu.Game/Rulesets/Mods/ModUsage.cs
@@ -4,22 +4,22 @@
 namespace osu.Game.Rulesets.Mods
 {
     /// <summary>
-    /// The usage of this mod to determine its playability.
+    /// The usage of this mod to determine whether it's playable in such context.
     /// </summary>
     public enum ModUsage
     {
         /// <summary>
-        /// In a solo gameplay session.
+        /// Used for a per-user gameplay session. Determines whether the mod is playable by an end user.
         /// </summary>
         User,
 
         /// <summary>
-        /// In a multiplayer match, as a required mod.
+        /// Used as a "required mod" for a multiplayer match.
         /// </summary>
         MultiplayerRequired,
 
         /// <summary>
-        /// In a multiplayer match, as a "free" mod.
+        /// Used as a "free mod" for a multiplayer match.
         /// </summary>
         MultiplayerFree,
     }

From add9f3ec9177815f7dab386927c47ad436d9576f Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sun, 20 Mar 2022 13:12:24 +0300
Subject: [PATCH 3589/5547] Rename multiplayer mod usages to make more sense

---
 osu.Game/Rulesets/Mods/IMod.cs                       |  4 ++--
 osu.Game/Rulesets/Mods/ModRateAdjust.cs              |  2 +-
 osu.Game/Rulesets/Mods/ModTimeRamp.cs                |  2 +-
 osu.Game/Rulesets/Mods/ModUsage.cs                   | 12 +++++++-----
 .../Multiplayer/MultiplayerMatchSongSelect.cs        |  4 ++--
 osu.Game/Utils/ModUtils.cs                           |  4 ++--
 6 files changed, 15 insertions(+), 13 deletions(-)

diff --git a/osu.Game/Rulesets/Mods/IMod.cs b/osu.Game/Rulesets/Mods/IMod.cs
index bdfb273b13..325b75b76e 100644
--- a/osu.Game/Rulesets/Mods/IMod.cs
+++ b/osu.Game/Rulesets/Mods/IMod.cs
@@ -39,8 +39,8 @@ namespace osu.Game.Rulesets.Mods
         /// <remarks>
         /// <list type="bullet">
         /// <item>Should be always <c>false</c> for cases where the user is not interacting with the game.</item>
-        /// <item>Should be <c>false</c> in <see cref="ModUsage.MultiplayerRequired"/> for mods that make gameplay duration dependent on user input (e.g. <see cref="ModAdaptiveSpeed"/>).</item>
-        /// <item>Should be <c>false</c> in <see cref="ModUsage.MultiplayerFree"/> for mods that affect the gameplay duration (e.g. <see cref="ModRateAdjust"/> and <see cref="ModTimeRamp"/>).</item>
+        /// <item>Should be <c>false</c> in <see cref="ModUsage.MultiplayerRoomWide"/> for mods that make gameplay duration dependent on user input (e.g. <see cref="ModAdaptiveSpeed"/>).</item>
+        /// <item>Should be <c>false</c> in <see cref="ModUsage.MultiplayerPerPlayer"/> for mods that affect the gameplay duration (e.g. <see cref="ModRateAdjust"/> and <see cref="ModTimeRamp"/>).</item>
         /// </list>
         /// </remarks>
         /// <param name="usage">The mod usage.</param>
diff --git a/osu.Game/Rulesets/Mods/ModRateAdjust.cs b/osu.Game/Rulesets/Mods/ModRateAdjust.cs
index 810b93c4dd..ab724673b6 100644
--- a/osu.Game/Rulesets/Mods/ModRateAdjust.cs
+++ b/osu.Game/Rulesets/Mods/ModRateAdjust.cs
@@ -11,7 +11,7 @@ namespace osu.Game.Rulesets.Mods
 {
     public abstract class ModRateAdjust : Mod, IApplicableToRate
     {
-        public override bool IsPlayable(ModUsage usage) => usage != ModUsage.MultiplayerFree;
+        public override bool IsPlayable(ModUsage usage) => usage != ModUsage.MultiplayerPerPlayer;
 
         public abstract BindableNumber<double> SpeedChange { get; }
 
diff --git a/osu.Game/Rulesets/Mods/ModTimeRamp.cs b/osu.Game/Rulesets/Mods/ModTimeRamp.cs
index fa6a9f3e5b..96b38301b5 100644
--- a/osu.Game/Rulesets/Mods/ModTimeRamp.cs
+++ b/osu.Game/Rulesets/Mods/ModTimeRamp.cs
@@ -30,7 +30,7 @@ namespace osu.Game.Rulesets.Mods
         [SettingSource("Adjust pitch", "Should pitch be adjusted with speed")]
         public abstract BindableBool AdjustPitch { get; }
 
-        public override bool IsPlayable(ModUsage usage) => usage != ModUsage.MultiplayerFree;
+        public override bool IsPlayable(ModUsage usage) => usage != ModUsage.MultiplayerPerPlayer;
 
         public override Type[] IncompatibleMods => new[] { typeof(ModRateAdjust), typeof(ModAdaptiveSpeed) };
 
diff --git a/osu.Game/Rulesets/Mods/ModUsage.cs b/osu.Game/Rulesets/Mods/ModUsage.cs
index 0892f528d5..59a62bfc6f 100644
--- a/osu.Game/Rulesets/Mods/ModUsage.cs
+++ b/osu.Game/Rulesets/Mods/ModUsage.cs
@@ -9,18 +9,20 @@ namespace osu.Game.Rulesets.Mods
     public enum ModUsage
     {
         /// <summary>
-        /// Used for a per-user gameplay session. Determines whether the mod is playable by an end user.
+        /// Used for a per-user gameplay session.
+        /// Determines whether the mod is playable by an end user.
         /// </summary>
         User,
 
         /// <summary>
-        /// Used as a "required mod" for a multiplayer match.
+        /// Used in multiplayer but must be applied to all users.
+        /// This is generally the case for mods which affect the length of gameplay.
         /// </summary>
-        MultiplayerRequired,
+        MultiplayerRoomWide,
 
         /// <summary>
-        /// Used as a "free mod" for a multiplayer match.
+        /// Used in multiplayer either at a room or per-player level (i.e. "free mod").
         /// </summary>
-        MultiplayerFree,
+        MultiplayerPerPlayer,
     }
 }
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs
index 4c1350a56b..63467dbb9d 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs
@@ -117,8 +117,8 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
 
         protected override BeatmapDetailArea CreateBeatmapDetailArea() => new PlayBeatmapDetailArea();
 
-        protected override bool IsValidMod(Mod mod) => base.IsValidMod(mod) && mod.IsPlayable(ModUsage.MultiplayerRequired);
+        protected override bool IsValidMod(Mod mod) => base.IsValidMod(mod) && mod.IsPlayable(ModUsage.MultiplayerRoomWide);
 
-        protected override bool IsValidFreeMod(Mod mod) => base.IsValidFreeMod(mod) && mod.IsPlayable(ModUsage.MultiplayerFree);
+        protected override bool IsValidFreeMod(Mod mod) => base.IsValidFreeMod(mod) && mod.IsPlayable(ModUsage.MultiplayerPerPlayer);
     }
 }
diff --git a/osu.Game/Utils/ModUtils.cs b/osu.Game/Utils/ModUtils.cs
index 4915f5bdc6..946386a7ce 100644
--- a/osu.Game/Utils/ModUtils.cs
+++ b/osu.Game/Utils/ModUtils.cs
@@ -121,7 +121,7 @@ namespace osu.Game.Utils
         /// <param name="invalidMods">Invalid mods, if any were found. Will be null if all mods were valid.</param>
         /// <returns>Whether the input mods were all valid. If false, <paramref name="invalidMods"/> will contain all invalid entries.</returns>
         public static bool CheckValidRequiredModsForMultiplayer(IEnumerable<Mod> mods, [NotNullWhen(false)] out List<Mod>? invalidMods)
-            => checkValid(mods, m => m.IsPlayable(ModUsage.MultiplayerRequired), out invalidMods);
+            => checkValid(mods, m => m.IsPlayable(ModUsage.MultiplayerRoomWide), out invalidMods);
 
         /// <summary>
         /// Check the provided combination of mods are valid as "free mods" in a multiplayer match session.
@@ -130,7 +130,7 @@ namespace osu.Game.Utils
         /// <param name="invalidMods">Invalid mods, if any were found. Will be null if all mods were valid.</param>
         /// <returns>Whether the input mods were all valid. If false, <paramref name="invalidMods"/> will contain all invalid entries.</returns>
         public static bool CheckValidFreeModsForMultiplayer(IEnumerable<Mod> mods, [NotNullWhen(false)] out List<Mod>? invalidMods)
-            => checkValid(mods, m => m.IsPlayable(ModUsage.MultiplayerFree), out invalidMods);
+            => checkValid(mods, m => m.IsPlayable(ModUsage.MultiplayerPerPlayer), out invalidMods);
 
         private static bool checkValid(IEnumerable<Mod> mods, Predicate<Mod> valid, [NotNullWhen(false)] out List<Mod>? invalidMods)
         {

From 5f878ed82b98a1d3ec14af96879c4d68bee8d167 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sun, 20 Mar 2022 16:07:08 +0300
Subject: [PATCH 3590/5547] Delegate `IsPlayable` to the obsoleted
 `UserPlayable` by default

Handles consumers who still haven't updated to use `IsPlayable` yet.
---
 osu.Game/Rulesets/Mods/Mod.cs | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Rulesets/Mods/Mod.cs b/osu.Game/Rulesets/Mods/Mod.cs
index 00aef1a598..debb1a1e48 100644
--- a/osu.Game/Rulesets/Mods/Mod.cs
+++ b/osu.Game/Rulesets/Mods/Mod.cs
@@ -91,7 +91,9 @@ namespace osu.Game.Rulesets.Mods
         [JsonIgnore]
         public virtual bool HasImplementation => this is IApplicableMod;
 
-        public virtual bool IsPlayable(ModUsage usage) => true;
+#pragma warning disable 618
+        public virtual bool IsPlayable(ModUsage usage) => UserPlayable;
+#pragma warning restore 618
 
         [JsonIgnore]
         [Obsolete("Override IsPlayable instead.")] // Can be removed 20220918

From 145fca2704457fe58baaf294b960812ce41dd49d Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sun, 20 Mar 2022 16:17:19 +0300
Subject: [PATCH 3591/5547] Fix failing test scenes

---
 osu.Game.Tests/Mods/ModUtilsTest.cs | 12 ------------
 osu.Game/Utils/ModUtils.cs          |  6 +++---
 2 files changed, 3 insertions(+), 15 deletions(-)

diff --git a/osu.Game.Tests/Mods/ModUtilsTest.cs b/osu.Game.Tests/Mods/ModUtilsTest.cs
index 4c126f0a3b..e858abfe44 100644
--- a/osu.Game.Tests/Mods/ModUtilsTest.cs
+++ b/osu.Game.Tests/Mods/ModUtilsTest.cs
@@ -134,18 +134,6 @@ namespace osu.Game.Tests.Mods
 
         private static readonly object[] invalid_mod_test_scenarios =
         {
-            // incompatible pair.
-            new object[]
-            {
-                new Mod[] { new OsuModDoubleTime(), new OsuModHalfTime() },
-                new[] { typeof(OsuModDoubleTime), typeof(OsuModHalfTime) }
-            },
-            // incompatible pair with derived class.
-            new object[]
-            {
-                new Mod[] { new OsuModNightcore(), new OsuModHalfTime() },
-                new[] { typeof(OsuModNightcore), typeof(OsuModHalfTime) }
-            },
             // system mod.
             new object[]
             {
diff --git a/osu.Game/Utils/ModUtils.cs b/osu.Game/Utils/ModUtils.cs
index 946386a7ce..0d46494319 100644
--- a/osu.Game/Utils/ModUtils.cs
+++ b/osu.Game/Utils/ModUtils.cs
@@ -106,7 +106,7 @@ namespace osu.Game.Utils
         }
 
         /// <summary>
-        /// Check the provided combination of mods are valid for a local gameplay session.
+        /// Checks that all <see cref="Mod"/>s in a combination are valid for a local gameplay session.
         /// </summary>
         /// <param name="mods">The mods to check.</param>
         /// <param name="invalidMods">Invalid mods, if any were found. Will be null if all mods were valid.</param>
@@ -115,7 +115,7 @@ namespace osu.Game.Utils
             => checkValid(mods, m => m.Type != ModType.System && m.HasImplementation && !(m is MultiMod), out invalidMods);
 
         /// <summary>
-        /// Check the provided combination of mods are valid as "required mods" in a multiplayer match session.
+        /// Checks that all <see cref="Mod"/>s in a combination are valid as "required mods" in a multiplayer match session.
         /// </summary>
         /// <param name="mods">The mods to check.</param>
         /// <param name="invalidMods">Invalid mods, if any were found. Will be null if all mods were valid.</param>
@@ -124,7 +124,7 @@ namespace osu.Game.Utils
             => checkValid(mods, m => m.IsPlayable(ModUsage.MultiplayerRoomWide), out invalidMods);
 
         /// <summary>
-        /// Check the provided combination of mods are valid as "free mods" in a multiplayer match session.
+        /// Checks that all <see cref="Mod"/>s in a combination are valid as "free mods" in a multiplayer match session.
         /// </summary>
         /// <param name="mods">The mods to check.</param>
         /// <param name="invalidMods">Invalid mods, if any were found. Will be null if all mods were valid.</param>

From 2a78042038da441a2d4cfa8b72b130fd182d2949 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sun, 20 Mar 2022 16:18:53 +0300
Subject: [PATCH 3592/5547] `GetBeatmapMaximumComboAsync` ->
 `GetMaximumAchievableComboAsync`

---
 osu.Game/Scoring/ScoreManager.cs                            | 6 +++---
 .../Screens/Ranking/Expanded/ExpandedPanelMiddleContent.cs  | 2 +-
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Scoring/ScoreManager.cs b/osu.Game/Scoring/ScoreManager.cs
index 0f3c991f07..e6bfe284cb 100644
--- a/osu.Game/Scoring/ScoreManager.cs
+++ b/osu.Game/Scoring/ScoreManager.cs
@@ -134,7 +134,7 @@ namespace osu.Game.Scoring
             if (string.IsNullOrEmpty(score.BeatmapInfo.MD5Hash))
                 return score.TotalScore;
 
-            int? beatmapMaxCombo = await GetBeatmapMaximumComboAsync(score, cancellationToken).ConfigureAwait(false);
+            int? beatmapMaxCombo = await GetMaximumAchievableComboAsync(score, cancellationToken).ConfigureAwait(false);
             if (beatmapMaxCombo == null)
                 return score.TotalScore;
 
@@ -149,12 +149,12 @@ namespace osu.Game.Scoring
         }
 
         /// <summary>
-        /// Retrieves the maximum achievable combo on the beatmap of the provided score.
+        /// Retrieves the maximum achievable combo for the provided score.
         /// </summary>
         /// <param name="score">The <see cref="ScoreInfo"/> to compute the maximum achievable combo for.</param>
         /// <param name="cancellationToken">A <see cref="CancellationToken"/> to cancel the process.</param>
         /// <returns>The maximum achievable combo.</returns>
-        public async Task<int?> GetBeatmapMaximumComboAsync([NotNull] ScoreInfo score, CancellationToken cancellationToken = default)
+        public async Task<int?> GetMaximumAchievableComboAsync([NotNull] ScoreInfo score, CancellationToken cancellationToken = default)
         {
             if (score.IsLegacyScore)
             {
diff --git a/osu.Game/Screens/Ranking/Expanded/ExpandedPanelMiddleContent.cs b/osu.Game/Screens/Ranking/Expanded/ExpandedPanelMiddleContent.cs
index 1d80bcbbe6..5b3129dad6 100644
--- a/osu.Game/Screens/Ranking/Expanded/ExpandedPanelMiddleContent.cs
+++ b/osu.Game/Screens/Ranking/Expanded/ExpandedPanelMiddleContent.cs
@@ -65,7 +65,7 @@ namespace osu.Game.Screens.Ranking.Expanded
             var metadata = beatmap.BeatmapSet?.Metadata ?? beatmap.Metadata;
             string creator = metadata.Author.Username;
 
-            int? beatmapMaxCombo = scoreManager.GetBeatmapMaximumComboAsync(score).GetResultSafely();
+            int? beatmapMaxCombo = scoreManager.GetMaximumAchievableComboAsync(score).GetResultSafely();
 
             var topStatistics = new List<StatisticDisplay>
             {

From aef40da8d4d39f80f9566b658e3d4918176c7316 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sun, 20 Mar 2022 16:24:29 +0300
Subject: [PATCH 3593/5547] Add note about null return value

---
 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 e6bfe284cb..371cbbf597 100644
--- a/osu.Game/Scoring/ScoreManager.cs
+++ b/osu.Game/Scoring/ScoreManager.cs
@@ -153,7 +153,7 @@ namespace osu.Game.Scoring
         /// </summary>
         /// <param name="score">The <see cref="ScoreInfo"/> to compute the maximum achievable combo for.</param>
         /// <param name="cancellationToken">A <see cref="CancellationToken"/> to cancel the process.</param>
-        /// <returns>The maximum achievable combo.</returns>
+        /// <returns>The maximum achievable combo. A <see langword="null"/> return value indicates the difficulty cache has failed to retrieve the combo.</returns>
         public async Task<int?> GetMaximumAchievableComboAsync([NotNull] ScoreInfo score, CancellationToken cancellationToken = default)
         {
             if (score.IsLegacyScore)

From c2063f415d674338066a31e93617f505aa71eed9 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sun, 20 Mar 2022 16:27:54 +0300
Subject: [PATCH 3594/5547] Remove unnecessary `MaxCombo` migration between
 unmapped database fields

---
 osu.Game/Beatmaps/EFBeatmapInfo.cs     | 3 ---
 osu.Game/Database/EFToRealmMigrator.cs | 1 -
 2 files changed, 4 deletions(-)

diff --git a/osu.Game/Beatmaps/EFBeatmapInfo.cs b/osu.Game/Beatmaps/EFBeatmapInfo.cs
index 8daeaa7030..740adfd1c7 100644
--- a/osu.Game/Beatmaps/EFBeatmapInfo.cs
+++ b/osu.Game/Beatmaps/EFBeatmapInfo.cs
@@ -53,9 +53,6 @@ namespace osu.Game.Beatmaps
         [NotMapped]
         public APIBeatmap OnlineInfo { get; set; }
 
-        [NotMapped]
-        public int? MaxCombo { get; set; }
-
         /// <summary>
         /// The playable length in milliseconds of this beatmap.
         /// </summary>
diff --git a/osu.Game/Database/EFToRealmMigrator.cs b/osu.Game/Database/EFToRealmMigrator.cs
index c9deee19fe..cbf5c5ffe9 100644
--- a/osu.Game/Database/EFToRealmMigrator.cs
+++ b/osu.Game/Database/EFToRealmMigrator.cs
@@ -295,7 +295,6 @@ namespace osu.Game.Database
                                 TimelineZoom = beatmap.TimelineZoom,
                                 Countdown = beatmap.Countdown,
                                 CountdownOffset = beatmap.CountdownOffset,
-                                MaxCombo = beatmap.MaxCombo,
                                 Bookmarks = beatmap.Bookmarks,
                                 BeatmapSet = realmBeatmapSet,
                             };

From 6f47f7ffc886f608df86c00d36790e57c8a95c37 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sun, 20 Mar 2022 16:29:56 +0300
Subject: [PATCH 3595/5547] Remove no longer necessary `MaxCombo` assignment in
 tests

---
 osu.Game.Tests/Resources/TestResources.cs | 1 -
 1 file changed, 1 deletion(-)

diff --git a/osu.Game.Tests/Resources/TestResources.cs b/osu.Game.Tests/Resources/TestResources.cs
index 00bb02a937..81b624f908 100644
--- a/osu.Game.Tests/Resources/TestResources.cs
+++ b/osu.Game.Tests/Resources/TestResources.cs
@@ -133,7 +133,6 @@ namespace osu.Game.Tests.Resources
                         StarRating = diff,
                         Length = length,
                         BPM = bpm,
-                        MaxCombo = 1000,
                         Hash = Guid.NewGuid().ToString().ComputeMD5Hash(),
                         Ruleset = rulesetInfo,
                         Metadata = metadata,

From b9859f9f215f129ec89e9d17bf0677187d8c7e54 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sun, 20 Mar 2022 16:30:28 +0300
Subject: [PATCH 3596/5547] Obsolete `BeatmapInfo.MaxCombo` and suppress in
 usages

---
 osu.Game/Beatmaps/BeatmapInfo.cs                       | 3 ++-
 osu.Game/Overlays/BeatmapSet/Scores/ScoreTable.cs      | 2 ++
 osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.cs | 2 ++
 osu.Game/Scoring/ScoreInfo.cs                          | 2 +-
 osu.Game/Scoring/ScoreManager.cs                       | 2 ++
 5 files changed, 9 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapInfo.cs b/osu.Game/Beatmaps/BeatmapInfo.cs
index 5a2cfd63cf..f90208d0c0 100644
--- a/osu.Game/Beatmaps/BeatmapInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapInfo.cs
@@ -172,9 +172,10 @@ namespace osu.Game.Beatmaps
 
         /// <summary>
         /// The maximum achievable combo on this beatmap, populated for online info purposes only.
-        /// Todo: This should never be used nor exist, but is still relied on in <see cref="ScoresContainer.Scores"/> since <see cref="IBeatmapInfo"/> can't be used yet.
+        /// Todo: This should never be used nor exist, but is still relied on in <see cref="ScoresContainer.Scores"/> since <see cref="IBeatmapInfo"/> can't be used yet. For now this is obsoleted until it is removed.
         /// </summary>
         [Ignored]
+        [Obsolete("Use ScoreManager.GetMaximumAchievableComboAsync instead.")]
         public int? MaxCombo { get; set; }
 
         [Ignored]
diff --git a/osu.Game/Overlays/BeatmapSet/Scores/ScoreTable.cs b/osu.Game/Overlays/BeatmapSet/Scores/ScoreTable.cs
index 5ef434c427..86e72e9faa 100644
--- a/osu.Game/Overlays/BeatmapSet/Scores/ScoreTable.cs
+++ b/osu.Game/Overlays/BeatmapSet/Scores/ScoreTable.cs
@@ -173,7 +173,9 @@ namespace osu.Game.Overlays.BeatmapSet.Scores
                 {
                     Text = score.MaxCombo.ToLocalisableString(@"0\x"),
                     Font = OsuFont.GetFont(size: text_size),
+#pragma warning disable 618
                     Colour = score.MaxCombo == score.BeatmapInfo.MaxCombo ? highAccuracyColour : Color4.White
+#pragma warning restore 618
                 }
             };
 
diff --git a/osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.cs b/osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.cs
index 6f07b20049..7d59c95396 100644
--- a/osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.cs
+++ b/osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.cs
@@ -78,7 +78,9 @@ namespace osu.Game.Overlays.BeatmapSet.Scores
                 // TODO: temporary. should be removed once `OrderByTotalScore` can accept `IScoreInfo`.
                 var beatmapInfo = new BeatmapInfo
                 {
+#pragma warning disable 618
                     MaxCombo = apiBeatmap.MaxCombo,
+#pragma warning restore 618
                     Status = apiBeatmap.Status,
                     MD5Hash = apiBeatmap.MD5Hash
                 };
diff --git a/osu.Game/Scoring/ScoreInfo.cs b/osu.Game/Scoring/ScoreInfo.cs
index 4de1d580dc..d7185a1677 100644
--- a/osu.Game/Scoring/ScoreInfo.cs
+++ b/osu.Game/Scoring/ScoreInfo.cs
@@ -157,7 +157,7 @@ namespace osu.Game.Scoring
         public LocalisableString DisplayAccuracy => Accuracy.FormatAccuracy();
 
         /// <summary>
-        /// Whether this <see cref="EFScoreInfo"/> represents a legacy (osu!stable) score.
+        /// Whether this <see cref="ScoreInfo"/> represents a legacy (osu!stable) score.
         /// </summary>
         [Ignored]
         public bool IsLegacyScore => Mods.OfType<ModClassic>().Any();
diff --git a/osu.Game/Scoring/ScoreManager.cs b/osu.Game/Scoring/ScoreManager.cs
index 371cbbf597..83359838aa 100644
--- a/osu.Game/Scoring/ScoreManager.cs
+++ b/osu.Game/Scoring/ScoreManager.cs
@@ -160,8 +160,10 @@ namespace osu.Game.Scoring
             {
                 // This score is guaranteed to be an osu!stable score.
                 // The combo must be determined through either the beatmap's max combo value or the difficulty calculator, as lazer's scoring has changed and the score statistics cannot be used.
+#pragma warning disable CS0618
                 if (score.BeatmapInfo.MaxCombo != null)
                     return score.BeatmapInfo.MaxCombo.Value;
+#pragma warning restore CS0618
 
                 if (difficulties == null)
                     return null;

From 35e2e6a4e75eb2ab8e1ba9bc30d357971977f88d Mon Sep 17 00:00:00 2001
From: apollo-dw <83023433+apollo-dw@users.noreply.github.com>
Date: Sun, 20 Mar 2022 15:41:46 +0000
Subject: [PATCH 3597/5547] Remove slider tick judgement flag

---
 osu.Game.Rulesets.Osu/Objects/SliderTailCircle.cs | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Objects/SliderTailCircle.cs b/osu.Game.Rulesets.Osu/Objects/SliderTailCircle.cs
index 70459dc432..f9450062f4 100644
--- a/osu.Game.Rulesets.Osu/Objects/SliderTailCircle.cs
+++ b/osu.Game.Rulesets.Osu/Objects/SliderTailCircle.cs
@@ -14,14 +14,12 @@ namespace osu.Game.Rulesets.Osu.Objects
     /// </summary>
     public class SliderTailCircle : SliderEndCircle
     {
-        public bool JudgeAsSliderTick = false;
-
         public SliderTailCircle(Slider slider)
             : base(slider)
         {
         }
 
-        public override Judgement CreateJudgement() => JudgeAsSliderTick ? (OsuJudgement)new SliderTickJudgement() : new SliderTailJudgement();
+        public override Judgement CreateJudgement() => new SliderTailJudgement();
 
         public class SliderTailJudgement : OsuJudgement
         {

From d3742a91a80262ef7038665e6de01a3bb81f5060 Mon Sep 17 00:00:00 2001
From: apollo-dw <83023433+apollo-dw@users.noreply.github.com>
Date: Sun, 20 Mar 2022 15:56:41 +0000
Subject: [PATCH 3598/5547] Nest specific object classes within the mod

---
 .../StrictTrackingDrawableSliderTail.cs       | 12 ---
 .../Mods/Objects/StrictTrackingSlider.cs      | 70 ----------------
 .../Objects/StrictTrackingSliderTailCircle.cs | 19 -----
 .../Mods/OsuModStrictTracking.cs              | 81 ++++++++++++++++++-
 4 files changed, 80 insertions(+), 102 deletions(-)
 delete mode 100644 osu.Game.Rulesets.Osu/Mods/Objects/StrictTrackingDrawableSliderTail.cs
 delete mode 100644 osu.Game.Rulesets.Osu/Mods/Objects/StrictTrackingSlider.cs
 delete mode 100644 osu.Game.Rulesets.Osu/Mods/Objects/StrictTrackingSliderTailCircle.cs

diff --git a/osu.Game.Rulesets.Osu/Mods/Objects/StrictTrackingDrawableSliderTail.cs b/osu.Game.Rulesets.Osu/Mods/Objects/StrictTrackingDrawableSliderTail.cs
deleted file mode 100644
index 110b09f4f9..0000000000
--- a/osu.Game.Rulesets.Osu/Mods/Objects/StrictTrackingDrawableSliderTail.cs
+++ /dev/null
@@ -1,12 +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.Osu.Objects.Drawables;
-
-namespace osu.Game.Rulesets.Osu.Mods.Objects
-{
-    public class StrictTrackingDrawableSliderTail : DrawableSliderTail
-    {
-        public override bool DisplayResult => true;
-    }
-}
diff --git a/osu.Game.Rulesets.Osu/Mods/Objects/StrictTrackingSlider.cs b/osu.Game.Rulesets.Osu/Mods/Objects/StrictTrackingSlider.cs
deleted file mode 100644
index bf0a57d871..0000000000
--- a/osu.Game.Rulesets.Osu/Mods/Objects/StrictTrackingSlider.cs
+++ /dev/null
@@ -1,70 +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.Threading;
-using osu.Game.Rulesets.Objects;
-using osu.Game.Rulesets.Objects.Types;
-using osu.Game.Rulesets.Osu.Objects;
-
-namespace osu.Game.Rulesets.Osu.Mods.Objects
-{
-    public class StrictTrackingSlider : Slider
-    {
-        public StrictTrackingSlider(Slider original)
-        {
-            StartTime = original.StartTime;
-            Samples = original.Samples;
-            Path = original.Path;
-            NodeSamples = original.NodeSamples;
-            RepeatCount = original.RepeatCount;
-            Position = original.Position;
-            NewCombo = original.NewCombo;
-            ComboOffset = original.ComboOffset;
-            LegacyLastTickOffset = original.LegacyLastTickOffset;
-            TickDistanceMultiplier = original.TickDistanceMultiplier;
-        }
-
-        protected override void CreateNestedHitObjects(CancellationToken cancellationToken)
-        {
-            var sliderEvents = SliderEventGenerator.Generate(StartTime, SpanDuration, Velocity, TickDistance, Path.Distance, this.SpanCount(), LegacyLastTickOffset, cancellationToken);
-
-            foreach (var e in sliderEvents)
-            {
-                switch (e.Type)
-                {
-                    case SliderEventType.Head:
-                        AddNested(HeadCircle = new SliderHeadCircle
-                        {
-                            StartTime = e.Time,
-                            Position = Position,
-                            StackHeight = StackHeight,
-                        });
-                        break;
-
-                    case SliderEventType.LegacyLastTick:
-                        AddNested(TailCircle = new StrictTrackingSliderTailCircle(this)
-                        {
-                            RepeatIndex = e.SpanIndex,
-                            StartTime = e.Time,
-                            Position = EndPosition,
-                            StackHeight = StackHeight
-                        });
-                        break;
-
-                    case SliderEventType.Repeat:
-                        AddNested(new SliderRepeat(this)
-                        {
-                            RepeatIndex = e.SpanIndex,
-                            StartTime = StartTime + (e.SpanIndex + 1) * SpanDuration,
-                            Position = Position + Path.PositionAt(e.PathProgress),
-                            StackHeight = StackHeight,
-                            Scale = Scale,
-                        });
-                        break;
-                }
-            }
-
-            UpdateNestedSamples();
-        }
-    }
-}
diff --git a/osu.Game.Rulesets.Osu/Mods/Objects/StrictTrackingSliderTailCircle.cs b/osu.Game.Rulesets.Osu/Mods/Objects/StrictTrackingSliderTailCircle.cs
deleted file mode 100644
index 7d93f2cf39..0000000000
--- a/osu.Game.Rulesets.Osu/Mods/Objects/StrictTrackingSliderTailCircle.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.Game.Rulesets.Judgements;
-using osu.Game.Rulesets.Osu.Judgements;
-using osu.Game.Rulesets.Osu.Objects;
-
-namespace osu.Game.Rulesets.Osu.Mods.Objects
-{
-    public class StrictTrackingSliderTailCircle : SliderTailCircle
-    {
-        public StrictTrackingSliderTailCircle(Slider slider)
-            : base(slider)
-        {
-        }
-
-        public override Judgement CreateJudgement() => new OsuJudgement();
-    }
-}
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModStrictTracking.cs b/osu.Game.Rulesets.Osu/Mods/OsuModStrictTracking.cs
index b8d7134e5f..ee325db66a 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModStrictTracking.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModStrictTracking.cs
@@ -3,12 +3,16 @@
 
 using System;
 using System.Linq;
+using System.Threading;
 using osu.Framework.Graphics.Sprites;
 using osu.Game.Beatmaps;
+using osu.Game.Rulesets.Judgements;
 using osu.Game.Rulesets.Mods;
+using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Objects.Drawables;
+using osu.Game.Rulesets.Objects.Types;
 using osu.Game.Rulesets.Osu.Beatmaps;
-using osu.Game.Rulesets.Osu.Mods.Objects;
+using osu.Game.Rulesets.Osu.Judgements;
 using osu.Game.Rulesets.Osu.Objects;
 using osu.Game.Rulesets.Osu.Objects.Drawables;
 using osu.Game.Rulesets.UI;
@@ -65,5 +69,80 @@ namespace osu.Game.Rulesets.Osu.Mods
         {
             drawableRuleset.Playfield.RegisterPool<StrictTrackingSliderTailCircle, StrictTrackingDrawableSliderTail>(10, 100);
         }
+
+        private class StrictTrackingSliderTailCircle : SliderTailCircle
+        {
+            public StrictTrackingSliderTailCircle(Slider slider)
+                : base(slider)
+            {
+            }
+
+            public override Judgement CreateJudgement() => new OsuJudgement();
+        }
+
+        private class StrictTrackingDrawableSliderTail : DrawableSliderTail
+        {
+            public override bool DisplayResult => true;
+        }
+
+        private class StrictTrackingSlider : Slider
+        {
+            public StrictTrackingSlider(Slider original)
+            {
+                StartTime = original.StartTime;
+                Samples = original.Samples;
+                Path = original.Path;
+                NodeSamples = original.NodeSamples;
+                RepeatCount = original.RepeatCount;
+                Position = original.Position;
+                NewCombo = original.NewCombo;
+                ComboOffset = original.ComboOffset;
+                LegacyLastTickOffset = original.LegacyLastTickOffset;
+                TickDistanceMultiplier = original.TickDistanceMultiplier;
+            }
+
+            protected override void CreateNestedHitObjects(CancellationToken cancellationToken)
+            {
+                var sliderEvents = SliderEventGenerator.Generate(StartTime, SpanDuration, Velocity, TickDistance, Path.Distance, this.SpanCount(), LegacyLastTickOffset, cancellationToken);
+
+                foreach (var e in sliderEvents)
+                {
+                    switch (e.Type)
+                    {
+                        case SliderEventType.Head:
+                            AddNested(HeadCircle = new SliderHeadCircle
+                            {
+                                StartTime = e.Time,
+                                Position = Position,
+                                StackHeight = StackHeight,
+                            });
+                            break;
+
+                        case SliderEventType.LegacyLastTick:
+                            AddNested(TailCircle = new StrictTrackingSliderTailCircle(this)
+                            {
+                                RepeatIndex = e.SpanIndex,
+                                StartTime = e.Time,
+                                Position = EndPosition,
+                                StackHeight = StackHeight
+                            });
+                            break;
+
+                        case SliderEventType.Repeat:
+                            AddNested(new SliderRepeat(this)
+                            {
+                                RepeatIndex = e.SpanIndex,
+                                StartTime = StartTime + (e.SpanIndex + 1) * SpanDuration,
+                                Position = Position + Path.PositionAt(e.PathProgress),
+                                StackHeight = StackHeight,
+                                Scale = Scale,
+                            });
+                            break;
+                    }
+                }
+
+                UpdateNestedSamples();
+            }
+        }
     }
 }

From 8fbdd068951bf1f213f396aaa57fe51498a7c194 Mon Sep 17 00:00:00 2001
From: hwabis <kennysun23@gmail.com>
Date: Sun, 20 Mar 2022 16:24:41 -0400
Subject: [PATCH 3599/5547] add queue tab count test

---
 .../TestSceneMultiplayerPlaylist.cs           | 31 +++++++++++++++++++
 .../Graphics/UserInterface/OsuTabControl.cs   |  2 +-
 2 files changed, 32 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs
index 6b5b45b73e..af17458649 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs
@@ -11,6 +11,7 @@ using osu.Framework.Graphics;
 using osu.Framework.Platform;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
+using osu.Game.Graphics.UserInterface;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Rooms;
 using osu.Game.Rulesets;
@@ -129,6 +130,25 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddUntilStep("item 1 not in lists", () => !inHistoryList(0) && !inQueueList(0));
         }
 
+        [Test]
+        public void TestTabQueueListCount()
+        {
+            assertQueueTabCount(1);
+
+            addItemStep();
+            assertQueueTabCount(2);
+
+            addItemStep();
+            assertQueueTabCount(3);
+
+            AddStep("finish current item", () => MultiplayerClient.FinishCurrentItem().WaitSafely());
+            assertQueueTabCount(2);
+
+            AddStep("leave room", () => RoomManager.PartRoom());
+            AddUntilStep("wait for room part", () => !RoomJoined);
+            assertQueueTabCount(0);
+        }
+
         [Ignore("Expired items are initially removed from the room.")]
         [Test]
         public void TestJoinRoomWithMixedItemsAddedInCorrectLists()
@@ -213,6 +233,17 @@ namespace osu.Game.Tests.Visual.Multiplayer
             });
         }
 
+        private void assertQueueTabCount(int count)
+        {
+            string queueTabText = count > 0 ? $"Queue ({count})" : "Queue";
+            AddUntilStep($"Queue tab shows \"{queueTabText}\"", () =>
+            {
+                return this.ChildrenOfType<OsuTabControl<MultiplayerPlaylistDisplayMode>.OsuTabItem>()
+                           .First()
+                           .Text.Text.Equals(queueTabText);
+            });
+        }
+
         private void changeDisplayModeStep(MultiplayerPlaylistDisplayMode mode) => AddStep($"change list to {mode}", () => list.DisplayMode.Value = mode);
 
         private bool inQueueList(int playlistItemId)
diff --git a/osu.Game/Graphics/UserInterface/OsuTabControl.cs b/osu.Game/Graphics/UserInterface/OsuTabControl.cs
index 3572ea5c31..ab03669207 100644
--- a/osu.Game/Graphics/UserInterface/OsuTabControl.cs
+++ b/osu.Game/Graphics/UserInterface/OsuTabControl.cs
@@ -98,7 +98,7 @@ namespace osu.Game.Graphics.UserInterface
 
         public class OsuTabItem : TabItem<T>, IHasAccentColour
         {
-            protected readonly SpriteText Text;
+            public readonly SpriteText Text;
             protected readonly Box Bar;
 
             private Color4 accentColour;

From 63b668638462a9e92af2b1a1bb1d150ed540b6e3 Mon Sep 17 00:00:00 2001
From: hwabis <kennysun23@gmail.com>
Date: Sun, 20 Mar 2022 16:28:05 -0400
Subject: [PATCH 3600/5547] make test name clearer

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

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs
index af17458649..15b626ceeb 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs
@@ -131,7 +131,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         }
 
         [Test]
-        public void TestTabQueueListCount()
+        public void TestQueueTabCount()
         {
             assertQueueTabCount(1);
 

From 06136b2247c81868cb69ad3497fb681cc4e0e89d Mon Sep 17 00:00:00 2001
From: hwabis <kennysun23@gmail.com>
Date: Sun, 20 Mar 2022 21:37:02 -0400
Subject: [PATCH 3601/5547] Revert OsuTabItem Text to protected, update tab
 count test

---
 .../Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs       | 5 +++--
 osu.Game/Graphics/UserInterface/OsuTabControl.cs             | 2 +-
 2 files changed, 4 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs
index 15b626ceeb..cbd8b472b8 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs
@@ -11,6 +11,7 @@ using osu.Framework.Graphics;
 using osu.Framework.Platform;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
+using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Rooms;
@@ -239,8 +240,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddUntilStep($"Queue tab shows \"{queueTabText}\"", () =>
             {
                 return this.ChildrenOfType<OsuTabControl<MultiplayerPlaylistDisplayMode>.OsuTabItem>()
-                           .First()
-                           .Text.Text.Equals(queueTabText);
+                           .Single(t => t.Value == MultiplayerPlaylistDisplayMode.Queue)
+                           .ChildrenOfType<OsuSpriteText>().Single().Text == queueTabText;
             });
         }
 
diff --git a/osu.Game/Graphics/UserInterface/OsuTabControl.cs b/osu.Game/Graphics/UserInterface/OsuTabControl.cs
index ab03669207..3572ea5c31 100644
--- a/osu.Game/Graphics/UserInterface/OsuTabControl.cs
+++ b/osu.Game/Graphics/UserInterface/OsuTabControl.cs
@@ -98,7 +98,7 @@ namespace osu.Game.Graphics.UserInterface
 
         public class OsuTabItem : TabItem<T>, IHasAccentColour
         {
-            public readonly SpriteText Text;
+            protected readonly SpriteText Text;
             protected readonly Box Bar;
 
             private Color4 accentColour;

From 355b0fa3144915016411b3b26b931e5734d45da9 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 21 Mar 2022 13:49:55 +0900
Subject: [PATCH 3602/5547] Fix loading player via skin editor still allowing
 changing current audio track

`PlayerLoader` is required in the sequence to get the game into the
correct state for gameplay right now. Applying ths simplest fix here.

Closes https://github.com/ppy/osu/issues/17351.
---
 osu.Game/Skinning/Editor/SkinEditorSceneLibrary.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Skinning/Editor/SkinEditorSceneLibrary.cs b/osu.Game/Skinning/Editor/SkinEditorSceneLibrary.cs
index 5da6147e4c..eac13922d7 100644
--- a/osu.Game/Skinning/Editor/SkinEditorSceneLibrary.cs
+++ b/osu.Game/Skinning/Editor/SkinEditorSceneLibrary.cs
@@ -94,7 +94,7 @@ namespace osu.Game.Skinning.Editor
 
                                         var replayGeneratingMod = ruleset.Value.CreateInstance().GetAutoplayMod();
                                         if (replayGeneratingMod != null)
-                                            screen.Push(new ReplayPlayer((beatmap, mods) => replayGeneratingMod.CreateReplayScore(beatmap, mods)));
+                                            screen.Push(new PlayerLoader(() => new ReplayPlayer((beatmap, mods) => replayGeneratingMod.CreateReplayScore(beatmap, mods))));
                                     }, new[] { typeof(Player), typeof(SongSelect) })
                                 },
                             }

From f922a6b55607148c40189e29b6f3447fb1773dcc Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 21 Mar 2022 14:15:22 +0900
Subject: [PATCH 3603/5547] Rename renaming button/pill classes

---
 osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs       | 6 +++---
 ...hannelListItemClose.cs => ChannelListItemCloseButton.cs} | 2 +-
 ...nnelListItemMention.cs => ChannelListItemMentionPill.cs} | 2 +-
 3 files changed, 5 insertions(+), 5 deletions(-)
 rename osu.Game/Overlays/Chat/ChannelList/{ChannelListItemClose.cs => ChannelListItemCloseButton.cs} (93%)
 rename osu.Game/Overlays/Chat/ChannelList/{ChannelListItemMention.cs => ChannelListItemMentionPill.cs} (96%)

diff --git a/osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs b/osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs
index 583493181b..006cfdea3b 100644
--- a/osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs
+++ b/osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs
@@ -34,7 +34,7 @@ namespace osu.Game.Overlays.Chat.ChannelList
         private Box? hoverBox;
         private Box? selectBox;
         private OsuSpriteText? text;
-        private ChannelListItemClose? close;
+        private ChannelListItemCloseButton? close;
 
         [Resolved]
         private Bindable<Channel> selectedChannel { get; set; } = null!;
@@ -97,14 +97,14 @@ namespace osu.Game.Overlays.Chat.ChannelList
                                     RelativeSizeAxes = Axes.X,
                                     Truncate = true,
                                 },
-                                new ChannelListItemMention
+                                new ChannelListItemMentionPill
                                 {
                                     Anchor = Anchor.CentreLeft,
                                     Origin = Anchor.CentreLeft,
                                     Margin = new MarginPadding { Right = 3 },
                                     Mentions = { BindTarget = Mentions },
                                 },
-                                close = new ChannelListItemClose
+                                close = new ChannelListItemCloseButton
                                 {
                                     Anchor = Anchor.CentreLeft,
                                     Origin = Anchor.CentreLeft,
diff --git a/osu.Game/Overlays/Chat/ChannelList/ChannelListItemClose.cs b/osu.Game/Overlays/Chat/ChannelList/ChannelListItemCloseButton.cs
similarity index 93%
rename from osu.Game/Overlays/Chat/ChannelList/ChannelListItemClose.cs
rename to osu.Game/Overlays/Chat/ChannelList/ChannelListItemCloseButton.cs
index 37a1fcdde7..3e595093b4 100644
--- a/osu.Game/Overlays/Chat/ChannelList/ChannelListItemClose.cs
+++ b/osu.Game/Overlays/Chat/ChannelList/ChannelListItemCloseButton.cs
@@ -12,7 +12,7 @@ using osuTK;
 
 namespace osu.Game.Overlays.Chat.ChannelList
 {
-    public class ChannelListItemClose : OsuAnimatedButton
+    public class ChannelListItemCloseButton : OsuAnimatedButton
     {
         [BackgroundDependencyLoader]
         private void load(OsuColour osuColour)
diff --git a/osu.Game/Overlays/Chat/ChannelList/ChannelListItemMention.cs b/osu.Game/Overlays/Chat/ChannelList/ChannelListItemMentionPill.cs
similarity index 96%
rename from osu.Game/Overlays/Chat/ChannelList/ChannelListItemMention.cs
rename to osu.Game/Overlays/Chat/ChannelList/ChannelListItemMentionPill.cs
index 3a1c3b7619..165756cfcd 100644
--- a/osu.Game/Overlays/Chat/ChannelList/ChannelListItemMention.cs
+++ b/osu.Game/Overlays/Chat/ChannelList/ChannelListItemMentionPill.cs
@@ -14,7 +14,7 @@ using osuTK;
 
 namespace osu.Game.Overlays.Chat.ChannelList
 {
-    public class ChannelListItemMention : CircularContainer
+    public class ChannelListItemMentionPill : CircularContainer
     {
         public readonly BindableInt Mentions = new BindableInt();
 

From 9eda2f2df126f28079b05e9c87955fb08dd63364 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 21 Mar 2022 14:25:29 +0900
Subject: [PATCH 3604/5547] Remove box surrounding close button

---
 .../ChannelList/ChannelListItemCloseButton.cs | 43 +++++++++++++++++--
 1 file changed, 39 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Overlays/Chat/ChannelList/ChannelListItemCloseButton.cs b/osu.Game/Overlays/Chat/ChannelList/ChannelListItemCloseButton.cs
index 3e595093b4..a5876c8ad8 100644
--- a/osu.Game/Overlays/Chat/ChannelList/ChannelListItemCloseButton.cs
+++ b/osu.Game/Overlays/Chat/ChannelList/ChannelListItemCloseButton.cs
@@ -6,28 +6,63 @@
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Sprites;
+using osu.Framework.Input.Events;
 using osu.Game.Graphics;
-using osu.Game.Graphics.UserInterface;
+using osu.Game.Graphics.Containers;
 using osuTK;
+using osuTK.Graphics;
 
 namespace osu.Game.Overlays.Chat.ChannelList
 {
-    public class ChannelListItemCloseButton : OsuAnimatedButton
+    public class ChannelListItemCloseButton : OsuClickableContainer
     {
+        private SpriteIcon icon = null!;
+
+        private Color4 normalColour;
+        private Color4 hoveredColour;
+
         [BackgroundDependencyLoader]
         private void load(OsuColour osuColour)
         {
+            normalColour = osuColour.Red2;
+            hoveredColour = Color4.White;
+
             Alpha = 0f;
             Size = new Vector2(20);
-            Add(new SpriteIcon
+            Add(icon = new SpriteIcon
             {
                 Anchor = Anchor.Centre,
                 Origin = Anchor.Centre,
                 Scale = new Vector2(0.75f),
                 Icon = FontAwesome.Solid.TimesCircle,
                 RelativeSizeAxes = Axes.Both,
-                Colour = osuColour.Red1,
+                Colour = normalColour,
             });
         }
+
+        // Transforms matching OsuAnimatedButton
+        protected override bool OnHover(HoverEvent e)
+        {
+            icon.FadeColour(hoveredColour, 300, Easing.OutQuint);
+            return base.OnHover(e);
+        }
+
+        protected override void OnHoverLost(HoverLostEvent e)
+        {
+            icon.FadeColour(normalColour, 300, Easing.OutQuint);
+            base.OnHoverLost(e);
+        }
+
+        protected override bool OnMouseDown(MouseDownEvent e)
+        {
+            icon.ScaleTo(0.75f, 2000, Easing.OutQuint);
+            return base.OnMouseDown(e);
+        }
+
+        protected override void OnMouseUp(MouseUpEvent e)
+        {
+            icon.ScaleTo(1, 1000, Easing.OutElastic);
+            base.OnMouseUp(e);
+        }
     }
 }

From 11b050b66b66d189c9f84a740709ff72b7674aa2 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 21 Mar 2022 14:28:12 +0900
Subject: [PATCH 3605/5547] Add slight fade when hovering `ChannelListItem`s

---
 osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs b/osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs
index 006cfdea3b..9dc0529ce4 100644
--- a/osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs
+++ b/osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs
@@ -140,15 +140,15 @@ namespace osu.Game.Overlays.Chat.ChannelList
 
         protected override bool OnHover(HoverEvent e)
         {
-            hoverBox?.Show();
-            close?.Show();
+            hoverBox?.FadeIn(300, Easing.OutQuint);
+            close?.FadeIn(300, Easing.OutQuint);
             return base.OnHover(e);
         }
 
         protected override void OnHoverLost(HoverLostEvent e)
         {
-            hoverBox?.Hide();
-            close?.Hide();
+            hoverBox?.FadeOut(200, Easing.OutQuint);
+            close?.FadeOut(200, Easing.OutQuint);
             base.OnHoverLost(e);
         }
 

From 692362131ef80b4990d2b7437c5b10c818513b02 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 21 Mar 2022 14:31:51 +0900
Subject: [PATCH 3606/5547] Add animation when mention pill appears (or a new
 message arrives)

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

diff --git a/osu.Game/Overlays/Chat/ChannelList/ChannelListItemMentionPill.cs b/osu.Game/Overlays/Chat/ChannelList/ChannelListItemMentionPill.cs
index 165756cfcd..5018c8cd64 100644
--- a/osu.Game/Overlays/Chat/ChannelList/ChannelListItemMentionPill.cs
+++ b/osu.Game/Overlays/Chat/ChannelList/ChannelListItemMentionPill.cs
@@ -11,6 +11,7 @@ using osu.Framework.Graphics.Shapes;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
 using osuTK;
+using osuTK.Graphics;
 
 namespace osu.Game.Overlays.Chat.ChannelList
 {
@@ -20,6 +21,8 @@ namespace osu.Game.Overlays.Chat.ChannelList
 
         private OsuSpriteText countText = null!;
 
+        private Box box = null!;
+
         [BackgroundDependencyLoader]
         private void load(OsuColour osuColour, OverlayColourProvider colourProvider)
         {
@@ -29,7 +32,7 @@ namespace osu.Game.Overlays.Chat.ChannelList
 
             Children = new Drawable[]
             {
-                new Box
+                box = new Box
                 {
                     RelativeSizeAxes = Axes.Both,
                     Colour = osuColour.Orange1,
@@ -56,9 +59,12 @@ namespace osu.Game.Overlays.Chat.ChannelList
                 countText.Text = mentionCount > 99 ? "99+" : mentionCount.ToString();
 
                 if (mentionCount > 0)
-                    Show();
+                {
+                    this.FadeIn(1000, Easing.OutQuint);
+                    box.FlashColour(Color4.White, 500, Easing.OutQuint);
+                }
                 else
-                    Hide();
+                    this.FadeOut(100, Easing.OutQuint);
             }, true);
         }
     }

From 5104e4db21ef5eec39bf463ea59cc2f1dfafc96f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 21 Mar 2022 14:33:50 +0900
Subject: [PATCH 3607/5547] Add step to `TestSceneChannelListItem` to actually
 select an item

---
 osu.Game.Tests/Visual/Online/TestSceneChannelListItem.cs | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneChannelListItem.cs b/osu.Game.Tests/Visual/Online/TestSceneChannelListItem.cs
index ac829f8cbc..af419c8b91 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneChannelListItem.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneChannelListItem.cs
@@ -3,6 +3,7 @@
 
 using NUnit.Framework;
 using System.Collections.Generic;
+using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
@@ -114,6 +115,8 @@ namespace osu.Game.Tests.Visual.Online
         [Test]
         public void TestVisual()
         {
+            AddStep("Select second item", () => selected.Value = channels.Skip(1).First());
+
             AddStep("Unread Selected", () =>
             {
                 if (selected.Value != null)

From 16caf2d30b989917100589f6fe072354995bf9b4 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 21 Mar 2022 14:34:54 +0900
Subject: [PATCH 3608/5547] Add slight animation when highlighting an unread
 channel

---
 osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs b/osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs
index 9dc0529ce4..8cf37fd0d5 100644
--- a/osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs
+++ b/osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs
@@ -134,7 +134,7 @@ namespace osu.Game.Overlays.Chat.ChannelList
 
             Unread.BindValueChanged(change =>
             {
-                text!.Colour = change.NewValue ? colourProvider.Content1 : colourProvider.Light3;
+                text!.FadeColour(change.NewValue ? colourProvider.Content1 : colourProvider.Light3, 300, Easing.OutQuint);
             }, true);
         }
 

From 428e439f40e1a1c0c4cf665d3e3138ebe785ec34 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 21 Mar 2022 14:36:55 +0900
Subject: [PATCH 3609/5547] Remove space between '#' and channel name

This was in flyte's design (he was following discord) but doesn't feel
too correct when it's not aligned with anything else. We can revisit
this if/when we have better glyphs to represent channel types.
---
 osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs b/osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs
index 8cf37fd0d5..f3bbe101de 100644
--- a/osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs
+++ b/osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs
@@ -90,7 +90,7 @@ namespace osu.Game.Overlays.Chat.ChannelList
                                 {
                                     Anchor = Anchor.CentreLeft,
                                     Origin = Anchor.CentreLeft,
-                                    Text = channel.Type == ChannelType.Public ? $"# {channel.Name.Substring(1)}" : channel.Name,
+                                    Text = channel.Name,
                                     Font = OsuFont.Torus.With(size: 17, weight: FontWeight.SemiBold),
                                     Colour = colourProvider.Light3,
                                     Margin = new MarginPadding { Bottom = 2 },

From 7ca3beb7cc5ef647e51a1d2aa9f858b25c44cedd Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 21 Mar 2022 14:41:42 +0900
Subject: [PATCH 3610/5547] Also add fade to `ChannelItem` selected box

---
 osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs b/osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs
index f3bbe101de..43574351ed 100644
--- a/osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs
+++ b/osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs
@@ -127,9 +127,9 @@ namespace osu.Game.Overlays.Chat.ChannelList
             selectedChannel.BindValueChanged(change =>
             {
                 if (change.NewValue == channel)
-                    selectBox?.Show();
+                    selectBox?.FadeIn(300, Easing.OutQuint);
                 else
-                    selectBox?.Hide();
+                    selectBox?.FadeOut(200, Easing.OutQuint);
             }, true);
 
             Unread.BindValueChanged(change =>

From 3bb01fd59583939aa46e5e8e18189375cc222d24 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 21 Mar 2022 14:41:57 +0900
Subject: [PATCH 3611/5547] Fix close button animation not being applied
 correct on mouse down due to conflicting scales

---
 .../Overlays/Chat/ChannelList/ChannelListItemCloseButton.cs     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/Chat/ChannelList/ChannelListItemCloseButton.cs b/osu.Game/Overlays/Chat/ChannelList/ChannelListItemCloseButton.cs
index a5876c8ad8..65b9c4a79b 100644
--- a/osu.Game/Overlays/Chat/ChannelList/ChannelListItemCloseButton.cs
+++ b/osu.Game/Overlays/Chat/ChannelList/ChannelListItemCloseButton.cs
@@ -33,7 +33,7 @@ namespace osu.Game.Overlays.Chat.ChannelList
             {
                 Anchor = Anchor.Centre,
                 Origin = Anchor.Centre,
-                Scale = new Vector2(0.75f),
+                Size = new Vector2(0.75f),
                 Icon = FontAwesome.Solid.TimesCircle,
                 RelativeSizeAxes = Axes.Both,
                 Colour = normalColour,

From b42081dd9bca5e574fa6fe0b0af576a99a53ffa2 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 21 Mar 2022 16:06:32 +0900
Subject: [PATCH 3612/5547] Add `DangerousButton` for use in popup dialogs

---
 .../UserInterface/TestScenePopupDialog.cs     |  4 ++
 .../Graphics/UserInterface/DialogButton.cs    | 19 +++---
 .../Dialog/PopupDialogDangerousButton.cs      | 59 +++++++++++++++++++
 3 files changed, 73 insertions(+), 9 deletions(-)
 create mode 100644 osu.Game/Overlays/Dialog/PopupDialogDangerousButton.cs

diff --git a/osu.Game.Tests/Visual/UserInterface/TestScenePopupDialog.cs b/osu.Game.Tests/Visual/UserInterface/TestScenePopupDialog.cs
index 8e53c7c402..6bd6115e68 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestScenePopupDialog.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestScenePopupDialog.cs
@@ -40,6 +40,10 @@ namespace osu.Game.Tests.Visual.UserInterface
                     {
                         Text = @"You're a fake!",
                     },
+                    new PopupDialogDangerousButton
+                    {
+                        Text = @"Careful with this one..",
+                    },
                 };
             }
         }
diff --git a/osu.Game/Graphics/UserInterface/DialogButton.cs b/osu.Game/Graphics/UserInterface/DialogButton.cs
index 2f9e4dae51..ad69ec4078 100644
--- a/osu.Game/Graphics/UserInterface/DialogButton.cs
+++ b/osu.Game/Graphics/UserInterface/DialogButton.cs
@@ -45,8 +45,9 @@ namespace osu.Game.Graphics.UserInterface
             }
         }
 
+        protected readonly Container ColourContainer;
+
         private readonly Container backgroundContainer;
-        private readonly Container colourContainer;
         private readonly Container glowContainer;
         private readonly Box leftGlow;
         private readonly Box centerGlow;
@@ -113,7 +114,7 @@ namespace osu.Game.Graphics.UserInterface
                     Masking = true,
                     Children = new Drawable[]
                     {
-                        colourContainer = new Container
+                        ColourContainer = new Container
                         {
                             RelativeSizeAxes = Axes.Both,
                             Origin = Anchor.Centre,
@@ -182,7 +183,7 @@ namespace osu.Game.Graphics.UserInterface
             {
                 buttonColour = value;
                 updateGlow();
-                colourContainer.Colour = value;
+                ColourContainer.Colour = value;
             }
         }
 
@@ -230,11 +231,11 @@ namespace osu.Game.Graphics.UserInterface
                 Alpha = 0.05f
             };
 
-            colourContainer.Add(flash);
+            ColourContainer.Add(flash);
             flash.FadeOutFromOne(100).Expire();
 
             clickAnimating = true;
-            colourContainer.ResizeWidthTo(colourContainer.Width * 1.05f, 100, Easing.OutQuint)
+            ColourContainer.ResizeWidthTo(ColourContainer.Width * 1.05f, 100, Easing.OutQuint)
                            .OnComplete(_ =>
                            {
                                clickAnimating = false;
@@ -246,14 +247,14 @@ namespace osu.Game.Graphics.UserInterface
 
         protected override bool OnMouseDown(MouseDownEvent e)
         {
-            colourContainer.ResizeWidthTo(hover_width * 0.98f, click_duration * 4, Easing.OutQuad);
+            ColourContainer.ResizeWidthTo(hover_width * 0.98f, click_duration * 4, Easing.OutQuad);
             return base.OnMouseDown(e);
         }
 
         protected override void OnMouseUp(MouseUpEvent e)
         {
             if (State == SelectionState.Selected)
-                colourContainer.ResizeWidthTo(hover_width, click_duration, Easing.In);
+                ColourContainer.ResizeWidthTo(hover_width, click_duration, Easing.In);
             base.OnMouseUp(e);
         }
 
@@ -279,12 +280,12 @@ namespace osu.Game.Graphics.UserInterface
             if (newState == SelectionState.Selected)
             {
                 spriteText.TransformSpacingTo(hoverSpacing, hover_duration, Easing.OutElastic);
-                colourContainer.ResizeWidthTo(hover_width, hover_duration, Easing.OutElastic);
+                ColourContainer.ResizeWidthTo(hover_width, hover_duration, Easing.OutElastic);
                 glowContainer.FadeIn(hover_duration, Easing.OutQuint);
             }
             else
             {
-                colourContainer.ResizeWidthTo(idle_width, hover_duration, Easing.OutElastic);
+                ColourContainer.ResizeWidthTo(idle_width, hover_duration, Easing.OutElastic);
                 spriteText.TransformSpacingTo(Vector2.Zero, hover_duration, Easing.OutElastic);
                 glowContainer.FadeOut(hover_duration, Easing.OutQuint);
             }
diff --git a/osu.Game/Overlays/Dialog/PopupDialogDangerousButton.cs b/osu.Game/Overlays/Dialog/PopupDialogDangerousButton.cs
new file mode 100644
index 0000000000..1911a4fa56
--- /dev/null
+++ b/osu.Game/Overlays/Dialog/PopupDialogDangerousButton.cs
@@ -0,0 +1,59 @@
+// 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.Shapes;
+using osu.Framework.Input.Events;
+using osu.Game.Graphics;
+using osu.Game.Graphics.Containers;
+
+namespace osu.Game.Overlays.Dialog
+{
+    public class PopupDialogDangerousButton : PopupDialogButton
+    {
+        [BackgroundDependencyLoader]
+        private void load(OsuColour colours)
+        {
+            ButtonColour = colours.Red3;
+
+            ColourContainer.Add(new ConfirmFillBox
+            {
+                Action = () => Action(),
+                RelativeSizeAxes = Axes.Both,
+                Blending = BlendingParameters.Additive,
+            });
+        }
+
+        private class ConfirmFillBox : HoldToConfirmContainer
+        {
+            private Box box;
+
+            protected override double? HoldActivationDelay => 500;
+
+            protected override void LoadComplete()
+            {
+                base.LoadComplete();
+
+                Child = box = new Box
+                {
+                    RelativeSizeAxes = Axes.Both,
+                };
+
+                Progress.BindValueChanged(progress => box.Width = (float)progress.NewValue, true);
+            }
+
+            protected override bool OnMouseDown(MouseDownEvent e)
+            {
+                BeginConfirm();
+                return true;
+            }
+
+            protected override void OnMouseUp(MouseUpEvent e)
+            {
+                if (!e.HasAnyButtonPressed)
+                    AbortConfirm();
+            }
+        }
+    }
+}

From d811a70f4b42cb638a6cc6be169acfb0f99275f9 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 21 Mar 2022 16:06:58 +0900
Subject: [PATCH 3613/5547] Change button types on editor exit dialog to match
 purpose

Addresses https://github.com/ppy/osu/discussions/17363.
---
 osu.Game/Screens/Edit/PromptForSaveDialog.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/Edit/PromptForSaveDialog.cs b/osu.Game/Screens/Edit/PromptForSaveDialog.cs
index e308a9533d..4f70491ade 100644
--- a/osu.Game/Screens/Edit/PromptForSaveDialog.cs
+++ b/osu.Game/Screens/Edit/PromptForSaveDialog.cs
@@ -17,12 +17,12 @@ namespace osu.Game.Screens.Edit
 
             Buttons = new PopupDialogButton[]
             {
-                new PopupDialogCancelButton
+                new PopupDialogOkButton
                 {
                     Text = @"Save my masterpiece!",
                     Action = saveAndExit
                 },
-                new PopupDialogOkButton
+                new PopupDialogDangerousButton
                 {
                     Text = @"Forget all changes",
                     Action = exit

From 36868dbdb4d8f480ebbbd68d268c4e35c8fd4ba0 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 21 Mar 2022 16:07:26 +0900
Subject: [PATCH 3614/5547] Add the ability to override the user setting for
 hold-to-confirm containers

Sometimes the user is not right.
---
 .../Graphics/Containers/HoldToConfirmContainer.cs    | 12 +++++++++++-
 1 file changed, 11 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Graphics/Containers/HoldToConfirmContainer.cs b/osu.Game/Graphics/Containers/HoldToConfirmContainer.cs
index 999dd183aa..b2f08eee0a 100644
--- a/osu.Game/Graphics/Containers/HoldToConfirmContainer.cs
+++ b/osu.Game/Graphics/Containers/HoldToConfirmContainer.cs
@@ -28,6 +28,14 @@ namespace osu.Game.Graphics.Containers
         /// </summary>
         protected virtual bool AllowMultipleFires => false;
 
+        /// <summary>
+        /// Specify a custom activation delay, overriding the game-wide user setting.
+        /// </summary>
+        /// <remarks>
+        /// This should be used in special cases where we want to be extra sure the user knows what they are doing. An example is when changes would be lost.
+        /// </remarks>
+        protected virtual double? HoldActivationDelay => null;
+
         public Bindable<double> Progress = new BindableDouble();
 
         private Bindable<double> holdActivationDelay;
@@ -35,7 +43,9 @@ namespace osu.Game.Graphics.Containers
         [BackgroundDependencyLoader]
         private void load(OsuConfigManager config)
         {
-            holdActivationDelay = config.GetBindable<double>(OsuSetting.UIHoldActivationDelay);
+            holdActivationDelay = HoldActivationDelay != null
+                ? new Bindable<double>(HoldActivationDelay.Value)
+                : config.GetBindable<double>(OsuSetting.UIHoldActivationDelay);
         }
 
         protected void BeginConfirm()

From 3643f879e42fda75f2e2308c098f7fa2fbcf1bd8 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 21 Mar 2022 17:01:46 +0900
Subject: [PATCH 3615/5547] Add test coverage of skin editor settings slider
 not working via keyboard adjustments

---
 .../Visual/Gameplay/TestSceneSkinEditor.cs    | 37 ++++++++-
 .../Navigation/TestSceneScreenNavigation.cs   | 77 ++++++++++++++++++-
 .../Skinning/Editor/SkinEditorSceneLibrary.cs |  3 +-
 3 files changed, 113 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSkinEditor.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSkinEditor.cs
index e74345aae9..38d83058c0 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSkinEditor.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSkinEditor.cs
@@ -1,14 +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 System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
+using osu.Framework.Graphics.UserInterface;
 using osu.Framework.Testing;
 using osu.Game.Overlays;
+using osu.Game.Overlays.Settings;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Osu;
+using osu.Game.Screens.Play.HUD.HitErrorMeters;
 using osu.Game.Skinning.Editor;
+using osuTK.Input;
 
 namespace osu.Game.Tests.Visual.Gameplay
 {
@@ -29,7 +34,7 @@ namespace osu.Game.Tests.Visual.Gameplay
             AddStep("reload skin editor", () =>
             {
                 skinEditor?.Expire();
-                Player.ScaleTo(0.8f);
+                Player.ScaleTo(0.4f);
                 LoadComponentAsync(skinEditor = new SkinEditor(Player), Add);
             });
         }
@@ -40,6 +45,36 @@ namespace osu.Game.Tests.Visual.Gameplay
             AddToggleStep("toggle editor visibility", visible => skinEditor.ToggleVisibility());
         }
 
+        [Test]
+        public void TestEditComponent()
+        {
+            BarHitErrorMeter hitErrorMeter = null;
+
+            AddStep("select bar hit error blueprint", () =>
+            {
+                var blueprint = skinEditor.ChildrenOfType<SkinBlueprint>().First(b => b.Item is BarHitErrorMeter);
+
+                hitErrorMeter = (BarHitErrorMeter)blueprint.Item;
+                skinEditor.SelectedComponents.Clear();
+                skinEditor.SelectedComponents.Add(blueprint.Item);
+            });
+
+            AddAssert("value is default", () => hitErrorMeter.JudgementLineThickness.IsDefault);
+
+            AddStep("hover first slider", () =>
+            {
+                InputManager.MoveMouseTo(
+                    skinEditor.ChildrenOfType<SkinSettingsToolbox>().First()
+                              .ChildrenOfType<SettingsSlider<float>>().First()
+                              .ChildrenOfType<SliderBar<float>>().First()
+                );
+            });
+
+            AddStep("adjust slider via keyboard", () => InputManager.Key(Key.Left));
+
+            AddAssert("value is less than default", () => hitErrorMeter.JudgementLineThickness.Value < hitErrorMeter.JudgementLineThickness.Default);
+        }
+
         protected override Ruleset CreatePlayerRuleset() => new OsuRuleset();
     }
 }
diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs b/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
index f2e6aa1e16..46266e844a 100644
--- a/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
@@ -7,6 +7,7 @@ using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Extensions;
 using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.UserInterface;
 using osu.Framework.Screens;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
@@ -14,6 +15,7 @@ using osu.Game.Graphics.UserInterface;
 using osu.Game.Online.Leaderboards;
 using osu.Game.Overlays;
 using osu.Game.Overlays.Mods;
+using osu.Game.Overlays.Settings;
 using osu.Game.Overlays.Toolbar;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Osu.Mods;
@@ -21,10 +23,12 @@ using osu.Game.Scoring;
 using osu.Game.Screens.Menu;
 using osu.Game.Screens.OnlinePlay.Lounge;
 using osu.Game.Screens.Play;
+using osu.Game.Screens.Play.HUD.HitErrorMeters;
 using osu.Game.Screens.Ranking;
 using osu.Game.Screens.Select;
 using osu.Game.Screens.Select.Leaderboards;
 using osu.Game.Screens.Select.Options;
+using osu.Game.Skinning.Editor;
 using osu.Game.Tests.Beatmaps.IO;
 using osuTK;
 using osuTK.Input;
@@ -66,6 +70,73 @@ namespace osu.Game.Tests.Visual.Navigation
             AddAssert("Overlay was shown", () => songSelect.ModSelectOverlay.State.Value == Visibility.Visible);
         }
 
+        [Test]
+        public void TestEditComponentDuringGameplay()
+        {
+            Screens.Select.SongSelect songSelect = null;
+            PushAndConfirm(() => songSelect = new TestPlaySongSelect());
+            AddUntilStep("wait for song select", () => songSelect.BeatmapSetsLoaded);
+
+            AddStep("import beatmap", () => BeatmapImportHelper.LoadQuickOszIntoOsu(Game).WaitSafely());
+
+            AddUntilStep("wait for selected", () => !Game.Beatmap.IsDefault);
+
+            SkinEditor skinEditor = null;
+
+            AddStep("open skin editor", () =>
+            {
+                InputManager.PressKey(Key.ControlLeft);
+                InputManager.PressKey(Key.ShiftLeft);
+                InputManager.Key(Key.S);
+                InputManager.ReleaseKey(Key.ControlLeft);
+                InputManager.ReleaseKey(Key.ShiftLeft);
+            });
+
+            AddUntilStep("get skin editor", () => (skinEditor = Game.ChildrenOfType<SkinEditor>().FirstOrDefault()) != null);
+
+            AddStep("Click gameplay scene button", () =>
+            {
+                skinEditor.ChildrenOfType<SkinEditorSceneLibrary.SceneButton>().First(b => b.Text == "Gameplay").TriggerClick();
+            });
+
+            AddUntilStep("wait for player", () =>
+            {
+                // dismiss any notifications that may appear (ie. muted notification).
+                clickMouseInCentre();
+                return Game.ScreenStack.CurrentScreen is Player;
+            });
+
+            BarHitErrorMeter hitErrorMeter = null;
+
+            AddUntilStep("select bar hit error blueprint", () =>
+            {
+                var blueprint = skinEditor.ChildrenOfType<SkinBlueprint>().FirstOrDefault(b => b.Item is BarHitErrorMeter);
+
+                if (blueprint == null)
+                    return false;
+
+                hitErrorMeter = (BarHitErrorMeter)blueprint.Item;
+                skinEditor.SelectedComponents.Clear();
+                skinEditor.SelectedComponents.Add(blueprint.Item);
+                return true;
+            });
+
+            AddAssert("value is default", () => hitErrorMeter.JudgementLineThickness.IsDefault);
+
+            AddStep("hover first slider", () =>
+            {
+                InputManager.MoveMouseTo(
+                    skinEditor.ChildrenOfType<SkinSettingsToolbox>().First()
+                              .ChildrenOfType<SettingsSlider<float>>().First()
+                              .ChildrenOfType<SliderBar<float>>().First()
+                );
+            });
+
+            AddStep("adjust slider via keyboard", () => InputManager.Key(Key.Left));
+
+            AddAssert("value is less than default", () => hitErrorMeter.JudgementLineThickness.Value < hitErrorMeter.JudgementLineThickness.Default);
+        }
+
         [Test]
         public void TestRetryCountIncrements()
         {
@@ -120,7 +191,8 @@ namespace osu.Game.Tests.Visual.Navigation
 
             AddStep("press back button", () => Game.ChildrenOfType<BackButton>().First().Action());
 
-            AddStep("show local scores", () => Game.ChildrenOfType<BeatmapDetailAreaTabControl>().First().Current.Value = new BeatmapDetailAreaLeaderboardTabItem<BeatmapLeaderboardScope>(BeatmapLeaderboardScope.Local));
+            AddStep("show local scores",
+                () => Game.ChildrenOfType<BeatmapDetailAreaTabControl>().First().Current.Value = new BeatmapDetailAreaLeaderboardTabItem<BeatmapLeaderboardScope>(BeatmapLeaderboardScope.Local));
 
             AddUntilStep("wait for score displayed", () => (scorePanel = Game.ChildrenOfType<LeaderboardScore>().FirstOrDefault(s => s.Score.Equals(score))) != null);
 
@@ -152,7 +224,8 @@ namespace osu.Game.Tests.Visual.Navigation
 
             AddStep("press back button", () => Game.ChildrenOfType<BackButton>().First().Action());
 
-            AddStep("show local scores", () => Game.ChildrenOfType<BeatmapDetailAreaTabControl>().First().Current.Value = new BeatmapDetailAreaLeaderboardTabItem<BeatmapLeaderboardScope>(BeatmapLeaderboardScope.Local));
+            AddStep("show local scores",
+                () => Game.ChildrenOfType<BeatmapDetailAreaTabControl>().First().Current.Value = new BeatmapDetailAreaLeaderboardTabItem<BeatmapLeaderboardScope>(BeatmapLeaderboardScope.Local));
 
             AddUntilStep("wait for score displayed", () => (scorePanel = Game.ChildrenOfType<LeaderboardScore>().FirstOrDefault(s => s.Score.Equals(score))) != null);
 
diff --git a/osu.Game/Skinning/Editor/SkinEditorSceneLibrary.cs b/osu.Game/Skinning/Editor/SkinEditorSceneLibrary.cs
index eac13922d7..4a7cce5a97 100644
--- a/osu.Game/Skinning/Editor/SkinEditorSceneLibrary.cs
+++ b/osu.Game/Skinning/Editor/SkinEditorSceneLibrary.cs
@@ -8,6 +8,7 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Screens;
+using osu.Game.Beatmaps;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
@@ -104,7 +105,7 @@ namespace osu.Game.Skinning.Editor
             };
         }
 
-        private class SceneButton : OsuButton
+        public class SceneButton : OsuButton
         {
             public SceneButton()
             {

From 2f18c512cd48d594876f9222bb33bc9ca281468c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 21 Mar 2022 16:52:06 +0900
Subject: [PATCH 3616/5547] Convert `SkinEditorOverlay` to an
 `OverlayContainer` to allow it to block input

---
 osu.Game/OsuGame.cs                           |  4 +++
 .../Overlays/Settings/Sections/SkinSection.cs |  2 +-
 osu.Game/Skinning/Editor/SkinEditorOverlay.cs | 30 +++++++------------
 3 files changed, 15 insertions(+), 21 deletions(-)

diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index 25bd3d71de..4cd954a646 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -1046,6 +1046,10 @@ namespace osu.Game
 
             switch (e.Action)
             {
+                case GlobalAction.ToggleSkinEditor:
+                    skinEditor.ToggleVisibility();
+                    return true;
+
                 case GlobalAction.ResetInputSettings:
                     Host.ResetInputHandlers();
                     frameworkConfig.GetBindable<ConfineMouseMode>(FrameworkSetting.ConfineMouseMode).SetDefault();
diff --git a/osu.Game/Overlays/Settings/Sections/SkinSection.cs b/osu.Game/Overlays/Settings/Sections/SkinSection.cs
index 475c4bff8d..a34776ddf0 100644
--- a/osu.Game/Overlays/Settings/Sections/SkinSection.cs
+++ b/osu.Game/Overlays/Settings/Sections/SkinSection.cs
@@ -64,7 +64,7 @@ namespace osu.Game.Overlays.Settings.Sections
                 new SettingsButton
                 {
                     Text = SkinSettingsStrings.SkinLayoutEditor,
-                    Action = () => skinEditor?.Toggle(),
+                    Action = () => skinEditor?.ToggleVisibility(),
                 },
                 new ExportSkinButton(),
             };
diff --git a/osu.Game/Skinning/Editor/SkinEditorOverlay.cs b/osu.Game/Skinning/Editor/SkinEditorOverlay.cs
index 9fc233d3e3..970a27285e 100644
--- a/osu.Game/Skinning/Editor/SkinEditorOverlay.cs
+++ b/osu.Game/Skinning/Editor/SkinEditorOverlay.cs
@@ -19,10 +19,12 @@ namespace osu.Game.Skinning.Editor
     /// A container which handles loading a skin editor on user request for a specified target.
     /// This also handles the scaling / positioning adjustment of the target.
     /// </summary>
-    public class SkinEditorOverlay : CompositeDrawable, IKeyBindingHandler<GlobalAction>
+    public class SkinEditorOverlay : OverlayContainer, IKeyBindingHandler<GlobalAction>
     {
         private readonly ScalingContainer scalingContainer;
 
+        protected override bool BlockNonPositionalInput => true;
+
         [CanBeNull]
         private SkinEditor skinEditor;
 
@@ -49,30 +51,12 @@ namespace osu.Game.Skinning.Editor
 
                     Hide();
                     return true;
-
-                case GlobalAction.ToggleSkinEditor:
-                    Toggle();
-                    return true;
             }
 
             return false;
         }
 
-        public void Toggle()
-        {
-            if (skinEditor == null)
-                Show();
-            else
-                skinEditor.ToggleVisibility();
-        }
-
-        public override void Hide()
-        {
-            // base call intentionally omitted.
-            skinEditor?.Hide();
-        }
-
-        public override void Show()
+        protected override void PopIn()
         {
             // base call intentionally omitted as we have custom behaviour.
 
@@ -106,6 +90,12 @@ namespace osu.Game.Skinning.Editor
             });
         }
 
+        protected override void PopOut()
+        {
+            // base call intentionally omitted.
+            skinEditor?.Hide();
+        }
+
         private void updateComponentVisibility()
         {
             Debug.Assert(skinEditor != null);

From 2a696783af33c7af24f100cb68598d080acaa6b0 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 21 Mar 2022 17:32:56 +0900
Subject: [PATCH 3617/5547] Remove unused const in `SkinEditorOverlay`

---
 osu.Game/Skinning/Editor/SkinEditorOverlay.cs | 2 --
 1 file changed, 2 deletions(-)

diff --git a/osu.Game/Skinning/Editor/SkinEditorOverlay.cs b/osu.Game/Skinning/Editor/SkinEditorOverlay.cs
index 970a27285e..f848c07680 100644
--- a/osu.Game/Skinning/Editor/SkinEditorOverlay.cs
+++ b/osu.Game/Skinning/Editor/SkinEditorOverlay.cs
@@ -28,8 +28,6 @@ namespace osu.Game.Skinning.Editor
         [CanBeNull]
         private SkinEditor skinEditor;
 
-        public const float VISIBLE_TARGET_SCALE = 0.8f;
-
         [Resolved(canBeNull: true)]
         private OsuGame game { get; set; }
 

From ed66f86ac6073ee655025ddfbddb9726b6cba2a8 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 21 Mar 2022 17:52:54 +0900
Subject: [PATCH 3618/5547] Update editor exit-without-safe tests to account
 for hold behaviour

---
 .../Editing/TestSceneEditorBeatmapCreation.cs      | 14 +++++++++++---
 1 file changed, 11 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneEditorBeatmapCreation.cs b/osu.Game.Tests/Visual/Editing/TestSceneEditorBeatmapCreation.cs
index ecd4035edd..b109234fec 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneEditorBeatmapCreation.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneEditorBeatmapCreation.cs
@@ -13,6 +13,7 @@ using osu.Framework.Testing;
 using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.ControlPoints;
 using osu.Game.Database;
+using osu.Game.Overlays.Dialog;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Catch;
 using osu.Game.Rulesets.Osu;
@@ -23,6 +24,7 @@ using osu.Game.Screens.Edit.Setup;
 using osu.Game.Storyboards;
 using osu.Game.Tests.Resources;
 using osuTK;
+using osuTK.Input;
 using SharpCompress.Archives;
 using SharpCompress.Archives.Zip;
 
@@ -63,13 +65,19 @@ namespace osu.Game.Tests.Visual.Editing
             EditorBeatmap editorBeatmap = null;
 
             AddStep("store editor beatmap", () => editorBeatmap = EditorBeatmap);
-            AddStep("exit without save", () =>
+
+            AddStep("exit without save", () => Editor.Exit());
+            AddStep("hold to confirm", () =>
             {
-                Editor.Exit();
-                DialogOverlay.CurrentDialog.PerformOkAction();
+                var confirmButton = DialogOverlay.CurrentDialog.ChildrenOfType<PopupDialogDangerousButton>().First();
+
+                InputManager.MoveMouseTo(confirmButton);
+                InputManager.PressButton(MouseButton.Left);
             });
 
             AddUntilStep("wait for exit", () => !Editor.IsCurrentScreen());
+            AddStep("release", () => InputManager.ReleaseButton(MouseButton.Left));
+
             AddAssert("new beatmap not persisted", () => beatmapManager.QueryBeatmapSet(s => s.ID == editorBeatmap.BeatmapInfo.BeatmapSet.ID)?.Value.DeletePending == true);
         }
 

From e4b2242719456749a8b7d828e1194551d18db7c6 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 21 Mar 2022 18:29:13 +0900
Subject: [PATCH 3619/5547] Fix follow point animations not looping

Because they do in stable. I don't know why but let's go with it.

Resolves issue reported in https://github.com/ppy/osu/discussions/17072.
---
 .../Skinning/Legacy/OsuLegacySkinTransformer.cs                 | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu/Skinning/Legacy/OsuLegacySkinTransformer.cs b/osu.Game.Rulesets.Osu/Skinning/Legacy/OsuLegacySkinTransformer.cs
index ff9f6f0e07..900ad6f6d3 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Legacy/OsuLegacySkinTransformer.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Legacy/OsuLegacySkinTransformer.cs
@@ -33,7 +33,7 @@ namespace osu.Game.Rulesets.Osu.Skinning.Legacy
                 switch (osuComponent.Component)
                 {
                     case OsuSkinComponents.FollowPoint:
-                        return this.GetAnimation(component.LookupName, true, false, true, startAtCurrentTime: false);
+                        return this.GetAnimation(component.LookupName, true, true, true, startAtCurrentTime: false);
 
                     case OsuSkinComponents.SliderFollowCircle:
                         var followCircle = this.GetAnimation("sliderfollowcircle", true, true, true);

From 058fbbbe6cc0b3422f50a495b7b09dc5049cff1d Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Mon, 21 Mar 2022 14:06:36 +0300
Subject: [PATCH 3620/5547] Remove unused using directive

---
 osu.Game/Skinning/Editor/SkinEditorSceneLibrary.cs | 1 -
 1 file changed, 1 deletion(-)

diff --git a/osu.Game/Skinning/Editor/SkinEditorSceneLibrary.cs b/osu.Game/Skinning/Editor/SkinEditorSceneLibrary.cs
index 4a7cce5a97..d126eff075 100644
--- a/osu.Game/Skinning/Editor/SkinEditorSceneLibrary.cs
+++ b/osu.Game/Skinning/Editor/SkinEditorSceneLibrary.cs
@@ -8,7 +8,6 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Screens;
-using osu.Game.Beatmaps;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;

From 33acc5d720c94eb1754759adc2d3a6079ee9de88 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Mon, 21 Mar 2022 14:06:47 +0300
Subject: [PATCH 3621/5547] Remove no longer valid comments

---
 osu.Game/Skinning/Editor/SkinEditorOverlay.cs | 8 +-------
 1 file changed, 1 insertion(+), 7 deletions(-)

diff --git a/osu.Game/Skinning/Editor/SkinEditorOverlay.cs b/osu.Game/Skinning/Editor/SkinEditorOverlay.cs
index f848c07680..819b0cbc6c 100644
--- a/osu.Game/Skinning/Editor/SkinEditorOverlay.cs
+++ b/osu.Game/Skinning/Editor/SkinEditorOverlay.cs
@@ -56,8 +56,6 @@ namespace osu.Game.Skinning.Editor
 
         protected override void PopIn()
         {
-            // base call intentionally omitted as we have custom behaviour.
-
             if (skinEditor != null)
             {
                 skinEditor.Show();
@@ -88,11 +86,7 @@ namespace osu.Game.Skinning.Editor
             });
         }
 
-        protected override void PopOut()
-        {
-            // base call intentionally omitted.
-            skinEditor?.Hide();
-        }
+        protected override void PopOut() => skinEditor?.Hide();
 
         private void updateComponentVisibility()
         {

From 9a2691c1bc0b8bf1578996a1cd0a56eb6b865f2f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 21 Mar 2022 23:54:47 +0900
Subject: [PATCH 3622/5547] Remove unnecessary schedule

---
 osu.Game/Skinning/Editor/SkinEditorOverlay.cs | 18 +++++++-----------
 1 file changed, 7 insertions(+), 11 deletions(-)

diff --git a/osu.Game/Skinning/Editor/SkinEditorOverlay.cs b/osu.Game/Skinning/Editor/SkinEditorOverlay.cs
index 819b0cbc6c..1a427d5f5d 100644
--- a/osu.Game/Skinning/Editor/SkinEditorOverlay.cs
+++ b/osu.Game/Skinning/Editor/SkinEditorOverlay.cs
@@ -63,26 +63,22 @@ namespace osu.Game.Skinning.Editor
             }
 
             var editor = new SkinEditor();
+
             editor.State.BindValueChanged(visibility => updateComponentVisibility());
 
             skinEditor = editor;
 
-            // Schedule ensures that if `Show` is called before this overlay is loaded,
-            // it will not throw (LoadComponentAsync requires the load target to be in a loaded state).
-            Schedule(() =>
+            if (editor != skinEditor)
+                return;
+
+            LoadComponentAsync(editor, _ =>
             {
                 if (editor != skinEditor)
                     return;
 
-                LoadComponentAsync(editor, _ =>
-                {
-                    if (editor != skinEditor)
-                        return;
+                AddInternal(editor);
 
-                    AddInternal(editor);
-
-                    SetTarget(lastTargetScreen);
-                });
+                SetTarget(lastTargetScreen);
             });
         }
 

From 17b639b4045974c255e8525b8f6cdfb6ade74373 Mon Sep 17 00:00:00 2001
From: NAGILSON <nagilson@umich.edu>
Date: Mon, 21 Mar 2022 22:42:17 -0400
Subject: [PATCH 3623/5547] Implement suggested change to wipe mods on
 multiplayer screen

---
 osu.Game/Screens/OnlinePlay/OnlinePlayScreen.cs | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/osu.Game/Screens/OnlinePlay/OnlinePlayScreen.cs b/osu.Game/Screens/OnlinePlay/OnlinePlayScreen.cs
index bf1699dca0..c56d04d5ac 100644
--- a/osu.Game/Screens/OnlinePlay/OnlinePlayScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/OnlinePlayScreen.cs
@@ -115,6 +115,8 @@ namespace osu.Game.Screens.OnlinePlay
             this.FadeIn();
             waves.Show();
 
+            Mods.SetDefault();
+
             if (loungeSubScreen.IsCurrentScreen())
                 loungeSubScreen.OnEntering(last);
             else

From 74ce009ed8ce926041f4fa60ba0467783761bb59 Mon Sep 17 00:00:00 2001
From: NAGILSON <nagilson@umich.edu>
Date: Mon, 21 Mar 2022 22:46:20 -0400
Subject: [PATCH 3624/5547] [WIP] Multiplayer Mods Regression Test

---
 .../Multiplayer/TestMultiplayerModLoading.cs  | 52 +++++++++++++++++++
 1 file changed, 52 insertions(+)
 create mode 100644 osu.Game.Tests/Visual/Multiplayer/TestMultiplayerModLoading.cs

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestMultiplayerModLoading.cs b/osu.Game.Tests/Visual/Multiplayer/TestMultiplayerModLoading.cs
new file mode 100644
index 0000000000..e9013af412
--- /dev/null
+++ b/osu.Game.Tests/Visual/Multiplayer/TestMultiplayerModLoading.cs
@@ -0,0 +1,52 @@
+// 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.Game.Rulesets.Mods;
+using osu.Game.Rulesets.Osu.Mods;
+using osu.Game.Screens.Select;
+
+// Resolve these names to types because there is a Namespace called "Playlists" and "Multiplayer" which conflicts
+using MultiplayerScreenAlias = osu.Game.Screens.OnlinePlay.Multiplayer.Multiplayer;
+using PlaylistsScreenAlias = osu.Game.Screens.OnlinePlay.Playlists.Playlists;
+
+namespace osu.Game.Tests.Visual.Multiplayer
+{
+    public class TestMultiplayerModLoading : OsuGameTestScene
+    {
+
+        [SetUp]
+        public void SetUp() => Schedule(() =>
+        {
+            SelectedMods.Value = Array.Empty<Mod>();
+        });
+
+
+        /// <summary>
+        /// This is a regression test that tests whether a singleplayer mod can transfer over to a multiplayer screen.
+        /// It should not carry over from these screens, prevents regression on https://github.com/ppy/osu/pull/17352 
+        /// </summary>
+        [Test]
+        public void TestSingleplayerModsDontCarryToMultiplayerScreens()
+        {
+            PushAndConfirm(() => new PlaySongSelect());
+
+            // Select Mods while a "singleplayer" screen is active
+            var osuAutomationMod = new OsuModAutoplay();
+            var expectedMods = new[] { osuAutomationMod };
+
+            AddStep("Toggle on the automation Mod.", () => { SelectedMods.Value = expectedMods; });
+            AddAssert("", () => SelectedMods.Value == expectedMods);
+
+            PushAndConfirm(() => new TestMultiplayerComponents());
+            AddAssert("Mods are Empty After A Multiplayer Screen Loads", () => SelectedMods.Value.Count == 0);
+
+            AddStep("Retoggle on the automation Mod.", () => { SelectedMods.Value = expectedMods; });
+            AddAssert("", () => SelectedMods.Value == expectedMods);
+
+            // TODO: Implement TestPlaylistComponents? 
+            //PushAndConfirm(() => new TestPlaylistComponents());
+            //AddAssert("Mods are Empty After Playlist Screen Loads", () => !SelectedMods.Value.Any());
+        }
+    }
+}

From aaf2edace9d43e9cadfcfb874ef5d8a68be660f6 Mon Sep 17 00:00:00 2001
From: NAGILSON <nagilson@umich.edu>
Date: Mon, 21 Mar 2022 22:48:08 -0400
Subject: [PATCH 3625/5547] remove code from old incorrect test

---
 .../Visual/Multiplayer/TestMultiplayerModLoading.cs           | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestMultiplayerModLoading.cs b/osu.Game.Tests/Visual/Multiplayer/TestMultiplayerModLoading.cs
index e9013af412..b5609a2841 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestMultiplayerModLoading.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestMultiplayerModLoading.cs
@@ -6,10 +6,6 @@ using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Osu.Mods;
 using osu.Game.Screens.Select;
 
-// Resolve these names to types because there is a Namespace called "Playlists" and "Multiplayer" which conflicts
-using MultiplayerScreenAlias = osu.Game.Screens.OnlinePlay.Multiplayer.Multiplayer;
-using PlaylistsScreenAlias = osu.Game.Screens.OnlinePlay.Playlists.Playlists;
-
 namespace osu.Game.Tests.Visual.Multiplayer
 {
     public class TestMultiplayerModLoading : OsuGameTestScene

From 33d97f53cbb5184939e8fde48d40acc3155b8925 Mon Sep 17 00:00:00 2001
From: NAGILSON <nagilson@umich.edu>
Date: Mon, 21 Mar 2022 22:58:53 -0400
Subject: [PATCH 3626/5547] Fill in assert details, remove whitespace

---
 .../Visual/Multiplayer/TestMultiplayerModLoading.cs         | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestMultiplayerModLoading.cs b/osu.Game.Tests/Visual/Multiplayer/TestMultiplayerModLoading.cs
index b5609a2841..7c2353513d 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestMultiplayerModLoading.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestMultiplayerModLoading.cs
@@ -10,14 +10,12 @@ namespace osu.Game.Tests.Visual.Multiplayer
 {
     public class TestMultiplayerModLoading : OsuGameTestScene
     {
-
         [SetUp]
         public void SetUp() => Schedule(() =>
         {
             SelectedMods.Value = Array.Empty<Mod>();
         });
 
-
         /// <summary>
         /// This is a regression test that tests whether a singleplayer mod can transfer over to a multiplayer screen.
         /// It should not carry over from these screens, prevents regression on https://github.com/ppy/osu/pull/17352 
@@ -32,13 +30,13 @@ namespace osu.Game.Tests.Visual.Multiplayer
             var expectedMods = new[] { osuAutomationMod };
 
             AddStep("Toggle on the automation Mod.", () => { SelectedMods.Value = expectedMods; });
-            AddAssert("", () => SelectedMods.Value == expectedMods);
+            AddAssert("Mods are loaded before the multiplayer screen is pushed.", () => SelectedMods.Value == expectedMods);
 
             PushAndConfirm(() => new TestMultiplayerComponents());
             AddAssert("Mods are Empty After A Multiplayer Screen Loads", () => SelectedMods.Value.Count == 0);
 
             AddStep("Retoggle on the automation Mod.", () => { SelectedMods.Value = expectedMods; });
-            AddAssert("", () => SelectedMods.Value == expectedMods);
+            AddAssert("Mods are loaded before the playlist screen is pushed", () => SelectedMods.Value == expectedMods);
 
             // TODO: Implement TestPlaylistComponents? 
             //PushAndConfirm(() => new TestPlaylistComponents());

From 4630aa15cc06a1efd1df0fe1486777c50d6999db Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 22 Mar 2022 12:54:10 +0900
Subject: [PATCH 3627/5547] Apply refactorings according to reviews

---
 .../Match/MultiplayerReadyButton.cs           | 41 ++++++-------------
 .../Multiplayer/TestMultiplayerClient.cs      |  8 +---
 2 files changed, 13 insertions(+), 36 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
index 381c5ea712..4c4cc87f6d 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
@@ -282,12 +282,12 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
 
                 int countReady = room.Users.Count(u => u.State == MultiplayerUserState.Ready);
                 int countTotal = room.Users.Count(u => u.State != MultiplayerUserState.Spectating);
-
-                string countdownText = room.Countdown == null ? string.Empty : $"Starting in {room.Countdown.EndTime - DateTimeOffset.Now:mm\\:ss}";
                 string countText = $"({countReady} / {countTotal} ready)";
 
                 if (room.Countdown != null)
                 {
+                    string countdownText = $"Starting in {room.Countdown.EndTime - DateTimeOffset.Now:mm\\:ss}";
+
                     switch (localUser?.State)
                     {
                         default:
@@ -329,37 +329,20 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
 
                 var localUser = multiplayerClient.LocalUser;
 
-                if (room.Countdown != null)
+                switch (localUser?.State)
                 {
-                    switch (localUser?.State)
-                    {
-                        default:
-                            setGreen();
-                            break;
+                    default:
+                        setGreen();
+                        break;
 
-                        case MultiplayerUserState.Spectating:
-                        case MultiplayerUserState.Ready:
+                    case MultiplayerUserState.Spectating:
+                    case MultiplayerUserState.Ready:
+                        if (room?.Host?.Equals(localUser) == true && room.Countdown == null)
+                            setGreen();
+                        else
                             setYellow();
-                            break;
-                    }
-                }
-                else
-                {
-                    switch (localUser?.State)
-                    {
-                        default:
-                            setGreen();
-                            break;
 
-                        case MultiplayerUserState.Spectating:
-                        case MultiplayerUserState.Ready:
-                            if (room?.Host?.Equals(localUser) == true)
-                                setGreen();
-                            else
-                                setYellow();
-
-                            break;
-                    }
+                        break;
                 }
 
                 void setYellow()
diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
index 4066cd0c4a..309ca6ca58 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
@@ -322,13 +322,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
                     async Task start()
                     {
-                        try
-                        {
-                            await lastCountdownTask;
-                        }
-                        catch (OperationCanceledException)
-                        {
-                        }
+                        await lastCountdownTask;
 
                         Schedule(() =>
                         {

From 0fcb3bdba9a4591407ee1415a582ac4e1f0d3682 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 22 Mar 2022 14:10:21 +0900
Subject: [PATCH 3628/5547] Fix beatmap date added not being updated on
 reimporting a soft deleted beatmap

Addresses concerns raised in https://github.com/ppy/osu/discussions/17399.
---
 osu.Game.Tests/Database/BeatmapImporterTests.cs |  6 ++++++
 osu.Game/Stores/BeatmapImporter.cs              |  6 ++++++
 osu.Game/Stores/RealmArchiveModelImporter.cs    | 16 ++++++++++++++--
 3 files changed, 26 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Database/BeatmapImporterTests.cs b/osu.Game.Tests/Database/BeatmapImporterTests.cs
index 9d67381b5a..9abd78039a 100644
--- a/osu.Game.Tests/Database/BeatmapImporterTests.cs
+++ b/osu.Game.Tests/Database/BeatmapImporterTests.cs
@@ -590,6 +590,8 @@ namespace osu.Game.Tests.Database
 
                 Assert.IsTrue(imported.DeletePending);
 
+                var originalAddedDate = imported.DateAdded;
+
                 var importedSecondTime = await LoadOszIntoStore(importer, realm.Realm);
 
                 // check the newly "imported" beatmap is actually just the restored previous import. since it matches hash.
@@ -597,6 +599,7 @@ namespace osu.Game.Tests.Database
                 Assert.IsTrue(imported.Beatmaps.First().ID == importedSecondTime.Beatmaps.First().ID);
                 Assert.IsFalse(imported.DeletePending);
                 Assert.IsFalse(importedSecondTime.DeletePending);
+                Assert.That(importedSecondTime.DateAdded, Is.GreaterThan(originalAddedDate));
             });
         }
 
@@ -646,6 +649,8 @@ namespace osu.Game.Tests.Database
 
                 Assert.IsTrue(imported.DeletePending);
 
+                var originalAddedDate = imported.DateAdded;
+
                 var importedSecondTime = await LoadOszIntoStore(importer, realm.Realm);
 
                 // check the newly "imported" beatmap is actually just the restored previous import. since it matches hash.
@@ -653,6 +658,7 @@ namespace osu.Game.Tests.Database
                 Assert.IsTrue(imported.Beatmaps.First().ID == importedSecondTime.Beatmaps.First().ID);
                 Assert.IsFalse(imported.DeletePending);
                 Assert.IsFalse(importedSecondTime.DeletePending);
+                Assert.That(importedSecondTime.DateAdded, Is.GreaterThan(originalAddedDate));
             });
         }
 
diff --git a/osu.Game/Stores/BeatmapImporter.cs b/osu.Game/Stores/BeatmapImporter.cs
index e6b655589c..f04a0210ef 100644
--- a/osu.Game/Stores/BeatmapImporter.cs
+++ b/osu.Game/Stores/BeatmapImporter.cs
@@ -163,6 +163,12 @@ namespace osu.Game.Stores
             return existing.OnlineID == import.OnlineID && existingIds.SequenceEqual(importIds);
         }
 
+        protected override void UndeleteForReuse(BeatmapSetInfo existing)
+        {
+            base.UndeleteForReuse(existing);
+            existing.DateAdded = DateTimeOffset.UtcNow;
+        }
+
         public override bool IsAvailableLocally(BeatmapSetInfo model)
         {
             return Realm.Run(realm => realm.All<BeatmapSetInfo>().Any(s => s.OnlineID == model.OnlineID));
diff --git a/osu.Game/Stores/RealmArchiveModelImporter.cs b/osu.Game/Stores/RealmArchiveModelImporter.cs
index 3011bc0320..1d0e16d549 100644
--- a/osu.Game/Stores/RealmArchiveModelImporter.cs
+++ b/osu.Game/Stores/RealmArchiveModelImporter.cs
@@ -351,7 +351,8 @@ namespace osu.Game.Stores
 
                             using (var transaction = realm.BeginWrite())
                             {
-                                existing.DeletePending = false;
+                                if (existing.DeletePending)
+                                    UndeleteForReuse(existing);
                                 transaction.Commit();
                             }
 
@@ -387,7 +388,9 @@ namespace osu.Game.Stores
                             {
                                 LogForModel(item, @$"Found existing {HumanisedModelName} for {item} (ID {existing.ID}) – skipping import.");
 
-                                existing.DeletePending = false;
+                                if (existing.DeletePending)
+                                    UndeleteForReuse(existing);
+
                                 transaction.Commit();
 
                                 return existing.ToLive(Realm);
@@ -527,6 +530,15 @@ namespace osu.Game.Stores
         private bool checkAllFilesExist(TModel model) =>
             model.Files.All(f => Files.Storage.Exists(f.File.GetStoragePath()));
 
+        /// <summary>
+        /// Called when an existing model is in a soft deleted state but being recovered.
+        /// </summary>
+        /// <param name="existing">The existing model.</param>
+        protected virtual void UndeleteForReuse(TModel existing)
+        {
+            existing.DeletePending = false;
+        }
+
         /// <summary>
         /// Whether this specified path should be removed after successful import.
         /// </summary>

From d0fee53e1fb26766ebd02d550243abbb625f58cd Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 18 Mar 2022 22:00:39 +0900
Subject: [PATCH 3629/5547] Implement auto countdown timers

Change to using TimeSpan
---
 .../Online/Multiplayer/MultiplayerClient.cs   |  5 ++-
 .../Multiplayer/MultiplayerRoomSettings.cs    |  9 ++++-
 osu.Game/Online/Rooms/Room.cs                 | 11 +++++
 .../Match/MultiplayerMatchSettingsOverlay.cs  | 40 ++++++++++++++++++-
 .../Match/MultiplayerReadyButton.cs           |  4 +-
 .../Screens/OnlinePlay/OnlinePlayComposite.cs |  3 ++
 6 files changed, 66 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Online/Multiplayer/MultiplayerClient.cs b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
index 2d5496c5c1..de17c012eb 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
@@ -239,7 +239,9 @@ namespace osu.Game.Online.Multiplayer
         /// <param name="password">The new password, if any.</param>
         /// <param name="matchType">The type of the match, if any.</param>
         /// <param name="queueMode">The new queue mode, if any.</param>
-        public Task ChangeSettings(Optional<string> name = default, Optional<string> password = default, Optional<MatchType> matchType = default, Optional<QueueMode> queueMode = default)
+        /// <param name="autoStartDuration">The new auto-start countdown duration, if any.</param>
+        public Task ChangeSettings(Optional<string> name = default, Optional<string> password = default, Optional<MatchType> matchType = default, Optional<QueueMode> queueMode = default,
+                                   Optional<TimeSpan> autoStartDuration = default)
         {
             if (Room == null)
                 throw new InvalidOperationException("Must be joined to a match to change settings.");
@@ -250,6 +252,7 @@ namespace osu.Game.Online.Multiplayer
                 Password = password.GetOr(Room.Settings.Password),
                 MatchType = matchType.GetOr(Room.Settings.MatchType),
                 QueueMode = queueMode.GetOr(Room.Settings.QueueMode),
+                AutoStartDuration = autoStartDuration.GetOr(Room.Settings.AutoStartDuration),
             });
         }
 
diff --git a/osu.Game/Online/Multiplayer/MultiplayerRoomSettings.cs b/osu.Game/Online/Multiplayer/MultiplayerRoomSettings.cs
index c392260a22..f8b238d61b 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerRoomSettings.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerRoomSettings.cs
@@ -28,6 +28,9 @@ namespace osu.Game.Online.Multiplayer
         [Key(4)]
         public QueueMode QueueMode { get; set; } = QueueMode.HostOnly;
 
+        [Key(5)]
+        public TimeSpan AutoStartDuration { get; set; }
+
         public bool Equals(MultiplayerRoomSettings? other)
         {
             if (ReferenceEquals(this, other)) return true;
@@ -37,13 +40,15 @@ namespace osu.Game.Online.Multiplayer
                    && Name.Equals(other.Name, StringComparison.Ordinal)
                    && PlaylistItemId == other.PlaylistItemId
                    && MatchType == other.MatchType
-                   && QueueMode == other.QueueMode;
+                   && QueueMode == other.QueueMode
+                   && AutoStartDuration == other.AutoStartDuration;
         }
 
         public override string ToString() => $"Name:{Name}"
                                              + $" Password:{(string.IsNullOrEmpty(Password) ? "no" : "yes")}"
                                              + $" Type:{MatchType}"
                                              + $" Item:{PlaylistItemId}"
-                                             + $" Queue:{QueueMode}";
+                                             + $" Queue:{QueueMode}"
+                                             + $" Start:{AutoStartDuration}";
     }
 }
diff --git a/osu.Game/Online/Rooms/Room.cs b/osu.Game/Online/Rooms/Room.cs
index 543b176b51..76bac44242 100644
--- a/osu.Game/Online/Rooms/Room.cs
+++ b/osu.Game/Online/Rooms/Room.cs
@@ -92,6 +92,16 @@ namespace osu.Game.Online.Rooms
             set => QueueMode.Value = value;
         }
 
+        [Cached]
+        public readonly Bindable<TimeSpan> AutoStartDuration = new Bindable<TimeSpan>();
+
+        [JsonProperty("start_duration")]
+        private ushort autoStartDuration
+        {
+            get => (ushort)AutoStartDuration.Value.TotalSeconds;
+            set => AutoStartDuration.Value = TimeSpan.FromSeconds(value);
+        }
+
         [Cached]
         public readonly Bindable<int?> MaxParticipants = new Bindable<int?>();
 
@@ -172,6 +182,7 @@ namespace osu.Game.Online.Rooms
             EndDate.Value = other.EndDate.Value;
             UserScore.Value = other.UserScore.Value;
             QueueMode.Value = other.QueueMode.Value;
+            AutoStartDuration.Value = other.AutoStartDuration.Value;
             DifficultyRange.Value = other.DifficultyRange.Value;
             PlaylistItemStats.Value = other.PlaylistItemStats.Value;
             CurrentPlaylistItem.Value = other.CurrentPlaylistItem.Value;
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs
index be98a9d4e9..2918e066c1 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs
@@ -2,6 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
+using System.ComponentModel;
 using System.Diagnostics;
 using JetBrains.Annotations;
 using osu.Framework.Allocation;
@@ -21,6 +22,7 @@ using osu.Game.Online.Rooms;
 using osu.Game.Overlays;
 using osu.Game.Screens.OnlinePlay.Match.Components;
 using osuTK;
+using Container = osu.Framework.Graphics.Containers.Container;
 
 namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
 {
@@ -64,6 +66,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
 
             public OsuSpriteText ErrorText;
 
+            private OsuEnumDropdown<StartMode> startModeDropdown;
             private OsuSpriteText typeLabel;
             private LoadingLayer loadingLayer;
 
@@ -204,6 +207,18 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
                                                                             RelativeSizeAxes = Axes.X
                                                                         }
                                                                     }
+                                                                },
+                                                                new Section("Auto start")
+                                                                {
+                                                                    Child = new Container
+                                                                    {
+                                                                        RelativeSizeAxes = Axes.X,
+                                                                        Height = 40,
+                                                                        Child = startModeDropdown = new OsuEnumDropdown<StartMode>
+                                                                        {
+                                                                            RelativeSizeAxes = Axes.X
+                                                                        }
+                                                                    }
                                                                 }
                                                             },
                                                         },
@@ -327,6 +342,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
                 RoomID.BindValueChanged(roomId => playlistContainer.Alpha = roomId.NewValue == null ? 1 : 0, true);
                 Password.BindValueChanged(password => PasswordTextBox.Text = password.NewValue ?? string.Empty, true);
                 QueueMode.BindValueChanged(mode => QueueModeDropdown.Current.Value = mode.NewValue, true);
+                AutoStartDuration.BindValueChanged(duration => startModeDropdown.Current.Value = (StartMode)(int)duration.NewValue.TotalSeconds, true);
 
                 operationInProgress.BindTo(ongoingOperationTracker.InProgress);
                 operationInProgress.BindValueChanged(v =>
@@ -363,6 +379,8 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
                 Debug.Assert(applyingSettingsOperation == null);
                 applyingSettingsOperation = ongoingOperationTracker.BeginOperation();
 
+                TimeSpan autoStartDuration = TimeSpan.FromSeconds((int)startModeDropdown.Current.Value);
+
                 // If the client is already in a room, update via the client.
                 // Otherwise, update the room directly in preparation for it to be submitted to the API on match creation.
                 if (client.Room != null)
@@ -371,7 +389,8 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
                               name: NameField.Text,
                               password: PasswordTextBox.Text,
                               matchType: TypePicker.Current.Value,
-                              queueMode: QueueModeDropdown.Current.Value)
+                              queueMode: QueueModeDropdown.Current.Value,
+                              autoStartDuration: autoStartDuration)
                           .ContinueWith(t => Schedule(() =>
                           {
                               if (t.IsCompletedSuccessfully)
@@ -387,6 +406,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
                     room.Type.Value = TypePicker.Current.Value;
                     room.Password.Value = PasswordTextBox.Current.Value;
                     room.QueueMode.Value = QueueModeDropdown.Current.Value;
+                    room.AutoStartDuration.Value = autoStartDuration;
 
                     if (int.TryParse(MaxParticipantsField.Text, out int max))
                         room.MaxParticipants.Value = max;
@@ -452,5 +472,23 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
                 Triangles.ColourDark = colours.YellowDark;
             }
         }
+
+        private enum StartMode
+        {
+            [Description("Off")]
+            Off = 0,
+
+            [Description("30 seconds")]
+            Seconds_30 = 30,
+
+            [Description("1 minute")]
+            Seconds_60 = 60,
+
+            [Description("3 minutes")]
+            Seconds_180 = 180,
+
+            [Description("5 minutes")]
+            Seconds_300 = 300
+        }
     }
 }
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
index 381c5ea712..930ddc3d64 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
@@ -120,7 +120,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
             clickOperation = ongoingOperationTracker.BeginOperation();
 
             // Ensure the current user becomes ready before being able to do anything else (start match, stop countdown, unready).
-            if (!isReady() || !Client.IsHost)
+            if (!isReady() || !Client.IsHost || Room.Settings.AutoStartDuration != TimeSpan.Zero)
             {
                 toggleReady();
                 return;
@@ -183,7 +183,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
             int newCountReady = Room.Users.Count(u => u.State == MultiplayerUserState.Ready);
             int newCountTotal = Room.Users.Count(u => u.State != MultiplayerUserState.Spectating);
 
-            if (Room.Countdown != null)
+            if (Room.Countdown != null || Room.Settings.AutoStartDuration != TimeSpan.Zero)
                 countdownButton.Alpha = 0;
             else
             {
diff --git a/osu.Game/Screens/OnlinePlay/OnlinePlayComposite.cs b/osu.Game/Screens/OnlinePlay/OnlinePlayComposite.cs
index 95d9b2af15..88354c8646 100644
--- a/osu.Game/Screens/OnlinePlay/OnlinePlayComposite.cs
+++ b/osu.Game/Screens/OnlinePlay/OnlinePlayComposite.cs
@@ -81,6 +81,9 @@ namespace osu.Game.Screens.OnlinePlay
         [Resolved(typeof(Room))]
         protected Bindable<QueueMode> QueueMode { get; private set; }
 
+        [Resolved(typeof(Room))]
+        protected Bindable<TimeSpan> AutoStartDuration { get; private set; }
+
         [Resolved(CanBeNull = true)]
         private IBindable<PlaylistItem> subScreenSelectedItem { get; set; }
 

From 23be0f1be90ce5275c80fb717603ac4686285878 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 22 Mar 2022 14:17:20 +0900
Subject: [PATCH 3630/5547] Remove availability picker for now

---
 .../Match/MultiplayerMatchSettingsOverlay.cs          | 11 -----------
 1 file changed, 11 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs
index 2918e066c1..aef04c106d 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs
@@ -58,7 +58,6 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
             public Action SettingsApplied;
 
             public OsuTextBox NameField, MaxParticipantsField;
-            public RoomAvailabilityPicker AvailabilityPicker;
             public MatchTypePicker TypePicker;
             public OsuEnumDropdown<QueueMode> QueueModeDropdown;
             public OsuTextBox PasswordTextBox;
@@ -166,14 +165,6 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
                                                                         LengthLimit = 100,
                                                                     },
                                                                 },
-                                                                new Section("Room visibility")
-                                                                {
-                                                                    Alpha = disabled_alpha,
-                                                                    Child = AvailabilityPicker = new RoomAvailabilityPicker
-                                                                    {
-                                                                        Enabled = { Value = false }
-                                                                    },
-                                                                },
                                                                 new Section("Game type")
                                                                 {
                                                                     Child = new FillFlowContainer
@@ -336,7 +327,6 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
 
                 TypePicker.Current.BindValueChanged(type => typeLabel.Text = type.NewValue.GetLocalisableDescription(), true);
                 RoomName.BindValueChanged(name => NameField.Text = name.NewValue, true);
-                Availability.BindValueChanged(availability => AvailabilityPicker.Current.Value = availability.NewValue, true);
                 Type.BindValueChanged(type => TypePicker.Current.Value = type.NewValue, true);
                 MaxParticipants.BindValueChanged(count => MaxParticipantsField.Text = count.NewValue?.ToString(), true);
                 RoomID.BindValueChanged(roomId => playlistContainer.Alpha = roomId.NewValue == null ? 1 : 0, true);
@@ -402,7 +392,6 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
                 else
                 {
                     room.Name.Value = NameField.Text;
-                    room.Availability.Value = AvailabilityPicker.Current.Value;
                     room.Type.Value = TypePicker.Current.Value;
                     room.Password.Value = PasswordTextBox.Current.Value;
                     room.QueueMode.Value = QueueModeDropdown.Current.Value;

From fb7f9a81db99bd547b64c26f331d1dca47c24c11 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 22 Mar 2022 14:35:13 +0900
Subject: [PATCH 3631/5547] Remove unnecessary equality check in skin editor
 construction path

---
 osu.Game/Skinning/Editor/SkinEditorOverlay.cs | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/osu.Game/Skinning/Editor/SkinEditorOverlay.cs b/osu.Game/Skinning/Editor/SkinEditorOverlay.cs
index 1a427d5f5d..497283a820 100644
--- a/osu.Game/Skinning/Editor/SkinEditorOverlay.cs
+++ b/osu.Game/Skinning/Editor/SkinEditorOverlay.cs
@@ -68,9 +68,6 @@ namespace osu.Game.Skinning.Editor
 
             skinEditor = editor;
 
-            if (editor != skinEditor)
-                return;
-
             LoadComponentAsync(editor, _ =>
             {
                 if (editor != skinEditor)

From f95bd8916693ea04a5afb17867cfcbc85709777f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 22 Mar 2022 14:46:57 +0900
Subject: [PATCH 3632/5547] Revert editor exit behaviour to exit without
 changes for now

---
 osu.Game/Overlays/Dialog/PopupDialog.cs | 7 ++++++-
 osu.Game/Screens/Edit/Editor.cs         | 3 ++-
 2 files changed, 8 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Overlays/Dialog/PopupDialog.cs b/osu.Game/Overlays/Dialog/PopupDialog.cs
index 0f953f92bb..a70a7f26cc 100644
--- a/osu.Game/Overlays/Dialog/PopupDialog.cs
+++ b/osu.Game/Overlays/Dialog/PopupDialog.cs
@@ -219,7 +219,12 @@ namespace osu.Game.Overlays.Dialog
         /// <summary>
         /// Programmatically clicks the first <see cref="PopupDialogOkButton"/>.
         /// </summary>
-        public void PerformOkAction() => Buttons.OfType<PopupDialogOkButton>().First().TriggerClick();
+        public void PerformOkAction() => PerformAction<PopupDialogOkButton>();
+
+        /// <summary>
+        /// Programmatically clicks the first button of the provided type.
+        /// </summary>
+        public void PerformAction<T>() where T : PopupDialogButton => Buttons.OfType<T>().First().TriggerClick();
 
         protected override bool OnKeyDown(KeyDownEvent e)
         {
diff --git a/osu.Game/Screens/Edit/Editor.cs b/osu.Game/Screens/Edit/Editor.cs
index dcb7e3a282..444b2fe6f9 100644
--- a/osu.Game/Screens/Edit/Editor.cs
+++ b/osu.Game/Screens/Edit/Editor.cs
@@ -28,6 +28,7 @@ using osu.Game.Graphics.UserInterface;
 using osu.Game.Input.Bindings;
 using osu.Game.Online.API;
 using osu.Game.Overlays;
+using osu.Game.Overlays.Dialog;
 using osu.Game.Overlays.Notifications;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Edit;
@@ -598,7 +599,7 @@ namespace osu.Game.Screens.Edit
                 // if the dialog is already displayed, confirm exit with no save.
                 if (dialogOverlay.CurrentDialog is PromptForSaveDialog saveDialog)
                 {
-                    saveDialog.PerformOkAction();
+                    saveDialog.PerformAction<PopupDialogDangerousButton>();
                     return true;
                 }
 

From 61ddf1e6cf90a9fb9041afdc9335ac57205b6b83 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 22 Mar 2022 15:28:31 +0900
Subject: [PATCH 3633/5547] Disallow exiting the editor without saving (unless
 explicitly confirming)

---
 .../Visual/Editing/TestSceneEditorSaving.cs    |  7 +++++++
 osu.Game/Screens/Edit/Editor.cs                | 13 +++++--------
 osu.Game/Tests/Visual/EditorTestScene.cs       | 18 ++++++++++++++++++
 3 files changed, 30 insertions(+), 8 deletions(-)

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneEditorSaving.cs b/osu.Game.Tests/Visual/Editing/TestSceneEditorSaving.cs
index d1c1558003..e75c7f25a3 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneEditorSaving.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneEditorSaving.cs
@@ -17,6 +17,13 @@ namespace osu.Game.Tests.Visual.Editing
 {
     public class TestSceneEditorSaving : EditorSavingTestScene
     {
+        [Test]
+        public void TestCantExitWithoutSaving()
+        {
+            AddRepeatStep("Exit", () => InputManager.Key(Key.Escape), 10);
+            AddAssert("Editor is still active screen", () => Game.ScreenStack.CurrentScreen is Editor);
+        }
+
         [Test]
         public void TestMetadata()
         {
diff --git a/osu.Game/Screens/Edit/Editor.cs b/osu.Game/Screens/Edit/Editor.cs
index 444b2fe6f9..7254a9140f 100644
--- a/osu.Game/Screens/Edit/Editor.cs
+++ b/osu.Game/Screens/Edit/Editor.cs
@@ -98,7 +98,7 @@ namespace osu.Game.Screens.Edit
 
         private bool canSave;
 
-        private bool exitConfirmed;
+        protected bool ExitConfirmed { get; private set; }
 
         private string lastSavedHash;
 
@@ -587,7 +587,7 @@ namespace osu.Game.Screens.Edit
 
         public override bool OnExiting(IScreen next)
         {
-            if (!exitConfirmed)
+            if (!ExitConfirmed)
             {
                 // dialog overlay may not be available in visual tests.
                 if (dialogOverlay == null)
@@ -596,12 +596,9 @@ namespace osu.Game.Screens.Edit
                     return true;
                 }
 
-                // if the dialog is already displayed, confirm exit with no save.
+                // if the dialog is already displayed, block exiting until the user explicitly makes a decision.
                 if (dialogOverlay.CurrentDialog is PromptForSaveDialog saveDialog)
-                {
-                    saveDialog.PerformAction<PopupDialogDangerousButton>();
                     return true;
-                }
 
                 if (isNewBeatmap || HasUnsavedChanges)
                 {
@@ -646,7 +643,7 @@ namespace osu.Game.Screens.Edit
         {
             Save();
 
-            exitConfirmed = true;
+            ExitConfirmed = true;
             this.Exit();
         }
 
@@ -669,7 +666,7 @@ namespace osu.Game.Screens.Edit
                 Beatmap.SetDefault();
             }
 
-            exitConfirmed = true;
+            ExitConfirmed = true;
             this.Exit();
         }
 
diff --git a/osu.Game/Tests/Visual/EditorTestScene.cs b/osu.Game/Tests/Visual/EditorTestScene.cs
index 24015590e2..efaf6f2253 100644
--- a/osu.Game/Tests/Visual/EditorTestScene.cs
+++ b/osu.Game/Tests/Visual/EditorTestScene.cs
@@ -7,10 +7,13 @@ using osu.Framework.Allocation;
 using osu.Framework.Audio;
 using osu.Framework.IO.Stores;
 using osu.Framework.Platform;
+using osu.Framework.Screens;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
 using osu.Game.Database;
 using osu.Game.Online.API;
+using osu.Game.Overlays;
+using osu.Game.Overlays.Dialog;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Edit;
 using osu.Game.Screens.Edit;
@@ -93,6 +96,9 @@ namespace osu.Game.Tests.Visual
 
         protected class TestEditor : Editor
         {
+            [Resolved(canBeNull: true)]
+            private DialogOverlay dialogOverlay { get; set; }
+
             public new void Undo() => base.Undo();
 
             public new void Redo() => base.Redo();
@@ -111,6 +117,18 @@ namespace osu.Game.Tests.Visual
 
             public new bool HasUnsavedChanges => base.HasUnsavedChanges;
 
+            public override bool OnExiting(IScreen next)
+            {
+                // For testing purposes allow the screen to exit without saving on second attempt.
+                if (!ExitConfirmed && dialogOverlay.CurrentDialog is PromptForSaveDialog saveDialog)
+                {
+                    saveDialog.PerformAction<PopupDialogDangerousButton>();
+                    return true;
+                }
+
+                return base.OnExiting(next);
+            }
+
             public TestEditor(EditorLoader loader = null)
                 : base(loader)
             {

From 2c4a6c246592cb8cb142aeb8a0704d34715cd30d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 22 Mar 2022 16:46:42 +0900
Subject: [PATCH 3634/5547] Add missing async safeties to new tests

---
 .../Visual/Multiplayer/TestSceneMultiplayer.cs       | 12 ++++++------
 .../Multiplayer/TestSceneMultiplayerReadyButton.cs   |  4 ++--
 2 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
index e38da96bd5..6300dfa381 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
@@ -424,7 +424,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             AddUntilStep("Beatmap doesn't match current item", () => Beatmap.Value.BeatmapInfo.OnlineID != multiplayerClient.Room?.Playlist.First().BeatmapID);
 
-            AddStep("start match externally", () => multiplayerClient.StartMatch());
+            AddStep("start match externally", () => multiplayerClient.StartMatch().WaitSafely());
 
             AddUntilStep("play started", () => multiplayerComponents.CurrentScreen is Player);
 
@@ -462,7 +462,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             AddUntilStep("Ruleset doesn't match current item", () => Ruleset.Value.OnlineID != multiplayerClient.Room?.Playlist.First().RulesetID);
 
-            AddStep("start match externally", () => multiplayerClient.StartMatch());
+            AddStep("start match externally", () => multiplayerClient.StartMatch().WaitSafely());
 
             AddUntilStep("play started", () => multiplayerComponents.CurrentScreen is Player);
 
@@ -500,7 +500,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             AddAssert("Mods don't match current item", () => !SelectedMods.Value.Select(m => m.Acronym).SequenceEqual(multiplayerClient.Room.AsNonNull().Playlist.First().RequiredMods.Select(m => m.Acronym)));
 
-            AddStep("start match externally", () => multiplayerClient.StartMatch());
+            AddStep("start match externally", () => multiplayerClient.StartMatch().WaitSafely());
 
             AddUntilStep("play started", () => multiplayerComponents.CurrentScreen is Player);
 
@@ -535,7 +535,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             AddUntilStep("wait for spectating user state", () => multiplayerClient.LocalUser?.State == MultiplayerUserState.Spectating);
 
-            AddStep("start match externally", () => multiplayerClient.StartMatch());
+            AddStep("start match externally", () => multiplayerClient.StartMatch().WaitSafely());
 
             AddAssert("play not started", () => multiplayerComponents.IsCurrentScreen());
         }
@@ -568,7 +568,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             AddUntilStep("wait for spectating user state", () => multiplayerClient.LocalUser?.State == MultiplayerUserState.Spectating);
 
-            AddStep("start match externally", () => multiplayerClient.StartMatch());
+            AddStep("start match externally", () => multiplayerClient.StartMatch().WaitSafely());
 
             AddStep("restore beatmap", () =>
             {
@@ -883,7 +883,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 AddStep("start match by other user", () =>
                 {
                     multiplayerClient.ChangeUserState(1234, MultiplayerUserState.Ready);
-                    multiplayerClient.StartMatch();
+                    multiplayerClient.StartMatch().WaitSafely();
                 });
 
                 AddUntilStep("wait for loading", () => multiplayerClient.Room?.State == MultiplayerRoomState.WaitingForLoad);
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs
index fc47861576..0315e5dfe4 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs
@@ -117,7 +117,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 MultiplayerClient.TransferHost(2);
             });
 
-            AddStep("start with countdown", () => MultiplayerClient.SendMatchRequest(new StartMatchCountdownRequest { Delay = TimeSpan.FromMinutes(2) }));
+            AddStep("start with countdown", () => MultiplayerClient.SendMatchRequest(new StartMatchCountdownRequest { Delay = TimeSpan.FromMinutes(2) }).WaitSafely());
 
             ClickButtonWhenEnabled<MultiplayerReadyButton.ReadyButton>();
             AddUntilStep("user is ready", () => MultiplayerClient.Room?.Users[0].State == MultiplayerUserState.Ready);
@@ -193,7 +193,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 MultiplayerClient.TransferHost(2);
             });
 
-            AddStep("start countdown", () => MultiplayerClient.SendMatchRequest(new StartMatchCountdownRequest { Delay = TimeSpan.FromMinutes(1) }));
+            AddStep("start countdown", () => MultiplayerClient.SendMatchRequest(new StartMatchCountdownRequest { Delay = TimeSpan.FromMinutes(1) }).WaitSafely());
             AddUntilStep("countdown started", () => MultiplayerClient.Room?.Countdown != null);
 
             AddStep("transfer host to local user", () => MultiplayerClient.TransferHost(API.LocalUser.Value.OnlineID));

From 483fb84b56bda3e3d6633c63d6daf2d74cd4e5ac Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 22 Mar 2022 16:50:13 +0900
Subject: [PATCH 3635/5547] Fix typo in `FinishCountdown` method

---
 .../Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs   | 6 +++---
 osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs  | 2 +-
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs
index 0315e5dfe4..7bf03caa88 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs
@@ -85,7 +85,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             });
 
             AddAssert("countdown button not visible", () => !this.ChildrenOfType<MultiplayerReadyButton.CountdownButton>().Single().IsPresent);
-            AddStep("finish countdown", () => MultiplayerClient.FinishCountDown());
+            AddStep("finish countdown", () => MultiplayerClient.FinishCountdown());
             AddUntilStep("match started", () => MultiplayerClient.LocalUser?.State == MultiplayerUserState.WaitingForLoad);
         }
 
@@ -104,7 +104,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             ClickButtonWhenEnabled<MultiplayerReadyButton.ReadyButton>();
 
-            AddStep("finish countdown", () => MultiplayerClient.FinishCountDown());
+            AddStep("finish countdown", () => MultiplayerClient.FinishCountdown());
             AddUntilStep("match not started", () => MultiplayerClient.LocalUser?.State == MultiplayerUserState.Ready);
         }
 
@@ -158,7 +158,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddStep("set spectating", () => MultiplayerClient.ChangeUserState(API.LocalUser.Value.OnlineID, MultiplayerUserState.Spectating));
             AddUntilStep("local user is spectating", () => MultiplayerClient.LocalUser?.State == MultiplayerUserState.Spectating);
 
-            AddStep("finish countdown", () => MultiplayerClient.FinishCountDown());
+            AddStep("finish countdown", () => MultiplayerClient.FinishCountdown());
             AddUntilStep("match not started", () => MultiplayerClient.Room?.State == MultiplayerRoomState.Open);
         }
 
diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
index 309ca6ca58..2b03017905 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
@@ -300,7 +300,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         private CancellationTokenSource? countdownStopSource;
         private Task countdownTask = Task.CompletedTask;
 
-        public void FinishCountDown() => countdownFinishSource?.Cancel();
+        public void FinishCountdown() => countdownFinishSource?.Cancel();
 
         public override async Task SendMatchRequest(MatchUserRequest request)
         {

From 804e8561607630f59380659e8cf3e85ce79eb88d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 22 Mar 2022 17:38:43 +0900
Subject: [PATCH 3636/5547] Move and refactor test in line with functionality
 changes

---
 .../Multiplayer/TestMultiplayerModLoading.cs  | 46 -------------------
 .../Navigation/TestSceneScreenNavigation.cs   | 14 ++++++
 2 files changed, 14 insertions(+), 46 deletions(-)
 delete mode 100644 osu.Game.Tests/Visual/Multiplayer/TestMultiplayerModLoading.cs

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestMultiplayerModLoading.cs b/osu.Game.Tests/Visual/Multiplayer/TestMultiplayerModLoading.cs
deleted file mode 100644
index 7c2353513d..0000000000
--- a/osu.Game.Tests/Visual/Multiplayer/TestMultiplayerModLoading.cs
+++ /dev/null
@@ -1,46 +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 NUnit.Framework;
-using osu.Game.Rulesets.Mods;
-using osu.Game.Rulesets.Osu.Mods;
-using osu.Game.Screens.Select;
-
-namespace osu.Game.Tests.Visual.Multiplayer
-{
-    public class TestMultiplayerModLoading : OsuGameTestScene
-    {
-        [SetUp]
-        public void SetUp() => Schedule(() =>
-        {
-            SelectedMods.Value = Array.Empty<Mod>();
-        });
-
-        /// <summary>
-        /// This is a regression test that tests whether a singleplayer mod can transfer over to a multiplayer screen.
-        /// It should not carry over from these screens, prevents regression on https://github.com/ppy/osu/pull/17352 
-        /// </summary>
-        [Test]
-        public void TestSingleplayerModsDontCarryToMultiplayerScreens()
-        {
-            PushAndConfirm(() => new PlaySongSelect());
-
-            // Select Mods while a "singleplayer" screen is active
-            var osuAutomationMod = new OsuModAutoplay();
-            var expectedMods = new[] { osuAutomationMod };
-
-            AddStep("Toggle on the automation Mod.", () => { SelectedMods.Value = expectedMods; });
-            AddAssert("Mods are loaded before the multiplayer screen is pushed.", () => SelectedMods.Value == expectedMods);
-
-            PushAndConfirm(() => new TestMultiplayerComponents());
-            AddAssert("Mods are Empty After A Multiplayer Screen Loads", () => SelectedMods.Value.Count == 0);
-
-            AddStep("Retoggle on the automation Mod.", () => { SelectedMods.Value = expectedMods; });
-            AddAssert("Mods are loaded before the playlist screen is pushed", () => SelectedMods.Value == expectedMods);
-
-            // TODO: Implement TestPlaylistComponents? 
-            //PushAndConfirm(() => new TestPlaylistComponents());
-            //AddAssert("Mods are Empty After Playlist Screen Loads", () => !SelectedMods.Value.Any());
-        }
-    }
-}
diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs b/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
index f2e6aa1e16..7e1ff08678 100644
--- a/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
@@ -262,6 +262,20 @@ namespace osu.Game.Tests.Visual.Navigation
             exitViaBackButtonAndConfirm();
         }
 
+        [Test]
+        public void TestModsResetOnEnteringMultiplayer()
+        {
+            var osuAutomationMod = new OsuModAutoplay();
+
+            AddStep("Enable autoplay", () => { Game.SelectedMods.Value = new[] { osuAutomationMod }; });
+
+            PushAndConfirm(() => new Screens.OnlinePlay.Multiplayer.Multiplayer());
+            AddUntilStep("Mods are removed", () => SelectedMods.Value.Count == 0);
+
+            AddStep("Return to menu", () => Game.ScreenStack.CurrentScreen.Exit());
+            AddUntilStep("Mods are restored", () => Game.SelectedMods.Value.Contains(osuAutomationMod));
+        }
+
         [Test]
         public void TestExitMultiWithEscape()
         {

From 09ec49e6fa68e714730043d9ec723bc352456017 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 22 Mar 2022 18:30:54 +0900
Subject: [PATCH 3637/5547] Rename realm-backed resource store in preparation
 for non-legacy usage

---
 osu.Game/Skinning/DefaultLegacySkin.cs                     | 2 +-
 osu.Game/Skinning/LegacySkin.cs                            | 2 +-
 ...sedSkinResourceStore.cs => RealmBackedResourceStore.cs} | 7 ++++---
 3 files changed, 6 insertions(+), 5 deletions(-)
 rename osu.Game/Skinning/{LegacyDatabasedSkinResourceStore.cs => RealmBackedResourceStore.cs} (83%)

diff --git a/osu.Game/Skinning/DefaultLegacySkin.cs b/osu.Game/Skinning/DefaultLegacySkin.cs
index c7033d37dc..3a8464879a 100644
--- a/osu.Game/Skinning/DefaultLegacySkin.cs
+++ b/osu.Game/Skinning/DefaultLegacySkin.cs
@@ -34,7 +34,7 @@ namespace osu.Game.Skinning
                 resources,
                 // A default legacy skin may still have a skin.ini if it is modified by the user.
                 // We must specify the stream directly as we are redirecting storage to the osu-resources location for other files.
-                new LegacyDatabasedSkinResourceStore(skin, resources.Files).GetStream("skin.ini")
+                new RealmBackedResourceStore(skin, resources.Files).GetStream("skin.ini")
             )
         {
             Configuration.CustomColours["SliderBall"] = new Color4(2, 170, 255, 255);
diff --git a/osu.Game/Skinning/LegacySkin.cs b/osu.Game/Skinning/LegacySkin.cs
index 359d9e5624..9d71fff92f 100644
--- a/osu.Game/Skinning/LegacySkin.cs
+++ b/osu.Game/Skinning/LegacySkin.cs
@@ -51,7 +51,7 @@ namespace osu.Game.Skinning
 
         [UsedImplicitly(ImplicitUseKindFlags.InstantiatedWithFixedConstructorSignature)]
         public LegacySkin(SkinInfo skin, IStorageResourceProvider resources)
-            : this(skin, new LegacyDatabasedSkinResourceStore(skin, resources.Files), resources, "skin.ini")
+            : this(skin, new RealmBackedResourceStore(skin, resources.Files), resources, "skin.ini")
         {
         }
 
diff --git a/osu.Game/Skinning/LegacyDatabasedSkinResourceStore.cs b/osu.Game/Skinning/RealmBackedResourceStore.cs
similarity index 83%
rename from osu.Game/Skinning/LegacyDatabasedSkinResourceStore.cs
rename to osu.Game/Skinning/RealmBackedResourceStore.cs
index cd90fea9bb..93ffbe4f44 100644
--- a/osu.Game/Skinning/LegacyDatabasedSkinResourceStore.cs
+++ b/osu.Game/Skinning/RealmBackedResourceStore.cs
@@ -4,21 +4,22 @@
 using System.Collections.Generic;
 using osu.Framework.Extensions;
 using osu.Framework.IO.Stores;
+using osu.Game.Database;
 using osu.Game.Extensions;
 
 namespace osu.Game.Skinning
 {
-    public class LegacyDatabasedSkinResourceStore : ResourceStore<byte[]>
+    public class RealmBackedResourceStore : ResourceStore<byte[]>
     {
         private readonly Dictionary<string, string> fileToStoragePathMapping = new Dictionary<string, string>();
 
-        public LegacyDatabasedSkinResourceStore(SkinInfo source, IResourceStore<byte[]> underlyingStore)
+        public RealmBackedResourceStore(IHasRealmFiles source, IResourceStore<byte[]> underlyingStore)
             : base(underlyingStore)
         {
             initialiseFileCache(source);
         }
 
-        private void initialiseFileCache(SkinInfo source)
+        private void initialiseFileCache(IHasRealmFiles source)
         {
             fileToStoragePathMapping.Clear();
             foreach (var f in source.Files)

From 5631726164afcc70f323f570454c6ebe3e300b1c Mon Sep 17 00:00:00 2001
From: mcpower <mcpower@users.noreply.github.com>
Date: Tue, 22 Mar 2022 20:30:54 +1100
Subject: [PATCH 3638/5547] Add C# extension to recommended VS Code extensions

The [official C# extension] is maintained by Microsoft and enables
IDE-like support for C# in VS Code.

If a user opens this repository in VS Code, they will be prompted to
install it if they haven't already installed it. After installation, the
extension will also prompt the user to install the .NET SDK if it's not
found.

[official C# extension]: https://marketplace.visualstudio.com/items?itemName=ms-dotnettools.csharp
---
 .vscode/extensions.json | 5 +++++
 1 file changed, 5 insertions(+)
 create mode 100644 .vscode/extensions.json

diff --git a/.vscode/extensions.json b/.vscode/extensions.json
new file mode 100644
index 0000000000..5b7a98f4ba
--- /dev/null
+++ b/.vscode/extensions.json
@@ -0,0 +1,5 @@
+{
+    "recommendations": [
+        "ms-dotnettools.csharp"
+    ]
+}

From 94c5207f36f162a9a52e5234f12660c5004afbc4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 22 Mar 2022 19:04:32 +0100
Subject: [PATCH 3639/5547] Fix test not actually testing desired scenario
 anymore

The test was checking the test scene's own `SelectedMods` bindable
rather than the multiplayer screen's, and the former was never actually
being mutated by anything. Therefore the case would pass even on
`master` with the fix reverted.
---
 .../Visual/Navigation/TestSceneScreenNavigation.cs           | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs b/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
index 7e1ff08678..034c1b7581 100644
--- a/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
@@ -269,8 +269,9 @@ namespace osu.Game.Tests.Visual.Navigation
 
             AddStep("Enable autoplay", () => { Game.SelectedMods.Value = new[] { osuAutomationMod }; });
 
-            PushAndConfirm(() => new Screens.OnlinePlay.Multiplayer.Multiplayer());
-            AddUntilStep("Mods are removed", () => SelectedMods.Value.Count == 0);
+            Screens.OnlinePlay.Multiplayer.Multiplayer multiplayer = null;
+            PushAndConfirm(() => multiplayer = new Screens.OnlinePlay.Multiplayer.Multiplayer());
+            AddUntilStep("Mods are removed", () => multiplayer.Mods.Value.Count == 0);
 
             AddStep("Return to menu", () => Game.ScreenStack.CurrentScreen.Exit());
             AddUntilStep("Mods are restored", () => Game.SelectedMods.Value.Contains(osuAutomationMod));

From c8d48f89e8a7b7a30af2be41c4ef2590cc41b21e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 22 Mar 2022 19:13:22 +0100
Subject: [PATCH 3640/5547] Remove unnecessary local

---
 .../Visual/Navigation/TestSceneScreenNavigation.cs           | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs b/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
index 034c1b7581..e4535b6cd6 100644
--- a/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
@@ -269,9 +269,8 @@ namespace osu.Game.Tests.Visual.Navigation
 
             AddStep("Enable autoplay", () => { Game.SelectedMods.Value = new[] { osuAutomationMod }; });
 
-            Screens.OnlinePlay.Multiplayer.Multiplayer multiplayer = null;
-            PushAndConfirm(() => multiplayer = new Screens.OnlinePlay.Multiplayer.Multiplayer());
-            AddUntilStep("Mods are removed", () => multiplayer.Mods.Value.Count == 0);
+            PushAndConfirm(() => new Screens.OnlinePlay.Multiplayer.Multiplayer());
+            AddUntilStep("Mods are removed", () => Game.SelectedMods.Value.Count == 0);
 
             AddStep("Return to menu", () => Game.ScreenStack.CurrentScreen.Exit());
             AddUntilStep("Mods are restored", () => Game.SelectedMods.Value.Contains(osuAutomationMod));

From a38bafab912108a86bea2411350f4413da450af1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 22 Mar 2022 22:00:05 +0100
Subject: [PATCH 3641/5547] Remove unused using directive

---
 osu.Game/Screens/Edit/Editor.cs | 1 -
 1 file changed, 1 deletion(-)

diff --git a/osu.Game/Screens/Edit/Editor.cs b/osu.Game/Screens/Edit/Editor.cs
index 7254a9140f..4d5e491c60 100644
--- a/osu.Game/Screens/Edit/Editor.cs
+++ b/osu.Game/Screens/Edit/Editor.cs
@@ -28,7 +28,6 @@ using osu.Game.Graphics.UserInterface;
 using osu.Game.Input.Bindings;
 using osu.Game.Online.API;
 using osu.Game.Overlays;
-using osu.Game.Overlays.Dialog;
 using osu.Game.Overlays.Notifications;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Edit;

From f3aad772399cb786147c3adb9b9d487beada0a53 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 22 Mar 2022 22:00:24 +0100
Subject: [PATCH 3642/5547] Remove unused local variable

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

diff --git a/osu.Game/Screens/Edit/Editor.cs b/osu.Game/Screens/Edit/Editor.cs
index 4d5e491c60..57f7429e06 100644
--- a/osu.Game/Screens/Edit/Editor.cs
+++ b/osu.Game/Screens/Edit/Editor.cs
@@ -596,7 +596,7 @@ namespace osu.Game.Screens.Edit
                 }
 
                 // if the dialog is already displayed, block exiting until the user explicitly makes a decision.
-                if (dialogOverlay.CurrentDialog is PromptForSaveDialog saveDialog)
+                if (dialogOverlay.CurrentDialog is PromptForSaveDialog)
                     return true;
 
                 if (isNewBeatmap || HasUnsavedChanges)

From 51a1721bc942b71b768faae474d1a2eaa52a1dc9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 22 Mar 2022 22:10:05 +0100
Subject: [PATCH 3643/5547] Fix unprotected access to potentially-null DI'd
 dialog overlay

---
 osu.Game/Tests/Visual/EditorTestScene.cs | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Tests/Visual/EditorTestScene.cs b/osu.Game/Tests/Visual/EditorTestScene.cs
index efaf6f2253..51221cb8fe 100644
--- a/osu.Game/Tests/Visual/EditorTestScene.cs
+++ b/osu.Game/Tests/Visual/EditorTestScene.cs
@@ -97,6 +97,7 @@ namespace osu.Game.Tests.Visual
         protected class TestEditor : Editor
         {
             [Resolved(canBeNull: true)]
+            [CanBeNull]
             private DialogOverlay dialogOverlay { get; set; }
 
             public new void Undo() => base.Undo();
@@ -120,7 +121,7 @@ namespace osu.Game.Tests.Visual
             public override bool OnExiting(IScreen next)
             {
                 // For testing purposes allow the screen to exit without saving on second attempt.
-                if (!ExitConfirmed && dialogOverlay.CurrentDialog is PromptForSaveDialog saveDialog)
+                if (!ExitConfirmed && dialogOverlay?.CurrentDialog is PromptForSaveDialog saveDialog)
                 {
                     saveDialog.PerformAction<PopupDialogDangerousButton>();
                     return true;

From 9138aaf78039b39a7fcba9c2b9ada333c5346ae5 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 23 Mar 2022 10:37:53 +0900
Subject: [PATCH 3644/5547] Split MultiplayerReadyButton

---
 .../Visual/Multiplayer/QueueModeTestScene.cs  |   4 +-
 .../TestSceneAllPlayersQueueMode.cs           |   8 +-
 ...utton.cs => TestSceneMatchStartControl.cs} |  80 +++---
 .../Multiplayer/TestSceneMultiplayer.cs       |   1 +
 .../TestSceneMultiplayerMatchSubScreen.cs     |   2 +-
 .../TestSceneMultiplayerSpectateButton.cs     |   6 +-
 .../Multiplayer/Match/CountdownButton.cs      |  87 +++++++
 ...yerReadyButton.cs => MatchStartControl.cs} | 230 +-----------------
 .../Match/MultiplayerMatchFooter.cs           |   2 +-
 .../Multiplayer/Match/ReadyButton.cs          | 162 ++++++++++++
 10 files changed, 303 insertions(+), 279 deletions(-)
 rename osu.Game.Tests/Visual/Multiplayer/{TestSceneMultiplayerReadyButton.cs => TestSceneMatchStartControl.cs} (79%)
 create mode 100644 osu.Game/Screens/OnlinePlay/Multiplayer/Match/CountdownButton.cs
 rename osu.Game/Screens/OnlinePlay/Multiplayer/Match/{MultiplayerReadyButton.cs => MatchStartControl.cs} (51%)
 create mode 100644 osu.Game/Screens/OnlinePlay/Multiplayer/Match/ReadyButton.cs

diff --git a/osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs b/osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs
index df8f63f6ed..fd43674b3b 100644
--- a/osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs
@@ -95,10 +95,10 @@ namespace osu.Game.Tests.Visual.Multiplayer
         protected void RunGameplay()
         {
             AddUntilStep("wait for idle", () => MultiplayerClient.LocalUser?.State == MultiplayerUserState.Idle);
-            ClickButtonWhenEnabled<MultiplayerReadyButton.ReadyButton>();
+            ClickButtonWhenEnabled<ReadyButton>();
 
             AddUntilStep("wait for ready", () => MultiplayerClient.LocalUser?.State == MultiplayerUserState.Ready);
-            ClickButtonWhenEnabled<MultiplayerReadyButton.ReadyButton>();
+            ClickButtonWhenEnabled<ReadyButton>();
 
             AddUntilStep("wait for player", () => multiplayerComponents.CurrentScreen is Player player && player.IsLoaded);
             AddStep("exit player", () => multiplayerComponents.MultiplayerScreen.MakeCurrent());
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneAllPlayersQueueMode.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneAllPlayersQueueMode.cs
index 266ac60168..582dacb332 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneAllPlayersQueueMode.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneAllPlayersQueueMode.cs
@@ -102,10 +102,10 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddUntilStep("selected beatmap is initial beatmap", () => Beatmap.Value.BeatmapInfo.OnlineID == InitialBeatmap.OnlineID);
 
             AddUntilStep("wait for idle", () => MultiplayerClient.LocalUser?.State == MultiplayerUserState.Idle);
-            ClickButtonWhenEnabled<MultiplayerReadyButton.ReadyButton>();
+            ClickButtonWhenEnabled<ReadyButton>();
 
             AddUntilStep("wait for ready", () => MultiplayerClient.LocalUser?.State == MultiplayerUserState.Ready);
-            ClickButtonWhenEnabled<MultiplayerReadyButton.ReadyButton>();
+            ClickButtonWhenEnabled<ReadyButton>();
 
             AddUntilStep("wait for player", () => CurrentScreen is Player player && player.IsLoaded);
             AddAssert("ruleset is correct", () => ((Player)CurrentScreen).Ruleset.Value.Equals(new OsuRuleset().RulesetInfo));
@@ -119,10 +119,10 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddUntilStep("selected beatmap is initial beatmap", () => Beatmap.Value.BeatmapInfo.OnlineID == InitialBeatmap.OnlineID);
 
             AddUntilStep("wait for idle", () => MultiplayerClient.LocalUser?.State == MultiplayerUserState.Idle);
-            ClickButtonWhenEnabled<MultiplayerReadyButton.ReadyButton>();
+            ClickButtonWhenEnabled<ReadyButton>();
 
             AddUntilStep("wait for ready", () => MultiplayerClient.LocalUser?.State == MultiplayerUserState.Ready);
-            ClickButtonWhenEnabled<MultiplayerReadyButton.ReadyButton>();
+            ClickButtonWhenEnabled<ReadyButton>();
 
             AddUntilStep("wait for player", () => CurrentScreen is Player player && player.IsLoaded);
             AddAssert("mods are correct", () => !((Player)CurrentScreen).Mods.Value.Any());
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.cs
similarity index 79%
rename from osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs
rename to osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.cs
index 7bf03caa88..4e54740a69 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerReadyButton.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.cs
@@ -27,9 +27,9 @@ using osuTK.Input;
 
 namespace osu.Game.Tests.Visual.Multiplayer
 {
-    public class TestSceneMultiplayerReadyButton : MultiplayerTestScene
+    public class TestSceneMatchStartControl : MultiplayerTestScene
     {
-        private MultiplayerReadyButton button;
+        private MatchStartControl control;
         private BeatmapSetInfo importedSet;
 
         private readonly Bindable<PlaylistItem> selectedItem = new Bindable<PlaylistItem>();
@@ -62,7 +62,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             Child = new PopoverContainer
             {
                 RelativeSizeAxes = Axes.Both,
-                Child = button = new MultiplayerReadyButton
+                Child = control = new MatchStartControl
                 {
                     Anchor = Anchor.Centre,
                     Origin = Anchor.Centre,
@@ -74,17 +74,17 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [Test]
         public void TestStartWithCountdown()
         {
-            ClickButtonWhenEnabled<MultiplayerReadyButton.ReadyButton>();
-            AddUntilStep("countdown button shown", () => this.ChildrenOfType<MultiplayerReadyButton.CountdownButton>().SingleOrDefault()?.IsPresent == true);
-            ClickButtonWhenEnabled<MultiplayerReadyButton.CountdownButton>();
+            ClickButtonWhenEnabled<ReadyButton>();
+            AddUntilStep("countdown button shown", () => this.ChildrenOfType<CountdownButton>().SingleOrDefault()?.IsPresent == true);
+            ClickButtonWhenEnabled<CountdownButton>();
             AddStep("click the first countdown button", () =>
             {
-                var popoverButton = this.ChildrenOfType<MultiplayerReadyButton.CountdownButton.PopoverButton>().First();
+                var popoverButton = this.ChildrenOfType<CountdownButton.PopoverButton>().First();
                 InputManager.MoveMouseTo(popoverButton);
                 InputManager.Click(MouseButton.Left);
             });
 
-            AddAssert("countdown button not visible", () => !this.ChildrenOfType<MultiplayerReadyButton.CountdownButton>().Single().IsPresent);
+            AddAssert("countdown button not visible", () => !this.ChildrenOfType<CountdownButton>().Single().IsPresent);
             AddStep("finish countdown", () => MultiplayerClient.FinishCountdown());
             AddUntilStep("match started", () => MultiplayerClient.LocalUser?.State == MultiplayerUserState.WaitingForLoad);
         }
@@ -92,17 +92,17 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [Test]
         public void TestCancelCountdown()
         {
-            ClickButtonWhenEnabled<MultiplayerReadyButton.ReadyButton>();
-            AddUntilStep("countdown button shown", () => this.ChildrenOfType<MultiplayerReadyButton.CountdownButton>().SingleOrDefault()?.IsPresent == true);
-            ClickButtonWhenEnabled<MultiplayerReadyButton.CountdownButton>();
+            ClickButtonWhenEnabled<ReadyButton>();
+            AddUntilStep("countdown button shown", () => this.ChildrenOfType<CountdownButton>().SingleOrDefault()?.IsPresent == true);
+            ClickButtonWhenEnabled<CountdownButton>();
             AddStep("click the first countdown button", () =>
             {
-                var popoverButton = this.ChildrenOfType<MultiplayerReadyButton.CountdownButton.PopoverButton>().First();
+                var popoverButton = this.ChildrenOfType<CountdownButton.PopoverButton>().First();
                 InputManager.MoveMouseTo(popoverButton);
                 InputManager.Click(MouseButton.Left);
             });
 
-            ClickButtonWhenEnabled<MultiplayerReadyButton.ReadyButton>();
+            ClickButtonWhenEnabled<ReadyButton>();
 
             AddStep("finish countdown", () => MultiplayerClient.FinishCountdown());
             AddUntilStep("match not started", () => MultiplayerClient.LocalUser?.State == MultiplayerUserState.Ready);
@@ -119,10 +119,10 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             AddStep("start with countdown", () => MultiplayerClient.SendMatchRequest(new StartMatchCountdownRequest { Delay = TimeSpan.FromMinutes(2) }).WaitSafely());
 
-            ClickButtonWhenEnabled<MultiplayerReadyButton.ReadyButton>();
+            ClickButtonWhenEnabled<ReadyButton>();
             AddUntilStep("user is ready", () => MultiplayerClient.Room?.Users[0].State == MultiplayerUserState.Ready);
 
-            ClickButtonWhenEnabled<MultiplayerReadyButton.ReadyButton>();
+            ClickButtonWhenEnabled<ReadyButton>();
             AddUntilStep("user is idle", () => MultiplayerClient.Room?.Users[0].State == MultiplayerUserState.Idle);
         }
 
@@ -132,25 +132,25 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddStep("set spectating", () => MultiplayerClient.ChangeUserState(API.LocalUser.Value.OnlineID, MultiplayerUserState.Spectating));
             AddUntilStep("local user is spectating", () => MultiplayerClient.LocalUser?.State == MultiplayerUserState.Spectating);
 
-            AddAssert("countdown button is visible", () => this.ChildrenOfType<MultiplayerReadyButton.CountdownButton>().Single().IsPresent);
-            AddAssert("countdown button disabled", () => !this.ChildrenOfType<MultiplayerReadyButton.CountdownButton>().Single().Enabled.Value);
+            AddAssert("countdown button is visible", () => this.ChildrenOfType<CountdownButton>().Single().IsPresent);
+            AddAssert("countdown button disabled", () => !this.ChildrenOfType<CountdownButton>().Single().Enabled.Value);
 
             AddStep("add second user", () => MultiplayerClient.AddUser(new APIUser { Id = 2, Username = "Another user" }));
-            AddAssert("countdown button disabled", () => !this.ChildrenOfType<MultiplayerReadyButton.CountdownButton>().Single().Enabled.Value);
+            AddAssert("countdown button disabled", () => !this.ChildrenOfType<CountdownButton>().Single().Enabled.Value);
 
             AddStep("set second user ready", () => MultiplayerClient.ChangeUserState(2, MultiplayerUserState.Ready));
-            AddAssert("countdown button enabled", () => this.ChildrenOfType<MultiplayerReadyButton.CountdownButton>().Single().Enabled.Value);
+            AddAssert("countdown button enabled", () => this.ChildrenOfType<CountdownButton>().Single().Enabled.Value);
         }
 
         [Test]
         public void TestSpectatingDuringCountdownWithNoReadyUsersCancelsCountdown()
         {
-            ClickButtonWhenEnabled<MultiplayerReadyButton.ReadyButton>();
-            AddUntilStep("countdown button shown", () => this.ChildrenOfType<MultiplayerReadyButton.CountdownButton>().SingleOrDefault()?.IsPresent == true);
-            ClickButtonWhenEnabled<MultiplayerReadyButton.CountdownButton>();
+            ClickButtonWhenEnabled<ReadyButton>();
+            AddUntilStep("countdown button shown", () => this.ChildrenOfType<CountdownButton>().SingleOrDefault()?.IsPresent == true);
+            ClickButtonWhenEnabled<CountdownButton>();
             AddStep("click the first countdown button", () =>
             {
-                var popoverButton = this.ChildrenOfType<MultiplayerReadyButton.CountdownButton.PopoverButton>().First();
+                var popoverButton = this.ChildrenOfType<CountdownButton.PopoverButton>().First();
                 InputManager.MoveMouseTo(popoverButton);
                 InputManager.Click(MouseButton.Left);
             });
@@ -168,12 +168,12 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddStep("add second user", () => MultiplayerClient.AddUser(new APIUser { Id = 2, Username = "Another user" }));
             AddStep("set second user ready", () => MultiplayerClient.ChangeUserState(2, MultiplayerUserState.Ready));
 
-            ClickButtonWhenEnabled<MultiplayerReadyButton.ReadyButton>();
-            AddUntilStep("countdown button shown", () => this.ChildrenOfType<MultiplayerReadyButton.CountdownButton>().SingleOrDefault()?.IsPresent == true);
-            ClickButtonWhenEnabled<MultiplayerReadyButton.CountdownButton>();
+            ClickButtonWhenEnabled<ReadyButton>();
+            AddUntilStep("countdown button shown", () => this.ChildrenOfType<CountdownButton>().SingleOrDefault()?.IsPresent == true);
+            ClickButtonWhenEnabled<CountdownButton>();
             AddStep("click the first countdown button", () =>
             {
-                var popoverButton = this.ChildrenOfType<MultiplayerReadyButton.CountdownButton.PopoverButton>().First();
+                var popoverButton = this.ChildrenOfType<CountdownButton.PopoverButton>().First();
                 InputManager.MoveMouseTo(popoverButton);
                 InputManager.Click(MouseButton.Left);
             });
@@ -181,7 +181,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddStep("set spectating", () => MultiplayerClient.ChangeUserState(API.LocalUser.Value.OnlineID, MultiplayerUserState.Spectating));
             AddUntilStep("local user is spectating", () => MultiplayerClient.LocalUser?.State == MultiplayerUserState.Spectating);
 
-            AddAssert("ready button enabled", () => this.ChildrenOfType<MultiplayerReadyButton.ReadyButton>().Single().Enabled.Value);
+            AddAssert("ready button enabled", () => this.ChildrenOfType<ReadyButton>().Single().Enabled.Value);
         }
 
         [Test]
@@ -199,7 +199,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddStep("transfer host to local user", () => MultiplayerClient.TransferHost(API.LocalUser.Value.OnlineID));
             AddUntilStep("local user is host", () => MultiplayerClient.Room?.Host?.Equals(MultiplayerClient.LocalUser) == true);
 
-            ClickButtonWhenEnabled<MultiplayerReadyButton.ReadyButton>();
+            ClickButtonWhenEnabled<ReadyButton>();
             AddUntilStep("local user became ready", () => MultiplayerClient.LocalUser?.State == MultiplayerUserState.Ready);
             AddAssert("countdown still active", () => MultiplayerClient.Room?.Countdown != null);
         }
@@ -211,7 +211,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             AddUntilStep("ensure ready button enabled", () =>
             {
-                readyButton = button.ChildrenOfType<OsuButton>().Single();
+                readyButton = control.ChildrenOfType<OsuButton>().Single();
                 return readyButton.Enabled.Value;
             });
 
@@ -230,10 +230,10 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 MultiplayerClient.TransferHost(2);
             });
 
-            ClickButtonWhenEnabled<MultiplayerReadyButton.ReadyButton>();
+            ClickButtonWhenEnabled<ReadyButton>();
             AddUntilStep("user is ready", () => MultiplayerClient.Room?.Users[0].State == MultiplayerUserState.Ready);
 
-            ClickButtonWhenEnabled<MultiplayerReadyButton.ReadyButton>();
+            ClickButtonWhenEnabled<ReadyButton>();
             AddUntilStep("user is idle", () => MultiplayerClient.Room?.Users[0].State == MultiplayerUserState.Idle);
         }
 
@@ -249,7 +249,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     MultiplayerClient.AddUser(new APIUser { Id = 2, Username = "Another user" });
             });
 
-            ClickButtonWhenEnabled<MultiplayerReadyButton.ReadyButton>();
+            ClickButtonWhenEnabled<ReadyButton>();
             AddUntilStep("user is ready", () => MultiplayerClient.Room?.Users[0].State == MultiplayerUserState.Ready);
 
             verifyGameplayStartFlow();
@@ -264,7 +264,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 MultiplayerClient.TransferHost(2);
             });
 
-            ClickButtonWhenEnabled<MultiplayerReadyButton.ReadyButton>();
+            ClickButtonWhenEnabled<ReadyButton>();
             AddStep("make user host", () => MultiplayerClient.TransferHost(MultiplayerClient.Room?.Users[0].UserID ?? 0));
 
             verifyGameplayStartFlow();
@@ -279,14 +279,14 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 MultiplayerClient.AddUser(new APIUser { Id = 2, Username = "Another user" });
             });
 
-            ClickButtonWhenEnabled<MultiplayerReadyButton.ReadyButton>();
+            ClickButtonWhenEnabled<ReadyButton>();
             AddUntilStep("user is ready", () => MultiplayerClient.Room?.Users[0].State == MultiplayerUserState.Ready);
 
             AddStep("transfer host", () => MultiplayerClient.TransferHost(MultiplayerClient.Room?.Users[1].UserID ?? 0));
 
-            ClickButtonWhenEnabled<MultiplayerReadyButton.ReadyButton>();
+            ClickButtonWhenEnabled<ReadyButton>();
             AddUntilStep("user is idle (match not started)", () => MultiplayerClient.Room?.Users[0].State == MultiplayerUserState.Idle);
-            AddAssert("ready button enabled", () => button.ChildrenOfType<OsuButton>().Single().Enabled.Value);
+            AddAssert("ready button enabled", () => control.ChildrenOfType<OsuButton>().Single().Enabled.Value);
         }
 
         [TestCase(true)]
@@ -304,7 +304,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             if (!isHost)
                 AddStep("transfer host", () => MultiplayerClient.TransferHost(2));
 
-            ClickButtonWhenEnabled<MultiplayerReadyButton.ReadyButton>();
+            ClickButtonWhenEnabled<ReadyButton>();
 
             AddRepeatStep("change user ready state", () =>
             {
@@ -322,7 +322,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         private void verifyGameplayStartFlow()
         {
             AddUntilStep("user is ready", () => MultiplayerClient.Room?.Users[0].State == MultiplayerUserState.Ready);
-            ClickButtonWhenEnabled<MultiplayerReadyButton.ReadyButton>();
+            ClickButtonWhenEnabled<ReadyButton>();
             AddUntilStep("user waiting for load", () => MultiplayerClient.Room?.Users[0].State == MultiplayerUserState.WaitingForLoad);
 
             AddStep("finish gameplay", () =>
@@ -331,7 +331,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 MultiplayerClient.ChangeUserState(MultiplayerClient.Room?.Users[0].UserID ?? 0, MultiplayerUserState.FinishedPlay);
             });
 
-            AddUntilStep("ready button enabled", () => button.ChildrenOfType<OsuButton>().Single().Enabled.Value);
+            AddUntilStep("ready button enabled", () => control.ChildrenOfType<OsuButton>().Single().Enabled.Value);
         }
     }
 }
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
index 6300dfa381..d0765fc4b3 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
@@ -41,6 +41,7 @@ using osu.Game.Screens.Ranking;
 using osu.Game.Screens.Spectate;
 using osu.Game.Tests.Resources;
 using osuTK.Input;
+using ReadyButton = osu.Game.Screens.OnlinePlay.Components.ReadyButton;
 
 namespace osu.Game.Tests.Visual.Multiplayer
 {
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs
index a51d4678fe..850a115f4c 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs
@@ -145,7 +145,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             AddUntilStep("wait for spectating user state", () => MultiplayerClient.LocalUser?.State == MultiplayerUserState.Spectating);
 
-            ClickButtonWhenEnabled<MultiplayerReadyButton.ReadyButton>();
+            ClickButtonWhenEnabled<ReadyButton>();
 
             AddUntilStep("match started", () => MultiplayerClient.Room?.State == MultiplayerRoomState.WaitingForLoad);
         }
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerSpectateButton.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerSpectateButton.cs
index 13c9e021db..07ac580276 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerSpectateButton.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerSpectateButton.cs
@@ -27,7 +27,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
     public class TestSceneMultiplayerSpectateButton : MultiplayerTestScene
     {
         private MultiplayerSpectateButton spectateButton;
-        private MultiplayerReadyButton readyButton;
+        private MatchStartControl startControl;
 
         private readonly Bindable<PlaylistItem> selectedItem = new Bindable<PlaylistItem>();
 
@@ -72,7 +72,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                             Origin = Anchor.Centre,
                             Size = new Vector2(200, 50),
                         },
-                        readyButton = new MultiplayerReadyButton
+                        startControl = new MatchStartControl
                         {
                             Anchor = Anchor.Centre,
                             Origin = Anchor.Centre,
@@ -146,6 +146,6 @@ namespace osu.Game.Tests.Visual.Multiplayer
             => AddUntilStep($"spectate button {(shouldBeEnabled ? "is" : "is not")} enabled", () => spectateButton.ChildrenOfType<OsuButton>().Single().Enabled.Value == shouldBeEnabled);
 
         private void assertReadyButtonEnablement(bool shouldBeEnabled)
-            => AddUntilStep($"ready button {(shouldBeEnabled ? "is" : "is not")} enabled", () => readyButton.ChildrenOfType<OsuButton>().Single().Enabled.Value == shouldBeEnabled);
+            => AddUntilStep($"ready button {(shouldBeEnabled ? "is" : "is not")} enabled", () => startControl.ChildrenOfType<ReadyButton>().Single().Enabled.Value == shouldBeEnabled);
     }
 }
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/CountdownButton.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/CountdownButton.cs
new file mode 100644
index 0000000000..e598f6670c
--- /dev/null
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/CountdownButton.cs
@@ -0,0 +1,87 @@
+// 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 Humanizer;
+using osu.Framework.Allocation;
+using osu.Framework.Extensions;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.Cursor;
+using osu.Framework.Graphics.Shapes;
+using osu.Framework.Graphics.Sprites;
+using osu.Framework.Graphics.UserInterface;
+using osu.Game.Graphics;
+using osu.Game.Graphics.UserInterface;
+using osu.Game.Graphics.UserInterfaceV2;
+using osuTK;
+
+namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
+{
+    public class CountdownButton : IconButton, IHasPopover
+    {
+        private static readonly TimeSpan[] available_delays =
+        {
+            TimeSpan.FromSeconds(10),
+            TimeSpan.FromSeconds(30),
+            TimeSpan.FromMinutes(1),
+            TimeSpan.FromMinutes(2)
+        };
+
+        public new Action<TimeSpan> Action;
+
+        private readonly Drawable background;
+
+        public CountdownButton()
+        {
+            Icon = FontAwesome.Solid.CaretDown;
+            IconScale = new Vector2(0.6f);
+
+            Add(background = new Box
+            {
+                RelativeSizeAxes = Axes.Both,
+                Depth = float.MaxValue
+            });
+
+            base.Action = this.ShowPopover;
+        }
+
+        [BackgroundDependencyLoader]
+        private void load(OsuColour colours)
+        {
+            background.Colour = colours.Green;
+        }
+
+        public Popover GetPopover()
+        {
+            var flow = new FillFlowContainer
+            {
+                Width = 200,
+                AutoSizeAxes = Axes.Y,
+                Direction = FillDirection.Vertical,
+                Spacing = new Vector2(2),
+            };
+
+            foreach (var duration in available_delays)
+            {
+                flow.Add(new PopoverButton
+                {
+                    RelativeSizeAxes = Axes.X,
+                    Text = $"Start match in {duration.Humanize()}",
+                    BackgroundColour = background.Colour,
+                    Action = () =>
+                    {
+                        Action(duration);
+                        this.HidePopover();
+                    }
+                });
+            }
+
+            return new OsuPopover { Child = flow };
+        }
+
+        public class PopoverButton : OsuButton
+        {
+        }
+    }
+}
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MatchStartControl.cs
similarity index 51%
rename from osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
rename to osu.Game/Screens/OnlinePlay/Multiplayer/Match/MatchStartControl.cs
index 4c4cc87f6d..d97ac601d5 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MatchStartControl.cs
@@ -4,32 +4,21 @@
 using System;
 using System.Diagnostics;
 using System.Linq;
-using Humanizer;
 using JetBrains.Annotations;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
 using osu.Framework.Audio.Sample;
 using osu.Framework.Bindables;
-using osu.Framework.Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
-using osu.Framework.Graphics.Cursor;
-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.Backgrounds;
-using osu.Game.Graphics.UserInterface;
-using osu.Game.Graphics.UserInterfaceV2;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Multiplayer.Countdown;
 using osuTK;
 
 namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
 {
-    public class MultiplayerReadyButton : MultiplayerRoomComposite
+    public class MatchStartControl : MultiplayerRoomComposite
     {
         [Resolved]
         private OngoingOperationTracker ongoingOperationTracker { get; set; }
@@ -47,7 +36,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
         private ScheduledDelegate readySampleDelegate;
         private IBindable<bool> operationInProgress;
 
-        public MultiplayerReadyButton()
+        public MatchStartControl()
         {
             InternalChild = new GridContainer
             {
@@ -231,220 +220,5 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
                 countReady = newCountReady;
             });
         }
-
-        public class ReadyButton : Components.ReadyButton
-        {
-            public new Triangles Triangles => base.Triangles;
-
-            [Resolved]
-            private MultiplayerClient multiplayerClient { get; set; }
-
-            [Resolved]
-            private OsuColour colours { get; set; }
-
-            [CanBeNull]
-            private MultiplayerRoom room => multiplayerClient.Room;
-
-            protected override void LoadComplete()
-            {
-                base.LoadComplete();
-
-                multiplayerClient.RoomUpdated += () => Scheduler.AddOnce(onRoomUpdated);
-                onRoomUpdated();
-            }
-
-            protected override void Update()
-            {
-                base.Update();
-
-                if (room?.Countdown != null)
-                {
-                    // Update the countdown timer.
-                    onRoomUpdated();
-                }
-            }
-
-            private void onRoomUpdated()
-            {
-                updateButtonText();
-                updateButtonColour();
-            }
-
-            private void updateButtonText()
-            {
-                if (room == null)
-                {
-                    Text = "Ready";
-                    return;
-                }
-
-                var localUser = multiplayerClient.LocalUser;
-
-                int countReady = room.Users.Count(u => u.State == MultiplayerUserState.Ready);
-                int countTotal = room.Users.Count(u => u.State != MultiplayerUserState.Spectating);
-                string countText = $"({countReady} / {countTotal} ready)";
-
-                if (room.Countdown != null)
-                {
-                    string countdownText = $"Starting in {room.Countdown.EndTime - DateTimeOffset.Now:mm\\:ss}";
-
-                    switch (localUser?.State)
-                    {
-                        default:
-                            Text = $"Ready ({countdownText.ToLowerInvariant()})";
-                            break;
-
-                        case MultiplayerUserState.Spectating:
-                        case MultiplayerUserState.Ready:
-                            Text = $"{countdownText} {countText}";
-                            break;
-                    }
-                }
-                else
-                {
-                    switch (localUser?.State)
-                    {
-                        default:
-                            Text = "Ready";
-                            break;
-
-                        case MultiplayerUserState.Spectating:
-                        case MultiplayerUserState.Ready:
-                            Text = room.Host?.Equals(localUser) == true
-                                ? $"Start match {countText}"
-                                : $"Waiting for host... {countText}";
-
-                            break;
-                    }
-                }
-            }
-
-            private void updateButtonColour()
-            {
-                if (room == null)
-                {
-                    setGreen();
-                    return;
-                }
-
-                var localUser = multiplayerClient.LocalUser;
-
-                switch (localUser?.State)
-                {
-                    default:
-                        setGreen();
-                        break;
-
-                    case MultiplayerUserState.Spectating:
-                    case MultiplayerUserState.Ready:
-                        if (room?.Host?.Equals(localUser) == true && room.Countdown == null)
-                            setGreen();
-                        else
-                            setYellow();
-
-                        break;
-                }
-
-                void setYellow()
-                {
-                    BackgroundColour = colours.YellowDark;
-                    Triangles.ColourDark = colours.YellowDark;
-                    Triangles.ColourLight = colours.Yellow;
-                }
-
-                void setGreen()
-                {
-                    BackgroundColour = colours.Green;
-                    Triangles.ColourDark = colours.Green;
-                    Triangles.ColourLight = colours.GreenLight;
-                }
-            }
-
-            protected override void Dispose(bool isDisposing)
-            {
-                base.Dispose(isDisposing);
-
-                if (multiplayerClient != null)
-                    multiplayerClient.RoomUpdated -= onRoomUpdated;
-            }
-
-            public override LocalisableString TooltipText
-            {
-                get
-                {
-                    if (room?.Countdown != null && multiplayerClient.IsHost && multiplayerClient.LocalUser?.State == MultiplayerUserState.Ready)
-                        return "Cancel countdown";
-
-                    return base.TooltipText;
-                }
-            }
-        }
-
-        public class CountdownButton : IconButton, IHasPopover
-        {
-            private static readonly TimeSpan[] available_delays =
-            {
-                TimeSpan.FromSeconds(10),
-                TimeSpan.FromSeconds(30),
-                TimeSpan.FromMinutes(1),
-                TimeSpan.FromMinutes(2)
-            };
-
-            public new Action<TimeSpan> Action;
-
-            private readonly Drawable background;
-
-            public CountdownButton()
-            {
-                Icon = FontAwesome.Solid.CaretDown;
-                IconScale = new Vector2(0.6f);
-
-                Add(background = new Box
-                {
-                    RelativeSizeAxes = Axes.Both,
-                    Depth = float.MaxValue
-                });
-
-                base.Action = this.ShowPopover;
-            }
-
-            [BackgroundDependencyLoader]
-            private void load(OsuColour colours)
-            {
-                background.Colour = colours.Green;
-            }
-
-            public Popover GetPopover()
-            {
-                var flow = new FillFlowContainer
-                {
-                    Width = 200,
-                    AutoSizeAxes = Axes.Y,
-                    Direction = FillDirection.Vertical,
-                    Spacing = new Vector2(2),
-                };
-
-                foreach (var duration in available_delays)
-                {
-                    flow.Add(new PopoverButton
-                    {
-                        RelativeSizeAxes = Axes.X,
-                        Text = $"Start match in {duration.Humanize()}",
-                        BackgroundColour = background.Colour,
-                        Action = () =>
-                        {
-                            Action(duration);
-                            this.HidePopover();
-                        }
-                    });
-                }
-
-                return new OsuPopover { Child = flow };
-            }
-
-            public class PopoverButton : OsuButton
-            {
-            }
-        }
     }
 }
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchFooter.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchFooter.cs
index b4fce5903b..a07c95bca8 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchFooter.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchFooter.cs
@@ -28,7 +28,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
                             RelativeSizeAxes = Axes.Both,
                         },
                         null,
-                        new MultiplayerReadyButton
+                        new MatchStartControl
                         {
                             RelativeSizeAxes = Axes.Both,
                         },
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/ReadyButton.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/ReadyButton.cs
new file mode 100644
index 0000000000..8e3a9f9349
--- /dev/null
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/ReadyButton.cs
@@ -0,0 +1,162 @@
+// 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 JetBrains.Annotations;
+using osu.Framework.Allocation;
+using osu.Framework.Localisation;
+using osu.Game.Graphics;
+using osu.Game.Graphics.Backgrounds;
+using osu.Game.Online.Multiplayer;
+
+namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
+{
+    public class ReadyButton : Components.ReadyButton
+    {
+        public new Triangles Triangles => base.Triangles;
+
+        [Resolved]
+        private MultiplayerClient multiplayerClient { get; set; }
+
+        [Resolved]
+        private OsuColour colours { get; set; }
+
+        [CanBeNull]
+        private MultiplayerRoom room => multiplayerClient.Room;
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            multiplayerClient.RoomUpdated += () => Scheduler.AddOnce(onRoomUpdated);
+            onRoomUpdated();
+        }
+
+        protected override void Update()
+        {
+            base.Update();
+
+            if (room?.Countdown != null)
+            {
+                // Update the countdown timer.
+                onRoomUpdated();
+            }
+        }
+
+        private void onRoomUpdated()
+        {
+            updateButtonText();
+            updateButtonColour();
+        }
+
+        private void updateButtonText()
+        {
+            if (room == null)
+            {
+                Text = "Ready";
+                return;
+            }
+
+            var localUser = multiplayerClient.LocalUser;
+
+            int countReady = room.Users.Count(u => u.State == MultiplayerUserState.Ready);
+            int countTotal = room.Users.Count(u => u.State != MultiplayerUserState.Spectating);
+            string countText = $"({countReady} / {countTotal} ready)";
+
+            if (room.Countdown != null)
+            {
+                string countdownText = $"Starting in {room.Countdown.EndTime - DateTimeOffset.Now:mm\\:ss}";
+
+                switch (localUser?.State)
+                {
+                    default:
+                        Text = $"Ready ({countdownText.ToLowerInvariant()})";
+                        break;
+
+                    case MultiplayerUserState.Spectating:
+                    case MultiplayerUserState.Ready:
+                        Text = $"{countdownText} {countText}";
+                        break;
+                }
+            }
+            else
+            {
+                switch (localUser?.State)
+                {
+                    default:
+                        Text = "Ready";
+                        break;
+
+                    case MultiplayerUserState.Spectating:
+                    case MultiplayerUserState.Ready:
+                        Text = room.Host?.Equals(localUser) == true
+                            ? $"Start match {countText}"
+                            : $"Waiting for host... {countText}";
+
+                        break;
+                }
+            }
+        }
+
+        private void updateButtonColour()
+        {
+            if (room == null)
+            {
+                setGreen();
+                return;
+            }
+
+            var localUser = multiplayerClient.LocalUser;
+
+            switch (localUser?.State)
+            {
+                default:
+                    setGreen();
+                    break;
+
+                case MultiplayerUserState.Spectating:
+                case MultiplayerUserState.Ready:
+                    if (room?.Host?.Equals(localUser) == true && room.Countdown == null)
+                        setGreen();
+                    else
+                        setYellow();
+
+                    break;
+            }
+
+            void setYellow()
+            {
+                BackgroundColour = colours.YellowDark;
+                Triangles.ColourDark = colours.YellowDark;
+                Triangles.ColourLight = colours.Yellow;
+            }
+
+            void setGreen()
+            {
+                BackgroundColour = colours.Green;
+                Triangles.ColourDark = colours.Green;
+                Triangles.ColourLight = colours.GreenLight;
+            }
+        }
+
+        protected override void Dispose(bool isDisposing)
+        {
+            base.Dispose(isDisposing);
+
+            if (multiplayerClient != null)
+                multiplayerClient.RoomUpdated -= onRoomUpdated;
+        }
+
+        public override LocalisableString TooltipText
+        {
+            get
+            {
+                if (room?.Countdown != null && multiplayerClient.IsHost && multiplayerClient.LocalUser?.State == MultiplayerUserState.Ready)
+                    return "Cancel countdown";
+
+                return base.TooltipText;
+            }
+        }
+    }
+}

From 6b712be97d08de140bd6d3b0cb81d8d90412194b Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 23 Mar 2022 10:40:05 +0900
Subject: [PATCH 3645/5547] Remove PopoverButton class

---
 .../Visual/Multiplayer/TestSceneMatchStartControl.cs      | 8 ++++----
 .../OnlinePlay/Multiplayer/Match/CountdownButton.cs       | 6 +-----
 2 files changed, 5 insertions(+), 9 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.cs
index 4e54740a69..b98676e737 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.cs
@@ -79,7 +79,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             ClickButtonWhenEnabled<CountdownButton>();
             AddStep("click the first countdown button", () =>
             {
-                var popoverButton = this.ChildrenOfType<CountdownButton.PopoverButton>().First();
+                var popoverButton = this.ChildrenOfType<CountdownButton>().Single().ChildrenOfType<OsuButton>().First();
                 InputManager.MoveMouseTo(popoverButton);
                 InputManager.Click(MouseButton.Left);
             });
@@ -97,7 +97,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             ClickButtonWhenEnabled<CountdownButton>();
             AddStep("click the first countdown button", () =>
             {
-                var popoverButton = this.ChildrenOfType<CountdownButton.PopoverButton>().First();
+                var popoverButton = this.ChildrenOfType<CountdownButton>().Single().ChildrenOfType<OsuButton>().First();
                 InputManager.MoveMouseTo(popoverButton);
                 InputManager.Click(MouseButton.Left);
             });
@@ -150,7 +150,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             ClickButtonWhenEnabled<CountdownButton>();
             AddStep("click the first countdown button", () =>
             {
-                var popoverButton = this.ChildrenOfType<CountdownButton.PopoverButton>().First();
+                var popoverButton = this.ChildrenOfType<CountdownButton>().Single().ChildrenOfType<OsuButton>().First();
                 InputManager.MoveMouseTo(popoverButton);
                 InputManager.Click(MouseButton.Left);
             });
@@ -173,7 +173,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             ClickButtonWhenEnabled<CountdownButton>();
             AddStep("click the first countdown button", () =>
             {
-                var popoverButton = this.ChildrenOfType<CountdownButton.PopoverButton>().First();
+                var popoverButton = this.ChildrenOfType<CountdownButton>().Single().ChildrenOfType<OsuButton>().First();
                 InputManager.MoveMouseTo(popoverButton);
                 InputManager.Click(MouseButton.Left);
             });
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/CountdownButton.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/CountdownButton.cs
index e598f6670c..e37168bf25 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/CountdownButton.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/CountdownButton.cs
@@ -64,7 +64,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
 
             foreach (var duration in available_delays)
             {
-                flow.Add(new PopoverButton
+                flow.Add(new OsuButton
                 {
                     RelativeSizeAxes = Axes.X,
                     Text = $"Start match in {duration.Humanize()}",
@@ -79,9 +79,5 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
 
             return new OsuPopover { Child = flow };
         }
-
-        public class PopoverButton : OsuButton
-        {
-        }
     }
 }

From d4ad4ac9db8c76be1cd9545944dca12e582d41f9 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 23 Mar 2022 10:50:05 +0900
Subject: [PATCH 3646/5547] Limit countdown updates to once per second

---
 .../Multiplayer/Match/ReadyButton.cs          | 20 +++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/ReadyButton.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/ReadyButton.cs
index 8e3a9f9349..b37d990466 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/ReadyButton.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/ReadyButton.cs
@@ -6,6 +6,7 @@ using System.Linq;
 using JetBrains.Annotations;
 using osu.Framework.Allocation;
 using osu.Framework.Localisation;
+using osu.Framework.Threading;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Backgrounds;
 using osu.Game.Online.Multiplayer;
@@ -33,21 +34,20 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
             onRoomUpdated();
         }
 
-        protected override void Update()
-        {
-            base.Update();
-
-            if (room?.Countdown != null)
-            {
-                // Update the countdown timer.
-                onRoomUpdated();
-            }
-        }
+        private ScheduledDelegate countdownUpdateDelegate;
 
         private void onRoomUpdated()
         {
             updateButtonText();
             updateButtonColour();
+
+            if (room?.Countdown != null)
+                countdownUpdateDelegate ??= Scheduler.AddDelayed(updateButtonText, 1000, true);
+            else
+            {
+                countdownUpdateDelegate?.Cancel();
+                countdownUpdateDelegate = null;
+            }
         }
 
         private void updateButtonText()

From 657daf07d745626681d4998eaa84193e8dad43e2 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 23 Mar 2022 11:03:24 +0900
Subject: [PATCH 3647/5547] Update LocalisationAnalyser to support .net6

---
 .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 985fc09df3..4177c402aa 100644
--- a/.config/dotnet-tools.json
+++ b/.config/dotnet-tools.json
@@ -27,7 +27,7 @@
       ]
     },
     "ppy.localisationanalyser.tools": {
-      "version": "2021.1210.0",
+      "version": "2022.320.0",
       "commands": [
         "localisation"
       ]
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 5e194e2aca..1c1deaae8e 100644
--- a/osu.Game/osu.Game.csproj
+++ b/osu.Game/osu.Game.csproj
@@ -31,7 +31,7 @@
     <PackageReference Include="Microsoft.Extensions.Configuration.Abstractions" Version="6.0.0" />
     <PackageReference Include="Microsoft.NETCore.Targets" Version="3.1.0" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
-    <PackageReference Include="ppy.LocalisationAnalyser" Version="2021.1210.0">
+    <PackageReference Include="ppy.LocalisationAnalyser" Version="2022.320.0">
       <PrivateAssets>all</PrivateAssets>
       <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
     </PackageReference>

From 5c4a74378dec7f2b64f5de49abde8779c6793486 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 22 Mar 2022 18:36:42 +0900
Subject: [PATCH 3648/5547] Remove `Textures` and `Samples` initialisation to
 `Skin`

---
 osu.Game/Skinning/LegacySkin.cs | 25 ---------
 osu.Game/Skinning/Skin.cs       | 99 ++++++++++++++++++---------------
 2 files changed, 53 insertions(+), 71 deletions(-)

diff --git a/osu.Game/Skinning/LegacySkin.cs b/osu.Game/Skinning/LegacySkin.cs
index 9d71fff92f..5533615568 100644
--- a/osu.Game/Skinning/LegacySkin.cs
+++ b/osu.Game/Skinning/LegacySkin.cs
@@ -27,12 +27,6 @@ namespace osu.Game.Skinning
 {
     public class LegacySkin : Skin
     {
-        [CanBeNull]
-        protected TextureStore Textures;
-
-        [CanBeNull]
-        protected ISampleStore Samples;
-
         /// <summary>
         /// Whether texture for the keys exists.
         /// Used to determine if the mania ruleset is skinned.
@@ -77,18 +71,6 @@ namespace osu.Game.Skinning
         protected LegacySkin(SkinInfo skin, [CanBeNull] IResourceStore<byte[]> storage, [CanBeNull] IStorageResourceProvider resources, [CanBeNull] Stream configurationStream)
             : base(skin, resources, configurationStream)
         {
-            if (storage != null)
-            {
-                var samples = resources?.AudioManager?.GetSampleStore(storage);
-                if (samples != null)
-                    samples.PlaybackConcurrency = OsuGameBase.SAMPLE_CONCURRENCY;
-
-                Samples = samples;
-                Textures = new TextureStore(resources?.CreateTextureLoaderStore(storage));
-
-                (storage as ResourceStore<byte[]>)?.AddExtension("ogg");
-            }
-
             // todo: this shouldn't really be duplicated here (from ManiaLegacySkinTransformer). we need to come up with a better solution.
             hasKeyTexture = new Lazy<bool>(() => this.GetAnimation(
                 lookupForMania<string>(new LegacyManiaSkinConfigurationLookup(4, LegacyManiaSkinConfigurationLookups.KeyImage, 0))?.Value ?? "mania-key1", true,
@@ -551,12 +533,5 @@ namespace osu.Game.Skinning
             // Fall back to using the last piece for components coming from lazer (e.g. "Gameplay/osu/approachcircle" -> "approachcircle").
             yield return componentName.Split('/').Last();
         }
-
-        protected override void Dispose(bool isDisposing)
-        {
-            base.Dispose(isDisposing);
-            Textures?.Dispose();
-            Samples?.Dispose();
-        }
     }
 }
diff --git a/osu.Game/Skinning/Skin.cs b/osu.Game/Skinning/Skin.cs
index 931bdfed48..d1ea7aa300 100644
--- a/osu.Game/Skinning/Skin.cs
+++ b/osu.Game/Skinning/Skin.cs
@@ -16,7 +16,6 @@ using osu.Framework.Graphics.Textures;
 using osu.Framework.Logging;
 using osu.Game.Audio;
 using osu.Game.Database;
-using osu.Game.Extensions;
 using osu.Game.IO;
 using osu.Game.Screens.Play.HUD;
 
@@ -24,8 +23,19 @@ namespace osu.Game.Skinning
 {
     public abstract class Skin : IDisposable, ISkin
     {
+        /// <summary>
+        /// A texture store which can be used to perform user file loops for this skin.
+        /// </summary>
+        [CanBeNull]
+        protected TextureStore Textures { get; set; }
+
+        /// <summary>
+        /// A sample store which can be used to perform user file loops for this skin.
+        /// </summary>
+        [CanBeNull]
+        protected ISampleStore Samples { get; set; }
+
         public readonly Live<SkinInfo> SkinInfo;
-        private readonly IStorageResourceProvider resources;
 
         public SkinConfiguration Configuration { get; set; }
 
@@ -41,16 +51,30 @@ namespace osu.Game.Skinning
 
         public abstract IBindable<TValue> GetConfig<TLookup, TValue>(TLookup lookup);
 
+        private readonly RealmBackedResourceStore skinStorage;
+
         protected Skin(SkinInfo skin, IStorageResourceProvider resources, [CanBeNull] Stream configurationStream = null)
         {
-            SkinInfo = resources?.RealmAccess != null
-                ? skin.ToLive(resources.RealmAccess)
-                // This path should only be used in some tests.
-                : skin.ToLiveUnmanaged();
+            if (resources.RealmAccess != null)
+            {
+                SkinInfo = skin.ToLive(resources.RealmAccess);
+                skinStorage = new RealmBackedResourceStore(skin, resources.Files);
 
-            this.resources = resources;
+                var samples = resources?.AudioManager?.GetSampleStore(skinStorage);
+                if (samples != null)
+                    samples.PlaybackConcurrency = OsuGameBase.SAMPLE_CONCURRENCY;
 
-            configurationStream ??= getConfigurationStream();
+                Samples = samples;
+                Textures = new TextureStore(resources?.CreateTextureLoaderStore(skinStorage));
+
+                skinStorage.AddExtension("ogg");
+            }
+            else
+            {
+                SkinInfo = skin.ToLiveUnmanaged();
+            }
+
+            configurationStream ??= skinStorage?.GetStream(@"skin.ini");
 
             if (configurationStream != null)
                 // stream will be closed after use by LineBufferedReader.
@@ -59,40 +83,30 @@ namespace osu.Game.Skinning
                 Configuration = new SkinConfiguration();
 
             // skininfo files may be null for default skin.
-            SkinInfo.PerformRead(s =>
+            foreach (SkinnableTarget skinnableTarget in Enum.GetValues(typeof(SkinnableTarget)))
             {
-                // we may want to move this to some kind of async operation in the future.
-                foreach (SkinnableTarget skinnableTarget in Enum.GetValues(typeof(SkinnableTarget)))
+                string filename = $"{skinnableTarget}.json";
+
+                byte[] bytes = skinStorage?.Get(filename);
+
+                if (bytes == null)
+                    continue;
+
+                try
                 {
-                    string filename = $"{skinnableTarget}.json";
+                    string jsonContent = Encoding.UTF8.GetString(bytes);
+                    var deserializedContent = JsonConvert.DeserializeObject<IEnumerable<SkinnableInfo>>(jsonContent);
 
-                    // skininfo files may be null for default skin.
-                    var fileInfo = s.Files.FirstOrDefault(f => f.Filename == filename);
-
-                    if (fileInfo == null)
+                    if (deserializedContent == null)
                         continue;
 
-                    byte[] bytes = resources?.Files.Get(fileInfo.File.GetStoragePath());
-
-                    if (bytes == null)
-                        continue;
-
-                    try
-                    {
-                        string jsonContent = Encoding.UTF8.GetString(bytes);
-                        var deserializedContent = JsonConvert.DeserializeObject<IEnumerable<SkinnableInfo>>(jsonContent);
-
-                        if (deserializedContent == null)
-                            continue;
-
-                        DrawableComponentInfo[skinnableTarget] = deserializedContent.ToArray();
-                    }
-                    catch (Exception ex)
-                    {
-                        Logger.Error(ex, "Failed to load skin configuration.");
-                    }
+                    DrawableComponentInfo[skinnableTarget] = deserializedContent.ToArray();
                 }
-            });
+                catch (Exception ex)
+                {
+                    Logger.Error(ex, "Failed to load skin configuration.");
+                }
+            }
         }
 
         protected virtual void ParseConfigurationStream(Stream stream)
@@ -101,16 +115,6 @@ namespace osu.Game.Skinning
                 Configuration = new LegacySkinDecoder().Decode(reader);
         }
 
-        private Stream getConfigurationStream()
-        {
-            string path = SkinInfo.PerformRead(s => s.Files.SingleOrDefault(f => f.Filename.Equals(@"skin.ini", StringComparison.OrdinalIgnoreCase))?.File.GetStoragePath());
-
-            if (string.IsNullOrEmpty(path))
-                return null;
-
-            return resources?.Files.GetStream(path);
-        }
-
         /// <summary>
         /// Remove all stored customisations for the provided target.
         /// </summary>
@@ -168,6 +172,9 @@ namespace osu.Game.Skinning
                 return;
 
             isDisposed = true;
+
+            Textures?.Dispose();
+            Samples?.Dispose();
         }
 
         #endregion

From b4d89b4e313863e6dec8ce85a4948ef4d9321b63 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 22 Mar 2022 18:42:45 +0900
Subject: [PATCH 3649/5547] Replace duplicate `LegacySkinResourceStore` class
 with `RealmBackedResourceStore`

---
 osu.Game/Skinning/LegacyBeatmapSkin.cs       |  2 +-
 osu.Game/Skinning/LegacySkinResourceStore.cs | 39 --------------------
 2 files changed, 1 insertion(+), 40 deletions(-)
 delete mode 100644 osu.Game/Skinning/LegacySkinResourceStore.cs

diff --git a/osu.Game/Skinning/LegacyBeatmapSkin.cs b/osu.Game/Skinning/LegacyBeatmapSkin.cs
index f80a980351..2ddf79ed5a 100644
--- a/osu.Game/Skinning/LegacyBeatmapSkin.cs
+++ b/osu.Game/Skinning/LegacyBeatmapSkin.cs
@@ -21,7 +21,7 @@ namespace osu.Game.Skinning
         protected override bool UseCustomSampleBanks => true;
 
         public LegacyBeatmapSkin(BeatmapInfo beatmapInfo, IResourceStore<byte[]> storage, IStorageResourceProvider resources)
-            : base(createSkinInfo(beatmapInfo), new LegacySkinResourceStore(beatmapInfo.BeatmapSet, storage), resources, beatmapInfo.Path)
+            : base(createSkinInfo(beatmapInfo), new RealmBackedResourceStore(beatmapInfo.BeatmapSet, storage), resources, beatmapInfo.Path)
         {
             // Disallow default colours fallback on beatmap skins to allow using parent skin combo colours. (via SkinProvidingContainer)
             Configuration.AllowDefaultComboColoursFallback = false;
diff --git a/osu.Game/Skinning/LegacySkinResourceStore.cs b/osu.Game/Skinning/LegacySkinResourceStore.cs
deleted file mode 100644
index 2487a469c8..0000000000
--- a/osu.Game/Skinning/LegacySkinResourceStore.cs
+++ /dev/null
@@ -1,39 +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.Extensions;
-using osu.Framework.IO.Stores;
-using osu.Game.Database;
-using osu.Game.Extensions;
-
-namespace osu.Game.Skinning
-{
-    public class LegacySkinResourceStore : ResourceStore<byte[]>
-    {
-        private readonly IHasNamedFiles source;
-
-        public LegacySkinResourceStore(IHasNamedFiles source, IResourceStore<byte[]> underlyingStore)
-            : base(underlyingStore)
-        {
-            this.source = source;
-        }
-
-        protected override IEnumerable<string> GetFilenames(string name)
-        {
-            foreach (string filename in base.GetFilenames(name))
-            {
-                string path = getPathForFile(filename.ToStandardisedPath());
-                if (path != null)
-                    yield return path;
-            }
-        }
-
-        private string getPathForFile(string filename) =>
-            source.Files.FirstOrDefault(f => string.Equals(f.Filename, filename, StringComparison.OrdinalIgnoreCase))?.File.GetStoragePath();
-
-        public override IEnumerable<string> GetAvailableResources() => source.Files.Select(f => f.Filename);
-    }
-}

From 35d2f973a39b533ed1cb7392d31d1d8299e9b0c9 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 22 Mar 2022 19:07:05 +0900
Subject: [PATCH 3650/5547] Prefer provided resource store over realm backed to
 keep tests working

---
 osu.Game/Skinning/LegacySkin.cs |  2 +-
 osu.Game/Skinning/Skin.cs       | 39 +++++++++++++++++++--------------
 2 files changed, 24 insertions(+), 17 deletions(-)

diff --git a/osu.Game/Skinning/LegacySkin.cs b/osu.Game/Skinning/LegacySkin.cs
index 5533615568..84844c4502 100644
--- a/osu.Game/Skinning/LegacySkin.cs
+++ b/osu.Game/Skinning/LegacySkin.cs
@@ -69,7 +69,7 @@ namespace osu.Game.Skinning
         /// <param name="resources">Access to raw game resources.</param>
         /// <param name="configurationStream">An optional stream containing the contents of a skin.ini file.</param>
         protected LegacySkin(SkinInfo skin, [CanBeNull] IResourceStore<byte[]> storage, [CanBeNull] IStorageResourceProvider resources, [CanBeNull] Stream configurationStream)
-            : base(skin, resources, configurationStream)
+            : base(skin, resources, storage, configurationStream)
         {
             // todo: this shouldn't really be duplicated here (from ManiaLegacySkinTransformer). we need to come up with a better solution.
             hasKeyTexture = new Lazy<bool>(() => this.GetAnimation(
diff --git a/osu.Game/Skinning/Skin.cs b/osu.Game/Skinning/Skin.cs
index d1ea7aa300..a47da70cd6 100644
--- a/osu.Game/Skinning/Skin.cs
+++ b/osu.Game/Skinning/Skin.cs
@@ -13,6 +13,7 @@ using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.OpenGL.Textures;
 using osu.Framework.Graphics.Textures;
+using osu.Framework.IO.Stores;
 using osu.Framework.Logging;
 using osu.Game.Audio;
 using osu.Game.Database;
@@ -51,30 +52,36 @@ namespace osu.Game.Skinning
 
         public abstract IBindable<TValue> GetConfig<TLookup, TValue>(TLookup lookup);
 
-        private readonly RealmBackedResourceStore skinStorage;
-
-        protected Skin(SkinInfo skin, IStorageResourceProvider resources, [CanBeNull] Stream configurationStream = null)
+        protected Skin(SkinInfo skin, [CanBeNull] IStorageResourceProvider resources, [CanBeNull] IResourceStore<byte[]> storage = null, [CanBeNull] Stream configurationStream = null)
         {
-            if (resources.RealmAccess != null)
+            if (resources != null)
             {
-                SkinInfo = skin.ToLive(resources.RealmAccess);
-                skinStorage = new RealmBackedResourceStore(skin, resources.Files);
+                if (resources.RealmAccess != null)
+                {
+                    SkinInfo = skin.ToLive(resources.RealmAccess);
 
-                var samples = resources?.AudioManager?.GetSampleStore(skinStorage);
+                    if (storage == null)
+                    {
+                        var realmStorage = new RealmBackedResourceStore(skin, resources.Files);
+                        realmStorage.AddExtension("ogg");
+
+                        storage = realmStorage;
+                    }
+                }
+                else
+                {
+                    SkinInfo = skin.ToLiveUnmanaged();
+                }
+
+                var samples = resources.AudioManager?.GetSampleStore(storage);
                 if (samples != null)
                     samples.PlaybackConcurrency = OsuGameBase.SAMPLE_CONCURRENCY;
 
                 Samples = samples;
-                Textures = new TextureStore(resources?.CreateTextureLoaderStore(skinStorage));
-
-                skinStorage.AddExtension("ogg");
-            }
-            else
-            {
-                SkinInfo = skin.ToLiveUnmanaged();
+                Textures = new TextureStore(resources.CreateTextureLoaderStore(storage));
             }
 
-            configurationStream ??= skinStorage?.GetStream(@"skin.ini");
+            configurationStream ??= storage?.GetStream(@"skin.ini");
 
             if (configurationStream != null)
                 // stream will be closed after use by LineBufferedReader.
@@ -87,7 +94,7 @@ namespace osu.Game.Skinning
             {
                 string filename = $"{skinnableTarget}.json";
 
-                byte[] bytes = skinStorage?.Get(filename);
+                byte[] bytes = storage?.Get(filename);
 
                 if (bytes == null)
                     continue;

From a7f63fb034d5174dc7e51e46fdfce88a06a4a89c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 22 Mar 2022 19:23:22 +0900
Subject: [PATCH 3651/5547] Make providing a custom `ResourceStore` to
 `LegacyBeatmapSkin` optional (for tests only)

---
 osu.Game.Tests/Skins/TestSceneBeatmapSkinLookupDisables.cs   | 2 +-
 osu.Game.Tests/Skins/TestSceneSkinConfigurationLookup.cs     | 2 +-
 .../Visual/Gameplay/TestSceneBeatmapSkinFallbacks.cs         | 2 +-
 osu.Game/Beatmaps/WorkingBeatmapCache.cs                     | 2 +-
 osu.Game/Skinning/LegacyBeatmapSkin.cs                       | 5 +++--
 osu.Game/Tests/Beatmaps/HitObjectSampleTest.cs               | 2 +-
 osu.Game/Tests/Beatmaps/LegacyBeatmapSkinColourTest.cs       | 2 +-
 7 files changed, 9 insertions(+), 8 deletions(-)

diff --git a/osu.Game.Tests/Skins/TestSceneBeatmapSkinLookupDisables.cs b/osu.Game.Tests/Skins/TestSceneBeatmapSkinLookupDisables.cs
index 71544e94f3..0c1981b35d 100644
--- a/osu.Game.Tests/Skins/TestSceneBeatmapSkinLookupDisables.cs
+++ b/osu.Game.Tests/Skins/TestSceneBeatmapSkinLookupDisables.cs
@@ -77,7 +77,7 @@ namespace osu.Game.Tests.Skins
         public class BeatmapSkinSource : LegacyBeatmapSkin
         {
             public BeatmapSkinSource()
-                : base(new TestBeatmap(new OsuRuleset().RulesetInfo).BeatmapInfo, null, null)
+                : base(new TestBeatmap(new OsuRuleset().RulesetInfo).BeatmapInfo, null)
             {
             }
 
diff --git a/osu.Game.Tests/Skins/TestSceneSkinConfigurationLookup.cs b/osu.Game.Tests/Skins/TestSceneSkinConfigurationLookup.cs
index 870d6d8f57..d3cacaa88c 100644
--- a/osu.Game.Tests/Skins/TestSceneSkinConfigurationLookup.cs
+++ b/osu.Game.Tests/Skins/TestSceneSkinConfigurationLookup.cs
@@ -202,7 +202,7 @@ namespace osu.Game.Tests.Skins
         public class BeatmapSkinSource : LegacyBeatmapSkin
         {
             public BeatmapSkinSource()
-                : base(new TestBeatmap(new OsuRuleset().RulesetInfo).BeatmapInfo, null, null)
+                : base(new TestBeatmap(new OsuRuleset().RulesetInfo).BeatmapInfo, null)
             {
             }
         }
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneBeatmapSkinFallbacks.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneBeatmapSkinFallbacks.cs
index eb1695b3df..53364b6d89 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneBeatmapSkinFallbacks.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneBeatmapSkinFallbacks.cs
@@ -50,7 +50,7 @@ namespace osu.Game.Tests.Visual.Gameplay
         [Test]
         public void TestEmptyLegacyBeatmapSkinFallsBack()
         {
-            CreateSkinTest(DefaultSkin.CreateInfo(), () => new LegacyBeatmapSkin(new BeatmapInfo(), null, null));
+            CreateSkinTest(DefaultSkin.CreateInfo(), () => new LegacyBeatmapSkin(new BeatmapInfo(), null));
             AddUntilStep("wait for hud load", () => Player.ChildrenOfType<SkinnableTargetContainer>().All(c => c.ComponentsLoaded));
             AddAssert("hud from default skin", () => AssertComponentsFromExpectedSource(SkinnableTarget.MainHUDComponents, skinManager.CurrentSkin.Value));
         }
diff --git a/osu.Game/Beatmaps/WorkingBeatmapCache.cs b/osu.Game/Beatmaps/WorkingBeatmapCache.cs
index d3f356bb24..7d28208157 100644
--- a/osu.Game/Beatmaps/WorkingBeatmapCache.cs
+++ b/osu.Game/Beatmaps/WorkingBeatmapCache.cs
@@ -225,7 +225,7 @@ namespace osu.Game.Beatmaps
             {
                 try
                 {
-                    return new LegacyBeatmapSkin(BeatmapInfo, resources.Files, resources);
+                    return new LegacyBeatmapSkin(BeatmapInfo, resources);
                 }
                 catch (Exception e)
                 {
diff --git a/osu.Game/Skinning/LegacyBeatmapSkin.cs b/osu.Game/Skinning/LegacyBeatmapSkin.cs
index 2ddf79ed5a..9b3548912c 100644
--- a/osu.Game/Skinning/LegacyBeatmapSkin.cs
+++ b/osu.Game/Skinning/LegacyBeatmapSkin.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 JetBrains.Annotations;
 using osu.Framework.Audio.Sample;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
@@ -20,8 +21,8 @@ namespace osu.Game.Skinning
         protected override bool AllowManiaSkin => false;
         protected override bool UseCustomSampleBanks => true;
 
-        public LegacyBeatmapSkin(BeatmapInfo beatmapInfo, IResourceStore<byte[]> storage, IStorageResourceProvider resources)
-            : base(createSkinInfo(beatmapInfo), new RealmBackedResourceStore(beatmapInfo.BeatmapSet, storage), resources, beatmapInfo.Path)
+        public LegacyBeatmapSkin(BeatmapInfo beatmapInfo, IStorageResourceProvider resources, [CanBeNull] IResourceStore<byte[]> storage = null)
+            : base(createSkinInfo(beatmapInfo), storage ?? new RealmBackedResourceStore(beatmapInfo.BeatmapSet, resources.Files), resources, beatmapInfo.Path)
         {
             // Disallow default colours fallback on beatmap skins to allow using parent skin combo colours. (via SkinProvidingContainer)
             Configuration.AllowDefaultComboColoursFallback = false;
diff --git a/osu.Game/Tests/Beatmaps/HitObjectSampleTest.cs b/osu.Game/Tests/Beatmaps/HitObjectSampleTest.cs
index 2a3e51b4f5..c13504c3de 100644
--- a/osu.Game/Tests/Beatmaps/HitObjectSampleTest.cs
+++ b/osu.Game/Tests/Beatmaps/HitObjectSampleTest.cs
@@ -206,7 +206,7 @@ namespace osu.Game.Tests.Beatmaps
                 this.resources = resources;
             }
 
-            protected internal override ISkin GetSkin() => new LegacyBeatmapSkin(skinBeatmapInfo, resourceStore, resources);
+            protected internal override ISkin GetSkin() => new LegacyBeatmapSkin(skinBeatmapInfo, resources, resourceStore);
         }
     }
 }
diff --git a/osu.Game/Tests/Beatmaps/LegacyBeatmapSkinColourTest.cs b/osu.Game/Tests/Beatmaps/LegacyBeatmapSkinColourTest.cs
index 5c522058d9..fee650ded0 100644
--- a/osu.Game/Tests/Beatmaps/LegacyBeatmapSkinColourTest.cs
+++ b/osu.Game/Tests/Beatmaps/LegacyBeatmapSkinColourTest.cs
@@ -112,7 +112,7 @@ namespace osu.Game.Tests.Beatmaps
             public static readonly Color4 HYPER_DASH_FRUIT_COLOUR = Color4.DarkGoldenrod;
 
             public TestBeatmapSkin(BeatmapInfo beatmapInfo, bool hasColours)
-                : base(beatmapInfo, new ResourceStore<byte[]>(), null)
+                : base(beatmapInfo, null, new ResourceStore<byte[]>())
             {
                 if (hasColours)
                 {

From e1236e07add705b02c145518169152e7c4e2fcd9 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 23 Mar 2022 13:36:33 +0900
Subject: [PATCH 3652/5547] Fix extensions not being specified in time for
 realm file caching

---
 osu.Game/Skinning/LegacyBeatmapSkin.cs        |  5 +++--
 osu.Game/Skinning/RealmBackedResourceStore.cs |  9 +++++++-
 osu.Game/Skinning/Skin.cs                     | 21 ++++++++-----------
 3 files changed, 20 insertions(+), 15 deletions(-)

diff --git a/osu.Game/Skinning/LegacyBeatmapSkin.cs b/osu.Game/Skinning/LegacyBeatmapSkin.cs
index 9b3548912c..d2428b0ccf 100644
--- a/osu.Game/Skinning/LegacyBeatmapSkin.cs
+++ b/osu.Game/Skinning/LegacyBeatmapSkin.cs
@@ -21,8 +21,9 @@ namespace osu.Game.Skinning
         protected override bool AllowManiaSkin => false;
         protected override bool UseCustomSampleBanks => true;
 
-        public LegacyBeatmapSkin(BeatmapInfo beatmapInfo, IStorageResourceProvider resources, [CanBeNull] IResourceStore<byte[]> storage = null)
-            : base(createSkinInfo(beatmapInfo), storage ?? new RealmBackedResourceStore(beatmapInfo.BeatmapSet, resources.Files), resources, beatmapInfo.Path)
+        public LegacyBeatmapSkin(BeatmapInfo beatmapInfo, [CanBeNull] IStorageResourceProvider resources, [CanBeNull] IResourceStore<byte[]> storage = null)
+            : base(createSkinInfo(beatmapInfo), storage ?? (resources != null ? new RealmBackedResourceStore(beatmapInfo.BeatmapSet, resources.Files, new[] { @"ogg" }) : null), resources,
+                beatmapInfo.Path)
         {
             // Disallow default colours fallback on beatmap skins to allow using parent skin combo colours. (via SkinProvidingContainer)
             Configuration.AllowDefaultComboColoursFallback = false;
diff --git a/osu.Game/Skinning/RealmBackedResourceStore.cs b/osu.Game/Skinning/RealmBackedResourceStore.cs
index 93ffbe4f44..fc9036727f 100644
--- a/osu.Game/Skinning/RealmBackedResourceStore.cs
+++ b/osu.Game/Skinning/RealmBackedResourceStore.cs
@@ -13,9 +13,16 @@ namespace osu.Game.Skinning
     {
         private readonly Dictionary<string, string> fileToStoragePathMapping = new Dictionary<string, string>();
 
-        public RealmBackedResourceStore(IHasRealmFiles source, IResourceStore<byte[]> underlyingStore)
+        public RealmBackedResourceStore(IHasRealmFiles source, IResourceStore<byte[]> underlyingStore, string[] extensions = null)
             : base(underlyingStore)
         {
+            // Must be initialised before the file cache.
+            if (extensions != null)
+            {
+                foreach (string extension in extensions)
+                    AddExtension(extension);
+            }
+
             initialiseFileCache(source);
         }
 
diff --git a/osu.Game/Skinning/Skin.cs b/osu.Game/Skinning/Skin.cs
index a47da70cd6..654c4e75f7 100644
--- a/osu.Game/Skinning/Skin.cs
+++ b/osu.Game/Skinning/Skin.cs
@@ -60,25 +60,22 @@ namespace osu.Game.Skinning
                 {
                     SkinInfo = skin.ToLive(resources.RealmAccess);
 
-                    if (storage == null)
-                    {
-                        var realmStorage = new RealmBackedResourceStore(skin, resources.Files);
-                        realmStorage.AddExtension("ogg");
-
-                        storage = realmStorage;
-                    }
+                    storage ??= new RealmBackedResourceStore(skin, resources.Files, new[] { @"ogg" });
                 }
                 else
                 {
                     SkinInfo = skin.ToLiveUnmanaged();
                 }
 
-                var samples = resources.AudioManager?.GetSampleStore(storage);
-                if (samples != null)
-                    samples.PlaybackConcurrency = OsuGameBase.SAMPLE_CONCURRENCY;
+                if (storage != null)
+                {
+                    var samples = resources.AudioManager?.GetSampleStore(storage);
+                    if (samples != null)
+                        samples.PlaybackConcurrency = OsuGameBase.SAMPLE_CONCURRENCY;
 
-                Samples = samples;
-                Textures = new TextureStore(resources.CreateTextureLoaderStore(storage));
+                    Samples = samples;
+                    Textures = new TextureStore(resources.CreateTextureLoaderStore(storage));
+                }
             }
 
             configurationStream ??= storage?.GetStream(@"skin.ini");

From 32e2cfb8ee710feabc140f1920c6b4e4c7150062 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 23 Mar 2022 13:38:32 +0900
Subject: [PATCH 3653/5547] Leave realm resource store construction to base
 class

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

diff --git a/osu.Game/Skinning/LegacySkin.cs b/osu.Game/Skinning/LegacySkin.cs
index 84844c4502..238cda1151 100644
--- a/osu.Game/Skinning/LegacySkin.cs
+++ b/osu.Game/Skinning/LegacySkin.cs
@@ -45,7 +45,7 @@ namespace osu.Game.Skinning
 
         [UsedImplicitly(ImplicitUseKindFlags.InstantiatedWithFixedConstructorSignature)]
         public LegacySkin(SkinInfo skin, IStorageResourceProvider resources)
-            : this(skin, new RealmBackedResourceStore(skin, resources.Files), resources, "skin.ini")
+            : this(skin, null, resources, "skin.ini")
         {
         }
 

From 3c38b142281e2bb90023be88b96ce0ac38a8b745 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 23 Mar 2022 13:14:56 +0900
Subject: [PATCH 3654/5547] Documentation improvements

---
 osu.Game/Skinning/LegacyBeatmapSkin.cs | 23 +++++++++++++++++++++--
 osu.Game/Skinning/LegacySkin.cs        |  5 +++--
 osu.Game/Skinning/Skin.cs              |  7 +++++++
 3 files changed, 31 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Skinning/LegacyBeatmapSkin.cs b/osu.Game/Skinning/LegacyBeatmapSkin.cs
index d2428b0ccf..7b8b659473 100644
--- a/osu.Game/Skinning/LegacyBeatmapSkin.cs
+++ b/osu.Game/Skinning/LegacyBeatmapSkin.cs
@@ -9,6 +9,7 @@ using osu.Framework.IO.Stores;
 using osu.Game.Audio;
 using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.Formats;
+using osu.Game.Database;
 using osu.Game.IO;
 using osu.Game.Rulesets.Objects.Legacy;
 using osu.Game.Rulesets.Objects.Types;
@@ -21,14 +22,28 @@ namespace osu.Game.Skinning
         protected override bool AllowManiaSkin => false;
         protected override bool UseCustomSampleBanks => true;
 
+        /// <summary>
+        /// Construct a new legacy beatmap skin instance.
+        /// </summary>
+        /// <param name="beatmapInfo">The model for this beatmap.</param>
+        /// <param name="resources">Access to raw game resources.</param>
+        /// <param name="storage">An optional store which will be used for looking up skin resources. If null, one will be created from realm <see cref="IHasRealmFiles"/> pattern.</param>
         public LegacyBeatmapSkin(BeatmapInfo beatmapInfo, [CanBeNull] IStorageResourceProvider resources, [CanBeNull] IResourceStore<byte[]> storage = null)
-            : base(createSkinInfo(beatmapInfo), storage ?? (resources != null ? new RealmBackedResourceStore(beatmapInfo.BeatmapSet, resources.Files, new[] { @"ogg" }) : null), resources,
+            : base(createSkinInfo(beatmapInfo), storage ?? createRealmBackedStore(beatmapInfo, resources), resources,
                 beatmapInfo.Path)
         {
             // Disallow default colours fallback on beatmap skins to allow using parent skin combo colours. (via SkinProvidingContainer)
             Configuration.AllowDefaultComboColoursFallback = false;
         }
 
+        private static IResourceStore<byte[]> createRealmBackedStore(BeatmapInfo beatmapInfo, [CanBeNull] IStorageResourceProvider resources)
+        {
+            if (resources == null)
+                return null;
+
+            return new RealmBackedResourceStore(beatmapInfo.BeatmapSet, resources.Files, new[] { @"ogg" });
+        }
+
         public override Drawable GetDrawableComponent(ISkinComponent component)
         {
             if (component is SkinnableTargetComponent targetComponent)
@@ -79,6 +94,10 @@ namespace osu.Game.Skinning
         }
 
         private static SkinInfo createSkinInfo(BeatmapInfo beatmapInfo) =>
-            new SkinInfo { Name = beatmapInfo.ToString(), Creator = beatmapInfo.Metadata.Author.Username ?? string.Empty };
+            new SkinInfo
+            {
+                Name = beatmapInfo.ToString(),
+                Creator = beatmapInfo.Metadata.Author.Username ?? string.Empty
+            };
     }
 }
diff --git a/osu.Game/Skinning/LegacySkin.cs b/osu.Game/Skinning/LegacySkin.cs
index 238cda1151..1559b9af53 100644
--- a/osu.Game/Skinning/LegacySkin.cs
+++ b/osu.Game/Skinning/LegacySkin.cs
@@ -15,6 +15,7 @@ using osu.Framework.Graphics.Textures;
 using osu.Framework.IO.Stores;
 using osu.Game.Audio;
 using osu.Game.Beatmaps.Formats;
+using osu.Game.Database;
 using osu.Game.IO;
 using osu.Game.Rulesets.Objects.Types;
 using osu.Game.Rulesets.Scoring;
@@ -53,7 +54,7 @@ namespace osu.Game.Skinning
         /// Construct a new legacy skin instance.
         /// </summary>
         /// <param name="skin">The model for this skin.</param>
-        /// <param name="storage">A storage for looking up files within this skin using user-facing filenames.</param>
+        /// <param name="storage">An optional store which will be used for looking up skin resources. If null, one will be created from realm <see cref="IHasRealmFiles"/> pattern.</param>
         /// <param name="resources">Access to raw game resources.</param>
         /// <param name="configurationFilename">The user-facing filename of the configuration file to be parsed. Can accept an .osu or skin.ini file.</param>
         protected LegacySkin(SkinInfo skin, [CanBeNull] IResourceStore<byte[]> storage, [CanBeNull] IStorageResourceProvider resources, string configurationFilename)
@@ -65,7 +66,7 @@ namespace osu.Game.Skinning
         /// Construct a new legacy skin instance.
         /// </summary>
         /// <param name="skin">The model for this skin.</param>
-        /// <param name="storage">A storage for looking up files within this skin using user-facing filenames.</param>
+        /// <param name="storage">An optional store which will be used for looking up skin resources. If null, one will be created from realm <see cref="IHasRealmFiles"/> pattern.</param>
         /// <param name="resources">Access to raw game resources.</param>
         /// <param name="configurationStream">An optional stream containing the contents of a skin.ini file.</param>
         protected LegacySkin(SkinInfo skin, [CanBeNull] IResourceStore<byte[]> storage, [CanBeNull] IStorageResourceProvider resources, [CanBeNull] Stream configurationStream)
diff --git a/osu.Game/Skinning/Skin.cs b/osu.Game/Skinning/Skin.cs
index 654c4e75f7..84041deb1a 100644
--- a/osu.Game/Skinning/Skin.cs
+++ b/osu.Game/Skinning/Skin.cs
@@ -52,6 +52,13 @@ namespace osu.Game.Skinning
 
         public abstract IBindable<TValue> GetConfig<TLookup, TValue>(TLookup lookup);
 
+        /// <summary>
+        /// Construct a new skin.
+        /// </summary>
+        /// <param name="skin">The skin's metadata. Usually a live realm object.</param>
+        /// <param name="resources">Access to game-wide resources.</param>
+        /// <param name="storage">An optional store which will be used for looking up skin resources. If null, one will be created from realm <see cref="IHasRealmFiles"/> pattern.</param>
+        /// <param name="configurationStream">An optional stream which will be used to read the skin configuration. If null, the configuration will be retrieved from the storage using "skin.ini".</param>
         protected Skin(SkinInfo skin, [CanBeNull] IStorageResourceProvider resources, [CanBeNull] IResourceStore<byte[]> storage = null, [CanBeNull] Stream configurationStream = null)
         {
             if (resources != null)

From 00aea9bef02f559210bef8ef898a07191c03f96e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 23 Mar 2022 13:46:19 +0900
Subject: [PATCH 3655/5547] Only use legacy resources lookup for protected (aka
 default) skin

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

diff --git a/osu.Game/Skinning/DefaultLegacySkin.cs b/osu.Game/Skinning/DefaultLegacySkin.cs
index 3a8464879a..7d7d2db7f3 100644
--- a/osu.Game/Skinning/DefaultLegacySkin.cs
+++ b/osu.Game/Skinning/DefaultLegacySkin.cs
@@ -30,7 +30,7 @@ namespace osu.Game.Skinning
         public DefaultLegacySkin(SkinInfo skin, IStorageResourceProvider resources)
             : base(
                 skin,
-                new NamespacedResourceStore<byte[]>(resources.Resources, "Skins/Legacy"),
+                skin.Protected ? new NamespacedResourceStore<byte[]>(resources.Resources, "Skins/Legacy") : null,
                 resources,
                 // A default legacy skin may still have a skin.ini if it is modified by the user.
                 // We must specify the stream directly as we are redirecting storage to the osu-resources location for other files.

From a5acd38fd5b68a9e137a1852aa3683b94a60bd12 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 23 Mar 2022 14:14:55 +0900
Subject: [PATCH 3656/5547] Fix `HitObjectSampleTest` adding null files to
 realm models

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

diff --git a/osu.Game/Tests/Beatmaps/HitObjectSampleTest.cs b/osu.Game/Tests/Beatmaps/HitObjectSampleTest.cs
index c13504c3de..630fbda688 100644
--- a/osu.Game/Tests/Beatmaps/HitObjectSampleTest.cs
+++ b/osu.Game/Tests/Beatmaps/HitObjectSampleTest.cs
@@ -96,12 +96,14 @@ namespace osu.Game.Tests.Beatmaps
             AddStep("setup skins", () =>
             {
                 userSkinInfo.Files.Clear();
-                userSkinInfo.Files.Add(new RealmNamedFileUsage(new RealmFile { Hash = userFile }, userFile));
+                if (!string.IsNullOrEmpty(userFile))
+                    userSkinInfo.Files.Add(new RealmNamedFileUsage(new RealmFile { Hash = userFile }, userFile));
 
                 Debug.Assert(beatmapInfo.BeatmapSet != null);
 
                 beatmapInfo.BeatmapSet.Files.Clear();
-                beatmapInfo.BeatmapSet.Files.Add(new RealmNamedFileUsage(new RealmFile { Hash = beatmapFile }, beatmapFile));
+                if (!string.IsNullOrEmpty(beatmapFile))
+                    beatmapInfo.BeatmapSet.Files.Add(new RealmNamedFileUsage(new RealmFile { Hash = beatmapFile }, beatmapFile));
 
                 // Need to refresh the cached skin source to refresh the skin resource store.
                 dependencies.SkinSource = new SkinProvidingContainer(Skin = new LegacySkin(userSkinInfo, this));

From e56d13d8be0ac9774aecf477cb43c24987295dd0 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 23 Mar 2022 14:21:35 +0900
Subject: [PATCH 3657/5547] Fix realm backed store not being initialised for
 some tests

---
 osu.Game/Skinning/Skin.cs | 26 +++++++++-----------------
 1 file changed, 9 insertions(+), 17 deletions(-)

diff --git a/osu.Game/Skinning/Skin.cs b/osu.Game/Skinning/Skin.cs
index 84041deb1a..4c2b58bbc2 100644
--- a/osu.Game/Skinning/Skin.cs
+++ b/osu.Game/Skinning/Skin.cs
@@ -63,26 +63,18 @@ namespace osu.Game.Skinning
         {
             if (resources != null)
             {
-                if (resources.RealmAccess != null)
-                {
-                    SkinInfo = skin.ToLive(resources.RealmAccess);
+                SkinInfo = resources.RealmAccess != null
+                    ? skin.ToLive(resources.RealmAccess)
+                    : skin.ToLiveUnmanaged();
 
-                    storage ??= new RealmBackedResourceStore(skin, resources.Files, new[] { @"ogg" });
-                }
-                else
-                {
-                    SkinInfo = skin.ToLiveUnmanaged();
-                }
+                storage ??= new RealmBackedResourceStore(skin, resources.Files, new[] { @"ogg" });
 
-                if (storage != null)
-                {
-                    var samples = resources.AudioManager?.GetSampleStore(storage);
-                    if (samples != null)
-                        samples.PlaybackConcurrency = OsuGameBase.SAMPLE_CONCURRENCY;
+                var samples = resources.AudioManager?.GetSampleStore(storage);
+                if (samples != null)
+                    samples.PlaybackConcurrency = OsuGameBase.SAMPLE_CONCURRENCY;
 
-                    Samples = samples;
-                    Textures = new TextureStore(resources.CreateTextureLoaderStore(storage));
-                }
+                Samples = samples;
+                Textures = new TextureStore(resources.CreateTextureLoaderStore(storage));
             }
 
             configurationStream ??= storage?.GetStream(@"skin.ini");

From b48aa1d8fa934eaedb0c03f65e630d3217c94826 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 23 Mar 2022 14:23:07 +0900
Subject: [PATCH 3658/5547] Ensure `HitObjectSampleTest`'s `TestWorkingBeatmap`
 provides the marking resource store correctly

---
 .../Tests/Beatmaps/HitObjectSampleTest.cs     | 20 ++++++++++++++-----
 1 file changed, 15 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Tests/Beatmaps/HitObjectSampleTest.cs b/osu.Game/Tests/Beatmaps/HitObjectSampleTest.cs
index 630fbda688..4667a385b3 100644
--- a/osu.Game/Tests/Beatmaps/HitObjectSampleTest.cs
+++ b/osu.Game/Tests/Beatmaps/HitObjectSampleTest.cs
@@ -193,22 +193,32 @@ namespace osu.Game.Tests.Beatmaps
             }
         }
 
-        private class TestWorkingBeatmap : ClockBackedTestWorkingBeatmap
+        private class TestWorkingBeatmap : ClockBackedTestWorkingBeatmap, IStorageResourceProvider
         {
             private readonly BeatmapInfo skinBeatmapInfo;
-            private readonly IResourceStore<byte[]> resourceStore;
 
             private readonly IStorageResourceProvider resources;
 
-            public TestWorkingBeatmap(BeatmapInfo skinBeatmapInfo, IResourceStore<byte[]> resourceStore, IBeatmap beatmap, Storyboard storyboard, IFrameBasedClock referenceClock, IStorageResourceProvider resources)
+            public TestWorkingBeatmap(BeatmapInfo skinBeatmapInfo, IResourceStore<byte[]> accessMarkingResourceStore, IBeatmap beatmap, Storyboard storyboard, IFrameBasedClock referenceClock,
+                                      IStorageResourceProvider resources)
                 : base(beatmap, storyboard, referenceClock, resources.AudioManager)
             {
                 this.skinBeatmapInfo = skinBeatmapInfo;
-                this.resourceStore = resourceStore;
+                Files = accessMarkingResourceStore;
                 this.resources = resources;
             }
 
-            protected internal override ISkin GetSkin() => new LegacyBeatmapSkin(skinBeatmapInfo, resources, resourceStore);
+            protected internal override ISkin GetSkin() => new LegacyBeatmapSkin(skinBeatmapInfo, this);
+
+            public AudioManager AudioManager => resources.AudioManager;
+
+            public IResourceStore<byte[]> Files { get; }
+
+            public IResourceStore<byte[]> Resources => resources.Resources;
+
+            public RealmAccess RealmAccess => resources.RealmAccess;
+
+            public IResourceStore<TextureUpload> CreateTextureLoaderStore(IResourceStore<byte[]> underlyingStore) => resources.CreateTextureLoaderStore(underlyingStore);
         }
     }
 }

From 6c405f1dee7242d5fc7dbdff300658d4693e3221 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 23 Mar 2022 14:31:24 +0900
Subject: [PATCH 3659/5547] Remove `storage` override from `LegacyBeatmapSkin`

---
 osu.Game/Skinning/LegacyBeatmapSkin.cs                 | 10 ++++------
 osu.Game/Tests/Beatmaps/LegacyBeatmapSkinColourTest.cs |  2 +-
 2 files changed, 5 insertions(+), 7 deletions(-)

diff --git a/osu.Game/Skinning/LegacyBeatmapSkin.cs b/osu.Game/Skinning/LegacyBeatmapSkin.cs
index 7b8b659473..6dc68b23d3 100644
--- a/osu.Game/Skinning/LegacyBeatmapSkin.cs
+++ b/osu.Game/Skinning/LegacyBeatmapSkin.cs
@@ -9,7 +9,6 @@ using osu.Framework.IO.Stores;
 using osu.Game.Audio;
 using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.Formats;
-using osu.Game.Database;
 using osu.Game.IO;
 using osu.Game.Rulesets.Objects.Legacy;
 using osu.Game.Rulesets.Objects.Types;
@@ -27,10 +26,8 @@ namespace osu.Game.Skinning
         /// </summary>
         /// <param name="beatmapInfo">The model for this beatmap.</param>
         /// <param name="resources">Access to raw game resources.</param>
-        /// <param name="storage">An optional store which will be used for looking up skin resources. If null, one will be created from realm <see cref="IHasRealmFiles"/> pattern.</param>
-        public LegacyBeatmapSkin(BeatmapInfo beatmapInfo, [CanBeNull] IStorageResourceProvider resources, [CanBeNull] IResourceStore<byte[]> storage = null)
-            : base(createSkinInfo(beatmapInfo), storage ?? createRealmBackedStore(beatmapInfo, resources), resources,
-                beatmapInfo.Path)
+        public LegacyBeatmapSkin(BeatmapInfo beatmapInfo, [CanBeNull] IStorageResourceProvider resources)
+            : base(createSkinInfo(beatmapInfo), createRealmBackedStore(beatmapInfo, resources), resources, beatmapInfo.Path)
         {
             // Disallow default colours fallback on beatmap skins to allow using parent skin combo colours. (via SkinProvidingContainer)
             Configuration.AllowDefaultComboColoursFallback = false;
@@ -39,7 +36,8 @@ namespace osu.Game.Skinning
         private static IResourceStore<byte[]> createRealmBackedStore(BeatmapInfo beatmapInfo, [CanBeNull] IStorageResourceProvider resources)
         {
             if (resources == null)
-                return null;
+                // should only ever be used in tests.
+                return new ResourceStore<byte[]>();
 
             return new RealmBackedResourceStore(beatmapInfo.BeatmapSet, resources.Files, new[] { @"ogg" });
         }
diff --git a/osu.Game/Tests/Beatmaps/LegacyBeatmapSkinColourTest.cs b/osu.Game/Tests/Beatmaps/LegacyBeatmapSkinColourTest.cs
index fee650ded0..b2b348d869 100644
--- a/osu.Game/Tests/Beatmaps/LegacyBeatmapSkinColourTest.cs
+++ b/osu.Game/Tests/Beatmaps/LegacyBeatmapSkinColourTest.cs
@@ -112,7 +112,7 @@ namespace osu.Game.Tests.Beatmaps
             public static readonly Color4 HYPER_DASH_FRUIT_COLOUR = Color4.DarkGoldenrod;
 
             public TestBeatmapSkin(BeatmapInfo beatmapInfo, bool hasColours)
-                : base(beatmapInfo, null, new ResourceStore<byte[]>())
+                : base(beatmapInfo, null)
             {
                 if (hasColours)
                 {

From 9d3c6ade6237c347bef8ad060ea755f2f2cf9d15 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 23 Mar 2022 14:38:40 +0900
Subject: [PATCH 3660/5547] Remove unnecessary skin reading hack in
 `DefaultLegacySkin`

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

diff --git a/osu.Game/Skinning/DefaultLegacySkin.cs b/osu.Game/Skinning/DefaultLegacySkin.cs
index 7d7d2db7f3..e7d0ed793f 100644
--- a/osu.Game/Skinning/DefaultLegacySkin.cs
+++ b/osu.Game/Skinning/DefaultLegacySkin.cs
@@ -30,11 +30,10 @@ namespace osu.Game.Skinning
         public DefaultLegacySkin(SkinInfo skin, IStorageResourceProvider resources)
             : base(
                 skin,
+                // In the case of the actual default legacy skin (ie. the fallback one, which a user hasn't applied any modifications to) we want to use the game provided resources.
                 skin.Protected ? new NamespacedResourceStore<byte[]>(resources.Resources, "Skins/Legacy") : null,
                 resources,
-                // A default legacy skin may still have a skin.ini if it is modified by the user.
-                // We must specify the stream directly as we are redirecting storage to the osu-resources location for other files.
-                new RealmBackedResourceStore(skin, resources.Files).GetStream("skin.ini")
+                "skin.ini"
             )
         {
             Configuration.CustomColours["SliderBall"] = new Color4(2, 170, 255, 255);

From d0ea1739b4767427c6ccd1b8de425a5fa4059be3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 23 Mar 2022 14:53:00 +0900
Subject: [PATCH 3661/5547] Remove skin configuration stream logic as it is no
 longer required

---
 osu.Game/Skinning/LegacySkin.cs | 14 +-------------
 osu.Game/Skinning/Skin.cs       |  6 +++---
 2 files changed, 4 insertions(+), 16 deletions(-)

diff --git a/osu.Game/Skinning/LegacySkin.cs b/osu.Game/Skinning/LegacySkin.cs
index 1559b9af53..6752851ca6 100644
--- a/osu.Game/Skinning/LegacySkin.cs
+++ b/osu.Game/Skinning/LegacySkin.cs
@@ -58,19 +58,7 @@ namespace osu.Game.Skinning
         /// <param name="resources">Access to raw game resources.</param>
         /// <param name="configurationFilename">The user-facing filename of the configuration file to be parsed. Can accept an .osu or skin.ini file.</param>
         protected LegacySkin(SkinInfo skin, [CanBeNull] IResourceStore<byte[]> storage, [CanBeNull] IStorageResourceProvider resources, string configurationFilename)
-            : this(skin, storage, resources, string.IsNullOrEmpty(configurationFilename) ? null : storage?.GetStream(configurationFilename))
-        {
-        }
-
-        /// <summary>
-        /// Construct a new legacy skin instance.
-        /// </summary>
-        /// <param name="skin">The model for this skin.</param>
-        /// <param name="storage">An optional store which will be used for looking up skin resources. If null, one will be created from realm <see cref="IHasRealmFiles"/> pattern.</param>
-        /// <param name="resources">Access to raw game resources.</param>
-        /// <param name="configurationStream">An optional stream containing the contents of a skin.ini file.</param>
-        protected LegacySkin(SkinInfo skin, [CanBeNull] IResourceStore<byte[]> storage, [CanBeNull] IStorageResourceProvider resources, [CanBeNull] Stream configurationStream)
-            : base(skin, resources, storage, configurationStream)
+            : base(skin, resources, storage, configurationFilename)
         {
             // todo: this shouldn't really be duplicated here (from ManiaLegacySkinTransformer). we need to come up with a better solution.
             hasKeyTexture = new Lazy<bool>(() => this.GetAnimation(
diff --git a/osu.Game/Skinning/Skin.cs b/osu.Game/Skinning/Skin.cs
index 4c2b58bbc2..72bbca4903 100644
--- a/osu.Game/Skinning/Skin.cs
+++ b/osu.Game/Skinning/Skin.cs
@@ -58,8 +58,8 @@ namespace osu.Game.Skinning
         /// <param name="skin">The skin's metadata. Usually a live realm object.</param>
         /// <param name="resources">Access to game-wide resources.</param>
         /// <param name="storage">An optional store which will be used for looking up skin resources. If null, one will be created from realm <see cref="IHasRealmFiles"/> pattern.</param>
-        /// <param name="configurationStream">An optional stream which will be used to read the skin configuration. If null, the configuration will be retrieved from the storage using "skin.ini".</param>
-        protected Skin(SkinInfo skin, [CanBeNull] IStorageResourceProvider resources, [CanBeNull] IResourceStore<byte[]> storage = null, [CanBeNull] Stream configurationStream = null)
+        /// <param name="configurationFilename">An optional filename to read the skin configuration from. If not provided, the configuration will be retrieved from the storage using "skin.ini".</param>
+        protected Skin(SkinInfo skin, [CanBeNull] IStorageResourceProvider resources, [CanBeNull] IResourceStore<byte[]> storage = null, [CanBeNull] string configurationFilename = "skin.ini")
         {
             if (resources != null)
             {
@@ -77,7 +77,7 @@ namespace osu.Game.Skinning
                 Textures = new TextureStore(resources.CreateTextureLoaderStore(storage));
             }
 
-            configurationStream ??= storage?.GetStream(@"skin.ini");
+            var configurationStream = storage?.GetStream(configurationFilename);
 
             if (configurationStream != null)
                 // stream will be closed after use by LineBufferedReader.

From 7a1909bf970acd9f5a2ebcce6387a644b0ec3002 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 23 Mar 2022 15:02:01 +0900
Subject: [PATCH 3662/5547] Change parameter order of `LegacySkin` to put
 `IStorageResourceProvider` first

The optional resource store should not be before the (basically)
required resource provider.
---
 .../CatchSkinColourDecodingTest.cs                          | 2 +-
 osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapEncoderTest.cs | 2 +-
 osu.Game.Tests/Gameplay/TestSceneStoryboardSamples.cs       | 2 +-
 osu.Game/Skinning/DefaultLegacySkin.cs                      | 2 +-
 osu.Game/Skinning/LegacyBeatmapSkin.cs                      | 2 +-
 osu.Game/Skinning/LegacySkin.cs                             | 6 +++---
 osu.Game/Tests/Beatmaps/LegacyBeatmapSkinColourTest.cs      | 2 +-
 osu.Game/Tests/Visual/SkinnableTestScene.cs                 | 2 +-
 8 files changed, 10 insertions(+), 10 deletions(-)

diff --git a/osu.Game.Rulesets.Catch.Tests/CatchSkinColourDecodingTest.cs b/osu.Game.Rulesets.Catch.Tests/CatchSkinColourDecodingTest.cs
index e70def7f8b..ea3c0f3f4a 100644
--- a/osu.Game.Rulesets.Catch.Tests/CatchSkinColourDecodingTest.cs
+++ b/osu.Game.Rulesets.Catch.Tests/CatchSkinColourDecodingTest.cs
@@ -30,7 +30,7 @@ namespace osu.Game.Rulesets.Catch.Tests
         {
             public TestLegacySkin(SkinInfo skin, IResourceStore<byte[]> storage)
                 // Bypass LegacySkinResourceStore to avoid returning null for retrieving files due to bad skin info (SkinInfo.Files = null).
-                : base(skin, storage, null, "skin.ini")
+                : base(skin, null, storage, "skin.ini")
             {
             }
         }
diff --git a/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapEncoderTest.cs b/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapEncoderTest.cs
index d19b3c71f1..0d436c1ef7 100644
--- a/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapEncoderTest.cs
+++ b/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapEncoderTest.cs
@@ -175,7 +175,7 @@ namespace osu.Game.Tests.Beatmaps.Formats
         private class TestLegacySkin : LegacySkin
         {
             public TestLegacySkin(IResourceStore<byte[]> storage, string fileName)
-                : base(new SkinInfo { Name = "Test Skin", Creator = "Craftplacer" }, storage, null, fileName)
+                : base(new SkinInfo { Name = "Test Skin", Creator = "Craftplacer" }, null, storage, fileName)
             {
             }
         }
diff --git a/osu.Game.Tests/Gameplay/TestSceneStoryboardSamples.cs b/osu.Game.Tests/Gameplay/TestSceneStoryboardSamples.cs
index 6457a23a1b..cfb158cc5a 100644
--- a/osu.Game.Tests/Gameplay/TestSceneStoryboardSamples.cs
+++ b/osu.Game.Tests/Gameplay/TestSceneStoryboardSamples.cs
@@ -148,7 +148,7 @@ namespace osu.Game.Tests.Gameplay
         private class TestSkin : LegacySkin
         {
             public TestSkin(string resourceName, IStorageResourceProvider resources)
-                : base(DefaultLegacySkin.CreateInfo(), new TestResourceStore(resourceName), resources, "skin.ini")
+                : base(DefaultLegacySkin.CreateInfo(), resources, new TestResourceStore(resourceName), "skin.ini")
             {
             }
         }
diff --git a/osu.Game/Skinning/DefaultLegacySkin.cs b/osu.Game/Skinning/DefaultLegacySkin.cs
index e7d0ed793f..be1b7b8f25 100644
--- a/osu.Game/Skinning/DefaultLegacySkin.cs
+++ b/osu.Game/Skinning/DefaultLegacySkin.cs
@@ -30,9 +30,9 @@ namespace osu.Game.Skinning
         public DefaultLegacySkin(SkinInfo skin, IStorageResourceProvider resources)
             : base(
                 skin,
+                resources,
                 // In the case of the actual default legacy skin (ie. the fallback one, which a user hasn't applied any modifications to) we want to use the game provided resources.
                 skin.Protected ? new NamespacedResourceStore<byte[]>(resources.Resources, "Skins/Legacy") : null,
-                resources,
                 "skin.ini"
             )
         {
diff --git a/osu.Game/Skinning/LegacyBeatmapSkin.cs b/osu.Game/Skinning/LegacyBeatmapSkin.cs
index 6dc68b23d3..e3685c986b 100644
--- a/osu.Game/Skinning/LegacyBeatmapSkin.cs
+++ b/osu.Game/Skinning/LegacyBeatmapSkin.cs
@@ -27,7 +27,7 @@ namespace osu.Game.Skinning
         /// <param name="beatmapInfo">The model for this beatmap.</param>
         /// <param name="resources">Access to raw game resources.</param>
         public LegacyBeatmapSkin(BeatmapInfo beatmapInfo, [CanBeNull] IStorageResourceProvider resources)
-            : base(createSkinInfo(beatmapInfo), createRealmBackedStore(beatmapInfo, resources), resources, beatmapInfo.Path)
+            : base(createSkinInfo(beatmapInfo), resources, createRealmBackedStore(beatmapInfo, resources), beatmapInfo.Path)
         {
             // Disallow default colours fallback on beatmap skins to allow using parent skin combo colours. (via SkinProvidingContainer)
             Configuration.AllowDefaultComboColoursFallback = false;
diff --git a/osu.Game/Skinning/LegacySkin.cs b/osu.Game/Skinning/LegacySkin.cs
index 6752851ca6..fa581f98e0 100644
--- a/osu.Game/Skinning/LegacySkin.cs
+++ b/osu.Game/Skinning/LegacySkin.cs
@@ -46,7 +46,7 @@ namespace osu.Game.Skinning
 
         [UsedImplicitly(ImplicitUseKindFlags.InstantiatedWithFixedConstructorSignature)]
         public LegacySkin(SkinInfo skin, IStorageResourceProvider resources)
-            : this(skin, null, resources, "skin.ini")
+            : this(skin, resources, null, "skin.ini")
         {
         }
 
@@ -54,10 +54,10 @@ namespace osu.Game.Skinning
         /// Construct a new legacy skin instance.
         /// </summary>
         /// <param name="skin">The model for this skin.</param>
-        /// <param name="storage">An optional store which will be used for looking up skin resources. If null, one will be created from realm <see cref="IHasRealmFiles"/> pattern.</param>
         /// <param name="resources">Access to raw game resources.</param>
+        /// <param name="storage">An optional store which will be used for looking up skin resources. If null, one will be created from realm <see cref="IHasRealmFiles"/> pattern.</param>
         /// <param name="configurationFilename">The user-facing filename of the configuration file to be parsed. Can accept an .osu or skin.ini file.</param>
-        protected LegacySkin(SkinInfo skin, [CanBeNull] IResourceStore<byte[]> storage, [CanBeNull] IStorageResourceProvider resources, string configurationFilename)
+        protected LegacySkin(SkinInfo skin, [CanBeNull] IStorageResourceProvider resources, [CanBeNull] IResourceStore<byte[]> storage, string configurationFilename)
             : base(skin, resources, storage, configurationFilename)
         {
             // todo: this shouldn't really be duplicated here (from ManiaLegacySkinTransformer). we need to come up with a better solution.
diff --git a/osu.Game/Tests/Beatmaps/LegacyBeatmapSkinColourTest.cs b/osu.Game/Tests/Beatmaps/LegacyBeatmapSkinColourTest.cs
index b2b348d869..531c38b655 100644
--- a/osu.Game/Tests/Beatmaps/LegacyBeatmapSkinColourTest.cs
+++ b/osu.Game/Tests/Beatmaps/LegacyBeatmapSkinColourTest.cs
@@ -141,7 +141,7 @@ namespace osu.Game.Tests.Beatmaps
             public static readonly Color4 HYPER_DASH_FRUIT_COLOUR = Color4.LightCyan;
 
             public TestSkin(bool hasCustomColours)
-                : base(new SkinInfo(), new ResourceStore<byte[]>(), null, string.Empty)
+                : base(new SkinInfo(), null, new ResourceStore<byte[]>(), string.Empty)
             {
                 if (hasCustomColours)
                 {
diff --git a/osu.Game/Tests/Visual/SkinnableTestScene.cs b/osu.Game/Tests/Visual/SkinnableTestScene.cs
index 1107089a46..c8fc988ffd 100644
--- a/osu.Game/Tests/Visual/SkinnableTestScene.cs
+++ b/osu.Game/Tests/Visual/SkinnableTestScene.cs
@@ -187,7 +187,7 @@ namespace osu.Game.Tests.Visual
             private readonly bool extrapolateAnimations;
 
             public TestLegacySkin(SkinInfo skin, IResourceStore<byte[]> storage, IStorageResourceProvider resources, bool extrapolateAnimations)
-                : base(skin, storage, resources, "skin.ini")
+                : base(skin, resources, storage, "skin.ini")
             {
                 this.extrapolateAnimations = extrapolateAnimations;
             }

From 078288a616319eed8e5a9a3d653a22d92ae3c88a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 23 Mar 2022 15:05:01 +0900
Subject: [PATCH 3663/5547] Make "skin.ini" the default skin filename and
 remove redundant parameters

---
 osu.Game.Rulesets.Catch.Tests/CatchSkinColourDecodingTest.cs | 2 +-
 osu.Game.Tests/Gameplay/TestSceneStoryboardSamples.cs        | 2 +-
 osu.Game/Skinning/DefaultLegacySkin.cs                       | 3 +--
 osu.Game/Skinning/LegacySkin.cs                              | 4 ++--
 osu.Game/Skinning/Skin.cs                                    | 2 +-
 osu.Game/Tests/Beatmaps/LegacyBeatmapSkinColourTest.cs       | 3 +--
 osu.Game/Tests/Visual/SkinnableTestScene.cs                  | 2 +-
 7 files changed, 8 insertions(+), 10 deletions(-)

diff --git a/osu.Game.Rulesets.Catch.Tests/CatchSkinColourDecodingTest.cs b/osu.Game.Rulesets.Catch.Tests/CatchSkinColourDecodingTest.cs
index ea3c0f3f4a..bb3a724b91 100644
--- a/osu.Game.Rulesets.Catch.Tests/CatchSkinColourDecodingTest.cs
+++ b/osu.Game.Rulesets.Catch.Tests/CatchSkinColourDecodingTest.cs
@@ -30,7 +30,7 @@ namespace osu.Game.Rulesets.Catch.Tests
         {
             public TestLegacySkin(SkinInfo skin, IResourceStore<byte[]> storage)
                 // Bypass LegacySkinResourceStore to avoid returning null for retrieving files due to bad skin info (SkinInfo.Files = null).
-                : base(skin, null, storage, "skin.ini")
+                : base(skin, null, storage)
             {
             }
         }
diff --git a/osu.Game.Tests/Gameplay/TestSceneStoryboardSamples.cs b/osu.Game.Tests/Gameplay/TestSceneStoryboardSamples.cs
index cfb158cc5a..76ec35d87d 100644
--- a/osu.Game.Tests/Gameplay/TestSceneStoryboardSamples.cs
+++ b/osu.Game.Tests/Gameplay/TestSceneStoryboardSamples.cs
@@ -148,7 +148,7 @@ namespace osu.Game.Tests.Gameplay
         private class TestSkin : LegacySkin
         {
             public TestSkin(string resourceName, IStorageResourceProvider resources)
-                : base(DefaultLegacySkin.CreateInfo(), resources, new TestResourceStore(resourceName), "skin.ini")
+                : base(DefaultLegacySkin.CreateInfo(), resources, new TestResourceStore(resourceName))
             {
             }
         }
diff --git a/osu.Game/Skinning/DefaultLegacySkin.cs b/osu.Game/Skinning/DefaultLegacySkin.cs
index be1b7b8f25..f7b415e886 100644
--- a/osu.Game/Skinning/DefaultLegacySkin.cs
+++ b/osu.Game/Skinning/DefaultLegacySkin.cs
@@ -32,8 +32,7 @@ namespace osu.Game.Skinning
                 skin,
                 resources,
                 // In the case of the actual default legacy skin (ie. the fallback one, which a user hasn't applied any modifications to) we want to use the game provided resources.
-                skin.Protected ? new NamespacedResourceStore<byte[]>(resources.Resources, "Skins/Legacy") : null,
-                "skin.ini"
+                skin.Protected ? new NamespacedResourceStore<byte[]>(resources.Resources, "Skins/Legacy") : null
             )
         {
             Configuration.CustomColours["SliderBall"] = new Color4(2, 170, 255, 255);
diff --git a/osu.Game/Skinning/LegacySkin.cs b/osu.Game/Skinning/LegacySkin.cs
index fa581f98e0..1c2ca797c6 100644
--- a/osu.Game/Skinning/LegacySkin.cs
+++ b/osu.Game/Skinning/LegacySkin.cs
@@ -46,7 +46,7 @@ namespace osu.Game.Skinning
 
         [UsedImplicitly(ImplicitUseKindFlags.InstantiatedWithFixedConstructorSignature)]
         public LegacySkin(SkinInfo skin, IStorageResourceProvider resources)
-            : this(skin, resources, null, "skin.ini")
+            : this(skin, resources, null)
         {
         }
 
@@ -57,7 +57,7 @@ namespace osu.Game.Skinning
         /// <param name="resources">Access to raw game resources.</param>
         /// <param name="storage">An optional store which will be used for looking up skin resources. If null, one will be created from realm <see cref="IHasRealmFiles"/> pattern.</param>
         /// <param name="configurationFilename">The user-facing filename of the configuration file to be parsed. Can accept an .osu or skin.ini file.</param>
-        protected LegacySkin(SkinInfo skin, [CanBeNull] IStorageResourceProvider resources, [CanBeNull] IResourceStore<byte[]> storage, string configurationFilename)
+        protected LegacySkin(SkinInfo skin, [CanBeNull] IStorageResourceProvider resources, [CanBeNull] IResourceStore<byte[]> storage, string configurationFilename = @"skin.ini")
             : base(skin, resources, storage, configurationFilename)
         {
             // todo: this shouldn't really be duplicated here (from ManiaLegacySkinTransformer). we need to come up with a better solution.
diff --git a/osu.Game/Skinning/Skin.cs b/osu.Game/Skinning/Skin.cs
index 72bbca4903..e28c35937d 100644
--- a/osu.Game/Skinning/Skin.cs
+++ b/osu.Game/Skinning/Skin.cs
@@ -59,7 +59,7 @@ namespace osu.Game.Skinning
         /// <param name="resources">Access to game-wide resources.</param>
         /// <param name="storage">An optional store which will be used for looking up skin resources. If null, one will be created from realm <see cref="IHasRealmFiles"/> pattern.</param>
         /// <param name="configurationFilename">An optional filename to read the skin configuration from. If not provided, the configuration will be retrieved from the storage using "skin.ini".</param>
-        protected Skin(SkinInfo skin, [CanBeNull] IStorageResourceProvider resources, [CanBeNull] IResourceStore<byte[]> storage = null, [CanBeNull] string configurationFilename = "skin.ini")
+        protected Skin(SkinInfo skin, [CanBeNull] IStorageResourceProvider resources, [CanBeNull] IResourceStore<byte[]> storage = null, [CanBeNull] string configurationFilename = @"skin.ini")
         {
             if (resources != null)
             {
diff --git a/osu.Game/Tests/Beatmaps/LegacyBeatmapSkinColourTest.cs b/osu.Game/Tests/Beatmaps/LegacyBeatmapSkinColourTest.cs
index 531c38b655..597c5e9a2b 100644
--- a/osu.Game/Tests/Beatmaps/LegacyBeatmapSkinColourTest.cs
+++ b/osu.Game/Tests/Beatmaps/LegacyBeatmapSkinColourTest.cs
@@ -7,7 +7,6 @@ using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
 using osu.Framework.Bindables;
-using osu.Framework.IO.Stores;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
 using osu.Game.Skinning;
@@ -141,7 +140,7 @@ namespace osu.Game.Tests.Beatmaps
             public static readonly Color4 HYPER_DASH_FRUIT_COLOUR = Color4.LightCyan;
 
             public TestSkin(bool hasCustomColours)
-                : base(new SkinInfo(), null, new ResourceStore<byte[]>(), string.Empty)
+                : base(new SkinInfo(), null, null)
             {
                 if (hasCustomColours)
                 {
diff --git a/osu.Game/Tests/Visual/SkinnableTestScene.cs b/osu.Game/Tests/Visual/SkinnableTestScene.cs
index c8fc988ffd..b4da91a97a 100644
--- a/osu.Game/Tests/Visual/SkinnableTestScene.cs
+++ b/osu.Game/Tests/Visual/SkinnableTestScene.cs
@@ -187,7 +187,7 @@ namespace osu.Game.Tests.Visual
             private readonly bool extrapolateAnimations;
 
             public TestLegacySkin(SkinInfo skin, IResourceStore<byte[]> storage, IStorageResourceProvider resources, bool extrapolateAnimations)
-                : base(skin, resources, storage, "skin.ini")
+                : base(skin, resources, storage)
             {
                 this.extrapolateAnimations = extrapolateAnimations;
             }

From f7c004720648ae8e296f3c1d2b2f49612a29f285 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 23 Mar 2022 15:19:43 +0900
Subject: [PATCH 3664/5547] Send time remaining in countdowns instead

---
 .../Multiplayer/MultiplayerCountdown.cs       |  8 +++++--
 .../Multiplayer/Match/ReadyButton.cs          | 23 +++++++++++++++----
 .../Multiplayer/TestMultiplayerClient.cs      |  2 +-
 3 files changed, 26 insertions(+), 7 deletions(-)

diff --git a/osu.Game/Online/Multiplayer/MultiplayerCountdown.cs b/osu.Game/Online/Multiplayer/MultiplayerCountdown.cs
index 63bb47b295..81190e64c9 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerCountdown.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerCountdown.cs
@@ -5,6 +5,7 @@
 
 using System;
 using MessagePack;
+using osu.Game.Online.Multiplayer.Countdown;
 
 namespace osu.Game.Online.Multiplayer
 {
@@ -16,9 +17,12 @@ namespace osu.Game.Online.Multiplayer
     public abstract class MultiplayerCountdown
     {
         /// <summary>
-        /// The time at which the countdown will end.
+        /// The amount of time remaining in the countdown.
         /// </summary>
+        /// <remarks>
+        /// This is only sent once from the server upon initial retrieval of the <see cref="MultiplayerRoom"/> or via a <see cref="CountdownChangedEvent"/>.
+        /// </remarks>
         [Key(0)]
-        public DateTimeOffset EndTime { get; set; }
+        public TimeSpan TimeRemaining { get; set; }
     }
 }
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/ReadyButton.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/ReadyButton.cs
index b37d990466..007e055d8c 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/ReadyButton.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/ReadyButton.cs
@@ -34,12 +34,16 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
             onRoomUpdated();
         }
 
+        private MultiplayerCountdown countdown;
+        private DateTimeOffset countdownReceivedTime;
         private ScheduledDelegate countdownUpdateDelegate;
 
         private void onRoomUpdated()
         {
-            updateButtonText();
-            updateButtonColour();
+            if (countdown == null && room?.Countdown != null)
+                countdownReceivedTime = DateTimeOffset.Now;
+
+            countdown = room?.Countdown;
 
             if (room?.Countdown != null)
                 countdownUpdateDelegate ??= Scheduler.AddDelayed(updateButtonText, 1000, true);
@@ -48,6 +52,9 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
                 countdownUpdateDelegate?.Cancel();
                 countdownUpdateDelegate = null;
             }
+
+            updateButtonText();
+            updateButtonColour();
         }
 
         private void updateButtonText()
@@ -64,9 +71,17 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
             int countTotal = room.Users.Count(u => u.State != MultiplayerUserState.Spectating);
             string countText = $"({countReady} / {countTotal} ready)";
 
-            if (room.Countdown != null)
+            if (countdown != null)
             {
-                string countdownText = $"Starting in {room.Countdown.EndTime - DateTimeOffset.Now:mm\\:ss}";
+                TimeSpan timeElapsed = DateTimeOffset.Now - countdownReceivedTime;
+                TimeSpan countdownRemaining;
+
+                if (timeElapsed > countdown.TimeRemaining)
+                    countdownRemaining = TimeSpan.Zero;
+                else
+                    countdownRemaining = countdown.TimeRemaining - timeElapsed;
+
+                string countdownText = $"Starting in {countdownRemaining:mm\\:ss}";
 
                 switch (localUser?.State)
                 {
diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
index 2b03017905..938147e05e 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
@@ -315,7 +315,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     var stopSource = countdownStopSource = new CancellationTokenSource();
                     var finishSource = countdownFinishSource = new CancellationTokenSource();
                     var cancellationSource = CancellationTokenSource.CreateLinkedTokenSource(stopSource.Token, finishSource.Token);
-                    var countdown = new MatchStartCountdown { EndTime = DateTimeOffset.Now + matchCountdownRequest.Delay };
+                    var countdown = new MatchStartCountdown { TimeRemaining = matchCountdownRequest.Delay };
 
                     Task lastCountdownTask = countdownTask;
                     countdownTask = start();

From a83a90e675f39a1646b8091c6da4c7eaeefe1d9d Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 23 Mar 2022 15:21:16 +0900
Subject: [PATCH 3665/5547] Rename countdown Delay -> Duration

---
 .../Visual/Multiplayer/TestSceneMatchStartControl.cs          | 4 ++--
 .../Multiplayer/Countdown/StartMatchCountdownRequest.cs       | 2 +-
 .../Screens/OnlinePlay/Multiplayer/Match/MatchStartControl.cs | 2 +-
 osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs    | 4 ++--
 4 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.cs
index b98676e737..7ef9505d8c 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.cs
@@ -117,7 +117,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 MultiplayerClient.TransferHost(2);
             });
 
-            AddStep("start with countdown", () => MultiplayerClient.SendMatchRequest(new StartMatchCountdownRequest { Delay = TimeSpan.FromMinutes(2) }).WaitSafely());
+            AddStep("start with countdown", () => MultiplayerClient.SendMatchRequest(new StartMatchCountdownRequest { Duration = TimeSpan.FromMinutes(2) }).WaitSafely());
 
             ClickButtonWhenEnabled<ReadyButton>();
             AddUntilStep("user is ready", () => MultiplayerClient.Room?.Users[0].State == MultiplayerUserState.Ready);
@@ -193,7 +193,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 MultiplayerClient.TransferHost(2);
             });
 
-            AddStep("start countdown", () => MultiplayerClient.SendMatchRequest(new StartMatchCountdownRequest { Delay = TimeSpan.FromMinutes(1) }).WaitSafely());
+            AddStep("start countdown", () => MultiplayerClient.SendMatchRequest(new StartMatchCountdownRequest { Duration = TimeSpan.FromMinutes(1) }).WaitSafely());
             AddUntilStep("countdown started", () => MultiplayerClient.Room?.Countdown != null);
 
             AddStep("transfer host to local user", () => MultiplayerClient.TransferHost(API.LocalUser.Value.OnlineID));
diff --git a/osu.Game/Online/Multiplayer/Countdown/StartMatchCountdownRequest.cs b/osu.Game/Online/Multiplayer/Countdown/StartMatchCountdownRequest.cs
index 9e6967af9d..08eab26090 100644
--- a/osu.Game/Online/Multiplayer/Countdown/StartMatchCountdownRequest.cs
+++ b/osu.Game/Online/Multiplayer/Countdown/StartMatchCountdownRequest.cs
@@ -18,6 +18,6 @@ namespace osu.Game.Online.Multiplayer.Countdown
         /// How long the countdown should last.
         /// </summary>
         [Key(0)]
-        public TimeSpan Delay { get; set; }
+        public TimeSpan Duration { get; set; }
     }
 }
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MatchStartControl.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MatchStartControl.cs
index d97ac601d5..9470fb1d68 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MatchStartControl.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MatchStartControl.cs
@@ -150,7 +150,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
             Debug.Assert(clickOperation == null);
             clickOperation = ongoingOperationTracker.BeginOperation();
 
-            Client.SendMatchRequest(new StartMatchCountdownRequest { Delay = duration }).ContinueWith(_ => endOperation());
+            Client.SendMatchRequest(new StartMatchCountdownRequest { Duration = duration }).ContinueWith(_ => endOperation());
         }
 
         private void endOperation()
diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
index 938147e05e..1f20292437 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
@@ -315,7 +315,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     var stopSource = countdownStopSource = new CancellationTokenSource();
                     var finishSource = countdownFinishSource = new CancellationTokenSource();
                     var cancellationSource = CancellationTokenSource.CreateLinkedTokenSource(stopSource.Token, finishSource.Token);
-                    var countdown = new MatchStartCountdown { TimeRemaining = matchCountdownRequest.Delay };
+                    var countdown = new MatchStartCountdown { TimeRemaining = matchCountdownRequest.Duration };
 
                     Task lastCountdownTask = countdownTask;
                     countdownTask = start();
@@ -335,7 +335,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
                         try
                         {
-                            await Task.Delay(matchCountdownRequest.Delay, cancellationSource.Token).ConfigureAwait(false);
+                            await Task.Delay(matchCountdownRequest.Duration, cancellationSource.Token).ConfigureAwait(false);
                         }
                         catch (OperationCanceledException)
                         {

From 2ea9e5245c381061e20d7b64ec86ef0795778287 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 23 Mar 2022 20:15:13 +0900
Subject: [PATCH 3666/5547] Revert "Remove `IsLayered` from `GetHasCode`
 implementation"

This reverts commit 16ee6b5fc7700b2a46359fb6b814e9c56eafaa53.
---
 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 8dc037c7c8..47fe9032f0 100644
--- a/osu.Game/Rulesets/Objects/Legacy/ConvertHitObjectParser.cs
+++ b/osu.Game/Rulesets/Objects/Legacy/ConvertHitObjectParser.cs
@@ -505,7 +505,7 @@ namespace osu.Game.Rulesets.Objects.Legacy
             public override bool Equals(object? obj)
                 => obj is LegacyHitSampleInfo other && Equals(other);
 
-            public override int GetHashCode() => HashCode.Combine(base.GetHashCode(), CustomSampleBank);
+            public override int GetHashCode() => HashCode.Combine(base.GetHashCode(), CustomSampleBank, IsLayered);
         }
 
         private class FileHitSampleInfo : LegacyHitSampleInfo, IEquatable<FileHitSampleInfo>

From 997c091a8de3a3aaaa99a2cf2194da2117f5af3b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 23 Mar 2022 20:15:17 +0900
Subject: [PATCH 3667/5547] Revert "Remove `IsLayered` from
 `LegacyHitSampleInfo` comparison"

This reverts commit 45233932089ea26d9e329c47f1893137d2d4bcaf.
---
 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 47fe9032f0..b091803406 100644
--- a/osu.Game/Rulesets/Objects/Legacy/ConvertHitObjectParser.cs
+++ b/osu.Game/Rulesets/Objects/Legacy/ConvertHitObjectParser.cs
@@ -500,7 +500,7 @@ namespace osu.Game.Rulesets.Objects.Legacy
                 => new LegacyHitSampleInfo(newName.GetOr(Name), newBank.GetOr(Bank), newVolume.GetOr(Volume), newCustomSampleBank.GetOr(CustomSampleBank), newIsLayered.GetOr(IsLayered));
 
             public bool Equals(LegacyHitSampleInfo? other)
-                => base.Equals(other) && CustomSampleBank == other.CustomSampleBank;
+                => base.Equals(other) && CustomSampleBank == other.CustomSampleBank && IsLayered == other.IsLayered;
 
             public override bool Equals(object? obj)
                 => obj is LegacyHitSampleInfo other && Equals(other);

From c079a9cd3232223379c793f284b63432bbe8eb93 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 23 Mar 2022 20:18:44 +0900
Subject: [PATCH 3668/5547] Add comment regarding equality check importance in
 `LegacyHitSampleInfo`

---
 osu.Game/Rulesets/Objects/Legacy/ConvertHitObjectParser.cs | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/osu.Game/Rulesets/Objects/Legacy/ConvertHitObjectParser.cs b/osu.Game/Rulesets/Objects/Legacy/ConvertHitObjectParser.cs
index b091803406..2a7f2b037f 100644
--- a/osu.Game/Rulesets/Objects/Legacy/ConvertHitObjectParser.cs
+++ b/osu.Game/Rulesets/Objects/Legacy/ConvertHitObjectParser.cs
@@ -500,6 +500,9 @@ namespace osu.Game.Rulesets.Objects.Legacy
                 => new LegacyHitSampleInfo(newName.GetOr(Name), newBank.GetOr(Bank), newVolume.GetOr(Volume), newCustomSampleBank.GetOr(CustomSampleBank), newIsLayered.GetOr(IsLayered));
 
             public bool Equals(LegacyHitSampleInfo? other)
+                // The additions to equality checks here are *required* to ensure that pooling works correctly.
+                // Of note, `IsLayered` may cause the usage of `SampleVirtual` instead of an actual sample (in cases playback is not required).
+                // Removing it would cause samples which may actually require playback to potentially source for a `SampleVirtual` sample pool.
                 => base.Equals(other) && CustomSampleBank == other.CustomSampleBank && IsLayered == other.IsLayered;
 
             public override bool Equals(object? obj)

From b218046fa28ef9ebb257663adf5388d9174345ee Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 23 Mar 2022 15:38:48 +0300
Subject: [PATCH 3669/5547] Remove redundant line from mod usage

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

diff --git a/osu.Game/Rulesets/Mods/ModUsage.cs b/osu.Game/Rulesets/Mods/ModUsage.cs
index 59a62bfc6f..746387a062 100644
--- a/osu.Game/Rulesets/Mods/ModUsage.cs
+++ b/osu.Game/Rulesets/Mods/ModUsage.cs
@@ -10,7 +10,6 @@ namespace osu.Game.Rulesets.Mods
     {
         /// <summary>
         /// Used for a per-user gameplay session.
-        /// Determines whether the mod is playable by an end user.
         /// </summary>
         User,
 

From 6cd67928aba27e2936fd8f0a6cfc0ae7838e1e67 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 23 Mar 2022 15:48:50 +0300
Subject: [PATCH 3670/5547] Simplify documentation of `ModUsage`

---
 osu.Game/Rulesets/Mods/ModUsage.cs | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Rulesets/Mods/ModUsage.cs b/osu.Game/Rulesets/Mods/ModUsage.cs
index 746387a062..04d99149dd 100644
--- a/osu.Game/Rulesets/Mods/ModUsage.cs
+++ b/osu.Game/Rulesets/Mods/ModUsage.cs
@@ -4,23 +4,23 @@
 namespace osu.Game.Rulesets.Mods
 {
     /// <summary>
-    /// The usage of this mod to determine whether it's playable in such context.
+    /// The context in which a <see cref="Mod"/> is playable.
     /// </summary>
     public enum ModUsage
     {
         /// <summary>
-        /// Used for a per-user gameplay session.
+        /// This mod can be used for a per-user gameplay session.
         /// </summary>
         User,
 
         /// <summary>
-        /// Used in multiplayer but must be applied to all users.
+        /// This mod can be used in multiplayer but must be applied to all users.
         /// This is generally the case for mods which affect the length of gameplay.
         /// </summary>
         MultiplayerRoomWide,
 
         /// <summary>
-        /// Used in multiplayer either at a room or per-player level (i.e. "free mod").
+        /// This mod can be used in multiplayer either at a room or per-player level (i.e. "free mod").
         /// </summary>
         MultiplayerPerPlayer,
     }

From 05c7e09d79fa1f667c8bdfe7472eaa3a7677fa2f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 23 Mar 2022 23:57:14 +0900
Subject: [PATCH 3671/5547] Make `Textures` and `Samples` read-only

---
 .../Skinning/LegacySkinTextureFallbackTest.cs | 54 +++++++++++++++----
 osu.Game/Skinning/Skin.cs                     |  4 +-
 2 files changed, 47 insertions(+), 11 deletions(-)

diff --git a/osu.Game.Tests/NonVisual/Skinning/LegacySkinTextureFallbackTest.cs b/osu.Game.Tests/NonVisual/Skinning/LegacySkinTextureFallbackTest.cs
index 69e66942ab..7516e7500b 100644
--- a/osu.Game.Tests/NonVisual/Skinning/LegacySkinTextureFallbackTest.cs
+++ b/osu.Game.Tests/NonVisual/Skinning/LegacySkinTextureFallbackTest.cs
@@ -1,12 +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.IO;
 using System.Linq;
+using System.Threading;
+using System.Threading.Tasks;
 using NUnit.Framework;
-using osu.Framework.Graphics.OpenGL.Textures;
+using osu.Framework.Audio;
 using osu.Framework.Graphics.Textures;
+using osu.Framework.IO.Stores;
+using osu.Game.Database;
+using osu.Game.IO;
 using osu.Game.Skinning;
+using SixLabors.ImageSharp;
+using SixLabors.ImageSharp.PixelFormats;
 
 namespace osu.Game.Tests.NonVisual.Skinning
 {
@@ -71,7 +80,7 @@ namespace osu.Game.Tests.NonVisual.Skinning
             var texture = legacySkin.GetTexture(requestedComponent);
 
             Assert.IsNotNull(texture);
-            Assert.AreEqual(textureStore.Textures[expectedTexture], texture);
+            Assert.AreEqual(textureStore.Textures[expectedTexture].Width, texture.Width);
             Assert.AreEqual(expectedScale, texture.ScaleAdjust);
         }
 
@@ -88,23 +97,50 @@ namespace osu.Game.Tests.NonVisual.Skinning
 
         private class TestLegacySkin : LegacySkin
         {
-            public TestLegacySkin(TextureStore textureStore)
-                : base(new SkinInfo(), null, null, string.Empty)
+            public TestLegacySkin(IResourceStore<TextureUpload> textureStore)
+                : base(new SkinInfo(), new TestResourceProvider(textureStore), null, string.Empty)
             {
-                Textures = textureStore;
+            }
+
+            private class TestResourceProvider : IStorageResourceProvider
+            {
+                private readonly IResourceStore<TextureUpload> textureStore;
+
+                public TestResourceProvider(IResourceStore<TextureUpload> textureStore)
+                {
+                    this.textureStore = textureStore;
+                }
+
+                public AudioManager AudioManager => null;
+                public IResourceStore<byte[]> Files => null;
+                public IResourceStore<byte[]> Resources => null;
+                public RealmAccess RealmAccess => null;
+                public IResourceStore<TextureUpload> CreateTextureLoaderStore(IResourceStore<byte[]> underlyingStore) => textureStore;
             }
         }
 
-        private class TestTextureStore : TextureStore
+        private class TestTextureStore : IResourceStore<TextureUpload>
         {
-            public readonly Dictionary<string, Texture> Textures;
+            public readonly Dictionary<string, TextureUpload> Textures;
 
             public TestTextureStore(params string[] fileNames)
             {
-                Textures = fileNames.ToDictionary(fileName => fileName, fileName => new Texture(1, 1));
+                // use an incrementing width to allow assertion matching on correct textures as they turn from uploads into actual textures.
+                int width = 1;
+                Textures = fileNames.ToDictionary(fileName => fileName, fileName => new TextureUpload(new Image<Rgba32>(width, width++)));
             }
 
-            public override Texture Get(string name, WrapMode wrapModeS, WrapMode wrapModeT) => Textures.GetValueOrDefault(name);
+            public TextureUpload Get(string name) => Textures.GetValueOrDefault(name);
+
+            public Task<TextureUpload> GetAsync(string name, CancellationToken cancellationToken = new CancellationToken()) => Task.FromResult(Get(name));
+
+            public Stream GetStream(string name) => throw new NotImplementedException();
+
+            public IEnumerable<string> GetAvailableResources() => throw new NotImplementedException();
+
+            public void Dispose()
+            {
+            }
         }
     }
 }
diff --git a/osu.Game/Skinning/Skin.cs b/osu.Game/Skinning/Skin.cs
index e28c35937d..b6f46a0d81 100644
--- a/osu.Game/Skinning/Skin.cs
+++ b/osu.Game/Skinning/Skin.cs
@@ -28,13 +28,13 @@ namespace osu.Game.Skinning
         /// A texture store which can be used to perform user file loops for this skin.
         /// </summary>
         [CanBeNull]
-        protected TextureStore Textures { get; set; }
+        protected TextureStore Textures { get; }
 
         /// <summary>
         /// A sample store which can be used to perform user file loops for this skin.
         /// </summary>
         [CanBeNull]
-        protected ISampleStore Samples { get; set; }
+        protected ISampleStore Samples { get; }
 
         public readonly Live<SkinInfo> SkinInfo;
 

From 3e020073c50d325f9c19ded1515d0653e19f5fb6 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 24 Mar 2022 00:08:01 +0900
Subject: [PATCH 3672/5547] Convert `Skin` to use `nullable`

---
 osu.Game/Skinning/ISkin.cs | 18 +++++++-----------
 osu.Game/Skinning/Skin.cs  | 36 +++++++++++++++++++++---------------
 2 files changed, 28 insertions(+), 26 deletions(-)

diff --git a/osu.Game/Skinning/ISkin.cs b/osu.Game/Skinning/ISkin.cs
index 73f7cf6d39..4b14dcfd62 100644
--- a/osu.Game/Skinning/ISkin.cs
+++ b/osu.Game/Skinning/ISkin.cs
@@ -1,7 +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 JetBrains.Annotations;
+#nullable enable
+
 using osu.Framework.Audio.Sample;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
@@ -21,16 +22,14 @@ namespace osu.Game.Skinning
         /// </summary>
         /// <param name="component">The requested component.</param>
         /// <returns>A drawable representation for the requested component, or null if unavailable.</returns>
-        [CanBeNull]
-        Drawable GetDrawableComponent(ISkinComponent component);
+        Drawable? GetDrawableComponent(ISkinComponent component);
 
         /// <summary>
         /// Retrieve a <see cref="Texture"/>.
         /// </summary>
         /// <param name="componentName">The requested texture.</param>
         /// <returns>A matching texture, or null if unavailable.</returns>
-        [CanBeNull]
-        Texture GetTexture(string componentName) => GetTexture(componentName, default, default);
+        Texture? GetTexture(string componentName) => GetTexture(componentName, default, default);
 
         /// <summary>
         /// Retrieve a <see cref="Texture"/>.
@@ -39,23 +38,20 @@ namespace osu.Game.Skinning
         /// <param name="wrapModeS">The texture wrap mode in horizontal direction.</param>
         /// <param name="wrapModeT">The texture wrap mode in vertical direction.</param>
         /// <returns>A matching texture, or null if unavailable.</returns>
-        [CanBeNull]
-        Texture GetTexture(string componentName, WrapMode wrapModeS, WrapMode wrapModeT);
+        Texture? GetTexture(string componentName, WrapMode wrapModeS, WrapMode wrapModeT);
 
         /// <summary>
         /// Retrieve a <see cref="SampleChannel"/>.
         /// </summary>
         /// <param name="sampleInfo">The requested sample.</param>
         /// <returns>A matching sample channel, or null if unavailable.</returns>
-        [CanBeNull]
-        ISample GetSample(ISampleInfo sampleInfo);
+        ISample? GetSample(ISampleInfo sampleInfo);
 
         /// <summary>
         /// Retrieve a configuration value.
         /// </summary>
         /// <param name="lookup">The requested configuration value.</param>
         /// <returns>A matching value boxed in an <see cref="IBindable{TValue}"/>, or null if unavailable.</returns>
-        [CanBeNull]
-        IBindable<TValue> GetConfig<TLookup, TValue>(TLookup lookup);
+        IBindable<TValue>? GetConfig<TLookup, TValue>(TLookup lookup);
     }
 }
diff --git a/osu.Game/Skinning/Skin.cs b/osu.Game/Skinning/Skin.cs
index b6f46a0d81..643e0c38d4 100644
--- a/osu.Game/Skinning/Skin.cs
+++ b/osu.Game/Skinning/Skin.cs
@@ -1,12 +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.
 
+#nullable enable
+
 using System;
 using System.Collections.Generic;
+using System.Diagnostics;
 using System.IO;
 using System.Linq;
 using System.Text;
-using JetBrains.Annotations;
 using Newtonsoft.Json;
 using osu.Framework.Audio.Sample;
 using osu.Framework.Bindables;
@@ -27,14 +29,12 @@ namespace osu.Game.Skinning
         /// <summary>
         /// A texture store which can be used to perform user file loops for this skin.
         /// </summary>
-        [CanBeNull]
-        protected TextureStore Textures { get; }
+        protected TextureStore? Textures { get; }
 
         /// <summary>
         /// A sample store which can be used to perform user file loops for this skin.
         /// </summary>
-        [CanBeNull]
-        protected ISampleStore Samples { get; }
+        protected ISampleStore? Samples { get; }
 
         public readonly Live<SkinInfo> SkinInfo;
 
@@ -44,13 +44,13 @@ namespace osu.Game.Skinning
 
         private readonly Dictionary<SkinnableTarget, SkinnableInfo[]> drawableComponentInfo = new Dictionary<SkinnableTarget, SkinnableInfo[]>();
 
-        public abstract ISample GetSample(ISampleInfo sampleInfo);
+        public abstract ISample? GetSample(ISampleInfo sampleInfo);
 
-        public Texture GetTexture(string componentName) => GetTexture(componentName, default, default);
+        public Texture? GetTexture(string componentName) => GetTexture(componentName, default, default);
 
-        public abstract Texture GetTexture(string componentName, WrapMode wrapModeS, WrapMode wrapModeT);
+        public abstract Texture? GetTexture(string componentName, WrapMode wrapModeS, WrapMode wrapModeT);
 
-        public abstract IBindable<TValue> GetConfig<TLookup, TValue>(TLookup lookup);
+        public abstract IBindable<TValue>? GetConfig<TLookup, TValue>(TLookup lookup);
 
         /// <summary>
         /// Construct a new skin.
@@ -59,13 +59,11 @@ namespace osu.Game.Skinning
         /// <param name="resources">Access to game-wide resources.</param>
         /// <param name="storage">An optional store which will be used for looking up skin resources. If null, one will be created from realm <see cref="IHasRealmFiles"/> pattern.</param>
         /// <param name="configurationFilename">An optional filename to read the skin configuration from. If not provided, the configuration will be retrieved from the storage using "skin.ini".</param>
-        protected Skin(SkinInfo skin, [CanBeNull] IStorageResourceProvider resources, [CanBeNull] IResourceStore<byte[]> storage = null, [CanBeNull] string configurationFilename = @"skin.ini")
+        protected Skin(SkinInfo skin, IStorageResourceProvider? resources, IResourceStore<byte[]>? storage = null, string configurationFilename = @"skin.ini")
         {
             if (resources != null)
             {
-                SkinInfo = resources.RealmAccess != null
-                    ? skin.ToLive(resources.RealmAccess)
-                    : skin.ToLiveUnmanaged();
+                SkinInfo = skin.ToLive(resources.RealmAccess);
 
                 storage ??= new RealmBackedResourceStore(skin, resources.Files, new[] { @"ogg" });
 
@@ -76,12 +74,20 @@ namespace osu.Game.Skinning
                 Samples = samples;
                 Textures = new TextureStore(resources.CreateTextureLoaderStore(storage));
             }
+            else
+            {
+                // Generally only used for tests.
+                SkinInfo = skin.ToLiveUnmanaged();
+            }
 
             var configurationStream = storage?.GetStream(configurationFilename);
 
             if (configurationStream != null)
+            {
                 // stream will be closed after use by LineBufferedReader.
                 ParseConfigurationStream(configurationStream);
+                Debug.Assert(Configuration != null);
+            }
             else
                 Configuration = new SkinConfiguration();
 
@@ -90,7 +96,7 @@ namespace osu.Game.Skinning
             {
                 string filename = $"{skinnableTarget}.json";
 
-                byte[] bytes = storage?.Get(filename);
+                byte[]? bytes = storage?.Get(filename);
 
                 if (bytes == null)
                     continue;
@@ -136,7 +142,7 @@ namespace osu.Game.Skinning
             DrawableComponentInfo[targetContainer.Target] = targetContainer.CreateSkinnableInfo().ToArray();
         }
 
-        public virtual Drawable GetDrawableComponent(ISkinComponent component)
+        public virtual Drawable? GetDrawableComponent(ISkinComponent component)
         {
             switch (component)
             {

From 194bf4fb057e60eff9781c2d85896e3b79075202 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 24 Mar 2022 00:21:19 +0900
Subject: [PATCH 3673/5547] Convert `LegacySkin` to use `nullable`

---
 osu.Game/Skinning/LegacySkin.cs | 35 ++++++++++++++++++---------------
 1 file changed, 19 insertions(+), 16 deletions(-)

diff --git a/osu.Game/Skinning/LegacySkin.cs b/osu.Game/Skinning/LegacySkin.cs
index 1c2ca797c6..20cac52d21 100644
--- a/osu.Game/Skinning/LegacySkin.cs
+++ b/osu.Game/Skinning/LegacySkin.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.
 
+#nullable enable
+
 using System;
 using System.Collections.Generic;
 using System.Diagnostics;
@@ -57,7 +59,7 @@ namespace osu.Game.Skinning
         /// <param name="resources">Access to raw game resources.</param>
         /// <param name="storage">An optional store which will be used for looking up skin resources. If null, one will be created from realm <see cref="IHasRealmFiles"/> pattern.</param>
         /// <param name="configurationFilename">The user-facing filename of the configuration file to be parsed. Can accept an .osu or skin.ini file.</param>
-        protected LegacySkin(SkinInfo skin, [CanBeNull] IStorageResourceProvider resources, [CanBeNull] IResourceStore<byte[]> storage, string configurationFilename = @"skin.ini")
+        protected LegacySkin(SkinInfo skin, IStorageResourceProvider? resources, IResourceStore<byte[]>? storage, string configurationFilename = @"skin.ini")
             : base(skin, resources, storage, configurationFilename)
         {
             // todo: this shouldn't really be duplicated here (from ManiaLegacySkinTransformer). we need to come up with a better solution.
@@ -81,7 +83,7 @@ namespace osu.Game.Skinning
             }
         }
 
-        public override IBindable<TValue> GetConfig<TLookup, TValue>(TLookup lookup)
+        public override IBindable<TValue>? GetConfig<TLookup, TValue>(TLookup lookup)
         {
             switch (lookup)
             {
@@ -127,7 +129,7 @@ namespace osu.Game.Skinning
             return null;
         }
 
-        private IBindable<TValue> lookupForMania<TValue>(LegacyManiaSkinConfigurationLookup maniaLookup)
+        private IBindable<TValue>? lookupForMania<TValue>(LegacyManiaSkinConfigurationLookup maniaLookup)
         {
             if (!maniaConfigurations.TryGetValue(maniaLookup.Keys, out var existing))
                 maniaConfigurations[maniaLookup.Keys] = existing = new LegacyManiaSkinConfiguration(maniaLookup.Keys);
@@ -267,20 +269,19 @@ namespace osu.Game.Skinning
         /// <param name="source">The source to retrieve the combo colours from.</param>
         /// <param name="colourIndex">The preferred index for retrieving the combo colour with.</param>
         /// <param name="combo">Information on the combo whose using the returned colour.</param>
-        protected virtual IBindable<Color4> GetComboColour(IHasComboColours source, int colourIndex, IHasComboInformation combo)
+        protected virtual IBindable<Color4>? GetComboColour(IHasComboColours source, int colourIndex, IHasComboInformation combo)
         {
             var colour = source.ComboColours?[colourIndex % source.ComboColours.Count];
             return colour.HasValue ? new Bindable<Color4>(colour.Value) : null;
         }
 
-        private IBindable<Color4> getCustomColour(IHasCustomColours source, string lookup)
+        private IBindable<Color4>? getCustomColour(IHasCustomColours source, string lookup)
             => source.CustomColours.TryGetValue(lookup, out var col) ? new Bindable<Color4>(col) : null;
 
-        private IBindable<string> getManiaImage(LegacyManiaSkinConfiguration source, string lookup)
+        private IBindable<string>? getManiaImage(LegacyManiaSkinConfiguration source, string lookup)
             => source.ImageLookups.TryGetValue(lookup, out string image) ? new Bindable<string>(image) : null;
 
-        [CanBeNull]
-        private IBindable<TValue> legacySettingLookup<TValue>(SkinConfiguration.LegacySetting legacySetting)
+        private IBindable<TValue>? legacySettingLookup<TValue>(SkinConfiguration.LegacySetting legacySetting)
         {
             switch (legacySetting)
             {
@@ -292,9 +293,11 @@ namespace osu.Game.Skinning
             }
         }
 
-        [CanBeNull]
-        private IBindable<TValue> genericLookup<TLookup, TValue>(TLookup lookup)
+        private IBindable<TValue>? genericLookup<TLookup, TValue>(TLookup lookup)
         {
+            if (lookup == null)
+                return null;
+
             try
             {
                 if (Configuration.ConfigDictionary.TryGetValue(lookup.ToString(), out string val))
@@ -316,7 +319,7 @@ namespace osu.Game.Skinning
             return null;
         }
 
-        public override Drawable GetDrawableComponent(ISkinComponent component)
+        public override Drawable? GetDrawableComponent(ISkinComponent component)
         {
             if (base.GetDrawableComponent(component) is Drawable c)
                 return c;
@@ -385,7 +388,7 @@ namespace osu.Game.Skinning
 
                 case GameplaySkinComponent<HitResult> resultComponent:
                     // TODO: this should be inside the judgement pieces.
-                    Func<Drawable> createDrawable = () => getJudgementAnimation(resultComponent.Component);
+                    Func<Drawable?> createDrawable = () => getJudgementAnimation(resultComponent.Component);
 
                     // kind of wasteful that we throw this away, but should do for now.
                     if (createDrawable() != null)
@@ -404,7 +407,7 @@ namespace osu.Game.Skinning
             return this.GetAnimation(component.LookupName, false, false);
         }
 
-        private Texture getParticleTexture(HitResult result)
+        private Texture? getParticleTexture(HitResult result)
         {
             switch (result)
             {
@@ -421,7 +424,7 @@ namespace osu.Game.Skinning
             return null;
         }
 
-        private Drawable getJudgementAnimation(HitResult result)
+        private Drawable? getJudgementAnimation(HitResult result)
         {
             switch (result)
             {
@@ -441,7 +444,7 @@ namespace osu.Game.Skinning
             return null;
         }
 
-        public override Texture GetTexture(string componentName, WrapMode wrapModeS, WrapMode wrapModeT)
+        public override Texture? GetTexture(string componentName, WrapMode wrapModeS, WrapMode wrapModeT)
         {
             foreach (string name in getFallbackNames(componentName))
             {
@@ -469,7 +472,7 @@ namespace osu.Game.Skinning
             return null;
         }
 
-        public override ISample GetSample(ISampleInfo sampleInfo)
+        public override ISample? GetSample(ISampleInfo sampleInfo)
         {
             IEnumerable<string> lookupNames;
 

From 7296bad294c93d7e088f52a103a0f395dae1581b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 24 Mar 2022 00:24:06 +0900
Subject: [PATCH 3674/5547] Convert `LegacyBeatmapSkin` to use `nullable`

---
 osu.Game/Skinning/LegacyBeatmapSkin.cs | 18 ++++++++++--------
 1 file changed, 10 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Skinning/LegacyBeatmapSkin.cs b/osu.Game/Skinning/LegacyBeatmapSkin.cs
index e3685c986b..16a05f4197 100644
--- a/osu.Game/Skinning/LegacyBeatmapSkin.cs
+++ b/osu.Game/Skinning/LegacyBeatmapSkin.cs
@@ -1,9 +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 JetBrains.Annotations;
+#nullable enable
+
 using osu.Framework.Audio.Sample;
 using osu.Framework.Bindables;
+using osu.Framework.Extensions.ObjectExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.IO.Stores;
 using osu.Game.Audio;
@@ -26,14 +28,14 @@ namespace osu.Game.Skinning
         /// </summary>
         /// <param name="beatmapInfo">The model for this beatmap.</param>
         /// <param name="resources">Access to raw game resources.</param>
-        public LegacyBeatmapSkin(BeatmapInfo beatmapInfo, [CanBeNull] IStorageResourceProvider resources)
-            : base(createSkinInfo(beatmapInfo), resources, createRealmBackedStore(beatmapInfo, resources), beatmapInfo.Path)
+        public LegacyBeatmapSkin(BeatmapInfo beatmapInfo, IStorageResourceProvider? resources)
+            : base(createSkinInfo(beatmapInfo), resources, createRealmBackedStore(beatmapInfo, resources), beatmapInfo.Path.AsNonNull())
         {
             // Disallow default colours fallback on beatmap skins to allow using parent skin combo colours. (via SkinProvidingContainer)
             Configuration.AllowDefaultComboColoursFallback = false;
         }
 
-        private static IResourceStore<byte[]> createRealmBackedStore(BeatmapInfo beatmapInfo, [CanBeNull] IStorageResourceProvider resources)
+        private static IResourceStore<byte[]> createRealmBackedStore(BeatmapInfo beatmapInfo, IStorageResourceProvider? resources)
         {
             if (resources == null)
                 // should only ever be used in tests.
@@ -42,7 +44,7 @@ namespace osu.Game.Skinning
             return new RealmBackedResourceStore(beatmapInfo.BeatmapSet, resources.Files, new[] { @"ogg" });
         }
 
-        public override Drawable GetDrawableComponent(ISkinComponent component)
+        public override Drawable? GetDrawableComponent(ISkinComponent component)
         {
             if (component is SkinnableTargetComponent targetComponent)
             {
@@ -61,7 +63,7 @@ namespace osu.Game.Skinning
             return base.GetDrawableComponent(component);
         }
 
-        public override IBindable<TValue> GetConfig<TLookup, TValue>(TLookup lookup)
+        public override IBindable<TValue>? GetConfig<TLookup, TValue>(TLookup lookup)
         {
             switch (lookup)
             {
@@ -77,10 +79,10 @@ namespace osu.Game.Skinning
             return base.GetConfig<TLookup, TValue>(lookup);
         }
 
-        protected override IBindable<Color4> GetComboColour(IHasComboColours source, int comboIndex, IHasComboInformation combo)
+        protected override IBindable<Color4>? GetComboColour(IHasComboColours source, int comboIndex, IHasComboInformation combo)
             => base.GetComboColour(source, combo.ComboIndexWithOffsets, combo);
 
-        public override ISample GetSample(ISampleInfo sampleInfo)
+        public override ISample? GetSample(ISampleInfo sampleInfo)
         {
             if (sampleInfo is ConvertHitObjectParser.LegacyHitSampleInfo legacy && legacy.CustomSampleBank == 0)
             {

From 547418e47e2296e71fb6567441afb183af2152d0 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 24 Mar 2022 11:15:51 +0900
Subject: [PATCH 3675/5547] Revert "Remove PopoverButton class"

This reverts commit 6b712be97d08de140bd6d3b0cb81d8d90412194b.
---
 .../Visual/Multiplayer/TestSceneMatchStartControl.cs      | 8 ++++----
 .../OnlinePlay/Multiplayer/Match/CountdownButton.cs       | 6 +++++-
 2 files changed, 9 insertions(+), 5 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.cs
index cd1eee49ec..b09fd306b7 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.cs
@@ -79,7 +79,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             ClickButtonWhenEnabled<CountdownButton>();
             AddStep("click the first countdown button", () =>
             {
-                var popoverButton = this.ChildrenOfType<CountdownButton>().Single().ChildrenOfType<OsuButton>().First();
+                var popoverButton = this.ChildrenOfType<CountdownButton.PopoverButton>().First();
                 InputManager.MoveMouseTo(popoverButton);
                 InputManager.Click(MouseButton.Left);
             });
@@ -97,7 +97,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             ClickButtonWhenEnabled<CountdownButton>();
             AddStep("click the first countdown button", () =>
             {
-                var popoverButton = this.ChildrenOfType<CountdownButton>().Single().ChildrenOfType<OsuButton>().First();
+                var popoverButton = this.ChildrenOfType<CountdownButton.PopoverButton>().First();
                 InputManager.MoveMouseTo(popoverButton);
                 InputManager.Click(MouseButton.Left);
             });
@@ -150,7 +150,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             ClickButtonWhenEnabled<CountdownButton>();
             AddStep("click the first countdown button", () =>
             {
-                var popoverButton = this.ChildrenOfType<CountdownButton>().Single().ChildrenOfType<OsuButton>().First();
+                var popoverButton = this.ChildrenOfType<CountdownButton.PopoverButton>().First();
                 InputManager.MoveMouseTo(popoverButton);
                 InputManager.Click(MouseButton.Left);
             });
@@ -173,7 +173,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             ClickButtonWhenEnabled<CountdownButton>();
             AddStep("click the first countdown button", () =>
             {
-                var popoverButton = this.ChildrenOfType<CountdownButton>().Single().ChildrenOfType<OsuButton>().First();
+                var popoverButton = this.ChildrenOfType<CountdownButton.PopoverButton>().First();
                 InputManager.MoveMouseTo(popoverButton);
                 InputManager.Click(MouseButton.Left);
             });
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/CountdownButton.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/CountdownButton.cs
index e37168bf25..e598f6670c 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/CountdownButton.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/CountdownButton.cs
@@ -64,7 +64,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
 
             foreach (var duration in available_delays)
             {
-                flow.Add(new OsuButton
+                flow.Add(new PopoverButton
                 {
                     RelativeSizeAxes = Axes.X,
                     Text = $"Start match in {duration.Humanize()}",
@@ -79,5 +79,9 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
 
             return new OsuPopover { Child = flow };
         }
+
+        public class PopoverButton : OsuButton
+        {
+        }
     }
 }

From a4d17a915f96c505e518dd261f9b4d1d5d967b7f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 24 Mar 2022 12:36:16 +0900
Subject: [PATCH 3676/5547] Fix incorrect HUD component fallback

Legacy skins should now always show the legacy hud components. The
conditional here is no longer valid as fallback lookups happen at a
*skin*-fallback level rather than internal *source*-fallback.

Put another way, `LegacyDefaultSkin` (with user customisations) should
still display the classic HUD components even if a font is not provided,
as that font will be available via the skin lookup hierarchy.

The TODO removed in this commit has been already resolved so this code
is no longer required.
---
 osu.Game/Skinning/LegacySkin.cs | 29 +++++++++--------------------
 1 file changed, 9 insertions(+), 20 deletions(-)

diff --git a/osu.Game/Skinning/LegacySkin.cs b/osu.Game/Skinning/LegacySkin.cs
index 1c2ca797c6..244774fd4c 100644
--- a/osu.Game/Skinning/LegacySkin.cs
+++ b/osu.Game/Skinning/LegacySkin.cs
@@ -356,26 +356,15 @@ namespace osu.Game.Skinning
                                 }
                             })
                             {
-                                Children = this.HasFont(LegacyFont.Score)
-                                    ? new Drawable[]
-                                    {
-                                        new LegacyComboCounter(),
-                                        new LegacyScoreCounter(),
-                                        new LegacyAccuracyCounter(),
-                                        new LegacyHealthDisplay(),
-                                        new SongProgress(),
-                                        new BarHitErrorMeter(),
-                                    }
-                                    : new Drawable[]
-                                    {
-                                        // TODO: these should fallback to using osu!classic skin textures, rather than doing this.
-                                        new DefaultComboCounter(),
-                                        new DefaultScoreCounter(),
-                                        new DefaultAccuracyCounter(),
-                                        new DefaultHealthDisplay(),
-                                        new SongProgress(),
-                                        new BarHitErrorMeter(),
-                                    }
+                                Children = new Drawable[]
+                                {
+                                    new LegacyComboCounter(),
+                                    new LegacyScoreCounter(),
+                                    new LegacyAccuracyCounter(),
+                                    new LegacyHealthDisplay(),
+                                    new SongProgress(),
+                                    new BarHitErrorMeter(),
+                                }
                             };
 
                             return skinnableTargetWrapper;

From 0cd29a73b929b007c02619d96fa6b71f0834aa24 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 24 Mar 2022 12:39:47 +0900
Subject: [PATCH 3677/5547] Fix typo in xmldocs

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

diff --git a/osu.Game/Skinning/Skin.cs b/osu.Game/Skinning/Skin.cs
index b6f46a0d81..e1fcf196f3 100644
--- a/osu.Game/Skinning/Skin.cs
+++ b/osu.Game/Skinning/Skin.cs
@@ -25,13 +25,13 @@ namespace osu.Game.Skinning
     public abstract class Skin : IDisposable, ISkin
     {
         /// <summary>
-        /// A texture store which can be used to perform user file loops for this skin.
+        /// A texture store which can be used to perform user file lookups for this skin.
         /// </summary>
         [CanBeNull]
         protected TextureStore Textures { get; }
 
         /// <summary>
-        /// A sample store which can be used to perform user file loops for this skin.
+        /// A sample store which can be used to perform user file lookups for this skin.
         /// </summary>
         [CanBeNull]
         protected ISampleStore Samples { get; }

From e243a7c55d349788f85c34a1b573b88547ace35b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 24 Mar 2022 12:45:11 +0900
Subject: [PATCH 3678/5547] Reword `storage` param xmldoc to use stronger and
 better defined langauge

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

diff --git a/osu.Game/Skinning/Skin.cs b/osu.Game/Skinning/Skin.cs
index e1fcf196f3..e00dd950a7 100644
--- a/osu.Game/Skinning/Skin.cs
+++ b/osu.Game/Skinning/Skin.cs
@@ -57,7 +57,7 @@ namespace osu.Game.Skinning
         /// </summary>
         /// <param name="skin">The skin's metadata. Usually a live realm object.</param>
         /// <param name="resources">Access to game-wide resources.</param>
-        /// <param name="storage">An optional store which will be used for looking up skin resources. If null, one will be created from realm <see cref="IHasRealmFiles"/> pattern.</param>
+        /// <param name="storage">An optional store which will *replace* all file lookups that are usually sourced from <paramref name="skin"/>.</param>
         /// <param name="configurationFilename">An optional filename to read the skin configuration from. If not provided, the configuration will be retrieved from the storage using "skin.ini".</param>
         protected Skin(SkinInfo skin, [CanBeNull] IStorageResourceProvider resources, [CanBeNull] IResourceStore<byte[]> storage = null, [CanBeNull] string configurationFilename = @"skin.ini")
         {

From 4d0b4c2541823d083c235c6b390a8d17d2f73ac9 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 24 Mar 2022 12:53:50 +0900
Subject: [PATCH 3679/5547] Fix realm potentially not being refreshed in time
 for test asserts in `BeatmapImporterTests`

As seen at https://github.com/ppy/osu/runs/5659368512?check_suite_focus=true

Went through every usage of `.Import` and added either an
`EnsureLoaded`, or where that provides too many checks, an explicit
`realm.Refresh()`.
---
 osu.Game.Tests/Database/BeatmapImporterTests.cs | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/osu.Game.Tests/Database/BeatmapImporterTests.cs b/osu.Game.Tests/Database/BeatmapImporterTests.cs
index 9abd78039a..f9c13a8169 100644
--- a/osu.Game.Tests/Database/BeatmapImporterTests.cs
+++ b/osu.Game.Tests/Database/BeatmapImporterTests.cs
@@ -147,7 +147,10 @@ namespace osu.Game.Tests.Database
                     Live<BeatmapSetInfo>? imported;
 
                     using (var reader = new ZipArchiveReader(TestResources.GetTestBeatmapStream()))
+                    {
                         imported = await importer.Import(reader);
+                        EnsureLoaded(realm.Realm);
+                    }
 
                     Assert.AreEqual(1, realm.Realm.All<BeatmapSetInfo>().Count());
 
@@ -510,6 +513,8 @@ namespace osu.Game.Tests.Database
                     new ImportTask(zipStream, string.Empty)
                 );
 
+                realm.Run(r => r.Refresh());
+
                 checkBeatmapSetCount(realm.Realm, 0);
                 checkBeatmapCount(realm.Realm, 0);
 
@@ -565,6 +570,8 @@ namespace osu.Game.Tests.Database
                 {
                 }
 
+                EnsureLoaded(realm.Realm);
+
                 checkBeatmapSetCount(realm.Realm, 1);
                 checkBeatmapCount(realm.Realm, 12);
 
@@ -726,6 +733,8 @@ namespace osu.Game.Tests.Database
 
                 var imported = importer.Import(toImport);
 
+                realm.Run(r => r.Refresh());
+
                 Assert.NotNull(imported);
                 Debug.Assert(imported != null);
 
@@ -891,6 +900,8 @@ namespace osu.Game.Tests.Database
                 string? temp = TestResources.GetTestBeatmapForImport();
                 await importer.Import(temp);
 
+                EnsureLoaded(realm.Realm);
+
                 // Update via the beatmap, not the beatmap info, to ensure correct linking
                 BeatmapSetInfo setToUpdate = realm.Realm.All<BeatmapSetInfo>().First();
 

From 90c7945bca3c413824618dc3ae430d072e2d7a85 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 24 Mar 2022 14:26:31 +0900
Subject: [PATCH 3680/5547] Re-remove PopoverButton class with better test fix

---
 .../Visual/Multiplayer/TestSceneMatchStartControl.cs     | 9 +++++----
 .../OnlinePlay/Multiplayer/Match/CountdownButton.cs      | 6 +-----
 2 files changed, 6 insertions(+), 9 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.cs
index b09fd306b7..02a61208d4 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.cs
@@ -10,6 +10,7 @@ using osu.Framework.Bindables;
 using osu.Framework.Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Cursor;
+using osu.Framework.Graphics.UserInterface;
 using osu.Framework.Platform;
 using osu.Framework.Testing;
 using osu.Framework.Utils;
@@ -79,7 +80,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             ClickButtonWhenEnabled<CountdownButton>();
             AddStep("click the first countdown button", () =>
             {
-                var popoverButton = this.ChildrenOfType<CountdownButton.PopoverButton>().First();
+                var popoverButton = this.ChildrenOfType<Popover>().Single().ChildrenOfType<OsuButton>().First();
                 InputManager.MoveMouseTo(popoverButton);
                 InputManager.Click(MouseButton.Left);
             });
@@ -97,7 +98,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             ClickButtonWhenEnabled<CountdownButton>();
             AddStep("click the first countdown button", () =>
             {
-                var popoverButton = this.ChildrenOfType<CountdownButton.PopoverButton>().First();
+                var popoverButton = this.ChildrenOfType<Popover>().Single().ChildrenOfType<OsuButton>().First();
                 InputManager.MoveMouseTo(popoverButton);
                 InputManager.Click(MouseButton.Left);
             });
@@ -150,7 +151,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             ClickButtonWhenEnabled<CountdownButton>();
             AddStep("click the first countdown button", () =>
             {
-                var popoverButton = this.ChildrenOfType<CountdownButton.PopoverButton>().First();
+                var popoverButton = this.ChildrenOfType<Popover>().Single().ChildrenOfType<OsuButton>().First();
                 InputManager.MoveMouseTo(popoverButton);
                 InputManager.Click(MouseButton.Left);
             });
@@ -173,7 +174,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             ClickButtonWhenEnabled<CountdownButton>();
             AddStep("click the first countdown button", () =>
             {
-                var popoverButton = this.ChildrenOfType<CountdownButton.PopoverButton>().First();
+                var popoverButton = this.ChildrenOfType<Popover>().Single().ChildrenOfType<OsuButton>().First();
                 InputManager.MoveMouseTo(popoverButton);
                 InputManager.Click(MouseButton.Left);
             });
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/CountdownButton.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/CountdownButton.cs
index e598f6670c..e37168bf25 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/CountdownButton.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/CountdownButton.cs
@@ -64,7 +64,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
 
             foreach (var duration in available_delays)
             {
-                flow.Add(new PopoverButton
+                flow.Add(new OsuButton
                 {
                     RelativeSizeAxes = Axes.X,
                     Text = $"Start match in {duration.Humanize()}",
@@ -79,9 +79,5 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
 
             return new OsuPopover { Child = flow };
         }
-
-        public class PopoverButton : OsuButton
-        {
-        }
     }
 }

From 96a447f68bf753b9c9f914def65504c627c9a27c Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 24 Mar 2022 14:28:38 +0900
Subject: [PATCH 3681/5547] Rename Multiplayer prefix to button classes

---
 .../Visual/Multiplayer/QueueModeTestScene.cs  |  4 +-
 .../TestSceneAllPlayersQueueMode.cs           |  8 +--
 .../Multiplayer/TestSceneMatchStartControl.cs | 60 +++++++++----------
 .../TestSceneMultiplayerMatchSubScreen.cs     |  2 +-
 .../TestSceneMultiplayerSpectateButton.cs     |  2 +-
 .../Multiplayer/Match/MatchStartControl.cs    |  6 +-
 ...utton.cs => MultiplayerCountdownButton.cs} |  4 +-
 ...adyButton.cs => MultiplayerReadyButton.cs} |  3 +-
 8 files changed, 45 insertions(+), 44 deletions(-)
 rename osu.Game/Screens/OnlinePlay/Multiplayer/Match/{CountdownButton.cs => MultiplayerCountdownButton.cs} (95%)
 rename osu.Game/Screens/OnlinePlay/Multiplayer/Match/{ReadyButton.cs => MultiplayerReadyButton.cs} (98%)

diff --git a/osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs b/osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs
index fd43674b3b..bafc579134 100644
--- a/osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs
@@ -95,10 +95,10 @@ namespace osu.Game.Tests.Visual.Multiplayer
         protected void RunGameplay()
         {
             AddUntilStep("wait for idle", () => MultiplayerClient.LocalUser?.State == MultiplayerUserState.Idle);
-            ClickButtonWhenEnabled<ReadyButton>();
+            ClickButtonWhenEnabled<MultiplayerReadyButton>();
 
             AddUntilStep("wait for ready", () => MultiplayerClient.LocalUser?.State == MultiplayerUserState.Ready);
-            ClickButtonWhenEnabled<ReadyButton>();
+            ClickButtonWhenEnabled<MultiplayerReadyButton>();
 
             AddUntilStep("wait for player", () => multiplayerComponents.CurrentScreen is Player player && player.IsLoaded);
             AddStep("exit player", () => multiplayerComponents.MultiplayerScreen.MakeCurrent());
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneAllPlayersQueueMode.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneAllPlayersQueueMode.cs
index 582dacb332..0785315b26 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneAllPlayersQueueMode.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneAllPlayersQueueMode.cs
@@ -102,10 +102,10 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddUntilStep("selected beatmap is initial beatmap", () => Beatmap.Value.BeatmapInfo.OnlineID == InitialBeatmap.OnlineID);
 
             AddUntilStep("wait for idle", () => MultiplayerClient.LocalUser?.State == MultiplayerUserState.Idle);
-            ClickButtonWhenEnabled<ReadyButton>();
+            ClickButtonWhenEnabled<MultiplayerReadyButton>();
 
             AddUntilStep("wait for ready", () => MultiplayerClient.LocalUser?.State == MultiplayerUserState.Ready);
-            ClickButtonWhenEnabled<ReadyButton>();
+            ClickButtonWhenEnabled<MultiplayerReadyButton>();
 
             AddUntilStep("wait for player", () => CurrentScreen is Player player && player.IsLoaded);
             AddAssert("ruleset is correct", () => ((Player)CurrentScreen).Ruleset.Value.Equals(new OsuRuleset().RulesetInfo));
@@ -119,10 +119,10 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddUntilStep("selected beatmap is initial beatmap", () => Beatmap.Value.BeatmapInfo.OnlineID == InitialBeatmap.OnlineID);
 
             AddUntilStep("wait for idle", () => MultiplayerClient.LocalUser?.State == MultiplayerUserState.Idle);
-            ClickButtonWhenEnabled<ReadyButton>();
+            ClickButtonWhenEnabled<MultiplayerReadyButton>();
 
             AddUntilStep("wait for ready", () => MultiplayerClient.LocalUser?.State == MultiplayerUserState.Ready);
-            ClickButtonWhenEnabled<ReadyButton>();
+            ClickButtonWhenEnabled<MultiplayerReadyButton>();
 
             AddUntilStep("wait for player", () => CurrentScreen is Player player && player.IsLoaded);
             AddAssert("mods are correct", () => !((Player)CurrentScreen).Mods.Value.Any());
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.cs
index 02a61208d4..4fd6fd5d70 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.cs
@@ -75,9 +75,9 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [Test]
         public void TestStartWithCountdown()
         {
-            ClickButtonWhenEnabled<ReadyButton>();
-            AddUntilStep("countdown button shown", () => this.ChildrenOfType<CountdownButton>().SingleOrDefault()?.IsPresent == true);
-            ClickButtonWhenEnabled<CountdownButton>();
+            ClickButtonWhenEnabled<MultiplayerReadyButton>();
+            AddUntilStep("countdown button shown", () => this.ChildrenOfType<MultiplayerCountdownButton>().SingleOrDefault()?.IsPresent == true);
+            ClickButtonWhenEnabled<MultiplayerCountdownButton>();
             AddStep("click the first countdown button", () =>
             {
                 var popoverButton = this.ChildrenOfType<Popover>().Single().ChildrenOfType<OsuButton>().First();
@@ -85,7 +85,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 InputManager.Click(MouseButton.Left);
             });
 
-            AddAssert("countdown button not visible", () => !this.ChildrenOfType<CountdownButton>().Single().IsPresent);
+            AddAssert("countdown button not visible", () => !this.ChildrenOfType<MultiplayerCountdownButton>().Single().IsPresent);
             AddStep("finish countdown", () => MultiplayerClient.FinishCountdown());
             AddUntilStep("match started", () => MultiplayerClient.LocalUser?.State == MultiplayerUserState.WaitingForLoad);
         }
@@ -93,9 +93,9 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [Test]
         public void TestCancelCountdown()
         {
-            ClickButtonWhenEnabled<ReadyButton>();
-            AddUntilStep("countdown button shown", () => this.ChildrenOfType<CountdownButton>().SingleOrDefault()?.IsPresent == true);
-            ClickButtonWhenEnabled<CountdownButton>();
+            ClickButtonWhenEnabled<MultiplayerReadyButton>();
+            AddUntilStep("countdown button shown", () => this.ChildrenOfType<MultiplayerCountdownButton>().SingleOrDefault()?.IsPresent == true);
+            ClickButtonWhenEnabled<MultiplayerCountdownButton>();
             AddStep("click the first countdown button", () =>
             {
                 var popoverButton = this.ChildrenOfType<Popover>().Single().ChildrenOfType<OsuButton>().First();
@@ -103,7 +103,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 InputManager.Click(MouseButton.Left);
             });
 
-            ClickButtonWhenEnabled<ReadyButton>();
+            ClickButtonWhenEnabled<MultiplayerReadyButton>();
 
             AddStep("finish countdown", () => MultiplayerClient.FinishCountdown());
             AddUntilStep("match not started", () => MultiplayerClient.LocalUser?.State == MultiplayerUserState.Ready);
@@ -120,10 +120,10 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             AddStep("start with countdown", () => MultiplayerClient.SendMatchRequest(new StartMatchCountdownRequest { Duration = TimeSpan.FromMinutes(2) }).WaitSafely());
 
-            ClickButtonWhenEnabled<ReadyButton>();
+            ClickButtonWhenEnabled<MultiplayerReadyButton>();
             AddUntilStep("user is ready", () => MultiplayerClient.Room?.Users[0].State == MultiplayerUserState.Ready);
 
-            ClickButtonWhenEnabled<ReadyButton>();
+            ClickButtonWhenEnabled<MultiplayerReadyButton>();
             AddUntilStep("user is idle", () => MultiplayerClient.Room?.Users[0].State == MultiplayerUserState.Idle);
         }
 
@@ -133,22 +133,22 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddStep("set spectating", () => MultiplayerClient.ChangeUserState(API.LocalUser.Value.OnlineID, MultiplayerUserState.Spectating));
             AddUntilStep("local user is spectating", () => MultiplayerClient.LocalUser?.State == MultiplayerUserState.Spectating);
 
-            AddAssert("countdown button is visible", () => this.ChildrenOfType<CountdownButton>().Single().IsPresent);
-            AddAssert("countdown button disabled", () => !this.ChildrenOfType<CountdownButton>().Single().Enabled.Value);
+            AddAssert("countdown button is visible", () => this.ChildrenOfType<MultiplayerCountdownButton>().Single().IsPresent);
+            AddAssert("countdown button disabled", () => !this.ChildrenOfType<MultiplayerCountdownButton>().Single().Enabled.Value);
 
             AddStep("add second user", () => MultiplayerClient.AddUser(new APIUser { Id = 2, Username = "Another user" }));
-            AddAssert("countdown button disabled", () => !this.ChildrenOfType<CountdownButton>().Single().Enabled.Value);
+            AddAssert("countdown button disabled", () => !this.ChildrenOfType<MultiplayerCountdownButton>().Single().Enabled.Value);
 
             AddStep("set second user ready", () => MultiplayerClient.ChangeUserState(2, MultiplayerUserState.Ready));
-            AddAssert("countdown button enabled", () => this.ChildrenOfType<CountdownButton>().Single().Enabled.Value);
+            AddAssert("countdown button enabled", () => this.ChildrenOfType<MultiplayerCountdownButton>().Single().Enabled.Value);
         }
 
         [Test]
         public void TestSpectatingDuringCountdownWithNoReadyUsersCancelsCountdown()
         {
-            ClickButtonWhenEnabled<ReadyButton>();
-            AddUntilStep("countdown button shown", () => this.ChildrenOfType<CountdownButton>().SingleOrDefault()?.IsPresent == true);
-            ClickButtonWhenEnabled<CountdownButton>();
+            ClickButtonWhenEnabled<MultiplayerReadyButton>();
+            AddUntilStep("countdown button shown", () => this.ChildrenOfType<MultiplayerCountdownButton>().SingleOrDefault()?.IsPresent == true);
+            ClickButtonWhenEnabled<MultiplayerCountdownButton>();
             AddStep("click the first countdown button", () =>
             {
                 var popoverButton = this.ChildrenOfType<Popover>().Single().ChildrenOfType<OsuButton>().First();
@@ -169,9 +169,9 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddStep("add second user", () => MultiplayerClient.AddUser(new APIUser { Id = 2, Username = "Another user" }));
             AddStep("set second user ready", () => MultiplayerClient.ChangeUserState(2, MultiplayerUserState.Ready));
 
-            ClickButtonWhenEnabled<ReadyButton>();
-            AddUntilStep("countdown button shown", () => this.ChildrenOfType<CountdownButton>().SingleOrDefault()?.IsPresent == true);
-            ClickButtonWhenEnabled<CountdownButton>();
+            ClickButtonWhenEnabled<MultiplayerReadyButton>();
+            AddUntilStep("countdown button shown", () => this.ChildrenOfType<MultiplayerCountdownButton>().SingleOrDefault()?.IsPresent == true);
+            ClickButtonWhenEnabled<MultiplayerCountdownButton>();
             AddStep("click the first countdown button", () =>
             {
                 var popoverButton = this.ChildrenOfType<Popover>().Single().ChildrenOfType<OsuButton>().First();
@@ -182,7 +182,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddStep("set spectating", () => MultiplayerClient.ChangeUserState(API.LocalUser.Value.OnlineID, MultiplayerUserState.Spectating));
             AddUntilStep("local user is spectating", () => MultiplayerClient.LocalUser?.State == MultiplayerUserState.Spectating);
 
-            AddAssert("ready button enabled", () => this.ChildrenOfType<ReadyButton>().Single().Enabled.Value);
+            AddAssert("ready button enabled", () => this.ChildrenOfType<MultiplayerReadyButton>().Single().Enabled.Value);
         }
 
         [Test]
@@ -200,7 +200,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddStep("transfer host to local user", () => MultiplayerClient.TransferHost(API.LocalUser.Value.OnlineID));
             AddUntilStep("local user is host", () => MultiplayerClient.Room?.Host?.Equals(MultiplayerClient.LocalUser) == true);
 
-            ClickButtonWhenEnabled<ReadyButton>();
+            ClickButtonWhenEnabled<MultiplayerReadyButton>();
             AddUntilStep("local user became ready", () => MultiplayerClient.LocalUser?.State == MultiplayerUserState.Ready);
             AddAssert("countdown still active", () => MultiplayerClient.Room?.Countdown != null);
         }
@@ -231,10 +231,10 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 MultiplayerClient.TransferHost(2);
             });
 
-            ClickButtonWhenEnabled<ReadyButton>();
+            ClickButtonWhenEnabled<MultiplayerReadyButton>();
             AddUntilStep("user is ready", () => MultiplayerClient.Room?.Users[0].State == MultiplayerUserState.Ready);
 
-            ClickButtonWhenEnabled<ReadyButton>();
+            ClickButtonWhenEnabled<MultiplayerReadyButton>();
             AddUntilStep("user is idle", () => MultiplayerClient.Room?.Users[0].State == MultiplayerUserState.Idle);
         }
 
@@ -250,7 +250,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     MultiplayerClient.AddUser(new APIUser { Id = 2, Username = "Another user" });
             });
 
-            ClickButtonWhenEnabled<ReadyButton>();
+            ClickButtonWhenEnabled<MultiplayerReadyButton>();
             AddUntilStep("user is ready", () => MultiplayerClient.Room?.Users[0].State == MultiplayerUserState.Ready);
 
             verifyGameplayStartFlow();
@@ -265,7 +265,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 MultiplayerClient.TransferHost(2);
             });
 
-            ClickButtonWhenEnabled<ReadyButton>();
+            ClickButtonWhenEnabled<MultiplayerReadyButton>();
             AddStep("make user host", () => MultiplayerClient.TransferHost(MultiplayerClient.Room?.Users[0].UserID ?? 0));
 
             verifyGameplayStartFlow();
@@ -280,12 +280,12 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 MultiplayerClient.AddUser(new APIUser { Id = 2, Username = "Another user" });
             });
 
-            ClickButtonWhenEnabled<ReadyButton>();
+            ClickButtonWhenEnabled<MultiplayerReadyButton>();
             AddUntilStep("user is ready", () => MultiplayerClient.Room?.Users[0].State == MultiplayerUserState.Ready);
 
             AddStep("transfer host", () => MultiplayerClient.TransferHost(MultiplayerClient.Room?.Users[1].UserID ?? 0));
 
-            ClickButtonWhenEnabled<ReadyButton>();
+            ClickButtonWhenEnabled<MultiplayerReadyButton>();
             AddUntilStep("user is idle (match not started)", () => MultiplayerClient.Room?.Users[0].State == MultiplayerUserState.Idle);
             AddUntilStep("ready button enabled", () => control.ChildrenOfType<OsuButton>().Single().Enabled.Value);
         }
@@ -305,7 +305,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             if (!isHost)
                 AddStep("transfer host", () => MultiplayerClient.TransferHost(2));
 
-            ClickButtonWhenEnabled<ReadyButton>();
+            ClickButtonWhenEnabled<MultiplayerReadyButton>();
 
             AddRepeatStep("change user ready state", () =>
             {
@@ -323,7 +323,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         private void verifyGameplayStartFlow()
         {
             AddUntilStep("user is ready", () => MultiplayerClient.Room?.Users[0].State == MultiplayerUserState.Ready);
-            ClickButtonWhenEnabled<ReadyButton>();
+            ClickButtonWhenEnabled<MultiplayerReadyButton>();
             AddUntilStep("user waiting for load", () => MultiplayerClient.Room?.Users[0].State == MultiplayerUserState.WaitingForLoad);
 
             AddStep("finish gameplay", () =>
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs
index 850a115f4c..057032c413 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs
@@ -145,7 +145,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             AddUntilStep("wait for spectating user state", () => MultiplayerClient.LocalUser?.State == MultiplayerUserState.Spectating);
 
-            ClickButtonWhenEnabled<ReadyButton>();
+            ClickButtonWhenEnabled<MultiplayerReadyButton>();
 
             AddUntilStep("match started", () => MultiplayerClient.Room?.State == MultiplayerRoomState.WaitingForLoad);
         }
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerSpectateButton.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerSpectateButton.cs
index 07ac580276..13917f4eb0 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerSpectateButton.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerSpectateButton.cs
@@ -146,6 +146,6 @@ namespace osu.Game.Tests.Visual.Multiplayer
             => AddUntilStep($"spectate button {(shouldBeEnabled ? "is" : "is not")} enabled", () => spectateButton.ChildrenOfType<OsuButton>().Single().Enabled.Value == shouldBeEnabled);
 
         private void assertReadyButtonEnablement(bool shouldBeEnabled)
-            => AddUntilStep($"ready button {(shouldBeEnabled ? "is" : "is not")} enabled", () => startControl.ChildrenOfType<ReadyButton>().Single().Enabled.Value == shouldBeEnabled);
+            => AddUntilStep($"ready button {(shouldBeEnabled ? "is" : "is not")} enabled", () => startControl.ChildrenOfType<MultiplayerReadyButton>().Single().Enabled.Value == shouldBeEnabled);
     }
 }
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MatchStartControl.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MatchStartControl.cs
index 9470fb1d68..af7ed9b9e2 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MatchStartControl.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MatchStartControl.cs
@@ -31,7 +31,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
         private Sample sampleUnready;
 
         private readonly BindableBool enabled = new BindableBool();
-        private readonly CountdownButton countdownButton;
+        private readonly MultiplayerCountdownButton countdownButton;
         private int countReady;
         private ScheduledDelegate readySampleDelegate;
         private IBindable<bool> operationInProgress;
@@ -50,14 +50,14 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
                 {
                     new Drawable[]
                     {
-                        new ReadyButton
+                        new MultiplayerReadyButton
                         {
                             RelativeSizeAxes = Axes.Both,
                             Size = Vector2.One,
                             Action = onReadyClick,
                             Enabled = { BindTarget = enabled },
                         },
-                        countdownButton = new CountdownButton
+                        countdownButton = new MultiplayerCountdownButton
                         {
                             RelativeSizeAxes = Axes.Y,
                             Size = new Vector2(40, 1),
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/CountdownButton.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerCountdownButton.cs
similarity index 95%
rename from osu.Game/Screens/OnlinePlay/Multiplayer/Match/CountdownButton.cs
rename to osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerCountdownButton.cs
index e37168bf25..3bf7e91a55 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/CountdownButton.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerCountdownButton.cs
@@ -18,7 +18,7 @@ using osuTK;
 
 namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
 {
-    public class CountdownButton : IconButton, IHasPopover
+    public class MultiplayerCountdownButton : IconButton, IHasPopover
     {
         private static readonly TimeSpan[] available_delays =
         {
@@ -32,7 +32,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
 
         private readonly Drawable background;
 
-        public CountdownButton()
+        public MultiplayerCountdownButton()
         {
             Icon = FontAwesome.Solid.CaretDown;
             IconScale = new Vector2(0.6f);
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/ReadyButton.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
similarity index 98%
rename from osu.Game/Screens/OnlinePlay/Multiplayer/Match/ReadyButton.cs
rename to osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
index 007e055d8c..6ff717d5c3 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/ReadyButton.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
@@ -10,10 +10,11 @@ using osu.Framework.Threading;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Backgrounds;
 using osu.Game.Online.Multiplayer;
+using osu.Game.Screens.OnlinePlay.Components;
 
 namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
 {
-    public class ReadyButton : Components.ReadyButton
+    public class MultiplayerReadyButton : ReadyButton
     {
         public new Triangles Triangles => base.Triangles;
 

From 8ca9cbc866e089338b09585890c97fc5dfce8da4 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 24 Mar 2022 14:43:33 +0900
Subject: [PATCH 3682/5547] Set a more correct initial value for
 `pauseFreqAdjust`

As the `GameplayClock` now starts paused, this value needs to match to
ensure things work correctly.

For a better explanation of how we got here, see discussion at
https://github.com/ppy/osu/pull/17302#discussion_r830017735.
---
 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 529503e020..9bcbbf789b 100644
--- a/osu.Game/Screens/Play/MasterGameplayClockContainer.cs
+++ b/osu.Game/Screens/Play/MasterGameplayClockContainer.cs
@@ -46,7 +46,7 @@ namespace osu.Game.Screens.Play
 
         private double totalAppliedOffset => userBeatmapOffsetClock.RateAdjustedOffset + userGlobalOffsetClock.RateAdjustedOffset + platformOffsetClock.RateAdjustedOffset;
 
-        private readonly BindableDouble pauseFreqAdjust = new BindableDouble(1);
+        private readonly BindableDouble pauseFreqAdjust = new BindableDouble(); // Important that this starts at zero, matching the paused state of the clock.
 
         private readonly WorkingBeatmap beatmap;
 

From 16dc2f6ef50bccada9e9cba2f3e934324204140c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 24 Mar 2022 14:51:21 +0900
Subject: [PATCH 3683/5547] Adjust `TestSceneFailAnimation` to account for
 initial frequency change

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

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneFailAnimation.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneFailAnimation.cs
index 744227c55e..83d7d769df 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneFailAnimation.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneFailAnimation.cs
@@ -56,10 +56,11 @@ namespace osu.Game.Tests.Visual.Gameplay
 
             private double lastFrequency = double.MaxValue;
 
-            protected override void Update()
+            protected override void UpdateAfterChildren()
             {
-                base.Update();
+                base.UpdateAfterChildren();
 
+                // This must be done in UpdateAfterChildren to allow the gameplay clock to have updated before checking values.
                 double freq = Beatmap.Value.Track.AggregateFrequency.Value;
 
                 FrequencyIncreased |= freq > lastFrequency;

From 1049e349e39a8944c223b71ad8d0a621a3965781 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 24 Mar 2022 14:55:01 +0900
Subject: [PATCH 3684/5547] Add test coverage of user offset being set before
 construction of `MasterGameplayClockContainer`

---
 .../Gameplay/TestSceneMasterGameplayClockContainer.cs  | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Gameplay/TestSceneMasterGameplayClockContainer.cs b/osu.Game.Tests/Gameplay/TestSceneMasterGameplayClockContainer.cs
index b2dd6cbd97..75be7b0362 100644
--- a/osu.Game.Tests/Gameplay/TestSceneMasterGameplayClockContainer.cs
+++ b/osu.Game.Tests/Gameplay/TestSceneMasterGameplayClockContainer.cs
@@ -73,11 +73,15 @@ namespace osu.Game.Tests.Gameplay
         public void TestSeekPerformsInGameplayTime(
             [Values(1.0, 0.5, 2.0)] double clockRate,
             [Values(0.0, 200.0, -200.0)] double userOffset,
-            [Values(false, true)] bool whileStopped)
+            [Values(false, true)] bool whileStopped,
+            [Values(false, true)] bool setAudioOffsetBeforeConstruction)
         {
             ClockBackedTestWorkingBeatmap working = null;
             GameplayClockContainer gameplayClockContainer = null;
 
+            if (setAudioOffsetBeforeConstruction)
+                AddStep($"preset audio offset to {userOffset}", () => localConfig.SetValue(OsuSetting.AudioOffset, userOffset));
+
             AddStep("create container", () =>
             {
                 working = new ClockBackedTestWorkingBeatmap(new OsuRuleset().RulesetInfo, new FramedClock(new ManualClock()), Audio);
@@ -89,7 +93,9 @@ namespace osu.Game.Tests.Gameplay
             });
 
             AddStep($"set clock rate to {clockRate}", () => working.Track.AddAdjustment(AdjustableProperty.Frequency, new BindableDouble(clockRate)));
-            AddStep($"set audio offset to {userOffset}", () => localConfig.SetValue(OsuSetting.AudioOffset, userOffset));
+
+            if (!setAudioOffsetBeforeConstruction)
+                AddStep($"set audio offset to {userOffset}", () => localConfig.SetValue(OsuSetting.AudioOffset, userOffset));
 
             AddStep("seek to 2500", () => gameplayClockContainer.Seek(2500));
             AddAssert("gameplay clock time = 2500", () => Precision.AlmostEquals(gameplayClockContainer.CurrentTime, 2500, 10f));

From d36944ac950d86761931befc4a7e020040d9ce1e Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 24 Mar 2022 14:35:03 +0900
Subject: [PATCH 3685/5547] Dispose token manually

Cover more branches with cancellation source disposal
---
 .../Visual/Multiplayer/TestMultiplayerClient.cs  | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
index 1f20292437..5fa2ca8890 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
@@ -343,19 +343,19 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
                         Schedule(() =>
                         {
-                            if (Room.Countdown != countdown)
-                                return;
-
-                            Room.Countdown = null;
-                            MatchEvent(new CountdownChangedEvent { Countdown = null });
-
                             using (cancellationSource)
                             {
+                                if (Room.Countdown != countdown)
+                                    return;
+
+                                Room.Countdown = null;
+                                MatchEvent(new CountdownChangedEvent { Countdown = null });
+
                                 if (stopSource.Token.IsCancellationRequested)
                                     return;
-                            }
 
-                            StartMatch().WaitSafely();
+                                StartMatch().WaitSafely();
+                            }
                         });
                     }
 

From 8f3a4df70adc38f9ed4fb89e31b3367012eb8e45 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 24 Mar 2022 14:44:27 +0900
Subject: [PATCH 3686/5547] Add explanation for try-catch

---
 osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
index 5fa2ca8890..f96ba8ba24 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
@@ -339,6 +339,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                         }
                         catch (OperationCanceledException)
                         {
+                            // Clients need to be notified of cancellations in the following code.
                         }
 
                         Schedule(() =>

From d2ecc100e5390460a4216ac5e4ccc54ce62f89aa Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 24 Mar 2022 15:07:01 +0900
Subject: [PATCH 3687/5547] Revert unnecessary async change

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

diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
index f96ba8ba24..7562b1d0e2 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
@@ -387,7 +387,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             }
         }
 
-        public override async Task StartMatch()
+        public override Task StartMatch()
         {
             Debug.Assert(Room != null);
 
@@ -395,7 +395,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             foreach (var user in Room.Users.Where(u => u.State == MultiplayerUserState.Ready))
                 ChangeUserState(user.UserID, MultiplayerUserState.WaitingForLoad);
 
-            await ((IMultiplayerClient)this).LoadRequested();
+            return ((IMultiplayerClient)this).LoadRequested();
         }
 
         public override Task AbortGameplay()

From f0d132b16e04e85bb84c8b13d42d15559d2ce4e5 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 24 Mar 2022 15:21:46 +0900
Subject: [PATCH 3688/5547] Rename FinishCountdown() -> SkipToEndOfCountdown()

---
 .../Visual/Multiplayer/TestSceneMatchStartControl.cs |  6 +++---
 .../Visual/Multiplayer/TestMultiplayerClient.cs      | 12 ++++++++----
 2 files changed, 11 insertions(+), 7 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.cs
index 4fd6fd5d70..a374488306 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.cs
@@ -86,7 +86,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             });
 
             AddAssert("countdown button not visible", () => !this.ChildrenOfType<MultiplayerCountdownButton>().Single().IsPresent);
-            AddStep("finish countdown", () => MultiplayerClient.FinishCountdown());
+            AddStep("finish countdown", () => MultiplayerClient.SkipToEndOfCountdown());
             AddUntilStep("match started", () => MultiplayerClient.LocalUser?.State == MultiplayerUserState.WaitingForLoad);
         }
 
@@ -105,7 +105,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             ClickButtonWhenEnabled<MultiplayerReadyButton>();
 
-            AddStep("finish countdown", () => MultiplayerClient.FinishCountdown());
+            AddStep("finish countdown", () => MultiplayerClient.SkipToEndOfCountdown());
             AddUntilStep("match not started", () => MultiplayerClient.LocalUser?.State == MultiplayerUserState.Ready);
         }
 
@@ -159,7 +159,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddStep("set spectating", () => MultiplayerClient.ChangeUserState(API.LocalUser.Value.OnlineID, MultiplayerUserState.Spectating));
             AddUntilStep("local user is spectating", () => MultiplayerClient.LocalUser?.State == MultiplayerUserState.Spectating);
 
-            AddStep("finish countdown", () => MultiplayerClient.FinishCountdown());
+            AddStep("finish countdown", () => MultiplayerClient.SkipToEndOfCountdown());
             AddUntilStep("match not started", () => MultiplayerClient.Room?.State == MultiplayerRoomState.Open);
         }
 
diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
index 7562b1d0e2..ea991af914 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
@@ -296,11 +296,15 @@ namespace osu.Game.Tests.Visual.Multiplayer
             return Task.CompletedTask;
         }
 
-        private CancellationTokenSource? countdownFinishSource;
+        private CancellationTokenSource? countdownSkipSource;
         private CancellationTokenSource? countdownStopSource;
         private Task countdownTask = Task.CompletedTask;
 
-        public void FinishCountdown() => countdownFinishSource?.Cancel();
+        /// <summary>
+        /// Skips to the end of the currently-running countdown, if one is running,
+        /// and runs the callback (e.g. to start the match) as soon as possible unless the countdown has been cancelled.
+        /// </summary>
+        public void SkipToEndOfCountdown() => countdownSkipSource?.Cancel();
 
         public override async Task SendMatchRequest(MatchUserRequest request)
         {
@@ -313,8 +317,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     countdownStopSource?.Cancel();
 
                     var stopSource = countdownStopSource = new CancellationTokenSource();
-                    var finishSource = countdownFinishSource = new CancellationTokenSource();
-                    var cancellationSource = CancellationTokenSource.CreateLinkedTokenSource(stopSource.Token, finishSource.Token);
+                    var skipSource = countdownSkipSource = new CancellationTokenSource();
+                    var cancellationSource = CancellationTokenSource.CreateLinkedTokenSource(stopSource.Token, skipSource.Token);
                     var countdown = new MatchStartCountdown { TimeRemaining = matchCountdownRequest.Duration };
 
                     Task lastCountdownTask = countdownTask;

From 4c0d76573c10a0ae54463d491367ce43c0e3a691 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 24 Mar 2022 15:51:30 +0900
Subject: [PATCH 3689/5547] Asserate code is running on update thread

---
 osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
index ea991af914..6f57d818a4 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
@@ -11,6 +11,7 @@ using System.Threading;
 using System.Threading.Tasks;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
+using osu.Framework.Development;
 using osu.Framework.Extensions;
 using osu.Game.Online.API;
 using osu.Game.Online.Multiplayer;
@@ -314,6 +315,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
             switch (request)
             {
                 case StartMatchCountdownRequest matchCountdownRequest:
+                    Debug.Assert(ThreadSafety.IsUpdateThread);
+
                     countdownStopSource?.Cancel();
 
                     var stopSource = countdownStopSource = new CancellationTokenSource();

From a7d5f2281ce59c004991070865a6c4cf640bc637 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 24 Mar 2022 15:49:13 +0900
Subject: [PATCH 3690/5547] Apply beatmap offsets to legacy replay frame
 handling

---
 osu.Game/Scoring/Legacy/LegacyScoreDecoder.cs | 8 +++++++-
 osu.Game/Scoring/Legacy/LegacyScoreEncoder.cs | 6 +++++-
 2 files changed, 12 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Scoring/Legacy/LegacyScoreDecoder.cs b/osu.Game/Scoring/Legacy/LegacyScoreDecoder.cs
index fefee370b9..9885fe5528 100644
--- a/osu.Game/Scoring/Legacy/LegacyScoreDecoder.cs
+++ b/osu.Game/Scoring/Legacy/LegacyScoreDecoder.cs
@@ -23,6 +23,8 @@ namespace osu.Game.Scoring.Legacy
         private IBeatmap currentBeatmap;
         private Ruleset currentRuleset;
 
+        private float beatmapOffset;
+
         public Score Parse(Stream stream)
         {
             var score = new Score
@@ -72,6 +74,10 @@ namespace osu.Game.Scoring.Legacy
                 currentBeatmap = workingBeatmap.GetPlayableBeatmap(currentRuleset.RulesetInfo, scoreInfo.Mods);
                 scoreInfo.BeatmapInfo = currentBeatmap.BeatmapInfo;
 
+                // BeatmapVersion 4 and lower had an incorrect offset (stable has this set as 24ms off)
+                // As this is baked into hitobject timing (see `LegacyBeatmapDecoder`) we also need to apply this to replay frame timing.
+                beatmapOffset = currentBeatmap.BeatmapInfo.BeatmapVersion < 5 ? 24 : 0;
+
                 /* score.HpGraphString = */
                 sr.ReadString();
 
@@ -229,7 +235,7 @@ namespace osu.Game.Scoring.Legacy
 
         private void readLegacyReplay(Replay replay, StreamReader reader)
         {
-            float lastTime = 0;
+            float lastTime = beatmapOffset;
             ReplayFrame currentFrame = null;
 
             string[] frames = reader.ReadToEnd().Split(',');
diff --git a/osu.Game/Scoring/Legacy/LegacyScoreEncoder.cs b/osu.Game/Scoring/Legacy/LegacyScoreEncoder.cs
index f0ead05280..6a321bed7a 100644
--- a/osu.Game/Scoring/Legacy/LegacyScoreEncoder.cs
+++ b/osu.Game/Scoring/Legacy/LegacyScoreEncoder.cs
@@ -111,6 +111,10 @@ namespace osu.Game.Scoring.Legacy
             {
                 StringBuilder replayData = new StringBuilder();
 
+                // BeatmapVersion 4 and lower had an incorrect offset (stable has this set as 24ms off)
+                // As this is baked into hitobject timing (see `LegacyBeatmapDecoder`) we also need to apply this to replay frame timing.
+                double offset = beatmap?.BeatmapInfo.BeatmapVersion < 5 ? -24 : 0;
+
                 if (score.Replay != null)
                 {
                     int lastTime = 0;
@@ -120,7 +124,7 @@ namespace osu.Game.Scoring.Legacy
                         var legacyFrame = getLegacyFrame(f);
 
                         // Rounding because stable could only parse integral values
-                        int time = (int)Math.Round(legacyFrame.Time);
+                        int time = (int)Math.Round(legacyFrame.Time + offset);
                         replayData.Append(FormattableString.Invariant($"{time - lastTime}|{legacyFrame.MouseX ?? 0}|{legacyFrame.MouseY ?? 0}|{(int)legacyFrame.ButtonState},"));
                         lastTime = time;
                     }

From dfa076c16983fe5badebd5bc3887cdf81d2fe2fb Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 24 Mar 2022 16:29:59 +0900
Subject: [PATCH 3691/5547] Refactor cancellation logic

---
 .../Multiplayer/TestMultiplayerClient.cs      | 23 +++++++++----------
 1 file changed, 11 insertions(+), 12 deletions(-)

diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
index 6f57d818a4..9be1b18062 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
@@ -319,9 +319,10 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
                     countdownStopSource?.Cancel();
 
+                    // Note that this will leak CTSs, however this is a test method and we haven't noticed foregoing disposal of non-linked CTSs to be detrimental.
+                    // If necessary, this can be moved into the final schedule below, and the class-level fields be nulled out accordingly.
                     var stopSource = countdownStopSource = new CancellationTokenSource();
                     var skipSource = countdownSkipSource = new CancellationTokenSource();
-                    var cancellationSource = CancellationTokenSource.CreateLinkedTokenSource(stopSource.Token, skipSource.Token);
                     var countdown = new MatchStartCountdown { TimeRemaining = matchCountdownRequest.Duration };
 
                     Task lastCountdownTask = countdownTask;
@@ -342,7 +343,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
                         try
                         {
-                            await Task.Delay(matchCountdownRequest.Duration, cancellationSource.Token).ConfigureAwait(false);
+                            using (var cancellationSource = CancellationTokenSource.CreateLinkedTokenSource(stopSource.Token, skipSource.Token))
+                                await Task.Delay(matchCountdownRequest.Duration, cancellationSource.Token).ConfigureAwait(false);
                         }
                         catch (OperationCanceledException)
                         {
@@ -351,19 +353,16 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
                         Schedule(() =>
                         {
-                            using (cancellationSource)
-                            {
-                                if (Room.Countdown != countdown)
-                                    return;
+                            if (Room.Countdown != countdown)
+                                return;
 
-                                Room.Countdown = null;
-                                MatchEvent(new CountdownChangedEvent { Countdown = null });
+                            Room.Countdown = null;
+                            MatchEvent(new CountdownChangedEvent { Countdown = null });
 
-                                if (stopSource.Token.IsCancellationRequested)
-                                    return;
+                            if (stopSource.IsCancellationRequested)
+                                return;
 
-                                StartMatch().WaitSafely();
-                            }
+                            StartMatch().WaitSafely();
                         });
                     }
 

From 59a7eb532203629e8dbd6dbc8f44cbc83c03fbde Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 24 Mar 2022 16:34:21 +0900
Subject: [PATCH 3692/5547] Add test coverage ensuring offsets are correct
 before and after legacy replay encode

---
 .../Formats/LegacyScoreDecoderTest.cs         | 60 ++++++++++++++++++-
 1 file changed, 59 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Beatmaps/Formats/LegacyScoreDecoderTest.cs b/osu.Game.Tests/Beatmaps/Formats/LegacyScoreDecoderTest.cs
index 2ba8c51a10..a50cef238a 100644
--- a/osu.Game.Tests/Beatmaps/Formats/LegacyScoreDecoderTest.cs
+++ b/osu.Game.Tests/Beatmaps/Formats/LegacyScoreDecoderTest.cs
@@ -8,6 +8,7 @@ using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Utils;
 using osu.Game.Beatmaps;
+using osu.Game.Beatmaps.Formats;
 using osu.Game.Replays;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Catch;
@@ -64,6 +65,55 @@ namespace osu.Game.Tests.Beatmaps.Formats
             }
         }
 
+        [TestCase(3)]
+        [TestCase(6)]
+        [TestCase(LegacyBeatmapDecoder.LATEST_VERSION)]
+        public void TestLegacyBeatmapReplayOffsets(int beatmapVersion)
+        {
+            const double first_frame_time = 2000;
+            const double second_frame_time = 3000;
+
+            var ruleset = new OsuRuleset().RulesetInfo;
+            var scoreInfo = TestResources.CreateTestScoreInfo(ruleset);
+            var beatmap = new TestBeatmap(ruleset)
+            {
+                BeatmapInfo =
+                {
+                    BeatmapVersion = beatmapVersion
+                }
+            };
+
+            var score = new Score
+            {
+                ScoreInfo = scoreInfo,
+                Replay = new Replay
+                {
+                    Frames = new List<ReplayFrame>
+                    {
+                        new OsuReplayFrame(first_frame_time, OsuPlayfield.BASE_SIZE / 2, OsuAction.LeftButton),
+                        new OsuReplayFrame(second_frame_time, OsuPlayfield.BASE_SIZE / 2, OsuAction.LeftButton)
+                    }
+                }
+            };
+
+            // the "se" culture is used here, as it encodes the negative number sign as U+2212 MINUS SIGN,
+            // rather than the classic ASCII U+002D HYPHEN-MINUS.
+            CultureInfo.CurrentCulture = new CultureInfo("se");
+
+            var encodeStream = new MemoryStream();
+
+            var encoder = new LegacyScoreEncoder(score, beatmap);
+            encoder.Encode(encodeStream);
+
+            var decodeStream = new MemoryStream(encodeStream.GetBuffer());
+
+            var decoder = new TestLegacyScoreDecoder(beatmapVersion);
+            var decodedAfterEncode = decoder.Parse(decodeStream);
+
+            Assert.That(decodedAfterEncode.Replay.Frames[0].Time, Is.EqualTo(first_frame_time));
+            Assert.That(decodedAfterEncode.Replay.Frames[1].Time, Is.EqualTo(second_frame_time));
+        }
+
         [Test]
         public void TestCultureInvariance()
         {
@@ -118,6 +168,8 @@ namespace osu.Game.Tests.Beatmaps.Formats
 
         private class TestLegacyScoreDecoder : LegacyScoreDecoder
         {
+            private readonly int beatmapVersion;
+
             private static readonly Dictionary<int, Ruleset> rulesets = new Ruleset[]
             {
                 new OsuRuleset(),
@@ -126,6 +178,11 @@ namespace osu.Game.Tests.Beatmaps.Formats
                 new ManiaRuleset()
             }.ToDictionary(ruleset => ((ILegacyRuleset)ruleset).LegacyID);
 
+            public TestLegacyScoreDecoder(int beatmapVersion = LegacyBeatmapDecoder.LATEST_VERSION)
+            {
+                this.beatmapVersion = beatmapVersion;
+            }
+
             protected override Ruleset GetRuleset(int rulesetId) => rulesets[rulesetId];
 
             protected override WorkingBeatmap GetBeatmap(string md5Hash) => new TestWorkingBeatmap(new Beatmap
@@ -134,7 +191,8 @@ namespace osu.Game.Tests.Beatmaps.Formats
                 {
                     MD5Hash = md5Hash,
                     Ruleset = new OsuRuleset().RulesetInfo,
-                    Difficulty = new BeatmapDifficulty()
+                    Difficulty = new BeatmapDifficulty(),
+                    BeatmapVersion = beatmapVersion,
                 }
             });
         }

From 2efae031c97a904c7876f6ee89093725b70f1bc5 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 24 Mar 2022 16:39:56 +0900
Subject: [PATCH 3693/5547] Add test coverage of decode specifically

---
 .../Formats/LegacyScoreDecoderTest.cs         | 21 ++++++++++++++++++-
 1 file changed, 20 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Beatmaps/Formats/LegacyScoreDecoderTest.cs b/osu.Game.Tests/Beatmaps/Formats/LegacyScoreDecoderTest.cs
index a50cef238a..39586bcd8c 100644
--- a/osu.Game.Tests/Beatmaps/Formats/LegacyScoreDecoderTest.cs
+++ b/osu.Game.Tests/Beatmaps/Formats/LegacyScoreDecoderTest.cs
@@ -65,10 +65,29 @@ namespace osu.Game.Tests.Beatmaps.Formats
             }
         }
 
+        [TestCase(3, true)]
+        [TestCase(6, false)]
+        [TestCase(LegacyBeatmapDecoder.LATEST_VERSION, false)]
+        public void TestLegacyBeatmapReplayOffsetsDecode(int beatmapVersion, bool offsetApplied)
+        {
+            const double first_frame_time = 48;
+            const double second_frame_time = 65;
+
+            var decoder = new TestLegacyScoreDecoder(beatmapVersion);
+
+            using (var resourceStream = TestResources.OpenResource("Replays/mania-replay.osr"))
+            {
+                var score = decoder.Parse(resourceStream);
+
+                Assert.That(score.Replay.Frames[0].Time, Is.EqualTo(first_frame_time + (offsetApplied ? 24 : 0)));
+                Assert.That(score.Replay.Frames[1].Time, Is.EqualTo(second_frame_time + (offsetApplied ? 24 : 0)));
+            }
+        }
+
         [TestCase(3)]
         [TestCase(6)]
         [TestCase(LegacyBeatmapDecoder.LATEST_VERSION)]
-        public void TestLegacyBeatmapReplayOffsets(int beatmapVersion)
+        public void TestLegacyBeatmapReplayOffsetsEncodeDecode(int beatmapVersion)
         {
             const double first_frame_time = 2000;
             const double second_frame_time = 3000;

From a7554dcdf77637543960f712cbbcb521fc3f410b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 24 Mar 2022 16:43:41 +0900
Subject: [PATCH 3694/5547] Use a constant for the early version timing offset

---
 osu.Game.Tests/Beatmaps/Formats/LegacyScoreDecoderTest.cs | 4 ++--
 osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs         | 8 ++++++--
 osu.Game/Scoring/Legacy/LegacyScoreDecoder.cs             | 3 +--
 osu.Game/Scoring/Legacy/LegacyScoreEncoder.cs             | 8 ++++----
 4 files changed, 13 insertions(+), 10 deletions(-)

diff --git a/osu.Game.Tests/Beatmaps/Formats/LegacyScoreDecoderTest.cs b/osu.Game.Tests/Beatmaps/Formats/LegacyScoreDecoderTest.cs
index 39586bcd8c..1cd910789f 100644
--- a/osu.Game.Tests/Beatmaps/Formats/LegacyScoreDecoderTest.cs
+++ b/osu.Game.Tests/Beatmaps/Formats/LegacyScoreDecoderTest.cs
@@ -79,8 +79,8 @@ namespace osu.Game.Tests.Beatmaps.Formats
             {
                 var score = decoder.Parse(resourceStream);
 
-                Assert.That(score.Replay.Frames[0].Time, Is.EqualTo(first_frame_time + (offsetApplied ? 24 : 0)));
-                Assert.That(score.Replay.Frames[1].Time, Is.EqualTo(second_frame_time + (offsetApplied ? 24 : 0)));
+                Assert.That(score.Replay.Frames[0].Time, Is.EqualTo(first_frame_time + (offsetApplied ? LegacyBeatmapDecoder.EARLY_VERSION_TIMING_OFFSET : 0)));
+                Assert.That(score.Replay.Frames[1].Time, Is.EqualTo(second_frame_time + (offsetApplied ? LegacyBeatmapDecoder.EARLY_VERSION_TIMING_OFFSET : 0)));
             }
         }
 
diff --git a/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs b/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
index e2a043490f..79d8bd3bb3 100644
--- a/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
+++ b/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
@@ -19,6 +19,11 @@ namespace osu.Game.Beatmaps.Formats
 {
     public class LegacyBeatmapDecoder : LegacyDecoder<Beatmap>
     {
+        /// <summary>
+        /// An offset which needs to be applied to old beatmaps (v4 and lower) to correct timing changes that were applied at a game client level.
+        /// </summary>
+        public const int EARLY_VERSION_TIMING_OFFSET = 24;
+
         internal static RulesetStore RulesetStore;
 
         private Beatmap beatmap;
@@ -50,8 +55,7 @@ namespace osu.Game.Beatmaps.Formats
                 RulesetStore = new AssemblyRulesetStore();
             }
 
-            // BeatmapVersion 4 and lower had an incorrect offset (stable has this set as 24ms off)
-            offset = FormatVersion < 5 ? 24 : 0;
+            offset = FormatVersion < 5 ? EARLY_VERSION_TIMING_OFFSET : 0;
         }
 
         protected override Beatmap CreateTemplateObject()
diff --git a/osu.Game/Scoring/Legacy/LegacyScoreDecoder.cs b/osu.Game/Scoring/Legacy/LegacyScoreDecoder.cs
index 9885fe5528..754ace82c5 100644
--- a/osu.Game/Scoring/Legacy/LegacyScoreDecoder.cs
+++ b/osu.Game/Scoring/Legacy/LegacyScoreDecoder.cs
@@ -74,9 +74,8 @@ namespace osu.Game.Scoring.Legacy
                 currentBeatmap = workingBeatmap.GetPlayableBeatmap(currentRuleset.RulesetInfo, scoreInfo.Mods);
                 scoreInfo.BeatmapInfo = currentBeatmap.BeatmapInfo;
 
-                // BeatmapVersion 4 and lower had an incorrect offset (stable has this set as 24ms off)
                 // As this is baked into hitobject timing (see `LegacyBeatmapDecoder`) we also need to apply this to replay frame timing.
-                beatmapOffset = currentBeatmap.BeatmapInfo.BeatmapVersion < 5 ? 24 : 0;
+                beatmapOffset = currentBeatmap.BeatmapInfo.BeatmapVersion < 5 ? LegacyBeatmapDecoder.EARLY_VERSION_TIMING_OFFSET : 0;
 
                 /* score.HpGraphString = */
                 sr.ReadString();
diff --git a/osu.Game/Scoring/Legacy/LegacyScoreEncoder.cs b/osu.Game/Scoring/Legacy/LegacyScoreEncoder.cs
index 6a321bed7a..ae9afbf32e 100644
--- a/osu.Game/Scoring/Legacy/LegacyScoreEncoder.cs
+++ b/osu.Game/Scoring/Legacy/LegacyScoreEncoder.cs
@@ -1,12 +1,15 @@
 // 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 enable
+
 using System;
 using System.IO;
 using System.Linq;
 using System.Text;
 using osu.Framework.Extensions;
 using osu.Game.Beatmaps;
+using osu.Game.Beatmaps.Formats;
 using osu.Game.Extensions;
 using osu.Game.IO.Legacy;
 using osu.Game.Replays.Legacy;
@@ -14,8 +17,6 @@ using osu.Game.Rulesets.Replays;
 using osu.Game.Rulesets.Replays.Types;
 using SharpCompress.Compressors.LZMA;
 
-#nullable enable
-
 namespace osu.Game.Scoring.Legacy
 {
     public class LegacyScoreEncoder
@@ -111,9 +112,8 @@ namespace osu.Game.Scoring.Legacy
             {
                 StringBuilder replayData = new StringBuilder();
 
-                // BeatmapVersion 4 and lower had an incorrect offset (stable has this set as 24ms off)
                 // As this is baked into hitobject timing (see `LegacyBeatmapDecoder`) we also need to apply this to replay frame timing.
-                double offset = beatmap?.BeatmapInfo.BeatmapVersion < 5 ? -24 : 0;
+                double offset = beatmap?.BeatmapInfo.BeatmapVersion < 5 ? -LegacyBeatmapDecoder.EARLY_VERSION_TIMING_OFFSET : 0;
 
                 if (score.Replay != null)
                 {

From d6fc53579eb0d7d5d3eed86575006b8820d9135e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 24 Mar 2022 17:00:49 +0900
Subject: [PATCH 3695/5547] Split out shared code for encode-decode cycle (and
 remove unrelated culture set)

---
 .../Formats/LegacyScoreDecoderTest.cs         | 38 ++++++++-----------
 1 file changed, 16 insertions(+), 22 deletions(-)

diff --git a/osu.Game.Tests/Beatmaps/Formats/LegacyScoreDecoderTest.cs b/osu.Game.Tests/Beatmaps/Formats/LegacyScoreDecoderTest.cs
index 1cd910789f..1474f2d277 100644
--- a/osu.Game.Tests/Beatmaps/Formats/LegacyScoreDecoderTest.cs
+++ b/osu.Game.Tests/Beatmaps/Formats/LegacyScoreDecoderTest.cs
@@ -115,19 +115,7 @@ namespace osu.Game.Tests.Beatmaps.Formats
                 }
             };
 
-            // the "se" culture is used here, as it encodes the negative number sign as U+2212 MINUS SIGN,
-            // rather than the classic ASCII U+002D HYPHEN-MINUS.
-            CultureInfo.CurrentCulture = new CultureInfo("se");
-
-            var encodeStream = new MemoryStream();
-
-            var encoder = new LegacyScoreEncoder(score, beatmap);
-            encoder.Encode(encodeStream);
-
-            var decodeStream = new MemoryStream(encodeStream.GetBuffer());
-
-            var decoder = new TestLegacyScoreDecoder(beatmapVersion);
-            var decodedAfterEncode = decoder.Parse(decodeStream);
+            var decodedAfterEncode = encodeThenDecode(beatmapVersion, score, beatmap);
 
             Assert.That(decodedAfterEncode.Replay.Frames[0].Time, Is.EqualTo(first_frame_time));
             Assert.That(decodedAfterEncode.Replay.Frames[1].Time, Is.EqualTo(second_frame_time));
@@ -155,15 +143,7 @@ namespace osu.Game.Tests.Beatmaps.Formats
             // rather than the classic ASCII U+002D HYPHEN-MINUS.
             CultureInfo.CurrentCulture = new CultureInfo("se");
 
-            var encodeStream = new MemoryStream();
-
-            var encoder = new LegacyScoreEncoder(score, beatmap);
-            encoder.Encode(encodeStream);
-
-            var decodeStream = new MemoryStream(encodeStream.GetBuffer());
-
-            var decoder = new TestLegacyScoreDecoder();
-            var decodedAfterEncode = decoder.Parse(decodeStream);
+            var decodedAfterEncode = encodeThenDecode(LegacyBeatmapDecoder.LATEST_VERSION, score, beatmap);
 
             Assert.Multiple(() =>
             {
@@ -179,6 +159,20 @@ namespace osu.Game.Tests.Beatmaps.Formats
             });
         }
 
+        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 TestLegacyScoreDecoder(beatmapVersion);
+            var decodedAfterEncode = decoder.Parse(decodeStream);
+            return decodedAfterEncode;
+        }
+
         [TearDown]
         public void TearDown()
         {

From 528ffea38db1b368b49a5c203fb744d33cbb6568 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 24 Mar 2022 17:11:08 +0900
Subject: [PATCH 3696/5547] Fix incorrect event binding

---
 .../OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs  | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
index 6ff717d5c3..746e4257f1 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
@@ -31,7 +31,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
         {
             base.LoadComplete();
 
-            multiplayerClient.RoomUpdated += () => Scheduler.AddOnce(onRoomUpdated);
+            multiplayerClient.RoomUpdated += onRoomUpdated;
             onRoomUpdated();
         }
 
@@ -39,7 +39,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
         private DateTimeOffset countdownReceivedTime;
         private ScheduledDelegate countdownUpdateDelegate;
 
-        private void onRoomUpdated()
+        private void onRoomUpdated() => Scheduler.AddOnce(() =>
         {
             if (countdown == null && room?.Countdown != null)
                 countdownReceivedTime = DateTimeOffset.Now;
@@ -56,7 +56,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
 
             updateButtonText();
             updateButtonColour();
-        }
+        });
 
         private void updateButtonText()
         {

From e3f8bc05883e126e176d6b12e54e0df39c85003a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 24 Mar 2022 17:14:51 +0900
Subject: [PATCH 3697/5547] Revert `Availability` to `private`

---
 .../Screens/OnlinePlay/Components/ReadyButton.cs     | 12 +++++++-----
 1 file changed, 7 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Components/ReadyButton.cs b/osu.Game/Screens/OnlinePlay/Components/ReadyButton.cs
index 79cf5c7236..cdaa39d2be 100644
--- a/osu.Game/Screens/OnlinePlay/Components/ReadyButton.cs
+++ b/osu.Game/Screens/OnlinePlay/Components/ReadyButton.cs
@@ -14,18 +14,20 @@ namespace osu.Game.Screens.OnlinePlay.Components
     public abstract class ReadyButton : TriangleButton, IHasTooltip
     {
         public new readonly BindableBool Enabled = new BindableBool();
-        protected readonly IBindable<BeatmapAvailability> Availability = new Bindable<BeatmapAvailability>();
+
+        private readonly IBindable<BeatmapAvailability> availability = new Bindable<BeatmapAvailability>();
 
         [BackgroundDependencyLoader]
         private void load(OnlinePlayBeatmapAvailabilityTracker beatmapTracker)
         {
-            Availability.BindTo(beatmapTracker.Availability);
-            Availability.BindValueChanged(_ => updateState());
+            availability.BindTo(beatmapTracker.Availability);
+
+            availability.BindValueChanged(_ => updateState());
             Enabled.BindValueChanged(_ => updateState(), true);
         }
 
         private void updateState() =>
-            base.Enabled.Value = Availability.Value.State == DownloadState.LocallyAvailable && Enabled.Value;
+            base.Enabled.Value = availability.Value.State == DownloadState.LocallyAvailable && Enabled.Value;
 
         public virtual LocalisableString TooltipText
         {
@@ -34,7 +36,7 @@ namespace osu.Game.Screens.OnlinePlay.Components
                 if (Enabled.Value)
                     return string.Empty;
 
-                if (Availability.Value.State != DownloadState.LocallyAvailable)
+                if (availability.Value.State != DownloadState.LocallyAvailable)
                     return "Beatmap not downloaded";
 
                 return string.Empty;

From e889d9344159d6c38641d6eaae56c4ab957a34d5 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 24 Mar 2022 17:47:58 +0900
Subject: [PATCH 3698/5547] Add asserts of playlist being non-empty after
 client operations

---
 osu.Game/Online/Multiplayer/MultiplayerClient.cs | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/osu.Game/Online/Multiplayer/MultiplayerClient.cs b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
index 2d5496c5c1..faa995ed19 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
@@ -171,6 +171,8 @@ namespace osu.Game.Online.Multiplayer
                     Room = joinedRoom;
                     APIRoom = room;
 
+                    Debug.Assert(joinedRoom.Playlist.Count > 0);
+
                     APIRoom.Playlist.Clear();
                     APIRoom.Playlist.AddRange(joinedRoom.Playlist.Select(createPlaylistItem));
 
@@ -683,6 +685,8 @@ namespace osu.Game.Online.Multiplayer
                 Room.Playlist.Remove(Room.Playlist.Single(existing => existing.ID == playlistItemId));
                 APIRoom.Playlist.RemoveAll(existing => existing.ID == playlistItemId);
 
+                Debug.Assert(Room.Playlist.Count > 0);
+
                 ItemRemoved?.Invoke(playlistItemId);
                 RoomUpdated?.Invoke();
             });

From 2d58feebb1ff4050f522caeb053ce4ca819cdfb7 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 24 Mar 2022 17:54:21 +0900
Subject: [PATCH 3699/5547] Guard against potential null `CurrentItem` in
 `ParticipantPanel`

---
 .../OnlinePlay/Multiplayer/Participants/ParticipantPanel.cs     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantPanel.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantPanel.cs
index 96a665f33d..128b9a1640 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantPanel.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantPanel.cs
@@ -189,7 +189,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Participants
             var currentItem = Playlist.GetCurrentItem();
             Debug.Assert(currentItem != null);
 
-            var ruleset = rulesets.GetRuleset(currentItem.RulesetID)?.CreateInstance();
+            var ruleset = currentItem != null ? rulesets.GetRuleset(currentItem.RulesetID)?.CreateInstance() : null;
 
             int? currentModeRank = ruleset != null ? User.User?.RulesetsStatistics?.GetValueOrDefault(ruleset.ShortName)?.GlobalRank : null;
             userRankText.Text = currentModeRank != null ? $"#{currentModeRank.Value:N0}" : string.Empty;

From ea9de0199d98ad4b4cfc654dba90af780eb96e88 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 24 Mar 2022 20:09:32 +0900
Subject: [PATCH 3700/5547] Split countdown start into separate method

---
 .../Multiplayer/TestMultiplayerClient.cs      | 106 +++++++++---------
 1 file changed, 55 insertions(+), 51 deletions(-)

diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
index 9be1b18062..16da64c61e 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
@@ -315,57 +315,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             switch (request)
             {
                 case StartMatchCountdownRequest matchCountdownRequest:
-                    Debug.Assert(ThreadSafety.IsUpdateThread);
-
-                    countdownStopSource?.Cancel();
-
-                    // Note that this will leak CTSs, however this is a test method and we haven't noticed foregoing disposal of non-linked CTSs to be detrimental.
-                    // If necessary, this can be moved into the final schedule below, and the class-level fields be nulled out accordingly.
-                    var stopSource = countdownStopSource = new CancellationTokenSource();
-                    var skipSource = countdownSkipSource = new CancellationTokenSource();
-                    var countdown = new MatchStartCountdown { TimeRemaining = matchCountdownRequest.Duration };
-
-                    Task lastCountdownTask = countdownTask;
-                    countdownTask = start();
-
-                    async Task start()
-                    {
-                        await lastCountdownTask;
-
-                        Schedule(() =>
-                        {
-                            if (stopSource.IsCancellationRequested)
-                                return;
-
-                            Room.Countdown = countdown;
-                            MatchEvent(new CountdownChangedEvent { Countdown = countdown });
-                        });
-
-                        try
-                        {
-                            using (var cancellationSource = CancellationTokenSource.CreateLinkedTokenSource(stopSource.Token, skipSource.Token))
-                                await Task.Delay(matchCountdownRequest.Duration, cancellationSource.Token).ConfigureAwait(false);
-                        }
-                        catch (OperationCanceledException)
-                        {
-                            // Clients need to be notified of cancellations in the following code.
-                        }
-
-                        Schedule(() =>
-                        {
-                            if (Room.Countdown != countdown)
-                                return;
-
-                            Room.Countdown = null;
-                            MatchEvent(new CountdownChangedEvent { Countdown = null });
-
-                            if (stopSource.IsCancellationRequested)
-                                return;
-
-                            StartMatch().WaitSafely();
-                        });
-                    }
-
+                    startCountdown(new MatchStartCountdown { TimeRemaining = matchCountdownRequest.Duration }, StartMatch);
                     break;
 
                 case StopCountdownRequest _:
@@ -393,6 +343,60 @@ namespace osu.Game.Tests.Visual.Multiplayer
             }
         }
 
+        private void startCountdown(MultiplayerCountdown countdown, Func<Task> continuation)
+        {
+            Debug.Assert(Room != null);
+            Debug.Assert(ThreadSafety.IsUpdateThread);
+
+            countdownStopSource?.Cancel();
+
+            // Note that this will leak CTSs, however this is a test method and we haven't noticed foregoing disposal of non-linked CTSs to be detrimental.
+            // If necessary, this can be moved into the final schedule below, and the class-level fields be nulled out accordingly.
+            var stopSource = countdownStopSource = new CancellationTokenSource();
+            var skipSource = countdownSkipSource = new CancellationTokenSource();
+
+            Task lastCountdownTask = countdownTask;
+            countdownTask = start();
+
+            async Task start()
+            {
+                await lastCountdownTask;
+
+                Schedule(() =>
+                {
+                    if (stopSource.IsCancellationRequested)
+                        return;
+
+                    Room.Countdown = countdown;
+                    MatchEvent(new CountdownChangedEvent { Countdown = countdown });
+                });
+
+                try
+                {
+                    using (var cancellationSource = CancellationTokenSource.CreateLinkedTokenSource(stopSource.Token, skipSource.Token))
+                        await Task.Delay(countdown.TimeRemaining, cancellationSource.Token).ConfigureAwait(false);
+                }
+                catch (OperationCanceledException)
+                {
+                    // Clients need to be notified of cancellations in the following code.
+                }
+
+                Schedule(() =>
+                {
+                    if (Room.Countdown != countdown)
+                        return;
+
+                    Room.Countdown = null;
+                    MatchEvent(new CountdownChangedEvent { Countdown = null });
+
+                    if (stopSource.IsCancellationRequested)
+                        return;
+
+                    continuation().WaitSafely();
+                });
+            }
+        }
+
         public override Task StartMatch()
         {
             Debug.Assert(Room != null);

From 209de886ce3677482a57066efe76d312bc8813ce Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 24 Mar 2022 20:13:58 +0900
Subject: [PATCH 3701/5547] Add method to stop countdown

---
 .../Tests/Visual/Multiplayer/TestMultiplayerClient.cs | 11 +++++------
 1 file changed, 5 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
index 16da64c61e..ef5936198b 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
@@ -132,7 +132,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                         shouldStopCountdown |= Room.Host?.State != MultiplayerUserState.Ready && Room.Host?.State != MultiplayerUserState.Spectating;
 
                         if (shouldStopCountdown)
-                            countdownStopSource?.Cancel();
+                            stopCountdown();
                         break;
 
                     case MultiplayerRoomState.WaitingForLoad:
@@ -319,10 +319,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     break;
 
                 case StopCountdownRequest _:
-                    countdownStopSource?.Cancel();
-
-                    Room.Countdown = null;
-                    await MatchEvent(new CountdownChangedEvent { Countdown = Room.Countdown });
+                    stopCountdown();
                     break;
 
                 case ChangeTeamRequest changeTeam:
@@ -348,7 +345,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             Debug.Assert(Room != null);
             Debug.Assert(ThreadSafety.IsUpdateThread);
 
-            countdownStopSource?.Cancel();
+            stopCountdown();
 
             // Note that this will leak CTSs, however this is a test method and we haven't noticed foregoing disposal of non-linked CTSs to be detrimental.
             // If necessary, this can be moved into the final schedule below, and the class-level fields be nulled out accordingly.
@@ -397,6 +394,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
             }
         }
 
+        private void stopCountdown() => countdownStopSource?.Cancel();
+
         public override Task StartMatch()
         {
             Debug.Assert(Room != null);

From 5fe46a73cb5e075db8a1b330923011989b5404af Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 24 Mar 2022 20:16:43 +0900
Subject: [PATCH 3702/5547] Update room state in more situations

---
 .../Tests/Visual/Multiplayer/TestMultiplayerClient.cs    | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
index ef5936198b..5c16c189d6 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
@@ -119,6 +119,12 @@ namespace osu.Game.Tests.Visual.Multiplayer
             Debug.Assert(Room != null);
 
             ((IMultiplayerClient)this).UserStateChanged(userId, newState);
+            updateRoomStateIfRequired();
+        }
+
+        private void updateRoomStateIfRequired()
+        {
+            Debug.Assert(Room != null);
 
             Schedule(() =>
             {
@@ -263,6 +269,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 ChangeUserState(user.UserID, MultiplayerUserState.Idle);
 
             await changeMatchType(settings.MatchType).ConfigureAwait(false);
+            updateRoomStateIfRequired();
         }
 
         public override Task ChangeState(MultiplayerUserState newState)
@@ -430,6 +437,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             await addItem(item).ConfigureAwait(false);
             await updateCurrentItem(Room).ConfigureAwait(false);
+            updateRoomStateIfRequired();
         }
 
         public override Task AddPlaylistItem(MultiplayerPlaylistItem item) => AddUserPlaylistItem(api.LocalUser.Value.OnlineID, item);
@@ -486,6 +494,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             await ((IMultiplayerClient)this).PlaylistItemRemoved(playlistItemId).ConfigureAwait(false);
 
             await updateCurrentItem(Room).ConfigureAwait(false);
+            updateRoomStateIfRequired();
         }
 
         public override Task RemovePlaylistItem(long playlistItemId) => RemoveUserPlaylistItem(api.LocalUser.Value.OnlineID, playlistItemId);

From f80692f342f703dd7f998bab4e7ad531362e4f37 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 24 Mar 2022 20:19:05 +0900
Subject: [PATCH 3703/5547] Add missing TestMultiplayerClient coverage

---
 .../Multiplayer/TestMultiplayerClient.cs      | 26 +++++++++++++++----
 1 file changed, 21 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
index 5c16c189d6..7b3e8ac3fe 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
@@ -125,6 +125,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         private void updateRoomStateIfRequired()
         {
             Debug.Assert(Room != null);
+            Debug.Assert(APIRoom != null);
 
             Schedule(() =>
             {
@@ -132,13 +133,28 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 {
                     case MultiplayerRoomState.Open:
                         // If there are no remaining ready users or the host is not ready, stop any existing countdown.
-                        // Todo: When we have an "automatic start" mode, this should also start a new countdown if any users _are_ ready.
                         // Todo: This doesn't yet support non-match-start countdowns.
-                        bool shouldStopCountdown = Room.Users.All(u => u.State != MultiplayerUserState.Ready);
-                        shouldStopCountdown |= Room.Host?.State != MultiplayerUserState.Ready && Room.Host?.State != MultiplayerUserState.Spectating;
+                        if (Room.Settings.AutoStartDuration != TimeSpan.Zero)
+                        {
+                            bool shouldHaveCountdown = !APIRoom.Playlist.GetCurrentItem()!.Expired && Room.Users.Any(u => u.State == MultiplayerUserState.Ready);
+
+                            if (shouldHaveCountdown)
+                            {
+                                if (Room.Countdown == null)
+                                    startCountdown(new MatchStartCountdown { TimeRemaining = Room.Settings.AutoStartDuration }, StartMatch);
+                            }
+                            else
+                                stopCountdown();
+                        }
+                        else
+                        {
+                            bool shouldStopCountdown = Room.Users.All(u => u.State != MultiplayerUserState.Ready);
+                            shouldStopCountdown |= Room.Host?.State != MultiplayerUserState.Ready && Room.Host?.State != MultiplayerUserState.Spectating;
+
+                            if (shouldStopCountdown)
+                                stopCountdown();
+                        }
 
-                        if (shouldStopCountdown)
-                            stopCountdown();
                         break;
 
                     case MultiplayerRoomState.WaitingForLoad:

From 0d88af19ae1c0f726aa6a68b6b0e29bcc53e4dd5 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 24 Mar 2022 20:23:58 +0900
Subject: [PATCH 3704/5547] Fix local setting not being updated

---
 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 de17c012eb..2f328a9339 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
@@ -744,6 +744,7 @@ namespace osu.Game.Online.Multiplayer
             APIRoom.Password.Value = Room.Settings.Password;
             APIRoom.Type.Value = Room.Settings.MatchType;
             APIRoom.QueueMode.Value = Room.Settings.QueueMode;
+            APIRoom.AutoStartDuration.Value = Room.Settings.AutoStartDuration;
 
             RoomUpdated?.Invoke();
         }

From d3a957d64e154410da41203875c3a243d0a505ab Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 24 Mar 2022 20:24:09 +0900
Subject: [PATCH 3705/5547] Fix test client not receiving initial value

---
 osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
index 7b3e8ac3fe..a4c63d762e 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
@@ -226,7 +226,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     Name = apiRoom.Name.Value,
                     MatchType = apiRoom.Type.Value,
                     Password = password,
-                    QueueMode = apiRoom.QueueMode.Value
+                    QueueMode = apiRoom.QueueMode.Value,
+                    AutoStartDuration = apiRoom.AutoStartDuration.Value
                 },
                 Playlist = serverSidePlaylist.ToList(),
                 Users = { localUser },

From 1abf3f7bf48515d6f910a09387c021d58eb962ee Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 24 Mar 2022 20:25:17 +0900
Subject: [PATCH 3706/5547] Fix cancel tooltip showing for autostart countdowns

---
 .../OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs      | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
index 746e4257f1..79d974fd3a 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
@@ -168,7 +168,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
         {
             get
             {
-                if (room?.Countdown != null && multiplayerClient.IsHost && multiplayerClient.LocalUser?.State == MultiplayerUserState.Ready)
+                if (room?.Countdown != null && multiplayerClient.IsHost && multiplayerClient.LocalUser?.State == MultiplayerUserState.Ready && room.Settings.AutoStartDuration == TimeSpan.Zero)
                     return "Cancel countdown";
 
                 return base.TooltipText;

From 2938f44e6c0307293b4b2f32c26d7f352a5dfe4b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 24 Mar 2022 23:40:46 +0900
Subject: [PATCH 3707/5547] Update `PresentExternally` usages in line with
 framework changes

---
 osu.Game.Tournament/Screens/Setup/TournamentSwitcher.cs       | 2 +-
 osu.Game/IO/WrappedStorage.cs                                 | 4 ++--
 osu.Game/Overlays/Settings/Sections/General/UpdateSettings.cs | 2 +-
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Tournament/Screens/Setup/TournamentSwitcher.cs b/osu.Game.Tournament/Screens/Setup/TournamentSwitcher.cs
index 93cfa9634e..f0aa857769 100644
--- a/osu.Game.Tournament/Screens/Setup/TournamentSwitcher.cs
+++ b/osu.Game.Tournament/Screens/Setup/TournamentSwitcher.cs
@@ -26,7 +26,7 @@ namespace osu.Game.Tournament.Screens.Setup
             dropdown.Current.BindValueChanged(v => Button.Enabled.Value = v.NewValue != startupTournament, true);
 
             Action = () => game.GracefullyExit();
-            folderButton.Action = storage.PresentExternally;
+            folderButton.Action = () => storage.PresentExternally();
 
             ButtonText = "Close osu!";
         }
diff --git a/osu.Game/IO/WrappedStorage.cs b/osu.Game/IO/WrappedStorage.cs
index 6f0f898de3..a6605de1d2 100644
--- a/osu.Game/IO/WrappedStorage.cs
+++ b/osu.Game/IO/WrappedStorage.cs
@@ -70,9 +70,9 @@ namespace osu.Game.IO
         public override Stream GetStream(string path, FileAccess access = FileAccess.Read, FileMode mode = FileMode.OpenOrCreate) =>
             UnderlyingStorage.GetStream(MutatePath(path), access, mode);
 
-        public override void OpenFileExternally(string filename) => UnderlyingStorage.OpenFileExternally(MutatePath(filename));
+        public override bool OpenFileExternally(string filename) => UnderlyingStorage.OpenFileExternally(MutatePath(filename));
 
-        public override void PresentFileExternally(string filename) => UnderlyingStorage.PresentFileExternally(MutatePath(filename));
+        public override bool PresentFileExternally(string filename) => UnderlyingStorage.PresentFileExternally(MutatePath(filename));
 
         public override Storage GetStorageForDirectory(string path)
         {
diff --git a/osu.Game/Overlays/Settings/Sections/General/UpdateSettings.cs b/osu.Game/Overlays/Settings/Sections/General/UpdateSettings.cs
index 158d8811b5..0b4eca6379 100644
--- a/osu.Game/Overlays/Settings/Sections/General/UpdateSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/General/UpdateSettings.cs
@@ -68,7 +68,7 @@ namespace osu.Game.Overlays.Settings.Sections.General
                 Add(new SettingsButton
                 {
                     Text = GeneralSettingsStrings.OpenOsuFolder,
-                    Action = storage.PresentExternally,
+                    Action = () => storage.PresentExternally(),
                 });
 
                 Add(new SettingsButton

From b04ca111c6b4f526dc38f172e81275fc7641db3b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 24 Mar 2022 22:28:26 +0900
Subject: [PATCH 3708/5547] Allow realm subscriptions to be initiated from a
 non-update thread

---
 osu.Game/Database/RealmAccess.cs | 30 +++++++++++++++++-------------
 osu.Game/OsuGameBase.cs          |  2 +-
 2 files changed, 18 insertions(+), 14 deletions(-)

diff --git a/osu.Game/Database/RealmAccess.cs b/osu.Game/Database/RealmAccess.cs
index f0d4011ab8..8574002436 100644
--- a/osu.Game/Database/RealmAccess.cs
+++ b/osu.Game/Database/RealmAccess.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.
 
+#nullable enable
+
 using System;
 using System.Collections.Generic;
 using System.ComponentModel;
@@ -17,6 +19,7 @@ using osu.Framework.Input.Bindings;
 using osu.Framework.Logging;
 using osu.Framework.Platform;
 using osu.Framework.Statistics;
+using osu.Framework.Threading;
 using osu.Game.Beatmaps;
 using osu.Game.Configuration;
 using osu.Game.Input.Bindings;
@@ -28,8 +31,6 @@ using osu.Game.Stores;
 using Realms;
 using Realms.Exceptions;
 
-#nullable enable
-
 namespace osu.Game.Database
 {
     /// <summary>
@@ -46,6 +47,8 @@ namespace osu.Game.Database
 
         private readonly IDatabaseContextFactory? efContextFactory;
 
+        private readonly SynchronizationContext? updateThreadSyncContext;
+
         /// <summary>
         /// Version history:
         /// 6    ~2021-10-18   First tracked version.
@@ -143,12 +146,15 @@ namespace osu.Game.Database
         /// </summary>
         /// <param name="storage">The game storage which will be used to create the realm backing file.</param>
         /// <param name="filename">The filename to use for the realm backing file. A ".realm" extension will be added automatically if not specified.</param>
+        /// <param name="updateThread">The game update thread, used to post realm operations into a thread-safe context.</param>
         /// <param name="efContextFactory">An EF factory used only for migration purposes.</param>
-        public RealmAccess(Storage storage, string filename, IDatabaseContextFactory? efContextFactory = null)
+        public RealmAccess(Storage storage, string filename, GameThread? updateThread = null, IDatabaseContextFactory? efContextFactory = null)
         {
             this.storage = storage;
             this.efContextFactory = efContextFactory;
 
+            updateThreadSyncContext = updateThread?.SynchronizationContext ?? SynchronizationContext.Current;
+
             Filename = filename;
 
             if (!Filename.EndsWith(realm_extension, StringComparison.Ordinal))
@@ -379,9 +385,6 @@ namespace osu.Game.Database
         public IDisposable RegisterForNotifications<T>(Func<Realm, IQueryable<T>> query, NotificationCallbackDelegate<T> callback)
             where T : RealmObjectBase
         {
-            if (!ThreadSafety.IsUpdateThread)
-                throw new InvalidOperationException(@$"{nameof(RegisterForNotifications)} must be called from the update thread.");
-
             lock (realmLock)
             {
                 Func<Realm, IDisposable?> action = realm => query(realm).QueryAsyncWithNotifications(callback);
@@ -459,23 +462,24 @@ namespace osu.Game.Database
         /// <returns>An <see cref="IDisposable"/> which should be disposed to unsubscribe any inner subscription.</returns>
         public IDisposable RegisterCustomSubscription(Func<Realm, IDisposable?> action)
         {
-            if (!ThreadSafety.IsUpdateThread)
-                throw new InvalidOperationException(@$"{nameof(RegisterForNotifications)} must be called from the update thread.");
-
-            var syncContext = SynchronizationContext.Current;
+            if (updateThreadSyncContext == null)
+                throw new InvalidOperationException("Attempted to register a realm subscription before update thread registration.");
 
             total_subscriptions.Value++;
 
-            registerSubscription(action);
+            if (ThreadSafety.IsUpdateThread)
+                updateThreadSyncContext.Send(_ => registerSubscription(action), null);
+            else
+                updateThreadSyncContext.Post(_ => registerSubscription(action), null);
 
             // This token is returned to the consumer.
             // When disposed, it will cause the registration to be permanently ceased (unsubscribed with realm and unregistered by this class).
             return new InvokeOnDisposal(() =>
             {
                 if (ThreadSafety.IsUpdateThread)
-                    syncContext.Send(_ => unsubscribe(), null);
+                    updateThreadSyncContext.Send(_ => unsubscribe(), null);
                 else
-                    syncContext.Post(_ => unsubscribe(), null);
+                    updateThreadSyncContext.Post(_ => unsubscribe(), null);
 
                 void unsubscribe()
                 {
diff --git a/osu.Game/OsuGameBase.cs b/osu.Game/OsuGameBase.cs
index 5468db348e..7b9aca4086 100644
--- a/osu.Game/OsuGameBase.cs
+++ b/osu.Game/OsuGameBase.cs
@@ -200,7 +200,7 @@ namespace osu.Game
             if (Storage.Exists(DatabaseContextFactory.DATABASE_NAME))
                 dependencies.Cache(EFContextFactory = new DatabaseContextFactory(Storage));
 
-            dependencies.Cache(realm = new RealmAccess(Storage, "client", EFContextFactory));
+            dependencies.Cache(realm = new RealmAccess(Storage, "client", Host.UpdateThread, EFContextFactory));
 
             dependencies.CacheAs<RulesetStore>(RulesetStore = new RealmRulesetStore(realm, Storage));
             dependencies.CacheAs<IRulesetStore>(RulesetStore);

From 878e8d21a3925bd4fc1cf4339ca6b346643bbac8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 24 Mar 2022 21:51:10 +0100
Subject: [PATCH 3709/5547] Remove assertion to fix "expression always true"
 inspection

---
 .../OnlinePlay/Multiplayer/Participants/ParticipantPanel.cs    | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantPanel.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantPanel.cs
index 128b9a1640..70f4030b79 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantPanel.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantPanel.cs
@@ -2,7 +2,6 @@
 // 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.Extensions.Color4Extensions;
@@ -187,8 +186,6 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Participants
             const double fade_time = 50;
 
             var currentItem = Playlist.GetCurrentItem();
-            Debug.Assert(currentItem != null);
-
             var ruleset = currentItem != null ? rulesets.GetRuleset(currentItem.RulesetID)?.CreateInstance() : null;
 
             int? currentModeRank = ruleset != null ? User.User?.RulesetsStatistics?.GetValueOrDefault(ruleset.ShortName)?.GlobalRank : null;

From b4c0155b3d22f2115fc250ef3451db9e1b2fe273 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 25 Mar 2022 13:07:21 +0900
Subject: [PATCH 3710/5547] Update framework

---
 osu.Android.props        | 2 +-
 osu.Game/osu.Game.csproj | 2 +-
 osu.iOS.props            | 4 ++--
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Android.props b/osu.Android.props
index 1b5461959a..182495cd56 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -52,7 +52,7 @@
   </ItemGroup>
   <ItemGroup>
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.304.0" />
-    <PackageReference Include="ppy.osu.Framework.Android" Version="2022.314.0" />
+    <PackageReference Include="ppy.osu.Framework.Android" Version="2022.325.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
     <!-- Realm needs to be directly referenced in all Xamarin projects, as it will not pull in its transitive dependencies otherwise. -->
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 1c1deaae8e..4193dc8fa0 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="10.10.0" />
-    <PackageReference Include="ppy.osu.Framework" Version="2022.314.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2022.325.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.304.0" />
     <PackageReference Include="Sentry" Version="3.14.1" />
     <PackageReference Include="SharpCompress" Version="0.30.1" />
diff --git a/osu.iOS.props b/osu.iOS.props
index 23101c5af6..f97f15d091 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -61,7 +61,7 @@
     <Reference Include="System.Net.Http" />
   </ItemGroup>
   <ItemGroup Label="Package References">
-    <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.314.0" />
+    <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.325.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.304.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net6.0) -->
@@ -84,7 +84,7 @@
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="5.0.14" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.Core" Version="5.0.14" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
-    <PackageReference Include="ppy.osu.Framework" Version="2022.314.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2022.325.0" />
     <PackageReference Include="SharpCompress" Version="0.30.1" />
     <PackageReference Include="NUnit" Version="3.13.2" />
     <PackageReference Include="System.ComponentModel.Annotations" Version="5.0.0" />

From 09c5325b08bfa8bb9c993c3428b5d79e65c91ed2 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 25 Mar 2022 13:18:49 +0900
Subject: [PATCH 3711/5547] Update resources

---
 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 182495cd56..6a3b113fa2 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -51,7 +51,7 @@
     <Reference Include="Java.Interop" />
   </ItemGroup>
   <ItemGroup>
-    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.304.0" />
+    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.325.0" />
     <PackageReference Include="ppy.osu.Framework.Android" Version="2022.325.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 4193dc8fa0..3c01f29671 100644
--- a/osu.Game/osu.Game.csproj
+++ b/osu.Game/osu.Game.csproj
@@ -37,7 +37,7 @@
     </PackageReference>
     <PackageReference Include="Realm" Version="10.10.0" />
     <PackageReference Include="ppy.osu.Framework" Version="2022.325.0" />
-    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.304.0" />
+    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.325.0" />
     <PackageReference Include="Sentry" Version="3.14.1" />
     <PackageReference Include="SharpCompress" Version="0.30.1" />
     <PackageReference Include="NUnit" Version="3.13.2" />
diff --git a/osu.iOS.props b/osu.iOS.props
index f97f15d091..c8f170497d 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -62,7 +62,7 @@
   </ItemGroup>
   <ItemGroup Label="Package References">
     <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.325.0" />
-    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.304.0" />
+    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.325.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net6.0) -->
   <PropertyGroup>

From 816fcae3a182647781490aa3c817e93a1c223f47 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 25 Mar 2022 15:12:39 +0900
Subject: [PATCH 3712/5547] Rename `Button` to `MainMenuButton` to
 differentiate better

---
 osu.Game/Screens/Menu/ButtonSystem.cs         | 28 +++++++++----------
 .../Menu/{Button.cs => MainMenuButton.cs}     |  4 +--
 2 files changed, 16 insertions(+), 16 deletions(-)
 rename osu.Game/Screens/Menu/{Button.cs => MainMenuButton.cs} (97%)

diff --git a/osu.Game/Screens/Menu/ButtonSystem.cs b/osu.Game/Screens/Menu/ButtonSystem.cs
index b03425fef4..a1f0d22efc 100644
--- a/osu.Game/Screens/Menu/ButtonSystem.cs
+++ b/osu.Game/Screens/Menu/ButtonSystem.cs
@@ -79,10 +79,10 @@ namespace osu.Game.Screens.Menu
 
         private readonly ButtonArea buttonArea;
 
-        private readonly Button backButton;
+        private readonly MainMenuButton backButton;
 
-        private readonly List<Button> buttonsTopLevel = new List<Button>();
-        private readonly List<Button> buttonsPlay = new List<Button>();
+        private readonly List<MainMenuButton> buttonsTopLevel = new List<MainMenuButton>();
+        private readonly List<MainMenuButton> buttonsPlay = new List<MainMenuButton>();
 
         private Sample sampleBack;
 
@@ -100,8 +100,8 @@ namespace osu.Game.Screens.Menu
 
             buttonArea.AddRange(new Drawable[]
             {
-                new Button(ButtonSystemStrings.Settings, string.Empty, FontAwesome.Solid.Cog, new Color4(85, 85, 85, 255), () => OnSettings?.Invoke(), -WEDGE_WIDTH, Key.O),
-                backButton = new Button(ButtonSystemStrings.Back, @"button-back-select", OsuIcon.LeftCircle, new Color4(51, 58, 94, 255), () => State = ButtonSystemState.TopLevel, -WEDGE_WIDTH)
+                new MainMenuButton(ButtonSystemStrings.Settings, string.Empty, FontAwesome.Solid.Cog, new Color4(85, 85, 85, 255), () => OnSettings?.Invoke(), -WEDGE_WIDTH, Key.O),
+                backButton = new MainMenuButton(ButtonSystemStrings.Back, @"button-back-select", OsuIcon.LeftCircle, new Color4(51, 58, 94, 255), () => State = ButtonSystemState.TopLevel, -WEDGE_WIDTH)
                 {
                     VisibleState = ButtonSystemState.Play,
                 },
@@ -126,24 +126,24 @@ namespace osu.Game.Screens.Menu
         [BackgroundDependencyLoader(true)]
         private void load(AudioManager audio, IdleTracker idleTracker, GameHost host)
         {
-            buttonsPlay.Add(new Button(ButtonSystemStrings.Solo, @"button-solo-select", FontAwesome.Solid.User, new Color4(102, 68, 204, 255), () => OnSolo?.Invoke(), WEDGE_WIDTH, Key.P));
-            buttonsPlay.Add(new Button(ButtonSystemStrings.Multi, @"button-generic-select", FontAwesome.Solid.Users, new Color4(94, 63, 186, 255), onMultiplayer, 0, Key.M));
-            buttonsPlay.Add(new Button(ButtonSystemStrings.Playlists, @"button-generic-select", OsuIcon.Charts, new Color4(94, 63, 186, 255), onPlaylists, 0, Key.L));
+            buttonsPlay.Add(new MainMenuButton(ButtonSystemStrings.Solo, @"button-solo-select", FontAwesome.Solid.User, new Color4(102, 68, 204, 255), () => OnSolo?.Invoke(), WEDGE_WIDTH, Key.P));
+            buttonsPlay.Add(new MainMenuButton(ButtonSystemStrings.Multi, @"button-generic-select", FontAwesome.Solid.Users, new Color4(94, 63, 186, 255), onMultiplayer, 0, Key.M));
+            buttonsPlay.Add(new MainMenuButton(ButtonSystemStrings.Playlists, @"button-generic-select", OsuIcon.Charts, new Color4(94, 63, 186, 255), onPlaylists, 0, Key.L));
             buttonsPlay.ForEach(b => b.VisibleState = ButtonSystemState.Play);
 
-            buttonsTopLevel.Add(new Button(ButtonSystemStrings.Play, @"button-play-select", OsuIcon.Logo, new Color4(102, 68, 204, 255), () => State = ButtonSystemState.Play, WEDGE_WIDTH, Key.P));
-            buttonsTopLevel.Add(new Button(ButtonSystemStrings.Edit, @"button-edit-select", OsuIcon.EditCircle, new Color4(238, 170, 0, 255), () => OnEdit?.Invoke(), 0, Key.E));
-            buttonsTopLevel.Add(new Button(ButtonSystemStrings.Browse, @"button-direct-select", OsuIcon.ChevronDownCircle, new Color4(165, 204, 0, 255), () => OnBeatmapListing?.Invoke(), 0, Key.D));
+            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.Edit, @"button-edit-select", OsuIcon.EditCircle, new Color4(238, 170, 0, 255), () => OnEdit?.Invoke(), 0, Key.E));
+            buttonsTopLevel.Add(new MainMenuButton(ButtonSystemStrings.Browse, @"button-direct-select", OsuIcon.ChevronDownCircle, new Color4(165, 204, 0, 255), () => OnBeatmapListing?.Invoke(), 0, Key.D));
 
             if (host.CanExit)
-                buttonsTopLevel.Add(new Button(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(), 0, Key.Q));
 
             buttonArea.AddRange(buttonsPlay);
             buttonArea.AddRange(buttonsTopLevel);
 
             buttonArea.ForEach(b =>
             {
-                if (b is Button)
+                if (b is MainMenuButton)
                 {
                     b.Origin = Anchor.CentreLeft;
                     b.Anchor = Anchor.CentreLeft;
@@ -305,7 +305,7 @@ namespace osu.Game.Screens.Menu
                 {
                     buttonArea.ButtonSystemState = state;
 
-                    foreach (var b in buttonArea.Children.OfType<Button>())
+                    foreach (var b in buttonArea.Children.OfType<MainMenuButton>())
                         b.ButtonSystemState = state;
                 }
 
diff --git a/osu.Game/Screens/Menu/Button.cs b/osu.Game/Screens/Menu/MainMenuButton.cs
similarity index 97%
rename from osu.Game/Screens/Menu/Button.cs
rename to osu.Game/Screens/Menu/MainMenuButton.cs
index 26f26d1304..1014249531 100644
--- a/osu.Game/Screens/Menu/Button.cs
+++ b/osu.Game/Screens/Menu/MainMenuButton.cs
@@ -28,7 +28,7 @@ namespace osu.Game.Screens.Menu
     /// Button designed specifically for the osu!next main menu.
     /// In order to correctly flow, we have to use a negative margin on the parent container (due to the parallelogram shape).
     /// </summary>
-    public class Button : BeatSyncedContainer, IStateful<ButtonState>
+    public class MainMenuButton : BeatSyncedContainer, IStateful<ButtonState>
     {
         public event Action<ButtonState> StateChanged;
 
@@ -51,7 +51,7 @@ namespace osu.Game.Screens.Menu
 
         public override bool ReceivePositionalInputAt(Vector2 screenSpacePos) => box.ReceivePositionalInputAt(screenSpacePos);
 
-        public Button(LocalisableString text, string sampleName, IconUsage symbol, Color4 colour, Action clickAction = null, float extraWidth = 0, Key triggerKey = Key.Unknown)
+        public MainMenuButton(LocalisableString text, string sampleName, IconUsage symbol, Color4 colour, Action clickAction = null, float extraWidth = 0, Key triggerKey = Key.Unknown)
         {
             this.sampleName = sampleName;
             this.clickAction = clickAction;

From 416b57ea69ac8c6bf43c7d0b52338a65246dc2a0 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 25 Mar 2022 15:13:22 +0900
Subject: [PATCH 3713/5547] Fix main menu buttons handling keys when super
 (cmd) is held

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

diff --git a/osu.Game/Screens/Menu/MainMenuButton.cs b/osu.Game/Screens/Menu/MainMenuButton.cs
index 1014249531..88bea43b23 100644
--- a/osu.Game/Screens/Menu/MainMenuButton.cs
+++ b/osu.Game/Screens/Menu/MainMenuButton.cs
@@ -209,7 +209,7 @@ namespace osu.Game.Screens.Menu
 
         protected override bool OnKeyDown(KeyDownEvent e)
         {
-            if (e.Repeat || e.ControlPressed || e.ShiftPressed || e.AltPressed)
+            if (e.Repeat || e.ControlPressed || e.ShiftPressed || e.AltPressed || e.SuperPressed)
                 return false;
 
             if (TriggerKey == e.Key && TriggerKey != Key.Unknown)

From de4c04ef809c7b0ccdc4ea8e7ca248a665875ad8 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 25 Mar 2022 15:34:33 +0900
Subject: [PATCH 3714/5547] Fix non-matching json propert for
 `AutoStartDuration`

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

diff --git a/osu.Game/Online/Rooms/Room.cs b/osu.Game/Online/Rooms/Room.cs
index 76bac44242..60c0503ddd 100644
--- a/osu.Game/Online/Rooms/Room.cs
+++ b/osu.Game/Online/Rooms/Room.cs
@@ -95,7 +95,7 @@ namespace osu.Game.Online.Rooms
         [Cached]
         public readonly Bindable<TimeSpan> AutoStartDuration = new Bindable<TimeSpan>();
 
-        [JsonProperty("start_duration")]
+        [JsonProperty("auto_start_duration")]
         private ushort autoStartDuration
         {
             get => (ushort)AutoStartDuration.Value.TotalSeconds;

From b1f0f89fdde94a7e3beb4821d2c7145af463ac34 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 25 Mar 2022 15:41:01 +0900
Subject: [PATCH 3715/5547] Simplify `AutoStart` and `Host` checks

---
 .../Online/Multiplayer/MultiplayerRoomSettings.cs    |  2 ++
 .../Multiplayer/Match/MatchStartControl.cs           | 12 ++++++------
 .../Multiplayer/Match/MultiplayerReadyButton.cs      |  2 +-
 .../Visual/Multiplayer/TestMultiplayerClient.cs      |  2 +-
 4 files changed, 10 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Online/Multiplayer/MultiplayerRoomSettings.cs b/osu.Game/Online/Multiplayer/MultiplayerRoomSettings.cs
index f8b238d61b..3aed42147b 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerRoomSettings.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerRoomSettings.cs
@@ -31,6 +31,8 @@ namespace osu.Game.Online.Multiplayer
         [Key(5)]
         public TimeSpan AutoStartDuration { get; set; }
 
+        public bool AutoStartEnabled => AutoStartDuration != TimeSpan.Zero;
+
         public bool Equals(MultiplayerRoomSettings? other)
         {
             if (ReferenceEquals(this, other)) return true;
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MatchStartControl.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MatchStartControl.cs
index 78719ac878..6297203684 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MatchStartControl.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MatchStartControl.cs
@@ -109,7 +109,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
             clickOperation = ongoingOperationTracker.BeginOperation();
 
             // Ensure the current user becomes ready before being able to do anything else (start match, stop countdown, unready).
-            if (!isReady() || !Client.IsHost || Room.Settings.AutoStartDuration != TimeSpan.Zero)
+            if (!isReady() || !Client.IsHost || Room.Settings.AutoStartEnabled)
             {
                 toggleReady();
                 return;
@@ -172,19 +172,19 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
             int newCountReady = Room.Users.Count(u => u.State == MultiplayerUserState.Ready);
             int newCountTotal = Room.Users.Count(u => u.State != MultiplayerUserState.Spectating);
 
-            if (Room.Countdown != null || Room.Settings.AutoStartDuration != TimeSpan.Zero)
-                countdownButton.Alpha = 0;
+            if (!Client.IsHost || Room.Countdown != null || Room.Settings.AutoStartEnabled)
+                countdownButton.Hide();
             else
             {
                 switch (localUser?.State)
                 {
                     default:
-                        countdownButton.Alpha = 0;
+                        countdownButton.Hide();
                         break;
 
                     case MultiplayerUserState.Spectating:
                     case MultiplayerUserState.Ready:
-                        countdownButton.Alpha = Room.Host?.Equals(localUser) == true ? 1 : 0;
+                        countdownButton.Show();
                         break;
                 }
             }
@@ -197,7 +197,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
 
             // When the local user is the host and spectating the match, the "start match" state should be enabled if any users are ready.
             if (localUser?.State == MultiplayerUserState.Spectating)
-                enabled.Value &= Room.Host?.Equals(localUser) == true && newCountReady > 0;
+                enabled.Value &= Client.IsHost && newCountReady > 0;
 
             if (newCountReady == countReady)
                 return;
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
index 79d974fd3a..71107095c2 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
@@ -168,7 +168,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
         {
             get
             {
-                if (room?.Countdown != null && multiplayerClient.IsHost && multiplayerClient.LocalUser?.State == MultiplayerUserState.Ready && room.Settings.AutoStartDuration == TimeSpan.Zero)
+                if (room?.Countdown != null && multiplayerClient.IsHost && multiplayerClient.LocalUser?.State == MultiplayerUserState.Ready && !room.Settings.AutoStartEnabled)
                     return "Cancel countdown";
 
                 return base.TooltipText;
diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
index a4c63d762e..6e8749d655 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
@@ -134,7 +134,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     case MultiplayerRoomState.Open:
                         // If there are no remaining ready users or the host is not ready, stop any existing countdown.
                         // Todo: This doesn't yet support non-match-start countdowns.
-                        if (Room.Settings.AutoStartDuration != TimeSpan.Zero)
+                        if (Room.Settings.AutoStartEnabled)
                         {
                             bool shouldHaveCountdown = !APIRoom.Playlist.GetCurrentItem()!.Expired && Room.Users.Any(u => u.State == MultiplayerUserState.Ready);
 

From 792e79265beb2bbdc82a004267acff9a322774e3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 25 Mar 2022 15:46:27 +0900
Subject: [PATCH 3716/5547] Add ignore rule for new helper property

---
 osu.Game/Online/Multiplayer/MultiplayerRoomSettings.cs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Game/Online/Multiplayer/MultiplayerRoomSettings.cs b/osu.Game/Online/Multiplayer/MultiplayerRoomSettings.cs
index 3aed42147b..5c086066e6 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerRoomSettings.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerRoomSettings.cs
@@ -31,6 +31,7 @@ namespace osu.Game.Online.Multiplayer
         [Key(5)]
         public TimeSpan AutoStartDuration { get; set; }
 
+        [IgnoreMember]
         public bool AutoStartEnabled => AutoStartDuration != TimeSpan.Zero;
 
         public bool Equals(MultiplayerRoomSettings? other)

From 23c4f9910e5bba1c0b556bb3838d9eea87cdd6dd Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 25 Mar 2022 15:53:55 +0900
Subject: [PATCH 3717/5547] Apply notnull constraint

---
 osu.Game/Skinning/ISkin.cs                   | 4 +++-
 osu.Game/Skinning/LegacySkin.cs              | 6 +++---
 osu.Game/Skinning/ResourceStoreBackedSkin.cs | 5 ++++-
 osu.Game/Skinning/Skin.cs                    | 4 +++-
 4 files changed, 13 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Skinning/ISkin.cs b/osu.Game/Skinning/ISkin.cs
index 4b14dcfd62..414a316dec 100644
--- a/osu.Game/Skinning/ISkin.cs
+++ b/osu.Game/Skinning/ISkin.cs
@@ -52,6 +52,8 @@ namespace osu.Game.Skinning
         /// </summary>
         /// <param name="lookup">The requested configuration value.</param>
         /// <returns>A matching value boxed in an <see cref="IBindable{TValue}"/>, or null if unavailable.</returns>
-        IBindable<TValue>? GetConfig<TLookup, TValue>(TLookup lookup);
+        IBindable<TValue>? GetConfig<TLookup, TValue>(TLookup lookup)
+            where TLookup : notnull
+            where TValue : notnull;
     }
 }
diff --git a/osu.Game/Skinning/LegacySkin.cs b/osu.Game/Skinning/LegacySkin.cs
index a3c08f4ba2..92713023f4 100644
--- a/osu.Game/Skinning/LegacySkin.cs
+++ b/osu.Game/Skinning/LegacySkin.cs
@@ -282,6 +282,7 @@ namespace osu.Game.Skinning
             => source.ImageLookups.TryGetValue(lookup, out string image) ? new Bindable<string>(image) : null;
 
         private IBindable<TValue>? legacySettingLookup<TValue>(SkinConfiguration.LegacySetting legacySetting)
+            where TValue : notnull
         {
             switch (legacySetting)
             {
@@ -294,10 +295,9 @@ namespace osu.Game.Skinning
         }
 
         private IBindable<TValue>? genericLookup<TLookup, TValue>(TLookup lookup)
+            where TLookup : notnull
+            where TValue : notnull
         {
-            if (lookup == null)
-                return null;
-
             try
             {
                 if (Configuration.ConfigDictionary.TryGetValue(lookup.ToString(), out string val))
diff --git a/osu.Game/Skinning/ResourceStoreBackedSkin.cs b/osu.Game/Skinning/ResourceStoreBackedSkin.cs
index 4787b5a4e9..48286bff59 100644
--- a/osu.Game/Skinning/ResourceStoreBackedSkin.cs
+++ b/osu.Game/Skinning/ResourceStoreBackedSkin.cs
@@ -46,7 +46,10 @@ namespace osu.Game.Skinning
             return null;
         }
 
-        public IBindable<TValue>? GetConfig<TLookup, TValue>(TLookup lookup) => null;
+        public IBindable<TValue>? GetConfig<TLookup, TValue>(TLookup lookup)
+            where TLookup : notnull
+            where TValue : notnull
+            => null;
 
         public void Dispose()
         {
diff --git a/osu.Game/Skinning/Skin.cs b/osu.Game/Skinning/Skin.cs
index 2766e58c96..324ed90a67 100644
--- a/osu.Game/Skinning/Skin.cs
+++ b/osu.Game/Skinning/Skin.cs
@@ -50,7 +50,9 @@ namespace osu.Game.Skinning
 
         public abstract Texture? GetTexture(string componentName, WrapMode wrapModeS, WrapMode wrapModeT);
 
-        public abstract IBindable<TValue>? GetConfig<TLookup, TValue>(TLookup lookup);
+        public abstract IBindable<TValue>? GetConfig<TLookup, TValue>(TLookup lookup)
+            where TLookup : notnull
+            where TValue : notnull;
 
         /// <summary>
         /// Construct a new skin.

From e44db4e726784b846c5d7b3b3213bfd59a8e16f6 Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Fri, 25 Mar 2022 15:13:25 +0800
Subject: [PATCH 3718/5547] Revert unintentional behavior change of random mod

Actually, using OsuPlayfield.BASE_SIZE.Y makes a touch more sense since it is the short side of the playfield, but I guess it is better to preserve replays than to introduce pointless breaking changes.
---
 osu.Game.Rulesets.Osu/Mods/OsuModRandom.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModRandom.cs b/osu.Game.Rulesets.Osu/Mods/OsuModRandom.cs
index 3c2c5d7759..fea9246035 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModRandom.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModRandom.cs
@@ -48,12 +48,12 @@ namespace osu.Game.Rulesets.Osu.Mods
 
                 if (positionInfo == positionInfos.First())
                 {
-                    positionInfo.DistanceFromPrevious = (float)rng.NextDouble() * OsuPlayfield.BASE_SIZE.Y / 2;
+                    positionInfo.DistanceFromPrevious = (float)(rng.NextDouble() * OsuPlayfield.BASE_SIZE.X / 2);
                     positionInfo.RelativeAngle = (float)(rng.NextDouble() * 2 * Math.PI - Math.PI);
                 }
                 else
                 {
-                    positionInfo.RelativeAngle = (float)(rateOfChangeMultiplier * 2 * Math.PI * Math.Min(1f, positionInfo.DistanceFromPrevious / (playfield_diagonal * 0.5f)));
+                    positionInfo.RelativeAngle = rateOfChangeMultiplier * 2 * (float)Math.PI * Math.Min(1f, positionInfo.DistanceFromPrevious / (playfield_diagonal * 0.5f));
                 }
             }
 

From 4a30b6ef565f320074116cb7ea4a9b447818e471 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 25 Mar 2022 16:22:53 +0900
Subject: [PATCH 3719/5547] Update multiplayer countdown button text more often

At once a second, it regularly skips whole seconds (because scheduler
isn't guaranteed to run exactly as often as specified). 10 updates a
second seems amicable and less noticeable to my eye.
---
 .../OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs      | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
index 746e4257f1..f0049565c9 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
@@ -47,7 +47,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
             countdown = room?.Countdown;
 
             if (room?.Countdown != null)
-                countdownUpdateDelegate ??= Scheduler.AddDelayed(updateButtonText, 1000, true);
+                countdownUpdateDelegate ??= Scheduler.AddDelayed(updateButtonText, 100, true);
             else
             {
                 countdownUpdateDelegate?.Cancel();

From 5fcd3b07f1352601ec8970a891f431f9d70433f6 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 25 Mar 2022 16:35:32 +0900
Subject: [PATCH 3720/5547] Fix visual test crashes due to local realm not
 having update thread

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

diff --git a/osu.Game/Tests/Visual/OsuTestScene.cs b/osu.Game/Tests/Visual/OsuTestScene.cs
index f287a04d71..6c332c2408 100644
--- a/osu.Game/Tests/Visual/OsuTestScene.cs
+++ b/osu.Game/Tests/Visual/OsuTestScene.cs
@@ -115,11 +115,13 @@ namespace osu.Game.Tests.Visual
 
         protected override IReadOnlyDependencyContainer CreateChildDependencies(IReadOnlyDependencyContainer parent)
         {
-            headlessHostStorage = (parent.Get<GameHost>() as HeadlessGameHost)?.Storage;
+            var host = parent.Get<GameHost>();
+
+            headlessHostStorage = (host as HeadlessGameHost)?.Storage;
 
             Resources = parent.Get<OsuGameBase>().Resources;
 
-            realm = new Lazy<RealmAccess>(() => new RealmAccess(LocalStorage, "client"));
+            realm = new Lazy<RealmAccess>(() => new RealmAccess(LocalStorage, "client", host.UpdateThread));
 
             RecycleLocalStorage(false);
 

From 6b22e5774f79d7e7b19e0ff24aee61b77ddb8b9e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 25 Mar 2022 16:42:35 +0900
Subject: [PATCH 3721/5547] Remove conditional access on known non-null

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

diff --git a/osu.Game/Tests/Visual/SkinnableTestScene.cs b/osu.Game/Tests/Visual/SkinnableTestScene.cs
index b4da91a97a..2e1ca09fe4 100644
--- a/osu.Game/Tests/Visual/SkinnableTestScene.cs
+++ b/osu.Game/Tests/Visual/SkinnableTestScene.cs
@@ -96,7 +96,7 @@ namespace osu.Game.Tests.Visual
                     },
                     new OsuSpriteText
                     {
-                        Text = skin?.SkinInfo?.Value.Name ?? "none",
+                        Text = skin?.SkinInfo.Value.Name ?? "none",
                         Scale = new Vector2(1.5f),
                         Padding = new MarginPadding(5),
                     },

From 2553cfed75bd40c79d0b13bb1d61af2c7413b177 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 25 Mar 2022 17:04:45 +0900
Subject: [PATCH 3722/5547] Match new server ready/unready logic

---
 .../Visual/Multiplayer/TestMultiplayerClient.cs | 17 ++---------------
 1 file changed, 2 insertions(+), 15 deletions(-)

diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
index 6e8749d655..b9304f713d 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
@@ -138,21 +138,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
                         {
                             bool shouldHaveCountdown = !APIRoom.Playlist.GetCurrentItem()!.Expired && Room.Users.Any(u => u.State == MultiplayerUserState.Ready);
 
-                            if (shouldHaveCountdown)
-                            {
-                                if (Room.Countdown == null)
-                                    startCountdown(new MatchStartCountdown { TimeRemaining = Room.Settings.AutoStartDuration }, StartMatch);
-                            }
-                            else
-                                stopCountdown();
-                        }
-                        else
-                        {
-                            bool shouldStopCountdown = Room.Users.All(u => u.State != MultiplayerUserState.Ready);
-                            shouldStopCountdown |= Room.Host?.State != MultiplayerUserState.Ready && Room.Host?.State != MultiplayerUserState.Spectating;
-
-                            if (shouldStopCountdown)
-                                stopCountdown();
+                            if (shouldHaveCountdown && Room.Countdown == null)
+                                startCountdown(new MatchStartCountdown { TimeRemaining = Room.Settings.AutoStartDuration }, StartMatch);
                         }
 
                         break;

From d5a37c223711bd7a9be258b27840c74a57dd619a Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 25 Mar 2022 17:06:04 +0900
Subject: [PATCH 3723/5547] Remove irrelevant test

---
 .../Multiplayer/TestSceneMatchStartControl.cs | 20 -------------------
 1 file changed, 20 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.cs
index a374488306..f0a2a28b34 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.cs
@@ -143,26 +143,6 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddAssert("countdown button enabled", () => this.ChildrenOfType<MultiplayerCountdownButton>().Single().Enabled.Value);
         }
 
-        [Test]
-        public void TestSpectatingDuringCountdownWithNoReadyUsersCancelsCountdown()
-        {
-            ClickButtonWhenEnabled<MultiplayerReadyButton>();
-            AddUntilStep("countdown button shown", () => this.ChildrenOfType<MultiplayerCountdownButton>().SingleOrDefault()?.IsPresent == true);
-            ClickButtonWhenEnabled<MultiplayerCountdownButton>();
-            AddStep("click the first countdown button", () =>
-            {
-                var popoverButton = this.ChildrenOfType<Popover>().Single().ChildrenOfType<OsuButton>().First();
-                InputManager.MoveMouseTo(popoverButton);
-                InputManager.Click(MouseButton.Left);
-            });
-
-            AddStep("set spectating", () => MultiplayerClient.ChangeUserState(API.LocalUser.Value.OnlineID, MultiplayerUserState.Spectating));
-            AddUntilStep("local user is spectating", () => MultiplayerClient.LocalUser?.State == MultiplayerUserState.Spectating);
-
-            AddStep("finish countdown", () => MultiplayerClient.SkipToEndOfCountdown());
-            AddUntilStep("match not started", () => MultiplayerClient.Room?.State == MultiplayerRoomState.Open);
-        }
-
         [Test]
         public void TestReadyButtonEnabledWhileSpectatingDuringCountdown()
         {

From c1649714f4784384b1de945f570e9ea79541a6e5 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 25 Mar 2022 17:12:00 +0900
Subject: [PATCH 3724/5547] Add a few more ready button tests

---
 .../Multiplayer/TestSceneMatchStartControl.cs | 25 +++++++++++++++++++
 1 file changed, 25 insertions(+)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.cs
index f0a2a28b34..e58b9893ce 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.cs
@@ -185,6 +185,31 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddAssert("countdown still active", () => MultiplayerClient.Room?.Countdown != null);
         }
 
+        [Test]
+        public void TestCountdownButtonVisibilityWithAutoStartEnablement()
+        {
+            ClickButtonWhenEnabled<MultiplayerReadyButton>();
+            AddUntilStep("local user became ready", () => MultiplayerClient.LocalUser?.State == MultiplayerUserState.Ready);
+            AddUntilStep("countdown button visible", () => this.ChildrenOfType<MultiplayerCountdownButton>().Single().IsPresent);
+
+            AddStep("enable auto start", () => MultiplayerClient.ChangeSettings(new MultiplayerRoomSettings { AutoStartDuration = TimeSpan.FromMinutes(1) }));
+
+            ClickButtonWhenEnabled<MultiplayerReadyButton>();
+            AddUntilStep("local user became ready", () => MultiplayerClient.LocalUser?.State == MultiplayerUserState.Ready);
+            AddUntilStep("countdown button not visible", () => !this.ChildrenOfType<MultiplayerCountdownButton>().Single().IsPresent);
+        }
+
+        [Test]
+        public void TestClickingReadyButtonUnReadiesDuringAutoStart()
+        {
+            AddStep("enable auto start", () => MultiplayerClient.ChangeSettings(new MultiplayerRoomSettings { AutoStartDuration = TimeSpan.FromMinutes(1) }));
+            ClickButtonWhenEnabled<MultiplayerReadyButton>();
+            AddUntilStep("local user became ready", () => MultiplayerClient.LocalUser?.State == MultiplayerUserState.Ready);
+
+            ClickButtonWhenEnabled<MultiplayerReadyButton>();
+            AddUntilStep("local user became idle", () => MultiplayerClient.LocalUser?.State == MultiplayerUserState.Idle);
+        }
+
         [Test]
         public void TestDeletedBeatmapDisableReady()
         {

From 463091bde25e9d97353c6ea3bcb978b1b0523f79 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 25 Mar 2022 18:25:32 +0900
Subject: [PATCH 3725/5547] Use more appropriate icon on countdown button (and
 give tooltip)

---
 .../Multiplayer/Match/MultiplayerCountdownButton.cs          | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerCountdownButton.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerCountdownButton.cs
index 3bf7e91a55..d6a09e0b31 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerCountdownButton.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerCountdownButton.cs
@@ -34,8 +34,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
 
         public MultiplayerCountdownButton()
         {
-            Icon = FontAwesome.Solid.CaretDown;
-            IconScale = new Vector2(0.6f);
+            Icon = FontAwesome.Regular.Clock;
 
             Add(background = new Box
             {
@@ -44,6 +43,8 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
             });
 
             base.Action = this.ShowPopover;
+
+            TooltipText = "Countdown settings";
         }
 
         [BackgroundDependencyLoader]

From 3ad092d80879975b371698f9c4dd8e510f2d8227 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 25 Mar 2022 18:29:00 +0900
Subject: [PATCH 3726/5547] Always show the countdown button when host

---
 .../Multiplayer/Match/MatchStartControl.cs     | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MatchStartControl.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MatchStartControl.cs
index 6297203684..fa1b682779 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MatchStartControl.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MatchStartControl.cs
@@ -30,7 +30,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
         private Sample sampleReadyAll;
         private Sample sampleUnready;
 
-        private readonly BindableBool enabled = new BindableBool();
+        private readonly MultiplayerReadyButton readyButton;
         private readonly MultiplayerCountdownButton countdownButton;
         private int countReady;
         private ScheduledDelegate readySampleDelegate;
@@ -50,12 +50,11 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
                 {
                     new Drawable[]
                     {
-                        new MultiplayerReadyButton
+                        readyButton = new MultiplayerReadyButton
                         {
                             RelativeSizeAxes = Axes.Both,
                             Size = Vector2.One,
                             Action = onReadyClick,
-                            Enabled = { BindTarget = enabled },
                         },
                         countdownButton = new MultiplayerCountdownButton
                         {
@@ -63,7 +62,6 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
                             Size = new Vector2(40, 1),
                             Alpha = 0,
                             Action = startCountdown,
-                            Enabled = { BindTarget = enabled }
                         }
                     }
                 }
@@ -163,7 +161,8 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
         {
             if (Room == null)
             {
-                enabled.Value = false;
+                readyButton.Enabled.Value = false;
+                countdownButton.Enabled.Value = false;
                 return;
             }
 
@@ -172,7 +171,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
             int newCountReady = Room.Users.Count(u => u.State == MultiplayerUserState.Ready);
             int newCountTotal = Room.Users.Count(u => u.State != MultiplayerUserState.Spectating);
 
-            if (!Client.IsHost || Room.Countdown != null || Room.Settings.AutoStartEnabled)
+            if (!Client.IsHost || Room.Settings.AutoStartEnabled)
                 countdownButton.Hide();
             else
             {
@@ -182,6 +181,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
                         countdownButton.Hide();
                         break;
 
+                    case MultiplayerUserState.Idle:
                     case MultiplayerUserState.Spectating:
                     case MultiplayerUserState.Ready:
                         countdownButton.Show();
@@ -189,15 +189,15 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
                 }
             }
 
-            enabled.Value =
+            readyButton.Enabled.Value = countdownButton.Enabled.Value =
                 Room.State == MultiplayerRoomState.Open
                 && CurrentPlaylistItem.Value?.ID == Room.Settings.PlaylistItemId
                 && !Room.Playlist.Single(i => i.ID == Room.Settings.PlaylistItemId).Expired
                 && !operationInProgress.Value;
 
-            // When the local user is the host and spectating the match, the "start match" state should be enabled if any users are ready.
+            // When the local user is the host and spectating the match, the ready button should be enabled only if any users are ready.
             if (localUser?.State == MultiplayerUserState.Spectating)
-                enabled.Value &= Client.IsHost && newCountReady > 0;
+                readyButton.Enabled.Value &= Client.IsHost && newCountReady > 0;
 
             if (newCountReady == countReady)
                 return;

From a0a3bba46e82f954c2264e9553a24c160d9fa813 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 25 Mar 2022 18:31:23 +0900
Subject: [PATCH 3727/5547] Avoid crashing if a skin component cannot be
 instantiated correctly

---
 osu.Game/Skinning/Skin.cs | 16 +++++++++++++++-
 1 file changed, 15 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Skinning/Skin.cs b/osu.Game/Skinning/Skin.cs
index e00dd950a7..7e93a74b7e 100644
--- a/osu.Game/Skinning/Skin.cs
+++ b/osu.Game/Skinning/Skin.cs
@@ -144,9 +144,23 @@ namespace osu.Game.Skinning
                     if (!DrawableComponentInfo.TryGetValue(target.Target, out var skinnableInfo))
                         return null;
 
+                    var components = new List<Drawable>();
+
+                    foreach (var i in skinnableInfo)
+                    {
+                        try
+                        {
+                            components.Add(i.CreateInstance());
+                        }
+                        catch (Exception e)
+                        {
+                            Logger.Error(e, $"Unable to create skin component {i.Type.Name}");
+                        }
+                    }
+
                     return new SkinnableTargetComponentsContainer
                     {
-                        ChildrenEnumerable = skinnableInfo.Select(i => i.CreateInstance())
+                        Children = components,
                     };
             }
 

From b13408aed0b07708ffdb0c54bb4545da38074638 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 25 Mar 2022 18:37:20 +0900
Subject: [PATCH 3728/5547] Add back "room visibility" control commented out
 for now

---
 .../Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs  | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs
index aef04c106d..a103d71120 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs
@@ -165,6 +165,14 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
                                                                         LengthLimit = 100,
                                                                     },
                                                                 },
+                                                                // new Section("Room visibility")
+                                                                // {
+                                                                //     Alpha = disabled_alpha,
+                                                                //     Child = AvailabilityPicker = new RoomAvailabilityPicker
+                                                                //     {
+                                                                //         Enabled = { Value = false }
+                                                                //     },
+                                                                // },
                                                                 new Section("Game type")
                                                                 {
                                                                     Child = new FillFlowContainer

From 320110f179efd7f7e4b5e565d5e85156852c04ba Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 25 Mar 2022 18:37:46 +0900
Subject: [PATCH 3729/5547] Remove "room visibility" from playlists settings to
 match

---
 .../Playlists/PlaylistsRoomSettingsOverlay.cs    | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSettingsOverlay.cs b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSettingsOverlay.cs
index 6674a37c3c..1bd227fa4d 100644
--- a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSettingsOverlay.cs
+++ b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSettingsOverlay.cs
@@ -152,14 +152,14 @@ namespace osu.Game.Screens.OnlinePlay.Playlists
                                                                 PlaceholderText = "Unlimited",
                                                             },
                                                         },
-                                                        new Section("Room visibility")
-                                                        {
-                                                            Alpha = disabled_alpha,
-                                                            Child = AvailabilityPicker = new RoomAvailabilityPicker
-                                                            {
-                                                                Enabled = { Value = false }
-                                                            },
-                                                        },
+                                                        // new Section("Room visibility")
+                                                        // {
+                                                        //     Alpha = disabled_alpha,
+                                                        //     Child = AvailabilityPicker = new RoomAvailabilityPicker
+                                                        //     {
+                                                        //         Enabled = { Value = false }
+                                                        //     },
+                                                        // },
                                                         new Section("Max participants")
                                                         {
                                                             Alpha = disabled_alpha,

From 76abce486766094622979c2b4be641f8feec118b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 25 Mar 2022 18:38:26 +0900
Subject: [PATCH 3730/5547] Add missing wait calls on `async` test steps

---
 .../Visual/Multiplayer/TestSceneMatchStartControl.cs          | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.cs
index e58b9893ce..52854db235 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.cs
@@ -192,7 +192,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddUntilStep("local user became ready", () => MultiplayerClient.LocalUser?.State == MultiplayerUserState.Ready);
             AddUntilStep("countdown button visible", () => this.ChildrenOfType<MultiplayerCountdownButton>().Single().IsPresent);
 
-            AddStep("enable auto start", () => MultiplayerClient.ChangeSettings(new MultiplayerRoomSettings { AutoStartDuration = TimeSpan.FromMinutes(1) }));
+            AddStep("enable auto start", () => MultiplayerClient.ChangeSettings(new MultiplayerRoomSettings { AutoStartDuration = TimeSpan.FromMinutes(1) }).WaitSafely());
 
             ClickButtonWhenEnabled<MultiplayerReadyButton>();
             AddUntilStep("local user became ready", () => MultiplayerClient.LocalUser?.State == MultiplayerUserState.Ready);
@@ -202,7 +202,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [Test]
         public void TestClickingReadyButtonUnReadiesDuringAutoStart()
         {
-            AddStep("enable auto start", () => MultiplayerClient.ChangeSettings(new MultiplayerRoomSettings { AutoStartDuration = TimeSpan.FromMinutes(1) }));
+            AddStep("enable auto start", () => MultiplayerClient.ChangeSettings(new MultiplayerRoomSettings { AutoStartDuration = TimeSpan.FromMinutes(1) }).WaitSafely());
             ClickButtonWhenEnabled<MultiplayerReadyButton>();
             AddUntilStep("local user became ready", () => MultiplayerClient.LocalUser?.State == MultiplayerUserState.Ready);
 

From 9963efce517068bbb7232374097ac88e8be1979d Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 25 Mar 2022 18:40:32 +0900
Subject: [PATCH 3731/5547] Improve ready/countdown button UX

---
 .../Multiplayer/Match/MatchStartControl.cs    | 32 ++++++++-----------
 .../Match/MultiplayerCountdownButton.cs       | 23 +++++++++++++
 2 files changed, 36 insertions(+), 19 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MatchStartControl.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MatchStartControl.cs
index fa1b682779..1201279929 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MatchStartControl.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MatchStartControl.cs
@@ -62,6 +62,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
                             Size = new Vector2(40, 1),
                             Alpha = 0,
                             Action = startCountdown,
+                            CancelAction = cancelCountdown
                         }
                     }
                 }
@@ -106,30 +107,15 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
             Debug.Assert(clickOperation == null);
             clickOperation = ongoingOperationTracker.BeginOperation();
 
-            // Ensure the current user becomes ready before being able to do anything else (start match, stop countdown, unready).
-            if (!isReady() || !Client.IsHost || Room.Settings.AutoStartEnabled)
-            {
+            if (isReady() && Client.IsHost && Room.Countdown == null)
+                startMatch();
+            else
                 toggleReady();
-                return;
-            }
-
-            // Local user is the room host and is in a ready state.
-            // The only action they can take is to stop a countdown if one's currently running.
-            if (Room.Countdown != null)
-            {
-                stopCountdown();
-                return;
-            }
-
-            // And if a countdown isn't running, start the match.
-            startMatch();
 
             bool isReady() => Client.LocalUser?.State == MultiplayerUserState.Ready || Client.LocalUser?.State == MultiplayerUserState.Spectating;
 
             void toggleReady() => Client.ToggleReady().ContinueWith(_ => endOperation());
 
-            void stopCountdown() => Client.SendMatchRequest(new StopCountdownRequest()).ContinueWith(_ => endOperation());
-
             void startMatch() => Client.StartMatch().ContinueWith(t =>
             {
                 // accessing Exception here silences any potential errors from the antecedent task
@@ -151,6 +137,14 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
             Client.SendMatchRequest(new StartMatchCountdownRequest { Duration = duration }).ContinueWith(_ => endOperation());
         }
 
+        private void cancelCountdown()
+        {
+            Debug.Assert(clickOperation == null);
+            clickOperation = ongoingOperationTracker.BeginOperation();
+
+            Client.SendMatchRequest(new StopCountdownRequest()).ContinueWith(_ => endOperation());
+        }
+
         private void endOperation()
         {
             clickOperation?.Dispose();
@@ -197,7 +191,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
 
             // When the local user is the host and spectating the match, the ready button should be enabled only if any users are ready.
             if (localUser?.State == MultiplayerUserState.Spectating)
-                readyButton.Enabled.Value &= Client.IsHost && newCountReady > 0;
+                readyButton.Enabled.Value &= Client.IsHost && newCountReady > 0 && Room.Countdown == null;
 
             if (newCountReady == countReady)
                 return;
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerCountdownButton.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerCountdownButton.cs
index 3bf7e91a55..d1e28fb5e0 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerCountdownButton.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerCountdownButton.cs
@@ -14,6 +14,7 @@ using osu.Framework.Graphics.UserInterface;
 using osu.Game.Graphics;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Graphics.UserInterfaceV2;
+using osu.Game.Online.Multiplayer;
 using osuTK;
 
 namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
@@ -29,6 +30,13 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
         };
 
         public new Action<TimeSpan> Action;
+        public Action CancelAction;
+
+        [Resolved]
+        private MultiplayerClient multiplayerClient { get; set; }
+
+        [Resolved]
+        private OsuColour colours { get; set; }
 
         private readonly Drawable background;
 
@@ -77,6 +85,21 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
                 });
             }
 
+            if (multiplayerClient.Room?.Countdown != null && multiplayerClient.IsHost)
+            {
+                flow.Add(new OsuButton
+                {
+                    RelativeSizeAxes = Axes.X,
+                    Text = "Cancel",
+                    BackgroundColour = colours.Red,
+                    Action = () =>
+                    {
+                        CancelAction();
+                        this.HidePopover();
+                    }
+                });
+            }
+
             return new OsuPopover { Child = flow };
         }
     }

From f989158a31e8c8c5a2e9301075c8b1fa4da0cae2 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 25 Mar 2022 19:20:16 +0900
Subject: [PATCH 3732/5547] Add back playlist availability control (because
 it's hooked up half way?)

---
 .../Playlists/PlaylistsRoomSettingsOverlay.cs    | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSettingsOverlay.cs b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSettingsOverlay.cs
index 1bd227fa4d..6674a37c3c 100644
--- a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSettingsOverlay.cs
+++ b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSettingsOverlay.cs
@@ -152,14 +152,14 @@ namespace osu.Game.Screens.OnlinePlay.Playlists
                                                                 PlaceholderText = "Unlimited",
                                                             },
                                                         },
-                                                        // new Section("Room visibility")
-                                                        // {
-                                                        //     Alpha = disabled_alpha,
-                                                        //     Child = AvailabilityPicker = new RoomAvailabilityPicker
-                                                        //     {
-                                                        //         Enabled = { Value = false }
-                                                        //     },
-                                                        // },
+                                                        new Section("Room visibility")
+                                                        {
+                                                            Alpha = disabled_alpha,
+                                                            Child = AvailabilityPicker = new RoomAvailabilityPicker
+                                                            {
+                                                                Enabled = { Value = false }
+                                                            },
+                                                        },
                                                         new Section("Max participants")
                                                         {
                                                             Alpha = disabled_alpha,

From 0146717fcb9bda32c892657d8030edde92774c16 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 26 Mar 2022 14:29:31 +0900
Subject: [PATCH 3733/5547] Adjust test button sizing to better match actual
 usage

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

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.cs
index 52854db235..b0a451f1d0 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.cs
@@ -67,7 +67,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 {
                     Anchor = Anchor.Centre,
                     Origin = Anchor.Centre,
-                    Size = new Vector2(200, 50),
+                    Size = new Vector2(250, 50),
                 }
             };
         });

From 5725cc36ff27b315f4246460a72366701e271637 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 26 Mar 2022 14:29:51 +0900
Subject: [PATCH 3734/5547] Add animation to countdown button when countdown is
 active

---
 .../Match/MultiplayerCountdownButton.cs       | 37 ++++++++++++++++++-
 1 file changed, 35 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerCountdownButton.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerCountdownButton.cs
index 7f819d9e75..c84fcff11e 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerCountdownButton.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerCountdownButton.cs
@@ -30,6 +30,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
         };
 
         public new Action<TimeSpan> Action;
+
         public Action CancelAction;
 
         [Resolved]
@@ -61,6 +62,38 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
             background.Colour = colours.Green;
         }
 
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            multiplayerClient.RoomUpdated += onRoomUpdated;
+        }
+
+        protected override void Dispose(bool isDisposing)
+        {
+            base.Dispose(isDisposing);
+            multiplayerClient.RoomUpdated -= onRoomUpdated;
+        }
+
+        private void onRoomUpdated() => Scheduler.AddOnce(() =>
+        {
+            bool countdownActive = multiplayerClient.Room?.Countdown != null;
+
+            if (countdownActive)
+            {
+                background
+                    .FadeColour(colours.YellowLight, 100, Easing.In)
+                    .Then()
+                    .FadeColour(colours.YellowDark, 900, Easing.OutQuint)
+                    .Loop();
+            }
+            else
+            {
+                background
+                    .FadeColour(colours.Green, 200, Easing.OutQuint);
+            }
+        });
+
         public Popover GetPopover()
         {
             var flow = new FillFlowContainer
@@ -77,7 +110,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
                 {
                     RelativeSizeAxes = Axes.X,
                     Text = $"Start match in {duration.Humanize()}",
-                    BackgroundColour = background.Colour,
+                    BackgroundColour = colours.Green,
                     Action = () =>
                     {
                         Action(duration);
@@ -91,7 +124,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
                 flow.Add(new OsuButton
                 {
                     RelativeSizeAxes = Axes.X,
-                    Text = "Cancel",
+                    Text = "Stop countdown",
                     BackgroundColour = colours.Red,
                     Action = () =>
                     {

From c3a0f0d6b8bbb5a13387ac84c98abd9431d1651d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 26 Mar 2022 14:43:41 +0900
Subject: [PATCH 3735/5547] Update tests in line with new button behaviour

---
 .../Multiplayer/TestSceneMatchStartControl.cs | 37 +++++--------------
 1 file changed, 10 insertions(+), 27 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.cs
index b0a451f1d0..5c2fd26857 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.cs
@@ -85,7 +85,6 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 InputManager.Click(MouseButton.Left);
             });
 
-            AddAssert("countdown button not visible", () => !this.ChildrenOfType<MultiplayerCountdownButton>().Single().IsPresent);
             AddStep("finish countdown", () => MultiplayerClient.SkipToEndOfCountdown());
             AddUntilStep("match started", () => MultiplayerClient.LocalUser?.State == MultiplayerUserState.WaitingForLoad);
         }
@@ -103,7 +102,13 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 InputManager.Click(MouseButton.Left);
             });
 
-            ClickButtonWhenEnabled<MultiplayerReadyButton>();
+            ClickButtonWhenEnabled<MultiplayerCountdownButton>();
+            AddStep("click the cancel button", () =>
+            {
+                var popoverButton = this.ChildrenOfType<Popover>().Single().ChildrenOfType<OsuButton>().Last();
+                InputManager.MoveMouseTo(popoverButton);
+                InputManager.Click(MouseButton.Left);
+            });
 
             AddStep("finish countdown", () => MultiplayerClient.SkipToEndOfCountdown());
             AddUntilStep("match not started", () => MultiplayerClient.LocalUser?.State == MultiplayerUserState.Ready);
@@ -128,43 +133,21 @@ namespace osu.Game.Tests.Visual.Multiplayer
         }
 
         [Test]
-        public void TestCountdownButtonEnablementAndVisibilityWhileSpectating()
+        public void TestCountdownWhileSpectating()
         {
             AddStep("set spectating", () => MultiplayerClient.ChangeUserState(API.LocalUser.Value.OnlineID, MultiplayerUserState.Spectating));
             AddUntilStep("local user is spectating", () => MultiplayerClient.LocalUser?.State == MultiplayerUserState.Spectating);
 
             AddAssert("countdown button is visible", () => this.ChildrenOfType<MultiplayerCountdownButton>().Single().IsPresent);
-            AddAssert("countdown button disabled", () => !this.ChildrenOfType<MultiplayerCountdownButton>().Single().Enabled.Value);
+            AddAssert("countdown button enabled", () => this.ChildrenOfType<MultiplayerCountdownButton>().Single().Enabled.Value);
 
             AddStep("add second user", () => MultiplayerClient.AddUser(new APIUser { Id = 2, Username = "Another user" }));
-            AddAssert("countdown button disabled", () => !this.ChildrenOfType<MultiplayerCountdownButton>().Single().Enabled.Value);
+            AddAssert("countdown button enabled", () => this.ChildrenOfType<MultiplayerCountdownButton>().Single().Enabled.Value);
 
             AddStep("set second user ready", () => MultiplayerClient.ChangeUserState(2, MultiplayerUserState.Ready));
             AddAssert("countdown button enabled", () => this.ChildrenOfType<MultiplayerCountdownButton>().Single().Enabled.Value);
         }
 
-        [Test]
-        public void TestReadyButtonEnabledWhileSpectatingDuringCountdown()
-        {
-            AddStep("add second user", () => MultiplayerClient.AddUser(new APIUser { Id = 2, Username = "Another user" }));
-            AddStep("set second user ready", () => MultiplayerClient.ChangeUserState(2, MultiplayerUserState.Ready));
-
-            ClickButtonWhenEnabled<MultiplayerReadyButton>();
-            AddUntilStep("countdown button shown", () => this.ChildrenOfType<MultiplayerCountdownButton>().SingleOrDefault()?.IsPresent == true);
-            ClickButtonWhenEnabled<MultiplayerCountdownButton>();
-            AddStep("click the first countdown button", () =>
-            {
-                var popoverButton = this.ChildrenOfType<Popover>().Single().ChildrenOfType<OsuButton>().First();
-                InputManager.MoveMouseTo(popoverButton);
-                InputManager.Click(MouseButton.Left);
-            });
-
-            AddStep("set spectating", () => MultiplayerClient.ChangeUserState(API.LocalUser.Value.OnlineID, MultiplayerUserState.Spectating));
-            AddUntilStep("local user is spectating", () => MultiplayerClient.LocalUser?.State == MultiplayerUserState.Spectating);
-
-            AddAssert("ready button enabled", () => this.ChildrenOfType<MultiplayerReadyButton>().Single().Enabled.Value);
-        }
-
         [Test]
         public void TestBecomeHostDuringCountdownAndReady()
         {

From 0d8a7246dd6e6093c0d467eb2fc0f283d9f1a67b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 26 Mar 2022 16:35:53 +0900
Subject: [PATCH 3736/5547] Add basic implementation of clock

---
 .../Visual/Menus/TestSceneToolbarClock.cs     |  64 +++++++
 osu.Game/Overlays/Toolbar/Toolbar.cs          |   1 +
 osu.Game/Overlays/Toolbar/ToolbarClock.cs     | 165 ++++++++++++++++++
 3 files changed, 230 insertions(+)
 create mode 100644 osu.Game.Tests/Visual/Menus/TestSceneToolbarClock.cs
 create mode 100644 osu.Game/Overlays/Toolbar/ToolbarClock.cs

diff --git a/osu.Game.Tests/Visual/Menus/TestSceneToolbarClock.cs b/osu.Game.Tests/Visual/Menus/TestSceneToolbarClock.cs
new file mode 100644
index 0000000000..56ac1b24f1
--- /dev/null
+++ b/osu.Game.Tests/Visual/Menus/TestSceneToolbarClock.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 NUnit.Framework;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.Shapes;
+using osu.Game.Overlays.Toolbar;
+using osuTK;
+using osuTK.Graphics;
+
+namespace osu.Game.Tests.Visual.Menus
+{
+    [TestFixture]
+    public class TestSceneToolbarClock : OsuManualInputManagerTestScene
+    {
+        public TestSceneToolbarClock()
+        {
+            Children = new Drawable[]
+            {
+                new Container
+                {
+                    Anchor = Anchor.Centre,
+                    Origin = Anchor.Centre,
+                    RelativeSizeAxes = Axes.X,
+                    Height = Toolbar.HEIGHT,
+                    Scale = new Vector2(4),
+                    Children = new Drawable[]
+                    {
+                        new Box
+                        {
+                            Colour = Color4.Black,
+                            RelativeSizeAxes = Axes.Both,
+                        },
+                        new FillFlowContainer
+                        {
+                            Anchor = Anchor.Centre,
+                            Origin = Anchor.Centre,
+                            RelativeSizeAxes = Axes.Y,
+                            AutoSizeAxes = Axes.X,
+                            Direction = FillDirection.Horizontal,
+                            Children = new Drawable[]
+                            {
+                                new Box
+                                {
+                                    Colour = Color4.DarkRed,
+                                    RelativeSizeAxes = Axes.Y,
+                                    Width = 2,
+                                },
+                                new ToolbarClock(),
+                                new Box
+                                {
+                                    Colour = Color4.DarkRed,
+                                    RelativeSizeAxes = Axes.Y,
+                                    Width = 2,
+                                },
+                            }
+                        },
+                    }
+                },
+            };
+        }
+    }
+}
diff --git a/osu.Game/Overlays/Toolbar/Toolbar.cs b/osu.Game/Overlays/Toolbar/Toolbar.cs
index 776f7ad7b7..b7fb2e45be 100644
--- a/osu.Game/Overlays/Toolbar/Toolbar.cs
+++ b/osu.Game/Overlays/Toolbar/Toolbar.cs
@@ -104,6 +104,7 @@ namespace osu.Game.Overlays.Toolbar
                         //    Icon = FontAwesome.Solid.search
                         //},
                         userButton = new ToolbarUserButton(),
+                        new ToolbarClock(),
                         new ToolbarNotificationButton(),
                     }
                 }
diff --git a/osu.Game/Overlays/Toolbar/ToolbarClock.cs b/osu.Game/Overlays/Toolbar/ToolbarClock.cs
new file mode 100644
index 0000000000..b8dc7ccbbd
--- /dev/null
+++ b/osu.Game/Overlays/Toolbar/ToolbarClock.cs
@@ -0,0 +1,165 @@
+// 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.Game.Graphics.Sprites;
+using osuTK;
+using osuTK.Graphics;
+
+namespace osu.Game.Overlays.Toolbar
+{
+    public class ToolbarClock : CompositeDrawable
+    {
+        public ToolbarClock()
+        {
+            RelativeSizeAxes = Axes.Y;
+            Width = 110;
+
+            Padding = new MarginPadding(10);
+        }
+
+        [BackgroundDependencyLoader]
+        private void load()
+        {
+            InternalChildren = new Drawable[]
+            {
+                new AnalogDisplay
+                {
+                    Anchor = Anchor.CentreLeft,
+                    Origin = Anchor.CentreLeft,
+                },
+                new DigitalDisplay
+                {
+                    Anchor = Anchor.CentreRight,
+                    Origin = Anchor.CentreRight,
+                }
+            };
+        }
+
+        private class DigitalDisplay : ClockDisplay
+        {
+            private OsuSpriteText text;
+
+            [BackgroundDependencyLoader]
+            private void load()
+            {
+                AutoSizeAxes = Axes.Y;
+                Width = 50;
+
+                InternalChildren = new Drawable[]
+                {
+                    text = new OsuSpriteText
+                    {
+                        Text = "00:00:00",
+                    }
+                };
+            }
+
+            protected override void UpdateDisplay(DateTimeOffset now)
+            {
+                text.Text = $"{now:HH:mm:ss}";
+            }
+        }
+
+        private class AnalogDisplay : ClockDisplay
+        {
+            private Drawable hour;
+            private Drawable minute;
+            private Drawable second;
+
+            [BackgroundDependencyLoader]
+            private void load()
+            {
+                Size = new Vector2(30);
+
+                InternalChildren = new[]
+                {
+                    new Circle
+                    {
+                        RelativeSizeAxes = Axes.Both,
+                    },
+                    hour = new Hand
+                    {
+                        Colour = Color4.Orange,
+                        Size = new Vector2(0.3f, 1.2f),
+                    },
+                    minute = new Hand
+                    {
+                        Colour = Color4.Green,
+                        Size = new Vector2(0.45f, 1),
+                    },
+                    second = new Hand
+                    {
+                        Colour = Color4.Blue,
+                        Size = new Vector2(0.48f, 0.5f),
+                    },
+                    new Circle
+                    {
+                        Anchor = Anchor.Centre,
+                        Origin = Anchor.Centre,
+                        Size = new Vector2(1.5f),
+                        Colour = Color4.Black,
+                    },
+                };
+            }
+
+            private class Hand : Circle
+            {
+                public Hand()
+                {
+                    Anchor = Anchor.Centre;
+                    Origin = Anchor.CentreLeft;
+
+                    RelativeSizeAxes = Axes.X;
+                }
+            }
+
+            protected override void UpdateDisplay(DateTimeOffset now)
+            {
+                float secondFractional = now.Second / 60f;
+                float minuteFractional = (now.Minute + secondFractional) / 60f;
+                float hourFractional = ((minuteFractional + now.Hour) % 12) / 12f;
+
+                updateRotation(hour, hourFractional);
+                updateRotation(minute, minuteFractional);
+                updateRotation(second, secondFractional);
+            }
+
+            private void updateRotation(Drawable hand, float fraction)
+            {
+                const float duration = 320;
+
+                float rotation = fraction * 360 - 90;
+
+                if (Math.Abs(hand.Rotation - rotation) > 180)
+                    hand.RotateTo(rotation);
+                else
+                    hand.RotateTo(rotation, duration, Easing.OutElastic);
+            }
+        }
+
+        private abstract class ClockDisplay : CompositeDrawable
+        {
+            private int lastSecond;
+
+            protected override void Update()
+            {
+                base.Update();
+
+                var now = DateTimeOffset.Now;
+
+                if (now.Second != lastSecond)
+                {
+                    lastSecond = now.Second;
+                    UpdateDisplay(now);
+                }
+            }
+
+            protected abstract void UpdateDisplay(DateTimeOffset now);
+        }
+    }
+}

From e8f5a8e3d6cad69b1d55b66458ddbfc36fb9d7b6 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 26 Mar 2022 17:22:48 +0900
Subject: [PATCH 3737/5547] Refactor hands for legibility (visual and code)

---
 osu.Game/Overlays/Toolbar/ToolbarClock.cs | 105 +++++++++++++++++-----
 1 file changed, 82 insertions(+), 23 deletions(-)

diff --git a/osu.Game/Overlays/Toolbar/ToolbarClock.cs b/osu.Game/Overlays/Toolbar/ToolbarClock.cs
index b8dc7ccbbd..a3c2994ffc 100644
--- a/osu.Game/Overlays/Toolbar/ToolbarClock.cs
+++ b/osu.Game/Overlays/Toolbar/ToolbarClock.cs
@@ -6,6 +6,7 @@ using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
+using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
 using osuTK;
 using osuTK.Graphics;
@@ -14,6 +15,8 @@ namespace osu.Game.Overlays.Toolbar
 {
     public class ToolbarClock : CompositeDrawable
     {
+        private const float hand_thickness = 2.2f;
+
         public ToolbarClock()
         {
             RelativeSizeAxes = Axes.Y;
@@ -72,7 +75,7 @@ namespace osu.Game.Overlays.Toolbar
             private Drawable second;
 
             [BackgroundDependencyLoader]
-            private void load()
+            private void load(OsuColour colours)
             {
                 Size = new Vector2(30);
 
@@ -82,38 +85,94 @@ namespace osu.Game.Overlays.Toolbar
                     {
                         RelativeSizeAxes = Axes.Both,
                     },
-                    hour = new Hand
-                    {
-                        Colour = Color4.Orange,
-                        Size = new Vector2(0.3f, 1.2f),
-                    },
-                    minute = new Hand
-                    {
-                        Colour = Color4.Green,
-                        Size = new Vector2(0.45f, 1),
-                    },
-                    second = new Hand
-                    {
-                        Colour = Color4.Blue,
-                        Size = new Vector2(0.48f, 0.5f),
-                    },
-                    new Circle
+                    hour = new LargeHand(0.3f),
+                    minute = new LargeHand(0.45f),
+                    second = new SecondHand(),
+                    new CentreCircle
                     {
                         Anchor = Anchor.Centre,
                         Origin = Anchor.Centre,
-                        Size = new Vector2(1.5f),
-                        Colour = Color4.Black,
-                    },
+                    }
                 };
             }
 
-            private class Hand : Circle
+            private class CentreCircle : CompositeDrawable
             {
-                public Hand()
+                public CentreCircle()
+                {
+                    InternalChildren = new Drawable[]
+                    {
+                        new Circle
+                        {
+                            Anchor = Anchor.Centre,
+                            Origin = Anchor.Centre,
+                            Size = new Vector2(hand_thickness),
+                            Colour = Color4.Black,
+                        },
+                        new Circle
+                        {
+                            Anchor = Anchor.Centre,
+                            Origin = Anchor.Centre,
+                            Size = new Vector2(hand_thickness * 0.7f),
+                            Colour = Color4.White,
+                        },
+                    };
+                }
+            }
+
+            private class SecondHand : CompositeDrawable
+            {
+                [BackgroundDependencyLoader]
+                private void load(OsuColour colours)
+                {
+                    RelativeSizeAxes = Axes.X;
+                    Width = 0.54f;
+
+                    Height = hand_thickness / 2;
+                    Anchor = Anchor.Centre;
+                    Origin = Anchor.Custom;
+
+                    OriginPosition = new Vector2(Height * 2, Height / 2);
+
+                    InternalChildren = new Drawable[]
+                    {
+                        new Circle
+                        {
+                            Colour = colours.YellowDark,
+                            RelativeSizeAxes = Axes.Both,
+                        },
+                    };
+                }
+            }
+
+            private class LargeHand : CompositeDrawable
+            {
+                public LargeHand(float length)
+                {
+                    Width = length;
+                }
+
+                [BackgroundDependencyLoader]
+                private void load(OsuColour colours)
                 {
                     Anchor = Anchor.Centre;
                     Origin = Anchor.CentreLeft;
 
+                    Origin = Anchor.Custom;
+                    OriginPosition = new Vector2(hand_thickness / 2); // offset x also, to ensure the centre of the line is centered on the face.
+                    Height = hand_thickness;
+
+                    InternalChildren = new Drawable[]
+                    {
+                        new Circle
+                        {
+                            Colour = colours.PurpleLight,
+                            RelativeSizeAxes = Axes.Both,
+                            BorderThickness = 0.5f,
+                            BorderColour = colours.Purple,
+                        },
+                    };
+
                     RelativeSizeAxes = Axes.X;
                 }
             }
@@ -144,7 +203,7 @@ namespace osu.Game.Overlays.Toolbar
 
         private abstract class ClockDisplay : CompositeDrawable
         {
-            private int lastSecond;
+            private int? lastSecond;
 
             protected override void Update()
             {

From 999ae88af2209af542acee1a55f38b80650fec0c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 26 Mar 2022 17:55:33 +0900
Subject: [PATCH 3738/5547] Show game time display in clock

---
 .../Visual/Menus/TestSceneToolbarClock.cs     | 17 ++++++-
 osu.Game/Overlays/Toolbar/ToolbarClock.cs     | 46 ++++++++++++-------
 2 files changed, 45 insertions(+), 18 deletions(-)

diff --git a/osu.Game.Tests/Visual/Menus/TestSceneToolbarClock.cs b/osu.Game.Tests/Visual/Menus/TestSceneToolbarClock.cs
index 56ac1b24f1..a8d25242ee 100644
--- a/osu.Game.Tests/Visual/Menus/TestSceneToolbarClock.cs
+++ b/osu.Game.Tests/Visual/Menus/TestSceneToolbarClock.cs
@@ -5,6 +5,7 @@ using NUnit.Framework;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
+using osu.Framework.Timing;
 using osu.Game.Overlays.Toolbar;
 using osuTK;
 using osuTK.Graphics;
@@ -14,11 +15,13 @@ namespace osu.Game.Tests.Visual.Menus
     [TestFixture]
     public class TestSceneToolbarClock : OsuManualInputManagerTestScene
     {
+        private readonly Container mainContainer;
+
         public TestSceneToolbarClock()
         {
             Children = new Drawable[]
             {
-                new Container
+                mainContainer = new Container
                 {
                     Anchor = Anchor.Centre,
                     Origin = Anchor.Centre,
@@ -60,5 +63,17 @@ namespace osu.Game.Tests.Visual.Menus
                 },
             };
         }
+
+        [Test]
+        public void TestRealGameTime()
+        {
+            AddStep("Set game time real", () => mainContainer.Clock = Clock);
+        }
+
+        [Test]
+        public void TestLongGameTime()
+        {
+            AddStep("Set game time long", () => mainContainer.Clock = new FramedOffsetClock(Clock, false) { Offset = 3600.0 * 24 * 1000 * 98 });
+        }
     }
 }
diff --git a/osu.Game/Overlays/Toolbar/ToolbarClock.cs b/osu.Game/Overlays/Toolbar/ToolbarClock.cs
index a3c2994ffc..f7a92ebbe6 100644
--- a/osu.Game/Overlays/Toolbar/ToolbarClock.cs
+++ b/osu.Game/Overlays/Toolbar/ToolbarClock.cs
@@ -20,7 +20,7 @@ namespace osu.Game.Overlays.Toolbar
         public ToolbarClock()
         {
             RelativeSizeAxes = Axes.Y;
-            Width = 110;
+            AutoSizeAxes = Axes.X;
 
             Padding = new MarginPadding(10);
         }
@@ -28,43 +28,55 @@ namespace osu.Game.Overlays.Toolbar
         [BackgroundDependencyLoader]
         private void load()
         {
-            InternalChildren = new Drawable[]
+            InternalChild = new FillFlowContainer
             {
-                new AnalogDisplay
+                RelativeSizeAxes = Axes.Y,
+                AutoSizeAxes = Axes.X,
+                Direction = FillDirection.Horizontal,
+                Spacing = new Vector2(5),
+                Children = new Drawable[]
                 {
-                    Anchor = Anchor.CentreLeft,
-                    Origin = Anchor.CentreLeft,
-                },
-                new DigitalDisplay
-                {
-                    Anchor = Anchor.CentreRight,
-                    Origin = Anchor.CentreRight,
+                    new AnalogDisplay
+                    {
+                        Anchor = Anchor.CentreLeft,
+                        Origin = Anchor.CentreLeft,
+                    },
+                    new DigitalDisplay
+                    {
+                        Anchor = Anchor.CentreLeft,
+                        Origin = Anchor.CentreLeft,
+                    }
                 }
             };
         }
 
         private class DigitalDisplay : ClockDisplay
         {
-            private OsuSpriteText text;
+            private OsuSpriteText realTime;
+            private OsuSpriteText gameTime;
 
             [BackgroundDependencyLoader]
-            private void load()
+            private void load(OsuColour colours)
             {
                 AutoSizeAxes = Axes.Y;
-                Width = 50;
+                Width = 70; // Allows for space for game time up to 99 days.
 
                 InternalChildren = new Drawable[]
                 {
-                    text = new OsuSpriteText
+                    realTime = new OsuSpriteText(),
+                    gameTime = new OsuSpriteText
                     {
-                        Text = "00:00:00",
+                        Y = 14,
+                        Colour = colours.PurpleLight,
+                        Scale = new Vector2(0.6f)
                     }
                 };
             }
 
             protected override void UpdateDisplay(DateTimeOffset now)
             {
-                text.Text = $"{now:HH:mm:ss}";
+                realTime.Text = $"{now:HH:mm:ss}";
+                gameTime.Text = $"running {new TimeSpan(TimeSpan.TicksPerSecond * (int)(Clock.CurrentTime / 1000)):c}";
             }
         }
 
@@ -75,7 +87,7 @@ namespace osu.Game.Overlays.Toolbar
             private Drawable second;
 
             [BackgroundDependencyLoader]
-            private void load(OsuColour colours)
+            private void load()
             {
                 Size = new Vector2(30);
 

From 252d1924e757331d23f2f6849e09497f864b5773 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 26 Mar 2022 18:13:33 +0900
Subject: [PATCH 3739/5547] Adjust metrics for better legibility at small sizes

---
 osu.Game/Overlays/Toolbar/ToolbarClock.cs | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Overlays/Toolbar/ToolbarClock.cs b/osu.Game/Overlays/Toolbar/ToolbarClock.cs
index f7a92ebbe6..3cbf07c875 100644
--- a/osu.Game/Overlays/Toolbar/ToolbarClock.cs
+++ b/osu.Game/Overlays/Toolbar/ToolbarClock.cs
@@ -22,7 +22,7 @@ namespace osu.Game.Overlays.Toolbar
             RelativeSizeAxes = Axes.Y;
             AutoSizeAxes = Axes.X;
 
-            Padding = new MarginPadding(10);
+            Padding = new MarginPadding(5);
         }
 
         [BackgroundDependencyLoader]
@@ -59,7 +59,7 @@ namespace osu.Game.Overlays.Toolbar
             private void load(OsuColour colours)
             {
                 AutoSizeAxes = Axes.Y;
-                Width = 70; // Allows for space for game time up to 99 days.
+                Width = 66; // Allows for space for game time up to 99 days (in the padding area since this is quite rare).
 
                 InternalChildren = new Drawable[]
                 {
@@ -89,7 +89,7 @@ namespace osu.Game.Overlays.Toolbar
             [BackgroundDependencyLoader]
             private void load()
             {
-                Size = new Vector2(30);
+                Size = new Vector2(20);
 
                 InternalChildren = new[]
                 {

From 622458e8570309fb23ccf9064ad573d3af6dbbda Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 26 Mar 2022 18:56:28 +0900
Subject: [PATCH 3740/5547] Allow scaling display in the test scene

---
 osu.Game.Tests/Visual/Menus/TestSceneToolbarClock.cs | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/Menus/TestSceneToolbarClock.cs b/osu.Game.Tests/Visual/Menus/TestSceneToolbarClock.cs
index a8d25242ee..064d6f82fd 100644
--- a/osu.Game.Tests/Visual/Menus/TestSceneToolbarClock.cs
+++ b/osu.Game.Tests/Visual/Menus/TestSceneToolbarClock.cs
@@ -27,7 +27,6 @@ namespace osu.Game.Tests.Visual.Menus
                     Origin = Anchor.Centre,
                     RelativeSizeAxes = Axes.X,
                     Height = Toolbar.HEIGHT,
-                    Scale = new Vector2(4),
                     Children = new Drawable[]
                     {
                         new Box
@@ -62,6 +61,8 @@ namespace osu.Game.Tests.Visual.Menus
                     }
                 },
             };
+
+            AddSliderStep("scale", 0.5, 4, 1, scale => mainContainer.Scale = new Vector2((float)scale));
         }
 
         [Test]

From 97e9049a2c47945ad08f234216713abfc469b213 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 26 Mar 2022 18:56:40 +0900
Subject: [PATCH 3741/5547] Adjust metrics and colours to better match the
 actual toolbar

---
 osu.Game/Overlays/Toolbar/ToolbarClock.cs | 40 ++++++++++++++---------
 1 file changed, 25 insertions(+), 15 deletions(-)

diff --git a/osu.Game/Overlays/Toolbar/ToolbarClock.cs b/osu.Game/Overlays/Toolbar/ToolbarClock.cs
index 3cbf07c875..1cbad6a471 100644
--- a/osu.Game/Overlays/Toolbar/ToolbarClock.cs
+++ b/osu.Game/Overlays/Toolbar/ToolbarClock.cs
@@ -15,7 +15,7 @@ namespace osu.Game.Overlays.Toolbar
 {
     public class ToolbarClock : CompositeDrawable
     {
-        private const float hand_thickness = 2.2f;
+        private const float hand_thickness = 2.4f;
 
         public ToolbarClock()
         {
@@ -67,7 +67,7 @@ namespace osu.Game.Overlays.Toolbar
                     gameTime = new OsuSpriteText
                     {
                         Y = 14,
-                        Colour = colours.PurpleLight,
+                        Colour = colours.PinkLight,
                         Scale = new Vector2(0.6f)
                     }
                 };
@@ -89,16 +89,25 @@ namespace osu.Game.Overlays.Toolbar
             [BackgroundDependencyLoader]
             private void load()
             {
-                Size = new Vector2(20);
+                Size = new Vector2(22);
 
                 InternalChildren = new[]
                 {
-                    new Circle
+                    new CircularContainer
                     {
                         RelativeSizeAxes = Axes.Both,
+                        Masking = true,
+                        BorderThickness = 2,
+                        BorderColour = Color4.White,
+                        Child = new Box
+                        {
+                            AlwaysPresent = true,
+                            Alpha = 0,
+                            RelativeSizeAxes = Axes.Both
+                        },
                     },
-                    hour = new LargeHand(0.3f),
-                    minute = new LargeHand(0.45f),
+                    hour = new LargeHand(0.34f),
+                    minute = new LargeHand(0.48f),
                     second = new SecondHand(),
                     new CentreCircle
                     {
@@ -110,7 +119,8 @@ namespace osu.Game.Overlays.Toolbar
 
             private class CentreCircle : CompositeDrawable
             {
-                public CentreCircle()
+                [BackgroundDependencyLoader]
+                private void load(OsuColour colours)
                 {
                     InternalChildren = new Drawable[]
                     {
@@ -119,14 +129,14 @@ namespace osu.Game.Overlays.Toolbar
                             Anchor = Anchor.Centre,
                             Origin = Anchor.Centre,
                             Size = new Vector2(hand_thickness),
-                            Colour = Color4.Black,
+                            Colour = Color4.White,
                         },
                         new Circle
                         {
                             Anchor = Anchor.Centre,
                             Origin = Anchor.Centre,
                             Size = new Vector2(hand_thickness * 0.7f),
-                            Colour = Color4.White,
+                            Colour = colours.PinkLight,
                         },
                     };
                 }
@@ -138,9 +148,9 @@ namespace osu.Game.Overlays.Toolbar
                 private void load(OsuColour colours)
                 {
                     RelativeSizeAxes = Axes.X;
-                    Width = 0.54f;
+                    Width = 0.66f;
 
-                    Height = hand_thickness / 2;
+                    Height = hand_thickness * 0.7f;
                     Anchor = Anchor.Centre;
                     Origin = Anchor.Custom;
 
@@ -150,7 +160,7 @@ namespace osu.Game.Overlays.Toolbar
                     {
                         new Circle
                         {
-                            Colour = colours.YellowDark,
+                            Colour = colours.PinkLight,
                             RelativeSizeAxes = Axes.Both,
                         },
                     };
@@ -178,10 +188,10 @@ namespace osu.Game.Overlays.Toolbar
                     {
                         new Circle
                         {
-                            Colour = colours.PurpleLight,
+                            Colour = Color4.White,
                             RelativeSizeAxes = Axes.Both,
-                            BorderThickness = 0.5f,
-                            BorderColour = colours.Purple,
+                            BorderThickness = 0.7f,
+                            BorderColour = colours.Gray2,
                         },
                     };
 

From 4ddf3cb1d9293d9e374a3c945bbfcb74d9fbe1c1 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 26 Mar 2022 19:18:41 +0900
Subject: [PATCH 3742/5547] Add ability to cycle between clock display modes

---
 osu.Game/Configuration/OsuConfigManager.cs    |  3 +
 .../Configuration/ToolbarClockDisplayMode.cs  | 13 +++
 osu.Game/Overlays/Toolbar/ToolbarClock.cs     | 85 ++++++++++++++++++-
 3 files changed, 97 insertions(+), 4 deletions(-)
 create mode 100644 osu.Game/Configuration/ToolbarClockDisplayMode.cs

diff --git a/osu.Game/Configuration/OsuConfigManager.cs b/osu.Game/Configuration/OsuConfigManager.cs
index c279ce1220..e8f13ba902 100644
--- a/osu.Game/Configuration/OsuConfigManager.cs
+++ b/osu.Game/Configuration/OsuConfigManager.cs
@@ -44,6 +44,8 @@ namespace osu.Game.Configuration
 
             SetDefault(OsuSetting.ChatDisplayHeight, ChatOverlay.DEFAULT_HEIGHT, 0.2f, 1f);
 
+            SetDefault(OsuSetting.ToolbarClockDisplayMode, ToolbarClockDisplayMode.Full);
+
             // Online settings
             SetDefault(OsuSetting.Username, string.Empty);
             SetDefault(OsuSetting.Token, string.Empty);
@@ -295,6 +297,7 @@ namespace osu.Game.Configuration
         RandomSelectAlgorithm,
         ShowFpsDisplay,
         ChatDisplayHeight,
+        ToolbarClockDisplayMode,
         Version,
         ShowConvertedBeatmaps,
         Skin,
diff --git a/osu.Game/Configuration/ToolbarClockDisplayMode.cs b/osu.Game/Configuration/ToolbarClockDisplayMode.cs
new file mode 100644
index 0000000000..2f42f7a9b5
--- /dev/null
+++ b/osu.Game/Configuration/ToolbarClockDisplayMode.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.
+
+namespace osu.Game.Configuration
+{
+    public enum ToolbarClockDisplayMode
+    {
+        Analog,
+        Digital,
+        DigitalWithRuntime,
+        Full
+    }
+}
diff --git a/osu.Game/Overlays/Toolbar/ToolbarClock.cs b/osu.Game/Overlays/Toolbar/ToolbarClock.cs
index 1cbad6a471..68772d8fc3 100644
--- a/osu.Game/Overlays/Toolbar/ToolbarClock.cs
+++ b/osu.Game/Overlays/Toolbar/ToolbarClock.cs
@@ -3,9 +3,12 @@
 
 using System;
 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.Graphics;
 using osu.Game.Graphics.Sprites;
 using osuTK;
@@ -15,6 +18,11 @@ namespace osu.Game.Overlays.Toolbar
 {
     public class ToolbarClock : CompositeDrawable
     {
+        private Bindable<ToolbarClockDisplayMode> clockDisplayMode;
+
+        private DigitalDisplay digital;
+        private AnalogDisplay analog;
+
         private const float hand_thickness = 2.4f;
 
         public ToolbarClock()
@@ -26,8 +34,10 @@ namespace osu.Game.Overlays.Toolbar
         }
 
         [BackgroundDependencyLoader]
-        private void load()
+        private void load(OsuConfigManager config)
         {
+            clockDisplayMode = config.GetBindable<ToolbarClockDisplayMode>(OsuSetting.ToolbarClockDisplayMode);
+
             InternalChild = new FillFlowContainer
             {
                 RelativeSizeAxes = Axes.Y,
@@ -36,12 +46,12 @@ namespace osu.Game.Overlays.Toolbar
                 Spacing = new Vector2(5),
                 Children = new Drawable[]
                 {
-                    new AnalogDisplay
+                    analog = new AnalogDisplay
                     {
                         Anchor = Anchor.CentreLeft,
                         Origin = Anchor.CentreLeft,
                     },
-                    new DigitalDisplay
+                    digital = new DigitalDisplay
                     {
                         Anchor = Anchor.CentreLeft,
                         Origin = Anchor.CentreLeft,
@@ -50,16 +60,75 @@ namespace osu.Game.Overlays.Toolbar
             };
         }
 
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            clockDisplayMode.BindValueChanged(displayMode =>
+            {
+                bool showAnalog = displayMode.NewValue == ToolbarClockDisplayMode.Analog || displayMode.NewValue == ToolbarClockDisplayMode.Full;
+                bool showDigital = displayMode.NewValue != ToolbarClockDisplayMode.Analog;
+                bool showRuntime = displayMode.NewValue == ToolbarClockDisplayMode.DigitalWithRuntime || displayMode.NewValue == ToolbarClockDisplayMode.Full;
+
+                digital.FadeTo(showDigital ? 1 : 0);
+                digital.ShowRuntime = showRuntime;
+
+                analog.FadeTo(showAnalog ? 1 : 0);
+            }, true);
+        }
+
+        protected override bool OnClick(ClickEvent e)
+        {
+            cycleDisplayMode();
+            return true;
+        }
+
+        private void cycleDisplayMode()
+        {
+            switch (clockDisplayMode.Value)
+            {
+                case ToolbarClockDisplayMode.Analog:
+                    clockDisplayMode.Value = ToolbarClockDisplayMode.Full;
+                    break;
+
+                case ToolbarClockDisplayMode.Digital:
+                    clockDisplayMode.Value = ToolbarClockDisplayMode.Analog;
+                    break;
+
+                case ToolbarClockDisplayMode.DigitalWithRuntime:
+                    clockDisplayMode.Value = ToolbarClockDisplayMode.Digital;
+                    break;
+
+                case ToolbarClockDisplayMode.Full:
+                    clockDisplayMode.Value = ToolbarClockDisplayMode.DigitalWithRuntime;
+                    break;
+            }
+        }
+
         private class DigitalDisplay : ClockDisplay
         {
             private OsuSpriteText realTime;
             private OsuSpriteText gameTime;
 
+            private bool showRuntime = true;
+
+            public bool ShowRuntime
+            {
+                get => showRuntime;
+                set
+                {
+                    if (showRuntime == value)
+                        return;
+
+                    showRuntime = value;
+                    updateMetrics();
+                }
+            }
+
             [BackgroundDependencyLoader]
             private void load(OsuColour colours)
             {
                 AutoSizeAxes = Axes.Y;
-                Width = 66; // Allows for space for game time up to 99 days (in the padding area since this is quite rare).
 
                 InternalChildren = new Drawable[]
                 {
@@ -71,6 +140,8 @@ namespace osu.Game.Overlays.Toolbar
                         Scale = new Vector2(0.6f)
                     }
                 };
+
+                updateMetrics();
             }
 
             protected override void UpdateDisplay(DateTimeOffset now)
@@ -78,6 +149,12 @@ namespace osu.Game.Overlays.Toolbar
                 realTime.Text = $"{now:HH:mm:ss}";
                 gameTime.Text = $"running {new TimeSpan(TimeSpan.TicksPerSecond * (int)(Clock.CurrentTime / 1000)):c}";
             }
+
+            private void updateMetrics()
+            {
+                Width = showRuntime ? 66 : 45; // Allows for space for game time up to 99 days (in the padding area since this is quite rare).
+                gameTime.FadeTo(showRuntime ? 1 : 0);
+            }
         }
 
         private class AnalogDisplay : ClockDisplay

From ab8db3b7dc1c4b68cfbc2885ba03e1840096357e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 26 Mar 2022 20:34:17 +0900
Subject: [PATCH 3743/5547] Move nested classes to own files

---
 .../Overlays/Toolbar/AnalogClockDisplay.cs    | 159 ++++++++++++
 osu.Game/Overlays/Toolbar/ClockDisplay.cs     |  28 +++
 .../Overlays/Toolbar/DigitalClockDisplay.cs   |  64 +++++
 osu.Game/Overlays/Toolbar/ToolbarClock.cs     | 230 +-----------------
 4 files changed, 255 insertions(+), 226 deletions(-)
 create mode 100644 osu.Game/Overlays/Toolbar/AnalogClockDisplay.cs
 create mode 100644 osu.Game/Overlays/Toolbar/ClockDisplay.cs
 create mode 100644 osu.Game/Overlays/Toolbar/DigitalClockDisplay.cs

diff --git a/osu.Game/Overlays/Toolbar/AnalogClockDisplay.cs b/osu.Game/Overlays/Toolbar/AnalogClockDisplay.cs
new file mode 100644
index 0000000000..e100ee0c06
--- /dev/null
+++ b/osu.Game/Overlays/Toolbar/AnalogClockDisplay.cs
@@ -0,0 +1,159 @@
+// 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.Game.Graphics;
+using osuTK;
+using osuTK.Graphics;
+
+namespace osu.Game.Overlays.Toolbar
+{
+    public class AnalogClockDisplay : ClockDisplay
+    {
+        private const float hand_thickness = 2.4f;
+
+        private Drawable hour;
+        private Drawable minute;
+        private Drawable second;
+
+        [BackgroundDependencyLoader]
+        private void load()
+        {
+            Size = new Vector2(22);
+
+            InternalChildren = new[]
+            {
+                new CircularContainer
+                {
+                    RelativeSizeAxes = Axes.Both,
+                    Masking = true,
+                    BorderThickness = 2,
+                    BorderColour = Color4.White,
+                    Child = new Box
+                    {
+                        AlwaysPresent = true,
+                        Alpha = 0,
+                        RelativeSizeAxes = Axes.Both
+                    },
+                },
+                hour = new LargeHand(0.34f),
+                minute = new LargeHand(0.48f),
+                second = new SecondHand(),
+                new CentreCircle
+                {
+                    Anchor = Anchor.Centre,
+                    Origin = Anchor.Centre,
+                }
+            };
+        }
+
+        protected override void UpdateDisplay(DateTimeOffset now)
+        {
+            float secondFractional = now.Second / 60f;
+            float minuteFractional = (now.Minute + secondFractional) / 60f;
+            float hourFractional = ((minuteFractional + now.Hour) % 12) / 12f;
+
+            updateRotation(hour, hourFractional);
+            updateRotation(minute, minuteFractional);
+            updateRotation(second, secondFractional);
+        }
+
+        private void updateRotation(Drawable hand, float fraction)
+        {
+            const float duration = 320;
+
+            float rotation = fraction * 360 - 90;
+
+            if (Math.Abs(hand.Rotation - rotation) > 180)
+                hand.RotateTo(rotation);
+            else
+                hand.RotateTo(rotation, duration, Easing.OutElastic);
+        }
+
+        private class CentreCircle : CompositeDrawable
+        {
+            [BackgroundDependencyLoader]
+            private void load(OsuColour colours)
+            {
+                InternalChildren = new Drawable[]
+                {
+                    new Circle
+                    {
+                        Anchor = Anchor.Centre,
+                        Origin = Anchor.Centre,
+                        Size = new Vector2(hand_thickness),
+                        Colour = Color4.White,
+                    },
+                    new Circle
+                    {
+                        Anchor = Anchor.Centre,
+                        Origin = Anchor.Centre,
+                        Size = new Vector2(hand_thickness * 0.7f),
+                        Colour = colours.PinkLight,
+                    },
+                };
+            }
+        }
+
+        private class SecondHand : CompositeDrawable
+        {
+            [BackgroundDependencyLoader]
+            private void load(OsuColour colours)
+            {
+                RelativeSizeAxes = Axes.X;
+                Width = 0.66f;
+
+                Height = hand_thickness * 0.7f;
+                Anchor = Anchor.Centre;
+                Origin = Anchor.Custom;
+
+                OriginPosition = new Vector2(Height * 2, Height / 2);
+
+                InternalChildren = new Drawable[]
+                {
+                    new Circle
+                    {
+                        Colour = colours.PinkLight,
+                        RelativeSizeAxes = Axes.Both,
+                    },
+                };
+            }
+        }
+
+        private class LargeHand : CompositeDrawable
+        {
+            public LargeHand(float length)
+            {
+                Width = length;
+            }
+
+            [BackgroundDependencyLoader]
+            private void load(OsuColour colours)
+            {
+                Anchor = Anchor.Centre;
+                Origin = Anchor.CentreLeft;
+
+                Origin = Anchor.Custom;
+                OriginPosition = new Vector2(hand_thickness / 2); // offset x also, to ensure the centre of the line is centered on the face.
+                Height = hand_thickness;
+
+                InternalChildren = new Drawable[]
+                {
+                    new Circle
+                    {
+                        Colour = Color4.White,
+                        RelativeSizeAxes = Axes.Both,
+                        BorderThickness = 0.7f,
+                        BorderColour = colours.Gray2,
+                    },
+                };
+
+                RelativeSizeAxes = Axes.X;
+            }
+        }
+    }
+}
diff --git a/osu.Game/Overlays/Toolbar/ClockDisplay.cs b/osu.Game/Overlays/Toolbar/ClockDisplay.cs
new file mode 100644
index 0000000000..c1befbb198
--- /dev/null
+++ b/osu.Game/Overlays/Toolbar/ClockDisplay.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 System;
+using osu.Framework.Graphics.Containers;
+
+namespace osu.Game.Overlays.Toolbar
+{
+    public abstract class ClockDisplay : CompositeDrawable
+    {
+        private int? lastSecond;
+
+        protected override void Update()
+        {
+            base.Update();
+
+            var now = DateTimeOffset.Now;
+
+            if (now.Second != lastSecond)
+            {
+                lastSecond = now.Second;
+                UpdateDisplay(now);
+            }
+        }
+
+        protected abstract void UpdateDisplay(DateTimeOffset now);
+    }
+}
diff --git a/osu.Game/Overlays/Toolbar/DigitalClockDisplay.cs b/osu.Game/Overlays/Toolbar/DigitalClockDisplay.cs
new file mode 100644
index 0000000000..090f8c4a0f
--- /dev/null
+++ b/osu.Game/Overlays/Toolbar/DigitalClockDisplay.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;
+using osu.Framework.Allocation;
+using osu.Framework.Graphics;
+using osu.Game.Graphics;
+using osu.Game.Graphics.Sprites;
+using osuTK;
+
+namespace osu.Game.Overlays.Toolbar
+{
+    public class DigitalClockDisplay : ClockDisplay
+    {
+        private OsuSpriteText realTime;
+        private OsuSpriteText gameTime;
+
+        private bool showRuntime = true;
+
+        public bool ShowRuntime
+        {
+            get => showRuntime;
+            set
+            {
+                if (showRuntime == value)
+                    return;
+
+                showRuntime = value;
+                updateMetrics();
+            }
+        }
+
+        [BackgroundDependencyLoader]
+        private void load(OsuColour colours)
+        {
+            AutoSizeAxes = Axes.Y;
+
+            InternalChildren = new Drawable[]
+            {
+                realTime = new OsuSpriteText(),
+                gameTime = new OsuSpriteText
+                {
+                    Y = 14,
+                    Colour = colours.PinkLight,
+                    Scale = new Vector2(0.6f)
+                }
+            };
+
+            updateMetrics();
+        }
+
+        protected override void UpdateDisplay(DateTimeOffset now)
+        {
+            realTime.Text = $"{now:HH:mm:ss}";
+            gameTime.Text = $"running {new TimeSpan(TimeSpan.TicksPerSecond * (int)(Clock.CurrentTime / 1000)):c}";
+        }
+
+        private void updateMetrics()
+        {
+            Width = showRuntime ? 66 : 45; // Allows for space for game time up to 99 days (in the padding area since this is quite rare).
+            gameTime.FadeTo(showRuntime ? 1 : 0);
+        }
+    }
+}
diff --git a/osu.Game/Overlays/Toolbar/ToolbarClock.cs b/osu.Game/Overlays/Toolbar/ToolbarClock.cs
index 68772d8fc3..332bfdf638 100644
--- a/osu.Game/Overlays/Toolbar/ToolbarClock.cs
+++ b/osu.Game/Overlays/Toolbar/ToolbarClock.cs
@@ -1,18 +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.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.Graphics;
-using osu.Game.Graphics.Sprites;
 using osuTK;
-using osuTK.Graphics;
 
 namespace osu.Game.Overlays.Toolbar
 {
@@ -20,10 +15,8 @@ namespace osu.Game.Overlays.Toolbar
     {
         private Bindable<ToolbarClockDisplayMode> clockDisplayMode;
 
-        private DigitalDisplay digital;
-        private AnalogDisplay analog;
-
-        private const float hand_thickness = 2.4f;
+        private DigitalClockDisplay digital;
+        private AnalogClockDisplay analog;
 
         public ToolbarClock()
         {
@@ -46,12 +39,12 @@ namespace osu.Game.Overlays.Toolbar
                 Spacing = new Vector2(5),
                 Children = new Drawable[]
                 {
-                    analog = new AnalogDisplay
+                    analog = new AnalogClockDisplay
                     {
                         Anchor = Anchor.CentreLeft,
                         Origin = Anchor.CentreLeft,
                     },
-                    digital = new DigitalDisplay
+                    digital = new DigitalClockDisplay
                     {
                         Anchor = Anchor.CentreLeft,
                         Origin = Anchor.CentreLeft,
@@ -104,220 +97,5 @@ namespace osu.Game.Overlays.Toolbar
                     break;
             }
         }
-
-        private class DigitalDisplay : ClockDisplay
-        {
-            private OsuSpriteText realTime;
-            private OsuSpriteText gameTime;
-
-            private bool showRuntime = true;
-
-            public bool ShowRuntime
-            {
-                get => showRuntime;
-                set
-                {
-                    if (showRuntime == value)
-                        return;
-
-                    showRuntime = value;
-                    updateMetrics();
-                }
-            }
-
-            [BackgroundDependencyLoader]
-            private void load(OsuColour colours)
-            {
-                AutoSizeAxes = Axes.Y;
-
-                InternalChildren = new Drawable[]
-                {
-                    realTime = new OsuSpriteText(),
-                    gameTime = new OsuSpriteText
-                    {
-                        Y = 14,
-                        Colour = colours.PinkLight,
-                        Scale = new Vector2(0.6f)
-                    }
-                };
-
-                updateMetrics();
-            }
-
-            protected override void UpdateDisplay(DateTimeOffset now)
-            {
-                realTime.Text = $"{now:HH:mm:ss}";
-                gameTime.Text = $"running {new TimeSpan(TimeSpan.TicksPerSecond * (int)(Clock.CurrentTime / 1000)):c}";
-            }
-
-            private void updateMetrics()
-            {
-                Width = showRuntime ? 66 : 45; // Allows for space for game time up to 99 days (in the padding area since this is quite rare).
-                gameTime.FadeTo(showRuntime ? 1 : 0);
-            }
-        }
-
-        private class AnalogDisplay : ClockDisplay
-        {
-            private Drawable hour;
-            private Drawable minute;
-            private Drawable second;
-
-            [BackgroundDependencyLoader]
-            private void load()
-            {
-                Size = new Vector2(22);
-
-                InternalChildren = new[]
-                {
-                    new CircularContainer
-                    {
-                        RelativeSizeAxes = Axes.Both,
-                        Masking = true,
-                        BorderThickness = 2,
-                        BorderColour = Color4.White,
-                        Child = new Box
-                        {
-                            AlwaysPresent = true,
-                            Alpha = 0,
-                            RelativeSizeAxes = Axes.Both
-                        },
-                    },
-                    hour = new LargeHand(0.34f),
-                    minute = new LargeHand(0.48f),
-                    second = new SecondHand(),
-                    new CentreCircle
-                    {
-                        Anchor = Anchor.Centre,
-                        Origin = Anchor.Centre,
-                    }
-                };
-            }
-
-            private class CentreCircle : CompositeDrawable
-            {
-                [BackgroundDependencyLoader]
-                private void load(OsuColour colours)
-                {
-                    InternalChildren = new Drawable[]
-                    {
-                        new Circle
-                        {
-                            Anchor = Anchor.Centre,
-                            Origin = Anchor.Centre,
-                            Size = new Vector2(hand_thickness),
-                            Colour = Color4.White,
-                        },
-                        new Circle
-                        {
-                            Anchor = Anchor.Centre,
-                            Origin = Anchor.Centre,
-                            Size = new Vector2(hand_thickness * 0.7f),
-                            Colour = colours.PinkLight,
-                        },
-                    };
-                }
-            }
-
-            private class SecondHand : CompositeDrawable
-            {
-                [BackgroundDependencyLoader]
-                private void load(OsuColour colours)
-                {
-                    RelativeSizeAxes = Axes.X;
-                    Width = 0.66f;
-
-                    Height = hand_thickness * 0.7f;
-                    Anchor = Anchor.Centre;
-                    Origin = Anchor.Custom;
-
-                    OriginPosition = new Vector2(Height * 2, Height / 2);
-
-                    InternalChildren = new Drawable[]
-                    {
-                        new Circle
-                        {
-                            Colour = colours.PinkLight,
-                            RelativeSizeAxes = Axes.Both,
-                        },
-                    };
-                }
-            }
-
-            private class LargeHand : CompositeDrawable
-            {
-                public LargeHand(float length)
-                {
-                    Width = length;
-                }
-
-                [BackgroundDependencyLoader]
-                private void load(OsuColour colours)
-                {
-                    Anchor = Anchor.Centre;
-                    Origin = Anchor.CentreLeft;
-
-                    Origin = Anchor.Custom;
-                    OriginPosition = new Vector2(hand_thickness / 2); // offset x also, to ensure the centre of the line is centered on the face.
-                    Height = hand_thickness;
-
-                    InternalChildren = new Drawable[]
-                    {
-                        new Circle
-                        {
-                            Colour = Color4.White,
-                            RelativeSizeAxes = Axes.Both,
-                            BorderThickness = 0.7f,
-                            BorderColour = colours.Gray2,
-                        },
-                    };
-
-                    RelativeSizeAxes = Axes.X;
-                }
-            }
-
-            protected override void UpdateDisplay(DateTimeOffset now)
-            {
-                float secondFractional = now.Second / 60f;
-                float minuteFractional = (now.Minute + secondFractional) / 60f;
-                float hourFractional = ((minuteFractional + now.Hour) % 12) / 12f;
-
-                updateRotation(hour, hourFractional);
-                updateRotation(minute, minuteFractional);
-                updateRotation(second, secondFractional);
-            }
-
-            private void updateRotation(Drawable hand, float fraction)
-            {
-                const float duration = 320;
-
-                float rotation = fraction * 360 - 90;
-
-                if (Math.Abs(hand.Rotation - rotation) > 180)
-                    hand.RotateTo(rotation);
-                else
-                    hand.RotateTo(rotation, duration, Easing.OutElastic);
-            }
-        }
-
-        private abstract class ClockDisplay : CompositeDrawable
-        {
-            private int? lastSecond;
-
-            protected override void Update()
-            {
-                base.Update();
-
-                var now = DateTimeOffset.Now;
-
-                if (now.Second != lastSecond)
-                {
-                    lastSecond = now.Second;
-                    UpdateDisplay(now);
-                }
-            }
-
-            protected abstract void UpdateDisplay(DateTimeOffset now);
-        }
     }
 }

From 9b7b897b3cd14508ff0bee285093480ba4dae9f0 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 26 Mar 2022 20:34:50 +0900
Subject: [PATCH 3744/5547] Adjust padding to fit better

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

diff --git a/osu.Game/Overlays/Toolbar/ToolbarClock.cs b/osu.Game/Overlays/Toolbar/ToolbarClock.cs
index 332bfdf638..ad5c9ac7a1 100644
--- a/osu.Game/Overlays/Toolbar/ToolbarClock.cs
+++ b/osu.Game/Overlays/Toolbar/ToolbarClock.cs
@@ -23,7 +23,7 @@ namespace osu.Game.Overlays.Toolbar
             RelativeSizeAxes = Axes.Y;
             AutoSizeAxes = Axes.X;
 
-            Padding = new MarginPadding(5);
+            Padding = new MarginPadding(10);
         }
 
         [BackgroundDependencyLoader]

From b6822f81909bea1f3fabd95e50dc9f50f410447a Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sat, 26 Mar 2022 14:55:19 +0300
Subject: [PATCH 3745/5547] Remove redundant/outdated `Origin` line

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

diff --git a/osu.Game/Overlays/Toolbar/AnalogClockDisplay.cs b/osu.Game/Overlays/Toolbar/AnalogClockDisplay.cs
index e100ee0c06..9228900e99 100644
--- a/osu.Game/Overlays/Toolbar/AnalogClockDisplay.cs
+++ b/osu.Game/Overlays/Toolbar/AnalogClockDisplay.cs
@@ -135,10 +135,10 @@ namespace osu.Game.Overlays.Toolbar
             private void load(OsuColour colours)
             {
                 Anchor = Anchor.Centre;
-                Origin = Anchor.CentreLeft;
-
                 Origin = Anchor.Custom;
+
                 OriginPosition = new Vector2(hand_thickness / 2); // offset x also, to ensure the centre of the line is centered on the face.
+
                 Height = hand_thickness;
 
                 InternalChildren = new Drawable[]

From 638453131714b4bc5305fd9a7fa50447b2edd07f Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Sun, 27 Mar 2022 01:39:31 +0900
Subject: [PATCH 3746/5547] Fix LogoVisualisation draw thread safety

---
 osu.Game/Screens/Menu/LogoVisualisation.cs | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/Menu/LogoVisualisation.cs b/osu.Game/Screens/Menu/LogoVisualisation.cs
index 4acd73bfa0..34f1d46067 100644
--- a/osu.Game/Screens/Menu/LogoVisualisation.cs
+++ b/osu.Game/Screens/Menu/LogoVisualisation.cs
@@ -176,7 +176,7 @@ namespace osu.Game.Screens.Menu
 
             private static readonly Color4 transparent_white = Color4.White.Opacity(0.2f);
 
-            private float[] audioData;
+            private readonly float[] audioData = new float[256];
 
             private readonly QuadBatch<TexturedVertex2D> vertexBatch = new QuadBatch<TexturedVertex2D>(100, 10);
 
@@ -192,7 +192,8 @@ namespace osu.Game.Screens.Menu
                 shader = Source.shader;
                 texture = Source.texture;
                 size = Source.DrawSize.X;
-                audioData = Source.frequencyAmplitudes;
+
+                Source.frequencyAmplitudes.AsSpan().CopyTo(audioData);
             }
 
             public override void Draw(Action<TexturedVertex2D> vertexAction)

From f400249f329627c71a5d2786d7629ee7f95596d0 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 26 Mar 2022 18:28:38 +0100
Subject: [PATCH 3747/5547] Fix multiplayer match settings overlay dropdown
 Z-ordering

---
 .../OnlinePlay/Match/Components/RoomSettingsOverlay.cs    | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Screens/OnlinePlay/Match/Components/RoomSettingsOverlay.cs b/osu.Game/Screens/OnlinePlay/Match/Components/RoomSettingsOverlay.cs
index 435c9aca02..c15b5b443a 100644
--- a/osu.Game/Screens/OnlinePlay/Match/Components/RoomSettingsOverlay.cs
+++ b/osu.Game/Screens/OnlinePlay/Match/Components/RoomSettingsOverlay.cs
@@ -7,6 +7,7 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Input.Bindings;
 using osu.Framework.Input.Events;
 using osu.Game.Graphics;
+using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Input.Bindings;
@@ -93,7 +94,12 @@ namespace osu.Game.Screens.OnlinePlay.Match.Components
         {
         }
 
-        protected class SectionContainer : FillFlowContainer<Section>
+        /// <remarks>
+        /// <see cref="ReverseChildIDFillFlowContainer{T}"/> is used to ensure that if the nested <see cref="Section"/>s
+        /// use expanded overhanging content (like an <see cref="OsuDropdown{T}"/>'s dropdown),
+        /// then the overhanging content will be correctly Z-ordered.
+        /// </remarks>
+        protected class SectionContainer : ReverseChildIDFillFlowContainer<Section>
         {
             public SectionContainer()
             {

From 69cc8636118a20400e5979b0dff958ea88176a5d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 26 Mar 2022 19:28:07 +0100
Subject: [PATCH 3748/5547] Fix test failures in skin editor test scene

---
 osu.Game.Tests/Visual/Gameplay/TestSceneSkinEditor.cs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSkinEditor.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSkinEditor.cs
index 38d83058c0..74ce9726e7 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSkinEditor.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSkinEditor.cs
@@ -37,6 +37,7 @@ namespace osu.Game.Tests.Visual.Gameplay
                 Player.ScaleTo(0.4f);
                 LoadComponentAsync(skinEditor = new SkinEditor(Player), Add);
             });
+            AddUntilStep("wait for loaded", () => skinEditor.IsLoaded);
         }
 
         [Test]

From 8c5594b3eadd8afb6db153d0726eaa0b48359f02 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 27 Mar 2022 14:38:06 +0900
Subject: [PATCH 3749/5547] Update fastlane (fix authorization failure)

---
 Gemfile.lock | 36 ++++++++++++++++++------------------
 1 file changed, 18 insertions(+), 18 deletions(-)

diff --git a/Gemfile.lock b/Gemfile.lock
index 1010027af9..ddab497657 100644
--- a/Gemfile.lock
+++ b/Gemfile.lock
@@ -8,17 +8,17 @@ GEM
     artifactory (3.0.15)
     atomos (0.1.3)
     aws-eventstream (1.2.0)
-    aws-partitions (1.553.0)
-    aws-sdk-core (3.126.0)
+    aws-partitions (1.570.0)
+    aws-sdk-core (3.130.0)
       aws-eventstream (~> 1, >= 1.0.2)
       aws-partitions (~> 1, >= 1.525.0)
       aws-sigv4 (~> 1.1)
       jmespath (~> 1.0)
-    aws-sdk-kms (1.54.0)
-      aws-sdk-core (~> 3, >= 3.126.0)
+    aws-sdk-kms (1.55.0)
+      aws-sdk-core (~> 3, >= 3.127.0)
       aws-sigv4 (~> 1.1)
-    aws-sdk-s3 (1.112.0)
-      aws-sdk-core (~> 3, >= 3.126.0)
+    aws-sdk-s3 (1.113.0)
+      aws-sdk-core (~> 3, >= 3.127.0)
       aws-sdk-kms (~> 1)
       aws-sigv4 (~> 1.4)
     aws-sigv4 (1.4.0)
@@ -36,8 +36,8 @@ GEM
       unf (>= 0.0.5, < 1.0.0)
     dotenv (2.7.6)
     emoji_regex (3.2.3)
-    excon (0.91.0)
-    faraday (1.9.3)
+    excon (0.92.1)
+    faraday (1.10.0)
       faraday-em_http (~> 1.0)
       faraday-em_synchrony (~> 1.0)
       faraday-excon (~> 1.1)
@@ -66,7 +66,7 @@ GEM
     faraday_middleware (1.2.0)
       faraday (~> 1.0)
     fastimage (2.2.6)
-    fastlane (2.204.2)
+    fastlane (2.205.1)
       CFPropertyList (>= 2.3, < 4.0.0)
       addressable (>= 2.8, < 3.0.0)
       artifactory (~> 3.0)
@@ -130,10 +130,10 @@ GEM
     google-cloud-core (1.6.0)
       google-cloud-env (~> 1.0)
       google-cloud-errors (~> 1.0)
-    google-cloud-env (1.5.0)
-      faraday (>= 0.17.3, < 2.0)
+    google-cloud-env (1.6.0)
+      faraday (>= 0.17.3, < 3.0)
     google-cloud-errors (1.2.0)
-    google-cloud-storage (1.36.0)
+    google-cloud-storage (1.36.1)
       addressable (~> 2.8)
       digest-crc (~> 0.4)
       google-apis-iamcredentials_v1 (~> 0.1)
@@ -141,8 +141,8 @@ GEM
       google-cloud-core (~> 1.6)
       googleauth (>= 0.16.2, < 2.a)
       mini_mime (~> 1.0)
-    googleauth (1.1.0)
-      faraday (>= 0.17.3, < 2.0)
+    googleauth (1.1.2)
+      faraday (>= 0.17.3, < 3.a)
       jwt (>= 1.4, < 3.0)
       memoist (~> 0.16)
       multi_json (~> 1.11)
@@ -152,7 +152,7 @@ GEM
     http-cookie (1.0.4)
       domain_name (~> 0.5)
     httpclient (2.8.3)
-    jmespath (1.5.0)
+    jmespath (1.6.1)
     json (2.6.1)
     jwt (2.3.0)
     memoist (0.16.2)
@@ -182,9 +182,9 @@ GEM
     ruby2_keywords (0.0.5)
     rubyzip (2.3.2)
     security (0.1.3)
-    signet (0.16.0)
+    signet (0.16.1)
       addressable (~> 2.8)
-      faraday (>= 0.17.3, < 2.0)
+      faraday (>= 0.17.5, < 3.0)
       jwt (>= 1.5, < 3.0)
       multi_json (~> 1.10)
     simctl (1.6.8)
@@ -205,7 +205,7 @@ GEM
     uber (0.1.0)
     unf (0.1.4)
       unf_ext
-    unf_ext (0.0.8)
+    unf_ext (0.0.8.1)
     unicode-display_width (1.8.0)
     webrick (1.7.0)
     word_wrap (1.0.0)

From de1fbda648a1ce13522b5f0a8faa602161df5e58 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sun, 27 Mar 2022 20:54:56 +0300
Subject: [PATCH 3750/5547] Clarify that searching includes both issues and Q&A
 discussions

---
 .github/ISSUE_TEMPLATE/bug-issue.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/ISSUE_TEMPLATE/bug-issue.yml b/.github/ISSUE_TEMPLATE/bug-issue.yml
index 5b19c3732c..d77b28316a 100644
--- a/.github/ISSUE_TEMPLATE/bug-issue.yml
+++ b/.github/ISSUE_TEMPLATE/bug-issue.yml
@@ -9,7 +9,7 @@ body:
         Important to note that your issue may have already been reported before. Please check:
         - Pinned issues, at the top of https://github.com/ppy/osu/issues.
         - Current open `priority:0` issues, filterable [here](https://github.com/ppy/osu/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc+label%3Apriority%3A0).
-        - And most importantly, search for your issue. If you find that it already exists, respond with a reaction or add any further information that may be helpful.
+        - And most importantly, search across the [issue listing](https://github.com/ppy/osu/issues) and [Q&A discussion listing](https://github.com/ppy/osu/discussions/categories/q-a) for your issue. If you find that it already exists, respond with a reaction or add any further information that may be helpful.
 
   - type: dropdown
     attributes:

From f847f9a31592d98e5070eaad37ef8e48cf313ae9 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sun, 27 Mar 2022 20:57:00 +0300
Subject: [PATCH 3751/5547] Exclude "open osu! folder" logs procedure from
 mobile platforms

---
 .github/ISSUE_TEMPLATE/bug-issue.yml | 16 ++++++++++++----
 1 file changed, 12 insertions(+), 4 deletions(-)

diff --git a/.github/ISSUE_TEMPLATE/bug-issue.yml b/.github/ISSUE_TEMPLATE/bug-issue.yml
index d77b28316a..8f54b5d1c8 100644
--- a/.github/ISSUE_TEMPLATE/bug-issue.yml
+++ b/.github/ISSUE_TEMPLATE/bug-issue.yml
@@ -48,19 +48,27 @@ body:
 
         Attaching log files is required for every reported bug. See instructions below on how to find them.
 
+        **Logs are reset when you reopen the game.** If the game crashed or has been closed since you found the bug, retrieve the logs using the file explorer instead.
+
+        ### Desktop platforms
+
         If the game has not yet been closed since you found the bug:
           1. Head on to game settings and click on "Open osu! folder"
           2. Then open the `logs` folder located there
 
-        **Logs are reset when you reopen the game.** If the game crashed or has been closed since you found the bug, retrieve the logs using the file explorer instead.
-
-        The default places to find the logs are as follows:
+        The default places to find the logs on desktop platforms are as follows:
           - `%AppData%/osu/logs` *on Windows*
           - `~/.local/share/osu/logs` *on Linux & macOS*
+
+        If you have selected a custom location for the game files, you can find the `logs` folder there.
+
+        ### Mobile platforms
+
+        The places to find the logs on mobile platforms are as follows:
           - `Android/data/sh.ppy.osulazer/files/logs` *on Android*
           - *On iOS*, they can be obtained by connecting your device to your desktop and copying the `logs` directory from the app's own document storage using iTunes. (https://support.apple.com/en-us/HT201301#copy-to-computer)
 
-        If you have selected a custom location for the game files, you can find the `logs` folder there.
+        ---
 
         After locating the `logs` folder, select all log files inside and drag them into the "Logs" box below.
 

From ebf520921520d486fbf99cd8c07b0e611b81fc0b Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sun, 27 Mar 2022 21:38:55 +0300
Subject: [PATCH 3752/5547] Reword issue searching note
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>
---
 .github/ISSUE_TEMPLATE/bug-issue.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/ISSUE_TEMPLATE/bug-issue.yml b/.github/ISSUE_TEMPLATE/bug-issue.yml
index 8f54b5d1c8..ea5ee298fb 100644
--- a/.github/ISSUE_TEMPLATE/bug-issue.yml
+++ b/.github/ISSUE_TEMPLATE/bug-issue.yml
@@ -9,7 +9,7 @@ body:
         Important to note that your issue may have already been reported before. Please check:
         - Pinned issues, at the top of https://github.com/ppy/osu/issues.
         - Current open `priority:0` issues, filterable [here](https://github.com/ppy/osu/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc+label%3Apriority%3A0).
-        - And most importantly, search across the [issue listing](https://github.com/ppy/osu/issues) and [Q&A discussion listing](https://github.com/ppy/osu/discussions/categories/q-a) for your issue. If you find that it already exists, respond with a reaction or add any further information that may be helpful.
+        - And most importantly, search for your issue both in the [issue listing](https://github.com/ppy/osu/issues) and the [Q&A discussion listing](https://github.com/ppy/osu/discussions/categories/q-a). If you find that it already exists, respond with a reaction or add any further information that may be helpful.
 
   - type: dropdown
     attributes:

From a98aac3bf2bbd0e03c46f4fb5eea7182e7b53d47 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 28 Mar 2022 17:33:15 +0900
Subject: [PATCH 3753/5547] Better inform users of migration failure reason
 when running Apply Silicon build

As mentioned in https://github.com/ppy/osu/discussions/17409#discussioncomment-2445464?
---
 osu.Game/Database/EFToRealmMigrator.cs | 34 ++++++++++++++++++++------
 1 file changed, 26 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Database/EFToRealmMigrator.cs b/osu.Game/Database/EFToRealmMigrator.cs
index cbf5c5ffe9..d3f7c561d5 100644
--- a/osu.Game/Database/EFToRealmMigrator.cs
+++ b/osu.Game/Database/EFToRealmMigrator.cs
@@ -1,6 +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 enable
+
+using System;
 using System.IO;
 using System.Linq;
 using System.Threading.Tasks;
@@ -14,6 +17,7 @@ using osu.Framework.Platform;
 using osu.Game.Beatmaps;
 using osu.Game.Configuration;
 using osu.Game.Graphics;
+using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Models;
@@ -29,8 +33,6 @@ using SharpCompress.Archives.Zip;
 using SharpCompress.Common;
 using SharpCompress.Writers.Zip;
 
-#nullable enable
-
 namespace osu.Game.Database
 {
     internal class EFToRealmMigrator : CompositeDrawable
@@ -57,7 +59,7 @@ namespace osu.Game.Database
         [Resolved]
         private Storage storage { get; set; } = null!;
 
-        private readonly OsuSpriteText currentOperationText;
+        private readonly OsuTextFlowContainer currentOperationText;
 
         public EFToRealmMigrator()
         {
@@ -99,11 +101,13 @@ namespace osu.Game.Database
                         {
                             State = { Value = Visibility.Visible }
                         },
-                        currentOperationText = new OsuSpriteText
+                        currentOperationText = new OsuTextFlowContainer(cp => cp.Font = OsuFont.Default.With(size: 30))
                         {
                             Anchor = Anchor.Centre,
                             Origin = Anchor.Centre,
-                            Font = OsuFont.Default.With(size: 30)
+                            AutoSizeAxes = Axes.Y,
+                            RelativeSizeAxes = Axes.X,
+                            TextAnchor = Anchor.TopCentre,
                         },
                     }
                 },
@@ -147,19 +151,33 @@ namespace osu.Game.Database
                     log("Migration successful!");
 
                     if (DebugUtils.IsDebugBuild)
-                        Logger.Log("Your development database has been fully migrated to realm. If you switch back to a pre-realm branch and need your previous database, rename the backup file back to \"client.db\".\n\nNote that doing this can potentially leave your file store in a bad state.", level: LogLevel.Important);
+                    {
+                        Logger.Log(
+                            "Your development database has been fully migrated to realm. If you switch back to a pre-realm branch and need your previous database, rename the backup file back to \"client.db\".\n\nNote that doing this can potentially leave your file store in a bad state.",
+                            level: LogLevel.Important);
+                    }
                 }
                 else
                 {
                     log("Migration failed!");
                     Logger.Log(t.Exception.ToString(), LoggingTarget.Database);
 
+                    if (t.Exception.Flatten().InnerException is TypeInitializationException)
+                    {
+                        // Not guaranteed to be the only cause of exception, but let's roll with it for now.
+                        log("Please download and run the intel version of osu! once\nto allow data migration to complete!");
+                        return;
+                    }
+
                     notificationOverlay.Post(new SimpleErrorNotification
                     {
-                        Text = "IMPORTANT: During data migration, some of your data could not be successfully migrated. The previous version has been backed up.\n\nFor further assistance, please open a discussion on github and attach your backup files (click to get started).",
+                        Text =
+                            "IMPORTANT: During data migration, some of your data could not be successfully migrated. The previous version has been backed up.\n\nFor further assistance, please open a discussion on github and attach your backup files (click to get started).",
                         Activated = () =>
                         {
-                            game.OpenUrlExternally($@"https://github.com/ppy/osu/discussions/new?title=Realm%20migration%20issue ({t.Exception.Message})&body=Please%20drag%20the%20""attach_me.zip""%20file%20here!&category=q-a", true);
+                            game.OpenUrlExternally(
+                                $@"https://github.com/ppy/osu/discussions/new?title=Realm%20migration%20issue ({t.Exception.Message})&body=Please%20drag%20the%20""attach_me.zip""%20file%20here!&category=q-a",
+                                true);
 
                             const string attachment_filename = "attach_me.zip";
                             const string backup_folder = "backups";

From b5834dabdb12a9c63d4b676fb906ee01896a372a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 28 Mar 2022 20:43:23 +0900
Subject: [PATCH 3754/5547] Fix skin editor not exiting correctly when using
 the menu

Closes https://github.com/ppy/osu/issues/17489.
---
 osu.Game/Skinning/Editor/SkinEditor.cs | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Skinning/Editor/SkinEditor.cs b/osu.Game/Skinning/Editor/SkinEditor.cs
index 4cc7e0bcdb..7bf4e94662 100644
--- a/osu.Game/Skinning/Editor/SkinEditor.cs
+++ b/osu.Game/Skinning/Editor/SkinEditor.cs
@@ -42,6 +42,9 @@ namespace osu.Game.Skinning.Editor
         [Resolved]
         private OsuColour colours { get; set; }
 
+        [Resolved(canBeNull: true)]
+        private SkinEditorOverlay skinEditorOverlay { get; set; }
+
         [Cached]
         private readonly OverlayColourProvider colourProvider = new OverlayColourProvider(OverlayColourScheme.Blue);
 
@@ -107,7 +110,7 @@ namespace osu.Game.Skinning.Editor
                                                     new EditorMenuItem("Save", MenuItemType.Standard, Save),
                                                     new EditorMenuItem("Revert to default", MenuItemType.Destructive, revert),
                                                     new EditorMenuItemSpacer(),
-                                                    new EditorMenuItem("Exit", MenuItemType.Standard, Hide),
+                                                    new EditorMenuItem("Exit", MenuItemType.Standard, () => skinEditorOverlay?.Hide()),
                                                 },
                                             },
                                         }

From a0692ce47780c05a907439172f3ae85a6b0b80a3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 28 Mar 2022 22:20:56 +0900
Subject: [PATCH 3755/5547] Add a `const` for system users which should never
 display a profile

---
 osu.Game/Online/API/Requests/Responses/APIUser.cs | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Online/API/Requests/Responses/APIUser.cs b/osu.Game/Online/API/Requests/Responses/APIUser.cs
index a53ac1cd9b..a87f0811a1 100644
--- a/osu.Game/Online/API/Requests/Responses/APIUser.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIUser.cs
@@ -15,6 +15,11 @@ namespace osu.Game.Online.API.Requests.Responses
     [JsonObject(MemberSerialization.OptIn)]
     public class APIUser : IEquatable<APIUser>, IUser
     {
+        /// <summary>
+        /// A user ID which can be used to represent any system user which is not attached to a user profile.
+        /// </summary>
+        public const int SYSTEM_USER_ID = 0;
+
         [JsonProperty(@"id")]
         public int Id { get; set; } = 1;
 
@@ -238,7 +243,7 @@ namespace osu.Game.Online.API.Requests.Responses
         /// </summary>
         public static readonly APIUser SYSTEM_USER = new APIUser
         {
-            Id = 0,
+            Id = SYSTEM_USER_ID,
             Username = "system",
             Colour = @"9c0101",
         };

From d2d88015e32927ab8704b273c2a090630cce084c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 28 Mar 2022 22:21:23 +0900
Subject: [PATCH 3756/5547] Update all cinema/autoplay mods to specify the
 system user ID

---
 .../Mods/EmptyFreeformModAutoplay.cs                     | 6 +++++-
 .../Mods/PippidonModAutoplay.cs                          | 6 +++++-
 .../Mods/EmptyScrollingModAutoplay.cs                    | 6 +++++-
 .../Mods/PippidonModAutoplay.cs                          | 6 +++++-
 osu.Game.Rulesets.Catch/Mods/CatchModAutoplay.cs         | 9 ++++++++-
 osu.Game.Rulesets.Catch/Mods/CatchModCinema.cs           | 9 ++++++++-
 osu.Game.Rulesets.Mania/Mods/ManiaModAutoplay.cs         | 9 ++++++++-
 osu.Game.Rulesets.Mania/Mods/ManiaModCinema.cs           | 9 ++++++++-
 osu.Game.Rulesets.Osu/Mods/OsuModAutoplay.cs             | 9 ++++++++-
 osu.Game.Rulesets.Osu/Mods/OsuModCinema.cs               | 9 ++++++++-
 osu.Game.Rulesets.Taiko/Mods/TaikoModAutoplay.cs         | 9 ++++++++-
 osu.Game.Rulesets.Taiko/Mods/TaikoModCinema.cs           | 9 ++++++++-
 12 files changed, 84 insertions(+), 12 deletions(-)

diff --git a/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform/Mods/EmptyFreeformModAutoplay.cs b/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform/Mods/EmptyFreeformModAutoplay.cs
index d4496a24fd..9c2a108c4e 100644
--- a/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform/Mods/EmptyFreeformModAutoplay.cs
+++ b/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform/Mods/EmptyFreeformModAutoplay.cs
@@ -16,7 +16,11 @@ namespace osu.Game.Rulesets.EmptyFreeform.Mods
         {
             ScoreInfo = new ScoreInfo
             {
-                User = new APIUser { Username = "sample" },
+                User = new APIUser
+                {
+                    Id = APIUser.SYSTEM_USER_ID,
+                    Username = "sample"
+                },
             },
             Replay = new EmptyFreeformAutoGenerator(beatmap).Generate(),
         };
diff --git a/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon/Mods/PippidonModAutoplay.cs b/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon/Mods/PippidonModAutoplay.cs
index 6e1fe42ee2..6683856a1a 100644
--- a/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon/Mods/PippidonModAutoplay.cs
+++ b/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon/Mods/PippidonModAutoplay.cs
@@ -16,7 +16,11 @@ namespace osu.Game.Rulesets.Pippidon.Mods
         {
             ScoreInfo = new ScoreInfo
             {
-                User = new APIUser { Username = "sample" },
+                User = new APIUser
+                {
+                    Id = APIUser.SYSTEM_USER_ID,
+                    Username = "sample"
+                },
             },
             Replay = new PippidonAutoGenerator(beatmap).Generate(),
         };
diff --git a/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling/Mods/EmptyScrollingModAutoplay.cs b/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling/Mods/EmptyScrollingModAutoplay.cs
index c5bacb522f..e3cecc7b44 100644
--- a/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling/Mods/EmptyScrollingModAutoplay.cs
+++ b/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling/Mods/EmptyScrollingModAutoplay.cs
@@ -16,7 +16,11 @@ namespace osu.Game.Rulesets.EmptyScrolling.Mods
         {
             ScoreInfo = new ScoreInfo
             {
-                User = new APIUser { Username = "sample" },
+                User = new APIUser
+                {
+                    Id = APIUser.SYSTEM_USER_ID,
+                    Username = "sample"
+                },
             },
             Replay = new EmptyScrollingAutoGenerator(beatmap).Generate(),
         };
diff --git a/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon/Mods/PippidonModAutoplay.cs b/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon/Mods/PippidonModAutoplay.cs
index 6e1fe42ee2..6683856a1a 100644
--- a/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon/Mods/PippidonModAutoplay.cs
+++ b/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon/Mods/PippidonModAutoplay.cs
@@ -16,7 +16,11 @@ namespace osu.Game.Rulesets.Pippidon.Mods
         {
             ScoreInfo = new ScoreInfo
             {
-                User = new APIUser { Username = "sample" },
+                User = new APIUser
+                {
+                    Id = APIUser.SYSTEM_USER_ID,
+                    Username = "sample"
+                },
             },
             Replay = new PippidonAutoGenerator(beatmap).Generate(),
         };
diff --git a/osu.Game.Rulesets.Catch/Mods/CatchModAutoplay.cs b/osu.Game.Rulesets.Catch/Mods/CatchModAutoplay.cs
index 11fffb31de..fbbb610035 100644
--- a/osu.Game.Rulesets.Catch/Mods/CatchModAutoplay.cs
+++ b/osu.Game.Rulesets.Catch/Mods/CatchModAutoplay.cs
@@ -14,7 +14,14 @@ namespace osu.Game.Rulesets.Catch.Mods
     {
         public override Score CreateReplayScore(IBeatmap beatmap, IReadOnlyList<Mod> mods) => new Score
         {
-            ScoreInfo = new ScoreInfo { User = new APIUser { Username = "osu!salad" } },
+            ScoreInfo = new ScoreInfo
+            {
+                User = new APIUser
+                {
+                    Id = APIUser.SYSTEM_USER_ID,
+                    Username = "osu!salad"
+                }
+            },
             Replay = new CatchAutoGenerator(beatmap).Generate(),
         };
     }
diff --git a/osu.Game.Rulesets.Catch/Mods/CatchModCinema.cs b/osu.Game.Rulesets.Catch/Mods/CatchModCinema.cs
index 6d2286b957..2f4769048f 100644
--- a/osu.Game.Rulesets.Catch/Mods/CatchModCinema.cs
+++ b/osu.Game.Rulesets.Catch/Mods/CatchModCinema.cs
@@ -15,7 +15,14 @@ namespace osu.Game.Rulesets.Catch.Mods
     {
         public override Score CreateReplayScore(IBeatmap beatmap, IReadOnlyList<Mod> mods) => new Score
         {
-            ScoreInfo = new ScoreInfo { User = new APIUser { Username = "osu!salad" } },
+            ScoreInfo = new ScoreInfo
+            {
+                User = new APIUser
+                {
+                    Id = APIUser.SYSTEM_USER_ID,
+                    Username = "osu!salad"
+                }
+            },
             Replay = new CatchAutoGenerator(beatmap).Generate(),
         };
     }
diff --git a/osu.Game.Rulesets.Mania/Mods/ManiaModAutoplay.cs b/osu.Game.Rulesets.Mania/Mods/ManiaModAutoplay.cs
index 1504c868d0..4eea0d4a44 100644
--- a/osu.Game.Rulesets.Mania/Mods/ManiaModAutoplay.cs
+++ b/osu.Game.Rulesets.Mania/Mods/ManiaModAutoplay.cs
@@ -15,7 +15,14 @@ namespace osu.Game.Rulesets.Mania.Mods
     {
         public override Score CreateReplayScore(IBeatmap beatmap, IReadOnlyList<Mod> mods) => new Score
         {
-            ScoreInfo = new ScoreInfo { User = new APIUser { Username = "osu!topus" } },
+            ScoreInfo = new ScoreInfo
+            {
+                User = new APIUser
+                {
+                    Id = APIUser.SYSTEM_USER_ID,
+                    Username = "osu!topus"
+                }
+            },
             Replay = new ManiaAutoGenerator((ManiaBeatmap)beatmap).Generate(),
         };
     }
diff --git a/osu.Game.Rulesets.Mania/Mods/ManiaModCinema.cs b/osu.Game.Rulesets.Mania/Mods/ManiaModCinema.cs
index 4f1276946b..0aa419bbcb 100644
--- a/osu.Game.Rulesets.Mania/Mods/ManiaModCinema.cs
+++ b/osu.Game.Rulesets.Mania/Mods/ManiaModCinema.cs
@@ -16,7 +16,14 @@ namespace osu.Game.Rulesets.Mania.Mods
     {
         public override Score CreateReplayScore(IBeatmap beatmap, IReadOnlyList<Mod> mods) => new Score
         {
-            ScoreInfo = new ScoreInfo { User = new APIUser { Username = "osu!topus" } },
+            ScoreInfo = new ScoreInfo
+            {
+                User = new APIUser
+                {
+                    Id = APIUser.SYSTEM_USER_ID,
+                    Username = "osu!topus"
+                }
+            },
             Replay = new ManiaAutoGenerator((ManiaBeatmap)beatmap).Generate(),
         };
     }
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModAutoplay.cs b/osu.Game.Rulesets.Osu/Mods/OsuModAutoplay.cs
index 2668013321..c5b1c55c40 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModAutoplay.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModAutoplay.cs
@@ -18,7 +18,14 @@ namespace osu.Game.Rulesets.Osu.Mods
 
         public override Score CreateReplayScore(IBeatmap beatmap, IReadOnlyList<Mod> mods) => new Score
         {
-            ScoreInfo = new ScoreInfo { User = new APIUser { Username = "Autoplay" } },
+            ScoreInfo = new ScoreInfo
+            {
+                User = new APIUser
+                {
+                    Id = APIUser.SYSTEM_USER_ID,
+                    Username = "Autoplay",
+                }
+            },
             Replay = new OsuAutoGenerator(beatmap, mods).Generate()
         };
     }
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModCinema.cs b/osu.Game.Rulesets.Osu/Mods/OsuModCinema.cs
index ff31cfcd18..83e6f0efb5 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModCinema.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModCinema.cs
@@ -19,7 +19,14 @@ namespace osu.Game.Rulesets.Osu.Mods
 
         public override Score CreateReplayScore(IBeatmap beatmap, IReadOnlyList<Mod> mods) => new Score
         {
-            ScoreInfo = new ScoreInfo { User = new APIUser { Username = "Autoplay" } },
+            ScoreInfo = new ScoreInfo
+            {
+                User = new APIUser
+                {
+                    Id = APIUser.SYSTEM_USER_ID,
+                    Username = "Autoplay"
+                }
+            },
             Replay = new OsuAutoGenerator(beatmap, mods).Generate()
         };
     }
diff --git a/osu.Game.Rulesets.Taiko/Mods/TaikoModAutoplay.cs b/osu.Game.Rulesets.Taiko/Mods/TaikoModAutoplay.cs
index 5832ae3dc1..b9bf3ab1b4 100644
--- a/osu.Game.Rulesets.Taiko/Mods/TaikoModAutoplay.cs
+++ b/osu.Game.Rulesets.Taiko/Mods/TaikoModAutoplay.cs
@@ -14,7 +14,14 @@ namespace osu.Game.Rulesets.Taiko.Mods
     {
         public override Score CreateReplayScore(IBeatmap beatmap, IReadOnlyList<Mod> mods) => new Score
         {
-            ScoreInfo = new ScoreInfo { User = new APIUser { Username = "mekkadosu!" } },
+            ScoreInfo = new ScoreInfo
+            {
+                User = new APIUser
+                {
+                    Id = APIUser.SYSTEM_USER_ID,
+                    Username = "mekkadosu!"
+                }
+            },
             Replay = new TaikoAutoGenerator(beatmap).Generate(),
         };
     }
diff --git a/osu.Game.Rulesets.Taiko/Mods/TaikoModCinema.cs b/osu.Game.Rulesets.Taiko/Mods/TaikoModCinema.cs
index f76e04a069..6ecf8a3b3d 100644
--- a/osu.Game.Rulesets.Taiko/Mods/TaikoModCinema.cs
+++ b/osu.Game.Rulesets.Taiko/Mods/TaikoModCinema.cs
@@ -15,7 +15,14 @@ namespace osu.Game.Rulesets.Taiko.Mods
     {
         public override Score CreateReplayScore(IBeatmap beatmap, IReadOnlyList<Mod> mods) => new Score
         {
-            ScoreInfo = new ScoreInfo { User = new APIUser { Username = "mekkadosu!" } },
+            ScoreInfo = new ScoreInfo
+            {
+                User = new APIUser
+                {
+                    Id = APIUser.SYSTEM_USER_ID,
+                    Username = "mekkadosu!"
+                }
+            },
             Replay = new TaikoAutoGenerator(beatmap).Generate(),
         };
     }

From dc7dc7f65ac7a3ef3a0f3d1cd9edd06ae0186099 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 28 Mar 2022 22:50:31 +0900
Subject: [PATCH 3757/5547] Update `UserProfileOverlay` and `ClickableAvatar`
 to treat system users more correctly

---
 osu.Game/Overlays/UserProfileOverlay.cs     | 2 +-
 osu.Game/Users/Drawables/ClickableAvatar.cs | 6 ++++--
 2 files changed, 5 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Overlays/UserProfileOverlay.cs b/osu.Game/Overlays/UserProfileOverlay.cs
index 9fac1463f2..518a2bf9c8 100644
--- a/osu.Game/Overlays/UserProfileOverlay.cs
+++ b/osu.Game/Overlays/UserProfileOverlay.cs
@@ -41,7 +41,7 @@ namespace osu.Game.Overlays
 
         public void ShowUser(IUser user)
         {
-            if (user == APIUser.SYSTEM_USER)
+            if (user.OnlineID == APIUser.SYSTEM_USER_ID)
                 return;
 
             Show();
diff --git a/osu.Game/Users/Drawables/ClickableAvatar.cs b/osu.Game/Users/Drawables/ClickableAvatar.cs
index 34c87568a1..0dd135b500 100644
--- a/osu.Game/Users/Drawables/ClickableAvatar.cs
+++ b/osu.Game/Users/Drawables/ClickableAvatar.cs
@@ -21,7 +21,7 @@ namespace osu.Game.Users.Drawables
         /// </summary>
         public bool OpenOnClick
         {
-            set => clickableArea.Enabled.Value = value;
+            set => clickableArea.Enabled.Value = clickableArea.Action != null && value;
         }
 
         /// <summary>
@@ -52,8 +52,10 @@ namespace osu.Game.Users.Drawables
             Add(clickableArea = new ClickableArea
             {
                 RelativeSizeAxes = Axes.Both,
-                Action = openProfile
             });
+
+            if (user?.Id != APIUser.SYSTEM_USER_ID)
+                clickableArea.Action = openProfile;
         }
 
         [BackgroundDependencyLoader]

From 05a978ce8c255d0ebfaf395f68f31d3446e3f281 Mon Sep 17 00:00:00 2001
From: Sebastian Krajewski <mail@wieku.me>
Date: Mon, 28 Mar 2022 16:36:37 +0200
Subject: [PATCH 3758/5547] Update LegacyComboCounter layout and scaling

---
 .../Screens/Play/HUD/LegacyComboCounter.cs    | 58 +++++++++++++------
 1 file changed, 40 insertions(+), 18 deletions(-)

diff --git a/osu.Game/Screens/Play/HUD/LegacyComboCounter.cs b/osu.Game/Screens/Play/HUD/LegacyComboCounter.cs
index 9510453ba5..a49d09e839 100644
--- a/osu.Game/Screens/Play/HUD/LegacyComboCounter.cs
+++ b/osu.Game/Screens/Play/HUD/LegacyComboCounter.cs
@@ -21,7 +21,9 @@ namespace osu.Game.Screens.Play.HUD
 
         private uint scheduledPopOutCurrentId;
 
-        private const double pop_out_duration = 150;
+        private const double big_pop_out_duration = 300;
+
+        private const double small_pop_out_duration = 100;
 
         private const double fade_out_duration = 100;
 
@@ -65,32 +67,28 @@ namespace osu.Game.Screens.Play.HUD
 
             Margin = new MarginPadding(10);
 
-            Scale = new Vector2(1.2f);
+            Scale = new Vector2(1.3f);
 
             InternalChildren = new[]
             {
                 counterContainer = new Container
                 {
-                    AutoSizeAxes = Axes.Both,
                     AlwaysPresent = true,
                     Children = new[]
                     {
                         popOutCount = new LegacySpriteText(LegacyFont.Combo)
                         {
                             Alpha = 0,
-                            Margin = new MarginPadding(0.05f),
                             Blending = BlendingParameters.Additive,
                             Anchor = Anchor.BottomLeft,
-                            Origin = Anchor.BottomLeft,
                             BypassAutoSizeAxes = Axes.Both,
                         },
                         displayedCountSpriteText = new LegacySpriteText(LegacyFont.Combo)
                         {
-                            // Initial text and AlwaysPresent allow the counter to have a size before it first displays a combo.
-                            // This is useful for display in the skin editor.
-                            Text = formatCount(0),
-                            AlwaysPresent = true,
                             Alpha = 0,
+                            AlwaysPresent = true,
+                            Anchor = Anchor.BottomLeft,
+                            BypassAutoSizeAxes = Axes.Both,
                         },
                     }
                 }
@@ -120,9 +118,12 @@ namespace osu.Game.Screens.Play.HUD
         }
 
         [BackgroundDependencyLoader]
-        private void load(ScoreProcessor scoreProcessor)
+        private void load(ScoreProcessor scoreProcessor, ISkinSource skin)
         {
             Current.BindTo(scoreProcessor.Combo);
+
+            // Since layout depends on combo font height we need to update it during skin change
+            skin.SourceChanged += updateLayout;
         }
 
         protected override void LoadComplete()
@@ -130,10 +131,28 @@ namespace osu.Game.Screens.Play.HUD
             base.LoadComplete();
 
             ((IHasText)displayedCountSpriteText).Text = formatCount(Current.Value);
+            ((IHasText)popOutCount).Text = formatCount(Current.Value);
+
+            updateLayout();
 
             Current.BindValueChanged(combo => updateCount(combo.NewValue == 0), true);
         }
 
+        private void updateLayout()
+        {
+            // Eye-balled to match stable
+            const float font_height_ratio = 0.625f;
+            const float vertical_offset = 9;
+
+            displayedCountSpriteText.OriginPosition = new Vector2(0, font_height_ratio * displayedCountSpriteText.Height + vertical_offset);
+            displayedCountSpriteText.Position = new Vector2(0, -(1 - font_height_ratio) * displayedCountSpriteText.Height + vertical_offset);
+
+            popOutCount.OriginPosition = new Vector2(3, font_height_ratio * popOutCount.Height + vertical_offset); // In stable, the bigger pop out scales a bit to the left
+            popOutCount.Position = new Vector2(0, -(1 - font_height_ratio) * popOutCount.Height + vertical_offset);
+
+            counterContainer.Size = displayedCountSpriteText.Size;
+        }
+
         private void updateCount(bool rolling)
         {
             int prev = previousValue;
@@ -165,26 +184,29 @@ namespace osu.Game.Screens.Play.HUD
             ((IHasText)popOutCount).Text = formatCount(newValue);
 
             popOutCount.ScaleTo(1.6f);
-            popOutCount.FadeTo(0.75f);
-            popOutCount.MoveTo(Vector2.Zero);
+            popOutCount.FadeTo(0.6f);
 
-            popOutCount.ScaleTo(1, pop_out_duration);
-            popOutCount.FadeOut(pop_out_duration);
-            popOutCount.MoveTo(displayedCountSpriteText.Position, pop_out_duration);
+            popOutCount.ScaleTo(1, big_pop_out_duration);
+            popOutCount.FadeOut(big_pop_out_duration);
         }
 
         private void transformNoPopOut(int newValue)
         {
             ((IHasText)displayedCountSpriteText).Text = formatCount(newValue);
 
+            counterContainer.Size = displayedCountSpriteText.Size;
+
             displayedCountSpriteText.ScaleTo(1);
         }
 
         private void transformPopOutSmall(int newValue)
         {
             ((IHasText)displayedCountSpriteText).Text = formatCount(newValue);
-            displayedCountSpriteText.ScaleTo(1.1f);
-            displayedCountSpriteText.ScaleTo(1, pop_out_duration);
+
+            counterContainer.Size = displayedCountSpriteText.Size;
+
+            displayedCountSpriteText.ScaleTo(1.1f, small_pop_out_duration / 2, Easing.InQuad).Then()
+                                    .ScaleTo(1, small_pop_out_duration / 2, Easing.OutQuad);
         }
 
         private void scheduledPopOutSmall(uint id)
@@ -212,7 +234,7 @@ namespace osu.Game.Screens.Play.HUD
             Scheduler.AddDelayed(delegate
             {
                 scheduledPopOutSmall(newTaskId);
-            }, pop_out_duration);
+            }, big_pop_out_duration - 140);
         }
 
         private void onCountRolling(int currentValue, int newValue)

From 7059e4bf9463a1adf45b2dc707e9cba5f4ac2be7 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 28 Mar 2022 23:37:39 +0900
Subject: [PATCH 3759/5547] Add test coverage for autoplay avatar not being
 clickable

---
 osu.Game.Tests/Visual/Gameplay/TestSceneAutoplay.cs | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneAutoplay.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneAutoplay.cs
index fdc3916c47..518ab5a1d3 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneAutoplay.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneAutoplay.cs
@@ -5,12 +5,14 @@ using System.ComponentModel;
 using System.Linq;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps.Timing;
+using osu.Game.Graphics.Containers;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Scoring;
 using osu.Game.Screens.Play;
 using osu.Game.Screens.Play.Break;
 using osu.Game.Screens.Ranking;
+using osu.Game.Users.Drawables;
 
 namespace osu.Game.Tests.Visual.Gameplay
 {
@@ -39,11 +41,18 @@ namespace osu.Game.Tests.Visual.Gameplay
             seekToBreak(1);
 
             AddStep("seek to completion", () => Player.GameplayClockContainer.Seek(Player.DrawableRuleset.Objects.Last().GetEndTime()));
-            AddUntilStep("results displayed", () => getResultsScreen() != null);
+
+            AddUntilStep("results displayed", () => getResultsScreen()?.IsLoaded == true);
 
             AddAssert("score has combo", () => getResultsScreen().Score.Combo > 100);
             AddAssert("score has no misses", () => getResultsScreen().Score.Statistics[HitResult.Miss] == 0);
 
+            AddUntilStep("avatar dispalyed", () => getAvatar() != null);
+            AddAssert("avatar not clickable", () => getAvatar().ChildrenOfType<OsuClickableContainer>().First().Action == null);
+
+            ClickableAvatar getAvatar() => getResultsScreen()
+                                           .ChildrenOfType<ClickableAvatar>().FirstOrDefault();
+
             ResultsScreen getResultsScreen() => Stack.CurrentScreen as ResultsScreen;
         }
 

From b6ae0ebb6f9ec7b561659d67327971e1a484ff87 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 28 Mar 2022 23:46:04 +0900
Subject: [PATCH 3760/5547] Limit macOS specific log output to macOS platforms
 specifically

---
 osu.Game/Database/EFToRealmMigrator.cs | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Database/EFToRealmMigrator.cs b/osu.Game/Database/EFToRealmMigrator.cs
index d3f7c561d5..d6460bc9d3 100644
--- a/osu.Game/Database/EFToRealmMigrator.cs
+++ b/osu.Game/Database/EFToRealmMigrator.cs
@@ -8,6 +8,7 @@ using System.IO;
 using System.Linq;
 using System.Threading.Tasks;
 using Microsoft.EntityFrameworkCore;
+using osu.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Development;
 using osu.Framework.Graphics;
@@ -162,7 +163,7 @@ namespace osu.Game.Database
                     log("Migration failed!");
                     Logger.Log(t.Exception.ToString(), LoggingTarget.Database);
 
-                    if (t.Exception.Flatten().InnerException is TypeInitializationException)
+                    if (RuntimeInfo.OS == RuntimeInfo.Platform.macOS && t.Exception.Flatten().InnerException is TypeInitializationException)
                     {
                         // Not guaranteed to be the only cause of exception, but let's roll with it for now.
                         log("Please download and run the intel version of osu! once\nto allow data migration to complete!");

From ea46e024c1f883fb73d655010fe69853e9bfa22e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 28 Mar 2022 23:59:11 +0900
Subject: [PATCH 3761/5547] Avoid deadlock during migration failed exit process

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

diff --git a/osu.Game/Database/EFToRealmMigrator.cs b/osu.Game/Database/EFToRealmMigrator.cs
index d6460bc9d3..ae73e13b77 100644
--- a/osu.Game/Database/EFToRealmMigrator.cs
+++ b/osu.Game/Database/EFToRealmMigrator.cs
@@ -167,6 +167,7 @@ namespace osu.Game.Database
                     {
                         // Not guaranteed to be the only cause of exception, but let's roll with it for now.
                         log("Please download and run the intel version of osu! once\nto allow data migration to complete!");
+                        efContextFactory.SetMigrationCompletion();
                         return;
                     }
 

From 001a98e069940a69eb4d30d1e036eb42f95ac62e Mon Sep 17 00:00:00 2001
From: Sebastian Krajewski <mail@wieku.me>
Date: Mon, 28 Mar 2022 18:08:35 +0200
Subject: [PATCH 3762/5547] Fix LegacyComboCounter not unsubscribing from skin

---
 .../Screens/Play/HUD/LegacyComboCounter.cs    | 22 ++++++++++++++-----
 1 file changed, 16 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Screens/Play/HUD/LegacyComboCounter.cs b/osu.Game/Screens/Play/HUD/LegacyComboCounter.cs
index a49d09e839..158cb92a1c 100644
--- a/osu.Game/Screens/Play/HUD/LegacyComboCounter.cs
+++ b/osu.Game/Screens/Play/HUD/LegacyComboCounter.cs
@@ -44,6 +44,9 @@ namespace osu.Game.Screens.Play.HUD
 
         private readonly Container counterContainer;
 
+        [Resolved]
+        private ISkinSource skin { get; set; }
+
         /// <summary>
         /// Hides the combo counter internally without affecting its <see cref="SkinnableInfo"/>.
         /// </summary>
@@ -118,12 +121,9 @@ namespace osu.Game.Screens.Play.HUD
         }
 
         [BackgroundDependencyLoader]
-        private void load(ScoreProcessor scoreProcessor, ISkinSource skin)
+        private void load(ScoreProcessor scoreProcessor)
         {
             Current.BindTo(scoreProcessor.Combo);
-
-            // Since layout depends on combo font height we need to update it during skin change
-            skin.SourceChanged += updateLayout;
         }
 
         protected override void LoadComplete()
@@ -133,9 +133,11 @@ namespace osu.Game.Screens.Play.HUD
             ((IHasText)displayedCountSpriteText).Text = formatCount(Current.Value);
             ((IHasText)popOutCount).Text = formatCount(Current.Value);
 
-            updateLayout();
-
             Current.BindValueChanged(combo => updateCount(combo.NewValue == 0), true);
+
+            // Since layout depends on combo font height we need to update it during skin change
+            skin.SourceChanged += updateLayout;
+            updateLayout();
         }
 
         private void updateLayout()
@@ -290,5 +292,13 @@ namespace osu.Game.Screens.Play.HUD
             double difference = currentValue > newValue ? currentValue - newValue : newValue - currentValue;
             return difference * rolling_duration;
         }
+
+        protected override void Dispose(bool isDisposing)
+        {
+            base.Dispose(isDisposing);
+
+            if (skin != null)
+                skin.SourceChanged -= updateLayout;
+        }
     }
 }

From 265b2111ef176f9178e49005dd0e0b3c6404a475 Mon Sep 17 00:00:00 2001
From: Sebastian Krajewski <mail@wieku.me>
Date: Mon, 28 Mar 2022 18:08:51 +0200
Subject: [PATCH 3763/5547] Remove comment

---
 osu.Game/Screens/Play/HUD/LegacyComboCounter.cs | 1 -
 1 file changed, 1 deletion(-)

diff --git a/osu.Game/Screens/Play/HUD/LegacyComboCounter.cs b/osu.Game/Screens/Play/HUD/LegacyComboCounter.cs
index 158cb92a1c..b4c972b94e 100644
--- a/osu.Game/Screens/Play/HUD/LegacyComboCounter.cs
+++ b/osu.Game/Screens/Play/HUD/LegacyComboCounter.cs
@@ -142,7 +142,6 @@ namespace osu.Game.Screens.Play.HUD
 
         private void updateLayout()
         {
-            // Eye-balled to match stable
             const float font_height_ratio = 0.625f;
             const float vertical_offset = 9;
 

From e3289bb0804bd3977c0192592c4a1fb5a54198d2 Mon Sep 17 00:00:00 2001
From: Sebastian Krajewski <mail@wieku.me>
Date: Mon, 28 Mar 2022 19:33:00 +0200
Subject: [PATCH 3764/5547] Don't scale big pop out as much

---
 osu.Game/Screens/Play/HUD/LegacyComboCounter.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/Play/HUD/LegacyComboCounter.cs b/osu.Game/Screens/Play/HUD/LegacyComboCounter.cs
index b4c972b94e..f463ac1457 100644
--- a/osu.Game/Screens/Play/HUD/LegacyComboCounter.cs
+++ b/osu.Game/Screens/Play/HUD/LegacyComboCounter.cs
@@ -70,7 +70,7 @@ namespace osu.Game.Screens.Play.HUD
 
             Margin = new MarginPadding(10);
 
-            Scale = new Vector2(1.3f);
+            Scale = new Vector2(1.28f);
 
             InternalChildren = new[]
             {
@@ -184,7 +184,7 @@ namespace osu.Game.Screens.Play.HUD
         {
             ((IHasText)popOutCount).Text = formatCount(newValue);
 
-            popOutCount.ScaleTo(1.6f);
+            popOutCount.ScaleTo(1.56f);
             popOutCount.FadeTo(0.6f);
 
             popOutCount.ScaleTo(1, big_pop_out_duration);

From 981ef735cfd87b1873fd476cfc16c24e53ec746e Mon Sep 17 00:00:00 2001
From: Sebastian Krajewski <mail@wieku.me>
Date: Mon, 28 Mar 2022 19:57:59 +0200
Subject: [PATCH 3765/5547] Always start small pop out from its initial size

---
 osu.Game/Screens/Play/HUD/LegacyComboCounter.cs | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Play/HUD/LegacyComboCounter.cs b/osu.Game/Screens/Play/HUD/LegacyComboCounter.cs
index f463ac1457..58036320d0 100644
--- a/osu.Game/Screens/Play/HUD/LegacyComboCounter.cs
+++ b/osu.Game/Screens/Play/HUD/LegacyComboCounter.cs
@@ -206,7 +206,11 @@ namespace osu.Game.Screens.Play.HUD
 
             counterContainer.Size = displayedCountSpriteText.Size;
 
-            displayedCountSpriteText.ScaleTo(1.1f, small_pop_out_duration / 2, Easing.InQuad).Then()
+            // In stable, small pop out always starts from its initial size
+            displayedCountSpriteText.ClearTransforms();
+
+            displayedCountSpriteText.ScaleTo(1).Then()
+                                    .ScaleTo(1.1f, small_pop_out_duration / 2, Easing.InQuad).Then()
                                     .ScaleTo(1, small_pop_out_duration / 2, Easing.OutQuad);
         }
 

From caf641e1ab19c9880db45e82e9f8c63b72c32d91 Mon Sep 17 00:00:00 2001
From: Sebastian Krajewski <mail@wieku.me>
Date: Mon, 28 Mar 2022 23:50:35 +0200
Subject: [PATCH 3766/5547] Remove redundant ClearTransforms

---
 osu.Game/Screens/Play/HUD/LegacyComboCounter.cs | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/osu.Game/Screens/Play/HUD/LegacyComboCounter.cs b/osu.Game/Screens/Play/HUD/LegacyComboCounter.cs
index 58036320d0..1617d49b10 100644
--- a/osu.Game/Screens/Play/HUD/LegacyComboCounter.cs
+++ b/osu.Game/Screens/Play/HUD/LegacyComboCounter.cs
@@ -206,9 +206,6 @@ namespace osu.Game.Screens.Play.HUD
 
             counterContainer.Size = displayedCountSpriteText.Size;
 
-            // In stable, small pop out always starts from its initial size
-            displayedCountSpriteText.ClearTransforms();
-
             displayedCountSpriteText.ScaleTo(1).Then()
                                     .ScaleTo(1.1f, small_pop_out_duration / 2, Easing.InQuad).Then()
                                     .ScaleTo(1, small_pop_out_duration / 2, Easing.OutQuad);

From 375a752e24faee7a9ae21b004e2c69e651b19f15 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 29 Mar 2022 11:24:26 +0900
Subject: [PATCH 3767/5547] Fix countdown timer not refreshing on new countdown

---
 .../Multiplayer/Match/MultiplayerReadyButton.cs   | 15 ++++++++-------
 1 file changed, 8 insertions(+), 7 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
index 0ec2c6560a..62be9ad3bd 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
@@ -36,17 +36,18 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
         }
 
         private MultiplayerCountdown countdown;
-        private DateTimeOffset countdownReceivedTime;
+        private DateTimeOffset countdownChangeTime;
         private ScheduledDelegate countdownUpdateDelegate;
 
         private void onRoomUpdated() => Scheduler.AddOnce(() =>
         {
-            if (countdown == null && room?.Countdown != null)
-                countdownReceivedTime = DateTimeOffset.Now;
+            if (countdown != room?.Countdown)
+            {
+                countdown = room?.Countdown;
+                countdownChangeTime = DateTimeOffset.Now;
+            }
 
-            countdown = room?.Countdown;
-
-            if (room?.Countdown != null)
+            if (countdown != null)
                 countdownUpdateDelegate ??= Scheduler.AddDelayed(updateButtonText, 100, true);
             else
             {
@@ -74,7 +75,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
 
             if (countdown != null)
             {
-                TimeSpan timeElapsed = DateTimeOffset.Now - countdownReceivedTime;
+                TimeSpan timeElapsed = DateTimeOffset.Now - countdownChangeTime;
                 TimeSpan countdownRemaining;
 
                 if (timeElapsed > countdown.TimeRemaining)

From 0433d2fe6a120f3b28140d24ae0026c34d7a4e91 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 29 Mar 2022 11:40:58 +0900
Subject: [PATCH 3768/5547] Add safety to realm instance retrieval in
 `RealmAccess`

---
 osu.Game/Database/RealmAccess.cs | 19 ++++++++++++++++++-
 1 file changed, 18 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Database/RealmAccess.cs b/osu.Game/Database/RealmAccess.cs
index 8574002436..8dbb338980 100644
--- a/osu.Game/Database/RealmAccess.cs
+++ b/osu.Game/Database/RealmAccess.cs
@@ -13,6 +13,7 @@ using System.Linq.Expressions;
 using System.Reflection;
 using System.Threading;
 using System.Threading.Tasks;
+using osu.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Development;
 using osu.Framework.Input.Bindings;
@@ -293,7 +294,18 @@ namespace osu.Game.Database
         /// Compact this realm.
         /// </summary>
         /// <returns></returns>
-        public bool Compact() => Realm.Compact(getConfiguration());
+        public bool Compact()
+        {
+            try
+            {
+                return Realm.Compact(getConfiguration());
+            }
+            // Catch can be removed along with entity framework. Is specifically to allow a failure message to arrive to the user (see similar catches in EFToRealmMigrator).
+            catch (AggregateException ae) when (RuntimeInfo.OS == RuntimeInfo.Platform.macOS && ae.Flatten().InnerException is TypeInitializationException)
+            {
+                return true;
+            }
+        }
 
         /// <summary>
         /// Run work on realm with a return value.
@@ -542,6 +554,11 @@ namespace osu.Game.Database
 
                 return Realm.GetInstance(getConfiguration());
             }
+            // Catch can be removed along with entity framework. Is specifically to allow a failure message to arrive to the user (see similar catches in EFToRealmMigrator).
+            catch (AggregateException ae) when (RuntimeInfo.OS == RuntimeInfo.Platform.macOS && ae.Flatten().InnerException is TypeInitializationException)
+            {
+                return Realm.GetInstance();
+            }
             finally
             {
                 if (tookSemaphoreLock)

From 8948bcce19e1e1112cc64b2541fe6bb21444793c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 29 Mar 2022 13:18:31 +0900
Subject: [PATCH 3769/5547] Restructure transforms slightly

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

diff --git a/osu.Game/Screens/Play/HUD/LegacyComboCounter.cs b/osu.Game/Screens/Play/HUD/LegacyComboCounter.cs
index 1617d49b10..afcdf5d07f 100644
--- a/osu.Game/Screens/Play/HUD/LegacyComboCounter.cs
+++ b/osu.Game/Screens/Play/HUD/LegacyComboCounter.cs
@@ -184,11 +184,11 @@ namespace osu.Game.Screens.Play.HUD
         {
             ((IHasText)popOutCount).Text = formatCount(newValue);
 
-            popOutCount.ScaleTo(1.56f);
-            popOutCount.FadeTo(0.6f);
+            popOutCount.ScaleTo(1.56f)
+                       .ScaleTo(1, big_pop_out_duration);
 
-            popOutCount.ScaleTo(1, big_pop_out_duration);
-            popOutCount.FadeOut(big_pop_out_duration);
+            popOutCount.FadeTo(0.6f)
+                       .FadeOut(big_pop_out_duration);
         }
 
         private void transformNoPopOut(int newValue)

From 327477d050910ee092ca6259633be172d525c086 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 29 Mar 2022 16:49:52 +0900
Subject: [PATCH 3770/5547] Remove unnecessary `SetReplayScore` call in
 `ModCinema`

---
 osu.Game/Rulesets/Mods/ModCinema.cs | 2 --
 1 file changed, 2 deletions(-)

diff --git a/osu.Game/Rulesets/Mods/ModCinema.cs b/osu.Game/Rulesets/Mods/ModCinema.cs
index f28ef1edeb..1fe5ddecf9 100644
--- a/osu.Game/Rulesets/Mods/ModCinema.cs
+++ b/osu.Game/Rulesets/Mods/ModCinema.cs
@@ -14,8 +14,6 @@ namespace osu.Game.Rulesets.Mods
     {
         public virtual void ApplyToDrawableRuleset(DrawableRuleset<T> drawableRuleset)
         {
-            drawableRuleset.SetReplayScore(CreateReplayScore(drawableRuleset.Beatmap, drawableRuleset.Mods));
-
             // AlwaysPresent required for hitsounds
             drawableRuleset.AlwaysPresent = true;
             drawableRuleset.Hide();

From 3fc8c23fe440644f321c9fa41ca183cf0b0ae637 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 29 Mar 2022 16:49:52 +0900
Subject: [PATCH 3771/5547] Remove unnecessary `SetReplayScore` call in
 `ModCinema`

---
 osu.Game/Rulesets/Mods/ModCinema.cs | 2 --
 1 file changed, 2 deletions(-)

diff --git a/osu.Game/Rulesets/Mods/ModCinema.cs b/osu.Game/Rulesets/Mods/ModCinema.cs
index f28ef1edeb..1fe5ddecf9 100644
--- a/osu.Game/Rulesets/Mods/ModCinema.cs
+++ b/osu.Game/Rulesets/Mods/ModCinema.cs
@@ -14,8 +14,6 @@ namespace osu.Game.Rulesets.Mods
     {
         public virtual void ApplyToDrawableRuleset(DrawableRuleset<T> drawableRuleset)
         {
-            drawableRuleset.SetReplayScore(CreateReplayScore(drawableRuleset.Beatmap, drawableRuleset.Mods));
-
             // AlwaysPresent required for hitsounds
             drawableRuleset.AlwaysPresent = true;
             drawableRuleset.Hide();

From 7d716adf39a8f91d1bac35332ad3346fa3020d67 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 29 Mar 2022 16:27:42 +0900
Subject: [PATCH 3772/5547] Create new `ICreateReplayData` interface and
 obsolete `ICreateReplay`

---
 osu.Game/Rulesets/Mods/ICreateReplay.cs     | 10 +++-
 osu.Game/Rulesets/Mods/ICreateReplayData.cs | 58 +++++++++++++++++++++
 osu.Game/Rulesets/Mods/ModAutoplay.cs       | 15 +++++-
 3 files changed, 81 insertions(+), 2 deletions(-)
 create mode 100644 osu.Game/Rulesets/Mods/ICreateReplayData.cs

diff --git a/osu.Game/Rulesets/Mods/ICreateReplay.cs b/osu.Game/Rulesets/Mods/ICreateReplay.cs
index 098bd8799a..4883ce5842 100644
--- a/osu.Game/Rulesets/Mods/ICreateReplay.cs
+++ b/osu.Game/Rulesets/Mods/ICreateReplay.cs
@@ -1,14 +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 System;
 using System.Collections.Generic;
 using osu.Game.Beatmaps;
 using osu.Game.Scoring;
 
 namespace osu.Game.Rulesets.Mods
 {
-    public interface ICreateReplay
+    [Obsolete("Use ICreateReplayData instead")] // Can be removed 20220929
+    public interface ICreateReplay : ICreateReplayData
     {
         public Score CreateReplayScore(IBeatmap beatmap, IReadOnlyList<Mod> mods);
+
+        ModReplayData ICreateReplayData.CreateReplayData(IBeatmap beatmap, IReadOnlyList<Mod> mods)
+        {
+            var replayScore = CreateReplayScore(beatmap, mods);
+            return new ModReplayData(replayScore.Replay, new ModCreatedReplayUser { Username = replayScore.ScoreInfo.User.Username });
+        }
     }
 }
diff --git a/osu.Game/Rulesets/Mods/ICreateReplayData.cs b/osu.Game/Rulesets/Mods/ICreateReplayData.cs
new file mode 100644
index 0000000000..b022949345
--- /dev/null
+++ b/osu.Game/Rulesets/Mods/ICreateReplayData.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 System.Collections.Generic;
+using osu.Game.Beatmaps;
+using osu.Game.Online.API.Requests.Responses;
+using osu.Game.Replays;
+using osu.Game.Users;
+
+namespace osu.Game.Rulesets.Mods
+{
+    /// <summary>
+    /// A mod which creates full replay data, which is to be played back in place of a local user playing the game.
+    /// </summary>
+    public interface ICreateReplayData
+    {
+        /// <summary>
+        /// Create replay data.
+        /// </summary>
+        /// <param name="beatmap"></param>
+        /// <param name="mods"></param>
+        /// <returns></returns>
+        public ModReplayData CreateReplayData(IBeatmap beatmap, IReadOnlyList<Mod> mods);
+    }
+
+    /// <summary>
+    /// Data created by a mod that implements <see cref="ICreateReplayData"/>.
+    /// </summary>
+    public class ModReplayData
+    {
+        /// <summary>
+        /// The full replay data.
+        /// </summary>
+        public readonly Replay Replay;
+
+        /// <summary>
+        /// Placeholder user data to show in place of the local user when the associated mod is active.
+        /// </summary>
+        public readonly ModCreatedReplayUser User;
+
+        public ModReplayData(Replay replay, ModCreatedReplayUser user = null)
+        {
+            Replay = replay;
+            User = user ?? new ModCreatedReplayUser();
+        }
+    }
+
+    /// <summary>
+    /// A user which is associated with a replay that was created by a mod (ie. autoplay or cinema).
+    /// </summary>
+    public class ModCreatedReplayUser : IUser
+    {
+        public int OnlineID => APIUser.SYSTEM_USER_ID;
+        public bool IsBot => true;
+
+        public string Username { get; set; } = string.Empty;
+    }
+}
diff --git a/osu.Game/Rulesets/Mods/ModAutoplay.cs b/osu.Game/Rulesets/Mods/ModAutoplay.cs
index 60b9c29fe0..aa72812bc3 100644
--- a/osu.Game/Rulesets/Mods/ModAutoplay.cs
+++ b/osu.Game/Rulesets/Mods/ModAutoplay.cs
@@ -4,6 +4,7 @@
 using System;
 using System.Collections.Generic;
 using osu.Framework.Graphics.Sprites;
+using osu.Framework.Logging;
 using osu.Game.Beatmaps;
 using osu.Game.Graphics;
 using osu.Game.Replays;
@@ -11,7 +12,7 @@ using osu.Game.Scoring;
 
 namespace osu.Game.Rulesets.Mods
 {
-    public abstract class ModAutoplay : Mod, IApplicableFailOverride, ICreateReplay
+    public abstract class ModAutoplay : Mod, IApplicableFailOverride, ICreateReplayData
     {
         public override string Name => "Autoplay";
         public override string Acronym => "AT";
@@ -30,6 +31,18 @@ namespace osu.Game.Rulesets.Mods
 
         public override bool HasImplementation => GetType().GenericTypeArguments.Length == 0;
 
+        [Obsolete("Use CreateScoreFromReplayData(IBeatmap, IReadOnlyList<Mod>) instead")] // Can be removed 20220929
         public virtual Score CreateReplayScore(IBeatmap beatmap, IReadOnlyList<Mod> mods) => new Score { Replay = new Replay() };
+
+        public virtual ModReplayData CreateReplayData(IBeatmap beatmap, IReadOnlyList<Mod> mods)
+        {
+            Logger.Log($"Ruleset mod implementation for {GetType().Name} should be updated to newer {nameof(ICreateReplayData)} signature.", LoggingTarget.Information);
+
+#pragma warning disable CS0618
+            var replayScore = CreateReplayScore(beatmap, mods);
+#pragma warning restore CS0618
+
+            return new ModReplayData(replayScore.Replay, new ModCreatedReplayUser { Username = replayScore.ScoreInfo.User.Username });
+        }
     }
 }

From ea9495eb74e42393063675dca467f5edd426e39c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 29 Mar 2022 16:45:21 +0900
Subject: [PATCH 3773/5547] Update all existing calls to extension method with
 correct fallback handling

---
 .../Visual/Gameplay/TestSceneReplay.cs        |  2 +-
 .../Edit/DrawableEditorRulesetWrapper.cs      |  2 +-
 osu.Game/Rulesets/Mods/ModExtensions.cs       | 31 +++++++++++++++++++
 osu.Game/Screens/Select/PlaySongSelect.cs     | 24 ++++++++++++--
 .../Skinning/Editor/SkinEditorSceneLibrary.cs |  3 +-
 osu.Game/Tests/Visual/TestPlayer.cs           |  2 +-
 osu.Game/Tests/Visual/TestReplayPlayer.cs     |  2 +-
 7 files changed, 59 insertions(+), 7 deletions(-)
 create mode 100644 osu.Game/Rulesets/Mods/ModExtensions.cs

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneReplay.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneReplay.cs
index f94e122b30..8622fe8f53 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneReplay.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneReplay.cs
@@ -19,7 +19,7 @@ namespace osu.Game.Tests.Visual.Gameplay
         {
             var beatmap = Beatmap.Value.GetPlayableBeatmap(ruleset.RulesetInfo, Array.Empty<Mod>());
 
-            return new ScoreAccessibleReplayPlayer(ruleset.GetAutoplayMod()?.CreateReplayScore(beatmap, Array.Empty<Mod>()));
+            return new ScoreAccessibleReplayPlayer(ruleset.GetAutoplayMod()?.CreateScoreFromReplayData(beatmap, Array.Empty<Mod>()));
         }
 
         protected override void AddCheckSteps()
diff --git a/osu.Game/Rulesets/Edit/DrawableEditorRulesetWrapper.cs b/osu.Game/Rulesets/Edit/DrawableEditorRulesetWrapper.cs
index 071f01ca00..392a5db9da 100644
--- a/osu.Game/Rulesets/Edit/DrawableEditorRulesetWrapper.cs
+++ b/osu.Game/Rulesets/Edit/DrawableEditorRulesetWrapper.cs
@@ -67,7 +67,7 @@ namespace osu.Game.Rulesets.Edit
         private void regenerateAutoplay()
         {
             var autoplayMod = drawableRuleset.Mods.OfType<ModAutoplay>().Single();
-            drawableRuleset.SetReplayScore(autoplayMod.CreateReplayScore(drawableRuleset.Beatmap, drawableRuleset.Mods));
+            drawableRuleset.SetReplayScore(autoplayMod.CreateScoreFromReplayData(drawableRuleset.Beatmap, drawableRuleset.Mods));
         }
 
         private void addHitObject(HitObject hitObject)
diff --git a/osu.Game/Rulesets/Mods/ModExtensions.cs b/osu.Game/Rulesets/Mods/ModExtensions.cs
new file mode 100644
index 0000000000..b22030414b
--- /dev/null
+++ b/osu.Game/Rulesets/Mods/ModExtensions.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 System.Collections.Generic;
+using osu.Game.Beatmaps;
+using osu.Game.Online.API.Requests.Responses;
+using osu.Game.Scoring;
+
+namespace osu.Game.Rulesets.Mods
+{
+    public static class ModExtensions
+    {
+        public static Score CreateScoreFromReplayData(this ICreateReplayData mod, IBeatmap beatmap, IReadOnlyList<Mod> mods)
+        {
+            var replayData = mod.CreateReplayData(beatmap, mods);
+
+            return new Score
+            {
+                Replay = replayData.Replay,
+                ScoreInfo =
+                {
+                    User = new APIUser
+                    {
+                        Id = APIUser.SYSTEM_USER_ID,
+                        Username = replayData.User.Username,
+                    }
+                }
+            };
+        }
+    }
+}
diff --git a/osu.Game/Screens/Select/PlaySongSelect.cs b/osu.Game/Screens/Select/PlaySongSelect.cs
index 94aa165785..17dc4524fe 100644
--- a/osu.Game/Screens/Select/PlaySongSelect.cs
+++ b/osu.Game/Screens/Select/PlaySongSelect.cs
@@ -7,6 +7,7 @@ using osu.Framework.Graphics.Sprites;
 using osu.Framework.Input.Events;
 using osu.Framework.Screens;
 using osu.Game.Graphics;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays;
 using osu.Game.Overlays.Notifications;
 using osu.Game.Rulesets.Mods;
@@ -111,9 +112,28 @@ namespace osu.Game.Screens.Select
 
             Player createPlayer()
             {
-                var replayGeneratingMod = Mods.Value.OfType<ICreateReplay>().FirstOrDefault();
+                var replayGeneratingMod = Mods.Value.OfType<ICreateReplayData>().FirstOrDefault();
+
                 if (replayGeneratingMod != null)
-                    return new ReplayPlayer((beatmap, mods) => replayGeneratingMod.CreateReplayScore(beatmap, mods));
+                {
+                    return new ReplayPlayer((beatmap, mods) =>
+                    {
+                        var replayData = replayGeneratingMod.CreateReplayData(beatmap, mods);
+
+                        return new Score
+                        {
+                            Replay = replayData.Replay,
+                            ScoreInfo =
+                            {
+                                User = new APIUser
+                                {
+                                    Id = APIUser.SYSTEM_USER_ID,
+                                    Username = replayData.User.Username,
+                                }
+                            }
+                        };
+                    });
+                }
 
                 return new SoloPlayer();
             }
diff --git a/osu.Game/Skinning/Editor/SkinEditorSceneLibrary.cs b/osu.Game/Skinning/Editor/SkinEditorSceneLibrary.cs
index d126eff075..0808cd157f 100644
--- a/osu.Game/Skinning/Editor/SkinEditorSceneLibrary.cs
+++ b/osu.Game/Skinning/Editor/SkinEditorSceneLibrary.cs
@@ -14,6 +14,7 @@ using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Overlays;
 using osu.Game.Rulesets;
+using osu.Game.Rulesets.Mods;
 using osu.Game.Screens.Play;
 using osu.Game.Screens.Select;
 using osuTK;
@@ -94,7 +95,7 @@ namespace osu.Game.Skinning.Editor
 
                                         var replayGeneratingMod = ruleset.Value.CreateInstance().GetAutoplayMod();
                                         if (replayGeneratingMod != null)
-                                            screen.Push(new PlayerLoader(() => new ReplayPlayer((beatmap, mods) => replayGeneratingMod.CreateReplayScore(beatmap, mods))));
+                                            screen.Push(new PlayerLoader(() => new ReplayPlayer((beatmap, mods) => replayGeneratingMod.CreateScoreFromReplayData(beatmap, mods))));
                                     }, new[] { typeof(Player), typeof(SongSelect) })
                                 },
                             }
diff --git a/osu.Game/Tests/Visual/TestPlayer.cs b/osu.Game/Tests/Visual/TestPlayer.cs
index d463905cf4..66a956ca3d 100644
--- a/osu.Game/Tests/Visual/TestPlayer.cs
+++ b/osu.Game/Tests/Visual/TestPlayer.cs
@@ -81,7 +81,7 @@ namespace osu.Game.Tests.Visual
 
             if (autoplayMod != null)
             {
-                DrawableRuleset?.SetReplayScore(autoplayMod.CreateReplayScore(GameplayState.Beatmap, Mods.Value));
+                DrawableRuleset?.SetReplayScore(autoplayMod.CreateScoreFromReplayData(GameplayState.Beatmap, Mods.Value));
                 return;
             }
 
diff --git a/osu.Game/Tests/Visual/TestReplayPlayer.cs b/osu.Game/Tests/Visual/TestReplayPlayer.cs
index da302d018d..bacb2427b0 100644
--- a/osu.Game/Tests/Visual/TestReplayPlayer.cs
+++ b/osu.Game/Tests/Visual/TestReplayPlayer.cs
@@ -40,7 +40,7 @@ namespace osu.Game.Tests.Visual
         /// Instantiate a replay player that renders an autoplay mod.
         /// </summary>
         public TestReplayPlayer(bool allowPause = true, bool showResults = true, bool pauseOnFocusLost = false)
-            : base((beatmap, mods) => mods.OfType<ModAutoplay>().First().CreateReplayScore(beatmap, mods), new PlayerConfiguration
+            : base((beatmap, mods) => mods.OfType<ModAutoplay>().First().CreateScoreFromReplayData(beatmap, mods), new PlayerConfiguration
             {
                 AllowPause = allowPause,
                 ShowResults = showResults

From 4b2c01a8c1591c480f092fe5473f39c6aa3e185b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 29 Mar 2022 16:59:03 +0900
Subject: [PATCH 3774/5547] Bring all mod implementations up-to-date

---
 .../Mods/EmptyFreeformModAutoplay.cs          | 16 ++------------
 .../Mods/PippidonModAutoplay.cs               | 16 ++------------
 .../Mods/EmptyScrollingModAutoplay.cs         | 22 +++++--------------
 .../Mods/PippidonModAutoplay.cs               | 16 ++------------
 .../Mods/CatchModAutoplay.cs                  | 16 ++------------
 .../Mods/CatchModCinema.cs                    | 16 ++------------
 .../Mods/ManiaModAutoplay.cs                  | 16 ++------------
 .../Mods/ManiaModCinema.cs                    | 16 ++------------
 .../TestSceneMissHitWindowJudgements.cs       |  9 ++------
 osu.Game.Rulesets.Osu/Mods/OsuModAutoplay.cs  | 16 ++------------
 osu.Game.Rulesets.Osu/Mods/OsuModCinema.cs    | 16 ++------------
 .../Mods/TaikoModAutoplay.cs                  | 16 ++------------
 .../Mods/TaikoModCinema.cs                    | 16 ++------------
 13 files changed, 29 insertions(+), 178 deletions(-)

diff --git a/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform/Mods/EmptyFreeformModAutoplay.cs b/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform/Mods/EmptyFreeformModAutoplay.cs
index 9c2a108c4e..dfa0615604 100644
--- a/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform/Mods/EmptyFreeformModAutoplay.cs
+++ b/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform/Mods/EmptyFreeformModAutoplay.cs
@@ -3,26 +3,14 @@
 
 using System.Collections.Generic;
 using osu.Game.Beatmaps;
-using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets.EmptyFreeform.Replays;
 using osu.Game.Rulesets.Mods;
-using osu.Game.Scoring;
 
 namespace osu.Game.Rulesets.EmptyFreeform.Mods
 {
     public class EmptyFreeformModAutoplay : ModAutoplay
     {
-        public override Score CreateReplayScore(IBeatmap beatmap, IReadOnlyList<Mod> mods) => new Score
-        {
-            ScoreInfo = new ScoreInfo
-            {
-                User = new APIUser
-                {
-                    Id = APIUser.SYSTEM_USER_ID,
-                    Username = "sample"
-                },
-            },
-            Replay = new EmptyFreeformAutoGenerator(beatmap).Generate(),
-        };
+        public override ModReplayData CreateReplayData(IBeatmap beatmap, IReadOnlyList<Mod> mods)
+            => new ModReplayData(new EmptyFreeformAutoGenerator(beatmap).Generate(), new ModCreatedReplayUser { Username = "sample" });
     }
 }
diff --git a/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon/Mods/PippidonModAutoplay.cs b/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon/Mods/PippidonModAutoplay.cs
index 6683856a1a..6a24812ce8 100644
--- a/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon/Mods/PippidonModAutoplay.cs
+++ b/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon/Mods/PippidonModAutoplay.cs
@@ -3,26 +3,14 @@
 
 using System.Collections.Generic;
 using osu.Game.Beatmaps;
-using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Pippidon.Replays;
-using osu.Game.Scoring;
 
 namespace osu.Game.Rulesets.Pippidon.Mods
 {
     public class PippidonModAutoplay : ModAutoplay
     {
-        public override Score CreateReplayScore(IBeatmap beatmap, IReadOnlyList<Mod> mods) => new Score
-        {
-            ScoreInfo = new ScoreInfo
-            {
-                User = new APIUser
-                {
-                    Id = APIUser.SYSTEM_USER_ID,
-                    Username = "sample"
-                },
-            },
-            Replay = new PippidonAutoGenerator(beatmap).Generate(),
-        };
+        public override ModReplayData CreateReplayData(IBeatmap beatmap, IReadOnlyList<Mod> mods)
+            => new ModReplayData(new PippidonAutoGenerator(beatmap).Generate(), new ModCreatedReplayUser { Username = "sample" });
     }
 }
diff --git a/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling/Mods/EmptyScrollingModAutoplay.cs b/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling/Mods/EmptyScrollingModAutoplay.cs
index e3cecc7b44..cd0233fb51 100644
--- a/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling/Mods/EmptyScrollingModAutoplay.cs
+++ b/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling/Mods/EmptyScrollingModAutoplay.cs
@@ -1,28 +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 osu.Game.Beatmaps;
-using osu.Game.Rulesets.Mods;
-using osu.Game.Rulesets.EmptyScrolling.Replays;
-using osu.Game.Scoring;
 using System.Collections.Generic;
-using osu.Game.Online.API.Requests.Responses;
+using osu.Game.Beatmaps;
+using osu.Game.Rulesets.EmptyScrolling.Replays;
+using osu.Game.Rulesets.Mods;
 
 namespace osu.Game.Rulesets.EmptyScrolling.Mods
 {
     public class EmptyScrollingModAutoplay : ModAutoplay
     {
-        public override Score CreateReplayScore(IBeatmap beatmap, IReadOnlyList<Mod> mods) => new Score
-        {
-            ScoreInfo = new ScoreInfo
-            {
-                User = new APIUser
-                {
-                    Id = APIUser.SYSTEM_USER_ID,
-                    Username = "sample"
-                },
-            },
-            Replay = new EmptyScrollingAutoGenerator(beatmap).Generate(),
-        };
+        public override ModReplayData CreateReplayData(IBeatmap beatmap, IReadOnlyList<Mod> mods)
+            => new ModReplayData(new EmptyScrollingAutoGenerator(beatmap).Generate(), new ModCreatedReplayUser { Username = "sample" });
     }
 }
diff --git a/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon/Mods/PippidonModAutoplay.cs b/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon/Mods/PippidonModAutoplay.cs
index 6683856a1a..6a24812ce8 100644
--- a/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon/Mods/PippidonModAutoplay.cs
+++ b/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon/Mods/PippidonModAutoplay.cs
@@ -3,26 +3,14 @@
 
 using System.Collections.Generic;
 using osu.Game.Beatmaps;
-using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Pippidon.Replays;
-using osu.Game.Scoring;
 
 namespace osu.Game.Rulesets.Pippidon.Mods
 {
     public class PippidonModAutoplay : ModAutoplay
     {
-        public override Score CreateReplayScore(IBeatmap beatmap, IReadOnlyList<Mod> mods) => new Score
-        {
-            ScoreInfo = new ScoreInfo
-            {
-                User = new APIUser
-                {
-                    Id = APIUser.SYSTEM_USER_ID,
-                    Username = "sample"
-                },
-            },
-            Replay = new PippidonAutoGenerator(beatmap).Generate(),
-        };
+        public override ModReplayData CreateReplayData(IBeatmap beatmap, IReadOnlyList<Mod> mods)
+            => new ModReplayData(new PippidonAutoGenerator(beatmap).Generate(), new ModCreatedReplayUser { Username = "sample" });
     }
 }
diff --git a/osu.Game.Rulesets.Catch/Mods/CatchModAutoplay.cs b/osu.Game.Rulesets.Catch/Mods/CatchModAutoplay.cs
index fbbb610035..08deb8378a 100644
--- a/osu.Game.Rulesets.Catch/Mods/CatchModAutoplay.cs
+++ b/osu.Game.Rulesets.Catch/Mods/CatchModAutoplay.cs
@@ -3,26 +3,14 @@
 
 using System.Collections.Generic;
 using osu.Game.Beatmaps;
-using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets.Catch.Replays;
 using osu.Game.Rulesets.Mods;
-using osu.Game.Scoring;
 
 namespace osu.Game.Rulesets.Catch.Mods
 {
     public class CatchModAutoplay : ModAutoplay
     {
-        public override Score CreateReplayScore(IBeatmap beatmap, IReadOnlyList<Mod> mods) => new Score
-        {
-            ScoreInfo = new ScoreInfo
-            {
-                User = new APIUser
-                {
-                    Id = APIUser.SYSTEM_USER_ID,
-                    Username = "osu!salad"
-                }
-            },
-            Replay = new CatchAutoGenerator(beatmap).Generate(),
-        };
+        public override ModReplayData CreateReplayData(IBeatmap beatmap, IReadOnlyList<Mod> mods)
+            => new ModReplayData(new CatchAutoGenerator(beatmap).Generate(), new ModCreatedReplayUser { Username = "osu!salad" });
     }
 }
diff --git a/osu.Game.Rulesets.Catch/Mods/CatchModCinema.cs b/osu.Game.Rulesets.Catch/Mods/CatchModCinema.cs
index 2f4769048f..d499348a09 100644
--- a/osu.Game.Rulesets.Catch/Mods/CatchModCinema.cs
+++ b/osu.Game.Rulesets.Catch/Mods/CatchModCinema.cs
@@ -3,27 +3,15 @@
 
 using System.Collections.Generic;
 using osu.Game.Beatmaps;
-using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets.Catch.Objects;
 using osu.Game.Rulesets.Catch.Replays;
 using osu.Game.Rulesets.Mods;
-using osu.Game.Scoring;
 
 namespace osu.Game.Rulesets.Catch.Mods
 {
     public class CatchModCinema : ModCinema<CatchHitObject>
     {
-        public override Score CreateReplayScore(IBeatmap beatmap, IReadOnlyList<Mod> mods) => new Score
-        {
-            ScoreInfo = new ScoreInfo
-            {
-                User = new APIUser
-                {
-                    Id = APIUser.SYSTEM_USER_ID,
-                    Username = "osu!salad"
-                }
-            },
-            Replay = new CatchAutoGenerator(beatmap).Generate(),
-        };
+        public override ModReplayData CreateReplayData(IBeatmap beatmap, IReadOnlyList<Mod> mods)
+            => new ModReplayData(new CatchAutoGenerator(beatmap).Generate(), new ModCreatedReplayUser { Username = "osu!salad" });
     }
 }
diff --git a/osu.Game.Rulesets.Mania/Mods/ManiaModAutoplay.cs b/osu.Game.Rulesets.Mania/Mods/ManiaModAutoplay.cs
index 4eea0d4a44..9ea7852808 100644
--- a/osu.Game.Rulesets.Mania/Mods/ManiaModAutoplay.cs
+++ b/osu.Game.Rulesets.Mania/Mods/ManiaModAutoplay.cs
@@ -3,27 +3,15 @@
 
 using System.Collections.Generic;
 using osu.Game.Beatmaps;
-using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets.Mania.Beatmaps;
 using osu.Game.Rulesets.Mania.Replays;
 using osu.Game.Rulesets.Mods;
-using osu.Game.Scoring;
 
 namespace osu.Game.Rulesets.Mania.Mods
 {
     public class ManiaModAutoplay : ModAutoplay
     {
-        public override Score CreateReplayScore(IBeatmap beatmap, IReadOnlyList<Mod> mods) => new Score
-        {
-            ScoreInfo = new ScoreInfo
-            {
-                User = new APIUser
-                {
-                    Id = APIUser.SYSTEM_USER_ID,
-                    Username = "osu!topus"
-                }
-            },
-            Replay = new ManiaAutoGenerator((ManiaBeatmap)beatmap).Generate(),
-        };
+        public override ModReplayData CreateReplayData(IBeatmap beatmap, IReadOnlyList<Mod> mods)
+            => new ModReplayData(new ManiaAutoGenerator((ManiaBeatmap)beatmap).Generate(), new ModCreatedReplayUser { Username = "osu!topus" });
     }
 }
diff --git a/osu.Game.Rulesets.Mania/Mods/ManiaModCinema.cs b/osu.Game.Rulesets.Mania/Mods/ManiaModCinema.cs
index 0aa419bbcb..a5d33261c5 100644
--- a/osu.Game.Rulesets.Mania/Mods/ManiaModCinema.cs
+++ b/osu.Game.Rulesets.Mania/Mods/ManiaModCinema.cs
@@ -3,28 +3,16 @@
 
 using System.Collections.Generic;
 using osu.Game.Beatmaps;
-using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets.Mania.Beatmaps;
 using osu.Game.Rulesets.Mania.Objects;
 using osu.Game.Rulesets.Mania.Replays;
 using osu.Game.Rulesets.Mods;
-using osu.Game.Scoring;
 
 namespace osu.Game.Rulesets.Mania.Mods
 {
     public class ManiaModCinema : ModCinema<ManiaHitObject>
     {
-        public override Score CreateReplayScore(IBeatmap beatmap, IReadOnlyList<Mod> mods) => new Score
-        {
-            ScoreInfo = new ScoreInfo
-            {
-                User = new APIUser
-                {
-                    Id = APIUser.SYSTEM_USER_ID,
-                    Username = "osu!topus"
-                }
-            },
-            Replay = new ManiaAutoGenerator((ManiaBeatmap)beatmap).Generate(),
-        };
+        public override ModReplayData CreateReplayData(IBeatmap beatmap, IReadOnlyList<Mod> mods)
+            => new ModReplayData(new ManiaAutoGenerator((ManiaBeatmap)beatmap).Generate(), new ModCreatedReplayUser { Username = "osu!topus" });
     }
 }
diff --git a/osu.Game.Rulesets.Osu.Tests/TestSceneMissHitWindowJudgements.cs b/osu.Game.Rulesets.Osu.Tests/TestSceneMissHitWindowJudgements.cs
index 840d871b7b..124a519ab3 100644
--- a/osu.Game.Rulesets.Osu.Tests/TestSceneMissHitWindowJudgements.cs
+++ b/osu.Game.Rulesets.Osu.Tests/TestSceneMissHitWindowJudgements.cs
@@ -4,7 +4,6 @@
 using System.Collections.Generic;
 using NUnit.Framework;
 using osu.Game.Beatmaps;
-using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Replays;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Osu.Beatmaps;
@@ -13,7 +12,6 @@ using osu.Game.Rulesets.Osu.Objects;
 using osu.Game.Rulesets.Osu.Replays;
 using osu.Game.Rulesets.Osu.Scoring;
 using osu.Game.Rulesets.Scoring;
-using osu.Game.Scoring;
 using osu.Game.Tests.Visual;
 using osuTK;
 
@@ -67,11 +65,8 @@ namespace osu.Game.Rulesets.Osu.Tests
 
         private class TestAutoMod : OsuModAutoplay
         {
-            public override Score CreateReplayScore(IBeatmap beatmap, IReadOnlyList<Mod> mods) => new Score
-            {
-                ScoreInfo = new ScoreInfo { User = new APIUser { Username = "Autoplay" } },
-                Replay = new MissingAutoGenerator(beatmap, mods).Generate()
-            };
+            public override ModReplayData CreateReplayData(IBeatmap beatmap, IReadOnlyList<Mod> mods)
+                => new ModReplayData(new MissingAutoGenerator(beatmap, mods).Generate(), new ModCreatedReplayUser { Username = "Autoplay" });
         }
 
         private class MissingAutoGenerator : OsuAutoGeneratorBase
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModAutoplay.cs b/osu.Game.Rulesets.Osu/Mods/OsuModAutoplay.cs
index c5b1c55c40..51283e171b 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModAutoplay.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModAutoplay.cs
@@ -5,10 +5,8 @@ using System;
 using System.Collections.Generic;
 using System.Linq;
 using osu.Game.Beatmaps;
-using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Osu.Replays;
-using osu.Game.Scoring;
 
 namespace osu.Game.Rulesets.Osu.Mods
 {
@@ -16,17 +14,7 @@ namespace osu.Game.Rulesets.Osu.Mods
     {
         public override Type[] IncompatibleMods => base.IncompatibleMods.Concat(new[] { typeof(OsuModAimAssist), typeof(OsuModAutopilot), typeof(OsuModSpunOut) }).ToArray();
 
-        public override Score CreateReplayScore(IBeatmap beatmap, IReadOnlyList<Mod> mods) => new Score
-        {
-            ScoreInfo = new ScoreInfo
-            {
-                User = new APIUser
-                {
-                    Id = APIUser.SYSTEM_USER_ID,
-                    Username = "Autoplay",
-                }
-            },
-            Replay = new OsuAutoGenerator(beatmap, mods).Generate()
-        };
+        public override ModReplayData CreateReplayData(IBeatmap beatmap, IReadOnlyList<Mod> mods)
+            => new ModReplayData(new OsuAutoGenerator(beatmap, mods).Generate(), new ModCreatedReplayUser { Username = "Autoplay" });
     }
 }
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModCinema.cs b/osu.Game.Rulesets.Osu/Mods/OsuModCinema.cs
index 83e6f0efb5..6ecf8b73d2 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModCinema.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModCinema.cs
@@ -5,11 +5,9 @@ using System;
 using System.Collections.Generic;
 using System.Linq;
 using osu.Game.Beatmaps;
-using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Osu.Objects;
 using osu.Game.Rulesets.Osu.Replays;
-using osu.Game.Scoring;
 
 namespace osu.Game.Rulesets.Osu.Mods
 {
@@ -17,17 +15,7 @@ namespace osu.Game.Rulesets.Osu.Mods
     {
         public override Type[] IncompatibleMods => base.IncompatibleMods.Concat(new[] { typeof(OsuModAimAssist), typeof(OsuModAutopilot), typeof(OsuModSpunOut) }).ToArray();
 
-        public override Score CreateReplayScore(IBeatmap beatmap, IReadOnlyList<Mod> mods) => new Score
-        {
-            ScoreInfo = new ScoreInfo
-            {
-                User = new APIUser
-                {
-                    Id = APIUser.SYSTEM_USER_ID,
-                    Username = "Autoplay"
-                }
-            },
-            Replay = new OsuAutoGenerator(beatmap, mods).Generate()
-        };
+        public override ModReplayData CreateReplayData(IBeatmap beatmap, IReadOnlyList<Mod> mods)
+            => new ModReplayData(new OsuAutoGenerator(beatmap, mods).Generate(), new ModCreatedReplayUser { Username = "Autoplay" });
     }
 }
diff --git a/osu.Game.Rulesets.Taiko/Mods/TaikoModAutoplay.cs b/osu.Game.Rulesets.Taiko/Mods/TaikoModAutoplay.cs
index b9bf3ab1b4..1579a121b6 100644
--- a/osu.Game.Rulesets.Taiko/Mods/TaikoModAutoplay.cs
+++ b/osu.Game.Rulesets.Taiko/Mods/TaikoModAutoplay.cs
@@ -3,26 +3,14 @@
 
 using System.Collections.Generic;
 using osu.Game.Beatmaps;
-using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Taiko.Replays;
-using osu.Game.Scoring;
 
 namespace osu.Game.Rulesets.Taiko.Mods
 {
     public class TaikoModAutoplay : ModAutoplay
     {
-        public override Score CreateReplayScore(IBeatmap beatmap, IReadOnlyList<Mod> mods) => new Score
-        {
-            ScoreInfo = new ScoreInfo
-            {
-                User = new APIUser
-                {
-                    Id = APIUser.SYSTEM_USER_ID,
-                    Username = "mekkadosu!"
-                }
-            },
-            Replay = new TaikoAutoGenerator(beatmap).Generate(),
-        };
+        public override ModReplayData CreateReplayData(IBeatmap beatmap, IReadOnlyList<Mod> mods)
+            => new ModReplayData(new TaikoAutoGenerator(beatmap).Generate(), new ModCreatedReplayUser { Username = "mekkadosu!" });
     }
 }
diff --git a/osu.Game.Rulesets.Taiko/Mods/TaikoModCinema.cs b/osu.Game.Rulesets.Taiko/Mods/TaikoModCinema.cs
index 6ecf8a3b3d..831e182193 100644
--- a/osu.Game.Rulesets.Taiko/Mods/TaikoModCinema.cs
+++ b/osu.Game.Rulesets.Taiko/Mods/TaikoModCinema.cs
@@ -3,27 +3,15 @@
 
 using System.Collections.Generic;
 using osu.Game.Beatmaps;
-using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Taiko.Objects;
 using osu.Game.Rulesets.Taiko.Replays;
-using osu.Game.Scoring;
 
 namespace osu.Game.Rulesets.Taiko.Mods
 {
     public class TaikoModCinema : ModCinema<TaikoHitObject>
     {
-        public override Score CreateReplayScore(IBeatmap beatmap, IReadOnlyList<Mod> mods) => new Score
-        {
-            ScoreInfo = new ScoreInfo
-            {
-                User = new APIUser
-                {
-                    Id = APIUser.SYSTEM_USER_ID,
-                    Username = "mekkadosu!"
-                }
-            },
-            Replay = new TaikoAutoGenerator(beatmap).Generate(),
-        };
+        public override ModReplayData CreateReplayData(IBeatmap beatmap, IReadOnlyList<Mod> mods)
+            => new ModReplayData(new TaikoAutoGenerator(beatmap).Generate(), new ModCreatedReplayUser { Username = "mekkadosu!" });
     }
 }

From 1fb3d11591858b9f0e05e35f41e4fbf4840b3b0e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 29 Mar 2022 18:00:56 +0900
Subject: [PATCH 3775/5547] Add ability to "migrate" data to another folder
 which has an existing install

Until now, migrating would always attempt to move files.

There's a chance that a user is reinstalling osu! but has their data at
a custom location. We want to allow the chance for them to continue
using the external data. This seems like the easiest way to make it
work.

Would be nice if we had a `Game.Restart()` method, but maybe this is
enough for now?

Note that further down the road we will probably prompt the user to
potentially select a custom install path (including one with existing
data) before osu! gets to writing anything.
---
 osu.Game/IO/OsuStorage.cs                     | 17 +++++++---
 .../Maintenance/MigrationSelectScreen.cs      | 32 ++++++++++++++++++-
 2 files changed, 44 insertions(+), 5 deletions(-)

diff --git a/osu.Game/IO/OsuStorage.cs b/osu.Game/IO/OsuStorage.cs
index 6e7cb545e3..a3f7b4bfec 100644
--- a/osu.Game/IO/OsuStorage.cs
+++ b/osu.Game/IO/OsuStorage.cs
@@ -64,12 +64,22 @@ namespace osu.Game.IO
         /// </summary>
         public void ResetCustomStoragePath()
         {
-            storageConfig.SetValue(StorageConfig.FullPath, string.Empty);
-            storageConfig.Save();
+            ChangeDataPath(string.Empty);
 
             ChangeTargetStorage(defaultStorage);
         }
 
+        /// <summary>
+        /// Updates the target data path without immediately switching.
+        /// This does NOT migrate any data.
+        /// The game should immediately be restarted after calling this.
+        /// </summary>
+        public void ChangeDataPath(string newPath)
+        {
+            storageConfig.SetValue(StorageConfig.FullPath, newPath);
+            storageConfig.Save();
+        }
+
         /// <summary>
         /// Attempts to change to the user's custom storage path.
         /// </summary>
@@ -117,8 +127,7 @@ namespace osu.Game.IO
         {
             bool cleanupSucceeded = base.Migrate(newStorage);
 
-            storageConfig.SetValue(StorageConfig.FullPath, newStorage.GetFullPath("."));
-            storageConfig.Save();
+            ChangeDataPath(newStorage.GetFullPath("."));
 
             return cleanupSucceeded;
         }
diff --git a/osu.Game/Overlays/Settings/Sections/Maintenance/MigrationSelectScreen.cs b/osu.Game/Overlays/Settings/Sections/Maintenance/MigrationSelectScreen.cs
index 1a60ab0638..9b20f2c0c3 100644
--- a/osu.Game/Overlays/Settings/Sections/Maintenance/MigrationSelectScreen.cs
+++ b/osu.Game/Overlays/Settings/Sections/Maintenance/MigrationSelectScreen.cs
@@ -3,11 +3,14 @@
 
 using System;
 using System.IO;
+using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Localisation;
 using osu.Framework.Logging;
 using osu.Framework.Platform;
 using osu.Framework.Screens;
+using osu.Game.IO;
+using osu.Game.Overlays.Dialog;
 
 namespace osu.Game.Overlays.Settings.Sections.Maintenance
 {
@@ -16,6 +19,12 @@ namespace osu.Game.Overlays.Settings.Sections.Maintenance
         [Resolved]
         private Storage storage { get; set; }
 
+        [Resolved]
+        private OsuGameBase game { get; set; }
+
+        [Resolved(canBeNull: true)]
+        private DialogOverlay dialogOverlay { get; set; }
+
         protected override DirectoryInfo InitialPath => new DirectoryInfo(storage.GetFullPath(string.Empty)).Parent;
 
         public override bool AllowExternalScreenChange => false;
@@ -32,8 +41,29 @@ namespace osu.Game.Overlays.Settings.Sections.Maintenance
 
             try
             {
-                if (target.GetDirectories().Length > 0 || target.GetFiles().Length > 0)
+                var directoryInfos = target.GetDirectories();
+                var fileInfos = target.GetFiles();
+
+                if (directoryInfos.Length > 0 || fileInfos.Length > 0)
+                {
+                    // Quick test for whether there's already an osu! install at the target path.
+                    if (fileInfos.Any(f => f.Name == @"client.realm"))
+                    {
+                        dialogOverlay.Push(new ConfirmDialog("The target directory already seems to have an osu! install. Use this data instead?", () =>
+                            {
+                                dialogOverlay.Push(new ConfirmDialog("To complete this operation, osu! will close. Please open it again to use the new data location.", () =>
+                                {
+                                    (storage as OsuStorage)?.ChangeDataPath(target.FullName);
+                                    game.GracefullyExit();
+                                }, () => { }));
+                            },
+                            () => { }));
+
+                        return;
+                    }
+
                     target = target.CreateSubdirectory("osu-lazer");
+                }
             }
             catch (Exception e)
             {

From 4741679a9404f08d79e0c412bc0f641b5c7d8c86 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 29 Mar 2022 19:03:50 +0900
Subject: [PATCH 3776/5547] Change confirmation message to be more clear about
 intentions

Co-authored-by: Henry Lin <henry.ys.lin@gmail.com>
---
 .../Settings/Sections/Maintenance/MigrationSelectScreen.cs      | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/Settings/Sections/Maintenance/MigrationSelectScreen.cs b/osu.Game/Overlays/Settings/Sections/Maintenance/MigrationSelectScreen.cs
index 9b20f2c0c3..047587e084 100644
--- a/osu.Game/Overlays/Settings/Sections/Maintenance/MigrationSelectScreen.cs
+++ b/osu.Game/Overlays/Settings/Sections/Maintenance/MigrationSelectScreen.cs
@@ -49,7 +49,7 @@ namespace osu.Game.Overlays.Settings.Sections.Maintenance
                     // Quick test for whether there's already an osu! install at the target path.
                     if (fileInfos.Any(f => f.Name == @"client.realm"))
                     {
-                        dialogOverlay.Push(new ConfirmDialog("The target directory already seems to have an osu! install. Use this data instead?", () =>
+                        dialogOverlay.Push(new ConfirmDialog("The target directory already seems to have an osu! install. Use that data instead?", () =>
                             {
                                 dialogOverlay.Push(new ConfirmDialog("To complete this operation, osu! will close. Please open it again to use the new data location.", () =>
                                 {

From 9a09c97457bfbd233ee29f961d5326c4ee054b41 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Tue, 29 Mar 2022 16:11:44 +0300
Subject: [PATCH 3777/5547] Fix "Barrel Roll" tooltip not limiting decimal
 places for spin speed

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

diff --git a/osu.Game/Rulesets/Mods/ModBarrelRoll.cs b/osu.Game/Rulesets/Mods/ModBarrelRoll.cs
index 4acbcf3e74..bacb953f76 100644
--- a/osu.Game/Rulesets/Mods/ModBarrelRoll.cs
+++ b/osu.Game/Rulesets/Mods/ModBarrelRoll.cs
@@ -37,7 +37,7 @@ namespace osu.Game.Rulesets.Mods
         public override string Description => "The whole playfield is on a wheel!";
         public override double ScoreMultiplier => 1;
 
-        public override string SettingDescription => $"{SpinSpeed.Value} rpm {Direction.Value.GetDescription().ToLowerInvariant()}";
+        public override string SettingDescription => $"{SpinSpeed.Value:N2} rpm {Direction.Value.GetDescription().ToLowerInvariant()}";
 
         public void Update(Playfield playfield)
         {

From 8d4356f23bf60cba89d1b7aa67513d38f3129b27 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Tue, 29 Mar 2022 17:25:05 +0300
Subject: [PATCH 3778/5547] Mark "autoplay" and "cinema" mods as mutually
 exclusive

---
 osu.Game/Rulesets/Mods/ModAutoplay.cs | 2 +-
 osu.Game/Rulesets/Mods/ModCinema.cs   | 4 ++++
 2 files changed, 5 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Rulesets/Mods/ModAutoplay.cs b/osu.Game/Rulesets/Mods/ModAutoplay.cs
index 60b9c29fe0..e804cb6734 100644
--- a/osu.Game/Rulesets/Mods/ModAutoplay.cs
+++ b/osu.Game/Rulesets/Mods/ModAutoplay.cs
@@ -26,7 +26,7 @@ namespace osu.Game.Rulesets.Mods
 
         public override bool UserPlayable => false;
 
-        public override Type[] IncompatibleMods => new[] { typeof(ModRelax), typeof(ModFailCondition), typeof(ModNoFail) };
+        public override Type[] IncompatibleMods => new[] { typeof(ModCinema), typeof(ModRelax), typeof(ModFailCondition), typeof(ModNoFail) };
 
         public override bool HasImplementation => GetType().GenericTypeArguments.Length == 0;
 
diff --git a/osu.Game/Rulesets/Mods/ModCinema.cs b/osu.Game/Rulesets/Mods/ModCinema.cs
index 1fe5ddecf9..99c4e71d1f 100644
--- a/osu.Game/Rulesets/Mods/ModCinema.cs
+++ b/osu.Game/Rulesets/Mods/ModCinema.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.Game.Graphics;
 using osu.Game.Rulesets.Objects;
@@ -27,6 +29,8 @@ namespace osu.Game.Rulesets.Mods
         public override IconUsage? Icon => OsuIcon.ModCinema;
         public override string Description => "Watch the video without visual distractions.";
 
+        public override Type[] IncompatibleMods => base.IncompatibleMods.Append(typeof(ModAutoplay)).ToArray();
+
         public void ApplyToHUD(HUDOverlay overlay)
         {
             overlay.ShowHud.Value = false;

From f762af13446554683388ed420bf97b0c9c6d807c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 29 Mar 2022 23:28:07 +0900
Subject: [PATCH 3779/5547] Add test coverage of migrating to folder with
 existing data

---
 .../NonVisual/CustomDataDirectoryTest.cs      | 42 +++++++++++++++++++
 1 file changed, 42 insertions(+)

diff --git a/osu.Game.Tests/NonVisual/CustomDataDirectoryTest.cs b/osu.Game.Tests/NonVisual/CustomDataDirectoryTest.cs
index 834930a05e..b5ab33b9fc 100644
--- a/osu.Game.Tests/NonVisual/CustomDataDirectoryTest.cs
+++ b/osu.Game.Tests/NonVisual/CustomDataDirectoryTest.cs
@@ -233,6 +233,48 @@ namespace osu.Game.Tests.NonVisual
             }
         }
 
+        [Test]
+        public void TestMigrationFailsOnExistingData()
+        {
+            string customPath = prepareCustomPath();
+            string customPath2 = prepareCustomPath();
+
+            using (var host = new CustomTestHeadlessGameHost())
+            {
+                try
+                {
+                    var osu = LoadOsuIntoHost(host);
+
+                    var storage = osu.Dependencies.Get<Storage>();
+                    var osuStorage = storage as OsuStorage;
+
+                    string originalDirectory = storage.GetFullPath(".");
+
+                    const string database_filename = "client.realm";
+
+                    Assert.DoesNotThrow(() => osu.Migrate(customPath));
+                    Assert.That(File.Exists(Path.Combine(customPath, database_filename)));
+
+                    Directory.CreateDirectory(customPath2);
+                    File.Copy(Path.Combine(customPath, database_filename), Path.Combine(customPath2, database_filename));
+
+                    // Fails because file already exists.
+                    Assert.Throws<ArgumentException>(() => osu.Migrate(customPath2));
+
+                    osuStorage?.ChangeDataPath(customPath2);
+
+                    Assert.That(osuStorage?.CustomStoragePath, Is.EqualTo(customPath2));
+                    Assert.That(new StreamReader(Path.Combine(originalDirectory, "storage.ini")).ReadToEnd().Contains($"FullPath = {customPath2}"));
+                }
+                finally
+                {
+                    host.Exit();
+                    cleanupPath(customPath);
+                    cleanupPath(customPath2);
+                }
+            }
+        }
+
         [Test]
         public void TestMigrationToNestedTargetFails()
         {

From f049d7cb677e899f9984611ae19410b01a18c978 Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Tue, 29 Mar 2022 21:36:08 +0100
Subject: [PATCH 3780/5547] Implement `ChatTextBox` for new chat design

Reference design: https://www.figma.com/file/f8b2dHp9LJCMOqYP4mdrPZ/Client%2FChat?node-id=1%3A297

Adds new component `ChatTextBox`.
Exposes `BindableBool` `ShowSearch` to change text input behaviour
between normal and search behaviour.

Adds new component `ChatTextBar`.
Exposes `BindableBool` `ShowSearch` which toggles between showing current
chat channel or search icon.
Additionally binds to child `ChatTextBox` components.
Requires a cached `Bindable<Channel>` instance to be managed by a parent
component.
---
 InspectCode.sh                                |   2 +-
 .../Visual/Online/TestSceneChatTextBox.cs     |  96 ++++++++++
 osu.Game/Overlays/Chat/ChatTextBar.cs         | 174 ++++++++++++++++++
 osu.Game/Overlays/Chat/ChatTextBox.cs         |  36 ++++
 4 files changed, 307 insertions(+), 1 deletion(-)
 create mode 100644 osu.Game.Tests/Visual/Online/TestSceneChatTextBox.cs
 create mode 100644 osu.Game/Overlays/Chat/ChatTextBar.cs
 create mode 100644 osu.Game/Overlays/Chat/ChatTextBox.cs

diff --git a/InspectCode.sh b/InspectCode.sh
index cf2bc18175..5a72324dd4 100755
--- a/InspectCode.sh
+++ b/InspectCode.sh
@@ -2,5 +2,5 @@
 
 dotnet tool restore
 dotnet CodeFileSanity
-dotnet jb inspectcode "osu.Desktop.slnf" --output="inspectcodereport.xml" --caches-home="inspectcode" --verbosity=WARN
+dotnet jb inspectcode "osu.Game/osu.Game.csproj" --no-build --output="inspectcodereport.xml" --caches-home="inspectcode" --verbosity=WARN
 dotnet nvika parsereport "inspectcodereport.xml" --treatwarningsaserrors
diff --git a/osu.Game.Tests/Visual/Online/TestSceneChatTextBox.cs b/osu.Game.Tests/Visual/Online/TestSceneChatTextBox.cs
new file mode 100644
index 0000000000..e72a1d6652
--- /dev/null
+++ b/osu.Game.Tests/Visual/Online/TestSceneChatTextBox.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 NUnit.Framework;
+using osu.Framework.Allocation;
+using osu.Framework.Bindables;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
+using osu.Game.Graphics;
+using osu.Game.Graphics.Sprites;
+using osu.Game.Online.API.Requests.Responses;
+using osu.Game.Online.Chat;
+using osu.Game.Overlays;
+using osu.Game.Overlays.Chat;
+
+namespace osu.Game.Tests.Visual.Online
+{
+    [TestFixture]
+    public class TestSceneChatTextBox : OsuTestScene
+    {
+        [Cached]
+        private readonly OverlayColourProvider colourProvider = new OverlayColourProvider(OverlayColourScheme.Pink);
+
+        [Cached]
+        private readonly Bindable<Channel> currentChannel = new Bindable<Channel>();
+
+        private OsuSpriteText commitText;
+        private ChatTextBar bar;
+
+        [SetUp]
+        public void SetUp()
+        {
+            Schedule(() =>
+            {
+                Child = new GridContainer
+                {
+                    Anchor = Anchor.Centre,
+                    Origin = Anchor.Centre,
+                    RelativeSizeAxes = Axes.X,
+                    AutoSizeAxes = Axes.Y,
+                    RowDimensions = new[]
+                    {
+                        new Dimension(GridSizeMode.Absolute, 30),
+                        new Dimension(GridSizeMode.AutoSize),
+                    },
+                    Content = new[]
+                    {
+                        new Drawable[]
+                        {
+                            commitText = new OsuSpriteText
+                            {
+                                Anchor = Anchor.TopCentre,
+                                Origin = Anchor.TopCentre,
+                                Font = OsuFont.Default.With(size: 20),
+                            },
+                        },
+                        new Drawable[]
+                        {
+                            bar = new ChatTextBar
+                            {
+                                Anchor = Anchor.TopCentre,
+                                Origin = Anchor.TopCentre,
+                                Width = 0.99f,
+                            },
+                        },
+                    },
+                };
+
+                bar.TextBox.OnCommit += (sender, newText) =>
+                {
+                    commitText.Text = $"Commit: {sender.Text}";
+                    commitText.FadeOutFromOne(1000, Easing.InQuint);
+                    sender.Text = string.Empty;
+                };
+            });
+        }
+
+        [Test]
+        public void TestVisual()
+        {
+            AddStep("Public Channel", () => currentChannel.Value = createPublicChannel("#osu"));
+            AddStep("Public Channel Long Name", () => currentChannel.Value = createPublicChannel("#public-channel-long-name"));
+            AddStep("Private Channel", () => currentChannel.Value = createPrivateChannel("peppy", 2));
+            AddStep("Private Long Name", () => currentChannel.Value = createPrivateChannel("test user long name", 3));
+
+            AddStep("Chat Mode Channel", () => bar.ShowSearch.Value = false);
+            AddStep("Chat Mode Search", () => bar.ShowSearch.Value = true);
+        }
+
+        private static Channel createPublicChannel(string name)
+            => new Channel { Name = name, Type = ChannelType.Public, Id = 1234 };
+
+        private static Channel createPrivateChannel(string username, int id)
+            => new Channel(new APIUser { Id = id, Username = username });
+    }
+}
diff --git a/osu.Game/Overlays/Chat/ChatTextBar.cs b/osu.Game/Overlays/Chat/ChatTextBar.cs
new file mode 100644
index 0000000000..00284fdd33
--- /dev/null
+++ b/osu.Game/Overlays/Chat/ChatTextBar.cs
@@ -0,0 +1,174 @@
+// 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 enable
+
+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.Graphics.Sprites;
+using osu.Game.Graphics;
+using osu.Game.Graphics.Containers;
+using osu.Game.Graphics.Sprites;
+using osu.Game.Online.Chat;
+using osuTK;
+
+namespace osu.Game.Overlays.Chat
+{
+    public class ChatTextBar : Container
+    {
+        public readonly BindableBool ShowSearch = new BindableBool();
+
+        public ChatTextBox TextBox => chatTextBox;
+
+        [Resolved]
+        private Bindable<Channel> currentChannel { get; set; } = null!;
+
+        private OsuTextFlowContainer chattingTextContainer = null!;
+        private Container searchIconContainer = null!;
+        private ChatTextBox chatTextBox = null!;
+        private Container enterContainer = null!;
+
+        private const float chatting_text_width = 180;
+        private const float search_icon_width = 40;
+
+        [BackgroundDependencyLoader]
+        private void load(OverlayColourProvider colourProvider)
+        {
+            RelativeSizeAxes = Axes.X;
+            Height = 60;
+
+            Children = new Drawable[]
+            {
+                new Box
+                {
+                    RelativeSizeAxes = Axes.Both,
+                    Colour = colourProvider.Background5,
+                },
+                new GridContainer
+                {
+                    RelativeSizeAxes = Axes.Both,
+                    ColumnDimensions = new[]
+                    {
+                        new Dimension(GridSizeMode.AutoSize),
+                        new Dimension(GridSizeMode.AutoSize),
+                        new Dimension(),
+                        new Dimension(GridSizeMode.AutoSize),
+                    },
+                    Content = new[]
+                    {
+                        new Drawable[]
+                        {
+                            chattingTextContainer = new OsuTextFlowContainer(t => t.Font = t.Font.With(size: 20))
+                            {
+                                Masking = true,
+                                Width = chatting_text_width,
+                                Padding = new MarginPadding { Left = 10 },
+                                RelativeSizeAxes = Axes.Y,
+                                TextAnchor = Anchor.CentreRight,
+                                Anchor = Anchor.CentreLeft,
+                                Origin = Anchor.CentreLeft,
+                                Colour = colourProvider.Background1,
+                            },
+                            searchIconContainer = new Container
+                            {
+                                RelativeSizeAxes = Axes.Y,
+                                Width = search_icon_width,
+                                Child = new SpriteIcon
+                                {
+                                    Icon = FontAwesome.Solid.Search,
+                                    Origin = Anchor.CentreRight,
+                                    Anchor = Anchor.CentreRight,
+                                    Size = new Vector2(20),
+                                    Margin = new MarginPadding { Right = 2 },
+                                },
+                            },
+                            new Container
+                            {
+                                RelativeSizeAxes = Axes.Both,
+                                Padding = new MarginPadding { Right = 5 },
+                                Child = chatTextBox =  new ChatTextBox
+                                {
+                                    Anchor = Anchor.CentreLeft,
+                                    Origin = Anchor.CentreLeft,
+                                    RelativeSizeAxes = Axes.X,
+                                    ShowSearch = { BindTarget = ShowSearch },
+                                    HoldFocus = true,
+                                    ReleaseFocusOnCommit = false,
+                                },
+                            },
+                            enterContainer = new Container
+                            {
+                                Origin = Anchor.CentreLeft,
+                                Anchor = Anchor.CentreLeft,
+                                Masking = true,
+                                BorderColour = colourProvider.Background1,
+                                BorderThickness = 2,
+                                CornerRadius = 10,
+                                Margin = new MarginPadding { Right = 10 },
+                                Size = new Vector2(60, 30),
+                                Children = new Drawable[]
+                                {
+                                    new Box
+                                    {
+                                        RelativeSizeAxes = Axes.Both,
+                                        Colour = Colour4.Transparent,
+                                    },
+                                    new OsuSpriteText
+                                    {
+                                        Text = "Enter",
+                                        Origin = Anchor.Centre,
+                                        Anchor = Anchor.Centre,
+                                        Colour = colourProvider.Background1,
+                                        Font = OsuFont.Torus.With(size: 20),
+                                        Margin = new MarginPadding { Bottom = 2 },
+                                    },
+                                },
+                            },
+                        },
+                    },
+                },
+            };
+        }
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            ShowSearch.BindValueChanged(change =>
+            {
+                if (change.NewValue)
+                {
+                    chattingTextContainer.Hide();
+                    enterContainer.Hide();
+                    searchIconContainer.Show();
+                }
+                else
+                {
+                    chattingTextContainer.Show();
+                    enterContainer.Show();
+                    searchIconContainer.Hide();
+                }
+            }, true);
+
+            currentChannel.BindValueChanged(change =>
+            {
+                Channel newChannel = change.NewValue;
+                switch (newChannel?.Type)
+                {
+                    case ChannelType.Public:
+                        chattingTextContainer.Text = $"chatting in {newChannel.Name}";
+                        break;
+                    case ChannelType.PM:
+                        chattingTextContainer.Text = $"chatting with {newChannel.Name}";
+                        break;
+                    default:
+                        chattingTextContainer.Text = "";
+                        break;
+                }
+            }, true);
+        }
+    }
+}
diff --git a/osu.Game/Overlays/Chat/ChatTextBox.cs b/osu.Game/Overlays/Chat/ChatTextBox.cs
new file mode 100644
index 0000000000..35ed26cda3
--- /dev/null
+++ b/osu.Game/Overlays/Chat/ChatTextBox.cs
@@ -0,0 +1,36 @@
+// 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 enable
+
+using osu.Framework.Bindables;
+using osu.Game.Graphics.UserInterface;
+
+namespace osu.Game.Overlays.Chat
+{
+    public class ChatTextBox : FocusedTextBox
+    {
+        public readonly BindableBool ShowSearch = new BindableBool();
+
+        public override bool HandleLeftRightArrows => !ShowSearch.Value;
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            ShowSearch.BindValueChanged(change =>
+            {
+                PlaceholderText = change.NewValue ? "type here to search" : "type here";
+                Schedule(() => Text = string.Empty);
+            }, true);
+        }
+
+        protected override void Commit()
+        {
+            if (ShowSearch.Value)
+                return;
+
+            base.Commit();
+        }
+    }
+}

From 06c32aa1362c5f31d0ca068f9b2cf799d00997ad Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Tue, 29 Mar 2022 22:50:24 +0100
Subject: [PATCH 3781/5547] Remove changes to `InspectCode.sh`

---
 InspectCode.sh | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/InspectCode.sh b/InspectCode.sh
index 5a72324dd4..cf2bc18175 100755
--- a/InspectCode.sh
+++ b/InspectCode.sh
@@ -2,5 +2,5 @@
 
 dotnet tool restore
 dotnet CodeFileSanity
-dotnet jb inspectcode "osu.Game/osu.Game.csproj" --no-build --output="inspectcodereport.xml" --caches-home="inspectcode" --verbosity=WARN
+dotnet jb inspectcode "osu.Desktop.slnf" --output="inspectcodereport.xml" --caches-home="inspectcode" --verbosity=WARN
 dotnet nvika parsereport "inspectcodereport.xml" --treatwarningsaserrors

From cef1b93471572085a6ecf97d11b95319b532b675 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 30 Mar 2022 01:06:35 +0300
Subject: [PATCH 3782/5547] Improve behaviour of "Autoplay" shortcut during
 gameplay start

This also opens up the way to adding shortcut for "Cinema" mod
(Ctrl+Shift+Enter), but will leave adding that until there's a demand
for it.
---
 osu.Game/Screens/Select/PlaySongSelect.cs | 50 +++++++++++------------
 1 file changed, 24 insertions(+), 26 deletions(-)

diff --git a/osu.Game/Screens/Select/PlaySongSelect.cs b/osu.Game/Screens/Select/PlaySongSelect.cs
index 94aa165785..434a0ea030 100644
--- a/osu.Game/Screens/Select/PlaySongSelect.cs
+++ b/osu.Game/Screens/Select/PlaySongSelect.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.Graphics.Sprites;
@@ -14,13 +15,13 @@ using osu.Game.Scoring;
 using osu.Game.Screens.Play;
 using osu.Game.Screens.Ranking;
 using osu.Game.Users;
+using osu.Game.Utils;
 using osuTK.Input;
 
 namespace osu.Game.Screens.Select
 {
     public class PlaySongSelect : SongSelect
     {
-        private bool removeAutoModOnResume;
         private OsuScreen playerLoader;
 
         [Resolved(CanBeNull = true)]
@@ -43,25 +44,6 @@ namespace osu.Game.Screens.Select
 
         protected override BeatmapDetailArea CreateBeatmapDetailArea() => new PlayBeatmapDetailArea();
 
-        private ModAutoplay getAutoplayMod() => Ruleset.Value.CreateInstance().GetAutoplayMod();
-
-        public override void OnResuming(IScreen last)
-        {
-            base.OnResuming(last);
-
-            playerLoader = null;
-
-            if (removeAutoModOnResume)
-            {
-                var autoType = getAutoplayMod()?.GetType();
-
-                if (autoType != null)
-                    Mods.Value = Mods.Value.Where(m => m.GetType() != autoType).ToArray();
-
-                removeAutoModOnResume = false;
-            }
-        }
-
         protected override bool OnKeyDown(KeyDownEvent e)
         {
             switch (e.Key)
@@ -77,10 +59,16 @@ namespace osu.Game.Screens.Select
             return base.OnKeyDown(e);
         }
 
+        private IReadOnlyList<Mod> modsAtGameplayStart;
+
+        private ModAutoplay getAutoplayMod() => Ruleset.Value.CreateInstance().GetAutoplayMod();
+
         protected override bool OnStart()
         {
             if (playerLoader != null) return false;
 
+            modsAtGameplayStart = Mods.Value;
+
             // Ctrl+Enter should start map with autoplay enabled.
             if (GetContainingInputManager().CurrentState?.Keyboard.ControlPressed == true)
             {
@@ -95,13 +83,12 @@ namespace osu.Game.Screens.Select
                     return false;
                 }
 
-                var mods = Mods.Value;
+                var mods = Mods.Value.Append(autoInstance).ToArray();
 
-                if (mods.All(m => m.GetType() != autoInstance.GetType()))
-                {
-                    Mods.Value = mods.Append(autoInstance).ToArray();
-                    removeAutoModOnResume = true;
-                }
+                if (!ModUtils.CheckCompatibleSet(mods, out var invalid))
+                    mods = mods.Except(invalid).Append(autoInstance).ToArray();
+
+                Mods.Value = mods;
             }
 
             SampleConfirm?.Play();
@@ -118,5 +105,16 @@ namespace osu.Game.Screens.Select
                 return new SoloPlayer();
             }
         }
+
+        public override void OnResuming(IScreen last)
+        {
+            base.OnResuming(last);
+
+            if (playerLoader != null)
+            {
+                Mods.Value = modsAtGameplayStart;
+                playerLoader = null;
+            }
+        }
     }
 }

From b7ae431252d0cf5b537b312f9b613f4115c77d69 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 30 Mar 2022 01:08:22 +0300
Subject: [PATCH 3783/5547] Add test coverage

---
 .../SongSelect/TestScenePlaySongSelect.cs     | 62 ++++++++++++++++++-
 1 file changed, 59 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
index c0c1e6b7a4..d27f16a624 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
@@ -68,7 +68,9 @@ namespace osu.Game.Tests.Visual.SongSelect
             AddStep("reset defaults", () =>
             {
                 Ruleset.Value = new OsuRuleset().RulesetInfo;
+
                 Beatmap.SetDefault();
+                SelectedMods.SetDefault();
 
                 songSelect = null;
             });
@@ -563,7 +565,7 @@ namespace osu.Game.Tests.Visual.SongSelect
         }
 
         [Test]
-        public void TestAutoplayViaCtrlEnter()
+        public void TestAutoplayShortcut()
         {
             addRulesetImportStep(0);
 
@@ -580,11 +582,65 @@ namespace osu.Game.Tests.Visual.SongSelect
 
             AddUntilStep("wait for player", () => Stack.CurrentScreen is PlayerLoader);
 
-            AddAssert("autoplay enabled", () => songSelect.Mods.Value.FirstOrDefault() is ModAutoplay);
+            AddAssert("autoplay selected", () => songSelect.Mods.Value.Single() is ModAutoplay);
 
             AddUntilStep("wait for return to ss", () => songSelect.IsCurrentScreen());
 
-            AddAssert("mod disabled", () => songSelect.Mods.Value.Count == 0);
+            AddAssert("no mods selected", () => songSelect.Mods.Value.Count == 0);
+        }
+
+        [Test]
+        public void TestAutoplayShortcutKeepsAutoplayIfSelectedAlready()
+        {
+            addRulesetImportStep(0);
+
+            createSongSelect();
+
+            AddUntilStep("wait for selection", () => !Beatmap.IsDefault);
+
+            changeMods(new OsuModAutoplay());
+
+            AddStep("press ctrl+enter", () =>
+            {
+                InputManager.PressKey(Key.ControlLeft);
+                InputManager.Key(Key.Enter);
+                InputManager.ReleaseKey(Key.ControlLeft);
+            });
+
+            AddUntilStep("wait for player", () => Stack.CurrentScreen is PlayerLoader);
+
+            AddAssert("autoplay selected", () => songSelect.Mods.Value.Single() is ModAutoplay);
+
+            AddUntilStep("wait for return to ss", () => songSelect.IsCurrentScreen());
+
+            AddAssert("autoplay still selected", () => songSelect.Mods.Value.Single() is ModAutoplay);
+        }
+
+        [Test]
+        public void TestAutoplayShortcutReturnsInitialModsOnExit()
+        {
+            addRulesetImportStep(0);
+
+            createSongSelect();
+
+            AddUntilStep("wait for selection", () => !Beatmap.IsDefault);
+
+            changeMods(new OsuModRelax());
+
+            AddStep("press ctrl+enter", () =>
+            {
+                InputManager.PressKey(Key.ControlLeft);
+                InputManager.Key(Key.Enter);
+                InputManager.ReleaseKey(Key.ControlLeft);
+            });
+
+            AddUntilStep("wait for player", () => Stack.CurrentScreen is PlayerLoader);
+
+            AddAssert("only autoplay selected", () => songSelect.Mods.Value.Single() is ModAutoplay);
+
+            AddUntilStep("wait for return to ss", () => songSelect.IsCurrentScreen());
+
+            AddAssert("relax returned", () => songSelect.Mods.Value.Single() is ModRelax);
         }
 
         [Test]

From 986aad4bd56c8f427753a06e6aaca09c5a427a86 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 30 Mar 2022 01:15:22 +0300
Subject: [PATCH 3784/5547] Fix potential nullref on
 `OsuGameTestScene.TearDownSteps`

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

diff --git a/osu.Game/Tests/Visual/OsuGameTestScene.cs b/osu.Game/Tests/Visual/OsuGameTestScene.cs
index 3b8d9a4cd1..34d7723fa3 100644
--- a/osu.Game/Tests/Visual/OsuGameTestScene.cs
+++ b/osu.Game/Tests/Visual/OsuGameTestScene.cs
@@ -74,7 +74,7 @@ namespace osu.Game.Tests.Visual
         [TearDownSteps]
         public void TearDownSteps()
         {
-            if (DebugUtils.IsNUnitRunning)
+            if (DebugUtils.IsNUnitRunning && Game != null)
             {
                 AddStep("exit game", () => Game.Exit());
                 AddUntilStep("wait for game exit", () => Game.Parent == null);

From 7495a04990a01792b7e65b7a473eb41bcb70c5ed Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 30 Mar 2022 01:16:10 +0300
Subject: [PATCH 3785/5547] Ignore EF-to-realm migration tests on ARM
 architectures

---
 .../Navigation/TestEFToRealmMigration.cs      | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/osu.Game.Tests/Visual/Navigation/TestEFToRealmMigration.cs b/osu.Game.Tests/Visual/Navigation/TestEFToRealmMigration.cs
index 00a06d420e..8498b9b28f 100644
--- a/osu.Game.Tests/Visual/Navigation/TestEFToRealmMigration.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestEFToRealmMigration.cs
@@ -3,7 +3,9 @@
 
 using System.IO;
 using System.Linq;
+using System.Runtime.InteropServices;
 using NUnit.Framework;
+using osu.Framework;
 using osu.Framework.Allocation;
 using osu.Game.Beatmaps;
 using osu.Game.Database;
@@ -28,6 +30,23 @@ namespace osu.Game.Tests.Visual.Navigation
                 stream.CopyTo(outStream);
         }
 
+        [SetUp]
+        public void SetUp()
+        {
+            if (RuntimeInfo.OS == RuntimeInfo.Platform.macOS && RuntimeInformation.OSArchitecture == Architecture.Arm64)
+                Assert.Ignore("EF-to-realm migrations are not supported on M1 ARM architectures.");
+        }
+
+        public override void SetUpSteps()
+        {
+            // base SetUpSteps are executed before the above SetUp, therefore early-return to allow ignoring test properly.
+            // attempting to ignore here would yield a TargetInvocationException instead.
+            if (RuntimeInfo.OS == RuntimeInfo.Platform.macOS && RuntimeInformation.OSArchitecture == Architecture.Arm64)
+                return;
+
+            base.SetUpSteps();
+        }
+
         [Test]
         public void TestMigration()
         {

From 7582c943a4a77e92d9dd3504dcdb29e755132b82 Mon Sep 17 00:00:00 2001
From: Sebastian Krajewski <mail@wieku.me>
Date: Wed, 30 Mar 2022 00:48:59 +0200
Subject: [PATCH 3786/5547] Use In/Out instead of {In/Out}Quad

---
 osu.Game/Screens/Play/HUD/LegacyComboCounter.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/Play/HUD/LegacyComboCounter.cs b/osu.Game/Screens/Play/HUD/LegacyComboCounter.cs
index afcdf5d07f..07dd42e173 100644
--- a/osu.Game/Screens/Play/HUD/LegacyComboCounter.cs
+++ b/osu.Game/Screens/Play/HUD/LegacyComboCounter.cs
@@ -207,8 +207,8 @@ namespace osu.Game.Screens.Play.HUD
             counterContainer.Size = displayedCountSpriteText.Size;
 
             displayedCountSpriteText.ScaleTo(1).Then()
-                                    .ScaleTo(1.1f, small_pop_out_duration / 2, Easing.InQuad).Then()
-                                    .ScaleTo(1, small_pop_out_duration / 2, Easing.OutQuad);
+                                    .ScaleTo(1.1f, small_pop_out_duration / 2, Easing.In).Then()
+                                    .ScaleTo(1, small_pop_out_duration / 2, Easing.Out);
         }
 
         private void scheduledPopOutSmall(uint id)

From cb62d3d4b9528336b0a8a950a05cb7f0b271851a Mon Sep 17 00:00:00 2001
From: Sebastian Krajewski <mail@wieku.me>
Date: Wed, 30 Mar 2022 01:09:05 +0200
Subject: [PATCH 3787/5547] Remove skin dependency as component is
 reinitialized on skin change

---
 osu.Game/Screens/Play/HUD/LegacyComboCounter.cs | 13 -------------
 1 file changed, 13 deletions(-)

diff --git a/osu.Game/Screens/Play/HUD/LegacyComboCounter.cs b/osu.Game/Screens/Play/HUD/LegacyComboCounter.cs
index 07dd42e173..eaca623e39 100644
--- a/osu.Game/Screens/Play/HUD/LegacyComboCounter.cs
+++ b/osu.Game/Screens/Play/HUD/LegacyComboCounter.cs
@@ -44,9 +44,6 @@ namespace osu.Game.Screens.Play.HUD
 
         private readonly Container counterContainer;
 
-        [Resolved]
-        private ISkinSource skin { get; set; }
-
         /// <summary>
         /// Hides the combo counter internally without affecting its <see cref="SkinnableInfo"/>.
         /// </summary>
@@ -135,8 +132,6 @@ namespace osu.Game.Screens.Play.HUD
 
             Current.BindValueChanged(combo => updateCount(combo.NewValue == 0), true);
 
-            // Since layout depends on combo font height we need to update it during skin change
-            skin.SourceChanged += updateLayout;
             updateLayout();
         }
 
@@ -292,13 +287,5 @@ namespace osu.Game.Screens.Play.HUD
             double difference = currentValue > newValue ? currentValue - newValue : newValue - currentValue;
             return difference * rolling_duration;
         }
-
-        protected override void Dispose(bool isDisposing)
-        {
-            base.Dispose(isDisposing);
-
-            if (skin != null)
-                skin.SourceChanged -= updateLayout;
-        }
     }
 }

From e7d2d94eeef6b11cc13660855b8267247ffc202c Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Wed, 30 Mar 2022 02:16:50 +0100
Subject: [PATCH 3788/5547] Fix code quality issues in `ChatTextBar`

---
 osu.Game/Overlays/Chat/ChatTextBar.cs | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Overlays/Chat/ChatTextBar.cs b/osu.Game/Overlays/Chat/ChatTextBar.cs
index 00284fdd33..66f9f281c9 100644
--- a/osu.Game/Overlays/Chat/ChatTextBar.cs
+++ b/osu.Game/Overlays/Chat/ChatTextBar.cs
@@ -21,14 +21,13 @@ namespace osu.Game.Overlays.Chat
     {
         public readonly BindableBool ShowSearch = new BindableBool();
 
-        public ChatTextBox TextBox => chatTextBox;
+        public ChatTextBox TextBox { get; private set; } = null!;
 
         [Resolved]
         private Bindable<Channel> currentChannel { get; set; } = null!;
 
         private OsuTextFlowContainer chattingTextContainer = null!;
         private Container searchIconContainer = null!;
-        private ChatTextBox chatTextBox = null!;
         private Container enterContainer = null!;
 
         private const float chatting_text_width = 180;
@@ -89,7 +88,7 @@ namespace osu.Game.Overlays.Chat
                             {
                                 RelativeSizeAxes = Axes.Both,
                                 Padding = new MarginPadding { Right = 5 },
-                                Child = chatTextBox =  new ChatTextBox
+                                Child = TextBox = new ChatTextBox
                                 {
                                     Anchor = Anchor.CentreLeft,
                                     Origin = Anchor.CentreLeft,
@@ -156,16 +155,19 @@ namespace osu.Game.Overlays.Chat
             currentChannel.BindValueChanged(change =>
             {
                 Channel newChannel = change.NewValue;
+
                 switch (newChannel?.Type)
                 {
                     case ChannelType.Public:
                         chattingTextContainer.Text = $"chatting in {newChannel.Name}";
                         break;
+
                     case ChannelType.PM:
                         chattingTextContainer.Text = $"chatting with {newChannel.Name}";
                         break;
+
                     default:
-                        chattingTextContainer.Text = "";
+                        chattingTextContainer.Text = string.Empty;
                         break;
                 }
             }, true);

From bd9c0076df59f0317fd9d43c69741ab2c5ef7044 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 30 Mar 2022 13:03:10 +0900
Subject: [PATCH 3789/5547] Fix scores sometimes shown with incorrect scoring
 mode

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

diff --git a/osu.Game/Scoring/ScoreManager.cs b/osu.Game/Scoring/ScoreManager.cs
index 83359838aa..113886dbd7 100644
--- a/osu.Game/Scoring/ScoreManager.cs
+++ b/osu.Game/Scoring/ScoreManager.cs
@@ -118,7 +118,11 @@ namespace osu.Game.Scoring
         public void GetTotalScore([NotNull] ScoreInfo score, [NotNull] Action<long> callback, ScoringMode mode = ScoringMode.Standardised, CancellationToken cancellationToken = default)
         {
             GetTotalScoreAsync(score, mode, cancellationToken)
-                .ContinueWith(task => scheduler.Add(() => callback(task.GetResultSafely())), TaskContinuationOptions.OnlyOnRanToCompletion);
+                .ContinueWith(task => scheduler.Add(() =>
+                {
+                    if (!cancellationToken.IsCancellationRequested)
+                        callback(task.GetResultSafely());
+                }), TaskContinuationOptions.OnlyOnRanToCompletion);
         }
 
         /// <summary>

From 4df63a4900897c6811a2a233b1602acbe3be6bb0 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 30 Mar 2022 13:15:41 +0900
Subject: [PATCH 3790/5547] Prevent scores being calculated twice

---
 osu.Game/Scoring/ScoreManager.cs | 16 ++++++----------
 1 file changed, 6 insertions(+), 10 deletions(-)

diff --git a/osu.Game/Scoring/ScoreManager.cs b/osu.Game/Scoring/ScoreManager.cs
index 113886dbd7..fbec6ea1fb 100644
--- a/osu.Game/Scoring/ScoreManager.cs
+++ b/osu.Game/Scoring/ScoreManager.cs
@@ -90,12 +90,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)
-        {
-            var bindable = new TotalScoreBindable(score, this);
-            configManager?.BindWith(OsuSetting.ScoreDisplayMode, bindable.ScoringMode);
-            return bindable;
-        }
+        public Bindable<long> GetBindableTotalScore([NotNull] ScoreInfo score) => new TotalScoreBindable(score, this, configManager);
 
         /// <summary>
         /// Retrieves a bindable that represents the formatted total score string of a <see cref="ScoreInfo"/>.
@@ -187,8 +182,7 @@ namespace osu.Game.Scoring
         /// </summary>
         private class TotalScoreBindable : Bindable<long>
         {
-            public readonly Bindable<ScoringMode> ScoringMode = new Bindable<ScoringMode>();
-
+            private readonly Bindable<ScoringMode> scoringMode = new Bindable<ScoringMode>();
             private readonly ScoreInfo score;
             private readonly ScoreManager scoreManager;
 
@@ -199,12 +193,14 @@ namespace osu.Game.Scoring
             /// </summary>
             /// <param name="score">The <see cref="ScoreInfo"/> to provide the total score of.</param>
             /// <param name="scoreManager">The <see cref="ScoreManager"/>.</param>
-            public TotalScoreBindable(ScoreInfo score, ScoreManager scoreManager)
+            /// <param name="configManager">The config.</param>
+            public TotalScoreBindable(ScoreInfo score, ScoreManager scoreManager, OsuConfigManager configManager)
             {
                 this.score = score;
                 this.scoreManager = scoreManager;
 
-                ScoringMode.BindValueChanged(onScoringModeChanged, true);
+                configManager?.BindWith(OsuSetting.ScoreDisplayMode, scoringMode);
+                scoringMode.BindValueChanged(onScoringModeChanged, true);
             }
 
             private void onScoringModeChanged(ValueChangedEvent<ScoringMode> mode)

From 975883da5c4ce921ee48319ee000c4f901f6a3c2 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 30 Mar 2022 13:34:48 +0900
Subject: [PATCH 3791/5547] Move all usages of `client.realm` filename to a
 single `const`

---
 osu.Game.Benchmarks/BenchmarkRealmReads.cs    |  2 +-
 osu.Game.Tests/Database/RealmTest.cs          |  4 ++--
 .../NonVisual/CustomDataDirectoryTest.cs      | 20 ++++++++-----------
 osu.Game/Database/RealmAccess.cs              |  2 +-
 osu.Game/IO/OsuStorage.cs                     |  6 +++---
 osu.Game/OsuGameBase.cs                       |  7 ++++++-
 .../Maintenance/MigrationSelectScreen.cs      |  2 +-
 osu.Game/Tests/Visual/OsuTestScene.cs         |  2 +-
 8 files changed, 23 insertions(+), 22 deletions(-)

diff --git a/osu.Game.Benchmarks/BenchmarkRealmReads.cs b/osu.Game.Benchmarks/BenchmarkRealmReads.cs
index bf9467700c..615e2e964d 100644
--- a/osu.Game.Benchmarks/BenchmarkRealmReads.cs
+++ b/osu.Game.Benchmarks/BenchmarkRealmReads.cs
@@ -27,7 +27,7 @@ namespace osu.Game.Benchmarks
             storage = new TemporaryNativeStorage("realm-benchmark");
             storage.DeleteDirectory(string.Empty);
 
-            realm = new RealmAccess(storage, "client");
+            realm = new RealmAccess(storage, OsuGameBase.CLIENT_DATABASE_FILENAME);
 
             realm.Run(r =>
             {
diff --git a/osu.Game.Tests/Database/RealmTest.cs b/osu.Game.Tests/Database/RealmTest.cs
index 838759c991..16072888b9 100644
--- a/osu.Game.Tests/Database/RealmTest.cs
+++ b/osu.Game.Tests/Database/RealmTest.cs
@@ -39,7 +39,7 @@ namespace osu.Game.Tests.Database
                     // ReSharper disable once AccessToDisposedClosure
                     var testStorage = new OsuStorage(host, storage.GetStorageForDirectory(caller));
 
-                    using (var realm = new RealmAccess(testStorage, "client"))
+                    using (var realm = new RealmAccess(testStorage, OsuGameBase.CLIENT_DATABASE_FILENAME))
                     {
                         Logger.Log($"Running test using realm file {testStorage.GetFullPath(realm.Filename)}");
                         testAction(realm, testStorage);
@@ -62,7 +62,7 @@ namespace osu.Game.Tests.Database
                 {
                     var testStorage = storage.GetStorageForDirectory(caller);
 
-                    using (var realm = new RealmAccess(testStorage, "client"))
+                    using (var realm = new RealmAccess(testStorage, OsuGameBase.CLIENT_DATABASE_FILENAME))
                     {
                         Logger.Log($"Running test using realm file {testStorage.GetFullPath(realm.Filename)}");
                         await testAction(realm, testStorage);
diff --git a/osu.Game.Tests/NonVisual/CustomDataDirectoryTest.cs b/osu.Game.Tests/NonVisual/CustomDataDirectoryTest.cs
index b5ab33b9fc..fd5691a9f4 100644
--- a/osu.Game.Tests/NonVisual/CustomDataDirectoryTest.cs
+++ b/osu.Game.Tests/NonVisual/CustomDataDirectoryTest.cs
@@ -143,14 +143,14 @@ namespace osu.Game.Tests.NonVisual
                     Assert.That(osuStorage, Is.Not.Null);
 
                     // In the following tests, realm files are ignored as
-                    // - in the case of checking the source, interacting with the pipe files (client.realm.note) may
+                    // - in the case of checking the source, interacting with the pipe files (.realm.note) may
                     //   lead to unexpected behaviour.
                     // - in the case of checking the destination, the files may have already been recreated by the game
                     //   as part of the standard migration flow.
 
                     foreach (string file in osuStorage.IgnoreFiles)
                     {
-                        if (!file.Contains("realm", StringComparison.Ordinal))
+                        if (!file.Contains(".realm", StringComparison.Ordinal))
                         {
                             Assert.That(File.Exists(Path.Combine(originalDirectory, file)));
                             Assert.That(storage.Exists(file), Is.False, () => $"{file} exists in destination when it was expected to be ignored");
@@ -159,7 +159,7 @@ namespace osu.Game.Tests.NonVisual
 
                     foreach (string dir in osuStorage.IgnoreDirectories)
                     {
-                        if (!dir.Contains("realm", StringComparison.Ordinal))
+                        if (!dir.Contains(".realm", StringComparison.Ordinal))
                         {
                             Assert.That(Directory.Exists(Path.Combine(originalDirectory, dir)));
                             Assert.That(storage.Exists(dir), Is.False, () => $"{dir} exists in destination when it was expected to be ignored");
@@ -188,19 +188,17 @@ namespace osu.Game.Tests.NonVisual
                 {
                     var osu = LoadOsuIntoHost(host);
 
-                    const string database_filename = "client.realm";
-
                     Assert.DoesNotThrow(() => osu.Migrate(customPath));
-                    Assert.That(File.Exists(Path.Combine(customPath, database_filename)));
+                    Assert.That(File.Exists(Path.Combine(customPath, OsuGameBase.CLIENT_DATABASE_FILENAME)));
 
                     Assert.DoesNotThrow(() => osu.Migrate(customPath2));
-                    Assert.That(File.Exists(Path.Combine(customPath2, database_filename)));
+                    Assert.That(File.Exists(Path.Combine(customPath2, OsuGameBase.CLIENT_DATABASE_FILENAME)));
 
                     // some files may have been left behind for whatever reason, but that's not what we're testing here.
                     cleanupPath(customPath);
 
                     Assert.DoesNotThrow(() => osu.Migrate(customPath));
-                    Assert.That(File.Exists(Path.Combine(customPath, database_filename)));
+                    Assert.That(File.Exists(Path.Combine(customPath, OsuGameBase.CLIENT_DATABASE_FILENAME)));
                 }
                 finally
                 {
@@ -250,13 +248,11 @@ namespace osu.Game.Tests.NonVisual
 
                     string originalDirectory = storage.GetFullPath(".");
 
-                    const string database_filename = "client.realm";
-
                     Assert.DoesNotThrow(() => osu.Migrate(customPath));
-                    Assert.That(File.Exists(Path.Combine(customPath, database_filename)));
+                    Assert.That(File.Exists(Path.Combine(customPath, OsuGameBase.CLIENT_DATABASE_FILENAME)));
 
                     Directory.CreateDirectory(customPath2);
-                    File.Copy(Path.Combine(customPath, database_filename), Path.Combine(customPath2, database_filename));
+                    File.Copy(Path.Combine(customPath, OsuGameBase.CLIENT_DATABASE_FILENAME), Path.Combine(customPath2, OsuGameBase.CLIENT_DATABASE_FILENAME));
 
                     // Fails because file already exists.
                     Assert.Throws<ArgumentException>(() => osu.Migrate(customPath2));
diff --git a/osu.Game/Database/RealmAccess.cs b/osu.Game/Database/RealmAccess.cs
index 8dbb338980..b0a70b51d0 100644
--- a/osu.Game/Database/RealmAccess.cs
+++ b/osu.Game/Database/RealmAccess.cs
@@ -212,7 +212,7 @@ namespace osu.Game.Database
                     if (realm.All<ScoreInfo>().Any())
                     {
                         Logger.Log(@"Recovery aborted as the existing database has scores set already.", LoggingTarget.Database);
-                        Logger.Log(@"To perform recovery, delete client.realm while osu! is not running.", LoggingTarget.Database);
+                        Logger.Log($@"To perform recovery, delete {OsuGameBase.CLIENT_DATABASE_FILENAME} while osu! is not running.", LoggingTarget.Database);
                         return;
                     }
                 }
diff --git a/osu.Game/IO/OsuStorage.cs b/osu.Game/IO/OsuStorage.cs
index a3f7b4bfec..c49365a9de 100644
--- a/osu.Game/IO/OsuStorage.cs
+++ b/osu.Game/IO/OsuStorage.cs
@@ -36,15 +36,15 @@ namespace osu.Game.IO
         public override string[] IgnoreDirectories => new[]
         {
             "cache",
-            "client.realm.management"
+            $"{OsuGameBase.CLIENT_DATABASE_FILENAME}.management",
         };
 
         public override string[] IgnoreFiles => new[]
         {
             "framework.ini",
             "storage.ini",
-            "client.realm.note",
-            "client.realm.lock",
+            $"{OsuGameBase.CLIENT_DATABASE_FILENAME}.note",
+            $"{OsuGameBase.CLIENT_DATABASE_FILENAME}.lock",
         };
 
         public OsuStorage(GameHost host, Storage defaultStorage)
diff --git a/osu.Game/OsuGameBase.cs b/osu.Game/OsuGameBase.cs
index 7b9aca4086..324fcada89 100644
--- a/osu.Game/OsuGameBase.cs
+++ b/osu.Game/OsuGameBase.cs
@@ -57,6 +57,11 @@ namespace osu.Game
 
         public const string CLIENT_STREAM_NAME = @"lazer";
 
+        /// <summary>
+        /// The filename of the main client database.
+        /// </summary>
+        public const string CLIENT_DATABASE_FILENAME = @"client.realm";
+
         public const int SAMPLE_CONCURRENCY = 6;
 
         /// <summary>
@@ -200,7 +205,7 @@ namespace osu.Game
             if (Storage.Exists(DatabaseContextFactory.DATABASE_NAME))
                 dependencies.Cache(EFContextFactory = new DatabaseContextFactory(Storage));
 
-            dependencies.Cache(realm = new RealmAccess(Storage, "client", Host.UpdateThread, EFContextFactory));
+            dependencies.Cache(realm = new RealmAccess(Storage, CLIENT_DATABASE_FILENAME, Host.UpdateThread, EFContextFactory));
 
             dependencies.CacheAs<RulesetStore>(RulesetStore = new RealmRulesetStore(realm, Storage));
             dependencies.CacheAs<IRulesetStore>(RulesetStore);
diff --git a/osu.Game/Overlays/Settings/Sections/Maintenance/MigrationSelectScreen.cs b/osu.Game/Overlays/Settings/Sections/Maintenance/MigrationSelectScreen.cs
index 047587e084..0304a4291a 100644
--- a/osu.Game/Overlays/Settings/Sections/Maintenance/MigrationSelectScreen.cs
+++ b/osu.Game/Overlays/Settings/Sections/Maintenance/MigrationSelectScreen.cs
@@ -47,7 +47,7 @@ namespace osu.Game.Overlays.Settings.Sections.Maintenance
                 if (directoryInfos.Length > 0 || fileInfos.Length > 0)
                 {
                     // Quick test for whether there's already an osu! install at the target path.
-                    if (fileInfos.Any(f => f.Name == @"client.realm"))
+                    if (fileInfos.Any(f => f.Name == OsuGameBase.CLIENT_DATABASE_FILENAME))
                     {
                         dialogOverlay.Push(new ConfirmDialog("The target directory already seems to have an osu! install. Use that data instead?", () =>
                             {
diff --git a/osu.Game/Tests/Visual/OsuTestScene.cs b/osu.Game/Tests/Visual/OsuTestScene.cs
index 6c332c2408..f2d280417e 100644
--- a/osu.Game/Tests/Visual/OsuTestScene.cs
+++ b/osu.Game/Tests/Visual/OsuTestScene.cs
@@ -121,7 +121,7 @@ namespace osu.Game.Tests.Visual
 
             Resources = parent.Get<OsuGameBase>().Resources;
 
-            realm = new Lazy<RealmAccess>(() => new RealmAccess(LocalStorage, "client", host.UpdateThread));
+            realm = new Lazy<RealmAccess>(() => new RealmAccess(LocalStorage, OsuGameBase.CLIENT_DATABASE_FILENAME, host.UpdateThread));
 
             RecycleLocalStorage(false);
 

From bc0b982102a89c8e18ef46944c47e004ec82780b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 30 Mar 2022 17:46:17 +0900
Subject: [PATCH 3792/5547] Remove song source from main wedge display

This was definitely added at someone's request, since I wouldn't have
put it here. But it's displayed below in the details section already and
also not displayed in the updated "wedge" in the new design.

See https://github.com/ppy/osu/discussions/17537 for discussion.
---
 .../Visual/SongSelect/TestSceneBeatmapInfoWedge.cs        | 2 +-
 osu.Game/Screens/Select/BeatmapInfoWedge.cs               | 8 ++++----
 2 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapInfoWedge.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapInfoWedge.cs
index fd3f739c34..644a333fcf 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapInfoWedge.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapInfoWedge.cs
@@ -116,7 +116,7 @@ namespace osu.Game.Tests.Visual.SongSelect
         private void testBeatmapLabels(Ruleset ruleset)
         {
             AddAssert("check version", () => infoWedge.Info.VersionLabel.Current.Value == $"{ruleset.ShortName}Version");
-            AddAssert("check title", () => infoWedge.Info.TitleLabel.Current.Value == $"{ruleset.ShortName}Source — {ruleset.ShortName}Title");
+            AddAssert("check title", () => infoWedge.Info.TitleLabel.Current.Value == $"{ruleset.ShortName}Title");
             AddAssert("check artist", () => infoWedge.Info.ArtistLabel.Current.Value == $"{ruleset.ShortName}Artist");
             AddAssert("check author", () => infoWedge.Info.MapperContainer.ChildrenOfType<OsuSpriteText>().Any(s => s.Current.Value == $"{ruleset.ShortName}Author"));
         }
diff --git a/osu.Game/Screens/Select/BeatmapInfoWedge.cs b/osu.Game/Screens/Select/BeatmapInfoWedge.cs
index 1e0aaf9c27..1a5a09afa3 100644
--- a/osu.Game/Screens/Select/BeatmapInfoWedge.cs
+++ b/osu.Game/Screens/Select/BeatmapInfoWedge.cs
@@ -314,8 +314,8 @@ namespace osu.Game.Screens.Select
                     }
                 };
 
-                titleBinding.BindValueChanged(_ => setMetadata(metadata.Source));
-                artistBinding.BindValueChanged(_ => setMetadata(metadata.Source), true);
+                titleBinding.BindValueChanged(_ => setMetadata());
+                artistBinding.BindValueChanged(_ => setMetadata(), true);
 
                 addInfoLabels();
             }
@@ -352,10 +352,10 @@ namespace osu.Game.Screens.Select
                 }, true);
             }
 
-            private void setMetadata(string source)
+            private void setMetadata()
             {
                 ArtistLabel.Text = artistBinding.Value;
-                TitleLabel.Text = string.IsNullOrEmpty(source) ? titleBinding.Value : source + " — " + titleBinding.Value;
+                TitleLabel.Text = titleBinding.Value;
             }
 
             private void addInfoLabels()

From f9f6248101a62841037d1afe294aa544cf58cfd0 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 30 Mar 2022 17:59:45 +0900
Subject: [PATCH 3793/5547] Simplify string bindings

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

diff --git a/osu.Game/Screens/Select/BeatmapInfoWedge.cs b/osu.Game/Screens/Select/BeatmapInfoWedge.cs
index 1a5a09afa3..7db1016f62 100644
--- a/osu.Game/Screens/Select/BeatmapInfoWedge.cs
+++ b/osu.Game/Screens/Select/BeatmapInfoWedge.cs
@@ -287,12 +287,14 @@ namespace osu.Game.Screens.Select
                         {
                             TitleLabel = new OsuSpriteText
                             {
+                                Current = { BindTarget = titleBinding },
                                 Font = OsuFont.GetFont(size: 28, italics: true),
                                 RelativeSizeAxes = Axes.X,
                                 Truncate = true,
                             },
                             ArtistLabel = new OsuSpriteText
                             {
+                                Current = { BindTarget = artistBinding },
                                 Font = OsuFont.GetFont(size: 17, italics: true),
                                 RelativeSizeAxes = Axes.X,
                                 Truncate = true,
@@ -314,9 +316,6 @@ namespace osu.Game.Screens.Select
                     }
                 };
 
-                titleBinding.BindValueChanged(_ => setMetadata());
-                artistBinding.BindValueChanged(_ => setMetadata(), true);
-
                 addInfoLabels();
             }
 
@@ -352,12 +351,6 @@ namespace osu.Game.Screens.Select
                 }, true);
             }
 
-            private void setMetadata()
-            {
-                ArtistLabel.Text = artistBinding.Value;
-                TitleLabel.Text = titleBinding.Value;
-            }
-
             private void addInfoLabels()
             {
                 if (working.Beatmap?.HitObjects?.Any() != true)

From 671386ba6cf29492d213d9cf19c5ad04754def65 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 30 Mar 2022 20:35:11 +0900
Subject: [PATCH 3794/5547] Fix `MultiplayerMatchSongSelect` potentially
 attempting to exit when not the current screen

---
 .../OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs      | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs
index e30ec36e9c..d49c122bd1 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs
@@ -80,6 +80,10 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
                 {
                     Schedule(() =>
                     {
+                        // If an error or server side trigger occurred this screen may have already exited by external means.
+                        if (!this.IsCurrentScreen())
+                            return;
+
                         loadingLayer.Hide();
 
                         if (t.IsFaulted)

From eec3fef7a66382337c2c2ee99c7f28ebb951407e Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Wed, 30 Mar 2022 20:25:23 +0100
Subject: [PATCH 3795/5547] Remove the enter box in `ChatTextBar`

---
 osu.Game/Overlays/Chat/ChatTextBar.cs | 32 ---------------------------
 1 file changed, 32 deletions(-)

diff --git a/osu.Game/Overlays/Chat/ChatTextBar.cs b/osu.Game/Overlays/Chat/ChatTextBar.cs
index 66f9f281c9..7ff1b8d1d3 100644
--- a/osu.Game/Overlays/Chat/ChatTextBar.cs
+++ b/osu.Game/Overlays/Chat/ChatTextBar.cs
@@ -28,7 +28,6 @@ namespace osu.Game.Overlays.Chat
 
         private OsuTextFlowContainer chattingTextContainer = null!;
         private Container searchIconContainer = null!;
-        private Container enterContainer = null!;
 
         private const float chatting_text_width = 180;
         private const float search_icon_width = 40;
@@ -54,7 +53,6 @@ namespace osu.Game.Overlays.Chat
                         new Dimension(GridSizeMode.AutoSize),
                         new Dimension(GridSizeMode.AutoSize),
                         new Dimension(),
-                        new Dimension(GridSizeMode.AutoSize),
                     },
                     Content = new[]
                     {
@@ -98,34 +96,6 @@ namespace osu.Game.Overlays.Chat
                                     ReleaseFocusOnCommit = false,
                                 },
                             },
-                            enterContainer = new Container
-                            {
-                                Origin = Anchor.CentreLeft,
-                                Anchor = Anchor.CentreLeft,
-                                Masking = true,
-                                BorderColour = colourProvider.Background1,
-                                BorderThickness = 2,
-                                CornerRadius = 10,
-                                Margin = new MarginPadding { Right = 10 },
-                                Size = new Vector2(60, 30),
-                                Children = new Drawable[]
-                                {
-                                    new Box
-                                    {
-                                        RelativeSizeAxes = Axes.Both,
-                                        Colour = Colour4.Transparent,
-                                    },
-                                    new OsuSpriteText
-                                    {
-                                        Text = "Enter",
-                                        Origin = Anchor.Centre,
-                                        Anchor = Anchor.Centre,
-                                        Colour = colourProvider.Background1,
-                                        Font = OsuFont.Torus.With(size: 20),
-                                        Margin = new MarginPadding { Bottom = 2 },
-                                    },
-                                },
-                            },
                         },
                     },
                 },
@@ -141,13 +111,11 @@ namespace osu.Game.Overlays.Chat
                 if (change.NewValue)
                 {
                     chattingTextContainer.Hide();
-                    enterContainer.Hide();
                     searchIconContainer.Show();
                 }
                 else
                 {
                     chattingTextContainer.Show();
-                    enterContainer.Show();
                     searchIconContainer.Hide();
                 }
             }, true);

From fff30e8a6ea20b9189f87547e86be90cd01ddfa7 Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Wed, 30 Mar 2022 21:01:28 +0100
Subject: [PATCH 3796/5547] Simplify show/hide of text and search in
 `ChatTextBar`

---
 osu.Game/Overlays/Chat/ChatTextBar.cs | 14 ++++----------
 1 file changed, 4 insertions(+), 10 deletions(-)

diff --git a/osu.Game/Overlays/Chat/ChatTextBar.cs b/osu.Game/Overlays/Chat/ChatTextBar.cs
index 7ff1b8d1d3..d7edbb83b6 100644
--- a/osu.Game/Overlays/Chat/ChatTextBar.cs
+++ b/osu.Game/Overlays/Chat/ChatTextBar.cs
@@ -108,16 +108,10 @@ namespace osu.Game.Overlays.Chat
 
             ShowSearch.BindValueChanged(change =>
             {
-                if (change.NewValue)
-                {
-                    chattingTextContainer.Hide();
-                    searchIconContainer.Show();
-                }
-                else
-                {
-                    chattingTextContainer.Show();
-                    searchIconContainer.Hide();
-                }
+                bool showSearch = change.NewValue;
+
+                chattingTextContainer.FadeTo(showSearch ? 0 : 1);
+                searchIconContainer.FadeTo(showSearch ? 1 : 0);
             }, true);
 
             currentChannel.BindValueChanged(change =>

From 83bae81095dd8de79cfef2f166db8eeb16c0873a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 30 Mar 2022 22:02:51 +0200
Subject: [PATCH 3797/5547] Fill out `ICreateReplayData` xmldocs

---
 osu.Game/Rulesets/Mods/ICreateReplayData.cs | 11 ++++++++---
 1 file changed, 8 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Rulesets/Mods/ICreateReplayData.cs b/osu.Game/Rulesets/Mods/ICreateReplayData.cs
index b022949345..1d07b95e7a 100644
--- a/osu.Game/Rulesets/Mods/ICreateReplayData.cs
+++ b/osu.Game/Rulesets/Mods/ICreateReplayData.cs
@@ -5,6 +5,7 @@ using System.Collections.Generic;
 using osu.Game.Beatmaps;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Replays;
+using osu.Game.Scoring;
 using osu.Game.Users;
 
 namespace osu.Game.Rulesets.Mods
@@ -17,9 +18,13 @@ namespace osu.Game.Rulesets.Mods
         /// <summary>
         /// Create replay data.
         /// </summary>
-        /// <param name="beatmap"></param>
-        /// <param name="mods"></param>
-        /// <returns></returns>
+        /// <param name="beatmap">The beatmap to create replay data for.</param>
+        /// <param name="mods">The mods to take into account when creating the replay data.</param>
+        /// <returns>A <see cref="ModReplayData"/> structure, containing the generated replay data.</returns>
+        /// <remarks>
+        /// For callers that want to receive a directly usable <see cref="Score"/> instance,
+        /// the <see cref="ModExtensions.CreateScoreFromReplayData"/> extension method is provided for convenience.
+        /// </remarks>
         public ModReplayData CreateReplayData(IBeatmap beatmap, IReadOnlyList<Mod> mods);
     }
 

From 436dec68c993813c20a8ff6753f459390226e38b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 30 Mar 2022 22:03:51 +0200
Subject: [PATCH 3798/5547] Use provided extension method instead of
 reimplementing locally

---
 osu.Game/Screens/Select/PlaySongSelect.cs | 19 +------------------
 1 file changed, 1 insertion(+), 18 deletions(-)

diff --git a/osu.Game/Screens/Select/PlaySongSelect.cs b/osu.Game/Screens/Select/PlaySongSelect.cs
index 3f2a5c6183..593436bbb7 100644
--- a/osu.Game/Screens/Select/PlaySongSelect.cs
+++ b/osu.Game/Screens/Select/PlaySongSelect.cs
@@ -8,7 +8,6 @@ using osu.Framework.Graphics.Sprites;
 using osu.Framework.Input.Events;
 using osu.Framework.Screens;
 using osu.Game.Graphics;
-using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays;
 using osu.Game.Overlays.Notifications;
 using osu.Game.Rulesets.Mods;
@@ -103,23 +102,7 @@ namespace osu.Game.Screens.Select
 
                 if (replayGeneratingMod != null)
                 {
-                    return new ReplayPlayer((beatmap, mods) =>
-                    {
-                        var replayData = replayGeneratingMod.CreateReplayData(beatmap, mods);
-
-                        return new Score
-                        {
-                            Replay = replayData.Replay,
-                            ScoreInfo =
-                            {
-                                User = new APIUser
-                                {
-                                    Id = APIUser.SYSTEM_USER_ID,
-                                    Username = replayData.User.Username,
-                                }
-                            }
-                        };
-                    });
+                    return new ReplayPlayer((beatmap, mods) => replayGeneratingMod.CreateScoreFromReplayData(beatmap, mods));
                 }
 
                 return new SoloPlayer();

From f4184cb6fe5abc7ae7e86d7f0fecace52f4b010c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 30 Mar 2022 22:04:19 +0200
Subject: [PATCH 3799/5547] Fix typo in step name

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

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneAutoplay.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneAutoplay.cs
index 518ab5a1d3..346a88a2d5 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneAutoplay.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneAutoplay.cs
@@ -47,7 +47,7 @@ namespace osu.Game.Tests.Visual.Gameplay
             AddAssert("score has combo", () => getResultsScreen().Score.Combo > 100);
             AddAssert("score has no misses", () => getResultsScreen().Score.Statistics[HitResult.Miss] == 0);
 
-            AddUntilStep("avatar dispalyed", () => getAvatar() != null);
+            AddUntilStep("avatar displayed", () => getAvatar() != null);
             AddAssert("avatar not clickable", () => getAvatar().ChildrenOfType<OsuClickableContainer>().First().Action == null);
 
             ClickableAvatar getAvatar() => getResultsScreen()

From 3ac0da2da305feac1ea30999e257027ffe37e51f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 26 Mar 2022 21:33:52 +0100
Subject: [PATCH 3800/5547] Implement sheared toggle button

---
 .../TestSceneShearedToggleButton.cs           |  88 ++++++++++
 .../UserInterface/ShearedToggleButton.cs      | 155 ++++++++++++++++++
 2 files changed, 243 insertions(+)
 create mode 100644 osu.Game.Tests/Visual/UserInterface/TestSceneShearedToggleButton.cs
 create mode 100644 osu.Game/Graphics/UserInterface/ShearedToggleButton.cs

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneShearedToggleButton.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneShearedToggleButton.cs
new file mode 100644
index 0000000000..a969858157
--- /dev/null
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneShearedToggleButton.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 NUnit.Framework;
+using osu.Framework.Allocation;
+using osu.Framework.Graphics;
+using osu.Game.Graphics.UserInterface;
+using osu.Game.Overlays;
+using osuTK.Input;
+
+namespace osu.Game.Tests.Visual.UserInterface
+{
+    [TestFixture]
+    public class TestSceneShearedToggleButton : OsuManualInputManagerTestScene
+    {
+        [Cached]
+        private OverlayColourProvider colourProvider = new OverlayColourProvider(OverlayColourScheme.Green);
+
+        [Test]
+        public void TestShearedToggleButton()
+        {
+            ShearedToggleButton button = null;
+
+            AddStep("create button", () =>
+            {
+                Child = button = new ShearedToggleButton(0.2f)
+                {
+                    Anchor = Anchor.Centre,
+                    Origin = Anchor.Centre,
+                    Text = "Toggle me",
+                    Width = 200
+                };
+            });
+
+            AddToggleStep("toggle button", active => button.Active.Value = active);
+            AddToggleStep("toggle disabled", disabled => button.Active.Disabled = disabled);
+        }
+
+        [Test]
+        public void TestDisabledState()
+        {
+            ShearedToggleButton button = null;
+
+            AddStep("create button", () =>
+            {
+                Child = button = new ShearedToggleButton(0.2f)
+                {
+                    Anchor = Anchor.Centre,
+                    Origin = Anchor.Centre,
+                    Text = "Toggle me",
+                    Width = 200
+                };
+            });
+
+            clickToggle();
+            assertToggleState(true);
+
+            clickToggle();
+            assertToggleState(false);
+
+            setToggleDisabledState(true);
+
+            assertToggleState(false);
+            clickToggle();
+            assertToggleState(false);
+
+            setToggleDisabledState(false);
+            assertToggleState(false);
+            clickToggle();
+            assertToggleState(true);
+
+            setToggleDisabledState(true);
+            assertToggleState(true);
+            clickToggle();
+            assertToggleState(true);
+
+            void clickToggle() => AddStep("click toggle", () =>
+            {
+                InputManager.MoveMouseTo(button);
+                InputManager.Click(MouseButton.Left);
+            });
+
+            void assertToggleState(bool active) => AddAssert($"toggle is {(active ? "" : "not ")}active", () => button.Active.Value == active);
+
+            void setToggleDisabledState(bool disabled) => AddStep($"{(disabled ? "disable" : "enable")} toggle", () => button.Active.Disabled = disabled);
+        }
+    }
+}
diff --git a/osu.Game/Graphics/UserInterface/ShearedToggleButton.cs b/osu.Game/Graphics/UserInterface/ShearedToggleButton.cs
new file mode 100644
index 0000000000..acbed29279
--- /dev/null
+++ b/osu.Game/Graphics/UserInterface/ShearedToggleButton.cs
@@ -0,0 +1,155 @@
+// 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 enable
+
+using System;
+using osu.Framework.Allocation;
+using osu.Framework.Audio;
+using osu.Framework.Audio.Sample;
+using osu.Framework.Bindables;
+using osu.Framework.Extensions.Color4Extensions;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Colour;
+using osu.Framework.Graphics.Shapes;
+using osu.Framework.Input.Events;
+using osu.Framework.Localisation;
+using osu.Game.Graphics.Containers;
+using osu.Game.Graphics.Sprites;
+using osu.Game.Overlays;
+using osuTK;
+
+namespace osu.Game.Graphics.UserInterface
+{
+    public class ShearedToggleButton : OsuClickableContainer
+    {
+        public BindableBool Active { get; } = new BindableBool();
+
+        public LocalisableString Text
+        {
+            get => text.Text;
+            set => text.Text = value;
+        }
+
+        private readonly Box background;
+        private readonly OsuSpriteText text;
+
+        private Sample? sampleOff;
+        private Sample? sampleOn;
+
+        [Resolved]
+        private OverlayColourProvider colourProvider { get; set; } = null!;
+
+        public ShearedToggleButton(float shear)
+        {
+            Height = 50;
+            Padding = new MarginPadding { Horizontal = shear * 50 };
+
+            Content.CornerRadius = 7;
+            Content.Shear = new Vector2(shear, 0);
+            Content.Masking = true;
+            Content.BorderThickness = 2;
+            Content.Anchor = Content.Origin = Anchor.Centre;
+
+            Children = new Drawable[]
+            {
+                background = new Box
+                {
+                    RelativeSizeAxes = Axes.Both
+                },
+                text = new OsuSpriteText
+                {
+                    Anchor = Anchor.Centre,
+                    Origin = Anchor.Centre,
+                    Font = OsuFont.TorusAlternate.With(size: 17),
+                    Shear = new Vector2(-shear, 0)
+                }
+            };
+        }
+
+        [BackgroundDependencyLoader]
+        private void load(AudioManager audio)
+        {
+            sampleOn = audio.Samples.Get(@"UI/check-on");
+            sampleOff = audio.Samples.Get(@"UI/check-off");
+        }
+
+        protected override HoverSounds CreateHoverSounds(HoverSampleSet sampleSet) => new HoverSounds(sampleSet);
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            Active.BindValueChanged(_ =>
+            {
+                updateState();
+                playSample();
+            });
+            Active.BindDisabledChanged(disabled =>
+            {
+                updateState();
+                Action = disabled ? (Action?)null : Active.Toggle;
+            }, true);
+
+            FinishTransforms(true);
+        }
+
+        protected override bool OnHover(HoverEvent e)
+        {
+            updateState();
+            return base.OnHover(e);
+        }
+
+        protected override void OnHoverLost(HoverLostEvent e)
+        {
+            updateState();
+            base.OnHoverLost(e);
+        }
+
+        protected override bool OnMouseDown(MouseDownEvent e)
+        {
+            Content.ScaleTo(0.8f, 2000, Easing.OutQuint);
+            return base.OnMouseDown(e);
+        }
+
+        protected override void OnMouseUp(MouseUpEvent e)
+        {
+            Content.ScaleTo(1, 1000, Easing.OutElastic);
+            base.OnMouseUp(e);
+        }
+
+        private void updateState()
+        {
+            var darkerColour = Active.Value ? colourProvider.Highlight1 : colourProvider.Background3;
+            var lighterColour = Active.Value ? colourProvider.Colour0 : colourProvider.Background1;
+
+            if (Active.Disabled)
+            {
+                darkerColour = darkerColour.Darken(0.3f);
+                lighterColour = lighterColour.Darken(0.3f);
+            }
+            else if (IsHovered)
+            {
+                darkerColour = darkerColour.Lighten(0.3f);
+                lighterColour = lighterColour.Lighten(0.3f);
+            }
+
+            background.FadeColour(darkerColour, 150, Easing.OutQuint);
+            Content.TransformTo(nameof(BorderColour), ColourInfo.GradientVertical(darkerColour, lighterColour), 150, Easing.OutQuint);
+
+            var textColour = Active.Value ? colourProvider.Background6 : colourProvider.Content1;
+            if (Active.Disabled)
+                textColour = textColour.Opacity(0.6f);
+
+            text.FadeColour(textColour, 150, Easing.OutQuint);
+        }
+
+        private void playSample()
+        {
+            if (Active.Value)
+                sampleOn?.Play();
+            else
+                sampleOff?.Play();
+        }
+    }
+}

From 6874cdf0c88db8d49f9545fc633eaab9a7ea307c Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 31 Mar 2022 01:50:46 +0300
Subject: [PATCH 3801/5547] Remove unnecessary `public` prefix in interface
 method

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

diff --git a/osu.Game/Rulesets/Mods/ICreateReplayData.cs b/osu.Game/Rulesets/Mods/ICreateReplayData.cs
index 1d07b95e7a..2b8305ac78 100644
--- a/osu.Game/Rulesets/Mods/ICreateReplayData.cs
+++ b/osu.Game/Rulesets/Mods/ICreateReplayData.cs
@@ -25,7 +25,7 @@ namespace osu.Game.Rulesets.Mods
         /// For callers that want to receive a directly usable <see cref="Score"/> instance,
         /// the <see cref="ModExtensions.CreateScoreFromReplayData"/> extension method is provided for convenience.
         /// </remarks>
-        public ModReplayData CreateReplayData(IBeatmap beatmap, IReadOnlyList<Mod> mods);
+        ModReplayData CreateReplayData(IBeatmap beatmap, IReadOnlyList<Mod> mods);
     }
 
     /// <summary>

From 234bec45cca3a30c66ea13c630066b9fef1b6c43 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 31 Mar 2022 11:32:00 +0900
Subject: [PATCH 3802/5547] Remove unnecessary logging

---
 osu.Game/Rulesets/Mods/ModAutoplay.cs | 2 --
 1 file changed, 2 deletions(-)

diff --git a/osu.Game/Rulesets/Mods/ModAutoplay.cs b/osu.Game/Rulesets/Mods/ModAutoplay.cs
index 10fe97c180..7b9ae187ce 100644
--- a/osu.Game/Rulesets/Mods/ModAutoplay.cs
+++ b/osu.Game/Rulesets/Mods/ModAutoplay.cs
@@ -36,8 +36,6 @@ namespace osu.Game.Rulesets.Mods
 
         public virtual ModReplayData CreateReplayData(IBeatmap beatmap, IReadOnlyList<Mod> mods)
         {
-            Logger.Log($"Ruleset mod implementation for {GetType().Name} should be updated to newer {nameof(ICreateReplayData)} signature.", LoggingTarget.Information);
-
 #pragma warning disable CS0618
             var replayScore = CreateReplayScore(beatmap, mods);
 #pragma warning restore CS0618

From 2c1ccc7d365b26202949ce08ecf86d3146cae77d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 31 Mar 2022 11:33:26 +0900
Subject: [PATCH 3803/5547] Update obsolete message to match targeted
 developers' use case

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

diff --git a/osu.Game/Rulesets/Mods/ModAutoplay.cs b/osu.Game/Rulesets/Mods/ModAutoplay.cs
index 7b9ae187ce..7e54c170bf 100644
--- a/osu.Game/Rulesets/Mods/ModAutoplay.cs
+++ b/osu.Game/Rulesets/Mods/ModAutoplay.cs
@@ -31,7 +31,7 @@ namespace osu.Game.Rulesets.Mods
 
         public override bool HasImplementation => GetType().GenericTypeArguments.Length == 0;
 
-        [Obsolete("Use CreateScoreFromReplayData(IBeatmap, IReadOnlyList<Mod>) instead")] // Can be removed 20220929
+        [Obsolete("Override CreateReplayData(IBeatmap, IReadOnlyList<Mod>) instead")] // Can be removed 20220929
         public virtual Score CreateReplayScore(IBeatmap beatmap, IReadOnlyList<Mod> mods) => new Score { Replay = new Replay() };
 
         public virtual ModReplayData CreateReplayData(IBeatmap beatmap, IReadOnlyList<Mod> mods)

From 0cac9359397ae36e322a628ec7cc8c8c5a43e2f0 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 31 Mar 2022 11:34:23 +0900
Subject: [PATCH 3804/5547] Shorten class name of `ModCreatedReplayUser`

---
 .../Mods/EmptyFreeformModAutoplay.cs                      | 2 +-
 .../Mods/PippidonModAutoplay.cs                           | 2 +-
 .../Mods/EmptyScrollingModAutoplay.cs                     | 2 +-
 .../Mods/PippidonModAutoplay.cs                           | 2 +-
 osu.Game.Rulesets.Catch/Mods/CatchModAutoplay.cs          | 2 +-
 osu.Game.Rulesets.Catch/Mods/CatchModCinema.cs            | 2 +-
 osu.Game.Rulesets.Mania/Mods/ManiaModAutoplay.cs          | 2 +-
 osu.Game.Rulesets.Mania/Mods/ManiaModCinema.cs            | 2 +-
 .../TestSceneMissHitWindowJudgements.cs                   | 2 +-
 osu.Game.Rulesets.Osu/Mods/OsuModAutoplay.cs              | 2 +-
 osu.Game.Rulesets.Osu/Mods/OsuModCinema.cs                | 2 +-
 osu.Game.Rulesets.Taiko/Mods/TaikoModAutoplay.cs          | 2 +-
 osu.Game.Rulesets.Taiko/Mods/TaikoModCinema.cs            | 2 +-
 osu.Game/Rulesets/Mods/ICreateReplay.cs                   | 2 +-
 osu.Game/Rulesets/Mods/ICreateReplayData.cs               | 8 ++++----
 osu.Game/Rulesets/Mods/ModAutoplay.cs                     | 2 +-
 16 files changed, 19 insertions(+), 19 deletions(-)

diff --git a/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform/Mods/EmptyFreeformModAutoplay.cs b/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform/Mods/EmptyFreeformModAutoplay.cs
index dfa0615604..d3ef3f6e56 100644
--- a/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform/Mods/EmptyFreeformModAutoplay.cs
+++ b/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform/Mods/EmptyFreeformModAutoplay.cs
@@ -11,6 +11,6 @@ namespace osu.Game.Rulesets.EmptyFreeform.Mods
     public class EmptyFreeformModAutoplay : ModAutoplay
     {
         public override ModReplayData CreateReplayData(IBeatmap beatmap, IReadOnlyList<Mod> mods)
-            => new ModReplayData(new EmptyFreeformAutoGenerator(beatmap).Generate(), new ModCreatedReplayUser { Username = "sample" });
+            => new ModReplayData(new EmptyFreeformAutoGenerator(beatmap).Generate(), new ModCreatedUser { Username = "sample" });
     }
 }
diff --git a/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon/Mods/PippidonModAutoplay.cs b/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon/Mods/PippidonModAutoplay.cs
index 6a24812ce8..f57b874ff3 100644
--- a/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon/Mods/PippidonModAutoplay.cs
+++ b/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon/Mods/PippidonModAutoplay.cs
@@ -11,6 +11,6 @@ namespace osu.Game.Rulesets.Pippidon.Mods
     public class PippidonModAutoplay : ModAutoplay
     {
         public override ModReplayData CreateReplayData(IBeatmap beatmap, IReadOnlyList<Mod> mods)
-            => new ModReplayData(new PippidonAutoGenerator(beatmap).Generate(), new ModCreatedReplayUser { Username = "sample" });
+            => new ModReplayData(new PippidonAutoGenerator(beatmap).Generate(), new ModCreatedUser { Username = "sample" });
     }
 }
diff --git a/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling/Mods/EmptyScrollingModAutoplay.cs b/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling/Mods/EmptyScrollingModAutoplay.cs
index cd0233fb51..5cf40c30cd 100644
--- a/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling/Mods/EmptyScrollingModAutoplay.cs
+++ b/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling/Mods/EmptyScrollingModAutoplay.cs
@@ -11,6 +11,6 @@ namespace osu.Game.Rulesets.EmptyScrolling.Mods
     public class EmptyScrollingModAutoplay : ModAutoplay
     {
         public override ModReplayData CreateReplayData(IBeatmap beatmap, IReadOnlyList<Mod> mods)
-            => new ModReplayData(new EmptyScrollingAutoGenerator(beatmap).Generate(), new ModCreatedReplayUser { Username = "sample" });
+            => new ModReplayData(new EmptyScrollingAutoGenerator(beatmap).Generate(), new ModCreatedUser { Username = "sample" });
     }
 }
diff --git a/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon/Mods/PippidonModAutoplay.cs b/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon/Mods/PippidonModAutoplay.cs
index 6a24812ce8..f57b874ff3 100644
--- a/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon/Mods/PippidonModAutoplay.cs
+++ b/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon/Mods/PippidonModAutoplay.cs
@@ -11,6 +11,6 @@ namespace osu.Game.Rulesets.Pippidon.Mods
     public class PippidonModAutoplay : ModAutoplay
     {
         public override ModReplayData CreateReplayData(IBeatmap beatmap, IReadOnlyList<Mod> mods)
-            => new ModReplayData(new PippidonAutoGenerator(beatmap).Generate(), new ModCreatedReplayUser { Username = "sample" });
+            => new ModReplayData(new PippidonAutoGenerator(beatmap).Generate(), new ModCreatedUser { Username = "sample" });
     }
 }
diff --git a/osu.Game.Rulesets.Catch/Mods/CatchModAutoplay.cs b/osu.Game.Rulesets.Catch/Mods/CatchModAutoplay.cs
index 08deb8378a..50e48101d3 100644
--- a/osu.Game.Rulesets.Catch/Mods/CatchModAutoplay.cs
+++ b/osu.Game.Rulesets.Catch/Mods/CatchModAutoplay.cs
@@ -11,6 +11,6 @@ namespace osu.Game.Rulesets.Catch.Mods
     public class CatchModAutoplay : ModAutoplay
     {
         public override ModReplayData CreateReplayData(IBeatmap beatmap, IReadOnlyList<Mod> mods)
-            => new ModReplayData(new CatchAutoGenerator(beatmap).Generate(), new ModCreatedReplayUser { Username = "osu!salad" });
+            => new ModReplayData(new CatchAutoGenerator(beatmap).Generate(), new ModCreatedUser { Username = "osu!salad" });
     }
 }
diff --git a/osu.Game.Rulesets.Catch/Mods/CatchModCinema.cs b/osu.Game.Rulesets.Catch/Mods/CatchModCinema.cs
index d499348a09..7eda6b37d3 100644
--- a/osu.Game.Rulesets.Catch/Mods/CatchModCinema.cs
+++ b/osu.Game.Rulesets.Catch/Mods/CatchModCinema.cs
@@ -12,6 +12,6 @@ namespace osu.Game.Rulesets.Catch.Mods
     public class CatchModCinema : ModCinema<CatchHitObject>
     {
         public override ModReplayData CreateReplayData(IBeatmap beatmap, IReadOnlyList<Mod> mods)
-            => new ModReplayData(new CatchAutoGenerator(beatmap).Generate(), new ModCreatedReplayUser { Username = "osu!salad" });
+            => new ModReplayData(new CatchAutoGenerator(beatmap).Generate(), new ModCreatedUser { Username = "osu!salad" });
     }
 }
diff --git a/osu.Game.Rulesets.Mania/Mods/ManiaModAutoplay.cs b/osu.Game.Rulesets.Mania/Mods/ManiaModAutoplay.cs
index 9ea7852808..d444c9b634 100644
--- a/osu.Game.Rulesets.Mania/Mods/ManiaModAutoplay.cs
+++ b/osu.Game.Rulesets.Mania/Mods/ManiaModAutoplay.cs
@@ -12,6 +12,6 @@ namespace osu.Game.Rulesets.Mania.Mods
     public class ManiaModAutoplay : ModAutoplay
     {
         public override ModReplayData CreateReplayData(IBeatmap beatmap, IReadOnlyList<Mod> mods)
-            => new ModReplayData(new ManiaAutoGenerator((ManiaBeatmap)beatmap).Generate(), new ModCreatedReplayUser { Username = "osu!topus" });
+            => new ModReplayData(new ManiaAutoGenerator((ManiaBeatmap)beatmap).Generate(), new ModCreatedUser { Username = "osu!topus" });
     }
 }
diff --git a/osu.Game.Rulesets.Mania/Mods/ManiaModCinema.cs b/osu.Game.Rulesets.Mania/Mods/ManiaModCinema.cs
index a5d33261c5..f0db742eac 100644
--- a/osu.Game.Rulesets.Mania/Mods/ManiaModCinema.cs
+++ b/osu.Game.Rulesets.Mania/Mods/ManiaModCinema.cs
@@ -13,6 +13,6 @@ namespace osu.Game.Rulesets.Mania.Mods
     public class ManiaModCinema : ModCinema<ManiaHitObject>
     {
         public override ModReplayData CreateReplayData(IBeatmap beatmap, IReadOnlyList<Mod> mods)
-            => new ModReplayData(new ManiaAutoGenerator((ManiaBeatmap)beatmap).Generate(), new ModCreatedReplayUser { Username = "osu!topus" });
+            => new ModReplayData(new ManiaAutoGenerator((ManiaBeatmap)beatmap).Generate(), new ModCreatedUser { Username = "osu!topus" });
     }
 }
diff --git a/osu.Game.Rulesets.Osu.Tests/TestSceneMissHitWindowJudgements.cs b/osu.Game.Rulesets.Osu.Tests/TestSceneMissHitWindowJudgements.cs
index 124a519ab3..a9325f98f7 100644
--- a/osu.Game.Rulesets.Osu.Tests/TestSceneMissHitWindowJudgements.cs
+++ b/osu.Game.Rulesets.Osu.Tests/TestSceneMissHitWindowJudgements.cs
@@ -66,7 +66,7 @@ namespace osu.Game.Rulesets.Osu.Tests
         private class TestAutoMod : OsuModAutoplay
         {
             public override ModReplayData CreateReplayData(IBeatmap beatmap, IReadOnlyList<Mod> mods)
-                => new ModReplayData(new MissingAutoGenerator(beatmap, mods).Generate(), new ModCreatedReplayUser { Username = "Autoplay" });
+                => new ModReplayData(new MissingAutoGenerator(beatmap, mods).Generate(), new ModCreatedUser { Username = "Autoplay" });
         }
 
         private class MissingAutoGenerator : OsuAutoGeneratorBase
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModAutoplay.cs b/osu.Game.Rulesets.Osu/Mods/OsuModAutoplay.cs
index 51283e171b..31179cdf4a 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModAutoplay.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModAutoplay.cs
@@ -15,6 +15,6 @@ namespace osu.Game.Rulesets.Osu.Mods
         public override Type[] IncompatibleMods => base.IncompatibleMods.Concat(new[] { typeof(OsuModAimAssist), typeof(OsuModAutopilot), typeof(OsuModSpunOut) }).ToArray();
 
         public override ModReplayData CreateReplayData(IBeatmap beatmap, IReadOnlyList<Mod> mods)
-            => new ModReplayData(new OsuAutoGenerator(beatmap, mods).Generate(), new ModCreatedReplayUser { Username = "Autoplay" });
+            => new ModReplayData(new OsuAutoGenerator(beatmap, mods).Generate(), new ModCreatedUser { Username = "Autoplay" });
     }
 }
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModCinema.cs b/osu.Game.Rulesets.Osu/Mods/OsuModCinema.cs
index 6ecf8b73d2..d677ab43d0 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModCinema.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModCinema.cs
@@ -16,6 +16,6 @@ namespace osu.Game.Rulesets.Osu.Mods
         public override Type[] IncompatibleMods => base.IncompatibleMods.Concat(new[] { typeof(OsuModAimAssist), typeof(OsuModAutopilot), typeof(OsuModSpunOut) }).ToArray();
 
         public override ModReplayData CreateReplayData(IBeatmap beatmap, IReadOnlyList<Mod> mods)
-            => new ModReplayData(new OsuAutoGenerator(beatmap, mods).Generate(), new ModCreatedReplayUser { Username = "Autoplay" });
+            => new ModReplayData(new OsuAutoGenerator(beatmap, mods).Generate(), new ModCreatedUser { Username = "Autoplay" });
     }
 }
diff --git a/osu.Game.Rulesets.Taiko/Mods/TaikoModAutoplay.cs b/osu.Game.Rulesets.Taiko/Mods/TaikoModAutoplay.cs
index 1579a121b6..4b74b4991e 100644
--- a/osu.Game.Rulesets.Taiko/Mods/TaikoModAutoplay.cs
+++ b/osu.Game.Rulesets.Taiko/Mods/TaikoModAutoplay.cs
@@ -11,6 +11,6 @@ namespace osu.Game.Rulesets.Taiko.Mods
     public class TaikoModAutoplay : ModAutoplay
     {
         public override ModReplayData CreateReplayData(IBeatmap beatmap, IReadOnlyList<Mod> mods)
-            => new ModReplayData(new TaikoAutoGenerator(beatmap).Generate(), new ModCreatedReplayUser { Username = "mekkadosu!" });
+            => new ModReplayData(new TaikoAutoGenerator(beatmap).Generate(), new ModCreatedUser { Username = "mekkadosu!" });
     }
 }
diff --git a/osu.Game.Rulesets.Taiko/Mods/TaikoModCinema.cs b/osu.Game.Rulesets.Taiko/Mods/TaikoModCinema.cs
index 831e182193..fee0cb2744 100644
--- a/osu.Game.Rulesets.Taiko/Mods/TaikoModCinema.cs
+++ b/osu.Game.Rulesets.Taiko/Mods/TaikoModCinema.cs
@@ -12,6 +12,6 @@ namespace osu.Game.Rulesets.Taiko.Mods
     public class TaikoModCinema : ModCinema<TaikoHitObject>
     {
         public override ModReplayData CreateReplayData(IBeatmap beatmap, IReadOnlyList<Mod> mods)
-            => new ModReplayData(new TaikoAutoGenerator(beatmap).Generate(), new ModCreatedReplayUser { Username = "mekkadosu!" });
+            => new ModReplayData(new TaikoAutoGenerator(beatmap).Generate(), new ModCreatedUser { Username = "mekkadosu!" });
     }
 }
diff --git a/osu.Game/Rulesets/Mods/ICreateReplay.cs b/osu.Game/Rulesets/Mods/ICreateReplay.cs
index 4883ce5842..1e5eeca92c 100644
--- a/osu.Game/Rulesets/Mods/ICreateReplay.cs
+++ b/osu.Game/Rulesets/Mods/ICreateReplay.cs
@@ -16,7 +16,7 @@ namespace osu.Game.Rulesets.Mods
         ModReplayData ICreateReplayData.CreateReplayData(IBeatmap beatmap, IReadOnlyList<Mod> mods)
         {
             var replayScore = CreateReplayScore(beatmap, mods);
-            return new ModReplayData(replayScore.Replay, new ModCreatedReplayUser { Username = replayScore.ScoreInfo.User.Username });
+            return new ModReplayData(replayScore.Replay, new ModCreatedUser { Username = replayScore.ScoreInfo.User.Username });
         }
     }
 }
diff --git a/osu.Game/Rulesets/Mods/ICreateReplayData.cs b/osu.Game/Rulesets/Mods/ICreateReplayData.cs
index 2b8305ac78..7d208e9000 100644
--- a/osu.Game/Rulesets/Mods/ICreateReplayData.cs
+++ b/osu.Game/Rulesets/Mods/ICreateReplayData.cs
@@ -41,19 +41,19 @@ namespace osu.Game.Rulesets.Mods
         /// <summary>
         /// Placeholder user data to show in place of the local user when the associated mod is active.
         /// </summary>
-        public readonly ModCreatedReplayUser User;
+        public readonly ModCreatedUser User;
 
-        public ModReplayData(Replay replay, ModCreatedReplayUser user = null)
+        public ModReplayData(Replay replay, ModCreatedUser user = null)
         {
             Replay = replay;
-            User = user ?? new ModCreatedReplayUser();
+            User = user ?? new ModCreatedUser();
         }
     }
 
     /// <summary>
     /// A user which is associated with a replay that was created by a mod (ie. autoplay or cinema).
     /// </summary>
-    public class ModCreatedReplayUser : IUser
+    public class ModCreatedUser : IUser
     {
         public int OnlineID => APIUser.SYSTEM_USER_ID;
         public bool IsBot => true;
diff --git a/osu.Game/Rulesets/Mods/ModAutoplay.cs b/osu.Game/Rulesets/Mods/ModAutoplay.cs
index 7e54c170bf..7a68de49b3 100644
--- a/osu.Game/Rulesets/Mods/ModAutoplay.cs
+++ b/osu.Game/Rulesets/Mods/ModAutoplay.cs
@@ -40,7 +40,7 @@ namespace osu.Game.Rulesets.Mods
             var replayScore = CreateReplayScore(beatmap, mods);
 #pragma warning restore CS0618
 
-            return new ModReplayData(replayScore.Replay, new ModCreatedReplayUser { Username = replayScore.ScoreInfo.User.Username });
+            return new ModReplayData(replayScore.Replay, new ModCreatedUser { Username = replayScore.ScoreInfo.User.Username });
         }
     }
 }

From e0d434b89fc51a91301cc0bbb953b4457b8386cf Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 31 Mar 2022 11:34:32 +0900
Subject: [PATCH 3805/5547] Remove unused using statement

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

diff --git a/osu.Game/Rulesets/Mods/ModAutoplay.cs b/osu.Game/Rulesets/Mods/ModAutoplay.cs
index 7a68de49b3..87dc627b19 100644
--- a/osu.Game/Rulesets/Mods/ModAutoplay.cs
+++ b/osu.Game/Rulesets/Mods/ModAutoplay.cs
@@ -4,7 +4,6 @@
 using System;
 using System.Collections.Generic;
 using osu.Framework.Graphics.Sprites;
-using osu.Framework.Logging;
 using osu.Game.Beatmaps;
 using osu.Game.Graphics;
 using osu.Game.Replays;

From 6e94a9780bbe26d5a182fed29d7908f34c21baba Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 31 Mar 2022 12:22:56 +0900
Subject: [PATCH 3806/5547] Remove ScoreInfo allocations in multi leaderboard

---
 .../Play/HUD/MultiplayerGameplayLeaderboard.cs      | 13 +++++++------
 1 file changed, 7 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Screens/Play/HUD/MultiplayerGameplayLeaderboard.cs b/osu.Game/Screens/Play/HUD/MultiplayerGameplayLeaderboard.cs
index 71998622ef..4832ee04af 100644
--- a/osu.Game/Screens/Play/HUD/MultiplayerGameplayLeaderboard.cs
+++ b/osu.Game/Screens/Play/HUD/MultiplayerGameplayLeaderboard.cs
@@ -228,6 +228,7 @@ namespace osu.Game.Screens.Play.HUD
             public int? Team => (User.MatchState as TeamVersusUserState)?.TeamID;
 
             private readonly RulesetInfo ruleset;
+            private readonly ScoreInfo scoreInfo;
 
             public TrackedUserData(MultiplayerRoomUser user, RulesetInfo ruleset, ScoreProcessor scoreProcessor)
             {
@@ -236,6 +237,8 @@ namespace osu.Game.Screens.Play.HUD
                 User = user;
                 ScoreProcessor = scoreProcessor;
 
+                scoreInfo = new ScoreInfo { Ruleset = ruleset };
+
                 ScoringMode.BindValueChanged(_ => UpdateScore());
             }
 
@@ -253,12 +256,10 @@ namespace osu.Game.Screens.Play.HUD
             {
                 var header = frame.Header;
 
-                Score.Value = ScoreProcessor.ComputePartialScore(ScoringMode.Value, new ScoreInfo
-                {
-                    Ruleset = ruleset,
-                    MaxCombo = header.MaxCombo,
-                    Statistics = header.Statistics
-                });
+                scoreInfo.MaxCombo = header.MaxCombo;
+                scoreInfo.Statistics = header.Statistics;
+
+                Score.Value = ScoreProcessor.ComputePartialScore(ScoringMode.Value, scoreInfo);
 
                 Accuracy.Value = header.Accuracy;
                 CurrentCombo.Value = header.Combo;

From 9c19ae1df8061373e8a2f9481d17885def75d691 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 31 Mar 2022 06:40:38 +0300
Subject: [PATCH 3807/5547] Remove no longer necessary ruleset field

---
 osu.Game/Screens/Play/HUD/MultiplayerGameplayLeaderboard.cs | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/osu.Game/Screens/Play/HUD/MultiplayerGameplayLeaderboard.cs b/osu.Game/Screens/Play/HUD/MultiplayerGameplayLeaderboard.cs
index 4832ee04af..4f5edab526 100644
--- a/osu.Game/Screens/Play/HUD/MultiplayerGameplayLeaderboard.cs
+++ b/osu.Game/Screens/Play/HUD/MultiplayerGameplayLeaderboard.cs
@@ -227,13 +227,10 @@ namespace osu.Game.Screens.Play.HUD
 
             public int? Team => (User.MatchState as TeamVersusUserState)?.TeamID;
 
-            private readonly RulesetInfo ruleset;
             private readonly ScoreInfo scoreInfo;
 
             public TrackedUserData(MultiplayerRoomUser user, RulesetInfo ruleset, ScoreProcessor scoreProcessor)
             {
-                this.ruleset = ruleset;
-
                 User = user;
                 ScoreProcessor = scoreProcessor;
 

From 36c02573a8e137a5e24d622b6f50893eade5b740 Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Wed, 30 Mar 2022 21:26:30 -0700
Subject: [PATCH 3808/5547] Fix osu! logo being clicked when exiting via cmd-q
 on initial state

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

diff --git a/osu.Game/Screens/Menu/ButtonSystem.cs b/osu.Game/Screens/Menu/ButtonSystem.cs
index a1f0d22efc..8eeb90a3fd 100644
--- a/osu.Game/Screens/Menu/ButtonSystem.cs
+++ b/osu.Game/Screens/Menu/ButtonSystem.cs
@@ -207,6 +207,9 @@ namespace osu.Game.Screens.Menu
 
         protected override bool OnKeyDown(KeyDownEvent e)
         {
+            if (e.Repeat || e.ControlPressed || e.ShiftPressed || e.AltPressed || e.SuperPressed)
+                return false;
+
             if (State == ButtonSystemState.Initial)
             {
                 if (buttonsTopLevel.Any(b => e.Key == b.TriggerKey))

From 615e4f0f3b3c7a8872c27b70017a4ad385697780 Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Mon, 28 Mar 2022 15:16:37 -0700
Subject: [PATCH 3809/5547] Ignore line ending normalisation commit from blame

---
 .git-blame-ignore-revs | 2 ++
 1 file changed, 2 insertions(+)
 create mode 100644 .git-blame-ignore-revs

diff --git a/.git-blame-ignore-revs b/.git-blame-ignore-revs
new file mode 100644
index 0000000000..8be6479043
--- /dev/null
+++ b/.git-blame-ignore-revs
@@ -0,0 +1,2 @@
+# Normalize all the line endings
+32a74f95a5c80a0ed18e693f13a47522099df5c3

From 40b6f3ff0a1f21da5f2b98b7ed6398906e8500c0 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 31 Mar 2022 15:09:06 +0900
Subject: [PATCH 3810/5547] Rename method to CalculateAllLegacyCombinations()

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

diff --git a/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs b/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs
index 0935f26de6..b5aec0d659 100644
--- a/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs
+++ b/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs
@@ -121,10 +121,10 @@ namespace osu.Game.Rulesets.Difficulty
         /// Calculates the difficulty of the beatmap using all mod combinations applicable to the beatmap.
         /// </summary>
         /// <remarks>
-        /// This should only be used to compute difficulties for legacy mod combinations.
+        /// This can only be used to compute difficulties for legacy mod combinations.
         /// </remarks>
         /// <returns>A collection of structures describing the difficulty of the beatmap for each mod combination.</returns>
-        public IEnumerable<DifficultyAttributes> CalculateAll(CancellationToken cancellationToken = default)
+        public IEnumerable<DifficultyAttributes> CalculateAllLegacyCombinations(CancellationToken cancellationToken = default)
         {
             var rulesetInstance = ruleset.CreateInstance();
 

From e8a295a61bc548ca8878ea2ca92f6aa04ec20d9d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 31 Mar 2022 15:18:24 +0900
Subject: [PATCH 3811/5547] Add test coverage of textbox focus in settings
 panels when switching between nested panels

---
 .../Visual/Settings/TestSceneSettingsPanel.cs | 57 ++++++++++++++++++-
 osu.Game/Overlays/SettingsSubPanel.cs         |  2 +-
 2 files changed, 56 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Tests/Visual/Settings/TestSceneSettingsPanel.cs b/osu.Game.Tests/Visual/Settings/TestSceneSettingsPanel.cs
index 0af77b3b5a..f9c9b2a68b 100644
--- a/osu.Game.Tests/Visual/Settings/TestSceneSettingsPanel.cs
+++ b/osu.Game.Tests/Visual/Settings/TestSceneSettingsPanel.cs
@@ -1,16 +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.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Testing;
+using osu.Game.Graphics.UserInterface;
 using osu.Game.Overlays;
+using osu.Game.Overlays.Settings.Sections;
+using osu.Game.Overlays.Settings.Sections.Input;
+using osuTK.Input;
 
 namespace osu.Game.Tests.Visual.Settings
 {
     [TestFixture]
-    public class TestSceneSettingsPanel : OsuTestScene
+    public class TestSceneSettingsPanel : OsuManualInputManagerTestScene
     {
         private SettingsPanel settings;
         private DialogOverlay dialogOverlay;
@@ -33,7 +38,55 @@ namespace osu.Game.Tests.Visual.Settings
         public void ToggleVisibility()
         {
             AddWaitStep("wait some", 5);
-            AddToggleStep("toggle editor visibility", visible => settings.ToggleVisibility());
+            AddToggleStep("toggle visibility", visible => settings.ToggleVisibility());
+        }
+
+        [Test]
+        public void TestTextboxFocusAfterNestedPanelBackButton()
+        {
+            AddUntilStep("sections loaded", () => settings.SectionsContainer.Children.Count > 0);
+            AddUntilStep("top-level textbox focused", () => settings.SectionsContainer.ChildrenOfType<FocusedTextBox>().FirstOrDefault()?.HasFocus == true);
+
+            AddStep("open key binding subpanel", () =>
+            {
+                settings.SectionsContainer
+                        .ChildrenOfType<InputSection>().FirstOrDefault()?
+                        .ChildrenOfType<OsuButton>().FirstOrDefault()?
+                        .TriggerClick();
+            });
+
+            AddUntilStep("binding panel textbox focused", () => settings
+                                                                .ChildrenOfType<KeyBindingPanel>().FirstOrDefault()?
+                                                                .ChildrenOfType<FocusedTextBox>().FirstOrDefault()?.HasFocus == true);
+
+            AddStep("Press back", () => settings
+                                        .ChildrenOfType<KeyBindingPanel>().FirstOrDefault()?
+                                        .ChildrenOfType<SettingsSubPanel.BackButton>().FirstOrDefault()?.TriggerClick());
+
+            AddUntilStep("top-level textbox focused", () => settings.SectionsContainer.ChildrenOfType<FocusedTextBox>().FirstOrDefault()?.HasFocus == true);
+        }
+
+        [Test]
+        public void TestTextboxFocusAfterNestedPanelEscape()
+        {
+            AddUntilStep("sections loaded", () => settings.SectionsContainer.Children.Count > 0);
+            AddUntilStep("top-level textbox focused", () => settings.SectionsContainer.ChildrenOfType<FocusedTextBox>().FirstOrDefault()?.HasFocus == true);
+
+            AddStep("open key binding subpanel", () =>
+            {
+                settings.SectionsContainer
+                        .ChildrenOfType<InputSection>().FirstOrDefault()?
+                        .ChildrenOfType<OsuButton>().FirstOrDefault()?
+                        .TriggerClick();
+            });
+
+            AddUntilStep("binding panel textbox focused", () => settings
+                                                                .ChildrenOfType<KeyBindingPanel>().FirstOrDefault()?
+                                                                .ChildrenOfType<FocusedTextBox>().FirstOrDefault()?.HasFocus == true);
+
+            AddStep("Escape", () => InputManager.Key(Key.Escape));
+
+            AddUntilStep("top-level textbox focused", () => settings.SectionsContainer.ChildrenOfType<FocusedTextBox>().FirstOrDefault()?.HasFocus == true);
         }
 
         [BackgroundDependencyLoader]
diff --git a/osu.Game/Overlays/SettingsSubPanel.cs b/osu.Game/Overlays/SettingsSubPanel.cs
index da806c09d3..d55c609d3f 100644
--- a/osu.Game/Overlays/SettingsSubPanel.cs
+++ b/osu.Game/Overlays/SettingsSubPanel.cs
@@ -32,7 +32,7 @@ namespace osu.Game.Overlays
 
         protected override bool DimMainContent => false; // dimming is handled by main overlay
 
-        private class BackButton : SidebarButton
+        public class BackButton : SidebarButton
         {
             private Container content;
 

From 726b49fdf3e170d67a9d07e54de12e1df0c741f0 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 31 Mar 2022 15:19:34 +0900
Subject: [PATCH 3812/5547] Focus focus not being transferred correctly to
 parent settings panel on exiting nested panel

Seemingly harmless schedule delay ommission meant that the textbox may
not be in a state it can handle the incoming focus event. Regressed in
https://github.com/ppy/osu/pull/14345#discussion_r690697501.
---
 osu.Game/Graphics/UserInterface/FocusedTextBox.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Graphics/UserInterface/FocusedTextBox.cs b/osu.Game/Graphics/UserInterface/FocusedTextBox.cs
index 578ff3c618..d3a76a0f1a 100644
--- a/osu.Game/Graphics/UserInterface/FocusedTextBox.cs
+++ b/osu.Game/Graphics/UserInterface/FocusedTextBox.cs
@@ -28,7 +28,7 @@ namespace osu.Game.Graphics.UserInterface
             if (!allowImmediateFocus)
                 return;
 
-            Scheduler.Add(() => GetContainingInputManager().ChangeFocus(this), false);
+            Scheduler.Add(() => GetContainingInputManager().ChangeFocus(this));
         }
 
         public new void KillFocus() => base.KillFocus();

From ef5e37c47a1099c393238d53e8e80f9621c1b06a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 31 Mar 2022 16:18:26 +0900
Subject: [PATCH 3813/5547] Fix multiplayer sounds playing too much after
 gameplay

Regressed in https://github.com/ppy/osu/pull/15936.

Closes #17295.
---
 .../OnlinePlay/Multiplayer/MultiplayerRoomSounds.cs       | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerRoomSounds.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerRoomSounds.cs
index d467a32acb..49b5b7fed9 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerRoomSounds.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerRoomSounds.cs
@@ -37,21 +37,21 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
         {
             base.UserJoined(user);
 
-            userJoinedSample?.Play();
+            Scheduler.AddOnce(() => userJoinedSample?.Play());
         }
 
         protected override void UserLeft(MultiplayerRoomUser user)
         {
             base.UserLeft(user);
 
-            userLeftSample?.Play();
+            Scheduler.AddOnce(() => userLeftSample?.Play());
         }
 
         protected override void UserKicked(MultiplayerRoomUser user)
         {
             base.UserKicked(user);
 
-            userKickedSample?.Play();
+            Scheduler.AddOnce(() => userKickedSample?.Play());
         }
 
         private void hostChanged(ValueChangedEvent<APIUser> value)
@@ -59,7 +59,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
             // only play sound when the host changes from an already-existing host.
             if (value.OldValue == null) return;
 
-            hostChangedSample?.Play();
+            Scheduler.AddOnce(() => hostChangedSample?.Play());
         }
     }
 }

From a7a7584d3ec5077c98fa7c8bb02aa7beb5bda09e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 31 Mar 2022 18:31:18 +0900
Subject: [PATCH 3814/5547] Add test coverage ensuring ruleset ID is correct
 after bracket read

Historically, tournament client may have written incorrect `OnlineID`
values. We wanted to use `ShortName` to re-fetch the ruleset. This test
ensures this flow is working correctly.
---
 .../NonVisual/DataLoadTest.cs                 | 60 ++++++++++++++++++-
 osu.Game.Tournament/TournamentGameBase.cs     |  4 +-
 2 files changed, 60 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Tournament.Tests/NonVisual/DataLoadTest.cs b/osu.Game.Tournament.Tests/NonVisual/DataLoadTest.cs
index 65753bfe00..4c1256df2e 100644
--- a/osu.Game.Tournament.Tests/NonVisual/DataLoadTest.cs
+++ b/osu.Game.Tournament.Tests/NonVisual/DataLoadTest.cs
@@ -1,9 +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 System.IO;
+using System.Threading.Tasks;
 using NUnit.Framework;
 using osu.Framework.Allocation;
+using osu.Framework.Bindables;
+using osu.Framework.Extensions;
 using osu.Framework.Platform;
 using osu.Game.Rulesets;
 using osu.Game.Tests;
@@ -12,6 +16,45 @@ namespace osu.Game.Tournament.Tests.NonVisual
 {
     public class DataLoadTest : TournamentHostTest
     {
+        [Test]
+        public void TestRulesetGetsValidOnlineID()
+        {
+            using (HeadlessGameHost host = new CleanRunHeadlessGameHost())
+            {
+                try
+                {
+                    var osu = new TestTournament(runOnLoadComplete: () =>
+                    {
+                        // ReSharper disable once AccessToDisposedClosure
+                        var storage = host.Storage.GetStorageForDirectory(Path.Combine("tournaments", "default"));
+
+                        using (var stream = storage.GetStream("bracket.json", FileAccess.Write, FileMode.Create))
+                        using (var writer = new StreamWriter(stream))
+                        {
+                            writer.Write(@"{
+                        ""Ruleset"": {
+                            ""ShortName"": ""taiko"",
+                            ""OnlineID"": -1,
+                            ""Name"": ""osu!taiko"",
+                            ""InstantiationInfo"": ""osu.Game.Rulesets.OsuTaiko.TaikoRuleset, osu.Game.Rulesets.Taiko"",
+                            ""Available"": true
+                        } }");
+                        }
+                    });
+
+                    LoadTournament(host, osu);
+
+                    osu.BracketLoadTask.WaitSafely();
+
+                    Assert.That(osu.Dependencies.Get<IBindable<RulesetInfo>>().Value.OnlineID, Is.EqualTo(1));
+                }
+                finally
+                {
+                    host.Exit();
+                }
+            }
+        }
+
         [Test]
         public void TestUnavailableRuleset()
         {
@@ -19,7 +62,7 @@ namespace osu.Game.Tournament.Tests.NonVisual
             {
                 try
                 {
-                    var osu = new TestTournament();
+                    var osu = new TestTournament(true);
 
                     LoadTournament(host, osu);
                     var storage = osu.Dependencies.Get<Storage>();
@@ -35,10 +78,23 @@ namespace osu.Game.Tournament.Tests.NonVisual
 
         public class TestTournament : TournamentGameBase
         {
+            private readonly bool resetRuleset;
+            private readonly Action runOnLoadComplete;
+
+            public new Task BracketLoadTask => base.BracketLoadTask;
+
+            public TestTournament(bool resetRuleset = false, Action runOnLoadComplete = null)
+            {
+                this.resetRuleset = resetRuleset;
+                this.runOnLoadComplete = runOnLoadComplete;
+            }
+
             protected override void LoadComplete()
             {
+                runOnLoadComplete?.Invoke();
                 base.LoadComplete();
-                Ruleset.Value = new RulesetInfo(); // not available
+                if (resetRuleset)
+                    Ruleset.Value = new RulesetInfo(); // not available
             }
         }
     }
diff --git a/osu.Game.Tournament/TournamentGameBase.cs b/osu.Game.Tournament/TournamentGameBase.cs
index f318c8bd85..b88f4edaa6 100644
--- a/osu.Game.Tournament/TournamentGameBase.cs
+++ b/osu.Game.Tournament/TournamentGameBase.cs
@@ -64,8 +64,6 @@ namespace osu.Game.Tournament
             Textures.AddStore(new TextureLoaderStore(new StorageBackedResourceStore(storage)));
 
             dependencies.CacheAs(new StableInfo(storage));
-
-            Task.Run(readBracket);
         }
 
         private void readBracket()
@@ -290,6 +288,8 @@ namespace osu.Game.Tournament
             MenuCursorContainer.Cursor.Alpha = 0;
 
             base.LoadComplete();
+
+            Task.Run(readBracket);
         }
 
         protected virtual void SaveChanges()

From a06b0a49662c94b53c05d1c482d6457cf1c3bb98 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 31 Mar 2022 18:40:58 +0900
Subject: [PATCH 3815/5547] Fix tournament bracket parsing's ruleset refetch
 logic not working correctly

Due to equality being based on `ShortName`, it was feasible that the
re-fetch exited early (in bindable shortcutting logic) causing the
ruleset's `OnlineID` to remain `-1` or something equally wrong.

Resolves issue pointed out at
https://github.com/ppy/osu/discussions/17538#discussioncomment-2471746.
---
 osu.Game.Tournament/TournamentGameBase.cs | 30 +++++++++++++----------
 1 file changed, 17 insertions(+), 13 deletions(-)

diff --git a/osu.Game.Tournament/TournamentGameBase.cs b/osu.Game.Tournament/TournamentGameBase.cs
index b88f4edaa6..a251a043f7 100644
--- a/osu.Game.Tournament/TournamentGameBase.cs
+++ b/osu.Game.Tournament/TournamentGameBase.cs
@@ -66,6 +66,18 @@ namespace osu.Game.Tournament
             dependencies.CacheAs(new StableInfo(storage));
         }
 
+        protected override void LoadComplete()
+        {
+            MenuCursorContainer.Cursor.AlwaysPresent = true; // required for tooltip display
+
+            // we don't want to show the menu cursor as it would appear on stream output.
+            MenuCursorContainer.Cursor.Alpha = 0;
+
+            base.LoadComplete();
+
+            Task.Run(readBracket);
+        }
+
         private void readBracket()
         {
             try
@@ -79,10 +91,14 @@ namespace osu.Game.Tournament
 
                 ladder ??= new LadderInfo();
 
-                ladder.Ruleset.Value = ladder.Ruleset.Value != null
+                var resolvedRuleset = ladder.Ruleset.Value != null
                     ? RulesetStore.GetRuleset(ladder.Ruleset.Value.ShortName)
                     : RulesetStore.AvailableRulesets.First();
 
+                // Must set to null initially to avoid the following re-fetch hitting `ShortName` based equality check.
+                ladder.Ruleset.Value = null;
+                ladder.Ruleset.Value = resolvedRuleset;
+
                 bool addedInfo = false;
 
                 // assign teams
@@ -280,18 +296,6 @@ namespace osu.Game.Tournament
             }
         }
 
-        protected override void LoadComplete()
-        {
-            MenuCursorContainer.Cursor.AlwaysPresent = true; // required for tooltip display
-
-            // we don't want to show the menu cursor as it would appear on stream output.
-            MenuCursorContainer.Cursor.Alpha = 0;
-
-            base.LoadComplete();
-
-            Task.Run(readBracket);
-        }
-
         protected virtual void SaveChanges()
         {
             if (!bracketLoadTaskCompletionSource.Task.IsCompletedSuccessfully)

From 0a34ce2509d1df942034704a9baa057010b1af47 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 31 Mar 2022 19:07:17 +0900
Subject: [PATCH 3816/5547] Increase font weight for runtime clock

Fonts this small are required to be `SemiBold` by design guidelines.
Somehow missed this.
---
 osu.Game/Overlays/Toolbar/DigitalClockDisplay.cs | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/osu.Game/Overlays/Toolbar/DigitalClockDisplay.cs b/osu.Game/Overlays/Toolbar/DigitalClockDisplay.cs
index 090f8c4a0f..81a362450c 100644
--- a/osu.Game/Overlays/Toolbar/DigitalClockDisplay.cs
+++ b/osu.Game/Overlays/Toolbar/DigitalClockDisplay.cs
@@ -6,7 +6,6 @@ using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
-using osuTK;
 
 namespace osu.Game.Overlays.Toolbar
 {
@@ -42,7 +41,7 @@ namespace osu.Game.Overlays.Toolbar
                 {
                     Y = 14,
                     Colour = colours.PinkLight,
-                    Scale = new Vector2(0.6f)
+                    Font = OsuFont.Default.With(size: 10, weight: FontWeight.SemiBold),
                 }
             };
 

From 5b3eb2d6f443ea90322787f28033e77335648cbe Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 30 Mar 2022 23:54:00 +0900
Subject: [PATCH 3817/5547] Add helper class to handle firing async multiplayer
 methods

---
 .../MultiplayerClientExtensions.cs            | 43 +++++++++++++++++++
 1 file changed, 43 insertions(+)
 create mode 100644 osu.Game/Online/Multiplayer/MultiplayerClientExtensions.cs

diff --git a/osu.Game/Online/Multiplayer/MultiplayerClientExtensions.cs b/osu.Game/Online/Multiplayer/MultiplayerClientExtensions.cs
new file mode 100644
index 0000000000..98c593236a
--- /dev/null
+++ b/osu.Game/Online/Multiplayer/MultiplayerClientExtensions.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.
+
+#nullable enable
+using System;
+using System.Diagnostics;
+using System.Threading.Tasks;
+using Microsoft.AspNetCore.SignalR;
+using osu.Framework.Logging;
+
+namespace osu.Game.Online.Multiplayer
+{
+    public static class MultiplayerClientExtensions
+    {
+        public static void FireAndForget(this Task task, Action? onSuccess = null, Action<Exception>? onError = null) =>
+            task.ContinueWith(t =>
+            {
+                if (t.IsFaulted)
+                {
+                    Exception? exception = t.Exception;
+
+                    if (exception is AggregateException ae)
+                        exception = ae.InnerException;
+
+                    Debug.Assert(exception != null);
+
+                    string message = exception is HubException
+                        // HubExceptions arrive with additional message context added, but we want to display the human readable message:
+                        // "An unexpected error occurred invoking 'AddPlaylistItem' on the server.InvalidStateException: Can't enqueue more than 3 items at once."
+                        // We generally use the message field for a user-parseable error (eventually to be replaced), so drop the first part for now.
+                        ? exception.Message.Substring(exception.Message.IndexOf(':') + 1).Trim()
+                        : exception.Message;
+
+                    Logger.Log(message, level: LogLevel.Important);
+                    onError?.Invoke(exception);
+                }
+                else
+                {
+                    onSuccess?.Invoke();
+                }
+            });
+    }
+}

From e0c125a628c5848f01b4f8c9616c4cf75e6c2667 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 30 Mar 2022 23:57:19 +0900
Subject: [PATCH 3818/5547] Replace existing usage with helper method

---
 .../Multiplayer/MultiplayerMatchSongSelect.cs | 49 ++++++-------------
 1 file changed, 14 insertions(+), 35 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs
index d49c122bd1..2e8f625eba 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs
@@ -1,13 +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;
-using System.Diagnostics;
 using System.Linq;
 using System.Threading.Tasks;
-using Microsoft.AspNetCore.SignalR;
 using osu.Framework.Allocation;
-using osu.Framework.Logging;
 using osu.Framework.Screens;
 using osu.Game.Beatmaps;
 using osu.Game.Graphics.UserInterface;
@@ -76,40 +72,23 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
 
                 Task task = itemToEdit != null ? client.EditPlaylistItem(multiplayerItem) : client.AddPlaylistItem(multiplayerItem);
 
-                task.ContinueWith(t =>
+                task.FireAndForget(onSuccess: () => Schedule(() =>
                 {
-                    Schedule(() =>
-                    {
-                        // If an error or server side trigger occurred this screen may have already exited by external means.
-                        if (!this.IsCurrentScreen())
-                            return;
+                    // If an error or server side trigger occurred this screen may have already exited by external means.
+                    if (!this.IsCurrentScreen())
+                        return;
 
-                        loadingLayer.Hide();
+                    loadingLayer.Hide();
+                    this.Exit();
+                }), onError: _ => Schedule(() =>
+                {
+                    // If an error or server side trigger occurred this screen may have already exited by external means.
+                    if (!this.IsCurrentScreen())
+                        return;
 
-                        if (t.IsFaulted)
-                        {
-                            Exception exception = t.Exception;
-
-                            if (exception is AggregateException ae)
-                                exception = ae.InnerException;
-
-                            Debug.Assert(exception != null);
-
-                            string message = exception is HubException
-                                // HubExceptions arrive with additional message context added, but we want to display the human readable message:
-                                // "An unexpected error occurred invoking 'AddPlaylistItem' on the server.InvalidStateException: Can't enqueue more than 3 items at once."
-                                // We generally use the message field for a user-parseable error (eventually to be replaced), so drop the first part for now.
-                                ? exception.Message.Substring(exception.Message.IndexOf(':') + 1).Trim()
-                                : exception.Message;
-
-                            Logger.Log(message, level: LogLevel.Important);
-                            Carousel.AllowSelection = true;
-                            return;
-                        }
-
-                        this.Exit();
-                    });
-                });
+                    loadingLayer.Hide();
+                    Carousel.AllowSelection = true;
+                }));
             }
             else
             {

From 0b6db315111cdc4756c7eda240836f2a633a6d59 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 30 Mar 2022 23:58:30 +0900
Subject: [PATCH 3819/5547] Guard other multiplayer client calls with exception
 handling

---
 .../Multiplayer/Match/MatchStartControl.cs      | 17 ++++++++---------
 .../Match/Playlist/MultiplayerQueueList.cs      |  2 +-
 .../OnlinePlay/Multiplayer/Multiplayer.cs       |  2 +-
 .../Multiplayer/MultiplayerMatchSubScreen.cs    |  6 +++---
 .../Participants/ParticipantPanel.cs            |  6 +++---
 .../Multiplayer/Participants/TeamDisplay.cs     |  2 +-
 6 files changed, 17 insertions(+), 18 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MatchStartControl.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MatchStartControl.cs
index 1201279929..d048676872 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MatchStartControl.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MatchStartControl.cs
@@ -114,18 +114,17 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
 
             bool isReady() => Client.LocalUser?.State == MultiplayerUserState.Ready || Client.LocalUser?.State == MultiplayerUserState.Spectating;
 
-            void toggleReady() => Client.ToggleReady().ContinueWith(_ => endOperation());
+            void toggleReady() => Client.ToggleReady().FireAndForget(
+                onSuccess: endOperation,
+                onError: _ => endOperation());
 
-            void startMatch() => Client.StartMatch().ContinueWith(t =>
+            void startMatch() => Client.StartMatch().FireAndForget(onSuccess: () =>
             {
-                // accessing Exception here silences any potential errors from the antecedent task
-                if (t.Exception != null)
-                {
-                    // gameplay was not started due to an exception; unblock button.
-                    endOperation();
-                }
-
                 // gameplay is starting, the button will be unblocked on load requested.
+            }, onError: _ =>
+            {
+                // gameplay was not started due to an exception; unblock button.
+                endOperation();
             });
         }
 
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerQueueList.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerQueueList.cs
index 1653d416d8..d72ce5e960 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerQueueList.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerQueueList.cs
@@ -62,7 +62,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist
             {
                 base.LoadComplete();
 
-                RequestDeletion = item => multiplayerClient.RemovePlaylistItem(item.ID);
+                RequestDeletion = item => multiplayerClient.RemovePlaylistItem(item.ID).FireAndForget();
 
                 multiplayerClient.RoomUpdated += onRoomUpdated;
                 onRoomUpdated();
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Multiplayer.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Multiplayer.cs
index 28c9bef3f0..2482d52492 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Multiplayer.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Multiplayer.cs
@@ -48,7 +48,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
             // If gameplay wasn't finished, then we have a simple path back to the idle state by aborting gameplay.
             if (!playerLoader.GameplayPassed)
             {
-                client.AbortGameplay();
+                client.AbortGameplay().FireAndForget();
                 return;
             }
 
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
index e53153e017..7ef0bb5923 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
@@ -281,7 +281,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
             if (client.Room == null)
                 return;
 
-            client.ChangeUserMods(mods.NewValue);
+            client.ChangeUserMods(mods.NewValue).FireAndForget();
 
             modSettingChangeTracker = new ModSettingChangeTracker(mods.NewValue);
             modSettingChangeTracker.SettingChanged += onModSettingsChanged;
@@ -296,7 +296,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
                 if (client.Room == null)
                     return;
 
-                client.ChangeUserMods(UserMods.Value);
+                client.ChangeUserMods(UserMods.Value).FireAndForget();
             }, 500);
         }
 
@@ -305,7 +305,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
             if (client.Room == null)
                 return;
 
-            client.ChangeBeatmapAvailability(availability.NewValue);
+            client.ChangeBeatmapAvailability(availability.NewValue).FireAndForget();
 
             if (availability.NewValue.State != DownloadState.LocallyAvailable)
             {
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantPanel.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantPanel.cs
index 7ba0a63856..e091559046 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantPanel.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantPanel.cs
@@ -169,7 +169,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Participants
                             Origin = Anchor.Centre,
                             Alpha = 0,
                             Margin = new MarginPadding(4),
-                            Action = () => Client.KickUser(User.UserID),
+                            Action = () => Client.KickUser(User.UserID).FireAndForget(),
                         },
                     },
                 }
@@ -231,7 +231,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Participants
                         if (!Client.IsHost)
                             return;
 
-                        Client.TransferHost(targetUser);
+                        Client.TransferHost(targetUser).FireAndForget();
                     }),
                     new OsuMenuItem("Kick", MenuItemType.Destructive, () =>
                     {
@@ -239,7 +239,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Participants
                         if (!Client.IsHost)
                             return;
 
-                        Client.KickUser(targetUser);
+                        Client.KickUser(targetUser).FireAndForget();
                     })
                 };
             }
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/TeamDisplay.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/TeamDisplay.cs
index 73aca0acdc..aca2c6073a 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/TeamDisplay.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/TeamDisplay.cs
@@ -83,7 +83,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Participants
             Client.SendMatchRequest(new ChangeTeamRequest
             {
                 TeamID = ((Client.LocalUser?.MatchState as TeamVersusUserState)?.TeamID + 1) % 2 ?? 0,
-            });
+            }).FireAndForget();
         }
 
         public int? DisplayedTeam { get; private set; }

From f1aa60c0f1c2fec417db5bc05d8d6dd2eb3dd391 Mon Sep 17 00:00:00 2001
From: CenTdemeern1 <timo.herngreen@gmail.com>
Date: Thu, 31 Mar 2022 16:26:53 +0200
Subject: [PATCH 3820/5547] Make the clock feel more like a button

---
 osu.Game/Overlays/Toolbar/ToolbarClock.cs | 92 +++++++++++++++++------
 1 file changed, 68 insertions(+), 24 deletions(-)

diff --git a/osu.Game/Overlays/Toolbar/ToolbarClock.cs b/osu.Game/Overlays/Toolbar/ToolbarClock.cs
index ad5c9ac7a1..02230c13cf 100644
--- a/osu.Game/Overlays/Toolbar/ToolbarClock.cs
+++ b/osu.Game/Overlays/Toolbar/ToolbarClock.cs
@@ -3,54 +3,83 @@
 
 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.Shapes;
 using osu.Framework.Input.Events;
 using osu.Game.Configuration;
+using osu.Game.Graphics;
+using osu.Game.Graphics.Containers;
+using osu.Game.Graphics.UserInterface;
 using osuTK;
+using osuTK.Graphics;
+
 
 namespace osu.Game.Overlays.Toolbar
 {
-    public class ToolbarClock : CompositeDrawable
+    public class ToolbarClock : OsuClickableContainer
     {
         private Bindable<ToolbarClockDisplayMode> clockDisplayMode;
 
+        protected Box HoverBackground;
+        private readonly Box flashBackground;
+        private readonly FillFlowContainer clockContainer;
+
         private DigitalClockDisplay digital;
         private AnalogClockDisplay analog;
 
         public ToolbarClock()
+            : base(HoverSampleSet.Toolbar)
         {
             RelativeSizeAxes = Axes.Y;
             AutoSizeAxes = Axes.X;
 
-            Padding = new MarginPadding(10);
+            Children = new Drawable[]
+            {
+                HoverBackground = new Box
+                {
+                    RelativeSizeAxes = Axes.Both,
+                    Colour = OsuColour.Gray(80).Opacity(180),
+                    Blending = BlendingParameters.Additive,
+                    Alpha = 0,
+                },
+                flashBackground = new Box
+                {
+                    RelativeSizeAxes = Axes.Both,
+                    Alpha = 0,
+                    Colour = Color4.White.Opacity(100),
+                    Blending = BlendingParameters.Additive,
+                },
+
+                clockContainer = new FillFlowContainer
+                {
+                    RelativeSizeAxes = Axes.Y,
+                    AutoSizeAxes = Axes.X,
+                    Direction = FillDirection.Horizontal,
+                    Spacing = new Vector2(5),
+                    Padding = new MarginPadding(10),
+                    Children = new Drawable[]
+                    {
+                        analog = new AnalogClockDisplay
+                        {
+                            Anchor = Anchor.CentreLeft,
+                            Origin = Anchor.CentreLeft,
+                        },
+                        digital = new DigitalClockDisplay
+                        {
+                            Anchor = Anchor.CentreLeft,
+                            Origin = Anchor.CentreLeft,
+                        }
+                    }
+                }
+            };
         }
 
         [BackgroundDependencyLoader]
         private void load(OsuConfigManager config)
         {
             clockDisplayMode = config.GetBindable<ToolbarClockDisplayMode>(OsuSetting.ToolbarClockDisplayMode);
-
-            InternalChild = new FillFlowContainer
-            {
-                RelativeSizeAxes = Axes.Y,
-                AutoSizeAxes = Axes.X,
-                Direction = FillDirection.Horizontal,
-                Spacing = new Vector2(5),
-                Children = new Drawable[]
-                {
-                    analog = new AnalogClockDisplay
-                    {
-                        Anchor = Anchor.CentreLeft,
-                        Origin = Anchor.CentreLeft,
-                    },
-                    digital = new DigitalClockDisplay
-                    {
-                        Anchor = Anchor.CentreLeft,
-                        Origin = Anchor.CentreLeft,
-                    }
-                }
-            };
         }
 
         protected override void LoadComplete()
@@ -72,8 +101,23 @@ namespace osu.Game.Overlays.Toolbar
 
         protected override bool OnClick(ClickEvent e)
         {
+            flashBackground.FadeOutFromOne(800, Easing.OutQuint);
+
             cycleDisplayMode();
-            return true;
+
+            return base.OnClick(e);
+        }
+
+        protected override bool OnHover(HoverEvent e)
+        {
+            HoverBackground.FadeIn(200);
+
+            return base.OnHover(e);
+        }
+
+        protected override void OnHoverLost(HoverLostEvent e)
+        {
+            HoverBackground.FadeOut(200);
         }
 
         private void cycleDisplayMode()

From c64a90b39e86a38b7ce5a54ff950ee8f7b986321 Mon Sep 17 00:00:00 2001
From: CenTdemeern1 <timo.herngreen@gmail.com>
Date: Thu, 31 Mar 2022 17:21:50 +0200
Subject: [PATCH 3821/5547] Remove a newline to comply with codefactor

---
 osu.Game/Overlays/Toolbar/ToolbarClock.cs | 1 -
 1 file changed, 1 deletion(-)

diff --git a/osu.Game/Overlays/Toolbar/ToolbarClock.cs b/osu.Game/Overlays/Toolbar/ToolbarClock.cs
index 02230c13cf..48de803b3a 100644
--- a/osu.Game/Overlays/Toolbar/ToolbarClock.cs
+++ b/osu.Game/Overlays/Toolbar/ToolbarClock.cs
@@ -15,7 +15,6 @@ using osu.Game.Graphics.UserInterface;
 using osuTK;
 using osuTK.Graphics;
 
-
 namespace osu.Game.Overlays.Toolbar
 {
     public class ToolbarClock : OsuClickableContainer

From 52d723aaa6ee71876054fcb240f8f2bcc182338a Mon Sep 17 00:00:00 2001
From: CenTdemeern1 <timo.herngreen@gmail.com>
Date: Thu, 31 Mar 2022 20:11:07 +0200
Subject: [PATCH 3822/5547] Remove BPM slider

---
 osu.Game/Screens/Edit/Timing/TimingSection.cs | 50 -------------------
 1 file changed, 50 deletions(-)

diff --git a/osu.Game/Screens/Edit/Timing/TimingSection.cs b/osu.Game/Screens/Edit/Timing/TimingSection.cs
index cd0b56d338..f3c468de4c 100644
--- a/osu.Game/Screens/Edit/Timing/TimingSection.cs
+++ b/osu.Game/Screens/Edit/Timing/TimingSection.cs
@@ -13,7 +13,6 @@ namespace osu.Game.Screens.Edit.Timing
 {
     internal class TimingSection : Section<TimingControlPoint>
     {
-        private SettingsSlider<double> bpmSlider;
         private LabelledTimeSignature timeSignature;
         private BPMTextBox bpmTextEntry;
 
@@ -23,7 +22,6 @@ namespace osu.Game.Screens.Edit.Timing
             Flow.AddRange(new Drawable[]
             {
                 bpmTextEntry = new BPMTextBox(),
-                bpmSlider = new BPMSlider(),
                 timeSignature = new LabelledTimeSignature
                 {
                     Label = "Time Signature"
@@ -35,9 +33,6 @@ namespace osu.Game.Screens.Edit.Timing
         {
             if (point.NewValue != null)
             {
-                bpmSlider.Current = point.NewValue.BeatLengthBindable;
-                bpmSlider.Current.BindValueChanged(_ => ChangeHandler?.SaveState());
-
                 bpmTextEntry.Bindable = point.NewValue.BeatLengthBindable;
                 // no need to hook change handler here as it's the same bindable as above
 
@@ -102,51 +97,6 @@ namespace osu.Game.Screens.Edit.Timing
             }
         }
 
-        private class BPMSlider : SettingsSlider<double>
-        {
-            private const double sane_minimum = 60;
-            private const double sane_maximum = 240;
-
-            private readonly BindableNumber<double> beatLengthBindable = new TimingControlPoint().BeatLengthBindable;
-
-            private readonly BindableDouble bpmBindable = new BindableDouble(60000 / TimingControlPoint.DEFAULT_BEAT_LENGTH)
-            {
-                MinValue = sane_minimum,
-                MaxValue = sane_maximum,
-            };
-
-            public BPMSlider()
-            {
-                beatLengthBindable.BindValueChanged(beatLength => updateCurrent(beatLengthToBpm(beatLength.NewValue)), true);
-                bpmBindable.BindValueChanged(bpm => beatLengthBindable.Value = beatLengthToBpm(bpm.NewValue));
-
-                base.Current = bpmBindable;
-
-                TransferValueOnCommit = true;
-            }
-
-            public override Bindable<double> Current
-            {
-                get => base.Current;
-                set
-                {
-                    // incoming will be beat length, not bpm
-                    beatLengthBindable.UnbindBindings();
-                    beatLengthBindable.BindTo(value);
-                }
-            }
-
-            private void updateCurrent(double newValue)
-            {
-                // we use a more sane range for the slider display unless overridden by the user.
-                // if a value comes in outside our range, we should expand temporarily.
-                bpmBindable.MinValue = Math.Min(newValue, sane_minimum);
-                bpmBindable.MaxValue = Math.Max(newValue, sane_maximum);
-
-                bpmBindable.Value = newValue;
-            }
-        }
-
         private static double beatLengthToBpm(double beatLength) => 60000 / beatLength;
     }
 }

From bdb21b17f721ab0a9b9f302439cd62033eafae14 Mon Sep 17 00:00:00 2001
From: CenTdemeern1 <timo.herngreen@gmail.com>
Date: Thu, 31 Mar 2022 20:39:26 +0200
Subject: [PATCH 3823/5547] Fix my code according to the changes @bdach
 requested

---
 osu.Game/Overlays/Toolbar/ToolbarClock.cs | 28 +++++++++++------------
 1 file changed, 14 insertions(+), 14 deletions(-)

diff --git a/osu.Game/Overlays/Toolbar/ToolbarClock.cs b/osu.Game/Overlays/Toolbar/ToolbarClock.cs
index 48de803b3a..22a96603dc 100644
--- a/osu.Game/Overlays/Toolbar/ToolbarClock.cs
+++ b/osu.Game/Overlays/Toolbar/ToolbarClock.cs
@@ -21,9 +21,8 @@ namespace osu.Game.Overlays.Toolbar
     {
         private Bindable<ToolbarClockDisplayMode> clockDisplayMode;
 
-        protected Box HoverBackground;
-        private readonly Box flashBackground;
-        private readonly FillFlowContainer clockContainer;
+        private Box hoverBackground;
+        private Box flashBackground;
 
         private DigitalClockDisplay digital;
         private AnalogClockDisplay analog;
@@ -33,10 +32,16 @@ namespace osu.Game.Overlays.Toolbar
         {
             RelativeSizeAxes = Axes.Y;
             AutoSizeAxes = Axes.X;
+        }
+
+        [BackgroundDependencyLoader]
+        private void load(OsuConfigManager config)
+        {
+            clockDisplayMode = config.GetBindable<ToolbarClockDisplayMode>(OsuSetting.ToolbarClockDisplayMode);
 
             Children = new Drawable[]
             {
-                HoverBackground = new Box
+                hoverBackground = new Box
                 {
                     RelativeSizeAxes = Axes.Both,
                     Colour = OsuColour.Gray(80).Opacity(180),
@@ -50,8 +55,7 @@ namespace osu.Game.Overlays.Toolbar
                     Colour = Color4.White.Opacity(100),
                     Blending = BlendingParameters.Additive,
                 },
-
-                clockContainer = new FillFlowContainer
+                new FillFlowContainer
                 {
                     RelativeSizeAxes = Axes.Y,
                     AutoSizeAxes = Axes.X,
@@ -75,12 +79,6 @@ namespace osu.Game.Overlays.Toolbar
             };
         }
 
-        [BackgroundDependencyLoader]
-        private void load(OsuConfigManager config)
-        {
-            clockDisplayMode = config.GetBindable<ToolbarClockDisplayMode>(OsuSetting.ToolbarClockDisplayMode);
-        }
-
         protected override void LoadComplete()
         {
             base.LoadComplete();
@@ -109,14 +107,16 @@ namespace osu.Game.Overlays.Toolbar
 
         protected override bool OnHover(HoverEvent e)
         {
-            HoverBackground.FadeIn(200);
+            hoverBackground.FadeIn(200);
 
             return base.OnHover(e);
         }
 
         protected override void OnHoverLost(HoverLostEvent e)
         {
-            HoverBackground.FadeOut(200);
+            hoverBackground.FadeOut(200);
+
+            base.OnHoverLost(e);
         }
 
         private void cycleDisplayMode()

From a6875383fcd5da6d50304bc40a660f35112e3f3f Mon Sep 17 00:00:00 2001
From: CenTdemeern1 <timo.herngreen@gmail.com>
Date: Thu, 31 Mar 2022 21:06:05 +0200
Subject: [PATCH 3824/5547] Rebind `SaveState()` to bpmTextEntry

---
 osu.Game/Screens/Edit/Timing/TimingSection.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Edit/Timing/TimingSection.cs b/osu.Game/Screens/Edit/Timing/TimingSection.cs
index f3c468de4c..07f8f2ba3a 100644
--- a/osu.Game/Screens/Edit/Timing/TimingSection.cs
+++ b/osu.Game/Screens/Edit/Timing/TimingSection.cs
@@ -34,7 +34,7 @@ namespace osu.Game.Screens.Edit.Timing
             if (point.NewValue != null)
             {
                 bpmTextEntry.Bindable = point.NewValue.BeatLengthBindable;
-                // no need to hook change handler here as it's the same bindable as above
+                bpmTextEntry.Current.BindValueChanged(_ => ChangeHandler?.SaveState());
 
                 timeSignature.Current = point.NewValue.TimeSignatureBindable;
                 timeSignature.Current.BindValueChanged(_ => ChangeHandler?.SaveState());

From e14d5b8adbc26bff6b9f9f184a9a9444ba18bb8d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 31 Mar 2022 21:20:30 +0200
Subject: [PATCH 3825/5547] Remove unused using directives

---
 osu.Game/Screens/Edit/Timing/TimingSection.cs | 2 --
 1 file changed, 2 deletions(-)

diff --git a/osu.Game/Screens/Edit/Timing/TimingSection.cs b/osu.Game/Screens/Edit/Timing/TimingSection.cs
index 07f8f2ba3a..13af04cd4b 100644
--- a/osu.Game/Screens/Edit/Timing/TimingSection.cs
+++ b/osu.Game/Screens/Edit/Timing/TimingSection.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.Bindables;
 using osu.Framework.Graphics;
 using osu.Game.Beatmaps.ControlPoints;
 using osu.Game.Graphics.UserInterfaceV2;
-using osu.Game.Overlays.Settings;
 
 namespace osu.Game.Screens.Edit.Timing
 {

From b3896257ca0721e50ce5e21f8572ade3da40dccc Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 31 Mar 2022 22:09:03 +0200
Subject: [PATCH 3826/5547] Move shear amount to constant

---
 .../Visual/UserInterface/TestSceneShearedToggleButton.cs      | 4 ++--
 osu.Game/Graphics/UserInterface/ShearedToggleButton.cs        | 4 +++-
 2 files changed, 5 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneShearedToggleButton.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneShearedToggleButton.cs
index a969858157..5082e93f37 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneShearedToggleButton.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneShearedToggleButton.cs
@@ -23,7 +23,7 @@ namespace osu.Game.Tests.Visual.UserInterface
 
             AddStep("create button", () =>
             {
-                Child = button = new ShearedToggleButton(0.2f)
+                Child = button = new ShearedToggleButton
                 {
                     Anchor = Anchor.Centre,
                     Origin = Anchor.Centre,
@@ -43,7 +43,7 @@ namespace osu.Game.Tests.Visual.UserInterface
 
             AddStep("create button", () =>
             {
-                Child = button = new ShearedToggleButton(0.2f)
+                Child = button = new ShearedToggleButton
                 {
                     Anchor = Anchor.Centre,
                     Origin = Anchor.Centre,
diff --git a/osu.Game/Graphics/UserInterface/ShearedToggleButton.cs b/osu.Game/Graphics/UserInterface/ShearedToggleButton.cs
index acbed29279..27d2611983 100644
--- a/osu.Game/Graphics/UserInterface/ShearedToggleButton.cs
+++ b/osu.Game/Graphics/UserInterface/ShearedToggleButton.cs
@@ -37,10 +37,12 @@ namespace osu.Game.Graphics.UserInterface
         private Sample? sampleOff;
         private Sample? sampleOn;
 
+        private const float shear = 0.2f;
+
         [Resolved]
         private OverlayColourProvider colourProvider { get; set; } = null!;
 
-        public ShearedToggleButton(float shear)
+        public ShearedToggleButton()
         {
             Height = 50;
             Padding = new MarginPadding { Horizontal = shear * 50 };

From e180db145dcee071d8e559345a1bdb25f66856ec Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 31 Mar 2022 22:19:08 +0200
Subject: [PATCH 3827/5547] Add constructor argument to facilitate fixed
 width/autosizing

---
 .../TestSceneShearedToggleButton.cs           | 25 +++++++++++++++++--
 .../UserInterface/ShearedToggleButton.cs      | 22 +++++++++++++++-
 2 files changed, 44 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneShearedToggleButton.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneShearedToggleButton.cs
index 5082e93f37..f12cbc4979 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneShearedToggleButton.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneShearedToggleButton.cs
@@ -23,12 +23,11 @@ namespace osu.Game.Tests.Visual.UserInterface
 
             AddStep("create button", () =>
             {
-                Child = button = new ShearedToggleButton
+                Child = button = new ShearedToggleButton(200)
                 {
                     Anchor = Anchor.Centre,
                     Origin = Anchor.Centre,
                     Text = "Toggle me",
-                    Width = 200
                 };
             });
 
@@ -36,6 +35,28 @@ namespace osu.Game.Tests.Visual.UserInterface
             AddToggleStep("toggle disabled", disabled => button.Active.Disabled = disabled);
         }
 
+        [Test]
+        public void TestSizing()
+        {
+            ShearedToggleButton toggleButton = null;
+
+            AddStep("create fixed width button", () => Child = toggleButton = new ShearedToggleButton(200)
+            {
+                Anchor = Anchor.Centre,
+                Origin = Anchor.Centre,
+                Text = "Fixed width"
+            });
+            AddStep("change text", () => toggleButton.Text = "New text");
+
+            AddStep("create auto-sizing button", () => Child = toggleButton = new ShearedToggleButton
+            {
+                Anchor = Anchor.Centre,
+                Origin = Anchor.Centre,
+                Text = "This button autosizes to its text!"
+            });
+            AddStep("change text", () => toggleButton.Text = "New text");
+        }
+
         [Test]
         public void TestDisabledState()
         {
diff --git a/osu.Game/Graphics/UserInterface/ShearedToggleButton.cs b/osu.Game/Graphics/UserInterface/ShearedToggleButton.cs
index 27d2611983..aed3be20a0 100644
--- a/osu.Game/Graphics/UserInterface/ShearedToggleButton.cs
+++ b/osu.Game/Graphics/UserInterface/ShearedToggleButton.cs
@@ -42,7 +42,17 @@ namespace osu.Game.Graphics.UserInterface
         [Resolved]
         private OverlayColourProvider colourProvider { get; set; } = null!;
 
-        public ShearedToggleButton()
+        /// <summary>
+        /// Creates a new <see cref="ShearedToggleButton"/>
+        /// </summary>
+        /// <param name="width">
+        /// The width of the button.
+        /// <list type="bullet">
+        /// <item>If a non-<see langword="null"/> value is provided, this button will have a fixed width equal to the provided value.</item>
+        /// <item>If a <see langword="null"/> value is provided (or the argument is omitted entirely), the button will autosize in width to fit the text.</item>
+        /// </list>
+        /// </param>
+        public ShearedToggleButton(float? width = null)
         {
             Height = 50;
             Padding = new MarginPadding { Horizontal = shear * 50 };
@@ -67,6 +77,16 @@ namespace osu.Game.Graphics.UserInterface
                     Shear = new Vector2(-shear, 0)
                 }
             };
+
+            if (width != null)
+            {
+                Width = width.Value;
+            }
+            else
+            {
+                AutoSizeAxes = Axes.X;
+                text.Margin = new MarginPadding { Horizontal = 15 };
+            }
         }
 
         [BackgroundDependencyLoader]

From 058350dfd8bf7c7754ccc25bb20357185a750817 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 1 Apr 2022 10:53:14 +0900
Subject: [PATCH 3828/5547] Fix failing test due to incorrect sizing
 specification

---
 .../Visual/UserInterface/TestSceneShearedToggleButton.cs       | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneShearedToggleButton.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneShearedToggleButton.cs
index f12cbc4979..b5109aa58d 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneShearedToggleButton.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneShearedToggleButton.cs
@@ -64,12 +64,11 @@ namespace osu.Game.Tests.Visual.UserInterface
 
             AddStep("create button", () =>
             {
-                Child = button = new ShearedToggleButton
+                Child = button = new ShearedToggleButton(200)
                 {
                     Anchor = Anchor.Centre,
                     Origin = Anchor.Centre,
                     Text = "Toggle me",
-                    Width = 200
                 };
             });
 

From d0873d67e1569b1345113d34407bc0878bbf718c Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Sun, 20 Mar 2022 13:36:18 -0700
Subject: [PATCH 3829/5547] Move difficulty graph toggle to individual skin
 settings

---
 osu.Game/Configuration/OsuConfigManager.cs                 | 2 --
 osu.Game/Localisation/GameplaySettingsStrings.cs           | 5 -----
 .../Overlays/Settings/Sections/Gameplay/HUDSettings.cs     | 5 -----
 osu.Game/Screens/Play/SongProgress.cs                      | 7 +++----
 4 files changed, 3 insertions(+), 16 deletions(-)

diff --git a/osu.Game/Configuration/OsuConfigManager.cs b/osu.Game/Configuration/OsuConfigManager.cs
index e8f13ba902..1b10456c8e 100644
--- a/osu.Game/Configuration/OsuConfigManager.cs
+++ b/osu.Game/Configuration/OsuConfigManager.cs
@@ -109,7 +109,6 @@ namespace osu.Game.Configuration
             SetDefault(OsuSetting.HitLighting, true);
 
             SetDefault(OsuSetting.HUDVisibilityMode, HUDVisibilityMode.Always);
-            SetDefault(OsuSetting.ShowProgressGraph, true);
             SetDefault(OsuSetting.ShowHealthDisplayWhenCantFail, true);
             SetDefault(OsuSetting.FadePlayfieldWhenHealthLow, true);
             SetDefault(OsuSetting.KeyOverlay, false);
@@ -266,7 +265,6 @@ namespace osu.Game.Configuration
         AlwaysPlayFirstComboBreak,
         FloatingComments,
         HUDVisibilityMode,
-        ShowProgressGraph,
         ShowHealthDisplayWhenCantFail,
         FadePlayfieldWhenHealthLow,
         MouseDisableButtons,
diff --git a/osu.Game/Localisation/GameplaySettingsStrings.cs b/osu.Game/Localisation/GameplaySettingsStrings.cs
index 84c3704e26..8a0f773551 100644
--- a/osu.Game/Localisation/GameplaySettingsStrings.cs
+++ b/osu.Game/Localisation/GameplaySettingsStrings.cs
@@ -64,11 +64,6 @@ namespace osu.Game.Localisation
         /// </summary>
         public static LocalisableString HUDVisibilityMode => new TranslatableString(getKey(@"hud_visibility_mode"), @"HUD overlay visibility mode");
 
-        /// <summary>
-        /// "Show difficulty graph on progress bar"
-        /// </summary>
-        public static LocalisableString ShowDifficultyGraph => new TranslatableString(getKey(@"show_difficulty_graph"), @"Show difficulty graph on progress bar");
-
         /// <summary>
         /// "Show health display even when you can't fail"
         /// </summary>
diff --git a/osu.Game/Overlays/Settings/Sections/Gameplay/HUDSettings.cs b/osu.Game/Overlays/Settings/Sections/Gameplay/HUDSettings.cs
index ba9779d650..e30df6b868 100644
--- a/osu.Game/Overlays/Settings/Sections/Gameplay/HUDSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Gameplay/HUDSettings.cs
@@ -24,11 +24,6 @@ namespace osu.Game.Overlays.Settings.Sections.Gameplay
                     Current = config.GetBindable<HUDVisibilityMode>(OsuSetting.HUDVisibilityMode)
                 },
                 new SettingsCheckbox
-                {
-                    LabelText = GameplaySettingsStrings.ShowDifficultyGraph,
-                    Current = config.GetBindable<bool>(OsuSetting.ShowProgressGraph)
-                },
-                new SettingsCheckbox
                 {
                     LabelText = GameplaySettingsStrings.ShowHealthDisplayWhenCantFail,
                     Current = config.GetBindable<bool>(OsuSetting.ShowHealthDisplayWhenCantFail),
diff --git a/osu.Game/Screens/Play/SongProgress.cs b/osu.Game/Screens/Play/SongProgress.cs
index e620abb90f..9470c60fe6 100644
--- a/osu.Game/Screens/Play/SongProgress.cs
+++ b/osu.Game/Screens/Play/SongProgress.cs
@@ -42,7 +42,8 @@ namespace osu.Game.Screens.Play
         /// </summary>
         public readonly Bindable<bool> AllowSeeking = new Bindable<bool>();
 
-        public readonly Bindable<bool> ShowGraph = new Bindable<bool>();
+        [SettingSource("Show difficulty graph", "Whether a graph should show difficulty throughout the beatmap")]
+        public Bindable<bool> ShowGraph { get; } = new BindableBool(true);
 
         public override bool HandleNonPositionalInput => AllowSeeking.Value;
         public override bool HandlePositionalInput => AllowSeeking.Value;
@@ -116,7 +117,7 @@ namespace osu.Game.Screens.Play
         }
 
         [BackgroundDependencyLoader(true)]
-        private void load(OsuColour colours, OsuConfigManager config)
+        private void load(OsuColour colours)
         {
             base.LoadComplete();
 
@@ -129,8 +130,6 @@ namespace osu.Game.Screens.Play
                 Objects = drawableRuleset.Objects;
             }
 
-            config.BindWith(OsuSetting.ShowProgressGraph, ShowGraph);
-
             graph.FillColour = bar.FillColour = colours.BlueLighter;
         }
 

From a987cda30daa1a235b035fafeb4add95618ddcc8 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 1 Apr 2022 12:15:26 +0900
Subject: [PATCH 3830/5547] Rename "Aim Assist" to "Magnetised" to better suit
 the mod's behaviour

As proposed in https://github.com/ppy/osu/discussions/17375.
---
 ...uModAimAssist.cs => TestSceneOsuModMagnetised.cs} |  6 +++---
 osu.Game.Rulesets.Osu/Mods/OsuModAutopilot.cs        |  2 +-
 osu.Game.Rulesets.Osu/Mods/OsuModAutoplay.cs         |  2 +-
 osu.Game.Rulesets.Osu/Mods/OsuModCinema.cs           |  2 +-
 .../Mods/{OsuModAimAssist.cs => OsuModMagnetised.cs} | 12 ++++++------
 osu.Game.Rulesets.Osu/Mods/OsuModRelax.cs            |  2 +-
 osu.Game.Rulesets.Osu/Mods/OsuModTransform.cs        |  2 +-
 osu.Game.Rulesets.Osu/Mods/OsuModWiggle.cs           |  2 +-
 osu.Game.Rulesets.Osu/OsuRuleset.cs                  |  2 +-
 9 files changed, 16 insertions(+), 16 deletions(-)
 rename osu.Game.Rulesets.Osu.Tests/Mods/{TestSceneOsuModAimAssist.cs => TestSceneOsuModMagnetised.cs} (79%)
 rename osu.Game.Rulesets.Osu/Mods/{OsuModAimAssist.cs => OsuModMagnetised.cs} (87%)

diff --git a/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModAimAssist.cs b/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModMagnetised.cs
similarity index 79%
rename from osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModAimAssist.cs
rename to osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModMagnetised.cs
index b8310bc4e7..e7a40d6337 100644
--- a/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModAimAssist.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModMagnetised.cs
@@ -6,16 +6,16 @@ using osu.Game.Rulesets.Osu.Mods;
 
 namespace osu.Game.Rulesets.Osu.Tests.Mods
 {
-    public class TestSceneOsuModAimAssist : OsuModTestScene
+    public class TestSceneOsuModMagnetised : OsuModTestScene
     {
         [TestCase(0.1f)]
         [TestCase(0.5f)]
         [TestCase(1)]
-        public void TestAimAssist(float strength)
+        public void TestMagnetised(float strength)
         {
             CreateModTest(new ModTestData
             {
-                Mod = new OsuModAimAssist
+                Mod = new OsuModMagnetised
                 {
                     AssistStrength = { Value = strength },
                 },
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModAutopilot.cs b/osu.Game.Rulesets.Osu/Mods/OsuModAutopilot.cs
index 983964d639..aaf455e95f 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModAutopilot.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModAutopilot.cs
@@ -22,7 +22,7 @@ namespace osu.Game.Rulesets.Osu.Mods
         public override ModType Type => ModType.Automation;
         public override string Description => @"Automatic cursor movement - just follow the rhythm.";
         public override double ScoreMultiplier => 1;
-        public override Type[] IncompatibleMods => new[] { typeof(OsuModSpunOut), typeof(ModRelax), typeof(ModFailCondition), typeof(ModNoFail), typeof(ModAutoplay), typeof(OsuModAimAssist) };
+        public override Type[] IncompatibleMods => new[] { typeof(OsuModSpunOut), typeof(ModRelax), typeof(ModFailCondition), typeof(ModNoFail), typeof(ModAutoplay), typeof(OsuModMagnetised) };
 
         public bool PerformFail() => false;
 
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModAutoplay.cs b/osu.Game.Rulesets.Osu/Mods/OsuModAutoplay.cs
index 31179cdf4a..b31ef5d2fd 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModAutoplay.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModAutoplay.cs
@@ -12,7 +12,7 @@ namespace osu.Game.Rulesets.Osu.Mods
 {
     public class OsuModAutoplay : ModAutoplay
     {
-        public override Type[] IncompatibleMods => base.IncompatibleMods.Concat(new[] { typeof(OsuModAimAssist), typeof(OsuModAutopilot), typeof(OsuModSpunOut) }).ToArray();
+        public override Type[] IncompatibleMods => base.IncompatibleMods.Concat(new[] { typeof(OsuModMagnetised), typeof(OsuModAutopilot), typeof(OsuModSpunOut) }).ToArray();
 
         public override ModReplayData CreateReplayData(IBeatmap beatmap, IReadOnlyList<Mod> mods)
             => new ModReplayData(new OsuAutoGenerator(beatmap, mods).Generate(), new ModCreatedUser { Username = "Autoplay" });
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModCinema.cs b/osu.Game.Rulesets.Osu/Mods/OsuModCinema.cs
index d677ab43d0..5b42772358 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModCinema.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModCinema.cs
@@ -13,7 +13,7 @@ namespace osu.Game.Rulesets.Osu.Mods
 {
     public class OsuModCinema : ModCinema<OsuHitObject>
     {
-        public override Type[] IncompatibleMods => base.IncompatibleMods.Concat(new[] { typeof(OsuModAimAssist), typeof(OsuModAutopilot), typeof(OsuModSpunOut) }).ToArray();
+        public override Type[] IncompatibleMods => base.IncompatibleMods.Concat(new[] { typeof(OsuModMagnetised), typeof(OsuModAutopilot), typeof(OsuModSpunOut) }).ToArray();
 
         public override ModReplayData CreateReplayData(IBeatmap beatmap, IReadOnlyList<Mod> mods)
             => new ModReplayData(new OsuAutoGenerator(beatmap, mods).Generate(), new ModCreatedUser { Username = "Autoplay" });
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs b/osu.Game.Rulesets.Osu/Mods/OsuModMagnetised.cs
similarity index 87%
rename from osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs
rename to osu.Game.Rulesets.Osu/Mods/OsuModMagnetised.cs
index 1abbd67d8f..31598c50e7 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModAimAssist.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModMagnetised.cs
@@ -16,19 +16,19 @@ using osuTK;
 
 namespace osu.Game.Rulesets.Osu.Mods
 {
-    internal class OsuModAimAssist : Mod, IUpdatableByPlayfield, IApplicableToDrawableRuleset<OsuHitObject>
+    internal class OsuModMagnetised : Mod, IUpdatableByPlayfield, IApplicableToDrawableRuleset<OsuHitObject>
     {
-        public override string Name => "Aim Assist";
-        public override string Acronym => "AA";
-        public override IconUsage? Icon => FontAwesome.Solid.MousePointer;
+        public override string Name => "Magnetised";
+        public override string Acronym => "MG";
+        public override IconUsage? Icon => FontAwesome.Solid.Magnet;
         public override ModType Type => ModType.Fun;
-        public override string Description => "No need to chase the circle – the circle chases you!";
+        public override string Description => "No need to chase the circles – your cursor is a magnet!";
         public override double ScoreMultiplier => 1;
         public override Type[] IncompatibleMods => new[] { typeof(OsuModAutopilot), typeof(OsuModWiggle), typeof(OsuModTransform), typeof(ModAutoplay), typeof(OsuModRelax) };
 
         private IFrameStableClock gameplayClock;
 
-        [SettingSource("Assist strength", "How much this mod will assist you.", 0)]
+        [SettingSource("Attraction strength", "How strong the pull is.", 0)]
         public BindableFloat AssistStrength { get; } = new BindableFloat(0.5f)
         {
             Precision = 0.05f,
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModRelax.cs b/osu.Game.Rulesets.Osu/Mods/OsuModRelax.cs
index 9719de441e..6b81efdca6 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModRelax.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModRelax.cs
@@ -19,7 +19,7 @@ namespace osu.Game.Rulesets.Osu.Mods
     public class OsuModRelax : ModRelax, IUpdatableByPlayfield, IApplicableToDrawableRuleset<OsuHitObject>, IApplicableToPlayer
     {
         public override string Description => @"You don't need to click. Give your clicking/tapping fingers a break from the heat of things.";
-        public override Type[] IncompatibleMods => base.IncompatibleMods.Concat(new[] { typeof(OsuModAutopilot), typeof(OsuModAimAssist) }).ToArray();
+        public override Type[] IncompatibleMods => base.IncompatibleMods.Concat(new[] { typeof(OsuModAutopilot), typeof(OsuModMagnetised) }).ToArray();
 
         /// <summary>
         /// How early before a hitobject's start time to trigger a hit.
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModTransform.cs b/osu.Game.Rulesets.Osu/Mods/OsuModTransform.cs
index 28c3b069b6..45ce4d555a 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModTransform.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModTransform.cs
@@ -20,7 +20,7 @@ namespace osu.Game.Rulesets.Osu.Mods
         public override ModType Type => ModType.Fun;
         public override string Description => "Everything rotates. EVERYTHING.";
         public override double ScoreMultiplier => 1;
-        public override Type[] IncompatibleMods => new[] { typeof(OsuModWiggle), typeof(OsuModAimAssist) };
+        public override Type[] IncompatibleMods => new[] { typeof(OsuModWiggle), typeof(OsuModMagnetised) };
 
         private float theta;
 
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModWiggle.cs b/osu.Game.Rulesets.Osu/Mods/OsuModWiggle.cs
index 40a05400ea..693a5bee0b 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModWiggle.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModWiggle.cs
@@ -20,7 +20,7 @@ namespace osu.Game.Rulesets.Osu.Mods
         public override ModType Type => ModType.Fun;
         public override string Description => "They just won't stay still...";
         public override double ScoreMultiplier => 1;
-        public override Type[] IncompatibleMods => new[] { typeof(OsuModTransform), typeof(OsuModAimAssist) };
+        public override Type[] IncompatibleMods => new[] { typeof(OsuModTransform), typeof(OsuModMagnetised) };
 
         private const int wiggle_duration = 90; // (ms) Higher = fewer wiggles
         private const int wiggle_strength = 10; // Higher = stronger wiggles
diff --git a/osu.Game.Rulesets.Osu/OsuRuleset.cs b/osu.Game.Rulesets.Osu/OsuRuleset.cs
index 47a2618ddd..207e7a4ab0 100644
--- a/osu.Game.Rulesets.Osu/OsuRuleset.cs
+++ b/osu.Game.Rulesets.Osu/OsuRuleset.cs
@@ -195,7 +195,7 @@ namespace osu.Game.Rulesets.Osu
                         new OsuModApproachDifferent(),
                         new OsuModMuted(),
                         new OsuModNoScope(),
-                        new OsuModAimAssist(),
+                        new OsuModMagnetised(),
                         new ModAdaptiveSpeed()
                     };
 

From cabbc486e9d1940f4d95429c6691758ff7ee6b85 Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Fri, 1 Apr 2022 11:36:20 +0800
Subject: [PATCH 3831/5547] Rotate sliders in random mod

---
 .../Utils/OsuHitObjectGenerationUtils.cs      | 35 +++++++++
 .../OsuHitObjectGenerationUtils_Reposition.cs | 72 +++++++++++++++++--
 2 files changed, 103 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Utils/OsuHitObjectGenerationUtils.cs b/osu.Game.Rulesets.Osu/Utils/OsuHitObjectGenerationUtils.cs
index da73c2addb..19d3390f56 100644
--- a/osu.Game.Rulesets.Osu/Utils/OsuHitObjectGenerationUtils.cs
+++ b/osu.Game.Rulesets.Osu/Utils/OsuHitObjectGenerationUtils.cs
@@ -146,5 +146,40 @@ namespace osu.Game.Rulesets.Osu.Utils
 
             slider.Path = new SliderPath(controlPoints, slider.Path.ExpectedDistance.Value);
         }
+
+        /// <summary>
+        /// Rotate a slider about its start position by the specified angle.
+        /// </summary>
+        /// <param name="slider">The slider to be rotated.</param>
+        /// <param name="rotation">The angle to rotate the slider by.</param>
+        public static void RotateSlider(Slider slider, float rotation)
+        {
+            void rotateNestedObject(OsuHitObject nested) => nested.Position = rotateVector(nested.Position - slider.Position, rotation) + slider.Position;
+
+            slider.NestedHitObjects.OfType<SliderTick>().ForEach(rotateNestedObject);
+            slider.NestedHitObjects.OfType<SliderRepeat>().ForEach(rotateNestedObject);
+
+            var controlPoints = slider.Path.ControlPoints.Select(p => new PathControlPoint(p.Position, p.Type)).ToArray();
+            foreach (var point in controlPoints)
+                point.Position = rotateVector(point.Position, rotation);
+
+            slider.Path = new SliderPath(controlPoints, slider.Path.ExpectedDistance.Value);
+        }
+
+        /// <summary>
+        /// Rotate a vector by the specified angle.
+        /// </summary>
+        /// <param name="vector">The vector to be rotated.</param>
+        /// <param name="rotation">The angle to rotate the vector by.</param>
+        /// <returns>The rotated vector.</returns>
+        private static Vector2 rotateVector(Vector2 vector, float rotation)
+        {
+            float angle = (float)Math.Atan2(vector.Y, vector.X) + rotation;
+            float length = vector.Length;
+            return new Vector2(
+                length * (float)Math.Cos(angle),
+                length * (float)Math.Sin(angle)
+            );
+        }
     }
 }
diff --git a/osu.Game.Rulesets.Osu/Utils/OsuHitObjectGenerationUtils_Reposition.cs b/osu.Game.Rulesets.Osu/Utils/OsuHitObjectGenerationUtils_Reposition.cs
index d1bc3b45df..ef1c258a8d 100644
--- a/osu.Game.Rulesets.Osu/Utils/OsuHitObjectGenerationUtils_Reposition.cs
+++ b/osu.Game.Rulesets.Osu/Utils/OsuHitObjectGenerationUtils_Reposition.cs
@@ -40,12 +40,21 @@ namespace osu.Game.Rulesets.Osu.Utils
                 float absoluteAngle = (float)Math.Atan2(relativePosition.Y, relativePosition.X);
                 float relativeAngle = absoluteAngle - previousAngle;
 
-                positionInfos.Add(new ObjectPositionInfo(hitObject)
+                ObjectPositionInfo positionInfo;
+                positionInfos.Add(positionInfo = new ObjectPositionInfo(hitObject)
                 {
                     RelativeAngle = relativeAngle,
                     DistanceFromPrevious = relativePosition.Length
                 });
 
+                if (hitObject is Slider)
+                {
+                    var endPositionVector = hitObject.EndPosition - hitObject.Position;
+                    float absoluteRotation = (float)Math.Atan2(endPositionVector.Y, endPositionVector.X);
+                    positionInfo.Rotation = absoluteRotation - absoluteAngle;
+                    absoluteAngle = absoluteRotation;
+                }
+
                 previousPosition = hitObject.EndPosition;
                 previousAngle = absoluteAngle;
             }
@@ -124,9 +133,16 @@ namespace osu.Game.Rulesets.Osu.Utils
 
             if (previous != null)
             {
-                Vector2 earliestPosition = beforePrevious?.HitObject.EndPosition ?? playfield_centre;
-                Vector2 relativePosition = previous.HitObject.Position - earliestPosition;
-                previousAbsoluteAngle = (float)Math.Atan2(relativePosition.Y, relativePosition.X);
+                if (previous.HitObject is Slider s)
+                {
+                    previousAbsoluteAngle = getSliderRotation(s);
+                }
+                else
+                {
+                    Vector2 earliestPosition = beforePrevious?.HitObject.EndPosition ?? playfield_centre;
+                    Vector2 relativePosition = previous.HitObject.Position - earliestPosition;
+                    previousAbsoluteAngle = (float)Math.Atan2(relativePosition.Y, relativePosition.X);
+                }
             }
 
             float absoluteAngle = previousAbsoluteAngle + current.PositionInfo.RelativeAngle;
@@ -141,6 +157,16 @@ namespace osu.Game.Rulesets.Osu.Utils
             posRelativeToPrev = RotateAwayFromEdge(lastEndPosition, posRelativeToPrev);
 
             current.PositionModified = lastEndPosition + posRelativeToPrev;
+
+            if (!(current.HitObject is Slider slider))
+                return;
+
+            Vector2 centreOfMassOriginal = calculateCentreOfMass(slider);
+            Vector2 centreOfMassModified = rotateVector(centreOfMassOriginal, current.PositionInfo.Rotation - current.RotationOriginal);
+            centreOfMassModified = RotateAwayFromEdge(current.PositionModified, centreOfMassModified);
+
+            float relativeRotation = (float)Math.Atan2(centreOfMassModified.Y, centreOfMassModified.X) - (float)Math.Atan2(centreOfMassOriginal.Y, centreOfMassOriginal.X);
+            RotateSlider(slider, relativeRotation);
         }
 
         /// <summary>
@@ -287,6 +313,27 @@ namespace osu.Game.Rulesets.Osu.Utils
             );
         }
 
+        private static Vector2 calculateCentreOfMass(Slider slider)
+        {
+            int count = 0;
+            Vector2 sum = Vector2.Zero;
+            double pathDistance = slider.Distance;
+
+            for (double i = 0; i < pathDistance; i++)
+            {
+                sum += slider.Path.PositionAt(i / pathDistance);
+                count++;
+            }
+
+            return sum / count;
+        }
+
+        private static float getSliderRotation(Slider slider)
+        {
+            var endPositionVector = slider.EndPosition - slider.Position;
+            return (float)Math.Atan2(endPositionVector.Y, endPositionVector.X);
+        }
+
         public class ObjectPositionInfo
         {
             /// <summary>
@@ -309,6 +356,13 @@ namespace osu.Game.Rulesets.Osu.Utils
             /// </remarks>
             public float DistanceFromPrevious { get; set; }
 
+            /// <summary>
+            /// The rotation of the hit object, relative to its jump angle.
+            /// For sliders, this is defined as the angle from the slider's start position to its end position, relative to its jump angle.
+            /// For hit circles and spinners, this property is ignored.
+            /// </summary>
+            public float Rotation { get; set; }
+
             /// <summary>
             /// The hit object associated with this <see cref="ObjectPositionInfo"/>.
             /// </summary>
@@ -325,6 +379,7 @@ namespace osu.Game.Rulesets.Osu.Utils
             public Vector2 PositionOriginal { get; }
             public Vector2 PositionModified { get; set; }
             public Vector2 EndPositionModified { get; set; }
+            public float RotationOriginal { get; }
 
             public ObjectPositionInfo PositionInfo { get; }
             public OsuHitObject HitObject => PositionInfo.HitObject;
@@ -334,6 +389,15 @@ namespace osu.Game.Rulesets.Osu.Utils
                 PositionInfo = positionInfo;
                 PositionModified = PositionOriginal = HitObject.Position;
                 EndPositionModified = HitObject.EndPosition;
+
+                if (HitObject is Slider slider)
+                {
+                    RotationOriginal = getSliderRotation(slider);
+                }
+                else
+                {
+                    RotationOriginal = 0;
+                }
             }
         }
     }

From 998df5a4fef7627a897c23afa4f8b57c01e2a6f7 Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Fri, 1 Apr 2022 11:37:10 +0800
Subject: [PATCH 3832/5547] Fix large slider clamping

---
 .../Utils/OsuHitObjectGenerationUtils_Reposition.cs         | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Utils/OsuHitObjectGenerationUtils_Reposition.cs b/osu.Game.Rulesets.Osu/Utils/OsuHitObjectGenerationUtils_Reposition.cs
index ef1c258a8d..9f308df985 100644
--- a/osu.Game.Rulesets.Osu/Utils/OsuHitObjectGenerationUtils_Reposition.cs
+++ b/osu.Game.Rulesets.Osu/Utils/OsuHitObjectGenerationUtils_Reposition.cs
@@ -198,13 +198,13 @@ namespace osu.Game.Rulesets.Osu.Utils
             var previousPosition = workingObject.PositionModified;
 
             // Clamp slider position to the placement area
-            // If the slider is larger than the playfield, force it to stay at the original position
+            // If the slider is larger than the playfield, at least make sure that the head circle is inside the playfield
             float newX = possibleMovementBounds.Width < 0
-                ? workingObject.PositionOriginal.X
+                ? Math.Clamp(possibleMovementBounds.Left, 0, OsuPlayfield.BASE_SIZE.X)
                 : Math.Clamp(previousPosition.X, possibleMovementBounds.Left, possibleMovementBounds.Right);
 
             float newY = possibleMovementBounds.Height < 0
-                ? workingObject.PositionOriginal.Y
+                ? Math.Clamp(possibleMovementBounds.Top, 0, OsuPlayfield.BASE_SIZE.Y)
                 : Math.Clamp(previousPosition.Y, possibleMovementBounds.Top, possibleMovementBounds.Bottom);
 
             slider.Position = workingObject.PositionModified = new Vector2(newX, newY);

From af3835083ccd246810758b0156adbca2b3117587 Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Fri, 1 Apr 2022 11:41:45 +0800
Subject: [PATCH 3833/5547] Fix slider relative rotation calculation

---
 .../OsuHitObjectGenerationUtils_Reposition.cs | 19 +++++--------------
 1 file changed, 5 insertions(+), 14 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Utils/OsuHitObjectGenerationUtils_Reposition.cs b/osu.Game.Rulesets.Osu/Utils/OsuHitObjectGenerationUtils_Reposition.cs
index 9f308df985..fe5841daac 100644
--- a/osu.Game.Rulesets.Osu/Utils/OsuHitObjectGenerationUtils_Reposition.cs
+++ b/osu.Game.Rulesets.Osu/Utils/OsuHitObjectGenerationUtils_Reposition.cs
@@ -47,10 +47,9 @@ namespace osu.Game.Rulesets.Osu.Utils
                     DistanceFromPrevious = relativePosition.Length
                 });
 
-                if (hitObject is Slider)
+                if (hitObject is Slider slider)
                 {
-                    var endPositionVector = hitObject.EndPosition - hitObject.Position;
-                    float absoluteRotation = (float)Math.Atan2(endPositionVector.Y, endPositionVector.X);
+                    float absoluteRotation = getSliderRotation(slider);
                     positionInfo.Rotation = absoluteRotation - absoluteAngle;
                     absoluteAngle = absoluteRotation;
                 }
@@ -161,8 +160,10 @@ namespace osu.Game.Rulesets.Osu.Utils
             if (!(current.HitObject is Slider slider))
                 return;
 
+            absoluteAngle = (float)Math.Atan2(posRelativeToPrev.Y, posRelativeToPrev.X);
+
             Vector2 centreOfMassOriginal = calculateCentreOfMass(slider);
-            Vector2 centreOfMassModified = rotateVector(centreOfMassOriginal, current.PositionInfo.Rotation - current.RotationOriginal);
+            Vector2 centreOfMassModified = rotateVector(centreOfMassOriginal, current.PositionInfo.Rotation + absoluteAngle - getSliderRotation(slider));
             centreOfMassModified = RotateAwayFromEdge(current.PositionModified, centreOfMassModified);
 
             float relativeRotation = (float)Math.Atan2(centreOfMassModified.Y, centreOfMassModified.X) - (float)Math.Atan2(centreOfMassOriginal.Y, centreOfMassOriginal.X);
@@ -379,7 +380,6 @@ namespace osu.Game.Rulesets.Osu.Utils
             public Vector2 PositionOriginal { get; }
             public Vector2 PositionModified { get; set; }
             public Vector2 EndPositionModified { get; set; }
-            public float RotationOriginal { get; }
 
             public ObjectPositionInfo PositionInfo { get; }
             public OsuHitObject HitObject => PositionInfo.HitObject;
@@ -389,15 +389,6 @@ namespace osu.Game.Rulesets.Osu.Utils
                 PositionInfo = positionInfo;
                 PositionModified = PositionOriginal = HitObject.Position;
                 EndPositionModified = HitObject.EndPosition;
-
-                if (HitObject is Slider slider)
-                {
-                    RotationOriginal = getSliderRotation(slider);
-                }
-                else
-                {
-                    RotationOriginal = 0;
-                }
             }
         }
     }

From ea672745b0d026ce7ca08d45239dca083e614635 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 1 Apr 2022 12:44:49 +0900
Subject: [PATCH 3834/5547] Add ability to switch between most common
 tournament scenes using key bindings

---
 osu.Game.Tournament/TournamentSceneManager.cs | 66 ++++++++++++++++---
 1 file changed, 58 insertions(+), 8 deletions(-)

diff --git a/osu.Game.Tournament/TournamentSceneManager.cs b/osu.Game.Tournament/TournamentSceneManager.cs
index 80a9c07cde..98338244e4 100644
--- a/osu.Game.Tournament/TournamentSceneManager.cs
+++ b/osu.Game.Tournament/TournamentSceneManager.cs
@@ -7,8 +7,10 @@ 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.Threading;
 using osu.Game.Graphics;
+using osu.Game.Graphics.Sprites;
 using osu.Game.Tournament.Components;
 using osu.Game.Tournament.Screens;
 using osu.Game.Tournament.Screens.Drawings;
@@ -23,6 +25,7 @@ using osu.Game.Tournament.Screens.TeamIntro;
 using osu.Game.Tournament.Screens.TeamWin;
 using osuTK;
 using osuTK.Graphics;
+using osuTK.Input;
 
 namespace osu.Game.Tournament
 {
@@ -123,16 +126,16 @@ namespace osu.Game.Tournament
                                 new ScreenButton(typeof(RoundEditorScreen)) { Text = "Rounds Editor", RequestSelection = SetScreen },
                                 new ScreenButton(typeof(LadderEditorScreen)) { Text = "Bracket Editor", RequestSelection = SetScreen },
                                 new Separator(),
-                                new ScreenButton(typeof(ScheduleScreen)) { Text = "Schedule", RequestSelection = SetScreen },
-                                new ScreenButton(typeof(LadderScreen)) { Text = "Bracket", RequestSelection = SetScreen },
+                                new ScreenButton(typeof(ScheduleScreen), Key.S) { Text = "Schedule", RequestSelection = SetScreen },
+                                new ScreenButton(typeof(LadderScreen), Key.B) { Text = "Bracket", RequestSelection = SetScreen },
                                 new Separator(),
-                                new ScreenButton(typeof(TeamIntroScreen)) { Text = "Team Intro", RequestSelection = SetScreen },
-                                new ScreenButton(typeof(SeedingScreen)) { Text = "Seeding", RequestSelection = SetScreen },
+                                new ScreenButton(typeof(TeamIntroScreen), Key.I) { Text = "Team Intro", RequestSelection = SetScreen },
+                                new ScreenButton(typeof(SeedingScreen), Key.D) { Text = "Seeding", RequestSelection = SetScreen },
                                 new Separator(),
-                                new ScreenButton(typeof(MapPoolScreen)) { Text = "Map Pool", RequestSelection = SetScreen },
-                                new ScreenButton(typeof(GameplayScreen)) { Text = "Gameplay", RequestSelection = SetScreen },
+                                new ScreenButton(typeof(MapPoolScreen), Key.M) { Text = "Map Pool", RequestSelection = SetScreen },
+                                new ScreenButton(typeof(GameplayScreen), Key.G) { Text = "Gameplay", RequestSelection = SetScreen },
                                 new Separator(),
-                                new ScreenButton(typeof(TeamWinScreen)) { Text = "Win", RequestSelection = SetScreen },
+                                new ScreenButton(typeof(TeamWinScreen), Key.W) { Text = "Win", RequestSelection = SetScreen },
                                 new Separator(),
                                 new ScreenButton(typeof(DrawingsScreen)) { Text = "Drawings", RequestSelection = SetScreen },
                                 new ScreenButton(typeof(ShowcaseScreen)) { Text = "Showcase", RequestSelection = SetScreen },
@@ -231,13 +234,60 @@ namespace osu.Game.Tournament
         {
             public readonly Type Type;
 
-            public ScreenButton(Type type)
+            private readonly Key? shortcutKey;
+
+            public ScreenButton(Type type, Key? shortcutKey = null)
             {
+                this.shortcutKey = shortcutKey;
+
                 Type = type;
+
                 BackgroundColour = OsuColour.Gray(0.2f);
                 Action = () => RequestSelection?.Invoke(type);
 
                 RelativeSizeAxes = Axes.X;
+
+                if (shortcutKey != null)
+                {
+                    Add(new Container
+                    {
+                        Anchor = Anchor.CentreLeft,
+                        Origin = Anchor.CentreLeft,
+                        Size = new Vector2(24),
+                        Margin = new MarginPadding(5),
+                        Masking = true,
+                        CornerRadius = 4,
+                        Alpha = 0.5f,
+                        Blending = BlendingParameters.Additive,
+                        Children = new Drawable[]
+                        {
+                            new Box
+                            {
+                                Colour = OsuColour.Gray(0.1f),
+                                RelativeSizeAxes = Axes.Both,
+                            },
+                            new OsuSpriteText
+                            {
+                                Font = OsuFont.Default.With(size: 24),
+                                Y = -2,
+                                Anchor = Anchor.Centre,
+                                Origin = Anchor.Centre,
+                                Text = shortcutKey.ToString(),
+                            }
+                        }
+                    });
+                }
+            }
+
+            protected override bool OnKeyDown(KeyDownEvent e)
+            {
+                if (e.Key == shortcutKey)
+                {
+                    TriggerClick();
+                    return true;
+                }
+
+                return base.OnKeyDown(e);
             }
 
             private bool isSelected;

From c0a78924aa2e5fe9ea9f6fe671e7fa770e472cac Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Fri, 1 Apr 2022 11:47:21 +0800
Subject: [PATCH 3835/5547] Fix generation for zero-length sliders

---
 .../Utils/OsuHitObjectGenerationUtils_Reposition.cs         | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu/Utils/OsuHitObjectGenerationUtils_Reposition.cs b/osu.Game.Rulesets.Osu/Utils/OsuHitObjectGenerationUtils_Reposition.cs
index fe5841daac..5f3719146f 100644
--- a/osu.Game.Rulesets.Osu/Utils/OsuHitObjectGenerationUtils_Reposition.cs
+++ b/osu.Game.Rulesets.Osu/Utils/OsuHitObjectGenerationUtils_Reposition.cs
@@ -5,6 +5,7 @@ using System;
 using System.Collections.Generic;
 using System.Linq;
 using osu.Framework.Graphics.Primitives;
+using osu.Framework.Utils;
 using osu.Game.Rulesets.Osu.Objects;
 using osu.Game.Rulesets.Osu.UI;
 using osuTK;
@@ -167,7 +168,8 @@ namespace osu.Game.Rulesets.Osu.Utils
             centreOfMassModified = RotateAwayFromEdge(current.PositionModified, centreOfMassModified);
 
             float relativeRotation = (float)Math.Atan2(centreOfMassModified.Y, centreOfMassModified.X) - (float)Math.Atan2(centreOfMassOriginal.Y, centreOfMassOriginal.X);
-            RotateSlider(slider, relativeRotation);
+            if (!Precision.AlmostEquals(relativeRotation, 0))
+                RotateSlider(slider, relativeRotation);
         }
 
         /// <summary>
@@ -316,6 +318,8 @@ namespace osu.Game.Rulesets.Osu.Utils
 
         private static Vector2 calculateCentreOfMass(Slider slider)
         {
+            if (slider.Distance < 1) return Vector2.Zero;
+
             int count = 0;
             Vector2 sum = Vector2.Zero;
             double pathDistance = slider.Distance;

From 0015f627b04a23f407ff514255650003fb610c0b Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Fri, 1 Apr 2022 11:49:27 +0800
Subject: [PATCH 3836/5547] Add xmldoc

---
 .../Utils/OsuHitObjectGenerationUtils_Reposition.cs    | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/osu.Game.Rulesets.Osu/Utils/OsuHitObjectGenerationUtils_Reposition.cs b/osu.Game.Rulesets.Osu/Utils/OsuHitObjectGenerationUtils_Reposition.cs
index 5f3719146f..ccc2529768 100644
--- a/osu.Game.Rulesets.Osu/Utils/OsuHitObjectGenerationUtils_Reposition.cs
+++ b/osu.Game.Rulesets.Osu/Utils/OsuHitObjectGenerationUtils_Reposition.cs
@@ -316,6 +316,11 @@ namespace osu.Game.Rulesets.Osu.Utils
             );
         }
 
+        /// <summary>
+        /// Estimate the centre of mass of a slider relative to its start position.
+        /// </summary>
+        /// <param name="slider">The slider to process.</param>
+        /// <returns>The centre of mass of the slider.</returns>
         private static Vector2 calculateCentreOfMass(Slider slider)
         {
             if (slider.Distance < 1) return Vector2.Zero;
@@ -333,6 +338,11 @@ namespace osu.Game.Rulesets.Osu.Utils
             return sum / count;
         }
 
+        /// <summary>
+        /// Get the absolute rotation of a slider, defined as the angle from its start position to its end position.
+        /// </summary>
+        /// <param name="slider">The slider to process.</param>
+        /// <returns>The angle in radians.</returns>
         private static float getSliderRotation(Slider slider)
         {
             var endPositionVector = slider.EndPosition - slider.Position;

From 031a977009d466796eb90aa9386d24ce16410f6c Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Fri, 1 Apr 2022 11:50:30 +0800
Subject: [PATCH 3837/5547] Calculate slider rotation using end point of path
 instead of EndPosition

---
 .../Utils/OsuHitObjectGenerationUtils_Reposition.cs         | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Utils/OsuHitObjectGenerationUtils_Reposition.cs b/osu.Game.Rulesets.Osu/Utils/OsuHitObjectGenerationUtils_Reposition.cs
index ccc2529768..45285e5e0c 100644
--- a/osu.Game.Rulesets.Osu/Utils/OsuHitObjectGenerationUtils_Reposition.cs
+++ b/osu.Game.Rulesets.Osu/Utils/OsuHitObjectGenerationUtils_Reposition.cs
@@ -339,13 +339,13 @@ namespace osu.Game.Rulesets.Osu.Utils
         }
 
         /// <summary>
-        /// Get the absolute rotation of a slider, defined as the angle from its start position to its end position.
+        /// Get the absolute rotation of a slider, defined as the angle from its start position to the end of its path.
         /// </summary>
         /// <param name="slider">The slider to process.</param>
         /// <returns>The angle in radians.</returns>
         private static float getSliderRotation(Slider slider)
         {
-            var endPositionVector = slider.EndPosition - slider.Position;
+            var endPositionVector = slider.Path.PositionAt(1);
             return (float)Math.Atan2(endPositionVector.Y, endPositionVector.X);
         }
 
@@ -373,7 +373,7 @@ namespace osu.Game.Rulesets.Osu.Utils
 
             /// <summary>
             /// The rotation of the hit object, relative to its jump angle.
-            /// For sliders, this is defined as the angle from the slider's start position to its end position, relative to its jump angle.
+            /// For sliders, this is defined as the angle from the slider's start position to the end of its path, relative to its jump angle.
             /// For hit circles and spinners, this property is ignored.
             /// </summary>
             public float Rotation { get; set; }

From ee6567788425bd24b198493bdd7f565fd6f0b4a5 Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Fri, 1 Apr 2022 11:57:45 +0800
Subject: [PATCH 3838/5547] Use height of playfield instead of width when
 randomizing the first object

This is the change discussed in #17194. The effect of this change is barely noticeable, but it makes more sense to generate the object within playfield from the start.
---
 osu.Game.Rulesets.Osu/Mods/OsuModRandom.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModRandom.cs b/osu.Game.Rulesets.Osu/Mods/OsuModRandom.cs
index fea9246035..ccc56bd64f 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModRandom.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModRandom.cs
@@ -48,7 +48,7 @@ namespace osu.Game.Rulesets.Osu.Mods
 
                 if (positionInfo == positionInfos.First())
                 {
-                    positionInfo.DistanceFromPrevious = (float)(rng.NextDouble() * OsuPlayfield.BASE_SIZE.X / 2);
+                    positionInfo.DistanceFromPrevious = (float)(rng.NextDouble() * OsuPlayfield.BASE_SIZE.Y / 2);
                     positionInfo.RelativeAngle = (float)(rng.NextDouble() * 2 * Math.PI - Math.PI);
                 }
                 else

From 3bebc88306c9abb2543686ba22fbbcbd51d2b0da Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Fri, 1 Apr 2022 11:59:24 +0800
Subject: [PATCH 3839/5547] Consider spinners when calculating jump angles

Spinners are considered in `GeneratePositionInfos`, so they should also be considered in `RepositionHitObjects`
---
 .../Utils/OsuHitObjectGenerationUtils_Reposition.cs             | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu/Utils/OsuHitObjectGenerationUtils_Reposition.cs b/osu.Game.Rulesets.Osu/Utils/OsuHitObjectGenerationUtils_Reposition.cs
index 45285e5e0c..664bfae35a 100644
--- a/osu.Game.Rulesets.Osu/Utils/OsuHitObjectGenerationUtils_Reposition.cs
+++ b/osu.Game.Rulesets.Osu/Utils/OsuHitObjectGenerationUtils_Reposition.cs
@@ -79,7 +79,7 @@ namespace osu.Game.Rulesets.Osu.Utils
 
                 if (hitObject is Spinner)
                 {
-                    previous = null;
+                    previous = current;
                     continue;
                 }
 

From de625125d6d04b97d8571d62267e6e04328dfde8 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 1 Apr 2022 13:03:48 +0900
Subject: [PATCH 3840/5547] Rename magnetised mod attraction strength property
 to match new naming

---
 osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModMagnetised.cs | 2 +-
 osu.Game.Rulesets.Osu/Mods/OsuModMagnetised.cs                | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModMagnetised.cs b/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModMagnetised.cs
index e7a40d6337..9b49e60363 100644
--- a/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModMagnetised.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModMagnetised.cs
@@ -17,7 +17,7 @@ namespace osu.Game.Rulesets.Osu.Tests.Mods
             {
                 Mod = new OsuModMagnetised
                 {
-                    AssistStrength = { Value = strength },
+                    AttractionStrength = { Value = strength },
                 },
                 PassCondition = () => true,
                 Autoplay = false,
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModMagnetised.cs b/osu.Game.Rulesets.Osu/Mods/OsuModMagnetised.cs
index 31598c50e7..ca6e9cfb1d 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModMagnetised.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModMagnetised.cs
@@ -29,7 +29,7 @@ namespace osu.Game.Rulesets.Osu.Mods
         private IFrameStableClock gameplayClock;
 
         [SettingSource("Attraction strength", "How strong the pull is.", 0)]
-        public BindableFloat AssistStrength { get; } = new BindableFloat(0.5f)
+        public BindableFloat AttractionStrength { get; } = new BindableFloat(0.5f)
         {
             Precision = 0.05f,
             MinValue = 0.05f,
@@ -72,7 +72,7 @@ namespace osu.Game.Rulesets.Osu.Mods
 
         private void easeTo(DrawableHitObject hitObject, Vector2 destination)
         {
-            double dampLength = Interpolation.Lerp(3000, 40, AssistStrength.Value);
+            double dampLength = Interpolation.Lerp(3000, 40, AttractionStrength.Value);
 
             float x = (float)Interpolation.DampContinuously(hitObject.X, destination.X, dampLength, gameplayClock.ElapsedFrameTime);
             float y = (float)Interpolation.DampContinuously(hitObject.Y, destination.Y, dampLength, gameplayClock.ElapsedFrameTime);

From 69d4f8612268ab280408f765d44256e385f25f9a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 1 Apr 2022 14:11:53 +0900
Subject: [PATCH 3841/5547] Fix automatically created "(modified)" skins
 getting conflicting names

Applies the already tested and proven method that is used in the editor
to the mutable skin creation flow.
---
 osu.Game/Skinning/SkinManager.cs | 15 +++++++++++----
 1 file changed, 11 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Skinning/SkinManager.cs b/osu.Game/Skinning/SkinManager.cs
index bad559d9fe..44b9c69794 100644
--- a/osu.Game/Skinning/SkinManager.cs
+++ b/osu.Game/Skinning/SkinManager.cs
@@ -24,6 +24,7 @@ using osu.Game.Database;
 using osu.Game.IO;
 using osu.Game.IO.Archives;
 using osu.Game.Overlays.Notifications;
+using osu.Game.Utils;
 
 namespace osu.Game.Skinning
 {
@@ -144,20 +145,26 @@ namespace osu.Game.Skinning
                 if (!s.Protected)
                     return;
 
+                var existingSkinNames = realm.Run(r => r.All<SkinInfo>()
+                                                        .Where(skin => !skin.DeletePending)
+                                                        .AsEnumerable()
+                                                        .Select(skin => skin.Name));
+
                 // if the user is attempting to save one of the default skin implementations, create a copy first.
-                var result = skinModelManager.Import(new SkinInfo
+                var skinInfo = new SkinInfo
                 {
-                    Name = s.Name + @" (modified)",
                     Creator = s.Creator,
                     InstantiationInfo = s.InstantiationInfo,
-                });
+                    Name = NamingUtils.GetNextBestName(existingSkinNames, $"{s.Name} (modified)")
+                };
+
+                var result = skinModelManager.Import(skinInfo);
 
                 if (result != null)
                 {
                     // save once to ensure the required json content is populated.
                     // currently this only happens on save.
                     result.PerformRead(skin => Save(skin.CreateInstance(this)));
-
                     CurrentSkinInfo.Value = result;
                 }
             });

From 88306a61804c4d960f0c1b06090f9c914fb3f6b3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 1 Apr 2022 14:22:26 +0900
Subject: [PATCH 3842/5547] Disable ability to select random skin from within
 the skin editor

Reasoning is explained in inline comment.

I knowingly only applied this to the shortcut key. It's still feasible a
user can choose the option from the skin dropdown while the editor is
open, but that's less of an issue (because a user won't get the same
compulsion that I get to mash the key, only to be greeted with 100 new
mutable skins created).
---
 osu.Game/OsuGame.cs | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index 4cd954a646..73121f6e7d 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -1061,6 +1061,12 @@ namespace osu.Game
                     return true;
 
                 case GlobalAction.RandomSkin:
+                    // Don't allow random skin selection while in the skin editor.
+                    // This is mainly to stop many "osu! default (modified)" skins being created via the SkinManager.EnsureMutableSkin() path.
+                    // If people want this to work we can potentially avoid selecting default skins when the editor is open, or allow a maximum of one mutable skin somehow.
+                    if (skinEditor.State.Value == Visibility.Visible)
+                        return false;
+
                     SkinManager.SelectRandomSkin();
                     return true;
             }

From 01829cf2d89ebec7056a5e5cb082b8d91f5cd46d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 1 Apr 2022 14:30:02 +0900
Subject: [PATCH 3843/5547] Move `SkinnableInfo` error handling to lower level

Handling was recently added to handle the usage in
`Skin.GetDrawableCompoent`, but it turns out this is also required for
`DrawableExtensions.ApplySkinnableInfo` which can throw in a similar
fashion.

Found while working on sprite support for the editor, where this becomes
an actual issue (ie. switching to a branch where the new sprite support
is not present can cause unexpected crashes).
---
 osu.Game/Screens/Play/HUD/SkinnableInfo.cs | 15 ++++++++++++---
 osu.Game/Skinning/Skin.cs                  | 11 +----------
 2 files changed, 13 insertions(+), 13 deletions(-)

diff --git a/osu.Game/Screens/Play/HUD/SkinnableInfo.cs b/osu.Game/Screens/Play/HUD/SkinnableInfo.cs
index 95395f8181..1f659fd5bf 100644
--- a/osu.Game/Screens/Play/HUD/SkinnableInfo.cs
+++ b/osu.Game/Screens/Play/HUD/SkinnableInfo.cs
@@ -9,6 +9,7 @@ using Newtonsoft.Json;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
+using osu.Framework.Logging;
 using osu.Game.Configuration;
 using osu.Game.Extensions;
 using osu.Game.Skinning;
@@ -84,9 +85,17 @@ namespace osu.Game.Screens.Play.HUD
         /// <returns>The new instance.</returns>
         public Drawable CreateInstance()
         {
-            Drawable d = (Drawable)Activator.CreateInstance(Type);
-            d.ApplySkinnableInfo(this);
-            return d;
+            try
+            {
+                Drawable d = (Drawable)Activator.CreateInstance(Type);
+                d.ApplySkinnableInfo(this);
+                return d;
+            }
+            catch (Exception e)
+            {
+                Logger.Error(e, $"Unable to create skin component {Type.Name}");
+                return Drawable.Empty();
+            }
         }
     }
 }
diff --git a/osu.Game/Skinning/Skin.cs b/osu.Game/Skinning/Skin.cs
index 2f01bb7301..5d4afc00c4 100644
--- a/osu.Game/Skinning/Skin.cs
+++ b/osu.Game/Skinning/Skin.cs
@@ -155,16 +155,7 @@ namespace osu.Game.Skinning
                     var components = new List<Drawable>();
 
                     foreach (var i in skinnableInfo)
-                    {
-                        try
-                        {
-                            components.Add(i.CreateInstance());
-                        }
-                        catch (Exception e)
-                        {
-                            Logger.Error(e, $"Unable to create skin component {i.Type.Name}");
-                        }
-                    }
+                        components.Add(i.CreateInstance());
 
                     return new SkinnableTargetComponentsContainer
                     {

From 3a16483214bb564dbf75f5bd61f6c7623e0783b5 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 23 Mar 2022 15:10:26 +0900
Subject: [PATCH 3844/5547] Add prioritised user lookups for default skin

This allows user resources to be consumed before falling back to the
game bundled assets.
---
 osu.Game/Skinning/DefaultSkin.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Skinning/DefaultSkin.cs b/osu.Game/Skinning/DefaultSkin.cs
index 7c6d138f4c..43ada59bcb 100644
--- a/osu.Game/Skinning/DefaultSkin.cs
+++ b/osu.Game/Skinning/DefaultSkin.cs
@@ -46,13 +46,13 @@ namespace osu.Game.Skinning
             this.resources = resources;
         }
 
-        public override Texture GetTexture(string componentName, WrapMode wrapModeS, WrapMode wrapModeT) => null;
+        public override Texture GetTexture(string componentName, WrapMode wrapModeS, WrapMode wrapModeT) => Textures?.Get(componentName, wrapModeS, wrapModeT);
 
         public override ISample GetSample(ISampleInfo sampleInfo)
         {
             foreach (string lookup in sampleInfo.LookupNames)
             {
-                var sample = resources.AudioManager.Samples.Get(lookup);
+                var sample = Samples?.Get(lookup) ?? resources.AudioManager.Samples.Get(lookup);
                 if (sample != null)
                     return sample;
             }

From fca9faac9b87eb9c24d86e2d52764619bbe2ddf0 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 23 Mar 2022 15:11:35 +0900
Subject: [PATCH 3845/5547] Add `SkinnableSprite` for arbitrary sprite
 additions

---
 .../Skinning/Components/SkinnableSprite.cs    | 49 ++++++++++++++++
 osu.Game/Skinning/Editor/SkinEditor.cs        | 56 +++++++++++++++++--
 osu.Game/Skinning/SkinManager.cs              | 44 ++++++++++++++-
 osu.Game/Skinning/SkinnableSprite.cs          |  4 +-
 4 files changed, 147 insertions(+), 6 deletions(-)
 create mode 100644 osu.Game/Skinning/Components/SkinnableSprite.cs

diff --git a/osu.Game/Skinning/Components/SkinnableSprite.cs b/osu.Game/Skinning/Components/SkinnableSprite.cs
new file mode 100644
index 0000000000..292bbe2321
--- /dev/null
+++ b/osu.Game/Skinning/Components/SkinnableSprite.cs
@@ -0,0 +1,49 @@
+// 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 JetBrains.Annotations;
+using osu.Framework.Allocation;
+using osu.Framework.Bindables;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.Sprites;
+using osu.Game.Configuration;
+
+namespace osu.Game.Skinning.Components
+{
+    /// <summary>
+    /// Intended to be a test bed for skinning. May be removed at some point in the future.
+    /// </summary>
+    [UsedImplicitly]
+    public class SkinSprite : CompositeDrawable, ISkinnableDrawable
+    {
+        public bool UsesFixedAnchor { get; set; }
+
+        [SettingSource("Sprite name", "The filename of the sprite")]
+        public Bindable<string> SpriteName { get; } = new Bindable<string>(string.Empty);
+
+        [Resolved]
+        private ISkinSource source { get; set; }
+
+        public SkinSprite()
+        {
+            AutoSizeAxes = Axes.Both;
+        }
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            SpriteName.BindValueChanged(spriteName =>
+            {
+                InternalChildren = new Drawable[]
+                {
+                    new Sprite
+                    {
+                        Texture = source.GetTexture(SpriteName.Value),
+                    }
+                };
+            }, true);
+        }
+    }
+}
diff --git a/osu.Game/Skinning/Editor/SkinEditor.cs b/osu.Game/Skinning/Editor/SkinEditor.cs
index 7bf4e94662..7701fafbfc 100644
--- a/osu.Game/Skinning/Editor/SkinEditor.cs
+++ b/osu.Game/Skinning/Editor/SkinEditor.cs
@@ -3,7 +3,9 @@
 
 using System;
 using System.Collections.Generic;
+using System.IO;
 using System.Linq;
+using System.Threading.Tasks;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
@@ -11,6 +13,7 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.UserInterface;
 using osu.Framework.Input.Events;
 using osu.Framework.Testing;
+using osu.Game.Database;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Cursor;
@@ -18,11 +21,12 @@ using osu.Game.Graphics.UserInterface;
 using osu.Game.Overlays;
 using osu.Game.Screens.Edit.Components;
 using osu.Game.Screens.Edit.Components.Menus;
+using osu.Game.Skinning.Components;
 
 namespace osu.Game.Skinning.Editor
 {
     [Cached(typeof(SkinEditor))]
-    public class SkinEditor : VisibilityContainer
+    public class SkinEditor : VisibilityContainer, ICanAcceptFiles
     {
         public const double TRANSITION_DURATION = 500;
 
@@ -36,6 +40,9 @@ namespace osu.Game.Skinning.Editor
 
         private Bindable<Skin> currentSkin;
 
+        [Resolved(canBeNull: true)]
+        private OsuGame game { get; set; }
+
         [Resolved]
         private SkinManager skins { get; set; }
 
@@ -171,6 +178,8 @@ namespace osu.Game.Skinning.Editor
 
             Show();
 
+            game?.RegisterImportHandler(this);
+
             // as long as the skin editor is loaded, let's make sure we can modify the current skin.
             currentSkin = skins.CurrentSkin.GetBoundCopy();
 
@@ -186,6 +195,13 @@ namespace osu.Game.Skinning.Editor
             SelectedComponents.BindCollectionChanged((_, __) => Scheduler.AddOnce(populateSettings), true);
         }
 
+        protected override void Dispose(bool isDisposing)
+        {
+            base.Dispose(isDisposing);
+
+            game?.UnregisterImportHandler(this);
+        }
+
         public void UpdateTargetScreen(Drawable targetScreen)
         {
             this.targetScreen = targetScreen;
@@ -229,15 +245,20 @@ namespace osu.Game.Skinning.Editor
         }
 
         private void placeComponent(Type type)
+        {
+            if (!(Activator.CreateInstance(type) is ISkinnableDrawable component))
+                throw new InvalidOperationException($"Attempted to instantiate a component for placement which was not an {typeof(ISkinnableDrawable)}.");
+
+            placeComponent(component);
+        }
+
+        private void placeComponent(ISkinnableDrawable component)
         {
             var targetContainer = getFirstTarget();
 
             if (targetContainer == null)
                 return;
 
-            if (!(Activator.CreateInstance(type) is ISkinnableDrawable component))
-                throw new InvalidOperationException($"Attempted to instantiate a component for placement which was not an {typeof(ISkinnableDrawable)}.");
-
             var drawableComponent = (Drawable)component;
 
             // give newly added components a sane starting location.
@@ -313,5 +334,32 @@ namespace osu.Game.Skinning.Editor
             foreach (var item in items)
                 availableTargets.FirstOrDefault(t => t.Components.Contains(item))?.Remove(item);
         }
+
+        public Task Import(params string[] paths)
+        {
+            Schedule(() =>
+            {
+                var file = new FileInfo(paths.First());
+
+                // import to skin
+                currentSkin.Value.SkinInfo.PerformWrite(skinInfo =>
+                {
+                    using (var contents = file.OpenRead())
+                        skins.AddFile(skinInfo, contents, file.Name);
+                });
+
+                // place component
+                placeComponent(new SkinSprite
+                {
+                    SpriteName = { Value = Path.GetFileNameWithoutExtension(file.Name) }
+                });
+            });
+
+            return Task.CompletedTask;
+        }
+
+        public Task Import(params ImportTask[] tasks) => throw new NotImplementedException();
+
+        public IEnumerable<string> HandledExtensions => new[] { ".jpg", ".jpeg", ".png" };
     }
 }
diff --git a/osu.Game/Skinning/SkinManager.cs b/osu.Game/Skinning/SkinManager.cs
index bad559d9fe..5333b58625 100644
--- a/osu.Game/Skinning/SkinManager.cs
+++ b/osu.Game/Skinning/SkinManager.cs
@@ -3,6 +3,7 @@
 
 using System;
 using System.Collections.Generic;
+using System.IO;
 using System.Linq;
 using System.Linq.Expressions;
 using System.Threading;
@@ -23,6 +24,7 @@ using osu.Game.Audio;
 using osu.Game.Database;
 using osu.Game.IO;
 using osu.Game.IO.Archives;
+using osu.Game.Models;
 using osu.Game.Overlays.Notifications;
 
 namespace osu.Game.Skinning
@@ -35,7 +37,7 @@ namespace osu.Game.Skinning
     /// For gameplay components, see <see cref="RulesetSkinProvidingContainer"/> which adds extra legacy and toggle logic that may affect the lookup process.
     /// </remarks>
     [ExcludeFromDynamicCompile]
-    public class SkinManager : ISkinSource, IStorageResourceProvider, IModelImporter<SkinInfo>
+    public class SkinManager : ISkinSource, IStorageResourceProvider, IModelImporter<SkinInfo>, IModelManager<SkinInfo>, IModelFileManager<SkinInfo, RealmNamedFileUsage>
     {
         private readonly AudioManager audio;
 
@@ -306,5 +308,45 @@ namespace osu.Game.Skinning
         }
 
         #endregion
+
+        public bool Delete(SkinInfo item)
+        {
+            return skinModelManager.Delete(item);
+        }
+
+        public void Delete(List<SkinInfo> items, bool silent = false)
+        {
+            skinModelManager.Delete(items, silent);
+        }
+
+        public void Undelete(List<SkinInfo> items, bool silent = false)
+        {
+            skinModelManager.Undelete(items, silent);
+        }
+
+        public void Undelete(SkinInfo item)
+        {
+            skinModelManager.Undelete(item);
+        }
+
+        public bool IsAvailableLocally(SkinInfo model)
+        {
+            return skinModelManager.IsAvailableLocally(model);
+        }
+
+        public void ReplaceFile(SkinInfo model, RealmNamedFileUsage file, Stream contents)
+        {
+            skinModelManager.ReplaceFile(model, file, contents);
+        }
+
+        public void DeleteFile(SkinInfo model, RealmNamedFileUsage file)
+        {
+            skinModelManager.DeleteFile(model, file);
+        }
+
+        public void AddFile(SkinInfo model, Stream contents, string filename)
+        {
+            skinModelManager.AddFile(model, contents, filename);
+        }
     }
 }
diff --git a/osu.Game/Skinning/SkinnableSprite.cs b/osu.Game/Skinning/SkinnableSprite.cs
index 56e576d081..38803bd8e3 100644
--- a/osu.Game/Skinning/SkinnableSprite.cs
+++ b/osu.Game/Skinning/SkinnableSprite.cs
@@ -11,7 +11,7 @@ namespace osu.Game.Skinning
     /// <summary>
     /// A skinnable element which uses a stable sprite and can therefore share implementation logic.
     /// </summary>
-    public class SkinnableSprite : SkinnableDrawable
+    public class SkinnableSprite : SkinnableDrawable, ISkinnableDrawable
     {
         protected override bool ApplySizeRestrictionsToDefault => true;
 
@@ -42,5 +42,7 @@ namespace osu.Game.Skinning
 
             public string LookupName { get; }
         }
+
+        public bool UsesFixedAnchor { get; set; }
     }
 }

From 66f5eae530cac55975b46655825d2b159e73976d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 24 Mar 2022 19:32:34 +0900
Subject: [PATCH 3846/5547] Hook up a dropdown to show all available sprites
 for the current skin

---
 .../Configuration/SettingSourceAttribute.cs   |  1 +
 osu.Game/Overlays/Settings/SettingsItem.cs    |  6 ++++++
 .../Skinning/Components/SkinnableSprite.cs    | 19 ++++++++++++++++++-
 osu.Game/Skinning/Editor/SkinEditor.cs        |  2 +-
 4 files changed, 26 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Configuration/SettingSourceAttribute.cs b/osu.Game/Configuration/SettingSourceAttribute.cs
index 4111a67b24..8c84707b88 100644
--- a/osu.Game/Configuration/SettingSourceAttribute.cs
+++ b/osu.Game/Configuration/SettingSourceAttribute.cs
@@ -88,6 +88,7 @@ namespace osu.Game.Configuration
                         throw new InvalidOperationException($"{nameof(SettingSourceAttribute)} had an unsupported custom control type ({controlType.ReadableName()})");
 
                     var control = (Drawable)Activator.CreateInstance(controlType);
+                    controlType.GetProperty(nameof(SettingsItem<object>.Source))?.SetValue(control, obj);
                     controlType.GetProperty(nameof(SettingsItem<object>.LabelText))?.SetValue(control, attr.Label);
                     controlType.GetProperty(nameof(SettingsItem<object>.TooltipText))?.SetValue(control, attr.Description);
                     controlType.GetProperty(nameof(SettingsItem<object>.Current))?.SetValue(control, value);
diff --git a/osu.Game/Overlays/Settings/SettingsItem.cs b/osu.Game/Overlays/Settings/SettingsItem.cs
index e709be1343..6ac5351270 100644
--- a/osu.Game/Overlays/Settings/SettingsItem.cs
+++ b/osu.Game/Overlays/Settings/SettingsItem.cs
@@ -11,6 +11,7 @@ using osu.Framework.Graphics.Cursor;
 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;
 using osu.Game.Graphics.Containers;
@@ -24,6 +25,11 @@ namespace osu.Game.Overlays.Settings
 
         protected Drawable Control { get; }
 
+        /// <summary>
+        /// The source component if this <see cref="SettingsItem{T}"/> was created via <see cref="SettingSourceAttribute"/>.
+        /// </summary>
+        public Drawable Source { get; internal set; }
+
         private IHasCurrentValue<T> controlWithCurrent => Control as IHasCurrentValue<T>;
 
         protected override Container<Drawable> Content => FlowContent;
diff --git a/osu.Game/Skinning/Components/SkinnableSprite.cs b/osu.Game/Skinning/Components/SkinnableSprite.cs
index 292bbe2321..aa23e428d1 100644
--- a/osu.Game/Skinning/Components/SkinnableSprite.cs
+++ b/osu.Game/Skinning/Components/SkinnableSprite.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.Collections.Generic;
+using System.Linq;
 using JetBrains.Annotations;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
@@ -8,6 +10,7 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Sprites;
 using osu.Game.Configuration;
+using osu.Game.Overlays.Settings;
 
 namespace osu.Game.Skinning.Components
 {
@@ -19,12 +22,14 @@ namespace osu.Game.Skinning.Components
     {
         public bool UsesFixedAnchor { get; set; }
 
-        [SettingSource("Sprite name", "The filename of the sprite")]
+        [SettingSource("Sprite name", "The filename of the sprite", SettingControlType = typeof(SpriteSelectorControl))]
         public Bindable<string> SpriteName { get; } = new Bindable<string>(string.Empty);
 
         [Resolved]
         private ISkinSource source { get; set; }
 
+        public IEnumerable<string> AvailableFiles => (source.AllSources.First() as Skin)?.SkinInfo.PerformRead(s => s.Files.Select(f => f.Filename));
+
         public SkinSprite()
         {
             AutoSizeAxes = Axes.Both;
@@ -45,5 +50,17 @@ namespace osu.Game.Skinning.Components
                 };
             }, true);
         }
+
+        public class SpriteSelectorControl : SettingsDropdown<string>
+        {
+            public SkinSprite Source { get; set; }
+
+            protected override void LoadComplete()
+            {
+                base.LoadComplete();
+
+                Items = Source.AvailableFiles;
+            }
+        }
     }
 }
diff --git a/osu.Game/Skinning/Editor/SkinEditor.cs b/osu.Game/Skinning/Editor/SkinEditor.cs
index 7701fafbfc..392cb2f32b 100644
--- a/osu.Game/Skinning/Editor/SkinEditor.cs
+++ b/osu.Game/Skinning/Editor/SkinEditor.cs
@@ -351,7 +351,7 @@ namespace osu.Game.Skinning.Editor
                 // place component
                 placeComponent(new SkinSprite
                 {
-                    SpriteName = { Value = Path.GetFileNameWithoutExtension(file.Name) }
+                    SpriteName = { Value = file.Name }
                 });
             });
 

From 9c3dad9fbf72f63cbb79fdc8f2ebc687a2d66f69 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 24 Mar 2022 19:09:17 +0900
Subject: [PATCH 3847/5547] Add proof of concept flow to ensure
 `RealmBackedResourceStore` is invalidated on realm file changes

I'm not at all happy with this, but it does work so let's go with it for
now.
---
 osu.Game/Skinning/LegacyBeatmapSkin.cs        |  5 +-
 osu.Game/Skinning/RealmBackedResourceStore.cs | 57 ++++++++++++-------
 osu.Game/Skinning/Skin.cs                     |  8 ++-
 osu.Game/Skinning/SkinManager.cs              | 21 ++++++-
 4 files changed, 67 insertions(+), 24 deletions(-)

diff --git a/osu.Game/Skinning/LegacyBeatmapSkin.cs b/osu.Game/Skinning/LegacyBeatmapSkin.cs
index 16a05f4197..70f5b35d00 100644
--- a/osu.Game/Skinning/LegacyBeatmapSkin.cs
+++ b/osu.Game/Skinning/LegacyBeatmapSkin.cs
@@ -11,6 +11,7 @@ using osu.Framework.IO.Stores;
 using osu.Game.Audio;
 using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.Formats;
+using osu.Game.Database;
 using osu.Game.IO;
 using osu.Game.Rulesets.Objects.Legacy;
 using osu.Game.Rulesets.Objects.Types;
@@ -37,11 +38,11 @@ namespace osu.Game.Skinning
 
         private static IResourceStore<byte[]> createRealmBackedStore(BeatmapInfo beatmapInfo, IStorageResourceProvider? resources)
         {
-            if (resources == null)
+            if (resources == null || beatmapInfo.BeatmapSet == null)
                 // should only ever be used in tests.
                 return new ResourceStore<byte[]>();
 
-            return new RealmBackedResourceStore(beatmapInfo.BeatmapSet, resources.Files, new[] { @"ogg" });
+            return new RealmBackedResourceStore<BeatmapSetInfo>(beatmapInfo.BeatmapSet.ToLive(resources.RealmAccess), resources.Files, resources.RealmAccess);
         }
 
         public override Drawable? GetDrawableComponent(ISkinComponent component)
diff --git a/osu.Game/Skinning/RealmBackedResourceStore.cs b/osu.Game/Skinning/RealmBackedResourceStore.cs
index fc9036727f..115d563575 100644
--- a/osu.Game/Skinning/RealmBackedResourceStore.cs
+++ b/osu.Game/Skinning/RealmBackedResourceStore.cs
@@ -1,51 +1,68 @@
 // 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 enable
+
+using System;
 using System.Collections.Generic;
+using System.Diagnostics;
+using System.Threading;
 using osu.Framework.Extensions;
 using osu.Framework.IO.Stores;
 using osu.Game.Database;
 using osu.Game.Extensions;
+using Realms;
 
 namespace osu.Game.Skinning
 {
-    public class RealmBackedResourceStore : ResourceStore<byte[]>
+    public class RealmBackedResourceStore<T> : ResourceStore<byte[]>
+        where T : RealmObject, IHasRealmFiles, IHasGuidPrimaryKey
     {
-        private readonly Dictionary<string, string> fileToStoragePathMapping = new Dictionary<string, string>();
+        private Lazy<Dictionary<string, string>> fileToStoragePathMapping;
 
-        public RealmBackedResourceStore(IHasRealmFiles source, IResourceStore<byte[]> underlyingStore, string[] extensions = null)
+        private readonly Live<T> liveSource;
+
+        public RealmBackedResourceStore(Live<T> source, IResourceStore<byte[]> underlyingStore, RealmAccess? realm)
             : base(underlyingStore)
         {
-            // Must be initialised before the file cache.
-            if (extensions != null)
-            {
-                foreach (string extension in extensions)
-                    AddExtension(extension);
-            }
+            liveSource = source;
 
-            initialiseFileCache(source);
+            invalidateCache();
+            Debug.Assert(fileToStoragePathMapping != null);
         }
 
-        private void initialiseFileCache(IHasRealmFiles source)
-        {
-            fileToStoragePathMapping.Clear();
-            foreach (var f in source.Files)
-                fileToStoragePathMapping[f.Filename.ToLowerInvariant()] = f.File.GetStoragePath();
-        }
+        public void Invalidate() => invalidateCache();
 
         protected override IEnumerable<string> GetFilenames(string name)
         {
             foreach (string filename in base.GetFilenames(name))
             {
-                string path = getPathForFile(filename.ToStandardisedPath());
+                string? path = getPathForFile(filename.ToStandardisedPath());
                 if (path != null)
                     yield return path;
             }
         }
 
-        private string getPathForFile(string filename) =>
-            fileToStoragePathMapping.TryGetValue(filename.ToLower(), out string path) ? path : null;
+        private string? getPathForFile(string filename)
+        {
+            if (fileToStoragePathMapping.Value.TryGetValue(filename.ToLowerInvariant(), out string path))
+                return path;
 
-        public override IEnumerable<string> GetAvailableResources() => fileToStoragePathMapping.Keys;
+            return null;
+        }
+
+        private void invalidateCache() => fileToStoragePathMapping = new Lazy<Dictionary<string, string>>(initialiseFileCache, LazyThreadSafetyMode.ExecutionAndPublication);
+
+        private Dictionary<string, string> initialiseFileCache() => liveSource.PerformRead(source =>
+        {
+            var dictionary = new Dictionary<string, string>();
+            dictionary.Clear();
+            foreach (var f in source.Files)
+                dictionary[f.Filename.ToLowerInvariant()] = f.File.GetStoragePath();
+
+            return dictionary;
+        });
+
+        public override IEnumerable<string> GetAvailableResources() => fileToStoragePathMapping.Value.Keys;
     }
 }
diff --git a/osu.Game/Skinning/Skin.cs b/osu.Game/Skinning/Skin.cs
index 2f01bb7301..fb9914cd9e 100644
--- a/osu.Game/Skinning/Skin.cs
+++ b/osu.Game/Skinning/Skin.cs
@@ -54,6 +54,10 @@ namespace osu.Game.Skinning
             where TLookup : notnull
             where TValue : notnull;
 
+        public void InvalidateCaches() => realmBackedStorage?.Invalidate();
+
+        private readonly RealmBackedResourceStore<SkinInfo> realmBackedStorage;
+
         /// <summary>
         /// Construct a new skin.
         /// </summary>
@@ -67,7 +71,9 @@ namespace osu.Game.Skinning
             {
                 SkinInfo = skin.ToLive(resources.RealmAccess);
 
-                storage ??= new RealmBackedResourceStore(skin, resources.Files, new[] { @"ogg" });
+                storage ??= realmBackedStorage = new RealmBackedResourceStore<SkinInfo>(SkinInfo, resources.Files, resources.RealmAccess);
+
+                (storage as ResourceStore<byte[]>)?.AddExtension("ogg");
 
                 var samples = resources.AudioManager?.GetSampleStore(storage);
                 if (samples != null)
diff --git a/osu.Game/Skinning/SkinManager.cs b/osu.Game/Skinning/SkinManager.cs
index 5333b58625..bafb088f68 100644
--- a/osu.Game/Skinning/SkinManager.cs
+++ b/osu.Game/Skinning/SkinManager.cs
@@ -16,6 +16,7 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.OpenGL.Textures;
 using osu.Framework.Graphics.Textures;
 using osu.Framework.IO.Stores;
+using osu.Framework.Logging;
 using osu.Framework.Platform;
 using osu.Framework.Testing;
 using osu.Framework.Threading;
@@ -26,6 +27,7 @@ using osu.Game.IO;
 using osu.Game.IO.Archives;
 using osu.Game.Models;
 using osu.Game.Overlays.Notifications;
+using Realms;
 
 namespace osu.Game.Skinning
 {
@@ -59,6 +61,8 @@ namespace osu.Game.Skinning
 
         private readonly IResourceStore<byte[]> userFiles;
 
+        private IDisposable currentSkinSubscription;
+
         /// <summary>
         /// The default skin.
         /// </summary>
@@ -97,7 +101,16 @@ namespace osu.Game.Skinning
                 }
             });
 
-            CurrentSkinInfo.ValueChanged += skin => CurrentSkin.Value = skin.NewValue.PerformRead(GetSkin);
+            CurrentSkinInfo.ValueChanged += skin =>
+            {
+                CurrentSkin.Value = skin.NewValue.PerformRead(GetSkin);
+
+                scheduler.Add(() =>
+                {
+                    currentSkinSubscription?.Dispose();
+                    currentSkinSubscription = realm.RegisterForNotifications(r => r.All<SkinInfo>().Where(s => s.ID == skin.NewValue.ID), realmSkinChanged);
+                });
+            };
 
             CurrentSkin.Value = DefaultSkin;
             CurrentSkin.ValueChanged += skin =>
@@ -109,6 +122,12 @@ namespace osu.Game.Skinning
             };
         }
 
+        private void realmSkinChanged<T>(IRealmCollection<T> sender, ChangeSet changes, Exception error) where T : RealmObjectBase
+        {
+            Logger.Log("Detected a skin change");
+            CurrentSkin.Value.InvalidateCaches();
+        }
+
         public void SelectRandomSkin()
         {
             realm.Run(r =>

From 762de3cc9780e76e744ea4e3c5d532e16117e4fd Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 24 Mar 2022 22:53:49 +0900
Subject: [PATCH 3848/5547] Replace invalidation logic with local realm
 notification subscription

---
 osu.Game/Skinning/RealmBackedResourceStore.cs | 12 +++++++++++-
 osu.Game/Skinning/Skin.cs                     |  4 ++--
 osu.Game/Skinning/SkinManager.cs              | 16 ----------------
 3 files changed, 13 insertions(+), 19 deletions(-)

diff --git a/osu.Game/Skinning/RealmBackedResourceStore.cs b/osu.Game/Skinning/RealmBackedResourceStore.cs
index 115d563575..e727a7e59a 100644
--- a/osu.Game/Skinning/RealmBackedResourceStore.cs
+++ b/osu.Game/Skinning/RealmBackedResourceStore.cs
@@ -6,6 +6,7 @@
 using System;
 using System.Collections.Generic;
 using System.Diagnostics;
+using System.Linq;
 using System.Threading;
 using osu.Framework.Extensions;
 using osu.Framework.IO.Stores;
@@ -21,6 +22,7 @@ namespace osu.Game.Skinning
         private Lazy<Dictionary<string, string>> fileToStoragePathMapping;
 
         private readonly Live<T> liveSource;
+        private readonly IDisposable? realmSubscription;
 
         public RealmBackedResourceStore(Live<T> source, IResourceStore<byte[]> underlyingStore, RealmAccess? realm)
             : base(underlyingStore)
@@ -29,9 +31,17 @@ namespace osu.Game.Skinning
 
             invalidateCache();
             Debug.Assert(fileToStoragePathMapping != null);
+
+            realmSubscription = realm?.RegisterForNotifications(r => r.All<T>().Where(s => s.ID == source.ID), skinChanged);
         }
 
-        public void Invalidate() => invalidateCache();
+        protected override void Dispose(bool disposing)
+        {
+            base.Dispose(disposing);
+            realmSubscription?.Dispose();
+        }
+
+        private void skinChanged(IRealmCollection<T> sender, ChangeSet changes, Exception error) => invalidateCache();
 
         protected override IEnumerable<string> GetFilenames(string name)
         {
diff --git a/osu.Game/Skinning/Skin.cs b/osu.Game/Skinning/Skin.cs
index fb9914cd9e..4cd1d952db 100644
--- a/osu.Game/Skinning/Skin.cs
+++ b/osu.Game/Skinning/Skin.cs
@@ -54,8 +54,6 @@ namespace osu.Game.Skinning
             where TLookup : notnull
             where TValue : notnull;
 
-        public void InvalidateCaches() => realmBackedStorage?.Invalidate();
-
         private readonly RealmBackedResourceStore<SkinInfo> realmBackedStorage;
 
         /// <summary>
@@ -206,6 +204,8 @@ namespace osu.Game.Skinning
 
             Textures?.Dispose();
             Samples?.Dispose();
+
+            realmBackedStorage?.Dispose();
         }
 
         #endregion
diff --git a/osu.Game/Skinning/SkinManager.cs b/osu.Game/Skinning/SkinManager.cs
index bafb088f68..5e85f9e4ca 100644
--- a/osu.Game/Skinning/SkinManager.cs
+++ b/osu.Game/Skinning/SkinManager.cs
@@ -16,7 +16,6 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.OpenGL.Textures;
 using osu.Framework.Graphics.Textures;
 using osu.Framework.IO.Stores;
-using osu.Framework.Logging;
 using osu.Framework.Platform;
 using osu.Framework.Testing;
 using osu.Framework.Threading;
@@ -27,7 +26,6 @@ using osu.Game.IO;
 using osu.Game.IO.Archives;
 using osu.Game.Models;
 using osu.Game.Overlays.Notifications;
-using Realms;
 
 namespace osu.Game.Skinning
 {
@@ -61,8 +59,6 @@ namespace osu.Game.Skinning
 
         private readonly IResourceStore<byte[]> userFiles;
 
-        private IDisposable currentSkinSubscription;
-
         /// <summary>
         /// The default skin.
         /// </summary>
@@ -104,12 +100,6 @@ namespace osu.Game.Skinning
             CurrentSkinInfo.ValueChanged += skin =>
             {
                 CurrentSkin.Value = skin.NewValue.PerformRead(GetSkin);
-
-                scheduler.Add(() =>
-                {
-                    currentSkinSubscription?.Dispose();
-                    currentSkinSubscription = realm.RegisterForNotifications(r => r.All<SkinInfo>().Where(s => s.ID == skin.NewValue.ID), realmSkinChanged);
-                });
             };
 
             CurrentSkin.Value = DefaultSkin;
@@ -122,12 +112,6 @@ namespace osu.Game.Skinning
             };
         }
 
-        private void realmSkinChanged<T>(IRealmCollection<T> sender, ChangeSet changes, Exception error) where T : RealmObjectBase
-        {
-            Logger.Log("Detected a skin change");
-            CurrentSkin.Value.InvalidateCaches();
-        }
-
         public void SelectRandomSkin()
         {
             realm.Run(r =>

From d1be229d74806794f8f136f3919885f915c118fc Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 25 Mar 2022 17:31:03 +0900
Subject: [PATCH 3849/5547] Combine `SkinSprite` into `SkinnableSprite`

---
 .../Skinning/Components/SkinnableSprite.cs    | 66 -------------------
 osu.Game/Skinning/DefaultSkin.cs              |  4 ++
 osu.Game/Skinning/Editor/SkinEditor.cs        |  5 +-
 osu.Game/Skinning/Skin.cs                     |  2 +-
 osu.Game/Skinning/SkinnableDrawable.cs        |  8 +--
 osu.Game/Skinning/SkinnableSprite.cs          | 47 ++++++++++++-
 6 files changed, 55 insertions(+), 77 deletions(-)
 delete mode 100644 osu.Game/Skinning/Components/SkinnableSprite.cs

diff --git a/osu.Game/Skinning/Components/SkinnableSprite.cs b/osu.Game/Skinning/Components/SkinnableSprite.cs
deleted file mode 100644
index aa23e428d1..0000000000
--- a/osu.Game/Skinning/Components/SkinnableSprite.cs
+++ /dev/null
@@ -1,66 +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.Collections.Generic;
-using System.Linq;
-using JetBrains.Annotations;
-using osu.Framework.Allocation;
-using osu.Framework.Bindables;
-using osu.Framework.Graphics;
-using osu.Framework.Graphics.Containers;
-using osu.Framework.Graphics.Sprites;
-using osu.Game.Configuration;
-using osu.Game.Overlays.Settings;
-
-namespace osu.Game.Skinning.Components
-{
-    /// <summary>
-    /// Intended to be a test bed for skinning. May be removed at some point in the future.
-    /// </summary>
-    [UsedImplicitly]
-    public class SkinSprite : CompositeDrawable, ISkinnableDrawable
-    {
-        public bool UsesFixedAnchor { get; set; }
-
-        [SettingSource("Sprite name", "The filename of the sprite", SettingControlType = typeof(SpriteSelectorControl))]
-        public Bindable<string> SpriteName { get; } = new Bindable<string>(string.Empty);
-
-        [Resolved]
-        private ISkinSource source { get; set; }
-
-        public IEnumerable<string> AvailableFiles => (source.AllSources.First() as Skin)?.SkinInfo.PerformRead(s => s.Files.Select(f => f.Filename));
-
-        public SkinSprite()
-        {
-            AutoSizeAxes = Axes.Both;
-        }
-
-        protected override void LoadComplete()
-        {
-            base.LoadComplete();
-
-            SpriteName.BindValueChanged(spriteName =>
-            {
-                InternalChildren = new Drawable[]
-                {
-                    new Sprite
-                    {
-                        Texture = source.GetTexture(SpriteName.Value),
-                    }
-                };
-            }, true);
-        }
-
-        public class SpriteSelectorControl : SettingsDropdown<string>
-        {
-            public SkinSprite Source { get; set; }
-
-            protected override void LoadComplete()
-            {
-                base.LoadComplete();
-
-                Items = Source.AvailableFiles;
-            }
-        }
-    }
-}
diff --git a/osu.Game/Skinning/DefaultSkin.cs b/osu.Game/Skinning/DefaultSkin.cs
index 43ada59bcb..c645b0fae4 100644
--- a/osu.Game/Skinning/DefaultSkin.cs
+++ b/osu.Game/Skinning/DefaultSkin.cs
@@ -8,6 +8,7 @@ using osu.Framework.Audio.Sample;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.OpenGL.Textures;
+using osu.Framework.Graphics.Sprites;
 using osu.Framework.Graphics.Textures;
 using osu.Game.Audio;
 using osu.Game.Beatmaps.Formats;
@@ -157,6 +158,9 @@ namespace osu.Game.Skinning
                     break;
             }
 
+            if (GetTexture(component.LookupName) is Texture t)
+                return new Sprite { Texture = t };
+
             return null;
         }
 
diff --git a/osu.Game/Skinning/Editor/SkinEditor.cs b/osu.Game/Skinning/Editor/SkinEditor.cs
index 392cb2f32b..484faebdc0 100644
--- a/osu.Game/Skinning/Editor/SkinEditor.cs
+++ b/osu.Game/Skinning/Editor/SkinEditor.cs
@@ -21,7 +21,6 @@ using osu.Game.Graphics.UserInterface;
 using osu.Game.Overlays;
 using osu.Game.Screens.Edit.Components;
 using osu.Game.Screens.Edit.Components.Menus;
-using osu.Game.Skinning.Components;
 
 namespace osu.Game.Skinning.Editor
 {
@@ -349,9 +348,9 @@ namespace osu.Game.Skinning.Editor
                 });
 
                 // place component
-                placeComponent(new SkinSprite
+                placeComponent(new SkinnableSprite
                 {
-                    SpriteName = { Value = file.Name }
+                    SpriteName = { Value = Path.GetFileNameWithoutExtension(file.Name) }
                 });
             });
 
diff --git a/osu.Game/Skinning/Skin.cs b/osu.Game/Skinning/Skin.cs
index 4cd1d952db..f2d095f880 100644
--- a/osu.Game/Skinning/Skin.cs
+++ b/osu.Game/Skinning/Skin.cs
@@ -54,7 +54,7 @@ namespace osu.Game.Skinning
             where TLookup : notnull
             where TValue : notnull;
 
-        private readonly RealmBackedResourceStore<SkinInfo> realmBackedStorage;
+        private readonly RealmBackedResourceStore<SkinInfo>? realmBackedStorage;
 
         /// <summary>
         /// Construct a new skin.
diff --git a/osu.Game/Skinning/SkinnableDrawable.cs b/osu.Game/Skinning/SkinnableDrawable.cs
index 72f64e2e12..45409694b5 100644
--- a/osu.Game/Skinning/SkinnableDrawable.cs
+++ b/osu.Game/Skinning/SkinnableDrawable.cs
@@ -31,7 +31,7 @@ namespace osu.Game.Skinning
             set => base.AutoSizeAxes = value;
         }
 
-        private readonly ISkinComponent component;
+        protected readonly ISkinComponent Component;
 
         private readonly ConfineMode confineMode;
 
@@ -49,7 +49,7 @@ namespace osu.Game.Skinning
 
         protected SkinnableDrawable(ISkinComponent component, ConfineMode confineMode = ConfineMode.NoScaling)
         {
-            this.component = component;
+            Component = component;
             this.confineMode = confineMode;
 
             RelativeSizeAxes = Axes.Both;
@@ -75,13 +75,13 @@ namespace osu.Game.Skinning
 
         protected override void SkinChanged(ISkinSource skin)
         {
-            Drawable = skin.GetDrawableComponent(component);
+            Drawable = skin.GetDrawableComponent(Component);
 
             isDefault = false;
 
             if (Drawable == null)
             {
-                Drawable = CreateDefault(component);
+                Drawable = CreateDefault(Component);
                 isDefault = true;
             }
 
diff --git a/osu.Game/Skinning/SkinnableSprite.cs b/osu.Game/Skinning/SkinnableSprite.cs
index 38803bd8e3..aa3001fe45 100644
--- a/osu.Game/Skinning/SkinnableSprite.cs
+++ b/osu.Game/Skinning/SkinnableSprite.cs
@@ -1,10 +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.Collections.Generic;
+using System.IO;
+using System.Linq;
 using osu.Framework.Allocation;
+using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Graphics.Textures;
+using osu.Game.Configuration;
+using osu.Game.Overlays.Settings;
 
 namespace osu.Game.Skinning
 {
@@ -18,9 +24,32 @@ namespace osu.Game.Skinning
         [Resolved]
         private TextureStore textures { get; set; }
 
+        [SettingSource("Sprite name", "The filename of the sprite", SettingControlType = typeof(SpriteSelectorControl))]
+        public Bindable<string> SpriteName { get; } = new Bindable<string>(string.Empty);
+
+        [Resolved]
+        private ISkinSource source { get; set; }
+
+        public IEnumerable<string> AvailableFiles => (source.AllSources.First() as Skin)?.SkinInfo.PerformRead(s => s.Files.Select(f => Path.GetFileNameWithoutExtension(f.Filename)).Distinct());
+
         public SkinnableSprite(string textureName, ConfineMode confineMode = ConfineMode.NoScaling)
             : base(new SpriteComponent(textureName), confineMode)
         {
+            SpriteName.Value = textureName;
+        }
+
+        public SkinnableSprite()
+            : base(new SpriteComponent(string.Empty), ConfineMode.NoScaling)
+        {
+            RelativeSizeAxes = Axes.None;
+            AutoSizeAxes = Axes.Both;
+
+            SpriteName.BindValueChanged(name =>
+            {
+                ((SpriteComponent)Component).LookupName = name.NewValue ?? string.Empty;
+                if (IsLoaded)
+                    SkinChanged(CurrentSkin);
+            });
         }
 
         protected override Drawable CreateDefault(ISkinComponent component)
@@ -33,16 +62,28 @@ namespace osu.Game.Skinning
             return new Sprite { Texture = texture };
         }
 
+        public bool UsesFixedAnchor { get; set; }
+
         private class SpriteComponent : ISkinComponent
         {
+            public string LookupName { get; set; }
+
             public SpriteComponent(string textureName)
             {
                 LookupName = textureName;
             }
-
-            public string LookupName { get; }
         }
 
-        public bool UsesFixedAnchor { get; set; }
+        public class SpriteSelectorControl : SettingsDropdown<string>
+        {
+            public SkinnableSprite Source { get; set; }
+
+            protected override void LoadComplete()
+            {
+                base.LoadComplete();
+
+                Items = Source.AvailableFiles;
+            }
+        }
     }
 }

From 52eeaffce333df069e325c9b4bc69b0ed00bc4d3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 25 Mar 2022 17:36:02 +0900
Subject: [PATCH 3850/5547] Limit lookup resources to images

---
 osu.Game/Skinning/SkinnableSprite.cs | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Skinning/SkinnableSprite.cs b/osu.Game/Skinning/SkinnableSprite.cs
index aa3001fe45..f36ae89e25 100644
--- a/osu.Game/Skinning/SkinnableSprite.cs
+++ b/osu.Game/Skinning/SkinnableSprite.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;
 using System.Collections.Generic;
-using System.IO;
 using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
@@ -30,7 +30,12 @@ namespace osu.Game.Skinning
         [Resolved]
         private ISkinSource source { get; set; }
 
-        public IEnumerable<string> AvailableFiles => (source.AllSources.First() as Skin)?.SkinInfo.PerformRead(s => s.Files.Select(f => Path.GetFileNameWithoutExtension(f.Filename)).Distinct());
+        public IEnumerable<string> AvailableFiles => (source.AllSources.First() as Skin)?.SkinInfo.PerformRead(s => s.Files
+                                                                                                                     .Where(f =>
+                                                                                                                         f.Filename.EndsWith(".png", StringComparison.Ordinal)
+                                                                                                                         || f.Filename.EndsWith(".jpg", StringComparison.Ordinal)
+                                                                                                                     )
+                                                                                                                     .Select(f => f.Filename).Distinct());
 
         public SkinnableSprite(string textureName, ConfineMode confineMode = ConfineMode.NoScaling)
             : base(new SpriteComponent(textureName), confineMode)

From 2b7105ac4fc0ab4663a5e7d3fd72c836028a4714 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 1 Apr 2022 14:46:14 +0900
Subject: [PATCH 3851/5547] Add a default sprite representation to allow better
 placeholder display in skin editor toolbox

---
 osu.Game/Skinning/SkinnableSprite.cs | 12 ++++++++++--
 1 file changed, 10 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Skinning/SkinnableSprite.cs b/osu.Game/Skinning/SkinnableSprite.cs
index f36ae89e25..0005045c00 100644
--- a/osu.Game/Skinning/SkinnableSprite.cs
+++ b/osu.Game/Skinning/SkinnableSprite.cs
@@ -11,6 +11,7 @@ using osu.Framework.Graphics.Sprites;
 using osu.Framework.Graphics.Textures;
 using osu.Game.Configuration;
 using osu.Game.Overlays.Settings;
+using osuTK;
 
 namespace osu.Game.Skinning
 {
@@ -62,7 +63,13 @@ namespace osu.Game.Skinning
             var texture = textures.Get(component.LookupName);
 
             if (texture == null)
-                return null;
+            {
+                return new SpriteIcon
+                {
+                    Size = new Vector2(100),
+                    Icon = FontAwesome.Solid.QuestionCircle
+                };
+            }
 
             return new Sprite { Texture = texture };
         }
@@ -87,7 +94,8 @@ namespace osu.Game.Skinning
             {
                 base.LoadComplete();
 
-                Items = Source.AvailableFiles;
+                if (Source.AvailableFiles.Any())
+                    Items = Source.AvailableFiles;
             }
         }
     }

From 314ad63c6eee361142d0129bab387301bf442231 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 1 Apr 2022 15:14:53 +0900
Subject: [PATCH 3852/5547] Simplify available file lookup and include file
 extension

---
 osu.Game/Skinning/Editor/SkinEditor.cs |  2 +-
 osu.Game/Skinning/SkinnableSprite.cs   | 24 ++++++++++++------------
 2 files changed, 13 insertions(+), 13 deletions(-)

diff --git a/osu.Game/Skinning/Editor/SkinEditor.cs b/osu.Game/Skinning/Editor/SkinEditor.cs
index 484faebdc0..d36806a1b3 100644
--- a/osu.Game/Skinning/Editor/SkinEditor.cs
+++ b/osu.Game/Skinning/Editor/SkinEditor.cs
@@ -350,7 +350,7 @@ namespace osu.Game.Skinning.Editor
                 // place component
                 placeComponent(new SkinnableSprite
                 {
-                    SpriteName = { Value = Path.GetFileNameWithoutExtension(file.Name) }
+                    SpriteName = { Value = file.Name }
                 });
             });
 
diff --git a/osu.Game/Skinning/SkinnableSprite.cs b/osu.Game/Skinning/SkinnableSprite.cs
index 0005045c00..87490b4397 100644
--- a/osu.Game/Skinning/SkinnableSprite.cs
+++ b/osu.Game/Skinning/SkinnableSprite.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 osu.Framework.Allocation;
 using osu.Framework.Bindables;
@@ -31,13 +30,6 @@ namespace osu.Game.Skinning
         [Resolved]
         private ISkinSource source { get; set; }
 
-        public IEnumerable<string> AvailableFiles => (source.AllSources.First() as Skin)?.SkinInfo.PerformRead(s => s.Files
-                                                                                                                     .Where(f =>
-                                                                                                                         f.Filename.EndsWith(".png", StringComparison.Ordinal)
-                                                                                                                         || f.Filename.EndsWith(".jpg", StringComparison.Ordinal)
-                                                                                                                     )
-                                                                                                                     .Select(f => f.Filename).Distinct());
-
         public SkinnableSprite(string textureName, ConfineMode confineMode = ConfineMode.NoScaling)
             : base(new SpriteComponent(textureName), confineMode)
         {
@@ -88,14 +80,22 @@ namespace osu.Game.Skinning
 
         public class SpriteSelectorControl : SettingsDropdown<string>
         {
-            public SkinnableSprite Source { get; set; }
-
             protected override void LoadComplete()
             {
                 base.LoadComplete();
 
-                if (Source.AvailableFiles.Any())
-                    Items = Source.AvailableFiles;
+                // Round-about way of getting the user's skin to find available resources.
+                // In the future we'll probably want to allow access to resources from the fallbacks, or potentially other skins
+                // but that requires further thought.
+                var highestPrioritySkin = ((SkinnableSprite)Source).source.AllSources.First() as Skin;
+
+                string[] availableFiles = highestPrioritySkin?.SkinInfo.PerformRead(s => s.Files
+                                                                                          .Where(f => f.Filename.EndsWith(".png", StringComparison.Ordinal)
+                                                                                                      || f.Filename.EndsWith(".jpg", StringComparison.Ordinal))
+                                                                                          .Select(f => f.Filename).Distinct()).ToArray();
+
+                if (availableFiles?.Length > 0)
+                    Items = availableFiles;
             }
         }
     }

From bfd3406f5f69149a251112ce7f3d94ee81fecce0 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 1 Apr 2022 15:49:05 +0900
Subject: [PATCH 3853/5547] Ensure that file is imported and caches are
 invalidated before placing new sprites

---
 osu.Game/Skinning/Editor/SkinEditor.cs | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/osu.Game/Skinning/Editor/SkinEditor.cs b/osu.Game/Skinning/Editor/SkinEditor.cs
index d36806a1b3..df0bb7a70c 100644
--- a/osu.Game/Skinning/Editor/SkinEditor.cs
+++ b/osu.Game/Skinning/Editor/SkinEditor.cs
@@ -48,6 +48,9 @@ namespace osu.Game.Skinning.Editor
         [Resolved]
         private OsuColour colours { get; set; }
 
+        [Resolved]
+        private RealmAccess realm { get; set; }
+
         [Resolved(canBeNull: true)]
         private SkinEditorOverlay skinEditorOverlay { get; set; }
 
@@ -347,6 +350,11 @@ namespace osu.Game.Skinning.Editor
                         skins.AddFile(skinInfo, contents, file.Name);
                 });
 
+                // Even though we are 100% on an update thread, we need to wait for realm callbacks to fire (to correctly invalidate caches in RealmBackedResourceStore).
+                // See https://github.com/realm/realm-dotnet/discussions/2634#discussioncomment-2483573 for further discussion.
+                // This is the best we can do for now.
+                realm.Run(r => r.Refresh());
+
                 // place component
                 placeComponent(new SkinnableSprite
                 {

From 6afed5e865ff278970db643719f1377c8cb08660 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 1 Apr 2022 16:00:51 +0900
Subject: [PATCH 3854/5547] Fix new `SettingsItem` attribute not playing well
 with non-`Drawable`s

---
 osu.Game/Configuration/SettingSourceAttribute.cs | 2 +-
 osu.Game/Overlays/Settings/SettingsItem.cs       | 2 +-
 osu.Game/Skinning/SkinnableSprite.cs             | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Configuration/SettingSourceAttribute.cs b/osu.Game/Configuration/SettingSourceAttribute.cs
index 8c84707b88..89f0e73f4f 100644
--- a/osu.Game/Configuration/SettingSourceAttribute.cs
+++ b/osu.Game/Configuration/SettingSourceAttribute.cs
@@ -88,7 +88,7 @@ namespace osu.Game.Configuration
                         throw new InvalidOperationException($"{nameof(SettingSourceAttribute)} had an unsupported custom control type ({controlType.ReadableName()})");
 
                     var control = (Drawable)Activator.CreateInstance(controlType);
-                    controlType.GetProperty(nameof(SettingsItem<object>.Source))?.SetValue(control, obj);
+                    controlType.GetProperty(nameof(SettingsItem<object>.SettingSourceObject))?.SetValue(control, obj);
                     controlType.GetProperty(nameof(SettingsItem<object>.LabelText))?.SetValue(control, attr.Label);
                     controlType.GetProperty(nameof(SettingsItem<object>.TooltipText))?.SetValue(control, attr.Description);
                     controlType.GetProperty(nameof(SettingsItem<object>.Current))?.SetValue(control, value);
diff --git a/osu.Game/Overlays/Settings/SettingsItem.cs b/osu.Game/Overlays/Settings/SettingsItem.cs
index 6ac5351270..098090bf78 100644
--- a/osu.Game/Overlays/Settings/SettingsItem.cs
+++ b/osu.Game/Overlays/Settings/SettingsItem.cs
@@ -28,7 +28,7 @@ namespace osu.Game.Overlays.Settings
         /// <summary>
         /// The source component if this <see cref="SettingsItem{T}"/> was created via <see cref="SettingSourceAttribute"/>.
         /// </summary>
-        public Drawable Source { get; internal set; }
+        public object SettingSourceObject { get; internal set; }
 
         private IHasCurrentValue<T> controlWithCurrent => Control as IHasCurrentValue<T>;
 
diff --git a/osu.Game/Skinning/SkinnableSprite.cs b/osu.Game/Skinning/SkinnableSprite.cs
index 87490b4397..c6cc4c1bdd 100644
--- a/osu.Game/Skinning/SkinnableSprite.cs
+++ b/osu.Game/Skinning/SkinnableSprite.cs
@@ -87,7 +87,7 @@ namespace osu.Game.Skinning
                 // Round-about way of getting the user's skin to find available resources.
                 // In the future we'll probably want to allow access to resources from the fallbacks, or potentially other skins
                 // but that requires further thought.
-                var highestPrioritySkin = ((SkinnableSprite)Source).source.AllSources.First() as Skin;
+                var highestPrioritySkin = ((SkinnableSprite)SettingSourceObject).source.AllSources.First() as Skin;
 
                 string[] availableFiles = highestPrioritySkin?.SkinInfo.PerformRead(s => s.Files
                                                                                           .Where(f => f.Filename.EndsWith(".png", StringComparison.Ordinal)

From f0821ce1fc9ca72c3e1c1534e50ebd913e768a77 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 1 Apr 2022 16:16:49 +0900
Subject: [PATCH 3855/5547] Import new skin editor sprites to the cursor
 location

---
 osu.Game/Skinning/Editor/SkinEditor.cs        | 25 +++++++++++++------
 .../Skinning/Editor/SkinSelectionHandler.cs   |  8 +++---
 2 files changed, 21 insertions(+), 12 deletions(-)

diff --git a/osu.Game/Skinning/Editor/SkinEditor.cs b/osu.Game/Skinning/Editor/SkinEditor.cs
index df0bb7a70c..0208f109da 100644
--- a/osu.Game/Skinning/Editor/SkinEditor.cs
+++ b/osu.Game/Skinning/Editor/SkinEditor.cs
@@ -254,7 +254,7 @@ namespace osu.Game.Skinning.Editor
             placeComponent(component);
         }
 
-        private void placeComponent(ISkinnableDrawable component)
+        private void placeComponent(ISkinnableDrawable component, bool applyDefaults = true)
         {
             var targetContainer = getFirstTarget();
 
@@ -263,10 +263,13 @@ namespace osu.Game.Skinning.Editor
 
             var drawableComponent = (Drawable)component;
 
-            // give newly added components a sane starting location.
-            drawableComponent.Origin = Anchor.TopCentre;
-            drawableComponent.Anchor = Anchor.TopCentre;
-            drawableComponent.Y = targetContainer.DrawSize.Y / 2;
+            if (applyDefaults)
+            {
+                // give newly added components a sane starting location.
+                drawableComponent.Origin = Anchor.TopCentre;
+                drawableComponent.Anchor = Anchor.TopCentre;
+                drawableComponent.Y = targetContainer.DrawSize.Y / 2;
+            }
 
             targetContainer.Add(component);
 
@@ -356,10 +359,16 @@ namespace osu.Game.Skinning.Editor
                 realm.Run(r => r.Refresh());
 
                 // place component
-                placeComponent(new SkinnableSprite
+                var sprite = new SkinnableSprite
                 {
-                    SpriteName = { Value = file.Name }
-                });
+                    SpriteName = { Value = file.Name },
+                    Origin = Anchor.Centre,
+                    Position = getFirstTarget().ToLocalSpace(GetContainingInputManager().CurrentState.Mouse.Position),
+                };
+
+                placeComponent(sprite, false);
+
+                SkinSelectionHandler.ApplyClosestAnchor(sprite);
             });
 
             return Task.CompletedTask;
diff --git a/osu.Game/Skinning/Editor/SkinSelectionHandler.cs b/osu.Game/Skinning/Editor/SkinSelectionHandler.cs
index d7fb5c0498..943425e099 100644
--- a/osu.Game/Skinning/Editor/SkinSelectionHandler.cs
+++ b/osu.Game/Skinning/Editor/SkinSelectionHandler.cs
@@ -157,13 +157,13 @@ namespace osu.Game.Skinning.Editor
 
                 if (item.UsesFixedAnchor) continue;
 
-                applyClosestAnchor(drawable);
+                ApplyClosestAnchor(drawable);
             }
 
             return true;
         }
 
-        private static void applyClosestAnchor(Drawable drawable) => applyAnchor(drawable, getClosestAnchor(drawable));
+        public static void ApplyClosestAnchor(Drawable drawable) => applyAnchor(drawable, getClosestAnchor(drawable));
 
         protected override void OnSelectionChanged()
         {
@@ -252,7 +252,7 @@ namespace osu.Game.Skinning.Editor
 
                 if (item.UsesFixedAnchor) continue;
 
-                applyClosestAnchor(drawable);
+                ApplyClosestAnchor(drawable);
             }
         }
 
@@ -279,7 +279,7 @@ namespace osu.Game.Skinning.Editor
             foreach (var item in SelectedItems)
             {
                 item.UsesFixedAnchor = false;
-                applyClosestAnchor((Drawable)item);
+                ApplyClosestAnchor((Drawable)item);
             }
         }
 

From 01681ee8749c3562672e20fe603597c39a467410 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 1 Apr 2022 16:19:00 +0900
Subject: [PATCH 3856/5547] Add missing `ToArray` call

Not sure where this went, was there in my original commit.
---
 osu.Game/Skinning/SkinManager.cs | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Skinning/SkinManager.cs b/osu.Game/Skinning/SkinManager.cs
index 44b9c69794..832cb01d22 100644
--- a/osu.Game/Skinning/SkinManager.cs
+++ b/osu.Game/Skinning/SkinManager.cs
@@ -145,10 +145,10 @@ namespace osu.Game.Skinning
                 if (!s.Protected)
                     return;
 
-                var existingSkinNames = realm.Run(r => r.All<SkinInfo>()
-                                                        .Where(skin => !skin.DeletePending)
-                                                        .AsEnumerable()
-                                                        .Select(skin => skin.Name));
+                string[] existingSkinNames = realm.Run(r => r.All<SkinInfo>()
+                                                             .Where(skin => !skin.DeletePending)
+                                                             .AsEnumerable()
+                                                             .Select(skin => skin.Name)).ToArray();
 
                 // if the user is attempting to save one of the default skin implementations, create a copy first.
                 var skinInfo = new SkinInfo

From fc3ebe9b510d34b5d75aae931076328b09851d9d Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 1 Apr 2022 10:40:16 +0300
Subject: [PATCH 3857/5547] Reword log retrieval steps on mobile platforms

Co-authored-by: Dean Herbert <pe@ppy.sh>
---
 .github/ISSUE_TEMPLATE/bug-issue.yml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/ISSUE_TEMPLATE/bug-issue.yml b/.github/ISSUE_TEMPLATE/bug-issue.yml
index ea5ee298fb..91ca622f55 100644
--- a/.github/ISSUE_TEMPLATE/bug-issue.yml
+++ b/.github/ISSUE_TEMPLATE/bug-issue.yml
@@ -65,8 +65,8 @@ body:
         ### Mobile platforms
 
         The places to find the logs on mobile platforms are as follows:
-          - `Android/data/sh.ppy.osulazer/files/logs` *on Android*
-          - *On iOS*, they can be obtained by connecting your device to your desktop and copying the `logs` directory from the app's own document storage using iTunes. (https://support.apple.com/en-us/HT201301#copy-to-computer)
+          - *On Android*, navigate to `Android/data/sh.ppy.osulazer/files/logs` using a file browser app.
+          - *On iOS*, connect your device to a PC and copy the `logs` directory from the app's document storage using iTunes. (https://support.apple.com/en-us/HT201301#copy-to-computer)
 
         ---
 

From 37dea0ff211db68d591a98a008cc3e4c76879ebb Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 1 Apr 2022 17:05:11 +0900
Subject: [PATCH 3858/5547] Add failing test case

---
 .../TestSceneMultiplayerPlaylist.cs           | 37 +++++++++++++++++--
 1 file changed, 33 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs
index cbd8b472b8..f8c0939ea9 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs
@@ -2,6 +2,7 @@
 // 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;
@@ -13,6 +14,7 @@ using osu.Framework.Testing;
 using osu.Game.Beatmaps;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.UserInterface;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Rooms;
 using osu.Game.Rulesets;
@@ -183,14 +185,41 @@ namespace osu.Game.Tests.Visual.Multiplayer
             assertItemInHistoryListStep(2, 0);
         }
 
+        [Test]
+        public void TestInsertedItemDoesNotRefreshAllOthers()
+        {
+            AddStep("change to round robin queue mode", () => MultiplayerClient.ChangeSettings(new MultiplayerRoomSettings { QueueMode = QueueMode.AllPlayersRoundRobin }).WaitSafely());
+
+            // Add a few items for the local user.
+            addItemStep();
+            addItemStep();
+            addItemStep();
+            addItemStep();
+            addItemStep();
+
+            DrawableRoomPlaylistItem[] drawableItems = null;
+            AddStep("get drawable items", () => drawableItems = this.ChildrenOfType<DrawableRoomPlaylistItem>().ToArray());
+
+            // Add 1 item for another user.
+            AddStep("join second user", () => MultiplayerClient.AddUser(new APIUser { Id = 10 }));
+            addItemStep(userId: 10);
+
+            // New item inserted towards the top of the list.
+            assertItemInQueueListStep(7, 1);
+            AddAssert("all previous playlist items remained", () => drawableItems.All(this.ChildrenOfType<DrawableRoomPlaylistItem>().Contains));
+        }
+
         /// <summary>
         /// Adds a step to create a new playlist item.
         /// </summary>
-        private void addItemStep(bool expired = false) => AddStep("add item", () => MultiplayerClient.AddPlaylistItem(new MultiplayerPlaylistItem(new PlaylistItem(importedBeatmap)
+        private void addItemStep(bool expired = false, int? userId = null) => AddStep("add item", () =>
         {
-            Expired = expired,
-            PlayedAt = DateTimeOffset.Now
-        })));
+            MultiplayerClient.AddUserPlaylistItem(userId ?? API.LocalUser.Value.OnlineID, new MultiplayerPlaylistItem(new PlaylistItem(importedBeatmap)
+            {
+                Expired = expired,
+                PlayedAt = DateTimeOffset.Now
+            })).WaitSafely();
+        });
 
         /// <summary>
         /// Asserts the position of a given playlist item in the queue list.

From 16d4544ff9b4ca72fcd0899c9cd56a1a92f91246 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 1 Apr 2022 17:06:37 +0900
Subject: [PATCH 3859/5547] Prevent reloads when playlist item order changes

---
 osu.Game/Online/Rooms/PlaylistItem.cs         |  6 ++++--
 .../Match/Playlist/MultiplayerPlaylist.cs     | 20 +++++++++++++++++--
 2 files changed, 22 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Online/Rooms/PlaylistItem.cs b/osu.Game/Online/Rooms/PlaylistItem.cs
index f696362cbb..a56851cfe6 100644
--- a/osu.Game/Online/Rooms/PlaylistItem.cs
+++ b/osu.Game/Online/Rooms/PlaylistItem.cs
@@ -11,6 +11,7 @@ using osu.Framework.Bindables;
 using osu.Game.Beatmaps;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests.Responses;
+using osu.Game.Utils;
 
 namespace osu.Game.Online.Rooms
 {
@@ -101,13 +102,13 @@ namespace osu.Game.Online.Rooms
 
         #endregion
 
-        public PlaylistItem With(IBeatmapInfo beatmap) => new PlaylistItem(beatmap)
+        public PlaylistItem With(Optional<IBeatmapInfo> beatmap = default, Optional<ushort?> playlistOrder = default) => new PlaylistItem(beatmap.GetOr(Beatmap))
         {
             ID = ID,
             OwnerID = OwnerID,
             RulesetID = RulesetID,
             Expired = Expired,
-            PlaylistOrder = PlaylistOrder,
+            PlaylistOrder = playlistOrder.GetOr(PlaylistOrder),
             PlayedAt = PlayedAt,
             AllowedMods = AllowedMods,
             RequiredMods = RequiredMods,
@@ -119,6 +120,7 @@ namespace osu.Game.Online.Rooms
                && Beatmap.OnlineID == other.Beatmap.OnlineID
                && RulesetID == other.RulesetID
                && Expired == other.Expired
+               && PlaylistOrder == other.PlaylistOrder
                && AllowedMods.SequenceEqual(other.AllowedMods)
                && RequiredMods.SequenceEqual(other.RequiredMods);
     }
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylist.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylist.cs
index 879a21e7c1..41f548a630 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylist.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylist.cs
@@ -117,8 +117,24 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist
         {
             base.PlaylistItemChanged(item);
 
-            removeItemFromLists(item.ID);
-            addItemToLists(item);
+            var newApiItem = Playlist.SingleOrDefault(i => i.ID == item.ID);
+            var existingApiItemInQueue = queueList.Items.SingleOrDefault(i => i.ID == item.ID);
+
+            // Test if the only change between the two playlist items is the order.
+            if (newApiItem != null && existingApiItemInQueue != null && existingApiItemInQueue.With(playlistOrder: newApiItem.PlaylistOrder).Equals(newApiItem))
+            {
+                // Set the new playlist order directly without refreshing the DrawablePlaylistItem.
+                existingApiItemInQueue.PlaylistOrder = newApiItem.PlaylistOrder;
+
+                // The following isn't really required, but is here for safety and explicitness.
+                // MultiplayerQueueList internally binds to changes in Playlist to invalidate its own layout, which is mutated on every playlist operation.
+                queueList.Invalidate();
+            }
+            else
+            {
+                removeItemFromLists(item.ID);
+                addItemToLists(item);
+            }
         }
 
         private void addItemToLists(MultiplayerPlaylistItem item)

From 6e6271d0c0ac4e00b0b2fd18b124e3cd4a0a6ca2 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 1 Apr 2022 18:31:17 +0900
Subject: [PATCH 3860/5547] Fix "server-side" room playlist not updated

Remove unused using
---
 .../TestSceneMultiplayerPlaylist.cs           |  1 -
 osu.Game/Online/Rooms/PlaylistItem.cs         | 13 ++++++++
 .../Multiplayer/TestMultiplayerClient.cs      | 33 +++++++++++++++----
 3 files changed, 39 insertions(+), 8 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs
index f8c0939ea9..1231866b36 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.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 NUnit.Framework;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Online/Rooms/PlaylistItem.cs b/osu.Game/Online/Rooms/PlaylistItem.cs
index a56851cfe6..6ec884d79c 100644
--- a/osu.Game/Online/Rooms/PlaylistItem.cs
+++ b/osu.Game/Online/Rooms/PlaylistItem.cs
@@ -85,6 +85,19 @@ namespace osu.Game.Online.Rooms
             Beatmap = beatmap;
         }
 
+        public PlaylistItem(MultiplayerPlaylistItem item)
+            : this(new APIBeatmap { OnlineID = item.BeatmapID })
+        {
+            ID = item.ID;
+            OwnerID = item.OwnerID;
+            RulesetID = item.RulesetID;
+            Expired = item.Expired;
+            PlaylistOrder = item.PlaylistOrder;
+            PlayedAt = item.PlayedAt;
+            RequiredMods = item.RequiredMods.ToArray();
+            AllowedMods = item.AllowedMods.ToArray();
+        }
+
         public void MarkInvalid() => valid.Value = false;
 
         #region Newtonsoft.Json implicit ShouldSerialize() methods
diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
index b9304f713d..0efaf16f99 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
@@ -31,7 +31,11 @@ namespace osu.Game.Tests.Visual.Multiplayer
         public override IBindable<bool> IsConnected => isConnected;
         private readonly Bindable<bool> isConnected = new Bindable<bool>(true);
 
+        /// <summary>
+        /// The local client's <see cref="Room"/>. This is not always equivalent to the server-side room.
+        /// </summary>
         public new Room? APIRoom => base.APIRoom;
+
         public Action<MultiplayerRoom>? RoomSetupAction;
 
         public bool RoomJoined { get; private set; }
@@ -46,6 +50,11 @@ namespace osu.Game.Tests.Visual.Multiplayer
         /// </summary>
         private readonly List<MultiplayerPlaylistItem> serverSidePlaylist = new List<MultiplayerPlaylistItem>();
 
+        /// <summary>
+        /// Guaranteed up-to-date API room.
+        /// </summary>
+        private Room? serverSideAPIRoom;
+
         private MultiplayerPlaylistItem? currentItem => Room?.Playlist[currentIndex];
         private int currentIndex;
         private long lastPlaylistItemId;
@@ -192,13 +201,13 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
         protected override async Task<MultiplayerRoom> JoinRoom(long roomId, string? password = null)
         {
-            var apiRoom = roomManager.ServerSideRooms.Single(r => r.RoomID.Value == roomId);
+            serverSideAPIRoom = roomManager.ServerSideRooms.Single(r => r.RoomID.Value == roomId);
 
-            if (password != apiRoom.Password.Value)
+            if (password != serverSideAPIRoom.Password.Value)
                 throw new InvalidOperationException("Invalid password.");
 
             serverSidePlaylist.Clear();
-            serverSidePlaylist.AddRange(apiRoom.Playlist.Select(item => new MultiplayerPlaylistItem(item)));
+            serverSidePlaylist.AddRange(serverSideAPIRoom.Playlist.Select(item => new MultiplayerPlaylistItem(item)));
             lastPlaylistItemId = serverSidePlaylist.Max(item => item.ID);
 
             var localUser = new MultiplayerRoomUser(api.LocalUser.Value.Id)
@@ -210,11 +219,11 @@ namespace osu.Game.Tests.Visual.Multiplayer
             {
                 Settings =
                 {
-                    Name = apiRoom.Name.Value,
-                    MatchType = apiRoom.Type.Value,
+                    Name = serverSideAPIRoom.Name.Value,
+                    MatchType = serverSideAPIRoom.Type.Value,
                     Password = password,
-                    QueueMode = apiRoom.QueueMode.Value,
-                    AutoStartDuration = apiRoom.AutoStartDuration.Value
+                    QueueMode = serverSideAPIRoom.QueueMode.Value,
+                    AutoStartDuration = serverSideAPIRoom.AutoStartDuration.Value
                 },
                 Playlist = serverSidePlaylist.ToList(),
                 Users = { localUser },
@@ -479,6 +488,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             Debug.Assert(Room != null);
             Debug.Assert(APIRoom != null);
+            Debug.Assert(serverSideAPIRoom != null);
 
             var item = serverSidePlaylist.Find(i => i.ID == playlistItemId);
 
@@ -495,6 +505,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 throw new InvalidOperationException("Attempted to remove an item which has already been played.");
 
             serverSidePlaylist.Remove(item);
+            serverSideAPIRoom.Playlist.RemoveAll(i => i.ID == item.ID);
             await ((IMultiplayerClient)this).PlaylistItemRemoved(playlistItemId).ConfigureAwait(false);
 
             await updateCurrentItem(Room).ConfigureAwait(false);
@@ -576,10 +587,12 @@ namespace osu.Game.Tests.Visual.Multiplayer
         private async Task addItem(MultiplayerPlaylistItem item)
         {
             Debug.Assert(Room != null);
+            Debug.Assert(serverSideAPIRoom != null);
 
             item.ID = ++lastPlaylistItemId;
 
             serverSidePlaylist.Add(item);
+            serverSideAPIRoom.Playlist.Add(new PlaylistItem(item));
             await ((IMultiplayerClient)this).PlaylistItemAdded(item).ConfigureAwait(false);
 
             await updatePlaylistOrder(Room).ConfigureAwait(false);
@@ -603,6 +616,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
         private async Task updatePlaylistOrder(MultiplayerRoom room)
         {
+            Debug.Assert(serverSideAPIRoom != null);
+
             List<MultiplayerPlaylistItem> orderedActiveItems;
 
             switch (room.Settings.QueueMode)
@@ -648,6 +663,10 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
                 await ((IMultiplayerClient)this).PlaylistItemChanged(item).ConfigureAwait(false);
             }
+
+            // Also ensure that the API room's playlist is correct.
+            foreach (var item in serverSideAPIRoom.Playlist)
+                item.PlaylistOrder = serverSidePlaylist.Single(i => i.ID == item.ID).PlaylistOrder;
         }
     }
 }

From 43d03f28255858659aac9c2f5078593ba0ecfd24 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 1 Apr 2022 19:30:16 +0900
Subject: [PATCH 3861/5547] Put `ToArray` call in correct place in brackets

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

diff --git a/osu.Game/Skinning/SkinManager.cs b/osu.Game/Skinning/SkinManager.cs
index 832cb01d22..71920fb166 100644
--- a/osu.Game/Skinning/SkinManager.cs
+++ b/osu.Game/Skinning/SkinManager.cs
@@ -148,7 +148,7 @@ namespace osu.Game.Skinning
                 string[] existingSkinNames = realm.Run(r => r.All<SkinInfo>()
                                                              .Where(skin => !skin.DeletePending)
                                                              .AsEnumerable()
-                                                             .Select(skin => skin.Name)).ToArray();
+                                                             .Select(skin => skin.Name).ToArray());
 
                 // if the user is attempting to save one of the default skin implementations, create a copy first.
                 var skinInfo = new SkinInfo

From 0f4b75ab15241c71ac89389a19586cd04ee821b7 Mon Sep 17 00:00:00 2001
From: Jamie Taylor <me@nekodex.net>
Date: Fri, 1 Apr 2022 21:33:57 +0900
Subject: [PATCH 3862/5547] Add multiplayer lobby countdown SFX

---
 .../Match/MultiplayerReadyButton.cs           | 23 +++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
index 62be9ad3bd..8068e80534 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
@@ -5,6 +5,8 @@ using System;
 using System.Linq;
 using JetBrains.Annotations;
 using osu.Framework.Allocation;
+using osu.Framework.Audio;
+using osu.Framework.Audio.Sample;
 using osu.Framework.Localisation;
 using osu.Framework.Threading;
 using osu.Game.Graphics;
@@ -27,6 +29,17 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
         [CanBeNull]
         private MultiplayerRoom room => multiplayerClient.Room;
 
+        private Sample countdownTickSample;
+        private Sample countdownTickFinalSample;
+        private int? lastTickPlayed;
+
+        [BackgroundDependencyLoader]
+        private void load(AudioManager audio)
+        {
+            countdownTickSample = audio.Samples.Get(@"Multiplayer/countdown-tick");
+            countdownTickFinalSample = audio.Samples.Get(@"Multiplayer/countdown-tick-final");
+        }
+
         protected override void LoadComplete()
         {
             base.LoadComplete();
@@ -83,6 +96,16 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
                 else
                     countdownRemaining = countdown.TimeRemaining - timeElapsed;
 
+                if (countdownRemaining.Seconds <= 10 && (lastTickPlayed == null || lastTickPlayed != countdownRemaining.Seconds))
+                {
+                    countdownTickSample?.Play();
+
+                    if (countdownRemaining.Seconds <= 3)
+                        countdownTickFinalSample?.Play();
+
+                    lastTickPlayed = countdownRemaining.Seconds;
+                }
+
                 string countdownText = $"Starting in {countdownRemaining:mm\\:ss}";
 
                 switch (localUser?.State)

From b07152a119d3df101600ff18356c476ffdce9326 Mon Sep 17 00:00:00 2001
From: CenTdemeern1 <timo.herngreen@gmail.com>
Date: Sat, 2 Apr 2022 02:35:37 +0200
Subject: [PATCH 3863/5547] Initial attempt at writing a test for the
 toolbarClock

I'll add more once I know if this code passes review or not
---
 .../Visual/Menus/TestSceneToolbarClock.cs     | 20 ++++++++++++++++++-
 1 file changed, 19 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/Menus/TestSceneToolbarClock.cs b/osu.Game.Tests/Visual/Menus/TestSceneToolbarClock.cs
index 064d6f82fd..0b5904aa2b 100644
--- a/osu.Game.Tests/Visual/Menus/TestSceneToolbarClock.cs
+++ b/osu.Game.Tests/Visual/Menus/TestSceneToolbarClock.cs
@@ -16,6 +16,7 @@ namespace osu.Game.Tests.Visual.Menus
     public class TestSceneToolbarClock : OsuManualInputManagerTestScene
     {
         private readonly Container mainContainer;
+        private readonly ToolbarClock toolbarClock;
 
         public TestSceneToolbarClock()
         {
@@ -49,7 +50,7 @@ namespace osu.Game.Tests.Visual.Menus
                                     RelativeSizeAxes = Axes.Y,
                                     Width = 2,
                                 },
-                                new ToolbarClock(),
+                                toolbarClock = new ToolbarClock(),
                                 new Box
                                 {
                                     Colour = Color4.DarkRed,
@@ -76,5 +77,22 @@ namespace osu.Game.Tests.Visual.Menus
         {
             AddStep("Set game time long", () => mainContainer.Clock = new FramedOffsetClock(Clock, false) { Offset = 3600.0 * 24 * 1000 * 98 });
         }
+
+        [Test]
+        public void TestHoverBackground()
+        {
+            Box hoverBackground = null;
+
+            AddStep("Retrieve hover background", () => hoverBackground = (Box)toolbarClock.Children[0]);
+
+            AddStep("Move mouse away from clock", () => InputManager.MoveMouseTo(mainContainer, new Vector2(0,200)));
+            AddAssert("Hover background is not visible", () => hoverBackground.Alpha == 0);
+
+            AddStep("Move mouse on top of clock", () => InputManager.MoveMouseTo(mainContainer));
+            AddAssert("Hover background is visible", () => hoverBackground.Alpha != 0);
+            
+            AddStep("Move mouse away from clock", () => InputManager.MoveMouseTo(mainContainer, new Vector2(0,200)));
+            AddUntilStep("Hover background is not visible", () => hoverBackground.Alpha == 0);
+        }
     }
 }

From 6685c97147a92e71fa27b8632a69ae592ad535f4 Mon Sep 17 00:00:00 2001
From: CenTdemeern1 <timo.herngreen@gmail.com>
Date: Sat, 2 Apr 2022 02:43:44 +0200
Subject: [PATCH 3864/5547] mainContainer -> toolbarClock

---
 osu.Game.Tests/Visual/Menus/TestSceneToolbarClock.cs | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Tests/Visual/Menus/TestSceneToolbarClock.cs b/osu.Game.Tests/Visual/Menus/TestSceneToolbarClock.cs
index 0b5904aa2b..a17e4030ff 100644
--- a/osu.Game.Tests/Visual/Menus/TestSceneToolbarClock.cs
+++ b/osu.Game.Tests/Visual/Menus/TestSceneToolbarClock.cs
@@ -85,13 +85,13 @@ namespace osu.Game.Tests.Visual.Menus
 
             AddStep("Retrieve hover background", () => hoverBackground = (Box)toolbarClock.Children[0]);
 
-            AddStep("Move mouse away from clock", () => InputManager.MoveMouseTo(mainContainer, new Vector2(0,200)));
+            AddStep("Move mouse away from clock", () => InputManager.MoveMouseTo(toolbarClock, new Vector2(0,200)));
             AddAssert("Hover background is not visible", () => hoverBackground.Alpha == 0);
 
-            AddStep("Move mouse on top of clock", () => InputManager.MoveMouseTo(mainContainer));
+            AddStep("Move mouse on top of clock", () => InputManager.MoveMouseTo(toolbarClock));
             AddAssert("Hover background is visible", () => hoverBackground.Alpha != 0);
-            
-            AddStep("Move mouse away from clock", () => InputManager.MoveMouseTo(mainContainer, new Vector2(0,200)));
+
+            AddStep("Move mouse away from clock", () => InputManager.MoveMouseTo(toolbarClock, new Vector2(0,200)));
             AddUntilStep("Hover background is not visible", () => hoverBackground.Alpha == 0);
         }
     }

From dc744f18ff7700d1cadd4ac9ad7cfa883a3ecabc Mon Sep 17 00:00:00 2001
From: CenTdemeern1 <timo.herngreen@gmail.com>
Date: Sat, 2 Apr 2022 02:43:51 +0200
Subject: [PATCH 3865/5547] Trim whitespace

---
 osu.Game.Tests/Visual/Menus/TestSceneToolbarClock.cs | 2 --
 1 file changed, 2 deletions(-)

diff --git a/osu.Game.Tests/Visual/Menus/TestSceneToolbarClock.cs b/osu.Game.Tests/Visual/Menus/TestSceneToolbarClock.cs
index a17e4030ff..b20ec7cbe5 100644
--- a/osu.Game.Tests/Visual/Menus/TestSceneToolbarClock.cs
+++ b/osu.Game.Tests/Visual/Menus/TestSceneToolbarClock.cs
@@ -87,10 +87,8 @@ namespace osu.Game.Tests.Visual.Menus
 
             AddStep("Move mouse away from clock", () => InputManager.MoveMouseTo(toolbarClock, new Vector2(0,200)));
             AddAssert("Hover background is not visible", () => hoverBackground.Alpha == 0);
-
             AddStep("Move mouse on top of clock", () => InputManager.MoveMouseTo(toolbarClock));
             AddAssert("Hover background is visible", () => hoverBackground.Alpha != 0);
-
             AddStep("Move mouse away from clock", () => InputManager.MoveMouseTo(toolbarClock, new Vector2(0,200)));
             AddUntilStep("Hover background is not visible", () => hoverBackground.Alpha == 0);
         }

From 9350f6f5f841684c70864ea64b059e29b0001f95 Mon Sep 17 00:00:00 2001
From: CenTdemeern1 <timo.herngreen@gmail.com>
Date: Sat, 2 Apr 2022 02:59:07 +0200
Subject: [PATCH 3866/5547] Add spaces around commas in Vector2 construction

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

diff --git a/osu.Game.Tests/Visual/Menus/TestSceneToolbarClock.cs b/osu.Game.Tests/Visual/Menus/TestSceneToolbarClock.cs
index b20ec7cbe5..df61e56011 100644
--- a/osu.Game.Tests/Visual/Menus/TestSceneToolbarClock.cs
+++ b/osu.Game.Tests/Visual/Menus/TestSceneToolbarClock.cs
@@ -85,11 +85,11 @@ namespace osu.Game.Tests.Visual.Menus
 
             AddStep("Retrieve hover background", () => hoverBackground = (Box)toolbarClock.Children[0]);
 
-            AddStep("Move mouse away from clock", () => InputManager.MoveMouseTo(toolbarClock, new Vector2(0,200)));
+            AddStep("Move mouse away from clock", () => InputManager.MoveMouseTo(toolbarClock, new Vector2(0, 200)));
             AddAssert("Hover background is not visible", () => hoverBackground.Alpha == 0);
             AddStep("Move mouse on top of clock", () => InputManager.MoveMouseTo(toolbarClock));
             AddAssert("Hover background is visible", () => hoverBackground.Alpha != 0);
-            AddStep("Move mouse away from clock", () => InputManager.MoveMouseTo(toolbarClock, new Vector2(0,200)));
+            AddStep("Move mouse away from clock", () => InputManager.MoveMouseTo(toolbarClock, new Vector2(0, 200)));
             AddUntilStep("Hover background is not visible", () => hoverBackground.Alpha == 0);
         }
     }

From 95ccac50d4c1f2dfbeefbea492f69f3b06979830 Mon Sep 17 00:00:00 2001
From: CenTdemeern1 <timo.herngreen@gmail.com>
Date: Sat, 2 Apr 2022 04:26:16 +0200
Subject: [PATCH 3867/5547] Add display mode changing test

Yup this is gonna fail horribly
---
 .../Visual/Menus/TestSceneToolbarClock.cs     | 28 +++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/osu.Game.Tests/Visual/Menus/TestSceneToolbarClock.cs b/osu.Game.Tests/Visual/Menus/TestSceneToolbarClock.cs
index df61e56011..7643e5032b 100644
--- a/osu.Game.Tests/Visual/Menus/TestSceneToolbarClock.cs
+++ b/osu.Game.Tests/Visual/Menus/TestSceneToolbarClock.cs
@@ -2,10 +2,13 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using NUnit.Framework;
+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.Timing;
+using osu.Game.Configuration;
 using osu.Game.Overlays.Toolbar;
 using osuTK;
 using osuTK.Graphics;
@@ -15,6 +18,8 @@ namespace osu.Game.Tests.Visual.Menus
     [TestFixture]
     public class TestSceneToolbarClock : OsuManualInputManagerTestScene
     {
+        private Bindable<ToolbarClockDisplayMode> clockDisplayMode;
+
         private readonly Container mainContainer;
         private readonly ToolbarClock toolbarClock;
 
@@ -66,6 +71,12 @@ namespace osu.Game.Tests.Visual.Menus
             AddSliderStep("scale", 0.5, 4, 1, scale => mainContainer.Scale = new Vector2((float)scale));
         }
 
+        [BackgroundDependencyLoader]
+        private void load(OsuConfigManager config)
+        {
+            clockDisplayMode = config.GetBindable<ToolbarClockDisplayMode>(OsuSetting.ToolbarClockDisplayMode);
+        }
+
         [Test]
         public void TestRealGameTime()
         {
@@ -92,5 +103,22 @@ namespace osu.Game.Tests.Visual.Menus
             AddStep("Move mouse away from clock", () => InputManager.MoveMouseTo(toolbarClock, new Vector2(0, 200)));
             AddUntilStep("Hover background is not visible", () => hoverBackground.Alpha == 0);
         }
+
+        [Test]
+        public void TestDisplayModeChange()
+        {
+            ToolbarClockDisplayMode initialDisplayMode = 0;
+
+            AddStep("Retrieve current state", () => initialDisplayMode = (ToolbarClockDisplayMode)clockDisplayMode.Value);
+
+            AddStep("Trigger click", () => toolbarClock.TriggerClick());
+            AddAssert("State changed from initial", () => clockDisplayMode.Value != initialDisplayMode);
+            AddStep("Trigger click", () => toolbarClock.TriggerClick());
+            AddAssert("State changed from initial", () => clockDisplayMode.Value != initialDisplayMode);
+            AddStep("Trigger click", () => toolbarClock.TriggerClick());
+            AddAssert("State changed from initial", () => clockDisplayMode.Value != initialDisplayMode);
+            AddStep("Trigger click", () => toolbarClock.TriggerClick());
+            AddAssert("State is equal to initial", () => clockDisplayMode.Value == initialDisplayMode);
+        }
     }
 }

From 245e452d41fcc2af69007f36f1f33122f2805bd5 Mon Sep 17 00:00:00 2001
From: CenTdemeern1 <timo.herngreen@gmail.com>
Date: Sat, 2 Apr 2022 04:31:43 +0200
Subject: [PATCH 3868/5547] Remove redundant typecast I accidentally left in
 (Thanks InspectCode)

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

diff --git a/osu.Game.Tests/Visual/Menus/TestSceneToolbarClock.cs b/osu.Game.Tests/Visual/Menus/TestSceneToolbarClock.cs
index 7643e5032b..c1b8cd919d 100644
--- a/osu.Game.Tests/Visual/Menus/TestSceneToolbarClock.cs
+++ b/osu.Game.Tests/Visual/Menus/TestSceneToolbarClock.cs
@@ -109,7 +109,7 @@ namespace osu.Game.Tests.Visual.Menus
         {
             ToolbarClockDisplayMode initialDisplayMode = 0;
 
-            AddStep("Retrieve current state", () => initialDisplayMode = (ToolbarClockDisplayMode)clockDisplayMode.Value);
+            AddStep("Retrieve current state", () => initialDisplayMode = clockDisplayMode.Value);
 
             AddStep("Trigger click", () => toolbarClock.TriggerClick());
             AddAssert("State changed from initial", () => clockDisplayMode.Value != initialDisplayMode);

From ee9696855ba9e1098d33353179f903283a2cb69a Mon Sep 17 00:00:00 2001
From: CenTdemeern1 <timo.herngreen@gmail.com>
Date: Sat, 2 Apr 2022 04:41:05 +0200
Subject: [PATCH 3869/5547] Remove hover test

---
 .../Visual/Menus/TestSceneToolbarClock.cs         | 15 ---------------
 1 file changed, 15 deletions(-)

diff --git a/osu.Game.Tests/Visual/Menus/TestSceneToolbarClock.cs b/osu.Game.Tests/Visual/Menus/TestSceneToolbarClock.cs
index c1b8cd919d..269b3cbad0 100644
--- a/osu.Game.Tests/Visual/Menus/TestSceneToolbarClock.cs
+++ b/osu.Game.Tests/Visual/Menus/TestSceneToolbarClock.cs
@@ -89,21 +89,6 @@ namespace osu.Game.Tests.Visual.Menus
             AddStep("Set game time long", () => mainContainer.Clock = new FramedOffsetClock(Clock, false) { Offset = 3600.0 * 24 * 1000 * 98 });
         }
 
-        [Test]
-        public void TestHoverBackground()
-        {
-            Box hoverBackground = null;
-
-            AddStep("Retrieve hover background", () => hoverBackground = (Box)toolbarClock.Children[0]);
-
-            AddStep("Move mouse away from clock", () => InputManager.MoveMouseTo(toolbarClock, new Vector2(0, 200)));
-            AddAssert("Hover background is not visible", () => hoverBackground.Alpha == 0);
-            AddStep("Move mouse on top of clock", () => InputManager.MoveMouseTo(toolbarClock));
-            AddAssert("Hover background is visible", () => hoverBackground.Alpha != 0);
-            AddStep("Move mouse away from clock", () => InputManager.MoveMouseTo(toolbarClock, new Vector2(0, 200)));
-            AddUntilStep("Hover background is not visible", () => hoverBackground.Alpha == 0);
-        }
-
         [Test]
         public void TestDisplayModeChange()
         {

From a1baced7774603a400e74c191ec6f3811a66f728 Mon Sep 17 00:00:00 2001
From: CenTdemeern1 <timo.herngreen@gmail.com>
Date: Sat, 2 Apr 2022 04:45:21 +0200
Subject: [PATCH 3870/5547] Change behavior of the display mode test

I remembered to run InspectCode this time, all good
---
 osu.Game.Tests/Visual/Menus/TestSceneToolbarClock.cs | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Tests/Visual/Menus/TestSceneToolbarClock.cs b/osu.Game.Tests/Visual/Menus/TestSceneToolbarClock.cs
index 269b3cbad0..2cf73f5442 100644
--- a/osu.Game.Tests/Visual/Menus/TestSceneToolbarClock.cs
+++ b/osu.Game.Tests/Visual/Menus/TestSceneToolbarClock.cs
@@ -92,12 +92,10 @@ namespace osu.Game.Tests.Visual.Menus
         [Test]
         public void TestDisplayModeChange()
         {
-            ToolbarClockDisplayMode initialDisplayMode = 0;
-
-            AddStep("Retrieve current state", () => initialDisplayMode = clockDisplayMode.Value);
+            AddStep("Set clock display mode", () => clockDisplayMode.Value = ToolbarClockDisplayMode.Full);
 
             AddStep("Trigger click", () => toolbarClock.TriggerClick());
-            AddAssert("State changed from initial", () => clockDisplayMode.Value != initialDisplayMode);
+            AddAssert("State is digital with runtime", () => clockDisplayMode.Value == ToolbarClockDisplayMode.DigitalWithRuntime);
             AddStep("Trigger click", () => toolbarClock.TriggerClick());
             AddAssert("State changed from initial", () => clockDisplayMode.Value != initialDisplayMode);
             AddStep("Trigger click", () => toolbarClock.TriggerClick());

From c103cee1d5dce8e5b157f594ebc9c9af0825363e Mon Sep 17 00:00:00 2001
From: CenTdemeern1 <timo.herngreen@gmail.com>
Date: Sat, 2 Apr 2022 04:53:47 +0200
Subject: [PATCH 3871/5547] Need to commit the second half again because my Git
 UI messed up

---
 osu.Game.Tests/Visual/Menus/TestSceneToolbarClock.cs | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Tests/Visual/Menus/TestSceneToolbarClock.cs b/osu.Game.Tests/Visual/Menus/TestSceneToolbarClock.cs
index 2cf73f5442..87d836687f 100644
--- a/osu.Game.Tests/Visual/Menus/TestSceneToolbarClock.cs
+++ b/osu.Game.Tests/Visual/Menus/TestSceneToolbarClock.cs
@@ -97,11 +97,11 @@ namespace osu.Game.Tests.Visual.Menus
             AddStep("Trigger click", () => toolbarClock.TriggerClick());
             AddAssert("State is digital with runtime", () => clockDisplayMode.Value == ToolbarClockDisplayMode.DigitalWithRuntime);
             AddStep("Trigger click", () => toolbarClock.TriggerClick());
-            AddAssert("State changed from initial", () => clockDisplayMode.Value != initialDisplayMode);
+            AddAssert("State is digital", () => clockDisplayMode.Value == ToolbarClockDisplayMode.Digital);
             AddStep("Trigger click", () => toolbarClock.TriggerClick());
-            AddAssert("State changed from initial", () => clockDisplayMode.Value != initialDisplayMode);
+            AddAssert("State is analog", () => clockDisplayMode.Value == ToolbarClockDisplayMode.Analog);
             AddStep("Trigger click", () => toolbarClock.TriggerClick());
-            AddAssert("State is equal to initial", () => clockDisplayMode.Value == initialDisplayMode);
+            AddAssert("State is full", () => clockDisplayMode.Value == ToolbarClockDisplayMode.Full);
         }
     }
 }

From a252c4cad57cae5472adb69101e288e46ab2c18c Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sat, 2 Apr 2022 18:08:23 +0300
Subject: [PATCH 3872/5547] Add random pass/play count data in test scene

---
 .../Visual/Online/TestSceneBeatmapSetOverlaySuccessRate.cs    | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlaySuccessRate.cs b/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlaySuccessRate.cs
index be3fc7aff9..82b34c50c2 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlaySuccessRate.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlaySuccessRate.cs
@@ -71,7 +71,9 @@ namespace osu.Game.Tests.Visual.Online
                 {
                     Fails = Enumerable.Range(1, 100).Select(_ => RNG.Next(10)).ToArray(),
                     Retries = Enumerable.Range(-2, 100).Select(_ => RNG.Next(10)).ToArray(),
-                }
+                },
+                PassCount = RNG.Next(0, 999),
+                PlayCount = RNG.Next(1000, 1999),
             };
         }
 

From ced5be33e6ac062126ba7352c31eddf00683f303 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sat, 2 Apr 2022 18:08:57 +0300
Subject: [PATCH 3873/5547] Display pass/play count in success rate percentage
 tooltip

---
 osu.Game/Overlays/BeatmapSet/SuccessRate.cs | 12 ++++++++++--
 1 file changed, 10 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Overlays/BeatmapSet/SuccessRate.cs b/osu.Game/Overlays/BeatmapSet/SuccessRate.cs
index e08f099226..fed3d7ddaa 100644
--- a/osu.Game/Overlays/BeatmapSet/SuccessRate.cs
+++ b/osu.Game/Overlays/BeatmapSet/SuccessRate.cs
@@ -5,6 +5,8 @@ using osu.Framework.Allocation;
 using osu.Framework.Extensions.LocalisationExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.Cursor;
+using osu.Framework.Localisation;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.UserInterface;
@@ -19,7 +21,7 @@ namespace osu.Game.Overlays.BeatmapSet
         protected readonly FailRetryGraph Graph;
 
         private readonly FillFlowContainer header;
-        private readonly OsuSpriteText successPercent;
+        private readonly SuccessRatePercentage successPercent;
         private readonly Bar successRate;
         private readonly Container percentContainer;
 
@@ -45,6 +47,7 @@ namespace osu.Game.Overlays.BeatmapSet
 
             float rate = playCount != 0 ? (float)passCount / playCount : 0;
             successPercent.Text = rate.ToLocalisableString(@"0.#%");
+            successPercent.TooltipText = $"{passCount} / {playCount}";
             successRate.Length = rate;
             percentContainer.ResizeWidthTo(successRate.Length, 250, Easing.InOutCubic);
 
@@ -80,7 +83,7 @@ namespace osu.Game.Overlays.BeatmapSet
                             RelativeSizeAxes = Axes.X,
                             AutoSizeAxes = Axes.Y,
                             Width = 0f,
-                            Child = successPercent = new OsuSpriteText
+                            Child = successPercent = new SuccessRatePercentage
                             {
                                 Anchor = Anchor.TopRight,
                                 Origin = Anchor.TopCentre,
@@ -121,5 +124,10 @@ namespace osu.Game.Overlays.BeatmapSet
 
             Graph.Padding = new MarginPadding { Top = header.DrawHeight };
         }
+
+        private class SuccessRatePercentage : OsuSpriteText, IHasTooltip
+        {
+            public LocalisableString TooltipText { get; set; }
+        }
     }
 }

From c4635f3c03f1ef7aac5a153459d0b55d8e068259 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sat, 2 Apr 2022 18:36:32 +0300
Subject: [PATCH 3874/5547] Add failing test case

---
 .../Online/TestSceneBeatmapListingOverlay.cs  | 37 ++++++++++++++++---
 1 file changed, 31 insertions(+), 6 deletions(-)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneBeatmapListingOverlay.cs b/osu.Game.Tests/Visual/Online/TestSceneBeatmapListingOverlay.cs
index a056e0cd2c..159c49ebea 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneBeatmapListingOverlay.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneBeatmapListingOverlay.cs
@@ -5,9 +5,11 @@ using System;
 using System.Collections.Generic;
 using System.Linq;
 using NUnit.Framework;
+using osu.Framework.Allocation;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps.Drawables.Cards;
+using osu.Game.Configuration;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Online.API;
@@ -29,6 +31,14 @@ namespace osu.Game.Tests.Visual.Online
 
         private BeatmapListingSearchControl searchControl => overlay.ChildrenOfType<BeatmapListingSearchControl>().Single();
 
+        private OsuConfigManager localConfig;
+
+        [BackgroundDependencyLoader]
+        private void load()
+        {
+            Dependencies.Cache(localConfig = new OsuConfigManager(LocalStorage));
+        }
+
         [SetUpSteps]
         public void SetUpSteps()
         {
@@ -61,6 +71,8 @@ namespace osu.Game.Tests.Visual.Online
                     Id = API.LocalUser.Value.Id + 1,
                 };
             });
+
+            AddStep("reset size", () => localConfig.SetValue(OsuSetting.BeatmapListingCardSize, BeatmapCardSize.Normal));
         }
 
         [Test]
@@ -120,24 +132,25 @@ namespace osu.Game.Tests.Visual.Online
             assertAllCardsOfType<BeatmapCardNormal>(30);
         }
 
-        [Test]
-        public void TestCardSizeSwitching()
+        [TestCase(false)]
+        [TestCase(true)]
+        public void TestCardSizeSwitching(bool viaConfig)
         {
             AddAssert("is visible", () => overlay.State.Value == Visibility.Visible);
 
             AddStep("show many results", () => fetchFor(Enumerable.Repeat(CreateAPIBeatmapSet(Ruleset.Value), 100).ToArray()));
             assertAllCardsOfType<BeatmapCardNormal>(100);
 
-            setCardSize(BeatmapCardSize.Extra);
+            setCardSize(BeatmapCardSize.Extra, viaConfig);
             assertAllCardsOfType<BeatmapCardExtra>(100);
 
-            setCardSize(BeatmapCardSize.Normal);
+            setCardSize(BeatmapCardSize.Normal, viaConfig);
             assertAllCardsOfType<BeatmapCardNormal>(100);
 
             AddStep("fetch for 0 beatmaps", () => fetchFor());
             AddUntilStep("placeholder shown", () => overlay.ChildrenOfType<BeatmapListingOverlay.NotFoundDrawable>().SingleOrDefault()?.IsPresent == true);
 
-            setCardSize(BeatmapCardSize.Extra);
+            setCardSize(BeatmapCardSize.Extra, viaConfig);
             AddAssert("placeholder shown", () => overlay.ChildrenOfType<BeatmapListingOverlay.NotFoundDrawable>().SingleOrDefault()?.IsPresent == true);
         }
 
@@ -361,7 +374,13 @@ namespace osu.Game.Tests.Visual.Online
             AddUntilStep("\"no maps found\" placeholder not shown", () => !overlay.ChildrenOfType<BeatmapListingOverlay.NotFoundDrawable>().Any(d => d.IsPresent));
         }
 
-        private void setCardSize(BeatmapCardSize cardSize) => AddStep($"set card size to {cardSize}", () => overlay.ChildrenOfType<BeatmapListingCardSizeTabControl>().Single().Current.Value = cardSize);
+        private void setCardSize(BeatmapCardSize cardSize, bool viaConfig) => AddStep($"set card size to {cardSize}", () =>
+        {
+            if (!viaConfig)
+                overlay.ChildrenOfType<BeatmapListingCardSizeTabControl>().Single().Current.Value = cardSize;
+            else
+                localConfig.SetValue(OsuSetting.BeatmapListingCardSize, cardSize);
+        });
 
         private void assertAllCardsOfType<T>(int expectedCount)
             where T : BeatmapCard =>
@@ -370,5 +389,11 @@ namespace osu.Game.Tests.Visual.Online
                 int loadedCorrectCount = this.ChildrenOfType<BeatmapCard>().Count(card => card.IsLoaded && card.GetType() == typeof(T));
                 return loadedCorrectCount > 0 && loadedCorrectCount == expectedCount;
             });
+
+        protected override void Dispose(bool isDisposing)
+        {
+            localConfig?.Dispose();
+            base.Dispose(isDisposing);
+        }
     }
 }

From beb8426d3b866743fdaebf84e82d2e518bc3769c Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sat, 2 Apr 2022 18:36:49 +0300
Subject: [PATCH 3875/5547] Save beatmap listing card size to game config

---
 osu.Game/Configuration/OsuConfigManager.cs             |  4 ++++
 .../BeatmapListing/BeatmapListingFilterControl.cs      | 10 +++++++++-
 2 files changed, 13 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Configuration/OsuConfigManager.cs b/osu.Game/Configuration/OsuConfigManager.cs
index e8f13ba902..2f966ac0a9 100644
--- a/osu.Game/Configuration/OsuConfigManager.cs
+++ b/osu.Game/Configuration/OsuConfigManager.cs
@@ -10,6 +10,7 @@ using osu.Framework.Extensions.LocalisationExtensions;
 using osu.Framework.Localisation;
 using osu.Framework.Platform;
 using osu.Framework.Testing;
+using osu.Game.Beatmaps.Drawables.Cards;
 using osu.Game.Input;
 using osu.Game.Input.Bindings;
 using osu.Game.Localisation;
@@ -44,6 +45,8 @@ namespace osu.Game.Configuration
 
             SetDefault(OsuSetting.ChatDisplayHeight, ChatOverlay.DEFAULT_HEIGHT, 0.2f, 1f);
 
+            SetDefault(OsuSetting.BeatmapListingCardSize, BeatmapCardSize.Normal);
+
             SetDefault(OsuSetting.ToolbarClockDisplayMode, ToolbarClockDisplayMode.Full);
 
             // Online settings
@@ -297,6 +300,7 @@ namespace osu.Game.Configuration
         RandomSelectAlgorithm,
         ShowFpsDisplay,
         ChatDisplayHeight,
+        BeatmapListingCardSize,
         ToolbarClockDisplayMode,
         Version,
         ShowConvertedBeatmaps,
diff --git a/osu.Game/Overlays/BeatmapListing/BeatmapListingFilterControl.cs b/osu.Game/Overlays/BeatmapListing/BeatmapListingFilterControl.cs
index 0f87f04270..e4628e3723 100644
--- a/osu.Game/Overlays/BeatmapListing/BeatmapListingFilterControl.cs
+++ b/osu.Game/Overlays/BeatmapListing/BeatmapListingFilterControl.cs
@@ -14,6 +14,7 @@ using osu.Framework.Graphics.Shapes;
 using osu.Framework.Localisation;
 using osu.Framework.Threading;
 using osu.Game.Beatmaps.Drawables.Cards;
+using osu.Game.Configuration;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests;
 using osu.Game.Online.API.Requests.Responses;
@@ -53,7 +54,9 @@ namespace osu.Game.Overlays.BeatmapListing
         /// <summary>
         /// The currently selected <see cref="BeatmapCardSize"/>.
         /// </summary>
-        public IBindable<BeatmapCardSize> CardSize { get; } = new Bindable<BeatmapCardSize>();
+        public IBindable<BeatmapCardSize> CardSize => cardSize;
+
+        private readonly Bindable<BeatmapCardSize> cardSize = new Bindable<BeatmapCardSize>();
 
         private readonly BeatmapListingSearchControl searchControl;
         private readonly BeatmapListingSortTabControl sortControl;
@@ -128,6 +131,9 @@ namespace osu.Game.Overlays.BeatmapListing
             };
         }
 
+        [Resolved]
+        private OsuConfigManager config { get; set; }
+
         [BackgroundDependencyLoader]
         private void load(OverlayColourProvider colourProvider, IAPIProvider api)
         {
@@ -141,6 +147,8 @@ namespace osu.Game.Overlays.BeatmapListing
         {
             base.LoadComplete();
 
+            config.BindWith(OsuSetting.BeatmapListingCardSize, cardSize);
+
             var sortCriteria = sortControl.Current;
             var sortDirection = sortControl.SortDirection;
 

From b9421d1415af7e15c07b3f7237603170ea4a7a92 Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Sat, 2 Apr 2022 17:14:27 +0100
Subject: [PATCH 3876/5547] Simplify text clear and placeholder change in
 `ChatTextBox`

---
 osu.Game/Overlays/Chat/ChatTextBox.cs | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Overlays/Chat/ChatTextBox.cs b/osu.Game/Overlays/Chat/ChatTextBox.cs
index 35ed26cda3..e0f949caba 100644
--- a/osu.Game/Overlays/Chat/ChatTextBox.cs
+++ b/osu.Game/Overlays/Chat/ChatTextBox.cs
@@ -20,8 +20,10 @@ namespace osu.Game.Overlays.Chat
 
             ShowSearch.BindValueChanged(change =>
             {
-                PlaceholderText = change.NewValue ? "type here to search" : "type here";
-                Schedule(() => Text = string.Empty);
+                bool showSearch = change.NewValue;
+
+                PlaceholderText = showSearch ? "type here to search" : "type here";
+                Text = string.Empty;
             }, true);
         }
 

From 2297073b7eec019a1553735e7fd846f9488aad34 Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Sat, 2 Apr 2022 17:15:19 +0100
Subject: [PATCH 3877/5547] Use `OnChatMessageCommit` & `OnSearchTermsChanged`
 events in `ChatTextBar`

---
 .../Visual/Online/TestSceneChatTextBox.cs     | 39 ++++++++++++++++---
 osu.Game/Overlays/Chat/ChatTextBar.cs         | 31 +++++++++++++--
 2 files changed, 60 insertions(+), 10 deletions(-)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneChatTextBox.cs b/osu.Game.Tests/Visual/Online/TestSceneChatTextBox.cs
index e72a1d6652..982fbc397d 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneChatTextBox.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneChatTextBox.cs
@@ -25,6 +25,7 @@ namespace osu.Game.Tests.Visual.Online
         private readonly Bindable<Channel> currentChannel = new Bindable<Channel>();
 
         private OsuSpriteText commitText;
+        private OsuSpriteText searchText;
         private ChatTextBar bar;
 
         [SetUp]
@@ -47,11 +48,32 @@ namespace osu.Game.Tests.Visual.Online
                     {
                         new Drawable[]
                         {
-                            commitText = new OsuSpriteText
+                            new GridContainer
                             {
-                                Anchor = Anchor.TopCentre,
-                                Origin = Anchor.TopCentre,
-                                Font = OsuFont.Default.With(size: 20),
+                                RelativeSizeAxes = Axes.Both,
+                                ColumnDimensions = new[]
+                                {
+                                    new Dimension(),
+                                    new Dimension(),
+                                },
+                                Content = new[]
+                                {
+                                    new Drawable[]
+                                    {
+                                        commitText = new OsuSpriteText
+                                        {
+                                            Anchor = Anchor.TopCentre,
+                                            Origin = Anchor.TopCentre,
+                                            Font = OsuFont.Default.With(size: 20),
+                                        },
+                                        searchText = new OsuSpriteText
+                                        {
+                                            Anchor = Anchor.TopCentre,
+                                            Origin = Anchor.TopCentre,
+                                            Font = OsuFont.Default.With(size: 20),
+                                        },
+                                    },
+                                },
                             },
                         },
                         new Drawable[]
@@ -66,12 +88,17 @@ namespace osu.Game.Tests.Visual.Online
                     },
                 };
 
-                bar.TextBox.OnCommit += (sender, newText) =>
+                bar.OnChatMessageCommit += (sender, newText) =>
                 {
-                    commitText.Text = $"Commit: {sender.Text}";
+                    commitText.Text = $"OnChatMessageCommit: {sender.Text}";
                     commitText.FadeOutFromOne(1000, Easing.InQuint);
                     sender.Text = string.Empty;
                 };
+
+                bar.OnSearchTermsChanged += (text) =>
+                {
+                    searchText.Text = $"OnSearchTermsChanged: {text}";
+                };
             });
         }
 
diff --git a/osu.Game/Overlays/Chat/ChatTextBar.cs b/osu.Game/Overlays/Chat/ChatTextBar.cs
index d7edbb83b6..51c74ee0a5 100644
--- a/osu.Game/Overlays/Chat/ChatTextBar.cs
+++ b/osu.Game/Overlays/Chat/ChatTextBar.cs
@@ -3,15 +3,15 @@
 
 #nullable enable
 
+using System;
 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.Graphics.Sprites;
-using osu.Game.Graphics;
+using osu.Framework.Graphics.UserInterface;
 using osu.Game.Graphics.Containers;
-using osu.Game.Graphics.Sprites;
 using osu.Game.Online.Chat;
 using osuTK;
 
@@ -21,13 +21,16 @@ namespace osu.Game.Overlays.Chat
     {
         public readonly BindableBool ShowSearch = new BindableBool();
 
-        public ChatTextBox TextBox { get; private set; } = null!;
+        public event TextBox.OnCommitHandler? OnChatMessageCommit;
+
+        public event Action<string>? OnSearchTermsChanged;
 
         [Resolved]
         private Bindable<Channel> currentChannel { get; set; } = null!;
 
         private OsuTextFlowContainer chattingTextContainer = null!;
         private Container searchIconContainer = null!;
+        private ChatTextBox chatTextBox = null!;
 
         private const float chatting_text_width = 180;
         private const float search_icon_width = 40;
@@ -86,7 +89,7 @@ namespace osu.Game.Overlays.Chat
                             {
                                 RelativeSizeAxes = Axes.Both,
                                 Padding = new MarginPadding { Right = 5 },
-                                Child = TextBox = new ChatTextBox
+                                Child = chatTextBox = new ChatTextBox
                                 {
                                     Anchor = Anchor.CentreLeft,
                                     Origin = Anchor.CentreLeft,
@@ -106,12 +109,20 @@ namespace osu.Game.Overlays.Chat
         {
             base.LoadComplete();
 
+            chatTextBox.Current.ValueChanged += chatTextBoxChange;
+            chatTextBox.OnCommit += chatTextBoxCommit;
+
             ShowSearch.BindValueChanged(change =>
             {
                 bool showSearch = change.NewValue;
 
                 chattingTextContainer.FadeTo(showSearch ? 0 : 1);
                 searchIconContainer.FadeTo(showSearch ? 1 : 0);
+
+                // Clear search terms if any exist when switching back to chat mode
+                if (!showSearch)
+                    OnSearchTermsChanged?.Invoke(string.Empty);
+
             }, true);
 
             currentChannel.BindValueChanged(change =>
@@ -134,5 +145,17 @@ namespace osu.Game.Overlays.Chat
                 }
             }, true);
         }
+
+        private void chatTextBoxChange(ValueChangedEvent<string> change)
+        {
+            if (ShowSearch.Value)
+                OnSearchTermsChanged?.Invoke(change.NewValue);
+        }
+
+        private void chatTextBoxCommit(TextBox sender, bool newText)
+        {
+            if (!ShowSearch.Value)
+                OnChatMessageCommit?.Invoke(sender, newText);
+        }
     }
 }

From 8534dd34632508c05edb0fd6132aca68023c845f Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sat, 2 Apr 2022 19:24:16 +0300
Subject: [PATCH 3878/5547] Simplify `TestCase` attributes to one `Values`
 attribute
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>
---
 .../Visual/Online/TestSceneBeatmapListingOverlay.cs          | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneBeatmapListingOverlay.cs b/osu.Game.Tests/Visual/Online/TestSceneBeatmapListingOverlay.cs
index 159c49ebea..9a7bd17902 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneBeatmapListingOverlay.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneBeatmapListingOverlay.cs
@@ -132,9 +132,8 @@ namespace osu.Game.Tests.Visual.Online
             assertAllCardsOfType<BeatmapCardNormal>(30);
         }
 
-        [TestCase(false)]
-        [TestCase(true)]
-        public void TestCardSizeSwitching(bool viaConfig)
+        [Test]
+        public void TestCardSizeSwitching([Values] bool viaConfig)
         {
             AddAssert("is visible", () => overlay.State.Value == Visibility.Visible);
 

From 9e152cd3fd8aa48354e8bc34bfe3589d2ba77ad4 Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Sat, 2 Apr 2022 17:27:44 +0100
Subject: [PATCH 3879/5547] Fix code quality issues

---
 osu.Game.Tests/Visual/Online/TestSceneChatTextBox.cs | 2 +-
 osu.Game/Overlays/Chat/ChatTextBar.cs                | 1 -
 2 files changed, 1 insertion(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneChatTextBox.cs b/osu.Game.Tests/Visual/Online/TestSceneChatTextBox.cs
index 982fbc397d..42d4a8efbd 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneChatTextBox.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneChatTextBox.cs
@@ -95,7 +95,7 @@ namespace osu.Game.Tests.Visual.Online
                     sender.Text = string.Empty;
                 };
 
-                bar.OnSearchTermsChanged += (text) =>
+                bar.OnSearchTermsChanged += text =>
                 {
                     searchText.Text = $"OnSearchTermsChanged: {text}";
                 };
diff --git a/osu.Game/Overlays/Chat/ChatTextBar.cs b/osu.Game/Overlays/Chat/ChatTextBar.cs
index 51c74ee0a5..0eb8056d76 100644
--- a/osu.Game/Overlays/Chat/ChatTextBar.cs
+++ b/osu.Game/Overlays/Chat/ChatTextBar.cs
@@ -122,7 +122,6 @@ namespace osu.Game.Overlays.Chat
                 // Clear search terms if any exist when switching back to chat mode
                 if (!showSearch)
                     OnSearchTermsChanged?.Invoke(string.Empty);
-
             }, true);
 
             currentChannel.BindValueChanged(change =>

From b815f685fc67d869fa99ebd65a8ae49972122a22 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sat, 2 Apr 2022 19:28:33 +0300
Subject: [PATCH 3880/5547] Flip `viaConfig` conditional branch

---
 .../Visual/Online/TestSceneBeatmapListingOverlay.cs         | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneBeatmapListingOverlay.cs b/osu.Game.Tests/Visual/Online/TestSceneBeatmapListingOverlay.cs
index 9a7bd17902..5999125013 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneBeatmapListingOverlay.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneBeatmapListingOverlay.cs
@@ -375,10 +375,10 @@ namespace osu.Game.Tests.Visual.Online
 
         private void setCardSize(BeatmapCardSize cardSize, bool viaConfig) => AddStep($"set card size to {cardSize}", () =>
         {
-            if (!viaConfig)
-                overlay.ChildrenOfType<BeatmapListingCardSizeTabControl>().Single().Current.Value = cardSize;
-            else
+            if (viaConfig)
                 localConfig.SetValue(OsuSetting.BeatmapListingCardSize, cardSize);
+            else
+                overlay.ChildrenOfType<BeatmapListingCardSizeTabControl>().Single().Current.Value = cardSize;
         });
 
         private void assertAllCardsOfType<T>(int expectedCount)

From 0f9461689085cb790de5a3850d051a344d3f0fc2 Mon Sep 17 00:00:00 2001
From: Ame <ajiiisai@protonmail.com>
Date: Sat, 2 Apr 2022 19:41:15 +0200
Subject: [PATCH 3881/5547] Make overlay shortcuts able to be toggled instead
 of repeatable

---
 osu.Game/OsuGame.cs | 24 +++++++++++++++++++++++-
 1 file changed, 23 insertions(+), 1 deletion(-)

diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index 73121f6e7d..3703318e81 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -95,6 +95,8 @@ namespace osu.Game
 
         private SkinEditorOverlay skinEditor;
 
+        private NowPlayingOverlay nowPlayingOverlay;
+
         private Container overlayContent;
 
         private Container rightFloatingOverlayContent;
@@ -818,7 +820,7 @@ namespace osu.Game
                 Origin = Anchor.TopRight,
             }, rightFloatingOverlayContent.Add, true);
 
-            loadComponentSingleFile(new NowPlayingOverlay
+            loadComponentSingleFile(nowPlayingOverlay = new NowPlayingOverlay
             {
                 Anchor = Anchor.TopRight,
                 Origin = Anchor.TopRight,
@@ -1069,6 +1071,26 @@ namespace osu.Game
 
                     SkinManager.SelectRandomSkin();
                     return true;
+
+                case GlobalAction.ToggleChat:
+                    chatOverlay.ToggleVisibility();
+                    return true;
+
+                case GlobalAction.ToggleSocial:
+                    dashboard.ToggleVisibility();
+                    return true;
+
+                case GlobalAction.ToggleNowPlaying:
+                    nowPlayingOverlay.ToggleVisibility();
+                    return true;
+
+                case GlobalAction.ToggleBeatmapListing:
+                    beatmapListing.ToggleVisibility();
+                    return true;
+
+                case GlobalAction.ToggleSettings:
+                    Settings.ToggleVisibility();
+                    return true;
             }
 
             return false;

From 35629e9be815c41788633363c38ec9f6450669ea Mon Sep 17 00:00:00 2001
From: Ame <ajiiisai@protonmail.com>
Date: Sat, 2 Apr 2022 20:45:00 +0200
Subject: [PATCH 3882/5547] General fix for ToolbarButton toggle repetition

---
 osu.Game/OsuGame.cs                        | 24 +---------------------
 osu.Game/Overlays/Toolbar/ToolbarButton.cs |  2 +-
 2 files changed, 2 insertions(+), 24 deletions(-)

diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index 3703318e81..73121f6e7d 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -95,8 +95,6 @@ namespace osu.Game
 
         private SkinEditorOverlay skinEditor;
 
-        private NowPlayingOverlay nowPlayingOverlay;
-
         private Container overlayContent;
 
         private Container rightFloatingOverlayContent;
@@ -820,7 +818,7 @@ namespace osu.Game
                 Origin = Anchor.TopRight,
             }, rightFloatingOverlayContent.Add, true);
 
-            loadComponentSingleFile(nowPlayingOverlay = new NowPlayingOverlay
+            loadComponentSingleFile(new NowPlayingOverlay
             {
                 Anchor = Anchor.TopRight,
                 Origin = Anchor.TopRight,
@@ -1071,26 +1069,6 @@ namespace osu.Game
 
                     SkinManager.SelectRandomSkin();
                     return true;
-
-                case GlobalAction.ToggleChat:
-                    chatOverlay.ToggleVisibility();
-                    return true;
-
-                case GlobalAction.ToggleSocial:
-                    dashboard.ToggleVisibility();
-                    return true;
-
-                case GlobalAction.ToggleNowPlaying:
-                    nowPlayingOverlay.ToggleVisibility();
-                    return true;
-
-                case GlobalAction.ToggleBeatmapListing:
-                    beatmapListing.ToggleVisibility();
-                    return true;
-
-                case GlobalAction.ToggleSettings:
-                    Settings.ToggleVisibility();
-                    return true;
             }
 
             return false;
diff --git a/osu.Game/Overlays/Toolbar/ToolbarButton.cs b/osu.Game/Overlays/Toolbar/ToolbarButton.cs
index c855b76680..670ce65c6b 100644
--- a/osu.Game/Overlays/Toolbar/ToolbarButton.cs
+++ b/osu.Game/Overlays/Toolbar/ToolbarButton.cs
@@ -190,7 +190,7 @@ namespace osu.Game.Overlays.Toolbar
 
         public bool OnPressed(KeyBindingPressEvent<GlobalAction> e)
         {
-            if (e.Action == Hotkey)
+            if (!e.Repeat && e.Action == Hotkey)
             {
                 TriggerClick();
                 return true;

From 01b10e68d2fc8de98912f715bb5e02599d4ba9a9 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sat, 2 Apr 2022 23:47:20 +0300
Subject: [PATCH 3883/5547] Adjust taiko hit objects sizes to match
 osu!(stable)

---
 osu.Game.Rulesets.Taiko/Objects/TaikoHitObject.cs           | 2 +-
 osu.Game.Rulesets.Taiko/Objects/TaikoStrongableHitObject.cs | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Rulesets.Taiko/Objects/TaikoHitObject.cs b/osu.Game.Rulesets.Taiko/Objects/TaikoHitObject.cs
index f047c03f4b..1a1fde1990 100644
--- a/osu.Game.Rulesets.Taiko/Objects/TaikoHitObject.cs
+++ b/osu.Game.Rulesets.Taiko/Objects/TaikoHitObject.cs
@@ -14,7 +14,7 @@ namespace osu.Game.Rulesets.Taiko.Objects
         /// <summary>
         /// Default size of a drawable taiko hit object.
         /// </summary>
-        public const float DEFAULT_SIZE = 0.45f;
+        public const float DEFAULT_SIZE = 0.475f;
 
         public override Judgement CreateJudgement() => new TaikoJudgement();
 
diff --git a/osu.Game.Rulesets.Taiko/Objects/TaikoStrongableHitObject.cs b/osu.Game.Rulesets.Taiko/Objects/TaikoStrongableHitObject.cs
index 6c17573b50..43a099b900 100644
--- a/osu.Game.Rulesets.Taiko/Objects/TaikoStrongableHitObject.cs
+++ b/osu.Game.Rulesets.Taiko/Objects/TaikoStrongableHitObject.cs
@@ -17,7 +17,7 @@ namespace osu.Game.Rulesets.Taiko.Objects
         /// <summary>
         /// Scale multiplier for a strong drawable taiko hit object.
         /// </summary>
-        public const float STRONG_SCALE = 1.4f;
+        public const float STRONG_SCALE = 1.525f;
 
         /// <summary>
         /// Default size of a strong drawable taiko hit object.

From 94fa5e2ef20ab519484638d34be6bbb5238a256c Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Sat, 2 Apr 2022 21:58:54 +0100
Subject: [PATCH 3884/5547] Use `Action<string>` for event
 `OnChatMessageCommitted` & clear textbox internally

---
 osu.Game.Tests/Visual/Online/TestSceneChatTextBox.cs | 5 ++---
 osu.Game/Overlays/Chat/ChatTextBar.cs                | 6 ++++--
 2 files changed, 6 insertions(+), 5 deletions(-)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneChatTextBox.cs b/osu.Game.Tests/Visual/Online/TestSceneChatTextBox.cs
index 42d4a8efbd..e5dd492183 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneChatTextBox.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneChatTextBox.cs
@@ -88,11 +88,10 @@ namespace osu.Game.Tests.Visual.Online
                     },
                 };
 
-                bar.OnChatMessageCommit += (sender, newText) =>
+                bar.OnChatMessageCommitted += text =>
                 {
-                    commitText.Text = $"OnChatMessageCommit: {sender.Text}";
+                    commitText.Text = $"OnChatMessageCommitted: {text}";
                     commitText.FadeOutFromOne(1000, Easing.InQuint);
-                    sender.Text = string.Empty;
                 };
 
                 bar.OnSearchTermsChanged += text =>
diff --git a/osu.Game/Overlays/Chat/ChatTextBar.cs b/osu.Game/Overlays/Chat/ChatTextBar.cs
index 0eb8056d76..531c417abc 100644
--- a/osu.Game/Overlays/Chat/ChatTextBar.cs
+++ b/osu.Game/Overlays/Chat/ChatTextBar.cs
@@ -21,7 +21,7 @@ namespace osu.Game.Overlays.Chat
     {
         public readonly BindableBool ShowSearch = new BindableBool();
 
-        public event TextBox.OnCommitHandler? OnChatMessageCommit;
+        public event Action<string>? OnChatMessageCommitted;
 
         public event Action<string>? OnSearchTermsChanged;
 
@@ -154,7 +154,9 @@ namespace osu.Game.Overlays.Chat
         private void chatTextBoxCommit(TextBox sender, bool newText)
         {
             if (!ShowSearch.Value)
-                OnChatMessageCommit?.Invoke(sender, newText);
+                OnChatMessageCommitted?.Invoke(sender.Text);
+
+            sender.Text = string.Empty;
         }
     }
 }

From 4ce69890d4fbad0f7990fe6ceb645cf05ae5252a Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sun, 3 Apr 2022 00:21:23 +0300
Subject: [PATCH 3885/5547] Use `TaikoHitObject.DEFAULT_SIZE` for default
 circle piece symbol size

---
 osu.Game.Rulesets.Taiko/Skinning/Default/CirclePiece.cs | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Taiko/Skinning/Default/CirclePiece.cs b/osu.Game.Rulesets.Taiko/Skinning/Default/CirclePiece.cs
index a106c4f629..f2452ad88c 100644
--- a/osu.Game.Rulesets.Taiko/Skinning/Default/CirclePiece.cs
+++ b/osu.Game.Rulesets.Taiko/Skinning/Default/CirclePiece.cs
@@ -11,6 +11,7 @@ using osu.Game.Beatmaps.ControlPoints;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Backgrounds;
 using osu.Game.Graphics.Containers;
+using osu.Game.Rulesets.Taiko.Objects;
 using osuTK.Graphics;
 
 namespace osu.Game.Rulesets.Taiko.Skinning.Default
@@ -24,8 +25,9 @@ namespace osu.Game.Rulesets.Taiko.Skinning.Default
     /// </summary>
     public abstract class CirclePiece : BeatSyncedContainer, IHasAccentColour
     {
-        public const float SYMBOL_SIZE = 0.45f;
+        public const float SYMBOL_SIZE = TaikoHitObject.DEFAULT_SIZE;
         public const float SYMBOL_BORDER = 8;
+
         private const double pre_beat_transition_time = 80;
 
         private Color4 accentColour;

From 534cc18ff9ff6d1a8f5726bef122a3ff4c79c006 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sun, 3 Apr 2022 01:21:48 +0300
Subject: [PATCH 3886/5547] Adjust osu!taiko legacy hit target size to match
 osu!(stable)

---
 .../Skinning/Legacy/TaikoLegacyHitTarget.cs                   | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Rulesets.Taiko/Skinning/Legacy/TaikoLegacyHitTarget.cs b/osu.Game.Rulesets.Taiko/Skinning/Legacy/TaikoLegacyHitTarget.cs
index 9feb2054da..c4657fcc49 100644
--- a/osu.Game.Rulesets.Taiko/Skinning/Legacy/TaikoLegacyHitTarget.cs
+++ b/osu.Game.Rulesets.Taiko/Skinning/Legacy/TaikoLegacyHitTarget.cs
@@ -30,7 +30,7 @@ namespace osu.Game.Rulesets.Taiko.Skinning.Legacy
                     new Sprite
                     {
                         Texture = skin.GetTexture("approachcircle"),
-                        Scale = new Vector2(0.73f),
+                        Scale = new Vector2(0.83f),
                         Alpha = 0.47f, // eyeballed to match stable
                         Anchor = Anchor.Centre,
                         Origin = Anchor.Centre,
@@ -38,7 +38,7 @@ namespace osu.Game.Rulesets.Taiko.Skinning.Legacy
                     new Sprite
                     {
                         Texture = skin.GetTexture("taikobigcircle"),
-                        Scale = new Vector2(0.7f),
+                        Scale = new Vector2(0.8f),
                         Alpha = 0.22f, // eyeballed to match stable
                         Anchor = Anchor.Centre,
                         Origin = Anchor.Centre,

From 970b1951ace07653526d5633f7975019ba006b68 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 3 Apr 2022 14:23:45 +0200
Subject: [PATCH 3887/5547] Rewrite logic slightly to better convey meaning of
 textbox clear

---
 osu.Game/Overlays/Chat/ChatTextBar.cs | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Overlays/Chat/ChatTextBar.cs b/osu.Game/Overlays/Chat/ChatTextBar.cs
index 531c417abc..ef20149dac 100644
--- a/osu.Game/Overlays/Chat/ChatTextBar.cs
+++ b/osu.Game/Overlays/Chat/ChatTextBar.cs
@@ -153,9 +153,10 @@ namespace osu.Game.Overlays.Chat
 
         private void chatTextBoxCommit(TextBox sender, bool newText)
         {
-            if (!ShowSearch.Value)
-                OnChatMessageCommitted?.Invoke(sender.Text);
+            if (ShowSearch.Value)
+                return;
 
+            OnChatMessageCommitted?.Invoke(sender.Text);
             sender.Text = string.Empty;
         }
     }

From 6d1844adc3a9b01b8d33a07bdf56fcdc6d671c4d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 3 Apr 2022 14:27:37 +0200
Subject: [PATCH 3888/5547] Use `nameof()` in test to reference event names

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

diff --git a/osu.Game.Tests/Visual/Online/TestSceneChatTextBox.cs b/osu.Game.Tests/Visual/Online/TestSceneChatTextBox.cs
index e5dd492183..a241aa0517 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneChatTextBox.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneChatTextBox.cs
@@ -90,13 +90,13 @@ namespace osu.Game.Tests.Visual.Online
 
                 bar.OnChatMessageCommitted += text =>
                 {
-                    commitText.Text = $"OnChatMessageCommitted: {text}";
+                    commitText.Text = $"{nameof(bar.OnChatMessageCommitted)}: {text}";
                     commitText.FadeOutFromOne(1000, Easing.InQuint);
                 };
 
                 bar.OnSearchTermsChanged += text =>
                 {
-                    searchText.Text = $"OnSearchTermsChanged: {text}";
+                    searchText.Text = $"{nameof(bar.OnSearchTermsChanged)}: {text}";
                 };
             });
         }

From 1393e3628be595cc9f2ab67cc7ee92d453e2acf0 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 3 Apr 2022 15:24:00 +0200
Subject: [PATCH 3889/5547] Invert operands for better readability

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

diff --git a/osu.Game/Overlays/Toolbar/ToolbarButton.cs b/osu.Game/Overlays/Toolbar/ToolbarButton.cs
index 670ce65c6b..4a839b048c 100644
--- a/osu.Game/Overlays/Toolbar/ToolbarButton.cs
+++ b/osu.Game/Overlays/Toolbar/ToolbarButton.cs
@@ -190,7 +190,7 @@ namespace osu.Game.Overlays.Toolbar
 
         public bool OnPressed(KeyBindingPressEvent<GlobalAction> e)
         {
-            if (!e.Repeat && e.Action == Hotkey)
+            if (e.Action == Hotkey && !e.Repeat)
             {
                 TriggerClick();
                 return true;

From 293ef4483609737f34bf5796d0f8fa09b84b177c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 26 Mar 2022 22:43:17 +0100
Subject: [PATCH 3890/5547] Implement new mod select screen

---
 .../UserInterface/TestSceneModSelectScreen.cs |  28 ++
 osu.Game/Overlays/Mods/ModColumn.cs           |  11 +-
 osu.Game/Overlays/Mods/ModSelectScreen.cs     | 315 ++++++++++++++++++
 osu.Game/Overlays/Mods/ModSettingsArea.cs     |   4 +-
 4 files changed, 356 insertions(+), 2 deletions(-)
 create mode 100644 osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs
 create mode 100644 osu.Game/Overlays/Mods/ModSelectScreen.cs

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs
new file mode 100644
index 0000000000..e6a5784536
--- /dev/null
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.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 NUnit.Framework;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
+using osu.Game.Overlays.Mods;
+
+namespace osu.Game.Tests.Visual.UserInterface
+{
+    [TestFixture]
+    public class TestSceneModSelectScreen : OsuTestScene
+    {
+        [Test]
+        public void TestModSelectScreen()
+        {
+            ModSelectScreen modSelectScreen = null;
+
+            AddStep("create screen", () => Child = modSelectScreen = new ModSelectScreen
+            {
+                RelativeSizeAxes = Axes.Both,
+                State = { Value = Visibility.Visible }
+            });
+
+            AddToggleStep("toggle state", visible => modSelectScreen.State.Value = visible ? Visibility.Visible : Visibility.Hidden);
+        }
+    }
+}
diff --git a/osu.Game/Overlays/Mods/ModColumn.cs b/osu.Game/Overlays/Mods/ModColumn.cs
index 736a0205e2..9cf9e6a268 100644
--- a/osu.Game/Overlays/Mods/ModColumn.cs
+++ b/osu.Game/Overlays/Mods/ModColumn.cs
@@ -48,6 +48,8 @@ namespace osu.Game.Overlays.Mods
             }
         }
 
+        public Action<Mod, bool>? ModStateChanged { get; set; }
+
         private readonly ModType modType;
         private readonly Key[]? toggleKeys;
 
@@ -251,7 +253,14 @@ namespace osu.Game.Overlays.Mods
                 panelFlow.ChildrenEnumerable = loaded;
 
                 foreach (var panel in panelFlow)
-                    panel.Active.BindValueChanged(_ => updateToggleState());
+                {
+                    panel.Active.BindValueChanged(_ =>
+                    {
+                        updateToggleState();
+                        ModStateChanged?.Invoke(panel.Mod, panel.Active.Value);
+                    });
+                }
+
                 updateToggleState();
 
                 updateFilter();
diff --git a/osu.Game/Overlays/Mods/ModSelectScreen.cs b/osu.Game/Overlays/Mods/ModSelectScreen.cs
new file mode 100644
index 0000000000..bd27407965
--- /dev/null
+++ b/osu.Game/Overlays/Mods/ModSelectScreen.cs
@@ -0,0 +1,315 @@
+// 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;
+using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.Shapes;
+using osu.Framework.Input.Events;
+using osu.Framework.Layout;
+using osu.Game.Configuration;
+using osu.Game.Graphics.Containers;
+using osu.Game.Graphics.UserInterface;
+using osu.Game.Rulesets.Mods;
+using osuTK;
+using osuTK.Input;
+
+namespace osu.Game.Overlays.Mods
+{
+    public class ModSelectScreen : OsuFocusedOverlayContainer
+    {
+        [Cached]
+        private OverlayColourProvider colourProvider = new OverlayColourProvider(OverlayColourScheme.Green);
+
+        [Cached]
+        private Bindable<IReadOnlyList<Mod>> selectedMods = new Bindable<IReadOnlyList<Mod>>(Array.Empty<Mod>());
+
+        private readonly BindableBool customisationVisible = new BindableBool();
+
+        private DifficultyMultiplierDisplay multiplierDisplay;
+        private ModSettingsArea modSettingsArea;
+        private Container columnContainer;
+        private FillFlowContainer<ModColumn> columnFlow;
+        private GridContainer grid;
+        private Container mainContent;
+
+        [BackgroundDependencyLoader]
+        private void load()
+        {
+            RelativeSizeAxes = Axes.Both;
+            RelativePositionAxes = Axes.Both;
+
+            InternalChildren = new Drawable[]
+            {
+                mainContent = new Container
+                {
+                    Origin = Anchor.BottomCentre,
+                    Anchor = Anchor.BottomCentre,
+                    RelativeSizeAxes = Axes.Both,
+                    Children = new Drawable[]
+                    {
+                        grid = new GridContainer
+                        {
+                            RelativeSizeAxes = Axes.Both,
+                            RowDimensions = new[]
+                            {
+                                new Dimension(GridSizeMode.AutoSize),
+                                new Dimension(GridSizeMode.AutoSize),
+                                new Dimension(),
+                                new Dimension(GridSizeMode.Absolute, 75),
+                            },
+                            Content = new[]
+                            {
+                                new Drawable[]
+                                {
+                                    new PopupScreenTitle
+                                    {
+                                        Anchor = Anchor.TopCentre,
+                                        Origin = Anchor.TopCentre,
+                                        Title = "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.",
+                                        Close = Hide
+                                    }
+                                },
+                                new Drawable[]
+                                {
+                                    new Container
+                                    {
+                                        RelativeSizeAxes = Axes.X,
+                                        AutoSizeAxes = Axes.Y,
+                                        Padding = new MarginPadding { Horizontal = 100, Vertical = 10 },
+                                        Child = multiplierDisplay = new DifficultyMultiplierDisplay
+                                        {
+                                            Anchor = Anchor.CentreRight,
+                                            Origin = Anchor.CentreRight
+                                        }
+                                    }
+                                },
+                                new Drawable[]
+                                {
+                                    columnContainer = new Container
+                                    {
+                                        RelativeSizeAxes = Axes.Both,
+                                        RelativePositionAxes = Axes.Both,
+                                        X = 1,
+                                        Padding = new MarginPadding { Horizontal = 70 },
+                                        Children = new Drawable[]
+                                        {
+                                            new OsuScrollContainer(Direction.Horizontal)
+                                            {
+                                                RelativeSizeAxes = Axes.Both,
+                                                Masking = false,
+                                                ScrollbarOverlapsContent = false,
+                                                Child = columnFlow = new ModColumnContainer
+                                                {
+                                                    RelativeSizeAxes = Axes.Y,
+                                                    AutoSizeAxes = Axes.X,
+                                                    Spacing = new Vector2(10, 0),
+                                                    Children = new[]
+                                                    {
+                                                        new ModColumn(ModType.DifficultyReduction, false, new[] { Key.Q, Key.W, Key.E, Key.R, Key.T, Key.Y, Key.U, Key.I, Key.O, Key.P }),
+                                                        new ModColumn(ModType.DifficultyIncrease, false, new[] { Key.A, Key.S, Key.D, Key.F, Key.G, Key.H, Key.J, Key.K, Key.L }),
+                                                        new ModColumn(ModType.Automation, false, new[] { Key.Z, Key.X, Key.C, Key.V, Key.B, Key.N, Key.M }),
+                                                        new ModColumn(ModType.Conversion, false),
+                                                        new ModColumn(ModType.Fun, false)
+                                                    }
+                                                }
+                                            }
+                                        }
+                                    }
+                                },
+                                new[] { Empty() }
+                            }
+                        },
+                        new Container
+                        {
+                            RelativeSizeAxes = Axes.X,
+                            AutoSizeAxes = Axes.Y,
+                            Anchor = Anchor.BottomCentre,
+                            Origin = Anchor.BottomCentre,
+                            Children = new Drawable[]
+                            {
+                                new Box
+                                {
+                                    RelativeSizeAxes = Axes.X,
+                                    Height = 50,
+                                    Anchor = Anchor.BottomCentre,
+                                    Origin = Anchor.BottomCentre,
+                                    Colour = colourProvider.Background5
+                                },
+                                new ShearedToggleButton(200)
+                                {
+                                    Anchor = Anchor.BottomLeft,
+                                    Origin = Anchor.BottomLeft,
+                                    Margin = new MarginPadding { Vertical = 14, Left = 70 },
+                                    Text = "Mod Customisation",
+                                    Active = { BindTarget = customisationVisible }
+                                }
+                            }
+                        },
+                        new ClickToReturnContainer
+                        {
+                            RelativeSizeAxes = Axes.Both,
+                            HandleMouse = { BindTarget = customisationVisible },
+                            OnClicked = () => customisationVisible.Value = false
+                        }
+                    }
+                },
+                modSettingsArea = new ModSettingsArea
+                {
+                    Anchor = Anchor.BottomCentre,
+                    Origin = Anchor.BottomCentre
+                }
+            };
+
+            foreach (var column in columnFlow)
+            {
+                column.ModStateChanged = (mod, active) => selectedMods.Value = active
+                    ? selectedMods.Value.Append(mod).ToArray()
+                    : selectedMods.Value.Except(new[] { mod }).ToArray();
+            }
+
+            columnFlow.Shear = new Vector2(ModPanel.SHEAR_X, 0);
+        }
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            ((IBindable<IReadOnlyList<Mod>>)modSettingsArea.SelectedMods).BindTo(selectedMods);
+            selectedMods.BindValueChanged(val =>
+            {
+                updateMultiplier();
+                updateCustomisation(val);
+            }, true);
+            customisationVisible.BindValueChanged(_ => updateCustomisationVisualState(), true);
+
+            FinishTransforms(true);
+        }
+
+        private void updateMultiplier()
+        {
+            double multiplier = 1.0;
+
+            foreach (var mod in selectedMods.Value)
+                multiplier *= mod.ScoreMultiplier;
+
+            multiplierDisplay.Current.Value = multiplier;
+        }
+
+        private void updateCustomisation(ValueChangedEvent<IReadOnlyList<Mod>> valueChangedEvent)
+        {
+            bool anyCustomisableMod = false;
+            bool anyModWithRequiredCustomisationAdded = false;
+
+            foreach (var mod in selectedMods.Value)
+            {
+                anyCustomisableMod |= mod.GetSettingsSourceProperties().Any();
+                anyModWithRequiredCustomisationAdded |= !valueChangedEvent.OldValue.Contains(mod) && mod.RequiresConfiguration;
+            }
+
+            if (anyCustomisableMod)
+            {
+                customisationVisible.Disabled = false;
+
+                if (anyModWithRequiredCustomisationAdded && !customisationVisible.Value)
+                    customisationVisible.Value = true;
+            }
+            else
+            {
+                if (customisationVisible.Value)
+                    customisationVisible.Value = false;
+
+                customisationVisible.Disabled = true;
+            }
+        }
+
+        private void updateCustomisationVisualState()
+        {
+            grid.FadeColour(customisationVisible.Value ? Colour4.Gray : Colour4.White, 800, Easing.OutQuint);
+
+            float modAreaHeight = customisationVisible.Value ? ModSettingsArea.HEIGHT : 0;
+
+            modSettingsArea.ResizeHeightTo(modAreaHeight, 800, Easing.InOutCubic);
+            mainContent.TransformTo(nameof(Margin), new MarginPadding { Bottom = modAreaHeight }, 800, Easing.InOutCubic);
+        }
+
+        protected override void PopIn()
+        {
+            base.PopIn();
+            this.MoveToY(0, 800, Easing.OutQuint);
+            columnContainer.MoveToX(0, 800, Easing.OutQuint);
+        }
+
+        protected override void PopOut()
+        {
+            base.PopOut();
+            this.MoveToY(1.2f, 800, Easing.OutQuint);
+            columnContainer.MoveToX(1, 800, Easing.OutQuint);
+        }
+
+        private class ModColumnContainer : FillFlowContainer<ModColumn>
+        {
+            private readonly LayoutValue drawSizeLayout = new LayoutValue(Invalidation.DrawSize);
+
+            public ModColumnContainer()
+            {
+                AddLayout(drawSizeLayout);
+            }
+
+            public override void Add(ModColumn column)
+            {
+                base.Add(column);
+
+                Debug.Assert(column != null);
+                column.Shear = Vector2.Zero;
+            }
+
+            protected override void Update()
+            {
+                base.Update();
+
+                if (!drawSizeLayout.IsValid)
+                {
+                    Padding = new MarginPadding
+                    {
+                        Left = DrawHeight * ModPanel.SHEAR_X,
+                        Bottom = 10
+                    };
+
+                    drawSizeLayout.Validate();
+                }
+            }
+        }
+
+        private class ClickToReturnContainer : Container
+        {
+            public BindableBool HandleMouse { get; } = new BindableBool();
+
+            public Action OnClicked { get; set; }
+
+            protected override bool Handle(UIEvent e)
+            {
+                if (!HandleMouse.Value)
+                    return base.Handle(e);
+
+                switch (e)
+                {
+                    case ClickEvent _:
+                        OnClicked?.Invoke();
+                        return true;
+
+                    case MouseEvent _:
+                        return true;
+                }
+
+                return base.Handle(e);
+            }
+        }
+    }
+}
diff --git a/osu.Game/Overlays/Mods/ModSettingsArea.cs b/osu.Game/Overlays/Mods/ModSettingsArea.cs
index e0a30f60c2..9b0382c6a4 100644
--- a/osu.Game/Overlays/Mods/ModSettingsArea.cs
+++ b/osu.Game/Overlays/Mods/ModSettingsArea.cs
@@ -23,6 +23,8 @@ namespace osu.Game.Overlays.Mods
     {
         public Bindable<IReadOnlyList<Mod>> SelectedMods { get; } = new Bindable<IReadOnlyList<Mod>>();
 
+        public const float HEIGHT = 250;
+
         private readonly Box background;
         private readonly FillFlowContainer modSettingsFlow;
 
@@ -32,7 +34,7 @@ namespace osu.Game.Overlays.Mods
         public ModSettingsArea()
         {
             RelativeSizeAxes = Axes.X;
-            Height = 250;
+            Height = HEIGHT;
 
             Anchor = Anchor.BottomRight;
             Origin = Anchor.BottomRight;

From e46c2df409afe3bcf50e3a8bb40bb8f1bf90d0d9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 26 Mar 2022 23:21:17 +0100
Subject: [PATCH 3891/5547] Add testing for customisation panel show/hide logic

---
 .../UserInterface/TestSceneModSelectScreen.cs | 62 ++++++++++++++++---
 osu.Game/Overlays/Mods/ModSelectScreen.cs     | 16 ++---
 2 files changed, 63 insertions(+), 15 deletions(-)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs
index e6a5784536..25b2e92c0c 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs
@@ -1,28 +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 System.Linq;
 using NUnit.Framework;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
+using osu.Framework.Testing;
+using osu.Game.Graphics.UserInterface;
 using osu.Game.Overlays.Mods;
+using osu.Game.Rulesets.Osu.Mods;
+using osuTK.Input;
 
 namespace osu.Game.Tests.Visual.UserInterface
 {
     [TestFixture]
-    public class TestSceneModSelectScreen : OsuTestScene
+    public class TestSceneModSelectScreen : OsuManualInputManagerTestScene
     {
-        [Test]
-        public void TestModSelectScreen()
-        {
-            ModSelectScreen modSelectScreen = null;
+        private ModSelectScreen modSelectScreen;
 
+        [SetUpSteps]
+        public void SetUpSteps()
+        {
             AddStep("create screen", () => Child = modSelectScreen = new ModSelectScreen
             {
                 RelativeSizeAxes = Axes.Both,
-                State = { Value = Visibility.Visible }
+                State = { Value = Visibility.Visible },
+                SelectedMods = { BindTarget = SelectedMods }
+            });
+        }
+
+        [Test]
+        public void TestStateChange()
+        {
+            AddToggleStep("toggle state", visible => modSelectScreen.State.Value = visible ? Visibility.Visible : Visibility.Hidden);
+        }
+
+        [Test]
+        public void TestCustomisationToggleState()
+        {
+            assertCustomisationToggleState(disabled: true, active: false);
+
+            AddStep("select customisable mod", () => SelectedMods.Value = new[] { new OsuModDoubleTime() });
+            assertCustomisationToggleState(disabled: false, active: false);
+
+            AddStep("select mod requiring configuration", () => SelectedMods.Value = new[] { new OsuModDifficultyAdjust() });
+            assertCustomisationToggleState(disabled: false, active: true);
+
+            AddStep("dismiss mod customisation", () =>
+            {
+                InputManager.MoveMouseTo(modSelectScreen.ChildrenOfType<ShearedToggleButton>().Single());
+                InputManager.Click(MouseButton.Left);
             });
 
-            AddToggleStep("toggle state", visible => modSelectScreen.State.Value = visible ? Visibility.Visible : Visibility.Hidden);
+            AddStep("append another mod not requiring config", () => SelectedMods.Value = SelectedMods.Value.Append(new OsuModFlashlight()).ToArray());
+            assertCustomisationToggleState(disabled: false, active: false);
+
+            AddStep("select mod without configuration", () => SelectedMods.Value = new[] { new OsuModAutoplay() });
+            assertCustomisationToggleState(disabled: true, active: false);
+
+            AddStep("select mod requiring configuration", () => SelectedMods.Value = new[] { new OsuModDifficultyAdjust() });
+            assertCustomisationToggleState(disabled: false, active: true);
+
+            AddStep("select mod without configuration", () => SelectedMods.Value = new[] { new OsuModAutoplay() });
+            assertCustomisationToggleState(disabled: true, active: false); // config was dismissed without explicit user action.
+        }
+
+        private void assertCustomisationToggleState(bool disabled, bool active)
+        {
+            ShearedToggleButton getToggle() => modSelectScreen.ChildrenOfType<ShearedToggleButton>().Single();
+
+            AddAssert($"customisation toggle is {(disabled ? "" : "not ")}disabled", () => getToggle().Active.Disabled == disabled);
+            AddAssert($"customisation toggle is {(active ? "" : "not ")}active", () => getToggle().Active.Value == active);
         }
     }
 }
diff --git a/osu.Game/Overlays/Mods/ModSelectScreen.cs b/osu.Game/Overlays/Mods/ModSelectScreen.cs
index bd27407965..0a9b1ddbcb 100644
--- a/osu.Game/Overlays/Mods/ModSelectScreen.cs
+++ b/osu.Game/Overlays/Mods/ModSelectScreen.cs
@@ -27,7 +27,7 @@ namespace osu.Game.Overlays.Mods
         private OverlayColourProvider colourProvider = new OverlayColourProvider(OverlayColourScheme.Green);
 
         [Cached]
-        private Bindable<IReadOnlyList<Mod>> selectedMods = new Bindable<IReadOnlyList<Mod>>(Array.Empty<Mod>());
+        public Bindable<IReadOnlyList<Mod>> SelectedMods { get; private set; } = new Bindable<IReadOnlyList<Mod>>(Array.Empty<Mod>());
 
         private readonly BindableBool customisationVisible = new BindableBool();
 
@@ -169,9 +169,9 @@ namespace osu.Game.Overlays.Mods
 
             foreach (var column in columnFlow)
             {
-                column.ModStateChanged = (mod, active) => selectedMods.Value = active
-                    ? selectedMods.Value.Append(mod).ToArray()
-                    : selectedMods.Value.Except(new[] { mod }).ToArray();
+                column.ModStateChanged = (mod, active) => SelectedMods.Value = active
+                    ? SelectedMods.Value.Append(mod).ToArray()
+                    : SelectedMods.Value.Except(new[] { mod }).ToArray();
             }
 
             columnFlow.Shear = new Vector2(ModPanel.SHEAR_X, 0);
@@ -181,8 +181,8 @@ namespace osu.Game.Overlays.Mods
         {
             base.LoadComplete();
 
-            ((IBindable<IReadOnlyList<Mod>>)modSettingsArea.SelectedMods).BindTo(selectedMods);
-            selectedMods.BindValueChanged(val =>
+            ((IBindable<IReadOnlyList<Mod>>)modSettingsArea.SelectedMods).BindTo(SelectedMods);
+            SelectedMods.BindValueChanged(val =>
             {
                 updateMultiplier();
                 updateCustomisation(val);
@@ -196,7 +196,7 @@ namespace osu.Game.Overlays.Mods
         {
             double multiplier = 1.0;
 
-            foreach (var mod in selectedMods.Value)
+            foreach (var mod in SelectedMods.Value)
                 multiplier *= mod.ScoreMultiplier;
 
             multiplierDisplay.Current.Value = multiplier;
@@ -207,7 +207,7 @@ namespace osu.Game.Overlays.Mods
             bool anyCustomisableMod = false;
             bool anyModWithRequiredCustomisationAdded = false;
 
-            foreach (var mod in selectedMods.Value)
+            foreach (var mod in SelectedMods.Value)
             {
                 anyCustomisableMod |= mod.GetSettingsSourceProperties().Any();
                 anyModWithRequiredCustomisationAdded |= !valueChangedEvent.OldValue.Contains(mod) && mod.RequiresConfiguration;

From 2921a1360917b915852e678bed4b453c9e777235 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 3 Apr 2022 17:43:13 +0200
Subject: [PATCH 3892/5547] Add testing for mod bindable state propagation

---
 .../UserInterface/TestSceneModSelectScreen.cs | 46 ++++++++++++++++---
 1 file changed, 40 insertions(+), 6 deletions(-)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs
index 25b2e92c0c..a5f5048961 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs
@@ -6,8 +6,10 @@ using NUnit.Framework;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Testing;
+using osu.Framework.Utils;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Overlays.Mods;
+using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Osu.Mods;
 using osuTK.Input;
 
@@ -21,23 +23,55 @@ namespace osu.Game.Tests.Visual.UserInterface
         [SetUpSteps]
         public void SetUpSteps()
         {
-            AddStep("create screen", () => Child = modSelectScreen = new ModSelectScreen
-            {
-                RelativeSizeAxes = Axes.Both,
-                State = { Value = Visibility.Visible },
-                SelectedMods = { BindTarget = SelectedMods }
-            });
+            AddStep("reset mods", () => SelectedMods.SetDefault());
         }
 
+        private void createScreen() => AddStep("create screen", () => Child = modSelectScreen = new ModSelectScreen
+        {
+            RelativeSizeAxes = Axes.Both,
+            State = { Value = Visibility.Visible },
+            SelectedMods = { BindTarget = SelectedMods }
+        });
+
         [Test]
         public void TestStateChange()
         {
+            createScreen();
             AddToggleStep("toggle state", visible => modSelectScreen.State.Value = visible ? Visibility.Visible : Visibility.Hidden);
         }
 
+        [Test]
+        public void TestPreexistingSelection()
+        {
+            AddStep("set mods", () => SelectedMods.Value = new Mod[] { new OsuModAlternate(), new OsuModDaycore() });
+            createScreen();
+            AddUntilStep("two panels active", () => modSelectScreen.ChildrenOfType<ModPanel>().Count(panel => panel.Active.Value) == 2);
+            AddAssert("mod multiplier correct", () =>
+            {
+                double multiplier = SelectedMods.Value.Aggregate(1d, (multiplier, mod) => multiplier * mod.ScoreMultiplier);
+                return Precision.AlmostEquals(multiplier, modSelectScreen.ChildrenOfType<DifficultyMultiplierDisplay>().Single().Current.Value);
+            });
+            assertCustomisationToggleState(disabled: false, active: false);
+        }
+
+        [Test]
+        public void TestExternalSelection()
+        {
+            createScreen();
+            AddStep("set mods", () => SelectedMods.Value = new Mod[] { new OsuModAlternate(), new OsuModDaycore() });
+            AddUntilStep("two panels active", () => modSelectScreen.ChildrenOfType<ModPanel>().Count(panel => panel.Active.Value) == 2);
+            AddAssert("mod multiplier correct", () =>
+            {
+                double multiplier = SelectedMods.Value.Aggregate(1d, (multiplier, mod) => multiplier * mod.ScoreMultiplier);
+                return Precision.AlmostEquals(multiplier, modSelectScreen.ChildrenOfType<DifficultyMultiplierDisplay>().Single().Current.Value);
+            });
+            assertCustomisationToggleState(disabled: false, active: false);
+        }
+
         [Test]
         public void TestCustomisationToggleState()
         {
+            createScreen();
             assertCustomisationToggleState(disabled: true, active: false);
 
             AddStep("select customisable mod", () => SelectedMods.Value = new[] { new OsuModDoubleTime() });

From cd776d21a6c5268277644bebd1fe3336cb75dbdd Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 28 Mar 2022 00:16:10 +0200
Subject: [PATCH 3893/5547] Fix propagation of selected mods to columns

---
 osu.Game/Overlays/Mods/ModColumn.cs       | 43 +++++++++++++++--------
 osu.Game/Overlays/Mods/ModSelectScreen.cs | 42 ++++++++++++++++++----
 2 files changed, 64 insertions(+), 21 deletions(-)

diff --git a/osu.Game/Overlays/Mods/ModColumn.cs b/osu.Game/Overlays/Mods/ModColumn.cs
index 9cf9e6a268..46a562ac98 100644
--- a/osu.Game/Overlays/Mods/ModColumn.cs
+++ b/osu.Game/Overlays/Mods/ModColumn.cs
@@ -31,6 +31,8 @@ namespace osu.Game.Overlays.Mods
 {
     public class ModColumn : CompositeDrawable
     {
+        public readonly ModType ModType;
+
         private Func<Mod, bool>? filter;
 
         /// <summary>
@@ -48,9 +50,8 @@ namespace osu.Game.Overlays.Mods
             }
         }
 
-        public Action<Mod, bool>? ModStateChanged { get; set; }
+        public Bindable<IReadOnlyList<Mod>> SelectedMods = new Bindable<IReadOnlyList<Mod>>(Array.Empty<Mod>());
 
-        private readonly ModType modType;
         private readonly Key[]? toggleKeys;
 
         private readonly Bindable<Dictionary<ModType, IReadOnlyList<Mod>>> availableMods = new Bindable<Dictionary<ModType, IReadOnlyList<Mod>>>();
@@ -71,7 +72,7 @@ namespace osu.Game.Overlays.Mods
 
         public ModColumn(ModType modType, bool allowBulkSelection, Key[]? toggleKeys = null)
         {
-            this.modType = modType;
+            ModType = modType;
             this.toggleKeys = toggleKeys;
 
             Width = 320;
@@ -195,7 +196,7 @@ namespace osu.Game.Overlays.Mods
 
         private void createHeaderText()
         {
-            IEnumerable<string> headerTextWords = modType.Humanize(LetterCasing.Title).Split(' ');
+            IEnumerable<string> headerTextWords = ModType.Humanize(LetterCasing.Title).Split(' ');
 
             if (headerTextWords.Count() > 1)
             {
@@ -211,7 +212,7 @@ namespace osu.Game.Overlays.Mods
         {
             availableMods.BindTo(game.AvailableMods);
 
-            headerBackground.Colour = accentColour = colours.ForModType(modType);
+            headerBackground.Colour = accentColour = colours.ForModType(ModType);
 
             if (toggleAllCheckbox != null)
             {
@@ -227,6 +228,12 @@ namespace osu.Game.Overlays.Mods
         {
             base.LoadComplete();
             availableMods.BindValueChanged(_ => Scheduler.AddOnce(updateMods));
+            SelectedMods.BindValueChanged(_ =>
+            {
+                // if a load is in progress, don't try to update the selection - the load flow will do so.
+                if (latestLoadTask == null)
+                    updateActiveState();
+            });
             updateMods();
         }
 
@@ -234,7 +241,7 @@ namespace osu.Game.Overlays.Mods
 
         private void updateMods()
         {
-            var newMods = ModUtils.FlattenMods(availableMods.Value.GetValueOrDefault(modType) ?? Array.Empty<Mod>()).ToList();
+            var newMods = ModUtils.FlattenMods(availableMods.Value.GetValueOrDefault(ModType) ?? Array.Empty<Mod>()).ToList();
 
             if (newMods.SequenceEqual(panelFlow.Children.Select(p => p.Mod)))
                 return;
@@ -252,18 +259,20 @@ namespace osu.Game.Overlays.Mods
             {
                 panelFlow.ChildrenEnumerable = loaded;
 
+                updateActiveState();
+                updateToggleAllState();
+                updateFilter();
+
                 foreach (var panel in panelFlow)
                 {
                     panel.Active.BindValueChanged(_ =>
                     {
-                        updateToggleState();
-                        ModStateChanged?.Invoke(panel.Mod, panel.Active.Value);
+                        updateToggleAllState();
+                        SelectedMods.Value = panel.Active.Value
+                            ? SelectedMods.Value.Append(panel.Mod).ToArray()
+                            : SelectedMods.Value.Except(new[] { panel.Mod }).ToArray();
                     });
                 }
-
-                updateToggleState();
-
-                updateFilter();
             }, (cancellationTokenSource = new CancellationTokenSource()).Token);
             loadTask.ContinueWith(_ =>
             {
@@ -272,6 +281,12 @@ namespace osu.Game.Overlays.Mods
             });
         }
 
+        private void updateActiveState()
+        {
+            foreach (var panel in panelFlow)
+                panel.Active.Value = SelectedMods.Value.Contains(panel.Mod, EqualityComparer<Mod>.Default);
+        }
+
         #region Bulk select / deselect
 
         private const double initial_multiple_selection_delay = 120;
@@ -306,7 +321,7 @@ namespace osu.Game.Overlays.Mods
             }
         }
 
-        private void updateToggleState()
+        private void updateToggleAllState()
         {
             if (toggleAllCheckbox != null && !SelectionAnimationRunning)
             {
@@ -408,7 +423,7 @@ namespace osu.Game.Overlays.Mods
             foreach (var modPanel in panelFlow)
                 modPanel.ApplyFilter(Filter);
 
-            updateToggleState();
+            updateToggleAllState();
         }
 
         #endregion
diff --git a/osu.Game/Overlays/Mods/ModSelectScreen.cs b/osu.Game/Overlays/Mods/ModSelectScreen.cs
index 0a9b1ddbcb..659c88e070 100644
--- a/osu.Game/Overlays/Mods/ModSelectScreen.cs
+++ b/osu.Game/Overlays/Mods/ModSelectScreen.cs
@@ -167,13 +167,6 @@ namespace osu.Game.Overlays.Mods
                 }
             };
 
-            foreach (var column in columnFlow)
-            {
-                column.ModStateChanged = (mod, active) => SelectedMods.Value = active
-                    ? SelectedMods.Value.Append(mod).ToArray()
-                    : SelectedMods.Value.Except(new[] { mod }).ToArray();
-            }
-
             columnFlow.Shear = new Vector2(ModPanel.SHEAR_X, 0);
         }
 
@@ -182,11 +175,19 @@ namespace osu.Game.Overlays.Mods
             base.LoadComplete();
 
             ((IBindable<IReadOnlyList<Mod>>)modSettingsArea.SelectedMods).BindTo(SelectedMods);
+
             SelectedMods.BindValueChanged(val =>
             {
                 updateMultiplier();
                 updateCustomisation(val);
+                updateSelectionFromBindable();
             }, true);
+
+            foreach (var column in columnFlow)
+            {
+                column.SelectedMods.BindValueChanged(_ => updateBindableFromSelection());
+            }
+
             customisationVisible.BindValueChanged(_ => updateCustomisationVisualState(), true);
 
             FinishTransforms(true);
@@ -239,6 +240,33 @@ namespace osu.Game.Overlays.Mods
             mainContent.TransformTo(nameof(Margin), new MarginPadding { Bottom = modAreaHeight }, 800, Easing.InOutCubic);
         }
 
+        private bool selectionBindableSyncInProgress;
+
+        private void updateSelectionFromBindable()
+        {
+            if (selectionBindableSyncInProgress)
+                return;
+
+            selectionBindableSyncInProgress = true;
+
+            foreach (var column in columnFlow)
+                column.SelectedMods.Value = SelectedMods.Value.Where(mod => mod.Type == column.ModType).ToArray();
+
+            selectionBindableSyncInProgress = false;
+        }
+
+        private void updateBindableFromSelection()
+        {
+            if (selectionBindableSyncInProgress)
+                return;
+
+            selectionBindableSyncInProgress = true;
+
+            SelectedMods.Value = columnFlow.SelectMany(column => column.SelectedMods.Value).ToArray();
+
+            selectionBindableSyncInProgress = false;
+        }
+
         protected override void PopIn()
         {
             base.PopIn();

From a172b194f0a97d546e7af99ee34f93512cb8c594 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 3 Apr 2022 18:38:23 +0200
Subject: [PATCH 3894/5547] Add testing for different rulesets

---
 .../UserInterface/TestSceneModSelectScreen.cs      | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs
index a5f5048961..0d568cd030 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs
@@ -9,8 +9,12 @@ using osu.Framework.Testing;
 using osu.Framework.Utils;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Overlays.Mods;
+using osu.Game.Rulesets.Catch;
+using osu.Game.Rulesets.Mania;
 using osu.Game.Rulesets.Mods;
+using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Osu.Mods;
+using osu.Game.Rulesets.Taiko;
 using osuTK.Input;
 
 namespace osu.Game.Tests.Visual.UserInterface
@@ -68,6 +72,16 @@ namespace osu.Game.Tests.Visual.UserInterface
             assertCustomisationToggleState(disabled: false, active: false);
         }
 
+        [Test]
+        public void TestRulesetChange()
+        {
+            createScreen();
+            AddStep("change to osu!", () => Ruleset.Value = new OsuRuleset().RulesetInfo);
+            AddStep("change to osu!taiko", () => Ruleset.Value = new TaikoRuleset().RulesetInfo);
+            AddStep("change to osu!catch", () => Ruleset.Value = new CatchRuleset().RulesetInfo);
+            AddStep("change to osu!mania", () => Ruleset.Value = new ManiaRuleset().RulesetInfo);
+        }
+
         [Test]
         public void TestCustomisationToggleState()
         {

From 90e44b67ea0c883128e7e2fe11da91e2e18101e9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 3 Apr 2022 20:24:32 +0200
Subject: [PATCH 3895/5547] Improve robustness of test code

---
 .../UserInterface/TestSceneModSelectScreen.cs | 42 +++++++++++++------
 1 file changed, 29 insertions(+), 13 deletions(-)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs
index 0d568cd030..47cff40873 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs
@@ -3,18 +3,16 @@
 
 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.Framework.Utils;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Overlays.Mods;
-using osu.Game.Rulesets.Catch;
-using osu.Game.Rulesets.Mania;
+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;
 using osuTK.Input;
 
 namespace osu.Game.Tests.Visual.UserInterface
@@ -22,20 +20,29 @@ namespace osu.Game.Tests.Visual.UserInterface
     [TestFixture]
     public class TestSceneModSelectScreen : OsuManualInputManagerTestScene
     {
+        [Resolved]
+        private RulesetStore rulesetStore { get; set; }
+
         private ModSelectScreen modSelectScreen;
 
         [SetUpSteps]
         public void SetUpSteps()
         {
+            AddStep("clear contents", Clear);
+            AddStep("reset ruleset", () => Ruleset.Value = rulesetStore.GetRuleset(0));
             AddStep("reset mods", () => SelectedMods.SetDefault());
         }
 
-        private void createScreen() => AddStep("create screen", () => Child = modSelectScreen = new ModSelectScreen
+        private void createScreen()
         {
-            RelativeSizeAxes = Axes.Both,
-            State = { Value = Visibility.Visible },
-            SelectedMods = { BindTarget = SelectedMods }
-        });
+            AddStep("create screen", () => Child = modSelectScreen = new ModSelectScreen
+            {
+                RelativeSizeAxes = Axes.Both,
+                State = { Value = Visibility.Visible },
+                SelectedMods = { BindTarget = SelectedMods }
+            });
+            waitForColumnLoad();
+        }
 
         [Test]
         public void TestStateChange()
@@ -76,10 +83,10 @@ namespace osu.Game.Tests.Visual.UserInterface
         public void TestRulesetChange()
         {
             createScreen();
-            AddStep("change to osu!", () => Ruleset.Value = new OsuRuleset().RulesetInfo);
-            AddStep("change to osu!taiko", () => Ruleset.Value = new TaikoRuleset().RulesetInfo);
-            AddStep("change to osu!catch", () => Ruleset.Value = new CatchRuleset().RulesetInfo);
-            AddStep("change to osu!mania", () => Ruleset.Value = new ManiaRuleset().RulesetInfo);
+            changeRuleset(0);
+            changeRuleset(1);
+            changeRuleset(2);
+            changeRuleset(3);
         }
 
         [Test]
@@ -113,6 +120,15 @@ namespace osu.Game.Tests.Visual.UserInterface
             assertCustomisationToggleState(disabled: true, active: false); // config was dismissed without explicit user action.
         }
 
+        private void waitForColumnLoad() => AddUntilStep("all column content loaded",
+            () => modSelectScreen.ChildrenOfType<ModColumn>().Any() && modSelectScreen.ChildrenOfType<ModColumn>().All(column => column.IsLoaded && column.ItemsLoaded));
+
+        private void changeRuleset(int id)
+        {
+            AddStep($"set ruleset to {id}", () => Ruleset.Value = rulesetStore.GetRuleset(id));
+            waitForColumnLoad();
+        }
+
         private void assertCustomisationToggleState(bool disabled, bool active)
         {
             ShearedToggleButton getToggle() => modSelectScreen.ChildrenOfType<ShearedToggleButton>().Single();

From e1f147a207a42f47370ac42527226212e23d3f9c Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Mon, 4 Apr 2022 13:46:41 +0900
Subject: [PATCH 3896/5547] Mutate playlist in EditUserPlaylistItem

---
 osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
index 0efaf16f99..4a974cf61d 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
@@ -458,8 +458,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
         public async Task EditUserPlaylistItem(int userId, MultiplayerPlaylistItem item)
         {
             Debug.Assert(Room != null);
-            Debug.Assert(APIRoom != null);
             Debug.Assert(currentItem != null);
+            Debug.Assert(serverSideAPIRoom != null);
 
             item.OwnerID = userId;
 
@@ -478,6 +478,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             item.PlaylistOrder = existingItem.PlaylistOrder;
 
             serverSidePlaylist[serverSidePlaylist.IndexOf(existingItem)] = item;
+            serverSideAPIRoom.Playlist[serverSideAPIRoom.Playlist.IndexOf(serverSideAPIRoom.Playlist.Single(i => i.ID == item.ID))] = new PlaylistItem(item);
 
             await ((IMultiplayerClient)this).PlaylistItemChanged(item).ConfigureAwait(false);
         }

From 39c6eed81969fe883264c04610c4b05ea0968816 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 4 Apr 2022 14:10:57 +0900
Subject: [PATCH 3897/5547] Update resources

---
 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 6a3b113fa2..200008017f 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -51,7 +51,7 @@
     <Reference Include="Java.Interop" />
   </ItemGroup>
   <ItemGroup>
-    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.325.0" />
+    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.404.0" />
     <PackageReference Include="ppy.osu.Framework.Android" Version="2022.325.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 3c01f29671..18faf318a6 100644
--- a/osu.Game/osu.Game.csproj
+++ b/osu.Game/osu.Game.csproj
@@ -37,7 +37,7 @@
     </PackageReference>
     <PackageReference Include="Realm" Version="10.10.0" />
     <PackageReference Include="ppy.osu.Framework" Version="2022.325.0" />
-    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.325.0" />
+    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.404.0" />
     <PackageReference Include="Sentry" Version="3.14.1" />
     <PackageReference Include="SharpCompress" Version="0.30.1" />
     <PackageReference Include="NUnit" Version="3.13.2" />
diff --git a/osu.iOS.props b/osu.iOS.props
index c8f170497d..b0c382c695 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -62,7 +62,7 @@
   </ItemGroup>
   <ItemGroup Label="Package References">
     <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.325.0" />
-    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.325.0" />
+    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.404.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net6.0) -->
   <PropertyGroup>

From 0abebe4d23a17cfd772fe1b700ddefb2a2427a57 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 4 Apr 2022 14:36:03 +0900
Subject: [PATCH 3898/5547] Stabilise countdown updates to be based on when
 whole seconds change

---
 .../Match/MultiplayerReadyButton.cs           | 50 ++++++++++++++-----
 1 file changed, 37 insertions(+), 13 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
index 62be9ad3bd..a20d250ea8 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
@@ -47,17 +47,33 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
                 countdownChangeTime = DateTimeOffset.Now;
             }
 
+            scheduleNextCountdownUpdate();
+
+            updateButtonText();
+            updateButtonColour();
+        });
+
+        private void scheduleNextCountdownUpdate()
+        {
             if (countdown != null)
-                countdownUpdateDelegate ??= Scheduler.AddDelayed(updateButtonText, 100, true);
+            {
+                // If a countdown is active, schedule relevant components to update on the next whole second.
+                double timeToNextSecond = countdownTimeRemaining.TotalMilliseconds % 1000;
+
+                countdownUpdateDelegate = Scheduler.AddDelayed(onCountdownTick, timeToNextSecond);
+            }
             else
             {
                 countdownUpdateDelegate?.Cancel();
                 countdownUpdateDelegate = null;
             }
 
-            updateButtonText();
-            updateButtonColour();
-        });
+            void onCountdownTick()
+            {
+                updateButtonText();
+                scheduleNextCountdownUpdate();
+            }
+        }
 
         private void updateButtonText()
         {
@@ -75,15 +91,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
 
             if (countdown != null)
             {
-                TimeSpan timeElapsed = DateTimeOffset.Now - countdownChangeTime;
-                TimeSpan countdownRemaining;
-
-                if (timeElapsed > countdown.TimeRemaining)
-                    countdownRemaining = TimeSpan.Zero;
-                else
-                    countdownRemaining = countdown.TimeRemaining - timeElapsed;
-
-                string countdownText = $"Starting in {countdownRemaining:mm\\:ss}";
+                string countdownText = $"Starting in {countdownTimeRemaining:mm\\:ss}";
 
                 switch (localUser?.State)
                 {
@@ -116,6 +124,22 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
             }
         }
 
+        private TimeSpan countdownTimeRemaining
+        {
+            get
+            {
+                TimeSpan timeElapsed = DateTimeOffset.Now - countdownChangeTime;
+                TimeSpan remaining;
+
+                if (timeElapsed > countdown.TimeRemaining)
+                    remaining = TimeSpan.Zero;
+                else
+                    remaining = countdown.TimeRemaining - timeElapsed;
+
+                return remaining;
+            }
+        }
+
         private void updateButtonColour()
         {
             if (room == null)

From 3ba81f3fdce3791d50f526849a320919a1e9d9fb Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 4 Apr 2022 15:29:03 +0900
Subject: [PATCH 3899/5547] Fix overlapping variable usage

---
 .../Visual/UserInterface/TestSceneModSelectScreen.cs          | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs
index 47cff40873..1e9357b6c4 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs
@@ -59,7 +59,7 @@ namespace osu.Game.Tests.Visual.UserInterface
             AddUntilStep("two panels active", () => modSelectScreen.ChildrenOfType<ModPanel>().Count(panel => panel.Active.Value) == 2);
             AddAssert("mod multiplier correct", () =>
             {
-                double multiplier = SelectedMods.Value.Aggregate(1d, (multiplier, mod) => multiplier * mod.ScoreMultiplier);
+                double multiplier = SelectedMods.Value.Aggregate(1d, (m, mod) => m * mod.ScoreMultiplier);
                 return Precision.AlmostEquals(multiplier, modSelectScreen.ChildrenOfType<DifficultyMultiplierDisplay>().Single().Current.Value);
             });
             assertCustomisationToggleState(disabled: false, active: false);
@@ -73,7 +73,7 @@ namespace osu.Game.Tests.Visual.UserInterface
             AddUntilStep("two panels active", () => modSelectScreen.ChildrenOfType<ModPanel>().Count(panel => panel.Active.Value) == 2);
             AddAssert("mod multiplier correct", () =>
             {
-                double multiplier = SelectedMods.Value.Aggregate(1d, (multiplier, mod) => multiplier * mod.ScoreMultiplier);
+                double multiplier = SelectedMods.Value.Aggregate(1d, (m, mod) => m * mod.ScoreMultiplier);
                 return Precision.AlmostEquals(multiplier, modSelectScreen.ChildrenOfType<DifficultyMultiplierDisplay>().Single().Current.Value);
             });
             assertCustomisationToggleState(disabled: false, active: false);

From b5df3500079489c969ba95666a7c94c0cf977d41 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 4 Apr 2022 15:45:44 +0900
Subject: [PATCH 3900/5547] Adjust pop in/out transitions

---
 osu.Game/Overlays/Mods/ModSelectScreen.cs | 26 +++++++++++++++++------
 1 file changed, 19 insertions(+), 7 deletions(-)

diff --git a/osu.Game/Overlays/Mods/ModSelectScreen.cs b/osu.Game/Overlays/Mods/ModSelectScreen.cs
index 659c88e070..fb991f60ba 100644
--- a/osu.Game/Overlays/Mods/ModSelectScreen.cs
+++ b/osu.Game/Overlays/Mods/ModSelectScreen.cs
@@ -38,6 +38,9 @@ namespace osu.Game.Overlays.Mods
         private GridContainer grid;
         private Container mainContent;
 
+        private PopupScreenTitle header;
+        private Container footer;
+
         [BackgroundDependencyLoader]
         private void load()
         {
@@ -67,7 +70,7 @@ namespace osu.Game.Overlays.Mods
                             {
                                 new Drawable[]
                                 {
-                                    new PopupScreenTitle
+                                    header = new PopupScreenTitle
                                     {
                                         Anchor = Anchor.TopCentre,
                                         Origin = Anchor.TopCentre,
@@ -96,7 +99,6 @@ namespace osu.Game.Overlays.Mods
                                     {
                                         RelativeSizeAxes = Axes.Both,
                                         RelativePositionAxes = Axes.Both,
-                                        X = 1,
                                         Padding = new MarginPadding { Horizontal = 70 },
                                         Children = new Drawable[]
                                         {
@@ -126,7 +128,7 @@ namespace osu.Game.Overlays.Mods
                                 new[] { Empty() }
                             }
                         },
-                        new Container
+                        footer = new Container
                         {
                             RelativeSizeAxes = Axes.X,
                             AutoSizeAxes = Axes.Y,
@@ -269,16 +271,26 @@ namespace osu.Game.Overlays.Mods
 
         protected override void PopIn()
         {
+            const double fade_in_duration = 500;
+
             base.PopIn();
-            this.MoveToY(0, 800, Easing.OutQuint);
-            columnContainer.MoveToX(0, 800, Easing.OutQuint);
+
+            header.MoveToY(0, fade_in_duration, Easing.OutQuint);
+            footer.MoveToY(0, fade_in_duration, Easing.OutQuint);
+
+            this.FadeIn(fade_in_duration, Easing.OutQuint);
         }
 
         protected override void PopOut()
         {
+            const double fade_out_duration = 500;
+
             base.PopOut();
-            this.MoveToY(1.2f, 800, Easing.OutQuint);
-            columnContainer.MoveToX(1, 800, Easing.OutQuint);
+
+            header.MoveToY(-header.DrawHeight, fade_out_duration, Easing.OutQuint);
+            footer.MoveToY(footer.DrawHeight, fade_out_duration, Easing.OutQuint);
+
+            this.FadeOut(fade_out_duration, Easing.OutQuint);
         }
 
         private class ModColumnContainer : FillFlowContainer<ModColumn>

From bc53adb72a14e5bbc16d320243a76388d2cc063e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 4 Apr 2022 15:50:40 +0900
Subject: [PATCH 3901/5547] Adjust customisation transition slightly

---
 osu.Game/Overlays/Mods/ModSelectScreen.cs | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Overlays/Mods/ModSelectScreen.cs b/osu.Game/Overlays/Mods/ModSelectScreen.cs
index fb991f60ba..b3435affff 100644
--- a/osu.Game/Overlays/Mods/ModSelectScreen.cs
+++ b/osu.Game/Overlays/Mods/ModSelectScreen.cs
@@ -234,12 +234,14 @@ namespace osu.Game.Overlays.Mods
 
         private void updateCustomisationVisualState()
         {
-            grid.FadeColour(customisationVisible.Value ? Colour4.Gray : Colour4.White, 800, Easing.OutQuint);
+            const double transition_duration = 700;
+
+            grid.FadeColour(customisationVisible.Value ? Colour4.Gray : Colour4.White, transition_duration, Easing.InOutCubic);
 
             float modAreaHeight = customisationVisible.Value ? ModSettingsArea.HEIGHT : 0;
 
-            modSettingsArea.ResizeHeightTo(modAreaHeight, 800, Easing.InOutCubic);
-            mainContent.TransformTo(nameof(Margin), new MarginPadding { Bottom = modAreaHeight }, 800, Easing.InOutCubic);
+            modSettingsArea.ResizeHeightTo(modAreaHeight, transition_duration, Easing.InOutCubic);
+            mainContent.TransformTo(nameof(Margin), new MarginPadding { Bottom = modAreaHeight }, transition_duration, Easing.InOutCubic);
         }
 
         private bool selectionBindableSyncInProgress;

From 09e15f5496a8ecee0f0c77f3743a3b664a150da9 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 4 Apr 2022 20:27:03 +0900
Subject: [PATCH 3902/5547] Remove nullable on `RealmBackedResourceStore` realm
 parameter

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

diff --git a/osu.Game/Skinning/RealmBackedResourceStore.cs b/osu.Game/Skinning/RealmBackedResourceStore.cs
index e727a7e59a..c81e976a67 100644
--- a/osu.Game/Skinning/RealmBackedResourceStore.cs
+++ b/osu.Game/Skinning/RealmBackedResourceStore.cs
@@ -24,7 +24,7 @@ namespace osu.Game.Skinning
         private readonly Live<T> liveSource;
         private readonly IDisposable? realmSubscription;
 
-        public RealmBackedResourceStore(Live<T> source, IResourceStore<byte[]> underlyingStore, RealmAccess? realm)
+        public RealmBackedResourceStore(Live<T> source, IResourceStore<byte[]> underlyingStore, RealmAccess realm)
             : base(underlyingStore)
         {
             liveSource = source;
@@ -32,7 +32,7 @@ namespace osu.Game.Skinning
             invalidateCache();
             Debug.Assert(fileToStoragePathMapping != null);
 
-            realmSubscription = realm?.RegisterForNotifications(r => r.All<T>().Where(s => s.ID == source.ID), skinChanged);
+            realmSubscription = realm.RegisterForNotifications(r => r.All<T>().Where(s => s.ID == source.ID), skinChanged);
         }
 
         protected override void Dispose(bool disposing)

From 300feadf6a9adba8120db8dc3e50fcef5c33c99d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 4 Apr 2022 20:27:46 +0900
Subject: [PATCH 3903/5547] Update `SkinnableSprite` to match more broad usage

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

diff --git a/osu.Game/Skinning/SkinnableSprite.cs b/osu.Game/Skinning/SkinnableSprite.cs
index c6cc4c1bdd..e7c62302b1 100644
--- a/osu.Game/Skinning/SkinnableSprite.cs
+++ b/osu.Game/Skinning/SkinnableSprite.cs
@@ -15,7 +15,7 @@ using osuTK;
 namespace osu.Game.Skinning
 {
     /// <summary>
-    /// A skinnable element which uses a stable sprite and can therefore share implementation logic.
+    /// A skinnable element which uses a single texture backing.
     /// </summary>
     public class SkinnableSprite : SkinnableDrawable, ISkinnableDrawable
     {

From dac5dfde8f8cee98be41887a5b4c94444efe3953 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 4 Apr 2022 20:28:43 +0900
Subject: [PATCH 3904/5547] Remove unnecessary `LazyThreadSafetyMode`
 specification

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

diff --git a/osu.Game/Skinning/RealmBackedResourceStore.cs b/osu.Game/Skinning/RealmBackedResourceStore.cs
index c81e976a67..0353b8a64d 100644
--- a/osu.Game/Skinning/RealmBackedResourceStore.cs
+++ b/osu.Game/Skinning/RealmBackedResourceStore.cs
@@ -61,7 +61,7 @@ namespace osu.Game.Skinning
             return null;
         }
 
-        private void invalidateCache() => fileToStoragePathMapping = new Lazy<Dictionary<string, string>>(initialiseFileCache, LazyThreadSafetyMode.ExecutionAndPublication);
+        private void invalidateCache() => fileToStoragePathMapping = new Lazy<Dictionary<string, string>>(initialiseFileCache);
 
         private Dictionary<string, string> initialiseFileCache() => liveSource.PerformRead(source =>
         {

From de30a42558b7ab5d0e03cae2ed80d574cb694732 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 4 Apr 2022 20:30:14 +0900
Subject: [PATCH 3905/5547] Add `region` for import methods and move `Dispose`
 to end of time

---
 osu.Game/Skinning/Editor/SkinEditor.cs | 18 +++++++++++-------
 1 file changed, 11 insertions(+), 7 deletions(-)

diff --git a/osu.Game/Skinning/Editor/SkinEditor.cs b/osu.Game/Skinning/Editor/SkinEditor.cs
index df0bb7a70c..607a881d28 100644
--- a/osu.Game/Skinning/Editor/SkinEditor.cs
+++ b/osu.Game/Skinning/Editor/SkinEditor.cs
@@ -197,13 +197,6 @@ namespace osu.Game.Skinning.Editor
             SelectedComponents.BindCollectionChanged((_, __) => Scheduler.AddOnce(populateSettings), true);
         }
 
-        protected override void Dispose(bool isDisposing)
-        {
-            base.Dispose(isDisposing);
-
-            game?.UnregisterImportHandler(this);
-        }
-
         public void UpdateTargetScreen(Drawable targetScreen)
         {
             this.targetScreen = targetScreen;
@@ -337,6 +330,8 @@ namespace osu.Game.Skinning.Editor
                 availableTargets.FirstOrDefault(t => t.Components.Contains(item))?.Remove(item);
         }
 
+        #region Drag & drop import handling
+
         public Task Import(params string[] paths)
         {
             Schedule(() =>
@@ -368,5 +363,14 @@ namespace osu.Game.Skinning.Editor
         public Task Import(params ImportTask[] tasks) => throw new NotImplementedException();
 
         public IEnumerable<string> HandledExtensions => new[] { ".jpg", ".jpeg", ".png" };
+
+        #endregion
+
+        protected override void Dispose(bool isDisposing)
+        {
+            base.Dispose(isDisposing);
+
+            game?.UnregisterImportHandler(this);
+        }
     }
 }

From 8185020f128dcda5d5a1feb236b02e7a3fbd51d7 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 4 Apr 2022 20:35:48 +0900
Subject: [PATCH 3906/5547] Improve the visual of the missing sprite sprite

---
 osu.Game/Skinning/RealmBackedResourceStore.cs |  1 -
 osu.Game/Skinning/SkinnableSprite.cs          | 33 +++++++++++++++----
 2 files changed, 26 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Skinning/RealmBackedResourceStore.cs b/osu.Game/Skinning/RealmBackedResourceStore.cs
index 0353b8a64d..0057132044 100644
--- a/osu.Game/Skinning/RealmBackedResourceStore.cs
+++ b/osu.Game/Skinning/RealmBackedResourceStore.cs
@@ -7,7 +7,6 @@ using System;
 using System.Collections.Generic;
 using System.Diagnostics;
 using System.Linq;
-using System.Threading;
 using osu.Framework.Extensions;
 using osu.Framework.IO.Stores;
 using osu.Game.Database;
diff --git a/osu.Game/Skinning/SkinnableSprite.cs b/osu.Game/Skinning/SkinnableSprite.cs
index e7c62302b1..c5f110f908 100644
--- a/osu.Game/Skinning/SkinnableSprite.cs
+++ b/osu.Game/Skinning/SkinnableSprite.cs
@@ -6,9 +6,11 @@ using System.Linq;
 using osu.Framework.Allocation;
 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.Game.Configuration;
+using osu.Game.Graphics.Sprites;
 using osu.Game.Overlays.Settings;
 using osuTK;
 
@@ -55,13 +57,7 @@ namespace osu.Game.Skinning
             var texture = textures.Get(component.LookupName);
 
             if (texture == null)
-            {
-                return new SpriteIcon
-                {
-                    Size = new Vector2(100),
-                    Icon = FontAwesome.Solid.QuestionCircle
-                };
-            }
+                return new SpriteNotFound(component.LookupName);
 
             return new Sprite { Texture = texture };
         }
@@ -98,5 +94,28 @@ namespace osu.Game.Skinning
                     Items = availableFiles;
             }
         }
+
+        public class SpriteNotFound : CompositeDrawable
+        {
+            public SpriteNotFound(string lookup)
+            {
+                AutoSizeAxes = Axes.Both;
+
+                InternalChildren = new Drawable[]
+                {
+                    new SpriteIcon
+                    {
+                        Size = new Vector2(50),
+                        Icon = FontAwesome.Solid.QuestionCircle
+                    },
+                    new OsuSpriteText
+                    {
+                        Position = new Vector2(25, 50),
+                        Text = $"missing: {lookup}",
+                        Origin = Anchor.TopCentre,
+                    }
+                };
+            }
+        }
     }
 }

From 5f358a04e98ba580ce6fa7b7c32ee23a35d8cba3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 4 Apr 2022 20:40:19 +0900
Subject: [PATCH 3907/5547] Return a valid "lighting" response from
 `DefaultSkin`

This is temporary to allow the new sprite lookup flow to potentially be
merged before hit lighting skinnability is addressed.
---
 osu.Game/Skinning/DefaultSkin.cs | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/osu.Game/Skinning/DefaultSkin.cs b/osu.Game/Skinning/DefaultSkin.cs
index c645b0fae4..119b0ec9ad 100644
--- a/osu.Game/Skinning/DefaultSkin.cs
+++ b/osu.Game/Skinning/DefaultSkin.cs
@@ -158,6 +158,13 @@ namespace osu.Game.Skinning
                     break;
             }
 
+            switch (component.LookupName)
+            {
+                // Temporary until default skin has a valid hit lighting.
+                case @"lighting":
+                    return Drawable.Empty();
+            }
+
             if (GetTexture(component.LookupName) is Texture t)
                 return new Sprite { Texture = t };
 

From 57b8c32f253f94df284fe1a9c9b4b739f9b4ac54 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 4 Apr 2022 20:42:12 +0900
Subject: [PATCH 3908/5547] Remove unused fields

---
 osu.Game/Overlays/Mods/ModSelectScreen.cs | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/osu.Game/Overlays/Mods/ModSelectScreen.cs b/osu.Game/Overlays/Mods/ModSelectScreen.cs
index b3435affff..8baf141c61 100644
--- a/osu.Game/Overlays/Mods/ModSelectScreen.cs
+++ b/osu.Game/Overlays/Mods/ModSelectScreen.cs
@@ -33,7 +33,6 @@ namespace osu.Game.Overlays.Mods
 
         private DifficultyMultiplierDisplay multiplierDisplay;
         private ModSettingsArea modSettingsArea;
-        private Container columnContainer;
         private FillFlowContainer<ModColumn> columnFlow;
         private GridContainer grid;
         private Container mainContent;
@@ -95,7 +94,7 @@ namespace osu.Game.Overlays.Mods
                                 },
                                 new Drawable[]
                                 {
-                                    columnContainer = new Container
+                                    new Container
                                     {
                                         RelativeSizeAxes = Axes.Both,
                                         RelativePositionAxes = Axes.Both,

From 6b5ee6d89dbf64de2003f0b8cb9e77da75def66b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 4 Apr 2022 20:44:05 +0900
Subject: [PATCH 3909/5547] Update framework

---
 osu.Android.props        | 2 +-
 osu.Game/osu.Game.csproj | 2 +-
 osu.iOS.props            | 4 ++--
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Android.props b/osu.Android.props
index 6a3b113fa2..ff14c97cd9 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -52,7 +52,7 @@
   </ItemGroup>
   <ItemGroup>
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.325.0" />
-    <PackageReference Include="ppy.osu.Framework.Android" Version="2022.325.0" />
+    <PackageReference Include="ppy.osu.Framework.Android" Version="2022.404.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
     <!-- Realm needs to be directly referenced in all Xamarin projects, as it will not pull in its transitive dependencies otherwise. -->
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 3c01f29671..7b0f8c72c5 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="10.10.0" />
-    <PackageReference Include="ppy.osu.Framework" Version="2022.325.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2022.404.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.325.0" />
     <PackageReference Include="Sentry" Version="3.14.1" />
     <PackageReference Include="SharpCompress" Version="0.30.1" />
diff --git a/osu.iOS.props b/osu.iOS.props
index c8f170497d..88daf2eda7 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -61,7 +61,7 @@
     <Reference Include="System.Net.Http" />
   </ItemGroup>
   <ItemGroup Label="Package References">
-    <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.325.0" />
+    <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.404.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.325.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net6.0) -->
@@ -84,7 +84,7 @@
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="5.0.14" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.Core" Version="5.0.14" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
-    <PackageReference Include="ppy.osu.Framework" Version="2022.325.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2022.404.0" />
     <PackageReference Include="SharpCompress" Version="0.30.1" />
     <PackageReference Include="NUnit" Version="3.13.2" />
     <PackageReference Include="System.ComponentModel.Annotations" Version="5.0.0" />

From 3708f2b744b46251c3d680b27ce7583109f3f2b2 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 5 Apr 2022 01:05:04 +0900
Subject: [PATCH 3910/5547] Update resources

---
 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 3203ffeac3..fbe13b11ee 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -51,7 +51,7 @@
     <Reference Include="Java.Interop" />
   </ItemGroup>
   <ItemGroup>
-    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.404.0" />
+    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.405.0" />
     <PackageReference Include="ppy.osu.Framework.Android" Version="2022.404.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 7e193a37f9..1bebf78d97 100644
--- a/osu.Game/osu.Game.csproj
+++ b/osu.Game/osu.Game.csproj
@@ -37,7 +37,7 @@
     </PackageReference>
     <PackageReference Include="Realm" Version="10.10.0" />
     <PackageReference Include="ppy.osu.Framework" Version="2022.404.0" />
-    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.404.0" />
+    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.405.0" />
     <PackageReference Include="Sentry" Version="3.14.1" />
     <PackageReference Include="SharpCompress" Version="0.30.1" />
     <PackageReference Include="NUnit" Version="3.13.2" />
diff --git a/osu.iOS.props b/osu.iOS.props
index a68bebeabe..efd5bac38e 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -62,7 +62,7 @@
   </ItemGroup>
   <ItemGroup Label="Package References">
     <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.404.0" />
-    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.404.0" />
+    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.405.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net6.0) -->
   <PropertyGroup>

From 9a07a95d39817ce408487253e410d845ee11c27d Mon Sep 17 00:00:00 2001
From: CenTdemeern1 <timo.herngreen@gmail.com>
Date: Mon, 4 Apr 2022 19:22:53 +0200
Subject: [PATCH 3911/5547] Make several delete confirmation buttons dangerous
 buttons

Includes:
- Mass deletion
- Beatmap deletion
- Local score deletion
---
 .../Sections/Maintenance/MassDeleteConfirmationDialog.cs        | 2 +-
 osu.Game/Screens/Select/BeatmapDeleteDialog.cs                  | 2 +-
 osu.Game/Screens/Select/LocalScoreDeleteDialog.cs               | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Overlays/Settings/Sections/Maintenance/MassDeleteConfirmationDialog.cs b/osu.Game/Overlays/Settings/Sections/Maintenance/MassDeleteConfirmationDialog.cs
index 6380232bbb..c481c80d82 100644
--- a/osu.Game/Overlays/Settings/Sections/Maintenance/MassDeleteConfirmationDialog.cs
+++ b/osu.Game/Overlays/Settings/Sections/Maintenance/MassDeleteConfirmationDialog.cs
@@ -17,7 +17,7 @@ namespace osu.Game.Overlays.Settings.Sections.Maintenance
             HeaderText = @"Confirm deletion of";
             Buttons = new PopupDialogButton[]
             {
-                new PopupDialogOkButton
+                new PopupDialogDangerousButton
                 {
                     Text = @"Yes. Go for it.",
                     Action = deleteAction
diff --git a/osu.Game/Screens/Select/BeatmapDeleteDialog.cs b/osu.Game/Screens/Select/BeatmapDeleteDialog.cs
index 1ac278d045..b156c2485b 100644
--- a/osu.Game/Screens/Select/BeatmapDeleteDialog.cs
+++ b/osu.Game/Screens/Select/BeatmapDeleteDialog.cs
@@ -26,7 +26,7 @@ namespace osu.Game.Screens.Select
             HeaderText = @"Confirm deletion of";
             Buttons = new PopupDialogButton[]
             {
-                new PopupDialogOkButton
+                new PopupDialogDangerousButton
                 {
                     Text = @"Yes. Totally. Delete it.",
                     Action = () => manager?.Delete(beatmap),
diff --git a/osu.Game/Screens/Select/LocalScoreDeleteDialog.cs b/osu.Game/Screens/Select/LocalScoreDeleteDialog.cs
index 1ae244281b..cb96e3f23e 100644
--- a/osu.Game/Screens/Select/LocalScoreDeleteDialog.cs
+++ b/osu.Game/Screens/Select/LocalScoreDeleteDialog.cs
@@ -38,7 +38,7 @@ namespace osu.Game.Screens.Select
             HeaderText = "Confirm deletion of local score";
             Buttons = new PopupDialogButton[]
             {
-                new PopupDialogOkButton
+                new PopupDialogDangerousButton
                 {
                     Text = "Yes. Please.",
                     Action = () => scoreManager?.Delete(score)

From 9b367d645d464bfcdeec61742de7768b928a8f5c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 4 Apr 2022 20:02:47 +0200
Subject: [PATCH 3912/5547] Always play pop in sequence

---
 osu.Game/Overlays/Mods/ModSelectScreen.cs | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Overlays/Mods/ModSelectScreen.cs b/osu.Game/Overlays/Mods/ModSelectScreen.cs
index 8baf141c61..7915fb755c 100644
--- a/osu.Game/Overlays/Mods/ModSelectScreen.cs
+++ b/osu.Game/Overlays/Mods/ModSelectScreen.cs
@@ -29,6 +29,8 @@ namespace osu.Game.Overlays.Mods
         [Cached]
         public Bindable<IReadOnlyList<Mod>> SelectedMods { get; private set; } = new Bindable<IReadOnlyList<Mod>>(Array.Empty<Mod>());
 
+        protected override bool StartHidden => true;
+
         private readonly BindableBool customisationVisible = new BindableBool();
 
         private DifficultyMultiplierDisplay multiplierDisplay;
@@ -164,7 +166,8 @@ namespace osu.Game.Overlays.Mods
                 modSettingsArea = new ModSettingsArea
                 {
                     Anchor = Anchor.BottomCentre,
-                    Origin = Anchor.BottomCentre
+                    Origin = Anchor.BottomCentre,
+                    Height = 0
                 }
             };
 
@@ -190,8 +193,6 @@ namespace osu.Game.Overlays.Mods
             }
 
             customisationVisible.BindValueChanged(_ => updateCustomisationVisualState(), true);
-
-            FinishTransforms(true);
         }
 
         private void updateMultiplier()

From 29b7460cc7454a8b4371c72f2f30858a04b146c2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 4 Apr 2022 20:05:54 +0200
Subject: [PATCH 3913/5547] Fix weird test step

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

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs
index 1e9357b6c4..34d9ddcc4e 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs
@@ -48,7 +48,7 @@ namespace osu.Game.Tests.Visual.UserInterface
         public void TestStateChange()
         {
             createScreen();
-            AddToggleStep("toggle state", visible => modSelectScreen.State.Value = visible ? Visibility.Visible : Visibility.Hidden);
+            AddStep("toggle state", () => modSelectScreen.ToggleVisibility());
         }
 
         [Test]

From a1ded66fd85bcc09e2cfe32cf2ca3d938726b2c7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 4 Apr 2022 21:59:09 +0200
Subject: [PATCH 3914/5547] Fix various breakage in delete local score test
 scene

---
 .../TestSceneDeleteLocalScore.cs              | 39 ++++++++++---------
 1 file changed, 21 insertions(+), 18 deletions(-)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
index a0a1feff36..c8a8fd43fb 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
@@ -44,9 +44,6 @@ namespace osu.Game.Tests.Visual.UserInterface
 
         private BeatmapInfo beatmapInfo;
 
-        [Resolved]
-        private RealmAccess realm { get; set; }
-
         [Cached]
         private readonly DialogOverlay dialogOverlay;
 
@@ -92,6 +89,12 @@ namespace osu.Game.Tests.Visual.UserInterface
             dependencies.Cache(scoreManager = new ScoreManager(dependencies.Get<RulesetStore>(), () => beatmapManager, LocalStorage, Realm, Scheduler));
             Dependencies.Cache(Realm);
 
+            return dependencies;
+        }
+
+        [BackgroundDependencyLoader]
+        private void load() => Schedule(() =>
+        {
             var imported = beatmapManager.Import(new ImportTask(TestResources.GetQuickTestBeatmapForImport())).GetResultSafely();
 
             imported?.PerformRead(s =>
@@ -115,26 +118,26 @@ namespace osu.Game.Tests.Visual.UserInterface
                     importedScores.Add(scoreManager.Import(score).Value);
                 }
             });
-
-            return dependencies;
-        }
-
-        [SetUp]
-        public void Setup() => Schedule(() =>
-        {
-            realm.Run(r =>
-            {
-                // Due to soft deletions, we can re-use deleted scores between test runs
-                scoreManager.Undelete(r.All<ScoreInfo>().Where(s => s.DeletePending).ToList());
-            });
-
-            leaderboard.BeatmapInfo = beatmapInfo;
-            leaderboard.RefetchScores(); // Required in the case that the beatmap hasn't changed
         });
 
         [SetUpSteps]
         public void SetupSteps()
         {
+            AddUntilStep("ensure scores imported", () => importedScores.Count == 50);
+            AddStep("undelete scores", () =>
+            {
+                Realm.Run(r =>
+                {
+                    // Due to soft deletions, we can re-use deleted scores between test runs
+                    scoreManager.Undelete(r.All<ScoreInfo>().Where(s => s.DeletePending).ToList());
+                });
+            });
+            AddStep("set up leaderboard", () =>
+            {
+                leaderboard.BeatmapInfo = beatmapInfo;
+                leaderboard.RefetchScores(); // Required in the case that the beatmap hasn't changed
+            });
+
             // Ensure the leaderboard items have finished showing up
             AddStep("finish transforms", () => leaderboard.FinishTransforms(true));
             AddUntilStep("wait for drawables", () => leaderboard.ChildrenOfType<LeaderboardScore>().Any());

From f73062a0d6c141290c93f227db7dd63173175324 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 4 Apr 2022 22:22:55 +0200
Subject: [PATCH 3915/5547] Revert "Remove nullable on
 `RealmBackedResourceStore` realm parameter"

This reverts commit 09e15f5496a8ecee0f0c77f3743a3b664a150da9.
---
 osu.Game/Skinning/RealmBackedResourceStore.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Skinning/RealmBackedResourceStore.cs b/osu.Game/Skinning/RealmBackedResourceStore.cs
index 0057132044..7fa24284ee 100644
--- a/osu.Game/Skinning/RealmBackedResourceStore.cs
+++ b/osu.Game/Skinning/RealmBackedResourceStore.cs
@@ -23,7 +23,7 @@ namespace osu.Game.Skinning
         private readonly Live<T> liveSource;
         private readonly IDisposable? realmSubscription;
 
-        public RealmBackedResourceStore(Live<T> source, IResourceStore<byte[]> underlyingStore, RealmAccess realm)
+        public RealmBackedResourceStore(Live<T> source, IResourceStore<byte[]> underlyingStore, RealmAccess? realm)
             : base(underlyingStore)
         {
             liveSource = source;
@@ -31,7 +31,7 @@ namespace osu.Game.Skinning
             invalidateCache();
             Debug.Assert(fileToStoragePathMapping != null);
 
-            realmSubscription = realm.RegisterForNotifications(r => r.All<T>().Where(s => s.ID == source.ID), skinChanged);
+            realmSubscription = realm?.RegisterForNotifications(r => r.All<T>().Where(s => s.ID == source.ID), skinChanged);
         }
 
         protected override void Dispose(bool disposing)

From da315f8a61b8e6d876dc47bfe709c17b8dc1241e Mon Sep 17 00:00:00 2001
From: CenTdemeern1 <timo.herngreen@gmail.com>
Date: Mon, 4 Apr 2022 22:44:35 +0200
Subject: [PATCH 3916/5547] Make the test hold the button instead of pressing
 it

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

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
index a0a1feff36..02a37627d7 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
@@ -169,7 +169,7 @@ namespace osu.Game.Tests.Visual.UserInterface
             AddStep("click delete button", () =>
             {
                 InputManager.MoveMouseTo(dialogOverlay.ChildrenOfType<DialogButton>().First());
-                InputManager.Click(MouseButton.Left);
+                InputManager.PressButton(MouseButton.Left);
             });
 
             AddUntilStep("wait for fetch", () => leaderboard.Scores != null);

From b2c822a3b1b1498513829c9d469062a52a4a12ec Mon Sep 17 00:00:00 2001
From: CenTdemeern1 <timo.herngreen@gmail.com>
Date: Mon, 4 Apr 2022 23:02:07 +0200
Subject: [PATCH 3917/5547] Release mouse button

---
 .../Visual/UserInterface/TestSceneDeleteLocalScore.cs          | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
index 02a37627d7..26e7b5bdda 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
@@ -174,6 +174,9 @@ namespace osu.Game.Tests.Visual.UserInterface
 
             AddUntilStep("wait for fetch", () => leaderboard.Scores != null);
             AddUntilStep("score removed from leaderboard", () => leaderboard.Scores.All(s => s.OnlineID != scoreBeingDeleted.OnlineID));
+
+            // "Clean up"
+            AddStep("release left mouse button", () => InputManager.ReleaseButton(MouseButton.Left));
         }
 
         [Test]

From 32c89f8643633fa7880292aa7d6828d7e6acaefa Mon Sep 17 00:00:00 2001
From: Ame <ajiiisai@protonmail.com>
Date: Tue, 5 Apr 2022 00:33:41 +0200
Subject: [PATCH 3918/5547] Handle repeated `OnPressed()` on `FooterButton`
 (without `FooterButtonRandom`)

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

diff --git a/osu.Game/Screens/Select/FooterButton.cs b/osu.Game/Screens/Select/FooterButton.cs
index 8d2ea47757..9cb178ca8b 100644
--- a/osu.Game/Screens/Select/FooterButton.cs
+++ b/osu.Game/Screens/Select/FooterButton.cs
@@ -174,7 +174,7 @@ namespace osu.Game.Screens.Select
 
         public virtual bool OnPressed(KeyBindingPressEvent<GlobalAction> e)
         {
-            if (e.Action == Hotkey)
+            if (e.Action == Hotkey && !e.Repeat)
             {
                 TriggerClick();
                 return true;

From 117d81d84f13c40fb7a782cfda8d1df6c5fa0c92 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Tue, 5 Apr 2022 03:04:53 +0300
Subject: [PATCH 3919/5547] Use perfect osu!(stable) strong scale value

Co-authored-by: Dean Herbert <pe@ppy.sh>
---
 osu.Game.Rulesets.Taiko/Objects/TaikoStrongableHitObject.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Taiko/Objects/TaikoStrongableHitObject.cs b/osu.Game.Rulesets.Taiko/Objects/TaikoStrongableHitObject.cs
index 43a099b900..6e0f6a3109 100644
--- a/osu.Game.Rulesets.Taiko/Objects/TaikoStrongableHitObject.cs
+++ b/osu.Game.Rulesets.Taiko/Objects/TaikoStrongableHitObject.cs
@@ -17,7 +17,7 @@ namespace osu.Game.Rulesets.Taiko.Objects
         /// <summary>
         /// Scale multiplier for a strong drawable taiko hit object.
         /// </summary>
-        public const float STRONG_SCALE = 1.525f;
+        public const float STRONG_SCALE = 1 / 0.65f;
 
         /// <summary>
         /// Default size of a strong drawable taiko hit object.

From 174dc1641c3fcc03cf72d8f3d35105a07c732d3e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 5 Apr 2022 11:49:57 +0900
Subject: [PATCH 3920/5547] Fix multiple issues with timekeeping

- Using realtime (`DateTimeOffset.Now`) meant that values would be
  changing in the same frame, causing misfirings or incorrect displays
- No debounce on sample playback meant that scheduling edge cases could
  potentially cause samples to be played more than once.
---
 .../Match/MultiplayerReadyButton.cs           | 30 ++++++++++++++-----
 1 file changed, 22 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
index a9092bc25a..9b7e9a925e 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
@@ -48,7 +48,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
         }
 
         private MultiplayerCountdown countdown;
-        private DateTimeOffset countdownChangeTime;
+        private double countdownChangeTime;
         private ScheduledDelegate countdownUpdateDelegate;
 
         private void onRoomUpdated() => Scheduler.AddOnce(() =>
@@ -56,7 +56,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
             if (countdown != room?.Countdown)
             {
                 countdown = room?.Countdown;
-                countdownChangeTime = DateTimeOffset.Now;
+                countdownChangeTime = Time.Current;
             }
 
             scheduleNextCountdownUpdate();
@@ -86,13 +86,27 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
 
                 int secondsRemaining = countdownTimeRemaining.Seconds;
 
-                if (secondsRemaining < 10) countdownTickSample?.Play();
-                if (secondsRemaining <= 3) countdownTickFinalSample?.Play();
+                playTickSound(secondsRemaining);
 
-                scheduleNextCountdownUpdate();
+                if (secondsRemaining > 0)
+                    scheduleNextCountdownUpdate();
             }
         }
 
+        private double? lastTickSampleTime;
+
+        private void playTickSound(int secondsRemaining)
+        {
+            // Simplified debounce. Ticks should only be played roughly once per second regardless of how often this function is called.
+            if (Time.Current - lastTickSampleTime < 500)
+                return;
+
+            lastTickSampleTime = Time.Current;
+
+            if (secondsRemaining < 10) countdownTickSample?.Play();
+            if (secondsRemaining <= 3) countdownTickFinalSample?.Play();
+        }
+
         private void updateButtonText()
         {
             if (room == null)
@@ -146,13 +160,13 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
         {
             get
             {
-                TimeSpan timeElapsed = DateTimeOffset.Now - countdownChangeTime;
+                double timeElapsed = Time.Current - countdownChangeTime;
                 TimeSpan remaining;
 
-                if (timeElapsed > countdown.TimeRemaining)
+                if (timeElapsed > countdown.TimeRemaining.TotalMilliseconds)
                     remaining = TimeSpan.Zero;
                 else
-                    remaining = countdown.TimeRemaining - timeElapsed;
+                    remaining = countdown.TimeRemaining - TimeSpan.FromMilliseconds(timeElapsed);
 
                 return remaining;
             }

From 31bf0c4a9b78bb40f5175ea0cb0388243d95c0c8 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 5 Apr 2022 13:16:06 +0900
Subject: [PATCH 3921/5547] Disable "final" sample in countdown for the time
 being

---
 .../OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs     | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
index 9b7e9a925e..6eed900963 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
@@ -104,7 +104,8 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
             lastTickSampleTime = Time.Current;
 
             if (secondsRemaining < 10) countdownTickSample?.Play();
-            if (secondsRemaining <= 3) countdownTickFinalSample?.Play();
+            // disabled for now pending further work on sound effect
+            // if (secondsRemaining <= 3) countdownTickFinalSample?.Play();
         }
 
         private void updateButtonText()

From d0f83885cea57adb37334b3646f5eb2e75da784f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 5 Apr 2022 13:20:34 +0900
Subject: [PATCH 3922/5547] Appease the CI

---
 .../OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs    | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
index 6eed900963..7e092bd353 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
@@ -30,13 +30,13 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
         private MultiplayerRoom room => multiplayerClient.Room;
 
         private Sample countdownTickSample;
-        private Sample countdownTickFinalSample;
 
         [BackgroundDependencyLoader]
         private void load(AudioManager audio)
         {
             countdownTickSample = audio.Samples.Get(@"Multiplayer/countdown-tick");
-            countdownTickFinalSample = audio.Samples.Get(@"Multiplayer/countdown-tick-final");
+            // disabled for now pending further work on sound effect
+            // countdownTickFinalSample = audio.Samples.Get(@"Multiplayer/countdown-tick-final");
         }
 
         protected override void LoadComplete()

From 5f415cbe53b1d406aa83abf402ceb7249305ea61 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 5 Apr 2022 15:48:18 +0900
Subject: [PATCH 3923/5547] Full potential null reference and add better
 commentary on countdown scheduling

---
 .../OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
index 7e092bd353..4cde7e71c3 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
@@ -67,9 +67,14 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
 
         private void scheduleNextCountdownUpdate()
         {
+            countdownUpdateDelegate?.Cancel();
+
             if (countdown != null)
             {
-                // If a countdown is active, schedule relevant components to update on the next whole second.
+                // The remaining time on a countdown may be at a fractional portion between two seconds.
+                // We want to align certain audio/visual cues to the point at which integer seconds change.
+                // To do so, we schedule to the next whole second.
+                // Note that scheduler invocation isn't guaranteed to be accurate, so this may still occur slightly late.
                 double timeToNextSecond = countdownTimeRemaining.TotalMilliseconds % 1000;
 
                 countdownUpdateDelegate = Scheduler.AddDelayed(onCountdownTick, timeToNextSecond);

From 8e543204cdca8305cf224f338848876d31120982 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 5 Apr 2022 15:49:47 +0900
Subject: [PATCH 3924/5547] Remove debounce logic (not required after switching
 to `Update` clock time)

---
 .../Multiplayer/Match/MultiplayerReadyButton.cs           | 8 --------
 1 file changed, 8 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
index 4cde7e71c3..4860078a79 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
@@ -98,16 +98,8 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
             }
         }
 
-        private double? lastTickSampleTime;
-
         private void playTickSound(int secondsRemaining)
         {
-            // Simplified debounce. Ticks should only be played roughly once per second regardless of how often this function is called.
-            if (Time.Current - lastTickSampleTime < 500)
-                return;
-
-            lastTickSampleTime = Time.Current;
-
             if (secondsRemaining < 10) countdownTickSample?.Play();
             // disabled for now pending further work on sound effect
             // if (secondsRemaining <= 3) countdownTickFinalSample?.Play();

From 3d8ae0465f1313981960f10a949aadbd21bd6651 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 5 Apr 2022 15:51:04 +0900
Subject: [PATCH 3925/5547] Reword comment slightly

---
 .../OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs   | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
index 4860078a79..d275f309cb 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
@@ -73,8 +73,9 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
             {
                 // The remaining time on a countdown may be at a fractional portion between two seconds.
                 // We want to align certain audio/visual cues to the point at which integer seconds change.
-                // To do so, we schedule to the next whole second.
-                // Note that scheduler invocation isn't guaranteed to be accurate, so this may still occur slightly late.
+                // To do so, we schedule to the next whole second. Note that scheduler invocation isn't
+                // guaranteed to be accurate, so this may still occur slightly late, but even in such a case
+                // the next invocation will be roughly correct.
                 double timeToNextSecond = countdownTimeRemaining.TotalMilliseconds % 1000;
 
                 countdownUpdateDelegate = Scheduler.AddDelayed(onCountdownTick, timeToNextSecond);

From 23dad7bdc4cab9bbbac3f8c707c17f2d23eb2c53 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 5 Apr 2022 16:39:02 +0900
Subject: [PATCH 3926/5547] Move scroll view padding to content level

Without doing this, there is a non-masked but also non-interactive area
to the left or right of the view.
---
 osu.Game/Overlays/Mods/ModSelectScreen.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/Mods/ModSelectScreen.cs b/osu.Game/Overlays/Mods/ModSelectScreen.cs
index 7915fb755c..5197cb6c3e 100644
--- a/osu.Game/Overlays/Mods/ModSelectScreen.cs
+++ b/osu.Game/Overlays/Mods/ModSelectScreen.cs
@@ -100,7 +100,6 @@ namespace osu.Game.Overlays.Mods
                                     {
                                         RelativeSizeAxes = Axes.Both,
                                         RelativePositionAxes = Axes.Both,
-                                        Padding = new MarginPadding { Horizontal = 70 },
                                         Children = new Drawable[]
                                         {
                                             new OsuScrollContainer(Direction.Horizontal)
@@ -113,6 +112,7 @@ namespace osu.Game.Overlays.Mods
                                                     RelativeSizeAxes = Axes.Y,
                                                     AutoSizeAxes = Axes.X,
                                                     Spacing = new Vector2(10, 0),
+                                                    Margin = new MarginPadding { Horizontal = 70 },
                                                     Children = new[]
                                                     {
                                                         new ModColumn(ModType.DifficultyReduction, false, new[] { Key.Q, Key.W, Key.E, Key.R, Key.T, Key.Y, Key.U, Key.I, Key.O, Key.P }),

From f156cb797df13c31e43856e58037cec9b490bf7d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 5 Apr 2022 16:40:09 +0900
Subject: [PATCH 3927/5547] Improve nested scroll behaviour

---
 osu.Game/Overlays/Mods/ModColumn.cs       | 60 ++++++++++++++++++++++-
 osu.Game/Overlays/Mods/ModSelectScreen.cs |  1 +
 2 files changed, 60 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/Mods/ModColumn.cs b/osu.Game/Overlays/Mods/ModColumn.cs
index 46a562ac98..513dd2ca3f 100644
--- a/osu.Game/Overlays/Mods/ModColumn.cs
+++ b/osu.Game/Overlays/Mods/ModColumn.cs
@@ -151,9 +151,10 @@ namespace osu.Game.Overlays.Mods
                                     },
                                     new Drawable[]
                                     {
-                                        new OsuScrollContainer
+                                        new NestedVerticalScrollContainer
                                         {
                                             RelativeSizeAxes = Axes.Both,
+                                            ClampExtension = 100,
                                             ScrollbarOverlapsContent = false,
                                             Child = panelFlow = new FillFlowContainer<ModPanel>
                                             {
@@ -194,6 +195,63 @@ namespace osu.Game.Overlays.Mods
             }
         }
 
+        /// <summary>
+        /// A scroll container that handles the case of vertically scrolling content inside a larger horizontally scrolling parent container.
+        /// </summary>
+        private class NestedVerticalScrollContainer : OsuScrollContainer
+        {
+            private OsuScrollContainer? parentScrollContainer;
+
+            protected override void LoadComplete()
+            {
+                base.LoadComplete();
+
+                parentScrollContainer = findClosestParent<OsuScrollContainer>();
+            }
+
+            protected override bool OnScroll(ScrollEvent e)
+            {
+                if (parentScrollContainer == null)
+                    return base.OnScroll(e);
+
+                // If not on screen, handle scroll but also allow parent to scroll at the same time.
+                bool topRightOutsideOfView = parentScrollContainer.ScreenSpaceDrawQuad.Contains(ScreenSpaceDrawQuad.TopRight) == false;
+                bool bottomLeftOutsideOfView = parentScrollContainer.ScreenSpaceDrawQuad.Contains(ScreenSpaceDrawQuad.BottomLeft) == false;
+
+                if (topRightOutsideOfView || bottomLeftOutsideOfView)
+                {
+                    base.OnScroll(e);
+                    return false;
+                }
+
+                bool scrollingPastEnd = e.ScrollDelta.Y < 0 && IsScrolledToEnd();
+                bool scrollingPastStart = e.ScrollDelta.Y > 0 && Target <= 0;
+
+                // Same deal if at one of the two extents of the view.
+                if (scrollingPastStart || scrollingPastEnd)
+                {
+                    base.OnScroll(e);
+                    return false;
+                }
+
+                return base.OnScroll(e);
+            }
+
+            // TODO: remove when https://github.com/ppy/osu-framework/pull/5092 is available.
+            private T? findClosestParent<T>() where T : class, IDrawable
+            {
+                Drawable cursor = this;
+
+                while ((cursor = cursor.Parent) != null)
+                {
+                    if (cursor is T match)
+                        return match;
+                }
+
+                return default;
+            }
+        }
+
         private void createHeaderText()
         {
             IEnumerable<string> headerTextWords = ModType.Humanize(LetterCasing.Title).Split(' ');
diff --git a/osu.Game/Overlays/Mods/ModSelectScreen.cs b/osu.Game/Overlays/Mods/ModSelectScreen.cs
index 5197cb6c3e..1d6f784133 100644
--- a/osu.Game/Overlays/Mods/ModSelectScreen.cs
+++ b/osu.Game/Overlays/Mods/ModSelectScreen.cs
@@ -106,6 +106,7 @@ namespace osu.Game.Overlays.Mods
                                             {
                                                 RelativeSizeAxes = Axes.Both,
                                                 Masking = false,
+                                                ClampExtension = 100,
                                                 ScrollbarOverlapsContent = false,
                                                 Child = columnFlow = new ModColumnContainer
                                                 {

From 2ec15a1ebe83c3e18bbde06f9f41c29db7780797 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 5 Apr 2022 16:47:15 +0900
Subject: [PATCH 3928/5547] Fix lookup through transformers

---
 osu.Game/Skinning/LegacySkinTransformer.cs |  2 +-
 osu.Game/Skinning/SkinnableSprite.cs       | 23 +++++++++++++++++++++-
 2 files changed, 23 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Skinning/LegacySkinTransformer.cs b/osu.Game/Skinning/LegacySkinTransformer.cs
index 97084f34e0..9481fc7182 100644
--- a/osu.Game/Skinning/LegacySkinTransformer.cs
+++ b/osu.Game/Skinning/LegacySkinTransformer.cs
@@ -23,7 +23,7 @@ namespace osu.Game.Skinning
         /// The <see cref="ISkin"/> which is being transformed.
         /// </summary>
         [NotNull]
-        protected ISkin Skin { get; }
+        protected internal ISkin Skin { get; }
 
         protected LegacySkinTransformer([NotNull] ISkin skin)
         {
diff --git a/osu.Game/Skinning/SkinnableSprite.cs b/osu.Game/Skinning/SkinnableSprite.cs
index c5f110f908..4b4d7fe2c6 100644
--- a/osu.Game/Skinning/SkinnableSprite.cs
+++ b/osu.Game/Skinning/SkinnableSprite.cs
@@ -2,6 +2,7 @@
 // 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;
@@ -83,7 +84,7 @@ namespace osu.Game.Skinning
                 // Round-about way of getting the user's skin to find available resources.
                 // In the future we'll probably want to allow access to resources from the fallbacks, or potentially other skins
                 // but that requires further thought.
-                var highestPrioritySkin = ((SkinnableSprite)SettingSourceObject).source.AllSources.First() as Skin;
+                var highestPrioritySkin = getHighestPriorityUserSkin(((SkinnableSprite)SettingSourceObject).source.AllSources) as Skin;
 
                 string[] availableFiles = highestPrioritySkin?.SkinInfo.PerformRead(s => s.Files
                                                                                           .Where(f => f.Filename.EndsWith(".png", StringComparison.Ordinal)
@@ -92,6 +93,26 @@ namespace osu.Game.Skinning
 
                 if (availableFiles?.Length > 0)
                     Items = availableFiles;
+
+                static ISkin getHighestPriorityUserSkin(IEnumerable<ISkin> skins)
+                {
+                    foreach (var skin in skins)
+                    {
+                        if (skin is LegacySkinTransformer transformer && isUserSkin(transformer.Skin))
+                            return transformer.Skin;
+
+                        if (isUserSkin(skin))
+                            return skin;
+                    }
+
+                    return null;
+                }
+
+                // Temporarily used to exclude undesirable ISkin implementations
+                static bool isUserSkin(ISkin skin)
+                    => skin.GetType() == typeof(DefaultSkin)
+                       || skin.GetType() == typeof(DefaultLegacySkin)
+                       || skin.GetType() == typeof(LegacySkin);
             }
         }
 

From 58e9147b12a613e6ae2dc590d82f5672304963b0 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 5 Apr 2022 16:48:25 +0900
Subject: [PATCH 3929/5547] Simplify and better comment nested scroll
 conditionals

---
 osu.Game/Overlays/Mods/ModColumn.cs | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Overlays/Mods/ModColumn.cs b/osu.Game/Overlays/Mods/ModColumn.cs
index 513dd2ca3f..e915e88e99 100644
--- a/osu.Game/Overlays/Mods/ModColumn.cs
+++ b/osu.Game/Overlays/Mods/ModColumn.cs
@@ -214,11 +214,11 @@ namespace osu.Game.Overlays.Mods
                 if (parentScrollContainer == null)
                     return base.OnScroll(e);
 
-                // If not on screen, handle scroll but also allow parent to scroll at the same time.
-                bool topRightOutsideOfView = parentScrollContainer.ScreenSpaceDrawQuad.Contains(ScreenSpaceDrawQuad.TopRight) == false;
-                bool bottomLeftOutsideOfView = parentScrollContainer.ScreenSpaceDrawQuad.Contains(ScreenSpaceDrawQuad.BottomLeft) == false;
+                bool topRightInView = parentScrollContainer.ScreenSpaceDrawQuad.Contains(ScreenSpaceDrawQuad.TopRight);
+                bool bottomLeftInView = parentScrollContainer.ScreenSpaceDrawQuad.Contains(ScreenSpaceDrawQuad.BottomLeft);
 
-                if (topRightOutsideOfView || bottomLeftOutsideOfView)
+                // If not completely on-screen, handle scroll but also allow parent to scroll at the same time (to hopefully bring our content into full view).
+                if (!topRightInView || !bottomLeftInView)
                 {
                     base.OnScroll(e);
                     return false;
@@ -227,7 +227,7 @@ namespace osu.Game.Overlays.Mods
                 bool scrollingPastEnd = e.ScrollDelta.Y < 0 && IsScrolledToEnd();
                 bool scrollingPastStart = e.ScrollDelta.Y > 0 && Target <= 0;
 
-                // Same deal if at one of the two extents of the view.
+                // If at either of our extents, allow the parent scroll to handle as a horizontal scroll to view more content.
                 if (scrollingPastStart || scrollingPastEnd)
                 {
                     base.OnScroll(e);

From 388322cd61eeec61aa7bc53597f49b4c0f463619 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 5 Apr 2022 16:56:24 +0900
Subject: [PATCH 3930/5547] Speed up customisation panel toggle a bit

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

diff --git a/osu.Game/Overlays/Mods/ModSelectScreen.cs b/osu.Game/Overlays/Mods/ModSelectScreen.cs
index 1d6f784133..1f0dcea6c2 100644
--- a/osu.Game/Overlays/Mods/ModSelectScreen.cs
+++ b/osu.Game/Overlays/Mods/ModSelectScreen.cs
@@ -235,7 +235,7 @@ namespace osu.Game.Overlays.Mods
 
         private void updateCustomisationVisualState()
         {
-            const double transition_duration = 700;
+            const double transition_duration = 300;
 
             grid.FadeColour(customisationVisible.Value ? Colour4.Gray : Colour4.White, transition_duration, Easing.InOutCubic);
 

From a408776734b8d7285d8f1af98560dae8405aeb09 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 5 Apr 2022 17:14:59 +0900
Subject: [PATCH 3931/5547] Limit `FillFlow` of columns to applicable direction

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

diff --git a/osu.Game/Overlays/Mods/ModSelectScreen.cs b/osu.Game/Overlays/Mods/ModSelectScreen.cs
index 1f0dcea6c2..8468448bbb 100644
--- a/osu.Game/Overlays/Mods/ModSelectScreen.cs
+++ b/osu.Game/Overlays/Mods/ModSelectScreen.cs
@@ -110,6 +110,7 @@ namespace osu.Game.Overlays.Mods
                                                 ScrollbarOverlapsContent = false,
                                                 Child = columnFlow = new ModColumnContainer
                                                 {
+                                                    Direction = FillDirection.Horizontal,
                                                     RelativeSizeAxes = Axes.Y,
                                                     AutoSizeAxes = Axes.X,
                                                     Spacing = new Vector2(10, 0),

From 497e5e3a36731490881e8afe3da2cd087446b197 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 5 Apr 2022 17:15:24 +0900
Subject: [PATCH 3932/5547] Slightly adjust scroll handling and also apply to
 `ModSettingsContainer`

---
 osu.Game/Overlays/Mods/ModColumn.cs           | 57 -----------------
 osu.Game/Overlays/Mods/ModSettingsArea.cs     |  4 +-
 .../Mods/NestedVerticalScrollContainer.cs     | 61 +++++++++++++++++++
 3 files changed, 64 insertions(+), 58 deletions(-)
 create mode 100644 osu.Game/Overlays/Mods/NestedVerticalScrollContainer.cs

diff --git a/osu.Game/Overlays/Mods/ModColumn.cs b/osu.Game/Overlays/Mods/ModColumn.cs
index e915e88e99..8531ae1e3f 100644
--- a/osu.Game/Overlays/Mods/ModColumn.cs
+++ b/osu.Game/Overlays/Mods/ModColumn.cs
@@ -195,63 +195,6 @@ namespace osu.Game.Overlays.Mods
             }
         }
 
-        /// <summary>
-        /// A scroll container that handles the case of vertically scrolling content inside a larger horizontally scrolling parent container.
-        /// </summary>
-        private class NestedVerticalScrollContainer : OsuScrollContainer
-        {
-            private OsuScrollContainer? parentScrollContainer;
-
-            protected override void LoadComplete()
-            {
-                base.LoadComplete();
-
-                parentScrollContainer = findClosestParent<OsuScrollContainer>();
-            }
-
-            protected override bool OnScroll(ScrollEvent e)
-            {
-                if (parentScrollContainer == null)
-                    return base.OnScroll(e);
-
-                bool topRightInView = parentScrollContainer.ScreenSpaceDrawQuad.Contains(ScreenSpaceDrawQuad.TopRight);
-                bool bottomLeftInView = parentScrollContainer.ScreenSpaceDrawQuad.Contains(ScreenSpaceDrawQuad.BottomLeft);
-
-                // If not completely on-screen, handle scroll but also allow parent to scroll at the same time (to hopefully bring our content into full view).
-                if (!topRightInView || !bottomLeftInView)
-                {
-                    base.OnScroll(e);
-                    return false;
-                }
-
-                bool scrollingPastEnd = e.ScrollDelta.Y < 0 && IsScrolledToEnd();
-                bool scrollingPastStart = e.ScrollDelta.Y > 0 && Target <= 0;
-
-                // If at either of our extents, allow the parent scroll to handle as a horizontal scroll to view more content.
-                if (scrollingPastStart || scrollingPastEnd)
-                {
-                    base.OnScroll(e);
-                    return false;
-                }
-
-                return base.OnScroll(e);
-            }
-
-            // TODO: remove when https://github.com/ppy/osu-framework/pull/5092 is available.
-            private T? findClosestParent<T>() where T : class, IDrawable
-            {
-                Drawable cursor = this;
-
-                while ((cursor = cursor.Parent) != null)
-                {
-                    if (cursor is T match)
-                        return match;
-                }
-
-                return default;
-            }
-        }
-
         private void createHeaderText()
         {
             IEnumerable<string> headerTextWords = ModType.Humanize(LetterCasing.Title).Split(' ');
diff --git a/osu.Game/Overlays/Mods/ModSettingsArea.cs b/osu.Game/Overlays/Mods/ModSettingsArea.cs
index 9b0382c6a4..be72c1e3e3 100644
--- a/osu.Game/Overlays/Mods/ModSettingsArea.cs
+++ b/osu.Game/Overlays/Mods/ModSettingsArea.cs
@@ -54,6 +54,7 @@ namespace osu.Game.Overlays.Mods
                     {
                         RelativeSizeAxes = Axes.Both,
                         ScrollbarOverlapsContent = false,
+                        ClampExtension = 100,
                         Child = modSettingsFlow = new FillFlowContainer
                         {
                             AutoSizeAxes = Axes.X,
@@ -157,9 +158,10 @@ namespace osu.Game.Overlays.Mods
                         new[] { Empty() },
                         new Drawable[]
                         {
-                            new OsuScrollContainer(Direction.Vertical)
+                            new NestedVerticalScrollContainer
                             {
                                 RelativeSizeAxes = Axes.Both,
+                                ClampExtension = 100,
                                 Child = new FillFlowContainer
                                 {
                                     RelativeSizeAxes = Axes.X,
diff --git a/osu.Game/Overlays/Mods/NestedVerticalScrollContainer.cs b/osu.Game/Overlays/Mods/NestedVerticalScrollContainer.cs
new file mode 100644
index 0000000000..c62b52ef27
--- /dev/null
+++ b/osu.Game/Overlays/Mods/NestedVerticalScrollContainer.cs
@@ -0,0 +1,61 @@
+// 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 enable
+using osu.Framework.Graphics;
+using osu.Framework.Input.Events;
+using osu.Game.Graphics.Containers;
+
+namespace osu.Game.Overlays.Mods
+{
+    /// <summary>
+    /// A scroll container that handles the case of vertically scrolling content inside a larger horizontally scrolling parent container.
+    /// </summary>
+    public class NestedVerticalScrollContainer : OsuScrollContainer
+    {
+        private OsuScrollContainer? parentScrollContainer;
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            parentScrollContainer = findClosestParent<OsuScrollContainer>();
+        }
+
+        protected override bool OnScroll(ScrollEvent e)
+        {
+            if (parentScrollContainer == null)
+                return base.OnScroll(e);
+
+            bool topRightInView = parentScrollContainer.ScreenSpaceDrawQuad.Contains(ScreenSpaceDrawQuad.TopRight);
+            bool bottomLeftInView = parentScrollContainer.ScreenSpaceDrawQuad.Contains(ScreenSpaceDrawQuad.BottomLeft);
+
+            // If not completely on-screen, handle scroll but also allow parent to scroll at the same time (to hopefully bring our content into full view).
+            if (!topRightInView || !bottomLeftInView)
+                return false;
+
+            bool scrollingPastEnd = e.ScrollDelta.Y < 0 && IsScrolledToEnd();
+            bool scrollingPastStart = e.ScrollDelta.Y > 0 && Target <= 0;
+
+            // If at either of our extents, delegate scroll to the horizontal parent container.
+            if (scrollingPastStart || scrollingPastEnd)
+                return false;
+
+            return base.OnScroll(e);
+        }
+
+        // TODO: remove when https://github.com/ppy/osu-framework/pull/5092 is available.
+        private T? findClosestParent<T>() where T : class, IDrawable
+        {
+            Drawable cursor = this;
+
+            while ((cursor = cursor.Parent) != null)
+            {
+                if (cursor is T match)
+                    return match;
+            }
+
+            return default;
+        }
+    }
+}

From 901032bfa21e0916efa9ce1b5b184f1978f53e8f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 5 Apr 2022 18:25:27 +0900
Subject: [PATCH 3933/5547] Animate multiplier display

---
 .../Mods/DifficultyMultiplierDisplay.cs       |  5 ++--
 osu.Game/Overlays/Mods/ModSelectScreen.cs     | 27 +++++++++++++++----
 2 files changed, 25 insertions(+), 7 deletions(-)

diff --git a/osu.Game/Overlays/Mods/DifficultyMultiplierDisplay.cs b/osu.Game/Overlays/Mods/DifficultyMultiplierDisplay.cs
index 4fc3a904fa..4d3f630a55 100644
--- a/osu.Game/Overlays/Mods/DifficultyMultiplierDisplay.cs
+++ b/osu.Game/Overlays/Mods/DifficultyMultiplierDisplay.cs
@@ -20,6 +20,8 @@ namespace osu.Game.Overlays.Mods
 {
     public class DifficultyMultiplierDisplay : CompositeDrawable, IHasCurrentValue<double>
     {
+        public const float HEIGHT = 42;
+
         public Bindable<double> Current
         {
             get => current.Current;
@@ -42,13 +44,12 @@ namespace osu.Game.Overlays.Mods
         [Resolved]
         private OverlayColourProvider colourProvider { get; set; }
 
-        private const float height = 42;
         private const float multiplier_value_area_width = 56;
         private const float transition_duration = 200;
 
         public DifficultyMultiplierDisplay()
         {
-            Height = height;
+            Height = HEIGHT;
             AutoSizeAxes = Axes.X;
 
             InternalChild = new Container
diff --git a/osu.Game/Overlays/Mods/ModSelectScreen.cs b/osu.Game/Overlays/Mods/ModSelectScreen.cs
index 8468448bbb..3437922cc8 100644
--- a/osu.Game/Overlays/Mods/ModSelectScreen.cs
+++ b/osu.Game/Overlays/Mods/ModSelectScreen.cs
@@ -84,13 +84,21 @@ namespace osu.Game.Overlays.Mods
                                 {
                                     new Container
                                     {
-                                        RelativeSizeAxes = Axes.X,
-                                        AutoSizeAxes = Axes.Y,
-                                        Padding = new MarginPadding { Horizontal = 100, Vertical = 10 },
+                                        Anchor = Anchor.Centre,
+                                        Origin = Anchor.Centre,
+                                        AutoSizeAxes = Axes.X,
+                                        RelativePositionAxes = Axes.X,
+                                        X = 0.3f,
+                                        Height = DifficultyMultiplierDisplay.HEIGHT,
+                                        Margin = new MarginPadding
+                                        {
+                                            Horizontal = 100,
+                                            Vertical = 10
+                                        },
                                         Child = multiplierDisplay = new DifficultyMultiplierDisplay
                                         {
-                                            Anchor = Anchor.CentreRight,
-                                            Origin = Anchor.CentreRight
+                                            Anchor = Anchor.Centre,
+                                            Origin = Anchor.Centre
                                         }
                                     }
                                 },
@@ -283,6 +291,11 @@ namespace osu.Game.Overlays.Mods
             footer.MoveToY(0, fade_in_duration, Easing.OutQuint);
 
             this.FadeIn(fade_in_duration, Easing.OutQuint);
+
+            multiplierDisplay
+                .Delay(300)
+                .FadeIn(200, Easing.OutQuint)
+                .ScaleTo(1, fade_in_duration, Easing.OutElastic);
         }
 
         protected override void PopOut()
@@ -291,6 +304,10 @@ namespace osu.Game.Overlays.Mods
 
             base.PopOut();
 
+            multiplierDisplay
+                .FadeOut(200, Easing.OutQuint)
+                .ScaleTo(0.75f, fade_out_duration, Easing.OutQuint);
+
             header.MoveToY(-header.DrawHeight, fade_out_duration, Easing.OutQuint);
             footer.MoveToY(footer.DrawHeight, fade_out_duration, Easing.OutQuint);
 

From 9fdeb2053746f6e0b35366cbedb4026034640ef9 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 5 Apr 2022 18:27:34 +0900
Subject: [PATCH 3934/5547] Animate individual `ModColumn`s during togle of
 oerlay

---
 osu.Game/Overlays/Mods/ModColumn.cs       | 143 ++++++++++++----------
 osu.Game/Overlays/Mods/ModSelectScreen.cs |  15 +++
 2 files changed, 91 insertions(+), 67 deletions(-)

diff --git a/osu.Game/Overlays/Mods/ModColumn.cs b/osu.Game/Overlays/Mods/ModColumn.cs
index 8531ae1e3f..f84ae4ac8a 100644
--- a/osu.Game/Overlays/Mods/ModColumn.cs
+++ b/osu.Game/Overlays/Mods/ModColumn.cs
@@ -31,6 +31,8 @@ namespace osu.Game.Overlays.Mods
 {
     public class ModColumn : CompositeDrawable
     {
+        public readonly Container TopLevelContent;
+
         public readonly ModType ModType;
 
         private Func<Mod, bool>? filter;
@@ -78,90 +80,97 @@ namespace osu.Game.Overlays.Mods
             Width = 320;
             RelativeSizeAxes = Axes.Y;
             Shear = new Vector2(ModPanel.SHEAR_X, 0);
-            CornerRadius = ModPanel.CORNER_RADIUS;
-            Masking = true;
 
             Container controlContainer;
             InternalChildren = new Drawable[]
             {
-                new Container
-                {
-                    RelativeSizeAxes = Axes.X,
-                    Height = header_height + ModPanel.CORNER_RADIUS,
-                    Children = new Drawable[]
-                    {
-                        headerBackground = new Box
-                        {
-                            RelativeSizeAxes = Axes.X,
-                            Height = header_height + ModPanel.CORNER_RADIUS
-                        },
-                        headerText = new OsuTextFlowContainer(t =>
-                        {
-                            t.Font = OsuFont.TorusAlternate.With(size: 17);
-                            t.Shadow = false;
-                            t.Colour = Colour4.Black;
-                        })
-                        {
-                            RelativeSizeAxes = Axes.X,
-                            AutoSizeAxes = Axes.Y,
-                            Anchor = Anchor.CentreLeft,
-                            Origin = Anchor.CentreLeft,
-                            Shear = new Vector2(-ModPanel.SHEAR_X, 0),
-                            Padding = new MarginPadding
-                            {
-                                Horizontal = 17,
-                                Bottom = ModPanel.CORNER_RADIUS
-                            }
-                        }
-                    }
-                },
-                new Container
+                TopLevelContent = new Container
                 {
                     RelativeSizeAxes = Axes.Both,
-                    Padding = new MarginPadding { Top = header_height },
-                    Child = contentContainer = new Container
+                    CornerRadius = ModPanel.CORNER_RADIUS,
+                    Masking = true,
+                    Children = new Drawable[]
                     {
-                        RelativeSizeAxes = Axes.Both,
-                        Masking = true,
-                        CornerRadius = ModPanel.CORNER_RADIUS,
-                        BorderThickness = 3,
-                        Children = new Drawable[]
+                        new Container
                         {
-                            contentBackground = new Box
+                            RelativeSizeAxes = Axes.X,
+                            Height = header_height + ModPanel.CORNER_RADIUS,
+                            Children = new Drawable[]
                             {
-                                RelativeSizeAxes = Axes.Both
-                            },
-                            new GridContainer
+                                headerBackground = new Box
+                                {
+                                    RelativeSizeAxes = Axes.X,
+                                    Height = header_height + ModPanel.CORNER_RADIUS
+                                },
+                                headerText = new OsuTextFlowContainer(t =>
+                                {
+                                    t.Font = OsuFont.TorusAlternate.With(size: 17);
+                                    t.Shadow = false;
+                                    t.Colour = Colour4.Black;
+                                })
+                                {
+                                    RelativeSizeAxes = Axes.X,
+                                    AutoSizeAxes = Axes.Y,
+                                    Anchor = Anchor.CentreLeft,
+                                    Origin = Anchor.CentreLeft,
+                                    Shear = new Vector2(-ModPanel.SHEAR_X, 0),
+                                    Padding = new MarginPadding
+                                    {
+                                        Horizontal = 17,
+                                        Bottom = ModPanel.CORNER_RADIUS
+                                    }
+                                }
+                            }
+                        },
+                        new Container
+                        {
+                            RelativeSizeAxes = Axes.Both,
+                            Padding = new MarginPadding { Top = header_height },
+                            Child = contentContainer = new Container
                             {
                                 RelativeSizeAxes = Axes.Both,
-                                RowDimensions = new[]
+                                Masking = true,
+                                CornerRadius = ModPanel.CORNER_RADIUS,
+                                BorderThickness = 3,
+                                Children = new Drawable[]
                                 {
-                                    new Dimension(GridSizeMode.AutoSize),
-                                    new Dimension()
-                                },
-                                Content = new[]
-                                {
-                                    new Drawable[]
+                                    contentBackground = new Box
                                     {
-                                        controlContainer = new Container
-                                        {
-                                            RelativeSizeAxes = Axes.X,
-                                            Padding = new MarginPadding { Horizontal = 14 }
-                                        }
+                                        RelativeSizeAxes = Axes.Both
                                     },
-                                    new Drawable[]
+                                    new GridContainer
                                     {
-                                        new NestedVerticalScrollContainer
+                                        RelativeSizeAxes = Axes.Both,
+                                        RowDimensions = new[]
                                         {
-                                            RelativeSizeAxes = Axes.Both,
-                                            ClampExtension = 100,
-                                            ScrollbarOverlapsContent = false,
-                                            Child = panelFlow = new FillFlowContainer<ModPanel>
+                                            new Dimension(GridSizeMode.AutoSize),
+                                            new Dimension()
+                                        },
+                                        Content = new[]
+                                        {
+                                            new Drawable[]
                                             {
-                                                RelativeSizeAxes = Axes.X,
-                                                AutoSizeAxes = Axes.Y,
-                                                Spacing = new Vector2(0, 7),
-                                                Padding = new MarginPadding(7)
+                                                controlContainer = new Container
+                                                {
+                                                    RelativeSizeAxes = Axes.X,
+                                                    Padding = new MarginPadding { Horizontal = 14 }
+                                                }
+                                            },
+                                            new Drawable[]
+                                            {
+                                                new NestedVerticalScrollContainer
+                                                {
+                                                    RelativeSizeAxes = Axes.Both,
+                                                    ClampExtension = 100,
+                                                    ScrollbarOverlapsContent = false,
+                                                    Child = panelFlow = new FillFlowContainer<ModPanel>
+                                                    {
+                                                        RelativeSizeAxes = Axes.X,
+                                                        AutoSizeAxes = Axes.Y,
+                                                        Spacing = new Vector2(0, 7),
+                                                        Padding = new MarginPadding(7)
+                                                    }
+                                                }
                                             }
                                         }
                                     }
diff --git a/osu.Game/Overlays/Mods/ModSelectScreen.cs b/osu.Game/Overlays/Mods/ModSelectScreen.cs
index 3437922cc8..1009c2edf6 100644
--- a/osu.Game/Overlays/Mods/ModSelectScreen.cs
+++ b/osu.Game/Overlays/Mods/ModSelectScreen.cs
@@ -106,6 +106,7 @@ namespace osu.Game.Overlays.Mods
                                 {
                                     new Container
                                     {
+                                        Depth = float.MaxValue,
                                         RelativeSizeAxes = Axes.Both,
                                         RelativePositionAxes = Axes.Both,
                                         Children = new Drawable[]
@@ -296,6 +297,13 @@ namespace osu.Game.Overlays.Mods
                 .Delay(300)
                 .FadeIn(200, Easing.OutQuint)
                 .ScaleTo(1, fade_in_duration, Easing.OutElastic);
+
+            for (int i = 0; i < columnFlow.Count; i++)
+            {
+                columnFlow[i].TopLevelContent
+                             .Delay(i * 30)
+                             .MoveToY(0, fade_in_duration, Easing.OutQuint);
+            }
         }
 
         protected override void PopOut()
@@ -312,6 +320,13 @@ namespace osu.Game.Overlays.Mods
             footer.MoveToY(footer.DrawHeight, fade_out_duration, Easing.OutQuint);
 
             this.FadeOut(fade_out_duration, Easing.OutQuint);
+
+            for (int i = 0; i < columnFlow.Count; i++)
+            {
+                const float distance = 700;
+
+                columnFlow[i].TopLevelContent.MoveToY(i % 2 == 0 ? -distance : distance, fade_out_duration, Easing.OutQuint);
+            }
         }
 
         private class ModColumnContainer : FillFlowContainer<ModColumn>

From 7a1820e6bb99a48101033da2abf8a9a6cd4670fe Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 5 Apr 2022 18:25:27 +0900
Subject: [PATCH 3935/5547] Fix multiplier display resetting transformations

---
 osu.Game/Overlays/Mods/DifficultyMultiplierDisplay.cs | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/Mods/DifficultyMultiplierDisplay.cs b/osu.Game/Overlays/Mods/DifficultyMultiplierDisplay.cs
index 4d3f630a55..248d4f288e 100644
--- a/osu.Game/Overlays/Mods/DifficultyMultiplierDisplay.cs
+++ b/osu.Game/Overlays/Mods/DifficultyMultiplierDisplay.cs
@@ -146,8 +146,9 @@ namespace osu.Game.Overlays.Mods
         protected override void LoadComplete()
         {
             base.LoadComplete();
+
             current.BindValueChanged(_ => updateState(), true);
-            FinishTransforms(true);
+
             // required to prevent the counter initially rolling up from 0 to 1
             // due to `Current.Value` having a nonstandard default value of 1.
             multiplierCounter.SetCountWithoutRolling(Current.Value);

From 54715885af16463759bb1aa99ed70f298232bb6d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 5 Apr 2022 18:38:31 +0900
Subject: [PATCH 3936/5547] Adjust animation metrics slightly

---
 osu.Game/Overlays/Mods/ModSelectScreen.cs | 21 +++++++++++----------
 1 file changed, 11 insertions(+), 10 deletions(-)

diff --git a/osu.Game/Overlays/Mods/ModSelectScreen.cs b/osu.Game/Overlays/Mods/ModSelectScreen.cs
index 1009c2edf6..c43987ea60 100644
--- a/osu.Game/Overlays/Mods/ModSelectScreen.cs
+++ b/osu.Game/Overlays/Mods/ModSelectScreen.cs
@@ -284,25 +284,25 @@ namespace osu.Game.Overlays.Mods
 
         protected override void PopIn()
         {
-            const double fade_in_duration = 500;
+            const double fade_in_duration = 400;
 
             base.PopIn();
+            this.FadeIn(fade_in_duration, Easing.OutQuint);
 
             header.MoveToY(0, fade_in_duration, Easing.OutQuint);
             footer.MoveToY(0, fade_in_duration, Easing.OutQuint);
 
-            this.FadeIn(fade_in_duration, Easing.OutQuint);
-
             multiplierDisplay
-                .Delay(300)
-                .FadeIn(200, Easing.OutQuint)
+                .Delay(fade_in_duration * 0.65f)
+                .FadeIn(fade_in_duration / 2, Easing.OutQuint)
                 .ScaleTo(1, fade_in_duration, Easing.OutElastic);
 
             for (int i = 0; i < columnFlow.Count; i++)
             {
                 columnFlow[i].TopLevelContent
                              .Delay(i * 30)
-                             .MoveToY(0, fade_in_duration, Easing.OutQuint);
+                             .MoveToY(0, fade_in_duration, Easing.OutQuint)
+                             .FadeIn(fade_in_duration, Easing.OutQuint);
             }
         }
 
@@ -311,21 +311,22 @@ namespace osu.Game.Overlays.Mods
             const double fade_out_duration = 500;
 
             base.PopOut();
+            this.FadeOut(fade_out_duration, Easing.OutQuint);
 
             multiplierDisplay
-                .FadeOut(200, Easing.OutQuint)
+                .FadeOut(fade_out_duration / 2, Easing.OutQuint)
                 .ScaleTo(0.75f, fade_out_duration, Easing.OutQuint);
 
             header.MoveToY(-header.DrawHeight, fade_out_duration, Easing.OutQuint);
             footer.MoveToY(footer.DrawHeight, fade_out_duration, Easing.OutQuint);
 
-            this.FadeOut(fade_out_duration, Easing.OutQuint);
-
             for (int i = 0; i < columnFlow.Count; i++)
             {
                 const float distance = 700;
 
-                columnFlow[i].TopLevelContent.MoveToY(i % 2 == 0 ? -distance : distance, fade_out_duration, Easing.OutQuint);
+                columnFlow[i].TopLevelContent
+                             .MoveToY(i % 2 == 0 ? -distance : distance, fade_out_duration, Easing.OutQuint)
+                             .FadeOut(fade_out_duration, Easing.OutQuint);
             }
         }
 

From 631aa2a6ec8e35be514953c4c4b40e35a51cdb4d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 5 Apr 2022 18:44:25 +0900
Subject: [PATCH 3937/5547] Remove left padding to allow left-most column to
 exist further to the.. left

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

diff --git a/osu.Game/Overlays/Mods/ModSelectScreen.cs b/osu.Game/Overlays/Mods/ModSelectScreen.cs
index c43987ea60..62080ec1b5 100644
--- a/osu.Game/Overlays/Mods/ModSelectScreen.cs
+++ b/osu.Game/Overlays/Mods/ModSelectScreen.cs
@@ -123,7 +123,7 @@ namespace osu.Game.Overlays.Mods
                                                     RelativeSizeAxes = Axes.Y,
                                                     AutoSizeAxes = Axes.X,
                                                     Spacing = new Vector2(10, 0),
-                                                    Margin = new MarginPadding { Horizontal = 70 },
+                                                    Margin = new MarginPadding { Right = 70 },
                                                     Children = new[]
                                                     {
                                                         new ModColumn(ModType.DifficultyReduction, false, new[] { Key.Q, Key.W, Key.E, Key.R, Key.T, Key.Y, Key.U, Key.I, Key.O, Key.P }),

From 32daf64a31a09cc459461957d0aa709c52f015f1 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 5 Apr 2022 19:23:35 +0900
Subject: [PATCH 3938/5547] Use newly exposed framework helper function to find
 closest parent

---
 osu.Android.props                                |  2 +-
 .../Mods/NestedVerticalScrollContainer.cs        | 16 +---------------
 osu.Game/osu.Game.csproj                         |  2 +-
 osu.iOS.props                                    |  4 ++--
 4 files changed, 5 insertions(+), 19 deletions(-)

diff --git a/osu.Android.props b/osu.Android.props
index 6a3b113fa2..a168d351fc 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -52,7 +52,7 @@
   </ItemGroup>
   <ItemGroup>
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.325.0" />
-    <PackageReference Include="ppy.osu.Framework.Android" Version="2022.325.0" />
+    <PackageReference Include="ppy.osu.Framework.Android" Version="2022.405.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
     <!-- Realm needs to be directly referenced in all Xamarin projects, as it will not pull in its transitive dependencies otherwise. -->
diff --git a/osu.Game/Overlays/Mods/NestedVerticalScrollContainer.cs b/osu.Game/Overlays/Mods/NestedVerticalScrollContainer.cs
index c62b52ef27..1bf965beeb 100644
--- a/osu.Game/Overlays/Mods/NestedVerticalScrollContainer.cs
+++ b/osu.Game/Overlays/Mods/NestedVerticalScrollContainer.cs
@@ -19,7 +19,7 @@ namespace osu.Game.Overlays.Mods
         {
             base.LoadComplete();
 
-            parentScrollContainer = findClosestParent<OsuScrollContainer>();
+            parentScrollContainer = this.FindClosestParent<OsuScrollContainer>();
         }
 
         protected override bool OnScroll(ScrollEvent e)
@@ -43,19 +43,5 @@ namespace osu.Game.Overlays.Mods
 
             return base.OnScroll(e);
         }
-
-        // TODO: remove when https://github.com/ppy/osu-framework/pull/5092 is available.
-        private T? findClosestParent<T>() where T : class, IDrawable
-        {
-            Drawable cursor = this;
-
-            while ((cursor = cursor.Parent) != null)
-            {
-                if (cursor is T match)
-                    return match;
-            }
-
-            return default;
-        }
     }
 }
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 3c01f29671..e968c6602d 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="10.10.0" />
-    <PackageReference Include="ppy.osu.Framework" Version="2022.325.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2022.405.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.325.0" />
     <PackageReference Include="Sentry" Version="3.14.1" />
     <PackageReference Include="SharpCompress" Version="0.30.1" />
diff --git a/osu.iOS.props b/osu.iOS.props
index c8f170497d..e441ed81ab 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -61,7 +61,7 @@
     <Reference Include="System.Net.Http" />
   </ItemGroup>
   <ItemGroup Label="Package References">
-    <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.325.0" />
+    <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.405.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.325.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net6.0) -->
@@ -84,7 +84,7 @@
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="5.0.14" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.Core" Version="5.0.14" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
-    <PackageReference Include="ppy.osu.Framework" Version="2022.325.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2022.405.0" />
     <PackageReference Include="SharpCompress" Version="0.30.1" />
     <PackageReference Include="NUnit" Version="3.13.2" />
     <PackageReference Include="System.ComponentModel.Annotations" Version="5.0.0" />

From ac799aaf7a412db957203074b9110776ad61dfbf Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 5 Apr 2022 19:25:47 +0900
Subject: [PATCH 3939/5547] Add missing newline

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

diff --git a/osu.Game/Overlays/Mods/NestedVerticalScrollContainer.cs b/osu.Game/Overlays/Mods/NestedVerticalScrollContainer.cs
index 1bf965beeb..aba47d5423 100644
--- a/osu.Game/Overlays/Mods/NestedVerticalScrollContainer.cs
+++ b/osu.Game/Overlays/Mods/NestedVerticalScrollContainer.cs
@@ -2,6 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 #nullable enable
+
 using osu.Framework.Graphics;
 using osu.Framework.Input.Events;
 using osu.Game.Graphics.Containers;

From 74706f72e6450befc842511bdc0077b100180ac9 Mon Sep 17 00:00:00 2001
From: Perry MacMurray <perrymacmurray@gmail.com>
Date: Tue, 5 Apr 2022 15:10:55 -0400
Subject: [PATCH 3940/5547] Add 12-hour display setting (TODO add toggle)

---
 osu.Game/Overlays/Toolbar/DigitalClockDisplay.cs | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Overlays/Toolbar/DigitalClockDisplay.cs b/osu.Game/Overlays/Toolbar/DigitalClockDisplay.cs
index 81a362450c..b535c5c6a2 100644
--- a/osu.Game/Overlays/Toolbar/DigitalClockDisplay.cs
+++ b/osu.Game/Overlays/Toolbar/DigitalClockDisplay.cs
@@ -29,6 +29,8 @@ namespace osu.Game.Overlays.Toolbar
             }
         }
 
+        private bool format12H = true;
+
         [BackgroundDependencyLoader]
         private void load(OsuColour colours)
         {
@@ -50,13 +52,17 @@ namespace osu.Game.Overlays.Toolbar
 
         protected override void UpdateDisplay(DateTimeOffset now)
         {
-            realTime.Text = $"{now:HH:mm:ss}";
+            realTime.Text = format12H ? $"{now:hh:mm:ss tt}" : $"{now:HH:mm:ss}";
             gameTime.Text = $"running {new TimeSpan(TimeSpan.TicksPerSecond * (int)(Clock.CurrentTime / 1000)):c}";
         }
 
         private void updateMetrics()
         {
-            Width = showRuntime ? 66 : 45; // Allows for space for game time up to 99 days (in the padding area since this is quite rare).
+            if (format12H)
+                Width = 74;
+            else
+                Width = showRuntime ? 66 : 45; // Allows for space for game time up to 99 days (in the padding area since this is quite rare).
+
             gameTime.FadeTo(showRuntime ? 1 : 0);
         }
     }

From 9d475f7b336b196a06f99801a64c7cd280641d9a Mon Sep 17 00:00:00 2001
From: Perry MacMurray <perrymacmurray@gmail.com>
Date: Tue, 5 Apr 2022 16:21:28 -0400
Subject: [PATCH 3941/5547] Add config in settings for forcing 24H time,
 determines default off CurrentCulture

---
 osu.Game/Configuration/OsuConfigManager.cs    |  3 +++
 osu.Game/Localisation/UserInterfaceStrings.cs |  5 +++++
 .../Sections/UserInterface/GeneralSettings.cs |  5 +++++
 .../Overlays/Toolbar/DigitalClockDisplay.cs   | 20 ++++++++++++++++---
 osu.Game/Overlays/Toolbar/ToolbarClock.cs     |  6 ++++++
 5 files changed, 36 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Configuration/OsuConfigManager.cs b/osu.Game/Configuration/OsuConfigManager.cs
index 2f966ac0a9..99372c92d9 100644
--- a/osu.Game/Configuration/OsuConfigManager.cs
+++ b/osu.Game/Configuration/OsuConfigManager.cs
@@ -102,6 +102,8 @@ namespace osu.Game.Configuration
 
             SetDefault(OsuSetting.MenuParallax, true);
 
+            SetDefault(OsuSetting.Prefer24HourTime, false);
+
             // Gameplay
             SetDefault(OsuSetting.PositionalHitsounds, true); // replaced by level setting below, can be removed 20220703.
             SetDefault(OsuSetting.PositionalHitsoundsLevel, 0.2f, 0, 1);
@@ -287,6 +289,7 @@ namespace osu.Game.Configuration
         MenuVoice,
         CursorRotation,
         MenuParallax,
+        Prefer24HourTime,
         BeatmapDetailTab,
         BeatmapDetailModsFilter,
         Username,
diff --git a/osu.Game/Localisation/UserInterfaceStrings.cs b/osu.Game/Localisation/UserInterfaceStrings.cs
index 4be403edb4..ac79f9f45d 100644
--- a/osu.Game/Localisation/UserInterfaceStrings.cs
+++ b/osu.Game/Localisation/UserInterfaceStrings.cs
@@ -24,6 +24,11 @@ namespace osu.Game.Localisation
         /// </summary>
         public static LocalisableString CursorRotation => new TranslatableString(getKey(@"cursor_rotation"), @"Rotate cursor when dragging");
 
+        /// <summary>
+        /// "Prefer 24-hour time"
+        /// </summary>
+        public static LocalisableString Prefer24HourTime => new TranslatableString(getKey(@"prefer_24_hour_time"), @"Prefer 24-hour time");
+
         /// <summary>
         /// "Menu cursor size"
         /// </summary>
diff --git a/osu.Game/Overlays/Settings/Sections/UserInterface/GeneralSettings.cs b/osu.Game/Overlays/Settings/Sections/UserInterface/GeneralSettings.cs
index 59894cbcae..d6d38c8e12 100644
--- a/osu.Game/Overlays/Settings/Sections/UserInterface/GeneralSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/UserInterface/GeneralSettings.cs
@@ -41,6 +41,11 @@ namespace osu.Game.Overlays.Settings.Sections.UserInterface
                     Current = config.GetBindable<double>(OsuSetting.UIHoldActivationDelay),
                     KeyboardStep = 50
                 },
+                new SettingsCheckbox
+                {
+                    LabelText = UserInterfaceStrings.Prefer24HourTime,
+                    Current = config.GetBindable<bool>(OsuSetting.Prefer24HourTime)
+                },
             };
         }
     }
diff --git a/osu.Game/Overlays/Toolbar/DigitalClockDisplay.cs b/osu.Game/Overlays/Toolbar/DigitalClockDisplay.cs
index b535c5c6a2..66f40532d0 100644
--- a/osu.Game/Overlays/Toolbar/DigitalClockDisplay.cs
+++ b/osu.Game/Overlays/Toolbar/DigitalClockDisplay.cs
@@ -29,7 +29,21 @@ namespace osu.Game.Overlays.Toolbar
             }
         }
 
-        private bool format12H = true;
+        private bool format12H = false;
+
+        public bool Format12H
+        {
+            get => format12H;
+            set
+            {
+                if (format12H == value)
+                    return;
+
+                format12H = value;
+                updateMetrics();
+                UpdateDisplay(DateTimeOffset.Now); //Update realTime.Text immediately instead of waiting until next second
+            }
+        }
 
         [BackgroundDependencyLoader]
         private void load(OsuColour colours)
@@ -52,14 +66,14 @@ namespace osu.Game.Overlays.Toolbar
 
         protected override void UpdateDisplay(DateTimeOffset now)
         {
-            realTime.Text = format12H ? $"{now:hh:mm:ss tt}" : $"{now:HH:mm:ss}";
+            realTime.Text = format12H ? $"{now:h:mm:ss tt}" : $"{now:HH:mm:ss}";
             gameTime.Text = $"running {new TimeSpan(TimeSpan.TicksPerSecond * (int)(Clock.CurrentTime / 1000)):c}";
         }
 
         private void updateMetrics()
         {
             if (format12H)
-                Width = 74;
+                Width = 70;
             else
                 Width = showRuntime ? 66 : 45; // Allows for space for game time up to 99 days (in the padding area since this is quite rare).
 
diff --git a/osu.Game/Overlays/Toolbar/ToolbarClock.cs b/osu.Game/Overlays/Toolbar/ToolbarClock.cs
index 22a96603dc..b256d6fbc4 100644
--- a/osu.Game/Overlays/Toolbar/ToolbarClock.cs
+++ b/osu.Game/Overlays/Toolbar/ToolbarClock.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.Globalization;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Extensions.Color4Extensions;
@@ -20,6 +21,7 @@ namespace osu.Game.Overlays.Toolbar
     public class ToolbarClock : OsuClickableContainer
     {
         private Bindable<ToolbarClockDisplayMode> clockDisplayMode;
+        private Bindable<bool> digitalPrefer24Hour;
 
         private Box hoverBackground;
         private Box flashBackground;
@@ -38,6 +40,7 @@ namespace osu.Game.Overlays.Toolbar
         private void load(OsuConfigManager config)
         {
             clockDisplayMode = config.GetBindable<ToolbarClockDisplayMode>(OsuSetting.ToolbarClockDisplayMode);
+            digitalPrefer24Hour = config.GetBindable<bool>(OsuSetting.Prefer24HourTime);
 
             Children = new Drawable[]
             {
@@ -94,6 +97,9 @@ namespace osu.Game.Overlays.Toolbar
 
                 analog.FadeTo(showAnalog ? 1 : 0);
             }, true);
+
+            digitalPrefer24Hour.BindValueChanged(prefer24H =>
+                digital.Format12H = prefer24H.NewValue ? false : CultureInfo.CurrentCulture.DateTimeFormat.ShortTimePattern.Contains("tt"), true);
         }
 
         protected override bool OnClick(ClickEvent e)

From 2525ec0d18db76a64e50be272dbf457204e1579a Mon Sep 17 00:00:00 2001
From: Perry MacMurray <perrymacmurray@gmail.com>
Date: Tue, 5 Apr 2022 17:07:58 -0400
Subject: [PATCH 3942/5547] Switch 24H toggle from UI settings to language
 settings

---
 osu.Game/Localisation/GeneralSettingsStrings.cs           | 5 +++++
 osu.Game/Localisation/UserInterfaceStrings.cs             | 5 -----
 .../Settings/Sections/General/LanguageSettings.cs         | 8 +++++++-
 .../Settings/Sections/UserInterface/GeneralSettings.cs    | 5 -----
 4 files changed, 12 insertions(+), 11 deletions(-)

diff --git a/osu.Game/Localisation/GeneralSettingsStrings.cs b/osu.Game/Localisation/GeneralSettingsStrings.cs
index a60e4891f4..cca8c8efd1 100644
--- a/osu.Game/Localisation/GeneralSettingsStrings.cs
+++ b/osu.Game/Localisation/GeneralSettingsStrings.cs
@@ -29,6 +29,11 @@ namespace osu.Game.Localisation
         /// </summary>
         public static LocalisableString PreferOriginalMetadataLanguage => new TranslatableString(getKey(@"prefer_original"), @"Prefer metadata in original language");
 
+        /// <summary>
+        /// "Prefer 24-hour time"
+        /// </summary>
+        public static LocalisableString Prefer24HourTime => new TranslatableString(getKey(@"prefer_24_hour_time"), @"Prefer 24-hour time");
+
         /// <summary>
         /// "Updates"
         /// </summary>
diff --git a/osu.Game/Localisation/UserInterfaceStrings.cs b/osu.Game/Localisation/UserInterfaceStrings.cs
index ac79f9f45d..4be403edb4 100644
--- a/osu.Game/Localisation/UserInterfaceStrings.cs
+++ b/osu.Game/Localisation/UserInterfaceStrings.cs
@@ -24,11 +24,6 @@ namespace osu.Game.Localisation
         /// </summary>
         public static LocalisableString CursorRotation => new TranslatableString(getKey(@"cursor_rotation"), @"Rotate cursor when dragging");
 
-        /// <summary>
-        /// "Prefer 24-hour time"
-        /// </summary>
-        public static LocalisableString Prefer24HourTime => new TranslatableString(getKey(@"prefer_24_hour_time"), @"Prefer 24-hour time");
-
         /// <summary>
         /// "Menu cursor size"
         /// </summary>
diff --git a/osu.Game/Overlays/Settings/Sections/General/LanguageSettings.cs b/osu.Game/Overlays/Settings/Sections/General/LanguageSettings.cs
index 200618c469..e7cc1bce10 100644
--- a/osu.Game/Overlays/Settings/Sections/General/LanguageSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/General/LanguageSettings.cs
@@ -6,6 +6,7 @@ using osu.Framework.Bindables;
 using osu.Framework.Configuration;
 using osu.Framework.Graphics;
 using osu.Framework.Localisation;
+using osu.Game.Configuration;
 using osu.Game.Extensions;
 using osu.Game.Localisation;
 
@@ -19,7 +20,7 @@ namespace osu.Game.Overlays.Settings.Sections.General
         protected override LocalisableString Header => GeneralSettingsStrings.LanguageHeader;
 
         [BackgroundDependencyLoader]
-        private void load(FrameworkConfigManager frameworkConfig)
+        private void load(FrameworkConfigManager frameworkConfig, OsuConfigManager config)
         {
             frameworkLocale = frameworkConfig.GetBindable<string>(FrameworkSetting.Locale);
 
@@ -34,6 +35,11 @@ namespace osu.Game.Overlays.Settings.Sections.General
                     LabelText = GeneralSettingsStrings.PreferOriginalMetadataLanguage,
                     Current = frameworkConfig.GetBindable<bool>(FrameworkSetting.ShowUnicode)
                 },
+                new SettingsCheckbox
+                {
+                    LabelText = GeneralSettingsStrings.Prefer24HourTime,
+                    Current = config.GetBindable<bool>(OsuSetting.Prefer24HourTime)
+                },
             };
 
             if (!LanguageExtensions.TryParseCultureCode(frameworkLocale.Value, out var locale))
diff --git a/osu.Game/Overlays/Settings/Sections/UserInterface/GeneralSettings.cs b/osu.Game/Overlays/Settings/Sections/UserInterface/GeneralSettings.cs
index d6d38c8e12..59894cbcae 100644
--- a/osu.Game/Overlays/Settings/Sections/UserInterface/GeneralSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/UserInterface/GeneralSettings.cs
@@ -41,11 +41,6 @@ namespace osu.Game.Overlays.Settings.Sections.UserInterface
                     Current = config.GetBindable<double>(OsuSetting.UIHoldActivationDelay),
                     KeyboardStep = 50
                 },
-                new SettingsCheckbox
-                {
-                    LabelText = UserInterfaceStrings.Prefer24HourTime,
-                    Current = config.GetBindable<bool>(OsuSetting.Prefer24HourTime)
-                },
             };
         }
     }

From 01da3924ccf7ccf91431ffb22db3fd15cf468b50 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 6 Apr 2022 11:32:35 +0900
Subject: [PATCH 3943/5547] Simplify `IsCurrentScreen` check to only apply to
 relevant call

---
 .../Multiplayer/MultiplayerMatchSongSelect.cs         | 11 +++--------
 1 file changed, 3 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs
index 2e8f625eba..289b8730ce 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs
@@ -74,18 +74,13 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
 
                 task.FireAndForget(onSuccess: () => Schedule(() =>
                 {
+                    loadingLayer.Hide();
+
                     // If an error or server side trigger occurred this screen may have already exited by external means.
                     if (!this.IsCurrentScreen())
-                        return;
-
-                    loadingLayer.Hide();
-                    this.Exit();
+                        this.Exit();
                 }), onError: _ => Schedule(() =>
                 {
-                    // If an error or server side trigger occurred this screen may have already exited by external means.
-                    if (!this.IsCurrentScreen())
-                        return;
-
                     loadingLayer.Hide();
                     Carousel.AllowSelection = true;
                 }));

From f795f77cf99d5dbd902860f7e685b1d0c2130393 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 6 Apr 2022 14:00:54 +0900
Subject: [PATCH 3944/5547] Add missing newline

---
 osu.Game/Online/Multiplayer/MultiplayerClientExtensions.cs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Game/Online/Multiplayer/MultiplayerClientExtensions.cs b/osu.Game/Online/Multiplayer/MultiplayerClientExtensions.cs
index 98c593236a..4729765084 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerClientExtensions.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerClientExtensions.cs
@@ -2,6 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 #nullable enable
+
 using System;
 using System.Diagnostics;
 using System.Threading.Tasks;

From 220d7bc6db4a2fbfb5c84a58c7c7058c3b7218f1 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 6 Apr 2022 14:01:25 +0900
Subject: [PATCH 3945/5547] Fix dangerous realm operation in
 `TestSceneMultiplayerMatchSongSelect`

The import process was running on the async load thread, but then
accessed from the access thread later on. This seemed to somehow pass
fine in headless runs, but would fail on visual test execution
(specifically on `TestBeatmapConfirmed()`).
---
 .../Multiplayer/TestSceneMultiplayerMatchSongSelect.cs | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs
index 381b9b58bd..84c53ce22e 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs
@@ -15,6 +15,7 @@ using osu.Framework.Screens;
 using osu.Framework.Testing;
 using osu.Framework.Utils;
 using osu.Game.Beatmaps;
+using osu.Game.Database;
 using osu.Game.Online.Rooms;
 using osu.Game.Overlays.Mods;
 using osu.Game.Rulesets;
@@ -35,10 +36,12 @@ namespace osu.Game.Tests.Visual.Multiplayer
         private BeatmapManager manager;
         private RulesetStore rulesets;
 
-        private List<BeatmapInfo> beatmaps;
+        private IList<BeatmapInfo> beatmaps => importedBeatmapSet?.PerformRead(s => s.Beatmaps) ?? new List<BeatmapInfo>();
 
         private TestMultiplayerMatchSongSelect songSelect;
 
+        private Live<BeatmapSetInfo> importedBeatmapSet;
+
         [BackgroundDependencyLoader]
         private void load(GameHost host, AudioManager audio)
         {
@@ -46,8 +49,6 @@ namespace osu.Game.Tests.Visual.Multiplayer
             Dependencies.Cache(manager = new BeatmapManager(LocalStorage, Realm, rulesets, null, audio, Resources, host, Beatmap.Default));
             Dependencies.Cache(Realm);
 
-            beatmaps = new List<BeatmapInfo>();
-
             var metadata = new BeatmapMetadata
             {
                 Artist = "Some Artist",
@@ -79,11 +80,10 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     Difficulty = new BeatmapDifficulty()
                 };
 
-                beatmaps.Add(beatmap);
                 beatmapSetInfo.Beatmaps.Add(beatmap);
             }
 
-            manager.Import(beatmapSetInfo);
+            importedBeatmapSet = manager.Import(beatmapSetInfo);
         }
 
         public override void SetUpSteps()

From 552ec5282f1d7fcb9a11cac2859f0ed570d3abde Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 6 Apr 2022 14:44:00 +0900
Subject: [PATCH 3946/5547] Change `WorkingBeatmap.GetVirtualTrack` to use
 length provided by `BeatmapInfo`

A lot of tests are using test resources that populate the length field,
but do not populate hitobjects. The general expectation is that
components should be using the cached length in cases where hitobjects
are not relevant, but `GetVirtualTrack` was doing its own local
calculation.

This could cause tests to fail due to `MusicController` changing track
in the background.
---
 osu.Game/Beatmaps/WorkingBeatmap.cs | 20 +-------------------
 1 file changed, 1 insertion(+), 19 deletions(-)

diff --git a/osu.Game/Beatmaps/WorkingBeatmap.cs b/osu.Game/Beatmaps/WorkingBeatmap.cs
index 397d47c389..bb64ec796c 100644
--- a/osu.Game/Beatmaps/WorkingBeatmap.cs
+++ b/osu.Game/Beatmaps/WorkingBeatmap.cs
@@ -17,7 +17,6 @@ using osu.Framework.Logging;
 using osu.Framework.Testing;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Mods;
-using osu.Game.Rulesets.Objects.Types;
 using osu.Game.Rulesets.UI;
 using osu.Game.Skinning;
 using osu.Game.Storyboards;
@@ -152,24 +151,7 @@ namespace osu.Game.Beatmaps
         {
             const double excess_length = 1000;
 
-            var lastObject = Beatmap?.HitObjects.LastOrDefault();
-
-            double length;
-
-            switch (lastObject)
-            {
-                case null:
-                    length = emptyLength;
-                    break;
-
-                case IHasDuration endTime:
-                    length = endTime.EndTime + excess_length;
-                    break;
-
-                default:
-                    length = lastObject.StartTime + excess_length;
-                    break;
-            }
+            double length = (BeatmapInfo?.Length + excess_length) ?? emptyLength;
 
             return audioManager.Tracks.GetVirtual(length);
         }

From d17890ca9acd9d30ce2269dab25712cce966cbe1 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 6 Apr 2022 14:51:08 +0900
Subject: [PATCH 3947/5547] Replace a couple more local test beatmap cases
 which can instead use `TestResources` methods

---
 .../TestSceneMultiplayerMatchSongSelect.cs    | 39 +------------------
 .../TestSceneDeleteLocalScore.cs              | 17 +-------
 2 files changed, 3 insertions(+), 53 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs
index 84c53ce22e..714951cc42 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs
@@ -8,12 +8,10 @@ using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
 using osu.Framework.Bindables;
-using osu.Framework.Extensions;
 using osu.Framework.Extensions.TypeExtensions;
 using osu.Framework.Platform;
 using osu.Framework.Screens;
 using osu.Framework.Testing;
-using osu.Framework.Utils;
 using osu.Game.Beatmaps;
 using osu.Game.Database;
 using osu.Game.Online.Rooms;
@@ -28,6 +26,7 @@ using osu.Game.Rulesets.Taiko.Mods;
 using osu.Game.Screens.OnlinePlay;
 using osu.Game.Screens.OnlinePlay.Multiplayer;
 using osu.Game.Screens.Select;
+using osu.Game.Tests.Resources;
 
 namespace osu.Game.Tests.Visual.Multiplayer
 {
@@ -49,41 +48,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             Dependencies.Cache(manager = new BeatmapManager(LocalStorage, Realm, rulesets, null, audio, Resources, host, Beatmap.Default));
             Dependencies.Cache(Realm);
 
-            var metadata = new BeatmapMetadata
-            {
-                Artist = "Some Artist",
-                Title = "Some Beatmap",
-                Author = { Username = "Some Author" },
-            };
-
-            var beatmapSetInfo = new BeatmapSetInfo
-            {
-                OnlineID = 10,
-                Hash = Guid.NewGuid().ToString().ComputeMD5Hash(),
-                DateAdded = DateTimeOffset.UtcNow
-            };
-
-            for (int i = 0; i < 8; ++i)
-            {
-                int beatmapId = 10 * 10 + i;
-
-                int length = RNG.Next(30000, 200000);
-                double bpm = RNG.NextSingle(80, 200);
-
-                var beatmap = new BeatmapInfo
-                {
-                    Ruleset = rulesets.GetRuleset(i % 4) ?? throw new InvalidOperationException(),
-                    OnlineID = beatmapId,
-                    Length = length,
-                    BPM = bpm,
-                    Metadata = metadata,
-                    Difficulty = new BeatmapDifficulty()
-                };
-
-                beatmapSetInfo.Beatmaps.Add(beatmap);
-            }
-
-            importedBeatmapSet = manager.Import(beatmapSetInfo);
+            importedBeatmapSet = manager.Import(TestResources.CreateTestBeatmapSetInfo(8, rulesets.AvailableRulesets.ToArray()));
         }
 
         public override void SetUpSteps()
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
index 13404a9810..72dfc53c01 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.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.Linq;
 using NUnit.Framework;
@@ -17,7 +16,6 @@ using osu.Game.Beatmaps;
 using osu.Game.Database;
 using osu.Game.Graphics.Cursor;
 using osu.Game.Graphics.UserInterface;
-using osu.Game.Models;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Leaderboards;
 using osu.Game.Overlays;
@@ -60,20 +58,7 @@ namespace osu.Game.Tests.Visual.UserInterface
                         Anchor = Anchor.Centre,
                         Size = new Vector2(550f, 450f),
                         Scope = BeatmapLeaderboardScope.Local,
-                        BeatmapInfo = new BeatmapInfo
-                        {
-                            ID = Guid.NewGuid(),
-                            Metadata = new BeatmapMetadata
-                            {
-                                Title = "TestSong",
-                                Artist = "TestArtist",
-                                Author = new RealmUser
-                                {
-                                    Username = "TestAuthor"
-                                },
-                            },
-                            DifficultyName = "Insane"
-                        },
+                        BeatmapInfo = TestResources.CreateTestBeatmapSetInfo().Beatmaps.First()
                     }
                 },
                 dialogOverlay = new DialogOverlay()

From 2b8a5833ddd4794c89fbb452d6a7d2d52bb107be Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 6 Apr 2022 15:13:02 +0900
Subject: [PATCH 3948/5547] Fix back-to-front conditional check

---
 .../OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs        | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs
index 289b8730ce..848424bc76 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs
@@ -77,7 +77,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
                     loadingLayer.Hide();
 
                     // If an error or server side trigger occurred this screen may have already exited by external means.
-                    if (!this.IsCurrentScreen())
+                    if (this.IsCurrentScreen())
                         this.Exit();
                 }), onError: _ => Schedule(() =>
                 {

From c2b2d443ed070da9b8fafa5b871e235f40ca13f8 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 6 Apr 2022 15:31:12 +0900
Subject: [PATCH 3949/5547] Add more comprehensive assert output to try and
 discern CI issues

---
 .../Visual/Gameplay/TestSceneLeadIn.cs         | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneLeadIn.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneLeadIn.cs
index 5a1fc1b1e5..58d2e4a1da 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneLeadIn.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneLeadIn.cs
@@ -36,10 +36,10 @@ namespace osu.Game.Tests.Visual.Gameplay
                 BeatmapInfo = { AudioLeadIn = leadIn }
             });
 
-            AddAssert($"first frame is {expectedStartTime}", () =>
+            AddStep($"check first frame time", () =>
             {
-                Debug.Assert(player.FirstFrameClockTime != null);
-                return Precision.AlmostEquals(player.FirstFrameClockTime.Value, expectedStartTime, lenience_ms);
+                Assert.That(player.FirstFrameClockTime, Is.Not.Null);
+                Assert.That(player.FirstFrameClockTime.Value, Is.EqualTo(expectedStartTime).Within(lenience_ms));
             });
         }
 
@@ -59,10 +59,10 @@ namespace osu.Game.Tests.Visual.Gameplay
 
             loadPlayerWithBeatmap(new TestBeatmap(new OsuRuleset().RulesetInfo), storyboard);
 
-            AddAssert($"first frame is {expectedStartTime}", () =>
+            AddStep($"check first frame time", () =>
             {
-                Debug.Assert(player.FirstFrameClockTime != null);
-                return Precision.AlmostEquals(player.FirstFrameClockTime.Value, expectedStartTime, lenience_ms);
+                Assert.That(player.FirstFrameClockTime, Is.Not.Null);
+                Assert.That(player.FirstFrameClockTime.Value, Is.EqualTo(expectedStartTime).Within(lenience_ms));
             });
         }
 
@@ -97,10 +97,10 @@ namespace osu.Game.Tests.Visual.Gameplay
 
             loadPlayerWithBeatmap(new TestBeatmap(new OsuRuleset().RulesetInfo), storyboard);
 
-            AddAssert($"first frame is {expectedStartTime}", () =>
+            AddStep($"check first frame time", () =>
             {
-                Debug.Assert(player.FirstFrameClockTime != null);
-                return Precision.AlmostEquals(player.FirstFrameClockTime.Value, expectedStartTime, lenience_ms);
+                Assert.That(player.FirstFrameClockTime, Is.Not.Null);
+                Assert.That(player.FirstFrameClockTime.Value, Is.EqualTo(expectedStartTime).Within(lenience_ms));
             });
         }
 

From 065bb60324c6f62393aee92799b4a6d916a9fa77 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 6 Apr 2022 16:05:11 +0900
Subject: [PATCH 3950/5547] Remove unused using statements

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

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneLeadIn.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneLeadIn.cs
index 58d2e4a1da..5ec9c6c474 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneLeadIn.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneLeadIn.cs
@@ -1,12 +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.Diagnostics;
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Graphics;
 using osu.Framework.Timing;
-using osu.Framework.Utils;
 using osu.Game.Beatmaps;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Rulesets.Osu;

From c42ef43faaeedd1ff18ccd6c1ceb16bd0e44a790 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 6 Apr 2022 16:46:52 +0900
Subject: [PATCH 3951/5547] Ensure intro beatmap has protected flag set

In cases this isn't set, the beatmap has likely entered a bad state.

Closes https://github.com/ppy/osu/issues/17659.
---
 osu.Game/Screens/Menu/IntroScreen.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Menu/IntroScreen.cs b/osu.Game/Screens/Menu/IntroScreen.cs
index a6b54dd1f2..e569b0e517 100644
--- a/osu.Game/Screens/Menu/IntroScreen.cs
+++ b/osu.Game/Screens/Menu/IntroScreen.cs
@@ -147,7 +147,7 @@ namespace osu.Game.Screens.Menu
 
             bool loadThemedIntro()
             {
-                var setInfo = beatmaps.QueryBeatmapSet(b => b.Hash == BeatmapHash);
+                var setInfo = beatmaps.QueryBeatmapSet(b => b.Protected && b.Hash == BeatmapHash);
 
                 if (setInfo == null)
                     return false;

From 43724f477a1cb7870a64d0878159ad4606678d87 Mon Sep 17 00:00:00 2001
From: Huo Yaoyuan <huoyaoyuan@hotmail.com>
Date: Wed, 6 Apr 2022 19:14:00 +0800
Subject: [PATCH 3952/5547] Remove outdated NU1701 warning.

---
 Directory.Build.props | 8 --------
 1 file changed, 8 deletions(-)

diff --git a/Directory.Build.props b/Directory.Build.props
index 5bdf12218c..3ab3dc3d13 100644
--- a/Directory.Build.props
+++ b/Directory.Build.props
@@ -26,14 +26,6 @@
     <GenerateDocumentationFile>true</GenerateDocumentationFile>
     <NoWarn>$(NoWarn);CS1591</NoWarn>
   </PropertyGroup>
-  <PropertyGroup Label="Project">
-    <!--
-    NU1701:
-      DeepEqual is not netstandard-compatible. This is fine since we run tests with .NET Framework anyway.
-      This is required due to https://github.com/NuGet/Home/issues/5740
-    -->
-    <NoWarn>$(NoWarn);NU1701</NoWarn>
-  </PropertyGroup>
   <PropertyGroup Label="Nuget">
     <IsPackable>false</IsPackable>
     <Authors>ppy Pty Ltd</Authors>

From ec4f1bcbc8209dce61b5cc8ce6862a15aaa2d50c Mon Sep 17 00:00:00 2001
From: Huo Yaoyuan <huoyaoyuan@hotmail.com>
Date: Wed, 6 Apr 2022 19:18:18 +0800
Subject: [PATCH 3953/5547] Remove outdated NETCore packages.

---
 osu.Desktop/osu.Desktop.csproj | 2 --
 osu.Game/osu.Game.csproj       | 1 -
 2 files changed, 3 deletions(-)

diff --git a/osu.Desktop/osu.Desktop.csproj b/osu.Desktop/osu.Desktop.csproj
index a06484214b..3ca6411812 100644
--- a/osu.Desktop/osu.Desktop.csproj
+++ b/osu.Desktop/osu.Desktop.csproj
@@ -25,7 +25,6 @@
   </ItemGroup>
   <ItemGroup Label="Package References">
     <PackageReference Include="Clowd.Squirrel" Version="2.8.28-pre" />
-    <PackageReference Include="Microsoft.NETCore.Targets" Version="5.0.0" />
     <PackageReference Include="Mono.Posix.NETStandard" Version="1.0.0" />
     <PackageReference Include="System.IO.Packaging" Version="6.0.0" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="5.0.14" />
@@ -33,7 +32,6 @@
       <PrivateAssets>all</PrivateAssets>
       <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
     </PackageReference>
-    <PackageReference Include="Microsoft.Win32.Registry" Version="5.0.0" />
     <PackageReference Include="DiscordRichPresence" Version="1.0.175" />
   </ItemGroup>
   <ItemGroup Label="Resources">
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 7b0f8c72c5..db1a945765 100644
--- a/osu.Game/osu.Game.csproj
+++ b/osu.Game/osu.Game.csproj
@@ -29,7 +29,6 @@
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="5.0.14" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.Core" Version="5.0.14" />
     <PackageReference Include="Microsoft.Extensions.Configuration.Abstractions" Version="6.0.0" />
-    <PackageReference Include="Microsoft.NETCore.Targets" Version="3.1.0" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
     <PackageReference Include="ppy.LocalisationAnalyser" Version="2022.320.0">
       <PrivateAssets>all</PrivateAssets>

From edb556643edf509ed77eb3da3e926658d08e45b6 Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Tue, 5 Apr 2022 01:00:33 -0700
Subject: [PATCH 3954/5547] Add failing replay button enabled test asserts

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

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneReplayDownloadButton.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneReplayDownloadButton.cs
index 8b7e1c4e58..5d25287e45 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneReplayDownloadButton.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneReplayDownloadButton.cs
@@ -150,10 +150,12 @@ namespace osu.Game.Tests.Visual.Gameplay
             AddStep("import score", () => imported = scoreManager.Import(getScoreInfo(true)));
 
             AddUntilStep("state is available", () => downloadButton.State.Value == DownloadState.LocallyAvailable);
+            AddAssert("button is enabled", () => downloadButton.ChildrenOfType<DownloadButton>().First().Enabled.Value);
 
             AddStep("delete score", () => scoreManager.Delete(imported.Value));
 
             AddUntilStep("state is not downloaded", () => downloadButton.State.Value == DownloadState.NotDownloaded);
+            AddAssert("button is not enabled", () => !downloadButton.ChildrenOfType<DownloadButton>().First().Enabled.Value);
         }
 
         [Test]

From 4432a93d096ed81f1a94d11914c48e19c1e346dd Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Tue, 5 Apr 2022 01:04:19 -0700
Subject: [PATCH 3955/5547] Fix replay button being disabled when available
 locally but not online

---
 osu.Game/Screens/Ranking/ReplayDownloadButton.cs | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Screens/Ranking/ReplayDownloadButton.cs b/osu.Game/Screens/Ranking/ReplayDownloadButton.cs
index 6a74fdaf75..222115daca 100644
--- a/osu.Game/Screens/Ranking/ReplayDownloadButton.cs
+++ b/osu.Game/Screens/Ranking/ReplayDownloadButton.cs
@@ -87,19 +87,20 @@ namespace osu.Game.Screens.Ranking
                     });
                 }
 
-                button.Enabled.Value = replayAvailability != ReplayAvailability.NotAvailable;
-                updateTooltip();
+                updateState();
             }, true);
 
             State.BindValueChanged(state =>
             {
                 button.State.Value = state.NewValue;
-                updateTooltip();
+                updateState();
             }, true);
         }
 
-        private void updateTooltip()
+        private void updateState()
         {
+            button.Enabled.Value = replayAvailability != ReplayAvailability.NotAvailable;
+
             switch (replayAvailability)
             {
                 case ReplayAvailability.Local:

From 8a73831115ab15eff3059e938786c235646862b6 Mon Sep 17 00:00:00 2001
From: Jamie Taylor <me@nekodex.net>
Date: Thu, 7 Apr 2022 13:12:33 +0900
Subject: [PATCH 3956/5547] Add MP lobby 'warning' SFX for the final seconds of
 countdown

---
 .../Multiplayer/Match/MultiplayerReadyButton.cs  | 16 ++++++++++++----
 1 file changed, 12 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
index d275f309cb..22a0243f8f 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
@@ -30,13 +30,15 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
         private MultiplayerRoom room => multiplayerClient.Room;
 
         private Sample countdownTickSample;
+        private Sample countdownWarnSample;
+        private Sample countdownWarnFinalSample;
 
         [BackgroundDependencyLoader]
         private void load(AudioManager audio)
         {
             countdownTickSample = audio.Samples.Get(@"Multiplayer/countdown-tick");
-            // disabled for now pending further work on sound effect
-            // countdownTickFinalSample = audio.Samples.Get(@"Multiplayer/countdown-tick-final");
+            countdownWarnSample = audio.Samples.Get(@"Multiplayer/countdown-warn");
+            countdownWarnFinalSample = audio.Samples.Get(@"Multiplayer/countdown-warn-final");
         }
 
         protected override void LoadComplete()
@@ -102,8 +104,14 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
         private void playTickSound(int secondsRemaining)
         {
             if (secondsRemaining < 10) countdownTickSample?.Play();
-            // disabled for now pending further work on sound effect
-            // if (secondsRemaining <= 3) countdownTickFinalSample?.Play();
+
+            if (secondsRemaining <= 3)
+            {
+                if (secondsRemaining > 0)
+                    countdownWarnSample?.Play();
+                else
+                    countdownWarnFinalSample?.Play();
+            }
         }
 
         private void updateButtonText()

From 358931842fc1936b8141cf58d6fe2c67ca6851ce Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Wed, 6 Apr 2022 21:22:56 -0700
Subject: [PATCH 3957/5547] Move enabled setting to each case

---
 osu.Game/Screens/Ranking/ReplayDownloadButton.cs | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/Ranking/ReplayDownloadButton.cs b/osu.Game/Screens/Ranking/ReplayDownloadButton.cs
index 222115daca..0c9c909395 100644
--- a/osu.Game/Screens/Ranking/ReplayDownloadButton.cs
+++ b/osu.Game/Screens/Ranking/ReplayDownloadButton.cs
@@ -99,20 +99,21 @@ namespace osu.Game.Screens.Ranking
 
         private void updateState()
         {
-            button.Enabled.Value = replayAvailability != ReplayAvailability.NotAvailable;
-
             switch (replayAvailability)
             {
                 case ReplayAvailability.Local:
                     button.TooltipText = @"watch replay";
+                    button.Enabled.Value = true;
                     break;
 
                 case ReplayAvailability.Online:
                     button.TooltipText = @"download replay";
+                    button.Enabled.Value = true;
                     break;
 
                 default:
                     button.TooltipText = @"replay unavailable";
+                    button.Enabled.Value = false;
                     break;
             }
         }

From 9ed4f310488e9c53223893674d21dea7f2a9617f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 7 Apr 2022 13:35:07 +0900
Subject: [PATCH 3958/5547] Update resources

---
 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 f1cbe1c9eb..10685d5990 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -51,7 +51,7 @@
     <Reference Include="Java.Interop" />
   </ItemGroup>
   <ItemGroup>
-    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.405.0" />
+    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.407.0" />
     <PackageReference Include="ppy.osu.Framework.Android" Version="2022.405.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index a009307cfe..7fd2647a8a 100644
--- a/osu.Game/osu.Game.csproj
+++ b/osu.Game/osu.Game.csproj
@@ -36,7 +36,7 @@
     </PackageReference>
     <PackageReference Include="Realm" Version="10.10.0" />
     <PackageReference Include="ppy.osu.Framework" Version="2022.405.0" />
-    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.405.0" />
+    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.407.0" />
     <PackageReference Include="Sentry" Version="3.14.1" />
     <PackageReference Include="SharpCompress" Version="0.30.1" />
     <PackageReference Include="NUnit" Version="3.13.2" />
diff --git a/osu.iOS.props b/osu.iOS.props
index 6e35fba86f..a5efc40d51 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -62,7 +62,7 @@
   </ItemGroup>
   <ItemGroup Label="Package References">
     <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.405.0" />
-    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.405.0" />
+    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.407.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net6.0) -->
   <PropertyGroup>

From b7f8716de9cd1f32c4ea9ad7f6b32b43b842167c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 7 Apr 2022 14:10:08 +0900
Subject: [PATCH 3959/5547] Add test coverage of skin lookups failing when
 `@2x` and extension are present

---
 .../Skinning/LegacySkinTextureFallbackTest.cs      | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/osu.Game.Tests/NonVisual/Skinning/LegacySkinTextureFallbackTest.cs b/osu.Game.Tests/NonVisual/Skinning/LegacySkinTextureFallbackTest.cs
index 7516e7500b..db7fc0b4a0 100644
--- a/osu.Game.Tests/NonVisual/Skinning/LegacySkinTextureFallbackTest.cs
+++ b/osu.Game.Tests/NonVisual/Skinning/LegacySkinTextureFallbackTest.cs
@@ -69,6 +69,20 @@ namespace osu.Game.Tests.NonVisual.Skinning
                 "Gameplay/osu/followpoint",
                 "followpoint", 1
             },
+            new object[]
+            {
+                // Looking up a filename with extension specified should work.
+                new[] { "followpoint.png" },
+                "followpoint.png",
+                "followpoint.png", 1
+            },
+            new object[]
+            {
+                // Looking up a filename with extension specified should also work with @2x sprites.
+                new[] { "followpoint@2x.png" },
+                "followpoint.png",
+                "followpoint@2x.png", 2
+            },
         };
 
         [TestCaseSource(nameof(fallbackTestCases))]

From 205edb65a2d800eb7bf54bdf3d1b8e56f4c81f19 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 7 Apr 2022 14:16:16 +0900
Subject: [PATCH 3960/5547] Fix filename lookups on `LegacySkin`s going awry
 when extension is specified

Due to the logic present to handle `@2x` fallback, the extension was
potentially being added at the wrong point in the filename. This change
ensures that the lookup filenames are always correct.

Closes https://github.com/ppy/osu/issues/17690.
---
 osu.Game/Skinning/LegacySkin.cs | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Skinning/LegacySkin.cs b/osu.Game/Skinning/LegacySkin.cs
index 92713023f4..a97b5d44ce 100644
--- a/osu.Game/Skinning/LegacySkin.cs
+++ b/osu.Game/Skinning/LegacySkin.cs
@@ -443,7 +443,11 @@ namespace osu.Game.Skinning
                 string lookupName = name.Replace(@"@2x", string.Empty);
 
                 float ratio = 2;
-                var texture = Textures?.Get(@$"{lookupName}@2x", wrapModeS, wrapModeT);
+                string twoTimesFilename = Path.HasExtension(lookupName)
+                    ? @$"{Path.GetFileNameWithoutExtension(lookupName)}@2x{Path.GetExtension(lookupName)}"
+                    : @$"{lookupName}@2x";
+
+                var texture = Textures?.Get(twoTimesFilename, wrapModeS, wrapModeT);
 
                 if (texture == null)
                 {

From a7e262627fe34e05c91497366b67054beb962fd9 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 7 Apr 2022 15:13:39 +0900
Subject: [PATCH 3961/5547] Fix `DrawableStoryboardAnimation` not specifying
 sizing correctly

Usually this would be handled by `TextureAnimation`, but because we are
inheriting from `DrawableAnimation` here for reasons, we needed to
implement this ourselves. Follows the implementation in
`TextureAnimation`.
---
 .../Drawables/DrawableStoryboardAnimation.cs           | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/osu.Game/Storyboards/Drawables/DrawableStoryboardAnimation.cs b/osu.Game/Storyboards/Drawables/DrawableStoryboardAnimation.cs
index 88cb5f40a1..2ef6f28720 100644
--- a/osu.Game/Storyboards/Drawables/DrawableStoryboardAnimation.cs
+++ b/osu.Game/Storyboards/Drawables/DrawableStoryboardAnimation.cs
@@ -5,8 +5,10 @@ using System;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Animations;
+using osu.Framework.Graphics.Sprites;
 using osu.Framework.Graphics.Textures;
 using osu.Framework.Utils;
+using osu.Game.Skinning;
 using osuTK;
 
 namespace osu.Game.Storyboards.Drawables
@@ -88,6 +90,14 @@ namespace osu.Game.Storyboards.Drawables
             LifetimeEnd = animation.EndTime;
         }
 
+        protected override Vector2 GetCurrentDisplaySize()
+        {
+            Texture texture = (CurrentFrame as Sprite)?.Texture
+                              ?? ((CurrentFrame as SkinnableSprite)?.Drawable as Sprite)?.Texture;
+
+            return new Vector2(texture?.DisplayWidth ?? 0, texture?.DisplayHeight ?? 0);
+        }
+
         [BackgroundDependencyLoader]
         private void load(TextureStore textureStore, Storyboard storyboard)
         {

From 93bdca5211c52c37c5e0fc358693affe9366ad5b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 7 Apr 2022 17:26:23 +0900
Subject: [PATCH 3962/5547] Split out `GetTextures` helper function for
 `LegacySkin`s

---
 osu.Game/Skinning/LegacySkinExtensions.cs | 86 ++++++++++++++---------
 1 file changed, 54 insertions(+), 32 deletions(-)

diff --git a/osu.Game/Skinning/LegacySkinExtensions.cs b/osu.Game/Skinning/LegacySkinExtensions.cs
index 479afabb00..514a06a4ee 100644
--- a/osu.Game/Skinning/LegacySkinExtensions.cs
+++ b/osu.Game/Skinning/LegacySkinExtensions.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.
 
+#nullable enable
+
 using System;
 using System.Collections.Generic;
+using System.Diagnostics;
 using System.Linq;
-using JetBrains.Annotations;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
@@ -18,39 +20,32 @@ namespace osu.Game.Skinning
 {
     public static class LegacySkinExtensions
     {
-        [CanBeNull]
-        public static Drawable GetAnimation(this ISkin source, string componentName, bool animatable, bool looping, bool applyConfigFrameRate = false, string animationSeparator = "-",
-                                            bool startAtCurrentTime = true, double? frameLength = null)
+        public static Drawable? GetAnimation(this ISkin? source, string componentName, bool animatable, bool looping, bool applyConfigFrameRate = false, string animationSeparator = "-",
+                                             bool startAtCurrentTime = true, double? frameLength = null)
             => source.GetAnimation(componentName, default, default, animatable, looping, applyConfigFrameRate, animationSeparator, startAtCurrentTime, frameLength);
 
-        [CanBeNull]
-        public static Drawable GetAnimation(this ISkin source, string componentName, WrapMode wrapModeS, WrapMode wrapModeT, bool animatable, bool looping, bool applyConfigFrameRate = false,
-                                            string animationSeparator = "-",
-                                            bool startAtCurrentTime = true, double? frameLength = null)
+        public static Drawable? GetAnimation(this ISkin? source, string componentName, WrapMode wrapModeS, WrapMode wrapModeT, bool animatable, bool looping, bool applyConfigFrameRate = false,
+                                             string animationSeparator = "-", bool startAtCurrentTime = true, double? frameLength = null)
         {
-            Texture texture;
-
-            // find the first source which provides either the animated or non-animated version.
-            ISkin skin = (source as ISkinSource)?.FindProvider(s =>
-            {
-                if (animatable && s.GetTexture(getFrameName(0)) != null)
-                    return true;
-
-                return s.GetTexture(componentName, wrapModeS, wrapModeT) != null;
-            }) ?? source;
-
-            if (skin == null)
+            if (source == null)
                 return null;
 
-            if (animatable)
-            {
-                var textures = getTextures().ToArray();
+            var textures = GetTextures(source, componentName, wrapModeS, wrapModeT, animatable, animationSeparator, out var retrievalSource);
+
+            switch (textures.Length)
+            {
+                case 0:
+                    return null;
+
+                case 1:
+                    return new Sprite { Texture = textures[0] };
+
+                default:
+                    Debug.Assert(retrievalSource != null);
 
-                if (textures.Length > 0)
-                {
                     var animation = new SkinnableTextureAnimation(startAtCurrentTime)
                     {
-                        DefaultFrameLength = frameLength ?? getFrameLength(skin, applyConfigFrameRate, textures),
+                        DefaultFrameLength = frameLength ?? getFrameLength(retrievalSource, applyConfigFrameRate, textures),
                         Loop = looping,
                     };
 
@@ -58,19 +53,46 @@ namespace osu.Game.Skinning
                         animation.AddFrame(t);
 
                     return animation;
-                }
+            }
+        }
+
+        public static Texture[] GetTextures(this ISkin? source, string componentName, WrapMode wrapModeS, WrapMode wrapModeT, bool animatable, string animationSeparator, out ISkin? retrievalSource)
+        {
+            retrievalSource = null;
+
+            if (source == null)
+                return Array.Empty<Texture>();
+
+            // find the first source which provides either the animated or non-animated version.
+            retrievalSource = (source as ISkinSource)?.FindProvider(s =>
+            {
+                if (animatable && s.GetTexture(getFrameName(0)) != null)
+                    return true;
+
+                return s.GetTexture(componentName, wrapModeS, wrapModeT) != null;
+            }) ?? source;
+
+            if (animatable)
+            {
+                var textures = getTextures(retrievalSource).ToArray();
+
+                if (textures.Length > 0)
+                    return textures;
             }
 
             // if an animation was not allowed or not found, fall back to a sprite retrieval.
-            if ((texture = skin.GetTexture(componentName, wrapModeS, wrapModeT)) != null)
-                return new Sprite { Texture = texture };
+            var singleTexture = retrievalSource.GetTexture(componentName, wrapModeS, wrapModeT);
 
-            return null;
+            return singleTexture != null
+                ? new[] { singleTexture }
+                : Array.Empty<Texture>();
 
-            IEnumerable<Texture> getTextures()
+            IEnumerable<Texture> getTextures(ISkin skin)
             {
                 for (int i = 0; true; i++)
                 {
+                    Texture? texture;
+
                     if ((texture = skin.GetTexture(getFrameName(i), wrapModeS, wrapModeT)) == null)
                         break;
 
@@ -130,7 +152,7 @@ namespace osu.Game.Skinning
         public class SkinnableTextureAnimation : TextureAnimation
         {
             [Resolved(canBeNull: true)]
-            private IAnimationTimeReference timeReference { get; set; }
+            private IAnimationTimeReference? timeReference { get; set; }
 
             private readonly Bindable<double> animationStartTime = new BindableDouble();
 

From cbc4e5319d1fa8d7b0f77ca9a5549cc56acaedad Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 7 Apr 2022 17:26:31 +0900
Subject: [PATCH 3963/5547] Fix `DrawableStoryboardAnimation` to handle skin
 fallback frame count similar to stable

Reasoning is explained in the inline comment (basically, stable doesn't
care what the user specifies as the frame count when falling back to
skin resources).

This change also removes on to two layers of drawables, which should be
a win in heavy storyboards.
---
 .../Drawables/DrawableStoryboardAnimation.cs  | 47 +++++++++++++++++--
 .../Drawables/DrawableStoryboardSprite.cs     | 27 ++++++++---
 osu.Game/Storyboards/Storyboard.cs            | 20 ++------
 3 files changed, 66 insertions(+), 28 deletions(-)

diff --git a/osu.Game/Storyboards/Drawables/DrawableStoryboardAnimation.cs b/osu.Game/Storyboards/Drawables/DrawableStoryboardAnimation.cs
index 2ef6f28720..28e65a7910 100644
--- a/osu.Game/Storyboards/Drawables/DrawableStoryboardAnimation.cs
+++ b/osu.Game/Storyboards/Drawables/DrawableStoryboardAnimation.cs
@@ -2,6 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
+using System.IO;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Animations;
@@ -98,17 +99,55 @@ namespace osu.Game.Storyboards.Drawables
             return new Vector2(texture?.DisplayWidth ?? 0, texture?.DisplayHeight ?? 0);
         }
 
+        [Resolved]
+        private ISkinSource skin { get; set; }
+
         [BackgroundDependencyLoader]
         private void load(TextureStore textureStore, Storyboard storyboard)
         {
-            for (int frameIndex = 0; frameIndex < Animation.FrameCount; frameIndex++)
+            int frameIndex = 0;
+
+            Texture frameTexture = storyboard.GetTextureFromPath(getFramePath(frameIndex), textureStore);
+
+            if (frameTexture != null)
             {
-                string framePath = Animation.Path.Replace(".", frameIndex + ".");
-                Drawable frame = storyboard.CreateSpriteFromResourcePath(framePath, textureStore) ?? Empty();
-                AddFrame(frame, Animation.FrameDelay);
+                // sourcing from storyboard.
+                for (frameIndex = 0; frameIndex < Animation.FrameCount; frameIndex++)
+                {
+                    frameTexture = storyboard.GetTextureFromPath(getFramePath(frameIndex), textureStore);
+                    AddFrame(new Sprite { Texture = frameTexture }, Animation.FrameDelay);
+                }
+            }
+            else if (storyboard.UseSkinSprites)
+            {
+                // fallback to skin if required.
+                skin.SourceChanged += skinSourceChanged;
+                skinSourceChanged();
             }
 
             Animation.ApplyTransforms(this);
         }
+
+        private void skinSourceChanged()
+        {
+            ClearFrames();
+
+            // ClearFrames doesn't clear the last displayed frame.
+            // Clear manually for now, in case the skin doesn't provide any frames.
+            DisplayFrame(Empty());
+
+            // When reading from a skin, we match stables weird behaviour where `FrameCount` is ignored
+            // and resources are retrieved until the end of the animation.
+            foreach (var texture in skin.GetTextures(Path.GetFileNameWithoutExtension(Animation.Path), default, default, true, string.Empty, out _))
+                AddFrame(new Sprite { Texture = texture }, Animation.FrameDelay);
+        }
+
+        private string getFramePath(int i) => Animation.Path.Replace(".", $"{i}.");
+
+        protected override void Dispose(bool isDisposing)
+        {
+            base.Dispose(isDisposing);
+            skin.SourceChanged -= skinSourceChanged;
+        }
     }
 }
diff --git a/osu.Game/Storyboards/Drawables/DrawableStoryboardSprite.cs b/osu.Game/Storyboards/Drawables/DrawableStoryboardSprite.cs
index db10f13896..6622cfb6be 100644
--- a/osu.Game/Storyboards/Drawables/DrawableStoryboardSprite.cs
+++ b/osu.Game/Storyboards/Drawables/DrawableStoryboardSprite.cs
@@ -4,14 +4,15 @@
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
-using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.Sprites;
 using osu.Framework.Graphics.Textures;
 using osu.Framework.Utils;
+using osu.Game.Skinning;
 using osuTK;
 
 namespace osu.Game.Storyboards.Drawables
 {
-    public class DrawableStoryboardSprite : CompositeDrawable, IFlippable, IVectorScalable
+    public class DrawableStoryboardSprite : Sprite, IFlippable, IVectorScalable
     {
         public StoryboardSprite Sprite { get; }
 
@@ -85,19 +86,31 @@ namespace osu.Game.Storyboards.Drawables
 
             LifetimeStart = sprite.StartTime;
             LifetimeEnd = sprite.EndTime;
-
-            AutoSizeAxes = Axes.Both;
         }
 
+        [Resolved]
+        private ISkinSource skin { get; set; }
+
         [BackgroundDependencyLoader]
         private void load(TextureStore textureStore, Storyboard storyboard)
         {
-            var drawable = storyboard.CreateSpriteFromResourcePath(Sprite.Path, textureStore);
+            Texture = storyboard.GetTextureFromPath(Sprite.Path, textureStore);
 
-            if (drawable != null)
-                InternalChild = drawable;
+            if (Texture == null && storyboard.UseSkinSprites)
+            {
+                skin.SourceChanged += skinSourceChanged;
+                skinSourceChanged();
+            }
 
             Sprite.ApplyTransforms(this);
         }
+
+        private void skinSourceChanged() => Texture = skin.GetTexture(Sprite.Path);
+
+        protected override void Dispose(bool isDisposing)
+        {
+            base.Dispose(isDisposing);
+            skin.SourceChanged -= skinSourceChanged;
+        }
     }
 }
diff --git a/osu.Game/Storyboards/Storyboard.cs b/osu.Game/Storyboards/Storyboard.cs
index b662b98e4e..1d21b5dce2 100644
--- a/osu.Game/Storyboards/Storyboard.cs
+++ b/osu.Game/Storyboards/Storyboard.cs
@@ -4,13 +4,10 @@
 using System;
 using System.Collections.Generic;
 using System.Linq;
-using osu.Framework.Graphics;
-using osu.Framework.Graphics.Sprites;
 using osu.Framework.Graphics.Textures;
 using osu.Game.Beatmaps;
 using osu.Game.Extensions;
 using osu.Game.Rulesets.Mods;
-using osu.Game.Skinning;
 using osu.Game.Storyboards.Drawables;
 
 namespace osu.Game.Storyboards
@@ -94,25 +91,14 @@ namespace osu.Game.Storyboards
         public DrawableStoryboard CreateDrawable(IReadOnlyList<Mod> mods = null) =>
             new DrawableStoryboard(this, mods);
 
-        public Drawable CreateSpriteFromResourcePath(string path, TextureStore textureStore)
+        public Texture GetTextureFromPath(string path, TextureStore textureStore)
         {
-            Drawable drawable = null;
-
             string storyboardPath = BeatmapInfo.BeatmapSet?.Files.FirstOrDefault(f => f.Filename.Equals(path, StringComparison.OrdinalIgnoreCase))?.File.GetStoragePath();
 
             if (!string.IsNullOrEmpty(storyboardPath))
-                drawable = new Sprite { Texture = textureStore.Get(storyboardPath) };
-            // if the texture isn't available locally in the beatmap, some storyboards choose to source from the underlying skin lookup hierarchy.
-            else if (UseSkinSprites)
-            {
-                drawable = new SkinnableSprite(path)
-                {
-                    RelativeSizeAxes = Axes.None,
-                    AutoSizeAxes = Axes.Both,
-                };
-            }
+                return textureStore.Get(storyboardPath);
 
-            return drawable;
+            return null;
         }
     }
 }

From 040afff670d37335aaa5b8f5aab4ec21af087517 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 7 Apr 2022 17:34:50 +0900
Subject: [PATCH 3964/5547] Change `DrawableStoryboardAnimation` to derive from
 `TextureAnimation`

---
 .../Drawables/DrawableStoryboardAnimation.cs  | 20 +++----------------
 1 file changed, 3 insertions(+), 17 deletions(-)

diff --git a/osu.Game/Storyboards/Drawables/DrawableStoryboardAnimation.cs b/osu.Game/Storyboards/Drawables/DrawableStoryboardAnimation.cs
index 28e65a7910..5ebca4d860 100644
--- a/osu.Game/Storyboards/Drawables/DrawableStoryboardAnimation.cs
+++ b/osu.Game/Storyboards/Drawables/DrawableStoryboardAnimation.cs
@@ -6,7 +6,6 @@ using System.IO;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Animations;
-using osu.Framework.Graphics.Sprites;
 using osu.Framework.Graphics.Textures;
 using osu.Framework.Utils;
 using osu.Game.Skinning;
@@ -14,7 +13,7 @@ using osuTK;
 
 namespace osu.Game.Storyboards.Drawables
 {
-    public class DrawableStoryboardAnimation : DrawableAnimation, IFlippable, IVectorScalable
+    public class DrawableStoryboardAnimation : TextureAnimation, IFlippable, IVectorScalable
     {
         public StoryboardAnimation Animation { get; }
 
@@ -91,14 +90,6 @@ namespace osu.Game.Storyboards.Drawables
             LifetimeEnd = animation.EndTime;
         }
 
-        protected override Vector2 GetCurrentDisplaySize()
-        {
-            Texture texture = (CurrentFrame as Sprite)?.Texture
-                              ?? ((CurrentFrame as SkinnableSprite)?.Drawable as Sprite)?.Texture;
-
-            return new Vector2(texture?.DisplayWidth ?? 0, texture?.DisplayHeight ?? 0);
-        }
-
         [Resolved]
         private ISkinSource skin { get; set; }
 
@@ -114,8 +105,7 @@ namespace osu.Game.Storyboards.Drawables
                 // sourcing from storyboard.
                 for (frameIndex = 0; frameIndex < Animation.FrameCount; frameIndex++)
                 {
-                    frameTexture = storyboard.GetTextureFromPath(getFramePath(frameIndex), textureStore);
-                    AddFrame(new Sprite { Texture = frameTexture }, Animation.FrameDelay);
+                    AddFrame(storyboard.GetTextureFromPath(getFramePath(frameIndex), textureStore), Animation.FrameDelay);
                 }
             }
             else if (storyboard.UseSkinSprites)
@@ -132,14 +122,10 @@ namespace osu.Game.Storyboards.Drawables
         {
             ClearFrames();
 
-            // ClearFrames doesn't clear the last displayed frame.
-            // Clear manually for now, in case the skin doesn't provide any frames.
-            DisplayFrame(Empty());
-
             // When reading from a skin, we match stables weird behaviour where `FrameCount` is ignored
             // and resources are retrieved until the end of the animation.
             foreach (var texture in skin.GetTextures(Path.GetFileNameWithoutExtension(Animation.Path), default, default, true, string.Empty, out _))
-                AddFrame(new Sprite { Texture = texture }, Animation.FrameDelay);
+                AddFrame(texture, Animation.FrameDelay);
         }
 
         private string getFramePath(int i) => Animation.Path.Replace(".", $"{i}.");

From 0674862b6c69ab7df325fa9d7506deee79b36aae Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 7 Apr 2022 17:51:10 +0900
Subject: [PATCH 3965/5547] Fix failing tests

---
 .../Gameplay/TestSceneDrawableStoryboardSprite.cs | 15 ++++++++-------
 1 file changed, 8 insertions(+), 7 deletions(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneDrawableStoryboardSprite.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneDrawableStoryboardSprite.cs
index 34e6d1996d..cfe9e35298 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneDrawableStoryboardSprite.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneDrawableStoryboardSprite.cs
@@ -7,6 +7,7 @@ using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.IEnumerableExtensions;
 using osu.Framework.Graphics;
+using osu.Framework.Graphics.Sprites;
 using osu.Framework.Testing;
 using osu.Framework.Utils;
 using osu.Game.Rulesets;
@@ -36,7 +37,8 @@ namespace osu.Game.Tests.Visual.Gameplay
 
             AddStep("create sprites", () => SetContents(_ => createSprite(lookup_name, Anchor.TopLeft, Vector2.Zero)));
 
-            assertSpritesFromSkin(false);
+            AddAssert("sprite didn't find texture", () =>
+                sprites.All(sprite => sprite.ChildrenOfType<Sprite>().All(s => s.Texture == null)));
         }
 
         [Test]
@@ -48,9 +50,12 @@ namespace osu.Game.Tests.Visual.Gameplay
 
             AddStep("create sprites", () => SetContents(_ => createSprite(lookup_name, Anchor.TopLeft, Vector2.Zero)));
 
-            assertSpritesFromSkin(true);
+            // Only checking for at least one sprite that succeeded, as not all skins in this test provide the hitcircleoverlay texture.
+            AddAssert("sprite found texture", () =>
+                sprites.Any(sprite => sprite.ChildrenOfType<Sprite>().All(s => s.Texture != null)));
 
-            AddAssert("skinnable sprite has correct size", () => sprites.Any(s => Precision.AlmostEquals(s.ChildrenOfType<SkinnableSprite>().Single().Size, new Vector2(128, 128))));
+            AddAssert("skinnable sprite has correct size", () =>
+                sprites.Any(sprite => sprite.ChildrenOfType<Sprite>().All(s => s.Size == new Vector2(128))));
         }
 
         [Test]
@@ -104,9 +109,5 @@ namespace osu.Game.Tests.Visual.Gameplay
                 s.LifetimeStart = double.MinValue;
                 s.LifetimeEnd = double.MaxValue;
             });
-
-        private void assertSpritesFromSkin(bool fromSkin) =>
-            AddAssert($"sprites are {(fromSkin ? "from skin" : "from storyboard")}",
-                () => sprites.All(sprite => sprite.ChildrenOfType<SkinnableSprite>().Any() == fromSkin));
     }
 }

From 37509e04a934ec1e51c080866316589d69a70003 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 7 Apr 2022 18:11:30 +0900
Subject: [PATCH 3966/5547] Rename variable and fix inspections

---
 osu.Game/Overlays/Toolbar/DigitalClockDisplay.cs | 14 +++++++-------
 osu.Game/Overlays/Toolbar/ToolbarClock.cs        |  2 +-
 2 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Overlays/Toolbar/DigitalClockDisplay.cs b/osu.Game/Overlays/Toolbar/DigitalClockDisplay.cs
index 66f40532d0..4392c5811a 100644
--- a/osu.Game/Overlays/Toolbar/DigitalClockDisplay.cs
+++ b/osu.Game/Overlays/Toolbar/DigitalClockDisplay.cs
@@ -29,17 +29,17 @@ namespace osu.Game.Overlays.Toolbar
             }
         }
 
-        private bool format12H = false;
+        private bool use24HourDisplay;
 
-        public bool Format12H
+        public bool Use24HourDisplay
         {
-            get => format12H;
+            get => use24HourDisplay;
             set
             {
-                if (format12H == value)
+                if (use24HourDisplay == value)
                     return;
 
-                format12H = value;
+                use24HourDisplay = value;
                 updateMetrics();
                 UpdateDisplay(DateTimeOffset.Now); //Update realTime.Text immediately instead of waiting until next second
             }
@@ -66,13 +66,13 @@ namespace osu.Game.Overlays.Toolbar
 
         protected override void UpdateDisplay(DateTimeOffset now)
         {
-            realTime.Text = format12H ? $"{now:h:mm:ss tt}" : $"{now:HH:mm:ss}";
+            realTime.Text = use24HourDisplay ? $"{now:h:mm:ss tt}" : $"{now:HH:mm:ss}";
             gameTime.Text = $"running {new TimeSpan(TimeSpan.TicksPerSecond * (int)(Clock.CurrentTime / 1000)):c}";
         }
 
         private void updateMetrics()
         {
-            if (format12H)
+            if (use24HourDisplay)
                 Width = 70;
             else
                 Width = showRuntime ? 66 : 45; // Allows for space for game time up to 99 days (in the padding area since this is quite rare).
diff --git a/osu.Game/Overlays/Toolbar/ToolbarClock.cs b/osu.Game/Overlays/Toolbar/ToolbarClock.cs
index b256d6fbc4..264e4bffde 100644
--- a/osu.Game/Overlays/Toolbar/ToolbarClock.cs
+++ b/osu.Game/Overlays/Toolbar/ToolbarClock.cs
@@ -99,7 +99,7 @@ namespace osu.Game.Overlays.Toolbar
             }, true);
 
             digitalPrefer24Hour.BindValueChanged(prefer24H =>
-                digital.Format12H = prefer24H.NewValue ? false : CultureInfo.CurrentCulture.DateTimeFormat.ShortTimePattern.Contains("tt"), true);
+                digital.Use24HourDisplay = !prefer24H.NewValue && CultureInfo.CurrentCulture.DateTimeFormat.ShortTimePattern.Contains("tt"), true);
         }
 
         protected override bool OnClick(ClickEvent e)

From 7530fe5adf4ea66d7f5cc02034aefef8eed0c969 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 7 Apr 2022 18:13:23 +0900
Subject: [PATCH 3967/5547] Move default specification to configuration initial
 value

---
 osu.Game/Configuration/OsuConfigManager.cs | 4 +++-
 osu.Game/Overlays/Toolbar/ToolbarClock.cs  | 8 +++-----
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Configuration/OsuConfigManager.cs b/osu.Game/Configuration/OsuConfigManager.cs
index 99372c92d9..9aacb50684 100644
--- a/osu.Game/Configuration/OsuConfigManager.cs
+++ b/osu.Game/Configuration/OsuConfigManager.cs
@@ -3,6 +3,7 @@
 
 using System;
 using System.Diagnostics;
+using System.Globalization;
 using osu.Framework.Configuration;
 using osu.Framework.Configuration.Tracking;
 using osu.Framework.Extensions;
@@ -102,7 +103,8 @@ namespace osu.Game.Configuration
 
             SetDefault(OsuSetting.MenuParallax, true);
 
-            SetDefault(OsuSetting.Prefer24HourTime, false);
+            // See https://stackoverflow.com/a/63307411 for default sourcing.
+            SetDefault(OsuSetting.Prefer24HourTime, CultureInfo.CurrentCulture.DateTimeFormat.ShortTimePattern.Contains(@"tt"));
 
             // Gameplay
             SetDefault(OsuSetting.PositionalHitsounds, true); // replaced by level setting below, can be removed 20220703.
diff --git a/osu.Game/Overlays/Toolbar/ToolbarClock.cs b/osu.Game/Overlays/Toolbar/ToolbarClock.cs
index 264e4bffde..d726a95f46 100644
--- a/osu.Game/Overlays/Toolbar/ToolbarClock.cs
+++ b/osu.Game/Overlays/Toolbar/ToolbarClock.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.Globalization;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Extensions.Color4Extensions;
@@ -21,7 +20,7 @@ namespace osu.Game.Overlays.Toolbar
     public class ToolbarClock : OsuClickableContainer
     {
         private Bindable<ToolbarClockDisplayMode> clockDisplayMode;
-        private Bindable<bool> digitalPrefer24Hour;
+        private Bindable<bool> prefer24HourTime;
 
         private Box hoverBackground;
         private Box flashBackground;
@@ -40,7 +39,7 @@ namespace osu.Game.Overlays.Toolbar
         private void load(OsuConfigManager config)
         {
             clockDisplayMode = config.GetBindable<ToolbarClockDisplayMode>(OsuSetting.ToolbarClockDisplayMode);
-            digitalPrefer24Hour = config.GetBindable<bool>(OsuSetting.Prefer24HourTime);
+            prefer24HourTime = config.GetBindable<bool>(OsuSetting.Prefer24HourTime);
 
             Children = new Drawable[]
             {
@@ -98,8 +97,7 @@ namespace osu.Game.Overlays.Toolbar
                 analog.FadeTo(showAnalog ? 1 : 0);
             }, true);
 
-            digitalPrefer24Hour.BindValueChanged(prefer24H =>
-                digital.Use24HourDisplay = !prefer24H.NewValue && CultureInfo.CurrentCulture.DateTimeFormat.ShortTimePattern.Contains("tt"), true);
+            prefer24HourTime.BindValueChanged(prefer24H => digital.Use24HourDisplay = !prefer24H.NewValue, true);
         }
 
         protected override bool OnClick(ClickEvent e)

From 555aee7b6a98056587d1077a71faff2c44f0b0a5 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 7 Apr 2022 18:16:14 +0900
Subject: [PATCH 3968/5547] Remove incorrect and pointless complexity to width
 changes

---
 osu.Game/Overlays/Toolbar/DigitalClockDisplay.cs | 5 +----
 1 file changed, 1 insertion(+), 4 deletions(-)

diff --git a/osu.Game/Overlays/Toolbar/DigitalClockDisplay.cs b/osu.Game/Overlays/Toolbar/DigitalClockDisplay.cs
index 4392c5811a..68b36c2a04 100644
--- a/osu.Game/Overlays/Toolbar/DigitalClockDisplay.cs
+++ b/osu.Game/Overlays/Toolbar/DigitalClockDisplay.cs
@@ -72,10 +72,7 @@ namespace osu.Game.Overlays.Toolbar
 
         private void updateMetrics()
         {
-            if (use24HourDisplay)
-                Width = 70;
-            else
-                Width = showRuntime ? 66 : 45; // Allows for space for game time up to 99 days (in the padding area since this is quite rare).
+            Width = showRuntime || use24HourDisplay ? 66 : 45; // Allows for space for game time up to 99 days (in the padding area since this is quite rare).
 
             gameTime.FadeTo(showRuntime ? 1 : 0);
         }

From b2c0eaeab4abf7f05cdec587acda9b1c19a29bbc Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 7 Apr 2022 18:20:15 +0900
Subject: [PATCH 3969/5547] Make string read better

---
 osu.Game/Localisation/GeneralSettingsStrings.cs               | 4 ++--
 .../Overlays/Settings/Sections/General/LanguageSettings.cs    | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Localisation/GeneralSettingsStrings.cs b/osu.Game/Localisation/GeneralSettingsStrings.cs
index cca8c8efd1..c65e6c77f4 100644
--- a/osu.Game/Localisation/GeneralSettingsStrings.cs
+++ b/osu.Game/Localisation/GeneralSettingsStrings.cs
@@ -30,9 +30,9 @@ namespace osu.Game.Localisation
         public static LocalisableString PreferOriginalMetadataLanguage => new TranslatableString(getKey(@"prefer_original"), @"Prefer metadata in original language");
 
         /// <summary>
-        /// "Prefer 24-hour time"
+        /// "Prefer 24-hour time display"
         /// </summary>
-        public static LocalisableString Prefer24HourTime => new TranslatableString(getKey(@"prefer_24_hour_time"), @"Prefer 24-hour time");
+        public static LocalisableString Prefer24HourTimeDisplay => new TranslatableString(getKey(@"prefer_24_hour_time_display"), @"Prefer 24-hour time display");
 
         /// <summary>
         /// "Updates"
diff --git a/osu.Game/Overlays/Settings/Sections/General/LanguageSettings.cs b/osu.Game/Overlays/Settings/Sections/General/LanguageSettings.cs
index e7cc1bce10..cdce187a35 100644
--- a/osu.Game/Overlays/Settings/Sections/General/LanguageSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/General/LanguageSettings.cs
@@ -37,7 +37,7 @@ namespace osu.Game.Overlays.Settings.Sections.General
                 },
                 new SettingsCheckbox
                 {
-                    LabelText = GeneralSettingsStrings.Prefer24HourTime,
+                    LabelText = GeneralSettingsStrings.Prefer24HourTimeDisplay,
                     Current = config.GetBindable<bool>(OsuSetting.Prefer24HourTime)
                 },
             };

From a4d3afd06d63059ca2b2cff0b4fb2577dd74818e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 7 Apr 2022 19:12:10 +0900
Subject: [PATCH 3970/5547] Fix multiple issues with bindable safety in
 `SkinEditor` components

---
 .../Skinning/Editor/SkinBlueprintContainer.cs | 23 ++++++++++++-------
 osu.Game/Skinning/Editor/SkinEditor.cs        |  3 +++
 2 files changed, 18 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Skinning/Editor/SkinBlueprintContainer.cs b/osu.Game/Skinning/Editor/SkinBlueprintContainer.cs
index d67bfb89ab..ebf3c9c319 100644
--- a/osu.Game/Skinning/Editor/SkinBlueprintContainer.cs
+++ b/osu.Game/Skinning/Editor/SkinBlueprintContainer.cs
@@ -21,21 +21,20 @@ namespace osu.Game.Skinning.Editor
 
         private readonly List<BindableList<ISkinnableDrawable>> targetComponents = new List<BindableList<ISkinnableDrawable>>();
 
+        [Resolved]
+        private SkinEditor editor { get; set; }
+
         public SkinBlueprintContainer(Drawable target)
         {
             this.target = target;
         }
 
-        [BackgroundDependencyLoader(true)]
-        private void load(SkinEditor editor)
-        {
-            SelectedItems.BindTo(editor.SelectedComponents);
-        }
-
         protected override void LoadComplete()
         {
             base.LoadComplete();
 
+            SelectedItems.BindTo(editor.SelectedComponents);
+
             // track each target container on the current screen.
             var targetContainers = target.ChildrenOfType<ISkinnableTarget>().ToArray();
 
@@ -56,7 +55,7 @@ namespace osu.Game.Skinning.Editor
             }
         }
 
-        private void componentsChanged(object sender, NotifyCollectionChangedEventArgs e)
+        private void componentsChanged(object sender, NotifyCollectionChangedEventArgs e) => Schedule(() =>
         {
             switch (e.Action)
             {
@@ -79,7 +78,7 @@ namespace osu.Game.Skinning.Editor
                         AddBlueprintFor(item);
                     break;
             }
-        }
+        });
 
         protected override void AddBlueprintFor(ISkinnableDrawable item)
         {
@@ -93,5 +92,13 @@ namespace osu.Game.Skinning.Editor
 
         protected override SelectionBlueprint<ISkinnableDrawable> CreateBlueprintFor(ISkinnableDrawable component)
             => new SkinBlueprint(component);
+
+        protected override void Dispose(bool isDisposing)
+        {
+            base.Dispose(isDisposing);
+
+            foreach (var list in targetComponents)
+                list.UnbindAll();
+        }
     }
 }
diff --git a/osu.Game/Skinning/Editor/SkinEditor.cs b/osu.Game/Skinning/Editor/SkinEditor.cs
index bcff70c008..4602366413 100644
--- a/osu.Game/Skinning/Editor/SkinEditor.cs
+++ b/osu.Game/Skinning/Editor/SkinEditor.cs
@@ -203,6 +203,9 @@ namespace osu.Game.Skinning.Editor
 
             SelectedComponents.Clear();
 
+            // Immediately clear the previous blueprint container to ensure it doesn't try to interact with the old target.
+            content.Clear();
+
             Scheduler.AddOnce(loadBlueprintContainer);
             Scheduler.AddOnce(populateSettings);
 

From 5b29ddd2ed91fae0d1fbe840d4575bce6d18be7d Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 7 Apr 2022 15:05:08 +0300
Subject: [PATCH 3971/5547] Add further test coverage against paths with
 extensions

---
 .../Skinning/LegacySkinTextureFallbackTest.cs      | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/osu.Game.Tests/NonVisual/Skinning/LegacySkinTextureFallbackTest.cs b/osu.Game.Tests/NonVisual/Skinning/LegacySkinTextureFallbackTest.cs
index db7fc0b4a0..76c49edf78 100644
--- a/osu.Game.Tests/NonVisual/Skinning/LegacySkinTextureFallbackTest.cs
+++ b/osu.Game.Tests/NonVisual/Skinning/LegacySkinTextureFallbackTest.cs
@@ -83,6 +83,20 @@ namespace osu.Game.Tests.NonVisual.Skinning
                 "followpoint.png",
                 "followpoint@2x.png", 2
             },
+            new object[]
+            {
+                // Looking up a path with extension specified should work.
+                new[] { "Gameplay/osu/followpoint.png" },
+                "Gameplay/osu/followpoint.png",
+                "Gameplay/osu/followpoint.png", 1
+            },
+            new object[]
+            {
+                // Looking up a path with extension specified should also work with @2x sprites.
+                new[] { "Gameplay/osu/followpoint@2x.png" },
+                "Gameplay/osu/followpoint.png",
+                "Gameplay/osu/followpoint@2x.png", 2
+            },
         };
 
         [TestCaseSource(nameof(fallbackTestCases))]

From fb9fe4213df4b89ddfec65c71765322aeb38742e Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 7 Apr 2022 15:07:14 +0300
Subject: [PATCH 3972/5547] Fix skin texture lookups not handling paths with
 extensions

---
 osu.Game/Skinning/LegacySkin.cs | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/osu.Game/Skinning/LegacySkin.cs b/osu.Game/Skinning/LegacySkin.cs
index a97b5d44ce..f7d5581621 100644
--- a/osu.Game/Skinning/LegacySkin.cs
+++ b/osu.Game/Skinning/LegacySkin.cs
@@ -443,9 +443,7 @@ namespace osu.Game.Skinning
                 string lookupName = name.Replace(@"@2x", string.Empty);
 
                 float ratio = 2;
-                string twoTimesFilename = Path.HasExtension(lookupName)
-                    ? @$"{Path.GetFileNameWithoutExtension(lookupName)}@2x{Path.GetExtension(lookupName)}"
-                    : @$"{lookupName}@2x";
+                string twoTimesFilename = $"{Path.ChangeExtension(lookupName, null)}@2x{Path.GetExtension(lookupName)}";
 
                 var texture = Textures?.Get(twoTimesFilename, wrapModeS, wrapModeT);
 

From c323020fcf362ee4f570fc0f495127a555cd3d5e Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 7 Apr 2022 15:56:12 +0300
Subject: [PATCH 3973/5547] Fix `Use24HourDisplay` conditional flipped

---
 osu.Game/Overlays/Toolbar/DigitalClockDisplay.cs | 3 ++-
 osu.Game/Overlays/Toolbar/ToolbarClock.cs        | 2 +-
 2 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Overlays/Toolbar/DigitalClockDisplay.cs b/osu.Game/Overlays/Toolbar/DigitalClockDisplay.cs
index 68b36c2a04..10de35ee50 100644
--- a/osu.Game/Overlays/Toolbar/DigitalClockDisplay.cs
+++ b/osu.Game/Overlays/Toolbar/DigitalClockDisplay.cs
@@ -40,6 +40,7 @@ namespace osu.Game.Overlays.Toolbar
                     return;
 
                 use24HourDisplay = value;
+
                 updateMetrics();
                 UpdateDisplay(DateTimeOffset.Now); //Update realTime.Text immediately instead of waiting until next second
             }
@@ -66,7 +67,7 @@ namespace osu.Game.Overlays.Toolbar
 
         protected override void UpdateDisplay(DateTimeOffset now)
         {
-            realTime.Text = use24HourDisplay ? $"{now:h:mm:ss tt}" : $"{now:HH:mm:ss}";
+            realTime.Text = use24HourDisplay ? $"{now:HH:mm:ss}" : $"{now:h:mm:ss tt}";
             gameTime.Text = $"running {new TimeSpan(TimeSpan.TicksPerSecond * (int)(Clock.CurrentTime / 1000)):c}";
         }
 
diff --git a/osu.Game/Overlays/Toolbar/ToolbarClock.cs b/osu.Game/Overlays/Toolbar/ToolbarClock.cs
index d726a95f46..308359570f 100644
--- a/osu.Game/Overlays/Toolbar/ToolbarClock.cs
+++ b/osu.Game/Overlays/Toolbar/ToolbarClock.cs
@@ -97,7 +97,7 @@ namespace osu.Game.Overlays.Toolbar
                 analog.FadeTo(showAnalog ? 1 : 0);
             }, true);
 
-            prefer24HourTime.BindValueChanged(prefer24H => digital.Use24HourDisplay = !prefer24H.NewValue, true);
+            prefer24HourTime.BindValueChanged(prefer24H => digital.Use24HourDisplay = prefer24H.NewValue, true);
         }
 
         protected override bool OnClick(ClickEvent e)

From 0e9248624076d27261c872a3a763ad6051251dfc Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 7 Apr 2022 22:05:04 +0900
Subject: [PATCH 3974/5547] Update various licence years to 2022

---
 Directory.Build.props               | 2 +-
 LICENCE                             | 2 +-
 Templates/osu.Game.Templates.csproj | 2 +-
 osu.Desktop/osu.nuspec              | 2 +-
 4 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/Directory.Build.props b/Directory.Build.props
index 3ab3dc3d13..709545bf1d 100644
--- a/Directory.Build.props
+++ b/Directory.Build.props
@@ -34,7 +34,7 @@
     <RepositoryUrl>https://github.com/ppy/osu</RepositoryUrl>
     <PackageReleaseNotes>Automated release.</PackageReleaseNotes>
     <Company>ppy Pty Ltd</Company>
-    <Copyright>Copyright (c) 2021 ppy Pty Ltd</Copyright>
+    <Copyright>Copyright (c) 2022 ppy Pty Ltd</Copyright>
     <PackageTags>osu game</PackageTags>
   </PropertyGroup>
 </Project>
diff --git a/LICENCE b/LICENCE
index b5962ad3b2..d3e7537cef 100644
--- a/LICENCE
+++ b/LICENCE
@@ -1,4 +1,4 @@
-Copyright (c) 2021 ppy Pty Ltd <contact@ppy.sh>.
+Copyright (c) 2022 ppy Pty Ltd <contact@ppy.sh>.
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
diff --git a/Templates/osu.Game.Templates.csproj b/Templates/osu.Game.Templates.csproj
index 4624d3d771..b8c3ad373a 100644
--- a/Templates/osu.Game.Templates.csproj
+++ b/Templates/osu.Game.Templates.csproj
@@ -8,7 +8,7 @@
     <PackageProjectUrl>https://github.com/ppy/osu/blob/master/Templates</PackageProjectUrl>
     <RepositoryUrl>https://github.com/ppy/osu</RepositoryUrl>
     <PackageReleaseNotes>Automated release.</PackageReleaseNotes>
-    <copyright>Copyright (c) 2021 ppy Pty Ltd</copyright>
+    <copyright>Copyright (c) 2022 ppy Pty Ltd</copyright>
     <Description>Templates to use when creating a ruleset for consumption in osu!.</Description>
     <PackageTags>dotnet-new;templates;osu</PackageTags>
     <TargetFramework>netstandard2.1</TargetFramework>
diff --git a/osu.Desktop/osu.nuspec b/osu.Desktop/osu.nuspec
index 1757fd7c73..dc1ec17e2c 100644
--- a/osu.Desktop/osu.nuspec
+++ b/osu.Desktop/osu.nuspec
@@ -11,7 +11,7 @@
         <requireLicenseAcceptance>false</requireLicenseAcceptance>
         <description>A free-to-win rhythm game. Rhythm is just a *click* away!</description>
         <releaseNotes>testing</releaseNotes>
-        <copyright>Copyright (c) 2021 ppy Pty Ltd</copyright>
+        <copyright>Copyright (c) 2022 ppy Pty Ltd</copyright>
         <language>en-AU</language>
     </metadata>
     <files>

From 11b4c5ca875b8a4f2a61ba8184f5f1b2865809be Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 7 Apr 2022 23:42:42 +0900
Subject: [PATCH 3975/5547] Fix potential null ref if `UpdateTargetScreen` is
 called too early

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

diff --git a/osu.Game/Skinning/Editor/SkinEditor.cs b/osu.Game/Skinning/Editor/SkinEditor.cs
index 4602366413..e36d5ca3c6 100644
--- a/osu.Game/Skinning/Editor/SkinEditor.cs
+++ b/osu.Game/Skinning/Editor/SkinEditor.cs
@@ -204,7 +204,7 @@ namespace osu.Game.Skinning.Editor
             SelectedComponents.Clear();
 
             // Immediately clear the previous blueprint container to ensure it doesn't try to interact with the old target.
-            content.Clear();
+            content?.Clear();
 
             Scheduler.AddOnce(loadBlueprintContainer);
             Scheduler.AddOnce(populateSettings);

From a616f5bc2a4eb90824ed0d7ae62fcd4a972c7720 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 7 Apr 2022 19:24:15 +0300
Subject: [PATCH 3976/5547] Fix regressed digital clock width conditional

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

diff --git a/osu.Game/Overlays/Toolbar/DigitalClockDisplay.cs b/osu.Game/Overlays/Toolbar/DigitalClockDisplay.cs
index 10de35ee50..ac6f563336 100644
--- a/osu.Game/Overlays/Toolbar/DigitalClockDisplay.cs
+++ b/osu.Game/Overlays/Toolbar/DigitalClockDisplay.cs
@@ -73,7 +73,7 @@ namespace osu.Game.Overlays.Toolbar
 
         private void updateMetrics()
         {
-            Width = showRuntime || use24HourDisplay ? 66 : 45; // Allows for space for game time up to 99 days (in the padding area since this is quite rare).
+            Width = showRuntime || !use24HourDisplay ? 66 : 45; // Allows for space for game time up to 99 days (in the padding area since this is quite rare).
 
             gameTime.FadeTo(showRuntime ? 1 : 0);
         }

From 04db80848bade5ee16f46621339cf4c5622bbd99 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 7 Apr 2022 21:24:50 +0200
Subject: [PATCH 3977/5547] Remove unused using directives

---
 .../Visual/Gameplay/TestSceneDrawableStoryboardSprite.cs        | 2 --
 1 file changed, 2 deletions(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneDrawableStoryboardSprite.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneDrawableStoryboardSprite.cs
index cfe9e35298..b2f4fa2738 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneDrawableStoryboardSprite.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneDrawableStoryboardSprite.cs
@@ -9,10 +9,8 @@ using osu.Framework.Extensions.IEnumerableExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Testing;
-using osu.Framework.Utils;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Osu;
-using osu.Game.Skinning;
 using osu.Game.Storyboards;
 using osu.Game.Storyboards.Drawables;
 using osuTK;

From 71c0216c559449c8286a816d0d592ebaad41fdfa Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 7 Apr 2022 21:37:42 +0200
Subject: [PATCH 3978/5547] Add null check guards to unsubscriptions in
 `Dispose()`

---
 osu.Game/Storyboards/Drawables/DrawableStoryboardAnimation.cs | 4 +++-
 osu.Game/Storyboards/Drawables/DrawableStoryboardSprite.cs    | 4 +++-
 2 files changed, 6 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Storyboards/Drawables/DrawableStoryboardAnimation.cs b/osu.Game/Storyboards/Drawables/DrawableStoryboardAnimation.cs
index 5ebca4d860..8a14b8b183 100644
--- a/osu.Game/Storyboards/Drawables/DrawableStoryboardAnimation.cs
+++ b/osu.Game/Storyboards/Drawables/DrawableStoryboardAnimation.cs
@@ -133,7 +133,9 @@ namespace osu.Game.Storyboards.Drawables
         protected override void Dispose(bool isDisposing)
         {
             base.Dispose(isDisposing);
-            skin.SourceChanged -= skinSourceChanged;
+
+            if (skin != null)
+                skin.SourceChanged -= skinSourceChanged;
         }
     }
 }
diff --git a/osu.Game/Storyboards/Drawables/DrawableStoryboardSprite.cs b/osu.Game/Storyboards/Drawables/DrawableStoryboardSprite.cs
index 6622cfb6be..a6f2b8fcbd 100644
--- a/osu.Game/Storyboards/Drawables/DrawableStoryboardSprite.cs
+++ b/osu.Game/Storyboards/Drawables/DrawableStoryboardSprite.cs
@@ -110,7 +110,9 @@ namespace osu.Game.Storyboards.Drawables
         protected override void Dispose(bool isDisposing)
         {
             base.Dispose(isDisposing);
-            skin.SourceChanged -= skinSourceChanged;
+
+            if (skin != null)
+                skin.SourceChanged -= skinSourceChanged;
         }
     }
 }

From 112096768b2107645ec0cafcad8bd9a8893c18ac Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 7 Apr 2022 22:38:00 +0200
Subject: [PATCH 3979/5547] Add test checking incompatibility of multi mods

---
 .../Mods/MultiModIncompatibilityTest.cs       | 65 +++++++++++++++++++
 1 file changed, 65 insertions(+)
 create mode 100644 osu.Game.Tests/Mods/MultiModIncompatibilityTest.cs

diff --git a/osu.Game.Tests/Mods/MultiModIncompatibilityTest.cs b/osu.Game.Tests/Mods/MultiModIncompatibilityTest.cs
new file mode 100644
index 0000000000..312b939315
--- /dev/null
+++ b/osu.Game.Tests/Mods/MultiModIncompatibilityTest.cs
@@ -0,0 +1,65 @@
+// 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.Game.Rulesets;
+using osu.Game.Rulesets.Catch;
+using osu.Game.Rulesets.Mania;
+using osu.Game.Rulesets.Mods;
+using osu.Game.Rulesets.Osu;
+using osu.Game.Rulesets.Taiko;
+using osu.Game.Utils;
+
+namespace osu.Game.Tests.Mods
+{
+    [TestFixture]
+    public class MultiModIncompatibilityTest
+    {
+        /// <summary>
+        /// Ensures that all mods grouped into <see cref="MultiMod"/>s, as declared by the default rulesets, are pairwise incompatible with each other.
+        /// </summary>
+        [TestCase(typeof(OsuRuleset))]
+        [TestCase(typeof(TaikoRuleset))]
+        [TestCase(typeof(CatchRuleset))]
+        [TestCase(typeof(ManiaRuleset))]
+        public void TestAllMultiModsFromRulesetAreIncompatible(Type rulesetType)
+        {
+            var ruleset = (Ruleset)Activator.CreateInstance(rulesetType);
+            Assert.That(ruleset, Is.Not.Null);
+
+            var allMultiMods = getMultiMods(ruleset);
+
+            Assert.Multiple(() =>
+            {
+                foreach (var multiMod in allMultiMods)
+                {
+                    int modCount = multiMod.Mods.Length;
+
+                    for (int i = 0; i < modCount; ++i)
+                    {
+                        // indexing from i + 1 ensures that only pairs of different mods are checked, and are checked only once
+                        // (indexing from 0 would check each pair twice, and also check each mod against itself).
+                        for (int j = i + 1; j < modCount; ++j)
+                        {
+                            var firstMod = multiMod.Mods[i];
+                            var secondMod = multiMod.Mods[j];
+
+                            Assert.That(
+                                ModUtils.CheckCompatibleSet(new[] { firstMod, secondMod }), Is.False,
+                                $"{firstMod.Name} ({firstMod.Acronym}) and {secondMod.Name} ({secondMod.Acronym}) should be incompatible.");
+                        }
+                    }
+                }
+            });
+        }
+
+        /// <remarks>
+        /// This local helper is used rather than <see cref="Ruleset.CreateAllMods"/>, because the aforementioned method flattens multi mods.
+        /// </remarks>>
+        private static IEnumerable<MultiMod> getMultiMods(Ruleset ruleset)
+            => Enum.GetValues(typeof(ModType)).Cast<ModType>().SelectMany(ruleset.GetModsFor).OfType<MultiMod>();
+    }
+}

From 6630b38c08d02c7f975ccd7b9d7f4031fbd08eb7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 3 Apr 2022 19:08:54 +0200
Subject: [PATCH 3980/5547] Make all `ModRateAdjust` implementations
 incompatible with each other

---
 osu.Game/Rulesets/Mods/ModDoubleTime.cs | 4 ----
 osu.Game/Rulesets/Mods/ModHalfTime.cs   | 4 ----
 osu.Game/Rulesets/Mods/ModRateAdjust.cs | 2 +-
 3 files changed, 1 insertion(+), 9 deletions(-)

diff --git a/osu.Game/Rulesets/Mods/ModDoubleTime.cs b/osu.Game/Rulesets/Mods/ModDoubleTime.cs
index d4c4dce0f5..1c71f5d055 100644
--- a/osu.Game/Rulesets/Mods/ModDoubleTime.cs
+++ b/osu.Game/Rulesets/Mods/ModDoubleTime.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.Bindables;
 using osu.Framework.Graphics.Sprites;
 using osu.Game.Configuration;
@@ -18,8 +16,6 @@ namespace osu.Game.Rulesets.Mods
         public override ModType Type => ModType.DifficultyIncrease;
         public override string Description => "Zoooooooooom...";
 
-        public override Type[] IncompatibleMods => base.IncompatibleMods.Append(typeof(ModHalfTime)).ToArray();
-
         [SettingSource("Speed increase", "The actual increase to apply")]
         public override BindableNumber<double> SpeedChange { get; } = new BindableDouble
         {
diff --git a/osu.Game/Rulesets/Mods/ModHalfTime.cs b/osu.Game/Rulesets/Mods/ModHalfTime.cs
index c240cdbe6e..13d89e30d6 100644
--- a/osu.Game/Rulesets/Mods/ModHalfTime.cs
+++ b/osu.Game/Rulesets/Mods/ModHalfTime.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.Bindables;
 using osu.Framework.Graphics.Sprites;
 using osu.Game.Configuration;
@@ -18,8 +16,6 @@ namespace osu.Game.Rulesets.Mods
         public override ModType Type => ModType.DifficultyReduction;
         public override string Description => "Less zoom...";
 
-        public override Type[] IncompatibleMods => base.IncompatibleMods.Append(typeof(ModDoubleTime)).ToArray();
-
         [SettingSource("Speed decrease", "The actual decrease to apply")]
         public override BindableNumber<double> SpeedChange { get; } = new BindableDouble
         {
diff --git a/osu.Game/Rulesets/Mods/ModRateAdjust.cs b/osu.Game/Rulesets/Mods/ModRateAdjust.cs
index ebe18f2188..88fb609c07 100644
--- a/osu.Game/Rulesets/Mods/ModRateAdjust.cs
+++ b/osu.Game/Rulesets/Mods/ModRateAdjust.cs
@@ -25,7 +25,7 @@ namespace osu.Game.Rulesets.Mods
 
         public double ApplyToRate(double time, double rate) => rate * SpeedChange.Value;
 
-        public override Type[] IncompatibleMods => new[] { typeof(ModTimeRamp), typeof(ModAdaptiveSpeed) };
+        public override Type[] IncompatibleMods => new[] { typeof(ModTimeRamp), typeof(ModAdaptiveSpeed), typeof(ModRateAdjust) };
 
         public override string SettingDescription => SpeedChange.IsDefault ? string.Empty : $"{SpeedChange.Value:N2}x";
     }

From 5e02ba353bd234008cf42dc422fe9bc1c42ae0be Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 3 Apr 2022 19:12:24 +0200
Subject: [PATCH 3981/5547] Make `OsuMod{Blinds,Flashlight}` incompatible

---
 osu.Game.Rulesets.Osu/Mods/OsuModBlinds.cs     | 2 ++
 osu.Game.Rulesets.Osu/Mods/OsuModFlashlight.cs | 2 ++
 2 files changed, 4 insertions(+)

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModBlinds.cs b/osu.Game.Rulesets.Osu/Mods/OsuModBlinds.cs
index ad4c5dfd5d..7567c96b50 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModBlinds.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModBlinds.cs
@@ -29,6 +29,8 @@ namespace osu.Game.Rulesets.Osu.Mods
         public override ModType Type => ModType.DifficultyIncrease;
 
         public override double ScoreMultiplier => 1.12;
+        public override Type[] IncompatibleMods => new[] { typeof(OsuModFlashlight) };
+
         private DrawableOsuBlinds blinds;
 
         public void ApplyToDrawableRuleset(DrawableRuleset<OsuHitObject> drawableRuleset)
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModFlashlight.cs b/osu.Game.Rulesets.Osu/Mods/OsuModFlashlight.cs
index 38c84be295..44d72fae61 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModFlashlight.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModFlashlight.cs
@@ -2,6 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
+using System.Linq;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Input;
@@ -19,6 +20,7 @@ namespace osu.Game.Rulesets.Osu.Mods
     public class OsuModFlashlight : ModFlashlight<OsuHitObject>, IApplicableToDrawableHitObject
     {
         public override double ScoreMultiplier => 1.12;
+        public override Type[] IncompatibleMods => base.IncompatibleMods.Append(typeof(OsuModBlinds)).ToArray();
 
         private const double default_follow_delay = 120;
 

From e99d0f9faeb115d551ecd6fe26f27141666646ac Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 3 Apr 2022 19:14:45 +0200
Subject: [PATCH 3982/5547] Make all `OsuModObjectScaleTween` implementations
 incompatible with each other

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

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModObjectScaleTween.cs b/osu.Game.Rulesets.Osu/Mods/OsuModObjectScaleTween.cs
index 778447e444..70c075276f 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModObjectScaleTween.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModObjectScaleTween.cs
@@ -24,7 +24,7 @@ namespace osu.Game.Rulesets.Osu.Mods
 
         protected virtual float EndScale => 1;
 
-        public override Type[] IncompatibleMods => new[] { typeof(IRequiresApproachCircles), typeof(OsuModSpinIn) };
+        public override Type[] IncompatibleMods => new[] { typeof(IRequiresApproachCircles), typeof(OsuModSpinIn), typeof(OsuModObjectScaleTween) };
 
         protected override void ApplyIncreasedVisibilityState(DrawableHitObject hitObject, ArmedState state)
         {

From 282b220d9436105b441588d64b3a7b515a1550c1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 8 Apr 2022 00:16:25 +0200
Subject: [PATCH 3983/5547] Fix test failure due to checking incompaatibility
 of flattened multi mods

---
 osu.Game/Utils/ModUtils.cs | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Utils/ModUtils.cs b/osu.Game/Utils/ModUtils.cs
index ff8e04cc58..8df44216b6 100644
--- a/osu.Game/Utils/ModUtils.cs
+++ b/osu.Game/Utils/ModUtils.cs
@@ -115,7 +115,9 @@ namespace osu.Game.Utils
         {
             mods = mods.ToArray();
 
-            CheckCompatibleSet(mods, out invalidMods);
+            // exclude multi mods from compatibility checks.
+            // the loop below automatically marks all multi mods as not valid for gameplay anyway.
+            CheckCompatibleSet(mods.Where(m => !(m is MultiMod)), out invalidMods);
 
             foreach (var mod in mods)
             {

From 9ba99ed57d0abc9e67ee9bbab633077a7103976c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 8 Apr 2022 14:42:54 +0900
Subject: [PATCH 3984/5547] Ensure all access to `MultiplayerClient.Room` is on
 the update thread

This was an implicit requirement until now, but not well documented
everywhere. Adding this makes it much easier to understand the
requirement (and probably safer).
---
 .../Online/Multiplayer/MultiplayerClient.cs     | 17 ++++++++++++++++-
 1 file changed, 16 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Online/Multiplayer/MultiplayerClient.cs b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
index d6099e5f72..2084ba048d 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
@@ -11,6 +11,7 @@ using System.Threading;
 using System.Threading.Tasks;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
+using osu.Framework.Development;
 using osu.Framework.Graphics;
 using osu.Framework.Logging;
 using osu.Game.Database;
@@ -87,7 +88,21 @@ namespace osu.Game.Online.Multiplayer
         /// <summary>
         /// The joined <see cref="MultiplayerRoom"/>.
         /// </summary>
-        public MultiplayerRoom? Room { get; private set; }
+        public MultiplayerRoom? Room
+        {
+            get
+            {
+                Debug.Assert(ThreadSafety.IsUpdateThread);
+                return room;
+            }
+            private set
+            {
+                Debug.Assert(ThreadSafety.IsUpdateThread);
+                room = value;
+            }
+        }
+
+        private MultiplayerRoom? room;
 
         /// <summary>
         /// The users in the joined <see cref="Room"/> which are participating in the current gameplay loop.

From d50f41225ffe644d1abb31681637c0cebeeacc38 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 8 Apr 2022 14:43:53 +0900
Subject: [PATCH 3985/5547] Rename `scheduleAsync` to `runOnUpdateThreadAsync`

---
 osu.Game/Online/Multiplayer/MultiplayerClient.cs | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Online/Multiplayer/MultiplayerClient.cs b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
index 2084ba048d..5cbf65478c 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
@@ -181,7 +181,7 @@ namespace osu.Game.Online.Multiplayer
                 await Task.WhenAll(joinedRoom.Users.Select(PopulateUser)).ConfigureAwait(false);
 
                 // Update the stored room (must be done on update thread for thread-safety).
-                await scheduleAsync(() =>
+                await runOnUpdateThreadAsync(() =>
                 {
                     Room = joinedRoom;
                     APIRoom = room;
@@ -228,7 +228,7 @@ namespace osu.Game.Online.Multiplayer
             // Leaving rooms is expected to occur instantaneously whilst the operation is finalised in the background.
             // However a few members need to be reset immediately to prevent other components from entering invalid states whilst the operation hasn't yet completed.
             // For example, if a room was left and the user immediately pressed the "create room" button, then the user could be taken into the lobby if the value of Room is not reset in time.
-            var scheduledReset = scheduleAsync(() =>
+            var scheduledReset = runOnUpdateThreadAsync(() =>
             {
                 APIRoom = null;
                 Room = null;
@@ -799,7 +799,7 @@ namespace osu.Game.Online.Multiplayer
                 PlayingUserIds.Remove(userId);
         }
 
-        private Task scheduleAsync(Action action, CancellationToken cancellationToken = default)
+        private Task runOnUpdateThreadAsync(Action action, CancellationToken cancellationToken = default)
         {
             var tcs = new TaskCompletionSource<bool>();
 

From 64c63fe93a4ae35a01a86ab5c25a0e65a633a036 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 8 Apr 2022 14:52:56 +0900
Subject: [PATCH 3986/5547] Move null check in `JoinRoom` on to update thread

---
 osu.Game/Online/Multiplayer/MultiplayerClient.cs | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Online/Multiplayer/MultiplayerClient.cs b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
index 5cbf65478c..996a4e312f 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
@@ -163,13 +163,13 @@ namespace osu.Game.Online.Multiplayer
         /// <param name="password">An optional password to use for the join operation.</param>
         public async Task JoinRoom(Room room, string? password = null)
         {
+            if (Room != null)
+                throw new InvalidOperationException("Cannot join a multiplayer room while already in one.");
+
             var cancellationSource = joinCancellationSource = new CancellationTokenSource();
 
             await joinOrLeaveTaskChain.Add(async () =>
             {
-                if (Room != null)
-                    throw new InvalidOperationException("Cannot join a multiplayer room while already in one.");
-
                 Debug.Assert(room.RoomID.Value != null);
 
                 // Join the server-side room.
@@ -183,6 +183,8 @@ namespace osu.Game.Online.Multiplayer
                 // Update the stored room (must be done on update thread for thread-safety).
                 await runOnUpdateThreadAsync(() =>
                 {
+                    Debug.Assert(Room == null);
+
                     Room = joinedRoom;
                     APIRoom = room;
 

From 24c2d465a9c04f61aad3fde9c87243a458447505 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 8 Apr 2022 14:53:14 +0900
Subject: [PATCH 3987/5547] Move null assert in `MultiplayerPlayer` on to
 update thread

---
 osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayer.cs | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayer.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayer.cs
index 043315c790..70f8f1b752 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayer.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayer.cs
@@ -133,6 +133,11 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
                     failAndBail();
                 }
             }), true);
+        }
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
 
             Debug.Assert(client.Room != null);
         }

From 933a722cfcecb2911fcb2db9ebecfb1e50b76922 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 8 Apr 2022 14:56:04 +0900
Subject: [PATCH 3988/5547] Remove secondary null checks which cannot exist
 (were on wrong thread)

---
 .../Online/Multiplayer/MultiplayerClient.cs   | 48 -------------------
 1 file changed, 48 deletions(-)

diff --git a/osu.Game/Online/Multiplayer/MultiplayerClient.cs b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
index 996a4e312f..7808d8939c 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
@@ -360,9 +360,6 @@ namespace osu.Game.Online.Multiplayer
 
         Task IMultiplayerClient.RoomStateChanged(MultiplayerRoomState state)
         {
-            if (Room == null)
-                return Task.CompletedTask;
-
             Scheduler.Add(() =>
             {
                 if (Room == null)
@@ -395,9 +392,6 @@ namespace osu.Game.Online.Multiplayer
 
         async Task IMultiplayerClient.UserJoined(MultiplayerRoomUser user)
         {
-            if (Room == null)
-                return;
-
             await PopulateUser(user).ConfigureAwait(false);
 
             Scheduler.Add(() =>
@@ -446,9 +440,6 @@ namespace osu.Game.Online.Multiplayer
 
         private Task handleUserLeft(MultiplayerRoomUser user, Action<MultiplayerRoomUser>? callback)
         {
-            if (Room == null)
-                return Task.CompletedTask;
-
             Scheduler.Add(() =>
             {
                 if (Room == null)
@@ -470,9 +461,6 @@ namespace osu.Game.Online.Multiplayer
 
         Task IMultiplayerClient.HostChanged(int userId)
         {
-            if (Room == null)
-                return Task.CompletedTask;
-
             Scheduler.Add(() =>
             {
                 if (Room == null)
@@ -503,9 +491,6 @@ namespace osu.Game.Online.Multiplayer
 
         Task IMultiplayerClient.UserStateChanged(int userId, MultiplayerUserState state)
         {
-            if (Room == null)
-                return Task.CompletedTask;
-
             Scheduler.Add(() =>
             {
                 if (Room == null)
@@ -523,9 +508,6 @@ namespace osu.Game.Online.Multiplayer
 
         Task IMultiplayerClient.MatchUserStateChanged(int userId, MatchUserState state)
         {
-            if (Room == null)
-                return Task.CompletedTask;
-
             Scheduler.Add(() =>
             {
                 if (Room == null)
@@ -540,9 +522,6 @@ namespace osu.Game.Online.Multiplayer
 
         Task IMultiplayerClient.MatchRoomStateChanged(MatchRoomState state)
         {
-            if (Room == null)
-                return Task.CompletedTask;
-
             Scheduler.Add(() =>
             {
                 if (Room == null)
@@ -557,9 +536,6 @@ namespace osu.Game.Online.Multiplayer
 
         public Task MatchEvent(MatchServerEvent e)
         {
-            if (Room == null)
-                return Task.CompletedTask;
-
             Scheduler.Add(() =>
             {
                 if (Room == null)
@@ -580,9 +556,6 @@ namespace osu.Game.Online.Multiplayer
 
         Task IMultiplayerClient.UserBeatmapAvailabilityChanged(int userId, BeatmapAvailability beatmapAvailability)
         {
-            if (Room == null)
-                return Task.CompletedTask;
-
             Scheduler.Add(() =>
             {
                 var user = Room?.Users.SingleOrDefault(u => u.UserID == userId);
@@ -601,9 +574,6 @@ namespace osu.Game.Online.Multiplayer
 
         public Task UserModsChanged(int userId, IEnumerable<APIMod> mods)
         {
-            if (Room == null)
-                return Task.CompletedTask;
-
             Scheduler.Add(() =>
             {
                 var user = Room?.Users.SingleOrDefault(u => u.UserID == userId);
@@ -622,9 +592,6 @@ namespace osu.Game.Online.Multiplayer
 
         Task IMultiplayerClient.LoadRequested()
         {
-            if (Room == null)
-                return Task.CompletedTask;
-
             Scheduler.Add(() =>
             {
                 if (Room == null)
@@ -638,9 +605,6 @@ namespace osu.Game.Online.Multiplayer
 
         Task IMultiplayerClient.MatchStarted()
         {
-            if (Room == null)
-                return Task.CompletedTask;
-
             Scheduler.Add(() =>
             {
                 if (Room == null)
@@ -654,9 +618,6 @@ namespace osu.Game.Online.Multiplayer
 
         Task IMultiplayerClient.ResultsReady()
         {
-            if (Room == null)
-                return Task.CompletedTask;
-
             Scheduler.Add(() =>
             {
                 if (Room == null)
@@ -670,9 +631,6 @@ namespace osu.Game.Online.Multiplayer
 
         public Task PlaylistItemAdded(MultiplayerPlaylistItem item)
         {
-            if (Room == null)
-                return Task.CompletedTask;
-
             Scheduler.Add(() =>
             {
                 if (Room == null)
@@ -692,9 +650,6 @@ namespace osu.Game.Online.Multiplayer
 
         public Task PlaylistItemRemoved(long playlistItemId)
         {
-            if (Room == null)
-                return Task.CompletedTask;
-
             Scheduler.Add(() =>
             {
                 if (Room == null)
@@ -716,9 +671,6 @@ namespace osu.Game.Online.Multiplayer
 
         public Task PlaylistItemChanged(MultiplayerPlaylistItem item)
         {
-            if (Room == null)
-                return Task.CompletedTask;
-
             Scheduler.Add(() =>
             {
                 if (Room == null)

From 879267862c62fff490bbec9032bf48b07a53bf6e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 8 Apr 2022 15:20:22 +0900
Subject: [PATCH 3989/5547] Fix typo in `DrawableOsuHitObject`

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

diff --git a/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableOsuHitObject.cs b/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableOsuHitObject.cs
index 628d95dff4..a1c8879105 100644
--- a/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableOsuHitObject.cs
+++ b/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableOsuHitObject.cs
@@ -21,7 +21,7 @@ namespace osu.Game.Rulesets.Osu.Objects.Drawables
         public readonly IBindable<float> ScaleBindable = new BindableFloat();
         public readonly IBindable<int> IndexInCurrentComboBindable = new Bindable<int>();
 
-        // Must be set to update IsHovered as it's used in relax mdo to detect osu hit objects.
+        // Must be set to update IsHovered as it's used in relax mod to detect osu hit objects.
         public override bool HandlePositionalInput => true;
 
         protected override float SamplePlaybackPosition => HitObject.X / OsuPlayfield.BASE_SIZE.X;

From 6bb82432125b7a5957a9472751b2f44ed48ff9fc Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 8 Apr 2022 17:41:03 +0900
Subject: [PATCH 3990/5547] Fix potential assert failure due to `Room` access
 from disconnection event

---
 osu.Game/Online/Multiplayer/MultiplayerClient.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Online/Multiplayer/MultiplayerClient.cs b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
index 7808d8939c..7d4084aeb4 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
@@ -142,7 +142,7 @@ namespace osu.Game.Online.Multiplayer
         [BackgroundDependencyLoader]
         private void load()
         {
-            IsConnected.BindValueChanged(connected =>
+            IsConnected.BindValueChanged(connected => Scheduler.Add(() =>
             {
                 // clean up local room state on server disconnect.
                 if (!connected.NewValue && Room != null)
@@ -150,7 +150,7 @@ namespace osu.Game.Online.Multiplayer
                     Logger.Log("Connection to multiplayer server was lost.", LoggingTarget.Runtime, LogLevel.Important);
                     LeaveRoom();
                 }
-            });
+            }));
         }
 
         private readonly TaskChain joinOrLeaveTaskChain = new TaskChain();

From 5c571996d8398287e8a7b5ed9eb2a36fe3959a5c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 8 Apr 2022 17:55:43 +0900
Subject: [PATCH 3991/5547] Avoid multiplayer crashes when events arrive in
 unexpected order

Intended to be a temporary fix for
https://github.com/ppy/osu/issues/17713 while a more permanent solution
is established. A proper fix is actually quite simple, but updating the
test to work with it is... *slightly* more complicated.

This hotfix will mean that if a `UserJoined` event arrives during the
unobserved window during room join (of the local user), the local user
still won't see the joining user, but the game won't crash as a result.
---
 osu.Game/Online/Multiplayer/MultiplayerClient.cs | 15 ++++++++++-----
 1 file changed, 10 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Online/Multiplayer/MultiplayerClient.cs b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
index 7808d8939c..7bd93c2e34 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
@@ -493,11 +493,13 @@ namespace osu.Game.Online.Multiplayer
         {
             Scheduler.Add(() =>
             {
-                if (Room == null)
+                var user = Room?.Users.SingleOrDefault(u => u.UserID == userId);
+
+                // TODO: user should NEVER be null here, see https://github.com/ppy/osu/issues/17713.
+                if (user == null)
                     return;
 
-                Room.Users.Single(u => u.UserID == userId).State = state;
-
+                user.State = state;
                 updateUserPlayingState(userId, state);
 
                 RoomUpdated?.Invoke();
@@ -510,10 +512,13 @@ namespace osu.Game.Online.Multiplayer
         {
             Scheduler.Add(() =>
             {
-                if (Room == null)
+                var user = Room?.Users.SingleOrDefault(u => u.UserID == userId);
+
+                // TODO: user should NEVER be null here, see https://github.com/ppy/osu/issues/17713.
+                if (user == null)
                     return;
 
-                Room.Users.Single(u => u.UserID == userId).MatchState = state;
+                user.MatchState = state;
                 RoomUpdated?.Invoke();
             }, false);
 

From ea4ca6d2ad0b7b14ea448f6f2de7612affc72b56 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 8 Apr 2022 18:09:57 +0900
Subject: [PATCH 3992/5547] Update framework

---
 osu.Android.props        | 2 +-
 osu.Game/osu.Game.csproj | 2 +-
 osu.iOS.props            | 4 ++--
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Android.props b/osu.Android.props
index 10685d5990..331c4db01f 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -52,7 +52,7 @@
   </ItemGroup>
   <ItemGroup>
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.407.0" />
-    <PackageReference Include="ppy.osu.Framework.Android" Version="2022.405.0" />
+    <PackageReference Include="ppy.osu.Framework.Android" Version="2022.408.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
     <!-- Realm needs to be directly referenced in all Xamarin projects, as it will not pull in its transitive dependencies otherwise. -->
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 7fd2647a8a..308ec7e7d6 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="10.10.0" />
-    <PackageReference Include="ppy.osu.Framework" Version="2022.405.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2022.408.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.407.0" />
     <PackageReference Include="Sentry" Version="3.14.1" />
     <PackageReference Include="SharpCompress" Version="0.30.1" />
diff --git a/osu.iOS.props b/osu.iOS.props
index a5efc40d51..311c9ba345 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -61,7 +61,7 @@
     <Reference Include="System.Net.Http" />
   </ItemGroup>
   <ItemGroup Label="Package References">
-    <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.405.0" />
+    <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.408.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.407.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net6.0) -->
@@ -84,7 +84,7 @@
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="5.0.14" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.Core" Version="5.0.14" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
-    <PackageReference Include="ppy.osu.Framework" Version="2022.405.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2022.408.0" />
     <PackageReference Include="SharpCompress" Version="0.30.1" />
     <PackageReference Include="NUnit" Version="3.13.2" />
     <PackageReference Include="System.ComponentModel.Annotations" Version="5.0.0" />

From 9ea6f9b1fe0e3411a94ed07ecf1286105bfd071e Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 8 Apr 2022 21:44:44 +0900
Subject: [PATCH 3993/5547] Remove some incorrectly-firing asserts

---
 osu.Game/Online/Multiplayer/MultiplayerClient.cs | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/osu.Game/Online/Multiplayer/MultiplayerClient.cs b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
index 0e9ba323ae..1bd1952832 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
@@ -481,11 +481,7 @@ namespace osu.Game.Online.Multiplayer
 
         Task IMultiplayerClient.SettingsChanged(MultiplayerRoomSettings newSettings)
         {
-            Debug.Assert(APIRoom != null);
-            Debug.Assert(Room != null);
-
             Scheduler.Add(() => updateLocalRoomSettings(newSettings));
-
             return Task.CompletedTask;
         }
 

From ae1e1268374f632294aedadf0c228ae724000bd9 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 9 Apr 2022 00:30:28 +0900
Subject: [PATCH 3994/5547] Make `HighlightMessage` implicitly show chat
 overlay

---
 osu.Game/Online/Chat/MessageNotifier.cs | 2 --
 osu.Game/Overlays/ChatOverlay.cs        | 2 ++
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Online/Chat/MessageNotifier.cs b/osu.Game/Online/Chat/MessageNotifier.cs
index bcfec3cc0f..20c33db61f 100644
--- a/osu.Game/Online/Chat/MessageNotifier.cs
+++ b/osu.Game/Online/Chat/MessageNotifier.cs
@@ -178,8 +178,6 @@ namespace osu.Game.Online.Chat
                 {
                     notificationOverlay.Hide();
                     chatOverlay.HighlightMessage(message, channel);
-                    chatOverlay.Show();
-
                     return true;
                 };
             }
diff --git a/osu.Game/Overlays/ChatOverlay.cs b/osu.Game/Overlays/ChatOverlay.cs
index 3d39c7ce3a..8eb33453de 100644
--- a/osu.Game/Overlays/ChatOverlay.cs
+++ b/osu.Game/Overlays/ChatOverlay.cs
@@ -313,6 +313,8 @@ namespace osu.Game.Overlays
         /// <param name="channel">The channel containing the message.</param>
         public void HighlightMessage(Message message, Channel channel)
         {
+            Show();
+
             Debug.Assert(channel.Id == message.ChannelId);
 
             if (currentChannel.Value.Id != channel.Id)

From 57fb8616b86c0a43fc51e3679984c88839efe0d0 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 9 Apr 2022 00:31:00 +0900
Subject: [PATCH 3995/5547] Fix potential null reference when attempting to
 highlight a message before overlay has been displayed

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

diff --git a/osu.Game/Overlays/ChatOverlay.cs b/osu.Game/Overlays/ChatOverlay.cs
index 8eb33453de..1ad6be132e 100644
--- a/osu.Game/Overlays/ChatOverlay.cs
+++ b/osu.Game/Overlays/ChatOverlay.cs
@@ -317,7 +317,7 @@ namespace osu.Game.Overlays
 
             Debug.Assert(channel.Id == message.ChannelId);
 
-            if (currentChannel.Value.Id != channel.Id)
+            if (currentChannel.Value?.Id != channel.Id)
             {
                 if (!channel.Joined.Value)
                     channel = channelManager.JoinChannel(channel);

From 34adc1d41070b37024065528da9e96965375a652 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 8 Apr 2022 19:21:37 +0300
Subject: [PATCH 3996/5547] Add quick test coverage

---
 .../Visual/Online/TestSceneChatOverlay.cs     | 28 +++++++++++++++++--
 1 file changed, 25 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneChatOverlay.cs b/osu.Game.Tests/Visual/Online/TestSceneChatOverlay.cs
index 80a6698761..4d1dee1650 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneChatOverlay.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneChatOverlay.cs
@@ -534,11 +534,33 @@ namespace osu.Game.Tests.Visual.Online
                 });
             });
 
-            AddStep("Highlight message and open chat", () =>
+            AddStep("Highlight message", () => chatOverlay.HighlightMessage(message, channel1));
+        }
+
+        [Test]
+        public void TestHighlightWithNullChannel()
+        {
+            Message message = null;
+
+            AddStep("Join channel 1", () => channelManager.JoinChannel(channel1));
+
+            AddStep("Send message in channel 1", () =>
             {
-                chatOverlay.HighlightMessage(message, channel1);
-                chatOverlay.Show();
+                channel1.AddNewMessages(message = new Message
+                {
+                    ChannelId = channel1.Id,
+                    Content = "Message to highlight!",
+                    Timestamp = DateTimeOffset.Now,
+                    Sender = new APIUser
+                    {
+                        Id = 2,
+                        Username = "Someone",
+                    }
+                });
             });
+
+            AddStep("Set null channel", () => channelManager.CurrentChannel.Value = null);
+            AddStep("Highlight message", () => chatOverlay.HighlightMessage(message, channel1));
         }
 
         private void pressChannelHotkey(int number)

From 134d9b5ddf16ea0ea8e27e764bdef755c0b3f17f Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 8 Apr 2022 19:27:59 +0300
Subject: [PATCH 3997/5547] Perform `Show()` at the bottom of the method

Probably not affecting behaviour, but makes more sense.
---
 osu.Game/Overlays/ChatOverlay.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Overlays/ChatOverlay.cs b/osu.Game/Overlays/ChatOverlay.cs
index 1ad6be132e..64b972262b 100644
--- a/osu.Game/Overlays/ChatOverlay.cs
+++ b/osu.Game/Overlays/ChatOverlay.cs
@@ -313,8 +313,6 @@ namespace osu.Game.Overlays
         /// <param name="channel">The channel containing the message.</param>
         public void HighlightMessage(Message message, Channel channel)
         {
-            Show();
-
             Debug.Assert(channel.Id == message.ChannelId);
 
             if (currentChannel.Value?.Id != channel.Id)
@@ -326,6 +324,8 @@ namespace osu.Game.Overlays
             }
 
             channel.HighlightedMessage.Value = message;
+
+            Show();
         }
 
         private float startDragChatHeight;

From d482ab02877b3f231dd4d177b352e28ef5a4af4a Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Sat, 9 Apr 2022 22:29:55 +0900
Subject: [PATCH 3998/5547] Fix ParticleSpewer outputting NaN in vertices

---
 osu.Game/Graphics/ParticleSpewer.cs | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/osu.Game/Graphics/ParticleSpewer.cs b/osu.Game/Graphics/ParticleSpewer.cs
index 4fc6c4527f..369a4b21c7 100644
--- a/osu.Game/Graphics/ParticleSpewer.cs
+++ b/osu.Game/Graphics/ParticleSpewer.cs
@@ -109,6 +109,9 @@ namespace osu.Game.Graphics
             {
                 foreach (var p in particles)
                 {
+                    if (p.Duration == 0)
+                        continue;
+
                     float timeSinceStart = currentTime - p.StartTime;
 
                     // ignore particles from the future.

From 19b655d75bd589f25fa76057fe3e66ec5d98eb96 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 11 Apr 2022 13:30:21 +0900
Subject: [PATCH 3999/5547] Avoid throwing unobserved exception when
 `PerformancePointsCounter` requests timed attributes

---
 osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs b/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs
index 7a1f724cfb..8b1e0ae83e 100644
--- a/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs
+++ b/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs
@@ -6,7 +6,6 @@ using System.Collections.Generic;
 using System.IO;
 using System.Linq;
 using System.Threading;
-using System.Threading.Tasks;
 using JetBrains.Annotations;
 using osu.Framework.Allocation;
 using osu.Framework.Audio.Track;
@@ -80,13 +79,16 @@ namespace osu.Game.Screens.Play.HUD
                 difficultyCache.GetTimedDifficultyAttributesAsync(gameplayWorkingBeatmap, gameplayState.Ruleset, clonedMods, loadCancellationSource.Token)
                                .ContinueWith(task => Schedule(() =>
                                {
+                                   if (task.Exception != null)
+                                       return;
+
                                    timedAttributes = task.GetResultSafely();
 
                                    IsValid = true;
 
                                    if (lastJudgement != null)
                                        onJudgementChanged(lastJudgement);
-                               }), TaskContinuationOptions.OnlyOnRanToCompletion);
+                               }));
             }
         }
 

From 779f7390b78425e9340f9172e536fd9bb733beae Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 11 Apr 2022 13:43:43 +0900
Subject: [PATCH 4000/5547] Add test coverage of `DrawableRoom` actually
 showing post-retrieval text

---
 .../Visual/Multiplayer/TestSceneDrawableRoom.cs          | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoom.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoom.cs
index d8ec0ad1f0..7d010592ae 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoom.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoom.cs
@@ -10,6 +10,7 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Testing;
 using osu.Framework.Utils;
+using osu.Game.Graphics.Sprites;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Rooms;
@@ -34,9 +35,11 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [Test]
         public void TestMultipleStatuses()
         {
+            FillFlowContainer rooms = null;
+
             AddStep("create rooms", () =>
             {
-                Child = new FillFlowContainer
+                Child = rooms = new FillFlowContainer
                 {
                     Anchor = Anchor.Centre,
                     Origin = Anchor.Centre,
@@ -124,6 +127,10 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     }
                 };
             });
+
+            AddUntilStep("wait for panel load", () => rooms.Count == 5);
+            AddUntilStep("correct status text", () => rooms.ChildrenOfType<OsuSpriteText>().Count(s => s.Text.ToString().StartsWith("Currently playing", StringComparison.Ordinal)) == 2);
+            AddUntilStep("correct status text", () => rooms.ChildrenOfType<OsuSpriteText>().Count(s => s.Text.ToString().StartsWith("Ready to play", StringComparison.Ordinal)) == 3);
         }
 
         [Test]

From 2b74dbca28c24f1d3f2077ab272ed99deac5b33d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 11 Apr 2022 13:36:01 +0900
Subject: [PATCH 4001/5547] Fix potential crash in `DrawableRoom` due to lack
 of null check on post-lookup beatmap

---
 .../OnlinePlay/Lounge/Components/DrawableRoom.cs   | 14 ++++++++++----
 1 file changed, 10 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Lounge/Components/DrawableRoom.cs b/osu.Game/Screens/OnlinePlay/Lounge/Components/DrawableRoom.cs
index 5adce862a0..8e3aa77e7b 100644
--- a/osu.Game/Screens/OnlinePlay/Lounge/Components/DrawableRoom.cs
+++ b/osu.Game/Screens/OnlinePlay/Lounge/Components/DrawableRoom.cs
@@ -418,10 +418,16 @@ namespace osu.Game.Screens.OnlinePlay.Lounge.Components
                                       var retrievedBeatmap = task.GetResultSafely();
 
                                       statusText.Text = "Currently playing ";
-                                      beatmapText.AddLink(retrievedBeatmap.GetDisplayTitleRomanisable(),
-                                          LinkAction.OpenBeatmap,
-                                          retrievedBeatmap.OnlineID.ToString(),
-                                          creationParameters: s => s.Truncate = true);
+
+                                      if (retrievedBeatmap != null)
+                                      {
+                                          beatmapText.AddLink(retrievedBeatmap.GetDisplayTitleRomanisable(),
+                                              LinkAction.OpenBeatmap,
+                                              retrievedBeatmap.OnlineID.ToString(),
+                                              creationParameters: s => s.Truncate = true);
+                                      }
+                                      else
+                                          beatmapText.AddText("unknown beatmap");
                                   }), cancellationSource.Token);
             }
         }

From 808f0ecb74d2f2c65fdc9558d1eb07a616b6ac18 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 11 Apr 2022 14:10:50 +0900
Subject: [PATCH 4002/5547] Ensure running state is updated before performing
 `Seek` in `GameplayClockContainer.Reset`

---
 osu.Game/Screens/Play/GameplayClockContainer.cs | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Screens/Play/GameplayClockContainer.cs b/osu.Game/Screens/Play/GameplayClockContainer.cs
index 226f5709c7..f2df00d691 100644
--- a/osu.Game/Screens/Play/GameplayClockContainer.cs
+++ b/osu.Game/Screens/Play/GameplayClockContainer.cs
@@ -122,14 +122,14 @@ namespace osu.Game.Screens.Play
             if (gameplayStartTime != null)
                 StartTime = gameplayStartTime;
 
-            ensureSourceClockSet();
-            Seek(StartTime ?? 0);
-
             // Manually stop the source in order to not affect the IsPaused state.
             AdjustableSource.Stop();
 
             if (!IsPaused.Value || startClock)
                 Start();
+
+            ensureSourceClockSet();
+            Seek(StartTime ?? 0);
         }
 
         /// <summary>

From cb6e557212a5156ba2f59dd542943c878414b40f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 11 Apr 2022 14:11:23 +0900
Subject: [PATCH 4003/5547] Fix `MasterGameplayClockContainer` having incorrect
 rate-based offsets immediately after `LoadComplete`

I've attempted to explain why this is required using inline comments.
There's also further conversation at
https://github.com/ppy/osu/pull/17302#issuecomment-1091850927.
---
 .../Play/MasterGameplayClockContainer.cs      | 29 ++++++++++++++-----
 1 file changed, 22 insertions(+), 7 deletions(-)

diff --git a/osu.Game/Screens/Play/MasterGameplayClockContainer.cs b/osu.Game/Screens/Play/MasterGameplayClockContainer.cs
index 9bcbbf789b..54901746fc 100644
--- a/osu.Game/Screens/Play/MasterGameplayClockContainer.cs
+++ b/osu.Game/Screens/Play/MasterGameplayClockContainer.cs
@@ -130,17 +130,32 @@ namespace osu.Game.Screens.Play
 
         protected override void OnIsPausedChanged(ValueChangedEvent<bool> isPaused)
         {
-            // The source is stopped by a frequency fade first.
-            if (isPaused.NewValue)
+            if (IsLoaded)
             {
-                this.TransformBindableTo(pauseFreqAdjust, 0, 200, Easing.Out).OnComplete(_ =>
+                // During normal operation, the source is stopped after performing a frequency ramp.
+                if (isPaused.NewValue)
                 {
-                    if (IsPaused.Value == isPaused.NewValue)
-                        AdjustableSource.Stop();
-                });
+                    this.TransformBindableTo(pauseFreqAdjust, 0, 200, Easing.Out).OnComplete(_ =>
+                    {
+                        if (IsPaused.Value == isPaused.NewValue)
+                            AdjustableSource.Stop();
+                    });
+                }
+                else
+                    this.TransformBindableTo(pauseFreqAdjust, 1, 200, Easing.In);
             }
             else
-                this.TransformBindableTo(pauseFreqAdjust, 1, 200, Easing.In);
+            {
+                if (isPaused.NewValue)
+                    AdjustableSource.Stop();
+
+                // If not yet loaded, we still want to ensure relevant state is correct, as it is used for offset calculations.
+                pauseFreqAdjust.Value = isPaused.NewValue ? 0 : 1;
+
+                // We must also process underlying gameplay clocks to update rate-adjusted offsets with the new frequency adjustment.
+                // Without doing this, an initial seek may be performed with the wrong offset.
+                GameplayClock.UnderlyingClock.ProcessFrame();
+            }
         }
 
         public override void Start()

From 72cb3d6ad63dc0967a74980d67ae3c097c02e41b Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Mon, 11 Apr 2022 14:15:08 +0800
Subject: [PATCH 4004/5547] USe `MathF` in all applicable places

---
 .../Utils/OsuHitObjectGenerationUtils.cs           |  6 +++---
 .../OsuHitObjectGenerationUtils_Reposition.cs      | 14 +++++++-------
 2 files changed, 10 insertions(+), 10 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Utils/OsuHitObjectGenerationUtils.cs b/osu.Game.Rulesets.Osu/Utils/OsuHitObjectGenerationUtils.cs
index 19d3390f56..6129e6bfc4 100644
--- a/osu.Game.Rulesets.Osu/Utils/OsuHitObjectGenerationUtils.cs
+++ b/osu.Game.Rulesets.Osu/Utils/OsuHitObjectGenerationUtils.cs
@@ -174,11 +174,11 @@ namespace osu.Game.Rulesets.Osu.Utils
         /// <returns>The rotated vector.</returns>
         private static Vector2 rotateVector(Vector2 vector, float rotation)
         {
-            float angle = (float)Math.Atan2(vector.Y, vector.X) + rotation;
+            float angle = MathF.Atan2(vector.Y, vector.X) + rotation;
             float length = vector.Length;
             return new Vector2(
-                length * (float)Math.Cos(angle),
-                length * (float)Math.Sin(angle)
+                length * MathF.Cos(angle),
+                length * MathF.Sin(angle)
             );
         }
     }
diff --git a/osu.Game.Rulesets.Osu/Utils/OsuHitObjectGenerationUtils_Reposition.cs b/osu.Game.Rulesets.Osu/Utils/OsuHitObjectGenerationUtils_Reposition.cs
index 664bfae35a..2abbd61c59 100644
--- a/osu.Game.Rulesets.Osu/Utils/OsuHitObjectGenerationUtils_Reposition.cs
+++ b/osu.Game.Rulesets.Osu/Utils/OsuHitObjectGenerationUtils_Reposition.cs
@@ -38,7 +38,7 @@ namespace osu.Game.Rulesets.Osu.Utils
             foreach (OsuHitObject hitObject in hitObjects)
             {
                 Vector2 relativePosition = hitObject.Position - previousPosition;
-                float absoluteAngle = (float)Math.Atan2(relativePosition.Y, relativePosition.X);
+                float absoluteAngle = MathF.Atan2(relativePosition.Y, relativePosition.X);
                 float relativeAngle = absoluteAngle - previousAngle;
 
                 ObjectPositionInfo positionInfo;
@@ -141,15 +141,15 @@ namespace osu.Game.Rulesets.Osu.Utils
                 {
                     Vector2 earliestPosition = beforePrevious?.HitObject.EndPosition ?? playfield_centre;
                     Vector2 relativePosition = previous.HitObject.Position - earliestPosition;
-                    previousAbsoluteAngle = (float)Math.Atan2(relativePosition.Y, relativePosition.X);
+                    previousAbsoluteAngle = MathF.Atan2(relativePosition.Y, relativePosition.X);
                 }
             }
 
             float absoluteAngle = previousAbsoluteAngle + current.PositionInfo.RelativeAngle;
 
             var posRelativeToPrev = new Vector2(
-                current.PositionInfo.DistanceFromPrevious * (float)Math.Cos(absoluteAngle),
-                current.PositionInfo.DistanceFromPrevious * (float)Math.Sin(absoluteAngle)
+                current.PositionInfo.DistanceFromPrevious * MathF.Cos(absoluteAngle),
+                current.PositionInfo.DistanceFromPrevious * MathF.Sin(absoluteAngle)
             );
 
             Vector2 lastEndPosition = previous?.EndPositionModified ?? playfield_centre;
@@ -161,13 +161,13 @@ namespace osu.Game.Rulesets.Osu.Utils
             if (!(current.HitObject is Slider slider))
                 return;
 
-            absoluteAngle = (float)Math.Atan2(posRelativeToPrev.Y, posRelativeToPrev.X);
+            absoluteAngle = MathF.Atan2(posRelativeToPrev.Y, posRelativeToPrev.X);
 
             Vector2 centreOfMassOriginal = calculateCentreOfMass(slider);
             Vector2 centreOfMassModified = rotateVector(centreOfMassOriginal, current.PositionInfo.Rotation + absoluteAngle - getSliderRotation(slider));
             centreOfMassModified = RotateAwayFromEdge(current.PositionModified, centreOfMassModified);
 
-            float relativeRotation = (float)Math.Atan2(centreOfMassModified.Y, centreOfMassModified.X) - (float)Math.Atan2(centreOfMassOriginal.Y, centreOfMassOriginal.X);
+            float relativeRotation = MathF.Atan2(centreOfMassModified.Y, centreOfMassModified.X) - MathF.Atan2(centreOfMassOriginal.Y, centreOfMassOriginal.X);
             if (!Precision.AlmostEquals(relativeRotation, 0))
                 RotateSlider(slider, relativeRotation);
         }
@@ -346,7 +346,7 @@ namespace osu.Game.Rulesets.Osu.Utils
         private static float getSliderRotation(Slider slider)
         {
             var endPositionVector = slider.Path.PositionAt(1);
-            return (float)Math.Atan2(endPositionVector.Y, endPositionVector.X);
+            return MathF.Atan2(endPositionVector.Y, endPositionVector.X);
         }
 
         public class ObjectPositionInfo

From d1de516b1109d69b4c09391cb7997dec590d77e8 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Mon, 11 Apr 2022 15:38:11 +0900
Subject: [PATCH 4005/5547] Fix incorrect cursor parameterisation in test scene

---
 .../TestScenePlaylistsResultsScreen.cs        | 21 +++++++++++++++----
 1 file changed, 17 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsResultsScreen.cs b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsResultsScreen.cs
index ee9a0e263b..f5fe00458a 100644
--- a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsResultsScreen.cs
+++ b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsResultsScreen.cs
@@ -259,7 +259,7 @@ namespace osu.Game.Tests.Visual.Playlists
             {
                 multiplayerUserScore.ScoresAround.Lower.Scores.Add(new MultiplayerScore
                 {
-                    ID = --highestScoreId,
+                    ID = getNextLowestScoreId(),
                     Accuracy = userScore.Accuracy,
                     Passed = true,
                     Rank = userScore.Rank,
@@ -274,7 +274,7 @@ namespace osu.Game.Tests.Visual.Playlists
 
                 multiplayerUserScore.ScoresAround.Higher.Scores.Add(new MultiplayerScore
                 {
-                    ID = ++lowestScoreId,
+                    ID = getNextHighestScoreId(),
                     Accuracy = userScore.Accuracy,
                     Passed = true,
                     Rank = userScore.Rank,
@@ -306,7 +306,7 @@ namespace osu.Game.Tests.Visual.Playlists
             {
                 result.Scores.Add(new MultiplayerScore
                 {
-                    ID = sort == "score_asc" ? --highestScoreId : ++lowestScoreId,
+                    ID = sort == "score_asc" ? getNextHighestScoreId() : getNextLowestScoreId(),
                     Accuracy = 1,
                     Passed = true,
                     Rank = ScoreRank.X,
@@ -327,6 +327,17 @@ namespace osu.Game.Tests.Visual.Playlists
             return result;
         }
 
+        /// <summary>
+        /// The next highest score ID to appear at the left of the list. Monotonically decreasing.
+        /// </summary>
+        private int getNextHighestScoreId() => --highestScoreId;
+
+        /// <summary>
+        /// The next lowest score ID to appear at the right of the list. Monotonically increasing.
+        /// </summary>
+        /// <returns></returns>
+        private int getNextLowestScoreId() => ++lowestScoreId;
+
         private void addCursor(MultiplayerScores scores)
         {
             scores.Cursor = new Cursor
@@ -342,7 +353,9 @@ namespace osu.Game.Tests.Visual.Playlists
             {
                 Properties = new Dictionary<string, JToken>
                 {
-                    { "sort", JToken.FromObject(scores.Scores[^1].ID > scores.Scores[^2].ID ? "score_asc" : "score_desc") }
+                    // [ 1, 2, 3, ... ] => score_desc (will be added to the right of the list)
+                    // [ 3, 2, 1, ... ] => score_asc (will be added to the left of the list)
+                    { "sort", JToken.FromObject(scores.Scores[^1].ID > scores.Scores[^2].ID ? "score_desc" : "score_asc") }
                 }
             };
         }

From abb42a54fde43f6613fd76a4389b4a0a9575f24a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 11 Apr 2022 16:47:34 +0900
Subject: [PATCH 4006/5547] Fix `MultiplayerTestScene` not actually setting
 match type correctly

---
 osu.Game/Tests/Visual/Multiplayer/MultiplayerTestScene.cs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Game/Tests/Visual/Multiplayer/MultiplayerTestScene.cs b/osu.Game/Tests/Visual/Multiplayer/MultiplayerTestScene.cs
index 6c40546325..a26c6f9be9 100644
--- a/osu.Game/Tests/Visual/Multiplayer/MultiplayerTestScene.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/MultiplayerTestScene.cs
@@ -44,6 +44,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             return new Room
             {
                 Name = { Value = "test name" },
+                Type = { Value = MatchType.HeadToHead },
                 Playlist =
                 {
                     new PlaylistItem(new TestBeatmap(Ruleset.Value).BeatmapInfo)

From 34457b474229b383e14a18e2d6cefd4760e1abee Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 11 Apr 2022 18:51:37 +0900
Subject: [PATCH 4007/5547] Expose mocked members as `virtual` on `Multiplayer`
 and `SpectatorClient`

---
 osu.Game/Online/Multiplayer/MultiplayerClient.cs | 4 ++--
 osu.Game/Online/Spectator/SpectatorClient.cs     | 6 +++---
 2 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Online/Multiplayer/MultiplayerClient.cs b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
index 1bd1952832..18db710cee 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
@@ -42,7 +42,7 @@ namespace osu.Game.Online.Multiplayer
         /// <summary>
         /// Invoked when a user leaves the room of their own accord.
         /// </summary>
-        public event Action<MultiplayerRoomUser>? UserLeft;
+        public virtual event Action<MultiplayerRoomUser>? UserLeft;
 
         /// <summary>
         /// Invoked when a user was kicked from the room forcefully.
@@ -107,7 +107,7 @@ namespace osu.Game.Online.Multiplayer
         /// <summary>
         /// The users in the joined <see cref="Room"/> which are participating in the current gameplay loop.
         /// </summary>
-        public IBindableList<int> CurrentMatchPlayingUserIds => PlayingUserIds;
+        public virtual IBindableList<int> CurrentMatchPlayingUserIds => PlayingUserIds;
 
         protected readonly BindableList<int> PlayingUserIds = new BindableList<int>();
 
diff --git a/osu.Game/Online/Spectator/SpectatorClient.cs b/osu.Game/Online/Spectator/SpectatorClient.cs
index 8f22078010..138e8ac7d6 100644
--- a/osu.Game/Online/Spectator/SpectatorClient.cs
+++ b/osu.Game/Online/Spectator/SpectatorClient.cs
@@ -54,17 +54,17 @@ namespace osu.Game.Online.Spectator
         /// <summary>
         /// Called whenever new frames arrive from the server.
         /// </summary>
-        public event Action<int, FrameDataBundle>? OnNewFrames;
+        public virtual event Action<int, FrameDataBundle>? OnNewFrames;
 
         /// <summary>
         /// Called whenever a user starts a play session, or immediately if the user is being watched and currently in a play session.
         /// </summary>
-        public event Action<int, SpectatorState>? OnUserBeganPlaying;
+        public virtual event Action<int, SpectatorState>? OnUserBeganPlaying;
 
         /// <summary>
         /// Called whenever a user finishes a play session.
         /// </summary>
-        public event Action<int, SpectatorState>? OnUserFinishedPlaying;
+        public virtual event Action<int, SpectatorState>? OnUserFinishedPlaying;
 
         /// <summary>
         /// All users currently being watched.

From 0ccac24f76dbd8f137cd59cda946a1a7d416aaae Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 11 Apr 2022 19:15:46 +0900
Subject: [PATCH 4008/5547] Split out base implementation of
 `MultiplayerGameplayLeaderboard` test

---
 ...MultiplayerGameplayLeaderboardTestScene.cs | 191 ++++++++++++++++++
 1 file changed, 191 insertions(+)
 create mode 100644 osu.Game.Tests/Visual/Multiplayer/MultiplayerGameplayLeaderboardTestScene.cs

diff --git a/osu.Game.Tests/Visual/Multiplayer/MultiplayerGameplayLeaderboardTestScene.cs b/osu.Game.Tests/Visual/Multiplayer/MultiplayerGameplayLeaderboardTestScene.cs
new file mode 100644
index 0000000000..eb15282f75
--- /dev/null
+++ b/osu.Game.Tests/Visual/Multiplayer/MultiplayerGameplayLeaderboardTestScene.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.Collections.Specialized;
+using System.Diagnostics;
+using System.Linq;
+using Moq;
+using NUnit.Framework;
+using osu.Framework.Allocation;
+using osu.Framework.Bindables;
+using osu.Framework.Testing;
+using osu.Framework.Utils;
+using osu.Game.Configuration;
+using osu.Game.Online.API;
+using osu.Game.Online.API.Requests.Responses;
+using osu.Game.Online.Multiplayer;
+using osu.Game.Online.Spectator;
+using osu.Game.Replays.Legacy;
+using osu.Game.Rulesets.Osu.Scoring;
+using osu.Game.Rulesets.Scoring;
+using osu.Game.Scoring;
+using osu.Game.Screens.Play.HUD;
+
+namespace osu.Game.Tests.Visual.Multiplayer
+{
+    public abstract class MultiplayerGameplayLeaderboardTestScene : OsuTestScene
+    {
+        protected readonly BindableList<MultiplayerRoomUser> MultiplayerUsers = new BindableList<MultiplayerRoomUser>();
+        private readonly BindableList<int> multiplayerUserIds = new BindableList<int>();
+
+        protected MultiplayerGameplayLeaderboard Leaderboard { get; private set; }
+
+        private OsuConfigManager config;
+
+        private readonly Mock<SpectatorClient> spectatorClient = new Mock<SpectatorClient>();
+        private readonly Mock<MultiplayerClient> multiplayerClient = new Mock<MultiplayerClient>();
+
+        private readonly Dictionary<int, FrameHeader> lastHeaders = new Dictionary<int, FrameHeader>();
+
+        [BackgroundDependencyLoader]
+        private void load()
+        {
+            Dependencies.Cache(config = new OsuConfigManager(LocalStorage));
+            Dependencies.CacheAs(spectatorClient.Object);
+            Dependencies.CacheAs(multiplayerClient.Object);
+
+            // To emulate `MultiplayerClient.CurrentMatchPlayingUserIds` we need a bindable list of *only IDs*.
+            // This tracks the list of users 1:1.
+            MultiplayerUsers.BindCollectionChanged((c, e) =>
+            {
+                switch (e.Action)
+                {
+                    case NotifyCollectionChangedAction.Add:
+                        Debug.Assert(e.NewItems != null);
+
+                        foreach (var user in e.NewItems.OfType<MultiplayerRoomUser>())
+                            multiplayerUserIds.Add(user.UserID);
+                        break;
+
+                    case NotifyCollectionChangedAction.Remove:
+                        Debug.Assert(e.OldItems != null);
+
+                        foreach (var user in e.OldItems.OfType<MultiplayerRoomUser>())
+                            multiplayerUserIds.Remove(user.UserID);
+                        break;
+
+                    case NotifyCollectionChangedAction.Reset:
+                        multiplayerUserIds.Clear();
+                        break;
+                }
+            });
+
+            multiplayerClient.SetupGet(c => c.CurrentMatchPlayingUserIds)
+                             .Returns(() => multiplayerUserIds);
+        }
+
+        [SetUpSteps]
+        public virtual void SetUpSteps()
+        {
+            AddStep("set local user", () => ((DummyAPIAccess)API).LocalUser.Value = new APIUser
+            {
+                Username = "local",
+            });
+
+            AddStep("populate users", () =>
+            {
+                MultiplayerUsers.Clear();
+                for (int i = 0; i < 16; i++)
+                    MultiplayerUsers.Add(CreateUser(i));
+            });
+
+            AddStep("create leaderboard", () =>
+            {
+                Leaderboard?.Expire();
+
+                OsuScoreProcessor scoreProcessor;
+                Beatmap.Value = CreateWorkingBeatmap(Ruleset.Value);
+
+                var playableBeatmap = Beatmap.Value.GetPlayableBeatmap(Ruleset.Value);
+
+                Child = scoreProcessor = new OsuScoreProcessor();
+
+                scoreProcessor.ApplyBeatmap(playableBeatmap);
+
+                LoadComponentAsync(Leaderboard = CreateLeaderboard(scoreProcessor), Add);
+            });
+
+            AddUntilStep("wait for load", () => Leaderboard.IsLoaded);
+        }
+
+        protected virtual MultiplayerRoomUser CreateUser(int i) => new MultiplayerRoomUser(i);
+
+        protected abstract MultiplayerGameplayLeaderboard CreateLeaderboard(OsuScoreProcessor scoreProcessor);
+
+        [Test]
+        public void TestScoreUpdates()
+        {
+            AddRepeatStep("update state", UpdateUserStatesRandomly, 100);
+            AddToggleStep("switch compact mode", expanded => Leaderboard.Expanded.Value = expanded);
+        }
+
+        [Test]
+        public void TestUserQuit()
+        {
+            AddUntilStep("mark users quit", () =>
+            {
+                if (MultiplayerUsers.Count == 0)
+                    return true;
+
+                MultiplayerUsers.RemoveAt(0);
+                return false;
+            });
+        }
+
+        [Test]
+        public void TestChangeScoringMode()
+        {
+            AddRepeatStep("update state", UpdateUserStatesRandomly, 5);
+            AddStep("change to classic", () => config.SetValue(OsuSetting.ScoreDisplayMode, ScoringMode.Classic));
+            AddStep("change to standardised", () => config.SetValue(OsuSetting.ScoreDisplayMode, ScoringMode.Standardised));
+        }
+
+        protected void UpdateUserStatesRandomly()
+        {
+            foreach (var user in MultiplayerUsers)
+            {
+                if (RNG.NextBool())
+                    continue;
+
+                int userId = user.UserID;
+
+                if (!lastHeaders.TryGetValue(userId, out var header))
+                {
+                    lastHeaders[userId] = header = new FrameHeader(new ScoreInfo
+                    {
+                        Statistics = new Dictionary<HitResult, int>
+                        {
+                            [HitResult.Miss] = 0,
+                            [HitResult.Meh] = 0,
+                            [HitResult.Great] = 0
+                        }
+                    });
+                }
+
+                switch (RNG.Next(0, 3))
+                {
+                    case 0:
+                        header.Combo = 0;
+                        header.Statistics[HitResult.Miss]++;
+                        break;
+
+                    case 1:
+                        header.Combo++;
+                        header.MaxCombo = Math.Max(header.MaxCombo, header.Combo);
+                        header.Statistics[HitResult.Meh]++;
+                        break;
+
+                    default:
+                        header.Combo++;
+                        header.MaxCombo = Math.Max(header.MaxCombo, header.Combo);
+                        header.Statistics[HitResult.Great]++;
+                        break;
+                }
+
+                spectatorClient.Raise(s => s.OnNewFrames -= null, userId, new FrameDataBundle(header, new[] { new LegacyReplayFrame(Time.Current, 0, 0, ReplayButtonState.None) }));
+            }
+        }
+    }
+}

From b52f070fdb79fa28aafc18d85ba0da7ac0a97d5f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 11 Apr 2022 19:15:57 +0900
Subject: [PATCH 4009/5547] Update existing multiplayer leaderboard tests to
 use new mocked implementation

---
 ...TestSceneMultiplayerGameplayLeaderboard.cs | 151 +-----------------
 ...ceneMultiplayerGameplayLeaderboardTeams.cs | 116 +++-----------
 2 files changed, 31 insertions(+), 236 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs
index bcd4474876..6e4aa48b0e 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs
@@ -1,161 +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 System;
-using System.Collections.Generic;
 using System.Linq;
-using NUnit.Framework;
-using osu.Framework.Allocation;
-using osu.Framework.Extensions;
-using osu.Framework.Extensions.ObjectExtensions;
 using osu.Framework.Graphics;
-using osu.Framework.Utils;
-using osu.Game.Configuration;
-using osu.Game.Online.API;
-using osu.Game.Online.API.Requests.Responses;
-using osu.Game.Online.Multiplayer;
-using osu.Game.Online.Spectator;
-using osu.Game.Replays.Legacy;
 using osu.Game.Rulesets.Osu.Scoring;
-using osu.Game.Rulesets.Scoring;
-using osu.Game.Scoring;
 using osu.Game.Screens.Play.HUD;
-using osu.Game.Tests.Visual.OnlinePlay;
-using osu.Game.Tests.Visual.Spectator;
 
 namespace osu.Game.Tests.Visual.Multiplayer
 {
-    public class TestSceneMultiplayerGameplayLeaderboard : MultiplayerTestScene
+    public class TestSceneMultiplayerGameplayLeaderboard : MultiplayerGameplayLeaderboardTestScene
     {
-        private static IEnumerable<int> users => Enumerable.Range(0, 16);
-
-        public new TestMultiplayerSpectatorClient SpectatorClient => (TestMultiplayerSpectatorClient)OnlinePlayDependencies?.SpectatorClient;
-
-        private MultiplayerGameplayLeaderboard leaderboard;
-        private OsuConfigManager config;
-
-        [BackgroundDependencyLoader]
-        private void load()
+        protected override MultiplayerGameplayLeaderboard CreateLeaderboard(OsuScoreProcessor scoreProcessor)
         {
-            Dependencies.Cache(config = new OsuConfigManager(LocalStorage));
-        }
-
-        public override void SetUpSteps()
-        {
-            base.SetUpSteps();
-
-            AddStep("set local user", () => ((DummyAPIAccess)API).LocalUser.Value = UserLookupCache.GetUserAsync(1).GetResultSafely());
-
-            AddStep("create leaderboard", () =>
+            return new MultiplayerGameplayLeaderboard(Ruleset.Value, scoreProcessor, MultiplayerUsers.ToArray())
             {
-                leaderboard?.Expire();
-
-                OsuScoreProcessor scoreProcessor;
-                Beatmap.Value = CreateWorkingBeatmap(Ruleset.Value);
-
-                var playableBeatmap = Beatmap.Value.GetPlayableBeatmap(Ruleset.Value);
-                var multiplayerUsers = new List<MultiplayerRoomUser>();
-
-                foreach (int user in users)
-                {
-                    SpectatorClient.SendStartPlay(user, Beatmap.Value.BeatmapInfo.OnlineID);
-                    multiplayerUsers.Add(OnlinePlayDependencies.MultiplayerClient.AddUser(new APIUser { Id = user }, true));
-                }
-
-                Children = new Drawable[]
-                {
-                    scoreProcessor = new OsuScoreProcessor(),
-                };
-
-                scoreProcessor.ApplyBeatmap(playableBeatmap);
-
-                LoadComponentAsync(leaderboard = new MultiplayerGameplayLeaderboard(Ruleset.Value, scoreProcessor, multiplayerUsers.ToArray())
-                {
-                    Anchor = Anchor.Centre,
-                    Origin = Anchor.Centre,
-                }, Add);
-            });
-
-            AddUntilStep("wait for load", () => leaderboard.IsLoaded);
-            AddUntilStep("wait for user population", () => MultiplayerClient.CurrentMatchPlayingUserIds.Count > 0);
-        }
-
-        [Test]
-        public void TestScoreUpdates()
-        {
-            AddRepeatStep("update state", () => SpectatorClient.RandomlyUpdateState(), 100);
-            AddToggleStep("switch compact mode", expanded => leaderboard.Expanded.Value = expanded);
-        }
-
-        [Test]
-        public void TestUserQuit()
-        {
-            foreach (int user in users)
-                AddStep($"mark user {user} quit", () => MultiplayerClient.RemoveUser(UserLookupCache.GetUserAsync(user).GetResultSafely().AsNonNull()));
-        }
-
-        [Test]
-        public void TestChangeScoringMode()
-        {
-            AddRepeatStep("update state", () => SpectatorClient.RandomlyUpdateState(), 5);
-            AddStep("change to classic", () => config.SetValue(OsuSetting.ScoreDisplayMode, ScoringMode.Classic));
-            AddStep("change to standardised", () => config.SetValue(OsuSetting.ScoreDisplayMode, ScoringMode.Standardised));
-        }
-
-        protected override OnlinePlayTestSceneDependencies CreateOnlinePlayDependencies() => new TestDependencies();
-
-        protected class TestDependencies : MultiplayerTestSceneDependencies
-        {
-            protected override TestSpectatorClient CreateSpectatorClient() => new TestMultiplayerSpectatorClient();
-        }
-
-        public class TestMultiplayerSpectatorClient : TestSpectatorClient
-        {
-            private readonly Dictionary<int, FrameHeader> lastHeaders = new Dictionary<int, FrameHeader>();
-
-            public void RandomlyUpdateState()
-            {
-                foreach ((int userId, _) in WatchedUserStates)
-                {
-                    if (RNG.NextBool())
-                        continue;
-
-                    if (!lastHeaders.TryGetValue(userId, out var header))
-                    {
-                        lastHeaders[userId] = header = new FrameHeader(new ScoreInfo
-                        {
-                            Statistics = new Dictionary<HitResult, int>
-                            {
-                                [HitResult.Miss] = 0,
-                                [HitResult.Meh] = 0,
-                                [HitResult.Great] = 0
-                            }
-                        });
-                    }
-
-                    switch (RNG.Next(0, 3))
-                    {
-                        case 0:
-                            header.Combo = 0;
-                            header.Statistics[HitResult.Miss]++;
-                            break;
-
-                        case 1:
-                            header.Combo++;
-                            header.MaxCombo = Math.Max(header.MaxCombo, header.Combo);
-                            header.Statistics[HitResult.Meh]++;
-                            break;
-
-                        default:
-                            header.Combo++;
-                            header.MaxCombo = Math.Max(header.MaxCombo, header.Combo);
-                            header.Statistics[HitResult.Great]++;
-                            break;
-                    }
-
-                    ((ISpectatorClient)this).UserSentFrames(userId, new FrameDataBundle(header, new[] { new LegacyReplayFrame(Time.Current, 0, 0, ReplayButtonState.None) }));
-                }
-            }
+                Anchor = Anchor.Centre,
+                Origin = Anchor.Centre,
+            };
         }
     }
 }
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboardTeams.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboardTeams.cs
index 7f5aced925..56a4f053c5 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboardTeams.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboardTeams.cs
@@ -1,121 +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.Linq;
-using NUnit.Framework;
-using osu.Framework.Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Utils;
-using osu.Game.Online.API;
-using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Multiplayer.MatchTypes.TeamVersus;
-using osu.Game.Online.Rooms;
 using osu.Game.Rulesets.Osu.Scoring;
 using osu.Game.Screens.OnlinePlay.Multiplayer;
 using osu.Game.Screens.Play.HUD;
-using osu.Game.Tests.Visual.OnlinePlay;
-using osu.Game.Tests.Visual.Spectator;
 
 namespace osu.Game.Tests.Visual.Multiplayer
 {
-    public class TestSceneMultiplayerGameplayLeaderboardTeams : MultiplayerTestScene
+    public class TestSceneMultiplayerGameplayLeaderboardTeams : MultiplayerGameplayLeaderboardTestScene
     {
-        private static IEnumerable<int> users => Enumerable.Range(0, 16);
-
-        public new TestSceneMultiplayerGameplayLeaderboard.TestMultiplayerSpectatorClient SpectatorClient =>
-            (TestSceneMultiplayerGameplayLeaderboard.TestMultiplayerSpectatorClient)OnlinePlayDependencies?.SpectatorClient;
-
-        protected override OnlinePlayTestSceneDependencies CreateOnlinePlayDependencies() => new TestDependencies();
-
-        protected class TestDependencies : MultiplayerTestSceneDependencies
+        protected override MultiplayerRoomUser CreateUser(int i)
         {
-            protected override TestSpectatorClient CreateSpectatorClient() => new TestSceneMultiplayerGameplayLeaderboard.TestMultiplayerSpectatorClient();
+            var user = base.CreateUser(i);
+            user.MatchState = new TeamVersusUserState
+            {
+                TeamID = RNG.Next(0, 2)
+            };
+            return user;
         }
 
-        private MultiplayerGameplayLeaderboard leaderboard;
-        private GameplayMatchScoreDisplay gameplayScoreDisplay;
-
-        protected override Room CreateRoom()
-        {
-            var room = base.CreateRoom();
-            room.Type.Value = MatchType.TeamVersus;
-            return room;
-        }
+        protected override MultiplayerGameplayLeaderboard CreateLeaderboard(OsuScoreProcessor scoreProcessor) =>
+            new MultiplayerGameplayLeaderboard(Ruleset.Value, scoreProcessor, MultiplayerUsers.ToArray())
+            {
+                Anchor = Anchor.Centre,
+                Origin = Anchor.Centre,
+            };
 
         public override void SetUpSteps()
         {
             base.SetUpSteps();
 
-            AddStep("set local user", () => ((DummyAPIAccess)API).LocalUser.Value = UserLookupCache.GetUserAsync(1).GetResultSafely());
-
-            AddStep("create leaderboard", () =>
+            AddStep("Add external display components", () =>
             {
-                leaderboard?.Expire();
-
-                OsuScoreProcessor scoreProcessor;
-                Beatmap.Value = CreateWorkingBeatmap(Ruleset.Value);
-
-                var playableBeatmap = Beatmap.Value.GetPlayableBeatmap(Ruleset.Value);
-                var multiplayerUsers = new List<MultiplayerRoomUser>();
-
-                foreach (int user in users)
+                LoadComponentAsync(new MatchScoreDisplay
                 {
-                    SpectatorClient.SendStartPlay(user, Beatmap.Value.BeatmapInfo.OnlineID);
-                    var roomUser = OnlinePlayDependencies.MultiplayerClient.AddUser(new APIUser { Id = user }, true);
+                    Team1Score = { BindTarget = Leaderboard.TeamScores[0] },
+                    Team2Score = { BindTarget = Leaderboard.TeamScores[1] }
+                }, Add);
 
-                    roomUser.MatchState = new TeamVersusUserState
-                    {
-                        TeamID = RNG.Next(0, 2)
-                    };
-
-                    multiplayerUsers.Add(roomUser);
-                }
-
-                Children = new Drawable[]
+                LoadComponentAsync(new GameplayMatchScoreDisplay
                 {
-                    scoreProcessor = new OsuScoreProcessor(),
-                };
-
-                scoreProcessor.ApplyBeatmap(playableBeatmap);
-
-                LoadComponentAsync(leaderboard = new MultiplayerGameplayLeaderboard(Ruleset.Value, scoreProcessor, multiplayerUsers.ToArray())
-                {
-                    Anchor = Anchor.Centre,
-                    Origin = Anchor.Centre,
-                }, gameplayLeaderboard =>
-                {
-                    LoadComponentAsync(new MatchScoreDisplay
-                    {
-                        Team1Score = { BindTarget = leaderboard.TeamScores[0] },
-                        Team2Score = { BindTarget = leaderboard.TeamScores[1] }
-                    }, Add);
-
-                    LoadComponentAsync(gameplayScoreDisplay = new GameplayMatchScoreDisplay
-                    {
-                        Anchor = Anchor.BottomCentre,
-                        Origin = Anchor.BottomCentre,
-                        Team1Score = { BindTarget = leaderboard.TeamScores[0] },
-                        Team2Score = { BindTarget = leaderboard.TeamScores[1] }
-                    }, Add);
-
-                    Add(gameplayLeaderboard);
-                });
-            });
-
-            AddUntilStep("wait for load", () => leaderboard.IsLoaded);
-            AddUntilStep("wait for user population", () => MultiplayerClient.CurrentMatchPlayingUserIds.Count > 0);
-        }
-
-        [Test]
-        public void TestScoreUpdates()
-        {
-            AddRepeatStep("update state", () => SpectatorClient.RandomlyUpdateState(), 100);
-            AddToggleStep("switch compact mode", expanded =>
-            {
-                leaderboard.Expanded.Value = expanded;
-                gameplayScoreDisplay.Expanded.Value = expanded;
+                    Anchor = Anchor.BottomCentre,
+                    Origin = Anchor.BottomCentre,
+                    Team1Score = { BindTarget = Leaderboard.TeamScores[0] },
+                    Team2Score = { BindTarget = Leaderboard.TeamScores[1] }
+                }, Add);
             });
         }
     }

From 6a61fd95eb3e5b0b6bfdab55c8ed78b89ce9025c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 11 Apr 2022 19:19:45 +0900
Subject: [PATCH 4010/5547] Tidy up base implementation

---
 ...MultiplayerGameplayLeaderboardTestScene.cs | 21 +++++++++----------
 ...ceneMultiplayerGameplayLeaderboardTeams.cs |  4 ++--
 2 files changed, 12 insertions(+), 13 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/MultiplayerGameplayLeaderboardTestScene.cs b/osu.Game.Tests/Visual/Multiplayer/MultiplayerGameplayLeaderboardTestScene.cs
index eb15282f75..7c8a61b231 100644
--- a/osu.Game.Tests/Visual/Multiplayer/MultiplayerGameplayLeaderboardTestScene.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/MultiplayerGameplayLeaderboardTestScene.cs
@@ -28,10 +28,15 @@ namespace osu.Game.Tests.Visual.Multiplayer
     public abstract class MultiplayerGameplayLeaderboardTestScene : OsuTestScene
     {
         protected readonly BindableList<MultiplayerRoomUser> MultiplayerUsers = new BindableList<MultiplayerRoomUser>();
-        private readonly BindableList<int> multiplayerUserIds = new BindableList<int>();
 
         protected MultiplayerGameplayLeaderboard Leaderboard { get; private set; }
 
+        protected virtual MultiplayerRoomUser CreateUser(int userId) => new MultiplayerRoomUser(userId);
+
+        protected abstract MultiplayerGameplayLeaderboard CreateLeaderboard(OsuScoreProcessor scoreProcessor);
+
+        private readonly BindableList<int> multiplayerUserIds = new BindableList<int>();
+
         private OsuConfigManager config;
 
         private readonly Mock<SpectatorClient> spectatorClient = new Mock<SpectatorClient>();
@@ -81,7 +86,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             AddStep("set local user", () => ((DummyAPIAccess)API).LocalUser.Value = new APIUser
             {
-                Username = "local",
+                Id = 1,
             });
 
             AddStep("populate users", () =>
@@ -95,25 +100,19 @@ namespace osu.Game.Tests.Visual.Multiplayer
             {
                 Leaderboard?.Expire();
 
-                OsuScoreProcessor scoreProcessor;
                 Beatmap.Value = CreateWorkingBeatmap(Ruleset.Value);
-
                 var playableBeatmap = Beatmap.Value.GetPlayableBeatmap(Ruleset.Value);
-
-                Child = scoreProcessor = new OsuScoreProcessor();
-
+                OsuScoreProcessor scoreProcessor = new OsuScoreProcessor();
                 scoreProcessor.ApplyBeatmap(playableBeatmap);
 
+                Child = scoreProcessor;
+
                 LoadComponentAsync(Leaderboard = CreateLeaderboard(scoreProcessor), Add);
             });
 
             AddUntilStep("wait for load", () => Leaderboard.IsLoaded);
         }
 
-        protected virtual MultiplayerRoomUser CreateUser(int i) => new MultiplayerRoomUser(i);
-
-        protected abstract MultiplayerGameplayLeaderboard CreateLeaderboard(OsuScoreProcessor scoreProcessor);
-
         [Test]
         public void TestScoreUpdates()
         {
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboardTeams.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboardTeams.cs
index 56a4f053c5..b37ba470ed 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboardTeams.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboardTeams.cs
@@ -14,9 +14,9 @@ namespace osu.Game.Tests.Visual.Multiplayer
 {
     public class TestSceneMultiplayerGameplayLeaderboardTeams : MultiplayerGameplayLeaderboardTestScene
     {
-        protected override MultiplayerRoomUser CreateUser(int i)
+        protected override MultiplayerRoomUser CreateUser(int userId)
         {
-            var user = base.CreateUser(i);
+            var user = base.CreateUser(userId);
             user.MatchState = new TeamVersusUserState
             {
                 TeamID = RNG.Next(0, 2)

From 09d560c93e7a04f7fa9389ba68678c13b76a6f7c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 11 Apr 2022 19:27:14 +0900
Subject: [PATCH 4011/5547] Add test coverage of spectator requests

---
 .../MultiplayerGameplayLeaderboardTestScene.cs     | 14 ++++++++++++++
 osu.Game/Online/Spectator/SpectatorClient.cs       |  2 +-
 2 files changed, 15 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/MultiplayerGameplayLeaderboardTestScene.cs b/osu.Game.Tests/Visual/Multiplayer/MultiplayerGameplayLeaderboardTestScene.cs
index 7c8a61b231..98e6cd514b 100644
--- a/osu.Game.Tests/Visual/Multiplayer/MultiplayerGameplayLeaderboardTestScene.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/MultiplayerGameplayLeaderboardTestScene.cs
@@ -84,6 +84,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [SetUpSteps]
         public virtual void SetUpSteps()
         {
+            AddStep("reset counts", () => spectatorClient.Invocations.Clear());
+
             AddStep("set local user", () => ((DummyAPIAccess)API).LocalUser.Value = new APIUser
             {
                 Id = 1,
@@ -111,6 +113,12 @@ namespace osu.Game.Tests.Visual.Multiplayer
             });
 
             AddUntilStep("wait for load", () => Leaderboard.IsLoaded);
+
+            AddStep("check watch requests were sent", () =>
+            {
+                foreach (var user in MultiplayerUsers)
+                    spectatorClient.Verify(s => s.WatchUser(user.UserID), Times.Once);
+            });
         }
 
         [Test]
@@ -131,6 +139,12 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 MultiplayerUsers.RemoveAt(0);
                 return false;
             });
+
+            AddStep("check stop watching requests were sent", () =>
+            {
+                foreach (var user in MultiplayerUsers)
+                    spectatorClient.Verify(s => s.StopWatchingUser(user.UserID), Times.Once);
+            });
         }
 
         [Test]
diff --git a/osu.Game/Online/Spectator/SpectatorClient.cs b/osu.Game/Online/Spectator/SpectatorClient.cs
index 138e8ac7d6..78beda6298 100644
--- a/osu.Game/Online/Spectator/SpectatorClient.cs
+++ b/osu.Game/Online/Spectator/SpectatorClient.cs
@@ -221,7 +221,7 @@ namespace osu.Game.Online.Spectator
             });
         }
 
-        public void WatchUser(int userId)
+        public virtual void WatchUser(int userId)
         {
             Debug.Assert(ThreadSafety.IsUpdateThread);
 

From 01cec7d3fb0e11f8e8f0b55a4ad509b6f6865a8e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 11 Apr 2022 19:37:01 +0900
Subject: [PATCH 4012/5547] Remove unnecessary string literals

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

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneLeadIn.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneLeadIn.cs
index 5ec9c6c474..b90bd93002 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneLeadIn.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneLeadIn.cs
@@ -34,7 +34,7 @@ namespace osu.Game.Tests.Visual.Gameplay
                 BeatmapInfo = { AudioLeadIn = leadIn }
             });
 
-            AddStep($"check first frame time", () =>
+            AddStep("check first frame time", () =>
             {
                 Assert.That(player.FirstFrameClockTime, Is.Not.Null);
                 Assert.That(player.FirstFrameClockTime.Value, Is.EqualTo(expectedStartTime).Within(lenience_ms));
@@ -57,7 +57,7 @@ namespace osu.Game.Tests.Visual.Gameplay
 
             loadPlayerWithBeatmap(new TestBeatmap(new OsuRuleset().RulesetInfo), storyboard);
 
-            AddStep($"check first frame time", () =>
+            AddStep("check first frame time", () =>
             {
                 Assert.That(player.FirstFrameClockTime, Is.Not.Null);
                 Assert.That(player.FirstFrameClockTime.Value, Is.EqualTo(expectedStartTime).Within(lenience_ms));
@@ -95,7 +95,7 @@ namespace osu.Game.Tests.Visual.Gameplay
 
             loadPlayerWithBeatmap(new TestBeatmap(new OsuRuleset().RulesetInfo), storyboard);
 
-            AddStep($"check first frame time", () =>
+            AddStep("check first frame time", () =>
             {
                 Assert.That(player.FirstFrameClockTime, Is.Not.Null);
                 Assert.That(player.FirstFrameClockTime.Value, Is.EqualTo(expectedStartTime).Within(lenience_ms));

From 4ab6c1107905210e10ea4286521bac7fb4d14550 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 11 Apr 2022 23:57:15 +0900
Subject: [PATCH 4013/5547] Add failing test coverage of skin import after
 exporting from lazer

---
 osu.Game.Tests/Skins/IO/ImportSkinTest.cs | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/osu.Game.Tests/Skins/IO/ImportSkinTest.cs b/osu.Game.Tests/Skins/IO/ImportSkinTest.cs
index 9b0facd625..dde8715764 100644
--- a/osu.Game.Tests/Skins/IO/ImportSkinTest.cs
+++ b/osu.Game.Tests/Skins/IO/ImportSkinTest.cs
@@ -11,6 +11,7 @@ using osu.Framework.Allocation;
 using osu.Framework.Extensions;
 using osu.Framework.Platform;
 using osu.Game.Database;
+using osu.Game.Extensions;
 using osu.Game.IO;
 using osu.Game.IO.Archives;
 using osu.Game.Skinning;
@@ -110,6 +111,27 @@ namespace osu.Game.Tests.Skins.IO
             assertImportedOnce(import1, import2);
         });
 
+        [Test]
+        public Task TestImportExportedSkinFilename() => runSkinTest(async osu =>
+        {
+            MemoryStream exportStream = new MemoryStream();
+
+            var import1 = await loadSkinIntoOsu(osu, new ZipArchiveReader(createOskWithIni("name 1", "author 1"), "custom.osk"));
+            assertCorrectMetadata(import1, "name 1 [custom]", "author 1", osu);
+
+            import1.PerformRead(s =>
+            {
+                new LegacySkinExporter(osu.Dependencies.Get<Storage>()).ExportModelTo(s, exportStream);
+            });
+
+            string exportFilename = import1.GetDisplayString();
+
+            var import2 = await loadSkinIntoOsu(osu, new ZipArchiveReader(exportStream, $"{exportFilename}.osk"));
+            assertCorrectMetadata(import2, "name 1 [custom]", "author 1", osu);
+
+            assertImportedOnce(import1, import2);
+        });
+
         [Test]
         public Task TestSameMetadataNameSameFolderName() => runSkinTest(async osu =>
         {

From 82939b05567eea3dd6ccd2773f4139cd5e9af250 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 11 Apr 2022 23:57:27 +0900
Subject: [PATCH 4014/5547] Fix skins getting duplicated when importing after
 export

Closes #17614.
---
 osu.Game/Skinning/SkinModelManager.cs | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Skinning/SkinModelManager.cs b/osu.Game/Skinning/SkinModelManager.cs
index 33e49ce486..23813e8eb2 100644
--- a/osu.Game/Skinning/SkinModelManager.cs
+++ b/osu.Game/Skinning/SkinModelManager.cs
@@ -104,7 +104,9 @@ namespace osu.Game.Skinning
                 // For imports, we want to use the archive or folder name as part of the metadata, in addition to any existing skin.ini metadata.
                 // In an ideal world, skin.ini would be the only source of metadata, but a lot of skin creators and users don't update it when making modifications.
                 // In both of these cases, the expectation from the user is that the filename or folder name is displayed somewhere to identify the skin.
-                if (archiveName != item.Name)
+                if (archiveName != item.Name
+                    // lazer exports use this format
+                    && archiveName != item.GetDisplayString())
                     item.Name = @$"{item.Name} [{archiveName}]";
             }
 

From 74dfa79f17c36949189e247b4ab9cdd0aaa8b949 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Mon, 11 Apr 2022 20:50:19 +0300
Subject: [PATCH 4015/5547] Add failing test case

---
 .../UserInterface/TestScenePopupDialog.cs     | 46 ++++++++++++++++---
 1 file changed, 40 insertions(+), 6 deletions(-)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestScenePopupDialog.cs b/osu.Game.Tests/Visual/UserInterface/TestScenePopupDialog.cs
index 6bd6115e68..b5f2544071 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestScenePopupDialog.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestScenePopupDialog.cs
@@ -4,25 +4,58 @@
 using NUnit.Framework;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Sprites;
+using osu.Framework.Testing;
 using osu.Game.Overlays.Dialog;
+using osuTK;
+using osuTK.Input;
 
 namespace osu.Game.Tests.Visual.UserInterface
 {
-    [TestFixture]
-    public class TestScenePopupDialog : OsuTestScene
+    public class TestScenePopupDialog : OsuManualInputManagerTestScene
     {
-        public TestScenePopupDialog()
+        private TestPopupDialog dialog;
+
+        [SetUpSteps]
+        public void SetUpSteps()
         {
             AddStep("new popup", () =>
-                Add(new TestPopupDialog
+            {
+                Add(dialog = new TestPopupDialog
                 {
                     RelativeSizeAxes = Axes.Both,
                     State = { Value = Framework.Graphics.Containers.Visibility.Visible },
-                }));
+                });
+            });
+        }
+
+        [Test]
+        public void TestDangerousButton([Values(false, true)] bool atEdge)
+        {
+            if (atEdge)
+            {
+                AddStep("move mouse to button edge", () =>
+                {
+                    var dangerousButtonQuad = dialog.DangerousButton.ScreenSpaceDrawQuad;
+                    InputManager.MoveMouseTo(new Vector2(dangerousButtonQuad.TopLeft.X + 5, dangerousButtonQuad.Centre.Y));
+                });
+            }
+            else
+                AddStep("move mouse to button", () => InputManager.MoveMouseTo(dialog.DangerousButton));
+
+            AddStep("click button", () => InputManager.Click(MouseButton.Left));
+            AddAssert("action not invoked", () => !dialog.DangerousButtonInvoked);
+
+            AddStep("hold button", () => InputManager.PressButton(MouseButton.Left));
+            AddUntilStep("action invoked", () => dialog.DangerousButtonInvoked);
+            AddStep("release button", () => InputManager.ReleaseButton(MouseButton.Left));
         }
 
         private class TestPopupDialog : PopupDialog
         {
+            public PopupDialogDangerousButton DangerousButton { get; }
+
+            public bool DangerousButtonInvoked;
+
             public TestPopupDialog()
             {
                 Icon = FontAwesome.Solid.AssistiveListeningSystems;
@@ -40,9 +73,10 @@ namespace osu.Game.Tests.Visual.UserInterface
                     {
                         Text = @"You're a fake!",
                     },
-                    new PopupDialogDangerousButton
+                    DangerousButton = new PopupDialogDangerousButton
                     {
                         Text = @"Careful with this one..",
+                        Action = () => DangerousButtonInvoked = true,
                     },
                 };
             }

From bad30d9e602537a6e2afbfb41333d89d9235a4c4 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Mon, 11 Apr 2022 21:05:37 +0300
Subject: [PATCH 4016/5547] Fix dialog dangerous button being clickable at
 edges

---
 .../Dialog/PopupDialogDangerousButton.cs      | 33 ++++++++++---------
 1 file changed, 17 insertions(+), 16 deletions(-)

diff --git a/osu.Game/Overlays/Dialog/PopupDialogDangerousButton.cs b/osu.Game/Overlays/Dialog/PopupDialogDangerousButton.cs
index 1911a4fa56..adc627e15b 100644
--- a/osu.Game/Overlays/Dialog/PopupDialogDangerousButton.cs
+++ b/osu.Game/Overlays/Dialog/PopupDialogDangerousButton.cs
@@ -12,37 +12,38 @@ namespace osu.Game.Overlays.Dialog
 {
     public class PopupDialogDangerousButton : PopupDialogButton
     {
+        private Box progressBox;
+        private DangerousConfirmContainer confirmContainer;
+
         [BackgroundDependencyLoader]
         private void load(OsuColour colours)
         {
             ButtonColour = colours.Red3;
 
-            ColourContainer.Add(new ConfirmFillBox
+            ColourContainer.Add(progressBox = new Box
             {
-                Action = () => Action(),
                 RelativeSizeAxes = Axes.Both,
                 Blending = BlendingParameters.Additive,
             });
+
+            AddInternal(confirmContainer = new DangerousConfirmContainer
+            {
+                Action = () => Action(),
+                RelativeSizeAxes = Axes.Both,
+            });
         }
 
-        private class ConfirmFillBox : HoldToConfirmContainer
+        protected override void LoadComplete()
         {
-            private Box box;
+            base.LoadComplete();
 
+            confirmContainer.Progress.BindValueChanged(progress => progressBox.Width = (float)progress.NewValue, true);
+        }
+
+        private class DangerousConfirmContainer : HoldToConfirmContainer
+        {
             protected override double? HoldActivationDelay => 500;
 
-            protected override void LoadComplete()
-            {
-                base.LoadComplete();
-
-                Child = box = new Box
-                {
-                    RelativeSizeAxes = Axes.Both,
-                };
-
-                Progress.BindValueChanged(progress => box.Width = (float)progress.NewValue, true);
-            }
-
             protected override bool OnMouseDown(MouseDownEvent e)
             {
                 BeginConfirm();

From a0e3a2102acd70cf3fc24e35bd70c647d7d40db3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 12 Apr 2022 10:49:57 +0900
Subject: [PATCH 4017/5547] Also expand match score component when leaderboard
 is (in test)

---
 .../TestSceneMultiplayerGameplayLeaderboardTeams.cs            | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboardTeams.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboardTeams.cs
index b37ba470ed..5cd3bb2f0f 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboardTeams.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboardTeams.cs
@@ -48,7 +48,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     Anchor = Anchor.BottomCentre,
                     Origin = Anchor.BottomCentre,
                     Team1Score = { BindTarget = Leaderboard.TeamScores[0] },
-                    Team2Score = { BindTarget = Leaderboard.TeamScores[1] }
+                    Team2Score = { BindTarget = Leaderboard.TeamScores[1] },
+                    Expanded = { BindTarget = Leaderboard.Expanded },
                 }, Add);
             });
         }

From ebee9e68886925a368e87596c0e68d03c3fe025f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 12 Apr 2022 11:04:53 +0900
Subject: [PATCH 4018/5547] Fix `MultiplayerGameplayLeaderboard` not
 immediately updating totals on scoring mode change

---
 osu.Game/Screens/Play/HUD/MultiplayerGameplayLeaderboard.cs | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/Play/HUD/MultiplayerGameplayLeaderboard.cs b/osu.Game/Screens/Play/HUD/MultiplayerGameplayLeaderboard.cs
index 4f5edab526..d0726248aa 100644
--- a/osu.Game/Screens/Play/HUD/MultiplayerGameplayLeaderboard.cs
+++ b/osu.Game/Screens/Play/HUD/MultiplayerGameplayLeaderboard.cs
@@ -75,7 +75,10 @@ namespace osu.Game.Screens.Play.HUD
             foreach (var user in playingUsers)
             {
                 var trackedUser = CreateUserData(user, ruleset, scoreProcessor);
+
                 trackedUser.ScoringMode.BindTo(scoringMode);
+                trackedUser.Score.BindValueChanged(_ => Scheduler.AddOnce(updateTotals));
+
                 UserScores[user.UserID] = trackedUser;
 
                 if (trackedUser.Team is int team && !TeamScores.ContainsKey(team))
@@ -175,8 +178,6 @@ namespace osu.Game.Screens.Play.HUD
 
             trackedData.Frames.Add(new TimedFrame(bundle.Frames.First().Time, bundle.Header));
             trackedData.UpdateScore();
-
-            updateTotals();
         });
 
         private void updateTotals()

From 577e29351ef5cf6e64336572b71a35214d94a1c6 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 12 Apr 2022 11:46:21 +0900
Subject: [PATCH 4019/5547] Ensure players are always on both leaderboard teams

In a very rare case, the randomisation may cause all users to be on one
team, causing a test failure. The odds make it basically impossible, but
if adjusting the number of users in the test scene this can more readily
be hit.
---
 .../TestSceneMultiplayerGameplayLeaderboardTeams.cs          | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboardTeams.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboardTeams.cs
index 5cd3bb2f0f..5caab9487e 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboardTeams.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboardTeams.cs
@@ -3,7 +3,6 @@
 
 using System.Linq;
 using osu.Framework.Graphics;
-using osu.Framework.Utils;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Multiplayer.MatchTypes.TeamVersus;
 using osu.Game.Rulesets.Osu.Scoring;
@@ -14,12 +13,14 @@ namespace osu.Game.Tests.Visual.Multiplayer
 {
     public class TestSceneMultiplayerGameplayLeaderboardTeams : MultiplayerGameplayLeaderboardTestScene
     {
+        private int team;
+
         protected override MultiplayerRoomUser CreateUser(int userId)
         {
             var user = base.CreateUser(userId);
             user.MatchState = new TeamVersusUserState
             {
-                TeamID = RNG.Next(0, 2)
+                TeamID = team++ % 2
             };
             return user;
         }

From 0ba95a448306c888163b442a2c8bb8c6b3768c23 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 12 Apr 2022 11:54:30 +0900
Subject: [PATCH 4020/5547] Ensure all users are shown on leaderboard (even
 when API lookup fails)

---
 .../Screens/Play/HUD/MultiplayerGameplayLeaderboard.cs   | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Screens/Play/HUD/MultiplayerGameplayLeaderboard.cs b/osu.Game/Screens/Play/HUD/MultiplayerGameplayLeaderboard.cs
index d0726248aa..11498a02cd 100644
--- a/osu.Game/Screens/Play/HUD/MultiplayerGameplayLeaderboard.cs
+++ b/osu.Game/Screens/Play/HUD/MultiplayerGameplayLeaderboard.cs
@@ -89,10 +89,13 @@ namespace osu.Game.Screens.Play.HUD
             {
                 var users = task.GetResultSafely();
 
-                foreach (var user in users)
+                for (int i = 0; i < users.Length; i++)
                 {
-                    if (user == null)
-                        continue;
+                    var user = users[i] ??= new APIUser
+                    {
+                        Id = playingUsers[i].UserID,
+                        Username = "Unknown user",
+                    };
 
                     var trackedUser = UserScores[user.Id];
 

From f29e32970003986caf7297139b3fa3c57c6f7a2d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 12 Apr 2022 12:11:51 +0900
Subject: [PATCH 4021/5547] Move user count to a constant to allow easier
 adjustment

---
 .../Multiplayer/MultiplayerGameplayLeaderboardTestScene.cs    | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/MultiplayerGameplayLeaderboardTestScene.cs b/osu.Game.Tests/Visual/Multiplayer/MultiplayerGameplayLeaderboardTestScene.cs
index 98e6cd514b..ab187a2f76 100644
--- a/osu.Game.Tests/Visual/Multiplayer/MultiplayerGameplayLeaderboardTestScene.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/MultiplayerGameplayLeaderboardTestScene.cs
@@ -27,6 +27,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
 {
     public abstract class MultiplayerGameplayLeaderboardTestScene : OsuTestScene
     {
+        private const int total_users = 16;
+
         protected readonly BindableList<MultiplayerRoomUser> MultiplayerUsers = new BindableList<MultiplayerRoomUser>();
 
         protected MultiplayerGameplayLeaderboard Leaderboard { get; private set; }
@@ -94,7 +96,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddStep("populate users", () =>
             {
                 MultiplayerUsers.Clear();
-                for (int i = 0; i < 16; i++)
+                for (int i = 0; i < total_users; i++)
                     MultiplayerUsers.Add(CreateUser(i));
             });
 

From 22c75a518ed4fd35f59eaa0fa1a98a4f404b1b53 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 12 Apr 2022 12:38:15 +0900
Subject: [PATCH 4022/5547] Fix headers not getting reset on re-run of test

---
 .../Multiplayer/MultiplayerGameplayLeaderboardTestScene.cs  | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/MultiplayerGameplayLeaderboardTestScene.cs b/osu.Game.Tests/Visual/Multiplayer/MultiplayerGameplayLeaderboardTestScene.cs
index ab187a2f76..4e6342868a 100644
--- a/osu.Game.Tests/Visual/Multiplayer/MultiplayerGameplayLeaderboardTestScene.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/MultiplayerGameplayLeaderboardTestScene.cs
@@ -86,7 +86,11 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [SetUpSteps]
         public virtual void SetUpSteps()
         {
-            AddStep("reset counts", () => spectatorClient.Invocations.Clear());
+            AddStep("reset counts", () =>
+            {
+                spectatorClient.Invocations.Clear();
+                lastHeaders.Clear();
+            });
 
             AddStep("set local user", () => ((DummyAPIAccess)API).LocalUser.Value = new APIUser
             {

From 0e1d17d1d191f87bcff7c324b9ad7a2da5de0b37 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 12 Apr 2022 13:11:22 +0900
Subject: [PATCH 4023/5547] Use zh-Hant instead of zh-TW

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

diff --git a/osu.Game/Localisation/Language.cs b/osu.Game/Localisation/Language.cs
index dc1fac47a8..ab96d01c82 100644
--- a/osu.Game/Localisation/Language.cs
+++ b/osu.Game/Localisation/Language.cs
@@ -110,6 +110,6 @@ namespace osu.Game.Localisation
         // zh_hk,
 
         [Description(@"繁體中文（台灣）")]
-        zh_tw
+        zh_hant
     }
 }

From 8b1cee75faa0b855d29a4d288f773d03cba348b3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 12 Apr 2022 14:13:07 +0900
Subject: [PATCH 4024/5547] Use `BindableLong` instead of `BindableInt` for
 user score tracking

---
 .../Visual/Multiplayer/TestSceneMultiplayerTeamResults.cs   | 6 +++---
 .../OnlinePlay/Multiplayer/MultiplayerTeamResultsScreen.cs  | 4 ++--
 osu.Game/Screens/Play/HUD/MatchScoreDisplay.cs              | 6 +++---
 osu.Game/Screens/Play/HUD/MultiplayerGameplayLeaderboard.cs | 4 ++--
 4 files changed, 10 insertions(+), 10 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerTeamResults.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerTeamResults.cs
index bdc348b043..bcb36a585f 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerTeamResults.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerTeamResults.cs
@@ -26,10 +26,10 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 var beatmapInfo = CreateBeatmap(rulesetInfo).BeatmapInfo;
                 var score = TestResources.CreateTestScoreInfo(beatmapInfo);
 
-                SortedDictionary<int, BindableInt> teamScores = new SortedDictionary<int, BindableInt>
+                SortedDictionary<int, BindableLong> teamScores = new SortedDictionary<int, BindableLong>
                 {
-                    { 0, new BindableInt(team1Score) },
-                    { 1, new BindableInt(team2Score) }
+                    { 0, new BindableLong(team1Score) },
+                    { 1, new BindableLong(team2Score) }
                 };
 
                 Stack.Push(screen = new MultiplayerTeamResultsScreen(score, 1, new PlaylistItem(beatmapInfo), teamScores));
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerTeamResultsScreen.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerTeamResultsScreen.cs
index 14a779dedf..3f0f3e043c 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerTeamResultsScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerTeamResultsScreen.cs
@@ -24,12 +24,12 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
 {
     public class MultiplayerTeamResultsScreen : MultiplayerResultsScreen
     {
-        private readonly SortedDictionary<int, BindableInt> teamScores;
+        private readonly SortedDictionary<int, BindableLong> teamScores;
 
         private Container winnerBackground;
         private Drawable winnerText;
 
-        public MultiplayerTeamResultsScreen(ScoreInfo score, long roomId, PlaylistItem playlistItem, SortedDictionary<int, BindableInt> teamScores)
+        public MultiplayerTeamResultsScreen(ScoreInfo score, long roomId, PlaylistItem playlistItem, SortedDictionary<int, BindableLong> teamScores)
             : base(score, roomId, playlistItem)
         {
             if (teamScores.Count != 2)
diff --git a/osu.Game/Screens/Play/HUD/MatchScoreDisplay.cs b/osu.Game/Screens/Play/HUD/MatchScoreDisplay.cs
index 88cf9529bf..2129000268 100644
--- a/osu.Game/Screens/Play/HUD/MatchScoreDisplay.cs
+++ b/osu.Game/Screens/Play/HUD/MatchScoreDisplay.cs
@@ -19,8 +19,8 @@ namespace osu.Game.Screens.Play.HUD
         private const float bar_height = 18;
         private const float font_size = 50;
 
-        public BindableInt Team1Score = new BindableInt();
-        public BindableInt Team2Score = new BindableInt();
+        public BindableLong Team1Score = new BindableLong();
+        public BindableLong Team2Score = new BindableLong();
 
         protected MatchScoreCounter Score1Text;
         protected MatchScoreCounter Score2Text;
@@ -133,7 +133,7 @@ namespace osu.Game.Screens.Play.HUD
             var winningBar = Team1Score.Value > Team2Score.Value ? score1Bar : score2Bar;
             var losingBar = Team1Score.Value <= Team2Score.Value ? score1Bar : score2Bar;
 
-            int diff = Math.Max(Team1Score.Value, Team2Score.Value) - Math.Min(Team1Score.Value, Team2Score.Value);
+            long diff = Math.Max(Team1Score.Value, Team2Score.Value) - Math.Min(Team1Score.Value, Team2Score.Value);
 
             losingBar.ResizeWidthTo(0, 400, Easing.OutQuint);
             winningBar.ResizeWidthTo(Math.Min(0.4f, MathF.Pow(diff / 1500000f, 0.5f) / 2), 400, Easing.OutQuint);
diff --git a/osu.Game/Screens/Play/HUD/MultiplayerGameplayLeaderboard.cs b/osu.Game/Screens/Play/HUD/MultiplayerGameplayLeaderboard.cs
index 11498a02cd..e569e5368b 100644
--- a/osu.Game/Screens/Play/HUD/MultiplayerGameplayLeaderboard.cs
+++ b/osu.Game/Screens/Play/HUD/MultiplayerGameplayLeaderboard.cs
@@ -29,7 +29,7 @@ namespace osu.Game.Screens.Play.HUD
     {
         protected readonly Dictionary<int, TrackedUserData> UserScores = new Dictionary<int, TrackedUserData>();
 
-        public readonly SortedDictionary<int, BindableInt> TeamScores = new SortedDictionary<int, BindableInt>();
+        public readonly SortedDictionary<int, BindableLong> TeamScores = new SortedDictionary<int, BindableLong>();
 
         [Resolved]
         private OsuColour colours { get; set; }
@@ -82,7 +82,7 @@ namespace osu.Game.Screens.Play.HUD
                 UserScores[user.UserID] = trackedUser;
 
                 if (trackedUser.Team is int team && !TeamScores.ContainsKey(team))
-                    TeamScores.Add(team, new BindableInt());
+                    TeamScores.Add(team, new BindableLong());
             }
 
             userLookupCache.GetUsersAsync(playingUsers.Select(u => u.UserID).ToArray()).ContinueWith(task => Schedule(() =>

From 45d79c1a737a8e6128e1ce631b5e37185fd48d9f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 12 Apr 2022 18:01:29 +0900
Subject: [PATCH 4025/5547] Ensure previous test score is cleaned up to allow
 visual test runs to work better

---
 .../Gameplay/TestSceneReplayDownloadButton.cs       | 13 ++++++++++++-
 1 file changed, 12 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneReplayDownloadButton.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneReplayDownloadButton.cs
index 5d25287e45..e89350de1a 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneReplayDownloadButton.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneReplayDownloadButton.cs
@@ -26,6 +26,8 @@ namespace osu.Game.Tests.Visual.Gameplay
     [TestFixture]
     public class TestSceneReplayDownloadButton : OsuManualInputManagerTestScene
     {
+        private const long online_score_id = 2553163309;
+
         [Resolved]
         private RulesetStore rulesets { get; set; }
 
@@ -43,6 +45,15 @@ namespace osu.Game.Tests.Visual.Gameplay
             beatmapManager.Import(TestResources.GetQuickTestBeatmapForImport()).WaitSafely();
         }
 
+        [SetUpSteps]
+        public void SetUpSteps()
+        {
+            AddStep("delete previous imports", () =>
+            {
+                scoreManager.Delete(s => s.OnlineID == online_score_id);
+            });
+        }
+
         [Test]
         public void TestDisplayStates()
         {
@@ -180,7 +191,7 @@ namespace osu.Game.Tests.Visual.Gameplay
         {
             return new APIScore
             {
-                OnlineID = 2553163309,
+                OnlineID = online_score_id,
                 RulesetID = 0,
                 Beatmap = CreateAPIBeatmapSet(new OsuRuleset().RulesetInfo).Beatmaps.First(),
                 HasReplay = replayAvailable,

From b51abfc72220646e1af51663fdc317bf58b0b3bd Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 12 Apr 2022 18:01:13 +0900
Subject: [PATCH 4026/5547] Fix `ScoreDownloadTracker` matching on empty hash
 equality

---
 osu.Game/Online/ScoreDownloadTracker.cs | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Online/ScoreDownloadTracker.cs b/osu.Game/Online/ScoreDownloadTracker.cs
index d7e31c8a59..ed1c566dbe 100644
--- a/osu.Game/Online/ScoreDownloadTracker.cs
+++ b/osu.Game/Online/ScoreDownloadTracker.cs
@@ -47,7 +47,10 @@ namespace osu.Game.Online
             Downloader.DownloadBegan += downloadBegan;
             Downloader.DownloadFailed += downloadFailed;
 
-            realmSubscription = realm.RegisterForNotifications(r => r.All<ScoreInfo>().Where(s => ((s.OnlineID > 0 && s.OnlineID == TrackedItem.OnlineID) || s.Hash == TrackedItem.Hash) && !s.DeletePending), (items, changes, ___) =>
+            realmSubscription = realm.RegisterForNotifications(r => r.All<ScoreInfo>().Where(s =>
+                ((s.OnlineID > 0 && s.OnlineID == TrackedItem.OnlineID)
+                 || (!string.IsNullOrEmpty(s.Hash) && s.Hash == TrackedItem.Hash))
+                && !s.DeletePending), (items, changes, ___) =>
             {
                 if (items.Any())
                     Schedule(() => UpdateState(DownloadState.LocallyAvailable));

From 6dbfc261585fd239e8b7b13a6f400938f581e238 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 12 Apr 2022 18:07:55 +0900
Subject: [PATCH 4027/5547] Add log output when a model is undeleted

---
 osu.Game/Stores/RealmArchiveModelImporter.cs | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/osu.Game/Stores/RealmArchiveModelImporter.cs b/osu.Game/Stores/RealmArchiveModelImporter.cs
index 1d0e16d549..353a2164bb 100644
--- a/osu.Game/Stores/RealmArchiveModelImporter.cs
+++ b/osu.Game/Stores/RealmArchiveModelImporter.cs
@@ -389,7 +389,10 @@ namespace osu.Game.Stores
                                 LogForModel(item, @$"Found existing {HumanisedModelName} for {item} (ID {existing.ID}) – skipping import.");
 
                                 if (existing.DeletePending)
+                                {
+                                    LogForModel(item, $@"Existing {HumanisedModelName}'s deletion flag has been removed");
                                     UndeleteForReuse(existing);
+                                }
 
                                 transaction.Commit();
 

From 20eca9bf6a3b7cde91545a85b58648f72fda7ac2 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 12 Apr 2022 19:26:02 +0900
Subject: [PATCH 4028/5547] Refactor `TestSceneRankRangePill` to not depend on
 `TestMultiplayerClient`

---
 .../Multiplayer/TestSceneRankRangePill.cs     | 76 ++++++++++---------
 .../Online/Multiplayer/MultiplayerClient.cs   |  4 +-
 2 files changed, 44 insertions(+), 36 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneRankRangePill.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneRankRangePill.cs
index f95e73ff3c..b758c83a0a 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneRankRangePill.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneRankRangePill.cs
@@ -1,67 +1,68 @@
 // 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 Moq;
 using NUnit.Framework;
+using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Game.Online.API.Requests.Responses;
+using osu.Game.Online.Multiplayer;
+using osu.Game.Online.Rooms;
 using osu.Game.Screens.OnlinePlay.Lounge.Components;
 
 namespace osu.Game.Tests.Visual.Multiplayer
 {
-    public class TestSceneRankRangePill : MultiplayerTestScene
+    public class TestSceneRankRangePill : OsuTestScene
     {
-        [SetUp]
-        public new void Setup() => Schedule(() =>
+        private readonly Mock<MultiplayerClient> multiplayerClient = new Mock<MultiplayerClient>();
+
+        protected override IReadOnlyDependencyContainer CreateChildDependencies(IReadOnlyDependencyContainer parent) =>
+            // not used but required by the component.
+            new CachedModelDependencyContainer<Room>(base.CreateChildDependencies(parent));
+
+        [BackgroundDependencyLoader]
+        private void load()
         {
+            Dependencies.CacheAs(multiplayerClient.Object);
+
             Child = new RankRangePill
             {
                 Anchor = Anchor.Centre,
                 Origin = Anchor.Centre
             };
-        });
+        }
 
         [Test]
         public void TestSingleUser()
         {
-            AddStep("add user", () =>
+            setupRoomWithUsers(new APIUser
             {
-                MultiplayerClient.AddUser(new APIUser
-                {
-                    Id = 2,
-                    Statistics = { GlobalRank = 1234 }
-                });
-
-                // Remove the local user so only the one above is displayed.
-                MultiplayerClient.RemoveUser(API.LocalUser.Value);
+                Id = 2,
+                Statistics = { GlobalRank = 1234 }
             });
         }
 
         [Test]
         public void TestMultipleUsers()
         {
-            AddStep("add users", () =>
-            {
-                MultiplayerClient.AddUser(new APIUser
+            setupRoomWithUsers(
+                new APIUser
                 {
                     Id = 2,
                     Statistics = { GlobalRank = 1234 }
-                });
-
-                MultiplayerClient.AddUser(new APIUser
+                },
+                new APIUser
                 {
                     Id = 3,
                     Statistics = { GlobalRank = 3333 }
-                });
-
-                MultiplayerClient.AddUser(new APIUser
+                },
+                new APIUser
                 {
                     Id = 4,
                     Statistics = { GlobalRank = 4321 }
                 });
-
-                // Remove the local user so only the ones above are displayed.
-                MultiplayerClient.RemoveUser(API.LocalUser.Value);
-            });
         }
 
         [TestCase(1, 10)]
@@ -73,22 +74,29 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [TestCase(1000000, 10000000)]
         public void TestRange(int min, int max)
         {
-            AddStep("add users", () =>
-            {
-                MultiplayerClient.AddUser(new APIUser
+            setupRoomWithUsers(
+                new APIUser
                 {
                     Id = 2,
                     Statistics = { GlobalRank = min }
-                });
-
-                MultiplayerClient.AddUser(new APIUser
+                },
+                new APIUser
                 {
                     Id = 3,
                     Statistics = { GlobalRank = max }
                 });
+        }
 
-                // Remove the local user so only the ones above are displayed.
-                MultiplayerClient.RemoveUser(API.LocalUser.Value);
+        private void setupRoomWithUsers(params APIUser[] users)
+        {
+            AddStep("setup room", () =>
+            {
+                multiplayerClient.SetupGet(m => m.Room).Returns(new MultiplayerRoom(0)
+                {
+                    Users = new List<MultiplayerRoomUser>(users.Select(apiUser => new MultiplayerRoomUser(apiUser.Id) { User = apiUser }))
+                });
+
+                multiplayerClient.Raise(m => m.RoomUpdated -= null);
             });
         }
     }
diff --git a/osu.Game/Online/Multiplayer/MultiplayerClient.cs b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
index 18db710cee..4c10949225 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
@@ -32,7 +32,7 @@ namespace osu.Game.Online.Multiplayer
         /// <summary>
         /// Invoked when any change occurs to the multiplayer room.
         /// </summary>
-        public event Action? RoomUpdated;
+        public virtual event Action? RoomUpdated;
 
         /// <summary>
         /// Invoked when a new user joins the room.
@@ -88,7 +88,7 @@ namespace osu.Game.Online.Multiplayer
         /// <summary>
         /// The joined <see cref="MultiplayerRoom"/>.
         /// </summary>
-        public MultiplayerRoom? Room
+        public virtual MultiplayerRoom? Room
         {
             get
             {

From bf677ad0ac8dc6383e5c249492f03d544becda9b Mon Sep 17 00:00:00 2001
From: Huo Yaoyuan <huoyaoyuan@hotmail.com>
Date: Tue, 12 Apr 2022 20:28:14 +0800
Subject: [PATCH 4029/5547] Remove usages of BinaryFormatter.

---
 osu.Game/IO/Legacy/SerializationReader.cs | 91 +----------------------
 osu.Game/IO/Legacy/SerializationWriter.cs | 11 +--
 2 files changed, 2 insertions(+), 100 deletions(-)

diff --git a/osu.Game/IO/Legacy/SerializationReader.cs b/osu.Game/IO/Legacy/SerializationReader.cs
index f7b3f33e87..64e25d5add 100644
--- a/osu.Game/IO/Legacy/SerializationReader.cs
+++ b/osu.Game/IO/Legacy/SerializationReader.cs
@@ -3,11 +3,8 @@
 
 using System;
 using System.Collections.Generic;
-using System.Diagnostics;
 using System.IO;
-using System.Reflection;
 using System.Runtime.Serialization;
-using System.Runtime.Serialization.Formatters.Binary;
 using System.Text;
 
 namespace osu.Game.IO.Legacy
@@ -186,98 +183,12 @@ namespace osu.Game.IO.Legacy
                     return ReadCharArray();
 
                 case ObjType.otherType:
-                    return DynamicDeserializer.Deserialize(BaseStream);
+                    throw new IOException("Deserialization of arbitrary type is not supported.");
 
                 default:
                     return null;
             }
         }
-
-        public static class DynamicDeserializer
-        {
-            private static VersionConfigToNamespaceAssemblyObjectBinder versionBinder;
-            private static BinaryFormatter formatter;
-
-            private static void initialize()
-            {
-                versionBinder = new VersionConfigToNamespaceAssemblyObjectBinder();
-                formatter = new BinaryFormatter
-                {
-                    // AssemblyFormat = FormatterAssemblyStyle.Simple,
-                    Binder = versionBinder
-                };
-            }
-
-            public static object Deserialize(Stream stream)
-            {
-                if (formatter == null)
-                    initialize();
-
-                Debug.Assert(formatter != null, "formatter != null");
-
-                // ReSharper disable once PossibleNullReferenceException
-                return formatter.Deserialize(stream);
-            }
-
-            #region Nested type: VersionConfigToNamespaceAssemblyObjectBinder
-
-            public sealed class VersionConfigToNamespaceAssemblyObjectBinder : SerializationBinder
-            {
-                private readonly Dictionary<string, Type> cache = new Dictionary<string, Type>();
-
-                public override Type BindToType(string assemblyName, string typeName)
-                {
-                    if (cache.TryGetValue(assemblyName + typeName, out var typeToDeserialize))
-                        return typeToDeserialize;
-
-                    List<Type> tmpTypes = new List<Type>();
-                    Type genType = null;
-
-                    if (typeName.Contains("System.Collections.Generic") && typeName.Contains("[["))
-                    {
-                        string[] splitTypes = typeName.Split('[');
-
-                        foreach (string typ in splitTypes)
-                        {
-                            if (typ.Contains("Version"))
-                            {
-                                string asmTmp = typ.Substring(typ.IndexOf(',') + 1);
-                                string asmName = asmTmp.Remove(asmTmp.IndexOf(']')).Trim();
-                                string typName = typ.Remove(typ.IndexOf(','));
-                                tmpTypes.Add(BindToType(asmName, typName));
-                            }
-                            else if (typ.Contains("Generic"))
-                            {
-                                genType = BindToType(assemblyName, typ);
-                            }
-                        }
-
-                        if (genType != null && tmpTypes.Count > 0)
-                        {
-                            return genType.MakeGenericType(tmpTypes.ToArray());
-                        }
-                    }
-
-                    string toAssemblyName = assemblyName.Split(',')[0];
-                    Assembly[] assemblies = AppDomain.CurrentDomain.GetAssemblies();
-
-                    foreach (Assembly a in assemblies)
-                    {
-                        if (a.FullName.Split(',')[0] == toAssemblyName)
-                        {
-                            typeToDeserialize = a.GetType(typeName);
-                            break;
-                        }
-                    }
-
-                    cache.Add(assemblyName + typeName, typeToDeserialize);
-
-                    return typeToDeserialize;
-                }
-            }
-
-            #endregion
-        }
     }
 
     public enum ObjType : byte
diff --git a/osu.Game/IO/Legacy/SerializationWriter.cs b/osu.Game/IO/Legacy/SerializationWriter.cs
index 9ebeaf616e..6dfb21e5bd 100644
--- a/osu.Game/IO/Legacy/SerializationWriter.cs
+++ b/osu.Game/IO/Legacy/SerializationWriter.cs
@@ -5,8 +5,6 @@ using System;
 using System.Collections.Generic;
 using System.IO;
 using System.Runtime.Serialization;
-using System.Runtime.Serialization.Formatters;
-using System.Runtime.Serialization.Formatters.Binary;
 using System.Text;
 
 // ReSharper disable ConditionIsAlwaysTrueOrFalse (we're allowing nulls to be passed to the writer where the underlying class doesn't).
@@ -218,14 +216,7 @@ namespace osu.Game.IO.Legacy
                         break;
 
                     default:
-                        Write((byte)ObjType.otherType);
-                        BinaryFormatter b = new BinaryFormatter
-                        {
-                            // AssemblyFormat = FormatterAssemblyStyle.Simple,
-                            TypeFormat = FormatterTypeStyle.TypesWhenNeeded
-                        };
-                        b.Serialize(BaseStream, obj);
-                        break;
+                        throw new IOException("Serialization of arbitrary type is not supported.");
                 } // switch
             } // if obj==null
         } // WriteObject

From 80e312dbbc5737e6d6c093a92961ace301b1482a Mon Sep 17 00:00:00 2001
From: Huo Yaoyuan <huoyaoyuan@hotmail.com>
Date: Tue, 12 Apr 2022 20:29:13 +0800
Subject: [PATCH 4030/5547] Remove unused binary serialization related code.

---
 osu.Game/IO/Legacy/SerializationReader.cs | 10 ----------
 osu.Game/IO/Legacy/SerializationWriter.cs |  8 --------
 2 files changed, 18 deletions(-)

diff --git a/osu.Game/IO/Legacy/SerializationReader.cs b/osu.Game/IO/Legacy/SerializationReader.cs
index 64e25d5add..5423485c95 100644
--- a/osu.Game/IO/Legacy/SerializationReader.cs
+++ b/osu.Game/IO/Legacy/SerializationReader.cs
@@ -4,7 +4,6 @@
 using System;
 using System.Collections.Generic;
 using System.IO;
-using System.Runtime.Serialization;
 using System.Text;
 
 namespace osu.Game.IO.Legacy
@@ -23,15 +22,6 @@ namespace osu.Game.IO.Legacy
 
         public int RemainingBytes => (int)(stream.Length - stream.Position);
 
-        /// <summary> Static method to take a SerializationInfo object (an input to an ISerializable constructor)
-        /// and produce a SerializationReader from which serialized objects can be read </summary>.
-        public static SerializationReader GetReader(SerializationInfo info)
-        {
-            byte[] byteArray = (byte[])info.GetValue("X", typeof(byte[]));
-            MemoryStream ms = new MemoryStream(byteArray);
-            return new SerializationReader(ms);
-        }
-
         /// <summary> Reads a string from the buffer.  Overrides the base implementation so it can cope with nulls. </summary>
         public override string ReadString()
         {
diff --git a/osu.Game/IO/Legacy/SerializationWriter.cs b/osu.Game/IO/Legacy/SerializationWriter.cs
index 6dfb21e5bd..c9fff05bcc 100644
--- a/osu.Game/IO/Legacy/SerializationWriter.cs
+++ b/osu.Game/IO/Legacy/SerializationWriter.cs
@@ -4,7 +4,6 @@
 using System;
 using System.Collections.Generic;
 using System.IO;
-using System.Runtime.Serialization;
 using System.Text;
 
 // ReSharper disable ConditionIsAlwaysTrueOrFalse (we're allowing nulls to be passed to the writer where the underlying class doesn't).
@@ -221,13 +220,6 @@ namespace osu.Game.IO.Legacy
             } // if obj==null
         } // WriteObject
 
-        /// <summary> Adds the SerializationWriter buffer to the SerializationInfo at the end of GetObjectData(). </summary>
-        public void AddToInfo(SerializationInfo info)
-        {
-            byte[] b = ((MemoryStream)BaseStream).ToArray();
-            info.AddValue("X", b, typeof(byte[]));
-        }
-
         public void WriteRawBytes(byte[] b)
         {
             base.Write(b);

From 1ebbef88ec75034295826c319b2a42189e505804 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 12 Apr 2022 22:56:48 +0900
Subject: [PATCH 4031/5547] Refactor `GameplayChatDisplay` test scene to not
 require `MultiplayerTestScene` inheritance

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

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneGameplayChatDisplay.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneGameplayChatDisplay.cs
index 512d206a06..c3487751b9 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneGameplayChatDisplay.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneGameplayChatDisplay.cs
@@ -9,13 +9,14 @@ using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.UserInterface;
 using osu.Framework.Testing;
+using osu.Game.Online.Rooms;
 using osu.Game.Screens.OnlinePlay.Multiplayer;
 using osu.Game.Screens.Play;
 using osuTK.Input;
 
 namespace osu.Game.Tests.Visual.Multiplayer
 {
-    public class TestSceneGameplayChatDisplay : MultiplayerTestScene
+    public class TestSceneGameplayChatDisplay : OsuManualInputManagerTestScene
     {
         private GameplayChatDisplay chatDisplay;
 
@@ -35,11 +36,9 @@ namespace osu.Game.Tests.Visual.Multiplayer
         }
 
         [SetUpSteps]
-        public override void SetUpSteps()
+        public void SetUpSteps()
         {
-            base.SetUpSteps();
-
-            AddStep("load chat display", () => Child = chatDisplay = new GameplayChatDisplay(SelectedRoom.Value)
+            AddStep("load chat display", () => Child = chatDisplay = new GameplayChatDisplay(new Room())
             {
                 Anchor = Anchor.Centre,
                 Origin = Anchor.Centre,

From ef7ab12b40c92c87c5cf2db5a57585efeec7466f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 12 Apr 2022 23:01:37 +0900
Subject: [PATCH 4032/5547] Fix `MultiplayerMatchFooter` test crash due to
 missing `PopoverContainer`

Clicking the countdown button would crash. I did consider removing the
test altogether but maybe it'll be useful in the future?
---
 .../Visual/Multiplayer/TestSceneMultiplayerMatchFooter.cs     | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchFooter.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchFooter.cs
index 6536ef2ca1..ff834d71a1 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchFooter.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchFooter.cs
@@ -3,7 +3,7 @@
 
 using NUnit.Framework;
 using osu.Framework.Graphics;
-using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.Cursor;
 using osu.Game.Screens.OnlinePlay.Multiplayer.Match;
 
 namespace osu.Game.Tests.Visual.Multiplayer
@@ -13,7 +13,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [SetUp]
         public new void Setup() => Schedule(() =>
         {
-            Child = new Container
+            Child = new PopoverContainer
             {
                 Anchor = Anchor.Centre,
                 Origin = Anchor.Centre,

From 63e2a84d7f4784f8bb824b70509f6d57c0a8d0b4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 12 Apr 2022 20:54:54 +0200
Subject: [PATCH 4033/5547] Nest one more container to fix popover not being
 dismissable

---
 .../Multiplayer/TestSceneMultiplayerMatchFooter.cs  | 13 ++++++++++---
 1 file changed, 10 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchFooter.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchFooter.cs
index ff834d71a1..111f51675d 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchFooter.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchFooter.cs
@@ -3,6 +3,7 @@
 
 using NUnit.Framework;
 using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Cursor;
 using osu.Game.Screens.OnlinePlay.Multiplayer.Match;
 
@@ -17,9 +18,15 @@ namespace osu.Game.Tests.Visual.Multiplayer
             {
                 Anchor = Anchor.Centre,
                 Origin = Anchor.Centre,
-                RelativeSizeAxes = Axes.X,
-                Height = 50,
-                Child = new MultiplayerMatchFooter()
+                RelativeSizeAxes = Axes.Both,
+                Child = new Container
+                {
+                    Anchor = Anchor.Centre,
+                    Origin = Anchor.Centre,
+                    RelativeSizeAxes = Axes.X,
+                    Height = 50,
+                    Child = new MultiplayerMatchFooter()
+                }
             };
         });
     }

From d73be7f1773425012c69d1aa25ff9efe0f3138cb Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 13 Apr 2022 09:36:44 +0900
Subject: [PATCH 4034/5547] Reword comment to read clearer
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.Tests/Visual/Multiplayer/TestSceneRankRangePill.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneRankRangePill.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneRankRangePill.cs
index b758c83a0a..b0a977dcbb 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneRankRangePill.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneRankRangePill.cs
@@ -19,7 +19,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         private readonly Mock<MultiplayerClient> multiplayerClient = new Mock<MultiplayerClient>();
 
         protected override IReadOnlyDependencyContainer CreateChildDependencies(IReadOnlyDependencyContainer parent) =>
-            // not used but required by the component.
+            // not used directly in component, but required due to it inheriting from OnlinePlayComposite.
             new CachedModelDependencyContainer<Room>(base.CreateChildDependencies(parent));
 
         [BackgroundDependencyLoader]

From 282fccb4c8842ff30cde671989a620303f4dc0f4 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 13 Apr 2022 12:24:47 +0900
Subject: [PATCH 4035/5547] Fix typo in 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/Screens/Play/Player.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Play/Player.cs b/osu.Game/Screens/Play/Player.cs
index 6ec21ef924..be19565657 100644
--- a/osu.Game/Screens/Play/Player.cs
+++ b/osu.Game/Screens/Play/Player.cs
@@ -610,7 +610,7 @@ namespace osu.Game.Screens.Play
         /// Specify and seek to a custom start time from which gameplay should be observed.
         /// </summary>
         /// <remarks>
-        /// This performance a non-frame-stable seek. Intermediate hitobject judgements may not be applied or reverted correctly during this seek.
+        /// This performs a non-frame-stable seek. Intermediate hitobject judgements may not be applied or reverted correctly during this seek.
         /// </remarks>
         /// <param name="time">The destination time to seek to.</param>
         protected void SetGameplayStartTime(double time)

From 017f3852c8a8354b08cb6a3f22a1624dea4b45db Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 13 Apr 2022 13:32:34 +0900
Subject: [PATCH 4036/5547] Replace incorrectly chosen `??=` with `??`

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

diff --git a/osu.Game/Screens/Play/HUD/MultiplayerGameplayLeaderboard.cs b/osu.Game/Screens/Play/HUD/MultiplayerGameplayLeaderboard.cs
index e569e5368b..41b40e9a91 100644
--- a/osu.Game/Screens/Play/HUD/MultiplayerGameplayLeaderboard.cs
+++ b/osu.Game/Screens/Play/HUD/MultiplayerGameplayLeaderboard.cs
@@ -91,7 +91,7 @@ namespace osu.Game.Screens.Play.HUD
 
                 for (int i = 0; i < users.Length; i++)
                 {
-                    var user = users[i] ??= new APIUser
+                    var user = users[i] ?? new APIUser
                     {
                         Id = playingUsers[i].UserID,
                         Username = "Unknown user",

From d4286255a094ac759e40e34c9be3aaa9caaf85b0 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 13 Apr 2022 13:49:58 +0900
Subject: [PATCH 4037/5547] Expose and set `GameplayStartTime` directly, rather
 than via `Reset` parameter

---
 .../Multiplayer/Spectate/MultiSpectatorScreen.cs          | 3 ++-
 osu.Game/Screens/Play/GameplayClockContainer.cs           | 8 ++------
 osu.Game/Screens/Play/MasterGameplayClockContainer.cs     | 4 ++--
 osu.Game/Screens/Play/Player.cs                           | 3 ++-
 4 files changed, 8 insertions(+), 10 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorScreen.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorScreen.cs
index 523301f4fd..2d03276fe5 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorScreen.cs
@@ -197,7 +197,8 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Spectate
                                         .DefaultIfEmpty(0)
                                         .Min();
 
-            masterClockContainer.Reset(true, startTime);
+            masterClockContainer.StartTime = startTime;
+            masterClockContainer.Reset(true);
 
             // Although the clock has been started, this flag is set to allow for later synchronisation state changes to also be able to start it.
             canStartMasterClock = true;
diff --git a/osu.Game/Screens/Play/GameplayClockContainer.cs b/osu.Game/Screens/Play/GameplayClockContainer.cs
index f2df00d691..721abc66f8 100644
--- a/osu.Game/Screens/Play/GameplayClockContainer.cs
+++ b/osu.Game/Screens/Play/GameplayClockContainer.cs
@@ -48,7 +48,7 @@ namespace osu.Game.Screens.Play
         /// If not set, a value of zero will be used.
         /// Importantly, the value will be inferred from the current ruleset in <see cref="MasterGameplayClockContainer"/> unless specified.
         /// </remarks>
-        protected double? StartTime { get; set; }
+        public double? StartTime { get; set; }
 
         /// <summary>
         /// Creates a new <see cref="GameplayClockContainer"/>.
@@ -116,12 +116,8 @@ namespace osu.Game.Screens.Play
         /// Resets this <see cref="GameplayClockContainer"/> and the source to an initial state ready for gameplay.
         /// </summary>
         /// <param name="startClock">Whether to start the clock immediately, if not already started.</param>
-        /// <param name="gameplayStartTime">A time to use for future <see cref="Reset"/> calls as the definite start of gameplay.</param>
-        public void Reset(bool startClock = false, double? gameplayStartTime = null)
+        public void Reset(bool startClock = false)
         {
-            if (gameplayStartTime != null)
-                StartTime = gameplayStartTime;
-
             // Manually stop the source in order to not affect the IsPaused state.
             AdjustableSource.Stop();
 
diff --git a/osu.Game/Screens/Play/MasterGameplayClockContainer.cs b/osu.Game/Screens/Play/MasterGameplayClockContainer.cs
index 54901746fc..88dc6db0f7 100644
--- a/osu.Game/Screens/Play/MasterGameplayClockContainer.cs
+++ b/osu.Game/Screens/Play/MasterGameplayClockContainer.cs
@@ -100,9 +100,9 @@ namespace osu.Game.Screens.Play
             bool isStarted = !IsPaused.Value;
 
             // If a custom start time was not specified, calculate the best value to use.
-            double gameplayStartTime = StartTime ?? findEarliestStartTime();
+            StartTime ??= findEarliestStartTime();
 
-            Reset(startClock: isStarted, gameplayStartTime: gameplayStartTime);
+            Reset(startClock: isStarted);
         }
 
         private double findEarliestStartTime()
diff --git a/osu.Game/Screens/Play/Player.cs b/osu.Game/Screens/Play/Player.cs
index be19565657..f99b07c313 100644
--- a/osu.Game/Screens/Play/Player.cs
+++ b/osu.Game/Screens/Play/Player.cs
@@ -621,7 +621,8 @@ namespace osu.Game.Screens.Play
             bool wasFrameStable = DrawableRuleset.FrameStablePlayback;
             DrawableRuleset.FrameStablePlayback = false;
 
-            GameplayClockContainer.Reset(gameplayStartTime: time);
+            GameplayClockContainer.StartTime = time;
+            GameplayClockContainer.Reset();
 
             // Delay resetting frame-stable playback for one frame to give the FrameStabilityContainer a chance to seek.
             frameStablePlaybackResetDelegate = ScheduleAfterChildren(() => DrawableRuleset.FrameStablePlayback = wasFrameStable);

From a59c6013c790f305d8567d98ec4e3a846c29fdeb Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 13 Apr 2022 14:03:52 +0900
Subject: [PATCH 4038/5547] Rename `latestGameplayStartTime` to
 `skipTargetTime`

---
 .../Play/MasterGameplayClockContainer.cs      | 20 +++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/osu.Game/Screens/Play/MasterGameplayClockContainer.cs b/osu.Game/Screens/Play/MasterGameplayClockContainer.cs
index 88dc6db0f7..61f31db435 100644
--- a/osu.Game/Screens/Play/MasterGameplayClockContainer.cs
+++ b/osu.Game/Screens/Play/MasterGameplayClockContainer.cs
@@ -58,7 +58,7 @@ namespace osu.Game.Screens.Play
 
         private IDisposable beatmapOffsetSubscription;
 
-        private readonly double latestGameplayStartTime;
+        private readonly double skipTargetTime;
 
         [Resolved]
         private RealmAccess realm { get; set; }
@@ -70,17 +70,17 @@ namespace osu.Game.Screens.Play
         /// Create a new master gameplay clock container.
         /// </summary>
         /// <param name="beatmap">The beatmap to be used for time and metadata references.</param>
-        /// <param name="latestGameplayStartTime">The latest time which should be used when introducing gameplay. Will be used when skipping forward.</param>
-        /// <param name="startFromLatestStartTime">Whether to start from the provided latest start time rather than zero.</param>
-        public MasterGameplayClockContainer(WorkingBeatmap beatmap, double latestGameplayStartTime, bool startFromLatestStartTime = false)
+        /// <param name="skipTargetTime">The latest time which should be used when introducing gameplay. Will be used when skipping forward.</param>
+        /// <param name="startFromSkipTarget">Whether to start from the provided latest start time rather than zero.</param>
+        public MasterGameplayClockContainer(WorkingBeatmap beatmap, double skipTargetTime, bool startFromSkipTarget = false)
             : base(beatmap.Track)
         {
             this.beatmap = beatmap;
 
-            this.latestGameplayStartTime = latestGameplayStartTime;
+            this.skipTargetTime = skipTargetTime;
 
-            if (startFromLatestStartTime)
-                StartTime = latestGameplayStartTime;
+            if (startFromSkipTarget)
+                StartTime = skipTargetTime;
         }
 
         protected override void LoadComplete()
@@ -111,7 +111,7 @@ namespace osu.Game.Screens.Play
             // generally this is either zero, or some point earlier than zero in the case of storyboards, lead-ins etc.
 
             // start with the originally provided latest time (if before zero).
-            double time = Math.Min(0, latestGameplayStartTime);
+            double time = Math.Min(0, skipTargetTime);
 
             // if a storyboard is present, it may dictate the appropriate start time by having events in negative time space.
             // this is commonly used to display an intro before the audio track start.
@@ -183,10 +183,10 @@ namespace osu.Game.Screens.Play
         /// </summary>
         public void Skip()
         {
-            if (GameplayClock.CurrentTime > latestGameplayStartTime - MINIMUM_SKIP_TIME)
+            if (GameplayClock.CurrentTime > skipTargetTime - MINIMUM_SKIP_TIME)
                 return;
 
-            double skipTarget = latestGameplayStartTime - MINIMUM_SKIP_TIME;
+            double skipTarget = skipTargetTime - MINIMUM_SKIP_TIME;
 
             if (GameplayClock.CurrentTime < 0 && skipTarget > 6000)
                 // double skip exception for storyboards with very long intros

From fbf0e5a45cf4f4f073126a717b35c6edf258c412 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 13 Apr 2022 14:09:49 +0900
Subject: [PATCH 4039/5547] Remove `startFromSkipTarget` parameter and update
 usages that required said behaviour

---
 osu.Game.Tests/Gameplay/TestSceneStoryboardSamples.cs     | 7 +++++--
 .../Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs   | 8 ++++----
 osu.Game/Screens/Edit/GameplayTest/EditorPlayer.cs        | 2 +-
 osu.Game/Screens/Play/MasterGameplayClockContainer.cs     | 7 +------
 4 files changed, 11 insertions(+), 13 deletions(-)

diff --git a/osu.Game.Tests/Gameplay/TestSceneStoryboardSamples.cs b/osu.Game.Tests/Gameplay/TestSceneStoryboardSamples.cs
index 76ec35d87d..e0a497cf24 100644
--- a/osu.Game.Tests/Gameplay/TestSceneStoryboardSamples.cs
+++ b/osu.Game.Tests/Gameplay/TestSceneStoryboardSamples.cs
@@ -88,7 +88,7 @@ namespace osu.Game.Tests.Gameplay
         [Test]
         public void TestSampleHasLifetimeEndWithInitialClockTime()
         {
-            GameplayClockContainer gameplayContainer = null;
+            MasterGameplayClockContainer gameplayContainer = null;
             DrawableStoryboardSample sample = null;
 
             AddStep("create container", () =>
@@ -96,8 +96,11 @@ namespace osu.Game.Tests.Gameplay
                 var working = CreateWorkingBeatmap(new OsuRuleset().RulesetInfo);
                 working.LoadTrack();
 
-                Add(gameplayContainer = new MasterGameplayClockContainer(working, 1000, true)
+                const double start_time = 1000;
+
+                Add(gameplayContainer = new MasterGameplayClockContainer(working, start_time)
                 {
+                    StartTime = start_time,
                     IsPaused = { Value = true },
                     Child = new FrameStabilityContainer
                     {
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs
index 653a35417e..703b526e8c 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs
@@ -464,16 +464,16 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
         private class TestMultiSpectatorScreen : MultiSpectatorScreen
         {
-            private readonly double? gameplayStartTime;
+            private readonly double? startTime;
 
-            public TestMultiSpectatorScreen(Room room, MultiplayerRoomUser[] users, double? gameplayStartTime = null)
+            public TestMultiSpectatorScreen(Room room, MultiplayerRoomUser[] users, double? startTime = null)
                 : base(room, users)
             {
-                this.gameplayStartTime = gameplayStartTime;
+                this.startTime = startTime;
             }
 
             protected override MasterGameplayClockContainer CreateMasterGameplayClockContainer(WorkingBeatmap beatmap)
-                => new MasterGameplayClockContainer(beatmap, gameplayStartTime ?? 0, true);
+                => new MasterGameplayClockContainer(beatmap, 0) { StartTime = startTime ?? 0 };
         }
     }
 }
diff --git a/osu.Game/Screens/Edit/GameplayTest/EditorPlayer.cs b/osu.Game/Screens/Edit/GameplayTest/EditorPlayer.cs
index f49603c754..d9e19df350 100644
--- a/osu.Game/Screens/Edit/GameplayTest/EditorPlayer.cs
+++ b/osu.Game/Screens/Edit/GameplayTest/EditorPlayer.cs
@@ -25,7 +25,7 @@ namespace osu.Game.Screens.Edit.GameplayTest
         }
 
         protected override GameplayClockContainer CreateGameplayClockContainer(WorkingBeatmap beatmap, double gameplayStart)
-            => new MasterGameplayClockContainer(beatmap, editorState.Time, true);
+            => new MasterGameplayClockContainer(beatmap, gameplayStart) { StartTime = editorState.Time };
 
         protected override void LoadComplete()
         {
diff --git a/osu.Game/Screens/Play/MasterGameplayClockContainer.cs b/osu.Game/Screens/Play/MasterGameplayClockContainer.cs
index 61f31db435..c5a5c14070 100644
--- a/osu.Game/Screens/Play/MasterGameplayClockContainer.cs
+++ b/osu.Game/Screens/Play/MasterGameplayClockContainer.cs
@@ -71,16 +71,11 @@ namespace osu.Game.Screens.Play
         /// </summary>
         /// <param name="beatmap">The beatmap to be used for time and metadata references.</param>
         /// <param name="skipTargetTime">The latest time which should be used when introducing gameplay. Will be used when skipping forward.</param>
-        /// <param name="startFromSkipTarget">Whether to start from the provided latest start time rather than zero.</param>
-        public MasterGameplayClockContainer(WorkingBeatmap beatmap, double skipTargetTime, bool startFromSkipTarget = false)
+        public MasterGameplayClockContainer(WorkingBeatmap beatmap, double skipTargetTime)
             : base(beatmap.Track)
         {
             this.beatmap = beatmap;
-
             this.skipTargetTime = skipTargetTime;
-
-            if (startFromSkipTarget)
-                StartTime = skipTargetTime;
         }
 
         protected override void LoadComplete()

From 56427becbba54e042c167edf8c59b03e37136aba Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 13 Apr 2022 14:33:28 +0900
Subject: [PATCH 4040/5547] Move logging and early return into
 `UndeleteForReuse` method itself

---
 osu.Game/Stores/RealmArchiveModelImporter.cs | 14 ++++++--------
 1 file changed, 6 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Stores/RealmArchiveModelImporter.cs b/osu.Game/Stores/RealmArchiveModelImporter.cs
index 353a2164bb..6d1449a4b4 100644
--- a/osu.Game/Stores/RealmArchiveModelImporter.cs
+++ b/osu.Game/Stores/RealmArchiveModelImporter.cs
@@ -351,8 +351,7 @@ namespace osu.Game.Stores
 
                             using (var transaction = realm.BeginWrite())
                             {
-                                if (existing.DeletePending)
-                                    UndeleteForReuse(existing);
+                                UndeleteForReuse(existing);
                                 transaction.Commit();
                             }
 
@@ -388,12 +387,7 @@ namespace osu.Game.Stores
                             {
                                 LogForModel(item, @$"Found existing {HumanisedModelName} for {item} (ID {existing.ID}) – skipping import.");
 
-                                if (existing.DeletePending)
-                                {
-                                    LogForModel(item, $@"Existing {HumanisedModelName}'s deletion flag has been removed");
-                                    UndeleteForReuse(existing);
-                                }
-
+                                UndeleteForReuse(existing);
                                 transaction.Commit();
 
                                 return existing.ToLive(Realm);
@@ -539,6 +533,10 @@ namespace osu.Game.Stores
         /// <param name="existing">The existing model.</param>
         protected virtual void UndeleteForReuse(TModel existing)
         {
+            if (!existing.DeletePending)
+                return;
+
+            LogForModel(existing, $@"Existing {HumanisedModelName}'s deletion flag has been removed to allow for reuse.");
             existing.DeletePending = false;
         }
 

From 2bb0d9e6d3d52a4e9da8f7405a95cedc1a8cfe2d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 13 Apr 2022 17:02:33 +0900
Subject: [PATCH 4041/5547] Expose required classes/properties for mocking

---
 osu.Game/Online/Multiplayer/MultiplayerClient.cs              | 4 ++--
 osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs | 4 ++--
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Online/Multiplayer/MultiplayerClient.cs b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
index 4c10949225..e29aee2c6d 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
@@ -114,12 +114,12 @@ namespace osu.Game.Online.Multiplayer
         /// <summary>
         /// The <see cref="MultiplayerRoomUser"/> corresponding to the local player, if available.
         /// </summary>
-        public MultiplayerRoomUser? LocalUser => Room?.Users.SingleOrDefault(u => u.User?.Id == API.LocalUser.Value.Id);
+        public virtual MultiplayerRoomUser? LocalUser => Room?.Users.SingleOrDefault(u => u.User?.Id == API.LocalUser.Value.Id);
 
         /// <summary>
         /// Whether the <see cref="LocalUser"/> is the host in <see cref="Room"/>.
         /// </summary>
-        public bool IsHost
+        public virtual bool IsHost
         {
             get
             {
diff --git a/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs b/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs
index 07506ba1f0..4ca6d79b19 100644
--- a/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs
+++ b/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs
@@ -25,7 +25,7 @@ namespace osu.Game.Online.Rooms
     /// This differs from a regular download tracking composite as this accounts for the
     /// databased beatmap set's checksum, to disallow from playing with an altered version of the beatmap.
     /// </summary>
-    public sealed class OnlinePlayBeatmapAvailabilityTracker : CompositeDrawable
+    public class OnlinePlayBeatmapAvailabilityTracker : CompositeDrawable
     {
         public readonly IBindable<PlaylistItem> SelectedItem = new Bindable<PlaylistItem>();
 
@@ -41,7 +41,7 @@ namespace osu.Game.Online.Rooms
         /// <summary>
         /// The availability state of the currently selected playlist item.
         /// </summary>
-        public IBindable<BeatmapAvailability> Availability => availability;
+        public virtual IBindable<BeatmapAvailability> Availability => availability;
 
         private readonly Bindable<BeatmapAvailability> availability = new Bindable<BeatmapAvailability>(BeatmapAvailability.NotDownloaded());
 

From 1f01714ec207c4fb4090efe72769234037bc9071 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 13 Apr 2022 17:02:53 +0900
Subject: [PATCH 4042/5547] Apply initial structural changes to
 `TestSceneMatchStartControl`

---
 .../Multiplayer/TestSceneMatchStartControl.cs | 233 +++++++++++-------
 1 file changed, 148 insertions(+), 85 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.cs
index 5c2fd26857..dcf73f9633 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.cs
@@ -3,74 +3,119 @@
 
 using System;
 using System.Linq;
+using Moq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
-using osu.Framework.Audio;
 using osu.Framework.Bindables;
 using osu.Framework.Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Cursor;
 using osu.Framework.Graphics.UserInterface;
-using osu.Framework.Platform;
 using osu.Framework.Testing;
 using osu.Framework.Utils;
-using osu.Game.Beatmaps;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Multiplayer.Countdown;
 using osu.Game.Online.Rooms;
-using osu.Game.Rulesets;
+using osu.Game.Screens.OnlinePlay;
 using osu.Game.Screens.OnlinePlay.Multiplayer.Match;
-using osu.Game.Tests.Resources;
 using osuTK;
 using osuTK.Input;
 
 namespace osu.Game.Tests.Visual.Multiplayer
 {
-    public class TestSceneMatchStartControl : MultiplayerTestScene
+    public class TestSceneMatchStartControl : OsuManualInputManagerTestScene
     {
+        private readonly Mock<MultiplayerClient> multiplayerClient = new Mock<MultiplayerClient>();
+        private readonly Mock<OnlinePlayBeatmapAvailabilityTracker> availabilityTracker = new Mock<OnlinePlayBeatmapAvailabilityTracker>();
+
+        private readonly Bindable<BeatmapAvailability> beatmapAvailability = new Bindable<BeatmapAvailability>();
+        private readonly Bindable<Room> room = new Bindable<Room>();
+
+        private MultiplayerRoom multiplayerRoom;
+        private MultiplayerRoomUser localUser;
+        private OngoingOperationTracker ongoingOperationTracker;
+
+        private PopoverContainer content;
         private MatchStartControl control;
-        private BeatmapSetInfo importedSet;
 
-        private readonly Bindable<PlaylistItem> selectedItem = new Bindable<PlaylistItem>();
-
-        private BeatmapManager beatmaps;
-        private RulesetStore rulesets;
+        protected override IReadOnlyDependencyContainer CreateChildDependencies(IReadOnlyDependencyContainer parent) =>
+            new CachedModelDependencyContainer<Room>(base.CreateChildDependencies(parent)) { Model = { BindTarget = room } };
 
         [BackgroundDependencyLoader]
-        private void load(GameHost host, AudioManager audio)
+        private void load()
         {
-            Dependencies.Cache(rulesets = new RealmRulesetStore(Realm));
-            Dependencies.Cache(beatmaps = new BeatmapManager(LocalStorage, Realm, rulesets, null, audio, Resources, host, Beatmap.Default));
-            Dependencies.Cache(Realm);
+            Dependencies.CacheAs(multiplayerClient.Object);
+            Dependencies.CacheAs(ongoingOperationTracker = new OngoingOperationTracker());
+
+            availabilityTracker.SetupGet(a => a.Availability).Returns(beatmapAvailability);
+            Dependencies.CacheAs(availabilityTracker.Object);
+
+            multiplayerClient.SetupGet(m => m.LocalUser).Returns(() => localUser);
+            multiplayerClient.SetupGet(m => m.Room).Returns(() => multiplayerRoom);
+
+            // By default, the local user is to be the host.
+            multiplayerClient.SetupGet(m => m.IsHost).Returns(true);
+
+            // Assume all state changes are accepted by the server.
+            multiplayerClient.Setup(m => m.ChangeState(It.IsAny<MultiplayerUserState>()))
+                             .Callback((MultiplayerUserState r) =>
+                             {
+                                 localUser.State = r;
+                                 raiseRoomUpdated();
+                             });
+
+            Children = new Drawable[]
+            {
+                ongoingOperationTracker,
+                content = new PopoverContainer { RelativeSizeAxes = Axes.Both }
+            };
         }
 
-        [SetUp]
-        public new void Setup() => Schedule(() =>
+        [SetUpSteps]
+        public void SetUpSteps()
         {
-            AvailabilityTracker.SelectedItem.BindTo(selectedItem);
-
-            beatmaps.Import(TestResources.GetQuickTestBeatmapForImport()).WaitSafely();
-            importedSet = beatmaps.GetAllUsableBeatmapSets().First();
-            Beatmap.Value = beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First());
-
-            selectedItem.Value = new PlaylistItem(Beatmap.Value.BeatmapInfo)
+            AddStep("reset state", () =>
             {
-                RulesetID = Beatmap.Value.BeatmapInfo.Ruleset.OnlineID
-            };
+                multiplayerClient.Invocations.Clear();
 
-            Child = new PopoverContainer
+                beatmapAvailability.Value = BeatmapAvailability.LocallyAvailable();
+
+                var playlistItem = new PlaylistItem(Beatmap.Value.BeatmapInfo)
+                {
+                    RulesetID = Beatmap.Value.BeatmapInfo.Ruleset.OnlineID
+                };
+
+                room.Value = new Room
+                {
+                    Playlist = { playlistItem },
+                    CurrentPlaylistItem = { Value = playlistItem }
+                };
+
+                multiplayerRoom = new MultiplayerRoom(0)
+                {
+                    Playlist =
+                    {
+                        new MultiplayerPlaylistItem(playlistItem),
+                    },
+                    Users =
+                    {
+                        (localUser = new MultiplayerRoomUser(API.LocalUser.Value.Id) { User = API.LocalUser.Value }),
+                    }
+                };
+            });
+
+            AddStep("create control", () =>
             {
-                RelativeSizeAxes = Axes.Both,
-                Child = control = new MatchStartControl
+                content.Child = control = new MatchStartControl
                 {
                     Anchor = Anchor.Centre,
                     Origin = Anchor.Centre,
                     Size = new Vector2(250, 50),
-                }
-            };
-        });
+                };
+            });
+        }
 
         [Test]
         public void TestStartWithCountdown()
@@ -85,8 +130,12 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 InputManager.Click(MouseButton.Left);
             });
 
-            AddStep("finish countdown", () => MultiplayerClient.SkipToEndOfCountdown());
-            AddUntilStep("match started", () => MultiplayerClient.LocalUser?.State == MultiplayerUserState.WaitingForLoad);
+            AddStep("check request received", () =>
+            {
+                multiplayerClient.Verify(m => m.SendMatchRequest(It.Is<StartMatchCountdownRequest>(req =>
+                    req.Duration == TimeSpan.FromSeconds(10)
+                )), Times.Once);
+            });
         }
 
         [Test]
@@ -110,7 +159,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 InputManager.Click(MouseButton.Left);
             });
 
-            AddStep("finish countdown", () => MultiplayerClient.SkipToEndOfCountdown());
+            // AddStep("finish countdown", skipToEndOfCountdown);
             AddUntilStep("match not started", () => MultiplayerClient.LocalUser?.State == MultiplayerUserState.Ready);
         }
 
@@ -119,32 +168,32 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             AddStep("add second user as host", () =>
             {
-                MultiplayerClient.AddUser(new APIUser { Id = 2, Username = "Another user" });
-                MultiplayerClient.TransferHost(2);
+                addUser(new APIUser { Id = 2, Username = "Another user" });
+                multiplayerClient.Object.TransferHost(2);
             });
 
-            AddStep("start with countdown", () => MultiplayerClient.SendMatchRequest(new StartMatchCountdownRequest { Duration = TimeSpan.FromMinutes(2) }).WaitSafely());
+            AddStep("start with countdown", () => multiplayerClient.Object.SendMatchRequest(new StartMatchCountdownRequest { Duration = TimeSpan.FromMinutes(2) }).WaitSafely());
 
             ClickButtonWhenEnabled<MultiplayerReadyButton>();
-            AddUntilStep("user is ready", () => MultiplayerClient.Room?.Users[0].State == MultiplayerUserState.Ready);
+            AddUntilStep("user is ready", () => multiplayerClient.Object.Room?.Users[0].State == MultiplayerUserState.Ready);
 
             ClickButtonWhenEnabled<MultiplayerReadyButton>();
-            AddUntilStep("user is idle", () => MultiplayerClient.Room?.Users[0].State == MultiplayerUserState.Idle);
+            AddUntilStep("user is idle", () => multiplayerClient.Object.Room?.Users[0].State == MultiplayerUserState.Idle);
         }
 
         [Test]
         public void TestCountdownWhileSpectating()
         {
-            AddStep("set spectating", () => MultiplayerClient.ChangeUserState(API.LocalUser.Value.OnlineID, MultiplayerUserState.Spectating));
-            AddUntilStep("local user is spectating", () => MultiplayerClient.LocalUser?.State == MultiplayerUserState.Spectating);
+            AddStep("set spectating", () => changeUserState(API.LocalUser.Value.OnlineID, MultiplayerUserState.Spectating));
+            AddUntilStep("local user is spectating", () => multiplayerClient.Object.LocalUser?.State == MultiplayerUserState.Spectating);
 
             AddAssert("countdown button is visible", () => this.ChildrenOfType<MultiplayerCountdownButton>().Single().IsPresent);
             AddAssert("countdown button enabled", () => this.ChildrenOfType<MultiplayerCountdownButton>().Single().Enabled.Value);
 
-            AddStep("add second user", () => MultiplayerClient.AddUser(new APIUser { Id = 2, Username = "Another user" }));
+            AddStep("add second user", () => addUser(new APIUser { Id = 2, Username = "Another user" }));
             AddAssert("countdown button enabled", () => this.ChildrenOfType<MultiplayerCountdownButton>().Single().Enabled.Value);
 
-            AddStep("set second user ready", () => MultiplayerClient.ChangeUserState(2, MultiplayerUserState.Ready));
+            AddStep("set second user ready", () => changeUserState(2, MultiplayerUserState.Ready));
             AddAssert("countdown button enabled", () => this.ChildrenOfType<MultiplayerCountdownButton>().Single().Enabled.Value);
         }
 
@@ -153,44 +202,44 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             AddStep("add second user as host", () =>
             {
-                MultiplayerClient.AddUser(new APIUser { Id = 2, Username = "Another user" });
-                MultiplayerClient.TransferHost(2);
+                addUser(new APIUser { Id = 2, Username = "Another user" });
+                multiplayerClient.Object.TransferHost(2);
             });
 
-            AddStep("start countdown", () => MultiplayerClient.SendMatchRequest(new StartMatchCountdownRequest { Duration = TimeSpan.FromMinutes(1) }).WaitSafely());
-            AddUntilStep("countdown started", () => MultiplayerClient.Room?.Countdown != null);
+            AddStep("start countdown", () => multiplayerClient.Object.SendMatchRequest(new StartMatchCountdownRequest { Duration = TimeSpan.FromMinutes(1) }).WaitSafely());
+            AddUntilStep("countdown started", () => multiplayerClient.Object.Room?.Countdown != null);
 
-            AddStep("transfer host to local user", () => MultiplayerClient.TransferHost(API.LocalUser.Value.OnlineID));
-            AddUntilStep("local user is host", () => MultiplayerClient.Room?.Host?.Equals(MultiplayerClient.LocalUser) == true);
+            AddStep("transfer host to local user", () => multiplayerClient.Object.TransferHost(API.LocalUser.Value.OnlineID));
+            AddUntilStep("local user is host", () => multiplayerClient.Object.Room?.Host?.Equals(multiplayerClient.Object.LocalUser) == true);
 
             ClickButtonWhenEnabled<MultiplayerReadyButton>();
-            AddUntilStep("local user became ready", () => MultiplayerClient.LocalUser?.State == MultiplayerUserState.Ready);
-            AddAssert("countdown still active", () => MultiplayerClient.Room?.Countdown != null);
+            AddUntilStep("local user became ready", () => multiplayerClient.Object.LocalUser?.State == MultiplayerUserState.Ready);
+            AddAssert("countdown still active", () => multiplayerClient.Object.Room?.Countdown != null);
         }
 
         [Test]
         public void TestCountdownButtonVisibilityWithAutoStartEnablement()
         {
             ClickButtonWhenEnabled<MultiplayerReadyButton>();
-            AddUntilStep("local user became ready", () => MultiplayerClient.LocalUser?.State == MultiplayerUserState.Ready);
+            AddUntilStep("local user became ready", () => multiplayerClient.Object.LocalUser?.State == MultiplayerUserState.Ready);
             AddUntilStep("countdown button visible", () => this.ChildrenOfType<MultiplayerCountdownButton>().Single().IsPresent);
 
-            AddStep("enable auto start", () => MultiplayerClient.ChangeSettings(new MultiplayerRoomSettings { AutoStartDuration = TimeSpan.FromMinutes(1) }).WaitSafely());
+            AddStep("enable auto start", () => multiplayerClient.Object.ChangeSettings(new MultiplayerRoomSettings { AutoStartDuration = TimeSpan.FromMinutes(1) }).WaitSafely());
 
             ClickButtonWhenEnabled<MultiplayerReadyButton>();
-            AddUntilStep("local user became ready", () => MultiplayerClient.LocalUser?.State == MultiplayerUserState.Ready);
+            AddUntilStep("local user became ready", () => multiplayerClient.Object.LocalUser?.State == MultiplayerUserState.Ready);
             AddUntilStep("countdown button not visible", () => !this.ChildrenOfType<MultiplayerCountdownButton>().Single().IsPresent);
         }
 
         [Test]
         public void TestClickingReadyButtonUnReadiesDuringAutoStart()
         {
-            AddStep("enable auto start", () => MultiplayerClient.ChangeSettings(new MultiplayerRoomSettings { AutoStartDuration = TimeSpan.FromMinutes(1) }).WaitSafely());
+            AddStep("enable auto start", () => multiplayerClient.Object.ChangeSettings(new MultiplayerRoomSettings { AutoStartDuration = TimeSpan.FromMinutes(1) }).WaitSafely());
             ClickButtonWhenEnabled<MultiplayerReadyButton>();
-            AddUntilStep("local user became ready", () => MultiplayerClient.LocalUser?.State == MultiplayerUserState.Ready);
+            AddUntilStep("local user became ready", () => multiplayerClient.Object.LocalUser?.State == MultiplayerUserState.Ready);
 
             ClickButtonWhenEnabled<MultiplayerReadyButton>();
-            AddUntilStep("local user became idle", () => MultiplayerClient.LocalUser?.State == MultiplayerUserState.Idle);
+            AddUntilStep("local user became idle", () => multiplayerClient.Object.LocalUser?.State == MultiplayerUserState.Idle);
         }
 
         [Test]
@@ -204,9 +253,9 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 return readyButton.Enabled.Value;
             });
 
-            AddStep("delete beatmap", () => beatmaps.Delete(importedSet));
+            // TODO: AddStep("delete beatmap", () => beatmaps.Delete(importedSet));
             AddUntilStep("ready button disabled", () => !readyButton.Enabled.Value);
-            AddStep("undelete beatmap", () => beatmaps.Undelete(importedSet));
+            // TODO: AddStep("undelete beatmap", () => beatmaps.Undelete(importedSet));
             AddUntilStep("ready button enabled back", () => readyButton.Enabled.Value);
         }
 
@@ -215,15 +264,15 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             AddStep("add second user as host", () =>
             {
-                MultiplayerClient.AddUser(new APIUser { Id = 2, Username = "Another user" });
-                MultiplayerClient.TransferHost(2);
+                addUser(new APIUser { Id = 2, Username = "Another user" });
+                multiplayerClient.Object.TransferHost(2);
             });
 
             ClickButtonWhenEnabled<MultiplayerReadyButton>();
-            AddUntilStep("user is ready", () => MultiplayerClient.Room?.Users[0].State == MultiplayerUserState.Ready);
+            AddUntilStep("user is ready", () => multiplayerClient.Object.Room?.Users[0].State == MultiplayerUserState.Ready);
 
             ClickButtonWhenEnabled<MultiplayerReadyButton>();
-            AddUntilStep("user is idle", () => MultiplayerClient.Room?.Users[0].State == MultiplayerUserState.Idle);
+            AddUntilStep("user is idle", () => multiplayerClient.Object.Room?.Users[0].State == MultiplayerUserState.Idle);
         }
 
         [TestCase(true)]
@@ -232,14 +281,14 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             AddStep("setup", () =>
             {
-                MultiplayerClient.TransferHost(MultiplayerClient.Room?.Users[0].UserID ?? 0);
+                multiplayerClient.Object.TransferHost(multiplayerClient.Object.Room?.Users[0].UserID ?? 0);
 
                 if (!allReady)
-                    MultiplayerClient.AddUser(new APIUser { Id = 2, Username = "Another user" });
+                    addUser(new APIUser { Id = 2, Username = "Another user" });
             });
 
             ClickButtonWhenEnabled<MultiplayerReadyButton>();
-            AddUntilStep("user is ready", () => MultiplayerClient.Room?.Users[0].State == MultiplayerUserState.Ready);
+            AddUntilStep("user is ready", () => multiplayerClient.Object.Room?.Users[0].State == MultiplayerUserState.Ready);
 
             verifyGameplayStartFlow();
         }
@@ -249,12 +298,12 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             AddStep("add host", () =>
             {
-                MultiplayerClient.AddUser(new APIUser { Id = 2, Username = "Another user" });
-                MultiplayerClient.TransferHost(2);
+                addUser(new APIUser { Id = 2, Username = "Another user" });
+                multiplayerClient.Object.TransferHost(2);
             });
 
             ClickButtonWhenEnabled<MultiplayerReadyButton>();
-            AddStep("make user host", () => MultiplayerClient.TransferHost(MultiplayerClient.Room?.Users[0].UserID ?? 0));
+            AddStep("make user host", () => multiplayerClient.Object.TransferHost(multiplayerClient.Object.Room?.Users[0].UserID ?? 0));
 
             verifyGameplayStartFlow();
         }
@@ -264,17 +313,17 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             AddStep("setup", () =>
             {
-                MultiplayerClient.TransferHost(MultiplayerClient.Room?.Users[0].UserID ?? 0);
-                MultiplayerClient.AddUser(new APIUser { Id = 2, Username = "Another user" });
+                multiplayerClient.Object.TransferHost(multiplayerClient.Object.Room?.Users[0].UserID ?? 0);
+                addUser(new APIUser { Id = 2, Username = "Another user" });
             });
 
             ClickButtonWhenEnabled<MultiplayerReadyButton>();
-            AddUntilStep("user is ready", () => MultiplayerClient.Room?.Users[0].State == MultiplayerUserState.Ready);
+            AddUntilStep("user is ready", () => multiplayerClient.Object.Room?.Users[0].State == MultiplayerUserState.Ready);
 
-            AddStep("transfer host", () => MultiplayerClient.TransferHost(MultiplayerClient.Room?.Users[1].UserID ?? 0));
+            AddStep("transfer host", () => multiplayerClient.Object.TransferHost(multiplayerClient.Object.Room?.Users[1].UserID ?? 0));
 
             ClickButtonWhenEnabled<MultiplayerReadyButton>();
-            AddUntilStep("user is idle (match not started)", () => MultiplayerClient.Room?.Users[0].State == MultiplayerUserState.Idle);
+            AddUntilStep("user is idle (match not started)", () => multiplayerClient.Object.Room?.Users[0].State == MultiplayerUserState.Idle);
             AddUntilStep("ready button enabled", () => control.ChildrenOfType<OsuButton>().Single().Enabled.Value);
         }
 
@@ -285,42 +334,56 @@ namespace osu.Game.Tests.Visual.Multiplayer
             const int users = 10;
             AddStep("setup", () =>
             {
-                MultiplayerClient.TransferHost(MultiplayerClient.Room?.Users[0].UserID ?? 0);
+                multiplayerClient.Object.TransferHost(multiplayerClient.Object.Room?.Users[0].UserID ?? 0);
                 for (int i = 0; i < users; i++)
-                    MultiplayerClient.AddUser(new APIUser { Id = i, Username = "Another user" });
+                    addUser(new APIUser { Id = i, Username = "Another user" });
             });
 
             if (!isHost)
-                AddStep("transfer host", () => MultiplayerClient.TransferHost(2));
+                AddStep("transfer host", () => multiplayerClient.Object.TransferHost(2));
 
             ClickButtonWhenEnabled<MultiplayerReadyButton>();
 
             AddRepeatStep("change user ready state", () =>
             {
-                MultiplayerClient.ChangeUserState(RNG.Next(0, users), RNG.NextBool() ? MultiplayerUserState.Ready : MultiplayerUserState.Idle);
+                changeUserState(RNG.Next(0, users), RNG.NextBool() ? MultiplayerUserState.Ready : MultiplayerUserState.Idle);
             }, 20);
 
             AddRepeatStep("ready all users", () =>
             {
-                var nextUnready = MultiplayerClient.Room?.Users.FirstOrDefault(c => c.State == MultiplayerUserState.Idle);
+                var nextUnready = multiplayerClient.Object.Room?.Users.FirstOrDefault(c => c.State == MultiplayerUserState.Idle);
                 if (nextUnready != null)
-                    MultiplayerClient.ChangeUserState(nextUnready.UserID, MultiplayerUserState.Ready);
+                    changeUserState(nextUnready.UserID, MultiplayerUserState.Ready);
             }, users);
         }
 
         private void verifyGameplayStartFlow()
         {
-            AddUntilStep("user is ready", () => MultiplayerClient.Room?.Users[0].State == MultiplayerUserState.Ready);
+            AddUntilStep("user is ready", () => multiplayerClient.Object.Room?.Users[0].State == MultiplayerUserState.Ready);
             ClickButtonWhenEnabled<MultiplayerReadyButton>();
-            AddUntilStep("user waiting for load", () => MultiplayerClient.Room?.Users[0].State == MultiplayerUserState.WaitingForLoad);
+            AddUntilStep("user waiting for load", () => multiplayerClient.Object.Room?.Users[0].State == MultiplayerUserState.WaitingForLoad);
 
             AddStep("finish gameplay", () =>
             {
-                MultiplayerClient.ChangeUserState(MultiplayerClient.Room?.Users[0].UserID ?? 0, MultiplayerUserState.Loaded);
-                MultiplayerClient.ChangeUserState(MultiplayerClient.Room?.Users[0].UserID ?? 0, MultiplayerUserState.FinishedPlay);
+                changeUserState(multiplayerClient.Object.Room?.Users[0].UserID ?? 0, MultiplayerUserState.Loaded);
+                changeUserState(multiplayerClient.Object.Room?.Users[0].UserID ?? 0, MultiplayerUserState.FinishedPlay);
             });
 
             AddUntilStep("ready button enabled", () => control.ChildrenOfType<OsuButton>().Single().Enabled.Value);
         }
+
+        private void changeUserState(int userId, MultiplayerUserState newState)
+        {
+            multiplayerRoom.Users.Single(u => u.UserID == userId).State = newState;
+            raiseRoomUpdated();
+        }
+
+        private void addUser(APIUser user)
+        {
+            multiplayerRoom.Users.Add(new MultiplayerRoomUser(user.Id) { User = user });
+            raiseRoomUpdated();
+        }
+
+        private void raiseRoomUpdated() => multiplayerClient.Raise(m => m.RoomUpdated -= null);
     }
 }

From ca44d2c4dcda8df808ce615f25ef5002e534b98a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 13 Apr 2022 17:32:04 +0900
Subject: [PATCH 4043/5547] Setup start/stop requests

---
 .../Multiplayer/TestSceneMatchStartControl.cs | 30 +++++++++++++++++--
 1 file changed, 28 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.cs
index dcf73f9633..dabf8c5267 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.cs
@@ -66,6 +66,23 @@ namespace osu.Game.Tests.Visual.Multiplayer
                                  raiseRoomUpdated();
                              });
 
+            multiplayerClient.Setup(m => m.SendMatchRequest(It.IsAny<MatchUserRequest>()))
+                             .Callback((MatchUserRequest request) =>
+                             {
+                                 switch (request)
+                                 {
+                                     case StartMatchCountdownRequest countdownStart:
+                                         multiplayerRoom.Countdown = new MatchStartCountdown { TimeRemaining = countdownStart.Duration };
+                                         raiseRoomUpdated();
+                                         break;
+
+                                     case StopCountdownRequest _:
+                                         multiplayerRoom.Countdown = null;
+                                         raiseRoomUpdated();
+                                         break;
+                                 }
+                             });
+
             Children = new Drawable[]
             {
                 ongoingOperationTracker,
@@ -151,6 +168,13 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 InputManager.Click(MouseButton.Left);
             });
 
+            AddStep("check request received", () =>
+            {
+                multiplayerClient.Verify(m => m.SendMatchRequest(It.Is<StartMatchCountdownRequest>(req =>
+                    req.Duration == TimeSpan.FromSeconds(10)
+                )), Times.Once);
+            });
+
             ClickButtonWhenEnabled<MultiplayerCountdownButton>();
             AddStep("click the cancel button", () =>
             {
@@ -159,8 +183,10 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 InputManager.Click(MouseButton.Left);
             });
 
-            // AddStep("finish countdown", skipToEndOfCountdown);
-            AddUntilStep("match not started", () => MultiplayerClient.LocalUser?.State == MultiplayerUserState.Ready);
+            AddStep("check request received", () =>
+            {
+                multiplayerClient.Verify(m => m.SendMatchRequest(It.IsAny<StopCountdownRequest>()), Times.Once);
+            });
         }
 
         [Test]

From 0a5a3415f8e5a54374f22f841a10850aea1a1430 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 13 Apr 2022 20:28:53 +0900
Subject: [PATCH 4044/5547] Setup host switching and avoid starting gameplay

---
 .../Multiplayer/TestSceneMatchStartControl.cs | 47 ++++++++++++-------
 1 file changed, 31 insertions(+), 16 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.cs
index dabf8c5267..dccfd98c4d 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.cs
@@ -3,6 +3,7 @@
 
 using System;
 using System.Linq;
+using System.Threading.Tasks;
 using Moq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
@@ -11,6 +12,7 @@ using osu.Framework.Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Cursor;
 using osu.Framework.Graphics.UserInterface;
+using osu.Framework.Logging;
 using osu.Framework.Testing;
 using osu.Framework.Utils;
 using osu.Game.Graphics.UserInterface;
@@ -62,18 +64,22 @@ namespace osu.Game.Tests.Visual.Multiplayer
             multiplayerClient.Setup(m => m.ChangeState(It.IsAny<MultiplayerUserState>()))
                              .Callback((MultiplayerUserState r) =>
                              {
+                                 Logger.Log($"Changing local user state from {localUser.State} to {r}");
                                  localUser.State = r;
                                  raiseRoomUpdated();
                              });
 
+            // We don't want to have to handle entering into actual gameplay in this test.
+            // Returning a failed task should always allow the button to always stay in a clickable state.
+            multiplayerClient.Setup(m => m.StartMatch()).Returns(Task.FromException<InvalidOperationException>(new InvalidOperationException()));
+
             multiplayerClient.Setup(m => m.SendMatchRequest(It.IsAny<MatchUserRequest>()))
                              .Callback((MatchUserRequest request) =>
                              {
                                  switch (request)
                                  {
                                      case StartMatchCountdownRequest countdownStart:
-                                         multiplayerRoom.Countdown = new MatchStartCountdown { TimeRemaining = countdownStart.Duration };
-                                         raiseRoomUpdated();
+                                         setRoomCountdown(countdownStart.Duration);
                                          break;
 
                                      case StopCountdownRequest _:
@@ -110,16 +116,16 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     CurrentPlaylistItem = { Value = playlistItem }
                 };
 
+                localUser = new MultiplayerRoomUser(API.LocalUser.Value.Id) { User = API.LocalUser.Value };
+
                 multiplayerRoom = new MultiplayerRoom(0)
                 {
                     Playlist =
                     {
                         new MultiplayerPlaylistItem(playlistItem),
                     },
-                    Users =
-                    {
-                        (localUser = new MultiplayerRoomUser(API.LocalUser.Value.Id) { User = API.LocalUser.Value }),
-                    }
+                    Users = { localUser },
+                    Host = localUser,
                 };
             });
 
@@ -160,6 +166,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             ClickButtonWhenEnabled<MultiplayerReadyButton>();
             AddUntilStep("countdown button shown", () => this.ChildrenOfType<MultiplayerCountdownButton>().SingleOrDefault()?.IsPresent == true);
+
             ClickButtonWhenEnabled<MultiplayerCountdownButton>();
             AddStep("click the first countdown button", () =>
             {
@@ -192,19 +199,15 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [Test]
         public void TestReadyAndUnReadyDuringCountdown()
         {
-            AddStep("add second user as host", () =>
-            {
-                addUser(new APIUser { Id = 2, Username = "Another user" });
-                multiplayerClient.Object.TransferHost(2);
-            });
+            AddStep("add second user as host", () => addUser(new APIUser { Id = 2, Username = "Another user" }, true));
 
-            AddStep("start with countdown", () => multiplayerClient.Object.SendMatchRequest(new StartMatchCountdownRequest { Duration = TimeSpan.FromMinutes(2) }).WaitSafely());
+            AddStep("start countdown", () => setRoomCountdown(TimeSpan.FromMinutes(1)));
 
             ClickButtonWhenEnabled<MultiplayerReadyButton>();
-            AddUntilStep("user is ready", () => multiplayerClient.Object.Room?.Users[0].State == MultiplayerUserState.Ready);
+            AddUntilStep("user is ready", () => localUser.State == MultiplayerUserState.Ready);
 
             ClickButtonWhenEnabled<MultiplayerReadyButton>();
-            AddUntilStep("user is idle", () => multiplayerClient.Object.Room?.Users[0].State == MultiplayerUserState.Idle);
+            AddUntilStep("user is idle", () => localUser.State == MultiplayerUserState.Idle);
         }
 
         [Test]
@@ -398,15 +401,27 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddUntilStep("ready button enabled", () => control.ChildrenOfType<OsuButton>().Single().Enabled.Value);
         }
 
+        private void setRoomCountdown(TimeSpan duration)
+        {
+            multiplayerRoom.Countdown = new MatchStartCountdown { TimeRemaining = duration };
+            raiseRoomUpdated();
+        }
+
         private void changeUserState(int userId, MultiplayerUserState newState)
         {
             multiplayerRoom.Users.Single(u => u.UserID == userId).State = newState;
             raiseRoomUpdated();
         }
 
-        private void addUser(APIUser user)
+        private void addUser(APIUser user, bool asHost = false)
         {
-            multiplayerRoom.Users.Add(new MultiplayerRoomUser(user.Id) { User = user });
+            var multiplayerRoomUser = new MultiplayerRoomUser(user.Id) { User = user };
+
+            multiplayerRoom.Users.Add(multiplayerRoomUser);
+
+            if (asHost)
+                multiplayerRoom.Host = multiplayerRoomUser;
+
             raiseRoomUpdated();
         }
 

From 331242d585ab23d8f11d8863ac991bb74600d038 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 13 Apr 2022 20:38:39 +0900
Subject: [PATCH 4045/5547] Update transfer host logic and simplify local user
 checks

---
 .../Multiplayer/TestSceneMatchStartControl.cs | 52 +++++++++----------
 1 file changed, 26 insertions(+), 26 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.cs
index dccfd98c4d..e10a63d010 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.cs
@@ -231,14 +231,13 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             AddStep("add second user as host", () =>
             {
-                addUser(new APIUser { Id = 2, Username = "Another user" });
-                multiplayerClient.Object.TransferHost(2);
+                addUser(new APIUser { Id = 2, Username = "Another user" }, true);
             });
 
             AddStep("start countdown", () => multiplayerClient.Object.SendMatchRequest(new StartMatchCountdownRequest { Duration = TimeSpan.FromMinutes(1) }).WaitSafely());
             AddUntilStep("countdown started", () => multiplayerClient.Object.Room?.Countdown != null);
 
-            AddStep("transfer host to local user", () => multiplayerClient.Object.TransferHost(API.LocalUser.Value.OnlineID));
+            AddStep("transfer host to local user", () => transferHost(localUser));
             AddUntilStep("local user is host", () => multiplayerClient.Object.Room?.Host?.Equals(multiplayerClient.Object.LocalUser) == true);
 
             ClickButtonWhenEnabled<MultiplayerReadyButton>();
@@ -293,15 +292,14 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             AddStep("add second user as host", () =>
             {
-                addUser(new APIUser { Id = 2, Username = "Another user" });
-                multiplayerClient.Object.TransferHost(2);
+                addUser(new APIUser { Id = 2, Username = "Another user" }, true);
             });
 
             ClickButtonWhenEnabled<MultiplayerReadyButton>();
-            AddUntilStep("user is ready", () => multiplayerClient.Object.Room?.Users[0].State == MultiplayerUserState.Ready);
+            AddUntilStep("user is ready", () => localUser.State == MultiplayerUserState.Ready);
 
             ClickButtonWhenEnabled<MultiplayerReadyButton>();
-            AddUntilStep("user is idle", () => multiplayerClient.Object.Room?.Users[0].State == MultiplayerUserState.Idle);
+            AddUntilStep("user is idle", () => localUser.State == MultiplayerUserState.Idle);
         }
 
         [TestCase(true)]
@@ -310,14 +308,14 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             AddStep("setup", () =>
             {
-                multiplayerClient.Object.TransferHost(multiplayerClient.Object.Room?.Users[0].UserID ?? 0);
+                transferHost(multiplayerRoom.Users[0]);
 
                 if (!allReady)
                     addUser(new APIUser { Id = 2, Username = "Another user" });
             });
 
             ClickButtonWhenEnabled<MultiplayerReadyButton>();
-            AddUntilStep("user is ready", () => multiplayerClient.Object.Room?.Users[0].State == MultiplayerUserState.Ready);
+            AddUntilStep("user is ready", () => localUser.State == MultiplayerUserState.Ready);
 
             verifyGameplayStartFlow();
         }
@@ -327,12 +325,12 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             AddStep("add host", () =>
             {
-                addUser(new APIUser { Id = 2, Username = "Another user" });
-                multiplayerClient.Object.TransferHost(2);
+                addUser(new APIUser { Id = 2, Username = "Another user" }, true);
             });
 
             ClickButtonWhenEnabled<MultiplayerReadyButton>();
-            AddStep("make user host", () => multiplayerClient.Object.TransferHost(multiplayerClient.Object.Room?.Users[0].UserID ?? 0));
+
+            AddStep("make user host", () => transferHost(localUser));
 
             verifyGameplayStartFlow();
         }
@@ -342,17 +340,16 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             AddStep("setup", () =>
             {
-                multiplayerClient.Object.TransferHost(multiplayerClient.Object.Room?.Users[0].UserID ?? 0);
                 addUser(new APIUser { Id = 2, Username = "Another user" });
             });
 
             ClickButtonWhenEnabled<MultiplayerReadyButton>();
-            AddUntilStep("user is ready", () => multiplayerClient.Object.Room?.Users[0].State == MultiplayerUserState.Ready);
+            AddUntilStep("user is ready", () => localUser.State == MultiplayerUserState.Ready);
 
-            AddStep("transfer host", () => multiplayerClient.Object.TransferHost(multiplayerClient.Object.Room?.Users[1].UserID ?? 0));
+            AddStep("transfer host", () => transferHost(multiplayerRoom.Users[1]));
 
             ClickButtonWhenEnabled<MultiplayerReadyButton>();
-            AddUntilStep("user is idle (match not started)", () => multiplayerClient.Object.Room?.Users[0].State == MultiplayerUserState.Idle);
+            AddUntilStep("user is idle (match not started)", () => localUser.State == MultiplayerUserState.Idle);
             AddUntilStep("ready button enabled", () => control.ChildrenOfType<OsuButton>().Single().Enabled.Value);
         }
 
@@ -363,14 +360,11 @@ namespace osu.Game.Tests.Visual.Multiplayer
             const int users = 10;
             AddStep("setup", () =>
             {
-                multiplayerClient.Object.TransferHost(multiplayerClient.Object.Room?.Users[0].UserID ?? 0);
+                transferHost(localUser);
                 for (int i = 0; i < users; i++)
-                    addUser(new APIUser { Id = i, Username = "Another user" });
+                    addUser(new APIUser { Id = i, Username = "Another user" }, !isHost && i == 2);
             });
 
-            if (!isHost)
-                AddStep("transfer host", () => multiplayerClient.Object.TransferHost(2));
-
             ClickButtonWhenEnabled<MultiplayerReadyButton>();
 
             AddRepeatStep("change user ready state", () =>
@@ -388,14 +382,14 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
         private void verifyGameplayStartFlow()
         {
-            AddUntilStep("user is ready", () => multiplayerClient.Object.Room?.Users[0].State == MultiplayerUserState.Ready);
+            AddUntilStep("user is ready", () => localUser.State == MultiplayerUserState.Ready);
             ClickButtonWhenEnabled<MultiplayerReadyButton>();
-            AddUntilStep("user waiting for load", () => multiplayerClient.Object.Room?.Users[0].State == MultiplayerUserState.WaitingForLoad);
+            AddUntilStep("user waiting for load", () => localUser.State == MultiplayerUserState.WaitingForLoad);
 
             AddStep("finish gameplay", () =>
             {
-                changeUserState(multiplayerClient.Object.Room?.Users[0].UserID ?? 0, MultiplayerUserState.Loaded);
-                changeUserState(multiplayerClient.Object.Room?.Users[0].UserID ?? 0, MultiplayerUserState.FinishedPlay);
+                changeUserState(localUser.UserID, MultiplayerUserState.Loaded);
+                changeUserState(localUser.UserID, MultiplayerUserState.FinishedPlay);
             });
 
             AddUntilStep("ready button enabled", () => control.ChildrenOfType<OsuButton>().Single().Enabled.Value);
@@ -420,11 +414,17 @@ namespace osu.Game.Tests.Visual.Multiplayer
             multiplayerRoom.Users.Add(multiplayerRoomUser);
 
             if (asHost)
-                multiplayerRoom.Host = multiplayerRoomUser;
+                transferHost(multiplayerRoomUser);
 
             raiseRoomUpdated();
         }
 
+        private void transferHost(MultiplayerRoomUser user)
+        {
+            multiplayerRoom.Host = user;
+            raiseRoomUpdated();
+        }
+
         private void raiseRoomUpdated() => multiplayerClient.Raise(m => m.RoomUpdated -= null);
     }
 }

From 4b6a9fbf474031d3df852a099cce731a95c7fa91 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 13 Apr 2022 20:41:56 +0900
Subject: [PATCH 4046/5547] Reimplement beatmap availability test

---
 .../Visual/Multiplayer/TestSceneMatchStartControl.cs          | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.cs
index e10a63d010..16f7426360 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.cs
@@ -281,9 +281,9 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 return readyButton.Enabled.Value;
             });
 
-            // TODO: AddStep("delete beatmap", () => beatmaps.Delete(importedSet));
+            AddStep("mark beatmap not available", () => beatmapAvailability.Value = BeatmapAvailability.NotDownloaded());
             AddUntilStep("ready button disabled", () => !readyButton.Enabled.Value);
-            // TODO: AddStep("undelete beatmap", () => beatmaps.Undelete(importedSet));
+            AddStep("mark beatmap available", () => beatmapAvailability.Value = BeatmapAvailability.LocallyAvailable());
             AddUntilStep("ready button enabled back", () => readyButton.Enabled.Value);
         }
 

From 8a7b37856c8902681a35f5f9b786af5f79fc23bd Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 13 Apr 2022 20:51:05 +0900
Subject: [PATCH 4047/5547] Implement `IsHost` to return correct value for
 current state

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

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.cs
index 16f7426360..bf980b0694 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.cs
@@ -58,7 +58,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             multiplayerClient.SetupGet(m => m.Room).Returns(() => multiplayerRoom);
 
             // By default, the local user is to be the host.
-            multiplayerClient.SetupGet(m => m.IsHost).Returns(true);
+            multiplayerClient.SetupGet(m => m.IsHost).Returns(() => ReferenceEquals(multiplayerRoom.Host, localUser));
 
             // Assume all state changes are accepted by the server.
             multiplayerClient.Setup(m => m.ChangeState(It.IsAny<MultiplayerUserState>()))

From c0ad91796d75e2f38b5117c0b484589cba1c588b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 13 Apr 2022 20:57:40 +0900
Subject: [PATCH 4048/5547] Fix gameplay start flow

---
 .../Multiplayer/TestSceneMatchStartControl.cs    | 16 +++++++---------
 osu.Game/Online/Multiplayer/MultiplayerClient.cs |  2 +-
 2 files changed, 8 insertions(+), 10 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.cs
index bf980b0694..8af1187b67 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.cs
@@ -3,7 +3,6 @@
 
 using System;
 using System.Linq;
-using System.Threading.Tasks;
 using Moq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
@@ -69,9 +68,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
                                  raiseRoomUpdated();
                              });
 
-            // We don't want to have to handle entering into actual gameplay in this test.
-            // Returning a failed task should always allow the button to always stay in a clickable state.
-            multiplayerClient.Setup(m => m.StartMatch()).Returns(Task.FromException<InvalidOperationException>(new InvalidOperationException()));
+            multiplayerClient.Setup(m => m.StartMatch())
+                             .Callback(() => multiplayerClient.Raise(m => m.LoadRequested -= null));
 
             multiplayerClient.Setup(m => m.SendMatchRequest(It.IsAny<MatchUserRequest>()))
                              .Callback((MatchUserRequest request) =>
@@ -384,13 +382,13 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             AddUntilStep("user is ready", () => localUser.State == MultiplayerUserState.Ready);
             ClickButtonWhenEnabled<MultiplayerReadyButton>();
+
+            AddStep("check start request received", () => multiplayerClient.Verify(m => m.StartMatch(), Times.Once));
             AddUntilStep("user waiting for load", () => localUser.State == MultiplayerUserState.WaitingForLoad);
 
-            AddStep("finish gameplay", () =>
-            {
-                changeUserState(localUser.UserID, MultiplayerUserState.Loaded);
-                changeUserState(localUser.UserID, MultiplayerUserState.FinishedPlay);
-            });
+            AddUntilStep("ready button disabled", () => !control.ChildrenOfType<OsuButton>().Single().Enabled.Value);
+
+            AddStep("finish gameplay", () => changeUserState(localUser.UserID, MultiplayerUserState.Idle));
 
             AddUntilStep("ready button enabled", () => control.ChildrenOfType<OsuButton>().Single().Enabled.Value);
         }
diff --git a/osu.Game/Online/Multiplayer/MultiplayerClient.cs b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
index e29aee2c6d..967220abbf 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
@@ -67,7 +67,7 @@ namespace osu.Game.Online.Multiplayer
         /// <summary>
         /// Invoked when the multiplayer server requests the current beatmap to be loaded into play.
         /// </summary>
-        public event Action? LoadRequested;
+        public virtual event Action? LoadRequested;
 
         /// <summary>
         /// Invoked when the multiplayer server requests gameplay to be started.

From 8b1fd051c65c40febb3193a7cb25910135768f9b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 13 Apr 2022 21:04:15 +0900
Subject: [PATCH 4049/5547] Fix remaining autostart and gameplay tests

---
 .../Multiplayer/TestSceneMatchStartControl.cs | 35 +++++++++++++------
 1 file changed, 24 insertions(+), 11 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.cs
index 8af1187b67..acee35d3ba 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.cs
@@ -69,7 +69,13 @@ namespace osu.Game.Tests.Visual.Multiplayer
                              });
 
             multiplayerClient.Setup(m => m.StartMatch())
-                             .Callback(() => multiplayerClient.Raise(m => m.LoadRequested -= null));
+                             .Callback(() =>
+                             {
+                                 multiplayerClient.Raise(m => m.LoadRequested -= null);
+
+                                 // immediately "end" gameplay, as we don't care about that part of the process.
+                                 changeUserState(localUser.UserID, MultiplayerUserState.Idle);
+                             });
 
             multiplayerClient.Setup(m => m.SendMatchRequest(It.IsAny<MatchUserRequest>()))
                              .Callback((MatchUserRequest request) =>
@@ -244,13 +250,13 @@ namespace osu.Game.Tests.Visual.Multiplayer
         }
 
         [Test]
-        public void TestCountdownButtonVisibilityWithAutoStartEnablement()
+        public void TestCountdownButtonVisibilityWithAutoStart()
         {
             ClickButtonWhenEnabled<MultiplayerReadyButton>();
             AddUntilStep("local user became ready", () => multiplayerClient.Object.LocalUser?.State == MultiplayerUserState.Ready);
             AddUntilStep("countdown button visible", () => this.ChildrenOfType<MultiplayerCountdownButton>().Single().IsPresent);
 
-            AddStep("enable auto start", () => multiplayerClient.Object.ChangeSettings(new MultiplayerRoomSettings { AutoStartDuration = TimeSpan.FromMinutes(1) }).WaitSafely());
+            AddStep("enable auto start", () => changeRoomSettings(new MultiplayerRoomSettings { AutoStartDuration = TimeSpan.FromMinutes(1) }));
 
             ClickButtonWhenEnabled<MultiplayerReadyButton>();
             AddUntilStep("local user became ready", () => multiplayerClient.Object.LocalUser?.State == MultiplayerUserState.Ready);
@@ -260,7 +266,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         [Test]
         public void TestClickingReadyButtonUnReadiesDuringAutoStart()
         {
-            AddStep("enable auto start", () => multiplayerClient.Object.ChangeSettings(new MultiplayerRoomSettings { AutoStartDuration = TimeSpan.FromMinutes(1) }).WaitSafely());
+            AddStep("enable auto start", () => changeRoomSettings(new MultiplayerRoomSettings { AutoStartDuration = TimeSpan.FromMinutes(1) }));
             ClickButtonWhenEnabled<MultiplayerReadyButton>();
             AddUntilStep("local user became ready", () => multiplayerClient.Object.LocalUser?.State == MultiplayerUserState.Ready);
 
@@ -384,13 +390,6 @@ namespace osu.Game.Tests.Visual.Multiplayer
             ClickButtonWhenEnabled<MultiplayerReadyButton>();
 
             AddStep("check start request received", () => multiplayerClient.Verify(m => m.StartMatch(), Times.Once));
-            AddUntilStep("user waiting for load", () => localUser.State == MultiplayerUserState.WaitingForLoad);
-
-            AddUntilStep("ready button disabled", () => !control.ChildrenOfType<OsuButton>().Single().Enabled.Value);
-
-            AddStep("finish gameplay", () => changeUserState(localUser.UserID, MultiplayerUserState.Idle));
-
-            AddUntilStep("ready button enabled", () => control.ChildrenOfType<OsuButton>().Single().Enabled.Value);
         }
 
         private void setRoomCountdown(TimeSpan duration)
@@ -423,6 +422,20 @@ namespace osu.Game.Tests.Visual.Multiplayer
             raiseRoomUpdated();
         }
 
+        private void changeRoomSettings(MultiplayerRoomSettings settings)
+        {
+            multiplayerRoom.Settings = settings;
+
+            // Changing settings should reset all user ready statuses.
+            foreach (var user in multiplayerRoom.Users)
+            {
+                if (user.State == MultiplayerUserState.Ready)
+                    user.State = MultiplayerUserState.Idle;
+            }
+
+            raiseRoomUpdated();
+        }
+
         private void raiseRoomUpdated() => multiplayerClient.Raise(m => m.RoomUpdated -= null);
     }
 }

From c77a7b75d326c90b5444bc26302b4ce7d38e38a7 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 13 Apr 2022 21:11:45 +0900
Subject: [PATCH 4050/5547] Tidy things up

---
 .../Multiplayer/TestSceneMatchStartControl.cs | 70 +++++++++----------
 1 file changed, 33 insertions(+), 37 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.cs
index acee35d3ba..ff6c02c4e5 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.cs
@@ -41,6 +41,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
         private PopoverContainer content;
         private MatchStartControl control;
 
+        private OsuButton readyButton => control.ChildrenOfType<OsuButton>().Single();
+
         protected override IReadOnlyDependencyContainer CreateChildDependencies(IReadOnlyDependencyContainer parent) =>
             new CachedModelDependencyContainer<Room>(base.CreateChildDependencies(parent)) { Model = { BindTarget = room } };
 
@@ -49,9 +51,9 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             Dependencies.CacheAs(multiplayerClient.Object);
             Dependencies.CacheAs(ongoingOperationTracker = new OngoingOperationTracker());
+            Dependencies.CacheAs(availabilityTracker.Object);
 
             availabilityTracker.SetupGet(a => a.Availability).Returns(beatmapAvailability);
-            Dependencies.CacheAs(availabilityTracker.Object);
 
             multiplayerClient.SetupGet(m => m.LocalUser).Returns(() => localUser);
             multiplayerClient.SetupGet(m => m.Room).Returns(() => multiplayerRoom);
@@ -149,6 +151,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             ClickButtonWhenEnabled<MultiplayerReadyButton>();
             AddUntilStep("countdown button shown", () => this.ChildrenOfType<MultiplayerCountdownButton>().SingleOrDefault()?.IsPresent == true);
+
             ClickButtonWhenEnabled<MultiplayerCountdownButton>();
             AddStep("click the first countdown button", () =>
             {
@@ -208,17 +211,17 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddStep("start countdown", () => setRoomCountdown(TimeSpan.FromMinutes(1)));
 
             ClickButtonWhenEnabled<MultiplayerReadyButton>();
-            AddUntilStep("user is ready", () => localUser.State == MultiplayerUserState.Ready);
+            checkLocalUserState(MultiplayerUserState.Ready);
 
             ClickButtonWhenEnabled<MultiplayerReadyButton>();
-            AddUntilStep("user is idle", () => localUser.State == MultiplayerUserState.Idle);
+            checkLocalUserState(MultiplayerUserState.Idle);
         }
 
         [Test]
         public void TestCountdownWhileSpectating()
         {
             AddStep("set spectating", () => changeUserState(API.LocalUser.Value.OnlineID, MultiplayerUserState.Spectating));
-            AddUntilStep("local user is spectating", () => multiplayerClient.Object.LocalUser?.State == MultiplayerUserState.Spectating);
+            checkLocalUserState(MultiplayerUserState.Spectating);
 
             AddAssert("countdown button is visible", () => this.ChildrenOfType<MultiplayerCountdownButton>().Single().IsPresent);
             AddAssert("countdown button enabled", () => this.ChildrenOfType<MultiplayerCountdownButton>().Single().Enabled.Value);
@@ -239,27 +242,27 @@ namespace osu.Game.Tests.Visual.Multiplayer
             });
 
             AddStep("start countdown", () => multiplayerClient.Object.SendMatchRequest(new StartMatchCountdownRequest { Duration = TimeSpan.FromMinutes(1) }).WaitSafely());
-            AddUntilStep("countdown started", () => multiplayerClient.Object.Room?.Countdown != null);
+            AddUntilStep("countdown started", () => multiplayerRoom.Countdown != null);
 
             AddStep("transfer host to local user", () => transferHost(localUser));
-            AddUntilStep("local user is host", () => multiplayerClient.Object.Room?.Host?.Equals(multiplayerClient.Object.LocalUser) == true);
+            AddUntilStep("local user is host", () => multiplayerRoom.Host?.Equals(multiplayerClient.Object.LocalUser) == true);
 
             ClickButtonWhenEnabled<MultiplayerReadyButton>();
-            AddUntilStep("local user became ready", () => multiplayerClient.Object.LocalUser?.State == MultiplayerUserState.Ready);
-            AddAssert("countdown still active", () => multiplayerClient.Object.Room?.Countdown != null);
+            checkLocalUserState(MultiplayerUserState.Ready);
+            AddAssert("countdown still active", () => multiplayerRoom.Countdown != null);
         }
 
         [Test]
         public void TestCountdownButtonVisibilityWithAutoStart()
         {
             ClickButtonWhenEnabled<MultiplayerReadyButton>();
-            AddUntilStep("local user became ready", () => multiplayerClient.Object.LocalUser?.State == MultiplayerUserState.Ready);
+            checkLocalUserState(MultiplayerUserState.Ready);
             AddUntilStep("countdown button visible", () => this.ChildrenOfType<MultiplayerCountdownButton>().Single().IsPresent);
 
             AddStep("enable auto start", () => changeRoomSettings(new MultiplayerRoomSettings { AutoStartDuration = TimeSpan.FromMinutes(1) }));
 
             ClickButtonWhenEnabled<MultiplayerReadyButton>();
-            AddUntilStep("local user became ready", () => multiplayerClient.Object.LocalUser?.State == MultiplayerUserState.Ready);
+            checkLocalUserState(MultiplayerUserState.Ready);
             AddUntilStep("countdown button not visible", () => !this.ChildrenOfType<MultiplayerCountdownButton>().Single().IsPresent);
         }
 
@@ -268,25 +271,20 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             AddStep("enable auto start", () => changeRoomSettings(new MultiplayerRoomSettings { AutoStartDuration = TimeSpan.FromMinutes(1) }));
             ClickButtonWhenEnabled<MultiplayerReadyButton>();
-            AddUntilStep("local user became ready", () => multiplayerClient.Object.LocalUser?.State == MultiplayerUserState.Ready);
+            checkLocalUserState(MultiplayerUserState.Ready);
 
             ClickButtonWhenEnabled<MultiplayerReadyButton>();
-            AddUntilStep("local user became idle", () => multiplayerClient.Object.LocalUser?.State == MultiplayerUserState.Idle);
+            checkLocalUserState(MultiplayerUserState.Idle);
         }
 
         [Test]
         public void TestDeletedBeatmapDisableReady()
         {
-            OsuButton readyButton = null;
-
-            AddUntilStep("ensure ready button enabled", () =>
-            {
-                readyButton = control.ChildrenOfType<OsuButton>().Single();
-                return readyButton.Enabled.Value;
-            });
+            AddUntilStep("ready button enabled", () => readyButton.Enabled.Value);
 
             AddStep("mark beatmap not available", () => beatmapAvailability.Value = BeatmapAvailability.NotDownloaded());
             AddUntilStep("ready button disabled", () => !readyButton.Enabled.Value);
+
             AddStep("mark beatmap available", () => beatmapAvailability.Value = BeatmapAvailability.LocallyAvailable());
             AddUntilStep("ready button enabled back", () => readyButton.Enabled.Value);
         }
@@ -300,26 +298,21 @@ namespace osu.Game.Tests.Visual.Multiplayer
             });
 
             ClickButtonWhenEnabled<MultiplayerReadyButton>();
-            AddUntilStep("user is ready", () => localUser.State == MultiplayerUserState.Ready);
+            checkLocalUserState(MultiplayerUserState.Ready);
 
             ClickButtonWhenEnabled<MultiplayerReadyButton>();
-            AddUntilStep("user is idle", () => localUser.State == MultiplayerUserState.Idle);
+            checkLocalUserState(MultiplayerUserState.Idle);
         }
 
         [TestCase(true)]
         [TestCase(false)]
         public void TestToggleStateWhenHost(bool allReady)
         {
-            AddStep("setup", () =>
-            {
-                transferHost(multiplayerRoom.Users[0]);
-
-                if (!allReady)
-                    addUser(new APIUser { Id = 2, Username = "Another user" });
-            });
+            if (!allReady)
+                AddStep("add other user", () => addUser(new APIUser { Id = 2, Username = "Another user" }));
 
             ClickButtonWhenEnabled<MultiplayerReadyButton>();
-            AddUntilStep("user is ready", () => localUser.State == MultiplayerUserState.Ready);
+            checkLocalUserState(MultiplayerUserState.Ready);
 
             verifyGameplayStartFlow();
         }
@@ -334,7 +327,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             ClickButtonWhenEnabled<MultiplayerReadyButton>();
 
-            AddStep("make user host", () => transferHost(localUser));
+            AddStep("make local user host", () => transferHost(localUser));
 
             verifyGameplayStartFlow();
         }
@@ -348,13 +341,13 @@ namespace osu.Game.Tests.Visual.Multiplayer
             });
 
             ClickButtonWhenEnabled<MultiplayerReadyButton>();
-            AddUntilStep("user is ready", () => localUser.State == MultiplayerUserState.Ready);
+            checkLocalUserState(MultiplayerUserState.Ready);
 
             AddStep("transfer host", () => transferHost(multiplayerRoom.Users[1]));
 
             ClickButtonWhenEnabled<MultiplayerReadyButton>();
-            AddUntilStep("user is idle (match not started)", () => localUser.State == MultiplayerUserState.Idle);
-            AddUntilStep("ready button enabled", () => control.ChildrenOfType<OsuButton>().Single().Enabled.Value);
+            checkLocalUserState(MultiplayerUserState.Idle);
+            AddUntilStep("ready button enabled", () => readyButton.Enabled.Value);
         }
 
         [TestCase(true)]
@@ -362,9 +355,9 @@ namespace osu.Game.Tests.Visual.Multiplayer
         public void TestManyUsersChangingState(bool isHost)
         {
             const int users = 10;
-            AddStep("setup", () =>
+
+            AddStep("add many users", () =>
             {
-                transferHost(localUser);
                 for (int i = 0; i < users; i++)
                     addUser(new APIUser { Id = i, Username = "Another user" }, !isHost && i == 2);
             });
@@ -378,7 +371,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             AddRepeatStep("ready all users", () =>
             {
-                var nextUnready = multiplayerClient.Object.Room?.Users.FirstOrDefault(c => c.State == MultiplayerUserState.Idle);
+                var nextUnready = multiplayerRoom.Users.FirstOrDefault(c => c.State == MultiplayerUserState.Idle);
                 if (nextUnready != null)
                     changeUserState(nextUnready.UserID, MultiplayerUserState.Ready);
             }, users);
@@ -386,12 +379,15 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
         private void verifyGameplayStartFlow()
         {
-            AddUntilStep("user is ready", () => localUser.State == MultiplayerUserState.Ready);
+            checkLocalUserState(MultiplayerUserState.Ready);
             ClickButtonWhenEnabled<MultiplayerReadyButton>();
 
             AddStep("check start request received", () => multiplayerClient.Verify(m => m.StartMatch(), Times.Once));
         }
 
+        private void checkLocalUserState(MultiplayerUserState state) =>
+            AddUntilStep($"local user is {state}", () => localUser.State == state);
+
         private void setRoomCountdown(TimeSpan duration)
         {
             multiplayerRoom.Countdown = new MatchStartCountdown { TimeRemaining = duration };

From 9b433280bdd9623b0a296b9a78ceccdec2a4215d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 13 Apr 2022 21:24:33 +0900
Subject: [PATCH 4051/5547] Remove countdown implementation from
 `TestMultiplayerClient`

---
 .../Multiplayer/TestMultiplayerClient.cs      | 89 +------------------
 1 file changed, 1 insertion(+), 88 deletions(-)

diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
index 4a974cf61d..21774b73a0 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
@@ -7,19 +7,16 @@ using System;
 using System.Collections.Generic;
 using System.Diagnostics;
 using System.Linq;
-using System.Threading;
 using System.Threading.Tasks;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
-using osu.Framework.Development;
 using osu.Framework.Extensions;
 using osu.Game.Online.API;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Multiplayer;
-using osu.Game.Online.Multiplayer.Countdown;
 using osu.Game.Online.Multiplayer.MatchTypes.TeamVersus;
 using osu.Game.Online.Rooms;
 using osu.Game.Rulesets.Mods;
-using APIUser = osu.Game.Online.API.Requests.Responses.APIUser;
 
 namespace osu.Game.Tests.Visual.Multiplayer
 {
@@ -141,16 +138,6 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 switch (Room.State)
                 {
                     case MultiplayerRoomState.Open:
-                        // If there are no remaining ready users or the host is not ready, stop any existing countdown.
-                        // Todo: This doesn't yet support non-match-start countdowns.
-                        if (Room.Settings.AutoStartEnabled)
-                        {
-                            bool shouldHaveCountdown = !APIRoom.Playlist.GetCurrentItem()!.Expired && Room.Users.Any(u => u.State == MultiplayerUserState.Ready);
-
-                            if (shouldHaveCountdown && Room.Countdown == null)
-                                startCountdown(new MatchStartCountdown { TimeRemaining = Room.Settings.AutoStartDuration }, StartMatch);
-                        }
-
                         break;
 
                     case MultiplayerRoomState.WaitingForLoad:
@@ -317,16 +304,6 @@ namespace osu.Game.Tests.Visual.Multiplayer
             return Task.CompletedTask;
         }
 
-        private CancellationTokenSource? countdownSkipSource;
-        private CancellationTokenSource? countdownStopSource;
-        private Task countdownTask = Task.CompletedTask;
-
-        /// <summary>
-        /// Skips to the end of the currently-running countdown, if one is running,
-        /// and runs the callback (e.g. to start the match) as soon as possible unless the countdown has been cancelled.
-        /// </summary>
-        public void SkipToEndOfCountdown() => countdownSkipSource?.Cancel();
-
         public override async Task SendMatchRequest(MatchUserRequest request)
         {
             Debug.Assert(Room != null);
@@ -334,14 +311,6 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             switch (request)
             {
-                case StartMatchCountdownRequest matchCountdownRequest:
-                    startCountdown(new MatchStartCountdown { TimeRemaining = matchCountdownRequest.Duration }, StartMatch);
-                    break;
-
-                case StopCountdownRequest _:
-                    stopCountdown();
-                    break;
-
                 case ChangeTeamRequest changeTeam:
 
                     TeamVersusRoomState roomState = (TeamVersusRoomState)Room.MatchState!;
@@ -360,62 +329,6 @@ namespace osu.Game.Tests.Visual.Multiplayer
             }
         }
 
-        private void startCountdown(MultiplayerCountdown countdown, Func<Task> continuation)
-        {
-            Debug.Assert(Room != null);
-            Debug.Assert(ThreadSafety.IsUpdateThread);
-
-            stopCountdown();
-
-            // Note that this will leak CTSs, however this is a test method and we haven't noticed foregoing disposal of non-linked CTSs to be detrimental.
-            // If necessary, this can be moved into the final schedule below, and the class-level fields be nulled out accordingly.
-            var stopSource = countdownStopSource = new CancellationTokenSource();
-            var skipSource = countdownSkipSource = new CancellationTokenSource();
-
-            Task lastCountdownTask = countdownTask;
-            countdownTask = start();
-
-            async Task start()
-            {
-                await lastCountdownTask;
-
-                Schedule(() =>
-                {
-                    if (stopSource.IsCancellationRequested)
-                        return;
-
-                    Room.Countdown = countdown;
-                    MatchEvent(new CountdownChangedEvent { Countdown = countdown });
-                });
-
-                try
-                {
-                    using (var cancellationSource = CancellationTokenSource.CreateLinkedTokenSource(stopSource.Token, skipSource.Token))
-                        await Task.Delay(countdown.TimeRemaining, cancellationSource.Token).ConfigureAwait(false);
-                }
-                catch (OperationCanceledException)
-                {
-                    // Clients need to be notified of cancellations in the following code.
-                }
-
-                Schedule(() =>
-                {
-                    if (Room.Countdown != countdown)
-                        return;
-
-                    Room.Countdown = null;
-                    MatchEvent(new CountdownChangedEvent { Countdown = null });
-
-                    if (stopSource.IsCancellationRequested)
-                        return;
-
-                    continuation().WaitSafely();
-                });
-            }
-        }
-
-        private void stopCountdown() => countdownStopSource?.Cancel();
-
         public override Task StartMatch()
         {
             Debug.Assert(Room != null);

From 9c28c5b8470b76a915d0239e960551c9ebe44500 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 14 Apr 2022 11:52:05 +0900
Subject: [PATCH 4052/5547] Upgrade to Resharper 2022.1.0-EAP10

---
 .config/dotnet-tools.json | 4 ++--
 .github/workflows/ci.yml  | 2 +-
 InspectCode.ps1           | 2 +-
 InspectCode.sh            | 2 +-
 4 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/.config/dotnet-tools.json b/.config/dotnet-tools.json
index 4177c402aa..7b94ee5bdd 100644
--- a/.config/dotnet-tools.json
+++ b/.config/dotnet-tools.json
@@ -9,7 +9,7 @@
       ]
     },
     "jetbrains.resharper.globaltools": {
-      "version": "2020.3.2",
+      "version": "2022.1.0-eap10",
       "commands": [
         "jb"
       ]
@@ -33,4 +33,4 @@
       ]
     }
   }
-}
+}
\ No newline at end of file
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index ec3816d541..95864a79f5 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -138,7 +138,7 @@ jobs:
       #   run: dotnet format --dry-run --check
 
       - name: InspectCode
-        run: dotnet jb inspectcode $(pwd)/osu.Desktop.slnf --output=$(pwd)/inspectcodereport.xml --cachesDir=$(pwd)/inspectcode --verbosity=WARN
+        run: dotnet jb inspectcode $(pwd)/osu.Desktop.slnf --no-build --output="inspectcodereport.xml" --verbosity=WARN
 
       - name: NVika
         run: dotnet nvika parsereport "${{github.workspace}}/inspectcodereport.xml" --treatwarningsaserrors
diff --git a/InspectCode.ps1 b/InspectCode.ps1
index 8316f48ff3..e311bd8755 100644
--- a/InspectCode.ps1
+++ b/InspectCode.ps1
@@ -5,7 +5,7 @@ dotnet tool restore
   # - cmd: dotnet format --dry-run --check
 
 dotnet CodeFileSanity
-dotnet jb inspectcode "osu.Desktop.slnf" --output="inspectcodereport.xml" --caches-home="inspectcode" --verbosity=WARN
+dotnet jb inspectcode "osu.Desktop.slnf" --no-build --output="inspectcodereport.xml" --verbosity=WARN
 dotnet nvika parsereport "inspectcodereport.xml" --treatwarningsaserrors
 
 exit $LASTEXITCODE
diff --git a/InspectCode.sh b/InspectCode.sh
index cf2bc18175..1985b14e1e 100755
--- a/InspectCode.sh
+++ b/InspectCode.sh
@@ -2,5 +2,5 @@
 
 dotnet tool restore
 dotnet CodeFileSanity
-dotnet jb inspectcode "osu.Desktop.slnf" --output="inspectcodereport.xml" --caches-home="inspectcode" --verbosity=WARN
+dotnet jb inspectcode "osu.Desktop.slnf" --no-build --output="inspectcodereport.xml" --verbosity=WARN
 dotnet nvika parsereport "inspectcodereport.xml" --treatwarningsaserrors

From fb409db14872e55d6fb6d443fca0b54b09e1bb2d Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 14 Apr 2022 12:31:18 +0900
Subject: [PATCH 4053/5547] Add caches-home

---
 InspectCode.ps1 | 2 +-
 InspectCode.sh  | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/InspectCode.ps1 b/InspectCode.ps1
index e311bd8755..df0d73ea43 100644
--- a/InspectCode.ps1
+++ b/InspectCode.ps1
@@ -5,7 +5,7 @@ dotnet tool restore
   # - cmd: dotnet format --dry-run --check
 
 dotnet CodeFileSanity
-dotnet jb inspectcode "osu.Desktop.slnf" --no-build --output="inspectcodereport.xml" --verbosity=WARN
+dotnet jb inspectcode "osu.Desktop.slnf" --no-build --output="inspectcodereport.xml" --caches-home="inspectcode" --verbosity=WARN
 dotnet nvika parsereport "inspectcodereport.xml" --treatwarningsaserrors
 
 exit $LASTEXITCODE
diff --git a/InspectCode.sh b/InspectCode.sh
index 1985b14e1e..65b55e0da0 100755
--- a/InspectCode.sh
+++ b/InspectCode.sh
@@ -2,5 +2,5 @@
 
 dotnet tool restore
 dotnet CodeFileSanity
-dotnet jb inspectcode "osu.Desktop.slnf" --no-build --output="inspectcodereport.xml" --verbosity=WARN
+dotnet jb inspectcode "osu.Desktop.slnf" --no-build --output="inspectcodereport.xml" --caches-home="inspectcode" --verbosity=WARN
 dotnet nvika parsereport "inspectcodereport.xml" --treatwarningsaserrors

From 494955aff1eaf1d321183590bec88ce5cd7d034f Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 14 Apr 2022 13:11:11 +0900
Subject: [PATCH 4054/5547] Resolve inspection issues

---
 .../EmptyFreeformDifficultyCalculator.cs                    | 3 ++-
 .../PippidonDifficultyCalculator.cs                         | 3 ++-
 .../EmptyScrollingDifficultyCalculator.cs                   | 3 ++-
 .../PippidonDifficultyCalculator.cs                         | 3 ++-
 osu.Game.Rulesets.Taiko.Tests/TestSceneFlyingHits.cs        | 4 +---
 osu.Game.Tests/Online/TestAPIModJsonSerialization.cs        | 5 +++--
 .../Visual/Gameplay/TestSceneGameplaySamplePlayback.cs      | 2 +-
 .../Screens/Ladder/Components/ProgressionPath.cs            | 6 +-----
 osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.cs      | 2 +-
 osu.Game/Screens/Play/BeatmapMetadataDisplay.cs             | 4 ++--
 osu.sln.DotSettings                                         | 1 +
 11 files changed, 18 insertions(+), 18 deletions(-)

diff --git a/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform/EmptyFreeformDifficultyCalculator.cs b/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform/EmptyFreeformDifficultyCalculator.cs
index fae3784f5e..312d3d5e9a 100644
--- a/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform/EmptyFreeformDifficultyCalculator.cs
+++ b/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform/EmptyFreeformDifficultyCalculator.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;
@@ -25,6 +26,6 @@ namespace osu.Game.Rulesets.EmptyFreeform
 
         protected override IEnumerable<DifficultyHitObject> CreateDifficultyHitObjects(IBeatmap beatmap, double clockRate) => Enumerable.Empty<DifficultyHitObject>();
 
-        protected override Skill[] CreateSkills(IBeatmap beatmap, Mod[] mods, double clockRate) => new Skill[0];
+        protected override Skill[] CreateSkills(IBeatmap beatmap, Mod[] mods, double clockRate) => Array.Empty<Skill>();
     }
 }
diff --git a/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon/PippidonDifficultyCalculator.cs b/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon/PippidonDifficultyCalculator.cs
index ca64636076..f6addab279 100644
--- a/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon/PippidonDifficultyCalculator.cs
+++ b/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon/PippidonDifficultyCalculator.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;
@@ -25,6 +26,6 @@ namespace osu.Game.Rulesets.Pippidon
 
         protected override IEnumerable<DifficultyHitObject> CreateDifficultyHitObjects(IBeatmap beatmap, double clockRate) => Enumerable.Empty<DifficultyHitObject>();
 
-        protected override Skill[] CreateSkills(IBeatmap beatmap, Mod[] mods, double clockRate) => new Skill[0];
+        protected override Skill[] CreateSkills(IBeatmap beatmap, Mod[] mods, double clockRate) => Array.Empty<Skill>();
     }
 }
diff --git a/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling/EmptyScrollingDifficultyCalculator.cs b/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling/EmptyScrollingDifficultyCalculator.cs
index 63a8b48b3c..a4dc1762d5 100644
--- a/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling/EmptyScrollingDifficultyCalculator.cs
+++ b/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling/EmptyScrollingDifficultyCalculator.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;
@@ -25,6 +26,6 @@ namespace osu.Game.Rulesets.EmptyScrolling
 
         protected override IEnumerable<DifficultyHitObject> CreateDifficultyHitObjects(IBeatmap beatmap, double clockRate) => Enumerable.Empty<DifficultyHitObject>();
 
-        protected override Skill[] CreateSkills(IBeatmap beatmap, Mod[] mods, double clockRate) => new Skill[0];
+        protected override Skill[] CreateSkills(IBeatmap beatmap, Mod[] mods, double clockRate) => Array.Empty<Skill>();
     }
 }
diff --git a/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon/PippidonDifficultyCalculator.cs b/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon/PippidonDifficultyCalculator.cs
index ca64636076..f6addab279 100644
--- a/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon/PippidonDifficultyCalculator.cs
+++ b/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon/PippidonDifficultyCalculator.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;
@@ -25,6 +26,6 @@ namespace osu.Game.Rulesets.Pippidon
 
         protected override IEnumerable<DifficultyHitObject> CreateDifficultyHitObjects(IBeatmap beatmap, double clockRate) => Enumerable.Empty<DifficultyHitObject>();
 
-        protected override Skill[] CreateSkills(IBeatmap beatmap, Mod[] mods, double clockRate) => new Skill[0];
+        protected override Skill[] CreateSkills(IBeatmap beatmap, Mod[] mods, double clockRate) => Array.Empty<Skill>();
     }
 }
diff --git a/osu.Game.Rulesets.Taiko.Tests/TestSceneFlyingHits.cs b/osu.Game.Rulesets.Taiko.Tests/TestSceneFlyingHits.cs
index 63854e7ead..5c7e3954e8 100644
--- a/osu.Game.Rulesets.Taiko.Tests/TestSceneFlyingHits.cs
+++ b/osu.Game.Rulesets.Taiko.Tests/TestSceneFlyingHits.cs
@@ -28,9 +28,7 @@ namespace osu.Game.Rulesets.Taiko.Tests
 
                 // flying hits all land in one common scrolling container (and stay there for rewind purposes),
                 // so we need to manually get the latest one.
-                flyingHit = this.ChildrenOfType<DrawableFlyingHit>()
-                                .OrderByDescending(h => h.HitObject.StartTime)
-                                .FirstOrDefault();
+                flyingHit = this.ChildrenOfType<DrawableFlyingHit>().MaxBy(h => h.HitObject.StartTime);
             });
 
             AddAssert("hit type is correct", () => flyingHit.HitObject.Type == hitType);
diff --git a/osu.Game.Tests/Online/TestAPIModJsonSerialization.cs b/osu.Game.Tests/Online/TestAPIModJsonSerialization.cs
index e98ea98bb2..0622514783 100644
--- a/osu.Game.Tests/Online/TestAPIModJsonSerialization.cs
+++ b/osu.Game.Tests/Online/TestAPIModJsonSerialization.cs
@@ -33,9 +33,10 @@ namespace osu.Game.Tests.Online
 
             var converted = deserialized?.ToMod(new TestRuleset());
 
+            Assert.NotNull(converted);
             Assert.That(converted, Is.TypeOf(typeof(UnknownMod)));
-            Assert.That(converted?.Type, Is.EqualTo(ModType.System));
-            Assert.That(converted?.Acronym, Is.EqualTo("WNG??"));
+            Assert.That(converted.Type, Is.EqualTo(ModType.System));
+            Assert.That(converted.Acronym, Is.EqualTo("WNG??"));
         }
 
         [Test]
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneGameplaySamplePlayback.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneGameplaySamplePlayback.cs
index 6b3fc304e0..ae2bc60fc6 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneGameplaySamplePlayback.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneGameplaySamplePlayback.cs
@@ -25,7 +25,7 @@ namespace osu.Game.Tests.Visual.Gameplay
             AddUntilStep("get variables", () =>
             {
                 sampleDisabler = Player;
-                slider = Player.ChildrenOfType<DrawableSlider>().OrderBy(s => s.HitObject.StartTime).FirstOrDefault();
+                slider = Player.ChildrenOfType<DrawableSlider>().MinBy(s => s.HitObject.StartTime);
                 samples = slider?.ChildrenOfType<PoolableSkinnableSample>().ToArray();
 
                 return slider != null;
diff --git a/osu.Game.Tournament/Screens/Ladder/Components/ProgressionPath.cs b/osu.Game.Tournament/Screens/Ladder/Components/ProgressionPath.cs
index cb73985b11..960c4f41cc 100644
--- a/osu.Game.Tournament/Screens/Ladder/Components/ProgressionPath.cs
+++ b/osu.Game.Tournament/Screens/Ladder/Components/ProgressionPath.cs
@@ -36,11 +36,7 @@ namespace osu.Game.Tournament.Screens.Ladder.Components
             bool progressionToRight = q2.TopLeft.X > q1.TopLeft.X;
 
             if (!progressionToRight)
-            {
-                var temp = q2;
-                q2 = q1;
-                q1 = temp;
-            }
+                (q2, q1) = (q1, q2);
 
             var c1 = getCenteredVector(q1.TopRight, q1.BottomRight) + new Vector2(padding, 0);
             var c2 = getCenteredVector(q2.TopLeft, q2.BottomLeft) - new Vector2(padding, 0);
diff --git a/osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.cs b/osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.cs
index 7d59c95396..591e4cf73e 100644
--- a/osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.cs
+++ b/osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.cs
@@ -253,7 +253,7 @@ namespace osu.Game.Overlays.BeatmapSet.Scores
 
             noScoresPlaceholder.Hide();
 
-            if (Beatmap.Value == null || Beatmap.Value.OnlineID <= 0 || (Beatmap.Value?.BeatmapSet as IBeatmapSetOnlineInfo)?.Status <= BeatmapOnlineStatus.Pending)
+            if (Beatmap.Value == null || Beatmap.Value.OnlineID <= 0 || (Beatmap.Value.BeatmapSet as IBeatmapSetOnlineInfo)?.Status <= BeatmapOnlineStatus.Pending)
             {
                 Scores = null;
                 Hide();
diff --git a/osu.Game/Screens/Play/BeatmapMetadataDisplay.cs b/osu.Game/Screens/Play/BeatmapMetadataDisplay.cs
index 795dddfaf5..0d759bacf0 100644
--- a/osu.Game/Screens/Play/BeatmapMetadataDisplay.cs
+++ b/osu.Game/Screens/Play/BeatmapMetadataDisplay.cs
@@ -106,7 +106,7 @@ namespace osu.Game.Screens.Play
                                 new Sprite
                                 {
                                     RelativeSizeAxes = Axes.Both,
-                                    Texture = beatmap?.Background,
+                                    Texture = beatmap.Background,
                                     Origin = Anchor.Centre,
                                     Anchor = Anchor.Centre,
                                     FillMode = FillMode.Fill,
@@ -126,7 +126,7 @@ namespace osu.Game.Screens.Play
                             {
                                 new OsuSpriteText
                                 {
-                                    Text = beatmap?.BeatmapInfo?.DifficultyName,
+                                    Text = beatmap.BeatmapInfo.DifficultyName,
                                     Font = OsuFont.GetFont(size: 26, italics: true),
                                     Anchor = Anchor.TopCentre,
                                     Origin = Anchor.TopCentre,
diff --git a/osu.sln.DotSettings b/osu.sln.DotSettings
index 2ff0f4d30b..68cf8138e2 100644
--- a/osu.sln.DotSettings
+++ b/osu.sln.DotSettings
@@ -118,6 +118,7 @@
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=MissingLinebreak/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=MissingSpace/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=MoreSpecificForeachVariableTypeAvailable/@EntryIndexedValue">WARNING</s:String>
+    <s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=MoveVariableDeclarationInsideLoopCondition/@EntryIndexedValue">HINT</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=MultipleSpaces/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=MultipleStatementsOnOneLine/@EntryIndexedValue">WARNING</s:String>
 	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=MultipleTypeMembersOnOneLine/@EntryIndexedValue">WARNING</s:String>

From 7160a48bab4fc69166e30c19954d0585528097f2 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 14 Apr 2022 12:33:59 +0900
Subject: [PATCH 4055/5547] Adjust hold to confirm animation curve to better
 show intention

---
 osu.Game/Graphics/Containers/HoldToConfirmContainer.cs | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Graphics/Containers/HoldToConfirmContainer.cs b/osu.Game/Graphics/Containers/HoldToConfirmContainer.cs
index b2f08eee0a..1b802a0a14 100644
--- a/osu.Game/Graphics/Containers/HoldToConfirmContainer.cs
+++ b/osu.Game/Graphics/Containers/HoldToConfirmContainer.cs
@@ -70,7 +70,10 @@ namespace osu.Game.Graphics.Containers
             confirming = false;
             Fired = false;
 
-            this.TransformBindableTo(Progress, 0, fadeout_delay, Easing.Out);
+            this
+                .TransformBindableTo(Progress, Progress.Value)
+                .Delay(200)
+                .TransformBindableTo(Progress, 0, fadeout_delay, Easing.InSine);
         }
     }
 }

From 46cce94a75ee41c1b13501a5e18f8c7c3f58dfd1 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 14 Apr 2022 14:34:43 +0900
Subject: [PATCH 4056/5547] Add inspectcode CI cache

---
 .github/workflows/ci.yml | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 95864a79f5..5e7f9628fc 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -120,6 +120,12 @@ jobs:
       - name: Restore Packages
         run: dotnet restore
 
+      - name: Restore inspectcode cache
+        uses: actions/cache@v3
+        with:
+          path: ${{ github.workspace }}/inspectcode
+          key: inspectcode-${{ hashFiles('.config/dotnet-tools.json') }}-${{ hashFiles('.github/workflows/ci.yml' ) }}
+
       - name: CodeFileSanity
         run: |
           # TODO: Add ignore filters and GitHub Workflow Command Reporting in CFS. That way we don't have to do this workaround.
@@ -138,7 +144,7 @@ jobs:
       #   run: dotnet format --dry-run --check
 
       - name: InspectCode
-        run: dotnet jb inspectcode $(pwd)/osu.Desktop.slnf --no-build --output="inspectcodereport.xml" --verbosity=WARN
+        run: dotnet jb inspectcode $(pwd)/osu.Desktop.slnf --no-build --output="inspectcodereport.xml" --caches-home="inspectcode" --verbosity=WARN
 
       - name: NVika
         run: dotnet nvika parsereport "${{github.workspace}}/inspectcodereport.xml" --treatwarningsaserrors

From f48a9ba90a611424d57e55832316d0177e645dac Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 14 Apr 2022 16:19:32 +0900
Subject: [PATCH 4057/5547] Add test coverage of nested screen stacks not
 handling dialog dismissal properly

---
 .../Navigation/TestScenePerformFromScreen.cs  | 66 +++++++++++++++++++
 1 file changed, 66 insertions(+)

diff --git a/osu.Game.Tests/Visual/Navigation/TestScenePerformFromScreen.cs b/osu.Game.Tests/Visual/Navigation/TestScenePerformFromScreen.cs
index 1ebceed15d..5c5d6679aa 100644
--- a/osu.Game.Tests/Visual/Navigation/TestScenePerformFromScreen.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestScenePerformFromScreen.cs
@@ -10,6 +10,7 @@ using osu.Framework.Screens;
 using osu.Framework.Testing;
 using osu.Game.Overlays;
 using osu.Game.Screens;
+using osu.Game.Screens.Edit;
 using osu.Game.Screens.Menu;
 using osu.Game.Screens.Play;
 using osu.Game.Tests.Beatmaps.IO;
@@ -171,6 +172,46 @@ namespace osu.Game.Tests.Visual.Navigation
             }
         }
 
+        [TestCase(true)]
+        [TestCase(false)]
+        public void TestPerformBlockedByDialogSubScreen(bool confirm)
+        {
+            TestScreenWithNestedStack screenWithNestedStack = null;
+
+            PushAndConfirm(() => screenWithNestedStack = new TestScreenWithNestedStack());
+
+            AddAssert("wait for nested screen", () => screenWithNestedStack.SubScreenStack.CurrentScreen == screenWithNestedStack.Blocker);
+
+            AddStep("try to perform", () => Game.PerformFromScreen(_ => actionPerformed = true));
+
+            AddUntilStep("wait for dialog", () => screenWithNestedStack.Blocker.ExitAttempts == 1);
+
+            AddWaitStep("wait a bit", 10);
+
+            AddUntilStep("wait for dialog display", () => Game.Dependencies.Get<DialogOverlay>().IsLoaded);
+
+            AddAssert("screen didn't change", () => Game.ScreenStack.CurrentScreen == screenWithNestedStack);
+            AddAssert("nested screen didn't change", () => screenWithNestedStack.SubScreenStack.CurrentScreen == screenWithNestedStack.Blocker);
+
+            AddAssert("did not perform", () => !actionPerformed);
+
+            AddAssert("only one exit attempt", () => screenWithNestedStack.Blocker.ExitAttempts == 1);
+
+            if (confirm)
+            {
+                AddStep("accept dialog", () => InputManager.Key(Key.Number1));
+                AddAssert("nested screen changed", () => screenWithNestedStack.SubScreenStack.CurrentScreen != screenWithNestedStack.Blocker);
+                AddUntilStep("did perform", () => actionPerformed);
+            }
+            else
+            {
+                AddStep("cancel dialog", () => InputManager.Key(Key.Number2));
+                AddAssert("screen didn't change", () => Game.ScreenStack.CurrentScreen == screenWithNestedStack);
+                AddAssert("nested screen didn't change", () => screenWithNestedStack.SubScreenStack.CurrentScreen == screenWithNestedStack.Blocker);
+                AddAssert("did not perform", () => !actionPerformed);
+            }
+        }
+
         private void importAndWaitForSongSelect()
         {
             AddStep("import beatmap", () => BeatmapImportHelper.LoadQuickOszIntoOsu(Game).WaitSafely());
@@ -200,5 +241,30 @@ namespace osu.Game.Tests.Visual.Navigation
                 return base.OnExiting(next);
             }
         }
+
+        public class TestScreenWithNestedStack : OsuScreen, IHasSubScreenStack
+        {
+            public DialogBlockingScreen Blocker { get; private set; }
+
+            public ScreenStack SubScreenStack { get; } = new ScreenStack();
+
+            public TestScreenWithNestedStack()
+            {
+                AddInternal(SubScreenStack);
+
+                SubScreenStack.Push(Blocker = new DialogBlockingScreen());
+            }
+
+            public override bool OnExiting(IScreen next)
+            {
+                if (SubScreenStack.CurrentScreen != null)
+                {
+                    SubScreenStack.CurrentScreen.Exit();
+                    return true;
+                }
+
+                return base.OnExiting(next);
+            }
+        }
     }
 }

From f9d9e6aa61ee45c7d605441ea77a6892a1f07ce8 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 14 Apr 2022 15:58:03 +0900
Subject: [PATCH 4058/5547] Ensure popup dialogs are hidden before running any
 associated actions

---
 osu.Game/Overlays/Dialog/PopupDialog.cs | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Overlays/Dialog/PopupDialog.cs b/osu.Game/Overlays/Dialog/PopupDialog.cs
index a70a7f26cc..f5e6aed41b 100644
--- a/osu.Game/Overlays/Dialog/PopupDialog.cs
+++ b/osu.Game/Overlays/Dialog/PopupDialog.cs
@@ -87,10 +87,13 @@ namespace osu.Game.Overlays.Dialog
                     {
                         if (actionInvoked) return;
 
+                        // Hide the dialog before running the action.
+                        // This is important as the code which is performed may check for a dialog being present (ie. `OsuGame.PerformFromScreen`)
+                        // and we don't want it to see the already dismissed dialog.
+                        Hide();
+
                         actionInvoked = true;
                         action?.Invoke();
-
-                        Hide();
                     };
                 }
             }

From 2bc4bb9e206dd4c7ec337ddd44c8690ffe8ad787 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 14 Apr 2022 16:03:34 +0900
Subject: [PATCH 4059/5547] Consider `SubScreenStack`s when allowing for exit
 confirmation sequence in `PerformFromMenuRunner`

---
 osu.Game/PerformFromMenuRunner.cs | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/osu.Game/PerformFromMenuRunner.cs b/osu.Game/PerformFromMenuRunner.cs
index 6f979b8dc8..7f0db96e6d 100644
--- a/osu.Game/PerformFromMenuRunner.cs
+++ b/osu.Game/PerformFromMenuRunner.cs
@@ -125,6 +125,18 @@ namespace osu.Game
         /// <returns>Whether a dialog blocked interaction.</returns>
         private bool checkForDialog(IScreen current)
         {
+            // An exit process may traverse multiple levels.
+            // When checking for dismissing dialogs, let's also consider sub screens.
+            while (current is IHasSubScreenStack currentWithSubScreenStack)
+            {
+                var nestedCurrent = currentWithSubScreenStack.SubScreenStack.CurrentScreen;
+
+                if (nestedCurrent == null)
+                    break;
+
+                current = nestedCurrent;
+            }
+
             var currentDialog = dialogOverlay.CurrentDialog;
 
             if (lastEncounteredDialog != null)

From 8b901fe60b2b4de540008ac3efab127213e02bdb Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 14 Apr 2022 16:22:40 +0900
Subject: [PATCH 4060/5547] Fix potential null reference when running recursive
 `findValidTarget`

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

diff --git a/osu.Game/PerformFromMenuRunner.cs b/osu.Game/PerformFromMenuRunner.cs
index 7f0db96e6d..528470768c 100644
--- a/osu.Game/PerformFromMenuRunner.cs
+++ b/osu.Game/PerformFromMenuRunner.cs
@@ -97,11 +97,14 @@ namespace osu.Game
                 // if this has a sub stack, recursively check the screens within it.
                 if (current is IHasSubScreenStack currentSubScreen)
                 {
-                    if (findValidTarget(currentSubScreen.SubScreenStack.CurrentScreen))
+                    var nestedCurrent = currentSubScreen.SubScreenStack.CurrentScreen;
+
+                    if (nestedCurrent != null)
                     {
                         // should be correct in theory, but currently untested/unused in existing implementations.
-                        current.MakeCurrent();
-                        return true;
+                        // note that calling findValidTarget actually performs the final operation.
+                        if (findValidTarget(nestedCurrent))
+                            return true;
                     }
                 }
 

From 58d5cf4560d35f5100681d1dd069e8424f31d16d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 14 Apr 2022 16:37:59 +0900
Subject: [PATCH 4061/5547] Remove unused using statement

---
 osu.Game.Tests/Visual/Navigation/TestScenePerformFromScreen.cs | 1 -
 1 file changed, 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/Navigation/TestScenePerformFromScreen.cs b/osu.Game.Tests/Visual/Navigation/TestScenePerformFromScreen.cs
index 5c5d6679aa..f045e3a3e8 100644
--- a/osu.Game.Tests/Visual/Navigation/TestScenePerformFromScreen.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestScenePerformFromScreen.cs
@@ -10,7 +10,6 @@ using osu.Framework.Screens;
 using osu.Framework.Testing;
 using osu.Game.Overlays;
 using osu.Game.Screens;
-using osu.Game.Screens.Edit;
 using osu.Game.Screens.Menu;
 using osu.Game.Screens.Play;
 using osu.Game.Tests.Beatmaps.IO;

From e010dfb1500c445ba8016ae9eb3eee2305d113ed Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 14 Apr 2022 17:32:47 +0900
Subject: [PATCH 4062/5547] Handle virtual track string to avoid throwing later
 in lookup

---
 osu.Game/Beatmaps/WorkingBeatmapCache.cs | 14 +++++++++++++-
 1 file changed, 13 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Beatmaps/WorkingBeatmapCache.cs b/osu.Game/Beatmaps/WorkingBeatmapCache.cs
index 7d28208157..bc810ee35e 100644
--- a/osu.Game/Beatmaps/WorkingBeatmapCache.cs
+++ b/osu.Game/Beatmaps/WorkingBeatmapCache.cs
@@ -26,6 +26,11 @@ namespace osu.Game.Beatmaps
     {
         private readonly WeakList<BeatmapManagerWorkingBeatmap> workingCache = new WeakList<BeatmapManagerWorkingBeatmap>();
 
+        /// <summary>
+        /// Beatmap files may specify this filename to denote that they don't have an audio track.
+        /// </summary>
+        private const string virtual_track_filename = @"virtual";
+
         /// <summary>
         /// A default representation of a WorkingBeatmap to use when no beatmap is available.
         /// </summary>
@@ -40,7 +45,8 @@ namespace osu.Game.Beatmaps
         [CanBeNull]
         private readonly GameHost host;
 
-        public WorkingBeatmapCache(ITrackStore trackStore, AudioManager audioManager, IResourceStore<byte[]> resources, IResourceStore<byte[]> files, WorkingBeatmap defaultBeatmap = null, GameHost host = null)
+        public WorkingBeatmapCache(ITrackStore trackStore, AudioManager audioManager, IResourceStore<byte[]> resources, IResourceStore<byte[]> files, WorkingBeatmap defaultBeatmap = null,
+                                   GameHost host = null)
         {
             DefaultBeatmap = defaultBeatmap;
 
@@ -157,6 +163,9 @@ namespace osu.Game.Beatmaps
                 if (string.IsNullOrEmpty(Metadata?.AudioFile))
                     return null;
 
+                if (Metadata.AudioFile == virtual_track_filename)
+                    return null;
+
                 try
                 {
                     return resources.Tracks.Get(BeatmapSetInfo.GetPathForFile(Metadata.AudioFile));
@@ -173,6 +182,9 @@ namespace osu.Game.Beatmaps
                 if (string.IsNullOrEmpty(Metadata?.AudioFile))
                     return null;
 
+                if (Metadata.AudioFile == virtual_track_filename)
+                    return null;
+
                 try
                 {
                     var trackData = GetStream(BeatmapSetInfo.GetPathForFile(Metadata.AudioFile));

From 1fdf742d3888fca4cf89e26f441ab4ef0b8e3a7d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 14 Apr 2022 17:51:50 +0900
Subject: [PATCH 4063/5547] Fix potentially incorrect button being pressed
 during `PopupDialog` hide due to flag set too late

---
 osu.Game/Overlays/Dialog/PopupDialog.cs | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/Dialog/PopupDialog.cs b/osu.Game/Overlays/Dialog/PopupDialog.cs
index f5e6aed41b..6159ab59f0 100644
--- a/osu.Game/Overlays/Dialog/PopupDialog.cs
+++ b/osu.Game/Overlays/Dialog/PopupDialog.cs
@@ -87,12 +87,13 @@ namespace osu.Game.Overlays.Dialog
                     {
                         if (actionInvoked) return;
 
+                        actionInvoked = true;
+
                         // Hide the dialog before running the action.
                         // This is important as the code which is performed may check for a dialog being present (ie. `OsuGame.PerformFromScreen`)
                         // and we don't want it to see the already dismissed dialog.
                         Hide();
 
-                        actionInvoked = true;
                         action?.Invoke();
                     };
                 }

From c8db7cf2a89dec23eec10b0ec217ef28802dd47a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 14 Apr 2022 18:09:23 +0900
Subject: [PATCH 4064/5547] Reset audio offset before each test run in
 `TestSceneMasterGameplayClockContainer`

---
 .../Gameplay/TestSceneMasterGameplayClockContainer.cs       | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/osu.Game.Tests/Gameplay/TestSceneMasterGameplayClockContainer.cs b/osu.Game.Tests/Gameplay/TestSceneMasterGameplayClockContainer.cs
index 75be7b0362..5c04ac88a7 100644
--- a/osu.Game.Tests/Gameplay/TestSceneMasterGameplayClockContainer.cs
+++ b/osu.Game.Tests/Gameplay/TestSceneMasterGameplayClockContainer.cs
@@ -26,6 +26,12 @@ namespace osu.Game.Tests.Gameplay
             Dependencies.Cache(localConfig = new OsuConfigManager(LocalStorage));
         }
 
+        [SetUpSteps]
+        public void SetUpSteps()
+        {
+            AddStep("reset audio offset", () => localConfig.SetValue(OsuSetting.AudioOffset, 0.0));
+        }
+
         [Test]
         public void TestStartThenElapsedTime()
         {

From 2abdbe53e7e90a7dfb86541ee475a93fe4ec6665 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 14 Apr 2022 18:55:12 +0900
Subject: [PATCH 4065/5547] Cleanup whitespace

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

diff --git a/osu.Game/Screens/Play/MasterGameplayClockContainer.cs b/osu.Game/Screens/Play/MasterGameplayClockContainer.cs
index c5a5c14070..ea43fb1546 100644
--- a/osu.Game/Screens/Play/MasterGameplayClockContainer.cs
+++ b/osu.Game/Screens/Play/MasterGameplayClockContainer.cs
@@ -251,7 +251,6 @@ namespace osu.Game.Screens.Play
         }
 
         private class HardwareCorrectionOffsetClock : FramedOffsetClock
-
         {
             private readonly BindableDouble pauseRateAdjust;
 
@@ -297,7 +296,6 @@ namespace osu.Game.Screens.Play
         }
 
         private class MasterGameplayClock : GameplayClock
-
         {
             public readonly List<Bindable<double>> MutableNonGameplayAdjustments = new List<Bindable<double>>();
             public override IEnumerable<Bindable<double>> NonGameplayAdjustments => MutableNonGameplayAdjustments;

From 392ce7390e179d58ae582afcb3bd8e393f844236 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 14 Apr 2022 18:58:16 +0900
Subject: [PATCH 4066/5547] Add test scene covering `ScalingContainer` delayed
 animations

---
 .../TestSceneScalingContainer.cs              | 114 ++++++++++++++++++
 1 file changed, 114 insertions(+)
 create mode 100644 osu.Game.Tests/Visual/UserInterface/TestSceneScalingContainer.cs

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneScalingContainer.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneScalingContainer.cs
new file mode 100644
index 0000000000..5d554719a5
--- /dev/null
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneScalingContainer.cs
@@ -0,0 +1,114 @@
+// 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.Graphics.Primitives;
+using osu.Framework.Graphics.Shapes;
+using osu.Game.Configuration;
+using osu.Game.Graphics.Containers;
+using osuTK;
+using osuTK.Graphics;
+
+namespace osu.Game.Tests.Visual.UserInterface
+{
+    [TestFixture]
+    public class TestSceneScalingContainer : OsuTestScene
+    {
+        private OsuConfigManager osuConfigManager { get; set; }
+
+        private ScalingContainer scaling1;
+        private ScalingContainer scaling2;
+        private Box scaleTarget;
+
+        [BackgroundDependencyLoader]
+        private void load()
+        {
+            osuConfigManager = new OsuConfigManager(LocalStorage);
+
+            Dependencies.CacheAs(osuConfigManager);
+
+            Children = new Drawable[]
+            {
+                new Container
+                {
+                    RelativeSizeAxes = Axes.Both,
+                    Children = new Drawable[]
+                    {
+                        scaling1 = new ScalingContainer(ScalingMode.Everything)
+                        {
+                            Anchor = Anchor.Centre,
+                            Origin = Anchor.Centre,
+                            Scale = new Vector2(0.8f),
+                            Children = new Drawable[]
+                            {
+                                scaling2 = new ScalingContainer(ScalingMode.Everything)
+                                {
+                                    Anchor = Anchor.Centre,
+                                    Origin = Anchor.Centre,
+                                    Scale = new Vector2(0.8f),
+                                    Children = new Drawable[]
+                                    {
+                                        new Box
+                                        {
+                                            Colour = Color4.Purple,
+                                            RelativeSizeAxes = Axes.Both,
+                                        },
+                                        scaleTarget = new Box
+                                        {
+                                            Anchor = Anchor.Centre,
+                                            Origin = Anchor.Centre,
+                                            Colour = Color4.White,
+                                            Size = new Vector2(100),
+                                        },
+                                    }
+                                }
+                            }
+                        }
+                    }
+                },
+            };
+        }
+
+        [Test]
+        public void TestScaling()
+        {
+            AddStep("adjust scale", () => osuConfigManager.SetValue(OsuSetting.UIScale, 2f));
+
+            checkForCorrectness();
+
+            AddStep("adjust scale", () => osuConfigManager.SetValue(OsuSetting.UIScale, 0.5f));
+
+            checkForCorrectness();
+        }
+
+        private void checkForCorrectness()
+        {
+            Quad? scaling1LastQuad = null;
+            Quad? scaling2LastQuad = null;
+            Quad? scalingTargetLastQuad = null;
+
+            AddUntilStep("ensure dimensions don't change", () =>
+            {
+                if (scaling1LastQuad.HasValue && scaling2LastQuad.HasValue)
+                {
+                    // check inter-frame changes to make sure they match expectations.
+                    Assert.That(scaling1.ScreenSpaceDrawQuad.AlmostEquals(scaling1LastQuad.Value), Is.True);
+                    Assert.That(scaling2.ScreenSpaceDrawQuad.AlmostEquals(scaling2LastQuad.Value), Is.True);
+                }
+
+                scaling1LastQuad = scaling1.ScreenSpaceDrawQuad;
+                scaling2LastQuad = scaling2.ScreenSpaceDrawQuad;
+
+                // wait for scaling to stop.
+                bool scalingFinished = scalingTargetLastQuad.HasValue && scaleTarget.ScreenSpaceDrawQuad.AlmostEquals(scalingTargetLastQuad.Value);
+
+                scalingTargetLastQuad = scaleTarget.ScreenSpaceDrawQuad;
+
+                return scalingFinished;
+            });
+        }
+    }
+}

From bb4322a4c488a429580bbd191e4e5415de96679f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 14 Apr 2022 18:58:20 +0900
Subject: [PATCH 4067/5547] Fix UI scale being applied unevenly, causing
 elements to move around relative to each other

---
 .../Graphics/Containers/ScalingContainer.cs     | 17 +++++++++++++----
 1 file changed, 13 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Graphics/Containers/ScalingContainer.cs b/osu.Game/Graphics/Containers/ScalingContainer.cs
index 58d18e1b21..12e570d62d 100644
--- a/osu.Game/Graphics/Containers/ScalingContainer.cs
+++ b/osu.Game/Graphics/Containers/ScalingContainer.cs
@@ -21,6 +21,8 @@ namespace osu.Game.Graphics.Containers
     /// </summary>
     public class ScalingContainer : Container
     {
+        private const float duration = 500;
+
         private Bindable<float> sizeX;
         private Bindable<float> sizeY;
         private Bindable<float> posX;
@@ -82,6 +84,8 @@ namespace osu.Game.Graphics.Containers
             private readonly bool applyUIScale;
             private Bindable<float> uiScale;
 
+            private readonly Bindable<float> currentScale = new Bindable<float>(1);
+
             public override bool ReceivePositionalInputAt(Vector2 screenSpacePos) => true;
 
             public ScalingDrawSizePreservingFillContainer(bool applyUIScale)
@@ -101,8 +105,15 @@ namespace osu.Game.Graphics.Containers
 
             private void scaleChanged(ValueChangedEvent<float> args)
             {
-                this.ScaleTo(new Vector2(args.NewValue), 500, Easing.Out);
-                this.ResizeTo(new Vector2(1 / args.NewValue), 500, Easing.Out);
+                this.TransformBindableTo(currentScale, args.NewValue, duration, Easing.OutQuart);
+            }
+
+            protected override void Update()
+            {
+                Scale = new Vector2(currentScale.Value);
+                Size = new Vector2(1 / currentScale.Value);
+
+                base.Update();
             }
         }
 
@@ -140,8 +151,6 @@ namespace osu.Game.Graphics.Containers
 
         private void updateSize()
         {
-            const float duration = 500;
-
             if (targetMode == ScalingMode.Everything)
             {
                 // the top level scaling container manages the background to be displayed while scaling.

From 7582c2a5e8f5cab06caeda0d3831026f6e644b6d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 14 Apr 2022 19:13:54 +0900
Subject: [PATCH 4068/5547] Remove unnecessary bindable

---
 osu.Game/Graphics/Containers/ScalingContainer.cs | 13 ++++---------
 1 file changed, 4 insertions(+), 9 deletions(-)

diff --git a/osu.Game/Graphics/Containers/ScalingContainer.cs b/osu.Game/Graphics/Containers/ScalingContainer.cs
index 12e570d62d..ca8b6f388f 100644
--- a/osu.Game/Graphics/Containers/ScalingContainer.cs
+++ b/osu.Game/Graphics/Containers/ScalingContainer.cs
@@ -84,7 +84,7 @@ namespace osu.Game.Graphics.Containers
             private readonly bool applyUIScale;
             private Bindable<float> uiScale;
 
-            private readonly Bindable<float> currentScale = new Bindable<float>(1);
+            private float currentScale = 1;
 
             public override bool ReceivePositionalInputAt(Vector2 screenSpacePos) => true;
 
@@ -99,19 +99,14 @@ namespace osu.Game.Graphics.Containers
                 if (applyUIScale)
                 {
                     uiScale = osuConfig.GetBindable<float>(OsuSetting.UIScale);
-                    uiScale.BindValueChanged(scaleChanged, true);
+                    uiScale.BindValueChanged(args => this.TransformTo(nameof(currentScale), args.NewValue, duration, Easing.OutQuart), true);
                 }
             }
 
-            private void scaleChanged(ValueChangedEvent<float> args)
-            {
-                this.TransformBindableTo(currentScale, args.NewValue, duration, Easing.OutQuart);
-            }
-
             protected override void Update()
             {
-                Scale = new Vector2(currentScale.Value);
-                Size = new Vector2(1 / currentScale.Value);
+                Scale = new Vector2(currentScale);
+                Size = new Vector2(1 / currentScale);
 
                 base.Update();
             }

From 566a20a623a5d82f73d4e11f6c2ea9836ce14566 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 14 Apr 2022 13:27:06 +0300
Subject: [PATCH 4069/5547] Add keyword "delay" to hold-to-confirm activation
 time setting

---
 .../Overlays/Settings/Sections/UserInterface/GeneralSettings.cs  | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Game/Overlays/Settings/Sections/UserInterface/GeneralSettings.cs b/osu.Game/Overlays/Settings/Sections/UserInterface/GeneralSettings.cs
index 59894cbcae..6e1558f7d7 100644
--- a/osu.Game/Overlays/Settings/Sections/UserInterface/GeneralSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/UserInterface/GeneralSettings.cs
@@ -39,6 +39,7 @@ namespace osu.Game.Overlays.Settings.Sections.UserInterface
                 {
                     LabelText = UserInterfaceStrings.HoldToConfirmActivationTime,
                     Current = config.GetBindable<double>(OsuSetting.UIHoldActivationDelay),
+                    Keywords = new[] { @"delay" },
                     KeyboardStep = 50
                 },
             };

From 74bfb25c78d58ad5cc8dacb1f04428f703f6a586 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 14 Apr 2022 19:30:02 +0900
Subject: [PATCH 4070/5547] Commit new rider metadata changes

---
 .idea/.idea.osu.Desktop/.idea/misc.xml | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/.idea/.idea.osu.Desktop/.idea/misc.xml b/.idea/.idea.osu.Desktop/.idea/misc.xml
index 1d8c84d0af..4e1d56f4dd 100644
--- a/.idea/.idea.osu.Desktop/.idea/misc.xml
+++ b/.idea/.idea.osu.Desktop/.idea/misc.xml
@@ -1,5 +1,10 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <project version="4">
+  <component name="SwUserDefinedSpecifications">
+    <option name="specTypeByUrl">
+      <map />
+    </option>
+  </component>
   <component name="com.jetbrains.rider.android.RiderAndroidMiscFileCreationComponent">
     <option name="ENSURE_MISC_FILE_EXISTS" value="true" />
   </component>

From 59bb6b8f7cbbde0078a51c88e51245bdc9ea88c3 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 14 Apr 2022 13:43:09 +0300
Subject: [PATCH 4071/5547] Add background dim effect to inactive settings
 sections

---
 osu.Game/Overlays/Settings/SettingsSection.cs | 53 +++++++++++++------
 1 file changed, 36 insertions(+), 17 deletions(-)

diff --git a/osu.Game/Overlays/Settings/SettingsSection.cs b/osu.Game/Overlays/Settings/SettingsSection.cs
index 2539c32806..50a82b3d96 100644
--- a/osu.Game/Overlays/Settings/SettingsSection.cs
+++ b/osu.Game/Overlays/Settings/SettingsSection.cs
@@ -13,6 +13,7 @@ using osu.Framework.Localisation;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
 using osuTK;
+using osuTK.Graphics;
 
 namespace osu.Game.Overlays.Settings
 {
@@ -23,6 +24,8 @@ namespace osu.Game.Overlays.Settings
 
         private IBindable<SettingsSection> selectedSection;
 
+        private Box dim;
+
         private OsuSpriteText header;
 
         public abstract Drawable CreateIcon();
@@ -78,25 +81,40 @@ namespace osu.Game.Overlays.Settings
                 },
                 new Container
                 {
-                    Padding = new MarginPadding
-                    {
-                        Top = 28,
-                        Bottom = 40,
-                    },
+                    Padding = new MarginPadding { Top = border_size },
                     RelativeSizeAxes = Axes.X,
                     AutoSizeAxes = Axes.Y,
                     Children = new Drawable[]
                     {
-                        header = new OsuSpriteText
+                        dim = new Box
                         {
-                            Font = OsuFont.TorusAlternate.With(size: header_size),
-                            Text = Header,
-                            Margin = new MarginPadding
-                            {
-                                Horizontal = SettingsPanel.CONTENT_MARGINS
-                            }
+                            RelativeSizeAxes = Axes.Both,
+                            Colour = Color4.Black,
+                            Alpha = 0f,
                         },
-                        FlowContent
+                        new Container
+                        {
+                            RelativeSizeAxes = Axes.X,
+                            AutoSizeAxes = Axes.Y,
+                            Padding = new MarginPadding
+                            {
+                                Top = 24,
+                                Bottom = 40,
+                            },
+                            Children = new Drawable[]
+                            {
+                                header = new OsuSpriteText
+                                {
+                                    Font = OsuFont.TorusAlternate.With(size: header_size),
+                                    Text = Header,
+                                    Margin = new MarginPadding
+                                    {
+                                        Horizontal = SettingsPanel.CONTENT_MARGINS
+                                    }
+                                },
+                                FlowContent
+                            }
+                        }
                     }
                 },
             });
@@ -135,15 +153,16 @@ namespace osu.Game.Overlays.Settings
         private void updateContentFade()
         {
             float contentFade = 1;
-            float headerFade = 1;
+            float dimFade = 0;
 
             if (!isCurrentSection)
             {
-                contentFade = 0.25f;
-                headerFade = IsHovered ? 0.5f : 0.25f;
+                contentFade = IsHovered ? 0.5f : 0.25f;
+                dimFade = IsHovered ? 0.125f : 0.25f;
             }
 
-            header.FadeTo(headerFade, 500, Easing.OutQuint);
+            dim.FadeTo(dimFade, 500, Easing.OutQuint);
+            header.FadeTo(contentFade, 500, Easing.OutQuint);
             FlowContent.FadeTo(contentFade, 500, Easing.OutQuint);
         }
     }

From 50a478ea5f3a5538eca5d9254644f9286680809c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 14 Apr 2022 20:05:13 +0900
Subject: [PATCH 4072/5547] Add failing test coverage of searching too fast not
 hiding filtered settings

---
 .../Visual/Settings/TestSceneSettingsPanel.cs | 22 +++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/osu.Game.Tests/Visual/Settings/TestSceneSettingsPanel.cs b/osu.Game.Tests/Visual/Settings/TestSceneSettingsPanel.cs
index f9c9b2a68b..0de1cedd0c 100644
--- a/osu.Game.Tests/Visual/Settings/TestSceneSettingsPanel.cs
+++ b/osu.Game.Tests/Visual/Settings/TestSceneSettingsPanel.cs
@@ -4,10 +4,12 @@
 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.UserInterface;
 using osu.Game.Overlays;
+using osu.Game.Overlays.Settings;
 using osu.Game.Overlays.Settings.Sections;
 using osu.Game.Overlays.Settings.Sections.Input;
 using osuTK.Input;
@@ -34,6 +36,26 @@ namespace osu.Game.Tests.Visual.Settings
             });
         }
 
+        [Test]
+        public void TestQuickFiltering()
+        {
+            AddStep("set filter", () =>
+            {
+                settings.SectionsContainer.ChildrenOfType<SearchTextBox>().First().Current.Value = "scaling";
+            });
+
+            AddUntilStep("wait for items to load", () => settings.SectionsContainer.ChildrenOfType<IFilterable>().Any());
+
+            AddAssert("ensure all items match filter", () => settings.SectionsContainer
+                                                                     .ChildrenOfType<SettingsSection>().Where(f => f.IsPresent)
+                                                                     .All(section =>
+                                                                         section.ChildrenOfType<Drawable>().Where(f => f.IsPresent)
+                                                                                .OfType<IFilterable>()
+                                                                                .Where(f => !(f is IHasFilterableChildren))
+                                                                                .All(f => f.FilterTerms.Any(t => t.Contains("scaling")))
+                                                                     ));
+        }
+
         [Test]
         public void ToggleVisibility()
         {

From 296420ae08b41305e179dfcd0cf0f935971e8ed1 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 14 Apr 2022 20:06:00 +0900
Subject: [PATCH 4073/5547] Fix settings textbox focus operation running too
 late

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

diff --git a/osu.Game/Overlays/SettingsPanel.cs b/osu.Game/Overlays/SettingsPanel.cs
index b11b6fde27..ea386e26c6 100644
--- a/osu.Game/Overlays/SettingsPanel.cs
+++ b/osu.Game/Overlays/SettingsPanel.cs
@@ -163,6 +163,7 @@ namespace osu.Game.Overlays
             Sidebar?.MoveToX(0, TRANSITION_LENGTH, Easing.OutQuint);
             this.FadeTo(1, TRANSITION_LENGTH, Easing.OutQuint);
 
+            searchTextBox.TakeFocus();
             searchTextBox.HoldFocus = true;
         }
 
@@ -213,7 +214,6 @@ namespace osu.Game.Overlays
                 loading.Hide();
 
                 searchTextBox.Current.BindValueChanged(term => SectionsContainer.SearchTerm = term.NewValue, true);
-                searchTextBox.TakeFocus();
 
                 loadSidebarButtons();
             });

From 9c7af9898213d92e214e6e8683a52c8265292f29 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 14 Apr 2022 20:06:15 +0900
Subject: [PATCH 4074/5547] Fix alpha cross-talk causing settings to
 potentially not filter when they should

---
 osu.Game/Overlays/Settings/SettingsItem.cs    | 7 +++----
 osu.Game/Overlays/Settings/SettingsSection.cs | 7 +++----
 2 files changed, 6 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Overlays/Settings/SettingsItem.cs b/osu.Game/Overlays/Settings/SettingsItem.cs
index 098090bf78..2d139a01e9 100644
--- a/osu.Game/Overlays/Settings/SettingsItem.cs
+++ b/osu.Game/Overlays/Settings/SettingsItem.cs
@@ -100,10 +100,9 @@ namespace osu.Game.Overlays.Settings
 
         public IEnumerable<string> Keywords { get; set; }
 
-        public bool MatchingFilter
-        {
-            set => Alpha = value ? 1 : 0;
-        }
+        public override bool IsPresent => MatchingFilter;
+
+        public bool MatchingFilter { get; set; }
 
         public bool FilteringActive { get; set; }
 
diff --git a/osu.Game/Overlays/Settings/SettingsSection.cs b/osu.Game/Overlays/Settings/SettingsSection.cs
index 2539c32806..a39aacf6b8 100644
--- a/osu.Game/Overlays/Settings/SettingsSection.cs
+++ b/osu.Game/Overlays/Settings/SettingsSection.cs
@@ -21,6 +21,8 @@ namespace osu.Game.Overlays.Settings
         protected FillFlowContainer FlowContent;
         protected override Container<Drawable> Content => FlowContent;
 
+        public override bool IsPresent => MatchingFilter;
+
         private IBindable<SettingsSection> selectedSection;
 
         private OsuSpriteText header;
@@ -36,10 +38,7 @@ namespace osu.Game.Overlays.Settings
         private const int header_size = 24;
         private const int border_size = 4;
 
-        public bool MatchingFilter
-        {
-            set => this.FadeTo(value ? 1 : 0);
-        }
+        public bool MatchingFilter { get; set; }
 
         public bool FilteringActive { get; set; }
 

From 21a5a2fd697322acdbc535797b9b6727a7023e97 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 14 Apr 2022 20:36:48 +0900
Subject: [PATCH 4075/5547] Add failing test coverage of incorrect current
 section after quick setting search

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

diff --git a/osu.Game.Tests/Visual/Settings/TestSceneSettingsPanel.cs b/osu.Game.Tests/Visual/Settings/TestSceneSettingsPanel.cs
index 0de1cedd0c..66242b19cd 100644
--- a/osu.Game.Tests/Visual/Settings/TestSceneSettingsPanel.cs
+++ b/osu.Game.Tests/Visual/Settings/TestSceneSettingsPanel.cs
@@ -54,6 +54,8 @@ namespace osu.Game.Tests.Visual.Settings
                                                                                 .Where(f => !(f is IHasFilterableChildren))
                                                                                 .All(f => f.FilterTerms.Any(t => t.Contains("scaling")))
                                                                      ));
+
+            AddAssert("ensure section is current", () => settings.CurrentSection.Value != null);
         }
 
         [Test]

From 316c0845ec8f56c92d36ea702038b3ec545e24e1 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 14 Apr 2022 20:36:11 +0900
Subject: [PATCH 4076/5547] Fix current section not being correct after early
 search

---
 osu.Game/Overlays/SettingsPanel.cs | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/SettingsPanel.cs b/osu.Game/Overlays/SettingsPanel.cs
index ea386e26c6..8c1129508a 100644
--- a/osu.Game/Overlays/SettingsPanel.cs
+++ b/osu.Game/Overlays/SettingsPanel.cs
@@ -287,7 +287,10 @@ namespace osu.Game.Overlays
                 set
                 {
                     SearchContainer.SearchTerm = value;
-                    InvalidateScrollPosition();
+
+                    // Schedule required as search term takes a frame to update.
+                    // Without this sections may not be in the correct state to ascertain CurrentSection.
+                    Schedule(InvalidateScrollPosition);
                 }
             }
 

From f19208a2451d26a7973f2361b3d7e4250964ffed Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 14 Apr 2022 21:04:52 +0900
Subject: [PATCH 4077/5547] Move dim layer to top and only apply dimming at one
 location

---
 osu.Game/Overlays/Settings/SettingsSection.cs | 29 +++++++------------
 1 file changed, 10 insertions(+), 19 deletions(-)

diff --git a/osu.Game/Overlays/Settings/SettingsSection.cs b/osu.Game/Overlays/Settings/SettingsSection.cs
index 50a82b3d96..49f0d5c153 100644
--- a/osu.Game/Overlays/Settings/SettingsSection.cs
+++ b/osu.Game/Overlays/Settings/SettingsSection.cs
@@ -13,7 +13,6 @@ using osu.Framework.Localisation;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
 using osuTK;
-using osuTK.Graphics;
 
 namespace osu.Game.Overlays.Settings
 {
@@ -26,8 +25,6 @@ namespace osu.Game.Overlays.Settings
 
         private Box dim;
 
-        private OsuSpriteText header;
-
         public abstract Drawable CreateIcon();
         public abstract LocalisableString Header { get; }
 
@@ -86,12 +83,6 @@ namespace osu.Game.Overlays.Settings
                     AutoSizeAxes = Axes.Y,
                     Children = new Drawable[]
                     {
-                        dim = new Box
-                        {
-                            RelativeSizeAxes = Axes.Both,
-                            Colour = Color4.Black,
-                            Alpha = 0f,
-                        },
                         new Container
                         {
                             RelativeSizeAxes = Axes.X,
@@ -103,7 +94,7 @@ namespace osu.Game.Overlays.Settings
                             },
                             Children = new Drawable[]
                             {
-                                header = new OsuSpriteText
+                                new OsuSpriteText
                                 {
                                     Font = OsuFont.TorusAlternate.With(size: header_size),
                                     Text = Header,
@@ -114,7 +105,13 @@ namespace osu.Game.Overlays.Settings
                                 },
                                 FlowContent
                             }
-                        }
+                        },
+                        dim = new Box
+                        {
+                            RelativeSizeAxes = Axes.Both,
+                            Colour = colourProvider.Background5,
+                            Alpha = 0f,
+                        },
                     }
                 },
             });
@@ -152,18 +149,12 @@ namespace osu.Game.Overlays.Settings
 
         private void updateContentFade()
         {
-            float contentFade = 1;
             float dimFade = 0;
 
             if (!isCurrentSection)
-            {
-                contentFade = IsHovered ? 0.5f : 0.25f;
-                dimFade = IsHovered ? 0.125f : 0.25f;
-            }
+                dimFade = IsHovered ? 0.5f : 0.8f;
 
-            dim.FadeTo(dimFade, 500, Easing.OutQuint);
-            header.FadeTo(contentFade, 500, Easing.OutQuint);
-            FlowContent.FadeTo(contentFade, 500, Easing.OutQuint);
+            dim.FadeTo(dimFade, 300, Easing.OutQuint);
         }
     }
 }

From 9240148c8e817869fcddc59f093f2eeb916c13dc Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 14 Apr 2022 21:16:54 +0900
Subject: [PATCH 4078/5547] Avoid initial fade of dim layer

---
 osu.Game/Overlays/Settings/SettingsSection.cs | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Overlays/Settings/SettingsSection.cs b/osu.Game/Overlays/Settings/SettingsSection.cs
index 49f0d5c153..6645d20dbe 100644
--- a/osu.Game/Overlays/Settings/SettingsSection.cs
+++ b/osu.Game/Overlays/Settings/SettingsSection.cs
@@ -25,6 +25,8 @@ namespace osu.Game.Overlays.Settings
 
         private Box dim;
 
+        private const float inactive_alpha = 0.8f;
+
         public abstract Drawable CreateIcon();
         public abstract LocalisableString Header { get; }
 
@@ -110,7 +112,7 @@ namespace osu.Game.Overlays.Settings
                         {
                             RelativeSizeAxes = Axes.Both,
                             Colour = colourProvider.Background5,
-                            Alpha = 0f,
+                            Alpha = inactive_alpha,
                         },
                     }
                 },
@@ -152,7 +154,9 @@ namespace osu.Game.Overlays.Settings
             float dimFade = 0;
 
             if (!isCurrentSection)
-                dimFade = IsHovered ? 0.5f : 0.8f;
+            {
+                dimFade = IsHovered ? 0.5f : inactive_alpha;
+            }
 
             dim.FadeTo(dimFade, 300, Easing.OutQuint);
         }

From b0889590458b16f1c43acb3ec5966af00e72a196 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 14 Apr 2022 21:17:06 +0900
Subject: [PATCH 4079/5547] Reduce settings fade in duration to higher
 alpha/colour cross-talk

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

diff --git a/osu.Game/Overlays/SettingsPanel.cs b/osu.Game/Overlays/SettingsPanel.cs
index b11b6fde27..d5b36713f3 100644
--- a/osu.Game/Overlays/SettingsPanel.cs
+++ b/osu.Game/Overlays/SettingsPanel.cs
@@ -197,7 +197,7 @@ namespace osu.Game.Overlays
             ContentContainer.Margin = new MarginPadding { Left = Sidebar?.DrawWidth ?? 0 };
         }
 
-        private const double fade_in_duration = 1000;
+        private const double fade_in_duration = 500;
 
         private void loadSections()
         {

From c57a918bbba4d3cb329b0c5a130e825d06571f7f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 14 Apr 2022 23:02:00 +0900
Subject: [PATCH 4080/5547] Mark settings elements as matching filter by
 default to handle cases where no filtering is provided

---
 osu.Game/Overlays/Settings/SettingsItem.cs    | 2 +-
 osu.Game/Overlays/Settings/SettingsSection.cs | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Overlays/Settings/SettingsItem.cs b/osu.Game/Overlays/Settings/SettingsItem.cs
index 2d139a01e9..329917d50a 100644
--- a/osu.Game/Overlays/Settings/SettingsItem.cs
+++ b/osu.Game/Overlays/Settings/SettingsItem.cs
@@ -102,7 +102,7 @@ namespace osu.Game.Overlays.Settings
 
         public override bool IsPresent => MatchingFilter;
 
-        public bool MatchingFilter { get; set; }
+        public bool MatchingFilter { get; set; } = true;
 
         public bool FilteringActive { get; set; }
 
diff --git a/osu.Game/Overlays/Settings/SettingsSection.cs b/osu.Game/Overlays/Settings/SettingsSection.cs
index a39aacf6b8..cd012f10c7 100644
--- a/osu.Game/Overlays/Settings/SettingsSection.cs
+++ b/osu.Game/Overlays/Settings/SettingsSection.cs
@@ -38,7 +38,7 @@ namespace osu.Game.Overlays.Settings
         private const int header_size = 24;
         private const int border_size = 4;
 
-        public bool MatchingFilter { get; set; }
+        public bool MatchingFilter { get; set; } = true;
 
         public bool FilteringActive { get; set; }
 

From a0ac316d6e9eed23f86bfe334d34fab6129d834e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 15 Apr 2022 01:41:55 +0900
Subject: [PATCH 4081/5547] Fix test matching conditions

---
 osu.Game.Tests/Visual/Settings/TestSceneSettingsPanel.cs | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/Settings/TestSceneSettingsPanel.cs b/osu.Game.Tests/Visual/Settings/TestSceneSettingsPanel.cs
index 66242b19cd..71c001887a 100644
--- a/osu.Game.Tests/Visual/Settings/TestSceneSettingsPanel.cs
+++ b/osu.Game.Tests/Visual/Settings/TestSceneSettingsPanel.cs
@@ -49,7 +49,8 @@ namespace osu.Game.Tests.Visual.Settings
             AddAssert("ensure all items match filter", () => settings.SectionsContainer
                                                                      .ChildrenOfType<SettingsSection>().Where(f => f.IsPresent)
                                                                      .All(section =>
-                                                                         section.ChildrenOfType<Drawable>().Where(f => f.IsPresent)
+                                                                         section.Children.Where(f => f.IsPresent)
+                                                                                .OfType<ISettingsItem>()
                                                                                 .OfType<IFilterable>()
                                                                                 .Where(f => !(f is IHasFilterableChildren))
                                                                                 .All(f => f.FilterTerms.Any(t => t.Contains("scaling")))

From 6081c29ae17fe8e202d0bc2ebc9b050a6c7a70b8 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 15 Apr 2022 10:18:29 +0900
Subject: [PATCH 4082/5547] Remove ununsed using statement

---
 osu.Game.Tests/Visual/Settings/TestSceneSettingsPanel.cs | 1 -
 1 file changed, 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/Settings/TestSceneSettingsPanel.cs b/osu.Game.Tests/Visual/Settings/TestSceneSettingsPanel.cs
index 71c001887a..6e2ba88ea0 100644
--- a/osu.Game.Tests/Visual/Settings/TestSceneSettingsPanel.cs
+++ b/osu.Game.Tests/Visual/Settings/TestSceneSettingsPanel.cs
@@ -4,7 +4,6 @@
 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.UserInterface;

From 423fae52f7269ea0ce638afb3b0128e3dc41583a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 15 Apr 2022 10:19:36 +0900
Subject: [PATCH 4083/5547] Add back `base.IsPresent` call

---
 osu.Game/Overlays/Settings/SettingsItem.cs    | 2 +-
 osu.Game/Overlays/Settings/SettingsSection.cs | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Overlays/Settings/SettingsItem.cs b/osu.Game/Overlays/Settings/SettingsItem.cs
index 329917d50a..1c5668479f 100644
--- a/osu.Game/Overlays/Settings/SettingsItem.cs
+++ b/osu.Game/Overlays/Settings/SettingsItem.cs
@@ -100,7 +100,7 @@ namespace osu.Game.Overlays.Settings
 
         public IEnumerable<string> Keywords { get; set; }
 
-        public override bool IsPresent => MatchingFilter;
+        public override bool IsPresent => base.IsPresent && MatchingFilter;
 
         public bool MatchingFilter { get; set; } = true;
 
diff --git a/osu.Game/Overlays/Settings/SettingsSection.cs b/osu.Game/Overlays/Settings/SettingsSection.cs
index cd012f10c7..ace618aa46 100644
--- a/osu.Game/Overlays/Settings/SettingsSection.cs
+++ b/osu.Game/Overlays/Settings/SettingsSection.cs
@@ -21,7 +21,7 @@ namespace osu.Game.Overlays.Settings
         protected FillFlowContainer FlowContent;
         protected override Container<Drawable> Content => FlowContent;
 
-        public override bool IsPresent => MatchingFilter;
+        public override bool IsPresent => base.IsPresent && MatchingFilter;
 
         private IBindable<SettingsSection> selectedSection;
 

From a7b04a8c19848c29443378b9c993c81842909c2f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 15 Apr 2022 19:59:38 +0900
Subject: [PATCH 4084/5547] Update framework

---
 osu.Android.props        | 2 +-
 osu.Game/osu.Game.csproj | 2 +-
 osu.iOS.props            | 4 ++--
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Android.props b/osu.Android.props
index 331c4db01f..77deec031b 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -52,7 +52,7 @@
   </ItemGroup>
   <ItemGroup>
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.407.0" />
-    <PackageReference Include="ppy.osu.Framework.Android" Version="2022.408.0" />
+    <PackageReference Include="ppy.osu.Framework.Android" Version="2022.415.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
     <!-- Realm needs to be directly referenced in all Xamarin projects, as it will not pull in its transitive dependencies otherwise. -->
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 308ec7e7d6..cf2245aa3a 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="10.10.0" />
-    <PackageReference Include="ppy.osu.Framework" Version="2022.408.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2022.415.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.407.0" />
     <PackageReference Include="Sentry" Version="3.14.1" />
     <PackageReference Include="SharpCompress" Version="0.30.1" />
diff --git a/osu.iOS.props b/osu.iOS.props
index 311c9ba345..b77dff9f41 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -61,7 +61,7 @@
     <Reference Include="System.Net.Http" />
   </ItemGroup>
   <ItemGroup Label="Package References">
-    <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.408.0" />
+    <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.415.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.407.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net6.0) -->
@@ -84,7 +84,7 @@
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="5.0.14" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.Core" Version="5.0.14" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
-    <PackageReference Include="ppy.osu.Framework" Version="2022.408.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2022.415.0" />
     <PackageReference Include="SharpCompress" Version="0.30.1" />
     <PackageReference Include="NUnit" Version="3.13.2" />
     <PackageReference Include="System.ComponentModel.Annotations" Version="5.0.0" />

From 8e6c0158568462e42d50a23307400de8f2c7cb76 Mon Sep 17 00:00:00 2001
From: Jamie Taylor <me@nekodex.net>
Date: Fri, 15 Apr 2022 20:31:59 +0900
Subject: [PATCH 4085/5547] Use a fallback sample when a MainMenuButton doesn't
 provide a click sample

---
 osu.Game/Screens/Menu/MainMenuButton.cs | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/osu.Game/Screens/Menu/MainMenuButton.cs b/osu.Game/Screens/Menu/MainMenuButton.cs
index 88bea43b23..c07ada9419 100644
--- a/osu.Game/Screens/Menu/MainMenuButton.cs
+++ b/osu.Game/Screens/Menu/MainMenuButton.cs
@@ -185,8 +185,7 @@ namespace osu.Game.Screens.Menu
         private void load(AudioManager audio)
         {
             sampleHover = audio.Samples.Get(@"Menu/button-hover");
-            if (!string.IsNullOrEmpty(sampleName))
-                sampleClick = audio.Samples.Get($@"Menu/{sampleName}");
+            sampleClick = audio.Samples.Get(!string.IsNullOrEmpty(sampleName) ? $@"Menu/{sampleName}" : @"UI/button-select");
         }
 
         protected override bool OnMouseDown(MouseDownEvent e)

From ef5ed262ca83d09bf6cda980fbbbd9201b3eea9e Mon Sep 17 00:00:00 2001
From: Jamie Taylor <me@nekodex.net>
Date: Fri, 15 Apr 2022 20:32:41 +0900
Subject: [PATCH 4086/5547] Add pitch randomisation to the OsuLogo hover sample

---
 osu.Game/Screens/Menu/OsuLogo.cs | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/Menu/OsuLogo.cs b/osu.Game/Screens/Menu/OsuLogo.cs
index c82efe2d32..1d3aef0653 100644
--- a/osu.Game/Screens/Menu/OsuLogo.cs
+++ b/osu.Game/Screens/Menu/OsuLogo.cs
@@ -283,9 +283,15 @@ namespace osu.Game.Screens.Menu
                 this.Delay(early_activation).Schedule(() =>
                 {
                     if (beatIndex % timingPoint.TimeSignature.Numerator == 0)
-                        sampleDownbeat.Play();
+                    {
+                        sampleDownbeat?.Play();
+                    }
                     else
-                        sampleBeat.Play();
+                    {
+                        var channel = sampleBeat.GetChannel();
+                        channel.Frequency.Value = 0.95 + RNG.NextDouble(0.1);
+                        channel.Play();
+                    }
                 });
             }
 

From ceb5b4f9b404b949571c0654858eda885777ea89 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 15 Apr 2022 20:46:49 +0900
Subject: [PATCH 4087/5547] Update resources

---
 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 77deec031b..ec638f7736 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -51,7 +51,7 @@
     <Reference Include="Java.Interop" />
   </ItemGroup>
   <ItemGroup>
-    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.407.0" />
+    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.415.0" />
     <PackageReference Include="ppy.osu.Framework.Android" Version="2022.415.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index cf2245aa3a..be4bee7c9d 100644
--- a/osu.Game/osu.Game.csproj
+++ b/osu.Game/osu.Game.csproj
@@ -36,7 +36,7 @@
     </PackageReference>
     <PackageReference Include="Realm" Version="10.10.0" />
     <PackageReference Include="ppy.osu.Framework" Version="2022.415.0" />
-    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.407.0" />
+    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.415.0" />
     <PackageReference Include="Sentry" Version="3.14.1" />
     <PackageReference Include="SharpCompress" Version="0.30.1" />
     <PackageReference Include="NUnit" Version="3.13.2" />
diff --git a/osu.iOS.props b/osu.iOS.props
index b77dff9f41..0a0cab91a4 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -62,7 +62,7 @@
   </ItemGroup>
   <ItemGroup Label="Package References">
     <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.415.0" />
-    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.407.0" />
+    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.415.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net6.0) -->
   <PropertyGroup>

From f1dd319fd99393c2a9ae2a6741f5621c6d47c77d Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Fri, 15 Apr 2022 15:38:47 +0100
Subject: [PATCH 4088/5547] Implement `ChannelList` for new chat design

Reference design: https://www.figma.com/file/f8b2dHp9LJCMOqYP4mdrPZ/Client%2FChat?node-id=1%3A297

Adds new component `ChannelList` which makes up the sidebar channel
selector of the new chat design. Contains two separate fill flows for
public and private `ChannelItem` child components.

Exposed bindable `SelectorActive` to indicate current state of the "Add
more channels" button. Requires `Bindable<Channel>` from parent
component.

Renames and updates the `TestSceneChannelListItem` to
`TestSceneChannelList` to make use of new component and having both
tests seemed redundant.
---
 .../Visual/Online/TestSceneChannelList.cs     | 187 ++++++++++++++++++
 .../Visual/Online/TestSceneChannelListItem.cs | 163 ---------------
 .../Overlays/Chat/ChannelList/ChannelList.cs  | 174 ++++++++++++++++
 .../Chat/ChannelList/ChannelListSelector.cs   |  84 ++++++++
 4 files changed, 445 insertions(+), 163 deletions(-)
 create mode 100644 osu.Game.Tests/Visual/Online/TestSceneChannelList.cs
 delete mode 100644 osu.Game.Tests/Visual/Online/TestSceneChannelListItem.cs
 create mode 100644 osu.Game/Overlays/Chat/ChannelList/ChannelList.cs
 create mode 100644 osu.Game/Overlays/Chat/ChannelList/ChannelListSelector.cs

diff --git a/osu.Game.Tests/Visual/Online/TestSceneChannelList.cs b/osu.Game.Tests/Visual/Online/TestSceneChannelList.cs
new file mode 100644
index 0000000000..d6a1e71f0d
--- /dev/null
+++ b/osu.Game.Tests/Visual/Online/TestSceneChannelList.cs
@@ -0,0 +1,187 @@
+// 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.Bindables;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
+using osu.Framework.Testing;
+using osu.Framework.Utils;
+using osu.Game.Graphics.Sprites;
+using osu.Game.Online.API.Requests.Responses;
+using osu.Game.Online.Chat;
+using osu.Game.Overlays;
+using osu.Game.Overlays.Chat.ChannelList;
+
+namespace osu.Game.Tests.Visual.Online
+{
+    [TestFixture]
+    public class TestSceneChannelList : OsuTestScene
+    {
+        [Cached]
+        private readonly OverlayColourProvider colourProvider = new OverlayColourProvider(OverlayColourScheme.Pink);
+
+        [Cached]
+        private readonly Bindable<Channel> selected = new Bindable<Channel>();
+
+        private OsuSpriteText selectorText;
+        private OsuSpriteText selectedText;
+        private OsuSpriteText leaveText;
+        private ChannelList channelList;
+
+        [SetUp]
+        public void SetUp()
+        {
+            Schedule(() =>
+            {
+                Child = new GridContainer
+                {
+                    Anchor = Anchor.Centre,
+                    Origin = Anchor.Centre,
+                    RelativeSizeAxes = Axes.Both,
+                    Height = 0.7f,
+                    RowDimensions = new[]
+                    {
+                        new Dimension(GridSizeMode.Absolute, 20),
+                        new Dimension(GridSizeMode.Absolute, 20),
+                        new Dimension(GridSizeMode.Absolute, 20),
+                        new Dimension(),
+                    },
+                    Content = new[]
+                    {
+                        new Drawable[]
+                        {
+                            selectorText = new OsuSpriteText
+                            {
+                                Anchor = Anchor.TopCentre,
+                                Origin = Anchor.TopCentre,
+                            },
+                        },
+                        new Drawable[]
+                        {
+                            selectedText = new OsuSpriteText
+                            {
+                                Anchor = Anchor.TopCentre,
+                                Origin = Anchor.TopCentre,
+                            },
+                        },
+                        new Drawable[]
+                        {
+                            leaveText = new OsuSpriteText
+                            {
+                                Anchor = Anchor.TopCentre,
+                                Origin = Anchor.TopCentre,
+                            },
+                        },
+                        new Drawable[]
+                        {
+                            channelList = new ChannelList
+                            {
+                                Anchor = Anchor.TopCentre,
+                                Origin = Anchor.TopCentre,
+                                RelativeSizeAxes = Axes.Y,
+                                Width = 190,
+                            },
+                        },
+                    },
+                };
+
+                channelList.OnRequestSelect += channel =>
+                {
+                    channelList.SelectorActive.Value = false;
+                    selected.Value = channel;
+                };
+
+                channelList.OnRequestLeave += channel =>
+                {
+                    leaveText.Text = $"OnRequestLeave: {channel.Name}";
+                    leaveText.FadeOutFromOne(1000, Easing.InQuint);
+                    selected.Value = null;
+                    channelList.RemoveChannel(channel);
+                };
+
+                channelList.SelectorActive.BindValueChanged(change =>
+                {
+                    selectorText.Text = $"Channel Selector Active: {change.NewValue}";
+                }, true);
+
+                selected.BindValueChanged(change =>
+                {
+                    selectedText.Text = $"Selected Channel: {change.NewValue?.Name ?? "[null]"}";
+                }, true);
+            });
+        }
+
+        [SetUpSteps]
+        public void SetUpSteps()
+        {
+            AddStep("Add Public Channels", () =>
+            {
+                for (int i = 0; i < 10; i++)
+                    channelList.AddChannel(createRandomPublicChannel());
+            });
+
+            AddStep("Add Private Channels", () =>
+            {
+                for (int i = 0; i < 10; i++)
+                    channelList.AddChannel(createRandomPrivateChannel());
+            });
+        }
+
+        [Test]
+        public void TestVisual()
+        {
+            AddStep("Unread Selected", () =>
+            {
+                if (selected.Value != null)
+                    channelList.GetItem(selected.Value).Unread.Value = true;
+            });
+
+            AddStep("Read Selected", () =>
+            {
+                if (selected.Value != null)
+                    channelList.GetItem(selected.Value).Unread.Value = false;
+            });
+
+            AddStep("Add Mention Selected", () =>
+            {
+                if (selected.Value != null)
+                    channelList.GetItem(selected.Value).Mentions.Value++;
+            });
+
+            AddStep("Add 98 Mentions Selected", () =>
+            {
+                if (selected.Value != null)
+                    channelList.GetItem(selected.Value).Mentions.Value += 98;
+            });
+
+            AddStep("Clear Mentions Selected", () =>
+            {
+                if (selected.Value != null)
+                    channelList.GetItem(selected.Value).Mentions.Value = 0;
+            });
+        }
+
+        private Channel createRandomPublicChannel()
+        {
+            int id = RNG.Next(0, 10000);
+            return new Channel
+            {
+                Name = $"#channel-{id}",
+                Type = ChannelType.Public,
+                Id = id,
+            };
+        }
+
+        private Channel createRandomPrivateChannel()
+        {
+            int id = RNG.Next(0, 10000);
+            return new Channel(new APIUser
+            {
+                Id = id,
+                Username = $"test user {id}",
+            });
+        }
+    }
+}
diff --git a/osu.Game.Tests/Visual/Online/TestSceneChannelListItem.cs b/osu.Game.Tests/Visual/Online/TestSceneChannelListItem.cs
deleted file mode 100644
index af419c8b91..0000000000
--- a/osu.Game.Tests/Visual/Online/TestSceneChannelListItem.cs
+++ /dev/null
@@ -1,163 +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 System.Collections.Generic;
-using System.Linq;
-using osu.Framework.Allocation;
-using osu.Framework.Bindables;
-using osu.Framework.Graphics;
-using osu.Framework.Graphics.Containers;
-using osu.Framework.Graphics.Shapes;
-using osu.Game.Graphics.Sprites;
-using osu.Game.Online.API.Requests.Responses;
-using osu.Game.Online.Chat;
-using osu.Game.Overlays;
-using osu.Game.Overlays.Chat.ChannelList;
-using osuTK;
-
-namespace osu.Game.Tests.Visual.Online
-{
-    [TestFixture]
-    public class TestSceneChannelListItem : OsuTestScene
-    {
-        [Cached]
-        private readonly OverlayColourProvider colourProvider = new OverlayColourProvider(OverlayColourScheme.Pink);
-
-        [Cached]
-        private readonly Bindable<Channel> selected = new Bindable<Channel>();
-
-        private static readonly List<Channel> channels = new List<Channel>
-        {
-            createPublicChannel("#public-channel"),
-            createPublicChannel("#public-channel-long-name"),
-            createPrivateChannel("test user", 2),
-            createPrivateChannel("test user long name", 3),
-        };
-
-        private readonly Dictionary<Channel, ChannelListItem> channelMap = new Dictionary<Channel, ChannelListItem>();
-
-        private FillFlowContainer flow;
-        private OsuSpriteText selectedText;
-        private OsuSpriteText leaveText;
-
-        [SetUp]
-        public void SetUp()
-        {
-            Schedule(() =>
-            {
-                foreach (var item in channelMap.Values)
-                    item.Expire();
-
-                channelMap.Clear();
-
-                Child = new FillFlowContainer
-                {
-                    Direction = FillDirection.Vertical,
-                    Anchor = Anchor.Centre,
-                    Origin = Anchor.Centre,
-                    AutoSizeAxes = Axes.Both,
-                    Spacing = new Vector2(10),
-                    Children = new Drawable[]
-                    {
-                        selectedText = new OsuSpriteText
-                        {
-                            Anchor = Anchor.TopCentre,
-                            Origin = Anchor.TopCentre,
-                        },
-                        leaveText = new OsuSpriteText
-                        {
-                            Anchor = Anchor.TopCentre,
-                            Origin = Anchor.TopCentre,
-                            Height = 16,
-                            AlwaysPresent = true,
-                        },
-                        new Container
-                        {
-                            Anchor = Anchor.TopCentre,
-                            Origin = Anchor.TopCentre,
-                            AutoSizeAxes = Axes.Y,
-                            Width = 190,
-                            Children = new Drawable[]
-                            {
-                                new Box
-                                {
-                                    RelativeSizeAxes = Axes.Both,
-                                    Colour = colourProvider.Background6,
-                                },
-                                flow = new FillFlowContainer
-                                {
-                                    Direction = FillDirection.Vertical,
-                                    RelativeSizeAxes = Axes.X,
-                                    AutoSizeAxes = Axes.Y,
-                                },
-                            },
-                        },
-                    },
-                };
-
-                selected.BindValueChanged(change =>
-                {
-                    selectedText.Text = $"Selected Channel: {change.NewValue?.Name ?? "[null]"}";
-                }, true);
-
-                foreach (var channel in channels)
-                {
-                    var item = new ChannelListItem(channel);
-                    flow.Add(item);
-                    channelMap.Add(channel, item);
-                    item.OnRequestSelect += c => selected.Value = c;
-                    item.OnRequestLeave += leaveChannel;
-                }
-            });
-        }
-
-        [Test]
-        public void TestVisual()
-        {
-            AddStep("Select second item", () => selected.Value = channels.Skip(1).First());
-
-            AddStep("Unread Selected", () =>
-            {
-                if (selected.Value != null)
-                    channelMap[selected.Value].Unread.Value = true;
-            });
-
-            AddStep("Read Selected", () =>
-            {
-                if (selected.Value != null)
-                    channelMap[selected.Value].Unread.Value = false;
-            });
-
-            AddStep("Add Mention Selected", () =>
-            {
-                if (selected.Value != null)
-                    channelMap[selected.Value].Mentions.Value++;
-            });
-
-            AddStep("Add 98 Mentions Selected", () =>
-            {
-                if (selected.Value != null)
-                    channelMap[selected.Value].Mentions.Value += 98;
-            });
-
-            AddStep("Clear Mentions Selected", () =>
-            {
-                if (selected.Value != null)
-                    channelMap[selected.Value].Mentions.Value = 0;
-            });
-        }
-
-        private void leaveChannel(Channel channel)
-        {
-            leaveText.Text = $"OnRequestLeave: {channel.Name}";
-            leaveText.FadeOutFromOne(1000, Easing.InQuint);
-        }
-
-        private static Channel createPublicChannel(string name) =>
-            new Channel { Name = name, Type = ChannelType.Public, Id = 1234 };
-
-        private static Channel createPrivateChannel(string username, int id)
-            => new Channel(new APIUser { Id = id, Username = username });
-    }
-}
diff --git a/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs b/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs
new file mode 100644
index 0000000000..4ffb6be451
--- /dev/null
+++ b/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs
@@ -0,0 +1,174 @@
+// 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 enable
+
+using System;
+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.Graphics;
+using osu.Game.Graphics.Containers;
+using osu.Game.Graphics.Sprites;
+using osu.Game.Online.Chat;
+using osuTK;
+
+namespace osu.Game.Overlays.Chat.ChannelList
+{
+    public class ChannelList : Container
+    {
+        public Action<Channel>? OnRequestSelect;
+        public Action<Channel>? OnRequestLeave;
+
+        public readonly BindableBool SelectorActive = new BindableBool();
+
+        private readonly Dictionary<Channel, ChannelListItem> channelMap = new Dictionary<Channel, ChannelListItem>();
+
+        private ChannelListItemFlow publicChannelFlow = null!;
+        private ChannelListItemFlow privateChannelFlow = null!;
+
+        [BackgroundDependencyLoader]
+        private void load(OverlayColourProvider colourProvider)
+        {
+            Children = new Drawable[]
+            {
+                new Box
+                {
+                    RelativeSizeAxes = Axes.Both,
+                    Colour = colourProvider.Background6,
+                },
+                new ChannelListScrollContainer
+                {
+                    Padding = new MarginPadding { Vertical = 7 },
+                    RelativeSizeAxes = Axes.Both,
+                    ScrollbarAnchor = Anchor.TopLeft,
+                    ScrollDistance = 35f,
+                    Child = new FillFlowContainer
+                    {
+                        Direction = FillDirection.Vertical,
+                        RelativeSizeAxes = Axes.X,
+                        AutoSizeAxes = Axes.Y,
+                        Children = new Drawable[]
+                        {
+                            publicChannelFlow = new ChannelListItemFlow("CHANNELS"),
+                            new ChannelListSelector
+                            {
+                                Margin = new MarginPadding { Bottom = 10 },
+                                SelectorActive = { BindTarget = SelectorActive },
+                            },
+                            privateChannelFlow = new ChannelListItemFlow("DIRECT MESSAGES"),
+                        },
+                    },
+                },
+            };
+        }
+
+        public void AddChannel(Channel channel)
+        {
+            if (channelMap.ContainsKey(channel))
+                return;
+
+            ChannelListItem item = new ChannelListItem(channel);
+            item.OnRequestSelect += channel => this.OnRequestSelect?.Invoke(channel);
+            item.OnRequestLeave += channel => this.OnRequestLeave?.Invoke(channel);
+
+            ChannelListItemFlow flow = getFlowForChannel(channel);
+            channelMap.Add(channel, item);
+            flow.Add(item);
+        }
+
+        public void RemoveChannel(Channel channel)
+        {
+            if (!channelMap.ContainsKey(channel))
+                return;
+
+            ChannelListItem item = channelMap[channel];
+            ChannelListItemFlow flow = getFlowForChannel(channel);
+
+            channelMap.Remove(channel);
+            flow.Remove(item);
+            item.Expire();
+        }
+
+        public ChannelListItem GetItem(Channel channel)
+        {
+            if (!channelMap.ContainsKey(channel))
+                throw new ArgumentOutOfRangeException();
+
+            return channelMap[channel];
+        }
+
+        private ChannelListItemFlow getFlowForChannel(Channel channel)
+        {
+            switch (channel.Type)
+            {
+                case ChannelType.Public:
+                    return publicChannelFlow;
+
+                case ChannelType.PM:
+                    return privateChannelFlow;
+
+                default:
+                    throw new ArgumentOutOfRangeException();
+            }
+        }
+
+        private class ChannelListItemFlow : FillFlowContainer
+        {
+            public ChannelListItemFlow(string label)
+            {
+                Direction = FillDirection.Vertical;
+                RelativeSizeAxes = Axes.X;
+                AutoSizeAxes = Axes.Y;
+
+                Add(new OsuSpriteText
+                {
+                    Text = label,
+                    Margin = new MarginPadding { Left = 18, Bottom = 5 },
+                    Font = OsuFont.Torus.With(size: 12),
+                });
+            }
+        }
+
+        private class ChannelListScrollContainer : OsuScrollContainer
+        {
+            protected override bool OnHover(HoverEvent e)
+            {
+                ScrollbarVisible = true;
+                return base.OnHover(e);
+            }
+
+            protected override void OnHoverLost(HoverLostEvent e)
+            {
+                ScrollbarVisible = false;
+                base.OnHoverLost(e);
+            }
+
+            protected override ScrollbarContainer CreateScrollbar(Direction direction)
+                => new ChannelListScrollBar(direction);
+
+            protected class ChannelListScrollBar : OsuScrollbar
+            {
+                private const float BAR_SIZE = 4;
+                private const float BAR_MARGIN = 7;
+
+                public ChannelListScrollBar(Direction scrollDir) : base(scrollDir)
+                {
+                    Size = new Vector2(BAR_SIZE);
+                    Margin = new MarginPadding { Left = BAR_MARGIN };
+                    CornerRadius = 2;
+                }
+
+                public override void ResizeTo(float val, int duration = 0, Easing easing = Easing.None)
+                {
+                    Vector2 size = new Vector2(BAR_SIZE, val);
+                    this.ResizeTo(size, duration, easing);
+                }
+            }
+        }
+    }
+}
diff --git a/osu.Game/Overlays/Chat/ChannelList/ChannelListSelector.cs b/osu.Game/Overlays/Chat/ChannelList/ChannelListSelector.cs
new file mode 100644
index 0000000000..5bc9a01598
--- /dev/null
+++ b/osu.Game/Overlays/Chat/ChannelList/ChannelListSelector.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.
+
+#nullable enable
+
+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.Graphics;
+using osu.Game.Graphics.Containers;
+using osu.Game.Graphics.Sprites;
+
+namespace osu.Game.Overlays.Chat.ChannelList
+{
+    public class ChannelListSelector : OsuClickableContainer
+    {
+        public readonly BindableBool SelectorActive = new BindableBool();
+
+        private Box hoverBox = null!;
+        private Box selectBox = null!;
+
+        [BackgroundDependencyLoader]
+        private void load(OverlayColourProvider colourProvider)
+        {
+            Height = 30;
+            RelativeSizeAxes = Axes.X;
+
+            Children = new Drawable[]
+            {
+                hoverBox = new Box
+                {
+                    RelativeSizeAxes = Axes.Both,
+                    Colour = colourProvider.Background3,
+                    Alpha = 0f,
+                },
+                selectBox = new Box
+                {
+                    RelativeSizeAxes = Axes.Both,
+                    Colour = colourProvider.Background4,
+                    Alpha = 0f,
+                },
+                new Container
+                {
+                    RelativeSizeAxes = Axes.Both,
+                    Padding = new MarginPadding { Left = 18, Right = 10 },
+                    Child = new OsuSpriteText
+                    {
+                        Anchor = Anchor.CentreLeft,
+                        Origin = Anchor.CentreLeft,
+                        Text = "Add More Channels",
+                        Font = OsuFont.Torus.With(size: 17, weight: FontWeight.SemiBold),
+                        Colour = colourProvider.Light3,
+                        Margin = new MarginPadding { Bottom = 2 },
+                        RelativeSizeAxes = Axes.X,
+                        Truncate = true,
+                    },
+                },
+            };
+        }
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            SelectorActive.BindValueChanged(selected => selectBox.FadeTo(selected.NewValue ? 1 : 0));
+            Action = () => SelectorActive.Value = true;
+        }
+
+        protected override bool OnHover(HoverEvent e)
+        {
+            hoverBox.FadeIn(300, Easing.OutQuint);
+            return base.OnHover(e);
+        }
+
+        protected override void OnHoverLost(HoverLostEvent e)
+        {
+            hoverBox.FadeOut(200, Easing.OutQuint);
+            base.OnHoverLost(e);
+        }
+    }
+}

From a0a2f8118e520003c23993bb2074d5664803758f Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Fri, 15 Apr 2022 22:05:20 +0100
Subject: [PATCH 4089/5547] Code quality fixes

---
 osu.Game/Overlays/Chat/ChannelList/ChannelList.cs | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs b/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs
index 4ffb6be451..9fcd675dc5 100644
--- a/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs
+++ b/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs
@@ -73,8 +73,8 @@ namespace osu.Game.Overlays.Chat.ChannelList
                 return;
 
             ChannelListItem item = new ChannelListItem(channel);
-            item.OnRequestSelect += channel => this.OnRequestSelect?.Invoke(channel);
-            item.OnRequestLeave += channel => this.OnRequestLeave?.Invoke(channel);
+            item.OnRequestSelect += chan => OnRequestSelect?.Invoke(chan);
+            item.OnRequestLeave += chan => OnRequestLeave?.Invoke(chan);
 
             ChannelListItemFlow flow = getFlowForChannel(channel);
             channelMap.Add(channel, item);
@@ -153,19 +153,19 @@ namespace osu.Game.Overlays.Chat.ChannelList
 
             protected class ChannelListScrollBar : OsuScrollbar
             {
-                private const float BAR_SIZE = 4;
-                private const float BAR_MARGIN = 7;
+                private const float bar_size = 4;
+                private const float bar_margin = 7;
 
                 public ChannelListScrollBar(Direction scrollDir) : base(scrollDir)
                 {
-                    Size = new Vector2(BAR_SIZE);
-                    Margin = new MarginPadding { Left = BAR_MARGIN };
+                    Size = new Vector2(bar_size);
+                    Margin = new MarginPadding { Left = bar_margin };
                     CornerRadius = 2;
                 }
 
                 public override void ResizeTo(float val, int duration = 0, Easing easing = Easing.None)
                 {
-                    Vector2 size = new Vector2(BAR_SIZE, val);
+                    Vector2 size = new Vector2(bar_size, val);
                     this.ResizeTo(size, duration, easing);
                 }
             }

From b6631fb9f97e5add211cc4187fef2f03210b71fd Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Fri, 15 Apr 2022 22:22:20 +0100
Subject: [PATCH 4090/5547] Add newline for base class call

---
 osu.Game/Overlays/Chat/ChannelList/ChannelList.cs | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs b/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs
index 9fcd675dc5..94c05770ab 100644
--- a/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs
+++ b/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs
@@ -156,7 +156,8 @@ namespace osu.Game.Overlays.Chat.ChannelList
                 private const float bar_size = 4;
                 private const float bar_margin = 7;
 
-                public ChannelListScrollBar(Direction scrollDir) : base(scrollDir)
+                public ChannelListScrollBar(Direction scrollDir)
+                    : base(scrollDir)
                 {
                     Size = new Vector2(bar_size);
                     Margin = new MarginPadding { Left = bar_margin };

From 4a0c5a07813fb94107e40acc9295f3f315abdf08 Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Sat, 16 Apr 2022 19:16:06 +0100
Subject: [PATCH 4091/5547] Remove hover override for
 `ChannelListScrollContainer`

---
 osu.Game/Overlays/Chat/ChannelList/ChannelList.cs | 13 -------------
 1 file changed, 13 deletions(-)

diff --git a/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs b/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs
index 94c05770ab..ef2f132501 100644
--- a/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs
+++ b/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs
@@ -10,7 +10,6 @@ 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.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
@@ -136,18 +135,6 @@ namespace osu.Game.Overlays.Chat.ChannelList
 
         private class ChannelListScrollContainer : OsuScrollContainer
         {
-            protected override bool OnHover(HoverEvent e)
-            {
-                ScrollbarVisible = true;
-                return base.OnHover(e);
-            }
-
-            protected override void OnHoverLost(HoverLostEvent e)
-            {
-                ScrollbarVisible = false;
-                base.OnHoverLost(e);
-            }
-
             protected override ScrollbarContainer CreateScrollbar(Direction direction)
                 => new ChannelListScrollBar(direction);
 

From 36aea9009e754ebd18872d259a137e2df8f52a88 Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Sat, 16 Apr 2022 19:19:18 +0100
Subject: [PATCH 4092/5547] Move `ChannelList` scrollbar to the right

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

diff --git a/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs b/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs
index ef2f132501..759242a779 100644
--- a/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs
+++ b/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs
@@ -44,7 +44,7 @@ namespace osu.Game.Overlays.Chat.ChannelList
                 {
                     Padding = new MarginPadding { Vertical = 7 },
                     RelativeSizeAxes = Axes.Both,
-                    ScrollbarAnchor = Anchor.TopLeft,
+                    ScrollbarAnchor = Anchor.TopRight,
                     ScrollDistance = 35f,
                     Child = new FillFlowContainer
                     {
@@ -147,7 +147,7 @@ namespace osu.Game.Overlays.Chat.ChannelList
                     : base(scrollDir)
                 {
                     Size = new Vector2(bar_size);
-                    Margin = new MarginPadding { Left = bar_margin };
+                    Margin = new MarginPadding { Horizontal = bar_margin };
                     CornerRadius = 2;
                 }
 

From 2f41cddb00124179b13ae5c69a633f00805dbec9 Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Sat, 16 Apr 2022 19:28:24 +0100
Subject: [PATCH 4093/5547] Remove redundant `Expire` call

---
 osu.Game/Overlays/Chat/ChannelList/ChannelList.cs | 1 -
 1 file changed, 1 deletion(-)

diff --git a/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs b/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs
index 759242a779..250e0cdf21 100644
--- a/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs
+++ b/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs
@@ -90,7 +90,6 @@ namespace osu.Game.Overlays.Chat.ChannelList
 
             channelMap.Remove(channel);
             flow.Remove(item);
-            item.Expire();
         }
 
         public ChannelListItem GetItem(Channel channel)

From 47c8b8010f1580ee9c7e583d0340f85f4c791e1d Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Sat, 16 Apr 2022 19:30:03 +0100
Subject: [PATCH 4094/5547] Use semibold font weight for `ChannelListItemFlow`
 label

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

diff --git a/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs b/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs
index 250e0cdf21..5c2a1ad89f 100644
--- a/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs
+++ b/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs
@@ -127,7 +127,7 @@ namespace osu.Game.Overlays.Chat.ChannelList
                 {
                     Text = label,
                     Margin = new MarginPadding { Left = 18, Bottom = 5 },
-                    Font = OsuFont.Torus.With(size: 12),
+                    Font = OsuFont.Torus.With(size: 12, weight: FontWeight.SemiBold),
                 });
             }
         }

From 610d2dc1a310d918604f758705bab41b8d2af451 Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Sun, 17 Apr 2022 10:34:48 +0800
Subject: [PATCH 4095/5547] Use a bigger sample step to calculate slider center
 of mass

---
 .../Utils/OsuHitObjectGenerationUtils_Reposition.cs    | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Utils/OsuHitObjectGenerationUtils_Reposition.cs b/osu.Game.Rulesets.Osu/Utils/OsuHitObjectGenerationUtils_Reposition.cs
index 2abbd61c59..a77d1f8b0f 100644
--- a/osu.Game.Rulesets.Osu/Utils/OsuHitObjectGenerationUtils_Reposition.cs
+++ b/osu.Game.Rulesets.Osu/Utils/OsuHitObjectGenerationUtils_Reposition.cs
@@ -323,13 +323,19 @@ namespace osu.Game.Rulesets.Osu.Utils
         /// <returns>The centre of mass of the slider.</returns>
         private static Vector2 calculateCentreOfMass(Slider slider)
         {
-            if (slider.Distance < 1) return Vector2.Zero;
+            const double sample_step = 50;
+
+            // just sample the start and end positions if the slider is too short
+            if (slider.Distance <= sample_step)
+            {
+                return Vector2.Divide(slider.Path.PositionAt(1), 2);
+            }
 
             int count = 0;
             Vector2 sum = Vector2.Zero;
             double pathDistance = slider.Distance;
 
-            for (double i = 0; i < pathDistance; i++)
+            for (double i = 0; i < pathDistance; i += sample_step)
             {
                 sum += slider.Path.PositionAt(i / pathDistance);
                 count++;

From 1d79266d422fe8dbe06eec2d259c2aab348df106 Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Sun, 17 Apr 2022 10:40:43 +0800
Subject: [PATCH 4096/5547] Clarify in the xmldoc that angles are measured in
 radians

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

diff --git a/osu.Game.Rulesets.Osu/Utils/OsuHitObjectGenerationUtils.cs b/osu.Game.Rulesets.Osu/Utils/OsuHitObjectGenerationUtils.cs
index 6129e6bfc4..7b0d061e9a 100644
--- a/osu.Game.Rulesets.Osu/Utils/OsuHitObjectGenerationUtils.cs
+++ b/osu.Game.Rulesets.Osu/Utils/OsuHitObjectGenerationUtils.cs
@@ -151,7 +151,7 @@ namespace osu.Game.Rulesets.Osu.Utils
         /// Rotate a slider about its start position by the specified angle.
         /// </summary>
         /// <param name="slider">The slider to be rotated.</param>
-        /// <param name="rotation">The angle to rotate the slider by.</param>
+        /// <param name="rotation">The angle, measured in radians, to rotate the slider by.</param>
         public static void RotateSlider(Slider slider, float rotation)
         {
             void rotateNestedObject(OsuHitObject nested) => nested.Position = rotateVector(nested.Position - slider.Position, rotation) + slider.Position;
@@ -170,7 +170,7 @@ namespace osu.Game.Rulesets.Osu.Utils
         /// Rotate a vector by the specified angle.
         /// </summary>
         /// <param name="vector">The vector to be rotated.</param>
-        /// <param name="rotation">The angle to rotate the vector by.</param>
+        /// <param name="rotation">The angle, measured in radians, to rotate the vector by.</param>
         /// <returns>The rotated vector.</returns>
         private static Vector2 rotateVector(Vector2 vector, float rotation)
         {

From 399d8eac36d8171a806b004843dc9ab747d0e500 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 17 Apr 2022 14:44:28 +0900
Subject: [PATCH 4097/5547] Update `LocalisationAnalyser` with dotnet 6
 compatibility changes

---
 .config/dotnet-tools.json | 4 ++--
 osu.Game/osu.Game.csproj  | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/.config/dotnet-tools.json b/.config/dotnet-tools.json
index 7b94ee5bdd..5a3eadf607 100644
--- a/.config/dotnet-tools.json
+++ b/.config/dotnet-tools.json
@@ -27,10 +27,10 @@
       ]
     },
     "ppy.localisationanalyser.tools": {
-      "version": "2022.320.0",
+      "version": "2022.417.0",
       "commands": [
         "localisation"
       ]
     }
   }
-}
\ No newline at end of file
+}
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index be4bee7c9d..94614bea76 100644
--- a/osu.Game/osu.Game.csproj
+++ b/osu.Game/osu.Game.csproj
@@ -30,7 +30,7 @@
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.Core" Version="5.0.14" />
     <PackageReference Include="Microsoft.Extensions.Configuration.Abstractions" Version="6.0.0" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
-    <PackageReference Include="ppy.LocalisationAnalyser" Version="2022.320.0">
+    <PackageReference Include="ppy.LocalisationAnalyser" Version="2022.417.0">
       <PrivateAssets>all</PrivateAssets>
       <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
     </PackageReference>

From a3cc07ff3f6adcf9c42355772eb0e489cfd35931 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 17 Apr 2022 15:08:15 +0900
Subject: [PATCH 4098/5547] Update resources

---
 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 ec638f7736..a8952df329 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -51,7 +51,7 @@
     <Reference Include="Java.Interop" />
   </ItemGroup>
   <ItemGroup>
-    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.415.0" />
+    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.417.0" />
     <PackageReference Include="ppy.osu.Framework.Android" Version="2022.415.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 94614bea76..3246255815 100644
--- a/osu.Game/osu.Game.csproj
+++ b/osu.Game/osu.Game.csproj
@@ -36,7 +36,7 @@
     </PackageReference>
     <PackageReference Include="Realm" Version="10.10.0" />
     <PackageReference Include="ppy.osu.Framework" Version="2022.415.0" />
-    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.415.0" />
+    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.417.0" />
     <PackageReference Include="Sentry" Version="3.14.1" />
     <PackageReference Include="SharpCompress" Version="0.30.1" />
     <PackageReference Include="NUnit" Version="3.13.2" />
diff --git a/osu.iOS.props b/osu.iOS.props
index 0a0cab91a4..668d23f82e 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -62,7 +62,7 @@
   </ItemGroup>
   <ItemGroup Label="Package References">
     <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.415.0" />
-    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.415.0" />
+    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.417.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net6.0) -->
   <PropertyGroup>

From f37444938fb20b951fa7de9bdcba609173681967 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 18 Apr 2022 02:05:09 +0900
Subject: [PATCH 4099/5547] Update squirrel to latest version

Includes disk space checks and better erroring.
---
 osu.Desktop/osu.Desktop.csproj | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Desktop/osu.Desktop.csproj b/osu.Desktop/osu.Desktop.csproj
index 3ca6411812..a4f309c6ac 100644
--- a/osu.Desktop/osu.Desktop.csproj
+++ b/osu.Desktop/osu.Desktop.csproj
@@ -24,7 +24,7 @@
     <ProjectReference Include="..\osu.Game.Rulesets.Taiko\osu.Game.Rulesets.Taiko.csproj" />
   </ItemGroup>
   <ItemGroup Label="Package References">
-    <PackageReference Include="Clowd.Squirrel" Version="2.8.28-pre" />
+    <PackageReference Include="Clowd.Squirrel" Version="2.9.23-gc8da1a" />
     <PackageReference Include="Mono.Posix.NETStandard" Version="1.0.0" />
     <PackageReference Include="System.IO.Packaging" Version="6.0.0" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="5.0.14" />

From 67c44db8d5aad22d8eb381574fb7421495840c75 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 27 Mar 2022 22:55:52 +0200
Subject: [PATCH 4100/5547] Add extension points required for replacing old mod
 overlay

---
 osu.Game/Overlays/Mods/ModColumn.cs       |  7 +-
 osu.Game/Overlays/Mods/ModSelectScreen.cs | 89 +++++++++++++++++------
 2 files changed, 71 insertions(+), 25 deletions(-)

diff --git a/osu.Game/Overlays/Mods/ModColumn.cs b/osu.Game/Overlays/Mods/ModColumn.cs
index f84ae4ac8a..abd243e1f7 100644
--- a/osu.Game/Overlays/Mods/ModColumn.cs
+++ b/osu.Game/Overlays/Mods/ModColumn.cs
@@ -54,6 +54,8 @@ namespace osu.Game.Overlays.Mods
 
         public Bindable<IReadOnlyList<Mod>> SelectedMods = new Bindable<IReadOnlyList<Mod>>(Array.Empty<Mod>());
 
+        protected virtual ModPanel CreateModPanel(Mod mod) => new ModPanel(mod);
+
         private readonly Key[]? toggleKeys;
 
         private readonly Bindable<Dictionary<ModType, IReadOnlyList<Mod>>> availableMods = new Bindable<Dictionary<ModType, IReadOnlyList<Mod>>>();
@@ -258,10 +260,7 @@ namespace osu.Game.Overlays.Mods
 
             cancellationTokenSource?.Cancel();
 
-            var panels = newMods.Select(mod => new ModPanel(mod)
-            {
-                Shear = new Vector2(-ModPanel.SHEAR_X, 0)
-            });
+            var panels = newMods.Select(mod => CreateModPanel(mod).With(panel => panel.Shear = new Vector2(-ModPanel.SHEAR_X, 0)));
 
             Task? loadTask;
 
diff --git a/osu.Game/Overlays/Mods/ModSelectScreen.cs b/osu.Game/Overlays/Mods/ModSelectScreen.cs
index 62080ec1b5..d174474076 100644
--- a/osu.Game/Overlays/Mods/ModSelectScreen.cs
+++ b/osu.Game/Overlays/Mods/ModSelectScreen.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.
 
+#nullable enable
+
 using System;
 using System.Collections.Generic;
 using System.Diagnostics;
@@ -31,16 +33,43 @@ namespace osu.Game.Overlays.Mods
 
         protected override bool StartHidden => true;
 
+        private Func<Mod, bool> isValidMod = m => true;
+
+        public Func<Mod, bool> IsValidMod
+        {
+            get => isValidMod;
+            set
+            {
+                isValidMod = value ?? throw new ArgumentNullException(nameof(value));
+
+                if (IsLoaded)
+                    updateAvailableMods();
+            }
+        }
+
+        /// <summary>
+        /// Whether configurable <see cref="Mod"/>s can be configured by the local user.
+        /// </summary>
+        protected virtual bool AllowConfiguration => true;
+
+        /// <summary>
+        /// Whether the total score multiplier calculated from the current selected set of mods should be shown.
+        /// </summary>
+        protected virtual bool ShowTotalMultiplier => true;
+
+        protected virtual ModColumn CreateModColumn(ModType modType, Key[]? toggleKeys = null) => new ModColumn(modType, false, toggleKeys);
+
         private readonly BindableBool customisationVisible = new BindableBool();
 
-        private DifficultyMultiplierDisplay multiplierDisplay;
-        private ModSettingsArea modSettingsArea;
-        private FillFlowContainer<ModColumn> columnFlow;
-        private GridContainer grid;
-        private Container mainContent;
+        private DifficultyMultiplierDisplay? multiplierDisplay;
+        private ModSettingsArea modSettingsArea = null!;
+        private Container aboveColumnsContainer = null!;
+        private FillFlowContainer<ModColumn> columnFlow = null!;
+        private GridContainer grid = null!;
+        private Container mainContent = null!;
 
-        private PopupScreenTitle header;
-        private Container footer;
+        private PopupScreenTitle header = null!;
+        private Container footer = null!;
 
         [BackgroundDependencyLoader]
         private void load()
@@ -82,7 +111,7 @@ namespace osu.Game.Overlays.Mods
                                 },
                                 new Drawable[]
                                 {
-                                    new Container
+                                    aboveColumnsContainer = new Container
                                     {
                                         Anchor = Anchor.Centre,
                                         Origin = Anchor.Centre,
@@ -94,11 +123,6 @@ namespace osu.Game.Overlays.Mods
                                         {
                                             Horizontal = 100,
                                             Vertical = 10
-                                        },
-                                        Child = multiplierDisplay = new DifficultyMultiplierDisplay
-                                        {
-                                            Anchor = Anchor.Centre,
-                                            Origin = Anchor.Centre
                                         }
                                     }
                                 },
@@ -126,11 +150,11 @@ namespace osu.Game.Overlays.Mods
                                                     Margin = new MarginPadding { Right = 70 },
                                                     Children = new[]
                                                     {
-                                                        new ModColumn(ModType.DifficultyReduction, false, new[] { Key.Q, Key.W, Key.E, Key.R, Key.T, Key.Y, Key.U, Key.I, Key.O, Key.P }),
-                                                        new ModColumn(ModType.DifficultyIncrease, false, new[] { Key.A, Key.S, Key.D, Key.F, Key.G, Key.H, Key.J, Key.K, Key.L }),
-                                                        new ModColumn(ModType.Automation, false, new[] { Key.Z, Key.X, Key.C, Key.V, Key.B, Key.N, Key.M }),
-                                                        new ModColumn(ModType.Conversion, false),
-                                                        new ModColumn(ModType.Fun, false)
+                                                        CreateModColumn(ModType.DifficultyReduction, new[] { Key.Q, Key.W, Key.E, Key.R, Key.T, Key.Y, Key.U, Key.I, Key.O, Key.P }),
+                                                        CreateModColumn(ModType.DifficultyIncrease, new[] { Key.A, Key.S, Key.D, Key.F, Key.G, Key.H, Key.J, Key.K, Key.L }),
+                                                        CreateModColumn(ModType.Automation, new[] { Key.Z, Key.X, Key.C, Key.V, Key.B, Key.N, Key.M }),
+                                                        CreateModColumn(ModType.Conversion),
+                                                        CreateModColumn(ModType.Fun)
                                                     }
                                                 }
                                             }
@@ -182,6 +206,15 @@ namespace osu.Game.Overlays.Mods
                 }
             };
 
+            if (ShowTotalMultiplier)
+            {
+                aboveColumnsContainer.Add(multiplierDisplay = new DifficultyMultiplierDisplay
+                {
+                    Anchor = Anchor.CentreRight,
+                    Origin = Anchor.CentreRight
+                });
+            }
+
             columnFlow.Shear = new Vector2(ModPanel.SHEAR_X, 0);
         }
 
@@ -204,10 +237,15 @@ namespace osu.Game.Overlays.Mods
             }
 
             customisationVisible.BindValueChanged(_ => updateCustomisationVisualState(), true);
+
+            updateAvailableMods();
         }
 
         private void updateMultiplier()
         {
+            if (multiplierDisplay == null)
+                return;
+
             double multiplier = 1.0;
 
             foreach (var mod in SelectedMods.Value)
@@ -216,8 +254,17 @@ namespace osu.Game.Overlays.Mods
             multiplierDisplay.Current.Value = multiplier;
         }
 
+        private void updateAvailableMods()
+        {
+            foreach (var column in columnFlow)
+                column.Filter = isValidMod;
+        }
+
         private void updateCustomisation(ValueChangedEvent<IReadOnlyList<Mod>> valueChangedEvent)
         {
+            if (!AllowConfiguration)
+                return;
+
             bool anyCustomisableMod = false;
             bool anyModWithRequiredCustomisationAdded = false;
 
@@ -292,7 +339,7 @@ namespace osu.Game.Overlays.Mods
             header.MoveToY(0, fade_in_duration, Easing.OutQuint);
             footer.MoveToY(0, fade_in_duration, Easing.OutQuint);
 
-            multiplierDisplay
+            multiplierDisplay?
                 .Delay(fade_in_duration * 0.65f)
                 .FadeIn(fade_in_duration / 2, Easing.OutQuint)
                 .ScaleTo(1, fade_in_duration, Easing.OutElastic);
@@ -313,7 +360,7 @@ namespace osu.Game.Overlays.Mods
             base.PopOut();
             this.FadeOut(fade_out_duration, Easing.OutQuint);
 
-            multiplierDisplay
+            multiplierDisplay?
                 .FadeOut(fade_out_duration / 2, Easing.OutQuint)
                 .ScaleTo(0.75f, fade_out_duration, Easing.OutQuint);
 
@@ -368,7 +415,7 @@ namespace osu.Game.Overlays.Mods
         {
             public BindableBool HandleMouse { get; } = new BindableBool();
 
-            public Action OnClicked { get; set; }
+            public Action? OnClicked { get; set; }
 
             protected override bool Handle(UIEvent e)
             {

From 7eebc2012465f58c95b6ff3bc2bb452f30d1a314 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 27 Mar 2022 23:07:52 +0200
Subject: [PATCH 4101/5547] Add replacements for mod overlays used by game

---
 osu.Game/Overlays/Mods/UserModSelectScreen.cs | 24 +++++++++++++++
 .../Screens/OnlinePlay/FreeModSelectScreen.cs | 29 +++++++++++++++++++
 2 files changed, 53 insertions(+)
 create mode 100644 osu.Game/Overlays/Mods/UserModSelectScreen.cs
 create mode 100644 osu.Game/Screens/OnlinePlay/FreeModSelectScreen.cs

diff --git a/osu.Game/Overlays/Mods/UserModSelectScreen.cs b/osu.Game/Overlays/Mods/UserModSelectScreen.cs
new file mode 100644
index 0000000000..81943da514
--- /dev/null
+++ b/osu.Game/Overlays/Mods/UserModSelectScreen.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 JetBrains.Annotations;
+using osu.Game.Rulesets.Mods;
+using osuTK.Input;
+
+namespace osu.Game.Overlays.Mods
+{
+    public class UserModSelectScreen : ModSelectScreen
+    {
+        protected override ModColumn CreateModColumn(ModType modType, Key[] toggleKeys = null) => new UserModColumn(modType, false, toggleKeys);
+
+        private class UserModColumn : ModColumn
+        {
+            public UserModColumn(ModType modType, bool allowBulkSelection, [CanBeNull] Key[] toggleKeys = null)
+                : base(modType, allowBulkSelection, toggleKeys)
+            {
+            }
+
+            protected override ModPanel CreateModPanel(Mod mod) => new IncompatibilityDisplayingModPanel(mod);
+        }
+    }
+}
diff --git a/osu.Game/Screens/OnlinePlay/FreeModSelectScreen.cs b/osu.Game/Screens/OnlinePlay/FreeModSelectScreen.cs
new file mode 100644
index 0000000000..438b334e0b
--- /dev/null
+++ b/osu.Game/Screens/OnlinePlay/FreeModSelectScreen.cs
@@ -0,0 +1,29 @@
+// 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.Game.Overlays.Mods;
+using osu.Game.Rulesets.Mods;
+using osuTK.Input;
+
+namespace osu.Game.Screens.OnlinePlay
+{
+    public class FreeModSelectScreen : ModSelectScreen
+    {
+        protected override bool AllowConfiguration => false;
+        protected override bool ShowTotalMultiplier => false;
+
+        public new Func<Mod, bool> IsValidMod
+        {
+            get => base.IsValidMod;
+            set => base.IsValidMod = m => m.HasImplementation && m.UserPlayable && value.Invoke(m);
+        }
+
+        public FreeModSelectScreen()
+        {
+            IsValidMod = _ => true;
+        }
+
+        protected override ModColumn CreateModColumn(ModType modType, Key[] toggleKeys = null) => new ModColumn(modType, true, toggleKeys);
+    }
+}

From 20c17b8c98448f7ad1a93b53ebb259b8961765db Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 3 Apr 2022 19:42:52 +0200
Subject: [PATCH 4102/5547] Make base mod select screen abstract

---
 .../Visual/UserInterface/TestSceneModSelectScreen.cs          | 4 ++--
 osu.Game/Overlays/Mods/ModSelectScreen.cs                     | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs
index 34d9ddcc4e..4a738cb29d 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs
@@ -23,7 +23,7 @@ namespace osu.Game.Tests.Visual.UserInterface
         [Resolved]
         private RulesetStore rulesetStore { get; set; }
 
-        private ModSelectScreen modSelectScreen;
+        private UserModSelectScreen modSelectScreen;
 
         [SetUpSteps]
         public void SetUpSteps()
@@ -35,7 +35,7 @@ namespace osu.Game.Tests.Visual.UserInterface
 
         private void createScreen()
         {
-            AddStep("create screen", () => Child = modSelectScreen = new ModSelectScreen
+            AddStep("create screen", () => Child = modSelectScreen = new UserModSelectScreen
             {
                 RelativeSizeAxes = Axes.Both,
                 State = { Value = Visibility.Visible },
diff --git a/osu.Game/Overlays/Mods/ModSelectScreen.cs b/osu.Game/Overlays/Mods/ModSelectScreen.cs
index d174474076..ad111cd5b9 100644
--- a/osu.Game/Overlays/Mods/ModSelectScreen.cs
+++ b/osu.Game/Overlays/Mods/ModSelectScreen.cs
@@ -23,7 +23,7 @@ using osuTK.Input;
 
 namespace osu.Game.Overlays.Mods
 {
-    public class ModSelectScreen : OsuFocusedOverlayContainer
+    public abstract class ModSelectScreen : OsuFocusedOverlayContainer
     {
         [Cached]
         private OverlayColourProvider colourProvider = new OverlayColourProvider(OverlayColourScheme.Green);

From 9942b0a9467cf51fb6284d157fbc67ea78107af6 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 3 Apr 2022 19:53:05 +0200
Subject: [PATCH 4103/5547] Add test scene for free mod select screen

---
 .../TestSceneFreeModSelectScreen.cs           | 28 +++++++++++++++++++
 1 file changed, 28 insertions(+)
 create mode 100644 osu.Game.Tests/Visual/Multiplayer/TestSceneFreeModSelectScreen.cs

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneFreeModSelectScreen.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneFreeModSelectScreen.cs
new file mode 100644
index 0000000000..974cd710f7
--- /dev/null
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneFreeModSelectScreen.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 NUnit.Framework;
+using osu.Framework.Graphics.Containers;
+using osu.Game.Screens.OnlinePlay;
+
+namespace osu.Game.Tests.Visual.Multiplayer
+{
+    public class TestSceneFreeModSelectScreen : MultiplayerTestScene
+    {
+        [Test]
+        public void TestFreeModSelect()
+        {
+            FreeModSelectScreen freeModSelectScreen = null;
+
+            AddStep("create free mod select screen", () => Child = freeModSelectScreen = new FreeModSelectScreen
+            {
+                State = { Value = Visibility.Visible }
+            });
+            AddToggleStep("toggle visibility", visible =>
+            {
+                if (freeModSelectScreen != null)
+                    freeModSelectScreen.State.Value = visible ? Visibility.Visible : Visibility.Hidden;
+            });
+        }
+    }
+}

From 4b6d42c7e890bcd797535fc6c5203e4fc70112aa Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 17 Apr 2022 16:54:30 +0200
Subject: [PATCH 4104/5547] Add assertion covering free mod selection mod
 validity filter

---
 .../Visual/Multiplayer/TestSceneFreeModSelectScreen.cs   | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneFreeModSelectScreen.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneFreeModSelectScreen.cs
index 974cd710f7..0db05e3a6a 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneFreeModSelectScreen.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneFreeModSelectScreen.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 System.Linq;
 using NUnit.Framework;
 using osu.Framework.Graphics.Containers;
+using osu.Framework.Testing;
+using osu.Game.Overlays.Mods;
 using osu.Game.Screens.OnlinePlay;
 
 namespace osu.Game.Tests.Visual.Multiplayer
@@ -18,6 +21,12 @@ namespace osu.Game.Tests.Visual.Multiplayer
             {
                 State = { Value = Visibility.Visible }
             });
+
+            AddAssert("all visible mods are playable",
+                () => this.ChildrenOfType<ModPanel>()
+                          .Where(panel => panel.IsPresent)
+                          .All(panel => panel.Mod.HasImplementation && panel.Mod.UserPlayable));
+
             AddToggleStep("toggle visibility", visible =>
             {
                 if (freeModSelectScreen != null)

From ffb5c1e86c71003c6d6f8cda6e173948936e64f1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 17 Apr 2022 16:58:02 +0200
Subject: [PATCH 4105/5547] Tweak colours on incompatibility displaying mod
 panel

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

diff --git a/osu.Game/Overlays/Mods/IncompatibilityDisplayingModPanel.cs b/osu.Game/Overlays/Mods/IncompatibilityDisplayingModPanel.cs
index 4b6759c209..6c6c36eec9 100644
--- a/osu.Game/Overlays/Mods/IncompatibilityDisplayingModPanel.cs
+++ b/osu.Game/Overlays/Mods/IncompatibilityDisplayingModPanel.cs
@@ -46,8 +46,8 @@ namespace osu.Game.Overlays.Mods
 
             if (incompatible.Value)
             {
-                Colour4 backgroundColour = ColourProvider.Background5;
-                Colour4 textBackgroundColour = ColourProvider.Background4;
+                Colour4 backgroundColour = ColourProvider.Background6;
+                Colour4 textBackgroundColour = ColourProvider.Background5;
 
                 Content.TransformTo(nameof(BorderColour), ColourInfo.GradientVertical(backgroundColour, textBackgroundColour), TRANSITION_DURATION, Easing.OutQuint);
                 Background.FadeColour(backgroundColour, TRANSITION_DURATION, Easing.OutQuint);

From 8af865a1c5766d850743f2654b48a50a63aa3316 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 17 Apr 2022 21:20:16 +0200
Subject: [PATCH 4106/5547] Fix incompatibility panel using reference equality

---
 osu.Game/Overlays/Mods/IncompatibilityDisplayingModPanel.cs | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/Mods/IncompatibilityDisplayingModPanel.cs b/osu.Game/Overlays/Mods/IncompatibilityDisplayingModPanel.cs
index 6c6c36eec9..38781455fa 100644
--- a/osu.Game/Overlays/Mods/IncompatibilityDisplayingModPanel.cs
+++ b/osu.Game/Overlays/Mods/IncompatibilityDisplayingModPanel.cs
@@ -37,7 +37,9 @@ namespace osu.Game.Overlays.Mods
 
         private void updateIncompatibility()
         {
-            incompatible.Value = selectedMods.Value.Count > 0 && !selectedMods.Value.Contains(Mod) && !ModUtils.CheckCompatibleSet(selectedMods.Value.Append(Mod));
+            incompatible.Value = selectedMods.Value.Count > 0
+                                 && selectedMods.Value.All(selected => selected.GetType() != Mod.GetType())
+                                 && !ModUtils.CheckCompatibleSet(selectedMods.Value.Append(Mod));
         }
 
         protected override void UpdateState()

From 881df7663d8ee8fab93759c57651e78c4ddfcab7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 17 Apr 2022 22:30:02 +0200
Subject: [PATCH 4107/5547] Fix filter not taking effect if applied before
 panel load completion

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

diff --git a/osu.Game/Overlays/Mods/ModPanel.cs b/osu.Game/Overlays/Mods/ModPanel.cs
index 312171cf74..c9aaa1c6c0 100644
--- a/osu.Game/Overlays/Mods/ModPanel.cs
+++ b/osu.Game/Overlays/Mods/ModPanel.cs
@@ -159,7 +159,7 @@ namespace osu.Game.Overlays.Mods
                 playStateChangeSamples();
                 UpdateState();
             });
-            Filtered.BindValueChanged(_ => updateFilterState());
+            Filtered.BindValueChanged(_ => updateFilterState(), true);
 
             UpdateState();
             FinishTransforms(true);

From 0d5ce336f49cfe4a475c6b587fc9c1e3dc52f3bb Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 17 Apr 2022 23:26:25 +0200
Subject: [PATCH 4108/5547] Hide mod customisation toggle if customisation not
 permitted

---
 osu.Game/Overlays/Mods/ModSelectScreen.cs | 20 ++++++++++++--------
 1 file changed, 12 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Overlays/Mods/ModSelectScreen.cs b/osu.Game/Overlays/Mods/ModSelectScreen.cs
index ad111cd5b9..237af2a71d 100644
--- a/osu.Game/Overlays/Mods/ModSelectScreen.cs
+++ b/osu.Game/Overlays/Mods/ModSelectScreen.cs
@@ -180,14 +180,6 @@ namespace osu.Game.Overlays.Mods
                                     Origin = Anchor.BottomCentre,
                                     Colour = colourProvider.Background5
                                 },
-                                new ShearedToggleButton(200)
-                                {
-                                    Anchor = Anchor.BottomLeft,
-                                    Origin = Anchor.BottomLeft,
-                                    Margin = new MarginPadding { Vertical = 14, Left = 70 },
-                                    Text = "Mod Customisation",
-                                    Active = { BindTarget = customisationVisible }
-                                }
                             }
                         },
                         new ClickToReturnContainer
@@ -206,6 +198,18 @@ namespace osu.Game.Overlays.Mods
                 }
             };
 
+            if (AllowConfiguration)
+            {
+                footer.Add(new ShearedToggleButton(200)
+                {
+                    Anchor = Anchor.BottomLeft,
+                    Origin = Anchor.BottomLeft,
+                    Margin = new MarginPadding { Vertical = 14, Left = 70 },
+                    Text = "Mod Customisation",
+                    Active = { BindTarget = customisationVisible }
+                });
+            }
+
             if (ShowTotalMultiplier)
             {
                 aboveColumnsContainer.Add(multiplierDisplay = new DifficultyMultiplierDisplay

From e5e196097584484bc9062328b887cd806232b960 Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Mon, 18 Apr 2022 09:38:51 +0800
Subject: [PATCH 4109/5547] Add inline comments

---
 osu.Game.Rulesets.Osu/Utils/OsuHitObjectGenerationUtils.cs | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/osu.Game.Rulesets.Osu/Utils/OsuHitObjectGenerationUtils.cs b/osu.Game.Rulesets.Osu/Utils/OsuHitObjectGenerationUtils.cs
index 7b0d061e9a..266f7d1251 100644
--- a/osu.Game.Rulesets.Osu/Utils/OsuHitObjectGenerationUtils.cs
+++ b/osu.Game.Rulesets.Osu/Utils/OsuHitObjectGenerationUtils.cs
@@ -116,6 +116,7 @@ namespace osu.Game.Rulesets.Osu.Utils
             if (!(osuObject is Slider slider))
                 return;
 
+            // No need to update the head and tail circles, since slider handles that when the new slider path is set
             slider.NestedHitObjects.OfType<SliderTick>().ForEach(h => h.Position = new Vector2(OsuPlayfield.BASE_SIZE.X - h.Position.X, h.Position.Y));
             slider.NestedHitObjects.OfType<SliderRepeat>().ForEach(h => h.Position = new Vector2(OsuPlayfield.BASE_SIZE.X - h.Position.X, h.Position.Y));
 
@@ -137,6 +138,7 @@ namespace osu.Game.Rulesets.Osu.Utils
             if (!(osuObject is Slider slider))
                 return;
 
+            // No need to update the head and tail circles, since slider handles that when the new slider path is set
             slider.NestedHitObjects.OfType<SliderTick>().ForEach(h => h.Position = new Vector2(h.Position.X, OsuPlayfield.BASE_SIZE.Y - h.Position.Y));
             slider.NestedHitObjects.OfType<SliderRepeat>().ForEach(h => h.Position = new Vector2(h.Position.X, OsuPlayfield.BASE_SIZE.Y - h.Position.Y));
 
@@ -156,6 +158,7 @@ namespace osu.Game.Rulesets.Osu.Utils
         {
             void rotateNestedObject(OsuHitObject nested) => nested.Position = rotateVector(nested.Position - slider.Position, rotation) + slider.Position;
 
+            // No need to update the head and tail circles, since slider handles that when the new slider path is set
             slider.NestedHitObjects.OfType<SliderTick>().ForEach(rotateNestedObject);
             slider.NestedHitObjects.OfType<SliderRepeat>().ForEach(rotateNestedObject);
 

From 338d94626e5cb5f86ce924c76e0cea3b16970a1f Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Mon, 18 Apr 2022 06:42:06 +0300
Subject: [PATCH 4110/5547] Expose underlying skin of `EditorBeatmapSkin`

---
 osu.Game/Screens/Edit/EditorBeatmapSkin.cs | 11 ++++++++---
 1 file changed, 8 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Screens/Edit/EditorBeatmapSkin.cs b/osu.Game/Screens/Edit/EditorBeatmapSkin.cs
index 429df85904..243a994a7f 100644
--- a/osu.Game/Screens/Edit/EditorBeatmapSkin.cs
+++ b/osu.Game/Screens/Edit/EditorBeatmapSkin.cs
@@ -21,13 +21,18 @@ namespace osu.Game.Screens.Edit
     {
         public event Action BeatmapSkinChanged;
 
+        /// <summary>
+        /// The underlying beatmap skin.
+        /// </summary>
+        protected internal ISkin Skin => skin;
+
+        private readonly Skin skin;
+
         /// <summary>
         /// The combo colours of this skin.
         /// If empty, the default combo colours will be used.
         /// </summary>
-        public readonly BindableList<Colour4> ComboColours;
-
-        private readonly Skin skin;
+        public BindableList<Colour4> ComboColours { get; }
 
         public EditorBeatmapSkin(Skin skin)
         {

From 80cce7c3cb1d5c840ec6bbb599a3bcdf3baf1e17 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Mon, 18 Apr 2022 06:46:06 +0300
Subject: [PATCH 4111/5547] Add failing test case

---
 .../Visual/Editing/TestSceneComposeScreen.cs  | 63 +++++++++++++------
 1 file changed, 45 insertions(+), 18 deletions(-)

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneComposeScreen.cs b/osu.Game.Tests/Visual/Editing/TestSceneComposeScreen.cs
index d100fba8d6..30c8539d85 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneComposeScreen.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneComposeScreen.cs
@@ -1,44 +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.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
+using osu.Framework.Extensions.ObjectExtensions;
+using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
+using osu.Framework.Testing;
 using osu.Game.Rulesets.Edit;
 using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Osu.Beatmaps;
 using osu.Game.Screens.Edit;
 using osu.Game.Screens.Edit.Compose;
+using osu.Game.Skinning;
 
 namespace osu.Game.Tests.Visual.Editing
 {
     [TestFixture]
     public class TestSceneComposeScreen : EditorClockTestScene
     {
-        [Cached(typeof(EditorBeatmap))]
-        [Cached(typeof(IBeatSnapProvider))]
-        private readonly EditorBeatmap editorBeatmap =
-            new EditorBeatmap(new OsuBeatmap
-            {
-                BeatmapInfo =
-                {
-                    Ruleset = new OsuRuleset().RulesetInfo
-                }
-            });
+        private EditorBeatmap editorBeatmap;
 
         [Cached]
         private EditorClipboard clipboard = new EditorClipboard();
 
-        protected override void LoadComplete()
+        [SetUpSteps]
+        public void SetUpSteps()
         {
-            base.LoadComplete();
-
-            Beatmap.Value = CreateWorkingBeatmap(editorBeatmap.PlayableBeatmap);
-
-            Child = new ComposeScreen
+            AddStep("setup compose screen", () =>
             {
-                State = { Value = Visibility.Visible },
-            };
+                var beatmap = new OsuBeatmap
+                {
+                    BeatmapInfo = { Ruleset = new OsuRuleset().RulesetInfo }
+                };
+
+                editorBeatmap = new EditorBeatmap(beatmap, new LegacyBeatmapSkin(beatmap.BeatmapInfo, null));
+
+                Beatmap.Value = CreateWorkingBeatmap(editorBeatmap.PlayableBeatmap);
+
+                Child = new DependencyProvidingContainer
+                {
+                    RelativeSizeAxes = Axes.Both,
+                    CachedDependencies = new (Type, object)[]
+                    {
+                        (typeof(EditorBeatmap), editorBeatmap),
+                        (typeof(IBeatSnapProvider), editorBeatmap),
+                    },
+                    Child = new ComposeScreen { State = { Value = Visibility.Visible } },
+                };
+            });
+
+            AddUntilStep("wait for composer", () => this.ChildrenOfType<HitObjectComposer>().SingleOrDefault()?.IsLoaded == true);
+        }
+
+        /// <summary>
+        /// Ensures that the skin of the edited beatmap is properly wrapped in a <see cref="LegacySkinTransformer"/>.
+        /// </summary>
+        [Test]
+        public void TestLegacyBeatmapSkinHasTransformer()
+        {
+            AddAssert("legacy beatmap skin has transformer", () =>
+            {
+                var sources = this.ChildrenOfType<BeatmapSkinProvidingContainer>().First().AllSources;
+                return sources.OfType<LegacySkinTransformer>().Count(t => t.Skin == editorBeatmap.BeatmapSkin.AsNonNull().Skin) == 1;
+            });
         }
     }
 }

From 2cb217e06c04d63de4bc4151c7631b9abc448062 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Mon, 18 Apr 2022 06:59:44 +0300
Subject: [PATCH 4112/5547] Fix editor legacy beatmap skins not receiving
 transformer

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

diff --git a/osu.Game/Screens/Edit/EditorSkinProvidingContainer.cs b/osu.Game/Screens/Edit/EditorSkinProvidingContainer.cs
index decfa879a8..694d0253e0 100644
--- a/osu.Game/Screens/Edit/EditorSkinProvidingContainer.cs
+++ b/osu.Game/Screens/Edit/EditorSkinProvidingContainer.cs
@@ -16,7 +16,7 @@ namespace osu.Game.Screens.Edit
         private readonly EditorBeatmapSkin? beatmapSkin;
 
         public EditorSkinProvidingContainer(EditorBeatmap editorBeatmap)
-            : base(editorBeatmap.PlayableBeatmap.BeatmapInfo.Ruleset.CreateInstance(), editorBeatmap.PlayableBeatmap, editorBeatmap.BeatmapSkin)
+            : base(editorBeatmap.PlayableBeatmap.BeatmapInfo.Ruleset.CreateInstance(), editorBeatmap.PlayableBeatmap, editorBeatmap.BeatmapSkin?.Skin)
         {
             beatmapSkin = editorBeatmap.BeatmapSkin;
         }

From 90093c1d9d3fab7757218cdb021f08c64cdd1fe7 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 18 Apr 2022 13:32:37 +0900
Subject: [PATCH 4113/5547] Combine `private` skin variable into exposed one

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

diff --git a/osu.Game/Screens/Edit/EditorBeatmapSkin.cs b/osu.Game/Screens/Edit/EditorBeatmapSkin.cs
index 243a994a7f..f650ffa5a3 100644
--- a/osu.Game/Screens/Edit/EditorBeatmapSkin.cs
+++ b/osu.Game/Screens/Edit/EditorBeatmapSkin.cs
@@ -24,9 +24,7 @@ namespace osu.Game.Screens.Edit
         /// <summary>
         /// The underlying beatmap skin.
         /// </summary>
-        protected internal ISkin Skin => skin;
-
-        private readonly Skin skin;
+        protected internal readonly Skin Skin;
 
         /// <summary>
         /// The combo colours of this skin.
@@ -36,11 +34,11 @@ namespace osu.Game.Screens.Edit
 
         public EditorBeatmapSkin(Skin skin)
         {
-            this.skin = skin;
+            Skin = skin;
 
             ComboColours = new BindableList<Colour4>();
-            if (skin.Configuration.ComboColours != null)
-                ComboColours.AddRange(skin.Configuration.ComboColours.Select(c => (Colour4)c));
+            if (Skin.Configuration.ComboColours != null)
+                ComboColours.AddRange(Skin.Configuration.ComboColours.Select(c => (Colour4)c));
             ComboColours.BindCollectionChanged((_, __) => updateColours());
         }
 
@@ -48,16 +46,16 @@ namespace osu.Game.Screens.Edit
 
         private void updateColours()
         {
-            skin.Configuration.CustomComboColours = ComboColours.Select(c => (Color4)c).ToList();
+            Skin.Configuration.CustomComboColours = ComboColours.Select(c => (Color4)c).ToList();
             invokeSkinChanged();
         }
 
         #region Delegated ISkin implementation
 
-        public Drawable GetDrawableComponent(ISkinComponent component) => skin.GetDrawableComponent(component);
-        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(ISkinComponent component) => Skin.GetDrawableComponent(component);
+        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);
 
         #endregion
     }

From fcb48c69cf8e30b4ae9a42bd7f2484b8ecdba175 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Mon, 18 Apr 2022 07:57:13 +0300
Subject: [PATCH 4114/5547] Calculate sample playback position using
 screen-space drawable rectangles

---
 .../Objects/Drawables/DrawableOsuHitObject.cs               | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableOsuHitObject.cs b/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableOsuHitObject.cs
index a1c8879105..ff87f441d6 100644
--- a/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableOsuHitObject.cs
+++ b/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableOsuHitObject.cs
@@ -6,10 +6,10 @@ using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Game.Rulesets.Objects.Drawables;
 using osu.Framework.Graphics;
+using osu.Framework.Graphics.Primitives;
 using osu.Game.Rulesets.Judgements;
 using osu.Game.Rulesets.Osu.Judgements;
 using osu.Game.Graphics.Containers;
-using osu.Game.Rulesets.Osu.UI;
 using osuTK;
 
 namespace osu.Game.Rulesets.Osu.Objects.Drawables
@@ -24,7 +24,9 @@ namespace osu.Game.Rulesets.Osu.Objects.Drawables
         // Must be set to update IsHovered as it's used in relax mod to detect osu hit objects.
         public override bool HandlePositionalInput => true;
 
-        protected override float SamplePlaybackPosition => HitObject.X / OsuPlayfield.BASE_SIZE.X;
+        protected override float SamplePlaybackPosition => (ScreenSpaceDrawQuad.Centre.X - parentScreenSpaceRectangle.X) / parentScreenSpaceRectangle.Width;
+
+        private RectangleF parentScreenSpaceRectangle => ((DrawableOsuHitObject)ParentHitObject)?.parentScreenSpaceRectangle ?? Parent.ScreenSpaceDrawQuad.AABBFloat;
 
         /// <summary>
         /// Whether this <see cref="DrawableOsuHitObject"/> can be hit, given a time value.

From 3a00931e3898fc4d7e8fc30500e2d3526378d699 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Mon, 18 Apr 2022 09:18:56 +0300
Subject: [PATCH 4115/5547] Update slider sliding samples balance calculation
 to use screen-space as well

---
 .../Objects/Drawables/DrawableOsuHitObject.cs        | 12 +++++++++---
 .../Objects/Drawables/DrawableSlider.cs              |  3 +--
 2 files changed, 10 insertions(+), 5 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableOsuHitObject.cs b/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableOsuHitObject.cs
index ff87f441d6..fa2d2ba38c 100644
--- a/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableOsuHitObject.cs
+++ b/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableOsuHitObject.cs
@@ -24,9 +24,7 @@ namespace osu.Game.Rulesets.Osu.Objects.Drawables
         // Must be set to update IsHovered as it's used in relax mod to detect osu hit objects.
         public override bool HandlePositionalInput => true;
 
-        protected override float SamplePlaybackPosition => (ScreenSpaceDrawQuad.Centre.X - parentScreenSpaceRectangle.X) / parentScreenSpaceRectangle.Width;
-
-        private RectangleF parentScreenSpaceRectangle => ((DrawableOsuHitObject)ParentHitObject)?.parentScreenSpaceRectangle ?? Parent.ScreenSpaceDrawQuad.AABBFloat;
+        protected override float SamplePlaybackPosition => CalculateDrawableRelativePosition(this);
 
         /// <summary>
         /// Whether this <see cref="DrawableOsuHitObject"/> can be hit, given a time value.
@@ -91,6 +89,14 @@ namespace osu.Game.Rulesets.Osu.Objects.Drawables
         /// </summary>
         public void MissForcefully() => ApplyResult(r => r.Type = r.Judgement.MinResult);
 
+        private RectangleF parentScreenSpaceRectangle => ((DrawableOsuHitObject)ParentHitObject)?.parentScreenSpaceRectangle ?? Parent.ScreenSpaceDrawQuad.AABBFloat;
+
+        /// <summary>
+        /// Calculates the position of the given <paramref name="drawable"/> relative to the playfield area.
+        /// </summary>
+        /// <param name="drawable">The drawable to calculate its relative position.</param>
+        protected float CalculateDrawableRelativePosition(Drawable drawable) => (drawable.ScreenSpaceDrawQuad.Centre.X - parentScreenSpaceRectangle.X) / parentScreenSpaceRectangle.Width;
+
         protected override JudgementResult CreateResult(Judgement judgement) => new OsuJudgementResult(HitObject, judgement);
     }
 }
diff --git a/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSlider.cs b/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSlider.cs
index 1447f131c6..c48ab998ba 100644
--- a/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSlider.cs
+++ b/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSlider.cs
@@ -13,7 +13,6 @@ using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Objects.Drawables;
 using osu.Game.Rulesets.Osu.Skinning;
 using osu.Game.Rulesets.Osu.Skinning.Default;
-using osu.Game.Rulesets.Osu.UI;
 using osu.Game.Rulesets.Scoring;
 using osu.Game.Skinning;
 using osuTK;
@@ -208,7 +207,7 @@ namespace osu.Game.Rulesets.Osu.Objects.Drawables
 
             if (Tracking.Value && slidingSample != null)
                 // keep the sliding sample playing at the current tracking position
-                slidingSample.Balance.Value = CalculateSamplePlaybackBalance(Ball.X / OsuPlayfield.BASE_SIZE.X);
+                slidingSample.Balance.Value = CalculateSamplePlaybackBalance(CalculateDrawableRelativePosition(Ball));
 
             double completionProgress = Math.Clamp((Time.Current - HitObject.StartTime) / HitObject.Duration, 0, 1);
 

From 2202863e1a1caf323aa341dec967fdaaefd4a237 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 18 Apr 2022 17:49:28 +0900
Subject: [PATCH 4116/5547] Split out `IPerformFromScreenRunner` to allow for
 easier testing

---
 osu.Game/OsuGame.cs                           |  8 +-----
 .../Dashboard/CurrentlyPlayingDisplay.cs      |  5 ++--
 .../Sections/DebugSettings/GeneralSettings.cs |  5 ++--
 .../StableDirectoryLocationDialog.cs          |  7 ++---
 osu.Game/Screens/IPerformFromScreenRunner.cs  | 26 +++++++++++++++++++
 osu.Game/Screens/Menu/MainMenu.cs             |  4 +--
 .../Skinning/Editor/SkinEditorSceneLibrary.cs |  7 ++---
 7 files changed, 43 insertions(+), 19 deletions(-)
 create mode 100644 osu.Game/Screens/IPerformFromScreenRunner.cs

diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index 73121f6e7d..76ccbe0a08 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -63,7 +63,7 @@ namespace osu.Game
     /// The full osu! experience. Builds on top of <see cref="OsuGameBase"/> to add menus and binding logic
     /// for initial components that are generally retrieved via DI.
     /// </summary>
-    public class OsuGame : OsuGameBase, IKeyBindingHandler<GlobalAction>, ILocalUserPlayInfo
+    public class OsuGame : OsuGameBase, IKeyBindingHandler<GlobalAction>, ILocalUserPlayInfo, IPerformFromScreenRunner
     {
         /// <summary>
         /// The amount of global offset to apply when a left/right anchored overlay is displayed (ie. settings or notifications).
@@ -586,12 +586,6 @@ namespace osu.Game
 
         private PerformFromMenuRunner performFromMainMenuTask;
 
-        /// <summary>
-        /// Perform an action only after returning to a specific screen as indicated by <paramref name="validScreens"/>.
-        /// Eagerly tries to exit the current screen until it succeeds.
-        /// </summary>
-        /// <param name="action">The action to perform once we are in the correct state.</param>
-        /// <param name="validScreens">An optional collection of valid screen types. If any of these screens are already current we can perform the action immediately, else the first valid parent will be made current before performing the action. <see cref="MainMenu"/> is used if not specified.</param>
         public void PerformFromScreen(Action<IScreen> action, IEnumerable<Type> validScreens = null)
         {
             performFromMainMenuTask?.Cancel();
diff --git a/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs b/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs
index 117de88166..786401b7a8 100644
--- a/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs
+++ b/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs
@@ -14,6 +14,7 @@ using osu.Game.Database;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Spectator;
+using osu.Game.Screens;
 using osu.Game.Screens.OnlinePlay.Match.Components;
 using osu.Game.Screens.Play;
 using osu.Game.Users;
@@ -106,7 +107,7 @@ namespace osu.Game.Overlays.Dashboard
             public readonly APIUser User;
 
             [Resolved(canBeNull: true)]
-            private OsuGame game { get; set; }
+            private IPerformFromScreenRunner performer { get; set; }
 
             public PlayingUserPanel(APIUser user)
             {
@@ -140,7 +141,7 @@ namespace osu.Game.Overlays.Dashboard
                                 Text = "Watch",
                                 Anchor = Anchor.TopCentre,
                                 Origin = Anchor.TopCentre,
-                                Action = () => game?.PerformFromScreen(s => s.Push(new SoloSpectator(User))),
+                                Action = () => performer?.PerformFromScreen(s => s.Push(new SoloSpectator(User))),
                                 Enabled = { Value = User.Id != api.LocalUser.Value.Id }
                             }
                         }
diff --git a/osu.Game/Overlays/Settings/Sections/DebugSettings/GeneralSettings.cs b/osu.Game/Overlays/Settings/Sections/DebugSettings/GeneralSettings.cs
index 60540a089e..8833420523 100644
--- a/osu.Game/Overlays/Settings/Sections/DebugSettings/GeneralSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/DebugSettings/GeneralSettings.cs
@@ -7,6 +7,7 @@ using osu.Framework.Graphics;
 using osu.Framework.Localisation;
 using osu.Framework.Screens;
 using osu.Game.Localisation;
+using osu.Game.Screens;
 using osu.Game.Screens.Import;
 
 namespace osu.Game.Overlays.Settings.Sections.DebugSettings
@@ -16,7 +17,7 @@ namespace osu.Game.Overlays.Settings.Sections.DebugSettings
         protected override LocalisableString Header => DebugSettingsStrings.GeneralHeader;
 
         [BackgroundDependencyLoader(true)]
-        private void load(FrameworkDebugConfigManager config, FrameworkConfigManager frameworkConfig, OsuGame game)
+        private void load(FrameworkDebugConfigManager config, FrameworkConfigManager frameworkConfig, IPerformFromScreenRunner performer)
         {
             Children = new Drawable[]
             {
@@ -34,7 +35,7 @@ namespace osu.Game.Overlays.Settings.Sections.DebugSettings
             Add(new SettingsButton
             {
                 Text = DebugSettingsStrings.ImportFiles,
-                Action = () => game?.PerformFromScreen(menu => menu.Push(new FileImportScreen()))
+                Action = () => performer?.PerformFromScreen(menu => menu.Push(new FileImportScreen()))
             });
         }
     }
diff --git a/osu.Game/Overlays/Settings/Sections/Maintenance/StableDirectoryLocationDialog.cs b/osu.Game/Overlays/Settings/Sections/Maintenance/StableDirectoryLocationDialog.cs
index 904c9deaae..4e81cd63b8 100644
--- a/osu.Game/Overlays/Settings/Sections/Maintenance/StableDirectoryLocationDialog.cs
+++ b/osu.Game/Overlays/Settings/Sections/Maintenance/StableDirectoryLocationDialog.cs
@@ -6,13 +6,14 @@ using osu.Framework.Allocation;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Screens;
 using osu.Game.Overlays.Dialog;
+using osu.Game.Screens;
 
 namespace osu.Game.Overlays.Settings.Sections.Maintenance
 {
     public class StableDirectoryLocationDialog : PopupDialog
     {
-        [Resolved]
-        private OsuGame game { get; set; }
+        [Resolved(canBeNull: true)]
+        private IPerformFromScreenRunner performer { get; set; }
 
         public StableDirectoryLocationDialog(TaskCompletionSource<string> taskCompletionSource)
         {
@@ -25,7 +26,7 @@ namespace osu.Game.Overlays.Settings.Sections.Maintenance
                 new PopupDialogOkButton
                 {
                     Text = "Sure! I know where it is located!",
-                    Action = () => Schedule(() => game.PerformFromScreen(screen => screen.Push(new StableDirectorySelectScreen(taskCompletionSource))))
+                    Action = () => Schedule(() => performer.PerformFromScreen(screen => screen.Push(new StableDirectorySelectScreen(taskCompletionSource))))
                 },
                 new PopupDialogCancelButton
                 {
diff --git a/osu.Game/Screens/IPerformFromScreenRunner.cs b/osu.Game/Screens/IPerformFromScreenRunner.cs
new file mode 100644
index 0000000000..655bebdeb0
--- /dev/null
+++ b/osu.Game/Screens/IPerformFromScreenRunner.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;
+using System.Collections.Generic;
+using osu.Framework.Allocation;
+using osu.Framework.Screens;
+using osu.Game.Screens.Menu;
+
+namespace osu.Game.Screens
+{
+    /// <summary>
+    /// Manages a global screen stack to allow nested components a guarantee of where work is executed.
+    /// </summary>
+    [Cached]
+    public interface IPerformFromScreenRunner
+    {
+        /// <summary>
+        /// Perform an action only after returning to a specific screen as indicated by <paramref name="validScreens"/>.
+        /// Eagerly tries to exit the current screen until it succeeds.
+        /// </summary>
+        /// <param name="action">The action to perform once we are in the correct state.</param>
+        /// <param name="validScreens">An optional collection of valid screen types. If any of these screens are already current we can perform the action immediately, else the first valid parent will be made current before performing the action. <see cref="MainMenu"/> is used if not specified.</param>
+        void PerformFromScreen(Action<IScreen> action, IEnumerable<Type> validScreens = null);
+    }
+}
diff --git a/osu.Game/Screens/Menu/MainMenu.cs b/osu.Game/Screens/Menu/MainMenu.cs
index e2d79b4015..442a536cf9 100644
--- a/osu.Game/Screens/Menu/MainMenu.cs
+++ b/osu.Game/Screens/Menu/MainMenu.cs
@@ -148,14 +148,14 @@ namespace osu.Game.Screens.Menu
         }
 
         [Resolved(canBeNull: true)]
-        private OsuGame game { get; set; }
+        private IPerformFromScreenRunner performer { get; set; }
 
         private void confirmAndExit()
         {
             if (exitConfirmed) return;
 
             exitConfirmed = true;
-            game?.PerformFromScreen(menu => menu.Exit());
+            performer?.PerformFromScreen(menu => menu.Exit());
         }
 
         private void preloadSongSelect()
diff --git a/osu.Game/Skinning/Editor/SkinEditorSceneLibrary.cs b/osu.Game/Skinning/Editor/SkinEditorSceneLibrary.cs
index 0808cd157f..4507526806 100644
--- a/osu.Game/Skinning/Editor/SkinEditorSceneLibrary.cs
+++ b/osu.Game/Skinning/Editor/SkinEditorSceneLibrary.cs
@@ -15,6 +15,7 @@ using osu.Game.Graphics.UserInterface;
 using osu.Game.Overlays;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Mods;
+using osu.Game.Screens;
 using osu.Game.Screens.Play;
 using osu.Game.Screens.Select;
 using osuTK;
@@ -28,7 +29,7 @@ namespace osu.Game.Skinning.Editor
         private const float padding = 10;
 
         [Resolved(canBeNull: true)]
-        private OsuGame game { get; set; }
+        private IPerformFromScreenRunner performer { get; set; }
 
         [Resolved]
         private IBindable<RulesetInfo> ruleset { get; set; }
@@ -75,7 +76,7 @@ namespace osu.Game.Skinning.Editor
                                     Text = "Song Select",
                                     Anchor = Anchor.CentreLeft,
                                     Origin = Anchor.CentreLeft,
-                                    Action = () => game?.PerformFromScreen(screen =>
+                                    Action = () => performer?.PerformFromScreen(screen =>
                                     {
                                         if (screen is SongSelect)
                                             return;
@@ -88,7 +89,7 @@ namespace osu.Game.Skinning.Editor
                                     Text = "Gameplay",
                                     Anchor = Anchor.CentreLeft,
                                     Origin = Anchor.CentreLeft,
-                                    Action = () => game?.PerformFromScreen(screen =>
+                                    Action = () => performer?.PerformFromScreen(screen =>
                                     {
                                         if (screen is Player)
                                             return;

From e3153132666a911dc2ac47d759d6a7654b128f59 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 18 Apr 2022 18:09:14 +0900
Subject: [PATCH 4117/5547] Split out `IDialogOverlay` to allow for easier
 testing

---
 .../TestSceneManageCollectionsDialog.cs       |  2 +-
 .../Visual/Navigation/TestSceneOsuGame.cs     |  2 +-
 .../Navigation/TestScenePerformFromScreen.cs  | 11 ++++---
 .../Navigation/TestSceneScreenNavigation.cs   | 13 ++++----
 .../TestSceneDeleteLocalScore.cs              |  2 +-
 .../UserInterface/TestSceneDialogOverlay.cs   |  2 +-
 .../Collections/DrawableCollectionListItem.cs |  2 +-
 osu.Game/Database/LegacyImportManager.cs      |  2 +-
 osu.Game/Online/Chat/ExternalLinkOpener.cs    |  2 +-
 .../Online/Leaderboards/LeaderboardScore.cs   |  2 +-
 osu.Game/Overlays/Dialog/PopupDialog.cs       |  2 +-
 osu.Game/Overlays/DialogOverlay.cs            |  2 +-
 osu.Game/Overlays/IDialogOverlay.cs           | 31 +++++++++++++++++++
 .../Sections/Maintenance/GeneralSettings.cs   |  2 +-
 .../Maintenance/MigrationSelectScreen.cs      |  2 +-
 osu.Game/PerformFromMenuRunner.cs             |  2 +-
 osu.Game/Screens/Edit/Editor.cs               |  2 +-
 osu.Game/Screens/Menu/MainMenu.cs             |  2 +-
 osu.Game/Screens/Menu/StorageErrorDialog.cs   |  2 +-
 .../Multiplayer/MultiplayerMatchSubScreen.cs  |  2 +-
 .../Carousel/DrawableCarouselBeatmapSet.cs    |  2 +-
 osu.Game/Screens/Select/SongSelect.cs         |  4 +--
 osu.Game/Tests/Visual/EditorTestScene.cs      |  2 +-
 osu.Game/Tests/Visual/ScreenTestScene.cs      |  2 +-
 24 files changed, 66 insertions(+), 33 deletions(-)
 create mode 100644 osu.Game/Overlays/IDialogOverlay.cs

diff --git a/osu.Game.Tests/Visual/Collections/TestSceneManageCollectionsDialog.cs b/osu.Game.Tests/Visual/Collections/TestSceneManageCollectionsDialog.cs
index e40dd58663..51ca55f37f 100644
--- a/osu.Game.Tests/Visual/Collections/TestSceneManageCollectionsDialog.cs
+++ b/osu.Game.Tests/Visual/Collections/TestSceneManageCollectionsDialog.cs
@@ -50,7 +50,7 @@ namespace osu.Game.Tests.Visual.Collections
             });
 
             Dependencies.Cache(manager);
-            Dependencies.Cache(dialogOverlay);
+            Dependencies.CacheAs<IDialogOverlay>(dialogOverlay);
         }
 
         [SetUp]
diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneOsuGame.cs b/osu.Game.Tests/Visual/Navigation/TestSceneOsuGame.cs
index b8d1636ea0..921d088fc7 100644
--- a/osu.Game.Tests/Visual/Navigation/TestSceneOsuGame.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneOsuGame.cs
@@ -49,7 +49,7 @@ namespace osu.Game.Tests.Visual.Navigation
             typeof(LoginOverlay),
             typeof(MusicController),
             typeof(AccountCreationOverlay),
-            typeof(DialogOverlay),
+            typeof(IDialogOverlay),
             typeof(ScreenshotManager)
         };
 
diff --git a/osu.Game.Tests/Visual/Navigation/TestScenePerformFromScreen.cs b/osu.Game.Tests/Visual/Navigation/TestScenePerformFromScreen.cs
index f045e3a3e8..c4099b55c7 100644
--- a/osu.Game.Tests/Visual/Navigation/TestScenePerformFromScreen.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestScenePerformFromScreen.cs
@@ -5,6 +5,7 @@ using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Extensions;
+using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Screens;
 using osu.Framework.Testing;
@@ -113,12 +114,12 @@ namespace osu.Game.Tests.Visual.Navigation
             AddAssert("did not perform", () => !actionPerformed);
             AddAssert("only one exit attempt", () => blocker.ExitAttempts == 1);
 
-            AddUntilStep("wait for dialog display", () => Game.Dependencies.Get<DialogOverlay>().IsLoaded);
+            AddUntilStep("wait for dialog display", () => ((Drawable)Game.Dependencies.Get<IDialogOverlay>()).IsLoaded);
 
             if (confirmed)
             {
                 AddStep("accept dialog", () => InputManager.Key(Key.Number1));
-                AddUntilStep("wait for dialog dismissed", () => Game.Dependencies.Get<DialogOverlay>().CurrentDialog == null);
+                AddUntilStep("wait for dialog dismissed", () => Game.Dependencies.Get<IDialogOverlay>().CurrentDialog == null);
                 AddUntilStep("did perform", () => actionPerformed);
             }
             else
@@ -145,7 +146,7 @@ namespace osu.Game.Tests.Visual.Navigation
 
             AddWaitStep("wait a bit", 10);
 
-            AddUntilStep("wait for dialog display", () => Game.Dependencies.Get<DialogOverlay>().IsLoaded);
+            AddUntilStep("wait for dialog display", () => ((Drawable)Game.Dependencies.Get<IDialogOverlay>()).IsLoaded);
 
             AddAssert("screen didn't change", () => Game.ScreenStack.CurrentScreen == blocker2);
             AddAssert("did not perform", () => !actionPerformed);
@@ -187,7 +188,7 @@ namespace osu.Game.Tests.Visual.Navigation
 
             AddWaitStep("wait a bit", 10);
 
-            AddUntilStep("wait for dialog display", () => Game.Dependencies.Get<DialogOverlay>().IsLoaded);
+            AddUntilStep("wait for dialog display", () => ((Drawable)Game.Dependencies.Get<IDialogOverlay>()).IsLoaded);
 
             AddAssert("screen didn't change", () => Game.ScreenStack.CurrentScreen == screenWithNestedStack);
             AddAssert("nested screen didn't change", () => screenWithNestedStack.SubScreenStack.CurrentScreen == screenWithNestedStack.Blocker);
@@ -221,7 +222,7 @@ namespace osu.Game.Tests.Visual.Navigation
         public class DialogBlockingScreen : OsuScreen
         {
             [Resolved]
-            private DialogOverlay dialogOverlay { get; set; }
+            private IDialogOverlay dialogOverlay { get; set; }
 
             private int dialogDisplayCount;
 
diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs b/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
index 394976eb43..0b7242eee0 100644
--- a/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
@@ -6,6 +6,7 @@ using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Extensions;
+using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.UserInterface;
 using osu.Framework.Screens;
@@ -200,10 +201,10 @@ namespace osu.Game.Tests.Visual.Navigation
 
             AddStep("choose clear all scores", () => InputManager.Key(Key.Number4));
 
-            AddUntilStep("wait for dialog display", () => Game.Dependencies.Get<DialogOverlay>().IsLoaded);
-            AddUntilStep("wait for dialog", () => Game.Dependencies.Get<DialogOverlay>().CurrentDialog != null);
+            AddUntilStep("wait for dialog display", () => ((Drawable)Game.Dependencies.Get<IDialogOverlay>()).IsLoaded);
+            AddUntilStep("wait for dialog", () => Game.Dependencies.Get<IDialogOverlay>().CurrentDialog != null);
             AddStep("confirm deletion", () => InputManager.Key(Key.Number1));
-            AddUntilStep("wait for dialog dismissed", () => Game.Dependencies.Get<DialogOverlay>().CurrentDialog == null);
+            AddUntilStep("wait for dialog dismissed", () => Game.Dependencies.Get<IDialogOverlay>().CurrentDialog == null);
 
             AddUntilStep("ensure score is pending deletion", () => Game.Realm.Run(r => r.Find<ScoreInfo>(score.ID)?.DeletePending == true));
 
@@ -246,10 +247,10 @@ namespace osu.Game.Tests.Visual.Navigation
                 InputManager.Click(MouseButton.Left);
             });
 
-            AddUntilStep("wait for dialog display", () => Game.Dependencies.Get<DialogOverlay>().IsLoaded);
-            AddUntilStep("wait for dialog", () => Game.Dependencies.Get<DialogOverlay>().CurrentDialog != null);
+            AddUntilStep("wait for dialog display", () => ((Drawable)Game.Dependencies.Get<IDialogOverlay>()).IsLoaded);
+            AddUntilStep("wait for dialog", () => Game.Dependencies.Get<IDialogOverlay>().CurrentDialog != null);
             AddStep("confirm deletion", () => InputManager.Key(Key.Number1));
-            AddUntilStep("wait for dialog dismissed", () => Game.Dependencies.Get<DialogOverlay>().CurrentDialog == null);
+            AddUntilStep("wait for dialog dismissed", () => Game.Dependencies.Get<IDialogOverlay>().CurrentDialog == null);
 
             AddUntilStep("ensure score is pending deletion", () => Game.Realm.Run(r => r.Find<ScoreInfo>(score.ID)?.DeletePending == true));
 
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
index 72dfc53c01..1350052ae6 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
@@ -42,7 +42,7 @@ namespace osu.Game.Tests.Visual.UserInterface
 
         private BeatmapInfo beatmapInfo;
 
-        [Cached]
+        [Cached(typeof(IDialogOverlay))]
         private readonly DialogOverlay dialogOverlay;
 
         public TestSceneDeleteLocalScore()
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneDialogOverlay.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneDialogOverlay.cs
index 405461eec8..17234f4022 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneDialogOverlay.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneDialogOverlay.cs
@@ -11,7 +11,7 @@ using osu.Game.Overlays.Dialog;
 namespace osu.Game.Tests.Visual.UserInterface
 {
     [TestFixture]
-    public class TestSceneDialogOverlay : OsuTestScene
+    public class TestSceneIDialogOverlay : OsuTestScene
     {
         private DialogOverlay overlay;
 
diff --git a/osu.Game/Collections/DrawableCollectionListItem.cs b/osu.Game/Collections/DrawableCollectionListItem.cs
index c4cb040b52..5a20b7e7bd 100644
--- a/osu.Game/Collections/DrawableCollectionListItem.cs
+++ b/osu.Game/Collections/DrawableCollectionListItem.cs
@@ -158,7 +158,7 @@ namespace osu.Game.Collections
             public Func<Vector2, bool> IsTextBoxHovered;
 
             [Resolved(CanBeNull = true)]
-            private DialogOverlay dialogOverlay { get; set; }
+            private IDialogOverlay dialogOverlay { get; set; }
 
             [Resolved(CanBeNull = true)]
             private CollectionManager collectionManager { get; set; }
diff --git a/osu.Game/Database/LegacyImportManager.cs b/osu.Game/Database/LegacyImportManager.cs
index 4dc26b18bb..59394c2952 100644
--- a/osu.Game/Database/LegacyImportManager.cs
+++ b/osu.Game/Database/LegacyImportManager.cs
@@ -40,7 +40,7 @@ namespace osu.Game.Database
         private OsuGame game { get; set; }
 
         [Resolved]
-        private DialogOverlay dialogOverlay { get; set; }
+        private IDialogOverlay dialogOverlay { get; set; }
 
         [Resolved(CanBeNull = true)]
         private DesktopGameHost desktopGameHost { get; set; }
diff --git a/osu.Game/Online/Chat/ExternalLinkOpener.cs b/osu.Game/Online/Chat/ExternalLinkOpener.cs
index 328b43c4e8..20d8459132 100644
--- a/osu.Game/Online/Chat/ExternalLinkOpener.cs
+++ b/osu.Game/Online/Chat/ExternalLinkOpener.cs
@@ -17,7 +17,7 @@ namespace osu.Game.Online.Chat
         private GameHost host { get; set; }
 
         [Resolved(CanBeNull = true)]
-        private DialogOverlay dialogOverlay { get; set; }
+        private IDialogOverlay dialogOverlay { get; set; }
 
         private Bindable<bool> externalLinkWarning;
 
diff --git a/osu.Game/Online/Leaderboards/LeaderboardScore.cs b/osu.Game/Online/Leaderboards/LeaderboardScore.cs
index ddd9d9a2b2..eecb7ff6b3 100644
--- a/osu.Game/Online/Leaderboards/LeaderboardScore.cs
+++ b/osu.Game/Online/Leaderboards/LeaderboardScore.cs
@@ -64,7 +64,7 @@ namespace osu.Game.Online.Leaderboards
         private List<ScoreComponentLabel> statisticsLabels;
 
         [Resolved(CanBeNull = true)]
-        private DialogOverlay dialogOverlay { get; set; }
+        private IDialogOverlay dialogOverlay { get; set; }
 
         [Resolved(CanBeNull = true)]
         private SongSelect songSelect { get; set; }
diff --git a/osu.Game/Overlays/Dialog/PopupDialog.cs b/osu.Game/Overlays/Dialog/PopupDialog.cs
index 6159ab59f0..9fd1a32e84 100644
--- a/osu.Game/Overlays/Dialog/PopupDialog.cs
+++ b/osu.Game/Overlays/Dialog/PopupDialog.cs
@@ -216,7 +216,7 @@ namespace osu.Game.Overlays.Dialog
             };
 
             // It's important we start in a visible state so our state fires on hide, even before load.
-            // This is used by the DialogOverlay to know when the dialog was dismissed.
+            // This is used by the IDialogOverlay to know when the dialog was dismissed.
             Show();
         }
 
diff --git a/osu.Game/Overlays/DialogOverlay.cs b/osu.Game/Overlays/DialogOverlay.cs
index 9dea1ca00a..15d89a561a 100644
--- a/osu.Game/Overlays/DialogOverlay.cs
+++ b/osu.Game/Overlays/DialogOverlay.cs
@@ -14,7 +14,7 @@ using osu.Game.Audio.Effects;
 
 namespace osu.Game.Overlays
 {
-    public class DialogOverlay : OsuFocusedOverlayContainer
+    public class DialogOverlay : OsuFocusedOverlayContainer, IDialogOverlay
     {
         private readonly Container dialogContainer;
 
diff --git a/osu.Game/Overlays/IDialogOverlay.cs b/osu.Game/Overlays/IDialogOverlay.cs
new file mode 100644
index 0000000000..07f28a7204
--- /dev/null
+++ b/osu.Game/Overlays/IDialogOverlay.cs
@@ -0,0 +1,31 @@
+#nullable enable
+// 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.Game.Overlays.Dialog;
+
+namespace osu.Game.Overlays
+{
+    /// <summary>
+    /// A global overlay that can show popup dialogs.
+    /// </summary>
+    [Cached]
+    public interface IDialogOverlay
+    {
+        /// <summary>
+        /// Push a new dialog for display.
+        /// </summary>
+        /// <remarks>
+        /// This will immediate dismiss any already displayed dialog (cancelling the action).
+        /// If the dialog instance provided is already displayed, it will be a noop.
+        /// </remarks>
+        /// <param name="dialog">The dialog to be presented.</param>
+        void Push(PopupDialog dialog);
+
+        /// <summary>
+        /// The currently displayed dialog, if any.
+        /// </summary>
+        PopupDialog? CurrentDialog { get; }
+    }
+}
diff --git a/osu.Game/Overlays/Settings/Sections/Maintenance/GeneralSettings.cs b/osu.Game/Overlays/Settings/Sections/Maintenance/GeneralSettings.cs
index aa02d086f4..be4b0decd9 100644
--- a/osu.Game/Overlays/Settings/Sections/Maintenance/GeneralSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Maintenance/GeneralSettings.cs
@@ -30,7 +30,7 @@ namespace osu.Game.Overlays.Settings.Sections.Maintenance
         private SettingsButton undeleteButton;
 
         [BackgroundDependencyLoader(permitNulls: true)]
-        private void load(BeatmapManager beatmaps, ScoreManager scores, SkinManager skins, [CanBeNull] CollectionManager collectionManager, [CanBeNull] LegacyImportManager legacyImportManager, DialogOverlay dialogOverlay)
+        private void load(BeatmapManager beatmaps, ScoreManager scores, SkinManager skins, [CanBeNull] CollectionManager collectionManager, [CanBeNull] LegacyImportManager legacyImportManager, IDialogOverlay dialogOverlay)
         {
             if (legacyImportManager?.SupportsImportFromStable == true)
             {
diff --git a/osu.Game/Overlays/Settings/Sections/Maintenance/MigrationSelectScreen.cs b/osu.Game/Overlays/Settings/Sections/Maintenance/MigrationSelectScreen.cs
index 0304a4291a..3cb5521e51 100644
--- a/osu.Game/Overlays/Settings/Sections/Maintenance/MigrationSelectScreen.cs
+++ b/osu.Game/Overlays/Settings/Sections/Maintenance/MigrationSelectScreen.cs
@@ -23,7 +23,7 @@ namespace osu.Game.Overlays.Settings.Sections.Maintenance
         private OsuGameBase game { get; set; }
 
         [Resolved(canBeNull: true)]
-        private DialogOverlay dialogOverlay { get; set; }
+        private IDialogOverlay dialogOverlay { get; set; }
 
         protected override DirectoryInfo InitialPath => new DirectoryInfo(storage.GetFullPath(string.Empty)).Parent;
 
diff --git a/osu.Game/PerformFromMenuRunner.cs b/osu.Game/PerformFromMenuRunner.cs
index 528470768c..7039d5379c 100644
--- a/osu.Game/PerformFromMenuRunner.cs
+++ b/osu.Game/PerformFromMenuRunner.cs
@@ -26,7 +26,7 @@ namespace osu.Game
         private NotificationOverlay notifications { get; set; }
 
         [Resolved]
-        private DialogOverlay dialogOverlay { get; set; }
+        private IDialogOverlay dialogOverlay { get; set; }
 
         [Resolved(canBeNull: true)]
         private OsuGame game { get; set; }
diff --git a/osu.Game/Screens/Edit/Editor.cs b/osu.Game/Screens/Edit/Editor.cs
index 57f7429e06..255571dfdb 100644
--- a/osu.Game/Screens/Edit/Editor.cs
+++ b/osu.Game/Screens/Edit/Editor.cs
@@ -84,7 +84,7 @@ namespace osu.Game.Screens.Edit
         private Storage storage { get; set; }
 
         [Resolved(canBeNull: true)]
-        private DialogOverlay dialogOverlay { get; set; }
+        private IDialogOverlay dialogOverlay { get; set; }
 
         [Resolved(canBeNull: true)]
         private NotificationOverlay notifications { get; set; }
diff --git a/osu.Game/Screens/Menu/MainMenu.cs b/osu.Game/Screens/Menu/MainMenu.cs
index e2d79b4015..9e6af860fc 100644
--- a/osu.Game/Screens/Menu/MainMenu.cs
+++ b/osu.Game/Screens/Menu/MainMenu.cs
@@ -60,7 +60,7 @@ namespace osu.Game.Screens.Menu
         private IAPIProvider api { get; set; }
 
         [Resolved(canBeNull: true)]
-        private DialogOverlay dialogOverlay { get; set; }
+        private IDialogOverlay dialogOverlay { get; set; }
 
         private BackgroundScreenDefault background;
 
diff --git a/osu.Game/Screens/Menu/StorageErrorDialog.cs b/osu.Game/Screens/Menu/StorageErrorDialog.cs
index 250623ec68..f4c77d5d8f 100644
--- a/osu.Game/Screens/Menu/StorageErrorDialog.cs
+++ b/osu.Game/Screens/Menu/StorageErrorDialog.cs
@@ -13,7 +13,7 @@ namespace osu.Game.Screens.Menu
     public class StorageErrorDialog : PopupDialog
     {
         [Resolved]
-        private DialogOverlay dialogOverlay { get; set; }
+        private IDialogOverlay dialogOverlay { get; set; }
 
         public StorageErrorDialog(OsuStorage storage, OsuStorageError error)
         {
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
index 7ef0bb5923..0dbf73fc5b 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
@@ -238,7 +238,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
         }
 
         [Resolved(canBeNull: true)]
-        private DialogOverlay dialogOverlay { get; set; }
+        private IDialogOverlay dialogOverlay { get; set; }
 
         private bool exitConfirmed;
 
diff --git a/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmapSet.cs b/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmapSet.cs
index 618c5cf5ec..2d70b1aecb 100644
--- a/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmapSet.cs
+++ b/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmapSet.cs
@@ -28,7 +28,7 @@ namespace osu.Game.Screens.Select.Carousel
         private Action<int> viewDetails;
 
         [Resolved(CanBeNull = true)]
-        private DialogOverlay dialogOverlay { get; set; }
+        private IDialogOverlay dialogOverlay { get; set; }
 
         [Resolved(CanBeNull = true)]
         private CollectionManager collectionManager { get; set; }
diff --git a/osu.Game/Screens/Select/SongSelect.cs b/osu.Game/Screens/Select/SongSelect.cs
index 2d1a2bce4e..dc505063d1 100644
--- a/osu.Game/Screens/Select/SongSelect.cs
+++ b/osu.Game/Screens/Select/SongSelect.cs
@@ -87,7 +87,7 @@ namespace osu.Game.Screens.Select
         protected Container LeftArea { get; private set; }
 
         private BeatmapInfoWedge beatmapInfoWedge;
-        private DialogOverlay dialogOverlay;
+        private IDialogOverlay dialogOverlay;
 
         [Resolved]
         private BeatmapManager beatmaps { get; set; }
@@ -114,7 +114,7 @@ namespace osu.Game.Screens.Select
         private MusicController music { get; set; }
 
         [BackgroundDependencyLoader(true)]
-        private void load(AudioManager audio, DialogOverlay dialog, OsuColour colours, ManageCollectionsDialog manageCollectionsDialog, DifficultyRecommender recommender)
+        private void load(AudioManager audio, IDialogOverlay dialog, OsuColour colours, ManageCollectionsDialog manageCollectionsDialog, DifficultyRecommender recommender)
         {
             // initial value transfer is required for FilterControl (it uses our re-cached bindables in its async load for the initial filter).
             transferRulesetValue();
diff --git a/osu.Game/Tests/Visual/EditorTestScene.cs b/osu.Game/Tests/Visual/EditorTestScene.cs
index 51221cb8fe..ca12bc73fe 100644
--- a/osu.Game/Tests/Visual/EditorTestScene.cs
+++ b/osu.Game/Tests/Visual/EditorTestScene.cs
@@ -98,7 +98,7 @@ namespace osu.Game.Tests.Visual
         {
             [Resolved(canBeNull: true)]
             [CanBeNull]
-            private DialogOverlay dialogOverlay { get; set; }
+            private IDialogOverlay dialogOverlay { get; set; }
 
             public new void Undo() => base.Undo();
 
diff --git a/osu.Game/Tests/Visual/ScreenTestScene.cs b/osu.Game/Tests/Visual/ScreenTestScene.cs
index b6f6ca6daa..e9069d8c9c 100644
--- a/osu.Game/Tests/Visual/ScreenTestScene.cs
+++ b/osu.Game/Tests/Visual/ScreenTestScene.cs
@@ -23,7 +23,7 @@ namespace osu.Game.Tests.Visual
 
         protected override Container<Drawable> Content => content;
 
-        [Cached]
+        [Cached(typeof(IDialogOverlay))]
         protected DialogOverlay DialogOverlay { get; private set; }
 
         protected ScreenTestScene()

From 25f1f772f3d6cad2a0bb9728057e106588555bd0 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 18 Apr 2022 18:36:22 +0900
Subject: [PATCH 4118/5547] Allow caching via `loadComponentSingleFile` with
 interface specification

---
 osu.Game/OsuGame.cs | 11 +++++++----
 1 file changed, 7 insertions(+), 4 deletions(-)

diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index 73121f6e7d..f8bc32431c 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -825,7 +825,7 @@ namespace osu.Game
             }, rightFloatingOverlayContent.Add, true);
 
             loadComponentSingleFile(new AccountCreationOverlay(), topMostOverlayContent.Add, true);
-            loadComponentSingleFile(new DialogOverlay(), topMostOverlayContent.Add, true);
+            loadComponentSingleFile<IDialogOverlay>(new DialogOverlay(), topMostOverlayContent.Add, true);
 
             loadComponentSingleFile(CreateHighPerformanceSession(), Add);
 
@@ -982,12 +982,15 @@ namespace osu.Game
         /// <param name="component">The component to load.</param>
         /// <param name="loadCompleteAction">An action to invoke on load completion (generally to add the component to the hierarchy).</param>
         /// <param name="cache">Whether to cache the component as type <typeparamref name="T"/> into the game dependencies before any scheduling.</param>
-        private T loadComponentSingleFile<T>(T component, Action<T> loadCompleteAction, bool cache = false)
-            where T : Drawable
+        private T loadComponentSingleFile<T>(T component, Action<Drawable> loadCompleteAction, bool cache = false)
+            where T : class
         {
             if (cache)
                 dependencies.CacheAs(component);
 
+            var drawableComponent = component as Drawable;
+            Debug.Assert(drawableComponent != null);
+
             if (component is OsuFocusedOverlayContainer overlay)
                 focusedOverlays.Add(overlay);
 
@@ -1011,7 +1014,7 @@ namespace osu.Game
                         // Since this is running in a separate thread, it is possible for OsuGame to be disposed after LoadComponentAsync has been called
                         // throwing an exception. To avoid this, the call is scheduled on the update thread, which does not run if IsDisposed = true
                         Task task = null;
-                        var del = new ScheduledDelegate(() => task = LoadComponentAsync(component, loadCompleteAction));
+                        var del = new ScheduledDelegate(() => task = LoadComponentAsync(drawableComponent, loadCompleteAction));
                         Scheduler.Add(del);
 
                         // The delegate won't complete if OsuGame has been disposed in the meantime

From fea4632e839207ae1b183878aff42a437e271fa6 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 18 Apr 2022 20:04:19 +0900
Subject: [PATCH 4119/5547] Convert assert to hard throw

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

diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index f8bc32431c..e10da39055 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -988,8 +988,7 @@ namespace osu.Game
             if (cache)
                 dependencies.CacheAs(component);
 
-            var drawableComponent = component as Drawable;
-            Debug.Assert(drawableComponent != null);
+            var drawableComponent = component as Drawable ?? throw new ArgumentException($"Component must be a {nameof(Drawable)}", nameof(component));
 
             if (component is OsuFocusedOverlayContainer overlay)
                 focusedOverlays.Add(overlay);

From d86e3abf2c5d4857062cf23d680fa40f94006a0e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 18 Apr 2022 20:04:38 +0900
Subject: [PATCH 4120/5547] Fix invalid rename

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

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneDialogOverlay.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneDialogOverlay.cs
index 17234f4022..405461eec8 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneDialogOverlay.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneDialogOverlay.cs
@@ -11,7 +11,7 @@ using osu.Game.Overlays.Dialog;
 namespace osu.Game.Tests.Visual.UserInterface
 {
     [TestFixture]
-    public class TestSceneIDialogOverlay : OsuTestScene
+    public class TestSceneDialogOverlay : OsuTestScene
     {
         private DialogOverlay overlay;
 

From 72a33c0926dde589b5dc1c2ffabdcf5184bdb474 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 18 Apr 2022 20:06:08 +0900
Subject: [PATCH 4121/5547] Split out step for dialog overlay load wait

---
 .../Visual/Navigation/TestScenePerformFromScreen.cs       | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Tests/Visual/Navigation/TestScenePerformFromScreen.cs b/osu.Game.Tests/Visual/Navigation/TestScenePerformFromScreen.cs
index c4099b55c7..559e6ddd89 100644
--- a/osu.Game.Tests/Visual/Navigation/TestScenePerformFromScreen.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestScenePerformFromScreen.cs
@@ -114,7 +114,7 @@ namespace osu.Game.Tests.Visual.Navigation
             AddAssert("did not perform", () => !actionPerformed);
             AddAssert("only one exit attempt", () => blocker.ExitAttempts == 1);
 
-            AddUntilStep("wait for dialog display", () => ((Drawable)Game.Dependencies.Get<IDialogOverlay>()).IsLoaded);
+            waitForDialogOverlayLoad();
 
             if (confirmed)
             {
@@ -146,7 +146,7 @@ namespace osu.Game.Tests.Visual.Navigation
 
             AddWaitStep("wait a bit", 10);
 
-            AddUntilStep("wait for dialog display", () => ((Drawable)Game.Dependencies.Get<IDialogOverlay>()).IsLoaded);
+            waitForDialogOverlayLoad();
 
             AddAssert("screen didn't change", () => Game.ScreenStack.CurrentScreen == blocker2);
             AddAssert("did not perform", () => !actionPerformed);
@@ -188,7 +188,7 @@ namespace osu.Game.Tests.Visual.Navigation
 
             AddWaitStep("wait a bit", 10);
 
-            AddUntilStep("wait for dialog display", () => ((Drawable)Game.Dependencies.Get<IDialogOverlay>()).IsLoaded);
+            waitForDialogOverlayLoad();
 
             AddAssert("screen didn't change", () => Game.ScreenStack.CurrentScreen == screenWithNestedStack);
             AddAssert("nested screen didn't change", () => screenWithNestedStack.SubScreenStack.CurrentScreen == screenWithNestedStack.Blocker);
@@ -212,6 +212,8 @@ namespace osu.Game.Tests.Visual.Navigation
             }
         }
 
+        private void waitForDialogOverlayLoad() => AddUntilStep("wait for dialog overlay loaded", () => ((Drawable)Game.Dependencies.Get<IDialogOverlay>()).IsLoaded);
+
         private void importAndWaitForSongSelect()
         {
             AddStep("import beatmap", () => BeatmapImportHelper.LoadQuickOszIntoOsu(Game).WaitSafely());

From 043599081bc29f81fa6888d48d214d1cc505edb3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 18 Apr 2022 19:59:57 +0900
Subject: [PATCH 4122/5547] Split out `INotificationOverlay` to allow for
 easier testing

---
 .../Security/ElevatedPrivilegesChecker.cs     |  2 +-
 osu.Desktop/Updater/SquirrelUpdateManager.cs  |  2 +-
 osu.Game.Tests/Visual/Menus/IntroTestScene.cs |  2 +-
 .../Visual/Navigation/TestSceneOsuGame.cs     |  2 +-
 .../Visual/Online/TestSceneMessageNotifier.cs |  2 +-
 osu.Game/Database/EFToRealmMigrator.cs        |  2 +-
 osu.Game/Graphics/ScreenshotManager.cs        |  2 +-
 osu.Game/Online/Chat/MessageNotifier.cs       |  4 +--
 osu.Game/OsuGame.cs                           |  2 +-
 .../BeatmapSet/Buttons/FavouriteButton.cs     |  2 +-
 osu.Game/Overlays/INotificationOverlay.cs     | 26 +++++++++++++++++++
 osu.Game/Overlays/NotificationOverlay.cs      |  6 +----
 .../Sections/General/UpdateSettings.cs        |  2 +-
 .../Maintenance/MigrationRunScreen.cs         |  2 +-
 osu.Game/PerformFromMenuRunner.cs             |  2 +-
 osu.Game/Screens/Edit/Editor.cs               |  2 +-
 osu.Game/Screens/Menu/ButtonSystem.cs         |  2 +-
 osu.Game/Screens/Menu/IntroScreen.cs          |  2 +-
 osu.Game/Screens/Play/HUDOverlay.cs           |  2 +-
 osu.Game/Screens/Play/PlayerLoader.cs         |  4 +--
 osu.Game/Screens/Select/PlaySongSelect.cs     |  2 +-
 osu.Game/Updater/UpdateManager.cs             |  4 +--
 22 files changed, 50 insertions(+), 28 deletions(-)
 create mode 100644 osu.Game/Overlays/INotificationOverlay.cs

diff --git a/osu.Desktop/Security/ElevatedPrivilegesChecker.cs b/osu.Desktop/Security/ElevatedPrivilegesChecker.cs
index 8f3ad853dc..ba37a14442 100644
--- a/osu.Desktop/Security/ElevatedPrivilegesChecker.cs
+++ b/osu.Desktop/Security/ElevatedPrivilegesChecker.cs
@@ -19,7 +19,7 @@ namespace osu.Desktop.Security
     public class ElevatedPrivilegesChecker : Component
     {
         [Resolved]
-        private NotificationOverlay notifications { get; set; }
+        private INotificationOverlay notifications { get; set; }
 
         private bool elevated;
 
diff --git a/osu.Desktop/Updater/SquirrelUpdateManager.cs b/osu.Desktop/Updater/SquirrelUpdateManager.cs
index b307146b10..bae850fce1 100644
--- a/osu.Desktop/Updater/SquirrelUpdateManager.cs
+++ b/osu.Desktop/Updater/SquirrelUpdateManager.cs
@@ -25,7 +25,7 @@ namespace osu.Desktop.Updater
     public class SquirrelUpdateManager : osu.Game.Updater.UpdateManager
     {
         private UpdateManager updateManager;
-        private NotificationOverlay notificationOverlay;
+        private INotificationOverlay notificationOverlay;
 
         public Task PrepareUpdateAsync() => UpdateManager.RestartAppWhenExited();
 
diff --git a/osu.Game.Tests/Visual/Menus/IntroTestScene.cs b/osu.Game.Tests/Visual/Menus/IntroTestScene.cs
index 82accceb23..c68cd39c65 100644
--- a/osu.Game.Tests/Visual/Menus/IntroTestScene.cs
+++ b/osu.Game.Tests/Visual/Menus/IntroTestScene.cs
@@ -26,7 +26,7 @@ namespace osu.Game.Tests.Visual.Menus
 
         private IntroScreen intro;
 
-        [Cached]
+        [Cached(typeof(INotificationOverlay))]
         private NotificationOverlay notifications;
 
         private ScheduledDelegate trackResetDelegate;
diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneOsuGame.cs b/osu.Game.Tests/Visual/Navigation/TestSceneOsuGame.cs
index 921d088fc7..0f8337deb6 100644
--- a/osu.Game.Tests/Visual/Navigation/TestSceneOsuGame.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneOsuGame.cs
@@ -37,7 +37,7 @@ namespace osu.Game.Tests.Visual.Navigation
             typeof(OsuLogo),
             typeof(IdleTracker),
             typeof(OnScreenDisplay),
-            typeof(NotificationOverlay),
+            typeof(INotificationOverlay),
             typeof(BeatmapListingOverlay),
             typeof(DashboardOverlay),
             typeof(NewsOverlay),
diff --git a/osu.Game.Tests/Visual/Online/TestSceneMessageNotifier.cs b/osu.Game.Tests/Visual/Online/TestSceneMessageNotifier.cs
index 2c253650d5..79f62a16e3 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneMessageNotifier.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneMessageNotifier.cs
@@ -200,7 +200,7 @@ namespace osu.Game.Tests.Visual.Online
             [Cached]
             public ChannelManager ChannelManager { get; } = new ChannelManager();
 
-            [Cached]
+            [Cached(typeof(INotificationOverlay))]
             public NotificationOverlay NotificationOverlay { get; } = new NotificationOverlay
             {
                 Anchor = Anchor.TopRight,
diff --git a/osu.Game/Database/EFToRealmMigrator.cs b/osu.Game/Database/EFToRealmMigrator.cs
index ae73e13b77..4e98b7d3d2 100644
--- a/osu.Game/Database/EFToRealmMigrator.cs
+++ b/osu.Game/Database/EFToRealmMigrator.cs
@@ -52,7 +52,7 @@ namespace osu.Game.Database
         private OsuConfigManager config { get; set; } = null!;
 
         [Resolved]
-        private NotificationOverlay notificationOverlay { get; set; } = null!;
+        private INotificationOverlay notificationOverlay { get; set; } = null!;
 
         [Resolved]
         private OsuGame game { get; set; } = null!;
diff --git a/osu.Game/Graphics/ScreenshotManager.cs b/osu.Game/Graphics/ScreenshotManager.cs
index b0f20de685..a2f1a3d7b9 100644
--- a/osu.Game/Graphics/ScreenshotManager.cs
+++ b/osu.Game/Graphics/ScreenshotManager.cs
@@ -43,7 +43,7 @@ namespace osu.Game.Graphics
         private Storage storage;
 
         [Resolved]
-        private NotificationOverlay notificationOverlay { get; set; }
+        private INotificationOverlay notificationOverlay { get; set; }
 
         private Sample shutter;
 
diff --git a/osu.Game/Online/Chat/MessageNotifier.cs b/osu.Game/Online/Chat/MessageNotifier.cs
index 20c33db61f..ca6082e19b 100644
--- a/osu.Game/Online/Chat/MessageNotifier.cs
+++ b/osu.Game/Online/Chat/MessageNotifier.cs
@@ -24,7 +24,7 @@ namespace osu.Game.Online.Chat
     public class MessageNotifier : Component
     {
         [Resolved]
-        private NotificationOverlay notifications { get; set; }
+        private INotificationOverlay notifications { get; set; }
 
         [Resolved]
         private ChatOverlay chatOverlay { get; set; }
@@ -170,7 +170,7 @@ namespace osu.Game.Online.Chat
             public override bool IsImportant => false;
 
             [BackgroundDependencyLoader]
-            private void load(OsuColour colours, ChatOverlay chatOverlay, NotificationOverlay notificationOverlay)
+            private void load(OsuColour colours, ChatOverlay chatOverlay, INotificationOverlay notificationOverlay)
             {
                 IconBackground.Colour = colours.PurpleDark;
 
diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index e10da39055..45d76cc15b 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -778,7 +778,7 @@ namespace osu.Game
 
             loadComponentSingleFile(onScreenDisplay, Add, true);
 
-            loadComponentSingleFile(Notifications.With(d =>
+            loadComponentSingleFile<INotificationOverlay>(Notifications.With(d =>
             {
                 d.Anchor = Anchor.TopRight;
                 d.Origin = Anchor.TopRight;
diff --git a/osu.Game/Overlays/BeatmapSet/Buttons/FavouriteButton.cs b/osu.Game/Overlays/BeatmapSet/Buttons/FavouriteButton.cs
index 8fe7450873..28100e5fff 100644
--- a/osu.Game/Overlays/BeatmapSet/Buttons/FavouriteButton.cs
+++ b/osu.Game/Overlays/BeatmapSet/Buttons/FavouriteButton.cs
@@ -41,7 +41,7 @@ namespace osu.Game.Overlays.BeatmapSet.Buttons
         }
 
         [BackgroundDependencyLoader(true)]
-        private void load(IAPIProvider api, NotificationOverlay notifications)
+        private void load(IAPIProvider api, INotificationOverlay notifications)
         {
             SpriteIcon icon;
 
diff --git a/osu.Game/Overlays/INotificationOverlay.cs b/osu.Game/Overlays/INotificationOverlay.cs
new file mode 100644
index 0000000000..432dd2be54
--- /dev/null
+++ b/osu.Game/Overlays/INotificationOverlay.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 osu.Framework.Allocation;
+using osu.Game.Overlays.Notifications;
+
+namespace osu.Game.Overlays
+{
+    /// <summary>
+    /// An overlay which is capable of showing notifications to the user.
+    /// </summary>
+    [Cached]
+    public interface INotificationOverlay
+    {
+        /// <summary>
+        /// Post a new notification for display.
+        /// </summary>
+        /// <param name="notification">The notification to display.</param>
+        void Post(Notification notification);
+
+        /// <summary>
+        /// Hide the overlay, if it is currently visible.
+        /// </summary>
+        void Hide();
+    }
+}
diff --git a/osu.Game/Overlays/NotificationOverlay.cs b/osu.Game/Overlays/NotificationOverlay.cs
index e4e3931048..0e8fbc6680 100644
--- a/osu.Game/Overlays/NotificationOverlay.cs
+++ b/osu.Game/Overlays/NotificationOverlay.cs
@@ -19,7 +19,7 @@ using osu.Game.Localisation;
 
 namespace osu.Game.Overlays
 {
-    public class NotificationOverlay : OsuFocusedOverlayContainer, INamedOverlayComponent
+    public class NotificationOverlay : OsuFocusedOverlayContainer, INamedOverlayComponent, INotificationOverlay
     {
         public string IconTexture => "Icons/Hexacons/notification";
         public LocalisableString Title => NotificationsStrings.HeaderTitle;
@@ -111,10 +111,6 @@ namespace osu.Game.Overlays
 
         private double? lastSamplePlayback;
 
-        /// <summary>
-        /// Post a new notification for display.
-        /// </summary>
-        /// <param name="notification">The notification to display.</param>
         public void Post(Notification notification) => postScheduler.Add(() =>
         {
             ++runningDepth;
diff --git a/osu.Game/Overlays/Settings/Sections/General/UpdateSettings.cs b/osu.Game/Overlays/Settings/Sections/General/UpdateSettings.cs
index 0b4eca6379..5bc88b8692 100644
--- a/osu.Game/Overlays/Settings/Sections/General/UpdateSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/General/UpdateSettings.cs
@@ -27,7 +27,7 @@ namespace osu.Game.Overlays.Settings.Sections.General
         private SettingsButton checkForUpdatesButton;
 
         [Resolved(CanBeNull = true)]
-        private NotificationOverlay notifications { get; set; }
+        private INotificationOverlay notifications { get; set; }
 
         [BackgroundDependencyLoader(true)]
         private void load(Storage storage, OsuConfigManager config, OsuGame game)
diff --git a/osu.Game/Overlays/Settings/Sections/Maintenance/MigrationRunScreen.cs b/osu.Game/Overlays/Settings/Sections/Maintenance/MigrationRunScreen.cs
index fb7ff0dbd1..10d6f0aef5 100644
--- a/osu.Game/Overlays/Settings/Sections/Maintenance/MigrationRunScreen.cs
+++ b/osu.Game/Overlays/Settings/Sections/Maintenance/MigrationRunScreen.cs
@@ -27,7 +27,7 @@ namespace osu.Game.Overlays.Settings.Sections.Maintenance
         private OsuGame game { get; set; }
 
         [Resolved]
-        private NotificationOverlay notifications { get; set; }
+        private INotificationOverlay notifications { get; set; }
 
         [Resolved]
         private Storage storage { get; set; }
diff --git a/osu.Game/PerformFromMenuRunner.cs b/osu.Game/PerformFromMenuRunner.cs
index 7039d5379c..ae9879fb5a 100644
--- a/osu.Game/PerformFromMenuRunner.cs
+++ b/osu.Game/PerformFromMenuRunner.cs
@@ -23,7 +23,7 @@ namespace osu.Game
         private readonly Func<IScreen> getCurrentScreen;
 
         [Resolved]
-        private NotificationOverlay notifications { get; set; }
+        private INotificationOverlay notifications { get; set; }
 
         [Resolved]
         private IDialogOverlay dialogOverlay { get; set; }
diff --git a/osu.Game/Screens/Edit/Editor.cs b/osu.Game/Screens/Edit/Editor.cs
index 255571dfdb..602b7563ac 100644
--- a/osu.Game/Screens/Edit/Editor.cs
+++ b/osu.Game/Screens/Edit/Editor.cs
@@ -87,7 +87,7 @@ namespace osu.Game.Screens.Edit
         private IDialogOverlay dialogOverlay { get; set; }
 
         [Resolved(canBeNull: true)]
-        private NotificationOverlay notifications { get; set; }
+        private INotificationOverlay notifications { get; set; }
 
         public readonly Bindable<EditorScreenMode> Mode = new Bindable<EditorScreenMode>();
 
diff --git a/osu.Game/Screens/Menu/ButtonSystem.cs b/osu.Game/Screens/Menu/ButtonSystem.cs
index 8eeb90a3fd..598c441042 100644
--- a/osu.Game/Screens/Menu/ButtonSystem.cs
+++ b/osu.Game/Screens/Menu/ButtonSystem.cs
@@ -118,7 +118,7 @@ namespace osu.Game.Screens.Menu
         private IAPIProvider api { get; set; }
 
         [Resolved(CanBeNull = true)]
-        private NotificationOverlay notifications { get; set; }
+        private INotificationOverlay notifications { get; set; }
 
         [Resolved(CanBeNull = true)]
         private LoginOverlay loginOverlay { get; set; }
diff --git a/osu.Game/Screens/Menu/IntroScreen.cs b/osu.Game/Screens/Menu/IntroScreen.cs
index e569b0e517..5575d3681f 100644
--- a/osu.Game/Screens/Menu/IntroScreen.cs
+++ b/osu.Game/Screens/Menu/IntroScreen.cs
@@ -171,7 +171,7 @@ namespace osu.Game.Screens.Menu
         }
 
         [Resolved]
-        private NotificationOverlay notifications { get; set; }
+        private INotificationOverlay notifications { get; set; }
 
         private void ensureEventuallyArrivingAtMenu()
         {
diff --git a/osu.Game/Screens/Play/HUDOverlay.cs b/osu.Game/Screens/Play/HUDOverlay.cs
index 628452fbc8..676a08b434 100644
--- a/osu.Game/Screens/Play/HUDOverlay.cs
+++ b/osu.Game/Screens/Play/HUDOverlay.cs
@@ -119,7 +119,7 @@ namespace osu.Game.Screens.Play
         }
 
         [BackgroundDependencyLoader(true)]
-        private void load(OsuConfigManager config, NotificationOverlay notificationOverlay)
+        private void load(OsuConfigManager config, INotificationOverlay notificationOverlay)
         {
             if (drawableRuleset != null)
             {
diff --git a/osu.Game/Screens/Play/PlayerLoader.cs b/osu.Game/Screens/Play/PlayerLoader.cs
index ba720af2a1..b72ec373d7 100644
--- a/osu.Game/Screens/Play/PlayerLoader.cs
+++ b/osu.Game/Screens/Play/PlayerLoader.cs
@@ -515,7 +515,7 @@ namespace osu.Game.Screens.Play
             }
 
             [BackgroundDependencyLoader]
-            private void load(OsuColour colours, AudioManager audioManager, NotificationOverlay notificationOverlay, VolumeOverlay volumeOverlay)
+            private void load(OsuColour colours, AudioManager audioManager, INotificationOverlay notificationOverlay, VolumeOverlay volumeOverlay)
             {
                 Icon = FontAwesome.Solid.VolumeMute;
                 IconBackground.Colour = colours.RedDark;
@@ -567,7 +567,7 @@ namespace osu.Game.Screens.Play
             }
 
             [BackgroundDependencyLoader]
-            private void load(OsuColour colours, NotificationOverlay notificationOverlay)
+            private void load(OsuColour colours, INotificationOverlay notificationOverlay)
             {
                 Icon = FontAwesome.Solid.BatteryQuarter;
                 IconBackground.Colour = colours.RedDark;
diff --git a/osu.Game/Screens/Select/PlaySongSelect.cs b/osu.Game/Screens/Select/PlaySongSelect.cs
index 593436bbb7..4a991ffc66 100644
--- a/osu.Game/Screens/Select/PlaySongSelect.cs
+++ b/osu.Game/Screens/Select/PlaySongSelect.cs
@@ -25,7 +25,7 @@ namespace osu.Game.Screens.Select
         private OsuScreen playerLoader;
 
         [Resolved(CanBeNull = true)]
-        private NotificationOverlay notifications { get; set; }
+        private INotificationOverlay notifications { get; set; }
 
         public override bool AllowExternalScreenChange => true;
 
diff --git a/osu.Game/Updater/UpdateManager.cs b/osu.Game/Updater/UpdateManager.cs
index 9b9f354d23..c17d8304b9 100644
--- a/osu.Game/Updater/UpdateManager.cs
+++ b/osu.Game/Updater/UpdateManager.cs
@@ -31,7 +31,7 @@ namespace osu.Game.Updater
         private OsuGameBase game { get; set; }
 
         [Resolved]
-        protected NotificationOverlay Notifications { get; private set; }
+        protected INotificationOverlay Notifications { get; private set; }
 
         protected override void LoadComplete()
         {
@@ -94,7 +94,7 @@ namespace osu.Game.Updater
             }
 
             [BackgroundDependencyLoader]
-            private void load(OsuColour colours, ChangelogOverlay changelog, NotificationOverlay notificationOverlay)
+            private void load(OsuColour colours, ChangelogOverlay changelog, INotificationOverlay notificationOverlay)
             {
                 Icon = FontAwesome.Solid.CheckSquare;
                 IconBackground.Colour = colours.BlueDark;

From d29312e0709eb11e63effe51fb6c806966e3689d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 18 Apr 2022 21:47:47 +0900
Subject: [PATCH 4123/5547] Fix rider incompetency

---
 osu.Game/Overlays/IDialogOverlay.cs | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/IDialogOverlay.cs b/osu.Game/Overlays/IDialogOverlay.cs
index 07f28a7204..dedc164510 100644
--- a/osu.Game/Overlays/IDialogOverlay.cs
+++ b/osu.Game/Overlays/IDialogOverlay.cs
@@ -1,7 +1,8 @@
-#nullable enable
 // 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 enable
+
 using osu.Framework.Allocation;
 using osu.Game.Overlays.Dialog;
 

From aaf5577e6a035606f19e3fd249b7a4f464f35a13 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 18 Apr 2022 21:48:46 +0900
Subject: [PATCH 4124/5547] Remove unnecessary `canBeNull` specification

---
 .../Sections/Maintenance/StableDirectoryLocationDialog.cs       | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/Settings/Sections/Maintenance/StableDirectoryLocationDialog.cs b/osu.Game/Overlays/Settings/Sections/Maintenance/StableDirectoryLocationDialog.cs
index 4e81cd63b8..b16fd9a5a1 100644
--- a/osu.Game/Overlays/Settings/Sections/Maintenance/StableDirectoryLocationDialog.cs
+++ b/osu.Game/Overlays/Settings/Sections/Maintenance/StableDirectoryLocationDialog.cs
@@ -12,7 +12,7 @@ namespace osu.Game.Overlays.Settings.Sections.Maintenance
 {
     public class StableDirectoryLocationDialog : PopupDialog
     {
-        [Resolved(canBeNull: true)]
+        [Resolved]
         private IPerformFromScreenRunner performer { get; set; }
 
         public StableDirectoryLocationDialog(TaskCompletionSource<string> taskCompletionSource)

From 5d5e46ede71bd05ac9846da73eb03119f96cad7b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 18 Apr 2022 21:47:47 +0900
Subject: [PATCH 4125/5547] Fix rider incompetency

---
 osu.Game/Overlays/IDialogOverlay.cs | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/IDialogOverlay.cs b/osu.Game/Overlays/IDialogOverlay.cs
index 07f28a7204..dedc164510 100644
--- a/osu.Game/Overlays/IDialogOverlay.cs
+++ b/osu.Game/Overlays/IDialogOverlay.cs
@@ -1,7 +1,8 @@
-#nullable enable
 // 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 enable
+
 using osu.Framework.Allocation;
 using osu.Game.Overlays.Dialog;
 

From 3cbc6cd29767a7d47ba624dc1680c22f4a02cedd Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Mon, 18 Apr 2022 21:04:22 +0300
Subject: [PATCH 4126/5547] Update further tests to cache using
 `IDialogOverlay`

---
 osu.Game.Tests/Visual/Online/TestSceneChatLink.cs               | 2 +-
 osu.Game.Tests/Visual/Settings/TestSceneSettingsPanel.cs        | 2 +-
 osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs | 2 +-
 .../Visual/SongSelect/TestSceneUserTopScoreContainer.cs         | 2 +-
 4 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneChatLink.cs b/osu.Game.Tests/Visual/Online/TestSceneChatLink.cs
index d077868175..6818147da4 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneChatLink.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneChatLink.cs
@@ -49,7 +49,7 @@ namespace osu.Game.Tests.Visual.Online
             Dependencies.Cache(chatManager);
 
             Dependencies.Cache(new ChatOverlay());
-            Dependencies.Cache(dialogOverlay);
+            Dependencies.CacheAs<IDialogOverlay>(dialogOverlay);
         }
 
         [SetUp]
diff --git a/osu.Game.Tests/Visual/Settings/TestSceneSettingsPanel.cs b/osu.Game.Tests/Visual/Settings/TestSceneSettingsPanel.cs
index f9c9b2a68b..2106043544 100644
--- a/osu.Game.Tests/Visual/Settings/TestSceneSettingsPanel.cs
+++ b/osu.Game.Tests/Visual/Settings/TestSceneSettingsPanel.cs
@@ -97,7 +97,7 @@ namespace osu.Game.Tests.Visual.Settings
                 Depth = -1
             });
 
-            Dependencies.Cache(dialogOverlay);
+            Dependencies.CacheAs<IDialogOverlay>(dialogOverlay);
         }
     }
 }
diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
index 1ed6648131..3b15ee9c45 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
@@ -31,7 +31,7 @@ namespace osu.Game.Tests.Visual.SongSelect
     {
         private readonly FailableLeaderboard leaderboard;
 
-        [Cached]
+        [Cached(typeof(IDialogOverlay))]
         private readonly DialogOverlay dialogOverlay;
 
         private ScoreManager scoreManager;
diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneUserTopScoreContainer.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneUserTopScoreContainer.cs
index dd7f9951bf..c71e54e9a8 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneUserTopScoreContainer.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneUserTopScoreContainer.cs
@@ -19,7 +19,7 @@ namespace osu.Game.Tests.Visual.SongSelect
 {
     public class TestSceneUserTopScoreContainer : OsuTestScene
     {
-        [Cached]
+        [Cached(typeof(IDialogOverlay))]
         private readonly DialogOverlay dialogOverlay;
 
         public TestSceneUserTopScoreContainer()

From 16a0efc5621ba8a751f874bb8fef91218766efa2 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Mon, 18 Apr 2022 21:06:27 +0300
Subject: [PATCH 4127/5547] Cache `IDialogOverlay` as its type in interface

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

diff --git a/osu.Game/Overlays/IDialogOverlay.cs b/osu.Game/Overlays/IDialogOverlay.cs
index dedc164510..1c6a84cd64 100644
--- a/osu.Game/Overlays/IDialogOverlay.cs
+++ b/osu.Game/Overlays/IDialogOverlay.cs
@@ -11,7 +11,7 @@ namespace osu.Game.Overlays
     /// <summary>
     /// A global overlay that can show popup dialogs.
     /// </summary>
-    [Cached]
+    [Cached(typeof(IDialogOverlay))]
     public interface IDialogOverlay
     {
         /// <summary>

From 1fc28552b54400ca6e49f40ad5e40f4c88d3bd6e Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Mon, 18 Apr 2022 21:07:20 +0300
Subject: [PATCH 4128/5547] Minor reword inline comment

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

diff --git a/osu.Game/Overlays/Dialog/PopupDialog.cs b/osu.Game/Overlays/Dialog/PopupDialog.cs
index 9fd1a32e84..d08b6b7beb 100644
--- a/osu.Game/Overlays/Dialog/PopupDialog.cs
+++ b/osu.Game/Overlays/Dialog/PopupDialog.cs
@@ -216,7 +216,7 @@ namespace osu.Game.Overlays.Dialog
             };
 
             // It's important we start in a visible state so our state fires on hide, even before load.
-            // This is used by the IDialogOverlay to know when the dialog was dismissed.
+            // This is used by the dialog overlay to know when the dialog was dismissed.
             Show();
         }
 

From 9d59cd408fda8b931d77f9001ac38a31a4a91fb7 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Mon, 18 Apr 2022 22:59:49 +0300
Subject: [PATCH 4129/5547] Add concept of "initial items count" in paginated
 API requests

---
 .../Online/API/Requests/GetUserBeatmapsRequest.cs   |  4 ++--
 .../API/Requests/GetUserKudosuHistoryRequest.cs     |  4 ++--
 .../Requests/GetUserMostPlayedBeatmapsRequest.cs    |  4 ++--
 .../API/Requests/GetUserRecentActivitiesRequest.cs  |  4 ++--
 .../Online/API/Requests/GetUserScoresRequest.cs     |  4 ++--
 osu.Game/Online/API/Requests/PaginatedAPIRequest.cs | 13 ++++++++++---
 6 files changed, 20 insertions(+), 13 deletions(-)

diff --git a/osu.Game/Online/API/Requests/GetUserBeatmapsRequest.cs b/osu.Game/Online/API/Requests/GetUserBeatmapsRequest.cs
index e2c0ed4301..b7681cb71b 100644
--- a/osu.Game/Online/API/Requests/GetUserBeatmapsRequest.cs
+++ b/osu.Game/Online/API/Requests/GetUserBeatmapsRequest.cs
@@ -13,8 +13,8 @@ namespace osu.Game.Online.API.Requests
 
         private readonly BeatmapSetType type;
 
-        public GetUserBeatmapsRequest(long userId, BeatmapSetType type, int page = 0, int itemsPerPage = 6)
-            : base(page, itemsPerPage)
+        public GetUserBeatmapsRequest(long userId, BeatmapSetType type, int page, int itemsPerPage, int initialItems)
+            : base(page, itemsPerPage, initialItems)
         {
             this.userId = userId;
             this.type = type;
diff --git a/osu.Game/Online/API/Requests/GetUserKudosuHistoryRequest.cs b/osu.Game/Online/API/Requests/GetUserKudosuHistoryRequest.cs
index e90e297672..d2102d7697 100644
--- a/osu.Game/Online/API/Requests/GetUserKudosuHistoryRequest.cs
+++ b/osu.Game/Online/API/Requests/GetUserKudosuHistoryRequest.cs
@@ -10,8 +10,8 @@ namespace osu.Game.Online.API.Requests
     {
         private readonly long userId;
 
-        public GetUserKudosuHistoryRequest(long userId, int page = 0, int itemsPerPage = 5)
-            : base(page, itemsPerPage)
+        public GetUserKudosuHistoryRequest(long userId, int page, int itemsPerPage, int initialItems)
+            : base(page, itemsPerPage, initialItems)
         {
             this.userId = userId;
         }
diff --git a/osu.Game/Online/API/Requests/GetUserMostPlayedBeatmapsRequest.cs b/osu.Game/Online/API/Requests/GetUserMostPlayedBeatmapsRequest.cs
index 9f094e51c4..a9b6dd7edc 100644
--- a/osu.Game/Online/API/Requests/GetUserMostPlayedBeatmapsRequest.cs
+++ b/osu.Game/Online/API/Requests/GetUserMostPlayedBeatmapsRequest.cs
@@ -10,8 +10,8 @@ namespace osu.Game.Online.API.Requests
     {
         private readonly long userId;
 
-        public GetUserMostPlayedBeatmapsRequest(long userId, int page = 0, int itemsPerPage = 5)
-            : base(page, itemsPerPage)
+        public GetUserMostPlayedBeatmapsRequest(long userId, int page, int itemsPerPage, int initialItems)
+            : base(page, itemsPerPage, initialItems)
         {
             this.userId = userId;
         }
diff --git a/osu.Game/Online/API/Requests/GetUserRecentActivitiesRequest.cs b/osu.Game/Online/API/Requests/GetUserRecentActivitiesRequest.cs
index f2fa51bde7..60acc27182 100644
--- a/osu.Game/Online/API/Requests/GetUserRecentActivitiesRequest.cs
+++ b/osu.Game/Online/API/Requests/GetUserRecentActivitiesRequest.cs
@@ -10,8 +10,8 @@ namespace osu.Game.Online.API.Requests
     {
         private readonly long userId;
 
-        public GetUserRecentActivitiesRequest(long userId, int page = 0, int itemsPerPage = 5)
-            : base(page, itemsPerPage)
+        public GetUserRecentActivitiesRequest(long userId, int page, int itemsPerPage, int initialItems)
+            : base(page, itemsPerPage, initialItems)
         {
             this.userId = userId;
         }
diff --git a/osu.Game/Online/API/Requests/GetUserScoresRequest.cs b/osu.Game/Online/API/Requests/GetUserScoresRequest.cs
index 5d39799f6b..85b58fc596 100644
--- a/osu.Game/Online/API/Requests/GetUserScoresRequest.cs
+++ b/osu.Game/Online/API/Requests/GetUserScoresRequest.cs
@@ -14,8 +14,8 @@ namespace osu.Game.Online.API.Requests
         private readonly ScoreType type;
         private readonly RulesetInfo ruleset;
 
-        public GetUserScoresRequest(long userId, ScoreType type, int page = 0, int itemsPerPage = 5, RulesetInfo ruleset = null)
-            : base(page, itemsPerPage)
+        public GetUserScoresRequest(long userId, ScoreType type, int page, int itemsPerPage, int initialItems, RulesetInfo ruleset = null)
+            : base(page, itemsPerPage, initialItems)
         {
             this.userId = userId;
             this.type = type;
diff --git a/osu.Game/Online/API/Requests/PaginatedAPIRequest.cs b/osu.Game/Online/API/Requests/PaginatedAPIRequest.cs
index bddc34a0dc..ea59fcfc25 100644
--- a/osu.Game/Online/API/Requests/PaginatedAPIRequest.cs
+++ b/osu.Game/Online/API/Requests/PaginatedAPIRequest.cs
@@ -9,11 +9,13 @@ namespace osu.Game.Online.API.Requests
     public abstract class PaginatedAPIRequest<T> : APIRequest<T> where T : class
     {
         private readonly int page;
+        private readonly int initialItems;
         private readonly int itemsPerPage;
 
-        protected PaginatedAPIRequest(int page, int itemsPerPage)
+        protected PaginatedAPIRequest(int page, int itemsPerPage, int initialItems)
         {
             this.page = page;
+            this.initialItems = initialItems;
             this.itemsPerPage = itemsPerPage;
         }
 
@@ -21,8 +23,13 @@ namespace osu.Game.Online.API.Requests
         {
             var req = base.CreateWebRequest();
 
-            req.AddParameter("offset", (page * itemsPerPage).ToString(CultureInfo.InvariantCulture));
-            req.AddParameter("limit", itemsPerPage.ToString(CultureInfo.InvariantCulture));
+            if (page == 0)
+                req.AddParameter("limit", initialItems.ToString(CultureInfo.InvariantCulture));
+            else
+            {
+                req.AddParameter("offset", (initialItems + (page - 1) * itemsPerPage).ToString(CultureInfo.InvariantCulture));
+                req.AddParameter("limit", itemsPerPage.ToString(CultureInfo.InvariantCulture));
+            }
 
             return req;
         }

From f08449e432d11625ec3b3fa3ad5d95df1ef091c8 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Mon, 18 Apr 2022 23:04:21 +0300
Subject: [PATCH 4130/5547] Update paginated profile subsections to display
 items inline with web

---
 .../Beatmaps/PaginatedBeatmapContainer.cs     |  7 ++++---
 .../PaginatedMostPlayedBeatmapContainer.cs    |  5 ++---
 .../Kudosu/PaginatedKudosuHistoryContainer.cs |  5 ++---
 .../Sections/PaginatedProfileSubsection.cs    | 19 +++++++++++++++----
 .../Sections/Ranks/PaginatedScoreContainer.cs |  6 ++----
 .../PaginatedRecentActivityContainer.cs       |  5 ++---
 6 files changed, 27 insertions(+), 20 deletions(-)

diff --git a/osu.Game/Overlays/Profile/Sections/Beatmaps/PaginatedBeatmapContainer.cs b/osu.Game/Overlays/Profile/Sections/Beatmaps/PaginatedBeatmapContainer.cs
index d39074bd49..deeb63b5bf 100644
--- a/osu.Game/Overlays/Profile/Sections/Beatmaps/PaginatedBeatmapContainer.cs
+++ b/osu.Game/Overlays/Profile/Sections/Beatmaps/PaginatedBeatmapContainer.cs
@@ -20,11 +20,12 @@ namespace osu.Game.Overlays.Profile.Sections.Beatmaps
         private const float panel_padding = 10f;
         private readonly BeatmapSetType type;
 
+        protected override int InitialItemsCount => type == BeatmapSetType.Graveyard ? 2 : 6;
+
         public PaginatedBeatmapContainer(BeatmapSetType type, Bindable<APIUser> user, LocalisableString headerText)
             : base(user, headerText)
         {
             this.type = type;
-            ItemsPerPage = 6;
         }
 
         [BackgroundDependencyLoader]
@@ -57,8 +58,8 @@ namespace osu.Game.Overlays.Profile.Sections.Beatmaps
             }
         }
 
-        protected override APIRequest<List<APIBeatmapSet>> CreateRequest() =>
-            new GetUserBeatmapsRequest(User.Value.Id, type, VisiblePages++, ItemsPerPage);
+        protected override APIRequest<List<APIBeatmapSet>> CreateRequest(int itemsPerPage, int initialItems) =>
+            new GetUserBeatmapsRequest(User.Value.Id, type, VisiblePages++, itemsPerPage, initialItems);
 
         protected override Drawable CreateDrawableItem(APIBeatmapSet model) => model.OnlineID > 0
             ? new BeatmapCardNormal(model)
diff --git a/osu.Game/Overlays/Profile/Sections/Historical/PaginatedMostPlayedBeatmapContainer.cs b/osu.Game/Overlays/Profile/Sections/Historical/PaginatedMostPlayedBeatmapContainer.cs
index ad1192a13a..ccd60fcd89 100644
--- a/osu.Game/Overlays/Profile/Sections/Historical/PaginatedMostPlayedBeatmapContainer.cs
+++ b/osu.Game/Overlays/Profile/Sections/Historical/PaginatedMostPlayedBeatmapContainer.cs
@@ -19,7 +19,6 @@ namespace osu.Game.Overlays.Profile.Sections.Historical
         public PaginatedMostPlayedBeatmapContainer(Bindable<APIUser> user)
             : base(user, UsersStrings.ShowExtraHistoricalMostPlayedTitle)
         {
-            ItemsPerPage = 5;
         }
 
         [BackgroundDependencyLoader]
@@ -30,8 +29,8 @@ namespace osu.Game.Overlays.Profile.Sections.Historical
 
         protected override int GetCount(APIUser user) => user.BeatmapPlayCountsCount;
 
-        protected override APIRequest<List<APIUserMostPlayedBeatmap>> CreateRequest() =>
-            new GetUserMostPlayedBeatmapsRequest(User.Value.Id, VisiblePages++, ItemsPerPage);
+        protected override APIRequest<List<APIUserMostPlayedBeatmap>> CreateRequest(int itemsPerPage, int initialItems) =>
+            new GetUserMostPlayedBeatmapsRequest(User.Value.Id, VisiblePages++, itemsPerPage, initialItems);
 
         protected override Drawable CreateDrawableItem(APIUserMostPlayedBeatmap mostPlayed) =>
             new DrawableMostPlayedBeatmap(mostPlayed);
diff --git a/osu.Game/Overlays/Profile/Sections/Kudosu/PaginatedKudosuHistoryContainer.cs b/osu.Game/Overlays/Profile/Sections/Kudosu/PaginatedKudosuHistoryContainer.cs
index c4837cc0e2..311a64a10d 100644
--- a/osu.Game/Overlays/Profile/Sections/Kudosu/PaginatedKudosuHistoryContainer.cs
+++ b/osu.Game/Overlays/Profile/Sections/Kudosu/PaginatedKudosuHistoryContainer.cs
@@ -17,11 +17,10 @@ namespace osu.Game.Overlays.Profile.Sections.Kudosu
         public PaginatedKudosuHistoryContainer(Bindable<APIUser> user)
             : base(user, missingText: UsersStrings.ShowExtraKudosuEntryEmpty)
         {
-            ItemsPerPage = 5;
         }
 
-        protected override APIRequest<List<APIKudosuHistory>> CreateRequest()
-            => new GetUserKudosuHistoryRequest(User.Value.Id, VisiblePages++, ItemsPerPage);
+        protected override APIRequest<List<APIKudosuHistory>> CreateRequest(int itemsPerPage, int initialItems)
+            => new GetUserKudosuHistoryRequest(User.Value.Id, VisiblePages++, itemsPerPage, initialItems);
 
         protected override Drawable CreateDrawableItem(APIKudosuHistory item) => new DrawableKudosuHistoryItem(item);
     }
diff --git a/osu.Game/Overlays/Profile/Sections/PaginatedProfileSubsection.cs b/osu.Game/Overlays/Profile/Sections/PaginatedProfileSubsection.cs
index 9dcbf6142d..646c16fbd7 100644
--- a/osu.Game/Overlays/Profile/Sections/PaginatedProfileSubsection.cs
+++ b/osu.Game/Overlays/Profile/Sections/PaginatedProfileSubsection.cs
@@ -21,11 +21,20 @@ namespace osu.Game.Overlays.Profile.Sections
 {
     public abstract class PaginatedProfileSubsection<TModel> : ProfileSubsection
     {
+        /// <summary>
+        /// The number of items displayed per page.
+        /// </summary>
+        protected virtual int ItemsPerPage => 50;
+
+        /// <summary>
+        /// The number of items displayed initially.
+        /// </summary>
+        protected virtual int InitialItemsCount => 5;
+
         [Resolved]
         private IAPIProvider api { get; set; }
 
         protected int VisiblePages;
-        protected int ItemsPerPage;
 
         protected ReverseChildIDFillFlowContainer<Drawable> ItemsContainer { get; private set; }
 
@@ -101,7 +110,7 @@ namespace osu.Game.Overlays.Profile.Sections
         {
             loadCancellation = new CancellationTokenSource();
 
-            retrievalRequest = CreateRequest();
+            retrievalRequest = CreateRequest(ItemsPerPage, InitialItemsCount);
             retrievalRequest.Success += UpdateItems;
 
             api.Queue(retrievalRequest);
@@ -125,7 +134,9 @@ namespace osu.Game.Overlays.Profile.Sections
             LoadComponentsAsync(items.Select(CreateDrawableItem).Where(d => d != null), drawables =>
             {
                 missing.Hide();
-                moreButton.FadeTo(items.Count == ItemsPerPage ? 1 : 0);
+
+                int maxCount = VisiblePages == 1 ? InitialItemsCount : ItemsPerPage;
+                moreButton.FadeTo(items.Count == maxCount ? 1 : 0);
                 moreButton.IsLoading = false;
 
                 ItemsContainer.AddRange(drawables);
@@ -138,7 +149,7 @@ namespace osu.Game.Overlays.Profile.Sections
         {
         }
 
-        protected abstract APIRequest<List<TModel>> CreateRequest();
+        protected abstract APIRequest<List<TModel>> CreateRequest(int itemsPerPage, int initialItems);
 
         protected abstract Drawable CreateDrawableItem(TModel model);
 
diff --git a/osu.Game/Overlays/Profile/Sections/Ranks/PaginatedScoreContainer.cs b/osu.Game/Overlays/Profile/Sections/Ranks/PaginatedScoreContainer.cs
index 5c67da1911..cc5952017d 100644
--- a/osu.Game/Overlays/Profile/Sections/Ranks/PaginatedScoreContainer.cs
+++ b/osu.Game/Overlays/Profile/Sections/Ranks/PaginatedScoreContainer.cs
@@ -23,8 +23,6 @@ namespace osu.Game.Overlays.Profile.Sections.Ranks
             : base(user, headerText)
         {
             this.type = type;
-
-            ItemsPerPage = 5;
         }
 
         [BackgroundDependencyLoader]
@@ -62,8 +60,8 @@ namespace osu.Game.Overlays.Profile.Sections.Ranks
             base.OnItemsReceived(items);
         }
 
-        protected override APIRequest<List<APIScore>> CreateRequest() =>
-            new GetUserScoresRequest(User.Value.Id, type, VisiblePages++, ItemsPerPage);
+        protected override APIRequest<List<APIScore>> CreateRequest(int itemsPerPage, int initialItems) =>
+            new GetUserScoresRequest(User.Value.Id, type, VisiblePages++, itemsPerPage, initialItems);
 
         private int drawableItemIndex;
 
diff --git a/osu.Game/Overlays/Profile/Sections/Recent/PaginatedRecentActivityContainer.cs b/osu.Game/Overlays/Profile/Sections/Recent/PaginatedRecentActivityContainer.cs
index c5ff896654..60cba95fda 100644
--- a/osu.Game/Overlays/Profile/Sections/Recent/PaginatedRecentActivityContainer.cs
+++ b/osu.Game/Overlays/Profile/Sections/Recent/PaginatedRecentActivityContainer.cs
@@ -19,7 +19,6 @@ namespace osu.Game.Overlays.Profile.Sections.Recent
         public PaginatedRecentActivityContainer(Bindable<APIUser> user)
             : base(user, missingText: EventsStrings.Empty)
         {
-            ItemsPerPage = 10;
         }
 
         [BackgroundDependencyLoader]
@@ -28,8 +27,8 @@ namespace osu.Game.Overlays.Profile.Sections.Recent
             ItemsContainer.Spacing = new Vector2(0, 8);
         }
 
-        protected override APIRequest<List<APIRecentActivity>> CreateRequest() =>
-            new GetUserRecentActivitiesRequest(User.Value.Id, VisiblePages++, ItemsPerPage);
+        protected override APIRequest<List<APIRecentActivity>> CreateRequest(int itemsPerPage, int initialItems) =>
+            new GetUserRecentActivitiesRequest(User.Value.Id, VisiblePages++, itemsPerPage, initialItems);
 
         protected override Drawable CreateDrawableItem(APIRecentActivity model) => new DrawableRecentActivity(model);
     }

From c4d89b8c3c446d6440b023c2fb5508da4c99add6 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 19 Apr 2022 05:57:03 +0900
Subject: [PATCH 4131/5547] Update framework

---
 osu.Android.props        | 2 +-
 osu.Game/osu.Game.csproj | 2 +-
 osu.iOS.props            | 4 ++--
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Android.props b/osu.Android.props
index a8952df329..8b22df418f 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -52,7 +52,7 @@
   </ItemGroup>
   <ItemGroup>
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.417.0" />
-    <PackageReference Include="ppy.osu.Framework.Android" Version="2022.415.0" />
+    <PackageReference Include="ppy.osu.Framework.Android" Version="2022.419.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
     <!-- Realm needs to be directly referenced in all Xamarin projects, as it will not pull in its transitive dependencies otherwise. -->
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 3246255815..0a102510e7 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="10.10.0" />
-    <PackageReference Include="ppy.osu.Framework" Version="2022.415.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2022.419.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.417.0" />
     <PackageReference Include="Sentry" Version="3.14.1" />
     <PackageReference Include="SharpCompress" Version="0.30.1" />
diff --git a/osu.iOS.props b/osu.iOS.props
index 668d23f82e..2f0facea18 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -61,7 +61,7 @@
     <Reference Include="System.Net.Http" />
   </ItemGroup>
   <ItemGroup Label="Package References">
-    <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.415.0" />
+    <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.419.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.417.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net6.0) -->
@@ -84,7 +84,7 @@
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="5.0.14" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.Core" Version="5.0.14" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
-    <PackageReference Include="ppy.osu.Framework" Version="2022.415.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2022.419.0" />
     <PackageReference Include="SharpCompress" Version="0.30.1" />
     <PackageReference Include="NUnit" Version="3.13.2" />
     <PackageReference Include="System.ComponentModel.Annotations" Version="5.0.0" />

From 94335c293848a5475aa0df3f8c71f6726a544ec8 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Tue, 19 Apr 2022 00:18:10 +0300
Subject: [PATCH 4132/5547] Update further usages to cache/resolve via
 interface

---
 osu.Desktop/Updater/SquirrelUpdateManager.cs                | 4 ++--
 osu.Game.Tests/Visual/Gameplay/TestScenePlayerLoader.cs     | 2 +-
 osu.Game.Tests/Visual/Settings/TestSceneMigrationScreens.cs | 2 +-
 osu.Game/Screens/Play/PlayerLoader.cs                       | 2 +-
 4 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/osu.Desktop/Updater/SquirrelUpdateManager.cs b/osu.Desktop/Updater/SquirrelUpdateManager.cs
index bae850fce1..c09cce1235 100644
--- a/osu.Desktop/Updater/SquirrelUpdateManager.cs
+++ b/osu.Desktop/Updater/SquirrelUpdateManager.cs
@@ -39,9 +39,9 @@ namespace osu.Desktop.Updater
         private readonly SquirrelLogger squirrelLogger = new SquirrelLogger();
 
         [BackgroundDependencyLoader]
-        private void load(NotificationOverlay notification)
+        private void load(INotificationOverlay notifications)
         {
-            notificationOverlay = notification;
+            notificationOverlay = notifications;
 
             SquirrelLocator.CurrentMutable.Register(() => squirrelLogger, typeof(ILogger));
         }
diff --git a/osu.Game.Tests/Visual/Gameplay/TestScenePlayerLoader.cs b/osu.Game.Tests/Visual/Gameplay/TestScenePlayerLoader.cs
index 958d617d63..950c755cc1 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestScenePlayerLoader.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestScenePlayerLoader.cs
@@ -43,7 +43,7 @@ namespace osu.Game.Tests.Visual.Gameplay
         [Resolved]
         private SessionStatics sessionStatics { get; set; }
 
-        [Cached]
+        [Cached(typeof(INotificationOverlay))]
         private readonly NotificationOverlay notificationOverlay;
 
         [Cached]
diff --git a/osu.Game.Tests/Visual/Settings/TestSceneMigrationScreens.cs b/osu.Game.Tests/Visual/Settings/TestSceneMigrationScreens.cs
index a68090504d..ac0956502e 100644
--- a/osu.Game.Tests/Visual/Settings/TestSceneMigrationScreens.cs
+++ b/osu.Game.Tests/Visual/Settings/TestSceneMigrationScreens.cs
@@ -14,7 +14,7 @@ namespace osu.Game.Tests.Visual.Settings
 {
     public class TestSceneMigrationScreens : ScreenTestScene
     {
-        [Cached]
+        [Cached(typeof(INotificationOverlay))]
         private readonly NotificationOverlay notifications;
 
         public TestSceneMigrationScreens()
diff --git a/osu.Game/Screens/Play/PlayerLoader.cs b/osu.Game/Screens/Play/PlayerLoader.cs
index b72ec373d7..aea39bc8ff 100644
--- a/osu.Game/Screens/Play/PlayerLoader.cs
+++ b/osu.Game/Screens/Play/PlayerLoader.cs
@@ -124,7 +124,7 @@ namespace osu.Game.Screens.Play
         private EpilepsyWarning? epilepsyWarning;
 
         [Resolved(CanBeNull = true)]
-        private NotificationOverlay? notificationOverlay { get; set; }
+        private INotificationOverlay? notificationOverlay { get; set; }
 
         [Resolved(CanBeNull = true)]
         private VolumeOverlay? volumeOverlay { get; set; }

From 96d4369cc823d71370f1c2fa9f8faaecba66f828 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Tue, 19 Apr 2022 02:04:23 +0300
Subject: [PATCH 4133/5547] Introduce `Pagination` and simplify paginated API
 requests

---
 .../API/Requests/GetUserBeatmapsRequest.cs    |  4 +-
 .../Requests/GetUserKudosuHistoryRequest.cs   |  4 +-
 .../GetUserMostPlayedBeatmapsRequest.cs       |  4 +-
 .../GetUserRecentActivitiesRequest.cs         |  4 +-
 .../API/Requests/GetUserScoresRequest.cs      |  4 +-
 .../API/Requests/PaginatedAPIRequest.cs       | 19 +++-------
 osu.Game/Online/API/Requests/Pagination.cs    | 38 +++++++++++++++++++
 .../Beatmaps/PaginatedBeatmapContainer.cs     |  4 +-
 .../PaginatedMostPlayedBeatmapContainer.cs    |  4 +-
 .../Kudosu/PaginatedKudosuHistoryContainer.cs |  4 +-
 .../Sections/PaginatedProfileSubsection.cs    | 16 ++++----
 .../Sections/Ranks/PaginatedScoreContainer.cs |  6 +--
 .../PaginatedRecentActivityContainer.cs       |  4 +-
 13 files changed, 73 insertions(+), 42 deletions(-)
 create mode 100644 osu.Game/Online/API/Requests/Pagination.cs

diff --git a/osu.Game/Online/API/Requests/GetUserBeatmapsRequest.cs b/osu.Game/Online/API/Requests/GetUserBeatmapsRequest.cs
index b7681cb71b..019c805c9a 100644
--- a/osu.Game/Online/API/Requests/GetUserBeatmapsRequest.cs
+++ b/osu.Game/Online/API/Requests/GetUserBeatmapsRequest.cs
@@ -13,8 +13,8 @@ namespace osu.Game.Online.API.Requests
 
         private readonly BeatmapSetType type;
 
-        public GetUserBeatmapsRequest(long userId, BeatmapSetType type, int page, int itemsPerPage, int initialItems)
-            : base(page, itemsPerPage, initialItems)
+        public GetUserBeatmapsRequest(long userId, BeatmapSetType type, Pagination pagination)
+            : base(pagination)
         {
             this.userId = userId;
             this.type = type;
diff --git a/osu.Game/Online/API/Requests/GetUserKudosuHistoryRequest.cs b/osu.Game/Online/API/Requests/GetUserKudosuHistoryRequest.cs
index d2102d7697..3759c59722 100644
--- a/osu.Game/Online/API/Requests/GetUserKudosuHistoryRequest.cs
+++ b/osu.Game/Online/API/Requests/GetUserKudosuHistoryRequest.cs
@@ -10,8 +10,8 @@ namespace osu.Game.Online.API.Requests
     {
         private readonly long userId;
 
-        public GetUserKudosuHistoryRequest(long userId, int page, int itemsPerPage, int initialItems)
-            : base(page, itemsPerPage, initialItems)
+        public GetUserKudosuHistoryRequest(long userId, Pagination pagination)
+            : base(pagination)
         {
             this.userId = userId;
         }
diff --git a/osu.Game/Online/API/Requests/GetUserMostPlayedBeatmapsRequest.cs b/osu.Game/Online/API/Requests/GetUserMostPlayedBeatmapsRequest.cs
index a9b6dd7edc..37359e2cd0 100644
--- a/osu.Game/Online/API/Requests/GetUserMostPlayedBeatmapsRequest.cs
+++ b/osu.Game/Online/API/Requests/GetUserMostPlayedBeatmapsRequest.cs
@@ -10,8 +10,8 @@ namespace osu.Game.Online.API.Requests
     {
         private readonly long userId;
 
-        public GetUserMostPlayedBeatmapsRequest(long userId, int page, int itemsPerPage, int initialItems)
-            : base(page, itemsPerPage, initialItems)
+        public GetUserMostPlayedBeatmapsRequest(long userId, Pagination pagination)
+            : base(pagination)
         {
             this.userId = userId;
         }
diff --git a/osu.Game/Online/API/Requests/GetUserRecentActivitiesRequest.cs b/osu.Game/Online/API/Requests/GetUserRecentActivitiesRequest.cs
index 60acc27182..c16633c17a 100644
--- a/osu.Game/Online/API/Requests/GetUserRecentActivitiesRequest.cs
+++ b/osu.Game/Online/API/Requests/GetUserRecentActivitiesRequest.cs
@@ -10,8 +10,8 @@ namespace osu.Game.Online.API.Requests
     {
         private readonly long userId;
 
-        public GetUserRecentActivitiesRequest(long userId, int page, int itemsPerPage, int initialItems)
-            : base(page, itemsPerPage, initialItems)
+        public GetUserRecentActivitiesRequest(long userId, Pagination pagination)
+            : base(pagination)
         {
             this.userId = userId;
         }
diff --git a/osu.Game/Online/API/Requests/GetUserScoresRequest.cs b/osu.Game/Online/API/Requests/GetUserScoresRequest.cs
index 85b58fc596..af01969a1a 100644
--- a/osu.Game/Online/API/Requests/GetUserScoresRequest.cs
+++ b/osu.Game/Online/API/Requests/GetUserScoresRequest.cs
@@ -14,8 +14,8 @@ namespace osu.Game.Online.API.Requests
         private readonly ScoreType type;
         private readonly RulesetInfo ruleset;
 
-        public GetUserScoresRequest(long userId, ScoreType type, int page, int itemsPerPage, int initialItems, RulesetInfo ruleset = null)
-            : base(page, itemsPerPage, initialItems)
+        public GetUserScoresRequest(long userId, ScoreType type, Pagination pagination, RulesetInfo ruleset = null)
+            : base(pagination)
         {
             this.userId = userId;
             this.type = type;
diff --git a/osu.Game/Online/API/Requests/PaginatedAPIRequest.cs b/osu.Game/Online/API/Requests/PaginatedAPIRequest.cs
index ea59fcfc25..ddc453bf17 100644
--- a/osu.Game/Online/API/Requests/PaginatedAPIRequest.cs
+++ b/osu.Game/Online/API/Requests/PaginatedAPIRequest.cs
@@ -8,28 +8,19 @@ namespace osu.Game.Online.API.Requests
 {
     public abstract class PaginatedAPIRequest<T> : APIRequest<T> where T : class
     {
-        private readonly int page;
-        private readonly int initialItems;
-        private readonly int itemsPerPage;
+        private readonly Pagination pagination;
 
-        protected PaginatedAPIRequest(int page, int itemsPerPage, int initialItems)
+        protected PaginatedAPIRequest(Pagination pagination)
         {
-            this.page = page;
-            this.initialItems = initialItems;
-            this.itemsPerPage = itemsPerPage;
+            this.pagination = pagination;
         }
 
         protected override WebRequest CreateWebRequest()
         {
             var req = base.CreateWebRequest();
 
-            if (page == 0)
-                req.AddParameter("limit", initialItems.ToString(CultureInfo.InvariantCulture));
-            else
-            {
-                req.AddParameter("offset", (initialItems + (page - 1) * itemsPerPage).ToString(CultureInfo.InvariantCulture));
-                req.AddParameter("limit", itemsPerPage.ToString(CultureInfo.InvariantCulture));
-            }
+            req.AddParameter("offset", pagination.Offset.ToString(CultureInfo.InvariantCulture));
+            req.AddParameter("limit", pagination.Limit.ToString(CultureInfo.InvariantCulture));
 
             return req;
         }
diff --git a/osu.Game/Online/API/Requests/Pagination.cs b/osu.Game/Online/API/Requests/Pagination.cs
new file mode 100644
index 0000000000..a1caac7592
--- /dev/null
+++ b/osu.Game/Online/API/Requests/Pagination.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.
+
+namespace osu.Game.Online.API.Requests
+{
+    /// <summary>
+    /// Represents a pagination data used for <see cref="PaginatedAPIRequest{T}"/>.
+    /// </summary>
+    public readonly struct Pagination
+    {
+        /// <summary>
+        /// The starting point of the request.
+        /// </summary>
+        public int Offset { get; }
+
+        /// <summary>
+        /// The maximum number of items to return in this request.
+        /// </summary>
+        public int Limit { get; }
+
+        public Pagination(int offset, int limit)
+        {
+            Offset = offset;
+            Limit = limit;
+        }
+
+        public Pagination(int limit)
+            : this(0, limit)
+        {
+        }
+
+        /// <summary>
+        /// Returns a <see cref="Pagination"/> of the next number of items defined by <paramref name="limit"/> after this.
+        /// </summary>
+        /// <param name="limit">The limit of the next pagination.</param>
+        public Pagination TakeNext(int limit) => new Pagination(Offset + Limit, limit);
+    }
+}
diff --git a/osu.Game/Overlays/Profile/Sections/Beatmaps/PaginatedBeatmapContainer.cs b/osu.Game/Overlays/Profile/Sections/Beatmaps/PaginatedBeatmapContainer.cs
index deeb63b5bf..f1c2b4bf7a 100644
--- a/osu.Game/Overlays/Profile/Sections/Beatmaps/PaginatedBeatmapContainer.cs
+++ b/osu.Game/Overlays/Profile/Sections/Beatmaps/PaginatedBeatmapContainer.cs
@@ -58,8 +58,8 @@ namespace osu.Game.Overlays.Profile.Sections.Beatmaps
             }
         }
 
-        protected override APIRequest<List<APIBeatmapSet>> CreateRequest(int itemsPerPage, int initialItems) =>
-            new GetUserBeatmapsRequest(User.Value.Id, type, VisiblePages++, itemsPerPage, initialItems);
+        protected override APIRequest<List<APIBeatmapSet>> CreateRequest(Pagination pagination) =>
+            new GetUserBeatmapsRequest(User.Value.Id, type, pagination);
 
         protected override Drawable CreateDrawableItem(APIBeatmapSet model) => model.OnlineID > 0
             ? new BeatmapCardNormal(model)
diff --git a/osu.Game/Overlays/Profile/Sections/Historical/PaginatedMostPlayedBeatmapContainer.cs b/osu.Game/Overlays/Profile/Sections/Historical/PaginatedMostPlayedBeatmapContainer.cs
index ccd60fcd89..281bcc3a03 100644
--- a/osu.Game/Overlays/Profile/Sections/Historical/PaginatedMostPlayedBeatmapContainer.cs
+++ b/osu.Game/Overlays/Profile/Sections/Historical/PaginatedMostPlayedBeatmapContainer.cs
@@ -29,8 +29,8 @@ namespace osu.Game.Overlays.Profile.Sections.Historical
 
         protected override int GetCount(APIUser user) => user.BeatmapPlayCountsCount;
 
-        protected override APIRequest<List<APIUserMostPlayedBeatmap>> CreateRequest(int itemsPerPage, int initialItems) =>
-            new GetUserMostPlayedBeatmapsRequest(User.Value.Id, VisiblePages++, itemsPerPage, initialItems);
+        protected override APIRequest<List<APIUserMostPlayedBeatmap>> CreateRequest(Pagination pagination) =>
+            new GetUserMostPlayedBeatmapsRequest(User.Value.Id, pagination);
 
         protected override Drawable CreateDrawableItem(APIUserMostPlayedBeatmap mostPlayed) =>
             new DrawableMostPlayedBeatmap(mostPlayed);
diff --git a/osu.Game/Overlays/Profile/Sections/Kudosu/PaginatedKudosuHistoryContainer.cs b/osu.Game/Overlays/Profile/Sections/Kudosu/PaginatedKudosuHistoryContainer.cs
index 311a64a10d..5aada2b655 100644
--- a/osu.Game/Overlays/Profile/Sections/Kudosu/PaginatedKudosuHistoryContainer.cs
+++ b/osu.Game/Overlays/Profile/Sections/Kudosu/PaginatedKudosuHistoryContainer.cs
@@ -19,8 +19,8 @@ namespace osu.Game.Overlays.Profile.Sections.Kudosu
         {
         }
 
-        protected override APIRequest<List<APIKudosuHistory>> CreateRequest(int itemsPerPage, int initialItems)
-            => new GetUserKudosuHistoryRequest(User.Value.Id, VisiblePages++, itemsPerPage, initialItems);
+        protected override APIRequest<List<APIKudosuHistory>> CreateRequest(Pagination pagination)
+            => new GetUserKudosuHistoryRequest(User.Value.Id, pagination);
 
         protected override Drawable CreateDrawableItem(APIKudosuHistory item) => new DrawableKudosuHistoryItem(item);
     }
diff --git a/osu.Game/Overlays/Profile/Sections/PaginatedProfileSubsection.cs b/osu.Game/Overlays/Profile/Sections/PaginatedProfileSubsection.cs
index 646c16fbd7..a1f9e7546a 100644
--- a/osu.Game/Overlays/Profile/Sections/PaginatedProfileSubsection.cs
+++ b/osu.Game/Overlays/Profile/Sections/PaginatedProfileSubsection.cs
@@ -14,6 +14,7 @@ using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Online.API;
 using osu.Game.Graphics.Containers;
+using osu.Game.Online.API.Requests;
 using osu.Game.Online.API.Requests.Responses;
 using osuTK;
 
@@ -34,7 +35,7 @@ namespace osu.Game.Overlays.Profile.Sections
         [Resolved]
         private IAPIProvider api { get; set; }
 
-        protected int VisiblePages;
+        protected Pagination? CurrentPage { get; private set; }
 
         protected ReverseChildIDFillFlowContainer<Drawable> ItemsContainer { get; private set; }
 
@@ -96,7 +97,7 @@ namespace osu.Game.Overlays.Profile.Sections
             loadCancellation?.Cancel();
             retrievalRequest?.Cancel();
 
-            VisiblePages = 0;
+            CurrentPage = null;
             ItemsContainer.Clear();
 
             if (e.NewValue != null)
@@ -110,7 +111,9 @@ namespace osu.Game.Overlays.Profile.Sections
         {
             loadCancellation = new CancellationTokenSource();
 
-            retrievalRequest = CreateRequest(ItemsPerPage, InitialItemsCount);
+            CurrentPage = CurrentPage?.TakeNext(ItemsPerPage) ?? new Pagination(InitialItemsCount);
+
+            retrievalRequest = CreateRequest(CurrentPage.Value);
             retrievalRequest.Success += UpdateItems;
 
             api.Queue(retrievalRequest);
@@ -120,7 +123,7 @@ namespace osu.Game.Overlays.Profile.Sections
         {
             OnItemsReceived(items);
 
-            if (!items.Any() && VisiblePages == 1)
+            if (!items.Any() && CurrentPage?.Offset == 0)
             {
                 moreButton.Hide();
                 moreButton.IsLoading = false;
@@ -135,8 +138,7 @@ namespace osu.Game.Overlays.Profile.Sections
             {
                 missing.Hide();
 
-                int maxCount = VisiblePages == 1 ? InitialItemsCount : ItemsPerPage;
-                moreButton.FadeTo(items.Count == maxCount ? 1 : 0);
+                moreButton.FadeTo(items.Count == CurrentPage?.Limit ? 1 : 0);
                 moreButton.IsLoading = false;
 
                 ItemsContainer.AddRange(drawables);
@@ -149,7 +151,7 @@ namespace osu.Game.Overlays.Profile.Sections
         {
         }
 
-        protected abstract APIRequest<List<TModel>> CreateRequest(int itemsPerPage, int initialItems);
+        protected abstract APIRequest<List<TModel>> CreateRequest(Pagination pagination);
 
         protected abstract Drawable CreateDrawableItem(TModel model);
 
diff --git a/osu.Game/Overlays/Profile/Sections/Ranks/PaginatedScoreContainer.cs b/osu.Game/Overlays/Profile/Sections/Ranks/PaginatedScoreContainer.cs
index cc5952017d..c3a5e3f8b8 100644
--- a/osu.Game/Overlays/Profile/Sections/Ranks/PaginatedScoreContainer.cs
+++ b/osu.Game/Overlays/Profile/Sections/Ranks/PaginatedScoreContainer.cs
@@ -54,14 +54,14 @@ namespace osu.Game.Overlays.Profile.Sections.Ranks
 
         protected override void OnItemsReceived(List<APIScore> items)
         {
-            if (VisiblePages == 0)
+            if (CurrentPage == null || CurrentPage?.Offset == 0)
                 drawableItemIndex = 0;
 
             base.OnItemsReceived(items);
         }
 
-        protected override APIRequest<List<APIScore>> CreateRequest(int itemsPerPage, int initialItems) =>
-            new GetUserScoresRequest(User.Value.Id, type, VisiblePages++, itemsPerPage, initialItems);
+        protected override APIRequest<List<APIScore>> CreateRequest(Pagination pagination) =>
+            new GetUserScoresRequest(User.Value.Id, type, pagination);
 
         private int drawableItemIndex;
 
diff --git a/osu.Game/Overlays/Profile/Sections/Recent/PaginatedRecentActivityContainer.cs b/osu.Game/Overlays/Profile/Sections/Recent/PaginatedRecentActivityContainer.cs
index 60cba95fda..e5118094ce 100644
--- a/osu.Game/Overlays/Profile/Sections/Recent/PaginatedRecentActivityContainer.cs
+++ b/osu.Game/Overlays/Profile/Sections/Recent/PaginatedRecentActivityContainer.cs
@@ -27,8 +27,8 @@ namespace osu.Game.Overlays.Profile.Sections.Recent
             ItemsContainer.Spacing = new Vector2(0, 8);
         }
 
-        protected override APIRequest<List<APIRecentActivity>> CreateRequest(int itemsPerPage, int initialItems) =>
-            new GetUserRecentActivitiesRequest(User.Value.Id, VisiblePages++, itemsPerPage, initialItems);
+        protected override APIRequest<List<APIRecentActivity>> CreateRequest(Pagination pagination) =>
+            new GetUserRecentActivitiesRequest(User.Value.Id, pagination);
 
         protected override Drawable CreateDrawableItem(APIRecentActivity model) => new DrawableRecentActivity(model);
     }

From c858ec24833b2020a434180d9f63a8a472ec7173 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Tue, 19 Apr 2022 02:48:34 +0300
Subject: [PATCH 4134/5547] `Pagination` -> `PaginationParameters

---
 osu.Game/Online/API/Requests/GetUserBeatmapsRequest.cs |  2 +-
 .../Online/API/Requests/GetUserKudosuHistoryRequest.cs |  2 +-
 .../API/Requests/GetUserMostPlayedBeatmapsRequest.cs   |  2 +-
 .../API/Requests/GetUserRecentActivitiesRequest.cs     |  2 +-
 osu.Game/Online/API/Requests/GetUserScoresRequest.cs   |  2 +-
 osu.Game/Online/API/Requests/PaginatedAPIRequest.cs    |  4 ++--
 .../{Pagination.cs => PaginationParameters.cs}         | 10 +++++-----
 .../Sections/Beatmaps/PaginatedBeatmapContainer.cs     |  2 +-
 .../Historical/PaginatedMostPlayedBeatmapContainer.cs  |  2 +-
 .../Sections/Kudosu/PaginatedKudosuHistoryContainer.cs |  2 +-
 .../Profile/Sections/PaginatedProfileSubsection.cs     |  6 +++---
 .../Profile/Sections/Ranks/PaginatedScoreContainer.cs  |  2 +-
 .../Recent/PaginatedRecentActivityContainer.cs         |  2 +-
 13 files changed, 20 insertions(+), 20 deletions(-)
 rename osu.Game/Online/API/Requests/{Pagination.cs => PaginationParameters.cs} (68%)

diff --git a/osu.Game/Online/API/Requests/GetUserBeatmapsRequest.cs b/osu.Game/Online/API/Requests/GetUserBeatmapsRequest.cs
index 019c805c9a..ffb3a3be9b 100644
--- a/osu.Game/Online/API/Requests/GetUserBeatmapsRequest.cs
+++ b/osu.Game/Online/API/Requests/GetUserBeatmapsRequest.cs
@@ -13,7 +13,7 @@ namespace osu.Game.Online.API.Requests
 
         private readonly BeatmapSetType type;
 
-        public GetUserBeatmapsRequest(long userId, BeatmapSetType type, Pagination pagination)
+        public GetUserBeatmapsRequest(long userId, BeatmapSetType type, PaginationParameters pagination)
             : base(pagination)
         {
             this.userId = userId;
diff --git a/osu.Game/Online/API/Requests/GetUserKudosuHistoryRequest.cs b/osu.Game/Online/API/Requests/GetUserKudosuHistoryRequest.cs
index 3759c59722..67d3ad26b0 100644
--- a/osu.Game/Online/API/Requests/GetUserKudosuHistoryRequest.cs
+++ b/osu.Game/Online/API/Requests/GetUserKudosuHistoryRequest.cs
@@ -10,7 +10,7 @@ namespace osu.Game.Online.API.Requests
     {
         private readonly long userId;
 
-        public GetUserKudosuHistoryRequest(long userId, Pagination pagination)
+        public GetUserKudosuHistoryRequest(long userId, PaginationParameters pagination)
             : base(pagination)
         {
             this.userId = userId;
diff --git a/osu.Game/Online/API/Requests/GetUserMostPlayedBeatmapsRequest.cs b/osu.Game/Online/API/Requests/GetUserMostPlayedBeatmapsRequest.cs
index 37359e2cd0..bef3df42fb 100644
--- a/osu.Game/Online/API/Requests/GetUserMostPlayedBeatmapsRequest.cs
+++ b/osu.Game/Online/API/Requests/GetUserMostPlayedBeatmapsRequest.cs
@@ -10,7 +10,7 @@ namespace osu.Game.Online.API.Requests
     {
         private readonly long userId;
 
-        public GetUserMostPlayedBeatmapsRequest(long userId, Pagination pagination)
+        public GetUserMostPlayedBeatmapsRequest(long userId, PaginationParameters pagination)
             : base(pagination)
         {
             this.userId = userId;
diff --git a/osu.Game/Online/API/Requests/GetUserRecentActivitiesRequest.cs b/osu.Game/Online/API/Requests/GetUserRecentActivitiesRequest.cs
index c16633c17a..79f0549d4a 100644
--- a/osu.Game/Online/API/Requests/GetUserRecentActivitiesRequest.cs
+++ b/osu.Game/Online/API/Requests/GetUserRecentActivitiesRequest.cs
@@ -10,7 +10,7 @@ namespace osu.Game.Online.API.Requests
     {
         private readonly long userId;
 
-        public GetUserRecentActivitiesRequest(long userId, Pagination pagination)
+        public GetUserRecentActivitiesRequest(long userId, PaginationParameters pagination)
             : base(pagination)
         {
             this.userId = userId;
diff --git a/osu.Game/Online/API/Requests/GetUserScoresRequest.cs b/osu.Game/Online/API/Requests/GetUserScoresRequest.cs
index af01969a1a..7250929f11 100644
--- a/osu.Game/Online/API/Requests/GetUserScoresRequest.cs
+++ b/osu.Game/Online/API/Requests/GetUserScoresRequest.cs
@@ -14,7 +14,7 @@ namespace osu.Game.Online.API.Requests
         private readonly ScoreType type;
         private readonly RulesetInfo ruleset;
 
-        public GetUserScoresRequest(long userId, ScoreType type, Pagination pagination, RulesetInfo ruleset = null)
+        public GetUserScoresRequest(long userId, ScoreType type, PaginationParameters pagination, RulesetInfo ruleset = null)
             : base(pagination)
         {
             this.userId = userId;
diff --git a/osu.Game/Online/API/Requests/PaginatedAPIRequest.cs b/osu.Game/Online/API/Requests/PaginatedAPIRequest.cs
index ddc453bf17..3d719de958 100644
--- a/osu.Game/Online/API/Requests/PaginatedAPIRequest.cs
+++ b/osu.Game/Online/API/Requests/PaginatedAPIRequest.cs
@@ -8,9 +8,9 @@ namespace osu.Game.Online.API.Requests
 {
     public abstract class PaginatedAPIRequest<T> : APIRequest<T> where T : class
     {
-        private readonly Pagination pagination;
+        private readonly PaginationParameters pagination;
 
-        protected PaginatedAPIRequest(Pagination pagination)
+        protected PaginatedAPIRequest(PaginationParameters pagination)
         {
             this.pagination = pagination;
         }
diff --git a/osu.Game/Online/API/Requests/Pagination.cs b/osu.Game/Online/API/Requests/PaginationParameters.cs
similarity index 68%
rename from osu.Game/Online/API/Requests/Pagination.cs
rename to osu.Game/Online/API/Requests/PaginationParameters.cs
index a1caac7592..3593a4fe83 100644
--- a/osu.Game/Online/API/Requests/Pagination.cs
+++ b/osu.Game/Online/API/Requests/PaginationParameters.cs
@@ -6,7 +6,7 @@ namespace osu.Game.Online.API.Requests
     /// <summary>
     /// Represents a pagination data used for <see cref="PaginatedAPIRequest{T}"/>.
     /// </summary>
-    public readonly struct Pagination
+    public readonly struct PaginationParameters
     {
         /// <summary>
         /// The starting point of the request.
@@ -18,21 +18,21 @@ namespace osu.Game.Online.API.Requests
         /// </summary>
         public int Limit { get; }
 
-        public Pagination(int offset, int limit)
+        public PaginationParameters(int offset, int limit)
         {
             Offset = offset;
             Limit = limit;
         }
 
-        public Pagination(int limit)
+        public PaginationParameters(int limit)
             : this(0, limit)
         {
         }
 
         /// <summary>
-        /// Returns a <see cref="Pagination"/> of the next number of items defined by <paramref name="limit"/> after this.
+        /// Returns a <see cref="PaginationParameters"/> of the next number of items defined by <paramref name="limit"/> after this.
         /// </summary>
         /// <param name="limit">The limit of the next pagination.</param>
-        public Pagination TakeNext(int limit) => new Pagination(Offset + Limit, limit);
+        public PaginationParameters TakeNext(int limit) => new PaginationParameters(Offset + Limit, limit);
     }
 }
diff --git a/osu.Game/Overlays/Profile/Sections/Beatmaps/PaginatedBeatmapContainer.cs b/osu.Game/Overlays/Profile/Sections/Beatmaps/PaginatedBeatmapContainer.cs
index f1c2b4bf7a..0424fe8bd9 100644
--- a/osu.Game/Overlays/Profile/Sections/Beatmaps/PaginatedBeatmapContainer.cs
+++ b/osu.Game/Overlays/Profile/Sections/Beatmaps/PaginatedBeatmapContainer.cs
@@ -58,7 +58,7 @@ namespace osu.Game.Overlays.Profile.Sections.Beatmaps
             }
         }
 
-        protected override APIRequest<List<APIBeatmapSet>> CreateRequest(Pagination pagination) =>
+        protected override APIRequest<List<APIBeatmapSet>> CreateRequest(PaginationParameters pagination) =>
             new GetUserBeatmapsRequest(User.Value.Id, type, pagination);
 
         protected override Drawable CreateDrawableItem(APIBeatmapSet model) => model.OnlineID > 0
diff --git a/osu.Game/Overlays/Profile/Sections/Historical/PaginatedMostPlayedBeatmapContainer.cs b/osu.Game/Overlays/Profile/Sections/Historical/PaginatedMostPlayedBeatmapContainer.cs
index 281bcc3a03..06de0f62dc 100644
--- a/osu.Game/Overlays/Profile/Sections/Historical/PaginatedMostPlayedBeatmapContainer.cs
+++ b/osu.Game/Overlays/Profile/Sections/Historical/PaginatedMostPlayedBeatmapContainer.cs
@@ -29,7 +29,7 @@ namespace osu.Game.Overlays.Profile.Sections.Historical
 
         protected override int GetCount(APIUser user) => user.BeatmapPlayCountsCount;
 
-        protected override APIRequest<List<APIUserMostPlayedBeatmap>> CreateRequest(Pagination pagination) =>
+        protected override APIRequest<List<APIUserMostPlayedBeatmap>> CreateRequest(PaginationParameters pagination) =>
             new GetUserMostPlayedBeatmapsRequest(User.Value.Id, pagination);
 
         protected override Drawable CreateDrawableItem(APIUserMostPlayedBeatmap mostPlayed) =>
diff --git a/osu.Game/Overlays/Profile/Sections/Kudosu/PaginatedKudosuHistoryContainer.cs b/osu.Game/Overlays/Profile/Sections/Kudosu/PaginatedKudosuHistoryContainer.cs
index 5aada2b655..9af854e6b9 100644
--- a/osu.Game/Overlays/Profile/Sections/Kudosu/PaginatedKudosuHistoryContainer.cs
+++ b/osu.Game/Overlays/Profile/Sections/Kudosu/PaginatedKudosuHistoryContainer.cs
@@ -19,7 +19,7 @@ namespace osu.Game.Overlays.Profile.Sections.Kudosu
         {
         }
 
-        protected override APIRequest<List<APIKudosuHistory>> CreateRequest(Pagination pagination)
+        protected override APIRequest<List<APIKudosuHistory>> CreateRequest(PaginationParameters pagination)
             => new GetUserKudosuHistoryRequest(User.Value.Id, pagination);
 
         protected override Drawable CreateDrawableItem(APIKudosuHistory item) => new DrawableKudosuHistoryItem(item);
diff --git a/osu.Game/Overlays/Profile/Sections/PaginatedProfileSubsection.cs b/osu.Game/Overlays/Profile/Sections/PaginatedProfileSubsection.cs
index a1f9e7546a..33bd155d71 100644
--- a/osu.Game/Overlays/Profile/Sections/PaginatedProfileSubsection.cs
+++ b/osu.Game/Overlays/Profile/Sections/PaginatedProfileSubsection.cs
@@ -35,7 +35,7 @@ namespace osu.Game.Overlays.Profile.Sections
         [Resolved]
         private IAPIProvider api { get; set; }
 
-        protected Pagination? CurrentPage { get; private set; }
+        protected PaginationParameters? CurrentPage { get; private set; }
 
         protected ReverseChildIDFillFlowContainer<Drawable> ItemsContainer { get; private set; }
 
@@ -111,7 +111,7 @@ namespace osu.Game.Overlays.Profile.Sections
         {
             loadCancellation = new CancellationTokenSource();
 
-            CurrentPage = CurrentPage?.TakeNext(ItemsPerPage) ?? new Pagination(InitialItemsCount);
+            CurrentPage = CurrentPage?.TakeNext(ItemsPerPage) ?? new PaginationParameters(InitialItemsCount);
 
             retrievalRequest = CreateRequest(CurrentPage.Value);
             retrievalRequest.Success += UpdateItems;
@@ -151,7 +151,7 @@ namespace osu.Game.Overlays.Profile.Sections
         {
         }
 
-        protected abstract APIRequest<List<TModel>> CreateRequest(Pagination pagination);
+        protected abstract APIRequest<List<TModel>> CreateRequest(PaginationParameters pagination);
 
         protected abstract Drawable CreateDrawableItem(TModel model);
 
diff --git a/osu.Game/Overlays/Profile/Sections/Ranks/PaginatedScoreContainer.cs b/osu.Game/Overlays/Profile/Sections/Ranks/PaginatedScoreContainer.cs
index c3a5e3f8b8..ef9f4b5ff3 100644
--- a/osu.Game/Overlays/Profile/Sections/Ranks/PaginatedScoreContainer.cs
+++ b/osu.Game/Overlays/Profile/Sections/Ranks/PaginatedScoreContainer.cs
@@ -60,7 +60,7 @@ namespace osu.Game.Overlays.Profile.Sections.Ranks
             base.OnItemsReceived(items);
         }
 
-        protected override APIRequest<List<APIScore>> CreateRequest(Pagination pagination) =>
+        protected override APIRequest<List<APIScore>> CreateRequest(PaginationParameters pagination) =>
             new GetUserScoresRequest(User.Value.Id, type, pagination);
 
         private int drawableItemIndex;
diff --git a/osu.Game/Overlays/Profile/Sections/Recent/PaginatedRecentActivityContainer.cs b/osu.Game/Overlays/Profile/Sections/Recent/PaginatedRecentActivityContainer.cs
index e5118094ce..77008d5f34 100644
--- a/osu.Game/Overlays/Profile/Sections/Recent/PaginatedRecentActivityContainer.cs
+++ b/osu.Game/Overlays/Profile/Sections/Recent/PaginatedRecentActivityContainer.cs
@@ -27,7 +27,7 @@ namespace osu.Game.Overlays.Profile.Sections.Recent
             ItemsContainer.Spacing = new Vector2(0, 8);
         }
 
-        protected override APIRequest<List<APIRecentActivity>> CreateRequest(Pagination pagination) =>
+        protected override APIRequest<List<APIRecentActivity>> CreateRequest(PaginationParameters pagination) =>
             new GetUserRecentActivitiesRequest(User.Value.Id, pagination);
 
         protected override Drawable CreateDrawableItem(APIRecentActivity model) => new DrawableRecentActivity(model);

From 83e89b3e80c737b626fe1962d2652a64a381058e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 19 Apr 2022 11:10:11 +0900
Subject: [PATCH 4135/5547] Add unread count to `INotificationOverlay` and fix
 toolbar button DI logic

---
 .../Visual/Menus/TestSceneToolbar.cs           | 18 +++++++++++++-----
 osu.Game/Overlays/INotificationOverlay.cs      |  6 ++++++
 osu.Game/Overlays/NotificationOverlay.cs       |  6 ++++--
 .../Toolbar/ToolbarNotificationButton.cs       |  8 ++++----
 4 files changed, 27 insertions(+), 11 deletions(-)

diff --git a/osu.Game.Tests/Visual/Menus/TestSceneToolbar.cs b/osu.Game.Tests/Visual/Menus/TestSceneToolbar.cs
index c65595d82e..dbc7e54b5e 100644
--- a/osu.Game.Tests/Visual/Menus/TestSceneToolbar.cs
+++ b/osu.Game.Tests/Visual/Menus/TestSceneToolbar.cs
@@ -2,6 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System.Linq;
+using Moq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
@@ -22,6 +23,17 @@ namespace osu.Game.Tests.Visual.Menus
         [Resolved]
         private IRulesetStore rulesets { get; set; }
 
+        private readonly Mock<INotificationOverlay> notifications = new Mock<INotificationOverlay>();
+
+        private readonly BindableInt unreadNotificationCount = new BindableInt();
+
+        [BackgroundDependencyLoader]
+        private void load()
+        {
+            Dependencies.CacheAs(notifications.Object);
+            notifications.SetupGet(n => n.UnreadCount).Returns(unreadNotificationCount);
+        }
+
         [SetUp]
         public void SetUp() => Schedule(() =>
         {
@@ -31,10 +43,6 @@ namespace osu.Game.Tests.Visual.Menus
         [Test]
         public void TestNotificationCounter()
         {
-            ToolbarNotificationButton notificationButton = null;
-
-            AddStep("retrieve notification button", () => notificationButton = toolbar.ChildrenOfType<ToolbarNotificationButton>().Single());
-
             setNotifications(1);
             setNotifications(2);
             setNotifications(3);
@@ -43,7 +51,7 @@ namespace osu.Game.Tests.Visual.Menus
 
             void setNotifications(int count)
                 => AddStep($"set notification count to {count}",
-                    () => notificationButton.NotificationCount.Value = count);
+                    () => unreadNotificationCount.Value = count);
         }
 
         [TestCase(false)]
diff --git a/osu.Game/Overlays/INotificationOverlay.cs b/osu.Game/Overlays/INotificationOverlay.cs
index 432dd2be54..1d8e33ea3a 100644
--- a/osu.Game/Overlays/INotificationOverlay.cs
+++ b/osu.Game/Overlays/INotificationOverlay.cs
@@ -2,6 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using osu.Framework.Allocation;
+using osu.Framework.Bindables;
 using osu.Game.Overlays.Notifications;
 
 namespace osu.Game.Overlays
@@ -22,5 +23,10 @@ namespace osu.Game.Overlays
         /// Hide the overlay, if it is currently visible.
         /// </summary>
         void Hide();
+
+        /// <summary>
+        /// Current number of unread notifications.
+        /// </summary>
+        IBindable<int> UnreadCount { get; }
     }
 }
diff --git a/osu.Game/Overlays/NotificationOverlay.cs b/osu.Game/Overlays/NotificationOverlay.cs
index 0e8fbc6680..2b5909f45a 100644
--- a/osu.Game/Overlays/NotificationOverlay.cs
+++ b/osu.Game/Overlays/NotificationOverlay.cs
@@ -99,7 +99,9 @@ namespace osu.Game.Overlays
             OverlayActivationMode.BindValueChanged(_ => updateProcessingMode(), true);
         }
 
-        public readonly BindableInt UnreadCount = new BindableInt();
+        public IBindable<int> UnreadCount => unreadCount;
+
+        private readonly BindableInt unreadCount = new BindableInt();
 
         private int runningDepth;
 
@@ -180,7 +182,7 @@ namespace osu.Game.Overlays
 
         private void updateCounts()
         {
-            UnreadCount.Value = sections.Select(c => c.UnreadCount).Sum();
+            unreadCount.Value = sections.Select(c => c.UnreadCount).Sum();
         }
 
         private void markAllRead()
diff --git a/osu.Game/Overlays/Toolbar/ToolbarNotificationButton.cs b/osu.Game/Overlays/Toolbar/ToolbarNotificationButton.cs
index 79d0fc74c1..313a2bc3f4 100644
--- a/osu.Game/Overlays/Toolbar/ToolbarNotificationButton.cs
+++ b/osu.Game/Overlays/Toolbar/ToolbarNotificationButton.cs
@@ -18,7 +18,7 @@ namespace osu.Game.Overlays.Toolbar
     {
         protected override Anchor TooltipAnchor => Anchor.TopRight;
 
-        public BindableInt NotificationCount = new BindableInt();
+        public IBindable<int> NotificationCount = new BindableInt();
 
         private readonly CountCircle countDisplay;
 
@@ -36,10 +36,10 @@ namespace osu.Game.Overlays.Toolbar
             });
         }
 
-        [BackgroundDependencyLoader(true)]
-        private void load(NotificationOverlay notificationOverlay)
+        [BackgroundDependencyLoader]
+        private void load(INotificationOverlay notificationOverlay)
         {
-            StateContainer = notificationOverlay;
+            StateContainer = notificationOverlay as NotificationOverlay;
 
             if (notificationOverlay != null)
                 NotificationCount.BindTo(notificationOverlay.UnreadCount);

From 8d0dd3961e056b2670f67412a48cfdf000ec1694 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Tue, 19 Apr 2022 03:25:18 +0300
Subject: [PATCH 4136/5547] Add failing test cases

---
 .../LegacyMainCirclePieceTest.cs              | 133 ++++++++++++++++++
 .../Skinning/Legacy/LegacyMainCirclePiece.cs  |  19 ++-
 2 files changed, 146 insertions(+), 6 deletions(-)
 create mode 100644 osu.Game.Rulesets.Osu.Tests/LegacyMainCirclePieceTest.cs

diff --git a/osu.Game.Rulesets.Osu.Tests/LegacyMainCirclePieceTest.cs b/osu.Game.Rulesets.Osu.Tests/LegacyMainCirclePieceTest.cs
new file mode 100644
index 0000000000..200dd2f593
--- /dev/null
+++ b/osu.Game.Rulesets.Osu.Tests/LegacyMainCirclePieceTest.cs
@@ -0,0 +1,133 @@
+// 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 NUnit.Framework;
+using osu.Framework.Audio.Sample;
+using osu.Framework.Bindables;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.OpenGL.Textures;
+using osu.Framework.Graphics.Sprites;
+using osu.Framework.Graphics.Textures;
+using osu.Framework.Testing;
+using osu.Game.Audio;
+using osu.Game.Rulesets.Osu.Skinning.Legacy;
+using osu.Game.Skinning;
+using osu.Game.Tests.Visual;
+
+#nullable enable
+
+namespace osu.Game.Rulesets.Osu.Tests
+{
+    [HeadlessTest]
+    public class LegacyMainCirclePieceTest : OsuTestScene
+    {
+        private static readonly object?[][] texture_priority_cases =
+        {
+            // default priority lookup
+            new object?[]
+            {
+                // available textures
+                new[] { @"hitcircle", @"hitcircleoverlay" },
+                // priority lookup
+                @"",
+                // expected circle and overlay
+                @"hitcircle", @"hitcircleoverlay",
+            },
+            // custom priority lookup
+            new object?[]
+            {
+                new[] { @"hitcircle", @"hitcircleoverlay", @"sliderstartcircle", @"sliderstartcircleoverlay" },
+                @"sliderstartcircle",
+                @"sliderstartcircle", @"sliderstartcircleoverlay",
+            },
+            // when no sprites are available for the specified prefix, fall back to "hitcircle"/"hitcircleoverlay".
+            new object?[]
+            {
+                new[] { @"hitcircle", @"hitcircleoverlay" },
+                @"sliderstartcircle",
+                @"hitcircle", @"hitcircleoverlay",
+            },
+            // when a circle is available for the specified prefix but no overlay exists, no overlay is displayed.
+            new object?[]
+            {
+                new[] { @"hitcircle", @"hitcircleoverlay", @"sliderstartcircle" },
+                @"sliderstartcircle",
+                @"sliderstartcircle", null
+            },
+            // when no circle is available for the specified prefix but an overlay exists, the overlay is ignored.
+            new object?[]
+            {
+                new[] { @"hitcircle", @"hitcircleoverlay", @"sliderstartcircleoverlay" },
+                @"sliderstartcircle",
+                @"hitcircle", @"hitcircleoverlay",
+            }
+        };
+
+        [TestCaseSource(nameof(texture_priority_cases))]
+        public void TestTexturePriorities(string[] textureFilenames, string priorityLookup, string? expectedCircle, string? expectedOverlay)
+        {
+            Sprite? circleSprite = null;
+            Sprite? overlaySprite = null;
+
+            AddStep("load circle piece", () =>
+            {
+                Child = new DependencyProvidingContainer
+                {
+                    CachedDependencies = new (Type, object)[]
+                    {
+                        (typeof(ISkinSource), new TestSkin(textureFilenames))
+                    },
+                    Child = new LegacyMainCirclePiece(priorityLookup, false),
+                };
+
+                var sprites = this.ChildrenOfType<Sprite>().Where(s => s.Texture.AssetName != null).DistinctBy(s => s.Texture.AssetName).ToArray();
+                Debug.Assert(sprites.Length <= 2);
+
+                circleSprite = sprites.ElementAtOrDefault(0);
+                overlaySprite = sprites.ElementAtOrDefault(1);
+            });
+
+            AddAssert("check circle sprite", () => circleSprite?.Texture?.AssetName == expectedCircle);
+            AddAssert("check overlay sprite", () => overlaySprite?.Texture?.AssetName == expectedOverlay);
+        }
+
+        private class TestSkin : ISkinSource
+        {
+            private readonly string[] textureFilenames;
+
+            public TestSkin(string[] textureFilenames)
+            {
+                this.textureFilenames = textureFilenames;
+            }
+
+            public Texture? GetTexture(string componentName, WrapMode wrapModeS, WrapMode wrapModeT)
+            {
+                if (textureFilenames.Contains(componentName))
+                    return new Texture(1, 1) { AssetName = componentName };
+
+                return null;
+            }
+
+            public event Action SourceChanged
+            {
+                add { }
+                remove { }
+            }
+
+            public IEnumerable<ISkin> AllSources { get; } = Enumerable.Empty<ISkin>();
+            public Drawable? GetDrawableComponent(ISkinComponent component) => null;
+            public ISample? GetSample(ISampleInfo sampleInfo) => null;
+
+            public IBindable<TValue>? GetConfig<TLookup, TValue>(TLookup lookup)
+                where TLookup : notnull
+                where TValue : notnull
+                => null;
+
+            public ISkin? FindProvider(Func<ISkin, bool> lookupFunction) => lookupFunction(this) ? this : null;
+        }
+    }
+}
diff --git a/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyMainCirclePiece.cs b/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyMainCirclePiece.cs
index c6007885be..829dbb02f1 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyMainCirclePiece.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyMainCirclePiece.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 JetBrains.Annotations;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
@@ -43,7 +44,8 @@ namespace osu.Game.Rulesets.Osu.Skinning.Legacy
         private readonly Bindable<Color4> accentColour = new Bindable<Color4>();
         private readonly IBindable<int> indexInCurrentCombo = new Bindable<int>();
 
-        [Resolved]
+        [Resolved(canBeNull: true)]
+        [CanBeNull]
         private DrawableHitObject drawableObject { get; set; }
 
         [Resolved]
@@ -107,8 +109,11 @@ namespace osu.Game.Rulesets.Osu.Skinning.Legacy
             if (overlayAboveNumber)
                 OverlayLayer.ChangeChildDepth(hitCircleOverlay, float.MinValue);
 
-            accentColour.BindTo(drawableObject.AccentColour);
-            indexInCurrentCombo.BindTo(drawableOsuObject.IndexInCurrentComboBindable);
+            if (drawableOsuObject != null)
+            {
+                accentColour.BindTo(drawableOsuObject.AccentColour);
+                indexInCurrentCombo.BindTo(drawableOsuObject.IndexInCurrentComboBindable);
+            }
 
             Texture getTextureWithFallback(string name)
             {
@@ -149,15 +154,17 @@ namespace osu.Game.Rulesets.Osu.Skinning.Legacy
             if (hasNumber)
                 indexInCurrentCombo.BindValueChanged(index => hitCircleText.Text = (index.NewValue + 1).ToString(), true);
 
-            drawableObject.ApplyCustomUpdateState += updateStateTransforms;
-            updateStateTransforms(drawableObject, drawableObject.State.Value);
+            if (drawableObject != null)
+                drawableObject.ApplyCustomUpdateState += updateStateTransforms;
+
+            updateStateTransforms(drawableObject, drawableObject?.State.Value ?? ArmedState.Idle);
         }
 
         private void updateStateTransforms(DrawableHitObject drawableHitObject, ArmedState state)
         {
             const double legacy_fade_duration = 240;
 
-            using (BeginAbsoluteSequence(drawableObject.HitStateUpdateTime))
+            using (BeginAbsoluteSequence(drawableObject?.HitStateUpdateTime ?? 0))
             {
                 switch (state)
                 {

From ec7bb876b5f76416255fa04e71876f6f39980465 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Tue, 19 Apr 2022 07:12:05 +0300
Subject: [PATCH 4137/5547] Improve legacy circle texture lookup to match 1:1
 with stable

---
 .../Skinning/Legacy/LegacyMainCirclePiece.cs  | 49 +++++--------------
 1 file changed, 12 insertions(+), 37 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyMainCirclePiece.cs b/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyMainCirclePiece.cs
index 829dbb02f1..5fe4a4b5df 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyMainCirclePiece.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyMainCirclePiece.cs
@@ -23,9 +23,10 @@ namespace osu.Game.Rulesets.Osu.Skinning.Legacy
     {
         public override bool RemoveCompletedTransforms => false;
 
-        private readonly string priorityLookup;
         private readonly bool hasNumber;
 
+        private string priorityLookup;
+
         public LegacyMainCirclePiece(string priorityLookup = null, bool hasNumber = true)
         {
             this.priorityLookup = priorityLookup;
@@ -56,21 +57,19 @@ namespace osu.Game.Rulesets.Osu.Skinning.Legacy
         {
             var drawableOsuObject = (DrawableOsuHitObject)drawableObject;
 
-            bool allowFallback = false;
-
             // attempt lookup using priority specification
-            Texture baseTexture = getTextureWithFallback(string.Empty);
+            Texture baseTexture = getTexture(string.Empty);
 
-            // if the base texture was not found without a fallback, switch on fallback mode and re-perform the lookup.
+            // if the base texture was not found using the priority specification, nullify the specification and fall back to "hitcircle".
             if (baseTexture == null)
             {
-                allowFallback = true;
-                baseTexture = getTextureWithFallback(string.Empty);
+                priorityLookup = null;
+                baseTexture = getTexture(string.Empty);
             }
 
             // at this point, any further texture fetches should be correctly using the priority source if the base texture was retrieved using it.
             // the flow above handles the case where a sliderendcircle.png is retrieved from the skin, but sliderendcircleoverlay.png doesn't exist.
-            // expected behaviour in this scenario is not showing the overlay, rather than using hitcircleoverlay.png (potentially from the default/fall-through skin).
+            // expected behaviour in this scenario is not showing the overlay, rather than using hitcircleoverlay.png.
 
             InternalChildren = new[]
             {
@@ -83,7 +82,7 @@ namespace osu.Game.Rulesets.Osu.Skinning.Legacy
                 {
                     Anchor = Anchor.Centre,
                     Origin = Anchor.Centre,
-                    Child = hitCircleOverlay = new KiaiFlashingDrawable(() => getAnimationWithFallback(@"overlay", 1000 / 2d))
+                    Child = hitCircleOverlay = new KiaiFlashingDrawable(() => getAnimation(@"overlay", 1000 / 2d))
                     {
                         Anchor = Anchor.Centre,
                         Origin = Anchor.Centre,
@@ -115,35 +114,11 @@ namespace osu.Game.Rulesets.Osu.Skinning.Legacy
                 indexInCurrentCombo.BindTo(drawableOsuObject.IndexInCurrentComboBindable);
             }
 
-            Texture getTextureWithFallback(string name)
-            {
-                Texture tex = null;
+            Texture getTexture(string name)
+                => skin.GetTexture($"{priorityLookup ?? @"hitcircle"}{name}");
 
-                if (!string.IsNullOrEmpty(priorityLookup))
-                {
-                    tex = skin.GetTexture($"{priorityLookup}{name}");
-
-                    if (!allowFallback)
-                        return tex;
-                }
-
-                return tex ?? skin.GetTexture($"hitcircle{name}");
-            }
-
-            Drawable getAnimationWithFallback(string name, double frameLength)
-            {
-                Drawable animation = null;
-
-                if (!string.IsNullOrEmpty(priorityLookup))
-                {
-                    animation = skin.GetAnimation($"{priorityLookup}{name}", true, true, frameLength: frameLength);
-
-                    if (!allowFallback)
-                        return animation;
-                }
-
-                return animation ?? skin.GetAnimation($"hitcircle{name}", true, true, frameLength: frameLength);
-            }
+            Drawable getAnimation(string name, double frameLength)
+                => skin.GetAnimation($"{priorityLookup ?? @"hitcircle"}{name}", true, true, frameLength: frameLength);
         }
 
         protected override void LoadComplete()

From f92a41b6c3758027e315347fafb01abbac7aa678 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Tue, 19 Apr 2022 08:03:50 +0300
Subject: [PATCH 4138/5547] Replace local `TestSkin` implementation with
 simplified Moq setups

---
 .../LegacyMainCirclePieceTest.cs              | 56 ++++---------------
 1 file changed, 10 insertions(+), 46 deletions(-)

diff --git a/osu.Game.Rulesets.Osu.Tests/LegacyMainCirclePieceTest.cs b/osu.Game.Rulesets.Osu.Tests/LegacyMainCirclePieceTest.cs
index 200dd2f593..766db25d71 100644
--- a/osu.Game.Rulesets.Osu.Tests/LegacyMainCirclePieceTest.cs
+++ b/osu.Game.Rulesets.Osu.Tests/LegacyMainCirclePieceTest.cs
@@ -1,25 +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.
 
+#nullable enable
+
 using System;
-using System.Collections.Generic;
 using System.Diagnostics;
 using System.Linq;
+using Moq;
 using NUnit.Framework;
-using osu.Framework.Audio.Sample;
-using osu.Framework.Bindables;
-using osu.Framework.Graphics;
 using osu.Framework.Graphics.OpenGL.Textures;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Graphics.Textures;
 using osu.Framework.Testing;
-using osu.Game.Audio;
 using osu.Game.Rulesets.Osu.Skinning.Legacy;
 using osu.Game.Skinning;
 using osu.Game.Tests.Visual;
 
-#nullable enable
-
 namespace osu.Game.Rulesets.Osu.Tests
 {
     [HeadlessTest]
@@ -75,12 +71,15 @@ namespace osu.Game.Rulesets.Osu.Tests
 
             AddStep("load circle piece", () =>
             {
+                var skin = new Mock<ISkinSource>();
+
+                skin.Setup(s => s.GetTexture(It.IsAny<string>())).CallBase();
+                skin.Setup(s => s.GetTexture(It.IsIn(textureFilenames), It.IsAny<WrapMode>(), It.IsAny<WrapMode>()))
+                    .Returns((string componentName, WrapMode _, WrapMode __) => new Texture(1, 1) { AssetName = componentName });
+
                 Child = new DependencyProvidingContainer
                 {
-                    CachedDependencies = new (Type, object)[]
-                    {
-                        (typeof(ISkinSource), new TestSkin(textureFilenames))
-                    },
+                    CachedDependencies = new (Type, object)[] { (typeof(ISkinSource), skin.Object) },
                     Child = new LegacyMainCirclePiece(priorityLookup, false),
                 };
 
@@ -94,40 +93,5 @@ namespace osu.Game.Rulesets.Osu.Tests
             AddAssert("check circle sprite", () => circleSprite?.Texture?.AssetName == expectedCircle);
             AddAssert("check overlay sprite", () => overlaySprite?.Texture?.AssetName == expectedOverlay);
         }
-
-        private class TestSkin : ISkinSource
-        {
-            private readonly string[] textureFilenames;
-
-            public TestSkin(string[] textureFilenames)
-            {
-                this.textureFilenames = textureFilenames;
-            }
-
-            public Texture? GetTexture(string componentName, WrapMode wrapModeS, WrapMode wrapModeT)
-            {
-                if (textureFilenames.Contains(componentName))
-                    return new Texture(1, 1) { AssetName = componentName };
-
-                return null;
-            }
-
-            public event Action SourceChanged
-            {
-                add { }
-                remove { }
-            }
-
-            public IEnumerable<ISkin> AllSources { get; } = Enumerable.Empty<ISkin>();
-            public Drawable? GetDrawableComponent(ISkinComponent component) => null;
-            public ISample? GetSample(ISampleInfo sampleInfo) => null;
-
-            public IBindable<TValue>? GetConfig<TLookup, TValue>(TLookup lookup)
-                where TLookup : notnull
-                where TValue : notnull
-                => null;
-
-            public ISkin? FindProvider(Func<ISkin, bool> lookupFunction) => lookupFunction(this) ? this : null;
-        }
     }
 }

From fd113953ace591b867081da881821f15dd356511 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Tue, 19 Apr 2022 08:06:39 +0300
Subject: [PATCH 4139/5547] Rename `prioritiyLookup` and add xmldoc

---
 .../Skinning/Legacy/LegacyMainCirclePiece.cs  | 19 +++++++++++++------
 1 file changed, 13 insertions(+), 6 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyMainCirclePiece.cs b/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyMainCirclePiece.cs
index 5fe4a4b5df..82bb4dcf2d 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyMainCirclePiece.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyMainCirclePiece.cs
@@ -25,11 +25,18 @@ namespace osu.Game.Rulesets.Osu.Skinning.Legacy
 
         private readonly bool hasNumber;
 
-        private string priorityLookup;
+        /// <summary>
+        /// A prioritised prefix to perform texture lookups with.
+        /// </summary>
+        /// <remarks>
+        /// If the "circle" texture could not be found with this prefix,
+        /// then it is nullified and the default prefix "hitcircle" is used instead.
+        /// </remarks>
+        private string priorityLookupPrefix;
 
-        public LegacyMainCirclePiece(string priorityLookup = null, bool hasNumber = true)
+        public LegacyMainCirclePiece(string priorityLookupPrefix = null, bool hasNumber = true)
         {
-            this.priorityLookup = priorityLookup;
+            this.priorityLookupPrefix = priorityLookupPrefix;
             this.hasNumber = hasNumber;
 
             Size = new Vector2(OsuHitObject.OBJECT_RADIUS * 2);
@@ -63,7 +70,7 @@ namespace osu.Game.Rulesets.Osu.Skinning.Legacy
             // if the base texture was not found using the priority specification, nullify the specification and fall back to "hitcircle".
             if (baseTexture == null)
             {
-                priorityLookup = null;
+                priorityLookupPrefix = null;
                 baseTexture = getTexture(string.Empty);
             }
 
@@ -115,10 +122,10 @@ namespace osu.Game.Rulesets.Osu.Skinning.Legacy
             }
 
             Texture getTexture(string name)
-                => skin.GetTexture($"{priorityLookup ?? @"hitcircle"}{name}");
+                => skin.GetTexture($"{priorityLookupPrefix ?? @"hitcircle"}{name}");
 
             Drawable getAnimation(string name, double frameLength)
-                => skin.GetAnimation($"{priorityLookup ?? @"hitcircle"}{name}", true, true, frameLength: frameLength);
+                => skin.GetAnimation($"{priorityLookupPrefix ?? @"hitcircle"}{name}", true, true, frameLength: frameLength);
         }
 
         protected override void LoadComplete()

From b067924adacb6ecdc38d3d9ccdf52a30b44458f7 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Tue, 19 Apr 2022 08:08:02 +0300
Subject: [PATCH 4140/5547] Avoid applying state transforms when no object is
 present

---
 .../Skinning/Legacy/LegacyMainCirclePiece.cs              | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyMainCirclePiece.cs b/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyMainCirclePiece.cs
index 82bb4dcf2d..9d14041dd8 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyMainCirclePiece.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyMainCirclePiece.cs
@@ -4,6 +4,7 @@
 using JetBrains.Annotations;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
+using osu.Framework.Extensions.ObjectExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Sprites;
@@ -137,16 +138,17 @@ namespace osu.Game.Rulesets.Osu.Skinning.Legacy
                 indexInCurrentCombo.BindValueChanged(index => hitCircleText.Text = (index.NewValue + 1).ToString(), true);
 
             if (drawableObject != null)
+            {
                 drawableObject.ApplyCustomUpdateState += updateStateTransforms;
-
-            updateStateTransforms(drawableObject, drawableObject?.State.Value ?? ArmedState.Idle);
+                updateStateTransforms(drawableObject, drawableObject.State.Value);
+            }
         }
 
         private void updateStateTransforms(DrawableHitObject drawableHitObject, ArmedState state)
         {
             const double legacy_fade_duration = 240;
 
-            using (BeginAbsoluteSequence(drawableObject?.HitStateUpdateTime ?? 0))
+            using (BeginAbsoluteSequence(drawableObject.AsNonNull().HitStateUpdateTime))
             {
                 switch (state)
                 {

From feeff1647697ef1c45156091cce88da20464caee Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 19 Apr 2022 14:30:45 +0900
Subject: [PATCH 4141/5547] Add debug language to help with localisation
 efforts

The idea is to allow a developer to immediately see which text on a
component or screen has already got localisation support. It can be a
bit of a challenge to see this when creating a new component that
doesn't yet have any translations populated.

Curious to hear thoughts on this. I could see it working very well as a
visual tests checkbox (implemented at o!f side), potentially in addition
to having this at the game level, or replacing this PR.
---
 .../Localisation/DebugLocalisationStore.cs    | 30 +++++++++++++++++++
 osu.Game/Localisation/Language.cs             |  7 ++++-
 osu.Game/OsuGame.cs                           |  8 +++++
 3 files changed, 44 insertions(+), 1 deletion(-)
 create mode 100644 osu.Game/Localisation/DebugLocalisationStore.cs

diff --git a/osu.Game/Localisation/DebugLocalisationStore.cs b/osu.Game/Localisation/DebugLocalisationStore.cs
new file mode 100644
index 0000000000..99dca6265e
--- /dev/null
+++ b/osu.Game/Localisation/DebugLocalisationStore.cs
@@ -0,0 +1,30 @@
+// 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.Globalization;
+using System.IO;
+using System.Threading;
+using System.Threading.Tasks;
+using osu.Framework.Localisation;
+
+namespace osu.Game.Localisation
+{
+    public class DebugLocalisationStore : ILocalisationStore
+    {
+        public string Get(string lookup) => $@"[[{lookup.Substring(lookup.LastIndexOf('.') + 1)}]]";
+
+        public Task<string> GetAsync(string lookup, CancellationToken cancellationToken = default) => Task.FromResult(Get(lookup));
+
+        public Stream GetStream(string name) => throw new NotImplementedException();
+
+        public IEnumerable<string> GetAvailableResources() => throw new NotImplementedException();
+
+        public CultureInfo EffectiveCulture { get; } = new CultureInfo(@"debug");
+
+        public void Dispose()
+        {
+        }
+    }
+}
diff --git a/osu.Game/Localisation/Language.cs b/osu.Game/Localisation/Language.cs
index ab96d01c82..c98586457e 100644
--- a/osu.Game/Localisation/Language.cs
+++ b/osu.Game/Localisation/Language.cs
@@ -110,6 +110,11 @@ namespace osu.Game.Localisation
         // zh_hk,
 
         [Description(@"繁體中文（台灣）")]
-        zh_hant
+        zh_hant,
+
+#if DEBUG
+        [Description(@"Debug (show raw keys)")]
+        DebugLocalisation
+#endif
     }
 }
diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index eee86de7ff..b591b09584 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -628,6 +628,14 @@ namespace osu.Game
 
             foreach (var language in Enum.GetValues(typeof(Language)).OfType<Language>())
             {
+#if DEBUG
+                if (language == Language.DebugLocalisation)
+                {
+                    Localisation.AddLanguage(Language.DebugLocalisation.ToString(), new DebugLocalisationStore());
+                    continue;
+                }
+#endif
+
                 string cultureCode = language.ToCultureCode();
 
                 try

From ae07b2b512b61ff86bd36632d67c6f01664c8d3c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 6 Apr 2022 17:42:10 +0900
Subject: [PATCH 4142/5547] Initial setup

---
 .../Visual/Navigation/TestFirstRunSetup.cs    |  15 ++
 osu.Game/OsuGame.cs                           |   3 +
 .../FirstRunSetup/FirstRunSetupScreen.cs      |  51 +++++++
 .../Overlays/FirstRunSetup/ScreenWelcome.cs   |  58 ++++++++
 osu.Game/Overlays/FirstRunSetupOverlay.cs     | 134 ++++++++++++++++++
 5 files changed, 261 insertions(+)
 create mode 100644 osu.Game.Tests/Visual/Navigation/TestFirstRunSetup.cs
 create mode 100644 osu.Game/Overlays/FirstRunSetup/FirstRunSetupScreen.cs
 create mode 100644 osu.Game/Overlays/FirstRunSetup/ScreenWelcome.cs
 create mode 100644 osu.Game/Overlays/FirstRunSetupOverlay.cs

diff --git a/osu.Game.Tests/Visual/Navigation/TestFirstRunSetup.cs b/osu.Game.Tests/Visual/Navigation/TestFirstRunSetup.cs
new file mode 100644
index 0000000000..ab49334af1
--- /dev/null
+++ b/osu.Game.Tests/Visual/Navigation/TestFirstRunSetup.cs
@@ -0,0 +1,15 @@
+// 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;
+
+namespace osu.Game.Tests.Visual.Navigation
+{
+    public class TestFirstRunSetup : OsuGameTestScene
+    {
+        [Test]
+        public void TestOverlay()
+        {
+        }
+    }
+}
diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index 5a150b0c49..52aa6b8f07 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -149,6 +149,8 @@ namespace osu.Game
 
         protected SettingsOverlay Settings;
 
+        private FirstRunSetupOverlay firstRunOverlay;
+
         private VolumeOverlay volume;
 
         private OsuLogo osuLogo;
@@ -791,6 +793,7 @@ namespace osu.Game
             loadComponentSingleFile(CreateUpdateManager(), Add, true);
 
             // overlay elements
+            loadComponentSingleFile(firstRunOverlay = new FirstRunSetupOverlay(), overlayContent.Add, true);
             loadComponentSingleFile(new ManageCollectionsDialog(), overlayContent.Add, true);
             loadComponentSingleFile(beatmapListing = new BeatmapListingOverlay(), overlayContent.Add, true);
             loadComponentSingleFile(dashboard = new DashboardOverlay(), overlayContent.Add, true);
diff --git a/osu.Game/Overlays/FirstRunSetup/FirstRunSetupScreen.cs b/osu.Game/Overlays/FirstRunSetup/FirstRunSetupScreen.cs
new file mode 100644
index 0000000000..d00d21d347
--- /dev/null
+++ b/osu.Game/Overlays/FirstRunSetup/FirstRunSetupScreen.cs
@@ -0,0 +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 osu.Framework.Allocation;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
+using osu.Framework.Input.Events;
+using osu.Framework.Screens;
+
+namespace osu.Game.Overlays.FirstRunSetup
+{
+    public abstract class FirstRunSetupScreen : Screen
+    {
+        [Resolved]
+        protected FirstRunSetupOverlay Overlay { get; private set; }
+
+        protected Container Content { get; private set; }
+
+        protected FirstRunSetupScreen()
+        {
+            InternalChildren = new Drawable[]
+            {
+                Content = new Container
+                {
+                    RelativeSizeAxes = Axes.Both,
+                    Padding = new MarginPadding(20),
+                },
+            };
+        }
+
+        protected override bool OnClick(ClickEvent e) => true;
+
+        public override void OnEntering(IScreen last)
+        {
+            base.OnEntering(last);
+            this.FadeOut().Delay(200).FadeIn(200);
+        }
+
+        public override void OnResuming(IScreen last)
+        {
+            base.OnResuming(last);
+            this.FadeIn(200);
+        }
+
+        public override void OnSuspending(IScreen next)
+        {
+            base.OnSuspending(next);
+            this.FadeOut(200);
+        }
+    }
+}
diff --git a/osu.Game/Overlays/FirstRunSetup/ScreenWelcome.cs b/osu.Game/Overlays/FirstRunSetup/ScreenWelcome.cs
new file mode 100644
index 0000000000..be21712c95
--- /dev/null
+++ b/osu.Game/Overlays/FirstRunSetup/ScreenWelcome.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 osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
+using osu.Framework.Screens;
+using osu.Framework.Utils;
+using osu.Game.Graphics.Containers;
+using osu.Game.Screens.OnlinePlay.Match.Components;
+using osuTK;
+
+namespace osu.Game.Overlays.FirstRunSetup
+{
+    public class ScreenWelcome : FirstRunSetupScreen
+    {
+        public ScreenWelcome()
+        {
+            Content.Children = new Drawable[]
+            {
+                new FillFlowContainer
+                {
+                    RelativeSizeAxes = Axes.Both,
+                    Direction = FillDirection.Vertical,
+                    Children = new Drawable[]
+                    {
+                        new OsuTextFlowContainer
+                        {
+                            Text = "Welcome to the first-run setup guide!\n\nThis will help you get osu! setup in a way that suits you.",
+                            RelativeSizeAxes = Axes.X,
+                            AutoSizeAxes = Axes.Y
+                        },
+                    }
+                },
+                new PurpleTriangleButton
+                {
+                    Anchor = Anchor.BottomCentre,
+                    Origin = Anchor.BottomCentre,
+                    RelativeSizeAxes = Axes.X,
+                    Margin = new MarginPadding(10),
+                    Text = "Get started",
+                    Action = () => this.Push(new ScreenWelcome()),
+                }
+            };
+        }
+
+        public override void OnEntering(IScreen last)
+        {
+            base.OnEntering(last);
+            Overlay.MoveDisplayTo(new Vector2(RNG.NextSingle(), RNG.NextSingle()));
+        }
+
+        public override void OnResuming(IScreen last)
+        {
+            base.OnResuming(last);
+            Overlay.MoveDisplayTo(new Vector2(RNG.NextSingle(), RNG.NextSingle()));
+        }
+    }
+}
diff --git a/osu.Game/Overlays/FirstRunSetupOverlay.cs b/osu.Game/Overlays/FirstRunSetupOverlay.cs
new file mode 100644
index 0000000000..218e6018e2
--- /dev/null
+++ b/osu.Game/Overlays/FirstRunSetupOverlay.cs
@@ -0,0 +1,134 @@
+// 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.Extensions.Color4Extensions;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.Effects;
+using osu.Framework.Graphics.Shapes;
+using osu.Framework.Input.Events;
+using osu.Framework.Screens;
+using osu.Game.Graphics;
+using osu.Game.Graphics.Containers;
+using osu.Game.Online.API;
+using osu.Game.Overlays.Dialog;
+using osu.Game.Overlays.FirstRunSetup;
+using osu.Game.Rulesets.UI;
+using osu.Game.Screens.Menu;
+using osuTK;
+using osuTK.Graphics;
+
+namespace osu.Game.Overlays
+{
+    [Cached]
+    public class FirstRunSetupOverlay : OsuFocusedOverlayContainer
+    {
+        protected override bool StartHidden => true;
+
+        [Resolved]
+        private DialogOverlay dialogOverlay { get; set; }
+
+        [Resolved]
+        private OsuGame osuGame { get; set; }
+
+        private ScreenWelcome welcomeScreen;
+
+        private Container currentDisplayContainer;
+
+        private PlayfieldBorder border;
+
+        public FirstRunSetupOverlay()
+        {
+            RelativeSizeAxes = Axes.Both;
+        }
+
+        [BackgroundDependencyLoader]
+        private void load(IAPIProvider api, OsuColour colours)
+        {
+            Children = new Drawable[]
+            {
+                border = new PlayfieldBorder
+                {
+                    PlayfieldBorderStyle = { Value = PlayfieldBorderStyle.Full },
+                    Colour = colours.Blue,
+                },
+                currentDisplayContainer = new Container
+                {
+                    Origin = Anchor.Centre,
+                    RelativePositionAxes = Axes.Both,
+                    Size = new Vector2(400, 300),
+                    Position = new Vector2(0.5f),
+                    EdgeEffect = new EdgeEffectParameters
+                    {
+                        Type = EdgeEffectType.Shadow,
+                        Radius = 5,
+                        Colour = Color4.Black.Opacity(0.2f),
+                    },
+                    Masking = true,
+                    CornerRadius = 10,
+                    Children = new Drawable[]
+                    {
+                        new Box
+                        {
+                            RelativeSizeAxes = Axes.Both,
+                            Colour = Color4.Black,
+                            Alpha = 0.8f,
+                        },
+                        new ScreenStack(welcomeScreen = new ScreenWelcome())
+                        {
+                            RelativeSizeAxes = Axes.Both,
+                        },
+                    }
+                }
+            };
+        }
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            // if we are valid for display, only do so after reaching the main menu.
+            osuGame.PerformFromScreen(_ =>
+            {
+                Show();
+            }, new[] { typeof(MainMenu) });
+
+            border
+                .FadeInFromZero(500)
+                .Delay(1000)
+                .FadeOut(500)
+                .Loop();
+        }
+
+        protected override bool OnClick(ClickEvent e)
+        {
+            if (dialogOverlay.CurrentDialog == null)
+            {
+                dialogOverlay.Push(new ConfirmDialog("Are you sure you want to exit the setup process?",
+                    Hide,
+                    () => { }));
+            }
+
+            return base.OnClick(e);
+        }
+
+        protected override void PopIn()
+        {
+            base.PopIn();
+            this.FadeIn(400, Easing.OutQuint);
+
+            if (welcomeScreen.GetChildScreen() != null)
+                welcomeScreen.MakeCurrent();
+        }
+
+        protected override void PopOut()
+        {
+            base.PopOut();
+            this.FadeOut(100);
+        }
+
+        public void MoveDisplayTo(Vector2 position) =>
+            currentDisplayContainer.MoveTo(position, 1000, Easing.OutElasticQuarter);
+    }
+}

From c2df3465b281fe8523e51379785780005cb98041 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 6 Apr 2022 18:11:32 +0900
Subject: [PATCH 4143/5547] Add ui scaling setup screen, kind of

---
 .../FirstRunSetup/ScreenSetupUIScale.cs       | 87 +++++++++++++++++++
 .../Overlays/FirstRunSetup/ScreenWelcome.cs   | 11 +--
 osu.Game/Overlays/FirstRunSetupOverlay.cs     |  6 +-
 3 files changed, 94 insertions(+), 10 deletions(-)
 create mode 100644 osu.Game/Overlays/FirstRunSetup/ScreenSetupUIScale.cs

diff --git a/osu.Game/Overlays/FirstRunSetup/ScreenSetupUIScale.cs b/osu.Game/Overlays/FirstRunSetup/ScreenSetupUIScale.cs
new file mode 100644
index 0000000000..7c703f65bd
--- /dev/null
+++ b/osu.Game/Overlays/FirstRunSetup/ScreenSetupUIScale.cs
@@ -0,0 +1,87 @@
+// 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.Localisation;
+using osu.Framework.Screens;
+using osu.Game.Configuration;
+using osu.Game.Graphics.Containers;
+using osu.Game.Graphics.UserInterface;
+using osu.Game.Localisation;
+using osu.Game.Overlays.Settings;
+using osu.Game.Screens;
+using osu.Game.Screens.OnlinePlay.Match.Components;
+using osu.Game.Screens.Select;
+using osuTK;
+
+namespace osu.Game.Overlays.FirstRunSetup
+{
+    public class ScreenSetupUIScale : FirstRunSetupScreen
+    {
+        [Resolved]
+        private OsuConfigManager osuConfig { get; set; }
+
+        [BackgroundDependencyLoader]
+        private void load()
+        {
+            OsuScreenStack stack;
+            Content.Children = new Drawable[]
+            {
+                new FillFlowContainer
+                {
+                    RelativeSizeAxes = Axes.Both,
+                    Direction = FillDirection.Vertical,
+                    Spacing = new Vector2(20),
+                    Children = new Drawable[]
+                    {
+                        new OsuTextFlowContainer
+                        {
+                            Text = "The osu! user interface size can be adjusted to your liking.",
+                            RelativeSizeAxes = Axes.X,
+                            AutoSizeAxes = Axes.Y
+                        },
+                        new SettingsSlider<float, UIScaleSlider>
+                        {
+                            LabelText = GraphicsSettingsStrings.UIScaling,
+                            TransferValueOnCommit = true,
+                            Current = osuConfig.GetBindable<float>(OsuSetting.UIScale),
+                            KeyboardStep = 0.01f,
+                        },
+                        new DrawSizePreservingFillContainer
+                        {
+                            Masking = true,
+                            RelativeSizeAxes = Axes.X,
+                            Height = 300,
+                            Child = stack = new OsuScreenStack()
+                        }
+                    }
+                },
+                new PurpleTriangleButton
+                {
+                    Anchor = Anchor.BottomCentre,
+                    Origin = Anchor.BottomCentre,
+                    RelativeSizeAxes = Axes.X,
+                    Margin = new MarginPadding(10),
+                    Text = "Finish",
+                    Action = () => Overlay.Hide()
+                }
+            };
+
+            stack.Push(new PlaySongSelect());
+        }
+
+        public override void OnEntering(IScreen last)
+        {
+            base.OnEntering(last);
+            Overlay.MoveDisplayTo(new Vector2(0.5f));
+            Overlay.ResizeDisplayTo(new Vector2(0.8f));
+        }
+
+        private class UIScaleSlider : OsuSliderBar<float>
+        {
+            public override LocalisableString TooltipText => base.TooltipText + "x";
+        }
+    }
+}
diff --git a/osu.Game/Overlays/FirstRunSetup/ScreenWelcome.cs b/osu.Game/Overlays/FirstRunSetup/ScreenWelcome.cs
index be21712c95..b436db2431 100644
--- a/osu.Game/Overlays/FirstRunSetup/ScreenWelcome.cs
+++ b/osu.Game/Overlays/FirstRunSetup/ScreenWelcome.cs
@@ -4,7 +4,6 @@
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Screens;
-using osu.Framework.Utils;
 using osu.Game.Graphics.Containers;
 using osu.Game.Screens.OnlinePlay.Match.Components;
 using osuTK;
@@ -38,7 +37,7 @@ namespace osu.Game.Overlays.FirstRunSetup
                     RelativeSizeAxes = Axes.X,
                     Margin = new MarginPadding(10),
                     Text = "Get started",
-                    Action = () => this.Push(new ScreenWelcome()),
+                    Action = () => this.Push(new ScreenSetupUIScale()),
                 }
             };
         }
@@ -46,13 +45,7 @@ namespace osu.Game.Overlays.FirstRunSetup
         public override void OnEntering(IScreen last)
         {
             base.OnEntering(last);
-            Overlay.MoveDisplayTo(new Vector2(RNG.NextSingle(), RNG.NextSingle()));
-        }
-
-        public override void OnResuming(IScreen last)
-        {
-            base.OnResuming(last);
-            Overlay.MoveDisplayTo(new Vector2(RNG.NextSingle(), RNG.NextSingle()));
+            Overlay.MoveDisplayTo(new Vector2(0.5f));
         }
     }
 }
diff --git a/osu.Game/Overlays/FirstRunSetupOverlay.cs b/osu.Game/Overlays/FirstRunSetupOverlay.cs
index 218e6018e2..1578ef8cbf 100644
--- a/osu.Game/Overlays/FirstRunSetupOverlay.cs
+++ b/osu.Game/Overlays/FirstRunSetupOverlay.cs
@@ -57,7 +57,8 @@ namespace osu.Game.Overlays
                 {
                     Origin = Anchor.Centre,
                     RelativePositionAxes = Axes.Both,
-                    Size = new Vector2(400, 300),
+                    RelativeSizeAxes = Axes.Both,
+                    Size = new Vector2(0.5f),
                     Position = new Vector2(0.5f),
                     EdgeEffect = new EdgeEffectParameters
                     {
@@ -130,5 +131,8 @@ namespace osu.Game.Overlays
 
         public void MoveDisplayTo(Vector2 position) =>
             currentDisplayContainer.MoveTo(position, 1000, Easing.OutElasticQuarter);
+
+        public void ResizeDisplayTo(Vector2 scale) =>
+            currentDisplayContainer.ScaleTo(scale, 1000, Easing.OutElasticQuarter);
     }
 }

From e064f2f23efac42cca67225d59854852edb61092 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 18 Apr 2022 15:20:54 +0900
Subject: [PATCH 4144/5547] Improve general layout and allow overlay to be
 displayed without dependencies for now

---
 .../Visual/Navigation/TestFirstRunSetup.cs    |   7 +-
 .../Overlays/FirstRunSetup/ScreenWelcome.cs   |  13 +-
 osu.Game/Overlays/FirstRunSetupOverlay.cs     | 118 ++++++++++++------
 3 files changed, 91 insertions(+), 47 deletions(-)

diff --git a/osu.Game.Tests/Visual/Navigation/TestFirstRunSetup.cs b/osu.Game.Tests/Visual/Navigation/TestFirstRunSetup.cs
index ab49334af1..9855865284 100644
--- a/osu.Game.Tests/Visual/Navigation/TestFirstRunSetup.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestFirstRunSetup.cs
@@ -2,14 +2,19 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using NUnit.Framework;
+using osu.Game.Overlays;
 
 namespace osu.Game.Tests.Visual.Navigation
 {
-    public class TestFirstRunSetup : OsuGameTestScene
+    public class TestFirstRunSetup : OsuTestScene
     {
         [Test]
         public void TestOverlay()
         {
+            AddStep("add overlay", () =>
+            {
+                Child = new FirstRunSetupOverlay();
+            });
         }
     }
 }
diff --git a/osu.Game/Overlays/FirstRunSetup/ScreenWelcome.cs b/osu.Game/Overlays/FirstRunSetup/ScreenWelcome.cs
index b436db2431..f67ab1cd7f 100644
--- a/osu.Game/Overlays/FirstRunSetup/ScreenWelcome.cs
+++ b/osu.Game/Overlays/FirstRunSetup/ScreenWelcome.cs
@@ -4,9 +4,9 @@
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Screens;
+using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Screens.OnlinePlay.Match.Components;
-using osuTK;
 
 namespace osu.Game.Overlays.FirstRunSetup
 {
@@ -22,9 +22,10 @@ namespace osu.Game.Overlays.FirstRunSetup
                     Direction = FillDirection.Vertical,
                     Children = new Drawable[]
                     {
-                        new OsuTextFlowContainer
+                        new OsuTextFlowContainer(cp => cp.Font = OsuFont.Default.With(size: 20))
                         {
-                            Text = "Welcome to the first-run setup guide!\n\nThis will help you get osu! setup in a way that suits you.",
+                            Text =
+                                "Welcome to the first-run setup guide!\n\nosu! is a very configurable game, and diving straight into the settings can sometimes be overwhelming. This guide will help you get the important choices out of the way to ensure a great first experience!",
                             RelativeSizeAxes = Axes.X,
                             AutoSizeAxes = Axes.Y
                         },
@@ -41,11 +42,5 @@ namespace osu.Game.Overlays.FirstRunSetup
                 }
             };
         }
-
-        public override void OnEntering(IScreen last)
-        {
-            base.OnEntering(last);
-            Overlay.MoveDisplayTo(new Vector2(0.5f));
-        }
     }
 }
diff --git a/osu.Game/Overlays/FirstRunSetupOverlay.cs b/osu.Game/Overlays/FirstRunSetupOverlay.cs
index 1578ef8cbf..d213f87fe5 100644
--- a/osu.Game/Overlays/FirstRunSetupOverlay.cs
+++ b/osu.Game/Overlays/FirstRunSetupOverlay.cs
@@ -11,10 +11,10 @@ using osu.Framework.Input.Events;
 using osu.Framework.Screens;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
+using osu.Game.Graphics.Sprites;
 using osu.Game.Online.API;
 using osu.Game.Overlays.Dialog;
 using osu.Game.Overlays.FirstRunSetup;
-using osu.Game.Rulesets.UI;
 using osu.Game.Screens.Menu;
 using osuTK;
 using osuTK.Graphics;
@@ -26,18 +26,17 @@ namespace osu.Game.Overlays
     {
         protected override bool StartHidden => true;
 
-        [Resolved]
+        [Resolved(canBeNull: true)]
         private DialogOverlay dialogOverlay { get; set; }
 
-        [Resolved]
+        [Resolved(canBeNull: true)]
         private OsuGame osuGame { get; set; }
 
+        [Cached]
+        private OverlayColourProvider colourProvider = new OverlayColourProvider(OverlayColourScheme.Purple);
+
         private ScreenWelcome welcomeScreen;
 
-        private Container currentDisplayContainer;
-
-        private PlayfieldBorder border;
-
         public FirstRunSetupOverlay()
         {
             RelativeSizeAxes = Axes.Both;
@@ -48,18 +47,12 @@ namespace osu.Game.Overlays
         {
             Children = new Drawable[]
             {
-                border = new PlayfieldBorder
+                new Container
                 {
-                    PlayfieldBorderStyle = { Value = PlayfieldBorderStyle.Full },
-                    Colour = colours.Blue,
-                },
-                currentDisplayContainer = new Container
-                {
-                    Origin = Anchor.Centre,
-                    RelativePositionAxes = Axes.Both,
                     RelativeSizeAxes = Axes.Both,
-                    Size = new Vector2(0.5f),
-                    Position = new Vector2(0.5f),
+                    Anchor = Anchor.Centre,
+                    Origin = Anchor.Centre,
+                    Size = new Vector2(0.95f),
                     EdgeEffect = new EdgeEffectParameters
                     {
                         Type = EdgeEffectType.Shadow,
@@ -73,12 +66,68 @@ namespace osu.Game.Overlays
                         new Box
                         {
                             RelativeSizeAxes = Axes.Both,
-                            Colour = Color4.Black,
-                            Alpha = 0.8f,
+                            Colour = colourProvider.Background5,
                         },
-                        new ScreenStack(welcomeScreen = new ScreenWelcome())
+                        new GridContainer
                         {
                             RelativeSizeAxes = Axes.Both,
+                            RowDimensions = new[]
+                            {
+                                new Dimension(GridSizeMode.AutoSize),
+                                new Dimension(),
+                            },
+                            Content = new[]
+                            {
+                                new Drawable[]
+                                {
+                                    new Container
+                                    {
+                                        RelativeSizeAxes = Axes.X,
+                                        AutoSizeAxes = Axes.Y,
+                                        Children = new Drawable[]
+                                        {
+                                            new Box
+                                            {
+                                                Colour = colourProvider.Background6,
+                                                RelativeSizeAxes = Axes.Both,
+                                            },
+                                            new FillFlowContainer
+                                            {
+                                                RelativeSizeAxes = Axes.X,
+                                                Margin = new MarginPadding(10),
+                                                AutoSizeAxes = Axes.Y,
+                                                Direction = FillDirection.Vertical,
+                                                Children = new Drawable[]
+                                                {
+                                                    new OsuSpriteText
+                                                    {
+                                                        Text = "First run setup",
+                                                        Font = OsuFont.Default.With(size: 32),
+                                                        Colour = colourProvider.Content2,
+                                                        Anchor = Anchor.TopCentre,
+                                                        Origin = Anchor.TopCentre,
+                                                    },
+                                                    new OsuTextFlowContainer
+                                                    {
+                                                        Text = "Setup osu! to suit you",
+                                                        Colour = colourProvider.Content1,
+                                                        Anchor = Anchor.TopCentre,
+                                                        Origin = Anchor.TopCentre,
+                                                        AutoSizeAxes = Axes.Both,
+                                                    },
+                                                }
+                                            },
+                                        }
+                                    },
+                                },
+                                new Drawable[]
+                                {
+                                    new ScreenStack(welcomeScreen = new ScreenWelcome())
+                                    {
+                                        RelativeSizeAxes = Axes.Both,
+                                    },
+                                }
+                            }
                         },
                     }
                 }
@@ -89,24 +138,25 @@ namespace osu.Game.Overlays
         {
             base.LoadComplete();
 
-            // if we are valid for display, only do so after reaching the main menu.
-            osuGame.PerformFromScreen(_ =>
+            if (osuGame != null)
+            {
+                // if we are valid for display, only do so after reaching the main menu.
+                osuGame.PerformFromScreen(_ =>
+                {
+                    Show();
+                }, new[] { typeof(MainMenu) });
+            }
+            else
             {
                 Show();
-            }, new[] { typeof(MainMenu) });
-
-            border
-                .FadeInFromZero(500)
-                .Delay(1000)
-                .FadeOut(500)
-                .Loop();
+            }
         }
 
         protected override bool OnClick(ClickEvent e)
         {
-            if (dialogOverlay.CurrentDialog == null)
+            if (dialogOverlay?.CurrentDialog == null)
             {
-                dialogOverlay.Push(new ConfirmDialog("Are you sure you want to exit the setup process?",
+                dialogOverlay?.Push(new ConfirmDialog("Are you sure you want to exit the setup process?",
                     Hide,
                     () => { }));
             }
@@ -128,11 +178,5 @@ namespace osu.Game.Overlays
             base.PopOut();
             this.FadeOut(100);
         }
-
-        public void MoveDisplayTo(Vector2 position) =>
-            currentDisplayContainer.MoveTo(position, 1000, Easing.OutElasticQuarter);
-
-        public void ResizeDisplayTo(Vector2 scale) =>
-            currentDisplayContainer.ScaleTo(scale, 1000, Easing.OutElasticQuarter);
     }
 }

From 3b94e01fe64ad1094e895f6822444c36b45cf042 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 18 Apr 2022 15:21:09 +0900
Subject: [PATCH 4145/5547] Improve layout of ui scale step

---
 .../FirstRunSetup/ScreenSetupUIScale.cs       | 55 ++++++++++++++-----
 1 file changed, 41 insertions(+), 14 deletions(-)

diff --git a/osu.Game/Overlays/FirstRunSetup/ScreenSetupUIScale.cs b/osu.Game/Overlays/FirstRunSetup/ScreenSetupUIScale.cs
index 7c703f65bd..1a8ef0338c 100644
--- a/osu.Game/Overlays/FirstRunSetup/ScreenSetupUIScale.cs
+++ b/osu.Game/Overlays/FirstRunSetup/ScreenSetupUIScale.cs
@@ -5,13 +5,14 @@ using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Localisation;
-using osu.Framework.Screens;
 using osu.Game.Configuration;
+using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Localisation;
 using osu.Game.Overlays.Settings;
 using osu.Game.Screens;
+using osu.Game.Screens.Menu;
 using osu.Game.Screens.OnlinePlay.Match.Components;
 using osu.Game.Screens.Select;
 using osuTK;
@@ -23,6 +24,9 @@ namespace osu.Game.Overlays.FirstRunSetup
         [Resolved]
         private OsuConfigManager osuConfig { get; set; }
 
+        [Cached]
+        private OsuLogo osuLogo = new OsuLogo();
+
         [BackgroundDependencyLoader]
         private void load()
         {
@@ -36,7 +40,7 @@ namespace osu.Game.Overlays.FirstRunSetup
                     Spacing = new Vector2(20),
                     Children = new Drawable[]
                     {
-                        new OsuTextFlowContainer
+                        new OsuTextFlowContainer(cp => cp.Font = OsuFont.Default.With(size: 32))
                         {
                             Text = "The osu! user interface size can be adjusted to your liking.",
                             RelativeSizeAxes = Axes.X,
@@ -49,12 +53,42 @@ namespace osu.Game.Overlays.FirstRunSetup
                             Current = osuConfig.GetBindable<float>(OsuSetting.UIScale),
                             KeyboardStep = 0.01f,
                         },
-                        new DrawSizePreservingFillContainer
+                        new GridContainer
                         {
-                            Masking = true,
-                            RelativeSizeAxes = Axes.X,
-                            Height = 300,
-                            Child = stack = new OsuScreenStack()
+                            RelativeSizeAxes = Axes.Both,
+                            Content = new[]
+                            {
+                                new Drawable[]
+                                {
+                                    new ScalingContainer(ScalingMode.Off)
+                                    {
+                                        Masking = true,
+                                        RelativeSizeAxes = Axes.Both,
+                                        Child = stack = new OsuScreenStack()
+                                    },
+                                    new ScalingContainer(ScalingMode.Off)
+                                    {
+                                        Masking = true,
+                                        RelativeSizeAxes = Axes.Both,
+                                        Child = stack = new OsuScreenStack()
+                                    }
+                                },
+                                new Drawable[]
+                                {
+                                    new ScalingContainer(ScalingMode.Off)
+                                    {
+                                        Masking = true,
+                                        RelativeSizeAxes = Axes.Both,
+                                        Child = stack = new OsuScreenStack()
+                                    },
+                                    new ScalingContainer(ScalingMode.Off)
+                                    {
+                                        Masking = true,
+                                        RelativeSizeAxes = Axes.Both,
+                                        Child = stack = new OsuScreenStack()
+                                    }
+                                }
+                            }
                         }
                     }
                 },
@@ -72,13 +106,6 @@ namespace osu.Game.Overlays.FirstRunSetup
             stack.Push(new PlaySongSelect());
         }
 
-        public override void OnEntering(IScreen last)
-        {
-            base.OnEntering(last);
-            Overlay.MoveDisplayTo(new Vector2(0.5f));
-            Overlay.ResizeDisplayTo(new Vector2(0.8f));
-        }
-
         private class UIScaleSlider : OsuSliderBar<float>
         {
             public override LocalisableString TooltipText => base.TooltipText + "x";

From 07da1cd731b7acf89337a066fd3ed677216c5e67 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 18 Apr 2022 16:07:30 +0900
Subject: [PATCH 4146/5547] Move buttons to top level and add backwards
 navigation

---
 .../FirstRunSetup/FirstRunSetupScreen.cs      |  28 ++--
 .../Overlays/FirstRunSetup/ScreenWelcome.cs   |  13 +-
 osu.Game/Overlays/FirstRunSetupOverlay.cs     | 128 +++++++++++++++++-
 3 files changed, 133 insertions(+), 36 deletions(-)

diff --git a/osu.Game/Overlays/FirstRunSetup/FirstRunSetupScreen.cs b/osu.Game/Overlays/FirstRunSetup/FirstRunSetupScreen.cs
index d00d21d347..5cf3d562a9 100644
--- a/osu.Game/Overlays/FirstRunSetup/FirstRunSetupScreen.cs
+++ b/osu.Game/Overlays/FirstRunSetup/FirstRunSetupScreen.cs
@@ -3,7 +3,6 @@
 
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
-using osu.Framework.Graphics.Containers;
 using osu.Framework.Input.Events;
 using osu.Framework.Screens;
 
@@ -14,38 +13,31 @@ namespace osu.Game.Overlays.FirstRunSetup
         [Resolved]
         protected FirstRunSetupOverlay Overlay { get; private set; }
 
-        protected Container Content { get; private set; }
-
-        protected FirstRunSetupScreen()
-        {
-            InternalChildren = new Drawable[]
-            {
-                Content = new Container
-                {
-                    RelativeSizeAxes = Axes.Both,
-                    Padding = new MarginPadding(20),
-                },
-            };
-        }
-
         protected override bool OnClick(ClickEvent e) => true;
 
         public override void OnEntering(IScreen last)
         {
             base.OnEntering(last);
-            this.FadeOut().Delay(200).FadeIn(200);
+            this
+                .FadeInFromZero(500)
+                .MoveToX(100)
+                .MoveToX(0, 500, Easing.OutQuint);
         }
 
         public override void OnResuming(IScreen last)
         {
             base.OnResuming(last);
-            this.FadeIn(200);
+            this
+                .FadeInFromZero(500)
+                .MoveToX(0, 500, Easing.OutQuint);
         }
 
         public override void OnSuspending(IScreen next)
         {
             base.OnSuspending(next);
-            this.FadeOut(200);
+            this
+                .FadeOut(100)
+                .MoveToX(-100, 500, Easing.OutQuint);
         }
     }
 }
diff --git a/osu.Game/Overlays/FirstRunSetup/ScreenWelcome.cs b/osu.Game/Overlays/FirstRunSetup/ScreenWelcome.cs
index f67ab1cd7f..879ffdf198 100644
--- a/osu.Game/Overlays/FirstRunSetup/ScreenWelcome.cs
+++ b/osu.Game/Overlays/FirstRunSetup/ScreenWelcome.cs
@@ -3,10 +3,8 @@
 
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
-using osu.Framework.Screens;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
-using osu.Game.Screens.OnlinePlay.Match.Components;
 
 namespace osu.Game.Overlays.FirstRunSetup
 {
@@ -14,7 +12,7 @@ namespace osu.Game.Overlays.FirstRunSetup
     {
         public ScreenWelcome()
         {
-            Content.Children = new Drawable[]
+            InternalChildren = new Drawable[]
             {
                 new FillFlowContainer
                 {
@@ -31,15 +29,6 @@ namespace osu.Game.Overlays.FirstRunSetup
                         },
                     }
                 },
-                new PurpleTriangleButton
-                {
-                    Anchor = Anchor.BottomCentre,
-                    Origin = Anchor.BottomCentre,
-                    RelativeSizeAxes = Axes.X,
-                    Margin = new MarginPadding(10),
-                    Text = "Get started",
-                    Action = () => this.Push(new ScreenSetupUIScale()),
-                }
             };
         }
     }
diff --git a/osu.Game/Overlays/FirstRunSetupOverlay.cs b/osu.Game/Overlays/FirstRunSetupOverlay.cs
index d213f87fe5..4eb46c38f3 100644
--- a/osu.Game/Overlays/FirstRunSetupOverlay.cs
+++ b/osu.Game/Overlays/FirstRunSetupOverlay.cs
@@ -1,6 +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 enable
+
+using System;
+using System.Diagnostics;
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
@@ -8,14 +12,17 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Effects;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Input.Events;
+using osu.Framework.Localisation;
 using osu.Framework.Screens;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
+using osu.Game.Graphics.UserInterface;
 using osu.Game.Online.API;
 using osu.Game.Overlays.Dialog;
 using osu.Game.Overlays.FirstRunSetup;
 using osu.Game.Screens.Menu;
+using osu.Game.Screens.OnlinePlay.Match.Components;
 using osuTK;
 using osuTK.Graphics;
 
@@ -27,15 +34,26 @@ namespace osu.Game.Overlays
         protected override bool StartHidden => true;
 
         [Resolved(canBeNull: true)]
-        private DialogOverlay dialogOverlay { get; set; }
+        private DialogOverlay? dialogOverlay { get; set; }
 
         [Resolved(canBeNull: true)]
-        private OsuGame osuGame { get; set; }
+        private OsuGame? osuGame { get; set; }
+
+        private ScreenStack stack = null!;
+
+        private PurpleTriangleButton nextButton = null!;
+        private DangerousTriangleButton backButton = null!;
 
         [Cached]
         private OverlayColourProvider colourProvider = new OverlayColourProvider(OverlayColourScheme.Purple);
 
-        private ScreenWelcome welcomeScreen;
+        private int? currentStepIndex;
+
+        private readonly FirstRunStep[] steps =
+        {
+            new FirstRunStep(typeof(ScreenWelcome), "Welcome"),
+            new FirstRunStep(typeof(ScreenSetupUIScale), "UI Scale"),
+        };
 
         public FirstRunSetupOverlay()
         {
@@ -75,6 +93,7 @@ namespace osu.Game.Overlays
                             {
                                 new Dimension(GridSizeMode.AutoSize),
                                 new Dimension(),
+                                new Dimension(GridSizeMode.AutoSize),
                             },
                             Content = new[]
                             {
@@ -122,10 +141,60 @@ namespace osu.Game.Overlays
                                 },
                                 new Drawable[]
                                 {
-                                    new ScreenStack(welcomeScreen = new ScreenWelcome())
+                                    new Container
                                     {
                                         RelativeSizeAxes = Axes.Both,
+                                        Padding = new MarginPadding(20),
+                                        Child = stack = new ScreenStack
+                                        {
+                                            RelativeSizeAxes = Axes.Both,
+                                        },
                                     },
+                                },
+                                new Drawable[]
+                                {
+                                    new Container
+                                    {
+                                        RelativeSizeAxes = Axes.X,
+                                        AutoSizeAxes = Axes.Y,
+                                        Padding = new MarginPadding(20),
+                                        Child = new GridContainer
+                                        {
+                                            RelativeSizeAxes = Axes.X,
+                                            AutoSizeAxes = Axes.Y,
+                                            ColumnDimensions = new[]
+                                            {
+                                                new Dimension(GridSizeMode.AutoSize),
+                                                new Dimension(GridSizeMode.Absolute, 10),
+                                                new Dimension(),
+                                            },
+                                            RowDimensions = new[]
+                                            {
+                                                new Dimension(GridSizeMode.AutoSize),
+                                            },
+                                            Content = new[]
+                                            {
+                                                new[]
+                                                {
+                                                    backButton = new DangerousTriangleButton
+                                                    {
+                                                        Width = 200,
+                                                        Text = "Back",
+                                                        Action = showLastStep,
+                                                        Enabled = { Value = false },
+                                                    },
+                                                    Empty(),
+                                                    nextButton = new PurpleTriangleButton
+                                                    {
+                                                        RelativeSizeAxes = Axes.X,
+                                                        Width = 1,
+                                                        Text = "Get started",
+                                                        Action = showNextStep
+                                                    }
+                                                },
+                                            }
+                                        },
+                                    }
                                 }
                             }
                         },
@@ -169,8 +238,43 @@ namespace osu.Game.Overlays
             base.PopIn();
             this.FadeIn(400, Easing.OutQuint);
 
-            if (welcomeScreen.GetChildScreen() != null)
-                welcomeScreen.MakeCurrent();
+            if (currentStepIndex == null)
+                showNextStep();
+        }
+
+        private void showLastStep()
+        {
+            Debug.Assert(currentStepIndex > 0);
+
+            stack.CurrentScreen.Exit();
+            currentStepIndex--;
+
+            backButton.Enabled.Value = currentStepIndex != 0;
+        }
+
+        private void showNextStep()
+        {
+            if (currentStepIndex == null)
+                currentStepIndex = 0;
+            else
+                currentStepIndex++;
+
+            Debug.Assert(currentStepIndex != null);
+            backButton.Enabled.Value = currentStepIndex > 0;
+
+            if (currentStepIndex < steps.Length)
+            {
+                var nextStep = steps[currentStepIndex.Value];
+                stack.Push((Screen)Activator.CreateInstance(nextStep.ScreenType));
+            }
+            else
+            {
+                Hide();
+            }
+
+            nextButton.Text = currentStepIndex + 1 < steps.Length
+                ? $"Next ({steps[currentStepIndex.Value + 1].Description})"
+                : "Finish";
         }
 
         protected override void PopOut()
@@ -178,5 +282,17 @@ namespace osu.Game.Overlays
             base.PopOut();
             this.FadeOut(100);
         }
+
+        private class FirstRunStep
+        {
+            public readonly Type ScreenType;
+            public readonly LocalisableString Description;
+
+            public FirstRunStep(Type screenType, LocalisableString description)
+            {
+                ScreenType = screenType;
+                Description = description;
+            }
+        }
     }
 }

From 288f759bb4bd8480e4157faf6e1e3d4681028299 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 18 Apr 2022 16:34:13 +0900
Subject: [PATCH 4147/5547] Add test coverage of navigation

---
 .../Visual/Navigation/TestFirstRunSetup.cs    | 20 ------
 .../TestSceneFirstRunSetupOverlay.cs          | 63 +++++++++++++++++++
 osu.Game/Overlays/FirstRunSetupOverlay.cs     | 19 +++---
 3 files changed, 75 insertions(+), 27 deletions(-)
 delete mode 100644 osu.Game.Tests/Visual/Navigation/TestFirstRunSetup.cs
 create mode 100644 osu.Game.Tests/Visual/Navigation/TestSceneFirstRunSetupOverlay.cs

diff --git a/osu.Game.Tests/Visual/Navigation/TestFirstRunSetup.cs b/osu.Game.Tests/Visual/Navigation/TestFirstRunSetup.cs
deleted file mode 100644
index 9855865284..0000000000
--- a/osu.Game.Tests/Visual/Navigation/TestFirstRunSetup.cs
+++ /dev/null
@@ -1,20 +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.Game.Overlays;
-
-namespace osu.Game.Tests.Visual.Navigation
-{
-    public class TestFirstRunSetup : OsuTestScene
-    {
-        [Test]
-        public void TestOverlay()
-        {
-            AddStep("add overlay", () =>
-            {
-                Child = new FirstRunSetupOverlay();
-            });
-        }
-    }
-}
diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneFirstRunSetupOverlay.cs b/osu.Game.Tests/Visual/Navigation/TestSceneFirstRunSetupOverlay.cs
new file mode 100644
index 0000000000..c9aba315eb
--- /dev/null
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneFirstRunSetupOverlay.cs
@@ -0,0 +1,63 @@
+// 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.Containers;
+using osu.Framework.Testing;
+using osu.Game.Overlays;
+using osu.Game.Overlays.FirstRunSetup;
+
+namespace osu.Game.Tests.Visual.Navigation
+{
+    public class TestSceneFirstRunSetupOverlay : OsuTestScene
+    {
+        private FirstRunSetupOverlay overlay;
+
+        [SetUpSteps]
+        public void SetUpSteps()
+        {
+            AddStep("add overlay", () =>
+            {
+                Child = overlay = new FirstRunSetupOverlay();
+            });
+        }
+
+        [Test]
+        public void TestOverlayRunsToFinish()
+        {
+            AddUntilStep("step through", () =>
+            {
+                if (overlay.CurrentScreen?.IsLoaded != false)
+                    overlay.NextButton.TriggerClick();
+
+                return overlay.State.Value == Visibility.Hidden;
+            });
+        }
+
+        [Test]
+        public void TestBackButton()
+        {
+            AddAssert("back button disabled", () => !overlay.BackButton.Enabled.Value);
+
+            AddUntilStep("step to last", () =>
+            {
+                var nextButton = overlay.NextButton;
+
+                if (overlay.CurrentScreen?.IsLoaded != false)
+                    nextButton.TriggerClick();
+
+                return nextButton.Text.ToString() == "Finish";
+            });
+
+            AddUntilStep("step back to start", () =>
+            {
+                if (overlay.CurrentScreen?.IsLoaded != false)
+                    overlay.BackButton.TriggerClick();
+
+                return overlay.CurrentScreen is ScreenWelcome;
+            });
+
+            AddAssert("back button disabled", () => !overlay.BackButton.Enabled.Value);
+        }
+    }
+}
diff --git a/osu.Game/Overlays/FirstRunSetupOverlay.cs b/osu.Game/Overlays/FirstRunSetupOverlay.cs
index 4eb46c38f3..bd6cb0b4d7 100644
--- a/osu.Game/Overlays/FirstRunSetupOverlay.cs
+++ b/osu.Game/Overlays/FirstRunSetupOverlay.cs
@@ -41,14 +41,19 @@ namespace osu.Game.Overlays
 
         private ScreenStack stack = null!;
 
-        private PurpleTriangleButton nextButton = null!;
-        private DangerousTriangleButton backButton = null!;
+        public PurpleTriangleButton NextButton = null!;
+        public DangerousTriangleButton BackButton = null!;
 
         [Cached]
         private OverlayColourProvider colourProvider = new OverlayColourProvider(OverlayColourScheme.Purple);
 
         private int? currentStepIndex;
 
+        /// <summary>
+        /// The currently displayed screen, if any.
+        /// </summary>
+        public FirstRunSetupScreen? CurrentScreen => (FirstRunSetupScreen?)stack.CurrentScreen;
+
         private readonly FirstRunStep[] steps =
         {
             new FirstRunStep(typeof(ScreenWelcome), "Welcome"),
@@ -176,7 +181,7 @@ namespace osu.Game.Overlays
                                             {
                                                 new[]
                                                 {
-                                                    backButton = new DangerousTriangleButton
+                                                    BackButton = new DangerousTriangleButton
                                                     {
                                                         Width = 200,
                                                         Text = "Back",
@@ -184,7 +189,7 @@ namespace osu.Game.Overlays
                                                         Enabled = { Value = false },
                                                     },
                                                     Empty(),
-                                                    nextButton = new PurpleTriangleButton
+                                                    NextButton = new PurpleTriangleButton
                                                     {
                                                         RelativeSizeAxes = Axes.X,
                                                         Width = 1,
@@ -249,7 +254,7 @@ namespace osu.Game.Overlays
             stack.CurrentScreen.Exit();
             currentStepIndex--;
 
-            backButton.Enabled.Value = currentStepIndex != 0;
+            BackButton.Enabled.Value = currentStepIndex != 0;
         }
 
         private void showNextStep()
@@ -260,7 +265,7 @@ namespace osu.Game.Overlays
                 currentStepIndex++;
 
             Debug.Assert(currentStepIndex != null);
-            backButton.Enabled.Value = currentStepIndex > 0;
+            BackButton.Enabled.Value = currentStepIndex > 0;
 
             if (currentStepIndex < steps.Length)
             {
@@ -272,7 +277,7 @@ namespace osu.Game.Overlays
                 Hide();
             }
 
-            nextButton.Text = currentStepIndex + 1 < steps.Length
+            NextButton.Text = currentStepIndex + 1 < steps.Length
                 ? $"Next ({steps[currentStepIndex.Value + 1].Description})"
                 : "Finish";
         }

From 56c4283764752f6a1eb2282df17e2db40196c794 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 18 Apr 2022 17:10:08 +0900
Subject: [PATCH 4148/5547] Only exit dialog from click if outside the dialog
 content

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

diff --git a/osu.Game/Overlays/FirstRunSetupOverlay.cs b/osu.Game/Overlays/FirstRunSetupOverlay.cs
index bd6cb0b4d7..0efeded062 100644
--- a/osu.Game/Overlays/FirstRunSetupOverlay.cs
+++ b/osu.Game/Overlays/FirstRunSetupOverlay.cs
@@ -60,6 +60,8 @@ namespace osu.Game.Overlays
             new FirstRunStep(typeof(ScreenSetupUIScale), "UI Scale"),
         };
 
+        private Container mainContent;
+
         public FirstRunSetupOverlay()
         {
             RelativeSizeAxes = Axes.Both;
@@ -70,7 +72,7 @@ namespace osu.Game.Overlays
         {
             Children = new Drawable[]
             {
-                new Container
+                mainContent = new Container
                 {
                     RelativeSizeAxes = Axes.Both,
                     Anchor = Anchor.Centre,
@@ -228,7 +230,7 @@ namespace osu.Game.Overlays
 
         protected override bool OnClick(ClickEvent e)
         {
-            if (dialogOverlay?.CurrentDialog == null)
+            if (!mainContent.IsHovered && dialogOverlay?.CurrentDialog == null)
             {
                 dialogOverlay?.Push(new ConfirmDialog("Are you sure you want to exit the setup process?",
                     Hide,

From ea52fab5b1202268f43fadeb9f47cb7c516e3717 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 18 Apr 2022 18:58:14 +0900
Subject: [PATCH 4149/5547] Tidy up dependencies and test naming

---
 .../TestSceneFirstRunSetupOverlay.cs          |  63 --------
 .../TestSceneFirstRunScreenUIScale.cs         |  19 +++
 .../TestSceneFirstRunSetupOverlay.cs          | 111 +++++++++++++
 .../FirstRunSetup/FirstRunSetupScreen.cs      |  25 +--
 .../FirstRunSetup/ScreenSetupUIScale.cs       | 114 --------------
 .../Overlays/FirstRunSetup/ScreenUIScale.cs   | 146 ++++++++++++++++++
 osu.Game/Overlays/FirstRunSetupOverlay.cs     |  38 ++---
 7 files changed, 304 insertions(+), 212 deletions(-)
 delete mode 100644 osu.Game.Tests/Visual/Navigation/TestSceneFirstRunSetupOverlay.cs
 create mode 100644 osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunScreenUIScale.cs
 create mode 100644 osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunSetupOverlay.cs
 delete mode 100644 osu.Game/Overlays/FirstRunSetup/ScreenSetupUIScale.cs
 create mode 100644 osu.Game/Overlays/FirstRunSetup/ScreenUIScale.cs

diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneFirstRunSetupOverlay.cs b/osu.Game.Tests/Visual/Navigation/TestSceneFirstRunSetupOverlay.cs
deleted file mode 100644
index c9aba315eb..0000000000
--- a/osu.Game.Tests/Visual/Navigation/TestSceneFirstRunSetupOverlay.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 NUnit.Framework;
-using osu.Framework.Graphics.Containers;
-using osu.Framework.Testing;
-using osu.Game.Overlays;
-using osu.Game.Overlays.FirstRunSetup;
-
-namespace osu.Game.Tests.Visual.Navigation
-{
-    public class TestSceneFirstRunSetupOverlay : OsuTestScene
-    {
-        private FirstRunSetupOverlay overlay;
-
-        [SetUpSteps]
-        public void SetUpSteps()
-        {
-            AddStep("add overlay", () =>
-            {
-                Child = overlay = new FirstRunSetupOverlay();
-            });
-        }
-
-        [Test]
-        public void TestOverlayRunsToFinish()
-        {
-            AddUntilStep("step through", () =>
-            {
-                if (overlay.CurrentScreen?.IsLoaded != false)
-                    overlay.NextButton.TriggerClick();
-
-                return overlay.State.Value == Visibility.Hidden;
-            });
-        }
-
-        [Test]
-        public void TestBackButton()
-        {
-            AddAssert("back button disabled", () => !overlay.BackButton.Enabled.Value);
-
-            AddUntilStep("step to last", () =>
-            {
-                var nextButton = overlay.NextButton;
-
-                if (overlay.CurrentScreen?.IsLoaded != false)
-                    nextButton.TriggerClick();
-
-                return nextButton.Text.ToString() == "Finish";
-            });
-
-            AddUntilStep("step back to start", () =>
-            {
-                if (overlay.CurrentScreen?.IsLoaded != false)
-                    overlay.BackButton.TriggerClick();
-
-                return overlay.CurrentScreen is ScreenWelcome;
-            });
-
-            AddAssert("back button disabled", () => !overlay.BackButton.Enabled.Value);
-        }
-    }
-}
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunScreenUIScale.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunScreenUIScale.cs
new file mode 100644
index 0000000000..5ca09b34aa
--- /dev/null
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunScreenUIScale.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.Screens;
+using osu.Game.Overlays.FirstRunSetup;
+
+namespace osu.Game.Tests.Visual.UserInterface
+{
+    public class TestSceneFirstRunScreenUIScale : OsuManualInputManagerTestScene
+    {
+        public TestSceneFirstRunScreenUIScale()
+        {
+            AddStep("load screen", () =>
+            {
+                Child = new ScreenStack(new ScreenUIScale());
+            });
+        }
+    }
+}
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunSetupOverlay.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunSetupOverlay.cs
new file mode 100644
index 0000000000..d892301a81
--- /dev/null
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunSetupOverlay.cs
@@ -0,0 +1,111 @@
+// 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 Moq;
+using NUnit.Framework;
+using osu.Framework.Allocation;
+using osu.Framework.Graphics.Containers;
+using osu.Framework.Screens;
+using osu.Framework.Testing;
+using osu.Game.Overlays;
+using osu.Game.Overlays.Dialog;
+using osu.Game.Overlays.FirstRunSetup;
+using osu.Game.Screens;
+using osuTK;
+using osuTK.Input;
+
+namespace osu.Game.Tests.Visual.UserInterface
+{
+    public class TestSceneFirstRunSetupOverlay : OsuManualInputManagerTestScene
+    {
+        private FirstRunSetupOverlay overlay;
+
+        private readonly Mock<IPerformFromScreenRunner> perfomer = new Mock<IPerformFromScreenRunner>();
+        private readonly Mock<IDialogOverlay> dialogOverlay = new Mock<IDialogOverlay>();
+
+        [BackgroundDependencyLoader]
+        private void load()
+        {
+            Dependencies.CacheAs(perfomer.Object);
+            Dependencies.CacheAs(dialogOverlay.Object);
+
+            perfomer.Setup(g => g.PerformFromScreen(It.IsAny<Action<IScreen>>(), It.IsAny<IEnumerable<Type>>()))
+                    .Callback((Action<IScreen> action, IEnumerable<Type> types) => action(null));
+
+            dialogOverlay.Setup(d => d.Push(It.IsAny<PopupDialog>()))
+                         .Callback((PopupDialog dialog) => dialog.PerformOkAction());
+        }
+
+        [SetUpSteps]
+        public void SetUpSteps()
+        {
+            AddStep("add overlay", () =>
+            {
+                Child = overlay = new FirstRunSetupOverlay
+                {
+                    State = { Value = Visibility.Visible }
+                };
+            });
+        }
+
+        [Test]
+        public void TestOverlayRunsToFinish()
+        {
+            AddUntilStep("step through", () =>
+            {
+                if (overlay.CurrentScreen?.IsLoaded != false)
+                    overlay.NextButton.TriggerClick();
+
+                return overlay.State.Value == Visibility.Hidden;
+            });
+        }
+
+        [Test]
+        public void TestBackButton()
+        {
+            AddAssert("back button disabled", () => !overlay.BackButton.Enabled.Value);
+
+            AddUntilStep("step to last", () =>
+            {
+                var nextButton = overlay.NextButton;
+
+                if (overlay.CurrentScreen?.IsLoaded != false)
+                    nextButton.TriggerClick();
+
+                return nextButton.Text.ToString() == "Finish";
+            });
+
+            AddUntilStep("step back to start", () =>
+            {
+                if (overlay.CurrentScreen?.IsLoaded != false)
+                    overlay.BackButton.TriggerClick();
+
+                return overlay.CurrentScreen is ScreenWelcome;
+            });
+
+            AddAssert("back button disabled", () => !overlay.BackButton.Enabled.Value);
+        }
+
+        [Test]
+        public void TestClickAwayToExit()
+        {
+            AddStep("click inside content", () =>
+            {
+                InputManager.MoveMouseTo(overlay.ScreenSpaceDrawQuad.Centre);
+                InputManager.Click(MouseButton.Left);
+            });
+
+            AddAssert("overlay not dismissed", () => overlay.State.Value == Visibility.Visible);
+
+            AddStep("click outside content", () =>
+            {
+                InputManager.MoveMouseTo(overlay.ScreenSpaceDrawQuad.TopLeft - new Vector2(1));
+                InputManager.Click(MouseButton.Left);
+            });
+
+            AddAssert("overlay dismissed", () => overlay.State.Value == Visibility.Hidden);
+        }
+    }
+}
diff --git a/osu.Game/Overlays/FirstRunSetup/FirstRunSetupScreen.cs b/osu.Game/Overlays/FirstRunSetup/FirstRunSetupScreen.cs
index 5cf3d562a9..2d025d46ef 100644
--- a/osu.Game/Overlays/FirstRunSetup/FirstRunSetupScreen.cs
+++ b/osu.Game/Overlays/FirstRunSetup/FirstRunSetupScreen.cs
@@ -1,26 +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.Allocation;
 using osu.Framework.Graphics;
-using osu.Framework.Input.Events;
 using osu.Framework.Screens;
 
 namespace osu.Game.Overlays.FirstRunSetup
 {
     public abstract class FirstRunSetupScreen : Screen
     {
-        [Resolved]
-        protected FirstRunSetupOverlay Overlay { get; private set; }
-
-        protected override bool OnClick(ClickEvent e) => true;
+        private const float offset = 100;
 
         public override void OnEntering(IScreen last)
         {
             base.OnEntering(last);
             this
                 .FadeInFromZero(500)
-                .MoveToX(100)
+                .MoveToX(offset)
                 .MoveToX(0, 500, Easing.OutQuint);
         }
 
@@ -32,12 +27,22 @@ namespace osu.Game.Overlays.FirstRunSetup
                 .MoveToX(0, 500, Easing.OutQuint);
         }
 
-        public override void OnSuspending(IScreen next)
+        public override bool OnExiting(IScreen next)
         {
-            base.OnSuspending(next);
             this
                 .FadeOut(100)
-                .MoveToX(-100, 500, Easing.OutQuint);
+                .MoveToX(offset, 500, Easing.OutQuint);
+
+            return base.OnExiting(next);
+        }
+
+        public override void OnSuspending(IScreen next)
+        {
+            this
+                .FadeOut(100)
+                .MoveToX(-offset, 500, Easing.OutQuint);
+
+            base.OnSuspending(next);
         }
     }
 }
diff --git a/osu.Game/Overlays/FirstRunSetup/ScreenSetupUIScale.cs b/osu.Game/Overlays/FirstRunSetup/ScreenSetupUIScale.cs
deleted file mode 100644
index 1a8ef0338c..0000000000
--- a/osu.Game/Overlays/FirstRunSetup/ScreenSetupUIScale.cs
+++ /dev/null
@@ -1,114 +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.Graphics;
-using osu.Framework.Graphics.Containers;
-using osu.Framework.Localisation;
-using osu.Game.Configuration;
-using osu.Game.Graphics;
-using osu.Game.Graphics.Containers;
-using osu.Game.Graphics.UserInterface;
-using osu.Game.Localisation;
-using osu.Game.Overlays.Settings;
-using osu.Game.Screens;
-using osu.Game.Screens.Menu;
-using osu.Game.Screens.OnlinePlay.Match.Components;
-using osu.Game.Screens.Select;
-using osuTK;
-
-namespace osu.Game.Overlays.FirstRunSetup
-{
-    public class ScreenSetupUIScale : FirstRunSetupScreen
-    {
-        [Resolved]
-        private OsuConfigManager osuConfig { get; set; }
-
-        [Cached]
-        private OsuLogo osuLogo = new OsuLogo();
-
-        [BackgroundDependencyLoader]
-        private void load()
-        {
-            OsuScreenStack stack;
-            Content.Children = new Drawable[]
-            {
-                new FillFlowContainer
-                {
-                    RelativeSizeAxes = Axes.Both,
-                    Direction = FillDirection.Vertical,
-                    Spacing = new Vector2(20),
-                    Children = new Drawable[]
-                    {
-                        new OsuTextFlowContainer(cp => cp.Font = OsuFont.Default.With(size: 32))
-                        {
-                            Text = "The osu! user interface size can be adjusted to your liking.",
-                            RelativeSizeAxes = Axes.X,
-                            AutoSizeAxes = Axes.Y
-                        },
-                        new SettingsSlider<float, UIScaleSlider>
-                        {
-                            LabelText = GraphicsSettingsStrings.UIScaling,
-                            TransferValueOnCommit = true,
-                            Current = osuConfig.GetBindable<float>(OsuSetting.UIScale),
-                            KeyboardStep = 0.01f,
-                        },
-                        new GridContainer
-                        {
-                            RelativeSizeAxes = Axes.Both,
-                            Content = new[]
-                            {
-                                new Drawable[]
-                                {
-                                    new ScalingContainer(ScalingMode.Off)
-                                    {
-                                        Masking = true,
-                                        RelativeSizeAxes = Axes.Both,
-                                        Child = stack = new OsuScreenStack()
-                                    },
-                                    new ScalingContainer(ScalingMode.Off)
-                                    {
-                                        Masking = true,
-                                        RelativeSizeAxes = Axes.Both,
-                                        Child = stack = new OsuScreenStack()
-                                    }
-                                },
-                                new Drawable[]
-                                {
-                                    new ScalingContainer(ScalingMode.Off)
-                                    {
-                                        Masking = true,
-                                        RelativeSizeAxes = Axes.Both,
-                                        Child = stack = new OsuScreenStack()
-                                    },
-                                    new ScalingContainer(ScalingMode.Off)
-                                    {
-                                        Masking = true,
-                                        RelativeSizeAxes = Axes.Both,
-                                        Child = stack = new OsuScreenStack()
-                                    }
-                                }
-                            }
-                        }
-                    }
-                },
-                new PurpleTriangleButton
-                {
-                    Anchor = Anchor.BottomCentre,
-                    Origin = Anchor.BottomCentre,
-                    RelativeSizeAxes = Axes.X,
-                    Margin = new MarginPadding(10),
-                    Text = "Finish",
-                    Action = () => Overlay.Hide()
-                }
-            };
-
-            stack.Push(new PlaySongSelect());
-        }
-
-        private class UIScaleSlider : OsuSliderBar<float>
-        {
-            public override LocalisableString TooltipText => base.TooltipText + "x";
-        }
-    }
-}
diff --git a/osu.Game/Overlays/FirstRunSetup/ScreenUIScale.cs b/osu.Game/Overlays/FirstRunSetup/ScreenUIScale.cs
new file mode 100644
index 0000000000..5070856087
--- /dev/null
+++ b/osu.Game/Overlays/FirstRunSetup/ScreenUIScale.cs
@@ -0,0 +1,146 @@
+// 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.Localisation;
+using osu.Framework.Screens;
+using osu.Game.Configuration;
+using osu.Game.Graphics;
+using osu.Game.Graphics.Containers;
+using osu.Game.Graphics.UserInterface;
+using osu.Game.Localisation;
+using osu.Game.Overlays.Settings;
+using osu.Game.Screens;
+using osu.Game.Screens.Menu;
+using osu.Game.Screens.Select;
+using osu.Game.Tests.Visual;
+using osuTK;
+
+namespace osu.Game.Overlays.FirstRunSetup
+{
+    public class ScreenUIScale : FirstRunSetupScreen
+    {
+        [Resolved]
+        private OsuConfigManager osuConfig { get; set; }
+
+        [BackgroundDependencyLoader]
+        private void load()
+        {
+            InternalChildren = new Drawable[]
+            {
+                new GridContainer
+                {
+                    RelativeSizeAxes = Axes.Both,
+                    RowDimensions = new[]
+                    {
+                        new Dimension(GridSizeMode.AutoSize),
+                        new Dimension()
+                    },
+                    Content = new[]
+                    {
+                        new Drawable[]
+                        {
+                            new FillFlowContainer
+                            {
+                                RelativeSizeAxes = Axes.X,
+                                AutoSizeAxes = Axes.Y,
+                                Direction = FillDirection.Vertical,
+                                Spacing = new Vector2(20),
+                                Children = new Drawable[]
+                                {
+                                    new OsuTextFlowContainer(cp => cp.Font = OsuFont.Default.With(size: 24))
+                                    {
+                                        Text = "The osu! user interface size can be adjusted to your liking.",
+                                        RelativeSizeAxes = Axes.X,
+                                        AutoSizeAxes = Axes.Y
+                                    },
+                                    new SettingsSlider<float, UIScaleSlider>
+                                    {
+                                        LabelText = GraphicsSettingsStrings.UIScaling,
+                                        Current = osuConfig.GetBindable<float>(OsuSetting.UIScale),
+                                        KeyboardStep = 0.01f,
+                                    },
+                                }
+                            }
+                        },
+                        new Drawable[]
+                        {
+                            new GridContainer
+                            {
+                                RelativeSizeAxes = Axes.Both,
+                                Content = new[]
+                                {
+                                    new Drawable[]
+                                    {
+                                        new SampleScreenContainer(new MainMenu()),
+                                        new SampleScreenContainer(new PlaySongSelect()),
+                                    },
+                                    new Drawable[]
+                                    {
+                                        new SampleScreenContainer(new MainMenu()),
+                                        new SampleScreenContainer(new MainMenu()),
+                                    }
+                                }
+                            }
+                        },
+                    }
+                }
+            };
+        }
+
+        private class SampleScreenContainer : CompositeDrawable
+        {
+            public override bool HandlePositionalInput => false;
+            public override bool HandleNonPositionalInput => false;
+            public override bool PropagatePositionalInputSubTree => false;
+            public override bool PropagateNonPositionalInputSubTree => false;
+
+            public SampleScreenContainer(Screen screen)
+            {
+                OsuScreenStack stack;
+                RelativeSizeAxes = Axes.Both;
+
+                OsuLogo logo;
+
+                InternalChildren = new Drawable[]
+                {
+                    new DependencyProvidingContainer
+                    {
+                        CachedDependencies = new (Type, object)[]
+                        {
+                            (typeof(OsuLogo), logo = new OsuLogo
+                            {
+                                RelativePositionAxes = Axes.Both,
+                                Position = new Vector2(0.5f),
+                            })
+                        },
+                        RelativeSizeAxes = Axes.Both,
+                        Children = new Drawable[]
+                        {
+                            new ScalingContainer(ScalingMode.Off)
+                            {
+                                Masking = true,
+                                RelativeSizeAxes = Axes.Both,
+                                Children = new Drawable[]
+                                {
+                                    stack = new OsuScreenStack(),
+                                    logo
+                                },
+                            },
+                        }
+                    },
+                };
+
+                stack.Push(screen);
+            }
+        }
+
+        private class UIScaleSlider : OsuSliderBar<float>
+        {
+            public override LocalisableString TooltipText => base.TooltipText + "x";
+        }
+    }
+}
diff --git a/osu.Game/Overlays/FirstRunSetupOverlay.cs b/osu.Game/Overlays/FirstRunSetupOverlay.cs
index 0efeded062..b391f71437 100644
--- a/osu.Game/Overlays/FirstRunSetupOverlay.cs
+++ b/osu.Game/Overlays/FirstRunSetupOverlay.cs
@@ -21,6 +21,7 @@ using osu.Game.Graphics.UserInterface;
 using osu.Game.Online.API;
 using osu.Game.Overlays.Dialog;
 using osu.Game.Overlays.FirstRunSetup;
+using osu.Game.Screens;
 using osu.Game.Screens.Menu;
 using osu.Game.Screens.OnlinePlay.Match.Components;
 using osuTK;
@@ -33,16 +34,17 @@ namespace osu.Game.Overlays
     {
         protected override bool StartHidden => true;
 
-        [Resolved(canBeNull: true)]
-        private DialogOverlay? dialogOverlay { get; set; }
+        [Resolved]
+        private IDialogOverlay dialogOverlay { get; set; } = null!;
 
-        [Resolved(canBeNull: true)]
-        private OsuGame? osuGame { get; set; }
+        [Resolved]
+        private IPerformFromScreenRunner performer { get; set; } = null!;
 
         private ScreenStack stack = null!;
 
         public PurpleTriangleButton NextButton = null!;
         public DangerousTriangleButton BackButton = null!;
+        private Container mainContent = null!;
 
         [Cached]
         private OverlayColourProvider colourProvider = new OverlayColourProvider(OverlayColourScheme.Purple);
@@ -57,11 +59,9 @@ namespace osu.Game.Overlays
         private readonly FirstRunStep[] steps =
         {
             new FirstRunStep(typeof(ScreenWelcome), "Welcome"),
-            new FirstRunStep(typeof(ScreenSetupUIScale), "UI Scale"),
+            new FirstRunStep(typeof(ScreenUIScale), "UI Scale"),
         };
 
-        private Container mainContent;
-
         public FirstRunSetupOverlay()
         {
             RelativeSizeAxes = Axes.Both;
@@ -91,7 +91,7 @@ namespace osu.Game.Overlays
                         new Box
                         {
                             RelativeSizeAxes = Axes.Both,
-                            Colour = colourProvider.Background5,
+                            Colour = colourProvider.Background6,
                         },
                         new GridContainer
                         {
@@ -114,7 +114,7 @@ namespace osu.Game.Overlays
                                         {
                                             new Box
                                             {
-                                                Colour = colourProvider.Background6,
+                                                Colour = colourProvider.Background5,
                                                 RelativeSizeAxes = Axes.Both,
                                             },
                                             new FillFlowContainer
@@ -214,27 +214,15 @@ namespace osu.Game.Overlays
         {
             base.LoadComplete();
 
-            if (osuGame != null)
-            {
-                // if we are valid for display, only do so after reaching the main menu.
-                osuGame.PerformFromScreen(_ =>
-                {
-                    Show();
-                }, new[] { typeof(MainMenu) });
-            }
-            else
-            {
-                Show();
-            }
+            // if we are valid for display, only do so after reaching the main menu.
+            performer.PerformFromScreen(_ => { Show(); }, new[] { typeof(MainMenu) });
         }
 
         protected override bool OnClick(ClickEvent e)
         {
-            if (!mainContent.IsHovered && dialogOverlay?.CurrentDialog == null)
+            if (!mainContent.IsHovered && dialogOverlay.CurrentDialog == null)
             {
-                dialogOverlay?.Push(new ConfirmDialog("Are you sure you want to exit the setup process?",
-                    Hide,
-                    () => { }));
+                dialogOverlay.Push(new ConfirmDialog("Are you sure you want to exit the setup process?", Hide, () => { }));
             }
 
             return base.OnClick(e);

From 11395c40b7e4586c7c3c1030bc7e36d9e51ac5d3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 18 Apr 2022 18:58:24 +0900
Subject: [PATCH 4150/5547] Add button to access first run setup on demand

---
 osu.Game/Overlays/Settings/Sections/GeneralSection.cs | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/osu.Game/Overlays/Settings/Sections/GeneralSection.cs b/osu.Game/Overlays/Settings/Sections/GeneralSection.cs
index 87e9f34833..786db85bbf 100644
--- a/osu.Game/Overlays/Settings/Sections/GeneralSection.cs
+++ b/osu.Game/Overlays/Settings/Sections/GeneralSection.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.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Localisation;
@@ -11,6 +12,9 @@ namespace osu.Game.Overlays.Settings.Sections
 {
     public class GeneralSection : SettingsSection
     {
+        [Resolved(CanBeNull = true)]
+        private FirstRunSetupOverlay firstRunSetupOverlay { get; set; }
+
         public override LocalisableString Header => GeneralSettingsStrings.GeneralSectionHeader;
 
         public override Drawable CreateIcon() => new SpriteIcon
@@ -22,6 +26,11 @@ namespace osu.Game.Overlays.Settings.Sections
         {
             Children = new Drawable[]
             {
+                new SettingsButton
+                {
+                    Text = "Run setup wizard",
+                    Action = () => firstRunSetupOverlay?.Show(),
+                },
                 new LanguageSettings(),
                 new UpdateSettings(),
             };

From 671662144443d40ef313773a6674c7c5dc741f73 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 18 Apr 2022 19:06:13 +0900
Subject: [PATCH 4151/5547] Re-fix clicking inside display also dismissing

---
 osu.Game/Overlays/FirstRunSetupOverlay.cs | 15 ++++++++-------
 1 file changed, 8 insertions(+), 7 deletions(-)

diff --git a/osu.Game/Overlays/FirstRunSetupOverlay.cs b/osu.Game/Overlays/FirstRunSetupOverlay.cs
index b391f71437..d7fd7ed104 100644
--- a/osu.Game/Overlays/FirstRunSetupOverlay.cs
+++ b/osu.Game/Overlays/FirstRunSetupOverlay.cs
@@ -18,7 +18,6 @@ using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.UserInterface;
-using osu.Game.Online.API;
 using osu.Game.Overlays.Dialog;
 using osu.Game.Overlays.FirstRunSetup;
 using osu.Game.Screens;
@@ -68,11 +67,11 @@ namespace osu.Game.Overlays
         }
 
         [BackgroundDependencyLoader]
-        private void load(IAPIProvider api, OsuColour colours)
+        private void load()
         {
             Children = new Drawable[]
             {
-                mainContent = new Container
+                mainContent = new BlockingContainer
                 {
                     RelativeSizeAxes = Axes.Both,
                     Anchor = Anchor.Centre,
@@ -210,6 +209,11 @@ namespace osu.Game.Overlays
             };
         }
 
+        private class BlockingContainer : Container
+        {
+            protected override bool OnMouseDown(MouseDownEvent e) => true;
+        }
+
         protected override void LoadComplete()
         {
             base.LoadComplete();
@@ -220,10 +224,7 @@ namespace osu.Game.Overlays
 
         protected override bool OnClick(ClickEvent e)
         {
-            if (!mainContent.IsHovered && dialogOverlay.CurrentDialog == null)
-            {
-                dialogOverlay.Push(new ConfirmDialog("Are you sure you want to exit the setup process?", Hide, () => { }));
-            }
+            dialogOverlay.Push(new ConfirmDialog("Are you sure you want to exit the setup process?", Hide, () => { }));
 
             return base.OnClick(e);
         }

From fb7dc895036aae174fa77f10189b253eebb6f8a9 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 18 Apr 2022 19:08:34 +0900
Subject: [PATCH 4152/5547] Ensure wizard returns to initial screen after
 completion

---
 .../UserInterface/TestSceneFirstRunSetupOverlay.cs       | 4 ++++
 osu.Game/Overlays/FirstRunSetupOverlay.cs                | 9 +++++----
 2 files changed, 9 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunSetupOverlay.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunSetupOverlay.cs
index d892301a81..d22dd260eb 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunSetupOverlay.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunSetupOverlay.cs
@@ -60,6 +60,10 @@ namespace osu.Game.Tests.Visual.UserInterface
 
                 return overlay.State.Value == Visibility.Hidden;
             });
+
+            AddStep("display again on demand", () => overlay.Show());
+
+            AddUntilStep("back at start", () => overlay.CurrentScreen is ScreenWelcome);
         }
 
         [Test]
diff --git a/osu.Game/Overlays/FirstRunSetupOverlay.cs b/osu.Game/Overlays/FirstRunSetupOverlay.cs
index d7fd7ed104..0c800888ee 100644
--- a/osu.Game/Overlays/FirstRunSetupOverlay.cs
+++ b/osu.Game/Overlays/FirstRunSetupOverlay.cs
@@ -262,15 +262,16 @@ namespace osu.Game.Overlays
             {
                 var nextStep = steps[currentStepIndex.Value];
                 stack.Push((Screen)Activator.CreateInstance(nextStep.ScreenType));
+
+                NextButton.Text = currentStepIndex + 1 < steps.Length
+                    ? $"Next ({steps[currentStepIndex.Value + 1].Description})"
+                    : "Finish";
             }
             else
             {
                 Hide();
+                currentStepIndex = null;
             }
-
-            NextButton.Text = currentStepIndex + 1 < steps.Length
-                ? $"Next ({steps[currentStepIndex.Value + 1].Description})"
-                : "Finish";
         }
 
         protected override void PopOut()

From 3ea4eabdb6aba9f384ae376b062a452dcbea3c46 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 18 Apr 2022 19:18:13 +0900
Subject: [PATCH 4153/5547] Ensure button text is updated on going backwards

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

diff --git a/osu.Game/Overlays/FirstRunSetupOverlay.cs b/osu.Game/Overlays/FirstRunSetupOverlay.cs
index 0c800888ee..abde9636ba 100644
--- a/osu.Game/Overlays/FirstRunSetupOverlay.cs
+++ b/osu.Game/Overlays/FirstRunSetupOverlay.cs
@@ -246,6 +246,8 @@ namespace osu.Game.Overlays
             currentStepIndex--;
 
             BackButton.Enabled.Value = currentStepIndex != 0;
+
+            updateButtonText();
         }
 
         private void showNextStep()
@@ -260,12 +262,8 @@ namespace osu.Game.Overlays
 
             if (currentStepIndex < steps.Length)
             {
-                var nextStep = steps[currentStepIndex.Value];
-                stack.Push((Screen)Activator.CreateInstance(nextStep.ScreenType));
-
-                NextButton.Text = currentStepIndex + 1 < steps.Length
-                    ? $"Next ({steps[currentStepIndex.Value + 1].Description})"
-                    : "Finish";
+                stack.Push((Screen)Activator.CreateInstance(steps[currentStepIndex.Value].ScreenType));
+                updateButtonText();
             }
             else
             {
@@ -274,6 +272,15 @@ namespace osu.Game.Overlays
             }
         }
 
+        private void updateButtonText()
+        {
+            Debug.Assert(currentStepIndex != null);
+
+            NextButton.Text = currentStepIndex + 1 < steps.Length
+                ? $"Next ({steps[currentStepIndex.Value + 1].Description})"
+                : "Finish";
+        }
+
         protected override void PopOut()
         {
             base.PopOut();

From 8bfa59d12f6165f7f30cca862264b9d84c73bd41 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 18 Apr 2022 19:35:09 +0900
Subject: [PATCH 4154/5547] Ensure all other dialogs and overlays are dismissed
 when the first run wizard is shown

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

diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index 52aa6b8f07..7aa488d7a8 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -844,7 +844,7 @@ namespace osu.Game
             Add(new MusicKeyBindingHandler());
 
             // side overlays which cancel each other.
-            var singleDisplaySideOverlays = new OverlayContainer[] { Settings, Notifications };
+            var singleDisplaySideOverlays = new OverlayContainer[] { Settings, Notifications, firstRunOverlay };
 
             foreach (var overlay in singleDisplaySideOverlays)
             {
@@ -869,7 +869,7 @@ namespace osu.Game
             }
 
             // ensure only one of these overlays are open at once.
-            var singleDisplayOverlays = new OverlayContainer[] { chatOverlay, news, dashboard, beatmapListing, changelogOverlay, rankingsOverlay, wikiOverlay };
+            var singleDisplayOverlays = new OverlayContainer[] { firstRunOverlay, chatOverlay, news, dashboard, beatmapListing, changelogOverlay, rankingsOverlay, wikiOverlay };
 
             foreach (var overlay in singleDisplayOverlays)
             {

From 9074eb283dd43e2f0f593c26e3cfddd7b81ec22f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 18 Apr 2022 19:35:51 +0900
Subject: [PATCH 4155/5547] Show a notification instead of blocking exit of
 wizard

---
 .../TestSceneFirstRunSetupOverlay.cs          |  6 ------
 osu.Game/Overlays/FirstRunSetupOverlay.cs     | 21 ++++++++++++-------
 2 files changed, 14 insertions(+), 13 deletions(-)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunSetupOverlay.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunSetupOverlay.cs
index d22dd260eb..3a4dc09e26 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunSetupOverlay.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunSetupOverlay.cs
@@ -10,7 +10,6 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Screens;
 using osu.Framework.Testing;
 using osu.Game.Overlays;
-using osu.Game.Overlays.Dialog;
 using osu.Game.Overlays.FirstRunSetup;
 using osu.Game.Screens;
 using osuTK;
@@ -23,19 +22,14 @@ namespace osu.Game.Tests.Visual.UserInterface
         private FirstRunSetupOverlay overlay;
 
         private readonly Mock<IPerformFromScreenRunner> perfomer = new Mock<IPerformFromScreenRunner>();
-        private readonly Mock<IDialogOverlay> dialogOverlay = new Mock<IDialogOverlay>();
 
         [BackgroundDependencyLoader]
         private void load()
         {
             Dependencies.CacheAs(perfomer.Object);
-            Dependencies.CacheAs(dialogOverlay.Object);
 
             perfomer.Setup(g => g.PerformFromScreen(It.IsAny<Action<IScreen>>(), It.IsAny<IEnumerable<Type>>()))
                     .Callback((Action<IScreen> action, IEnumerable<Type> types) => action(null));
-
-            dialogOverlay.Setup(d => d.Push(It.IsAny<PopupDialog>()))
-                         .Callback((PopupDialog dialog) => dialog.PerformOkAction());
         }
 
         [SetUpSteps]
diff --git a/osu.Game/Overlays/FirstRunSetupOverlay.cs b/osu.Game/Overlays/FirstRunSetupOverlay.cs
index abde9636ba..b7d7a21493 100644
--- a/osu.Game/Overlays/FirstRunSetupOverlay.cs
+++ b/osu.Game/Overlays/FirstRunSetupOverlay.cs
@@ -222,13 +222,6 @@ namespace osu.Game.Overlays
             performer.PerformFromScreen(_ => { Show(); }, new[] { typeof(MainMenu) });
         }
 
-        protected override bool OnClick(ClickEvent e)
-        {
-            dialogOverlay.Push(new ConfirmDialog("Are you sure you want to exit the setup process?", Hide, () => { }));
-
-            return base.OnClick(e);
-        }
-
         protected override void PopIn()
         {
             base.PopIn();
@@ -283,6 +276,20 @@ namespace osu.Game.Overlays
 
         protected override void PopOut()
         {
+            if (currentStepIndex != null)
+            {
+                notificationOverlay?.Post(new SimpleNotification
+                {
+                    Text = "Click here to resume initial setup at any point",
+                    Icon = FontAwesome.Solid.Horse,
+                    Activated = () =>
+                    {
+                        Show();
+                        return true;
+                    },
+                });
+            }
+
             base.PopOut();
             this.FadeOut(100);
         }

From 2682373bf25102647c142cdecdaf442be1428725 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 18 Apr 2022 19:36:12 +0900
Subject: [PATCH 4156/5547] Use existing blocking / exit logic provided by
 `OsuFocusedOverlayContainer`

---
 osu.Game/Overlays/FirstRunSetupOverlay.cs | 230 +++++++++++-----------
 1 file changed, 115 insertions(+), 115 deletions(-)

diff --git a/osu.Game/Overlays/FirstRunSetupOverlay.cs b/osu.Game/Overlays/FirstRunSetupOverlay.cs
index b7d7a21493..4a9e8d0efd 100644
--- a/osu.Game/Overlays/FirstRunSetupOverlay.cs
+++ b/osu.Game/Overlays/FirstRunSetupOverlay.cs
@@ -11,15 +11,15 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Effects;
 using osu.Framework.Graphics.Shapes;
-using osu.Framework.Input.Events;
+using osu.Framework.Graphics.Sprites;
 using osu.Framework.Localisation;
 using osu.Framework.Screens;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.UserInterface;
-using osu.Game.Overlays.Dialog;
 using osu.Game.Overlays.FirstRunSetup;
+using osu.Game.Overlays.Notifications;
 using osu.Game.Screens;
 using osu.Game.Screens.Menu;
 using osu.Game.Screens.OnlinePlay.Match.Components;
@@ -33,17 +33,16 @@ namespace osu.Game.Overlays
     {
         protected override bool StartHidden => true;
 
-        [Resolved]
-        private IDialogOverlay dialogOverlay { get; set; } = null!;
-
         [Resolved]
         private IPerformFromScreenRunner performer { get; set; } = null!;
 
+        [Resolved(canBeNull: true)]
+        private NotificationOverlay notificationOverlay { get; set; } = null!;
+
         private ScreenStack stack = null!;
 
         public PurpleTriangleButton NextButton = null!;
         public DangerousTriangleButton BackButton = null!;
-        private Container mainContent = null!;
 
         [Cached]
         private OverlayColourProvider colourProvider = new OverlayColourProvider(OverlayColourScheme.Purple);
@@ -61,6 +60,8 @@ namespace osu.Game.Overlays
             new FirstRunStep(typeof(ScreenUIScale), "UI Scale"),
         };
 
+        private Container stackContainer = null!;
+
         public FirstRunSetupOverlay()
         {
             RelativeSizeAxes = Axes.Both;
@@ -69,151 +70,140 @@ namespace osu.Game.Overlays
         [BackgroundDependencyLoader]
         private void load()
         {
+            Anchor = Anchor.Centre;
+            Origin = Anchor.Centre;
+
+            RelativeSizeAxes = Axes.Both;
+            Size = new Vector2(0.95f);
+
+            EdgeEffect = new EdgeEffectParameters
+            {
+                Type = EdgeEffectType.Shadow,
+                Radius = 5,
+                Colour = Color4.Black.Opacity(0.2f),
+            };
+
+            Masking = true;
+            CornerRadius = 10;
+
             Children = new Drawable[]
             {
-                mainContent = new BlockingContainer
+                new Box
                 {
                     RelativeSizeAxes = Axes.Both,
-                    Anchor = Anchor.Centre,
-                    Origin = Anchor.Centre,
-                    Size = new Vector2(0.95f),
-                    EdgeEffect = new EdgeEffectParameters
+                    Colour = colourProvider.Background6,
+                },
+                new GridContainer
+                {
+                    RelativeSizeAxes = Axes.Both,
+                    RowDimensions = new[]
                     {
-                        Type = EdgeEffectType.Shadow,
-                        Radius = 5,
-                        Colour = Color4.Black.Opacity(0.2f),
+                        new Dimension(GridSizeMode.AutoSize),
+                        new Dimension(),
+                        new Dimension(GridSizeMode.AutoSize),
                     },
-                    Masking = true,
-                    CornerRadius = 10,
-                    Children = new Drawable[]
+                    Content = new[]
                     {
-                        new Box
+                        new Drawable[]
                         {
-                            RelativeSizeAxes = Axes.Both,
-                            Colour = colourProvider.Background6,
-                        },
-                        new GridContainer
-                        {
-                            RelativeSizeAxes = Axes.Both,
-                            RowDimensions = new[]
+                            new Container
                             {
-                                new Dimension(GridSizeMode.AutoSize),
-                                new Dimension(),
-                                new Dimension(GridSizeMode.AutoSize),
-                            },
-                            Content = new[]
-                            {
-                                new Drawable[]
+                                RelativeSizeAxes = Axes.X,
+                                AutoSizeAxes = Axes.Y,
+                                Children = new Drawable[]
                                 {
-                                    new Container
+                                    new Box
+                                    {
+                                        Colour = colourProvider.Background5,
+                                        RelativeSizeAxes = Axes.Both,
+                                    },
+                                    new FillFlowContainer
                                     {
                                         RelativeSizeAxes = Axes.X,
+                                        Margin = new MarginPadding(10),
                                         AutoSizeAxes = Axes.Y,
+                                        Direction = FillDirection.Vertical,
                                         Children = new Drawable[]
                                         {
-                                            new Box
+                                            new OsuSpriteText
                                             {
-                                                Colour = colourProvider.Background5,
-                                                RelativeSizeAxes = Axes.Both,
+                                                Text = "First run setup",
+                                                Font = OsuFont.Default.With(size: 32),
+                                                Colour = colourProvider.Content2,
+                                                Anchor = Anchor.TopCentre,
+                                                Origin = Anchor.TopCentre,
                                             },
-                                            new FillFlowContainer
+                                            new OsuTextFlowContainer
                                             {
-                                                RelativeSizeAxes = Axes.X,
-                                                Margin = new MarginPadding(10),
-                                                AutoSizeAxes = Axes.Y,
-                                                Direction = FillDirection.Vertical,
-                                                Children = new Drawable[]
-                                                {
-                                                    new OsuSpriteText
-                                                    {
-                                                        Text = "First run setup",
-                                                        Font = OsuFont.Default.With(size: 32),
-                                                        Colour = colourProvider.Content2,
-                                                        Anchor = Anchor.TopCentre,
-                                                        Origin = Anchor.TopCentre,
-                                                    },
-                                                    new OsuTextFlowContainer
-                                                    {
-                                                        Text = "Setup osu! to suit you",
-                                                        Colour = colourProvider.Content1,
-                                                        Anchor = Anchor.TopCentre,
-                                                        Origin = Anchor.TopCentre,
-                                                        AutoSizeAxes = Axes.Both,
-                                                    },
-                                                }
+                                                Text = "Setup osu! to suit you",
+                                                Colour = colourProvider.Content1,
+                                                Anchor = Anchor.TopCentre,
+                                                Origin = Anchor.TopCentre,
+                                                AutoSizeAxes = Axes.Both,
                                             },
                                         }
                                     },
-                                },
-                                new Drawable[]
+                                }
+                            },
+                        },
+                        new Drawable[]
+                        {
+                            stackContainer = new Container
+                            {
+                                RelativeSizeAxes = Axes.Both,
+                                Padding = new MarginPadding(20),
+                            },
+                        },
+                        new Drawable[]
+                        {
+                            new Container
+                            {
+                                RelativeSizeAxes = Axes.X,
+                                AutoSizeAxes = Axes.Y,
+                                Padding = new MarginPadding(20),
+                                Child = new GridContainer
                                 {
-                                    new Container
+                                    RelativeSizeAxes = Axes.X,
+                                    AutoSizeAxes = Axes.Y,
+                                    ColumnDimensions = new[]
                                     {
-                                        RelativeSizeAxes = Axes.Both,
-                                        Padding = new MarginPadding(20),
-                                        Child = stack = new ScreenStack
-                                        {
-                                            RelativeSizeAxes = Axes.Both,
-                                        },
+                                        new Dimension(GridSizeMode.AutoSize),
+                                        new Dimension(GridSizeMode.Absolute, 10),
+                                        new Dimension(),
                                     },
-                                },
-                                new Drawable[]
-                                {
-                                    new Container
+                                    RowDimensions = new[]
                                     {
-                                        RelativeSizeAxes = Axes.X,
-                                        AutoSizeAxes = Axes.Y,
-                                        Padding = new MarginPadding(20),
-                                        Child = new GridContainer
+                                        new Dimension(GridSizeMode.AutoSize),
+                                    },
+                                    Content = new[]
+                                    {
+                                        new[]
                                         {
-                                            RelativeSizeAxes = Axes.X,
-                                            AutoSizeAxes = Axes.Y,
-                                            ColumnDimensions = new[]
+                                            BackButton = new DangerousTriangleButton
                                             {
-                                                new Dimension(GridSizeMode.AutoSize),
-                                                new Dimension(GridSizeMode.Absolute, 10),
-                                                new Dimension(),
+                                                Width = 200,
+                                                Text = "Back",
+                                                Action = showLastStep,
+                                                Enabled = { Value = false },
                                             },
-                                            RowDimensions = new[]
+                                            Empty(),
+                                            NextButton = new PurpleTriangleButton
                                             {
-                                                new Dimension(GridSizeMode.AutoSize),
-                                            },
-                                            Content = new[]
-                                            {
-                                                new[]
-                                                {
-                                                    BackButton = new DangerousTriangleButton
-                                                    {
-                                                        Width = 200,
-                                                        Text = "Back",
-                                                        Action = showLastStep,
-                                                        Enabled = { Value = false },
-                                                    },
-                                                    Empty(),
-                                                    NextButton = new PurpleTriangleButton
-                                                    {
-                                                        RelativeSizeAxes = Axes.X,
-                                                        Width = 1,
-                                                        Text = "Get started",
-                                                        Action = showNextStep
-                                                    }
-                                                },
+                                                RelativeSizeAxes = Axes.X,
+                                                Width = 1,
+                                                Text = "Get started",
+                                                Action = showNextStep
                                             }
                                         },
                                     }
-                                }
+                                },
                             }
-                        },
+                        }
                     }
-                }
+                },
             };
         }
 
-        private class BlockingContainer : Container
-        {
-            protected override bool OnMouseDown(MouseDownEvent e) => true;
-        }
-
         protected override void LoadComplete()
         {
             base.LoadComplete();
@@ -246,7 +236,14 @@ namespace osu.Game.Overlays
         private void showNextStep()
         {
             if (currentStepIndex == null)
+            {
+                stackContainer.Child = stack = new ScreenStack
+                {
+                    RelativeSizeAxes = Axes.Both,
+                };
+
                 currentStepIndex = 0;
+            }
             else
                 currentStepIndex++;
 
@@ -260,8 +257,11 @@ namespace osu.Game.Overlays
             }
             else
             {
-                Hide();
+                stack.FadeOut(500);
+                stack.Expire();
+
                 currentStepIndex = null;
+                Hide();
             }
         }
 

From 5fd64a4c782cb67e9d88ac9751c4955165553d5f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 18 Apr 2022 19:41:07 +0900
Subject: [PATCH 4157/5547] Add test coverage to ensure we don't leave any
 screens in the first run overlay

---
 .../Visual/UserInterface/TestSceneFirstRunSetupOverlay.cs      | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunSetupOverlay.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunSetupOverlay.cs
index 3a4dc09e26..dfe7ba0252 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunSetupOverlay.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunSetupOverlay.cs
@@ -3,6 +3,7 @@
 
 using System;
 using System.Collections.Generic;
+using System.Linq;
 using Moq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
@@ -55,6 +56,8 @@ namespace osu.Game.Tests.Visual.UserInterface
                 return overlay.State.Value == Visibility.Hidden;
             });
 
+            AddUntilStep("wait for screens removed", () => !overlay.ChildrenOfType<Screen>().Any());
+
             AddStep("display again on demand", () => overlay.Show());
 
             AddUntilStep("back at start", () => overlay.CurrentScreen is ScreenWelcome);

From 02f8367d66abbd278751092cb06b2f17ca97aabb Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 18 Apr 2022 19:47:47 +0900
Subject: [PATCH 4158/5547] Improve animation when showing/hiding first run
 overlay

---
 osu.Game/Overlays/FirstRunSetupOverlay.cs | 43 ++++++++++++++---------
 1 file changed, 27 insertions(+), 16 deletions(-)

diff --git a/osu.Game/Overlays/FirstRunSetupOverlay.cs b/osu.Game/Overlays/FirstRunSetupOverlay.cs
index 4a9e8d0efd..ee78865618 100644
--- a/osu.Game/Overlays/FirstRunSetupOverlay.cs
+++ b/osu.Game/Overlays/FirstRunSetupOverlay.cs
@@ -36,8 +36,8 @@ namespace osu.Game.Overlays
         [Resolved]
         private IPerformFromScreenRunner performer { get; set; } = null!;
 
-        [Resolved(canBeNull: true)]
-        private NotificationOverlay notificationOverlay { get; set; } = null!;
+        [Resolved]
+        private INotificationOverlay notificationOverlay { get; set; } = null!;
 
         private ScreenStack stack = null!;
 
@@ -49,6 +49,8 @@ namespace osu.Game.Overlays
 
         private int? currentStepIndex;
 
+        private const float scale_when_hidden = 0.9f;
+
         /// <summary>
         /// The currently displayed screen, if any.
         /// </summary>
@@ -212,15 +214,6 @@ namespace osu.Game.Overlays
             performer.PerformFromScreen(_ => { Show(); }, new[] { typeof(MainMenu) });
         }
 
-        protected override void PopIn()
-        {
-            base.PopIn();
-            this.FadeIn(400, Easing.OutQuint);
-
-            if (currentStepIndex == null)
-                showNextStep();
-        }
-
         private void showLastStep()
         {
             Debug.Assert(currentStepIndex > 0);
@@ -257,9 +250,6 @@ namespace osu.Game.Overlays
             }
             else
             {
-                stack.FadeOut(500);
-                stack.Expire();
-
                 currentStepIndex = null;
                 Hide();
             }
@@ -274,11 +264,24 @@ namespace osu.Game.Overlays
                 : "Finish";
         }
 
+        protected override void PopIn()
+        {
+            base.PopIn();
+
+            this.ScaleTo(scale_when_hidden)
+                .ScaleTo(1, 400, Easing.OutElasticHalf);
+
+            this.FadeIn(400, Easing.OutQuint);
+
+            if (currentStepIndex == null)
+                showNextStep();
+        }
+
         protected override void PopOut()
         {
             if (currentStepIndex != null)
             {
-                notificationOverlay?.Post(new SimpleNotification
+                notificationOverlay.Post(new SimpleNotification
                 {
                     Text = "Click here to resume initial setup at any point",
                     Icon = FontAwesome.Solid.Horse,
@@ -289,9 +292,17 @@ namespace osu.Game.Overlays
                     },
                 });
             }
+            else
+            {
+                stack?
+                    .FadeOut(100)
+                    .Expire();
+            }
 
             base.PopOut();
-            this.FadeOut(100);
+
+            this.ScaleTo(0.96f, 400, Easing.OutQuint);
+            this.FadeOut(200, Easing.OutQuint);
         }
 
         private class FirstRunStep

From a8d32a20611650c6bf3af729e0cb4c9bcfb79f19 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 18 Apr 2022 23:37:08 +0900
Subject: [PATCH 4159/5547] Add test coverage of notification resume flow

---
 .../TestSceneFirstRunSetupOverlay.cs          | 45 ++++++++++++++++---
 1 file changed, 40 insertions(+), 5 deletions(-)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunSetupOverlay.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunSetupOverlay.cs
index dfe7ba0252..77a37e7420 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunSetupOverlay.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunSetupOverlay.cs
@@ -12,6 +12,7 @@ using osu.Framework.Screens;
 using osu.Framework.Testing;
 using osu.Game.Overlays;
 using osu.Game.Overlays.FirstRunSetup;
+using osu.Game.Overlays.Notifications;
 using osu.Game.Screens;
 using osuTK;
 using osuTK.Input;
@@ -22,20 +23,34 @@ namespace osu.Game.Tests.Visual.UserInterface
     {
         private FirstRunSetupOverlay overlay;
 
-        private readonly Mock<IPerformFromScreenRunner> perfomer = new Mock<IPerformFromScreenRunner>();
+        private readonly Mock<IPerformFromScreenRunner> performer = new Mock<IPerformFromScreenRunner>();
+
+        private readonly Mock<INotificationOverlay> notificationOverlay = new Mock<INotificationOverlay>();
+
+        private Notification lastNotification;
 
         [BackgroundDependencyLoader]
         private void load()
         {
-            Dependencies.CacheAs(perfomer.Object);
-
-            perfomer.Setup(g => g.PerformFromScreen(It.IsAny<Action<IScreen>>(), It.IsAny<IEnumerable<Type>>()))
-                    .Callback((Action<IScreen> action, IEnumerable<Type> types) => action(null));
+            Dependencies.CacheAs(performer.Object);
+            Dependencies.CacheAs(notificationOverlay.Object);
         }
 
         [SetUpSteps]
         public void SetUpSteps()
         {
+            AddStep("setup dependencies", () =>
+            {
+                performer.Reset();
+                notificationOverlay.Reset();
+
+                performer.Setup(g => g.PerformFromScreen(It.IsAny<Action<IScreen>>(), It.IsAny<IEnumerable<Type>>()))
+                         .Callback((Action<IScreen> action, IEnumerable<Type> types) => action(null));
+
+                notificationOverlay.Setup(n => n.Post(It.IsAny<Notification>()))
+                                   .Callback((Notification n) => lastNotification = n);
+            });
+
             AddStep("add overlay", () =>
             {
                 Child = overlay = new FirstRunSetupOverlay
@@ -58,6 +73,8 @@ namespace osu.Game.Tests.Visual.UserInterface
 
             AddUntilStep("wait for screens removed", () => !overlay.ChildrenOfType<Screen>().Any());
 
+            AddStep("no notifications", () => notificationOverlay.VerifyNoOtherCalls());
+
             AddStep("display again on demand", () => overlay.Show());
 
             AddUntilStep("back at start", () => overlay.CurrentScreen is ScreenWelcome);
@@ -108,5 +125,23 @@ namespace osu.Game.Tests.Visual.UserInterface
 
             AddAssert("overlay dismissed", () => overlay.State.Value == Visibility.Hidden);
         }
+
+        [Test]
+        public void TestResumeViaNotification()
+        {
+            AddStep("step to next", () => overlay.NextButton.TriggerClick());
+
+            AddAssert("is at known screen", () => overlay.CurrentScreen is ScreenUIScale);
+
+            AddStep("hide", () => overlay.Hide());
+            AddAssert("overlay hidden", () => overlay.State.Value == Visibility.Hidden);
+
+            AddStep("notification arrived", () => notificationOverlay.Verify(n => n.Post(It.IsAny<Notification>()), Times.Once));
+
+            AddStep("run notification action", () => lastNotification.Activated());
+
+            AddAssert("overlay shown", () => overlay.State.Value == Visibility.Visible);
+            AddAssert("is resumed", () => overlay.CurrentScreen is ScreenUIScale);
+        }
     }
 }

From 5dc38050056e4bb524e48af24bb385c65c5c276b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 19 Apr 2022 13:48:43 +0900
Subject: [PATCH 4160/5547] Fix `stack` nullability

---
 osu.Game/Overlays/FirstRunSetupOverlay.cs | 12 +++++++-----
 1 file changed, 7 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Overlays/FirstRunSetupOverlay.cs b/osu.Game/Overlays/FirstRunSetupOverlay.cs
index ee78865618..27ff4aaabf 100644
--- a/osu.Game/Overlays/FirstRunSetupOverlay.cs
+++ b/osu.Game/Overlays/FirstRunSetupOverlay.cs
@@ -39,7 +39,7 @@ namespace osu.Game.Overlays
         [Resolved]
         private INotificationOverlay notificationOverlay { get; set; } = null!;
 
-        private ScreenStack stack = null!;
+        private ScreenStack? stack;
 
         public PurpleTriangleButton NextButton = null!;
         public DangerousTriangleButton BackButton = null!;
@@ -54,7 +54,7 @@ namespace osu.Game.Overlays
         /// <summary>
         /// The currently displayed screen, if any.
         /// </summary>
-        public FirstRunSetupScreen? CurrentScreen => (FirstRunSetupScreen?)stack.CurrentScreen;
+        public FirstRunSetupScreen? CurrentScreen => (FirstRunSetupScreen?)stack?.CurrentScreen;
 
         private readonly FirstRunStep[] steps =
         {
@@ -217,6 +217,7 @@ namespace osu.Game.Overlays
         private void showLastStep()
         {
             Debug.Assert(currentStepIndex > 0);
+            Debug.Assert(stack != null);
 
             stack.CurrentScreen.Exit();
             currentStepIndex--;
@@ -241,6 +242,8 @@ namespace osu.Game.Overlays
                 currentStepIndex++;
 
             Debug.Assert(currentStepIndex != null);
+            Debug.Assert(stack != null);
+
             BackButton.Enabled.Value = currentStepIndex > 0;
 
             if (currentStepIndex < steps.Length)
@@ -294,9 +297,8 @@ namespace osu.Game.Overlays
             }
             else
             {
-                stack?
-                    .FadeOut(100)
-                    .Expire();
+                stack?.FadeOut(100)
+                     .Expire();
             }
 
             base.PopOut();

From e67cc293b8215e57d412165989754071d748f254 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 19 Apr 2022 13:52:55 +0900
Subject: [PATCH 4161/5547] Add localisation support for all new strings

---
 osu.Game/Localisation/CommonStrings.cs        | 10 ++++
 .../FirstRunSetupOverlayStrings.cs            | 58 +++++++++++++++++++
 .../Localisation/GeneralSettingsStrings.cs    |  5 ++
 .../Overlays/FirstRunSetup/ScreenUIScale.cs   |  2 +-
 .../Overlays/FirstRunSetup/ScreenWelcome.cs   |  4 +-
 osu.Game/Overlays/FirstRunSetupOverlay.cs     | 19 +++---
 .../Settings/Sections/GeneralSection.cs       |  2 +-
 7 files changed, 87 insertions(+), 13 deletions(-)
 create mode 100644 osu.Game/Localisation/FirstRunSetupOverlayStrings.cs

diff --git a/osu.Game/Localisation/CommonStrings.cs b/osu.Game/Localisation/CommonStrings.cs
index 3ea337c279..05c4d97ccc 100644
--- a/osu.Game/Localisation/CommonStrings.cs
+++ b/osu.Game/Localisation/CommonStrings.cs
@@ -19,6 +19,16 @@ namespace osu.Game.Localisation
         /// </summary>
         public static LocalisableString Clear => new TranslatableString(getKey(@"clear"), @"Clear");
 
+        /// <summary>
+        /// "Back"
+        /// </summary>
+        public static LocalisableString Back => new TranslatableString(getKey(@"back"), @"Back");
+
+        /// <summary>
+        /// "Finish"
+        /// </summary>
+        public static LocalisableString Finish => new TranslatableString(getKey(@"finish"), @"Finish");
+
         /// <summary>
         /// "Enabled"
         /// </summary>
diff --git a/osu.Game/Localisation/FirstRunSetupOverlayStrings.cs b/osu.Game/Localisation/FirstRunSetupOverlayStrings.cs
new file mode 100644
index 0000000000..ec2e97d82a
--- /dev/null
+++ b/osu.Game/Localisation/FirstRunSetupOverlayStrings.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 osu.Framework.Localisation;
+
+namespace osu.Game.Localisation
+{
+    public static class FirstRunSetupOverlayStrings
+    {
+        private const string prefix = @"osu.Game.Resources.Localisation.FirstRunSetupOverlay";
+
+        /// <summary>
+        /// "Get started"
+        /// </summary>
+        public static LocalisableString GetStarted => new TranslatableString(getKey(@"get_started"), @"Get started");
+
+        /// <summary>
+        /// "Click to resume first-run setup at any point"
+        /// </summary>
+        public static LocalisableString ClickToResumeFirstRunSetupAtAnyPoint => new TranslatableString(getKey(@"click_to_resume_first_run_setup_at_any_point"), @"Click to resume first-run setup at any point");
+
+        /// <summary>
+        /// "First-run setup"
+        /// </summary>
+        public static LocalisableString FirstRunSetup => new TranslatableString(getKey(@"first_run_setup"), @"First-run setup");
+
+        /// <summary>
+        /// "Setup osu! to suit you"
+        /// </summary>
+        public static LocalisableString SetupOsuToSuitYou => new TranslatableString(getKey(@"setup_osu_to_suit_you"), @"Setup osu! to suit you");
+
+        /// <summary>
+        /// "Welcome"
+        /// </summary>
+        public static LocalisableString Welcome => new TranslatableString(getKey(@"welcome"), @"Welcome");
+
+        /// <summary>
+        /// "Welcome to the first-run setup guide!
+        ///
+        /// osu! is a very configurable game, and diving straight into the settings can sometimes be overwhelming. This guide will help you get the important choices out of the way to ensure a great first experience!"
+        /// </summary>
+        public static LocalisableString WelcomeDescription => new TranslatableString(getKey(@"welcome_description"), @"Welcome to the first-run setup guide!
+
+osu! is a very configurable game, and diving straight into the settings can sometimes be overwhelming. This guide will help you get the important choices out of the way to ensure a great first experience!");
+
+        /// <summary>
+        /// "The size of the osu! user interface size can be adjusted to your liking."
+        /// </summary>
+        public static LocalisableString UIScaleDescription => new TranslatableString(getKey(@"ui_scale_description"), @"The size of the osu! user interface size can be adjusted to your liking.");
+
+        /// <summary>
+        /// "Next ({0})"
+        /// </summary>
+        public static LocalisableString Next(LocalisableString nextStepDescription) => new TranslatableString(getKey(@"next"), @"Next ({0})", nextStepDescription);
+
+        private static string getKey(string key) => $@"{prefix}:{key}";
+    }
+}
diff --git a/osu.Game/Localisation/GeneralSettingsStrings.cs b/osu.Game/Localisation/GeneralSettingsStrings.cs
index c65e6c77f4..2aa91f5245 100644
--- a/osu.Game/Localisation/GeneralSettingsStrings.cs
+++ b/osu.Game/Localisation/GeneralSettingsStrings.cs
@@ -59,6 +59,11 @@ namespace osu.Game.Localisation
         /// </summary>
         public static LocalisableString ChangeFolderLocation => new TranslatableString(getKey(@"change_folder_location"), @"Change folder location...");
 
+        /// <summary>
+        /// "Run setup wizard"
+        /// </summary>
+        public static LocalisableString RunSetupWizard => new TranslatableString(getKey(@"run_setup_wizard"), @"Run setup wizard");
+
         private static string getKey(string key) => $"{prefix}:{key}";
     }
 }
diff --git a/osu.Game/Overlays/FirstRunSetup/ScreenUIScale.cs b/osu.Game/Overlays/FirstRunSetup/ScreenUIScale.cs
index 5070856087..80ff7bdf25 100644
--- a/osu.Game/Overlays/FirstRunSetup/ScreenUIScale.cs
+++ b/osu.Game/Overlays/FirstRunSetup/ScreenUIScale.cs
@@ -53,7 +53,7 @@ namespace osu.Game.Overlays.FirstRunSetup
                                 {
                                     new OsuTextFlowContainer(cp => cp.Font = OsuFont.Default.With(size: 24))
                                     {
-                                        Text = "The osu! user interface size can be adjusted to your liking.",
+                                        Text = FirstRunSetupOverlayStrings.UIScaleDescription,
                                         RelativeSizeAxes = Axes.X,
                                         AutoSizeAxes = Axes.Y
                                     },
diff --git a/osu.Game/Overlays/FirstRunSetup/ScreenWelcome.cs b/osu.Game/Overlays/FirstRunSetup/ScreenWelcome.cs
index 879ffdf198..9f80c80a02 100644
--- a/osu.Game/Overlays/FirstRunSetup/ScreenWelcome.cs
+++ b/osu.Game/Overlays/FirstRunSetup/ScreenWelcome.cs
@@ -5,6 +5,7 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
+using osu.Game.Localisation;
 
 namespace osu.Game.Overlays.FirstRunSetup
 {
@@ -22,8 +23,7 @@ namespace osu.Game.Overlays.FirstRunSetup
                     {
                         new OsuTextFlowContainer(cp => cp.Font = OsuFont.Default.With(size: 20))
                         {
-                            Text =
-                                "Welcome to the first-run setup guide!\n\nosu! is a very configurable game, and diving straight into the settings can sometimes be overwhelming. This guide will help you get the important choices out of the way to ensure a great first experience!",
+                            Text = FirstRunSetupOverlayStrings.WelcomeDescription,
                             RelativeSizeAxes = Axes.X,
                             AutoSizeAxes = Axes.Y
                         },
diff --git a/osu.Game/Overlays/FirstRunSetupOverlay.cs b/osu.Game/Overlays/FirstRunSetupOverlay.cs
index 27ff4aaabf..e8829136f0 100644
--- a/osu.Game/Overlays/FirstRunSetupOverlay.cs
+++ b/osu.Game/Overlays/FirstRunSetupOverlay.cs
@@ -18,6 +18,7 @@ using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.UserInterface;
+using osu.Game.Localisation;
 using osu.Game.Overlays.FirstRunSetup;
 using osu.Game.Overlays.Notifications;
 using osu.Game.Screens;
@@ -58,8 +59,8 @@ namespace osu.Game.Overlays
 
         private readonly FirstRunStep[] steps =
         {
-            new FirstRunStep(typeof(ScreenWelcome), "Welcome"),
-            new FirstRunStep(typeof(ScreenUIScale), "UI Scale"),
+            new FirstRunStep(typeof(ScreenWelcome), FirstRunSetupOverlayStrings.Welcome),
+            new FirstRunStep(typeof(ScreenUIScale), GraphicsSettingsStrings.UIScaling),
         };
 
         private Container stackContainer = null!;
@@ -129,7 +130,7 @@ namespace osu.Game.Overlays
                                         {
                                             new OsuSpriteText
                                             {
-                                                Text = "First run setup",
+                                                Text = FirstRunSetupOverlayStrings.FirstRunSetup,
                                                 Font = OsuFont.Default.With(size: 32),
                                                 Colour = colourProvider.Content2,
                                                 Anchor = Anchor.TopCentre,
@@ -137,7 +138,7 @@ namespace osu.Game.Overlays
                                             },
                                             new OsuTextFlowContainer
                                             {
-                                                Text = "Setup osu! to suit you",
+                                                Text = FirstRunSetupOverlayStrings.SetupOsuToSuitYou,
                                                 Colour = colourProvider.Content1,
                                                 Anchor = Anchor.TopCentre,
                                                 Origin = Anchor.TopCentre,
@@ -184,7 +185,7 @@ namespace osu.Game.Overlays
                                             BackButton = new DangerousTriangleButton
                                             {
                                                 Width = 200,
-                                                Text = "Back",
+                                                Text = CommonStrings.Back,
                                                 Action = showLastStep,
                                                 Enabled = { Value = false },
                                             },
@@ -193,7 +194,7 @@ namespace osu.Game.Overlays
                                             {
                                                 RelativeSizeAxes = Axes.X,
                                                 Width = 1,
-                                                Text = "Get started",
+                                                Text = FirstRunSetupOverlayStrings.GetStarted,
                                                 Action = showNextStep
                                             }
                                         },
@@ -263,8 +264,8 @@ namespace osu.Game.Overlays
             Debug.Assert(currentStepIndex != null);
 
             NextButton.Text = currentStepIndex + 1 < steps.Length
-                ? $"Next ({steps[currentStepIndex.Value + 1].Description})"
-                : "Finish";
+                ? FirstRunSetupOverlayStrings.Next(steps[currentStepIndex.Value + 1].Description)
+                : CommonStrings.Finish;
         }
 
         protected override void PopIn()
@@ -286,7 +287,7 @@ namespace osu.Game.Overlays
             {
                 notificationOverlay.Post(new SimpleNotification
                 {
-                    Text = "Click here to resume initial setup at any point",
+                    Text = FirstRunSetupOverlayStrings.ClickToResumeFirstRunSetupAtAnyPoint,
                     Icon = FontAwesome.Solid.Horse,
                     Activated = () =>
                     {
diff --git a/osu.Game/Overlays/Settings/Sections/GeneralSection.cs b/osu.Game/Overlays/Settings/Sections/GeneralSection.cs
index 786db85bbf..ced3116728 100644
--- a/osu.Game/Overlays/Settings/Sections/GeneralSection.cs
+++ b/osu.Game/Overlays/Settings/Sections/GeneralSection.cs
@@ -28,7 +28,7 @@ namespace osu.Game.Overlays.Settings.Sections
             {
                 new SettingsButton
                 {
-                    Text = "Run setup wizard",
+                    Text = GeneralSettingsStrings.RunSetupWizard,
                     Action = () => firstRunSetupOverlay?.Show(),
                 },
                 new LanguageSettings(),

From 6d534046ff2cedc67315f4d6e10f8f810afab33a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 19 Apr 2022 14:46:01 +0900
Subject: [PATCH 4162/5547] Add keyboard traversal support for first run dialog
 (and tidy up step traversal logic)

---
 .../TestSceneFirstRunSetupOverlay.cs          |  30 ++++-
 osu.Game/Overlays/FirstRunSetupOverlay.cs     | 125 +++++++++++-------
 2 files changed, 103 insertions(+), 52 deletions(-)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunSetupOverlay.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunSetupOverlay.cs
index 77a37e7420..ff54e34ca0 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunSetupOverlay.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunSetupOverlay.cs
@@ -60,13 +60,19 @@ namespace osu.Game.Tests.Visual.UserInterface
             });
         }
 
-        [Test]
-        public void TestOverlayRunsToFinish()
+        [TestCase(false)]
+        [TestCase(true)]
+        public void TestOverlayRunsToFinish(bool keyboard)
         {
             AddUntilStep("step through", () =>
             {
                 if (overlay.CurrentScreen?.IsLoaded != false)
-                    overlay.NextButton.TriggerClick();
+                {
+                    if (keyboard)
+                        InputManager.Key(Key.Enter);
+                    else
+                        overlay.NextButton.TriggerClick();
+                }
 
                 return overlay.State.Value == Visibility.Hidden;
             });
@@ -80,8 +86,9 @@ namespace osu.Game.Tests.Visual.UserInterface
             AddUntilStep("back at start", () => overlay.CurrentScreen is ScreenWelcome);
         }
 
-        [Test]
-        public void TestBackButton()
+        [TestCase(false)]
+        [TestCase(true)]
+        public void TestBackButton(bool keyboard)
         {
             AddAssert("back button disabled", () => !overlay.BackButton.Enabled.Value);
 
@@ -98,12 +105,23 @@ namespace osu.Game.Tests.Visual.UserInterface
             AddUntilStep("step back to start", () =>
             {
                 if (overlay.CurrentScreen?.IsLoaded != false)
-                    overlay.BackButton.TriggerClick();
+                {
+                    if (keyboard)
+                        InputManager.Key(Key.Escape);
+                    else
+                        overlay.BackButton.TriggerClick();
+                }
 
                 return overlay.CurrentScreen is ScreenWelcome;
             });
 
             AddAssert("back button disabled", () => !overlay.BackButton.Enabled.Value);
+
+            if (keyboard)
+            {
+                AddStep("exit via keyboard", () => InputManager.Key(Key.Escape));
+                AddAssert("overlay dismissed", () => overlay.State.Value == Visibility.Hidden);
+            }
         }
 
         [Test]
diff --git a/osu.Game/Overlays/FirstRunSetupOverlay.cs b/osu.Game/Overlays/FirstRunSetupOverlay.cs
index e8829136f0..00396e6d85 100644
--- a/osu.Game/Overlays/FirstRunSetupOverlay.cs
+++ b/osu.Game/Overlays/FirstRunSetupOverlay.cs
@@ -12,12 +12,14 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Effects;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Graphics.Sprites;
+using osu.Framework.Input.Events;
 using osu.Framework.Localisation;
 using osu.Framework.Screens;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.UserInterface;
+using osu.Game.Input.Bindings;
 using osu.Game.Localisation;
 using osu.Game.Overlays.FirstRunSetup;
 using osu.Game.Overlays.Notifications;
@@ -215,57 +217,30 @@ namespace osu.Game.Overlays
             performer.PerformFromScreen(_ => { Show(); }, new[] { typeof(MainMenu) });
         }
 
-        private void showLastStep()
+        public override bool OnPressed(KeyBindingPressEvent<GlobalAction> e)
         {
-            Debug.Assert(currentStepIndex > 0);
-            Debug.Assert(stack != null);
-
-            stack.CurrentScreen.Exit();
-            currentStepIndex--;
-
-            BackButton.Enabled.Value = currentStepIndex != 0;
-
-            updateButtonText();
-        }
-
-        private void showNextStep()
-        {
-            if (currentStepIndex == null)
+            if (!e.Repeat)
             {
-                stackContainer.Child = stack = new ScreenStack
+                switch (e.Action)
                 {
-                    RelativeSizeAxes = Axes.Both,
-                };
+                    case GlobalAction.Select:
+                        NextButton.TriggerClick();
+                        return true;
 
-                currentStepIndex = 0;
+                    case GlobalAction.Back:
+                        if (BackButton.Enabled.Value)
+                        {
+                            BackButton.TriggerClick();
+                            return true;
+                        }
+
+                        // If back button is disabled, we are at the first step.
+                        // The base call will handle dismissal of the overlay.
+                        break;
+                }
             }
-            else
-                currentStepIndex++;
 
-            Debug.Assert(currentStepIndex != null);
-            Debug.Assert(stack != null);
-
-            BackButton.Enabled.Value = currentStepIndex > 0;
-
-            if (currentStepIndex < steps.Length)
-            {
-                stack.Push((Screen)Activator.CreateInstance(steps[currentStepIndex.Value].ScreenType));
-                updateButtonText();
-            }
-            else
-            {
-                currentStepIndex = null;
-                Hide();
-            }
-        }
-
-        private void updateButtonText()
-        {
-            Debug.Assert(currentStepIndex != null);
-
-            NextButton.Text = currentStepIndex + 1 < steps.Length
-                ? FirstRunSetupOverlayStrings.Next(steps[currentStepIndex.Value + 1].Description)
-                : CommonStrings.Finish;
+            return base.OnPressed(e);
         }
 
         protected override void PopIn()
@@ -278,7 +253,7 @@ namespace osu.Game.Overlays
             this.FadeIn(400, Easing.OutQuint);
 
             if (currentStepIndex == null)
-                showNextStep();
+                showFirstStep();
         }
 
         protected override void PopOut()
@@ -308,6 +283,64 @@ namespace osu.Game.Overlays
             this.FadeOut(200, Easing.OutQuint);
         }
 
+        private void showFirstStep()
+        {
+            Debug.Assert(currentStepIndex == null);
+
+            stackContainer.Child = stack = new ScreenStack
+            {
+                RelativeSizeAxes = Axes.Both,
+            };
+
+            currentStepIndex = -1;
+            showNextStep();
+        }
+
+        private void showLastStep()
+        {
+            if (currentStepIndex == 0)
+                return;
+
+            Debug.Assert(stack != null);
+
+            stack.CurrentScreen.Exit();
+            currentStepIndex--;
+
+            BackButton.Enabled.Value = currentStepIndex != 0;
+
+            updateButtonText();
+        }
+
+        private void showNextStep()
+        {
+            Debug.Assert(currentStepIndex != null);
+            Debug.Assert(stack != null);
+
+            currentStepIndex++;
+
+            BackButton.Enabled.Value = currentStepIndex > 0;
+
+            if (currentStepIndex < steps.Length)
+            {
+                stack.Push((Screen)Activator.CreateInstance(steps[currentStepIndex.Value].ScreenType));
+                updateButtonText();
+            }
+            else
+            {
+                currentStepIndex = null;
+                Hide();
+            }
+        }
+
+        private void updateButtonText()
+        {
+            Debug.Assert(currentStepIndex != null);
+
+            NextButton.Text = currentStepIndex + 1 < steps.Length
+                ? FirstRunSetupOverlayStrings.Next(steps[currentStepIndex.Value + 1].Description)
+                : CommonStrings.Finish;
+        }
+
         private class FirstRunStep
         {
             public readonly Type ScreenType;

From c4bade099574fa36af497f4d8fe8d97493041ee2 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 19 Apr 2022 15:46:03 +0900
Subject: [PATCH 4163/5547] Expose `MainMenu` buttons

---
 osu.Game/Screens/Menu/ButtonSystem.cs | 14 +++++++++++---
 osu.Game/Screens/Menu/MainMenu.cs     | 26 +++++++++++++-------------
 2 files changed, 24 insertions(+), 16 deletions(-)

diff --git a/osu.Game/Screens/Menu/ButtonSystem.cs b/osu.Game/Screens/Menu/ButtonSystem.cs
index 598c441042..a153eda0c4 100644
--- a/osu.Game/Screens/Menu/ButtonSystem.cs
+++ b/osu.Game/Screens/Menu/ButtonSystem.cs
@@ -88,6 +88,8 @@ namespace osu.Game.Screens.Menu
 
         private readonly LogoTrackingContainer logoTrackingContainer;
 
+        public bool ReturnToTopOnIdle { get; set; } = true;
+
         public ButtonSystem()
         {
             RelativeSizeAxes = Axes.Both;
@@ -101,7 +103,8 @@ namespace osu.Game.Screens.Menu
             buttonArea.AddRange(new Drawable[]
             {
                 new MainMenuButton(ButtonSystemStrings.Settings, string.Empty, FontAwesome.Solid.Cog, new Color4(85, 85, 85, 255), () => OnSettings?.Invoke(), -WEDGE_WIDTH, Key.O),
-                backButton = new MainMenuButton(ButtonSystemStrings.Back, @"button-back-select", OsuIcon.LeftCircle, new Color4(51, 58, 94, 255), () => State = ButtonSystemState.TopLevel, -WEDGE_WIDTH)
+                backButton = new MainMenuButton(ButtonSystemStrings.Back, @"button-back-select", OsuIcon.LeftCircle, new Color4(51, 58, 94, 255), () => State = ButtonSystemState.TopLevel,
+                    -WEDGE_WIDTH)
                 {
                     VisibleState = ButtonSystemState.Play,
                 },
@@ -131,9 +134,11 @@ namespace osu.Game.Screens.Menu
             buttonsPlay.Add(new MainMenuButton(ButtonSystemStrings.Playlists, @"button-generic-select", OsuIcon.Charts, new Color4(94, 63, 186, 255), onPlaylists, 0, Key.L));
             buttonsPlay.ForEach(b => b.VisibleState = ButtonSystemState.Play);
 
-            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));
             buttonsTopLevel.Add(new MainMenuButton(ButtonSystemStrings.Edit, @"button-edit-select", OsuIcon.EditCircle, new Color4(238, 170, 0, 255), () => OnEdit?.Invoke(), 0, Key.E));
-            buttonsTopLevel.Add(new MainMenuButton(ButtonSystemStrings.Browse, @"button-direct-select", OsuIcon.ChevronDownCircle, new Color4(165, 204, 0, 255), () => OnBeatmapListing?.Invoke(), 0, Key.D));
+            buttonsTopLevel.Add(new MainMenuButton(ButtonSystemStrings.Browse, @"button-direct-select", OsuIcon.ChevronDownCircle, new Color4(165, 204, 0, 255), () => OnBeatmapListing?.Invoke(), 0,
+                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));
@@ -201,6 +206,9 @@ namespace osu.Game.Screens.Menu
 
         private void updateIdleState(bool isIdle)
         {
+            if (!ReturnToTopOnIdle)
+                return;
+
             if (isIdle && State != ButtonSystemState.Exit && State != ButtonSystemState.EnteringMode)
                 State = ButtonSystemState.Initial;
         }
diff --git a/osu.Game/Screens/Menu/MainMenu.cs b/osu.Game/Screens/Menu/MainMenu.cs
index 08df06816b..422508b60e 100644
--- a/osu.Game/Screens/Menu/MainMenu.cs
+++ b/osu.Game/Screens/Menu/MainMenu.cs
@@ -35,7 +35,7 @@ namespace osu.Game.Screens.Menu
 
         public const float FADE_OUT_DURATION = 400;
 
-        public override bool HideOverlaysOnEnter => buttons == null || buttons.State == ButtonSystemState.Initial;
+        public override bool HideOverlaysOnEnter => Buttons == null || Buttons.State == ButtonSystemState.Initial;
 
         public override bool AllowBackButton => false;
 
@@ -45,7 +45,7 @@ namespace osu.Game.Screens.Menu
 
         private MenuSideFlashes sideFlashes;
 
-        private ButtonSystem buttons;
+        protected ButtonSystem Buttons;
 
         [Resolved]
         private GameHost host { get; set; }
@@ -101,7 +101,7 @@ namespace osu.Game.Screens.Menu
                     ParallaxAmount = 0.01f,
                     Children = new Drawable[]
                     {
-                        buttons = new ButtonSystem
+                        Buttons = new ButtonSystem
                         {
                             OnEdit = delegate
                             {
@@ -125,7 +125,7 @@ namespace osu.Game.Screens.Menu
                 exitConfirmOverlay?.CreateProxy() ?? Empty()
             });
 
-            buttons.StateChanged += state =>
+            Buttons.StateChanged += state =>
             {
                 switch (state)
                 {
@@ -140,8 +140,8 @@ namespace osu.Game.Screens.Menu
                 }
             };
 
-            buttons.OnSettings = () => settings?.ToggleVisibility();
-            buttons.OnBeatmapListing = () => beatmapListing?.ToggleVisibility();
+            Buttons.OnSettings = () => settings?.ToggleVisibility();
+            Buttons.OnBeatmapListing = () => beatmapListing?.ToggleVisibility();
 
             LoadComponentAsync(background = new BackgroundScreenDefault());
             preloadSongSelect();
@@ -179,7 +179,7 @@ namespace osu.Game.Screens.Menu
         public override void OnEntering(IScreen last)
         {
             base.OnEntering(last);
-            buttons.FadeInFromZero(500);
+            Buttons.FadeInFromZero(500);
 
             if (last is IntroScreen && musicController.TrackLoaded)
             {
@@ -203,14 +203,14 @@ namespace osu.Game.Screens.Menu
         {
             base.LogoArriving(logo, resuming);
 
-            buttons.SetOsuLogo(logo);
+            Buttons.SetOsuLogo(logo);
 
             logo.FadeColour(Color4.White, 100, Easing.OutQuint);
             logo.FadeIn(100, Easing.OutQuint);
 
             if (resuming)
             {
-                buttons.State = ButtonSystemState.TopLevel;
+                Buttons.State = ButtonSystemState.TopLevel;
 
                 this.FadeIn(FADE_IN_DURATION, Easing.OutQuint);
                 buttonsContainer.MoveTo(new Vector2(0, 0), FADE_IN_DURATION, Easing.OutQuint);
@@ -245,15 +245,15 @@ namespace osu.Game.Screens.Menu
             var seq = logo.FadeOut(300, Easing.InSine)
                           .ScaleTo(0.2f, 300, Easing.InSine);
 
-            seq.OnComplete(_ => buttons.SetOsuLogo(null));
-            seq.OnAbort(_ => buttons.SetOsuLogo(null));
+            seq.OnComplete(_ => Buttons.SetOsuLogo(null));
+            seq.OnAbort(_ => Buttons.SetOsuLogo(null));
         }
 
         public override void OnSuspending(IScreen next)
         {
             base.OnSuspending(next);
 
-            buttons.State = ButtonSystemState.EnteringMode;
+            Buttons.State = ButtonSystemState.EnteringMode;
 
             this.FadeOut(FADE_OUT_DURATION, Easing.InSine);
             buttonsContainer.MoveTo(new Vector2(-800, 0), FADE_OUT_DURATION, Easing.InSine);
@@ -285,7 +285,7 @@ namespace osu.Game.Screens.Menu
                 return true;
             }
 
-            buttons.State = ButtonSystemState.Exit;
+            Buttons.State = ButtonSystemState.Exit;
             OverlayActivationMode.Value = OverlayActivation.Disabled;
 
             songTicker.Hide();

From c27831145ccd47975d0ba862d0b11408fe9c5368 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 19 Apr 2022 16:37:29 +0900
Subject: [PATCH 4164/5547] Add scroll and flow at the `FirstRunSetupScreen`
 level

---
 .../FirstRunSetup/FirstRunSetupScreen.cs      | 23 +++++++++++++++++++
 .../Overlays/FirstRunSetup/ScreenWelcome.cs   | 19 ++++-----------
 2 files changed, 28 insertions(+), 14 deletions(-)

diff --git a/osu.Game/Overlays/FirstRunSetup/FirstRunSetupScreen.cs b/osu.Game/Overlays/FirstRunSetup/FirstRunSetupScreen.cs
index 2d025d46ef..b2284a999d 100644
--- a/osu.Game/Overlays/FirstRunSetup/FirstRunSetupScreen.cs
+++ b/osu.Game/Overlays/FirstRunSetup/FirstRunSetupScreen.cs
@@ -2,7 +2,10 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
 using osu.Framework.Screens;
+using osu.Game.Graphics.Containers;
+using osuTK;
 
 namespace osu.Game.Overlays.FirstRunSetup
 {
@@ -10,6 +13,26 @@ namespace osu.Game.Overlays.FirstRunSetup
     {
         private const float offset = 100;
 
+        protected FillFlowContainer Content { get; private set; }
+
+        protected FirstRunSetupScreen()
+        {
+            InternalChildren = new Drawable[]
+            {
+                new OsuScrollContainer(Direction.Vertical)
+                {
+                    RelativeSizeAxes = Axes.Both,
+                    Child = Content = new FillFlowContainer
+                    {
+                        Spacing = new Vector2(20),
+                        RelativeSizeAxes = Axes.X,
+                        AutoSizeAxes = Axes.Y,
+                        Direction = FillDirection.Vertical,
+                    },
+                }
+            };
+        }
+
         public override void OnEntering(IScreen last)
         {
             base.OnEntering(last);
diff --git a/osu.Game/Overlays/FirstRunSetup/ScreenWelcome.cs b/osu.Game/Overlays/FirstRunSetup/ScreenWelcome.cs
index 9f80c80a02..39da180f40 100644
--- a/osu.Game/Overlays/FirstRunSetup/ScreenWelcome.cs
+++ b/osu.Game/Overlays/FirstRunSetup/ScreenWelcome.cs
@@ -2,7 +2,6 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using osu.Framework.Graphics;
-using osu.Framework.Graphics.Containers;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Localisation;
@@ -13,21 +12,13 @@ namespace osu.Game.Overlays.FirstRunSetup
     {
         public ScreenWelcome()
         {
-            InternalChildren = new Drawable[]
+            Content.Children = new Drawable[]
             {
-                new FillFlowContainer
+                new OsuTextFlowContainer(cp => cp.Font = OsuFont.Default.With(size: 20))
                 {
-                    RelativeSizeAxes = Axes.Both,
-                    Direction = FillDirection.Vertical,
-                    Children = new Drawable[]
-                    {
-                        new OsuTextFlowContainer(cp => cp.Font = OsuFont.Default.With(size: 20))
-                        {
-                            Text = FirstRunSetupOverlayStrings.WelcomeDescription,
-                            RelativeSizeAxes = Axes.X,
-                            AutoSizeAxes = Axes.Y
-                        },
-                    }
+                    Text = FirstRunSetupOverlayStrings.WelcomeDescription,
+                    RelativeSizeAxes = Axes.X,
+                    AutoSizeAxes = Axes.Y
                 },
             };
         }

From a195d4f5aa5a132bf6860e23ab04f327cb84b8a8 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 19 Apr 2022 16:49:41 +0900
Subject: [PATCH 4165/5547] Use a culture name that doesn't cause everything to
 fall over

---
 osu.Game/Localisation/DebugLocalisationStore.cs | 2 +-
 osu.Game/Localisation/Language.cs               | 2 +-
 osu.Game/OsuGame.cs                             | 4 ++--
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Localisation/DebugLocalisationStore.cs b/osu.Game/Localisation/DebugLocalisationStore.cs
index 99dca6265e..2b114b1bd8 100644
--- a/osu.Game/Localisation/DebugLocalisationStore.cs
+++ b/osu.Game/Localisation/DebugLocalisationStore.cs
@@ -21,7 +21,7 @@ namespace osu.Game.Localisation
 
         public IEnumerable<string> GetAvailableResources() => throw new NotImplementedException();
 
-        public CultureInfo EffectiveCulture { get; } = new CultureInfo(@"debug");
+        public CultureInfo EffectiveCulture { get; } = CultureInfo.CurrentCulture;
 
         public void Dispose()
         {
diff --git a/osu.Game/Localisation/Language.cs b/osu.Game/Localisation/Language.cs
index c98586457e..c13a1a10cb 100644
--- a/osu.Game/Localisation/Language.cs
+++ b/osu.Game/Localisation/Language.cs
@@ -114,7 +114,7 @@ namespace osu.Game.Localisation
 
 #if DEBUG
         [Description(@"Debug (show raw keys)")]
-        DebugLocalisation
+        debug
 #endif
     }
 }
diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index b591b09584..ea21954b9c 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -629,9 +629,9 @@ namespace osu.Game
             foreach (var language in Enum.GetValues(typeof(Language)).OfType<Language>())
             {
 #if DEBUG
-                if (language == Language.DebugLocalisation)
+                if (language == Language.debug)
                 {
-                    Localisation.AddLanguage(Language.DebugLocalisation.ToString(), new DebugLocalisationStore());
+                    Localisation.AddLanguage(Language.debug.ToString(), new DebugLocalisationStore());
                     continue;
                 }
 #endif

From 1490502d4ccc84472f34e23e04e91e04b001f7b4 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 19 Apr 2022 16:37:38 +0900
Subject: [PATCH 4166/5547] Improve overall usability of scale adjust screen

---
 .../Graphics/Containers/ScalingContainer.cs   |  10 +-
 .../Overlays/FirstRunSetup/ScreenUIScale.cs   | 153 +++++++++++-------
 2 files changed, 101 insertions(+), 62 deletions(-)

diff --git a/osu.Game/Graphics/Containers/ScalingContainer.cs b/osu.Game/Graphics/Containers/ScalingContainer.cs
index ca8b6f388f..6589de40b7 100644
--- a/osu.Game/Graphics/Containers/ScalingContainer.cs
+++ b/osu.Game/Graphics/Containers/ScalingContainer.cs
@@ -79,12 +79,12 @@ namespace osu.Game.Graphics.Containers
             };
         }
 
-        private class ScalingDrawSizePreservingFillContainer : DrawSizePreservingFillContainer
+        public class ScalingDrawSizePreservingFillContainer : DrawSizePreservingFillContainer
         {
             private readonly bool applyUIScale;
             private Bindable<float> uiScale;
 
-            private float currentScale = 1;
+            protected float CurrentScale { get; private set; } = 1;
 
             public override bool ReceivePositionalInputAt(Vector2 screenSpacePos) => true;
 
@@ -99,14 +99,14 @@ namespace osu.Game.Graphics.Containers
                 if (applyUIScale)
                 {
                     uiScale = osuConfig.GetBindable<float>(OsuSetting.UIScale);
-                    uiScale.BindValueChanged(args => this.TransformTo(nameof(currentScale), args.NewValue, duration, Easing.OutQuart), true);
+                    uiScale.BindValueChanged(args => this.TransformTo(nameof(CurrentScale), args.NewValue, duration, Easing.OutQuart), true);
                 }
             }
 
             protected override void Update()
             {
-                Scale = new Vector2(currentScale);
-                Size = new Vector2(1 / currentScale);
+                Scale = new Vector2(CurrentScale);
+                Size = new Vector2(1 / CurrentScale);
 
                 base.Update();
             }
diff --git a/osu.Game/Overlays/FirstRunSetup/ScreenUIScale.cs b/osu.Game/Overlays/FirstRunSetup/ScreenUIScale.cs
index 80ff7bdf25..52aeb8082e 100644
--- a/osu.Game/Overlays/FirstRunSetup/ScreenUIScale.cs
+++ b/osu.Game/Overlays/FirstRunSetup/ScreenUIScale.cs
@@ -2,17 +2,23 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
+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.Graphics.Textures;
 using osu.Framework.Localisation;
 using osu.Framework.Screens;
+using osu.Game.Beatmaps;
 using osu.Game.Configuration;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Localisation;
 using osu.Game.Overlays.Settings;
+using osu.Game.Rulesets;
 using osu.Game.Screens;
 using osu.Game.Screens.Menu;
 using osu.Game.Screens.Select;
@@ -27,77 +33,113 @@ namespace osu.Game.Overlays.FirstRunSetup
         private OsuConfigManager osuConfig { get; set; }
 
         [BackgroundDependencyLoader]
-        private void load()
+        private void load(RulesetStore rulesets, BeatmapManager beatmaps)
         {
-            InternalChildren = new Drawable[]
+            Content.Children = new Drawable[]
             {
-                new GridContainer
+                new OsuTextFlowContainer(cp => cp.Font = OsuFont.Default.With(size: 24))
                 {
-                    RelativeSizeAxes = Axes.Both,
-                    RowDimensions = new[]
+                    Text = FirstRunSetupOverlayStrings.UIScaleDescription,
+                    RelativeSizeAxes = Axes.X,
+                    AutoSizeAxes = Axes.Y
+                },
+                new SettingsSlider<float, UIScaleSlider>
+                {
+                    LabelText = GraphicsSettingsStrings.UIScaling,
+                    Current = osuConfig.GetBindable<float>(OsuSetting.UIScale),
+                    KeyboardStep = 0.01f,
+                },
+                new InverseScalingDrawSizePreservingFillContainer
+                {
+                    Anchor = Anchor.TopCentre,
+                    Origin = Anchor.TopCentre,
+                    RelativeSizeAxes = Axes.None,
+                    Size = new Vector2(960, 960 / 16f * 9 / 2),
+                    Children = new Drawable[]
                     {
-                        new Dimension(GridSizeMode.AutoSize),
-                        new Dimension()
-                    },
-                    Content = new[]
-                    {
-                        new Drawable[]
+                        new GridContainer
                         {
-                            new FillFlowContainer
+                            RelativeSizeAxes = Axes.Both,
+                            Content = new[]
                             {
-                                RelativeSizeAxes = Axes.X,
-                                AutoSizeAxes = Axes.Y,
-                                Direction = FillDirection.Vertical,
-                                Spacing = new Vector2(20),
-                                Children = new Drawable[]
+                                new Drawable[]
                                 {
-                                    new OsuTextFlowContainer(cp => cp.Font = OsuFont.Default.With(size: 24))
-                                    {
-                                        Text = FirstRunSetupOverlayStrings.UIScaleDescription,
-                                        RelativeSizeAxes = Axes.X,
-                                        AutoSizeAxes = Axes.Y
-                                    },
-                                    new SettingsSlider<float, UIScaleSlider>
-                                    {
-                                        LabelText = GraphicsSettingsStrings.UIScaling,
-                                        Current = osuConfig.GetBindable<float>(OsuSetting.UIScale),
-                                        KeyboardStep = 0.01f,
-                                    },
-                                }
+                                    new SampleScreenContainer(new PinnedMainMenu()),
+                                    new SampleScreenContainer(new PlaySongSelect()),
+                                },
+                                // TODO: add more screens here in the future (gameplay / results)
+                                // requires a bit more consideration to isolate their behaviour from the "parent" game.
                             }
-                        },
-                        new Drawable[]
-                        {
-                            new GridContainer
-                            {
-                                RelativeSizeAxes = Axes.Both,
-                                Content = new[]
-                                {
-                                    new Drawable[]
-                                    {
-                                        new SampleScreenContainer(new MainMenu()),
-                                        new SampleScreenContainer(new PlaySongSelect()),
-                                    },
-                                    new Drawable[]
-                                    {
-                                        new SampleScreenContainer(new MainMenu()),
-                                        new SampleScreenContainer(new MainMenu()),
-                                    }
-                                }
-                            }
-                        },
+                        }
                     }
                 }
             };
         }
 
+        private class InverseScalingDrawSizePreservingFillContainer : ScalingContainer.ScalingDrawSizePreservingFillContainer
+        {
+            private Vector2 initialSize;
+
+            public InverseScalingDrawSizePreservingFillContainer()
+                : base(true)
+            {
+            }
+
+            protected override void LoadComplete()
+            {
+                base.LoadComplete();
+
+                initialSize = Size;
+            }
+
+            protected override void Update()
+            {
+                Size = initialSize / CurrentScale;
+            }
+        }
+
+        private class PinnedMainMenu : MainMenu
+        {
+            public override void OnEntering(IScreen last)
+            {
+                base.OnEntering(last);
+
+                Buttons.ReturnToTopOnIdle = false;
+                Buttons.State = ButtonSystemState.TopLevel;
+            }
+        }
+
+        private class UIScaleSlider : OsuSliderBar<float>
+        {
+            public override LocalisableString TooltipText => base.TooltipText + "x";
+        }
+
         private class SampleScreenContainer : CompositeDrawable
         {
+            // Minimal isolation from main game.
+
+            [Cached]
+            [Cached(typeof(IBindable<RulesetInfo>))]
+            protected readonly Bindable<RulesetInfo> Ruleset = new Bindable<RulesetInfo>();
+
+            [Cached]
+            [Cached(typeof(IBindable<WorkingBeatmap>))]
+            protected Bindable<WorkingBeatmap> Beatmap { get; private set; } = new Bindable<WorkingBeatmap>();
+
             public override bool HandlePositionalInput => false;
             public override bool HandleNonPositionalInput => false;
             public override bool PropagatePositionalInputSubTree => false;
             public override bool PropagateNonPositionalInputSubTree => false;
 
+            [BackgroundDependencyLoader]
+            private void load(AudioManager audio, TextureStore textures, RulesetStore rulesets)
+            {
+                Beatmap.Value = new DummyWorkingBeatmap(audio, textures);
+                Beatmap.Value.LoadTrack();
+
+                Ruleset.Value = rulesets.AvailableRulesets.First();
+            }
+
             public SampleScreenContainer(Screen screen)
             {
                 OsuScreenStack stack;
@@ -105,6 +147,8 @@ namespace osu.Game.Overlays.FirstRunSetup
 
                 OsuLogo logo;
 
+                Padding = new MarginPadding(5);
+
                 InternalChildren = new Drawable[]
                 {
                     new DependencyProvidingContainer
@@ -120,7 +164,7 @@ namespace osu.Game.Overlays.FirstRunSetup
                         RelativeSizeAxes = Axes.Both,
                         Children = new Drawable[]
                         {
-                            new ScalingContainer(ScalingMode.Off)
+                            new ScalingContainer.ScalingDrawSizePreservingFillContainer(true)
                             {
                                 Masking = true,
                                 RelativeSizeAxes = Axes.Both,
@@ -137,10 +181,5 @@ namespace osu.Game.Overlays.FirstRunSetup
                 stack.Push(screen);
             }
         }
-
-        private class UIScaleSlider : OsuSliderBar<float>
-        {
-            public override LocalisableString TooltipText => base.TooltipText + "x";
-        }
     }
 }

From 3378c919013f67690a168fddd79d07d9baf2078c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 19 Apr 2022 16:53:41 +0900
Subject: [PATCH 4167/5547] Fix double applied padding

---
 osu.Game/Overlays/FirstRunSetupOverlay.cs | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/FirstRunSetupOverlay.cs b/osu.Game/Overlays/FirstRunSetupOverlay.cs
index 00396e6d85..1411539b37 100644
--- a/osu.Game/Overlays/FirstRunSetupOverlay.cs
+++ b/osu.Game/Overlays/FirstRunSetupOverlay.cs
@@ -165,7 +165,10 @@ namespace osu.Game.Overlays
                             {
                                 RelativeSizeAxes = Axes.X,
                                 AutoSizeAxes = Axes.Y,
-                                Padding = new MarginPadding(20),
+                                Padding = new MarginPadding(20)
+                                {
+                                    Top = 0 // provided by the stack container above.
+                                },
                                 Child = new GridContainer
                                 {
                                     RelativeSizeAxes = Axes.X,

From e2da1d76ca34999f4e3d45531b65ea8795838299 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 19 Apr 2022 16:59:25 +0900
Subject: [PATCH 4168/5547] Only show first run setup once per install

---
 osu.Game/Configuration/OsuConfigManager.cs |  3 +++
 osu.Game/Overlays/FirstRunSetupOverlay.cs  | 17 +++++++++++++++--
 2 files changed, 18 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Configuration/OsuConfigManager.cs b/osu.Game/Configuration/OsuConfigManager.cs
index 9aacb50684..2c04b03646 100644
--- a/osu.Game/Configuration/OsuConfigManager.cs
+++ b/osu.Game/Configuration/OsuConfigManager.cs
@@ -134,6 +134,8 @@ namespace osu.Game.Configuration
 
             SetDefault(OsuSetting.Version, string.Empty);
 
+            SetDefault(OsuSetting.ShowFirstRunSetup, true);
+
             SetDefault(OsuSetting.ScreenshotFormat, ScreenshotFormat.Jpg);
             SetDefault(OsuSetting.ScreenshotCaptureMenuCursor, false);
 
@@ -308,6 +310,7 @@ namespace osu.Game.Configuration
         BeatmapListingCardSize,
         ToolbarClockDisplayMode,
         Version,
+        ShowFirstRunSetup,
         ShowConvertedBeatmaps,
         Skin,
         ScreenshotFormat,
diff --git a/osu.Game/Overlays/FirstRunSetupOverlay.cs b/osu.Game/Overlays/FirstRunSetupOverlay.cs
index 1411539b37..207eeb0f6e 100644
--- a/osu.Game/Overlays/FirstRunSetupOverlay.cs
+++ b/osu.Game/Overlays/FirstRunSetupOverlay.cs
@@ -6,6 +6,7 @@
 using System;
 using System.Diagnostics;
 using osu.Framework.Allocation;
+using osu.Framework.Bindables;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
@@ -15,6 +16,7 @@ using osu.Framework.Graphics.Sprites;
 using osu.Framework.Input.Events;
 using osu.Framework.Localisation;
 using osu.Framework.Screens;
+using osu.Game.Configuration;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
@@ -42,6 +44,9 @@ namespace osu.Game.Overlays
         [Resolved]
         private INotificationOverlay notificationOverlay { get; set; } = null!;
 
+        [Resolved]
+        private OsuConfigManager config { get; set; } = null!;
+
         private ScreenStack? stack;
 
         public PurpleTriangleButton NextButton = null!;
@@ -50,6 +55,8 @@ namespace osu.Game.Overlays
         [Cached]
         private OverlayColourProvider colourProvider = new OverlayColourProvider(OverlayColourScheme.Purple);
 
+        private readonly Bindable<bool> showFirstRunSetup = new Bindable<bool>();
+
         private int? currentStepIndex;
 
         private const float scale_when_hidden = 0.9f;
@@ -216,8 +223,13 @@ namespace osu.Game.Overlays
         {
             base.LoadComplete();
 
-            // if we are valid for display, only do so after reaching the main menu.
-            performer.PerformFromScreen(_ => { Show(); }, new[] { typeof(MainMenu) });
+            config.BindWith(OsuSetting.ShowFirstRunSetup, showFirstRunSetup);
+
+            if (showFirstRunSetup.Value)
+            {
+                // if we are valid for display, only do so after reaching the main menu.
+                performer.PerformFromScreen(_ => { Show(); }, new[] { typeof(MainMenu) });
+            }
         }
 
         public override bool OnPressed(KeyBindingPressEvent<GlobalAction> e)
@@ -330,6 +342,7 @@ namespace osu.Game.Overlays
             }
             else
             {
+                showFirstRunSetup.Value = false;
                 currentStepIndex = null;
                 Hide();
             }

From c562004fe9784065fddc14fe56950148ed50eca2 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 19 Apr 2022 17:08:38 +0900
Subject: [PATCH 4169/5547] Add test coverage of only showing on first run

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

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunSetupOverlay.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunSetupOverlay.cs
index ff54e34ca0..00f1d4ac4e 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunSetupOverlay.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunSetupOverlay.cs
@@ -10,6 +10,7 @@ using osu.Framework.Allocation;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Screens;
 using osu.Framework.Testing;
+using osu.Game.Configuration;
 using osu.Game.Overlays;
 using osu.Game.Overlays.FirstRunSetup;
 using osu.Game.Overlays.Notifications;
@@ -29,9 +30,12 @@ namespace osu.Game.Tests.Visual.UserInterface
 
         private Notification lastNotification;
 
+        protected OsuConfigManager LocalConfig;
+
         [BackgroundDependencyLoader]
         private void load()
         {
+            Dependencies.Cache(LocalConfig = new OsuConfigManager(LocalStorage));
             Dependencies.CacheAs(performer.Object);
             Dependencies.CacheAs(notificationOverlay.Object);
         }
@@ -60,6 +64,29 @@ namespace osu.Game.Tests.Visual.UserInterface
             });
         }
 
+        [Test]
+        public void TestDoesntOpenOnSecondRun()
+        {
+            AddStep("set first run", () => LocalConfig.SetValue(OsuSetting.ShowFirstRunSetup, true));
+
+            AddUntilStep("step through", () =>
+            {
+                if (overlay.CurrentScreen?.IsLoaded != false) overlay.NextButton.TriggerClick();
+                return overlay.State.Value == Visibility.Hidden;
+            });
+
+            AddAssert("first run false", () => !LocalConfig.Get<bool>(OsuSetting.ShowFirstRunSetup));
+
+            AddStep("add overlay", () =>
+            {
+                Child = overlay = new FirstRunSetupOverlay();
+            });
+
+            AddWaitStep("wait some", 5);
+
+            AddAssert("overlay didn't show", () => overlay.State.Value == Visibility.Hidden);
+        }
+
         [TestCase(false)]
         [TestCase(true)]
         public void TestOverlayRunsToFinish(bool keyboard)

From 17eaa44af1c773d581a8a54455ef505fbf000b4f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 19 Apr 2022 17:40:35 +0900
Subject: [PATCH 4170/5547] Ensure notifications don't interrupt the first run
 setup process

---
 osu.Game/Overlays/FirstRunSetupOverlay.cs | 35 +++++++++++++++++++----
 osu.Game/Screens/OsuScreen.cs             |  2 +-
 2 files changed, 31 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Overlays/FirstRunSetupOverlay.cs b/osu.Game/Overlays/FirstRunSetupOverlay.cs
index 207eeb0f6e..b118e61fba 100644
--- a/osu.Game/Overlays/FirstRunSetupOverlay.cs
+++ b/osu.Game/Overlays/FirstRunSetupOverlay.cs
@@ -74,6 +74,8 @@ namespace osu.Game.Overlays
 
         private Container stackContainer = null!;
 
+        private Bindable<OverlayActivation>? overlayActivationMode;
+
         public FirstRunSetupOverlay()
         {
             RelativeSizeAxes = Axes.Both;
@@ -225,11 +227,7 @@ namespace osu.Game.Overlays
 
             config.BindWith(OsuSetting.ShowFirstRunSetup, showFirstRunSetup);
 
-            if (showFirstRunSetup.Value)
-            {
-                // if we are valid for display, only do so after reaching the main menu.
-                performer.PerformFromScreen(_ => { Show(); }, new[] { typeof(MainMenu) });
-            }
+            if (showFirstRunSetup.Value) Show();
         }
 
         public override bool OnPressed(KeyBindingPressEvent<GlobalAction> e)
@@ -258,6 +256,26 @@ namespace osu.Game.Overlays
             return base.OnPressed(e);
         }
 
+        public override void Show()
+        {
+            // if we are valid for display, only do so after reaching the main menu.
+            performer.PerformFromScreen(screen =>
+            {
+                MainMenu menu = (MainMenu)screen;
+
+                // Eventually I'd like to replace this with a better method that doesn't access the screen.
+                // Either this dialog would be converted to its own screen, or at very least be "hosted" by a screen pushed to the main menu.
+                // Alternatively, another method of disabling notifications could be added to `INotificationOverlay`.
+                if (menu != null)
+                {
+                    overlayActivationMode = menu.OverlayActivationMode.GetBoundCopy();
+                    overlayActivationMode.Value = OverlayActivation.UserTriggered;
+                }
+
+                base.Show();
+            }, new[] { typeof(MainMenu) });
+        }
+
         protected override void PopIn()
         {
             base.PopIn();
@@ -273,6 +291,13 @@ namespace osu.Game.Overlays
 
         protected override void PopOut()
         {
+            if (overlayActivationMode != null)
+            {
+                // If this is non-null we are guaranteed to have come from the main menu.
+                overlayActivationMode.Value = OverlayActivation.All;
+                overlayActivationMode = null;
+            }
+
             if (currentStepIndex != null)
             {
                 notificationOverlay.Post(new SimpleNotification
diff --git a/osu.Game/Screens/OsuScreen.cs b/osu.Game/Screens/OsuScreen.cs
index ed4901e1fa..d87a86cedf 100644
--- a/osu.Game/Screens/OsuScreen.cs
+++ b/osu.Game/Screens/OsuScreen.cs
@@ -48,7 +48,7 @@ namespace osu.Game.Screens
         /// </summary>
         protected virtual OverlayActivation InitialOverlayActivationMode => OverlayActivation.All;
 
-        protected readonly Bindable<OverlayActivation> OverlayActivationMode;
+        public readonly Bindable<OverlayActivation> OverlayActivationMode;
 
         IBindable<OverlayActivation> IOsuScreen.OverlayActivationMode => OverlayActivationMode;
 

From 2a3a0c1cd38dbe61d4941913b18785ed3a5732a6 Mon Sep 17 00:00:00 2001
From: chickensalt <nsdj.sharma@gmail.com>
Date: Tue, 19 Apr 2022 18:44:20 +1000
Subject: [PATCH 4171/5547] remove notification on trying to multi when logged
 out fixes #17877

---
 osu.Game/Screens/Menu/ButtonSystem.cs | 12 +-----------
 1 file changed, 1 insertion(+), 11 deletions(-)

diff --git a/osu.Game/Screens/Menu/ButtonSystem.cs b/osu.Game/Screens/Menu/ButtonSystem.cs
index 598c441042..6d09b6de9f 100644
--- a/osu.Game/Screens/Menu/ButtonSystem.cs
+++ b/osu.Game/Screens/Menu/ButtonSystem.cs
@@ -161,17 +161,7 @@ namespace osu.Game.Screens.Menu
         {
             if (api.State.Value != APIState.Online)
             {
-                notifications?.Post(new SimpleNotification
-                {
-                    Text = "You gotta be online to multi 'yo!",
-                    Icon = FontAwesome.Solid.Globe,
-                    Activated = () =>
-                    {
-                        loginOverlay?.Show();
-                        return true;
-                    }
-                });
-
+                loginOverlay?.Show();
                 return;
             }
 

From ce70c10afae4bc91f6cb751f8b59fd46c0488689 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 19 Apr 2022 18:00:39 +0900
Subject: [PATCH 4172/5547] Tidy up unused dependencies

---
 osu.Game/Overlays/FirstRunSetup/ScreenUIScale.cs | 7 ++-----
 1 file changed, 2 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Overlays/FirstRunSetup/ScreenUIScale.cs b/osu.Game/Overlays/FirstRunSetup/ScreenUIScale.cs
index 52aeb8082e..e632170975 100644
--- a/osu.Game/Overlays/FirstRunSetup/ScreenUIScale.cs
+++ b/osu.Game/Overlays/FirstRunSetup/ScreenUIScale.cs
@@ -29,11 +29,8 @@ namespace osu.Game.Overlays.FirstRunSetup
 {
     public class ScreenUIScale : FirstRunSetupScreen
     {
-        [Resolved]
-        private OsuConfigManager osuConfig { get; set; }
-
         [BackgroundDependencyLoader]
-        private void load(RulesetStore rulesets, BeatmapManager beatmaps)
+        private void load(OsuConfigManager config)
         {
             Content.Children = new Drawable[]
             {
@@ -46,7 +43,7 @@ namespace osu.Game.Overlays.FirstRunSetup
                 new SettingsSlider<float, UIScaleSlider>
                 {
                     LabelText = GraphicsSettingsStrings.UIScaling,
-                    Current = osuConfig.GetBindable<float>(OsuSetting.UIScale),
+                    Current = config.GetBindable<float>(OsuSetting.UIScale),
                     KeyboardStep = 0.01f,
                 },
                 new InverseScalingDrawSizePreservingFillContainer

From 75a6e9fd7f7bbf82325051c89fe7eab3caa60dcc Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 19 Apr 2022 18:10:10 +0900
Subject: [PATCH 4173/5547] Convert to use `nullable` and rearrange fields

---
 .../Skinning/Legacy/LegacyMainCirclePiece.cs  | 47 +++++++++----------
 1 file changed, 23 insertions(+), 24 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyMainCirclePiece.cs b/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyMainCirclePiece.cs
index 9d14041dd8..1fedc7daae 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyMainCirclePiece.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyMainCirclePiece.cs
@@ -1,7 +1,7 @@
+#nullable enable
 // 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 JetBrains.Annotations;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Extensions.ObjectExtensions;
@@ -33,9 +33,25 @@ namespace osu.Game.Rulesets.Osu.Skinning.Legacy
         /// If the "circle" texture could not be found with this prefix,
         /// then it is nullified and the default prefix "hitcircle" is used instead.
         /// </remarks>
-        private string priorityLookupPrefix;
+        private string? priorityLookupPrefix;
 
-        public LegacyMainCirclePiece(string priorityLookupPrefix = null, bool hasNumber = true)
+        private Drawable hitCircleSprite = null!;
+
+        protected Container OverlayLayer { get; private set; } = null!;
+
+        private Drawable hitCircleOverlay = null!;
+        private SkinnableSpriteText hitCircleText = null!;
+
+        private readonly Bindable<Color4> accentColour = new Bindable<Color4>();
+        private readonly IBindable<int> indexInCurrentCombo = new Bindable<int>();
+
+        [Resolved(canBeNull: true)]
+        private DrawableHitObject? drawableObject { get; set; }
+
+        [Resolved]
+        private ISkinSource skin { get; set; } = null!;
+
+        public LegacyMainCirclePiece(string? priorityLookupPrefix = null, bool hasNumber = true)
         {
             this.priorityLookupPrefix = priorityLookupPrefix;
             this.hasNumber = hasNumber;
@@ -43,30 +59,13 @@ namespace osu.Game.Rulesets.Osu.Skinning.Legacy
             Size = new Vector2(OsuHitObject.OBJECT_RADIUS * 2);
         }
 
-        private Drawable hitCircleSprite;
-
-        protected Container OverlayLayer { get; private set; }
-
-        private Drawable hitCircleOverlay;
-        private SkinnableSpriteText hitCircleText;
-
-        private readonly Bindable<Color4> accentColour = new Bindable<Color4>();
-        private readonly IBindable<int> indexInCurrentCombo = new Bindable<int>();
-
-        [Resolved(canBeNull: true)]
-        [CanBeNull]
-        private DrawableHitObject drawableObject { get; set; }
-
-        [Resolved]
-        private ISkinSource skin { get; set; }
-
         [BackgroundDependencyLoader]
         private void load()
         {
-            var drawableOsuObject = (DrawableOsuHitObject)drawableObject;
+            var drawableOsuObject = (DrawableOsuHitObject?)drawableObject;
 
             // attempt lookup using priority specification
-            Texture baseTexture = getTexture(string.Empty);
+            Texture? baseTexture = getTexture(string.Empty);
 
             // if the base texture was not found using the priority specification, nullify the specification and fall back to "hitcircle".
             if (baseTexture == null)
@@ -122,10 +121,10 @@ namespace osu.Game.Rulesets.Osu.Skinning.Legacy
                 indexInCurrentCombo.BindTo(drawableOsuObject.IndexInCurrentComboBindable);
             }
 
-            Texture getTexture(string name)
+            Texture? getTexture(string name)
                 => skin.GetTexture($"{priorityLookupPrefix ?? @"hitcircle"}{name}");
 
-            Drawable getAnimation(string name, double frameLength)
+            Drawable? getAnimation(string name, double frameLength)
                 => skin.GetAnimation($"{priorityLookupPrefix ?? @"hitcircle"}{name}", true, true, frameLength: frameLength);
         }
 

From e8adbb319bd1a4d6eb6c16218cda13870a8dcdd4 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 19 Apr 2022 22:57:04 +0900
Subject: [PATCH 4174/5547] Skip first run setup in `OsuGameTestScene`s

---
 osu.Game/Tests/Visual/OsuGameTestScene.cs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Game/Tests/Visual/OsuGameTestScene.cs b/osu.Game/Tests/Visual/OsuGameTestScene.cs
index 34d7723fa3..7a6f8c8cfb 100644
--- a/osu.Game/Tests/Visual/OsuGameTestScene.cs
+++ b/osu.Game/Tests/Visual/OsuGameTestScene.cs
@@ -156,6 +156,7 @@ namespace osu.Game.Tests.Visual
                 base.LoadComplete();
 
                 LocalConfig.SetValue(OsuSetting.IntroSequence, IntroSequence.Circles);
+                LocalConfig.SetValue(OsuSetting.ShowFirstRunSetup, false);
 
                 API.Login("Rhythm Champion", "osu!");
 

From 44c822f34d7a332ba41381d871c42814e9a6daea Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Tue, 19 Apr 2022 16:56:55 +0100
Subject: [PATCH 4175/5547] Use normal `OsuScrollContainer` for `ChannelList`

---
 .../Overlays/Chat/ChannelList/ChannelList.cs  | 28 +------------------
 1 file changed, 1 insertion(+), 27 deletions(-)

diff --git a/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs b/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs
index 5c2a1ad89f..94c1a99a81 100644
--- a/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs
+++ b/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs
@@ -40,7 +40,7 @@ namespace osu.Game.Overlays.Chat.ChannelList
                     RelativeSizeAxes = Axes.Both,
                     Colour = colourProvider.Background6,
                 },
-                new ChannelListScrollContainer
+                new OsuScrollContainer
                 {
                     Padding = new MarginPadding { Vertical = 7 },
                     RelativeSizeAxes = Axes.Both,
@@ -131,31 +131,5 @@ namespace osu.Game.Overlays.Chat.ChannelList
                 });
             }
         }
-
-        private class ChannelListScrollContainer : OsuScrollContainer
-        {
-            protected override ScrollbarContainer CreateScrollbar(Direction direction)
-                => new ChannelListScrollBar(direction);
-
-            protected class ChannelListScrollBar : OsuScrollbar
-            {
-                private const float bar_size = 4;
-                private const float bar_margin = 7;
-
-                public ChannelListScrollBar(Direction scrollDir)
-                    : base(scrollDir)
-                {
-                    Size = new Vector2(bar_size);
-                    Margin = new MarginPadding { Horizontal = bar_margin };
-                    CornerRadius = 2;
-                }
-
-                public override void ResizeTo(float val, int duration = 0, Easing easing = Easing.None)
-                {
-                    Vector2 size = new Vector2(bar_size, val);
-                    this.ResizeTo(size, duration, easing);
-                }
-            }
-        }
     }
 }

From 033b556be58fe1b780d52d0b6c90b75eaea23f31 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Tue, 19 Apr 2022 19:39:06 +0300
Subject: [PATCH 4176/5547] Simplify texture lookup further

---
 .../Skinning/Legacy/LegacyMainCirclePiece.cs  | 35 +++++--------------
 1 file changed, 9 insertions(+), 26 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyMainCirclePiece.cs b/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyMainCirclePiece.cs
index 1fedc7daae..2107de61b6 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyMainCirclePiece.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyMainCirclePiece.cs
@@ -8,7 +8,6 @@ using osu.Framework.Extensions.ObjectExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Sprites;
-using osu.Framework.Graphics.Textures;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Rulesets.Objects.Drawables;
@@ -24,16 +23,12 @@ namespace osu.Game.Rulesets.Osu.Skinning.Legacy
     {
         public override bool RemoveCompletedTransforms => false;
 
-        private readonly bool hasNumber;
-
         /// <summary>
         /// A prioritised prefix to perform texture lookups with.
         /// </summary>
-        /// <remarks>
-        /// If the "circle" texture could not be found with this prefix,
-        /// then it is nullified and the default prefix "hitcircle" is used instead.
-        /// </remarks>
-        private string? priorityLookupPrefix;
+        private readonly string? priorityLookupPrefix;
+
+        private readonly bool hasNumber;
 
         private Drawable hitCircleSprite = null!;
 
@@ -64,23 +59,17 @@ namespace osu.Game.Rulesets.Osu.Skinning.Legacy
         {
             var drawableOsuObject = (DrawableOsuHitObject?)drawableObject;
 
-            // attempt lookup using priority specification
-            Texture? baseTexture = getTexture(string.Empty);
-
-            // if the base texture was not found using the priority specification, nullify the specification and fall back to "hitcircle".
-            if (baseTexture == null)
-            {
-                priorityLookupPrefix = null;
-                baseTexture = getTexture(string.Empty);
-            }
+            // if a base texture for the specified prefix exists, continue using it for subsequent lookups.
+            // otherwise fall back to the default prefix "hitcircle".
+            string circleName = (priorityLookupPrefix != null && skin.GetTexture(priorityLookupPrefix) != null) ? priorityLookupPrefix : @"hitcircle";
 
             // at this point, any further texture fetches should be correctly using the priority source if the base texture was retrieved using it.
-            // the flow above handles the case where a sliderendcircle.png is retrieved from the skin, but sliderendcircleoverlay.png doesn't exist.
+            // the conditional above handles the case where a sliderendcircle.png is retrieved from the skin, but sliderendcircleoverlay.png doesn't exist.
             // expected behaviour in this scenario is not showing the overlay, rather than using hitcircleoverlay.png.
 
             InternalChildren = new[]
             {
-                hitCircleSprite = new KiaiFlashingDrawable(() => new Sprite { Texture = baseTexture })
+                hitCircleSprite = new KiaiFlashingDrawable(() => new Sprite { Texture = skin.GetTexture(circleName) })
                 {
                     Anchor = Anchor.Centre,
                     Origin = Anchor.Centre,
@@ -89,7 +78,7 @@ namespace osu.Game.Rulesets.Osu.Skinning.Legacy
                 {
                     Anchor = Anchor.Centre,
                     Origin = Anchor.Centre,
-                    Child = hitCircleOverlay = new KiaiFlashingDrawable(() => getAnimation(@"overlay", 1000 / 2d))
+                    Child = hitCircleOverlay = new KiaiFlashingDrawable(() => skin.GetAnimation(@$"{circleName}overlay", true, true, frameLength: 1000 / 2d))
                     {
                         Anchor = Anchor.Centre,
                         Origin = Anchor.Centre,
@@ -120,12 +109,6 @@ namespace osu.Game.Rulesets.Osu.Skinning.Legacy
                 accentColour.BindTo(drawableOsuObject.AccentColour);
                 indexInCurrentCombo.BindTo(drawableOsuObject.IndexInCurrentComboBindable);
             }
-
-            Texture? getTexture(string name)
-                => skin.GetTexture($"{priorityLookupPrefix ?? @"hitcircle"}{name}");
-
-            Drawable? getAnimation(string name, double frameLength)
-                => skin.GetAnimation($"{priorityLookupPrefix ?? @"hitcircle"}{name}", true, true, frameLength: frameLength);
         }
 
         protected override void LoadComplete()

From 813dc2dd78fd0ba65bcae4caddd289be67447310 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Tue, 19 Apr 2022 19:46:29 +0300
Subject: [PATCH 4177/5547] Fix wrong prefix for default priority lookup in
 test

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

diff --git a/osu.Game.Rulesets.Osu.Tests/LegacyMainCirclePieceTest.cs b/osu.Game.Rulesets.Osu.Tests/LegacyMainCirclePieceTest.cs
index 766db25d71..c9eeef3c01 100644
--- a/osu.Game.Rulesets.Osu.Tests/LegacyMainCirclePieceTest.cs
+++ b/osu.Game.Rulesets.Osu.Tests/LegacyMainCirclePieceTest.cs
@@ -29,7 +29,7 @@ namespace osu.Game.Rulesets.Osu.Tests
                 // available textures
                 new[] { @"hitcircle", @"hitcircleoverlay" },
                 // priority lookup
-                @"",
+                null,
                 // expected circle and overlay
                 @"hitcircle", @"hitcircleoverlay",
             },

From a96664295bfd6cec5adc4b9c222ca47707e5f207 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Tue, 19 Apr 2022 19:48:44 +0300
Subject: [PATCH 4178/5547] Fix nullability preprocessor placed over the
 copyright header

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

diff --git a/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyMainCirclePiece.cs b/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyMainCirclePiece.cs
index 2107de61b6..db4d643046 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyMainCirclePiece.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyMainCirclePiece.cs
@@ -1,4 +1,3 @@
-#nullable enable
 // 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.
 
@@ -17,6 +16,8 @@ using osu.Game.Skinning;
 using osuTK;
 using osuTK.Graphics;
 
+#nullable enable
+
 namespace osu.Game.Rulesets.Osu.Skinning.Legacy
 {
     public class LegacyMainCirclePiece : CompositeDrawable

From fd20c2bdcd7c174b27efded6d8e371ec2233ba1f Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 20 Apr 2022 00:24:18 +0300
Subject: [PATCH 4179/5547] Change circle/overlay sprite fields to `protected`
 for better test assertion

---
 .../LegacyMainCirclePieceTest.cs              | 25 ++++++++++++-------
 .../Skinning/Legacy/LegacyMainCirclePiece.cs  | 20 +++++++--------
 2 files changed, 26 insertions(+), 19 deletions(-)

diff --git a/osu.Game.Rulesets.Osu.Tests/LegacyMainCirclePieceTest.cs b/osu.Game.Rulesets.Osu.Tests/LegacyMainCirclePieceTest.cs
index c9eeef3c01..fd5b6fd752 100644
--- a/osu.Game.Rulesets.Osu.Tests/LegacyMainCirclePieceTest.cs
+++ b/osu.Game.Rulesets.Osu.Tests/LegacyMainCirclePieceTest.cs
@@ -28,7 +28,7 @@ namespace osu.Game.Rulesets.Osu.Tests
             {
                 // available textures
                 new[] { @"hitcircle", @"hitcircleoverlay" },
-                // priority lookup
+                // priority lookup prefix
                 null,
                 // expected circle and overlay
                 @"hitcircle", @"hitcircleoverlay",
@@ -66,8 +66,7 @@ namespace osu.Game.Rulesets.Osu.Tests
         [TestCaseSource(nameof(texture_priority_cases))]
         public void TestTexturePriorities(string[] textureFilenames, string priorityLookup, string? expectedCircle, string? expectedOverlay)
         {
-            Sprite? circleSprite = null;
-            Sprite? overlaySprite = null;
+            TestLegacyMainCirclePiece piece = null!;
 
             AddStep("load circle piece", () =>
             {
@@ -80,18 +79,26 @@ namespace osu.Game.Rulesets.Osu.Tests
                 Child = new DependencyProvidingContainer
                 {
                     CachedDependencies = new (Type, object)[] { (typeof(ISkinSource), skin.Object) },
-                    Child = new LegacyMainCirclePiece(priorityLookup, false),
+                    Child = piece = new TestLegacyMainCirclePiece(priorityLookup),
                 };
 
                 var sprites = this.ChildrenOfType<Sprite>().Where(s => s.Texture.AssetName != null).DistinctBy(s => s.Texture.AssetName).ToArray();
                 Debug.Assert(sprites.Length <= 2);
-
-                circleSprite = sprites.ElementAtOrDefault(0);
-                overlaySprite = sprites.ElementAtOrDefault(1);
             });
 
-            AddAssert("check circle sprite", () => circleSprite?.Texture?.AssetName == expectedCircle);
-            AddAssert("check overlay sprite", () => overlaySprite?.Texture?.AssetName == expectedOverlay);
+            AddAssert("check circle sprite", () => piece.CircleSprite?.Texture?.AssetName == expectedCircle);
+            AddAssert("check overlay sprite", () => piece.OverlaySprite?.Texture?.AssetName == expectedOverlay);
+        }
+
+        private class TestLegacyMainCirclePiece : LegacyMainCirclePiece
+        {
+            public new Sprite? CircleSprite => base.CircleSprite.ChildrenOfType<Sprite>().DistinctBy(s => s.Texture.AssetName).SingleOrDefault();
+            public new Sprite? OverlaySprite => base.OverlaySprite.ChildrenOfType<Sprite>().DistinctBy(s => s.Texture.AssetName).SingleOrDefault();
+
+            public TestLegacyMainCirclePiece(string? priorityLookupPrefix)
+                : base(priorityLookupPrefix, false)
+            {
+            }
         }
     }
 }
diff --git a/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyMainCirclePiece.cs b/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyMainCirclePiece.cs
index db4d643046..391147648f 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyMainCirclePiece.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyMainCirclePiece.cs
@@ -31,11 +31,11 @@ namespace osu.Game.Rulesets.Osu.Skinning.Legacy
 
         private readonly bool hasNumber;
 
-        private Drawable hitCircleSprite = null!;
+        protected Drawable CircleSprite = null!;
+        protected Drawable OverlaySprite = null!;
 
         protected Container OverlayLayer { get; private set; } = null!;
 
-        private Drawable hitCircleOverlay = null!;
         private SkinnableSpriteText hitCircleText = null!;
 
         private readonly Bindable<Color4> accentColour = new Bindable<Color4>();
@@ -70,7 +70,7 @@ namespace osu.Game.Rulesets.Osu.Skinning.Legacy
 
             InternalChildren = new[]
             {
-                hitCircleSprite = new KiaiFlashingDrawable(() => new Sprite { Texture = skin.GetTexture(circleName) })
+                CircleSprite = new KiaiFlashingDrawable(() => new Sprite { Texture = skin.GetTexture(circleName) })
                 {
                     Anchor = Anchor.Centre,
                     Origin = Anchor.Centre,
@@ -79,7 +79,7 @@ namespace osu.Game.Rulesets.Osu.Skinning.Legacy
                 {
                     Anchor = Anchor.Centre,
                     Origin = Anchor.Centre,
-                    Child = hitCircleOverlay = new KiaiFlashingDrawable(() => skin.GetAnimation(@$"{circleName}overlay", true, true, frameLength: 1000 / 2d))
+                    Child = OverlaySprite = new KiaiFlashingDrawable(() => skin.GetAnimation(@$"{circleName}overlay", true, true, frameLength: 1000 / 2d))
                     {
                         Anchor = Anchor.Centre,
                         Origin = Anchor.Centre,
@@ -103,7 +103,7 @@ namespace osu.Game.Rulesets.Osu.Skinning.Legacy
             bool overlayAboveNumber = skin.GetConfig<OsuSkinConfiguration, bool>(OsuSkinConfiguration.HitCircleOverlayAboveNumber)?.Value ?? true;
 
             if (overlayAboveNumber)
-                OverlayLayer.ChangeChildDepth(hitCircleOverlay, float.MinValue);
+                OverlayLayer.ChangeChildDepth(OverlaySprite, float.MinValue);
 
             if (drawableOsuObject != null)
             {
@@ -116,7 +116,7 @@ namespace osu.Game.Rulesets.Osu.Skinning.Legacy
         {
             base.LoadComplete();
 
-            accentColour.BindValueChanged(colour => hitCircleSprite.Colour = LegacyColourCompatibility.DisallowZeroAlpha(colour.NewValue), true);
+            accentColour.BindValueChanged(colour => CircleSprite.Colour = LegacyColourCompatibility.DisallowZeroAlpha(colour.NewValue), true);
             if (hasNumber)
                 indexInCurrentCombo.BindValueChanged(index => hitCircleText.Text = (index.NewValue + 1).ToString(), true);
 
@@ -136,11 +136,11 @@ namespace osu.Game.Rulesets.Osu.Skinning.Legacy
                 switch (state)
                 {
                     case ArmedState.Hit:
-                        hitCircleSprite.FadeOut(legacy_fade_duration, Easing.Out);
-                        hitCircleSprite.ScaleTo(1.4f, legacy_fade_duration, Easing.Out);
+                        CircleSprite.FadeOut(legacy_fade_duration, Easing.Out);
+                        CircleSprite.ScaleTo(1.4f, legacy_fade_duration, Easing.Out);
 
-                        hitCircleOverlay.FadeOut(legacy_fade_duration, Easing.Out);
-                        hitCircleOverlay.ScaleTo(1.4f, legacy_fade_duration, Easing.Out);
+                        OverlaySprite.FadeOut(legacy_fade_duration, Easing.Out);
+                        OverlaySprite.ScaleTo(1.4f, legacy_fade_duration, Easing.Out);
 
                         if (hasNumber)
                         {

From 858c8f927f7baccc9328cb85847d0ea510d2b0a9 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 20 Apr 2022 00:27:02 +0300
Subject: [PATCH 4180/5547] Attach comment explaining purpose of `CallBase`

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

diff --git a/osu.Game.Rulesets.Osu.Tests/LegacyMainCirclePieceTest.cs b/osu.Game.Rulesets.Osu.Tests/LegacyMainCirclePieceTest.cs
index fd5b6fd752..d8c10b814d 100644
--- a/osu.Game.Rulesets.Osu.Tests/LegacyMainCirclePieceTest.cs
+++ b/osu.Game.Rulesets.Osu.Tests/LegacyMainCirclePieceTest.cs
@@ -72,7 +72,11 @@ namespace osu.Game.Rulesets.Osu.Tests
             {
                 var skin = new Mock<ISkinSource>();
 
+                // shouldn't be required as GetTexture(string) calls GetTexture(string, WrapMode, WrapMode) by default,
+                // but moq doesn't handle that well, therefore explicitly requiring to use `CallBase`:
+                // https://github.com/moq/moq4/issues/972
                 skin.Setup(s => s.GetTexture(It.IsAny<string>())).CallBase();
+
                 skin.Setup(s => s.GetTexture(It.IsIn(textureFilenames), It.IsAny<WrapMode>(), It.IsAny<WrapMode>()))
                     .Returns((string componentName, WrapMode _, WrapMode __) => new Texture(1, 1) { AssetName = componentName });
 

From 4f8065160684cbc49e7a20cad355663e245a5578 Mon Sep 17 00:00:00 2001
From: chickensalt <nsdj.sharma@gmail.com>
Date: Wed, 20 Apr 2022 10:33:06 +1000
Subject: [PATCH 4181/5547] implement 2a3a0c1 for playlists as well

---
 osu.Game/Screens/Menu/ButtonSystem.cs | 12 +-----------
 1 file changed, 1 insertion(+), 11 deletions(-)

diff --git a/osu.Game/Screens/Menu/ButtonSystem.cs b/osu.Game/Screens/Menu/ButtonSystem.cs
index 6d09b6de9f..6d9941ba87 100644
--- a/osu.Game/Screens/Menu/ButtonSystem.cs
+++ b/osu.Game/Screens/Menu/ButtonSystem.cs
@@ -172,17 +172,7 @@ namespace osu.Game.Screens.Menu
         {
             if (api.State.Value != APIState.Online)
             {
-                notifications?.Post(new SimpleNotification
-                {
-                    Text = "You gotta be online to view playlists 'yo!",
-                    Icon = FontAwesome.Solid.Globe,
-                    Activated = () =>
-                    {
-                        loginOverlay?.Show();
-                        return true;
-                    }
-                });
-
+                loginOverlay?.Show();
                 return;
             }
 

From f5863c20307b8e4ad8123fb25641b588a782dbd7 Mon Sep 17 00:00:00 2001
From: chickensalt <nsdj.sharma@gmail.com>
Date: Wed, 20 Apr 2022 13:40:02 +1000
Subject: [PATCH 4182/5547] remove unused import

---
 osu.Game/Screens/Menu/ButtonSystem.cs | 1 -
 1 file changed, 1 deletion(-)

diff --git a/osu.Game/Screens/Menu/ButtonSystem.cs b/osu.Game/Screens/Menu/ButtonSystem.cs
index 6d9941ba87..b59e42551a 100644
--- a/osu.Game/Screens/Menu/ButtonSystem.cs
+++ b/osu.Game/Screens/Menu/ButtonSystem.cs
@@ -26,7 +26,6 @@ using osu.Game.Input.Bindings;
 using osu.Game.Localisation;
 using osu.Game.Online.API;
 using osu.Game.Overlays;
-using osu.Game.Overlays.Notifications;
 using osuTK;
 using osuTK.Graphics;
 using osuTK.Input;

From d46329f55a4fc651b34ac654e963eb79a6e73f23 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 20 Apr 2022 12:51:55 +0900
Subject: [PATCH 4183/5547] Remove unused dependency

---
 osu.Game/Screens/Menu/ButtonSystem.cs | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/osu.Game/Screens/Menu/ButtonSystem.cs b/osu.Game/Screens/Menu/ButtonSystem.cs
index b59e42551a..2d18dce6da 100644
--- a/osu.Game/Screens/Menu/ButtonSystem.cs
+++ b/osu.Game/Screens/Menu/ButtonSystem.cs
@@ -116,9 +116,6 @@ namespace osu.Game.Screens.Menu
         [Resolved]
         private IAPIProvider api { get; set; }
 
-        [Resolved(CanBeNull = true)]
-        private INotificationOverlay notifications { get; set; }
-
         [Resolved(CanBeNull = true)]
         private LoginOverlay loginOverlay { get; set; }
 

From 488fc9db67b82baebdc59f71477569960580c439 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 20 Apr 2022 14:48:51 +0900
Subject: [PATCH 4184/5547] Reverse content colours to match design spec

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

diff --git a/osu.Game/Overlays/FirstRunSetupOverlay.cs b/osu.Game/Overlays/FirstRunSetupOverlay.cs
index b118e61fba..7ad7e6f770 100644
--- a/osu.Game/Overlays/FirstRunSetupOverlay.cs
+++ b/osu.Game/Overlays/FirstRunSetupOverlay.cs
@@ -143,14 +143,14 @@ namespace osu.Game.Overlays
                                             {
                                                 Text = FirstRunSetupOverlayStrings.FirstRunSetup,
                                                 Font = OsuFont.Default.With(size: 32),
-                                                Colour = colourProvider.Content2,
+                                                Colour = colourProvider.Content1,
                                                 Anchor = Anchor.TopCentre,
                                                 Origin = Anchor.TopCentre,
                                             },
                                             new OsuTextFlowContainer
                                             {
                                                 Text = FirstRunSetupOverlayStrings.SetupOsuToSuitYou,
-                                                Colour = colourProvider.Content1,
+                                                Colour = colourProvider.Content2,
                                                 Anchor = Anchor.TopCentre,
                                                 Origin = Anchor.TopCentre,
                                                 AutoSizeAxes = Axes.Both,

From 9797e2d8871682f9a036a625e5230f324788ec52 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 20 Apr 2022 14:49:17 +0900
Subject: [PATCH 4185/5547] Rename `showLastStep` method to avoid ambiguity

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

diff --git a/osu.Game/Overlays/FirstRunSetupOverlay.cs b/osu.Game/Overlays/FirstRunSetupOverlay.cs
index 7ad7e6f770..0e8919fd82 100644
--- a/osu.Game/Overlays/FirstRunSetupOverlay.cs
+++ b/osu.Game/Overlays/FirstRunSetupOverlay.cs
@@ -200,7 +200,7 @@ namespace osu.Game.Overlays
                                             {
                                                 Width = 200,
                                                 Text = CommonStrings.Back,
-                                                Action = showLastStep,
+                                                Action = showPreviousStep,
                                                 Enabled = { Value = false },
                                             },
                                             Empty(),
@@ -336,7 +336,7 @@ namespace osu.Game.Overlays
             showNextStep();
         }
 
-        private void showLastStep()
+        private void showPreviousStep()
         {
             if (currentStepIndex == 0)
                 return;

From 66373bf038f01e1ff5b26bdc134530db504ff6c4 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 20 Apr 2022 14:50:41 +0900
Subject: [PATCH 4186/5547] Move back button enable handling to shared method

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

diff --git a/osu.Game/Overlays/FirstRunSetupOverlay.cs b/osu.Game/Overlays/FirstRunSetupOverlay.cs
index 0e8919fd82..c74adbabae 100644
--- a/osu.Game/Overlays/FirstRunSetupOverlay.cs
+++ b/osu.Game/Overlays/FirstRunSetupOverlay.cs
@@ -346,8 +346,6 @@ namespace osu.Game.Overlays
             stack.CurrentScreen.Exit();
             currentStepIndex--;
 
-            BackButton.Enabled.Value = currentStepIndex != 0;
-
             updateButtonText();
         }
 
@@ -358,8 +356,6 @@ namespace osu.Game.Overlays
 
             currentStepIndex++;
 
-            BackButton.Enabled.Value = currentStepIndex > 0;
-
             if (currentStepIndex < steps.Length)
             {
                 stack.Push((Screen)Activator.CreateInstance(steps[currentStepIndex.Value].ScreenType));
@@ -377,6 +373,8 @@ namespace osu.Game.Overlays
         {
             Debug.Assert(currentStepIndex != null);
 
+            BackButton.Enabled.Value = currentStepIndex != 0;
+
             NextButton.Text = currentStepIndex + 1 < steps.Length
                 ? FirstRunSetupOverlayStrings.Next(steps[currentStepIndex.Value + 1].Description)
                 : CommonStrings.Finish;

From 7e7fa633f0b2fdde41d9a22c4ce052cb46762201 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 20 Apr 2022 14:51:16 +0900
Subject: [PATCH 4187/5547] Use direct localised string reference in test

---
 .../Visual/UserInterface/TestSceneFirstRunSetupOverlay.cs      | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunSetupOverlay.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunSetupOverlay.cs
index 00f1d4ac4e..8a9ed50725 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunSetupOverlay.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunSetupOverlay.cs
@@ -11,6 +11,7 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Screens;
 using osu.Framework.Testing;
 using osu.Game.Configuration;
+using osu.Game.Localisation;
 using osu.Game.Overlays;
 using osu.Game.Overlays.FirstRunSetup;
 using osu.Game.Overlays.Notifications;
@@ -126,7 +127,7 @@ namespace osu.Game.Tests.Visual.UserInterface
                 if (overlay.CurrentScreen?.IsLoaded != false)
                     nextButton.TriggerClick();
 
-                return nextButton.Text.ToString() == "Finish";
+                return nextButton.Text.ToString() == CommonStrings.Finish;
             });
 
             AddUntilStep("step back to start", () =>

From 8d31b0bc015461a5c05bb7e0ff9747823cdded5e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 20 Apr 2022 15:05:07 +0900
Subject: [PATCH 4188/5547] Split out the base design of sheared overlay into
 its own abstract class

This will allow for reuse with the first-run overlay.
---
 .../UserInterface/PopupScreenTitle.cs         |   4 +-
 osu.Game/Overlays/Mods/ModSelectScreen.cs     | 101 ++++---------
 .../Overlays/Mods/ShearedOverlayContainer.cs  | 136 ++++++++++++++++++
 3 files changed, 165 insertions(+), 76 deletions(-)
 create mode 100644 osu.Game/Overlays/Mods/ShearedOverlayContainer.cs

diff --git a/osu.Game/Graphics/UserInterface/PopupScreenTitle.cs b/osu.Game/Graphics/UserInterface/PopupScreenTitle.cs
index 5b7db09e77..2e5519726b 100644
--- a/osu.Game/Graphics/UserInterface/PopupScreenTitle.cs
+++ b/osu.Game/Graphics/UserInterface/PopupScreenTitle.cs
@@ -21,6 +21,8 @@ namespace osu.Game.Graphics.UserInterface
 {
     public class PopupScreenTitle : CompositeDrawable
     {
+        public const float HEIGHT = main_area_height + 2 * corner_radius;
+
         public LocalisableString Title
         {
             set => titleSpriteText.Text = value;
@@ -67,7 +69,7 @@ namespace osu.Game.Graphics.UserInterface
                     underlayContainer = new Container
                     {
                         RelativeSizeAxes = Axes.X,
-                        Height = main_area_height + 2 * corner_radius,
+                        Height = HEIGHT,
                         CornerRadius = corner_radius,
                         Masking = true,
                         BorderThickness = 2,
diff --git a/osu.Game/Overlays/Mods/ModSelectScreen.cs b/osu.Game/Overlays/Mods/ModSelectScreen.cs
index 62080ec1b5..6e8684478e 100644
--- a/osu.Game/Overlays/Mods/ModSelectScreen.cs
+++ b/osu.Game/Overlays/Mods/ModSelectScreen.cs
@@ -9,7 +9,6 @@ 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.Framework.Layout;
 using osu.Game.Configuration;
@@ -21,39 +20,27 @@ using osuTK.Input;
 
 namespace osu.Game.Overlays.Mods
 {
-    public class ModSelectScreen : OsuFocusedOverlayContainer
+    public class ModSelectScreen : ShearedOverlayContainer
     {
-        [Cached]
-        private OverlayColourProvider colourProvider = new OverlayColourProvider(OverlayColourScheme.Green);
+        protected override OverlayColourScheme ColourScheme => OverlayColourScheme.Green;
 
         [Cached]
         public Bindable<IReadOnlyList<Mod>> SelectedMods { get; private set; } = new Bindable<IReadOnlyList<Mod>>(Array.Empty<Mod>());
 
-        protected override bool StartHidden => true;
-
         private readonly BindableBool customisationVisible = new BindableBool();
 
         private DifficultyMultiplierDisplay multiplierDisplay;
         private ModSettingsArea modSettingsArea;
         private FillFlowContainer<ModColumn> columnFlow;
         private GridContainer grid;
-        private Container mainContent;
-
-        private PopupScreenTitle header;
-        private Container footer;
 
         [BackgroundDependencyLoader]
         private void load()
         {
-            RelativeSizeAxes = Axes.Both;
-            RelativePositionAxes = Axes.Both;
-
-            InternalChildren = new Drawable[]
+            MainAreaContent.AddRange(new Drawable[]
             {
-                mainContent = new Container
+                new Container
                 {
-                    Origin = Anchor.BottomCentre,
-                    Anchor = Anchor.BottomCentre,
                     RelativeSizeAxes = Axes.Both,
                     Children = new Drawable[]
                     {
@@ -62,24 +49,11 @@ namespace osu.Game.Overlays.Mods
                             RelativeSizeAxes = Axes.Both,
                             RowDimensions = new[]
                             {
-                                new Dimension(GridSizeMode.AutoSize),
                                 new Dimension(GridSizeMode.AutoSize),
                                 new Dimension(),
-                                new Dimension(GridSizeMode.Absolute, 75),
                             },
                             Content = new[]
                             {
-                                new Drawable[]
-                                {
-                                    header = new PopupScreenTitle
-                                    {
-                                        Anchor = Anchor.TopCentre,
-                                        Origin = Anchor.TopCentre,
-                                        Title = "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.",
-                                        Close = Hide
-                                    }
-                                },
                                 new Drawable[]
                                 {
                                     new Container
@@ -120,6 +94,7 @@ namespace osu.Game.Overlays.Mods
                                                 Child = columnFlow = new ModColumnContainer
                                                 {
                                                     Direction = FillDirection.Horizontal,
+                                                    Shear = new Vector2(ModPanel.SHEAR_X, 0),
                                                     RelativeSizeAxes = Axes.Y,
                                                     AutoSizeAxes = Axes.X,
                                                     Spacing = new Vector2(10, 0),
@@ -137,52 +112,36 @@ namespace osu.Game.Overlays.Mods
                                         }
                                     }
                                 },
-                                new[] { Empty() }
                             }
                         },
-                        footer = new Container
-                        {
-                            RelativeSizeAxes = Axes.X,
-                            AutoSizeAxes = Axes.Y,
-                            Anchor = Anchor.BottomCentre,
-                            Origin = Anchor.BottomCentre,
-                            Children = new Drawable[]
-                            {
-                                new Box
-                                {
-                                    RelativeSizeAxes = Axes.X,
-                                    Height = 50,
-                                    Anchor = Anchor.BottomCentre,
-                                    Origin = Anchor.BottomCentre,
-                                    Colour = colourProvider.Background5
-                                },
-                                new ShearedToggleButton(200)
-                                {
-                                    Anchor = Anchor.BottomLeft,
-                                    Origin = Anchor.BottomLeft,
-                                    Margin = new MarginPadding { Vertical = 14, Left = 70 },
-                                    Text = "Mod Customisation",
-                                    Active = { BindTarget = customisationVisible }
-                                }
-                            }
-                        },
-                        new ClickToReturnContainer
-                        {
-                            RelativeSizeAxes = Axes.Both,
-                            HandleMouse = { BindTarget = customisationVisible },
-                            OnClicked = () => customisationVisible.Value = false
-                        }
                     }
                 },
+            });
+
+            Footer.Add(new ShearedToggleButton(200)
+            {
+                Anchor = Anchor.BottomLeft,
+                Origin = Anchor.BottomLeft,
+                Margin = new MarginPadding { Vertical = 14, Left = 70 },
+                Text = "Mod Customisation",
+                Active = { BindTarget = customisationVisible }
+            });
+
+            AddRange(new Drawable[]
+            {
+                new ClickToReturnContainer
+                {
+                    RelativeSizeAxes = Axes.Both,
+                    HandleMouse = { BindTarget = customisationVisible },
+                    OnClicked = () => customisationVisible.Value = false
+                },
                 modSettingsArea = new ModSettingsArea
                 {
                     Anchor = Anchor.BottomCentre,
                     Origin = Anchor.BottomCentre,
                     Height = 0
                 }
-            };
-
-            columnFlow.Shear = new Vector2(ModPanel.SHEAR_X, 0);
+            });
         }
 
         protected override void LoadComplete()
@@ -252,7 +211,7 @@ namespace osu.Game.Overlays.Mods
             float modAreaHeight = customisationVisible.Value ? ModSettingsArea.HEIGHT : 0;
 
             modSettingsArea.ResizeHeightTo(modAreaHeight, transition_duration, Easing.InOutCubic);
-            mainContent.TransformTo(nameof(Margin), new MarginPadding { Bottom = modAreaHeight }, transition_duration, Easing.InOutCubic);
+            TopLevelContent.MoveToY(-modAreaHeight, transition_duration, Easing.InOutCubic);
         }
 
         private bool selectionBindableSyncInProgress;
@@ -287,10 +246,6 @@ namespace osu.Game.Overlays.Mods
             const double fade_in_duration = 400;
 
             base.PopIn();
-            this.FadeIn(fade_in_duration, Easing.OutQuint);
-
-            header.MoveToY(0, fade_in_duration, Easing.OutQuint);
-            footer.MoveToY(0, fade_in_duration, Easing.OutQuint);
 
             multiplierDisplay
                 .Delay(fade_in_duration * 0.65f)
@@ -311,15 +266,11 @@ namespace osu.Game.Overlays.Mods
             const double fade_out_duration = 500;
 
             base.PopOut();
-            this.FadeOut(fade_out_duration, Easing.OutQuint);
 
             multiplierDisplay
                 .FadeOut(fade_out_duration / 2, Easing.OutQuint)
                 .ScaleTo(0.75f, fade_out_duration, Easing.OutQuint);
 
-            header.MoveToY(-header.DrawHeight, fade_out_duration, Easing.OutQuint);
-            footer.MoveToY(footer.DrawHeight, fade_out_duration, Easing.OutQuint);
-
             for (int i = 0; i < columnFlow.Count; i++)
             {
                 const float distance = 700;
diff --git a/osu.Game/Overlays/Mods/ShearedOverlayContainer.cs b/osu.Game/Overlays/Mods/ShearedOverlayContainer.cs
new file mode 100644
index 0000000000..46a3ad3c8d
--- /dev/null
+++ b/osu.Game/Overlays/Mods/ShearedOverlayContainer.cs
@@ -0,0 +1,136 @@
+// 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.Game.Graphics.Containers;
+using osu.Game.Graphics.UserInterface;
+
+namespace osu.Game.Overlays.Mods
+{
+    /// <summary>
+    /// A sheared overlay which provides a header and footer and basic animations.
+    /// Exposes <see cref="TopLevelContent"/>, <see cref="MainAreaContent"/> and <see cref="Footer"/> as valid targets for content.
+    /// </summary>
+    public abstract class ShearedOverlayContainer : OsuFocusedOverlayContainer
+    {
+        [Cached]
+        protected readonly OverlayColourProvider ColourProvider;
+
+        /// <summary>
+        /// The overlay's header.
+        /// </summary>
+        protected PopupScreenTitle Header { get; private set; }
+
+        /// <summary>
+        /// The overlay's footer.
+        /// </summary>
+        protected Container Footer { get; private set; }
+
+        /// <summary>
+        /// A container containing all content, including the header and footer.
+        /// May be used for overlay-wide animations.
+        /// </summary>
+        protected Container TopLevelContent { get; private set; }
+
+        /// <summary>
+        /// A container for content that is to be displayed between the header and footer.
+        /// </summary>
+        protected Container MainAreaContent { get; private set; }
+
+        /// <summary>
+        /// A container for content that is to be displayed inside the footer.
+        /// </summary>
+        protected Container FooterContent { get; private set; }
+
+        protected abstract OverlayColourScheme ColourScheme { get; }
+
+        protected override bool StartHidden => true;
+
+        protected override bool BlockNonPositionalInput => true;
+
+        protected ShearedOverlayContainer()
+        {
+            RelativeSizeAxes = Axes.Both;
+
+            ColourProvider = new OverlayColourProvider(ColourScheme);
+        }
+
+        [BackgroundDependencyLoader]
+        private void load()
+        {
+            const float footer_height = 50;
+
+            Child = TopLevelContent = new Container
+            {
+                RelativeSizeAxes = Axes.Both,
+                Children = new Drawable[]
+                {
+                    Header = new PopupScreenTitle
+                    {
+                        Anchor = Anchor.TopCentre,
+                        Depth = float.MinValue,
+                        Origin = Anchor.TopCentre,
+                        Title = "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.",
+                        Close = Hide
+                    },
+                    MainAreaContent = new Container
+                    {
+                        RelativeSizeAxes = Axes.Both,
+                        Padding = new MarginPadding
+                        {
+                            Top = PopupScreenTitle.HEIGHT,
+                            Bottom = footer_height,
+                        }
+                    },
+                    Footer = new Container
+                    {
+                        RelativeSizeAxes = Axes.X,
+                        Depth = float.MinValue,
+                        Height = footer_height,
+                        Margin = new MarginPadding { Top = 10 },
+                        Anchor = Anchor.BottomCentre,
+                        Origin = Anchor.BottomCentre,
+                        Children = new Drawable[]
+                        {
+                            new Box
+                            {
+                                RelativeSizeAxes = Axes.Both,
+                                Colour = ColourProvider.Background5
+                            },
+                            FooterContent = new Container
+                            {
+                                RelativeSizeAxes = Axes.Both,
+                            },
+                        }
+                    }
+                }
+            };
+        }
+
+        protected override void PopIn()
+        {
+            const double fade_in_duration = 400;
+
+            base.PopIn();
+            this.FadeIn(fade_in_duration, Easing.OutQuint);
+
+            Header.MoveToY(0, fade_in_duration, Easing.OutQuint);
+            Footer.MoveToY(0, fade_in_duration, Easing.OutQuint);
+        }
+
+        protected override void PopOut()
+        {
+            const double fade_out_duration = 500;
+
+            base.PopOut();
+            this.FadeOut(fade_out_duration, Easing.OutQuint);
+
+            Header.MoveToY(-Header.DrawHeight, fade_out_duration, Easing.OutQuint);
+            Footer.MoveToY(Footer.DrawHeight, fade_out_duration, Easing.OutQuint);
+        }
+    }
+}

From 1032dc235dae06d61460c0fd019472bb4994ad04 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 20 Apr 2022 15:50:57 +0900
Subject: [PATCH 4189/5547] Rename `PopupScreenTitle` to `ShearedOverlayHeader`

---
 ...reenTitle.cs => TestSceneShearedOverlayHeader.cs} | 12 ++++++------
 .../{PopupScreenTitle.cs => ShearedOverlayHeader.cs} |  4 ++--
 osu.Game/Overlays/Mods/ShearedOverlayContainer.cs    |  6 +++---
 3 files changed, 11 insertions(+), 11 deletions(-)
 rename osu.Game.Tests/Visual/UserInterface/{TestScenePopupScreenTitle.cs => TestSceneShearedOverlayHeader.cs} (76%)
 rename osu.Game/Graphics/UserInterface/{PopupScreenTitle.cs => ShearedOverlayHeader.cs} (98%)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestScenePopupScreenTitle.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneShearedOverlayHeader.cs
similarity index 76%
rename from osu.Game.Tests/Visual/UserInterface/TestScenePopupScreenTitle.cs
rename to osu.Game.Tests/Visual/UserInterface/TestSceneShearedOverlayHeader.cs
index 22a8fa8a46..ef2b25cd92 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestScenePopupScreenTitle.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneShearedOverlayHeader.cs
@@ -10,19 +10,19 @@ using osu.Game.Overlays;
 namespace osu.Game.Tests.Visual.UserInterface
 {
     [TestFixture]
-    public class TestScenePopupScreenTitle : OsuTestScene
+    public class TestSceneShearedOverlayHeader : OsuTestScene
     {
         [Cached]
         private OverlayColourProvider colourProvider = new OverlayColourProvider(OverlayColourScheme.Green);
 
         [Test]
-        public void TestPopupScreenTitle()
+        public void TestShearedOverlayHeader()
         {
             AddStep("create content", () =>
             {
-                Child = new PopupScreenTitle
+                Child = new ShearedOverlayHeader
                 {
-                    Title = "Popup Screen Title",
+                    Title = "Sheared overlay header",
                     Description = string.Join(" ", Enumerable.Repeat("This is a description.", 20)),
                     Close = () => { }
                 };
@@ -34,9 +34,9 @@ namespace osu.Game.Tests.Visual.UserInterface
         {
             AddStep("create content", () =>
             {
-                Child = new PopupScreenTitle
+                Child = new ShearedOverlayHeader
                 {
-                    Title = "Popup Screen Title",
+                    Title = "Sheared overlay header",
                     Description = "This is a description."
                 };
             });
diff --git a/osu.Game/Graphics/UserInterface/PopupScreenTitle.cs b/osu.Game/Graphics/UserInterface/ShearedOverlayHeader.cs
similarity index 98%
rename from osu.Game/Graphics/UserInterface/PopupScreenTitle.cs
rename to osu.Game/Graphics/UserInterface/ShearedOverlayHeader.cs
index 2e5519726b..9ed7bb35de 100644
--- a/osu.Game/Graphics/UserInterface/PopupScreenTitle.cs
+++ b/osu.Game/Graphics/UserInterface/ShearedOverlayHeader.cs
@@ -19,7 +19,7 @@ using osuTK;
 
 namespace osu.Game.Graphics.UserInterface
 {
-    public class PopupScreenTitle : CompositeDrawable
+    public class ShearedOverlayHeader : CompositeDrawable
     {
         public const float HEIGHT = main_area_height + 2 * corner_radius;
 
@@ -50,7 +50,7 @@ namespace osu.Game.Graphics.UserInterface
         private readonly OsuTextFlowContainer descriptionText;
         private readonly IconButton closeButton;
 
-        public PopupScreenTitle()
+        public ShearedOverlayHeader()
         {
             RelativeSizeAxes = Axes.X;
             AutoSizeAxes = Axes.Y;
diff --git a/osu.Game/Overlays/Mods/ShearedOverlayContainer.cs b/osu.Game/Overlays/Mods/ShearedOverlayContainer.cs
index 46a3ad3c8d..b6f6cf1468 100644
--- a/osu.Game/Overlays/Mods/ShearedOverlayContainer.cs
+++ b/osu.Game/Overlays/Mods/ShearedOverlayContainer.cs
@@ -22,7 +22,7 @@ namespace osu.Game.Overlays.Mods
         /// <summary>
         /// The overlay's header.
         /// </summary>
-        protected PopupScreenTitle Header { get; private set; }
+        protected ShearedOverlayHeader Header { get; private set; }
 
         /// <summary>
         /// The overlay's footer.
@@ -68,7 +68,7 @@ namespace osu.Game.Overlays.Mods
                 RelativeSizeAxes = Axes.Both,
                 Children = new Drawable[]
                 {
-                    Header = new PopupScreenTitle
+                    Header = new ShearedOverlayHeader
                     {
                         Anchor = Anchor.TopCentre,
                         Depth = float.MinValue,
@@ -82,7 +82,7 @@ namespace osu.Game.Overlays.Mods
                         RelativeSizeAxes = Axes.Both,
                         Padding = new MarginPadding
                         {
-                            Top = PopupScreenTitle.HEIGHT,
+                            Top = ShearedOverlayHeader.HEIGHT,
                             Bottom = footer_height,
                         }
                     },

From 2ee37aeceb5c30f1f36eaa94707a02484f4c217e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 20 Apr 2022 15:57:45 +0900
Subject: [PATCH 4190/5547] Reduce nesting and usage of `GridContainer`

---
 osu.Game/Overlays/Mods/ModSelectScreen.cs | 159 +++++++++-------------
 1 file changed, 67 insertions(+), 92 deletions(-)

diff --git a/osu.Game/Overlays/Mods/ModSelectScreen.cs b/osu.Game/Overlays/Mods/ModSelectScreen.cs
index 6e8684478e..452c6e32a6 100644
--- a/osu.Game/Overlays/Mods/ModSelectScreen.cs
+++ b/osu.Game/Overlays/Mods/ModSelectScreen.cs
@@ -32,101 +32,10 @@ namespace osu.Game.Overlays.Mods
         private DifficultyMultiplierDisplay multiplierDisplay;
         private ModSettingsArea modSettingsArea;
         private FillFlowContainer<ModColumn> columnFlow;
-        private GridContainer grid;
 
         [BackgroundDependencyLoader]
         private void load()
         {
-            MainAreaContent.AddRange(new Drawable[]
-            {
-                new Container
-                {
-                    RelativeSizeAxes = Axes.Both,
-                    Children = new Drawable[]
-                    {
-                        grid = new GridContainer
-                        {
-                            RelativeSizeAxes = Axes.Both,
-                            RowDimensions = new[]
-                            {
-                                new Dimension(GridSizeMode.AutoSize),
-                                new Dimension(),
-                            },
-                            Content = new[]
-                            {
-                                new Drawable[]
-                                {
-                                    new Container
-                                    {
-                                        Anchor = Anchor.Centre,
-                                        Origin = Anchor.Centre,
-                                        AutoSizeAxes = Axes.X,
-                                        RelativePositionAxes = Axes.X,
-                                        X = 0.3f,
-                                        Height = DifficultyMultiplierDisplay.HEIGHT,
-                                        Margin = new MarginPadding
-                                        {
-                                            Horizontal = 100,
-                                            Vertical = 10
-                                        },
-                                        Child = multiplierDisplay = new DifficultyMultiplierDisplay
-                                        {
-                                            Anchor = Anchor.Centre,
-                                            Origin = Anchor.Centre
-                                        }
-                                    }
-                                },
-                                new Drawable[]
-                                {
-                                    new Container
-                                    {
-                                        Depth = float.MaxValue,
-                                        RelativeSizeAxes = Axes.Both,
-                                        RelativePositionAxes = Axes.Both,
-                                        Children = new Drawable[]
-                                        {
-                                            new OsuScrollContainer(Direction.Horizontal)
-                                            {
-                                                RelativeSizeAxes = Axes.Both,
-                                                Masking = false,
-                                                ClampExtension = 100,
-                                                ScrollbarOverlapsContent = false,
-                                                Child = columnFlow = new ModColumnContainer
-                                                {
-                                                    Direction = FillDirection.Horizontal,
-                                                    Shear = new Vector2(ModPanel.SHEAR_X, 0),
-                                                    RelativeSizeAxes = Axes.Y,
-                                                    AutoSizeAxes = Axes.X,
-                                                    Spacing = new Vector2(10, 0),
-                                                    Margin = new MarginPadding { Right = 70 },
-                                                    Children = new[]
-                                                    {
-                                                        new ModColumn(ModType.DifficultyReduction, false, new[] { Key.Q, Key.W, Key.E, Key.R, Key.T, Key.Y, Key.U, Key.I, Key.O, Key.P }),
-                                                        new ModColumn(ModType.DifficultyIncrease, false, new[] { Key.A, Key.S, Key.D, Key.F, Key.G, Key.H, Key.J, Key.K, Key.L }),
-                                                        new ModColumn(ModType.Automation, false, new[] { Key.Z, Key.X, Key.C, Key.V, Key.B, Key.N, Key.M }),
-                                                        new ModColumn(ModType.Conversion, false),
-                                                        new ModColumn(ModType.Fun, false)
-                                                    }
-                                                }
-                                            }
-                                        }
-                                    }
-                                },
-                            }
-                        },
-                    }
-                },
-            });
-
-            Footer.Add(new ShearedToggleButton(200)
-            {
-                Anchor = Anchor.BottomLeft,
-                Origin = Anchor.BottomLeft,
-                Margin = new MarginPadding { Vertical = 14, Left = 70 },
-                Text = "Mod Customisation",
-                Active = { BindTarget = customisationVisible }
-            });
-
             AddRange(new Drawable[]
             {
                 new ClickToReturnContainer
@@ -142,6 +51,72 @@ namespace osu.Game.Overlays.Mods
                     Height = 0
                 }
             });
+
+            MainAreaContent.AddRange(new Drawable[]
+            {
+                new Container
+                {
+                    Anchor = Anchor.TopRight,
+                    Origin = Anchor.TopRight,
+                    AutoSizeAxes = Axes.X,
+                    Height = DifficultyMultiplierDisplay.HEIGHT,
+                    Margin = new MarginPadding
+                    {
+                        Horizontal = 100,
+                    },
+                    Child = multiplierDisplay = new DifficultyMultiplierDisplay
+                    {
+                        Anchor = Anchor.Centre,
+                        Origin = Anchor.Centre
+                    }
+                },
+                new Container
+                {
+                    Margin = new MarginPadding
+                    {
+                        Vertical = DifficultyMultiplierDisplay.HEIGHT + 10,
+                    },
+                    Depth = float.MaxValue,
+                    RelativeSizeAxes = Axes.Both,
+                    RelativePositionAxes = Axes.Both,
+                    Children = new Drawable[]
+                    {
+                        new OsuScrollContainer(Direction.Horizontal)
+                        {
+                            RelativeSizeAxes = Axes.Both,
+                            Masking = false,
+                            ClampExtension = 100,
+                            ScrollbarOverlapsContent = false,
+                            Child = columnFlow = new ModColumnContainer
+                            {
+                                Direction = FillDirection.Horizontal,
+                                Shear = new Vector2(ModPanel.SHEAR_X, 0),
+                                RelativeSizeAxes = Axes.Y,
+                                AutoSizeAxes = Axes.X,
+                                Spacing = new Vector2(10, 0),
+                                Margin = new MarginPadding { Right = 70 },
+                                Children = new[]
+                                {
+                                    new ModColumn(ModType.DifficultyReduction, false, new[] { Key.Q, Key.W, Key.E, Key.R, Key.T, Key.Y, Key.U, Key.I, Key.O, Key.P }),
+                                    new ModColumn(ModType.DifficultyIncrease, false, new[] { Key.A, Key.S, Key.D, Key.F, Key.G, Key.H, Key.J, Key.K, Key.L }),
+                                    new ModColumn(ModType.Automation, false, new[] { Key.Z, Key.X, Key.C, Key.V, Key.B, Key.N, Key.M }),
+                                    new ModColumn(ModType.Conversion, false),
+                                    new ModColumn(ModType.Fun, false)
+                                }
+                            }
+                        }
+                    }
+                }
+            });
+
+            Footer.Add(new ShearedToggleButton(200)
+            {
+                Anchor = Anchor.BottomLeft,
+                Origin = Anchor.BottomLeft,
+                Margin = new MarginPadding { Vertical = 14, Left = 70 },
+                Text = "Mod Customisation",
+                Active = { BindTarget = customisationVisible }
+            });
         }
 
         protected override void LoadComplete()
@@ -206,7 +181,7 @@ namespace osu.Game.Overlays.Mods
         {
             const double transition_duration = 300;
 
-            grid.FadeColour(customisationVisible.Value ? Colour4.Gray : Colour4.White, transition_duration, Easing.InOutCubic);
+            MainAreaContent.FadeColour(customisationVisible.Value ? Colour4.Gray : Colour4.White, transition_duration, Easing.InOutCubic);
 
             float modAreaHeight = customisationVisible.Value ? ModSettingsArea.HEIGHT : 0;
 

From 5c7ff363ce406ca8ef4c6c21bc6f76eb7b42f58d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 20 Apr 2022 16:08:00 +0900
Subject: [PATCH 4191/5547] Move title/description to correct class

---
 osu.Game/Overlays/Mods/ModSelectScreen.cs         | 3 +++
 osu.Game/Overlays/Mods/ShearedOverlayContainer.cs | 2 --
 2 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Overlays/Mods/ModSelectScreen.cs b/osu.Game/Overlays/Mods/ModSelectScreen.cs
index 452c6e32a6..7c857d5a90 100644
--- a/osu.Game/Overlays/Mods/ModSelectScreen.cs
+++ b/osu.Game/Overlays/Mods/ModSelectScreen.cs
@@ -36,6 +36,9 @@ namespace osu.Game.Overlays.Mods
         [BackgroundDependencyLoader]
         private void load()
         {
+            Header.Title = "Mod Select";
+            Header.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.";
+
             AddRange(new Drawable[]
             {
                 new ClickToReturnContainer
diff --git a/osu.Game/Overlays/Mods/ShearedOverlayContainer.cs b/osu.Game/Overlays/Mods/ShearedOverlayContainer.cs
index b6f6cf1468..76a81421fa 100644
--- a/osu.Game/Overlays/Mods/ShearedOverlayContainer.cs
+++ b/osu.Game/Overlays/Mods/ShearedOverlayContainer.cs
@@ -73,8 +73,6 @@ namespace osu.Game.Overlays.Mods
                         Anchor = Anchor.TopCentre,
                         Depth = float.MinValue,
                         Origin = Anchor.TopCentre,
-                        Title = "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.",
                         Close = Hide
                     },
                     MainAreaContent = new Container

From e17f224793bc31ebf92b8ae5113f221d61d908b0 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 20 Apr 2022 16:28:52 +0900
Subject: [PATCH 4192/5547] Fix padding mismatches

---
 osu.Game/Overlays/Mods/ModSelectScreen.cs         | 6 +++---
 osu.Game/Overlays/Mods/ShearedOverlayContainer.cs | 6 ++++--
 2 files changed, 7 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Overlays/Mods/ModSelectScreen.cs b/osu.Game/Overlays/Mods/ModSelectScreen.cs
index 7c857d5a90..a9992d70bc 100644
--- a/osu.Game/Overlays/Mods/ModSelectScreen.cs
+++ b/osu.Game/Overlays/Mods/ModSelectScreen.cs
@@ -75,9 +75,9 @@ namespace osu.Game.Overlays.Mods
                 },
                 new Container
                 {
-                    Margin = new MarginPadding
+                    Padding = new MarginPadding
                     {
-                        Vertical = DifficultyMultiplierDisplay.HEIGHT + 10,
+                        Top = DifficultyMultiplierDisplay.HEIGHT + PADDING,
                     },
                     Depth = float.MaxValue,
                     RelativeSizeAxes = Axes.Both,
@@ -116,7 +116,7 @@ namespace osu.Game.Overlays.Mods
             {
                 Anchor = Anchor.BottomLeft,
                 Origin = Anchor.BottomLeft,
-                Margin = new MarginPadding { Vertical = 14, Left = 70 },
+                Margin = new MarginPadding { Vertical = PADDING, Left = 70 },
                 Text = "Mod Customisation",
                 Active = { BindTarget = customisationVisible }
             });
diff --git a/osu.Game/Overlays/Mods/ShearedOverlayContainer.cs b/osu.Game/Overlays/Mods/ShearedOverlayContainer.cs
index 76a81421fa..0bdd4189a0 100644
--- a/osu.Game/Overlays/Mods/ShearedOverlayContainer.cs
+++ b/osu.Game/Overlays/Mods/ShearedOverlayContainer.cs
@@ -16,6 +16,8 @@ namespace osu.Game.Overlays.Mods
     /// </summary>
     public abstract class ShearedOverlayContainer : OsuFocusedOverlayContainer
     {
+        protected const float PADDING = 14;
+
         [Cached]
         protected readonly OverlayColourProvider ColourProvider;
 
@@ -81,7 +83,7 @@ namespace osu.Game.Overlays.Mods
                         Padding = new MarginPadding
                         {
                             Top = ShearedOverlayHeader.HEIGHT,
-                            Bottom = footer_height,
+                            Bottom = footer_height + PADDING,
                         }
                     },
                     Footer = new Container
@@ -89,7 +91,7 @@ namespace osu.Game.Overlays.Mods
                         RelativeSizeAxes = Axes.X,
                         Depth = float.MinValue,
                         Height = footer_height,
-                        Margin = new MarginPadding { Top = 10 },
+                        Margin = new MarginPadding { Top = PADDING },
                         Anchor = Anchor.BottomCentre,
                         Origin = Anchor.BottomCentre,
                         Children = new Drawable[]

From 65b2db5e71fc86dab1d1f2c7416123f002c83d93 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 20 Apr 2022 16:30:58 +0900
Subject: [PATCH 4193/5547] Move shear constant to overlay (this is going to
 likely be used everywhere ever)

---
 osu.Game/Overlays/Mods/DifficultyMultiplierDisplay.cs |  6 +++---
 osu.Game/Overlays/Mods/ModColumn.cs                   |  8 ++++----
 osu.Game/Overlays/Mods/ModPanel.cs                    | 11 +++++------
 osu.Game/Overlays/Mods/ModSelectScreen.cs             |  4 ++--
 osu.Game/Overlays/Mods/ShearedOverlayContainer.cs     |  2 ++
 5 files changed, 16 insertions(+), 15 deletions(-)

diff --git a/osu.Game/Overlays/Mods/DifficultyMultiplierDisplay.cs b/osu.Game/Overlays/Mods/DifficultyMultiplierDisplay.cs
index 248d4f288e..66fd6a202d 100644
--- a/osu.Game/Overlays/Mods/DifficultyMultiplierDisplay.cs
+++ b/osu.Game/Overlays/Mods/DifficultyMultiplierDisplay.cs
@@ -58,7 +58,7 @@ namespace osu.Game.Overlays.Mods
                 AutoSizeAxes = Axes.X,
                 Masking = true,
                 CornerRadius = ModPanel.CORNER_RADIUS,
-                Shear = new Vector2(ModPanel.SHEAR_X, 0),
+                Shear = new Vector2(ShearedOverlayContainer.SHEAR, 0),
                 Children = new Drawable[]
                 {
                     underlayBackground = new Box
@@ -98,7 +98,7 @@ namespace osu.Game.Overlays.Mods
                                             Anchor = Anchor.Centre,
                                             Origin = Anchor.Centre,
                                             Margin = new MarginPadding { Horizontal = 18 },
-                                            Shear = new Vector2(-ModPanel.SHEAR_X, 0),
+                                            Shear = new Vector2(-ShearedOverlayContainer.SHEAR, 0),
                                             Text = "Difficulty Multiplier",
                                             Font = OsuFont.Default.With(size: 17, weight: FontWeight.SemiBold)
                                         }
@@ -109,7 +109,7 @@ namespace osu.Game.Overlays.Mods
                                     AutoSizeAxes = Axes.Both,
                                     Anchor = Anchor.Centre,
                                     Origin = Anchor.Centre,
-                                    Shear = new Vector2(-ModPanel.SHEAR_X, 0),
+                                    Shear = new Vector2(-ShearedOverlayContainer.SHEAR, 0),
                                     Direction = FillDirection.Horizontal,
                                     Spacing = new Vector2(2, 0),
                                     Children = new Drawable[]
diff --git a/osu.Game/Overlays/Mods/ModColumn.cs b/osu.Game/Overlays/Mods/ModColumn.cs
index f84ae4ac8a..78b4e24a4e 100644
--- a/osu.Game/Overlays/Mods/ModColumn.cs
+++ b/osu.Game/Overlays/Mods/ModColumn.cs
@@ -79,7 +79,7 @@ namespace osu.Game.Overlays.Mods
 
             Width = 320;
             RelativeSizeAxes = Axes.Y;
-            Shear = new Vector2(ModPanel.SHEAR_X, 0);
+            Shear = new Vector2(ShearedOverlayContainer.SHEAR, 0);
 
             Container controlContainer;
             InternalChildren = new Drawable[]
@@ -113,7 +113,7 @@ namespace osu.Game.Overlays.Mods
                                     AutoSizeAxes = Axes.Y,
                                     Anchor = Anchor.CentreLeft,
                                     Origin = Anchor.CentreLeft,
-                                    Shear = new Vector2(-ModPanel.SHEAR_X, 0),
+                                    Shear = new Vector2(-ShearedOverlayContainer.SHEAR, 0),
                                     Padding = new MarginPadding
                                     {
                                         Horizontal = 17,
@@ -193,7 +193,7 @@ namespace osu.Game.Overlays.Mods
                     Scale = new Vector2(0.8f),
                     RelativeSizeAxes = Axes.X,
                     LabelText = "Enable All",
-                    Shear = new Vector2(-ModPanel.SHEAR_X, 0)
+                    Shear = new Vector2(-ShearedOverlayContainer.SHEAR, 0)
                 });
                 panelFlow.Padding = new MarginPadding
                 {
@@ -260,7 +260,7 @@ namespace osu.Game.Overlays.Mods
 
             var panels = newMods.Select(mod => new ModPanel(mod)
             {
-                Shear = new Vector2(-ModPanel.SHEAR_X, 0)
+                Shear = new Vector2(-ShearedOverlayContainer.SHEAR, 0)
             });
 
             Task? loadTask;
diff --git a/osu.Game/Overlays/Mods/ModPanel.cs b/osu.Game/Overlays/Mods/ModPanel.cs
index 312171cf74..7c4f2dcb7e 100644
--- a/osu.Game/Overlays/Mods/ModPanel.cs
+++ b/osu.Game/Overlays/Mods/ModPanel.cs
@@ -42,7 +42,6 @@ namespace osu.Game.Overlays.Mods
 
         protected const double TRANSITION_DURATION = 150;
 
-        public const float SHEAR_X = 0.2f;
         public const float CORNER_RADIUS = 7;
 
         protected const float HEIGHT = 42;
@@ -67,7 +66,7 @@ namespace osu.Game.Overlays.Mods
             Content.Masking = true;
             Content.CornerRadius = CORNER_RADIUS;
             Content.BorderThickness = 2;
-            Content.Shear = new Vector2(SHEAR_X, 0);
+            Content.Shear = new Vector2(ShearedOverlayContainer.SHEAR, 0);
 
             Children = new Drawable[]
             {
@@ -83,7 +82,7 @@ namespace osu.Game.Overlays.Mods
                         Anchor = Anchor.Centre,
                         Origin = Anchor.Centre,
                         Active = { BindTarget = Active },
-                        Shear = new Vector2(-SHEAR_X, 0),
+                        Shear = new Vector2(-ShearedOverlayContainer.SHEAR, 0),
                         Scale = new Vector2(HEIGHT / ModSwitchSmall.DEFAULT_SIZE)
                     }
                 },
@@ -116,10 +115,10 @@ namespace osu.Game.Overlays.Mods
                                     {
                                         Text = mod.Name,
                                         Font = OsuFont.TorusAlternate.With(size: 18, weight: FontWeight.SemiBold),
-                                        Shear = new Vector2(-SHEAR_X, 0),
+                                        Shear = new Vector2(-ShearedOverlayContainer.SHEAR, 0),
                                         Margin = new MarginPadding
                                         {
-                                            Left = -18 * SHEAR_X
+                                            Left = -18 * ShearedOverlayContainer.SHEAR
                                         }
                                     },
                                     new OsuSpriteText
@@ -128,7 +127,7 @@ namespace osu.Game.Overlays.Mods
                                         Font = OsuFont.Default.With(size: 12),
                                         RelativeSizeAxes = Axes.X,
                                         Truncate = true,
-                                        Shear = new Vector2(-SHEAR_X, 0)
+                                        Shear = new Vector2(-ShearedOverlayContainer.SHEAR, 0)
                                     }
                                 }
                             }
diff --git a/osu.Game/Overlays/Mods/ModSelectScreen.cs b/osu.Game/Overlays/Mods/ModSelectScreen.cs
index a9992d70bc..94f877a08c 100644
--- a/osu.Game/Overlays/Mods/ModSelectScreen.cs
+++ b/osu.Game/Overlays/Mods/ModSelectScreen.cs
@@ -93,7 +93,7 @@ namespace osu.Game.Overlays.Mods
                             Child = columnFlow = new ModColumnContainer
                             {
                                 Direction = FillDirection.Horizontal,
-                                Shear = new Vector2(ModPanel.SHEAR_X, 0),
+                                Shear = new Vector2(SHEAR, 0),
                                 RelativeSizeAxes = Axes.Y,
                                 AutoSizeAxes = Axes.X,
                                 Spacing = new Vector2(10, 0),
@@ -284,7 +284,7 @@ namespace osu.Game.Overlays.Mods
                 {
                     Padding = new MarginPadding
                     {
-                        Left = DrawHeight * ModPanel.SHEAR_X,
+                        Left = DrawHeight * SHEAR,
                         Bottom = 10
                     };
 
diff --git a/osu.Game/Overlays/Mods/ShearedOverlayContainer.cs b/osu.Game/Overlays/Mods/ShearedOverlayContainer.cs
index 0bdd4189a0..62ed736dc2 100644
--- a/osu.Game/Overlays/Mods/ShearedOverlayContainer.cs
+++ b/osu.Game/Overlays/Mods/ShearedOverlayContainer.cs
@@ -18,6 +18,8 @@ namespace osu.Game.Overlays.Mods
     {
         protected const float PADDING = 14;
 
+        public const float SHEAR = 0.2f;
+
         [Cached]
         protected readonly OverlayColourProvider ColourProvider;
 

From 8c2d70e93fb01036538638dc50f399cc0bffa023 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 20 Apr 2022 17:50:31 +0900
Subject: [PATCH 4194/5547] Disable forward button when already at end

---
 osu.Game/Overlays/FirstRunSetupOverlay.cs | 21 ++++++++++++---------
 1 file changed, 12 insertions(+), 9 deletions(-)

diff --git a/osu.Game/Overlays/FirstRunSetupOverlay.cs b/osu.Game/Overlays/FirstRunSetupOverlay.cs
index c74adbabae..d5aa1178e0 100644
--- a/osu.Game/Overlays/FirstRunSetupOverlay.cs
+++ b/osu.Game/Overlays/FirstRunSetupOverlay.cs
@@ -346,7 +346,7 @@ namespace osu.Game.Overlays
             stack.CurrentScreen.Exit();
             currentStepIndex--;
 
-            updateButtonText();
+            updateButtons();
         }
 
         private void showNextStep()
@@ -359,7 +359,6 @@ namespace osu.Game.Overlays
             if (currentStepIndex < steps.Length)
             {
                 stack.Push((Screen)Activator.CreateInstance(steps[currentStepIndex.Value].ScreenType));
-                updateButtonText();
             }
             else
             {
@@ -367,17 +366,21 @@ namespace osu.Game.Overlays
                 currentStepIndex = null;
                 Hide();
             }
+
+            updateButtons();
         }
 
-        private void updateButtonText()
+        private void updateButtons()
         {
-            Debug.Assert(currentStepIndex != null);
+            BackButton.Enabled.Value = currentStepIndex > 0;
+            NextButton.Enabled.Value = currentStepIndex != null;
 
-            BackButton.Enabled.Value = currentStepIndex != 0;
-
-            NextButton.Text = currentStepIndex + 1 < steps.Length
-                ? FirstRunSetupOverlayStrings.Next(steps[currentStepIndex.Value + 1].Description)
-                : CommonStrings.Finish;
+            if (currentStepIndex != null)
+            {
+                NextButton.Text = currentStepIndex + 1 < steps.Length
+                    ? FirstRunSetupOverlayStrings.Next(steps[currentStepIndex.Value + 1].Description)
+                    : CommonStrings.Finish;
+            }
         }
 
         private class FirstRunStep

From 2906af323af33c835473b28bdc67ff88cb168cb1 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 20 Apr 2022 17:51:08 +0900
Subject: [PATCH 4195/5547] Fix incorrectly written string equality logic

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

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunSetupOverlay.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunSetupOverlay.cs
index 8a9ed50725..efce4f350b 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunSetupOverlay.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunSetupOverlay.cs
@@ -127,7 +127,7 @@ namespace osu.Game.Tests.Visual.UserInterface
                 if (overlay.CurrentScreen?.IsLoaded != false)
                     nextButton.TriggerClick();
 
-                return nextButton.Text.ToString() == CommonStrings.Finish;
+                return nextButton.Text == CommonStrings.Finish;
             });
 
             AddUntilStep("step back to start", () =>

From 4466e15bfcf3a0b7c93ba3c9cfc1da87509a6393 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 20 Apr 2022 23:17:29 +0900
Subject: [PATCH 4196/5547] Rename `AllowConfiguration` to `AllowCustomisation`
 and simplify drawable addition

---
 osu.Game/Overlays/Mods/ModSelectScreen.cs     | 57 ++++++++++---------
 .../Screens/OnlinePlay/FreeModSelectScreen.cs |  2 +-
 2 files changed, 31 insertions(+), 28 deletions(-)

diff --git a/osu.Game/Overlays/Mods/ModSelectScreen.cs b/osu.Game/Overlays/Mods/ModSelectScreen.cs
index 41cbfdafb3..693c85fafc 100644
--- a/osu.Game/Overlays/Mods/ModSelectScreen.cs
+++ b/osu.Game/Overlays/Mods/ModSelectScreen.cs
@@ -46,7 +46,7 @@ namespace osu.Game.Overlays.Mods
         /// <summary>
         /// Whether configurable <see cref="Mod"/>s can be configured by the local user.
         /// </summary>
-        protected virtual bool AllowConfiguration => true;
+        protected virtual bool AllowCustomisation => true;
 
         /// <summary>
         /// Whether the total score multiplier calculated from the current selected set of mods should be shown.
@@ -85,29 +85,12 @@ namespace osu.Game.Overlays.Mods
 
             MainAreaContent.AddRange(new Drawable[]
             {
-                new Container
-                {
-                    Anchor = Anchor.TopRight,
-                    Origin = Anchor.TopRight,
-                    AutoSizeAxes = Axes.X,
-                    Height = DifficultyMultiplierDisplay.HEIGHT,
-                    Margin = new MarginPadding
-                    {
-                        Horizontal = 100,
-                    },
-                    Child = multiplierDisplay = new DifficultyMultiplierDisplay
-                    {
-                        Anchor = Anchor.Centre,
-                        Origin = Anchor.Centre
-                    }
-                },
                 new Container
                 {
                     Padding = new MarginPadding
                     {
-                        Top = DifficultyMultiplierDisplay.HEIGHT + PADDING,
+                        Top = (ShowTotalMultiplier ? DifficultyMultiplierDisplay.HEIGHT : 0) + PADDING,
                     },
-                    Depth = float.MaxValue,
                     RelativeSizeAxes = Axes.Both,
                     RelativePositionAxes = Axes.Both,
                     Children = new Drawable[]
@@ -140,14 +123,34 @@ namespace osu.Game.Overlays.Mods
                 }
             });
 
-            Footer.Add(new ShearedToggleButton(200)
+            if (ShowTotalMultiplier)
             {
-                Anchor = Anchor.BottomLeft,
-                Origin = Anchor.BottomLeft,
-                Margin = new MarginPadding { Vertical = PADDING, Left = 70 },
-                Text = "Mod Customisation",
-                Active = { BindTarget = customisationVisible }
-            });
+                MainAreaContent.Add(new Container
+                {
+                    Anchor = Anchor.TopRight,
+                    Origin = Anchor.TopRight,
+                    AutoSizeAxes = Axes.X,
+                    Height = DifficultyMultiplierDisplay.HEIGHT,
+                    Margin = new MarginPadding { Horizontal = 100 },
+                    Child = multiplierDisplay = new DifficultyMultiplierDisplay
+                    {
+                        Anchor = Anchor.Centre,
+                        Origin = Anchor.Centre
+                    },
+                });
+            }
+
+            if (AllowCustomisation)
+            {
+                Footer.Add(new ShearedToggleButton(200)
+                {
+                    Anchor = Anchor.BottomLeft,
+                    Origin = Anchor.BottomLeft,
+                    Margin = new MarginPadding { Vertical = PADDING, Left = 70 },
+                    Text = "Mod Customisation",
+                    Active = { BindTarget = customisationVisible }
+                });
+            }
         }
 
         protected override void LoadComplete()
@@ -194,7 +197,7 @@ namespace osu.Game.Overlays.Mods
 
         private void updateCustomisation(ValueChangedEvent<IReadOnlyList<Mod>> valueChangedEvent)
         {
-            if (!AllowConfiguration)
+            if (!AllowCustomisation)
                 return;
 
             bool anyCustomisableMod = false;
diff --git a/osu.Game/Screens/OnlinePlay/FreeModSelectScreen.cs b/osu.Game/Screens/OnlinePlay/FreeModSelectScreen.cs
index 438b334e0b..c85a4fc38b 100644
--- a/osu.Game/Screens/OnlinePlay/FreeModSelectScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/FreeModSelectScreen.cs
@@ -10,7 +10,7 @@ namespace osu.Game.Screens.OnlinePlay
 {
     public class FreeModSelectScreen : ModSelectScreen
     {
-        protected override bool AllowConfiguration => false;
+        protected override bool AllowCustomisation => false;
         protected override bool ShowTotalMultiplier => false;
 
         public new Func<Mod, bool> IsValidMod

From e596c9d1713f82f3000f1c5029ee20d4a96ebdb3 Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Wed, 20 Apr 2022 19:12:43 +0100
Subject: [PATCH 4197/5547] Use `Bindable<ChannelSelectorState>` to control
 selector active visibility

---
 .../Visual/Online/TestSceneChannelList.cs     |  9 +++--
 .../Overlays/Chat/ChannelList/ChannelList.cs  |  8 +++-
 .../Chat/ChannelList/ChannelListItem.cs       | 38 +++++++++++--------
 .../Chat/ChannelList/ChannelListSelector.cs   | 14 ++++++-
 4 files changed, 46 insertions(+), 23 deletions(-)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneChannelList.cs b/osu.Game.Tests/Visual/Online/TestSceneChannelList.cs
index d6a1e71f0d..2bfe42e6d4 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneChannelList.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneChannelList.cs
@@ -25,6 +25,9 @@ namespace osu.Game.Tests.Visual.Online
         [Cached]
         private readonly Bindable<Channel> selected = new Bindable<Channel>();
 
+        [Cached]
+        private readonly Bindable<ChannelSelectorState> selector = new Bindable<ChannelSelectorState>();
+
         private OsuSpriteText selectorText;
         private OsuSpriteText selectedText;
         private OsuSpriteText leaveText;
@@ -89,7 +92,7 @@ namespace osu.Game.Tests.Visual.Online
 
                 channelList.OnRequestSelect += channel =>
                 {
-                    channelList.SelectorActive.Value = false;
+                    selector.Value = ChannelSelectorState.Hidden;
                     selected.Value = channel;
                 };
 
@@ -101,9 +104,9 @@ namespace osu.Game.Tests.Visual.Online
                     channelList.RemoveChannel(channel);
                 };
 
-                channelList.SelectorActive.BindValueChanged(change =>
+                selector.BindValueChanged(change =>
                 {
-                    selectorText.Text = $"Channel Selector Active: {change.NewValue}";
+                    selectorText.Text = $"Channel Selector State: {change.NewValue}";
                 }, true);
 
                 selected.BindValueChanged(change =>
diff --git a/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs b/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs
index 94c1a99a81..578ac2aa45 100644
--- a/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs
+++ b/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs
@@ -14,7 +14,6 @@ using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Online.Chat;
-using osuTK;
 
 namespace osu.Game.Overlays.Chat.ChannelList
 {
@@ -57,7 +56,6 @@ namespace osu.Game.Overlays.Chat.ChannelList
                             new ChannelListSelector
                             {
                                 Margin = new MarginPadding { Bottom = 10 },
-                                SelectorActive = { BindTarget = SelectorActive },
                             },
                             privateChannelFlow = new ChannelListItemFlow("DIRECT MESSAGES"),
                         },
@@ -132,4 +130,10 @@ namespace osu.Game.Overlays.Chat.ChannelList
             }
         }
     }
+
+    public enum ChannelSelectorState
+    {
+        Visibile,
+        Hidden,
+    }
 }
diff --git a/osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs b/osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs
index 43574351ed..3d59d1dc4c 100644
--- a/osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs
+++ b/osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs
@@ -31,14 +31,17 @@ namespace osu.Game.Overlays.Chat.ChannelList
 
         private readonly Channel channel;
 
-        private Box? hoverBox;
-        private Box? selectBox;
-        private OsuSpriteText? text;
-        private ChannelListItemCloseButton? close;
+        private Box hoverBox = null!;
+        private Box selectBox = null!;
+        private OsuSpriteText text = null!;
+        private ChannelListItemCloseButton close = null!;
 
         [Resolved]
         private Bindable<Channel> selectedChannel { get; set; } = null!;
 
+        [Resolved]
+        private Bindable<ChannelSelectorState> selectorState { get; set; } = null!;
+
         [Resolved]
         private OverlayColourProvider colourProvider { get; set; } = null!;
 
@@ -124,31 +127,26 @@ namespace osu.Game.Overlays.Chat.ChannelList
         {
             base.LoadComplete();
 
-            selectedChannel.BindValueChanged(change =>
-            {
-                if (change.NewValue == channel)
-                    selectBox?.FadeIn(300, Easing.OutQuint);
-                else
-                    selectBox?.FadeOut(200, Easing.OutQuint);
-            }, true);
+            selectedChannel.BindValueChanged(_ => updateSelectState(), true);
+            selectorState.BindValueChanged(_ => updateSelectState(), true);
 
             Unread.BindValueChanged(change =>
             {
-                text!.FadeColour(change.NewValue ? colourProvider.Content1 : colourProvider.Light3, 300, Easing.OutQuint);
+                text.FadeColour(change.NewValue ? colourProvider.Content1 : colourProvider.Light3, 300, Easing.OutQuint);
             }, true);
         }
 
         protected override bool OnHover(HoverEvent e)
         {
-            hoverBox?.FadeIn(300, Easing.OutQuint);
-            close?.FadeIn(300, Easing.OutQuint);
+            hoverBox.FadeIn(300, Easing.OutQuint);
+            close.FadeIn(300, Easing.OutQuint);
             return base.OnHover(e);
         }
 
         protected override void OnHoverLost(HoverLostEvent e)
         {
-            hoverBox?.FadeOut(200, Easing.OutQuint);
-            close?.FadeOut(200, Easing.OutQuint);
+            hoverBox.FadeOut(200, Easing.OutQuint);
+            close.FadeOut(200, Easing.OutQuint);
             base.OnHoverLost(e);
         }
 
@@ -167,5 +165,13 @@ namespace osu.Game.Overlays.Chat.ChannelList
                 Masking = true,
             };
         }
+
+        private void updateSelectState()
+        {
+            if (selectedChannel.Value == channel && selectorState.Value == ChannelSelectorState.Hidden)
+                selectBox.FadeIn(300, Easing.OutQuint);
+            else
+                selectBox.FadeOut(200, Easing.OutQuint);
+        }
     }
 }
diff --git a/osu.Game/Overlays/Chat/ChannelList/ChannelListSelector.cs b/osu.Game/Overlays/Chat/ChannelList/ChannelListSelector.cs
index 5bc9a01598..4529a34f84 100644
--- a/osu.Game/Overlays/Chat/ChannelList/ChannelListSelector.cs
+++ b/osu.Game/Overlays/Chat/ChannelList/ChannelListSelector.cs
@@ -22,6 +22,9 @@ namespace osu.Game.Overlays.Chat.ChannelList
         private Box hoverBox = null!;
         private Box selectBox = null!;
 
+        [Resolved]
+        private Bindable<ChannelSelectorState> selectorState { get; set; } = null!;
+
         [BackgroundDependencyLoader]
         private void load(OverlayColourProvider colourProvider)
         {
@@ -65,8 +68,15 @@ namespace osu.Game.Overlays.Chat.ChannelList
         {
             base.LoadComplete();
 
-            SelectorActive.BindValueChanged(selected => selectBox.FadeTo(selected.NewValue ? 1 : 0));
-            Action = () => SelectorActive.Value = true;
+            selectorState.BindValueChanged(selector =>
+            {
+                if (selector.NewValue == ChannelSelectorState.Visibile)
+                    selectBox.FadeIn(300, Easing.OutQuint);
+                else
+                    selectBox.FadeOut(200, Easing.OutQuint);
+            }, true);
+
+            Action = () => selectorState.Value = ChannelSelectorState.Visibile;
         }
 
         protected override bool OnHover(HoverEvent e)

From 5319bce772d9e91857108628997c78a8284c79fc Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Wed, 20 Apr 2022 21:05:33 +0100
Subject: [PATCH 4198/5547] Revert DI usage of `ChannelSelectorState` in favour
 of directly binding `BindableBool` `SelectorActive`

---
 osu.Game.Tests/Visual/Online/TestSceneChannelList.cs     | 9 +++------
 osu.Game/Overlays/Chat/ChannelList/ChannelList.cs        | 8 ++------
 osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs    | 9 ++++-----
 .../Overlays/Chat/ChannelList/ChannelListSelector.cs     | 9 +++------
 4 files changed, 12 insertions(+), 23 deletions(-)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneChannelList.cs b/osu.Game.Tests/Visual/Online/TestSceneChannelList.cs
index 2bfe42e6d4..d6a1e71f0d 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneChannelList.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneChannelList.cs
@@ -25,9 +25,6 @@ namespace osu.Game.Tests.Visual.Online
         [Cached]
         private readonly Bindable<Channel> selected = new Bindable<Channel>();
 
-        [Cached]
-        private readonly Bindable<ChannelSelectorState> selector = new Bindable<ChannelSelectorState>();
-
         private OsuSpriteText selectorText;
         private OsuSpriteText selectedText;
         private OsuSpriteText leaveText;
@@ -92,7 +89,7 @@ namespace osu.Game.Tests.Visual.Online
 
                 channelList.OnRequestSelect += channel =>
                 {
-                    selector.Value = ChannelSelectorState.Hidden;
+                    channelList.SelectorActive.Value = false;
                     selected.Value = channel;
                 };
 
@@ -104,9 +101,9 @@ namespace osu.Game.Tests.Visual.Online
                     channelList.RemoveChannel(channel);
                 };
 
-                selector.BindValueChanged(change =>
+                channelList.SelectorActive.BindValueChanged(change =>
                 {
-                    selectorText.Text = $"Channel Selector State: {change.NewValue}";
+                    selectorText.Text = $"Channel Selector Active: {change.NewValue}";
                 }, true);
 
                 selected.BindValueChanged(change =>
diff --git a/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs b/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs
index 578ac2aa45..076dc5719e 100644
--- a/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs
+++ b/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs
@@ -56,6 +56,7 @@ namespace osu.Game.Overlays.Chat.ChannelList
                             new ChannelListSelector
                             {
                                 Margin = new MarginPadding { Bottom = 10 },
+                                SelectorActive = { BindTarget = SelectorActive },
                             },
                             privateChannelFlow = new ChannelListItemFlow("DIRECT MESSAGES"),
                         },
@@ -72,6 +73,7 @@ namespace osu.Game.Overlays.Chat.ChannelList
             ChannelListItem item = new ChannelListItem(channel);
             item.OnRequestSelect += chan => OnRequestSelect?.Invoke(chan);
             item.OnRequestLeave += chan => OnRequestLeave?.Invoke(chan);
+            item.SelectorActive.BindTarget = SelectorActive;
 
             ChannelListItemFlow flow = getFlowForChannel(channel);
             channelMap.Add(channel, item);
@@ -130,10 +132,4 @@ namespace osu.Game.Overlays.Chat.ChannelList
             }
         }
     }
-
-    public enum ChannelSelectorState
-    {
-        Visibile,
-        Hidden,
-    }
 }
diff --git a/osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs b/osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs
index 3d59d1dc4c..7c4a72559b 100644
--- a/osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs
+++ b/osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs
@@ -29,6 +29,8 @@ namespace osu.Game.Overlays.Chat.ChannelList
 
         public readonly BindableBool Unread = new BindableBool();
 
+        public readonly BindableBool SelectorActive = new BindableBool();
+
         private readonly Channel channel;
 
         private Box hoverBox = null!;
@@ -39,9 +41,6 @@ namespace osu.Game.Overlays.Chat.ChannelList
         [Resolved]
         private Bindable<Channel> selectedChannel { get; set; } = null!;
 
-        [Resolved]
-        private Bindable<ChannelSelectorState> selectorState { get; set; } = null!;
-
         [Resolved]
         private OverlayColourProvider colourProvider { get; set; } = null!;
 
@@ -128,7 +127,7 @@ namespace osu.Game.Overlays.Chat.ChannelList
             base.LoadComplete();
 
             selectedChannel.BindValueChanged(_ => updateSelectState(), true);
-            selectorState.BindValueChanged(_ => updateSelectState(), true);
+            SelectorActive.BindValueChanged(_ => updateSelectState(), true);
 
             Unread.BindValueChanged(change =>
             {
@@ -168,7 +167,7 @@ namespace osu.Game.Overlays.Chat.ChannelList
 
         private void updateSelectState()
         {
-            if (selectedChannel.Value == channel && selectorState.Value == ChannelSelectorState.Hidden)
+            if (selectedChannel.Value == channel && !SelectorActive.Value)
                 selectBox.FadeIn(300, Easing.OutQuint);
             else
                 selectBox.FadeOut(200, Easing.OutQuint);
diff --git a/osu.Game/Overlays/Chat/ChannelList/ChannelListSelector.cs b/osu.Game/Overlays/Chat/ChannelList/ChannelListSelector.cs
index 4529a34f84..57ab7584b5 100644
--- a/osu.Game/Overlays/Chat/ChannelList/ChannelListSelector.cs
+++ b/osu.Game/Overlays/Chat/ChannelList/ChannelListSelector.cs
@@ -22,9 +22,6 @@ namespace osu.Game.Overlays.Chat.ChannelList
         private Box hoverBox = null!;
         private Box selectBox = null!;
 
-        [Resolved]
-        private Bindable<ChannelSelectorState> selectorState { get; set; } = null!;
-
         [BackgroundDependencyLoader]
         private void load(OverlayColourProvider colourProvider)
         {
@@ -68,15 +65,15 @@ namespace osu.Game.Overlays.Chat.ChannelList
         {
             base.LoadComplete();
 
-            selectorState.BindValueChanged(selector =>
+            SelectorActive.BindValueChanged(selector =>
             {
-                if (selector.NewValue == ChannelSelectorState.Visibile)
+                if (selector.NewValue)
                     selectBox.FadeIn(300, Easing.OutQuint);
                 else
                     selectBox.FadeOut(200, Easing.OutQuint);
             }, true);
 
-            Action = () => selectorState.Value = ChannelSelectorState.Visibile;
+            Action = () => SelectorActive.Value = true;
         }
 
         protected override bool OnHover(HoverEvent e)

From 5e5c8e78a6538b4bcda713375f59b1b2828ec9fa Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Thu, 27 Jan 2022 20:53:48 -0800
Subject: [PATCH 4199/5547] Use existing web localisation for most hardcoded
 strings

---
 osu.Game.Rulesets.Osu/Beatmaps/OsuBeatmap.cs   |  5 +++--
 osu.Game/Beatmaps/BeatmapStatistic.cs          |  3 ++-
 .../Drawables/BeatmapDownloadButton.cs         |  3 ++-
 osu.Game/Graphics/UserInterface/OsuMenuItem.cs |  3 ++-
 .../UserInterface/PageSelector/PageSelector.cs |  5 +++--
 .../PageSelector/PageSelectorPrevNextButton.cs |  6 ++++--
 .../Graphics/UserInterface/SearchTextBox.cs    |  3 ++-
 .../Graphics/UserInterface/ShowMoreButton.cs   |  4 +++-
 .../Graphics/UserInterfaceV2/ColourDisplay.cs  |  3 ++-
 osu.Game/Localisation/CommonStrings.cs         | 10 ----------
 .../API/Requests/Responses/APIPlayStyle.cs     | 11 ++++++-----
 osu.Game/Online/Chat/StandAloneChatDisplay.cs  |  3 ++-
 .../Online/Leaderboards/LeaderboardScore.cs    | 11 ++++++-----
 osu.Game/Online/Rooms/MatchType.cs             |  7 ++++---
 .../Overlays/AccountCreation/ScreenEntry.cs    |  3 ++-
 .../Overlays/BeatmapSet/BeatmapAvailability.cs |  7 ++++---
 .../Scores/NotSupporterPlaceholder.cs          |  3 ++-
 osu.Game/Overlays/ChatOverlay.cs               |  2 +-
 .../Comments/Buttons/LoadRepliesButton.cs      |  3 ++-
 .../Comments/Buttons/ShowMoreRepliesButton.cs  |  3 ++-
 .../Comments/CancellableCommentEditor.cs       |  3 ++-
 .../Overlays/Comments/CommentsContainer.cs     |  3 ++-
 osu.Game/Overlays/Comments/CommentsHeader.cs   | 10 ++++++++--
 .../Comments/CommentsShowMoreButton.cs         |  6 +++++-
 osu.Game/Overlays/Comments/DrawableComment.cs  |  2 +-
 .../Overlays/Comments/TotalCommentsCounter.cs  |  3 ++-
 .../Dashboard/CurrentlyPlayingDisplay.cs       |  3 ++-
 .../Dashboard/Home/DrawableBeatmapList.cs      |  3 ++-
 .../Dashboard/Home/DrawableNewBeatmapList.cs   |  4 +++-
 .../Home/DrawablePopularBeatmapList.cs         |  4 +++-
 .../Dashboard/Home/News/ShowMoreNewsPanel.cs   |  3 ++-
 osu.Game/Overlays/Dialog/ConfirmDialog.cs      |  3 ++-
 osu.Game/Overlays/Login/LoginForm.cs           |  7 ++++---
 osu.Game/Overlays/Login/UserAction.cs          |  3 +++
 osu.Game/Overlays/Mods/ModSelectOverlay.cs     |  3 ++-
 osu.Game/Overlays/NotificationOverlay.cs       |  5 +++--
 .../Notifications/NotificationSection.cs       |  7 ++++---
 .../Profile/Header/BottomHeaderContainer.cs    | 18 ++++++++++++++----
 .../Settings/Sections/Input/KeyBindingRow.cs   |  6 +++---
 osu.Game/Overlays/Toolbar/ToolbarUserButton.cs |  3 ++-
 .../Wiki/Markdown/WikiNoticeContainer.cs       |  8 +++++---
 osu.Game/Overlays/Wiki/WikiSidebar.cs          |  4 +++-
 .../Compose/Components/SelectionHandler.cs     |  3 ++-
 osu.Game/Screens/Edit/Editor.cs                |  3 ++-
 .../Screens/Edit/Setup/DifficultySection.cs    |  9 +++++----
 osu.Game/Screens/Edit/Setup/MetadataSection.cs |  7 ++++---
 .../OnlinePlay/Components/OverlinedHeader.cs   |  3 ++-
 .../OnlinePlay/DrawableRoomPlaylistItem.cs     |  3 ++-
 .../Match/Components/MatchLeaderboardScore.cs  |  5 +++--
 .../OnlinePlay/Match/DrawableMatchRoom.cs      |  3 ++-
 .../Participants/ParticipantsListHeader.cs     |  3 ++-
 .../Screens/Play/BeatmapMetadataDisplay.cs     |  9 +++++----
 osu.Game/Screens/Play/Break/BreakInfo.cs       |  3 ++-
 osu.Game/Screens/Play/Break/BreakInfoLine.cs   |  4 ++--
 .../Play/HUD/PerformancePointsCounter.cs       |  3 ++-
 .../Play/PlayerSettings/AudioSettings.cs       |  3 ++-
 .../Play/PlayerSettings/VisualSettings.cs      | 11 ++++++-----
 .../Contracted/ContractedPanelMiddleContent.cs |  8 +++++---
 .../Expanded/Statistics/AccuracyStatistic.cs   |  3 ++-
 .../Expanded/Statistics/ComboStatistic.cs      |  3 ++-
 .../Expanded/Statistics/CounterStatistic.cs    |  3 ++-
 .../Statistics/PerformanceStatistic.cs         |  3 ++-
 .../Expanded/Statistics/StatisticDisplay.cs    |  8 +++++---
 osu.Game/Screens/Select/BeatmapDetails.cs      |  3 ++-
 .../Select/Carousel/DrawableCarouselBeatmap.cs | 14 ++++----------
 .../Screens/Select/Details/AdvancedStats.cs    | 13 +++++++------
 osu.Game/Screens/Select/Filter/SortMode.cs     | 16 +++++++++-------
 osu.Game/Screens/Select/FilterControl.cs       |  3 ++-
 .../Select/Options/BeatmapOptionsOverlay.cs    |  3 ++-
 osu.Game/Users/UserStatus.cs                   | 10 ++++++----
 70 files changed, 224 insertions(+), 147 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Beatmaps/OsuBeatmap.cs b/osu.Game.Rulesets.Osu/Beatmaps/OsuBeatmap.cs
index 2d3cc3c103..a5282877ee 100644
--- a/osu.Game.Rulesets.Osu/Beatmaps/OsuBeatmap.cs
+++ b/osu.Game.Rulesets.Osu/Beatmaps/OsuBeatmap.cs
@@ -4,6 +4,7 @@
 using System.Collections.Generic;
 using System.Linq;
 using osu.Game.Beatmaps;
+using osu.Game.Resources.Localisation.Web;
 using osu.Game.Rulesets.Osu.Objects;
 
 namespace osu.Game.Rulesets.Osu.Beatmaps
@@ -20,13 +21,13 @@ namespace osu.Game.Rulesets.Osu.Beatmaps
             {
                 new BeatmapStatistic
                 {
-                    Name = @"Circle Count",
+                    Name = BeatmapsetsStrings.ShowStatsCountCircles,
                     Content = circles.ToString(),
                     CreateIcon = () => new BeatmapStatisticIcon(BeatmapStatisticsIconType.Circles),
                 },
                 new BeatmapStatistic
                 {
-                    Name = @"Slider Count",
+                    Name = BeatmapsetsStrings.ShowStatsCountSliders,
                     Content = sliders.ToString(),
                     CreateIcon = () => new BeatmapStatisticIcon(BeatmapStatisticsIconType.Sliders),
                 },
diff --git a/osu.Game/Beatmaps/BeatmapStatistic.cs b/osu.Game/Beatmaps/BeatmapStatistic.cs
index 7d7ba09fcf..94ebb56a5c 100644
--- a/osu.Game/Beatmaps/BeatmapStatistic.cs
+++ b/osu.Game/Beatmaps/BeatmapStatistic.cs
@@ -3,6 +3,7 @@
 
 using System;
 using osu.Framework.Graphics;
+using osu.Framework.Localisation;
 
 namespace osu.Game.Beatmaps
 {
@@ -14,6 +15,6 @@ namespace osu.Game.Beatmaps
         public Func<Drawable> CreateIcon;
 
         public string Content;
-        public string Name;
+        public LocalisableString Name;
     }
 }
diff --git a/osu.Game/Beatmaps/Drawables/BeatmapDownloadButton.cs b/osu.Game/Beatmaps/Drawables/BeatmapDownloadButton.cs
index e2485e7a77..6ab92a2ba2 100644
--- a/osu.Game/Beatmaps/Drawables/BeatmapDownloadButton.cs
+++ b/osu.Game/Beatmaps/Drawables/BeatmapDownloadButton.cs
@@ -12,6 +12,7 @@ using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Online;
 using osu.Game.Online.API.Requests.Responses;
+using osu.Game.Resources.Localisation.Web;
 
 namespace osu.Game.Beatmaps.Drawables
 {
@@ -104,7 +105,7 @@ namespace osu.Game.Beatmaps.Drawables
                         if ((beatmapSet as IBeatmapSetOnlineInfo)?.Availability.DownloadDisabled == true)
                         {
                             button.Enabled.Value = false;
-                            button.TooltipText = "this beatmap is currently not available for download.";
+                            button.TooltipText = BeatmapsetsStrings.AvailabilityDisabled;
                         }
 
                         break;
diff --git a/osu.Game/Graphics/UserInterface/OsuMenuItem.cs b/osu.Game/Graphics/UserInterface/OsuMenuItem.cs
index 0fe41937ce..1da60415ba 100644
--- a/osu.Game/Graphics/UserInterface/OsuMenuItem.cs
+++ b/osu.Game/Graphics/UserInterface/OsuMenuItem.cs
@@ -3,6 +3,7 @@
 
 using System;
 using osu.Framework.Graphics.UserInterface;
+using osu.Framework.Localisation;
 
 namespace osu.Game.Graphics.UserInterface
 {
@@ -15,7 +16,7 @@ namespace osu.Game.Graphics.UserInterface
         {
         }
 
-        public OsuMenuItem(string text, MenuItemType type, Action action)
+        public OsuMenuItem(LocalisableString text, MenuItemType type, Action action)
             : base(text, action)
         {
             Type = type;
diff --git a/osu.Game/Graphics/UserInterface/PageSelector/PageSelector.cs b/osu.Game/Graphics/UserInterface/PageSelector/PageSelector.cs
index 005729580c..5c6d087279 100644
--- a/osu.Game/Graphics/UserInterface/PageSelector/PageSelector.cs
+++ b/osu.Game/Graphics/UserInterface/PageSelector/PageSelector.cs
@@ -5,6 +5,7 @@ using System;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics;
 using osu.Framework.Bindables;
+using osu.Game.Resources.Localisation.Web;
 
 namespace osu.Game.Graphics.UserInterface.PageSelector
 {
@@ -29,7 +30,7 @@ namespace osu.Game.Graphics.UserInterface.PageSelector
                 Direction = FillDirection.Horizontal,
                 Children = new Drawable[]
                 {
-                    previousPageButton = new PageSelectorPrevNextButton(false, "prev")
+                    previousPageButton = new PageSelectorPrevNextButton(false, CommonStrings.PaginationPrevious)
                     {
                         Action = () => CurrentPage.Value -= 1,
                     },
@@ -38,7 +39,7 @@ namespace osu.Game.Graphics.UserInterface.PageSelector
                         AutoSizeAxes = Axes.Both,
                         Direction = FillDirection.Horizontal,
                     },
-                    nextPageButton = new PageSelectorPrevNextButton(true, "next")
+                    nextPageButton = new PageSelectorPrevNextButton(true, CommonStrings.PaginationNext)
                     {
                         Action = () => CurrentPage.Value += 1
                     }
diff --git a/osu.Game/Graphics/UserInterface/PageSelector/PageSelectorPrevNextButton.cs b/osu.Game/Graphics/UserInterface/PageSelector/PageSelectorPrevNextButton.cs
index 7503ab8135..889917c397 100644
--- a/osu.Game/Graphics/UserInterface/PageSelector/PageSelectorPrevNextButton.cs
+++ b/osu.Game/Graphics/UserInterface/PageSelector/PageSelectorPrevNextButton.cs
@@ -2,9 +2,11 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using osu.Framework.Allocation;
+using osu.Framework.Extensions.LocalisationExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Sprites;
+using osu.Framework.Localisation;
 using osu.Game.Graphics.Sprites;
 using osuTK;
 
@@ -13,12 +15,12 @@ namespace osu.Game.Graphics.UserInterface.PageSelector
     public class PageSelectorPrevNextButton : PageSelectorButton
     {
         private readonly bool rightAligned;
-        private readonly string text;
+        private readonly LocalisableString text;
 
         private SpriteIcon icon;
         private OsuSpriteText name;
 
-        public PageSelectorPrevNextButton(bool rightAligned, string text)
+        public PageSelectorPrevNextButton(bool rightAligned, LocalisableString text)
         {
             this.rightAligned = rightAligned;
             this.text = text;
diff --git a/osu.Game/Graphics/UserInterface/SearchTextBox.cs b/osu.Game/Graphics/UserInterface/SearchTextBox.cs
index 6937782be6..dd9ed7c9e9 100644
--- a/osu.Game/Graphics/UserInterface/SearchTextBox.cs
+++ b/osu.Game/Graphics/UserInterface/SearchTextBox.cs
@@ -5,6 +5,7 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Input;
 using osu.Framework.Input.Events;
+using osu.Game.Resources.Localisation.Web;
 using osuTK;
 using osuTK.Input;
 
@@ -27,7 +28,7 @@ namespace osu.Game.Graphics.UserInterface
             });
 
             TextFlow.Padding = new MarginPadding { Right = 35 };
-            PlaceholderText = "type to search";
+            PlaceholderText = HomeStrings.SearchPlaceholder;
         }
 
         public override bool OnPressed(KeyBindingPressEvent<PlatformAction> e)
diff --git a/osu.Game/Graphics/UserInterface/ShowMoreButton.cs b/osu.Game/Graphics/UserInterface/ShowMoreButton.cs
index 615895074c..05dda324d4 100644
--- a/osu.Game/Graphics/UserInterface/ShowMoreButton.cs
+++ b/osu.Game/Graphics/UserInterface/ShowMoreButton.cs
@@ -11,7 +11,9 @@ using osu.Game.Graphics.Sprites;
 using osu.Game.Overlays;
 using osuTK;
 using System.Collections.Generic;
+using osu.Framework.Extensions.LocalisationExtensions;
 using osu.Framework.Localisation;
+using osu.Game.Resources.Localisation.Web;
 
 namespace osu.Game.Graphics.UserInterface
 {
@@ -80,7 +82,7 @@ namespace osu.Game.Graphics.UserInterface
                             Anchor = Anchor.Centre,
                             Origin = Anchor.Centre,
                             Font = OsuFont.GetFont(size: 12, weight: FontWeight.SemiBold),
-                            Text = "show more".ToUpper(),
+                            Text = CommonStrings.ButtonsShowMore.ToUpper(),
                         },
                         rightIcon = new ChevronIcon
                         {
diff --git a/osu.Game/Graphics/UserInterfaceV2/ColourDisplay.cs b/osu.Game/Graphics/UserInterfaceV2/ColourDisplay.cs
index 5240df74a2..cec319f28e 100644
--- a/osu.Game/Graphics/UserInterfaceV2/ColourDisplay.cs
+++ b/osu.Game/Graphics/UserInterfaceV2/ColourDisplay.cs
@@ -14,6 +14,7 @@ using osu.Framework.Localisation;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.UserInterface;
+using osu.Game.Resources.Localisation.Web;
 using osuTK;
 
 namespace osu.Game.Graphics.UserInterfaceV2
@@ -139,7 +140,7 @@ namespace osu.Game.Graphics.UserInterfaceV2
 
             public MenuItem[] ContextMenuItems => new MenuItem[]
             {
-                new OsuMenuItem("Delete", MenuItemType.Destructive, () => DeleteRequested?.Invoke())
+                new OsuMenuItem(CommonStrings.ButtonsDelete, MenuItemType.Destructive, () => DeleteRequested?.Invoke())
             };
         }
     }
diff --git a/osu.Game/Localisation/CommonStrings.cs b/osu.Game/Localisation/CommonStrings.cs
index 3ea337c279..b717bb83dd 100644
--- a/osu.Game/Localisation/CommonStrings.cs
+++ b/osu.Game/Localisation/CommonStrings.cs
@@ -9,16 +9,6 @@ namespace osu.Game.Localisation
     {
         private const string prefix = @"osu.Game.Resources.Localisation.Common";
 
-        /// <summary>
-        /// "Cancel"
-        /// </summary>
-        public static LocalisableString Cancel => new TranslatableString(getKey(@"cancel"), @"Cancel");
-
-        /// <summary>
-        /// "Clear"
-        /// </summary>
-        public static LocalisableString Clear => new TranslatableString(getKey(@"clear"), @"Clear");
-
         /// <summary>
         /// "Enabled"
         /// </summary>
diff --git a/osu.Game/Online/API/Requests/Responses/APIPlayStyle.cs b/osu.Game/Online/API/Requests/Responses/APIPlayStyle.cs
index 9573ae1825..a9d66f3d6a 100644
--- a/osu.Game/Online/API/Requests/Responses/APIPlayStyle.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIPlayStyle.cs
@@ -1,22 +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 System.ComponentModel;
+using osu.Framework.Localisation;
+using osu.Game.Resources.Localisation.Web;
 
 namespace osu.Game.Online.API.Requests.Responses
 {
     public enum APIPlayStyle
     {
-        [Description("Keyboard")]
+        [LocalisableDescription(typeof(CommonStrings), nameof(CommonStrings.DeviceKeyboard))]
         Keyboard,
 
-        [Description("Mouse")]
+        [LocalisableDescription(typeof(CommonStrings), nameof(CommonStrings.DeviceMouse))]
         Mouse,
 
-        [Description("Tablet")]
+        [LocalisableDescription(typeof(CommonStrings), nameof(CommonStrings.DeviceTablet))]
         Tablet,
 
-        [Description("Touch Screen")]
+        [LocalisableDescription(typeof(CommonStrings), nameof(CommonStrings.DeviceTouch))]
         Touch,
     }
 }
diff --git a/osu.Game/Online/Chat/StandAloneChatDisplay.cs b/osu.Game/Online/Chat/StandAloneChatDisplay.cs
index f83bf4877e..6a7da52416 100644
--- a/osu.Game/Online/Chat/StandAloneChatDisplay.cs
+++ b/osu.Game/Online/Chat/StandAloneChatDisplay.cs
@@ -12,6 +12,7 @@ using osu.Framework.Input.Events;
 using osu.Game.Graphics;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Overlays.Chat;
+using osu.Game.Resources.Localisation.Web;
 using osuTK.Graphics;
 
 namespace osu.Game.Online.Chat
@@ -63,7 +64,7 @@ namespace osu.Game.Online.Chat
                 {
                     RelativeSizeAxes = Axes.X,
                     Height = text_box_height,
-                    PlaceholderText = "type your message",
+                    PlaceholderText = ChatStrings.InputPlaceholder,
                     CornerRadius = corner_radius,
                     ReleaseFocusOnCommit = false,
                     HoldFocus = true,
diff --git a/osu.Game/Online/Leaderboards/LeaderboardScore.cs b/osu.Game/Online/Leaderboards/LeaderboardScore.cs
index eecb7ff6b3..c75e98cdaa 100644
--- a/osu.Game/Online/Leaderboards/LeaderboardScore.cs
+++ b/osu.Game/Online/Leaderboards/LeaderboardScore.cs
@@ -30,6 +30,7 @@ using osu.Game.Users.Drawables;
 using osuTK;
 using osuTK.Graphics;
 using osu.Game.Online.API;
+using osu.Game.Resources.Localisation.Web;
 using osu.Game.Utils;
 
 namespace osu.Game.Online.Leaderboards
@@ -291,8 +292,8 @@ namespace osu.Game.Online.Leaderboards
 
         protected virtual IEnumerable<LeaderboardScoreStatistic> GetStatistics(ScoreInfo model) => new[]
         {
-            new LeaderboardScoreStatistic(FontAwesome.Solid.Link, "Max Combo", model.MaxCombo.ToString()),
-            new LeaderboardScoreStatistic(FontAwesome.Solid.Crosshairs, "Accuracy", model.DisplayAccuracy)
+            new LeaderboardScoreStatistic(FontAwesome.Solid.Link, BeatmapsetsStrings.ShowScoreboardHeadersCombo, model.MaxCombo.ToString()),
+            new LeaderboardScoreStatistic(FontAwesome.Solid.Crosshairs, BeatmapsetsStrings.ShowScoreboardHeadersAccuracy, model.DisplayAccuracy)
         };
 
         protected override bool OnHover(HoverEvent e)
@@ -403,9 +404,9 @@ namespace osu.Game.Online.Leaderboards
         {
             public IconUsage Icon;
             public LocalisableString Value;
-            public string Name;
+            public LocalisableString Name;
 
-            public LeaderboardScoreStatistic(IconUsage icon, string name, LocalisableString value)
+            public LeaderboardScoreStatistic(IconUsage icon, LocalisableString name, LocalisableString value)
             {
                 Icon = icon;
                 Name = name;
@@ -426,7 +427,7 @@ namespace osu.Game.Online.Leaderboards
                     items.Add(new OsuMenuItem("Export", MenuItemType.Standard, () => new LegacyScoreExporter(storage).Export(Score)));
 
                 if (!isOnlineScope)
-                    items.Add(new OsuMenuItem("Delete", MenuItemType.Destructive, () => dialogOverlay?.Push(new LocalScoreDeleteDialog(Score))));
+                    items.Add(new OsuMenuItem(CommonStrings.ButtonsDelete, MenuItemType.Destructive, () => dialogOverlay?.Push(new LocalScoreDeleteDialog(Score))));
 
                 return items.ToArray();
             }
diff --git a/osu.Game/Online/Rooms/MatchType.cs b/osu.Game/Online/Rooms/MatchType.cs
index 36f0dc0c81..278f0693eb 100644
--- a/osu.Game/Online/Rooms/MatchType.cs
+++ b/osu.Game/Online/Rooms/MatchType.cs
@@ -1,7 +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.ComponentModel;
+using osu.Framework.Localisation;
+using osu.Game.Resources.Localisation.Web;
 
 namespace osu.Game.Online.Rooms
 {
@@ -11,10 +12,10 @@ namespace osu.Game.Online.Rooms
 
         Playlists,
 
-        [Description("Head to head")]
+        [LocalisableDescription(typeof(MatchesStrings), nameof(MatchesStrings.MatchTeamTypesHeadToHead))]
         HeadToHead,
 
-        [Description("Team VS")]
+        [LocalisableDescription(typeof(MatchesStrings), nameof(MatchesStrings.MatchTeamTypesTeamVs))]
         TeamVersus,
     }
 }
diff --git a/osu.Game/Overlays/AccountCreation/ScreenEntry.cs b/osu.Game/Overlays/AccountCreation/ScreenEntry.cs
index a2c04c6989..6cf3fb4267 100644
--- a/osu.Game/Overlays/AccountCreation/ScreenEntry.cs
+++ b/osu.Game/Overlays/AccountCreation/ScreenEntry.cs
@@ -16,6 +16,7 @@ using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Online.API;
 using osu.Game.Overlays.Settings;
+using osu.Game.Resources.Localisation.Web;
 using osuTK;
 using osuTK.Graphics;
 
@@ -68,7 +69,7 @@ namespace osu.Game.Overlays.AccountCreation
                         },
                         usernameTextBox = new OsuTextBox
                         {
-                            PlaceholderText = "username",
+                            PlaceholderText = UsersStrings.LoginUsername,
                             RelativeSizeAxes = Axes.X,
                             TabbableContentContainer = this
                         },
diff --git a/osu.Game/Overlays/BeatmapSet/BeatmapAvailability.cs b/osu.Game/Overlays/BeatmapSet/BeatmapAvailability.cs
index dc46452dcb..b6e768d632 100644
--- a/osu.Game/Overlays/BeatmapSet/BeatmapAvailability.cs
+++ b/osu.Game/Overlays/BeatmapSet/BeatmapAvailability.cs
@@ -8,6 +8,7 @@ using osu.Framework.Graphics.Shapes;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Online.API.Requests.Responses;
+using osu.Game.Resources.Localisation.Web;
 using osuTK.Graphics;
 
 namespace osu.Game.Overlays.BeatmapSet
@@ -69,14 +70,14 @@ namespace osu.Game.Overlays.BeatmapSet
         {
             textContainer.Clear();
             textContainer.AddParagraph(downloadDisabled
-                ? "This beatmap is currently not available for download."
-                : "Portions of this beatmap have been removed at the request of the creator or a third-party rights holder.", t => t.Colour = Color4.Orange);
+                ? BeatmapsetsStrings.AvailabilityDisabled
+                : BeatmapsetsStrings.AvailabilityPartsRemoved, t => t.Colour = Color4.Orange);
 
             if (hasExternalLink)
             {
                 textContainer.NewParagraph();
                 textContainer.NewParagraph();
-                textContainer.AddLink("Check here for more information.", BeatmapSet.Availability.ExternalLink, creationParameters: t => t.Font = OsuFont.GetFont(size: 10));
+                textContainer.AddLink(BeatmapsetsStrings.AvailabilityMoreInfo, BeatmapSet.Availability.ExternalLink, creationParameters: t => t.Font = OsuFont.GetFont(size: 10));
             }
         }
     }
diff --git a/osu.Game/Overlays/BeatmapSet/Scores/NotSupporterPlaceholder.cs b/osu.Game/Overlays/BeatmapSet/Scores/NotSupporterPlaceholder.cs
index b2c87a1477..d1a0960a08 100644
--- a/osu.Game/Overlays/BeatmapSet/Scores/NotSupporterPlaceholder.cs
+++ b/osu.Game/Overlays/BeatmapSet/Scores/NotSupporterPlaceholder.cs
@@ -7,6 +7,7 @@ using osu.Game.Graphics.Sprites;
 using osuTK;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
+using osu.Game.Resources.Localisation.Web;
 
 namespace osu.Game.Overlays.BeatmapSet.Scores
 {
@@ -28,7 +29,7 @@ namespace osu.Game.Overlays.BeatmapSet.Scores
                     {
                         Anchor = Anchor.TopCentre,
                         Origin = Anchor.TopCentre,
-                        Text = @"You need to be an osu!supporter to access the friend and country rankings!",
+                        Text = BeatmapsetsStrings.ShowScoreboardSupporterOnly,
                         Font = OsuFont.GetFont(size: 14, weight: FontWeight.Bold),
                     },
                     text = new LinkFlowContainer(t => t.Font = t.Font.With(size: 11))
diff --git a/osu.Game/Overlays/ChatOverlay.cs b/osu.Game/Overlays/ChatOverlay.cs
index 64b972262b..034670cf37 100644
--- a/osu.Game/Overlays/ChatOverlay.cs
+++ b/osu.Game/Overlays/ChatOverlay.cs
@@ -160,7 +160,7 @@ namespace osu.Game.Overlays
                                                 {
                                                     RelativeSizeAxes = Axes.Both,
                                                     Height = 1,
-                                                    PlaceholderText = "type your message",
+                                                    PlaceholderText = Resources.Localisation.Web.ChatStrings.InputPlaceholder,
                                                     ReleaseFocusOnCommit = false,
                                                     HoldFocus = true,
                                                 }
diff --git a/osu.Game/Overlays/Comments/Buttons/LoadRepliesButton.cs b/osu.Game/Overlays/Comments/Buttons/LoadRepliesButton.cs
index 4998e5391e..4bb5b9d66d 100644
--- a/osu.Game/Overlays/Comments/Buttons/LoadRepliesButton.cs
+++ b/osu.Game/Overlays/Comments/Buttons/LoadRepliesButton.cs
@@ -3,6 +3,7 @@
 
 using osu.Framework.Graphics;
 using osu.Game.Graphics.UserInterface;
+using osu.Game.Resources.Localisation.Web;
 
 namespace osu.Game.Overlays.Comments.Buttons
 {
@@ -25,7 +26,7 @@ namespace osu.Game.Overlays.Comments.Buttons
         {
             public ButtonContent()
             {
-                Text = "load replies";
+                Text = CommentsStrings.LoadReplies;
             }
         }
     }
diff --git a/osu.Game/Overlays/Comments/Buttons/ShowMoreRepliesButton.cs b/osu.Game/Overlays/Comments/Buttons/ShowMoreRepliesButton.cs
index c115a8bb8f..4908e29b7d 100644
--- a/osu.Game/Overlays/Comments/Buttons/ShowMoreRepliesButton.cs
+++ b/osu.Game/Overlays/Comments/Buttons/ShowMoreRepliesButton.cs
@@ -9,6 +9,7 @@ using osu.Game.Graphics.Sprites;
 using System.Collections.Generic;
 using osuTK;
 using osu.Framework.Allocation;
+using osu.Game.Resources.Localisation.Web;
 
 namespace osu.Game.Overlays.Comments.Buttons
 {
@@ -38,7 +39,7 @@ namespace osu.Game.Overlays.Comments.Buttons
             {
                 AlwaysPresent = true,
                 Font = OsuFont.GetFont(size: 12, weight: FontWeight.SemiBold),
-                Text = "show more"
+                Text = CommonStrings.ButtonsShowMore
             }
         };
 
diff --git a/osu.Game/Overlays/Comments/CancellableCommentEditor.cs b/osu.Game/Overlays/Comments/CancellableCommentEditor.cs
index c226b7f07f..74c221bd82 100644
--- a/osu.Game/Overlays/Comments/CancellableCommentEditor.cs
+++ b/osu.Game/Overlays/Comments/CancellableCommentEditor.cs
@@ -10,6 +10,7 @@ using osu.Framework.Graphics.Shapes;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
+using osu.Game.Resources.Localisation.Web;
 
 namespace osu.Game.Overlays.Comments
 {
@@ -54,7 +55,7 @@ namespace osu.Game.Overlays.Comments
                             Origin = Anchor.Centre,
                             Font = OsuFont.GetFont(size: 12, weight: FontWeight.Bold),
                             Margin = new MarginPadding { Horizontal = 20 },
-                            Text = @"Cancel"
+                            Text = CommonStrings.ButtonsCancel
                         }
                     }
                 };
diff --git a/osu.Game/Overlays/Comments/CommentsContainer.cs b/osu.Game/Overlays/Comments/CommentsContainer.cs
index 6a5734b553..a28b13fc12 100644
--- a/osu.Game/Overlays/Comments/CommentsContainer.cs
+++ b/osu.Game/Overlays/Comments/CommentsContainer.cs
@@ -16,6 +16,7 @@ using osu.Framework.Threading;
 using System.Collections.Generic;
 using JetBrains.Annotations;
 using osu.Game.Graphics.Sprites;
+using osu.Game.Resources.Localisation.Web;
 using APIUser = osu.Game.Online.API.Requests.Responses.APIUser;
 
 namespace osu.Game.Overlays.Comments
@@ -328,7 +329,7 @@ namespace osu.Game.Overlays.Comments
                         Anchor = Anchor.CentreLeft,
                         Origin = Anchor.CentreLeft,
                         Margin = new MarginPadding { Left = 50 },
-                        Text = @"No comments yet."
+                        Text = CommentsStrings.Empty
                     }
                 });
             }
diff --git a/osu.Game/Overlays/Comments/CommentsHeader.cs b/osu.Game/Overlays/Comments/CommentsHeader.cs
index bf80655c3d..e7d9e72dcc 100644
--- a/osu.Game/Overlays/Comments/CommentsHeader.cs
+++ b/osu.Game/Overlays/Comments/CommentsHeader.cs
@@ -12,7 +12,9 @@ using osu.Game.Graphics;
 using osu.Framework.Graphics.Sprites;
 using osuTK;
 using osu.Framework.Input.Events;
+using osu.Framework.Localisation;
 using osu.Game.Graphics.Sprites;
+using osu.Game.Resources.Localisation.Web;
 
 namespace osu.Game.Overlays.Comments
 {
@@ -91,7 +93,7 @@ namespace osu.Game.Overlays.Comments
                             Anchor = Anchor.CentreLeft,
                             Origin = Anchor.CentreLeft,
                             Font = OsuFont.GetFont(size: 12, weight: FontWeight.SemiBold),
-                            Text = @"Show deleted"
+                            Text = CommonStrings.ButtonsShowDeleted
                         }
                     },
                 });
@@ -126,9 +128,13 @@ namespace osu.Game.Overlays.Comments
 
     public enum CommentsSortCriteria
     {
-        [System.ComponentModel.Description(@"Recent")]
+        [LocalisableDescription(typeof(SortStrings), nameof(SortStrings.New))]
         New,
+
+        [LocalisableDescription(typeof(SortStrings), nameof(SortStrings.Old))]
         Old,
+
+        [LocalisableDescription(typeof(SortStrings), nameof(SortStrings.Top))]
         Top
     }
 }
diff --git a/osu.Game/Overlays/Comments/CommentsShowMoreButton.cs b/osu.Game/Overlays/Comments/CommentsShowMoreButton.cs
index adf64eabb1..b1ca39c3bf 100644
--- a/osu.Game/Overlays/Comments/CommentsShowMoreButton.cs
+++ b/osu.Game/Overlays/Comments/CommentsShowMoreButton.cs
@@ -2,7 +2,10 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using osu.Framework.Bindables;
+using osu.Framework.Extensions.LocalisationExtensions;
+using osu.Framework.Localisation;
 using osu.Game.Graphics.UserInterface;
+using osu.Game.Resources.Localisation.Web;
 
 namespace osu.Game.Overlays.Comments
 {
@@ -18,7 +21,8 @@ namespace osu.Game.Overlays.Comments
 
         private void onCurrentChanged(ValueChangedEvent<int> count)
         {
-            Text = $@"Show More ({count.NewValue})".ToUpper();
+            Text = new TranslatableString(@"_", "{0} ({1})",
+                CommonStrings.ButtonsShowMore.ToUpper(), count.NewValue);
         }
     }
 }
diff --git a/osu.Game/Overlays/Comments/DrawableComment.cs b/osu.Game/Overlays/Comments/DrawableComment.cs
index 3286b6c5c0..3ec91c8e63 100644
--- a/osu.Game/Overlays/Comments/DrawableComment.cs
+++ b/osu.Game/Overlays/Comments/DrawableComment.cs
@@ -150,7 +150,7 @@ namespace osu.Game.Overlays.Comments
                                                         {
                                                             Alpha = Comment.IsDeleted ? 1 : 0,
                                                             Font = OsuFont.GetFont(size: 14, weight: FontWeight.Bold),
-                                                            Text = "deleted"
+                                                            Text = CommentsStrings.Deleted
                                                         }
                                                     }
                                                 },
diff --git a/osu.Game/Overlays/Comments/TotalCommentsCounter.cs b/osu.Game/Overlays/Comments/TotalCommentsCounter.cs
index 1bb9b52689..221a745189 100644
--- a/osu.Game/Overlays/Comments/TotalCommentsCounter.cs
+++ b/osu.Game/Overlays/Comments/TotalCommentsCounter.cs
@@ -9,6 +9,7 @@ using osuTK;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Game.Graphics.Sprites;
+using osu.Game.Resources.Localisation.Web;
 
 namespace osu.Game.Overlays.Comments
 {
@@ -39,7 +40,7 @@ namespace osu.Game.Overlays.Comments
                         Origin = Anchor.CentreLeft,
                         Font = OsuFont.GetFont(size: 20, italics: true),
                         Colour = colourProvider.Light1,
-                        Text = @"Comments"
+                        Text = CommentsStrings.Title
                     },
                     new CircularContainer
                     {
diff --git a/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs b/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs
index 786401b7a8..e036f1d304 100644
--- a/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs
+++ b/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs
@@ -14,6 +14,7 @@ using osu.Game.Database;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Spectator;
+using osu.Game.Resources.Localisation.Web;
 using osu.Game.Screens;
 using osu.Game.Screens.OnlinePlay.Match.Components;
 using osu.Game.Screens.Play;
@@ -138,7 +139,7 @@ namespace osu.Game.Overlays.Dashboard
                             new PurpleTriangleButton
                             {
                                 RelativeSizeAxes = Axes.X,
-                                Text = "Watch",
+                                Text = CommonStrings.ButtonsWatchTo1,
                                 Anchor = Anchor.TopCentre,
                                 Origin = Anchor.TopCentre,
                                 Action = () => performer?.PerformFromScreen(s => s.Push(new SoloSpectator(User))),
diff --git a/osu.Game/Overlays/Dashboard/Home/DrawableBeatmapList.cs b/osu.Game/Overlays/Dashboard/Home/DrawableBeatmapList.cs
index c73cc828e2..382bc00b1d 100644
--- a/osu.Game/Overlays/Dashboard/Home/DrawableBeatmapList.cs
+++ b/osu.Game/Overlays/Dashboard/Home/DrawableBeatmapList.cs
@@ -6,6 +6,7 @@ using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
+using osu.Framework.Localisation;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Online.API.Requests.Responses;
@@ -49,7 +50,7 @@ namespace osu.Game.Overlays.Dashboard.Home
             flow.AddRange(beatmapSets.Select(CreateBeatmapPanel));
         }
 
-        protected abstract string Title { get; }
+        protected abstract LocalisableString Title { get; }
 
         protected abstract DashboardBeatmapPanel CreateBeatmapPanel(APIBeatmapSet beatmapSet);
     }
diff --git a/osu.Game/Overlays/Dashboard/Home/DrawableNewBeatmapList.cs b/osu.Game/Overlays/Dashboard/Home/DrawableNewBeatmapList.cs
index 714e07a7ed..331fff0aea 100644
--- a/osu.Game/Overlays/Dashboard/Home/DrawableNewBeatmapList.cs
+++ b/osu.Game/Overlays/Dashboard/Home/DrawableNewBeatmapList.cs
@@ -2,7 +2,9 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System.Collections.Generic;
+using osu.Framework.Localisation;
 using osu.Game.Online.API.Requests.Responses;
+using osu.Game.Resources.Localisation.Web;
 
 namespace osu.Game.Overlays.Dashboard.Home
 {
@@ -15,6 +17,6 @@ namespace osu.Game.Overlays.Dashboard.Home
 
         protected override DashboardBeatmapPanel CreateBeatmapPanel(APIBeatmapSet beatmapSet) => new DashboardNewBeatmapPanel(beatmapSet);
 
-        protected override string Title => "New Ranked Beatmaps";
+        protected override LocalisableString Title => HomeStrings.UserBeatmapsNew;
     }
 }
diff --git a/osu.Game/Overlays/Dashboard/Home/DrawablePopularBeatmapList.cs b/osu.Game/Overlays/Dashboard/Home/DrawablePopularBeatmapList.cs
index 48b100b04e..154813dea1 100644
--- a/osu.Game/Overlays/Dashboard/Home/DrawablePopularBeatmapList.cs
+++ b/osu.Game/Overlays/Dashboard/Home/DrawablePopularBeatmapList.cs
@@ -2,7 +2,9 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System.Collections.Generic;
+using osu.Framework.Localisation;
 using osu.Game.Online.API.Requests.Responses;
+using osu.Game.Resources.Localisation.Web;
 
 namespace osu.Game.Overlays.Dashboard.Home
 {
@@ -15,6 +17,6 @@ namespace osu.Game.Overlays.Dashboard.Home
 
         protected override DashboardBeatmapPanel CreateBeatmapPanel(APIBeatmapSet beatmapSet) => new DashboardPopularBeatmapPanel(beatmapSet);
 
-        protected override string Title => "Popular Beatmaps";
+        protected override LocalisableString Title => HomeStrings.UserBeatmapsPopular;
     }
 }
diff --git a/osu.Game/Overlays/Dashboard/Home/News/ShowMoreNewsPanel.cs b/osu.Game/Overlays/Dashboard/Home/News/ShowMoreNewsPanel.cs
index d25df6f189..f6e966957e 100644
--- a/osu.Game/Overlays/Dashboard/Home/News/ShowMoreNewsPanel.cs
+++ b/osu.Game/Overlays/Dashboard/Home/News/ShowMoreNewsPanel.cs
@@ -6,6 +6,7 @@ using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
+using osu.Game.Resources.Localisation.Web;
 using osuTK.Graphics;
 
 namespace osu.Game.Overlays.Dashboard.Home.News
@@ -35,7 +36,7 @@ namespace osu.Game.Overlays.Dashboard.Home.News
                     Anchor = Anchor.Centre,
                     Origin = Anchor.Centre,
                     Margin = new MarginPadding { Vertical = 20 },
-                    Text = "see more"
+                    Text = CommonStrings.ButtonsSeeMore
                 }
             };
 
diff --git a/osu.Game/Overlays/Dialog/ConfirmDialog.cs b/osu.Game/Overlays/Dialog/ConfirmDialog.cs
index d1c0d746d1..58ce84e13a 100644
--- a/osu.Game/Overlays/Dialog/ConfirmDialog.cs
+++ b/osu.Game/Overlays/Dialog/ConfirmDialog.cs
@@ -3,6 +3,7 @@
 
 using System;
 using osu.Framework.Graphics.Sprites;
+using osu.Game.Resources.Localisation.Web;
 
 namespace osu.Game.Overlays.Dialog
 {
@@ -33,7 +34,7 @@ namespace osu.Game.Overlays.Dialog
                 },
                 new PopupDialogCancelButton
                 {
-                    Text = Localisation.CommonStrings.Cancel,
+                    Text = CommonStrings.ButtonsCancel,
                     Action = onCancel
                 },
             };
diff --git a/osu.Game/Overlays/Login/LoginForm.cs b/osu.Game/Overlays/Login/LoginForm.cs
index f7842dcd30..c31416e078 100644
--- a/osu.Game/Overlays/Login/LoginForm.cs
+++ b/osu.Game/Overlays/Login/LoginForm.cs
@@ -13,6 +13,7 @@ using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Online.API;
 using osu.Game.Overlays.Settings;
+using osu.Game.Resources.Localisation.Web;
 using osuTK;
 
 namespace osu.Game.Overlays.Login
@@ -50,14 +51,14 @@ namespace osu.Game.Overlays.Login
             {
                 username = new OsuTextBox
                 {
-                    PlaceholderText = "username",
+                    PlaceholderText = UsersStrings.LoginUsername,
                     RelativeSizeAxes = Axes.X,
                     Text = api?.ProvidedUsername ?? string.Empty,
                     TabbableContentContainer = this
                 },
                 password = new OsuPasswordTextBox
                 {
-                    PlaceholderText = "password",
+                    PlaceholderText = UsersStrings.LoginPassword,
                     RelativeSizeAxes = Axes.X,
                     TabbableContentContainer = this,
                 },
@@ -88,7 +89,7 @@ namespace osu.Game.Overlays.Login
                             AutoSizeAxes = Axes.Y,
                             Child = new SettingsButton
                             {
-                                Text = "Sign in",
+                                Text = UsersStrings.LoginButton,
                                 Action = performLogin
                             },
                         }
diff --git a/osu.Game/Overlays/Login/UserAction.cs b/osu.Game/Overlays/Login/UserAction.cs
index 07b6b4bf7e..d216670a28 100644
--- a/osu.Game/Overlays/Login/UserAction.cs
+++ b/osu.Game/Overlays/Login/UserAction.cs
@@ -2,11 +2,14 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System.ComponentModel;
+using osu.Framework.Localisation;
+using osu.Game.Resources.Localisation.Web;
 
 namespace osu.Game.Overlays.Login
 {
     public enum UserAction
     {
+        [LocalisableDescription(typeof(UsersStrings), nameof(UsersStrings.StatusOnline))]
         Online,
 
         [Description(@"Do not disturb")]
diff --git a/osu.Game/Overlays/Mods/ModSelectOverlay.cs b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
index ec7e49920c..9ce79c25f7 100644
--- a/osu.Game/Overlays/Mods/ModSelectOverlay.cs
+++ b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
@@ -20,6 +20,7 @@ using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Input.Bindings;
+using osu.Game.Resources.Localisation.Web;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Screens;
 using osu.Game.Utils;
@@ -317,7 +318,7 @@ namespace osu.Game.Overlays.Mods
                                             CloseButton = new TriangleButton
                                             {
                                                 Width = 180,
-                                                Text = "Close",
+                                                Text = CommonStrings.ButtonsClose,
                                                 Action = Hide,
                                                 Origin = Anchor.CentreLeft,
                                                 Anchor = Anchor.CentreLeft,
diff --git a/osu.Game/Overlays/NotificationOverlay.cs b/osu.Game/Overlays/NotificationOverlay.cs
index 2b5909f45a..f1ed5c4ba6 100644
--- a/osu.Game/Overlays/NotificationOverlay.cs
+++ b/osu.Game/Overlays/NotificationOverlay.cs
@@ -15,7 +15,8 @@ using osu.Framework.Localisation;
 using osu.Framework.Logging;
 using osu.Framework.Threading;
 using osu.Game.Graphics;
-using osu.Game.Localisation;
+using osu.Game.Resources.Localisation.Web;
+using NotificationsStrings = osu.Game.Localisation.NotificationsStrings;
 
 namespace osu.Game.Overlays
 {
@@ -61,7 +62,7 @@ namespace osu.Game.Overlays
                             RelativeSizeAxes = Axes.X,
                             Children = new[]
                             {
-                                new NotificationSection(@"Notifications", @"Clear All")
+                                new NotificationSection(AccountsStrings.NotificationsTitle, "Clear All")
                                 {
                                     AcceptTypes = new[] { typeof(SimpleNotification) }
                                 },
diff --git a/osu.Game/Overlays/Notifications/NotificationSection.cs b/osu.Game/Overlays/Notifications/NotificationSection.cs
index a23ff07a64..a4851ab365 100644
--- a/osu.Game/Overlays/Notifications/NotificationSection.cs
+++ b/osu.Game/Overlays/Notifications/NotificationSection.cs
@@ -6,6 +6,7 @@ using System.Collections.Generic;
 using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.IEnumerableExtensions;
+using osu.Framework.Extensions.LocalisationExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Localisation;
@@ -34,9 +35,9 @@ namespace osu.Game.Overlays.Notifications
 
         private readonly string clearButtonText;
 
-        private readonly string titleText;
+        private readonly LocalisableString titleText;
 
-        public NotificationSection(string title, string clearButtonText)
+        public NotificationSection(LocalisableString title, string clearButtonText)
         {
             this.clearButtonText = clearButtonText.ToUpperInvariant();
             titleText = title;
@@ -84,7 +85,7 @@ namespace osu.Game.Overlays.Notifications
                             {
                                 new OsuSpriteText
                                 {
-                                    Text = titleText.ToUpperInvariant(),
+                                    Text = titleText.ToUpper(),
                                     Font = OsuFont.GetFont(weight: FontWeight.Bold)
                                 },
                                 countDrawable = new OsuSpriteText
diff --git a/osu.Game/Overlays/Profile/Header/BottomHeaderContainer.cs b/osu.Game/Overlays/Profile/Header/BottomHeaderContainer.cs
index ea52cec2e1..a70d57661b 100644
--- a/osu.Game/Overlays/Profile/Header/BottomHeaderContainer.cs
+++ b/osu.Game/Overlays/Profile/Header/BottomHeaderContainer.cs
@@ -2,7 +2,6 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
-using System.Linq;
 using Humanizer;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
@@ -11,10 +10,12 @@ 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.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests.Responses;
+using osu.Game.Resources.Localisation.Web;
 using osuTK;
 using osuTK.Graphics;
 
@@ -83,7 +84,7 @@ namespace osu.Game.Overlays.Profile.Header
             if (user == null) return;
 
             if (user.JoinDate.ToUniversalTime().Year < 2008)
-                topLinkContainer.AddText("Here since the beginning");
+                topLinkContainer.AddText(UsersStrings.ShowFirstMembers);
             else
             {
                 topLinkContainer.AddText("Joined ");
@@ -94,7 +95,7 @@ namespace osu.Game.Overlays.Profile.Header
 
             if (user.IsOnline)
             {
-                topLinkContainer.AddText("Currently online");
+                topLinkContainer.AddText(UsersStrings.ShowLastvisitOnline);
                 addSpacer(topLinkContainer);
             }
             else if (user.LastVisit.HasValue)
@@ -108,7 +109,16 @@ namespace osu.Game.Overlays.Profile.Header
             if (user.PlayStyles?.Length > 0)
             {
                 topLinkContainer.AddText("Plays with ");
-                topLinkContainer.AddText(string.Join(", ", user.PlayStyles.Select(style => style.GetDescription())), embolden);
+
+                LocalisableString playStylesString = user.PlayStyles[0].GetLocalisableDescription();
+
+                for (int i = 1; i < user.PlayStyles.Length; i++)
+                {
+                    playStylesString = new TranslatableString(@"_", @"{0}{1}", playStylesString, CommonStrings.ArrayAndWordsConnector);
+                    playStylesString = new TranslatableString(@"_", @"{0}{1}", playStylesString, user.PlayStyles[i].GetLocalisableDescription());
+                }
+
+                topLinkContainer.AddText(playStylesString, embolden);
 
                 addSpacer(topLinkContainer);
             }
diff --git a/osu.Game/Overlays/Settings/Sections/Input/KeyBindingRow.cs b/osu.Game/Overlays/Settings/Sections/Input/KeyBindingRow.cs
index 2405618917..459405f57d 100644
--- a/osu.Game/Overlays/Settings/Sections/Input/KeyBindingRow.cs
+++ b/osu.Game/Overlays/Settings/Sections/Input/KeyBindingRow.cs
@@ -21,7 +21,7 @@ using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Input;
 using osu.Game.Input.Bindings;
-using osu.Game.Localisation;
+using osu.Game.Resources.Localisation.Web;
 using osuTK;
 using osuTK.Graphics;
 using osuTK.Input;
@@ -402,7 +402,7 @@ namespace osu.Game.Overlays.Settings.Sections.Input
         {
             public CancelButton()
             {
-                Text = CommonStrings.Cancel;
+                Text = CommonStrings.ButtonsCancel;
                 Size = new Vector2(80, 20);
             }
         }
@@ -411,7 +411,7 @@ namespace osu.Game.Overlays.Settings.Sections.Input
         {
             public ClearButton()
             {
-                Text = CommonStrings.Clear;
+                Text = CommonStrings.ButtonsClear;
                 Size = new Vector2(80, 20);
             }
         }
diff --git a/osu.Game/Overlays/Toolbar/ToolbarUserButton.cs b/osu.Game/Overlays/Toolbar/ToolbarUserButton.cs
index b0c9a04285..d8ba07dc3b 100644
--- a/osu.Game/Overlays/Toolbar/ToolbarUserButton.cs
+++ b/osu.Game/Overlays/Toolbar/ToolbarUserButton.cs
@@ -9,6 +9,7 @@ using osu.Framework.Graphics.Effects;
 using osu.Game.Graphics;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests.Responses;
+using osu.Game.Resources.Localisation.Web;
 using osu.Game.Users.Drawables;
 using osuTK;
 using osuTK.Graphics;
@@ -62,7 +63,7 @@ namespace osu.Game.Overlays.Toolbar
             switch (state.NewValue)
             {
                 default:
-                    Text = @"Guest";
+                    Text = UsersStrings.AnonymousUsername;
                     avatar.User = new APIUser();
                     break;
 
diff --git a/osu.Game/Overlays/Wiki/Markdown/WikiNoticeContainer.cs b/osu.Game/Overlays/Wiki/Markdown/WikiNoticeContainer.cs
index a22c18b0a4..11cab80a57 100644
--- a/osu.Game/Overlays/Wiki/Markdown/WikiNoticeContainer.cs
+++ b/osu.Game/Overlays/Wiki/Markdown/WikiNoticeContainer.cs
@@ -7,7 +7,9 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Containers.Markdown;
 using osu.Framework.Graphics.Shapes;
+using osu.Framework.Localisation;
 using osu.Game.Graphics;
+using osu.Game.Resources.Localisation.Web;
 
 namespace osu.Game.Overlays.Wiki.Markdown
 {
@@ -46,14 +48,14 @@ namespace osu.Game.Overlays.Wiki.Markdown
             {
                 Add(new NoticeBox
                 {
-                    Text = "The content on this page is incomplete or outdated. If you are able to help out, please consider updating the article!",
+                    Text = WikiStrings.ShowIncompleteOrOutdated,
                 });
             }
             else if (needsCleanup)
             {
                 Add(new NoticeBox
                 {
-                    Text = "This page does not meet the standards of the osu! wiki and needs to be cleaned up or rewritten. If you are able to help out, please consider updating the article!",
+                    Text = WikiStrings.ShowNeedsCleanupOrRewrite,
                 });
             }
         }
@@ -63,7 +65,7 @@ namespace osu.Game.Overlays.Wiki.Markdown
             [Resolved]
             private IMarkdownTextFlowComponent parentFlowComponent { get; set; }
 
-            public string Text { get; set; }
+            public LocalisableString Text { get; set; }
 
             [BackgroundDependencyLoader]
             private void load(OverlayColourProvider colourProvider, OsuColour colour)
diff --git a/osu.Game/Overlays/Wiki/WikiSidebar.cs b/osu.Game/Overlays/Wiki/WikiSidebar.cs
index ee4e195f3f..da96885fb5 100644
--- a/osu.Game/Overlays/Wiki/WikiSidebar.cs
+++ b/osu.Game/Overlays/Wiki/WikiSidebar.cs
@@ -3,11 +3,13 @@
 
 using Markdig.Syntax;
 using Markdig.Syntax.Inlines;
+using osu.Framework.Extensions.LocalisationExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Containers.Markdown;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
+using osu.Game.Resources.Localisation.Web;
 
 namespace osu.Game.Overlays.Wiki
 {
@@ -24,7 +26,7 @@ namespace osu.Game.Overlays.Wiki
             {
                 new OsuSpriteText
                 {
-                    Text = "CONTENTS",
+                    Text = WikiStrings.ShowToc.ToUpper(),
                     Font = OsuFont.GetFont(size: 12, weight: FontWeight.Bold),
                     Margin = new MarginPadding { Bottom = 5 },
                 },
diff --git a/osu.Game/Screens/Edit/Compose/Components/SelectionHandler.cs b/osu.Game/Screens/Edit/Compose/Components/SelectionHandler.cs
index 9d5d8013b7..78b98a3649 100644
--- a/osu.Game/Screens/Edit/Compose/Components/SelectionHandler.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/SelectionHandler.cs
@@ -17,6 +17,7 @@ using osu.Framework.Input.Events;
 using osu.Framework.Utils;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Input.Bindings;
+using osu.Game.Resources.Localisation.Web;
 using osu.Game.Rulesets.Edit;
 using osuTK;
 using osuTK.Input;
@@ -358,7 +359,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
                 if (SelectedBlueprints.Count == 1)
                     items.AddRange(SelectedBlueprints[0].ContextMenuItems);
 
-                items.Add(new OsuMenuItem("Delete", MenuItemType.Destructive, DeleteSelected));
+                items.Add(new OsuMenuItem(CommonStrings.ButtonsDelete, MenuItemType.Destructive, DeleteSelected));
 
                 return items.ToArray();
             }
diff --git a/osu.Game/Screens/Edit/Editor.cs b/osu.Game/Screens/Edit/Editor.cs
index 602b7563ac..30c57733ed 100644
--- a/osu.Game/Screens/Edit/Editor.cs
+++ b/osu.Game/Screens/Edit/Editor.cs
@@ -29,6 +29,7 @@ using osu.Game.Input.Bindings;
 using osu.Game.Online.API;
 using osu.Game.Overlays;
 using osu.Game.Overlays.Notifications;
+using osu.Game.Resources.Localisation.Web;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Edit;
 using osu.Game.Screens.Edit.Components;
@@ -252,7 +253,7 @@ namespace osu.Game.Screens.Edit
                                     {
                                         Items = createFileMenuItems()
                                     },
-                                    new MenuItem("Edit")
+                                    new MenuItem(CommonStrings.ButtonsEdit)
                                     {
                                         Items = new[]
                                         {
diff --git a/osu.Game/Screens/Edit/Setup/DifficultySection.cs b/osu.Game/Screens/Edit/Setup/DifficultySection.cs
index 75c6a89a66..e799081115 100644
--- a/osu.Game/Screens/Edit/Setup/DifficultySection.cs
+++ b/osu.Game/Screens/Edit/Setup/DifficultySection.cs
@@ -8,6 +8,7 @@ using osu.Framework.Graphics;
 using osu.Framework.Localisation;
 using osu.Game.Beatmaps;
 using osu.Game.Graphics.UserInterfaceV2;
+using osu.Game.Resources.Localisation.Web;
 
 namespace osu.Game.Screens.Edit.Setup
 {
@@ -27,7 +28,7 @@ namespace osu.Game.Screens.Edit.Setup
             {
                 circleSizeSlider = new LabelledSliderBar<float>
                 {
-                    Label = "Object Size",
+                    Label = BeatmapsetsStrings.ShowStatsCs,
                     FixedLabelWidth = LABEL_WIDTH,
                     Description = "The size of all hit objects",
                     Current = new BindableFloat(Beatmap.Difficulty.CircleSize)
@@ -40,7 +41,7 @@ namespace osu.Game.Screens.Edit.Setup
                 },
                 healthDrainSlider = new LabelledSliderBar<float>
                 {
-                    Label = "Health Drain",
+                    Label = BeatmapsetsStrings.ShowStatsDrain,
                     FixedLabelWidth = LABEL_WIDTH,
                     Description = "The rate of passive health drain throughout playable time",
                     Current = new BindableFloat(Beatmap.Difficulty.DrainRate)
@@ -53,7 +54,7 @@ namespace osu.Game.Screens.Edit.Setup
                 },
                 approachRateSlider = new LabelledSliderBar<float>
                 {
-                    Label = "Approach Rate",
+                    Label = BeatmapsetsStrings.ShowStatsAr,
                     FixedLabelWidth = LABEL_WIDTH,
                     Description = "The speed at which objects are presented to the player",
                     Current = new BindableFloat(Beatmap.Difficulty.ApproachRate)
@@ -66,7 +67,7 @@ namespace osu.Game.Screens.Edit.Setup
                 },
                 overallDifficultySlider = new LabelledSliderBar<float>
                 {
-                    Label = "Overall Difficulty",
+                    Label = BeatmapsetsStrings.ShowStatsAccuracy,
                     FixedLabelWidth = LABEL_WIDTH,
                     Description = "The harshness of hit windows and difficulty of special objects (ie. spinners)",
                     Current = new BindableFloat(Beatmap.Difficulty.OverallDifficulty)
diff --git a/osu.Game/Screens/Edit/Setup/MetadataSection.cs b/osu.Game/Screens/Edit/Setup/MetadataSection.cs
index 571dfb3f6f..6262b4c18b 100644
--- a/osu.Game/Screens/Edit/Setup/MetadataSection.cs
+++ b/osu.Game/Screens/Edit/Setup/MetadataSection.cs
@@ -7,6 +7,7 @@ using osu.Framework.Graphics.UserInterface;
 using osu.Framework.Localisation;
 using osu.Game.Beatmaps;
 using osu.Game.Graphics.UserInterfaceV2;
+using osu.Game.Resources.Localisation.Web;
 
 namespace osu.Game.Screens.Edit.Setup
 {
@@ -48,15 +49,15 @@ namespace osu.Game.Screens.Edit.Setup
 
                 creatorTextBox = createTextBox<LabelledTextBox>("Creator", metadata.Author.Username),
                 difficultyTextBox = createTextBox<LabelledTextBox>("Difficulty Name", Beatmap.BeatmapInfo.DifficultyName),
-                sourceTextBox = createTextBox<LabelledTextBox>("Source", metadata.Source),
-                tagsTextBox = createTextBox<LabelledTextBox>("Tags", metadata.Tags)
+                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>(string label, string initialValue)
+        private TTextBox createTextBox<TTextBox>(LocalisableString label, string initialValue)
             where TTextBox : LabelledTextBox, new()
             => new TTextBox
             {
diff --git a/osu.Game/Screens/OnlinePlay/Components/OverlinedHeader.cs b/osu.Game/Screens/OnlinePlay/Components/OverlinedHeader.cs
index 08a0a3405e..f667a3c1d2 100644
--- a/osu.Game/Screens/OnlinePlay/Components/OverlinedHeader.cs
+++ b/osu.Game/Screens/OnlinePlay/Components/OverlinedHeader.cs
@@ -6,6 +6,7 @@ using osu.Framework.Bindables;
 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.Graphics.Sprites;
 using osuTK;
@@ -34,7 +35,7 @@ namespace osu.Game.Screens.OnlinePlay.Components
         private readonly Circle line;
         private readonly OsuSpriteText details;
 
-        public OverlinedHeader(string title)
+        public OverlinedHeader(LocalisableString title)
         {
             RelativeSizeAxes = Axes.X;
             AutoSizeAxes = Axes.Y;
diff --git a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
index 25b36e0774..459b861d96 100644
--- a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
+++ b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
@@ -26,6 +26,7 @@ using osu.Game.Online;
 using osu.Game.Online.Chat;
 using osu.Game.Online.Rooms;
 using osu.Game.Overlays.BeatmapSet;
+using osu.Game.Resources.Localisation.Web;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Screens.Play.HUD;
@@ -449,7 +450,7 @@ namespace osu.Game.Screens.OnlinePlay
                 Size = new Vector2(30, 30),
                 Alpha = AllowEditing ? 1 : 0,
                 Action = () => RequestEdit?.Invoke(Item),
-                TooltipText = "Edit"
+                TooltipText = CommonStrings.ButtonsEdit
             },
             removeButton = new PlaylistRemoveButton
             {
diff --git a/osu.Game/Screens/OnlinePlay/Match/Components/MatchLeaderboardScore.cs b/osu.Game/Screens/OnlinePlay/Match/Components/MatchLeaderboardScore.cs
index cf7e33fd63..799983342b 100644
--- a/osu.Game/Screens/OnlinePlay/Match/Components/MatchLeaderboardScore.cs
+++ b/osu.Game/Screens/OnlinePlay/Match/Components/MatchLeaderboardScore.cs
@@ -6,6 +6,7 @@ using osu.Framework.Allocation;
 using osu.Framework.Graphics.Sprites;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Leaderboards;
+using osu.Game.Resources.Localisation.Web;
 using osu.Game.Scoring;
 
 namespace osu.Game.Screens.OnlinePlay.Match.Components
@@ -30,8 +31,8 @@ namespace osu.Game.Screens.OnlinePlay.Match.Components
 
         protected override IEnumerable<LeaderboardScoreStatistic> GetStatistics(ScoreInfo model) => new[]
         {
-            new LeaderboardScoreStatistic(FontAwesome.Solid.Crosshairs, "Accuracy", model.DisplayAccuracy),
-            new LeaderboardScoreStatistic(FontAwesome.Solid.Sync, "Total Attempts", score.TotalAttempts.ToString()),
+            new LeaderboardScoreStatistic(FontAwesome.Solid.Crosshairs, RankingsStrings.StatAccuracy, model.DisplayAccuracy),
+            new LeaderboardScoreStatistic(FontAwesome.Solid.Sync, RankingsStrings.StatPlayCount, score.TotalAttempts.ToString()),
             new LeaderboardScoreStatistic(FontAwesome.Solid.Check, "Completed Beatmaps", score.CompletedBeatmaps.ToString()),
         };
     }
diff --git a/osu.Game/Screens/OnlinePlay/Match/DrawableMatchRoom.cs b/osu.Game/Screens/OnlinePlay/Match/DrawableMatchRoom.cs
index cdd2ae0c9c..1828a072f8 100644
--- a/osu.Game/Screens/OnlinePlay/Match/DrawableMatchRoom.cs
+++ b/osu.Game/Screens/OnlinePlay/Match/DrawableMatchRoom.cs
@@ -10,6 +10,7 @@ using osu.Game.Beatmaps.Drawables;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Rooms;
+using osu.Game.Resources.Localisation.Web;
 using osu.Game.Screens.OnlinePlay.Lounge.Components;
 using osu.Game.Screens.OnlinePlay.Match.Components;
 using osuTK;
@@ -49,7 +50,7 @@ namespace osu.Game.Screens.OnlinePlay.Match
                 {
                     RelativeSizeAxes = Axes.Y,
                     Size = new Vector2(100, 1),
-                    Text = "Edit",
+                    Text = CommonStrings.ButtonsEdit,
                     Action = () => OnEdit?.Invoke()
                 });
             }
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantsListHeader.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantsListHeader.cs
index 7e442c6568..ef84c4b4fa 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantsListHeader.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantsListHeader.cs
@@ -3,6 +3,7 @@
 
 using osu.Framework.Allocation;
 using osu.Game.Online.Multiplayer;
+using osu.Game.Resources.Localisation.Web;
 using osu.Game.Screens.OnlinePlay.Components;
 
 namespace osu.Game.Screens.OnlinePlay.Multiplayer.Participants
@@ -13,7 +14,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Participants
         private MultiplayerClient client { get; set; }
 
         public ParticipantsListHeader()
-            : base("Participants")
+            : base(RankingsStrings.SpotlightParticipants)
         {
         }
 
diff --git a/osu.Game/Screens/Play/BeatmapMetadataDisplay.cs b/osu.Game/Screens/Play/BeatmapMetadataDisplay.cs
index 0d759bacf0..4a0bab84fa 100644
--- a/osu.Game/Screens/Play/BeatmapMetadataDisplay.cs
+++ b/osu.Game/Screens/Play/BeatmapMetadataDisplay.cs
@@ -14,6 +14,7 @@ using osu.Game.Beatmaps.Drawables;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.UserInterface;
+using osu.Game.Resources.Localisation.Web;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Screens.Play.HUD;
 using osuTK;
@@ -158,7 +159,7 @@ namespace osu.Game.Screens.Play
                             {
                                 new Drawable[]
                                 {
-                                    new MetadataLineLabel("Source"),
+                                    new MetadataLineLabel(BeatmapsetsStrings.ShowInfoSource),
                                     new MetadataLineInfo(metadata.Source)
                                 },
                                 new Drawable[]
@@ -213,7 +214,7 @@ namespace osu.Game.Screens.Play
 
         private class MetadataLineLabel : OsuSpriteText
         {
-            public MetadataLineLabel(string text)
+            public MetadataLineLabel(LocalisableString text)
             {
                 Anchor = Anchor.TopRight;
                 Origin = Anchor.TopRight;
@@ -225,10 +226,10 @@ namespace osu.Game.Screens.Play
 
         private class MetadataLineInfo : OsuSpriteText
         {
-            public MetadataLineInfo(string text)
+            public MetadataLineInfo(LocalisableString text)
             {
                 Margin = new MarginPadding { Left = 5 };
-                Text = string.IsNullOrEmpty(text) ? @"-" : text;
+                Text = string.IsNullOrEmpty(text.ToString()) ? @"-" : text;
             }
         }
     }
diff --git a/osu.Game/Screens/Play/Break/BreakInfo.cs b/osu.Game/Screens/Play/Break/BreakInfo.cs
index 6349ebd9a7..f95e949920 100644
--- a/osu.Game/Screens/Play/Break/BreakInfo.cs
+++ b/osu.Game/Screens/Play/Break/BreakInfo.cs
@@ -5,6 +5,7 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
+using osu.Game.Resources.Localisation.Web;
 using osu.Game.Scoring;
 using osuTK;
 
@@ -42,7 +43,7 @@ namespace osu.Game.Screens.Play.Break
                         Direction = FillDirection.Vertical,
                         Children = new Drawable[]
                         {
-                            AccuracyDisplay = new PercentageBreakInfoLine("Accuracy"),
+                            AccuracyDisplay = new PercentageBreakInfoLine(BeatmapsetsStrings.ShowStatsAccuracy),
 
                             // See https://github.com/ppy/osu/discussions/15185
                             // RankDisplay = new BreakInfoLine<int>("Rank"),
diff --git a/osu.Game/Screens/Play/Break/BreakInfoLine.cs b/osu.Game/Screens/Play/Break/BreakInfoLine.cs
index 87f514ffd5..4cae90e50f 100644
--- a/osu.Game/Screens/Play/Break/BreakInfoLine.cs
+++ b/osu.Game/Screens/Play/Break/BreakInfoLine.cs
@@ -26,7 +26,7 @@ namespace osu.Game.Screens.Play.Break
 
         private readonly string prefix;
 
-        public BreakInfoLine(string name, string prefix = @"")
+        public BreakInfoLine(LocalisableString name, string prefix = @"")
         {
             this.prefix = prefix;
 
@@ -82,7 +82,7 @@ namespace osu.Game.Screens.Play.Break
 
     public class PercentageBreakInfoLine : BreakInfoLine<double>
     {
-        public PercentageBreakInfoLine(string name, string prefix = "")
+        public PercentageBreakInfoLine(LocalisableString name, string prefix = "")
             : base(name, prefix)
         {
         }
diff --git a/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs b/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs
index 8b1e0ae83e..019a9f9730 100644
--- a/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs
+++ b/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs
@@ -19,6 +19,7 @@ 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;
@@ -200,7 +201,7 @@ namespace osu.Game.Screens.Play.HUD
                         {
                             Anchor = Anchor.BottomLeft,
                             Origin = Anchor.BottomLeft,
-                            Text = @"pp",
+                            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/PlayerSettings/AudioSettings.cs b/osu.Game/Screens/Play/PlayerSettings/AudioSettings.cs
index 32de5333e1..90caf6f0f3 100644
--- a/osu.Game/Screens/Play/PlayerSettings/AudioSettings.cs
+++ b/osu.Game/Screens/Play/PlayerSettings/AudioSettings.cs
@@ -5,6 +5,7 @@ using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Game.Configuration;
+using osu.Game.Localisation;
 using osu.Game.Scoring;
 
 namespace osu.Game.Screens.Play.PlayerSettings
@@ -20,7 +21,7 @@ namespace osu.Game.Screens.Play.PlayerSettings
         {
             Children = new Drawable[]
             {
-                beatmapHitsoundsToggle = new PlayerCheckbox { LabelText = "Beatmap hitsounds" },
+                beatmapHitsoundsToggle = new PlayerCheckbox { LabelText = SkinSettingsStrings.BeatmapHitsounds },
                 new BeatmapOffsetControl
                 {
                     ReferenceScore = { BindTarget = ReferenceScore },
diff --git a/osu.Game/Screens/Play/PlayerSettings/VisualSettings.cs b/osu.Game/Screens/Play/PlayerSettings/VisualSettings.cs
index 81950efa9e..a999b32cb4 100644
--- a/osu.Game/Screens/Play/PlayerSettings/VisualSettings.cs
+++ b/osu.Game/Screens/Play/PlayerSettings/VisualSettings.cs
@@ -5,6 +5,7 @@ using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Game.Configuration;
 using osu.Game.Graphics.Sprites;
+using osu.Game.Localisation;
 
 namespace osu.Game.Screens.Play.PlayerSettings
 {
@@ -23,7 +24,7 @@ namespace osu.Game.Screens.Play.PlayerSettings
             {
                 new OsuSpriteText
                 {
-                    Text = "Background dim:"
+                    Text = GameplaySettingsStrings.BackgroundDim
                 },
                 dimSliderBar = new PlayerSliderBar<double>
                 {
@@ -31,7 +32,7 @@ namespace osu.Game.Screens.Play.PlayerSettings
                 },
                 new OsuSpriteText
                 {
-                    Text = "Background blur:"
+                    Text = GameplaySettingsStrings.BackgroundBlur
                 },
                 blurSliderBar = new PlayerSliderBar<double>
                 {
@@ -41,9 +42,9 @@ namespace osu.Game.Screens.Play.PlayerSettings
                 {
                     Text = "Toggles:"
                 },
-                showStoryboardToggle = new PlayerCheckbox { LabelText = "Storyboard / Video" },
-                beatmapSkinsToggle = new PlayerCheckbox { LabelText = "Beatmap skins" },
-                beatmapColorsToggle = new PlayerCheckbox { LabelText = "Beatmap colours" },
+                showStoryboardToggle = new PlayerCheckbox { LabelText = GraphicsSettingsStrings.StoryboardVideo },
+                beatmapSkinsToggle = new PlayerCheckbox { LabelText = SkinSettingsStrings.BeatmapSkins },
+                beatmapColorsToggle = new PlayerCheckbox { LabelText = SkinSettingsStrings.BeatmapColours },
             };
         }
 
diff --git a/osu.Game/Screens/Ranking/Contracted/ContractedPanelMiddleContent.cs b/osu.Game/Screens/Ranking/Contracted/ContractedPanelMiddleContent.cs
index f9aff28bef..bb286f41c0 100644
--- a/osu.Game/Screens/Ranking/Contracted/ContractedPanelMiddleContent.cs
+++ b/osu.Game/Screens/Ranking/Contracted/ContractedPanelMiddleContent.cs
@@ -9,9 +9,11 @@ using osu.Framework.Graphics.Colour;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Effects;
 using osu.Framework.Graphics.Shapes;
+using osu.Framework.Localisation;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Online.Leaderboards;
+using osu.Game.Resources.Localisation.Web;
 using osu.Game.Rulesets.Scoring;
 using osu.Game.Scoring;
 using osu.Game.Screens.Play.HUD;
@@ -127,8 +129,8 @@ namespace osu.Game.Screens.Ranking.Contracted
                                             Spacing = new Vector2(0, 5),
                                             Children = new[]
                                             {
-                                                createStatistic("Max Combo", $"x{score.MaxCombo}"),
-                                                createStatistic("Accuracy", $"{score.Accuracy.FormatAccuracy()}"),
+                                                createStatistic(BeatmapsetsStrings.ShowScoreboardHeadersCombo, $"x{score.MaxCombo}"),
+                                                createStatistic(BeatmapsetsStrings.ShowScoreboardHeadersAccuracy, $"{score.Accuracy.FormatAccuracy()}"),
                                             }
                                         },
                                         new ModFlowDisplay
@@ -200,7 +202,7 @@ namespace osu.Game.Screens.Ranking.Contracted
         private Drawable createStatistic(HitResultDisplayStatistic result)
             => createStatistic(result.DisplayName, result.MaxCount == null ? $"{result.Count}" : $"{result.Count}/{result.MaxCount}");
 
-        private Drawable createStatistic(string key, string value) => new Container
+        private Drawable createStatistic(LocalisableString key, string value) => new Container
         {
             RelativeSizeAxes = Axes.X,
             AutoSizeAxes = Axes.Y,
diff --git a/osu.Game/Screens/Ranking/Expanded/Statistics/AccuracyStatistic.cs b/osu.Game/Screens/Ranking/Expanded/Statistics/AccuracyStatistic.cs
index 476c9fb42f..25a644d8d9 100644
--- a/osu.Game/Screens/Ranking/Expanded/Statistics/AccuracyStatistic.cs
+++ b/osu.Game/Screens/Ranking/Expanded/Statistics/AccuracyStatistic.cs
@@ -6,6 +6,7 @@ using osu.Framework.Localisation;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.UserInterface;
+using osu.Game.Resources.Localisation.Web;
 using osu.Game.Screens.Ranking.Expanded.Accuracy;
 using osu.Game.Utils;
 using osuTK;
@@ -26,7 +27,7 @@ namespace osu.Game.Screens.Ranking.Expanded.Statistics
         /// </summary>
         /// <param name="accuracy">The accuracy to display.</param>
         public AccuracyStatistic(double accuracy)
-            : base("accuracy")
+            : base(BeatmapsetsStrings.ShowScoreboardHeadersAccuracy)
         {
             this.accuracy = accuracy;
         }
diff --git a/osu.Game/Screens/Ranking/Expanded/Statistics/ComboStatistic.cs b/osu.Game/Screens/Ranking/Expanded/Statistics/ComboStatistic.cs
index 0e42ec026a..cb25736f6e 100644
--- a/osu.Game/Screens/Ranking/Expanded/Statistics/ComboStatistic.cs
+++ b/osu.Game/Screens/Ranking/Expanded/Statistics/ComboStatistic.cs
@@ -7,6 +7,7 @@ using osu.Framework.Graphics.Colour;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
+using osu.Game.Resources.Localisation.Web;
 using osu.Game.Screens.Ranking.Expanded.Accuracy;
 using osuTK;
 
@@ -27,7 +28,7 @@ namespace osu.Game.Screens.Ranking.Expanded.Statistics
         /// <param name="combo">The combo to be displayed.</param>
         /// <param name="maxCombo">The maximum value of <paramref name="combo"/>.</param>
         public ComboStatistic(int combo, int? maxCombo)
-            : base("combo", combo, maxCombo)
+            : base(BeatmapsetsStrings.ShowScoreboardHeadersCombo, combo, maxCombo)
         {
             isPerfect = combo == maxCombo;
         }
diff --git a/osu.Game/Screens/Ranking/Expanded/Statistics/CounterStatistic.cs b/osu.Game/Screens/Ranking/Expanded/Statistics/CounterStatistic.cs
index d37f6c5e5f..b1c72173da 100644
--- a/osu.Game/Screens/Ranking/Expanded/Statistics/CounterStatistic.cs
+++ b/osu.Game/Screens/Ranking/Expanded/Statistics/CounterStatistic.cs
@@ -3,6 +3,7 @@
 
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
+using osu.Framework.Localisation;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.UserInterface;
@@ -26,7 +27,7 @@ namespace osu.Game.Screens.Ranking.Expanded.Statistics
         /// <param name="header">The name of the statistic.</param>
         /// <param name="count">The value to display.</param>
         /// <param name="maxCount">The maximum value of <paramref name="count"/>. Not displayed if null.</param>
-        public CounterStatistic(string header, int count, int? maxCount = null)
+        public CounterStatistic(LocalisableString header, int count, int? maxCount = null)
             : base(header)
         {
             this.count = count;
diff --git a/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatistic.cs b/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatistic.cs
index 95f017d625..c681946a2f 100644
--- a/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatistic.cs
+++ b/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatistic.cs
@@ -8,6 +8,7 @@ using osu.Framework.Bindables;
 using osu.Framework.Extensions;
 using osu.Framework.Graphics;
 using osu.Game.Graphics.UserInterface;
+using osu.Game.Resources.Localisation.Web;
 using osu.Game.Scoring;
 
 namespace osu.Game.Screens.Ranking.Expanded.Statistics
@@ -23,7 +24,7 @@ namespace osu.Game.Screens.Ranking.Expanded.Statistics
         private RollingCounter<int> counter;
 
         public PerformanceStatistic(ScoreInfo score)
-            : base("PP")
+            : base(BeatmapsetsStrings.ShowScoreboardHeaderspp)
         {
             this.score = score;
         }
diff --git a/osu.Game/Screens/Ranking/Expanded/Statistics/StatisticDisplay.cs b/osu.Game/Screens/Ranking/Expanded/Statistics/StatisticDisplay.cs
index 9206c58bc9..c034abc916 100644
--- a/osu.Game/Screens/Ranking/Expanded/Statistics/StatisticDisplay.cs
+++ b/osu.Game/Screens/Ranking/Expanded/Statistics/StatisticDisplay.cs
@@ -3,10 +3,12 @@
 
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.Color4Extensions;
+using osu.Framework.Extensions.LocalisationExtensions;
 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.Game.Graphics;
 using osu.Game.Graphics.Sprites;
 
@@ -19,14 +21,14 @@ namespace osu.Game.Screens.Ranking.Expanded.Statistics
     {
         protected SpriteText HeaderText { get; private set; }
 
-        private readonly string header;
+        private readonly LocalisableString header;
         private Drawable content;
 
         /// <summary>
         /// Creates a new <see cref="StatisticDisplay"/>.
         /// </summary>
         /// <param name="header">The name of the statistic.</param>
-        protected StatisticDisplay(string header)
+        protected StatisticDisplay(LocalisableString header)
         {
             this.header = header;
             RelativeSizeAxes = Axes.X;
@@ -60,7 +62,7 @@ namespace osu.Game.Screens.Ranking.Expanded.Statistics
                                 Anchor = Anchor.Centre,
                                 Origin = Anchor.Centre,
                                 Font = OsuFont.Torus.With(size: 12, weight: FontWeight.SemiBold),
-                                Text = header.ToUpperInvariant(),
+                                Text = header.ToUpper(),
                             }
                         }
                     },
diff --git a/osu.Game/Screens/Select/BeatmapDetails.cs b/osu.Game/Screens/Select/BeatmapDetails.cs
index bbe0a37d8e..9ff1574fe4 100644
--- a/osu.Game/Screens/Select/BeatmapDetails.cs
+++ b/osu.Game/Screens/Select/BeatmapDetails.cs
@@ -16,6 +16,7 @@ using osu.Game.Online;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests;
 using osu.Game.Overlays.BeatmapSet;
+using osu.Game.Resources.Localisation.Web;
 using osu.Game.Screens.Select.Details;
 using osuTK;
 using osuTK.Graphics;
@@ -155,7 +156,7 @@ namespace osu.Game.Screens.Select
                                         {
                                             new OsuSpriteText
                                             {
-                                                Text = "Points of Failure",
+                                                Text = BeatmapsetsStrings.ShowInfoPointsOfFailure,
                                                 Font = OsuFont.GetFont(weight: FontWeight.Bold, size: 14),
                                             },
                                             failRetryGraph = new FailRetryGraph
diff --git a/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmap.cs b/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmap.cs
index 3576b77ae8..c6037d1bd6 100644
--- a/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmap.cs
+++ b/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmap.cs
@@ -24,6 +24,7 @@ using osu.Game.Graphics.Backgrounds;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Overlays;
+using osu.Game.Resources.Localisation.Web;
 using osuTK;
 using osuTK.Graphics;
 
@@ -136,14 +137,7 @@ namespace osu.Game.Screens.Select.Carousel
                                         },
                                         new OsuSpriteText
                                         {
-                                            Text = "mapped by",
-                                            Anchor = Anchor.BottomLeft,
-                                            Origin = Anchor.BottomLeft
-                                        },
-                                        new OsuSpriteText
-                                        {
-                                            Text = $"{beatmapInfo.Metadata.Author.Username}",
-                                            Font = OsuFont.GetFont(italics: true),
+                                            Text = BeatmapsetsStrings.ShowDetailsMappedBy(beatmapInfo.Metadata.Author.Username),
                                             Anchor = Anchor.BottomLeft,
                                             Origin = Anchor.BottomLeft
                                         },
@@ -235,7 +229,7 @@ namespace osu.Game.Screens.Select.Carousel
                     items.Add(new OsuMenuItem("Play", MenuItemType.Highlighted, () => startRequested(beatmapInfo)));
 
                 if (editRequested != null)
-                    items.Add(new OsuMenuItem("Edit", MenuItemType.Standard, () => editRequested(beatmapInfo)));
+                    items.Add(new OsuMenuItem(CommonStrings.ButtonsEdit, MenuItemType.Standard, () => editRequested(beatmapInfo)));
 
                 if (beatmapInfo.OnlineID > 0 && beatmapOverlay != null)
                     items.Add(new OsuMenuItem("Details...", MenuItemType.Standard, () => beatmapOverlay.FetchAndShowBeatmap(beatmapInfo.OnlineID)));
@@ -250,7 +244,7 @@ namespace osu.Game.Screens.Select.Carousel
                 }
 
                 if (hideRequested != null)
-                    items.Add(new OsuMenuItem("Hide", MenuItemType.Destructive, () => hideRequested(beatmapInfo)));
+                    items.Add(new OsuMenuItem(CommonStrings.ButtonsHide, MenuItemType.Destructive, () => hideRequested(beatmapInfo)));
 
                 return items.ToArray();
             }
diff --git a/osu.Game/Screens/Select/Details/AdvancedStats.cs b/osu.Game/Screens/Select/Details/AdvancedStats.cs
index adaaa6425c..a6f2520472 100644
--- a/osu.Game/Screens/Select/Details/AdvancedStats.cs
+++ b/osu.Game/Screens/Select/Details/AdvancedStats.cs
@@ -21,6 +21,7 @@ using osu.Framework.Localisation;
 using osu.Framework.Threading;
 using osu.Framework.Utils;
 using osu.Game.Configuration;
+using osu.Game.Resources.Localisation.Web;
 using osu.Game.Rulesets;
 
 namespace osu.Game.Screens.Select.Details
@@ -63,10 +64,10 @@ namespace osu.Game.Screens.Select.Details
                 Children = new[]
                 {
                     FirstValue = new StatisticRow(), // circle size/key amount
-                    HpDrain = new StatisticRow { Title = "HP Drain" },
-                    Accuracy = new StatisticRow { Title = "Accuracy" },
-                    ApproachRate = new StatisticRow { Title = "Approach Rate" },
-                    starDifficulty = new StatisticRow(10, true) { Title = "Star Difficulty" },
+                    HpDrain = new StatisticRow { Title = BeatmapsetsStrings.ShowStatsDrain },
+                    Accuracy = new StatisticRow { Title = BeatmapsetsStrings.ShowStatsAccuracy },
+                    ApproachRate = new StatisticRow { Title = BeatmapsetsStrings.ShowStatsAr },
+                    starDifficulty = new StatisticRow(10, true) { Title = BeatmapsetsStrings.ShowStatsStars },
                 },
             };
         }
@@ -120,12 +121,12 @@ namespace osu.Game.Screens.Select.Details
                 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
-                    FirstValue.Title = "Key Count";
+                    FirstValue.Title = BeatmapsetsStrings.ShowStatsCsMania;
                     FirstValue.Value = (baseDifficulty?.CircleSize ?? 0, null);
                     break;
 
                 default:
-                    FirstValue.Title = "Circle Size";
+                    FirstValue.Title = BeatmapsetsStrings.ShowStatsCs;
                     FirstValue.Value = (baseDifficulty?.CircleSize ?? 0, adjustedDifficulty?.CircleSize);
                     break;
             }
diff --git a/osu.Game/Screens/Select/Filter/SortMode.cs b/osu.Game/Screens/Select/Filter/SortMode.cs
index 18c5d713e1..1ab54fa069 100644
--- a/osu.Game/Screens/Select/Filter/SortMode.cs
+++ b/osu.Game/Screens/Select/Filter/SortMode.cs
@@ -2,36 +2,38 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System.ComponentModel;
+using osu.Framework.Localisation;
+using osu.Game.Resources.Localisation.Web;
 
 namespace osu.Game.Screens.Select.Filter
 {
     public enum SortMode
     {
-        [Description("Artist")]
+        [LocalisableDescription(typeof(BeatmapsStrings), nameof(BeatmapsStrings.ListingSearchSortingArtist))]
         Artist,
 
         [Description("Author")]
         Author,
 
-        [Description("BPM")]
+        [LocalisableDescription(typeof(BeatmapsetsStrings), nameof(BeatmapsetsStrings.ShowStatsBpm))]
         BPM,
 
         [Description("Date Added")]
         DateAdded,
 
-        [Description("Difficulty")]
+        [LocalisableDescription(typeof(BeatmapsStrings), nameof(BeatmapsStrings.ListingSearchSortingDifficulty))]
         Difficulty,
 
-        [Description("Length")]
+        [LocalisableDescription(typeof(SortStrings), nameof(SortStrings.ArtistTracksLength))]
         Length,
 
-        [Description("Rank Achieved")]
+        [LocalisableDescription(typeof(BeatmapsStrings), nameof(BeatmapsStrings.ListingSearchFiltersRank))]
         RankAchieved,
 
-        [Description("Source")]
+        [LocalisableDescription(typeof(BeatmapsetsStrings), nameof(BeatmapsetsStrings.ShowInfoSource))]
         Source,
 
-        [Description("Title")]
+        [LocalisableDescription(typeof(BeatmapsStrings), nameof(BeatmapsStrings.ListingSearchSortingTitle))]
         Title,
     }
 }
diff --git a/osu.Game/Screens/Select/FilterControl.cs b/osu.Game/Screens/Select/FilterControl.cs
index b53d64260a..65dde146bb 100644
--- a/osu.Game/Screens/Select/FilterControl.cs
+++ b/osu.Game/Screens/Select/FilterControl.cs
@@ -14,6 +14,7 @@ using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.UserInterface;
+using osu.Game.Resources.Localisation.Web;
 using osu.Game.Rulesets;
 using osu.Game.Screens.Select.Filter;
 using osuTK;
@@ -139,7 +140,7 @@ namespace osu.Game.Screens.Select
                                             },
                                             new OsuSpriteText
                                             {
-                                                Text = "Sort by",
+                                                Text = SortStrings.Default,
                                                 Font = OsuFont.GetFont(size: 14),
                                                 Margin = new MarginPadding(5),
                                                 Anchor = Anchor.BottomRight,
diff --git a/osu.Game/Screens/Select/Options/BeatmapOptionsOverlay.cs b/osu.Game/Screens/Select/Options/BeatmapOptionsOverlay.cs
index b5fdbd225f..1a8b69d859 100644
--- a/osu.Game/Screens/Select/Options/BeatmapOptionsOverlay.cs
+++ b/osu.Game/Screens/Select/Options/BeatmapOptionsOverlay.cs
@@ -13,6 +13,7 @@ using osuTK.Input;
 using osu.Game.Graphics.Containers;
 using osu.Framework.Input.Events;
 using System.Linq;
+using osu.Framework.Localisation;
 
 namespace osu.Game.Screens.Select.Options
 {
@@ -63,7 +64,7 @@ namespace osu.Game.Screens.Select.Options
         /// <param name="colour">Colour of the button.</param>
         /// <param name="icon">Icon of the button.</param>
         /// <param name="action">Binding the button does.</param>
-        public void AddButton(string firstLine, string secondLine, IconUsage icon, Color4 colour, Action action)
+        public void AddButton(LocalisableString firstLine, string secondLine, IconUsage icon, Color4 colour, Action action)
         {
             var button = new BeatmapOptionsButton
             {
diff --git a/osu.Game/Users/UserStatus.cs b/osu.Game/Users/UserStatus.cs
index 21c18413f4..7f275b3b2a 100644
--- a/osu.Game/Users/UserStatus.cs
+++ b/osu.Game/Users/UserStatus.cs
@@ -1,20 +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.Localisation;
 using osuTK.Graphics;
 using osu.Game.Graphics;
+using osu.Game.Resources.Localisation.Web;
 
 namespace osu.Game.Users
 {
     public abstract class UserStatus
     {
-        public abstract string Message { get; }
+        public abstract LocalisableString Message { get; }
         public abstract Color4 GetAppropriateColour(OsuColour colours);
     }
 
     public class UserStatusOnline : UserStatus
     {
-        public override string Message => @"Online";
+        public override LocalisableString Message => UsersStrings.StatusOnline;
         public override Color4 GetAppropriateColour(OsuColour colours) => colours.GreenLight;
     }
 
@@ -25,13 +27,13 @@ namespace osu.Game.Users
 
     public class UserStatusOffline : UserStatus
     {
-        public override string Message => @"Offline";
+        public override LocalisableString Message => UsersStrings.StatusOffline;
         public override Color4 GetAppropriateColour(OsuColour colours) => Color4.Black;
     }
 
     public class UserStatusDoNotDisturb : UserStatus
     {
-        public override string Message => @"Do not disturb";
+        public override LocalisableString Message => "Do not disturb";
         public override Color4 GetAppropriateColour(OsuColour colours) => colours.RedDark;
     }
 }

From 0146949ad60c45e788230e6336bfb29aaaa3491e Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Wed, 20 Apr 2022 16:52:24 -0700
Subject: [PATCH 4200/5547] Fix failing string comparison tests

---
 osu.Game.Tests/Visual/SongSelect/TestSceneAdvancedStats.cs | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneAdvancedStats.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneAdvancedStats.cs
index 7ceae0a69b..8af70df48a 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneAdvancedStats.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneAdvancedStats.cs
@@ -10,6 +10,7 @@ using osu.Framework.Graphics.Sprites;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
 using osu.Game.Graphics;
+using osu.Game.Resources.Localisation.Web;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Osu.Mods;
@@ -55,7 +56,7 @@ namespace osu.Game.Tests.Visual.SongSelect
 
             AddStep("no mods selected", () => SelectedMods.Value = Array.Empty<Mod>());
 
-            AddAssert("first bar text is Circle Size", () => advancedStats.ChildrenOfType<SpriteText>().First().Text == "Circle Size");
+            AddAssert("first bar text is correct", () => advancedStats.ChildrenOfType<SpriteText>().First().Text == BeatmapsetsStrings.ShowStatsCs);
             AddAssert("circle size bar is white", () => barIsWhite(advancedStats.FirstValue));
             AddAssert("HP drain bar is white", () => barIsWhite(advancedStats.HpDrain));
             AddAssert("accuracy bar is white", () => barIsWhite(advancedStats.Accuracy));
@@ -78,7 +79,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                 StarRating = 8
             });
 
-            AddAssert("first bar text is Key Count", () => advancedStats.ChildrenOfType<SpriteText>().First().Text == "Key Count");
+            AddAssert("first bar text is correct", () => advancedStats.ChildrenOfType<SpriteText>().First().Text == BeatmapsetsStrings.ShowStatsCsMania);
         }
 
         [Test]

From 56d8de23e2b649f305c87111fd31dd3a0abbaec1 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 21 Apr 2022 12:18:54 +0900
Subject: [PATCH 4201/5547] Replace horse with "more suitable" icon
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/FirstRunSetupOverlay.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/FirstRunSetupOverlay.cs b/osu.Game/Overlays/FirstRunSetupOverlay.cs
index d5aa1178e0..f73d82b793 100644
--- a/osu.Game/Overlays/FirstRunSetupOverlay.cs
+++ b/osu.Game/Overlays/FirstRunSetupOverlay.cs
@@ -303,7 +303,7 @@ namespace osu.Game.Overlays
                 notificationOverlay.Post(new SimpleNotification
                 {
                     Text = FirstRunSetupOverlayStrings.ClickToResumeFirstRunSetupAtAnyPoint,
-                    Icon = FontAwesome.Solid.Horse,
+                    Icon = FontAwesome.Solid.Redo,
                     Activated = () =>
                     {
                         Show();

From a9163727db6195bee3a4212ad6d4c3cf8b1d0804 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 21 Apr 2022 13:44:14 +0900
Subject: [PATCH 4202/5547] Mark selected channel null in test when selector is
 activated

---
 osu.Game.Tests/Visual/Online/TestSceneChannelList.cs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneChannelList.cs b/osu.Game.Tests/Visual/Online/TestSceneChannelList.cs
index d6a1e71f0d..a3bfbd47a3 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneChannelList.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneChannelList.cs
@@ -104,6 +104,7 @@ namespace osu.Game.Tests.Visual.Online
                 channelList.SelectorActive.BindValueChanged(change =>
                 {
                     selectorText.Text = $"Channel Selector Active: {change.NewValue}";
+                    selected.Value = null;
                 }, true);
 
                 selected.BindValueChanged(change =>

From 9f525ee26743ce70b1f200979c1664841fef0896 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 21 Apr 2022 14:09:51 +0900
Subject: [PATCH 4203/5547] Revert localisation of spectate/watch button

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

diff --git a/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs b/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs
index e036f1d304..9807a65250 100644
--- a/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs
+++ b/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs
@@ -139,7 +139,7 @@ namespace osu.Game.Overlays.Dashboard
                             new PurpleTriangleButton
                             {
                                 RelativeSizeAxes = Axes.X,
-                                Text = CommonStrings.ButtonsWatchTo1,
+                                Text = "Spectate",
                                 Anchor = Anchor.TopCentre,
                                 Origin = Anchor.TopCentre,
                                 Action = () => performer?.PerformFromScreen(s => s.Push(new SoloSpectator(User))),

From 848366416e7595b1dce036fa186e0f1369b66c5c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 21 Apr 2022 14:10:58 +0900
Subject: [PATCH 4204/5547] Revert string type changes in `MetadataLineInfo`

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

diff --git a/osu.Game/Screens/Play/BeatmapMetadataDisplay.cs b/osu.Game/Screens/Play/BeatmapMetadataDisplay.cs
index 4a0bab84fa..e8021d4065 100644
--- a/osu.Game/Screens/Play/BeatmapMetadataDisplay.cs
+++ b/osu.Game/Screens/Play/BeatmapMetadataDisplay.cs
@@ -226,10 +226,10 @@ namespace osu.Game.Screens.Play
 
         private class MetadataLineInfo : OsuSpriteText
         {
-            public MetadataLineInfo(LocalisableString text)
+            public MetadataLineInfo(string text)
             {
                 Margin = new MarginPadding { Left = 5 };
-                Text = string.IsNullOrEmpty(text.ToString()) ? @"-" : text;
+                Text = string.IsNullOrEmpty(text) ? @"-" : text;
             }
         }
     }

From e54d3702a6fa6ec1b72432c4bde79428aa7927b3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 21 Apr 2022 15:16:39 +0900
Subject: [PATCH 4205/5547] Specify web proxy in SignalR connection building

Might solve https://github.com/ppy/osu/discussions/17897 (depends on how
adeptly signalr falls back to long polling if/when is fails to websocket
via the proxy, or maybe succeed).

As with the framework side change, I've tested this to not break a
zero-proxy flow. Intending to have the user test this after next
release.

Reference:
https://stackoverflow.com/questions/59343807/get-system-default-web-proxy-in-net-core
/
https://stackoverflow.com/questions/13515058/using-signalr-client-through-a-web-proxy
---
 osu.Game/Online/HubClientConnector.cs | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/osu.Game/Online/HubClientConnector.cs b/osu.Game/Online/HubClientConnector.cs
index c79660568c..ca9bf00b23 100644
--- a/osu.Game/Online/HubClientConnector.cs
+++ b/osu.Game/Online/HubClientConnector.cs
@@ -5,6 +5,7 @@
 
 using System;
 using System.Collections.Generic;
+using System.Net;
 using System.Threading;
 using System.Threading.Tasks;
 using Microsoft.AspNetCore.SignalR.Client;
@@ -144,6 +145,12 @@ namespace osu.Game.Online
             var builder = new HubConnectionBuilder()
                 .WithUrl(endpoint, options =>
                 {
+                    // Use HttpClient.DefaultProxy once on net6 everywhere.
+                    // The credential setter can also be removed at this point.
+                    options.Proxy = WebRequest.DefaultWebProxy;
+                    if (options.Proxy != null)
+                        options.Proxy.Credentials = CredentialCache.DefaultCredentials;
+
                     options.Headers.Add("Authorization", $"Bearer {api.AccessToken}");
                     options.Headers.Add("OsuVersionHash", versionHash);
                 });

From b4c208be63db5babf41d3301de4f07f59379a7c9 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 21 Apr 2022 15:34:01 +0900
Subject: [PATCH 4206/5547] Move Code Quality check to top of checks list

---
 .github/workflows/ci.yml | 110 +++++++++++++++++++--------------------
 1 file changed, 55 insertions(+), 55 deletions(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 5e7f9628fc..f2066f27de 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -2,6 +2,60 @@ on: [push, pull_request]
 name: Continuous Integration
 
 jobs:
+  inspect-code:
+    name: Code Quality
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v2
+
+      # FIXME: Tools won't run in .NET 6.0 unless you install 3.1.x LTS side by side.
+      # https://itnext.io/how-to-support-multiple-net-sdks-in-github-actions-workflows-b988daa884e
+      - name: Install .NET 3.1.x LTS
+        uses: actions/setup-dotnet@v1
+        with:
+          dotnet-version: "3.1.x"
+
+      - name: Install .NET 6.0.x
+        uses: actions/setup-dotnet@v1
+        with:
+          dotnet-version: "6.0.x"
+
+      - name: Restore Tools
+        run: dotnet tool restore
+
+      - name: Restore Packages
+        run: dotnet restore
+
+      - name: Restore inspectcode cache
+        uses: actions/cache@v3
+        with:
+          path: ${{ github.workspace }}/inspectcode
+          key: inspectcode-${{ hashFiles('.config/dotnet-tools.json') }}-${{ hashFiles('.github/workflows/ci.yml' ) }}
+
+      - name: CodeFileSanity
+        run: |
+          # TODO: Add ignore filters and GitHub Workflow Command Reporting in CFS. That way we don't have to do this workaround.
+          # FIXME: Suppress warnings from templates project
+          exit_code=0
+          while read -r line; do
+            if [[ ! -z "$line" ]]; then
+              echo "::error::$line"
+              exit_code=1
+            fi
+          done <<< $(dotnet codefilesanity)
+          exit $exit_code
+
+      # Temporarily disabled due to test failures, but it won't work anyway until the tool is upgraded.
+      # - name: .NET Format (Dry Run)
+      #   run: dotnet format --dry-run --check
+
+      - name: InspectCode
+        run: dotnet jb inspectcode $(pwd)/osu.Desktop.slnf --no-build --output="inspectcodereport.xml" --caches-home="inspectcode" --verbosity=WARN
+
+      - name: NVika
+        run: dotnet nvika parsereport "${{github.workspace}}/inspectcodereport.xml" --treatwarningsaserrors
+
   test:
     name: Test
     runs-on: ${{matrix.os.fullname}}
@@ -93,58 +147,4 @@ jobs:
       # cannot accept .sln(f) files as arguments.
       # Build just the main game for now.
       - name: Build
-        run: msbuild osu.iOS/osu.iOS.csproj /restore /p:Configuration=Debug
-
-  inspect-code:
-    name: Code Quality
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v2
-
-      # FIXME: Tools won't run in .NET 6.0 unless you install 3.1.x LTS side by side.
-      # https://itnext.io/how-to-support-multiple-net-sdks-in-github-actions-workflows-b988daa884e
-      - name: Install .NET 3.1.x LTS
-        uses: actions/setup-dotnet@v1
-        with:
-          dotnet-version: "3.1.x"
-
-      - name: Install .NET 6.0.x
-        uses: actions/setup-dotnet@v1
-        with:
-          dotnet-version: "6.0.x"
-
-      - name: Restore Tools
-        run: dotnet tool restore
-
-      - name: Restore Packages
-        run: dotnet restore
-
-      - name: Restore inspectcode cache
-        uses: actions/cache@v3
-        with:
-          path: ${{ github.workspace }}/inspectcode
-          key: inspectcode-${{ hashFiles('.config/dotnet-tools.json') }}-${{ hashFiles('.github/workflows/ci.yml' ) }}
-
-      - name: CodeFileSanity
-        run: |
-          # TODO: Add ignore filters and GitHub Workflow Command Reporting in CFS. That way we don't have to do this workaround.
-          # FIXME: Suppress warnings from templates project
-          exit_code=0
-          while read -r line; do
-            if [[ ! -z "$line" ]]; then
-              echo "::error::$line"
-              exit_code=1
-            fi
-          done <<< $(dotnet codefilesanity)
-          exit $exit_code
-
-      # Temporarily disabled due to test failures, but it won't work anyway until the tool is upgraded.
-      # - name: .NET Format (Dry Run)
-      #   run: dotnet format --dry-run --check
-
-      - name: InspectCode
-        run: dotnet jb inspectcode $(pwd)/osu.Desktop.slnf --no-build --output="inspectcodereport.xml" --caches-home="inspectcode" --verbosity=WARN
-
-      - name: NVika
-        run: dotnet nvika parsereport "${{github.workspace}}/inspectcodereport.xml" --treatwarningsaserrors
+        run: msbuild osu.iOS/osu.iOS.csproj /restore /p:Configuration=Debug
\ No newline at end of file

From 54ca4b9d36f55bd9e3636b1c88eea0ef553753e6 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 21 Apr 2022 15:34:14 +0900
Subject: [PATCH 4207/5547] Remove unused using

---
 osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs | 1 -
 1 file changed, 1 deletion(-)

diff --git a/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs b/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs
index 9807a65250..a9312e9a3a 100644
--- a/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs
+++ b/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs
@@ -14,7 +14,6 @@ using osu.Game.Database;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Spectator;
-using osu.Game.Resources.Localisation.Web;
 using osu.Game.Screens;
 using osu.Game.Screens.OnlinePlay.Match.Components;
 using osu.Game.Screens.Play;

From 414408140e0e66e394dafc1738c2a2c574496f87 Mon Sep 17 00:00:00 2001
From: Andrei Zavatski <megaman9919@gmail.com>
Date: Thu, 21 Apr 2022 10:16:52 +0300
Subject: [PATCH 4208/5547] Improve AnchorOriginVisualiser

---
 osu.Game/Skinning/Editor/SkinBlueprint.cs | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Skinning/Editor/SkinBlueprint.cs b/osu.Game/Skinning/Editor/SkinBlueprint.cs
index 0a4bd1d75f..1860c6006c 100644
--- a/osu.Game/Skinning/Editor/SkinBlueprint.cs
+++ b/osu.Game/Skinning/Editor/SkinBlueprint.cs
@@ -146,8 +146,10 @@ namespace osu.Game.Skinning.Editor
             {
                 anchorLine = new Box
                 {
-                    Colour = Color4.Yellow,
                     Height = 2,
+                    Origin = Anchor.CentreLeft,
+                    Colour = Color4.Yellow,
+                    EdgeSmoothness = Vector2.One
                 },
                 originBox = new Box
                 {

From 2769d8e8cfdbded19d1ba4407053efb8c162ae43 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 21 Apr 2022 16:24:21 +0900
Subject: [PATCH 4209/5547] Add test coverage of `ShearedOverlayContainer`

---
 .../TestSceneShearedOverlayContainer.cs       | 102 ++++++++++++++++++
 1 file changed, 102 insertions(+)
 create mode 100644 osu.Game.Tests/Visual/UserInterface/TestSceneShearedOverlayContainer.cs

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneShearedOverlayContainer.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneShearedOverlayContainer.cs
new file mode 100644
index 0000000000..5a9cafde27
--- /dev/null
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneShearedOverlayContainer.cs
@@ -0,0 +1,102 @@
+// 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;
+using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.Shapes;
+using osu.Framework.Testing;
+using osu.Game.Graphics;
+using osu.Game.Graphics.Sprites;
+using osu.Game.Graphics.UserInterface;
+using osu.Game.Overlays;
+using osu.Game.Overlays.Mods;
+using osuTK;
+using osuTK.Graphics;
+using osuTK.Input;
+
+namespace osu.Game.Tests.Visual.UserInterface
+{
+    [TestFixture]
+    public class TestSceneShearedOverlayContainer : OsuManualInputManagerTestScene
+    {
+        private TestShearedOverlayContainer overlay;
+
+        [SetUpSteps]
+        public void SetUpSteps()
+        {
+            AddStep("create overlay", () =>
+            {
+                Child = overlay = new TestShearedOverlayContainer
+                {
+                    State = { Value = Visibility.Visible }
+                };
+            });
+        }
+
+        [Test]
+        public void TestClickAwayToExit()
+        {
+            AddStep("click inside header", () =>
+            {
+                InputManager.MoveMouseTo(overlay.ChildrenOfType<ShearedOverlayHeader>().First().ScreenSpaceDrawQuad.Centre);
+                InputManager.Click(MouseButton.Left);
+            });
+
+            AddAssert("overlay not dismissed", () => overlay.State.Value == Visibility.Visible);
+
+            AddStep("click inside content", () =>
+            {
+                InputManager.MoveMouseTo(overlay.ScreenSpaceDrawQuad.Centre);
+                InputManager.Click(MouseButton.Left);
+            });
+
+            AddAssert("overlay not dismissed", () => overlay.State.Value == Visibility.Visible);
+
+            AddStep("click outside header", () =>
+            {
+                InputManager.MoveMouseTo(new Vector2(overlay.ScreenSpaceDrawQuad.TopLeft.X, overlay.ScreenSpaceDrawQuad.Centre.Y));
+                InputManager.Click(MouseButton.Left);
+            });
+
+            AddAssert("overlay dismissed", () => overlay.State.Value == Visibility.Hidden);
+        }
+
+        public class TestShearedOverlayContainer : ShearedOverlayContainer
+        {
+            protected override OverlayColourScheme ColourScheme => OverlayColourScheme.Green;
+
+            [BackgroundDependencyLoader]
+            private void load()
+            {
+                Header.Title = "Sheared overlay header";
+                Header.Description = string.Join(" ", Enumerable.Repeat("This is a description.", 20));
+
+                MainAreaContent.Child = new InputBlockingContainer
+                {
+                    RelativeSizeAxes = Axes.Both,
+                    Anchor = Anchor.Centre,
+                    Origin = Anchor.Centre,
+                    Size = new Vector2(0.9f),
+                    Children = new Drawable[]
+                    {
+                        new Box
+                        {
+                            Colour = Color4.Blue,
+                            RelativeSizeAxes = Axes.Both,
+                        },
+                        new OsuSpriteText
+                        {
+                            Font = OsuFont.Default.With(size: 24),
+                            Text = "Content",
+                            Anchor = Anchor.Centre,
+                            Origin = Anchor.Centre,
+                        }
+                    }
+                };
+            }
+        }
+    }
+}

From 0f4b40ab15b2727d5cf66c2f0a3bf606403e9c51 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 21 Apr 2022 16:15:10 +0900
Subject: [PATCH 4210/5547] Add better click-to-dismiss logic for sheared
 overlays

---
 osu.Game/Graphics/InputBlockingContainer.cs   | 21 +++++++++++++++++++
 .../UserInterface/ShearedOverlayHeader.cs     |  2 +-
 .../Overlays/Mods/ShearedOverlayContainer.cs  | 15 ++++++++++++-
 3 files changed, 36 insertions(+), 2 deletions(-)
 create mode 100644 osu.Game/Graphics/InputBlockingContainer.cs

diff --git a/osu.Game/Graphics/InputBlockingContainer.cs b/osu.Game/Graphics/InputBlockingContainer.cs
new file mode 100644
index 0000000000..d8387b1401
--- /dev/null
+++ b/osu.Game/Graphics/InputBlockingContainer.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.
+
+#nullable enable
+using osu.Framework.Graphics.Containers;
+using osu.Framework.Input.Events;
+
+namespace osu.Game.Graphics
+{
+    /// <summary>
+    /// A simple container which blocks input events from travelling through it.
+    /// </summary>
+    public class InputBlockingContainer : Container
+    {
+        protected override bool OnHover(HoverEvent e) => true;
+
+        protected override bool OnMouseDown(MouseDownEvent e) => true;
+
+        protected override bool OnClick(ClickEvent e) => true;
+    }
+}
diff --git a/osu.Game/Graphics/UserInterface/ShearedOverlayHeader.cs b/osu.Game/Graphics/UserInterface/ShearedOverlayHeader.cs
index 9ed7bb35de..452a1dd394 100644
--- a/osu.Game/Graphics/UserInterface/ShearedOverlayHeader.cs
+++ b/osu.Game/Graphics/UserInterface/ShearedOverlayHeader.cs
@@ -66,7 +66,7 @@ namespace osu.Game.Graphics.UserInterface
                 },
                 Children = new Drawable[]
                 {
-                    underlayContainer = new Container
+                    underlayContainer = new InputBlockingContainer
                     {
                         RelativeSizeAxes = Axes.X,
                         Height = HEIGHT,
diff --git a/osu.Game/Overlays/Mods/ShearedOverlayContainer.cs b/osu.Game/Overlays/Mods/ShearedOverlayContainer.cs
index 62ed736dc2..eca192c8e5 100644
--- a/osu.Game/Overlays/Mods/ShearedOverlayContainer.cs
+++ b/osu.Game/Overlays/Mods/ShearedOverlayContainer.cs
@@ -5,6 +5,8 @@ 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.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.UserInterface;
 
@@ -88,7 +90,7 @@ namespace osu.Game.Overlays.Mods
                             Bottom = footer_height + PADDING,
                         }
                     },
-                    Footer = new Container
+                    Footer = new InputBlockingContainer
                     {
                         RelativeSizeAxes = Axes.X,
                         Depth = float.MinValue,
@@ -113,6 +115,17 @@ namespace osu.Game.Overlays.Mods
             };
         }
 
+        protected override bool OnClick(ClickEvent e)
+        {
+            if (State.Value == Visibility.Visible)
+            {
+                Hide();
+                return true;
+            }
+
+            return base.OnClick(e);
+        }
+
         protected override void PopIn()
         {
             const double fade_in_duration = 400;

From 0b81ae9de2af8883ceb5931ed964e9949672b85c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 20 Apr 2022 16:51:26 +0900
Subject: [PATCH 4211/5547] Convert to using sheared overlay container

Add better click-to-dismiss logic for sheader overlays
---
 .../TestSceneFirstRunSetupOverlay.cs          |   2 +-
 osu.Game/Overlays/FirstRunSetupOverlay.cs     | 221 ++++++------------
 2 files changed, 75 insertions(+), 148 deletions(-)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunSetupOverlay.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunSetupOverlay.cs
index efce4f350b..e925859d71 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunSetupOverlay.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunSetupOverlay.cs
@@ -165,7 +165,7 @@ namespace osu.Game.Tests.Visual.UserInterface
 
             AddStep("click outside content", () =>
             {
-                InputManager.MoveMouseTo(overlay.ScreenSpaceDrawQuad.TopLeft - new Vector2(1));
+                InputManager.MoveMouseTo(new Vector2(overlay.ScreenSpaceDrawQuad.TopLeft.X, overlay.ScreenSpaceDrawQuad.Centre.Y));
                 InputManager.Click(MouseButton.Left);
             });
 
diff --git a/osu.Game/Overlays/FirstRunSetupOverlay.cs b/osu.Game/Overlays/FirstRunSetupOverlay.cs
index f73d82b793..d0e721cf46 100644
--- a/osu.Game/Overlays/FirstRunSetupOverlay.cs
+++ b/osu.Game/Overlays/FirstRunSetupOverlay.cs
@@ -7,10 +7,8 @@ using System;
 using System.Diagnostics;
 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.Effects;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Input.Events;
@@ -18,25 +16,22 @@ using osu.Framework.Localisation;
 using osu.Framework.Screens;
 using osu.Game.Configuration;
 using osu.Game.Graphics;
-using osu.Game.Graphics.Containers;
-using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Input.Bindings;
 using osu.Game.Localisation;
 using osu.Game.Overlays.FirstRunSetup;
+using osu.Game.Overlays.Mods;
 using osu.Game.Overlays.Notifications;
 using osu.Game.Screens;
 using osu.Game.Screens.Menu;
 using osu.Game.Screens.OnlinePlay.Match.Components;
-using osuTK;
-using osuTK.Graphics;
 
 namespace osu.Game.Overlays
 {
     [Cached]
-    public class FirstRunSetupOverlay : OsuFocusedOverlayContainer
+    public class FirstRunSetupOverlay : ShearedOverlayContainer
     {
-        protected override bool StartHidden => true;
+        protected override OverlayColourScheme ColourScheme => OverlayColourScheme.Purple;
 
         [Resolved]
         private IPerformFromScreenRunner performer { get; set; } = null!;
@@ -52,15 +47,10 @@ namespace osu.Game.Overlays
         public PurpleTriangleButton NextButton = null!;
         public DangerousTriangleButton BackButton = null!;
 
-        [Cached]
-        private OverlayColourProvider colourProvider = new OverlayColourProvider(OverlayColourScheme.Purple);
-
         private readonly Bindable<bool> showFirstRunSetup = new Bindable<bool>();
 
         private int? currentStepIndex;
 
-        private const float scale_when_hidden = 0.9f;
-
         /// <summary>
         /// The currently displayed screen, if any.
         /// </summary>
@@ -76,149 +66,89 @@ namespace osu.Game.Overlays
 
         private Bindable<OverlayActivation>? overlayActivationMode;
 
-        public FirstRunSetupOverlay()
-        {
-            RelativeSizeAxes = Axes.Both;
-        }
+        private Container content = null!;
 
         [BackgroundDependencyLoader]
         private void load()
         {
-            Anchor = Anchor.Centre;
-            Origin = Anchor.Centre;
+            Header.Title = FirstRunSetupOverlayStrings.FirstRunSetup;
+            Header.Description = FirstRunSetupOverlayStrings.SetupOsuToSuitYou;
 
-            RelativeSizeAxes = Axes.Both;
-            Size = new Vector2(0.95f);
-
-            EdgeEffect = new EdgeEffectParameters
+            MainAreaContent.AddRange(new Drawable[]
             {
-                Type = EdgeEffectType.Shadow,
-                Radius = 5,
-                Colour = Color4.Black.Opacity(0.2f),
-            };
-
-            Masking = true;
-            CornerRadius = 10;
-
-            Children = new Drawable[]
-            {
-                new Box
+                content = new Container
                 {
+                    Anchor = Anchor.Centre,
+                    Origin = Anchor.Centre,
                     RelativeSizeAxes = Axes.Both,
-                    Colour = colourProvider.Background6,
-                },
-                new GridContainer
-                {
-                    RelativeSizeAxes = Axes.Both,
-                    RowDimensions = new[]
+                    Padding = new MarginPadding { Horizontal = 50 },
+                    Child = new InputBlockingContainer
                     {
-                        new Dimension(GridSizeMode.AutoSize),
-                        new Dimension(),
-                        new Dimension(GridSizeMode.AutoSize),
-                    },
-                    Content = new[]
-                    {
-                        new Drawable[]
+                        Masking = true,
+                        CornerRadius = 14,
+                        RelativeSizeAxes = Axes.Both,
+                        Children = new Drawable[]
                         {
-                            new Container
-                            {
-                                RelativeSizeAxes = Axes.X,
-                                AutoSizeAxes = Axes.Y,
-                                Children = new Drawable[]
-                                {
-                                    new Box
-                                    {
-                                        Colour = colourProvider.Background5,
-                                        RelativeSizeAxes = Axes.Both,
-                                    },
-                                    new FillFlowContainer
-                                    {
-                                        RelativeSizeAxes = Axes.X,
-                                        Margin = new MarginPadding(10),
-                                        AutoSizeAxes = Axes.Y,
-                                        Direction = FillDirection.Vertical,
-                                        Children = new Drawable[]
-                                        {
-                                            new OsuSpriteText
-                                            {
-                                                Text = FirstRunSetupOverlayStrings.FirstRunSetup,
-                                                Font = OsuFont.Default.With(size: 32),
-                                                Colour = colourProvider.Content1,
-                                                Anchor = Anchor.TopCentre,
-                                                Origin = Anchor.TopCentre,
-                                            },
-                                            new OsuTextFlowContainer
-                                            {
-                                                Text = FirstRunSetupOverlayStrings.SetupOsuToSuitYou,
-                                                Colour = colourProvider.Content2,
-                                                Anchor = Anchor.TopCentre,
-                                                Origin = Anchor.TopCentre,
-                                                AutoSizeAxes = Axes.Both,
-                                            },
-                                        }
-                                    },
-                                }
-                            },
-                        },
-                        new Drawable[]
-                        {
-                            stackContainer = new Container
+                            new Box
                             {
                                 RelativeSizeAxes = Axes.Both,
-                                Padding = new MarginPadding(20),
+                                Colour = ColourProvider.Background6,
                             },
-                        },
-                        new Drawable[]
-                        {
-                            new Container
+                            stackContainer = new Container
                             {
-                                RelativeSizeAxes = Axes.X,
-                                AutoSizeAxes = Axes.Y,
-                                Padding = new MarginPadding(20)
+                                Anchor = Anchor.Centre,
+                                Origin = Anchor.Centre,
+                                RelativeSizeAxes = Axes.Both,
+                                Padding = new MarginPadding
                                 {
-                                    Top = 0 // provided by the stack container above.
-                                },
-                                Child = new GridContainer
-                                {
-                                    RelativeSizeAxes = Axes.X,
-                                    AutoSizeAxes = Axes.Y,
-                                    ColumnDimensions = new[]
-                                    {
-                                        new Dimension(GridSizeMode.AutoSize),
-                                        new Dimension(GridSizeMode.Absolute, 10),
-                                        new Dimension(),
-                                    },
-                                    RowDimensions = new[]
-                                    {
-                                        new Dimension(GridSizeMode.AutoSize),
-                                    },
-                                    Content = new[]
-                                    {
-                                        new[]
-                                        {
-                                            BackButton = new DangerousTriangleButton
-                                            {
-                                                Width = 200,
-                                                Text = CommonStrings.Back,
-                                                Action = showPreviousStep,
-                                                Enabled = { Value = false },
-                                            },
-                                            Empty(),
-                                            NextButton = new PurpleTriangleButton
-                                            {
-                                                RelativeSizeAxes = Axes.X,
-                                                Width = 1,
-                                                Text = FirstRunSetupOverlayStrings.GetStarted,
-                                                Action = showNextStep
-                                            }
-                                        },
-                                    }
+                                    Vertical = 20,
+                                    Horizontal = 20,
                                 },
                             }
-                        }
-                    }
+                        },
+                    },
                 },
-            };
+            });
+
+            FooterContent.Add(new GridContainer
+            {
+                RelativeSizeAxes = Axes.X,
+                AutoSizeAxes = Axes.Y,
+                Width = 0.98f,
+                Anchor = Anchor.Centre,
+                Origin = Anchor.Centre,
+                ColumnDimensions = new[]
+                {
+                    new Dimension(GridSizeMode.AutoSize),
+                    new Dimension(GridSizeMode.Absolute, 10),
+                    new Dimension(),
+                },
+                RowDimensions = new[]
+                {
+                    new Dimension(GridSizeMode.AutoSize),
+                },
+                Content = new[]
+                {
+                    new[]
+                    {
+                        BackButton = new DangerousTriangleButton
+                        {
+                            Width = 200,
+                            Text = CommonStrings.Back,
+                            Action = showPreviousStep,
+                            Enabled = { Value = false },
+                        },
+                        Empty(),
+                        NextButton = new PurpleTriangleButton
+                        {
+                            RelativeSizeAxes = Axes.X,
+                            Width = 1,
+                            Text = FirstRunSetupOverlayStrings.GetStarted,
+                            Action = showNextStep
+                        }
+                    },
+                }
+            });
         }
 
         protected override void LoadComplete()
@@ -280,10 +210,8 @@ namespace osu.Game.Overlays
         {
             base.PopIn();
 
-            this.ScaleTo(scale_when_hidden)
-                .ScaleTo(1, 400, Easing.OutElasticHalf);
-
-            this.FadeIn(400, Easing.OutQuint);
+            content.ScaleTo(0.99f)
+                   .ScaleTo(1, 400, Easing.OutQuint);
 
             if (currentStepIndex == null)
                 showFirstStep();
@@ -291,6 +219,10 @@ namespace osu.Game.Overlays
 
         protected override void PopOut()
         {
+            base.PopOut();
+
+            content.ScaleTo(0.99f, 400, Easing.OutQuint);
+
             if (overlayActivationMode != null)
             {
                 // If this is non-null we are guaranteed to have come from the main menu.
@@ -316,11 +248,6 @@ namespace osu.Game.Overlays
                 stack?.FadeOut(100)
                      .Expire();
             }
-
-            base.PopOut();
-
-            this.ScaleTo(0.96f, 400, Easing.OutQuint);
-            this.FadeOut(200, Easing.OutQuint);
         }
 
         private void showFirstStep()

From f5d24add58766dfdf8822271907a32349a9df27f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 21 Apr 2022 16:49:21 +0900
Subject: [PATCH 4212/5547] Fix `TestSceneSkinnableSound` not working under
 visual tests

oops
---
 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 ccf13e1e8f..64afe1235b 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableSound.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableSound.cs
@@ -25,7 +25,7 @@ namespace osu.Game.Tests.Visual.Gameplay
         private TestSkinSourceContainer skinSource;
         private PausableSkinnableSound skinnableSound;
 
-        [SetUp]
+        [SetUpSteps]
         public void SetUpSteps()
         {
             AddStep("setup hierarchy", () =>

From 5ae3d0eb274785ac3bb55cf26e8860ca7e35456e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 21 Apr 2022 19:36:19 +0900
Subject: [PATCH 4213/5547] Fix wording of ui scale screen description

Co-authored-by: Walavouchey <36758269+Walavouchey@users.noreply.github.com>
---
 osu.Game/Localisation/FirstRunSetupOverlayStrings.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Localisation/FirstRunSetupOverlayStrings.cs b/osu.Game/Localisation/FirstRunSetupOverlayStrings.cs
index ec2e97d82a..b55102db20 100644
--- a/osu.Game/Localisation/FirstRunSetupOverlayStrings.cs
+++ b/osu.Game/Localisation/FirstRunSetupOverlayStrings.cs
@@ -44,9 +44,9 @@ namespace osu.Game.Localisation
 osu! is a very configurable game, and diving straight into the settings can sometimes be overwhelming. This guide will help you get the important choices out of the way to ensure a great first experience!");
 
         /// <summary>
-        /// "The size of the osu! user interface size can be adjusted to your liking."
+        /// "The size of the osu! user interface can be adjusted to your liking."
         /// </summary>
-        public static LocalisableString UIScaleDescription => new TranslatableString(getKey(@"ui_scale_description"), @"The size of the osu! user interface size can be adjusted to your liking.");
+        public static LocalisableString UIScaleDescription => new TranslatableString(getKey(@"ui_scale_description"), @"The size of the osu! user interface can be adjusted to your liking.");
 
         /// <summary>
         /// "Next ({0})"

From 1f967ecba3f4b30821640091d94ee55d238e44cf Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 21 Apr 2022 19:52:28 +0900
Subject: [PATCH 4214/5547] Update string keys and change "setup" to "set up"
 to fix grammar

---
 osu.Game/Localisation/FirstRunSetupOverlayStrings.cs | 6 +++---
 osu.Game/Overlays/FirstRunSetupOverlay.cs            | 4 ++--
 2 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Localisation/FirstRunSetupOverlayStrings.cs b/osu.Game/Localisation/FirstRunSetupOverlayStrings.cs
index b55102db20..d2fb0e7467 100644
--- a/osu.Game/Localisation/FirstRunSetupOverlayStrings.cs
+++ b/osu.Game/Localisation/FirstRunSetupOverlayStrings.cs
@@ -22,12 +22,12 @@ namespace osu.Game.Localisation
         /// <summary>
         /// "First-run setup"
         /// </summary>
-        public static LocalisableString FirstRunSetup => new TranslatableString(getKey(@"first_run_setup"), @"First-run setup");
+        public static LocalisableString FirstRunSetupTitle => new TranslatableString(getKey(@"first_run_setup_title"), @"First-run setup");
 
         /// <summary>
-        /// "Setup osu! to suit you"
+        /// "Set up osu! to suit you"
         /// </summary>
-        public static LocalisableString SetupOsuToSuitYou => new TranslatableString(getKey(@"setup_osu_to_suit_you"), @"Setup osu! to suit you");
+        public static LocalisableString FirstRunSetupDescription => new TranslatableString(getKey(@"first_run_setup_description"), @"Set up osu! to suit you");
 
         /// <summary>
         /// "Welcome"
diff --git a/osu.Game/Overlays/FirstRunSetupOverlay.cs b/osu.Game/Overlays/FirstRunSetupOverlay.cs
index f73d82b793..dd36475a23 100644
--- a/osu.Game/Overlays/FirstRunSetupOverlay.cs
+++ b/osu.Game/Overlays/FirstRunSetupOverlay.cs
@@ -141,7 +141,7 @@ namespace osu.Game.Overlays
                                         {
                                             new OsuSpriteText
                                             {
-                                                Text = FirstRunSetupOverlayStrings.FirstRunSetup,
+                                                Text = FirstRunSetupOverlayStrings.FirstRunSetupTitle,
                                                 Font = OsuFont.Default.With(size: 32),
                                                 Colour = colourProvider.Content1,
                                                 Anchor = Anchor.TopCentre,
@@ -149,7 +149,7 @@ namespace osu.Game.Overlays
                                             },
                                             new OsuTextFlowContainer
                                             {
-                                                Text = FirstRunSetupOverlayStrings.SetupOsuToSuitYou,
+                                                Text = FirstRunSetupOverlayStrings.FirstRunSetupDescription,
                                                 Colour = colourProvider.Content2,
                                                 Anchor = Anchor.TopCentre,
                                                 Origin = Anchor.TopCentre,

From ed6481f7084277a063d26c63515d6631f560d9d6 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 21 Apr 2022 19:55:15 +0900
Subject: [PATCH 4215/5547] Also rename `Welcome` to `WelcomeTitle` to match
 other usages

---
 osu.Game/Localisation/FirstRunSetupOverlayStrings.cs | 2 +-
 osu.Game/Overlays/FirstRunSetupOverlay.cs            | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Localisation/FirstRunSetupOverlayStrings.cs b/osu.Game/Localisation/FirstRunSetupOverlayStrings.cs
index d2fb0e7467..001de93c16 100644
--- a/osu.Game/Localisation/FirstRunSetupOverlayStrings.cs
+++ b/osu.Game/Localisation/FirstRunSetupOverlayStrings.cs
@@ -32,7 +32,7 @@ namespace osu.Game.Localisation
         /// <summary>
         /// "Welcome"
         /// </summary>
-        public static LocalisableString Welcome => new TranslatableString(getKey(@"welcome"), @"Welcome");
+        public static LocalisableString WelcomeTitle => new TranslatableString(getKey(@"welcome_title"), @"Welcome");
 
         /// <summary>
         /// "Welcome to the first-run setup guide!
diff --git a/osu.Game/Overlays/FirstRunSetupOverlay.cs b/osu.Game/Overlays/FirstRunSetupOverlay.cs
index dd36475a23..a12fec4507 100644
--- a/osu.Game/Overlays/FirstRunSetupOverlay.cs
+++ b/osu.Game/Overlays/FirstRunSetupOverlay.cs
@@ -68,7 +68,7 @@ namespace osu.Game.Overlays
 
         private readonly FirstRunStep[] steps =
         {
-            new FirstRunStep(typeof(ScreenWelcome), FirstRunSetupOverlayStrings.Welcome),
+            new FirstRunStep(typeof(ScreenWelcome), FirstRunSetupOverlayStrings.WelcomeTitle),
             new FirstRunStep(typeof(ScreenUIScale), GraphicsSettingsStrings.UIScaling),
         };
 

From 8c3b541312ebcfe59cea912c755de5dcfb37ee1c Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 21 Apr 2022 22:35:07 +0900
Subject: [PATCH 4216/5547] Add state for when user is ready for gameplay

---
 .../Online/Multiplayer/MultiplayerRoomUser.cs    | 16 ++++++++++++++++
 .../Online/Multiplayer/MultiplayerUserState.cs   |  8 +++++++-
 .../Multiplayer/Participants/StateDisplay.cs     |  1 +
 3 files changed, 24 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Online/Multiplayer/MultiplayerRoomUser.cs b/osu.Game/Online/Multiplayer/MultiplayerRoomUser.cs
index f0b7dcbff8..50e539e8a6 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerRoomUser.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerRoomUser.cs
@@ -65,5 +65,21 @@ namespace osu.Game.Online.Multiplayer
         }
 
         public override int GetHashCode() => UserID.GetHashCode();
+
+        /// <summary>
+        /// Whether this user has finished loading and can start gameplay.
+        /// </summary>
+        public bool CanStartGameplay()
+        {
+            switch (State)
+            {
+                case MultiplayerUserState.Loaded:
+                case MultiplayerUserState.ReadyForGameplay:
+                    return true;
+
+                default:
+                    return false;
+            }
+        }
     }
 }
diff --git a/osu.Game/Online/Multiplayer/MultiplayerUserState.cs b/osu.Game/Online/Multiplayer/MultiplayerUserState.cs
index c467ff84bb..d1369a7970 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerUserState.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerUserState.cs
@@ -29,10 +29,16 @@ namespace osu.Game.Online.Multiplayer
         WaitingForLoad,
 
         /// <summary>
-        /// The user's client has marked itself as loaded and ready to begin gameplay.
+        /// The user has marked itself as loaded, but may still be adjusting settings prior to being ready for gameplay.
+        /// Players remaining in this state for an extended period of time will be automatically transitioned to the <see cref="Playing"/> state by the server.
         /// </summary>
         Loaded,
 
+        /// <summary>
+        /// The user has finished adjusting settings and is ready to start gameplay.
+        /// </summary>
+        ReadyForGameplay,
+
         /// <summary>
         /// The user is currently playing in a game. This is a reserved state, and is set by the server.
         /// </summary>
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/StateDisplay.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/StateDisplay.cs
index 2616b07c1f..658fc43e8d 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/StateDisplay.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/StateDisplay.cs
@@ -112,6 +112,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Participants
                     break;
 
                 case MultiplayerUserState.Loaded:
+                case MultiplayerUserState.ReadyForGameplay:
                     text.Text = "loaded";
                     icon.Icon = FontAwesome.Solid.DotCircle;
                     icon.Colour = colours.YellowLight;

From 08d250fe587e854affd32332f6d10dfd51bc5e61 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 21 Apr 2022 22:37:26 +0900
Subject: [PATCH 4217/5547] Rename MatchStarted() -> GameplayStarted()

---
 .../Visual/Multiplayer/TestSceneMultiplayerPlayer.cs        | 2 +-
 osu.Game/Online/Multiplayer/IMultiplayerClient.cs           | 5 +++--
 osu.Game/Online/Multiplayer/MultiplayerClient.cs            | 6 +++---
 osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs      | 2 +-
 .../Screens/OnlinePlay/Multiplayer/MultiplayerPlayer.cs     | 6 +++---
 osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs  | 2 +-
 6 files changed, 12 insertions(+), 11 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlayer.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlayer.cs
index 312281ac18..e05580fed6 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlayer.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlayer.cs
@@ -35,7 +35,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             });
 
             AddUntilStep("wait for player to be current", () => player.IsCurrentScreen() && player.IsLoaded);
-            AddStep("start gameplay", () => ((IMultiplayerClient)MultiplayerClient).MatchStarted());
+            AddStep("start gameplay", () => ((IMultiplayerClient)MultiplayerClient).GameplayStarted());
         }
 
         [Test]
diff --git a/osu.Game/Online/Multiplayer/IMultiplayerClient.cs b/osu.Game/Online/Multiplayer/IMultiplayerClient.cs
index 3e6821b1cd..43ccfd36ed 100644
--- a/osu.Game/Online/Multiplayer/IMultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/IMultiplayerClient.cs
@@ -98,9 +98,10 @@ namespace osu.Game.Online.Multiplayer
         Task LoadRequested();
 
         /// <summary>
-        /// Signals that a match has started. All users in the <see cref="MultiplayerUserState.Loaded"/> state should begin gameplay as soon as possible.
+        /// Signals that gameplay has started.
+        /// All users in the <see cref="MultiplayerUserState.Loaded"/> or <see cref="MultiplayerUserState.ReadyForGameplay"/> states should begin gameplay as soon as possible.
         /// </summary>
-        Task MatchStarted();
+        Task GameplayStarted();
 
         /// <summary>
         /// Signals that the match has ended, all players have finished and results are ready to be displayed.
diff --git a/osu.Game/Online/Multiplayer/MultiplayerClient.cs b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
index 967220abbf..a9fdf1110f 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
@@ -72,7 +72,7 @@ namespace osu.Game.Online.Multiplayer
         /// <summary>
         /// Invoked when the multiplayer server requests gameplay to be started.
         /// </summary>
-        public event Action? MatchStarted;
+        public event Action? GameplayStarted;
 
         /// <summary>
         /// Invoked when the multiplayer server has finished collating results.
@@ -604,14 +604,14 @@ namespace osu.Game.Online.Multiplayer
             return Task.CompletedTask;
         }
 
-        Task IMultiplayerClient.MatchStarted()
+        Task IMultiplayerClient.GameplayStarted()
         {
             Scheduler.Add(() =>
             {
                 if (Room == null)
                     return;
 
-                MatchStarted?.Invoke();
+                GameplayStarted?.Invoke();
             }, false);
 
             return Task.CompletedTask;
diff --git a/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs b/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs
index 7e62908ecd..de93233830 100644
--- a/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs
@@ -54,7 +54,7 @@ namespace osu.Game.Online.Multiplayer
                     connection.On<MultiplayerRoomSettings>(nameof(IMultiplayerClient.SettingsChanged), ((IMultiplayerClient)this).SettingsChanged);
                     connection.On<int, MultiplayerUserState>(nameof(IMultiplayerClient.UserStateChanged), ((IMultiplayerClient)this).UserStateChanged);
                     connection.On(nameof(IMultiplayerClient.LoadRequested), ((IMultiplayerClient)this).LoadRequested);
-                    connection.On(nameof(IMultiplayerClient.MatchStarted), ((IMultiplayerClient)this).MatchStarted);
+                    connection.On(nameof(IMultiplayerClient.GameplayStarted), ((IMultiplayerClient)this).GameplayStarted);
                     connection.On(nameof(IMultiplayerClient.ResultsReady), ((IMultiplayerClient)this).ResultsReady);
                     connection.On<int, IEnumerable<APIMod>>(nameof(IMultiplayerClient.UserModsChanged), ((IMultiplayerClient)this).UserModsChanged);
                     connection.On<int, BeatmapAvailability>(nameof(IMultiplayerClient.UserBeatmapAvailabilityChanged), ((IMultiplayerClient)this).UserBeatmapAvailabilityChanged);
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayer.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayer.cs
index 70f8f1b752..d3a78a43a5 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayer.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayer.cs
@@ -115,7 +115,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
             if (!ValidForResume)
                 return; // token retrieval may have failed.
 
-            client.MatchStarted += onMatchStarted;
+            client.GameplayStarted += onGameplayStarted;
             client.ResultsReady += onResultsReady;
 
             ScoreProcessor.HasCompleted.BindValueChanged(completed =>
@@ -175,7 +175,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
             leaderboardFlow.Position = new Vector2(padding, padding + HUDOverlay.TopScoringElementsHeight);
         }
 
-        private void onMatchStarted() => Scheduler.Add(() =>
+        private void onGameplayStarted() => Scheduler.Add(() =>
         {
             if (!this.IsCurrentScreen())
                 return;
@@ -223,7 +223,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
 
             if (client != null)
             {
-                client.MatchStarted -= onMatchStarted;
+                client.GameplayStarted -= onGameplayStarted;
                 client.ResultsReady -= onResultsReady;
             }
         }
diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
index 21774b73a0..725499d0e5 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
@@ -155,7 +155,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                             foreach (var u in Room.Users.Where(u => u.State == MultiplayerUserState.Loaded))
                                 ChangeUserState(u.UserID, MultiplayerUserState.Playing);
 
-                            ((IMultiplayerClient)this).MatchStarted();
+                            ((IMultiplayerClient)this).GameplayStarted();
 
                             ChangeRoomState(MultiplayerRoomState.Playing);
                         }

From 59622deb1fcf0d06b60302698bad24238e66e49e Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 21 Apr 2022 22:38:58 +0900
Subject: [PATCH 4218/5547] Add LoadAborted() event

---
 .../Online/Multiplayer/IMultiplayerClient.cs   |  7 ++++++-
 .../Online/Multiplayer/MultiplayerClient.cs    | 18 ++++++++++++++++++
 .../Multiplayer/OnlineMultiplayerClient.cs     |  1 +
 3 files changed, 25 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Online/Multiplayer/IMultiplayerClient.cs b/osu.Game/Online/Multiplayer/IMultiplayerClient.cs
index 43ccfd36ed..2f454ea835 100644
--- a/osu.Game/Online/Multiplayer/IMultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/IMultiplayerClient.cs
@@ -93,10 +93,15 @@ namespace osu.Game.Online.Multiplayer
         Task UserModsChanged(int userId, IEnumerable<APIMod> mods);
 
         /// <summary>
-        /// Signals that a match is to be started. This will *only* be sent to clients which are to begin loading at this point.
+        /// Signals that the match is starting and the loading of gameplay should be started. This will *only* be sent to clients which are to begin loading at this point.
         /// </summary>
         Task LoadRequested();
 
+        /// <summary>
+        /// Signals that loading of gameplay is to be aborted.
+        /// </summary>
+        Task LoadAborted();
+
         /// <summary>
         /// Signals that gameplay has started.
         /// All users in the <see cref="MultiplayerUserState.Loaded"/> or <see cref="MultiplayerUserState.ReadyForGameplay"/> states should begin gameplay as soon as possible.
diff --git a/osu.Game/Online/Multiplayer/MultiplayerClient.cs b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
index a9fdf1110f..cae675b406 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
@@ -69,6 +69,11 @@ namespace osu.Game.Online.Multiplayer
         /// </summary>
         public virtual event Action? LoadRequested;
 
+        /// <summary>
+        /// Invoked when the multiplayer server requests loading of play to be aborted.
+        /// </summary>
+        public event Action? LoadAborted;
+
         /// <summary>
         /// Invoked when the multiplayer server requests gameplay to be started.
         /// </summary>
@@ -604,6 +609,19 @@ namespace osu.Game.Online.Multiplayer
             return Task.CompletedTask;
         }
 
+        Task IMultiplayerClient.LoadAborted()
+        {
+            Scheduler.Add(() =>
+            {
+                if (Room == null)
+                    return;
+
+                LoadAborted?.Invoke();
+            }, false);
+
+            return Task.CompletedTask;
+        }
+
         Task IMultiplayerClient.GameplayStarted()
         {
             Scheduler.Add(() =>
diff --git a/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs b/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs
index de93233830..4dc23d8b85 100644
--- a/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs
@@ -55,6 +55,7 @@ namespace osu.Game.Online.Multiplayer
                     connection.On<int, MultiplayerUserState>(nameof(IMultiplayerClient.UserStateChanged), ((IMultiplayerClient)this).UserStateChanged);
                     connection.On(nameof(IMultiplayerClient.LoadRequested), ((IMultiplayerClient)this).LoadRequested);
                     connection.On(nameof(IMultiplayerClient.GameplayStarted), ((IMultiplayerClient)this).GameplayStarted);
+                    connection.On(nameof(IMultiplayerClient.LoadAborted), ((IMultiplayerClient)this).LoadAborted);
                     connection.On(nameof(IMultiplayerClient.ResultsReady), ((IMultiplayerClient)this).ResultsReady);
                     connection.On<int, IEnumerable<APIMod>>(nameof(IMultiplayerClient.UserModsChanged), ((IMultiplayerClient)this).UserModsChanged);
                     connection.On<int, BeatmapAvailability>(nameof(IMultiplayerClient.UserBeatmapAvailabilityChanged), ((IMultiplayerClient)this).UserBeatmapAvailabilityChanged);

From 41355384bdab55039c78b59f11500d2d1d497761 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 21 Apr 2022 22:55:13 +0900
Subject: [PATCH 4219/5547] Add support for gameplay abort/force start

---
 .../OnlinePlay/Multiplayer/Multiplayer.cs      | 18 ++++++++++++++++++
 .../Multiplayer/MultiplayerPlayer.cs           | 13 +++++++++----
 .../Multiplayer/MultiplayerPlayerLoader.cs     | 10 ++++++++++
 osu.Game/Screens/Play/PlayerLoader.cs          | 12 ++++++++----
 4 files changed, 45 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Multiplayer.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Multiplayer.cs
index 2482d52492..c78756771a 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Multiplayer.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Multiplayer.cs
@@ -3,6 +3,7 @@
 
 using System.Diagnostics;
 using osu.Framework.Allocation;
+using osu.Framework.Logging;
 using osu.Framework.Screens;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Screens.OnlinePlay.Components;
@@ -20,6 +21,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
             base.LoadComplete();
 
             client.RoomUpdated += onRoomUpdated;
+            client.LoadAborted += onLoadAborted;
             onRoomUpdated();
         }
 
@@ -35,6 +37,16 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
                 transitionFromResults();
         }
 
+        private void onLoadAborted()
+        {
+            // If the server aborts gameplay for this user (due to loading too slow), exit gameplay screens.
+            if (!this.IsCurrentScreen())
+            {
+                Logger.Log("Gameplay aborted because loading the beatmap took too long.", LoggingTarget.Runtime, LogLevel.Important);
+                this.MakeCurrent();
+            }
+        }
+
         public override void OnResuming(IScreen last)
         {
             base.OnResuming(last);
@@ -42,9 +54,15 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
             if (client.Room == null)
                 return;
 
+            Debug.Assert(client.LocalUser != null);
+
             if (!(last is MultiplayerPlayerLoader playerLoader))
                 return;
 
+            // Nothing needs to be done if already in the idle state (e.g. via load being aborted by the server).
+            if (client.LocalUser.State == MultiplayerUserState.Idle)
+                return;
+
             // If gameplay wasn't finished, then we have a simple path back to the idle state by aborting gameplay.
             if (!playerLoader.GameplayPassed)
             {
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayer.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayer.cs
index d3a78a43a5..7dd57ee50f 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayer.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayer.cs
@@ -133,6 +133,9 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
                     failAndBail();
                 }
             }), true);
+
+            client.ChangeState(MultiplayerUserState.Loaded)
+                  .ContinueWith(task => failAndBail(task.Exception?.Message ?? "Server error"), TaskContinuationOptions.NotOnRanToCompletion);
         }
 
         protected override void LoadComplete()
@@ -144,10 +147,12 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
 
         protected override void StartGameplay()
         {
-            // block base call, but let the server know we are ready to start.
-            loadingDisplay.Show();
-
-            client.ChangeState(MultiplayerUserState.Loaded).ContinueWith(task => failAndBail(task.Exception?.Message ?? "Server error"), TaskContinuationOptions.NotOnRanToCompletion);
+            if (client.LocalUser?.State == MultiplayerUserState.Loaded)
+            {
+                // block base call, but let the server know we are ready to start.
+                loadingDisplay.Show();
+                client.ChangeState(MultiplayerUserState.ReadyForGameplay);
+            }
         }
 
         private void failAndBail(string message = null)
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayerLoader.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayerLoader.cs
index 772651727e..9964452f61 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayerLoader.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayerLoader.cs
@@ -2,7 +2,9 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
+using osu.Framework.Allocation;
 using osu.Framework.Screens;
+using osu.Game.Online.Multiplayer;
 using osu.Game.Screens.Play;
 
 namespace osu.Game.Screens.OnlinePlay.Multiplayer
@@ -11,6 +13,9 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
     {
         public bool GameplayPassed => player?.GameplayState.HasPassed == true;
 
+        [Resolved]
+        private MultiplayerClient multiplayerClient { get; set; }
+
         private Player player;
 
         public MultiplayerPlayerLoader(Func<Player> createPlayer)
@@ -18,6 +23,11 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
         {
         }
 
+        protected override bool ReadyForGameplay =>
+            base.ReadyForGameplay
+            // The server is forcefully starting gameplay.
+            || multiplayerClient.LocalUser?.State == MultiplayerUserState.Playing;
+
         public override void OnSuspending(IScreen next)
         {
             base.OnSuspending(next);
diff --git a/osu.Game/Screens/Play/PlayerLoader.cs b/osu.Game/Screens/Play/PlayerLoader.cs
index aea39bc8ff..f7dae6eaa9 100644
--- a/osu.Game/Screens/Play/PlayerLoader.cs
+++ b/osu.Game/Screens/Play/PlayerLoader.cs
@@ -92,11 +92,15 @@ namespace osu.Game.Screens.Play
             !playerConsumed
             // don't push unless the player is completely loaded
             && CurrentPlayer?.LoadState == LoadState.Ready
-            // don't push if the user is hovering one of the panes, unless they are idle.
-            && (IsHovered || idleTracker.IsIdle.Value)
-            // don't push if the user is dragging a slider or otherwise.
+            // don't push unless the player is ready to start gameplay
+            && 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 dragging a slider or otherwise.
             && inputManager.DraggedDrawable == null
-            // don't push if a focused overlay is visible, like settings.
+            // not ready if a focused overlay is visible, like settings.
             && inputManager.FocusedDrawable == null;
 
         private readonly Func<Player> createPlayer;

From cbb07d4011a8db5de79c775f659eaa6ea7f0da34 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 21 Apr 2022 22:56:24 +0900
Subject: [PATCH 4220/5547] Add countdown classes

---
 .../Online/Multiplayer/GameplayStartCountdown.cs  | 15 +++++++++++++++
 .../Online/Multiplayer/MultiplayerCountdown.cs    |  1 +
 osu.Game/Online/SignalRWorkaroundTypes.cs         |  3 ++-
 3 files changed, 18 insertions(+), 1 deletion(-)
 create mode 100644 osu.Game/Online/Multiplayer/GameplayStartCountdown.cs

diff --git a/osu.Game/Online/Multiplayer/GameplayStartCountdown.cs b/osu.Game/Online/Multiplayer/GameplayStartCountdown.cs
new file mode 100644
index 0000000000..d3d7f78507
--- /dev/null
+++ b/osu.Game/Online/Multiplayer/GameplayStartCountdown.cs
@@ -0,0 +1,15 @@
+// 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 MessagePack;
+
+namespace osu.Game.Online.Multiplayer
+{
+    /// <summary>
+    /// A <see cref="MultiplayerCountdown"/> indicating that gameplay will start after a given period of time.
+    /// </summary>
+    [MessagePackObject]
+    public class GameplayStartCountdown : MultiplayerCountdown
+    {
+    }
+}
diff --git a/osu.Game/Online/Multiplayer/MultiplayerCountdown.cs b/osu.Game/Online/Multiplayer/MultiplayerCountdown.cs
index 81190e64c9..308eea3aef 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerCountdown.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerCountdown.cs
@@ -14,6 +14,7 @@ namespace osu.Game.Online.Multiplayer
     /// </summary>
     [MessagePackObject]
     [Union(0, typeof(MatchStartCountdown))] // IMPORTANT: Add rules to SignalRUnionWorkaroundResolver for new derived types.
+    [Union(1, typeof(GameplayStartCountdown))]
     public abstract class MultiplayerCountdown
     {
         /// <summary>
diff --git a/osu.Game/Online/SignalRWorkaroundTypes.cs b/osu.Game/Online/SignalRWorkaroundTypes.cs
index 156f916cef..00fdadb87e 100644
--- a/osu.Game/Online/SignalRWorkaroundTypes.cs
+++ b/osu.Game/Online/SignalRWorkaroundTypes.cs
@@ -24,7 +24,8 @@ namespace osu.Game.Online
             (typeof(CountdownChangedEvent), typeof(MatchServerEvent)),
             (typeof(TeamVersusRoomState), typeof(MatchRoomState)),
             (typeof(TeamVersusUserState), typeof(MatchUserState)),
-            (typeof(MatchStartCountdown), typeof(MultiplayerCountdown))
+            (typeof(MatchStartCountdown), typeof(MultiplayerCountdown)),
+            (typeof(GameplayStartCountdown), typeof(MultiplayerCountdown))
         };
     }
 }

From ef1955d8ab2651a9ceff1386acd152762577bf45 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 21 Apr 2022 23:01:16 +0900
Subject: [PATCH 4221/5547] Make buttons only respond to MatchStartCountdown

---
 .../Match/MultiplayerCountdownButton.cs          |  2 +-
 .../Multiplayer/Match/MultiplayerReadyButton.cs  | 16 +++++++++++++++-
 2 files changed, 16 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerCountdownButton.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerCountdownButton.cs
index c84fcff11e..1a51aebb76 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerCountdownButton.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerCountdownButton.cs
@@ -77,7 +77,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
 
         private void onRoomUpdated() => Scheduler.AddOnce(() =>
         {
-            bool countdownActive = multiplayerClient.Room?.Countdown != null;
+            bool countdownActive = multiplayerClient.Room?.Countdown is MatchStartCountdown;
 
             if (countdownActive)
             {
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
index 22a0243f8f..a7e18622dc 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
@@ -55,7 +55,21 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
 
         private void onRoomUpdated() => Scheduler.AddOnce(() =>
         {
-            if (countdown != room?.Countdown)
+            MultiplayerCountdown newCountdown;
+
+            switch (room?.Countdown)
+            {
+                case MatchStartCountdown _:
+                    newCountdown = room.Countdown;
+                    break;
+
+                // Clear the countdown with any other (including non-null) countdown values.
+                default:
+                    newCountdown = null;
+                    break;
+            }
+
+            if (newCountdown != countdown)
             {
                 countdown = room?.Countdown;
                 countdownChangeTime = Time.Current;

From a0a83fb51fa1d69f4ade683fb5dd7e3db4e19130 Mon Sep 17 00:00:00 2001
From: 63411 <62799417+molneya@users.noreply.github.com>
Date: Thu, 21 Apr 2022 23:03:28 +0800
Subject: [PATCH 4222/5547] Use closest endTime for holdAddition validity

---
 osu.Game.Rulesets.Mania/Difficulty/Skills/Strain.cs | 13 ++++++++-----
 1 file changed, 8 insertions(+), 5 deletions(-)

diff --git a/osu.Game.Rulesets.Mania/Difficulty/Skills/Strain.cs b/osu.Game.Rulesets.Mania/Difficulty/Skills/Strain.cs
index ab6bd78ece..2e252acdc8 100644
--- a/osu.Game.Rulesets.Mania/Difficulty/Skills/Strain.cs
+++ b/osu.Game.Rulesets.Mania/Difficulty/Skills/Strain.cs
@@ -37,6 +37,7 @@ namespace osu.Game.Rulesets.Mania.Difficulty.Skills
             var maniaCurrent = (ManiaDifficultyHitObject)current;
             double endTime = maniaCurrent.EndTime;
             int column = maniaCurrent.BaseObject.Column;
+            double closestEndTime = 100;
 
             double holdFactor = 1.0; // Factor to all additional strains in case something else is held
             double holdAddition = 0; // Addition to the current note in case it's a hold and has to be released awkwardly
@@ -44,24 +45,26 @@ namespace osu.Game.Rulesets.Mania.Difficulty.Skills
             // Fill up the holdEndTimes array
             for (int i = 0; i < holdEndTimes.Length; ++i)
             {
-                // If there is at least one other overlapping end or note, then we get an addition, buuuuuut...
+                // If there is at least one other overlapping end or note, then we get an addition
                 if (Precision.DefinitelyBigger(holdEndTimes[i], maniaCurrent.StartTime, 1) && Precision.DefinitelyBigger(endTime, holdEndTimes[i], 1))
                     holdAddition = 1.0;
 
-                // ... this addition only is valid if there is _no_ other note with the same ending. Releasing multiple notes at the same time is just as easy as releasing 1
-                if (Precision.AlmostEquals(endTime, holdEndTimes[i], 1))
-                    holdAddition = 0;
-
                 // We give a slight bonus to everything if something is held meanwhile
                 if (Precision.DefinitelyBigger(holdEndTimes[i], endTime, 1))
                     holdFactor = 1.25;
 
+                closestEndTime = Math.Min(closestEndTime, Math.Abs(endTime - holdEndTimes[i]));
+
                 // Decay individual strains
                 individualStrains[i] = applyDecay(individualStrains[i], current.DeltaTime, individual_decay_base);
             }
 
             holdEndTimes[column] = endTime;
 
+            // The hold addition only is valid if there is _no_ other note with the same ending. Releasing multiple notes at the same time is just as easy as releasing 1
+            if (closestEndTime < 1)
+                holdAddition = 0;
+
             // Increase individual strain in own column
             individualStrains[column] += 2.0 * holdFactor;
             individualStrain = individualStrains[column];

From e7a149af6c1c7091a4406df3fddb980b8ac5fb9f Mon Sep 17 00:00:00 2001
From: 63411 <62799417+molneya@users.noreply.github.com>
Date: Thu, 21 Apr 2022 23:05:20 +0800
Subject: [PATCH 4223/5547] Use curve for holdAddition validity cutoff

---
 osu.Game.Rulesets.Mania/Difficulty/Skills/Strain.cs | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/osu.Game.Rulesets.Mania/Difficulty/Skills/Strain.cs b/osu.Game.Rulesets.Mania/Difficulty/Skills/Strain.cs
index 2e252acdc8..d5d5d5751d 100644
--- a/osu.Game.Rulesets.Mania/Difficulty/Skills/Strain.cs
+++ b/osu.Game.Rulesets.Mania/Difficulty/Skills/Strain.cs
@@ -62,8 +62,7 @@ namespace osu.Game.Rulesets.Mania.Difficulty.Skills
             holdEndTimes[column] = endTime;
 
             // The hold addition only is valid if there is _no_ other note with the same ending. Releasing multiple notes at the same time is just as easy as releasing 1
-            if (closestEndTime < 1)
-                holdAddition = 0;
+            holdAddition *= 1 / (1 + Math.Exp(0.5 * (24 - closestEndTime)));
 
             // Increase individual strain in own column
             individualStrains[column] += 2.0 * holdFactor;

From 4d3044b841c4f5d9b73a144aaabf7bd1fc7b1725 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 22 Apr 2022 00:49:15 +0900
Subject: [PATCH 4224/5547] Update framework

---
 osu.Android.props        | 2 +-
 osu.Game/osu.Game.csproj | 2 +-
 osu.iOS.props            | 4 ++--
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Android.props b/osu.Android.props
index 8b22df418f..6b06305bf9 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -52,7 +52,7 @@
   </ItemGroup>
   <ItemGroup>
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.417.0" />
-    <PackageReference Include="ppy.osu.Framework.Android" Version="2022.419.0" />
+    <PackageReference Include="ppy.osu.Framework.Android" Version="2022.421.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
     <!-- Realm needs to be directly referenced in all Xamarin projects, as it will not pull in its transitive dependencies otherwise. -->
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 0a102510e7..c57acb3b7f 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="10.10.0" />
-    <PackageReference Include="ppy.osu.Framework" Version="2022.419.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2022.421.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.417.0" />
     <PackageReference Include="Sentry" Version="3.14.1" />
     <PackageReference Include="SharpCompress" Version="0.30.1" />
diff --git a/osu.iOS.props b/osu.iOS.props
index 2f0facea18..d7f89b802b 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -61,7 +61,7 @@
     <Reference Include="System.Net.Http" />
   </ItemGroup>
   <ItemGroup Label="Package References">
-    <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.419.0" />
+    <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.421.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.417.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net6.0) -->
@@ -84,7 +84,7 @@
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="5.0.14" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.Core" Version="5.0.14" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
-    <PackageReference Include="ppy.osu.Framework" Version="2022.419.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2022.421.0" />
     <PackageReference Include="SharpCompress" Version="0.30.1" />
     <PackageReference Include="NUnit" Version="3.13.2" />
     <PackageReference Include="System.ComponentModel.Annotations" Version="5.0.0" />

From 832d37b2c2c9b5f2cde6bec90804e6dab36e8e0e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 22 Apr 2022 00:52:44 +0900
Subject: [PATCH 4225/5547] Update screen transition events to use new event
 args

---
 .../Background/TestSceneUserDimBackgrounds.cs |  4 ++--
 .../Visual/Gameplay/TestScenePause.cs         |  4 ++--
 .../Navigation/TestScenePerformFromScreen.cs  |  8 ++++----
 .../Visual/TestMultiplayerComponents.cs       |  4 ++--
 .../Graphics/Containers/ScalingContainer.cs   |  2 +-
 .../AccountCreation/AccountCreationScreen.cs  | 12 +++++------
 .../Overlays/AccountCreation/ScreenEntry.cs   |  4 ++--
 .../Overlays/AccountCreation/ScreenWarning.cs |  4 ++--
 .../Maintenance/DirectorySelectScreen.cs      |  4 ++--
 .../Maintenance/MigrationRunScreen.cs         |  8 ++++----
 .../StableDirectorySelectScreen.cs            |  4 ++--
 osu.Game/Screens/BackgroundScreen.cs          | 16 +++++++--------
 .../Backgrounds/BackgroundScreenBlack.cs      |  2 +-
 osu.Game/Screens/Edit/Editor.cs               | 16 +++++++--------
 .../Screens/Edit/GameplayTest/EditorPlayer.cs |  8 ++++----
 .../Edit/GameplayTest/EditorPlayerLoader.cs   |  4 ++--
 osu.Game/Screens/Import/FileImportScreen.cs   |  8 ++++----
 osu.Game/Screens/Loader.cs                    |  4 ++--
 osu.Game/Screens/Menu/Disclaimer.cs           |  4 ++--
 osu.Game/Screens/Menu/IntroCircles.cs         |  4 ++--
 osu.Game/Screens/Menu/IntroScreen.cs          | 12 +++++------
 osu.Game/Screens/Menu/IntroTriangles.cs       |  8 ++++----
 osu.Game/Screens/Menu/IntroWelcome.cs         |  4 ++--
 osu.Game/Screens/Menu/MainMenu.cs             | 18 ++++++++---------
 .../Components/OnlinePlayBackgroundScreen.cs  |  8 ++++----
 .../Lounge/LoungeBackgroundScreen.cs          |  2 +-
 .../OnlinePlay/Lounge/LoungeSubScreen.cs      | 16 +++++++--------
 .../Screens/OnlinePlay/Match/RoomSubScreen.cs | 16 +++++++--------
 .../OnlinePlay/Multiplayer/Multiplayer.cs     |  6 +++---
 .../Multiplayer/MultiplayerLoungeSubScreen.cs |  6 +++---
 .../Multiplayer/MultiplayerMatchSubScreen.cs  |  6 +++---
 .../Multiplayer/MultiplayerPlayerLoader.cs    |  6 +++---
 .../Screens/OnlinePlay/OnlinePlayScreen.cs    | 20 +++++++++----------
 .../OnlinePlay/OnlinePlaySongSelect.cs        |  4 ++--
 .../Screens/OnlinePlay/OnlinePlaySubScreen.cs | 16 +++++++--------
 .../OnlinePlay/Playlists/PlaylistsPlayer.cs   |  4 ++--
 osu.Game/Screens/OsuScreen.cs                 | 16 +++++++--------
 osu.Game/Screens/Play/Player.cs               | 12 +++++------
 osu.Game/Screens/Play/PlayerLoader.cs         | 16 +++++++--------
 osu.Game/Screens/Play/ReplayPlayerLoader.cs   |  4 ++--
 osu.Game/Screens/Play/SoloSpectator.cs        |  4 ++--
 osu.Game/Screens/Play/SoloSpectatorPlayer.cs  |  4 ++--
 osu.Game/Screens/Play/SpectatorPlayer.cs      |  4 ++--
 .../Screens/Play/SpectatorPlayerLoader.cs     |  4 ++--
 osu.Game/Screens/Play/SubmittingPlayer.cs     |  4 ++--
 osu.Game/Screens/Ranking/ResultsScreen.cs     |  8 ++++----
 osu.Game/Screens/ScreenWhiteBox.cs            | 12 +++++------
 osu.Game/Screens/Select/PlaySongSelect.cs     |  4 ++--
 osu.Game/Screens/Select/SongSelect.cs         | 16 +++++++--------
 osu.Game/Tests/Visual/EditorTestScene.cs      |  4 ++--
 50 files changed, 194 insertions(+), 194 deletions(-)

diff --git a/osu.Game.Tests/Visual/Background/TestSceneUserDimBackgrounds.cs b/osu.Game.Tests/Visual/Background/TestSceneUserDimBackgrounds.cs
index 9f708ace70..f7140537ee 100644
--- a/osu.Game.Tests/Visual/Background/TestSceneUserDimBackgrounds.cs
+++ b/osu.Game.Tests/Visual/Background/TestSceneUserDimBackgrounds.cs
@@ -359,9 +359,9 @@ namespace osu.Game.Tests.Visual.Background
             protected override BackgroundScreen CreateBackground() =>
                 new FadeAccessibleBackground(Beatmap.Value);
 
-            public override void OnEntering(IScreen last)
+            public override void OnEntering(ScreenTransitionEvent e)
             {
-                base.OnEntering(last);
+                base.OnEntering(e);
 
                 ApplyToBackground(b => ReplacesBackground.BindTo(b.StoryboardReplacesBackground));
             }
diff --git a/osu.Game.Tests/Visual/Gameplay/TestScenePause.cs b/osu.Game.Tests/Visual/Gameplay/TestScenePause.cs
index ea0255ab76..a224a78531 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestScenePause.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestScenePause.cs
@@ -389,9 +389,9 @@ namespace osu.Game.Tests.Visual.Gameplay
 
             public void ExitViaQuickExit() => PerformExit(false);
 
-            public override void OnEntering(IScreen last)
+            public override void OnEntering(ScreenTransitionEvent e)
             {
-                base.OnEntering(last);
+                base.OnEntering(e);
                 GameplayClockContainer.Stop();
             }
         }
diff --git a/osu.Game.Tests/Visual/Navigation/TestScenePerformFromScreen.cs b/osu.Game.Tests/Visual/Navigation/TestScenePerformFromScreen.cs
index 559e6ddd89..2ce914ba3d 100644
--- a/osu.Game.Tests/Visual/Navigation/TestScenePerformFromScreen.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestScenePerformFromScreen.cs
@@ -230,7 +230,7 @@ namespace osu.Game.Tests.Visual.Navigation
 
             public int ExitAttempts { get; private set; }
 
-            public override bool OnExiting(IScreen next)
+            public override bool OnExiting(ScreenExitEvent e)
             {
                 ExitAttempts++;
 
@@ -240,7 +240,7 @@ namespace osu.Game.Tests.Visual.Navigation
                     return true;
                 }
 
-                return base.OnExiting(next);
+                return base.OnExiting(e);
             }
         }
 
@@ -257,7 +257,7 @@ namespace osu.Game.Tests.Visual.Navigation
                 SubScreenStack.Push(Blocker = new DialogBlockingScreen());
             }
 
-            public override bool OnExiting(IScreen next)
+            public override bool OnExiting(ScreenExitEvent e)
             {
                 if (SubScreenStack.CurrentScreen != null)
                 {
@@ -265,7 +265,7 @@ namespace osu.Game.Tests.Visual.Navigation
                     return true;
                 }
 
-                return base.OnExiting(next);
+                return base.OnExiting(e);
             }
         }
     }
diff --git a/osu.Game.Tests/Visual/TestMultiplayerComponents.cs b/osu.Game.Tests/Visual/TestMultiplayerComponents.cs
index c43ed744bd..4ab201ef46 100644
--- a/osu.Game.Tests/Visual/TestMultiplayerComponents.cs
+++ b/osu.Game.Tests/Visual/TestMultiplayerComponents.cs
@@ -80,10 +80,10 @@ namespace osu.Game.Tests.Visual
 
         public override bool OnBackButton() => (screenStack.CurrentScreen as OsuScreen)?.OnBackButton() ?? base.OnBackButton();
 
-        public override bool OnExiting(IScreen next)
+        public override bool OnExiting(ScreenExitEvent e)
         {
             if (screenStack.CurrentScreen == null)
-                return base.OnExiting(next);
+                return base.OnExiting(e);
 
             screenStack.Exit();
             return true;
diff --git a/osu.Game/Graphics/Containers/ScalingContainer.cs b/osu.Game/Graphics/Containers/ScalingContainer.cs
index ca8b6f388f..89432595f3 100644
--- a/osu.Game/Graphics/Containers/ScalingContainer.cs
+++ b/osu.Game/Graphics/Containers/ScalingContainer.cs
@@ -209,7 +209,7 @@ namespace osu.Game.Graphics.Containers
         {
             protected override bool AllowStoryboardBackground => false;
 
-            public override void OnEntering(IScreen last)
+            public override void OnEntering(ScreenTransitionEvent e)
             {
                 this.FadeInFromZero(4000, Easing.OutQuint);
             }
diff --git a/osu.Game/Overlays/AccountCreation/AccountCreationScreen.cs b/osu.Game/Overlays/AccountCreation/AccountCreationScreen.cs
index 7e2ae405cb..6aef358b2e 100644
--- a/osu.Game/Overlays/AccountCreation/AccountCreationScreen.cs
+++ b/osu.Game/Overlays/AccountCreation/AccountCreationScreen.cs
@@ -8,21 +8,21 @@ namespace osu.Game.Overlays.AccountCreation
 {
     public abstract class AccountCreationScreen : Screen
     {
-        public override void OnEntering(IScreen last)
+        public override void OnEntering(ScreenTransitionEvent e)
         {
-            base.OnEntering(last);
+            base.OnEntering(e);
             this.FadeOut().Delay(200).FadeIn(200);
         }
 
-        public override void OnResuming(IScreen last)
+        public override void OnResuming(ScreenTransitionEvent e)
         {
-            base.OnResuming(last);
+            base.OnResuming(e);
             this.FadeIn(200);
         }
 
-        public override void OnSuspending(IScreen next)
+        public override void OnSuspending(ScreenTransitionEvent e)
         {
-            base.OnSuspending(next);
+            base.OnSuspending(e);
             this.FadeOut(200);
         }
     }
diff --git a/osu.Game/Overlays/AccountCreation/ScreenEntry.cs b/osu.Game/Overlays/AccountCreation/ScreenEntry.cs
index 6cf3fb4267..1be1321d85 100644
--- a/osu.Game/Overlays/AccountCreation/ScreenEntry.cs
+++ b/osu.Game/Overlays/AccountCreation/ScreenEntry.cs
@@ -147,9 +147,9 @@ namespace osu.Game.Overlays.AccountCreation
                 d.Colour = password.Length == 0 ? Color4.White : Interpolation.ValueAt(password.Length, Color4.OrangeRed, Color4.YellowGreen, 0, 8, Easing.In);
         }
 
-        public override void OnEntering(IScreen last)
+        public override void OnEntering(ScreenTransitionEvent e)
         {
-            base.OnEntering(last);
+            base.OnEntering(e);
             loadingLayer.Hide();
 
             if (host?.OnScreenKeyboardOverlapsGameWindow != true)
diff --git a/osu.Game/Overlays/AccountCreation/ScreenWarning.cs b/osu.Game/Overlays/AccountCreation/ScreenWarning.cs
index 3d46e9ed94..780a79f8f9 100644
--- a/osu.Game/Overlays/AccountCreation/ScreenWarning.cs
+++ b/osu.Game/Overlays/AccountCreation/ScreenWarning.cs
@@ -31,7 +31,7 @@ namespace osu.Game.Overlays.AccountCreation
 
         private const string help_centre_url = "/help/wiki/Help_Centre#login";
 
-        public override void OnEntering(IScreen last)
+        public override void OnEntering(ScreenTransitionEvent e)
         {
             if (string.IsNullOrEmpty(api?.ProvidedUsername) || game?.UseDevelopmentServer == true)
             {
@@ -40,7 +40,7 @@ namespace osu.Game.Overlays.AccountCreation
                 return;
             }
 
-            base.OnEntering(last);
+            base.OnEntering(e);
         }
 
         [BackgroundDependencyLoader(true)]
diff --git a/osu.Game/Overlays/Settings/Sections/Maintenance/DirectorySelectScreen.cs b/osu.Game/Overlays/Settings/Sections/Maintenance/DirectorySelectScreen.cs
index 98bc8d88be..c7fd248842 100644
--- a/osu.Game/Overlays/Settings/Sections/Maintenance/DirectorySelectScreen.cs
+++ b/osu.Game/Overlays/Settings/Sections/Maintenance/DirectorySelectScreen.cs
@@ -124,9 +124,9 @@ namespace osu.Game.Overlays.Settings.Sections.Maintenance
             base.LoadComplete();
         }
 
-        public override void OnSuspending(IScreen next)
+        public override void OnSuspending(ScreenTransitionEvent e)
         {
-            base.OnSuspending(next);
+            base.OnSuspending(e);
 
             this.FadeOut(250);
         }
diff --git a/osu.Game/Overlays/Settings/Sections/Maintenance/MigrationRunScreen.cs b/osu.Game/Overlays/Settings/Sections/Maintenance/MigrationRunScreen.cs
index 10d6f0aef5..b7b797936e 100644
--- a/osu.Game/Overlays/Settings/Sections/Maintenance/MigrationRunScreen.cs
+++ b/osu.Game/Overlays/Settings/Sections/Maintenance/MigrationRunScreen.cs
@@ -124,20 +124,20 @@ namespace osu.Game.Overlays.Settings.Sections.Maintenance
 
         protected virtual bool PerformMigration() => game?.Migrate(destination.FullName) != false;
 
-        public override void OnEntering(IScreen last)
+        public override void OnEntering(ScreenTransitionEvent e)
         {
-            base.OnEntering(last);
+            base.OnEntering(e);
 
             this.FadeOut().Delay(250).Then().FadeIn(250);
         }
 
-        public override bool OnExiting(IScreen next)
+        public override bool OnExiting(ScreenExitEvent e)
         {
             // block until migration is finished
             if (migrationTask?.IsCompleted == false)
                 return true;
 
-            return base.OnExiting(next);
+            return base.OnExiting(e);
         }
     }
 }
diff --git a/osu.Game/Overlays/Settings/Sections/Maintenance/StableDirectorySelectScreen.cs b/osu.Game/Overlays/Settings/Sections/Maintenance/StableDirectorySelectScreen.cs
index 4aea05fb14..86934ae514 100644
--- a/osu.Game/Overlays/Settings/Sections/Maintenance/StableDirectorySelectScreen.cs
+++ b/osu.Game/Overlays/Settings/Sections/Maintenance/StableDirectorySelectScreen.cs
@@ -30,10 +30,10 @@ namespace osu.Game.Overlays.Settings.Sections.Maintenance
             this.Exit();
         }
 
-        public override bool OnExiting(IScreen next)
+        public override bool OnExiting(ScreenExitEvent e)
         {
             taskCompletionSource.TrySetCanceled();
-            return base.OnExiting(next);
+            return base.OnExiting(e);
         }
     }
 }
diff --git a/osu.Game/Screens/BackgroundScreen.cs b/osu.Game/Screens/BackgroundScreen.cs
index a706934cce..6084ec4b01 100644
--- a/osu.Game/Screens/BackgroundScreen.cs
+++ b/osu.Game/Screens/BackgroundScreen.cs
@@ -48,7 +48,7 @@ namespace osu.Game.Screens
             Scale = new Vector2(1 + x_movement_amount / DrawSize.X * 2);
         }
 
-        public override void OnEntering(IScreen last)
+        public override void OnEntering(ScreenTransitionEvent e)
         {
             if (animateOnEnter)
             {
@@ -59,16 +59,16 @@ namespace osu.Game.Screens
                 this.MoveToX(0, TRANSITION_LENGTH, Easing.InOutQuart);
             }
 
-            base.OnEntering(last);
+            base.OnEntering(e);
         }
 
-        public override void OnSuspending(IScreen next)
+        public override void OnSuspending(ScreenTransitionEvent e)
         {
             this.MoveToX(-x_movement_amount, TRANSITION_LENGTH, Easing.InOutQuart);
-            base.OnSuspending(next);
+            base.OnSuspending(e);
         }
 
-        public override bool OnExiting(IScreen next)
+        public override bool OnExiting(ScreenExitEvent e)
         {
             if (IsLoaded)
             {
@@ -76,14 +76,14 @@ namespace osu.Game.Screens
                 this.MoveToX(x_movement_amount, TRANSITION_LENGTH, Easing.OutExpo);
             }
 
-            return base.OnExiting(next);
+            return base.OnExiting(e);
         }
 
-        public override void OnResuming(IScreen last)
+        public override void OnResuming(ScreenTransitionEvent e)
         {
             if (IsLoaded)
                 this.MoveToX(0, TRANSITION_LENGTH, Easing.OutExpo);
-            base.OnResuming(last);
+            base.OnResuming(e);
         }
     }
 }
diff --git a/osu.Game/Screens/Backgrounds/BackgroundScreenBlack.cs b/osu.Game/Screens/Backgrounds/BackgroundScreenBlack.cs
index 9e2559cc56..d946fd41d9 100644
--- a/osu.Game/Screens/Backgrounds/BackgroundScreenBlack.cs
+++ b/osu.Game/Screens/Backgrounds/BackgroundScreenBlack.cs
@@ -19,7 +19,7 @@ namespace osu.Game.Screens.Backgrounds
             };
         }
 
-        public override void OnEntering(IScreen last)
+        public override void OnEntering(ScreenTransitionEvent e)
         {
             Show();
         }
diff --git a/osu.Game/Screens/Edit/Editor.cs b/osu.Game/Screens/Edit/Editor.cs
index 30c57733ed..3fde033587 100644
--- a/osu.Game/Screens/Edit/Editor.cs
+++ b/osu.Game/Screens/Edit/Editor.cs
@@ -560,16 +560,16 @@ namespace osu.Game.Screens.Edit
         {
         }
 
-        public override void OnEntering(IScreen last)
+        public override void OnEntering(ScreenTransitionEvent e)
         {
-            base.OnEntering(last);
+            base.OnEntering(e);
             dimBackground();
             resetTrack(true);
         }
 
-        public override void OnResuming(IScreen last)
+        public override void OnResuming(ScreenTransitionEvent e)
         {
-            base.OnResuming(last);
+            base.OnResuming(e);
             dimBackground();
         }
 
@@ -585,7 +585,7 @@ namespace osu.Game.Screens.Edit
             });
         }
 
-        public override bool OnExiting(IScreen next)
+        public override bool OnExiting(ScreenExitEvent e)
         {
             if (!ExitConfirmed)
             {
@@ -613,12 +613,12 @@ namespace osu.Game.Screens.Edit
 
             refetchBeatmap();
 
-            return base.OnExiting(next);
+            return base.OnExiting(e);
         }
 
-        public override void OnSuspending(IScreen next)
+        public override void OnSuspending(ScreenTransitionEvent e)
         {
-            base.OnSuspending(next);
+            base.OnSuspending(e);
             clock.Stop();
             refetchBeatmap();
         }
diff --git a/osu.Game/Screens/Edit/GameplayTest/EditorPlayer.cs b/osu.Game/Screens/Edit/GameplayTest/EditorPlayer.cs
index d9e19df350..f7e450b0e2 100644
--- a/osu.Game/Screens/Edit/GameplayTest/EditorPlayer.cs
+++ b/osu.Game/Screens/Edit/GameplayTest/EditorPlayer.cs
@@ -44,9 +44,9 @@ namespace osu.Game.Screens.Edit.GameplayTest
 
         protected override bool CheckModsAllowFailure() => false; // never fail.
 
-        public override void OnEntering(IScreen last)
+        public override void OnEntering(ScreenTransitionEvent e)
         {
-            base.OnEntering(last);
+            base.OnEntering(e);
 
             // finish alpha transforms on entering to avoid gameplay starting in a half-hidden state.
             // the finish calls are purposefully not propagated to children to avoid messing up their state.
@@ -54,13 +54,13 @@ namespace osu.Game.Screens.Edit.GameplayTest
             GameplayClockContainer.FinishTransforms(false, nameof(Alpha));
         }
 
-        public override bool OnExiting(IScreen next)
+        public override bool OnExiting(ScreenExitEvent e)
         {
             musicController.Stop();
 
             editorState.Time = GameplayClockContainer.CurrentTime;
             editor.RestoreState(editorState);
-            return base.OnExiting(next);
+            return base.OnExiting(e);
         }
     }
 }
diff --git a/osu.Game/Screens/Edit/GameplayTest/EditorPlayerLoader.cs b/osu.Game/Screens/Edit/GameplayTest/EditorPlayerLoader.cs
index addc79ba61..c16bb8677c 100644
--- a/osu.Game/Screens/Edit/GameplayTest/EditorPlayerLoader.cs
+++ b/osu.Game/Screens/Edit/GameplayTest/EditorPlayerLoader.cs
@@ -19,9 +19,9 @@ namespace osu.Game.Screens.Edit.GameplayTest
         {
         }
 
-        public override void OnEntering(IScreen last)
+        public override void OnEntering(ScreenTransitionEvent e)
         {
-            base.OnEntering(last);
+            base.OnEntering(e);
 
             MetadataInfo.FinishTransforms(true);
         }
diff --git a/osu.Game/Screens/Import/FileImportScreen.cs b/osu.Game/Screens/Import/FileImportScreen.cs
index 09870e0bab..32ce54aa29 100644
--- a/osu.Game/Screens/Import/FileImportScreen.cs
+++ b/osu.Game/Screens/Import/FileImportScreen.cs
@@ -118,20 +118,20 @@ namespace osu.Game.Screens.Import
             fileSelector.CurrentPath.BindValueChanged(directoryChanged);
         }
 
-        public override void OnEntering(IScreen last)
+        public override void OnEntering(ScreenTransitionEvent e)
         {
-            base.OnEntering(last);
+            base.OnEntering(e);
 
             contentContainer.ScaleTo(0.95f).ScaleTo(1, duration, Easing.OutQuint);
             this.FadeInFromZero(duration);
         }
 
-        public override bool OnExiting(IScreen next)
+        public override bool OnExiting(ScreenExitEvent e)
         {
             contentContainer.ScaleTo(0.95f, duration, Easing.OutQuint);
             this.FadeOut(duration, Easing.OutQuint);
 
-            return base.OnExiting(next);
+            return base.OnExiting(e);
         }
 
         private void directoryChanged(ValueChangedEvent<DirectoryInfo> _)
diff --git a/osu.Game/Screens/Loader.cs b/osu.Game/Screens/Loader.cs
index a72ba89dfa..52e83c9e98 100644
--- a/osu.Game/Screens/Loader.cs
+++ b/osu.Game/Screens/Loader.cs
@@ -69,9 +69,9 @@ namespace osu.Game.Screens
 
         private EFToRealmMigrator realmMigrator;
 
-        public override void OnEntering(IScreen last)
+        public override void OnEntering(ScreenTransitionEvent e)
         {
-            base.OnEntering(last);
+            base.OnEntering(e);
 
             LoadComponentAsync(precompiler = CreateShaderPrecompiler(), AddInternal);
 
diff --git a/osu.Game/Screens/Menu/Disclaimer.cs b/osu.Game/Screens/Menu/Disclaimer.cs
index 22151db0dd..24412cd85e 100644
--- a/osu.Game/Screens/Menu/Disclaimer.cs
+++ b/osu.Game/Screens/Menu/Disclaimer.cs
@@ -171,9 +171,9 @@ namespace osu.Game.Screens.Menu
             ((IBindable<APIUser>)currentUser).BindTo(api.LocalUser);
         }
 
-        public override void OnEntering(IScreen last)
+        public override void OnEntering(ScreenTransitionEvent e)
         {
-            base.OnEntering(last);
+            base.OnEntering(e);
 
             icon.RotateTo(10);
             icon.FadeOut();
diff --git a/osu.Game/Screens/Menu/IntroCircles.cs b/osu.Game/Screens/Menu/IntroCircles.cs
index 2792d05f75..00e2de62f0 100644
--- a/osu.Game/Screens/Menu/IntroCircles.cs
+++ b/osu.Game/Screens/Menu/IntroCircles.cs
@@ -57,10 +57,10 @@ namespace osu.Game.Screens.Menu
             }
         }
 
-        public override void OnSuspending(IScreen next)
+        public override void OnSuspending(ScreenTransitionEvent e)
         {
             this.FadeOut(300);
-            base.OnSuspending(next);
+            base.OnSuspending(e);
         }
     }
 }
diff --git a/osu.Game/Screens/Menu/IntroScreen.cs b/osu.Game/Screens/Menu/IntroScreen.cs
index 5575d3681f..d4072d6202 100644
--- a/osu.Game/Screens/Menu/IntroScreen.cs
+++ b/osu.Game/Screens/Menu/IntroScreen.cs
@@ -164,9 +164,9 @@ namespace osu.Game.Screens.Menu
             }
         }
 
-        public override void OnEntering(IScreen last)
+        public override void OnEntering(ScreenTransitionEvent e)
         {
-            base.OnEntering(last);
+            base.OnEntering(e);
             ensureEventuallyArrivingAtMenu();
         }
 
@@ -194,7 +194,7 @@ namespace osu.Game.Screens.Menu
             }, 5000);
         }
 
-        public override void OnResuming(IScreen last)
+        public override void OnResuming(ScreenTransitionEvent e)
         {
             this.FadeIn(300);
 
@@ -237,12 +237,12 @@ namespace osu.Game.Screens.Menu
             //don't want to fade out completely else we will stop running updates.
             Game.FadeTo(0.01f, fadeOutTime).OnComplete(_ => this.Exit());
 
-            base.OnResuming(last);
+            base.OnResuming(e);
         }
 
-        public override void OnSuspending(IScreen next)
+        public override void OnSuspending(ScreenTransitionEvent e)
         {
-            base.OnSuspending(next);
+            base.OnSuspending(e);
             initialBeatmap = null;
         }
 
diff --git a/osu.Game/Screens/Menu/IntroTriangles.cs b/osu.Game/Screens/Menu/IntroTriangles.cs
index b6b6bf2ad7..ba8314f103 100644
--- a/osu.Game/Screens/Menu/IntroTriangles.cs
+++ b/osu.Game/Screens/Menu/IntroTriangles.cs
@@ -89,9 +89,9 @@ namespace osu.Game.Screens.Menu
             }
         }
 
-        public override void OnSuspending(IScreen next)
+        public override void OnSuspending(ScreenTransitionEvent e)
         {
-            base.OnSuspending(next);
+            base.OnSuspending(e);
 
             // ensure the background is shown, even if the TriangleIntroSequence failed to do so.
             background.ApplyToBackground(b => b.Show());
@@ -100,9 +100,9 @@ namespace osu.Game.Screens.Menu
             intro.Expire();
         }
 
-        public override void OnResuming(IScreen last)
+        public override void OnResuming(ScreenTransitionEvent e)
         {
-            base.OnResuming(last);
+            base.OnResuming(e);
             background.FadeOut(100);
         }
 
diff --git a/osu.Game/Screens/Menu/IntroWelcome.cs b/osu.Game/Screens/Menu/IntroWelcome.cs
index 27eaa7eb3a..9a6c949cad 100644
--- a/osu.Game/Screens/Menu/IntroWelcome.cs
+++ b/osu.Game/Screens/Menu/IntroWelcome.cs
@@ -106,9 +106,9 @@ namespace osu.Game.Screens.Menu
             }
         }
 
-        public override void OnResuming(IScreen last)
+        public override void OnResuming(ScreenTransitionEvent e)
         {
-            base.OnResuming(last);
+            base.OnResuming(e);
             background.FadeOut(100);
         }
 
diff --git a/osu.Game/Screens/Menu/MainMenu.cs b/osu.Game/Screens/Menu/MainMenu.cs
index 08df06816b..c9ce077695 100644
--- a/osu.Game/Screens/Menu/MainMenu.cs
+++ b/osu.Game/Screens/Menu/MainMenu.cs
@@ -176,12 +176,12 @@ namespace osu.Game.Screens.Menu
         [Resolved]
         private Storage storage { get; set; }
 
-        public override void OnEntering(IScreen last)
+        public override void OnEntering(ScreenTransitionEvent e)
         {
-            base.OnEntering(last);
+            base.OnEntering(e);
             buttons.FadeInFromZero(500);
 
-            if (last is IntroScreen && musicController.TrackLoaded)
+            if (e.Last is IntroScreen && musicController.TrackLoaded)
             {
                 var track = musicController.CurrentTrack;
 
@@ -249,9 +249,9 @@ namespace osu.Game.Screens.Menu
             seq.OnAbort(_ => buttons.SetOsuLogo(null));
         }
 
-        public override void OnSuspending(IScreen next)
+        public override void OnSuspending(ScreenTransitionEvent e)
         {
-            base.OnSuspending(next);
+            base.OnSuspending(e);
 
             buttons.State = ButtonSystemState.EnteringMode;
 
@@ -261,9 +261,9 @@ namespace osu.Game.Screens.Menu
             sideFlashes.FadeOut(64, Easing.OutQuint);
         }
 
-        public override void OnResuming(IScreen last)
+        public override void OnResuming(ScreenTransitionEvent e)
         {
-            base.OnResuming(last);
+            base.OnResuming(e);
 
             ApplyToBackground(b => (b as BackgroundScreenDefault)?.Next());
 
@@ -273,7 +273,7 @@ namespace osu.Game.Screens.Menu
             musicController.EnsurePlayingSomething();
         }
 
-        public override bool OnExiting(IScreen next)
+        public override bool OnExiting(ScreenExitEvent e)
         {
             if (!exitConfirmed && dialogOverlay != null)
             {
@@ -291,7 +291,7 @@ namespace osu.Game.Screens.Menu
             songTicker.Hide();
 
             this.FadeOut(3000);
-            return base.OnExiting(next);
+            return base.OnExiting(e);
         }
 
         public void PresentBeatmap(WorkingBeatmap beatmap, RulesetInfo ruleset)
diff --git a/osu.Game/Screens/OnlinePlay/Components/OnlinePlayBackgroundScreen.cs b/osu.Game/Screens/OnlinePlay/Components/OnlinePlayBackgroundScreen.cs
index 8906bebf0e..9e964de31e 100644
--- a/osu.Game/Screens/OnlinePlay/Components/OnlinePlayBackgroundScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Components/OnlinePlayBackgroundScreen.cs
@@ -91,15 +91,15 @@ namespace osu.Game.Screens.OnlinePlay.Components
             AddInternal(background = newBackground);
         }
 
-        public override void OnSuspending(IScreen next)
+        public override void OnSuspending(ScreenTransitionEvent e)
         {
-            base.OnSuspending(next);
+            base.OnSuspending(e);
             this.MoveToX(0, TRANSITION_LENGTH);
         }
 
-        public override bool OnExiting(IScreen next)
+        public override bool OnExiting(ScreenExitEvent e)
         {
-            bool result = base.OnExiting(next);
+            bool result = base.OnExiting(e);
             this.MoveToX(0);
             return result;
         }
diff --git a/osu.Game/Screens/OnlinePlay/Lounge/LoungeBackgroundScreen.cs b/osu.Game/Screens/OnlinePlay/Lounge/LoungeBackgroundScreen.cs
index 926c35c5da..52a902f5da 100644
--- a/osu.Game/Screens/OnlinePlay/Lounge/LoungeBackgroundScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Lounge/LoungeBackgroundScreen.cs
@@ -33,7 +33,7 @@ namespace osu.Game.Screens.OnlinePlay.Lounge
                 playlist.Clear();
         }
 
-        public override bool OnExiting(IScreen next)
+        public override bool OnExiting(ScreenExitEvent e)
         {
             // This screen never exits.
             return true;
diff --git a/osu.Game/Screens/OnlinePlay/Lounge/LoungeSubScreen.cs b/osu.Game/Screens/OnlinePlay/Lounge/LoungeSubScreen.cs
index a2d3b7f4fc..ec55ae79ce 100644
--- a/osu.Game/Screens/OnlinePlay/Lounge/LoungeSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Lounge/LoungeSubScreen.cs
@@ -238,15 +238,15 @@ namespace osu.Game.Screens.OnlinePlay.Lounge
 
         #endregion
 
-        public override void OnEntering(IScreen last)
+        public override void OnEntering(ScreenTransitionEvent e)
         {
-            base.OnEntering(last);
+            base.OnEntering(e);
             onReturning();
         }
 
-        public override void OnResuming(IScreen last)
+        public override void OnResuming(ScreenTransitionEvent e)
         {
-            base.OnResuming(last);
+            base.OnResuming(e);
 
             Debug.Assert(selectionLease != null);
 
@@ -261,16 +261,16 @@ namespace osu.Game.Screens.OnlinePlay.Lounge
             onReturning();
         }
 
-        public override bool OnExiting(IScreen next)
+        public override bool OnExiting(ScreenExitEvent e)
         {
             onLeaving();
-            return base.OnExiting(next);
+            return base.OnExiting(e);
         }
 
-        public override void OnSuspending(IScreen next)
+        public override void OnSuspending(ScreenTransitionEvent e)
         {
             onLeaving();
-            base.OnSuspending(next);
+            base.OnSuspending(e);
         }
 
         protected override void OnFocus(FocusEvent e)
diff --git a/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs b/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
index a382f65d84..cc1f842f8c 100644
--- a/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
@@ -290,35 +290,35 @@ namespace osu.Game.Screens.OnlinePlay.Match
 
         protected void ShowUserModSelect() => userModsSelectOverlay.Show();
 
-        public override void OnEntering(IScreen last)
+        public override void OnEntering(ScreenTransitionEvent e)
         {
-            base.OnEntering(last);
+            base.OnEntering(e);
             beginHandlingTrack();
         }
 
-        public override void OnSuspending(IScreen next)
+        public override void OnSuspending(ScreenTransitionEvent e)
         {
             endHandlingTrack();
-            base.OnSuspending(next);
+            base.OnSuspending(e);
         }
 
-        public override void OnResuming(IScreen last)
+        public override void OnResuming(ScreenTransitionEvent e)
         {
-            base.OnResuming(last);
+            base.OnResuming(e);
             updateWorkingBeatmap();
             beginHandlingTrack();
             Scheduler.AddOnce(UpdateMods);
             Scheduler.AddOnce(updateRuleset);
         }
 
-        public override bool OnExiting(IScreen next)
+        public override bool OnExiting(ScreenExitEvent e)
         {
             RoomManager?.PartRoom();
             Mods.Value = Array.Empty<Mod>();
 
             endHandlingTrack();
 
-            return base.OnExiting(next);
+            return base.OnExiting(e);
         }
 
         protected void StartPlay()
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Multiplayer.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Multiplayer.cs
index 2482d52492..66f6935bcc 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Multiplayer.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Multiplayer.cs
@@ -35,14 +35,14 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
                 transitionFromResults();
         }
 
-        public override void OnResuming(IScreen last)
+        public override void OnResuming(ScreenTransitionEvent e)
         {
-            base.OnResuming(last);
+            base.OnResuming(e);
 
             if (client.Room == null)
                 return;
 
-            if (!(last is MultiplayerPlayerLoader playerLoader))
+            if (!(e.Last is MultiplayerPlayerLoader playerLoader))
                 return;
 
             // If gameplay wasn't finished, then we have a simple path back to the idle state by aborting gameplay.
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerLoungeSubScreen.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerLoungeSubScreen.cs
index 5cdec52bc2..a05f248d3a 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerLoungeSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerLoungeSubScreen.cs
@@ -25,13 +25,13 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
         [Resolved]
         private MultiplayerClient client { get; set; }
 
-        public override void OnResuming(IScreen last)
+        public override void OnResuming(ScreenTransitionEvent e)
         {
-            base.OnResuming(last);
+            base.OnResuming(e);
 
             // Upon having left a room, we don't know whether we were the only participant, and whether the room is now closed as a result of leaving it.
             // To work around this, temporarily remove the room and trigger an immediate listing poll.
-            if (last is MultiplayerMatchSubScreen match)
+            if (e.Last is MultiplayerMatchSubScreen match)
             {
                 RoomManager.RemoveRoom(match.Room);
                 ListingPollingComponent.PollImmediately();
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
index 0dbf73fc5b..769873f74c 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
@@ -242,14 +242,14 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
 
         private bool exitConfirmed;
 
-        public override bool OnExiting(IScreen next)
+        public override bool OnExiting(ScreenExitEvent e)
         {
             // the room may not be left immediately after a disconnection due to async flow,
             // so checking the IsConnected status is also required.
             if (client.Room == null || !client.IsConnected.Value)
             {
                 // room has not been created yet; exit immediately.
-                return base.OnExiting(next);
+                return base.OnExiting(e);
             }
 
             if (!exitConfirmed && dialogOverlay != null)
@@ -268,7 +268,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
                 return true;
             }
 
-            return base.OnExiting(next);
+            return base.OnExiting(e);
         }
 
         private ModSettingChangeTracker modSettingChangeTracker;
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayerLoader.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayerLoader.cs
index 772651727e..53dea83f18 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayerLoader.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayerLoader.cs
@@ -18,10 +18,10 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
         {
         }
 
-        public override void OnSuspending(IScreen next)
+        public override void OnSuspending(ScreenTransitionEvent e)
         {
-            base.OnSuspending(next);
-            player = (Player)next;
+            base.OnSuspending(e);
+            player = (Player)e.Next;
         }
     }
 }
diff --git a/osu.Game/Screens/OnlinePlay/OnlinePlayScreen.cs b/osu.Game/Screens/OnlinePlay/OnlinePlayScreen.cs
index c56d04d5ac..ff4225e155 100644
--- a/osu.Game/Screens/OnlinePlay/OnlinePlayScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/OnlinePlayScreen.cs
@@ -110,7 +110,7 @@ namespace osu.Game.Screens.OnlinePlay
             }
         }
 
-        public override void OnEntering(IScreen last)
+        public override void OnEntering(ScreenTransitionEvent e)
         {
             this.FadeIn();
             waves.Show();
@@ -118,35 +118,35 @@ namespace osu.Game.Screens.OnlinePlay
             Mods.SetDefault();
 
             if (loungeSubScreen.IsCurrentScreen())
-                loungeSubScreen.OnEntering(last);
+                loungeSubScreen.OnEntering(e);
             else
                 loungeSubScreen.MakeCurrent();
         }
 
-        public override void OnResuming(IScreen last)
+        public override void OnResuming(ScreenTransitionEvent e)
         {
             this.FadeIn(250);
             this.ScaleTo(1, 250, Easing.OutSine);
 
             Debug.Assert(screenStack.CurrentScreen != null);
-            screenStack.CurrentScreen.OnResuming(last);
+            screenStack.CurrentScreen.OnResuming(e);
 
-            base.OnResuming(last);
+            base.OnResuming(e);
         }
 
-        public override void OnSuspending(IScreen next)
+        public override void OnSuspending(ScreenTransitionEvent e)
         {
             this.ScaleTo(1.1f, 250, Easing.InSine);
             this.FadeOut(250);
 
             Debug.Assert(screenStack.CurrentScreen != null);
-            screenStack.CurrentScreen.OnSuspending(next);
+            screenStack.CurrentScreen.OnSuspending(e);
         }
 
-        public override bool OnExiting(IScreen next)
+        public override bool OnExiting(ScreenExitEvent e)
         {
             var subScreen = screenStack.CurrentScreen as Drawable;
-            if (subScreen?.IsLoaded == true && screenStack.CurrentScreen.OnExiting(next))
+            if (subScreen?.IsLoaded == true && screenStack.CurrentScreen.OnExiting(e))
                 return true;
 
             RoomManager.PartRoom();
@@ -155,7 +155,7 @@ namespace osu.Game.Screens.OnlinePlay
 
             this.Delay(WaveContainer.DISAPPEAR_DURATION).FadeOut();
 
-            base.OnExiting(next);
+            base.OnExiting(e);
             return false;
         }
 
diff --git a/osu.Game/Screens/OnlinePlay/OnlinePlaySongSelect.cs b/osu.Game/Screens/OnlinePlay/OnlinePlaySongSelect.cs
index 7b64784316..6a559dbb2c 100644
--- a/osu.Game/Screens/OnlinePlay/OnlinePlaySongSelect.cs
+++ b/osu.Game/Screens/OnlinePlay/OnlinePlaySongSelect.cs
@@ -141,7 +141,7 @@ namespace osu.Game.Screens.OnlinePlay
             return base.OnBackButton();
         }
 
-        public override bool OnExiting(IScreen next)
+        public override bool OnExiting(ScreenExitEvent e)
         {
             if (!itemSelected)
             {
@@ -150,7 +150,7 @@ namespace osu.Game.Screens.OnlinePlay
                 Mods.Value = initialMods;
             }
 
-            return base.OnExiting(next);
+            return base.OnExiting(e);
         }
 
         protected override ModSelectOverlay CreateModSelectOverlay() => new UserModSelectOverlay
diff --git a/osu.Game/Screens/OnlinePlay/OnlinePlaySubScreen.cs b/osu.Game/Screens/OnlinePlay/OnlinePlaySubScreen.cs
index 3411c4afb1..07e0f60011 100644
--- a/osu.Game/Screens/OnlinePlay/OnlinePlaySubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/OnlinePlaySubScreen.cs
@@ -27,28 +27,28 @@ namespace osu.Game.Screens.OnlinePlay
 
         public const double DISAPPEAR_DURATION = 500;
 
-        public override void OnEntering(IScreen last)
+        public override void OnEntering(ScreenTransitionEvent e)
         {
-            base.OnEntering(last);
+            base.OnEntering(e);
             this.FadeInFromZero(APPEAR_DURATION, Easing.OutQuint);
         }
 
-        public override bool OnExiting(IScreen next)
+        public override bool OnExiting(ScreenExitEvent e)
         {
-            base.OnExiting(next);
+            base.OnExiting(e);
             this.FadeOut(DISAPPEAR_DURATION, Easing.OutQuint);
             return false;
         }
 
-        public override void OnResuming(IScreen last)
+        public override void OnResuming(ScreenTransitionEvent e)
         {
-            base.OnResuming(last);
+            base.OnResuming(e);
             this.FadeIn(APPEAR_DURATION, Easing.OutQuint);
         }
 
-        public override void OnSuspending(IScreen next)
+        public override void OnSuspending(ScreenTransitionEvent e)
         {
-            base.OnSuspending(next);
+            base.OnSuspending(e);
             this.FadeOut(DISAPPEAR_DURATION, Easing.OutQuint);
         }
 
diff --git a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsPlayer.cs b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsPlayer.cs
index 5a7762a3d8..5cba8676c5 100644
--- a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsPlayer.cs
+++ b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsPlayer.cs
@@ -45,9 +45,9 @@ namespace osu.Game.Screens.OnlinePlay.Playlists
                 throw new InvalidOperationException("Current Mods do not match PlaylistItem's RequiredMods");
         }
 
-        public override bool OnExiting(IScreen next)
+        public override bool OnExiting(ScreenExitEvent e)
         {
-            if (base.OnExiting(next))
+            if (base.OnExiting(e))
                 return true;
 
             Exited?.Invoke();
diff --git a/osu.Game/Screens/OsuScreen.cs b/osu.Game/Screens/OsuScreen.cs
index ed4901e1fa..4035d168e1 100644
--- a/osu.Game/Screens/OsuScreen.cs
+++ b/osu.Game/Screens/OsuScreen.cs
@@ -171,7 +171,7 @@ namespace osu.Game.Screens
             background.ApplyToBackground(action);
         }
 
-        public override void OnResuming(IScreen last)
+        public override void OnResuming(ScreenTransitionEvent e)
         {
             if (PlayResumeSound)
                 sampleExit?.Play();
@@ -183,19 +183,19 @@ namespace osu.Game.Screens
             if (trackAdjustmentStateAtSuspend != null)
                 musicController.AllowTrackAdjustments = trackAdjustmentStateAtSuspend.Value;
 
-            base.OnResuming(last);
+            base.OnResuming(e);
         }
 
-        public override void OnSuspending(IScreen next)
+        public override void OnSuspending(ScreenTransitionEvent e)
         {
-            base.OnSuspending(next);
+            base.OnSuspending(e);
 
             trackAdjustmentStateAtSuspend = musicController.AllowTrackAdjustments;
 
             onSuspendingLogo();
         }
 
-        public override void OnEntering(IScreen last)
+        public override void OnEntering(ScreenTransitionEvent e)
         {
             applyArrivingDefaults(false);
 
@@ -210,15 +210,15 @@ namespace osu.Game.Screens
             }
 
             background = backgroundStack?.CurrentScreen as BackgroundScreen;
-            base.OnEntering(last);
+            base.OnEntering(e);
         }
 
-        public override bool OnExiting(IScreen next)
+        public override bool OnExiting(ScreenExitEvent e)
         {
             if (ValidForResume && logo != null)
                 onExitingLogo();
 
-            if (base.OnExiting(next))
+            if (base.OnExiting(e))
                 return true;
 
             if (ownedBackground != null && backgroundStack?.CurrentScreen == ownedBackground)
diff --git a/osu.Game/Screens/Play/Player.cs b/osu.Game/Screens/Play/Player.cs
index f99b07c313..2d5a67758a 100644
--- a/osu.Game/Screens/Play/Player.cs
+++ b/osu.Game/Screens/Play/Player.cs
@@ -917,9 +917,9 @@ namespace osu.Game.Screens.Play
 
         #region Screen Logic
 
-        public override void OnEntering(IScreen last)
+        public override void OnEntering(ScreenTransitionEvent e)
         {
-            base.OnEntering(last);
+            base.OnEntering(e);
 
             if (!LoadedBeatmapSuccessfully)
                 return;
@@ -985,15 +985,15 @@ namespace osu.Game.Screens.Play
             GameplayClockContainer.Reset(true);
         }
 
-        public override void OnSuspending(IScreen next)
+        public override void OnSuspending(ScreenTransitionEvent e)
         {
             screenSuspension?.RemoveAndDisposeImmediately();
 
             fadeOut();
-            base.OnSuspending(next);
+            base.OnSuspending(e);
         }
 
-        public override bool OnExiting(IScreen next)
+        public override bool OnExiting(ScreenExitEvent e)
         {
             screenSuspension?.RemoveAndDisposeImmediately();
             failAnimationLayer?.RemoveFilters();
@@ -1024,7 +1024,7 @@ namespace osu.Game.Screens.Play
             musicController.ResetTrackAdjustments();
 
             fadeOut();
-            return base.OnExiting(next);
+            return base.OnExiting(e);
         }
 
         /// <summary>
diff --git a/osu.Game/Screens/Play/PlayerLoader.cs b/osu.Game/Screens/Play/PlayerLoader.cs
index aea39bc8ff..494ab51a10 100644
--- a/osu.Game/Screens/Play/PlayerLoader.cs
+++ b/osu.Game/Screens/Play/PlayerLoader.cs
@@ -210,9 +210,9 @@ namespace osu.Game.Screens.Play
 
         #region Screen handling
 
-        public override void OnEntering(IScreen last)
+        public override void OnEntering(ScreenTransitionEvent e)
         {
-            base.OnEntering(last);
+            base.OnEntering(e);
 
             ApplyToBackground(b =>
             {
@@ -236,9 +236,9 @@ namespace osu.Game.Screens.Play
             showBatteryWarningIfNeeded();
         }
 
-        public override void OnResuming(IScreen last)
+        public override void OnResuming(ScreenTransitionEvent e)
         {
-            base.OnResuming(last);
+            base.OnResuming(e);
 
             Debug.Assert(CurrentPlayer != null);
 
@@ -254,9 +254,9 @@ namespace osu.Game.Screens.Play
             contentIn();
         }
 
-        public override void OnSuspending(IScreen next)
+        public override void OnSuspending(ScreenTransitionEvent e)
         {
-            base.OnSuspending(next);
+            base.OnSuspending(e);
 
             BackgroundBrightnessReduction = false;
 
@@ -268,7 +268,7 @@ namespace osu.Game.Screens.Play
             highPassFilter.CutoffTo(0);
         }
 
-        public override bool OnExiting(IScreen next)
+        public override bool OnExiting(ScreenExitEvent e)
         {
             cancelLoad();
             ContentOut();
@@ -284,7 +284,7 @@ namespace osu.Game.Screens.Play
             BackgroundBrightnessReduction = false;
             Beatmap.Value.Track.RemoveAdjustment(AdjustableProperty.Volume, volumeAdjustment);
 
-            return base.OnExiting(next);
+            return base.OnExiting(e);
         }
 
         protected override void LogoArriving(OsuLogo logo, bool resuming)
diff --git a/osu.Game/Screens/Play/ReplayPlayerLoader.cs b/osu.Game/Screens/Play/ReplayPlayerLoader.cs
index 9eff4cb8fc..e78f700af2 100644
--- a/osu.Game/Screens/Play/ReplayPlayerLoader.cs
+++ b/osu.Game/Screens/Play/ReplayPlayerLoader.cs
@@ -20,13 +20,13 @@ namespace osu.Game.Screens.Play
             Score = score.ScoreInfo;
         }
 
-        public override void OnEntering(IScreen last)
+        public override void OnEntering(ScreenTransitionEvent e)
         {
             // these will be reverted thanks to PlayerLoader's lease.
             Mods.Value = Score.Mods;
             Ruleset.Value = Score.Ruleset;
 
-            base.OnEntering(last);
+            base.OnEntering(e);
         }
     }
 }
diff --git a/osu.Game/Screens/Play/SoloSpectator.cs b/osu.Game/Screens/Play/SoloSpectator.cs
index a0b07fcbd9..202527f308 100644
--- a/osu.Game/Screens/Play/SoloSpectator.cs
+++ b/osu.Game/Screens/Play/SoloSpectator.cs
@@ -249,10 +249,10 @@ namespace osu.Game.Screens.Play
             beatmapDownloader.Download(beatmapSet);
         }
 
-        public override bool OnExiting(IScreen next)
+        public override bool OnExiting(ScreenExitEvent e)
         {
             previewTrackManager.StopAnyPlaying(this);
-            return base.OnExiting(next);
+            return base.OnExiting(e);
         }
     }
 }
diff --git a/osu.Game/Screens/Play/SoloSpectatorPlayer.cs b/osu.Game/Screens/Play/SoloSpectatorPlayer.cs
index 969a5bf2b4..5b601083c2 100644
--- a/osu.Game/Screens/Play/SoloSpectatorPlayer.cs
+++ b/osu.Game/Screens/Play/SoloSpectatorPlayer.cs
@@ -24,11 +24,11 @@ namespace osu.Game.Screens.Play
             SpectatorClient.OnUserBeganPlaying += userBeganPlaying;
         }
 
-        public override bool OnExiting(IScreen next)
+        public override bool OnExiting(ScreenExitEvent e)
         {
             SpectatorClient.OnUserBeganPlaying -= userBeganPlaying;
 
-            return base.OnExiting(next);
+            return base.OnExiting(e);
         }
 
         private void userBeganPlaying(int userId, SpectatorState state)
diff --git a/osu.Game/Screens/Play/SpectatorPlayer.cs b/osu.Game/Screens/Play/SpectatorPlayer.cs
index c0682952c3..09bec9b89f 100644
--- a/osu.Game/Screens/Play/SpectatorPlayer.cs
+++ b/osu.Game/Screens/Play/SpectatorPlayer.cs
@@ -91,11 +91,11 @@ namespace osu.Game.Screens.Play
             DrawableRuleset?.SetReplayScore(score);
         }
 
-        public override bool OnExiting(IScreen next)
+        public override bool OnExiting(ScreenExitEvent e)
         {
             SpectatorClient.OnNewFrames -= userSentFrames;
 
-            return base.OnExiting(next);
+            return base.OnExiting(e);
         }
 
         protected override void Dispose(bool isDisposing)
diff --git a/osu.Game/Screens/Play/SpectatorPlayerLoader.cs b/osu.Game/Screens/Play/SpectatorPlayerLoader.cs
index 10cc36c9a9..9ca5475ee4 100644
--- a/osu.Game/Screens/Play/SpectatorPlayerLoader.cs
+++ b/osu.Game/Screens/Play/SpectatorPlayerLoader.cs
@@ -20,13 +20,13 @@ namespace osu.Game.Screens.Play
             Score = score.ScoreInfo;
         }
 
-        public override void OnEntering(IScreen last)
+        public override void OnEntering(ScreenTransitionEvent e)
         {
             // these will be reverted thanks to PlayerLoader's lease.
             Mods.Value = Score.Mods;
             Ruleset.Value = Score.Ruleset;
 
-            base.OnEntering(last);
+            base.OnEntering(e);
         }
     }
 }
diff --git a/osu.Game/Screens/Play/SubmittingPlayer.cs b/osu.Game/Screens/Play/SubmittingPlayer.cs
index b1f2bccddf..b62dc1e5a6 100644
--- a/osu.Game/Screens/Play/SubmittingPlayer.cs
+++ b/osu.Game/Screens/Play/SubmittingPlayer.cs
@@ -115,9 +115,9 @@ namespace osu.Game.Screens.Play
             await submitScore(score).ConfigureAwait(false);
         }
 
-        public override bool OnExiting(IScreen next)
+        public override bool OnExiting(ScreenExitEvent e)
         {
-            bool exiting = base.OnExiting(next);
+            bool exiting = base.OnExiting(e);
 
             if (LoadedBeatmapSuccessfully)
                 submitScore(Score.DeepClone());
diff --git a/osu.Game/Screens/Ranking/ResultsScreen.cs b/osu.Game/Screens/Ranking/ResultsScreen.cs
index cb842ce4a0..98514cd846 100644
--- a/osu.Game/Screens/Ranking/ResultsScreen.cs
+++ b/osu.Game/Screens/Ranking/ResultsScreen.cs
@@ -231,9 +231,9 @@ namespace osu.Game.Screens.Ranking
             lastFetchCompleted = true;
         });
 
-        public override void OnEntering(IScreen last)
+        public override void OnEntering(ScreenTransitionEvent e)
         {
-            base.OnEntering(last);
+            base.OnEntering(e);
 
             ApplyToBackground(b =>
             {
@@ -244,9 +244,9 @@ namespace osu.Game.Screens.Ranking
             bottomPanel.FadeTo(1, 250);
         }
 
-        public override bool OnExiting(IScreen next)
+        public override bool OnExiting(ScreenExitEvent e)
         {
-            if (base.OnExiting(next))
+            if (base.OnExiting(e))
                 return true;
 
             this.FadeOut(100);
diff --git a/osu.Game/Screens/ScreenWhiteBox.cs b/osu.Game/Screens/ScreenWhiteBox.cs
index 8b38b67f5c..3a9e7b8f18 100644
--- a/osu.Game/Screens/ScreenWhiteBox.cs
+++ b/osu.Game/Screens/ScreenWhiteBox.cs
@@ -28,25 +28,25 @@ namespace osu.Game.Screens
 
         protected override BackgroundScreen CreateBackground() => new BackgroundScreenCustom(@"Backgrounds/bg2");
 
-        public override bool OnExiting(IScreen next)
+        public override bool OnExiting(ScreenExitEvent e)
         {
             message.TextContainer.MoveTo(new Vector2(DrawSize.X / 16, 0), transition_time, Easing.OutExpo);
             this.FadeOut(transition_time, Easing.OutExpo);
 
-            return base.OnExiting(next);
+            return base.OnExiting(e);
         }
 
-        public override void OnSuspending(IScreen next)
+        public override void OnSuspending(ScreenTransitionEvent e)
         {
-            base.OnSuspending(next);
+            base.OnSuspending(e);
 
             message.TextContainer.MoveTo(new Vector2(-(DrawSize.X / 16), 0), transition_time, Easing.OutExpo);
             this.FadeOut(transition_time, Easing.OutExpo);
         }
 
-        public override void OnResuming(IScreen last)
+        public override void OnResuming(ScreenTransitionEvent e)
         {
-            base.OnResuming(last);
+            base.OnResuming(e);
 
             message.TextContainer.MoveTo(Vector2.Zero, transition_time, Easing.OutExpo);
             this.FadeIn(transition_time, Easing.OutExpo);
diff --git a/osu.Game/Screens/Select/PlaySongSelect.cs b/osu.Game/Screens/Select/PlaySongSelect.cs
index 4a991ffc66..ec8b2e029a 100644
--- a/osu.Game/Screens/Select/PlaySongSelect.cs
+++ b/osu.Game/Screens/Select/PlaySongSelect.cs
@@ -109,9 +109,9 @@ namespace osu.Game.Screens.Select
             }
         }
 
-        public override void OnResuming(IScreen last)
+        public override void OnResuming(ScreenTransitionEvent e)
         {
-            base.OnResuming(last);
+            base.OnResuming(e);
 
             if (playerLoader != null)
             {
diff --git a/osu.Game/Screens/Select/SongSelect.cs b/osu.Game/Screens/Select/SongSelect.cs
index dc505063d1..928978cd08 100644
--- a/osu.Game/Screens/Select/SongSelect.cs
+++ b/osu.Game/Screens/Select/SongSelect.cs
@@ -543,9 +543,9 @@ namespace osu.Game.Screens.Select
             }
         }
 
-        public override void OnEntering(IScreen last)
+        public override void OnEntering(ScreenTransitionEvent e)
         {
-            base.OnEntering(last);
+            base.OnEntering(e);
 
             this.FadeInFromZero(250);
             FilterControl.Activate();
@@ -591,9 +591,9 @@ namespace osu.Game.Screens.Select
             logo.FadeOut(logo_transition / 2, Easing.Out);
         }
 
-        public override void OnResuming(IScreen last)
+        public override void OnResuming(ScreenTransitionEvent e)
         {
-            base.OnResuming(last);
+            base.OnResuming(e);
 
             // required due to https://github.com/ppy/osu-framework/issues/3218
             ModSelect.SelectedMods.Disabled = false;
@@ -622,7 +622,7 @@ namespace osu.Game.Screens.Select
             FilterControl.Activate();
         }
 
-        public override void OnSuspending(IScreen next)
+        public override void OnSuspending(ScreenTransitionEvent e)
         {
             // Handle the case where FinaliseSelection is never called (ie. when a screen is pushed externally).
             // Without this, it's possible for a transfer to happen while we are not the current screen.
@@ -640,12 +640,12 @@ namespace osu.Game.Screens.Select
             this.FadeOut(250);
 
             FilterControl.Deactivate();
-            base.OnSuspending(next);
+            base.OnSuspending(e);
         }
 
-        public override bool OnExiting(IScreen next)
+        public override bool OnExiting(ScreenExitEvent e)
         {
-            if (base.OnExiting(next))
+            if (base.OnExiting(e))
                 return true;
 
             beatmapInfoWedge.Hide();
diff --git a/osu.Game/Tests/Visual/EditorTestScene.cs b/osu.Game/Tests/Visual/EditorTestScene.cs
index ca12bc73fe..46f31ae53b 100644
--- a/osu.Game/Tests/Visual/EditorTestScene.cs
+++ b/osu.Game/Tests/Visual/EditorTestScene.cs
@@ -118,7 +118,7 @@ namespace osu.Game.Tests.Visual
 
             public new bool HasUnsavedChanges => base.HasUnsavedChanges;
 
-            public override bool OnExiting(IScreen next)
+            public override bool OnExiting(ScreenExitEvent e)
             {
                 // For testing purposes allow the screen to exit without saving on second attempt.
                 if (!ExitConfirmed && dialogOverlay?.CurrentDialog is PromptForSaveDialog saveDialog)
@@ -127,7 +127,7 @@ namespace osu.Game.Tests.Visual
                     return true;
                 }
 
-                return base.OnExiting(next);
+                return base.OnExiting(e);
             }
 
             public TestEditor(EditorLoader loader = null)

From 749b86f0f41c7bed292d3eff81b40ceaf5b20fc4 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 22 Apr 2022 00:48:41 +0900
Subject: [PATCH 4226/5547] Use new framework exposed event instead of schedule

---
 osu.Game/Overlays/SettingsPanel.cs | 11 +++--------
 1 file changed, 3 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Overlays/SettingsPanel.cs b/osu.Game/Overlays/SettingsPanel.cs
index 7cf233a061..a5a6f9bce7 100644
--- a/osu.Game/Overlays/SettingsPanel.cs
+++ b/osu.Game/Overlays/SettingsPanel.cs
@@ -284,14 +284,7 @@ namespace osu.Game.Overlays
             public string SearchTerm
             {
                 get => SearchContainer.SearchTerm;
-                set
-                {
-                    SearchContainer.SearchTerm = value;
-
-                    // Schedule required as search term takes a frame to update.
-                    // Without this sections may not be in the correct state to ascertain CurrentSection.
-                    Schedule(InvalidateScrollPosition);
-                }
+                set => SearchContainer.SearchTerm = value;
             }
 
             protected override FlowContainer<SettingsSection> CreateScrollContentContainer()
@@ -310,6 +303,8 @@ namespace osu.Game.Overlays
                     Colour = colourProvider.Background4,
                     RelativeSizeAxes = Axes.Both
                 };
+
+                SearchContainer.FilterCompleted += InvalidateScrollPosition;
             }
 
             protected override void UpdateAfterChildren()

From 574007c07a15efd125bfa6c7076428747fe89e54 Mon Sep 17 00:00:00 2001
From: 63411 <62799417+molneya@users.noreply.github.com>
Date: Fri, 22 Apr 2022 02:02:23 +0800
Subject: [PATCH 4227/5547] Optimise holdAddition calculation

---
 osu.Game.Rulesets.Mania/Difficulty/Skills/Strain.cs | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Mania/Difficulty/Skills/Strain.cs b/osu.Game.Rulesets.Mania/Difficulty/Skills/Strain.cs
index d5d5d5751d..04d1329eec 100644
--- a/osu.Game.Rulesets.Mania/Difficulty/Skills/Strain.cs
+++ b/osu.Game.Rulesets.Mania/Difficulty/Skills/Strain.cs
@@ -62,7 +62,9 @@ namespace osu.Game.Rulesets.Mania.Difficulty.Skills
             holdEndTimes[column] = endTime;
 
             // The hold addition only is valid if there is _no_ other note with the same ending. Releasing multiple notes at the same time is just as easy as releasing 1
-            holdAddition *= 1 / (1 + Math.Exp(0.5 * (24 - closestEndTime)));
+            // Nerfs the hold addition by half if the closest release is 24ms away
+            if (holdAddition > 0)
+                holdAddition *= 1 / (1 + Math.Exp(0.5 * (24 - closestEndTime)));
 
             // Increase individual strain in own column
             individualStrains[column] += 2.0 * holdFactor;

From 8fe4443029420bf4d1df46eda7c3a73b4018279a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 21 Apr 2022 22:29:23 +0200
Subject: [PATCH 4228/5547] Update screen method signatures to match framework
 API changes

---
 .../FirstRunSetup/FirstRunSetupScreen.cs         | 16 ++++++++--------
 osu.Game/Overlays/FirstRunSetup/ScreenUIScale.cs |  4 ++--
 2 files changed, 10 insertions(+), 10 deletions(-)

diff --git a/osu.Game/Overlays/FirstRunSetup/FirstRunSetupScreen.cs b/osu.Game/Overlays/FirstRunSetup/FirstRunSetupScreen.cs
index b2284a999d..eb4b97069c 100644
--- a/osu.Game/Overlays/FirstRunSetup/FirstRunSetupScreen.cs
+++ b/osu.Game/Overlays/FirstRunSetup/FirstRunSetupScreen.cs
@@ -33,39 +33,39 @@ namespace osu.Game.Overlays.FirstRunSetup
             };
         }
 
-        public override void OnEntering(IScreen last)
+        public override void OnEntering(ScreenTransitionEvent e)
         {
-            base.OnEntering(last);
+            base.OnEntering(e);
             this
                 .FadeInFromZero(500)
                 .MoveToX(offset)
                 .MoveToX(0, 500, Easing.OutQuint);
         }
 
-        public override void OnResuming(IScreen last)
+        public override void OnResuming(ScreenTransitionEvent e)
         {
-            base.OnResuming(last);
+            base.OnResuming(e);
             this
                 .FadeInFromZero(500)
                 .MoveToX(0, 500, Easing.OutQuint);
         }
 
-        public override bool OnExiting(IScreen next)
+        public override bool OnExiting(ScreenExitEvent e)
         {
             this
                 .FadeOut(100)
                 .MoveToX(offset, 500, Easing.OutQuint);
 
-            return base.OnExiting(next);
+            return base.OnExiting(e);
         }
 
-        public override void OnSuspending(IScreen next)
+        public override void OnSuspending(ScreenTransitionEvent e)
         {
             this
                 .FadeOut(100)
                 .MoveToX(-offset, 500, Easing.OutQuint);
 
-            base.OnSuspending(next);
+            base.OnSuspending(e);
         }
     }
 }
diff --git a/osu.Game/Overlays/FirstRunSetup/ScreenUIScale.cs b/osu.Game/Overlays/FirstRunSetup/ScreenUIScale.cs
index e632170975..d9a612ea26 100644
--- a/osu.Game/Overlays/FirstRunSetup/ScreenUIScale.cs
+++ b/osu.Game/Overlays/FirstRunSetup/ScreenUIScale.cs
@@ -97,9 +97,9 @@ namespace osu.Game.Overlays.FirstRunSetup
 
         private class PinnedMainMenu : MainMenu
         {
-            public override void OnEntering(IScreen last)
+            public override void OnEntering(ScreenTransitionEvent e)
             {
-                base.OnEntering(last);
+                base.OnEntering(e);
 
                 Buttons.ReturnToTopOnIdle = false;
                 Buttons.State = ButtonSystemState.TopLevel;

From 32722adba90c3b0f3da0a80438693cff8d39c1fa Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 20 Apr 2022 22:59:37 +0200
Subject: [PATCH 4229/5547] Allow mod panels to be clicked in incompatible
 state

---
 .../Mods/IncompatibilityDisplayingModPanel.cs | 39 ++-----------------
 osu.Game/Overlays/Mods/ModPanel.cs            | 20 ++++++----
 2 files changed, 16 insertions(+), 43 deletions(-)

diff --git a/osu.Game/Overlays/Mods/IncompatibilityDisplayingModPanel.cs b/osu.Game/Overlays/Mods/IncompatibilityDisplayingModPanel.cs
index 38781455fa..aeb983d352 100644
--- a/osu.Game/Overlays/Mods/IncompatibilityDisplayingModPanel.cs
+++ b/osu.Game/Overlays/Mods/IncompatibilityDisplayingModPanel.cs
@@ -1,15 +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 System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
-using osu.Framework.Graphics.Colour;
 using osu.Framework.Graphics.Cursor;
-using osu.Framework.Input.Events;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Utils;
 
@@ -42,41 +39,13 @@ namespace osu.Game.Overlays.Mods
                                  && !ModUtils.CheckCompatibleSet(selectedMods.Value.Append(Mod));
         }
 
+        protected override Colour4 BackgroundColour => incompatible.Value ? (Colour4)ColourProvider.Background6 : base.BackgroundColour;
+        protected override Colour4 ForegroundColour => incompatible.Value ? (Colour4)ColourProvider.Background5 : base.ForegroundColour;
+
         protected override void UpdateState()
         {
-            Action = incompatible.Value ? () => { } : (Action)Active.Toggle;
-
-            if (incompatible.Value)
-            {
-                Colour4 backgroundColour = ColourProvider.Background6;
-                Colour4 textBackgroundColour = ColourProvider.Background5;
-
-                Content.TransformTo(nameof(BorderColour), ColourInfo.GradientVertical(backgroundColour, textBackgroundColour), TRANSITION_DURATION, Easing.OutQuint);
-                Background.FadeColour(backgroundColour, TRANSITION_DURATION, Easing.OutQuint);
-
-                SwitchContainer.ResizeWidthTo(IDLE_SWITCH_WIDTH, TRANSITION_DURATION, Easing.OutQuint);
-                SwitchContainer.FadeColour(Colour4.Gray, TRANSITION_DURATION, Easing.OutQuint);
-                MainContentContainer.TransformTo(nameof(Padding), new MarginPadding
-                {
-                    Left = IDLE_SWITCH_WIDTH,
-                    Right = CORNER_RADIUS
-                }, TRANSITION_DURATION, Easing.OutQuint);
-
-                TextBackground.FadeColour(textBackgroundColour, TRANSITION_DURATION, Easing.OutQuint);
-                TextFlow.FadeColour(Colour4.White.Opacity(0.5f), TRANSITION_DURATION, Easing.OutQuint);
-                return;
-            }
-
-            SwitchContainer.FadeColour(Colour4.White, TRANSITION_DURATION, Easing.OutQuint);
             base.UpdateState();
-        }
-
-        protected override bool OnMouseDown(MouseDownEvent e)
-        {
-            if (incompatible.Value)
-                return true; // bypasses base call purposely in order to not play out the intermediate state animation.
-
-            return base.OnMouseDown(e);
+            SwitchContainer.FadeColour(incompatible.Value ? Colour4.Gray : Colour4.White, TRANSITION_DURATION, Easing.OutQuint);
         }
 
         #region IHasCustomTooltip
diff --git a/osu.Game/Overlays/Mods/ModPanel.cs b/osu.Game/Overlays/Mods/ModPanel.cs
index 7ae325bde7..f2a97da3b2 100644
--- a/osu.Game/Overlays/Mods/ModPanel.cs
+++ b/osu.Game/Overlays/Mods/ModPanel.cs
@@ -203,20 +203,24 @@ namespace osu.Game.Overlays.Mods
             base.OnMouseUp(e);
         }
 
+        protected virtual Colour4 BackgroundColour => Active.Value ? activeColour.Darken(0.3f) : (Colour4)ColourProvider.Background3;
+        protected virtual Colour4 ForegroundColour => Active.Value ? activeColour : (Colour4)ColourProvider.Background2;
+        protected virtual Colour4 TextColour => Active.Value ? (Colour4)ColourProvider.Background6 : Colour4.White;
+
         protected virtual void UpdateState()
         {
             float targetWidth = Active.Value ? EXPANDED_SWITCH_WIDTH : IDLE_SWITCH_WIDTH;
             double transitionDuration = TRANSITION_DURATION;
 
-            Colour4 textBackgroundColour = Active.Value ? activeColour : (Colour4)ColourProvider.Background2;
-            Colour4 mainBackgroundColour = Active.Value ? activeColour.Darken(0.3f) : (Colour4)ColourProvider.Background3;
-            Colour4 textColour = Active.Value ? (Colour4)ColourProvider.Background6 : Colour4.White;
+            Colour4 backgroundColour = BackgroundColour;
+            Colour4 foregroundColour = ForegroundColour;
+            Colour4 textColour = TextColour;
 
             // Hover affects colour of button background
             if (IsHovered)
             {
-                textBackgroundColour = textBackgroundColour.Lighten(0.1f);
-                mainBackgroundColour = mainBackgroundColour.Lighten(0.1f);
+                backgroundColour = backgroundColour.Lighten(0.1f);
+                foregroundColour = foregroundColour.Lighten(0.1f);
             }
 
             // Mouse down adds a halfway tween of the movement
@@ -226,15 +230,15 @@ namespace osu.Game.Overlays.Mods
                 transitionDuration *= 4;
             }
 
-            Content.TransformTo(nameof(BorderColour), ColourInfo.GradientVertical(mainBackgroundColour, textBackgroundColour), transitionDuration, Easing.OutQuint);
-            Background.FadeColour(mainBackgroundColour, transitionDuration, Easing.OutQuint);
+            Content.TransformTo(nameof(BorderColour), ColourInfo.GradientVertical(backgroundColour, foregroundColour), transitionDuration, Easing.OutQuint);
+            Background.FadeColour(backgroundColour, transitionDuration, Easing.OutQuint);
             SwitchContainer.ResizeWidthTo(targetWidth, transitionDuration, Easing.OutQuint);
             MainContentContainer.TransformTo(nameof(Padding), new MarginPadding
             {
                 Left = targetWidth,
                 Right = CORNER_RADIUS
             }, transitionDuration, Easing.OutQuint);
-            TextBackground.FadeColour(textBackgroundColour, transitionDuration, Easing.OutQuint);
+            TextBackground.FadeColour(foregroundColour, transitionDuration, Easing.OutQuint);
             TextFlow.FadeColour(textColour, transitionDuration, Easing.OutQuint);
         }
 

From b7c11cdb8e2736df2ec96e187bb2adb549507276 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 20 Apr 2022 23:34:43 +0200
Subject: [PATCH 4230/5547] Deselect old incompatible mods if any on user mod
 select screen

---
 osu.Game/Overlays/Mods/ModSelectScreen.cs     | 27 ++++++++++---------
 osu.Game/Overlays/Mods/UserModSelectScreen.cs | 21 +++++++++++++++
 2 files changed, 36 insertions(+), 12 deletions(-)

diff --git a/osu.Game/Overlays/Mods/ModSelectScreen.cs b/osu.Game/Overlays/Mods/ModSelectScreen.cs
index 693c85fafc..8a83071109 100644
--- a/osu.Game/Overlays/Mods/ModSelectScreen.cs
+++ b/osu.Game/Overlays/Mods/ModSelectScreen.cs
@@ -168,7 +168,7 @@ namespace osu.Game.Overlays.Mods
 
             foreach (var column in columnFlow)
             {
-                column.SelectedMods.BindValueChanged(_ => updateBindableFromSelection());
+                column.SelectedMods.BindValueChanged(updateBindableFromSelection);
             }
 
             customisationVisible.BindValueChanged(_ => updateCustomisationVisualState(), true);
@@ -237,33 +237,36 @@ namespace osu.Game.Overlays.Mods
             TopLevelContent.MoveToY(-modAreaHeight, transition_duration, Easing.InOutCubic);
         }
 
-        private bool selectionBindableSyncInProgress;
-
         private void updateSelectionFromBindable()
         {
-            if (selectionBindableSyncInProgress)
-                return;
-
-            selectionBindableSyncInProgress = true;
-
+            // note that selectionBindableSyncInProgress is purposefully not checked here.
+            // this is because in the case of mod selection in solo gameplay, a user selection of a mod can actually lead to deselection of other incompatible mods.
+            // to synchronise state correctly, updateBindableFromSelection() computes the final mods (including incompatibility rules) and updates SelectedMods,
+            // and this method then runs unconditionally again to make sure the new visual selection accurately reflects the final set of selected mods.
+            // selectionBindableSyncInProgress ensures that mutual infinite recursion does not happen after that unconditional call.
             foreach (var column in columnFlow)
                 column.SelectedMods.Value = SelectedMods.Value.Where(mod => mod.Type == column.ModType).ToArray();
-
-            selectionBindableSyncInProgress = false;
         }
 
-        private void updateBindableFromSelection()
+        private bool selectionBindableSyncInProgress;
+
+        private void updateBindableFromSelection(ValueChangedEvent<IReadOnlyList<Mod>> modSelectionChange)
         {
             if (selectionBindableSyncInProgress)
                 return;
 
             selectionBindableSyncInProgress = true;
 
-            SelectedMods.Value = columnFlow.SelectMany(column => column.SelectedMods.Value).ToArray();
+            SelectedMods.Value = ComputeNewModsFromSelection(
+                modSelectionChange.NewValue.Except(modSelectionChange.OldValue),
+                modSelectionChange.OldValue.Except(modSelectionChange.NewValue));
 
             selectionBindableSyncInProgress = false;
         }
 
+        protected virtual IReadOnlyList<Mod> ComputeNewModsFromSelection(IEnumerable<Mod> addedMods, IEnumerable<Mod> removedMods)
+            => columnFlow.SelectMany(column => column.SelectedMods.Value).ToArray();
+
         protected override void PopIn()
         {
             const double fade_in_duration = 400;
diff --git a/osu.Game/Overlays/Mods/UserModSelectScreen.cs b/osu.Game/Overlays/Mods/UserModSelectScreen.cs
index 81943da514..ed0a07521b 100644
--- a/osu.Game/Overlays/Mods/UserModSelectScreen.cs
+++ b/osu.Game/Overlays/Mods/UserModSelectScreen.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 System.Collections.Generic;
+using System.Linq;
 using JetBrains.Annotations;
 using osu.Game.Rulesets.Mods;
+using osu.Game.Utils;
 using osuTK.Input;
 
 namespace osu.Game.Overlays.Mods
@@ -11,6 +14,24 @@ namespace osu.Game.Overlays.Mods
     {
         protected override ModColumn CreateModColumn(ModType modType, Key[] toggleKeys = null) => new UserModColumn(modType, false, toggleKeys);
 
+        protected override IReadOnlyList<Mod> ComputeNewModsFromSelection(IEnumerable<Mod> addedMods, IEnumerable<Mod> removedMods)
+        {
+            IEnumerable<Mod> modsAfterRemoval = SelectedMods.Value.Except(removedMods).ToList();
+
+            // the preference is that all new mods should override potential incompatible old mods.
+            // in general that's a bit difficult to compute if more than one mod is added at a time,
+            // so be conservative and just remove all mods that aren't compatible with any one added mod.
+            foreach (var addedMod in addedMods)
+            {
+                if (!ModUtils.CheckCompatibleSet(modsAfterRemoval.Append(addedMod), out var invalidMods))
+                    modsAfterRemoval = modsAfterRemoval.Except(invalidMods);
+
+                modsAfterRemoval = modsAfterRemoval.Append(addedMod).ToList();
+            }
+
+            return modsAfterRemoval.ToList();
+        }
+
         private class UserModColumn : ModColumn
         {
             public UserModColumn(ModType modType, bool allowBulkSelection, [CanBeNull] Key[] toggleKeys = null)

From cd898344cb60663f0c300cd524c2d8e16d3d984c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 21 Apr 2022 23:49:40 +0200
Subject: [PATCH 4231/5547] Add test coverage of new incompatibility behaviour

---
 .../UserInterface/TestSceneModSelectScreen.cs | 25 +++++++++++++++++++
 1 file changed, 25 insertions(+)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs
index 4a738cb29d..514538161e 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.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.Allocation;
@@ -89,6 +90,27 @@ namespace osu.Game.Tests.Visual.UserInterface
             changeRuleset(3);
         }
 
+        [Test]
+        public void TestIncompatibilityToggling()
+        {
+            createScreen();
+            changeRuleset(0);
+
+            AddStep("activate DT", () => getPanelForMod(typeof(OsuModDoubleTime)).TriggerClick());
+            AddAssert("DT active", () => SelectedMods.Value.Single().GetType() == typeof(OsuModDoubleTime));
+
+            AddStep("activate NC", () => getPanelForMod(typeof(OsuModNightcore)).TriggerClick());
+            AddAssert("only NC active", () => SelectedMods.Value.Single().GetType() == typeof(OsuModNightcore));
+
+            AddStep("activate HR", () => getPanelForMod(typeof(OsuModHardRock)).TriggerClick());
+            AddAssert("NC+HR active", () => SelectedMods.Value.Any(mod => mod.GetType() == typeof(OsuModNightcore))
+                                            && SelectedMods.Value.Any(mod => mod.GetType() == typeof(OsuModHardRock)));
+
+            AddStep("activate MR", () => getPanelForMod(typeof(OsuModMirror)).TriggerClick());
+            AddAssert("NC+MR active", () => SelectedMods.Value.Any(mod => mod.GetType() == typeof(OsuModNightcore))
+                                            && SelectedMods.Value.Any(mod => mod.GetType() == typeof(OsuModMirror)));
+        }
+
         [Test]
         public void TestCustomisationToggleState()
         {
@@ -136,5 +158,8 @@ namespace osu.Game.Tests.Visual.UserInterface
             AddAssert($"customisation toggle is {(disabled ? "" : "not ")}disabled", () => getToggle().Active.Disabled == disabled);
             AddAssert($"customisation toggle is {(active ? "" : "not ")}active", () => getToggle().Active.Value == active);
         }
+
+        private ModPanel getPanelForMod(Type modType)
+            => modSelectScreen.ChildrenOfType<ModPanel>().Single(panel => panel.Mod.GetType() == modType);
     }
 }

From e9bd87545e47af17f8226f3850b906a147217883 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 22 Apr 2022 00:07:00 +0200
Subject: [PATCH 4232/5547] Fix flaky test in free mod select test scene

---
 .../Visual/Multiplayer/TestSceneFreeModSelectScreen.cs       | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneFreeModSelectScreen.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneFreeModSelectScreen.cs
index 0db05e3a6a..b5f901e51d 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneFreeModSelectScreen.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneFreeModSelectScreen.cs
@@ -21,8 +21,11 @@ namespace osu.Game.Tests.Visual.Multiplayer
             {
                 State = { Value = Visibility.Visible }
             });
+            AddUntilStep("all column content loaded",
+                () => freeModSelectScreen.ChildrenOfType<ModColumn>().Any()
+                      && freeModSelectScreen.ChildrenOfType<ModColumn>().All(column => column.IsLoaded && column.ItemsLoaded));
 
-            AddAssert("all visible mods are playable",
+            AddUntilStep("all visible mods are playable",
                 () => this.ChildrenOfType<ModPanel>()
                           .Where(panel => panel.IsPresent)
                           .All(panel => panel.Mod.HasImplementation && panel.Mod.UserPlayable));

From a9ea0ab91b962e10806ea14698064b13e4d617d0 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 22 Apr 2022 07:55:39 +0300
Subject: [PATCH 4233/5547] Add support for fetching user guest participations

---
 osu.Game/Online/API/Requests/GetUserBeatmapsRequest.cs         | 1 +
 osu.Game/Online/API/Requests/Responses/APIUser.cs              | 3 +++
 .../Profile/Sections/Beatmaps/PaginatedBeatmapContainer.cs     | 3 +++
 3 files changed, 7 insertions(+)

diff --git a/osu.Game/Online/API/Requests/GetUserBeatmapsRequest.cs b/osu.Game/Online/API/Requests/GetUserBeatmapsRequest.cs
index ffb3a3be9b..205fdc9f2b 100644
--- a/osu.Game/Online/API/Requests/GetUserBeatmapsRequest.cs
+++ b/osu.Game/Online/API/Requests/GetUserBeatmapsRequest.cs
@@ -29,6 +29,7 @@ namespace osu.Game.Online.API.Requests
         Ranked,
         Loved,
         Pending,
+        Guest,
         Graveyard
     }
 }
diff --git a/osu.Game/Online/API/Requests/Responses/APIUser.cs b/osu.Game/Online/API/Requests/Responses/APIUser.cs
index a87f0811a1..41f486c709 100644
--- a/osu.Game/Online/API/Requests/Responses/APIUser.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIUser.cs
@@ -148,6 +148,9 @@ namespace osu.Game.Online.API.Requests.Responses
         [JsonProperty(@"pending_beatmapset_count")]
         public int PendingBeatmapsetCount;
 
+        [JsonProperty(@"guest_beatmapset_count")]
+        public int GuestBeatmapsetCount;
+
         [JsonProperty(@"scores_best_count")]
         public int ScoresBestCount;
 
diff --git a/osu.Game/Overlays/Profile/Sections/Beatmaps/PaginatedBeatmapContainer.cs b/osu.Game/Overlays/Profile/Sections/Beatmaps/PaginatedBeatmapContainer.cs
index 0424fe8bd9..8224cd5eb5 100644
--- a/osu.Game/Overlays/Profile/Sections/Beatmaps/PaginatedBeatmapContainer.cs
+++ b/osu.Game/Overlays/Profile/Sections/Beatmaps/PaginatedBeatmapContainer.cs
@@ -53,6 +53,9 @@ namespace osu.Game.Overlays.Profile.Sections.Beatmaps
                 case BeatmapSetType.Pending:
                     return user.PendingBeatmapsetCount;
 
+                case BeatmapSetType.Guest:
+                    return user.GuestBeatmapsetCount;
+
                 default:
                     return 0;
             }

From 2c21bd89e74a6f8330f23d2d98b64a4138f510b8 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 22 Apr 2022 07:56:01 +0300
Subject: [PATCH 4234/5547] Display beatmap guest participations in user
 profile

---
 osu.Game/Overlays/Profile/Sections/BeatmapsSection.cs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Game/Overlays/Profile/Sections/BeatmapsSection.cs b/osu.Game/Overlays/Profile/Sections/BeatmapsSection.cs
index af6ab4aad1..64e5f3e52e 100644
--- a/osu.Game/Overlays/Profile/Sections/BeatmapsSection.cs
+++ b/osu.Game/Overlays/Profile/Sections/BeatmapsSection.cs
@@ -22,6 +22,7 @@ namespace osu.Game.Overlays.Profile.Sections
                 new PaginatedBeatmapContainer(BeatmapSetType.Ranked, User, UsersStrings.ShowExtraBeatmapsRankedTitle),
                 new PaginatedBeatmapContainer(BeatmapSetType.Loved, User, UsersStrings.ShowExtraBeatmapsLovedTitle),
                 new PaginatedBeatmapContainer(BeatmapSetType.Pending, User, UsersStrings.ShowExtraBeatmapsPendingTitle),
+                new PaginatedBeatmapContainer(BeatmapSetType.Guest, User, "Guest Participation Beatmaps"),
                 new PaginatedBeatmapContainer(BeatmapSetType.Graveyard, User, UsersStrings.ShowExtraBeatmapsGraveyardTitle)
             };
         }

From 97b4a2a105c26c4a6b56eabec85b4e0df2c424a3 Mon Sep 17 00:00:00 2001
From: 63411 <62799417+molneya@users.noreply.github.com>
Date: Fri, 22 Apr 2022 12:59:00 +0800
Subject: [PATCH 4235/5547] Use better initial value for closestEndTime

---
 osu.Game.Rulesets.Mania/Difficulty/Skills/Strain.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Mania/Difficulty/Skills/Strain.cs b/osu.Game.Rulesets.Mania/Difficulty/Skills/Strain.cs
index 04d1329eec..f295af5f4d 100644
--- a/osu.Game.Rulesets.Mania/Difficulty/Skills/Strain.cs
+++ b/osu.Game.Rulesets.Mania/Difficulty/Skills/Strain.cs
@@ -37,7 +37,7 @@ namespace osu.Game.Rulesets.Mania.Difficulty.Skills
             var maniaCurrent = (ManiaDifficultyHitObject)current;
             double endTime = maniaCurrent.EndTime;
             int column = maniaCurrent.BaseObject.Column;
-            double closestEndTime = 100;
+            double closestEndTime = endTime - maniaCurrent.LastObject.StartTime; // Lowest value we can assume with the current information
 
             double holdFactor = 1.0; // Factor to all additional strains in case something else is held
             double holdAddition = 0; // Addition to the current note in case it's a hold and has to be released awkwardly

From 56bbfa58e5cb08c499e6806a91725a5c186abafc Mon Sep 17 00:00:00 2001
From: 63411 <62799417+molneya@users.noreply.github.com>
Date: Fri, 22 Apr 2022 13:01:41 +0800
Subject: [PATCH 4236/5547] Add missing absolute value of closestEndTime

---
 osu.Game.Rulesets.Mania/Difficulty/Skills/Strain.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Mania/Difficulty/Skills/Strain.cs b/osu.Game.Rulesets.Mania/Difficulty/Skills/Strain.cs
index f295af5f4d..ba964a4edd 100644
--- a/osu.Game.Rulesets.Mania/Difficulty/Skills/Strain.cs
+++ b/osu.Game.Rulesets.Mania/Difficulty/Skills/Strain.cs
@@ -37,7 +37,7 @@ namespace osu.Game.Rulesets.Mania.Difficulty.Skills
             var maniaCurrent = (ManiaDifficultyHitObject)current;
             double endTime = maniaCurrent.EndTime;
             int column = maniaCurrent.BaseObject.Column;
-            double closestEndTime = endTime - maniaCurrent.LastObject.StartTime; // Lowest value we can assume with the current information
+            double closestEndTime = Math.Abs(endTime - maniaCurrent.LastObject.StartTime); // Lowest value we can assume with the current information
 
             double holdFactor = 1.0; // Factor to all additional strains in case something else is held
             double holdAddition = 0; // Addition to the current note in case it's a hold and has to be released awkwardly

From 8b55d3855a7112bab2e41fad4c62fc17916d5fb8 Mon Sep 17 00:00:00 2001
From: 63411 <62799417+molneya@users.noreply.github.com>
Date: Fri, 22 Apr 2022 13:27:59 +0800
Subject: [PATCH 4237/5547] Use isOverlapping bool to determine holdAddition

---
 .../Difficulty/Skills/Strain.cs                    | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/osu.Game.Rulesets.Mania/Difficulty/Skills/Strain.cs b/osu.Game.Rulesets.Mania/Difficulty/Skills/Strain.cs
index ba964a4edd..a5b9675836 100644
--- a/osu.Game.Rulesets.Mania/Difficulty/Skills/Strain.cs
+++ b/osu.Game.Rulesets.Mania/Difficulty/Skills/Strain.cs
@@ -41,13 +41,13 @@ namespace osu.Game.Rulesets.Mania.Difficulty.Skills
 
             double holdFactor = 1.0; // Factor to all additional strains in case something else is held
             double holdAddition = 0; // Addition to the current note in case it's a hold and has to be released awkwardly
+            bool isOverlapping = false;
 
             // Fill up the holdEndTimes array
             for (int i = 0; i < holdEndTimes.Length; ++i)
             {
-                // If there is at least one other overlapping end or note, then we get an addition
-                if (Precision.DefinitelyBigger(holdEndTimes[i], maniaCurrent.StartTime, 1) && Precision.DefinitelyBigger(endTime, holdEndTimes[i], 1))
-                    holdAddition = 1.0;
+                // The current note is overlapped if a previous note or end is overlapping the current note body
+                isOverlapping |= Precision.DefinitelyBigger(holdEndTimes[i], maniaCurrent.StartTime, 1) && Precision.DefinitelyBigger(endTime, holdEndTimes[i], 1);
 
                 // We give a slight bonus to everything if something is held meanwhile
                 if (Precision.DefinitelyBigger(holdEndTimes[i], endTime, 1))
@@ -61,10 +61,10 @@ namespace osu.Game.Rulesets.Mania.Difficulty.Skills
 
             holdEndTimes[column] = endTime;
 
-            // The hold addition only is valid if there is _no_ other note with the same ending. Releasing multiple notes at the same time is just as easy as releasing 1
-            // Nerfs the hold addition by half if the closest release is 24ms away
-            if (holdAddition > 0)
-                holdAddition *= 1 / (1 + Math.Exp(0.5 * (24 - closestEndTime)));
+            // The hold addition is given if there was an overlap, however it is only valid if there are no other note with a similar ending.
+            // Releasing multiple notes is just as easy as releasing 1. Nerfs the hold addition by half if the closest release is 24ms away.
+            if (isOverlapping)
+                holdAddition = 1 / (1 + Math.Exp(0.5 * (24 - closestEndTime)));
 
             // Increase individual strain in own column
             individualStrains[column] += 2.0 * holdFactor;

From 893a95df408fce4c3a0b280d248c9008670b6f18 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 22 Apr 2022 09:17:30 +0300
Subject: [PATCH 4238/5547] Update resources

---
 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 6b06305bf9..8d79eb94a8 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -51,7 +51,7 @@
     <Reference Include="Java.Interop" />
   </ItemGroup>
   <ItemGroup>
-    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.417.0" />
+    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.422.0" />
     <PackageReference Include="ppy.osu.Framework.Android" Version="2022.421.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index c57acb3b7f..c6c18f6061 100644
--- a/osu.Game/osu.Game.csproj
+++ b/osu.Game/osu.Game.csproj
@@ -36,7 +36,7 @@
     </PackageReference>
     <PackageReference Include="Realm" Version="10.10.0" />
     <PackageReference Include="ppy.osu.Framework" Version="2022.421.0" />
-    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.417.0" />
+    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.422.0" />
     <PackageReference Include="Sentry" Version="3.14.1" />
     <PackageReference Include="SharpCompress" Version="0.30.1" />
     <PackageReference Include="NUnit" Version="3.13.2" />
diff --git a/osu.iOS.props b/osu.iOS.props
index d7f89b802b..64af0d70f3 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -62,7 +62,7 @@
   </ItemGroup>
   <ItemGroup Label="Package References">
     <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.421.0" />
-    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.417.0" />
+    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.422.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net6.0) -->
   <PropertyGroup>

From 40d823bf693da2a1af210b7b0e5f3d3218f7b717 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 22 Apr 2022 09:18:42 +0300
Subject: [PATCH 4239/5547] Use localised string for guest participation
 beatmaps header

---
 osu.Game/Overlays/Profile/Sections/BeatmapsSection.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/Profile/Sections/BeatmapsSection.cs b/osu.Game/Overlays/Profile/Sections/BeatmapsSection.cs
index 64e5f3e52e..4db00df1b5 100644
--- a/osu.Game/Overlays/Profile/Sections/BeatmapsSection.cs
+++ b/osu.Game/Overlays/Profile/Sections/BeatmapsSection.cs
@@ -22,7 +22,7 @@ namespace osu.Game.Overlays.Profile.Sections
                 new PaginatedBeatmapContainer(BeatmapSetType.Ranked, User, UsersStrings.ShowExtraBeatmapsRankedTitle),
                 new PaginatedBeatmapContainer(BeatmapSetType.Loved, User, UsersStrings.ShowExtraBeatmapsLovedTitle),
                 new PaginatedBeatmapContainer(BeatmapSetType.Pending, User, UsersStrings.ShowExtraBeatmapsPendingTitle),
-                new PaginatedBeatmapContainer(BeatmapSetType.Guest, User, "Guest Participation Beatmaps"),
+                new PaginatedBeatmapContainer(BeatmapSetType.Guest, User, UsersStrings.ShowExtraBeatmapsGuestTitle),
                 new PaginatedBeatmapContainer(BeatmapSetType.Graveyard, User, UsersStrings.ShowExtraBeatmapsGraveyardTitle)
             };
         }

From 82a1d1cc2eab41622c5b69a2867a0a25521e97f0 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 22 Apr 2022 15:22:58 +0900
Subject: [PATCH 4240/5547] Fix multiplier display not blocking input

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

diff --git a/osu.Game/Overlays/Mods/DifficultyMultiplierDisplay.cs b/osu.Game/Overlays/Mods/DifficultyMultiplierDisplay.cs
index 66fd6a202d..1d848fe456 100644
--- a/osu.Game/Overlays/Mods/DifficultyMultiplierDisplay.cs
+++ b/osu.Game/Overlays/Mods/DifficultyMultiplierDisplay.cs
@@ -52,7 +52,7 @@ namespace osu.Game.Overlays.Mods
             Height = HEIGHT;
             AutoSizeAxes = Axes.X;
 
-            InternalChild = new Container
+            InternalChild = new InputBlockingContainer
             {
                 RelativeSizeAxes = Axes.Y,
                 AutoSizeAxes = Axes.X,

From 33d516eecb0b11541c733de1797b9706c8c69763 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 22 Apr 2022 09:28:27 +0300
Subject: [PATCH 4241/5547] Move guest participation beatmap up to below loved

---
 osu.Game/Overlays/Profile/Sections/BeatmapsSection.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/Profile/Sections/BeatmapsSection.cs b/osu.Game/Overlays/Profile/Sections/BeatmapsSection.cs
index 4db00df1b5..6b93c24a78 100644
--- a/osu.Game/Overlays/Profile/Sections/BeatmapsSection.cs
+++ b/osu.Game/Overlays/Profile/Sections/BeatmapsSection.cs
@@ -21,8 +21,8 @@ namespace osu.Game.Overlays.Profile.Sections
                 new PaginatedBeatmapContainer(BeatmapSetType.Favourite, User, UsersStrings.ShowExtraBeatmapsFavouriteTitle),
                 new PaginatedBeatmapContainer(BeatmapSetType.Ranked, User, UsersStrings.ShowExtraBeatmapsRankedTitle),
                 new PaginatedBeatmapContainer(BeatmapSetType.Loved, User, UsersStrings.ShowExtraBeatmapsLovedTitle),
-                new PaginatedBeatmapContainer(BeatmapSetType.Pending, User, UsersStrings.ShowExtraBeatmapsPendingTitle),
                 new PaginatedBeatmapContainer(BeatmapSetType.Guest, User, UsersStrings.ShowExtraBeatmapsGuestTitle),
+                new PaginatedBeatmapContainer(BeatmapSetType.Pending, User, UsersStrings.ShowExtraBeatmapsPendingTitle),
                 new PaginatedBeatmapContainer(BeatmapSetType.Graveyard, User, UsersStrings.ShowExtraBeatmapsGraveyardTitle)
             };
         }

From 06594ca0c8aa9635f3403db0575f322ad0c34d59 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 22 Apr 2022 15:30:12 +0900
Subject: [PATCH 4242/5547] Refine assertion to ensure correct section is
 current, rather than any section

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

diff --git a/osu.Game.Tests/Visual/Settings/TestSceneSettingsPanel.cs b/osu.Game.Tests/Visual/Settings/TestSceneSettingsPanel.cs
index 8d91b55877..cdeaafd828 100644
--- a/osu.Game.Tests/Visual/Settings/TestSceneSettingsPanel.cs
+++ b/osu.Game.Tests/Visual/Settings/TestSceneSettingsPanel.cs
@@ -55,7 +55,7 @@ namespace osu.Game.Tests.Visual.Settings
                                                                                 .All(f => f.FilterTerms.Any(t => t.Contains("scaling")))
                                                                      ));
 
-            AddAssert("ensure section is current", () => settings.CurrentSection.Value != null);
+            AddAssert("ensure section is current", () => settings.CurrentSection.Value is GraphicsSection);
         }
 
         [Test]

From f282e5b0133785d8c9e6474cbe04bf5c79dc4811 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 22 Apr 2022 15:32:23 +0900
Subject: [PATCH 4243/5547] Remove one more unnecessary schedule

---
 osu.Game/Graphics/Containers/SectionsContainer.cs | 7 ++-----
 1 file changed, 2 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Graphics/Containers/SectionsContainer.cs b/osu.Game/Graphics/Containers/SectionsContainer.cs
index 540ca85809..823ba33216 100644
--- a/osu.Game/Graphics/Containers/SectionsContainer.cs
+++ b/osu.Game/Graphics/Containers/SectionsContainer.cs
@@ -195,11 +195,8 @@ namespace osu.Game.Graphics.Containers
 
         protected void InvalidateScrollPosition()
         {
-            Schedule(() =>
-            {
-                lastKnownScroll = null;
-                lastClickedSection = null;
-            });
+            lastKnownScroll = null;
+            lastClickedSection = null;
         }
 
         protected override void UpdateAfterChildren()

From c44f7d9f93c83c74eb25b30c73247506cc474766 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 22 Apr 2022 15:56:03 +0900
Subject: [PATCH 4244/5547] Fix high star ratings not being easily visible on
 tooltips

Resolves issue mentioned in https://github.com/ppy/osu/discussions/17920.
---
 .../Drawables/DifficultyIconTooltip.cs        | 59 +++++--------------
 1 file changed, 15 insertions(+), 44 deletions(-)

diff --git a/osu.Game/Beatmaps/Drawables/DifficultyIconTooltip.cs b/osu.Game/Beatmaps/Drawables/DifficultyIconTooltip.cs
index aba01a1294..5479644772 100644
--- a/osu.Game/Beatmaps/Drawables/DifficultyIconTooltip.cs
+++ b/osu.Game/Beatmaps/Drawables/DifficultyIconTooltip.cs
@@ -7,7 +7,6 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Cursor;
 using osu.Framework.Graphics.Shapes;
-using osu.Framework.Graphics.Sprites;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
 using osuTK;
@@ -16,11 +15,11 @@ namespace osu.Game.Beatmaps.Drawables
 {
     internal class DifficultyIconTooltip : VisibilityContainer, ITooltip<DifficultyIconTooltipContent>
     {
-        private readonly OsuSpriteText difficultyName, starRating;
-        private readonly Box background;
-        private readonly FillFlowContainer difficultyFlow;
+        private OsuSpriteText difficultyName;
+        private StarRatingDisplay starRating;
 
-        public DifficultyIconTooltip()
+        [BackgroundDependencyLoader]
+        private void load(OsuColour colours)
         {
             AutoSizeAxes = Axes.Both;
             Masking = true;
@@ -28,9 +27,10 @@ namespace osu.Game.Beatmaps.Drawables
 
             Children = new Drawable[]
             {
-                background = new Box
+                new Box
                 {
                     Alpha = 0.9f,
+                    Colour = colours.Gray3,
                     RelativeSizeAxes = Axes.Both
                 },
                 new FillFlowContainer
@@ -40,6 +40,7 @@ namespace osu.Game.Beatmaps.Drawables
                     AutoSizeEasing = Easing.OutQuint,
                     Direction = FillDirection.Vertical,
                     Padding = new MarginPadding(10),
+                    Spacing = new Vector2(5),
                     Children = new Drawable[]
                     {
                         difficultyName = new OsuSpriteText
@@ -48,57 +49,27 @@ namespace osu.Game.Beatmaps.Drawables
                             Origin = Anchor.Centre,
                             Font = OsuFont.GetFont(size: 16, weight: FontWeight.Bold),
                         },
-                        difficultyFlow = new FillFlowContainer
+                        starRating = new StarRatingDisplay(default, StarRatingDisplaySize.Small)
                         {
-                            AutoSizeAxes = Axes.Both,
                             Anchor = Anchor.Centre,
                             Origin = Anchor.Centre,
-                            Direction = FillDirection.Horizontal,
-                            Children = new Drawable[]
-                            {
-                                starRating = new OsuSpriteText
-                                {
-                                    Anchor = Anchor.Centre,
-                                    Origin = Anchor.Centre,
-                                    Font = OsuFont.GetFont(size: 16, weight: FontWeight.Regular),
-                                },
-                                new SpriteIcon
-                                {
-                                    Anchor = Anchor.Centre,
-                                    Origin = Anchor.Centre,
-                                    Margin = new MarginPadding { Left = 4 },
-                                    Icon = FontAwesome.Solid.Star,
-                                    Size = new Vector2(12),
-                                },
-                            }
                         }
                     }
                 }
             };
         }
 
-        [Resolved]
-        private OsuColour colours { get; set; }
-
-        [BackgroundDependencyLoader]
-        private void load()
-        {
-            background.Colour = colours.Gray3;
-        }
-
-        private readonly IBindable<StarDifficulty> starDifficulty = new Bindable<StarDifficulty>();
+        private DifficultyIconTooltipContent displayedContent;
 
         public void SetContent(DifficultyIconTooltipContent content)
         {
-            difficultyName.Text = content.BeatmapInfo.DifficultyName;
+            if (displayedContent != null)
+                starRating.Current.UnbindFrom(displayedContent.Difficulty);
 
-            starDifficulty.UnbindAll();
-            starDifficulty.BindTo(content.Difficulty);
-            starDifficulty.BindValueChanged(difficulty =>
-            {
-                starRating.Text = $"{difficulty.NewValue.Stars:0.##}";
-                difficultyFlow.Colour = colours.ForStarDifficulty(difficulty.NewValue.Stars);
-            }, true);
+            displayedContent = content;
+
+            starRating.Current.BindTarget = displayedContent.Difficulty;
+            difficultyName.Text = displayedContent.BeatmapInfo.DifficultyName;
         }
 
         public void Move(Vector2 pos) => Position = pos;

From 14e17c8b7b4892c8485ff907a6790d1d5b041708 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 22 Apr 2022 16:22:12 +0900
Subject: [PATCH 4245/5547] Update `TestIncompatibilityDisplay` in line with
 new functionality

---
 .../Visual/UserInterface/TestSceneModPanel.cs | 25 +++++++++++--------
 1 file changed, 15 insertions(+), 10 deletions(-)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneModPanel.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneModPanel.cs
index 95323e5dfa..f56d9c8a91 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneModPanel.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneModPanel.cs
@@ -47,12 +47,22 @@ namespace osu.Game.Tests.Visual.UserInterface
         {
             IncompatibilityDisplayingModPanel panel = null;
 
-            AddStep("create panel with DT", () => Child = panel = new IncompatibilityDisplayingModPanel(new OsuModDoubleTime())
+            AddStep("create panel with DT", () =>
             {
-                Anchor = Anchor.Centre,
-                Origin = Anchor.Centre,
-                RelativeSizeAxes = Axes.None,
-                Width = 300
+                Child = panel = new IncompatibilityDisplayingModPanel(new OsuModDoubleTime())
+                {
+                    Anchor = Anchor.Centre,
+                    Origin = Anchor.Centre,
+                    RelativeSizeAxes = Axes.None,
+                    Width = 300,
+                };
+
+                panel.Active.BindValueChanged(active =>
+                {
+                    SelectedMods.Value = active.NewValue
+                        ? Array.Empty<Mod>()
+                        : new[] { panel.Mod };
+                });
             });
 
             clickPanel();
@@ -63,11 +73,6 @@ namespace osu.Game.Tests.Visual.UserInterface
 
             AddStep("set incompatible mod", () => SelectedMods.Value = new[] { new OsuModHalfTime() });
 
-            clickPanel();
-            AddAssert("panel not active", () => !panel.Active.Value);
-
-            AddStep("reset mods", () => SelectedMods.Value = Array.Empty<Mod>());
-
             clickPanel();
             AddAssert("panel active", () => panel.Active.Value);
 

From 7258a097489655632d89def6cdbac09cd54f3d3a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 22 Apr 2022 18:04:07 +0900
Subject: [PATCH 4246/5547] Allow `SettingsSection`s to exit without a parent
 `SettingsPanel`

---
 osu.Game/Overlays/Settings/SettingsSection.cs | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Overlays/Settings/SettingsSection.cs b/osu.Game/Overlays/Settings/SettingsSection.cs
index 28c42a0e47..dc3af9104f 100644
--- a/osu.Game/Overlays/Settings/SettingsSection.cs
+++ b/osu.Game/Overlays/Settings/SettingsSection.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;
@@ -44,7 +45,7 @@ namespace osu.Game.Overlays.Settings
 
         public bool FilteringActive { get; set; }
 
-        [Resolved]
+        [Resolved(canBeNull: true)]
         private SettingsPanel settingsPanel { get; set; }
 
         protected SettingsSection()
@@ -117,7 +118,7 @@ namespace osu.Game.Overlays.Settings
                 },
             });
 
-            selectedSection = settingsPanel.CurrentSection.GetBoundCopy();
+            selectedSection = settingsPanel?.CurrentSection.GetBoundCopy() ?? new Bindable<SettingsSection>(this);
             selectedSection.BindValueChanged(_ => updateContentFade(), true);
         }
 
@@ -138,7 +139,10 @@ namespace osu.Game.Overlays.Settings
         protected override bool OnClick(ClickEvent e)
         {
             if (!isCurrentSection)
+            {
+                Debug.Assert(settingsPanel != null);
                 settingsPanel.SectionsContainer.ScrollTo(this);
+            }
 
             return base.OnClick(e);
         }

From 2a043aa6de7ae64990a6069e7cb0402d4e8f06fd Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 22 Apr 2022 18:04:43 +0900
Subject: [PATCH 4247/5547] Add a method of finding and applying settings with
 classic default value

---
 osu.Game/Overlays/Settings/ISettingsItem.cs |  6 ++++
 osu.Game/Overlays/Settings/SettingsItem.cs  | 36 ++++++++++++++++++++-
 2 files changed, 41 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/Settings/ISettingsItem.cs b/osu.Game/Overlays/Settings/ISettingsItem.cs
index e7afa48502..e6b1e68741 100644
--- a/osu.Game/Overlays/Settings/ISettingsItem.cs
+++ b/osu.Game/Overlays/Settings/ISettingsItem.cs
@@ -9,5 +9,11 @@ namespace osu.Game.Overlays.Settings
     public interface ISettingsItem : IDrawable, IDisposable
     {
         event Action SettingChanged;
+
+        /// <summary>
+        /// Apply the default values of a setting item, if the setting item specifies a "classic" default via <see cref="SettingsItem{T}.ApplyClassicDefault"/>.
+        /// </summary>
+        /// <param name="useClassicDefault">Whether to apply the classic value. If <c>false</c>, the standard default is applied.</param>
+        void ApplyClassicDefault(bool useClassicDefault);
     }
 }
diff --git a/osu.Game/Overlays/Settings/SettingsItem.cs b/osu.Game/Overlays/Settings/SettingsItem.cs
index 1c5668479f..845a7f5cdf 100644
--- a/osu.Game/Overlays/Settings/SettingsItem.cs
+++ b/osu.Game/Overlays/Settings/SettingsItem.cs
@@ -30,6 +30,8 @@ namespace osu.Game.Overlays.Settings
         /// </summary>
         public object SettingSourceObject { get; internal set; }
 
+        public const string CLASSIC_DEFAULT_SEARCH_TERM = @"has-classic-default";
+
         private IHasCurrentValue<T> controlWithCurrent => Control as IHasCurrentValue<T>;
 
         protected override Container<Drawable> Content => FlowContent;
@@ -96,7 +98,23 @@ namespace osu.Game.Overlays.Settings
             set => controlWithCurrent.Current = value;
         }
 
-        public virtual IEnumerable<string> FilterTerms => Keywords == null ? new[] { LabelText.ToString() } : new List<string>(Keywords) { LabelText.ToString() }.ToArray();
+        public virtual IEnumerable<string> FilterTerms
+        {
+            get
+            {
+                var keywords = new List<string>(Keywords ?? Array.Empty<string>())
+                {
+                    LabelText.ToString()
+                };
+
+                if (GetClassicDefault != null)
+                {
+                    keywords.Add(CLASSIC_DEFAULT_SEARCH_TERM);
+                }
+
+                return keywords;
+            }
+        }
 
         public IEnumerable<string> Keywords { get; set; }
 
@@ -108,6 +126,22 @@ namespace osu.Game.Overlays.Settings
 
         public event Action SettingChanged;
 
+        /// <summary>
+        /// An action which when invoked will apply a classic default value to this setting.
+        /// </summary>
+        public Func<T> GetClassicDefault { get; set; }
+
+        public void ApplyClassicDefault(bool useClassicDefault)
+        {
+            if (GetClassicDefault != null)
+            {
+                if (useClassicDefault)
+                    Current.Value = GetClassicDefault();
+                else
+                    Current.SetDefault();
+            }
+        }
+
         protected SettingsItem()
         {
             RelativeSizeAxes = Axes.X;

From e0b9ab022de2f610b294a53c065ae07d4e81f999 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 22 Apr 2022 18:05:24 +0900
Subject: [PATCH 4248/5547] Add classic default values against setting controls

---
 osu.Game.Rulesets.Osu/UI/OsuSettingsSubsection.cs                | 1 +
 osu.Game/Overlays/Settings/Sections/Gameplay/GeneralSettings.cs  | 1 +
 .../Overlays/Settings/Sections/UserInterface/GeneralSettings.cs  | 1 +
 3 files changed, 3 insertions(+)

diff --git a/osu.Game.Rulesets.Osu/UI/OsuSettingsSubsection.cs b/osu.Game.Rulesets.Osu/UI/OsuSettingsSubsection.cs
index a4c0381d16..33db74c530 100644
--- a/osu.Game.Rulesets.Osu/UI/OsuSettingsSubsection.cs
+++ b/osu.Game.Rulesets.Osu/UI/OsuSettingsSubsection.cs
@@ -33,6 +33,7 @@ namespace osu.Game.Rulesets.Osu.UI
                 },
                 new SettingsCheckbox
                 {
+                    GetClassicDefault = () => false,
                     LabelText = "Snaking out sliders",
                     Current = config.GetBindable<bool>(OsuRulesetSetting.SnakingOutSliders)
                 },
diff --git a/osu.Game/Overlays/Settings/Sections/Gameplay/GeneralSettings.cs b/osu.Game/Overlays/Settings/Sections/Gameplay/GeneralSettings.cs
index d4e4fd571d..3ca677ef7b 100644
--- a/osu.Game/Overlays/Settings/Sections/Gameplay/GeneralSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Gameplay/GeneralSettings.cs
@@ -21,6 +21,7 @@ namespace osu.Game.Overlays.Settings.Sections.Gameplay
             {
                 new SettingsEnumDropdown<ScoringMode>
                 {
+                    GetClassicDefault = () => ScoringMode.Classic,
                     LabelText = GameplaySettingsStrings.ScoreDisplayMode,
                     Current = config.GetBindable<ScoringMode>(OsuSetting.ScoreDisplayMode),
                     Keywords = new[] { "scoring" }
diff --git a/osu.Game/Overlays/Settings/Sections/UserInterface/GeneralSettings.cs b/osu.Game/Overlays/Settings/Sections/UserInterface/GeneralSettings.cs
index 6e1558f7d7..06f2c9794c 100644
--- a/osu.Game/Overlays/Settings/Sections/UserInterface/GeneralSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/UserInterface/GeneralSettings.cs
@@ -37,6 +37,7 @@ namespace osu.Game.Overlays.Settings.Sections.UserInterface
                 },
                 new SettingsSlider<double, TimeSlider>
                 {
+                    GetClassicDefault = () => 0,
                     LabelText = UserInterfaceStrings.HoldToConfirmActivationTime,
                     Current = config.GetBindable<double>(OsuSetting.UIHoldActivationDelay),
                     Keywords = new[] { @"delay" },

From 1caee3876802ca5ac8aa81c9bb932f8a558192ad Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 22 Apr 2022 18:05:52 +0900
Subject: [PATCH 4249/5547] Add first-run "behaviour" screen to allow users a
 choice of more familiar UX

---
 .../TestSceneFirstRunScreenBehaviour.cs       |  19 ++++
 .../FirstRunSetupOverlayStrings.cs            |  28 ++++-
 .../Overlays/FirstRunSetup/ScreenBehaviour.cs | 104 ++++++++++++++++++
 osu.Game/Overlays/FirstRunSetupOverlay.cs     |   1 +
 4 files changed, 151 insertions(+), 1 deletion(-)
 create mode 100644 osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunScreenBehaviour.cs
 create mode 100644 osu.Game/Overlays/FirstRunSetup/ScreenBehaviour.cs

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunScreenBehaviour.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunScreenBehaviour.cs
new file mode 100644
index 0000000000..d7f0c5ba03
--- /dev/null
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunScreenBehaviour.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.Screens;
+using osu.Game.Overlays.FirstRunSetup;
+
+namespace osu.Game.Tests.Visual.UserInterface
+{
+    public class TestSceneFirstRunScreenBehaviour : OsuManualInputManagerTestScene
+    {
+        public TestSceneFirstRunScreenBehaviour()
+        {
+            AddStep("load screen", () =>
+            {
+                Child = new ScreenStack(new ScreenBehaviour());
+            });
+        }
+    }
+}
diff --git a/osu.Game/Localisation/FirstRunSetupOverlayStrings.cs b/osu.Game/Localisation/FirstRunSetupOverlayStrings.cs
index 001de93c16..15b8d0ba67 100644
--- a/osu.Game/Localisation/FirstRunSetupOverlayStrings.cs
+++ b/osu.Game/Localisation/FirstRunSetupOverlayStrings.cs
@@ -17,7 +17,8 @@ namespace osu.Game.Localisation
         /// <summary>
         /// "Click to resume first-run setup at any point"
         /// </summary>
-        public static LocalisableString ClickToResumeFirstRunSetupAtAnyPoint => new TranslatableString(getKey(@"click_to_resume_first_run_setup_at_any_point"), @"Click to resume first-run setup at any point");
+        public static LocalisableString ClickToResumeFirstRunSetupAtAnyPoint =>
+            new TranslatableString(getKey(@"click_to_resume_first_run_setup_at_any_point"), @"Click to resume first-run setup at any point");
 
         /// <summary>
         /// "First-run setup"
@@ -53,6 +54,31 @@ osu! is a very configurable game, and diving straight into the settings can some
         /// </summary>
         public static LocalisableString Next(LocalisableString nextStepDescription) => new TranslatableString(getKey(@"next"), @"Next ({0})", nextStepDescription);
 
+        /// <summary>
+        /// "Behaviour"
+        /// </summary>
+        public static LocalisableString Behaviour => new TranslatableString(getKey(@"behaviour"), @"Behaviour");
+
+        /// <summary>
+        /// "Some new defaults for game behaviours have been implemented, with the aim of improving the game experience and making it more accessible to everyone.
+        ///
+        /// We recommend you give the new defaults a try, but if you&#39;d like to have things feel more like classic versions of osu!, you can easily apply some sane defaults below."
+        /// </summary>
+        public static LocalisableString BehaviourDescription => new TranslatableString(getKey(@"behaviour_description"),
+            @"Some new defaults for game behaviours have been implemented, with the aim of improving the game experience and making it more accessible to everyone.
+
+We recommend you give the new defaults a try, but if you'd like to have things feel more like classic versions of osu!, you can easily apply some sane defaults below.");
+
+        /// <summary>
+        /// "New defaults"
+        /// </summary>
+        public static LocalisableString NewDefaults => new TranslatableString(getKey(@"new_defaults"), @"New defaults");
+
+        /// <summary>
+        /// "Classic defaults"
+        /// </summary>
+        public static LocalisableString ClassicDefaults => new TranslatableString(getKey(@"classic_defaults"), @"Classic defaults");
+
         private static string getKey(string key) => $@"{prefix}:{key}";
     }
 }
diff --git a/osu.Game/Overlays/FirstRunSetup/ScreenBehaviour.cs b/osu.Game/Overlays/FirstRunSetup/ScreenBehaviour.cs
new file mode 100644
index 0000000000..61177c821b
--- /dev/null
+++ b/osu.Game/Overlays/FirstRunSetup/ScreenBehaviour.cs
@@ -0,0 +1,104 @@
+// 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.Testing;
+using osu.Game.Graphics;
+using osu.Game.Graphics.Containers;
+using osu.Game.Graphics.UserInterface;
+using osu.Game.Localisation;
+using osu.Game.Overlays.Settings;
+using osu.Game.Overlays.Settings.Sections;
+
+namespace osu.Game.Overlays.FirstRunSetup
+{
+    public class ScreenBehaviour : FirstRunSetupScreen
+    {
+        private SearchContainer<SettingsSection> searchContainer;
+
+        [BackgroundDependencyLoader]
+        private void load()
+        {
+            Content.Children = new Drawable[]
+            {
+                new OsuTextFlowContainer(cp => cp.Font = OsuFont.Default.With(size: 24))
+                {
+                    Text = FirstRunSetupOverlayStrings.BehaviourDescription,
+                    RelativeSizeAxes = Axes.X,
+                    AutoSizeAxes = Axes.Y
+                },
+                new GridContainer
+                {
+                    RelativeSizeAxes = Axes.X,
+                    AutoSizeAxes = Axes.Y,
+                    ColumnDimensions = new[]
+                    {
+                        new Dimension(),
+                        new Dimension(GridSizeMode.Absolute, 10),
+                        new Dimension(),
+                    },
+                    RowDimensions = new[]
+                    {
+                        new Dimension(GridSizeMode.AutoSize),
+                    },
+                    Content = new[]
+                    {
+                        new[]
+                        {
+                            new TriangleButton
+                            {
+                                Anchor = Anchor.TopLeft,
+                                Origin = Anchor.TopLeft,
+                                Text = FirstRunSetupOverlayStrings.NewDefaults,
+                                RelativeSizeAxes = Axes.X,
+                                Action = applyStandard,
+                            },
+                            Empty(),
+                            new DangerousTriangleButton
+                            {
+                                Anchor = Anchor.TopRight,
+                                Origin = Anchor.TopRight,
+                                Text = FirstRunSetupOverlayStrings.ClassicDefaults,
+                                RelativeSizeAxes = Axes.X,
+                                Action = applyClassic
+                            }
+                        },
+                    },
+                },
+                searchContainer = new SearchContainer<SettingsSection>
+                {
+                    RelativeSizeAxes = Axes.X,
+                    AutoSizeAxes = Axes.Y,
+                    Children = new SettingsSection[]
+                    {
+                        new GeneralSection(),
+                        new SkinSection(),
+                        new UserInterfaceSection(),
+                        new GameplaySection(),
+                        new RulesetSection(),
+                        new AudioSection(),
+                        new GraphicsSection(),
+                        new OnlineSection(),
+                        new MaintenanceSection(),
+                        new DebugSection(),
+                    },
+                    SearchTerm = SettingsItem<bool>.CLASSIC_DEFAULT_SEARCH_TERM,
+                }
+            };
+        }
+
+        private void applyClassic()
+        {
+            foreach (var i in searchContainer.ChildrenOfType<ISettingsItem>())
+                i.ApplyClassicDefault(true);
+        }
+
+        private void applyStandard()
+        {
+            foreach (var i in searchContainer.ChildrenOfType<ISettingsItem>())
+                i.ApplyClassicDefault(false);
+        }
+    }
+}
diff --git a/osu.Game/Overlays/FirstRunSetupOverlay.cs b/osu.Game/Overlays/FirstRunSetupOverlay.cs
index a12fec4507..26b1eb2d45 100644
--- a/osu.Game/Overlays/FirstRunSetupOverlay.cs
+++ b/osu.Game/Overlays/FirstRunSetupOverlay.cs
@@ -70,6 +70,7 @@ namespace osu.Game.Overlays
         {
             new FirstRunStep(typeof(ScreenWelcome), FirstRunSetupOverlayStrings.WelcomeTitle),
             new FirstRunStep(typeof(ScreenUIScale), GraphicsSettingsStrings.UIScaling),
+            new FirstRunStep(typeof(ScreenBehaviour), FirstRunSetupOverlayStrings.Behaviour),
         };
 
         private Container stackContainer = null!;

From bcdd1fb183b0b612290f23c2129c3948d2210262 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 22 Apr 2022 18:37:40 +0900
Subject: [PATCH 4250/5547] Fix nested song select in first-run dialog fiddling
 with global audio

---
 osu.Game/Screens/Select/SongSelect.cs | 23 +++++++++++++++++++----
 1 file changed, 19 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Screens/Select/SongSelect.cs b/osu.Game/Screens/Select/SongSelect.cs
index 928978cd08..2a1ed2a7a8 100644
--- a/osu.Game/Screens/Select/SongSelect.cs
+++ b/osu.Game/Screens/Select/SongSelect.cs
@@ -50,6 +50,12 @@ namespace osu.Game.Screens.Select
 
         public FilterControl FilterControl { get; private set; }
 
+        /// <summary>
+        /// Whether this song select instance should take control of the global track,
+        /// applying looping and preview offsets.
+        /// </summary>
+        protected virtual bool ControlGlobalMusic => true;
+
         protected virtual bool ShowFooter => true;
 
         protected virtual bool DisplayStableImportPrompt => legacyImportManager?.SupportsImportFromStable == true;
@@ -604,15 +610,18 @@ namespace osu.Game.Screens.Select
             BeatmapDetails.Refresh();
 
             beginLooping();
-            music.ResetTrackAdjustments();
 
             if (Beatmap != null && !Beatmap.Value.BeatmapSetInfo.DeletePending)
             {
                 updateComponentFromBeatmap(Beatmap.Value);
 
-                // restart playback on returning to song select, regardless.
-                // not sure this should be a permanent thing (we may want to leave a user pause paused even on returning)
-                music.Play(requestedByUser: true);
+                if (ControlGlobalMusic)
+                {
+                    // restart playback on returning to song select, regardless.
+                    // not sure this should be a permanent thing (we may want to leave a user pause paused even on returning)
+                    music.ResetTrackAdjustments();
+                    music.Play(requestedByUser: true);
+                }
             }
 
             this.FadeIn(250);
@@ -663,6 +672,9 @@ namespace osu.Game.Screens.Select
 
         private void beginLooping()
         {
+            if (!ControlGlobalMusic)
+                return;
+
             Debug.Assert(!isHandlingLooping);
 
             isHandlingLooping = true;
@@ -733,6 +745,9 @@ namespace osu.Game.Screens.Select
         /// </summary>
         private void ensurePlayingSelected()
         {
+            if (!ControlGlobalMusic)
+                return;
+
             ITrack track = music.CurrentTrack;
 
             bool isNewTrack = !lastTrack.TryGetTarget(out var last) || last != track;

From 5f3ff51f7e1f1c416b2be768b7433aabf7fbb5be Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 22 Apr 2022 21:24:58 +0900
Subject: [PATCH 4251/5547] Revert "Remove one more unnecessary schedule"

This reverts commit f282e5b0133785d8c9e6474cbe04bf5c79dc4811.
---
 osu.Game/Graphics/Containers/SectionsContainer.cs | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Graphics/Containers/SectionsContainer.cs b/osu.Game/Graphics/Containers/SectionsContainer.cs
index 823ba33216..540ca85809 100644
--- a/osu.Game/Graphics/Containers/SectionsContainer.cs
+++ b/osu.Game/Graphics/Containers/SectionsContainer.cs
@@ -195,8 +195,11 @@ namespace osu.Game.Graphics.Containers
 
         protected void InvalidateScrollPosition()
         {
-            lastKnownScroll = null;
-            lastClickedSection = null;
+            Schedule(() =>
+            {
+                lastKnownScroll = null;
+                lastClickedSection = null;
+            });
         }
 
         protected override void UpdateAfterChildren()

From 0dc3d1041fe22d4c0bbc245327b6a2cd46f49e36 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 22 Apr 2022 19:23:54 +0300
Subject: [PATCH 4252/5547] Revert "Revert "Remove one more unnecessary
 schedule""

This reverts commit 5f3ff51f7e1f1c416b2be768b7433aabf7fbb5be.
---
 osu.Game/Graphics/Containers/SectionsContainer.cs | 7 ++-----
 1 file changed, 2 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Graphics/Containers/SectionsContainer.cs b/osu.Game/Graphics/Containers/SectionsContainer.cs
index 540ca85809..823ba33216 100644
--- a/osu.Game/Graphics/Containers/SectionsContainer.cs
+++ b/osu.Game/Graphics/Containers/SectionsContainer.cs
@@ -195,11 +195,8 @@ namespace osu.Game.Graphics.Containers
 
         protected void InvalidateScrollPosition()
         {
-            Schedule(() =>
-            {
-                lastKnownScroll = null;
-                lastClickedSection = null;
-            });
+            lastKnownScroll = null;
+            lastClickedSection = null;
         }
 
         protected override void UpdateAfterChildren()

From 2961c383f68891bdc954ecab928fda81cad765ba Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 22 Apr 2022 20:04:04 +0300
Subject: [PATCH 4253/5547] Add failing test case

---
 .../Visual/Settings/TestSceneSettingsPanel.cs | 22 ++++++++++++++-----
 1 file changed, 17 insertions(+), 5 deletions(-)

diff --git a/osu.Game.Tests/Visual/Settings/TestSceneSettingsPanel.cs b/osu.Game.Tests/Visual/Settings/TestSceneSettingsPanel.cs
index cdeaafd828..377873f64a 100644
--- a/osu.Game.Tests/Visual/Settings/TestSceneSettingsPanel.cs
+++ b/osu.Game.Tests/Visual/Settings/TestSceneSettingsPanel.cs
@@ -33,18 +33,21 @@ namespace osu.Game.Tests.Visual.Settings
                     State = { Value = Visibility.Visible }
                 });
             });
+
+            AddStep("reset mouse", () => InputManager.MoveMouseTo(settings));
         }
 
         [Test]
-        public void TestQuickFiltering()
+        public void TestFiltering([Values] bool beforeLoad)
         {
-            AddStep("set filter", () =>
-            {
-                settings.SectionsContainer.ChildrenOfType<SearchTextBox>().First().Current.Value = "scaling";
-            });
+            if (beforeLoad)
+                AddStep("set filter", () => settings.SectionsContainer.ChildrenOfType<SearchTextBox>().First().Current.Value = "scaling");
 
             AddUntilStep("wait for items to load", () => settings.SectionsContainer.ChildrenOfType<IFilterable>().Any());
 
+            if (!beforeLoad)
+                AddStep("set filter", () => settings.SectionsContainer.ChildrenOfType<SearchTextBox>().First().Current.Value = "scaling");
+
             AddAssert("ensure all items match filter", () => settings.SectionsContainer
                                                                      .ChildrenOfType<SettingsSection>().Where(f => f.IsPresent)
                                                                      .All(section =>
@@ -56,6 +59,15 @@ namespace osu.Game.Tests.Visual.Settings
                                                                      ));
 
             AddAssert("ensure section is current", () => settings.CurrentSection.Value is GraphicsSection);
+            AddAssert("ensure section is placed first", () => settings.CurrentSection.Value.Y == 0);
+        }
+
+        [Test]
+        public void TestFilterAfterLoad()
+        {
+            AddUntilStep("wait for items to load", () => settings.SectionsContainer.ChildrenOfType<IFilterable>().Any());
+
+            AddStep("set filter", () => settings.SectionsContainer.ChildrenOfType<SearchTextBox>().First().Current.Value = "scaling");
         }
 
         [Test]

From 4c7c611218fbf0b4e73aca928f2e1b2081f9d370 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 22 Apr 2022 20:34:00 +0300
Subject: [PATCH 4254/5547] Fix settings overlay not invalidating presence on
 filter change

---
 osu.Game/Overlays/Settings/SettingsItem.cs    | 18 +++++++++++++++--
 osu.Game/Overlays/Settings/SettingsSection.cs | 20 ++++++++++++++++---
 2 files changed, 33 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Overlays/Settings/SettingsItem.cs b/osu.Game/Overlays/Settings/SettingsItem.cs
index 1c5668479f..7795b7b4c5 100644
--- a/osu.Game/Overlays/Settings/SettingsItem.cs
+++ b/osu.Game/Overlays/Settings/SettingsItem.cs
@@ -100,9 +100,23 @@ namespace osu.Game.Overlays.Settings
 
         public IEnumerable<string> Keywords { get; set; }
 
-        public override bool IsPresent => base.IsPresent && MatchingFilter;
+        private bool matchingFilter;
 
-        public bool MatchingFilter { get; set; } = true;
+        public bool MatchingFilter
+        {
+            get => matchingFilter;
+            set
+            {
+                bool wasPresent = IsPresent;
+
+                matchingFilter = value;
+
+                if (IsPresent != wasPresent)
+                    Invalidate(Invalidation.Presence);
+            }
+        }
+
+        public override bool IsPresent => base.IsPresent && MatchingFilter;
 
         public bool FilteringActive { get; set; }
 
diff --git a/osu.Game/Overlays/Settings/SettingsSection.cs b/osu.Game/Overlays/Settings/SettingsSection.cs
index 28c42a0e47..694823314e 100644
--- a/osu.Game/Overlays/Settings/SettingsSection.cs
+++ b/osu.Game/Overlays/Settings/SettingsSection.cs
@@ -21,8 +21,6 @@ namespace osu.Game.Overlays.Settings
         protected FillFlowContainer FlowContent;
         protected override Container<Drawable> Content => FlowContent;
 
-        public override bool IsPresent => base.IsPresent && MatchingFilter;
-
         private IBindable<SettingsSection> selectedSection;
 
         private Box dim;
@@ -40,7 +38,23 @@ namespace osu.Game.Overlays.Settings
         private const int header_size = 24;
         private const int border_size = 4;
 
-        public bool MatchingFilter { get; set; } = true;
+        private bool matchingFilter;
+
+        public bool MatchingFilter
+        {
+            get => matchingFilter;
+            set
+            {
+                bool wasPresent = IsPresent;
+
+                matchingFilter = value;
+
+                if (IsPresent != wasPresent)
+                    Invalidate(Invalidation.Presence);
+            }
+        }
+
+        public override bool IsPresent => base.IsPresent && MatchingFilter;
 
         public bool FilteringActive { get; set; }
 

From 7be25963121626e9f024787d1c24f13409e7952b Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 22 Apr 2022 23:50:58 +0300
Subject: [PATCH 4255/5547] Fix `MatchingFilter` being false by default

---
 osu.Game/Overlays/Settings/SettingsItem.cs    | 2 +-
 osu.Game/Overlays/Settings/SettingsSection.cs | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Overlays/Settings/SettingsItem.cs b/osu.Game/Overlays/Settings/SettingsItem.cs
index 7795b7b4c5..f7824d79e7 100644
--- a/osu.Game/Overlays/Settings/SettingsItem.cs
+++ b/osu.Game/Overlays/Settings/SettingsItem.cs
@@ -100,7 +100,7 @@ namespace osu.Game.Overlays.Settings
 
         public IEnumerable<string> Keywords { get; set; }
 
-        private bool matchingFilter;
+        private bool matchingFilter = true;
 
         public bool MatchingFilter
         {
diff --git a/osu.Game/Overlays/Settings/SettingsSection.cs b/osu.Game/Overlays/Settings/SettingsSection.cs
index 694823314e..b5f3d8e003 100644
--- a/osu.Game/Overlays/Settings/SettingsSection.cs
+++ b/osu.Game/Overlays/Settings/SettingsSection.cs
@@ -38,7 +38,7 @@ namespace osu.Game.Overlays.Settings
         private const int header_size = 24;
         private const int border_size = 4;
 
-        private bool matchingFilter;
+        private bool matchingFilter = true;
 
         public bool MatchingFilter
         {

From 56358ef19ed9ebe69a74b25eff50e537b5e63fe2 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sat, 23 Apr 2022 00:35:45 +0300
Subject: [PATCH 4256/5547] Fix legacy skin hit animation lookup falling back
 to `LookupName`

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

diff --git a/osu.Game/Skinning/LegacySkin.cs b/osu.Game/Skinning/LegacySkin.cs
index f7d5581621..aed6026d69 100644
--- a/osu.Game/Skinning/LegacySkin.cs
+++ b/osu.Game/Skinning/LegacySkin.cs
@@ -390,7 +390,7 @@ namespace osu.Game.Skinning
                             return new LegacyJudgementPieceOld(resultComponent.Component, createDrawable);
                     }
 
-                    break;
+                    return null;
             }
 
             return this.GetAnimation(component.LookupName, false, false);

From 69e2e309717382f6ae63d5b24205a249f089b562 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sat, 23 Apr 2022 01:06:35 +0300
Subject: [PATCH 4257/5547] Remove legacy skin component fallback lookup

Has always been a source of hiding actual issues like in https://github.com/ppy/osu/issues/17745 (`sliderfollowcircle` looked up from fallback because there's no transformer), and https://github.com/ppy/osu/issues/17934 (because there's a texture `ok` and that matches the component name `HitResult.Ok`).
---
 osu.Game/Skinning/LegacySkin.cs | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Skinning/LegacySkin.cs b/osu.Game/Skinning/LegacySkin.cs
index aed6026d69..1b3b0eea18 100644
--- a/osu.Game/Skinning/LegacySkin.cs
+++ b/osu.Game/Skinning/LegacySkin.cs
@@ -391,9 +391,10 @@ namespace osu.Game.Skinning
                     }
 
                     return null;
-            }
 
-            return this.GetAnimation(component.LookupName, false, false);
+                default:
+                    throw new ArgumentOutOfRangeException(nameof(component));
+            }
         }
 
         private Texture? getParticleTexture(HitResult result)

From 61078910a64de149e999f970146837b3334d8bfa Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sat, 23 Apr 2022 01:08:53 +0300
Subject: [PATCH 4258/5547] Handle all skin component types explicitly

---
 .../Skinning/Legacy/CatchLegacySkinTransformer.cs |  3 +++
 .../Skinning/Legacy/ManiaLegacySkinTransformer.cs |  5 +++--
 .../Skinning/Legacy/OsuLegacySkinTransformer.cs   |  6 ++++++
 .../Skinning/Legacy/TaikoLegacySkinTransformer.cs |  7 +++++++
 osu.Game/Skinning/DefaultSkin.cs                  |  2 +-
 osu.Game/Skinning/LegacySkin.cs                   |  5 ++++-
 osu.Game/Skinning/SkinnableSprite.cs              |  2 +-
 .../Skinning/UnsupportedSkinComponentException.cs | 15 +++++++++++++++
 8 files changed, 40 insertions(+), 5 deletions(-)
 create mode 100644 osu.Game/Skinning/UnsupportedSkinComponentException.cs

diff --git a/osu.Game.Rulesets.Catch/Skinning/Legacy/CatchLegacySkinTransformer.cs b/osu.Game.Rulesets.Catch/Skinning/Legacy/CatchLegacySkinTransformer.cs
index b2a555f89d..04b522b404 100644
--- a/osu.Game.Rulesets.Catch/Skinning/Legacy/CatchLegacySkinTransformer.cs
+++ b/osu.Game.Rulesets.Catch/Skinning/Legacy/CatchLegacySkinTransformer.cs
@@ -90,6 +90,9 @@ namespace osu.Game.Rulesets.Catch.Skinning.Legacy
                             return new LegacyHitExplosion();
 
                         return null;
+
+                    default:
+                        throw new UnsupportedSkinComponentException(component);
                 }
             }
 
diff --git a/osu.Game.Rulesets.Mania/Skinning/Legacy/ManiaLegacySkinTransformer.cs b/osu.Game.Rulesets.Mania/Skinning/Legacy/ManiaLegacySkinTransformer.cs
index 431bd77402..315b4444c2 100644
--- a/osu.Game.Rulesets.Mania/Skinning/Legacy/ManiaLegacySkinTransformer.cs
+++ b/osu.Game.Rulesets.Mania/Skinning/Legacy/ManiaLegacySkinTransformer.cs
@@ -116,9 +116,10 @@ namespace osu.Game.Rulesets.Mania.Skinning.Legacy
 
                         case ManiaSkinComponents.StageForeground:
                             return new LegacyStageForeground();
-                    }
 
-                    break;
+                        default:
+                            throw new UnsupportedSkinComponentException(component);
+                    }
             }
 
             return base.GetDrawableComponent(component);
diff --git a/osu.Game.Rulesets.Osu/Skinning/Legacy/OsuLegacySkinTransformer.cs b/osu.Game.Rulesets.Osu/Skinning/Legacy/OsuLegacySkinTransformer.cs
index 900ad6f6d3..572185e6e1 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Legacy/OsuLegacySkinTransformer.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Legacy/OsuLegacySkinTransformer.cs
@@ -35,6 +35,9 @@ namespace osu.Game.Rulesets.Osu.Skinning.Legacy
                     case OsuSkinComponents.FollowPoint:
                         return this.GetAnimation(component.LookupName, true, true, true, startAtCurrentTime: false);
 
+                    case OsuSkinComponents.SliderScorePoint:
+                        return this.GetAnimation(component.LookupName, false, false);
+
                     case OsuSkinComponents.SliderFollowCircle:
                         var followCircle = this.GetAnimation("sliderfollowcircle", true, true, true);
                         if (followCircle != null)
@@ -123,6 +126,9 @@ namespace osu.Game.Rulesets.Osu.Skinning.Legacy
 
                     case OsuSkinComponents.ApproachCircle:
                         return new LegacyApproachCircle();
+
+                    default:
+                        throw new UnsupportedSkinComponentException(component);
                 }
             }
 
diff --git a/osu.Game.Rulesets.Taiko/Skinning/Legacy/TaikoLegacySkinTransformer.cs b/osu.Game.Rulesets.Taiko/Skinning/Legacy/TaikoLegacySkinTransformer.cs
index bbc8f0abea..af5921b0fb 100644
--- a/osu.Game.Rulesets.Taiko/Skinning/Legacy/TaikoLegacySkinTransformer.cs
+++ b/osu.Game.Rulesets.Taiko/Skinning/Legacy/TaikoLegacySkinTransformer.cs
@@ -57,6 +57,10 @@ namespace osu.Game.Rulesets.Taiko.Skinning.Legacy
                     case TaikoSkinComponents.DrumRollTick:
                         return this.GetAnimation("sliderscorepoint", false, false);
 
+                    case TaikoSkinComponents.Swell:
+                        // todo: support taiko legacy swell (https://github.com/ppy/osu/issues/13601).
+                        return null;
+
                     case TaikoSkinComponents.HitTarget:
                         if (GetTexture("taikobigcircle") != null)
                             return new TaikoLegacyHitTarget();
@@ -119,6 +123,9 @@ namespace osu.Game.Rulesets.Taiko.Skinning.Legacy
 
                     case TaikoSkinComponents.Mascot:
                         return new DrawableTaikoMascot();
+
+                    default:
+                        throw new UnsupportedSkinComponentException(component);
                 }
             }
 
diff --git a/osu.Game/Skinning/DefaultSkin.cs b/osu.Game/Skinning/DefaultSkin.cs
index 119b0ec9ad..fb24084659 100644
--- a/osu.Game/Skinning/DefaultSkin.cs
+++ b/osu.Game/Skinning/DefaultSkin.cs
@@ -155,7 +155,7 @@ namespace osu.Game.Skinning
                             return skinnableTargetWrapper;
                     }
 
-                    break;
+                    return null;
             }
 
             switch (component.LookupName)
diff --git a/osu.Game/Skinning/LegacySkin.cs b/osu.Game/Skinning/LegacySkin.cs
index 1b3b0eea18..b65ba8b04c 100644
--- a/osu.Game/Skinning/LegacySkin.cs
+++ b/osu.Game/Skinning/LegacySkin.cs
@@ -392,8 +392,11 @@ namespace osu.Game.Skinning
 
                     return null;
 
+                case SkinnableSprite.SpriteComponent sprite:
+                    return this.GetAnimation(sprite.LookupName, false, false);
+
                 default:
-                    throw new ArgumentOutOfRangeException(nameof(component));
+                    throw new UnsupportedSkinComponentException(component);
             }
         }
 
diff --git a/osu.Game/Skinning/SkinnableSprite.cs b/osu.Game/Skinning/SkinnableSprite.cs
index 4b4d7fe2c6..af9ff0f1d7 100644
--- a/osu.Game/Skinning/SkinnableSprite.cs
+++ b/osu.Game/Skinning/SkinnableSprite.cs
@@ -65,7 +65,7 @@ namespace osu.Game.Skinning
 
         public bool UsesFixedAnchor { get; set; }
 
-        private class SpriteComponent : ISkinComponent
+        public class SpriteComponent : ISkinComponent
         {
             public string LookupName { get; set; }
 
diff --git a/osu.Game/Skinning/UnsupportedSkinComponentException.cs b/osu.Game/Skinning/UnsupportedSkinComponentException.cs
new file mode 100644
index 0000000000..643f29c3db
--- /dev/null
+++ b/osu.Game/Skinning/UnsupportedSkinComponentException.cs
@@ -0,0 +1,15 @@
+// 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.Skinning
+{
+    public class UnsupportedSkinComponentException : Exception
+    {
+        public UnsupportedSkinComponentException(ISkinComponent component)
+            : base($@"Unsupported component type: {component.GetType()}(""{component.LookupName}"").")
+        {
+        }
+    }
+}

From 89519086c89fd8897e65816677f1ca088e743907 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sat, 23 Apr 2022 03:16:58 +0300
Subject: [PATCH 4259/5547] Fix `SkinnableTestScene` unnecessarily adding a
 base raw skin layer

---
 osu.Game/Tests/Visual/SkinnableTestScene.cs | 18 ++++++++++--------
 1 file changed, 10 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Tests/Visual/SkinnableTestScene.cs b/osu.Game/Tests/Visual/SkinnableTestScene.cs
index 2e1ca09fe4..296ed80e37 100644
--- a/osu.Game/Tests/Visual/SkinnableTestScene.cs
+++ b/osu.Game/Tests/Visual/SkinnableTestScene.cs
@@ -74,11 +74,15 @@ namespace osu.Game.Tests.Visual
 
             createdDrawables.Add(created);
 
-            SkinProvidingContainer mainProvider;
             Container childContainer;
             OutlineBox outlineBox;
             SkinProvidingContainer skinProvider;
 
+            ISkin provider = skin;
+
+            if (provider is LegacySkin legacyProvider)
+                provider = Ruleset.Value.CreateInstance().CreateLegacySkinProvider(legacyProvider, beatmap);
+
             var children = new Container
             {
                 RelativeSizeAxes = Axes.Both,
@@ -107,12 +111,10 @@ namespace osu.Game.Tests.Visual
                         Children = new Drawable[]
                         {
                             outlineBox = new OutlineBox(),
-                            (mainProvider = new SkinProvidingContainer(skin)).WithChild(
-                                skinProvider = new SkinProvidingContainer(Ruleset.Value.CreateInstance().CreateLegacySkinProvider(mainProvider, beatmap))
-                                {
-                                    Child = created,
-                                }
-                            )
+                            skinProvider = new SkinProvidingContainer(provider)
+                            {
+                                Child = created,
+                            }
                         }
                     },
                 }
@@ -130,7 +132,7 @@ namespace osu.Game.Tests.Visual
             {
                 bool autoSize = created.RelativeSizeAxes == Axes.None;
 
-                foreach (var c in new[] { mainProvider, childContainer, skinProvider })
+                foreach (var c in new[] { childContainer, skinProvider })
                 {
                     c.RelativeSizeAxes = Axes.None;
                     c.AutoSizeAxes = Axes.None;

From 610d61dce9dcc1be01acf3dce37ea254b6125942 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sat, 23 Apr 2022 03:17:18 +0300
Subject: [PATCH 4260/5547] Fix `TestSceneSliderApplication` not applying
 legacy skin transformer

---
 osu.Game.Rulesets.Osu.Tests/TestSceneSliderApplication.cs | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu.Tests/TestSceneSliderApplication.cs b/osu.Game.Rulesets.Osu.Tests/TestSceneSliderApplication.cs
index d673b7a6ac..a40ae611d8 100644
--- a/osu.Game.Rulesets.Osu.Tests/TestSceneSliderApplication.cs
+++ b/osu.Game.Rulesets.Osu.Tests/TestSceneSliderApplication.cs
@@ -70,7 +70,9 @@ namespace osu.Game.Rulesets.Osu.Tests
                 var tintingSkin = skinManager.GetSkin(DefaultLegacySkin.CreateInfo());
                 tintingSkin.Configuration.ConfigDictionary["AllowSliderBallTint"] = "1";
 
-                Child = new SkinProvidingContainer(tintingSkin)
+                var provider = Ruleset.Value.CreateInstance().CreateLegacySkinProvider(tintingSkin, Beatmap.Value.Beatmap);
+
+                Child = new SkinProvidingContainer(provider)
                 {
                     RelativeSizeAxes = Axes.Both,
                     Child = dho = new DrawableSlider(prepareObject(new Slider

From 6cca56ab77d0317a2dba6cfc114f9c3bd105d248 Mon Sep 17 00:00:00 2001
From: 63411 <62799417+molneya@users.noreply.github.com>
Date: Sat, 23 Apr 2022 10:46:12 +0800
Subject: [PATCH 4261/5547] Move release_threshold to const

---
 osu.Game.Rulesets.Mania/Difficulty/Skills/Strain.cs | 13 +++++++++++--
 1 file changed, 11 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Rulesets.Mania/Difficulty/Skills/Strain.cs b/osu.Game.Rulesets.Mania/Difficulty/Skills/Strain.cs
index a5b9675836..31550a8105 100644
--- a/osu.Game.Rulesets.Mania/Difficulty/Skills/Strain.cs
+++ b/osu.Game.Rulesets.Mania/Difficulty/Skills/Strain.cs
@@ -14,6 +14,7 @@ namespace osu.Game.Rulesets.Mania.Difficulty.Skills
     {
         private const double individual_decay_base = 0.125;
         private const double overall_decay_base = 0.30;
+        private const double release_threshold = 24;
 
         protected override double SkillMultiplier => 1;
         protected override double StrainDecayBase => 1;
@@ -62,9 +63,17 @@ namespace osu.Game.Rulesets.Mania.Difficulty.Skills
             holdEndTimes[column] = endTime;
 
             // The hold addition is given if there was an overlap, however it is only valid if there are no other note with a similar ending.
-            // Releasing multiple notes is just as easy as releasing 1. Nerfs the hold addition by half if the closest release is 24ms away.
+            // Releasing multiple notes is just as easy as releasing 1. Nerfs the hold addition by half if the closest release is release_threshold away.
+            // holdAddition
+            //     ^
+            // 1.0 + - - - - - -+-----------
+            //     |           /
+            // 0.5 + - - - - -/   Sigmoid Curve
+            //     |         /|
+            // 0.0 +--------+-+---------------> Release Difference / ms
+            //         release_threshold
             if (isOverlapping)
-                holdAddition = 1 / (1 + Math.Exp(0.5 * (24 - closestEndTime)));
+                holdAddition = 1 / (1 + Math.Exp(0.5 * (release_threshold - closestEndTime)));
 
             // Increase individual strain in own column
             individualStrains[column] += 2.0 * holdFactor;

From 27f3499330536b0ab2e86e600478a751fcb1e9d5 Mon Sep 17 00:00:00 2001
From: maromalo <54760464+maromalo@users.noreply.github.com>
Date: Sat, 23 Apr 2022 00:17:00 -0300
Subject: [PATCH 4262/5547] Add joystick/gamepad deadzone setting

Also splits joystick/gamepad into a new sub-section.
---
 .../Localisation/JoystickSettingsStrings.cs   | 21 +++++++
 .../Sections/Input/JoystickSettings.cs        | 62 +++++++++++++++++++
 .../Settings/Sections/InputSection.cs         |  5 +-
 3 files changed, 87 insertions(+), 1 deletion(-)
 create mode 100644 osu.Game/Localisation/JoystickSettingsStrings.cs
 create mode 100644 osu.Game/Overlays/Settings/Sections/Input/JoystickSettings.cs

diff --git a/osu.Game/Localisation/JoystickSettingsStrings.cs b/osu.Game/Localisation/JoystickSettingsStrings.cs
new file mode 100644
index 0000000000..6ae8bb66dc
--- /dev/null
+++ b/osu.Game/Localisation/JoystickSettingsStrings.cs
@@ -0,0 +1,21 @@
+using osu.Framework.Localisation;
+
+namespace osu.Game.Localisation
+{
+    public static class JoystickSettingsStrings
+    {
+        private const string prefix = @"osu.Game.Resources.Localisation.JoystickSettings";
+
+        /// <summary>
+        /// "Joystick / Gamepad"
+        /// </summary>
+        public static LocalisableString JoystickGamepad => new TranslatableString(getKey(@"joystick_gamepad"), @"Joystick / Gamepad");
+
+        /// <summary>
+        /// "Deadzone Threshold"
+        /// </summary>
+        public static LocalisableString DeadzoneThreshold => new TranslatableString(getKey(@"deadzone_threshold"), @"Deadzone Threshold");
+
+        private static string getKey(string key) => $@"{prefix}:{key}";
+    }
+}
\ No newline at end of file
diff --git a/osu.Game/Overlays/Settings/Sections/Input/JoystickSettings.cs b/osu.Game/Overlays/Settings/Sections/Input/JoystickSettings.cs
new file mode 100644
index 0000000000..fd1dbc876a
--- /dev/null
+++ b/osu.Game/Overlays/Settings/Sections/Input/JoystickSettings.cs
@@ -0,0 +1,62 @@
+using osu.Framework.Allocation;
+using osu.Framework.Bindables;
+using osu.Framework.Graphics;
+using osu.Framework.Input.Handlers.Joystick;
+using osu.Framework.Localisation;
+using osu.Game.Graphics.UserInterface;
+using osu.Game.Localisation;
+
+namespace osu.Game.Overlays.Settings.Sections.Input
+{
+    public class JoystickSettings : SettingsSubsection
+    {
+        private readonly JoystickHandler joystickHandler;
+           
+            protected override LocalisableString Header => JoystickSettingsStrings.JoystickGamepad;
+            private readonly BindableNumber<float> deadzoneThreshold = new BindableNumber<float>();
+            private readonly Bindable<bool> enabled = new BindableBool(true);
+            public JoystickSettings(JoystickHandler joystickHandler)
+            {
+                this.joystickHandler = joystickHandler;
+            }
+            [BackgroundDependencyLoader]
+            private void load()
+            {
+                Children = new Drawable[]
+                {
+                    new SettingsCheckbox
+                    {
+                        LabelText = CommonStrings.Enabled,
+                        Current = enabled
+                    },
+                    new DeadzoneSetting
+                    {
+                        LabelText = JoystickSettingsStrings.DeadzoneThreshold,
+                        Current = deadzoneThreshold
+                    },
+                };
+            }
+
+            protected override void LoadComplete()
+            {
+                base.LoadComplete();
+                enabled.BindTo(joystickHandler.Enabled);
+                deadzoneThreshold.BindTo(joystickHandler.DeadzoneThreshold);
+                enabled.BindValueChanged(e => deadzoneThreshold.Disabled = !e.NewValue, true);
+            }
+
+            private class DeadzoneSetting : SettingsSlider<float, DeadzoneSlider>
+            {
+                public DeadzoneSetting()
+                {
+                    KeyboardStep = 0.005f;
+                    TransferValueOnCommit = true;
+                }
+            }
+            
+            private class DeadzoneSlider : OsuSliderBar<float>
+            {
+                public override LocalisableString TooltipText => Current.Disabled ? "" : base.TooltipText;
+            }
+    }
+}
\ No newline at end of file
diff --git a/osu.Game/Overlays/Settings/Sections/InputSection.cs b/osu.Game/Overlays/Settings/Sections/InputSection.cs
index d282ba5318..d2c5d2fcf7 100644
--- a/osu.Game/Overlays/Settings/Sections/InputSection.cs
+++ b/osu.Game/Overlays/Settings/Sections/InputSection.cs
@@ -68,7 +68,10 @@ namespace osu.Game.Overlays.Settings.Sections
                     break;
 
                 // whitelist the handlers which should be displayed to avoid any weird cases of users touching settings they shouldn't.
-                case JoystickHandler _:
+                case JoystickHandler jh:
+                    section = new JoystickSettings(jh);
+                    break;
+
                 case MidiHandler _:
                     section = new HandlerSection(handler);
                     break;

From 99f276a570950a93f5fdf9022aad10e356da7ae7 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 23 Apr 2022 13:30:23 +0900
Subject: [PATCH 4263/5547] Update framework

---
 osu.Android.props        | 2 +-
 osu.Game/osu.Game.csproj | 2 +-
 osu.iOS.props            | 4 ++--
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Android.props b/osu.Android.props
index 8d79eb94a8..82dec74855 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -52,7 +52,7 @@
   </ItemGroup>
   <ItemGroup>
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.422.0" />
-    <PackageReference Include="ppy.osu.Framework.Android" Version="2022.421.0" />
+    <PackageReference Include="ppy.osu.Framework.Android" Version="2022.423.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
     <!-- Realm needs to be directly referenced in all Xamarin projects, as it will not pull in its transitive dependencies otherwise. -->
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index c6c18f6061..325e834fa5 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="10.10.0" />
-    <PackageReference Include="ppy.osu.Framework" Version="2022.421.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2022.423.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.422.0" />
     <PackageReference Include="Sentry" Version="3.14.1" />
     <PackageReference Include="SharpCompress" Version="0.30.1" />
diff --git a/osu.iOS.props b/osu.iOS.props
index 64af0d70f3..8775442be2 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -61,7 +61,7 @@
     <Reference Include="System.Net.Http" />
   </ItemGroup>
   <ItemGroup Label="Package References">
-    <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.421.0" />
+    <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.423.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.422.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net6.0) -->
@@ -84,7 +84,7 @@
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="5.0.14" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.Core" Version="5.0.14" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
-    <PackageReference Include="ppy.osu.Framework" Version="2022.421.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2022.423.0" />
     <PackageReference Include="SharpCompress" Version="0.30.1" />
     <PackageReference Include="NUnit" Version="3.13.2" />
     <PackageReference Include="System.ComponentModel.Annotations" Version="5.0.0" />

From 23ef1e194db1ef1fdaefe0664622547c59c3caed Mon Sep 17 00:00:00 2001
From: maromalo <54760464+maromalo@users.noreply.github.com>
Date: Sat, 23 Apr 2022 01:52:59 -0300
Subject: [PATCH 4264/5547] Code Quality

Whoops.
---
 .../Localisation/JoystickSettingsStrings.cs   |  3 +
 .../Sections/Input/JoystickSettings.cs        | 85 ++++++++++---------
 2 files changed, 46 insertions(+), 42 deletions(-)

diff --git a/osu.Game/Localisation/JoystickSettingsStrings.cs b/osu.Game/Localisation/JoystickSettingsStrings.cs
index 6ae8bb66dc..ee2096ef89 100644
--- a/osu.Game/Localisation/JoystickSettingsStrings.cs
+++ b/osu.Game/Localisation/JoystickSettingsStrings.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 osu.Framework.Localisation;
 
 namespace osu.Game.Localisation
diff --git a/osu.Game/Overlays/Settings/Sections/Input/JoystickSettings.cs b/osu.Game/Overlays/Settings/Sections/Input/JoystickSettings.cs
index fd1dbc876a..aa6d602b6d 100644
--- a/osu.Game/Overlays/Settings/Sections/Input/JoystickSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Input/JoystickSettings.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 osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
@@ -11,52 +14,50 @@ namespace osu.Game.Overlays.Settings.Sections.Input
     public class JoystickSettings : SettingsSubsection
     {
         private readonly JoystickHandler joystickHandler;
-           
-            protected override LocalisableString Header => JoystickSettingsStrings.JoystickGamepad;
-            private readonly BindableNumber<float> deadzoneThreshold = new BindableNumber<float>();
-            private readonly Bindable<bool> enabled = new BindableBool(true);
-            public JoystickSettings(JoystickHandler joystickHandler)
+        protected override LocalisableString Header => JoystickSettingsStrings.JoystickGamepad;
+        private readonly BindableNumber<float> deadzoneThreshold = new BindableNumber<float>();
+        private readonly Bindable<bool> enabled = new BindableBool(true);
+        public JoystickSettings(JoystickHandler joystickHandler)
+        {
+            this.joystickHandler = joystickHandler;
+        }
+        [BackgroundDependencyLoader]
+        private void load()
+        {
+            Children = new Drawable[]
             {
-                this.joystickHandler = joystickHandler;
-            }
-            [BackgroundDependencyLoader]
-            private void load()
-            {
-                Children = new Drawable[]
+                new SettingsCheckbox
                 {
-                    new SettingsCheckbox
-                    {
-                        LabelText = CommonStrings.Enabled,
-                        Current = enabled
-                    },
-                    new DeadzoneSetting
-                    {
-                        LabelText = JoystickSettingsStrings.DeadzoneThreshold,
-                        Current = deadzoneThreshold
-                    },
-                };
-            }
-
-            protected override void LoadComplete()
-            {
-                base.LoadComplete();
-                enabled.BindTo(joystickHandler.Enabled);
-                deadzoneThreshold.BindTo(joystickHandler.DeadzoneThreshold);
-                enabled.BindValueChanged(e => deadzoneThreshold.Disabled = !e.NewValue, true);
-            }
-
-            private class DeadzoneSetting : SettingsSlider<float, DeadzoneSlider>
-            {
-                public DeadzoneSetting()
+                    LabelText = CommonStrings.Enabled,
+                    Current = enabled
+                },
+                new DeadzoneSetting
                 {
-                    KeyboardStep = 0.005f;
-                    TransferValueOnCommit = true;
-                }
-            }
-            
-            private class DeadzoneSlider : OsuSliderBar<float>
+                    LabelText = JoystickSettingsStrings.DeadzoneThreshold,
+                    Current = deadzoneThreshold
+                },
+            };
+        }
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+            enabled.BindTo(joystickHandler.Enabled);
+            deadzoneThreshold.BindTo(joystickHandler.DeadzoneThreshold);
+            enabled.BindValueChanged(e => deadzoneThreshold.Disabled = !e.NewValue, true);
+        }
+
+        private class DeadzoneSetting : SettingsSlider<float, DeadzoneSlider>
+        {
+            public DeadzoneSetting()
             {
-                public override LocalisableString TooltipText => Current.Disabled ? "" : base.TooltipText;
+                KeyboardStep = 0.005f;
+                TransferValueOnCommit = true;
             }
+        }
+        private class DeadzoneSlider : OsuSliderBar<float>
+        {
+            public override LocalisableString TooltipText => Current.Disabled ? "" : base.TooltipText;
+        }
     }
 }
\ No newline at end of file

From 6a87dfdabb8c56d54fffb2355181a9cde95e4eee Mon Sep 17 00:00:00 2001
From: maromalo <54760464+maromalo@users.noreply.github.com>
Date: Sat, 23 Apr 2022 02:14:41 -0300
Subject: [PATCH 4265/5547] More Code Quality

Double whoops.
---
 osu.Game/Overlays/Settings/Sections/Input/JoystickSettings.cs | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/osu.Game/Overlays/Settings/Sections/Input/JoystickSettings.cs b/osu.Game/Overlays/Settings/Sections/Input/JoystickSettings.cs
index aa6d602b6d..aaa8048019 100644
--- a/osu.Game/Overlays/Settings/Sections/Input/JoystickSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Input/JoystickSettings.cs
@@ -17,10 +17,12 @@ namespace osu.Game.Overlays.Settings.Sections.Input
         protected override LocalisableString Header => JoystickSettingsStrings.JoystickGamepad;
         private readonly BindableNumber<float> deadzoneThreshold = new BindableNumber<float>();
         private readonly Bindable<bool> enabled = new BindableBool(true);
+
         public JoystickSettings(JoystickHandler joystickHandler)
         {
             this.joystickHandler = joystickHandler;
         }
+
         [BackgroundDependencyLoader]
         private void load()
         {
@@ -55,6 +57,7 @@ namespace osu.Game.Overlays.Settings.Sections.Input
                 TransferValueOnCommit = true;
             }
         }
+
         private class DeadzoneSlider : OsuSliderBar<float>
         {
             public override LocalisableString TooltipText => Current.Disabled ? "" : base.TooltipText;

From 0133ee962da47e25fcc6255a94833f34db73955b Mon Sep 17 00:00:00 2001
From: maromalo <54760464+maromalo@users.noreply.github.com>
Date: Sat, 23 Apr 2022 02:23:07 -0300
Subject: [PATCH 4266/5547] Change JoystickSettingsStrings.cs text

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

diff --git a/osu.Game/Localisation/JoystickSettingsStrings.cs b/osu.Game/Localisation/JoystickSettingsStrings.cs
index ee2096ef89..410cd0a6f5 100644
--- a/osu.Game/Localisation/JoystickSettingsStrings.cs
+++ b/osu.Game/Localisation/JoystickSettingsStrings.cs
@@ -17,7 +17,7 @@ namespace osu.Game.Localisation
         /// <summary>
         /// "Deadzone Threshold"
         /// </summary>
-        public static LocalisableString DeadzoneThreshold => new TranslatableString(getKey(@"deadzone_threshold"), @"Deadzone Threshold");
+        public static LocalisableString DeadzoneThreshold => new TranslatableString(getKey(@"deadzone_threshold"), @"Deadzone");
 
         private static string getKey(string key) => $@"{prefix}:{key}";
     }

From d97dc22e79021f94249a99cae827d1d25003bac7 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 23 Apr 2022 21:23:41 +0900
Subject: [PATCH 4267/5547] Add missing dependencies for behaviour screen test

---
 .../Visual/UserInterface/TestSceneFirstRunScreenBehaviour.cs | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunScreenBehaviour.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunScreenBehaviour.cs
index d7f0c5ba03..9747b5cc53 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunScreenBehaviour.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunScreenBehaviour.cs
@@ -1,13 +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 osu.Framework.Allocation;
 using osu.Framework.Screens;
+using osu.Game.Overlays;
 using osu.Game.Overlays.FirstRunSetup;
 
 namespace osu.Game.Tests.Visual.UserInterface
 {
     public class TestSceneFirstRunScreenBehaviour : OsuManualInputManagerTestScene
     {
+        [Cached]
+        private OverlayColourProvider colourProvider = new OverlayColourProvider(OverlayColourScheme.Purple);
+
         public TestSceneFirstRunScreenBehaviour()
         {
             AddStep("load screen", () =>

From 5d0842ac447f2912872e6e37d029305baf69b0b7 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 23 Apr 2022 21:53:47 +0900
Subject: [PATCH 4268/5547] Add a few more classic defaults to missed settings

---
 osu.Game/Overlays/Settings/Sections/Gameplay/AudioSettings.cs    | 1 +
 osu.Game/Overlays/Settings/Sections/Gameplay/HUDSettings.cs      | 1 +
 .../Settings/Sections/UserInterface/SongSelectSettings.cs        | 1 +
 3 files changed, 3 insertions(+)

diff --git a/osu.Game/Overlays/Settings/Sections/Gameplay/AudioSettings.cs b/osu.Game/Overlays/Settings/Sections/Gameplay/AudioSettings.cs
index 5029c6a617..6978c77aad 100644
--- a/osu.Game/Overlays/Settings/Sections/Gameplay/AudioSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Gameplay/AudioSettings.cs
@@ -28,6 +28,7 @@ namespace osu.Game.Overlays.Settings.Sections.Gameplay
                 },
                 new SettingsCheckbox
                 {
+                    GetClassicDefault = () => false,
                     LabelText = GameplaySettingsStrings.AlwaysPlayFirstComboBreak,
                     Current = config.GetBindable<bool>(OsuSetting.AlwaysPlayFirstComboBreak)
                 }
diff --git a/osu.Game/Overlays/Settings/Sections/Gameplay/HUDSettings.cs b/osu.Game/Overlays/Settings/Sections/Gameplay/HUDSettings.cs
index ba9779d650..285cdfa3f8 100644
--- a/osu.Game/Overlays/Settings/Sections/Gameplay/HUDSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Gameplay/HUDSettings.cs
@@ -30,6 +30,7 @@ namespace osu.Game.Overlays.Settings.Sections.Gameplay
                 },
                 new SettingsCheckbox
                 {
+                    GetClassicDefault = () => false,
                     LabelText = GameplaySettingsStrings.ShowHealthDisplayWhenCantFail,
                     Current = config.GetBindable<bool>(OsuSetting.ShowHealthDisplayWhenCantFail),
                     Keywords = new[] { "hp", "bar" }
diff --git a/osu.Game/Overlays/Settings/Sections/UserInterface/SongSelectSettings.cs b/osu.Game/Overlays/Settings/Sections/UserInterface/SongSelectSettings.cs
index 6290046987..213234db4f 100644
--- a/osu.Game/Overlays/Settings/Sections/UserInterface/SongSelectSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/UserInterface/SongSelectSettings.cs
@@ -32,6 +32,7 @@ namespace osu.Game.Overlays.Settings.Sections.UserInterface
             {
                 new SettingsCheckbox
                 {
+                    GetClassicDefault = () => true,
                     LabelText = UserInterfaceStrings.RightMouseScroll,
                     Current = config.GetBindable<bool>(OsuSetting.SongSelectRightMouseScroll),
                 },

From 4bf11df57c9ac2ac19646f2ac83a94b75be2279c Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sat, 23 Apr 2022 19:11:54 +0300
Subject: [PATCH 4269/5547] Change `SpriteComponent` accessibility to
 `internal`

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

diff --git a/osu.Game/Skinning/SkinnableSprite.cs b/osu.Game/Skinning/SkinnableSprite.cs
index af9ff0f1d7..21b34fcd27 100644
--- a/osu.Game/Skinning/SkinnableSprite.cs
+++ b/osu.Game/Skinning/SkinnableSprite.cs
@@ -65,7 +65,7 @@ namespace osu.Game.Skinning
 
         public bool UsesFixedAnchor { get; set; }
 
-        public class SpriteComponent : ISkinComponent
+        internal class SpriteComponent : ISkinComponent
         {
             public string LookupName { get; set; }
 

From 5addcbf460d569a385c01b1db5a0918d8343d89c Mon Sep 17 00:00:00 2001
From: maromalo <54760464+maromalo@users.noreply.github.com>
Date: Sat, 23 Apr 2022 13:16:20 -0300
Subject: [PATCH 4270/5547] Changed KeyboardStep to 0.01

---
 osu.Game/Overlays/Settings/Sections/Input/JoystickSettings.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/Settings/Sections/Input/JoystickSettings.cs b/osu.Game/Overlays/Settings/Sections/Input/JoystickSettings.cs
index aaa8048019..ad01c25ac9 100644
--- a/osu.Game/Overlays/Settings/Sections/Input/JoystickSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Input/JoystickSettings.cs
@@ -53,7 +53,7 @@ namespace osu.Game.Overlays.Settings.Sections.Input
         {
             public DeadzoneSetting()
             {
-                KeyboardStep = 0.005f;
+                KeyboardStep = 0.01f;
                 TransferValueOnCommit = true;
             }
         }

From e89441951cab3b2f3142d3b15c535c6cf867cf45 Mon Sep 17 00:00:00 2001
From: Susko3 <Susko3@protonmail.com>
Date: Wed, 20 Apr 2022 22:00:37 +0200
Subject: [PATCH 4271/5547] Allow any key to trigger the initial osu! cookie

---
 osu.Game/Screens/Menu/ButtonSystem.cs | 7 ++-----
 1 file changed, 2 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Screens/Menu/ButtonSystem.cs b/osu.Game/Screens/Menu/ButtonSystem.cs
index 885f4903b0..b48aef330a 100644
--- a/osu.Game/Screens/Menu/ButtonSystem.cs
+++ b/osu.Game/Screens/Menu/ButtonSystem.cs
@@ -196,11 +196,8 @@ namespace osu.Game.Screens.Menu
 
             if (State == ButtonSystemState.Initial)
             {
-                if (buttonsTopLevel.Any(b => e.Key == b.TriggerKey))
-                {
-                    logo?.TriggerClick();
-                    return true;
-                }
+                logo?.TriggerClick();
+                return true;
             }
 
             return base.OnKeyDown(e);

From cdfef088464046ee468ca016579d8362441a8c3e Mon Sep 17 00:00:00 2001
From: Susko3 <Susko3@protonmail.com>
Date: Sat, 23 Apr 2022 18:44:50 +0200
Subject: [PATCH 4272/5547] Add tests for shortcut keys

---
 .../UserInterface/TestSceneButtonSystem.cs    | 63 ++++++++++++++++++-
 1 file changed, 62 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneButtonSystem.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneButtonSystem.cs
index 1bb5cadc6a..1a879e2e70 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneButtonSystem.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneButtonSystem.cs
@@ -10,11 +10,12 @@ using osu.Framework.Graphics.Shapes;
 using osu.Game.Screens.Menu;
 using osuTK;
 using osuTK.Graphics;
+using osuTK.Input;
 
 namespace osu.Game.Tests.Visual.UserInterface
 {
     [TestFixture]
-    public class TestSceneButtonSystem : OsuTestScene
+    public class TestSceneButtonSystem : OsuManualInputManagerTestScene
     {
         private OsuLogo logo;
         private ButtonSystem buttons;
@@ -64,6 +65,66 @@ namespace osu.Game.Tests.Visual.UserInterface
             AddStep("Enter mode", performEnterMode);
         }
 
+        [TestCase(Key.P, true)]
+        [TestCase(Key.M, true)]
+        [TestCase(Key.L, true)]
+        [TestCase(Key.E, false)]
+        [TestCase(Key.D, false)]
+        [TestCase(Key.Q, false)]
+        [TestCase(Key.O, false)]
+        public void TestShortcutKeys(Key key, bool entersPlay)
+        {
+            int activationCount = -1;
+            AddStep("set up action", () =>
+            {
+                activationCount = 0;
+                void action() => activationCount++;
+
+                switch (key)
+                {
+                    case Key.P:
+                        buttons.OnSolo = action;
+                        break;
+
+                    case Key.M:
+                        buttons.OnMultiplayer = action;
+                        break;
+
+                    case Key.L:
+                        buttons.OnPlaylists = action;
+                        break;
+
+                    case Key.E:
+                        buttons.OnEdit = action;
+                        break;
+
+                    case Key.D:
+                        buttons.OnBeatmapListing = action;
+                        break;
+
+                    case Key.Q:
+                        buttons.OnExit = action;
+                        break;
+
+                    case Key.O:
+                        buttons.OnSettings = action;
+                        break;
+                }
+            });
+
+            AddStep($"press {key}", () => InputManager.Key(key));
+            AddAssert("state is top level", () => buttons.State == ButtonSystemState.TopLevel);
+
+            if (entersPlay)
+            {
+                AddStep("press P", () => InputManager.Key(Key.P));
+                AddAssert("state is play", () => buttons.State == ButtonSystemState.Play);
+            }
+
+            AddStep($"press {key}", () => InputManager.Key(key));
+            AddAssert("action triggered", () => activationCount == 1);
+        }
+
         private void performEnterMode()
         {
             buttons.State = ButtonSystemState.EnteringMode;

From 684d88ba7586eb361091f8e235b35c9dc3af54c5 Mon Sep 17 00:00:00 2001
From: Susko3 <Susko3@protonmail.com>
Date: Sat, 23 Apr 2022 19:01:55 +0200
Subject: [PATCH 4273/5547] Add full OsuGame tests

These tests ensure the expected behaviour is not broken in the future.
---
 .../TestSceneButtonSystemNavigation.cs        | 46 +++++++++++++++++++
 1 file changed, 46 insertions(+)
 create mode 100644 osu.Game.Tests/Visual/Navigation/TestSceneButtonSystemNavigation.cs

diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneButtonSystemNavigation.cs b/osu.Game.Tests/Visual/Navigation/TestSceneButtonSystemNavigation.cs
new file mode 100644
index 0000000000..8c96ec699f
--- /dev/null
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneButtonSystemNavigation.cs
@@ -0,0 +1,46 @@
+// 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.Testing;
+using osu.Game.Screens.Menu;
+using osu.Game.Screens.Select;
+using osuTK.Input;
+
+namespace osu.Game.Tests.Visual.Navigation
+{
+    public class TestSceneButtonSystemNavigation : OsuGameTestScene
+    {
+        private ButtonSystem buttons => ((MainMenu)Game.ScreenStack.CurrentScreen).ChildrenOfType<ButtonSystem>().Single();
+
+        [Test]
+        public void TestGlobalActionHasPriority()
+        {
+            AddAssert("state is initial", () => buttons.State == ButtonSystemState.Initial);
+
+            // triggering the cookie in the initial state with any key should only happen if no other action is bound to that key.
+            // here, F10 is bound to GlobalAction.ToggleGameplayMouseButtons.
+            AddStep("press F10", () => InputManager.Key(Key.F10));
+            AddAssert("state is initial", () => buttons.State == ButtonSystemState.Initial);
+
+            AddStep("press P", () => InputManager.Key(Key.P));
+            AddAssert("state is top level", () => buttons.State == ButtonSystemState.TopLevel);
+        }
+
+        [Test]
+        public void TestShortcutKeys()
+        {
+            AddAssert("state is initial", () => buttons.State == ButtonSystemState.Initial);
+
+            AddStep("press P", () => InputManager.Key(Key.P));
+            AddAssert("state is top level", () => buttons.State == ButtonSystemState.TopLevel);
+
+            AddStep("press P", () => InputManager.Key(Key.P));
+            AddAssert("state is play", () => buttons.State == ButtonSystemState.Play);
+
+            AddStep("press P", () => InputManager.Key(Key.P));
+            AddAssert("entered song select", () => Game.ScreenStack.CurrentScreen is PlaySongSelect);
+        }
+    }
+}

From daadc3fc21c35824de511b930ffa06a1fe85c00a Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sat, 23 Apr 2022 23:14:14 +0300
Subject: [PATCH 4274/5547] Simplfiy and share notification dimsiss method
 across test scenes

Might as well inline, but I feel like it will require adding the same
comment across all usages, because just `State.Value = Hidden` in an
until step feels off, dunno.
---
 .../TestSceneChangeAndUseGameplayBindings.cs      |  9 +--------
 .../Navigation/TestSceneMouseWheelVolumeAdjust.cs |  9 +--------
 .../Navigation/TestSceneScreenNavigation.cs       | 15 +++------------
 osu.Game/Tests/Visual/OsuGameTestScene.cs         |  7 +++++++
 4 files changed, 12 insertions(+), 28 deletions(-)

diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneChangeAndUseGameplayBindings.cs b/osu.Game.Tests/Visual/Navigation/TestSceneChangeAndUseGameplayBindings.cs
index 347b4b6c54..b7a74dcd27 100644
--- a/osu.Game.Tests/Visual/Navigation/TestSceneChangeAndUseGameplayBindings.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneChangeAndUseGameplayBindings.cs
@@ -59,8 +59,7 @@ namespace osu.Game.Tests.Visual.Navigation
 
             AddUntilStep("wait for player", () =>
             {
-                // dismiss any notifications that may appear (ie. muted notification).
-                clickMouseInCentre();
+                DismissAnyNotifications();
                 return player != null;
             });
 
@@ -73,12 +72,6 @@ namespace osu.Game.Tests.Visual.Navigation
             AddAssert("key counter did increase", () => keyCounter.CountPresses == 1);
         }
 
-        private void clickMouseInCentre()
-        {
-            InputManager.MoveMouseTo(Game.ScreenSpaceDrawQuad.Centre);
-            InputManager.Click(MouseButton.Left);
-        }
-
         private KeyBindingsSubsection osuBindingSubsection => keyBindingPanel
                                                               .ChildrenOfType<VariantBindingsSubsection>()
                                                               .FirstOrDefault(s => s.Ruleset.ShortName == "osu");
diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneMouseWheelVolumeAdjust.cs b/osu.Game.Tests/Visual/Navigation/TestSceneMouseWheelVolumeAdjust.cs
index 22a00a3e5a..2662b3930c 100644
--- a/osu.Game.Tests/Visual/Navigation/TestSceneMouseWheelVolumeAdjust.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneMouseWheelVolumeAdjust.cs
@@ -89,18 +89,11 @@ namespace osu.Game.Tests.Visual.Navigation
 
             AddUntilStep("wait for player", () =>
             {
-                // dismiss any notifications that may appear (ie. muted notification).
-                clickMouseInCentre();
+                DismissAnyNotifications();
                 return (player = Game.ScreenStack.CurrentScreen as Player) != null;
             });
 
             AddUntilStep("wait for play time active", () => !player.IsBreakTime.Value);
         }
-
-        private void clickMouseInCentre()
-        {
-            InputManager.MoveMouseTo(Game.ScreenSpaceDrawQuad.Centre);
-            InputManager.Click(MouseButton.Left);
-        }
     }
 }
diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs b/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
index 0b7242eee0..296a184f4b 100644
--- a/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
@@ -155,8 +155,7 @@ namespace osu.Game.Tests.Visual.Navigation
 
             AddUntilStep("wait for player", () =>
             {
-                // dismiss any notifications that may appear (ie. muted notification).
-                clickMouseInCentre();
+                DismissAnyNotifications();
                 return (player = Game.ScreenStack.CurrentScreen as Player) != null;
             });
 
@@ -280,8 +279,7 @@ namespace osu.Game.Tests.Visual.Navigation
 
             AddUntilStep("wait for player", () =>
             {
-                // dismiss any notifications that may appear (ie. muted notification).
-                clickMouseInCentre();
+                DismissAnyNotifications();
                 return (player = Game.ScreenStack.CurrentScreen as Player) != null;
             });
 
@@ -596,8 +594,7 @@ namespace osu.Game.Tests.Visual.Navigation
 
             AddUntilStep("wait for player", () =>
             {
-                // dismiss any notifications that may appear (ie. muted notification).
-                clickMouseInCentre();
+                DismissAnyNotifications();
                 return (player = Game.ScreenStack.CurrentScreen as Player) != null;
             });
 
@@ -607,12 +604,6 @@ namespace osu.Game.Tests.Visual.Navigation
             return () => player;
         }
 
-        private void clickMouseInCentre()
-        {
-            InputManager.MoveMouseTo(Game.ScreenSpaceDrawQuad.Centre);
-            InputManager.Click(MouseButton.Left);
-        }
-
         private void pushEscape() =>
             AddStep("Press escape", () => InputManager.Key(Key.Escape));
 
diff --git a/osu.Game/Tests/Visual/OsuGameTestScene.cs b/osu.Game/Tests/Visual/OsuGameTestScene.cs
index 7a6f8c8cfb..1b8f8bfd07 100644
--- a/osu.Game/Tests/Visual/OsuGameTestScene.cs
+++ b/osu.Game/Tests/Visual/OsuGameTestScene.cs
@@ -23,7 +23,9 @@ using osu.Game.Rulesets.Mods;
 using osu.Game.Scoring;
 using osu.Game.Screens;
 using osu.Game.Screens.Menu;
+using osu.Game.Screens.Play;
 using osuTK.Graphics;
+using osuTK.Input;
 using IntroSequence = osu.Game.Configuration.IntroSequence;
 
 namespace osu.Game.Tests.Visual
@@ -106,6 +108,11 @@ namespace osu.Game.Tests.Visual
 
         protected void ConfirmAtMainMenu() => AddUntilStep("Wait for main menu", () => Game.ScreenStack.CurrentScreen is MainMenu menu && menu.IsLoaded);
 
+        /// <summary>
+        /// Dismisses any notifications pushed which block from interacting with the game (or block screens from loading, e.g. <see cref="Player"/>).
+        /// </summary>
+        protected void DismissAnyNotifications() => Game.Notifications.State.Value = Visibility.Hidden;
+
         public class TestOsuGame : OsuGame
         {
             public new const float SIDE_OVERLAY_OFFSET_RATIO = OsuGame.SIDE_OVERLAY_OFFSET_RATIO;

From 6ab188f8f9c52651a64dc26b27534d47a228a133 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sat, 23 Apr 2022 23:15:31 +0300
Subject: [PATCH 4275/5547] Split skin editor scene library test to own file

Rather than stuffing more random cases to `TestSceneScreenNavigation`.
---
 .../Navigation/TestSceneScreenNavigation.cs   | 71 --------------
 .../TestSceneSkinEditorSceneLibrary.cs        | 97 +++++++++++++++++++
 2 files changed, 97 insertions(+), 71 deletions(-)
 create mode 100644 osu.Game.Tests/Visual/Navigation/TestSceneSkinEditorSceneLibrary.cs

diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs b/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
index 296a184f4b..a1f41d4caf 100644
--- a/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
@@ -8,7 +8,6 @@ using osu.Framework.Allocation;
 using osu.Framework.Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
-using osu.Framework.Graphics.UserInterface;
 using osu.Framework.Screens;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
@@ -16,7 +15,6 @@ using osu.Game.Graphics.UserInterface;
 using osu.Game.Online.Leaderboards;
 using osu.Game.Overlays;
 using osu.Game.Overlays.Mods;
-using osu.Game.Overlays.Settings;
 using osu.Game.Overlays.Toolbar;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Osu.Mods;
@@ -24,12 +22,10 @@ using osu.Game.Scoring;
 using osu.Game.Screens.Menu;
 using osu.Game.Screens.OnlinePlay.Lounge;
 using osu.Game.Screens.Play;
-using osu.Game.Screens.Play.HUD.HitErrorMeters;
 using osu.Game.Screens.Ranking;
 using osu.Game.Screens.Select;
 using osu.Game.Screens.Select.Leaderboards;
 using osu.Game.Screens.Select.Options;
-using osu.Game.Skinning.Editor;
 using osu.Game.Tests.Beatmaps.IO;
 using osuTK;
 using osuTK.Input;
@@ -71,73 +67,6 @@ namespace osu.Game.Tests.Visual.Navigation
             AddAssert("Overlay was shown", () => songSelect.ModSelectOverlay.State.Value == Visibility.Visible);
         }
 
-        [Test]
-        public void TestEditComponentDuringGameplay()
-        {
-            Screens.Select.SongSelect songSelect = null;
-            PushAndConfirm(() => songSelect = new TestPlaySongSelect());
-            AddUntilStep("wait for song select", () => songSelect.BeatmapSetsLoaded);
-
-            AddStep("import beatmap", () => BeatmapImportHelper.LoadQuickOszIntoOsu(Game).WaitSafely());
-
-            AddUntilStep("wait for selected", () => !Game.Beatmap.IsDefault);
-
-            SkinEditor skinEditor = null;
-
-            AddStep("open skin editor", () =>
-            {
-                InputManager.PressKey(Key.ControlLeft);
-                InputManager.PressKey(Key.ShiftLeft);
-                InputManager.Key(Key.S);
-                InputManager.ReleaseKey(Key.ControlLeft);
-                InputManager.ReleaseKey(Key.ShiftLeft);
-            });
-
-            AddUntilStep("get skin editor", () => (skinEditor = Game.ChildrenOfType<SkinEditor>().FirstOrDefault()) != null);
-
-            AddStep("Click gameplay scene button", () =>
-            {
-                skinEditor.ChildrenOfType<SkinEditorSceneLibrary.SceneButton>().First(b => b.Text == "Gameplay").TriggerClick();
-            });
-
-            AddUntilStep("wait for player", () =>
-            {
-                // dismiss any notifications that may appear (ie. muted notification).
-                clickMouseInCentre();
-                return Game.ScreenStack.CurrentScreen is Player;
-            });
-
-            BarHitErrorMeter hitErrorMeter = null;
-
-            AddUntilStep("select bar hit error blueprint", () =>
-            {
-                var blueprint = skinEditor.ChildrenOfType<SkinBlueprint>().FirstOrDefault(b => b.Item is BarHitErrorMeter);
-
-                if (blueprint == null)
-                    return false;
-
-                hitErrorMeter = (BarHitErrorMeter)blueprint.Item;
-                skinEditor.SelectedComponents.Clear();
-                skinEditor.SelectedComponents.Add(blueprint.Item);
-                return true;
-            });
-
-            AddAssert("value is default", () => hitErrorMeter.JudgementLineThickness.IsDefault);
-
-            AddStep("hover first slider", () =>
-            {
-                InputManager.MoveMouseTo(
-                    skinEditor.ChildrenOfType<SkinSettingsToolbox>().First()
-                              .ChildrenOfType<SettingsSlider<float>>().First()
-                              .ChildrenOfType<SliderBar<float>>().First()
-                );
-            });
-
-            AddStep("adjust slider via keyboard", () => InputManager.Key(Key.Left));
-
-            AddAssert("value is less than default", () => hitErrorMeter.JudgementLineThickness.Value < hitErrorMeter.JudgementLineThickness.Default);
-        }
-
         [Test]
         public void TestRetryCountIncrements()
         {
diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneSkinEditorSceneLibrary.cs b/osu.Game.Tests/Visual/Navigation/TestSceneSkinEditorSceneLibrary.cs
new file mode 100644
index 0000000000..ed3eae528f
--- /dev/null
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneSkinEditorSceneLibrary.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 System;
+using System.Linq;
+using NUnit.Framework;
+using osu.Framework.Extensions;
+using osu.Framework.Graphics.UserInterface;
+using osu.Framework.Testing;
+using osu.Game.Overlays.Settings;
+using osu.Game.Rulesets.Mods;
+using osu.Game.Rulesets.Osu.Mods;
+using osu.Game.Screens.Play;
+using osu.Game.Screens.Play.HUD.HitErrorMeters;
+using osu.Game.Skinning.Editor;
+using osu.Game.Tests.Beatmaps.IO;
+using osuTK.Input;
+using static osu.Game.Tests.Visual.Navigation.TestSceneScreenNavigation;
+
+namespace osu.Game.Tests.Visual.Navigation
+{
+    public class TestSceneSkinEditorSceneLibrary : OsuGameTestScene
+    {
+        private SkinEditor skinEditor;
+
+        public override void SetUpSteps()
+        {
+            base.SetUpSteps();
+
+            Screens.Select.SongSelect songSelect = null;
+            PushAndConfirm(() => songSelect = new TestPlaySongSelect());
+            AddUntilStep("wait for song select", () => songSelect.BeatmapSetsLoaded);
+
+            AddStep("import beatmap", () => BeatmapImportHelper.LoadQuickOszIntoOsu(Game).WaitSafely());
+
+            AddUntilStep("wait for selected", () => !Game.Beatmap.IsDefault);
+
+            AddStep("open skin editor", () =>
+            {
+                InputManager.PressKey(Key.ControlLeft);
+                InputManager.PressKey(Key.ShiftLeft);
+                InputManager.Key(Key.S);
+                InputManager.ReleaseKey(Key.ControlLeft);
+                InputManager.ReleaseKey(Key.ShiftLeft);
+            });
+
+            AddUntilStep("get skin editor", () => (skinEditor = Game.ChildrenOfType<SkinEditor>().FirstOrDefault()) != null);
+        }
+
+        [Test]
+        public void TestEditComponentDuringGameplay()
+        {
+            switchToGameplayScene();
+
+            BarHitErrorMeter hitErrorMeter = null;
+
+            AddUntilStep("select bar hit error blueprint", () =>
+            {
+                var blueprint = skinEditor.ChildrenOfType<SkinBlueprint>().FirstOrDefault(b => b.Item is BarHitErrorMeter);
+
+                if (blueprint == null)
+                    return false;
+
+                hitErrorMeter = (BarHitErrorMeter)blueprint.Item;
+                skinEditor.SelectedComponents.Clear();
+                skinEditor.SelectedComponents.Add(blueprint.Item);
+                return true;
+            });
+
+            AddAssert("value is default", () => hitErrorMeter.JudgementLineThickness.IsDefault);
+
+            AddStep("hover first slider", () =>
+            {
+                InputManager.MoveMouseTo(
+                    skinEditor.ChildrenOfType<SkinSettingsToolbox>().First()
+                              .ChildrenOfType<SettingsSlider<float>>().First()
+                              .ChildrenOfType<SliderBar<float>>().First()
+                );
+            });
+
+            AddStep("adjust slider via keyboard", () => InputManager.Key(Key.Left));
+
+            AddAssert("value is less than default", () => hitErrorMeter.JudgementLineThickness.Value < hitErrorMeter.JudgementLineThickness.Default);
+        }
+
+        private void switchToGameplayScene()
+        {
+            AddStep("Click gameplay scene button", () => skinEditor.ChildrenOfType<SkinEditorSceneLibrary.SceneButton>().First(b => b.Text == "Gameplay").TriggerClick());
+
+            AddUntilStep("wait for player", () =>
+            {
+                DismissAnyNotifications();
+                return Game.ScreenStack.CurrentScreen is Player;
+            });
+        }
+    }
+}

From 60e76d62c1231ce81e1c7725136fb160f8d4e750 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sat, 23 Apr 2022 23:16:06 +0300
Subject: [PATCH 4276/5547] Add failing test cases

---
 .../TestSceneSkinEditorSceneLibrary.cs        | 40 +++++++++++++++++++
 1 file changed, 40 insertions(+)

diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneSkinEditorSceneLibrary.cs b/osu.Game.Tests/Visual/Navigation/TestSceneSkinEditorSceneLibrary.cs
index ed3eae528f..448d6b1e68 100644
--- a/osu.Game.Tests/Visual/Navigation/TestSceneSkinEditorSceneLibrary.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneSkinEditorSceneLibrary.cs
@@ -83,6 +83,46 @@ namespace osu.Game.Tests.Visual.Navigation
             AddAssert("value is less than default", () => hitErrorMeter.JudgementLineThickness.Value < hitErrorMeter.JudgementLineThickness.Default);
         }
 
+        [Test]
+        public void TestAutoplayCompatibleModsRetainedOnEnteringGameplay()
+        {
+            AddStep("select DT", () => Game.SelectedMods.Value = new Mod[] { new OsuModDoubleTime() });
+
+            switchToGameplayScene();
+
+            AddAssert("DT still selected", () => ((Player)Game.ScreenStack.CurrentScreen).Mods.Value.Single() is OsuModDoubleTime);
+        }
+
+        [Test]
+        public void TestAutoplayIncompatibleModsRemovedOnEnteringGameplay()
+        {
+            AddStep("select no fail and spun out", () => Game.SelectedMods.Value = new Mod[] { new OsuModNoFail(), new OsuModSpunOut() });
+
+            switchToGameplayScene();
+
+            AddAssert("no mod selected", () => !((Player)Game.ScreenStack.CurrentScreen).Mods.Value.Any());
+        }
+
+        [Test]
+        public void TestDuplicateAutoplayModRemovedOnEnteringGameplay()
+        {
+            AddStep("select autoplay", () => Game.SelectedMods.Value = new Mod[] { new OsuModAutoplay() });
+
+            switchToGameplayScene();
+
+            AddAssert("no mod selected", () => !((Player)Game.ScreenStack.CurrentScreen).Mods.Value.Any());
+        }
+
+        [Test]
+        public void TestCinemaModRemovedOnEnteringGameplay()
+        {
+            AddStep("select cinema", () => Game.SelectedMods.Value = new Mod[] { new OsuModCinema() });
+
+            switchToGameplayScene();
+
+            AddAssert("no mod selected", () => !((Player)Game.ScreenStack.CurrentScreen).Mods.Value.Any());
+        }
+
         private void switchToGameplayScene()
         {
             AddStep("Click gameplay scene button", () => skinEditor.ChildrenOfType<SkinEditorSceneLibrary.SceneButton>().First(b => b.Text == "Gameplay").TriggerClick());

From 0ecda46d93261dce4ebae52eaec3da768c16da1e Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sat, 23 Apr 2022 23:16:32 +0300
Subject: [PATCH 4277/5547] Deselect mods incompatible with "Autoplay" when
 entering gameplay via scene library

---
 osu.Game/Skinning/Editor/SkinEditorSceneLibrary.cs | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/osu.Game/Skinning/Editor/SkinEditorSceneLibrary.cs b/osu.Game/Skinning/Editor/SkinEditorSceneLibrary.cs
index 4507526806..2124ba9b6d 100644
--- a/osu.Game/Skinning/Editor/SkinEditorSceneLibrary.cs
+++ b/osu.Game/Skinning/Editor/SkinEditorSceneLibrary.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.Collections.Generic;
+using System.Linq;
 using JetBrains.Annotations;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
@@ -18,6 +20,7 @@ using osu.Game.Rulesets.Mods;
 using osu.Game.Screens;
 using osu.Game.Screens.Play;
 using osu.Game.Screens.Select;
+using osu.Game.Utils;
 using osuTK;
 
 namespace osu.Game.Skinning.Editor
@@ -34,6 +37,9 @@ namespace osu.Game.Skinning.Editor
         [Resolved]
         private IBindable<RulesetInfo> ruleset { get; set; }
 
+        [Resolved]
+        private Bindable<IReadOnlyList<Mod>> mods { get; set; }
+
         public SkinEditorSceneLibrary()
         {
             Height = BUTTON_HEIGHT + padding * 2;
@@ -95,6 +101,10 @@ namespace osu.Game.Skinning.Editor
                                             return;
 
                                         var replayGeneratingMod = ruleset.Value.CreateInstance().GetAutoplayMod();
+
+                                        if (!ModUtils.CheckCompatibleSet(mods.Value.Append(replayGeneratingMod), out var invalid))
+                                            mods.Value = mods.Value.Except(invalid).ToArray();
+
                                         if (replayGeneratingMod != null)
                                             screen.Push(new PlayerLoader(() => new ReplayPlayer((beatmap, mods) => replayGeneratingMod.CreateScoreFromReplayData(beatmap, mods))));
                                     }, new[] { typeof(Player), typeof(SongSelect) })

From e8cf4466b0caee3478ca109329b237608748b12a Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 22 Apr 2022 23:19:03 +0300
Subject: [PATCH 4278/5547] Make sections container test scene more usable

Head busted the moment I opened this test scene.

Cleaned it up a bit to make it easier to test changes.
---
 .../TestSceneSectionsContainer.cs             | 146 ++++++++++++++----
 1 file changed, 115 insertions(+), 31 deletions(-)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneSectionsContainer.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneSectionsContainer.cs
index 2312c57af2..fc2b5e5e09 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneSectionsContainer.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneSectionsContainer.cs
@@ -3,45 +3,79 @@
 
 using System.Linq;
 using NUnit.Framework;
+using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Colour;
+using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Testing;
+using osu.Framework.Utils;
+using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
+using osu.Game.Graphics.Sprites;
 using osuTK.Graphics;
+using osuTK.Input;
 
 namespace osu.Game.Tests.Visual.UserInterface
 {
     public class TestSceneSectionsContainer : OsuManualInputManagerTestScene
     {
-        private readonly SectionsContainer<TestSection> container;
+        private SectionsContainer<TestSection> container;
         private float custom;
-        private const float header_height = 100;
 
-        public TestSceneSectionsContainer()
+        private const float header_expandable_height = 300;
+        private const float header_fixed_height = 100;
+
+        [SetUpSteps]
+        public void SetUpSteps()
         {
-            container = new SectionsContainer<TestSection>
+            AddStep("setup container", () =>
             {
-                RelativeSizeAxes = Axes.Y,
-                Width = 300,
-                Origin = Anchor.Centre,
-                Anchor = Anchor.Centre,
-                FixedHeader = new Box
+                container = new SectionsContainer<TestSection>
                 {
-                    Alpha = 0.5f,
+                    RelativeSizeAxes = Axes.Y,
                     Width = 300,
-                    Height = header_height,
-                    Colour = Color4.Red
-                }
-            };
-            container.SelectedSection.ValueChanged += section =>
-            {
-                if (section.OldValue != null)
-                    section.OldValue.Selected = false;
-                if (section.NewValue != null)
-                    section.NewValue.Selected = true;
-            };
-            Add(container);
+                    Origin = Anchor.Centre,
+                    Anchor = Anchor.Centre,
+                };
+
+                container.SelectedSection.ValueChanged += section =>
+                {
+                    if (section.OldValue != null)
+                        section.OldValue.Selected = false;
+                    if (section.NewValue != null)
+                        section.NewValue.Selected = true;
+                };
+
+                Child = container;
+            });
+
+            AddToggleStep("disable expandable header", v => container.ExpandableHeader = v
+                ? null
+                : new TestBox(@"Expandable Header")
+                {
+                    RelativeSizeAxes = Axes.X,
+                    Height = header_expandable_height,
+                    BackgroundColour = new OsuColour().GreySky,
+                });
+
+            AddToggleStep("disable fixed header", v => container.FixedHeader = v
+                ? null
+                : new TestBox(@"Fixed Header")
+                {
+                    RelativeSizeAxes = Axes.X,
+                    Height = header_fixed_height,
+                    BackgroundColour = new OsuColour().Red.Opacity(0.5f),
+                });
+
+            AddToggleStep("disable footer", v => container.Footer = v
+                ? null
+                : new TestBox("Footer")
+                {
+                    RelativeSizeAxes = Axes.X,
+                    Height = 200,
+                    BackgroundColour = new OsuColour().Green4,
+                });
         }
 
         [Test]
@@ -71,7 +105,6 @@ namespace osu.Game.Tests.Visual.UserInterface
         {
             const int sections_count = 11;
             float[] alternating = { 0.07f, 0.33f, 0.16f, 0.33f };
-            AddStep("clear", () => container.Clear());
             AddStep("fill with sections", () =>
             {
                 for (int i = 0; i < sections_count; i++)
@@ -84,9 +117,9 @@ namespace osu.Game.Tests.Visual.UserInterface
                 AddUntilStep("correct section selected", () => container.SelectedSection.Value == container.Children[scrollIndex]);
                 AddUntilStep("section top is visible", () =>
                 {
-                    float scrollPosition = container.ChildrenOfType<UserTrackingScrollContainer>().First().Current;
-                    float sectionTop = container.Children[scrollIndex].BoundingBox.Top;
-                    return scrollPosition < sectionTop;
+                    var scrollContainer = container.ChildrenOfType<UserTrackingScrollContainer>().Single();
+                    float sectionPosition = scrollContainer.GetChildPosInContent(container.Children[scrollIndex]);
+                    return scrollContainer.Current < sectionPosition;
                 });
             }
 
@@ -101,15 +134,27 @@ namespace osu.Game.Tests.Visual.UserInterface
             AddUntilStep("correct section selected", () => container.SelectedSection.Value == container.Children[sections_count - 1]);
         }
 
-        private static readonly ColourInfo selected_colour = ColourInfo.GradientVertical(Color4.Yellow, Color4.Gold);
+        private static readonly ColourInfo selected_colour = ColourInfo.GradientVertical(new OsuColour().Orange2, new OsuColour().Orange3);
         private static readonly ColourInfo default_colour = ColourInfo.GradientVertical(Color4.White, Color4.DarkGray);
 
         private void append(float multiplier)
         {
-            container.Add(new TestSection
+            float fixedHeaderHeight = container.FixedHeader?.Height ?? 0;
+            float expandableHeaderHeight = container.ExpandableHeader?.Height ?? 0;
+
+            float totalHeaderHeight = expandableHeaderHeight + fixedHeaderHeight;
+            float effectiveHeaderHeight = totalHeaderHeight;
+
+            // if we're in the "next page" of the sections container,
+            // height of the expandable header should not be accounted.
+            var scrollContent = container.ChildrenOfType<UserTrackingScrollContainer>().Single().ScrollContent;
+            if (totalHeaderHeight + scrollContent.Height >= Content.DrawHeight)
+                effectiveHeaderHeight -= expandableHeaderHeight;
+
+            container.Add(new TestSection($"Section #{container.Children.Count + 1}")
             {
                 Width = 300,
-                Height = (container.ChildSize.Y - header_height) * multiplier,
+                Height = (Content.DrawHeight - effectiveHeaderHeight) * multiplier,
                 Colour = default_colour
             });
         }
@@ -120,11 +165,50 @@ namespace osu.Game.Tests.Visual.UserInterface
             InputManager.ScrollVerticalBy(direction);
         }
 
-        private class TestSection : Box
+        private class TestSection : TestBox
         {
             public bool Selected
             {
-                set => Colour = value ? selected_colour : default_colour;
+                set => BackgroundColour = value ? selected_colour : default_colour;
+            }
+
+            public TestSection(string label)
+                : base(label)
+            {
+                BackgroundColour = default_colour;
+            }
+        }
+
+        private class TestBox : Container
+        {
+            private readonly Box background;
+            private readonly OsuSpriteText text;
+
+            public ColourInfo BackgroundColour
+            {
+                set
+                {
+                    background.Colour = value;
+                    text.Colour = OsuColour.ForegroundTextColourFor(value.AverageColour);
+                }
+            }
+
+            public TestBox(string label)
+            {
+                Children = new Drawable[]
+                {
+                    background = new Box
+                    {
+                        RelativeSizeAxes = Axes.Both,
+                    },
+                    text = new OsuSpriteText
+                    {
+                        Anchor = Anchor.Centre,
+                        Origin = Anchor.Centre,
+                        Text = label,
+                        Font = OsuFont.Default.With(size: 36),
+                    }
+                };
             }
         }
     }

From 05736fb84ce8404070d38180efa663a5a3d67dd6 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sun, 24 Apr 2022 01:09:24 +0300
Subject: [PATCH 4279/5547] Add failing test case for navigation via
 PageUp/PageDown

---
 .../TestSceneSectionsContainer.cs             | 29 +++++++++++++++++++
 1 file changed, 29 insertions(+)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneSectionsContainer.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneSectionsContainer.cs
index fc2b5e5e09..1f3736bd9b 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneSectionsContainer.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneSectionsContainer.cs
@@ -134,6 +134,35 @@ namespace osu.Game.Tests.Visual.UserInterface
             AddUntilStep("correct section selected", () => container.SelectedSection.Value == container.Children[sections_count - 1]);
         }
 
+        [Test]
+        public void TestNavigation()
+        {
+            AddRepeatStep("add sections", () => append(1f), 3);
+            AddUntilStep("wait for load", () => container.Children.Any());
+
+            AddStep("hover sections container", () => InputManager.MoveMouseTo(container));
+            AddStep("press page down", () => InputManager.Key(Key.PageDown));
+            AddUntilStep("scrolled one page down", () =>
+            {
+                var scroll = container.ChildrenOfType<UserTrackingScrollContainer>().First();
+                return Precision.AlmostEquals(scroll.Current, Content.DrawHeight - header_fixed_height, 1f);
+            });
+
+            AddStep("press page down", () => InputManager.Key(Key.PageDown));
+            AddUntilStep("scrolled two pages down", () =>
+            {
+                var scroll = container.ChildrenOfType<UserTrackingScrollContainer>().First();
+                return Precision.AlmostEquals(scroll.Current, (Content.DrawHeight - header_fixed_height) * 2, 1f);
+            });
+
+            AddStep("press page up", () => InputManager.Key(Key.PageUp));
+            AddUntilStep("scrolled one page up", () =>
+            {
+                var scroll = container.ChildrenOfType<UserTrackingScrollContainer>().First();
+                return Precision.AlmostEquals(scroll.Current, Content.DrawHeight - header_fixed_height, 1f);
+            });
+        }
+
         private static readonly ColourInfo selected_colour = ColourInfo.GradientVertical(new OsuColour().Orange2, new OsuColour().Orange3);
         private static readonly ColourInfo default_colour = ColourInfo.GradientVertical(Color4.White, Color4.DarkGray);
 

From 3700c607d8fc9844d406496a8c6ff0d843aa9d06 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sat, 23 Apr 2022 06:03:54 +0300
Subject: [PATCH 4280/5547] Fix sections scroll container not handling fixed
 header in scrolls

---
 osu.Game/Graphics/Containers/SectionsContainer.cs | 14 ++++++++------
 1 file changed, 8 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Graphics/Containers/SectionsContainer.cs b/osu.Game/Graphics/Containers/SectionsContainer.cs
index 540ca85809..9fa8b352cf 100644
--- a/osu.Game/Graphics/Containers/SectionsContainer.cs
+++ b/osu.Game/Graphics/Containers/SectionsContainer.cs
@@ -149,13 +149,11 @@ namespace osu.Game.Graphics.Containers
         {
             lastKnownScroll = null;
 
-            float fixedHeaderSize = FixedHeader?.BoundingBox.Height ?? 0;
-
             // implementation similar to ScrollIntoView but a bit more nuanced.
             float top = scrollContainer.GetChildPosInContent(target);
 
-            float bottomScrollExtent = scrollContainer.ScrollableExtent - fixedHeaderSize;
-            float scrollTarget = top - fixedHeaderSize - scrollContainer.DisplayableContent * scroll_y_centre;
+            float bottomScrollExtent = scrollContainer.ScrollableExtent;
+            float scrollTarget = top - scrollContainer.DisplayableContent * scroll_y_centre;
 
             if (scrollTarget > bottomScrollExtent)
                 scrollContainer.ScrollToEnd();
@@ -270,9 +268,13 @@ namespace osu.Game.Graphics.Containers
         {
             if (!Children.Any()) return;
 
-            var newMargin = originalSectionsMargin;
+            // if a fixed header is present, apply top padding for it
+            // to make the scroll container aware of its displayable area.
+            // (i.e. for page up/down to work properly)
+            scrollContainer.Padding = new MarginPadding { Top = FixedHeader?.LayoutSize.Y ?? 0 };
 
-            newMargin.Top += (headerHeight ?? 0);
+            var newMargin = originalSectionsMargin;
+            newMargin.Top += (ExpandableHeader?.LayoutSize.Y ?? 0);
             newMargin.Bottom += (footerHeight ?? 0);
 
             scrollContentContainer.Margin = newMargin;

From 70a93c0e7eb66c3316e5c4d0a38a96dc7ebc0db7 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sun, 24 Apr 2022 07:08:53 +0300
Subject: [PATCH 4281/5547] Move `DistanceSpacingMultiplier` bindable to its
 own `IDistanceSnapProvider` interface

---
 .../Editor/TestSceneManiaBeatSnapGrid.cs        |  3 ---
 .../Editor/TestSceneOsuDistanceSnapGrid.cs      |  4 ++--
 .../Visual/Editing/TestSceneDistanceSnapGrid.cs |  4 ++--
 osu.Game/Rulesets/Edit/IDistanceSnapProvider.cs | 17 +++++++++++++++++
 osu.Game/Rulesets/Edit/IPositionSnapProvider.cs | 10 ++--------
 .../Edit/Compose/Components/DistanceSnapGrid.cs |  2 +-
 6 files changed, 24 insertions(+), 16 deletions(-)
 create mode 100644 osu.Game/Rulesets/Edit/IDistanceSnapProvider.cs

diff --git a/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneManiaBeatSnapGrid.cs b/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneManiaBeatSnapGrid.cs
index f32a1a823e..50be13c4e0 100644
--- a/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneManiaBeatSnapGrid.cs
+++ b/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneManiaBeatSnapGrid.cs
@@ -4,7 +4,6 @@
 using System.Collections.Generic;
 using System.Linq;
 using osu.Framework.Allocation;
-using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Input.Events;
 using osu.Framework.Timing;
@@ -99,8 +98,6 @@ namespace osu.Game.Rulesets.Mania.Tests.Editor
             set => InternalChild = value;
         }
 
-        public override IBindable<double> DistanceSpacingMultiplier => throw new System.NotImplementedException();
-
         public override SnapResult SnapScreenSpacePositionToValidTime(Vector2 screenSpacePosition)
         {
             throw new System.NotImplementedException();
diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuDistanceSnapGrid.cs b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuDistanceSnapGrid.cs
index 38a442d48b..2ba30c5f74 100644
--- a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuDistanceSnapGrid.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuDistanceSnapGrid.cs
@@ -34,7 +34,7 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
         [Cached]
         private readonly BindableBeatDivisor beatDivisor = new BindableBeatDivisor();
 
-        [Cached(typeof(IPositionSnapProvider))]
+        [Cached(typeof(IDistanceSnapProvider))]
         private readonly SnapProvider snapProvider = new SnapProvider();
 
         private TestOsuDistanceSnapGrid grid;
@@ -180,7 +180,7 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
             }
         }
 
-        private class SnapProvider : IPositionSnapProvider
+        private class SnapProvider : IDistanceSnapProvider
         {
             public SnapResult SnapScreenSpacePositionToValidPosition(Vector2 screenSpacePosition) =>
                 new SnapResult(screenSpacePosition, null);
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneDistanceSnapGrid.cs b/osu.Game.Tests/Visual/Editing/TestSceneDistanceSnapGrid.cs
index 69fd642143..b9cfa84a5d 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneDistanceSnapGrid.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneDistanceSnapGrid.cs
@@ -26,7 +26,7 @@ namespace osu.Game.Tests.Visual.Editing
         [Cached(typeof(EditorBeatmap))]
         private readonly EditorBeatmap editorBeatmap;
 
-        [Cached(typeof(IPositionSnapProvider))]
+        [Cached(typeof(IDistanceSnapProvider))]
         private readonly SnapProvider snapProvider = new SnapProvider();
 
         public TestSceneDistanceSnapGrid()
@@ -160,7 +160,7 @@ namespace osu.Game.Tests.Visual.Editing
                 => (Vector2.Zero, 0);
         }
 
-        private class SnapProvider : IPositionSnapProvider
+        private class SnapProvider : IDistanceSnapProvider
         {
             public SnapResult SnapScreenSpacePositionToValidPosition(Vector2 screenSpacePosition) =>
                 new SnapResult(screenSpacePosition, null);
diff --git a/osu.Game/Rulesets/Edit/IDistanceSnapProvider.cs b/osu.Game/Rulesets/Edit/IDistanceSnapProvider.cs
new file mode 100644
index 0000000000..70921a6170
--- /dev/null
+++ b/osu.Game/Rulesets/Edit/IDistanceSnapProvider.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.Framework.Bindables;
+using osu.Game.Beatmaps;
+
+namespace osu.Game.Rulesets.Edit
+{
+    public interface IDistanceSnapProvider : IPositionSnapProvider
+    {
+        /// <summary>
+        /// The spacing multiplier applied to beat snap distances.
+        /// </summary>
+        /// <seealso cref="BeatmapInfo.DistanceSpacing"/>
+        IBindable<double> DistanceSpacingMultiplier { get; }
+    }
+}
diff --git a/osu.Game/Rulesets/Edit/IPositionSnapProvider.cs b/osu.Game/Rulesets/Edit/IPositionSnapProvider.cs
index e4adbba47d..944619a3ca 100644
--- a/osu.Game/Rulesets/Edit/IPositionSnapProvider.cs
+++ b/osu.Game/Rulesets/Edit/IPositionSnapProvider.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 osu.Framework.Bindables;
-using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Objects;
 using osuTK;
 
@@ -10,12 +8,6 @@ namespace osu.Game.Rulesets.Edit
 {
     public interface IPositionSnapProvider
     {
-        /// <summary>
-        /// The spacing multiplier applied to beat snap distances.
-        /// </summary>
-        /// <seealso cref="BeatmapInfo.DistanceSpacing"/>
-        IBindable<double> DistanceSpacingMultiplier { get; }
-
         /// <summary>
         /// Given a position, find a valid time and position snap.
         /// </summary>
@@ -38,6 +30,8 @@ namespace osu.Game.Rulesets.Edit
         /// </summary>
         /// <param name="referenceObject">An object to be used as a reference point for this operation.</param>
         /// <returns>The distance between two points residing in the timing point that are one beat length apart.</returns>
+        // todo: this, and other distance-related methods below it, should move to IDistanceSnapProvider.
+        // needs thought on how to properly share implementation, since not all composers inherit IDistanceSnapProvider.
         float GetBeatSnapDistanceAt(HitObject referenceObject);
 
         /// <summary>
diff --git a/osu.Game/Screens/Edit/Compose/Components/DistanceSnapGrid.cs b/osu.Game/Screens/Edit/Compose/Components/DistanceSnapGrid.cs
index f9e4ef086c..9dd6cec8ce 100644
--- a/osu.Game/Screens/Edit/Compose/Components/DistanceSnapGrid.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/DistanceSnapGrid.cs
@@ -45,7 +45,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
         protected OsuColour Colours { get; private set; }
 
         [Resolved]
-        protected IPositionSnapProvider SnapProvider { get; private set; }
+        protected IDistanceSnapProvider SnapProvider { get; private set; }
 
         [Resolved]
         private EditorBeatmap beatmap { get; set; }

From 8ed39009fd5301396d5d98be2a98c9dd6e3a3d87 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sun, 24 Apr 2022 07:10:30 +0300
Subject: [PATCH 4282/5547] Encapsulate distance spacing control handling to a
 "distance toolbox composite"

Encapsulated in a way which can allow further extensibility for the
right-side area of toolboxes.
---
 .../Edit/CatchHitObjectComposer.cs            |   5 +-
 .../Edit/ManiaHitObjectComposer.cs            |   2 -
 .../Editor/TestSceneObjectObjectSnap.cs       |   4 +-
 .../Editor/TestSceneSliderSnapping.cs         |   3 +-
 .../Edit/OsuHitObjectComposer.cs              |  12 +-
 .../Edit/OsuToolboxComposite.cs               | 119 ++++++++++++++++++
 .../Edit/TaikoHitObjectComposer.cs            |   2 -
 .../Overlays/Settings/Sections/SizeSlider.cs  |   2 +-
 osu.Game/Rulesets/Edit/HitObjectComposer.cs   |  99 +--------------
 9 files changed, 137 insertions(+), 111 deletions(-)
 create mode 100644 osu.Game.Rulesets.Osu/Edit/OsuToolboxComposite.cs

diff --git a/osu.Game.Rulesets.Catch/Edit/CatchHitObjectComposer.cs b/osu.Game.Rulesets.Catch/Edit/CatchHitObjectComposer.cs
index 19595de3b1..b3e6fe382a 100644
--- a/osu.Game.Rulesets.Catch/Edit/CatchHitObjectComposer.cs
+++ b/osu.Game.Rulesets.Catch/Edit/CatchHitObjectComposer.cs
@@ -24,6 +24,9 @@ using osuTK;
 
 namespace osu.Game.Rulesets.Catch.Edit
 {
+    /// <remarks>
+    /// todo: should inherit <see cref="IDistanceSnapProvider"/> once it supports distance spacing properly.
+    /// </remarks>
     public class CatchHitObjectComposer : HitObjectComposer<CatchHitObject>
     {
         private const float distance_snap_radius = 50;
@@ -32,8 +35,6 @@ namespace osu.Game.Rulesets.Catch.Edit
 
         private readonly Bindable<TernaryState> distanceSnapToggle = new Bindable<TernaryState>();
 
-        protected override bool SupportsDistanceSpacing => false;
-
         private InputManager inputManager;
 
         public CatchHitObjectComposer(CatchRuleset ruleset)
diff --git a/osu.Game.Rulesets.Mania/Edit/ManiaHitObjectComposer.cs b/osu.Game.Rulesets.Mania/Edit/ManiaHitObjectComposer.cs
index 5752f9f014..2baec95c94 100644
--- a/osu.Game.Rulesets.Mania/Edit/ManiaHitObjectComposer.cs
+++ b/osu.Game.Rulesets.Mania/Edit/ManiaHitObjectComposer.cs
@@ -26,8 +26,6 @@ namespace osu.Game.Rulesets.Mania.Edit
         private ManiaBeatSnapGrid beatSnapGrid;
         private InputManager inputManager;
 
-        protected override bool SupportsDistanceSpacing => false;
-
         public ManiaHitObjectComposer(Ruleset ruleset)
             : base(ruleset)
         {
diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneObjectObjectSnap.cs b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneObjectObjectSnap.cs
index aa0e35102e..954bb53dd5 100644
--- a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneObjectObjectSnap.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneObjectObjectSnap.cs
@@ -7,7 +7,7 @@ using osu.Framework.Bindables;
 using osu.Framework.Testing;
 using osu.Framework.Utils;
 using osu.Game.Beatmaps;
-using osu.Game.Rulesets.Edit;
+using osu.Game.Rulesets.Osu.Edit;
 using osu.Game.Rulesets.Osu.Objects;
 using osu.Game.Rulesets.Osu.UI;
 using osu.Game.Tests.Beatmaps;
@@ -30,7 +30,7 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
             AddStep("seek to first control point", () => EditorClock.Seek(Beatmap.Value.Beatmap.ControlPointInfo.TimingPoints.First().Time));
             AddStep("set distance spacing to 1", () =>
             {
-                var distanceSpacing = (BindableDouble)Editor.ChildrenOfType<HitObjectComposer>().Single().DistanceSpacingMultiplier;
+                var distanceSpacing = (BindableDouble)Editor.ChildrenOfType<OsuHitObjectComposer>().Single().DistanceSpacingMultiplier;
                 distanceSpacing.Value = 1;
             });
         }
diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderSnapping.cs b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderSnapping.cs
index 13ce340362..2632e556c6 100644
--- a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderSnapping.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderSnapping.cs
@@ -11,7 +11,6 @@ using osu.Framework.Utils;
 using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.ControlPoints;
 using osu.Game.Input.Bindings;
-using osu.Game.Rulesets.Edit;
 using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Osu.Edit;
 using osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders.Components;
@@ -69,7 +68,7 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
             });
             AddStep("set distance spacing to 1", () =>
             {
-                var distanceSpacing = (BindableDouble)Editor.ChildrenOfType<HitObjectComposer>().Single().DistanceSpacingMultiplier;
+                var distanceSpacing = (BindableDouble)Editor.ChildrenOfType<OsuHitObjectComposer>().Single().DistanceSpacingMultiplier;
                 distanceSpacing.Value = 1;
             });
         }
diff --git a/osu.Game.Rulesets.Osu/Edit/OsuHitObjectComposer.cs b/osu.Game.Rulesets.Osu/Edit/OsuHitObjectComposer.cs
index e7eabdc748..a52c916ca0 100644
--- a/osu.Game.Rulesets.Osu/Edit/OsuHitObjectComposer.cs
+++ b/osu.Game.Rulesets.Osu/Edit/OsuHitObjectComposer.cs
@@ -24,9 +24,12 @@ using osuTK;
 
 namespace osu.Game.Rulesets.Osu.Edit
 {
-    public class OsuHitObjectComposer : HitObjectComposer<OsuHitObject>
+    [Cached(typeof(IDistanceSnapProvider))]
+    public class OsuHitObjectComposer : HitObjectComposer<OsuHitObject>, IDistanceSnapProvider
     {
-        protected override bool SupportsDistanceSpacing => true;
+        private OsuToolboxComposite osuToolboxComposite;
+
+        public IBindable<double> DistanceSpacingMultiplier => osuToolboxComposite.DistanceSpacing;
 
         public OsuHitObjectComposer(Ruleset ruleset)
             : base(ruleset)
@@ -76,6 +79,8 @@ namespace osu.Game.Rulesets.Osu.Edit
                 }
             });
 
+            AddInternal(osuToolboxComposite = new OsuToolboxComposite());
+
             selectedHitObjects = EditorBeatmap.SelectedHitObjects.GetBoundCopy();
             selectedHitObjects.CollectionChanged += (_, __) => updateDistanceSnapGrid();
 
@@ -130,6 +135,9 @@ namespace osu.Game.Rulesets.Osu.Edit
             }
         }
 
+        public override float GetBeatSnapDistanceAt(HitObject referenceObject)
+            => (float)(base.GetBeatSnapDistanceAt(referenceObject) * DistanceSpacingMultiplier.Value);
+
         public override SnapResult SnapScreenSpacePositionToValidPosition(Vector2 screenSpacePosition)
         {
             if (snapToVisibleBlueprints(screenSpacePosition, out var snapResult))
diff --git a/osu.Game.Rulesets.Osu/Edit/OsuToolboxComposite.cs b/osu.Game.Rulesets.Osu/Edit/OsuToolboxComposite.cs
new file mode 100644
index 0000000000..b0298e4034
--- /dev/null
+++ b/osu.Game.Rulesets.Osu/Edit/OsuToolboxComposite.cs
@@ -0,0 +1,119 @@
+// 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.Input.Events;
+using osu.Game.Graphics.Containers;
+using osu.Game.Graphics.UserInterface;
+using osu.Game.Overlays.Settings.Sections;
+using osu.Game.Rulesets.Edit;
+using osu.Game.Screens.Edit;
+using osuTK;
+using osuTK.Input;
+
+namespace osu.Game.Rulesets.Osu.Edit
+{
+    /// <summary>
+    /// A toolbox composite for osu!-specific controls.
+    /// </summary>
+    // todo: once catch supports distance spacing, the control here should move out to a base "DistancingRulesetToolboxComposite" class or something better.
+    public class OsuToolboxComposite : CompositeDrawable
+    {
+        private ExpandingToolboxContainer expandingContainer;
+        private ExpandableSlider<double, SizeSlider<double>> distanceSpacingSlider;
+
+        private readonly Bindable<double> distanceSpacing = new BindableDouble(1.0)
+        {
+            MinValue = 0.1,
+            MaxValue = 6.0,
+            Precision = 0.01,
+        };
+
+        public IBindable<double> DistanceSpacing => distanceSpacing;
+
+        private bool distanceSpacingScrollActive;
+
+        [Resolved]
+        private EditorBeatmap editorBeatmap { get; set; }
+
+        [BackgroundDependencyLoader]
+        private void load()
+        {
+            RelativeSizeAxes = Axes.Both;
+
+            InternalChild = expandingContainer = new ExpandingToolboxContainer
+            {
+                Anchor = Anchor.TopRight,
+                Origin = Anchor.TopRight,
+                Child = new EditorToolboxGroup("snapping")
+                {
+                    Child = distanceSpacingSlider = new ExpandableSlider<double, SizeSlider<double>>
+                    {
+                        Current = { BindTarget = distanceSpacing },
+                        KeyboardStep = 0.1f,
+                    }
+                }
+            };
+        }
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            distanceSpacing.Value = editorBeatmap.BeatmapInfo.DistanceSpacing;
+            distanceSpacing.BindValueChanged(v =>
+            {
+                distanceSpacingSlider.ContractedLabelText = $"D. S. ({v.NewValue:0.##x})";
+                distanceSpacingSlider.ExpandedLabelText = $"Distance Spacing ({v.NewValue:0.##x})";
+                editorBeatmap.BeatmapInfo.DistanceSpacing = v.NewValue;
+            }, true);
+        }
+
+        protected override bool OnKeyDown(KeyDownEvent e)
+        {
+            if (e.AltPressed && e.Key == Key.D && !e.Repeat)
+            {
+                expandingContainer.Expanded.Value = true;
+                distanceSpacingScrollActive = true;
+                return true;
+            }
+
+            return base.OnKeyDown(e);
+        }
+
+        protected override void OnKeyUp(KeyUpEvent e)
+        {
+            if (distanceSpacingScrollActive && (!e.AltPressed || e.Key == Key.D))
+            {
+                expandingContainer.Expanded.Value = false;
+                distanceSpacingScrollActive = false;
+            }
+        }
+
+        protected override bool OnScroll(ScrollEvent e)
+        {
+            if (distanceSpacingScrollActive)
+            {
+                distanceSpacing.Value += e.ScrollDelta.Y * (e.IsPrecise ? 0.01f : 0.1f);
+                return true;
+            }
+
+            return base.OnScroll(e);
+        }
+
+        private class ExpandingToolboxContainer : ExpandingContainer
+        {
+            public ExpandingToolboxContainer()
+                : base(130, 250)
+            {
+                RelativeSizeAxes = Axes.Y;
+                Padding = new MarginPadding { Left = 10 };
+
+                FillFlow.Spacing = new Vector2(10);
+            }
+        }
+    }
+}
diff --git a/osu.Game.Rulesets.Taiko/Edit/TaikoHitObjectComposer.cs b/osu.Game.Rulesets.Taiko/Edit/TaikoHitObjectComposer.cs
index af9bc6c3a3..161799c980 100644
--- a/osu.Game.Rulesets.Taiko/Edit/TaikoHitObjectComposer.cs
+++ b/osu.Game.Rulesets.Taiko/Edit/TaikoHitObjectComposer.cs
@@ -11,8 +11,6 @@ namespace osu.Game.Rulesets.Taiko.Edit
 {
     public class TaikoHitObjectComposer : HitObjectComposer<TaikoHitObject>
     {
-        protected override bool SupportsDistanceSpacing => false;
-
         public TaikoHitObjectComposer(TaikoRuleset ruleset)
             : base(ruleset)
         {
diff --git a/osu.Game/Overlays/Settings/Sections/SizeSlider.cs b/osu.Game/Overlays/Settings/Sections/SizeSlider.cs
index 26db1aa755..c8a46162af 100644
--- a/osu.Game/Overlays/Settings/Sections/SizeSlider.cs
+++ b/osu.Game/Overlays/Settings/Sections/SizeSlider.cs
@@ -11,7 +11,7 @@ namespace osu.Game.Overlays.Settings.Sections
     /// <summary>
     /// A slider intended to show a "size" multiplier number, where 1x is 1.0.
     /// </summary>
-    internal class SizeSlider<T> : OsuSliderBar<T>
+    public class SizeSlider<T> : OsuSliderBar<T>
         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/Rulesets/Edit/HitObjectComposer.cs b/osu.Game/Rulesets/Edit/HitObjectComposer.cs
index ab82fbad04..8d2bd1e5d1 100644
--- a/osu.Game/Rulesets/Edit/HitObjectComposer.cs
+++ b/osu.Game/Rulesets/Edit/HitObjectComposer.cs
@@ -14,8 +14,6 @@ using osu.Framework.Input.Events;
 using osu.Framework.Logging;
 using osu.Game.Beatmaps;
 using osu.Game.Graphics.Containers;
-using osu.Game.Graphics.UserInterface;
-using osu.Game.Overlays.Settings.Sections;
 using osu.Game.Rulesets.Configuration;
 using osu.Game.Rulesets.Edit.Tools;
 using osu.Game.Rulesets.Mods;
@@ -58,26 +56,6 @@ namespace osu.Game.Rulesets.Edit
         [Resolved]
         protected IBeatSnapProvider BeatSnapProvider { get; private set; }
 
-        /// <summary>
-        /// Whether this composer supports a "distance spacing" multiplier for distance snap grids.
-        /// </summary>
-        /// <remarks>
-        /// Setting this to <see langword="true"/> displays a "distance spacing" slider and allows this composer to configure the value of <see cref="BeatmapInfo.DistanceSpacing"/>.
-        /// </remarks>
-        protected abstract bool SupportsDistanceSpacing { get; }
-
-        private readonly BindableDouble distanceSpacing = new BindableDouble
-        {
-            Default = 1.0,
-            MinValue = 0.1,
-            MaxValue = 6.0,
-            Precision = 0.01,
-        };
-
-        public override IBindable<double> DistanceSpacingMultiplier => distanceSpacing;
-
-        private SnappingToolboxContainer snappingToolboxContainer;
-
         protected ComposeBlueprintContainer BlueprintContainer { get; private set; }
 
         private DrawableEditorRulesetWrapper<TObject> drawableRulesetWrapper;
@@ -161,36 +139,6 @@ namespace osu.Game.Rulesets.Edit
                 },
             };
 
-            distanceSpacing.Value = EditorBeatmap.BeatmapInfo.DistanceSpacing;
-
-            if (SupportsDistanceSpacing)
-            {
-                ExpandableSlider<double, SizeSlider<double>> distanceSpacingSlider;
-
-                AddInternal(snappingToolboxContainer = new SnappingToolboxContainer
-                {
-                    Anchor = Anchor.TopRight,
-                    Origin = Anchor.TopRight,
-                    Child = new EditorToolboxGroup("snapping")
-                    {
-                        Child = distanceSpacingSlider = new ExpandableSlider<double, SizeSlider<double>>
-                        {
-                            Current = { BindTarget = distanceSpacing },
-                            KeyboardStep = 0.01f,
-                        }
-                    }
-                });
-
-                distanceSpacing.BindValueChanged(v =>
-                {
-                    distanceSpacingSlider.ContractedLabelText = $"D. S. ({v.NewValue:0.##x})";
-                    distanceSpacingSlider.ExpandedLabelText = $"Distance Spacing ({v.NewValue:0.##x})";
-                    EditorBeatmap.BeatmapInfo.DistanceSpacing = v.NewValue;
-                }, true);
-            }
-            else
-                distanceSpacing.Disabled = true;
-
             toolboxCollection.Items = CompositionTools
                                       .Prepend(new SelectTool())
                                       .Select(t => new RadioButton(t.Name, () => toolSelected(t), t.CreateIcon))
@@ -265,17 +213,8 @@ namespace osu.Game.Rulesets.Edit
 
         #region Tool selection logic
 
-        private bool distanceSpacingScrollActive;
-
         protected override bool OnKeyDown(KeyDownEvent e)
         {
-            if (SupportsDistanceSpacing && e.AltPressed && e.Key == Key.D && !e.Repeat)
-            {
-                snappingToolboxContainer.Expanded.Value = true;
-                distanceSpacingScrollActive = true;
-                return true;
-            }
-
             if (e.ControlPressed || e.AltPressed || e.SuperPressed)
                 return false;
 
@@ -305,28 +244,6 @@ namespace osu.Game.Rulesets.Edit
             return base.OnKeyDown(e);
         }
 
-        protected override void OnKeyUp(KeyUpEvent e)
-        {
-            if (distanceSpacingScrollActive && (e.Key == Key.AltLeft || e.Key == Key.AltRight || e.Key == Key.D))
-            {
-                snappingToolboxContainer.Expanded.Value = false;
-                distanceSpacingScrollActive = false;
-            }
-
-            base.OnKeyUp(e);
-        }
-
-        protected override bool OnScroll(ScrollEvent e)
-        {
-            if (distanceSpacingScrollActive)
-            {
-                distanceSpacing.Value += e.ScrollDelta.Y * (e.IsPrecise ? 0.01f : 0.1f);
-                return true;
-            }
-
-            return base.OnScroll(e);
-        }
-
         private bool checkLeftToggleFromKey(Key key, out int index)
         {
             if (key < Key.Number1 || key > Key.Number9)
@@ -468,7 +385,7 @@ namespace osu.Game.Rulesets.Edit
 
         public override float GetBeatSnapDistanceAt(HitObject referenceObject)
         {
-            return (float)(100 * referenceObject.DifficultyControlPoint.SliderVelocity * EditorBeatmap.Difficulty.SliderMultiplier * distanceSpacing.Value / BeatSnapProvider.BeatDivisor);
+            return (float)(100 * referenceObject.DifficultyControlPoint.SliderVelocity * EditorBeatmap.Difficulty.SliderMultiplier / BeatSnapProvider.BeatDivisor);
         }
 
         public override float DurationToDistance(HitObject referenceObject, double duration)
@@ -517,18 +434,6 @@ namespace osu.Game.Rulesets.Edit
                 FillFlow.Spacing = new Vector2(10);
             }
         }
-
-        private class SnappingToolboxContainer : ExpandingContainer
-        {
-            public SnappingToolboxContainer()
-                : base(130, 250)
-            {
-                RelativeSizeAxes = Axes.Y;
-                Padding = new MarginPadding { Left = 10 };
-
-                FillFlow.Spacing = new Vector2(10);
-            }
-        }
     }
 
     /// <summary>
@@ -563,8 +468,6 @@ namespace osu.Game.Rulesets.Edit
 
         #region IPositionSnapProvider
 
-        public abstract IBindable<double> DistanceSpacingMultiplier { get; }
-
         public abstract SnapResult SnapScreenSpacePositionToValidTime(Vector2 screenSpacePosition);
 
         public virtual SnapResult SnapScreenSpacePositionToValidPosition(Vector2 screenSpacePosition) =>

From 0738cd028f5824cf6f9a0511ee9321d8e6876000 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sun, 24 Apr 2022 08:53:10 +0300
Subject: [PATCH 4283/5547] Give snapping toolbox enough hover delay for
 interaction with expand button

With 0 delay, if the `SettingsToolboxGroup` has been contracted via
button, there's no chance to be able to expand it via button again.

This is temporary at best just to keep things working somewhat, not sure
if the expansion logic will still be required in editor redesign, so
deciding to roll with it for now.
---
 osu.Game.Rulesets.Osu/Edit/OsuToolboxComposite.cs | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/osu.Game.Rulesets.Osu/Edit/OsuToolboxComposite.cs b/osu.Game.Rulesets.Osu/Edit/OsuToolboxComposite.cs
index b0298e4034..542f98207e 100644
--- a/osu.Game.Rulesets.Osu/Edit/OsuToolboxComposite.cs
+++ b/osu.Game.Rulesets.Osu/Edit/OsuToolboxComposite.cs
@@ -106,6 +106,8 @@ namespace osu.Game.Rulesets.Osu.Edit
 
         private class ExpandingToolboxContainer : ExpandingContainer
         {
+            protected override double HoverExpansionDelay => 250;
+
             public ExpandingToolboxContainer()
                 : base(130, 250)
             {

From 2200067c52759a32eb1adfa12fd79347b7f51200 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 24 Apr 2022 16:31:20 +0900
Subject: [PATCH 4284/5547] Display deadzone as percentage and simplify
 surrounding code

---
 .../Sections/Input/JoystickSettings.cs        | 34 +++++++------------
 1 file changed, 12 insertions(+), 22 deletions(-)

diff --git a/osu.Game/Overlays/Settings/Sections/Input/JoystickSettings.cs b/osu.Game/Overlays/Settings/Sections/Input/JoystickSettings.cs
index ad01c25ac9..c136ca6a19 100644
--- a/osu.Game/Overlays/Settings/Sections/Input/JoystickSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Input/JoystickSettings.cs
@@ -6,18 +6,20 @@ using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Input.Handlers.Joystick;
 using osu.Framework.Localisation;
-using osu.Game.Graphics.UserInterface;
 using osu.Game.Localisation;
 
 namespace osu.Game.Overlays.Settings.Sections.Input
 {
     public class JoystickSettings : SettingsSubsection
     {
-        private readonly JoystickHandler joystickHandler;
         protected override LocalisableString Header => JoystickSettingsStrings.JoystickGamepad;
-        private readonly BindableNumber<float> deadzoneThreshold = new BindableNumber<float>();
+
+        private readonly JoystickHandler joystickHandler;
+
         private readonly Bindable<bool> enabled = new BindableBool(true);
 
+        private SettingsSlider<float> deadzoneSlider;
+
         public JoystickSettings(JoystickHandler joystickHandler)
         {
             this.joystickHandler = joystickHandler;
@@ -33,10 +35,12 @@ namespace osu.Game.Overlays.Settings.Sections.Input
                     LabelText = CommonStrings.Enabled,
                     Current = enabled
                 },
-                new DeadzoneSetting
+                deadzoneSlider = new SettingsSlider<float>
                 {
                     LabelText = JoystickSettingsStrings.DeadzoneThreshold,
-                    Current = deadzoneThreshold
+                    KeyboardStep = 0.01f,
+                    DisplayAsPercentage = true,
+                    Current = joystickHandler.DeadzoneThreshold,
                 },
             };
         }
@@ -44,23 +48,9 @@ namespace osu.Game.Overlays.Settings.Sections.Input
         protected override void LoadComplete()
         {
             base.LoadComplete();
+
             enabled.BindTo(joystickHandler.Enabled);
-            deadzoneThreshold.BindTo(joystickHandler.DeadzoneThreshold);
-            enabled.BindValueChanged(e => deadzoneThreshold.Disabled = !e.NewValue, true);
-        }
-
-        private class DeadzoneSetting : SettingsSlider<float, DeadzoneSlider>
-        {
-            public DeadzoneSetting()
-            {
-                KeyboardStep = 0.01f;
-                TransferValueOnCommit = true;
-            }
-        }
-
-        private class DeadzoneSlider : OsuSliderBar<float>
-        {
-            public override LocalisableString TooltipText => Current.Disabled ? "" : base.TooltipText;
+            enabled.BindValueChanged(e => deadzoneSlider.Current.Disabled = !e.NewValue, true);
         }
     }
-}
\ No newline at end of file
+}

From 1b2467d3ed7df7e2c2171947e606b296ce48983c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 24 Apr 2022 16:35:41 +0900
Subject: [PATCH 4285/5547] Disable first run screen from appearing on startup
 until it is more complete

---
 .../Visual/UserInterface/TestSceneFirstRunSetupOverlay.cs   | 1 +
 osu.Game/Overlays/FirstRunSetupOverlay.cs                   | 6 ++++--
 2 files changed, 5 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunSetupOverlay.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunSetupOverlay.cs
index e925859d71..31c4d66784 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunSetupOverlay.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunSetupOverlay.cs
@@ -66,6 +66,7 @@ namespace osu.Game.Tests.Visual.UserInterface
         }
 
         [Test]
+        [Ignore("Enable when first run setup is being displayed on first run.")]
         public void TestDoesntOpenOnSecondRun()
         {
             AddStep("set first run", () => LocalConfig.SetValue(OsuSetting.ShowFirstRunSetup, true));
diff --git a/osu.Game/Overlays/FirstRunSetupOverlay.cs b/osu.Game/Overlays/FirstRunSetupOverlay.cs
index c4e3626996..dc1ae2be37 100644
--- a/osu.Game/Overlays/FirstRunSetupOverlay.cs
+++ b/osu.Game/Overlays/FirstRunSetupOverlay.cs
@@ -157,7 +157,8 @@ namespace osu.Game.Overlays
 
             config.BindWith(OsuSetting.ShowFirstRunSetup, showFirstRunSetup);
 
-            if (showFirstRunSetup.Value) Show();
+            // TODO: uncomment when happy with the whole flow.
+            // if (showFirstRunSetup.Value) Show();
         }
 
         public override bool OnPressed(KeyBindingPressEvent<GlobalAction> e)
@@ -289,7 +290,8 @@ namespace osu.Game.Overlays
             }
             else
             {
-                showFirstRunSetup.Value = false;
+                // TODO: uncomment when happy with the whole flow.
+                // showFirstRunSetup.Value = false;
                 currentStepIndex = null;
                 Hide();
             }

From 999b4505d139ae7779958690de8d130b180a09fa Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 24 Apr 2022 16:37:11 +0900
Subject: [PATCH 4286/5547] Remove localisation of "hide" string to fix
 incorrect case

---
 osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmap.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmap.cs b/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmap.cs
index c6037d1bd6..9772b1feb3 100644
--- a/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmap.cs
+++ b/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmap.cs
@@ -244,7 +244,7 @@ namespace osu.Game.Screens.Select.Carousel
                 }
 
                 if (hideRequested != null)
-                    items.Add(new OsuMenuItem(CommonStrings.ButtonsHide, MenuItemType.Destructive, () => hideRequested(beatmapInfo)));
+                    items.Add(new OsuMenuItem("Hide", MenuItemType.Destructive, () => hideRequested(beatmapInfo)));
 
                 return items.ToArray();
             }

From 66b47d22d78bc45d2e890e0aaa7ac565b1fb2e82 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 24 Apr 2022 17:11:25 +0900
Subject: [PATCH 4287/5547] Also fix case of login form username/password

---
 osu.Game/Overlays/Login/LoginForm.cs | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Overlays/Login/LoginForm.cs b/osu.Game/Overlays/Login/LoginForm.cs
index c31416e078..502f0cd22e 100644
--- a/osu.Game/Overlays/Login/LoginForm.cs
+++ b/osu.Game/Overlays/Login/LoginForm.cs
@@ -3,6 +3,7 @@
 
 using System;
 using osu.Framework.Allocation;
+using osu.Framework.Extensions.LocalisationExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.UserInterface;
@@ -51,14 +52,14 @@ namespace osu.Game.Overlays.Login
             {
                 username = new OsuTextBox
                 {
-                    PlaceholderText = UsersStrings.LoginUsername,
+                    PlaceholderText = UsersStrings.LoginUsername.ToLower(),
                     RelativeSizeAxes = Axes.X,
                     Text = api?.ProvidedUsername ?? string.Empty,
                     TabbableContentContainer = this
                 },
                 password = new OsuPasswordTextBox
                 {
-                    PlaceholderText = UsersStrings.LoginPassword,
+                    PlaceholderText = UsersStrings.LoginPassword.ToLower(),
                     RelativeSizeAxes = Axes.X,
                     TabbableContentContainer = this,
                 },

From d92c9056005839fc6410c5de133fb7ee8a9c3533 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 24 Apr 2022 18:15:35 +0900
Subject: [PATCH 4288/5547] Actually use exposed property

---
 osu.Game/Overlays/FirstRunSetup/ScreenUIScale.cs | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/FirstRunSetup/ScreenUIScale.cs b/osu.Game/Overlays/FirstRunSetup/ScreenUIScale.cs
index d9a612ea26..ef48d9ced5 100644
--- a/osu.Game/Overlays/FirstRunSetup/ScreenUIScale.cs
+++ b/osu.Game/Overlays/FirstRunSetup/ScreenUIScale.cs
@@ -62,7 +62,7 @@ namespace osu.Game.Overlays.FirstRunSetup
                                 new Drawable[]
                                 {
                                     new SampleScreenContainer(new PinnedMainMenu()),
-                                    new SampleScreenContainer(new PlaySongSelect()),
+                                    new SampleScreenContainer(new NestedSongSelect()),
                                 },
                                 // TODO: add more screens here in the future (gameplay / results)
                                 // requires a bit more consideration to isolate their behaviour from the "parent" game.
@@ -95,6 +95,11 @@ namespace osu.Game.Overlays.FirstRunSetup
             }
         }
 
+        private class NestedSongSelect : PlaySongSelect
+        {
+            protected override bool ControlGlobalMusic => false;
+        }
+
         private class PinnedMainMenu : MainMenu
         {
             public override void OnEntering(ScreenTransitionEvent e)

From 51aa17eb524e70899f09c1058842e0d55f58109b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 24 Apr 2022 22:17:01 +0900
Subject: [PATCH 4289/5547] Fix context menus not working

---
 osu.Game/Graphics/UserInterface/OsuDropdown.cs | 18 +++++++++++++++++-
 osu.Game/Graphics/UserInterface/OsuMenu.cs     | 18 +++++++++++++++++-
 2 files changed, 34 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Graphics/UserInterface/OsuDropdown.cs b/osu.Game/Graphics/UserInterface/OsuDropdown.cs
index b1d4691938..20fa7d5148 100644
--- a/osu.Game/Graphics/UserInterface/OsuDropdown.cs
+++ b/osu.Game/Graphics/UserInterface/OsuDropdown.cs
@@ -12,6 +12,7 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Graphics.UserInterface;
+using osu.Framework.Input.Events;
 using osu.Framework.Localisation;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
@@ -130,7 +131,22 @@ namespace osu.Game.Graphics.UserInterface
                 BackgroundColourSelected = SelectionColour
             };
 
-            protected override ScrollContainer<Drawable> CreateScrollContainer(Direction direction) => new OsuScrollContainer(direction);
+            protected override ScrollContainer<Drawable> CreateScrollContainer(Direction direction) => new DropdownScrollContainer(direction);
+
+            // Hotfix for https://github.com/ppy/osu/issues/17961
+            public class DropdownScrollContainer : OsuScrollContainer
+            {
+                public DropdownScrollContainer(Direction direction)
+                    : base(direction)
+                {
+                }
+
+                protected override bool OnMouseDown(MouseDownEvent e)
+                {
+                    base.OnMouseDown(e);
+                    return true;
+                }
+            }
 
             #region DrawableOsuDropdownMenuItem
 
diff --git a/osu.Game/Graphics/UserInterface/OsuMenu.cs b/osu.Game/Graphics/UserInterface/OsuMenu.cs
index a16adcbd57..bfdfd32fb3 100644
--- a/osu.Game/Graphics/UserInterface/OsuMenu.cs
+++ b/osu.Game/Graphics/UserInterface/OsuMenu.cs
@@ -9,6 +9,7 @@ using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.UserInterface;
+using osu.Framework.Input.Events;
 using osu.Game.Graphics.Containers;
 using osuTK;
 
@@ -81,7 +82,22 @@ namespace osu.Game.Graphics.UserInterface
             return new DrawableOsuMenuItem(item);
         }
 
-        protected override ScrollContainer<Drawable> CreateScrollContainer(Direction direction) => new OsuScrollContainer(direction);
+        protected override ScrollContainer<Drawable> CreateScrollContainer(Direction direction) => new OsuMenuScrollContainer(direction);
+
+        // Hotfix for https://github.com/ppy/osu/issues/17961
+        public class OsuMenuScrollContainer : OsuScrollContainer
+        {
+            public OsuMenuScrollContainer(Direction direction)
+                : base(direction)
+            {
+            }
+
+            protected override bool OnMouseDown(MouseDownEvent e)
+            {
+                base.OnMouseDown(e);
+                return true;
+            }
+        }
 
         protected override Menu CreateSubMenu() => new OsuMenu(Direction.Vertical)
         {

From 7e9d51f33f31a21f883826a755cf3f39c67b307b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 25 Apr 2022 18:37:35 +0900
Subject: [PATCH 4290/5547] Fix windows taskbar context menu not popping up
 correctly

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

Note that this will cause a second osu! icon to appear after running the
application (after any update). As per the inline comment, this will
eventually be resolved via https://github.com/clowd/Clowd.Squirrel/issues/24.

I do think having context menus working is more important than duplicate
icons.

Note that for anyone who already has a pinned taskbar icon, it will need
to be manually unpinned and repinned after a future update to actually
fix this issue.

Thanks to @caesay for help with investigation.
---
 osu.Desktop/Program.cs | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/osu.Desktop/Program.cs b/osu.Desktop/Program.cs
index e317a44bc3..eb9045d9ce 100644
--- a/osu.Desktop/Program.cs
+++ b/osu.Desktop/Program.cs
@@ -123,7 +123,12 @@ namespace osu.Desktop
                 tools.RemoveUninstallerRegistryEntry();
             }, onEveryRun: (version, tools, firstRun) =>
             {
-                tools.SetProcessAppUserModelId();
+                // While setting the `ProcessAppUserModelId` fixes duplicate icons/shortcuts on the taskbar, it currently
+                // causes the right-click context menu to function incorrectly.
+                //
+                // This may turn out to be non-required after an alternative solution is implemented.
+                // see https://github.com/clowd/Clowd.Squirrel/issues/24
+                // tools.SetProcessAppUserModelId();
             });
         }
 

From 7ac3ba132ce70a2ba150c6567decde647cb62f3c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 25 Apr 2022 18:55:12 +0900
Subject: [PATCH 4291/5547] Remove unused using statements

---
 .../Visual/Navigation/TestSceneSkinEditorSceneLibrary.cs         | 1 -
 osu.Game/Tests/Visual/OsuGameTestScene.cs                        | 1 -
 2 files changed, 2 deletions(-)

diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneSkinEditorSceneLibrary.cs b/osu.Game.Tests/Visual/Navigation/TestSceneSkinEditorSceneLibrary.cs
index 448d6b1e68..d3aeba2c0f 100644
--- a/osu.Game.Tests/Visual/Navigation/TestSceneSkinEditorSceneLibrary.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneSkinEditorSceneLibrary.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.Linq;
 using NUnit.Framework;
 using osu.Framework.Extensions;
diff --git a/osu.Game/Tests/Visual/OsuGameTestScene.cs b/osu.Game/Tests/Visual/OsuGameTestScene.cs
index 1b8f8bfd07..6e4adb4d4c 100644
--- a/osu.Game/Tests/Visual/OsuGameTestScene.cs
+++ b/osu.Game/Tests/Visual/OsuGameTestScene.cs
@@ -25,7 +25,6 @@ using osu.Game.Screens;
 using osu.Game.Screens.Menu;
 using osu.Game.Screens.Play;
 using osuTK.Graphics;
-using osuTK.Input;
 using IntroSequence = osu.Game.Configuration.IntroSequence;
 
 namespace osu.Game.Tests.Visual

From d2780c2c50557b1bdbfc1bec444ae9814dd08e80 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 25 Apr 2022 19:06:47 +0900
Subject: [PATCH 4292/5547] Add a touch more detail to the unsupported skin
 component exception

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

diff --git a/osu.Game/Skinning/UnsupportedSkinComponentException.cs b/osu.Game/Skinning/UnsupportedSkinComponentException.cs
index 643f29c3db..7f0dd51d5b 100644
--- a/osu.Game/Skinning/UnsupportedSkinComponentException.cs
+++ b/osu.Game/Skinning/UnsupportedSkinComponentException.cs
@@ -8,7 +8,7 @@ namespace osu.Game.Skinning
     public class UnsupportedSkinComponentException : Exception
     {
         public UnsupportedSkinComponentException(ISkinComponent component)
-            : base($@"Unsupported component type: {component.GetType()}(""{component.LookupName}"").")
+            : base($@"Unsupported component type: {component.GetType()} (lookup: ""{component.LookupName}"").")
         {
         }
     }

From 5e48b37569a549cd8388985a6efc7b4eca5be72f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 25 Apr 2022 23:58:12 +0900
Subject: [PATCH 4293/5547] Show "Get Started" text on first run button

---
 osu.Game/Overlays/FirstRunSetupOverlay.cs | 15 +++++++++------
 1 file changed, 9 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Overlays/FirstRunSetupOverlay.cs b/osu.Game/Overlays/FirstRunSetupOverlay.cs
index dc1ae2be37..87e62cbddf 100644
--- a/osu.Game/Overlays/FirstRunSetupOverlay.cs
+++ b/osu.Game/Overlays/FirstRunSetupOverlay.cs
@@ -304,12 +304,15 @@ namespace osu.Game.Overlays
             BackButton.Enabled.Value = currentStepIndex > 0;
             NextButton.Enabled.Value = currentStepIndex != null;
 
-            if (currentStepIndex != null)
-            {
-                NextButton.Text = currentStepIndex + 1 < steps.Length
-                    ? FirstRunSetupOverlayStrings.Next(steps[currentStepIndex.Value + 1].Description)
-                    : CommonStrings.Finish;
-            }
+            if (currentStepIndex == null)
+                return;
+
+            if (currentStepIndex == 0)
+                NextButton.Text = FirstRunSetupOverlayStrings.GetStarted;
+            else if (currentStepIndex < steps.Length - 1)
+                NextButton.Text = FirstRunSetupOverlayStrings.Next(steps[currentStepIndex.Value + 1].Description);
+            else
+                NextButton.Text = CommonStrings.Finish;
         }
 
         private class FirstRunStep

From ebc8429495c1cde762d2273ed2a7c2fb37476f01 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 24 Apr 2022 19:13:19 +0200
Subject: [PATCH 4294/5547] Dim offscreen columns & scroll to them if clicked

---
 osu.Game/Overlays/Mods/ModColumn.cs       |   3 +
 osu.Game/Overlays/Mods/ModSelectScreen.cs | 138 ++++++++++++++++++----
 2 files changed, 115 insertions(+), 26 deletions(-)

diff --git a/osu.Game/Overlays/Mods/ModColumn.cs b/osu.Game/Overlays/Mods/ModColumn.cs
index 1157c0c0c6..fed2f9aff6 100644
--- a/osu.Game/Overlays/Mods/ModColumn.cs
+++ b/osu.Game/Overlays/Mods/ModColumn.cs
@@ -53,6 +53,9 @@ namespace osu.Game.Overlays.Mods
         }
 
         public Bindable<IReadOnlyList<Mod>> SelectedMods = new Bindable<IReadOnlyList<Mod>>(Array.Empty<Mod>());
+        public Bindable<bool> Active = new BindableBool(true);
+
+        protected override bool ReceivePositionalInputAtSubTree(Vector2 screenSpacePos) => base.ReceivePositionalInputAtSubTree(screenSpacePos) && Active.Value;
 
         protected virtual ModPanel CreateModPanel(Mod mod) => new ModPanel(mod);
 
diff --git a/osu.Game/Overlays/Mods/ModSelectScreen.cs b/osu.Game/Overlays/Mods/ModSelectScreen.cs
index 8a83071109..ca3609aa75 100644
--- a/osu.Game/Overlays/Mods/ModSelectScreen.cs
+++ b/osu.Game/Overlays/Mods/ModSelectScreen.cs
@@ -13,7 +13,9 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Input.Events;
 using osu.Framework.Layout;
+using osu.Framework.Utils;
 using osu.Game.Configuration;
+using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Rulesets.Mods;
@@ -59,7 +61,8 @@ namespace osu.Game.Overlays.Mods
 
         private DifficultyMultiplierDisplay? multiplierDisplay;
         private ModSettingsArea modSettingsArea = null!;
-        private FillFlowContainer<ModColumn> columnFlow = null!;
+        private OsuScrollContainer columnScroll = null!;
+        private ColumnFlowContainer columnFlow = null!;
 
         [BackgroundDependencyLoader]
         private void load()
@@ -83,6 +86,9 @@ namespace osu.Game.Overlays.Mods
                 }
             });
 
+            // initialise the scroll early, as we will want to pass it to its children in the hierarchy initialisation below.
+            columnScroll = new OsuScrollContainer(Direction.Horizontal);
+
             MainAreaContent.AddRange(new Drawable[]
             {
                 new Container
@@ -95,13 +101,13 @@ namespace osu.Game.Overlays.Mods
                     RelativePositionAxes = Axes.Both,
                     Children = new Drawable[]
                     {
-                        new OsuScrollContainer(Direction.Horizontal)
+                        columnScroll.With(col =>
                         {
-                            RelativeSizeAxes = Axes.Both,
-                            Masking = false,
-                            ClampExtension = 100,
-                            ScrollbarOverlapsContent = false,
-                            Child = columnFlow = new ModColumnContainer
+                            col.RelativeSizeAxes = Axes.Both;
+                            col.Masking = false;
+                            col.ClampExtension = 100;
+                            col.ScrollbarOverlapsContent = false;
+                            col.Child = columnFlow = new ColumnFlowContainer
                             {
                                 Direction = FillDirection.Horizontal,
                                 Shear = new Vector2(SHEAR, 0),
@@ -111,14 +117,14 @@ namespace osu.Game.Overlays.Mods
                                 Margin = new MarginPadding { Right = 70 },
                                 Children = new[]
                                 {
-                                    CreateModColumn(ModType.DifficultyReduction, new[] { Key.Q, Key.W, Key.E, Key.R, Key.T, Key.Y, Key.U, Key.I, Key.O, Key.P }),
-                                    CreateModColumn(ModType.DifficultyIncrease, new[] { Key.A, Key.S, Key.D, Key.F, Key.G, Key.H, Key.J, Key.K, Key.L }),
-                                    CreateModColumn(ModType.Automation, new[] { Key.Z, Key.X, Key.C, Key.V, Key.B, Key.N, Key.M }),
-                                    CreateModColumn(ModType.Conversion),
-                                    CreateModColumn(ModType.Fun)
+                                    createModColumnContent(columnScroll, ModType.DifficultyReduction, new[] { Key.Q, Key.W, Key.E, Key.R, Key.T, Key.Y, Key.U, Key.I, Key.O, Key.P }),
+                                    createModColumnContent(columnScroll, ModType.DifficultyIncrease, new[] { Key.A, Key.S, Key.D, Key.F, Key.G, Key.H, Key.J, Key.K, Key.L }),
+                                    createModColumnContent(columnScroll, ModType.Automation, new[] { Key.Z, Key.X, Key.C, Key.V, Key.B, Key.N, Key.M }),
+                                    createModColumnContent(columnScroll, ModType.Conversion),
+                                    createModColumnContent(columnScroll, ModType.Fun)
                                 }
-                            }
-                        }
+                            };
+                        })
                     }
                 }
             });
@@ -153,6 +159,13 @@ namespace osu.Game.Overlays.Mods
             }
         }
 
+        private ColumnDimContainer createModColumnContent(OsuScrollContainer scroll, ModType modType, Key[]? toggleKeys = null)
+            => new ColumnDimContainer(scroll, CreateModColumn(modType, toggleKeys))
+            {
+                AutoSizeAxes = Axes.X,
+                RelativeSizeAxes = Axes.Y
+            };
+
         protected override void LoadComplete()
         {
             base.LoadComplete();
@@ -166,7 +179,7 @@ namespace osu.Game.Overlays.Mods
                 updateSelectionFromBindable();
             }, true);
 
-            foreach (var column in columnFlow)
+            foreach (var column in columnFlow.Columns)
             {
                 column.SelectedMods.BindValueChanged(updateBindableFromSelection);
             }
@@ -191,7 +204,7 @@ namespace osu.Game.Overlays.Mods
 
         private void updateAvailableMods()
         {
-            foreach (var column in columnFlow)
+            foreach (var column in columnFlow.Columns)
                 column.Filter = isValidMod;
         }
 
@@ -244,7 +257,7 @@ namespace osu.Game.Overlays.Mods
             // to synchronise state correctly, updateBindableFromSelection() computes the final mods (including incompatibility rules) and updates SelectedMods,
             // and this method then runs unconditionally again to make sure the new visual selection accurately reflects the final set of selected mods.
             // selectionBindableSyncInProgress ensures that mutual infinite recursion does not happen after that unconditional call.
-            foreach (var column in columnFlow)
+            foreach (var column in columnFlow.Columns)
                 column.SelectedMods.Value = SelectedMods.Value.Where(mod => mod.Type == column.ModType).ToArray();
         }
 
@@ -265,7 +278,7 @@ namespace osu.Game.Overlays.Mods
         }
 
         protected virtual IReadOnlyList<Mod> ComputeNewModsFromSelection(IEnumerable<Mod> addedMods, IEnumerable<Mod> removedMods)
-            => columnFlow.SelectMany(column => column.SelectedMods.Value).ToArray();
+            => columnFlow.Columns.SelectMany(column => column.SelectedMods.Value).ToArray();
 
         protected override void PopIn()
         {
@@ -280,7 +293,8 @@ namespace osu.Game.Overlays.Mods
 
             for (int i = 0; i < columnFlow.Count; i++)
             {
-                columnFlow[i].TopLevelContent
+                columnFlow[i].Column
+                             .TopLevelContent
                              .Delay(i * 30)
                              .MoveToY(0, fade_in_duration, Easing.OutQuint)
                              .FadeIn(fade_in_duration, Easing.OutQuint);
@@ -301,27 +315,30 @@ namespace osu.Game.Overlays.Mods
             {
                 const float distance = 700;
 
-                columnFlow[i].TopLevelContent
+                columnFlow[i].Column
+                             .TopLevelContent
                              .MoveToY(i % 2 == 0 ? -distance : distance, fade_out_duration, Easing.OutQuint)
                              .FadeOut(fade_out_duration, Easing.OutQuint);
             }
         }
 
-        private class ModColumnContainer : FillFlowContainer<ModColumn>
+        private class ColumnFlowContainer : FillFlowContainer<ColumnDimContainer>
         {
+            public IEnumerable<ModColumn> Columns => Children.Select(dimWrapper => dimWrapper.Column);
+
             private readonly LayoutValue drawSizeLayout = new LayoutValue(Invalidation.DrawSize);
 
-            public ModColumnContainer()
+            public ColumnFlowContainer()
             {
                 AddLayout(drawSizeLayout);
             }
 
-            public override void Add(ModColumn column)
+            public override void Add(ColumnDimContainer dimContainer)
             {
-                base.Add(column);
+                base.Add(dimContainer);
 
-                Debug.Assert(column != null);
-                column.Shear = Vector2.Zero;
+                Debug.Assert(dimContainer != null);
+                dimContainer.Column.Shear = Vector2.Zero;
             }
 
             protected override void Update()
@@ -341,6 +358,75 @@ namespace osu.Game.Overlays.Mods
             }
         }
 
+        private class ColumnDimContainer : Container
+        {
+            public ModColumn Column { get; }
+
+            private readonly ScrollContainer<Drawable> parentScroll;
+            private readonly Bindable<bool> isFullyOnScreen = new BindableBool(true);
+
+            [Resolved]
+            private OsuColour colours { get; set; } = null!;
+
+            public ColumnDimContainer(ScrollContainer<Drawable> parentScroll, ModColumn column)
+            {
+                this.parentScroll = parentScroll;
+                Child = Column = column;
+                column.Active.BindTo(isFullyOnScreen);
+            }
+
+            protected override void LoadComplete()
+            {
+                base.LoadComplete();
+                isFullyOnScreen.BindValueChanged(_ => updateDim(), true);
+                FinishTransforms();
+            }
+
+            private void updateDim()
+            {
+                Colour4 targetColour;
+
+                if (isFullyOnScreen.Value)
+                    targetColour = Colour4.White;
+                else
+                    targetColour = IsHovered ? colours.GrayC : colours.Gray8;
+
+                this.FadeColour(targetColour, 300, Easing.OutQuint);
+            }
+
+            protected override void Update()
+            {
+                float leftX = DrawPosition.X;
+                // DrawWidth does not include shear effects, and we want to know the full extents of the columns post-shear,
+                // so we have to manually compensate.
+                float rightX = DrawPosition.X + DrawWidth + DrawHeight * SHEAR;
+
+                isFullyOnScreen.Value = Precision.AlmostBigger(leftX, parentScroll.Current)
+                                        && Precision.DefinitelyBigger(parentScroll.Current + parentScroll.DrawWidth, rightX);
+            }
+
+            protected override bool OnMouseDown(MouseDownEvent e)
+            {
+                if (!isFullyOnScreen.Value)
+                    parentScroll.ScrollTo(DrawPosition.X - 70);
+
+                return true;
+            }
+
+            protected override bool OnHover(HoverEvent e)
+            {
+                base.OnHover(e);
+                updateDim();
+                return isFullyOnScreen.Value;
+            }
+
+            protected override void OnHoverLost(HoverLostEvent e)
+            {
+                base.OnHoverLost(e);
+                updateDim();
+            }
+        }
+
         private class ClickToReturnContainer : Container
         {
             public BindableBool HandleMouse { get; } = new BindableBool();

From 09c08248c4a54bd89582247c3dfee500186b2908 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 24 Apr 2022 19:20:50 +0200
Subject: [PATCH 4295/5547] Fix bounce when scrolling to first/last column

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

diff --git a/osu.Game/Overlays/Mods/ModSelectScreen.cs b/osu.Game/Overlays/Mods/ModSelectScreen.cs
index ca3609aa75..f12f55a3a7 100644
--- a/osu.Game/Overlays/Mods/ModSelectScreen.cs
+++ b/osu.Game/Overlays/Mods/ModSelectScreen.cs
@@ -408,7 +408,7 @@ namespace osu.Game.Overlays.Mods
             protected override bool OnMouseDown(MouseDownEvent e)
             {
                 if (!isFullyOnScreen.Value)
-                    parentScroll.ScrollTo(DrawPosition.X - 70);
+                    parentScroll.ScrollTo(Math.Clamp(DrawPosition.X - 70, 0, parentScroll.ScrollableExtent));
 
                 return true;
             }

From e384e074fb9243521974d6af45051e8567aa6c1b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 24 Apr 2022 19:27:27 +0200
Subject: [PATCH 4296/5547] Fix asymmetric margin of column scroll

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

diff --git a/osu.Game/Overlays/Mods/ModSelectScreen.cs b/osu.Game/Overlays/Mods/ModSelectScreen.cs
index f12f55a3a7..324fc68885 100644
--- a/osu.Game/Overlays/Mods/ModSelectScreen.cs
+++ b/osu.Game/Overlays/Mods/ModSelectScreen.cs
@@ -114,7 +114,7 @@ namespace osu.Game.Overlays.Mods
                                 RelativeSizeAxes = Axes.Y,
                                 AutoSizeAxes = Axes.X,
                                 Spacing = new Vector2(10, 0),
-                                Margin = new MarginPadding { Right = 70 },
+                                Margin = new MarginPadding { Horizontal = 70 },
                                 Children = new[]
                                 {
                                     createModColumnContent(columnScroll, ModType.DifficultyReduction, new[] { Key.Q, Key.W, Key.E, Key.R, Key.T, Key.Y, Key.U, Key.I, Key.O, Key.P }),

From e13d0d02ae7db2a6808c2d1834de6f19261a80d0 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 24 Apr 2022 19:27:51 +0200
Subject: [PATCH 4297/5547] Use better way of calculating whether columns are
 fully on screen

---
 osu.Game/Overlays/Mods/ModSelectScreen.cs | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Overlays/Mods/ModSelectScreen.cs b/osu.Game/Overlays/Mods/ModSelectScreen.cs
index 324fc68885..11cffe7959 100644
--- a/osu.Game/Overlays/Mods/ModSelectScreen.cs
+++ b/osu.Game/Overlays/Mods/ModSelectScreen.cs
@@ -396,13 +396,13 @@ namespace osu.Game.Overlays.Mods
 
             protected override void Update()
             {
-                float leftX = DrawPosition.X;
-                // DrawWidth does not include shear effects, and we want to know the full extents of the columns post-shear,
+                // DrawWidth/DrawPosition do not include shear effects, and we want to know the full extents of the columns post-shear,
                 // so we have to manually compensate.
-                float rightX = DrawPosition.X + DrawWidth + DrawHeight * SHEAR;
+                var topLeft = ToSpaceOfOtherDrawable(new Vector2(-DrawHeight * SHEAR, 0), parentScroll);
+                var topRight = ToSpaceOfOtherDrawable(new Vector2(DrawWidth, 0), parentScroll);
 
-                isFullyOnScreen.Value = Precision.AlmostBigger(leftX, parentScroll.Current)
-                                        && Precision.DefinitelyBigger(parentScroll.Current + parentScroll.DrawWidth, rightX);
+                isFullyOnScreen.Value = Precision.AlmostBigger(topLeft.X, 0)
+                                        && Precision.DefinitelyBigger(parentScroll.DrawWidth, topRight.X);
             }
 
             protected override bool OnMouseDown(MouseDownEvent e)

From 24a1eb8003c4bcddce3ea0e076d09c15a8bfe6fc Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 25 Apr 2022 23:41:40 +0200
Subject: [PATCH 4298/5547] Add test coverage for column dimming behaviour

---
 .../UserInterface/TestSceneModSelectScreen.cs | 29 +++++++++++++++++++
 1 file changed, 29 insertions(+)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs
index 514538161e..d7ae131372 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs
@@ -111,6 +111,35 @@ namespace osu.Game.Tests.Visual.UserInterface
                                             && SelectedMods.Value.Any(mod => mod.GetType() == typeof(OsuModMirror)));
         }
 
+        [Test]
+        public void TestDimmedState()
+        {
+            createScreen();
+            changeRuleset(0);
+
+            AddUntilStep("any column dimmed", () => this.ChildrenOfType<ModColumn>().Any(column => !column.Active.Value));
+
+            ModColumn firstDimmed = null;
+            ModPanel firstPanel = null;
+
+            AddStep("click first panel on dimmed column", () =>
+            {
+                firstDimmed = this.ChildrenOfType<ModColumn>().First(column => !column.Active.Value);
+                firstPanel = firstDimmed.ChildrenOfType<ModPanel>().First();
+                InputManager.MoveMouseTo(firstPanel);
+                InputManager.Click(MouseButton.Left);
+            });
+            AddUntilStep("column undimmed", () => firstDimmed.Active.Value);
+            AddAssert("panel not selected", () => !firstPanel.Active.Value);
+
+            AddStep("click panel again", () =>
+            {
+                InputManager.MoveMouseTo(firstPanel);
+                InputManager.Click(MouseButton.Left);
+            });
+            AddUntilStep("panel selected", () => firstPanel.Active.Value);
+        }
+
         [Test]
         public void TestCustomisationToggleState()
         {

From f958010d29ae5040c37b89e88f00fc29e1123d12 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Tue, 26 Apr 2022 04:52:48 +0300
Subject: [PATCH 4299/5547] Fix `AccuracyCircle` storing accuracy values in
 `float`

---
 .../Ranking/Expanded/Accuracy/AccuracyCircle.cs      | 12 ++++++------
 .../Screens/Ranking/Expanded/Accuracy/RankBadge.cs   |  6 +++---
 2 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/osu.Game/Screens/Ranking/Expanded/Accuracy/AccuracyCircle.cs b/osu.Game/Screens/Ranking/Expanded/Accuracy/AccuracyCircle.cs
index e50520e0ca..b9248bd67e 100644
--- a/osu.Game/Screens/Ranking/Expanded/Accuracy/AccuracyCircle.cs
+++ b/osu.Game/Screens/Ranking/Expanded/Accuracy/AccuracyCircle.cs
@@ -212,12 +212,12 @@ namespace osu.Game.Screens.Ranking.Expanded.Accuracy
                     Padding = new MarginPadding { Vertical = -15, Horizontal = -20 },
                     Children = new[]
                     {
-                        new RankBadge(1f, getRank(ScoreRank.X)),
-                        new RankBadge(0.95f, getRank(ScoreRank.S)),
-                        new RankBadge(0.9f, getRank(ScoreRank.A)),
-                        new RankBadge(0.8f, getRank(ScoreRank.B)),
-                        new RankBadge(0.7f, getRank(ScoreRank.C)),
-                        new RankBadge(0.35f, getRank(ScoreRank.D)),
+                        new RankBadge(1, getRank(ScoreRank.X)),
+                        new RankBadge(0.95, getRank(ScoreRank.S)),
+                        new RankBadge(0.9, getRank(ScoreRank.A)),
+                        new RankBadge(0.8, getRank(ScoreRank.B)),
+                        new RankBadge(0.7, getRank(ScoreRank.C)),
+                        new RankBadge(0.35, getRank(ScoreRank.D)),
                     }
                 },
                 rankText = new RankText(score.Rank)
diff --git a/osu.Game/Screens/Ranking/Expanded/Accuracy/RankBadge.cs b/osu.Game/Screens/Ranking/Expanded/Accuracy/RankBadge.cs
index 76cd408daa..d0b79aa4c7 100644
--- a/osu.Game/Screens/Ranking/Expanded/Accuracy/RankBadge.cs
+++ b/osu.Game/Screens/Ranking/Expanded/Accuracy/RankBadge.cs
@@ -23,7 +23,7 @@ namespace osu.Game.Screens.Ranking.Expanded.Accuracy
         /// <summary>
         /// The accuracy value corresponding to the <see cref="ScoreRank"/> displayed by this badge.
         /// </summary>
-        public readonly float Accuracy;
+        public readonly double Accuracy;
 
         private readonly ScoreRank rank;
 
@@ -35,7 +35,7 @@ namespace osu.Game.Screens.Ranking.Expanded.Accuracy
         /// </summary>
         /// <param name="accuracy">The accuracy value corresponding to <paramref name="rank"/>.</param>
         /// <param name="rank">The <see cref="ScoreRank"/> to be displayed in this <see cref="RankBadge"/>.</param>
-        public RankBadge(float accuracy, ScoreRank rank)
+        public RankBadge(double accuracy, ScoreRank rank)
         {
             Accuracy = accuracy;
             this.rank = rank;
@@ -90,7 +90,7 @@ namespace osu.Game.Screens.Ranking.Expanded.Accuracy
             base.Update();
 
             // Starts at -90deg (top) and moves counter-clockwise by the accuracy
-            rankContainer.Position = circlePosition(-MathF.PI / 2 - (1 - Accuracy) * MathF.PI * 2);
+            rankContainer.Position = circlePosition(-MathF.PI / 2 - (1 - (float)Accuracy) * MathF.PI * 2);
         }
 
         private Vector2 circlePosition(float t)

From 7d3249019887d1ee8ce62f61c7e17d92e55908e0 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Tue, 26 Apr 2022 04:55:27 +0300
Subject: [PATCH 4300/5547] Change score accuracy grading logic to be inclusive

---
 osu.Game/Rulesets/Scoring/ScoreProcessor.cs | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Rulesets/Scoring/ScoreProcessor.cs b/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
index 1e268bb2eb..1dd1d1aeb6 100644
--- a/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
+++ b/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
@@ -375,13 +375,13 @@ namespace osu.Game.Rulesets.Scoring
         {
             if (acc == 1)
                 return ScoreRank.X;
-            if (acc > 0.95)
+            if (acc >= 0.95)
                 return ScoreRank.S;
-            if (acc > 0.9)
+            if (acc >= 0.9)
                 return ScoreRank.A;
-            if (acc > 0.8)
+            if (acc >= 0.8)
                 return ScoreRank.B;
-            if (acc > 0.7)
+            if (acc >= 0.7)
                 return ScoreRank.C;
 
             return ScoreRank.D;

From d310886c26e7d971e41206cbed26d0483452b958 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 26 Apr 2022 12:02:38 +0900
Subject: [PATCH 4301/5547] Add test coverage of `IsPlaying` state during fail
 and pause

---
 osu.Game.Tests/Visual/Gameplay/TestSceneFailJudgement.cs | 2 ++
 osu.Game.Tests/Visual/Gameplay/TestScenePause.cs         | 3 +++
 2 files changed, 5 insertions(+)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneFailJudgement.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneFailJudgement.cs
index 79d7bb366d..bf491db45a 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneFailJudgement.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneFailJudgement.cs
@@ -21,7 +21,9 @@ namespace osu.Game.Tests.Visual.Gameplay
 
         protected override void AddCheckSteps()
         {
+            AddUntilStep("player is playing", () => Player.LocalUserPlaying.Value);
             AddUntilStep("wait for fail", () => Player.GameplayState.HasFailed);
+            AddAssert("player is not playing", () => !Player.LocalUserPlaying.Value);
             AddUntilStep("wait for multiple judgements", () => ((FailPlayer)Player).ScoreProcessor.JudgedHits > 1);
             AddAssert("total number of results == 1", () =>
             {
diff --git a/osu.Game.Tests/Visual/Gameplay/TestScenePause.cs b/osu.Game.Tests/Visual/Gameplay/TestScenePause.cs
index a224a78531..ab5d766609 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestScenePause.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestScenePause.cs
@@ -85,7 +85,10 @@ namespace osu.Game.Tests.Visual.Gameplay
         {
             AddStep("move cursor outside", () => InputManager.MoveMouseTo(Player.ScreenSpaceDrawQuad.TopLeft - new Vector2(10)));
             pauseAndConfirm();
+            AddAssert("player not playing", () => !Player.LocalUserPlaying.Value);
+
             resumeAndConfirm();
+            AddUntilStep("player playing", () => Player.LocalUserPlaying.Value);
         }
 
         [Test]

From 8ab3636f87b434878a4d2bb536ce9a0f1d7287d1 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 26 Apr 2022 11:19:19 +0900
Subject: [PATCH 4302/5547] Change conditions for HUD being shown to include
 pause/fail states

As proposed in https://github.com/ppy/osu/discussions/17975. Feels pretty good to me, and probably how it should have been implemented from the start.
---
 osu.Game/Screens/Play/HUDOverlay.cs | 6 +++---
 osu.Game/Screens/Play/Player.cs     | 6 ++++--
 2 files changed, 7 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Screens/Play/HUDOverlay.cs b/osu.Game/Screens/Play/HUDOverlay.cs
index 676a08b434..abfed1acd0 100644
--- a/osu.Game/Screens/Play/HUDOverlay.cs
+++ b/osu.Game/Screens/Play/HUDOverlay.cs
@@ -66,7 +66,7 @@ namespace osu.Game.Screens.Play
         private readonly FillFlowContainer bottomRightElements;
         private readonly FillFlowContainer topRightElements;
 
-        internal readonly IBindable<bool> IsBreakTime = new Bindable<bool>();
+        internal readonly IBindable<bool> IsPlaying = new Bindable<bool>();
 
         private bool holdingForHUD;
 
@@ -152,7 +152,7 @@ namespace osu.Game.Screens.Play
 
             ShowHud.BindValueChanged(visible => hideTargets.ForEach(d => d.FadeTo(visible.NewValue ? 1 : 0, FADE_DURATION, FADE_EASING)));
 
-            IsBreakTime.BindValueChanged(_ => updateVisibility());
+            IsPlaying.BindValueChanged(_ => updateVisibility());
             configVisibilityMode.BindValueChanged(_ => updateVisibility(), true);
 
             replayLoaded.BindValueChanged(replayLoadedValueChanged, true);
@@ -218,7 +218,7 @@ namespace osu.Game.Screens.Play
 
                 case HUDVisibilityMode.HideDuringGameplay:
                     // always show during replay as we want the seek bar to be visible.
-                    ShowHud.Value = replayLoaded.Value || IsBreakTime.Value;
+                    ShowHud.Value = replayLoaded.Value || !IsPlaying.Value;
                     break;
 
                 case HUDVisibilityMode.Always:
diff --git a/osu.Game/Screens/Play/Player.cs b/osu.Game/Screens/Play/Player.cs
index 2d5a67758a..ae3eb1ed8b 100644
--- a/osu.Game/Screens/Play/Player.cs
+++ b/osu.Game/Screens/Play/Player.cs
@@ -457,7 +457,7 @@ namespace osu.Game.Screens.Play
 
         private void updateGameplayState()
         {
-            bool inGameplay = !DrawableRuleset.HasReplayLoaded.Value && !DrawableRuleset.IsPaused.Value && !breakTracker.IsBreakTime.Value;
+            bool inGameplay = !DrawableRuleset.HasReplayLoaded.Value && !DrawableRuleset.IsPaused.Value && !breakTracker.IsBreakTime.Value && !GameplayState.HasFailed;
             OverlayActivationMode.Value = inGameplay ? OverlayActivation.Disabled : OverlayActivation.UserTriggered;
             localUserPlaying.Value = inGameplay;
         }
@@ -812,6 +812,8 @@ namespace osu.Game.Screens.Play
             GameplayState.HasFailed = true;
             Score.ScoreInfo.Passed = false;
 
+            updateGameplayState();
+
             // There is a chance that we could be in a paused state as the ruleset's internal clock (see FrameStabilityContainer)
             // could process an extra frame after the GameplayClock is stopped.
             // In such cases we want the fail state to precede a user triggered pause.
@@ -945,7 +947,7 @@ namespace osu.Game.Screens.Play
                 failAnimationLayer.Background = b;
             });
 
-            HUDOverlay.IsBreakTime.BindTo(breakTracker.IsBreakTime);
+            HUDOverlay.IsPlaying.BindTo(localUserPlaying);
             DimmableStoryboard.IsBreakTime.BindTo(breakTracker.IsBreakTime);
 
             DimmableStoryboard.StoryboardReplacesBackground.BindTo(storyboardReplacesBackground);

From b41e273086df007bb12b1521df7e31cd6bc53a04 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 26 Apr 2022 15:06:27 +0900
Subject: [PATCH 4303/5547] Convert function weirdness to property + bool

---
 .../UI/OsuSettingsSubsection.cs               |  2 +-
 .../Sections/Gameplay/AudioSettings.cs        |  2 +-
 .../Sections/Gameplay/GeneralSettings.cs      |  2 +-
 .../Settings/Sections/Gameplay/HUDSettings.cs |  2 +-
 .../Sections/UserInterface/GeneralSettings.cs |  2 +-
 .../UserInterface/SongSelectSettings.cs       |  2 +-
 osu.Game/Overlays/Settings/SettingsItem.cs    | 29 +++++++++++--------
 7 files changed, 23 insertions(+), 18 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/UI/OsuSettingsSubsection.cs b/osu.Game.Rulesets.Osu/UI/OsuSettingsSubsection.cs
index 33db74c530..a638019e69 100644
--- a/osu.Game.Rulesets.Osu/UI/OsuSettingsSubsection.cs
+++ b/osu.Game.Rulesets.Osu/UI/OsuSettingsSubsection.cs
@@ -33,7 +33,7 @@ namespace osu.Game.Rulesets.Osu.UI
                 },
                 new SettingsCheckbox
                 {
-                    GetClassicDefault = () => false,
+                    ClassicDefault = false,
                     LabelText = "Snaking out sliders",
                     Current = config.GetBindable<bool>(OsuRulesetSetting.SnakingOutSliders)
                 },
diff --git a/osu.Game/Overlays/Settings/Sections/Gameplay/AudioSettings.cs b/osu.Game/Overlays/Settings/Sections/Gameplay/AudioSettings.cs
index 6978c77aad..e2e00813bd 100644
--- a/osu.Game/Overlays/Settings/Sections/Gameplay/AudioSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Gameplay/AudioSettings.cs
@@ -28,7 +28,7 @@ namespace osu.Game.Overlays.Settings.Sections.Gameplay
                 },
                 new SettingsCheckbox
                 {
-                    GetClassicDefault = () => false,
+                    ClassicDefault = false,
                     LabelText = GameplaySettingsStrings.AlwaysPlayFirstComboBreak,
                     Current = config.GetBindable<bool>(OsuSetting.AlwaysPlayFirstComboBreak)
                 }
diff --git a/osu.Game/Overlays/Settings/Sections/Gameplay/GeneralSettings.cs b/osu.Game/Overlays/Settings/Sections/Gameplay/GeneralSettings.cs
index 3ca677ef7b..5231ce1211 100644
--- a/osu.Game/Overlays/Settings/Sections/Gameplay/GeneralSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Gameplay/GeneralSettings.cs
@@ -21,7 +21,7 @@ namespace osu.Game.Overlays.Settings.Sections.Gameplay
             {
                 new SettingsEnumDropdown<ScoringMode>
                 {
-                    GetClassicDefault = () => ScoringMode.Classic,
+                    ClassicDefault = ScoringMode.Classic,
                     LabelText = GameplaySettingsStrings.ScoreDisplayMode,
                     Current = config.GetBindable<ScoringMode>(OsuSetting.ScoreDisplayMode),
                     Keywords = new[] { "scoring" }
diff --git a/osu.Game/Overlays/Settings/Sections/Gameplay/HUDSettings.cs b/osu.Game/Overlays/Settings/Sections/Gameplay/HUDSettings.cs
index 285cdfa3f8..829977e9b6 100644
--- a/osu.Game/Overlays/Settings/Sections/Gameplay/HUDSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Gameplay/HUDSettings.cs
@@ -30,7 +30,7 @@ namespace osu.Game.Overlays.Settings.Sections.Gameplay
                 },
                 new SettingsCheckbox
                 {
-                    GetClassicDefault = () => false,
+                    ClassicDefault = false,
                     LabelText = GameplaySettingsStrings.ShowHealthDisplayWhenCantFail,
                     Current = config.GetBindable<bool>(OsuSetting.ShowHealthDisplayWhenCantFail),
                     Keywords = new[] { "hp", "bar" }
diff --git a/osu.Game/Overlays/Settings/Sections/UserInterface/GeneralSettings.cs b/osu.Game/Overlays/Settings/Sections/UserInterface/GeneralSettings.cs
index 06f2c9794c..7fc049915e 100644
--- a/osu.Game/Overlays/Settings/Sections/UserInterface/GeneralSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/UserInterface/GeneralSettings.cs
@@ -37,7 +37,7 @@ namespace osu.Game.Overlays.Settings.Sections.UserInterface
                 },
                 new SettingsSlider<double, TimeSlider>
                 {
-                    GetClassicDefault = () => 0,
+                    ClassicDefault = 0,
                     LabelText = UserInterfaceStrings.HoldToConfirmActivationTime,
                     Current = config.GetBindable<double>(OsuSetting.UIHoldActivationDelay),
                     Keywords = new[] { @"delay" },
diff --git a/osu.Game/Overlays/Settings/Sections/UserInterface/SongSelectSettings.cs b/osu.Game/Overlays/Settings/Sections/UserInterface/SongSelectSettings.cs
index 213234db4f..b91b5c5243 100644
--- a/osu.Game/Overlays/Settings/Sections/UserInterface/SongSelectSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/UserInterface/SongSelectSettings.cs
@@ -32,7 +32,7 @@ namespace osu.Game.Overlays.Settings.Sections.UserInterface
             {
                 new SettingsCheckbox
                 {
-                    GetClassicDefault = () => true,
+                    ClassicDefault = true,
                     LabelText = UserInterfaceStrings.RightMouseScroll,
                     Current = config.GetBindable<bool>(OsuSetting.SongSelectRightMouseScroll),
                 },
diff --git a/osu.Game/Overlays/Settings/SettingsItem.cs b/osu.Game/Overlays/Settings/SettingsItem.cs
index 845a7f5cdf..0b9a553c2c 100644
--- a/osu.Game/Overlays/Settings/SettingsItem.cs
+++ b/osu.Game/Overlays/Settings/SettingsItem.cs
@@ -107,10 +107,8 @@ namespace osu.Game.Overlays.Settings
                     LabelText.ToString()
                 };
 
-                if (GetClassicDefault != null)
-                {
+                if (hasClassicDefault)
                     keywords.Add(CLASSIC_DEFAULT_SEARCH_TERM);
-                }
 
                 return keywords;
             }
@@ -126,20 +124,27 @@ namespace osu.Game.Overlays.Settings
 
         public event Action SettingChanged;
 
+        private T classicDefault;
+        private bool hasClassicDefault;
+
         /// <summary>
-        /// An action which when invoked will apply a classic default value to this setting.
+        /// A "classic" default value for this setting.
         /// </summary>
-        public Func<T> GetClassicDefault { get; set; }
+        public T ClassicDefault
+        {
+            set
+            {
+                classicDefault = value;
+                hasClassicDefault = true;
+            }
+        }
 
         public void ApplyClassicDefault(bool useClassicDefault)
         {
-            if (GetClassicDefault != null)
-            {
-                if (useClassicDefault)
-                    Current.Value = GetClassicDefault();
-                else
-                    Current.SetDefault();
-            }
+            if (hasClassicDefault && useClassicDefault)
+                Current.Value = classicDefault;
+            else
+                Current.SetDefault();
         }
 
         protected SettingsItem()

From 71aa7c813e24fe7636b7c938cd2e9ada83038240 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 26 Apr 2022 15:33:39 +0900
Subject: [PATCH 4304/5547] Fix regressed logic for applying classic defaults

---
 osu.Game/Overlays/Settings/SettingsItem.cs | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/Settings/SettingsItem.cs b/osu.Game/Overlays/Settings/SettingsItem.cs
index 0b9a553c2c..db9fbfcbb4 100644
--- a/osu.Game/Overlays/Settings/SettingsItem.cs
+++ b/osu.Game/Overlays/Settings/SettingsItem.cs
@@ -141,7 +141,10 @@ namespace osu.Game.Overlays.Settings
 
         public void ApplyClassicDefault(bool useClassicDefault)
         {
-            if (hasClassicDefault && useClassicDefault)
+            if (!hasClassicDefault)
+                return;
+
+            if (useClassicDefault)
                 Current.Value = classicDefault;
             else
                 Current.SetDefault();

From 37ae39f5feb847926d6842e795523977268326a3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 26 Apr 2022 15:48:40 +0900
Subject: [PATCH 4305/5547] Move "Next" localisation to common strings

---
 osu.Game/Localisation/CommonStrings.cs               | 5 +++++
 osu.Game/Localisation/FirstRunSetupOverlayStrings.cs | 5 -----
 osu.Game/Overlays/FirstRunSetupOverlay.cs            | 2 +-
 3 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Localisation/CommonStrings.cs b/osu.Game/Localisation/CommonStrings.cs
index 6da2e4d272..52e9811cf7 100644
--- a/osu.Game/Localisation/CommonStrings.cs
+++ b/osu.Game/Localisation/CommonStrings.cs
@@ -14,6 +14,11 @@ namespace osu.Game.Localisation
         /// </summary>
         public static LocalisableString Back => new TranslatableString(getKey(@"back"), @"Back");
 
+        /// <summary>
+        /// "Next"
+        /// </summary>
+        public static LocalisableString Next => new TranslatableString(getKey(@"next"), @"Next");
+
         /// <summary>
         /// "Finish"
         /// </summary>
diff --git a/osu.Game/Localisation/FirstRunSetupOverlayStrings.cs b/osu.Game/Localisation/FirstRunSetupOverlayStrings.cs
index 001de93c16..ebce9e1ce1 100644
--- a/osu.Game/Localisation/FirstRunSetupOverlayStrings.cs
+++ b/osu.Game/Localisation/FirstRunSetupOverlayStrings.cs
@@ -48,11 +48,6 @@ osu! is a very configurable game, and diving straight into the settings can some
         /// </summary>
         public static LocalisableString UIScaleDescription => new TranslatableString(getKey(@"ui_scale_description"), @"The size of the osu! user interface can be adjusted to your liking.");
 
-        /// <summary>
-        /// "Next ({0})"
-        /// </summary>
-        public static LocalisableString Next(LocalisableString nextStepDescription) => new TranslatableString(getKey(@"next"), @"Next ({0})", nextStepDescription);
-
         private static string getKey(string key) => $@"{prefix}:{key}";
     }
 }
diff --git a/osu.Game/Overlays/FirstRunSetupOverlay.cs b/osu.Game/Overlays/FirstRunSetupOverlay.cs
index 87e62cbddf..5700fa3763 100644
--- a/osu.Game/Overlays/FirstRunSetupOverlay.cs
+++ b/osu.Game/Overlays/FirstRunSetupOverlay.cs
@@ -310,7 +310,7 @@ namespace osu.Game.Overlays
             if (currentStepIndex == 0)
                 NextButton.Text = FirstRunSetupOverlayStrings.GetStarted;
             else if (currentStepIndex < steps.Length - 1)
-                NextButton.Text = FirstRunSetupOverlayStrings.Next(steps[currentStepIndex.Value + 1].Description);
+                NextButton.Text = new TranslatableString(@"_", @"{0} ({1})", CommonStrings.Next, steps[currentStepIndex.Value + 1].Description);
             else
                 NextButton.Text = CommonStrings.Finish;
         }

From 2c836e2d6312fc0a162f322163385c484cb19a94 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 26 Apr 2022 15:55:32 +0900
Subject: [PATCH 4306/5547] Fix scrollbar overlapping content

---
 osu.Game/Overlays/FirstRunSetup/FirstRunSetupScreen.cs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Game/Overlays/FirstRunSetup/FirstRunSetupScreen.cs b/osu.Game/Overlays/FirstRunSetup/FirstRunSetupScreen.cs
index eb4b97069c..8fcfdbf689 100644
--- a/osu.Game/Overlays/FirstRunSetup/FirstRunSetupScreen.cs
+++ b/osu.Game/Overlays/FirstRunSetup/FirstRunSetupScreen.cs
@@ -22,6 +22,7 @@ namespace osu.Game.Overlays.FirstRunSetup
                 new OsuScrollContainer(Direction.Vertical)
                 {
                     RelativeSizeAxes = Axes.Both,
+                    ScrollbarOverlapsContent = false,
                     Child = Content = new FillFlowContainer
                     {
                         Spacing = new Vector2(20),

From a078440012482f4b575f74eab6dbee0484c3541f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 26 Apr 2022 16:03:15 +0900
Subject: [PATCH 4307/5547] Show last step on back button as well

---
 osu.Game/Overlays/FirstRunSetupOverlay.cs | 20 +++++++++++++++-----
 1 file changed, 15 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Overlays/FirstRunSetupOverlay.cs b/osu.Game/Overlays/FirstRunSetupOverlay.cs
index 5700fa3763..27a057bf09 100644
--- a/osu.Game/Overlays/FirstRunSetupOverlay.cs
+++ b/osu.Game/Overlays/FirstRunSetupOverlay.cs
@@ -133,7 +133,7 @@ namespace osu.Game.Overlays
                     {
                         BackButton = new DangerousTriangleButton
                         {
-                            Width = 200,
+                            Width = 300,
                             Text = CommonStrings.Back,
                             Action = showPreviousStep,
                             Enabled = { Value = false },
@@ -307,12 +307,22 @@ namespace osu.Game.Overlays
             if (currentStepIndex == null)
                 return;
 
-            if (currentStepIndex == 0)
+            bool isFirstStep = currentStepIndex == 0;
+            bool isLastStep = currentStepIndex == steps.Length - 1;
+
+            if (isFirstStep)
+            {
+                BackButton.Text = CommonStrings.Back;
                 NextButton.Text = FirstRunSetupOverlayStrings.GetStarted;
-            else if (currentStepIndex < steps.Length - 1)
-                NextButton.Text = new TranslatableString(@"_", @"{0} ({1})", CommonStrings.Next, steps[currentStepIndex.Value + 1].Description);
+            }
             else
-                NextButton.Text = CommonStrings.Finish;
+            {
+                BackButton.Text = new TranslatableString(@"_", @"{0} ({1})", CommonStrings.Back, steps[currentStepIndex.Value - 1].Description);
+
+                NextButton.Text = isLastStep
+                    ? CommonStrings.Finish
+                    : new TranslatableString(@"_", @"{0} ({1})", CommonStrings.Next, steps[currentStepIndex.Value + 1].Description);
+            }
         }
 
         private class FirstRunStep

From 01fdb771ee4844ddd724548f1188bbdcd4705241 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 26 Apr 2022 16:22:41 +0900
Subject: [PATCH 4308/5547] Add header text to first run setup screens

---
 .../FirstRunSetup/FirstRunSetupScreen.cs      | 30 +++++++++++++++----
 .../Overlays/FirstRunSetup/ScreenUIScale.cs   |  1 +
 .../Overlays/FirstRunSetup/ScreenWelcome.cs   |  6 +++-
 osu.Game/Overlays/FirstRunSetupOverlay.cs     | 24 ++++-----------
 4 files changed, 36 insertions(+), 25 deletions(-)

diff --git a/osu.Game/Overlays/FirstRunSetup/FirstRunSetupScreen.cs b/osu.Game/Overlays/FirstRunSetup/FirstRunSetupScreen.cs
index eb4b97069c..282ba52ddc 100644
--- a/osu.Game/Overlays/FirstRunSetup/FirstRunSetupScreen.cs
+++ b/osu.Game/Overlays/FirstRunSetup/FirstRunSetupScreen.cs
@@ -1,10 +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.Framework.Allocation;
+using osu.Framework.Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Screens;
+using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
+using osu.Game.Graphics.Sprites;
 using osuTK;
 
 namespace osu.Game.Overlays.FirstRunSetup
@@ -15,19 +19,33 @@ namespace osu.Game.Overlays.FirstRunSetup
 
         protected FillFlowContainer Content { get; private set; }
 
-        protected FirstRunSetupScreen()
+        [BackgroundDependencyLoader]
+        private void load(OverlayColourProvider overlayColourProvider)
         {
+            const float header_size = 40;
+            const float spacing = 20;
+
             InternalChildren = new Drawable[]
             {
                 new OsuScrollContainer(Direction.Vertical)
                 {
                     RelativeSizeAxes = Axes.Both,
-                    Child = Content = new FillFlowContainer
+                    Children = new Drawable[]
                     {
-                        Spacing = new Vector2(20),
-                        RelativeSizeAxes = Axes.X,
-                        AutoSizeAxes = Axes.Y,
-                        Direction = FillDirection.Vertical,
+                        new OsuSpriteText
+                        {
+                            Text = this.GetLocalisableDescription(),
+                            Font = OsuFont.Default.With(size: header_size),
+                            Colour = overlayColourProvider.Light1,
+                        },
+                        Content = new FillFlowContainer
+                        {
+                            Y = header_size + spacing,
+                            Spacing = new Vector2(spacing),
+                            RelativeSizeAxes = Axes.X,
+                            AutoSizeAxes = Axes.Y,
+                            Direction = FillDirection.Vertical,
+                        }
                     },
                 }
             };
diff --git a/osu.Game/Overlays/FirstRunSetup/ScreenUIScale.cs b/osu.Game/Overlays/FirstRunSetup/ScreenUIScale.cs
index ef48d9ced5..1bd82f6d99 100644
--- a/osu.Game/Overlays/FirstRunSetup/ScreenUIScale.cs
+++ b/osu.Game/Overlays/FirstRunSetup/ScreenUIScale.cs
@@ -27,6 +27,7 @@ using osuTK;
 
 namespace osu.Game.Overlays.FirstRunSetup
 {
+    [LocalisableDescription(typeof(GraphicsSettingsStrings), nameof(GraphicsSettingsStrings.UIScaling))]
     public class ScreenUIScale : FirstRunSetupScreen
     {
         [BackgroundDependencyLoader]
diff --git a/osu.Game/Overlays/FirstRunSetup/ScreenWelcome.cs b/osu.Game/Overlays/FirstRunSetup/ScreenWelcome.cs
index 39da180f40..10e15a7555 100644
--- a/osu.Game/Overlays/FirstRunSetup/ScreenWelcome.cs
+++ b/osu.Game/Overlays/FirstRunSetup/ScreenWelcome.cs
@@ -1,16 +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.Allocation;
 using osu.Framework.Graphics;
+using osu.Framework.Localisation;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Localisation;
 
 namespace osu.Game.Overlays.FirstRunSetup
 {
+    [LocalisableDescription(typeof(FirstRunSetupOverlayStrings), nameof(FirstRunSetupOverlayStrings.WelcomeTitle))]
     public class ScreenWelcome : FirstRunSetupScreen
     {
-        public ScreenWelcome()
+        [BackgroundDependencyLoader]
+        private void load()
         {
             Content.Children = new Drawable[]
             {
diff --git a/osu.Game/Overlays/FirstRunSetupOverlay.cs b/osu.Game/Overlays/FirstRunSetupOverlay.cs
index dc1ae2be37..7d5f4acee7 100644
--- a/osu.Game/Overlays/FirstRunSetupOverlay.cs
+++ b/osu.Game/Overlays/FirstRunSetupOverlay.cs
@@ -7,12 +7,12 @@ using System;
 using System.Diagnostics;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
+using osu.Framework.Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Input.Events;
-using osu.Framework.Localisation;
 using osu.Framework.Screens;
 using osu.Game.Configuration;
 using osu.Game.Graphics;
@@ -56,10 +56,10 @@ namespace osu.Game.Overlays
         /// </summary>
         public FirstRunSetupScreen? CurrentScreen => (FirstRunSetupScreen?)stack?.CurrentScreen;
 
-        private readonly FirstRunStep[] steps =
+        private readonly Type[] steps =
         {
-            new FirstRunStep(typeof(ScreenWelcome), FirstRunSetupOverlayStrings.WelcomeTitle),
-            new FirstRunStep(typeof(ScreenUIScale), GraphicsSettingsStrings.UIScaling),
+            typeof(ScreenWelcome),
+            typeof(ScreenUIScale)
         };
 
         private Container stackContainer = null!;
@@ -286,7 +286,7 @@ namespace osu.Game.Overlays
 
             if (currentStepIndex < steps.Length)
             {
-                stack.Push((Screen)Activator.CreateInstance(steps[currentStepIndex.Value].ScreenType));
+                stack.Push((Screen)Activator.CreateInstance(steps[currentStepIndex.Value]));
             }
             else
             {
@@ -307,21 +307,9 @@ namespace osu.Game.Overlays
             if (currentStepIndex != null)
             {
                 NextButton.Text = currentStepIndex + 1 < steps.Length
-                    ? FirstRunSetupOverlayStrings.Next(steps[currentStepIndex.Value + 1].Description)
+                    ? FirstRunSetupOverlayStrings.Next(steps[currentStepIndex.Value + 1].GetLocalisableDescription())
                     : CommonStrings.Finish;
             }
         }
-
-        private class FirstRunStep
-        {
-            public readonly Type ScreenType;
-            public readonly LocalisableString Description;
-
-            public FirstRunStep(Type screenType, LocalisableString description)
-            {
-                ScreenType = screenType;
-                Description = description;
-            }
-        }
     }
 }

From 280cd048f662090d5bdde09191daa9ff978190dc Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 26 Apr 2022 17:30:28 +0900
Subject: [PATCH 4309/5547] Fix joystick settings changing enabled state of
 config level bindables

Just copied what we had in place for the mouse sensitivity setting. For
tablet settings I believe I avoided this by just hiding the settings
when not enabled. Might be a better way forward, but this is simplest
for now.

Run `TestSceneSettingsPanel` twice to get a crash without this change.
---
 .../Sections/Input/JoystickSettings.cs        | 21 ++++++++++++++++++-
 1 file changed, 20 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/Settings/Sections/Input/JoystickSettings.cs b/osu.Game/Overlays/Settings/Sections/Input/JoystickSettings.cs
index c136ca6a19..60849cd6d4 100644
--- a/osu.Game/Overlays/Settings/Sections/Input/JoystickSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Input/JoystickSettings.cs
@@ -20,6 +20,10 @@ namespace osu.Game.Overlays.Settings.Sections.Input
 
         private SettingsSlider<float> deadzoneSlider;
 
+        private Bindable<float> handlerDeadzone;
+
+        private Bindable<float> localDeadzone;
+
         public JoystickSettings(JoystickHandler joystickHandler)
         {
             this.joystickHandler = joystickHandler;
@@ -28,6 +32,10 @@ namespace osu.Game.Overlays.Settings.Sections.Input
         [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
@@ -40,7 +48,7 @@ namespace osu.Game.Overlays.Settings.Sections.Input
                     LabelText = JoystickSettingsStrings.DeadzoneThreshold,
                     KeyboardStep = 0.01f,
                     DisplayAsPercentage = true,
-                    Current = joystickHandler.DeadzoneThreshold,
+                    Current = localDeadzone,
                 },
             };
         }
@@ -51,6 +59,17 @@ namespace osu.Game.Overlays.Settings.Sections.Input
 
             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);
         }
     }
 }

From c52c08fe9785e35735ae1dcacd4db5cbe4463bc6 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 26 Apr 2022 16:41:50 +0900
Subject: [PATCH 4310/5547] Rename test to increase scope

---
 ...stSceneShearedToggleButton.cs => TestSceneShearedButtons.cs} | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
 rename osu.Game.Tests/Visual/UserInterface/{TestSceneShearedToggleButton.cs => TestSceneShearedButtons.cs} (97%)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneShearedToggleButton.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneShearedButtons.cs
similarity index 97%
rename from osu.Game.Tests/Visual/UserInterface/TestSceneShearedToggleButton.cs
rename to osu.Game.Tests/Visual/UserInterface/TestSceneShearedButtons.cs
index b5109aa58d..ff83547087 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneShearedToggleButton.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneShearedButtons.cs
@@ -11,7 +11,7 @@ using osuTK.Input;
 namespace osu.Game.Tests.Visual.UserInterface
 {
     [TestFixture]
-    public class TestSceneShearedToggleButton : OsuManualInputManagerTestScene
+    public class TestSceneShearedButtons : OsuManualInputManagerTestScene
     {
         [Cached]
         private OverlayColourProvider colourProvider = new OverlayColourProvider(OverlayColourScheme.Green);

From 9f33e627de61afbe107efc6557c48c8d06331572 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 26 Apr 2022 17:31:55 +0900
Subject: [PATCH 4311/5547] Split out `ShearedButton` from
 `ShearedToggleButton`

---
 .../Graphics/UserInterface/ShearedButton.cs   | 174 ++++++++++++++++++
 .../UserInterface/ShearedToggleButton.cs      | 131 ++-----------
 2 files changed, 190 insertions(+), 115 deletions(-)
 create mode 100644 osu.Game/Graphics/UserInterface/ShearedButton.cs

diff --git a/osu.Game/Graphics/UserInterface/ShearedButton.cs b/osu.Game/Graphics/UserInterface/ShearedButton.cs
new file mode 100644
index 0000000000..5114e15e2e
--- /dev/null
+++ b/osu.Game/Graphics/UserInterface/ShearedButton.cs
@@ -0,0 +1,174 @@
+// 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 enable
+using osu.Framework.Allocation;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Colour;
+using osu.Framework.Graphics.Shapes;
+using osu.Framework.Input.Events;
+using osu.Framework.Localisation;
+using osu.Game.Graphics.Containers;
+using osu.Game.Graphics.Sprites;
+using osu.Game.Overlays;
+using osuTK;
+
+namespace osu.Game.Graphics.UserInterface
+{
+    public class ShearedButton : OsuClickableContainer
+    {
+        public LocalisableString Text
+        {
+            get => text.Text;
+            set => text.Text = value;
+        }
+
+        public Colour4 DarkerColour
+        {
+            set
+            {
+                darkerColour = value;
+                Scheduler.AddOnce(updateState);
+            }
+        }
+
+        public Colour4 LighterColour
+        {
+            set
+            {
+                lighterColour = value;
+                Scheduler.AddOnce(updateState);
+            }
+        }
+
+        public Colour4 TextColour
+        {
+            set
+            {
+                textColour = value;
+                Scheduler.AddOnce(updateState);
+            }
+        }
+
+        [Resolved]
+        protected OverlayColourProvider ColourProvider { get; private set; } = null!;
+
+        private readonly Box background;
+        private readonly OsuSpriteText text;
+
+        private const float shear = 0.2f;
+
+        private Colour4? darkerColour;
+        private Colour4? lighterColour;
+        private Colour4? textColour;
+
+        /// <summary>
+        /// Creates a new <see cref="ShearedToggleButton"/>
+        /// </summary>
+        /// <param name="width">
+        /// The width of the button.
+        /// <list type="bullet">
+        /// <item>If a non-<see langword="null"/> value is provided, this button will have a fixed width equal to the provided value.</item>
+        /// <item>If a <see langword="null"/> value is provided (or the argument is omitted entirely), the button will autosize in width to fit the text.</item>
+        /// </list>
+        /// </param>
+        public ShearedButton(float? width = null)
+        {
+            Height = 50;
+            Padding = new MarginPadding { Horizontal = shear * 50 };
+
+            Content.CornerRadius = 7;
+            Content.Shear = new Vector2(shear, 0);
+            Content.Masking = true;
+            Content.BorderThickness = 2;
+            Content.Anchor = Content.Origin = Anchor.Centre;
+
+            Children = new Drawable[]
+            {
+                background = new Box
+                {
+                    RelativeSizeAxes = Axes.Both
+                },
+                text = new OsuSpriteText
+                {
+                    Anchor = Anchor.Centre,
+                    Origin = Anchor.Centre,
+                    Font = OsuFont.TorusAlternate.With(size: 17),
+                    Shear = new Vector2(-shear, 0)
+                }
+            };
+
+            if (width != null)
+            {
+                Width = width.Value;
+            }
+            else
+            {
+                AutoSizeAxes = Axes.X;
+                text.Margin = new MarginPadding { Horizontal = 15 };
+            }
+        }
+
+        protected override HoverSounds CreateHoverSounds(HoverSampleSet sampleSet) => new HoverClickSounds(sampleSet);
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            Enabled.BindValueChanged(_ => Scheduler.AddOnce(updateState));
+
+            updateState();
+            FinishTransforms(true);
+        }
+
+        protected override bool OnHover(HoverEvent e)
+        {
+            Scheduler.AddOnce(updateState);
+            return base.OnHover(e);
+        }
+
+        protected override void OnHoverLost(HoverLostEvent e)
+        {
+            Scheduler.AddOnce(updateState);
+            base.OnHoverLost(e);
+        }
+
+        protected override bool OnMouseDown(MouseDownEvent e)
+        {
+            Content.ScaleTo(0.8f, 2000, Easing.OutQuint);
+            return base.OnMouseDown(e);
+        }
+
+        protected override void OnMouseUp(MouseUpEvent e)
+        {
+            Content.ScaleTo(1, 1000, Easing.OutElastic);
+            base.OnMouseUp(e);
+        }
+
+        private void updateState()
+        {
+            var colourDark = darkerColour ?? ColourProvider.Background3;
+            var colourLight = lighterColour ?? ColourProvider.Background1;
+            var colourText = textColour ?? ColourProvider.Content1;
+
+            if (!Enabled.Value)
+            {
+                colourDark = colourDark.Darken(0.3f);
+                colourLight = colourLight.Darken(0.3f);
+            }
+            else if (IsHovered)
+            {
+                colourDark = colourDark.Lighten(0.3f);
+                colourLight = colourLight.Lighten(0.3f);
+            }
+
+            background.FadeColour(colourDark, 150, Easing.OutQuint);
+            Content.TransformTo(nameof(BorderColour), ColourInfo.GradientVertical(colourDark, colourLight), 150, Easing.OutQuint);
+
+            if (!Enabled.Value)
+                colourText = colourText.Opacity(0.6f);
+
+            text.FadeColour(colourText, 150, Easing.OutQuint);
+        }
+    }
+}
diff --git a/osu.Game/Graphics/UserInterface/ShearedToggleButton.cs b/osu.Game/Graphics/UserInterface/ShearedToggleButton.cs
index aed3be20a0..c7273320fc 100644
--- a/osu.Game/Graphics/UserInterface/ShearedToggleButton.cs
+++ b/osu.Game/Graphics/UserInterface/ShearedToggleButton.cs
@@ -8,39 +8,18 @@ using osu.Framework.Allocation;
 using osu.Framework.Audio;
 using osu.Framework.Audio.Sample;
 using osu.Framework.Bindables;
-using osu.Framework.Extensions.Color4Extensions;
-using osu.Framework.Graphics;
-using osu.Framework.Graphics.Colour;
-using osu.Framework.Graphics.Shapes;
-using osu.Framework.Input.Events;
-using osu.Framework.Localisation;
-using osu.Game.Graphics.Containers;
-using osu.Game.Graphics.Sprites;
-using osu.Game.Overlays;
-using osuTK;
 
 namespace osu.Game.Graphics.UserInterface
 {
-    public class ShearedToggleButton : OsuClickableContainer
+    public class ShearedToggleButton : ShearedButton
     {
-        public BindableBool Active { get; } = new BindableBool();
-
-        public LocalisableString Text
-        {
-            get => text.Text;
-            set => text.Text = value;
-        }
-
-        private readonly Box background;
-        private readonly OsuSpriteText text;
-
         private Sample? sampleOff;
         private Sample? sampleOn;
 
-        private const float shear = 0.2f;
-
-        [Resolved]
-        private OverlayColourProvider colourProvider { get; set; } = null!;
+        /// <summary>
+        /// Whether this button is currently toggled to an active state.
+        /// </summary>
+        public BindableBool Active { get; } = new BindableBool();
 
         /// <summary>
         /// Creates a new <see cref="ShearedToggleButton"/>
@@ -53,40 +32,8 @@ namespace osu.Game.Graphics.UserInterface
         /// </list>
         /// </param>
         public ShearedToggleButton(float? width = null)
+            : base(width)
         {
-            Height = 50;
-            Padding = new MarginPadding { Horizontal = shear * 50 };
-
-            Content.CornerRadius = 7;
-            Content.Shear = new Vector2(shear, 0);
-            Content.Masking = true;
-            Content.BorderThickness = 2;
-            Content.Anchor = Content.Origin = Anchor.Centre;
-
-            Children = new Drawable[]
-            {
-                background = new Box
-                {
-                    RelativeSizeAxes = Axes.Both
-                },
-                text = new OsuSpriteText
-                {
-                    Anchor = Anchor.Centre,
-                    Origin = Anchor.Centre,
-                    Font = OsuFont.TorusAlternate.With(size: 17),
-                    Shear = new Vector2(-shear, 0)
-                }
-            };
-
-            if (width != null)
-            {
-                Width = width.Value;
-            }
-            else
-            {
-                AutoSizeAxes = Axes.X;
-                text.Margin = new MarginPadding { Horizontal = 15 };
-            }
         }
 
         [BackgroundDependencyLoader]
@@ -100,70 +47,24 @@ namespace osu.Game.Graphics.UserInterface
 
         protected override void LoadComplete()
         {
-            base.LoadComplete();
-
             Active.BindValueChanged(_ =>
             {
-                updateState();
+                updateActiveState();
                 playSample();
             });
-            Active.BindDisabledChanged(disabled =>
-            {
-                updateState();
-                Action = disabled ? (Action?)null : Active.Toggle;
-            }, true);
 
-            FinishTransforms(true);
+            updateActiveState();
+
+            Active.BindDisabledChanged(disabled => Action = disabled ? (Action?)null : Active.Toggle, true);
+
+            base.LoadComplete();
         }
 
-        protected override bool OnHover(HoverEvent e)
+        private void updateActiveState()
         {
-            updateState();
-            return base.OnHover(e);
-        }
-
-        protected override void OnHoverLost(HoverLostEvent e)
-        {
-            updateState();
-            base.OnHoverLost(e);
-        }
-
-        protected override bool OnMouseDown(MouseDownEvent e)
-        {
-            Content.ScaleTo(0.8f, 2000, Easing.OutQuint);
-            return base.OnMouseDown(e);
-        }
-
-        protected override void OnMouseUp(MouseUpEvent e)
-        {
-            Content.ScaleTo(1, 1000, Easing.OutElastic);
-            base.OnMouseUp(e);
-        }
-
-        private void updateState()
-        {
-            var darkerColour = Active.Value ? colourProvider.Highlight1 : colourProvider.Background3;
-            var lighterColour = Active.Value ? colourProvider.Colour0 : colourProvider.Background1;
-
-            if (Active.Disabled)
-            {
-                darkerColour = darkerColour.Darken(0.3f);
-                lighterColour = lighterColour.Darken(0.3f);
-            }
-            else if (IsHovered)
-            {
-                darkerColour = darkerColour.Lighten(0.3f);
-                lighterColour = lighterColour.Lighten(0.3f);
-            }
-
-            background.FadeColour(darkerColour, 150, Easing.OutQuint);
-            Content.TransformTo(nameof(BorderColour), ColourInfo.GradientVertical(darkerColour, lighterColour), 150, Easing.OutQuint);
-
-            var textColour = Active.Value ? colourProvider.Background6 : colourProvider.Content1;
-            if (Active.Disabled)
-                textColour = textColour.Opacity(0.6f);
-
-            text.FadeColour(textColour, 150, Easing.OutQuint);
+            DarkerColour = Active.Value ? ColourProvider.Highlight1 : ColourProvider.Background3;
+            LighterColour = Active.Value ? ColourProvider.Colour0 : ColourProvider.Background1;
+            TextColour = Active.Value ? ColourProvider.Background6 : ColourProvider.Content1;
         }
 
         private void playSample()

From 4e260e741077cba720196c425a3e130f8bebbc79 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 26 Apr 2022 17:32:20 +0900
Subject: [PATCH 4312/5547] Fix all buttons gamewide not animating properly on
 click

Not sure how or when this happened.
---
 osu.Game/Graphics/UserInterface/OsuButton.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Graphics/UserInterface/OsuButton.cs b/osu.Game/Graphics/UserInterface/OsuButton.cs
index 7c1e8d90a0..29a797bd78 100644
--- a/osu.Game/Graphics/UserInterface/OsuButton.cs
+++ b/osu.Game/Graphics/UserInterface/OsuButton.cs
@@ -108,7 +108,7 @@ namespace osu.Game.Graphics.UserInterface
             if (Enabled.Value)
             {
                 Debug.Assert(backgroundColour != null);
-                Background.FlashColour(backgroundColour.Value, 200);
+                Background.FlashColour(backgroundColour.Value.Lighten(0.4f), 200);
             }
 
             return base.OnClick(e);

From 6864623bacac5d1c9ab488c84f29ac88a06cc115 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 26 Apr 2022 17:32:02 +0900
Subject: [PATCH 4313/5547] Add `ShearedButton` test coverage

---
 .../UserInterface/TestSceneShearedButtons.cs  | 32 +++++++++++++++++++
 1 file changed, 32 insertions(+)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneShearedButtons.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneShearedButtons.cs
index ff83547087..4540528918 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneShearedButtons.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneShearedButtons.cs
@@ -16,6 +16,38 @@ namespace osu.Game.Tests.Visual.UserInterface
         [Cached]
         private OverlayColourProvider colourProvider = new OverlayColourProvider(OverlayColourScheme.Green);
 
+        [Test]
+        public void TestShearedButton()
+        {
+            ShearedButton button = null;
+            bool actionFired = false;
+
+            AddStep("create button", () =>
+            {
+                actionFired = false;
+
+                Child = button = new ShearedButton(200)
+                {
+                    LighterColour = Colour4.FromHex("#FF86DD"),
+                    DarkerColour = Colour4.FromHex("#DE31AE"),
+                    TextColour = Colour4.White,
+                    Anchor = Anchor.Centre,
+                    Origin = Anchor.Centre,
+                    Text = "Press me",
+                    Height = 80,
+                    Action = () => actionFired = true,
+                };
+            });
+
+            AddStep("set disabled", () => button.Enabled.Value = false);
+            AddStep("press button", () => button.TriggerClick());
+            AddAssert("action not fired", () => !actionFired);
+
+            AddStep("set enabled", () => button.Enabled.Value = true);
+            AddStep("press button", () => button.TriggerClick());
+            AddAssert("action fired", () => actionFired);
+        }
+
         [Test]
         public void TestShearedToggleButton()
         {

From 4bc4ff179a5a3f883af152090c07eacff4b57346 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 26 Apr 2022 18:03:34 +0900
Subject: [PATCH 4314/5547] Add flash effect on click

---
 .../Graphics/UserInterface/ShearedButton.cs   | 19 ++++++++++++++++++-
 1 file changed, 18 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Graphics/UserInterface/ShearedButton.cs b/osu.Game/Graphics/UserInterface/ShearedButton.cs
index 5114e15e2e..e9120a3b7d 100644
--- a/osu.Game/Graphics/UserInterface/ShearedButton.cs
+++ b/osu.Game/Graphics/UserInterface/ShearedButton.cs
@@ -62,6 +62,8 @@ namespace osu.Game.Graphics.UserInterface
         private Colour4? lighterColour;
         private Colour4? textColour;
 
+        private readonly Box flashLayer;
+
         /// <summary>
         /// Creates a new <see cref="ShearedToggleButton"/>
         /// </summary>
@@ -95,7 +97,14 @@ namespace osu.Game.Graphics.UserInterface
                     Origin = Anchor.Centre,
                     Font = OsuFont.TorusAlternate.With(size: 17),
                     Shear = new Vector2(-shear, 0)
-                }
+                },
+                flashLayer = new Box
+                {
+                    RelativeSizeAxes = Axes.Both,
+                    Colour = Colour4.White.Opacity(0.9f),
+                    Blending = BlendingParameters.Additive,
+                    Alpha = 0,
+                },
             };
 
             if (width != null)
@@ -121,6 +130,14 @@ namespace osu.Game.Graphics.UserInterface
             FinishTransforms(true);
         }
 
+        protected override bool OnClick(ClickEvent e)
+        {
+            if (Enabled.Value)
+                flashLayer.FadeOutFromOne(800, Easing.OutQuint);
+
+            return base.OnClick(e);
+        }
+
         protected override bool OnHover(HoverEvent e)
         {
             Scheduler.AddOnce(updateState);

From cd197a938046249950bbf395eb2c55277b2305cf Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 26 Apr 2022 18:11:03 +0900
Subject: [PATCH 4315/5547] Reduce the hover lightening effect slightly

---
 osu.Game/Graphics/UserInterface/ShearedButton.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Graphics/UserInterface/ShearedButton.cs b/osu.Game/Graphics/UserInterface/ShearedButton.cs
index e9120a3b7d..f995da9e4b 100644
--- a/osu.Game/Graphics/UserInterface/ShearedButton.cs
+++ b/osu.Game/Graphics/UserInterface/ShearedButton.cs
@@ -175,8 +175,8 @@ namespace osu.Game.Graphics.UserInterface
             }
             else if (IsHovered)
             {
-                colourDark = colourDark.Lighten(0.3f);
-                colourLight = colourLight.Lighten(0.3f);
+                colourDark = colourDark.Lighten(0.2f);
+                colourLight = colourLight.Lighten(0.2f);
             }
 
             background.FadeColour(colourDark, 150, Easing.OutQuint);

From 52a8f3848d5989e38615bbbaaa8e1c5d892199fc Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 26 Apr 2022 18:14:57 +0900
Subject: [PATCH 4316/5547] Expose font size and add big button test

---
 .../UserInterface/TestSceneShearedButtons.cs  | 43 +++++++++++++------
 .../Graphics/UserInterface/ShearedButton.cs   |  6 +++
 2 files changed, 37 insertions(+), 12 deletions(-)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneShearedButtons.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneShearedButtons.cs
index 4540528918..5a4eeef4d9 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneShearedButtons.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneShearedButtons.cs
@@ -16,8 +16,9 @@ namespace osu.Game.Tests.Visual.UserInterface
         [Cached]
         private OverlayColourProvider colourProvider = new OverlayColourProvider(OverlayColourScheme.Green);
 
-        [Test]
-        public void TestShearedButton()
+        [TestCase(false)]
+        [TestCase(true)]
+        public void TestShearedButton(bool bigButton)
         {
             ShearedButton button = null;
             bool actionFired = false;
@@ -26,17 +27,35 @@ namespace osu.Game.Tests.Visual.UserInterface
             {
                 actionFired = false;
 
-                Child = button = new ShearedButton(200)
+                if (bigButton)
                 {
-                    LighterColour = Colour4.FromHex("#FF86DD"),
-                    DarkerColour = Colour4.FromHex("#DE31AE"),
-                    TextColour = Colour4.White,
-                    Anchor = Anchor.Centre,
-                    Origin = Anchor.Centre,
-                    Text = "Press me",
-                    Height = 80,
-                    Action = () => actionFired = true,
-                };
+                    Child = button = new ShearedButton(400)
+                    {
+                        LighterColour = Colour4.FromHex("#FFFFFF"),
+                        DarkerColour = Colour4.FromHex("#FFCC22"),
+                        TextColour = Colour4.Black,
+                        TextSize = 36,
+                        Anchor = Anchor.Centre,
+                        Origin = Anchor.Centre,
+                        Text = "Let's GO!",
+                        Height = 80,
+                        Action = () => actionFired = true,
+                    };
+                }
+                else
+                {
+                    Child = button = new ShearedButton(200)
+                    {
+                        LighterColour = Colour4.FromHex("#FF86DD"),
+                        DarkerColour = Colour4.FromHex("#DE31AE"),
+                        TextColour = Colour4.White,
+                        Anchor = Anchor.Centre,
+                        Origin = Anchor.Centre,
+                        Text = "Press me",
+                        Height = 80,
+                        Action = () => actionFired = true,
+                    };
+                }
             });
 
             AddStep("set disabled", () => button.Enabled.Value = false);
diff --git a/osu.Game/Graphics/UserInterface/ShearedButton.cs b/osu.Game/Graphics/UserInterface/ShearedButton.cs
index f995da9e4b..c3c566782f 100644
--- a/osu.Game/Graphics/UserInterface/ShearedButton.cs
+++ b/osu.Game/Graphics/UserInterface/ShearedButton.cs
@@ -23,6 +23,12 @@ namespace osu.Game.Graphics.UserInterface
             set => text.Text = value;
         }
 
+        public float TextSize
+        {
+            get => text.Font.Size;
+            set => text.Font = OsuFont.TorusAlternate.With(size: value);
+        }
+
         public Colour4 DarkerColour
         {
             set

From 4a370f429eb3d484fc261af50fb53b809dd9a70b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 26 Apr 2022 18:21:46 +0900
Subject: [PATCH 4317/5547] Reorder initialisation of bindable action binding
 to make more sense

---
 osu.Game/Graphics/UserInterface/ShearedToggleButton.cs | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/osu.Game/Graphics/UserInterface/ShearedToggleButton.cs b/osu.Game/Graphics/UserInterface/ShearedToggleButton.cs
index c7273320fc..4780270f66 100644
--- a/osu.Game/Graphics/UserInterface/ShearedToggleButton.cs
+++ b/osu.Game/Graphics/UserInterface/ShearedToggleButton.cs
@@ -47,6 +47,7 @@ namespace osu.Game.Graphics.UserInterface
 
         protected override void LoadComplete()
         {
+            Active.BindDisabledChanged(disabled => Action = disabled ? (Action?)null : Active.Toggle, true);
             Active.BindValueChanged(_ =>
             {
                 updateActiveState();
@@ -54,9 +55,6 @@ namespace osu.Game.Graphics.UserInterface
             });
 
             updateActiveState();
-
-            Active.BindDisabledChanged(disabled => Action = disabled ? (Action?)null : Active.Toggle, true);
-
             base.LoadComplete();
         }
 

From e646233722e2c24b789217d8d8a087b8b4cb6787 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Tue, 26 Apr 2022 19:16:36 +0300
Subject: [PATCH 4318/5547] Use correct translation for "Accuracy" label in
 break overlay

---
 osu.Game/Screens/Play/Break/BreakInfo.cs | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/osu.Game/Screens/Play/Break/BreakInfo.cs b/osu.Game/Screens/Play/Break/BreakInfo.cs
index f95e949920..ead41a826a 100644
--- a/osu.Game/Screens/Play/Break/BreakInfo.cs
+++ b/osu.Game/Screens/Play/Break/BreakInfo.cs
@@ -43,8 +43,7 @@ namespace osu.Game.Screens.Play.Break
                         Direction = FillDirection.Vertical,
                         Children = new Drawable[]
                         {
-                            AccuracyDisplay = new PercentageBreakInfoLine(BeatmapsetsStrings.ShowStatsAccuracy),
-
+                            AccuracyDisplay = new PercentageBreakInfoLine(BeatmapsetsStrings.ShowScoreboardHeadersAccuracy),
                             // See https://github.com/ppy/osu/discussions/15185
                             // RankDisplay = new BreakInfoLine<int>("Rank"),
                             GradeDisplay = new BreakInfoLine<ScoreRank>("Grade"),

From b0d6e16658a17299663ca3451de1b094918429bb Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 26 Apr 2022 21:57:19 +0200
Subject: [PATCH 4319/5547] Invert data flow in column dim implementation

---
 osu.Game/Overlays/Mods/ModSelectScreen.cs | 82 ++++++++++++-----------
 1 file changed, 42 insertions(+), 40 deletions(-)

diff --git a/osu.Game/Overlays/Mods/ModSelectScreen.cs b/osu.Game/Overlays/Mods/ModSelectScreen.cs
index 11cffe7959..ccd160a534 100644
--- a/osu.Game/Overlays/Mods/ModSelectScreen.cs
+++ b/osu.Game/Overlays/Mods/ModSelectScreen.cs
@@ -86,9 +86,6 @@ namespace osu.Game.Overlays.Mods
                 }
             });
 
-            // initialise the scroll early, as we will want to pass it to its children in the hierarchy initialisation below.
-            columnScroll = new OsuScrollContainer(Direction.Horizontal);
-
             MainAreaContent.AddRange(new Drawable[]
             {
                 new Container
@@ -101,13 +98,13 @@ namespace osu.Game.Overlays.Mods
                     RelativePositionAxes = Axes.Both,
                     Children = new Drawable[]
                     {
-                        columnScroll.With(col =>
+                        columnScroll = new OsuScrollContainer(Direction.Horizontal)
                         {
-                            col.RelativeSizeAxes = Axes.Both;
-                            col.Masking = false;
-                            col.ClampExtension = 100;
-                            col.ScrollbarOverlapsContent = false;
-                            col.Child = columnFlow = new ColumnFlowContainer
+                            RelativeSizeAxes = Axes.Both,
+                            Masking = false,
+                            ClampExtension = 100,
+                            ScrollbarOverlapsContent = false,
+                            Child = columnFlow = new ColumnFlowContainer
                             {
                                 Direction = FillDirection.Horizontal,
                                 Shear = new Vector2(SHEAR, 0),
@@ -117,14 +114,14 @@ namespace osu.Game.Overlays.Mods
                                 Margin = new MarginPadding { Horizontal = 70 },
                                 Children = new[]
                                 {
-                                    createModColumnContent(columnScroll, ModType.DifficultyReduction, new[] { Key.Q, Key.W, Key.E, Key.R, Key.T, Key.Y, Key.U, Key.I, Key.O, Key.P }),
-                                    createModColumnContent(columnScroll, ModType.DifficultyIncrease, new[] { Key.A, Key.S, Key.D, Key.F, Key.G, Key.H, Key.J, Key.K, Key.L }),
-                                    createModColumnContent(columnScroll, ModType.Automation, new[] { Key.Z, Key.X, Key.C, Key.V, Key.B, Key.N, Key.M }),
-                                    createModColumnContent(columnScroll, ModType.Conversion),
-                                    createModColumnContent(columnScroll, ModType.Fun)
+                                    createModColumnContent(ModType.DifficultyReduction, new[] { Key.Q, Key.W, Key.E, Key.R, Key.T, Key.Y, Key.U, Key.I, Key.O, Key.P }),
+                                    createModColumnContent(ModType.DifficultyIncrease, new[] { Key.A, Key.S, Key.D, Key.F, Key.G, Key.H, Key.J, Key.K, Key.L }),
+                                    createModColumnContent(ModType.Automation, new[] { Key.Z, Key.X, Key.C, Key.V, Key.B, Key.N, Key.M }),
+                                    createModColumnContent(ModType.Conversion),
+                                    createModColumnContent(ModType.Fun)
                                 }
-                            };
-                        })
+                            }
+                        }
                     }
                 }
             });
@@ -159,11 +156,12 @@ namespace osu.Game.Overlays.Mods
             }
         }
 
-        private ColumnDimContainer createModColumnContent(OsuScrollContainer scroll, ModType modType, Key[]? toggleKeys = null)
-            => new ColumnDimContainer(scroll, CreateModColumn(modType, toggleKeys))
+        private ColumnDimContainer createModColumnContent(ModType modType, Key[]? toggleKeys = null)
+            => new ColumnDimContainer(CreateModColumn(modType, toggleKeys))
             {
                 AutoSizeAxes = Axes.X,
-                RelativeSizeAxes = Axes.Y
+                RelativeSizeAxes = Axes.Y,
+                RequestScroll = column => columnScroll.ScrollTo(Math.Clamp(column.DrawPosition.X - 70, 0, columnScroll.ScrollableExtent))
             };
 
         protected override void LoadComplete()
@@ -322,6 +320,22 @@ namespace osu.Game.Overlays.Mods
             }
         }
 
+        protected override void Update()
+        {
+            base.Update();
+
+            foreach (var column in columnFlow)
+            {
+                // DrawWidth/DrawPosition do not include shear effects, and we want to know the full extents of the columns post-shear,
+                // so we have to manually compensate.
+                var topLeft = column.ToSpaceOfOtherDrawable(new Vector2(-column.DrawHeight * SHEAR, 0), columnScroll);
+                var topRight = column.ToSpaceOfOtherDrawable(new Vector2(column.DrawWidth, 0), columnScroll);
+
+                column.Active.Value = Precision.AlmostBigger(topLeft.X, 0)
+                                      && Precision.DefinitelyBigger(columnScroll.DrawWidth, topRight.X);
+            }
+        }
+
         private class ColumnFlowContainer : FillFlowContainer<ColumnDimContainer>
         {
             public IEnumerable<ModColumn> Columns => Children.Select(dimWrapper => dimWrapper.Column);
@@ -362,23 +376,22 @@ namespace osu.Game.Overlays.Mods
         {
             public ModColumn Column { get; }
 
-            private readonly ScrollContainer<Drawable> parentScroll;
-            private readonly Bindable<bool> isFullyOnScreen = new BindableBool(true);
+            public readonly Bindable<bool> Active = new BindableBool();
+            public Action<ColumnDimContainer>? RequestScroll { get; set; }
 
             [Resolved]
             private OsuColour colours { get; set; } = null!;
 
-            public ColumnDimContainer(ScrollContainer<Drawable> parentScroll, ModColumn column)
+            public ColumnDimContainer(ModColumn column)
             {
-                this.parentScroll = parentScroll;
                 Child = Column = column;
-                column.Active.BindTo(isFullyOnScreen);
+                column.Active.BindTo(Active);
             }
 
             protected override void LoadComplete()
             {
                 base.LoadComplete();
-                isFullyOnScreen.BindValueChanged(_ => updateDim(), true);
+                Active.BindValueChanged(_ => updateDim(), true);
                 FinishTransforms();
             }
 
@@ -386,7 +399,7 @@ namespace osu.Game.Overlays.Mods
             {
                 Colour4 targetColour;
 
-                if (isFullyOnScreen.Value)
+                if (Active.Value)
                     targetColour = Colour4.White;
                 else
                     targetColour = IsHovered ? colours.GrayC : colours.Gray8;
@@ -394,21 +407,10 @@ namespace osu.Game.Overlays.Mods
                 this.FadeColour(targetColour, 300, Easing.OutQuint);
             }
 
-            protected override void Update()
-            {
-                // DrawWidth/DrawPosition do not include shear effects, and we want to know the full extents of the columns post-shear,
-                // so we have to manually compensate.
-                var topLeft = ToSpaceOfOtherDrawable(new Vector2(-DrawHeight * SHEAR, 0), parentScroll);
-                var topRight = ToSpaceOfOtherDrawable(new Vector2(DrawWidth, 0), parentScroll);
-
-                isFullyOnScreen.Value = Precision.AlmostBigger(topLeft.X, 0)
-                                        && Precision.DefinitelyBigger(parentScroll.DrawWidth, topRight.X);
-            }
-
             protected override bool OnMouseDown(MouseDownEvent e)
             {
-                if (!isFullyOnScreen.Value)
-                    parentScroll.ScrollTo(Math.Clamp(DrawPosition.X - 70, 0, parentScroll.ScrollableExtent));
+                if (!Active.Value)
+                    RequestScroll?.Invoke(this);
 
                 return true;
             }
@@ -417,7 +419,7 @@ namespace osu.Game.Overlays.Mods
             {
                 base.OnHover(e);
                 updateDim();
-                return isFullyOnScreen.Value;
+                return Active.Value;
             }
 
             protected override void OnHoverLost(HoverLostEvent e)

From 13a36f2e5124cb152490017f529beec799165989 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 26 Apr 2022 22:01:24 +0200
Subject: [PATCH 4320/5547] Scroll to column when mouse is released rather than
 pressed

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

diff --git a/osu.Game/Overlays/Mods/ModSelectScreen.cs b/osu.Game/Overlays/Mods/ModSelectScreen.cs
index ccd160a534..4299bc05f1 100644
--- a/osu.Game/Overlays/Mods/ModSelectScreen.cs
+++ b/osu.Game/Overlays/Mods/ModSelectScreen.cs
@@ -407,7 +407,7 @@ namespace osu.Game.Overlays.Mods
                 this.FadeColour(targetColour, 300, Easing.OutQuint);
             }
 
-            protected override bool OnMouseDown(MouseDownEvent e)
+            protected override bool OnClick(ClickEvent e)
             {
                 if (!Active.Value)
                     RequestScroll?.Invoke(this);

From e9c9c764ca457277e39e2d965ef0e11f1a59ce32 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 26 Apr 2022 22:15:58 +0200
Subject: [PATCH 4321/5547] Fix column dim state changing when scrolling past
 extent

---
 osu.Game/Overlays/Mods/ModSelectScreen.cs | 15 +++++++++++----
 1 file changed, 11 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Overlays/Mods/ModSelectScreen.cs b/osu.Game/Overlays/Mods/ModSelectScreen.cs
index 4299bc05f1..828ed93ca8 100644
--- a/osu.Game/Overlays/Mods/ModSelectScreen.cs
+++ b/osu.Game/Overlays/Mods/ModSelectScreen.cs
@@ -324,15 +324,22 @@ namespace osu.Game.Overlays.Mods
         {
             base.Update();
 
+            // the bounds below represent the horizontal range of scroll items to be considered fully visible/active, in the scroll's internal coordinate space.
+            // note that clamping is applied to the left scroll bound to ensure scrolling past extents does not change the set of active columns.
+            float leftScrollBound = Math.Clamp(columnScroll.Current, 0, columnScroll.ScrollableExtent);
+            float rightScrollBound = leftScrollBound + columnScroll.DrawWidth;
+
             foreach (var column in columnFlow)
             {
                 // DrawWidth/DrawPosition do not include shear effects, and we want to know the full extents of the columns post-shear,
                 // so we have to manually compensate.
-                var topLeft = column.ToSpaceOfOtherDrawable(new Vector2(-column.DrawHeight * SHEAR, 0), columnScroll);
-                var topRight = column.ToSpaceOfOtherDrawable(new Vector2(column.DrawWidth, 0), columnScroll);
+                // additionally note that columnFlow.Parent is not columnScroll, but rather it is the scroll's internal container.
+                // this is intentional in order to include margin of the columnFlow in calculations correctly and operate in the "scroll internal content space".
+                var topLeft = column.ToSpaceOfOtherDrawable(new Vector2(-column.DrawHeight * SHEAR, 0), columnFlow.Parent);
+                var topRight = column.ToSpaceOfOtherDrawable(new Vector2(column.DrawWidth, 0), columnFlow.Parent);
 
-                column.Active.Value = Precision.AlmostBigger(topLeft.X, 0)
-                                      && Precision.DefinitelyBigger(columnScroll.DrawWidth, topRight.X);
+                column.Active.Value = Precision.AlmostBigger(topLeft.X, leftScrollBound)
+                                      && Precision.DefinitelyBigger(rightScrollBound, topRight.X);
             }
         }
 

From a884f20c6541227ef42896b1d042ace7af3e0f6a Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Tue, 26 Apr 2022 22:19:20 +0300
Subject: [PATCH 4322/5547] Add failing test case

---
 .../TestSceneDrainingHealthProcessor.cs       | 37 +++++++++++++++++++
 1 file changed, 37 insertions(+)

diff --git a/osu.Game.Tests/Gameplay/TestSceneDrainingHealthProcessor.cs b/osu.Game.Tests/Gameplay/TestSceneDrainingHealthProcessor.cs
index 296c5cef76..56fb68ea27 100644
--- a/osu.Game.Tests/Gameplay/TestSceneDrainingHealthProcessor.cs
+++ b/osu.Game.Tests/Gameplay/TestSceneDrainingHealthProcessor.cs
@@ -160,6 +160,43 @@ namespace osu.Game.Tests.Gameplay
             assertHealthNotEqualTo(1);
         }
 
+        [Test]
+        public void TestFailConditions()
+        {
+            var beatmap = createBeatmap(0, 1000);
+            createProcessor(beatmap);
+
+            AddStep("setup fail conditions", () => processor.FailConditions += ((_, result) => result.Type == HitResult.Miss));
+
+            AddStep("apply perfect hit result", () => processor.ApplyResult(new JudgementResult(beatmap.HitObjects[0], new Judgement()) { Type = HitResult.Perfect }));
+            AddAssert("not failed", () => !processor.HasFailed);
+            AddStep("apply miss hit result", () => processor.ApplyResult(new JudgementResult(beatmap.HitObjects[0], new Judgement()) { Type = HitResult.Miss }));
+            AddAssert("failed", () => processor.HasFailed);
+        }
+
+        [Test]
+        public void TestMultipleFailConditions([Values] bool applyFirstCondition)
+        {
+            var beatmap = createBeatmap(0, 1000);
+            createProcessor(beatmap);
+
+            AddStep("setup multiple fail conditions", () =>
+            {
+                processor.FailConditions += ((_, result) => result.Type == HitResult.Miss);
+                processor.FailConditions += ((_, result) => result.Type == HitResult.Meh);
+            });
+
+            AddStep("apply perfect hit result", () => processor.ApplyResult(new JudgementResult(beatmap.HitObjects[0], new Judgement()) { Type = HitResult.Perfect }));
+            AddAssert("not failed", () => !processor.HasFailed);
+
+            if (applyFirstCondition)
+                AddStep("apply miss hit result", () => processor.ApplyResult(new JudgementResult(beatmap.HitObjects[0], new Judgement()) { Type = HitResult.Miss }));
+            else
+                AddStep("apply meh hit result", () => processor.ApplyResult(new JudgementResult(beatmap.HitObjects[0], new Judgement()) { Type = HitResult.Meh }));
+
+            AddAssert("failed", () => processor.HasFailed);
+        }
+
         [Test]
         public void TestBonusObjectsExcludedFromDrain()
         {

From 31f64b13819620d1eee947e84dae43220b371081 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Tue, 26 Apr 2022 22:49:14 +0300
Subject: [PATCH 4323/5547] Fix `HealthProcessor` fail conditions not handling
 multiple invocations

---
 osu.Game/Rulesets/Scoring/HealthProcessor.cs | 32 +++++++++++++++++---
 1 file changed, 27 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Rulesets/Scoring/HealthProcessor.cs b/osu.Game/Rulesets/Scoring/HealthProcessor.cs
index a92c30e593..5e4e40b3bb 100644
--- a/osu.Game/Rulesets/Scoring/HealthProcessor.cs
+++ b/osu.Game/Rulesets/Scoring/HealthProcessor.cs
@@ -43,11 +43,11 @@ namespace osu.Game.Rulesets.Scoring
 
             Health.Value += GetHealthIncreaseFor(result);
 
-            if (!DefaultFailCondition && FailConditions?.Invoke(this, result) != true)
-                return;
-
-            if (Failed?.Invoke() != false)
-                HasFailed = true;
+            if (meetsFailConditions(result))
+            {
+                if (Failed?.Invoke() != false)
+                    HasFailed = true;
+            }
         }
 
         protected override void RevertResultInternal(JudgementResult result)
@@ -69,6 +69,28 @@ namespace osu.Game.Rulesets.Scoring
         /// </summary>
         protected virtual bool DefaultFailCondition => Precision.AlmostBigger(Health.MinValue, Health.Value);
 
+        /// <summary>
+        /// Whether the current state of <see cref="HealthProcessor"/> or the provided <paramref name="result"/> meets the fail conditions.
+        /// </summary>
+        /// <param name="result">The judgement result.</param>
+        private bool meetsFailConditions(JudgementResult result)
+        {
+            if (DefaultFailCondition)
+                return true;
+
+            if (FailConditions != null)
+            {
+                foreach (var condition in FailConditions.GetInvocationList())
+                {
+                    bool conditionResult = (bool)condition.Method.Invoke(condition.Target, new object[] { this, result });
+                    if (conditionResult)
+                        return true;
+                }
+            }
+
+            return false;
+        }
+
         protected override void Reset(bool storeResults)
         {
             base.Reset(storeResults);

From fb6a112708e5b1759fd5625f96d04a2788f5ebde Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Tue, 26 Apr 2022 23:09:51 +0300
Subject: [PATCH 4324/5547] Mark `OsuModTarget` and `OsuModSuddenDeath` as
 mutually exclusive

`OsuModTarget` already fails on miss, so "Sudden Death" doesn't make
sense to be enabled and may only cause issues.
---
 osu.Game.Rulesets.Osu/Mods/OsuModSuddenDeath.cs | 6 +++++-
 osu.Game.Rulesets.Osu/Mods/OsuModTarget.cs      | 2 +-
 2 files changed, 6 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModSuddenDeath.cs b/osu.Game.Rulesets.Osu/Mods/OsuModSuddenDeath.cs
index 0403e81229..429fe30fc5 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModSuddenDeath.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModSuddenDeath.cs
@@ -9,6 +9,10 @@ namespace osu.Game.Rulesets.Osu.Mods
 {
     public class OsuModSuddenDeath : ModSuddenDeath
     {
-        public override Type[] IncompatibleMods => base.IncompatibleMods.Append(typeof(OsuModAutopilot)).ToArray();
+        public override Type[] IncompatibleMods => base.IncompatibleMods.Concat(new[]
+        {
+            typeof(OsuModAutopilot),
+            typeof(OsuModTarget),
+        }).ToArray();
     }
 }
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModTarget.cs b/osu.Game.Rulesets.Osu/Mods/OsuModTarget.cs
index 5285380097..4fab9b6a5a 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModTarget.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModTarget.cs
@@ -42,7 +42,7 @@ namespace osu.Game.Rulesets.Osu.Mods
         public override string Description => @"Practice keeping up with the beat of the song.";
         public override double ScoreMultiplier => 1;
 
-        public override Type[] IncompatibleMods => new[] { typeof(IRequiresApproachCircles) };
+        public override Type[] IncompatibleMods => new[] { typeof(IRequiresApproachCircles), typeof(OsuModSuddenDeath) };
 
         [SettingSource("Seed", "Use a custom seed instead of a random one", SettingControlType = typeof(SettingsNumberBox))]
         public Bindable<int?> Seed { get; } = new Bindable<int?>

From 94d07e147f565fa89552b27d2ba89a2acda6c5ea Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 26 Apr 2022 22:35:18 +0200
Subject: [PATCH 4325/5547] Move dimming logic to custom scroll container

---
 osu.Game/Overlays/Mods/ModSelectScreen.cs | 44 +++++++++++++----------
 1 file changed, 25 insertions(+), 19 deletions(-)

diff --git a/osu.Game/Overlays/Mods/ModSelectScreen.cs b/osu.Game/Overlays/Mods/ModSelectScreen.cs
index 828ed93ca8..3aaec5edfd 100644
--- a/osu.Game/Overlays/Mods/ModSelectScreen.cs
+++ b/osu.Game/Overlays/Mods/ModSelectScreen.cs
@@ -61,7 +61,7 @@ namespace osu.Game.Overlays.Mods
 
         private DifficultyMultiplierDisplay? multiplierDisplay;
         private ModSettingsArea modSettingsArea = null!;
-        private OsuScrollContainer columnScroll = null!;
+        private ColumnScrollContainer columnScroll = null!;
         private ColumnFlowContainer columnFlow = null!;
 
         [BackgroundDependencyLoader]
@@ -98,7 +98,7 @@ namespace osu.Game.Overlays.Mods
                     RelativePositionAxes = Axes.Both,
                     Children = new Drawable[]
                     {
-                        columnScroll = new OsuScrollContainer(Direction.Horizontal)
+                        columnScroll = new ColumnScrollContainer
                         {
                             RelativeSizeAxes = Axes.Both,
                             Masking = false,
@@ -320,26 +320,32 @@ namespace osu.Game.Overlays.Mods
             }
         }
 
-        protected override void Update()
+        private class ColumnScrollContainer : OsuScrollContainer<ColumnFlowContainer>
         {
-            base.Update();
-
-            // the bounds below represent the horizontal range of scroll items to be considered fully visible/active, in the scroll's internal coordinate space.
-            // note that clamping is applied to the left scroll bound to ensure scrolling past extents does not change the set of active columns.
-            float leftScrollBound = Math.Clamp(columnScroll.Current, 0, columnScroll.ScrollableExtent);
-            float rightScrollBound = leftScrollBound + columnScroll.DrawWidth;
-
-            foreach (var column in columnFlow)
+            public ColumnScrollContainer()
+                : base(Direction.Horizontal)
             {
-                // DrawWidth/DrawPosition do not include shear effects, and we want to know the full extents of the columns post-shear,
-                // so we have to manually compensate.
-                // additionally note that columnFlow.Parent is not columnScroll, but rather it is the scroll's internal container.
-                // this is intentional in order to include margin of the columnFlow in calculations correctly and operate in the "scroll internal content space".
-                var topLeft = column.ToSpaceOfOtherDrawable(new Vector2(-column.DrawHeight * SHEAR, 0), columnFlow.Parent);
-                var topRight = column.ToSpaceOfOtherDrawable(new Vector2(column.DrawWidth, 0), columnFlow.Parent);
+            }
 
-                column.Active.Value = Precision.AlmostBigger(topLeft.X, leftScrollBound)
-                                      && Precision.DefinitelyBigger(rightScrollBound, topRight.X);
+            protected override void Update()
+            {
+                base.Update();
+
+                // the bounds below represent the horizontal range of scroll items to be considered fully visible/active, in the scroll's internal coordinate space.
+                // note that clamping is applied to the left scroll bound to ensure scrolling past extents does not change the set of active columns.
+                float leftScrollBound = Math.Clamp(Current, 0, ScrollableExtent);
+                float rightScrollBound = leftScrollBound + DrawWidth;
+
+                foreach (var column in Child)
+                {
+                    // DrawWidth/DrawPosition do not include shear effects, and we want to know the full extents of the columns post-shear,
+                    // so we have to manually compensate.
+                    var topLeft = column.ToSpaceOfOtherDrawable(new Vector2(-column.DrawHeight * SHEAR, 0), ScrollContent);
+                    var topRight = column.ToSpaceOfOtherDrawable(new Vector2(column.DrawWidth, 0), ScrollContent);
+
+                    column.Active.Value = Precision.AlmostBigger(topLeft.X, leftScrollBound)
+                                          && Precision.DefinitelyBigger(rightScrollBound, topRight.X);
+                }
             }
         }
 

From 21377d2a4d96f5265043ef4b360c6b2ab5754067 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 26 Apr 2022 22:43:58 +0200
Subject: [PATCH 4326/5547] Fix inactive columns flickering on and off
 mid-scroll

---
 osu.Game/Overlays/Mods/ModSelectScreen.cs | 17 +++++++++++++----
 1 file changed, 13 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Overlays/Mods/ModSelectScreen.cs b/osu.Game/Overlays/Mods/ModSelectScreen.cs
index 3aaec5edfd..d0d487d1ad 100644
--- a/osu.Game/Overlays/Mods/ModSelectScreen.cs
+++ b/osu.Game/Overlays/Mods/ModSelectScreen.cs
@@ -333,8 +333,13 @@ namespace osu.Game.Overlays.Mods
 
                 // the bounds below represent the horizontal range of scroll items to be considered fully visible/active, in the scroll's internal coordinate space.
                 // note that clamping is applied to the left scroll bound to ensure scrolling past extents does not change the set of active columns.
-                float leftScrollBound = Math.Clamp(Current, 0, ScrollableExtent);
-                float rightScrollBound = leftScrollBound + DrawWidth;
+                float leftVisibleBound = Math.Clamp(Current, 0, ScrollableExtent);
+                float rightVisibleBound = leftVisibleBound + DrawWidth;
+
+                // if a movement is occurring at this time, the bounds below represent the full range of columns that the scroll movement will encompass.
+                // this will be used to ensure that columns do not change state from active to inactive back and forth until they are fully scrolled past.
+                float leftMovementBound = Math.Min(Current, Target);
+                float rightMovementBound = Math.Max(Current, Target) + DrawWidth;
 
                 foreach (var column in Child)
                 {
@@ -343,8 +348,12 @@ namespace osu.Game.Overlays.Mods
                     var topLeft = column.ToSpaceOfOtherDrawable(new Vector2(-column.DrawHeight * SHEAR, 0), ScrollContent);
                     var topRight = column.ToSpaceOfOtherDrawable(new Vector2(column.DrawWidth, 0), ScrollContent);
 
-                    column.Active.Value = Precision.AlmostBigger(topLeft.X, leftScrollBound)
-                                          && Precision.DefinitelyBigger(rightScrollBound, topRight.X);
+                    bool isCurrentlyVisible = Precision.AlmostBigger(topLeft.X, leftVisibleBound)
+                                              && Precision.DefinitelyBigger(rightVisibleBound, topRight.X);
+                    bool isBeingScrolledToward = Precision.AlmostBigger(topLeft.X, leftMovementBound)
+                                                 && Precision.DefinitelyBigger(rightMovementBound, topRight.X);
+
+                    column.Active.Value = isCurrentlyVisible || isBeingScrolledToward;
                 }
             }
         }

From 921e8af3b039b7c1f3ee10d23aaea2fcf3807d44 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 26 Apr 2022 22:54:54 +0200
Subject: [PATCH 4327/5547] Use more lenient column bounds for checking active
 state

---
 osu.Game/Overlays/Mods/ModSelectScreen.cs | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Overlays/Mods/ModSelectScreen.cs b/osu.Game/Overlays/Mods/ModSelectScreen.cs
index d0d487d1ad..76f4a8cdd4 100644
--- a/osu.Game/Overlays/Mods/ModSelectScreen.cs
+++ b/osu.Game/Overlays/Mods/ModSelectScreen.cs
@@ -345,13 +345,13 @@ namespace osu.Game.Overlays.Mods
                 {
                     // DrawWidth/DrawPosition do not include shear effects, and we want to know the full extents of the columns post-shear,
                     // so we have to manually compensate.
-                    var topLeft = column.ToSpaceOfOtherDrawable(new Vector2(-column.DrawHeight * SHEAR, 0), ScrollContent);
-                    var topRight = column.ToSpaceOfOtherDrawable(new Vector2(column.DrawWidth, 0), ScrollContent);
+                    var topLeft = column.ToSpaceOfOtherDrawable(Vector2.Zero, ScrollContent);
+                    var bottomRight = column.ToSpaceOfOtherDrawable(new Vector2(column.DrawWidth - column.DrawHeight * SHEAR, 0), ScrollContent);
 
                     bool isCurrentlyVisible = Precision.AlmostBigger(topLeft.X, leftVisibleBound)
-                                              && Precision.DefinitelyBigger(rightVisibleBound, topRight.X);
+                                              && Precision.DefinitelyBigger(rightVisibleBound, bottomRight.X);
                     bool isBeingScrolledToward = Precision.AlmostBigger(topLeft.X, leftMovementBound)
-                                                 && Precision.DefinitelyBigger(rightMovementBound, topRight.X);
+                                                 && Precision.DefinitelyBigger(rightMovementBound, bottomRight.X);
 
                     column.Active.Value = isCurrentlyVisible || isBeingScrolledToward;
                 }

From cccc9d7d39dbde7a876c3b48a60273edb0a03a3a Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 27 Apr 2022 00:03:48 +0300
Subject: [PATCH 4328/5547] Rename method to better reflect what it's doing

---
 osu.Game/Rulesets/Scoring/HealthProcessor.cs | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Rulesets/Scoring/HealthProcessor.cs b/osu.Game/Rulesets/Scoring/HealthProcessor.cs
index 5e4e40b3bb..0f51560476 100644
--- a/osu.Game/Rulesets/Scoring/HealthProcessor.cs
+++ b/osu.Game/Rulesets/Scoring/HealthProcessor.cs
@@ -43,7 +43,7 @@ namespace osu.Game.Rulesets.Scoring
 
             Health.Value += GetHealthIncreaseFor(result);
 
-            if (meetsFailConditions(result))
+            if (meetsAnyFailCondition(result))
             {
                 if (Failed?.Invoke() != false)
                     HasFailed = true;
@@ -70,10 +70,10 @@ namespace osu.Game.Rulesets.Scoring
         protected virtual bool DefaultFailCondition => Precision.AlmostBigger(Health.MinValue, Health.Value);
 
         /// <summary>
-        /// Whether the current state of <see cref="HealthProcessor"/> or the provided <paramref name="result"/> meets the fail conditions.
+        /// Whether the current state of <see cref="HealthProcessor"/> or the provided <paramref name="result"/> meets any fail condition.
         /// </summary>
         /// <param name="result">The judgement result.</param>
-        private bool meetsFailConditions(JudgementResult result)
+        private bool meetsAnyFailCondition(JudgementResult result)
         {
             if (DefaultFailCondition)
                 return true;

From 1676c2c3f69ad7836e2199986f34f44edab73960 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 27 Apr 2022 00:05:15 +0300
Subject: [PATCH 4329/5547] Change boolean argument to `HitResult` instead

---
 .../Gameplay/TestSceneDrainingHealthProcessor.cs      | 11 ++++-------
 1 file changed, 4 insertions(+), 7 deletions(-)

diff --git a/osu.Game.Tests/Gameplay/TestSceneDrainingHealthProcessor.cs b/osu.Game.Tests/Gameplay/TestSceneDrainingHealthProcessor.cs
index 56fb68ea27..a7cd567635 100644
--- a/osu.Game.Tests/Gameplay/TestSceneDrainingHealthProcessor.cs
+++ b/osu.Game.Tests/Gameplay/TestSceneDrainingHealthProcessor.cs
@@ -174,8 +174,9 @@ namespace osu.Game.Tests.Gameplay
             AddAssert("failed", () => processor.HasFailed);
         }
 
-        [Test]
-        public void TestMultipleFailConditions([Values] bool applyFirstCondition)
+        [TestCase(HitResult.Miss)]
+        [TestCase(HitResult.Meh)]
+        public void TestMultipleFailConditions(HitResult resultApplied)
         {
             var beatmap = createBeatmap(0, 1000);
             createProcessor(beatmap);
@@ -189,11 +190,7 @@ namespace osu.Game.Tests.Gameplay
             AddStep("apply perfect hit result", () => processor.ApplyResult(new JudgementResult(beatmap.HitObjects[0], new Judgement()) { Type = HitResult.Perfect }));
             AddAssert("not failed", () => !processor.HasFailed);
 
-            if (applyFirstCondition)
-                AddStep("apply miss hit result", () => processor.ApplyResult(new JudgementResult(beatmap.HitObjects[0], new Judgement()) { Type = HitResult.Miss }));
-            else
-                AddStep("apply meh hit result", () => processor.ApplyResult(new JudgementResult(beatmap.HitObjects[0], new Judgement()) { Type = HitResult.Meh }));
-
+            AddStep($"apply {resultApplied.ToString().ToLower()} hit result", () => processor.ApplyResult(new JudgementResult(beatmap.HitObjects[0], new Judgement()) { Type = HitResult.Miss }));
             AddAssert("failed", () => processor.HasFailed);
         }
 

From 8842847b1850e574f95e537fba07684ff9523c23 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 27 Apr 2022 00:05:49 +0300
Subject: [PATCH 4330/5547] Fix wrong result applied

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

diff --git a/osu.Game.Tests/Gameplay/TestSceneDrainingHealthProcessor.cs b/osu.Game.Tests/Gameplay/TestSceneDrainingHealthProcessor.cs
index a7cd567635..a354464a8e 100644
--- a/osu.Game.Tests/Gameplay/TestSceneDrainingHealthProcessor.cs
+++ b/osu.Game.Tests/Gameplay/TestSceneDrainingHealthProcessor.cs
@@ -190,7 +190,7 @@ namespace osu.Game.Tests.Gameplay
             AddStep("apply perfect hit result", () => processor.ApplyResult(new JudgementResult(beatmap.HitObjects[0], new Judgement()) { Type = HitResult.Perfect }));
             AddAssert("not failed", () => !processor.HasFailed);
 
-            AddStep($"apply {resultApplied.ToString().ToLower()} hit result", () => processor.ApplyResult(new JudgementResult(beatmap.HitObjects[0], new Judgement()) { Type = HitResult.Miss }));
+            AddStep($"apply {resultApplied.ToString().ToLower()} hit result", () => processor.ApplyResult(new JudgementResult(beatmap.HitObjects[0], new Judgement()) { Type = resultApplied }));
             AddAssert("failed", () => processor.HasFailed);
         }
 

From a849bfcf60523da4b7b69d1ce92325cd75a71f7b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 26 Apr 2022 23:11:38 +0200
Subject: [PATCH 4331/5547] Rewrite dim test to pass headless

Unfortunately neuters the test a touch, but alas.
---
 .../UserInterface/TestSceneModSelectScreen.cs | 28 +++++++++----------
 osu.Game/Overlays/Mods/ModSelectScreen.cs     |  2 +-
 2 files changed, 14 insertions(+), 16 deletions(-)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs
index d7ae131372..ec6e962c6a 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs
@@ -119,25 +119,23 @@ namespace osu.Game.Tests.Visual.UserInterface
 
             AddUntilStep("any column dimmed", () => this.ChildrenOfType<ModColumn>().Any(column => !column.Active.Value));
 
-            ModColumn firstDimmed = null;
-            ModPanel firstPanel = null;
+            ModColumn lastColumn = null;
 
-            AddStep("click first panel on dimmed column", () =>
+            AddAssert("last column dimmed", () => !this.ChildrenOfType<ModColumn>().Last().Active.Value);
+            AddStep("request scroll to last column", () =>
             {
-                firstDimmed = this.ChildrenOfType<ModColumn>().First(column => !column.Active.Value);
-                firstPanel = firstDimmed.ChildrenOfType<ModPanel>().First();
-                InputManager.MoveMouseTo(firstPanel);
+                var lastDimContainer = this.ChildrenOfType<ModSelectScreen.ColumnDimContainer>().Last();
+                lastColumn = lastDimContainer.Column;
+                lastDimContainer.RequestScroll?.Invoke(lastDimContainer);
+            });
+            AddUntilStep("column undimmed", () => lastColumn.Active.Value);
+
+            AddStep("click panel", () =>
+            {
+                InputManager.MoveMouseTo(lastColumn.ChildrenOfType<ModPanel>().First());
                 InputManager.Click(MouseButton.Left);
             });
-            AddUntilStep("column undimmed", () => firstDimmed.Active.Value);
-            AddAssert("panel not selected", () => !firstPanel.Active.Value);
-
-            AddStep("click panel again", () =>
-            {
-                InputManager.MoveMouseTo(firstPanel);
-                InputManager.Click(MouseButton.Left);
-            });
-            AddUntilStep("panel selected", () => firstPanel.Active.Value);
+            AddUntilStep("panel selected", () => lastColumn.ChildrenOfType<ModPanel>().First().Active.Value);
         }
 
         [Test]
diff --git a/osu.Game/Overlays/Mods/ModSelectScreen.cs b/osu.Game/Overlays/Mods/ModSelectScreen.cs
index 76f4a8cdd4..e28b46436c 100644
--- a/osu.Game/Overlays/Mods/ModSelectScreen.cs
+++ b/osu.Game/Overlays/Mods/ModSelectScreen.cs
@@ -394,7 +394,7 @@ namespace osu.Game.Overlays.Mods
             }
         }
 
-        private class ColumnDimContainer : Container
+        internal class ColumnDimContainer : Container
         {
             public ModColumn Column { get; }
 

From 0343687b85fd00349056b06da0ef3fda63317e4c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 27 Apr 2022 15:59:39 +0900
Subject: [PATCH 4332/5547] Make apply default methods more explicit in
 behaviour

---
 .../Overlays/FirstRunSetup/ScreenBehaviour.cs |  9 +++++----
 osu.Game/Overlays/Settings/ISettingsItem.cs   | 15 +++++++++++---
 osu.Game/Overlays/Settings/SettingsItem.cs    | 20 +++++++++----------
 3 files changed, 27 insertions(+), 17 deletions(-)

diff --git a/osu.Game/Overlays/FirstRunSetup/ScreenBehaviour.cs b/osu.Game/Overlays/FirstRunSetup/ScreenBehaviour.cs
index 61177c821b..1316d14302 100644
--- a/osu.Game/Overlays/FirstRunSetup/ScreenBehaviour.cs
+++ b/osu.Game/Overlays/FirstRunSetup/ScreenBehaviour.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;
@@ -91,14 +92,14 @@ namespace osu.Game.Overlays.FirstRunSetup
 
         private void applyClassic()
         {
-            foreach (var i in searchContainer.ChildrenOfType<ISettingsItem>())
-                i.ApplyClassicDefault(true);
+            foreach (var i in searchContainer.ChildrenOfType<ISettingsItem>().Where(s => s.HasClassicDefault))
+                i.ApplyClassicDefault();
         }
 
         private void applyStandard()
         {
-            foreach (var i in searchContainer.ChildrenOfType<ISettingsItem>())
-                i.ApplyClassicDefault(false);
+            foreach (var i in searchContainer.ChildrenOfType<ISettingsItem>().Where(s => s.HasClassicDefault))
+                i.ApplyDefault();
         }
     }
 }
diff --git a/osu.Game/Overlays/Settings/ISettingsItem.cs b/osu.Game/Overlays/Settings/ISettingsItem.cs
index e6b1e68741..61191dcacf 100644
--- a/osu.Game/Overlays/Settings/ISettingsItem.cs
+++ b/osu.Game/Overlays/Settings/ISettingsItem.cs
@@ -11,9 +11,18 @@ namespace osu.Game.Overlays.Settings
         event Action SettingChanged;
 
         /// <summary>
-        /// Apply the default values of a setting item, if the setting item specifies a "classic" default via <see cref="SettingsItem{T}.ApplyClassicDefault"/>.
+        /// Whether this setting has a classic default (ie. a different default which better aligns with osu-stable expectations).
         /// </summary>
-        /// <param name="useClassicDefault">Whether to apply the classic value. If <c>false</c>, the standard default is applied.</param>
-        void ApplyClassicDefault(bool useClassicDefault);
+        bool HasClassicDefault { get; }
+
+        /// <summary>
+        /// Apply the classic default value of the associated setting. Will throw if <see cref="HasClassicDefault"/> is <c>false</c>.
+        /// </summary>
+        void ApplyClassicDefault();
+
+        /// <summary>
+        /// Apply the default value of the associated setting.
+        /// </summary>
+        void ApplyDefault();
     }
 }
diff --git a/osu.Game/Overlays/Settings/SettingsItem.cs b/osu.Game/Overlays/Settings/SettingsItem.cs
index 3c755ab570..afcd41af22 100644
--- a/osu.Game/Overlays/Settings/SettingsItem.cs
+++ b/osu.Game/Overlays/Settings/SettingsItem.cs
@@ -107,7 +107,7 @@ namespace osu.Game.Overlays.Settings
                     LabelText.ToString()
                 };
 
-                if (hasClassicDefault)
+                if (HasClassicDefault)
                     keywords.Add(CLASSIC_DEFAULT_SEARCH_TERM);
 
                 return keywords;
@@ -139,7 +139,8 @@ namespace osu.Game.Overlays.Settings
         public event Action SettingChanged;
 
         private T classicDefault;
-        private bool hasClassicDefault;
+
+        public bool HasClassicDefault { get; private set; }
 
         /// <summary>
         /// A "classic" default value for this setting.
@@ -149,21 +150,20 @@ namespace osu.Game.Overlays.Settings
             set
             {
                 classicDefault = value;
-                hasClassicDefault = true;
+                HasClassicDefault = true;
             }
         }
 
-        public void ApplyClassicDefault(bool useClassicDefault)
+        public void ApplyClassicDefault()
         {
-            if (!hasClassicDefault)
-                return;
+            if (!HasClassicDefault)
+                throw new InvalidOperationException($"Cannot apply a classic default to a setting which doesn't have one defined via {nameof(ClassicDefault)}.");
 
-            if (useClassicDefault)
-                Current.Value = classicDefault;
-            else
-                Current.SetDefault();
+            Current.Value = classicDefault;
         }
 
+        public void ApplyDefault() => Current.SetDefault();
+
         protected SettingsItem()
         {
             RelativeSizeAxes = Axes.X;

From 0354dd5ce623830c0061e5414f59ba0372fe270e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 27 Apr 2022 16:02:39 +0900
Subject: [PATCH 4333/5547] Add comment regarding section initialisation in
 `ScreenBehaviour`

---
 osu.Game/Overlays/FirstRunSetup/ScreenBehaviour.cs | 2 ++
 osu.Game/Overlays/SettingsOverlay.cs               | 1 +
 2 files changed, 3 insertions(+)

diff --git a/osu.Game/Overlays/FirstRunSetup/ScreenBehaviour.cs b/osu.Game/Overlays/FirstRunSetup/ScreenBehaviour.cs
index 1316d14302..db7659e87a 100644
--- a/osu.Game/Overlays/FirstRunSetup/ScreenBehaviour.cs
+++ b/osu.Game/Overlays/FirstRunSetup/ScreenBehaviour.cs
@@ -74,8 +74,10 @@ namespace osu.Game.Overlays.FirstRunSetup
                     AutoSizeAxes = Axes.Y,
                     Children = new SettingsSection[]
                     {
+                        // This list should be kept in sync with SettingsOverlay.
                         new GeneralSection(),
                         new SkinSection(),
+                        // InputSection is intentionally omitted for now due to its sub-panel being a pain to set up.
                         new UserInterfaceSection(),
                         new GameplaySection(),
                         new RulesetSection(),
diff --git a/osu.Game/Overlays/SettingsOverlay.cs b/osu.Game/Overlays/SettingsOverlay.cs
index c84cba8189..7cd8fc6d66 100644
--- a/osu.Game/Overlays/SettingsOverlay.cs
+++ b/osu.Game/Overlays/SettingsOverlay.cs
@@ -23,6 +23,7 @@ namespace osu.Game.Overlays
 
         protected override IEnumerable<SettingsSection> CreateSections() => new SettingsSection[]
         {
+            // This list should be kept in sync with ScreenBehaviour.
             new GeneralSection(),
             new SkinSection(),
             new InputSection(createSubPanel(new KeyBindingPanel())),

From b29af28028a172ed3ad756f5272a2286eecd833c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 27 Apr 2022 16:55:15 +0900
Subject: [PATCH 4334/5547] Fix mod panels not ignoring super key presses

Most other usages have this included. Noticed that the panel was
changing state when exiting the game using cmd-w.

Would probably be nice to have an exposed `HasAnyModifierPressed` helper
property.
---
 osu.Game/Overlays/Mods/ModColumn.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/Mods/ModColumn.cs b/osu.Game/Overlays/Mods/ModColumn.cs
index 1157c0c0c6..6a2c2adcba 100644
--- a/osu.Game/Overlays/Mods/ModColumn.cs
+++ b/osu.Game/Overlays/Mods/ModColumn.cs
@@ -441,7 +441,7 @@ namespace osu.Game.Overlays.Mods
 
         protected override bool OnKeyDown(KeyDownEvent e)
         {
-            if (e.ControlPressed || e.AltPressed) return false;
+            if (e.ControlPressed || e.AltPressed || e.SuperPressed) return false;
             if (toggleKeys == null) return false;
 
             int index = Array.IndexOf(toggleKeys, e.Key);

From 1a345c06c6c92c20593bb1f413e267498e2f2bfa Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 27 Apr 2022 17:10:27 +0900
Subject: [PATCH 4335/5547] Fix regression in nested scroll behaviour due to
 the top level scroll container's type changing

---
 osu.Game/Overlays/Mods/ModSelectScreen.cs               | 4 ++--
 osu.Game/Overlays/Mods/NestedVerticalScrollContainer.cs | 4 ++--
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Overlays/Mods/ModSelectScreen.cs b/osu.Game/Overlays/Mods/ModSelectScreen.cs
index e28b46436c..a47a399a23 100644
--- a/osu.Game/Overlays/Mods/ModSelectScreen.cs
+++ b/osu.Game/Overlays/Mods/ModSelectScreen.cs
@@ -320,7 +320,7 @@ namespace osu.Game.Overlays.Mods
             }
         }
 
-        private class ColumnScrollContainer : OsuScrollContainer<ColumnFlowContainer>
+        internal class ColumnScrollContainer : OsuScrollContainer<ColumnFlowContainer>
         {
             public ColumnScrollContainer()
                 : base(Direction.Horizontal)
@@ -358,7 +358,7 @@ namespace osu.Game.Overlays.Mods
             }
         }
 
-        private class ColumnFlowContainer : FillFlowContainer<ColumnDimContainer>
+        internal class ColumnFlowContainer : FillFlowContainer<ColumnDimContainer>
         {
             public IEnumerable<ModColumn> Columns => Children.Select(dimWrapper => dimWrapper.Column);
 
diff --git a/osu.Game/Overlays/Mods/NestedVerticalScrollContainer.cs b/osu.Game/Overlays/Mods/NestedVerticalScrollContainer.cs
index aba47d5423..d27f97f3d2 100644
--- a/osu.Game/Overlays/Mods/NestedVerticalScrollContainer.cs
+++ b/osu.Game/Overlays/Mods/NestedVerticalScrollContainer.cs
@@ -14,13 +14,13 @@ namespace osu.Game.Overlays.Mods
     /// </summary>
     public class NestedVerticalScrollContainer : OsuScrollContainer
     {
-        private OsuScrollContainer? parentScrollContainer;
+        private ModSelectScreen.ColumnScrollContainer? parentScrollContainer;
 
         protected override void LoadComplete()
         {
             base.LoadComplete();
 
-            parentScrollContainer = this.FindClosestParent<OsuScrollContainer>();
+            parentScrollContainer = this.FindClosestParent<ModSelectScreen.ColumnScrollContainer>();
         }
 
         protected override bool OnScroll(ScrollEvent e)

From 7a23363d74ceed68fe84731c84f38e286d0d6f8c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 27 Apr 2022 18:10:58 +0900
Subject: [PATCH 4336/5547] Add migration of song progress setting from config
 to component

---
 osu.Game/Configuration/OsuConfigManager.cs |  4 ++
 osu.Game/Screens/Play/SongProgress.cs      | 56 ++++++++++++++++++++--
 2 files changed, 55 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Configuration/OsuConfigManager.cs b/osu.Game/Configuration/OsuConfigManager.cs
index bee4f914ce..64e77384a2 100644
--- a/osu.Game/Configuration/OsuConfigManager.cs
+++ b/osu.Game/Configuration/OsuConfigManager.cs
@@ -116,6 +116,7 @@ namespace osu.Game.Configuration
             SetDefault(OsuSetting.HitLighting, true);
 
             SetDefault(OsuSetting.HUDVisibilityMode, HUDVisibilityMode.Always);
+            SetDefault(OsuSetting.ShowProgressGraph, true);
             SetDefault(OsuSetting.ShowHealthDisplayWhenCantFail, true);
             SetDefault(OsuSetting.FadePlayfieldWhenHealthLow, true);
             SetDefault(OsuSetting.KeyOverlay, false);
@@ -274,6 +275,9 @@ namespace osu.Game.Configuration
         AlwaysPlayFirstComboBreak,
         FloatingComments,
         HUDVisibilityMode,
+
+        // This has been migrated to the component itself. can be removed 20221027.
+        ShowProgressGraph,
         ShowHealthDisplayWhenCantFail,
         FadePlayfieldWhenHealthLow,
         MouseDisableButtons,
diff --git a/osu.Game/Screens/Play/SongProgress.cs b/osu.Game/Screens/Play/SongProgress.cs
index 9470c60fe6..592071b02e 100644
--- a/osu.Game/Screens/Play/SongProgress.cs
+++ b/osu.Game/Screens/Play/SongProgress.cs
@@ -1,20 +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 osuTK;
-using osu.Framework.Graphics;
-using osu.Framework.Graphics.Containers;
 using System;
 using System.Collections.Generic;
-using osu.Game.Graphics;
-using osu.Framework.Allocation;
 using System.Linq;
+using osu.Framework.Allocation;
 using osu.Framework.Bindables;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
 using osu.Framework.Timing;
 using osu.Game.Configuration;
+using osu.Game.Graphics;
 using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.UI;
 using osu.Game.Skinning;
+using osuTK;
 
 namespace osu.Game.Screens.Play
 {
@@ -139,6 +139,52 @@ namespace osu.Game.Screens.Play
 
             AllowSeeking.BindValueChanged(_ => updateBarVisibility(), true);
             ShowGraph.BindValueChanged(_ => updateGraphVisibility(), true);
+
+            migrateSettingFromConfig();
+        }
+
+        [Resolved]
+        private OsuConfigManager config { get; set; }
+
+        [Resolved]
+        private SkinManager skinManager { get; set; }
+
+        /// <summary>
+        /// This setting has been migrated to a per-component level.
+        /// Only take the value from the config if it is in a non-default state (then reset it to default so it only applies once).
+        ///
+        /// Can be removed 20221027.
+        /// </summary>
+        private void migrateSettingFromConfig()
+        {
+            Bindable<bool> configShowGraph = config.GetBindable<bool>(OsuSetting.ShowProgressGraph);
+
+            if (!configShowGraph.IsDefault)
+            {
+                ShowGraph.Value = configShowGraph.Value;
+                configShowGraph.SetDefault();
+
+                // This is pretty ugly, but the only way to make this stick...
+                if (skinManager != null)
+                {
+                    var skinnableTarget = this.FindClosestParent<ISkinnableTarget>();
+
+                    if (skinnableTarget != null)
+                    {
+                        skinManager.EnsureMutableSkin();
+
+                        // If `EnsureMutableSkin` actually changed the skin, default layout may take a frame to apply.
+                        // See `SkinnableTargetComponentsContainer`'s use of ScheduleAfterChildren.
+                        ScheduleAfterChildren(() =>
+                        {
+                            var skin = skinManager.CurrentSkin.Value;
+                            skin.UpdateDrawableTarget(skinnableTarget);
+
+                            skinManager.Save(skin);
+                        });
+                    }
+                }
+            }
         }
 
         protected override void PopIn()

From 20a50ddb6e0639adc5980a4e2c6c85ad2c4d13aa Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 27 Apr 2022 18:45:40 +0900
Subject: [PATCH 4337/5547] Add missing `OverlayColourProvider` in test scene

---
 .../Visual/UserInterface/TestSceneFirstRunScreenUIScale.cs   | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunScreenUIScale.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunScreenUIScale.cs
index 5ca09b34aa..64ad4ff119 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunScreenUIScale.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunScreenUIScale.cs
@@ -1,13 +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 osu.Framework.Allocation;
 using osu.Framework.Screens;
+using osu.Game.Overlays;
 using osu.Game.Overlays.FirstRunSetup;
 
 namespace osu.Game.Tests.Visual.UserInterface
 {
     public class TestSceneFirstRunScreenUIScale : OsuManualInputManagerTestScene
     {
+        [Cached]
+        private OverlayColourProvider colourProvider = new OverlayColourProvider(OverlayColourScheme.Purple);
+
         public TestSceneFirstRunScreenUIScale()
         {
             AddStep("load screen", () =>

From e9ec406046033632a19d062e6b4cd7ae2bd86514 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 27 Apr 2022 19:20:08 +0900
Subject: [PATCH 4338/5547] Remove weird code

---
 osu.Game/Beatmaps/Drawables/DownloadProgressBar.cs | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/osu.Game/Beatmaps/Drawables/DownloadProgressBar.cs b/osu.Game/Beatmaps/Drawables/DownloadProgressBar.cs
index 54dcdc55e3..ad0ff876e8 100644
--- a/osu.Game/Beatmaps/Drawables/DownloadProgressBar.cs
+++ b/osu.Game/Beatmaps/Drawables/DownloadProgressBar.cs
@@ -28,11 +28,6 @@ namespace osu.Game.Beatmaps.Drawables
                 },
                 downloadTracker = new BeatmapDownloadTracker(beatmapSet),
             };
-            AddInternal(progressBar = new ProgressBar(false)
-            {
-                Height = 0,
-                Alpha = 0,
-            });
 
             AutoSizeAxes = Axes.Y;
             RelativeSizeAxes = Axes.X;

From 66c730c382cdd9ab74f74053e043b385e17586a6 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 27 Apr 2022 17:11:23 +0300
Subject: [PATCH 4339/5547] Change distance spacing keybind to Ctrl+Alt

---
 osu.Game.Rulesets.Osu/Edit/OsuToolboxComposite.cs           | 5 ++---
 osu.Game.Tests/Visual/Editing/TestSceneHitObjectComposer.cs | 4 ++--
 2 files changed, 4 insertions(+), 5 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Edit/OsuToolboxComposite.cs b/osu.Game.Rulesets.Osu/Edit/OsuToolboxComposite.cs
index 542f98207e..17232db509 100644
--- a/osu.Game.Rulesets.Osu/Edit/OsuToolboxComposite.cs
+++ b/osu.Game.Rulesets.Osu/Edit/OsuToolboxComposite.cs
@@ -12,7 +12,6 @@ using osu.Game.Overlays.Settings.Sections;
 using osu.Game.Rulesets.Edit;
 using osu.Game.Screens.Edit;
 using osuTK;
-using osuTK.Input;
 
 namespace osu.Game.Rulesets.Osu.Edit
 {
@@ -74,7 +73,7 @@ namespace osu.Game.Rulesets.Osu.Edit
 
         protected override bool OnKeyDown(KeyDownEvent e)
         {
-            if (e.AltPressed && e.Key == Key.D && !e.Repeat)
+            if (e.ControlPressed && e.AltPressed && !e.Repeat)
             {
                 expandingContainer.Expanded.Value = true;
                 distanceSpacingScrollActive = true;
@@ -86,7 +85,7 @@ namespace osu.Game.Rulesets.Osu.Edit
 
         protected override void OnKeyUp(KeyUpEvent e)
         {
-            if (distanceSpacingScrollActive && (!e.AltPressed || e.Key == Key.D))
+            if (distanceSpacingScrollActive && (!e.AltPressed || !e.ControlPressed))
             {
                 expandingContainer.Expanded.Value = false;
                 distanceSpacingScrollActive = false;
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneHitObjectComposer.cs b/osu.Game.Tests/Visual/Editing/TestSceneHitObjectComposer.cs
index d542732e19..7039d7d8a4 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneHitObjectComposer.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneHitObjectComposer.cs
@@ -95,14 +95,14 @@ namespace osu.Game.Tests.Visual.Editing
 
             AddStep("retrieve original spacing", () => originalSpacing = (float)editorBeatmap.BeatmapInfo.DistanceSpacing);
 
+            AddStep("hold ctrl", () => InputManager.PressKey(Key.LControl));
             AddStep("hold alt", () => InputManager.PressKey(Key.LAlt));
-            AddStep("hold D", () => InputManager.PressKey(Key.D));
 
             AddStep("scroll mouse 5 steps", () => InputManager.ScrollVerticalBy(5));
             AddAssert("distance spacing increased by 0.5", () => Precision.AlmostEquals(editorBeatmap.BeatmapInfo.DistanceSpacing, originalSpacing + 0.5f));
 
             AddStep("release alt", () => InputManager.ReleaseKey(Key.LAlt));
-            AddStep("release D", () => InputManager.ReleaseKey(Key.D));
+            AddStep("release ctrl", () => InputManager.ReleaseKey(Key.LControl));
         }
 
         public class EditorBeatmapContainer : Container

From 59cf3ff50fad705e477d8b00c6fcfed55550e387 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 28 Apr 2022 05:48:45 +0300
Subject: [PATCH 4340/5547] Move distancing methods from
 `IPositionSnapProvider` to `IDistanceSnapProvider`

---
 .../Editor/TestSceneManiaBeatSnapGrid.cs      | 26 -----------
 .../Components/PathControlPointVisualiser.cs  |  2 +-
 .../Sliders/SliderPlacementBlueprint.cs       |  4 +-
 .../Sliders/SliderSelectionBlueprint.cs       |  6 +--
 .../Edit/OsuSelectionHandler.cs               |  6 +--
 .../Rulesets/Edit/IDistanceSnapProvider.cs    | 41 ++++++++++++++++++
 .../Rulesets/Edit/IPositionSnapProvider.cs    | 43 -------------------
 .../Rulesets/Objects/SliderPathExtensions.cs  |  2 +-
 .../Compose/Components/Timeline/Timeline.cs   | 13 ------
 9 files changed, 51 insertions(+), 92 deletions(-)

diff --git a/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneManiaBeatSnapGrid.cs b/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneManiaBeatSnapGrid.cs
index 50be13c4e0..2e55f86bb6 100644
--- a/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneManiaBeatSnapGrid.cs
+++ b/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneManiaBeatSnapGrid.cs
@@ -13,7 +13,6 @@ using osu.Game.Rulesets.Edit;
 using osu.Game.Rulesets.Mania.Beatmaps;
 using osu.Game.Rulesets.Mania.Edit;
 using osu.Game.Rulesets.Mania.UI;
-using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Objects.Drawables;
 using osu.Game.Rulesets.UI;
 using osu.Game.Rulesets.UI.Scrolling;
@@ -107,30 +106,5 @@ namespace osu.Game.Rulesets.Mania.Tests.Editor
         {
             throw new System.NotImplementedException();
         }
-
-        public override float GetBeatSnapDistanceAt(HitObject referenceObject)
-        {
-            throw new System.NotImplementedException();
-        }
-
-        public override float DurationToDistance(HitObject referenceObject, double duration)
-        {
-            throw new System.NotImplementedException();
-        }
-
-        public override double DistanceToDuration(HitObject referenceObject, float distance)
-        {
-            throw new System.NotImplementedException();
-        }
-
-        public override double GetSnappedDurationFromDistance(HitObject referenceObject, float distance)
-        {
-            throw new System.NotImplementedException();
-        }
-
-        public override float GetSnappedDistanceFromDistance(HitObject referenceObject, float distance)
-        {
-            throw new System.NotImplementedException();
-        }
     }
 }
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 ae4141073e..5de614722f 100644
--- a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointVisualiser.cs
+++ b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointVisualiser.cs
@@ -43,7 +43,7 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders.Components
         public Action<List<PathControlPoint>> RemoveControlPointsRequested;
 
         [Resolved(CanBeNull = true)]
-        private IPositionSnapProvider snapProvider { get; set; }
+        private IDistanceSnapProvider snapProvider { get; set; }
 
         public PathControlPointVisualiser(Slider slider, bool allowSelection)
         {
diff --git a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/SliderPlacementBlueprint.cs b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/SliderPlacementBlueprint.cs
index b868c9a7ee..73a4ea5434 100644
--- a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/SliderPlacementBlueprint.cs
+++ b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/SliderPlacementBlueprint.cs
@@ -37,7 +37,7 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders
         private int currentSegmentLength;
 
         [Resolved(CanBeNull = true)]
-        private HitObjectComposer composer { get; set; }
+        private IDistanceSnapProvider snapProvider { get; set; }
 
         public SliderPlacementBlueprint()
             : base(new Objects.Slider())
@@ -220,7 +220,7 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders
 
         private void updateSlider()
         {
-            HitObject.Path.ExpectedDistance.Value = composer?.GetSnappedDistanceFromDistance(HitObject, (float)HitObject.Path.CalculatedDistance) ?? (float)HitObject.Path.CalculatedDistance;
+            HitObject.Path.ExpectedDistance.Value = snapProvider?.GetSnappedDistanceFromDistance(HitObject, (float)HitObject.Path.CalculatedDistance) ?? (float)HitObject.Path.CalculatedDistance;
 
             bodyPiece.UpdateFrom(HitObject);
             headCirclePiece.UpdateFrom(HitObject.HeadCircle);
diff --git a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/SliderSelectionBlueprint.cs b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/SliderSelectionBlueprint.cs
index 6cf2a493a9..a019f2fb64 100644
--- a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/SliderSelectionBlueprint.cs
+++ b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/SliderSelectionBlueprint.cs
@@ -38,7 +38,7 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders
         protected PathControlPointVisualiser ControlPointVisualiser { get; private set; }
 
         [Resolved(CanBeNull = true)]
-        private HitObjectComposer composer { get; set; }
+        private IDistanceSnapProvider snapProvider { get; set; }
 
         [Resolved(CanBeNull = true)]
         private IPlacementHandler placementHandler { get; set; }
@@ -208,7 +208,7 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders
             // Move the control points from the insertion index onwards to make room for the insertion
             controlPoints.Insert(insertionIndex, pathControlPoint);
 
-            HitObject.SnapTo(composer);
+            HitObject.SnapTo(snapProvider);
 
             return pathControlPoint;
         }
@@ -230,7 +230,7 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders
             }
 
             // Snap the slider to the current beat divisor before checking length validity.
-            HitObject.SnapTo(composer);
+            HitObject.SnapTo(snapProvider);
 
             // If there are 0 or 1 remaining control points, or the slider has an invalid length, it is in a degenerate form and should be deleted
             if (controlPoints.Count <= 1 || !HitObject.Path.HasValidLength)
diff --git a/osu.Game.Rulesets.Osu/Edit/OsuSelectionHandler.cs b/osu.Game.Rulesets.Osu/Edit/OsuSelectionHandler.cs
index efbac5439c..70c60ab635 100644
--- a/osu.Game.Rulesets.Osu/Edit/OsuSelectionHandler.cs
+++ b/osu.Game.Rulesets.Osu/Edit/OsuSelectionHandler.cs
@@ -23,7 +23,7 @@ namespace osu.Game.Rulesets.Osu.Edit
     public class OsuSelectionHandler : EditorSelectionHandler
     {
         [Resolved(CanBeNull = true)]
-        private IPositionSnapProvider? positionSnapProvider { get; set; }
+        private IDistanceSnapProvider? snapProvider { get; set; }
 
         /// <summary>
         /// During a transform, the initial origin is stored so it can be used throughout the operation.
@@ -206,7 +206,7 @@ namespace osu.Game.Rulesets.Osu.Edit
 
             // Snap the slider's length to the current beat divisor
             // to calculate the final resulting duration / bounding box before the final checks.
-            slider.SnapTo(positionSnapProvider);
+            slider.SnapTo(snapProvider);
 
             //if sliderhead or sliderend end up outside playfield, revert scaling.
             Quad scaledQuad = getSurroundingQuad(new OsuHitObject[] { slider });
@@ -219,7 +219,7 @@ namespace osu.Game.Rulesets.Osu.Edit
                 point.Position = oldControlPoints.Dequeue();
 
             // Snap the slider's length again to undo the potentially-invalid length applied by the previous snap.
-            slider.SnapTo(positionSnapProvider);
+            slider.SnapTo(snapProvider);
         }
 
         private void scaleHitObjects(OsuHitObject[] hitObjects, Anchor reference, Vector2 scale)
diff --git a/osu.Game/Rulesets/Edit/IDistanceSnapProvider.cs b/osu.Game/Rulesets/Edit/IDistanceSnapProvider.cs
index 70921a6170..c6e866561e 100644
--- a/osu.Game/Rulesets/Edit/IDistanceSnapProvider.cs
+++ b/osu.Game/Rulesets/Edit/IDistanceSnapProvider.cs
@@ -3,6 +3,7 @@
 
 using osu.Framework.Bindables;
 using osu.Game.Beatmaps;
+using osu.Game.Rulesets.Objects;
 
 namespace osu.Game.Rulesets.Edit
 {
@@ -13,5 +14,45 @@ namespace osu.Game.Rulesets.Edit
         /// </summary>
         /// <seealso cref="BeatmapInfo.DistanceSpacing"/>
         IBindable<double> DistanceSpacingMultiplier { get; }
+
+        /// <summary>
+        /// Retrieves the distance between two points within a timing point that are one beat length apart.
+        /// </summary>
+        /// <param name="referenceObject">An object to be used as a reference point for this operation.</param>
+        /// <returns>The distance between two points residing in the timing point that are one beat length apart.</returns>
+        float GetBeatSnapDistanceAt(HitObject referenceObject);
+
+        /// <summary>
+        /// Converts a duration to a distance.
+        /// </summary>
+        /// <param name="referenceObject">An object to be used as a reference point for this operation.</param>
+        /// <param name="duration">The duration to convert.</param>
+        /// <returns>A value that represents <paramref name="duration"/> as a distance in the timing point.</returns>
+        float DurationToDistance(HitObject referenceObject, double duration);
+
+        /// <summary>
+        /// Converts a distance to a duration.
+        /// </summary>
+        /// <param name="referenceObject">An object to be used as a reference point for this operation.</param>
+        /// <param name="distance">The distance to convert.</param>
+        /// <returns>A value that represents <paramref name="distance"/> as a duration in the timing point.</returns>
+        double DistanceToDuration(HitObject referenceObject, float distance);
+
+        /// <summary>
+        /// Converts a distance to a snapped duration.
+        /// </summary>
+        /// <param name="referenceObject">An object to be used as a reference point for this operation.</param>
+        /// <param name="distance">The distance to convert.</param>
+        /// <returns>A value that represents <paramref name="distance"/> as a duration snapped to the closest beat of the timing point.</returns>
+        double GetSnappedDurationFromDistance(HitObject referenceObject, float distance);
+
+        /// <summary>
+        /// Converts an unsnapped distance to a snapped distance.
+        /// The returned distance will always be floored (as to never exceed the provided <paramref name="distance"/>.
+        /// </summary>
+        /// <param name="referenceObject">An object to be used as a reference point for this operation.</param>
+        /// <param name="distance">The distance to convert.</param>
+        /// <returns>A value that represents <paramref name="distance"/> snapped to the closest beat of the timing point.</returns>
+        float GetSnappedDistanceFromDistance(HitObject referenceObject, float distance);
     }
 }
diff --git a/osu.Game/Rulesets/Edit/IPositionSnapProvider.cs b/osu.Game/Rulesets/Edit/IPositionSnapProvider.cs
index 944619a3ca..8a179ed424 100644
--- a/osu.Game/Rulesets/Edit/IPositionSnapProvider.cs
+++ b/osu.Game/Rulesets/Edit/IPositionSnapProvider.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.Game.Rulesets.Objects;
 using osuTK;
 
 namespace osu.Game.Rulesets.Edit
@@ -24,47 +23,5 @@ namespace osu.Game.Rulesets.Edit
         /// <param name="screenSpacePosition">The screen-space position to be snapped.</param>
         /// <returns>The position post-snapping. Time will always be null.</returns>
         SnapResult SnapScreenSpacePositionToValidPosition(Vector2 screenSpacePosition);
-
-        /// <summary>
-        /// Retrieves the distance between two points within a timing point that are one beat length apart.
-        /// </summary>
-        /// <param name="referenceObject">An object to be used as a reference point for this operation.</param>
-        /// <returns>The distance between two points residing in the timing point that are one beat length apart.</returns>
-        // todo: this, and other distance-related methods below it, should move to IDistanceSnapProvider.
-        // needs thought on how to properly share implementation, since not all composers inherit IDistanceSnapProvider.
-        float GetBeatSnapDistanceAt(HitObject referenceObject);
-
-        /// <summary>
-        /// Converts a duration to a distance.
-        /// </summary>
-        /// <param name="referenceObject">An object to be used as a reference point for this operation.</param>
-        /// <param name="duration">The duration to convert.</param>
-        /// <returns>A value that represents <paramref name="duration"/> as a distance in the timing point.</returns>
-        float DurationToDistance(HitObject referenceObject, double duration);
-
-        /// <summary>
-        /// Converts a distance to a duration.
-        /// </summary>
-        /// <param name="referenceObject">An object to be used as a reference point for this operation.</param>
-        /// <param name="distance">The distance to convert.</param>
-        /// <returns>A value that represents <paramref name="distance"/> as a duration in the timing point.</returns>
-        double DistanceToDuration(HitObject referenceObject, float distance);
-
-        /// <summary>
-        /// Converts a distance to a snapped duration.
-        /// </summary>
-        /// <param name="referenceObject">An object to be used as a reference point for this operation.</param>
-        /// <param name="distance">The distance to convert.</param>
-        /// <returns>A value that represents <paramref name="distance"/> as a duration snapped to the closest beat of the timing point.</returns>
-        double GetSnappedDurationFromDistance(HitObject referenceObject, float distance);
-
-        /// <summary>
-        /// Converts an unsnapped distance to a snapped distance.
-        /// The returned distance will always be floored (as to never exceed the provided <paramref name="distance"/>.
-        /// </summary>
-        /// <param name="referenceObject">An object to be used as a reference point for this operation.</param>
-        /// <param name="distance">The distance to convert.</param>
-        /// <returns>A value that represents <paramref name="distance"/> snapped to the closest beat of the timing point.</returns>
-        float GetSnappedDistanceFromDistance(HitObject referenceObject, float distance);
     }
 }
diff --git a/osu.Game/Rulesets/Objects/SliderPathExtensions.cs b/osu.Game/Rulesets/Objects/SliderPathExtensions.cs
index ba614900c0..3100d26a55 100644
--- a/osu.Game/Rulesets/Objects/SliderPathExtensions.cs
+++ b/osu.Game/Rulesets/Objects/SliderPathExtensions.cs
@@ -15,7 +15,7 @@ namespace osu.Game.Rulesets.Objects
         /// <summary>
         /// Snaps the provided <paramref name="hitObject"/>'s duration using the <paramref name="snapProvider"/>.
         /// </summary>
-        public static void SnapTo<THitObject>(this THitObject hitObject, IPositionSnapProvider? snapProvider)
+        public static void SnapTo<THitObject>(this THitObject hitObject, IDistanceSnapProvider? snapProvider)
             where THitObject : HitObject, IHasPath
         {
             hitObject.Path.ExpectedDistance.Value = snapProvider?.GetSnappedDistanceFromDistance(hitObject, (float)hitObject.Path.CalculatedDistance) ?? hitObject.Path.CalculatedDistance;
diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/Timeline.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/Timeline.cs
index 8832c4e89c..c2b2bdb861 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/Timeline.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/Timeline.cs
@@ -15,7 +15,6 @@ using osu.Game.Beatmaps;
 using osu.Game.Configuration;
 using osu.Game.Graphics;
 using osu.Game.Rulesets.Edit;
-using osu.Game.Rulesets.Objects;
 using osuTK;
 
 namespace osu.Game.Screens.Edit.Compose.Components.Timeline
@@ -316,17 +315,5 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
 
         private double getTimeFromPosition(Vector2 localPosition) =>
             (localPosition.X / Content.DrawWidth) * track.Length;
-
-        public IBindable<double> DistanceSpacingMultiplier => throw new NotImplementedException();
-
-        public float GetBeatSnapDistanceAt(HitObject referenceObject) => throw new NotImplementedException();
-
-        public float DurationToDistance(HitObject referenceObject, double duration) => throw new NotImplementedException();
-
-        public double DistanceToDuration(HitObject referenceObject, float distance) => throw new NotImplementedException();
-
-        public double GetSnappedDurationFromDistance(HitObject referenceObject, float distance) => throw new NotImplementedException();
-
-        public float GetSnappedDistanceFromDistance(HitObject referenceObject, float distance) => throw new NotImplementedException();
     }
 }

From d6395b14beae1116a3b7271363136c89642a1b98 Mon Sep 17 00:00:00 2001
From: Pasi4K5 <pascal.pomper03@gmail.com>
Date: Thu, 28 Apr 2022 05:15:04 +0200
Subject: [PATCH 4341/5547] Add incompatibilities

---
 osu.Game.Rulesets.Osu/Mods/OsuModClassic.cs        |  2 +-
 osu.Game.Rulesets.Osu/Mods/OsuModRandom.cs         |  2 ++
 osu.Game.Rulesets.Osu/Mods/OsuModSpunOut.cs        |  2 +-
 osu.Game.Rulesets.Osu/Mods/OsuModStrictTracking.cs |  2 +-
 osu.Game.Rulesets.Osu/Mods/OsuModTarget.cs         | 10 +++++++++-
 5 files changed, 14 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModClassic.cs b/osu.Game.Rulesets.Osu/Mods/OsuModClassic.cs
index f46573c494..5d262cd95e 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModClassic.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModClassic.cs
@@ -17,7 +17,7 @@ namespace osu.Game.Rulesets.Osu.Mods
 {
     public class OsuModClassic : ModClassic, IApplicableToHitObject, IApplicableToDrawableHitObject, IApplicableToDrawableRuleset<OsuHitObject>
     {
-        public override Type[] IncompatibleMods => new[] { typeof(OsuModStrictTracking) };
+        public override Type[] IncompatibleMods => new[] { typeof(OsuModStrictTracking), typeof(OsuModTarget) };
 
         [SettingSource("No slider head accuracy requirement", "Scores sliders proportionally to the number of ticks hit.")]
         public Bindable<bool> NoSliderHeadAccuracy { get; } = new BindableBool(true);
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModRandom.cs b/osu.Game.Rulesets.Osu/Mods/OsuModRandom.cs
index fea9246035..7a7e189c29 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModRandom.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModRandom.cs
@@ -22,6 +22,8 @@ namespace osu.Game.Rulesets.Osu.Mods
     {
         public override string Description => "It never gets boring!";
 
+        public override Type[] IncompatibleMods => new[] { typeof(OsuModTarget) };
+
         private static readonly float playfield_diagonal = OsuPlayfield.BASE_SIZE.LengthFast;
 
         private Random? rng;
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModSpunOut.cs b/osu.Game.Rulesets.Osu/Mods/OsuModSpunOut.cs
index 9be0dc748a..d9ab749ad3 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModSpunOut.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModSpunOut.cs
@@ -20,7 +20,7 @@ namespace osu.Game.Rulesets.Osu.Mods
         public override ModType Type => ModType.Automation;
         public override string Description => @"Spinners will be automatically completed.";
         public override double ScoreMultiplier => 0.9;
-        public override Type[] IncompatibleMods => new[] { typeof(ModAutoplay), typeof(OsuModAutopilot) };
+        public override Type[] IncompatibleMods => new[] { typeof(ModAutoplay), typeof(OsuModAutopilot), typeof(OsuModTarget) };
 
         public void ApplyToDrawableHitObject(DrawableHitObject hitObject)
         {
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModStrictTracking.cs b/osu.Game.Rulesets.Osu/Mods/OsuModStrictTracking.cs
index ee325db66a..ab45e5192d 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModStrictTracking.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModStrictTracking.cs
@@ -27,7 +27,7 @@ namespace osu.Game.Rulesets.Osu.Mods
         public override ModType Type => ModType.DifficultyIncrease;
         public override string Description => @"Follow circles just got serious...";
         public override double ScoreMultiplier => 1.0;
-        public override Type[] IncompatibleMods => new[] { typeof(ModClassic) };
+        public override Type[] IncompatibleMods => new[] { typeof(ModClassic), typeof(OsuModTarget) };
 
         public void ApplyToDrawableHitObject(DrawableHitObject drawable)
         {
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModTarget.cs b/osu.Game.Rulesets.Osu/Mods/OsuModTarget.cs
index 4fab9b6a5a..4d6c09f919 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModTarget.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModTarget.cs
@@ -42,7 +42,15 @@ namespace osu.Game.Rulesets.Osu.Mods
         public override string Description => @"Practice keeping up with the beat of the song.";
         public override double ScoreMultiplier => 1;
 
-        public override Type[] IncompatibleMods => new[] { typeof(IRequiresApproachCircles), typeof(OsuModSuddenDeath) };
+        public override Type[] IncompatibleMods => new[]
+        {
+            typeof(IRequiresApproachCircles),
+            typeof(OsuModClassic),
+            typeof(OsuModRandom),
+            typeof(OsuModSpunOut),
+            typeof(OsuModStrictTracking),
+            typeof(OsuModSuddenDeath)
+        };
 
         [SettingSource("Seed", "Use a custom seed instead of a random one", SettingControlType = typeof(SettingsNumberBox))]
         public Bindable<int?> Seed { get; } = new Bindable<int?>

From 835898dd30ae70170a6670178d19397d7a057361 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 28 Apr 2022 05:49:37 +0300
Subject: [PATCH 4342/5547] Introduce `DistancedHitObjectComposer` and
 supersede `OsuToolboxComposite`

---
 .../Editor/TestSceneObjectObjectSnap.cs       |   4 +-
 .../Editor/TestSceneSliderSnapping.cs         |   3 +-
 .../Edit/OsuHitObjectComposer.cs              |  12 +-
 .../Edit/OsuToolboxComposite.cs               | 120 -------------
 .../Edit/DistancedHitObjectComposer.cs        | 158 ++++++++++++++++++
 osu.Game/Rulesets/Edit/HitObjectComposer.cs   |  48 ------
 6 files changed, 163 insertions(+), 182 deletions(-)
 delete mode 100644 osu.Game.Rulesets.Osu/Edit/OsuToolboxComposite.cs
 create mode 100644 osu.Game/Rulesets/Edit/DistancedHitObjectComposer.cs

diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneObjectObjectSnap.cs b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneObjectObjectSnap.cs
index 954bb53dd5..dfb6ecfcae 100644
--- a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneObjectObjectSnap.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneObjectObjectSnap.cs
@@ -7,7 +7,7 @@ using osu.Framework.Bindables;
 using osu.Framework.Testing;
 using osu.Framework.Utils;
 using osu.Game.Beatmaps;
-using osu.Game.Rulesets.Osu.Edit;
+using osu.Game.Rulesets.Edit;
 using osu.Game.Rulesets.Osu.Objects;
 using osu.Game.Rulesets.Osu.UI;
 using osu.Game.Tests.Beatmaps;
@@ -30,7 +30,7 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
             AddStep("seek to first control point", () => EditorClock.Seek(Beatmap.Value.Beatmap.ControlPointInfo.TimingPoints.First().Time));
             AddStep("set distance spacing to 1", () =>
             {
-                var distanceSpacing = (BindableDouble)Editor.ChildrenOfType<OsuHitObjectComposer>().Single().DistanceSpacingMultiplier;
+                var distanceSpacing = (BindableDouble)Editor.ChildrenOfType<IDistanceSnapProvider>().Single().DistanceSpacingMultiplier;
                 distanceSpacing.Value = 1;
             });
         }
diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderSnapping.cs b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderSnapping.cs
index 2632e556c6..702e2216ac 100644
--- a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderSnapping.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderSnapping.cs
@@ -11,6 +11,7 @@ using osu.Framework.Utils;
 using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.ControlPoints;
 using osu.Game.Input.Bindings;
+using osu.Game.Rulesets.Edit;
 using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Osu.Edit;
 using osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders.Components;
@@ -68,7 +69,7 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
             });
             AddStep("set distance spacing to 1", () =>
             {
-                var distanceSpacing = (BindableDouble)Editor.ChildrenOfType<OsuHitObjectComposer>().Single().DistanceSpacingMultiplier;
+                var distanceSpacing = (BindableDouble)Editor.ChildrenOfType<IDistanceSnapProvider>().Single().DistanceSpacingMultiplier;
                 distanceSpacing.Value = 1;
             });
         }
diff --git a/osu.Game.Rulesets.Osu/Edit/OsuHitObjectComposer.cs b/osu.Game.Rulesets.Osu/Edit/OsuHitObjectComposer.cs
index a52c916ca0..bd26a99e51 100644
--- a/osu.Game.Rulesets.Osu/Edit/OsuHitObjectComposer.cs
+++ b/osu.Game.Rulesets.Osu/Edit/OsuHitObjectComposer.cs
@@ -24,13 +24,8 @@ using osuTK;
 
 namespace osu.Game.Rulesets.Osu.Edit
 {
-    [Cached(typeof(IDistanceSnapProvider))]
-    public class OsuHitObjectComposer : HitObjectComposer<OsuHitObject>, IDistanceSnapProvider
+    public class OsuHitObjectComposer : DistancedHitObjectComposer<OsuHitObject>
     {
-        private OsuToolboxComposite osuToolboxComposite;
-
-        public IBindable<double> DistanceSpacingMultiplier => osuToolboxComposite.DistanceSpacing;
-
         public OsuHitObjectComposer(Ruleset ruleset)
             : base(ruleset)
         {
@@ -79,8 +74,6 @@ namespace osu.Game.Rulesets.Osu.Edit
                 }
             });
 
-            AddInternal(osuToolboxComposite = new OsuToolboxComposite());
-
             selectedHitObjects = EditorBeatmap.SelectedHitObjects.GetBoundCopy();
             selectedHitObjects.CollectionChanged += (_, __) => updateDistanceSnapGrid();
 
@@ -135,9 +128,6 @@ namespace osu.Game.Rulesets.Osu.Edit
             }
         }
 
-        public override float GetBeatSnapDistanceAt(HitObject referenceObject)
-            => (float)(base.GetBeatSnapDistanceAt(referenceObject) * DistanceSpacingMultiplier.Value);
-
         public override SnapResult SnapScreenSpacePositionToValidPosition(Vector2 screenSpacePosition)
         {
             if (snapToVisibleBlueprints(screenSpacePosition, out var snapResult))
diff --git a/osu.Game.Rulesets.Osu/Edit/OsuToolboxComposite.cs b/osu.Game.Rulesets.Osu/Edit/OsuToolboxComposite.cs
deleted file mode 100644
index 17232db509..0000000000
--- a/osu.Game.Rulesets.Osu/Edit/OsuToolboxComposite.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 osu.Framework.Allocation;
-using osu.Framework.Bindables;
-using osu.Framework.Graphics;
-using osu.Framework.Graphics.Containers;
-using osu.Framework.Input.Events;
-using osu.Game.Graphics.Containers;
-using osu.Game.Graphics.UserInterface;
-using osu.Game.Overlays.Settings.Sections;
-using osu.Game.Rulesets.Edit;
-using osu.Game.Screens.Edit;
-using osuTK;
-
-namespace osu.Game.Rulesets.Osu.Edit
-{
-    /// <summary>
-    /// A toolbox composite for osu!-specific controls.
-    /// </summary>
-    // todo: once catch supports distance spacing, the control here should move out to a base "DistancingRulesetToolboxComposite" class or something better.
-    public class OsuToolboxComposite : CompositeDrawable
-    {
-        private ExpandingToolboxContainer expandingContainer;
-        private ExpandableSlider<double, SizeSlider<double>> distanceSpacingSlider;
-
-        private readonly Bindable<double> distanceSpacing = new BindableDouble(1.0)
-        {
-            MinValue = 0.1,
-            MaxValue = 6.0,
-            Precision = 0.01,
-        };
-
-        public IBindable<double> DistanceSpacing => distanceSpacing;
-
-        private bool distanceSpacingScrollActive;
-
-        [Resolved]
-        private EditorBeatmap editorBeatmap { get; set; }
-
-        [BackgroundDependencyLoader]
-        private void load()
-        {
-            RelativeSizeAxes = Axes.Both;
-
-            InternalChild = expandingContainer = new ExpandingToolboxContainer
-            {
-                Anchor = Anchor.TopRight,
-                Origin = Anchor.TopRight,
-                Child = new EditorToolboxGroup("snapping")
-                {
-                    Child = distanceSpacingSlider = new ExpandableSlider<double, SizeSlider<double>>
-                    {
-                        Current = { BindTarget = distanceSpacing },
-                        KeyboardStep = 0.1f,
-                    }
-                }
-            };
-        }
-
-        protected override void LoadComplete()
-        {
-            base.LoadComplete();
-
-            distanceSpacing.Value = editorBeatmap.BeatmapInfo.DistanceSpacing;
-            distanceSpacing.BindValueChanged(v =>
-            {
-                distanceSpacingSlider.ContractedLabelText = $"D. S. ({v.NewValue:0.##x})";
-                distanceSpacingSlider.ExpandedLabelText = $"Distance Spacing ({v.NewValue:0.##x})";
-                editorBeatmap.BeatmapInfo.DistanceSpacing = v.NewValue;
-            }, true);
-        }
-
-        protected override bool OnKeyDown(KeyDownEvent e)
-        {
-            if (e.ControlPressed && e.AltPressed && !e.Repeat)
-            {
-                expandingContainer.Expanded.Value = true;
-                distanceSpacingScrollActive = true;
-                return true;
-            }
-
-            return base.OnKeyDown(e);
-        }
-
-        protected override void OnKeyUp(KeyUpEvent e)
-        {
-            if (distanceSpacingScrollActive && (!e.AltPressed || !e.ControlPressed))
-            {
-                expandingContainer.Expanded.Value = false;
-                distanceSpacingScrollActive = false;
-            }
-        }
-
-        protected override bool OnScroll(ScrollEvent e)
-        {
-            if (distanceSpacingScrollActive)
-            {
-                distanceSpacing.Value += e.ScrollDelta.Y * (e.IsPrecise ? 0.01f : 0.1f);
-                return true;
-            }
-
-            return base.OnScroll(e);
-        }
-
-        private class ExpandingToolboxContainer : ExpandingContainer
-        {
-            protected override double HoverExpansionDelay => 250;
-
-            public ExpandingToolboxContainer()
-                : base(130, 250)
-            {
-                RelativeSizeAxes = Axes.Y;
-                Padding = new MarginPadding { Left = 10 };
-
-                FillFlow.Spacing = new Vector2(10);
-            }
-        }
-    }
-}
diff --git a/osu.Game/Rulesets/Edit/DistancedHitObjectComposer.cs b/osu.Game/Rulesets/Edit/DistancedHitObjectComposer.cs
new file mode 100644
index 0000000000..a3624f6d77
--- /dev/null
+++ b/osu.Game/Rulesets/Edit/DistancedHitObjectComposer.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 osu.Framework.Allocation;
+using osu.Framework.Bindables;
+using osu.Framework.Graphics;
+using osu.Framework.Input.Events;
+using osu.Game.Graphics.Containers;
+using osu.Game.Graphics.UserInterface;
+using osu.Game.Overlays.Settings.Sections;
+using osu.Game.Rulesets.Objects;
+using osuTK;
+
+namespace osu.Game.Rulesets.Edit
+{
+    /// <summary>
+    /// Represents a <see cref="HitObjectComposer{TObject}"/> for rulesets with the concept of distances between objects.
+    /// </summary>
+    /// <typeparam name="TObject">The base type of supported objects.</typeparam>
+    [Cached(typeof(IDistanceSnapProvider))]
+    public abstract class DistancedHitObjectComposer<TObject> : HitObjectComposer<TObject>, IDistanceSnapProvider
+        where TObject : HitObject
+    {
+        protected Bindable<double> DistanceSpacingMultiplier { get; } = new BindableDouble(1.0)
+        {
+            MinValue = 0.1,
+            MaxValue = 6.0,
+            Precision = 0.01,
+        };
+
+        IBindable<double> IDistanceSnapProvider.DistanceSpacingMultiplier => DistanceSpacingMultiplier;
+
+        protected ExpandingToolboxContainer RightSideToolboxContainer { get; private set; }
+
+        private ExpandableSlider<double, SizeSlider<double>> distanceSpacingSlider;
+        private bool distanceSpacingScrollActive;
+
+        protected DistancedHitObjectComposer(Ruleset ruleset)
+            : base(ruleset)
+        {
+        }
+
+        [BackgroundDependencyLoader]
+        private void load()
+        {
+            AddInternal(RightSideToolboxContainer = new ExpandingToolboxContainer
+            {
+                Anchor = Anchor.TopRight,
+                Origin = Anchor.TopRight,
+                Child = new EditorToolboxGroup("snapping")
+                {
+                    Child = distanceSpacingSlider = new ExpandableSlider<double, SizeSlider<double>>
+                    {
+                        Current = { BindTarget = DistanceSpacingMultiplier },
+                        KeyboardStep = 0.1f,
+                    }
+                }
+            });
+        }
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            DistanceSpacingMultiplier.Value = EditorBeatmap.BeatmapInfo.DistanceSpacing;
+            DistanceSpacingMultiplier.BindValueChanged(v =>
+            {
+                distanceSpacingSlider.ContractedLabelText = $"D. S. ({v.NewValue:0.##x})";
+                distanceSpacingSlider.ExpandedLabelText = $"Distance Spacing ({v.NewValue:0.##x})";
+                EditorBeatmap.BeatmapInfo.DistanceSpacing = v.NewValue;
+            }, true);
+        }
+
+        protected override bool OnKeyDown(KeyDownEvent e)
+        {
+            if (e.ControlPressed && e.AltPressed && !e.Repeat)
+            {
+                RightSideToolboxContainer.Expanded.Value = true;
+                distanceSpacingScrollActive = true;
+                return true;
+            }
+
+            return base.OnKeyDown(e);
+        }
+
+        protected override void OnKeyUp(KeyUpEvent e)
+        {
+            if (distanceSpacingScrollActive && (!e.AltPressed || !e.ControlPressed))
+            {
+                RightSideToolboxContainer.Expanded.Value = false;
+                distanceSpacingScrollActive = false;
+            }
+        }
+
+        protected override bool OnScroll(ScrollEvent e)
+        {
+            if (distanceSpacingScrollActive)
+            {
+                DistanceSpacingMultiplier.Value += e.ScrollDelta.Y * (e.IsPrecise ? 0.01f : 0.1f);
+                return true;
+            }
+
+            return base.OnScroll(e);
+        }
+
+        public virtual float GetBeatSnapDistanceAt(HitObject referenceObject)
+        {
+            return (float)(100 * EditorBeatmap.Difficulty.SliderMultiplier * referenceObject.DifficultyControlPoint.SliderVelocity * DistanceSpacingMultiplier.Value / BeatSnapProvider.BeatDivisor);
+        }
+
+        public virtual float DurationToDistance(HitObject referenceObject, double duration)
+        {
+            double beatLength = BeatSnapProvider.GetBeatLengthAtTime(referenceObject.StartTime);
+            return (float)(duration / beatLength * GetBeatSnapDistanceAt(referenceObject));
+        }
+
+        public virtual double DistanceToDuration(HitObject referenceObject, float distance)
+        {
+            double beatLength = BeatSnapProvider.GetBeatLengthAtTime(referenceObject.StartTime);
+            return distance / GetBeatSnapDistanceAt(referenceObject) * beatLength;
+        }
+
+        public virtual double GetSnappedDurationFromDistance(HitObject referenceObject, float distance)
+            => BeatSnapProvider.SnapTime(referenceObject.StartTime + DistanceToDuration(referenceObject, distance), referenceObject.StartTime) - referenceObject.StartTime;
+
+        public virtual float GetSnappedDistanceFromDistance(HitObject referenceObject, float distance)
+        {
+            double startTime = referenceObject.StartTime;
+
+            double actualDuration = startTime + DistanceToDuration(referenceObject, distance);
+
+            double snappedEndTime = BeatSnapProvider.SnapTime(actualDuration, startTime);
+
+            double beatLength = BeatSnapProvider.GetBeatLengthAtTime(startTime);
+
+            // we don't want to exceed the actual duration and snap to a point in the future.
+            // as we are snapping to beat length via SnapTime (which will round-to-nearest), check for snapping in the forward direction and reverse it.
+            if (snappedEndTime > actualDuration + 1)
+                snappedEndTime -= beatLength;
+
+            return DurationToDistance(referenceObject, snappedEndTime - startTime);
+        }
+
+        protected class ExpandingToolboxContainer : ExpandingContainer
+        {
+            protected override double HoverExpansionDelay => 250;
+
+            public ExpandingToolboxContainer()
+                : base(130, 250)
+            {
+                RelativeSizeAxes = Axes.Y;
+                Padding = new MarginPadding { Left = 10 };
+
+                FillFlow.Spacing = new Vector2(10);
+            }
+        }
+    }
+}
diff --git a/osu.Game/Rulesets/Edit/HitObjectComposer.cs b/osu.Game/Rulesets/Edit/HitObjectComposer.cs
index 8d2bd1e5d1..9fc332d726 100644
--- a/osu.Game/Rulesets/Edit/HitObjectComposer.cs
+++ b/osu.Game/Rulesets/Edit/HitObjectComposer.cs
@@ -383,44 +383,6 @@ namespace osu.Game.Rulesets.Edit
             return new SnapResult(screenSpacePosition, targetTime, playfield);
         }
 
-        public override float GetBeatSnapDistanceAt(HitObject referenceObject)
-        {
-            return (float)(100 * referenceObject.DifficultyControlPoint.SliderVelocity * EditorBeatmap.Difficulty.SliderMultiplier / BeatSnapProvider.BeatDivisor);
-        }
-
-        public override float DurationToDistance(HitObject referenceObject, double duration)
-        {
-            double beatLength = BeatSnapProvider.GetBeatLengthAtTime(referenceObject.StartTime);
-            return (float)(duration / beatLength * GetBeatSnapDistanceAt(referenceObject));
-        }
-
-        public override double DistanceToDuration(HitObject referenceObject, float distance)
-        {
-            double beatLength = BeatSnapProvider.GetBeatLengthAtTime(referenceObject.StartTime);
-            return distance / GetBeatSnapDistanceAt(referenceObject) * beatLength;
-        }
-
-        public override double GetSnappedDurationFromDistance(HitObject referenceObject, float distance)
-            => BeatSnapProvider.SnapTime(referenceObject.StartTime + DistanceToDuration(referenceObject, distance), referenceObject.StartTime) - referenceObject.StartTime;
-
-        public override float GetSnappedDistanceFromDistance(HitObject referenceObject, float distance)
-        {
-            double startTime = referenceObject.StartTime;
-
-            double actualDuration = startTime + DistanceToDuration(referenceObject, distance);
-
-            double snappedEndTime = BeatSnapProvider.SnapTime(actualDuration, startTime);
-
-            double beatLength = BeatSnapProvider.GetBeatLengthAtTime(startTime);
-
-            // we don't want to exceed the actual duration and snap to a point in the future.
-            // as we are snapping to beat length via SnapTime (which will round-to-nearest), check for snapping in the forward direction and reverse it.
-            if (snappedEndTime > actualDuration + 1)
-                snappedEndTime -= beatLength;
-
-            return DurationToDistance(referenceObject, snappedEndTime - startTime);
-        }
-
         #endregion
 
         private class LeftToolboxFlow : ExpandingButtonContainer
@@ -473,16 +435,6 @@ namespace osu.Game.Rulesets.Edit
         public virtual SnapResult SnapScreenSpacePositionToValidPosition(Vector2 screenSpacePosition) =>
             new SnapResult(screenSpacePosition, null);
 
-        public abstract float GetBeatSnapDistanceAt(HitObject referenceObject);
-
-        public abstract float DurationToDistance(HitObject referenceObject, double duration);
-
-        public abstract double DistanceToDuration(HitObject referenceObject, float distance);
-
-        public abstract double GetSnappedDurationFromDistance(HitObject referenceObject, float distance);
-
-        public abstract float GetSnappedDistanceFromDistance(HitObject referenceObject, float distance);
-
         #endregion
     }
 }

From bfc6bfc91b19a1fc9fb57518e490b81d9c09b8c3 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 28 Apr 2022 05:50:55 +0300
Subject: [PATCH 4343/5547] Let `CatchHitObjectComposer` inherit from
 `DistancedHitObjectComposer` and hide control

---
 .../Edit/CatchHitObjectComposer.cs            |  9 +++++----
 .../Edit/DistancedHitObjectComposer.cs        | 20 +++++++++++--------
 2 files changed, 17 insertions(+), 12 deletions(-)

diff --git a/osu.Game.Rulesets.Catch/Edit/CatchHitObjectComposer.cs b/osu.Game.Rulesets.Catch/Edit/CatchHitObjectComposer.cs
index b3e6fe382a..a90b0d3e89 100644
--- a/osu.Game.Rulesets.Catch/Edit/CatchHitObjectComposer.cs
+++ b/osu.Game.Rulesets.Catch/Edit/CatchHitObjectComposer.cs
@@ -24,10 +24,7 @@ using osuTK;
 
 namespace osu.Game.Rulesets.Catch.Edit
 {
-    /// <remarks>
-    /// todo: should inherit <see cref="IDistanceSnapProvider"/> once it supports distance spacing properly.
-    /// </remarks>
-    public class CatchHitObjectComposer : HitObjectComposer<CatchHitObject>
+    public class CatchHitObjectComposer : DistancedHitObjectComposer<CatchHitObject>
     {
         private const float distance_snap_radius = 50;
 
@@ -45,6 +42,10 @@ namespace osu.Game.Rulesets.Catch.Edit
         [BackgroundDependencyLoader]
         private void load()
         {
+            // todo: enable distance spacing once catch supports it.
+            RightSideToolboxContainer.Alpha = 0;
+            DistanceSpacingMultiplier.Disabled = true;
+
             LayerBelowRuleset.Add(new PlayfieldBorder
             {
                 RelativeSizeAxes = Axes.Both,
diff --git a/osu.Game/Rulesets/Edit/DistancedHitObjectComposer.cs b/osu.Game/Rulesets/Edit/DistancedHitObjectComposer.cs
index a3624f6d77..d0c9babf24 100644
--- a/osu.Game/Rulesets/Edit/DistancedHitObjectComposer.cs
+++ b/osu.Game/Rulesets/Edit/DistancedHitObjectComposer.cs
@@ -45,6 +45,7 @@ namespace osu.Game.Rulesets.Edit
         {
             AddInternal(RightSideToolboxContainer = new ExpandingToolboxContainer
             {
+                Alpha = DistanceSpacingMultiplier.Disabled ? 0 : 1,
                 Anchor = Anchor.TopRight,
                 Origin = Anchor.TopRight,
                 Child = new EditorToolboxGroup("snapping")
@@ -62,18 +63,21 @@ namespace osu.Game.Rulesets.Edit
         {
             base.LoadComplete();
 
-            DistanceSpacingMultiplier.Value = EditorBeatmap.BeatmapInfo.DistanceSpacing;
-            DistanceSpacingMultiplier.BindValueChanged(v =>
+            if (!DistanceSpacingMultiplier.Disabled)
             {
-                distanceSpacingSlider.ContractedLabelText = $"D. S. ({v.NewValue:0.##x})";
-                distanceSpacingSlider.ExpandedLabelText = $"Distance Spacing ({v.NewValue:0.##x})";
-                EditorBeatmap.BeatmapInfo.DistanceSpacing = v.NewValue;
-            }, true);
+                DistanceSpacingMultiplier.Value = EditorBeatmap.BeatmapInfo.DistanceSpacing;
+                DistanceSpacingMultiplier.BindValueChanged(v =>
+                {
+                    distanceSpacingSlider.ContractedLabelText = $"D. S. ({v.NewValue:0.##x})";
+                    distanceSpacingSlider.ExpandedLabelText = $"Distance Spacing ({v.NewValue:0.##x})";
+                    EditorBeatmap.BeatmapInfo.DistanceSpacing = v.NewValue;
+                }, true);
+            }
         }
 
         protected override bool OnKeyDown(KeyDownEvent e)
         {
-            if (e.ControlPressed && e.AltPressed && !e.Repeat)
+            if (!DistanceSpacingMultiplier.Disabled && e.ControlPressed && e.AltPressed && !e.Repeat)
             {
                 RightSideToolboxContainer.Expanded.Value = true;
                 distanceSpacingScrollActive = true;
@@ -85,7 +89,7 @@ namespace osu.Game.Rulesets.Edit
 
         protected override void OnKeyUp(KeyUpEvent e)
         {
-            if (distanceSpacingScrollActive && (!e.AltPressed || !e.ControlPressed))
+            if (!DistanceSpacingMultiplier.Disabled && distanceSpacingScrollActive && (!e.AltPressed || !e.ControlPressed))
             {
                 RightSideToolboxContainer.Expanded.Value = false;
                 distanceSpacingScrollActive = false;

From a5defbe4961b06d37a8a6c7f834196e00f63a806 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 28 Apr 2022 06:44:02 +0300
Subject: [PATCH 4344/5547] Keep distance spacing reset to one on test scenes
 with slider snapping for now

---
 .../Editor/TestSceneObjectObjectSnap.cs              | 12 ++++--------
 .../Editor/TestSceneSliderSnapping.cs                | 10 ++--------
 2 files changed, 6 insertions(+), 16 deletions(-)

diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneObjectObjectSnap.cs b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneObjectObjectSnap.cs
index dfb6ecfcae..21ba1e647d 100644
--- a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneObjectObjectSnap.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneObjectObjectSnap.cs
@@ -3,11 +3,9 @@
 
 using System.Linq;
 using NUnit.Framework;
-using osu.Framework.Bindables;
 using osu.Framework.Testing;
 using osu.Framework.Utils;
 using osu.Game.Beatmaps;
-using osu.Game.Rulesets.Edit;
 using osu.Game.Rulesets.Osu.Objects;
 using osu.Game.Rulesets.Osu.UI;
 using osu.Game.Tests.Beatmaps;
@@ -21,18 +19,16 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
     {
         private OsuPlayfield playfield;
 
-        protected override IBeatmap CreateBeatmap(RulesetInfo ruleset) => new TestBeatmap(Ruleset.Value, false);
+        protected override IBeatmap CreateBeatmap(RulesetInfo ruleset) => new TestBeatmap(Ruleset.Value, false)
+        {
+            BeatmapInfo = { DistanceSpacing = 1 }
+        };
 
         public override void SetUpSteps()
         {
             base.SetUpSteps();
             AddStep("get playfield", () => playfield = Editor.ChildrenOfType<OsuPlayfield>().First());
             AddStep("seek to first control point", () => EditorClock.Seek(Beatmap.Value.Beatmap.ControlPointInfo.TimingPoints.First().Time));
-            AddStep("set distance spacing to 1", () =>
-            {
-                var distanceSpacing = (BindableDouble)Editor.ChildrenOfType<IDistanceSnapProvider>().Single().DistanceSpacingMultiplier;
-                distanceSpacing.Value = 1;
-            });
         }
 
         [TestCase(true)]
diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderSnapping.cs b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderSnapping.cs
index 702e2216ac..4833266dca 100644
--- a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderSnapping.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderSnapping.cs
@@ -4,14 +4,12 @@
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
-using osu.Framework.Bindables;
 using osu.Framework.Input.Events;
 using osu.Framework.Testing;
 using osu.Framework.Utils;
 using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.ControlPoints;
 using osu.Game.Input.Bindings;
-using osu.Game.Rulesets.Edit;
 using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Osu.Edit;
 using osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders.Components;
@@ -38,7 +36,8 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
             controlPointInfo.Add(0, new TimingControlPoint { BeatLength = beat_length });
             return new TestBeatmap(ruleset, false)
             {
-                ControlPointInfo = controlPointInfo
+                ControlPointInfo = controlPointInfo,
+                BeatmapInfo = { DistanceSpacing = 1 },
             };
         }
 
@@ -67,11 +66,6 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
                 var beatDivisor = Editor.Dependencies.Get<BindableBeatDivisor>();
                 beatDivisor.Value = 1;
             });
-            AddStep("set distance spacing to 1", () =>
-            {
-                var distanceSpacing = (BindableDouble)Editor.ChildrenOfType<IDistanceSnapProvider>().Single().DistanceSpacingMultiplier;
-                distanceSpacing.Value = 1;
-            });
         }
 
         [Test]

From 71533808e9958f7470c407750cc34cdc0a014804 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 28 Apr 2022 06:46:20 +0300
Subject: [PATCH 4345/5547] Add test case for `DistanceSpacingMultiplier` in
 distance snapping test scene

---
 .../TestSceneHitObjectComposerDistanceSnapping.cs  | 14 +++++++++++++-
 1 file changed, 13 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Editing/TestSceneHitObjectComposerDistanceSnapping.cs b/osu.Game.Tests/Editing/TestSceneHitObjectComposerDistanceSnapping.cs
index d9312cb7ae..e2ff45c431 100644
--- a/osu.Game.Tests/Editing/TestSceneHitObjectComposerDistanceSnapping.cs
+++ b/osu.Game.Tests/Editing/TestSceneHitObjectComposerDistanceSnapping.cs
@@ -3,6 +3,7 @@
 
 using NUnit.Framework;
 using osu.Framework.Allocation;
+using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Testing;
@@ -70,7 +71,7 @@ namespace osu.Game.Tests.Editing
         [TestCase(2)]
         public void TestSliderMultiplier(float multiplier)
         {
-            AddStep($"set multiplier = {multiplier}", () => composer.EditorBeatmap.Difficulty.SliderMultiplier = multiplier);
+            AddStep($"set slider multiplier = {multiplier}", () => composer.EditorBeatmap.Difficulty.SliderMultiplier = multiplier);
 
             assertSnapDistance(100 * multiplier);
         }
@@ -88,6 +89,15 @@ namespace osu.Game.Tests.Editing
             });
         }
 
+        [TestCase(1)]
+        [TestCase(2)]
+        public void TestDistanceSpacingMultiplier(float multiplier)
+        {
+            AddStep($"set distance spacing = {multiplier}", () => composer.DistanceSpacingMultiplier.Value = multiplier);
+
+            assertSnapDistance(100 * multiplier);
+        }
+
         [TestCase(1)]
         [TestCase(2)]
         public void TestBeatDivisor(int divisor)
@@ -222,6 +232,8 @@ namespace osu.Game.Tests.Editing
         {
             public new EditorBeatmap EditorBeatmap => base.EditorBeatmap;
 
+            public new Bindable<double> DistanceSpacingMultiplier => base.DistanceSpacingMultiplier;
+
             public TestHitObjectComposer()
                 : base(new OsuRuleset())
             {

From dacca73838049da362da4f7628c5e8948fbe8322 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 28 Apr 2022 06:46:34 +0300
Subject: [PATCH 4346/5547] Set default value of `DistanceSpacing` to 1

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

diff --git a/osu.Game/Beatmaps/BeatmapInfo.cs b/osu.Game/Beatmaps/BeatmapInfo.cs
index f90208d0c0..1a9703f478 100644
--- a/osu.Game/Beatmaps/BeatmapInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapInfo.cs
@@ -109,7 +109,7 @@ namespace osu.Game.Beatmaps
 
         public bool SamplesMatchPlaybackRate { get; set; } = true;
 
-        public double DistanceSpacing { get; set; }
+        public double DistanceSpacing { get; set; } = 1.0;
 
         public int BeatDivisor { get; set; }
 

From 2e8372fe906996996553d275f333358b3699c9b3 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 28 Apr 2022 06:52:42 +0300
Subject: [PATCH 4347/5547] Minor cleanup

Just from reading diff.
---
 .../Editor/TestSceneSliderSnapping.cs                      | 3 +--
 .../Visual/Editing/TestSceneHitObjectComposer.cs           | 7 +++----
 osu.Game/Rulesets/Edit/HitObjectComposer.cs                | 4 +---
 .../Screens/Edit/Compose/Components/DistanceSnapGrid.cs    | 2 +-
 4 files changed, 6 insertions(+), 10 deletions(-)

diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderSnapping.cs b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderSnapping.cs
index 4833266dca..6b9a0ff531 100644
--- a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderSnapping.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderSnapping.cs
@@ -3,7 +3,6 @@
 
 using System.Linq;
 using NUnit.Framework;
-using osu.Framework.Allocation;
 using osu.Framework.Input.Events;
 using osu.Framework.Testing;
 using osu.Framework.Utils;
@@ -63,7 +62,7 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
             }));
             AddStep("set beat divisor to 1/1", () =>
             {
-                var beatDivisor = Editor.Dependencies.Get<BindableBeatDivisor>();
+                var beatDivisor = (BindableBeatDivisor)Editor.Dependencies.Get(typeof(BindableBeatDivisor));
                 beatDivisor.Value = 1;
             });
         }
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneHitObjectComposer.cs b/osu.Game.Tests/Visual/Editing/TestSceneHitObjectComposer.cs
index 7039d7d8a4..ae1b691767 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneHitObjectComposer.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneHitObjectComposer.cs
@@ -8,7 +8,6 @@ using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Testing;
-using osu.Framework.Utils;
 using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.ControlPoints;
 using osu.Game.Rulesets.Edit;
@@ -91,15 +90,15 @@ namespace osu.Game.Tests.Visual.Editing
         [Test]
         public void TestDistanceSpacingHotkeys()
         {
-            float originalSpacing = 0;
+            double originalSpacing = 0;
 
-            AddStep("retrieve original spacing", () => originalSpacing = (float)editorBeatmap.BeatmapInfo.DistanceSpacing);
+            AddStep("retrieve original spacing", () => originalSpacing = editorBeatmap.BeatmapInfo.DistanceSpacing);
 
             AddStep("hold ctrl", () => InputManager.PressKey(Key.LControl));
             AddStep("hold alt", () => InputManager.PressKey(Key.LAlt));
 
             AddStep("scroll mouse 5 steps", () => InputManager.ScrollVerticalBy(5));
-            AddAssert("distance spacing increased by 0.5", () => Precision.AlmostEquals(editorBeatmap.BeatmapInfo.DistanceSpacing, originalSpacing + 0.5f));
+            AddAssert("distance spacing increased by 0.5", () => editorBeatmap.BeatmapInfo.DistanceSpacing == originalSpacing + 0.5);
 
             AddStep("release alt", () => InputManager.ReleaseKey(Key.LAlt));
             AddStep("release ctrl", () => InputManager.ReleaseKey(Key.LControl));
diff --git a/osu.Game/Rulesets/Edit/HitObjectComposer.cs b/osu.Game/Rulesets/Edit/HitObjectComposer.cs
index 9fc332d726..a235a5bc60 100644
--- a/osu.Game/Rulesets/Edit/HitObjectComposer.cs
+++ b/osu.Game/Rulesets/Edit/HitObjectComposer.cs
@@ -117,8 +117,6 @@ namespace osu.Game.Rulesets.Edit
                 },
                 new LeftToolboxFlow
                 {
-                    Anchor = Anchor.TopLeft,
-                    Origin = Anchor.TopLeft,
                     Children = new Drawable[]
                     {
                         new EditorToolboxGroup("toolbox (1-9)")
@@ -134,7 +132,7 @@ namespace osu.Game.Rulesets.Edit
                                 Direction = FillDirection.Vertical,
                                 Spacing = new Vector2(0, 5),
                             },
-                        },
+                        }
                     }
                 },
             };
diff --git a/osu.Game/Screens/Edit/Compose/Components/DistanceSnapGrid.cs b/osu.Game/Screens/Edit/Compose/Components/DistanceSnapGrid.cs
index 9dd6cec8ce..4f348567b1 100644
--- a/osu.Game/Screens/Edit/Compose/Components/DistanceSnapGrid.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/DistanceSnapGrid.cs
@@ -84,7 +84,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
         {
             base.LoadComplete();
 
-            beatDivisor.BindValueChanged(_ => updateSpacing(), true);
+            beatDivisor.BindValueChanged(_ => updateSpacing());
 
             distanceSpacingMultiplier = SnapProvider.DistanceSpacingMultiplier.GetBoundCopy();
             distanceSpacingMultiplier.BindValueChanged(_ => updateSpacing(), true);

From aabe5865784ca5ed2729c507c2267ca14cc0d0c2 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 28 Apr 2022 14:09:30 +0900
Subject: [PATCH 4348/5547] Add return value to `EnsureMutableSkin` to
 understand whether a new skin was made

---
 osu.Game/Skinning/SkinManager.cs | 13 +++++++++----
 1 file changed, 9 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Skinning/SkinManager.cs b/osu.Game/Skinning/SkinManager.cs
index 01e7646644..77e60d179c 100644
--- a/osu.Game/Skinning/SkinManager.cs
+++ b/osu.Game/Skinning/SkinManager.cs
@@ -143,12 +143,15 @@ namespace osu.Game.Skinning
         /// Ensure that the current skin is in a state it can accept user modifications.
         /// This will create a copy of any internal skin and being tracking in the database if not already.
         /// </summary>
-        public void EnsureMutableSkin()
+        /// <returns>
+        /// Whether a new skin was created to allow for mutation.
+        /// </returns>
+        public bool EnsureMutableSkin()
         {
-            CurrentSkinInfo.Value.PerformRead(s =>
+            return CurrentSkinInfo.Value.PerformRead(s =>
             {
                 if (!s.Protected)
-                    return;
+                    return false;
 
                 string[] existingSkinNames = realm.Run(r => r.All<SkinInfo>()
                                                              .Where(skin => !skin.DeletePending)
@@ -160,7 +163,7 @@ namespace osu.Game.Skinning
                 {
                     Creator = s.Creator,
                     InstantiationInfo = s.InstantiationInfo,
-                    Name = NamingUtils.GetNextBestName(existingSkinNames, $"{s.Name} (modified)")
+                    Name = NamingUtils.GetNextBestName(existingSkinNames, $@"{s.Name} (modified)")
                 };
 
                 var result = skinModelManager.Import(skinInfo);
@@ -172,6 +175,8 @@ namespace osu.Game.Skinning
                     result.PerformRead(skin => Save(skin.CreateInstance(this)));
                     CurrentSkinInfo.Value = result;
                 }
+
+                return true;
             });
         }
 

From 7c1b0b41ff1e52acb9cc5bc25fa166bf4d95637f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 28 Apr 2022 14:09:41 +0900
Subject: [PATCH 4349/5547] Fix migration not working correctly when applying
 on a default skin

---
 osu.Game/Screens/Play/SongProgress.cs | 19 +++++++++----------
 1 file changed, 9 insertions(+), 10 deletions(-)

diff --git a/osu.Game/Screens/Play/SongProgress.cs b/osu.Game/Screens/Play/SongProgress.cs
index 592071b02e..35d70976d2 100644
--- a/osu.Game/Screens/Play/SongProgress.cs
+++ b/osu.Game/Screens/Play/SongProgress.cs
@@ -162,7 +162,6 @@ namespace osu.Game.Screens.Play
             if (!configShowGraph.IsDefault)
             {
                 ShowGraph.Value = configShowGraph.Value;
-                configShowGraph.SetDefault();
 
                 // This is pretty ugly, but the only way to make this stick...
                 if (skinManager != null)
@@ -171,17 +170,17 @@ namespace osu.Game.Screens.Play
 
                     if (skinnableTarget != null)
                     {
-                        skinManager.EnsureMutableSkin();
+                        // If the skin is not mutable, a mutable instance will be created, causing this migration logic to run again on the correct skin.
+                        // Therefore we want to avoid resetting the config value on this invocation.
+                        if (skinManager.EnsureMutableSkin())
+                            return;
 
-                        // If `EnsureMutableSkin` actually changed the skin, default layout may take a frame to apply.
-                        // See `SkinnableTargetComponentsContainer`'s use of ScheduleAfterChildren.
-                        ScheduleAfterChildren(() =>
-                        {
-                            var skin = skinManager.CurrentSkin.Value;
-                            skin.UpdateDrawableTarget(skinnableTarget);
+                        var skin = skinManager.CurrentSkin.Value;
+                        skin.UpdateDrawableTarget(skinnableTarget);
 
-                            skinManager.Save(skin);
-                        });
+                        skinManager.Save(skin);
+
+                        configShowGraph.SetDefault();
                     }
                 }
             }

From 3c45746ba10e889f6ca68172d40fa397b448ecb2 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 28 Apr 2022 14:29:57 +0900
Subject: [PATCH 4350/5547] Add back schedule for safety

---
 osu.Game/Screens/Play/SongProgress.cs | 11 ++++++++---
 1 file changed, 8 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Screens/Play/SongProgress.cs b/osu.Game/Screens/Play/SongProgress.cs
index 35d70976d2..a21a08e558 100644
--- a/osu.Game/Screens/Play/SongProgress.cs
+++ b/osu.Game/Screens/Play/SongProgress.cs
@@ -175,10 +175,15 @@ namespace osu.Game.Screens.Play
                         if (skinManager.EnsureMutableSkin())
                             return;
 
-                        var skin = skinManager.CurrentSkin.Value;
-                        skin.UpdateDrawableTarget(skinnableTarget);
+                        // If `EnsureMutableSkin` actually changed the skin, default layout may take a frame to apply.
+                        // See `SkinnableTargetComponentsContainer`'s use of ScheduleAfterChildren.
+                        ScheduleAfterChildren(() =>
+                        {
+                            var skin = skinManager.CurrentSkin.Value;
+                            skin.UpdateDrawableTarget(skinnableTarget);
 
-                        skinManager.Save(skin);
+                            skinManager.Save(skin);
+                        });
 
                         configShowGraph.SetDefault();
                     }

From f3a0e2ed55ba0c99feaec64911d92575bbb3d72c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 28 Apr 2022 14:59:39 +0900
Subject: [PATCH 4351/5547] Increase fade duration

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

diff --git a/osu.Game/Overlays/Mods/ModSelectScreen.cs b/osu.Game/Overlays/Mods/ModSelectScreen.cs
index a47a399a23..03a66575c4 100644
--- a/osu.Game/Overlays/Mods/ModSelectScreen.cs
+++ b/osu.Game/Overlays/Mods/ModSelectScreen.cs
@@ -426,7 +426,7 @@ namespace osu.Game.Overlays.Mods
                 else
                     targetColour = IsHovered ? colours.GrayC : colours.Gray8;
 
-                this.FadeColour(targetColour, 300, Easing.OutQuint);
+                this.FadeColour(targetColour, 800, Easing.OutQuint);
             }
 
             protected override bool OnClick(ClickEvent e)

From 7aaa88cac2be239dcc778a1082585f8e8d5a7e55 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 28 Apr 2022 10:24:36 +0300
Subject: [PATCH 4352/5547] Convert data type of `DistanceSpacing` to float

---
 .../Editor/TestSceneOsuDistanceSnapGrid.cs         |  2 +-
 .../TestSceneHitObjectComposerDistanceSnapping.cs  |  2 +-
 .../Visual/Editing/TestSceneDistanceSnapGrid.cs    |  2 +-
 .../UserInterface/TestSceneExpandingContainer.cs   |  4 ++--
 osu.Game/Beatmaps/BeatmapInfo.cs                   |  2 +-
 osu.Game/Beatmaps/EFBeatmapInfo.cs                 |  2 +-
 osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs  |  2 +-
 .../Settings/Sections/Gameplay/InputSettings.cs    |  2 +-
 osu.Game/Overlays/Settings/Sections/SizeSlider.cs  |  7 ++-----
 .../Sections/UserInterface/GeneralSettings.cs      |  2 +-
 .../Rulesets/Edit/DistancedHitObjectComposer.cs    | 14 +++++++-------
 osu.Game/Rulesets/Edit/IDistanceSnapProvider.cs    |  2 +-
 .../Edit/Compose/Components/DistanceSnapGrid.cs    |  2 +-
 13 files changed, 21 insertions(+), 24 deletions(-)

diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuDistanceSnapGrid.cs b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuDistanceSnapGrid.cs
index 2ba30c5f74..4cccddddf3 100644
--- a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuDistanceSnapGrid.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuDistanceSnapGrid.cs
@@ -187,7 +187,7 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
 
             public SnapResult SnapScreenSpacePositionToValidTime(Vector2 screenSpacePosition) => new SnapResult(screenSpacePosition, 0);
 
-            public IBindable<double> DistanceSpacingMultiplier { get; } = new BindableDouble(1);
+            public IBindable<float> DistanceSpacingMultiplier { get; } = new BindableFloat(1);
 
             public float GetBeatSnapDistanceAt(HitObject referenceObject) => (float)beat_length;
 
diff --git a/osu.Game.Tests/Editing/TestSceneHitObjectComposerDistanceSnapping.cs b/osu.Game.Tests/Editing/TestSceneHitObjectComposerDistanceSnapping.cs
index e2ff45c431..ffaf3ec41d 100644
--- a/osu.Game.Tests/Editing/TestSceneHitObjectComposerDistanceSnapping.cs
+++ b/osu.Game.Tests/Editing/TestSceneHitObjectComposerDistanceSnapping.cs
@@ -232,7 +232,7 @@ namespace osu.Game.Tests.Editing
         {
             public new EditorBeatmap EditorBeatmap => base.EditorBeatmap;
 
-            public new Bindable<double> DistanceSpacingMultiplier => base.DistanceSpacingMultiplier;
+            public new Bindable<float> DistanceSpacingMultiplier => base.DistanceSpacingMultiplier;
 
             public TestHitObjectComposer()
                 : base(new OsuRuleset())
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneDistanceSnapGrid.cs b/osu.Game.Tests/Visual/Editing/TestSceneDistanceSnapGrid.cs
index b9cfa84a5d..20bf9b3fa0 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneDistanceSnapGrid.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneDistanceSnapGrid.cs
@@ -167,7 +167,7 @@ namespace osu.Game.Tests.Visual.Editing
 
             public SnapResult SnapScreenSpacePositionToValidTime(Vector2 screenSpacePosition) => new SnapResult(screenSpacePosition, 0);
 
-            public IBindable<double> DistanceSpacingMultiplier { get; } = new BindableDouble(1);
+            public IBindable<float> DistanceSpacingMultiplier { get; } = new BindableFloat(1);
 
             public float GetBeatSnapDistanceAt(HitObject referenceObject) => 10;
 
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneExpandingContainer.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneExpandingContainer.cs
index 288c0cb140..f4920b4412 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneExpandingContainer.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneExpandingContainer.cs
@@ -17,7 +17,7 @@ namespace osu.Game.Tests.Visual.UserInterface
         private TestExpandingContainer container;
         private SettingsToolboxGroup toolboxGroup;
 
-        private ExpandableSlider<float, SizeSlider<float>> slider1;
+        private ExpandableSlider<float, SizeSlider> slider1;
         private ExpandableSlider<double> slider2;
 
         [SetUp]
@@ -34,7 +34,7 @@ namespace osu.Game.Tests.Visual.UserInterface
                     Width = 1,
                     Children = new Drawable[]
                     {
-                        slider1 = new ExpandableSlider<float, SizeSlider<float>>
+                        slider1 = new ExpandableSlider<float, SizeSlider>
                         {
                             Current = new BindableFloat
                             {
diff --git a/osu.Game/Beatmaps/BeatmapInfo.cs b/osu.Game/Beatmaps/BeatmapInfo.cs
index 1a9703f478..1b364247a8 100644
--- a/osu.Game/Beatmaps/BeatmapInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapInfo.cs
@@ -109,7 +109,7 @@ namespace osu.Game.Beatmaps
 
         public bool SamplesMatchPlaybackRate { get; set; } = true;
 
-        public double DistanceSpacing { get; set; } = 1.0;
+        public float DistanceSpacing { get; set; } = 1.0f;
 
         public int BeatDivisor { get; set; }
 
diff --git a/osu.Game/Beatmaps/EFBeatmapInfo.cs b/osu.Game/Beatmaps/EFBeatmapInfo.cs
index 740adfd1c7..67c4dbe788 100644
--- a/osu.Game/Beatmaps/EFBeatmapInfo.cs
+++ b/osu.Game/Beatmaps/EFBeatmapInfo.cs
@@ -107,7 +107,7 @@ namespace osu.Game.Beatmaps
         [NotMapped]
         public int[] Bookmarks { get; set; } = Array.Empty<int>();
 
-        public double DistanceSpacing { get; set; }
+        public float DistanceSpacing { get; set; }
         public int BeatDivisor { get; set; }
         public int GridSize { get; set; }
         public double TimelineZoom { get; set; }
diff --git a/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs b/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
index 79d8bd3bb3..0ba7a07010 100644
--- a/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
+++ b/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
@@ -240,7 +240,7 @@ namespace osu.Game.Beatmaps.Formats
                     break;
 
                 case @"DistanceSpacing":
-                    beatmap.BeatmapInfo.DistanceSpacing = Math.Max(0, Parsing.ParseDouble(pair.Value));
+                    beatmap.BeatmapInfo.DistanceSpacing = Math.Max(0, Parsing.ParseFloat(pair.Value));
                     break;
 
                 case @"BeatDivisor":
diff --git a/osu.Game/Overlays/Settings/Sections/Gameplay/InputSettings.cs b/osu.Game/Overlays/Settings/Sections/Gameplay/InputSettings.cs
index 83ea655601..962572ca6e 100644
--- a/osu.Game/Overlays/Settings/Sections/Gameplay/InputSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Gameplay/InputSettings.cs
@@ -19,7 +19,7 @@ namespace osu.Game.Overlays.Settings.Sections.Gameplay
         {
             Children = new Drawable[]
             {
-                new SettingsSlider<float, SizeSlider<float>>
+                new SettingsSlider<float, SizeSlider>
                 {
                     LabelText = SkinSettingsStrings.GameplayCursorSize,
                     Current = config.GetBindable<float>(OsuSetting.GameplayCursorSize),
diff --git a/osu.Game/Overlays/Settings/Sections/SizeSlider.cs b/osu.Game/Overlays/Settings/Sections/SizeSlider.cs
index c8a46162af..8aeb440be1 100644
--- a/osu.Game/Overlays/Settings/Sections/SizeSlider.cs
+++ b/osu.Game/Overlays/Settings/Sections/SizeSlider.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.Globalization;
 using osu.Framework.Localisation;
 using osu.Game.Graphics.UserInterface;
 
@@ -11,9 +9,8 @@ namespace osu.Game.Overlays.Settings.Sections
     /// <summary>
     /// A slider intended to show a "size" multiplier number, where 1x is 1.0.
     /// </summary>
-    public class SizeSlider<T> : OsuSliderBar<T>
-        where T : struct, IEquatable<T>, IComparable<T>, IConvertible, IFormattable
+    internal class SizeSlider : OsuSliderBar<float>
     {
-        public override LocalisableString TooltipText => Current.Value.ToString(@"0.##x", NumberFormatInfo.CurrentInfo);
+        public override LocalisableString TooltipText => Current.Value.ToString(@"0.##x");
     }
 }
diff --git a/osu.Game/Overlays/Settings/Sections/UserInterface/GeneralSettings.cs b/osu.Game/Overlays/Settings/Sections/UserInterface/GeneralSettings.cs
index 0e3b822c82..6e1558f7d7 100644
--- a/osu.Game/Overlays/Settings/Sections/UserInterface/GeneralSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/UserInterface/GeneralSettings.cs
@@ -24,7 +24,7 @@ namespace osu.Game.Overlays.Settings.Sections.UserInterface
                     LabelText = UserInterfaceStrings.CursorRotation,
                     Current = config.GetBindable<bool>(OsuSetting.CursorRotation)
                 },
-                new SettingsSlider<float, SizeSlider<float>>
+                new SettingsSlider<float, SizeSlider>
                 {
                     LabelText = UserInterfaceStrings.MenuCursorSize,
                     Current = config.GetBindable<float>(OsuSetting.MenuCursorSize),
diff --git a/osu.Game/Rulesets/Edit/DistancedHitObjectComposer.cs b/osu.Game/Rulesets/Edit/DistancedHitObjectComposer.cs
index d0c9babf24..ce31318fb8 100644
--- a/osu.Game/Rulesets/Edit/DistancedHitObjectComposer.cs
+++ b/osu.Game/Rulesets/Edit/DistancedHitObjectComposer.cs
@@ -21,18 +21,18 @@ namespace osu.Game.Rulesets.Edit
     public abstract class DistancedHitObjectComposer<TObject> : HitObjectComposer<TObject>, IDistanceSnapProvider
         where TObject : HitObject
     {
-        protected Bindable<double> DistanceSpacingMultiplier { get; } = new BindableDouble(1.0)
+        protected Bindable<float> DistanceSpacingMultiplier { get; } = new BindableFloat(1.0f)
         {
-            MinValue = 0.1,
-            MaxValue = 6.0,
-            Precision = 0.01,
+            MinValue = 0.1f,
+            MaxValue = 6.0f,
+            Precision = 0.01f,
         };
 
-        IBindable<double> IDistanceSnapProvider.DistanceSpacingMultiplier => DistanceSpacingMultiplier;
+        IBindable<float> IDistanceSnapProvider.DistanceSpacingMultiplier => DistanceSpacingMultiplier;
 
         protected ExpandingToolboxContainer RightSideToolboxContainer { get; private set; }
 
-        private ExpandableSlider<double, SizeSlider<double>> distanceSpacingSlider;
+        private ExpandableSlider<float, SizeSlider> distanceSpacingSlider;
         private bool distanceSpacingScrollActive;
 
         protected DistancedHitObjectComposer(Ruleset ruleset)
@@ -50,7 +50,7 @@ namespace osu.Game.Rulesets.Edit
                 Origin = Anchor.TopRight,
                 Child = new EditorToolboxGroup("snapping")
                 {
-                    Child = distanceSpacingSlider = new ExpandableSlider<double, SizeSlider<double>>
+                    Child = distanceSpacingSlider = new ExpandableSlider<float, SizeSlider>
                     {
                         Current = { BindTarget = DistanceSpacingMultiplier },
                         KeyboardStep = 0.1f,
diff --git a/osu.Game/Rulesets/Edit/IDistanceSnapProvider.cs b/osu.Game/Rulesets/Edit/IDistanceSnapProvider.cs
index c6e866561e..0eb572d22a 100644
--- a/osu.Game/Rulesets/Edit/IDistanceSnapProvider.cs
+++ b/osu.Game/Rulesets/Edit/IDistanceSnapProvider.cs
@@ -13,7 +13,7 @@ namespace osu.Game.Rulesets.Edit
         /// The spacing multiplier applied to beat snap distances.
         /// </summary>
         /// <seealso cref="BeatmapInfo.DistanceSpacing"/>
-        IBindable<double> DistanceSpacingMultiplier { get; }
+        IBindable<float> DistanceSpacingMultiplier { get; }
 
         /// <summary>
         /// Retrieves the distance between two points within a timing point that are one beat length apart.
diff --git a/osu.Game/Screens/Edit/Compose/Components/DistanceSnapGrid.cs b/osu.Game/Screens/Edit/Compose/Components/DistanceSnapGrid.cs
index 4f348567b1..cd56beda47 100644
--- a/osu.Game/Screens/Edit/Compose/Components/DistanceSnapGrid.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/DistanceSnapGrid.cs
@@ -53,7 +53,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
         [Resolved]
         private BindableBeatDivisor beatDivisor { get; set; }
 
-        private IBindable<double> distanceSpacingMultiplier;
+        private IBindable<float> distanceSpacingMultiplier;
 
         private readonly LayoutValue gridCache = new LayoutValue(Invalidation.RequiredParentSizeToFit);
         private readonly double? endTime;

From abb88b090702a9330401ab4c348b725b379a2d25 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 28 Apr 2022 10:54:38 +0300
Subject: [PATCH 4353/5547] Move distance spacing application to
 `DistanceSnapGrid`

---
 .../Editor/TestSceneObjectObjectSnap.cs                |  5 +----
 .../Editor/TestSceneSliderSnapping.cs                  |  3 +--
 .../TestSceneHitObjectComposerDistanceSnapping.cs      | 10 ----------
 osu.Game/Rulesets/Edit/DistancedHitObjectComposer.cs   |  2 +-
 .../Edit/Compose/Components/DistanceSnapGrid.cs        |  2 +-
 5 files changed, 4 insertions(+), 18 deletions(-)

diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneObjectObjectSnap.cs b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneObjectObjectSnap.cs
index 21ba1e647d..7bdf131e0d 100644
--- a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneObjectObjectSnap.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneObjectObjectSnap.cs
@@ -19,10 +19,7 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
     {
         private OsuPlayfield playfield;
 
-        protected override IBeatmap CreateBeatmap(RulesetInfo ruleset) => new TestBeatmap(Ruleset.Value, false)
-        {
-            BeatmapInfo = { DistanceSpacing = 1 }
-        };
+        protected override IBeatmap CreateBeatmap(RulesetInfo ruleset) => new TestBeatmap(Ruleset.Value, false);
 
         public override void SetUpSteps()
         {
diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderSnapping.cs b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderSnapping.cs
index 6b9a0ff531..b43b2b1461 100644
--- a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderSnapping.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderSnapping.cs
@@ -35,8 +35,7 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
             controlPointInfo.Add(0, new TimingControlPoint { BeatLength = beat_length });
             return new TestBeatmap(ruleset, false)
             {
-                ControlPointInfo = controlPointInfo,
-                BeatmapInfo = { DistanceSpacing = 1 },
+                ControlPointInfo = controlPointInfo
             };
         }
 
diff --git a/osu.Game.Tests/Editing/TestSceneHitObjectComposerDistanceSnapping.cs b/osu.Game.Tests/Editing/TestSceneHitObjectComposerDistanceSnapping.cs
index ffaf3ec41d..2c2c06ae0c 100644
--- a/osu.Game.Tests/Editing/TestSceneHitObjectComposerDistanceSnapping.cs
+++ b/osu.Game.Tests/Editing/TestSceneHitObjectComposerDistanceSnapping.cs
@@ -62,7 +62,6 @@ namespace osu.Game.Tests.Editing
             BeatDivisor.Value = 1;
 
             composer.EditorBeatmap.Difficulty.SliderMultiplier = 1;
-            composer.EditorBeatmap.BeatmapInfo.DistanceSpacing = 1;
             composer.EditorBeatmap.ControlPointInfo.Clear();
             composer.EditorBeatmap.ControlPointInfo.Add(0, new TimingControlPoint { BeatLength = 1000 });
         });
@@ -89,15 +88,6 @@ namespace osu.Game.Tests.Editing
             });
         }
 
-        [TestCase(1)]
-        [TestCase(2)]
-        public void TestDistanceSpacingMultiplier(float multiplier)
-        {
-            AddStep($"set distance spacing = {multiplier}", () => composer.DistanceSpacingMultiplier.Value = multiplier);
-
-            assertSnapDistance(100 * multiplier);
-        }
-
         [TestCase(1)]
         [TestCase(2)]
         public void TestBeatDivisor(int divisor)
diff --git a/osu.Game/Rulesets/Edit/DistancedHitObjectComposer.cs b/osu.Game/Rulesets/Edit/DistancedHitObjectComposer.cs
index ce31318fb8..1e1fbb4edf 100644
--- a/osu.Game/Rulesets/Edit/DistancedHitObjectComposer.cs
+++ b/osu.Game/Rulesets/Edit/DistancedHitObjectComposer.cs
@@ -109,7 +109,7 @@ namespace osu.Game.Rulesets.Edit
 
         public virtual float GetBeatSnapDistanceAt(HitObject referenceObject)
         {
-            return (float)(100 * EditorBeatmap.Difficulty.SliderMultiplier * referenceObject.DifficultyControlPoint.SliderVelocity * DistanceSpacingMultiplier.Value / BeatSnapProvider.BeatDivisor);
+            return (float)(100 * EditorBeatmap.Difficulty.SliderMultiplier * referenceObject.DifficultyControlPoint.SliderVelocity / BeatSnapProvider.BeatDivisor);
         }
 
         public virtual float DurationToDistance(HitObject referenceObject, double duration)
diff --git a/osu.Game/Screens/Edit/Compose/Components/DistanceSnapGrid.cs b/osu.Game/Screens/Edit/Compose/Components/DistanceSnapGrid.cs
index cd56beda47..13c3b713b1 100644
--- a/osu.Game/Screens/Edit/Compose/Components/DistanceSnapGrid.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/DistanceSnapGrid.cs
@@ -92,7 +92,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
 
         private void updateSpacing()
         {
-            DistanceSpacing = SnapProvider.GetBeatSnapDistanceAt(ReferenceObject);
+            DistanceSpacing = SnapProvider.GetBeatSnapDistanceAt(ReferenceObject) * distanceSpacingMultiplier.Value;
 
             if (endTime == null)
                 MaxIntervals = int.MaxValue;

From b6d2ca7709b0b8a32f179c0c258852217372b520 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 28 Apr 2022 10:57:14 +0300
Subject: [PATCH 4354/5547] Clarify TODO comment

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

diff --git a/osu.Game.Rulesets.Catch/Edit/CatchHitObjectComposer.cs b/osu.Game.Rulesets.Catch/Edit/CatchHitObjectComposer.cs
index a90b0d3e89..9ff6d10a49 100644
--- a/osu.Game.Rulesets.Catch/Edit/CatchHitObjectComposer.cs
+++ b/osu.Game.Rulesets.Catch/Edit/CatchHitObjectComposer.cs
@@ -42,7 +42,7 @@ namespace osu.Game.Rulesets.Catch.Edit
         [BackgroundDependencyLoader]
         private void load()
         {
-            // todo: enable distance spacing once catch supports it.
+            // todo: enable distance spacing once catch supports applying it to its existing distance snap grid implementation.
             RightSideToolboxContainer.Alpha = 0;
             DistanceSpacingMultiplier.Disabled = true;
 

From edeefc28501a12c7719025a63925975b39e4bd3c Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 28 Apr 2022 11:10:14 +0300
Subject: [PATCH 4355/5547] Update framework

---
 osu.Android.props        | 2 +-
 osu.Game/osu.Game.csproj | 2 +-
 osu.iOS.props            | 4 ++--
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Android.props b/osu.Android.props
index 82dec74855..ff6499631d 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -52,7 +52,7 @@
   </ItemGroup>
   <ItemGroup>
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.422.0" />
-    <PackageReference Include="ppy.osu.Framework.Android" Version="2022.423.0" />
+    <PackageReference Include="ppy.osu.Framework.Android" Version="2022.428.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
     <!-- Realm needs to be directly referenced in all Xamarin projects, as it will not pull in its transitive dependencies otherwise. -->
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 325e834fa5..26891ad978 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="10.10.0" />
-    <PackageReference Include="ppy.osu.Framework" Version="2022.423.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2022.428.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.422.0" />
     <PackageReference Include="Sentry" Version="3.14.1" />
     <PackageReference Include="SharpCompress" Version="0.30.1" />
diff --git a/osu.iOS.props b/osu.iOS.props
index 8775442be2..d261e13ade 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -61,7 +61,7 @@
     <Reference Include="System.Net.Http" />
   </ItemGroup>
   <ItemGroup Label="Package References">
-    <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.423.0" />
+    <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.428.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.422.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net6.0) -->
@@ -84,7 +84,7 @@
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="5.0.14" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.Core" Version="5.0.14" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
-    <PackageReference Include="ppy.osu.Framework" Version="2022.423.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2022.428.0" />
     <PackageReference Include="SharpCompress" Version="0.30.1" />
     <PackageReference Include="NUnit" Version="3.13.2" />
     <PackageReference Include="System.ComponentModel.Annotations" Version="5.0.0" />

From c8665dc93b40835dd08687c51ec4384354e83584 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 28 Apr 2022 11:12:50 +0300
Subject: [PATCH 4356/5547] Update `TimeSpan` localisation to use
 `ToLocalisableString`

---
 osu.Game/Extensions/TimeDisplayExtensions.cs | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Extensions/TimeDisplayExtensions.cs b/osu.Game/Extensions/TimeDisplayExtensions.cs
index 54af6a5942..98633958ee 100644
--- a/osu.Game/Extensions/TimeDisplayExtensions.cs
+++ b/osu.Game/Extensions/TimeDisplayExtensions.cs
@@ -3,6 +3,7 @@
 
 using System;
 using Humanizer;
+using osu.Framework.Extensions.LocalisationExtensions;
 using osu.Framework.Localisation;
 using osu.Game.Resources.Localisation.Web;
 
@@ -42,12 +43,12 @@ namespace osu.Game.Extensions
         public static LocalisableString ToFormattedDuration(this TimeSpan timeSpan)
         {
             if (timeSpan.TotalDays >= 1)
-                return new LocalisableFormattableString(timeSpan, @"dd\:hh\:mm\:ss");
+                return timeSpan.ToLocalisableString(@"dd\:hh\:mm\:ss");
 
             if (timeSpan.TotalHours >= 1)
-                return new LocalisableFormattableString(timeSpan, @"hh\:mm\:ss");
+                return timeSpan.ToLocalisableString(@"hh\:mm\:ss");
 
-            return new LocalisableFormattableString(timeSpan, @"mm\:ss");
+            return timeSpan.ToLocalisableString(@"mm\:ss");
         }
 
         /// <summary>

From be2d616e345e7e37ff5698b1b57c435209874d83 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 28 Apr 2022 11:19:30 +0300
Subject: [PATCH 4357/5547] Fix localisation use cases not falling back to
 `default(LocalisableString)`

Previously such use cases have been returning `null` values just fine since `GetLocalisableString` was returning `LocalisableFormattableString`, and these null values were wrapped in `LocalisableString`s implicitly, therefore not requiring an explicit fallback string and `null` doesn't break anything.
---
 .../Overlays/BeatmapSet/Scores/TopScoreStatisticsSection.cs    | 2 +-
 .../Overlays/Profile/Header/Components/LevelProgressBar.cs     | 2 +-
 osu.Game/Overlays/Rankings/SpotlightSelector.cs                | 2 +-
 osu.Game/Overlays/Rankings/Tables/PerformanceTable.cs          | 3 ++-
 4 files changed, 5 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Overlays/BeatmapSet/Scores/TopScoreStatisticsSection.cs b/osu.Game/Overlays/BeatmapSet/Scores/TopScoreStatisticsSection.cs
index ec795cf6b2..9ee002fd9d 100644
--- a/osu.Game/Overlays/BeatmapSet/Scores/TopScoreStatisticsSection.cs
+++ b/osu.Game/Overlays/BeatmapSet/Scores/TopScoreStatisticsSection.cs
@@ -119,7 +119,7 @@ namespace osu.Game.Overlays.BeatmapSet.Scores
                 maxComboColumn.Text = value.MaxCombo.ToLocalisableString(@"0\x");
 
                 ppColumn.Alpha = value.BeatmapInfo.Status.GrantsPerformancePoints() ? 1 : 0;
-                ppColumn.Text = value.PP?.ToLocalisableString(@"N0");
+                ppColumn.Text = value.PP?.ToLocalisableString(@"N0") ?? default(LocalisableString);
 
                 statisticsColumns.ChildrenEnumerable = value.GetStatisticsForDisplay().Select(createStatisticsColumn);
                 modsColumn.Mods = value.Mods;
diff --git a/osu.Game/Overlays/Profile/Header/Components/LevelProgressBar.cs b/osu.Game/Overlays/Profile/Header/Components/LevelProgressBar.cs
index 8f6b935128..ec9cb55042 100644
--- a/osu.Game/Overlays/Profile/Header/Components/LevelProgressBar.cs
+++ b/osu.Game/Overlays/Profile/Header/Components/LevelProgressBar.cs
@@ -62,7 +62,7 @@ namespace osu.Game.Overlays.Profile.Header.Components
         private void updateProgress(APIUser user)
         {
             levelProgressBar.Length = user?.Statistics?.Level.Progress / 100f ?? 0;
-            levelProgressText.Text = user?.Statistics?.Level.Progress.ToLocalisableString("0'%'");
+            levelProgressText.Text = user?.Statistics?.Level.Progress.ToLocalisableString("0'%'") ?? default(LocalisableString);
         }
     }
 }
diff --git a/osu.Game/Overlays/Rankings/SpotlightSelector.cs b/osu.Game/Overlays/Rankings/SpotlightSelector.cs
index dfa45cc543..48a4c31f30 100644
--- a/osu.Game/Overlays/Rankings/SpotlightSelector.cs
+++ b/osu.Game/Overlays/Rankings/SpotlightSelector.cs
@@ -126,7 +126,7 @@ namespace osu.Game.Overlays.Rankings
             startDateColumn.Value = dateToString(response.Spotlight.StartDate);
             endDateColumn.Value = dateToString(response.Spotlight.EndDate);
             mapCountColumn.Value = response.BeatmapSets.Count.ToLocalisableString(@"N0");
-            participantsColumn.Value = response.Spotlight.Participants?.ToLocalisableString(@"N0");
+            participantsColumn.Value = response.Spotlight.Participants?.ToLocalisableString(@"N0") ?? default(LocalisableString);
         }
 
         private LocalisableString dateToString(DateTimeOffset date) => date.ToLocalisableString(@"yyyy-MM-dd");
diff --git a/osu.Game/Overlays/Rankings/Tables/PerformanceTable.cs b/osu.Game/Overlays/Rankings/Tables/PerformanceTable.cs
index 17c17b1f1a..bdbd2942d1 100644
--- a/osu.Game/Overlays/Rankings/Tables/PerformanceTable.cs
+++ b/osu.Game/Overlays/Rankings/Tables/PerformanceTable.cs
@@ -5,6 +5,7 @@ using System.Collections.Generic;
 using osu.Framework.Extensions.LocalisationExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
+using osu.Framework.Localisation;
 using osu.Game.Resources.Localisation.Web;
 using osu.Game.Users;
 
@@ -24,7 +25,7 @@ namespace osu.Game.Overlays.Rankings.Tables
 
         protected override Drawable[] CreateUniqueContent(UserStatistics item) => new Drawable[]
         {
-            new RowText { Text = item.PP?.ToLocalisableString(@"N0"), }
+            new RowText { Text = item.PP?.ToLocalisableString(@"N0") ?? default(LocalisableString), }
         };
     }
 }

From 92cac0b74e67616aec5845d11c9adb7deb3d6b2a Mon Sep 17 00:00:00 2001
From: Jamie Taylor <me@nekodex.net>
Date: Thu, 28 Apr 2022 17:30:24 +0900
Subject: [PATCH 4358/5547] Fix TabControls using the wrong sample

---
 .../BeatmapListing/BeatmapListingCardSizeTabControl.cs         | 3 ++-
 osu.Game/Overlays/OverlaySortTabControl.cs                     | 2 +-
 2 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Overlays/BeatmapListing/BeatmapListingCardSizeTabControl.cs b/osu.Game/Overlays/BeatmapListing/BeatmapListingCardSizeTabControl.cs
index e4fda9d9c3..1f9a63e3b9 100644
--- a/osu.Game/Overlays/BeatmapListing/BeatmapListingCardSizeTabControl.cs
+++ b/osu.Game/Overlays/BeatmapListing/BeatmapListingCardSizeTabControl.cs
@@ -72,7 +72,8 @@ namespace osu.Game.Overlays.BeatmapListing
                             Size = new Vector2(12),
                             Icon = getIconForCardSize(Value)
                         }
-                    }
+                    },
+                    new HoverClickSounds(HoverSampleSet.TabSelect)
                 };
             }
 
diff --git a/osu.Game/Overlays/OverlaySortTabControl.cs b/osu.Game/Overlays/OverlaySortTabControl.cs
index d4dde0db3f..5f5cfce344 100644
--- a/osu.Game/Overlays/OverlaySortTabControl.cs
+++ b/osu.Game/Overlays/OverlaySortTabControl.cs
@@ -149,7 +149,7 @@ namespace osu.Game.Overlays
                     }
                 });
 
-                AddInternal(new HoverClickSounds());
+                AddInternal(new HoverClickSounds(HoverSampleSet.TabSelect));
             }
 
             protected override void LoadComplete()

From 37816ebc41abc2679c667a848865382872aa01b2 Mon Sep 17 00:00:00 2001
From: Jamie Taylor <me@nekodex.net>
Date: Thu, 28 Apr 2022 17:33:51 +0900
Subject: [PATCH 4359/5547] Add audio feedback to `SwitchButton` checkbox

---
 .../Graphics/UserInterfaceV2/SwitchButton.cs  | 20 ++++++++++++++++++-
 1 file changed, 19 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Graphics/UserInterfaceV2/SwitchButton.cs b/osu.Game/Graphics/UserInterfaceV2/SwitchButton.cs
index c6477d1781..f483e67b27 100644
--- a/osu.Game/Graphics/UserInterfaceV2/SwitchButton.cs
+++ b/osu.Game/Graphics/UserInterfaceV2/SwitchButton.cs
@@ -4,6 +4,8 @@
 #nullable enable
 
 using osu.Framework.Allocation;
+using osu.Framework.Audio;
+using osu.Framework.Audio.Sample;
 using osu.Framework.Bindables;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
@@ -31,6 +33,9 @@ namespace osu.Game.Graphics.UserInterfaceV2
         private Color4 enabledColour;
         private Color4 disabledColour;
 
+        private Sample? sampleChecked;
+        private Sample? sampleUnchecked;
+
         public SwitchButton()
         {
             Size = new Vector2(45, 20);
@@ -70,13 +75,16 @@ namespace osu.Game.Graphics.UserInterfaceV2
         }
 
         [BackgroundDependencyLoader(true)]
-        private void load(OverlayColourProvider? colourProvider, OsuColour colours)
+        private void load(OverlayColourProvider? colourProvider, OsuColour colours, AudioManager audio)
         {
             enabledColour = colourProvider?.Highlight1 ?? colours.BlueDark;
             disabledColour = colourProvider?.Background3 ?? colours.Gray3;
 
             switchContainer.Colour = enabledColour;
             fill.Colour = disabledColour;
+
+            sampleChecked = audio.Samples.Get(@"UI/check-on");
+            sampleUnchecked = audio.Samples.Get(@"UI/check-off");
         }
 
         protected override void LoadComplete()
@@ -107,6 +115,16 @@ namespace osu.Game.Graphics.UserInterfaceV2
             base.OnHoverLost(e);
         }
 
+        protected override void OnUserChange(bool value)
+        {
+            base.OnUserChange(value);
+
+            if (value)
+                sampleChecked?.Play();
+            else
+                sampleUnchecked?.Play();
+        }
+
         private void updateBorder()
         {
             circularContainer.TransformBorderTo((Current.Value ? enabledColour : disabledColour).Lighten(IsHovered ? 0.3f : 0));

From 691bec6f16845c94fa79ba26ff87372e988c43d3 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 28 Apr 2022 11:38:40 +0300
Subject: [PATCH 4360/5547] Use `LocalisableString.Interpolate` instead of
 invalid `TranslatableString`s

---
 osu.Game/Overlays/FirstRunSetupOverlay.cs                    | 4 ++--
 osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs | 4 ++--
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Overlays/FirstRunSetupOverlay.cs b/osu.Game/Overlays/FirstRunSetupOverlay.cs
index 27a057bf09..735de670e3 100644
--- a/osu.Game/Overlays/FirstRunSetupOverlay.cs
+++ b/osu.Game/Overlays/FirstRunSetupOverlay.cs
@@ -317,11 +317,11 @@ namespace osu.Game.Overlays
             }
             else
             {
-                BackButton.Text = new TranslatableString(@"_", @"{0} ({1})", CommonStrings.Back, steps[currentStepIndex.Value - 1].Description);
+                BackButton.Text = LocalisableString.Interpolate($@"{CommonStrings.Back} ({steps[currentStepIndex.Value - 1].Description})");
 
                 NextButton.Text = isLastStep
                     ? CommonStrings.Finish
-                    : new TranslatableString(@"_", @"{0} ({1})", CommonStrings.Next, steps[currentStepIndex.Value + 1].Description);
+                    : LocalisableString.Interpolate($@"{CommonStrings.Next} ({steps[currentStepIndex.Value + 1].Description})");
             }
         }
 
diff --git a/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs b/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
index 42091c521f..1662ca399f 100644
--- a/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
+++ b/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
@@ -99,8 +99,8 @@ namespace osu.Game.Screens.Play.PlayerSettings
             {
                 public override LocalisableString TooltipText =>
                     Current.Value == 0
-                        ? new TranslatableString("_", @"{0} ms", base.TooltipText)
-                        : new TranslatableString("_", @"{0} ms {1}", base.TooltipText, getEarlyLateText(Current.Value));
+                        ? LocalisableString.Interpolate($@"{base.TooltipText} ms")
+                        : LocalisableString.Interpolate($@"{base.TooltipText} ms {getEarlyLateText(Current.Value)}");
 
                 private LocalisableString getEarlyLateText(double value)
                 {

From 93db6c6bb0a82b85cf1a4429bcf8e7ff165bc75f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 28 Apr 2022 17:46:00 +0900
Subject: [PATCH 4361/5547] Move `FastRandom` to `LegacyRandom` in `osu.Game`
 project

---
 .../Beatmaps/CatchBeatmapProcessor.cs         |  8 +-
 .../Beatmaps/ManiaBeatmapConverter.cs         |  8 +-
 .../Legacy/DistanceObjectPatternGenerator.cs  |  4 +-
 .../Legacy/EndTimeObjectPatternGenerator.cs   |  4 +-
 .../Legacy/HitObjectPatternGenerator.cs       |  4 +-
 .../Patterns/Legacy/PatternGenerator.cs       |  6 +-
 .../MathUtils/FastRandom.cs                   | 95 -------------------
 .../Utils/LegacyRandom.cs                     | 37 +++++---
 8 files changed, 40 insertions(+), 126 deletions(-)
 delete mode 100644 osu.Game.Rulesets.Mania/MathUtils/FastRandom.cs
 rename osu.Game.Rulesets.Catch/MathUtils/FastRandom.cs => osu.Game/Utils/LegacyRandom.cs (79%)

diff --git a/osu.Game.Rulesets.Catch/Beatmaps/CatchBeatmapProcessor.cs b/osu.Game.Rulesets.Catch/Beatmaps/CatchBeatmapProcessor.cs
index 346a09cac8..ab61b14ac4 100644
--- a/osu.Game.Rulesets.Catch/Beatmaps/CatchBeatmapProcessor.cs
+++ b/osu.Game.Rulesets.Catch/Beatmaps/CatchBeatmapProcessor.cs
@@ -5,10 +5,10 @@ using System;
 using System.Collections.Generic;
 using System.Linq;
 using osu.Game.Beatmaps;
-using osu.Game.Rulesets.Catch.MathUtils;
 using osu.Game.Rulesets.Catch.Objects;
 using osu.Game.Rulesets.Catch.UI;
 using osu.Game.Rulesets.Objects.Types;
+using osu.Game.Utils;
 
 namespace osu.Game.Rulesets.Catch.Beatmaps
 {
@@ -46,7 +46,7 @@ namespace osu.Game.Rulesets.Catch.Beatmaps
 
         public void ApplyPositionOffsets(IBeatmap beatmap)
         {
-            var rng = new FastRandom(RNG_SEED);
+            var rng = new LegacyRandom(RNG_SEED);
 
             float? lastPosition = null;
             double lastStartTime = 0;
@@ -98,7 +98,7 @@ namespace osu.Game.Rulesets.Catch.Beatmaps
             initialiseHyperDash(beatmap);
         }
 
-        private static void applyHardRockOffset(CatchHitObject hitObject, ref float? lastPosition, ref double lastStartTime, FastRandom rng)
+        private static void applyHardRockOffset(CatchHitObject hitObject, ref float? lastPosition, ref double lastStartTime, LegacyRandom rng)
         {
             float offsetPosition = hitObject.OriginalX;
             double startTime = hitObject.StartTime;
@@ -146,7 +146,7 @@ namespace osu.Game.Rulesets.Catch.Beatmaps
         /// <param name="position">The position which the offset should be applied to.</param>
         /// <param name="maxOffset">The maximum offset, cannot exceed 20px.</param>
         /// <param name="rng">The random number generator.</param>
-        private static void applyRandomOffset(ref float position, double maxOffset, FastRandom rng)
+        private static void applyRandomOffset(ref float position, double maxOffset, LegacyRandom rng)
         {
             bool right = rng.NextBool();
             float rand = Math.Min(20, (float)rng.Next(0, Math.Max(0, maxOffset)));
diff --git a/osu.Game.Rulesets.Mania/Beatmaps/ManiaBeatmapConverter.cs b/osu.Game.Rulesets.Mania/Beatmaps/ManiaBeatmapConverter.cs
index 47e0e6d7b1..207c6907c8 100644
--- a/osu.Game.Rulesets.Mania/Beatmaps/ManiaBeatmapConverter.cs
+++ b/osu.Game.Rulesets.Mania/Beatmaps/ManiaBeatmapConverter.cs
@@ -11,8 +11,8 @@ using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Objects.Types;
 using osu.Game.Rulesets.Mania.Beatmaps.Patterns;
-using osu.Game.Rulesets.Mania.MathUtils;
 using osu.Game.Rulesets.Mania.Beatmaps.Patterns.Legacy;
+using osu.Game.Utils;
 using osuTK;
 
 namespace osu.Game.Rulesets.Mania.Beatmaps
@@ -31,7 +31,7 @@ namespace osu.Game.Rulesets.Mania.Beatmaps
         private readonly int originalTargetColumns;
 
         // Internal for testing purposes
-        internal FastRandom Random { get; private set; }
+        internal LegacyRandom Random { get; private set; }
 
         private Pattern lastPattern = new Pattern();
 
@@ -84,7 +84,7 @@ namespace osu.Game.Rulesets.Mania.Beatmaps
             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 FastRandom(seed);
+            Random = new LegacyRandom(seed);
 
             return base.ConvertBeatmap(original, cancellationToken);
         }
@@ -227,7 +227,7 @@ namespace osu.Game.Rulesets.Mania.Beatmaps
         /// </summary>
         private class SpecificBeatmapPatternGenerator : Patterns.Legacy.PatternGenerator
         {
-            public SpecificBeatmapPatternGenerator(FastRandom random, HitObject hitObject, ManiaBeatmap beatmap, Pattern previousPattern, IBeatmap originalBeatmap)
+            public SpecificBeatmapPatternGenerator(LegacyRandom random, HitObject hitObject, ManiaBeatmap beatmap, Pattern previousPattern, IBeatmap originalBeatmap)
                 : base(random, hitObject, beatmap, previousPattern, originalBeatmap)
             {
             }
diff --git a/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Legacy/DistanceObjectPatternGenerator.cs b/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Legacy/DistanceObjectPatternGenerator.cs
index 5f8b58d94d..dafe65f415 100644
--- a/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Legacy/DistanceObjectPatternGenerator.cs
+++ b/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Legacy/DistanceObjectPatternGenerator.cs
@@ -8,12 +8,12 @@ using System.Linq;
 using osu.Framework.Extensions.EnumExtensions;
 using osu.Game.Audio;
 using osu.Game.Beatmaps;
-using osu.Game.Rulesets.Mania.MathUtils;
 using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Objects.Types;
 using osu.Game.Rulesets.Mania.Objects;
 using osu.Game.Beatmaps.ControlPoints;
 using osu.Game.Beatmaps.Formats;
+using osu.Game.Utils;
 
 namespace osu.Game.Rulesets.Mania.Beatmaps.Patterns.Legacy
 {
@@ -34,7 +34,7 @@ namespace osu.Game.Rulesets.Mania.Beatmaps.Patterns.Legacy
 
         private PatternType convertType;
 
-        public DistanceObjectPatternGenerator(FastRandom random, HitObject hitObject, ManiaBeatmap beatmap, Pattern previousPattern, IBeatmap originalBeatmap)
+        public DistanceObjectPatternGenerator(LegacyRandom random, HitObject hitObject, ManiaBeatmap beatmap, Pattern previousPattern, IBeatmap originalBeatmap)
             : base(random, hitObject, beatmap, previousPattern, originalBeatmap)
         {
             convertType = PatternType.None;
diff --git a/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Legacy/EndTimeObjectPatternGenerator.cs b/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Legacy/EndTimeObjectPatternGenerator.cs
index f816a70ab3..2265d3d347 100644
--- a/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Legacy/EndTimeObjectPatternGenerator.cs
+++ b/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Legacy/EndTimeObjectPatternGenerator.cs
@@ -2,13 +2,13 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System.Collections.Generic;
-using osu.Game.Rulesets.Mania.MathUtils;
 using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Objects.Types;
 using System.Linq;
 using osu.Game.Audio;
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Mania.Objects;
+using osu.Game.Utils;
 
 namespace osu.Game.Rulesets.Mania.Beatmaps.Patterns.Legacy
 {
@@ -17,7 +17,7 @@ namespace osu.Game.Rulesets.Mania.Beatmaps.Patterns.Legacy
         private readonly int endTime;
         private readonly PatternType convertType;
 
-        public EndTimeObjectPatternGenerator(FastRandom random, HitObject hitObject, ManiaBeatmap beatmap, Pattern previousPattern, IBeatmap originalBeatmap)
+        public EndTimeObjectPatternGenerator(LegacyRandom random, HitObject hitObject, ManiaBeatmap beatmap, Pattern previousPattern, IBeatmap originalBeatmap)
             : base(random, hitObject, beatmap, previousPattern, originalBeatmap)
         {
             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 53b059b4e2..41d4c9322b 100644
--- a/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Legacy/HitObjectPatternGenerator.cs
+++ b/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Legacy/HitObjectPatternGenerator.cs
@@ -9,11 +9,11 @@ using osuTK;
 using osu.Game.Audio;
 using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.ControlPoints;
-using osu.Game.Rulesets.Mania.MathUtils;
 using osu.Game.Rulesets.Mania.Objects;
 using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Objects.Types;
 using osu.Framework.Extensions.IEnumerableExtensions;
+using osu.Game.Utils;
 
 namespace osu.Game.Rulesets.Mania.Beatmaps.Patterns.Legacy
 {
@@ -23,7 +23,7 @@ namespace osu.Game.Rulesets.Mania.Beatmaps.Patterns.Legacy
 
         private readonly PatternType convertType;
 
-        public HitObjectPatternGenerator(FastRandom random, HitObject hitObject, ManiaBeatmap beatmap, Pattern previousPattern, double previousTime, Vector2 previousPosition, double density,
+        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)
         {
diff --git a/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Legacy/PatternGenerator.cs b/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Legacy/PatternGenerator.cs
index eaf0ea0f2b..d5689c047a 100644
--- a/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Legacy/PatternGenerator.cs
+++ b/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Legacy/PatternGenerator.cs
@@ -5,8 +5,8 @@ using System;
 using System.Linq;
 using JetBrains.Annotations;
 using osu.Game.Beatmaps;
-using osu.Game.Rulesets.Mania.MathUtils;
 using osu.Game.Rulesets.Objects;
+using osu.Game.Utils;
 
 namespace osu.Game.Rulesets.Mania.Beatmaps.Patterns.Legacy
 {
@@ -23,14 +23,14 @@ namespace osu.Game.Rulesets.Mania.Beatmaps.Patterns.Legacy
         /// <summary>
         /// The random number generator to use.
         /// </summary>
-        protected readonly FastRandom Random;
+        protected readonly LegacyRandom Random;
 
         /// <summary>
         /// The beatmap which <see cref="HitObject"/> is being converted from.
         /// </summary>
         protected readonly IBeatmap OriginalBeatmap;
 
-        protected PatternGenerator(FastRandom random, HitObject hitObject, ManiaBeatmap beatmap, Pattern previousPattern, IBeatmap originalBeatmap)
+        protected PatternGenerator(LegacyRandom random, HitObject hitObject, ManiaBeatmap beatmap, Pattern previousPattern, IBeatmap originalBeatmap)
             : base(hitObject, beatmap, previousPattern)
         {
             if (random == null) throw new ArgumentNullException(nameof(random));
diff --git a/osu.Game.Rulesets.Mania/MathUtils/FastRandom.cs b/osu.Game.Rulesets.Mania/MathUtils/FastRandom.cs
deleted file mode 100644
index a9cd7f2476..0000000000
--- a/osu.Game.Rulesets.Mania/MathUtils/FastRandom.cs
+++ /dev/null
@@ -1,95 +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.Rulesets.Mania.MathUtils
-{
-    /// <summary>
-    /// A PRNG specified in http://heliosphan.org/fastrandom.html.
-    /// </summary>
-    internal class FastRandom
-    {
-        private const double int_to_real = 1.0 / (int.MaxValue + 1.0);
-        private const uint int_mask = 0x7FFFFFFF;
-        private const uint y = 842502087;
-        private const uint z = 3579807591;
-        private const uint w = 273326509;
-
-        internal uint X { get; private set; }
-        internal uint Y { get; private set; } = y;
-        internal uint Z { get; private set; } = z;
-        internal uint W { get; private set; } = w;
-
-        public FastRandom(int seed)
-        {
-            X = (uint)seed;
-        }
-
-        public FastRandom()
-            : this(Environment.TickCount)
-        {
-        }
-
-        /// <summary>
-        /// Generates a random unsigned integer within the range [<see cref="uint.MinValue"/>, <see cref="uint.MaxValue"/>).
-        /// </summary>
-        /// <returns>The random value.</returns>
-        public uint NextUInt()
-        {
-            uint t = X ^ (X << 11);
-            X = Y;
-            Y = Z;
-            Z = W;
-            return W = W ^ (W >> 19) ^ t ^ (t >> 8);
-        }
-
-        /// <summary>
-        /// Generates a random integer value within the range [0, <see cref="int.MaxValue"/>).
-        /// </summary>
-        /// <returns>The random value.</returns>
-        public int Next() => (int)(int_mask & NextUInt());
-
-        /// <summary>
-        /// Generates a random integer value within the range [0, <paramref name="upperBound"/>).
-        /// </summary>
-        /// <param name="upperBound">The upper bound.</param>
-        /// <returns>The random value.</returns>
-        public int Next(int upperBound) => (int)(NextDouble() * upperBound);
-
-        /// <summary>
-        /// Generates a random integer value within the range [<paramref name="lowerBound"/>, <paramref name="upperBound"/>).
-        /// </summary>
-        /// <param name="lowerBound">The lower bound of the range.</param>
-        /// <param name="upperBound">The upper bound of the range.</param>
-        /// <returns>The random value.</returns>
-        public int Next(int lowerBound, int upperBound) => (int)(lowerBound + NextDouble() * (upperBound - lowerBound));
-
-        /// <summary>
-        /// Generates a random double value within the range [0, 1).
-        /// </summary>
-        /// <returns>The random value.</returns>
-        public double NextDouble() => int_to_real * Next();
-
-        private uint bitBuffer;
-        private int bitIndex = 32;
-
-        /// <summary>
-        /// Generates a reandom boolean value. Cached such that a random value is only generated once in every 32 calls.
-        /// </summary>
-        /// <returns>The random value.</returns>
-        public bool NextBool()
-        {
-            if (bitIndex == 32)
-            {
-                bitBuffer = NextUInt();
-                bitIndex = 1;
-
-                return (bitBuffer & 1) == 1;
-            }
-
-            bitIndex++;
-            return ((bitBuffer >>= 1) & 1) == 1;
-        }
-    }
-}
diff --git a/osu.Game.Rulesets.Catch/MathUtils/FastRandom.cs b/osu.Game/Utils/LegacyRandom.cs
similarity index 79%
rename from osu.Game.Rulesets.Catch/MathUtils/FastRandom.cs
rename to osu.Game/Utils/LegacyRandom.cs
index 46e427e1b7..cf731aa91f 100644
--- a/osu.Game.Rulesets.Catch/MathUtils/FastRandom.cs
+++ b/osu.Game/Utils/LegacyRandom.cs
@@ -2,27 +2,36 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
+using osu.Framework.Utils;
 
-namespace osu.Game.Rulesets.Catch.MathUtils
+namespace osu.Game.Utils
 {
     /// <summary>
     /// A PRNG specified in http://heliosphan.org/fastrandom.html.
+    /// Should only be used to match legacy behaviour. See <see cref="RNG"/> for a newer alternative.
     /// </summary>
-    public class FastRandom
+    /// <remarks>
+    /// Known in osu-stable code as `FastRandom`.
+    /// </remarks>
+    public class LegacyRandom
     {
         private const double int_to_real = 1.0 / (int.MaxValue + 1.0);
         private const uint int_mask = 0x7FFFFFFF;
-        private const uint y_initial = 842502087;
-        private const uint z_initial = 3579807591;
-        private const uint w_initial = 273326509;
-        private uint x, y = y_initial, z = z_initial, w = w_initial;
+        private const uint y = 842502087;
+        private const uint z = 3579807591;
+        private const uint w = 273326509;
 
-        public FastRandom(int seed)
+        public uint X { get; private set; }
+        public uint Y { get; private set; } = y;
+        public uint Z { get; private set; } = z;
+        public uint W { get; private set; } = w;
+
+        public LegacyRandom(int seed)
         {
-            x = (uint)seed;
+            X = (uint)seed;
         }
 
-        public FastRandom()
+        public LegacyRandom()
             : this(Environment.TickCount)
         {
         }
@@ -33,11 +42,11 @@ namespace osu.Game.Rulesets.Catch.MathUtils
         /// <returns>The random value.</returns>
         public uint NextUInt()
         {
-            uint t = x ^ (x << 11);
-            x = y;
-            y = z;
-            z = w;
-            return w = w ^ (w >> 19) ^ t ^ (t >> 8);
+            uint t = X ^ (X << 11);
+            X = Y;
+            Y = Z;
+            Z = W;
+            return W = W ^ (W >> 19) ^ t ^ (t >> 8);
         }
 
         /// <summary>

From d052321eee722155c2635560819b60a3a8a41089 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 28 Apr 2022 12:11:06 +0300
Subject: [PATCH 4362/5547] Revert "Fix context menus not working"

This reverts commit 51aa17eb524e70899f09c1058842e0d55f58109b.
---
 osu.Game/Graphics/UserInterface/OsuDropdown.cs | 18 +-----------------
 osu.Game/Graphics/UserInterface/OsuMenu.cs     | 18 +-----------------
 2 files changed, 2 insertions(+), 34 deletions(-)

diff --git a/osu.Game/Graphics/UserInterface/OsuDropdown.cs b/osu.Game/Graphics/UserInterface/OsuDropdown.cs
index 20fa7d5148..b1d4691938 100644
--- a/osu.Game/Graphics/UserInterface/OsuDropdown.cs
+++ b/osu.Game/Graphics/UserInterface/OsuDropdown.cs
@@ -12,7 +12,6 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Graphics.UserInterface;
-using osu.Framework.Input.Events;
 using osu.Framework.Localisation;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
@@ -131,22 +130,7 @@ namespace osu.Game.Graphics.UserInterface
                 BackgroundColourSelected = SelectionColour
             };
 
-            protected override ScrollContainer<Drawable> CreateScrollContainer(Direction direction) => new DropdownScrollContainer(direction);
-
-            // Hotfix for https://github.com/ppy/osu/issues/17961
-            public class DropdownScrollContainer : OsuScrollContainer
-            {
-                public DropdownScrollContainer(Direction direction)
-                    : base(direction)
-                {
-                }
-
-                protected override bool OnMouseDown(MouseDownEvent e)
-                {
-                    base.OnMouseDown(e);
-                    return true;
-                }
-            }
+            protected override ScrollContainer<Drawable> CreateScrollContainer(Direction direction) => new OsuScrollContainer(direction);
 
             #region DrawableOsuDropdownMenuItem
 
diff --git a/osu.Game/Graphics/UserInterface/OsuMenu.cs b/osu.Game/Graphics/UserInterface/OsuMenu.cs
index bfdfd32fb3..a16adcbd57 100644
--- a/osu.Game/Graphics/UserInterface/OsuMenu.cs
+++ b/osu.Game/Graphics/UserInterface/OsuMenu.cs
@@ -9,7 +9,6 @@ using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.UserInterface;
-using osu.Framework.Input.Events;
 using osu.Game.Graphics.Containers;
 using osuTK;
 
@@ -82,22 +81,7 @@ namespace osu.Game.Graphics.UserInterface
             return new DrawableOsuMenuItem(item);
         }
 
-        protected override ScrollContainer<Drawable> CreateScrollContainer(Direction direction) => new OsuMenuScrollContainer(direction);
-
-        // Hotfix for https://github.com/ppy/osu/issues/17961
-        public class OsuMenuScrollContainer : OsuScrollContainer
-        {
-            public OsuMenuScrollContainer(Direction direction)
-                : base(direction)
-            {
-            }
-
-            protected override bool OnMouseDown(MouseDownEvent e)
-            {
-                base.OnMouseDown(e);
-                return true;
-            }
-        }
+        protected override ScrollContainer<Drawable> CreateScrollContainer(Direction direction) => new OsuScrollContainer(direction);
 
         protected override Menu CreateSubMenu() => new OsuMenu(Direction.Vertical)
         {

From 99d2d7b80592777fbde57bca6aab8f8d2b49fdcb Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 27 Apr 2022 18:57:10 +0900
Subject: [PATCH 4363/5547] Add very basic implementation of bundled beatmap
 downloader

---
 .../TestSceneBundledBeatmapDownloader.cs      |  24 ++
 .../Drawables/BundledBeatmapDownloader.cs     | 227 ++++++++++++++++++
 2 files changed, 251 insertions(+)
 create mode 100644 osu.Game.Tests/Visual/Online/TestSceneBundledBeatmapDownloader.cs
 create mode 100644 osu.Game/Beatmaps/Drawables/BundledBeatmapDownloader.cs

diff --git a/osu.Game.Tests/Visual/Online/TestSceneBundledBeatmapDownloader.cs b/osu.Game.Tests/Visual/Online/TestSceneBundledBeatmapDownloader.cs
new file mode 100644
index 0000000000..895524e79a
--- /dev/null
+++ b/osu.Game.Tests/Visual/Online/TestSceneBundledBeatmapDownloader.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 NUnit.Framework;
+using osu.Game.Beatmaps.Drawables;
+
+namespace osu.Game.Tests.Visual.Online
+{
+    [Ignore("Only for visual testing")]
+    public class TestSceneBundledBeatmapDownloader : OsuTestScene
+    {
+        private BundledBeatmapDownloader downloader;
+
+        [Test]
+        public void TestDownloader()
+        {
+            AddStep("Create downloader", () =>
+            {
+                downloader?.Expire();
+                Add(downloader = new BundledBeatmapDownloader());
+            });
+        }
+    }
+}
diff --git a/osu.Game/Beatmaps/Drawables/BundledBeatmapDownloader.cs b/osu.Game/Beatmaps/Drawables/BundledBeatmapDownloader.cs
new file mode 100644
index 0000000000..6b14ed760d
--- /dev/null
+++ b/osu.Game/Beatmaps/Drawables/BundledBeatmapDownloader.cs
@@ -0,0 +1,227 @@
+// 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 System.Text.RegularExpressions;
+using osu.Framework.Allocation;
+using osu.Framework.Graphics.Containers;
+using osu.Framework.Utils;
+using osu.Game.Online.API.Requests.Responses;
+
+namespace osu.Game.Beatmaps.Drawables
+{
+    public class BundledBeatmapDownloader : CompositeDrawable
+    {
+        [Resolved]
+        private BeatmapModelDownloader beatmapDownloader { get; set; }
+
+        [BackgroundDependencyLoader]
+        private void load()
+        {
+            foreach (string filename in bundled_beatmap_filenames.OrderBy(_ => RNG.NextSingle()).Take(10))
+            {
+                var match = Regex.Match(filename, @"([0-9]*) (.*) - (.*)\.osz");
+
+                beatmapDownloader.Download(new APIBeatmapSet
+                {
+                    OnlineID = int.Parse(match.Groups[1].Value),
+                    Artist = match.Groups[2].Value,
+                    Title = match.Groups[3].Value,
+                });
+            }
+        }
+
+        private static readonly string[] bundled_beatmap_filenames = new[]
+        {
+            "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",
+            "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",
+            "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",
+            "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",
+        };
+    }
+}

From b042f1cad55680e61d4656522b4b4cb500a9e05a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 27 Apr 2022 18:57:20 +0900
Subject: [PATCH 4364/5547] Add screen to perform bundled beatmap downloads

---
 .../FirstRunSetup/ScreenBundledBeatmaps.cs    | 47 +++++++++++++++++++
 osu.Game/Overlays/FirstRunSetupOverlay.cs     |  1 +
 2 files changed, 48 insertions(+)
 create mode 100644 osu.Game/Overlays/FirstRunSetup/ScreenBundledBeatmaps.cs

diff --git a/osu.Game/Overlays/FirstRunSetup/ScreenBundledBeatmaps.cs b/osu.Game/Overlays/FirstRunSetup/ScreenBundledBeatmaps.cs
new file mode 100644
index 0000000000..fae852860b
--- /dev/null
+++ b/osu.Game/Overlays/FirstRunSetup/ScreenBundledBeatmaps.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 System.ComponentModel;
+using osu.Framework.Allocation;
+using osu.Framework.Graphics;
+using osu.Game.Beatmaps.Drawables;
+using osu.Game.Graphics;
+using osu.Game.Graphics.Containers;
+using osu.Game.Graphics.UserInterface;
+
+namespace osu.Game.Overlays.FirstRunSetup
+{
+    [Description("Bundled Beatmaps")]
+    public class ScreenBundledBeatmaps : FirstRunSetupScreen
+    {
+        private TriangleButton downloadButton;
+
+        [BackgroundDependencyLoader]
+        private void load()
+        {
+            Content.Children = new Drawable[]
+            {
+                new OsuTextFlowContainer(cp => cp.Font = OsuFont.Default.With(size: 20))
+                {
+                    Text = "osu! doesn't come with any beatmaps pre-loaded. To get started, we have some recommended beatmaps.",
+                    RelativeSizeAxes = Axes.X,
+                    AutoSizeAxes = Axes.Y
+                },
+                downloadButton = new TriangleButton
+                {
+                    Width = 300,
+                    Anchor = Anchor.TopCentre,
+                    Origin = Anchor.TopCentre,
+                    Text = "Download beatmap selection",
+                    Action = download
+                }
+            };
+        }
+
+        private void download()
+        {
+            AddInternal(new BundledBeatmapDownloader());
+            downloadButton.Enabled.Value = false;
+        }
+    }
+}
diff --git a/osu.Game/Overlays/FirstRunSetupOverlay.cs b/osu.Game/Overlays/FirstRunSetupOverlay.cs
index 82158793a2..b43f14522e 100644
--- a/osu.Game/Overlays/FirstRunSetupOverlay.cs
+++ b/osu.Game/Overlays/FirstRunSetupOverlay.cs
@@ -60,6 +60,7 @@ namespace osu.Game.Overlays
         private readonly Type[] steps =
         {
             typeof(ScreenWelcome),
+            typeof(ScreenBundledBeatmaps),
             typeof(ScreenUIScale)
         };
 

From 973dd4bfa9eab3d7d7ee934ed4b02df0a6c940ff Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 27 Apr 2022 19:41:13 +0900
Subject: [PATCH 4365/5547] Add initial flow for download button / progress
 display

---
 .../Drawables/BundledBeatmapDownloader.cs     | 51 ++++++++++++++++---
 .../FirstRunSetup/ScreenBundledBeatmaps.cs    | 29 ++++++++++-
 2 files changed, 72 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Beatmaps/Drawables/BundledBeatmapDownloader.cs b/osu.Game/Beatmaps/Drawables/BundledBeatmapDownloader.cs
index 6b14ed760d..5937186705 100644
--- a/osu.Game/Beatmaps/Drawables/BundledBeatmapDownloader.cs
+++ b/osu.Game/Beatmaps/Drawables/BundledBeatmapDownloader.cs
@@ -1,37 +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.Linq;
 using System.Text.RegularExpressions;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Utils;
+using osu.Game.Database;
+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.Overlays;
 
 namespace osu.Game.Beatmaps.Drawables
 {
     public class BundledBeatmapDownloader : CompositeDrawable
     {
-        [Resolved]
-        private BeatmapModelDownloader beatmapDownloader { get; set; }
+        public IEnumerable<BeatmapDownloadTracker> DownloadTrackers => downloadTrackers;
+
+        private readonly List<BeatmapDownloadTracker> downloadTrackers = new List<BeatmapDownloadTracker>();
 
         [BackgroundDependencyLoader]
-        private void load()
+        private void load(BeatmapManager beatmapManager, IAPIProvider api, INotificationOverlay notifications)
         {
+            var beatmapDownloader = new BundledBeatmapModelDownloader(beatmapManager, api)
+            {
+                PostNotification = notifications.Post
+            };
+
             foreach (string filename in bundled_beatmap_filenames.OrderBy(_ => RNG.NextSingle()).Take(10))
             {
                 var match = Regex.Match(filename, @"([0-9]*) (.*) - (.*)\.osz");
 
-                beatmapDownloader.Download(new APIBeatmapSet
+                var beatmapSet = new APIBeatmapSet
                 {
                     OnlineID = int.Parse(match.Groups[1].Value),
                     Artist = match.Groups[2].Value,
                     Title = match.Groups[3].Value,
-                });
+                };
+
+                var beatmapDownloadTracker = new BeatmapDownloadTracker(beatmapSet);
+                downloadTrackers.Add(beatmapDownloadTracker);
+                AddInternal(beatmapDownloadTracker);
+
+                beatmapDownloader.Download(beatmapSet);
             }
         }
 
-        private static readonly string[] bundled_beatmap_filenames = new[]
+        private static readonly string[] bundled_beatmap_filenames =
         {
             "682286 Yuyoyuppe - Emerald Galaxy.osz",
             "682287 baker - For a Dead Girl+.osz",
@@ -223,5 +241,26 @@ namespace osu.Game.Beatmaps.Drawables
             "1009907 James Landino & Kabuki - Birdsong.osz",
             "1015169 Thaehan - Insert Coin.osz",
         };
+
+        private class BundledBeatmapModelDownloader : BeatmapModelDownloader
+        {
+            public BundledBeatmapModelDownloader(IModelImporter<BeatmapSetInfo> beatmapImporter, IAPIProvider api)
+                : base(beatmapImporter, api)
+            {
+            }
+
+            protected override ArchiveDownloadRequest<IBeatmapSetInfo> CreateDownloadRequest(IBeatmapSetInfo set, bool minimiseDownloadSize)
+                => new BundledBeatmapDownloadRequest(set, minimiseDownloadSize);
+
+            public class BundledBeatmapDownloadRequest : DownloadBeatmapSetRequest
+            {
+                protected override string Uri => $"https://assets.ppy.sh/client-resources/bundled/{Model.OnlineID}.osz";
+
+                public BundledBeatmapDownloadRequest(IBeatmapSetInfo beatmapSetInfo, bool minimiseDownloadSize)
+                    : base(beatmapSetInfo, minimiseDownloadSize)
+                {
+                }
+            }
+        }
     }
 }
diff --git a/osu.Game/Overlays/FirstRunSetup/ScreenBundledBeatmaps.cs b/osu.Game/Overlays/FirstRunSetup/ScreenBundledBeatmaps.cs
index fae852860b..97f429bcf2 100644
--- a/osu.Game/Overlays/FirstRunSetup/ScreenBundledBeatmaps.cs
+++ b/osu.Game/Overlays/FirstRunSetup/ScreenBundledBeatmaps.cs
@@ -2,12 +2,15 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System.ComponentModel;
+using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Game.Beatmaps.Drawables;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.UserInterface;
+using osu.Game.Online;
+using osuTK.Graphics;
 
 namespace osu.Game.Overlays.FirstRunSetup
 {
@@ -16,6 +19,9 @@ namespace osu.Game.Overlays.FirstRunSetup
     {
         private TriangleButton downloadButton;
 
+        private ProgressBar progressBar;
+        private BundledBeatmapDownloader downloader;
+
         [BackgroundDependencyLoader]
         private void load()
         {
@@ -34,14 +40,33 @@ namespace osu.Game.Overlays.FirstRunSetup
                     Origin = Anchor.TopCentre,
                     Text = "Download beatmap selection",
                     Action = download
-                }
+                },
             };
+
+            downloadButton.Add(progressBar = new ProgressBar(false)
+            {
+                RelativeSizeAxes = Axes.Both,
+                Blending = BlendingParameters.Additive,
+                FillColour = Color4.Aqua,
+                Alpha = 0.5f,
+                Depth = float.MinValue
+            });
         }
 
         private void download()
         {
-            AddInternal(new BundledBeatmapDownloader());
+            AddInternal(downloader = new BundledBeatmapDownloader());
             downloadButton.Enabled.Value = false;
+
+            foreach (var tracker in downloader.DownloadTrackers)
+                tracker.State.BindValueChanged(_ => updateProgress());
+        }
+
+        private void updateProgress()
+        {
+            double progress = (double)downloader.DownloadTrackers.Count(t => t.State.Value == DownloadState.LocallyAvailable) / downloader.DownloadTrackers.Count();
+
+            this.TransformBindableTo(progressBar.Current, progress, 1000, Easing.OutQuint);
         }
     }
 }

From b424d20f267b26104eca245cf1f3de926f29849b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 27 Apr 2022 20:18:46 +0900
Subject: [PATCH 4366/5547] Fix rounded buttons not allowing custom colour
 specifications

---
 osu.Game/Graphics/UserInterfaceV2/RoundedButton.cs | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Graphics/UserInterfaceV2/RoundedButton.cs b/osu.Game/Graphics/UserInterfaceV2/RoundedButton.cs
index 23ebc6e98d..f535a32b39 100644
--- a/osu.Game/Graphics/UserInterfaceV2/RoundedButton.cs
+++ b/osu.Game/Graphics/UserInterfaceV2/RoundedButton.cs
@@ -8,6 +8,7 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Overlays;
+using osuTK.Graphics;
 
 namespace osu.Game.Graphics.UserInterfaceV2
 {
@@ -28,7 +29,8 @@ namespace osu.Game.Graphics.UserInterfaceV2
         [BackgroundDependencyLoader(true)]
         private void load([CanBeNull] OverlayColourProvider overlayColourProvider, OsuColour colours)
         {
-            BackgroundColour = overlayColourProvider?.Highlight1 ?? colours.Blue3;
+            if (BackgroundColour == Color4.White)
+                BackgroundColour = overlayColourProvider?.Highlight1 ?? colours.Blue3;
         }
 
         protected override void LoadComplete()

From 58399a5113e9bc5906e529672fc917b19a33a187 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 27 Apr 2022 20:19:11 +0900
Subject: [PATCH 4367/5547] Add tutorial download support and improve the
 visuals "slightly"

---
 .../TestSceneBundledBeatmapDownloader.cs      |  2 +-
 .../Drawables/BundledBeatmapDownloader.cs     | 37 +++++--
 .../FirstRunSetup/ScreenBundledBeatmaps.cs    | 98 +++++++++++++++----
 3 files changed, 108 insertions(+), 29 deletions(-)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneBundledBeatmapDownloader.cs b/osu.Game.Tests/Visual/Online/TestSceneBundledBeatmapDownloader.cs
index 895524e79a..2af1c9a0f0 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneBundledBeatmapDownloader.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneBundledBeatmapDownloader.cs
@@ -17,7 +17,7 @@ namespace osu.Game.Tests.Visual.Online
             AddStep("Create downloader", () =>
             {
                 downloader?.Expire();
-                Add(downloader = new BundledBeatmapDownloader());
+                Add(downloader = new BundledBeatmapDownloader(false));
             });
         }
     }
diff --git a/osu.Game/Beatmaps/Drawables/BundledBeatmapDownloader.cs b/osu.Game/Beatmaps/Drawables/BundledBeatmapDownloader.cs
index 5937186705..0bdaaaca22 100644
--- a/osu.Game/Beatmaps/Drawables/BundledBeatmapDownloader.cs
+++ b/osu.Game/Beatmaps/Drawables/BundledBeatmapDownloader.cs
@@ -22,15 +22,34 @@ namespace osu.Game.Beatmaps.Drawables
 
         private readonly List<BeatmapDownloadTracker> downloadTrackers = new List<BeatmapDownloadTracker>();
 
-        [BackgroundDependencyLoader]
-        private void load(BeatmapManager beatmapManager, IAPIProvider api, INotificationOverlay notifications)
-        {
-            var beatmapDownloader = new BundledBeatmapModelDownloader(beatmapManager, api)
-            {
-                PostNotification = notifications.Post
-            };
+        private readonly List<string> downloadableFilenames = new List<string>();
 
-            foreach (string filename in bundled_beatmap_filenames.OrderBy(_ => RNG.NextSingle()).Take(10))
+        private BundledBeatmapModelDownloader beatmapDownloader;
+
+        public BundledBeatmapDownloader(bool onlyTutorial)
+        {
+            if (onlyTutorial)
+                downloadableFilenames.Add(tutorial_filename);
+            else
+                downloadableFilenames.AddRange(bundled_beatmap_filenames);
+        }
+
+        protected override IReadOnlyDependencyContainer CreateChildDependencies(IReadOnlyDependencyContainer parent)
+        {
+            var localDependencies = new DependencyContainer(base.CreateChildDependencies(parent));
+
+            localDependencies.CacheAs<BeatmapModelDownloader>(beatmapDownloader = new BundledBeatmapModelDownloader(parent.Get<BeatmapManager>(), parent.Get<IAPIProvider>())
+            {
+                PostNotification = parent.Get<INotificationOverlay>().Post
+            });
+
+            return localDependencies;
+        }
+
+        [BackgroundDependencyLoader]
+        private void load()
+        {
+            foreach (string filename in downloadableFilenames.OrderBy(_ => RNG.NextSingle()).Take(10))
             {
                 var match = Regex.Match(filename, @"([0-9]*) (.*) - (.*)\.osz");
 
@@ -49,6 +68,8 @@ namespace osu.Game.Beatmaps.Drawables
             }
         }
 
+        private const string tutorial_filename = "1011011 nekodex - new beginnings.osz";
+
         private static readonly string[] bundled_beatmap_filenames =
         {
             "682286 Yuyoyuppe - Emerald Galaxy.osz",
diff --git a/osu.Game/Overlays/FirstRunSetup/ScreenBundledBeatmaps.cs b/osu.Game/Overlays/FirstRunSetup/ScreenBundledBeatmaps.cs
index 97f429bcf2..518903e74b 100644
--- a/osu.Game/Overlays/FirstRunSetup/ScreenBundledBeatmaps.cs
+++ b/osu.Game/Overlays/FirstRunSetup/ScreenBundledBeatmaps.cs
@@ -9,64 +9,122 @@ using osu.Game.Beatmaps.Drawables;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.UserInterface;
+using osu.Game.Graphics.UserInterfaceV2;
 using osu.Game.Online;
-using osuTK.Graphics;
+using osuTK;
 
 namespace osu.Game.Overlays.FirstRunSetup
 {
     [Description("Bundled Beatmaps")]
     public class ScreenBundledBeatmaps : FirstRunSetupScreen
     {
-        private TriangleButton downloadButton;
+        private RoundedButton downloadBundledButton;
 
-        private ProgressBar progressBar;
-        private BundledBeatmapDownloader downloader;
+        private ProgressBar progressBarBundled;
+
+        private RoundedButton downloadTutorialButton;
+        private ProgressBar progressBarTutorial;
+
+        private BundledBeatmapDownloader tutorialDownloader;
+        private BundledBeatmapDownloader bundledDownloader;
 
         [BackgroundDependencyLoader]
-        private void load()
+        private void load(OsuColour colours)
         {
+            Vector2 buttonSize = new Vector2(500, 80);
+
             Content.Children = new Drawable[]
             {
                 new OsuTextFlowContainer(cp => cp.Font = OsuFont.Default.With(size: 20))
                 {
-                    Text = "osu! doesn't come with any beatmaps pre-loaded. To get started, we have some recommended beatmaps.",
+                    Text =
+                        "osu! doesn't come with any beatmaps pre-loaded. To get started, we have some recommended beatmaps. You can obtain more beatmaps from the main menu \"browse\" button at any time.",
                     RelativeSizeAxes = Axes.X,
                     AutoSizeAxes = Axes.Y
                 },
-                downloadButton = new TriangleButton
+                downloadTutorialButton = new RoundedButton
                 {
-                    Width = 300,
+                    Size = buttonSize,
                     Anchor = Anchor.TopCentre,
                     Origin = Anchor.TopCentre,
-                    Text = "Download beatmap selection",
-                    Action = download
+                    BackgroundColour = colours.Pink3,
+                    Text = "Download tutorial",
+                    Action = downloadTutorial
                 },
+                downloadBundledButton = new RoundedButton
+                {
+                    Size = buttonSize,
+                    Anchor = Anchor.TopCentre,
+                    Origin = Anchor.TopCentre,
+                    BackgroundColour = colours.Blue3,
+                    Text = "Download beatmap selection",
+                    Action = downloadBundled
+                },
+                // TODO: add stable import button if a stable install is detected.
             };
 
-            downloadButton.Add(progressBar = new ProgressBar(false)
+            downloadTutorialButton.Add(progressBarTutorial = new ProgressBar(false)
             {
                 RelativeSizeAxes = Axes.Both,
                 Blending = BlendingParameters.Additive,
-                FillColour = Color4.Aqua,
+                FillColour = downloadTutorialButton.BackgroundColour,
+                Alpha = 0.5f,
+                Depth = float.MinValue
+            });
+
+            downloadBundledButton.Add(progressBarBundled = new ProgressBar(false)
+            {
+                RelativeSizeAxes = Axes.Both,
+                Blending = BlendingParameters.Additive,
+                FillColour = downloadBundledButton.BackgroundColour,
                 Alpha = 0.5f,
                 Depth = float.MinValue
             });
         }
 
-        private void download()
+        private void downloadTutorial()
         {
-            AddInternal(downloader = new BundledBeatmapDownloader());
-            downloadButton.Enabled.Value = false;
+            if (tutorialDownloader != null)
+                return;
 
-            foreach (var tracker in downloader.DownloadTrackers)
-                tracker.State.BindValueChanged(_ => updateProgress());
+            tutorialDownloader = new BundledBeatmapDownloader(true);
+
+            AddInternal(tutorialDownloader);
+
+            var downloadTracker = tutorialDownloader.DownloadTrackers.First();
+
+            downloadTracker.Progress.BindValueChanged(progress =>
+            {
+                progressBarTutorial.Current.Value = progress.NewValue;
+
+                if (progress.NewValue == 1)
+                    downloadTutorialButton.Enabled.Value = false;
+            }, true);
         }
 
-        private void updateProgress()
+        private void downloadBundled()
         {
-            double progress = (double)downloader.DownloadTrackers.Count(t => t.State.Value == DownloadState.LocallyAvailable) / downloader.DownloadTrackers.Count();
+            if (bundledDownloader != null)
+                return;
 
-            this.TransformBindableTo(progressBar.Current, progress, 1000, Easing.OutQuint);
+            // downloadBundledButton.Enabled.Value = false;
+
+            bundledDownloader = new BundledBeatmapDownloader(false);
+
+            AddInternal(bundledDownloader);
+
+            foreach (var tracker in bundledDownloader.DownloadTrackers)
+                tracker.State.BindValueChanged(_ => updateProgress(), true);
+
+            void updateProgress()
+            {
+                double progress = (double)bundledDownloader.DownloadTrackers.Count(t => t.State.Value == DownloadState.LocallyAvailable) / bundledDownloader.DownloadTrackers.Count();
+
+                this.TransformBindableTo(progressBarBundled.Current, progress, 1000, Easing.OutQuint);
+
+                if (progress == 1)
+                    downloadBundledButton.Enabled.Value = false;
+            }
         }
     }
 }

From d0564657423632e9ae41978b085f85682054ba6b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 28 Apr 2022 16:08:32 +0900
Subject: [PATCH 4368/5547] Remove explicit dependency on
 `INotificationOverlay`

---
 osu.Game/Beatmaps/Drawables/BundledBeatmapDownloader.cs | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Beatmaps/Drawables/BundledBeatmapDownloader.cs b/osu.Game/Beatmaps/Drawables/BundledBeatmapDownloader.cs
index 0bdaaaca22..029bb37c18 100644
--- a/osu.Game/Beatmaps/Drawables/BundledBeatmapDownloader.cs
+++ b/osu.Game/Beatmaps/Drawables/BundledBeatmapDownloader.cs
@@ -38,10 +38,10 @@ namespace osu.Game.Beatmaps.Drawables
         {
             var localDependencies = new DependencyContainer(base.CreateChildDependencies(parent));
 
-            localDependencies.CacheAs<BeatmapModelDownloader>(beatmapDownloader = new BundledBeatmapModelDownloader(parent.Get<BeatmapManager>(), parent.Get<IAPIProvider>())
-            {
-                PostNotification = parent.Get<INotificationOverlay>().Post
-            });
+            localDependencies.CacheAs<BeatmapModelDownloader>(beatmapDownloader = new BundledBeatmapModelDownloader(parent.Get<BeatmapManager>(), parent.Get<IAPIProvider>()));
+
+            if (parent.Get<INotificationOverlay>() is INotificationOverlay notifications)
+                beatmapDownloader.PostNotification = notifications.Post;
 
             return localDependencies;
         }

From 3c0bdcaf3804717eb827bdbbcf579c6e8345143a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 28 Apr 2022 16:09:00 +0900
Subject: [PATCH 4369/5547] Rename screen, add tests and add stable import step

---
 .../TestSceneFirstRunScreenBundledBeatmaps.cs | 24 ++++++
 ...enBundledBeatmaps.cs => ScreenBeatmaps.cs} | 81 ++++++++++++++-----
 osu.Game/Overlays/FirstRunSetupOverlay.cs     |  2 +-
 3 files changed, 84 insertions(+), 23 deletions(-)
 create mode 100644 osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunScreenBundledBeatmaps.cs
 rename osu.Game/Overlays/FirstRunSetup/{ScreenBundledBeatmaps.cs => ScreenBeatmaps.cs} (52%)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunScreenBundledBeatmaps.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunScreenBundledBeatmaps.cs
new file mode 100644
index 0000000000..51065939f0
--- /dev/null
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunScreenBundledBeatmaps.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.Allocation;
+using osu.Framework.Screens;
+using osu.Game.Overlays;
+using osu.Game.Overlays.FirstRunSetup;
+
+namespace osu.Game.Tests.Visual.UserInterface
+{
+    public class TestSceneFirstRunScreenBundledBeatmaps : OsuManualInputManagerTestScene
+    {
+        [Cached]
+        private OverlayColourProvider colourProvider = new OverlayColourProvider(OverlayColourScheme.Purple);
+
+        public TestSceneFirstRunScreenBundledBeatmaps()
+        {
+            AddStep("load screen", () =>
+            {
+                Child = new ScreenStack(new ScreenBeatmaps());
+            });
+        }
+    }
+}
diff --git a/osu.Game/Overlays/FirstRunSetup/ScreenBundledBeatmaps.cs b/osu.Game/Overlays/FirstRunSetup/ScreenBeatmaps.cs
similarity index 52%
rename from osu.Game/Overlays/FirstRunSetup/ScreenBundledBeatmaps.cs
rename to osu.Game/Overlays/FirstRunSetup/ScreenBeatmaps.cs
index 518903e74b..aff084be73 100644
--- a/osu.Game/Overlays/FirstRunSetup/ScreenBundledBeatmaps.cs
+++ b/osu.Game/Overlays/FirstRunSetup/ScreenBeatmaps.cs
@@ -1,3 +1,4 @@
+#nullable enable
 // 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.
 
@@ -6,39 +7,51 @@ using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Game.Beatmaps.Drawables;
+using osu.Game.Database;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Graphics.UserInterfaceV2;
+using osu.Game.Localisation;
 using osu.Game.Online;
 using osuTK;
 
 namespace osu.Game.Overlays.FirstRunSetup
 {
-    [Description("Bundled Beatmaps")]
-    public class ScreenBundledBeatmaps : FirstRunSetupScreen
+    [Description("Obtaining Beatmaps")]
+    public class ScreenBeatmaps : FirstRunSetupScreen
     {
-        private RoundedButton downloadBundledButton;
+        private RoundedButton downloadBundledButton = null!;
+        private RoundedButton importBeatmapsButton = null!;
 
-        private ProgressBar progressBarBundled;
+        private ProgressBar progressBarBundled = null!;
 
-        private RoundedButton downloadTutorialButton;
-        private ProgressBar progressBarTutorial;
+        private RoundedButton downloadTutorialButton = null!;
+        private ProgressBar progressBarTutorial = null!;
 
-        private BundledBeatmapDownloader tutorialDownloader;
-        private BundledBeatmapDownloader bundledDownloader;
+        private BundledBeatmapDownloader tutorialDownloader = null!;
+        private BundledBeatmapDownloader bundledDownloader = null!;
 
-        [BackgroundDependencyLoader]
-        private void load(OsuColour colours)
+        [BackgroundDependencyLoader(permitNulls: true)]
+        private void load(OsuColour colours, OverlayColourProvider overlayColourProvider, LegacyImportManager? legacyImportManager)
         {
-            Vector2 buttonSize = new Vector2(500, 80);
+            Vector2 buttonSize = new Vector2(500, 60);
 
             Content.Children = new Drawable[]
             {
                 new OsuTextFlowContainer(cp => cp.Font = OsuFont.Default.With(size: 20))
                 {
+                    Colour = overlayColourProvider.Content1,
                     Text =
-                        "osu! doesn't come with any beatmaps pre-loaded. To get started, we have some recommended beatmaps. You can obtain more beatmaps from the main menu \"browse\" button at any time.",
+                        "\"Beatmaps\" are what we call playable levels in osu!.\n\nosu! doesn't come with any beatmaps pre-loaded. This step will help you get started on your beatmap collection.",
+                    RelativeSizeAxes = Axes.X,
+                    AutoSizeAxes = Axes.Y
+                },
+                new OsuTextFlowContainer(cp => cp.Font = OsuFont.Default.With(size: 20))
+                {
+                    Colour = overlayColourProvider.Content1,
+                    Text =
+                        "If you are a new player, we recommend playing through the tutorial to get accustomed to the gameplay.",
                     RelativeSizeAxes = Axes.X,
                     AutoSizeAxes = Axes.Y
                 },
@@ -51,6 +64,13 @@ namespace osu.Game.Overlays.FirstRunSetup
                     Text = "Download tutorial",
                     Action = downloadTutorial
                 },
+                new OsuTextFlowContainer(cp => cp.Font = OsuFont.Default.With(size: 20))
+                {
+                    Colour = overlayColourProvider.Content1,
+                    Text = "To get you started, we have some recommended beatmaps.",
+                    RelativeSizeAxes = Axes.X,
+                    AutoSizeAxes = Axes.Y
+                },
                 downloadBundledButton = new RoundedButton
                 {
                     Size = buttonSize,
@@ -60,9 +80,34 @@ namespace osu.Game.Overlays.FirstRunSetup
                     Text = "Download beatmap selection",
                     Action = downloadBundled
                 },
-                // TODO: add stable import button if a stable install is detected.
+                new OsuTextFlowContainer(cp => cp.Font = OsuFont.Default.With(size: 20))
+                {
+                    Colour = overlayColourProvider.Content1,
+                    Text = "If you have an existing osu! install, you can also choose to import your existing beatmap collection.",
+                    RelativeSizeAxes = Axes.X,
+                    AutoSizeAxes = Axes.Y
+                },
+                importBeatmapsButton = new RoundedButton
+                {
+                    Size = buttonSize,
+                    Anchor = Anchor.TopCentre,
+                    Origin = Anchor.TopCentre,
+                    BackgroundColour = colours.Blue3,
+                    Text = MaintenanceSettingsStrings.ImportBeatmapsFromStable,
+                    Action = () =>
+                    {
+                        importBeatmapsButton.Enabled.Value = false;
+                        legacyImportManager?.ImportFromStableAsync(StableContent.Beatmaps).ContinueWith(t => Schedule(() => importBeatmapsButton.Enabled.Value = true));
+                    }
+                },
+                new OsuTextFlowContainer(cp => cp.Font = OsuFont.Default.With(size: 20))
+                {
+                    Colour = overlayColourProvider.Content1,
+                    Text = "You can also obtain more beatmaps from the main menu \"browse\" button at any time.",
+                    RelativeSizeAxes = Axes.X,
+                    AutoSizeAxes = Axes.Y
+                },
             };
-
             downloadTutorialButton.Add(progressBarTutorial = new ProgressBar(false)
             {
                 RelativeSizeAxes = Axes.Both,
@@ -84,9 +129,6 @@ namespace osu.Game.Overlays.FirstRunSetup
 
         private void downloadTutorial()
         {
-            if (tutorialDownloader != null)
-                return;
-
             tutorialDownloader = new BundledBeatmapDownloader(true);
 
             AddInternal(tutorialDownloader);
@@ -104,11 +146,6 @@ namespace osu.Game.Overlays.FirstRunSetup
 
         private void downloadBundled()
         {
-            if (bundledDownloader != null)
-                return;
-
-            // downloadBundledButton.Enabled.Value = false;
-
             bundledDownloader = new BundledBeatmapDownloader(false);
 
             AddInternal(bundledDownloader);
diff --git a/osu.Game/Overlays/FirstRunSetupOverlay.cs b/osu.Game/Overlays/FirstRunSetupOverlay.cs
index b43f14522e..c151554081 100644
--- a/osu.Game/Overlays/FirstRunSetupOverlay.cs
+++ b/osu.Game/Overlays/FirstRunSetupOverlay.cs
@@ -60,7 +60,7 @@ namespace osu.Game.Overlays
         private readonly Type[] steps =
         {
             typeof(ScreenWelcome),
-            typeof(ScreenBundledBeatmaps),
+            typeof(ScreenBeatmaps),
             typeof(ScreenUIScale)
         };
 

From 081275e0b996b5198c116ebb2903d0ef9898e0e3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 28 Apr 2022 16:36:25 +0900
Subject: [PATCH 4370/5547] Adjust text and layout

---
 osu.Game/Overlays/FirstRunSetup/ScreenBeatmaps.cs | 6 +++---
 osu.Game/Overlays/FirstRunSetupOverlay.cs         | 4 ++--
 2 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Overlays/FirstRunSetup/ScreenBeatmaps.cs b/osu.Game/Overlays/FirstRunSetup/ScreenBeatmaps.cs
index aff084be73..b1e2394f89 100644
--- a/osu.Game/Overlays/FirstRunSetup/ScreenBeatmaps.cs
+++ b/osu.Game/Overlays/FirstRunSetup/ScreenBeatmaps.cs
@@ -43,7 +43,7 @@ namespace osu.Game.Overlays.FirstRunSetup
                 {
                     Colour = overlayColourProvider.Content1,
                     Text =
-                        "\"Beatmaps\" are what we call playable levels in osu!.\n\nosu! doesn't come with any beatmaps pre-loaded. This step will help you get started on your beatmap collection.",
+                        "\"Beatmaps\" are what we call playable levels. osu! doesn't come with any beatmaps pre-loaded. This step will help you get started on your beatmap collection.",
                     RelativeSizeAxes = Axes.X,
                     AutoSizeAxes = Axes.Y
                 },
@@ -61,7 +61,7 @@ namespace osu.Game.Overlays.FirstRunSetup
                     Anchor = Anchor.TopCentre,
                     Origin = Anchor.TopCentre,
                     BackgroundColour = colours.Pink3,
-                    Text = "Download tutorial",
+                    Text = "Get the osu! tutorial",
                     Action = downloadTutorial
                 },
                 new OsuTextFlowContainer(cp => cp.Font = OsuFont.Default.With(size: 20))
@@ -77,7 +77,7 @@ namespace osu.Game.Overlays.FirstRunSetup
                     Anchor = Anchor.TopCentre,
                     Origin = Anchor.TopCentre,
                     BackgroundColour = colours.Blue3,
-                    Text = "Download beatmap selection",
+                    Text = "Get recommended beatmaps",
                     Action = downloadBundled
                 },
                 new OsuTextFlowContainer(cp => cp.Font = OsuFont.Default.With(size: 20))
diff --git a/osu.Game/Overlays/FirstRunSetupOverlay.cs b/osu.Game/Overlays/FirstRunSetupOverlay.cs
index c151554081..13fb73bd27 100644
--- a/osu.Game/Overlays/FirstRunSetupOverlay.cs
+++ b/osu.Game/Overlays/FirstRunSetupOverlay.cs
@@ -83,7 +83,7 @@ namespace osu.Game.Overlays
                     Anchor = Anchor.Centre,
                     Origin = Anchor.Centre,
                     RelativeSizeAxes = Axes.Both,
-                    Padding = new MarginPadding { Horizontal = 50 },
+                    Padding = new MarginPadding { Horizontal = 70 * 2 },
                     Child = new InputBlockingContainer
                     {
                         Masking = true,
@@ -104,7 +104,7 @@ namespace osu.Game.Overlays
                                 Padding = new MarginPadding
                                 {
                                     Vertical = 20,
-                                    Horizontal = 20,
+                                    Horizontal = 70,
                                 },
                             }
                         },

From c860eb46b0274e28a32aff95c3935c37290fec8f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 28 Apr 2022 17:11:29 +0900
Subject: [PATCH 4371/5547] Split out button implementation into its own class

---
 .../Overlays/FirstRunSetup/ScreenBeatmaps.cs  | 97 ++++++++++++-------
 1 file changed, 63 insertions(+), 34 deletions(-)

diff --git a/osu.Game/Overlays/FirstRunSetup/ScreenBeatmaps.cs b/osu.Game/Overlays/FirstRunSetup/ScreenBeatmaps.cs
index b1e2394f89..893c940a1d 100644
--- a/osu.Game/Overlays/FirstRunSetup/ScreenBeatmaps.cs
+++ b/osu.Game/Overlays/FirstRunSetup/ScreenBeatmaps.cs
@@ -5,6 +5,7 @@
 using System.ComponentModel;
 using System.Linq;
 using osu.Framework.Allocation;
+using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Game.Beatmaps.Drawables;
 using osu.Game.Database;
@@ -21,19 +22,18 @@ namespace osu.Game.Overlays.FirstRunSetup
     [Description("Obtaining Beatmaps")]
     public class ScreenBeatmaps : FirstRunSetupScreen
     {
-        private RoundedButton downloadBundledButton = null!;
-        private RoundedButton importBeatmapsButton = null!;
+        private ProgressRoundedButton downloadBundledButton = null!;
+        private ProgressRoundedButton importBeatmapsButton = null!;
+        private ProgressRoundedButton downloadTutorialButton = null!;
 
-        private ProgressBar progressBarBundled = null!;
+        private BundledBeatmapDownloader? tutorialDownloader;
+        private BundledBeatmapDownloader? bundledDownloader;
 
-        private RoundedButton downloadTutorialButton = null!;
-        private ProgressBar progressBarTutorial = null!;
-
-        private BundledBeatmapDownloader tutorialDownloader = null!;
-        private BundledBeatmapDownloader bundledDownloader = null!;
+        [Resolved]
+        private OsuColour colours { get; set; } = null!;
 
         [BackgroundDependencyLoader(permitNulls: true)]
-        private void load(OsuColour colours, OverlayColourProvider overlayColourProvider, LegacyImportManager? legacyImportManager)
+        private void load(OverlayColourProvider overlayColourProvider, LegacyImportManager? legacyImportManager)
         {
             Vector2 buttonSize = new Vector2(500, 60);
 
@@ -55,7 +55,7 @@ namespace osu.Game.Overlays.FirstRunSetup
                     RelativeSizeAxes = Axes.X,
                     AutoSizeAxes = Axes.Y
                 },
-                downloadTutorialButton = new RoundedButton
+                downloadTutorialButton = new ProgressRoundedButton
                 {
                     Size = buttonSize,
                     Anchor = Anchor.TopCentre,
@@ -71,7 +71,7 @@ namespace osu.Game.Overlays.FirstRunSetup
                     RelativeSizeAxes = Axes.X,
                     AutoSizeAxes = Axes.Y
                 },
-                downloadBundledButton = new RoundedButton
+                downloadBundledButton = new ProgressRoundedButton
                 {
                     Size = buttonSize,
                     Anchor = Anchor.TopCentre,
@@ -87,7 +87,7 @@ namespace osu.Game.Overlays.FirstRunSetup
                     RelativeSizeAxes = Axes.X,
                     AutoSizeAxes = Axes.Y
                 },
-                importBeatmapsButton = new RoundedButton
+                importBeatmapsButton = new ProgressRoundedButton
                 {
                     Size = buttonSize,
                     Anchor = Anchor.TopCentre,
@@ -97,7 +97,13 @@ namespace osu.Game.Overlays.FirstRunSetup
                     Action = () =>
                     {
                         importBeatmapsButton.Enabled.Value = false;
-                        legacyImportManager?.ImportFromStableAsync(StableContent.Beatmaps).ContinueWith(t => Schedule(() => importBeatmapsButton.Enabled.Value = true));
+                        legacyImportManager?.ImportFromStableAsync(StableContent.Beatmaps).ContinueWith(t => Schedule(() =>
+                        {
+                            // TODO: can we know if the import was successful?
+                            // if so we should turn the button green and disable it in that case alone.
+                            // importBeatmapsButton.Enabled.Value = true;
+                            importBeatmapsButton.Complete();
+                        }));
                     }
                 },
                 new OsuTextFlowContainer(cp => cp.Font = OsuFont.Default.With(size: 20))
@@ -108,27 +114,13 @@ namespace osu.Game.Overlays.FirstRunSetup
                     AutoSizeAxes = Axes.Y
                 },
             };
-            downloadTutorialButton.Add(progressBarTutorial = new ProgressBar(false)
-            {
-                RelativeSizeAxes = Axes.Both,
-                Blending = BlendingParameters.Additive,
-                FillColour = downloadTutorialButton.BackgroundColour,
-                Alpha = 0.5f,
-                Depth = float.MinValue
-            });
-
-            downloadBundledButton.Add(progressBarBundled = new ProgressBar(false)
-            {
-                RelativeSizeAxes = Axes.Both,
-                Blending = BlendingParameters.Additive,
-                FillColour = downloadBundledButton.BackgroundColour,
-                Alpha = 0.5f,
-                Depth = float.MinValue
-            });
         }
 
         private void downloadTutorial()
         {
+            if (tutorialDownloader != null)
+                return;
+
             tutorialDownloader = new BundledBeatmapDownloader(true);
 
             AddInternal(tutorialDownloader);
@@ -137,15 +129,18 @@ namespace osu.Game.Overlays.FirstRunSetup
 
             downloadTracker.Progress.BindValueChanged(progress =>
             {
-                progressBarTutorial.Current.Value = progress.NewValue;
+                downloadTutorialButton.Current.Value = progress.NewValue;
 
                 if (progress.NewValue == 1)
-                    downloadTutorialButton.Enabled.Value = false;
+                    downloadTutorialButton.Complete();
             }, true);
         }
 
         private void downloadBundled()
         {
+            if (bundledDownloader != null)
+                return;
+
             bundledDownloader = new BundledBeatmapDownloader(false);
 
             AddInternal(bundledDownloader);
@@ -157,10 +152,44 @@ namespace osu.Game.Overlays.FirstRunSetup
             {
                 double progress = (double)bundledDownloader.DownloadTrackers.Count(t => t.State.Value == DownloadState.LocallyAvailable) / bundledDownloader.DownloadTrackers.Count();
 
-                this.TransformBindableTo(progressBarBundled.Current, progress, 1000, Easing.OutQuint);
+                this.TransformBindableTo(downloadBundledButton.Current, progress, 2000, Easing.OutQuint);
 
                 if (progress == 1)
-                    downloadBundledButton.Enabled.Value = false;
+                    downloadBundledButton.Complete();
+            }
+        }
+
+        private class ProgressRoundedButton : RoundedButton
+        {
+            [Resolved]
+            private OsuColour colours { get; set; } = null!;
+
+            private ProgressBar progressBar = null!;
+
+            public Bindable<double> Current => progressBar.Current;
+
+            protected override void LoadComplete()
+            {
+                base.LoadComplete();
+
+                Add(progressBar = new ProgressBar(false)
+                {
+                    RelativeSizeAxes = Axes.Both,
+                    Blending = BlendingParameters.Additive,
+                    FillColour = BackgroundColour,
+                    Alpha = 0.5f,
+                    Depth = float.MinValue
+                });
+            }
+
+            public void Complete()
+            {
+                Enabled.Value = false;
+
+                Background.FadeColour(colours.Green, 500, Easing.OutQuint);
+                progressBar.FillColour = colours.Green;
+
+                this.TransformBindableTo(Current, 1, 500, Easing.OutQuint);
             }
         }
     }

From 18a38f7e23786e2e83de7a9c6478e440b64fe8aa Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 28 Apr 2022 17:46:00 +0900
Subject: [PATCH 4372/5547] Move `FastRandom` to `LegacyRandom` in `osu.Game`
 project

---
 .../Beatmaps/CatchBeatmapProcessor.cs         |  8 +-
 .../Beatmaps/ManiaBeatmapConverter.cs         |  8 +-
 .../Legacy/DistanceObjectPatternGenerator.cs  |  4 +-
 .../Legacy/EndTimeObjectPatternGenerator.cs   |  4 +-
 .../Legacy/HitObjectPatternGenerator.cs       |  4 +-
 .../Patterns/Legacy/PatternGenerator.cs       |  6 +-
 .../MathUtils/FastRandom.cs                   | 95 -------------------
 .../Utils/LegacyRandom.cs                     | 37 +++++---
 8 files changed, 40 insertions(+), 126 deletions(-)
 delete mode 100644 osu.Game.Rulesets.Mania/MathUtils/FastRandom.cs
 rename osu.Game.Rulesets.Catch/MathUtils/FastRandom.cs => osu.Game/Utils/LegacyRandom.cs (79%)

diff --git a/osu.Game.Rulesets.Catch/Beatmaps/CatchBeatmapProcessor.cs b/osu.Game.Rulesets.Catch/Beatmaps/CatchBeatmapProcessor.cs
index 346a09cac8..ab61b14ac4 100644
--- a/osu.Game.Rulesets.Catch/Beatmaps/CatchBeatmapProcessor.cs
+++ b/osu.Game.Rulesets.Catch/Beatmaps/CatchBeatmapProcessor.cs
@@ -5,10 +5,10 @@ using System;
 using System.Collections.Generic;
 using System.Linq;
 using osu.Game.Beatmaps;
-using osu.Game.Rulesets.Catch.MathUtils;
 using osu.Game.Rulesets.Catch.Objects;
 using osu.Game.Rulesets.Catch.UI;
 using osu.Game.Rulesets.Objects.Types;
+using osu.Game.Utils;
 
 namespace osu.Game.Rulesets.Catch.Beatmaps
 {
@@ -46,7 +46,7 @@ namespace osu.Game.Rulesets.Catch.Beatmaps
 
         public void ApplyPositionOffsets(IBeatmap beatmap)
         {
-            var rng = new FastRandom(RNG_SEED);
+            var rng = new LegacyRandom(RNG_SEED);
 
             float? lastPosition = null;
             double lastStartTime = 0;
@@ -98,7 +98,7 @@ namespace osu.Game.Rulesets.Catch.Beatmaps
             initialiseHyperDash(beatmap);
         }
 
-        private static void applyHardRockOffset(CatchHitObject hitObject, ref float? lastPosition, ref double lastStartTime, FastRandom rng)
+        private static void applyHardRockOffset(CatchHitObject hitObject, ref float? lastPosition, ref double lastStartTime, LegacyRandom rng)
         {
             float offsetPosition = hitObject.OriginalX;
             double startTime = hitObject.StartTime;
@@ -146,7 +146,7 @@ namespace osu.Game.Rulesets.Catch.Beatmaps
         /// <param name="position">The position which the offset should be applied to.</param>
         /// <param name="maxOffset">The maximum offset, cannot exceed 20px.</param>
         /// <param name="rng">The random number generator.</param>
-        private static void applyRandomOffset(ref float position, double maxOffset, FastRandom rng)
+        private static void applyRandomOffset(ref float position, double maxOffset, LegacyRandom rng)
         {
             bool right = rng.NextBool();
             float rand = Math.Min(20, (float)rng.Next(0, Math.Max(0, maxOffset)));
diff --git a/osu.Game.Rulesets.Mania/Beatmaps/ManiaBeatmapConverter.cs b/osu.Game.Rulesets.Mania/Beatmaps/ManiaBeatmapConverter.cs
index 47e0e6d7b1..207c6907c8 100644
--- a/osu.Game.Rulesets.Mania/Beatmaps/ManiaBeatmapConverter.cs
+++ b/osu.Game.Rulesets.Mania/Beatmaps/ManiaBeatmapConverter.cs
@@ -11,8 +11,8 @@ using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Objects.Types;
 using osu.Game.Rulesets.Mania.Beatmaps.Patterns;
-using osu.Game.Rulesets.Mania.MathUtils;
 using osu.Game.Rulesets.Mania.Beatmaps.Patterns.Legacy;
+using osu.Game.Utils;
 using osuTK;
 
 namespace osu.Game.Rulesets.Mania.Beatmaps
@@ -31,7 +31,7 @@ namespace osu.Game.Rulesets.Mania.Beatmaps
         private readonly int originalTargetColumns;
 
         // Internal for testing purposes
-        internal FastRandom Random { get; private set; }
+        internal LegacyRandom Random { get; private set; }
 
         private Pattern lastPattern = new Pattern();
 
@@ -84,7 +84,7 @@ namespace osu.Game.Rulesets.Mania.Beatmaps
             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 FastRandom(seed);
+            Random = new LegacyRandom(seed);
 
             return base.ConvertBeatmap(original, cancellationToken);
         }
@@ -227,7 +227,7 @@ namespace osu.Game.Rulesets.Mania.Beatmaps
         /// </summary>
         private class SpecificBeatmapPatternGenerator : Patterns.Legacy.PatternGenerator
         {
-            public SpecificBeatmapPatternGenerator(FastRandom random, HitObject hitObject, ManiaBeatmap beatmap, Pattern previousPattern, IBeatmap originalBeatmap)
+            public SpecificBeatmapPatternGenerator(LegacyRandom random, HitObject hitObject, ManiaBeatmap beatmap, Pattern previousPattern, IBeatmap originalBeatmap)
                 : base(random, hitObject, beatmap, previousPattern, originalBeatmap)
             {
             }
diff --git a/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Legacy/DistanceObjectPatternGenerator.cs b/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Legacy/DistanceObjectPatternGenerator.cs
index 5f8b58d94d..dafe65f415 100644
--- a/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Legacy/DistanceObjectPatternGenerator.cs
+++ b/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Legacy/DistanceObjectPatternGenerator.cs
@@ -8,12 +8,12 @@ using System.Linq;
 using osu.Framework.Extensions.EnumExtensions;
 using osu.Game.Audio;
 using osu.Game.Beatmaps;
-using osu.Game.Rulesets.Mania.MathUtils;
 using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Objects.Types;
 using osu.Game.Rulesets.Mania.Objects;
 using osu.Game.Beatmaps.ControlPoints;
 using osu.Game.Beatmaps.Formats;
+using osu.Game.Utils;
 
 namespace osu.Game.Rulesets.Mania.Beatmaps.Patterns.Legacy
 {
@@ -34,7 +34,7 @@ namespace osu.Game.Rulesets.Mania.Beatmaps.Patterns.Legacy
 
         private PatternType convertType;
 
-        public DistanceObjectPatternGenerator(FastRandom random, HitObject hitObject, ManiaBeatmap beatmap, Pattern previousPattern, IBeatmap originalBeatmap)
+        public DistanceObjectPatternGenerator(LegacyRandom random, HitObject hitObject, ManiaBeatmap beatmap, Pattern previousPattern, IBeatmap originalBeatmap)
             : base(random, hitObject, beatmap, previousPattern, originalBeatmap)
         {
             convertType = PatternType.None;
diff --git a/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Legacy/EndTimeObjectPatternGenerator.cs b/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Legacy/EndTimeObjectPatternGenerator.cs
index f816a70ab3..2265d3d347 100644
--- a/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Legacy/EndTimeObjectPatternGenerator.cs
+++ b/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Legacy/EndTimeObjectPatternGenerator.cs
@@ -2,13 +2,13 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System.Collections.Generic;
-using osu.Game.Rulesets.Mania.MathUtils;
 using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Objects.Types;
 using System.Linq;
 using osu.Game.Audio;
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Mania.Objects;
+using osu.Game.Utils;
 
 namespace osu.Game.Rulesets.Mania.Beatmaps.Patterns.Legacy
 {
@@ -17,7 +17,7 @@ namespace osu.Game.Rulesets.Mania.Beatmaps.Patterns.Legacy
         private readonly int endTime;
         private readonly PatternType convertType;
 
-        public EndTimeObjectPatternGenerator(FastRandom random, HitObject hitObject, ManiaBeatmap beatmap, Pattern previousPattern, IBeatmap originalBeatmap)
+        public EndTimeObjectPatternGenerator(LegacyRandom random, HitObject hitObject, ManiaBeatmap beatmap, Pattern previousPattern, IBeatmap originalBeatmap)
             : base(random, hitObject, beatmap, previousPattern, originalBeatmap)
         {
             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 53b059b4e2..41d4c9322b 100644
--- a/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Legacy/HitObjectPatternGenerator.cs
+++ b/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Legacy/HitObjectPatternGenerator.cs
@@ -9,11 +9,11 @@ using osuTK;
 using osu.Game.Audio;
 using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.ControlPoints;
-using osu.Game.Rulesets.Mania.MathUtils;
 using osu.Game.Rulesets.Mania.Objects;
 using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Objects.Types;
 using osu.Framework.Extensions.IEnumerableExtensions;
+using osu.Game.Utils;
 
 namespace osu.Game.Rulesets.Mania.Beatmaps.Patterns.Legacy
 {
@@ -23,7 +23,7 @@ namespace osu.Game.Rulesets.Mania.Beatmaps.Patterns.Legacy
 
         private readonly PatternType convertType;
 
-        public HitObjectPatternGenerator(FastRandom random, HitObject hitObject, ManiaBeatmap beatmap, Pattern previousPattern, double previousTime, Vector2 previousPosition, double density,
+        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)
         {
diff --git a/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Legacy/PatternGenerator.cs b/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Legacy/PatternGenerator.cs
index eaf0ea0f2b..d5689c047a 100644
--- a/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Legacy/PatternGenerator.cs
+++ b/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Legacy/PatternGenerator.cs
@@ -5,8 +5,8 @@ using System;
 using System.Linq;
 using JetBrains.Annotations;
 using osu.Game.Beatmaps;
-using osu.Game.Rulesets.Mania.MathUtils;
 using osu.Game.Rulesets.Objects;
+using osu.Game.Utils;
 
 namespace osu.Game.Rulesets.Mania.Beatmaps.Patterns.Legacy
 {
@@ -23,14 +23,14 @@ namespace osu.Game.Rulesets.Mania.Beatmaps.Patterns.Legacy
         /// <summary>
         /// The random number generator to use.
         /// </summary>
-        protected readonly FastRandom Random;
+        protected readonly LegacyRandom Random;
 
         /// <summary>
         /// The beatmap which <see cref="HitObject"/> is being converted from.
         /// </summary>
         protected readonly IBeatmap OriginalBeatmap;
 
-        protected PatternGenerator(FastRandom random, HitObject hitObject, ManiaBeatmap beatmap, Pattern previousPattern, IBeatmap originalBeatmap)
+        protected PatternGenerator(LegacyRandom random, HitObject hitObject, ManiaBeatmap beatmap, Pattern previousPattern, IBeatmap originalBeatmap)
             : base(hitObject, beatmap, previousPattern)
         {
             if (random == null) throw new ArgumentNullException(nameof(random));
diff --git a/osu.Game.Rulesets.Mania/MathUtils/FastRandom.cs b/osu.Game.Rulesets.Mania/MathUtils/FastRandom.cs
deleted file mode 100644
index a9cd7f2476..0000000000
--- a/osu.Game.Rulesets.Mania/MathUtils/FastRandom.cs
+++ /dev/null
@@ -1,95 +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.Rulesets.Mania.MathUtils
-{
-    /// <summary>
-    /// A PRNG specified in http://heliosphan.org/fastrandom.html.
-    /// </summary>
-    internal class FastRandom
-    {
-        private const double int_to_real = 1.0 / (int.MaxValue + 1.0);
-        private const uint int_mask = 0x7FFFFFFF;
-        private const uint y = 842502087;
-        private const uint z = 3579807591;
-        private const uint w = 273326509;
-
-        internal uint X { get; private set; }
-        internal uint Y { get; private set; } = y;
-        internal uint Z { get; private set; } = z;
-        internal uint W { get; private set; } = w;
-
-        public FastRandom(int seed)
-        {
-            X = (uint)seed;
-        }
-
-        public FastRandom()
-            : this(Environment.TickCount)
-        {
-        }
-
-        /// <summary>
-        /// Generates a random unsigned integer within the range [<see cref="uint.MinValue"/>, <see cref="uint.MaxValue"/>).
-        /// </summary>
-        /// <returns>The random value.</returns>
-        public uint NextUInt()
-        {
-            uint t = X ^ (X << 11);
-            X = Y;
-            Y = Z;
-            Z = W;
-            return W = W ^ (W >> 19) ^ t ^ (t >> 8);
-        }
-
-        /// <summary>
-        /// Generates a random integer value within the range [0, <see cref="int.MaxValue"/>).
-        /// </summary>
-        /// <returns>The random value.</returns>
-        public int Next() => (int)(int_mask & NextUInt());
-
-        /// <summary>
-        /// Generates a random integer value within the range [0, <paramref name="upperBound"/>).
-        /// </summary>
-        /// <param name="upperBound">The upper bound.</param>
-        /// <returns>The random value.</returns>
-        public int Next(int upperBound) => (int)(NextDouble() * upperBound);
-
-        /// <summary>
-        /// Generates a random integer value within the range [<paramref name="lowerBound"/>, <paramref name="upperBound"/>).
-        /// </summary>
-        /// <param name="lowerBound">The lower bound of the range.</param>
-        /// <param name="upperBound">The upper bound of the range.</param>
-        /// <returns>The random value.</returns>
-        public int Next(int lowerBound, int upperBound) => (int)(lowerBound + NextDouble() * (upperBound - lowerBound));
-
-        /// <summary>
-        /// Generates a random double value within the range [0, 1).
-        /// </summary>
-        /// <returns>The random value.</returns>
-        public double NextDouble() => int_to_real * Next();
-
-        private uint bitBuffer;
-        private int bitIndex = 32;
-
-        /// <summary>
-        /// Generates a reandom boolean value. Cached such that a random value is only generated once in every 32 calls.
-        /// </summary>
-        /// <returns>The random value.</returns>
-        public bool NextBool()
-        {
-            if (bitIndex == 32)
-            {
-                bitBuffer = NextUInt();
-                bitIndex = 1;
-
-                return (bitBuffer & 1) == 1;
-            }
-
-            bitIndex++;
-            return ((bitBuffer >>= 1) & 1) == 1;
-        }
-    }
-}
diff --git a/osu.Game.Rulesets.Catch/MathUtils/FastRandom.cs b/osu.Game/Utils/LegacyRandom.cs
similarity index 79%
rename from osu.Game.Rulesets.Catch/MathUtils/FastRandom.cs
rename to osu.Game/Utils/LegacyRandom.cs
index 46e427e1b7..cf731aa91f 100644
--- a/osu.Game.Rulesets.Catch/MathUtils/FastRandom.cs
+++ b/osu.Game/Utils/LegacyRandom.cs
@@ -2,27 +2,36 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
+using osu.Framework.Utils;
 
-namespace osu.Game.Rulesets.Catch.MathUtils
+namespace osu.Game.Utils
 {
     /// <summary>
     /// A PRNG specified in http://heliosphan.org/fastrandom.html.
+    /// Should only be used to match legacy behaviour. See <see cref="RNG"/> for a newer alternative.
     /// </summary>
-    public class FastRandom
+    /// <remarks>
+    /// Known in osu-stable code as `FastRandom`.
+    /// </remarks>
+    public class LegacyRandom
     {
         private const double int_to_real = 1.0 / (int.MaxValue + 1.0);
         private const uint int_mask = 0x7FFFFFFF;
-        private const uint y_initial = 842502087;
-        private const uint z_initial = 3579807591;
-        private const uint w_initial = 273326509;
-        private uint x, y = y_initial, z = z_initial, w = w_initial;
+        private const uint y = 842502087;
+        private const uint z = 3579807591;
+        private const uint w = 273326509;
 
-        public FastRandom(int seed)
+        public uint X { get; private set; }
+        public uint Y { get; private set; } = y;
+        public uint Z { get; private set; } = z;
+        public uint W { get; private set; } = w;
+
+        public LegacyRandom(int seed)
         {
-            x = (uint)seed;
+            X = (uint)seed;
         }
 
-        public FastRandom()
+        public LegacyRandom()
             : this(Environment.TickCount)
         {
         }
@@ -33,11 +42,11 @@ namespace osu.Game.Rulesets.Catch.MathUtils
         /// <returns>The random value.</returns>
         public uint NextUInt()
         {
-            uint t = x ^ (x << 11);
-            x = y;
-            y = z;
-            z = w;
-            return w = w ^ (w >> 19) ^ t ^ (t >> 8);
+            uint t = X ^ (X << 11);
+            X = Y;
+            Y = Z;
+            Z = W;
+            return W = W ^ (W >> 19) ^ t ^ (t >> 8);
         }
 
         /// <summary>

From 3c9e52018834ab2409758e57fae5d0fa3a71f548 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 28 Apr 2022 17:24:47 +0900
Subject: [PATCH 4373/5547] Update bundle logic to match stable

---
 .../Drawables/BundledBeatmapDownloader.cs     | 84 +++++++++++++------
 1 file changed, 58 insertions(+), 26 deletions(-)

diff --git a/osu.Game/Beatmaps/Drawables/BundledBeatmapDownloader.cs b/osu.Game/Beatmaps/Drawables/BundledBeatmapDownloader.cs
index 029bb37c18..5b81022cbf 100644
--- a/osu.Game/Beatmaps/Drawables/BundledBeatmapDownloader.cs
+++ b/osu.Game/Beatmaps/Drawables/BundledBeatmapDownloader.cs
@@ -1,18 +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 System;
 using System.Collections.Generic;
 using System.Linq;
 using System.Text.RegularExpressions;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics.Containers;
-using osu.Framework.Utils;
 using osu.Game.Database;
 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.Overlays;
+using osu.Game.Utils;
 
 namespace osu.Game.Beatmaps.Drawables
 {
@@ -29,9 +30,16 @@ namespace osu.Game.Beatmaps.Drawables
         public BundledBeatmapDownloader(bool onlyTutorial)
         {
             if (onlyTutorial)
-                downloadableFilenames.Add(tutorial_filename);
+            {
+                queueDownloads(new[] { tutorial_filename });
+            }
             else
-                downloadableFilenames.AddRange(bundled_beatmap_filenames);
+            {
+                queueDownloads(bundled_osu, 8);
+                queueDownloads(bundled_taiko, 3);
+                queueDownloads(bundled_catch, 3);
+                queueDownloads(bundled_mania, 3);
+            }
         }
 
         protected override IReadOnlyDependencyContainer CreateChildDependencies(IReadOnlyDependencyContainer parent)
@@ -49,7 +57,7 @@ namespace osu.Game.Beatmaps.Drawables
         [BackgroundDependencyLoader]
         private void load()
         {
-            foreach (string filename in downloadableFilenames.OrderBy(_ => RNG.NextSingle()).Take(10))
+            foreach (string filename in downloadableFilenames)
             {
                 var match = Regex.Match(filename, @"([0-9]*) (.*) - (.*)\.osz");
 
@@ -68,9 +76,42 @@ namespace osu.Game.Beatmaps.Drawables
             }
         }
 
+        private void queueDownloads(string[] sourceFilenames, int? limit = null)
+        {
+            try
+            {
+                // Matches osu-stable, in order to provide new users with roughly the same randomised selection of bundled beatmaps.
+                var random = new LegacyRandom(DateTime.UtcNow.Year * 1000 + (DateTime.UtcNow.DayOfYear / 7));
+
+                downloadableFilenames.AddRange(sourceFilenames.OrderBy(x => random.NextDouble()).Take(limit ?? int.MaxValue));
+            }
+            catch { }
+        }
+
+        private class BundledBeatmapModelDownloader : BeatmapModelDownloader
+        {
+            public BundledBeatmapModelDownloader(IModelImporter<BeatmapSetInfo> beatmapImporter, IAPIProvider api)
+                : base(beatmapImporter, api)
+            {
+            }
+
+            protected override ArchiveDownloadRequest<IBeatmapSetInfo> CreateDownloadRequest(IBeatmapSetInfo set, bool minimiseDownloadSize)
+                => new BundledBeatmapDownloadRequest(set, minimiseDownloadSize);
+
+            public class BundledBeatmapDownloadRequest : DownloadBeatmapSetRequest
+            {
+                protected override string Uri => $"https://assets.ppy.sh/client-resources/bundled/{Model.OnlineID}.osz";
+
+                public BundledBeatmapDownloadRequest(IBeatmapSetInfo beatmapSetInfo, bool minimiseDownloadSize)
+                    : base(beatmapSetInfo, minimiseDownloadSize)
+                {
+                }
+            }
+        }
+
         private const string tutorial_filename = "1011011 nekodex - new beginnings.osz";
 
-        private static readonly string[] bundled_beatmap_filenames =
+        private static readonly string[] bundled_osu =
         {
             "682286 Yuyoyuppe - Emerald Galaxy.osz",
             "682287 baker - For a Dead Girl+.osz",
@@ -180,6 +221,10 @@ namespace osu.Game.Beatmaps.Drawables
             "1019827 UNDEAD CORPORATION - Sad Dream.osz",
             "1020213 Creo - Idolize.osz",
             "1021450 Thaehan - Chiptune & Baroque.osz",
+        };
+
+        private static readonly string[] bundled_taiko =
+        {
             "707824 Fractal Dreamers - Fortuna Redux.osz",
             "789553 Cranky - Ran.osz",
             "827822 Function Phantom - Neuronecia.osz",
@@ -227,6 +272,10 @@ namespace osu.Game.Beatmaps.Drawables
             "1023681 Inferi - The Ruin of Mankind.osz",
             "1034358 ALEPH - The Evil Spirit.osz",
             "1037567 ALEPH - Scintillations.osz",
+        };
+
+        private static readonly string[] bundled_catch =
+        {
             "554256 Helblinde - When Time Sleeps.osz",
             "693123 yuki. - Nadeshiko Sensation.osz",
             "767009 OISHII - PIZZA PLAZA.osz",
@@ -251,6 +300,10 @@ namespace osu.Game.Beatmaps.Drawables
             "972887 HyuN - Illusion of Inflict.osz",
             "1008600 LukHash - WHEN AN ANGEL DIES.osz",
             "1032103 LukHash - H8 U.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",
@@ -262,26 +315,5 @@ namespace osu.Game.Beatmaps.Drawables
             "1009907 James Landino & Kabuki - Birdsong.osz",
             "1015169 Thaehan - Insert Coin.osz",
         };
-
-        private class BundledBeatmapModelDownloader : BeatmapModelDownloader
-        {
-            public BundledBeatmapModelDownloader(IModelImporter<BeatmapSetInfo> beatmapImporter, IAPIProvider api)
-                : base(beatmapImporter, api)
-            {
-            }
-
-            protected override ArchiveDownloadRequest<IBeatmapSetInfo> CreateDownloadRequest(IBeatmapSetInfo set, bool minimiseDownloadSize)
-                => new BundledBeatmapDownloadRequest(set, minimiseDownloadSize);
-
-            public class BundledBeatmapDownloadRequest : DownloadBeatmapSetRequest
-            {
-                protected override string Uri => $"https://assets.ppy.sh/client-resources/bundled/{Model.OnlineID}.osz";
-
-                public BundledBeatmapDownloadRequest(IBeatmapSetInfo beatmapSetInfo, bool minimiseDownloadSize)
-                    : base(beatmapSetInfo, minimiseDownloadSize)
-                {
-                }
-            }
-        }
     }
 }

From 9f6597695ce4555cbaa12df3d4705534d05f928e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 28 Apr 2022 18:17:29 +0900
Subject: [PATCH 4374/5547] Only mark stable import complete if it actually
 completes

---
 osu.Game/Overlays/FirstRunSetup/ScreenBeatmaps.cs | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Overlays/FirstRunSetup/ScreenBeatmaps.cs b/osu.Game/Overlays/FirstRunSetup/ScreenBeatmaps.cs
index 893c940a1d..abbef52f8f 100644
--- a/osu.Game/Overlays/FirstRunSetup/ScreenBeatmaps.cs
+++ b/osu.Game/Overlays/FirstRunSetup/ScreenBeatmaps.cs
@@ -99,10 +99,10 @@ namespace osu.Game.Overlays.FirstRunSetup
                         importBeatmapsButton.Enabled.Value = false;
                         legacyImportManager?.ImportFromStableAsync(StableContent.Beatmaps).ContinueWith(t => Schedule(() =>
                         {
-                            // TODO: can we know if the import was successful?
-                            // if so we should turn the button green and disable it in that case alone.
-                            // importBeatmapsButton.Enabled.Value = true;
-                            importBeatmapsButton.Complete();
+                            if (t.IsCompletedSuccessfully)
+                                importBeatmapsButton.Complete();
+                            else
+                                importBeatmapsButton.Enabled.Value = true;
                         }));
                     }
                 },

From 4e0d70cbf49322e74362c88bba9f4bd5a0eb6e06 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 28 Apr 2022 18:26:29 +0900
Subject: [PATCH 4375/5547] Internalise bindable and progress handling to
 ensure transforms don't go backwards

---
 .../Overlays/FirstRunSetup/ScreenBeatmaps.cs  | 19 ++++++++++++-------
 1 file changed, 12 insertions(+), 7 deletions(-)

diff --git a/osu.Game/Overlays/FirstRunSetup/ScreenBeatmaps.cs b/osu.Game/Overlays/FirstRunSetup/ScreenBeatmaps.cs
index abbef52f8f..e02ba4d3ed 100644
--- a/osu.Game/Overlays/FirstRunSetup/ScreenBeatmaps.cs
+++ b/osu.Game/Overlays/FirstRunSetup/ScreenBeatmaps.cs
@@ -5,7 +5,6 @@
 using System.ComponentModel;
 using System.Linq;
 using osu.Framework.Allocation;
-using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Game.Beatmaps.Drawables;
 using osu.Game.Database;
@@ -129,7 +128,7 @@ namespace osu.Game.Overlays.FirstRunSetup
 
             downloadTracker.Progress.BindValueChanged(progress =>
             {
-                downloadTutorialButton.Current.Value = progress.NewValue;
+                downloadTutorialButton.SetProgress(progress.NewValue, false);
 
                 if (progress.NewValue == 1)
                     downloadTutorialButton.Complete();
@@ -152,10 +151,10 @@ namespace osu.Game.Overlays.FirstRunSetup
             {
                 double progress = (double)bundledDownloader.DownloadTrackers.Count(t => t.State.Value == DownloadState.LocallyAvailable) / bundledDownloader.DownloadTrackers.Count();
 
-                this.TransformBindableTo(downloadBundledButton.Current, progress, 2000, Easing.OutQuint);
-
                 if (progress == 1)
                     downloadBundledButton.Complete();
+                else
+                    downloadBundledButton.SetProgress(progress, true);
             }
         }
 
@@ -166,8 +165,6 @@ namespace osu.Game.Overlays.FirstRunSetup
 
             private ProgressBar progressBar = null!;
 
-            public Bindable<double> Current => progressBar.Current;
-
             protected override void LoadComplete()
             {
                 base.LoadComplete();
@@ -189,7 +186,15 @@ namespace osu.Game.Overlays.FirstRunSetup
                 Background.FadeColour(colours.Green, 500, Easing.OutQuint);
                 progressBar.FillColour = colours.Green;
 
-                this.TransformBindableTo(Current, 1, 500, Easing.OutQuint);
+                this.TransformBindableTo(progressBar.Current, 1, 500, Easing.OutQuint);
+            }
+
+            public void SetProgress(double progress, bool animated)
+            {
+                if (!Enabled.Value)
+                    return;
+
+                this.TransformBindableTo(progressBar.Current, progress, animated ? 500 : 0, Easing.OutQuint);
             }
         }
     }

From 88bfd5dece938e0e886dce8f433191cd7fe4b9ca Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 28 Apr 2022 18:57:32 +0900
Subject: [PATCH 4376/5547] Show current beatmap count on beatmap screen

---
 .../FirstRunSetup/FirstRunSetupScreen.cs      |  7 ++-
 .../Overlays/FirstRunSetup/ScreenBeatmaps.cs  | 63 +++++++++++++++++--
 2 files changed, 62 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Overlays/FirstRunSetup/FirstRunSetupScreen.cs b/osu.Game/Overlays/FirstRunSetup/FirstRunSetupScreen.cs
index 282ba52ddc..d4032306ad 100644
--- a/osu.Game/Overlays/FirstRunSetup/FirstRunSetupScreen.cs
+++ b/osu.Game/Overlays/FirstRunSetup/FirstRunSetupScreen.cs
@@ -19,8 +19,11 @@ namespace osu.Game.Overlays.FirstRunSetup
 
         protected FillFlowContainer Content { get; private set; }
 
+        [Resolved]
+        protected OverlayColourProvider OverlayColourProvider { get; private set; }
+
         [BackgroundDependencyLoader]
-        private void load(OverlayColourProvider overlayColourProvider)
+        private void load()
         {
             const float header_size = 40;
             const float spacing = 20;
@@ -36,7 +39,7 @@ namespace osu.Game.Overlays.FirstRunSetup
                         {
                             Text = this.GetLocalisableDescription(),
                             Font = OsuFont.Default.With(size: header_size),
-                            Colour = overlayColourProvider.Light1,
+                            Colour = OverlayColourProvider.Light1,
                         },
                         Content = new FillFlowContainer
                         {
diff --git a/osu.Game/Overlays/FirstRunSetup/ScreenBeatmaps.cs b/osu.Game/Overlays/FirstRunSetup/ScreenBeatmaps.cs
index e02ba4d3ed..fda9fde8b7 100644
--- a/osu.Game/Overlays/FirstRunSetup/ScreenBeatmaps.cs
+++ b/osu.Game/Overlays/FirstRunSetup/ScreenBeatmaps.cs
@@ -2,10 +2,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.ComponentModel;
 using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
+using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.Drawables;
 using osu.Game.Database;
 using osu.Game.Graphics;
@@ -15,6 +17,8 @@ using osu.Game.Graphics.UserInterfaceV2;
 using osu.Game.Localisation;
 using osu.Game.Online;
 using osuTK;
+using Realms;
+using Container = osu.Framework.Graphics.Containers.Container;
 
 namespace osu.Game.Overlays.FirstRunSetup
 {
@@ -25,14 +29,21 @@ namespace osu.Game.Overlays.FirstRunSetup
         private ProgressRoundedButton importBeatmapsButton = null!;
         private ProgressRoundedButton downloadTutorialButton = null!;
 
+        private OsuTextFlowContainer currentlyLoadedBeatmaps = null!;
+
         private BundledBeatmapDownloader? tutorialDownloader;
         private BundledBeatmapDownloader? bundledDownloader;
 
         [Resolved]
         private OsuColour colours { get; set; } = null!;
 
+        [Resolved]
+        private RealmAccess realmAccess { get; set; } = null!;
+
+        private IDisposable? beatmapSubscription;
+
         [BackgroundDependencyLoader(permitNulls: true)]
-        private void load(OverlayColourProvider overlayColourProvider, LegacyImportManager? legacyImportManager)
+        private void load(LegacyImportManager? legacyImportManager)
         {
             Vector2 buttonSize = new Vector2(500, 60);
 
@@ -40,15 +51,31 @@ namespace osu.Game.Overlays.FirstRunSetup
             {
                 new OsuTextFlowContainer(cp => cp.Font = OsuFont.Default.With(size: 20))
                 {
-                    Colour = overlayColourProvider.Content1,
+                    Colour = OverlayColourProvider.Content1,
                     Text =
                         "\"Beatmaps\" are what we call playable levels. osu! doesn't come with any beatmaps pre-loaded. This step will help you get started on your beatmap collection.",
                     RelativeSizeAxes = Axes.X,
                     AutoSizeAxes = Axes.Y
                 },
+                new Container
+                {
+                    RelativeSizeAxes = Axes.X,
+                    Height = 30,
+                    Children = new Drawable[]
+                    {
+                        currentlyLoadedBeatmaps = new OsuTextFlowContainer(cp => cp.Font = OsuFont.Default.With(size: 24, weight: FontWeight.SemiBold))
+                        {
+                            Colour = OverlayColourProvider.Content2,
+                            TextAnchor = Anchor.Centre,
+                            Anchor = Anchor.Centre,
+                            Origin = Anchor.Centre,
+                            AutoSizeAxes = Axes.Both,
+                        },
+                    }
+                },
                 new OsuTextFlowContainer(cp => cp.Font = OsuFont.Default.With(size: 20))
                 {
-                    Colour = overlayColourProvider.Content1,
+                    Colour = OverlayColourProvider.Content1,
                     Text =
                         "If you are a new player, we recommend playing through the tutorial to get accustomed to the gameplay.",
                     RelativeSizeAxes = Axes.X,
@@ -65,7 +92,7 @@ namespace osu.Game.Overlays.FirstRunSetup
                 },
                 new OsuTextFlowContainer(cp => cp.Font = OsuFont.Default.With(size: 20))
                 {
-                    Colour = overlayColourProvider.Content1,
+                    Colour = OverlayColourProvider.Content1,
                     Text = "To get you started, we have some recommended beatmaps.",
                     RelativeSizeAxes = Axes.X,
                     AutoSizeAxes = Axes.Y
@@ -81,7 +108,7 @@ namespace osu.Game.Overlays.FirstRunSetup
                 },
                 new OsuTextFlowContainer(cp => cp.Font = OsuFont.Default.With(size: 20))
                 {
-                    Colour = overlayColourProvider.Content1,
+                    Colour = OverlayColourProvider.Content1,
                     Text = "If you have an existing osu! install, you can also choose to import your existing beatmap collection.",
                     RelativeSizeAxes = Axes.X,
                     AutoSizeAxes = Axes.Y
@@ -107,7 +134,7 @@ namespace osu.Game.Overlays.FirstRunSetup
                 },
                 new OsuTextFlowContainer(cp => cp.Font = OsuFont.Default.With(size: 20))
                 {
-                    Colour = overlayColourProvider.Content1,
+                    Colour = OverlayColourProvider.Content1,
                     Text = "You can also obtain more beatmaps from the main menu \"browse\" button at any time.",
                     RelativeSizeAxes = Axes.X,
                     AutoSizeAxes = Axes.Y
@@ -115,6 +142,30 @@ namespace osu.Game.Overlays.FirstRunSetup
             };
         }
 
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            beatmapSubscription = realmAccess.RegisterForNotifications(r => r.All<BeatmapSetInfo>().Where(s => !s.DeletePending && !s.Protected), beatmapsChanged);
+        }
+
+        protected override void Dispose(bool isDisposing)
+        {
+            base.Dispose(isDisposing);
+            beatmapSubscription?.Dispose();
+        }
+
+        private void beatmapsChanged(IRealmCollection<BeatmapSetInfo> sender, ChangeSet? changes, Exception error)
+        {
+            currentlyLoadedBeatmaps.Text = $"You currently have {sender.Count} beatmap(s) loaded!";
+
+            if (changes != null && (changes.DeletedIndices.Any() || changes.InsertedIndices.Any()))
+            {
+                currentlyLoadedBeatmaps.FadeColour(colours.YellowLight).FadeColour(OverlayColourProvider.Content2);
+                currentlyLoadedBeatmaps.ScaleTo(1.1f).ScaleTo(1, 1000, Easing.OutQuint);
+            }
+        }
+
         private void downloadTutorial()
         {
             if (tutorialDownloader != null)

From 804848c9fb546aea2634da3e9b45c9eee2d6ad10 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 28 Apr 2022 18:57:41 +0900
Subject: [PATCH 4377/5547] Allow bundled downloader to not post notifications

---
 .../Beatmaps/Drawables/BundledBeatmapDownloader.cs  | 13 +++++++++++--
 1 file changed, 11 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Beatmaps/Drawables/BundledBeatmapDownloader.cs b/osu.Game/Beatmaps/Drawables/BundledBeatmapDownloader.cs
index 5b81022cbf..bc99aa4a5a 100644
--- a/osu.Game/Beatmaps/Drawables/BundledBeatmapDownloader.cs
+++ b/osu.Game/Beatmaps/Drawables/BundledBeatmapDownloader.cs
@@ -19,6 +19,8 @@ namespace osu.Game.Beatmaps.Drawables
 {
     public class BundledBeatmapDownloader : CompositeDrawable
     {
+        private readonly bool shouldPostNotifications;
+
         public IEnumerable<BeatmapDownloadTracker> DownloadTrackers => downloadTrackers;
 
         private readonly List<BeatmapDownloadTracker> downloadTrackers = new List<BeatmapDownloadTracker>();
@@ -27,8 +29,15 @@ namespace osu.Game.Beatmaps.Drawables
 
         private BundledBeatmapModelDownloader beatmapDownloader;
 
-        public BundledBeatmapDownloader(bool onlyTutorial)
+        /// <summary>
+        /// Construct a new beatmap downloader.
+        /// </summary>
+        /// <param name="onlyTutorial">Whether only the tutorial should be downloaded, instead of bundled beatmaps.</param>
+        /// <param name="shouldPostNotifications">Whether downloads should create tracking notifications.</param>
+        public BundledBeatmapDownloader(bool onlyTutorial, bool shouldPostNotifications = false)
         {
+            this.shouldPostNotifications = shouldPostNotifications;
+
             if (onlyTutorial)
             {
                 queueDownloads(new[] { tutorial_filename });
@@ -48,7 +57,7 @@ namespace osu.Game.Beatmaps.Drawables
 
             localDependencies.CacheAs<BeatmapModelDownloader>(beatmapDownloader = new BundledBeatmapModelDownloader(parent.Get<BeatmapManager>(), parent.Get<IAPIProvider>()));
 
-            if (parent.Get<INotificationOverlay>() is INotificationOverlay notifications)
+            if (shouldPostNotifications && parent.Get<INotificationOverlay>() is INotificationOverlay notifications)
                 beatmapDownloader.PostNotification = notifications.Post;
 
             return localDependencies;

From b6896376e7db72813bbd8c42a6d9ce9bd26c3a45 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 28 Apr 2022 19:08:16 +0900
Subject: [PATCH 4378/5547] Better signal when no beatmaps are loaded

---
 osu.Game/Overlays/FirstRunSetup/ScreenBeatmaps.cs | 13 ++++++++++---
 1 file changed, 10 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Overlays/FirstRunSetup/ScreenBeatmaps.cs b/osu.Game/Overlays/FirstRunSetup/ScreenBeatmaps.cs
index fda9fde8b7..645713c52a 100644
--- a/osu.Game/Overlays/FirstRunSetup/ScreenBeatmaps.cs
+++ b/osu.Game/Overlays/FirstRunSetup/ScreenBeatmaps.cs
@@ -159,10 +159,17 @@ namespace osu.Game.Overlays.FirstRunSetup
         {
             currentlyLoadedBeatmaps.Text = $"You currently have {sender.Count} beatmap(s) loaded!";
 
-            if (changes != null && (changes.DeletedIndices.Any() || changes.InsertedIndices.Any()))
+            if (sender.Count == 0)
             {
-                currentlyLoadedBeatmaps.FadeColour(colours.YellowLight).FadeColour(OverlayColourProvider.Content2);
-                currentlyLoadedBeatmaps.ScaleTo(1.1f).ScaleTo(1, 1000, Easing.OutQuint);
+                currentlyLoadedBeatmaps.FadeColour(colours.Red1, 500, Easing.OutQuint);
+            }
+            else if (changes != null && (changes.DeletedIndices.Any() || changes.InsertedIndices.Any()))
+            {
+                currentlyLoadedBeatmaps.FadeColour(colours.Yellow)
+                                       .FadeColour(OverlayColourProvider.Content2, 1500, Easing.OutQuint);
+
+                currentlyLoadedBeatmaps.ScaleTo(1.1f)
+                                       .ScaleTo(1, 1500, Easing.OutQuint);
             }
         }
 

From 14316855f9a478734cc4627463e70332c3b8fdbc Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 28 Apr 2022 19:26:28 +0900
Subject: [PATCH 4379/5547] Add localisation length hinting

---
 .editorconfig          | 2 ++
 osu.Game/.editorconfig | 3 ++-
 2 files changed, 4 insertions(+), 1 deletion(-)

diff --git a/.editorconfig b/.editorconfig
index be5652954b..49e83c9103 100644
--- a/.editorconfig
+++ b/.editorconfig
@@ -175,6 +175,8 @@ csharp_style_prefer_switch_expression = false:none
 #Supressing roslyn built-in analyzers
 # Suppress: EC112
 
+dotnet_diagnostic.OLOC001.words_in_name = 5
+
 #Private method is unused
 dotnet_diagnostic.IDE0051.severity = silent
 #Private member is unused
diff --git a/osu.Game/.editorconfig b/osu.Game/.editorconfig
index 4107d1bb35..539cd56dab 100644
--- a/osu.Game/.editorconfig
+++ b/osu.Game/.editorconfig
@@ -1,3 +1,4 @@
 [*.cs]
+dotnet_diagnostic.OLOC001.words_in_name = 5
 dotnet_diagnostic.OLOC001.prefix_namespace = osu.Game.Resources.Localisation
-dotnet_diagnostic.OLOC001.license_header = // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.\n// See the LICENCE file in the repository root for full licence text.
\ No newline at end of file
+dotnet_diagnostic.OLOC001.license_header = // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.\n// See the LICENCE file in the repository root for full licence text.

From 694f33b827d327b2b8fb8afd7e39761c8a12a25b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 28 Apr 2022 19:33:16 +0900
Subject: [PATCH 4380/5547] Add localisation of beatmaps screen

---
 .../FirstRunSetupBeatmapScreenStrings.cs      | 54 +++++++++++++++++++
 .../Overlays/FirstRunSetup/ScreenBeatmaps.cs  | 22 ++++----
 2 files changed, 64 insertions(+), 12 deletions(-)
 create mode 100644 osu.Game/Localisation/FirstRunSetupBeatmapScreenStrings.cs

diff --git a/osu.Game/Localisation/FirstRunSetupBeatmapScreenStrings.cs b/osu.Game/Localisation/FirstRunSetupBeatmapScreenStrings.cs
new file mode 100644
index 0000000000..3a7fe4bb12
--- /dev/null
+++ b/osu.Game/Localisation/FirstRunSetupBeatmapScreenStrings.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.Localisation;
+
+namespace osu.Game.Localisation
+{
+    public static class FirstRunSetupBeatmapScreenStrings
+    {
+        private const string prefix = @"osu.Game.Resources.Localisation.FirstRunSetupBeatmapScreen";
+
+        /// <summary>
+        /// "Obtaining Beatmaps"
+        /// </summary>
+        public static LocalisableString Header => new TranslatableString(getKey(@"header"), @"Obtaining Beatmaps");
+
+        /// <summary>
+        /// "&quot;Beatmaps&quot; are what we call playable levels. osu! doesn&#39;t come with any beatmaps pre-loaded. This step will help you get started on your beatmap collection."
+        /// </summary>
+        public static LocalisableString Description => new TranslatableString(getKey(@"description"), @"""Beatmaps"" are what we call playable levels. osu! doesn't come with any beatmaps pre-loaded. This step will help you get started on your beatmap collection.");
+
+        /// <summary>
+        /// "If you are a new player, we recommend playing through the tutorial to get accustomed to the gameplay."
+        /// </summary>
+        public static LocalisableString TutorialDescription => new TranslatableString(getKey(@"tutorial_description"), @"If you are a new player, we recommend playing through the tutorial to get accustomed to the gameplay.");
+
+        /// <summary>
+        /// "Get the osu! tutorial"
+        /// </summary>
+        public static LocalisableString TutorialButton => new TranslatableString(getKey(@"tutorial_button"), @"Get the osu! tutorial");
+
+        /// <summary>
+        /// "To get you started, we have some recommended beatmaps."
+        /// </summary>
+        public static LocalisableString BundledDescription => new TranslatableString(getKey(@"bundled_description"), @"To get you started, we have some recommended beatmaps.");
+
+        /// <summary>
+        /// "Get recommended beatmaps"
+        /// </summary>
+        public static LocalisableString BundledButton => new TranslatableString(getKey(@"bundled_button"), @"Get recommended beatmaps");
+
+        /// <summary>
+        /// "You can also obtain more beatmaps from the main menu &quot;browse&quot; button at any time."
+        /// </summary>
+        public static LocalisableString ObtainMoreBeatmaps => new TranslatableString(getKey(@"obtain_more_beatmaps"), @"You can also obtain more beatmaps from the main menu ""browse"" button at any time.");
+
+        /// <summary>
+        /// "You currently have {0} beatmap(s) loaded!"
+        /// </summary>
+        public static LocalisableString CurrentlyLoadedBeatmaps(int beatmaps) => new TranslatableString(getKey(@"currently_loaded_beatmaps"), @"You currently have {0} beatmap(s) loaded!", beatmaps);
+
+        private static string getKey(string key) => $@"{prefix}:{key}";
+    }
+}
diff --git a/osu.Game/Overlays/FirstRunSetup/ScreenBeatmaps.cs b/osu.Game/Overlays/FirstRunSetup/ScreenBeatmaps.cs
index 645713c52a..892856d280 100644
--- a/osu.Game/Overlays/FirstRunSetup/ScreenBeatmaps.cs
+++ b/osu.Game/Overlays/FirstRunSetup/ScreenBeatmaps.cs
@@ -3,10 +3,11 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
-using System.ComponentModel;
 using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
+using osu.Framework.Localisation;
 using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.Drawables;
 using osu.Game.Database;
@@ -18,11 +19,10 @@ using osu.Game.Localisation;
 using osu.Game.Online;
 using osuTK;
 using Realms;
-using Container = osu.Framework.Graphics.Containers.Container;
 
 namespace osu.Game.Overlays.FirstRunSetup
 {
-    [Description("Obtaining Beatmaps")]
+    [LocalisableDescription(typeof(FirstRunSetupBeatmapScreenStrings), nameof(FirstRunSetupBeatmapScreenStrings.Header))]
     public class ScreenBeatmaps : FirstRunSetupScreen
     {
         private ProgressRoundedButton downloadBundledButton = null!;
@@ -52,8 +52,7 @@ namespace osu.Game.Overlays.FirstRunSetup
                 new OsuTextFlowContainer(cp => cp.Font = OsuFont.Default.With(size: 20))
                 {
                     Colour = OverlayColourProvider.Content1,
-                    Text =
-                        "\"Beatmaps\" are what we call playable levels. osu! doesn't come with any beatmaps pre-loaded. This step will help you get started on your beatmap collection.",
+                    Text = FirstRunSetupBeatmapScreenStrings.Description,
                     RelativeSizeAxes = Axes.X,
                     AutoSizeAxes = Axes.Y
                 },
@@ -76,8 +75,7 @@ namespace osu.Game.Overlays.FirstRunSetup
                 new OsuTextFlowContainer(cp => cp.Font = OsuFont.Default.With(size: 20))
                 {
                     Colour = OverlayColourProvider.Content1,
-                    Text =
-                        "If you are a new player, we recommend playing through the tutorial to get accustomed to the gameplay.",
+                    Text = FirstRunSetupBeatmapScreenStrings.TutorialDescription,
                     RelativeSizeAxes = Axes.X,
                     AutoSizeAxes = Axes.Y
                 },
@@ -87,13 +85,13 @@ namespace osu.Game.Overlays.FirstRunSetup
                     Anchor = Anchor.TopCentre,
                     Origin = Anchor.TopCentre,
                     BackgroundColour = colours.Pink3,
-                    Text = "Get the osu! tutorial",
+                    Text = FirstRunSetupBeatmapScreenStrings.TutorialButton,
                     Action = downloadTutorial
                 },
                 new OsuTextFlowContainer(cp => cp.Font = OsuFont.Default.With(size: 20))
                 {
                     Colour = OverlayColourProvider.Content1,
-                    Text = "To get you started, we have some recommended beatmaps.",
+                    Text = FirstRunSetupBeatmapScreenStrings.BundledDescription,
                     RelativeSizeAxes = Axes.X,
                     AutoSizeAxes = Axes.Y
                 },
@@ -103,7 +101,7 @@ namespace osu.Game.Overlays.FirstRunSetup
                     Anchor = Anchor.TopCentre,
                     Origin = Anchor.TopCentre,
                     BackgroundColour = colours.Blue3,
-                    Text = "Get recommended beatmaps",
+                    Text = FirstRunSetupBeatmapScreenStrings.BundledButton,
                     Action = downloadBundled
                 },
                 new OsuTextFlowContainer(cp => cp.Font = OsuFont.Default.With(size: 20))
@@ -135,7 +133,7 @@ namespace osu.Game.Overlays.FirstRunSetup
                 new OsuTextFlowContainer(cp => cp.Font = OsuFont.Default.With(size: 20))
                 {
                     Colour = OverlayColourProvider.Content1,
-                    Text = "You can also obtain more beatmaps from the main menu \"browse\" button at any time.",
+                    Text = FirstRunSetupBeatmapScreenStrings.ObtainMoreBeatmaps,
                     RelativeSizeAxes = Axes.X,
                     AutoSizeAxes = Axes.Y
                 },
@@ -157,7 +155,7 @@ namespace osu.Game.Overlays.FirstRunSetup
 
         private void beatmapsChanged(IRealmCollection<BeatmapSetInfo> sender, ChangeSet? changes, Exception error)
         {
-            currentlyLoadedBeatmaps.Text = $"You currently have {sender.Count} beatmap(s) loaded!";
+            currentlyLoadedBeatmaps.Text = FirstRunSetupBeatmapScreenStrings.CurrentlyLoadedBeatmaps(sender.Count);
 
             if (sender.Count == 0)
             {

From fe0fcc7e9ea522ebfa9bca7a71603de316a80371 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 28 Apr 2022 20:00:38 +0900
Subject: [PATCH 4381/5547] Rename countdown object

---
 .../Multiplayer/ForceGameplayStartCountdown.cs  | 17 +++++++++++++++++
 .../Multiplayer/GameplayStartCountdown.cs       | 15 ---------------
 .../Online/Multiplayer/MultiplayerCountdown.cs  |  2 +-
 osu.Game/Online/SignalRWorkaroundTypes.cs       |  2 +-
 4 files changed, 19 insertions(+), 17 deletions(-)
 create mode 100644 osu.Game/Online/Multiplayer/ForceGameplayStartCountdown.cs
 delete mode 100644 osu.Game/Online/Multiplayer/GameplayStartCountdown.cs

diff --git a/osu.Game/Online/Multiplayer/ForceGameplayStartCountdown.cs b/osu.Game/Online/Multiplayer/ForceGameplayStartCountdown.cs
new file mode 100644
index 0000000000..4ec5019a07
--- /dev/null
+++ b/osu.Game/Online/Multiplayer/ForceGameplayStartCountdown.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 MessagePack;
+
+namespace osu.Game.Online.Multiplayer
+{
+    /// <summary>
+    /// A <see cref="MultiplayerCountdown"/> started by the server when clients being to load.
+    /// Indicates how long until gameplay will forcefully start, excluding any users which have not completed loading,
+    /// and forcing progression of any clients that are blocking load due to user interaction.
+    /// </summary>
+    [MessagePackObject]
+    public class ForceGameplayStartCountdown : MultiplayerCountdown
+    {
+    }
+}
diff --git a/osu.Game/Online/Multiplayer/GameplayStartCountdown.cs b/osu.Game/Online/Multiplayer/GameplayStartCountdown.cs
deleted file mode 100644
index d3d7f78507..0000000000
--- a/osu.Game/Online/Multiplayer/GameplayStartCountdown.cs
+++ /dev/null
@@ -1,15 +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 MessagePack;
-
-namespace osu.Game.Online.Multiplayer
-{
-    /// <summary>
-    /// A <see cref="MultiplayerCountdown"/> indicating that gameplay will start after a given period of time.
-    /// </summary>
-    [MessagePackObject]
-    public class GameplayStartCountdown : MultiplayerCountdown
-    {
-    }
-}
diff --git a/osu.Game/Online/Multiplayer/MultiplayerCountdown.cs b/osu.Game/Online/Multiplayer/MultiplayerCountdown.cs
index 308eea3aef..dbf2ab667b 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerCountdown.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerCountdown.cs
@@ -14,7 +14,7 @@ namespace osu.Game.Online.Multiplayer
     /// </summary>
     [MessagePackObject]
     [Union(0, typeof(MatchStartCountdown))] // IMPORTANT: Add rules to SignalRUnionWorkaroundResolver for new derived types.
-    [Union(1, typeof(GameplayStartCountdown))]
+    [Union(1, typeof(ForceGameplayStartCountdown))]
     public abstract class MultiplayerCountdown
     {
         /// <summary>
diff --git a/osu.Game/Online/SignalRWorkaroundTypes.cs b/osu.Game/Online/SignalRWorkaroundTypes.cs
index 00fdadb87e..d1f0ba725f 100644
--- a/osu.Game/Online/SignalRWorkaroundTypes.cs
+++ b/osu.Game/Online/SignalRWorkaroundTypes.cs
@@ -25,7 +25,7 @@ namespace osu.Game.Online
             (typeof(TeamVersusRoomState), typeof(MatchRoomState)),
             (typeof(TeamVersusUserState), typeof(MatchUserState)),
             (typeof(MatchStartCountdown), typeof(MultiplayerCountdown)),
-            (typeof(GameplayStartCountdown), typeof(MultiplayerCountdown))
+            (typeof(ForceGameplayStartCountdown), typeof(MultiplayerCountdown))
         };
     }
 }

From f300b62877cad3c2c25b52fae29c7a446a887dda Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 28 Apr 2022 20:03:54 +0900
Subject: [PATCH 4382/5547] Add `ScrollIntoView` method which accepts an offset
 to allow usage in mod select

---
 .../Graphics/Containers/OsuScrollContainer.cs | 21 +++++++++++++++++++
 osu.Game/Overlays/Mods/ModSelectScreen.cs     |  2 +-
 2 files changed, 22 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Graphics/Containers/OsuScrollContainer.cs b/osu.Game/Graphics/Containers/OsuScrollContainer.cs
index 017ea6ec32..817b8409e6 100644
--- a/osu.Game/Graphics/Containers/OsuScrollContainer.cs
+++ b/osu.Game/Graphics/Containers/OsuScrollContainer.cs
@@ -3,6 +3,7 @@
 
 #nullable enable
 
+using System;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
@@ -57,6 +58,26 @@ namespace osu.Game.Graphics.Containers
         {
         }
 
+        /// <summary>
+        /// Scrolls a <see cref="Drawable"/> into view.
+        /// </summary>
+        /// <param name="d">The <see cref="Drawable"/> to scroll into view.</param>
+        /// <param name="animated">Whether to animate the movement.</param>
+        /// <param name="extraScroll">An added amount to scroll beyond the requirement to bring the target into view.</param>
+        public void ScrollIntoView(Drawable d, bool animated = true, float extraScroll = 0)
+        {
+            float childPos0 = GetChildPosInContent(d);
+            float childPos1 = GetChildPosInContent(d, d.DrawSize);
+
+            float minPos = Math.Min(childPos0, childPos1);
+            float maxPos = Math.Max(childPos0, childPos1);
+
+            if (minPos < Current || (minPos > Current && d.DrawSize[ScrollDim] > DisplayableContent))
+                ScrollTo(minPos - extraScroll, animated);
+            else if (maxPos > Current + DisplayableContent)
+                ScrollTo(maxPos - DisplayableContent + extraScroll, animated);
+        }
+
         protected override bool OnMouseDown(MouseDownEvent e)
         {
             if (shouldPerformRightMouseScroll(e))
diff --git a/osu.Game/Overlays/Mods/ModSelectScreen.cs b/osu.Game/Overlays/Mods/ModSelectScreen.cs
index 03a66575c4..ffd6e9a52c 100644
--- a/osu.Game/Overlays/Mods/ModSelectScreen.cs
+++ b/osu.Game/Overlays/Mods/ModSelectScreen.cs
@@ -161,7 +161,7 @@ namespace osu.Game.Overlays.Mods
             {
                 AutoSizeAxes = Axes.X,
                 RelativeSizeAxes = Axes.Y,
-                RequestScroll = column => columnScroll.ScrollTo(Math.Clamp(column.DrawPosition.X - 70, 0, columnScroll.ScrollableExtent))
+                RequestScroll = column => columnScroll.ScrollIntoView(column, extraScroll: 140)
             };
 
         protected override void LoadComplete()

From 1d8ac6917dc4a3fe58f67b254a32143b2c9bd632 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 28 Apr 2022 20:10:47 +0900
Subject: [PATCH 4383/5547] Send Loaded state from PlayerLoader on update
 thread

---
 .../Multiplayer/MultiplayerPlayer.cs          |  3 ---
 .../Multiplayer/MultiplayerPlayerLoader.cs    | 22 +++++++++++++++++++
 osu.Game/Screens/Play/PlayerLoader.cs         | 10 ++++++++-
 3 files changed, 31 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayer.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayer.cs
index 7dd57ee50f..02ff040a94 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayer.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayer.cs
@@ -133,9 +133,6 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
                     failAndBail();
                 }
             }), true);
-
-            client.ChangeState(MultiplayerUserState.Loaded)
-                  .ContinueWith(task => failAndBail(task.Exception?.Message ?? "Server error"), TaskContinuationOptions.NotOnRanToCompletion);
         }
 
         protected override void LoadComplete()
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayerLoader.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayerLoader.cs
index 236df7917c..7f01bd64ab 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayerLoader.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayerLoader.cs
@@ -2,7 +2,9 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
+using System.Threading.Tasks;
 using osu.Framework.Allocation;
+using osu.Framework.Logging;
 using osu.Framework.Screens;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Screens.Play;
@@ -28,6 +30,26 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
             // The server is forcefully starting gameplay.
             || multiplayerClient.LocalUser?.State == MultiplayerUserState.Playing;
 
+        protected override void OnPlayerLoaded()
+        {
+            base.OnPlayerLoaded();
+
+            multiplayerClient.ChangeState(MultiplayerUserState.Loaded)
+                             .ContinueWith(task => failAndBail(task.Exception?.Message ?? "Server error"), TaskContinuationOptions.NotOnRanToCompletion);
+        }
+
+        private void failAndBail(string message = null)
+        {
+            if (!string.IsNullOrEmpty(message))
+                Logger.Log(message, LoggingTarget.Runtime, LogLevel.Important);
+
+            Schedule(() =>
+            {
+                if (this.IsCurrentScreen())
+                    this.Exit();
+            });
+        }
+
         public override void OnSuspending(ScreenTransitionEvent e)
         {
             base.OnSuspending(e);
diff --git a/osu.Game/Screens/Play/PlayerLoader.cs b/osu.Game/Screens/Play/PlayerLoader.cs
index bdfa822cb0..d75466764d 100644
--- a/osu.Game/Screens/Play/PlayerLoader.cs
+++ b/osu.Game/Screens/Play/PlayerLoader.cs
@@ -368,7 +368,15 @@ namespace osu.Game.Screens.Play
             CurrentPlayer.RestartCount = restartCount++;
             CurrentPlayer.RestartRequested = restartRequested;
 
-            LoadTask = LoadComponentAsync(CurrentPlayer, _ => MetadataInfo.Loading = false);
+            LoadTask = LoadComponentAsync(CurrentPlayer, _ =>
+            {
+                MetadataInfo.Loading = false;
+                OnPlayerLoaded();
+            });
+        }
+
+        protected virtual void OnPlayerLoaded()
+        {
         }
 
         private void restartRequested()

From a50dd2ae93becc4c980c88e8b881a1a914e8b914 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 28 Apr 2022 20:15:40 +0900
Subject: [PATCH 4384/5547] Fix rider failures in nullable

---
 osu.Game/Overlays/FirstRunSetup/ScreenBeatmaps.cs | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/FirstRunSetup/ScreenBeatmaps.cs b/osu.Game/Overlays/FirstRunSetup/ScreenBeatmaps.cs
index 892856d280..190a0badab 100644
--- a/osu.Game/Overlays/FirstRunSetup/ScreenBeatmaps.cs
+++ b/osu.Game/Overlays/FirstRunSetup/ScreenBeatmaps.cs
@@ -1,7 +1,8 @@
-#nullable enable
 // 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 enable
+
 using System;
 using System.Linq;
 using osu.Framework.Allocation;

From b902e69634ea7f56e4af3ceb29037186695b39b1 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 28 Apr 2022 20:16:32 +0900
Subject: [PATCH 4385/5547] Update test expectations based on new screen order

---
 .../Visual/UserInterface/TestSceneFirstRunSetupOverlay.cs     | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunSetupOverlay.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunSetupOverlay.cs
index 31c4d66784..836cf6caad 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunSetupOverlay.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunSetupOverlay.cs
@@ -178,7 +178,7 @@ namespace osu.Game.Tests.Visual.UserInterface
         {
             AddStep("step to next", () => overlay.NextButton.TriggerClick());
 
-            AddAssert("is at known screen", () => overlay.CurrentScreen is ScreenUIScale);
+            AddAssert("is at known screen", () => overlay.CurrentScreen is ScreenBeatmaps);
 
             AddStep("hide", () => overlay.Hide());
             AddAssert("overlay hidden", () => overlay.State.Value == Visibility.Hidden);
@@ -188,7 +188,7 @@ namespace osu.Game.Tests.Visual.UserInterface
             AddStep("run notification action", () => lastNotification.Activated());
 
             AddAssert("overlay shown", () => overlay.State.Value == Visibility.Visible);
-            AddAssert("is resumed", () => overlay.CurrentScreen is ScreenUIScale);
+            AddAssert("is resumed", () => overlay.CurrentScreen is ScreenBeatmaps);
         }
     }
 }

From 32ad2166698528574947aca2c17fe28eb35d2757 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 28 Apr 2022 22:58:32 +0900
Subject: [PATCH 4386/5547] Allow dragging the osu! logo

Logic borrowed from `NowPlayingOverlay`.
---
 osu.Game/Screens/Menu/OsuLogo.cs | 23 ++++++++++++++++++++++-
 1 file changed, 22 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Menu/OsuLogo.cs b/osu.Game/Screens/Menu/OsuLogo.cs
index 1d3aef0653..1217a28fe7 100644
--- a/osu.Game/Screens/Menu/OsuLogo.cs
+++ b/osu.Game/Screens/Menu/OsuLogo.cs
@@ -109,7 +109,7 @@ namespace osu.Game.Screens.Menu
                     AutoSizeAxes = Axes.Both,
                     Children = new Drawable[]
                     {
-                        logoBounceContainer = new Container
+                        logoBounceContainer = new DragContainer
                         {
                             AutoSizeAxes = Axes.Both,
                             Children = new Drawable[]
@@ -402,5 +402,26 @@ namespace osu.Game.Screens.Menu
             impactContainer.ScaleTo(0.96f);
             impactContainer.ScaleTo(1.12f, 250);
         }
+
+        private class DragContainer : Container
+        {
+            protected override bool OnDragStart(DragStartEvent e) => true;
+
+            protected override void OnDrag(DragEvent e)
+            {
+                Vector2 change = e.MousePosition - e.MouseDownPosition;
+
+                // Diminish the drag distance as we go further to simulate "rubber band" feeling.
+                change *= change.Length <= 0 ? 0 : MathF.Pow(change.Length, 0.6f) / change.Length;
+
+                this.MoveTo(change);
+            }
+
+            protected override void OnDragEnd(DragEndEvent e)
+            {
+                this.MoveTo(Vector2.Zero, 800, Easing.OutElastic);
+                base.OnDragEnd(e);
+            }
+        }
     }
 }

From d5702e29558f7845e27e4a60bbf2c88231535d3f Mon Sep 17 00:00:00 2001
From: Pasi4K5 <pascal.pomper03@gmail.com>
Date: Thu, 28 Apr 2022 18:29:37 +0200
Subject: [PATCH 4387/5547] Append incompatible mods to `base.IncompatibleMods`

---
 osu.Game.Rulesets.Osu/Mods/OsuModClassic.cs | 2 +-
 osu.Game.Rulesets.Osu/Mods/OsuModRandom.cs  | 2 +-
 osu.Game.Rulesets.Osu/Mods/OsuModTarget.cs  | 4 ++--
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModClassic.cs b/osu.Game.Rulesets.Osu/Mods/OsuModClassic.cs
index 5d262cd95e..b27b1a7267 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModClassic.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModClassic.cs
@@ -17,7 +17,7 @@ namespace osu.Game.Rulesets.Osu.Mods
 {
     public class OsuModClassic : ModClassic, IApplicableToHitObject, IApplicableToDrawableHitObject, IApplicableToDrawableRuleset<OsuHitObject>
     {
-        public override Type[] IncompatibleMods => new[] { typeof(OsuModStrictTracking), typeof(OsuModTarget) };
+        public override Type[] IncompatibleMods => base.IncompatibleMods.Concat(new[] { typeof(OsuModStrictTracking), typeof(OsuModTarget) }).ToArray();
 
         [SettingSource("No slider head accuracy requirement", "Scores sliders proportionally to the number of ticks hit.")]
         public Bindable<bool> NoSliderHeadAccuracy { get; } = new BindableBool(true);
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModRandom.cs b/osu.Game.Rulesets.Osu/Mods/OsuModRandom.cs
index 7a7e189c29..23500f5da6 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModRandom.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModRandom.cs
@@ -22,7 +22,7 @@ namespace osu.Game.Rulesets.Osu.Mods
     {
         public override string Description => "It never gets boring!";
 
-        public override Type[] IncompatibleMods => new[] { typeof(OsuModTarget) };
+        public override Type[] IncompatibleMods => base.IncompatibleMods.Append(typeof(OsuModTarget)).ToArray();
 
         private static readonly float playfield_diagonal = OsuPlayfield.BASE_SIZE.LengthFast;
 
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModTarget.cs b/osu.Game.Rulesets.Osu/Mods/OsuModTarget.cs
index 4d6c09f919..bb21550c56 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModTarget.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModTarget.cs
@@ -42,7 +42,7 @@ namespace osu.Game.Rulesets.Osu.Mods
         public override string Description => @"Practice keeping up with the beat of the song.";
         public override double ScoreMultiplier => 1;
 
-        public override Type[] IncompatibleMods => new[]
+        public override Type[] IncompatibleMods => base.IncompatibleMods.Concat(new[]
         {
             typeof(IRequiresApproachCircles),
             typeof(OsuModClassic),
@@ -50,7 +50,7 @@ namespace osu.Game.Rulesets.Osu.Mods
             typeof(OsuModSpunOut),
             typeof(OsuModStrictTracking),
             typeof(OsuModSuddenDeath)
-        };
+        }).ToArray();
 
         [SettingSource("Seed", "Use a custom seed instead of a random one", SettingControlType = typeof(SettingsNumberBox))]
         public Bindable<int?> Seed { get; } = new Bindable<int?>

From fa5c05120c913dd9c5931d7e92a84d8ba5b4b4c0 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 28 Apr 2022 20:04:52 +0300
Subject: [PATCH 4388/5547] Allow rewinding random in song select with Shift +
 Left Click

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

diff --git a/osu.Game/Screens/Select/FooterButtonRandom.cs b/osu.Game/Screens/Select/FooterButtonRandom.cs
index 1d4722cf5d..5cdf381879 100644
--- a/osu.Game/Screens/Select/FooterButtonRandom.cs
+++ b/osu.Game/Screens/Select/FooterButtonRandom.cs
@@ -59,6 +59,18 @@ namespace osu.Game.Screens.Select
             };
         }
 
+        protected override bool OnClick(ClickEvent e)
+        {
+            rewindSearch = e.ShiftPressed;
+            return base.OnClick(e);
+        }
+
+        protected override void OnMouseUp(MouseUpEvent e)
+        {
+            rewindSearch = false;
+            base.OnMouseUp(e);
+        }
+
         public override bool OnPressed(KeyBindingPressEvent<GlobalAction> e)
         {
             rewindSearch = e.Action == GlobalAction.SelectPreviousRandom;

From e31fdc28ddbadae1e8bd2150d6ea695bd4b133e6 Mon Sep 17 00:00:00 2001
From: Pasi4K5 <pascal.pomper03@gmail.com>
Date: Thu, 28 Apr 2022 22:31:48 +0200
Subject: [PATCH 4389/5547] Make Classic and Target compatible again

---
 osu.Game.Rulesets.Osu/Mods/OsuModClassic.cs | 2 +-
 osu.Game.Rulesets.Osu/Mods/OsuModTarget.cs  | 1 -
 2 files changed, 1 insertion(+), 2 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModClassic.cs b/osu.Game.Rulesets.Osu/Mods/OsuModClassic.cs
index b27b1a7267..76ff361ce3 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModClassic.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModClassic.cs
@@ -17,7 +17,7 @@ namespace osu.Game.Rulesets.Osu.Mods
 {
     public class OsuModClassic : ModClassic, IApplicableToHitObject, IApplicableToDrawableHitObject, IApplicableToDrawableRuleset<OsuHitObject>
     {
-        public override Type[] IncompatibleMods => base.IncompatibleMods.Concat(new[] { typeof(OsuModStrictTracking), typeof(OsuModTarget) }).ToArray();
+        public override Type[] IncompatibleMods => base.IncompatibleMods.Append(typeof(OsuModStrictTracking)).ToArray();
 
         [SettingSource("No slider head accuracy requirement", "Scores sliders proportionally to the number of ticks hit.")]
         public Bindable<bool> NoSliderHeadAccuracy { get; } = new BindableBool(true);
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModTarget.cs b/osu.Game.Rulesets.Osu/Mods/OsuModTarget.cs
index bb21550c56..5b121f4673 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModTarget.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModTarget.cs
@@ -45,7 +45,6 @@ namespace osu.Game.Rulesets.Osu.Mods
         public override Type[] IncompatibleMods => base.IncompatibleMods.Concat(new[]
         {
             typeof(IRequiresApproachCircles),
-            typeof(OsuModClassic),
             typeof(OsuModRandom),
             typeof(OsuModSpunOut),
             typeof(OsuModStrictTracking),

From 294340279eb5614a8a6d1c23d305b6ba9aa5a174 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 29 Apr 2022 04:14:09 +0300
Subject: [PATCH 4390/5547] Add inputting test coverage

---
 .../SongSelect/TestSceneSongSelectFooter.cs   | 90 ++++++++++++++-----
 1 file changed, 70 insertions(+), 20 deletions(-)

diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneSongSelectFooter.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneSongSelectFooter.cs
index 0ac65b357c..6485123b29 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneSongSelectFooter.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneSongSelectFooter.cs
@@ -1,35 +1,85 @@
 // 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.Game.Screens.Select;
+using osuTK.Input;
 
 namespace osu.Game.Tests.Visual.SongSelect
 {
     public class TestSceneSongSelectFooter : OsuManualInputManagerTestScene
     {
-        public TestSceneSongSelectFooter()
-        {
-            AddStep("Create footer", () =>
-            {
-                Footer footer;
-                AddRange(new Drawable[]
-                {
-                    footer = new Footer
-                    {
-                        Anchor = Anchor.Centre,
-                        Origin = Anchor.Centre,
-                    }
-                });
+        private FooterButtonRandom randomButton;
 
-                footer.AddButton(new FooterButtonMods(), null);
-                footer.AddButton(new FooterButtonRandom
-                {
-                    NextRandom = () => { },
-                    PreviousRandom = () => { },
-                }, null);
-                footer.AddButton(new FooterButtonOptions(), null);
+        private bool nextRandomCalled;
+        private bool previousRandomCalled;
+
+        [SetUp]
+        public void SetUp() => Schedule(() =>
+        {
+            nextRandomCalled = false;
+            previousRandomCalled = false;
+
+            Footer footer;
+
+            Child = footer = new Footer
+            {
+                Anchor = Anchor.Centre,
+                Origin = Anchor.Centre,
+            };
+
+            footer.AddButton(new FooterButtonMods(), null);
+            footer.AddButton(randomButton = new FooterButtonRandom
+            {
+                NextRandom = () => nextRandomCalled = true,
+                PreviousRandom = () => previousRandomCalled = true,
+            }, null);
+            footer.AddButton(new FooterButtonOptions(), null);
+        });
+
+        [Test]
+        public void TestFooterRandom()
+        {
+            AddStep("press F2", () => InputManager.Key(Key.F2));
+            AddAssert("next random invoked", () => nextRandomCalled && !previousRandomCalled);
+        }
+
+        [Test]
+        public void TestFooterRandomViaMouse()
+        {
+            AddStep("click button", () =>
+            {
+                InputManager.MoveMouseTo(randomButton);
+                InputManager.Click(MouseButton.Left);
             });
+            AddAssert("next random invoked", () => nextRandomCalled && !previousRandomCalled);
+        }
+
+        [Test]
+        public void TestFooterRewind()
+        {
+            AddStep("press Shift+F2", () =>
+            {
+                InputManager.PressKey(Key.LShift);
+                InputManager.PressKey(Key.F2);
+                InputManager.ReleaseKey(Key.F2);
+                InputManager.ReleaseKey(Key.LShift);
+            });
+            AddAssert("previous random invoked", () => previousRandomCalled && !nextRandomCalled);
+        }
+
+        [Test]
+        public void TestFooterRewindViaMouse()
+        {
+            AddStep("shift + click button", () =>
+            {
+                InputManager.PressKey(Key.LShift);
+                InputManager.MoveMouseTo(randomButton);
+                InputManager.Click(MouseButton.Left);
+                InputManager.ReleaseKey(Key.LShift);
+            });
+            AddAssert("previous random invoked", () => previousRandomCalled && !nextRandomCalled);
         }
     }
 }

From 7442ae283cee27f591c76c80de62c915d190829d Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 29 Apr 2022 05:24:00 +0300
Subject: [PATCH 4391/5547] Tidy up test cases a touch

---
 .../Mods/TestSceneOsuModAlternate.cs          | 60 +++++++++++--------
 1 file changed, 35 insertions(+), 25 deletions(-)

diff --git a/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModAlternate.cs b/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModAlternate.cs
index de1f61a0bd..67654c11f2 100644
--- a/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModAlternate.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModAlternate.cs
@@ -16,31 +16,6 @@ namespace osu.Game.Rulesets.Osu.Tests.Mods
 {
     public class TestSceneOsuModAlternate : OsuModTestScene
     {
-        [Test]
-        public void TestInputAtIntro() => CreateModTest(new ModTestData
-        {
-            Mod = new OsuModAlternate(),
-            PassCondition = () => Player.ScoreProcessor.Combo.Value == 1,
-            Autoplay = false,
-            Beatmap = new Beatmap
-            {
-                HitObjects = new List<HitObject>
-                {
-                    new HitCircle
-                    {
-                        StartTime = 1000,
-                        Position = new Vector2(100),
-                    },
-                },
-            },
-            ReplayFrames = new List<ReplayFrame>
-            {
-                new OsuReplayFrame(500, new Vector2(200), OsuAction.LeftButton),
-                new OsuReplayFrame(501, new Vector2(200)),
-                new OsuReplayFrame(1000, new Vector2(100), OsuAction.LeftButton),
-            }
-        });
-
         [Test]
         public void TestInputAlternating() => CreateModTest(new ModTestData
         {
@@ -116,6 +91,39 @@ namespace osu.Game.Rulesets.Osu.Tests.Mods
             }
         });
 
+        /// <summary>
+        /// Ensures alternation is reset before the first hitobject after intro.
+        /// </summary>
+        [Test]
+        public void TestInputSingularAtIntro() => CreateModTest(new ModTestData
+        {
+            Mod = new OsuModAlternate(),
+            PassCondition = () => Player.ScoreProcessor.Combo.Value == 1,
+            Autoplay = false,
+            Beatmap = new Beatmap
+            {
+                HitObjects = new List<HitObject>
+                {
+                    new HitCircle
+                    {
+                        StartTime = 1000,
+                        Position = new Vector2(100),
+                    },
+                },
+            },
+            ReplayFrames = new List<ReplayFrame>
+            {
+                // first press during intro.
+                new OsuReplayFrame(500, new Vector2(200), OsuAction.LeftButton),
+                new OsuReplayFrame(501, new Vector2(200)),
+                // press same key at hitobject and ensure it has been hit.
+                new OsuReplayFrame(1000, new Vector2(100), OsuAction.LeftButton),
+            }
+        });
+
+        /// <summary>
+        /// Ensures alternation is reset after a break.
+        /// </summary>
         [Test]
         public void TestInputSingularWithBreak() => CreateModTest(new ModTestData
         {
@@ -144,8 +152,10 @@ namespace osu.Game.Rulesets.Osu.Tests.Mods
             },
             ReplayFrames = new List<ReplayFrame>
             {
+                // first press to start alternate lock.
                 new OsuReplayFrame(500, new Vector2(100), OsuAction.LeftButton),
                 new OsuReplayFrame(501, new Vector2(100)),
+                // press same key at second hitobject and ensure it has been hit.
                 new OsuReplayFrame(2500, new Vector2(100), OsuAction.LeftButton),
                 new OsuReplayFrame(2501, new Vector2(100)),
             }

From 845e7dba95d28d2d37bf8502db04ee7910cb0e63 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 29 Apr 2022 11:27:14 +0900
Subject: [PATCH 4392/5547] Reduce padding slightly to restore usability of UI
 scale screen

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

diff --git a/osu.Game/Overlays/FirstRunSetupOverlay.cs b/osu.Game/Overlays/FirstRunSetupOverlay.cs
index c3dcdef318..4277f0f2ba 100644
--- a/osu.Game/Overlays/FirstRunSetupOverlay.cs
+++ b/osu.Game/Overlays/FirstRunSetupOverlay.cs
@@ -84,7 +84,7 @@ namespace osu.Game.Overlays
                     Anchor = Anchor.Centre,
                     Origin = Anchor.Centre,
                     RelativeSizeAxes = Axes.Both,
-                    Padding = new MarginPadding { Horizontal = 70 * 2 },
+                    Padding = new MarginPadding { Horizontal = 70 * 1.2f },
                     Child = new InputBlockingContainer
                     {
                         Masking = true,

From 723d70be7096b300e86568b937b2f2998f4ded56 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 29 Apr 2022 05:26:19 +0300
Subject: [PATCH 4393/5547] Change `TestInputSingularWithBreak` to reproduce
 case of pressing before second object

---
 .../Mods/TestSceneOsuModAlternate.cs          | 25 +++++++++++++------
 1 file changed, 18 insertions(+), 7 deletions(-)

diff --git a/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModAlternate.cs b/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModAlternate.cs
index 67654c11f2..5e46498aca 100644
--- a/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModAlternate.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModAlternate.cs
@@ -122,19 +122,19 @@ namespace osu.Game.Rulesets.Osu.Tests.Mods
         });
 
         /// <summary>
-        /// Ensures alternation is reset after a break.
+        /// Ensures alternation is reset before the first hitobject after a break.
         /// </summary>
         [Test]
         public void TestInputSingularWithBreak() => CreateModTest(new ModTestData
         {
             Mod = new OsuModAlternate(),
-            PassCondition = () => Player.ScoreProcessor.Combo.Value == 2,
+            PassCondition = () => Player.ScoreProcessor.Combo.Value == 0 && Player.ScoreProcessor.HighestCombo.Value == 2,
             Autoplay = false,
             Beatmap = new Beatmap
             {
                 Breaks = new List<BreakPeriod>
                 {
-                    new BreakPeriod(500, 2250),
+                    new BreakPeriod(500, 2000),
                 },
                 HitObjects = new List<HitObject>
                 {
@@ -146,8 +146,13 @@ namespace osu.Game.Rulesets.Osu.Tests.Mods
                     new HitCircle
                     {
                         StartTime = 2500,
-                        Position = new Vector2(100),
-                    }
+                        Position = new Vector2(500, 100),
+                    },
+                    new HitCircle
+                    {
+                        StartTime = 3000,
+                        Position = new Vector2(500, 100),
+                    },
                 }
             },
             ReplayFrames = new List<ReplayFrame>
@@ -155,9 +160,15 @@ namespace osu.Game.Rulesets.Osu.Tests.Mods
                 // first press to start alternate lock.
                 new OsuReplayFrame(500, new Vector2(100), OsuAction.LeftButton),
                 new OsuReplayFrame(501, new Vector2(100)),
+                // press same key after break but before hit object.
+                new OsuReplayFrame(2250, new Vector2(300, 100), OsuAction.LeftButton),
+                new OsuReplayFrame(2251, new Vector2(300, 100)),
                 // press same key at second hitobject and ensure it has been hit.
-                new OsuReplayFrame(2500, new Vector2(100), OsuAction.LeftButton),
-                new OsuReplayFrame(2501, new Vector2(100)),
+                new OsuReplayFrame(2500, new Vector2(500, 100), OsuAction.LeftButton),
+                new OsuReplayFrame(2501, new Vector2(500, 100)),
+                // press same key at third hitobject and ensure it has been missed.
+                new OsuReplayFrame(3000, new Vector2(500, 100), OsuAction.LeftButton),
+                new OsuReplayFrame(3001, new Vector2(500, 100)),
             }
         });
     }

From 92d4463e55acf51e8707d3eddbba642ec6a22541 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 29 Apr 2022 11:45:18 +0900
Subject: [PATCH 4394/5547] Add "always bundled" beatmaps

---
 .../Beatmaps/Drawables/BundledBeatmapDownloader.cs    | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/osu.Game/Beatmaps/Drawables/BundledBeatmapDownloader.cs b/osu.Game/Beatmaps/Drawables/BundledBeatmapDownloader.cs
index bc99aa4a5a..df0a69cb25 100644
--- a/osu.Game/Beatmaps/Drawables/BundledBeatmapDownloader.cs
+++ b/osu.Game/Beatmaps/Drawables/BundledBeatmapDownloader.cs
@@ -44,6 +44,8 @@ namespace osu.Game.Beatmaps.Drawables
             }
             else
             {
+                queueDownloads(always_bundled_beatmaps);
+
                 queueDownloads(bundled_osu, 8);
                 queueDownloads(bundled_taiko, 3);
                 queueDownloads(bundled_catch, 3);
@@ -120,6 +122,15 @@ namespace osu.Game.Beatmaps.Drawables
 
         private const string tutorial_filename = "1011011 nekodex - new beginnings.osz";
 
+        /// <summary>
+        /// Contest winners or other special cases.
+        /// </summary>
+        private static readonly string[] always_bundled_beatmaps =
+        {
+            // This thing is 40mb, I'm not sure we want it here...
+            @"1388906 Raphlesia & BilliumMoto - My Love.osz"
+        };
+
         private static readonly string[] bundled_osu =
         {
             "682286 Yuyoyuppe - Emerald Galaxy.osz",

From 6ccbdc85a37fc172159f591762efe4110875e3fe Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 29 Apr 2022 11:56:46 +0900
Subject: [PATCH 4395/5547] Improve setting description text
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/Screens/Play/SongProgress.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Play/SongProgress.cs b/osu.Game/Screens/Play/SongProgress.cs
index a21a08e558..b38dcb937d 100644
--- a/osu.Game/Screens/Play/SongProgress.cs
+++ b/osu.Game/Screens/Play/SongProgress.cs
@@ -42,7 +42,7 @@ namespace osu.Game.Screens.Play
         /// </summary>
         public readonly Bindable<bool> AllowSeeking = new Bindable<bool>();
 
-        [SettingSource("Show difficulty graph", "Whether a graph should show difficulty throughout the beatmap")]
+        [SettingSource("Show difficulty graph", "Whether a graph displaying difficulty throughout the beatmap should be shown")]
         public Bindable<bool> ShowGraph { get; } = new BindableBool(true);
 
         public override bool HandleNonPositionalInput => AllowSeeking.Value;

From 22e9620211fd32352494ef48ba336dad178471b3 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 29 Apr 2022 12:09:11 +0900
Subject: [PATCH 4396/5547] Don't block clicks when dragging osu! logo

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

diff --git a/osu.Game/Screens/Menu/OsuLogo.cs b/osu.Game/Screens/Menu/OsuLogo.cs
index 1217a28fe7..f5743c7d5a 100644
--- a/osu.Game/Screens/Menu/OsuLogo.cs
+++ b/osu.Game/Screens/Menu/OsuLogo.cs
@@ -405,6 +405,8 @@ namespace osu.Game.Screens.Menu
 
         private class DragContainer : Container
         {
+            public override bool DragBlocksClick => false;
+
             protected override bool OnDragStart(DragStartEvent e) => true;
 
             protected override void OnDrag(DragEvent e)

From d7441fbcd443464ca8e2e108ac677e68b42f1f51 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 29 Apr 2022 12:16:37 +0900
Subject: [PATCH 4397/5547] Move diagnostic down

---
 .editorconfig | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/.editorconfig b/.editorconfig
index 49e83c9103..840fa98334 100644
--- a/.editorconfig
+++ b/.editorconfig
@@ -175,8 +175,6 @@ csharp_style_prefer_switch_expression = false:none
 #Supressing roslyn built-in analyzers
 # Suppress: EC112
 
-dotnet_diagnostic.OLOC001.words_in_name = 5
-
 #Private method is unused
 dotnet_diagnostic.IDE0051.severity = silent
 #Private member is unused
@@ -193,4 +191,5 @@ dotnet_diagnostic.CA2225.severity = none
 # Banned APIs
 dotnet_diagnostic.RS0030.severity = error
 
+dotnet_diagnostic.OLOC001.words_in_name = 5
 dotnet_diagnostic.OLOC001.license_header = // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.\n// See the LICENCE file in the repository root for full licence text.

From a4ca8bfe75ab0aa19c3aa20275492cdfe4a182fa Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 29 Apr 2022 05:26:56 +0300
Subject: [PATCH 4398/5547] Improve "Alternate" to reset before first hitobject
 after break

---
 osu.Game.Rulesets.Osu/Mods/OsuModAlternate.cs | 51 +++++++++++--------
 1 file changed, 31 insertions(+), 20 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModAlternate.cs b/osu.Game.Rulesets.Osu/Mods/OsuModAlternate.cs
index 46b97dd23b..dfa28a537a 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModAlternate.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModAlternate.cs
@@ -2,21 +2,24 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
+using System.Collections.Generic;
 using System.Linq;
-using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Input.Bindings;
 using osu.Framework.Input.Events;
+using osu.Game.Beatmaps.Timing;
 using osu.Game.Rulesets.Mods;
+using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Osu.Objects;
 using osu.Game.Rulesets.Scoring;
 using osu.Game.Rulesets.UI;
 using osu.Game.Screens.Play;
+using osu.Game.Utils;
 
 namespace osu.Game.Rulesets.Osu.Mods
 {
-    public class OsuModAlternate : Mod, IApplicableToDrawableRuleset<OsuHitObject>, IApplicableToPlayer
+    public class OsuModAlternate : Mod, IApplicableToDrawableRuleset<OsuHitObject>
     {
         public override string Name => @"Alternate";
         public override string Acronym => @"AL";
@@ -26,9 +29,16 @@ namespace osu.Game.Rulesets.Osu.Mods
         public override ModType Type => ModType.Conversion;
         public override IconUsage? Icon => FontAwesome.Solid.Keyboard;
 
-        private double firstObjectValidJudgementTime;
-        private IBindable<bool> isBreakTime;
         private const double flash_duration = 1000;
+
+        /// <summary>
+        /// A tracker for periods where alternate should not be forced (i.e. non-gameplay periods).
+        /// </summary>
+        /// <remarks>
+        /// This is different from <see cref="Player.IsBreakTime"/> in that the periods here end strictly at the first object after the break, rather than the break's end time.
+        /// </remarks>
+        private PeriodTracker nonGameplayPeriods;
+
         private OsuAction? lastActionPressed;
         private DrawableRuleset<OsuHitObject> ruleset;
 
@@ -39,29 +49,30 @@ namespace osu.Game.Rulesets.Osu.Mods
             ruleset = drawableRuleset;
             drawableRuleset.KeyBindingInputManager.Add(new InputInterceptor(this));
 
-            var firstHitObject = ruleset.Objects.FirstOrDefault();
-            firstObjectValidJudgementTime = (firstHitObject?.StartTime ?? 0) - (firstHitObject?.HitWindows.WindowFor(HitResult.Meh) ?? 0);
+            var periods = new List<Period>();
+
+            if (drawableRuleset.Objects.Any())
+            {
+                periods.Add(new Period(int.MinValue, getValidJudgementTime(ruleset.Objects.First()) - 1));
+
+                foreach (BreakPeriod b in drawableRuleset.Beatmap.Breaks)
+                    periods.Add(new Period(b.StartTime, getValidJudgementTime(ruleset.Objects.First(h => h.StartTime >= b.EndTime)) - 1));
+
+                static double getValidJudgementTime(HitObject hitObject) => hitObject.StartTime - hitObject.HitWindows.WindowFor(HitResult.Meh);
+            }
+
+            nonGameplayPeriods = new PeriodTracker(periods);
 
             gameplayClock = drawableRuleset.FrameStableClock;
         }
 
-        public void ApplyToPlayer(Player player)
-        {
-            isBreakTime = player.IsBreakTime.GetBoundCopy();
-            isBreakTime.ValueChanged += e =>
-            {
-                if (e.NewValue)
-                    lastActionPressed = null;
-            };
-        }
-
         private bool checkCorrectAction(OsuAction action)
         {
-            if (isBreakTime.Value)
-                return true;
-
-            if (gameplayClock.CurrentTime < firstObjectValidJudgementTime)
+            if (nonGameplayPeriods.IsInAny(gameplayClock.CurrentTime))
+            {
+                lastActionPressed = null;
                 return true;
+            }
 
             switch (action)
             {

From ee99b949402e7917dc579a84dd9a2fbfae9a5708 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 29 Apr 2022 13:46:18 +0900
Subject: [PATCH 4399/5547] Fix return condition from `EnsureMutableSkin` not
 accounting for "failed" imports

---
 osu.Game/Skinning/SkinManager.cs | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Skinning/SkinManager.cs b/osu.Game/Skinning/SkinManager.cs
index 77e60d179c..5e1902f520 100644
--- a/osu.Game/Skinning/SkinManager.cs
+++ b/osu.Game/Skinning/SkinManager.cs
@@ -174,9 +174,10 @@ namespace osu.Game.Skinning
                     // currently this only happens on save.
                     result.PerformRead(skin => Save(skin.CreateInstance(this)));
                     CurrentSkinInfo.Value = result;
+                    return true;
                 }
 
-                return true;
+                return false;
             });
         }
 

From 7e3d1511c67d620ba2dc63059c6cec86ed25d244 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 29 Apr 2022 06:55:44 +0300
Subject: [PATCH 4400/5547] Hide "Rank Achieved" sorting mode until it's
 supported

---
 osu.Game/Screens/Select/Filter/SortMode.cs | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/Select/Filter/SortMode.cs b/osu.Game/Screens/Select/Filter/SortMode.cs
index 1ab54fa069..5dfa2a2664 100644
--- a/osu.Game/Screens/Select/Filter/SortMode.cs
+++ b/osu.Game/Screens/Select/Filter/SortMode.cs
@@ -27,8 +27,9 @@ namespace osu.Game.Screens.Select.Filter
         [LocalisableDescription(typeof(SortStrings), nameof(SortStrings.ArtistTracksLength))]
         Length,
 
-        [LocalisableDescription(typeof(BeatmapsStrings), nameof(BeatmapsStrings.ListingSearchFiltersRank))]
-        RankAchieved,
+        // todo: pending support (https://github.com/ppy/osu/issues/4917)
+        // [LocalisableDescription(typeof(BeatmapsStrings), nameof(BeatmapsStrings.ListingSearchFiltersRank))]
+        // RankAchieved,
 
         [LocalisableDescription(typeof(BeatmapsetsStrings), nameof(BeatmapsetsStrings.ShowInfoSource))]
         Source,

From ef56dc07b5eea8392407aec09de8f3adbd1e8681 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 29 Apr 2022 06:55:58 +0300
Subject: [PATCH 4401/5547] Hide "modding" tab in user profile until it's
 implemented

---
 osu.Game/Overlays/Profile/ProfileHeader.cs | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/Profile/ProfileHeader.cs b/osu.Game/Overlays/Profile/ProfileHeader.cs
index fab2487c0d..44e0d9c37f 100644
--- a/osu.Game/Overlays/Profile/ProfileHeader.cs
+++ b/osu.Game/Overlays/Profile/ProfileHeader.cs
@@ -31,7 +31,9 @@ namespace osu.Game.Overlays.Profile
             User.ValueChanged += e => updateDisplay(e.NewValue);
 
             TabControl.AddItem(LayoutStrings.HeaderUsersShow);
-            TabControl.AddItem(LayoutStrings.HeaderUsersModding);
+
+            // todo: pending implementation.
+            // TabControl.AddItem(LayoutStrings.HeaderUsersModding);
 
             centreHeaderContainer.DetailsVisible.BindValueChanged(visible => detailHeaderContainer.Expanded = visible.NewValue, true);
         }

From fef94d49f4a57b1a1ac7bfd4fa5ef87278e2f049 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 29 Apr 2022 08:02:07 +0300
Subject: [PATCH 4402/5547] Revert "Convert data type of `DistanceSpacing` to
 float"

This reverts commit 7aaa88cac2be239dcc778a1082585f8e8d5a7e55.
---
 .../Editor/TestSceneOsuDistanceSnapGrid.cs         |  2 +-
 .../TestSceneHitObjectComposerDistanceSnapping.cs  |  2 +-
 .../Visual/Editing/TestSceneDistanceSnapGrid.cs    |  2 +-
 .../UserInterface/TestSceneExpandingContainer.cs   |  4 ++--
 osu.Game/Beatmaps/BeatmapInfo.cs                   |  2 +-
 osu.Game/Beatmaps/EFBeatmapInfo.cs                 |  2 +-
 osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs  |  2 +-
 .../Settings/Sections/Gameplay/InputSettings.cs    |  2 +-
 osu.Game/Overlays/Settings/Sections/SizeSlider.cs  |  7 +++++--
 .../Sections/UserInterface/GeneralSettings.cs      |  2 +-
 .../Rulesets/Edit/DistancedHitObjectComposer.cs    | 14 +++++++-------
 osu.Game/Rulesets/Edit/IDistanceSnapProvider.cs    |  2 +-
 .../Edit/Compose/Components/DistanceSnapGrid.cs    |  2 +-
 13 files changed, 24 insertions(+), 21 deletions(-)

diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuDistanceSnapGrid.cs b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuDistanceSnapGrid.cs
index 4cccddddf3..2ba30c5f74 100644
--- a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuDistanceSnapGrid.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuDistanceSnapGrid.cs
@@ -187,7 +187,7 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
 
             public SnapResult SnapScreenSpacePositionToValidTime(Vector2 screenSpacePosition) => new SnapResult(screenSpacePosition, 0);
 
-            public IBindable<float> DistanceSpacingMultiplier { get; } = new BindableFloat(1);
+            public IBindable<double> DistanceSpacingMultiplier { get; } = new BindableDouble(1);
 
             public float GetBeatSnapDistanceAt(HitObject referenceObject) => (float)beat_length;
 
diff --git a/osu.Game.Tests/Editing/TestSceneHitObjectComposerDistanceSnapping.cs b/osu.Game.Tests/Editing/TestSceneHitObjectComposerDistanceSnapping.cs
index 2c2c06ae0c..a2ee97210a 100644
--- a/osu.Game.Tests/Editing/TestSceneHitObjectComposerDistanceSnapping.cs
+++ b/osu.Game.Tests/Editing/TestSceneHitObjectComposerDistanceSnapping.cs
@@ -222,7 +222,7 @@ namespace osu.Game.Tests.Editing
         {
             public new EditorBeatmap EditorBeatmap => base.EditorBeatmap;
 
-            public new Bindable<float> DistanceSpacingMultiplier => base.DistanceSpacingMultiplier;
+            public new Bindable<double> DistanceSpacingMultiplier => base.DistanceSpacingMultiplier;
 
             public TestHitObjectComposer()
                 : base(new OsuRuleset())
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneDistanceSnapGrid.cs b/osu.Game.Tests/Visual/Editing/TestSceneDistanceSnapGrid.cs
index 20bf9b3fa0..b9cfa84a5d 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneDistanceSnapGrid.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneDistanceSnapGrid.cs
@@ -167,7 +167,7 @@ namespace osu.Game.Tests.Visual.Editing
 
             public SnapResult SnapScreenSpacePositionToValidTime(Vector2 screenSpacePosition) => new SnapResult(screenSpacePosition, 0);
 
-            public IBindable<float> DistanceSpacingMultiplier { get; } = new BindableFloat(1);
+            public IBindable<double> DistanceSpacingMultiplier { get; } = new BindableDouble(1);
 
             public float GetBeatSnapDistanceAt(HitObject referenceObject) => 10;
 
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneExpandingContainer.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneExpandingContainer.cs
index f4920b4412..288c0cb140 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneExpandingContainer.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneExpandingContainer.cs
@@ -17,7 +17,7 @@ namespace osu.Game.Tests.Visual.UserInterface
         private TestExpandingContainer container;
         private SettingsToolboxGroup toolboxGroup;
 
-        private ExpandableSlider<float, SizeSlider> slider1;
+        private ExpandableSlider<float, SizeSlider<float>> slider1;
         private ExpandableSlider<double> slider2;
 
         [SetUp]
@@ -34,7 +34,7 @@ namespace osu.Game.Tests.Visual.UserInterface
                     Width = 1,
                     Children = new Drawable[]
                     {
-                        slider1 = new ExpandableSlider<float, SizeSlider>
+                        slider1 = new ExpandableSlider<float, SizeSlider<float>>
                         {
                             Current = new BindableFloat
                             {
diff --git a/osu.Game/Beatmaps/BeatmapInfo.cs b/osu.Game/Beatmaps/BeatmapInfo.cs
index 1b364247a8..1a9703f478 100644
--- a/osu.Game/Beatmaps/BeatmapInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapInfo.cs
@@ -109,7 +109,7 @@ namespace osu.Game.Beatmaps
 
         public bool SamplesMatchPlaybackRate { get; set; } = true;
 
-        public float DistanceSpacing { get; set; } = 1.0f;
+        public double DistanceSpacing { get; set; } = 1.0;
 
         public int BeatDivisor { get; set; }
 
diff --git a/osu.Game/Beatmaps/EFBeatmapInfo.cs b/osu.Game/Beatmaps/EFBeatmapInfo.cs
index 67c4dbe788..740adfd1c7 100644
--- a/osu.Game/Beatmaps/EFBeatmapInfo.cs
+++ b/osu.Game/Beatmaps/EFBeatmapInfo.cs
@@ -107,7 +107,7 @@ namespace osu.Game.Beatmaps
         [NotMapped]
         public int[] Bookmarks { get; set; } = Array.Empty<int>();
 
-        public float DistanceSpacing { get; set; }
+        public double DistanceSpacing { get; set; }
         public int BeatDivisor { get; set; }
         public int GridSize { get; set; }
         public double TimelineZoom { get; set; }
diff --git a/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs b/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
index 0ba7a07010..79d8bd3bb3 100644
--- a/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
+++ b/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
@@ -240,7 +240,7 @@ namespace osu.Game.Beatmaps.Formats
                     break;
 
                 case @"DistanceSpacing":
-                    beatmap.BeatmapInfo.DistanceSpacing = Math.Max(0, Parsing.ParseFloat(pair.Value));
+                    beatmap.BeatmapInfo.DistanceSpacing = Math.Max(0, Parsing.ParseDouble(pair.Value));
                     break;
 
                 case @"BeatDivisor":
diff --git a/osu.Game/Overlays/Settings/Sections/Gameplay/InputSettings.cs b/osu.Game/Overlays/Settings/Sections/Gameplay/InputSettings.cs
index 962572ca6e..83ea655601 100644
--- a/osu.Game/Overlays/Settings/Sections/Gameplay/InputSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Gameplay/InputSettings.cs
@@ -19,7 +19,7 @@ namespace osu.Game.Overlays.Settings.Sections.Gameplay
         {
             Children = new Drawable[]
             {
-                new SettingsSlider<float, SizeSlider>
+                new SettingsSlider<float, SizeSlider<float>>
                 {
                     LabelText = SkinSettingsStrings.GameplayCursorSize,
                     Current = config.GetBindable<float>(OsuSetting.GameplayCursorSize),
diff --git a/osu.Game/Overlays/Settings/Sections/SizeSlider.cs b/osu.Game/Overlays/Settings/Sections/SizeSlider.cs
index 8aeb440be1..c8a46162af 100644
--- a/osu.Game/Overlays/Settings/Sections/SizeSlider.cs
+++ b/osu.Game/Overlays/Settings/Sections/SizeSlider.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.Globalization;
 using osu.Framework.Localisation;
 using osu.Game.Graphics.UserInterface;
 
@@ -9,8 +11,9 @@ namespace osu.Game.Overlays.Settings.Sections
     /// <summary>
     /// A slider intended to show a "size" multiplier number, where 1x is 1.0.
     /// </summary>
-    internal class SizeSlider : OsuSliderBar<float>
+    public class SizeSlider<T> : OsuSliderBar<T>
+        where T : struct, IEquatable<T>, IComparable<T>, IConvertible, IFormattable
     {
-        public override LocalisableString TooltipText => Current.Value.ToString(@"0.##x");
+        public override LocalisableString TooltipText => Current.Value.ToString(@"0.##x", NumberFormatInfo.CurrentInfo);
     }
 }
diff --git a/osu.Game/Overlays/Settings/Sections/UserInterface/GeneralSettings.cs b/osu.Game/Overlays/Settings/Sections/UserInterface/GeneralSettings.cs
index 6e1558f7d7..0e3b822c82 100644
--- a/osu.Game/Overlays/Settings/Sections/UserInterface/GeneralSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/UserInterface/GeneralSettings.cs
@@ -24,7 +24,7 @@ namespace osu.Game.Overlays.Settings.Sections.UserInterface
                     LabelText = UserInterfaceStrings.CursorRotation,
                     Current = config.GetBindable<bool>(OsuSetting.CursorRotation)
                 },
-                new SettingsSlider<float, SizeSlider>
+                new SettingsSlider<float, SizeSlider<float>>
                 {
                     LabelText = UserInterfaceStrings.MenuCursorSize,
                     Current = config.GetBindable<float>(OsuSetting.MenuCursorSize),
diff --git a/osu.Game/Rulesets/Edit/DistancedHitObjectComposer.cs b/osu.Game/Rulesets/Edit/DistancedHitObjectComposer.cs
index 1e1fbb4edf..0505f9ab0e 100644
--- a/osu.Game/Rulesets/Edit/DistancedHitObjectComposer.cs
+++ b/osu.Game/Rulesets/Edit/DistancedHitObjectComposer.cs
@@ -21,18 +21,18 @@ namespace osu.Game.Rulesets.Edit
     public abstract class DistancedHitObjectComposer<TObject> : HitObjectComposer<TObject>, IDistanceSnapProvider
         where TObject : HitObject
     {
-        protected Bindable<float> DistanceSpacingMultiplier { get; } = new BindableFloat(1.0f)
+        protected Bindable<double> DistanceSpacingMultiplier { get; } = new BindableDouble(1.0)
         {
-            MinValue = 0.1f,
-            MaxValue = 6.0f,
-            Precision = 0.01f,
+            MinValue = 0.1,
+            MaxValue = 6.0,
+            Precision = 0.01,
         };
 
-        IBindable<float> IDistanceSnapProvider.DistanceSpacingMultiplier => DistanceSpacingMultiplier;
+        IBindable<double> IDistanceSnapProvider.DistanceSpacingMultiplier => DistanceSpacingMultiplier;
 
         protected ExpandingToolboxContainer RightSideToolboxContainer { get; private set; }
 
-        private ExpandableSlider<float, SizeSlider> distanceSpacingSlider;
+        private ExpandableSlider<double, SizeSlider<double>> distanceSpacingSlider;
         private bool distanceSpacingScrollActive;
 
         protected DistancedHitObjectComposer(Ruleset ruleset)
@@ -50,7 +50,7 @@ namespace osu.Game.Rulesets.Edit
                 Origin = Anchor.TopRight,
                 Child = new EditorToolboxGroup("snapping")
                 {
-                    Child = distanceSpacingSlider = new ExpandableSlider<float, SizeSlider>
+                    Child = distanceSpacingSlider = new ExpandableSlider<double, SizeSlider<double>>
                     {
                         Current = { BindTarget = DistanceSpacingMultiplier },
                         KeyboardStep = 0.1f,
diff --git a/osu.Game/Rulesets/Edit/IDistanceSnapProvider.cs b/osu.Game/Rulesets/Edit/IDistanceSnapProvider.cs
index 0eb572d22a..c6e866561e 100644
--- a/osu.Game/Rulesets/Edit/IDistanceSnapProvider.cs
+++ b/osu.Game/Rulesets/Edit/IDistanceSnapProvider.cs
@@ -13,7 +13,7 @@ namespace osu.Game.Rulesets.Edit
         /// The spacing multiplier applied to beat snap distances.
         /// </summary>
         /// <seealso cref="BeatmapInfo.DistanceSpacing"/>
-        IBindable<float> DistanceSpacingMultiplier { get; }
+        IBindable<double> DistanceSpacingMultiplier { get; }
 
         /// <summary>
         /// Retrieves the distance between two points within a timing point that are one beat length apart.
diff --git a/osu.Game/Screens/Edit/Compose/Components/DistanceSnapGrid.cs b/osu.Game/Screens/Edit/Compose/Components/DistanceSnapGrid.cs
index 13c3b713b1..2500bb1f60 100644
--- a/osu.Game/Screens/Edit/Compose/Components/DistanceSnapGrid.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/DistanceSnapGrid.cs
@@ -53,7 +53,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
         [Resolved]
         private BindableBeatDivisor beatDivisor { get; set; }
 
-        private IBindable<float> distanceSpacingMultiplier;
+        private IBindable<double> distanceSpacingMultiplier;
 
         private readonly LayoutValue gridCache = new LayoutValue(Invalidation.RequiredParentSizeToFit);
         private readonly double? endTime;

From 173a6188eb0d46db4a762e81213f1d377127140e Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 29 Apr 2022 08:41:37 +0300
Subject: [PATCH 4403/5547] Add back `float` cast to distance spacing
 computation

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

diff --git a/osu.Game/Screens/Edit/Compose/Components/DistanceSnapGrid.cs b/osu.Game/Screens/Edit/Compose/Components/DistanceSnapGrid.cs
index 2500bb1f60..5568c15514 100644
--- a/osu.Game/Screens/Edit/Compose/Components/DistanceSnapGrid.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/DistanceSnapGrid.cs
@@ -92,7 +92,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
 
         private void updateSpacing()
         {
-            DistanceSpacing = SnapProvider.GetBeatSnapDistanceAt(ReferenceObject) * distanceSpacingMultiplier.Value;
+            DistanceSpacing = (float)(SnapProvider.GetBeatSnapDistanceAt(ReferenceObject) * distanceSpacingMultiplier.Value);
 
             if (endTime == null)
                 MaxIntervals = int.MaxValue;

From a9d67d3e92dd9f892d0843ac5961172294346373 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 29 Apr 2022 10:10:19 +0300
Subject: [PATCH 4404/5547] Change random button text when holding shift key

---
 osu.Game/Screens/Select/FooterButtonRandom.cs | 16 +++++++++++++++-
 1 file changed, 15 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Select/FooterButtonRandom.cs b/osu.Game/Screens/Select/FooterButtonRandom.cs
index 5cdf381879..5f8fdce054 100644
--- a/osu.Game/Screens/Select/FooterButtonRandom.cs
+++ b/osu.Game/Screens/Select/FooterButtonRandom.cs
@@ -25,7 +25,7 @@ namespace osu.Game.Screens.Select
         {
             SelectedColour = colours.Green;
             DeselectedColour = SelectedColour.Opacity(0.5f);
-            Text = @"random";
+            updateText();
 
             Action = () =>
             {
@@ -59,6 +59,18 @@ namespace osu.Game.Screens.Select
             };
         }
 
+        protected override bool OnKeyDown(KeyDownEvent e)
+        {
+            updateText(e.ShiftPressed);
+            return base.OnKeyDown(e);
+        }
+
+        protected override void OnKeyUp(KeyUpEvent e)
+        {
+            updateText(e.ShiftPressed);
+            base.OnKeyUp(e);
+        }
+
         protected override bool OnClick(ClickEvent e)
         {
             rewindSearch = e.ShiftPressed;
@@ -91,5 +103,7 @@ namespace osu.Game.Screens.Select
                 rewindSearch = false;
             }
         }
+
+        private void updateText(bool rewind = false) => Text = rewind ? "rewind" : "random";
     }
 }

From 856ca96b66ec0073f42b290cbde260e04267c8eb Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 29 Apr 2022 10:12:20 +0300
Subject: [PATCH 4405/5547] Allow right-clicking to rewind on random button

---
 .../SongSelect/TestSceneSongSelectFooter.cs   | 16 +++++++++++++-
 osu.Game/Screens/Select/FooterButtonRandom.cs | 21 ++++++++++++++++---
 2 files changed, 33 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneSongSelectFooter.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneSongSelectFooter.cs
index 6485123b29..f27615eea5 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneSongSelectFooter.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneSongSelectFooter.cs
@@ -4,6 +4,7 @@
 using NUnit.Framework;
 using osu.Framework.Graphics;
 using osu.Game.Screens.Select;
+using osuTK;
 using osuTK.Input;
 
 namespace osu.Game.Tests.Visual.SongSelect
@@ -36,6 +37,8 @@ namespace osu.Game.Tests.Visual.SongSelect
                 PreviousRandom = () => previousRandomCalled = true,
             }, null);
             footer.AddButton(new FooterButtonOptions(), null);
+
+            InputManager.MoveMouseTo(Vector2.Zero);
         });
 
         [Test]
@@ -70,7 +73,7 @@ namespace osu.Game.Tests.Visual.SongSelect
         }
 
         [Test]
-        public void TestFooterRewindViaMouse()
+        public void TestFooterRewindViaShiftMouseLeft()
         {
             AddStep("shift + click button", () =>
             {
@@ -81,5 +84,16 @@ namespace osu.Game.Tests.Visual.SongSelect
             });
             AddAssert("previous random invoked", () => previousRandomCalled && !nextRandomCalled);
         }
+
+        [Test]
+        public void TestFooterRewindViaMouseRight()
+        {
+            AddStep("right click button", () =>
+            {
+                InputManager.MoveMouseTo(randomButton);
+                InputManager.Click(MouseButton.Right);
+            });
+            AddAssert("previous random invoked", () => previousRandomCalled && !nextRandomCalled);
+        }
     }
 }
diff --git a/osu.Game/Screens/Select/FooterButtonRandom.cs b/osu.Game/Screens/Select/FooterButtonRandom.cs
index 5f8fdce054..48d5836826 100644
--- a/osu.Game/Screens/Select/FooterButtonRandom.cs
+++ b/osu.Game/Screens/Select/FooterButtonRandom.cs
@@ -10,6 +10,7 @@ using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Input.Bindings;
 using osuTK;
+using osuTK.Input;
 
 namespace osu.Game.Screens.Select
 {
@@ -73,13 +74,27 @@ namespace osu.Game.Screens.Select
 
         protected override bool OnClick(ClickEvent e)
         {
-            rewindSearch = e.ShiftPressed;
-            return base.OnClick(e);
+            try
+            {
+                // this uses OR to handle rewinding when clicks are triggered by other sources (i.e. right button in OnMouseUp).
+                rewindSearch |= e.ShiftPressed;
+                return base.OnClick(e);
+            }
+            finally
+            {
+                rewindSearch = false;
+            }
         }
 
         protected override void OnMouseUp(MouseUpEvent e)
         {
-            rewindSearch = false;
+            if (e.Button == MouseButton.Right)
+            {
+                rewindSearch = true;
+                TriggerClick();
+                return;
+            }
+
             base.OnMouseUp(e);
         }
 

From 3829d278451c71aa4223c70520331f970ad79cb7 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 29 Apr 2022 12:19:22 +0300
Subject: [PATCH 4406/5547] Update overlay ruleset selector design

---
 osu.Game/Overlays/OverlayRulesetTabItem.cs | 22 +++++++++-------------
 1 file changed, 9 insertions(+), 13 deletions(-)

diff --git a/osu.Game/Overlays/OverlayRulesetTabItem.cs b/osu.Game/Overlays/OverlayRulesetTabItem.cs
index 9d4afc94d1..4f58d4c189 100644
--- a/osu.Game/Overlays/OverlayRulesetTabItem.cs
+++ b/osu.Game/Overlays/OverlayRulesetTabItem.cs
@@ -5,14 +5,12 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.UserInterface;
 using osu.Framework.Input.Events;
-using osu.Game.Graphics;
-using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Rulesets;
 using osuTK.Graphics;
 using osuTK;
 using osu.Framework.Allocation;
-using osu.Framework.Extensions.Color4Extensions;
+using osu.Game.Graphics.Containers;
 
 namespace osu.Game.Overlays
 {
@@ -26,7 +24,7 @@ namespace osu.Game.Overlays
             set
             {
                 accentColour = value;
-                text.FadeColour(value, 120, Easing.OutQuint);
+                icon.FadeColour(value, 120, Easing.OutQuint);
             }
         }
 
@@ -35,7 +33,7 @@ namespace osu.Game.Overlays
         [Resolved]
         private OverlayColourProvider colourProvider { get; set; }
 
-        private readonly OsuSpriteText text;
+        private readonly Drawable icon;
 
         public OverlayRulesetTabItem(RulesetInfo value)
             : base(value)
@@ -48,15 +46,14 @@ namespace osu.Game.Overlays
                 {
                     AutoSizeAxes = Axes.Both,
                     Direction = FillDirection.Horizontal,
-                    Spacing = new Vector2(3, 0),
-                    Child = text = new OsuSpriteText
+                    Spacing = new Vector2(5f, 0),
+                    Child = icon = new ConstrainedIconContainer
                     {
-                        Origin = Anchor.Centre,
                         Anchor = Anchor.Centre,
-                        Text = value.Name,
-                        Font = OsuFont.GetFont(size: 14),
-                        ShadowColour = Color4.Black.Opacity(0.75f)
-                    }
+                        Origin = Anchor.Centre,
+                        Size = new Vector2(20f),
+                        Icon = value.CreateInstance().CreateIcon(),
+                    },
                 },
                 new HoverClickSounds()
             });
@@ -91,7 +88,6 @@ namespace osu.Game.Overlays
 
         private void updateState()
         {
-            text.Font = text.Font.With(weight: Active.Value ? FontWeight.Bold : FontWeight.Medium);
             AccentColour = Enabled.Value ? getActiveColour() : colourProvider.Foreground1;
         }
 

From 4016fe1e19695637ea0a954b63ec633fcff2d5b4 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 29 Apr 2022 12:19:47 +0300
Subject: [PATCH 4407/5547] Adjust profile ruleset selector to new design

Looks weird with `AlwaysPresent`.
---
 .../Profile/Header/Components/ProfileRulesetTabItem.cs         | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/osu.Game/Overlays/Profile/Header/Components/ProfileRulesetTabItem.cs b/osu.Game/Overlays/Profile/Header/Components/ProfileRulesetTabItem.cs
index 3d20fba542..15640ddc5e 100644
--- a/osu.Game/Overlays/Profile/Header/Components/ProfileRulesetTabItem.cs
+++ b/osu.Game/Overlays/Profile/Header/Components/ProfileRulesetTabItem.cs
@@ -23,7 +23,7 @@ namespace osu.Game.Overlays.Profile.Header.Components
 
                 isDefault = value;
 
-                icon.FadeTo(isDefault ? 1 : 0, 200, Easing.OutQuint);
+                icon.Alpha = isDefault ? 1 : 0;
             }
         }
 
@@ -47,7 +47,6 @@ namespace osu.Game.Overlays.Profile.Header.Components
                 Origin = Anchor.Centre,
                 Anchor = Anchor.Centre,
                 Alpha = 0,
-                AlwaysPresent = true,
                 Icon = FontAwesome.Solid.Star,
                 Size = new Vector2(12),
             });

From fae8d86e154df9e31674a2b94f66a79c259ba709 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 29 Apr 2022 12:20:33 +0300
Subject: [PATCH 4408/5547] Fix regressed profile ruleset selector test scene

Due to the changes in `APIUser`, which change equality to be based on ID.
---
 .../Visual/Online/TestSceneProfileRulesetSelector.cs   | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneProfileRulesetSelector.cs b/osu.Game.Tests/Visual/Online/TestSceneProfileRulesetSelector.cs
index cbbe8b8eac..4e572b665b 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneProfileRulesetSelector.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneProfileRulesetSelector.cs
@@ -32,14 +32,14 @@ namespace osu.Game.Tests.Visual.Online
             };
 
             AddStep("set osu! as default", () => selector.SetDefaultRuleset(new OsuRuleset().RulesetInfo));
-            AddStep("set mania as default", () => selector.SetDefaultRuleset(new ManiaRuleset().RulesetInfo));
             AddStep("set taiko as default", () => selector.SetDefaultRuleset(new TaikoRuleset().RulesetInfo));
             AddStep("set catch as default", () => selector.SetDefaultRuleset(new CatchRuleset().RulesetInfo));
+            AddStep("set mania as default", () => selector.SetDefaultRuleset(new ManiaRuleset().RulesetInfo));
 
-            AddStep("User with osu as default", () => user.Value = new APIUser { PlayMode = "osu" });
-            AddStep("User with mania as default", () => user.Value = new APIUser { PlayMode = "mania" });
-            AddStep("User with taiko as default", () => user.Value = new APIUser { PlayMode = "taiko" });
-            AddStep("User with catch as default", () => user.Value = new APIUser { PlayMode = "fruits" });
+            AddStep("User with osu as default", () => user.Value = new APIUser { Id = 0, PlayMode = "osu" });
+            AddStep("User with taiko as default", () => user.Value = new APIUser { Id = 2, PlayMode = "taiko" });
+            AddStep("User with catch as default", () => user.Value = new APIUser { Id = 3, PlayMode = "fruits" });
+            AddStep("User with mania as default", () => user.Value = new APIUser { Id = 1, PlayMode = "mania" });
             AddStep("null user", () => user.Value = null);
         }
     }

From 5e19bdbf430b76c8124f81afd4e6d04a69978950 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 29 Apr 2022 12:21:12 +0300
Subject: [PATCH 4409/5547] Refactor beatmap ruleset selector test scene

---
 .../Online/TestSceneBeatmapRulesetSelector.cs | 99 ++++++++++---------
 1 file changed, 53 insertions(+), 46 deletions(-)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneBeatmapRulesetSelector.cs b/osu.Game.Tests/Visual/Online/TestSceneBeatmapRulesetSelector.cs
index 63741451f3..c550c9afda 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneBeatmapRulesetSelector.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneBeatmapRulesetSelector.cs
@@ -4,11 +4,11 @@
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
-using osu.Framework.Graphics.UserInterface;
+using osu.Framework.Graphics;
+using osu.Framework.Testing;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays;
 using osu.Game.Overlays.BeatmapSet;
-using osu.Game.Rulesets;
 
 namespace osu.Game.Tests.Visual.Online
 {
@@ -17,79 +17,86 @@ namespace osu.Game.Tests.Visual.Online
         [Cached]
         private OverlayColourProvider colourProvider = new OverlayColourProvider(OverlayColourScheme.Blue);
 
-        private readonly TestRulesetSelector selector;
+        private BeatmapRulesetSelector selector;
 
-        public TestSceneBeatmapRulesetSelector()
+        [SetUp]
+        public void SetUp() => Schedule(() => Child = selector = new BeatmapRulesetSelector
         {
-            Add(selector = new TestRulesetSelector());
-        }
+            Anchor = Anchor.Centre,
+            Origin = Anchor.Centre,
+            BeatmapSet = new APIBeatmapSet(),
+        });
 
-        [Resolved]
-        private IRulesetStore rulesets { get; set; }
+        [Test]
+        public void TestDisplay()
+        {
+            AddSliderStep("osu", 0, 100, 0, v => updateBeatmaps(0, v));
+            AddSliderStep("taiko", 0, 100, 0, v => updateBeatmaps(1, v));
+            AddSliderStep("fruits", 0, 100, 0, v => updateBeatmaps(2, v));
+            AddSliderStep("mania", 0, 100, 0, v => updateBeatmaps(3, v));
+
+            void updateBeatmaps(int ruleset, int count)
+            {
+                if (selector == null)
+                    return;
+
+                selector.BeatmapSet = new APIBeatmapSet
+                {
+                    Beatmaps = selector.BeatmapSet.Beatmaps
+                                       .Where(b => b.Ruleset.OnlineID != ruleset)
+                                       .Concat(Enumerable.Range(0, count).Select(_ => new APIBeatmap { RulesetID = ruleset }))
+                                       .ToArray(),
+                };
+            }
+        }
 
         [Test]
         public void TestMultipleRulesetsBeatmapSet()
         {
-            var enabledRulesets = rulesets.AvailableRulesets.Skip(1).Take(2);
-
             AddStep("load multiple rulesets beatmapset", () =>
-            {
-                selector.BeatmapSet = new APIBeatmapSet
-                {
-                    Beatmaps = enabledRulesets.Select(r => new APIBeatmap { RulesetID = r.OnlineID }).ToArray()
-                };
-            });
-
-            var tabItems = selector.TabContainer.TabItems;
-            AddAssert("other rulesets disabled", () => tabItems.Except(tabItems.Where(t => enabledRulesets.Any(r => r.Equals(t.Value)))).All(t => !t.Enabled.Value));
-            AddAssert("left-most ruleset selected", () => tabItems.First(t => t.Enabled.Value).Active.Value);
-        }
-
-        [Test]
-        public void TestSingleRulesetBeatmapSet()
-        {
-            var enabledRuleset = rulesets.AvailableRulesets.Last();
-
-            AddStep("load single ruleset beatmapset", () =>
             {
                 selector.BeatmapSet = new APIBeatmapSet
                 {
                     Beatmaps = new[]
                     {
-                        new APIBeatmap
-                        {
-                            RulesetID = enabledRuleset.OnlineID
-                        }
+                        new APIBeatmap { RulesetID = 1 },
+                        new APIBeatmap { RulesetID = 2 },
                     }
                 };
             });
 
-            AddAssert("single ruleset selected", () => selector.SelectedTab.Value.Equals(enabledRuleset));
+            AddAssert("osu disabled", () => !selector.ChildrenOfType<BeatmapRulesetTabItem>().Single(t => t.Value.OnlineID == 0).Enabled.Value);
+            AddAssert("mania disabled", () => !selector.ChildrenOfType<BeatmapRulesetTabItem>().Single(t => t.Value.OnlineID == 3).Enabled.Value);
+
+            AddAssert("taiko selected", () => selector.ChildrenOfType<BeatmapRulesetTabItem>().Single(t => t.Active.Value).Value.OnlineID == 1);
+        }
+
+        [Test]
+        public void TestSingleRulesetBeatmapSet()
+        {
+            AddStep("load single ruleset beatmapset", () =>
+            {
+                selector.BeatmapSet = new APIBeatmapSet
+                {
+                    Beatmaps = new[] { new APIBeatmap { RulesetID = 3 } }
+                };
+            });
+
+            AddAssert("single ruleset selected", () => selector.ChildrenOfType<BeatmapRulesetTabItem>().Single(t => t.Active.Value).Value.OnlineID == 3);
         }
 
         [Test]
         public void TestEmptyBeatmapSet()
         {
             AddStep("load empty beatmapset", () => selector.BeatmapSet = new APIBeatmapSet());
-
-            AddAssert("no ruleset selected", () => selector.SelectedTab == null);
-            AddAssert("all rulesets disabled", () => selector.TabContainer.TabItems.All(t => !t.Enabled.Value));
+            AddAssert("all rulesets disabled", () => selector.ChildrenOfType<BeatmapRulesetTabItem>().All(t => !t.Active.Value && !t.Enabled.Value));
         }
 
         [Test]
         public void TestNullBeatmapSet()
         {
             AddStep("load null beatmapset", () => selector.BeatmapSet = null);
-
-            AddAssert("no ruleset selected", () => selector.SelectedTab == null);
-            AddAssert("all rulesets disabled", () => selector.TabContainer.TabItems.All(t => !t.Enabled.Value));
-        }
-
-        private class TestRulesetSelector : BeatmapRulesetSelector
-        {
-            public new TabItem<RulesetInfo> SelectedTab => base.SelectedTab;
-
-            public new TabFillFlowContainer TabContainer => base.TabContainer;
+            AddAssert("all rulesets disabled", () => selector.ChildrenOfType<BeatmapRulesetTabItem>().All(t => !t.Active.Value && !t.Enabled.Value));
         }
     }
 }

From 55c03dc04d0505f462c41876a50797acc3698f0b Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 29 Apr 2022 12:40:40 +0300
Subject: [PATCH 4410/5547] Fix silly mistake in ordering and update test
 colour scheme

---
 .../Visual/Online/TestSceneProfileRulesetSelector.cs      | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneProfileRulesetSelector.cs b/osu.Game.Tests/Visual/Online/TestSceneProfileRulesetSelector.cs
index 4e572b665b..ae90872439 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneProfileRulesetSelector.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneProfileRulesetSelector.cs
@@ -17,7 +17,7 @@ namespace osu.Game.Tests.Visual.Online
     public class TestSceneProfileRulesetSelector : OsuTestScene
     {
         [Cached]
-        private readonly OverlayColourProvider colourProvider = new OverlayColourProvider(OverlayColourScheme.Green);
+        private readonly OverlayColourProvider colourProvider = new OverlayColourProvider(OverlayColourScheme.Pink);
 
         public TestSceneProfileRulesetSelector()
         {
@@ -37,9 +37,9 @@ namespace osu.Game.Tests.Visual.Online
             AddStep("set mania as default", () => selector.SetDefaultRuleset(new ManiaRuleset().RulesetInfo));
 
             AddStep("User with osu as default", () => user.Value = new APIUser { Id = 0, PlayMode = "osu" });
-            AddStep("User with taiko as default", () => user.Value = new APIUser { Id = 2, PlayMode = "taiko" });
-            AddStep("User with catch as default", () => user.Value = new APIUser { Id = 3, PlayMode = "fruits" });
-            AddStep("User with mania as default", () => user.Value = new APIUser { Id = 1, PlayMode = "mania" });
+            AddStep("User with taiko as default", () => user.Value = new APIUser { Id = 1, PlayMode = "taiko" });
+            AddStep("User with catch as default", () => user.Value = new APIUser { Id = 2, PlayMode = "fruits" });
+            AddStep("User with mania as default", () => user.Value = new APIUser { Id = 3, PlayMode = "mania" });
             AddStep("null user", () => user.Value = null);
         }
     }

From 9ea3e244e7d141b1a0d56862a03a2f15aa56a372 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 29 Apr 2022 12:48:05 +0300
Subject: [PATCH 4411/5547] Adjust ruleset tab item content spacing to match
 web

Not too noticeable, but better match web in any case.
---
 osu.Game/Overlays/OverlayRulesetTabItem.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/OverlayRulesetTabItem.cs b/osu.Game/Overlays/OverlayRulesetTabItem.cs
index 4f58d4c189..32177b2b96 100644
--- a/osu.Game/Overlays/OverlayRulesetTabItem.cs
+++ b/osu.Game/Overlays/OverlayRulesetTabItem.cs
@@ -46,7 +46,7 @@ namespace osu.Game.Overlays
                 {
                     AutoSizeAxes = Axes.Both,
                     Direction = FillDirection.Horizontal,
-                    Spacing = new Vector2(5f, 0),
+                    Spacing = new Vector2(4f, 0),
                     Child = icon = new ConstrainedIconContainer
                     {
                         Anchor = Anchor.Centre,

From 670b51324ea0d6e52c036391039329ca27f3e1b2 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 29 Apr 2022 23:45:02 +0900
Subject: [PATCH 4412/5547] Add basic test at top of first run scene to make
 adjusting UI easier

---
 .../Visual/UserInterface/TestSceneFirstRunSetupOverlay.cs   | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunSetupOverlay.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunSetupOverlay.cs
index 836cf6caad..39298f56ba 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunSetupOverlay.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunSetupOverlay.cs
@@ -65,6 +65,12 @@ namespace osu.Game.Tests.Visual.UserInterface
             });
         }
 
+        [Test]
+        public void TestBasic()
+        {
+            AddAssert("overlay visible", () => overlay.State.Value == Visibility.Visible);
+        }
+
         [Test]
         [Ignore("Enable when first run setup is being displayed on first run.")]
         public void TestDoesntOpenOnSecondRun()

From 27ee990359ab4f412e589b53ae70f740c9de7e1c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 29 Apr 2022 23:45:17 +0900
Subject: [PATCH 4413/5547] Update first-run overlay footer buttons to use new
 sheared design

---
 osu.Game/Overlays/FirstRunSetupOverlay.cs | 36 ++++++++++++++---------
 1 file changed, 22 insertions(+), 14 deletions(-)

diff --git a/osu.Game/Overlays/FirstRunSetupOverlay.cs b/osu.Game/Overlays/FirstRunSetupOverlay.cs
index 4277f0f2ba..75778e6c4d 100644
--- a/osu.Game/Overlays/FirstRunSetupOverlay.cs
+++ b/osu.Game/Overlays/FirstRunSetupOverlay.cs
@@ -25,7 +25,6 @@ using osu.Game.Overlays.Mods;
 using osu.Game.Overlays.Notifications;
 using osu.Game.Screens;
 using osu.Game.Screens.Menu;
-using osu.Game.Screens.OnlinePlay.Match.Components;
 
 namespace osu.Game.Overlays
 {
@@ -45,8 +44,8 @@ namespace osu.Game.Overlays
 
         private ScreenStack? stack;
 
-        public PurpleTriangleButton NextButton = null!;
-        public DangerousTriangleButton BackButton = null!;
+        public ShearedButton NextButton = null!;
+        public ShearedButton BackButton = null!;
 
         private readonly Bindable<bool> showFirstRunSetup = new Bindable<bool>();
 
@@ -72,7 +71,7 @@ namespace osu.Game.Overlays
         private Container content = null!;
 
         [BackgroundDependencyLoader]
-        private void load()
+        private void load(OsuColour colours)
         {
             Header.Title = FirstRunSetupOverlayStrings.FirstRunSetupTitle;
             Header.Description = FirstRunSetupOverlayStrings.FirstRunSetupDescription;
@@ -84,7 +83,11 @@ namespace osu.Game.Overlays
                     Anchor = Anchor.Centre,
                     Origin = Anchor.Centre,
                     RelativeSizeAxes = Axes.Both,
-                    Padding = new MarginPadding { Horizontal = 70 * 1.2f },
+                    Padding = new MarginPadding
+                    {
+                        Horizontal = 70 * 1.2f,
+                        Bottom = 20,
+                    },
                     Child = new InputBlockingContainer
                     {
                         Masking = true,
@@ -117,14 +120,15 @@ namespace osu.Game.Overlays
             {
                 RelativeSizeAxes = Axes.X,
                 AutoSizeAxes = Axes.Y,
-                Width = 0.98f,
-                Anchor = Anchor.Centre,
-                Origin = Anchor.Centre,
+                Margin = new MarginPadding { Vertical = PADDING },
+                Anchor = Anchor.BottomLeft,
+                Origin = Anchor.BottomLeft,
                 ColumnDimensions = new[]
                 {
-                    new Dimension(GridSizeMode.AutoSize),
                     new Dimension(GridSizeMode.Absolute, 10),
+                    new Dimension(GridSizeMode.AutoSize),
                     new Dimension(),
+                    new Dimension(GridSizeMode.Absolute, 10),
                 },
                 RowDimensions = new[]
                 {
@@ -134,21 +138,25 @@ namespace osu.Game.Overlays
                 {
                     new[]
                     {
-                        BackButton = new DangerousTriangleButton
+                        Empty(),
+                        BackButton = new ShearedButton(300)
                         {
-                            Width = 300,
                             Text = CommonStrings.Back,
                             Action = showPreviousStep,
                             Enabled = { Value = false },
+                            DarkerColour = colours.Pink2,
+                            LighterColour = colours.Pink1,
                         },
-                        Empty(),
-                        NextButton = new PurpleTriangleButton
+                        NextButton = new ShearedButton(0)
                         {
                             RelativeSizeAxes = Axes.X,
                             Width = 1,
                             Text = FirstRunSetupOverlayStrings.GetStarted,
+                            DarkerColour = ColourProvider.Colour2,
+                            LighterColour = ColourProvider.Colour1,
                             Action = showNextStep
-                        }
+                        },
+                        Empty(),
                     },
                 }
             });

From 3996972867507a1b46c551d7c921a5a973dad3c1 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sat, 30 Apr 2022 12:23:08 +0300
Subject: [PATCH 4414/5547] Remove unnecessary `f` suffix

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

diff --git a/osu.Game/Overlays/OverlayRulesetTabItem.cs b/osu.Game/Overlays/OverlayRulesetTabItem.cs
index 32177b2b96..84815b0cc1 100644
--- a/osu.Game/Overlays/OverlayRulesetTabItem.cs
+++ b/osu.Game/Overlays/OverlayRulesetTabItem.cs
@@ -46,7 +46,7 @@ namespace osu.Game.Overlays
                 {
                     AutoSizeAxes = Axes.Both,
                     Direction = FillDirection.Horizontal,
-                    Spacing = new Vector2(4f, 0),
+                    Spacing = new Vector2(4, 0),
                     Child = icon = new ConstrainedIconContainer
                     {
                         Anchor = Anchor.Centre,

From c7ab9a89285f457737a6e5b1f2261da4a46c4e0c Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sat, 30 Apr 2022 15:35:04 +0300
Subject: [PATCH 4415/5547] Add ruleset tab item tooltips

---
 osu.Game/Overlays/OverlayRulesetTabItem.cs    |  6 ++++-
 .../Components/ProfileRulesetTabItem.cs       | 23 +++++++++++++------
 2 files changed, 21 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Overlays/OverlayRulesetTabItem.cs b/osu.Game/Overlays/OverlayRulesetTabItem.cs
index 84815b0cc1..8ed75a528b 100644
--- a/osu.Game/Overlays/OverlayRulesetTabItem.cs
+++ b/osu.Game/Overlays/OverlayRulesetTabItem.cs
@@ -10,11 +10,13 @@ using osu.Game.Rulesets;
 using osuTK.Graphics;
 using osuTK;
 using osu.Framework.Allocation;
+using osu.Framework.Graphics.Cursor;
+using osu.Framework.Localisation;
 using osu.Game.Graphics.Containers;
 
 namespace osu.Game.Overlays
 {
-    public class OverlayRulesetTabItem : TabItem<RulesetInfo>
+    public class OverlayRulesetTabItem : TabItem<RulesetInfo>, IHasTooltip
     {
         private Color4 accentColour;
 
@@ -35,6 +37,8 @@ namespace osu.Game.Overlays
 
         private readonly Drawable icon;
 
+        public LocalisableString TooltipText => Value.Name;
+
         public OverlayRulesetTabItem(RulesetInfo value)
             : base(value)
         {
diff --git a/osu.Game/Overlays/Profile/Header/Components/ProfileRulesetTabItem.cs b/osu.Game/Overlays/Profile/Header/Components/ProfileRulesetTabItem.cs
index 15640ddc5e..4a44e285bf 100644
--- a/osu.Game/Overlays/Profile/Header/Components/ProfileRulesetTabItem.cs
+++ b/osu.Game/Overlays/Profile/Header/Components/ProfileRulesetTabItem.cs
@@ -2,7 +2,10 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using osu.Framework.Graphics;
+using osu.Framework.Graphics.Cursor;
 using osu.Framework.Graphics.Sprites;
+using osu.Framework.Localisation;
+using osu.Game.Resources.Localisation.Web;
 using osu.Game.Rulesets;
 using osuTK;
 using osuTK.Graphics;
@@ -42,14 +45,20 @@ namespace osu.Game.Overlays.Profile.Header.Components
         public ProfileRulesetTabItem(RulesetInfo value)
             : base(value)
         {
-            Add(icon = new SpriteIcon
+            Add(icon = new DefaultRulesetIcon { Alpha = 0 });
+        }
+
+        public class DefaultRulesetIcon : SpriteIcon, IHasTooltip
+        {
+            public LocalisableString TooltipText => UsersStrings.ShowEditDefaultPlaymodeIsDefaultTooltip;
+
+            public DefaultRulesetIcon()
             {
-                Origin = Anchor.Centre,
-                Anchor = Anchor.Centre,
-                Alpha = 0,
-                Icon = FontAwesome.Solid.Star,
-                Size = new Vector2(12),
-            });
+                Origin = Anchor.Centre;
+                Anchor = Anchor.Centre;
+                Icon = FontAwesome.Solid.Star;
+                Size = new Vector2(12);
+            }
         }
     }
 }

From ba5da8a52aa40cc4c1092854f33b9054b4fbe5e1 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sat, 30 Apr 2022 15:36:15 +0300
Subject: [PATCH 4416/5547] Fix tooltips not shown on selected tab

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

diff --git a/osu.Game/Overlays/OverlayRulesetTabItem.cs b/osu.Game/Overlays/OverlayRulesetTabItem.cs
index 8ed75a528b..1f11b98881 100644
--- a/osu.Game/Overlays/OverlayRulesetTabItem.cs
+++ b/osu.Game/Overlays/OverlayRulesetTabItem.cs
@@ -71,7 +71,7 @@ namespace osu.Game.Overlays
             Enabled.BindValueChanged(_ => updateState(), true);
         }
 
-        public override bool PropagatePositionalInputSubTree => Enabled.Value && !Active.Value && base.PropagatePositionalInputSubTree;
+        public override bool PropagatePositionalInputSubTree => Enabled.Value && base.PropagatePositionalInputSubTree;
 
         protected override bool OnHover(HoverEvent e)
         {

From b6fb0197ab1ef3f03a9270af7e035d0f97839c86 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 30 Apr 2022 23:52:36 +0900
Subject: [PATCH 4417/5547] Update framework

---
 osu.Android.props        | 2 +-
 osu.Game/osu.Game.csproj | 2 +-
 osu.iOS.props            | 4 ++--
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Android.props b/osu.Android.props
index ff6499631d..b6260fd1d4 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -52,7 +52,7 @@
   </ItemGroup>
   <ItemGroup>
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.422.0" />
-    <PackageReference Include="ppy.osu.Framework.Android" Version="2022.428.0" />
+    <PackageReference Include="ppy.osu.Framework.Android" Version="2022.430.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
     <!-- Realm needs to be directly referenced in all Xamarin projects, as it will not pull in its transitive dependencies otherwise. -->
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 26891ad978..fa7563da55 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="10.10.0" />
-    <PackageReference Include="ppy.osu.Framework" Version="2022.428.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2022.430.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.422.0" />
     <PackageReference Include="Sentry" Version="3.14.1" />
     <PackageReference Include="SharpCompress" Version="0.30.1" />
diff --git a/osu.iOS.props b/osu.iOS.props
index d261e13ade..e472b5f1a8 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -61,7 +61,7 @@
     <Reference Include="System.Net.Http" />
   </ItemGroup>
   <ItemGroup Label="Package References">
-    <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.428.0" />
+    <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.430.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.422.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net6.0) -->
@@ -84,7 +84,7 @@
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="5.0.14" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.Core" Version="5.0.14" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
-    <PackageReference Include="ppy.osu.Framework" Version="2022.428.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2022.430.0" />
     <PackageReference Include="SharpCompress" Version="0.30.1" />
     <PackageReference Include="NUnit" Version="3.13.2" />
     <PackageReference Include="System.ComponentModel.Annotations" Version="5.0.0" />

From de393f735fdb3d2f4b93939af1a47f8a17217a17 Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Fri, 29 Apr 2022 21:33:32 +0100
Subject: [PATCH 4418/5547] Implement basic layout and behaviour of new chat
 overlay

Provides initial implementation of new chat overlay in component
`ChatOverlayV2`. Contains only the basic functionality required for
a functioning chat overlay according to the new design with the intent
of added the rest of the functionality in subsequent PRs.

Backports existing tests for the current chat overlay except for ones
testing keyboard shortcuts (since they haven't been added) and tab
closing behaviour (since no tabs).
---
 .../Visual/Online/TestSceneChatOverlayV2.cs   | 365 ++++++++++++++++++
 .../Chat/ChannelList/ChannelListItem.cs       |  18 +-
 osu.Game/Overlays/Chat/ChatOverlayTopBar.cs   |  67 ++++
 .../Chat/Listing/ChannelListingItem.cs        |  18 +-
 osu.Game/Overlays/ChatOverlayV2.cs            | 293 ++++++++++++++
 5 files changed, 743 insertions(+), 18 deletions(-)
 create mode 100644 osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs
 create mode 100644 osu.Game/Overlays/Chat/ChatOverlayTopBar.cs
 create mode 100644 osu.Game/Overlays/ChatOverlayV2.cs

diff --git a/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs b/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs
new file mode 100644
index 0000000000..312bda6460
--- /dev/null
+++ b/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs
@@ -0,0 +1,365 @@
+// 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 System.Collections.Generic;
+using System.Net;
+using NUnit.Framework;
+using osu.Framework.Bindables;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
+using osu.Framework.Logging;
+using osu.Framework.Testing;
+using osu.Framework.Utils;
+using osu.Game.Graphics.UserInterface;
+using osu.Game.Online.API;
+using osu.Game.Online.API.Requests;
+using osu.Game.Online.API.Requests.Responses;
+using osu.Game.Online.Chat;
+using osu.Game.Overlays;
+using osu.Game.Overlays.Chat;
+using osu.Game.Overlays.Chat.Listing;
+using osu.Game.Overlays.Chat.ChannelList;
+using osuTK.Input;
+
+namespace osu.Game.Tests.Visual.Online
+{
+    [TestFixture]
+    public class TestSceneChatOverlayV2 : OsuManualInputManagerTestScene
+    {
+        private ChatOverlayV2 chatOverlay;
+        private ChannelManager channelManager;
+
+        private readonly APIUser testUser;
+        private readonly Channel testPMChannel;
+        private readonly Channel[] testChannels;
+        private Channel testChannel1 => testChannels[0];
+        private Channel testChannel2 => testChannels[1];
+
+        public TestSceneChatOverlayV2()
+        {
+            testUser = new APIUser { Username = "test user", Id = 5071479 };
+            testPMChannel = new Channel(testUser);
+            testChannels = Enumerable.Range(1, 10).Select(createPublicChannel).ToArray();
+        }
+
+        [SetUp]
+        public void SetUp() => Schedule(() =>
+        {
+            Child = new DependencyProvidingContainer
+            {
+                RelativeSizeAxes = Axes.Both,
+                CachedDependencies = new (Type, object)[]
+                {
+                    (typeof(ChannelManager), channelManager = new ChannelManager()),
+                },
+                Children = new Drawable[]
+                {
+                    channelManager,
+                    chatOverlay = new ChatOverlayV2 { RelativeSizeAxes = Axes.Both },
+                },
+            };
+        });
+
+        [SetUpSteps]
+        public void SetUpSteps()
+        {
+            AddStep("Setup request handler", () =>
+            {
+                ((DummyAPIAccess)API).HandleRequest = req =>
+                {
+                    switch (req)
+                    {
+                        case GetUpdatesRequest getUpdates:
+                            getUpdates.TriggerFailure(new WebException());
+                            return true;
+
+                        case JoinChannelRequest joinChannel:
+                            joinChannel.TriggerSuccess();
+                            return true;
+
+                        case LeaveChannelRequest leaveChannel:
+                            leaveChannel.TriggerSuccess();
+                            return true;
+
+                        case GetMessagesRequest getMessages:
+                            getMessages.TriggerSuccess(createChannelMessages(getMessages.Channel));
+                            return true;
+
+                        case GetUserRequest getUser:
+                            if (getUser.Lookup == testUser.Username)
+                                getUser.TriggerSuccess(testUser);
+                            else
+                                getUser.TriggerFailure(new WebException());
+                            return true;
+
+                        case PostMessageRequest postMessage:
+                            postMessage.TriggerSuccess(new Message(RNG.Next(0, 10000000))
+                            {
+                                Content = postMessage.Message.Content,
+                                ChannelId = postMessage.Message.ChannelId,
+                                Sender = postMessage.Message.Sender,
+                                Timestamp = new DateTimeOffset(DateTime.Now),
+                            });
+                            return true;
+
+                        default:
+                            Logger.Log($"Unhandled Request Type: {req.GetType()}");
+                            return false;
+                    }
+                };
+            });
+
+            AddStep("Add test channels", () =>
+            {
+                (channelManager.AvailableChannels as BindableList<Channel>)?.AddRange(testChannels);
+            });
+        }
+
+        [Test]
+        public void TestShowHide()
+        {
+            AddStep("Show overlay", () => chatOverlay.Show());
+            AddAssert("Overlay is visible", () => chatOverlay.State.Value == Visibility.Visible);
+            AddStep("Hide overlay", () => chatOverlay.Hide());
+            AddAssert("Overlay is hidden", () => chatOverlay.State.Value == Visibility.Hidden);
+        }
+
+        [Test]
+        public void TestChannelSelection()
+        {
+            AddStep("Show overlay", () => chatOverlay.Show());
+            AddAssert("Listing is visible", () => listingVisibility == Visibility.Visible);
+            AddStep("Join channel 1", () => channelManager.JoinChannel(testChannel1));
+            AddStep("Select channel 1", () => clickDrawable(getChannelListItem(testChannel1)));
+            AddAssert("Listing is hidden", () => listingVisibility == Visibility.Hidden);
+            AddAssert("Loading is hidden", () => loadingVisibility == Visibility.Hidden);
+            AddAssert("Current channel is correct", () => channelManager.CurrentChannel.Value == testChannel1);
+            AddAssert("DrawableChannel is correct", () => currentDrawableChannel.Channel == testChannel1);
+        }
+
+        [Test]
+        public void TestSearchInListing()
+        {
+            AddStep("Show overlay", () => chatOverlay.Show());
+            AddAssert("Listing is visible", () => listingVisibility == Visibility.Visible);
+            AddStep("Search for 'number 2'", () => chatOverlay.ChildrenOfType<ChatTextBox>().Single().Text = "number 2");
+            AddUntilStep("Only channel 2 visibile", () =>
+            {
+                IEnumerable<ChannelListingItem> listingItems = chatOverlay.ChildrenOfType<ChannelListingItem>()
+                                                                          .Where(item => item.IsPresent);
+                return listingItems.Count() == 1 && listingItems.Single().Channel == testChannel2;
+            });
+        }
+
+        [Test]
+        public void TestChannelCloseButton()
+        {
+            AddStep("Show overlay", () => chatOverlay.Show());
+            AddStep("Join PM and public channels", () =>
+            {
+                channelManager.JoinChannel(testChannel1);
+                channelManager.JoinChannel(testPMChannel);
+            });
+            AddStep("Select PM channel", () => clickDrawable(getChannelListItem(testPMChannel)));
+            AddStep("Click close button", () =>
+            {
+                ChannelListItemCloseButton closeButton = getChannelListItem(testPMChannel).ChildrenOfType<ChannelListItemCloseButton>().Single();
+                clickDrawable(closeButton);
+            });
+            AddAssert("PM channel closed", () => !channelManager.JoinedChannels.Contains(testPMChannel));
+            AddStep("Select normal channel", () => clickDrawable(getChannelListItem(testChannel1)));
+            AddStep("Click close button", () =>
+            {
+                ChannelListItemCloseButton closeButton = getChannelListItem(testChannel1).ChildrenOfType<ChannelListItemCloseButton>().Single();
+                clickDrawable(closeButton);
+            });
+            AddAssert("Normal channel closed", () => !channelManager.JoinedChannels.Contains(testChannel1));
+        }
+
+        [Test]
+        public void TestChatCommand()
+        {
+            AddStep("Show overlay", () => chatOverlay.Show());
+            AddStep("Join channel 1", () => channelManager.JoinChannel(testChannel1));
+            AddStep("Select channel 1", () => clickDrawable(getChannelListItem(testChannel1)));
+            AddStep("Open chat with user", () => channelManager.PostCommand($"chat {testUser.Username}"));
+            AddAssert("PM channel is selected", () => channelManager.CurrentChannel.Value == testPMChannel);
+            AddAssert("PM channel is visibile", () => currentDrawableChannel.Channel == testPMChannel);
+            AddStep("Open chat with non-existent user", () => channelManager.PostCommand("chat user_doesnt_exist"));
+            AddAssert("Last message is error", () => channelManager.CurrentChannel.Value.Messages.Last() is ErrorMessage);
+            // Make sure no unnecessary requests are made when the PM channel is already open.
+            AddStep("Select channel 1", () => clickDrawable(getChannelListItem(testChannel1)));
+            AddStep("Unregister request handling", () => ((DummyAPIAccess)API).HandleRequest = null);
+            AddStep("Open chat with user", () => channelManager.PostCommand($"chat {testUser.Username}"));
+            AddAssert("PM channel is selected", () => channelManager.CurrentChannel.Value == testPMChannel);
+            AddAssert("PM channel is visibile", () => currentDrawableChannel.Channel == testPMChannel);
+        }
+
+        [Test]
+        public void TestMultiplayerChannelIsNotShown()
+        {
+            Channel multiplayerChannel = null;
+
+            AddStep("Show overlay", () => chatOverlay.Show());
+            AddStep("Join multiplayer channel", () => channelManager.JoinChannel(multiplayerChannel = new Channel(new APIUser())
+            {
+                Name = "#mp_1",
+                Type = ChannelType.Multiplayer,
+            }));
+            AddAssert("Channel is joined", () => channelManager.JoinedChannels.Contains(multiplayerChannel));
+            AddUntilStep("Channel not present in listing", () => !chatOverlay.ChildrenOfType<ChannelListingItem>()
+                                                                             .Where(item => item.IsPresent)
+                                                                             .Select(item => item.Channel)
+                                                                             .Contains(multiplayerChannel));
+        }
+
+        [Test]
+        public void TestHighlightOnCurrentChannel()
+        {
+            Message message = null;
+
+            AddStep("Show overlay", () => chatOverlay.Show());
+            AddStep("Join channel 1", () => channelManager.JoinChannel(testChannel1));
+            AddStep("Select channel 1", () => clickDrawable(getChannelListItem(testChannel1)));
+            AddStep("Send message in channel 1", () =>
+            {
+                testChannel1.AddNewMessages(message = new Message
+                {
+                    ChannelId = testChannel1.Id,
+                    Content = "Message to highlight!",
+                    Timestamp = DateTimeOffset.Now,
+                    Sender = testUser,
+                });
+            });
+            AddStep("Highlight message", () => chatOverlay.HighlightMessage(message, testChannel1));
+        }
+
+        [Test]
+        public void TestHighlightOnAnotherChannel()
+        {
+            Message message = null;
+
+            AddStep("Show overlay", () => chatOverlay.Show());
+            AddStep("Join channel 1", () => channelManager.JoinChannel(testChannel1));
+            AddStep("Join channel 2", () => channelManager.JoinChannel(testChannel2));
+            AddStep("Select channel 1", () => clickDrawable(getChannelListItem(testChannel1)));
+            AddStep("Send message in channel 2", () =>
+            {
+                testChannel2.AddNewMessages(message = new Message
+                {
+                    ChannelId = testChannel2.Id,
+                    Content = "Message to highlight!",
+                    Timestamp = DateTimeOffset.Now,
+                    Sender = testUser,
+                });
+            });
+            AddStep("Highlight message", () => chatOverlay.HighlightMessage(message, testChannel2));
+            AddAssert("Channel 2 is selected", () => channelManager.CurrentChannel.Value == testChannel2);
+            AddAssert("Channel 2 is visible", () => currentDrawableChannel.Channel == testChannel2);
+        }
+
+        [Test]
+        public void TestHighlightOnLeftChannel()
+        {
+            Message message = null;
+
+            AddStep("Show overlay", () => chatOverlay.Show());
+            AddStep("Join channel 1", () => channelManager.JoinChannel(testChannel1));
+            AddStep("Join channel 2", () => channelManager.JoinChannel(testChannel2));
+            AddStep("Select channel 1", () => clickDrawable(getChannelListItem(testChannel1)));
+            AddStep("Send message in channel 2", () =>
+            {
+                testChannel2.AddNewMessages(message = new Message
+                {
+                    ChannelId = testChannel2.Id,
+                    Content = "Message to highlight!",
+                    Timestamp = DateTimeOffset.Now,
+                    Sender = testUser,
+                });
+            });
+            AddStep("Leave channel 2", () => channelManager.LeaveChannel(testChannel2));
+            AddStep("Highlight message", () => chatOverlay.HighlightMessage(message, testChannel2));
+            AddAssert("Channel 2 is selected", () => channelManager.CurrentChannel.Value == testChannel2);
+            AddAssert("Channel 2 is visible", () => currentDrawableChannel.Channel == testChannel2);
+        }
+
+        [Test]
+        public void TestHighlightWhileChatNeverOpen()
+        {
+            Message message = null;
+
+            AddStep("Join channel 1", () => channelManager.JoinChannel(testChannel1));
+            AddStep("Send message in channel 1", () =>
+            {
+                testChannel1.AddNewMessages(message = new Message
+                {
+                    ChannelId = testChannel1.Id,
+                    Content = "Message to highlight!",
+                    Timestamp = DateTimeOffset.Now,
+                    Sender = testUser,
+                });
+            });
+            AddStep("Highlight message", () => chatOverlay.HighlightMessage(message, testChannel1));
+        }
+
+        [Test]
+        public void TestHighlightWithNullChannel()
+        {
+            Message message = null;
+
+            AddStep("Join channel 1", () => channelManager.JoinChannel(testChannel1));
+            AddStep("Send message in channel 1", () =>
+            {
+                testChannel1.AddNewMessages(message = new Message
+                {
+                    ChannelId = testChannel1.Id,
+                    Content = "Message to highlight!",
+                    Timestamp = DateTimeOffset.Now,
+                    Sender = testUser,
+                });
+            });
+            AddStep("Set null channel", () => channelManager.CurrentChannel.Value = null);
+            AddStep("Highlight message", () => chatOverlay.HighlightMessage(message, testChannel1));
+        }
+
+        private Visibility listingVisibility =>
+            chatOverlay.ChildrenOfType<ChannelListing>().Single().State.Value;
+
+        private Visibility loadingVisibility =>
+            chatOverlay.ChildrenOfType<LoadingLayer>().Single().State.Value;
+
+        private DrawableChannel currentDrawableChannel =>
+            chatOverlay.ChildrenOfType<Container<DrawableChannel>>().Single().Child;
+
+        private ChannelListItem getChannelListItem(Channel channel) =>
+            chatOverlay.ChildrenOfType<ChannelListItem>().Single(item => item.Channel == channel);
+
+        private void clickDrawable(Drawable d)
+        {
+            InputManager.MoveMouseTo(d);
+            InputManager.Click(MouseButton.Left);
+        }
+
+        private List<Message> createChannelMessages(Channel channel)
+        {
+            var message = new Message
+            {
+                ChannelId = channel.Id,
+                Content = $"Hello, this is a message in {channel.Name}",
+                Sender = testUser,
+                Timestamp = new DateTimeOffset(DateTime.Now),
+            };
+            return new List<Message> { message };
+        }
+
+        private Channel createPublicChannel(int id) => new Channel
+        {
+            Id = id,
+            Name = $"#channel-{id}",
+            Topic = $"We talk about the number {id} here",
+            Type = ChannelType.Public,
+        };
+    }
+}
diff --git a/osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs b/osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs
index 7c4a72559b..fa8fae29e5 100644
--- a/osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs
+++ b/osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs
@@ -25,14 +25,14 @@ namespace osu.Game.Overlays.Chat.ChannelList
         public event Action<Channel>? OnRequestSelect;
         public event Action<Channel>? OnRequestLeave;
 
+        public readonly Channel Channel;
+
         public readonly BindableInt Mentions = new BindableInt();
 
         public readonly BindableBool Unread = new BindableBool();
 
         public readonly BindableBool SelectorActive = new BindableBool();
 
-        private readonly Channel channel;
-
         private Box hoverBox = null!;
         private Box selectBox = null!;
         private OsuSpriteText text = null!;
@@ -46,7 +46,7 @@ namespace osu.Game.Overlays.Chat.ChannelList
 
         public ChannelListItem(Channel channel)
         {
-            this.channel = channel;
+            Channel = channel;
         }
 
         [BackgroundDependencyLoader]
@@ -92,7 +92,7 @@ namespace osu.Game.Overlays.Chat.ChannelList
                                 {
                                     Anchor = Anchor.CentreLeft,
                                     Origin = Anchor.CentreLeft,
-                                    Text = channel.Name,
+                                    Text = Channel.Name,
                                     Font = OsuFont.Torus.With(size: 17, weight: FontWeight.SemiBold),
                                     Colour = colourProvider.Light3,
                                     Margin = new MarginPadding { Bottom = 2 },
@@ -111,7 +111,7 @@ namespace osu.Game.Overlays.Chat.ChannelList
                                     Anchor = Anchor.CentreLeft,
                                     Origin = Anchor.CentreLeft,
                                     Margin = new MarginPadding { Right = 3 },
-                                    Action = () => OnRequestLeave?.Invoke(channel),
+                                    Action = () => OnRequestLeave?.Invoke(Channel),
                                 }
                             }
                         },
@@ -119,7 +119,7 @@ namespace osu.Game.Overlays.Chat.ChannelList
                 },
             };
 
-            Action = () => OnRequestSelect?.Invoke(channel);
+            Action = () => OnRequestSelect?.Invoke(Channel);
         }
 
         protected override void LoadComplete()
@@ -151,10 +151,10 @@ namespace osu.Game.Overlays.Chat.ChannelList
 
         private Drawable createIcon()
         {
-            if (channel.Type != ChannelType.PM)
+            if (Channel.Type != ChannelType.PM)
                 return Drawable.Empty();
 
-            return new UpdateableAvatar(channel.Users.First(), isInteractive: false)
+            return new UpdateableAvatar(Channel.Users.First(), isInteractive: false)
             {
                 Size = new Vector2(20),
                 Margin = new MarginPadding { Right = 5 },
@@ -167,7 +167,7 @@ namespace osu.Game.Overlays.Chat.ChannelList
 
         private void updateSelectState()
         {
-            if (selectedChannel.Value == channel && !SelectorActive.Value)
+            if (selectedChannel.Value == Channel && !SelectorActive.Value)
                 selectBox.FadeIn(300, Easing.OutQuint);
             else
                 selectBox.FadeOut(200, Easing.OutQuint);
diff --git a/osu.Game/Overlays/Chat/ChatOverlayTopBar.cs b/osu.Game/Overlays/Chat/ChatOverlayTopBar.cs
new file mode 100644
index 0000000000..9ba7608d89
--- /dev/null
+++ b/osu.Game/Overlays/Chat/ChatOverlayTopBar.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.
+
+#nullable enable
+
+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.Graphics.Textures;
+using osu.Game.Graphics;
+using osu.Game.Graphics.Sprites;
+using osuTK;
+
+namespace osu.Game.Overlays.Chat
+{
+    public class ChatOverlayTopBar : Container
+    {
+        // IsHovered is used by overlay
+        public override bool HandlePositionalInput => true;
+
+        [BackgroundDependencyLoader]
+        private void load(OverlayColourProvider colourProvider, TextureStore textures)
+        {
+            Children = new Drawable[]
+            {
+                new Box
+                {
+                    RelativeSizeAxes = Axes.Both,
+                    Colour = colourProvider.Background3,
+                },
+                new GridContainer
+                {
+                    RelativeSizeAxes = Axes.Both,
+                    ColumnDimensions = new[]
+                    {
+                        new Dimension(GridSizeMode.Absolute, 50),
+                        new Dimension(),
+                    },
+                    Content = new[]
+                    {
+                        new Drawable[]
+                        {
+                            new Sprite
+                            {
+                                Anchor = Anchor.Centre,
+                                Origin = Anchor.Centre,
+                                Texture = textures.Get("Icons/Hexacons/messaging"),
+                                Size = new Vector2(18),
+                            },
+                            // Placeholder text
+                            new OsuSpriteText
+                            {
+                                Anchor = Anchor.CentreLeft,
+                                Origin = Anchor.CentreLeft,
+                                Text = "osu!chat",
+                                Font = OsuFont.Torus.With(size: 16, weight: FontWeight.SemiBold),
+                                Margin = new MarginPadding { Bottom = 2f },
+                            },
+                        },
+                    },
+                },
+            };
+        }
+    }
+}
diff --git a/osu.Game/Overlays/Chat/Listing/ChannelListingItem.cs b/osu.Game/Overlays/Chat/Listing/ChannelListingItem.cs
index 526cbcda87..1f0cbae7e2 100644
--- a/osu.Game/Overlays/Chat/Listing/ChannelListingItem.cs
+++ b/osu.Game/Overlays/Chat/Listing/ChannelListingItem.cs
@@ -25,11 +25,11 @@ namespace osu.Game.Overlays.Chat.Listing
         public event Action<Channel>? OnRequestJoin;
         public event Action<Channel>? OnRequestLeave;
 
-        public bool FilteringActive { get; set; }
-        public IEnumerable<string> FilterTerms => new[] { channel.Name, channel.Topic ?? string.Empty };
-        public bool MatchingFilter { set => this.FadeTo(value ? 1f : 0f, 100); }
+        public readonly Channel Channel;
 
-        private readonly Channel channel;
+        public bool FilteringActive { get; set; }
+        public IEnumerable<string> FilterTerms => new[] { Channel.Name, Channel.Topic ?? string.Empty };
+        public bool MatchingFilter { set => this.FadeTo(value ? 1f : 0f, 100); }
 
         private Box hoverBox = null!;
         private SpriteIcon checkbox = null!;
@@ -47,7 +47,7 @@ namespace osu.Game.Overlays.Chat.Listing
 
         public ChannelListingItem(Channel channel)
         {
-            this.channel = channel;
+            Channel = channel;
         }
 
         [BackgroundDependencyLoader]
@@ -94,7 +94,7 @@ namespace osu.Game.Overlays.Chat.Listing
                             {
                                 Anchor = Anchor.CentreLeft,
                                 Origin = Anchor.CentreLeft,
-                                Text = channel.Name,
+                                Text = Channel.Name,
                                 Font = OsuFont.Torus.With(size: text_size, weight: FontWeight.SemiBold),
                                 Margin = new MarginPadding { Bottom = 2 },
                             },
@@ -102,7 +102,7 @@ namespace osu.Game.Overlays.Chat.Listing
                             {
                                 Anchor = Anchor.CentreLeft,
                                 Origin = Anchor.CentreLeft,
-                                Text = channel.Topic,
+                                Text = Channel.Topic,
                                 Font = OsuFont.Torus.With(size: text_size),
                                 Margin = new MarginPadding { Bottom = 2 },
                             },
@@ -134,7 +134,7 @@ namespace osu.Game.Overlays.Chat.Listing
         {
             base.LoadComplete();
 
-            channelJoined = channel.Joined.GetBoundCopy();
+            channelJoined = Channel.Joined.GetBoundCopy();
             channelJoined.BindValueChanged(change =>
             {
                 const double duration = 500;
@@ -155,7 +155,7 @@ namespace osu.Game.Overlays.Chat.Listing
                 }
             }, true);
 
-            Action = () => (channelJoined.Value ? OnRequestLeave : OnRequestJoin)?.Invoke(channel);
+            Action = () => (channelJoined.Value ? OnRequestLeave : OnRequestJoin)?.Invoke(Channel);
         }
 
         protected override bool OnHover(HoverEvent e)
diff --git a/osu.Game/Overlays/ChatOverlayV2.cs b/osu.Game/Overlays/ChatOverlayV2.cs
new file mode 100644
index 0000000000..01b8ed2a45
--- /dev/null
+++ b/osu.Game/Overlays/ChatOverlayV2.cs
@@ -0,0 +1,293 @@
+// 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 enable
+
+using System.Collections;
+using System.Collections.Generic;
+using System.Collections.Specialized;
+using System.Diagnostics;
+using System.Linq;
+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.Framework.Localisation;
+using osu.Game.Configuration;
+using osu.Game.Graphics.Containers;
+using osu.Game.Graphics.UserInterface;
+using osu.Game.Localisation;
+using osu.Game.Online.Chat;
+using osu.Game.Overlays.Chat;
+using osu.Game.Overlays.Chat.ChannelList;
+using osu.Game.Overlays.Chat.Listing;
+
+namespace osu.Game.Overlays
+{
+    public class ChatOverlayV2 : OsuFocusedOverlayContainer, INamedOverlayComponent
+    {
+        public string IconTexture => "Icons/Hexacons/messaging";
+        public LocalisableString Title => ChatStrings.HeaderTitle;
+        public LocalisableString Description => ChatStrings.HeaderDescription;
+
+        private ChatOverlayTopBar topBar = null!;
+        private ChannelList channelList = null!;
+        private LoadingLayer loading = null!;
+        private ChannelListing channelListing = null!;
+        private ChatTextBar textBar = null!;
+        private Container<DrawableChannel> currentChannelContainer = null!;
+
+        private Bindable<float>? chatHeight;
+        private bool isDraggingTopBar;
+        private float dragStartChatHeight;
+
+        private const int transition_length = 500;
+        private const float default_chat_height = 0.4f;
+        private const float top_bar_height = 40;
+        private const float side_bar_width = 190;
+        private const float chat_bar_height = 60;
+
+        private readonly BindableBool selectorActive = new BindableBool();
+
+        [Resolved]
+        private OsuConfigManager config { get; set; } = null!;
+
+        [Resolved]
+        private ChannelManager channelManager { get; set; } = null!;
+
+        [Cached]
+        private readonly OverlayColourProvider colourProvider = new OverlayColourProvider(OverlayColourScheme.Pink);
+
+        [Cached]
+        private readonly Bindable<Channel> currentChannel = new Bindable<Channel>();
+
+        [BackgroundDependencyLoader]
+        private void load()
+        {
+            // Width = 0.85f; // Matches OnlineOverlay
+            Height = default_chat_height;
+            RelativeSizeAxes = Axes.Both;
+            RelativePositionAxes = Axes.Both;
+            Anchor = Anchor.BottomCentre;
+            Origin = Anchor.BottomCentre;
+            Masking = true;
+            CornerRadius = 7f;
+            Margin = new MarginPadding { Bottom = -10 };
+            Padding = new MarginPadding { Bottom = 10 };
+
+            Children = new Drawable[]
+            {
+                topBar = new ChatOverlayTopBar
+                {
+                    RelativeSizeAxes = Axes.X,
+                    Height = top_bar_height,
+                },
+                channelList = new ChannelList
+                {
+                    RelativeSizeAxes = Axes.Y,
+                    Width = side_bar_width,
+                    Padding = new MarginPadding { Top = top_bar_height },
+                    SelectorActive = { BindTarget = selectorActive },
+                },
+                new Container
+                {
+                    RelativeSizeAxes = Axes.Both,
+                    Anchor = Anchor.TopRight,
+                    Origin = Anchor.TopRight,
+                    Padding = new MarginPadding
+                    {
+                        Top = top_bar_height,
+                        Left = side_bar_width,
+                        Bottom = chat_bar_height,
+                    },
+                    Children = new Drawable[]
+                    {
+                        new Box
+                        {
+                            RelativeSizeAxes = Axes.Both,
+                            Colour = colourProvider.Background4,
+                        },
+                        currentChannelContainer = new Container<DrawableChannel>
+                        {
+                            RelativeSizeAxes = Axes.Both,
+                        },
+                        loading = new LoadingLayer(true),
+                        channelListing = new ChannelListing
+                        {
+                            RelativeSizeAxes = Axes.Both,
+                        },
+                    },
+                },
+                textBar = new ChatTextBar
+                {
+                    RelativeSizeAxes = Axes.X,
+                    Anchor = Anchor.BottomRight,
+                    Origin = Anchor.BottomRight,
+                    Padding = new MarginPadding { Left = side_bar_width },
+                    ShowSearch = { BindTarget = selectorActive },
+                },
+            };
+        }
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            loading.Show();
+
+            chatHeight = config.GetBindable<float>(OsuSetting.ChatDisplayHeight).GetBoundCopy();
+            chatHeight.BindValueChanged(height => { Height = height.NewValue; }, true);
+
+            currentChannel.BindTo(channelManager.CurrentChannel);
+            channelManager.CurrentChannel.BindValueChanged(currentChannelChanged, true);
+            channelManager.JoinedChannels.BindCollectionChanged(joinedChannelsChanged, true);
+            channelManager.AvailableChannels.BindCollectionChanged(availableChannelsChanged, true);
+
+            channelList.OnRequestSelect += channel =>
+            {
+                // Manually selecting a channel should dismiss the selector
+                selectorActive.Value = false;
+                channelManager.CurrentChannel.Value = channel;
+            };
+            channelList.OnRequestLeave += channel => channelManager.LeaveChannel(channel);
+
+            channelListing.OnRequestJoin += channel => channelManager.JoinChannel(channel);
+            channelListing.OnRequestLeave += channel => channelManager.LeaveChannel(channel);
+
+            textBar.OnSearchTermsChanged += searchTerms => channelListing.SearchTerm = searchTerms;
+            textBar.OnChatMessageCommitted += handleChatMessage;
+
+            selectorActive.BindValueChanged(v => channelListing.State.Value = v.NewValue ? Visibility.Visible : Visibility.Hidden, true);
+        }
+
+        /// <summary>
+        /// Highlights a certain message in the specified channel.
+        /// </summary>
+        /// <param name="message">The message to highlight.</param>
+        /// <param name="channel">The channel containing the message.</param>
+        public void HighlightMessage(Message message, Channel channel)
+        {
+            Debug.Assert(channel.Id == message.ChannelId);
+
+            if (currentChannel.Value?.Id != channel.Id)
+            {
+                if (!channel.Joined.Value)
+                    channel = channelManager.JoinChannel(channel);
+
+                channelManager.CurrentChannel.Value = channel;
+            }
+
+            selectorActive.Value = false;
+
+            channel.HighlightedMessage.Value = message;
+
+            Show();
+        }
+
+        protected override bool OnDragStart(DragStartEvent e)
+        {
+            isDraggingTopBar = topBar.IsHovered;
+
+            if (!isDraggingTopBar)
+                return base.OnDragStart(e);
+
+            dragStartChatHeight = chatHeight!.Value;
+            return true;
+        }
+
+        protected override void OnDrag(DragEvent e)
+        {
+            if (!isDraggingTopBar)
+                return;
+
+            float targetChatHeight = dragStartChatHeight - (e.MousePosition.Y - e.MouseDownPosition.Y) / Parent.DrawSize.Y;
+            chatHeight!.Value = targetChatHeight;
+        }
+
+        protected override void OnDragEnd(DragEndEvent e)
+        {
+            isDraggingTopBar = false;
+            base.OnDragEnd(e);
+        }
+
+        protected override void PopIn()
+        {
+            this.MoveToY(0, transition_length, Easing.OutQuint);
+            this.FadeIn(transition_length, Easing.OutQuint);
+            base.PopIn();
+        }
+
+        protected override void PopOut()
+        {
+            this.MoveToY(Height, transition_length, Easing.InSine);
+            this.FadeOut(transition_length, Easing.InSine);
+            base.PopOut();
+        }
+
+        private void currentChannelChanged(ValueChangedEvent<Channel> e)
+        {
+            Channel? newChannel = e.NewValue;
+
+            loading.Show();
+
+            // Channel is null when leaving the currently selected channel
+            if (newChannel == null)
+            {
+                // Find another channel to switch to
+                newChannel = channelManager.JoinedChannels.FirstOrDefault(chan => chan != e.OldValue);
+
+                if (newChannel == null)
+                    selectorActive.Value = true;
+                else
+                    currentChannel.Value = newChannel;
+
+                return;
+            }
+
+            LoadComponentAsync(new DrawableChannel(newChannel), loaded =>
+            {
+                currentChannelContainer.Clear();
+                currentChannelContainer.Add(loaded);
+                loading.Hide();
+            });
+        }
+
+        private void joinedChannelsChanged(object sender, NotifyCollectionChangedEventArgs args)
+        {
+            switch (args.Action)
+            {
+                case NotifyCollectionChangedAction.Add:
+                    IEnumerable<Channel> joinedChannels = filterChannels(args.NewItems);
+                    foreach (var channel in joinedChannels)
+                        channelList.AddChannel(channel);
+                    break;
+
+                case NotifyCollectionChangedAction.Remove:
+                    IEnumerable<Channel> leftChannels = filterChannels(args.OldItems);
+                    foreach (var channel in leftChannels)
+                        channelList.RemoveChannel(channel);
+                    break;
+            }
+        }
+
+        private void availableChannelsChanged(object sender, NotifyCollectionChangedEventArgs args)
+            => channelListing.UpdateAvailableChannels(channelManager.AvailableChannels);
+
+        private IEnumerable<Channel> filterChannels(IList channels)
+            => channels.Cast<Channel>().Where(c => c.Type == ChannelType.Public || c.Type == ChannelType.PM);
+
+        private void handleChatMessage(string message)
+        {
+            if (string.IsNullOrWhiteSpace(message))
+                return;
+
+            if (message[0] == '/')
+                channelManager.PostCommand(message.Substring(1));
+            else
+                channelManager.PostMessage(message);
+        }
+    }
+}
+

From 5c13200c75d581b796306b04e5d21ad3082beb3b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 1 May 2022 13:01:38 +0900
Subject: [PATCH 4419/5547] Update production endpoint to new version

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

diff --git a/osu.Game/Online/ProductionEndpointConfiguration.cs b/osu.Game/Online/ProductionEndpointConfiguration.cs
index c6ddc03564..e44dad1db5 100644
--- a/osu.Game/Online/ProductionEndpointConfiguration.cs
+++ b/osu.Game/Online/ProductionEndpointConfiguration.cs
@@ -10,8 +10,8 @@ namespace osu.Game.Online
             WebsiteRootUrl = APIEndpointUrl = @"https://osu.ppy.sh";
             APIClientSecret = @"FGc9GAtyHzeQDshWP5Ah7dega8hJACAJpQtw6OXk";
             APIClientID = "5";
-            SpectatorEndpointUrl = "https://spectator.ppy.sh/spectator";
-            MultiplayerEndpointUrl = "https://spectator.ppy.sh/multiplayer";
+            SpectatorEndpointUrl = "https://spectator2.ppy.sh/spectator";
+            MultiplayerEndpointUrl = "https://spectator2.ppy.sh/multiplayer";
         }
     }
 }

From 4bd1d091486feba7933432359758c531c40ec29b Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Sun, 1 May 2022 12:20:11 +0100
Subject: [PATCH 4420/5547] Remove blank line

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

diff --git a/osu.Game/Overlays/ChatOverlayV2.cs b/osu.Game/Overlays/ChatOverlayV2.cs
index 01b8ed2a45..d0b49d9ef3 100644
--- a/osu.Game/Overlays/ChatOverlayV2.cs
+++ b/osu.Game/Overlays/ChatOverlayV2.cs
@@ -290,4 +290,3 @@ namespace osu.Game.Overlays
         }
     }
 }
-

From bcce807311ae0a455ebf0771322c63ba9ed8c6d7 Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Sun, 1 May 2022 12:20:54 +0100
Subject: [PATCH 4421/5547] Fix chat command test as reference equality checks
 on PM channels doesn't seem to to work

---
 osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs b/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs
index 312bda6460..c7bb6760c7 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs
@@ -185,16 +185,17 @@ namespace osu.Game.Tests.Visual.Online
             AddStep("Join channel 1", () => channelManager.JoinChannel(testChannel1));
             AddStep("Select channel 1", () => clickDrawable(getChannelListItem(testChannel1)));
             AddStep("Open chat with user", () => channelManager.PostCommand($"chat {testUser.Username}"));
-            AddAssert("PM channel is selected", () => channelManager.CurrentChannel.Value == testPMChannel);
-            AddAssert("PM channel is visibile", () => currentDrawableChannel.Channel == testPMChannel);
+            AddAssert("PM channel is selected", () =>
+                channelManager.CurrentChannel.Value.Type == ChannelType.PM && channelManager.CurrentChannel.Value.Users.Single() == testUser);
             AddStep("Open chat with non-existent user", () => channelManager.PostCommand("chat user_doesnt_exist"));
             AddAssert("Last message is error", () => channelManager.CurrentChannel.Value.Messages.Last() is ErrorMessage);
+
             // Make sure no unnecessary requests are made when the PM channel is already open.
             AddStep("Select channel 1", () => clickDrawable(getChannelListItem(testChannel1)));
             AddStep("Unregister request handling", () => ((DummyAPIAccess)API).HandleRequest = null);
             AddStep("Open chat with user", () => channelManager.PostCommand($"chat {testUser.Username}"));
-            AddAssert("PM channel is selected", () => channelManager.CurrentChannel.Value == testPMChannel);
-            AddAssert("PM channel is visibile", () => currentDrawableChannel.Channel == testPMChannel);
+            AddAssert("PM channel is selected", () =>
+                channelManager.CurrentChannel.Value.Type == ChannelType.PM && channelManager.CurrentChannel.Value.Users.Single() == testUser);
         }
 
         [Test]

From 4b30d0e59b84cc4a8a496cd5d2ab8fcf16f125f8 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 2 May 2022 17:42:56 +0900
Subject: [PATCH 4422/5547] Fix first-run overlay's song select applying track
 adjustments

Closes https://github.com/ppy/osu/issues/18041.
---
 osu.Game/Overlays/FirstRunSetup/ScreenUIScale.cs | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/osu.Game/Overlays/FirstRunSetup/ScreenUIScale.cs b/osu.Game/Overlays/FirstRunSetup/ScreenUIScale.cs
index 1bd82f6d99..862506add2 100644
--- a/osu.Game/Overlays/FirstRunSetup/ScreenUIScale.cs
+++ b/osu.Game/Overlays/FirstRunSetup/ScreenUIScale.cs
@@ -99,6 +99,8 @@ namespace osu.Game.Overlays.FirstRunSetup
         private class NestedSongSelect : PlaySongSelect
         {
             protected override bool ControlGlobalMusic => false;
+
+            public override bool? AllowTrackAdjustments => false;
         }
 
         private class PinnedMainMenu : MainMenu

From c3e0ba5c8db4bd3d2042445ad1d8db136e5b93e6 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 2 May 2022 20:27:00 +0900
Subject: [PATCH 4423/5547] Fix clicking anywhere in the beatmap overlay
 dismissing it

---
 osu.Game/Overlays/BeatmapSetOverlay.cs | 10 ----------
 1 file changed, 10 deletions(-)

diff --git a/osu.Game/Overlays/BeatmapSetOverlay.cs b/osu.Game/Overlays/BeatmapSetOverlay.cs
index b9d3854066..bd63c997df 100644
--- a/osu.Game/Overlays/BeatmapSetOverlay.cs
+++ b/osu.Game/Overlays/BeatmapSetOverlay.cs
@@ -5,7 +5,6 @@ using System.Linq;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
-using osu.Framework.Input.Events;
 using osu.Game.Online.API.Requests;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays.BeatmapSet;
@@ -24,9 +23,6 @@ namespace osu.Game.Overlays
 
         private readonly Bindable<APIBeatmapSet> beatmapSet = new Bindable<APIBeatmapSet>();
 
-        // receive input outside our bounds so we can trigger a close event on ourselves.
-        public override bool ReceivePositionalInputAt(Vector2 screenSpacePos) => true;
-
         public BeatmapSetOverlay()
             : base(OverlayColourScheme.Blue)
         {
@@ -71,12 +67,6 @@ namespace osu.Game.Overlays
             beatmapSet.Value = null;
         }
 
-        protected override bool OnClick(ClickEvent e)
-        {
-            Hide();
-            return true;
-        }
-
         public void FetchAndShowBeatmap(int beatmapId)
         {
             beatmapSet.Value = null;

From 55949e8407bd91ad1bc32e09084d3db27cb986e3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 2 May 2022 20:30:03 +0900
Subject: [PATCH 4424/5547] Make disabled sheared buttons darker

---
 osu.Game/Graphics/UserInterface/ShearedButton.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Graphics/UserInterface/ShearedButton.cs b/osu.Game/Graphics/UserInterface/ShearedButton.cs
index c3c566782f..d46fa24409 100644
--- a/osu.Game/Graphics/UserInterface/ShearedButton.cs
+++ b/osu.Game/Graphics/UserInterface/ShearedButton.cs
@@ -176,8 +176,8 @@ namespace osu.Game.Graphics.UserInterface
 
             if (!Enabled.Value)
             {
-                colourDark = colourDark.Darken(0.3f);
-                colourLight = colourLight.Darken(0.3f);
+                colourDark = colourDark.Darken(1f);
+                colourLight = colourLight.Darken(1f);
             }
             else if (IsHovered)
             {

From f9a1d9df56968b8ebe8ff094ae990c4615214690 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 2 May 2022 20:30:36 +0900
Subject: [PATCH 4425/5547] Reduce scale effect slightly (was feeling too
 bouncy)

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

diff --git a/osu.Game/Graphics/UserInterface/ShearedButton.cs b/osu.Game/Graphics/UserInterface/ShearedButton.cs
index d46fa24409..dea44e6d99 100644
--- a/osu.Game/Graphics/UserInterface/ShearedButton.cs
+++ b/osu.Game/Graphics/UserInterface/ShearedButton.cs
@@ -158,7 +158,7 @@ namespace osu.Game.Graphics.UserInterface
 
         protected override bool OnMouseDown(MouseDownEvent e)
         {
-            Content.ScaleTo(0.8f, 2000, Easing.OutQuint);
+            Content.ScaleTo(0.9f, 2000, Easing.OutQuint);
             return base.OnMouseDown(e);
         }
 

From 18852b250965df3f8c51be41682c2fca9719f298 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Mon, 2 May 2022 15:31:47 +0300
Subject: [PATCH 4426/5547] Fix footer random button autosizing to text length

---
 osu.Game/Screens/Select/FooterButtonRandom.cs | 51 +++++++++++++++----
 1 file changed, 42 insertions(+), 9 deletions(-)

diff --git a/osu.Game/Screens/Select/FooterButtonRandom.cs b/osu.Game/Screens/Select/FooterButtonRandom.cs
index 48d5836826..f855b80f75 100644
--- a/osu.Game/Screens/Select/FooterButtonRandom.cs
+++ b/osu.Game/Screens/Select/FooterButtonRandom.cs
@@ -5,6 +5,7 @@ using System;
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
 using osu.Framework.Input.Events;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
@@ -19,6 +20,9 @@ namespace osu.Game.Screens.Select
         public Action NextRandom { get; set; }
         public Action PreviousRandom { get; set; }
 
+        private Container persistentText;
+        private OsuSpriteText randomSpriteText;
+        private OsuSpriteText rewindSpriteText;
         private bool rewindSearch;
 
         [BackgroundDependencyLoader]
@@ -26,7 +30,32 @@ namespace osu.Game.Screens.Select
         {
             SelectedColour = colours.Green;
             DeselectedColour = SelectedColour.Opacity(0.5f);
-            updateText();
+
+            TextContainer.Add(persistentText = new Container
+            {
+                Anchor = Anchor.Centre,
+                Origin = Anchor.Centre,
+                AlwaysPresent = true,
+                AutoSizeAxes = Axes.Both,
+                Children = new[]
+                {
+                    randomSpriteText = new OsuSpriteText
+                    {
+                        AlwaysPresent = true,
+                        Anchor = Anchor.Centre,
+                        Origin = Anchor.Centre,
+                        Text = "random",
+                    },
+                    rewindSpriteText = new OsuSpriteText
+                    {
+                        AlwaysPresent = true,
+                        Anchor = Anchor.Centre,
+                        Origin = Anchor.Centre,
+                        Text = "rewind",
+                        Alpha = 0f,
+                    }
+                }
+            });
 
             Action = () =>
             {
@@ -34,22 +63,22 @@ namespace osu.Game.Screens.Select
                 {
                     const double fade_time = 500;
 
-                    OsuSpriteText rewindSpriteText;
+                    OsuSpriteText fallingRewind;
 
-                    TextContainer.Add(rewindSpriteText = new OsuSpriteText
+                    TextContainer.Add(fallingRewind = new OsuSpriteText
                     {
                         Alpha = 0,
-                        Text = @"rewind",
+                        Text = rewindSpriteText.Text,
                         AlwaysPresent = true, // make sure the button is sized large enough to always show this
                         Anchor = Anchor.Centre,
                         Origin = Anchor.Centre,
                     });
 
-                    rewindSpriteText.FadeOutFromOne(fade_time, Easing.In);
-                    rewindSpriteText.MoveTo(Vector2.Zero).MoveTo(new Vector2(0, 10), fade_time, Easing.In);
-                    rewindSpriteText.Expire();
+                    fallingRewind.FadeOutFromOne(fade_time, Easing.In);
+                    fallingRewind.MoveTo(Vector2.Zero).MoveTo(new Vector2(0, 10), fade_time, Easing.In);
+                    fallingRewind.Expire();
 
-                    SpriteText.FadeInFromZero(fade_time, Easing.In);
+                    persistentText.FadeInFromZero(fade_time, Easing.In);
 
                     PreviousRandom.Invoke();
                 }
@@ -119,6 +148,10 @@ namespace osu.Game.Screens.Select
             }
         }
 
-        private void updateText(bool rewind = false) => Text = rewind ? "rewind" : "random";
+        private void updateText(bool rewind = false)
+        {
+            randomSpriteText.Alpha = rewind ? 0 : 1;
+            rewindSpriteText.Alpha = rewind ? 1 : 0;
+        }
     }
 }

From c4c62ff4e7c478dcafdcc21b166cd34ecc64a11d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 2 May 2022 22:46:14 +0900
Subject: [PATCH 4427/5547] Fix countdown sounds playing every minute, rather
 than only on the last minute

---
 .../OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs      | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
index a7e18622dc..62310bcaac 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
@@ -106,7 +106,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
             {
                 updateButtonText();
 
-                int secondsRemaining = countdownTimeRemaining.Seconds;
+                int secondsRemaining = (int)countdownTimeRemaining.TotalSeconds;
 
                 playTickSound(secondsRemaining);
 

From e6f1ac6bec24e483f42e985a4ca43cf0454d99f5 Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Mon, 2 May 2022 20:08:33 +0100
Subject: [PATCH 4428/5547] Ensure "chatting in..." text is aligned with chat
 message

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

diff --git a/osu.Game/Overlays/Chat/ChatTextBar.cs b/osu.Game/Overlays/Chat/ChatTextBar.cs
index ef20149dac..15fa2d87db 100644
--- a/osu.Game/Overlays/Chat/ChatTextBar.cs
+++ b/osu.Game/Overlays/Chat/ChatTextBar.cs
@@ -32,7 +32,7 @@ namespace osu.Game.Overlays.Chat
         private Container searchIconContainer = null!;
         private ChatTextBox chatTextBox = null!;
 
-        private const float chatting_text_width = 180;
+        private const float chatting_text_width = 240;
         private const float search_icon_width = 40;
 
         [BackgroundDependencyLoader]

From 1473762e2567884d8e238e1ce3c713e76c0be42b Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Mon, 2 May 2022 20:57:39 +0100
Subject: [PATCH 4429/5547] Don't wrap "chatting in.." text in `ChatTextBar`

---
 osu.Game/Overlays/Chat/ChatTextBar.cs | 31 ++++++++++++++++-----------
 1 file changed, 18 insertions(+), 13 deletions(-)

diff --git a/osu.Game/Overlays/Chat/ChatTextBar.cs b/osu.Game/Overlays/Chat/ChatTextBar.cs
index 15fa2d87db..316511d9a6 100644
--- a/osu.Game/Overlays/Chat/ChatTextBar.cs
+++ b/osu.Game/Overlays/Chat/ChatTextBar.cs
@@ -11,7 +11,8 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Graphics.UserInterface;
-using osu.Game.Graphics.Containers;
+using osu.Game.Graphics;
+using osu.Game.Graphics.Sprites;
 using osu.Game.Online.Chat;
 using osuTK;
 
@@ -28,7 +29,8 @@ namespace osu.Game.Overlays.Chat
         [Resolved]
         private Bindable<Channel> currentChannel { get; set; } = null!;
 
-        private OsuTextFlowContainer chattingTextContainer = null!;
+        private Container chattingTextContainer = null!;
+        private OsuSpriteText chattingText = null!;
         private Container searchIconContainer = null!;
         private ChatTextBox chatTextBox = null!;
 
@@ -61,16 +63,19 @@ namespace osu.Game.Overlays.Chat
                     {
                         new Drawable[]
                         {
-                            chattingTextContainer = new OsuTextFlowContainer(t => t.Font = t.Font.With(size: 20))
+                            chattingTextContainer = new Container
                             {
-                                Masking = true,
-                                Width = chatting_text_width,
-                                Padding = new MarginPadding { Left = 10 },
                                 RelativeSizeAxes = Axes.Y,
-                                TextAnchor = Anchor.CentreRight,
-                                Anchor = Anchor.CentreLeft,
-                                Origin = Anchor.CentreLeft,
-                                Colour = colourProvider.Background1,
+                                Width = chatting_text_width,
+                                Masking = true,
+                                Child = chattingText = new OsuSpriteText
+                                {
+                                    Font = OsuFont.Torus.With(size: 20),
+                                    Colour = colourProvider.Background1,
+                                    Anchor = Anchor.CentreRight,
+                                    Origin = Anchor.CentreRight,
+                                    Truncate = true,
+                                },
                             },
                             searchIconContainer = new Container
                             {
@@ -131,15 +136,15 @@ namespace osu.Game.Overlays.Chat
                 switch (newChannel?.Type)
                 {
                     case ChannelType.Public:
-                        chattingTextContainer.Text = $"chatting in {newChannel.Name}";
+                        chattingText.Text = $"chatting in {newChannel.Name}";
                         break;
 
                     case ChannelType.PM:
-                        chattingTextContainer.Text = $"chatting with {newChannel.Name}";
+                        chattingText.Text = $"chatting with {newChannel.Name}";
                         break;
 
                     default:
-                        chattingTextContainer.Text = string.Empty;
+                        chattingText.Text = string.Empty;
                         break;
                 }
             }, true);

From 7f8e00c1e3e8e6d66d4f9de132c0ffdddf9b37bf Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Mon, 2 May 2022 21:22:47 +0100
Subject: [PATCH 4430/5547] Change "Add more channels" to sentence case in
 "ChannelList"

---
 osu.Game/Overlays/Chat/ChannelList/ChannelListSelector.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/Chat/ChannelList/ChannelListSelector.cs b/osu.Game/Overlays/Chat/ChannelList/ChannelListSelector.cs
index 57ab7584b5..f9dab74eb1 100644
--- a/osu.Game/Overlays/Chat/ChannelList/ChannelListSelector.cs
+++ b/osu.Game/Overlays/Chat/ChannelList/ChannelListSelector.cs
@@ -50,7 +50,7 @@ namespace osu.Game.Overlays.Chat.ChannelList
                     {
                         Anchor = Anchor.CentreLeft,
                         Origin = Anchor.CentreLeft,
-                        Text = "Add More Channels",
+                        Text = "Add more channels",
                         Font = OsuFont.Torus.With(size: 17, weight: FontWeight.SemiBold),
                         Colour = colourProvider.Light3,
                         Margin = new MarginPadding { Bottom = 2 },

From a931b1ecc37a089edc4fcf55f93c94543cf26d08 Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Mon, 2 May 2022 22:32:25 +0100
Subject: [PATCH 4431/5547] Show selected channel text as white in
 `ChannelListItem`

---
 .../Chat/ChannelList/ChannelListItem.cs       | 23 +++++++++++--------
 1 file changed, 14 insertions(+), 9 deletions(-)

diff --git a/osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs b/osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs
index fa8fae29e5..e6a126f4d8 100644
--- a/osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs
+++ b/osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs
@@ -126,13 +126,9 @@ namespace osu.Game.Overlays.Chat.ChannelList
         {
             base.LoadComplete();
 
-            selectedChannel.BindValueChanged(_ => updateSelectState(), true);
-            SelectorActive.BindValueChanged(_ => updateSelectState(), true);
-
-            Unread.BindValueChanged(change =>
-            {
-                text.FadeColour(change.NewValue ? colourProvider.Content1 : colourProvider.Light3, 300, Easing.OutQuint);
-            }, true);
+            selectedChannel.BindValueChanged(_ => updateState(), true);
+            SelectorActive.BindValueChanged(_ => updateState(), true);
+            Unread.BindValueChanged(_ => updateState(), true);
         }
 
         protected override bool OnHover(HoverEvent e)
@@ -165,12 +161,21 @@ namespace osu.Game.Overlays.Chat.ChannelList
             };
         }
 
-        private void updateSelectState()
+        private void updateState()
         {
-            if (selectedChannel.Value == Channel && !SelectorActive.Value)
+            if (showSelected)
                 selectBox.FadeIn(300, Easing.OutQuint);
             else
                 selectBox.FadeOut(200, Easing.OutQuint);
+
+            if (showUnread || showSelected)
+                text.FadeColour(colourProvider.Content1, 300, Easing.OutQuint);
+            else
+                text.FadeColour(colourProvider.Light3, 200, Easing.OutQuint);
         }
+
+        private bool showUnread => Unread.Value;
+
+        private bool showSelected => selectedChannel.Value == Channel && !SelectorActive.Value;
     }
 }

From d7919f462c32def081a8424c09731088495146d7 Mon Sep 17 00:00:00 2001
From: Ganendra Afrasya <gsculerlor@hotmail.com>
Date: Tue, 3 May 2022 05:36:12 +0700
Subject: [PATCH 4432/5547] Split `SearchTextBox` into `SearchTextBox` and
 `BasicSearchTextBox`

---
 .../UserInterface/BasicSearchTextBox.cs       | 26 +++++++++++++++++++
 .../Graphics/UserInterface/SearchTextBox.cs   | 13 ----------
 2 files changed, 26 insertions(+), 13 deletions(-)
 create mode 100644 osu.Game/Graphics/UserInterface/BasicSearchTextBox.cs

diff --git a/osu.Game/Graphics/UserInterface/BasicSearchTextBox.cs b/osu.Game/Graphics/UserInterface/BasicSearchTextBox.cs
new file mode 100644
index 0000000000..aa101d7e08
--- /dev/null
+++ b/osu.Game/Graphics/UserInterface/BasicSearchTextBox.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 osu.Framework.Graphics;
+using osu.Framework.Graphics.Sprites;
+using osuTK;
+
+namespace osu.Game.Graphics.UserInterface
+{
+    public class BasicSearchTextBox : SearchTextBox
+    {
+        public BasicSearchTextBox()
+        {
+            Add(new SpriteIcon
+            {
+                Icon = FontAwesome.Solid.Search,
+                Origin = Anchor.CentreRight,
+                Anchor = Anchor.CentreRight,
+                Margin = new MarginPadding { Right = 10 },
+                Size = new Vector2(20),
+            });
+
+            TextFlow.Padding = new MarginPadding { Right = 35 };
+        }
+    }
+}
\ No newline at end of file
diff --git a/osu.Game/Graphics/UserInterface/SearchTextBox.cs b/osu.Game/Graphics/UserInterface/SearchTextBox.cs
index dd9ed7c9e9..cc0bc2dc46 100644
--- a/osu.Game/Graphics/UserInterface/SearchTextBox.cs
+++ b/osu.Game/Graphics/UserInterface/SearchTextBox.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.
 
-using osu.Framework.Graphics;
-using osu.Framework.Graphics.Sprites;
 using osu.Framework.Input;
 using osu.Framework.Input.Events;
 using osu.Game.Resources.Localisation.Web;
-using osuTK;
 using osuTK.Input;
 
 namespace osu.Game.Graphics.UserInterface
@@ -18,16 +15,6 @@ namespace osu.Game.Graphics.UserInterface
         public SearchTextBox()
         {
             Height = 35;
-            Add(new SpriteIcon
-            {
-                Icon = FontAwesome.Solid.Search,
-                Origin = Anchor.CentreRight,
-                Anchor = Anchor.CentreRight,
-                Margin = new MarginPadding { Right = 10 },
-                Size = new Vector2(20),
-            });
-
-            TextFlow.Padding = new MarginPadding { Right = 35 };
             PlaceholderText = HomeStrings.SearchPlaceholder;
         }
 

From 81be69e72ec3884fcc1347235036b735162efa1f Mon Sep 17 00:00:00 2001
From: Ganendra Afrasya <gsculerlor@hotmail.com>
Date: Tue, 3 May 2022 06:18:42 +0700
Subject: [PATCH 4433/5547] Update search textbox implementation to use
 `BasicSearchTextBox` instead

---
 osu.Game/Graphics/UserInterface/SeekLimitedSearchTextBox.cs     | 2 +-
 osu.Game/Overlays/BeatmapListing/BeatmapListingSearchControl.cs | 2 +-
 osu.Game/Overlays/Chat/Selection/ChannelSelectionOverlay.cs     | 2 +-
 osu.Game/Overlays/Music/FilterControl.cs                        | 2 +-
 osu.Game/Screens/OnlinePlay/Lounge/LoungeSubScreen.cs           | 2 +-
 5 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Graphics/UserInterface/SeekLimitedSearchTextBox.cs b/osu.Game/Graphics/UserInterface/SeekLimitedSearchTextBox.cs
index 6a9e8a5b8c..0b76ff658f 100644
--- a/osu.Game/Graphics/UserInterface/SeekLimitedSearchTextBox.cs
+++ b/osu.Game/Graphics/UserInterface/SeekLimitedSearchTextBox.cs
@@ -6,7 +6,7 @@ namespace osu.Game.Graphics.UserInterface
     /// <summary>
     /// A <see cref="SearchTextBox"/> which does not handle left/right arrow keys for seeking.
     /// </summary>
-    public class SeekLimitedSearchTextBox : SearchTextBox
+    public class SeekLimitedSearchTextBox : BasicSearchTextBox
     {
         public override bool HandleLeftRightArrows => false;
     }
diff --git a/osu.Game/Overlays/BeatmapListing/BeatmapListingSearchControl.cs b/osu.Game/Overlays/BeatmapListing/BeatmapListingSearchControl.cs
index 2474515802..eeaa31a013 100644
--- a/osu.Game/Overlays/BeatmapListing/BeatmapListingSearchControl.cs
+++ b/osu.Game/Overlays/BeatmapListing/BeatmapListingSearchControl.cs
@@ -163,7 +163,7 @@ namespace osu.Game.Overlays.BeatmapListing
 
         public void TakeFocus() => textBox.TakeFocus();
 
-        private class BeatmapSearchTextBox : SearchTextBox
+        private class BeatmapSearchTextBox : BasicSearchTextBox
         {
             /// <summary>
             /// Any time the text box receives key events (even while masked).
diff --git a/osu.Game/Overlays/Chat/Selection/ChannelSelectionOverlay.cs b/osu.Game/Overlays/Chat/Selection/ChannelSelectionOverlay.cs
index 231d7ca63c..9b0354e264 100644
--- a/osu.Game/Overlays/Chat/Selection/ChannelSelectionOverlay.cs
+++ b/osu.Game/Overlays/Chat/Selection/ChannelSelectionOverlay.cs
@@ -181,7 +181,7 @@ namespace osu.Game.Overlays.Chat.Selection
             base.PopOut();
         }
 
-        private class HeaderSearchTextBox : SearchTextBox
+        private class HeaderSearchTextBox : BasicSearchTextBox
         {
             [BackgroundDependencyLoader]
             private void load()
diff --git a/osu.Game/Overlays/Music/FilterControl.cs b/osu.Game/Overlays/Music/FilterControl.cs
index 66adbeebe8..46c66b4bae 100644
--- a/osu.Game/Overlays/Music/FilterControl.cs
+++ b/osu.Game/Overlays/Music/FilterControl.cs
@@ -56,7 +56,7 @@ namespace osu.Game.Overlays.Music
             Collection = collectionDropdown.Current.Value?.Collection
         };
 
-        public class FilterTextBox : SearchTextBox
+        public class FilterTextBox : BasicSearchTextBox
         {
             protected override bool AllowCommit => true;
 
diff --git a/osu.Game/Screens/OnlinePlay/Lounge/LoungeSubScreen.cs b/osu.Game/Screens/OnlinePlay/Lounge/LoungeSubScreen.cs
index ec55ae79ce..f2429c1944 100644
--- a/osu.Game/Screens/OnlinePlay/Lounge/LoungeSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Lounge/LoungeSubScreen.cs
@@ -129,7 +129,7 @@ namespace osu.Game.Screens.OnlinePlay.Lounge
                         {
                             RelativeSizeAxes = Axes.X,
                             Height = Header.HEIGHT,
-                            Child = searchTextBox = new SearchTextBox
+                            Child = searchTextBox = new BasicSearchTextBox
                             {
                                 Anchor = Anchor.CentreRight,
                                 Origin = Anchor.CentreRight,

From e6fbb199518c3c07a2f8a11f7d9a7f0fe2ccae8f Mon Sep 17 00:00:00 2001
From: Ganendra Afrasya <gsculerlor@hotmail.com>
Date: Thu, 21 Apr 2022 03:59:36 +0700
Subject: [PATCH 4434/5547] Implement new search textbox design

---
 .../TestSceneShearedSearchTextBox.cs          |  46 +++++
 .../UserInterface/ShearedSearchTextBox.cs     | 192 ++++++++++++++++++
 2 files changed, 238 insertions(+)
 create mode 100644 osu.Game.Tests/Visual/UserInterface/TestSceneShearedSearchTextBox.cs
 create mode 100644 osu.Game/Graphics/UserInterface/ShearedSearchTextBox.cs

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneShearedSearchTextBox.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneShearedSearchTextBox.cs
new file mode 100644
index 0000000000..e1dbf04133
--- /dev/null
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneShearedSearchTextBox.cs
@@ -0,0 +1,46 @@
+// 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.Game.Graphics.UserInterface;
+using osu.Game.Overlays;
+
+namespace osu.Game.Tests.Visual.UserInterface
+{
+    public class TestSceneShearedSearchTextBox : OsuTestScene
+    {
+        [Test]
+        public void TestAllColourSchemes()
+        {
+            foreach (var scheme in Enum.GetValues(typeof(OverlayColourScheme)).Cast<OverlayColourScheme>())
+                AddStep($"set {scheme} scheme", () => Child = createContent(scheme));
+        }
+
+        private Drawable createContent(OverlayColourScheme colourScheme)
+        {
+            var colourProvider = new OverlayColourProvider(colourScheme);
+
+            return new DependencyProvidingContainer
+            {
+                RelativeSizeAxes = Axes.Both,
+                CachedDependencies = new (Type, object)[]
+                {
+                    (typeof(OverlayColourProvider), colourProvider)
+                },
+                Children = new Drawable[]
+                {
+                    new ShearedSearchTextBox
+                    {
+                        Origin = Anchor.Centre,
+                        Anchor = Anchor.Centre,
+                        RelativeSizeAxes = Axes.X,
+                        Width = 0.5f
+                    }
+                }
+            };
+        }
+    }
+}
diff --git a/osu.Game/Graphics/UserInterface/ShearedSearchTextBox.cs b/osu.Game/Graphics/UserInterface/ShearedSearchTextBox.cs
new file mode 100644
index 0000000000..e3dc118faa
--- /dev/null
+++ b/osu.Game/Graphics/UserInterface/ShearedSearchTextBox.cs
@@ -0,0 +1,192 @@
+// 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.Shapes;
+using osu.Framework.Graphics.Sprites;
+using osu.Framework.Graphics.UserInterface;
+using osu.Framework.Input;
+using osu.Framework.Input.Events;
+using osu.Game.Graphics.Sprites;
+using osu.Game.Overlays;
+using osuTK;
+using osuTK.Graphics;
+using osuTK.Input;
+
+namespace osu.Game.Graphics.UserInterface
+{
+    public class ShearedSearchTextBox : CompositeDrawable, IHasCurrentValue<string>
+    {
+        private const float icon_container_width = 50;
+        private const float corner_radius = 10;
+        private const float height = 42;
+        private readonly Vector2 shear = new Vector2(0.2f, 0);
+
+        public FocusedTextBox TextBox;
+
+        public Bindable<string> Current
+        {
+            get => TextBox.Current;
+            set => TextBox.Current = value;
+        }
+
+        [BackgroundDependencyLoader]
+        private void load(OverlayColourProvider colourProvider)
+        {
+            Height = height;
+            Shear = shear;
+            Masking = true;
+            CornerRadius = corner_radius;
+            InternalChild = new Container
+            {
+                RelativeSizeAxes = Axes.Both,
+                Children = new Drawable[]
+                {
+                    new Box
+                    {
+                        Colour = colourProvider.Background3,
+                        RelativeSizeAxes = Axes.Both
+                    },
+                    new GridContainer
+                    {
+                        RelativeSizeAxes = Axes.Both,
+                        Content = new[]
+                        {
+                            new Drawable[]
+                            {
+                                new Container
+                                {
+                                    Name = @"Search box container",
+                                    RelativeSizeAxes = Axes.Both,
+                                    CornerRadius = corner_radius,
+                                    Masking = true,
+                                    Children = new Drawable[]
+                                    {
+                                        new Box
+                                        {
+                                            Colour = colourProvider.Background4,
+                                            RelativeSizeAxes = Axes.Both
+                                        },
+                                        TextBox = new SearchTextBox
+                                        {
+                                            Shear = -shear,
+                                            Anchor = Anchor.CentreLeft,
+                                            Origin = Anchor.CentreLeft,
+                                            RelativeSizeAxes = Axes.X,
+                                            Padding = new MarginPadding
+                                            {
+                                                Horizontal = corner_radius
+                                            }
+                                        }
+                                    }
+                                },
+                                new Container
+                                {
+                                    Name = @"Icon container",
+                                    RelativeSizeAxes = Axes.Y,
+                                    Width = icon_container_width,
+                                    Origin = Anchor.CentreRight,
+                                    Anchor = Anchor.CentreRight,
+                                    Children = new Drawable[]
+                                    {
+                                        new SpriteIcon
+                                        {
+                                            Icon = FontAwesome.Solid.Search,
+                                            Origin = Anchor.Centre,
+                                            Anchor = Anchor.Centre,
+                                            Size = new Vector2(16),
+                                            Shear = -shear
+                                        }
+                                    }
+                                }
+                            }
+                        },
+                        ColumnDimensions = new[] { new Dimension(), new Dimension(GridSizeMode.AutoSize) }
+                    }
+                }
+            };
+        }
+
+        public override bool HandleNonPositionalInput => TextBox.HandleNonPositionalInput;
+
+        private class SearchTextBox : FocusedTextBox
+        {
+            protected virtual bool AllowCommit => false;
+
+            [BackgroundDependencyLoader]
+            private void load(OverlayColourProvider colourProvider)
+            {
+                BackgroundFocused = colourProvider.Background4;
+                BackgroundUnfocused = colourProvider.Background4;
+                Placeholder.Colour = Color4.White;
+                PlaceholderText = @"Search";
+            }
+
+            protected override SpriteText CreatePlaceholder() => new OsuSpriteText
+            {
+                Font = OsuFont.GetFont(size: 20, weight: FontWeight.SemiBold)
+            };
+
+            protected override Drawable GetDrawableCharacter(char c) => new FallingDownContainer
+            {
+                AutoSizeAxes = Axes.Both,
+                Child = new OsuSpriteText { Text = c.ToString(), Font = OsuFont.GetFont(size: 20, weight: FontWeight.SemiBold) },
+            };
+
+            public override bool OnPressed(KeyBindingPressEvent<PlatformAction> e)
+            {
+                switch (e.Action)
+                {
+                    case PlatformAction.MoveBackwardLine:
+                    case PlatformAction.MoveForwardLine:
+                    // Shift+delete is handled via PlatformAction on macOS. this is not so useful in the context of a SearchTextBox
+                    // as we do not allow arrow key navigation in the first place (ie. the caret should always be at the end of text)
+                    // Avoid handling it here to allow other components to potentially consume the shortcut.
+                    case PlatformAction.DeleteForwardChar:
+                        return false;
+                }
+
+                return base.OnPressed(e);
+            }
+
+            protected override bool OnKeyDown(KeyDownEvent e)
+            {
+                if (!e.ControlPressed && !e.ShiftPressed)
+                {
+                    switch (e.Key)
+                    {
+                        case Key.Left:
+                        case Key.Right:
+                        case Key.Up:
+                        case Key.Down:
+                            return false;
+                    }
+                }
+
+                if (!AllowCommit)
+                {
+                    switch (e.Key)
+                    {
+                        case Key.KeypadEnter:
+                        case Key.Enter:
+                            return false;
+                    }
+                }
+
+                if (e.ShiftPressed)
+                {
+                    switch (e.Key)
+                    {
+                        case Key.Delete:
+                            return false;
+                    }
+                }
+
+                return base.OnKeyDown(e);
+            }
+        }
+    }
+}

From a436ff877f19d509ee0eb0a81a76659997aa99b1 Mon Sep 17 00:00:00 2001
From: Ganendra Afrasya <gsculerlor@hotmail.com>
Date: Fri, 22 Apr 2022 22:01:56 +0700
Subject: [PATCH 4435/5547] Apply review

---
 osu.Game/Graphics/UserInterface/ShearedSearchTextBox.cs | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Graphics/UserInterface/ShearedSearchTextBox.cs b/osu.Game/Graphics/UserInterface/ShearedSearchTextBox.cs
index e3dc118faa..89373ec8db 100644
--- a/osu.Game/Graphics/UserInterface/ShearedSearchTextBox.cs
+++ b/osu.Game/Graphics/UserInterface/ShearedSearchTextBox.cs
@@ -12,6 +12,7 @@ using osu.Framework.Input;
 using osu.Framework.Input.Events;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Overlays;
+using osu.Game.Overlays.Mods;
 using osuTK;
 using osuTK.Graphics;
 using osuTK.Input;
@@ -21,9 +22,9 @@ namespace osu.Game.Graphics.UserInterface
     public class ShearedSearchTextBox : CompositeDrawable, IHasCurrentValue<string>
     {
         private const float icon_container_width = 50;
-        private const float corner_radius = 10;
+        private const float corner_radius = 7;
         private const float height = 42;
-        private readonly Vector2 shear = new Vector2(0.2f, 0);
+        private readonly Vector2 shear = new Vector2(ShearedOverlayContainer.SHEAR, 0);
 
         public FocusedTextBox TextBox;
 
@@ -78,7 +79,7 @@ namespace osu.Game.Graphics.UserInterface
                                             RelativeSizeAxes = Axes.X,
                                             Padding = new MarginPadding
                                             {
-                                                Horizontal = corner_radius
+                                                Horizontal = corner_radius + shear.X
                                             }
                                         }
                                     }

From e03d086305626e3fe30e69787911f6c6b636a7a3 Mon Sep 17 00:00:00 2001
From: Ganendra Afrasya <gsculerlor@hotmail.com>
Date: Tue, 3 May 2022 11:24:48 +0700
Subject: [PATCH 4436/5547] Inherit `SearchTextBox` instead

---
 .../UserInterface/ShearedSearchTextBox.cs     | 58 +------------------
 1 file changed, 1 insertion(+), 57 deletions(-)

diff --git a/osu.Game/Graphics/UserInterface/ShearedSearchTextBox.cs b/osu.Game/Graphics/UserInterface/ShearedSearchTextBox.cs
index 89373ec8db..04c060a5bc 100644
--- a/osu.Game/Graphics/UserInterface/ShearedSearchTextBox.cs
+++ b/osu.Game/Graphics/UserInterface/ShearedSearchTextBox.cs
@@ -8,14 +8,11 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Graphics.UserInterface;
-using osu.Framework.Input;
-using osu.Framework.Input.Events;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Overlays;
 using osu.Game.Overlays.Mods;
 using osuTK;
 using osuTK.Graphics;
-using osuTK.Input;
 
 namespace osu.Game.Graphics.UserInterface
 {
@@ -113,9 +110,8 @@ namespace osu.Game.Graphics.UserInterface
 
         public override bool HandleNonPositionalInput => TextBox.HandleNonPositionalInput;
 
-        private class SearchTextBox : FocusedTextBox
+        private class InnerSearchTextBox : SearchTextBox
         {
-            protected virtual bool AllowCommit => false;
 
             [BackgroundDependencyLoader]
             private void load(OverlayColourProvider colourProvider)
@@ -136,58 +132,6 @@ namespace osu.Game.Graphics.UserInterface
                 AutoSizeAxes = Axes.Both,
                 Child = new OsuSpriteText { Text = c.ToString(), Font = OsuFont.GetFont(size: 20, weight: FontWeight.SemiBold) },
             };
-
-            public override bool OnPressed(KeyBindingPressEvent<PlatformAction> e)
-            {
-                switch (e.Action)
-                {
-                    case PlatformAction.MoveBackwardLine:
-                    case PlatformAction.MoveForwardLine:
-                    // Shift+delete is handled via PlatformAction on macOS. this is not so useful in the context of a SearchTextBox
-                    // as we do not allow arrow key navigation in the first place (ie. the caret should always be at the end of text)
-                    // Avoid handling it here to allow other components to potentially consume the shortcut.
-                    case PlatformAction.DeleteForwardChar:
-                        return false;
-                }
-
-                return base.OnPressed(e);
-            }
-
-            protected override bool OnKeyDown(KeyDownEvent e)
-            {
-                if (!e.ControlPressed && !e.ShiftPressed)
-                {
-                    switch (e.Key)
-                    {
-                        case Key.Left:
-                        case Key.Right:
-                        case Key.Up:
-                        case Key.Down:
-                            return false;
-                    }
-                }
-
-                if (!AllowCommit)
-                {
-                    switch (e.Key)
-                    {
-                        case Key.KeypadEnter:
-                        case Key.Enter:
-                            return false;
-                    }
-                }
-
-                if (e.ShiftPressed)
-                {
-                    switch (e.Key)
-                    {
-                        case Key.Delete:
-                            return false;
-                    }
-                }
-
-                return base.OnKeyDown(e);
-            }
         }
     }
 }

From a35502a834189826e4435ec7faf1cc3654d12481 Mon Sep 17 00:00:00 2001
From: Ganendra Afrasya <gsculerlor@hotmail.com>
Date: Tue, 3 May 2022 11:25:14 +0700
Subject: [PATCH 4437/5547] Move implementation to ctor instead of bdl method

---
 .../UserInterface/ShearedSearchTextBox.cs     | 40 +++++++++++++------
 1 file changed, 27 insertions(+), 13 deletions(-)

diff --git a/osu.Game/Graphics/UserInterface/ShearedSearchTextBox.cs b/osu.Game/Graphics/UserInterface/ShearedSearchTextBox.cs
index 04c060a5bc..4076c4f76b 100644
--- a/osu.Game/Graphics/UserInterface/ShearedSearchTextBox.cs
+++ b/osu.Game/Graphics/UserInterface/ShearedSearchTextBox.cs
@@ -22,17 +22,27 @@ namespace osu.Game.Graphics.UserInterface
         private const float corner_radius = 7;
         private const float height = 42;
         private readonly Vector2 shear = new Vector2(ShearedOverlayContainer.SHEAR, 0);
-
-        public FocusedTextBox TextBox;
+        private readonly Box background;
+        private readonly Box searchBoxBackground;
+        private readonly SearchTextBox textBox;
 
         public Bindable<string> Current
         {
-            get => TextBox.Current;
-            set => TextBox.Current = value;
+            get => textBox.Current;
+            set => textBox.Current = value;
         }
 
-        [BackgroundDependencyLoader]
-        private void load(OverlayColourProvider colourProvider)
+        public bool HoldFocus
+        {
+            get => textBox.HoldFocus;
+            set => textBox.HoldFocus = value;
+        }
+
+        public void TakeFocus() => textBox.TakeFocus();
+
+        public void KillFocus() => textBox.KillFocus();
+
+        public ShearedSearchTextBox()
         {
             Height = height;
             Shear = shear;
@@ -43,9 +53,8 @@ namespace osu.Game.Graphics.UserInterface
                 RelativeSizeAxes = Axes.Both,
                 Children = new Drawable[]
                 {
-                    new Box
+                    background = new Box
                     {
-                        Colour = colourProvider.Background3,
                         RelativeSizeAxes = Axes.Both
                     },
                     new GridContainer
@@ -63,12 +72,11 @@ namespace osu.Game.Graphics.UserInterface
                                     Masking = true,
                                     Children = new Drawable[]
                                     {
-                                        new Box
+                                        searchBoxBackground = new Box
                                         {
-                                            Colour = colourProvider.Background4,
                                             RelativeSizeAxes = Axes.Both
                                         },
-                                        TextBox = new SearchTextBox
+                                        textBox = new InnerSearchTextBox
                                         {
                                             Shear = -shear,
                                             Anchor = Anchor.CentreLeft,
@@ -108,11 +116,17 @@ namespace osu.Game.Graphics.UserInterface
             };
         }
 
-        public override bool HandleNonPositionalInput => TextBox.HandleNonPositionalInput;
+        [BackgroundDependencyLoader]
+        private void load(OverlayColourProvider colourProvider)
+        {
+            background.Colour = colourProvider.Background3;
+            searchBoxBackground.Colour = colourProvider.Background4;
+        }
+
+        public override bool HandleNonPositionalInput => textBox.HandleNonPositionalInput;
 
         private class InnerSearchTextBox : SearchTextBox
         {
-
             [BackgroundDependencyLoader]
             private void load(OverlayColourProvider colourProvider)
             {

From 4f16da893286b09da833f3b3aa24037019fdb266 Mon Sep 17 00:00:00 2001
From: Huo Yaoyuan <huoyaoyuan@hotmail.com>
Date: Mon, 2 May 2022 20:04:34 +0800
Subject: [PATCH 4438/5547] Set EnforceCodeStyleInBuild

---
 .globalconfig         | 55 +++++++++++++++++++++++++++++++++++++++++++
 Directory.Build.props |  1 +
 osu.sln               |  1 +
 3 files changed, 57 insertions(+)
 create mode 100644 .globalconfig

diff --git a/.globalconfig b/.globalconfig
new file mode 100644
index 0000000000..607798492c
--- /dev/null
+++ b/.globalconfig
@@ -0,0 +1,55 @@
+is_global = true
+
+# .NET Code Style
+# IDE styles reference: https://docs.microsoft.com/dotnet/fundamentals/code-analysis/style-rules/
+
+# IDE0001: Simplify names
+dotnet_diagnostic.IDE0001.severity = warning
+
+# IDE0002: Simplify member access
+dotnet_diagnostic.IDE0002.severity = warning
+
+# IDE0003: Remove qualification
+dotnet_diagnostic.IDE0003.severity = warning
+
+# IDE0004: Remove unnecessary cast
+dotnet_diagnostic.IDE0004.severity = warning
+
+# IDE0005: Remove unnecessary imports
+dotnet_diagnostic.IDE0005.severity = warning
+
+# IDE0034: Simplify default literal
+dotnet_diagnostic.IDE0034.severity = warning
+
+# IDE0036: Sort modifiers
+dotnet_diagnostic.IDE0036.severity = warning
+
+# IDE0040: Add accessibility modifier
+dotnet_diagnostic.IDE0040.severity = warning
+
+# IDE0049: Use keyword for type name
+dotnet_diagnostic.IDE0040.severity = warning
+
+# IDE0055: Fix formatting
+dotnet_diagnostic.IDE0055.severity = warning
+
+# IDE0051: Private method is unused
+dotnet_diagnostic.IDE0051.severity = silent
+
+# IDE0052: Private member is unused
+dotnet_diagnostic.IDE0052.severity = warning
+
+# IDE0073: File header
+dotnet_diagnostic.IDE0073.severity = warning
+
+# IDE0130: Namespace mismatch with folder
+dotnet_diagnostic.IDE0130.severity = warning
+
+# IDE1006: Naming style
+dotnet_diagnostic.IDE1006.severity = warning
+
+#Disable operator overloads requiring alternate named methods
+dotnet_diagnostic.CA2225.severity = none
+
+# Banned APIs
+dotnet_diagnostic.RS0030.severity = error
diff --git a/Directory.Build.props b/Directory.Build.props
index 709545bf1d..f3ddc68838 100644
--- a/Directory.Build.props
+++ b/Directory.Build.props
@@ -20,6 +20,7 @@
     <AdditionalFiles Include="$(MSBuildThisFileDirectory)CodeAnalysis\BannedSymbols.txt" />
   </ItemGroup>
   <PropertyGroup Label="Code Analysis">
+    <EnforceCodeStyleInBuild>true</EnforceCodeStyleInBuild>
     <CodeAnalysisRuleSet>$(MSBuildThisFileDirectory)CodeAnalysis\osu.ruleset</CodeAnalysisRuleSet>
   </PropertyGroup>
   <PropertyGroup Label="Documentation">
diff --git a/osu.sln b/osu.sln
index b5018db362..aeec0843be 100644
--- a/osu.sln
+++ b/osu.sln
@@ -56,6 +56,7 @@ EndProject
 Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Solution Items", "Solution Items", "{10DF8F12-50FD-45D8-8A38-17BA764BF54D}"
 	ProjectSection(SolutionItems) = preProject
 		.editorconfig = .editorconfig
+		.globalconfig = .globalconfig
 		Directory.Build.props = Directory.Build.props
 		osu.Android.props = osu.Android.props
 		osu.iOS.props = osu.iOS.props

From 7cf4dabe29961c7f9d74f88e5827269598ed45ce Mon Sep 17 00:00:00 2001
From: Huo Yaoyuan <huoyaoyuan@hotmail.com>
Date: Mon, 2 May 2022 20:07:53 +0800
Subject: [PATCH 4439/5547] Fix IDE0005 and IDE0034

---
 osu.Game/Migrations/20181007180454_StandardizePaths.cs        | 4 +---
 .../Overlays/BeatmapSet/Scores/TopScoreStatisticsSection.cs   | 2 +-
 .../Overlays/Profile/Header/Components/LevelProgressBar.cs    | 2 +-
 osu.Game/Overlays/Rankings/SpotlightSelector.cs               | 2 +-
 osu.Game/Overlays/Rankings/Tables/PerformanceTable.cs         | 3 +--
 .../Edit/Compose/Components/SelectionBoxRotationHandle.cs     | 2 +-
 6 files changed, 6 insertions(+), 9 deletions(-)

diff --git a/osu.Game/Migrations/20181007180454_StandardizePaths.cs b/osu.Game/Migrations/20181007180454_StandardizePaths.cs
index 274b8030a9..11a020eb9c 100644
--- a/osu.Game/Migrations/20181007180454_StandardizePaths.cs
+++ b/osu.Game/Migrations/20181007180454_StandardizePaths.cs
@@ -1,6 +1,4 @@
-using System;
-using Microsoft.EntityFrameworkCore.Migrations;
-using System.IO;
+using Microsoft.EntityFrameworkCore.Migrations;
 
 namespace osu.Game.Migrations
 {
diff --git a/osu.Game/Overlays/BeatmapSet/Scores/TopScoreStatisticsSection.cs b/osu.Game/Overlays/BeatmapSet/Scores/TopScoreStatisticsSection.cs
index 9ee002fd9d..f528f54cdf 100644
--- a/osu.Game/Overlays/BeatmapSet/Scores/TopScoreStatisticsSection.cs
+++ b/osu.Game/Overlays/BeatmapSet/Scores/TopScoreStatisticsSection.cs
@@ -119,7 +119,7 @@ namespace osu.Game.Overlays.BeatmapSet.Scores
                 maxComboColumn.Text = value.MaxCombo.ToLocalisableString(@"0\x");
 
                 ppColumn.Alpha = value.BeatmapInfo.Status.GrantsPerformancePoints() ? 1 : 0;
-                ppColumn.Text = value.PP?.ToLocalisableString(@"N0") ?? default(LocalisableString);
+                ppColumn.Text = value.PP?.ToLocalisableString(@"N0") ?? default;
 
                 statisticsColumns.ChildrenEnumerable = value.GetStatisticsForDisplay().Select(createStatisticsColumn);
                 modsColumn.Mods = value.Mods;
diff --git a/osu.Game/Overlays/Profile/Header/Components/LevelProgressBar.cs b/osu.Game/Overlays/Profile/Header/Components/LevelProgressBar.cs
index ec9cb55042..d8eb5b65ac 100644
--- a/osu.Game/Overlays/Profile/Header/Components/LevelProgressBar.cs
+++ b/osu.Game/Overlays/Profile/Header/Components/LevelProgressBar.cs
@@ -62,7 +62,7 @@ namespace osu.Game.Overlays.Profile.Header.Components
         private void updateProgress(APIUser user)
         {
             levelProgressBar.Length = user?.Statistics?.Level.Progress / 100f ?? 0;
-            levelProgressText.Text = user?.Statistics?.Level.Progress.ToLocalisableString("0'%'") ?? default(LocalisableString);
+            levelProgressText.Text = user?.Statistics?.Level.Progress.ToLocalisableString("0'%'") ?? default;
         }
     }
 }
diff --git a/osu.Game/Overlays/Rankings/SpotlightSelector.cs b/osu.Game/Overlays/Rankings/SpotlightSelector.cs
index 48a4c31f30..c05c160463 100644
--- a/osu.Game/Overlays/Rankings/SpotlightSelector.cs
+++ b/osu.Game/Overlays/Rankings/SpotlightSelector.cs
@@ -126,7 +126,7 @@ namespace osu.Game.Overlays.Rankings
             startDateColumn.Value = dateToString(response.Spotlight.StartDate);
             endDateColumn.Value = dateToString(response.Spotlight.EndDate);
             mapCountColumn.Value = response.BeatmapSets.Count.ToLocalisableString(@"N0");
-            participantsColumn.Value = response.Spotlight.Participants?.ToLocalisableString(@"N0") ?? default(LocalisableString);
+            participantsColumn.Value = response.Spotlight.Participants?.ToLocalisableString(@"N0") ?? default;
         }
 
         private LocalisableString dateToString(DateTimeOffset date) => date.ToLocalisableString(@"yyyy-MM-dd");
diff --git a/osu.Game/Overlays/Rankings/Tables/PerformanceTable.cs b/osu.Game/Overlays/Rankings/Tables/PerformanceTable.cs
index bdbd2942d1..6c85ec2753 100644
--- a/osu.Game/Overlays/Rankings/Tables/PerformanceTable.cs
+++ b/osu.Game/Overlays/Rankings/Tables/PerformanceTable.cs
@@ -5,7 +5,6 @@ using System.Collections.Generic;
 using osu.Framework.Extensions.LocalisationExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
-using osu.Framework.Localisation;
 using osu.Game.Resources.Localisation.Web;
 using osu.Game.Users;
 
@@ -25,7 +24,7 @@ namespace osu.Game.Overlays.Rankings.Tables
 
         protected override Drawable[] CreateUniqueContent(UserStatistics item) => new Drawable[]
         {
-            new RowText { Text = item.PP?.ToLocalisableString(@"N0") ?? default(LocalisableString), }
+            new RowText { Text = item.PP?.ToLocalisableString(@"N0") ?? default, }
         };
     }
 }
diff --git a/osu.Game/Screens/Edit/Compose/Components/SelectionBoxRotationHandle.cs b/osu.Game/Screens/Edit/Compose/Components/SelectionBoxRotationHandle.cs
index 22479bd9b3..f13ed0456a 100644
--- a/osu.Game/Screens/Edit/Compose/Components/SelectionBoxRotationHandle.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/SelectionBoxRotationHandle.cs
@@ -100,7 +100,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
 
         private void updateTooltipText()
         {
-            TooltipText = cumulativeRotation.Value?.ToLocalisableString("0.0°") ?? default(LocalisableString);
+            TooltipText = cumulativeRotation.Value?.ToLocalisableString("0.0°") ?? default;
         }
     }
 }

From 5513710b2efbe9684cbf850ea7ef8c8ce04dcb38 Mon Sep 17 00:00:00 2001
From: Huo Yaoyuan <huoyaoyuan@hotmail.com>
Date: Mon, 2 May 2022 21:51:28 +0800
Subject: [PATCH 4440/5547] Fix IDE0055

---
 .../CatchSelectionBlueprintTestScene.cs       |  5 +-
 .../TestSceneManageCollectionsDialog.cs       |  3 +-
 .../OnlinePlay/Components/DrawableGameType.cs | 76 ++++++++++---------
 3 files changed, 44 insertions(+), 40 deletions(-)

diff --git a/osu.Game.Rulesets.Catch.Tests/Editor/CatchSelectionBlueprintTestScene.cs b/osu.Game.Rulesets.Catch.Tests/Editor/CatchSelectionBlueprintTestScene.cs
index e345e03c96..88fd3b36ba 100644
--- a/osu.Game.Rulesets.Catch.Tests/Editor/CatchSelectionBlueprintTestScene.cs
+++ b/osu.Game.Rulesets.Catch.Tests/Editor/CatchSelectionBlueprintTestScene.cs
@@ -29,13 +29,14 @@ namespace osu.Game.Rulesets.Catch.Tests.Editor
 
         protected CatchSelectionBlueprintTestScene()
         {
-            EditorBeatmap = new EditorBeatmap(new CatchBeatmap
+            var catchBeatmap = new CatchBeatmap
             {
                 BeatmapInfo =
                 {
                     Ruleset = new CatchRuleset().RulesetInfo,
                 }
-            }) { Difficulty = { CircleSize = 0 } };
+            };
+            EditorBeatmap = new EditorBeatmap(catchBeatmap) { Difficulty = { CircleSize = 0 } };
             EditorBeatmap.ControlPointInfo.Add(0, new TimingControlPoint
             {
                 BeatLength = 100
diff --git a/osu.Game.Tests/Visual/Collections/TestSceneManageCollectionsDialog.cs b/osu.Game.Tests/Visual/Collections/TestSceneManageCollectionsDialog.cs
index 51ca55f37f..d5983ac827 100644
--- a/osu.Game.Tests/Visual/Collections/TestSceneManageCollectionsDialog.cs
+++ b/osu.Game.Tests/Visual/Collections/TestSceneManageCollectionsDialog.cs
@@ -141,7 +141,8 @@ namespace osu.Game.Tests.Visual.Collections
         {
             AddStep("add dropdown", () =>
             {
-                Add(new CollectionFilterDropdown
+                Add(
+                    new CollectionFilterDropdown
                     {
                         Anchor = Anchor.TopRight,
                         Origin = Anchor.TopRight,
diff --git a/osu.Game/Screens/OnlinePlay/Components/DrawableGameType.cs b/osu.Game/Screens/OnlinePlay/Components/DrawableGameType.cs
index 613f16563c..f360a80599 100644
--- a/osu.Game/Screens/OnlinePlay/Components/DrawableGameType.cs
+++ b/osu.Game/Screens/OnlinePlay/Components/DrawableGameType.cs
@@ -87,44 +87,46 @@ namespace osu.Game.Screens.OnlinePlay.Components
                         },
                     };
 
-                // case MatchType.TagCoop:
-                //     return new SpriteIcon
-                //     {
-                //         Anchor = Anchor.Centre,
-                //         Origin = Anchor.Centre,
-                //         Size = new Vector2(size),
-                //         Icon = FontAwesome.Solid.Sync,
-                //         Colour = colours.Blue,
-                //
-                //         Shadow = false
-                //     };
+#pragma warning disable IDE0055 // Indentation of commented code
+                    // case MatchType.TagCoop:
+                    //     return new SpriteIcon
+                    //     {
+                    //         Anchor = Anchor.Centre,
+                    //         Origin = Anchor.Centre,
+                    //         Size = new Vector2(size),
+                    //         Icon = FontAwesome.Solid.Sync,
+                    //         Colour = colours.Blue,
+                    //
+                    //         Shadow = false
+                    //     };
 
-                // case MatchType.TagTeamCoop:
-                //     return new FillFlowContainer
-                //     {
-                //         Anchor = Anchor.Centre,
-                //         Origin = Anchor.Centre,
-                //         AutoSizeAxes = Axes.Both,
-                //         Direction = FillDirection.Horizontal,
-                //         Spacing = new Vector2(2f),
-                //         Children = new[]
-                //         {
-                //             new SpriteIcon
-                //             {
-                //                 Icon = FontAwesome.Solid.Sync,
-                //                 Size = new Vector2(size * 0.75f),
-                //                 Colour = colours.Blue,
-                //                 Shadow = false,
-                //             },
-                //             new SpriteIcon
-                //             {
-                //                 Icon = FontAwesome.Solid.Sync,
-                //                 Size = new Vector2(size * 0.75f),
-                //                 Colour = colours.Pink,
-                //                 Shadow = false,
-                //             },
-                //         },
-                //     };
+                    // case MatchType.TagTeamCoop:
+                    //     return new FillFlowContainer
+                    //     {
+                    //         Anchor = Anchor.Centre,
+                    //         Origin = Anchor.Centre,
+                    //         AutoSizeAxes = Axes.Both,
+                    //         Direction = FillDirection.Horizontal,
+                    //         Spacing = new Vector2(2f),
+                    //         Children = new[]
+                    //         {
+                    //             new SpriteIcon
+                    //             {
+                    //                 Icon = FontAwesome.Solid.Sync,
+                    //                 Size = new Vector2(size * 0.75f),
+                    //                 Colour = colours.Blue,
+                    //                 Shadow = false,
+                    //             },
+                    //             new SpriteIcon
+                    //             {
+                    //                 Icon = FontAwesome.Solid.Sync,
+                    //                 Size = new Vector2(size * 0.75f),
+                    //                 Colour = colours.Pink,
+                    //                 Shadow = false,
+                    //             },
+                    //         },
+                    //     };
+#pragma warning restore IDE0055
             }
         }
 

From 4a56297c1c187083878aa7c9e8b83c9fedf33cee Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 3 May 2022 14:28:58 +0900
Subject: [PATCH 4441/5547] Add localisation and improve visuals of placeholder
 text

---
 .../UserInterface/ShearedSearchTextBox.cs     | 27 ++++++++++++++-----
 1 file changed, 21 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Graphics/UserInterface/ShearedSearchTextBox.cs b/osu.Game/Graphics/UserInterface/ShearedSearchTextBox.cs
index 4076c4f76b..5dda8598bc 100644
--- a/osu.Game/Graphics/UserInterface/ShearedSearchTextBox.cs
+++ b/osu.Game/Graphics/UserInterface/ShearedSearchTextBox.cs
@@ -11,8 +11,8 @@ using osu.Framework.Graphics.UserInterface;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Overlays;
 using osu.Game.Overlays.Mods;
+using osu.Game.Resources.Localisation.Web;
 using osuTK;
-using osuTK.Graphics;
 
 namespace osu.Game.Graphics.UserInterface
 {
@@ -132,14 +132,29 @@ namespace osu.Game.Graphics.UserInterface
             {
                 BackgroundFocused = colourProvider.Background4;
                 BackgroundUnfocused = colourProvider.Background4;
-                Placeholder.Colour = Color4.White;
-                PlaceholderText = @"Search";
+
+                Placeholder.Font = OsuFont.GetFont(size: CalculatedTextSize, weight: FontWeight.SemiBold);
+                PlaceholderText = CommonStrings.InputSearch;
             }
 
-            protected override SpriteText CreatePlaceholder() => new OsuSpriteText
+            protected override SpriteText CreatePlaceholder() => new SearchPlaceholder();
+
+            internal class SearchPlaceholder : SpriteText
             {
-                Font = OsuFont.GetFont(size: 20, weight: FontWeight.SemiBold)
-            };
+                public override void Show()
+                {
+                    this
+                        .MoveToY(0, 250, Easing.OutQuint)
+                        .FadeIn(250, Easing.OutQuint);
+                }
+
+                public override void Hide()
+                {
+                    this
+                        .MoveToY(3, 250, Easing.OutQuint)
+                        .FadeOut(250, Easing.OutQuint);
+                }
+            }
 
             protected override Drawable GetDrawableCharacter(char c) => new FallingDownContainer
             {

From 8e0235392f9df3fed2007cbb69f94fad0990be17 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 3 May 2022 14:30:38 +0900
Subject: [PATCH 4442/5547] Inline single-use constants

---
 .../UserInterface/ShearedSearchTextBox.cs     | 22 ++++++++++---------
 1 file changed, 12 insertions(+), 10 deletions(-)

diff --git a/osu.Game/Graphics/UserInterface/ShearedSearchTextBox.cs b/osu.Game/Graphics/UserInterface/ShearedSearchTextBox.cs
index 5dda8598bc..639331196d 100644
--- a/osu.Game/Graphics/UserInterface/ShearedSearchTextBox.cs
+++ b/osu.Game/Graphics/UserInterface/ShearedSearchTextBox.cs
@@ -18,10 +18,8 @@ namespace osu.Game.Graphics.UserInterface
 {
     public class ShearedSearchTextBox : CompositeDrawable, IHasCurrentValue<string>
     {
-        private const float icon_container_width = 50;
         private const float corner_radius = 7;
-        private const float height = 42;
-        private readonly Vector2 shear = new Vector2(ShearedOverlayContainer.SHEAR, 0);
+
         private readonly Box background;
         private readonly Box searchBoxBackground;
         private readonly SearchTextBox textBox;
@@ -44,8 +42,8 @@ namespace osu.Game.Graphics.UserInterface
 
         public ShearedSearchTextBox()
         {
-            Height = height;
-            Shear = shear;
+            Height = 42;
+            Shear = new Vector2(ShearedOverlayContainer.SHEAR, 0);
             Masking = true;
             CornerRadius = corner_radius;
             InternalChild = new Container
@@ -78,13 +76,13 @@ namespace osu.Game.Graphics.UserInterface
                                         },
                                         textBox = new InnerSearchTextBox
                                         {
-                                            Shear = -shear,
+                                            Shear = -new Vector2(ShearedOverlayContainer.SHEAR, 0),
                                             Anchor = Anchor.CentreLeft,
                                             Origin = Anchor.CentreLeft,
                                             RelativeSizeAxes = Axes.X,
                                             Padding = new MarginPadding
                                             {
-                                                Horizontal = corner_radius + shear.X
+                                                Horizontal = corner_radius + new Vector2(ShearedOverlayContainer.SHEAR, 0).X
                                             }
                                         }
                                     }
@@ -93,7 +91,7 @@ namespace osu.Game.Graphics.UserInterface
                                 {
                                     Name = @"Icon container",
                                     RelativeSizeAxes = Axes.Y,
-                                    Width = icon_container_width,
+                                    Width = 50,
                                     Origin = Anchor.CentreRight,
                                     Anchor = Anchor.CentreRight,
                                     Children = new Drawable[]
@@ -104,13 +102,17 @@ namespace osu.Game.Graphics.UserInterface
                                             Origin = Anchor.Centre,
                                             Anchor = Anchor.Centre,
                                             Size = new Vector2(16),
-                                            Shear = -shear
+                                            Shear = -new Vector2(ShearedOverlayContainer.SHEAR, 0)
                                         }
                                     }
                                 }
                             }
                         },
-                        ColumnDimensions = new[] { new Dimension(), new Dimension(GridSizeMode.AutoSize) }
+                        ColumnDimensions = new[]
+                        {
+                            new Dimension(),
+                            new Dimension(GridSizeMode.AutoSize)
+                        }
                     }
                 }
             };

From bc88c4ee8e201f3734d9b60a725e77978e002cd7 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 3 May 2022 14:34:18 +0900
Subject: [PATCH 4443/5547] Reduce container nesting by one level

---
 .../UserInterface/ShearedSearchTextBox.cs     | 103 +++++++++---------
 1 file changed, 50 insertions(+), 53 deletions(-)

diff --git a/osu.Game/Graphics/UserInterface/ShearedSearchTextBox.cs b/osu.Game/Graphics/UserInterface/ShearedSearchTextBox.cs
index 639331196d..8b49f1d90e 100644
--- a/osu.Game/Graphics/UserInterface/ShearedSearchTextBox.cs
+++ b/osu.Game/Graphics/UserInterface/ShearedSearchTextBox.cs
@@ -46,73 +46,70 @@ namespace osu.Game.Graphics.UserInterface
             Shear = new Vector2(ShearedOverlayContainer.SHEAR, 0);
             Masking = true;
             CornerRadius = corner_radius;
-            InternalChild = new Container
+
+            InternalChildren = new Drawable[]
             {
-                RelativeSizeAxes = Axes.Both,
-                Children = new Drawable[]
+                background = new Box
                 {
-                    background = new Box
+                    RelativeSizeAxes = Axes.Both
+                },
+                new GridContainer
+                {
+                    RelativeSizeAxes = Axes.Both,
+                    Content = new[]
                     {
-                        RelativeSizeAxes = Axes.Both
-                    },
-                    new GridContainer
-                    {
-                        RelativeSizeAxes = Axes.Both,
-                        Content = new[]
+                        new Drawable[]
                         {
-                            new Drawable[]
+                            new Container
                             {
-                                new Container
+                                Name = @"Search box container",
+                                RelativeSizeAxes = Axes.Both,
+                                CornerRadius = corner_radius,
+                                Masking = true,
+                                Children = new Drawable[]
                                 {
-                                    Name = @"Search box container",
-                                    RelativeSizeAxes = Axes.Both,
-                                    CornerRadius = corner_radius,
-                                    Masking = true,
-                                    Children = new Drawable[]
+                                    searchBoxBackground = new Box
                                     {
-                                        searchBoxBackground = new Box
-                                        {
-                                            RelativeSizeAxes = Axes.Both
-                                        },
-                                        textBox = new InnerSearchTextBox
-                                        {
-                                            Shear = -new Vector2(ShearedOverlayContainer.SHEAR, 0),
-                                            Anchor = Anchor.CentreLeft,
-                                            Origin = Anchor.CentreLeft,
-                                            RelativeSizeAxes = Axes.X,
-                                            Padding = new MarginPadding
-                                            {
-                                                Horizontal = corner_radius + new Vector2(ShearedOverlayContainer.SHEAR, 0).X
-                                            }
-                                        }
-                                    }
-                                },
-                                new Container
-                                {
-                                    Name = @"Icon container",
-                                    RelativeSizeAxes = Axes.Y,
-                                    Width = 50,
-                                    Origin = Anchor.CentreRight,
-                                    Anchor = Anchor.CentreRight,
-                                    Children = new Drawable[]
+                                        RelativeSizeAxes = Axes.Both
+                                    },
+                                    textBox = new InnerSearchTextBox
                                     {
-                                        new SpriteIcon
+                                        Shear = -Shear,
+                                        Anchor = Anchor.CentreLeft,
+                                        Origin = Anchor.CentreLeft,
+                                        RelativeSizeAxes = Axes.X,
+                                        Padding = new MarginPadding
                                         {
-                                            Icon = FontAwesome.Solid.Search,
-                                            Origin = Anchor.Centre,
-                                            Anchor = Anchor.Centre,
-                                            Size = new Vector2(16),
-                                            Shear = -new Vector2(ShearedOverlayContainer.SHEAR, 0)
+                                            Horizontal = corner_radius + Shear.X
                                         }
                                     }
                                 }
+                            },
+                            new Container
+                            {
+                                Name = @"Icon container",
+                                RelativeSizeAxes = Axes.Y,
+                                Width = 50,
+                                Origin = Anchor.CentreRight,
+                                Anchor = Anchor.CentreRight,
+                                Children = new Drawable[]
+                                {
+                                    new SpriteIcon
+                                    {
+                                        Icon = FontAwesome.Solid.Search,
+                                        Origin = Anchor.Centre,
+                                        Anchor = Anchor.Centre,
+                                        Size = new Vector2(16),
+                                        Shear = -Shear
+                                    }
+                                }
                             }
-                        },
-                        ColumnDimensions = new[]
-                        {
-                            new Dimension(),
-                            new Dimension(GridSizeMode.AutoSize)
                         }
+                    },
+                    ColumnDimensions = new[]
+                    {
+                        new Dimension(),
+                        new Dimension(GridSizeMode.AutoSize)
                     }
                 }
             };

From b5ea26f2fa7b4f2c99c733f49111c16b8704a2be Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 3 May 2022 14:45:17 +0900
Subject: [PATCH 4444/5547] Fix incorrect shear masking on nested textbox

---
 .../UserInterface/ShearedSearchTextBox.cs     | 31 +++++--------------
 1 file changed, 7 insertions(+), 24 deletions(-)

diff --git a/osu.Game/Graphics/UserInterface/ShearedSearchTextBox.cs b/osu.Game/Graphics/UserInterface/ShearedSearchTextBox.cs
index 8b49f1d90e..d16ae2498a 100644
--- a/osu.Game/Graphics/UserInterface/ShearedSearchTextBox.cs
+++ b/osu.Game/Graphics/UserInterface/ShearedSearchTextBox.cs
@@ -21,7 +21,6 @@ namespace osu.Game.Graphics.UserInterface
         private const float corner_radius = 7;
 
         private readonly Box background;
-        private readonly Box searchBoxBackground;
         private readonly SearchTextBox textBox;
 
         public Bindable<string> Current
@@ -60,30 +59,12 @@ namespace osu.Game.Graphics.UserInterface
                     {
                         new Drawable[]
                         {
-                            new Container
+                            textBox = new InnerSearchTextBox
                             {
-                                Name = @"Search box container",
+                                Anchor = Anchor.CentreLeft,
+                                Origin = Anchor.CentreLeft,
                                 RelativeSizeAxes = Axes.Both,
-                                CornerRadius = corner_radius,
-                                Masking = true,
-                                Children = new Drawable[]
-                                {
-                                    searchBoxBackground = new Box
-                                    {
-                                        RelativeSizeAxes = Axes.Both
-                                    },
-                                    textBox = new InnerSearchTextBox
-                                    {
-                                        Shear = -Shear,
-                                        Anchor = Anchor.CentreLeft,
-                                        Origin = Anchor.CentreLeft,
-                                        RelativeSizeAxes = Axes.X,
-                                        Padding = new MarginPadding
-                                        {
-                                            Horizontal = corner_radius + Shear.X
-                                        }
-                                    }
-                                }
+                                Size = Vector2.One
                             },
                             new Container
                             {
@@ -119,7 +100,6 @@ namespace osu.Game.Graphics.UserInterface
         private void load(OverlayColourProvider colourProvider)
         {
             background.Colour = colourProvider.Background3;
-            searchBoxBackground.Colour = colourProvider.Background4;
         }
 
         public override bool HandleNonPositionalInput => textBox.HandleNonPositionalInput;
@@ -134,6 +114,9 @@ namespace osu.Game.Graphics.UserInterface
 
                 Placeholder.Font = OsuFont.GetFont(size: CalculatedTextSize, weight: FontWeight.SemiBold);
                 PlaceholderText = CommonStrings.InputSearch;
+
+                CornerRadius = corner_radius;
+                TextContainer.Shear = new Vector2(-ShearedOverlayContainer.SHEAR, 0);
             }
 
             protected override SpriteText CreatePlaceholder() => new SearchPlaceholder();

From 983eed32fc8f328837cb50428b621a0ac1b93385 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 3 May 2022 14:48:00 +0900
Subject: [PATCH 4445/5547] Reduce complexity of icon container nesting

---
 .../UserInterface/ShearedSearchTextBox.cs     | 25 ++++++-------------
 1 file changed, 7 insertions(+), 18 deletions(-)

diff --git a/osu.Game/Graphics/UserInterface/ShearedSearchTextBox.cs b/osu.Game/Graphics/UserInterface/ShearedSearchTextBox.cs
index d16ae2498a..0c34a04a65 100644
--- a/osu.Game/Graphics/UserInterface/ShearedSearchTextBox.cs
+++ b/osu.Game/Graphics/UserInterface/ShearedSearchTextBox.cs
@@ -66,31 +66,20 @@ namespace osu.Game.Graphics.UserInterface
                                 RelativeSizeAxes = Axes.Both,
                                 Size = Vector2.One
                             },
-                            new Container
+                            new SpriteIcon
                             {
-                                Name = @"Icon container",
-                                RelativeSizeAxes = Axes.Y,
-                                Width = 50,
-                                Origin = Anchor.CentreRight,
-                                Anchor = Anchor.CentreRight,
-                                Children = new Drawable[]
-                                {
-                                    new SpriteIcon
-                                    {
-                                        Icon = FontAwesome.Solid.Search,
-                                        Origin = Anchor.Centre,
-                                        Anchor = Anchor.Centre,
-                                        Size = new Vector2(16),
-                                        Shear = -Shear
-                                    }
-                                }
+                                Icon = FontAwesome.Solid.Search,
+                                Origin = Anchor.Centre,
+                                Anchor = Anchor.Centre,
+                                Size = new Vector2(16),
+                                Shear = -Shear
                             }
                         }
                     },
                     ColumnDimensions = new[]
                     {
                         new Dimension(),
-                        new Dimension(GridSizeMode.AutoSize)
+                        new Dimension(GridSizeMode.Absolute, 50),
                     }
                 }
             };

From a555c472127a9d900ac239b91ae82f1802c8f8d7 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 3 May 2022 15:02:57 +0900
Subject: [PATCH 4446/5547] Reduce sorting complexity in worst-case of diffcalc

---
 osu.Game/Rulesets/Difficulty/Skills/StrainSkill.cs | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/osu.Game/Rulesets/Difficulty/Skills/StrainSkill.cs b/osu.Game/Rulesets/Difficulty/Skills/StrainSkill.cs
index bbd2f079aa..d13d4ebf2e 100644
--- a/osu.Game/Rulesets/Difficulty/Skills/StrainSkill.cs
+++ b/osu.Game/Rulesets/Difficulty/Skills/StrainSkill.cs
@@ -65,6 +65,10 @@ namespace osu.Game.Rulesets.Difficulty.Skills
         /// </summary>
         private void saveCurrentPeak()
         {
+            // Ignore sections with 0 strain to avoid edge cases of long maps with a lot of spacing between objects (e.g. /b/2351871).
+            if (currentSectionPeak == 0)
+                return;
+
             strainPeaks.Add(currentSectionPeak);
         }
 

From 547038f13b9840e263ce1bc6c0d57841acf8aeb6 Mon Sep 17 00:00:00 2001
From: Huo Yaoyuan <huoyaoyuan@hotmail.com>
Date: Tue, 3 May 2022 14:28:53 +0800
Subject: [PATCH 4447/5547] Align editorconfig with framework

---
 .editorconfig | 48 +++++++++++++++++++++++++++---------------------
 1 file changed, 27 insertions(+), 21 deletions(-)

diff --git a/.editorconfig b/.editorconfig
index 840fa98334..35ac84fca0 100644
--- a/.editorconfig
+++ b/.editorconfig
@@ -1,6 +1,14 @@
 # EditorConfig is awesome: http://editorconfig.org
 root = true
 
+[*.{csproj,props,targets}]
+charset = utf-8-bom
+end_of_line = crlf
+insert_final_newline = true
+indent_style = space
+indent_size = 2
+trim_trailing_whitespace = true
+
 [*.cs]
 end_of_line = crlf
 insert_final_newline = true
@@ -8,8 +16,19 @@ indent_style = space
 indent_size = 4
 trim_trailing_whitespace = true
 
+#license header
+file_header_template = Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.\nSee the LICENCE file in the repository root for full licence text.
+
 #Roslyn naming styles
 
+#PascalCase for public and protected members
+dotnet_naming_style.pascalcase.capitalization = pascal_case
+dotnet_naming_symbols.public_members.applicable_accessibilities = public,internal,protected,protected_internal,private_protected
+dotnet_naming_symbols.public_members.applicable_kinds = property,method,field,event
+dotnet_naming_rule.public_members_pascalcase.severity = error
+dotnet_naming_rule.public_members_pascalcase.symbols = public_members
+dotnet_naming_rule.public_members_pascalcase.style = pascalcase
+
 #camelCase for private members
 dotnet_naming_style.camelcase.capitalization = camel_case
 
@@ -157,7 +176,7 @@ csharp_style_unused_value_assignment_preference = discard_variable:warning
 
 #Style - variable declaration
 csharp_style_inlined_variable_declaration = true:warning
-csharp_style_deconstructed_variable_declaration = false:silent
+csharp_style_deconstructed_variable_declaration = true:warning
 
 #Style - other C# 7.x features
 dotnet_style_prefer_inferred_tuple_names = true:warning
@@ -168,28 +187,15 @@ dotnet_style_prefer_is_null_check_over_reference_equality_method = true:silent
 #Style - C# 8 features
 csharp_prefer_static_local_function = true:warning
 csharp_prefer_simple_using_statement = true:silent
-csharp_style_prefer_index_operator = false:silent
-csharp_style_prefer_range_operator = false:silent
+csharp_style_prefer_index_operator = true:warning
+csharp_style_prefer_range_operator = true:warning
 csharp_style_prefer_switch_expression = false:none
 
-#Supressing roslyn built-in analyzers
-# Suppress: EC112
-
-#Private method is unused
-dotnet_diagnostic.IDE0051.severity = silent
-#Private member is unused
-dotnet_diagnostic.IDE0052.severity = silent
-
-#Rules for disposable
-dotnet_diagnostic.IDE0067.severity = none
-dotnet_diagnostic.IDE0068.severity = none
-dotnet_diagnostic.IDE0069.severity = none
-
-#Disable operator overloads requiring alternate named methods
-dotnet_diagnostic.CA2225.severity = none
-
-# Banned APIs
-dotnet_diagnostic.RS0030.severity = error
+[*.{yaml,yml}]
+insert_final_newline = true
+indent_style = space
+indent_size = 2
+trim_trailing_whitespace = true
 
 dotnet_diagnostic.OLOC001.words_in_name = 5
 dotnet_diagnostic.OLOC001.license_header = // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.\n// See the LICENCE file in the repository root for full licence text.

From 1202c29ea1aa4318a111e196f583c430700ff951 Mon Sep 17 00:00:00 2001
From: Huo Yaoyuan <huoyaoyuan@hotmail.com>
Date: Tue, 3 May 2022 14:33:14 +0800
Subject: [PATCH 4448/5547] Add license headers to EF migration files

---
 osu.Game/Migrations/20171019041408_InitialCreate.cs          | 5 ++++-
 osu.Game/Migrations/20171025071459_AddMissingIndexRules.cs   | 5 ++++-
 .../20171119065731_AddBeatmapOnlineIDUniqueConstraint.cs     | 5 ++++-
 .../Migrations/20171209034410_AddRulesetInfoShortName.cs     | 5 ++++-
 osu.Game/Migrations/20180125143340_Settings.cs               | 5 ++++-
 osu.Game/Migrations/20180131154205_AddMuteBinding.cs         | 5 ++++-
 osu.Game/Migrations/20180219060912_AddSkins.cs               | 5 ++++-
 .../Migrations/20180529055154_RemoveUniqueHashConstraints.cs | 5 ++++-
 .../Migrations/20180621044111_UpdateTaikoDefaultBindings.cs  | 5 ++++-
 osu.Game/Migrations/20180628011956_RemoveNegativeSetIDs.cs   | 5 ++++-
 osu.Game/Migrations/20180913080842_AddRankStatus.cs          | 5 ++++-
 osu.Game/Migrations/20181007180454_StandardizePaths.cs       | 5 ++++-
 osu.Game/Migrations/20181128100659_AddSkinInfoHash.cs        | 5 ++++-
 osu.Game/Migrations/20181130113755_AddScoreInfoTables.cs     | 5 ++++-
 osu.Game/Migrations/20190225062029_AddUserIDColumn.cs        | 5 ++++-
 osu.Game/Migrations/20190525060824_SkinSettings.cs           | 5 ++++-
 .../20190605091246_AddDateAddedColumnToBeatmapSet.cs         | 5 ++++-
 osu.Game/Migrations/20190708070844_AddBPMAndLengthColumns.cs | 5 ++++-
 osu.Game/Migrations/20190913104727_AddBeatmapVideo.cs        | 5 ++++-
 osu.Game/Migrations/20200302094919_RefreshVolumeBindings.cs  | 5 ++++-
 osu.Game/Migrations/20201019224408_AddEpilepsyWarning.cs     | 5 ++++-
 .../Migrations/20210412045700_RefreshVolumeBindingsAgain.cs  | 5 ++++-
 .../Migrations/20210511060743_AddSkinInstantiationInfo.cs    | 5 ++++-
 .../20210514062639_AddAuthorIdToBeatmapMetadata.cs           | 5 ++++-
 osu.Game/Migrations/20210824185035_AddCountdownSettings.cs   | 5 ++++-
 .../Migrations/20210912144011_AddSamplesMatchPlaybackRate.cs | 5 ++++-
 26 files changed, 104 insertions(+), 26 deletions(-)

diff --git a/osu.Game/Migrations/20171019041408_InitialCreate.cs b/osu.Game/Migrations/20171019041408_InitialCreate.cs
index 9b6881f98c..08ab64fd08 100644
--- a/osu.Game/Migrations/20171019041408_InitialCreate.cs
+++ b/osu.Game/Migrations/20171019041408_InitialCreate.cs
@@ -1,4 +1,7 @@
-using Microsoft.EntityFrameworkCore.Migrations;
+// 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 Microsoft.EntityFrameworkCore.Migrations;
 
 namespace osu.Game.Migrations
 {
diff --git a/osu.Game/Migrations/20171025071459_AddMissingIndexRules.cs b/osu.Game/Migrations/20171025071459_AddMissingIndexRules.cs
index c9fc59c5a2..4ec3952941 100644
--- a/osu.Game/Migrations/20171025071459_AddMissingIndexRules.cs
+++ b/osu.Game/Migrations/20171025071459_AddMissingIndexRules.cs
@@ -1,4 +1,7 @@
-using Microsoft.EntityFrameworkCore.Migrations;
+// 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 Microsoft.EntityFrameworkCore.Migrations;
 
 namespace osu.Game.Migrations
 {
diff --git a/osu.Game/Migrations/20171119065731_AddBeatmapOnlineIDUniqueConstraint.cs b/osu.Game/Migrations/20171119065731_AddBeatmapOnlineIDUniqueConstraint.cs
index 084ae67940..6aba12f86f 100644
--- a/osu.Game/Migrations/20171119065731_AddBeatmapOnlineIDUniqueConstraint.cs
+++ b/osu.Game/Migrations/20171119065731_AddBeatmapOnlineIDUniqueConstraint.cs
@@ -1,4 +1,7 @@
-using Microsoft.EntityFrameworkCore.Migrations;
+// 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 Microsoft.EntityFrameworkCore.Migrations;
 
 namespace osu.Game.Migrations
 {
diff --git a/osu.Game/Migrations/20171209034410_AddRulesetInfoShortName.cs b/osu.Game/Migrations/20171209034410_AddRulesetInfoShortName.cs
index 09cf0af89c..5688455f79 100644
--- a/osu.Game/Migrations/20171209034410_AddRulesetInfoShortName.cs
+++ b/osu.Game/Migrations/20171209034410_AddRulesetInfoShortName.cs
@@ -1,4 +1,7 @@
-using Microsoft.EntityFrameworkCore.Migrations;
+// 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 Microsoft.EntityFrameworkCore.Migrations;
 
 namespace osu.Game.Migrations
 {
diff --git a/osu.Game/Migrations/20180125143340_Settings.cs b/osu.Game/Migrations/20180125143340_Settings.cs
index 166d3c086d..1feb37531f 100644
--- a/osu.Game/Migrations/20180125143340_Settings.cs
+++ b/osu.Game/Migrations/20180125143340_Settings.cs
@@ -1,4 +1,7 @@
-using Microsoft.EntityFrameworkCore.Migrations;
+// 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 Microsoft.EntityFrameworkCore.Migrations;
 
 namespace osu.Game.Migrations
 {
diff --git a/osu.Game/Migrations/20180131154205_AddMuteBinding.cs b/osu.Game/Migrations/20180131154205_AddMuteBinding.cs
index 5564a30bbf..8646d1d76b 100644
--- a/osu.Game/Migrations/20180131154205_AddMuteBinding.cs
+++ b/osu.Game/Migrations/20180131154205_AddMuteBinding.cs
@@ -1,4 +1,7 @@
-using Microsoft.EntityFrameworkCore.Migrations;
+// 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 Microsoft.EntityFrameworkCore.Migrations;
 using Microsoft.EntityFrameworkCore.Infrastructure;
 using osu.Game.Database;
 using osu.Game.Input.Bindings;
diff --git a/osu.Game/Migrations/20180219060912_AddSkins.cs b/osu.Game/Migrations/20180219060912_AddSkins.cs
index a0270ab0fd..319748bed6 100644
--- a/osu.Game/Migrations/20180219060912_AddSkins.cs
+++ b/osu.Game/Migrations/20180219060912_AddSkins.cs
@@ -1,4 +1,7 @@
-using Microsoft.EntityFrameworkCore.Migrations;
+// 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 Microsoft.EntityFrameworkCore.Migrations;
 
 namespace osu.Game.Migrations
 {
diff --git a/osu.Game/Migrations/20180529055154_RemoveUniqueHashConstraints.cs b/osu.Game/Migrations/20180529055154_RemoveUniqueHashConstraints.cs
index 27269cc5fc..91eabe8868 100644
--- a/osu.Game/Migrations/20180529055154_RemoveUniqueHashConstraints.cs
+++ b/osu.Game/Migrations/20180529055154_RemoveUniqueHashConstraints.cs
@@ -1,4 +1,7 @@
-using Microsoft.EntityFrameworkCore.Migrations;
+// 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 Microsoft.EntityFrameworkCore.Migrations;
 
 namespace osu.Game.Migrations
 {
diff --git a/osu.Game/Migrations/20180621044111_UpdateTaikoDefaultBindings.cs b/osu.Game/Migrations/20180621044111_UpdateTaikoDefaultBindings.cs
index 71304ea979..d888ccd5a2 100644
--- a/osu.Game/Migrations/20180621044111_UpdateTaikoDefaultBindings.cs
+++ b/osu.Game/Migrations/20180621044111_UpdateTaikoDefaultBindings.cs
@@ -1,4 +1,7 @@
-using Microsoft.EntityFrameworkCore.Migrations;
+// 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 Microsoft.EntityFrameworkCore.Migrations;
 
 namespace osu.Game.Migrations
 {
diff --git a/osu.Game/Migrations/20180628011956_RemoveNegativeSetIDs.cs b/osu.Game/Migrations/20180628011956_RemoveNegativeSetIDs.cs
index 506d65f761..fdea636ac6 100644
--- a/osu.Game/Migrations/20180628011956_RemoveNegativeSetIDs.cs
+++ b/osu.Game/Migrations/20180628011956_RemoveNegativeSetIDs.cs
@@ -1,4 +1,7 @@
-using Microsoft.EntityFrameworkCore.Migrations;
+// 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 Microsoft.EntityFrameworkCore.Migrations;
 
 namespace osu.Game.Migrations
 {
diff --git a/osu.Game/Migrations/20180913080842_AddRankStatus.cs b/osu.Game/Migrations/20180913080842_AddRankStatus.cs
index bba4944bb7..bb147dff84 100644
--- a/osu.Game/Migrations/20180913080842_AddRankStatus.cs
+++ b/osu.Game/Migrations/20180913080842_AddRankStatus.cs
@@ -1,4 +1,7 @@
-using Microsoft.EntityFrameworkCore.Migrations;
+// 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 Microsoft.EntityFrameworkCore.Migrations;
 
 namespace osu.Game.Migrations
 {
diff --git a/osu.Game/Migrations/20181007180454_StandardizePaths.cs b/osu.Game/Migrations/20181007180454_StandardizePaths.cs
index 11a020eb9c..30f27043a0 100644
--- a/osu.Game/Migrations/20181007180454_StandardizePaths.cs
+++ b/osu.Game/Migrations/20181007180454_StandardizePaths.cs
@@ -1,4 +1,7 @@
-using Microsoft.EntityFrameworkCore.Migrations;
+// 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 Microsoft.EntityFrameworkCore.Migrations;
 
 namespace osu.Game.Migrations
 {
diff --git a/osu.Game/Migrations/20181128100659_AddSkinInfoHash.cs b/osu.Game/Migrations/20181128100659_AddSkinInfoHash.cs
index 860264a7dd..ee825a1e9c 100644
--- a/osu.Game/Migrations/20181128100659_AddSkinInfoHash.cs
+++ b/osu.Game/Migrations/20181128100659_AddSkinInfoHash.cs
@@ -1,4 +1,7 @@
-using Microsoft.EntityFrameworkCore.Migrations;
+// 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 Microsoft.EntityFrameworkCore.Migrations;
 
 namespace osu.Game.Migrations
 {
diff --git a/osu.Game/Migrations/20181130113755_AddScoreInfoTables.cs b/osu.Game/Migrations/20181130113755_AddScoreInfoTables.cs
index 2b6f94c5a4..58980132f3 100644
--- a/osu.Game/Migrations/20181130113755_AddScoreInfoTables.cs
+++ b/osu.Game/Migrations/20181130113755_AddScoreInfoTables.cs
@@ -1,4 +1,7 @@
-using System;
+// 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 Microsoft.EntityFrameworkCore.Migrations;
 
 namespace osu.Game.Migrations
diff --git a/osu.Game/Migrations/20190225062029_AddUserIDColumn.cs b/osu.Game/Migrations/20190225062029_AddUserIDColumn.cs
index 0720e0eac7..f2eef600dc 100644
--- a/osu.Game/Migrations/20190225062029_AddUserIDColumn.cs
+++ b/osu.Game/Migrations/20190225062029_AddUserIDColumn.cs
@@ -1,4 +1,7 @@
-using Microsoft.EntityFrameworkCore.Migrations;
+// 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 Microsoft.EntityFrameworkCore.Migrations;
 
 namespace osu.Game.Migrations
 {
diff --git a/osu.Game/Migrations/20190525060824_SkinSettings.cs b/osu.Game/Migrations/20190525060824_SkinSettings.cs
index 99237419b7..7779b55bb7 100644
--- a/osu.Game/Migrations/20190525060824_SkinSettings.cs
+++ b/osu.Game/Migrations/20190525060824_SkinSettings.cs
@@ -1,4 +1,7 @@
-using Microsoft.EntityFrameworkCore.Migrations;
+// 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 Microsoft.EntityFrameworkCore.Migrations;
 
 namespace osu.Game.Migrations
 {
diff --git a/osu.Game/Migrations/20190605091246_AddDateAddedColumnToBeatmapSet.cs b/osu.Game/Migrations/20190605091246_AddDateAddedColumnToBeatmapSet.cs
index 55dc18b6a3..0620a0624f 100644
--- a/osu.Game/Migrations/20190605091246_AddDateAddedColumnToBeatmapSet.cs
+++ b/osu.Game/Migrations/20190605091246_AddDateAddedColumnToBeatmapSet.cs
@@ -1,4 +1,7 @@
-using System;
+// 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 Microsoft.EntityFrameworkCore.Migrations;
 
 namespace osu.Game.Migrations
diff --git a/osu.Game/Migrations/20190708070844_AddBPMAndLengthColumns.cs b/osu.Game/Migrations/20190708070844_AddBPMAndLengthColumns.cs
index f5963ebf5e..f8ce354aa1 100644
--- a/osu.Game/Migrations/20190708070844_AddBPMAndLengthColumns.cs
+++ b/osu.Game/Migrations/20190708070844_AddBPMAndLengthColumns.cs
@@ -1,4 +1,7 @@
-using Microsoft.EntityFrameworkCore.Migrations;
+// 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 Microsoft.EntityFrameworkCore.Migrations;
 
 namespace osu.Game.Migrations
 {
diff --git a/osu.Game/Migrations/20190913104727_AddBeatmapVideo.cs b/osu.Game/Migrations/20190913104727_AddBeatmapVideo.cs
index 9ed0943acd..af82b4db20 100644
--- a/osu.Game/Migrations/20190913104727_AddBeatmapVideo.cs
+++ b/osu.Game/Migrations/20190913104727_AddBeatmapVideo.cs
@@ -1,4 +1,7 @@
-using Microsoft.EntityFrameworkCore.Migrations;
+// 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 Microsoft.EntityFrameworkCore.Migrations;
 
 namespace osu.Game.Migrations
 {
diff --git a/osu.Game/Migrations/20200302094919_RefreshVolumeBindings.cs b/osu.Game/Migrations/20200302094919_RefreshVolumeBindings.cs
index ec4475971c..3d2ddbf6fc 100644
--- a/osu.Game/Migrations/20200302094919_RefreshVolumeBindings.cs
+++ b/osu.Game/Migrations/20200302094919_RefreshVolumeBindings.cs
@@ -1,4 +1,7 @@
-using Microsoft.EntityFrameworkCore.Migrations;
+// 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 Microsoft.EntityFrameworkCore.Migrations;
 
 namespace osu.Game.Migrations
 {
diff --git a/osu.Game/Migrations/20201019224408_AddEpilepsyWarning.cs b/osu.Game/Migrations/20201019224408_AddEpilepsyWarning.cs
index be6968aa5d..58a35a7bf3 100644
--- a/osu.Game/Migrations/20201019224408_AddEpilepsyWarning.cs
+++ b/osu.Game/Migrations/20201019224408_AddEpilepsyWarning.cs
@@ -1,4 +1,7 @@
-using Microsoft.EntityFrameworkCore.Migrations;
+// 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 Microsoft.EntityFrameworkCore.Migrations;
 
 namespace osu.Game.Migrations
 {
diff --git a/osu.Game/Migrations/20210412045700_RefreshVolumeBindingsAgain.cs b/osu.Game/Migrations/20210412045700_RefreshVolumeBindingsAgain.cs
index 155d6670a8..4d3941dd20 100644
--- a/osu.Game/Migrations/20210412045700_RefreshVolumeBindingsAgain.cs
+++ b/osu.Game/Migrations/20210412045700_RefreshVolumeBindingsAgain.cs
@@ -1,4 +1,7 @@
-using Microsoft.EntityFrameworkCore.Migrations;
+// 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 Microsoft.EntityFrameworkCore.Migrations;
 
 namespace osu.Game.Migrations
 {
diff --git a/osu.Game/Migrations/20210511060743_AddSkinInstantiationInfo.cs b/osu.Game/Migrations/20210511060743_AddSkinInstantiationInfo.cs
index 1d5b0769a4..887635fa85 100644
--- a/osu.Game/Migrations/20210511060743_AddSkinInstantiationInfo.cs
+++ b/osu.Game/Migrations/20210511060743_AddSkinInstantiationInfo.cs
@@ -1,4 +1,7 @@
-using Microsoft.EntityFrameworkCore.Migrations;
+// 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 Microsoft.EntityFrameworkCore.Migrations;
 
 namespace osu.Game.Migrations
 {
diff --git a/osu.Game/Migrations/20210514062639_AddAuthorIdToBeatmapMetadata.cs b/osu.Game/Migrations/20210514062639_AddAuthorIdToBeatmapMetadata.cs
index 98fe9b5e13..7b579e27b9 100644
--- a/osu.Game/Migrations/20210514062639_AddAuthorIdToBeatmapMetadata.cs
+++ b/osu.Game/Migrations/20210514062639_AddAuthorIdToBeatmapMetadata.cs
@@ -1,4 +1,7 @@
-using Microsoft.EntityFrameworkCore.Migrations;
+// 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 Microsoft.EntityFrameworkCore.Migrations;
 
 namespace osu.Game.Migrations
 {
diff --git a/osu.Game/Migrations/20210824185035_AddCountdownSettings.cs b/osu.Game/Migrations/20210824185035_AddCountdownSettings.cs
index 564f5f4520..d1b09e2c1d 100644
--- a/osu.Game/Migrations/20210824185035_AddCountdownSettings.cs
+++ b/osu.Game/Migrations/20210824185035_AddCountdownSettings.cs
@@ -1,4 +1,7 @@
-using Microsoft.EntityFrameworkCore.Migrations;
+// 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 Microsoft.EntityFrameworkCore.Migrations;
 
 namespace osu.Game.Migrations
 {
diff --git a/osu.Game/Migrations/20210912144011_AddSamplesMatchPlaybackRate.cs b/osu.Game/Migrations/20210912144011_AddSamplesMatchPlaybackRate.cs
index bf3f855d5f..f6fc1f4420 100644
--- a/osu.Game/Migrations/20210912144011_AddSamplesMatchPlaybackRate.cs
+++ b/osu.Game/Migrations/20210912144011_AddSamplesMatchPlaybackRate.cs
@@ -1,4 +1,7 @@
-using Microsoft.EntityFrameworkCore.Migrations;
+// 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 Microsoft.EntityFrameworkCore.Migrations;
 
 namespace osu.Game.Migrations
 {

From 2a388ba3eaba2df84a1f5b5a6c7e3d22149f1a7e Mon Sep 17 00:00:00 2001
From: Huo Yaoyuan <huoyaoyuan@hotmail.com>
Date: Tue, 3 May 2022 14:34:54 +0800
Subject: [PATCH 4449/5547] Turn IDE0052 to silent according to the occurrences

---
 .globalconfig | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.globalconfig b/.globalconfig
index 607798492c..462dbc74ed 100644
--- a/.globalconfig
+++ b/.globalconfig
@@ -37,7 +37,7 @@ dotnet_diagnostic.IDE0055.severity = warning
 dotnet_diagnostic.IDE0051.severity = silent
 
 # IDE0052: Private member is unused
-dotnet_diagnostic.IDE0052.severity = warning
+dotnet_diagnostic.IDE0052.severity = silent
 
 # IDE0073: File header
 dotnet_diagnostic.IDE0073.severity = warning

From 2896612c5cd09cc4c6436f2f307d60218b13b8f9 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 3 May 2022 16:06:04 +0900
Subject: [PATCH 4450/5547] Make exiting multiplayer a dangerous operation,
 requiring hold

---
 .../Containers/HoldToConfirmContainer.cs      |  8 ++++--
 .../Dialog/PopupDialogDangerousButton.cs      |  4 ++-
 .../Screens/Play/HUD/HoldForMenuButton.cs     | 27 ++++++++++++++-----
 3 files changed, 30 insertions(+), 9 deletions(-)

diff --git a/osu.Game/Graphics/Containers/HoldToConfirmContainer.cs b/osu.Game/Graphics/Containers/HoldToConfirmContainer.cs
index 1b802a0a14..c74245461d 100644
--- a/osu.Game/Graphics/Containers/HoldToConfirmContainer.cs
+++ b/osu.Game/Graphics/Containers/HoldToConfirmContainer.cs
@@ -40,9 +40,13 @@ namespace osu.Game.Graphics.Containers
 
         private Bindable<double> holdActivationDelay;
 
-        [BackgroundDependencyLoader]
-        private void load(OsuConfigManager config)
+        [Resolved]
+        private OsuConfigManager config { get; set; }
+
+        protected override void LoadComplete()
         {
+            base.LoadComplete();
+
             holdActivationDelay = HoldActivationDelay != null
                 ? new Bindable<double>(HoldActivationDelay.Value)
                 : config.GetBindable<double>(OsuSetting.UIHoldActivationDelay);
diff --git a/osu.Game/Overlays/Dialog/PopupDialogDangerousButton.cs b/osu.Game/Overlays/Dialog/PopupDialogDangerousButton.cs
index adc627e15b..6c775f44f8 100644
--- a/osu.Game/Overlays/Dialog/PopupDialogDangerousButton.cs
+++ b/osu.Game/Overlays/Dialog/PopupDialogDangerousButton.cs
@@ -12,6 +12,8 @@ namespace osu.Game.Overlays.Dialog
 {
     public class PopupDialogDangerousButton : PopupDialogButton
     {
+        public const double DANGEROUS_HOLD_ACTIVATION_DELAY = 500;
+
         private Box progressBox;
         private DangerousConfirmContainer confirmContainer;
 
@@ -42,7 +44,7 @@ namespace osu.Game.Overlays.Dialog
 
         private class DangerousConfirmContainer : HoldToConfirmContainer
         {
-            protected override double? HoldActivationDelay => 500;
+            protected override double? HoldActivationDelay => DANGEROUS_HOLD_ACTIVATION_DELAY;
 
             protected override bool OnMouseDown(MouseDownEvent e)
             {
diff --git a/osu.Game/Screens/Play/HUD/HoldForMenuButton.cs b/osu.Game/Screens/Play/HUD/HoldForMenuButton.cs
index 3da63ec2cc..c6aa3fbe08 100644
--- a/osu.Game/Screens/Play/HUD/HoldForMenuButton.cs
+++ b/osu.Game/Screens/Play/HUD/HoldForMenuButton.cs
@@ -18,6 +18,7 @@ using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Input.Bindings;
+using osu.Game.Overlays.Dialog;
 using osuTK;
 
 namespace osu.Game.Screens.Play.HUD
@@ -37,6 +38,14 @@ namespace osu.Game.Screens.Play.HUD
 
         private readonly OsuSpriteText text;
 
+        [Resolved]
+        private OsuConfigManager config { get; set; }
+
+        [Resolved(canBeNull: true)]
+        private Player player { get; set; }
+
+        private readonly Bindable<double> activationDelay = new Bindable<double>();
+
         public HoldForMenuButton()
         {
             Direction = FillDirection.Horizontal;
@@ -60,14 +69,15 @@ namespace osu.Game.Screens.Play.HUD
             AutoSizeAxes = Axes.Both;
         }
 
-        [Resolved]
-        private OsuConfigManager config { get; set; }
-
-        private Bindable<double> activationDelay;
-
         protected override void LoadComplete()
         {
-            activationDelay = config.GetBindable<double>(OsuSetting.UIHoldActivationDelay);
+            if (player?.Configuration.AllowRestart == false)
+            {
+                activationDelay.Value = PopupDialogDangerousButton.DANGEROUS_HOLD_ACTIVATION_DELAY;
+            }
+            else
+                config.BindWith(OsuSetting.UIHoldActivationDelay, activationDelay);
+
             activationDelay.BindValueChanged(v =>
             {
                 text.Text = v.NewValue > 0
@@ -115,6 +125,11 @@ namespace osu.Game.Screens.Play.HUD
             public Action HoverGained;
             public Action HoverLost;
 
+            [Resolved(canBeNull: true)]
+            private Player player { get; set; }
+
+            protected override double? HoldActivationDelay => player?.Configuration.AllowRestart == false ? PopupDialogDangerousButton.DANGEROUS_HOLD_ACTIVATION_DELAY : (double?)null;
+
             [BackgroundDependencyLoader]
             private void load(OsuColour colours)
             {

From 637f81769609d8d56223d2d70263b57d6617444a Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 3 May 2022 16:06:20 +0900
Subject: [PATCH 4451/5547] Ignore zero-sections on a per-case basis

---
 .../Difficulty/Skills/OsuStrainSkill.cs                |  6 +++++-
 .../Difficulty/TaikoDifficultyCalculator.cs            |  8 +++++++-
 osu.Game/Rulesets/Difficulty/Skills/StrainSkill.cs     | 10 +++++-----
 3 files changed, 17 insertions(+), 7 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/OsuStrainSkill.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/OsuStrainSkill.cs
index e47edc37cc..dcd2c7d321 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/OsuStrainSkill.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/OsuStrainSkill.cs
@@ -38,7 +38,11 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
             double difficulty = 0;
             double weight = 1;
 
-            List<double> strains = GetCurrentStrainPeaks().OrderByDescending(d => d).ToList();
+            // Sections with 0 strain are excluded to avoid worst-case time complexity of the following sort (e.g. /b/2351871).
+            // These sections will not contribute to the difficulty.
+            var peaks = GetCurrentStrainPeaks().Where(p => p > 0);
+
+            List<double> strains = peaks.OrderByDescending(d => d).ToList();
 
             // We are reducing the highest strains first to account for extreme difficulty spikes
             for (int i = 0; i < Math.Min(strains.Count, ReducedSectionCount); i++)
diff --git a/osu.Game.Rulesets.Taiko/Difficulty/TaikoDifficultyCalculator.cs b/osu.Game.Rulesets.Taiko/Difficulty/TaikoDifficultyCalculator.cs
index 6afdef3f3c..a9d512f076 100644
--- a/osu.Game.Rulesets.Taiko/Difficulty/TaikoDifficultyCalculator.cs
+++ b/osu.Game.Rulesets.Taiko/Difficulty/TaikoDifficultyCalculator.cs
@@ -141,7 +141,13 @@ namespace osu.Game.Rulesets.Taiko.Difficulty
                 double colourPeak = colourPeaks[i] * colour_skill_multiplier;
                 double rhythmPeak = rhythmPeaks[i] * rhythm_skill_multiplier;
                 double staminaPeak = (staminaRightPeaks[i] + staminaLeftPeaks[i]) * stamina_skill_multiplier * staminaPenalty;
-                peaks.Add(norm(2, colourPeak, rhythmPeak, staminaPeak));
+
+                double peak = norm(2, colourPeak, rhythmPeak, staminaPeak);
+
+                // Sections with 0 strain are excluded to avoid worst-case time complexity of the following sort (e.g. /b/2351871).
+                // These sections will not contribute to the difficulty.
+                if (peak > 0)
+                    peaks.Add(peak);
             }
 
             double difficulty = 0;
diff --git a/osu.Game/Rulesets/Difficulty/Skills/StrainSkill.cs b/osu.Game/Rulesets/Difficulty/Skills/StrainSkill.cs
index d13d4ebf2e..97266562e4 100644
--- a/osu.Game/Rulesets/Difficulty/Skills/StrainSkill.cs
+++ b/osu.Game/Rulesets/Difficulty/Skills/StrainSkill.cs
@@ -65,10 +65,6 @@ namespace osu.Game.Rulesets.Difficulty.Skills
         /// </summary>
         private void saveCurrentPeak()
         {
-            // Ignore sections with 0 strain to avoid edge cases of long maps with a lot of spacing between objects (e.g. /b/2351871).
-            if (currentSectionPeak == 0)
-                return;
-
             strainPeaks.Add(currentSectionPeak);
         }
 
@@ -104,9 +100,13 @@ namespace osu.Game.Rulesets.Difficulty.Skills
             double difficulty = 0;
             double weight = 1;
 
+            // Sections with 0 strain are excluded to avoid worst-case time complexity of the following sort (e.g. /b/2351871).
+            // These sections will not contribute to the difficulty.
+            var peaks = GetCurrentStrainPeaks().Where(p => p > 0);
+
             // Difficulty is the weighted sum of the highest strains from every section.
             // We're sorting from highest to lowest strain.
-            foreach (double strain in GetCurrentStrainPeaks().OrderByDescending(d => d))
+            foreach (double strain in peaks.OrderByDescending(d => d))
             {
                 difficulty += strain * weight;
                 weight *= DecayWeight;

From 521ec1a225f72931941c1ab23714954aa646ec93 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Tue, 3 May 2022 04:44:55 +0300
Subject: [PATCH 4452/5547] Add keybind for distance grid spacing activation

---
 osu.Game/Input/Bindings/GlobalActionContainer.cs   |  4 ++++
 .../Localisation/GlobalActionKeyBindingStrings.cs  |  5 +++++
 .../Rulesets/Edit/DistancedHitObjectComposer.cs    | 14 ++++++++------
 3 files changed, 17 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Input/Bindings/GlobalActionContainer.cs b/osu.Game/Input/Bindings/GlobalActionContainer.cs
index 47cb7be2cf..5656c79975 100644
--- a/osu.Game/Input/Bindings/GlobalActionContainer.cs
+++ b/osu.Game/Input/Bindings/GlobalActionContainer.cs
@@ -79,6 +79,7 @@ namespace osu.Game.Input.Bindings
             new KeyBinding(new[] { InputKey.F5 }, GlobalAction.EditorTestGameplay),
             new KeyBinding(new[] { InputKey.Control, InputKey.H }, GlobalAction.EditorFlipHorizontally),
             new KeyBinding(new[] { InputKey.Control, InputKey.J }, GlobalAction.EditorFlipVertically),
+            new KeyBinding(new[] { InputKey.Control, InputKey.Alt }, GlobalAction.EditorDistanceSpacing),
         };
 
         public IEnumerable<KeyBinding> InGameKeyBindings => new[]
@@ -301,5 +302,8 @@ namespace osu.Game.Input.Bindings
 
         [LocalisableDescription(typeof(GlobalActionKeyBindingStrings), nameof(GlobalActionKeyBindingStrings.EditorFlipVertically))]
         EditorFlipVertically,
+
+        [LocalisableDescription(typeof(GlobalActionKeyBindingStrings), nameof(GlobalActionKeyBindingStrings.EditorDistanceSpacing))]
+        EditorDistanceSpacing,
     }
 }
diff --git a/osu.Game/Localisation/GlobalActionKeyBindingStrings.cs b/osu.Game/Localisation/GlobalActionKeyBindingStrings.cs
index 777e97d1e3..73cc7546ab 100644
--- a/osu.Game/Localisation/GlobalActionKeyBindingStrings.cs
+++ b/osu.Game/Localisation/GlobalActionKeyBindingStrings.cs
@@ -239,6 +239,11 @@ namespace osu.Game.Localisation
         /// </summary>
         public static LocalisableString EditorFlipVertically => new TranslatableString(getKey(@"editor_flip_vertically"), @"Flip selection vertically");
 
+        /// <summary>
+        /// "Distance grid spacing (hold)"
+        /// </summary>
+        public static LocalisableString EditorDistanceSpacing => new TranslatableString(getKey(@"editor_distance_spacing"), @"Distance grid spacing (hold)");
+
         /// <summary>
         /// "Toggle skin editor"
         /// </summary>
diff --git a/osu.Game/Rulesets/Edit/DistancedHitObjectComposer.cs b/osu.Game/Rulesets/Edit/DistancedHitObjectComposer.cs
index 0505f9ab0e..1a4ea845d0 100644
--- a/osu.Game/Rulesets/Edit/DistancedHitObjectComposer.cs
+++ b/osu.Game/Rulesets/Edit/DistancedHitObjectComposer.cs
@@ -4,9 +4,11 @@
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
+using osu.Framework.Input.Bindings;
 using osu.Framework.Input.Events;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.UserInterface;
+using osu.Game.Input.Bindings;
 using osu.Game.Overlays.Settings.Sections;
 using osu.Game.Rulesets.Objects;
 using osuTK;
@@ -18,7 +20,7 @@ namespace osu.Game.Rulesets.Edit
     /// </summary>
     /// <typeparam name="TObject">The base type of supported objects.</typeparam>
     [Cached(typeof(IDistanceSnapProvider))]
-    public abstract class DistancedHitObjectComposer<TObject> : HitObjectComposer<TObject>, IDistanceSnapProvider
+    public abstract class DistancedHitObjectComposer<TObject> : HitObjectComposer<TObject>, IDistanceSnapProvider, IKeyBindingHandler<GlobalAction>
         where TObject : HitObject
     {
         protected Bindable<double> DistanceSpacingMultiplier { get; } = new BindableDouble(1.0)
@@ -75,21 +77,21 @@ namespace osu.Game.Rulesets.Edit
             }
         }
 
-        protected override bool OnKeyDown(KeyDownEvent e)
+        public bool OnPressed(KeyBindingPressEvent<GlobalAction> e)
         {
-            if (!DistanceSpacingMultiplier.Disabled && e.ControlPressed && e.AltPressed && !e.Repeat)
+            if (!DistanceSpacingMultiplier.Disabled && e.Action == GlobalAction.EditorDistanceSpacing)
             {
                 RightSideToolboxContainer.Expanded.Value = true;
                 distanceSpacingScrollActive = true;
                 return true;
             }
 
-            return base.OnKeyDown(e);
+            return false;
         }
 
-        protected override void OnKeyUp(KeyUpEvent e)
+        public void OnReleased(KeyBindingReleaseEvent<GlobalAction> e)
         {
-            if (!DistanceSpacingMultiplier.Disabled && distanceSpacingScrollActive && (!e.AltPressed || !e.ControlPressed))
+            if (!DistanceSpacingMultiplier.Disabled && e.Action == GlobalAction.EditorDistanceSpacing)
             {
                 RightSideToolboxContainer.Expanded.Value = false;
                 distanceSpacingScrollActive = false;

From b8287f3687e06c88b6a565994cf23233f285d2e2 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Tue, 3 May 2022 10:30:32 +0300
Subject: [PATCH 4453/5547] Display toast notification on editor distance
 spacing change

---
 .../Edit/DistancedHitObjectComposer.cs        | 23 +++++++++++++++----
 1 file changed, 19 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Rulesets/Edit/DistancedHitObjectComposer.cs b/osu.Game/Rulesets/Edit/DistancedHitObjectComposer.cs
index 1a4ea845d0..a19944712e 100644
--- a/osu.Game/Rulesets/Edit/DistancedHitObjectComposer.cs
+++ b/osu.Game/Rulesets/Edit/DistancedHitObjectComposer.cs
@@ -3,12 +3,16 @@
 
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
+using osu.Framework.Extensions.LocalisationExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Input.Bindings;
 using osu.Framework.Input.Events;
+using osu.Framework.Localisation;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Input.Bindings;
+using osu.Game.Overlays;
+using osu.Game.Overlays.OSD;
 using osu.Game.Overlays.Settings.Sections;
 using osu.Game.Rulesets.Objects;
 using osuTK;
@@ -37,6 +41,9 @@ namespace osu.Game.Rulesets.Edit
         private ExpandableSlider<double, SizeSlider<double>> distanceSpacingSlider;
         private bool distanceSpacingScrollActive;
 
+        [Resolved]
+        private OnScreenDisplay onScreenDisplay { get; set; }
+
         protected DistancedHitObjectComposer(Ruleset ruleset)
             : base(ruleset)
         {
@@ -72,6 +79,10 @@ namespace osu.Game.Rulesets.Edit
                 {
                     distanceSpacingSlider.ContractedLabelText = $"D. S. ({v.NewValue:0.##x})";
                     distanceSpacingSlider.ExpandedLabelText = $"Distance Spacing ({v.NewValue:0.##x})";
+
+                    if (v.NewValue != v.OldValue)
+                        onScreenDisplay.Display(new DistanceSpacingToast(v.NewValue.ToLocalisableString(@"0.##x")));
+
                     EditorBeatmap.BeatmapInfo.DistanceSpacing = v.NewValue;
                 }, true);
             }
@@ -81,7 +92,6 @@ namespace osu.Game.Rulesets.Edit
         {
             if (!DistanceSpacingMultiplier.Disabled && e.Action == GlobalAction.EditorDistanceSpacing)
             {
-                RightSideToolboxContainer.Expanded.Value = true;
                 distanceSpacingScrollActive = true;
                 return true;
             }
@@ -92,10 +102,7 @@ namespace osu.Game.Rulesets.Edit
         public void OnReleased(KeyBindingReleaseEvent<GlobalAction> e)
         {
             if (!DistanceSpacingMultiplier.Disabled && e.Action == GlobalAction.EditorDistanceSpacing)
-            {
-                RightSideToolboxContainer.Expanded.Value = false;
                 distanceSpacingScrollActive = false;
-            }
         }
 
         protected override bool OnScroll(ScrollEvent e)
@@ -160,5 +167,13 @@ namespace osu.Game.Rulesets.Edit
                 FillFlow.Spacing = new Vector2(10);
             }
         }
+
+        private class DistanceSpacingToast : Toast
+        {
+            public DistanceSpacingToast(LocalisableString value)
+                : base("Distance Spacing", value, string.Empty)
+            {
+            }
+        }
     }
 }

From 0dd2e1652c2a040e6bd831c2cbdab12d22f33210 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Tue, 3 May 2022 11:15:28 +0300
Subject: [PATCH 4454/5547] Mark `OnScreenDisplay` dependency as nullable

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

diff --git a/osu.Game/Rulesets/Edit/DistancedHitObjectComposer.cs b/osu.Game/Rulesets/Edit/DistancedHitObjectComposer.cs
index a19944712e..75b87fb6e8 100644
--- a/osu.Game/Rulesets/Edit/DistancedHitObjectComposer.cs
+++ b/osu.Game/Rulesets/Edit/DistancedHitObjectComposer.cs
@@ -41,7 +41,7 @@ namespace osu.Game.Rulesets.Edit
         private ExpandableSlider<double, SizeSlider<double>> distanceSpacingSlider;
         private bool distanceSpacingScrollActive;
 
-        [Resolved]
+        [Resolved(canBeNull: true)]
         private OnScreenDisplay onScreenDisplay { get; set; }
 
         protected DistancedHitObjectComposer(Ruleset ruleset)
@@ -81,7 +81,7 @@ namespace osu.Game.Rulesets.Edit
                     distanceSpacingSlider.ExpandedLabelText = $"Distance Spacing ({v.NewValue:0.##x})";
 
                     if (v.NewValue != v.OldValue)
-                        onScreenDisplay.Display(new DistanceSpacingToast(v.NewValue.ToLocalisableString(@"0.##x")));
+                        onScreenDisplay?.Display(new DistanceSpacingToast(v.NewValue.ToLocalisableString(@"0.##x")));
 
                     EditorBeatmap.BeatmapInfo.DistanceSpacing = v.NewValue;
                 }, true);

From 89d8ed8e20b2850cb96af75fd0d5b69adf575c61 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 17 Apr 2022 20:26:16 +0200
Subject: [PATCH 4455/5547] Port existing test coverage

---
 .../UserInterface/TestSceneModSelectScreen.cs | 225 ++++++++++++++++++
 1 file changed, 225 insertions(+)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs
index ec6e962c6a..bd63023efb 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs
@@ -2,17 +2,21 @@
 // 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.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Testing;
 using osu.Framework.Utils;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Overlays.Mods;
+using osu.Game.Overlays.Settings;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Mods;
+using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Osu.Mods;
 using osuTK.Input;
 
@@ -169,6 +173,206 @@ namespace osu.Game.Tests.Visual.UserInterface
             assertCustomisationToggleState(disabled: true, active: false); // config was dismissed without explicit user action.
         }
 
+        /// <summary>
+        /// Ensure that two mod overlays are not cross polluting via central settings instances.
+        /// </summary>
+        [Test]
+        public void TestSettingsNotCrossPolluting()
+        {
+            Bindable<IReadOnlyList<Mod>> selectedMods2 = null;
+            ModSelectScreen modSelectScreen2 = null;
+
+            createScreen();
+            AddStep("select diff adjust", () => SelectedMods.Value = new Mod[] { new OsuModDifficultyAdjust() });
+
+            AddStep("set setting", () => modSelectScreen.ChildrenOfType<SettingsSlider<float>>().First().Current.Value = 8);
+
+            AddAssert("ensure setting is propagated", () => SelectedMods.Value.OfType<OsuModDifficultyAdjust>().Single().CircleSize.Value == 8);
+
+            AddStep("create second bindable", () => selectedMods2 = new Bindable<IReadOnlyList<Mod>>(new Mod[] { new OsuModDifficultyAdjust() }));
+
+            AddStep("create second overlay", () =>
+            {
+                Add(modSelectScreen2 = new UserModSelectScreen().With(d =>
+                {
+                    d.Origin = Anchor.TopCentre;
+                    d.Anchor = Anchor.TopCentre;
+                    d.SelectedMods.BindTarget = selectedMods2;
+                }));
+            });
+
+            AddStep("show", () => modSelectScreen2.Show());
+
+            AddAssert("ensure first is unchanged", () => SelectedMods.Value.OfType<OsuModDifficultyAdjust>().Single().CircleSize.Value == 8);
+            AddAssert("ensure second is default", () => selectedMods2.Value.OfType<OsuModDifficultyAdjust>().Single().CircleSize.Value == null);
+        }
+
+        [Test]
+        public void TestSettingsResetOnDeselection()
+        {
+            var osuModDoubleTime = new OsuModDoubleTime { SpeedChange = { Value = 1.2 } };
+
+            createScreen();
+            changeRuleset(0);
+
+            AddStep("set dt mod with custom rate", () => { SelectedMods.Value = new[] { osuModDoubleTime }; });
+
+            AddAssert("selected mod matches", () => (SelectedMods.Value.Single() as OsuModDoubleTime)?.SpeedChange.Value == 1.2);
+
+            AddStep("deselect", () => getPanelForMod(typeof(OsuModDoubleTime)).TriggerClick());
+            AddAssert("selected mods empty", () => SelectedMods.Value.Count == 0);
+
+            AddStep("reselect", () => getPanelForMod(typeof(OsuModDoubleTime)).TriggerClick());
+            AddAssert("selected mod has default value", () => (SelectedMods.Value.Single() as OsuModDoubleTime)?.SpeedChange.IsDefault == true);
+        }
+
+        [Test]
+        public void TestAnimationFlushOnClose()
+        {
+            createScreen();
+            changeRuleset(0);
+
+            AddStep("Select all fun mods", () =>
+            {
+                modSelectScreen.ChildrenOfType<ModColumn>()
+                               .Single(c => c.ModType == ModType.DifficultyIncrease)
+                               .SelectAll();
+            });
+
+            AddUntilStep("many mods selected", () => SelectedMods.Value.Count >= 5);
+
+            AddStep("trigger deselect and close overlay", () =>
+            {
+                modSelectScreen.ChildrenOfType<ModColumn>()
+                               .Single(c => c.ModType == ModType.DifficultyIncrease)
+                               .DeselectAll();
+
+                modSelectScreen.Hide();
+            });
+
+            AddAssert("all mods deselected", () => SelectedMods.Value.Count == 0);
+        }
+
+        [Test]
+        public void TestRulesetChanges()
+        {
+            createScreen();
+            changeRuleset(0);
+
+            var noFailMod = new OsuRuleset().GetModsFor(ModType.DifficultyReduction).FirstOrDefault(m => m is OsuModNoFail);
+
+            AddStep("set mods externally", () => { SelectedMods.Value = new[] { noFailMod }; });
+
+            changeRuleset(0);
+
+            AddAssert("ensure mods still selected", () => SelectedMods.Value.SingleOrDefault(m => m is OsuModNoFail) != null);
+
+            changeRuleset(3);
+
+            AddAssert("ensure mods not selected", () => SelectedMods.Value.Count == 0);
+
+            changeRuleset(0);
+
+            AddAssert("ensure mods not selected", () => SelectedMods.Value.Count == 0);
+        }
+
+        [Test]
+        public void TestExternallySetCustomizedMod()
+        {
+            createScreen();
+            changeRuleset(0);
+
+            AddStep("set customized mod externally", () => SelectedMods.Value = new[] { new OsuModDoubleTime { SpeedChange = { Value = 1.01 } } });
+
+            AddAssert("ensure button is selected and customized accordingly", () =>
+            {
+                var button = getPanelForMod(SelectedMods.Value.Single().GetType());
+                return ((OsuModDoubleTime)button.Mod).SpeedChange.Value == 1.01;
+            });
+        }
+
+        [Test]
+        public void TestSettingsAreRetainedOnReload()
+        {
+            createScreen();
+            changeRuleset(0);
+
+            AddStep("set customized mod externally", () => SelectedMods.Value = new[] { new OsuModDoubleTime { SpeedChange = { Value = 1.01 } } });
+            AddAssert("setting remains", () => (SelectedMods.Value.SingleOrDefault() as OsuModDoubleTime)?.SpeedChange.Value == 1.01);
+
+            createScreen();
+            AddAssert("setting remains", () => (SelectedMods.Value.SingleOrDefault() as OsuModDoubleTime)?.SpeedChange.Value == 1.01);
+        }
+
+        [Test]
+        public void TestExternallySetModIsReplacedByOverlayInstance()
+        {
+            Mod external = new OsuModDoubleTime();
+            Mod overlayButtonMod = null;
+
+            createScreen();
+            changeRuleset(0);
+
+            AddStep("set mod externally", () => { SelectedMods.Value = new[] { external }; });
+
+            AddAssert("ensure button is selected", () =>
+            {
+                var button = getPanelForMod(SelectedMods.Value.Single().GetType());
+                overlayButtonMod = button.Mod;
+                return button.Active.Value;
+            });
+
+            // Right now, when an external change occurs, the ModSelectOverlay will replace the global instance with its own
+            AddAssert("mod instance doesn't match", () => external != overlayButtonMod);
+
+            AddAssert("one mod present in global selected", () => SelectedMods.Value.Count == 1);
+            AddAssert("globally selected matches button's mod instance", () => SelectedMods.Value.Contains(overlayButtonMod));
+            AddAssert("globally selected doesn't contain original external change", () => !SelectedMods.Value.Contains(external));
+        }
+
+        [Test]
+        public void TestChangeIsValidChangesButtonVisibility()
+        {
+            createScreen();
+            changeRuleset(0);
+
+            AddAssert("double time visible", () => modSelectScreen.ChildrenOfType<ModPanel>().Where(panel => panel.Mod is OsuModDoubleTime).Any(panel => !panel.Filtered.Value));
+
+            AddStep("make double time invalid", () => modSelectScreen.IsValidMod = m => !(m is OsuModDoubleTime));
+            AddUntilStep("double time not visible", () => modSelectScreen.ChildrenOfType<ModPanel>().Where(panel => panel.Mod is OsuModDoubleTime).All(panel => panel.Filtered.Value));
+            AddAssert("nightcore still visible", () => modSelectScreen.ChildrenOfType<ModPanel>().Where(panel => panel.Mod is OsuModNightcore).Any(panel => !panel.Filtered.Value));
+
+            AddStep("make double time valid again", () => modSelectScreen.IsValidMod = m => true);
+            AddUntilStep("double time visible", () => modSelectScreen.ChildrenOfType<ModPanel>().Where(panel => panel.Mod is OsuModDoubleTime).Any(panel => !panel.Filtered.Value));
+            AddAssert("nightcore still visible", () => modSelectScreen.ChildrenOfType<ModPanel>().Where(b => b.Mod is OsuModNightcore).Any(panel => !panel.Filtered.Value));
+        }
+
+        [Test]
+        public void TestChangeIsValidPreservesSelection()
+        {
+            createScreen();
+            changeRuleset(0);
+
+            AddStep("select DT + HD", () => SelectedMods.Value = new Mod[] { new OsuModDoubleTime(), new OsuModHidden() });
+            AddAssert("DT + HD selected", () => modSelectScreen.ChildrenOfType<ModPanel>().Count(panel => panel.Active.Value) == 2);
+
+            AddStep("make NF invalid", () => modSelectScreen.IsValidMod = m => !(m is ModNoFail));
+            AddAssert("DT + HD still selected", () => modSelectScreen.ChildrenOfType<ModPanel>().Count(panel => panel.Active.Value) == 2);
+        }
+
+        [Test]
+        public void TestUnimplementedModIsUnselectable()
+        {
+            var testRuleset = new TestUnimplementedModOsuRuleset();
+
+            createScreen();
+
+            AddStep("set ruleset", () => Ruleset.Value = testRuleset.RulesetInfo);
+            waitForColumnLoad();
+
+            AddAssert("unimplemented mod panel is filtered", () => getPanelForMod(typeof(TestUnimplementedMod)).Filtered.Value);
+        }
+
         private void waitForColumnLoad() => AddUntilStep("all column content loaded",
             () => modSelectScreen.ChildrenOfType<ModColumn>().Any() && modSelectScreen.ChildrenOfType<ModColumn>().All(column => column.IsLoaded && column.ItemsLoaded));
 
@@ -188,5 +392,26 @@ namespace osu.Game.Tests.Visual.UserInterface
 
         private ModPanel getPanelForMod(Type modType)
             => modSelectScreen.ChildrenOfType<ModPanel>().Single(panel => panel.Mod.GetType() == modType);
+
+        private class TestUnimplementedMod : Mod
+        {
+            public override string Name => "Unimplemented mod";
+            public override string Acronym => "UM";
+            public override string Description => "A mod that is not implemented.";
+            public override double ScoreMultiplier => 1;
+            public override ModType Type => ModType.Conversion;
+        }
+
+        private class TestUnimplementedModOsuRuleset : OsuRuleset
+        {
+            public override string ShortName => "unimplemented";
+
+            public override IEnumerable<Mod> GetModsFor(ModType type)
+            {
+                if (type == ModType.Conversion) return base.GetModsFor(type).Concat(new[] { new TestUnimplementedMod() });
+
+                return base.GetModsFor(type);
+            }
+        }
     }
 }

From 746a4a740316f6bd1fbdd17f8bcc1d63c3474e6a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 17 Apr 2022 21:23:54 +0200
Subject: [PATCH 4456/5547] Fix mod column using wrong equality type

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

diff --git a/osu.Game/Overlays/Mods/ModColumn.cs b/osu.Game/Overlays/Mods/ModColumn.cs
index 018922c074..9e32602a85 100644
--- a/osu.Game/Overlays/Mods/ModColumn.cs
+++ b/osu.Game/Overlays/Mods/ModColumn.cs
@@ -296,7 +296,7 @@ namespace osu.Game.Overlays.Mods
         private void updateActiveState()
         {
             foreach (var panel in panelFlow)
-                panel.Active.Value = SelectedMods.Value.Contains(panel.Mod, EqualityComparer<Mod>.Default);
+                panel.Active.Value = SelectedMods.Value.Any(selected => selected.GetType() == panel.Mod.GetType());
         }
 
         #region Bulk select / deselect

From fe59f4ae58ae848af1f6992d9c4b63f9f3d3a0e5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 17 Apr 2022 20:32:45 +0200
Subject: [PATCH 4457/5547] Fix multiselection operation not flushing on close

---
 osu.Game/Overlays/Mods/ModColumn.cs       |  9 +++++++++
 osu.Game/Overlays/Mods/ModSelectScreen.cs | 10 ++++++----
 2 files changed, 15 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Overlays/Mods/ModColumn.cs b/osu.Game/Overlays/Mods/ModColumn.cs
index 9e32602a85..c839305746 100644
--- a/osu.Game/Overlays/Mods/ModColumn.cs
+++ b/osu.Game/Overlays/Mods/ModColumn.cs
@@ -364,6 +364,15 @@ namespace osu.Game.Overlays.Mods
                 pendingSelectionOperations.Enqueue(() => button.Active.Value = false);
         }
 
+        /// <summary>
+        /// Play out all remaining animations immediately to leave mods in a good (final) state.
+        /// </summary>
+        public void FlushAnimation()
+        {
+            while (pendingSelectionOperations.TryDequeue(out var dequeuedAction))
+                dequeuedAction();
+        }
+
         private class ToggleAllCheckbox : OsuCheckbox
         {
             private Color4 accentColour;
diff --git a/osu.Game/Overlays/Mods/ModSelectScreen.cs b/osu.Game/Overlays/Mods/ModSelectScreen.cs
index ffd6e9a52c..20c5b5a321 100644
--- a/osu.Game/Overlays/Mods/ModSelectScreen.cs
+++ b/osu.Game/Overlays/Mods/ModSelectScreen.cs
@@ -313,10 +313,12 @@ namespace osu.Game.Overlays.Mods
             {
                 const float distance = 700;
 
-                columnFlow[i].Column
-                             .TopLevelContent
-                             .MoveToY(i % 2 == 0 ? -distance : distance, fade_out_duration, Easing.OutQuint)
-                             .FadeOut(fade_out_duration, Easing.OutQuint);
+                var column = columnFlow[i].Column;
+
+                column.FlushAnimation();
+                column.TopLevelContent
+                      .MoveToY(i % 2 == 0 ? -distance : distance, fade_out_duration, Easing.OutQuint)
+                      .FadeOut(fade_out_duration, Easing.OutQuint);
             }
         }
 

From 7c04bf5c53442b3fe2d0adf05928c674a378923c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 17 Apr 2022 22:12:06 +0200
Subject: [PATCH 4458/5547] Refactor mod reference management to meet test
 expectations

---
 osu.Game/Overlays/Mods/ModColumn.cs | 29 ++++++++++++++++++++++-------
 1 file changed, 22 insertions(+), 7 deletions(-)

diff --git a/osu.Game/Overlays/Mods/ModColumn.cs b/osu.Game/Overlays/Mods/ModColumn.cs
index c839305746..c2273abf53 100644
--- a/osu.Game/Overlays/Mods/ModColumn.cs
+++ b/osu.Game/Overlays/Mods/ModColumn.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.
 
+#nullable enable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
@@ -10,6 +12,7 @@ using Humanizer;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Extensions.Color4Extensions;
+using osu.Framework.Extensions.IEnumerableExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Colour;
 using osu.Framework.Graphics.Containers;
@@ -25,8 +28,6 @@ using osuTK;
 using osuTK.Graphics;
 using osuTK.Input;
 
-#nullable enable
-
 namespace osu.Game.Overlays.Mods
 {
     public class ModColumn : CompositeDrawable
@@ -256,7 +257,9 @@ namespace osu.Game.Overlays.Mods
 
         private void updateMods()
         {
-            var newMods = ModUtils.FlattenMods(availableMods.Value.GetValueOrDefault(ModType) ?? Array.Empty<Mod>()).ToList();
+            var newMods = ModUtils.FlattenMods(availableMods.Value.GetValueOrDefault(ModType) ?? Array.Empty<Mod>())
+                                  .Select(m => m.DeepClone())
+                                  .ToList();
 
             if (newMods.SequenceEqual(panelFlow.Children.Select(p => p.Mod)))
                 return;
@@ -280,9 +283,16 @@ namespace osu.Game.Overlays.Mods
                     panel.Active.BindValueChanged(_ =>
                     {
                         updateToggleAllState();
-                        SelectedMods.Value = panel.Active.Value
-                            ? SelectedMods.Value.Append(panel.Mod).ToArray()
-                            : SelectedMods.Value.Except(new[] { panel.Mod }).ToArray();
+
+                        var newSelectedMods = SelectedMods.Value;
+
+                        var matchingModInstance = SelectedMods.Value.SingleOrDefault(selected => selected.GetType() == panel.Mod.GetType());
+                        if (matchingModInstance != null && (matchingModInstance != panel.Mod || !panel.Active.Value))
+                            newSelectedMods = newSelectedMods.Except(matchingModInstance.Yield()).ToArray();
+                        if (panel.Active.Value)
+                            newSelectedMods = newSelectedMods.Append(panel.Mod).ToArray();
+
+                        SelectedMods.Value = newSelectedMods.ToArray();
                     });
                 }
             }, (cancellationTokenSource = new CancellationTokenSource()).Token);
@@ -296,7 +306,12 @@ namespace osu.Game.Overlays.Mods
         private void updateActiveState()
         {
             foreach (var panel in panelFlow)
-                panel.Active.Value = SelectedMods.Value.Any(selected => selected.GetType() == panel.Mod.GetType());
+            {
+                var matchingSelectedMod = SelectedMods.Value.SingleOrDefault(selected => selected.GetType() == panel.Mod.GetType());
+                panel.Active.Value = matchingSelectedMod != null;
+                if (matchingSelectedMod != null)
+                    panel.Mod.CopyFrom(matchingSelectedMod);
+            }
         }
 
         #region Bulk select / deselect

From f91ee4b0422bd8b91585b4f0f9a689719a8b0f06 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 17 Apr 2022 22:14:28 +0200
Subject: [PATCH 4459/5547] Reset panel mod instance settings to defaults on
 deselect

---
 osu.Game/Overlays/Mods/ModColumn.cs | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/Mods/ModColumn.cs b/osu.Game/Overlays/Mods/ModColumn.cs
index c2273abf53..d480382fcb 100644
--- a/osu.Game/Overlays/Mods/ModColumn.cs
+++ b/osu.Game/Overlays/Mods/ModColumn.cs
@@ -309,8 +309,10 @@ namespace osu.Game.Overlays.Mods
             {
                 var matchingSelectedMod = SelectedMods.Value.SingleOrDefault(selected => selected.GetType() == panel.Mod.GetType());
                 panel.Active.Value = matchingSelectedMod != null;
-                if (matchingSelectedMod != null)
+                if (panel.Active.Value)
                     panel.Mod.CopyFrom(matchingSelectedMod);
+                else
+                    panel.Mod.ResetSettingsToDefaults();
             }
         }
 

From e3641213e1832c627def0b48aae6213f455e4b17 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 17 Apr 2022 22:16:59 +0200
Subject: [PATCH 4460/5547] Always hide unimplemented mods on mod select screen

---
 osu.Game/Overlays/Mods/ModSelectScreen.cs          | 2 +-
 osu.Game/Screens/OnlinePlay/FreeModSelectScreen.cs | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Overlays/Mods/ModSelectScreen.cs b/osu.Game/Overlays/Mods/ModSelectScreen.cs
index 20c5b5a321..2f6eae0afb 100644
--- a/osu.Game/Overlays/Mods/ModSelectScreen.cs
+++ b/osu.Game/Overlays/Mods/ModSelectScreen.cs
@@ -203,7 +203,7 @@ namespace osu.Game.Overlays.Mods
         private void updateAvailableMods()
         {
             foreach (var column in columnFlow.Columns)
-                column.Filter = isValidMod;
+                column.Filter = m => m.HasImplementation && isValidMod.Invoke(m);
         }
 
         private void updateCustomisation(ValueChangedEvent<IReadOnlyList<Mod>> valueChangedEvent)
diff --git a/osu.Game/Screens/OnlinePlay/FreeModSelectScreen.cs b/osu.Game/Screens/OnlinePlay/FreeModSelectScreen.cs
index c85a4fc38b..5a7a60b479 100644
--- a/osu.Game/Screens/OnlinePlay/FreeModSelectScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/FreeModSelectScreen.cs
@@ -16,7 +16,7 @@ namespace osu.Game.Screens.OnlinePlay
         public new Func<Mod, bool> IsValidMod
         {
             get => base.IsValidMod;
-            set => base.IsValidMod = m => m.HasImplementation && m.UserPlayable && value.Invoke(m);
+            set => base.IsValidMod = m => m.UserPlayable && value.Invoke(m);
         }
 
         public FreeModSelectScreen()

From 970361676b374995f5c768805e9d9097e23ec855 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 2 May 2022 23:05:35 +0200
Subject: [PATCH 4461/5547] Fix setting items not creating if mods initially
 not empty

---
 .../Visual/UserInterface/TestSceneModSelectScreen.cs         | 2 ++
 osu.Game/Overlays/Mods/ModSettingsArea.cs                    | 5 +++--
 2 files changed, 5 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs
index bd63023efb..7690029ba2 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs
@@ -68,6 +68,7 @@ namespace osu.Game.Tests.Visual.UserInterface
                 return Precision.AlmostEquals(multiplier, modSelectScreen.ChildrenOfType<DifficultyMultiplierDisplay>().Single().Current.Value);
             });
             assertCustomisationToggleState(disabled: false, active: false);
+            AddAssert("setting items created", () => modSelectScreen.ChildrenOfType<ISettingsItem>().Any());
         }
 
         [Test]
@@ -82,6 +83,7 @@ namespace osu.Game.Tests.Visual.UserInterface
                 return Precision.AlmostEquals(multiplier, modSelectScreen.ChildrenOfType<DifficultyMultiplierDisplay>().Single().Current.Value);
             });
             assertCustomisationToggleState(disabled: false, active: false);
+            AddAssert("setting items created", () => modSelectScreen.ChildrenOfType<ISettingsItem>().Any());
         }
 
         [Test]
diff --git a/osu.Game/Overlays/Mods/ModSettingsArea.cs b/osu.Game/Overlays/Mods/ModSettingsArea.cs
index be72c1e3e3..9c5f3b7f11 100644
--- a/osu.Game/Overlays/Mods/ModSettingsArea.cs
+++ b/osu.Game/Overlays/Mods/ModSettingsArea.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.Framework.Allocation;
@@ -21,7 +22,7 @@ namespace osu.Game.Overlays.Mods
 {
     public class ModSettingsArea : CompositeDrawable
     {
-        public Bindable<IReadOnlyList<Mod>> SelectedMods { get; } = new Bindable<IReadOnlyList<Mod>>();
+        public Bindable<IReadOnlyList<Mod>> SelectedMods { get; } = new Bindable<IReadOnlyList<Mod>>(Array.Empty<Mod>());
 
         public const float HEIGHT = 250;
 
@@ -77,7 +78,7 @@ namespace osu.Game.Overlays.Mods
         protected override void LoadComplete()
         {
             base.LoadComplete();
-            SelectedMods.BindValueChanged(_ => updateMods());
+            SelectedMods.BindValueChanged(_ => updateMods(), true);
         }
 
         private void updateMods()

From 216dfb7e9121b5e0f8b662d3f9039aeb7860fbcc Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 2 May 2022 23:29:30 +0200
Subject: [PATCH 4462/5547] Expand incompatibility test to cover logic more
 thoroughly

---
 .../Visual/UserInterface/TestSceneModSelectScreen.cs      | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs
index 7690029ba2..0bd138275b 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs
@@ -104,17 +104,25 @@ namespace osu.Game.Tests.Visual.UserInterface
 
             AddStep("activate DT", () => getPanelForMod(typeof(OsuModDoubleTime)).TriggerClick());
             AddAssert("DT active", () => SelectedMods.Value.Single().GetType() == typeof(OsuModDoubleTime));
+            AddAssert("DT panel active", () => getPanelForMod(typeof(OsuModDoubleTime)).Active.Value);
 
             AddStep("activate NC", () => getPanelForMod(typeof(OsuModNightcore)).TriggerClick());
             AddAssert("only NC active", () => SelectedMods.Value.Single().GetType() == typeof(OsuModNightcore));
+            AddAssert("DT panel not active", () => !getPanelForMod(typeof(OsuModDoubleTime)).Active.Value);
+            AddAssert("NC panel active", () => getPanelForMod(typeof(OsuModNightcore)).Active.Value);
 
             AddStep("activate HR", () => getPanelForMod(typeof(OsuModHardRock)).TriggerClick());
             AddAssert("NC+HR active", () => SelectedMods.Value.Any(mod => mod.GetType() == typeof(OsuModNightcore))
                                             && SelectedMods.Value.Any(mod => mod.GetType() == typeof(OsuModHardRock)));
+            AddAssert("NC panel active", () => getPanelForMod(typeof(OsuModNightcore)).Active.Value);
+            AddAssert("HR panel active", () => getPanelForMod(typeof(OsuModHardRock)).Active.Value);
 
             AddStep("activate MR", () => getPanelForMod(typeof(OsuModMirror)).TriggerClick());
             AddAssert("NC+MR active", () => SelectedMods.Value.Any(mod => mod.GetType() == typeof(OsuModNightcore))
                                             && SelectedMods.Value.Any(mod => mod.GetType() == typeof(OsuModMirror)));
+            AddAssert("NC panel active", () => getPanelForMod(typeof(OsuModNightcore)).Active.Value);
+            AddAssert("HR panel not active", () => !getPanelForMod(typeof(OsuModHardRock)).Active.Value);
+            AddAssert("MR panel active", () => getPanelForMod(typeof(OsuModMirror)).Active.Value);
         }
 
         [Test]

From f5fa41356e33a528039742f9909d45dff71e451e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 3 May 2022 21:44:44 +0200
Subject: [PATCH 4463/5547] Rewrite mod instance management again to pass tests

---
 .../UserInterface/TestSceneModSelectScreen.cs |   4 +-
 osu.Game/Overlays/Mods/ModColumn.cs           | 129 ++++++++++++------
 osu.Game/Overlays/Mods/ModSelectScreen.cs     |  33 ++---
 osu.Game/Overlays/Mods/UserModSelectScreen.cs |   7 +-
 4 files changed, 111 insertions(+), 62 deletions(-)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs
index 0bd138275b..bdb423a43c 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs
@@ -336,8 +336,8 @@ namespace osu.Game.Tests.Visual.UserInterface
             AddAssert("mod instance doesn't match", () => external != overlayButtonMod);
 
             AddAssert("one mod present in global selected", () => SelectedMods.Value.Count == 1);
-            AddAssert("globally selected matches button's mod instance", () => SelectedMods.Value.Contains(overlayButtonMod));
-            AddAssert("globally selected doesn't contain original external change", () => !SelectedMods.Value.Contains(external));
+            AddAssert("globally selected matches button's mod instance", () => SelectedMods.Value.Any(mod => ReferenceEquals(mod, overlayButtonMod)));
+            AddAssert("globally selected doesn't contain original external change", () => !SelectedMods.Value.Any(mod => ReferenceEquals(mod, external)));
         }
 
         [Test]
diff --git a/osu.Game/Overlays/Mods/ModColumn.cs b/osu.Game/Overlays/Mods/ModColumn.cs
index d480382fcb..f9332dd28b 100644
--- a/osu.Game/Overlays/Mods/ModColumn.cs
+++ b/osu.Game/Overlays/Mods/ModColumn.cs
@@ -53,9 +53,22 @@ namespace osu.Game.Overlays.Mods
             }
         }
 
-        public Bindable<IReadOnlyList<Mod>> SelectedMods = new Bindable<IReadOnlyList<Mod>>(Array.Empty<Mod>());
         public Bindable<bool> Active = new BindableBool(true);
 
+        /// <summary>
+        /// List of mods marked as selected in this column.
+        /// </summary>
+        /// <remarks>
+        /// Note that the mod instances returned by this property are owned solely by this column
+        /// (as in, they are locally-managed clones, to ensure proper isolation from any other external instances).
+        /// </remarks>
+        public IReadOnlyList<Mod> SelectedMods { get; private set; } = Array.Empty<Mod>();
+
+        /// <summary>
+        /// Invoked when a mod panel has been selected interactively by the user.
+        /// </summary>
+        public event Action? SelectionChangedByUser;
+
         protected override bool ReceivePositionalInputAtSubTree(Vector2 screenSpacePos) => base.ReceivePositionalInputAtSubTree(screenSpacePos) && Active.Value;
 
         protected virtual ModPanel CreateModPanel(Mod mod) => new ModPanel(mod);
@@ -64,6 +77,15 @@ namespace osu.Game.Overlays.Mods
 
         private readonly Bindable<Dictionary<ModType, IReadOnlyList<Mod>>> availableMods = new Bindable<Dictionary<ModType, IReadOnlyList<Mod>>>();
 
+        /// <summary>
+        /// All mods that are available for the current ruleset in this particular column.
+        /// </summary>
+        /// <remarks>
+        /// Note that the mod instances in this list are owned solely by this column
+        /// (as in, they are locally-managed clones, to ensure proper isolation from any other external instances).
+        /// </remarks>
+        private IReadOnlyList<Mod> localAvailableMods = Array.Empty<Mod>();
+
         private readonly TextFlowContainer headerText;
         private readonly Box headerBackground;
         private readonly Container contentContainer;
@@ -227,6 +249,9 @@ namespace osu.Game.Overlays.Mods
         private void load(OsuGameBase game, OverlayColourProvider colourProvider, OsuColour colours)
         {
             availableMods.BindTo(game.AvailableMods);
+            // this `BindValueChanged` callback is intentionally here, to ensure that local available mods are constructed as early as possible.
+            // this is needed to make sure no external changes to mods are dropped while mod panels are asynchronously loading.
+            availableMods.BindValueChanged(_ => updateLocalAvailableMods(), true);
 
             headerBackground.Colour = accentColour = colours.ForModType(ModType);
 
@@ -240,33 +265,26 @@ namespace osu.Game.Overlays.Mods
             contentBackground.Colour = colourProvider.Background4;
         }
 
-        protected override void LoadComplete()
-        {
-            base.LoadComplete();
-            availableMods.BindValueChanged(_ => Scheduler.AddOnce(updateMods));
-            SelectedMods.BindValueChanged(_ =>
-            {
-                // if a load is in progress, don't try to update the selection - the load flow will do so.
-                if (latestLoadTask == null)
-                    updateActiveState();
-            });
-            updateMods();
-        }
-
-        private CancellationTokenSource? cancellationTokenSource;
-
-        private void updateMods()
+        private void updateLocalAvailableMods()
         {
             var newMods = ModUtils.FlattenMods(availableMods.Value.GetValueOrDefault(ModType) ?? Array.Empty<Mod>())
                                   .Select(m => m.DeepClone())
                                   .ToList();
 
-            if (newMods.SequenceEqual(panelFlow.Children.Select(p => p.Mod)))
+            if (newMods.SequenceEqual(localAvailableMods))
                 return;
 
+            localAvailableMods = newMods;
+            Scheduler.AddOnce(loadPanels);
+        }
+
+        private CancellationTokenSource? cancellationTokenSource;
+
+        private void loadPanels()
+        {
             cancellationTokenSource?.Cancel();
 
-            var panels = newMods.Select(mod => CreateModPanel(mod).With(panel => panel.Shear = new Vector2(-ShearedOverlayContainer.SHEAR, 0)));
+            var panels = localAvailableMods.Select(mod => CreateModPanel(mod).With(panel => panel.Shear = new Vector2(-ShearedOverlayContainer.SHEAR, 0)));
 
             Task? loadTask;
 
@@ -280,20 +298,7 @@ namespace osu.Game.Overlays.Mods
 
                 foreach (var panel in panelFlow)
                 {
-                    panel.Active.BindValueChanged(_ =>
-                    {
-                        updateToggleAllState();
-
-                        var newSelectedMods = SelectedMods.Value;
-
-                        var matchingModInstance = SelectedMods.Value.SingleOrDefault(selected => selected.GetType() == panel.Mod.GetType());
-                        if (matchingModInstance != null && (matchingModInstance != panel.Mod || !panel.Active.Value))
-                            newSelectedMods = newSelectedMods.Except(matchingModInstance.Yield()).ToArray();
-                        if (panel.Active.Value)
-                            newSelectedMods = newSelectedMods.Append(panel.Mod).ToArray();
-
-                        SelectedMods.Value = newSelectedMods.ToArray();
-                    });
+                    panel.Active.BindValueChanged(_ => panelStateChanged(panel));
                 }
             }, (cancellationTokenSource = new CancellationTokenSource()).Token);
             loadTask.ContinueWith(_ =>
@@ -306,14 +311,62 @@ namespace osu.Game.Overlays.Mods
         private void updateActiveState()
         {
             foreach (var panel in panelFlow)
+                panel.Active.Value = SelectedMods.Contains(panel.Mod);
+        }
+
+        /// <summary>
+        /// This flag helps to determine the source of changes to <see cref="SelectedMods"/>.
+        /// If the value is false, then <see cref="SelectedMods"/> are changing due to a user selection on the UI.
+        /// If the value is true, then <see cref="SelectedMods"/> are changing due to an external <see cref="SetSelection"/> call.
+        /// </summary>
+        private bool externalSelectionUpdateInProgress;
+
+        private void panelStateChanged(ModPanel panel)
+        {
+            updateToggleAllState();
+
+            var newSelectedMods = panel.Active.Value
+                ? SelectedMods.Append(panel.Mod)
+                : SelectedMods.Except(panel.Mod.Yield());
+
+            SelectedMods = newSelectedMods.ToArray();
+            if (!externalSelectionUpdateInProgress)
+                SelectionChangedByUser?.Invoke();
+        }
+
+        /// <summary>
+        /// Adjusts the set of selected mods in this column to match the passed in <paramref name="mods"/>.
+        /// </summary>
+        /// <remarks>
+        /// This method exists to be able to receive mod instances that come from potentially-external sources and to copy the changes across to this column's state.
+        /// <see cref="ModSelectScreen"/> uses this to substitute any external mod references in <see cref="ModSelectScreen.SelectedMods"/>
+        /// to references that are owned by this column.
+        /// </remarks>
+        internal void SetSelection(IReadOnlyList<Mod> mods)
+        {
+            externalSelectionUpdateInProgress = true;
+
+            var newSelection = new List<Mod>();
+
+            foreach (var mod in localAvailableMods)
             {
-                var matchingSelectedMod = SelectedMods.Value.SingleOrDefault(selected => selected.GetType() == panel.Mod.GetType());
-                panel.Active.Value = matchingSelectedMod != null;
-                if (panel.Active.Value)
-                    panel.Mod.CopyFrom(matchingSelectedMod);
+                var matchingSelectedMod = mods.SingleOrDefault(selected => selected.GetType() == mod.GetType());
+
+                if (matchingSelectedMod != null)
+                {
+                    mod.CopyFrom(matchingSelectedMod);
+                    newSelection.Add(mod);
+                }
                 else
-                    panel.Mod.ResetSettingsToDefaults();
+                {
+                    mod.ResetSettingsToDefaults();
+                }
             }
+
+            SelectedMods = newSelection;
+            updateActiveState();
+
+            externalSelectionUpdateInProgress = false;
         }
 
         #region Bulk select / deselect
diff --git a/osu.Game/Overlays/Mods/ModSelectScreen.cs b/osu.Game/Overlays/Mods/ModSelectScreen.cs
index 2f6eae0afb..bb12143d7c 100644
--- a/osu.Game/Overlays/Mods/ModSelectScreen.cs
+++ b/osu.Game/Overlays/Mods/ModSelectScreen.cs
@@ -179,7 +179,7 @@ namespace osu.Game.Overlays.Mods
 
             foreach (var column in columnFlow.Columns)
             {
-                column.SelectedMods.BindValueChanged(updateBindableFromSelection);
+                column.SelectionChangedByUser += updateBindableFromSelection;
             }
 
             customisationVisible.BindValueChanged(_ => updateCustomisationVisualState(), true);
@@ -250,33 +250,26 @@ namespace osu.Game.Overlays.Mods
 
         private void updateSelectionFromBindable()
         {
-            // note that selectionBindableSyncInProgress is purposefully not checked here.
-            // this is because in the case of mod selection in solo gameplay, a user selection of a mod can actually lead to deselection of other incompatible mods.
-            // to synchronise state correctly, updateBindableFromSelection() computes the final mods (including incompatibility rules) and updates SelectedMods,
-            // and this method then runs unconditionally again to make sure the new visual selection accurately reflects the final set of selected mods.
-            // selectionBindableSyncInProgress ensures that mutual infinite recursion does not happen after that unconditional call.
+            // `SelectedMods` may contain mod references that come from external sources.
+            // to ensure isolation, first pull in the potentially-external change into the mod columns...
             foreach (var column in columnFlow.Columns)
-                column.SelectedMods.Value = SelectedMods.Value.Where(mod => mod.Type == column.ModType).ToArray();
+                column.SetSelection(SelectedMods.Value);
+
+            // and then, when done, replace the potentially-external mod references in `SelectedMods` with ones we own.
+            updateBindableFromSelection();
         }
 
-        private bool selectionBindableSyncInProgress;
-
-        private void updateBindableFromSelection(ValueChangedEvent<IReadOnlyList<Mod>> modSelectionChange)
+        private void updateBindableFromSelection()
         {
-            if (selectionBindableSyncInProgress)
+            var candidateSelection = columnFlow.Columns.SelectMany(column => column.SelectedMods).ToArray();
+
+            if (candidateSelection.SequenceEqual(SelectedMods.Value))
                 return;
 
-            selectionBindableSyncInProgress = true;
-
-            SelectedMods.Value = ComputeNewModsFromSelection(
-                modSelectionChange.NewValue.Except(modSelectionChange.OldValue),
-                modSelectionChange.OldValue.Except(modSelectionChange.NewValue));
-
-            selectionBindableSyncInProgress = false;
+            SelectedMods.Value = ComputeNewModsFromSelection(SelectedMods.Value, candidateSelection);
         }
 
-        protected virtual IReadOnlyList<Mod> ComputeNewModsFromSelection(IEnumerable<Mod> addedMods, IEnumerable<Mod> removedMods)
-            => columnFlow.Columns.SelectMany(column => column.SelectedMods.Value).ToArray();
+        protected virtual IReadOnlyList<Mod> ComputeNewModsFromSelection(IReadOnlyList<Mod> oldSelection, IReadOnlyList<Mod> newSelection) => newSelection;
 
         protected override void PopIn()
         {
diff --git a/osu.Game/Overlays/Mods/UserModSelectScreen.cs b/osu.Game/Overlays/Mods/UserModSelectScreen.cs
index ed0a07521b..ca33d35605 100644
--- a/osu.Game/Overlays/Mods/UserModSelectScreen.cs
+++ b/osu.Game/Overlays/Mods/UserModSelectScreen.cs
@@ -14,9 +14,12 @@ namespace osu.Game.Overlays.Mods
     {
         protected override ModColumn CreateModColumn(ModType modType, Key[] toggleKeys = null) => new UserModColumn(modType, false, toggleKeys);
 
-        protected override IReadOnlyList<Mod> ComputeNewModsFromSelection(IEnumerable<Mod> addedMods, IEnumerable<Mod> removedMods)
+        protected override IReadOnlyList<Mod> ComputeNewModsFromSelection(IReadOnlyList<Mod> oldSelection, IReadOnlyList<Mod> newSelection)
         {
-            IEnumerable<Mod> modsAfterRemoval = SelectedMods.Value.Except(removedMods).ToList();
+            var addedMods = newSelection.Except(oldSelection);
+            var removedMods = oldSelection.Except(newSelection);
+
+            IEnumerable<Mod> modsAfterRemoval = newSelection.Except(removedMods).ToList();
 
             // the preference is that all new mods should override potential incompatible old mods.
             // in general that's a bit difficult to compute if more than one mod is added at a time,

From 50aee8b665bcb9285fd6c8b099135f9aa56b32f4 Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Tue, 3 May 2022 22:32:01 +0100
Subject: [PATCH 4464/5547] Ensure `ChannelListSelector` text also turns white
 when selected

---
 .../Overlays/Chat/ChannelList/ChannelListSelector.cs | 12 +++++++++++-
 1 file changed, 11 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/Chat/ChannelList/ChannelListSelector.cs b/osu.Game/Overlays/Chat/ChannelList/ChannelListSelector.cs
index f9dab74eb1..9cba93ffa5 100644
--- a/osu.Game/Overlays/Chat/ChannelList/ChannelListSelector.cs
+++ b/osu.Game/Overlays/Chat/ChannelList/ChannelListSelector.cs
@@ -21,6 +21,10 @@ namespace osu.Game.Overlays.Chat.ChannelList
 
         private Box hoverBox = null!;
         private Box selectBox = null!;
+        private OsuSpriteText text = null!;
+
+        [Resolved]
+        private OverlayColourProvider colourProvider { get; set; } = null!;
 
         [BackgroundDependencyLoader]
         private void load(OverlayColourProvider colourProvider)
@@ -46,7 +50,7 @@ namespace osu.Game.Overlays.Chat.ChannelList
                 {
                     RelativeSizeAxes = Axes.Both,
                     Padding = new MarginPadding { Left = 18, Right = 10 },
-                    Child = new OsuSpriteText
+                    Child = text = new OsuSpriteText
                     {
                         Anchor = Anchor.CentreLeft,
                         Origin = Anchor.CentreLeft,
@@ -68,9 +72,15 @@ namespace osu.Game.Overlays.Chat.ChannelList
             SelectorActive.BindValueChanged(selector =>
             {
                 if (selector.NewValue)
+                {
+                    text.FadeColour(colourProvider.Content1, 300, Easing.OutQuint);
                     selectBox.FadeIn(300, Easing.OutQuint);
+                }
                 else
+                {
+                    text.FadeColour(colourProvider.Light3, 200, Easing.OutQuint);
                     selectBox.FadeOut(200, Easing.OutQuint);
+                }
             }, true);
 
             Action = () => SelectorActive.Value = true;

From c17edb2848e32dd803e88b6b95efe4c46d74ab2a Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Tue, 3 May 2022 22:32:51 +0100
Subject: [PATCH 4465/5547] Add padding to text in `ChatTextBar` to separate it
 from the textbox

---
 osu.Game/Overlays/Chat/ChatTextBar.cs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Game/Overlays/Chat/ChatTextBar.cs b/osu.Game/Overlays/Chat/ChatTextBar.cs
index 316511d9a6..3de7b67b0f 100644
--- a/osu.Game/Overlays/Chat/ChatTextBar.cs
+++ b/osu.Game/Overlays/Chat/ChatTextBar.cs
@@ -68,6 +68,7 @@ namespace osu.Game.Overlays.Chat
                                 RelativeSizeAxes = Axes.Y,
                                 Width = chatting_text_width,
                                 Masking = true,
+                                Padding = new MarginPadding { Right = 5 },
                                 Child = chattingText = new OsuSpriteText
                                 {
                                     Font = OsuFont.Torus.With(size: 20),

From 60999e83e03647f71460c65ba57aa3d038d994ae Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Tue, 3 May 2022 22:33:36 +0100
Subject: [PATCH 4466/5547] Ensure `ChatTextBox` takes/leaves focus on chat
 overlay pop in/out

---
 osu.Game/Overlays/Chat/ChatTextBar.cs |  4 ++++
 osu.Game/Overlays/ChatOverlayV2.cs    | 10 ++++++++--
 2 files changed, 12 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Overlays/Chat/ChatTextBar.cs b/osu.Game/Overlays/Chat/ChatTextBar.cs
index 3de7b67b0f..0fa3613d38 100644
--- a/osu.Game/Overlays/Chat/ChatTextBar.cs
+++ b/osu.Game/Overlays/Chat/ChatTextBar.cs
@@ -26,6 +26,10 @@ namespace osu.Game.Overlays.Chat
 
         public event Action<string>? OnSearchTermsChanged;
 
+        public void TextBoxTakeFocus() => chatTextBox.TakeFocus();
+
+        public void TextBoxKillFocus() => chatTextBox.KillFocus();
+
         [Resolved]
         private Bindable<Channel> currentChannel { get; set; } = null!;
 
diff --git a/osu.Game/Overlays/ChatOverlayV2.cs b/osu.Game/Overlays/ChatOverlayV2.cs
index d0b49d9ef3..f6190bbe20 100644
--- a/osu.Game/Overlays/ChatOverlayV2.cs
+++ b/osu.Game/Overlays/ChatOverlayV2.cs
@@ -214,16 +214,22 @@ namespace osu.Game.Overlays
 
         protected override void PopIn()
         {
+            base.PopIn();
+
             this.MoveToY(0, transition_length, Easing.OutQuint);
             this.FadeIn(transition_length, Easing.OutQuint);
-            base.PopIn();
+
+            textBar.TextBoxTakeFocus();
         }
 
         protected override void PopOut()
         {
+            base.PopOut();
+
             this.MoveToY(Height, transition_length, Easing.InSine);
             this.FadeOut(transition_length, Easing.InSine);
-            base.PopOut();
+
+            textBar.TextBoxKillFocus();
         }
 
         private void currentChannelChanged(ValueChangedEvent<Channel> e)

From d52a1a5d2324a5d0041fe7d7e6e548e56f907aa2 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 4 May 2022 03:52:10 +0300
Subject: [PATCH 4467/5547] Add key binding for beatmap selection in song
 select

---
 .../Input/Bindings/GlobalActionContainer.cs   | 10 +++++++-
 .../GlobalActionKeyBindingStrings.cs          | 10 ++++++++
 osu.Game/Screens/Select/BeatmapCarousel.cs    | 24 ++++---------------
 3 files changed, 24 insertions(+), 20 deletions(-)

diff --git a/osu.Game/Input/Bindings/GlobalActionContainer.cs b/osu.Game/Input/Bindings/GlobalActionContainer.cs
index 47cb7be2cf..ec368a6fda 100644
--- a/osu.Game/Input/Bindings/GlobalActionContainer.cs
+++ b/osu.Game/Input/Bindings/GlobalActionContainer.cs
@@ -100,10 +100,12 @@ namespace osu.Game.Input.Bindings
 
         public IEnumerable<KeyBinding> SongSelectKeyBindings => new[]
         {
+            new KeyBinding(InputKey.Left, GlobalAction.SelectPreviousBeatmap),
+            new KeyBinding(InputKey.Right, GlobalAction.SelectNextBeatmap),
             new KeyBinding(InputKey.F1, GlobalAction.ToggleModSelection),
             new KeyBinding(InputKey.F2, GlobalAction.SelectNextRandom),
             new KeyBinding(new[] { InputKey.Shift, InputKey.F2 }, GlobalAction.SelectPreviousRandom),
-            new KeyBinding(InputKey.F3, GlobalAction.ToggleBeatmapOptions)
+            new KeyBinding(InputKey.F3, GlobalAction.ToggleBeatmapOptions),
         };
 
         public IEnumerable<KeyBinding> AudioControlKeyBindings => new[]
@@ -301,5 +303,11 @@ namespace osu.Game.Input.Bindings
 
         [LocalisableDescription(typeof(GlobalActionKeyBindingStrings), nameof(GlobalActionKeyBindingStrings.EditorFlipVertically))]
         EditorFlipVertically,
+
+        [LocalisableDescription(typeof(GlobalActionKeyBindingStrings), nameof(GlobalActionKeyBindingStrings.SelectPreviousBeatmap))]
+        SelectPreviousBeatmap,
+
+        [LocalisableDescription(typeof(GlobalActionKeyBindingStrings), nameof(GlobalActionKeyBindingStrings.SelectNextBeatmap))]
+        SelectNextBeatmap,
     }
 }
diff --git a/osu.Game/Localisation/GlobalActionKeyBindingStrings.cs b/osu.Game/Localisation/GlobalActionKeyBindingStrings.cs
index 777e97d1e3..08e13e24ae 100644
--- a/osu.Game/Localisation/GlobalActionKeyBindingStrings.cs
+++ b/osu.Game/Localisation/GlobalActionKeyBindingStrings.cs
@@ -194,6 +194,16 @@ namespace osu.Game.Localisation
         /// </summary>
         public static LocalisableString ToggleInGameInterface => new TranslatableString(getKey(@"toggle_in_game_interface"), @"Toggle in-game interface");
 
+        /// <summary>
+        /// "Previous beatmap selection"
+        /// </summary>
+        public static LocalisableString SelectPreviousBeatmap => new TranslatableString(getKey(@"select_previous_beatmap"), @"Previous beatmap selection");
+
+        /// <summary>
+        /// "Next beatmap selection"
+        /// </summary>
+        public static LocalisableString SelectNextBeatmap => new TranslatableString(getKey(@"select_next_beatmap"), @"Next beatmap selection");
+
         /// <summary>
         /// "Toggle Mod Select"
         /// </summary>
diff --git a/osu.Game/Screens/Select/BeatmapCarousel.cs b/osu.Game/Screens/Select/BeatmapCarousel.cs
index c3d340ac61..85b5af049e 100644
--- a/osu.Game/Screens/Select/BeatmapCarousel.cs
+++ b/osu.Game/Screens/Select/BeatmapCarousel.cs
@@ -604,34 +604,20 @@ namespace osu.Game.Screens.Select
         public void ScrollToSelected(bool immediate = false) =>
             pendingScrollOperation = immediate ? PendingScrollOperation.Immediate : PendingScrollOperation.Standard;
 
-        #region Key / button selection logic
-
-        protected override bool OnKeyDown(KeyDownEvent e)
-        {
-            switch (e.Key)
-            {
-                case Key.Left:
-                    SelectNext(-1);
-                    return true;
-
-                case Key.Right:
-                    SelectNext();
-                    return true;
-            }
-
-            return false;
-        }
+        #region Button selection logic
 
         public bool OnPressed(KeyBindingPressEvent<GlobalAction> e)
         {
             switch (e.Action)
             {
                 case GlobalAction.SelectNext:
-                    SelectNext(1, false);
+                case GlobalAction.SelectNextBeatmap:
+                    SelectNext(1, e.Action == GlobalAction.SelectNextBeatmap);
                     return true;
 
                 case GlobalAction.SelectPrevious:
-                    SelectNext(-1, false);
+                case GlobalAction.SelectPreviousBeatmap:
+                    SelectNext(-1, e.Action == GlobalAction.SelectPreviousBeatmap);
                     return true;
             }
 

From bb086800b1e528205cfcd635c093798bc87e2a0c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 4 May 2022 13:41:30 +0900
Subject: [PATCH 4468/5547] Remove ugly playfield border

---
 osu.Game.Rulesets.Osu/Edit/OsuHitObjectComposer.cs | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Edit/OsuHitObjectComposer.cs b/osu.Game.Rulesets.Osu/Edit/OsuHitObjectComposer.cs
index bd26a99e51..ba7c6e9d33 100644
--- a/osu.Game.Rulesets.Osu/Edit/OsuHitObjectComposer.cs
+++ b/osu.Game.Rulesets.Osu/Edit/OsuHitObjectComposer.cs
@@ -59,11 +59,6 @@ namespace osu.Game.Rulesets.Osu.Edit
         {
             LayerBelowRuleset.AddRange(new Drawable[]
             {
-                new PlayfieldBorder
-                {
-                    RelativeSizeAxes = Axes.Both,
-                    PlayfieldBorderStyle = { Value = PlayfieldBorderStyle.Corners }
-                },
                 distanceSnapGridContainer = new Container
                 {
                     RelativeSizeAxes = Axes.Both

From 0bb90c7b07169096984972b9741b6f9a9dbebb2d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 4 May 2022 13:41:55 +0900
Subject: [PATCH 4469/5547] Fix gridline centering and ensure lines are always
 rendered using a fixed screen-space width

---
 .../Components/RectangularPositionSnapGrid.cs       | 13 +++++++++----
 1 file changed, 9 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Screens/Edit/Compose/Components/RectangularPositionSnapGrid.cs b/osu.Game/Screens/Edit/Compose/Components/RectangularPositionSnapGrid.cs
index 95b4b2fe53..4c0b4f8beb 100644
--- a/osu.Game/Screens/Edit/Compose/Components/RectangularPositionSnapGrid.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/RectangularPositionSnapGrid.cs
@@ -6,6 +6,7 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Layout;
+using osu.Framework.Utils;
 using osuTK;
 
 namespace osu.Game.Screens.Edit.Compose.Components
@@ -72,25 +73,29 @@ namespace osu.Game.Screens.Edit.Compose.Components
             int index = 0;
             float currentPosition = startPosition;
 
-            while ((endPosition - currentPosition) * Math.Sign(step) > 0)
+            // Make lines the same width independent of display resolution.
+            float lineWidth = DrawWidth / ScreenSpaceDrawQuad.Width;
+
+            while (Precision.AlmostBigger((endPosition - currentPosition) * Math.Sign(step), 0))
             {
                 var gridLine = new Box
                 {
                     Colour = Colour4.White,
                     Alpha = index == 0 ? 0.3f : 0.1f,
-                    EdgeSmoothness = new Vector2(0.2f)
                 };
 
                 if (direction == Direction.Horizontal)
                 {
+                    gridLine.Origin = Anchor.CentreLeft;
                     gridLine.RelativeSizeAxes = Axes.X;
-                    gridLine.Height = 1;
+                    gridLine.Height = lineWidth;
                     gridLine.Y = currentPosition;
                 }
                 else
                 {
+                    gridLine.Origin = Anchor.TopCentre;
                     gridLine.RelativeSizeAxes = Axes.Y;
-                    gridLine.Width = 1;
+                    gridLine.Width = lineWidth;
                     gridLine.X = currentPosition;
                 }
 

From df530cb5ab2d2c598fcf8f02d20475d20abde36a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 4 May 2022 13:49:02 +0900
Subject: [PATCH 4470/5547] Add highlighting to the position snap grid edges in
 addition to centre lines

---
 .../Components/RectangularPositionSnapGrid.cs    | 16 ++++++++++++++--
 1 file changed, 14 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/Edit/Compose/Components/RectangularPositionSnapGrid.cs b/osu.Game/Screens/Edit/Compose/Components/RectangularPositionSnapGrid.cs
index 4c0b4f8beb..f0d26c7b6a 100644
--- a/osu.Game/Screens/Edit/Compose/Components/RectangularPositionSnapGrid.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/RectangularPositionSnapGrid.cs
@@ -2,6 +2,8 @@
 // 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.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
@@ -76,12 +78,14 @@ namespace osu.Game.Screens.Edit.Compose.Components
             // Make lines the same width independent of display resolution.
             float lineWidth = DrawWidth / ScreenSpaceDrawQuad.Width;
 
+            List<Box> generatedLines = new List<Box>();
+
             while (Precision.AlmostBigger((endPosition - currentPosition) * Math.Sign(step), 0))
             {
                 var gridLine = new Box
                 {
                     Colour = Colour4.White,
-                    Alpha = index == 0 ? 0.3f : 0.1f,
+                    Alpha = 0.1f,
                 };
 
                 if (direction == Direction.Horizontal)
@@ -99,11 +103,19 @@ namespace osu.Game.Screens.Edit.Compose.Components
                     gridLine.X = currentPosition;
                 }
 
-                AddInternal(gridLine);
+                generatedLines.Add(gridLine);
 
                 index += 1;
                 currentPosition = startPosition + index * step;
             }
+
+            if (generatedLines.Count == 0)
+                return;
+
+            generatedLines.First().Alpha = 0.3f;
+            generatedLines.Last().Alpha = 0.3f;
+
+            AddRangeInternal(generatedLines);
         }
 
         public Vector2 GetSnappedPosition(Vector2 original)

From 8e96af8ff0b7caaaf7e2542856daa6a7ecd001af Mon Sep 17 00:00:00 2001
From: Huo Yaoyuan <huoyaoyuan@hotmail.com>
Date: Wed, 4 May 2022 13:43:59 +0800
Subject: [PATCH 4471/5547] Update indentation to be clearer

---
 .../TestSceneManageCollectionsDialog.cs          | 16 +++++++---------
 1 file changed, 7 insertions(+), 9 deletions(-)

diff --git a/osu.Game.Tests/Visual/Collections/TestSceneManageCollectionsDialog.cs b/osu.Game.Tests/Visual/Collections/TestSceneManageCollectionsDialog.cs
index d5983ac827..888002eb36 100644
--- a/osu.Game.Tests/Visual/Collections/TestSceneManageCollectionsDialog.cs
+++ b/osu.Game.Tests/Visual/Collections/TestSceneManageCollectionsDialog.cs
@@ -141,15 +141,13 @@ namespace osu.Game.Tests.Visual.Collections
         {
             AddStep("add dropdown", () =>
             {
-                Add(
-                    new CollectionFilterDropdown
-                    {
-                        Anchor = Anchor.TopRight,
-                        Origin = Anchor.TopRight,
-                        RelativeSizeAxes = Axes.X,
-                        Width = 0.4f,
-                    }
-                );
+                Add(new CollectionFilterDropdown
+                {
+                    Anchor = Anchor.TopRight,
+                    Origin = Anchor.TopRight,
+                    RelativeSizeAxes = Axes.X,
+                    Width = 0.4f,
+                });
             });
             AddStep("add two collections with same name", () => manager.Collections.AddRange(new[]
             {

From 35eeeba4c60b9240296e077ae5968d40100877ee Mon Sep 17 00:00:00 2001
From: Huo Yaoyuan <huoyaoyuan@hotmail.com>
Date: Wed, 4 May 2022 13:57:53 +0800
Subject: [PATCH 4472/5547] Disable code style analysis on Xamarin projects

---
 osu.Android.props | 3 ++-
 osu.iOS.props     | 3 ++-
 2 files changed, 4 insertions(+), 2 deletions(-)

diff --git a/osu.Android.props b/osu.Android.props
index b6260fd1d4..299f236220 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -1,4 +1,4 @@
-<Project>
+<Project>
   <PropertyGroup>
     <LangVersion>8.0</LangVersion>
     <OutputPath>bin\$(Configuration)</OutputPath>
@@ -19,6 +19,7 @@
     <MandroidI18n>cjk,mideast,other,rare,west</MandroidI18n>
     <AndroidLinkMode>SdkOnly</AndroidLinkMode>
     <ErrorReport>prompt</ErrorReport>
+    <EnforceCodeStyleInBuild>false</EnforceCodeStyleInBuild>
   </PropertyGroup>
   <PropertyGroup Condition="'$(Configuration)' == 'Debug'">
     <DebugSymbols>True</DebugSymbols>
diff --git a/osu.iOS.props b/osu.iOS.props
index e472b5f1a8..d16c6803f4 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -1,4 +1,4 @@
-<Project>
+<Project>
   <PropertyGroup>
     <LangVersion>8.0</LangVersion>
     <ProjectTypeGuids>{FEACFBD2-3405-455C-9665-78FE426C6842};{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}</ProjectTypeGuids>
@@ -11,6 +11,7 @@
     <MtouchVerbosity></MtouchVerbosity>
     <CodesignKey>iPhone Developer</CodesignKey>
     <AutoGenerateBindingRedirects>true</AutoGenerateBindingRedirects>
+    <EnforceCodeStyleInBuild>false</EnforceCodeStyleInBuild>
   </PropertyGroup>
   <PropertyGroup>
     <!-- Generated via osu.Framework.iOS/generate-symbol-strip-flags.sh -->

From 813d6fed487d06959f18f19e982639e08a95d9dc Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 4 May 2022 09:00:54 +0300
Subject: [PATCH 4473/5547] Split activation keybind to separate
 increase/decrease keybinds

---
 .../Input/Bindings/GlobalActionContainer.cs   | 10 +++--
 .../GlobalActionKeyBindingStrings.cs          |  9 ++++-
 .../Edit/DistancedHitObjectComposer.cs        | 40 +++++++++++--------
 3 files changed, 38 insertions(+), 21 deletions(-)

diff --git a/osu.Game/Input/Bindings/GlobalActionContainer.cs b/osu.Game/Input/Bindings/GlobalActionContainer.cs
index 5656c79975..3e7051cbf5 100644
--- a/osu.Game/Input/Bindings/GlobalActionContainer.cs
+++ b/osu.Game/Input/Bindings/GlobalActionContainer.cs
@@ -79,7 +79,8 @@ namespace osu.Game.Input.Bindings
             new KeyBinding(new[] { InputKey.F5 }, GlobalAction.EditorTestGameplay),
             new KeyBinding(new[] { InputKey.Control, InputKey.H }, GlobalAction.EditorFlipHorizontally),
             new KeyBinding(new[] { InputKey.Control, InputKey.J }, GlobalAction.EditorFlipVertically),
-            new KeyBinding(new[] { InputKey.Control, InputKey.Alt }, GlobalAction.EditorDistanceSpacing),
+            new KeyBinding(new[] { InputKey.Control, InputKey.Alt, InputKey.MouseWheelDown }, GlobalAction.EditorDecreaseDistanceSpacing),
+            new KeyBinding(new[] { InputKey.Control, InputKey.Alt, InputKey.MouseWheelUp }, GlobalAction.EditorIncreaseDistanceSpacing),
         };
 
         public IEnumerable<KeyBinding> InGameKeyBindings => new[]
@@ -303,7 +304,10 @@ namespace osu.Game.Input.Bindings
         [LocalisableDescription(typeof(GlobalActionKeyBindingStrings), nameof(GlobalActionKeyBindingStrings.EditorFlipVertically))]
         EditorFlipVertically,
 
-        [LocalisableDescription(typeof(GlobalActionKeyBindingStrings), nameof(GlobalActionKeyBindingStrings.EditorDistanceSpacing))]
-        EditorDistanceSpacing,
+        [LocalisableDescription(typeof(GlobalActionKeyBindingStrings), nameof(GlobalActionKeyBindingStrings.EditorIncreaseDistanceSpacing))]
+        EditorIncreaseDistanceSpacing,
+
+        [LocalisableDescription(typeof(GlobalActionKeyBindingStrings), nameof(GlobalActionKeyBindingStrings.EditorDecreaseDistanceSpacing))]
+        EditorDecreaseDistanceSpacing,
     }
 }
diff --git a/osu.Game/Localisation/GlobalActionKeyBindingStrings.cs b/osu.Game/Localisation/GlobalActionKeyBindingStrings.cs
index 73cc7546ab..5086e7f4c7 100644
--- a/osu.Game/Localisation/GlobalActionKeyBindingStrings.cs
+++ b/osu.Game/Localisation/GlobalActionKeyBindingStrings.cs
@@ -240,9 +240,14 @@ namespace osu.Game.Localisation
         public static LocalisableString EditorFlipVertically => new TranslatableString(getKey(@"editor_flip_vertically"), @"Flip selection vertically");
 
         /// <summary>
-        /// "Distance grid spacing (hold)"
+        /// "Increase distance grid spacing"
         /// </summary>
-        public static LocalisableString EditorDistanceSpacing => new TranslatableString(getKey(@"editor_distance_spacing"), @"Distance grid spacing (hold)");
+        public static LocalisableString EditorIncreaseDistanceSpacing => new TranslatableString(getKey(@"editor_increase_distance_spacing"), @"Increase distance grid spacing");
+
+        /// <summary>
+        /// "Decrease distance grid spacing"
+        /// </summary>
+        public static LocalisableString EditorDecreaseDistanceSpacing => new TranslatableString(getKey(@"editor_decrease_distance_spacing"), @"Decrease distance grid spacing");
 
         /// <summary>
         /// "Toggle skin editor"
diff --git a/osu.Game/Rulesets/Edit/DistancedHitObjectComposer.cs b/osu.Game/Rulesets/Edit/DistancedHitObjectComposer.cs
index 1a4ea845d0..e6bc36622f 100644
--- a/osu.Game/Rulesets/Edit/DistancedHitObjectComposer.cs
+++ b/osu.Game/Rulesets/Edit/DistancedHitObjectComposer.cs
@@ -20,7 +20,7 @@ namespace osu.Game.Rulesets.Edit
     /// </summary>
     /// <typeparam name="TObject">The base type of supported objects.</typeparam>
     [Cached(typeof(IDistanceSnapProvider))]
-    public abstract class DistancedHitObjectComposer<TObject> : HitObjectComposer<TObject>, IDistanceSnapProvider, IKeyBindingHandler<GlobalAction>
+    public abstract class DistancedHitObjectComposer<TObject> : HitObjectComposer<TObject>, IDistanceSnapProvider, IScrollBindingHandler<GlobalAction>
         where TObject : HitObject
     {
         protected Bindable<double> DistanceSpacingMultiplier { get; } = new BindableDouble(1.0)
@@ -35,7 +35,6 @@ namespace osu.Game.Rulesets.Edit
         protected ExpandingToolboxContainer RightSideToolboxContainer { get; private set; }
 
         private ExpandableSlider<double, SizeSlider<double>> distanceSpacingSlider;
-        private bool distanceSpacingScrollActive;
 
         protected DistancedHitObjectComposer(Ruleset ruleset)
             : base(ruleset)
@@ -79,11 +78,11 @@ namespace osu.Game.Rulesets.Edit
 
         public bool OnPressed(KeyBindingPressEvent<GlobalAction> e)
         {
-            if (!DistanceSpacingMultiplier.Disabled && e.Action == GlobalAction.EditorDistanceSpacing)
+            switch (e.Action)
             {
-                RightSideToolboxContainer.Expanded.Value = true;
-                distanceSpacingScrollActive = true;
-                return true;
+                case GlobalAction.EditorIncreaseDistanceSpacing:
+                case GlobalAction.EditorDecreaseDistanceSpacing:
+                    return adjustDistanceSpacing(e.Action, 0.1f);
             }
 
             return false;
@@ -91,22 +90,31 @@ namespace osu.Game.Rulesets.Edit
 
         public void OnReleased(KeyBindingReleaseEvent<GlobalAction> e)
         {
-            if (!DistanceSpacingMultiplier.Disabled && e.Action == GlobalAction.EditorDistanceSpacing)
-            {
-                RightSideToolboxContainer.Expanded.Value = false;
-                distanceSpacingScrollActive = false;
-            }
         }
 
-        protected override bool OnScroll(ScrollEvent e)
+        public bool OnScroll(KeyBindingScrollEvent<GlobalAction> e)
         {
-            if (distanceSpacingScrollActive)
+            switch (e.Action)
             {
-                DistanceSpacingMultiplier.Value += e.ScrollDelta.Y * (e.IsPrecise ? 0.01f : 0.1f);
-                return true;
+                case GlobalAction.EditorIncreaseDistanceSpacing:
+                case GlobalAction.EditorDecreaseDistanceSpacing:
+                    return adjustDistanceSpacing(e.Action, e.IsPrecise ? 0.01f : 0.1f);
             }
 
-            return base.OnScroll(e);
+            return false;
+        }
+
+        private bool adjustDistanceSpacing(GlobalAction action, float amount)
+        {
+            if (DistanceSpacingMultiplier.Disabled)
+                return false;
+
+            if (action == GlobalAction.EditorIncreaseDistanceSpacing)
+                DistanceSpacingMultiplier.Value += amount;
+            else if (action == GlobalAction.EditorDecreaseDistanceSpacing)
+                DistanceSpacingMultiplier.Value -= amount;
+
+            return true;
         }
 
         public virtual float GetBeatSnapDistanceAt(HitObject referenceObject)

From a17bbd62b7d05491a1ed2d5575819feb0c7fcdc5 Mon Sep 17 00:00:00 2001
From: Huo Yaoyuan <huoyaoyuan@hotmail.com>
Date: Wed, 4 May 2022 14:06:01 +0800
Subject: [PATCH 4474/5547] Disable EnforceCodeStyleInBuild in Xamarin CI run

---
 .github/workflows/ci.yml | 4 ++--
 Directory.Build.props    | 4 ++--
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index f2066f27de..b4d7f894d4 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -128,7 +128,7 @@ jobs:
       # cannot accept .sln(f) files as arguments.
       # Build just the main game for now.
       - name: Build
-        run: msbuild osu.Android/osu.Android.csproj /restore /p:Configuration=Debug
+        run: msbuild osu.Android/osu.Android.csproj /restore /p:Configuration=Debug /p:EnforceCodeStyleInBuild=false
 
   build-only-ios:
     name: Build only (iOS)
@@ -147,4 +147,4 @@ jobs:
       # cannot accept .sln(f) files as arguments.
       # Build just the main game for now.
       - name: Build
-        run: msbuild osu.iOS/osu.iOS.csproj /restore /p:Configuration=Debug
\ No newline at end of file
+        run: msbuild osu.iOS/osu.iOS.csproj /restore /p:Configuration=Debug /p:EnforceCodeStyleInBuild=false
diff --git a/Directory.Build.props b/Directory.Build.props
index f3ddc68838..65ffe02584 100644
--- a/Directory.Build.props
+++ b/Directory.Build.props
@@ -1,4 +1,4 @@
-<!-- Contains required properties for osu!framework projects. -->
+<!-- Contains required properties for osu!framework projects. -->
 <Project>
   <PropertyGroup Label="C#">
     <LangVersion>8.0</LangVersion>
@@ -20,7 +20,7 @@
     <AdditionalFiles Include="$(MSBuildThisFileDirectory)CodeAnalysis\BannedSymbols.txt" />
   </ItemGroup>
   <PropertyGroup Label="Code Analysis">
-    <EnforceCodeStyleInBuild>true</EnforceCodeStyleInBuild>
+    <EnforceCodeStyleInBuild Condition="'$(EnforceCodeStyleInBuild)' == ''">true</EnforceCodeStyleInBuild>
     <CodeAnalysisRuleSet>$(MSBuildThisFileDirectory)CodeAnalysis\osu.ruleset</CodeAnalysisRuleSet>
   </PropertyGroup>
   <PropertyGroup Label="Documentation">

From 504ca5be31d011b8909ea05518265529758a63fb Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 4 May 2022 09:51:53 +0300
Subject: [PATCH 4475/5547] Fix scrolling no longer adjusting distance spacing
 by amount

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

diff --git a/osu.Game/Rulesets/Edit/DistancedHitObjectComposer.cs b/osu.Game/Rulesets/Edit/DistancedHitObjectComposer.cs
index e6bc36622f..66a78640c6 100644
--- a/osu.Game/Rulesets/Edit/DistancedHitObjectComposer.cs
+++ b/osu.Game/Rulesets/Edit/DistancedHitObjectComposer.cs
@@ -98,7 +98,7 @@ namespace osu.Game.Rulesets.Edit
             {
                 case GlobalAction.EditorIncreaseDistanceSpacing:
                 case GlobalAction.EditorDecreaseDistanceSpacing:
-                    return adjustDistanceSpacing(e.Action, e.IsPrecise ? 0.01f : 0.1f);
+                    return adjustDistanceSpacing(e.Action, e.ScrollAmount * (e.IsPrecise ? 0.01f : 0.1f));
             }
 
             return false;

From 732739715aee8149791a0f2bc35fa4b5d14ba3c7 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 4 May 2022 16:31:20 +0900
Subject: [PATCH 4476/5547] Remove "grid" from strings

---
 osu.Game/Localisation/GlobalActionKeyBindingStrings.cs | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Localisation/GlobalActionKeyBindingStrings.cs b/osu.Game/Localisation/GlobalActionKeyBindingStrings.cs
index 5086e7f4c7..58afb284b5 100644
--- a/osu.Game/Localisation/GlobalActionKeyBindingStrings.cs
+++ b/osu.Game/Localisation/GlobalActionKeyBindingStrings.cs
@@ -240,14 +240,14 @@ namespace osu.Game.Localisation
         public static LocalisableString EditorFlipVertically => new TranslatableString(getKey(@"editor_flip_vertically"), @"Flip selection vertically");
 
         /// <summary>
-        /// "Increase distance grid spacing"
+        /// "Increase distance spacing"
         /// </summary>
-        public static LocalisableString EditorIncreaseDistanceSpacing => new TranslatableString(getKey(@"editor_increase_distance_spacing"), @"Increase distance grid spacing");
+        public static LocalisableString EditorIncreaseDistanceSpacing => new TranslatableString(getKey(@"editor_increase_distance_spacing"), @"Increase distance spacing");
 
         /// <summary>
-        /// "Decrease distance grid spacing"
+        /// "Decrease distance spacing"
         /// </summary>
-        public static LocalisableString EditorDecreaseDistanceSpacing => new TranslatableString(getKey(@"editor_decrease_distance_spacing"), @"Decrease distance grid spacing");
+        public static LocalisableString EditorDecreaseDistanceSpacing => new TranslatableString(getKey(@"editor_decrease_distance_spacing"), @"Decrease distance spacing");
 
         /// <summary>
         /// "Toggle skin editor"

From a66743266f6460dc7c50ad873e2b231a813a8d0b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 4 May 2022 17:20:58 +0900
Subject: [PATCH 4477/5547] Remove unused `ScrollingToolboxGroup` class

---
 .../Rulesets/Edit/ScrollingToolboxGroup.cs    | 34 -------------------
 1 file changed, 34 deletions(-)
 delete mode 100644 osu.Game/Rulesets/Edit/ScrollingToolboxGroup.cs

diff --git a/osu.Game/Rulesets/Edit/ScrollingToolboxGroup.cs b/osu.Game/Rulesets/Edit/ScrollingToolboxGroup.cs
deleted file mode 100644
index 98e026c49a..0000000000
--- a/osu.Game/Rulesets/Edit/ScrollingToolboxGroup.cs
+++ /dev/null
@@ -1,34 +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.Containers;
-using osu.Game.Graphics.Containers;
-
-namespace osu.Game.Rulesets.Edit
-{
-    public class ScrollingToolboxGroup : EditorToolboxGroup
-    {
-        protected readonly OsuScrollContainer Scroll;
-
-        protected readonly FillFlowContainer FillFlow;
-
-        protected override Container<Drawable> Content { get; }
-
-        public ScrollingToolboxGroup(string title, float scrollAreaHeight)
-            : base(title)
-        {
-            base.Content.Add(Scroll = new OsuScrollContainer
-            {
-                RelativeSizeAxes = Axes.X,
-                Height = scrollAreaHeight,
-                Child = Content = FillFlow = new FillFlowContainer
-                {
-                    RelativeSizeAxes = Axes.X,
-                    AutoSizeAxes = Axes.Y,
-                    Direction = FillDirection.Vertical,
-                },
-            });
-        }
-    }
-}

From b325f0ee0b3ebc286f13ba82d95e590707ece455 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 4 May 2022 17:41:29 +0900
Subject: [PATCH 4478/5547] Combine editor toolbox container implementation and
 fix input blocking

Until now, toolbox scroll areas would block input from arriving behind
them, even when no visible element was clicked.

In addition, clicking on a button inside a toolbox would still send a
`MouseDown` event to things behind it. Specifically, the editor's
`HitObjectComposer` would receive these events and also place objects
when the user does not expect them to be placed.

This fixes another regression that occurred due to `ScrollContainer`s no
longer blocking input theirselves.
---
 .../Edit/DistancedHitObjectComposer.cs        | 19 ++---------
 .../Edit/ExpandingToolboxContainer.cs         | 34 +++++++++++++++++++
 osu.Game/Rulesets/Edit/HitObjectComposer.cs   | 16 ++-------
 3 files changed, 38 insertions(+), 31 deletions(-)
 create mode 100644 osu.Game/Rulesets/Edit/ExpandingToolboxContainer.cs

diff --git a/osu.Game/Rulesets/Edit/DistancedHitObjectComposer.cs b/osu.Game/Rulesets/Edit/DistancedHitObjectComposer.cs
index 66a78640c6..370e8ccbda 100644
--- a/osu.Game/Rulesets/Edit/DistancedHitObjectComposer.cs
+++ b/osu.Game/Rulesets/Edit/DistancedHitObjectComposer.cs
@@ -6,12 +6,10 @@ using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Input.Bindings;
 using osu.Framework.Input.Events;
-using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Input.Bindings;
 using osu.Game.Overlays.Settings.Sections;
 using osu.Game.Rulesets.Objects;
-using osuTK;
 
 namespace osu.Game.Rulesets.Edit
 {
@@ -44,8 +42,9 @@ namespace osu.Game.Rulesets.Edit
         [BackgroundDependencyLoader]
         private void load()
         {
-            AddInternal(RightSideToolboxContainer = new ExpandingToolboxContainer
+            AddInternal(RightSideToolboxContainer = new ExpandingToolboxContainer(130, 250)
             {
+                Padding = new MarginPadding { Right = 10 },
                 Alpha = DistanceSpacingMultiplier.Disabled ? 0 : 1,
                 Anchor = Anchor.TopRight,
                 Origin = Anchor.TopRight,
@@ -154,19 +153,5 @@ namespace osu.Game.Rulesets.Edit
 
             return DurationToDistance(referenceObject, snappedEndTime - startTime);
         }
-
-        protected class ExpandingToolboxContainer : ExpandingContainer
-        {
-            protected override double HoverExpansionDelay => 250;
-
-            public ExpandingToolboxContainer()
-                : base(130, 250)
-            {
-                RelativeSizeAxes = Axes.Y;
-                Padding = new MarginPadding { Left = 10 };
-
-                FillFlow.Spacing = new Vector2(10);
-            }
-        }
     }
 }
diff --git a/osu.Game/Rulesets/Edit/ExpandingToolboxContainer.cs b/osu.Game/Rulesets/Edit/ExpandingToolboxContainer.cs
new file mode 100644
index 0000000000..e807dbd482
--- /dev/null
+++ b/osu.Game/Rulesets/Edit/ExpandingToolboxContainer.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.Linq;
+using osu.Framework.Graphics;
+using osu.Framework.Input.Events;
+using osu.Game.Graphics.Containers;
+using osuTK;
+
+namespace osu.Game.Rulesets.Edit
+{
+    public class ExpandingToolboxContainer : ExpandingContainer
+    {
+        protected override double HoverExpansionDelay => 250;
+
+        public ExpandingToolboxContainer(float contractedWidth, float expandedWidth)
+            : base(contractedWidth, expandedWidth)
+        {
+            RelativeSizeAxes = Axes.Y;
+
+            FillFlow.Spacing = new Vector2(10);
+        }
+
+        protected override bool ReceivePositionalInputAtSubTree(Vector2 screenSpacePos) => base.ReceivePositionalInputAtSubTree(screenSpacePos) && anyToolboxHovered(screenSpacePos);
+
+        public override bool ReceivePositionalInputAt(Vector2 screenSpacePos) => base.ReceivePositionalInputAt(screenSpacePos) && anyToolboxHovered(screenSpacePos);
+
+        private bool anyToolboxHovered(Vector2 screenSpacePos) => FillFlow.Children.Any(d => d.ScreenSpaceDrawQuad.Contains(screenSpacePos));
+
+        protected override bool OnMouseDown(MouseDownEvent e) => true;
+
+        protected override bool OnClick(ClickEvent e) => true;
+    }
+}
diff --git a/osu.Game/Rulesets/Edit/HitObjectComposer.cs b/osu.Game/Rulesets/Edit/HitObjectComposer.cs
index a235a5bc60..1c388fe68f 100644
--- a/osu.Game/Rulesets/Edit/HitObjectComposer.cs
+++ b/osu.Game/Rulesets/Edit/HitObjectComposer.cs
@@ -13,7 +13,6 @@ using osu.Framework.Input;
 using osu.Framework.Input.Events;
 using osu.Framework.Logging;
 using osu.Game.Beatmaps;
-using osu.Game.Graphics.Containers;
 using osu.Game.Rulesets.Configuration;
 using osu.Game.Rulesets.Edit.Tools;
 using osu.Game.Rulesets.Mods;
@@ -115,8 +114,9 @@ namespace osu.Game.Rulesets.Edit
                                               .WithChild(BlueprintContainer = CreateBlueprintContainer())
                     }
                 },
-                new LeftToolboxFlow
+                new ExpandingToolboxContainer(80, 200)
                 {
+                    Padding = new MarginPadding { Left = 10 },
                     Children = new Drawable[]
                     {
                         new EditorToolboxGroup("toolbox (1-9)")
@@ -382,18 +382,6 @@ namespace osu.Game.Rulesets.Edit
         }
 
         #endregion
-
-        private class LeftToolboxFlow : ExpandingButtonContainer
-        {
-            public LeftToolboxFlow()
-                : base(80, 200)
-            {
-                RelativeSizeAxes = Axes.Y;
-                Padding = new MarginPadding { Right = 10 };
-
-                FillFlow.Spacing = new Vector2(10);
-            }
-        }
     }
 
     /// <summary>

From 0b8fd2e39f9c4e93d91c43f93da1c08e27244f33 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 4 May 2022 11:41:33 +0300
Subject: [PATCH 4479/5547] Improve distance spacing toast inline with key
 binding changes

---
 .../Edit/DistancedHitObjectComposer.cs        | 21 ++++++++++++++++---
 1 file changed, 18 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Rulesets/Edit/DistancedHitObjectComposer.cs b/osu.Game/Rulesets/Edit/DistancedHitObjectComposer.cs
index afd6909874..466b6cba4b 100644
--- a/osu.Game/Rulesets/Edit/DistancedHitObjectComposer.cs
+++ b/osu.Game/Rulesets/Edit/DistancedHitObjectComposer.cs
@@ -3,11 +3,13 @@
 
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
+using osu.Framework.Extensions;
 using osu.Framework.Extensions.LocalisationExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Input.Bindings;
 using osu.Framework.Input.Events;
 using osu.Framework.Localisation;
+using osu.Game.Configuration;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Input.Bindings;
@@ -80,7 +82,7 @@ namespace osu.Game.Rulesets.Edit
                     distanceSpacingSlider.ExpandedLabelText = $"Distance Spacing ({v.NewValue:0.##x})";
 
                     if (v.NewValue != v.OldValue)
-                        onScreenDisplay?.Display(new DistanceSpacingToast(v.NewValue.ToLocalisableString(@"0.##x")));
+                        onScreenDisplay?.Display(new DistanceSpacingToast(v.NewValue.ToLocalisableString(@"0.##x"), v));
 
                     EditorBeatmap.BeatmapInfo.DistanceSpacing = v.NewValue;
                 }, true);
@@ -182,10 +184,23 @@ namespace osu.Game.Rulesets.Edit
 
         private class DistanceSpacingToast : Toast
         {
-            public DistanceSpacingToast(LocalisableString value)
-                : base("Distance Spacing", value, string.Empty)
+            private readonly ValueChangedEvent<double> change;
+
+            public DistanceSpacingToast(LocalisableString value, ValueChangedEvent<double> change)
+                : base(getAction(change).GetLocalisableDescription(), value, string.Empty)
             {
+                this.change = change;
             }
+
+            [BackgroundDependencyLoader]
+            private void load(OsuConfigManager config)
+            {
+                ShortcutText.Text = config.LookupKeyBindings(getAction(change));
+            }
+
+            private static GlobalAction getAction(ValueChangedEvent<double> change) => change.NewValue - change.OldValue > 0
+                ? GlobalAction.EditorIncreaseDistanceSpacing
+                : GlobalAction.EditorDecreaseDistanceSpacing;
         }
     }
 }

From f899c3e68fa5ad4eb53196de2dd509fd3d9d46b8 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 4 May 2022 17:56:38 +0900
Subject: [PATCH 4480/5547] Add test coverage of circle placement around editor
 toolboxes

---
 .../Editing/TestSceneHitObjectComposer.cs     | 60 +++++++++++++++++++
 1 file changed, 60 insertions(+)

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneHitObjectComposer.cs b/osu.Game.Tests/Visual/Editing/TestSceneHitObjectComposer.cs
index ae1b691767..231a1f408f 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneHitObjectComposer.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneHitObjectComposer.cs
@@ -19,6 +19,7 @@ using osu.Game.Rulesets.Osu.Edit;
 using osu.Game.Rulesets.Osu.Objects;
 using osu.Game.Screens.Edit;
 using osu.Game.Screens.Edit.Components.RadioButtons;
+using osu.Game.Screens.Edit.Components.TernaryButtons;
 using osu.Game.Screens.Edit.Compose.Components;
 using osuTK;
 using osuTK.Input;
@@ -87,6 +88,65 @@ namespace osu.Game.Tests.Visual.Editing
             AddAssert("Tool changed", () => hitObjectComposer.ChildrenOfType<ComposeBlueprintContainer>().First().CurrentTool is HitCircleCompositionTool);
         }
 
+        [Test]
+        public void TestPlacementFailsWhenClickingButton()
+        {
+            AddStep("clear all control points and hitobjects", () =>
+            {
+                editorBeatmap.ControlPointInfo.Clear();
+                editorBeatmap.Clear();
+            });
+
+            AddStep("Add timing point", () => editorBeatmap.ControlPointInfo.Add(0, new TimingControlPoint()));
+
+            AddStep("Change to hitcircle", () => hitObjectComposer.ChildrenOfType<EditorRadioButton>().First(d => d.Button.Label == "HitCircle").TriggerClick());
+
+            AddStep("move mouse to overlapping toggle button", () =>
+            {
+                var playfield = hitObjectComposer.Playfield.ScreenSpaceDrawQuad;
+                var button = hitObjectComposer
+                             .ChildrenOfType<ExpandingToolboxContainer>().First()
+                             .ChildrenOfType<DrawableTernaryButton>().First(b => playfield.Contains(b.ScreenSpaceDrawQuad.Centre));
+
+                InputManager.MoveMouseTo(button);
+            });
+
+            AddAssert("no circles placed", () => editorBeatmap.HitObjects.Count == 0);
+
+            AddStep("attempt place circle", () => InputManager.Click(MouseButton.Left));
+
+            AddAssert("no circles placed", () => editorBeatmap.HitObjects.Count == 0);
+        }
+
+        [Test]
+        public void TestPlacementWithinToolboxScrollArea()
+        {
+            AddStep("clear all control points and hitobjects", () =>
+            {
+                editorBeatmap.ControlPointInfo.Clear();
+                editorBeatmap.Clear();
+            });
+
+            AddStep("Add timing point", () => editorBeatmap.ControlPointInfo.Add(0, new TimingControlPoint()));
+
+            AddStep("Change to hitcircle", () => hitObjectComposer.ChildrenOfType<EditorRadioButton>().First(d => d.Button.Label == "HitCircle").TriggerClick());
+
+            AddStep("move mouse to scroll area", () =>
+            {
+                // Specifically wanting to test the area of overlap between the left expanding toolbox container
+                // and the playfield/composer.
+                var scrollArea = hitObjectComposer.ChildrenOfType<ExpandingToolboxContainer>().First().ScreenSpaceDrawQuad;
+                var playfield = hitObjectComposer.Playfield.ScreenSpaceDrawQuad;
+                InputManager.MoveMouseTo(new Vector2(scrollArea.TopLeft.X, playfield.Centre.Y));
+            });
+
+            AddAssert("no circles placed", () => editorBeatmap.HitObjects.Count == 0);
+
+            AddStep("place circle", () => InputManager.Click(MouseButton.Left));
+
+            AddAssert("circle placed", () => editorBeatmap.HitObjects.Count == 1);
+        }
+
         [Test]
         public void TestDistanceSpacingHotkeys()
         {

From f5d4f02200aa1118485de0eddfa977aa4ec09325 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 4 May 2022 11:59:29 +0300
Subject: [PATCH 4481/5547] Use `ToUpper` for key binding text

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

diff --git a/osu.Game/Rulesets/Edit/DistancedHitObjectComposer.cs b/osu.Game/Rulesets/Edit/DistancedHitObjectComposer.cs
index 466b6cba4b..3ca443cc85 100644
--- a/osu.Game/Rulesets/Edit/DistancedHitObjectComposer.cs
+++ b/osu.Game/Rulesets/Edit/DistancedHitObjectComposer.cs
@@ -195,7 +195,7 @@ namespace osu.Game.Rulesets.Edit
             [BackgroundDependencyLoader]
             private void load(OsuConfigManager config)
             {
-                ShortcutText.Text = config.LookupKeyBindings(getAction(change));
+                ShortcutText.Text = config.LookupKeyBindings(getAction(change)).ToUpper();
             }
 
             private static GlobalAction getAction(ValueChangedEvent<double> change) => change.NewValue - change.OldValue > 0

From 4e0f899159aebc9b5de32b04faefc7f98f8cc654 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 4 May 2022 18:13:30 +0900
Subject: [PATCH 4482/5547] Rename value changed variable

---
 osu.Game/Rulesets/Edit/DistancedHitObjectComposer.cs | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Rulesets/Edit/DistancedHitObjectComposer.cs b/osu.Game/Rulesets/Edit/DistancedHitObjectComposer.cs
index 3ca443cc85..081610a62b 100644
--- a/osu.Game/Rulesets/Edit/DistancedHitObjectComposer.cs
+++ b/osu.Game/Rulesets/Edit/DistancedHitObjectComposer.cs
@@ -76,15 +76,15 @@ namespace osu.Game.Rulesets.Edit
             if (!DistanceSpacingMultiplier.Disabled)
             {
                 DistanceSpacingMultiplier.Value = EditorBeatmap.BeatmapInfo.DistanceSpacing;
-                DistanceSpacingMultiplier.BindValueChanged(v =>
+                DistanceSpacingMultiplier.BindValueChanged(multiplier =>
                 {
-                    distanceSpacingSlider.ContractedLabelText = $"D. S. ({v.NewValue:0.##x})";
-                    distanceSpacingSlider.ExpandedLabelText = $"Distance Spacing ({v.NewValue:0.##x})";
+                    distanceSpacingSlider.ContractedLabelText = $"D. S. ({multiplier.NewValue:0.##x})";
+                    distanceSpacingSlider.ExpandedLabelText = $"Distance Spacing ({multiplier.NewValue:0.##x})";
 
-                    if (v.NewValue != v.OldValue)
-                        onScreenDisplay?.Display(new DistanceSpacingToast(v.NewValue.ToLocalisableString(@"0.##x"), v));
+                    if (multiplier.NewValue != multiplier.OldValue)
+                        onScreenDisplay?.Display(new DistanceSpacingToast(multiplier.NewValue.ToLocalisableString(@"0.##x"), multiplier));
 
-                    EditorBeatmap.BeatmapInfo.DistanceSpacing = v.NewValue;
+                    EditorBeatmap.BeatmapInfo.DistanceSpacing = multiplier.NewValue;
                 }, true);
             }
         }

From a759e641ebf17f71cbd825491fb34fc95045f382 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 4 May 2022 11:56:29 +0200
Subject: [PATCH 4483/5547] Enforce composer aspect ratio to avoid depending on
 ambient window size

---
 osu.Game.Tests/Visual/Editing/TestSceneHitObjectComposer.cs | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneHitObjectComposer.cs b/osu.Game.Tests/Visual/Editing/TestSceneHitObjectComposer.cs
index 231a1f408f..fb179a448c 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneHitObjectComposer.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneHitObjectComposer.cs
@@ -71,6 +71,11 @@ namespace osu.Game.Tests.Visual.Editing
                 Child = editorBeatmapContainer = new EditorBeatmapContainer(Beatmap.Value)
                 {
                     Child = hitObjectComposer = new OsuHitObjectComposer(new OsuRuleset())
+                    {
+                        // force the composer to fully overlap the playfield area by setting a 4:3 aspect ratio.
+                        FillMode = FillMode.Fit,
+                        FillAspectRatio = 4 / 3f
+                    }
                 };
             });
         }

From 6380216263c0cff2c46417322362da11631aa63e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 4 May 2022 11:56:44 +0200
Subject: [PATCH 4484/5547] Nudge click location to avoid placement failures

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

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneHitObjectComposer.cs b/osu.Game.Tests/Visual/Editing/TestSceneHitObjectComposer.cs
index fb179a448c..c9d44fdab7 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneHitObjectComposer.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneHitObjectComposer.cs
@@ -142,7 +142,7 @@ namespace osu.Game.Tests.Visual.Editing
                 // and the playfield/composer.
                 var scrollArea = hitObjectComposer.ChildrenOfType<ExpandingToolboxContainer>().First().ScreenSpaceDrawQuad;
                 var playfield = hitObjectComposer.Playfield.ScreenSpaceDrawQuad;
-                InputManager.MoveMouseTo(new Vector2(scrollArea.TopLeft.X, playfield.Centre.Y));
+                InputManager.MoveMouseTo(new Vector2(scrollArea.TopLeft.X + 1, playfield.Centre.Y));
             });
 
             AddAssert("no circles placed", () => editorBeatmap.HitObjects.Count == 0);

From 2f12c7d9e1e9c1231c82c2bd4766f198dfa709a8 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 4 May 2022 19:09:22 +0900
Subject: [PATCH 4485/5547] Change `ChatTextBox` to not handle up/down arrows

---
 osu.Game/Online/Chat/StandAloneChatDisplay.cs | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/osu.Game/Online/Chat/StandAloneChatDisplay.cs b/osu.Game/Online/Chat/StandAloneChatDisplay.cs
index 6a7da52416..df210fcaf8 100644
--- a/osu.Game/Online/Chat/StandAloneChatDisplay.cs
+++ b/osu.Game/Online/Chat/StandAloneChatDisplay.cs
@@ -14,6 +14,7 @@ using osu.Game.Graphics.UserInterface;
 using osu.Game.Overlays.Chat;
 using osu.Game.Resources.Localisation.Web;
 using osuTK.Graphics;
+using osuTK.Input;
 
 namespace osu.Game.Online.Chat
 {
@@ -119,6 +120,20 @@ namespace osu.Game.Online.Chat
 
         public class ChatTextBox : FocusedTextBox
         {
+            protected override bool OnKeyDown(KeyDownEvent e)
+            {
+                // Chat text boxes are generally used in places where they retain focus, but shouldn't block interaction with other
+                // elements on the same screen.
+                switch (e.Key)
+                {
+                    case Key.Up:
+                    case Key.Down:
+                        return false;
+                }
+
+                return base.OnKeyDown(e);
+            }
+
             protected override void LoadComplete()
             {
                 base.LoadComplete();

From df1f4aecdceee273e3fbafbe7e7fa2c208e50419 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 4 May 2022 19:09:40 +0900
Subject: [PATCH 4486/5547] Add support for traversing playlist items using
 next/previous bindings

Addresses https://github.com/ppy/osu/discussions/18061.
---
 .../OnlinePlay/DrawableRoomPlaylist.cs        | 53 ++++++++++++++++++-
 .../Lounge/Components/RoomsContainer.cs       |  2 +-
 2 files changed, 53 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs
index 57bb4253cb..d1b21ca1b0 100644
--- a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs
+++ b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs
@@ -6,7 +6,10 @@ using System.Linq;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
+using osu.Framework.Input.Bindings;
+using osu.Framework.Input.Events;
 using osu.Game.Graphics.Containers;
+using osu.Game.Input.Bindings;
 using osu.Game.Online.Rooms;
 using osuTK;
 
@@ -15,7 +18,7 @@ namespace osu.Game.Screens.OnlinePlay
     /// <summary>
     /// A scrollable list which displays the <see cref="PlaylistItem"/>s in a <see cref="Room"/>.
     /// </summary>
-    public class DrawableRoomPlaylist : OsuRearrangeableListContainer<PlaylistItem>
+    public class DrawableRoomPlaylist : OsuRearrangeableListContainer<PlaylistItem>, IKeyBindingHandler<GlobalAction>
     {
         /// <summary>
         /// The currently-selected item. Selection is visually represented with a border.
@@ -169,5 +172,53 @@ namespace osu.Game.Screens.OnlinePlay
         });
 
         protected virtual DrawableRoomPlaylistItem CreateDrawablePlaylistItem(PlaylistItem item) => new DrawableRoomPlaylistItem(item);
+
+        #region Key selection logic (shared with BeatmapCarousel and RoomsContainer)
+
+        public bool OnPressed(KeyBindingPressEvent<GlobalAction> e)
+        {
+            switch (e.Action)
+            {
+                case GlobalAction.SelectNext:
+                    selectNext(1);
+                    return true;
+
+                case GlobalAction.SelectPrevious:
+                    selectNext(-1);
+                    return true;
+            }
+
+            return false;
+        }
+
+        public void OnReleased(KeyBindingReleaseEvent<GlobalAction> e)
+        {
+        }
+
+        private void selectNext(int direction)
+        {
+            if (SelectedItem.Disabled)
+                return;
+
+            var visibleRooms = ListContainer.AsEnumerable().Where(r => r.IsPresent);
+
+            PlaylistItem item;
+
+            if (SelectedItem.Value == null)
+                item = visibleRooms.FirstOrDefault()?.Model;
+            else
+            {
+                if (direction < 0)
+                    visibleRooms = visibleRooms.Reverse();
+
+                item = visibleRooms.SkipWhile(r => r.Model != SelectedItem.Value).Skip(1).FirstOrDefault()?.Model;
+            }
+
+            // we already have a valid selection only change selection if we still have a room to switch to.
+            if (item != null)
+                SelectedItem.Value = item;
+        }
+
+        #endregion
     }
 }
diff --git a/osu.Game/Screens/OnlinePlay/Lounge/Components/RoomsContainer.cs b/osu.Game/Screens/OnlinePlay/Lounge/Components/RoomsContainer.cs
index 175cd2c44e..9bcda90e6d 100644
--- a/osu.Game/Screens/OnlinePlay/Lounge/Components/RoomsContainer.cs
+++ b/osu.Game/Screens/OnlinePlay/Lounge/Components/RoomsContainer.cs
@@ -139,7 +139,7 @@ namespace osu.Game.Screens.OnlinePlay.Lounge.Components
             return base.OnClick(e);
         }
 
-        #region Key selection logic (shared with BeatmapCarousel)
+        #region Key selection logic (shared with BeatmapCarousel and RoomsContainer)
 
         public bool OnPressed(KeyBindingPressEvent<GlobalAction> e)
         {

From 3b04daddaa9ec3de743eb590003df4f4cc17592d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 4 May 2022 12:36:43 +0200
Subject: [PATCH 4487/5547] Fix self-reference in region name

---
 osu.Game/Screens/OnlinePlay/Lounge/Components/RoomsContainer.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Screens/OnlinePlay/Lounge/Components/RoomsContainer.cs b/osu.Game/Screens/OnlinePlay/Lounge/Components/RoomsContainer.cs
index 9bcda90e6d..74e4225f11 100644
--- a/osu.Game/Screens/OnlinePlay/Lounge/Components/RoomsContainer.cs
+++ b/osu.Game/Screens/OnlinePlay/Lounge/Components/RoomsContainer.cs
@@ -139,7 +139,7 @@ namespace osu.Game.Screens.OnlinePlay.Lounge.Components
             return base.OnClick(e);
         }
 
-        #region Key selection logic (shared with BeatmapCarousel and RoomsContainer)
+        #region Key selection logic (shared with BeatmapCarousel and DrawableRoomPlaylist)
 
         public bool OnPressed(KeyBindingPressEvent<GlobalAction> e)
         {

From 3eead5a6a39c3add1966990f280d655c2d71f3c2 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 4 May 2022 19:40:08 +0900
Subject: [PATCH 4488/5547] Rename `FlushAnimation` to `FlushPendingSelections`
 to better match purpose

---
 osu.Game/Overlays/Mods/ModColumn.cs        | 4 ++--
 osu.Game/Overlays/Mods/ModSection.cs       | 4 ++--
 osu.Game/Overlays/Mods/ModSelectOverlay.cs | 2 +-
 osu.Game/Overlays/Mods/ModSelectScreen.cs  | 2 +-
 4 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Overlays/Mods/ModColumn.cs b/osu.Game/Overlays/Mods/ModColumn.cs
index f9332dd28b..a792c0a81e 100644
--- a/osu.Game/Overlays/Mods/ModColumn.cs
+++ b/osu.Game/Overlays/Mods/ModColumn.cs
@@ -435,9 +435,9 @@ namespace osu.Game.Overlays.Mods
         }
 
         /// <summary>
-        /// Play out all remaining animations immediately to leave mods in a good (final) state.
+        /// Run any delayed selections (due to animation) immediately to leave mods in a good (final) state.
         /// </summary>
-        public void FlushAnimation()
+        public void FlushPendingSelections()
         {
             while (pendingSelectionOperations.TryDequeue(out var dequeuedAction))
                 dequeuedAction();
diff --git a/osu.Game/Overlays/Mods/ModSection.cs b/osu.Game/Overlays/Mods/ModSection.cs
index 5bf8cddd0c..a70191a864 100644
--- a/osu.Game/Overlays/Mods/ModSection.cs
+++ b/osu.Game/Overlays/Mods/ModSection.cs
@@ -250,9 +250,9 @@ namespace osu.Game.Overlays.Mods
         protected virtual ModButton CreateModButton(Mod mod) => new ModButton(mod);
 
         /// <summary>
-        /// Play out all remaining animations immediately to leave mods in a good (final) state.
+        /// Run any delayed selections (due to animation) immediately to leave mods in a good (final) state.
         /// </summary>
-        public void FlushAnimation()
+        public void FlushPendingSelections()
         {
             while (pendingSelectionOperations.TryDequeue(out var dequeuedAction))
                 dequeuedAction();
diff --git a/osu.Game/Overlays/Mods/ModSelectOverlay.cs b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
index 9ce79c25f7..cf57322594 100644
--- a/osu.Game/Overlays/Mods/ModSelectOverlay.cs
+++ b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
@@ -369,7 +369,7 @@ namespace osu.Game.Overlays.Mods
 
             foreach (var section in ModSectionsContainer)
             {
-                section.FlushAnimation();
+                section.FlushPendingSelections();
             }
 
             FooterContainer.MoveToX(content_width, WaveContainer.DISAPPEAR_DURATION, Easing.InSine);
diff --git a/osu.Game/Overlays/Mods/ModSelectScreen.cs b/osu.Game/Overlays/Mods/ModSelectScreen.cs
index bb12143d7c..8060bca65f 100644
--- a/osu.Game/Overlays/Mods/ModSelectScreen.cs
+++ b/osu.Game/Overlays/Mods/ModSelectScreen.cs
@@ -308,7 +308,7 @@ namespace osu.Game.Overlays.Mods
 
                 var column = columnFlow[i].Column;
 
-                column.FlushAnimation();
+                column.FlushPendingSelections();
                 column.TopLevelContent
                       .MoveToY(i % 2 == 0 ? -distance : distance, fade_out_duration, Easing.OutQuint)
                       .FadeOut(fade_out_duration, Easing.OutQuint);

From ec27fa8e857a357e7e07f205dcdc6c3891666416 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 4 May 2022 13:12:21 +0200
Subject: [PATCH 4489/5547] Add test coverage for keyboard selection

---
 .../TestSceneDrawableRoomPlaylist.cs          | 34 +++++++++++++++++++
 1 file changed, 34 insertions(+)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
index 76353323d6..566a8db608 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
@@ -147,6 +147,40 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddAssert("item 1 is selected", () => playlist.SelectedItem.Value == playlist.Items[1]);
         }
 
+        [Test]
+        public void KeyboardSelection()
+        {
+            createPlaylist(p => p.AllowSelection = true);
+
+            AddStep("press down", () => InputManager.Key(Key.Down));
+            AddAssert("item 0 is selected", () => playlist.SelectedItem.Value == playlist.Items[0]);
+
+            AddStep("press down", () => InputManager.Key(Key.Down));
+            AddAssert("item 1 is selected", () => playlist.SelectedItem.Value == playlist.Items[1]);
+
+            AddStep("press up", () => InputManager.Key(Key.Up));
+            AddAssert("item 0 is selected", () => playlist.SelectedItem.Value == playlist.Items[0]);
+
+            AddUntilStep("navigate to last item via keyboard", () =>
+            {
+                InputManager.Key(Key.Down);
+                return playlist.SelectedItem.Value == playlist.Items.Last();
+            });
+            AddAssert("last item is selected", () => playlist.SelectedItem.Value == playlist.Items.Last());
+            AddUntilStep("last item is scrolled into view", () =>
+            {
+                var drawableItem = playlist.ItemMap[playlist.Items.Last()];
+                return playlist.ScreenSpaceDrawQuad.Contains(drawableItem.ScreenSpaceDrawQuad.TopLeft)
+                       && playlist.ScreenSpaceDrawQuad.Contains(drawableItem.ScreenSpaceDrawQuad.BottomRight);
+            });
+
+            AddStep("press down", () => InputManager.Key(Key.Down));
+            AddAssert("last item is selected", () => playlist.SelectedItem.Value == playlist.Items.Last());
+
+            AddStep("press up", () => InputManager.Key(Key.Up));
+            AddAssert("second last item is selected", () => playlist.SelectedItem.Value == playlist.Items.Reverse().ElementAt(1));
+        }
+
         [Test]
         public void TestDownloadButtonHiddenWhenBeatmapExists()
         {

From 0405c1c34a18ca1c06be95fa5426f7deeeaf0daa Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 4 May 2022 13:15:26 +0200
Subject: [PATCH 4490/5547] Ensure selected playlist item is always scrolled
 into view

---
 .../Screens/OnlinePlay/DrawableRoomPlaylist.cs   | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs
index d1b21ca1b0..fe654c4ab8 100644
--- a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs
+++ b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs
@@ -2,6 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
+using System.Diagnostics;
 using System.Linq;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
@@ -173,6 +174,21 @@ namespace osu.Game.Screens.OnlinePlay
 
         protected virtual DrawableRoomPlaylistItem CreateDrawablePlaylistItem(PlaylistItem item) => new DrawableRoomPlaylistItem(item);
 
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            SelectedItem.BindValueChanged(_ => scrollToSelection(), true);
+        }
+
+        private void scrollToSelection()
+        {
+            if (SelectedItem.Value == null) return;
+
+            Debug.Assert(ItemMap.TryGetValue(SelectedItem.Value, out var drawableItem));
+            ScrollContainer.ScrollIntoView(drawableItem);
+        }
+
         #region Key selection logic (shared with BeatmapCarousel and RoomsContainer)
 
         public bool OnPressed(KeyBindingPressEvent<GlobalAction> e)

From cf220f171b22ac1a65e65c91daa9b35499f5bea3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 4 May 2022 20:14:30 +0900
Subject: [PATCH 4491/5547] Add test coverage of cross-thread transforms if a
 dialog is pushed too early

---
 .../UserInterface/TestSceneDialogOverlay.cs   | 60 ++++++++++++++++---
 1 file changed, 51 insertions(+), 9 deletions(-)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneDialogOverlay.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneDialogOverlay.cs
index 405461eec8..aecb3f6c71 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneDialogOverlay.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneDialogOverlay.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.Threading;
 using NUnit.Framework;
+using osu.Framework.Allocation;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Sprites;
-using osu.Framework.Testing;
 using osu.Game.Overlays;
 using osu.Game.Overlays.Dialog;
 
@@ -15,15 +17,11 @@ namespace osu.Game.Tests.Visual.UserInterface
     {
         private DialogOverlay overlay;
 
-        [SetUpSteps]
-        public void SetUpSteps()
-        {
-            AddStep("create dialog overlay", () => Child = overlay = new DialogOverlay());
-        }
-
         [Test]
         public void TestBasic()
         {
+            AddStep("create dialog overlay", () => Child = overlay = new DialogOverlay());
+
             TestPopupDialog firstDialog = null;
             TestPopupDialog secondDialog = null;
 
@@ -37,12 +35,12 @@ namespace osu.Game.Tests.Visual.UserInterface
                     new PopupDialogOkButton
                     {
                         Text = @"I never want to see this again.",
-                        Action = () => System.Console.WriteLine(@"OK"),
+                        Action = () => Console.WriteLine(@"OK"),
                     },
                     new PopupDialogCancelButton
                     {
                         Text = @"Firetruck, I still want quick ranks!",
-                        Action = () => System.Console.WriteLine(@"Cancel"),
+                        Action = () => Console.WriteLine(@"Cancel"),
                     },
                 },
             }));
@@ -87,9 +85,51 @@ namespace osu.Game.Tests.Visual.UserInterface
             AddAssert("first dialog is not part of hierarchy", () => firstDialog.Parent == null);
         }
 
+        [Test]
+        public void TestPushBeforeLoad()
+        {
+            PopupDialog dialog = null;
+
+            AddStep("create dialog overlay", () => overlay = new SlowLoadingDialogOverlay());
+
+            AddStep("start loading overlay", () => LoadComponentAsync(overlay, Add));
+
+            AddStep("push dialog before loaded", () =>
+            {
+                overlay.Push(dialog = new TestPopupDialog
+                {
+                    Buttons = new PopupDialogButton[]
+                    {
+                        new PopupDialogOkButton { Text = @"OK" },
+                    },
+                });
+            });
+
+            AddAssert("dialog not displayed", () => overlay.CurrentDialog != dialog);
+
+            AddStep("complete load", () => ((SlowLoadingDialogOverlay)overlay).LoadEvent.Set());
+
+            AddUntilStep("wait for load", () => overlay.IsLoaded);
+
+            AddAssert("dialog displayed", () => overlay.CurrentDialog == dialog);
+        }
+
+        public class SlowLoadingDialogOverlay : DialogOverlay
+        {
+            public ManualResetEventSlim LoadEvent = new ManualResetEventSlim();
+
+            [BackgroundDependencyLoader]
+            private void load()
+            {
+                LoadEvent.Wait(10000);
+            }
+        }
+
         [Test]
         public void TestDismissBeforePush()
         {
+            AddStep("create dialog overlay", () => Child = overlay = new DialogOverlay());
+
             TestPopupDialog testDialog = null;
             AddStep("dismissed dialog push", () =>
             {
@@ -106,6 +146,8 @@ namespace osu.Game.Tests.Visual.UserInterface
         [Test]
         public void TestDismissBeforePushViaButtonPress()
         {
+            AddStep("create dialog overlay", () => Child = overlay = new DialogOverlay());
+
             TestPopupDialog testDialog = null;
             AddStep("dismissed dialog push", () =>
             {

From 383245f43afec71c7e5d44102c04395032a582e0 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 4 May 2022 20:22:52 +0900
Subject: [PATCH 4492/5547] Fix dialoged pushed to `DialogOverlay` too early
 potentially doing cross-thread transforms

As seen at https://github.com/ppy/osu/runs/6287700705?check_suite_focus=true.
---
 osu.Game/Overlays/DialogOverlay.cs | 20 ++++++++++++--------
 1 file changed, 12 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Overlays/DialogOverlay.cs b/osu.Game/Overlays/DialogOverlay.cs
index 15d89a561a..0699c69691 100644
--- a/osu.Game/Overlays/DialogOverlay.cs
+++ b/osu.Game/Overlays/DialogOverlay.cs
@@ -47,6 +47,12 @@ namespace osu.Game.Overlays
 
         public void Push(PopupDialog dialog)
         {
+            if (!IsLoaded)
+            {
+                Schedule(() => Push(dialog));
+                return;
+            }
+
             if (dialog == CurrentDialog || dialog.State.Value != Visibility.Visible) return;
 
             // if any existing dialog is being displayed, dismiss it before showing a new one.
@@ -60,7 +66,7 @@ namespace osu.Game.Overlays
             Show();
         }
 
-        public override bool IsPresent => dialogContainer.Children.Count > 0;
+        public override bool IsPresent => Scheduler.HasPendingTasks || dialogContainer.Children.Count > 0;
 
         protected override bool BlockNonPositionalInput => true;
 
@@ -88,16 +94,14 @@ namespace osu.Game.Overlays
         protected override void PopOut()
         {
             base.PopOut();
+            this.FadeOut(PopupDialog.EXIT_DURATION, Easing.InSine);
+
+            // PopOut is called as part of VisibilityContainer's initialisation logic, but we don't want it to interact with a potentially waiting dialog.
+            if (!IsLoaded) return;
 
             lowPassFilter.CutoffTo(AudioFilter.MAX_LOWPASS_CUTOFF, 100, Easing.InCubic);
 
-            if (CurrentDialog?.State.Value == Visibility.Visible)
-            {
-                CurrentDialog.Hide();
-                return;
-            }
-
-            this.FadeOut(PopupDialog.EXIT_DURATION, Easing.InSine);
+            if (CurrentDialog?.State.Value == Visibility.Visible) CurrentDialog.Hide();
         }
 
         public override bool OnPressed(KeyBindingPressEvent<GlobalAction> e)

From e6fdef2d7afbb769583bc5a4cab62eba438e5773 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 4 May 2022 13:51:47 +0200
Subject: [PATCH 4493/5547] Fix test failures due to selection/item collection
 desyncs

---
 osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs | 12 ++++++++----
 1 file changed, 8 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs
index fe654c4ab8..18cf454be3 100644
--- a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs
+++ b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs
@@ -2,7 +2,6 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
-using System.Diagnostics;
 using System.Linq;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
@@ -178,14 +177,19 @@ namespace osu.Game.Screens.OnlinePlay
         {
             base.LoadComplete();
 
-            SelectedItem.BindValueChanged(_ => scrollToSelection(), true);
+            // schedules added as the properties may change value while the drawable items haven't been created yet.
+            SelectedItem.BindValueChanged(_ => Scheduler.AddOnce(scrollToSelection));
+            Items.BindCollectionChanged((_, __) => Scheduler.AddOnce(scrollToSelection), true);
         }
 
         private void scrollToSelection()
         {
-            if (SelectedItem.Value == null) return;
+            // SelectedItem and ItemMap/drawable items are managed separately,
+            // so if the item can't be unmapped to a drawable, don't try to scroll to it.
+            // best effort is made to not drop any updates, by subscribing to both sources.
+            if (SelectedItem.Value == null || !ItemMap.TryGetValue(SelectedItem.Value, out var drawableItem))
+                return;
 
-            Debug.Assert(ItemMap.TryGetValue(SelectedItem.Value, out var drawableItem));
             ScrollContainer.ScrollIntoView(drawableItem);
         }
 

From 81ce0e6565f244f6d1c59f00653ca972ab49a63d Mon Sep 17 00:00:00 2001
From: apollo-dw <83023433+apollo-dw@users.noreply.github.com>
Date: Wed, 4 May 2022 12:55:22 +0100
Subject: [PATCH 4494/5547] Reimplement sliderticks

---
 .../Mods/OsuModStrictTracking.cs                | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModStrictTracking.cs b/osu.Game.Rulesets.Osu/Mods/OsuModStrictTracking.cs
index ab45e5192d..a1e6946157 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModStrictTracking.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModStrictTracking.cs
@@ -70,6 +70,11 @@ namespace osu.Game.Rulesets.Osu.Mods
             drawableRuleset.Playfield.RegisterPool<StrictTrackingSliderTailCircle, StrictTrackingDrawableSliderTail>(10, 100);
         }
 
+        private class StrictTrackingSliderTick : SliderTick
+        {
+            public override Judgement CreateJudgement() => new OsuIgnoreJudgement();
+        }
+
         private class StrictTrackingSliderTailCircle : SliderTailCircle
         {
             public StrictTrackingSliderTailCircle(Slider slider)
@@ -109,6 +114,18 @@ namespace osu.Game.Rulesets.Osu.Mods
                 {
                     switch (e.Type)
                     {
+                        case SliderEventType.Tick:
+                            AddNested(new StrictTrackingSliderTick
+                            {
+                                SpanIndex = e.SpanIndex,
+                                SpanStartTime = e.SpanStartTime,
+                                StartTime = e.Time,
+                                Position = Position + Path.PositionAt(e.PathProgress),
+                                StackHeight = StackHeight,
+                                Scale = Scale,
+                            });
+                            break;
+
                         case SliderEventType.Head:
                             AddNested(HeadCircle = new SliderHeadCircle
                             {

From ddab3c6d8084a0c19289c56f53bdb779481ec4b6 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 4 May 2022 21:00:11 +0900
Subject: [PATCH 4495/5547] Tidy up state variables

---
 osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs | 10 ++++------
 1 file changed, 4 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs b/osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs
index e6a126f4d8..c5ac87f527 100644
--- a/osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs
+++ b/osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs
@@ -163,19 +163,17 @@ namespace osu.Game.Overlays.Chat.ChannelList
 
         private void updateState()
         {
-            if (showSelected)
+            bool selected = selectedChannel.Value == Channel && !SelectorActive.Value;
+
+            if (selected)
                 selectBox.FadeIn(300, Easing.OutQuint);
             else
                 selectBox.FadeOut(200, Easing.OutQuint);
 
-            if (showUnread || showSelected)
+            if (Unread.Value || selected)
                 text.FadeColour(colourProvider.Content1, 300, Easing.OutQuint);
             else
                 text.FadeColour(colourProvider.Light3, 200, Easing.OutQuint);
         }
-
-        private bool showUnread => Unread.Value;
-
-        private bool showSelected => selectedChannel.Value == Channel && !SelectorActive.Value;
     }
 }

From 1a85e1267bc0ccf3700360f831b69f5e5cc26312 Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Wed, 4 May 2022 14:43:40 +0100
Subject: [PATCH 4496/5547] Ensure focus is directed to `ChatTextBox` from
 `ChatOverlay` and add tests

---
 .../Visual/Online/TestSceneChatOverlayV2.cs   | 27 ++++++++++++++++++-
 osu.Game/Overlays/ChatOverlayV2.cs            |  8 ++++--
 2 files changed, 32 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs b/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs
index c7bb6760c7..9d4de11c5a 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs
@@ -144,7 +144,7 @@ namespace osu.Game.Tests.Visual.Online
         {
             AddStep("Show overlay", () => chatOverlay.Show());
             AddAssert("Listing is visible", () => listingVisibility == Visibility.Visible);
-            AddStep("Search for 'number 2'", () => chatOverlay.ChildrenOfType<ChatTextBox>().Single().Text = "number 2");
+            AddStep("Search for 'number 2'", () => chatOverlayTextBox.Text = "number 2");
             AddUntilStep("Only channel 2 visibile", () =>
             {
                 IEnumerable<ChannelListingItem> listingItems = chatOverlay.ChildrenOfType<ChannelListingItem>()
@@ -325,6 +325,28 @@ namespace osu.Game.Tests.Visual.Online
             AddStep("Highlight message", () => chatOverlay.HighlightMessage(message, testChannel1));
         }
 
+        [Test]
+        public void TextBoxRetainsFocus()
+        {
+            AddStep("Show overlay", () => chatOverlay.Show());
+            AddAssert("TextBox is focused", () => InputManager.FocusedDrawable == chatOverlayTextBox);
+            AddStep("Join channel 1", () => channelManager.JoinChannel(testChannel1));
+            AddStep("Select channel 1", () => clickDrawable(getChannelListItem(testChannel1)));
+            AddAssert("TextBox is focused", () => InputManager.FocusedDrawable == chatOverlayTextBox);
+            AddStep("Click selector", () => clickDrawable(chatOverlay.ChildrenOfType<ChannelListSelector>().Single()));
+            AddAssert("TextBox is focused", () => InputManager.FocusedDrawable == chatOverlayTextBox);
+            AddStep("Click listing", () => clickDrawable(chatOverlay.ChildrenOfType<ChannelListing>().Single()));
+            AddAssert("TextBox is focused", () => InputManager.FocusedDrawable == chatOverlayTextBox);
+            AddStep("Click drawable channel", () => clickDrawable(chatOverlay.ChildrenOfType<DrawableChannel>().Single()));
+            AddAssert("TextBox is focused", () => InputManager.FocusedDrawable == chatOverlayTextBox);
+            AddStep("Click channel list", () => clickDrawable(chatOverlay.ChildrenOfType<ChannelList>().Single()));
+            AddAssert("TextBox is focused", () => InputManager.FocusedDrawable == chatOverlayTextBox);
+            AddStep("Click top bar", () => clickDrawable(chatOverlay.ChildrenOfType<ChatOverlayTopBar>().Single()));
+            AddAssert("TextBox is focused", () => InputManager.FocusedDrawable == chatOverlayTextBox);
+            AddStep("Hide overlay", () => chatOverlay.Hide());
+            AddAssert("TextBox is not focused", () => InputManager.FocusedDrawable == null);
+        }
+
         private Visibility listingVisibility =>
             chatOverlay.ChildrenOfType<ChannelListing>().Single().State.Value;
 
@@ -337,6 +359,9 @@ namespace osu.Game.Tests.Visual.Online
         private ChannelListItem getChannelListItem(Channel channel) =>
             chatOverlay.ChildrenOfType<ChannelListItem>().Single(item => item.Channel == channel);
 
+        private ChatTextBox chatOverlayTextBox =>
+            chatOverlay.ChildrenOfType<ChatTextBox>().Single();
+
         private void clickDrawable(Drawable d)
         {
             InputManager.MoveMouseTo(d);
diff --git a/osu.Game/Overlays/ChatOverlayV2.cs b/osu.Game/Overlays/ChatOverlayV2.cs
index f6190bbe20..658a28bfdb 100644
--- a/osu.Game/Overlays/ChatOverlayV2.cs
+++ b/osu.Game/Overlays/ChatOverlayV2.cs
@@ -218,8 +218,6 @@ namespace osu.Game.Overlays
 
             this.MoveToY(0, transition_length, Easing.OutQuint);
             this.FadeIn(transition_length, Easing.OutQuint);
-
-            textBar.TextBoxTakeFocus();
         }
 
         protected override void PopOut()
@@ -232,6 +230,12 @@ namespace osu.Game.Overlays
             textBar.TextBoxKillFocus();
         }
 
+        protected override void OnFocus(FocusEvent e)
+        {
+            textBar.TextBoxTakeFocus();
+            base.OnFocus(e);
+        }
+
         private void currentChannelChanged(ValueChangedEvent<Channel> e)
         {
             Channel? newChannel = e.NewValue;

From 9416346c942ad20baa7b8000ebcb0a028a8c796e Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 4 May 2022 16:46:23 +0300
Subject: [PATCH 4497/5547] Globalise beatmap selection key bindings as "group"
 selection

---
 .../Input/Bindings/GlobalActionContainer.cs   | 13 ++++++------
 .../GlobalActionKeyBindingStrings.cs          | 20 +++++++++----------
 osu.Game/Overlays/Volume/VolumeMeter.cs       |  4 ++--
 osu.Game/Screens/Select/BeatmapCarousel.cs    |  8 ++++----
 4 files changed, 23 insertions(+), 22 deletions(-)

diff --git a/osu.Game/Input/Bindings/GlobalActionContainer.cs b/osu.Game/Input/Bindings/GlobalActionContainer.cs
index ec368a6fda..9cb8f2dfcc 100644
--- a/osu.Game/Input/Bindings/GlobalActionContainer.cs
+++ b/osu.Game/Input/Bindings/GlobalActionContainer.cs
@@ -59,6 +59,9 @@ namespace osu.Game.Input.Bindings
             new KeyBinding(InputKey.Up, GlobalAction.SelectPrevious),
             new KeyBinding(InputKey.Down, GlobalAction.SelectNext),
 
+            new KeyBinding(InputKey.Left, GlobalAction.SelectPreviousGroup),
+            new KeyBinding(InputKey.Right, GlobalAction.SelectNextGroup),
+
             new KeyBinding(InputKey.Space, GlobalAction.Select),
             new KeyBinding(InputKey.Enter, GlobalAction.Select),
             new KeyBinding(InputKey.KeypadEnter, GlobalAction.Select),
@@ -100,8 +103,6 @@ namespace osu.Game.Input.Bindings
 
         public IEnumerable<KeyBinding> SongSelectKeyBindings => new[]
         {
-            new KeyBinding(InputKey.Left, GlobalAction.SelectPreviousBeatmap),
-            new KeyBinding(InputKey.Right, GlobalAction.SelectNextBeatmap),
             new KeyBinding(InputKey.F1, GlobalAction.ToggleModSelection),
             new KeyBinding(InputKey.F2, GlobalAction.SelectNextRandom),
             new KeyBinding(new[] { InputKey.Shift, InputKey.F2 }, GlobalAction.SelectPreviousRandom),
@@ -304,10 +305,10 @@ namespace osu.Game.Input.Bindings
         [LocalisableDescription(typeof(GlobalActionKeyBindingStrings), nameof(GlobalActionKeyBindingStrings.EditorFlipVertically))]
         EditorFlipVertically,
 
-        [LocalisableDescription(typeof(GlobalActionKeyBindingStrings), nameof(GlobalActionKeyBindingStrings.SelectPreviousBeatmap))]
-        SelectPreviousBeatmap,
+        [LocalisableDescription(typeof(GlobalActionKeyBindingStrings), nameof(GlobalActionKeyBindingStrings.SelectPreviousGroup))]
+        SelectPreviousGroup,
 
-        [LocalisableDescription(typeof(GlobalActionKeyBindingStrings), nameof(GlobalActionKeyBindingStrings.SelectNextBeatmap))]
-        SelectNextBeatmap,
+        [LocalisableDescription(typeof(GlobalActionKeyBindingStrings), nameof(GlobalActionKeyBindingStrings.SelectNextGroup))]
+        SelectNextGroup,
     }
 }
diff --git a/osu.Game/Localisation/GlobalActionKeyBindingStrings.cs b/osu.Game/Localisation/GlobalActionKeyBindingStrings.cs
index 08e13e24ae..129706261b 100644
--- a/osu.Game/Localisation/GlobalActionKeyBindingStrings.cs
+++ b/osu.Game/Localisation/GlobalActionKeyBindingStrings.cs
@@ -129,6 +129,16 @@ namespace osu.Game.Localisation
         /// </summary>
         public static LocalisableString SelectNext => new TranslatableString(getKey(@"select_next"), @"Next selection");
 
+        /// <summary>
+        /// "Previous group selection"
+        /// </summary>
+        public static LocalisableString SelectPreviousGroup => new TranslatableString(getKey(@"select_previous_group"), @"Previous group selection");
+
+        /// <summary>
+        /// "Next group selection"
+        /// </summary>
+        public static LocalisableString SelectNextGroup => new TranslatableString(getKey(@"select_next_group"), @"Next group selection");
+
         /// <summary>
         /// "Home"
         /// </summary>
@@ -194,16 +204,6 @@ namespace osu.Game.Localisation
         /// </summary>
         public static LocalisableString ToggleInGameInterface => new TranslatableString(getKey(@"toggle_in_game_interface"), @"Toggle in-game interface");
 
-        /// <summary>
-        /// "Previous beatmap selection"
-        /// </summary>
-        public static LocalisableString SelectPreviousBeatmap => new TranslatableString(getKey(@"select_previous_beatmap"), @"Previous beatmap selection");
-
-        /// <summary>
-        /// "Next beatmap selection"
-        /// </summary>
-        public static LocalisableString SelectNextBeatmap => new TranslatableString(getKey(@"select_next_beatmap"), @"Next beatmap selection");
-
         /// <summary>
         /// "Toggle Mod Select"
         /// </summary>
diff --git a/osu.Game/Overlays/Volume/VolumeMeter.cs b/osu.Game/Overlays/Volume/VolumeMeter.cs
index e2afd46c18..46b8b35da2 100644
--- a/osu.Game/Overlays/Volume/VolumeMeter.cs
+++ b/osu.Game/Overlays/Volume/VolumeMeter.cs
@@ -372,12 +372,12 @@ namespace osu.Game.Overlays.Volume
 
             switch (e.Action)
             {
-                case GlobalAction.SelectPrevious:
+                case GlobalAction.SelectPreviousGroup:
                     State = SelectionState.Selected;
                     adjust(1, false);
                     return true;
 
-                case GlobalAction.SelectNext:
+                case GlobalAction.SelectNextGroup:
                     State = SelectionState.Selected;
                     adjust(-1, false);
                     return true;
diff --git a/osu.Game/Screens/Select/BeatmapCarousel.cs b/osu.Game/Screens/Select/BeatmapCarousel.cs
index 85b5af049e..a59f14647d 100644
--- a/osu.Game/Screens/Select/BeatmapCarousel.cs
+++ b/osu.Game/Screens/Select/BeatmapCarousel.cs
@@ -611,13 +611,13 @@ namespace osu.Game.Screens.Select
             switch (e.Action)
             {
                 case GlobalAction.SelectNext:
-                case GlobalAction.SelectNextBeatmap:
-                    SelectNext(1, e.Action == GlobalAction.SelectNextBeatmap);
+                case GlobalAction.SelectNextGroup:
+                    SelectNext(1, e.Action == GlobalAction.SelectNextGroup);
                     return true;
 
                 case GlobalAction.SelectPrevious:
-                case GlobalAction.SelectPreviousBeatmap:
-                    SelectNext(-1, e.Action == GlobalAction.SelectPreviousBeatmap);
+                case GlobalAction.SelectPreviousGroup:
+                    SelectNext(-1, e.Action == GlobalAction.SelectPreviousGroup);
                     return true;
             }
 

From 20e277d2e587069d0534bf457efa8999d0ac9629 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 4 May 2022 17:08:41 +0300
Subject: [PATCH 4498/5547] Apply proposed naming changes

---
 osu.Game/Overlays/BeatmapSet/LeaderboardModSelector.cs      | 2 +-
 osu.Game/Rulesets/Mods/IMod.cs                              | 4 ++--
 osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs                  | 2 +-
 osu.Game/Rulesets/Mods/ModRateAdjust.cs                     | 2 +-
 osu.Game/Rulesets/Mods/ModTimeRamp.cs                       | 2 +-
 osu.Game/Rulesets/Mods/ModUsage.cs                          | 6 +++---
 osu.Game/Screens/OnlinePlay/FreeModSelectOverlay.cs         | 2 +-
 .../OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs    | 4 ++--
 osu.Game/Screens/OnlinePlay/OnlinePlaySongSelect.cs         | 2 +-
 .../Screens/Play/PlayerSettings/BeatmapOffsetControl.cs     | 2 +-
 osu.Game/Screens/Play/SubmittingPlayer.cs                   | 2 +-
 osu.Game/Screens/Ranking/ResultsScreen.cs                   | 2 +-
 osu.Game/Utils/ModUtils.cs                                  | 4 ++--
 13 files changed, 18 insertions(+), 18 deletions(-)

diff --git a/osu.Game/Overlays/BeatmapSet/LeaderboardModSelector.cs b/osu.Game/Overlays/BeatmapSet/LeaderboardModSelector.cs
index caeb757d7a..17ea117018 100644
--- a/osu.Game/Overlays/BeatmapSet/LeaderboardModSelector.cs
+++ b/osu.Game/Overlays/BeatmapSet/LeaderboardModSelector.cs
@@ -63,7 +63,7 @@ namespace osu.Game.Overlays.BeatmapSet
                 return;
 
             modsContainer.Add(new ModButton(new ModNoMod()));
-            modsContainer.AddRange(rulesetInstance.AllMods.Where(m => m.IsPlayable(ModUsage.User)).Select(m => new ModButton(m)));
+            modsContainer.AddRange(rulesetInstance.AllMods.Where(m => m.IsPlayable(ModUsage.SoloLocal)).Select(m => new ModButton(m)));
 
             modsContainer.ForEach(button =>
             {
diff --git a/osu.Game/Rulesets/Mods/IMod.cs b/osu.Game/Rulesets/Mods/IMod.cs
index 325b75b76e..d37ef53a66 100644
--- a/osu.Game/Rulesets/Mods/IMod.cs
+++ b/osu.Game/Rulesets/Mods/IMod.cs
@@ -39,8 +39,8 @@ namespace osu.Game.Rulesets.Mods
         /// <remarks>
         /// <list type="bullet">
         /// <item>Should be always <c>false</c> for cases where the user is not interacting with the game.</item>
-        /// <item>Should be <c>false</c> in <see cref="ModUsage.MultiplayerRoomWide"/> for mods that make gameplay duration dependent on user input (e.g. <see cref="ModAdaptiveSpeed"/>).</item>
-        /// <item>Should be <c>false</c> in <see cref="ModUsage.MultiplayerPerPlayer"/> for mods that affect the gameplay duration (e.g. <see cref="ModRateAdjust"/> and <see cref="ModTimeRamp"/>).</item>
+        /// <item>Should be <c>false</c> in <see cref="ModUsage.MultiplayerGlobal"/> for mods that make gameplay duration dependent on user input (e.g. <see cref="ModAdaptiveSpeed"/>).</item>
+        /// <item>Should be <c>false</c> in <see cref="ModUsage.MultiplayerLocal"/> for mods that affect the gameplay duration (e.g. <see cref="ModRateAdjust"/> and <see cref="ModTimeRamp"/>).</item>
         /// </list>
         /// </remarks>
         /// <param name="usage">The mod usage.</param>
diff --git a/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs b/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs
index 801cd3cba7..700ad30c08 100644
--- a/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs
+++ b/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs
@@ -31,7 +31,7 @@ namespace osu.Game.Rulesets.Mods
 
         public override double ScoreMultiplier => 1;
 
-        public override bool IsPlayable(ModUsage usage) => usage == ModUsage.User;
+        public override bool IsPlayable(ModUsage usage) => usage == ModUsage.SoloLocal;
 
         public override Type[] IncompatibleMods => new[] { typeof(ModRateAdjust), typeof(ModTimeRamp) };
 
diff --git a/osu.Game/Rulesets/Mods/ModRateAdjust.cs b/osu.Game/Rulesets/Mods/ModRateAdjust.cs
index 59d9026f3b..acb39bfbe6 100644
--- a/osu.Game/Rulesets/Mods/ModRateAdjust.cs
+++ b/osu.Game/Rulesets/Mods/ModRateAdjust.cs
@@ -11,7 +11,7 @@ namespace osu.Game.Rulesets.Mods
 {
     public abstract class ModRateAdjust : Mod, IApplicableToRate
     {
-        public override bool IsPlayable(ModUsage usage) => usage != ModUsage.MultiplayerPerPlayer;
+        public override bool IsPlayable(ModUsage usage) => usage != ModUsage.MultiplayerLocal;
 
         public abstract BindableNumber<double> SpeedChange { get; }
 
diff --git a/osu.Game/Rulesets/Mods/ModTimeRamp.cs b/osu.Game/Rulesets/Mods/ModTimeRamp.cs
index 96b38301b5..c554c39010 100644
--- a/osu.Game/Rulesets/Mods/ModTimeRamp.cs
+++ b/osu.Game/Rulesets/Mods/ModTimeRamp.cs
@@ -30,7 +30,7 @@ namespace osu.Game.Rulesets.Mods
         [SettingSource("Adjust pitch", "Should pitch be adjusted with speed")]
         public abstract BindableBool AdjustPitch { get; }
 
-        public override bool IsPlayable(ModUsage usage) => usage != ModUsage.MultiplayerPerPlayer;
+        public override bool IsPlayable(ModUsage usage) => usage != ModUsage.MultiplayerLocal;
 
         public override Type[] IncompatibleMods => new[] { typeof(ModRateAdjust), typeof(ModAdaptiveSpeed) };
 
diff --git a/osu.Game/Rulesets/Mods/ModUsage.cs b/osu.Game/Rulesets/Mods/ModUsage.cs
index 04d99149dd..3f25154d73 100644
--- a/osu.Game/Rulesets/Mods/ModUsage.cs
+++ b/osu.Game/Rulesets/Mods/ModUsage.cs
@@ -11,17 +11,17 @@ namespace osu.Game.Rulesets.Mods
         /// <summary>
         /// This mod can be used for a per-user gameplay session.
         /// </summary>
-        User,
+        SoloLocal,
 
         /// <summary>
         /// This mod can be used in multiplayer but must be applied to all users.
         /// This is generally the case for mods which affect the length of gameplay.
         /// </summary>
-        MultiplayerRoomWide,
+        MultiplayerGlobal,
 
         /// <summary>
         /// This mod can be used in multiplayer either at a room or per-player level (i.e. "free mod").
         /// </summary>
-        MultiplayerPerPlayer,
+        MultiplayerLocal,
     }
 }
diff --git a/osu.Game/Screens/OnlinePlay/FreeModSelectOverlay.cs b/osu.Game/Screens/OnlinePlay/FreeModSelectOverlay.cs
index 37cffd8343..13d5dd8927 100644
--- a/osu.Game/Screens/OnlinePlay/FreeModSelectOverlay.cs
+++ b/osu.Game/Screens/OnlinePlay/FreeModSelectOverlay.cs
@@ -25,7 +25,7 @@ namespace osu.Game.Screens.OnlinePlay
         public new Func<Mod, bool> IsValidMod
         {
             get => base.IsValidMod;
-            set => base.IsValidMod = m => m.HasImplementation && m.IsPlayable(ModUsage.User) && value(m);
+            set => base.IsValidMod = m => m.HasImplementation && m.IsPlayable(ModUsage.SoloLocal) && value(m);
         }
 
         public FreeModSelectOverlay()
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs
index 5bf217031a..d7e752623d 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs
@@ -95,8 +95,8 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
 
         protected override BeatmapDetailArea CreateBeatmapDetailArea() => new PlayBeatmapDetailArea();
 
-        protected override bool IsValidMod(Mod mod) => base.IsValidMod(mod) && mod.IsPlayable(ModUsage.MultiplayerRoomWide);
+        protected override bool IsValidMod(Mod mod) => base.IsValidMod(mod) && mod.IsPlayable(ModUsage.MultiplayerGlobal);
 
-        protected override bool IsValidFreeMod(Mod mod) => base.IsValidFreeMod(mod) && mod.IsPlayable(ModUsage.MultiplayerPerPlayer);
+        protected override bool IsValidFreeMod(Mod mod) => base.IsValidFreeMod(mod) && mod.IsPlayable(ModUsage.MultiplayerLocal);
     }
 }
diff --git a/osu.Game/Screens/OnlinePlay/OnlinePlaySongSelect.cs b/osu.Game/Screens/OnlinePlay/OnlinePlaySongSelect.cs
index d9da230f58..b8b0604c79 100644
--- a/osu.Game/Screens/OnlinePlay/OnlinePlaySongSelect.cs
+++ b/osu.Game/Screens/OnlinePlay/OnlinePlaySongSelect.cs
@@ -170,7 +170,7 @@ namespace osu.Game.Screens.OnlinePlay
         /// </summary>
         /// <param name="mod">The <see cref="Mod"/> to check.</param>
         /// <returns>Whether <paramref name="mod"/> is a valid mod for online play.</returns>
-        protected virtual bool IsValidMod(Mod mod) => mod.HasImplementation && ModUtils.FlattenMod(mod).All(m => m.IsPlayable(ModUsage.User));
+        protected virtual bool IsValidMod(Mod mod) => mod.HasImplementation && ModUtils.FlattenMod(mod).All(m => m.IsPlayable(ModUsage.SoloLocal));
 
         /// <summary>
         /// Checks whether a given <see cref="Mod"/> is valid for per-player free-mod selection.
diff --git a/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs b/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
index 554b58f481..af2cecfba5 100644
--- a/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
+++ b/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
@@ -188,7 +188,7 @@ namespace osu.Game.Screens.Play.PlayerSettings
             if (score.NewValue == null)
                 return;
 
-            if (score.NewValue.Mods.Any(m => !m.IsPlayable(ModUsage.User)))
+            if (score.NewValue.Mods.Any(m => !m.IsPlayable(ModUsage.SoloLocal)))
                 return;
 
             var hitEvents = score.NewValue.HitEvents;
diff --git a/osu.Game/Screens/Play/SubmittingPlayer.cs b/osu.Game/Screens/Play/SubmittingPlayer.cs
index 6846992b13..b33ff87d55 100644
--- a/osu.Game/Screens/Play/SubmittingPlayer.cs
+++ b/osu.Game/Screens/Play/SubmittingPlayer.cs
@@ -48,7 +48,7 @@ namespace osu.Game.Screens.Play
             // Token request construction should happen post-load to allow derived classes to potentially prepare DI backings that are used to create the request.
             var tcs = new TaskCompletionSource<bool>();
 
-            if (Mods.Value.Any(m => !m.IsPlayable(ModUsage.User)))
+            if (Mods.Value.Any(m => !m.IsPlayable(ModUsage.SoloLocal)))
             {
                 handleTokenFailure(new InvalidOperationException("Non-user playable mod selected."));
                 return false;
diff --git a/osu.Game/Screens/Ranking/ResultsScreen.cs b/osu.Game/Screens/Ranking/ResultsScreen.cs
index ee2c00a135..e0ae0309ce 100644
--- a/osu.Game/Screens/Ranking/ResultsScreen.cs
+++ b/osu.Game/Screens/Ranking/ResultsScreen.cs
@@ -146,7 +146,7 @@ namespace osu.Game.Screens.Ranking
             if (Score != null)
             {
                 // only show flair / animation when arriving after watching a play that isn't autoplay.
-                bool shouldFlair = player != null && Score.Mods.All(m => m.IsPlayable(ModUsage.User));
+                bool shouldFlair = player != null && Score.Mods.All(m => m.IsPlayable(ModUsage.SoloLocal));
 
                 ScorePanelList.AddScore(Score, shouldFlair);
             }
diff --git a/osu.Game/Utils/ModUtils.cs b/osu.Game/Utils/ModUtils.cs
index c5cf469f7c..e19020a959 100644
--- a/osu.Game/Utils/ModUtils.cs
+++ b/osu.Game/Utils/ModUtils.cs
@@ -121,7 +121,7 @@ namespace osu.Game.Utils
         /// <param name="invalidMods">Invalid mods, if any were found. Will be null if all mods were valid.</param>
         /// <returns>Whether the input mods were all valid. If false, <paramref name="invalidMods"/> will contain all invalid entries.</returns>
         public static bool CheckValidRequiredModsForMultiplayer(IEnumerable<Mod> mods, [NotNullWhen(false)] out List<Mod>? invalidMods)
-            => checkValid(mods, m => m.IsPlayable(ModUsage.MultiplayerRoomWide), out invalidMods);
+            => checkValid(mods, m => m.IsPlayable(ModUsage.MultiplayerGlobal), out invalidMods);
 
         /// <summary>
         /// Checks that all <see cref="Mod"/>s in a combination are valid as "free mods" in a multiplayer match session.
@@ -130,7 +130,7 @@ namespace osu.Game.Utils
         /// <param name="invalidMods">Invalid mods, if any were found. Will be null if all mods were valid.</param>
         /// <returns>Whether the input mods were all valid. If false, <paramref name="invalidMods"/> will contain all invalid entries.</returns>
         public static bool CheckValidFreeModsForMultiplayer(IEnumerable<Mod> mods, [NotNullWhen(false)] out List<Mod>? invalidMods)
-            => checkValid(mods, m => m.IsPlayable(ModUsage.MultiplayerPerPlayer), out invalidMods);
+            => checkValid(mods, m => m.IsPlayable(ModUsage.MultiplayerLocal), out invalidMods);
 
         private static bool checkValid(IEnumerable<Mod> mods, Predicate<Mod> valid, [NotNullWhen(false)] out List<Mod>? invalidMods)
         {

From 8f04db5df5136f9431e62a6fffce273f2ba8d6bc Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 4 May 2022 17:21:19 +0300
Subject: [PATCH 4499/5547] Bring back behaviour of checking incompatibility on
 gameplay validity

---
 osu.Game.Tests/Mods/ModUtilsTest.cs | 12 ++++++++++++
 osu.Game/OsuGame.cs                 | 15 +++++----------
 osu.Game/Utils/ModUtils.cs          | 15 +++++++++++----
 3 files changed, 28 insertions(+), 14 deletions(-)

diff --git a/osu.Game.Tests/Mods/ModUtilsTest.cs b/osu.Game.Tests/Mods/ModUtilsTest.cs
index e858abfe44..4c126f0a3b 100644
--- a/osu.Game.Tests/Mods/ModUtilsTest.cs
+++ b/osu.Game.Tests/Mods/ModUtilsTest.cs
@@ -134,6 +134,18 @@ namespace osu.Game.Tests.Mods
 
         private static readonly object[] invalid_mod_test_scenarios =
         {
+            // incompatible pair.
+            new object[]
+            {
+                new Mod[] { new OsuModDoubleTime(), new OsuModHalfTime() },
+                new[] { typeof(OsuModDoubleTime), typeof(OsuModHalfTime) }
+            },
+            // incompatible pair with derived class.
+            new object[]
+            {
+                new Mod[] { new OsuModNightcore(), new OsuModHalfTime() },
+                new[] { typeof(OsuModNightcore), typeof(OsuModHalfTime) }
+            },
             // system mod.
             new object[]
             {
diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index 29985b0893..e9fe8c43de 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -577,16 +577,11 @@ namespace osu.Game
             if (SelectedMods.Disabled)
                 return;
 
-            var validMods = mods.NewValue;
-
-            if (!ModUtils.CheckCompatibleSet(validMods, out var incompatible))
-                validMods = validMods.Except(incompatible).ToArray();
-
-            if (!ModUtils.CheckValidForGameplay(validMods, out var invalid))
-                validMods = validMods.Except(invalid).ToArray();
-
-            // ensure we always have a valid set of mods.
-            SelectedMods.Value = validMods;
+            if (!ModUtils.CheckValidForGameplay(mods.NewValue, out var invalid))
+            {
+                // ensure we always have a valid set of mods.
+                SelectedMods.Value = mods.NewValue.Except(invalid).ToArray();
+            }
         }
 
         #endregion
diff --git a/osu.Game/Utils/ModUtils.cs b/osu.Game/Utils/ModUtils.cs
index e19020a959..c18125054a 100644
--- a/osu.Game/Utils/ModUtils.cs
+++ b/osu.Game/Utils/ModUtils.cs
@@ -112,7 +112,7 @@ namespace osu.Game.Utils
         /// <param name="invalidMods">Invalid mods, if any were found. Will be null if all mods were valid.</param>
         /// <returns>Whether the input mods were all valid. If false, <paramref name="invalidMods"/> will contain all invalid entries.</returns>
         public static bool CheckValidForGameplay(IEnumerable<Mod> mods, [NotNullWhen(false)] out List<Mod>? invalidMods)
-            => checkValid(mods, m => m.Type != ModType.System && m.HasImplementation && !(m is MultiMod), out invalidMods);
+            => checkValid(mods, m => m.Type != ModType.System && m.HasImplementation && !(m is MultiMod), out invalidMods, true);
 
         /// <summary>
         /// Checks that all <see cref="Mod"/>s in a combination are valid as "required mods" in a multiplayer match session.
@@ -121,7 +121,7 @@ namespace osu.Game.Utils
         /// <param name="invalidMods">Invalid mods, if any were found. Will be null if all mods were valid.</param>
         /// <returns>Whether the input mods were all valid. If false, <paramref name="invalidMods"/> will contain all invalid entries.</returns>
         public static bool CheckValidRequiredModsForMultiplayer(IEnumerable<Mod> mods, [NotNullWhen(false)] out List<Mod>? invalidMods)
-            => checkValid(mods, m => m.IsPlayable(ModUsage.MultiplayerGlobal), out invalidMods);
+            => checkValid(mods, m => m.IsPlayable(ModUsage.MultiplayerGlobal), out invalidMods, true);
 
         /// <summary>
         /// Checks that all <see cref="Mod"/>s in a combination are valid as "free mods" in a multiplayer match session.
@@ -130,13 +130,20 @@ namespace osu.Game.Utils
         /// <param name="invalidMods">Invalid mods, if any were found. Will be null if all mods were valid.</param>
         /// <returns>Whether the input mods were all valid. If false, <paramref name="invalidMods"/> will contain all invalid entries.</returns>
         public static bool CheckValidFreeModsForMultiplayer(IEnumerable<Mod> mods, [NotNullWhen(false)] out List<Mod>? invalidMods)
-            => checkValid(mods, m => m.IsPlayable(ModUsage.MultiplayerLocal), out invalidMods);
+            => checkValid(mods, m => m.IsPlayable(ModUsage.MultiplayerLocal), out invalidMods, false);
 
-        private static bool checkValid(IEnumerable<Mod> mods, Predicate<Mod> valid, [NotNullWhen(false)] out List<Mod>? invalidMods)
+        private static bool checkValid(IEnumerable<Mod> mods, Predicate<Mod> valid, [NotNullWhen(false)] out List<Mod>? invalidMods, bool checkCompatibility)
         {
             mods = mods.ToArray();
             invalidMods = null;
 
+            if (checkCompatibility)
+            {
+                // exclude multi mods from compatibility checks.
+                // the loop below automatically marks all multi mods as not valid for gameplay anyway.
+                CheckCompatibleSet(mods.Where(m => !(m is MultiMod)), out invalidMods);
+            }
+
             foreach (var mod in mods)
             {
                 if (!valid(mod))

From 8488a29e9e4db0dd26ab6ec2ecacd24681b764b2 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 4 May 2022 17:22:11 +0300
Subject: [PATCH 4500/5547] Renew obsoletion date

---
 osu.Game/Rulesets/Mods/IMod.cs | 2 +-
 osu.Game/Rulesets/Mods/Mod.cs  | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Rulesets/Mods/IMod.cs b/osu.Game/Rulesets/Mods/IMod.cs
index d37ef53a66..c0d4aa5c9f 100644
--- a/osu.Game/Rulesets/Mods/IMod.cs
+++ b/osu.Game/Rulesets/Mods/IMod.cs
@@ -50,7 +50,7 @@ namespace osu.Game.Rulesets.Mods
         /// Whether this mod is playable by an end user.
         /// Should be <c>false</c> for cases where the user is not interacting with the game (so it can be excluded from multiplayer selection, for example).
         /// </summary>
-        [Obsolete("Override IsPlayable instead.")] // Can be removed 20220918
+        [Obsolete("Override IsPlayable instead.")] // Can be removed 20221104
         bool UserPlayable { get; }
 
         /// <summary>
diff --git a/osu.Game/Rulesets/Mods/Mod.cs b/osu.Game/Rulesets/Mods/Mod.cs
index debb1a1e48..b2f1b7e24f 100644
--- a/osu.Game/Rulesets/Mods/Mod.cs
+++ b/osu.Game/Rulesets/Mods/Mod.cs
@@ -96,7 +96,7 @@ namespace osu.Game.Rulesets.Mods
 #pragma warning restore 618
 
         [JsonIgnore]
-        [Obsolete("Override IsPlayable instead.")] // Can be removed 20220918
+        [Obsolete("Override IsPlayable instead.")] // Can be removed 20221104
         public virtual bool UserPlayable => true;
 
         [Obsolete("Going forward, the concept of \"ranked\" doesn't exist. The only exceptions are automation mods, which should now override IsPlayable to false.")] // Can be removed 20211009

From d0df9e8051f7580b94e888079557d6cf62018b40 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 4 May 2022 18:56:27 +0300
Subject: [PATCH 4501/5547] Inline `CheckCompatibleSet` method to avoid ugly
 boolean flag

---
 osu.Game/Utils/ModUtils.cs | 31 ++++++++++++++++++++-----------
 1 file changed, 20 insertions(+), 11 deletions(-)

diff --git a/osu.Game/Utils/ModUtils.cs b/osu.Game/Utils/ModUtils.cs
index c18125054a..40db981ef0 100644
--- a/osu.Game/Utils/ModUtils.cs
+++ b/osu.Game/Utils/ModUtils.cs
@@ -112,7 +112,16 @@ namespace osu.Game.Utils
         /// <param name="invalidMods">Invalid mods, if any were found. Will be null if all mods were valid.</param>
         /// <returns>Whether the input mods were all valid. If false, <paramref name="invalidMods"/> will contain all invalid entries.</returns>
         public static bool CheckValidForGameplay(IEnumerable<Mod> mods, [NotNullWhen(false)] out List<Mod>? invalidMods)
-            => checkValid(mods, m => m.Type != ModType.System && m.HasImplementation && !(m is MultiMod), out invalidMods, true);
+        {
+            mods = mods.ToArray();
+
+            // exclude multi mods from compatibility checks.
+            // the loop below automatically marks all multi mods as not valid for gameplay anyway.
+            if (!CheckCompatibleSet(mods.Where(m => !(m is MultiMod)), out invalidMods))
+                return false;
+
+            return checkValid(mods, m => m.Type != ModType.System && m.HasImplementation && !(m is MultiMod), out invalidMods);
+        }
 
         /// <summary>
         /// Checks that all <see cref="Mod"/>s in a combination are valid as "required mods" in a multiplayer match session.
@@ -121,7 +130,14 @@ namespace osu.Game.Utils
         /// <param name="invalidMods">Invalid mods, if any were found. Will be null if all mods were valid.</param>
         /// <returns>Whether the input mods were all valid. If false, <paramref name="invalidMods"/> will contain all invalid entries.</returns>
         public static bool CheckValidRequiredModsForMultiplayer(IEnumerable<Mod> mods, [NotNullWhen(false)] out List<Mod>? invalidMods)
-            => checkValid(mods, m => m.IsPlayable(ModUsage.MultiplayerGlobal), out invalidMods, true);
+        {
+            mods = mods.ToArray();
+
+            if (!CheckCompatibleSet(mods, out invalidMods))
+                return false;
+
+            return checkValid(mods, m => m.IsPlayable(ModUsage.MultiplayerGlobal), out invalidMods);
+        }
 
         /// <summary>
         /// Checks that all <see cref="Mod"/>s in a combination are valid as "free mods" in a multiplayer match session.
@@ -130,20 +146,13 @@ namespace osu.Game.Utils
         /// <param name="invalidMods">Invalid mods, if any were found. Will be null if all mods were valid.</param>
         /// <returns>Whether the input mods were all valid. If false, <paramref name="invalidMods"/> will contain all invalid entries.</returns>
         public static bool CheckValidFreeModsForMultiplayer(IEnumerable<Mod> mods, [NotNullWhen(false)] out List<Mod>? invalidMods)
-            => checkValid(mods, m => m.IsPlayable(ModUsage.MultiplayerLocal), out invalidMods, false);
+            => checkValid(mods, m => m.IsPlayable(ModUsage.MultiplayerLocal), out invalidMods);
 
-        private static bool checkValid(IEnumerable<Mod> mods, Predicate<Mod> valid, [NotNullWhen(false)] out List<Mod>? invalidMods, bool checkCompatibility)
+        private static bool checkValid(IEnumerable<Mod> mods, Predicate<Mod> valid, [NotNullWhen(false)] out List<Mod>? invalidMods)
         {
             mods = mods.ToArray();
             invalidMods = null;
 
-            if (checkCompatibility)
-            {
-                // exclude multi mods from compatibility checks.
-                // the loop below automatically marks all multi mods as not valid for gameplay anyway.
-                CheckCompatibleSet(mods.Where(m => !(m is MultiMod)), out invalidMods);
-            }
-
             foreach (var mod in mods)
             {
                 if (!valid(mod))

From a27fcda9f1cee33104a9e6bb1aee1e5ac2bca1ac Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 5 May 2022 01:52:39 +0900
Subject: [PATCH 4502/5547] Fix failing tests due to `CurrentDialog` being
 unexpectedly not set after `Push`

---
 .../UserInterface/TestSceneDialogOverlay.cs   |  2 --
 osu.Game/Overlays/DialogOverlay.cs            | 27 +++++++++----------
 2 files changed, 12 insertions(+), 17 deletions(-)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneDialogOverlay.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneDialogOverlay.cs
index aecb3f6c71..54cdeaf956 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneDialogOverlay.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneDialogOverlay.cs
@@ -105,8 +105,6 @@ namespace osu.Game.Tests.Visual.UserInterface
                 });
             });
 
-            AddAssert("dialog not displayed", () => overlay.CurrentDialog != dialog);
-
             AddStep("complete load", () => ((SlowLoadingDialogOverlay)overlay).LoadEvent.Set());
 
             AddUntilStep("wait for load", () => overlay.IsLoaded);
diff --git a/osu.Game/Overlays/DialogOverlay.cs b/osu.Game/Overlays/DialogOverlay.cs
index 0699c69691..a8c3c392e0 100644
--- a/osu.Game/Overlays/DialogOverlay.cs
+++ b/osu.Game/Overlays/DialogOverlay.cs
@@ -47,23 +47,23 @@ namespace osu.Game.Overlays
 
         public void Push(PopupDialog dialog)
         {
-            if (!IsLoaded)
-            {
-                Schedule(() => Push(dialog));
-                return;
-            }
-
             if (dialog == CurrentDialog || dialog.State.Value != Visibility.Visible) return;
 
-            // if any existing dialog is being displayed, dismiss it before showing a new one.
-            CurrentDialog?.Hide();
-
+            var lastDialog = CurrentDialog;
             CurrentDialog = dialog;
-            CurrentDialog.State.ValueChanged += state => onDialogOnStateChanged(dialog, state.NewValue);
 
-            dialogContainer.Add(CurrentDialog);
+            Scheduler.Add(() =>
+            {
+                // if any existing dialog is being displayed, dismiss it before showing a new one.
+                lastDialog?.Hide();
 
-            Show();
+                CurrentDialog = dialog;
+                CurrentDialog.State.ValueChanged += state => onDialogOnStateChanged(dialog, state.NewValue);
+
+                dialogContainer.Add(CurrentDialog);
+
+                Show();
+            }, false);
         }
 
         public override bool IsPresent => Scheduler.HasPendingTasks || dialogContainer.Children.Count > 0;
@@ -96,9 +96,6 @@ namespace osu.Game.Overlays
             base.PopOut();
             this.FadeOut(PopupDialog.EXIT_DURATION, Easing.InSine);
 
-            // PopOut is called as part of VisibilityContainer's initialisation logic, but we don't want it to interact with a potentially waiting dialog.
-            if (!IsLoaded) return;
-
             lowPassFilter.CutoffTo(AudioFilter.MAX_LOWPASS_CUTOFF, 100, Easing.InCubic);
 
             if (CurrentDialog?.State.Value == Visibility.Visible) CurrentDialog.Hide();

From 81b462262096d38d864be7e1b1bf22cc13e75eb7 Mon Sep 17 00:00:00 2001
From: Supersonicboss1 <leodalgado@gmail.com>
Date: Wed, 4 May 2022 22:25:34 +0100
Subject: [PATCH 4503/5547] fixed autoplay not showing compat, + relax compat

---
 osu.Game.Rulesets.Osu/Mods/OsuModAlternate.cs | 2 +-
 osu.Game.Rulesets.Osu/Mods/OsuModAutoplay.cs  | 2 +-
 osu.Game.Rulesets.Osu/Mods/OsuModCinema.cs    | 2 +-
 osu.Game.Rulesets.Osu/Mods/OsuModRelax.cs     | 2 +-
 4 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModAlternate.cs b/osu.Game.Rulesets.Osu/Mods/OsuModAlternate.cs
index dfa28a537a..0832cfb545 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModAlternate.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModAlternate.cs
@@ -25,7 +25,7 @@ namespace osu.Game.Rulesets.Osu.Mods
         public override string Acronym => @"AL";
         public override string Description => @"Don't use the same key twice in a row!";
         public override double ScoreMultiplier => 1.0;
-        public override Type[] IncompatibleMods => new[] { typeof(ModAutoplay) };
+        public override Type[] IncompatibleMods => new[] { typeof(ModAutoplay), typeof(ModRelax) };
         public override ModType Type => ModType.Conversion;
         public override IconUsage? Icon => FontAwesome.Solid.Keyboard;
 
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModAutoplay.cs b/osu.Game.Rulesets.Osu/Mods/OsuModAutoplay.cs
index b31ef5d2fd..507b3588bd 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModAutoplay.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModAutoplay.cs
@@ -12,7 +12,7 @@ namespace osu.Game.Rulesets.Osu.Mods
 {
     public class OsuModAutoplay : ModAutoplay
     {
-        public override Type[] IncompatibleMods => base.IncompatibleMods.Concat(new[] { typeof(OsuModMagnetised), typeof(OsuModAutopilot), typeof(OsuModSpunOut) }).ToArray();
+        public override Type[] IncompatibleMods => base.IncompatibleMods.Concat(new[] { typeof(OsuModMagnetised), typeof(OsuModAutopilot), typeof(OsuModSpunOut), typeof(OsuModAlternate) }).ToArray();
 
         public override ModReplayData CreateReplayData(IBeatmap beatmap, IReadOnlyList<Mod> mods)
             => new ModReplayData(new OsuAutoGenerator(beatmap, mods).Generate(), new ModCreatedUser { Username = "Autoplay" });
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModCinema.cs b/osu.Game.Rulesets.Osu/Mods/OsuModCinema.cs
index 5b42772358..99d7535957 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModCinema.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModCinema.cs
@@ -13,7 +13,7 @@ namespace osu.Game.Rulesets.Osu.Mods
 {
     public class OsuModCinema : ModCinema<OsuHitObject>
     {
-        public override Type[] IncompatibleMods => base.IncompatibleMods.Concat(new[] { typeof(OsuModMagnetised), typeof(OsuModAutopilot), typeof(OsuModSpunOut) }).ToArray();
+        public override Type[] IncompatibleMods => base.IncompatibleMods.Concat(new[] { typeof(OsuModMagnetised), typeof(OsuModAutopilot), typeof(OsuModSpunOut), typeof(OsuModAlternate) }).ToArray();
 
         public override ModReplayData CreateReplayData(IBeatmap beatmap, IReadOnlyList<Mod> mods)
             => new ModReplayData(new OsuAutoGenerator(beatmap, mods).Generate(), new ModCreatedUser { Username = "Autoplay" });
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModRelax.cs b/osu.Game.Rulesets.Osu/Mods/OsuModRelax.cs
index 6b81efdca6..5f37c6a0ae 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModRelax.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModRelax.cs
@@ -19,7 +19,7 @@ namespace osu.Game.Rulesets.Osu.Mods
     public class OsuModRelax : ModRelax, IUpdatableByPlayfield, IApplicableToDrawableRuleset<OsuHitObject>, IApplicableToPlayer
     {
         public override string Description => @"You don't need to click. Give your clicking/tapping fingers a break from the heat of things.";
-        public override Type[] IncompatibleMods => base.IncompatibleMods.Concat(new[] { typeof(OsuModAutopilot), typeof(OsuModMagnetised) }).ToArray();
+        public override Type[] IncompatibleMods => base.IncompatibleMods.Concat(new[] { typeof(OsuModAutopilot), typeof(OsuModMagnetised), typeof(OsuModAlternate) }).ToArray();
 
         /// <summary>
         /// How early before a hitobject's start time to trigger a hit.

From 464b3af5f37b23204c3c440d4d0359b670527384 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 5 May 2022 05:42:20 +0300
Subject: [PATCH 4504/5547] Rename local correctly

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

diff --git a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs
index 18cf454be3..d1b83c3749 100644
--- a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs
+++ b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs
@@ -220,18 +220,18 @@ namespace osu.Game.Screens.OnlinePlay
             if (SelectedItem.Disabled)
                 return;
 
-            var visibleRooms = ListContainer.AsEnumerable().Where(r => r.IsPresent);
+            var visibleItems = ListContainer.AsEnumerable().Where(r => r.IsPresent);
 
             PlaylistItem item;
 
             if (SelectedItem.Value == null)
-                item = visibleRooms.FirstOrDefault()?.Model;
+                item = visibleItems.FirstOrDefault()?.Model;
             else
             {
                 if (direction < 0)
-                    visibleRooms = visibleRooms.Reverse();
+                    visibleItems = visibleItems.Reverse();
 
-                item = visibleRooms.SkipWhile(r => r.Model != SelectedItem.Value).Skip(1).FirstOrDefault()?.Model;
+                item = visibleItems.SkipWhile(r => r.Model != SelectedItem.Value).Skip(1).FirstOrDefault()?.Model;
             }
 
             // we already have a valid selection only change selection if we still have a room to switch to.

From f28978b85661ea1c878c27864788e0d65e68de57 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 5 May 2022 05:42:49 +0300
Subject: [PATCH 4505/5547] Handle against playlists which disallow selection

`SelectedItem.Disabled` is also not checked against in the select-via-click flow inside `DrawableRoomPlaylistItem` (only `AllowSelection` is checked).
---
 .../Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs  | 9 +++++++++
 osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs      | 2 +-
 2 files changed, 10 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
index 566a8db608..d520384218 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
@@ -56,6 +56,9 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             AddStep("click", () => InputManager.Click(MouseButton.Left));
             AddAssert("no item selected", () => playlist.SelectedItem.Value == null);
+
+            AddStep("press down", () => InputManager.Key(Key.Down));
+            AddAssert("no item selected", () => playlist.SelectedItem.Value == null);
         }
 
         [Test]
@@ -73,6 +76,9 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             AddStep("click", () => InputManager.Click(MouseButton.Left));
             AddAssert("no item selected", () => playlist.SelectedItem.Value == null);
+
+            AddStep("press down", () => InputManager.Key(Key.Down));
+            AddAssert("no item selected", () => playlist.SelectedItem.Value == null);
         }
 
         [Test]
@@ -91,6 +97,9 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             AddStep("click", () => InputManager.Click(MouseButton.Left));
             AddAssert("no item selected", () => playlist.SelectedItem.Value == null);
+
+            AddStep("press down", () => InputManager.Key(Key.Down));
+            AddAssert("no item selected", () => playlist.SelectedItem.Value == null);
         }
 
         [Test]
diff --git a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs
index d1b83c3749..840fc48613 100644
--- a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs
+++ b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs
@@ -217,7 +217,7 @@ namespace osu.Game.Screens.OnlinePlay
 
         private void selectNext(int direction)
         {
-            if (SelectedItem.Disabled)
+            if (!AllowSelection)
                 return;
 
             var visibleItems = ListContainer.AsEnumerable().Where(r => r.IsPresent);

From a26793cd654a29ada9d9d0234e796f531cd404c8 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 5 May 2022 06:12:24 +0300
Subject: [PATCH 4506/5547] Add missing `Test` prefix

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

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
index d520384218..e2b4b2870f 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
@@ -157,7 +157,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         }
 
         [Test]
-        public void KeyboardSelection()
+        public void TestKeyboardSelection()
         {
             createPlaylist(p => p.AllowSelection = true);
 

From e3c7c5d0b9ceca3ea19683280321c66e08155c42 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 5 May 2022 08:12:54 +0300
Subject: [PATCH 4507/5547] Improve validity methods to include system,
 non-implemented, and multi mods

---
 osu.Game/Utils/ModUtils.cs | 20 ++++++++++++++------
 1 file changed, 14 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Utils/ModUtils.cs b/osu.Game/Utils/ModUtils.cs
index 40db981ef0..f11a06e3be 100644
--- a/osu.Game/Utils/ModUtils.cs
+++ b/osu.Game/Utils/ModUtils.cs
@@ -115,12 +115,15 @@ namespace osu.Game.Utils
         {
             mods = mods.ToArray();
 
-            // exclude multi mods from compatibility checks.
-            // the loop below automatically marks all multi mods as not valid for gameplay anyway.
-            if (!CheckCompatibleSet(mods.Where(m => !(m is MultiMod)), out invalidMods))
+            // checking compatibility of multi mods would try to flatten them and return incompatible mods.
+            // in gameplay context, we never want MultiMod selected in the first place, therefore check against it first.
+            if (!checkValid(mods, m => !(m is MultiMod), out invalidMods))
                 return false;
 
-            return checkValid(mods, m => m.Type != ModType.System && m.HasImplementation && !(m is MultiMod), out invalidMods);
+            if (!CheckCompatibleSet(mods, out invalidMods))
+                return false;
+
+            return checkValid(mods, m => m.Type != ModType.System && m.HasImplementation, out invalidMods);
         }
 
         /// <summary>
@@ -133,10 +136,15 @@ namespace osu.Game.Utils
         {
             mods = mods.ToArray();
 
+            // checking compatibility of multi mods would try to flatten them and return incompatible mods.
+            // in gameplay context, we never want MultiMod selected in the first place, therefore check against it first.
+            if (!checkValid(mods, m => !(m is MultiMod), out invalidMods))
+                return false;
+
             if (!CheckCompatibleSet(mods, out invalidMods))
                 return false;
 
-            return checkValid(mods, m => m.IsPlayable(ModUsage.MultiplayerGlobal), out invalidMods);
+            return checkValid(mods, m => m.Type != ModType.System && m.HasImplementation && m.IsPlayable(ModUsage.MultiplayerGlobal), out invalidMods);
         }
 
         /// <summary>
@@ -146,7 +154,7 @@ namespace osu.Game.Utils
         /// <param name="invalidMods">Invalid mods, if any were found. Will be null if all mods were valid.</param>
         /// <returns>Whether the input mods were all valid. If false, <paramref name="invalidMods"/> will contain all invalid entries.</returns>
         public static bool CheckValidFreeModsForMultiplayer(IEnumerable<Mod> mods, [NotNullWhen(false)] out List<Mod>? invalidMods)
-            => checkValid(mods, m => m.IsPlayable(ModUsage.MultiplayerLocal), out invalidMods);
+            => checkValid(mods, m => m.Type != ModType.System && m.HasImplementation && m.IsPlayable(ModUsage.MultiplayerLocal) && !(m is MultiMod), out invalidMods);
 
         private static bool checkValid(IEnumerable<Mod> mods, Predicate<Mod> valid, [NotNullWhen(false)] out List<Mod>? invalidMods)
         {

From 86aa2125fe9878eda71857a0e1d0ca0823ab2899 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 5 May 2022 08:13:29 +0300
Subject: [PATCH 4508/5547] Add test coverage for multiplayer mod validity
 methods

---
 osu.Game.Tests/Mods/ModUtilsTest.cs | 161 ++++++++++++++++++++++++++--
 1 file changed, 153 insertions(+), 8 deletions(-)

diff --git a/osu.Game.Tests/Mods/ModUtilsTest.cs b/osu.Game.Tests/Mods/ModUtilsTest.cs
index 4c126f0a3b..2447233d3c 100644
--- a/osu.Game.Tests/Mods/ModUtilsTest.cs
+++ b/osu.Game.Tests/Mods/ModUtilsTest.cs
@@ -137,33 +137,137 @@ namespace osu.Game.Tests.Mods
             // incompatible pair.
             new object[]
             {
-                new Mod[] { new OsuModDoubleTime(), new OsuModHalfTime() },
-                new[] { typeof(OsuModDoubleTime), typeof(OsuModHalfTime) }
+                new Mod[] { new OsuModHidden(), new OsuModApproachDifferent() },
+                new[] { typeof(OsuModHidden), typeof(OsuModApproachDifferent) }
             },
             // incompatible pair with derived class.
             new object[]
             {
-                new Mod[] { new OsuModNightcore(), new OsuModHalfTime() },
-                new[] { typeof(OsuModNightcore), typeof(OsuModHalfTime) }
+                new Mod[] { new OsuModDeflate(), new OsuModApproachDifferent() },
+                new[] { typeof(OsuModDeflate), typeof(OsuModApproachDifferent) }
             },
             // system mod.
             new object[]
             {
-                new Mod[] { new OsuModDoubleTime(), new OsuModTouchDevice() },
+                new Mod[] { new OsuModHidden(), new OsuModTouchDevice() },
                 new[] { typeof(OsuModTouchDevice) }
             },
             // multi mod.
             new object[]
             {
-                new Mod[] { new MultiMod(new OsuModHalfTime()), new OsuModDaycore() },
+                new Mod[] { new MultiMod(new OsuModSuddenDeath(), new OsuModPerfect()) },
                 new[] { typeof(MultiMod) }
             },
+            // invalid multiplayer mod is valid for local.
+            new object[]
+            {
+                new Mod[] { new OsuModHidden(), new InvalidMultiplayerMod() },
+                null
+            },
+            // invalid free mod is valid for local.
+            new object[]
+            {
+                new Mod[] { new OsuModHidden(), new InvalidMultiplayerFreeMod() },
+                null
+            },
             // valid pair.
             new object[]
             {
-                new Mod[] { new OsuModDoubleTime(), new OsuModHardRock() },
+                new Mod[] { new OsuModHidden(), new OsuModHardRock() },
                 null
-            }
+            },
+        };
+
+        private static readonly object[] invalid_multiplayer_mod_test_scenarios =
+        {
+            // incompatible pair.
+            new object[]
+            {
+                new Mod[] { new OsuModHidden(), new OsuModApproachDifferent() },
+                new[] { typeof(OsuModHidden), typeof(OsuModApproachDifferent) }
+            },
+            // incompatible pair with derived class.
+            new object[]
+            {
+                new Mod[] { new OsuModDeflate(), new OsuModApproachDifferent() },
+                new[] { typeof(OsuModDeflate), typeof(OsuModApproachDifferent) }
+            },
+            // system mod.
+            new object[]
+            {
+                new Mod[] { new OsuModHidden(), new OsuModTouchDevice() },
+                new[] { typeof(OsuModTouchDevice) }
+            },
+            // multi mod.
+            new object[]
+            {
+                new Mod[] { new MultiMod(new OsuModSuddenDeath(), new OsuModPerfect()) },
+                new[] { typeof(MultiMod) }
+            },
+            // invalid multiplayer mod.
+            new object[]
+            {
+                new Mod[] { new OsuModHidden(), new InvalidMultiplayerMod() },
+                new[] { typeof(InvalidMultiplayerMod) }
+            },
+            // invalid free mod is valid for multiplayer global.
+            new object[]
+            {
+                new Mod[] { new OsuModHidden(), new InvalidMultiplayerFreeMod() },
+                null
+            },
+            // valid pair.
+            new object[]
+            {
+                new Mod[] { new OsuModHidden(), new OsuModHardRock() },
+                null
+            },
+        };
+
+        private static readonly object[] invalid_free_mod_test_scenarios =
+        {
+            // system mod.
+            new object[]
+            {
+                new Mod[] { new OsuModHidden(), new OsuModTouchDevice() },
+                new[] { typeof(OsuModTouchDevice) }
+            },
+            // multi mod.
+            new object[]
+            {
+                new Mod[] { new MultiMod(new OsuModSuddenDeath(), new OsuModPerfect()) },
+                new[] { typeof(MultiMod) }
+            },
+            // invalid multiplayer mod.
+            new object[]
+            {
+                new Mod[] { new OsuModHidden(), new InvalidMultiplayerMod() },
+                new[] { typeof(InvalidMultiplayerMod) }
+            },
+            // invalid free mod.
+            new object[]
+            {
+                new Mod[] { new OsuModHidden(), new InvalidMultiplayerFreeMod() },
+                new[] { typeof(InvalidMultiplayerFreeMod) }
+            },
+            // incompatible pair is valid for free mods.
+            new object[]
+            {
+                new Mod[] { new OsuModHidden(), new OsuModApproachDifferent() },
+                null,
+            },
+            // incompatible pair with derived class is valid for free mods.
+            new object[]
+            {
+                new Mod[] { new OsuModDeflate(), new OsuModSpinIn() },
+                null,
+            },
+            // valid pair.
+            new object[]
+            {
+                new Mod[] { new OsuModHidden(), new OsuModHardRock() },
+                null
+            },
         };
 
         [TestCaseSource(nameof(invalid_mod_test_scenarios))]
@@ -179,6 +283,32 @@ namespace osu.Game.Tests.Mods
                 Assert.That(invalid.Select(t => t.GetType()), Is.EquivalentTo(expectedInvalid));
         }
 
+        [TestCaseSource(nameof(invalid_multiplayer_mod_test_scenarios))]
+        public void TestInvalidMultiplayerModScenarios(Mod[] inputMods, Type[] expectedInvalid)
+        {
+            bool isValid = ModUtils.CheckValidRequiredModsForMultiplayer(inputMods, out var invalid);
+
+            Assert.That(isValid, Is.EqualTo(expectedInvalid == null));
+
+            if (isValid)
+                Assert.IsNull(invalid);
+            else
+                Assert.That(invalid.Select(t => t.GetType()), Is.EquivalentTo(expectedInvalid));
+        }
+
+        [TestCaseSource(nameof(invalid_free_mod_test_scenarios))]
+        public void TestInvalidFreeModScenarios(Mod[] inputMods, Type[] expectedInvalid)
+        {
+            bool isValid = ModUtils.CheckValidFreeModsForMultiplayer(inputMods, out var invalid);
+
+            Assert.That(isValid, Is.EqualTo(expectedInvalid == null));
+
+            if (isValid)
+                Assert.IsNull(invalid);
+            else
+                Assert.That(invalid.Select(t => t.GetType()), Is.EquivalentTo(expectedInvalid));
+        }
+
         public abstract class CustomMod1 : Mod, IModCompatibilitySpecification
         {
         }
@@ -187,6 +317,21 @@ namespace osu.Game.Tests.Mods
         {
         }
 
+        public class InvalidMultiplayerMod : Mod
+        {
+            public override string Name => string.Empty;
+            public override string Description => string.Empty;
+            public override string Acronym => string.Empty;
+            public override double ScoreMultiplier => 1;
+            public override bool HasImplementation => true;
+            public override bool IsPlayable(ModUsage usage) => usage == ModUsage.SoloLocal;
+        }
+
+        private class InvalidMultiplayerFreeMod : InvalidMultiplayerMod
+        {
+            public override bool IsPlayable(ModUsage usage) => usage != ModUsage.MultiplayerLocal;
+        }
+
         public interface IModCompatibilitySpecification
         {
         }

From 326ff3b6e9998d1e67cc41f2fa26c70eca456e4a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 5 May 2022 14:55:05 +0900
Subject: [PATCH 4509/5547] Fix `CurrentDialog` being updated twice, unsafe
 variable access

---
 osu.Game/Overlays/DialogOverlay.cs | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Overlays/DialogOverlay.cs b/osu.Game/Overlays/DialogOverlay.cs
index a8c3c392e0..c46f36b4df 100644
--- a/osu.Game/Overlays/DialogOverlay.cs
+++ b/osu.Game/Overlays/DialogOverlay.cs
@@ -50,17 +50,17 @@ namespace osu.Game.Overlays
             if (dialog == CurrentDialog || dialog.State.Value != Visibility.Visible) return;
 
             var lastDialog = CurrentDialog;
+
+            // Immediately update the externally accessible property as this may be used for checks even before
+            // a DialogOverlay instance has finished loading.
             CurrentDialog = dialog;
 
             Scheduler.Add(() =>
             {
                 // if any existing dialog is being displayed, dismiss it before showing a new one.
                 lastDialog?.Hide();
-
-                CurrentDialog = dialog;
-                CurrentDialog.State.ValueChanged += state => onDialogOnStateChanged(dialog, state.NewValue);
-
-                dialogContainer.Add(CurrentDialog);
+                dialog.State.ValueChanged += state => onDialogOnStateChanged(dialog, state.NewValue);
+                dialogContainer.Add(dialog);
 
                 Show();
             }, false);

From f6a6a11391e934973b3449cec07700c5421d11b5 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 5 May 2022 15:02:23 +0900
Subject: [PATCH 4510/5547] Remove `DialogOverlay` local fades (is already
 managed by `PopupDialog`s themselves)

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

diff --git a/osu.Game/Overlays/DialogOverlay.cs b/osu.Game/Overlays/DialogOverlay.cs
index c46f36b4df..5a69562e82 100644
--- a/osu.Game/Overlays/DialogOverlay.cs
+++ b/osu.Game/Overlays/DialogOverlay.cs
@@ -87,18 +87,16 @@ namespace osu.Game.Overlays
         protected override void PopIn()
         {
             base.PopIn();
-            this.FadeIn(PopupDialog.ENTER_DURATION, Easing.OutQuint);
             lowPassFilter.CutoffTo(300, 100, Easing.OutCubic);
         }
 
         protected override void PopOut()
         {
             base.PopOut();
-            this.FadeOut(PopupDialog.EXIT_DURATION, Easing.InSine);
-
             lowPassFilter.CutoffTo(AudioFilter.MAX_LOWPASS_CUTOFF, 100, Easing.InCubic);
 
-            if (CurrentDialog?.State.Value == Visibility.Visible) CurrentDialog.Hide();
+            if (CurrentDialog?.State.Value == Visibility.Visible)
+                CurrentDialog.Hide();
         }
 
         public override bool OnPressed(KeyBindingPressEvent<GlobalAction> e)

From cbc58c67bfd32b0631089afd0b7ee89c0ca01ea3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 5 May 2022 15:16:01 +0900
Subject: [PATCH 4511/5547] Remove weird strict tracking icon and reword
 description to explain what the mod does

---
 osu.Game.Rulesets.Osu/Mods/OsuModStrictTracking.cs | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModStrictTracking.cs b/osu.Game.Rulesets.Osu/Mods/OsuModStrictTracking.cs
index ab45e5192d..22ace52c2a 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModStrictTracking.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModStrictTracking.cs
@@ -4,7 +4,6 @@
 using System;
 using System.Linq;
 using System.Threading;
-using osu.Framework.Graphics.Sprites;
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Judgements;
 using osu.Game.Rulesets.Mods;
@@ -23,9 +22,8 @@ namespace osu.Game.Rulesets.Osu.Mods
     {
         public override string Name => @"Strict Tracking";
         public override string Acronym => @"ST";
-        public override IconUsage? Icon => FontAwesome.Solid.PenFancy;
         public override ModType Type => ModType.DifficultyIncrease;
-        public override string Description => @"Follow circles just got serious...";
+        public override string Description => @"Once you start a slider, follow precisely or get a miss.";
         public override double ScoreMultiplier => 1.0;
         public override Type[] IncompatibleMods => new[] { typeof(ModClassic), typeof(OsuModTarget) };
 

From f6fc926f1ade6fb5d1366edd4dd2f6632ec83913 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 5 May 2022 15:58:21 +0900
Subject: [PATCH 4512/5547] Add xmldoc and rename methods in
 `IPositionSnapProvider` for legibility

---
 osu.Game.Rulesets.Catch/Edit/CatchHitObjectComposer.cs |  4 ++--
 .../Editor/TestSceneManiaBeatSnapGrid.cs               |  4 ++--
 osu.Game.Rulesets.Mania/Edit/ManiaHitObjectComposer.cs |  6 +++---
 .../Editor/TestSceneOsuDistanceSnapGrid.cs             |  4 ++--
 .../Sliders/Components/PathControlPointVisualiser.cs   |  2 +-
 osu.Game.Rulesets.Osu/Edit/OsuHitObjectComposer.cs     |  8 ++++----
 .../Visual/Editing/TestSceneDistanceSnapGrid.cs        |  4 ++--
 osu.Game/Rulesets/Edit/HitObjectComposer.cs            |  6 +++---
 osu.Game/Rulesets/Edit/IPositionSnapProvider.cs        | 10 +++++++---
 .../Edit/Compose/Components/BlueprintContainer.cs      |  4 ++--
 .../Compose/Components/ComposeBlueprintContainer.cs    |  2 +-
 .../Edit/Compose/Components/Timeline/Timeline.cs       |  4 ++--
 .../Components/Timeline/TimelineHitObjectBlueprint.cs  |  2 +-
 13 files changed, 32 insertions(+), 28 deletions(-)

diff --git a/osu.Game.Rulesets.Catch/Edit/CatchHitObjectComposer.cs b/osu.Game.Rulesets.Catch/Edit/CatchHitObjectComposer.cs
index 9ff6d10a49..630a2cf645 100644
--- a/osu.Game.Rulesets.Catch/Edit/CatchHitObjectComposer.cs
+++ b/osu.Game.Rulesets.Catch/Edit/CatchHitObjectComposer.cs
@@ -89,9 +89,9 @@ namespace osu.Game.Rulesets.Catch.Edit
             new TernaryButton(distanceSnapToggle, "Distance Snap", () => new SpriteIcon { Icon = FontAwesome.Solid.Ruler })
         });
 
-        public override SnapResult SnapScreenSpacePositionToValidTime(Vector2 screenSpacePosition)
+        public override SnapResult FindSnappedPositionAndTime(Vector2 screenSpacePosition)
         {
-            var result = base.SnapScreenSpacePositionToValidTime(screenSpacePosition);
+            var result = base.FindSnappedPositionAndTime(screenSpacePosition);
             result.ScreenSpacePosition.X = screenSpacePosition.X;
 
             if (distanceSnapGrid.IsPresent && distanceSnapGrid.GetSnappedPosition(result.ScreenSpacePosition) is SnapResult snapResult &&
diff --git a/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneManiaBeatSnapGrid.cs b/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneManiaBeatSnapGrid.cs
index 2e55f86bb6..4bb049b1a4 100644
--- a/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneManiaBeatSnapGrid.cs
+++ b/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneManiaBeatSnapGrid.cs
@@ -97,12 +97,12 @@ namespace osu.Game.Rulesets.Mania.Tests.Editor
             set => InternalChild = value;
         }
 
-        public override SnapResult SnapScreenSpacePositionToValidTime(Vector2 screenSpacePosition)
+        public override SnapResult FindSnappedPositionAndTime(Vector2 screenSpacePosition)
         {
             throw new System.NotImplementedException();
         }
 
-        public override SnapResult SnapScreenSpacePositionToValidPosition(Vector2 screenSpacePosition)
+        public override SnapResult FindSnappedPosition(Vector2 screenSpacePosition)
         {
             throw new System.NotImplementedException();
         }
diff --git a/osu.Game.Rulesets.Mania/Edit/ManiaHitObjectComposer.cs b/osu.Game.Rulesets.Mania/Edit/ManiaHitObjectComposer.cs
index 2baec95c94..fef315e2ef 100644
--- a/osu.Game.Rulesets.Mania/Edit/ManiaHitObjectComposer.cs
+++ b/osu.Game.Rulesets.Mania/Edit/ManiaHitObjectComposer.cs
@@ -56,9 +56,9 @@ namespace osu.Game.Rulesets.Mania.Edit
         protected override Playfield PlayfieldAtScreenSpacePosition(Vector2 screenSpacePosition) =>
             Playfield.GetColumnByPosition(screenSpacePosition);
 
-        public override SnapResult SnapScreenSpacePositionToValidTime(Vector2 screenSpacePosition)
+        public override SnapResult FindSnappedPositionAndTime(Vector2 screenSpacePosition)
         {
-            var result = base.SnapScreenSpacePositionToValidTime(screenSpacePosition);
+            var result = base.FindSnappedPositionAndTime(screenSpacePosition);
 
             switch (ScrollingInfo.Direction.Value)
             {
@@ -112,7 +112,7 @@ namespace osu.Game.Rulesets.Mania.Edit
             }
             else
             {
-                var result = SnapScreenSpacePositionToValidTime(inputManager.CurrentState.Mouse.Position);
+                var result = FindSnappedPositionAndTime(inputManager.CurrentState.Mouse.Position);
                 if (result.Time is double time)
                     beatSnapGrid.SelectionTimeRange = (time, time);
                 else
diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuDistanceSnapGrid.cs b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuDistanceSnapGrid.cs
index 2ba30c5f74..27381d9d55 100644
--- a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuDistanceSnapGrid.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuDistanceSnapGrid.cs
@@ -182,10 +182,10 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
 
         private class SnapProvider : IDistanceSnapProvider
         {
-            public SnapResult SnapScreenSpacePositionToValidPosition(Vector2 screenSpacePosition) =>
+            public SnapResult FindSnappedPosition(Vector2 screenSpacePosition) =>
                 new SnapResult(screenSpacePosition, null);
 
-            public SnapResult SnapScreenSpacePositionToValidTime(Vector2 screenSpacePosition) => new SnapResult(screenSpacePosition, 0);
+            public SnapResult FindSnappedPositionAndTime(Vector2 screenSpacePosition) => new SnapResult(screenSpacePosition, 0);
 
             public IBindable<double> DistanceSpacingMultiplier { get; } = new BindableDouble(1);
 
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 5de614722f..e71bde7357 100644
--- a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointVisualiser.cs
+++ b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointVisualiser.cs
@@ -255,7 +255,7 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders.Components
             {
                 // Special handling for selections containing head control point - the position of the slider changes which means the snapped position and time have to be taken into account
                 Vector2 newHeadPosition = Parent.ToScreenSpace(e.MousePosition + (dragStartPositions[0] - dragStartPositions[draggedControlPointIndex]));
-                var result = snapProvider?.SnapScreenSpacePositionToValidTime(newHeadPosition);
+                var result = snapProvider?.FindSnappedPositionAndTime(newHeadPosition);
 
                 Vector2 movementDelta = Parent.ToLocalSpace(result?.ScreenSpacePosition ?? newHeadPosition) - slider.Position;
 
diff --git a/osu.Game.Rulesets.Osu/Edit/OsuHitObjectComposer.cs b/osu.Game.Rulesets.Osu/Edit/OsuHitObjectComposer.cs
index ba7c6e9d33..02beb0f2a4 100644
--- a/osu.Game.Rulesets.Osu/Edit/OsuHitObjectComposer.cs
+++ b/osu.Game.Rulesets.Osu/Edit/OsuHitObjectComposer.cs
@@ -123,7 +123,7 @@ namespace osu.Game.Rulesets.Osu.Edit
             }
         }
 
-        public override SnapResult SnapScreenSpacePositionToValidPosition(Vector2 screenSpacePosition)
+        public override SnapResult FindSnappedPosition(Vector2 screenSpacePosition)
         {
             if (snapToVisibleBlueprints(screenSpacePosition, out var snapResult))
                 return snapResult;
@@ -131,9 +131,9 @@ namespace osu.Game.Rulesets.Osu.Edit
             return new SnapResult(screenSpacePosition, null);
         }
 
-        public override SnapResult SnapScreenSpacePositionToValidTime(Vector2 screenSpacePosition)
+        public override SnapResult FindSnappedPositionAndTime(Vector2 screenSpacePosition)
         {
-            var positionSnap = SnapScreenSpacePositionToValidPosition(screenSpacePosition);
+            var positionSnap = FindSnappedPosition(screenSpacePosition);
             if (positionSnap.ScreenSpacePosition != screenSpacePosition)
                 return positionSnap;
 
@@ -149,7 +149,7 @@ namespace osu.Game.Rulesets.Osu.Edit
                 return new SnapResult(rectangularPositionSnapGrid.ToScreenSpace(pos), null, PlayfieldAtScreenSpacePosition(screenSpacePosition));
             }
 
-            return base.SnapScreenSpacePositionToValidTime(screenSpacePosition);
+            return base.FindSnappedPositionAndTime(screenSpacePosition);
         }
 
         private bool snapToVisibleBlueprints(Vector2 screenSpacePosition, out SnapResult snapResult)
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneDistanceSnapGrid.cs b/osu.Game.Tests/Visual/Editing/TestSceneDistanceSnapGrid.cs
index b9cfa84a5d..1be4ac2eab 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneDistanceSnapGrid.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneDistanceSnapGrid.cs
@@ -162,10 +162,10 @@ namespace osu.Game.Tests.Visual.Editing
 
         private class SnapProvider : IDistanceSnapProvider
         {
-            public SnapResult SnapScreenSpacePositionToValidPosition(Vector2 screenSpacePosition) =>
+            public SnapResult FindSnappedPosition(Vector2 screenSpacePosition) =>
                 new SnapResult(screenSpacePosition, null);
 
-            public SnapResult SnapScreenSpacePositionToValidTime(Vector2 screenSpacePosition) => new SnapResult(screenSpacePosition, 0);
+            public SnapResult FindSnappedPositionAndTime(Vector2 screenSpacePosition) => new SnapResult(screenSpacePosition, 0);
 
             public IBindable<double> DistanceSpacingMultiplier { get; } = new BindableDouble(1);
 
diff --git a/osu.Game/Rulesets/Edit/HitObjectComposer.cs b/osu.Game/Rulesets/Edit/HitObjectComposer.cs
index 1c388fe68f..e0cfd5c74a 100644
--- a/osu.Game/Rulesets/Edit/HitObjectComposer.cs
+++ b/osu.Game/Rulesets/Edit/HitObjectComposer.cs
@@ -362,7 +362,7 @@ namespace osu.Game.Rulesets.Edit
         /// <returns>The most relevant <see cref="Playfield"/>.</returns>
         protected virtual Playfield PlayfieldAtScreenSpacePosition(Vector2 screenSpacePosition) => drawableRulesetWrapper.Playfield;
 
-        public override SnapResult SnapScreenSpacePositionToValidTime(Vector2 screenSpacePosition)
+        public override SnapResult FindSnappedPositionAndTime(Vector2 screenSpacePosition)
         {
             var playfield = PlayfieldAtScreenSpacePosition(screenSpacePosition);
             double? targetTime = null;
@@ -416,9 +416,9 @@ namespace osu.Game.Rulesets.Edit
 
         #region IPositionSnapProvider
 
-        public abstract SnapResult SnapScreenSpacePositionToValidTime(Vector2 screenSpacePosition);
+        public abstract SnapResult FindSnappedPositionAndTime(Vector2 screenSpacePosition);
 
-        public virtual SnapResult SnapScreenSpacePositionToValidPosition(Vector2 screenSpacePosition) =>
+        public virtual SnapResult FindSnappedPosition(Vector2 screenSpacePosition) =>
             new SnapResult(screenSpacePosition, null);
 
         #endregion
diff --git a/osu.Game/Rulesets/Edit/IPositionSnapProvider.cs b/osu.Game/Rulesets/Edit/IPositionSnapProvider.cs
index 8a179ed424..8b6dbb6af3 100644
--- a/osu.Game/Rulesets/Edit/IPositionSnapProvider.cs
+++ b/osu.Game/Rulesets/Edit/IPositionSnapProvider.cs
@@ -5,23 +5,27 @@ using osuTK;
 
 namespace osu.Game.Rulesets.Edit
 {
+    /// <summary>
+    /// A snap provider which given the position of a hit object, offers a more correct position and time value inferred from the context of the beatmap.
+    /// Provided values are done so in an isolated context, without consideration of other nearby hit objects.
+    /// </summary>
     public interface IPositionSnapProvider
     {
         /// <summary>
         /// Given a position, find a valid time and position snap.
         /// </summary>
         /// <remarks>
-        /// This call should be equivalent to running <see cref="SnapScreenSpacePositionToValidPosition"/> with any additional logic that can be performed without the time immutability restriction.
+        /// This call should be equivalent to running <see cref="FindSnappedPosition"/> with any additional logic that can be performed without the time immutability restriction.
         /// </remarks>
         /// <param name="screenSpacePosition">The screen-space position to be snapped.</param>
         /// <returns>The time and position post-snapping.</returns>
-        SnapResult SnapScreenSpacePositionToValidTime(Vector2 screenSpacePosition);
+        SnapResult FindSnappedPositionAndTime(Vector2 screenSpacePosition);
 
         /// <summary>
         /// Given a position, find a value position snap, restricting time to its input value.
         /// </summary>
         /// <param name="screenSpacePosition">The screen-space position to be snapped.</param>
         /// <returns>The position post-snapping. Time will always be null.</returns>
-        SnapResult SnapScreenSpacePositionToValidPosition(Vector2 screenSpacePosition);
+        SnapResult FindSnappedPosition(Vector2 screenSpacePosition);
     }
 }
diff --git a/osu.Game/Screens/Edit/Compose/Components/BlueprintContainer.cs b/osu.Game/Screens/Edit/Compose/Components/BlueprintContainer.cs
index 6dc6f20cfe..186c66e0af 100644
--- a/osu.Game/Screens/Edit/Compose/Components/BlueprintContainer.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/BlueprintContainer.cs
@@ -486,7 +486,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
                     Vector2 originalPosition = movementBlueprintOriginalPositions[i];
                     var testPosition = originalPosition + distanceTravelled;
 
-                    var positionalResult = snapProvider.SnapScreenSpacePositionToValidPosition(testPosition);
+                    var positionalResult = snapProvider.FindSnappedPosition(testPosition);
 
                     if (positionalResult.ScreenSpacePosition == testPosition) continue;
 
@@ -505,7 +505,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
             Vector2 movePosition = movementBlueprintOriginalPositions.First() + distanceTravelled;
 
             // Retrieve a snapped position.
-            var result = snapProvider?.SnapScreenSpacePositionToValidTime(movePosition);
+            var result = snapProvider?.FindSnappedPositionAndTime(movePosition);
 
             if (result == null)
             {
diff --git a/osu.Game/Screens/Edit/Compose/Components/ComposeBlueprintContainer.cs b/osu.Game/Screens/Edit/Compose/Components/ComposeBlueprintContainer.cs
index 79b38861ee..68be20720d 100644
--- a/osu.Game/Screens/Edit/Compose/Components/ComposeBlueprintContainer.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/ComposeBlueprintContainer.cs
@@ -214,7 +214,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
 
         private void updatePlacementPosition()
         {
-            var snapResult = Composer.SnapScreenSpacePositionToValidTime(inputManager.CurrentState.Mouse.Position);
+            var snapResult = Composer.FindSnappedPositionAndTime(inputManager.CurrentState.Mouse.Position);
 
             // if no time was found from positional snapping, we should still quantize to the beat.
             snapResult.Time ??= Beatmap.SnapTime(EditorClock.CurrentTime, null);
diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/Timeline.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/Timeline.cs
index c2b2bdb861..56ff972801 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/Timeline.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/Timeline.cs
@@ -307,10 +307,10 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
         /// </summary>
         public double VisibleRange => track.Length / Zoom;
 
-        public SnapResult SnapScreenSpacePositionToValidPosition(Vector2 screenSpacePosition) =>
+        public SnapResult FindSnappedPosition(Vector2 screenSpacePosition) =>
             new SnapResult(screenSpacePosition, null);
 
-        public SnapResult SnapScreenSpacePositionToValidTime(Vector2 screenSpacePosition) =>
+        public SnapResult FindSnappedPositionAndTime(Vector2 screenSpacePosition) =>
             new SnapResult(screenSpacePosition, beatSnapProvider.SnapTime(getTimeFromPosition(Content.ToLocalSpace(screenSpacePosition))));
 
         private double getTimeFromPosition(Vector2 localPosition) =>
diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineHitObjectBlueprint.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineHitObjectBlueprint.cs
index 6426d33e99..33ea137d51 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineHitObjectBlueprint.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineHitObjectBlueprint.cs
@@ -382,7 +382,7 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
                 {
                     OnDragHandled?.Invoke(e);
 
-                    if (timeline.SnapScreenSpacePositionToValidTime(e.ScreenSpaceMousePosition).Time is double time)
+                    if (timeline.FindSnappedPositionAndTime(e.ScreenSpaceMousePosition).Time is double time)
                     {
                         switch (hitObject)
                         {

From 1fce0da33189907d8c14588af5b35dd8b5efb13a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 5 May 2022 16:04:34 +0900
Subject: [PATCH 4513/5547] Reword slightly, to allow better conformity with
 `IDistanceSnapProvider`

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

diff --git a/osu.Game/Rulesets/Edit/IPositionSnapProvider.cs b/osu.Game/Rulesets/Edit/IPositionSnapProvider.cs
index 8b6dbb6af3..c6a365938c 100644
--- a/osu.Game/Rulesets/Edit/IPositionSnapProvider.cs
+++ b/osu.Game/Rulesets/Edit/IPositionSnapProvider.cs
@@ -6,8 +6,8 @@ using osuTK;
 namespace osu.Game.Rulesets.Edit
 {
     /// <summary>
-    /// A snap provider which given the position of a hit object, offers a more correct position and time value inferred from the context of the beatmap.
-    /// Provided values are done so in an isolated context, without consideration of other nearby hit objects.
+    /// A snap provider which given a proposed position for a hit object, potentially offers a more correct position and time value inferred from the context of the beatmap.
+    /// Provided values are inferred in an isolated context, without consideration of other nearby hit objects.
     /// </summary>
     public interface IPositionSnapProvider
     {

From ac6342ff8d22213ac41a2df547ab69c816641a21 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 5 May 2022 10:16:16 +0300
Subject: [PATCH 4514/5547] Add workaround for item scrolling issue

---
 osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs
index 840fc48613..2a72fc6eb1 100644
--- a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs
+++ b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs
@@ -190,7 +190,12 @@ namespace osu.Game.Screens.OnlinePlay
             if (SelectedItem.Value == null || !ItemMap.TryGetValue(SelectedItem.Value, out var drawableItem))
                 return;
 
-            ScrollContainer.ScrollIntoView(drawableItem);
+            // ScrollIntoView does not handle non-loaded items appropriately, delay scroll until the item finishes loading.
+            // see: https://github.com/ppy/osu-framework/issues/5158
+            if (!drawableItem.IsLoaded)
+                drawableItem.OnLoadComplete += _ => ScrollContainer.ScrollIntoView(drawableItem);
+            else
+                ScrollContainer.ScrollIntoView(drawableItem);
         }
 
         #region Key selection logic (shared with BeatmapCarousel and RoomsContainer)

From 6227e3f876bfd9d6fceebb5e2f7a8a276fdcccf6 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 5 May 2022 16:17:37 +0900
Subject: [PATCH 4515/5547] Add comprehensive documentation of
 `BeatmapInfo.DistanceSpacing`

---
 osu.Game/Beatmaps/BeatmapInfo.cs | 16 ++++++++++++++--
 1 file changed, 14 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapInfo.cs b/osu.Game/Beatmaps/BeatmapInfo.cs
index 1a9703f478..abc9020dc6 100644
--- a/osu.Game/Beatmaps/BeatmapInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapInfo.cs
@@ -1,21 +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.
 
+#nullable enable
+
 using System;
 using System.Linq;
 using JetBrains.Annotations;
 using Newtonsoft.Json;
 using osu.Framework.Testing;
+using osu.Game.Beatmaps.ControlPoints;
 using osu.Game.Database;
 using osu.Game.Models;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays.BeatmapSet.Scores;
 using osu.Game.Rulesets;
+using osu.Game.Rulesets.Edit;
 using osu.Game.Scoring;
 using Realms;
 
-#nullable enable
-
 namespace osu.Game.Beatmaps
 {
     /// <summary>
@@ -109,6 +111,16 @@ namespace osu.Game.Beatmaps
 
         public bool SamplesMatchPlaybackRate { get; set; } = true;
 
+        /// <summary>
+        /// The ratio of distance travelled per time unit.
+        /// Generally used to decouple the spacing between hit objects from the enforced "velocity" of the beatmap (see <see cref="DifficultyControlPoint.SliderVelocity"/>).
+        /// </summary>
+        /// <remarks>
+        /// The most common method of understanding is that at a default value of 1.0, the time-to-distance ratio will match the slider velocity of the beatmap
+        /// at the current point in time. Increasing this value will make hit objects more spaced apart when compared to the cursor movement required to track a slider.
+        ///
+        /// This is only a hint property, used by the editor in <see cref="IDistanceSnapProvider"/> implementations. It does not directly affect the beatmap or gameplay.
+        /// </remarks>
         public double DistanceSpacing { get; set; } = 1.0;
 
         public int BeatDivisor { get; set; }

From 977e6d8a8081fff93503156670ce034ec54387f7 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 5 May 2022 16:25:05 +0900
Subject: [PATCH 4516/5547] Add xmldoc for `IDistanceSnapProvider` and related
 properties

---
 .../Editor/TestSceneOsuDistanceSnapGrid.cs    |  4 ++--
 .../Sliders/SliderPlacementBlueprint.cs       |  2 +-
 ...tSceneHitObjectComposerDistanceSnapping.cs |  4 ++--
 .../Editing/TestSceneDistanceSnapGrid.cs      |  4 ++--
 .../Edit/DistancedHitObjectComposer.cs        |  4 ++--
 .../Rulesets/Edit/IDistanceSnapProvider.cs    | 23 +++++++++++--------
 .../Rulesets/Objects/SliderPathExtensions.cs  |  2 +-
 .../Components/CircularDistanceSnapGrid.cs    |  2 +-
 8 files changed, 25 insertions(+), 20 deletions(-)

diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuDistanceSnapGrid.cs b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuDistanceSnapGrid.cs
index 2ba30c5f74..2ea39e47f4 100644
--- a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuDistanceSnapGrid.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuDistanceSnapGrid.cs
@@ -195,9 +195,9 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
 
             public double DistanceToDuration(HitObject referenceObject, float distance) => distance;
 
-            public double GetSnappedDurationFromDistance(HitObject referenceObject, float distance) => 0;
+            public double FindSnappedDuration(HitObject referenceObject, float distance) => 0;
 
-            public float GetSnappedDistanceFromDistance(HitObject referenceObject, float distance) => 0;
+            public float FindSnappedDistance(HitObject referenceObject, float distance) => 0;
         }
     }
 }
diff --git a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/SliderPlacementBlueprint.cs b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/SliderPlacementBlueprint.cs
index 73a4ea5434..501589987d 100644
--- a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/SliderPlacementBlueprint.cs
+++ b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/SliderPlacementBlueprint.cs
@@ -220,7 +220,7 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders
 
         private void updateSlider()
         {
-            HitObject.Path.ExpectedDistance.Value = snapProvider?.GetSnappedDistanceFromDistance(HitObject, (float)HitObject.Path.CalculatedDistance) ?? (float)HitObject.Path.CalculatedDistance;
+            HitObject.Path.ExpectedDistance.Value = snapProvider?.FindSnappedDistance(HitObject, (float)HitObject.Path.CalculatedDistance) ?? (float)HitObject.Path.CalculatedDistance;
 
             bodyPiece.UpdateFrom(HitObject);
             headCirclePiece.UpdateFrom(HitObject.HeadCircle);
diff --git a/osu.Game.Tests/Editing/TestSceneHitObjectComposerDistanceSnapping.cs b/osu.Game.Tests/Editing/TestSceneHitObjectComposerDistanceSnapping.cs
index a2ee97210a..82fc7a208b 100644
--- a/osu.Game.Tests/Editing/TestSceneHitObjectComposerDistanceSnapping.cs
+++ b/osu.Game.Tests/Editing/TestSceneHitObjectComposerDistanceSnapping.cs
@@ -213,10 +213,10 @@ namespace osu.Game.Tests.Editing
             => AddAssert($"distance = {distance} -> duration = {expectedDuration}", () => composer.DistanceToDuration(new HitObject(), distance) == expectedDuration);
 
         private void assertSnappedDuration(float distance, double expectedDuration)
-            => AddAssert($"distance = {distance} -> duration = {expectedDuration} (snapped)", () => composer.GetSnappedDurationFromDistance(new HitObject(), distance) == expectedDuration);
+            => AddAssert($"distance = {distance} -> duration = {expectedDuration} (snapped)", () => composer.FindSnappedDuration(new HitObject(), distance) == expectedDuration);
 
         private void assertSnappedDistance(float distance, float expectedDistance)
-            => AddAssert($"distance = {distance} -> distance = {expectedDistance} (snapped)", () => composer.GetSnappedDistanceFromDistance(new HitObject(), distance) == expectedDistance);
+            => AddAssert($"distance = {distance} -> distance = {expectedDistance} (snapped)", () => composer.FindSnappedDistance(new HitObject(), distance) == expectedDistance);
 
         private class TestHitObjectComposer : OsuHitObjectComposer
         {
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneDistanceSnapGrid.cs b/osu.Game.Tests/Visual/Editing/TestSceneDistanceSnapGrid.cs
index b9cfa84a5d..7cb1e8f36a 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneDistanceSnapGrid.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneDistanceSnapGrid.cs
@@ -175,9 +175,9 @@ namespace osu.Game.Tests.Visual.Editing
 
             public double DistanceToDuration(HitObject referenceObject, float distance) => distance;
 
-            public double GetSnappedDurationFromDistance(HitObject referenceObject, float distance) => 0;
+            public double FindSnappedDuration(HitObject referenceObject, float distance) => 0;
 
-            public float GetSnappedDistanceFromDistance(HitObject referenceObject, float distance) => 0;
+            public float FindSnappedDistance(HitObject referenceObject, float distance) => 0;
         }
     }
 }
diff --git a/osu.Game/Rulesets/Edit/DistancedHitObjectComposer.cs b/osu.Game/Rulesets/Edit/DistancedHitObjectComposer.cs
index 680fc9aaa8..2280211421 100644
--- a/osu.Game/Rulesets/Edit/DistancedHitObjectComposer.cs
+++ b/osu.Game/Rulesets/Edit/DistancedHitObjectComposer.cs
@@ -146,10 +146,10 @@ namespace osu.Game.Rulesets.Edit
             return distance / GetBeatSnapDistanceAt(referenceObject) * beatLength;
         }
 
-        public virtual double GetSnappedDurationFromDistance(HitObject referenceObject, float distance)
+        public virtual double FindSnappedDuration(HitObject referenceObject, float distance)
             => BeatSnapProvider.SnapTime(referenceObject.StartTime + DistanceToDuration(referenceObject, distance), referenceObject.StartTime) - referenceObject.StartTime;
 
-        public virtual float GetSnappedDistanceFromDistance(HitObject referenceObject, float distance)
+        public virtual float FindSnappedDistance(HitObject referenceObject, float distance)
         {
             double startTime = referenceObject.StartTime;
 
diff --git a/osu.Game/Rulesets/Edit/IDistanceSnapProvider.cs b/osu.Game/Rulesets/Edit/IDistanceSnapProvider.cs
index c6e866561e..8e4e9afb1c 100644
--- a/osu.Game/Rulesets/Edit/IDistanceSnapProvider.cs
+++ b/osu.Game/Rulesets/Edit/IDistanceSnapProvider.cs
@@ -7,10 +7,13 @@ using osu.Game.Rulesets.Objects;
 
 namespace osu.Game.Rulesets.Edit
 {
+    /// <summary>
+    /// A snap provider which given a reference hit object and proposed distance from it, offers a more correct duration or distance value.
+    /// </summary>
     public interface IDistanceSnapProvider : IPositionSnapProvider
     {
         /// <summary>
-        /// The spacing multiplier applied to beat snap distances.
+        /// A multiplier which changes the ratio of distance travelled per time unit.
         /// </summary>
         /// <seealso cref="BeatmapInfo.DistanceSpacing"/>
         IBindable<double> DistanceSpacingMultiplier { get; }
@@ -23,7 +26,7 @@ namespace osu.Game.Rulesets.Edit
         float GetBeatSnapDistanceAt(HitObject referenceObject);
 
         /// <summary>
-        /// Converts a duration to a distance.
+        /// Converts a duration to a distance without applying any snapping.
         /// </summary>
         /// <param name="referenceObject">An object to be used as a reference point for this operation.</param>
         /// <param name="duration">The duration to convert.</param>
@@ -31,7 +34,7 @@ namespace osu.Game.Rulesets.Edit
         float DurationToDistance(HitObject referenceObject, double duration);
 
         /// <summary>
-        /// Converts a distance to a duration.
+        /// Converts a distance to a duration without applying any snapping.
         /// </summary>
         /// <param name="referenceObject">An object to be used as a reference point for this operation.</param>
         /// <param name="distance">The distance to convert.</param>
@@ -39,20 +42,22 @@ namespace osu.Game.Rulesets.Edit
         double DistanceToDuration(HitObject referenceObject, float distance);
 
         /// <summary>
-        /// Converts a distance to a snapped duration.
+        /// Given a distance from the provided hit object, find the valid snapped duration.
         /// </summary>
         /// <param name="referenceObject">An object to be used as a reference point for this operation.</param>
         /// <param name="distance">The distance to convert.</param>
         /// <returns>A value that represents <paramref name="distance"/> as a duration snapped to the closest beat of the timing point.</returns>
-        double GetSnappedDurationFromDistance(HitObject referenceObject, float distance);
+        double FindSnappedDuration(HitObject referenceObject, float distance);
 
         /// <summary>
-        /// Converts an unsnapped distance to a snapped distance.
-        /// The returned distance will always be floored (as to never exceed the provided <paramref name="distance"/>.
+        /// Given a distance from the provided hit object, find the valid snapped distance.
         /// </summary>
         /// <param name="referenceObject">An object to be used as a reference point for this operation.</param>
         /// <param name="distance">The distance to convert.</param>
-        /// <returns>A value that represents <paramref name="distance"/> snapped to the closest beat of the timing point.</returns>
-        float GetSnappedDistanceFromDistance(HitObject referenceObject, float distance);
+        /// <returns>
+        /// A value that represents <paramref name="distance"/> snapped to the closest beat of the timing point.
+        /// The distance will always be less than or equal to the provided <paramref name="distance"/>.
+        /// </returns>
+        float FindSnappedDistance(HitObject referenceObject, float distance);
     }
 }
diff --git a/osu.Game/Rulesets/Objects/SliderPathExtensions.cs b/osu.Game/Rulesets/Objects/SliderPathExtensions.cs
index 3100d26a55..dd418a1b7b 100644
--- a/osu.Game/Rulesets/Objects/SliderPathExtensions.cs
+++ b/osu.Game/Rulesets/Objects/SliderPathExtensions.cs
@@ -18,7 +18,7 @@ namespace osu.Game.Rulesets.Objects
         public static void SnapTo<THitObject>(this THitObject hitObject, IDistanceSnapProvider? snapProvider)
             where THitObject : HitObject, IHasPath
         {
-            hitObject.Path.ExpectedDistance.Value = snapProvider?.GetSnappedDistanceFromDistance(hitObject, (float)hitObject.Path.CalculatedDistance) ?? hitObject.Path.CalculatedDistance;
+            hitObject.Path.ExpectedDistance.Value = snapProvider?.FindSnappedDistance(hitObject, (float)hitObject.Path.CalculatedDistance) ?? hitObject.Path.CalculatedDistance;
         }
 
         /// <summary>
diff --git a/osu.Game/Screens/Edit/Compose/Components/CircularDistanceSnapGrid.cs b/osu.Game/Screens/Edit/Compose/Components/CircularDistanceSnapGrid.cs
index 6b32ff96c4..50d5f0389a 100644
--- a/osu.Game/Screens/Edit/Compose/Components/CircularDistanceSnapGrid.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/CircularDistanceSnapGrid.cs
@@ -80,7 +80,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
             Vector2 normalisedDirection = direction * new Vector2(1f / distance);
             Vector2 snappedPosition = StartPosition + normalisedDirection * radialCount * radius;
 
-            return (snappedPosition, StartTime + SnapProvider.GetSnappedDurationFromDistance(ReferenceObject, (snappedPosition - StartPosition).Length));
+            return (snappedPosition, StartTime + SnapProvider.FindSnappedDuration(ReferenceObject, (snappedPosition - StartPosition).Length));
         }
     }
 }

From b411b59006da5cfbb5d39cd0e0754db943b3f298 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 5 May 2022 16:32:14 +0900
Subject: [PATCH 4517/5547] Move `IPlacementHandler` caching to interface

---
 osu.Game/Rulesets/Edit/HitObjectComposer.cs          | 1 -
 osu.Game/Screens/Edit/Compose/IPlacementHandler.cs   | 2 ++
 osu.Game/Tests/Visual/PlacementBlueprintTestScene.cs | 1 -
 3 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Rulesets/Edit/HitObjectComposer.cs b/osu.Game/Rulesets/Edit/HitObjectComposer.cs
index 1c388fe68f..fdc12bf549 100644
--- a/osu.Game/Rulesets/Edit/HitObjectComposer.cs
+++ b/osu.Game/Rulesets/Edit/HitObjectComposer.cs
@@ -35,7 +35,6 @@ namespace osu.Game.Rulesets.Edit
     /// Responsible for providing snapping and generally gluing components together.
     /// </summary>
     /// <typeparam name="TObject">The base type of supported objects.</typeparam>
-    [Cached(Type = typeof(IPlacementHandler))]
     public abstract class HitObjectComposer<TObject> : HitObjectComposer, IPlacementHandler
         where TObject : HitObject
     {
diff --git a/osu.Game/Screens/Edit/Compose/IPlacementHandler.cs b/osu.Game/Screens/Edit/Compose/IPlacementHandler.cs
index aefcbc6542..59eb13cae5 100644
--- a/osu.Game/Screens/Edit/Compose/IPlacementHandler.cs
+++ b/osu.Game/Screens/Edit/Compose/IPlacementHandler.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 osu.Framework.Allocation;
 using osu.Game.Rulesets.Objects;
 
 namespace osu.Game.Screens.Edit.Compose
 {
+    [Cached]
     public interface IPlacementHandler
     {
         /// <summary>
diff --git a/osu.Game/Tests/Visual/PlacementBlueprintTestScene.cs b/osu.Game/Tests/Visual/PlacementBlueprintTestScene.cs
index b2f5b1754f..b981a31bd1 100644
--- a/osu.Game/Tests/Visual/PlacementBlueprintTestScene.cs
+++ b/osu.Game/Tests/Visual/PlacementBlueprintTestScene.cs
@@ -14,7 +14,6 @@ using osu.Game.Screens.Edit.Compose;
 
 namespace osu.Game.Tests.Visual
 {
-    [Cached(Type = typeof(IPlacementHandler))]
     public abstract class PlacementBlueprintTestScene : OsuManualInputManagerTestScene, IPlacementHandler
     {
         protected readonly Container HitObjectContainer;

From 1c6a233cc0daba2519a3ba54609ebabea6c7c637 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 5 May 2022 16:35:52 +0900
Subject: [PATCH 4518/5547] Move snap provider caching to interfaces

---
 osu.Game/Rulesets/Edit/DistancedHitObjectComposer.cs          | 1 -
 osu.Game/Rulesets/Edit/HitObjectComposer.cs                   | 1 -
 osu.Game/Rulesets/Edit/IDistanceSnapProvider.cs               | 2 ++
 osu.Game/Rulesets/Edit/IPositionSnapProvider.cs               | 2 ++
 osu.Game/Screens/Edit/Compose/Components/Timeline/Timeline.cs | 1 -
 5 files changed, 4 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Rulesets/Edit/DistancedHitObjectComposer.cs b/osu.Game/Rulesets/Edit/DistancedHitObjectComposer.cs
index 680fc9aaa8..7a997bb423 100644
--- a/osu.Game/Rulesets/Edit/DistancedHitObjectComposer.cs
+++ b/osu.Game/Rulesets/Edit/DistancedHitObjectComposer.cs
@@ -23,7 +23,6 @@ namespace osu.Game.Rulesets.Edit
     /// Represents a <see cref="HitObjectComposer{TObject}"/> for rulesets with the concept of distances between objects.
     /// </summary>
     /// <typeparam name="TObject">The base type of supported objects.</typeparam>
-    [Cached(typeof(IDistanceSnapProvider))]
     public abstract class DistancedHitObjectComposer<TObject> : HitObjectComposer<TObject>, IDistanceSnapProvider, IScrollBindingHandler<GlobalAction>
         where TObject : HitObject
     {
diff --git a/osu.Game/Rulesets/Edit/HitObjectComposer.cs b/osu.Game/Rulesets/Edit/HitObjectComposer.cs
index fdc12bf549..c384eb4ea9 100644
--- a/osu.Game/Rulesets/Edit/HitObjectComposer.cs
+++ b/osu.Game/Rulesets/Edit/HitObjectComposer.cs
@@ -388,7 +388,6 @@ namespace osu.Game.Rulesets.Edit
     /// Generally used to access certain methods without requiring a generic type for <see cref="HitObjectComposer{T}" />.
     /// </summary>
     [Cached(typeof(HitObjectComposer))]
-    [Cached(typeof(IPositionSnapProvider))]
     public abstract class HitObjectComposer : CompositeDrawable, IPositionSnapProvider
     {
         protected HitObjectComposer()
diff --git a/osu.Game/Rulesets/Edit/IDistanceSnapProvider.cs b/osu.Game/Rulesets/Edit/IDistanceSnapProvider.cs
index c6e866561e..7850edf3f1 100644
--- a/osu.Game/Rulesets/Edit/IDistanceSnapProvider.cs
+++ b/osu.Game/Rulesets/Edit/IDistanceSnapProvider.cs
@@ -1,12 +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.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Objects;
 
 namespace osu.Game.Rulesets.Edit
 {
+    [Cached]
     public interface IDistanceSnapProvider : IPositionSnapProvider
     {
         /// <summary>
diff --git a/osu.Game/Rulesets/Edit/IPositionSnapProvider.cs b/osu.Game/Rulesets/Edit/IPositionSnapProvider.cs
index 8a179ed424..d7379b26ce 100644
--- a/osu.Game/Rulesets/Edit/IPositionSnapProvider.cs
+++ b/osu.Game/Rulesets/Edit/IPositionSnapProvider.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 osu.Framework.Allocation;
 using osuTK;
 
 namespace osu.Game.Rulesets.Edit
 {
+    [Cached]
     public interface IPositionSnapProvider
     {
         /// <summary>
diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/Timeline.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/Timeline.cs
index c2b2bdb861..f91b321835 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/Timeline.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/Timeline.cs
@@ -19,7 +19,6 @@ using osuTK;
 
 namespace osu.Game.Screens.Edit.Compose.Components.Timeline
 {
-    [Cached(typeof(IPositionSnapProvider))]
     [Cached]
     public class Timeline : ZoomableScrollContainer, IPositionSnapProvider
     {

From 5a1ac71d90fdb698d6e8e2a68ef7779faf651acd Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 5 May 2022 16:42:57 +0900
Subject: [PATCH 4519/5547] Remove unnecessary type specification in
 `HitObjectComposer`'s caching

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

diff --git a/osu.Game/Rulesets/Edit/HitObjectComposer.cs b/osu.Game/Rulesets/Edit/HitObjectComposer.cs
index c384eb4ea9..b97690c9e0 100644
--- a/osu.Game/Rulesets/Edit/HitObjectComposer.cs
+++ b/osu.Game/Rulesets/Edit/HitObjectComposer.cs
@@ -387,7 +387,7 @@ namespace osu.Game.Rulesets.Edit
     /// A non-generic definition of a HitObject composer class.
     /// Generally used to access certain methods without requiring a generic type for <see cref="HitObjectComposer{T}" />.
     /// </summary>
-    [Cached(typeof(HitObjectComposer))]
+    [Cached]
     public abstract class HitObjectComposer : CompositeDrawable, IPositionSnapProvider
     {
         protected HitObjectComposer()

From c3d2648f85bd87289cb58a5622038e2f4d44e7f4 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 5 May 2022 17:07:05 +0900
Subject: [PATCH 4520/5547] Reword weird 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/Rulesets/Edit/IPositionSnapProvider.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Rulesets/Edit/IPositionSnapProvider.cs b/osu.Game/Rulesets/Edit/IPositionSnapProvider.cs
index c6a365938c..200005cb11 100644
--- a/osu.Game/Rulesets/Edit/IPositionSnapProvider.cs
+++ b/osu.Game/Rulesets/Edit/IPositionSnapProvider.cs
@@ -22,7 +22,7 @@ namespace osu.Game.Rulesets.Edit
         SnapResult FindSnappedPositionAndTime(Vector2 screenSpacePosition);
 
         /// <summary>
-        /// Given a position, find a value position snap, restricting time to its input value.
+        /// Given a position, find a valid position snap, without changing the time value.
         /// </summary>
         /// <param name="screenSpacePosition">The screen-space position to be snapped.</param>
         /// <returns>The position post-snapping. Time will always be null.</returns>

From de9b3d33ebfba7beefe36f659e3a8aa77ab6a7eb Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 5 May 2022 17:00:36 +0900
Subject: [PATCH 4521/5547] Rename misleading `DistanceSpacing` variable

---
 .../Editor/TestSceneOsuDistanceSnapGrid.cs       | 16 +++-------------
 .../Visual/Editing/TestSceneDistanceSnapGrid.cs  | 10 +++++-----
 .../Components/CircularDistanceSnapGrid.cs       | 10 +++++-----
 .../Edit/Compose/Components/DistanceSnapGrid.cs  |  8 ++++----
 4 files changed, 17 insertions(+), 27 deletions(-)

diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuDistanceSnapGrid.cs b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuDistanceSnapGrid.cs
index 368166157d..015a922719 100644
--- a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuDistanceSnapGrid.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuDistanceSnapGrid.cs
@@ -37,7 +37,7 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
         [Cached(typeof(IDistanceSnapProvider))]
         private readonly SnapProvider snapProvider = new SnapProvider();
 
-        private TestOsuDistanceSnapGrid grid;
+        private OsuDistanceSnapGrid grid;
 
         public TestSceneOsuDistanceSnapGrid()
         {
@@ -64,7 +64,7 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
                     RelativeSizeAxes = Axes.Both,
                     Colour = Color4.SlateGray
                 },
-                grid = new TestOsuDistanceSnapGrid(new HitCircle { Position = grid_position }),
+                grid = new OsuDistanceSnapGrid(new HitCircle { Position = grid_position }),
                 new SnappingCursorContainer { GetSnapPosition = v => grid.GetSnappedPosition(grid.ToLocalSpace(v)).position }
             };
         });
@@ -115,7 +115,7 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
                         RelativeSizeAxes = Axes.Both,
                         Colour = Color4.SlateGray
                     },
-                    grid = new TestOsuDistanceSnapGrid(new HitCircle { Position = grid_position }, new HitCircle { StartTime = 200 }),
+                    grid = new OsuDistanceSnapGrid(new HitCircle { Position = grid_position }, new HitCircle { StartTime = 200 }),
                     new SnappingCursorContainer { GetSnapPosition = v => grid.GetSnappedPosition(grid.ToLocalSpace(v)).position }
                 };
             });
@@ -170,16 +170,6 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
             }
         }
 
-        private class TestOsuDistanceSnapGrid : OsuDistanceSnapGrid
-        {
-            public new float DistanceSpacing => base.DistanceSpacing;
-
-            public TestOsuDistanceSnapGrid(OsuHitObject hitObject, OsuHitObject nextHitObject = null)
-                : base(hitObject, nextHitObject)
-            {
-            }
-        }
-
         private class SnapProvider : IDistanceSnapProvider
         {
             public SnapResult FindSnappedPosition(Vector2 screenSpacePosition) =>
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneDistanceSnapGrid.cs b/osu.Game.Tests/Visual/Editing/TestSceneDistanceSnapGrid.cs
index 38c0808a71..cdaa3739b7 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneDistanceSnapGrid.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneDistanceSnapGrid.cs
@@ -87,7 +87,7 @@ namespace osu.Game.Tests.Visual.Editing
 
         private class TestDistanceSnapGrid : DistanceSnapGrid
         {
-            public new float DistanceSpacing => base.DistanceSpacing;
+            public new float DistanceBetweenTick => base.DistanceBetweenTick;
 
             public TestDistanceSnapGrid(double? endTime = null)
                 : base(new HitObject(), grid_position, 0, endTime)
@@ -105,7 +105,7 @@ namespace osu.Game.Tests.Visual.Editing
 
                 int indexFromPlacement = 0;
 
-                for (float s = StartPosition.X + DistanceSpacing; s <= DrawWidth && indexFromPlacement < MaxIntervals; s += DistanceSpacing, indexFromPlacement++)
+                for (float s = StartPosition.X + DistanceBetweenTick; s <= DrawWidth && indexFromPlacement < MaxIntervals; s += DistanceBetweenTick, indexFromPlacement++)
                 {
                     AddInternal(new Circle
                     {
@@ -118,7 +118,7 @@ namespace osu.Game.Tests.Visual.Editing
 
                 indexFromPlacement = 0;
 
-                for (float s = StartPosition.X - DistanceSpacing; s >= 0 && indexFromPlacement < MaxIntervals; s -= DistanceSpacing, indexFromPlacement++)
+                for (float s = StartPosition.X - DistanceBetweenTick; s >= 0 && indexFromPlacement < MaxIntervals; s -= DistanceBetweenTick, indexFromPlacement++)
                 {
                     AddInternal(new Circle
                     {
@@ -131,7 +131,7 @@ namespace osu.Game.Tests.Visual.Editing
 
                 indexFromPlacement = 0;
 
-                for (float s = StartPosition.Y + DistanceSpacing; s <= DrawHeight && indexFromPlacement < MaxIntervals; s += DistanceSpacing, indexFromPlacement++)
+                for (float s = StartPosition.Y + DistanceBetweenTick; s <= DrawHeight && indexFromPlacement < MaxIntervals; s += DistanceBetweenTick, indexFromPlacement++)
                 {
                     AddInternal(new Circle
                     {
@@ -144,7 +144,7 @@ namespace osu.Game.Tests.Visual.Editing
 
                 indexFromPlacement = 0;
 
-                for (float s = StartPosition.Y - DistanceSpacing; s >= 0 && indexFromPlacement < MaxIntervals; s -= DistanceSpacing, indexFromPlacement++)
+                for (float s = StartPosition.Y - DistanceBetweenTick; s >= 0 && indexFromPlacement < MaxIntervals; s -= DistanceBetweenTick, indexFromPlacement++)
                 {
                     AddInternal(new Circle
                     {
diff --git a/osu.Game/Screens/Edit/Compose/Components/CircularDistanceSnapGrid.cs b/osu.Game/Screens/Edit/Compose/Components/CircularDistanceSnapGrid.cs
index 50d5f0389a..76e429dbeb 100644
--- a/osu.Game/Screens/Edit/Compose/Components/CircularDistanceSnapGrid.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/CircularDistanceSnapGrid.cs
@@ -30,14 +30,14 @@ namespace osu.Game.Screens.Edit.Compose.Components
                     Position = StartPosition,
                     Width = crosshair_thickness,
                     EdgeSmoothness = new Vector2(1),
-                    Height = Math.Min(crosshair_max_size, DistanceSpacing * 2),
+                    Height = Math.Min(crosshair_max_size, DistanceBetweenTick * 2),
                 },
                 new Box
                 {
                     Origin = Anchor.Centre,
                     Position = StartPosition,
                     EdgeSmoothness = new Vector2(1),
-                    Width = Math.Min(crosshair_max_size, DistanceSpacing * 2),
+                    Width = Math.Min(crosshair_max_size, DistanceBetweenTick * 2),
                     Height = crosshair_thickness,
                 }
             });
@@ -45,11 +45,11 @@ namespace osu.Game.Screens.Edit.Compose.Components
             float dx = Math.Max(StartPosition.X, DrawWidth - StartPosition.X);
             float dy = Math.Max(StartPosition.Y, DrawHeight - StartPosition.Y);
             float maxDistance = new Vector2(dx, dy).Length;
-            int requiredCircles = Math.Min(MaxIntervals, (int)(maxDistance / DistanceSpacing));
+            int requiredCircles = Math.Min(MaxIntervals, (int)(maxDistance / DistanceBetweenTick));
 
             for (int i = 0; i < requiredCircles; i++)
             {
-                float radius = (i + 1) * DistanceSpacing * 2;
+                float radius = (i + 1) * DistanceBetweenTick * 2;
 
                 AddInternal(new CircularProgress
                 {
@@ -74,7 +74,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
 
             float distance = direction.Length;
 
-            float radius = DistanceSpacing;
+            float radius = DistanceBetweenTick;
             int radialCount = Math.Clamp((int)MathF.Round(distance / radius), 1, MaxIntervals);
 
             Vector2 normalisedDirection = direction * new Vector2(1f / distance);
diff --git a/osu.Game/Screens/Edit/Compose/Components/DistanceSnapGrid.cs b/osu.Game/Screens/Edit/Compose/Components/DistanceSnapGrid.cs
index 5568c15514..42bb8a813d 100644
--- a/osu.Game/Screens/Edit/Compose/Components/DistanceSnapGrid.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/DistanceSnapGrid.cs
@@ -23,7 +23,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
         /// <summary>
         /// The spacing between each tick of the beat snapping grid.
         /// </summary>
-        protected float DistanceSpacing { get; private set; }
+        protected float DistanceBetweenTick { get; private set; }
 
         /// <summary>
         /// The maximum number of distance snapping intervals allowed.
@@ -32,7 +32,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
 
         /// <summary>
         /// The position which the grid should start.
-        /// The first beat snapping tick is located at <see cref="StartPosition"/> + <see cref="DistanceSpacing"/> away from this point.
+        /// The first beat snapping tick is located at <see cref="StartPosition"/> + <see cref="DistanceBetweenTick"/> away from this point.
         /// </summary>
         protected readonly Vector2 StartPosition;
 
@@ -92,7 +92,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
 
         private void updateSpacing()
         {
-            DistanceSpacing = (float)(SnapProvider.GetBeatSnapDistanceAt(ReferenceObject) * distanceSpacingMultiplier.Value);
+            DistanceBetweenTick = (float)(SnapProvider.GetBeatSnapDistanceAt(ReferenceObject) * distanceSpacingMultiplier.Value);
 
             if (endTime == null)
                 MaxIntervals = int.MaxValue;
@@ -100,7 +100,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
             {
                 // +1 is added since a snapped hitobject may have its start time slightly less than the snapped time due to floating point errors
                 double maxDuration = endTime.Value - StartTime + 1;
-                MaxIntervals = (int)(maxDuration / SnapProvider.DistanceToDuration(ReferenceObject, DistanceSpacing));
+                MaxIntervals = (int)(maxDuration / SnapProvider.DistanceToDuration(ReferenceObject, DistanceBetweenTick));
             }
 
             gridCache.Invalidate();

From 786c7f14d3d0a2ea1db09dea4528e04a4b53e217 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 5 May 2022 17:08:53 +0900
Subject: [PATCH 4522/5547] Expose `DistanceSpacingMultiplier` to distance

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

diff --git a/osu.Game/Screens/Edit/Compose/Components/DistanceSnapGrid.cs b/osu.Game/Screens/Edit/Compose/Components/DistanceSnapGrid.cs
index 42bb8a813d..a907608cbc 100644
--- a/osu.Game/Screens/Edit/Compose/Components/DistanceSnapGrid.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/DistanceSnapGrid.cs
@@ -25,6 +25,8 @@ namespace osu.Game.Screens.Edit.Compose.Components
         /// </summary>
         protected float DistanceBetweenTick { get; private set; }
 
+        protected IBindable<double> DistanceSpacingMultiplier { get; private set; }
+
         /// <summary>
         /// The maximum number of distance snapping intervals allowed.
         /// </summary>
@@ -53,8 +55,6 @@ namespace osu.Game.Screens.Edit.Compose.Components
         [Resolved]
         private BindableBeatDivisor beatDivisor { get; set; }
 
-        private IBindable<double> distanceSpacingMultiplier;
-
         private readonly LayoutValue gridCache = new LayoutValue(Invalidation.RequiredParentSizeToFit);
         private readonly double? endTime;
 
@@ -86,13 +86,13 @@ namespace osu.Game.Screens.Edit.Compose.Components
 
             beatDivisor.BindValueChanged(_ => updateSpacing());
 
-            distanceSpacingMultiplier = SnapProvider.DistanceSpacingMultiplier.GetBoundCopy();
-            distanceSpacingMultiplier.BindValueChanged(_ => updateSpacing(), true);
+            DistanceSpacingMultiplier = SnapProvider.DistanceSpacingMultiplier.GetBoundCopy();
+            DistanceSpacingMultiplier.BindValueChanged(_ => updateSpacing(), true);
         }
 
         private void updateSpacing()
         {
-            DistanceBetweenTick = (float)(SnapProvider.GetBeatSnapDistanceAt(ReferenceObject) * distanceSpacingMultiplier.Value);
+            DistanceBetweenTick = (float)(SnapProvider.GetBeatSnapDistanceAt(ReferenceObject) * DistanceSpacingMultiplier.Value);
 
             if (endTime == null)
                 MaxIntervals = int.MaxValue;

From 4c884aea5d8592b810b7549ab8d6966759edf60c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 5 May 2022 17:09:14 +0900
Subject: [PATCH 4523/5547] Fix `CircularDistanceSnapGrid` returning an
 incorrect time value when distance spacing is not 1.0

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

diff --git a/osu.Game/Screens/Edit/Compose/Components/CircularDistanceSnapGrid.cs b/osu.Game/Screens/Edit/Compose/Components/CircularDistanceSnapGrid.cs
index 76e429dbeb..1c6eb98521 100644
--- a/osu.Game/Screens/Edit/Compose/Components/CircularDistanceSnapGrid.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/CircularDistanceSnapGrid.cs
@@ -80,7 +80,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
             Vector2 normalisedDirection = direction * new Vector2(1f / distance);
             Vector2 snappedPosition = StartPosition + normalisedDirection * radialCount * radius;
 
-            return (snappedPosition, StartTime + SnapProvider.FindSnappedDuration(ReferenceObject, (snappedPosition - StartPosition).Length));
+            return (snappedPosition, StartTime + SnapProvider.FindSnappedDuration(ReferenceObject, (float)((snappedPosition - StartPosition).Length / DistanceSpacingMultiplier.Value)));
         }
     }
 }

From 947a68006a6afb4f166053401bc6b01f21e78f14 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 5 May 2022 17:50:17 +0900
Subject: [PATCH 4524/5547] Add note about `IDistanceSnapProvider` not
 multiplying `DistanceSpacing` itself

---
 osu.Game/Rulesets/Edit/IDistanceSnapProvider.cs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Game/Rulesets/Edit/IDistanceSnapProvider.cs b/osu.Game/Rulesets/Edit/IDistanceSnapProvider.cs
index 8c599f8596..b12e1437dc 100644
--- a/osu.Game/Rulesets/Edit/IDistanceSnapProvider.cs
+++ b/osu.Game/Rulesets/Edit/IDistanceSnapProvider.cs
@@ -16,6 +16,7 @@ namespace osu.Game.Rulesets.Edit
     {
         /// <summary>
         /// A multiplier which changes the ratio of distance travelled per time unit.
+        /// Importantly, this is provided for manual usage, and not multiplied into any of the methods exposed by this interface.
         /// </summary>
         /// <seealso cref="BeatmapInfo.DistanceSpacing"/>
         IBindable<double> DistanceSpacingMultiplier { get; }

From b2e9be70a5e3ae76a315fa346356a9348f0a590e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 5 May 2022 17:50:33 +0900
Subject: [PATCH 4525/5547] Rewrite `CircularDistanceSnapGrid` snapping
 implementation to use snap provider

---
 .../Components/CircularDistanceSnapGrid.cs    | 28 +++++++++++++------
 1 file changed, 19 insertions(+), 9 deletions(-)

diff --git a/osu.Game/Screens/Edit/Compose/Components/CircularDistanceSnapGrid.cs b/osu.Game/Screens/Edit/Compose/Components/CircularDistanceSnapGrid.cs
index 1c6eb98521..f34fa7328a 100644
--- a/osu.Game/Screens/Edit/Compose/Components/CircularDistanceSnapGrid.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/CircularDistanceSnapGrid.cs
@@ -68,19 +68,29 @@ namespace osu.Game.Screens.Edit.Compose.Components
             if (MaxIntervals == 0)
                 return (StartPosition, StartTime);
 
-            Vector2 direction = position - StartPosition;
-            if (direction == Vector2.Zero)
-                direction = new Vector2(0.001f, 0.001f);
+            // This grid implementation factors in the user's distance spacing specification,
+            // which is usually not considered by an `IDistanceSnapProvider`.
+            float distanceSpacing = (float)DistanceSpacingMultiplier.Value;
 
-            float distance = direction.Length;
+            Vector2 travelVector = (position - StartPosition);
 
-            float radius = DistanceBetweenTick;
-            int radialCount = Math.Clamp((int)MathF.Round(distance / radius), 1, MaxIntervals);
+            if (travelVector == Vector2.Zero)
+                return (StartPosition, StartTime);
 
-            Vector2 normalisedDirection = direction * new Vector2(1f / distance);
-            Vector2 snappedPosition = StartPosition + normalisedDirection * radialCount * radius;
+            float travelLength = travelVector.Length;
 
-            return (snappedPosition, StartTime + SnapProvider.FindSnappedDuration(ReferenceObject, (float)((snappedPosition - StartPosition).Length / DistanceSpacingMultiplier.Value)));
+            // FindSnappedDistance will always round down, but we want to potentially round upwards.
+            travelLength += DistanceBetweenTick / 2;
+
+            // When interacting with the resolved snap provider, the distance spacing multiplier should first be removed
+            // to allow for snapping at a non-multiplied ratio.
+            float snappedDistance = SnapProvider.FindSnappedDistance(ReferenceObject, travelLength / distanceSpacing);
+            double snappedTime = StartTime + SnapProvider.DistanceToDuration(ReferenceObject, snappedDistance);
+
+            // The multiplier can then be reapplied to the final position.
+            Vector2 snappedPosition = StartPosition + travelVector.Normalized() * snappedDistance * distanceSpacing;
+
+            return (snappedPosition, snappedTime);
         }
     }
 }

From 67341db0e742e302802a006d21e9c8baa2bba68a Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 5 May 2022 12:40:02 +0300
Subject: [PATCH 4526/5547] Wrap `BeatmapOnlineLookupQueue` cache request in a
 task

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

diff --git a/osu.Game/Beatmaps/BeatmapOnlineLookupQueue.cs b/osu.Game/Beatmaps/BeatmapOnlineLookupQueue.cs
index a24b6b315a..46f5b418bd 100644
--- a/osu.Game/Beatmaps/BeatmapOnlineLookupQueue.cs
+++ b/osu.Game/Beatmaps/BeatmapOnlineLookupQueue.cs
@@ -153,7 +153,7 @@ namespace osu.Game.Beatmaps
                 }
             };
 
-            cacheDownloadRequest.PerformAsync();
+            Task.Run(() => cacheDownloadRequest.PerformAsync());
         }
 
         private bool checkLocalCache(BeatmapSetInfo set, BeatmapInfo beatmapInfo)

From 269e15c167dc53a20afd3162e936b578d8fbae4a Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 5 May 2022 11:42:50 +0300
Subject: [PATCH 4527/5547] Add test coverage of distance spacing multiplier
 working with distance snap grid

---
 .../Editor/TestSceneOsuDistanceSnapGrid.cs    | 12 +++++-
 .../Editing/TestSceneDistanceSnapGrid.cs      | 37 ++++++++++++++++---
 2 files changed, 42 insertions(+), 7 deletions(-)

diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuDistanceSnapGrid.cs b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuDistanceSnapGrid.cs
index 015a922719..1feb80414a 100644
--- a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuDistanceSnapGrid.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuDistanceSnapGrid.cs
@@ -82,6 +82,14 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
             AddStep($"set beat divisor = {divisor}", () => beatDivisor.Value = divisor);
         }
 
+        [TestCase(1.0f)]
+        [TestCase(2.0f)]
+        [TestCase(0.5f)]
+        public void TestDistanceSpacing(float multiplier)
+        {
+            AddStep($"set beat divisor = {multiplier}", () => snapProvider.DistanceSpacingMultiplier.Value = multiplier);
+        }
+
         [Test]
         public void TestCursorInCentre()
         {
@@ -177,7 +185,9 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
 
             public SnapResult FindSnappedPositionAndTime(Vector2 screenSpacePosition) => new SnapResult(screenSpacePosition, 0);
 
-            public IBindable<double> DistanceSpacingMultiplier { get; } = new BindableDouble(1);
+            public Bindable<double> DistanceSpacingMultiplier { get; } = new BindableDouble(1);
+
+            IBindable<double> IDistanceSnapProvider.DistanceSpacingMultiplier => DistanceSpacingMultiplier;
 
             public float GetBeatSnapDistanceAt(HitObject referenceObject) => (float)beat_length;
 
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneDistanceSnapGrid.cs b/osu.Game.Tests/Visual/Editing/TestSceneDistanceSnapGrid.cs
index cdaa3739b7..7d8089b435 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneDistanceSnapGrid.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneDistanceSnapGrid.cs
@@ -21,8 +21,12 @@ namespace osu.Game.Tests.Visual.Editing
     public class TestSceneDistanceSnapGrid : EditorClockTestScene
     {
         private const double beat_length = 100;
+        private const int beat_snap_distance = 10;
+
         private static readonly Vector2 grid_position = new Vector2(512, 384);
 
+        private TestDistanceSnapGrid grid;
+
         [Cached(typeof(EditorBeatmap))]
         private readonly EditorBeatmap editorBeatmap;
 
@@ -39,6 +43,7 @@ namespace osu.Game.Tests.Visual.Editing
                 }
             });
             editorBeatmap.ControlPointInfo.Add(0, new TimingControlPoint { BeatLength = beat_length });
+            editorBeatmap.Difficulty.SliderMultiplier = 1;
         }
 
         [SetUp]
@@ -51,7 +56,7 @@ namespace osu.Game.Tests.Visual.Editing
                     RelativeSizeAxes = Axes.Both,
                     Colour = Color4.SlateGray
                 },
-                new TestDistanceSnapGrid()
+                grid = new TestDistanceSnapGrid()
             };
         });
 
@@ -68,9 +73,22 @@ namespace osu.Game.Tests.Visual.Editing
             AddStep($"set beat divisor = {divisor}", () => BeatDivisor.Value = divisor);
         }
 
-        [Test]
-        public void TestLimitedDistance()
+        [TestCase(1.0)]
+        [TestCase(2.0)]
+        [TestCase(0.5)]
+        public void TestDistanceSpacing(double multiplier)
         {
+            AddStep($"set distance spacing = {multiplier}", () => snapProvider.DistanceSpacingMultiplier.Value = multiplier);
+            AddAssert("distance spacing matches multiplier", () => grid.DistanceBetweenTick == beat_snap_distance * multiplier);
+        }
+
+        [TestCase(1.0)]
+        [TestCase(2.0)]
+        [TestCase(0.5)]
+        public void TestLimitedDistance(double multiplier)
+        {
+            const int end_time = 100;
+
             AddStep("create limited grid", () =>
             {
                 Children = new Drawable[]
@@ -80,15 +98,20 @@ namespace osu.Game.Tests.Visual.Editing
                         RelativeSizeAxes = Axes.Both,
                         Colour = Color4.SlateGray
                     },
-                    new TestDistanceSnapGrid(100)
+                    grid = new TestDistanceSnapGrid(end_time)
                 };
             });
+
+            AddStep($"set distance spacing = {multiplier}", () => snapProvider.DistanceSpacingMultiplier.Value = multiplier);
+            AddAssert("check correct interval count", () => grid.MaxIntervals == (end_time / grid.DistanceBetweenTick));
         }
 
         private class TestDistanceSnapGrid : DistanceSnapGrid
         {
             public new float DistanceBetweenTick => base.DistanceBetweenTick;
 
+            public new int MaxIntervals => base.MaxIntervals;
+
             public TestDistanceSnapGrid(double? endTime = null)
                 : base(new HitObject(), grid_position, 0, endTime)
             {
@@ -167,9 +190,11 @@ namespace osu.Game.Tests.Visual.Editing
 
             public SnapResult FindSnappedPositionAndTime(Vector2 screenSpacePosition) => new SnapResult(screenSpacePosition, 0);
 
-            public IBindable<double> DistanceSpacingMultiplier { get; } = new BindableDouble(1);
+            public Bindable<double> DistanceSpacingMultiplier { get; } = new BindableDouble(1);
 
-            public float GetBeatSnapDistanceAt(HitObject referenceObject) => 10;
+            IBindable<double> IDistanceSnapProvider.DistanceSpacingMultiplier => DistanceSpacingMultiplier;
+
+            public float GetBeatSnapDistanceAt(HitObject referenceObject) => beat_snap_distance;
 
             public float DurationToDistance(HitObject referenceObject, double duration) => (float)duration;
 

From 7b71fb860b39574c71cad2def3055750cec4bdad Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 5 May 2022 18:25:32 +0900
Subject: [PATCH 4528/5547] Expose `DistanceSpacingMultiplier` for test usage

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

diff --git a/osu.Game/Rulesets/Edit/DistancedHitObjectComposer.cs b/osu.Game/Rulesets/Edit/DistancedHitObjectComposer.cs
index bbcb702bd8..5e6d9dbe34 100644
--- a/osu.Game/Rulesets/Edit/DistancedHitObjectComposer.cs
+++ b/osu.Game/Rulesets/Edit/DistancedHitObjectComposer.cs
@@ -26,7 +26,7 @@ namespace osu.Game.Rulesets.Edit
     public abstract class DistancedHitObjectComposer<TObject> : HitObjectComposer<TObject>, IDistanceSnapProvider, IScrollBindingHandler<GlobalAction>
         where TObject : HitObject
     {
-        protected Bindable<double> DistanceSpacingMultiplier { get; } = new BindableDouble(1.0)
+        public Bindable<double> DistanceSpacingMultiplier { get; } = new BindableDouble(1.0)
         {
             MinValue = 0.1,
             MaxValue = 6.0,

From b9d8b7e413462c45871419977b67a927ace19c41 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 5 May 2022 18:25:46 +0900
Subject: [PATCH 4529/5547] Fix end time extent not being accounted for in new
 snap implementation

---
 .../Edit/Compose/Components/CircularDistanceSnapGrid.cs  | 5 +++++
 .../Screens/Edit/Compose/Components/DistanceSnapGrid.cs  | 9 +++++----
 2 files changed, 10 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Screens/Edit/Compose/Components/CircularDistanceSnapGrid.cs b/osu.Game/Screens/Edit/Compose/Components/CircularDistanceSnapGrid.cs
index f34fa7328a..2873d74f75 100644
--- a/osu.Game/Screens/Edit/Compose/Components/CircularDistanceSnapGrid.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/CircularDistanceSnapGrid.cs
@@ -87,6 +87,11 @@ namespace osu.Game.Screens.Edit.Compose.Components
             float snappedDistance = SnapProvider.FindSnappedDistance(ReferenceObject, travelLength / distanceSpacing);
             double snappedTime = StartTime + SnapProvider.DistanceToDuration(ReferenceObject, snappedDistance);
 
+            if (snappedTime > LatestEndTime)
+            {
+                snappedDistance = SnapProvider.DurationToDistance(ReferenceObject, LatestEndTime.Value - ReferenceObject.StartTime);
+            }
+
             // The multiplier can then be reapplied to the final position.
             Vector2 snappedPosition = StartPosition + travelVector.Normalized() * snappedDistance * distanceSpacing;
 
diff --git a/osu.Game/Screens/Edit/Compose/Components/DistanceSnapGrid.cs b/osu.Game/Screens/Edit/Compose/Components/DistanceSnapGrid.cs
index a907608cbc..b9e0cfef19 100644
--- a/osu.Game/Screens/Edit/Compose/Components/DistanceSnapGrid.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/DistanceSnapGrid.cs
@@ -43,6 +43,8 @@ namespace osu.Game.Screens.Edit.Compose.Components
         /// </summary>
         protected readonly double StartTime;
 
+        protected readonly double? LatestEndTime;
+
         [Resolved]
         protected OsuColour Colours { get; private set; }
 
@@ -56,7 +58,6 @@ namespace osu.Game.Screens.Edit.Compose.Components
         private BindableBeatDivisor beatDivisor { get; set; }
 
         private readonly LayoutValue gridCache = new LayoutValue(Invalidation.RequiredParentSizeToFit);
-        private readonly double? endTime;
 
         protected readonly HitObject ReferenceObject;
 
@@ -70,7 +71,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
         protected DistanceSnapGrid(HitObject referenceObject, Vector2 startPosition, double startTime, double? endTime = null)
         {
             ReferenceObject = referenceObject;
-            this.endTime = endTime;
+            LatestEndTime = endTime;
 
             StartPosition = startPosition;
             StartTime = startTime;
@@ -94,12 +95,12 @@ namespace osu.Game.Screens.Edit.Compose.Components
         {
             DistanceBetweenTick = (float)(SnapProvider.GetBeatSnapDistanceAt(ReferenceObject) * DistanceSpacingMultiplier.Value);
 
-            if (endTime == null)
+            if (LatestEndTime == null)
                 MaxIntervals = int.MaxValue;
             else
             {
                 // +1 is added since a snapped hitobject may have its start time slightly less than the snapped time due to floating point errors
-                double maxDuration = endTime.Value - StartTime + 1;
+                double maxDuration = LatestEndTime.Value - StartTime + 1;
                 MaxIntervals = (int)(maxDuration / SnapProvider.DistanceToDuration(ReferenceObject, DistanceBetweenTick));
             }
 

From 4fe23bced2da57d8931991b3df12aab667c7c6d0 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 5 May 2022 18:32:37 +0900
Subject: [PATCH 4530/5547] Update tests with new assumptions and a better snap
 implementation

---
 .../Editor/TestSceneOsuDistanceSnapGrid.cs    | 53 +++++++++----------
 1 file changed, 25 insertions(+), 28 deletions(-)

diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuDistanceSnapGrid.cs b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuDistanceSnapGrid.cs
index 1feb80414a..201d6b5d8f 100644
--- a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuDistanceSnapGrid.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuDistanceSnapGrid.cs
@@ -4,7 +4,6 @@
 using System;
 using NUnit.Framework;
 using osu.Framework.Allocation;
-using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
@@ -12,7 +11,6 @@ using osu.Framework.Input.Events;
 using osu.Framework.Utils;
 using osu.Game.Beatmaps.ControlPoints;
 using osu.Game.Rulesets.Edit;
-using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Osu.Beatmaps;
 using osu.Game.Rulesets.Osu.Edit;
 using osu.Game.Rulesets.Osu.Objects;
@@ -26,16 +24,26 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
     public class TestSceneOsuDistanceSnapGrid : OsuManualInputManagerTestScene
     {
         private const double beat_length = 100;
+
         private static readonly Vector2 grid_position = new Vector2(512, 384);
 
         [Cached(typeof(EditorBeatmap))]
+        [Cached(typeof(IBeatSnapProvider))]
         private readonly EditorBeatmap editorBeatmap;
 
+        [Cached]
+        private readonly EditorClock editorClock;
+
         [Cached]
         private readonly BindableBeatDivisor beatDivisor = new BindableBeatDivisor();
 
         [Cached(typeof(IDistanceSnapProvider))]
-        private readonly SnapProvider snapProvider = new SnapProvider();
+        private readonly OsuHitObjectComposer snapProvider = new OsuHitObjectComposer(new OsuRuleset())
+        {
+            // Just used for the snap implementation, so let's hide from vision.
+            AlwaysPresent = true,
+            Alpha = 0,
+        };
 
         private OsuDistanceSnapGrid grid;
 
@@ -48,14 +56,25 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
                     Ruleset = new OsuRuleset().RulesetInfo
                 }
             });
+
+            editorClock = new EditorClock(editorBeatmap);
+
+            base.Content.Children = new Drawable[]
+            {
+                snapProvider,
+                Content
+            };
         }
 
+        protected override Container<Drawable> Content { get; } = new Container { RelativeSizeAxes = Axes.Both };
+
         [SetUp]
         public void Setup() => Schedule(() =>
         {
             editorBeatmap.Difficulty.SliderMultiplier = 1;
             editorBeatmap.ControlPointInfo.Clear();
             editorBeatmap.ControlPointInfo.Add(0, new TimingControlPoint { BeatLength = beat_length });
+            snapProvider.DistanceSpacingMultiplier.Value = 1;
 
             Children = new Drawable[]
             {
@@ -94,20 +113,20 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
         public void TestCursorInCentre()
         {
             AddStep("move mouse to centre", () => InputManager.MoveMouseTo(grid.ToScreenSpace(grid_position)));
-            assertSnappedDistance((float)beat_length);
+            assertSnappedDistance(0);
         }
 
         [Test]
         public void TestCursorBeforeMovementPoint()
         {
-            AddStep("move mouse to just before movement point", () => InputManager.MoveMouseTo(grid.ToScreenSpace(grid_position + new Vector2((float)beat_length, 0) * 1.49f)));
+            AddStep("move mouse to just before movement point", () => InputManager.MoveMouseTo(grid.ToScreenSpace(grid_position + new Vector2((float)beat_length, 0) * 1.45f)));
             assertSnappedDistance((float)beat_length);
         }
 
         [Test]
         public void TestCursorAfterMovementPoint()
         {
-            AddStep("move mouse to just after movement point", () => InputManager.MoveMouseTo(grid.ToScreenSpace(grid_position + new Vector2((float)beat_length, 0) * 1.51f)));
+            AddStep("move mouse to just after movement point", () => InputManager.MoveMouseTo(grid.ToScreenSpace(grid_position + new Vector2((float)beat_length, 0) * 1.55f)));
             assertSnappedDistance((float)beat_length * 2);
         }
 
@@ -177,27 +196,5 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
                 cursor.Position = GetSnapPosition.Invoke(screenSpacePosition);
             }
         }
-
-        private class SnapProvider : IDistanceSnapProvider
-        {
-            public SnapResult FindSnappedPosition(Vector2 screenSpacePosition) =>
-                new SnapResult(screenSpacePosition, null);
-
-            public SnapResult FindSnappedPositionAndTime(Vector2 screenSpacePosition) => new SnapResult(screenSpacePosition, 0);
-
-            public Bindable<double> DistanceSpacingMultiplier { get; } = new BindableDouble(1);
-
-            IBindable<double> IDistanceSnapProvider.DistanceSpacingMultiplier => DistanceSpacingMultiplier;
-
-            public float GetBeatSnapDistanceAt(HitObject referenceObject) => (float)beat_length;
-
-            public float DurationToDistance(HitObject referenceObject, double duration) => (float)duration;
-
-            public double DistanceToDuration(HitObject referenceObject, float distance) => distance;
-
-            public double FindSnappedDuration(HitObject referenceObject, float distance) => 0;
-
-            public float FindSnappedDistance(HitObject referenceObject, float distance) => 0;
-        }
     }
 }

From 9fd98b80608e42182df12ced2ebec96b19d2e3db Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 5 May 2022 18:41:25 +0900
Subject: [PATCH 4531/5547] Also add test coverage of adjsuting the distance
 spacing multiplier

---
 .../Editor/TestSceneOsuDistanceSnapGrid.cs    | 47 +++++++++++--------
 1 file changed, 28 insertions(+), 19 deletions(-)

diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuDistanceSnapGrid.cs b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuDistanceSnapGrid.cs
index 201d6b5d8f..6d0ed15e45 100644
--- a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuDistanceSnapGrid.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuDistanceSnapGrid.cs
@@ -7,7 +7,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.Input;
 using osu.Framework.Utils;
 using osu.Game.Beatmaps.ControlPoints;
 using osu.Game.Rulesets.Edit;
@@ -23,7 +23,7 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
 {
     public class TestSceneOsuDistanceSnapGrid : OsuManualInputManagerTestScene
     {
-        private const double beat_length = 100;
+        private const float beat_length = 100;
 
         private static readonly Vector2 grid_position = new Vector2(512, 384);
 
@@ -119,15 +119,27 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
         [Test]
         public void TestCursorBeforeMovementPoint()
         {
-            AddStep("move mouse to just before movement point", () => InputManager.MoveMouseTo(grid.ToScreenSpace(grid_position + new Vector2((float)beat_length, 0) * 1.45f)));
-            assertSnappedDistance((float)beat_length);
+            AddStep("move mouse to just before movement point", () => InputManager.MoveMouseTo(grid.ToScreenSpace(grid_position + new Vector2(beat_length, 0) * 1.45f)));
+            assertSnappedDistance(beat_length);
         }
 
         [Test]
         public void TestCursorAfterMovementPoint()
         {
-            AddStep("move mouse to just after movement point", () => InputManager.MoveMouseTo(grid.ToScreenSpace(grid_position + new Vector2((float)beat_length, 0) * 1.55f)));
-            assertSnappedDistance((float)beat_length * 2);
+            AddStep("move mouse to just after movement point", () => InputManager.MoveMouseTo(grid.ToScreenSpace(grid_position + new Vector2(beat_length, 0) * 1.55f)));
+            assertSnappedDistance(beat_length * 2);
+        }
+
+        [TestCase(0.5f, beat_length * 2)]
+        [TestCase(1, beat_length * 2)]
+        [TestCase(1.5f, beat_length * 1.5f)]
+        [TestCase(2f, beat_length * 2)]
+        public void TestDistanceSpacingAdjust(float multiplier, float expectedDistance)
+        {
+            AddStep($"Set distance spacing to {multiplier}", () => snapProvider.DistanceSpacingMultiplier.Value = multiplier);
+            AddStep("move mouse to point", () => InputManager.MoveMouseTo(grid.ToScreenSpace(grid_position + new Vector2(beat_length, 0) * 2)));
+
+            assertSnappedDistance(expectedDistance);
         }
 
         [Test]
@@ -147,8 +159,8 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
                 };
             });
 
-            AddStep("move mouse outside grid", () => InputManager.MoveMouseTo(grid.ToScreenSpace(grid_position + new Vector2((float)beat_length, 0) * 3f)));
-            assertSnappedDistance((float)beat_length * 2);
+            AddStep("move mouse outside grid", () => InputManager.MoveMouseTo(grid.ToScreenSpace(grid_position + new Vector2(beat_length, 0) * 3f)));
+            assertSnappedDistance(beat_length * 2);
         }
 
         private void assertSnappedDistance(float expectedDistance) => AddAssert($"snap distance = {expectedDistance}", () =>
@@ -164,6 +176,10 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
 
             private readonly Drawable cursor;
 
+            private InputManager inputManager;
+
+            public override bool HandlePositionalInput => true;
+
             public SnappingCursorContainer()
             {
                 RelativeSizeAxes = Axes.Both;
@@ -180,20 +196,13 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
             {
                 base.LoadComplete();
 
-                updatePosition(GetContainingInputManager().CurrentState.Mouse.Position);
+                inputManager = GetContainingInputManager();
             }
 
-            protected override bool OnMouseMove(MouseMoveEvent e)
+            protected override void Update()
             {
-                base.OnMouseMove(e);
-
-                updatePosition(e.ScreenSpaceMousePosition);
-                return true;
-            }
-
-            private void updatePosition(Vector2 screenSpacePosition)
-            {
-                cursor.Position = GetSnapPosition.Invoke(screenSpacePosition);
+                base.Update();
+                cursor.Position = GetSnapPosition.Invoke(inputManager.CurrentState.Mouse.Position);
             }
         }
     }

From e7205d8593ec1ab27528137eed48b2002d61cd85 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 5 May 2022 19:09:56 +0900
Subject: [PATCH 4532/5547] Reset all test data before each test method to
 avoid channels stuck in joined state

---
 .../Visual/Online/TestSceneChatOverlayV2.cs    | 18 ++++++++----------
 1 file changed, 8 insertions(+), 10 deletions(-)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs b/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs
index 9d4de11c5a..b15a7afbf9 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs
@@ -31,22 +31,20 @@ namespace osu.Game.Tests.Visual.Online
         private ChatOverlayV2 chatOverlay;
         private ChannelManager channelManager;
 
-        private readonly APIUser testUser;
-        private readonly Channel testPMChannel;
-        private readonly Channel[] testChannels;
+        private APIUser testUser;
+        private Channel testPMChannel;
+        private Channel[] testChannels;
+
         private Channel testChannel1 => testChannels[0];
         private Channel testChannel2 => testChannels[1];
 
-        public TestSceneChatOverlayV2()
-        {
-            testUser = new APIUser { Username = "test user", Id = 5071479 };
-            testPMChannel = new Channel(testUser);
-            testChannels = Enumerable.Range(1, 10).Select(createPublicChannel).ToArray();
-        }
-
         [SetUp]
         public void SetUp() => Schedule(() =>
         {
+            testUser = new APIUser { Username = "test user", Id = 5071479 };
+            testPMChannel = new Channel(testUser);
+            testChannels = Enumerable.Range(1, 10).Select(createPublicChannel).ToArray();
+
             Child = new DependencyProvidingContainer
             {
                 RelativeSizeAxes = Axes.Both,

From 25ea660b0b7f449bb74280a09b3f31db5b471d67 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 5 May 2022 19:13:48 +0900
Subject: [PATCH 4533/5547] Replace `HandlePositionalInput` override with
 simple hover effect

---
 osu.Game/Overlays/Chat/ChatOverlayTopBar.cs | 24 +++++++++++++++++----
 1 file changed, 20 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Overlays/Chat/ChatOverlayTopBar.cs b/osu.Game/Overlays/Chat/ChatOverlayTopBar.cs
index 9ba7608d89..3a8cd1fb91 100644
--- a/osu.Game/Overlays/Chat/ChatOverlayTopBar.cs
+++ b/osu.Game/Overlays/Chat/ChatOverlayTopBar.cs
@@ -4,31 +4,35 @@
 #nullable enable
 
 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.Textures;
+using osu.Framework.Input.Events;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
 using osuTK;
+using osuTK.Graphics;
 
 namespace osu.Game.Overlays.Chat
 {
     public class ChatOverlayTopBar : Container
     {
-        // IsHovered is used by overlay
-        public override bool HandlePositionalInput => true;
+        private Box background = null!;
+
+        private Color4 backgroundColour;
 
         [BackgroundDependencyLoader]
         private void load(OverlayColourProvider colourProvider, TextureStore textures)
         {
             Children = new Drawable[]
             {
-                new Box
+                background = new Box
                 {
                     RelativeSizeAxes = Axes.Both,
-                    Colour = colourProvider.Background3,
+                    Colour = backgroundColour = colourProvider.Background3,
                 },
                 new GridContainer
                 {
@@ -63,5 +67,17 @@ namespace osu.Game.Overlays.Chat
                 },
             };
         }
+
+        protected override bool OnHover(HoverEvent e)
+        {
+            background.FadeColour(backgroundColour.Lighten(0.1f), 300, Easing.OutQuint);
+            return base.OnHover(e);
+        }
+
+        protected override void OnHoverLost(HoverLostEvent e)
+        {
+            background.FadeColour(backgroundColour, 300, Easing.OutQuint);
+            base.OnHoverLost(e);
+        }
     }
 }

From 74505ba1666e821c905d27325bb86f7e0236aa2a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 5 May 2022 19:16:19 +0900
Subject: [PATCH 4534/5547] Remove `!` usage (also seems to fix height
 saving/loading)

---
 osu.Game/Overlays/ChatOverlayV2.cs | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Overlays/ChatOverlayV2.cs b/osu.Game/Overlays/ChatOverlayV2.cs
index 658a28bfdb..ae4e160de5 100644
--- a/osu.Game/Overlays/ChatOverlayV2.cs
+++ b/osu.Game/Overlays/ChatOverlayV2.cs
@@ -39,7 +39,8 @@ namespace osu.Game.Overlays
         private ChatTextBar textBar = null!;
         private Container<DrawableChannel> currentChannelContainer = null!;
 
-        private Bindable<float>? chatHeight;
+        private readonly Bindable<float> chatHeight = new Bindable<float>();
+
         private bool isDraggingTopBar;
         private float dragStartChatHeight;
 
@@ -137,7 +138,8 @@ namespace osu.Game.Overlays
 
             loading.Show();
 
-            chatHeight = config.GetBindable<float>(OsuSetting.ChatDisplayHeight).GetBoundCopy();
+            config.BindWith(OsuSetting.ChatDisplayHeight, chatHeight);
+
             chatHeight.BindValueChanged(height => { Height = height.NewValue; }, true);
 
             currentChannel.BindTo(channelManager.CurrentChannel);
@@ -193,7 +195,7 @@ namespace osu.Game.Overlays
             if (!isDraggingTopBar)
                 return base.OnDragStart(e);
 
-            dragStartChatHeight = chatHeight!.Value;
+            dragStartChatHeight = chatHeight.Value;
             return true;
         }
 
@@ -203,7 +205,7 @@ namespace osu.Game.Overlays
                 return;
 
             float targetChatHeight = dragStartChatHeight - (e.MousePosition.Y - e.MouseDownPosition.Y) / Parent.DrawSize.Y;
-            chatHeight!.Value = targetChatHeight;
+            chatHeight.Value = targetChatHeight;
         }
 
         protected override void OnDragEnd(DragEndEvent e)

From e54f5e2d9206f49b387beda75f70e9fcfddc5a4e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 5 May 2022 19:17:32 +0900
Subject: [PATCH 4535/5547] Adjust value change variables to avoid `e` usage

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

diff --git a/osu.Game/Overlays/ChatOverlayV2.cs b/osu.Game/Overlays/ChatOverlayV2.cs
index ae4e160de5..8a73eabed2 100644
--- a/osu.Game/Overlays/ChatOverlayV2.cs
+++ b/osu.Game/Overlays/ChatOverlayV2.cs
@@ -238,9 +238,9 @@ namespace osu.Game.Overlays
             base.OnFocus(e);
         }
 
-        private void currentChannelChanged(ValueChangedEvent<Channel> e)
+        private void currentChannelChanged(ValueChangedEvent<Channel> channel)
         {
-            Channel? newChannel = e.NewValue;
+            Channel? newChannel = channel.NewValue;
 
             loading.Show();
 
@@ -248,7 +248,7 @@ namespace osu.Game.Overlays
             if (newChannel == null)
             {
                 // Find another channel to switch to
-                newChannel = channelManager.JoinedChannels.FirstOrDefault(chan => chan != e.OldValue);
+                newChannel = channelManager.JoinedChannels.FirstOrDefault(c => c != channel.OldValue);
 
                 if (newChannel == null)
                     selectorActive.Value = true;

From 97221d2ef1ee5b88464fc2bdbbe7dc372d05c882 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 5 May 2022 19:22:30 +0900
Subject: [PATCH 4536/5547] Tidy up initialisation

---
 osu.Game/Overlays/ChatOverlayV2.cs | 29 ++++++++++++++++++-----------
 1 file changed, 18 insertions(+), 11 deletions(-)

diff --git a/osu.Game/Overlays/ChatOverlayV2.cs b/osu.Game/Overlays/ChatOverlayV2.cs
index 8a73eabed2..16da1f7c10 100644
--- a/osu.Game/Overlays/ChatOverlayV2.cs
+++ b/osu.Game/Overlays/ChatOverlayV2.cs
@@ -64,20 +64,27 @@ namespace osu.Game.Overlays
         [Cached]
         private readonly Bindable<Channel> currentChannel = new Bindable<Channel>();
 
+        public ChatOverlayV2()
+        {
+            Height = default_chat_height;
+
+            Masking = true;
+
+            const float corner_radius = 7f;
+
+            CornerRadius = corner_radius;
+
+            // Hack to hide the bottom edge corner radius off-screen.
+            Margin = new MarginPadding { Bottom = -corner_radius };
+            Padding = new MarginPadding { Bottom = corner_radius };
+
+            Anchor = Anchor.BottomCentre;
+            Origin = Anchor.BottomCentre;
+        }
+
         [BackgroundDependencyLoader]
         private void load()
         {
-            // Width = 0.85f; // Matches OnlineOverlay
-            Height = default_chat_height;
-            RelativeSizeAxes = Axes.Both;
-            RelativePositionAxes = Axes.Both;
-            Anchor = Anchor.BottomCentre;
-            Origin = Anchor.BottomCentre;
-            Masking = true;
-            CornerRadius = 7f;
-            Margin = new MarginPadding { Bottom = -10 };
-            Padding = new MarginPadding { Bottom = 10 };
-
             Children = new Drawable[]
             {
                 topBar = new ChatOverlayTopBar

From 684db27bb8d962c6ada325dcb903b71c95106dbb Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 5 May 2022 19:40:44 +0900
Subject: [PATCH 4537/5547] Reword binding text to read better

---
 osu.Game/Localisation/GlobalActionKeyBindingStrings.cs | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Localisation/GlobalActionKeyBindingStrings.cs b/osu.Game/Localisation/GlobalActionKeyBindingStrings.cs
index cfe0fd55ce..b2f25de7f2 100644
--- a/osu.Game/Localisation/GlobalActionKeyBindingStrings.cs
+++ b/osu.Game/Localisation/GlobalActionKeyBindingStrings.cs
@@ -130,14 +130,14 @@ namespace osu.Game.Localisation
         public static LocalisableString SelectNext => new TranslatableString(getKey(@"select_next"), @"Next selection");
 
         /// <summary>
-        /// "Previous group selection"
+        /// "Select previous group"
         /// </summary>
-        public static LocalisableString SelectPreviousGroup => new TranslatableString(getKey(@"select_previous_group"), @"Previous group selection");
+        public static LocalisableString SelectPreviousGroup => new TranslatableString(getKey(@"select_previous_group"), @"Select previous group");
 
         /// <summary>
-        /// "Next group selection"
+        /// "Select next group"
         /// </summary>
-        public static LocalisableString SelectNextGroup => new TranslatableString(getKey(@"select_next_group"), @"Next group selection");
+        public static LocalisableString SelectNextGroup => new TranslatableString(getKey(@"select_next_group"), @"Select next group");
 
         /// <summary>
         /// "Home"

From 8501a4161958514bfae52c5e78aee2ee26a870e0 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 5 May 2022 14:37:38 +0300
Subject: [PATCH 4538/5547] Bring back separate bool properties as
 non-cascading

---
 osu.Game.Tests/Mods/ModUtilsTest.cs           | 12 ++++++---
 .../TestSceneFreeModSelectScreen.cs           |  3 +--
 .../BeatmapSet/LeaderboardModSelector.cs      |  2 +-
 osu.Game/Rulesets/Mods/IMod.cs                | 26 +++++++++---------
 osu.Game/Rulesets/Mods/Mod.cs                 | 11 ++++----
 osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs    |  3 ++-
 osu.Game/Rulesets/Mods/ModAutoplay.cs         |  4 ++-
 osu.Game/Rulesets/Mods/ModRateAdjust.cs       |  2 +-
 osu.Game/Rulesets/Mods/ModTimeRamp.cs         |  2 +-
 osu.Game/Rulesets/Mods/ModUsage.cs            | 27 -------------------
 osu.Game/Rulesets/Mods/UnknownMod.cs          |  4 ++-
 .../OnlinePlay/FreeModSelectOverlay.cs        |  2 +-
 .../Screens/OnlinePlay/FreeModSelectScreen.cs |  2 +-
 .../Multiplayer/MultiplayerMatchSongSelect.cs |  4 +--
 .../OnlinePlay/OnlinePlaySongSelect.cs        |  2 +-
 .../PlayerSettings/BeatmapOffsetControl.cs    |  3 +--
 osu.Game/Screens/Play/SubmittingPlayer.cs     |  3 +--
 osu.Game/Screens/Ranking/ResultsScreen.cs     |  3 +--
 osu.Game/Utils/ModUtils.cs                    |  4 +--
 19 files changed, 49 insertions(+), 70 deletions(-)
 delete mode 100644 osu.Game/Rulesets/Mods/ModUsage.cs

diff --git a/osu.Game.Tests/Mods/ModUtilsTest.cs b/osu.Game.Tests/Mods/ModUtilsTest.cs
index 2447233d3c..6c9dddf51f 100644
--- a/osu.Game.Tests/Mods/ModUtilsTest.cs
+++ b/osu.Game.Tests/Mods/ModUtilsTest.cs
@@ -324,12 +324,18 @@ namespace osu.Game.Tests.Mods
             public override string Acronym => string.Empty;
             public override double ScoreMultiplier => 1;
             public override bool HasImplementation => true;
-            public override bool IsPlayable(ModUsage usage) => usage == ModUsage.SoloLocal;
+            public override bool ValidForMultiplayer => false;
+            public override bool ValidForMultiplayerAsFreeMod => false;
         }
 
-        private class InvalidMultiplayerFreeMod : InvalidMultiplayerMod
+        private class InvalidMultiplayerFreeMod : Mod
         {
-            public override bool IsPlayable(ModUsage usage) => usage != ModUsage.MultiplayerLocal;
+            public override string Name => string.Empty;
+            public override string Description => string.Empty;
+            public override string Acronym => string.Empty;
+            public override double ScoreMultiplier => 1;
+            public override bool HasImplementation => true;
+            public override bool ValidForMultiplayerAsFreeMod => false;
         }
 
         public interface IModCompatibilitySpecification
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneFreeModSelectScreen.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneFreeModSelectScreen.cs
index fad784a09e..b5f901e51d 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneFreeModSelectScreen.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneFreeModSelectScreen.cs
@@ -6,7 +6,6 @@ using NUnit.Framework;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Testing;
 using osu.Game.Overlays.Mods;
-using osu.Game.Rulesets.Mods;
 using osu.Game.Screens.OnlinePlay;
 
 namespace osu.Game.Tests.Visual.Multiplayer
@@ -29,7 +28,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddUntilStep("all visible mods are playable",
                 () => this.ChildrenOfType<ModPanel>()
                           .Where(panel => panel.IsPresent)
-                          .All(panel => panel.Mod.HasImplementation && panel.Mod.IsPlayable(ModUsage.SoloLocal)));
+                          .All(panel => panel.Mod.HasImplementation && panel.Mod.UserPlayable));
 
             AddToggleStep("toggle visibility", visible =>
             {
diff --git a/osu.Game/Overlays/BeatmapSet/LeaderboardModSelector.cs b/osu.Game/Overlays/BeatmapSet/LeaderboardModSelector.cs
index 17ea117018..25aed4c980 100644
--- a/osu.Game/Overlays/BeatmapSet/LeaderboardModSelector.cs
+++ b/osu.Game/Overlays/BeatmapSet/LeaderboardModSelector.cs
@@ -63,7 +63,7 @@ namespace osu.Game.Overlays.BeatmapSet
                 return;
 
             modsContainer.Add(new ModButton(new ModNoMod()));
-            modsContainer.AddRange(rulesetInstance.AllMods.Where(m => m.IsPlayable(ModUsage.SoloLocal)).Select(m => new ModButton(m)));
+            modsContainer.AddRange(rulesetInstance.AllMods.Where(m => m.UserPlayable).Select(m => new ModButton(m)));
 
             modsContainer.ForEach(button =>
             {
diff --git a/osu.Game/Rulesets/Mods/IMod.cs b/osu.Game/Rulesets/Mods/IMod.cs
index c0d4aa5c9f..30fa1ea8cb 100644
--- a/osu.Game/Rulesets/Mods/IMod.cs
+++ b/osu.Game/Rulesets/Mods/IMod.cs
@@ -33,26 +33,24 @@ namespace osu.Game.Rulesets.Mods
         /// </summary>
         IconUsage? Icon { get; }
 
-        /// <summary>
-        /// Whether this mod is playable for the given usage.
-        /// </summary>
-        /// <remarks>
-        /// <list type="bullet">
-        /// <item>Should be always <c>false</c> for cases where the user is not interacting with the game.</item>
-        /// <item>Should be <c>false</c> in <see cref="ModUsage.MultiplayerGlobal"/> for mods that make gameplay duration dependent on user input (e.g. <see cref="ModAdaptiveSpeed"/>).</item>
-        /// <item>Should be <c>false</c> in <see cref="ModUsage.MultiplayerLocal"/> for mods that affect the gameplay duration (e.g. <see cref="ModRateAdjust"/> and <see cref="ModTimeRamp"/>).</item>
-        /// </list>
-        /// </remarks>
-        /// <param name="usage">The mod usage.</param>
-        bool IsPlayable(ModUsage usage);
-
         /// <summary>
         /// Whether this mod is playable by an end user.
         /// Should be <c>false</c> for cases where the user is not interacting with the game (so it can be excluded from multiplayer selection, for example).
         /// </summary>
-        [Obsolete("Override IsPlayable instead.")] // Can be removed 20221104
         bool UserPlayable { get; }
 
+        /// <summary>
+        /// Whether this mod is valid for multiplayer matches.
+        /// Should be <c>false</c> for mods that make gameplay duration dependent on user input (e.g. <see cref="ModAdaptiveSpeed"/>).
+        /// </summary>
+        bool ValidForMultiplayer { get; }
+
+        /// <summary>
+        /// Whether this mod is valid as a free mod in multiplayer matches.
+        /// Should be <c>false</c> for mods that affect the gameplay duration (e.g. <see cref="ModRateAdjust"/> and <see cref="ModTimeRamp"/>).
+        /// </summary>
+        bool ValidForMultiplayerAsFreeMod { get; }
+
         /// <summary>
         /// Create a fresh <see cref="Mod"/> instance based on this mod.
         /// </summary>
diff --git a/osu.Game/Rulesets/Mods/Mod.cs b/osu.Game/Rulesets/Mods/Mod.cs
index b2f1b7e24f..93990d36e1 100644
--- a/osu.Game/Rulesets/Mods/Mod.cs
+++ b/osu.Game/Rulesets/Mods/Mod.cs
@@ -91,13 +91,14 @@ namespace osu.Game.Rulesets.Mods
         [JsonIgnore]
         public virtual bool HasImplementation => this is IApplicableMod;
 
-#pragma warning disable 618
-        public virtual bool IsPlayable(ModUsage usage) => UserPlayable;
-#pragma warning restore 618
+        [JsonIgnore]
+        public virtual bool UserPlayable => true;
 
         [JsonIgnore]
-        [Obsolete("Override IsPlayable instead.")] // Can be removed 20221104
-        public virtual bool UserPlayable => true;
+        public virtual bool ValidForMultiplayer => true;
+
+        [JsonIgnore]
+        public virtual bool ValidForMultiplayerAsFreeMod => true;
 
         [Obsolete("Going forward, the concept of \"ranked\" doesn't exist. The only exceptions are automation mods, which should now override IsPlayable to false.")] // Can be removed 20211009
         public virtual bool Ranked => false;
diff --git a/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs b/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs
index 700ad30c08..93251f7b2d 100644
--- a/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs
+++ b/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs
@@ -31,7 +31,8 @@ namespace osu.Game.Rulesets.Mods
 
         public override double ScoreMultiplier => 1;
 
-        public override bool IsPlayable(ModUsage usage) => usage == ModUsage.SoloLocal;
+        public override bool ValidForMultiplayer => false;
+        public override bool ValidForMultiplayerAsFreeMod => false;
 
         public override Type[] IncompatibleMods => new[] { typeof(ModRateAdjust), typeof(ModTimeRamp) };
 
diff --git a/osu.Game/Rulesets/Mods/ModAutoplay.cs b/osu.Game/Rulesets/Mods/ModAutoplay.cs
index 9df25b006d..0ebe11b393 100644
--- a/osu.Game/Rulesets/Mods/ModAutoplay.cs
+++ b/osu.Game/Rulesets/Mods/ModAutoplay.cs
@@ -24,7 +24,9 @@ namespace osu.Game.Rulesets.Mods
 
         public bool RestartOnFail => false;
 
-        public override bool IsPlayable(ModUsage usage) => false;
+        public override bool UserPlayable => false;
+        public override bool ValidForMultiplayer => false;
+        public override bool ValidForMultiplayerAsFreeMod => false;
 
         public override Type[] IncompatibleMods => new[] { typeof(ModCinema), typeof(ModRelax), typeof(ModFailCondition), typeof(ModNoFail) };
 
diff --git a/osu.Game/Rulesets/Mods/ModRateAdjust.cs b/osu.Game/Rulesets/Mods/ModRateAdjust.cs
index acb39bfbe6..05953f903f 100644
--- a/osu.Game/Rulesets/Mods/ModRateAdjust.cs
+++ b/osu.Game/Rulesets/Mods/ModRateAdjust.cs
@@ -11,7 +11,7 @@ namespace osu.Game.Rulesets.Mods
 {
     public abstract class ModRateAdjust : Mod, IApplicableToRate
     {
-        public override bool IsPlayable(ModUsage usage) => usage != ModUsage.MultiplayerLocal;
+        public override bool ValidForMultiplayerAsFreeMod => false;
 
         public abstract BindableNumber<double> SpeedChange { get; }
 
diff --git a/osu.Game/Rulesets/Mods/ModTimeRamp.cs b/osu.Game/Rulesets/Mods/ModTimeRamp.cs
index c554c39010..fe6d54332c 100644
--- a/osu.Game/Rulesets/Mods/ModTimeRamp.cs
+++ b/osu.Game/Rulesets/Mods/ModTimeRamp.cs
@@ -30,7 +30,7 @@ namespace osu.Game.Rulesets.Mods
         [SettingSource("Adjust pitch", "Should pitch be adjusted with speed")]
         public abstract BindableBool AdjustPitch { get; }
 
-        public override bool IsPlayable(ModUsage usage) => usage != ModUsage.MultiplayerLocal;
+        public override bool ValidForMultiplayerAsFreeMod => false;
 
         public override Type[] IncompatibleMods => new[] { typeof(ModRateAdjust), typeof(ModAdaptiveSpeed) };
 
diff --git a/osu.Game/Rulesets/Mods/ModUsage.cs b/osu.Game/Rulesets/Mods/ModUsage.cs
deleted file mode 100644
index 3f25154d73..0000000000
--- a/osu.Game/Rulesets/Mods/ModUsage.cs
+++ /dev/null
@@ -1,27 +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.Rulesets.Mods
-{
-    /// <summary>
-    /// The context in which a <see cref="Mod"/> is playable.
-    /// </summary>
-    public enum ModUsage
-    {
-        /// <summary>
-        /// This mod can be used for a per-user gameplay session.
-        /// </summary>
-        SoloLocal,
-
-        /// <summary>
-        /// This mod can be used in multiplayer but must be applied to all users.
-        /// This is generally the case for mods which affect the length of gameplay.
-        /// </summary>
-        MultiplayerGlobal,
-
-        /// <summary>
-        /// This mod can be used in multiplayer either at a room or per-player level (i.e. "free mod").
-        /// </summary>
-        MultiplayerLocal,
-    }
-}
diff --git a/osu.Game/Rulesets/Mods/UnknownMod.cs b/osu.Game/Rulesets/Mods/UnknownMod.cs
index 75d86e67bc..72de0ad653 100644
--- a/osu.Game/Rulesets/Mods/UnknownMod.cs
+++ b/osu.Game/Rulesets/Mods/UnknownMod.cs
@@ -15,7 +15,9 @@ namespace osu.Game.Rulesets.Mods
         public override string Description => "This mod could not be resolved by the game.";
         public override double ScoreMultiplier => 0;
 
-        public override bool IsPlayable(ModUsage usage) => false;
+        public override bool UserPlayable => false;
+        public override bool ValidForMultiplayer => false;
+        public override bool ValidForMultiplayerAsFreeMod => false;
 
         public override ModType Type => ModType.System;
 
diff --git a/osu.Game/Screens/OnlinePlay/FreeModSelectOverlay.cs b/osu.Game/Screens/OnlinePlay/FreeModSelectOverlay.cs
index 13d5dd8927..d5abaaab4e 100644
--- a/osu.Game/Screens/OnlinePlay/FreeModSelectOverlay.cs
+++ b/osu.Game/Screens/OnlinePlay/FreeModSelectOverlay.cs
@@ -25,7 +25,7 @@ namespace osu.Game.Screens.OnlinePlay
         public new Func<Mod, bool> IsValidMod
         {
             get => base.IsValidMod;
-            set => base.IsValidMod = m => m.HasImplementation && m.IsPlayable(ModUsage.SoloLocal) && value(m);
+            set => base.IsValidMod = m => m.HasImplementation && m.UserPlayable && value(m);
         }
 
         public FreeModSelectOverlay()
diff --git a/osu.Game/Screens/OnlinePlay/FreeModSelectScreen.cs b/osu.Game/Screens/OnlinePlay/FreeModSelectScreen.cs
index 415ae60706..5a7a60b479 100644
--- a/osu.Game/Screens/OnlinePlay/FreeModSelectScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/FreeModSelectScreen.cs
@@ -16,7 +16,7 @@ namespace osu.Game.Screens.OnlinePlay
         public new Func<Mod, bool> IsValidMod
         {
             get => base.IsValidMod;
-            set => base.IsValidMod = m => m.IsPlayable(ModUsage.SoloLocal) && value.Invoke(m);
+            set => base.IsValidMod = m => m.UserPlayable && value.Invoke(m);
         }
 
         public FreeModSelectScreen()
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs
index d7e752623d..929c3ee321 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs
@@ -95,8 +95,8 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
 
         protected override BeatmapDetailArea CreateBeatmapDetailArea() => new PlayBeatmapDetailArea();
 
-        protected override bool IsValidMod(Mod mod) => base.IsValidMod(mod) && mod.IsPlayable(ModUsage.MultiplayerGlobal);
+        protected override bool IsValidMod(Mod mod) => base.IsValidMod(mod) && mod.ValidForMultiplayer;
 
-        protected override bool IsValidFreeMod(Mod mod) => base.IsValidFreeMod(mod) && mod.IsPlayable(ModUsage.MultiplayerLocal);
+        protected override bool IsValidFreeMod(Mod mod) => base.IsValidFreeMod(mod) && mod.ValidForMultiplayerAsFreeMod;
     }
 }
diff --git a/osu.Game/Screens/OnlinePlay/OnlinePlaySongSelect.cs b/osu.Game/Screens/OnlinePlay/OnlinePlaySongSelect.cs
index b8b0604c79..6a559dbb2c 100644
--- a/osu.Game/Screens/OnlinePlay/OnlinePlaySongSelect.cs
+++ b/osu.Game/Screens/OnlinePlay/OnlinePlaySongSelect.cs
@@ -170,7 +170,7 @@ namespace osu.Game.Screens.OnlinePlay
         /// </summary>
         /// <param name="mod">The <see cref="Mod"/> to check.</param>
         /// <returns>Whether <paramref name="mod"/> is a valid mod for online play.</returns>
-        protected virtual bool IsValidMod(Mod mod) => mod.HasImplementation && ModUtils.FlattenMod(mod).All(m => m.IsPlayable(ModUsage.SoloLocal));
+        protected virtual bool IsValidMod(Mod mod) => mod.HasImplementation && ModUtils.FlattenMod(mod).All(m => m.UserPlayable);
 
         /// <summary>
         /// Checks whether a given <see cref="Mod"/> is valid for per-player free-mod selection.
diff --git a/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs b/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
index af2cecfba5..1662ca399f 100644
--- a/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
+++ b/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
@@ -20,7 +20,6 @@ using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Localisation;
 using osu.Game.Overlays.Settings;
-using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Scoring;
 using osu.Game.Scoring;
 using osu.Game.Screens.Ranking.Statistics;
@@ -188,7 +187,7 @@ namespace osu.Game.Screens.Play.PlayerSettings
             if (score.NewValue == null)
                 return;
 
-            if (score.NewValue.Mods.Any(m => !m.IsPlayable(ModUsage.SoloLocal)))
+            if (score.NewValue.Mods.Any(m => !m.UserPlayable))
                 return;
 
             var hitEvents = score.NewValue.HitEvents;
diff --git a/osu.Game/Screens/Play/SubmittingPlayer.cs b/osu.Game/Screens/Play/SubmittingPlayer.cs
index b33ff87d55..b62dc1e5a6 100644
--- a/osu.Game/Screens/Play/SubmittingPlayer.cs
+++ b/osu.Game/Screens/Play/SubmittingPlayer.cs
@@ -11,7 +11,6 @@ using osu.Framework.Logging;
 using osu.Framework.Screens;
 using osu.Game.Online.API;
 using osu.Game.Online.Rooms;
-using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Scoring;
 using osu.Game.Scoring;
 
@@ -48,7 +47,7 @@ namespace osu.Game.Screens.Play
             // Token request construction should happen post-load to allow derived classes to potentially prepare DI backings that are used to create the request.
             var tcs = new TaskCompletionSource<bool>();
 
-            if (Mods.Value.Any(m => !m.IsPlayable(ModUsage.SoloLocal)))
+            if (Mods.Value.Any(m => !m.UserPlayable))
             {
                 handleTokenFailure(new InvalidOperationException("Non-user playable mod selected."));
                 return false;
diff --git a/osu.Game/Screens/Ranking/ResultsScreen.cs b/osu.Game/Screens/Ranking/ResultsScreen.cs
index e0ae0309ce..98514cd846 100644
--- a/osu.Game/Screens/Ranking/ResultsScreen.cs
+++ b/osu.Game/Screens/Ranking/ResultsScreen.cs
@@ -18,7 +18,6 @@ using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Input.Bindings;
 using osu.Game.Online.API;
-using osu.Game.Rulesets.Mods;
 using osu.Game.Scoring;
 using osu.Game.Screens.Play;
 using osu.Game.Screens.Ranking.Statistics;
@@ -146,7 +145,7 @@ namespace osu.Game.Screens.Ranking
             if (Score != null)
             {
                 // only show flair / animation when arriving after watching a play that isn't autoplay.
-                bool shouldFlair = player != null && Score.Mods.All(m => m.IsPlayable(ModUsage.SoloLocal));
+                bool shouldFlair = player != null && Score.Mods.All(m => m.UserPlayable);
 
                 ScorePanelList.AddScore(Score, shouldFlair);
             }
diff --git a/osu.Game/Utils/ModUtils.cs b/osu.Game/Utils/ModUtils.cs
index f11a06e3be..a252a9b416 100644
--- a/osu.Game/Utils/ModUtils.cs
+++ b/osu.Game/Utils/ModUtils.cs
@@ -144,7 +144,7 @@ namespace osu.Game.Utils
             if (!CheckCompatibleSet(mods, out invalidMods))
                 return false;
 
-            return checkValid(mods, m => m.Type != ModType.System && m.HasImplementation && m.IsPlayable(ModUsage.MultiplayerGlobal), out invalidMods);
+            return checkValid(mods, m => m.Type != ModType.System && m.HasImplementation && m.ValidForMultiplayer, out invalidMods);
         }
 
         /// <summary>
@@ -154,7 +154,7 @@ namespace osu.Game.Utils
         /// <param name="invalidMods">Invalid mods, if any were found. Will be null if all mods were valid.</param>
         /// <returns>Whether the input mods were all valid. If false, <paramref name="invalidMods"/> will contain all invalid entries.</returns>
         public static bool CheckValidFreeModsForMultiplayer(IEnumerable<Mod> mods, [NotNullWhen(false)] out List<Mod>? invalidMods)
-            => checkValid(mods, m => m.Type != ModType.System && m.HasImplementation && m.IsPlayable(ModUsage.MultiplayerLocal) && !(m is MultiMod), out invalidMods);
+            => checkValid(mods, m => m.Type != ModType.System && m.HasImplementation && m.ValidForMultiplayerAsFreeMod && !(m is MultiMod), out invalidMods);
 
         private static bool checkValid(IEnumerable<Mod> mods, Predicate<Mod> valid, [NotNullWhen(false)] out List<Mod>? invalidMods)
         {

From 43c9058d09dbff83898f8b7f841c524d8a72d454 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 5 May 2022 14:39:05 +0300
Subject: [PATCH 4539/5547] Fix wrong obsolete message

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

diff --git a/osu.Game/Rulesets/Mods/Mod.cs b/osu.Game/Rulesets/Mods/Mod.cs
index 93990d36e1..af1550f8a9 100644
--- a/osu.Game/Rulesets/Mods/Mod.cs
+++ b/osu.Game/Rulesets/Mods/Mod.cs
@@ -100,7 +100,7 @@ namespace osu.Game.Rulesets.Mods
         [JsonIgnore]
         public virtual bool ValidForMultiplayerAsFreeMod => true;
 
-        [Obsolete("Going forward, the concept of \"ranked\" doesn't exist. The only exceptions are automation mods, which should now override IsPlayable to false.")] // Can be removed 20211009
+        [Obsolete("Going forward, the concept of \"ranked\" doesn't exist. The only exceptions are automation mods, which should now override and set UserPlayable to false.")] // Can be removed 20211009
         public virtual bool Ranked => false;
 
         /// <summary>

From 2039d3db6a76031a7f23d9c84140f0f1f8f94d31 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 5 May 2022 14:37:57 +0200
Subject: [PATCH 4540/5547] Use standard slider ticks in strict tracking mod

---
 osu.Game.Rulesets.Osu/Mods/OsuModStrictTracking.cs | 7 +------
 1 file changed, 1 insertion(+), 6 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModStrictTracking.cs b/osu.Game.Rulesets.Osu/Mods/OsuModStrictTracking.cs
index a1e6946157..8bbfa68fdf 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModStrictTracking.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModStrictTracking.cs
@@ -70,11 +70,6 @@ namespace osu.Game.Rulesets.Osu.Mods
             drawableRuleset.Playfield.RegisterPool<StrictTrackingSliderTailCircle, StrictTrackingDrawableSliderTail>(10, 100);
         }
 
-        private class StrictTrackingSliderTick : SliderTick
-        {
-            public override Judgement CreateJudgement() => new OsuIgnoreJudgement();
-        }
-
         private class StrictTrackingSliderTailCircle : SliderTailCircle
         {
             public StrictTrackingSliderTailCircle(Slider slider)
@@ -115,7 +110,7 @@ namespace osu.Game.Rulesets.Osu.Mods
                     switch (e.Type)
                     {
                         case SliderEventType.Tick:
-                            AddNested(new StrictTrackingSliderTick
+                            AddNested(new SliderTick
                             {
                                 SpanIndex = e.SpanIndex,
                                 SpanStartTime = e.SpanStartTime,

From 74c0cb2f6eb9ddf40563e70da00f9454e29b22ca Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 5 May 2022 16:16:55 +0300
Subject: [PATCH 4541/5547] Add note about not checking compatibility in free
 mods validity method

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

diff --git a/osu.Game/Utils/ModUtils.cs b/osu.Game/Utils/ModUtils.cs
index a252a9b416..ea092a8ca3 100644
--- a/osu.Game/Utils/ModUtils.cs
+++ b/osu.Game/Utils/ModUtils.cs
@@ -150,6 +150,11 @@ namespace osu.Game.Utils
         /// <summary>
         /// Checks that all <see cref="Mod"/>s in a combination are valid as "free mods" in a multiplayer match session.
         /// </summary>
+        /// <remarks>
+        /// Note that this does not check compatibility between mods,
+        /// given that the passed mods are expected to be the ones to be allowed for the multiplayer match,
+        /// not to be confused with the list of mods the user currently has selected for the multiplayer match.
+        /// </remarks>
         /// <param name="mods">The mods to check.</param>
         /// <param name="invalidMods">Invalid mods, if any were found. Will be null if all mods were valid.</param>
         /// <returns>Whether the input mods were all valid. If false, <paramref name="invalidMods"/> will contain all invalid entries.</returns>

From 5ea6f62951b93a9e558c59142e0275ce886d2459 Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Thu, 5 May 2022 14:20:33 +0100
Subject: [PATCH 4542/5547] Ensure `RelativePositionAxes` is set in BDL for
 animations to work

---
 osu.Game/Overlays/ChatOverlayV2.cs | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/osu.Game/Overlays/ChatOverlayV2.cs b/osu.Game/Overlays/ChatOverlayV2.cs
index 16da1f7c10..cab88136fc 100644
--- a/osu.Game/Overlays/ChatOverlayV2.cs
+++ b/osu.Game/Overlays/ChatOverlayV2.cs
@@ -85,6 +85,9 @@ namespace osu.Game.Overlays
         [BackgroundDependencyLoader]
         private void load()
         {
+            // Required for the pop in/out animation
+            RelativePositionAxes = Axes.Both;
+
             Children = new Drawable[]
             {
                 topBar = new ChatOverlayTopBar

From 9cb52f8879f839eb7ba64cd1b38a35d4bc0c69cb Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Thu, 5 May 2022 14:21:26 +0100
Subject: [PATCH 4543/5547] Add tests for chat height saving/loading

---
 .../Visual/Online/TestSceneChatOverlayV2.cs   | 31 +++++++++++++++++++
 1 file changed, 31 insertions(+)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs b/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs
index b15a7afbf9..31ced4e8f7 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs
@@ -6,12 +6,14 @@ using System.Linq;
 using System.Collections.Generic;
 using System.Net;
 using NUnit.Framework;
+using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Logging;
 using osu.Framework.Testing;
 using osu.Framework.Utils;
+using osu.Game.Configuration;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests;
@@ -21,6 +23,7 @@ using osu.Game.Overlays;
 using osu.Game.Overlays.Chat;
 using osu.Game.Overlays.Chat.Listing;
 using osu.Game.Overlays.Chat.ChannelList;
+using osuTK;
 using osuTK.Input;
 
 namespace osu.Game.Tests.Visual.Online
@@ -38,6 +41,9 @@ namespace osu.Game.Tests.Visual.Online
         private Channel testChannel1 => testChannels[0];
         private Channel testChannel2 => testChannels[1];
 
+        [Resolved]
+        private OsuConfigManager config { get; set; } = null!;
+
         [SetUp]
         public void SetUp() => Schedule(() =>
         {
@@ -124,6 +130,28 @@ namespace osu.Game.Tests.Visual.Online
             AddAssert("Overlay is hidden", () => chatOverlay.State.Value == Visibility.Hidden);
         }
 
+        [Test]
+        public void TestChatHeight()
+        {
+            Bindable<float> configChatHeight = config.GetBindable<float>(OsuSetting.ChatDisplayHeight);
+            float newHeight = 0;
+
+            AddStep("Set config chat height", () => configChatHeight.Value = 0.4f);
+            AddStep("Show overlay", () => chatOverlay.Show());
+            AddAssert("Overlay uses config height", () => chatOverlay.Height == 0.4f);
+            AddStep("Drag overlay to new height", () => {
+                InputManager.MoveMouseTo(chatOverlayTopBar);
+                InputManager.PressButton(MouseButton.Left);
+                InputManager.MoveMouseTo(chatOverlayTopBar, new Vector2(0, -300));
+                InputManager.ReleaseButton(MouseButton.Left);
+            });
+            AddStep("Store new height", () => newHeight = chatOverlay.Height);
+            AddAssert("Config height changed", () => configChatHeight.Value != 0.4f && configChatHeight.Value == newHeight);
+            AddStep("Hide overlay", () => chatOverlay.Hide());
+            AddStep("Show overlay", () => chatOverlay.Show());
+            AddAssert("Overlay uses new height", () => chatOverlay.Height == newHeight);
+        }
+
         [Test]
         public void TestChannelSelection()
         {
@@ -360,6 +388,9 @@ namespace osu.Game.Tests.Visual.Online
         private ChatTextBox chatOverlayTextBox =>
             chatOverlay.ChildrenOfType<ChatTextBox>().Single();
 
+        private ChatOverlayTopBar chatOverlayTopBar =>
+            chatOverlay.ChildrenOfType<ChatOverlayTopBar>().Single();
+
         private void clickDrawable(Drawable d)
         {
             InputManager.MoveMouseTo(d);

From 5657e7f11ec5d0e8551380efeb3e4998e6e55f3c Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Thu, 5 May 2022 14:52:03 +0100
Subject: [PATCH 4544/5547] Fix chat height saving/loading test

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

diff --git a/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs b/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs
index 31ced4e8f7..98574e5d53 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs
@@ -133,13 +133,15 @@ namespace osu.Game.Tests.Visual.Online
         [Test]
         public void TestChatHeight()
         {
-            Bindable<float> configChatHeight = config.GetBindable<float>(OsuSetting.ChatDisplayHeight);
+            Bindable<float> configChatHeight = null;
             float newHeight = 0;
 
+            AddStep("Bind config chat height", () => configChatHeight = config.GetBindable<float>(OsuSetting.ChatDisplayHeight).GetBoundCopy());
             AddStep("Set config chat height", () => configChatHeight.Value = 0.4f);
             AddStep("Show overlay", () => chatOverlay.Show());
             AddAssert("Overlay uses config height", () => chatOverlay.Height == 0.4f);
-            AddStep("Drag overlay to new height", () => {
+            AddStep("Drag overlay to new height", () =>
+            {
                 InputManager.MoveMouseTo(chatOverlayTopBar);
                 InputManager.PressButton(MouseButton.Left);
                 InputManager.MoveMouseTo(chatOverlayTopBar, new Vector2(0, -300));

From 2cc56a4b19348b2b80ca4e4521a37e56a4bc0011 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 5 May 2022 19:07:44 +0200
Subject: [PATCH 4545/5547] Fix hidden issue with automatic customisation panel
 show logic

Doesn't cause tests to fail headless, but they do fail in the test
browser.
---
 osu.Game/Overlays/Mods/ModSelectScreen.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/Mods/ModSelectScreen.cs b/osu.Game/Overlays/Mods/ModSelectScreen.cs
index 8060bca65f..1779d59e33 100644
--- a/osu.Game/Overlays/Mods/ModSelectScreen.cs
+++ b/osu.Game/Overlays/Mods/ModSelectScreen.cs
@@ -217,7 +217,7 @@ namespace osu.Game.Overlays.Mods
             foreach (var mod in SelectedMods.Value)
             {
                 anyCustomisableMod |= mod.GetSettingsSourceProperties().Any();
-                anyModWithRequiredCustomisationAdded |= !valueChangedEvent.OldValue.Contains(mod) && mod.RequiresConfiguration;
+                anyModWithRequiredCustomisationAdded |= valueChangedEvent.OldValue.All(m => m.GetType() != mod.GetType()) && mod.RequiresConfiguration;
             }
 
             if (anyCustomisableMod)

From 8002726c9c1a1e1bf23befa68bb45eaec1cb57fb Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 5 May 2022 19:08:38 +0200
Subject: [PATCH 4546/5547] Add test coverage for dismissing customisation area
 with Escape

---
 .../Visual/UserInterface/TestSceneModSelectScreen.cs   | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs
index bdb423a43c..a3ce4b734b 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs
@@ -164,11 +164,19 @@ namespace osu.Game.Tests.Visual.UserInterface
             AddStep("select mod requiring configuration", () => SelectedMods.Value = new[] { new OsuModDifficultyAdjust() });
             assertCustomisationToggleState(disabled: false, active: true);
 
-            AddStep("dismiss mod customisation", () =>
+            AddStep("dismiss mod customisation via mouse", () =>
             {
                 InputManager.MoveMouseTo(modSelectScreen.ChildrenOfType<ShearedToggleButton>().Single());
                 InputManager.Click(MouseButton.Left);
             });
+            assertCustomisationToggleState(disabled: false, active: false);
+
+            AddStep("reset mods", () => SelectedMods.SetDefault());
+            AddStep("select mod requiring configuration", () => SelectedMods.Value = new[] { new OsuModDifficultyAdjust() });
+            assertCustomisationToggleState(disabled: false, active: true);
+
+            AddStep("dismiss mod customisation via keyboard", () => InputManager.Key(Key.Escape));
+            assertCustomisationToggleState(disabled: false, active: false);
 
             AddStep("append another mod not requiring config", () => SelectedMods.Value = SelectedMods.Value.Append(new OsuModFlashlight()).ToArray());
             assertCustomisationToggleState(disabled: false, active: false);

From 79e1b93b303195ef57cb9d2fc839aca0670fefd4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 5 May 2022 17:08:02 +0200
Subject: [PATCH 4547/5547] Close customisation area on escape press before
 exiting

---
 osu.Game/Overlays/Mods/ModSelectScreen.cs | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/osu.Game/Overlays/Mods/ModSelectScreen.cs b/osu.Game/Overlays/Mods/ModSelectScreen.cs
index 1779d59e33..a7f8a167f9 100644
--- a/osu.Game/Overlays/Mods/ModSelectScreen.cs
+++ b/osu.Game/Overlays/Mods/ModSelectScreen.cs
@@ -18,6 +18,7 @@ using osu.Game.Configuration;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.UserInterface;
+using osu.Game.Input.Bindings;
 using osu.Game.Rulesets.Mods;
 using osuTK;
 using osuTK.Input;
@@ -315,6 +316,17 @@ namespace osu.Game.Overlays.Mods
             }
         }
 
+        public override bool OnPressed(KeyBindingPressEvent<GlobalAction> e)
+        {
+            if (e.Action == GlobalAction.Back && customisationVisible.Value)
+            {
+                customisationVisible.Value = false;
+                return true;
+            }
+
+            return base.OnPressed(e);
+        }
+
         internal class ColumnScrollContainer : OsuScrollContainer<ColumnFlowContainer>
         {
             public ColumnScrollContainer()

From aafb363a3487e547ea349d0717f489557eb82252 Mon Sep 17 00:00:00 2001
From: Huo Yaoyuan <huoyaoyuan@hotmail.com>
Date: Fri, 6 May 2022 01:24:19 +0800
Subject: [PATCH 4548/5547] Only enable EnforceCodeStyleInBuild in CI

---
 .github/workflows/ci.yml | 7 +++++--
 Directory.Build.props    | 1 -
 osu.Android.props        | 1 -
 osu.iOS.props            | 1 -
 4 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index b4d7f894d4..57069a0ae2 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -33,6 +33,9 @@ jobs:
           path: ${{ github.workspace }}/inspectcode
           key: inspectcode-${{ hashFiles('.config/dotnet-tools.json') }}-${{ hashFiles('.github/workflows/ci.yml' ) }}
 
+      - name: Dotnet code style
+        run: dotnet build -c Debug -warnaserror osu.Desktop.slnf -p:EnforceCodeStyleInBuild=true
+
       - name: CodeFileSanity
         run: |
           # TODO: Add ignore filters and GitHub Workflow Command Reporting in CFS. That way we don't have to do this workaround.
@@ -128,7 +131,7 @@ jobs:
       # cannot accept .sln(f) files as arguments.
       # Build just the main game for now.
       - name: Build
-        run: msbuild osu.Android/osu.Android.csproj /restore /p:Configuration=Debug /p:EnforceCodeStyleInBuild=false
+        run: msbuild osu.Android/osu.Android.csproj /restore /p:Configuration=Debug
 
   build-only-ios:
     name: Build only (iOS)
@@ -147,4 +150,4 @@ jobs:
       # cannot accept .sln(f) files as arguments.
       # Build just the main game for now.
       - name: Build
-        run: msbuild osu.iOS/osu.iOS.csproj /restore /p:Configuration=Debug /p:EnforceCodeStyleInBuild=false
+        run: msbuild osu.iOS/osu.iOS.csproj /restore /p:Configuration=Debug
diff --git a/Directory.Build.props b/Directory.Build.props
index 65ffe02584..73a150d3e3 100644
--- a/Directory.Build.props
+++ b/Directory.Build.props
@@ -20,7 +20,6 @@
     <AdditionalFiles Include="$(MSBuildThisFileDirectory)CodeAnalysis\BannedSymbols.txt" />
   </ItemGroup>
   <PropertyGroup Label="Code Analysis">
-    <EnforceCodeStyleInBuild Condition="'$(EnforceCodeStyleInBuild)' == ''">true</EnforceCodeStyleInBuild>
     <CodeAnalysisRuleSet>$(MSBuildThisFileDirectory)CodeAnalysis\osu.ruleset</CodeAnalysisRuleSet>
   </PropertyGroup>
   <PropertyGroup Label="Documentation">
diff --git a/osu.Android.props b/osu.Android.props
index 299f236220..2866ec24a6 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -19,7 +19,6 @@
     <MandroidI18n>cjk,mideast,other,rare,west</MandroidI18n>
     <AndroidLinkMode>SdkOnly</AndroidLinkMode>
     <ErrorReport>prompt</ErrorReport>
-    <EnforceCodeStyleInBuild>false</EnforceCodeStyleInBuild>
   </PropertyGroup>
   <PropertyGroup Condition="'$(Configuration)' == 'Debug'">
     <DebugSymbols>True</DebugSymbols>
diff --git a/osu.iOS.props b/osu.iOS.props
index d16c6803f4..f987ae9bf8 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -11,7 +11,6 @@
     <MtouchVerbosity></MtouchVerbosity>
     <CodesignKey>iPhone Developer</CodesignKey>
     <AutoGenerateBindingRedirects>true</AutoGenerateBindingRedirects>
-    <EnforceCodeStyleInBuild>false</EnforceCodeStyleInBuild>
   </PropertyGroup>
   <PropertyGroup>
     <!-- Generated via osu.Framework.iOS/generate-symbol-strip-flags.sh -->

From 30ffc7b23f0d354cad739df4ca2e4c62ba42a294 Mon Sep 17 00:00:00 2001
From: Huo Yaoyuan <huoyaoyuan@hotmail.com>
Date: Fri, 6 May 2022 01:28:30 +0800
Subject: [PATCH 4549/5547] Remove dotnet-format

---
 .config/dotnet-tools.json | 6 ------
 .github/workflows/ci.yml  | 4 ----
 2 files changed, 10 deletions(-)

diff --git a/.config/dotnet-tools.json b/.config/dotnet-tools.json
index 5a3eadf607..1132396608 100644
--- a/.config/dotnet-tools.json
+++ b/.config/dotnet-tools.json
@@ -2,12 +2,6 @@
   "version": 1,
   "isRoot": true,
   "tools": {
-    "dotnet-format": {
-      "version": "3.1.37601",
-      "commands": [
-        "dotnet-format"
-      ]
-    },
     "jetbrains.resharper.globaltools": {
       "version": "2022.1.0-eap10",
       "commands": [
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 57069a0ae2..514acef525 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -49,10 +49,6 @@ jobs:
           done <<< $(dotnet codefilesanity)
           exit $exit_code
 
-      # Temporarily disabled due to test failures, but it won't work anyway until the tool is upgraded.
-      # - name: .NET Format (Dry Run)
-      #   run: dotnet format --dry-run --check
-
       - name: InspectCode
         run: dotnet jb inspectcode $(pwd)/osu.Desktop.slnf --no-build --output="inspectcodereport.xml" --caches-home="inspectcode" --verbosity=WARN
 

From 701ddade47739c20143e56e4da271663b24bce7d Mon Sep 17 00:00:00 2001
From: Huo Yaoyuan <huoyaoyuan@hotmail.com>
Date: Fri, 6 May 2022 01:32:37 +0800
Subject: [PATCH 4550/5547] Revert editorconfig changes from framework

---
 .editorconfig | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.editorconfig b/.editorconfig
index 35ac84fca0..c0ea55f4c8 100644
--- a/.editorconfig
+++ b/.editorconfig
@@ -176,7 +176,7 @@ csharp_style_unused_value_assignment_preference = discard_variable:warning
 
 #Style - variable declaration
 csharp_style_inlined_variable_declaration = true:warning
-csharp_style_deconstructed_variable_declaration = true:warning
+csharp_style_deconstructed_variable_declaration = false:silent
 
 #Style - other C# 7.x features
 dotnet_style_prefer_inferred_tuple_names = true:warning
@@ -187,8 +187,8 @@ dotnet_style_prefer_is_null_check_over_reference_equality_method = true:silent
 #Style - C# 8 features
 csharp_prefer_static_local_function = true:warning
 csharp_prefer_simple_using_statement = true:silent
-csharp_style_prefer_index_operator = true:warning
-csharp_style_prefer_range_operator = true:warning
+csharp_style_prefer_index_operator = false:silent
+csharp_style_prefer_range_operator = false:silent
 csharp_style_prefer_switch_expression = false:none
 
 [*.{yaml,yml}]

From 407db7ff9d288d9f1a81d05027f732eb33019c05 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 4 May 2022 21:49:02 +0200
Subject: [PATCH 4551/5547] Replace old mod select overlay with new design

---
 .../Navigation/TestSceneScreenNavigation.cs   |  2 +-
 .../OnlinePlay/OnlinePlaySongSelect.cs        |  2 +-
 osu.Game/Screens/Select/SongSelect.cs         | 36 ++++++-------------
 3 files changed, 12 insertions(+), 28 deletions(-)

diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs b/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
index a1f41d4caf..8ba074a7d1 100644
--- a/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
@@ -551,7 +551,7 @@ namespace osu.Game.Tests.Visual.Navigation
 
         public class TestPlaySongSelect : PlaySongSelect
         {
-            public ModSelectOverlay ModSelectOverlay => ModSelect;
+            public ModSelectScreen ModSelectOverlay => ModSelect;
 
             public BeatmapOptionsOverlay BeatmapOptionsOverlay => BeatmapOptions;
 
diff --git a/osu.Game/Screens/OnlinePlay/OnlinePlaySongSelect.cs b/osu.Game/Screens/OnlinePlay/OnlinePlaySongSelect.cs
index 6a559dbb2c..0eeb32230d 100644
--- a/osu.Game/Screens/OnlinePlay/OnlinePlaySongSelect.cs
+++ b/osu.Game/Screens/OnlinePlay/OnlinePlaySongSelect.cs
@@ -153,7 +153,7 @@ namespace osu.Game.Screens.OnlinePlay
             return base.OnExiting(e);
         }
 
-        protected override ModSelectOverlay CreateModSelectOverlay() => new UserModSelectOverlay
+        protected override ModSelectScreen CreateModSelectOverlay() => new UserModSelectScreen
         {
             IsValidMod = IsValidMod
         };
diff --git a/osu.Game/Screens/Select/SongSelect.cs b/osu.Game/Screens/Select/SongSelect.cs
index 2a1ed2a7a8..3c46433b45 100644
--- a/osu.Game/Screens/Select/SongSelect.cs
+++ b/osu.Game/Screens/Select/SongSelect.cs
@@ -101,7 +101,7 @@ namespace osu.Game.Screens.Select
         [Resolved(CanBeNull = true)]
         private LegacyImportManager legacyImportManager { get; set; }
 
-        protected ModSelectOverlay ModSelect { get; private set; }
+        protected ModSelectScreen ModSelect { get; private set; }
 
         protected Sample SampleConfirm { get; private set; }
 
@@ -252,35 +252,19 @@ namespace osu.Game.Screens.Select
             {
                 AddRangeInternal(new Drawable[]
                 {
-                    new GridContainer // used for max height implementation
+                    FooterPanels = new Container
                     {
+                        Anchor = Anchor.BottomLeft,
+                        Origin = Anchor.BottomLeft,
                         RelativeSizeAxes = Axes.Both,
-                        RowDimensions = new[]
+                        Padding = new MarginPadding { Bottom = Footer.HEIGHT },
+                        Children = new Drawable[]
                         {
-                            new Dimension(),
-                            new Dimension(GridSizeMode.Relative, 1f, maxSize: ModSelectOverlay.HEIGHT + Footer.HEIGHT),
-                        },
-                        Content = new[]
-                        {
-                            null,
-                            new Drawable[]
-                            {
-                                FooterPanels = new Container
-                                {
-                                    Anchor = Anchor.BottomLeft,
-                                    Origin = Anchor.BottomLeft,
-                                    RelativeSizeAxes = Axes.Both,
-                                    Padding = new MarginPadding { Bottom = Footer.HEIGHT },
-                                    Children = new Drawable[]
-                                    {
-                                        BeatmapOptions = new BeatmapOptionsOverlay(),
-                                        ModSelect = CreateModSelectOverlay()
-                                    }
-                                }
-                            }
+                            BeatmapOptions = new BeatmapOptionsOverlay(),
                         }
                     },
-                    Footer = new Footer()
+                    Footer = new Footer(),
+                    ModSelect = CreateModSelectOverlay()
                 });
             }
 
@@ -332,7 +316,7 @@ namespace osu.Game.Screens.Select
             (new FooterButtonOptions(), BeatmapOptions)
         };
 
-        protected virtual ModSelectOverlay CreateModSelectOverlay() => new UserModSelectOverlay();
+        protected virtual ModSelectScreen CreateModSelectOverlay() => new UserModSelectScreen();
 
         protected virtual void ApplyFilterToCarousel(FilterCriteria criteria)
         {

From 1744d7e4f0cd7130b0dad22da73bb708d9295c96 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 4 May 2022 21:53:04 +0200
Subject: [PATCH 4552/5547] Fix new mod select overlay dimming itself

---
 .../Containers/OsuFocusedOverlayContainer.cs  |  6 +--
 osu.Game/OsuGame.cs                           | 45 ++++++++++++++++++-
 osu.Game/Screens/Select/SongSelect.cs         | 21 ++++++++-
 3 files changed, 66 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Graphics/Containers/OsuFocusedOverlayContainer.cs b/osu.Game/Graphics/Containers/OsuFocusedOverlayContainer.cs
index 68351acd7e..0e8e481e9d 100644
--- a/osu.Game/Graphics/Containers/OsuFocusedOverlayContainer.cs
+++ b/osu.Game/Graphics/Containers/OsuFocusedOverlayContainer.cs
@@ -127,14 +127,14 @@ namespace osu.Game.Graphics.Containers
                     if (didChange)
                         samplePopIn?.Play();
 
-                    if (BlockScreenWideMouse && DimMainContent) game?.AddBlockingOverlay(this);
+                    if (BlockScreenWideMouse && DimMainContent) game?.ShowBlockingOverlay(this);
                     break;
 
                 case Visibility.Hidden:
                     if (didChange)
                         samplePopOut?.Play();
 
-                    if (BlockScreenWideMouse) game?.RemoveBlockingOverlay(this);
+                    if (BlockScreenWideMouse) game?.HideBlockingOverlay(this);
                     break;
             }
 
@@ -150,7 +150,7 @@ namespace osu.Game.Graphics.Containers
         protected override void Dispose(bool isDisposing)
         {
             base.Dispose(isDisposing);
-            game?.RemoveBlockingOverlay(this);
+            game?.HideBlockingOverlay(this);
         }
     }
 }
diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index e9fe8c43de..da8cdde944 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -171,6 +171,7 @@ namespace osu.Game
         private readonly string[] args;
 
         private readonly List<OsuFocusedOverlayContainer> focusedOverlays = new List<OsuFocusedOverlayContainer>();
+        private readonly List<OverlayContainer> externalOverlays = new List<OverlayContainer>();
 
         private readonly List<OverlayContainer> visibleBlockingOverlays = new List<OverlayContainer>();
 
@@ -186,19 +187,59 @@ namespace osu.Game
         private void updateBlockingOverlayFade() =>
             ScreenContainer.FadeColour(visibleBlockingOverlays.Any() ? OsuColour.Gray(0.5f) : Color4.White, 500, Easing.OutQuint);
 
-        public void AddBlockingOverlay(OverlayContainer overlay)
+        /// <summary>
+        /// Registers a blocking <see cref="OverlayContainer"/> that was not created by <see cref="OsuGame"/> itself for later use.
+        /// </summary>
+        /// <remarks>
+        /// The goal of this method is to allow child screens, like <see cref="SongSelect"/> to register their own full-screen blocking overlays
+        /// with background dim.
+        /// In those cases, for the dim to work correctly, the overlays need to be added at the `OsuGame` level directly, rather as children of the screens.
+        /// </remarks>
+        /// <returns>
+        /// An <see cref="IDisposable"/> that should be disposed of when the <paramref name="overlayContainer"/> should be unregistered.
+        /// Disposing of this <see cref="IDisposable"/> will automatically expire the <paramref name="overlayContainer"/>.
+        /// </returns>
+        internal IDisposable RegisterBlockingOverlay(OverlayContainer overlayContainer)
+        {
+            if (overlayContainer.Parent != null)
+                throw new ArgumentException($@"Overlays registered via {nameof(RegisterBlockingOverlay)} should not be added to the scene graph.");
+
+            if (externalOverlays.Contains(overlayContainer))
+                throw new ArgumentException($@"{overlayContainer} has already been registered via {nameof(RegisterBlockingOverlay)} once.");
+
+            externalOverlays.Add(overlayContainer);
+            overlayContent.Add(overlayContainer);
+            return new InvokeOnDisposal(() => unregisterBlockingOverlay(overlayContainer));
+        }
+
+        /// <summary>
+        /// Should be called when <paramref name="overlay"/> has been shown and should begin blocking background input.
+        /// </summary>
+        internal void ShowBlockingOverlay(OverlayContainer overlay)
         {
             if (!visibleBlockingOverlays.Contains(overlay))
                 visibleBlockingOverlays.Add(overlay);
             updateBlockingOverlayFade();
         }
 
-        public void RemoveBlockingOverlay(OverlayContainer overlay) => Schedule(() =>
+        /// <summary>
+        /// Should be called when a blocking <paramref name="overlay"/> has been hidden and should stop blocking background input.
+        /// </summary>
+        internal void HideBlockingOverlay(OverlayContainer overlay) => Schedule(() =>
         {
             visibleBlockingOverlays.Remove(overlay);
             updateBlockingOverlayFade();
         });
 
+        /// <summary>
+        /// Unregisters a blocking <see cref="OverlayContainer"/> that was not created by <see cref="OsuGame"/> itself.
+        /// </summary>
+        private void unregisterBlockingOverlay(OverlayContainer overlayContainer)
+        {
+            externalOverlays.Remove(overlayContainer);
+            overlayContainer.Expire();
+        }
+
         /// <summary>
         /// Close all game-wide overlays.
         /// </summary>
diff --git a/osu.Game/Screens/Select/SongSelect.cs b/osu.Game/Screens/Select/SongSelect.cs
index 3c46433b45..448e702b96 100644
--- a/osu.Game/Screens/Select/SongSelect.cs
+++ b/osu.Game/Screens/Select/SongSelect.cs
@@ -35,6 +35,7 @@ using osu.Framework.Input.Bindings;
 using osu.Game.Collections;
 using osu.Game.Graphics.UserInterface;
 using System.Diagnostics;
+using JetBrains.Annotations;
 using osu.Game.Screens.Play;
 using osu.Game.Database;
 using osu.Game.Skinning;
@@ -116,9 +117,15 @@ namespace osu.Game.Screens.Select
 
         private double audioFeedbackLastPlaybackTime;
 
+        [CanBeNull]
+        private IDisposable modSelectOverlayRegistration;
+
         [Resolved]
         private MusicController music { get; set; }
 
+        [Resolved(CanBeNull = true)]
+        private OsuGame game { get; set; }
+
         [BackgroundDependencyLoader(true)]
         private void load(AudioManager audio, IDialogOverlay dialog, OsuColour colours, ManageCollectionsDialog manageCollectionsDialog, DifficultyRecommender recommender)
         {
@@ -264,10 +271,13 @@ namespace osu.Game.Screens.Select
                         }
                     },
                     Footer = new Footer(),
-                    ModSelect = CreateModSelectOverlay()
                 });
             }
 
+            // preload the mod select overlay for later use in `LoadComplete()`.
+            // therein it will be registered at the `OsuGame` level to properly function as a blocking overlay.
+            LoadComponent(ModSelect = CreateModSelectOverlay());
+
             if (Footer != null)
             {
                 foreach (var (button, overlay) in CreateFooterButtons())
@@ -301,6 +311,13 @@ namespace osu.Game.Screens.Select
             }
         }
 
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            modSelectOverlayRegistration = game?.RegisterBlockingOverlay(ModSelect);
+        }
+
         /// <summary>
         /// Creates the buttons to be displayed in the footer.
         /// </summary>
@@ -700,6 +717,8 @@ namespace osu.Game.Screens.Select
 
             if (music != null)
                 music.TrackChanged -= ensureTrackLooping;
+
+            modSelectOverlayRegistration?.Dispose();
         }
 
         /// <summary>

From ac08498f35f8db294d26dfd0dba91df914cf492d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 4 May 2022 22:17:40 +0200
Subject: [PATCH 4553/5547] Use plum colour scheme in multiplayer to match rest
 of multiplayer screens

---
 .../UserInterface/TestSceneShearedOverlayContainer.cs      | 5 ++++-
 osu.Game/Overlays/FirstRunSetupOverlay.cs                  | 7 +++++--
 osu.Game/Overlays/Mods/ModSelectScreen.cs                  | 7 +++++--
 osu.Game/Overlays/Mods/ShearedOverlayContainer.cs          | 6 ++----
 osu.Game/Overlays/Mods/UserModSelectScreen.cs              | 5 +++++
 osu.Game/Screens/OnlinePlay/FreeModSelectScreen.cs         | 2 ++
 osu.Game/Screens/OnlinePlay/OnlinePlaySongSelect.cs        | 3 ++-
 7 files changed, 25 insertions(+), 10 deletions(-)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneShearedOverlayContainer.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneShearedOverlayContainer.cs
index 5a9cafde27..4dd64c6536 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneShearedOverlayContainer.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneShearedOverlayContainer.cs
@@ -66,7 +66,10 @@ namespace osu.Game.Tests.Visual.UserInterface
 
         public class TestShearedOverlayContainer : ShearedOverlayContainer
         {
-            protected override OverlayColourScheme ColourScheme => OverlayColourScheme.Green;
+            public TestShearedOverlayContainer()
+                : base(OverlayColourScheme.Green)
+            {
+            }
 
             [BackgroundDependencyLoader]
             private void load()
diff --git a/osu.Game/Overlays/FirstRunSetupOverlay.cs b/osu.Game/Overlays/FirstRunSetupOverlay.cs
index 75778e6c4d..607bef76dd 100644
--- a/osu.Game/Overlays/FirstRunSetupOverlay.cs
+++ b/osu.Game/Overlays/FirstRunSetupOverlay.cs
@@ -31,8 +31,6 @@ namespace osu.Game.Overlays
     [Cached]
     public class FirstRunSetupOverlay : ShearedOverlayContainer
     {
-        protected override OverlayColourScheme ColourScheme => OverlayColourScheme.Purple;
-
         [Resolved]
         private IPerformFromScreenRunner performer { get; set; } = null!;
 
@@ -70,6 +68,11 @@ namespace osu.Game.Overlays
 
         private Container content = null!;
 
+        public FirstRunSetupOverlay()
+            : base(OverlayColourScheme.Purple)
+        {
+        }
+
         [BackgroundDependencyLoader]
         private void load(OsuColour colours)
         {
diff --git a/osu.Game/Overlays/Mods/ModSelectScreen.cs b/osu.Game/Overlays/Mods/ModSelectScreen.cs
index a7f8a167f9..bf47e4351a 100644
--- a/osu.Game/Overlays/Mods/ModSelectScreen.cs
+++ b/osu.Game/Overlays/Mods/ModSelectScreen.cs
@@ -27,8 +27,6 @@ namespace osu.Game.Overlays.Mods
 {
     public abstract class ModSelectScreen : ShearedOverlayContainer
     {
-        protected override OverlayColourScheme ColourScheme => OverlayColourScheme.Green;
-
         [Cached]
         public Bindable<IReadOnlyList<Mod>> SelectedMods { get; private set; } = new Bindable<IReadOnlyList<Mod>>(Array.Empty<Mod>());
 
@@ -65,6 +63,11 @@ namespace osu.Game.Overlays.Mods
         private ColumnScrollContainer columnScroll = null!;
         private ColumnFlowContainer columnFlow = null!;
 
+        protected ModSelectScreen(OverlayColourScheme colourScheme = OverlayColourScheme.Green)
+            : base(colourScheme)
+        {
+        }
+
         [BackgroundDependencyLoader]
         private void load()
         {
diff --git a/osu.Game/Overlays/Mods/ShearedOverlayContainer.cs b/osu.Game/Overlays/Mods/ShearedOverlayContainer.cs
index eca192c8e5..92e88bfaaf 100644
--- a/osu.Game/Overlays/Mods/ShearedOverlayContainer.cs
+++ b/osu.Game/Overlays/Mods/ShearedOverlayContainer.cs
@@ -51,17 +51,15 @@ namespace osu.Game.Overlays.Mods
         /// </summary>
         protected Container FooterContent { get; private set; }
 
-        protected abstract OverlayColourScheme ColourScheme { get; }
-
         protected override bool StartHidden => true;
 
         protected override bool BlockNonPositionalInput => true;
 
-        protected ShearedOverlayContainer()
+        protected ShearedOverlayContainer(OverlayColourScheme colourScheme)
         {
             RelativeSizeAxes = Axes.Both;
 
-            ColourProvider = new OverlayColourProvider(ColourScheme);
+            ColourProvider = new OverlayColourProvider(colourScheme);
         }
 
         [BackgroundDependencyLoader]
diff --git a/osu.Game/Overlays/Mods/UserModSelectScreen.cs b/osu.Game/Overlays/Mods/UserModSelectScreen.cs
index ca33d35605..a018797cba 100644
--- a/osu.Game/Overlays/Mods/UserModSelectScreen.cs
+++ b/osu.Game/Overlays/Mods/UserModSelectScreen.cs
@@ -12,6 +12,11 @@ namespace osu.Game.Overlays.Mods
 {
     public class UserModSelectScreen : ModSelectScreen
     {
+        public UserModSelectScreen(OverlayColourScheme colourScheme = OverlayColourScheme.Green)
+            : base(colourScheme)
+        {
+        }
+
         protected override ModColumn CreateModColumn(ModType modType, Key[] toggleKeys = null) => new UserModColumn(modType, false, toggleKeys);
 
         protected override IReadOnlyList<Mod> ComputeNewModsFromSelection(IReadOnlyList<Mod> oldSelection, IReadOnlyList<Mod> newSelection)
diff --git a/osu.Game/Screens/OnlinePlay/FreeModSelectScreen.cs b/osu.Game/Screens/OnlinePlay/FreeModSelectScreen.cs
index 5a7a60b479..63b7d1dbb5 100644
--- a/osu.Game/Screens/OnlinePlay/FreeModSelectScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/FreeModSelectScreen.cs
@@ -2,6 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
+using osu.Game.Overlays;
 using osu.Game.Overlays.Mods;
 using osu.Game.Rulesets.Mods;
 using osuTK.Input;
@@ -20,6 +21,7 @@ namespace osu.Game.Screens.OnlinePlay
         }
 
         public FreeModSelectScreen()
+            : base(OverlayColourScheme.Plum)
         {
             IsValidMod = _ => true;
         }
diff --git a/osu.Game/Screens/OnlinePlay/OnlinePlaySongSelect.cs b/osu.Game/Screens/OnlinePlay/OnlinePlaySongSelect.cs
index 0eeb32230d..d8474ef86a 100644
--- a/osu.Game/Screens/OnlinePlay/OnlinePlaySongSelect.cs
+++ b/osu.Game/Screens/OnlinePlay/OnlinePlaySongSelect.cs
@@ -14,6 +14,7 @@ using osu.Framework.Screens;
 using osu.Game.Beatmaps;
 using osu.Game.Online.API;
 using osu.Game.Online.Rooms;
+using osu.Game.Overlays;
 using osu.Game.Overlays.Mods;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Mods;
@@ -153,7 +154,7 @@ namespace osu.Game.Screens.OnlinePlay
             return base.OnExiting(e);
         }
 
-        protected override ModSelectScreen CreateModSelectOverlay() => new UserModSelectScreen
+        protected override ModSelectScreen CreateModSelectOverlay() => new UserModSelectScreen(OverlayColourScheme.Plum)
         {
             IsValidMod = IsValidMod
         };

From 4eefbd5bc21af4b34fd374fd255b29dacca3d195 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 4 May 2022 22:25:13 +0200
Subject: [PATCH 4554/5547] Use new free mod select design in room creation
 flow

---
 .../Screens/OnlinePlay/OnlinePlaySongSelect.cs  | 17 ++++++++++++++---
 osu.Game/Screens/Select/SongSelect.cs           |  4 ++--
 2 files changed, 16 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/OnlinePlaySongSelect.cs b/osu.Game/Screens/OnlinePlay/OnlinePlaySongSelect.cs
index d8474ef86a..659084addf 100644
--- a/osu.Game/Screens/OnlinePlay/OnlinePlaySongSelect.cs
+++ b/osu.Game/Screens/OnlinePlay/OnlinePlaySongSelect.cs
@@ -46,7 +46,6 @@ namespace osu.Game.Screens.OnlinePlay
 
         protected readonly Bindable<IReadOnlyList<Mod>> FreeMods = new Bindable<IReadOnlyList<Mod>>(Array.Empty<Mod>());
 
-        private readonly FreeModSelectOverlay freeModSelectOverlay;
         private readonly Room room;
 
         private WorkingBeatmap initialBeatmap;
@@ -54,13 +53,16 @@ namespace osu.Game.Screens.OnlinePlay
         private IReadOnlyList<Mod> initialMods;
         private bool itemSelected;
 
+        private FreeModSelectScreen freeModSelectOverlay;
+        private IDisposable freeModSelectOverlayRegistration;
+
         protected OnlinePlaySongSelect(Room room)
         {
             this.room = room;
 
             Padding = new MarginPadding { Horizontal = HORIZONTAL_OVERFLOW_PADDING };
 
-            freeModSelectOverlay = new FreeModSelectOverlay
+            freeModSelectOverlay = new FreeModSelectScreen
             {
                 SelectedMods = { BindTarget = FreeMods },
                 IsValidMod = IsValidFreeMod,
@@ -76,7 +78,7 @@ namespace osu.Game.Screens.OnlinePlay
             initialRuleset = Ruleset.Value;
             initialMods = Mods.Value.ToList();
 
-            FooterPanels.Add(freeModSelectOverlay);
+            LoadComponent(freeModSelectOverlay);
         }
 
         protected override void LoadComplete()
@@ -95,6 +97,8 @@ namespace osu.Game.Screens.OnlinePlay
 
             Mods.BindValueChanged(onModsChanged);
             Ruleset.BindValueChanged(onRulesetChanged);
+
+            freeModSelectOverlayRegistration = Game?.RegisterBlockingOverlay(freeModSelectOverlay);
         }
 
         private void onModsChanged(ValueChangedEvent<IReadOnlyList<Mod>> mods)
@@ -183,5 +187,12 @@ namespace osu.Game.Screens.OnlinePlay
         private bool checkCompatibleFreeMod(Mod mod)
             => Mods.Value.All(m => m.Acronym != mod.Acronym) // Mod must not be contained in the required mods.
                && ModUtils.CheckCompatibleSet(Mods.Value.Append(mod).ToArray()); // Mod must be compatible with all the required mods.
+
+        protected override void Dispose(bool isDisposing)
+        {
+            base.Dispose(isDisposing);
+
+            freeModSelectOverlayRegistration?.Dispose();
+        }
     }
 }
diff --git a/osu.Game/Screens/Select/SongSelect.cs b/osu.Game/Screens/Select/SongSelect.cs
index 448e702b96..55d28ec8a4 100644
--- a/osu.Game/Screens/Select/SongSelect.cs
+++ b/osu.Game/Screens/Select/SongSelect.cs
@@ -124,7 +124,7 @@ namespace osu.Game.Screens.Select
         private MusicController music { get; set; }
 
         [Resolved(CanBeNull = true)]
-        private OsuGame game { get; set; }
+        protected new OsuGame Game { get; private set; }
 
         [BackgroundDependencyLoader(true)]
         private void load(AudioManager audio, IDialogOverlay dialog, OsuColour colours, ManageCollectionsDialog manageCollectionsDialog, DifficultyRecommender recommender)
@@ -315,7 +315,7 @@ namespace osu.Game.Screens.Select
         {
             base.LoadComplete();
 
-            modSelectOverlayRegistration = game?.RegisterBlockingOverlay(ModSelect);
+            modSelectOverlayRegistration = Game?.RegisterBlockingOverlay(ModSelect);
         }
 
         /// <summary>

From 66473972daafbcf0b1ec7358a21dbae001ec149f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 4 May 2022 22:30:20 +0200
Subject: [PATCH 4555/5547] Use new user mod select design in multiplayer lobby

---
 .../Screens/OnlinePlay/Match/RoomSubScreen.cs | 30 +++++++++++++++----
 1 file changed, 24 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs b/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
index cc1f842f8c..5b892e1925 100644
--- a/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
@@ -5,6 +5,7 @@ using System;
 using System.Collections.Generic;
 using System.Diagnostics;
 using System.Linq;
+using JetBrains.Annotations;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
 using osu.Framework.Audio.Sample;
@@ -57,6 +58,9 @@ namespace osu.Game.Screens.OnlinePlay.Match
 
         protected readonly IBindable<long?> RoomId = new Bindable<long?>();
 
+        [Resolved]
+        private OsuGame game { get; set; }
+
         [Resolved]
         private MusicController music { get; set; }
 
@@ -77,7 +81,11 @@ namespace osu.Game.Screens.OnlinePlay.Match
         public readonly Room Room;
         private readonly bool allowEdit;
 
-        private ModSelectOverlay userModsSelectOverlay;
+        private ModSelectScreen userModsSelectOverlay;
+
+        [CanBeNull]
+        private IDisposable userModsSelectOverlayRegistration;
+
         private RoomSettingsOverlay settingsOverlay;
         private Drawable mainContent;
 
@@ -180,11 +188,6 @@ namespace osu.Game.Screens.OnlinePlay.Match
                                                                 Origin = Anchor.BottomLeft,
                                                                 RelativeSizeAxes = Axes.X,
                                                                 AutoSizeAxes = Axes.Y,
-                                                                Child = userModsSelectOverlay = new UserModSelectOverlay
-                                                                {
-                                                                    SelectedMods = { BindTarget = UserMods },
-                                                                    IsValidMod = _ => false
-                                                                }
                                                             },
                                                         }
                                                     }
@@ -227,6 +230,12 @@ namespace osu.Game.Screens.OnlinePlay.Match
                     }
                 }
             };
+
+            LoadComponent(userModsSelectOverlay = new UserModSelectScreen(OverlayColourScheme.Plum)
+            {
+                SelectedMods = { BindTarget = UserMods },
+                IsValidMod = _ => false
+            });
         }
 
         protected override void LoadComplete()
@@ -254,6 +263,8 @@ namespace osu.Game.Screens.OnlinePlay.Match
 
             beatmapAvailabilityTracker.SelectedItem.BindTo(SelectedItem);
             beatmapAvailabilityTracker.Availability.BindValueChanged(_ => updateWorkingBeatmap());
+
+            userModsSelectOverlayRegistration = game?.RegisterBlockingOverlay(userModsSelectOverlay);
         }
 
         protected override IReadOnlyDependencyContainer CreateChildDependencies(IReadOnlyDependencyContainer parent)
@@ -459,5 +470,12 @@ namespace osu.Game.Screens.OnlinePlay.Match
         public class UserModSelectButton : PurpleTriangleButton
         {
         }
+
+        protected override void Dispose(bool isDisposing)
+        {
+            base.Dispose(isDisposing);
+
+            userModsSelectOverlayRegistration?.Dispose();
+        }
     }
 }

From a56eab2c4757dfb3955e3eefb507c051c723f5b3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 5 May 2022 15:47:10 +0200
Subject: [PATCH 4556/5547] Extract interface for overlay management

---
 .../Containers/OsuFocusedOverlayContainer.cs  | 12 ++---
 osu.Game/OsuGame.cs                           | 36 +++++----------
 osu.Game/Overlays/IOverlayManager.cs          | 44 +++++++++++++++++++
 .../Screens/OnlinePlay/Match/RoomSubScreen.cs |  6 +--
 .../OnlinePlay/OnlinePlaySongSelect.cs        |  4 +-
 osu.Game/Screens/Select/SongSelect.cs         |  4 +-
 6 files changed, 69 insertions(+), 37 deletions(-)
 create mode 100644 osu.Game/Overlays/IOverlayManager.cs

diff --git a/osu.Game/Graphics/Containers/OsuFocusedOverlayContainer.cs b/osu.Game/Graphics/Containers/OsuFocusedOverlayContainer.cs
index 0e8e481e9d..512602d120 100644
--- a/osu.Game/Graphics/Containers/OsuFocusedOverlayContainer.cs
+++ b/osu.Game/Graphics/Containers/OsuFocusedOverlayContainer.cs
@@ -34,7 +34,7 @@ namespace osu.Game.Graphics.Containers
         protected virtual bool DimMainContent => true;
 
         [Resolved(CanBeNull = true)]
-        private OsuGame game { get; set; }
+        private IOverlayManager overlayManager { get; set; }
 
         [Resolved]
         private PreviewTrackManager previewTrackManager { get; set; }
@@ -50,8 +50,8 @@ namespace osu.Game.Graphics.Containers
 
         protected override void LoadComplete()
         {
-            if (game != null)
-                OverlayActivationMode.BindTo(game.OverlayActivationMode);
+            if (overlayManager != null)
+                OverlayActivationMode.BindTo(overlayManager.OverlayActivationMode);
 
             OverlayActivationMode.BindValueChanged(mode =>
             {
@@ -127,14 +127,14 @@ namespace osu.Game.Graphics.Containers
                     if (didChange)
                         samplePopIn?.Play();
 
-                    if (BlockScreenWideMouse && DimMainContent) game?.ShowBlockingOverlay(this);
+                    if (BlockScreenWideMouse && DimMainContent) overlayManager?.ShowBlockingOverlay(this);
                     break;
 
                 case Visibility.Hidden:
                     if (didChange)
                         samplePopOut?.Play();
 
-                    if (BlockScreenWideMouse) game?.HideBlockingOverlay(this);
+                    if (BlockScreenWideMouse) overlayManager?.HideBlockingOverlay(this);
                     break;
             }
 
@@ -150,7 +150,7 @@ namespace osu.Game.Graphics.Containers
         protected override void Dispose(bool isDisposing)
         {
             base.Dispose(isDisposing);
-            game?.HideBlockingOverlay(this);
+            overlayManager?.HideBlockingOverlay(this);
         }
     }
 }
diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index da8cdde944..fcf5889a7e 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -63,7 +63,7 @@ namespace osu.Game
     /// The full osu! experience. Builds on top of <see cref="OsuGameBase"/> to add menus and binding logic
     /// for initial components that are generally retrieved via DI.
     /// </summary>
-    public class OsuGame : OsuGameBase, IKeyBindingHandler<GlobalAction>, ILocalUserPlayInfo, IPerformFromScreenRunner
+    public class OsuGame : OsuGameBase, IKeyBindingHandler<GlobalAction>, ILocalUserPlayInfo, IPerformFromScreenRunner, IOverlayManager
     {
         /// <summary>
         /// The amount of global offset to apply when a left/right anchored overlay is displayed (ie. settings or notifications).
@@ -184,48 +184,34 @@ namespace osu.Game
             SentryLogger = new SentryLogger(this);
         }
 
+        #region IOverlayManager
+
+        IBindable<OverlayActivation> IOverlayManager.OverlayActivationMode => OverlayActivationMode;
+
         private void updateBlockingOverlayFade() =>
             ScreenContainer.FadeColour(visibleBlockingOverlays.Any() ? OsuColour.Gray(0.5f) : Color4.White, 500, Easing.OutQuint);
 
-        /// <summary>
-        /// Registers a blocking <see cref="OverlayContainer"/> that was not created by <see cref="OsuGame"/> itself for later use.
-        /// </summary>
-        /// <remarks>
-        /// The goal of this method is to allow child screens, like <see cref="SongSelect"/> to register their own full-screen blocking overlays
-        /// with background dim.
-        /// In those cases, for the dim to work correctly, the overlays need to be added at the `OsuGame` level directly, rather as children of the screens.
-        /// </remarks>
-        /// <returns>
-        /// An <see cref="IDisposable"/> that should be disposed of when the <paramref name="overlayContainer"/> should be unregistered.
-        /// Disposing of this <see cref="IDisposable"/> will automatically expire the <paramref name="overlayContainer"/>.
-        /// </returns>
-        internal IDisposable RegisterBlockingOverlay(OverlayContainer overlayContainer)
+        IDisposable IOverlayManager.RegisterBlockingOverlay(OverlayContainer overlayContainer)
         {
             if (overlayContainer.Parent != null)
-                throw new ArgumentException($@"Overlays registered via {nameof(RegisterBlockingOverlay)} should not be added to the scene graph.");
+                throw new ArgumentException($@"Overlays registered via {nameof(IOverlayManager.RegisterBlockingOverlay)} should not be added to the scene graph.");
 
             if (externalOverlays.Contains(overlayContainer))
-                throw new ArgumentException($@"{overlayContainer} has already been registered via {nameof(RegisterBlockingOverlay)} once.");
+                throw new ArgumentException($@"{overlayContainer} has already been registered via {nameof(IOverlayManager.RegisterBlockingOverlay)} once.");
 
             externalOverlays.Add(overlayContainer);
             overlayContent.Add(overlayContainer);
             return new InvokeOnDisposal(() => unregisterBlockingOverlay(overlayContainer));
         }
 
-        /// <summary>
-        /// Should be called when <paramref name="overlay"/> has been shown and should begin blocking background input.
-        /// </summary>
-        internal void ShowBlockingOverlay(OverlayContainer overlay)
+        void IOverlayManager.ShowBlockingOverlay(OverlayContainer overlay)
         {
             if (!visibleBlockingOverlays.Contains(overlay))
                 visibleBlockingOverlays.Add(overlay);
             updateBlockingOverlayFade();
         }
 
-        /// <summary>
-        /// Should be called when a blocking <paramref name="overlay"/> has been hidden and should stop blocking background input.
-        /// </summary>
-        internal void HideBlockingOverlay(OverlayContainer overlay) => Schedule(() =>
+        void IOverlayManager.HideBlockingOverlay(OverlayContainer overlay) => Schedule(() =>
         {
             visibleBlockingOverlays.Remove(overlay);
             updateBlockingOverlayFade();
@@ -240,6 +226,8 @@ namespace osu.Game
             overlayContainer.Expire();
         }
 
+        #endregion
+
         /// <summary>
         /// Close all game-wide overlays.
         /// </summary>
diff --git a/osu.Game/Overlays/IOverlayManager.cs b/osu.Game/Overlays/IOverlayManager.cs
new file mode 100644
index 0000000000..940ee2d8db
--- /dev/null
+++ b/osu.Game/Overlays/IOverlayManager.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 System;
+using osu.Framework.Allocation;
+using osu.Framework.Bindables;
+using osu.Framework.Graphics.Containers;
+using osu.Game.Screens.Select;
+
+namespace osu.Game.Overlays
+{
+    [Cached]
+    internal interface IOverlayManager
+    {
+        /// <summary>
+        /// Whether overlays should be able to be opened game-wide. Value is sourced from the current active screen.
+        /// </summary>
+        IBindable<OverlayActivation> OverlayActivationMode { get; }
+
+        /// <summary>
+        /// Registers a blocking <see cref="OverlayContainer"/> that was not created by <see cref="OsuGame"/> itself for later use.
+        /// </summary>
+        /// <remarks>
+        /// The goal of this method is to allow child screens, like <see cref="SongSelect"/> to register their own full-screen blocking overlays
+        /// with background dim.
+        /// In those cases, for the dim to work correctly, the overlays need to be added at a game level directly, rather as children of the screens.
+        /// </remarks>
+        /// <returns>
+        /// An <see cref="IDisposable"/> that should be disposed of when the <paramref name="overlayContainer"/> should be unregistered.
+        /// Disposing of this <see cref="IDisposable"/> will automatically expire the <paramref name="overlayContainer"/>.
+        /// </returns>
+        IDisposable RegisterBlockingOverlay(OverlayContainer overlayContainer);
+
+        /// <summary>
+        /// Should be called when <paramref name="overlay"/> has been shown and should begin blocking background input.
+        /// </summary>
+        void ShowBlockingOverlay(OverlayContainer overlay);
+
+        /// <summary>
+        /// Should be called when a blocking <paramref name="overlay"/> has been hidden and should stop blocking background input.
+        /// </summary>
+        void HideBlockingOverlay(OverlayContainer overlay);
+    }
+}
diff --git a/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs b/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
index 5b892e1925..b7a9b45bb8 100644
--- a/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
@@ -58,8 +58,8 @@ namespace osu.Game.Screens.OnlinePlay.Match
 
         protected readonly IBindable<long?> RoomId = new Bindable<long?>();
 
-        [Resolved]
-        private OsuGame game { get; set; }
+        [Resolved(CanBeNull = true)]
+        private IOverlayManager overlayManager { get; set; }
 
         [Resolved]
         private MusicController music { get; set; }
@@ -264,7 +264,7 @@ namespace osu.Game.Screens.OnlinePlay.Match
             beatmapAvailabilityTracker.SelectedItem.BindTo(SelectedItem);
             beatmapAvailabilityTracker.Availability.BindValueChanged(_ => updateWorkingBeatmap());
 
-            userModsSelectOverlayRegistration = game?.RegisterBlockingOverlay(userModsSelectOverlay);
+            userModsSelectOverlayRegistration = overlayManager?.RegisterBlockingOverlay(userModsSelectOverlay);
         }
 
         protected override IReadOnlyDependencyContainer CreateChildDependencies(IReadOnlyDependencyContainer parent)
diff --git a/osu.Game/Screens/OnlinePlay/OnlinePlaySongSelect.cs b/osu.Game/Screens/OnlinePlay/OnlinePlaySongSelect.cs
index 659084addf..c262544d6c 100644
--- a/osu.Game/Screens/OnlinePlay/OnlinePlaySongSelect.cs
+++ b/osu.Game/Screens/OnlinePlay/OnlinePlaySongSelect.cs
@@ -53,7 +53,7 @@ namespace osu.Game.Screens.OnlinePlay
         private IReadOnlyList<Mod> initialMods;
         private bool itemSelected;
 
-        private FreeModSelectScreen freeModSelectOverlay;
+        private readonly FreeModSelectScreen freeModSelectOverlay;
         private IDisposable freeModSelectOverlayRegistration;
 
         protected OnlinePlaySongSelect(Room room)
@@ -98,7 +98,7 @@ namespace osu.Game.Screens.OnlinePlay
             Mods.BindValueChanged(onModsChanged);
             Ruleset.BindValueChanged(onRulesetChanged);
 
-            freeModSelectOverlayRegistration = Game?.RegisterBlockingOverlay(freeModSelectOverlay);
+            freeModSelectOverlayRegistration = OverlayManager?.RegisterBlockingOverlay(freeModSelectOverlay);
         }
 
         private void onModsChanged(ValueChangedEvent<IReadOnlyList<Mod>> mods)
diff --git a/osu.Game/Screens/Select/SongSelect.cs b/osu.Game/Screens/Select/SongSelect.cs
index 55d28ec8a4..bb2746ee95 100644
--- a/osu.Game/Screens/Select/SongSelect.cs
+++ b/osu.Game/Screens/Select/SongSelect.cs
@@ -124,7 +124,7 @@ namespace osu.Game.Screens.Select
         private MusicController music { get; set; }
 
         [Resolved(CanBeNull = true)]
-        protected new OsuGame Game { get; private set; }
+        internal IOverlayManager OverlayManager { get; private set; }
 
         [BackgroundDependencyLoader(true)]
         private void load(AudioManager audio, IDialogOverlay dialog, OsuColour colours, ManageCollectionsDialog manageCollectionsDialog, DifficultyRecommender recommender)
@@ -315,7 +315,7 @@ namespace osu.Game.Screens.Select
         {
             base.LoadComplete();
 
-            modSelectOverlayRegistration = Game?.RegisterBlockingOverlay(ModSelect);
+            modSelectOverlayRegistration = OverlayManager?.RegisterBlockingOverlay(ModSelect);
         }
 
         /// <summary>

From fdb21fedaba887647523f0c25fdad6c3bc0775d1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 5 May 2022 16:31:02 +0200
Subject: [PATCH 4557/5547] Implement `IOverlayManager` in `ScreenTestScene`

---
 osu.Game/Tests/Visual/ScreenTestScene.cs | 33 ++++++++++++++++++++++--
 1 file changed, 31 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Tests/Visual/ScreenTestScene.cs b/osu.Game/Tests/Visual/ScreenTestScene.cs
index e9069d8c9c..0fa2f3e786 100644
--- a/osu.Game/Tests/Visual/ScreenTestScene.cs
+++ b/osu.Game/Tests/Visual/ScreenTestScene.cs
@@ -1,12 +1,15 @@
 // 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.Bindables;
 using osu.Framework.Development;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Logging;
 using osu.Framework.Testing;
+using osu.Game.Graphics;
 using osu.Game.Overlays;
 using osu.Game.Screens;
 
@@ -15,11 +18,12 @@ namespace osu.Game.Tests.Visual
     /// <summary>
     /// A test case which can be used to test a screen (that relies on OnEntering being called to execute startup instructions).
     /// </summary>
-    public abstract class ScreenTestScene : OsuManualInputManagerTestScene
+    public abstract class ScreenTestScene : OsuManualInputManagerTestScene, IOverlayManager
     {
         protected readonly OsuScreenStack Stack;
 
         private readonly Container content;
+        private readonly Container overlayContent;
 
         protected override Container<Drawable> Content => content;
 
@@ -36,7 +40,11 @@ namespace osu.Game.Tests.Visual
                     RelativeSizeAxes = Axes.Both
                 },
                 content = new Container { RelativeSizeAxes = Axes.Both },
-                DialogOverlay = new DialogOverlay()
+                overlayContent = new Container
+                {
+                    RelativeSizeAxes = Axes.Both,
+                    Child = DialogOverlay = new DialogOverlay()
+                }
             });
 
             Stack.ScreenPushed += (lastScreen, newScreen) => Logger.Log($"{nameof(ScreenTestScene)} screen changed → {newScreen}");
@@ -65,5 +73,26 @@ namespace osu.Game.Tests.Visual
                 return false;
             });
         }
+
+        #region IOverlayManager
+
+        IBindable<OverlayActivation> IOverlayManager.OverlayActivationMode { get; } = new Bindable<OverlayActivation>(OverlayActivation.All);
+
+        // in the blocking methods below it is important to be careful about threading (e.g. use `Expire()` rather than `Remove()`, and schedule transforms),
+        // because in the worst case the clean-up methods could be called from async disposal.
+
+        IDisposable IOverlayManager.RegisterBlockingOverlay(OverlayContainer overlayContainer)
+        {
+            overlayContent.Add(overlayContainer);
+            return new InvokeOnDisposal(() => overlayContainer.Expire());
+        }
+
+        void IOverlayManager.ShowBlockingOverlay(OverlayContainer overlay)
+            => Schedule(() => Stack.FadeColour(OsuColour.Gray(0.5f), 500, Easing.OutQuint));
+
+        void IOverlayManager.HideBlockingOverlay(OverlayContainer overlay)
+            => Schedule(() => Stack.FadeColour(Colour4.White, 500, Easing.OutQuint));
+
+        #endregion
     }
 }

From 0caea7717641ad85849219257ea563e2ad8e53f3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 5 May 2022 17:27:21 +0200
Subject: [PATCH 4558/5547] Fix mod selects not hiding when their owner screens
 exit

---
 osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs  | 10 ++++++++--
 osu.Game/Screens/OnlinePlay/OnlinePlaySongSelect.cs |  2 ++
 osu.Game/Screens/Select/SongSelect.cs               |  1 +
 3 files changed, 11 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs b/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
index b7a9b45bb8..ec4e329f7a 100644
--- a/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
@@ -309,7 +309,7 @@ namespace osu.Game.Screens.OnlinePlay.Match
 
         public override void OnSuspending(ScreenTransitionEvent e)
         {
-            endHandlingTrack();
+            onLeaving();
             base.OnSuspending(e);
         }
 
@@ -327,7 +327,7 @@ namespace osu.Game.Screens.OnlinePlay.Match
             RoomManager?.PartRoom();
             Mods.Value = Array.Empty<Mod>();
 
-            endHandlingTrack();
+            onLeaving();
 
             return base.OnExiting(e);
         }
@@ -423,6 +423,12 @@ namespace osu.Game.Screens.OnlinePlay.Match
             Beatmap.BindValueChanged(applyLoopingToTrack, true);
         }
 
+        private void onLeaving()
+        {
+            userModsSelectOverlay.Hide();
+            endHandlingTrack();
+        }
+
         private void endHandlingTrack()
         {
             Beatmap.ValueChanged -= applyLoopingToTrack;
diff --git a/osu.Game/Screens/OnlinePlay/OnlinePlaySongSelect.cs b/osu.Game/Screens/OnlinePlay/OnlinePlaySongSelect.cs
index c262544d6c..c4503773ad 100644
--- a/osu.Game/Screens/OnlinePlay/OnlinePlaySongSelect.cs
+++ b/osu.Game/Screens/OnlinePlay/OnlinePlaySongSelect.cs
@@ -155,6 +155,8 @@ namespace osu.Game.Screens.OnlinePlay
                 Mods.Value = initialMods;
             }
 
+            freeModSelectOverlay.Hide();
+
             return base.OnExiting(e);
         }
 
diff --git a/osu.Game/Screens/Select/SongSelect.cs b/osu.Game/Screens/Select/SongSelect.cs
index bb2746ee95..eb5e996972 100644
--- a/osu.Game/Screens/Select/SongSelect.cs
+++ b/osu.Game/Screens/Select/SongSelect.cs
@@ -659,6 +659,7 @@ namespace osu.Game.Screens.Select
                 return true;
 
             beatmapInfoWedge.Hide();
+            ModSelect.Hide();
 
             this.FadeOut(100);
 

From 8f65e0e60f4931f736e6b342e18b6a67e1ecbb4e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 5 May 2022 21:08:19 +0200
Subject: [PATCH 4559/5547] Add failing test coverage for toggling mod overlay
 with hotkey

---
 .../Visual/SongSelect/TestScenePlaySongSelect.cs | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
index d27f16a624..083e24be7b 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
@@ -8,6 +8,7 @@ using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
 using osu.Framework.Bindables;
+using osu.Framework.Graphics.Containers;
 using osu.Framework.Platform;
 using osu.Framework.Screens;
 using osu.Framework.Testing;
@@ -18,6 +19,7 @@ using osu.Game.Extensions;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays;
+using osu.Game.Overlays.Mods;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Osu;
@@ -918,6 +920,19 @@ namespace osu.Game.Tests.Visual.SongSelect
             AddAssert("check ruleset is correct for score", () => Ruleset.Value.OnlineID == 0);
         }
 
+        [Test]
+        public void TestModOverlayToggling()
+        {
+            changeRuleset(0);
+            createSongSelect();
+
+            AddStep("toggle mod overlay on", () => InputManager.Key(Key.F1));
+            AddUntilStep("mod overlay shown", () => songSelect.ModSelect.State.Value == Visibility.Visible);
+
+            AddStep("toggle mod overlay off", () => InputManager.Key(Key.F1));
+            AddUntilStep("mod overlay hidden", () => songSelect.ModSelect.State.Value == Visibility.Hidden);
+        }
+
         private void waitForInitialSelection()
         {
             AddUntilStep("wait for initial selection", () => !Beatmap.IsDefault);
@@ -993,6 +1008,7 @@ namespace osu.Game.Tests.Visual.SongSelect
             public WorkingBeatmap CurrentBeatmap => Beatmap.Value;
             public IWorkingBeatmap CurrentBeatmapDetailsBeatmap => BeatmapDetails.Beatmap;
             public new BeatmapCarousel Carousel => base.Carousel;
+            public new ModSelectScreen ModSelect => base.ModSelect;
 
             public new void PresentScore(ScoreInfo score) => base.PresentScore(score);
 

From 34cf4c6a3895557d6dc5f1d07b702857b512ccca Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 5 May 2022 21:22:07 +0200
Subject: [PATCH 4560/5547] Fix mod overlay not closing on toggle hotkey

---
 osu.Game/Overlays/Mods/ModSelectScreen.cs     | 21 +++++++++++++++++++
 .../OnlinePlay/OnlinePlaySongSelect.cs        |  2 ++
 osu.Game/Screens/Select/SongSelect.cs         |  5 ++++-
 3 files changed, 27 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/Mods/ModSelectScreen.cs b/osu.Game/Overlays/Mods/ModSelectScreen.cs
index bf47e4351a..7c0ed941c6 100644
--- a/osu.Game/Overlays/Mods/ModSelectScreen.cs
+++ b/osu.Game/Overlays/Mods/ModSelectScreen.cs
@@ -20,6 +20,7 @@ using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Input.Bindings;
 using osu.Game.Rulesets.Mods;
+using osu.Game.Screens.Select;
 using osuTK;
 using osuTK.Input;
 
@@ -44,6 +45,15 @@ namespace osu.Game.Overlays.Mods
             }
         }
 
+        /// <summary>
+        /// Hotkey that should be used to hide the mod select screen.
+        /// </summary>
+        /// <remarks>
+        /// This is handled locally here rather than via <see cref="FooterButtonMods"/>, because this overlay is being registered at the game level
+        /// and therefore takes away keyboard focus from the screen stack.
+        /// </remarks>
+        internal GlobalAction? Hotkey { get; set; }
+
         /// <summary>
         /// Whether configurable <see cref="Mod"/>s can be configured by the local user.
         /// </summary>
@@ -321,12 +331,23 @@ namespace osu.Game.Overlays.Mods
 
         public override bool OnPressed(KeyBindingPressEvent<GlobalAction> e)
         {
+            if (e.Repeat)
+                return false;
+
             if (e.Action == GlobalAction.Back && customisationVisible.Value)
             {
                 customisationVisible.Value = false;
                 return true;
             }
 
+            if (e.Action == Hotkey)
+            {
+                if (customisationVisible.Value)
+                    customisationVisible.Value = false;
+                Hide();
+                return true;
+            }
+
             return base.OnPressed(e);
         }
 
diff --git a/osu.Game/Screens/OnlinePlay/OnlinePlaySongSelect.cs b/osu.Game/Screens/OnlinePlay/OnlinePlaySongSelect.cs
index c4503773ad..4b6c06481b 100644
--- a/osu.Game/Screens/OnlinePlay/OnlinePlaySongSelect.cs
+++ b/osu.Game/Screens/OnlinePlay/OnlinePlaySongSelect.cs
@@ -12,6 +12,7 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Screens;
 using osu.Game.Beatmaps;
+using osu.Game.Input.Bindings;
 using osu.Game.Online.API;
 using osu.Game.Online.Rooms;
 using osu.Game.Overlays;
@@ -162,6 +163,7 @@ namespace osu.Game.Screens.OnlinePlay
 
         protected override ModSelectScreen CreateModSelectOverlay() => new UserModSelectScreen(OverlayColourScheme.Plum)
         {
+            Hotkey = GlobalAction.ToggleModSelection,
             IsValidMod = IsValidMod
         };
 
diff --git a/osu.Game/Screens/Select/SongSelect.cs b/osu.Game/Screens/Select/SongSelect.cs
index eb5e996972..7317b20f88 100644
--- a/osu.Game/Screens/Select/SongSelect.cs
+++ b/osu.Game/Screens/Select/SongSelect.cs
@@ -333,7 +333,10 @@ namespace osu.Game.Screens.Select
             (new FooterButtonOptions(), BeatmapOptions)
         };
 
-        protected virtual ModSelectScreen CreateModSelectOverlay() => new UserModSelectScreen();
+        protected virtual ModSelectScreen CreateModSelectOverlay() => new UserModSelectScreen
+        {
+            Hotkey = GlobalAction.ToggleModSelection
+        };
 
         protected virtual void ApplyFilterToCarousel(FilterCriteria criteria)
         {

From 17c19063f7945ad3d40287f471875c0a109835f4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 5 May 2022 21:24:11 +0200
Subject: [PATCH 4561/5547] Fix user dim test scene accumulating no fail
 instances in `SelectedMods`

The old design was apparently somehow tolerant of multiple instances of
the same mod in `SelectedMods`, but the new one is not.

Fix the test, because appending to a list of mods that was getting
modified by previous tests is generally not how tests should be
written.
---
 .../Visual/Background/TestSceneUserDimBackgrounds.cs           | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Visual/Background/TestSceneUserDimBackgrounds.cs b/osu.Game.Tests/Visual/Background/TestSceneUserDimBackgrounds.cs
index f7140537ee..ef115ab66b 100644
--- a/osu.Game.Tests/Visual/Background/TestSceneUserDimBackgrounds.cs
+++ b/osu.Game.Tests/Visual/Background/TestSceneUserDimBackgrounds.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 System.Threading;
 using NUnit.Framework;
 using osu.Framework.Allocation;
@@ -283,7 +282,7 @@ namespace osu.Game.Tests.Visual.Background
             AddUntilStep("Song select has selection", () => songSelect.Carousel?.SelectedBeatmapInfo != null);
             AddStep("Set default user settings", () =>
             {
-                SelectedMods.Value = SelectedMods.Value.Concat(new[] { new OsuModNoFail() }).ToArray();
+                SelectedMods.Value = new[] { new OsuModNoFail() };
                 songSelect.DimLevel.Value = 0.7f;
                 songSelect.BlurLevel.Value = 0.4f;
             });

From 199bdb8e7ded820c6a0b1663ef307d8564f9a831 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 5 May 2022 21:43:39 +0200
Subject: [PATCH 4562/5547] Replace reference to old mod select in multiplayer
 test

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

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
index 6a69917fb4..8e26d1c562 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
@@ -622,7 +622,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             AddStep("invoke on back button", () => multiplayerComponents.OnBackButton());
 
-            AddAssert("mod overlay is hidden", () => this.ChildrenOfType<UserModSelectOverlay>().Single().State.Value == Visibility.Hidden);
+            AddAssert("mod overlay is hidden", () => this.ChildrenOfType<UserModSelectScreen>().Single().State.Value == Visibility.Hidden);
 
             AddAssert("dialog overlay is hidden", () => DialogOverlay.State.Value == Visibility.Hidden);
 

From ecc28050992e69ec8a1068ede63d8cd313623680 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 5 May 2022 21:47:03 +0200
Subject: [PATCH 4563/5547] Replace references to old mod select classes in
 match song select test

Also note the change from `songSelect.ChildrenOfType<>()...` to
`this.ChildrenOfType<>()...` - because the new design is registered at
game-level, the mod select is not a child of the song select screen
anymore.
---
 .../Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs   | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs
index 714951cc42..d170b12dc3 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs
@@ -132,7 +132,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         private void assertHasFreeModButton(Type type, bool hasButton = true)
         {
             AddAssert($"{type.ReadableName()} {(hasButton ? "displayed" : "not displayed")} in freemod overlay",
-                () => songSelect.ChildrenOfType<FreeModSelectOverlay>().Single().ChildrenOfType<ModButton>().All(b => b.Mod.GetType() != type));
+                () => this.ChildrenOfType<FreeModSelectScreen>().Single().ChildrenOfType<ModPanel>().All(b => b.Mod.GetType() != type));
         }
 
         private class TestMultiplayerMatchSongSelect : MultiplayerMatchSongSelect

From d296f78dfe097fdf70c759a416538ef7a1fa3fc5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 5 May 2022 21:59:44 +0200
Subject: [PATCH 4564/5547] Replace references to old mod select classes in
 multiplayer match screen test

---
 .../Multiplayer/TestSceneMultiplayerMatchSubScreen.cs      | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs
index 057032c413..2abde82e92 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs
@@ -168,8 +168,13 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             ClickButtonWhenEnabled<RoomSubScreen.UserModSelectButton>();
 
+            AddUntilStep("mod select contents loaded",
+                () => this.ChildrenOfType<ModColumn>().Any() && this.ChildrenOfType<ModColumn>().All(col => col.IsLoaded && col.ItemsLoaded));
             AddUntilStep("mod select contains only double time mod",
-                () => this.ChildrenOfType<UserModSelectOverlay>().SingleOrDefault()?.ChildrenOfType<ModButton>().SingleOrDefault()?.Mod is OsuModDoubleTime);
+                () => this.ChildrenOfType<UserModSelectScreen>()
+                          .SingleOrDefault()?
+                          .ChildrenOfType<ModPanel>()
+                          .SingleOrDefault(panel => !panel.Filtered.Value)?.Mod is OsuModDoubleTime);
         }
     }
 }

From a2ab79620a2a7dd63260a23951b9b2d572046d56 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 5 May 2022 22:15:49 +0200
Subject: [PATCH 4565/5547] Update song select exit via click test to match new
 expectations

---
 .../Visual/Navigation/TestSceneScreenNavigation.cs        | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs b/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
index 8ba074a7d1..f8eee7be56 100644
--- a/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
@@ -253,12 +253,12 @@ namespace osu.Game.Tests.Visual.Navigation
             PushAndConfirm(() => songSelect = new TestPlaySongSelect());
             AddStep("Show mods overlay", () => songSelect.ModSelectOverlay.Show());
             AddAssert("Overlay was shown", () => songSelect.ModSelectOverlay.State.Value == Visibility.Visible);
-            AddStep("Move mouse to backButton", () => InputManager.MoveMouseTo(backButtonPosition));
 
-            // BackButton handles hover using its child button, so this checks whether or not any of BackButton's children are hovered.
-            AddUntilStep("Back button is hovered", () => Game.ChildrenOfType<BackButton>().First().Children.Any(c => c.IsHovered));
+            AddStep("Move mouse to dimmed area", () => InputManager.MoveMouseTo(new Vector2(
+                songSelect.ScreenSpaceDrawQuad.TopLeft.X + 1,
+                songSelect.ScreenSpaceDrawQuad.TopLeft.Y + songSelect.ScreenSpaceDrawQuad.Height / 2)));
+            AddStep("Click left mouse button", () => InputManager.Click(MouseButton.Left));
 
-            AddStep("Click back button", () => InputManager.Click(MouseButton.Left));
             AddUntilStep("Overlay was hidden", () => songSelect.ModSelectOverlay.State.Value == Visibility.Hidden);
             exitViaBackButtonAndConfirm();
         }

From 16a6c11bc87a906b36e699fcd2101eac371dcb25 Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Thu, 5 May 2022 21:39:31 +0100
Subject: [PATCH 4566/5547] Clamp maximum and minimum height the chat overlay
 can be resized to

---
 osu.Game/Overlays/ChatOverlayV2.cs | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Overlays/ChatOverlayV2.cs b/osu.Game/Overlays/ChatOverlayV2.cs
index cab88136fc..8b6fe70f3c 100644
--- a/osu.Game/Overlays/ChatOverlayV2.cs
+++ b/osu.Game/Overlays/ChatOverlayV2.cs
@@ -3,6 +3,7 @@
 
 #nullable enable
 
+using System;
 using System.Collections;
 using System.Collections.Generic;
 using System.Collections.Specialized;
@@ -44,8 +45,11 @@ namespace osu.Game.Overlays
         private bool isDraggingTopBar;
         private float dragStartChatHeight;
 
-        private const int transition_length = 500;
+        private const float min_chat_height = 0.2f;
+        private const float max_chat_height = 1f;
         private const float default_chat_height = 0.4f;
+
+        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;
@@ -215,7 +219,7 @@ namespace osu.Game.Overlays
                 return;
 
             float targetChatHeight = dragStartChatHeight - (e.MousePosition.Y - e.MouseDownPosition.Y) / Parent.DrawSize.Y;
-            chatHeight.Value = targetChatHeight;
+            chatHeight.Value = Math.Clamp(targetChatHeight, min_chat_height, max_chat_height);
         }
 
         protected override void OnDragEnd(DragEndEvent e)

From 0974de8fb007afdca51520ac44204c408a6d3523 Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Thu, 5 May 2022 23:13:32 +0100
Subject: [PATCH 4567/5547] Use `BindableFloat` for chat height

---
 osu.Game/Overlays/ChatOverlayV2.cs | 10 +++-------
 1 file changed, 3 insertions(+), 7 deletions(-)

diff --git a/osu.Game/Overlays/ChatOverlayV2.cs b/osu.Game/Overlays/ChatOverlayV2.cs
index 8b6fe70f3c..4c7fa0f802 100644
--- a/osu.Game/Overlays/ChatOverlayV2.cs
+++ b/osu.Game/Overlays/ChatOverlayV2.cs
@@ -3,7 +3,6 @@
 
 #nullable enable
 
-using System;
 using System.Collections;
 using System.Collections.Generic;
 using System.Collections.Specialized;
@@ -40,16 +39,13 @@ namespace osu.Game.Overlays
         private ChatTextBar textBar = null!;
         private Container<DrawableChannel> currentChannelContainer = null!;
 
-        private readonly Bindable<float> chatHeight = new Bindable<float>();
+        private readonly BindableFloat chatHeight = new BindableFloat();
 
         private bool isDraggingTopBar;
         private float dragStartChatHeight;
 
-        private const float min_chat_height = 0.2f;
-        private const float max_chat_height = 1f;
-        private const float default_chat_height = 0.4f;
-
         private const int transition_length = 500;
+        private const float default_chat_height = 0.4f;
         private const float top_bar_height = 40;
         private const float side_bar_width = 190;
         private const float chat_bar_height = 60;
@@ -219,7 +215,7 @@ namespace osu.Game.Overlays
                 return;
 
             float targetChatHeight = dragStartChatHeight - (e.MousePosition.Y - e.MouseDownPosition.Y) / Parent.DrawSize.Y;
-            chatHeight.Value = Math.Clamp(targetChatHeight, min_chat_height, max_chat_height);
+            chatHeight.Value = targetChatHeight;
         }
 
         protected override void OnDragEnd(DragEndEvent e)

From 7ffe3b132fbe12ff2f8689fbc330aecf90bd1249 Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Thu, 5 May 2022 23:13:43 +0100
Subject: [PATCH 4568/5547] Use `BindableFloat` in chat height tests

---
 .../Visual/Online/TestSceneChatOverlayV2.cs      | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs b/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs
index 98574e5d53..7c77ac925e 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs
@@ -133,22 +133,22 @@ namespace osu.Game.Tests.Visual.Online
         [Test]
         public void TestChatHeight()
         {
-            Bindable<float> configChatHeight = null;
+            BindableFloat configChatHeight = new BindableFloat();
+            config.BindWith(OsuSetting.ChatDisplayHeight, configChatHeight);
             float newHeight = 0;
 
-            AddStep("Bind config chat height", () => configChatHeight = config.GetBindable<float>(OsuSetting.ChatDisplayHeight).GetBoundCopy());
-            AddStep("Set config chat height", () => configChatHeight.Value = 0.4f);
+            AddStep("Reset config chat height", () => configChatHeight.SetDefault());
             AddStep("Show overlay", () => chatOverlay.Show());
-            AddAssert("Overlay uses config height", () => chatOverlay.Height == 0.4f);
-            AddStep("Drag overlay to new height", () =>
+            AddAssert("Overlay uses config height", () => chatOverlay.Height == configChatHeight.Default);
+            AddStep("Click top bar", () =>
             {
                 InputManager.MoveMouseTo(chatOverlayTopBar);
                 InputManager.PressButton(MouseButton.Left);
-                InputManager.MoveMouseTo(chatOverlayTopBar, new Vector2(0, -300));
-                InputManager.ReleaseButton(MouseButton.Left);
             });
+            AddStep("Drag overlay to new height", () => InputManager.MoveMouseTo(chatOverlayTopBar, new Vector2(0, -300)));
+            AddStep("Stop dragging", () => InputManager.ReleaseButton(MouseButton.Left));
             AddStep("Store new height", () => newHeight = chatOverlay.Height);
-            AddAssert("Config height changed", () => configChatHeight.Value != 0.4f && configChatHeight.Value == newHeight);
+            AddAssert("Config height changed", () => !configChatHeight.IsDefault && configChatHeight.Value == newHeight);
             AddStep("Hide overlay", () => chatOverlay.Hide());
             AddStep("Show overlay", () => chatOverlay.Show());
             AddAssert("Overlay uses new height", () => chatOverlay.Height == newHeight);

From be960eb092aacf2f8651d5099b1eb2d1eb09a8a1 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 6 May 2022 14:34:31 +0900
Subject: [PATCH 4569/5547] Move dangerous hold specification to base class

---
 .../Containers/HoldToConfirmContainer.cs      | 32 ++++++++++----
 .../Dialog/PopupDialogDangerousButton.cs      |  7 ++--
 .../Screens/Play/HUD/HoldForMenuButton.cs     | 42 +++++++------------
 3 files changed, 43 insertions(+), 38 deletions(-)

diff --git a/osu.Game/Graphics/Containers/HoldToConfirmContainer.cs b/osu.Game/Graphics/Containers/HoldToConfirmContainer.cs
index c74245461d..078721ec77 100644
--- a/osu.Game/Graphics/Containers/HoldToConfirmContainer.cs
+++ b/osu.Game/Graphics/Containers/HoldToConfirmContainer.cs
@@ -12,6 +12,13 @@ namespace osu.Game.Graphics.Containers
 {
     public abstract class HoldToConfirmContainer : Container
     {
+        public const double DANGEROUS_HOLD_ACTIVATION_DELAY = 500;
+
+        /// <summary>
+        /// Whether the associated action is considered dangerous, warranting a longer hold.
+        /// </summary>
+        public bool IsDangerousAction { get; }
+
         public Action Action;
 
         private const int fadeout_delay = 200;
@@ -29,12 +36,9 @@ namespace osu.Game.Graphics.Containers
         protected virtual bool AllowMultipleFires => false;
 
         /// <summary>
-        /// Specify a custom activation delay, overriding the game-wide user setting.
+        /// The current activation delay for this control.
         /// </summary>
-        /// <remarks>
-        /// This should be used in special cases where we want to be extra sure the user knows what they are doing. An example is when changes would be lost.
-        /// </remarks>
-        protected virtual double? HoldActivationDelay => null;
+        protected IBindable<double> HoldActivationDelay => holdActivationDelay;
 
         public Bindable<double> Progress = new BindableDouble();
 
@@ -43,13 +47,25 @@ namespace osu.Game.Graphics.Containers
         [Resolved]
         private OsuConfigManager config { get; set; }
 
+        protected HoldToConfirmContainer(bool isDangerousAction = false)
+        {
+            IsDangerousAction = isDangerousAction;
+        }
+
         protected override void LoadComplete()
         {
             base.LoadComplete();
 
-            holdActivationDelay = HoldActivationDelay != null
-                ? new Bindable<double>(HoldActivationDelay.Value)
-                : config.GetBindable<double>(OsuSetting.UIHoldActivationDelay);
+            if (IsDangerousAction)
+            {
+                holdActivationDelay.Value = DANGEROUS_HOLD_ACTIVATION_DELAY;
+            }
+            else
+            {
+                holdActivationDelay = HoldActivationDelay != null
+                    ? new Bindable<double>(HoldActivationDelay.Value)
+                    : config.GetBindable<double>(OsuSetting.UIHoldActivationDelay);
+            }
         }
 
         protected void BeginConfirm()
diff --git a/osu.Game/Overlays/Dialog/PopupDialogDangerousButton.cs b/osu.Game/Overlays/Dialog/PopupDialogDangerousButton.cs
index 6c775f44f8..6239c5e409 100644
--- a/osu.Game/Overlays/Dialog/PopupDialogDangerousButton.cs
+++ b/osu.Game/Overlays/Dialog/PopupDialogDangerousButton.cs
@@ -12,8 +12,6 @@ namespace osu.Game.Overlays.Dialog
 {
     public class PopupDialogDangerousButton : PopupDialogButton
     {
-        public const double DANGEROUS_HOLD_ACTIVATION_DELAY = 500;
-
         private Box progressBox;
         private DangerousConfirmContainer confirmContainer;
 
@@ -44,7 +42,10 @@ namespace osu.Game.Overlays.Dialog
 
         private class DangerousConfirmContainer : HoldToConfirmContainer
         {
-            protected override double? HoldActivationDelay => DANGEROUS_HOLD_ACTIVATION_DELAY;
+            public DangerousConfirmContainer()
+                : base(isDangerousAction: true)
+            {
+            }
 
             protected override bool OnMouseDown(MouseDownEvent e)
             {
diff --git a/osu.Game/Screens/Play/HUD/HoldForMenuButton.cs b/osu.Game/Screens/Play/HUD/HoldForMenuButton.cs
index c6aa3fbe08..9d280a1737 100644
--- a/osu.Game/Screens/Play/HUD/HoldForMenuButton.cs
+++ b/osu.Game/Screens/Play/HUD/HoldForMenuButton.cs
@@ -13,12 +13,10 @@ using osu.Framework.Graphics.UserInterface;
 using osu.Framework.Input.Bindings;
 using osu.Framework.Input.Events;
 using osu.Framework.Utils;
-using osu.Game.Configuration;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Input.Bindings;
-using osu.Game.Overlays.Dialog;
 using osuTK;
 
 namespace osu.Game.Screens.Play.HUD
@@ -29,20 +27,11 @@ namespace osu.Game.Screens.Play.HUD
 
         public readonly Bindable<bool> IsPaused = new Bindable<bool>();
 
-        private readonly Button button;
+        private Button button;
 
-        public Action Action
-        {
-            set => button.Action = value;
-        }
+        public Action Action { get; set; }
 
-        private readonly OsuSpriteText text;
-
-        [Resolved]
-        private OsuConfigManager config { get; set; }
-
-        [Resolved(canBeNull: true)]
-        private Player player { get; set; }
+        private OsuSpriteText text;
 
         private readonly Bindable<double> activationDelay = new Bindable<double>();
 
@@ -51,6 +40,11 @@ namespace osu.Game.Screens.Play.HUD
             Direction = FillDirection.Horizontal;
             Spacing = new Vector2(20, 0);
             Margin = new MarginPadding(10);
+        }
+
+        [BackgroundDependencyLoader(true)]
+        private void load(Player player)
+        {
             Children = new Drawable[]
             {
                 text = new OsuSpriteText
@@ -59,11 +53,12 @@ namespace osu.Game.Screens.Play.HUD
                     Anchor = Anchor.CentreLeft,
                     Origin = Anchor.CentreLeft
                 },
-                button = new Button
+                button = new Button(player?.Configuration.AllowRestart == false)
                 {
                     HoverGained = () => text.FadeIn(500, Easing.OutQuint),
                     HoverLost = () => text.FadeOut(500, Easing.OutQuint),
-                    IsPaused = { BindTarget = IsPaused }
+                    IsPaused = { BindTarget = IsPaused },
+                    Action = () => Action(),
                 }
             };
             AutoSizeAxes = Axes.Both;
@@ -71,13 +66,6 @@ namespace osu.Game.Screens.Play.HUD
 
         protected override void LoadComplete()
         {
-            if (player?.Configuration.AllowRestart == false)
-            {
-                activationDelay.Value = PopupDialogDangerousButton.DANGEROUS_HOLD_ACTIVATION_DELAY;
-            }
-            else
-                config.BindWith(OsuSetting.UIHoldActivationDelay, activationDelay);
-
             activationDelay.BindValueChanged(v =>
             {
                 text.Text = v.NewValue > 0
@@ -125,10 +113,10 @@ namespace osu.Game.Screens.Play.HUD
             public Action HoverGained;
             public Action HoverLost;
 
-            [Resolved(canBeNull: true)]
-            private Player player { get; set; }
-
-            protected override double? HoldActivationDelay => player?.Configuration.AllowRestart == false ? PopupDialogDangerousButton.DANGEROUS_HOLD_ACTIVATION_DELAY : (double?)null;
+            public Button(bool isDangerousAction)
+                : base(isDangerousAction)
+            {
+            }
 
             [BackgroundDependencyLoader]
             private void load(OsuColour colours)

From a11771c11b82992c2b5dfdda3acfcc09c59121e1 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 6 May 2022 14:37:50 +0900
Subject: [PATCH 4570/5547] Better encapsulate exposed bindables of
 `HoldToConfirmContainer`

---
 .../Containers/HoldToConfirmContainer.cs      | 40 ++++++++++---------
 .../Screens/Play/HUD/HoldForMenuButton.cs     |  2 +-
 2 files changed, 22 insertions(+), 20 deletions(-)

diff --git a/osu.Game/Graphics/Containers/HoldToConfirmContainer.cs b/osu.Game/Graphics/Containers/HoldToConfirmContainer.cs
index 078721ec77..540f9b97a7 100644
--- a/osu.Game/Graphics/Containers/HoldToConfirmContainer.cs
+++ b/osu.Game/Graphics/Containers/HoldToConfirmContainer.cs
@@ -14,15 +14,18 @@ namespace osu.Game.Graphics.Containers
     {
         public const double DANGEROUS_HOLD_ACTIVATION_DELAY = 500;
 
+        private const int fadeout_delay = 200;
+
         /// <summary>
         /// Whether the associated action is considered dangerous, warranting a longer hold.
         /// </summary>
         public bool IsDangerousAction { get; }
 
+        /// <summary>
+        /// The action to perform when a hold successfully completes.
+        /// </summary>
         public Action Action;
 
-        private const int fadeout_delay = 200;
-
         /// <summary>
         /// Whether currently in a fired state (and the confirm <see cref="Action"/> has been sent).
         /// </summary>
@@ -30,19 +33,24 @@ namespace osu.Game.Graphics.Containers
 
         private bool confirming;
 
+        /// <summary>
+        /// The current activation delay for this control.
+        /// </summary>
+        public IBindable<double> HoldActivationDelay => holdActivationDelay;
+
+        /// <summary>
+        /// The progress of any ongoing hold operation. 0 means no hold has started; 1 means a hold has been completed.
+        /// </summary>
+        public IBindable<double> Progress => progress;
+
         /// <summary>
         /// Whether the overlay should be allowed to return from a fired state.
         /// </summary>
         protected virtual bool AllowMultipleFires => false;
 
-        /// <summary>
-        /// The current activation delay for this control.
-        /// </summary>
-        protected IBindable<double> HoldActivationDelay => holdActivationDelay;
+        private readonly Bindable<double> progress = new BindableDouble();
 
-        public Bindable<double> Progress = new BindableDouble();
-
-        private Bindable<double> holdActivationDelay;
+        private readonly Bindable<double> holdActivationDelay = new Bindable<double>();
 
         [Resolved]
         private OsuConfigManager config { get; set; }
@@ -57,15 +65,9 @@ namespace osu.Game.Graphics.Containers
             base.LoadComplete();
 
             if (IsDangerousAction)
-            {
                 holdActivationDelay.Value = DANGEROUS_HOLD_ACTIVATION_DELAY;
-            }
             else
-            {
-                holdActivationDelay = HoldActivationDelay != null
-                    ? new Bindable<double>(HoldActivationDelay.Value)
-                    : config.GetBindable<double>(OsuSetting.UIHoldActivationDelay);
-            }
+                config.BindWith(OsuSetting.UIHoldActivationDelay, holdActivationDelay);
         }
 
         protected void BeginConfirm()
@@ -74,7 +76,7 @@ namespace osu.Game.Graphics.Containers
 
             confirming = true;
 
-            this.TransformBindableTo(Progress, 1, holdActivationDelay.Value * (1 - Progress.Value), Easing.Out).OnComplete(_ => Confirm());
+            this.TransformBindableTo(progress, 1, holdActivationDelay.Value * (1 - progress.Value), Easing.Out).OnComplete(_ => Confirm());
         }
 
         protected virtual void Confirm()
@@ -91,9 +93,9 @@ namespace osu.Game.Graphics.Containers
             Fired = false;
 
             this
-                .TransformBindableTo(Progress, Progress.Value)
+                .TransformBindableTo(progress, progress.Value)
                 .Delay(200)
-                .TransformBindableTo(Progress, 0, fadeout_delay, Easing.InSine);
+                .TransformBindableTo(progress, 0, fadeout_delay, Easing.InSine);
         }
     }
 }
diff --git a/osu.Game/Screens/Play/HUD/HoldForMenuButton.cs b/osu.Game/Screens/Play/HUD/HoldForMenuButton.cs
index 9d280a1737..678c4256b4 100644
--- a/osu.Game/Screens/Play/HUD/HoldForMenuButton.cs
+++ b/osu.Game/Screens/Play/HUD/HoldForMenuButton.cs
@@ -164,7 +164,7 @@ namespace osu.Game.Screens.Play.HUD
 
             private void bind()
             {
-                circularProgress.Current.BindTo(Progress);
+                ((IBindable<double>)circularProgress.Current).BindTo(Progress);
                 Progress.ValueChanged += progress => icon.Scale = new Vector2(1 + (float)progress.NewValue * 0.2f);
             }
 

From c38e97c9ecb390496c576ab815911a87d17c1a04 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 6 May 2022 14:43:24 +0900
Subject: [PATCH 4571/5547] Add full xmldoc to `HoldToConfirmContainer`

---
 .../Containers/HoldToConfirmContainer.cs      | 35 +++++++++++++++----
 1 file changed, 29 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Graphics/Containers/HoldToConfirmContainer.cs b/osu.Game/Graphics/Containers/HoldToConfirmContainer.cs
index 540f9b97a7..28afd082c3 100644
--- a/osu.Game/Graphics/Containers/HoldToConfirmContainer.cs
+++ b/osu.Game/Graphics/Containers/HoldToConfirmContainer.cs
@@ -10,6 +10,16 @@ using osu.Game.Configuration;
 
 namespace osu.Game.Graphics.Containers
 {
+    /// <summary>
+    /// A container which adds a common "hold-to-perform" pattern to a container.
+    /// </summary>
+    /// <remarks>
+    /// This container does not handle triggering the hold/abort operations.
+    /// To use this class, please call <see cref="BeginConfirm"/> and <see cref="AbortConfirm"/> when necessary.
+    ///
+    /// The <see cref="Progress"/> is exposed as a transforming bindable which smoothly tracks the progress of a hold operation.
+    /// It can be used for animating and displaying progress directly.
+    /// </remarks>
     public abstract class HoldToConfirmContainer : Container
     {
         public const double DANGEROUS_HOLD_ACTIVATION_DELAY = 500;
@@ -70,6 +80,12 @@ namespace osu.Game.Graphics.Containers
                 config.BindWith(OsuSetting.UIHoldActivationDelay, holdActivationDelay);
         }
 
+        /// <summary>
+        /// Begin a new confirmation. Should be called when the container is interacted with (ie. the user presses a key).
+        /// </summary>
+        /// <remarks>
+        /// Calling this method when already in the process of confirming has no effect.
+        /// </remarks>
         protected void BeginConfirm()
         {
             if (confirming || (!AllowMultipleFires && Fired)) return;
@@ -79,12 +95,9 @@ namespace osu.Game.Graphics.Containers
             this.TransformBindableTo(progress, 1, holdActivationDelay.Value * (1 - progress.Value), Easing.Out).OnComplete(_ => Confirm());
         }
 
-        protected virtual void Confirm()
-        {
-            Action?.Invoke();
-            Fired = true;
-        }
-
+        /// <summary>
+        /// Abort any ongoing confirmation. Should be called when the container's interaction is no longer valid (ie. the user releases a key).
+        /// </summary>
         protected void AbortConfirm()
         {
             if (!AllowMultipleFires && Fired) return;
@@ -97,5 +110,15 @@ namespace osu.Game.Graphics.Containers
                 .Delay(200)
                 .TransformBindableTo(progress, 0, fadeout_delay, Easing.InSine);
         }
+
+        /// <summary>
+        /// A method which is invoked when the confirmation sequence completes successfully.
+        /// By default, will fire the associated <see cref="Action"/>.
+        /// </summary>
+        protected virtual void Confirm()
+        {
+            Action?.Invoke();
+            Fired = true;
+        }
     }
 }

From 1c4aa125859d2de65858661b38bc207706a65625 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 6 May 2022 14:44:10 +0900
Subject: [PATCH 4572/5547] Rename non-descript `Button` nested class

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

diff --git a/osu.Game/Screens/Play/HUD/HoldForMenuButton.cs b/osu.Game/Screens/Play/HUD/HoldForMenuButton.cs
index 678c4256b4..e3283062ef 100644
--- a/osu.Game/Screens/Play/HUD/HoldForMenuButton.cs
+++ b/osu.Game/Screens/Play/HUD/HoldForMenuButton.cs
@@ -27,7 +27,7 @@ namespace osu.Game.Screens.Play.HUD
 
         public readonly Bindable<bool> IsPaused = new Bindable<bool>();
 
-        private Button button;
+        private HoldButton button;
 
         public Action Action { get; set; }
 
@@ -53,7 +53,7 @@ namespace osu.Game.Screens.Play.HUD
                     Anchor = Anchor.CentreLeft,
                     Origin = Anchor.CentreLeft
                 },
-                button = new Button(player?.Configuration.AllowRestart == false)
+                button = new HoldButton(player?.Configuration.AllowRestart == false)
                 {
                     HoverGained = () => text.FadeIn(500, Easing.OutQuint),
                     HoverLost = () => text.FadeOut(500, Easing.OutQuint),
@@ -100,7 +100,7 @@ namespace osu.Game.Screens.Play.HUD
             }
         }
 
-        private class Button : HoldToConfirmContainer, IKeyBindingHandler<GlobalAction>
+        private class HoldButton : HoldToConfirmContainer, IKeyBindingHandler<GlobalAction>
         {
             private SpriteIcon icon;
             private CircularProgress circularProgress;
@@ -113,7 +113,7 @@ namespace osu.Game.Screens.Play.HUD
             public Action HoverGained;
             public Action HoverLost;
 
-            public Button(bool isDangerousAction)
+            public HoldButton(bool isDangerousAction)
                 : base(isDangerousAction)
             {
             }

From 78959a6e05a4cf753dfc59d480b2fdf041296c33 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 6 May 2022 15:01:24 +0900
Subject: [PATCH 4573/5547] Add animation to denote a dangerous player exit

---
 .../Screens/Play/HUD/HoldForMenuButton.cs     | 39 ++++++++++++++++++-
 1 file changed, 37 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/Play/HUD/HoldForMenuButton.cs b/osu.Game/Screens/Play/HUD/HoldForMenuButton.cs
index e3283062ef..f892ea1049 100644
--- a/osu.Game/Screens/Play/HUD/HoldForMenuButton.cs
+++ b/osu.Game/Screens/Play/HUD/HoldForMenuButton.cs
@@ -12,12 +12,14 @@ using osu.Framework.Graphics.Sprites;
 using osu.Framework.Graphics.UserInterface;
 using osu.Framework.Input.Bindings;
 using osu.Framework.Input.Events;
+using osu.Framework.Threading;
 using osu.Framework.Utils;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Input.Bindings;
 using osuTK;
+using osuTK.Graphics;
 
 namespace osu.Game.Screens.Play.HUD
 {
@@ -113,6 +115,11 @@ namespace osu.Game.Screens.Play.HUD
             public Action HoverGained;
             public Action HoverLost;
 
+            private const double shake_duration = 20;
+
+            private bool pendingAnimation;
+            private ScheduledDelegate shakeOperation;
+
             public HoldButton(bool isDangerousAction)
                 : base(isDangerousAction)
             {
@@ -165,10 +172,38 @@ namespace osu.Game.Screens.Play.HUD
             private void bind()
             {
                 ((IBindable<double>)circularProgress.Current).BindTo(Progress);
-                Progress.ValueChanged += progress => icon.Scale = new Vector2(1 + (float)progress.NewValue * 0.2f);
+                Progress.ValueChanged += progress =>
+                {
+                    icon.Scale = new Vector2(1 + (float)progress.NewValue * 0.2f);
+
+                    if (IsDangerousAction)
+                    {
+                        //Child.Scale = new Vector2(1 + (float)progress.NewValue);
+                        Colour = Interpolation.ValueAt(progress.NewValue, Color4.White, Color4.Red, 0, 1, Easing.OutQuint);
+
+                        if (progress.NewValue > 0 && progress.NewValue < 1)
+                        {
+                            shakeOperation ??= Scheduler.AddDelayed(shake, shake_duration, true);
+                        }
+                        else
+                        {
+                            Child.MoveTo(Vector2.Zero, shake_duration * 2, Easing.OutQuint);
+                            shakeOperation?.Cancel();
+                            shakeOperation = null;
+                        }
+                    }
+                };
             }
 
-            private bool pendingAnimation;
+            private void shake()
+            {
+                const float shake_magnitude = 8;
+
+                Child.MoveTo(new Vector2(
+                    RNG.NextSingle(-1, 1) * (float)Progress.Value * shake_magnitude,
+                    RNG.NextSingle(-1, 1) * (float)Progress.Value * shake_magnitude
+                ), shake_duration);
+            }
 
             protected override void Confirm()
             {

From 060461a431a3fe99a46786b652cba234933fbc85 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 6 May 2022 15:22:22 +0900
Subject: [PATCH 4574/5547] Add test coverage of multiplayer gameplay exit flow

---
 .../Multiplayer/TestSceneMultiplayer.cs       | 42 +++++++++++++++++++
 1 file changed, 42 insertions(+)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
index 6a69917fb4..8e45d99eae 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
@@ -7,6 +7,7 @@ using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
+using osu.Framework.Bindables;
 using osu.Framework.Extensions;
 using osu.Framework.Extensions.ObjectExtensions;
 using osu.Framework.Graphics.Containers;
@@ -17,6 +18,7 @@ using osu.Framework.Screens;
 using osu.Framework.Testing;
 using osu.Framework.Utils;
 using osu.Game.Beatmaps;
+using osu.Game.Configuration;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests.Responses;
@@ -56,6 +58,9 @@ namespace osu.Game.Tests.Visual.Multiplayer
         private TestMultiplayerClient multiplayerClient => multiplayerComponents.MultiplayerClient;
         private TestMultiplayerRoomManager roomManager => multiplayerComponents.RoomManager;
 
+        [Resolved]
+        private OsuConfigManager config { get; set; }
+
         [BackgroundDependencyLoader]
         private void load(GameHost host, AudioManager audio)
         {
@@ -668,6 +673,43 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddUntilStep("wait for results", () => multiplayerComponents.CurrentScreen is ResultsScreen);
         }
 
+        [Test]
+        public void TestGameplayExitFlow()
+        {
+            Bindable<double> holdDelay = null;
+
+            AddStep("Set hold delay to zero", () =>
+            {
+                holdDelay = config.GetBindable<double>(OsuSetting.UIHoldActivationDelay);
+                holdDelay.Value = 0;
+            });
+
+            createRoom(() => new Room
+            {
+                Name = { Value = "Test Room" },
+                Playlist =
+                {
+                    new PlaylistItem(beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First(b => b.Ruleset.OnlineID == 0)).BeatmapInfo)
+                    {
+                        RulesetID = new OsuRuleset().RulesetInfo.OnlineID,
+                    }
+                }
+            });
+
+            enterGameplay();
+
+            AddUntilStep("wait for playing", () => this.ChildrenOfType<Player>().FirstOrDefault()?.LocalUserPlaying.Value == true);
+
+            AddStep("attempt exit without hold", () => InputManager.Key(Key.Escape));
+            AddAssert("still in gameplay", () => multiplayerComponents.CurrentScreen is Player);
+
+            AddStep("attempt exit with hold", () => InputManager.PressKey(Key.Escape));
+            AddUntilStep("wait for lounge", () => multiplayerComponents.CurrentScreen is Screens.OnlinePlay.Multiplayer.Multiplayer);
+
+            AddStep("stop holding", () => InputManager.ReleaseKey(Key.Escape));
+            AddStep("set hold delay to default", () => holdDelay.SetDefault());
+        }
+
         [Test]
         public void TestGameplayDoesntStartWithNonLoadedUser()
         {

From 32b40bdabfaa99f6c01ecf22a07c222b064103cd Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 6 May 2022 15:45:36 +0900
Subject: [PATCH 4575/5547] Rename `DistanceBetweenTick` to be plural

---
 .../Visual/Editing/TestSceneDistanceSnapGrid.cs    | 14 +++++++-------
 .../Compose/Components/CircularDistanceSnapGrid.cs | 10 +++++-----
 .../Edit/Compose/Components/DistanceSnapGrid.cs    |  8 ++++----
 3 files changed, 16 insertions(+), 16 deletions(-)

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneDistanceSnapGrid.cs b/osu.Game.Tests/Visual/Editing/TestSceneDistanceSnapGrid.cs
index 7d8089b435..9148965987 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneDistanceSnapGrid.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneDistanceSnapGrid.cs
@@ -79,7 +79,7 @@ namespace osu.Game.Tests.Visual.Editing
         public void TestDistanceSpacing(double multiplier)
         {
             AddStep($"set distance spacing = {multiplier}", () => snapProvider.DistanceSpacingMultiplier.Value = multiplier);
-            AddAssert("distance spacing matches multiplier", () => grid.DistanceBetweenTick == beat_snap_distance * multiplier);
+            AddAssert("distance spacing matches multiplier", () => grid.DistanceBetweenTicks == beat_snap_distance * multiplier);
         }
 
         [TestCase(1.0)]
@@ -103,12 +103,12 @@ namespace osu.Game.Tests.Visual.Editing
             });
 
             AddStep($"set distance spacing = {multiplier}", () => snapProvider.DistanceSpacingMultiplier.Value = multiplier);
-            AddAssert("check correct interval count", () => grid.MaxIntervals == (end_time / grid.DistanceBetweenTick));
+            AddAssert("check correct interval count", () => grid.MaxIntervals == (end_time / grid.DistanceBetweenTicks));
         }
 
         private class TestDistanceSnapGrid : DistanceSnapGrid
         {
-            public new float DistanceBetweenTick => base.DistanceBetweenTick;
+            public new float DistanceBetweenTicks => base.DistanceBetweenTicks;
 
             public new int MaxIntervals => base.MaxIntervals;
 
@@ -128,7 +128,7 @@ namespace osu.Game.Tests.Visual.Editing
 
                 int indexFromPlacement = 0;
 
-                for (float s = StartPosition.X + DistanceBetweenTick; s <= DrawWidth && indexFromPlacement < MaxIntervals; s += DistanceBetweenTick, indexFromPlacement++)
+                for (float s = StartPosition.X + DistanceBetweenTicks; s <= DrawWidth && indexFromPlacement < MaxIntervals; s += DistanceBetweenTicks, indexFromPlacement++)
                 {
                     AddInternal(new Circle
                     {
@@ -141,7 +141,7 @@ namespace osu.Game.Tests.Visual.Editing
 
                 indexFromPlacement = 0;
 
-                for (float s = StartPosition.X - DistanceBetweenTick; s >= 0 && indexFromPlacement < MaxIntervals; s -= DistanceBetweenTick, indexFromPlacement++)
+                for (float s = StartPosition.X - DistanceBetweenTicks; s >= 0 && indexFromPlacement < MaxIntervals; s -= DistanceBetweenTicks, indexFromPlacement++)
                 {
                     AddInternal(new Circle
                     {
@@ -154,7 +154,7 @@ namespace osu.Game.Tests.Visual.Editing
 
                 indexFromPlacement = 0;
 
-                for (float s = StartPosition.Y + DistanceBetweenTick; s <= DrawHeight && indexFromPlacement < MaxIntervals; s += DistanceBetweenTick, indexFromPlacement++)
+                for (float s = StartPosition.Y + DistanceBetweenTicks; s <= DrawHeight && indexFromPlacement < MaxIntervals; s += DistanceBetweenTicks, indexFromPlacement++)
                 {
                     AddInternal(new Circle
                     {
@@ -167,7 +167,7 @@ namespace osu.Game.Tests.Visual.Editing
 
                 indexFromPlacement = 0;
 
-                for (float s = StartPosition.Y - DistanceBetweenTick; s >= 0 && indexFromPlacement < MaxIntervals; s -= DistanceBetweenTick, indexFromPlacement++)
+                for (float s = StartPosition.Y - DistanceBetweenTicks; s >= 0 && indexFromPlacement < MaxIntervals; s -= DistanceBetweenTicks, indexFromPlacement++)
                 {
                     AddInternal(new Circle
                     {
diff --git a/osu.Game/Screens/Edit/Compose/Components/CircularDistanceSnapGrid.cs b/osu.Game/Screens/Edit/Compose/Components/CircularDistanceSnapGrid.cs
index 2873d74f75..ee8ca80c01 100644
--- a/osu.Game/Screens/Edit/Compose/Components/CircularDistanceSnapGrid.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/CircularDistanceSnapGrid.cs
@@ -30,14 +30,14 @@ namespace osu.Game.Screens.Edit.Compose.Components
                     Position = StartPosition,
                     Width = crosshair_thickness,
                     EdgeSmoothness = new Vector2(1),
-                    Height = Math.Min(crosshair_max_size, DistanceBetweenTick * 2),
+                    Height = Math.Min(crosshair_max_size, DistanceBetweenTicks * 2),
                 },
                 new Box
                 {
                     Origin = Anchor.Centre,
                     Position = StartPosition,
                     EdgeSmoothness = new Vector2(1),
-                    Width = Math.Min(crosshair_max_size, DistanceBetweenTick * 2),
+                    Width = Math.Min(crosshair_max_size, DistanceBetweenTicks * 2),
                     Height = crosshair_thickness,
                 }
             });
@@ -45,11 +45,11 @@ namespace osu.Game.Screens.Edit.Compose.Components
             float dx = Math.Max(StartPosition.X, DrawWidth - StartPosition.X);
             float dy = Math.Max(StartPosition.Y, DrawHeight - StartPosition.Y);
             float maxDistance = new Vector2(dx, dy).Length;
-            int requiredCircles = Math.Min(MaxIntervals, (int)(maxDistance / DistanceBetweenTick));
+            int requiredCircles = Math.Min(MaxIntervals, (int)(maxDistance / DistanceBetweenTicks));
 
             for (int i = 0; i < requiredCircles; i++)
             {
-                float radius = (i + 1) * DistanceBetweenTick * 2;
+                float radius = (i + 1) * DistanceBetweenTicks * 2;
 
                 AddInternal(new CircularProgress
                 {
@@ -80,7 +80,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
             float travelLength = travelVector.Length;
 
             // FindSnappedDistance will always round down, but we want to potentially round upwards.
-            travelLength += DistanceBetweenTick / 2;
+            travelLength += DistanceBetweenTicks / 2;
 
             // When interacting with the resolved snap provider, the distance spacing multiplier should first be removed
             // to allow for snapping at a non-multiplied ratio.
diff --git a/osu.Game/Screens/Edit/Compose/Components/DistanceSnapGrid.cs b/osu.Game/Screens/Edit/Compose/Components/DistanceSnapGrid.cs
index b9e0cfef19..742fbc99ca 100644
--- a/osu.Game/Screens/Edit/Compose/Components/DistanceSnapGrid.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/DistanceSnapGrid.cs
@@ -23,7 +23,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
         /// <summary>
         /// The spacing between each tick of the beat snapping grid.
         /// </summary>
-        protected float DistanceBetweenTick { get; private set; }
+        protected float DistanceBetweenTicks { get; private set; }
 
         protected IBindable<double> DistanceSpacingMultiplier { get; private set; }
 
@@ -34,7 +34,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
 
         /// <summary>
         /// The position which the grid should start.
-        /// The first beat snapping tick is located at <see cref="StartPosition"/> + <see cref="DistanceBetweenTick"/> away from this point.
+        /// The first beat snapping tick is located at <see cref="StartPosition"/> + <see cref="DistanceBetweenTicks"/> away from this point.
         /// </summary>
         protected readonly Vector2 StartPosition;
 
@@ -93,7 +93,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
 
         private void updateSpacing()
         {
-            DistanceBetweenTick = (float)(SnapProvider.GetBeatSnapDistanceAt(ReferenceObject) * DistanceSpacingMultiplier.Value);
+            DistanceBetweenTicks = (float)(SnapProvider.GetBeatSnapDistanceAt(ReferenceObject) * DistanceSpacingMultiplier.Value);
 
             if (LatestEndTime == null)
                 MaxIntervals = int.MaxValue;
@@ -101,7 +101,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
             {
                 // +1 is added since a snapped hitobject may have its start time slightly less than the snapped time due to floating point errors
                 double maxDuration = LatestEndTime.Value - StartTime + 1;
-                MaxIntervals = (int)(maxDuration / SnapProvider.DistanceToDuration(ReferenceObject, DistanceBetweenTick));
+                MaxIntervals = (int)(maxDuration / SnapProvider.DistanceToDuration(ReferenceObject, DistanceBetweenTicks));
             }
 
             gridCache.Invalidate();

From 246479bf34c725d886742017099f9d509e58b2f7 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 6 May 2022 15:54:37 +0900
Subject: [PATCH 4576/5547] Fix snap extent not working correctly on sliders
 (and providing incorrect time values)

---
 .../Edit/Compose/Components/CircularDistanceSnapGrid.cs        | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Edit/Compose/Components/CircularDistanceSnapGrid.cs b/osu.Game/Screens/Edit/Compose/Components/CircularDistanceSnapGrid.cs
index ee8ca80c01..ffa4176a48 100644
--- a/osu.Game/Screens/Edit/Compose/Components/CircularDistanceSnapGrid.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/CircularDistanceSnapGrid.cs
@@ -89,7 +89,8 @@ namespace osu.Game.Screens.Edit.Compose.Components
 
             if (snappedTime > LatestEndTime)
             {
-                snappedDistance = SnapProvider.DurationToDistance(ReferenceObject, LatestEndTime.Value - ReferenceObject.StartTime);
+                snappedDistance = SnapProvider.DurationToDistance(ReferenceObject, LatestEndTime.Value - ReferenceObject.GetEndTime());
+                snappedTime = StartTime + SnapProvider.DistanceToDuration(ReferenceObject, snappedDistance);
             }
 
             // The multiplier can then be reapplied to the final position.

From f39fcee41bae044337bca75e5619f88772b50a51 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 6 May 2022 10:04:00 +0200
Subject: [PATCH 4577/5547] Remove commented-out code

---
 osu.Game/Screens/Play/HUD/HoldForMenuButton.cs | 1 -
 1 file changed, 1 deletion(-)

diff --git a/osu.Game/Screens/Play/HUD/HoldForMenuButton.cs b/osu.Game/Screens/Play/HUD/HoldForMenuButton.cs
index f892ea1049..8ed7260aac 100644
--- a/osu.Game/Screens/Play/HUD/HoldForMenuButton.cs
+++ b/osu.Game/Screens/Play/HUD/HoldForMenuButton.cs
@@ -178,7 +178,6 @@ namespace osu.Game.Screens.Play.HUD
 
                     if (IsDangerousAction)
                     {
-                        //Child.Scale = new Vector2(1 + (float)progress.NewValue);
                         Colour = Interpolation.ValueAt(progress.NewValue, Color4.White, Color4.Red, 0, 1, Easing.OutQuint);
 
                         if (progress.NewValue > 0 && progress.NewValue < 1)

From f5026bbbeb579dfe72325fbbab92647ceafcafd8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 6 May 2022 10:04:36 +0200
Subject: [PATCH 4578/5547] Bind to button's activation delay directly

---
 osu.Game/Screens/Play/HUD/HoldForMenuButton.cs | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/osu.Game/Screens/Play/HUD/HoldForMenuButton.cs b/osu.Game/Screens/Play/HUD/HoldForMenuButton.cs
index 8ed7260aac..2ba76d0896 100644
--- a/osu.Game/Screens/Play/HUD/HoldForMenuButton.cs
+++ b/osu.Game/Screens/Play/HUD/HoldForMenuButton.cs
@@ -35,8 +35,6 @@ namespace osu.Game.Screens.Play.HUD
 
         private OsuSpriteText text;
 
-        private readonly Bindable<double> activationDelay = new Bindable<double>();
-
         public HoldForMenuButton()
         {
             Direction = FillDirection.Horizontal;
@@ -68,7 +66,7 @@ namespace osu.Game.Screens.Play.HUD
 
         protected override void LoadComplete()
         {
-            activationDelay.BindValueChanged(v =>
+            button.HoldActivationDelay.BindValueChanged(v =>
             {
                 text.Text = v.NewValue > 0
                     ? "hold for menu"

From c7e7aa5962c12cda3e74b161e0f4b30130b5a026 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 6 May 2022 17:05:52 +0900
Subject: [PATCH 4579/5547] Don't draw distance snap grid on the start time of
 the next object

---
 osu.Game.Rulesets.Osu/Edit/OsuDistanceSnapGrid.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu/Edit/OsuDistanceSnapGrid.cs b/osu.Game.Rulesets.Osu/Edit/OsuDistanceSnapGrid.cs
index 8a561f962a..b11929c1e8 100644
--- a/osu.Game.Rulesets.Osu/Edit/OsuDistanceSnapGrid.cs
+++ b/osu.Game.Rulesets.Osu/Edit/OsuDistanceSnapGrid.cs
@@ -11,7 +11,7 @@ namespace osu.Game.Rulesets.Osu.Edit
     public class OsuDistanceSnapGrid : CircularDistanceSnapGrid
     {
         public OsuDistanceSnapGrid(OsuHitObject hitObject, [CanBeNull] OsuHitObject nextHitObject = null)
-            : base(hitObject, hitObject.StackedEndPosition, hitObject.GetEndTime(), nextHitObject?.StartTime)
+            : base(hitObject, hitObject.StackedEndPosition, hitObject.GetEndTime(), nextHitObject?.StartTime - 1)
         {
             Masking = true;
         }

From 684fef7f8cf813f616b96cb0c3abfe009ccf40d5 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 6 May 2022 17:09:02 +0900
Subject: [PATCH 4580/5547] Fix `MaxIntervals` incorrectly factoring distance
 spacing multipiler into snap calculation

---
 .../Edit/Compose/Components/DistanceSnapGrid.cs   | 15 +++++++--------
 1 file changed, 7 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Screens/Edit/Compose/Components/DistanceSnapGrid.cs b/osu.Game/Screens/Edit/Compose/Components/DistanceSnapGrid.cs
index 742fbc99ca..2f39db06d4 100644
--- a/osu.Game/Screens/Edit/Compose/Components/DistanceSnapGrid.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/DistanceSnapGrid.cs
@@ -52,7 +52,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
         protected IDistanceSnapProvider SnapProvider { get; private set; }
 
         [Resolved]
-        private EditorBeatmap beatmap { get; set; }
+        protected EditorBeatmap Beatmap { get; private set; }
 
         [Resolved]
         private BindableBeatDivisor beatDivisor { get; set; }
@@ -93,16 +93,15 @@ namespace osu.Game.Screens.Edit.Compose.Components
 
         private void updateSpacing()
         {
-            DistanceBetweenTicks = (float)(SnapProvider.GetBeatSnapDistanceAt(ReferenceObject) * DistanceSpacingMultiplier.Value);
+            float distanceSpacingMultiplier = (float)DistanceSpacingMultiplier.Value;
+            float beatSnapDistance = SnapProvider.GetBeatSnapDistanceAt(ReferenceObject);
+
+            DistanceBetweenTicks = beatSnapDistance * distanceSpacingMultiplier;
 
             if (LatestEndTime == null)
                 MaxIntervals = int.MaxValue;
             else
-            {
-                // +1 is added since a snapped hitobject may have its start time slightly less than the snapped time due to floating point errors
-                double maxDuration = LatestEndTime.Value - StartTime + 1;
-                MaxIntervals = (int)(maxDuration / SnapProvider.DistanceToDuration(ReferenceObject, DistanceBetweenTicks));
-            }
+                MaxIntervals = (int)((LatestEndTime.Value - StartTime) / SnapProvider.DistanceToDuration(ReferenceObject, beatSnapDistance));
 
             gridCache.Invalidate();
         }
@@ -138,7 +137,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
         /// <returns>The applicable colour.</returns>
         protected ColourInfo GetColourForIndexFromPlacement(int placementIndex)
         {
-            var timingPoint = beatmap.ControlPointInfo.TimingPointAt(StartTime);
+            var timingPoint = Beatmap.ControlPointInfo.TimingPointAt(StartTime);
             double beatLength = timingPoint.BeatLength / beatDivisor.Value;
             int beatIndex = (int)Math.Round((StartTime - timingPoint.Time) / beatLength);
 

From 37cbc792834b9128ae2dfdcb8deba7abe6129766 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 6 May 2022 17:09:38 +0900
Subject: [PATCH 4581/5547] Fix clamping logic to always clamp to the last
 displayed tick

---
 .../Compose/Components/CircularDistanceSnapGrid.cs     | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Screens/Edit/Compose/Components/CircularDistanceSnapGrid.cs b/osu.Game/Screens/Edit/Compose/Components/CircularDistanceSnapGrid.cs
index ffa4176a48..13d838234e 100644
--- a/osu.Game/Screens/Edit/Compose/Components/CircularDistanceSnapGrid.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/CircularDistanceSnapGrid.cs
@@ -70,7 +70,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
 
             // This grid implementation factors in the user's distance spacing specification,
             // which is usually not considered by an `IDistanceSnapProvider`.
-            float distanceSpacing = (float)DistanceSpacingMultiplier.Value;
+            float distanceSpacingMultiplier = (float)DistanceSpacingMultiplier.Value;
 
             Vector2 travelVector = (position - StartPosition);
 
@@ -84,17 +84,19 @@ namespace osu.Game.Screens.Edit.Compose.Components
 
             // When interacting with the resolved snap provider, the distance spacing multiplier should first be removed
             // to allow for snapping at a non-multiplied ratio.
-            float snappedDistance = SnapProvider.FindSnappedDistance(ReferenceObject, travelLength / distanceSpacing);
+            float snappedDistance = SnapProvider.FindSnappedDistance(ReferenceObject, travelLength / distanceSpacingMultiplier);
             double snappedTime = StartTime + SnapProvider.DistanceToDuration(ReferenceObject, snappedDistance);
 
             if (snappedTime > LatestEndTime)
             {
-                snappedDistance = SnapProvider.DurationToDistance(ReferenceObject, LatestEndTime.Value - ReferenceObject.GetEndTime());
+                double tickLength = Beatmap.GetBeatLengthAtTime(StartTime);
+
+                snappedDistance = SnapProvider.DurationToDistance(ReferenceObject, MaxIntervals * tickLength);
                 snappedTime = StartTime + SnapProvider.DistanceToDuration(ReferenceObject, snappedDistance);
             }
 
             // The multiplier can then be reapplied to the final position.
-            Vector2 snappedPosition = StartPosition + travelVector.Normalized() * snappedDistance * distanceSpacing;
+            Vector2 snappedPosition = StartPosition + travelVector.Normalized() * snappedDistance * distanceSpacingMultiplier;
 
             return (snappedPosition, snappedTime);
         }

From 319867f73c968d9238ac319c05ed03fe38fa3076 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 6 May 2022 17:32:55 +0900
Subject: [PATCH 4582/5547] Mark `GuestUser` as system user via `Id` for now

Should resolve https://github.com/ppy/osu/issues/18105.

Checking through usages, it doesn't immediately look like this will
regress any other scenarios.
---
 osu.Game/Online/API/APIAccess.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Online/API/APIAccess.cs b/osu.Game/Online/API/APIAccess.cs
index 8c9741b98b..62ddd49881 100644
--- a/osu.Game/Online/API/APIAccess.cs
+++ b/osu.Game/Online/API/APIAccess.cs
@@ -458,7 +458,7 @@ namespace osu.Game.Online.API
         public GuestUser()
         {
             Username = @"Guest";
-            Id = 1;
+            Id = SYSTEM_USER_ID;
         }
     }
 

From 118e58888b77d38a2b202c97ad7fe5ed11ff3ab9 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 6 May 2022 17:51:51 +0900
Subject: [PATCH 4583/5547] Rename incorrectly named variable (radius is not
 diameter)

---
 .../Edit/Compose/Components/CircularDistanceSnapGrid.cs     | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Screens/Edit/Compose/Components/CircularDistanceSnapGrid.cs b/osu.Game/Screens/Edit/Compose/Components/CircularDistanceSnapGrid.cs
index 13d838234e..91fad08aff 100644
--- a/osu.Game/Screens/Edit/Compose/Components/CircularDistanceSnapGrid.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/CircularDistanceSnapGrid.cs
@@ -49,15 +49,15 @@ namespace osu.Game.Screens.Edit.Compose.Components
 
             for (int i = 0; i < requiredCircles; i++)
             {
-                float radius = (i + 1) * DistanceBetweenTicks * 2;
+                float diameter = (i + 1) * DistanceBetweenTicks * 2;
 
                 AddInternal(new CircularProgress
                 {
                     Origin = Anchor.Centre,
                     Position = StartPosition,
                     Current = { Value = 1 },
-                    Size = new Vector2(radius),
-                    InnerRadius = 4 * 1f / radius,
+                    Size = new Vector2(diameter),
+                    InnerRadius = 4 * 1f / diameter,
                     Colour = GetColourForIndexFromPlacement(i)
                 });
             }

From 69592722f80f0869a1ddbe42fbe76564c6252c5e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 6 May 2022 18:25:02 +0900
Subject: [PATCH 4584/5547] Highlight distance snap grid rings that are close
 to the current time value

---
 .../Components/CircularDistanceSnapGrid.cs    | 45 +++++++++++++++++--
 .../Compose/Components/DistanceSnapGrid.cs    |  7 +--
 2 files changed, 45 insertions(+), 7 deletions(-)

diff --git a/osu.Game/Screens/Edit/Compose/Components/CircularDistanceSnapGrid.cs b/osu.Game/Screens/Edit/Compose/Components/CircularDistanceSnapGrid.cs
index 91fad08aff..5682b5563e 100644
--- a/osu.Game/Screens/Edit/Compose/Components/CircularDistanceSnapGrid.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/CircularDistanceSnapGrid.cs
@@ -2,11 +2,15 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
+using osu.Framework.Allocation;
+using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Graphics.UserInterface;
+using osu.Game.Rulesets.Edit;
 using osu.Game.Rulesets.Objects;
 using osuTK;
+using osuTK.Graphics;
 
 namespace osu.Game.Screens.Edit.Compose.Components
 {
@@ -51,14 +55,12 @@ namespace osu.Game.Screens.Edit.Compose.Components
             {
                 float diameter = (i + 1) * DistanceBetweenTicks * 2;
 
-                AddInternal(new CircularProgress
+                AddInternal(new Ring(ReferenceObject, GetColourForIndexFromPlacement(i))
                 {
-                    Origin = Anchor.Centre,
                     Position = StartPosition,
-                    Current = { Value = 1 },
+                    Origin = Anchor.Centre,
                     Size = new Vector2(diameter),
                     InnerRadius = 4 * 1f / diameter,
-                    Colour = GetColourForIndexFromPlacement(i)
                 });
             }
         }
@@ -100,5 +102,40 @@ namespace osu.Game.Screens.Edit.Compose.Components
 
             return (snappedPosition, snappedTime);
         }
+
+        public class Ring : CircularProgress
+        {
+            [Resolved]
+            private IDistanceSnapProvider snapProvider { get; set; }
+
+            [Resolved(canBeNull: true)]
+            private EditorClock editorClock { get; set; }
+
+            private readonly HitObject referenceObject;
+
+            private readonly Color4 baseColour;
+
+            public Ring(HitObject referenceObject, Color4 baseColour)
+            {
+                this.referenceObject = referenceObject;
+
+                Colour = this.baseColour = baseColour;
+
+                Current.Value = 1;
+            }
+
+            protected override void Update()
+            {
+                base.Update();
+
+                if (editorClock == null)
+                    return;
+
+                float distanceForCurrentTime = snapProvider.DurationToDistance(referenceObject, editorClock.CurrentTime - referenceObject.StartTime);
+                float timeBasedAlpha = Math.Clamp(1 - Math.Abs(distanceForCurrentTime - Size.X / 2) / 30, 0, 1);
+
+                Colour = baseColour.Opacity(Math.Max(baseColour.A, timeBasedAlpha));
+            }
+        }
     }
 }
diff --git a/osu.Game/Screens/Edit/Compose/Components/DistanceSnapGrid.cs b/osu.Game/Screens/Edit/Compose/Components/DistanceSnapGrid.cs
index 2f39db06d4..1f64a50c02 100644
--- a/osu.Game/Screens/Edit/Compose/Components/DistanceSnapGrid.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/DistanceSnapGrid.cs
@@ -4,14 +4,15 @@
 using System;
 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.Layout;
 using osu.Game.Graphics;
 using osu.Game.Rulesets.Edit;
 using osu.Game.Rulesets.Objects;
 using osuTK;
+using osuTK.Graphics;
 
 namespace osu.Game.Screens.Edit.Compose.Components
 {
@@ -135,7 +136,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
         /// </summary>
         /// <param name="placementIndex">The 0-based beat index from the point of placement.</param>
         /// <returns>The applicable colour.</returns>
-        protected ColourInfo GetColourForIndexFromPlacement(int placementIndex)
+        protected Color4 GetColourForIndexFromPlacement(int placementIndex)
         {
             var timingPoint = Beatmap.ControlPointInfo.TimingPointAt(StartTime);
             double beatLength = timingPoint.BeatLength / beatDivisor.Value;
@@ -144,7 +145,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
             var colour = BindableBeatDivisor.GetColourFor(BindableBeatDivisor.GetDivisorForBeatIndex(beatIndex + placementIndex + 1, beatDivisor.Value), Colours);
 
             int repeatIndex = placementIndex / beatDivisor.Value;
-            return ColourInfo.SingleColour(colour).MultiplyAlpha(0.5f / (repeatIndex + 1));
+            return colour.Opacity(0.5f / (repeatIndex + 1));
         }
     }
 }

From 8f217d1e975db8ffdf3099e982e9edabb6bc8fe3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 6 May 2022 11:37:50 +0200
Subject: [PATCH 4585/5547] Add failing test case for broken hover behaviour

---
 .../UserInterface/TestSceneModSelectScreen.cs | 26 ++++++++++++++++++-
 1 file changed, 25 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs
index a3ce4b734b..c92a738b56 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs
@@ -18,6 +18,7 @@ using osu.Game.Rulesets;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Osu.Mods;
+using osuTK;
 using osuTK.Input;
 
 namespace osu.Game.Tests.Visual.UserInterface
@@ -164,7 +165,7 @@ namespace osu.Game.Tests.Visual.UserInterface
             AddStep("select mod requiring configuration", () => SelectedMods.Value = new[] { new OsuModDifficultyAdjust() });
             assertCustomisationToggleState(disabled: false, active: true);
 
-            AddStep("dismiss mod customisation via mouse", () =>
+            AddStep("dismiss mod customisation via toggle", () =>
             {
                 InputManager.MoveMouseTo(modSelectScreen.ChildrenOfType<ShearedToggleButton>().Single());
                 InputManager.Click(MouseButton.Left);
@@ -191,6 +192,29 @@ namespace osu.Game.Tests.Visual.UserInterface
             assertCustomisationToggleState(disabled: true, active: false); // config was dismissed without explicit user action.
         }
 
+        [Test]
+        public void TestDismissCustomisationViaDimmedArea()
+        {
+            createScreen();
+            assertCustomisationToggleState(disabled: true, active: false);
+
+            AddStep("select mod requiring configuration", () => SelectedMods.Value = new[] { new OsuModDifficultyAdjust() });
+            assertCustomisationToggleState(disabled: false, active: true);
+
+            AddStep("move mouse to settings area", () => InputManager.MoveMouseTo(this.ChildrenOfType<ModSettingsArea>().Single()));
+            AddStep("move mouse to dimmed area", () =>
+            {
+                InputManager.MoveMouseTo(new Vector2(
+                    modSelectScreen.ScreenSpaceDrawQuad.TopLeft.X,
+                    (modSelectScreen.ScreenSpaceDrawQuad.TopLeft.Y + modSelectScreen.ScreenSpaceDrawQuad.BottomLeft.Y) / 2));
+            });
+            AddStep("click", () => InputManager.Click(MouseButton.Left));
+            assertCustomisationToggleState(disabled: false, active: false);
+
+            AddStep("move mouse to first mod panel", () => InputManager.MoveMouseTo(modSelectScreen.ChildrenOfType<ModPanel>().First()));
+            AddAssert("first mod panel is hovered", () => modSelectScreen.ChildrenOfType<ModPanel>().First().IsHovered);
+        }
+
         /// <summary>
         /// Ensure that two mod overlays are not cross polluting via central settings instances.
         /// </summary>

From daed42513e6476abe183fd6173ce328765970903 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 6 May 2022 18:44:25 +0900
Subject: [PATCH 4586/5547] Fix outdated test asserts

---
 .../Editor/TestSceneOsuDistanceSnapGrid.cs                      | 2 +-
 osu.Game.Tests/Visual/Editing/TestSceneDistanceSnapGrid.cs      | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuDistanceSnapGrid.cs b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuDistanceSnapGrid.cs
index 6d0ed15e45..f6b8f4edc3 100644
--- a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuDistanceSnapGrid.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuDistanceSnapGrid.cs
@@ -160,7 +160,7 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
             });
 
             AddStep("move mouse outside grid", () => InputManager.MoveMouseTo(grid.ToScreenSpace(grid_position + new Vector2(beat_length, 0) * 3f)));
-            assertSnappedDistance(beat_length * 2);
+            assertSnappedDistance(beat_length);
         }
 
         private void assertSnappedDistance(float expectedDistance) => AddAssert($"snap distance = {expectedDistance}", () =>
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneDistanceSnapGrid.cs b/osu.Game.Tests/Visual/Editing/TestSceneDistanceSnapGrid.cs
index 9148965987..3aa3481cbf 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneDistanceSnapGrid.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneDistanceSnapGrid.cs
@@ -103,7 +103,7 @@ namespace osu.Game.Tests.Visual.Editing
             });
 
             AddStep($"set distance spacing = {multiplier}", () => snapProvider.DistanceSpacingMultiplier.Value = multiplier);
-            AddAssert("check correct interval count", () => grid.MaxIntervals == (end_time / grid.DistanceBetweenTicks));
+            AddStep("check correct interval count", () => Assert.That((end_time / grid.DistanceBetweenTicks) * multiplier, Is.EqualTo(grid.MaxIntervals)));
         }
 
         private class TestDistanceSnapGrid : DistanceSnapGrid

From c6bc6be1280dfff8db52757ab51ab8aa9111b28b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 6 May 2022 19:06:40 +0900
Subject: [PATCH 4587/5547] Fix toolbox expand being interrupted by gaps
 between groups

---
 osu.Game/Rulesets/Edit/ExpandingToolboxContainer.cs | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/osu.Game/Rulesets/Edit/ExpandingToolboxContainer.cs b/osu.Game/Rulesets/Edit/ExpandingToolboxContainer.cs
index e807dbd482..c6cc09a16c 100644
--- a/osu.Game/Rulesets/Edit/ExpandingToolboxContainer.cs
+++ b/osu.Game/Rulesets/Edit/ExpandingToolboxContainer.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.Graphics;
 using osu.Framework.Input.Events;
 using osu.Game.Graphics.Containers;
@@ -25,7 +24,7 @@ namespace osu.Game.Rulesets.Edit
 
         public override bool ReceivePositionalInputAt(Vector2 screenSpacePos) => base.ReceivePositionalInputAt(screenSpacePos) && anyToolboxHovered(screenSpacePos);
 
-        private bool anyToolboxHovered(Vector2 screenSpacePos) => FillFlow.Children.Any(d => d.ScreenSpaceDrawQuad.Contains(screenSpacePos));
+        private bool anyToolboxHovered(Vector2 screenSpacePos) => FillFlow.ScreenSpaceDrawQuad.Contains(screenSpacePos);
 
         protected override bool OnMouseDown(MouseDownEvent e) => true;
 

From 08fd0ea086d4e6b7ca0d9d07179493120ecdc47e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 6 May 2022 12:26:09 +0200
Subject: [PATCH 4588/5547] Fix click-to-return container still handling hover
 when inactive

---
 osu.Game/Overlays/Mods/ModSelectScreen.cs | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/osu.Game/Overlays/Mods/ModSelectScreen.cs b/osu.Game/Overlays/Mods/ModSelectScreen.cs
index a7f8a167f9..a1b4d7d8a0 100644
--- a/osu.Game/Overlays/Mods/ModSelectScreen.cs
+++ b/osu.Game/Overlays/Mods/ModSelectScreen.cs
@@ -464,6 +464,8 @@ namespace osu.Game.Overlays.Mods
 
             public Action? OnClicked { get; set; }
 
+            public override bool HandlePositionalInput => base.HandlePositionalInput && HandleMouse.Value;
+
             protected override bool Handle(UIEvent e)
             {
                 if (!HandleMouse.Value)

From 949e30c4b4d85ed4b50e04494fe20fd3f6143ab7 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 6 May 2022 19:36:41 +0900
Subject: [PATCH 4589/5547] Remove auto-expansion of individual toolbox groups
 when parent expanding container expands

---
 osu.Game/Overlays/SettingsToolboxGroup.cs | 54 ++++++++---------------
 1 file changed, 19 insertions(+), 35 deletions(-)

diff --git a/osu.Game/Overlays/SettingsToolboxGroup.cs b/osu.Game/Overlays/SettingsToolboxGroup.cs
index b9e5283a44..ca4864293c 100644
--- a/osu.Game/Overlays/SettingsToolboxGroup.cs
+++ b/osu.Game/Overlays/SettingsToolboxGroup.cs
@@ -135,60 +135,31 @@ namespace osu.Game.Overlays
                 headerText.FadeTo(headerText.DrawWidth < DrawWidth ? 1 : 0, 150, Easing.OutQuint);
         }
 
-        [Resolved(canBeNull: true)]
-        private IExpandingContainer expandingContainer { get; set; }
-
-        private bool expandedByContainer;
-
         protected override void LoadComplete()
         {
             base.LoadComplete();
 
-            expandingContainer?.Expanded.BindValueChanged(containerExpanded =>
-            {
-                if (containerExpanded.NewValue && !Expanded.Value)
-                {
-                    Expanded.Value = true;
-                    expandedByContainer = true;
-                }
-                else if (!containerExpanded.NewValue && expandedByContainer)
-                {
-                    Expanded.Value = false;
-                    expandedByContainer = false;
-                }
-
-                updateActiveState();
-            }, true);
-
             Expanded.BindValueChanged(v =>
             {
                 // clearing transforms can break autosizing, see: https://github.com/ppy/osu-framework/issues/5064
                 if (v.NewValue != v.OldValue)
                     content.ClearTransforms();
 
-                if (v.NewValue)
-                    content.AutoSizeAxes = Axes.Y;
-                else
-                {
-                    content.AutoSizeAxes = Axes.None;
-                    content.ResizeHeightTo(0, transition_duration, Easing.OutQuint);
-                }
-
-                button.FadeColour(Expanded.Value ? expandedColour : Color4.White, 200, Easing.InOutQuint);
+                Scheduler.AddOnce(updateExpandedState);
             }, true);
 
-            this.Delay(600).Schedule(updateActiveState);
+            this.Delay(600).Schedule(updateFadeState);
         }
 
         protected override bool OnHover(HoverEvent e)
         {
-            updateActiveState();
+            updateFadeState();
             return false;
         }
 
         protected override void OnHoverLost(HoverLostEvent e)
         {
-            updateActiveState();
+            updateFadeState();
             base.OnHoverLost(e);
         }
 
@@ -198,9 +169,22 @@ namespace osu.Game.Overlays
             expandedColour = colours.Yellow;
         }
 
-        private void updateActiveState()
+        private void updateExpandedState()
         {
-            this.FadeTo(IsHovered || expandingContainer?.Expanded.Value == true ? 1 : inactive_alpha, fade_duration, Easing.OutQuint);
+            if (Expanded.Value)
+                content.AutoSizeAxes = Axes.Y;
+            else
+            {
+                content.AutoSizeAxes = Axes.None;
+                content.ResizeHeightTo(0, transition_duration, Easing.OutQuint);
+            }
+
+            button.FadeColour(Expanded.Value ? expandedColour : Color4.White, 200, Easing.InOutQuint);
+        }
+
+        private void updateFadeState()
+        {
+            this.FadeTo(IsHovered ? 1 : inactive_alpha, fade_duration, Easing.OutQuint);
         }
 
         protected override Container<Drawable> Content => content;

From 59add66632fcd15cad5b81f0baf99653bdabb483 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 6 May 2022 19:39:00 +0900
Subject: [PATCH 4590/5547] Remove unnecessary autosize workaround (was fixed
 long ago)

---
 osu.Game/Overlays/SettingsToolboxGroup.cs | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/osu.Game/Overlays/SettingsToolboxGroup.cs b/osu.Game/Overlays/SettingsToolboxGroup.cs
index ca4864293c..10a09f3965 100644
--- a/osu.Game/Overlays/SettingsToolboxGroup.cs
+++ b/osu.Game/Overlays/SettingsToolboxGroup.cs
@@ -141,10 +141,6 @@ namespace osu.Game.Overlays
 
             Expanded.BindValueChanged(v =>
             {
-                // clearing transforms can break autosizing, see: https://github.com/ppy/osu-framework/issues/5064
-                if (v.NewValue != v.OldValue)
-                    content.ClearTransforms();
-
                 Scheduler.AddOnce(updateExpandedState);
             }, true);
 

From b432885e5f4b20cee67ab44b3321df1ea954ecca Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 6 May 2022 19:39:09 +0900
Subject: [PATCH 4591/5547] Tidy up ordering of `SettingsToolboxGroup`

---
 osu.Game/Overlays/SettingsToolboxGroup.cs | 47 +++++++++++------------
 1 file changed, 22 insertions(+), 25 deletions(-)

diff --git a/osu.Game/Overlays/SettingsToolboxGroup.cs b/osu.Game/Overlays/SettingsToolboxGroup.cs
index 10a09f3965..eb8c0248e7 100644
--- a/osu.Game/Overlays/SettingsToolboxGroup.cs
+++ b/osu.Game/Overlays/SettingsToolboxGroup.cs
@@ -117,32 +117,17 @@ namespace osu.Game.Overlays
             };
         }
 
-        protected override bool OnInvalidate(Invalidation invalidation, InvalidationSource source)
+        [BackgroundDependencyLoader]
+        private void load(OsuColour colours)
         {
-            if (invalidation.HasFlagFast(Invalidation.DrawSize))
-                headerTextVisibilityCache.Invalidate();
-
-            return base.OnInvalidate(invalidation, source);
-        }
-
-        protected override void Update()
-        {
-            base.Update();
-
-            if (!headerTextVisibilityCache.IsValid)
-                // These toolbox grouped may be contracted to only show icons.
-                // For now, let's hide the header to avoid text truncation weirdness in such cases.
-                headerText.FadeTo(headerText.DrawWidth < DrawWidth ? 1 : 0, 150, Easing.OutQuint);
+            expandedColour = colours.Yellow;
         }
 
         protected override void LoadComplete()
         {
             base.LoadComplete();
 
-            Expanded.BindValueChanged(v =>
-            {
-                Scheduler.AddOnce(updateExpandedState);
-            }, true);
+            Expanded.BindValueChanged(updateExpandedState, true);
 
             this.Delay(600).Schedule(updateFadeState);
         }
@@ -159,15 +144,27 @@ namespace osu.Game.Overlays
             base.OnHoverLost(e);
         }
 
-        [BackgroundDependencyLoader]
-        private void load(OsuColour colours)
+        protected override void Update()
         {
-            expandedColour = colours.Yellow;
+            base.Update();
+
+            if (!headerTextVisibilityCache.IsValid)
+                // These toolbox grouped may be contracted to only show icons.
+                // For now, let's hide the header to avoid text truncation weirdness in such cases.
+                headerText.FadeTo(headerText.DrawWidth < DrawWidth ? 1 : 0, 150, Easing.OutQuint);
         }
 
-        private void updateExpandedState()
+        protected override bool OnInvalidate(Invalidation invalidation, InvalidationSource source)
         {
-            if (Expanded.Value)
+            if (invalidation.HasFlagFast(Invalidation.DrawSize))
+                headerTextVisibilityCache.Invalidate();
+
+            return base.OnInvalidate(invalidation, source);
+        }
+
+        private void updateExpandedState(ValueChangedEvent<bool> expanded)
+        {
+            if (expanded.NewValue)
                 content.AutoSizeAxes = Axes.Y;
             else
             {
@@ -175,7 +172,7 @@ namespace osu.Game.Overlays
                 content.ResizeHeightTo(0, transition_duration, Easing.OutQuint);
             }
 
-            button.FadeColour(Expanded.Value ? expandedColour : Color4.White, 200, Easing.InOutQuint);
+            button.FadeColour(expanded.NewValue ? expandedColour : Color4.White, 200, Easing.InOutQuint);
         }
 
         private void updateFadeState()

From 88c190f3e359f9cb3bf9449dba97d19af0de7329 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 6 May 2022 19:45:14 +0900
Subject: [PATCH 4592/5547] Change colour denoting expanded state to be gray
 rather than yellow

I always found the yellow colour very non-descript in this case. Gray
seems to work better?
---
 osu.Game/Overlays/SettingsToolboxGroup.cs | 14 ++++----------
 1 file changed, 4 insertions(+), 10 deletions(-)

diff --git a/osu.Game/Overlays/SettingsToolboxGroup.cs b/osu.Game/Overlays/SettingsToolboxGroup.cs
index eb8c0248e7..fd81d092c9 100644
--- a/osu.Game/Overlays/SettingsToolboxGroup.cs
+++ b/osu.Game/Overlays/SettingsToolboxGroup.cs
@@ -39,10 +39,10 @@ namespace osu.Game.Overlays
 
         public BindableBool Expanded { get; } = new BindableBool(true);
 
-        private Color4 expandedColour;
-
         private readonly OsuSpriteText headerText;
 
+        private readonly Container headerContent;
+
         /// <summary>
         /// Create a new instance.
         /// </summary>
@@ -71,7 +71,7 @@ namespace osu.Game.Overlays
                     AutoSizeAxes = Axes.Y,
                     Children = new Drawable[]
                     {
-                        new Container
+                        headerContent = new Container
                         {
                             Name = @"Header",
                             Origin = Anchor.TopCentre,
@@ -117,12 +117,6 @@ namespace osu.Game.Overlays
             };
         }
 
-        [BackgroundDependencyLoader]
-        private void load(OsuColour colours)
-        {
-            expandedColour = colours.Yellow;
-        }
-
         protected override void LoadComplete()
         {
             base.LoadComplete();
@@ -172,7 +166,7 @@ namespace osu.Game.Overlays
                 content.ResizeHeightTo(0, transition_duration, Easing.OutQuint);
             }
 
-            button.FadeColour(expanded.NewValue ? expandedColour : Color4.White, 200, Easing.InOutQuint);
+            headerContent.FadeColour(expanded.NewValue ? Color4.White : OsuColour.Gray(0.5f), 200, Easing.OutQuint);
         }
 
         private void updateFadeState()

From a915b7333c8935ce0c643431824806059d494cd3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 6 May 2022 13:08:54 +0200
Subject: [PATCH 4593/5547] Remove unused using directive

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

diff --git a/osu.Game/Overlays/SettingsToolboxGroup.cs b/osu.Game/Overlays/SettingsToolboxGroup.cs
index fd81d092c9..f9cfd8ff2a 100644
--- a/osu.Game/Overlays/SettingsToolboxGroup.cs
+++ b/osu.Game/Overlays/SettingsToolboxGroup.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.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Caching;
 using osu.Framework.Extensions.EnumExtensions;

From e9d52aa9547f0df158310fac9bf7a632232d34fc Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 6 May 2022 13:09:37 +0200
Subject: [PATCH 4594/5547] Remove not-accessed field

---
 osu.Game/Overlays/SettingsToolboxGroup.cs | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/osu.Game/Overlays/SettingsToolboxGroup.cs b/osu.Game/Overlays/SettingsToolboxGroup.cs
index f9cfd8ff2a..808d4fc422 100644
--- a/osu.Game/Overlays/SettingsToolboxGroup.cs
+++ b/osu.Game/Overlays/SettingsToolboxGroup.cs
@@ -34,7 +34,6 @@ namespace osu.Game.Overlays
         private readonly Cached headerTextVisibilityCache = new Cached();
 
         private readonly FillFlowContainer content;
-        private readonly IconButton button;
 
         public BindableBool Expanded { get; } = new BindableBool(true);
 
@@ -87,7 +86,7 @@ namespace osu.Game.Overlays
                                     Font = OsuFont.GetFont(weight: FontWeight.Bold, size: 17),
                                     Padding = new MarginPadding { Left = 10, Right = 30 },
                                 },
-                                button = new IconButton
+                                new IconButton
                                 {
                                     Origin = Anchor.Centre,
                                     Anchor = Anchor.CentreRight,

From fad1f727bb26954f75a8eeea25ff333107f3325a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 6 May 2022 20:34:44 +0900
Subject: [PATCH 4595/5547] Fix editor drag box visuals

---
 .../Edit/Compose/Components/DragBox.cs        | 85 ++++++++++++++++---
 1 file changed, 73 insertions(+), 12 deletions(-)

diff --git a/osu.Game/Screens/Edit/Compose/Components/DragBox.cs b/osu.Game/Screens/Edit/Compose/Components/DragBox.cs
index eaee2cd1e2..a256adbe4a 100644
--- a/osu.Game/Screens/Edit/Compose/Components/DragBox.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/DragBox.cs
@@ -9,7 +9,8 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Primitives;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Input.Events;
-using osuTK.Graphics;
+using osu.Framework.Layout;
+using osuTK;
 
 namespace osu.Game.Screens.Edit.Compose.Components
 {
@@ -41,17 +42,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
             InternalChild = Box = CreateBox();
         }
 
-        protected virtual Drawable CreateBox() => new Container
-        {
-            Masking = true,
-            BorderColour = Color4.White,
-            BorderThickness = SelectionBox.BORDER_RADIUS,
-            Child = new Box
-            {
-                RelativeSizeAxes = Axes.Both,
-                Alpha = 0.1f
-            }
-        };
+        protected virtual Drawable CreateBox() => new BoxWithBorders();
 
         private RectangleF? dragRectangle;
 
@@ -111,5 +102,75 @@ namespace osu.Game.Screens.Edit.Compose.Components
         public override void Show() => State = Visibility.Visible;
 
         public event Action<Visibility> StateChanged;
+
+        public class BoxWithBorders : CompositeDrawable
+        {
+            private readonly LayoutValue cache = new LayoutValue(Invalidation.RequiredParentSizeToFit);
+
+            public BoxWithBorders()
+            {
+                AddLayout(cache);
+            }
+
+            protected override void Update()
+            {
+                base.Update();
+
+                if (!cache.IsValid)
+                {
+                    createContent();
+                    cache.Validate();
+                }
+            }
+
+            private void createContent()
+            {
+                if (DrawSize == Vector2.Zero)
+                {
+                    ClearInternal();
+                    return;
+                }
+
+                // Make lines the same width independent of display resolution.
+                float lineThickness = DrawWidth > 0
+                    ? DrawWidth / ScreenSpaceDrawQuad.Width * 2
+                    : DrawHeight / ScreenSpaceDrawQuad.Height * 2;
+
+                Padding = new MarginPadding(-lineThickness);
+
+                InternalChildren = new Drawable[]
+                {
+                    new Box
+                    {
+                        RelativeSizeAxes = Axes.X,
+                        Height = lineThickness,
+                    },
+                    new Box
+                    {
+                        RelativeSizeAxes = Axes.X,
+                        Height = lineThickness,
+                        Anchor = Anchor.BottomRight,
+                        Origin = Anchor.BottomRight,
+                    },
+                    new Box
+                    {
+                        RelativeSizeAxes = Axes.Y,
+                        Width = lineThickness,
+                    },
+                    new Box
+                    {
+                        RelativeSizeAxes = Axes.Y,
+                        Width = lineThickness,
+                        Anchor = Anchor.BottomRight,
+                        Origin = Anchor.BottomRight,
+                    },
+                    new Box
+                    {
+                        RelativeSizeAxes = Axes.Both,
+                        Alpha = 0.1f
+                    }
+                };
+            }
+        }
     }
 }

From 19297375e270839c443bfd3165b79c641f692de9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 6 May 2022 13:44:04 +0200
Subject: [PATCH 4596/5547] Update tests to reflect new expected behaviour

---
 .../Visual/UserInterface/TestSceneExpandingContainer.cs     | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneExpandingContainer.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneExpandingContainer.cs
index 288c0cb140..2bb6e58448 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneExpandingContainer.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneExpandingContainer.cs
@@ -99,15 +99,15 @@ namespace osu.Game.Tests.Visual.UserInterface
         }
 
         /// <summary>
-        /// Tests expanding a container will expand underlying groups if contracted.
+        /// Tests expanding a container will not expand underlying groups if they were manually contracted by the user.
         /// </summary>
         [Test]
-        public void TestExpandingContainerExpandsContractedGroup()
+        public void TestExpandingContainerDoesNotExpandContractedGroup()
         {
             AddStep("contract group", () => toolboxGroup.Expanded.Value = false);
 
             AddStep("expand container", () => container.Expanded.Value = true);
-            AddAssert("group expanded", () => toolboxGroup.Expanded.Value);
+            AddAssert("group not expanded", () => !toolboxGroup.Expanded.Value);
             AddAssert("controls expanded", () => slider1.Expanded.Value && slider2.Expanded.Value);
 
             AddStep("contract container", () => container.Expanded.Value = false);

From b119726b289334df0666c15709a99245b2c0a28d Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 6 May 2022 15:36:52 +0300
Subject: [PATCH 4597/5547] Reword test step

---
 .../Editor/TestSceneOsuDistanceSnapGrid.cs                      | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuDistanceSnapGrid.cs b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuDistanceSnapGrid.cs
index f6b8f4edc3..3c3c5cb939 100644
--- a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuDistanceSnapGrid.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuDistanceSnapGrid.cs
@@ -106,7 +106,7 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
         [TestCase(0.5f)]
         public void TestDistanceSpacing(float multiplier)
         {
-            AddStep($"set beat divisor = {multiplier}", () => snapProvider.DistanceSpacingMultiplier.Value = multiplier);
+            AddStep($"set distance spacing = {multiplier}", () => snapProvider.DistanceSpacingMultiplier.Value = multiplier);
         }
 
         [Test]

From 29a3ab7e7a018d895ddcc5f14d65d0f864812855 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 6 May 2022 15:21:25 +0200
Subject: [PATCH 4598/5547] Halve drag box padding

Allows the drag box borders to collapse in on themselves to a single
line if the drag selection has zero width or height.
---
 osu.Game/Screens/Edit/Compose/Components/DragBox.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Edit/Compose/Components/DragBox.cs b/osu.Game/Screens/Edit/Compose/Components/DragBox.cs
index a256adbe4a..ecbac82db0 100644
--- a/osu.Game/Screens/Edit/Compose/Components/DragBox.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/DragBox.cs
@@ -136,7 +136,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
                     ? DrawWidth / ScreenSpaceDrawQuad.Width * 2
                     : DrawHeight / ScreenSpaceDrawQuad.Height * 2;
 
-                Padding = new MarginPadding(-lineThickness);
+                Padding = new MarginPadding(-lineThickness / 2);
 
                 InternalChildren = new Drawable[]
                 {

From c533c93ffd088e2a2240fdccc822608fd1460317 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 6 May 2022 15:29:54 +0200
Subject: [PATCH 4599/5547] Remove leftover border thickness spec in mod
 settings area

Was never supposed to be there, it was a vestige of a previous design
iteration that went by unnoticed.
---
 osu.Game/Overlays/Mods/ModSettingsArea.cs | 1 -
 1 file changed, 1 deletion(-)

diff --git a/osu.Game/Overlays/Mods/ModSettingsArea.cs b/osu.Game/Overlays/Mods/ModSettingsArea.cs
index 9c5f3b7f11..08f563f93e 100644
--- a/osu.Game/Overlays/Mods/ModSettingsArea.cs
+++ b/osu.Game/Overlays/Mods/ModSettingsArea.cs
@@ -44,7 +44,6 @@ namespace osu.Game.Overlays.Mods
             {
                 RelativeSizeAxes = Axes.Both,
                 Masking = true,
-                BorderThickness = 2,
                 Children = new Drawable[]
                 {
                     background = new Box

From 112496204d26f8709428b9eab026969953330910 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 6 May 2022 18:50:28 +0300
Subject: [PATCH 4600/5547] Make nested class private

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

diff --git a/osu.Game/Screens/Edit/Compose/Components/CircularDistanceSnapGrid.cs b/osu.Game/Screens/Edit/Compose/Components/CircularDistanceSnapGrid.cs
index 5682b5563e..b3df72f827 100644
--- a/osu.Game/Screens/Edit/Compose/Components/CircularDistanceSnapGrid.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/CircularDistanceSnapGrid.cs
@@ -103,7 +103,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
             return (snappedPosition, snappedTime);
         }
 
-        public class Ring : CircularProgress
+        private class Ring : CircularProgress
         {
             [Resolved]
             private IDistanceSnapProvider snapProvider { get; set; }

From d78f1d158d3f5582fc99efd20a92c48e5e73331d Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 6 May 2022 18:51:34 +0300
Subject: [PATCH 4601/5547] Use `GetEndTime()` instead of `StartTime`

Companion to
https://github.com/ppy/osu/pull/18103/commits/246479bf34c725d886742017099f9d509e58b2f7
---
 .../Screens/Edit/Compose/Components/CircularDistanceSnapGrid.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Edit/Compose/Components/CircularDistanceSnapGrid.cs b/osu.Game/Screens/Edit/Compose/Components/CircularDistanceSnapGrid.cs
index b3df72f827..6cb05f0596 100644
--- a/osu.Game/Screens/Edit/Compose/Components/CircularDistanceSnapGrid.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/CircularDistanceSnapGrid.cs
@@ -131,7 +131,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
                 if (editorClock == null)
                     return;
 
-                float distanceForCurrentTime = snapProvider.DurationToDistance(referenceObject, editorClock.CurrentTime - referenceObject.StartTime);
+                float distanceForCurrentTime = snapProvider.DurationToDistance(referenceObject, editorClock.CurrentTime - referenceObject.GetEndTime());
                 float timeBasedAlpha = Math.Clamp(1 - Math.Abs(distanceForCurrentTime - Size.X / 2) / 30, 0, 1);
 
                 Colour = baseColour.Opacity(Math.Max(baseColour.A, timeBasedAlpha));

From 723fce81741de8b858edb0a60090b850fc18f67a Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 6 May 2022 18:54:08 +0300
Subject: [PATCH 4602/5547] Move inverting value to happen outside clamp

Looks to have no effect, but makes sense to happen outside instead.
---
 .../Screens/Edit/Compose/Components/CircularDistanceSnapGrid.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Edit/Compose/Components/CircularDistanceSnapGrid.cs b/osu.Game/Screens/Edit/Compose/Components/CircularDistanceSnapGrid.cs
index 6cb05f0596..c0a3f7d97f 100644
--- a/osu.Game/Screens/Edit/Compose/Components/CircularDistanceSnapGrid.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/CircularDistanceSnapGrid.cs
@@ -132,7 +132,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
                     return;
 
                 float distanceForCurrentTime = snapProvider.DurationToDistance(referenceObject, editorClock.CurrentTime - referenceObject.GetEndTime());
-                float timeBasedAlpha = Math.Clamp(1 - Math.Abs(distanceForCurrentTime - Size.X / 2) / 30, 0, 1);
+                float timeBasedAlpha = 1 - Math.Clamp(Math.Abs(distanceForCurrentTime - Size.X / 2) / 30, 0, 1);
 
                 Colour = baseColour.Opacity(Math.Max(baseColour.A, timeBasedAlpha));
             }

From cc251ed5c3fe4a50126817d8893fba4a4a591536 Mon Sep 17 00:00:00 2001
From: Hugo Denizart <thepoon@cartooncraft.fr>
Date: Fri, 6 May 2022 19:52:25 +0200
Subject: [PATCH 4603/5547] =?UTF-8?q?=F0=9F=94=A7=20Update=20Sentry=20DSN?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

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

diff --git a/osu.Game/Utils/SentryLogger.cs b/osu.Game/Utils/SentryLogger.cs
index dbf04283b6..d9c8199f75 100644
--- a/osu.Game/Utils/SentryLogger.cs
+++ b/osu.Game/Utils/SentryLogger.cs
@@ -24,7 +24,7 @@ namespace osu.Game.Utils
 
             var options = new SentryOptions
             {
-                Dsn = "https://5e342cd55f294edebdc9ad604d28bbd3@sentry.io/1255255",
+                Dsn = "https://ad9f78529cef40ac874afb95a9aca04e@sentry.ppy.sh/2",
                 Release = game.Version
             };
 

From 049fed42e2084497b6766d7af736026fe77b96b4 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 6 May 2022 21:42:20 +0300
Subject: [PATCH 4604/5547] Fix side overlay offsetting not affecting
 fullscreen overlays

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

diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index e9fe8c43de..7f47c15f68 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -1153,6 +1153,7 @@ namespace osu.Game
                 horizontalOffset += (Content.ToLocalSpace(Notifications.ScreenSpaceDrawQuad.TopLeft).X - Content.DrawWidth) * SIDE_OVERLAY_OFFSET_RATIO;
 
             ScreenOffsetContainer.X = horizontalOffset;
+            overlayContent.X = horizontalOffset;
 
             MenuCursorContainer.CanShowCursor = (ScreenStack.CurrentScreen as IOsuScreen)?.CursorVisible ?? false;
         }

From 8080f784fd5f9a3e202d7f27808b8a08ac67835b Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 6 May 2022 22:20:04 +0300
Subject: [PATCH 4605/5547] Apply offset by a factor of 0.8x from screen offset

---
 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 7f47c15f68..b3de23ee08 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -1153,7 +1153,7 @@ namespace osu.Game
                 horizontalOffset += (Content.ToLocalSpace(Notifications.ScreenSpaceDrawQuad.TopLeft).X - Content.DrawWidth) * SIDE_OVERLAY_OFFSET_RATIO;
 
             ScreenOffsetContainer.X = horizontalOffset;
-            overlayContent.X = horizontalOffset;
+            overlayContent.X = horizontalOffset * 0.8f;
 
             MenuCursorContainer.CanShowCursor = (ScreenStack.CurrentScreen as IOsuScreen)?.CursorVisible ?? false;
         }

From 380cd1e03619e45ad580356342f99498c0f59592 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 6 May 2022 21:35:22 +0200
Subject: [PATCH 4606/5547] Add test coverage for lack of customisation on free
 mod select

---
 .../TestSceneFreeModSelectScreen.cs           | 34 ++++++++++++++-----
 1 file changed, 25 insertions(+), 9 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneFreeModSelectScreen.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneFreeModSelectScreen.cs
index b5f901e51d..8eaa45696f 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneFreeModSelectScreen.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneFreeModSelectScreen.cs
@@ -6,24 +6,19 @@ using NUnit.Framework;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Testing;
 using osu.Game.Overlays.Mods;
+using osu.Game.Rulesets.Osu.Mods;
 using osu.Game.Screens.OnlinePlay;
 
 namespace osu.Game.Tests.Visual.Multiplayer
 {
     public class TestSceneFreeModSelectScreen : MultiplayerTestScene
     {
+        private FreeModSelectScreen freeModSelectScreen;
+
         [Test]
         public void TestFreeModSelect()
         {
-            FreeModSelectScreen freeModSelectScreen = null;
-
-            AddStep("create free mod select screen", () => Child = freeModSelectScreen = new FreeModSelectScreen
-            {
-                State = { Value = Visibility.Visible }
-            });
-            AddUntilStep("all column content loaded",
-                () => freeModSelectScreen.ChildrenOfType<ModColumn>().Any()
-                      && freeModSelectScreen.ChildrenOfType<ModColumn>().All(column => column.IsLoaded && column.ItemsLoaded));
+            createFreeModSelect();
 
             AddUntilStep("all visible mods are playable",
                 () => this.ChildrenOfType<ModPanel>()
@@ -36,5 +31,26 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     freeModSelectScreen.State.Value = visible ? Visibility.Visible : Visibility.Hidden;
             });
         }
+
+        [Test]
+        public void TestCustomisationNotAvailable()
+        {
+            createFreeModSelect();
+
+            AddStep("select difficulty adjust", () => freeModSelectScreen.SelectedMods.Value = new[] { new OsuModDifficultyAdjust() });
+            AddWaitStep("wait some", 3);
+            AddAssert("customisation area not expanded", () => this.ChildrenOfType<ModSettingsArea>().Single().Height == 0);
+        }
+
+        private void createFreeModSelect()
+        {
+            AddStep("create free mod select screen", () => Child = freeModSelectScreen = new FreeModSelectScreen
+            {
+                State = { Value = Visibility.Visible }
+            });
+            AddUntilStep("all column content loaded",
+                () => freeModSelectScreen.ChildrenOfType<ModColumn>().Any()
+                      && freeModSelectScreen.ChildrenOfType<ModColumn>().All(column => column.IsLoaded && column.ItemsLoaded));
+        }
     }
 }

From c199b8fcb66fade4234b6e24597d42f4afccc442 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 6 May 2022 21:35:36 +0200
Subject: [PATCH 4607/5547] Simplify state management in `ModColumn`

Bad sign when you can't follow your own code.

All of the various state changing methods were flattened into one
because it was too hard to follow what was calling what and why.
---
 osu.Game/Overlays/Mods/ModColumn.cs | 43 ++++++++++-------------------
 1 file changed, 14 insertions(+), 29 deletions(-)

diff --git a/osu.Game/Overlays/Mods/ModColumn.cs b/osu.Game/Overlays/Mods/ModColumn.cs
index a792c0a81e..270839112a 100644
--- a/osu.Game/Overlays/Mods/ModColumn.cs
+++ b/osu.Game/Overlays/Mods/ModColumn.cs
@@ -49,7 +49,7 @@ namespace osu.Game.Overlays.Mods
             set
             {
                 filter = value;
-                updateFilter();
+                updateState();
             }
         }
 
@@ -292,9 +292,7 @@ namespace osu.Game.Overlays.Mods
             {
                 panelFlow.ChildrenEnumerable = loaded;
 
-                updateActiveState();
-                updateToggleAllState();
-                updateFilter();
+                updateState();
 
                 foreach (var panel in panelFlow)
                 {
@@ -308,10 +306,19 @@ namespace osu.Game.Overlays.Mods
             });
         }
 
-        private void updateActiveState()
+        private void updateState()
         {
             foreach (var panel in panelFlow)
+            {
                 panel.Active.Value = SelectedMods.Contains(panel.Mod);
+                panel.ApplyFilter(Filter);
+            }
+
+            if (toggleAllCheckbox != null && !SelectionAnimationRunning)
+            {
+                toggleAllCheckbox.Alpha = panelFlow.Any(panel => !panel.Filtered.Value) ? 1 : 0;
+                toggleAllCheckbox.Current.Value = panelFlow.Where(panel => !panel.Filtered.Value).All(panel => panel.Active.Value);
+            }
         }
 
         /// <summary>
@@ -323,13 +330,12 @@ namespace osu.Game.Overlays.Mods
 
         private void panelStateChanged(ModPanel panel)
         {
-            updateToggleAllState();
-
             var newSelectedMods = panel.Active.Value
                 ? SelectedMods.Append(panel.Mod)
                 : SelectedMods.Except(panel.Mod.Yield());
 
             SelectedMods = newSelectedMods.ToArray();
+            updateState();
             if (!externalSelectionUpdateInProgress)
                 SelectionChangedByUser?.Invoke();
         }
@@ -364,7 +370,7 @@ namespace osu.Game.Overlays.Mods
             }
 
             SelectedMods = newSelection;
-            updateActiveState();
+            updateState();
 
             externalSelectionUpdateInProgress = false;
         }
@@ -403,15 +409,6 @@ namespace osu.Game.Overlays.Mods
             }
         }
 
-        private void updateToggleAllState()
-        {
-            if (toggleAllCheckbox != null && !SelectionAnimationRunning)
-            {
-                toggleAllCheckbox.Alpha = panelFlow.Any(panel => !panel.Filtered.Value) ? 1 : 0;
-                toggleAllCheckbox.Current.Value = panelFlow.Where(panel => !panel.Filtered.Value).All(panel => panel.Active.Value);
-            }
-        }
-
         /// <summary>
         /// Selects all mods.
         /// </summary>
@@ -507,18 +504,6 @@ namespace osu.Game.Overlays.Mods
 
         #endregion
 
-        #region Filtering support
-
-        private void updateFilter()
-        {
-            foreach (var modPanel in panelFlow)
-                modPanel.ApplyFilter(Filter);
-
-            updateToggleAllState();
-        }
-
-        #endregion
-
         #region Keyboard selection support
 
         protected override bool OnKeyDown(KeyDownEvent e)

From 621f7467898e290bdd2d9d9fe3cc4daadd209366 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 6 May 2022 21:46:56 +0200
Subject: [PATCH 4608/5547] Do not modify selected mods through panel state
 change during external update

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

diff --git a/osu.Game/Overlays/Mods/ModColumn.cs b/osu.Game/Overlays/Mods/ModColumn.cs
index 270839112a..f6fa591666 100644
--- a/osu.Game/Overlays/Mods/ModColumn.cs
+++ b/osu.Game/Overlays/Mods/ModColumn.cs
@@ -330,14 +330,16 @@ namespace osu.Game.Overlays.Mods
 
         private void panelStateChanged(ModPanel panel)
         {
+            if (externalSelectionUpdateInProgress)
+                return;
+
             var newSelectedMods = panel.Active.Value
                 ? SelectedMods.Append(panel.Mod)
                 : SelectedMods.Except(panel.Mod.Yield());
 
             SelectedMods = newSelectedMods.ToArray();
             updateState();
-            if (!externalSelectionUpdateInProgress)
-                SelectionChangedByUser?.Invoke();
+            SelectionChangedByUser?.Invoke();
         }
 
         /// <summary>

From 8c73ed72078a47eb7f166164cb80e642b5486218 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 6 May 2022 21:38:29 +0200
Subject: [PATCH 4609/5547] Fix sequence equality check not using reference
 comparison

---
 osu.Game/Overlays/Mods/ModSelectScreen.cs | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/Mods/ModSelectScreen.cs b/osu.Game/Overlays/Mods/ModSelectScreen.cs
index a1b4d7d8a0..838c3597ae 100644
--- a/osu.Game/Overlays/Mods/ModSelectScreen.cs
+++ b/osu.Game/Overlays/Mods/ModSelectScreen.cs
@@ -13,6 +13,7 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Input.Events;
 using osu.Framework.Layout;
+using osu.Framework.Lists;
 using osu.Framework.Utils;
 using osu.Game.Configuration;
 using osu.Game.Graphics;
@@ -264,7 +265,9 @@ namespace osu.Game.Overlays.Mods
         {
             var candidateSelection = columnFlow.Columns.SelectMany(column => column.SelectedMods).ToArray();
 
-            if (candidateSelection.SequenceEqual(SelectedMods.Value))
+            // the following guard intends to check cases where we've already replaced potentially-external mod references with our own and avoid endless recursion.
+            // TODO: replace custom comparer with System.Collections.Generic.ReferenceEqualityComparer when fully on .NET 6
+            if (candidateSelection.SequenceEqual(SelectedMods.Value, new FuncEqualityComparer<Mod>(ReferenceEquals)))
                 return;
 
             SelectedMods.Value = ComputeNewModsFromSelection(SelectedMods.Value, candidateSelection);

From 9d62206176732dbc9b6e96b1f0258ee87dffe489 Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Fri, 6 May 2022 22:56:35 +0100
Subject: [PATCH 4610/5547] Update new chat overlay day separator colours and
 spacing

Updates the `DaySeparator` component to have separately settable colours
for the text and the lines.

Updates existing overrides of the `DaySeparator` to use the new colour
setter.

Create new `ChatOverlayDrawableChannel` with adjusted spacing and new
`DaySeparator` colours.
---
 .../Visual/Online/TestSceneChatOverlayV2.cs   |  6 ++--
 osu.Game/Online/Chat/StandAloneChatDisplay.cs | 33 ++++++++-----------
 osu.Game/Overlays/Chat/ChatTextBar.cs         |  2 +-
 osu.Game/Overlays/Chat/DrawableChannel.cs     | 18 +++++++++-
 osu.Game/Overlays/ChatOverlayV2.cs            | 33 +++++++++++++++++--
 5 files changed, 64 insertions(+), 28 deletions(-)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs b/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs
index 7c77ac925e..9d894314f8 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs
@@ -365,7 +365,7 @@ namespace osu.Game.Tests.Visual.Online
             AddAssert("TextBox is focused", () => InputManager.FocusedDrawable == chatOverlayTextBox);
             AddStep("Click listing", () => clickDrawable(chatOverlay.ChildrenOfType<ChannelListing>().Single()));
             AddAssert("TextBox is focused", () => InputManager.FocusedDrawable == chatOverlayTextBox);
-            AddStep("Click drawable channel", () => clickDrawable(chatOverlay.ChildrenOfType<DrawableChannel>().Single()));
+            AddStep("Click drawable channel", () => clickDrawable(chatOverlay.ChildrenOfType<ChatOverlayDrawableChannel>().Single()));
             AddAssert("TextBox is focused", () => InputManager.FocusedDrawable == chatOverlayTextBox);
             AddStep("Click channel list", () => clickDrawable(chatOverlay.ChildrenOfType<ChannelList>().Single()));
             AddAssert("TextBox is focused", () => InputManager.FocusedDrawable == chatOverlayTextBox);
@@ -381,8 +381,8 @@ namespace osu.Game.Tests.Visual.Online
         private Visibility loadingVisibility =>
             chatOverlay.ChildrenOfType<LoadingLayer>().Single().State.Value;
 
-        private DrawableChannel currentDrawableChannel =>
-            chatOverlay.ChildrenOfType<Container<DrawableChannel>>().Single().Child;
+        private ChatOverlayDrawableChannel currentDrawableChannel =>
+            chatOverlay.ChildrenOfType<Container<ChatOverlayDrawableChannel>>().Single().Child;
 
         private ChannelListItem getChannelListItem(Channel channel) =>
             chatOverlay.ChildrenOfType<ChannelListItem>().Single(item => item.Channel == channel);
diff --git a/osu.Game/Online/Chat/StandAloneChatDisplay.cs b/osu.Game/Online/Chat/StandAloneChatDisplay.cs
index df210fcaf8..c03cd938a5 100644
--- a/osu.Game/Online/Chat/StandAloneChatDisplay.cs
+++ b/osu.Game/Online/Chat/StandAloneChatDisplay.cs
@@ -155,9 +155,7 @@ namespace osu.Game.Online.Chat
         {
             public Func<Message, ChatLine> CreateChatLineAction;
 
-            protected override ChatLine CreateChatLine(Message m) => CreateChatLineAction(m);
-
-            protected override DaySeparator CreateDaySeparator(DateTimeOffset time) => new CustomDaySeparator(time);
+            private Colour4 daySepColour;
 
             public StandAloneDrawableChannel(Channel channel)
                 : base(channel)
@@ -165,28 +163,23 @@ namespace osu.Game.Online.Chat
             }
 
             [BackgroundDependencyLoader]
-            private void load()
+            private void load(OsuColour colours)
             {
                 ChatLineFlow.Padding = new MarginPadding { Horizontal = 0 };
+                daySepColour = colours.Yellow;
             }
 
-            private class CustomDaySeparator : DaySeparator
+            protected override ChatLine CreateChatLine(Message m) => CreateChatLineAction(m);
+
+            protected override DaySeparator CreateDaySeparator(DateTimeOffset time) => new DaySeparator(time)
             {
-                public CustomDaySeparator(DateTimeOffset time)
-                    : base(time)
-                {
-                }
-
-                [BackgroundDependencyLoader]
-                private void load(OsuColour colours)
-                {
-                    Colour = colours.Yellow;
-                    TextSize = 14;
-                    LineHeight = 1;
-                    Padding = new MarginPadding { Horizontal = 10 };
-                    Margin = new MarginPadding { Vertical = 5 };
-                }
-            }
+                TextSize = 14,
+                TextColour = daySepColour,
+                LineHeight = 1,
+                LineColour = daySepColour,
+                Padding = new MarginPadding { Horizontal = 10 },
+                Margin = new MarginPadding { Vertical = 5 },
+            };
         }
 
         protected class StandAloneMessage : ChatLine
diff --git a/osu.Game/Overlays/Chat/ChatTextBar.cs b/osu.Game/Overlays/Chat/ChatTextBar.cs
index 0fa3613d38..404d686d91 100644
--- a/osu.Game/Overlays/Chat/ChatTextBar.cs
+++ b/osu.Game/Overlays/Chat/ChatTextBar.cs
@@ -38,7 +38,7 @@ namespace osu.Game.Overlays.Chat
         private Container searchIconContainer = null!;
         private ChatTextBox chatTextBox = null!;
 
-        private const float chatting_text_width = 240;
+        private const float chatting_text_width = 220;
         private const float search_icon_width = 40;
 
         [BackgroundDependencyLoader]
diff --git a/osu.Game/Overlays/Chat/DrawableChannel.cs b/osu.Game/Overlays/Chat/DrawableChannel.cs
index 161fe1d5be..7e4e936bee 100644
--- a/osu.Game/Overlays/Chat/DrawableChannel.cs
+++ b/osu.Game/Overlays/Chat/DrawableChannel.cs
@@ -9,6 +9,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.Shapes;
 using osu.Framework.Graphics.Sprites;
@@ -123,8 +124,9 @@ namespace osu.Game.Overlays.Chat
 
         protected virtual DaySeparator CreateDaySeparator(DateTimeOffset time) => new DaySeparator(time)
         {
+            TextColour = colours.ChatBlue.Lighten(0.7f),
+            LineColour = colours.ChatBlue.Lighten(0.7f),
             Margin = new MarginPadding { Vertical = 10 },
-            Colour = colours.ChatBlue.Lighten(0.7f),
         };
 
         private void newMessagesArrived(IEnumerable<Message> newMessages) => Schedule(() =>
@@ -212,6 +214,12 @@ namespace osu.Game.Overlays.Chat
                 set => text.Font = text.Font.With(size: value);
             }
 
+            public ColourInfo TextColour
+            {
+                get => text.Colour;
+                set => text.Colour = value;
+            }
+
             private float lineHeight = 2;
 
             public float LineHeight
@@ -220,6 +228,14 @@ namespace osu.Game.Overlays.Chat
                 set => lineHeight = leftBox.Height = rightBox.Height = value;
             }
 
+            private ColourInfo lineColour;
+
+            public ColourInfo LineColour
+            {
+                get => lineColour;
+                set => lineColour = leftBox.Colour = rightBox.Colour = value;
+            }
+
             private readonly SpriteText text;
             private readonly Box leftBox;
             private readonly Box rightBox;
diff --git a/osu.Game/Overlays/ChatOverlayV2.cs b/osu.Game/Overlays/ChatOverlayV2.cs
index 4c7fa0f802..cc050a0760 100644
--- a/osu.Game/Overlays/ChatOverlayV2.cs
+++ b/osu.Game/Overlays/ChatOverlayV2.cs
@@ -3,6 +3,7 @@
 
 #nullable enable
 
+using System;
 using System.Collections;
 using System.Collections.Generic;
 using System.Collections.Specialized;
@@ -37,7 +38,7 @@ namespace osu.Game.Overlays
         private LoadingLayer loading = null!;
         private ChannelListing channelListing = null!;
         private ChatTextBar textBar = null!;
-        private Container<DrawableChannel> currentChannelContainer = null!;
+        private Container<ChatOverlayDrawableChannel> currentChannelContainer = null!;
 
         private readonly BindableFloat chatHeight = new BindableFloat();
 
@@ -120,7 +121,7 @@ namespace osu.Game.Overlays
                             RelativeSizeAxes = Axes.Both,
                             Colour = colourProvider.Background4,
                         },
-                        currentChannelContainer = new Container<DrawableChannel>
+                        currentChannelContainer = new Container<ChatOverlayDrawableChannel>
                         {
                             RelativeSizeAxes = Axes.Both,
                         },
@@ -268,7 +269,7 @@ namespace osu.Game.Overlays
                 return;
             }
 
-            LoadComponentAsync(new DrawableChannel(newChannel), loaded =>
+            LoadComponentAsync(new ChatOverlayDrawableChannel(newChannel), loaded =>
             {
                 currentChannelContainer.Clear();
                 currentChannelContainer.Add(loaded);
@@ -311,4 +312,30 @@ namespace osu.Game.Overlays
                 channelManager.PostMessage(message);
         }
     }
+
+    public class ChatOverlayDrawableChannel : DrawableChannel
+    {
+        private Colour4 daySepTextColour;
+        private Colour4 daySepLineColour;
+
+        public ChatOverlayDrawableChannel(Channel channel)
+            : base(channel)
+        { }
+
+        [BackgroundDependencyLoader]
+        private void load(OverlayColourProvider colourProvider)
+        {
+            ChatLineFlow.Padding = new MarginPadding(0);
+            daySepTextColour = colourProvider.Content1;
+            daySepLineColour = colourProvider.Background5;
+        }
+
+        protected override DaySeparator CreateDaySeparator(DateTimeOffset time) => new DaySeparator(time)
+        {
+            TextColour = daySepTextColour,
+            LineColour = daySepLineColour,
+            Margin = new MarginPadding { Vertical = 10 },
+            Padding = new MarginPadding { Horizontal = 15 },
+        };
+    }
 }

From 6fc808be22cb8bf32e8f1bd497f88efa7f89340c Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Fri, 6 May 2022 23:17:59 +0100
Subject: [PATCH 4611/5547] Code quality

---
 osu.Game/Overlays/ChatOverlayV2.cs | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/ChatOverlayV2.cs b/osu.Game/Overlays/ChatOverlayV2.cs
index cc050a0760..e1ac71a125 100644
--- a/osu.Game/Overlays/ChatOverlayV2.cs
+++ b/osu.Game/Overlays/ChatOverlayV2.cs
@@ -320,7 +320,8 @@ namespace osu.Game.Overlays
 
         public ChatOverlayDrawableChannel(Channel channel)
             : base(channel)
-        { }
+        {
+        }
 
         [BackgroundDependencyLoader]
         private void load(OverlayColourProvider colourProvider)

From 71758390b5db8186bd149647d162417e5607e730 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 7 May 2022 13:37:36 +0900
Subject: [PATCH 4612/5547] Fix time based distance grid alpha not correctly
 accounting for distance spacing multiplier

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

diff --git a/osu.Game/Screens/Edit/Compose/Components/CircularDistanceSnapGrid.cs b/osu.Game/Screens/Edit/Compose/Components/CircularDistanceSnapGrid.cs
index c0a3f7d97f..2c6bb766ad 100644
--- a/osu.Game/Screens/Edit/Compose/Components/CircularDistanceSnapGrid.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/CircularDistanceSnapGrid.cs
@@ -131,7 +131,12 @@ namespace osu.Game.Screens.Edit.Compose.Components
                 if (editorClock == null)
                     return;
 
-                float distanceForCurrentTime = snapProvider.DurationToDistance(referenceObject, editorClock.CurrentTime - referenceObject.GetEndTime());
+                float distanceSpacingMultiplier = (float)snapProvider.DistanceSpacingMultiplier.Value;
+                double timeFromReferencePoint = editorClock.CurrentTime - referenceObject.GetEndTime();
+
+                float distanceForCurrentTime = snapProvider.DurationToDistance(referenceObject, timeFromReferencePoint)
+                                               * distanceSpacingMultiplier;
+
                 float timeBasedAlpha = 1 - Math.Clamp(Math.Abs(distanceForCurrentTime - Size.X / 2) / 30, 0, 1);
 
                 Colour = baseColour.Opacity(Math.Max(baseColour.A, timeBasedAlpha));

From ce14fddcb2c2950285dd89d96b8587cd9c3fbf6f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 7 May 2022 14:02:07 +0900
Subject: [PATCH 4613/5547] Use above-1 offset instead for more correct feeling
 parallax

---
 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 b3de23ee08..69adca4190 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -1153,7 +1153,7 @@ namespace osu.Game
                 horizontalOffset += (Content.ToLocalSpace(Notifications.ScreenSpaceDrawQuad.TopLeft).X - Content.DrawWidth) * SIDE_OVERLAY_OFFSET_RATIO;
 
             ScreenOffsetContainer.X = horizontalOffset;
-            overlayContent.X = horizontalOffset * 0.8f;
+            overlayContent.X = horizontalOffset * 1.2f;
 
             MenuCursorContainer.CanShowCursor = (ScreenStack.CurrentScreen as IOsuScreen)?.CursorVisible ?? false;
         }

From 0c6de331f3075fe701210031271d79bd4cdeef8b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 6 May 2022 15:59:19 +0200
Subject: [PATCH 4614/5547] Move footer button padding to a higher level

---
 osu.Game/Overlays/Mods/ModSelectScreen.cs | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Overlays/Mods/ModSelectScreen.cs b/osu.Game/Overlays/Mods/ModSelectScreen.cs
index 838c3597ae..06baea8364 100644
--- a/osu.Game/Overlays/Mods/ModSelectScreen.cs
+++ b/osu.Game/Overlays/Mods/ModSelectScreen.cs
@@ -145,13 +145,18 @@ namespace osu.Game.Overlays.Mods
                 });
             }
 
+            FooterContent.Padding = new MarginPadding
+            {
+                Vertical = PADDING,
+                Horizontal = 70
+            };
+
             if (AllowCustomisation)
             {
-                Footer.Add(new ShearedToggleButton(200)
+                FooterContent.Add(new ShearedToggleButton(200)
                 {
                     Anchor = Anchor.BottomLeft,
                     Origin = Anchor.BottomLeft,
-                    Margin = new MarginPadding { Vertical = PADDING, Left = 70 },
                     Text = "Mod Customisation",
                     Active = { BindTarget = customisationVisible }
                 });

From 0b95594f60f8afeab0b3927944e4f28e66b8eb28 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 6 May 2022 16:02:32 +0200
Subject: [PATCH 4615/5547] Add some more padding between footer and column
 scroll

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

diff --git a/osu.Game/Overlays/Mods/ModSelectScreen.cs b/osu.Game/Overlays/Mods/ModSelectScreen.cs
index 06baea8364..75f9f4e72e 100644
--- a/osu.Game/Overlays/Mods/ModSelectScreen.cs
+++ b/osu.Game/Overlays/Mods/ModSelectScreen.cs
@@ -95,6 +95,7 @@ namespace osu.Game.Overlays.Mods
                     Padding = new MarginPadding
                     {
                         Top = (ShowTotalMultiplier ? DifficultyMultiplierDisplay.HEIGHT : 0) + PADDING,
+                        Bottom = PADDING
                     },
                     RelativeSizeAxes = Axes.Both,
                     RelativePositionAxes = Axes.Both,

From 852e4a97668421ad78b258d6366204ebb8cdd858 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 6 May 2022 16:31:59 +0200
Subject: [PATCH 4616/5547] Add select/deselect all buttons to free mod select
 screen

---
 osu.Game/Overlays/Mods/ModSelectScreen.cs     | 61 +++++++++++++------
 .../Screens/OnlinePlay/FreeModSelectScreen.cs | 21 ++++++-
 2 files changed, 61 insertions(+), 21 deletions(-)

diff --git a/osu.Game/Overlays/Mods/ModSelectScreen.cs b/osu.Game/Overlays/Mods/ModSelectScreen.cs
index 75f9f4e72e..419a6ee7f7 100644
--- a/osu.Game/Overlays/Mods/ModSelectScreen.cs
+++ b/osu.Game/Overlays/Mods/ModSelectScreen.cs
@@ -47,11 +47,6 @@ namespace osu.Game.Overlays.Mods
             }
         }
 
-        /// <summary>
-        /// Whether configurable <see cref="Mod"/>s can be configured by the local user.
-        /// </summary>
-        protected virtual bool AllowCustomisation => true;
-
         /// <summary>
         /// Whether the total score multiplier calculated from the current selected set of mods should be shown.
         /// </summary>
@@ -59,12 +54,27 @@ namespace osu.Game.Overlays.Mods
 
         protected virtual ModColumn CreateModColumn(ModType modType, Key[]? toggleKeys = null) => new ModColumn(modType, false, toggleKeys);
 
+        protected virtual Drawable[] CreateFooterButtons() => new Drawable[]
+        {
+            customisationButton = new ShearedToggleButton(200)
+            {
+                Text = "Mod Customisation",
+                Active = { BindTarget = customisationVisible }
+            },
+            new ShearedButton(200)
+            {
+                Text = "Deselect All",
+                Action = DeselectAll
+            }
+        };
+
         private readonly BindableBool customisationVisible = new BindableBool();
 
         private DifficultyMultiplierDisplay? multiplierDisplay;
         private ModSettingsArea modSettingsArea = null!;
         private ColumnScrollContainer columnScroll = null!;
         private ColumnFlowContainer columnFlow = null!;
+        private ShearedToggleButton? customisationButton;
 
         [BackgroundDependencyLoader]
         private void load()
@@ -146,22 +156,21 @@ namespace osu.Game.Overlays.Mods
                 });
             }
 
-            FooterContent.Padding = new MarginPadding
+            FooterContent.Child = new FillFlowContainer
             {
-                Vertical = PADDING,
-                Horizontal = 70
-            };
-
-            if (AllowCustomisation)
-            {
-                FooterContent.Add(new ShearedToggleButton(200)
+                RelativeSizeAxes = Axes.X,
+                AutoSizeAxes = Axes.Y,
+                Direction = FillDirection.Horizontal,
+                Anchor = Anchor.BottomLeft,
+                Origin = Anchor.BottomLeft,
+                Padding = new MarginPadding
                 {
-                    Anchor = Anchor.BottomLeft,
-                    Origin = Anchor.BottomLeft,
-                    Text = "Mod Customisation",
-                    Active = { BindTarget = customisationVisible }
-                });
-            }
+                    Vertical = PADDING,
+                    Horizontal = 70
+                },
+                Spacing = new Vector2(10),
+                Children = CreateFooterButtons()
+            };
         }
 
         private ColumnDimContainer createModColumnContent(ModType modType, Key[]? toggleKeys = null)
@@ -216,7 +225,7 @@ namespace osu.Game.Overlays.Mods
 
         private void updateCustomisation(ValueChangedEvent<IReadOnlyList<Mod>> valueChangedEvent)
         {
-            if (!AllowCustomisation)
+            if (customisationButton == null)
                 return;
 
             bool anyCustomisableMod = false;
@@ -325,6 +334,18 @@ namespace osu.Game.Overlays.Mods
             }
         }
 
+        protected void SelectAll()
+        {
+            foreach (var column in columnFlow.Columns)
+                column.SelectAll();
+        }
+
+        protected void DeselectAll()
+        {
+            foreach (var column in columnFlow.Columns)
+                column.DeselectAll();
+        }
+
         public override bool OnPressed(KeyBindingPressEvent<GlobalAction> e)
         {
             if (e.Action == GlobalAction.Back && customisationVisible.Value)
diff --git a/osu.Game/Screens/OnlinePlay/FreeModSelectScreen.cs b/osu.Game/Screens/OnlinePlay/FreeModSelectScreen.cs
index 5a7a60b479..52ca28ce5d 100644
--- a/osu.Game/Screens/OnlinePlay/FreeModSelectScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/FreeModSelectScreen.cs
@@ -2,6 +2,8 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
+using osu.Framework.Graphics;
+using osu.Game.Graphics.UserInterface;
 using osu.Game.Overlays.Mods;
 using osu.Game.Rulesets.Mods;
 using osuTK.Input;
@@ -10,7 +12,6 @@ namespace osu.Game.Screens.OnlinePlay
 {
     public class FreeModSelectScreen : ModSelectScreen
     {
-        protected override bool AllowCustomisation => false;
         protected override bool ShowTotalMultiplier => false;
 
         public new Func<Mod, bool> IsValidMod
@@ -25,5 +26,23 @@ namespace osu.Game.Screens.OnlinePlay
         }
 
         protected override ModColumn CreateModColumn(ModType modType, Key[] toggleKeys = null) => new ModColumn(modType, true, toggleKeys);
+
+        protected override Drawable[] CreateFooterButtons() => new Drawable[]
+        {
+            new ShearedButton(200)
+            {
+                Anchor = Anchor.BottomLeft,
+                Origin = Anchor.BottomLeft,
+                Text = "Select All",
+                Action = SelectAll
+            },
+            new ShearedButton(200)
+            {
+                Anchor = Anchor.BottomLeft,
+                Origin = Anchor.BottomLeft,
+                Text = "Deselect All",
+                Action = DeselectAll
+            }
+        };
     }
 }

From 35c106efaab09a067c7b456aabfda8ec7e24fdb4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 6 May 2022 20:54:36 +0200
Subject: [PATCH 4617/5547] Add test coverage for deselecting all mods on user
 mod select

---
 .../UserInterface/TestSceneModSelectScreen.cs   | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs
index c92a738b56..9e0c8206b7 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs
@@ -415,6 +415,23 @@ namespace osu.Game.Tests.Visual.UserInterface
             AddAssert("unimplemented mod panel is filtered", () => getPanelForMod(typeof(TestUnimplementedMod)).Filtered.Value);
         }
 
+        [Test]
+        public void TestDeselectAllViaButton()
+        {
+            createScreen();
+            changeRuleset(0);
+
+            AddStep("select DT + HD", () => SelectedMods.Value = new Mod[] { new OsuModDoubleTime(), new OsuModHidden() });
+            AddAssert("DT + HD selected", () => modSelectScreen.ChildrenOfType<ModPanel>().Count(panel => panel.Active.Value) == 2);
+
+            AddStep("click deselect all button", () =>
+            {
+                InputManager.MoveMouseTo(this.ChildrenOfType<ShearedButton>().Last());
+                InputManager.Click(MouseButton.Left);
+            });
+            AddUntilStep("all mods deselected", () => !SelectedMods.Value.Any());
+        }
+
         private void waitForColumnLoad() => AddUntilStep("all column content loaded",
             () => modSelectScreen.ChildrenOfType<ModColumn>().Any() && modSelectScreen.ChildrenOfType<ModColumn>().All(column => column.IsLoaded && column.ItemsLoaded));
 

From e1953c484c0ae08bb4846a1243bf4c3283640ac8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 6 May 2022 16:43:24 +0200
Subject: [PATCH 4618/5547] Add test coverage for selecting/deselecting all
 mods on free mod select

---
 .../TestSceneFreeModSelectScreen.cs           | 49 +++++++++++++++++++
 1 file changed, 49 insertions(+)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneFreeModSelectScreen.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneFreeModSelectScreen.cs
index 8eaa45696f..a02055d960 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneFreeModSelectScreen.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneFreeModSelectScreen.cs
@@ -1,19 +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 System.Linq;
 using NUnit.Framework;
+using osu.Framework.Allocation;
+using osu.Framework.Bindables;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Testing;
+using osu.Game.Graphics.UserInterface;
 using osu.Game.Overlays.Mods;
 using osu.Game.Rulesets.Osu.Mods;
+using osu.Game.Rulesets.Mods;
 using osu.Game.Screens.OnlinePlay;
+using osuTK.Input;
 
 namespace osu.Game.Tests.Visual.Multiplayer
 {
     public class TestSceneFreeModSelectScreen : MultiplayerTestScene
     {
         private FreeModSelectScreen freeModSelectScreen;
+        private readonly Bindable<Dictionary<ModType, IReadOnlyList<Mod>>> availableMods = new Bindable<Dictionary<ModType, IReadOnlyList<Mod>>>();
+
+        [BackgroundDependencyLoader]
+        private void load(OsuGameBase osuGameBase)
+        {
+            availableMods.BindTo(osuGameBase.AvailableMods);
+        }
 
         [Test]
         public void TestFreeModSelect()
@@ -42,6 +55,26 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddAssert("customisation area not expanded", () => this.ChildrenOfType<ModSettingsArea>().Single().Height == 0);
         }
 
+        [Test]
+        public void TestSelectDeselectAll()
+        {
+            createFreeModSelect();
+
+            AddStep("click select all button", () =>
+            {
+                InputManager.MoveMouseTo(this.ChildrenOfType<ShearedButton>().First());
+                InputManager.Click(MouseButton.Left);
+            });
+            AddUntilStep("all mods selected", assertAllAvailableModsSelected);
+
+            AddStep("click deselect all button", () =>
+            {
+                InputManager.MoveMouseTo(this.ChildrenOfType<ShearedButton>().Last());
+                InputManager.Click(MouseButton.Left);
+            });
+            AddUntilStep("all mods deselected", () => !freeModSelectScreen.SelectedMods.Value.Any());
+        }
+
         private void createFreeModSelect()
         {
             AddStep("create free mod select screen", () => Child = freeModSelectScreen = new FreeModSelectScreen
@@ -52,5 +85,21 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 () => freeModSelectScreen.ChildrenOfType<ModColumn>().Any()
                       && freeModSelectScreen.ChildrenOfType<ModColumn>().All(column => column.IsLoaded && column.ItemsLoaded));
         }
+
+        private bool assertAllAvailableModsSelected()
+        {
+            var allAvailableMods = availableMods.Value
+                                                .SelectMany(pair => pair.Value)
+                                                .Where(mod => mod.UserPlayable && mod.HasImplementation)
+                                                .ToList();
+
+            foreach (var availableMod in allAvailableMods)
+            {
+                if (freeModSelectScreen.SelectedMods.Value.All(selectedMod => selectedMod.GetType() != availableMod.GetType()))
+                    return false;
+            }
+
+            return true;
+        }
     }
 }

From 9f96dd47d12db4a4df8ebfa9268eec86907fb886 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 6 May 2022 16:48:01 +0200
Subject: [PATCH 4619/5547] Remove schedule in panel load

It was causing selection/deselection of all mods to work improperly if a
select/deselect all operation was requested before the panel was
scrolled into view.

In general the schedule was an over-optimisation - the game-global set
of available mods shouldn't be changing so often as to warrant such an
aggressive debounce.
---
 osu.Game/Overlays/Mods/ModColumn.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/Mods/ModColumn.cs b/osu.Game/Overlays/Mods/ModColumn.cs
index f6fa591666..7f1d7e0541 100644
--- a/osu.Game/Overlays/Mods/ModColumn.cs
+++ b/osu.Game/Overlays/Mods/ModColumn.cs
@@ -275,7 +275,7 @@ namespace osu.Game.Overlays.Mods
                 return;
 
             localAvailableMods = newMods;
-            Scheduler.AddOnce(loadPanels);
+            loadPanels();
         }
 
         private CancellationTokenSource? cancellationTokenSource;

From 9514a5cef7a6b291056697f1305fa159903103a3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 6 May 2022 17:33:32 +0200
Subject: [PATCH 4620/5547] Only load panels asynchronously outside of BDL

---
 osu.Game/Overlays/Mods/ModColumn.cs | 41 +++++++++++++++++++----------
 1 file changed, 27 insertions(+), 14 deletions(-)

diff --git a/osu.Game/Overlays/Mods/ModColumn.cs b/osu.Game/Overlays/Mods/ModColumn.cs
index 7f1d7e0541..6297b2d92e 100644
--- a/osu.Game/Overlays/Mods/ModColumn.cs
+++ b/osu.Game/Overlays/Mods/ModColumn.cs
@@ -275,30 +275,25 @@ namespace osu.Game.Overlays.Mods
                 return;
 
             localAvailableMods = newMods;
-            loadPanels();
+
+            if (!IsLoaded)
+                // if we're coming from BDL, perform the first load synchronously to make sure everything is in place as early as possible.
+                onPanelsLoaded(createPanels());
+            else
+                asyncLoadPanels();
         }
 
         private CancellationTokenSource? cancellationTokenSource;
 
-        private void loadPanels()
+        private void asyncLoadPanels()
         {
             cancellationTokenSource?.Cancel();
 
-            var panels = localAvailableMods.Select(mod => CreateModPanel(mod).With(panel => panel.Shear = new Vector2(-ShearedOverlayContainer.SHEAR, 0)));
+            var panels = createPanels();
 
             Task? loadTask;
 
-            latestLoadTask = loadTask = LoadComponentsAsync(panels, loaded =>
-            {
-                panelFlow.ChildrenEnumerable = loaded;
-
-                updateState();
-
-                foreach (var panel in panelFlow)
-                {
-                    panel.Active.BindValueChanged(_ => panelStateChanged(panel));
-                }
-            }, (cancellationTokenSource = new CancellationTokenSource()).Token);
+            latestLoadTask = loadTask = LoadComponentsAsync(panels, onPanelsLoaded, (cancellationTokenSource = new CancellationTokenSource()).Token);
             loadTask.ContinueWith(_ =>
             {
                 if (loadTask == latestLoadTask)
@@ -306,6 +301,24 @@ namespace osu.Game.Overlays.Mods
             });
         }
 
+        private IEnumerable<ModPanel> createPanels()
+        {
+            var panels = localAvailableMods.Select(mod => CreateModPanel(mod).With(panel => panel.Shear = new Vector2(-ShearedOverlayContainer.SHEAR, 0)));
+            return panels;
+        }
+
+        private void onPanelsLoaded(IEnumerable<ModPanel> loaded)
+        {
+            panelFlow.ChildrenEnumerable = loaded;
+
+            updateState();
+
+            foreach (var panel in panelFlow)
+            {
+                panel.Active.BindValueChanged(_ => panelStateChanged(panel));
+            }
+        }
+
         private void updateState()
         {
             foreach (var panel in panelFlow)

From 18e4c3ed0f6659ff7c3dc3b5bb089a7c09c04b80 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 6 May 2022 18:08:11 +0200
Subject: [PATCH 4621/5547] Update mod columns even if they're not
 present/offscreen

Important to make "select/deselect all" operations work on all columns
simultaneously, even if they're offscreen. Unfortunately by the nature
of how the existing selection animation works, it is hard-tied to the
update loop, so we need to compensate.
---
 osu.Game/Overlays/Mods/ModColumn.cs       | 2 +-
 osu.Game/Overlays/Mods/ModSelectScreen.cs | 2 ++
 2 files changed, 3 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/Mods/ModColumn.cs b/osu.Game/Overlays/Mods/ModColumn.cs
index 6297b2d92e..07871663a6 100644
--- a/osu.Game/Overlays/Mods/ModColumn.cs
+++ b/osu.Game/Overlays/Mods/ModColumn.cs
@@ -399,7 +399,7 @@ namespace osu.Game.Overlays.Mods
 
         private readonly Queue<Action> pendingSelectionOperations = new Queue<Action>();
 
-        protected bool SelectionAnimationRunning => pendingSelectionOperations.Count > 0;
+        internal bool SelectionAnimationRunning => pendingSelectionOperations.Count > 0;
 
         protected override void Update()
         {
diff --git a/osu.Game/Overlays/Mods/ModSelectScreen.cs b/osu.Game/Overlays/Mods/ModSelectScreen.cs
index 419a6ee7f7..5ffe07f34a 100644
--- a/osu.Game/Overlays/Mods/ModSelectScreen.cs
+++ b/osu.Game/Overlays/Mods/ModSelectScreen.cs
@@ -454,6 +454,8 @@ namespace osu.Game.Overlays.Mods
                 FinishTransforms();
             }
 
+            protected override bool RequiresChildrenUpdate => base.RequiresChildrenUpdate || Column.SelectionAnimationRunning;
+
             private void updateDim()
             {
                 Colour4 targetColour;

From 4ff96f82be57186874089d942beb35ee4766a015 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 6 May 2022 22:36:08 +0200
Subject: [PATCH 4622/5547] Dim other buttons if customisation panel is open

---
 osu.Game/Overlays/Mods/ModSelectScreen.cs          | 13 ++++++++++---
 osu.Game/Screens/OnlinePlay/FreeModSelectScreen.cs |  3 ++-
 2 files changed, 12 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Overlays/Mods/ModSelectScreen.cs b/osu.Game/Overlays/Mods/ModSelectScreen.cs
index 5ffe07f34a..e5b4927a6a 100644
--- a/osu.Game/Overlays/Mods/ModSelectScreen.cs
+++ b/osu.Game/Overlays/Mods/ModSelectScreen.cs
@@ -54,7 +54,7 @@ namespace osu.Game.Overlays.Mods
 
         protected virtual ModColumn CreateModColumn(ModType modType, Key[]? toggleKeys = null) => new ModColumn(modType, false, toggleKeys);
 
-        protected virtual Drawable[] CreateFooterButtons() => new Drawable[]
+        protected virtual IEnumerable<ShearedButton> CreateFooterButtons() => new[]
         {
             customisationButton = new ShearedToggleButton(200)
             {
@@ -75,6 +75,7 @@ namespace osu.Game.Overlays.Mods
         private ColumnScrollContainer columnScroll = null!;
         private ColumnFlowContainer columnFlow = null!;
         private ShearedToggleButton? customisationButton;
+        private FillFlowContainer<ShearedButton> footerButtonFlow = null!;
 
         [BackgroundDependencyLoader]
         private void load()
@@ -156,7 +157,7 @@ namespace osu.Game.Overlays.Mods
                 });
             }
 
-            FooterContent.Child = new FillFlowContainer
+            FooterContent.Child = footerButtonFlow = new FillFlowContainer<ShearedButton>
             {
                 RelativeSizeAxes = Axes.X,
                 AutoSizeAxes = Axes.Y,
@@ -169,7 +170,7 @@ namespace osu.Game.Overlays.Mods
                     Horizontal = 70
                 },
                 Spacing = new Vector2(10),
-                Children = CreateFooterButtons()
+                ChildrenEnumerable = CreateFooterButtons()
             };
         }
 
@@ -259,6 +260,12 @@ namespace osu.Game.Overlays.Mods
 
             MainAreaContent.FadeColour(customisationVisible.Value ? Colour4.Gray : Colour4.White, transition_duration, Easing.InOutCubic);
 
+            foreach (var button in footerButtonFlow)
+            {
+                if (button != customisationButton)
+                    button.Enabled.Value = !customisationVisible.Value;
+            }
+
             float modAreaHeight = customisationVisible.Value ? ModSettingsArea.HEIGHT : 0;
 
             modSettingsArea.ResizeHeightTo(modAreaHeight, transition_duration, Easing.InOutCubic);
diff --git a/osu.Game/Screens/OnlinePlay/FreeModSelectScreen.cs b/osu.Game/Screens/OnlinePlay/FreeModSelectScreen.cs
index 52ca28ce5d..6298e1f8c0 100644
--- a/osu.Game/Screens/OnlinePlay/FreeModSelectScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/FreeModSelectScreen.cs
@@ -2,6 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
+using System.Collections.Generic;
 using osu.Framework.Graphics;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Overlays.Mods;
@@ -27,7 +28,7 @@ namespace osu.Game.Screens.OnlinePlay
 
         protected override ModColumn CreateModColumn(ModType modType, Key[] toggleKeys = null) => new ModColumn(modType, true, toggleKeys);
 
-        protected override Drawable[] CreateFooterButtons() => new Drawable[]
+        protected override IEnumerable<ShearedButton> CreateFooterButtons() => new[]
         {
             new ShearedButton(200)
             {

From 6ad990dfc3a32d824c08e29ad5dc7d20410b14e4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 7 May 2022 10:17:24 +0200
Subject: [PATCH 4623/5547] Add basic localisation strings for new mod select

---
 osu.Game/Localisation/CommonStrings.cs        | 10 +++++++
 .../Localisation/ModSelectScreenStrings.cs    | 29 +++++++++++++++++++
 osu.Game/Overlays/Mods/ModSelectScreen.cs     |  9 +++---
 .../Screens/OnlinePlay/FreeModSelectScreen.cs |  5 ++--
 4 files changed, 47 insertions(+), 6 deletions(-)
 create mode 100644 osu.Game/Localisation/ModSelectScreenStrings.cs

diff --git a/osu.Game/Localisation/CommonStrings.cs b/osu.Game/Localisation/CommonStrings.cs
index 52e9811cf7..9cd626af0f 100644
--- a/osu.Game/Localisation/CommonStrings.cs
+++ b/osu.Game/Localisation/CommonStrings.cs
@@ -59,6 +59,16 @@ namespace osu.Game.Localisation
         /// </summary>
         public static LocalisableString Importing => new TranslatableString(getKey(@"importing"), @"Importing...");
 
+        /// <summary>
+        /// "Deselect All"
+        /// </summary>
+        public static LocalisableString DeselectAll => new TranslatableString(getKey(@"deselect_all"), @"Deselect All");
+
+        /// <summary>
+        /// "Select All"
+        /// </summary>
+        public static LocalisableString SelectAll => new TranslatableString(getKey(@"select_all"), @"Select All");
+
         private static string getKey(string key) => $@"{prefix}:{key}";
     }
 }
diff --git a/osu.Game/Localisation/ModSelectScreenStrings.cs b/osu.Game/Localisation/ModSelectScreenStrings.cs
new file mode 100644
index 0000000000..0c113fd381
--- /dev/null
+++ b/osu.Game/Localisation/ModSelectScreenStrings.cs
@@ -0,0 +1,29 @@
+// 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 ModSelectScreenStrings
+    {
+        private const string prefix = @"osu.Game.Resources.Localisation.ModSelectScreen";
+
+        /// <summary>
+        /// "Mod Select"
+        /// </summary>
+        public static LocalisableString ModSelectTitle => new TranslatableString(getKey(@"mod_select_title"), @"Mod Select");
+
+        /// <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.");
+
+        /// <summary>
+        /// "Mod Customisation"
+        /// </summary>
+        public static LocalisableString ModCustomisation => new TranslatableString(getKey(@"mod_customisation"), @"Mod Customisation");
+
+        private static string getKey(string key) => $@"{prefix}:{key}";
+    }
+}
\ No newline at end of file
diff --git a/osu.Game/Overlays/Mods/ModSelectScreen.cs b/osu.Game/Overlays/Mods/ModSelectScreen.cs
index e5b4927a6a..4a80a0637e 100644
--- a/osu.Game/Overlays/Mods/ModSelectScreen.cs
+++ b/osu.Game/Overlays/Mods/ModSelectScreen.cs
@@ -23,6 +23,7 @@ using osu.Game.Input.Bindings;
 using osu.Game.Rulesets.Mods;
 using osuTK;
 using osuTK.Input;
+using osu.Game.Localisation;
 
 namespace osu.Game.Overlays.Mods
 {
@@ -58,12 +59,12 @@ namespace osu.Game.Overlays.Mods
         {
             customisationButton = new ShearedToggleButton(200)
             {
-                Text = "Mod Customisation",
+                Text = ModSelectScreenStrings.ModCustomisation,
                 Active = { BindTarget = customisationVisible }
             },
             new ShearedButton(200)
             {
-                Text = "Deselect All",
+                Text = CommonStrings.DeselectAll,
                 Action = DeselectAll
             }
         };
@@ -80,8 +81,8 @@ namespace osu.Game.Overlays.Mods
         [BackgroundDependencyLoader]
         private void load()
         {
-            Header.Title = "Mod Select";
-            Header.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.";
+            Header.Title = ModSelectScreenStrings.ModSelectTitle;
+            Header.Description = ModSelectScreenStrings.ModSelectDescription;
 
             AddRange(new Drawable[]
             {
diff --git a/osu.Game/Screens/OnlinePlay/FreeModSelectScreen.cs b/osu.Game/Screens/OnlinePlay/FreeModSelectScreen.cs
index 6298e1f8c0..5a7fe8a778 100644
--- a/osu.Game/Screens/OnlinePlay/FreeModSelectScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/FreeModSelectScreen.cs
@@ -8,6 +8,7 @@ using osu.Game.Graphics.UserInterface;
 using osu.Game.Overlays.Mods;
 using osu.Game.Rulesets.Mods;
 using osuTK.Input;
+using osu.Game.Localisation;
 
 namespace osu.Game.Screens.OnlinePlay
 {
@@ -34,14 +35,14 @@ namespace osu.Game.Screens.OnlinePlay
             {
                 Anchor = Anchor.BottomLeft,
                 Origin = Anchor.BottomLeft,
-                Text = "Select All",
+                Text = CommonStrings.SelectAll,
                 Action = SelectAll
             },
             new ShearedButton(200)
             {
                 Anchor = Anchor.BottomLeft,
                 Origin = Anchor.BottomLeft,
-                Text = "Deselect All",
+                Text = CommonStrings.DeselectAll,
                 Action = DeselectAll
             }
         };

From 271d64fd545deaa4fb42eb6d6464b7283d55f871 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 6 May 2022 22:30:07 +0200
Subject: [PATCH 4624/5547] Add back button to mod select overlays

---
 osu.Game/Overlays/Mods/ModSelectScreen.cs | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Overlays/Mods/ModSelectScreen.cs b/osu.Game/Overlays/Mods/ModSelectScreen.cs
index 4a80a0637e..2af65d89b5 100644
--- a/osu.Game/Overlays/Mods/ModSelectScreen.cs
+++ b/osu.Game/Overlays/Mods/ModSelectScreen.cs
@@ -79,7 +79,7 @@ namespace osu.Game.Overlays.Mods
         private FillFlowContainer<ShearedButton> footerButtonFlow = null!;
 
         [BackgroundDependencyLoader]
-        private void load()
+        private void load(OsuColour colours)
         {
             Header.Title = ModSelectScreenStrings.ModSelectTitle;
             Header.Description = ModSelectScreenStrings.ModSelectDescription;
@@ -171,7 +171,13 @@ namespace osu.Game.Overlays.Mods
                     Horizontal = 70
                 },
                 Spacing = new Vector2(10),
-                ChildrenEnumerable = CreateFooterButtons()
+                ChildrenEnumerable = CreateFooterButtons().Prepend(new ShearedButton(200)
+                {
+                    Text = CommonStrings.Back,
+                    Action = Hide,
+                    DarkerColour = colours.Pink2,
+                    LighterColour = colours.Pink1
+                })
             };
         }
 

From 1c029552d7c9308f05969bb640c7adec2f51a889 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 7 May 2022 10:23:49 +0200
Subject: [PATCH 4625/5547] Add test coverage for mod select back button

---
 .../UserInterface/TestSceneModSelectScreen.cs | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs
index 9e0c8206b7..42ffeba444 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs
@@ -432,6 +432,25 @@ namespace osu.Game.Tests.Visual.UserInterface
             AddUntilStep("all mods deselected", () => !SelectedMods.Value.Any());
         }
 
+        [Test]
+        public void TestCloseViaBackButton()
+        {
+            createScreen();
+            changeRuleset(0);
+
+            AddStep("select difficulty adjust", () => SelectedMods.Value = new Mod[] { new OsuModDifficultyAdjust() });
+            assertCustomisationToggleState(disabled: false, active: true);
+            AddAssert("back button disabled", () => !this.ChildrenOfType<ShearedButton>().First().Enabled.Value);
+
+            AddStep("dismiss customisation area", () => InputManager.Key(Key.Escape));
+            AddStep("click back button", () =>
+            {
+                InputManager.MoveMouseTo(this.ChildrenOfType<ShearedButton>().First());
+                InputManager.Click(MouseButton.Left);
+            });
+            AddAssert("mod select hidden", () => modSelectScreen.State.Value == Visibility.Hidden);
+        }
+
         private void waitForColumnLoad() => AddUntilStep("all column content loaded",
             () => modSelectScreen.ChildrenOfType<ModColumn>().Any() && modSelectScreen.ChildrenOfType<ModColumn>().All(column => column.IsLoaded && column.ItemsLoaded));
 

From 9d3e67b10dbf9b6fc27405a50023f735a95d16fd Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 7 May 2022 10:25:23 +0200
Subject: [PATCH 4626/5547] Update free mod select/deselect all test after back
 button addition

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

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneFreeModSelectScreen.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneFreeModSelectScreen.cs
index a02055d960..4eb14542ba 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneFreeModSelectScreen.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneFreeModSelectScreen.cs
@@ -62,7 +62,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             AddStep("click select all button", () =>
             {
-                InputManager.MoveMouseTo(this.ChildrenOfType<ShearedButton>().First());
+                InputManager.MoveMouseTo(this.ChildrenOfType<ShearedButton>().ElementAt(1));
                 InputManager.Click(MouseButton.Left);
             });
             AddUntilStep("all mods selected", assertAllAvailableModsSelected);

From fa0a256f4843f4cd5c3cbfcf1737e613f2ff856a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 7 May 2022 10:48:15 +0200
Subject: [PATCH 4627/5547] Add localisable string for difficulty multiplier
 display

---
 .../DifficultyMultiplierDisplayStrings.cs     | 19 +++++++++++++++++++
 .../Mods/DifficultyMultiplierDisplay.cs       |  3 ++-
 2 files changed, 21 insertions(+), 1 deletion(-)
 create mode 100644 osu.Game/Localisation/DifficultyMultiplierDisplayStrings.cs

diff --git a/osu.Game/Localisation/DifficultyMultiplierDisplayStrings.cs b/osu.Game/Localisation/DifficultyMultiplierDisplayStrings.cs
new file mode 100644
index 0000000000..c281d90190
--- /dev/null
+++ b/osu.Game/Localisation/DifficultyMultiplierDisplayStrings.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 DifficultyMultiplierDisplayStrings
+    {
+        private const string prefix = @"osu.Game.Resources.Localisation.DifficultyMultiplierDisplay";
+
+        /// <summary>
+        /// "Difficulty Multiplier"
+        /// </summary>
+        public static LocalisableString DifficultyMultiplier => new TranslatableString(getKey(@"difficulty_multiplier"), @"Difficulty Multiplier");
+
+        private static string getKey(string key) => $@"{prefix}:{key}";
+    }
+}
\ No newline at end of file
diff --git a/osu.Game/Overlays/Mods/DifficultyMultiplierDisplay.cs b/osu.Game/Overlays/Mods/DifficultyMultiplierDisplay.cs
index 1d848fe456..4ccec0dd87 100644
--- a/osu.Game/Overlays/Mods/DifficultyMultiplierDisplay.cs
+++ b/osu.Game/Overlays/Mods/DifficultyMultiplierDisplay.cs
@@ -15,6 +15,7 @@ using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Rulesets.Mods;
 using osuTK;
+using osu.Game.Localisation;
 
 namespace osu.Game.Overlays.Mods
 {
@@ -99,7 +100,7 @@ namespace osu.Game.Overlays.Mods
                                             Origin = Anchor.Centre,
                                             Margin = new MarginPadding { Horizontal = 18 },
                                             Shear = new Vector2(-ShearedOverlayContainer.SHEAR, 0),
-                                            Text = "Difficulty Multiplier",
+                                            Text = DifficultyMultiplierDisplayStrings.DifficultyMultiplier,
                                             Font = OsuFont.Default.With(size: 17, weight: FontWeight.SemiBold)
                                         }
                                     }

From f761d4d4d4060597ff01624f513c849090b9160b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 7 May 2022 10:56:03 +0200
Subject: [PATCH 4628/5547] Reuse "select/deselect all" localisable string on
 column toggle

---
 osu.Game/Overlays/Mods/ModColumn.cs | 16 +++++++++++++++-
 1 file changed, 15 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/Mods/ModColumn.cs b/osu.Game/Overlays/Mods/ModColumn.cs
index 07871663a6..cbd036c71f 100644
--- a/osu.Game/Overlays/Mods/ModColumn.cs
+++ b/osu.Game/Overlays/Mods/ModColumn.cs
@@ -5,6 +5,7 @@
 
 using System;
 using System.Collections.Generic;
+using System.Diagnostics;
 using System.Linq;
 using System.Threading;
 using System.Threading.Tasks;
@@ -22,6 +23,7 @@ using osu.Framework.Input.Events;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.UserInterface;
+using osu.Game.Localisation;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Utils;
 using osuTK;
@@ -220,7 +222,6 @@ namespace osu.Game.Overlays.Mods
                     Origin = Anchor.CentreLeft,
                     Scale = new Vector2(0.8f),
                     RelativeSizeAxes = Axes.X,
-                    LabelText = "Enable All",
                     Shear = new Vector2(-ShearedOverlayContainer.SHEAR, 0)
                 });
                 panelFlow.Padding = new MarginPadding
@@ -265,6 +266,19 @@ namespace osu.Game.Overlays.Mods
             contentBackground.Colour = colourProvider.Background4;
         }
 
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            toggleAllCheckbox?.Current.BindValueChanged(_ => updateToggleAllText(), true);
+        }
+
+        private void updateToggleAllText()
+        {
+            Debug.Assert(toggleAllCheckbox != null);
+            toggleAllCheckbox.LabelText = toggleAllCheckbox.Current.Value ? CommonStrings.DeselectAll : CommonStrings.SelectAll;
+        }
+
         private void updateLocalAvailableMods()
         {
             var newMods = ModUtils.FlattenMods(availableMods.Value.GetValueOrDefault(ModType) ?? Array.Empty<Mod>())

From fd75963ca2d4ce479ce1965ae81390b45cf68da3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 7 May 2022 11:01:05 +0200
Subject: [PATCH 4629/5547] Dismiss mod select if select binding is pressed

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

diff --git a/osu.Game/Overlays/Mods/ModSelectScreen.cs b/osu.Game/Overlays/Mods/ModSelectScreen.cs
index 7d0400aace..706222761d 100644
--- a/osu.Game/Overlays/Mods/ModSelectScreen.cs
+++ b/osu.Game/Overlays/Mods/ModSelectScreen.cs
@@ -384,7 +384,7 @@ namespace osu.Game.Overlays.Mods
                 return true;
             }
 
-            if (e.Action == Hotkey)
+            if (e.Action == Hotkey || e.Action == GlobalAction.Select)
             {
                 if (customisationVisible.Value)
                     customisationVisible.Value = false;

From 8ee3fdd0aaa9cd03339ed21576a2aaa080bc4ff3 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sat, 7 May 2022 12:15:11 +0300
Subject: [PATCH 4630/5547] Change mod scrolling behaviour to not scroll
 horizontally on columns/settings

---
 osu.Game/Overlays/Mods/ModColumn.cs           |  2 +-
 osu.Game/Overlays/Mods/ModSettingsArea.cs     |  2 +-
 .../Mods/NestedVerticalScrollContainer.cs     | 48 -------------------
 3 files changed, 2 insertions(+), 50 deletions(-)
 delete mode 100644 osu.Game/Overlays/Mods/NestedVerticalScrollContainer.cs

diff --git a/osu.Game/Overlays/Mods/ModColumn.cs b/osu.Game/Overlays/Mods/ModColumn.cs
index 07871663a6..1bc139a181 100644
--- a/osu.Game/Overlays/Mods/ModColumn.cs
+++ b/osu.Game/Overlays/Mods/ModColumn.cs
@@ -186,7 +186,7 @@ namespace osu.Game.Overlays.Mods
                                             },
                                             new Drawable[]
                                             {
-                                                new NestedVerticalScrollContainer
+                                                new OsuScrollContainer(Direction.Vertical)
                                                 {
                                                     RelativeSizeAxes = Axes.Both,
                                                     ClampExtension = 100,
diff --git a/osu.Game/Overlays/Mods/ModSettingsArea.cs b/osu.Game/Overlays/Mods/ModSettingsArea.cs
index 08f563f93e..f44e4bf07f 100644
--- a/osu.Game/Overlays/Mods/ModSettingsArea.cs
+++ b/osu.Game/Overlays/Mods/ModSettingsArea.cs
@@ -158,7 +158,7 @@ namespace osu.Game.Overlays.Mods
                         new[] { Empty() },
                         new Drawable[]
                         {
-                            new NestedVerticalScrollContainer
+                            new OsuScrollContainer(Direction.Vertical)
                             {
                                 RelativeSizeAxes = Axes.Both,
                                 ClampExtension = 100,
diff --git a/osu.Game/Overlays/Mods/NestedVerticalScrollContainer.cs b/osu.Game/Overlays/Mods/NestedVerticalScrollContainer.cs
deleted file mode 100644
index d27f97f3d2..0000000000
--- a/osu.Game/Overlays/Mods/NestedVerticalScrollContainer.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 enable
-
-using osu.Framework.Graphics;
-using osu.Framework.Input.Events;
-using osu.Game.Graphics.Containers;
-
-namespace osu.Game.Overlays.Mods
-{
-    /// <summary>
-    /// A scroll container that handles the case of vertically scrolling content inside a larger horizontally scrolling parent container.
-    /// </summary>
-    public class NestedVerticalScrollContainer : OsuScrollContainer
-    {
-        private ModSelectScreen.ColumnScrollContainer? parentScrollContainer;
-
-        protected override void LoadComplete()
-        {
-            base.LoadComplete();
-
-            parentScrollContainer = this.FindClosestParent<ModSelectScreen.ColumnScrollContainer>();
-        }
-
-        protected override bool OnScroll(ScrollEvent e)
-        {
-            if (parentScrollContainer == null)
-                return base.OnScroll(e);
-
-            bool topRightInView = parentScrollContainer.ScreenSpaceDrawQuad.Contains(ScreenSpaceDrawQuad.TopRight);
-            bool bottomLeftInView = parentScrollContainer.ScreenSpaceDrawQuad.Contains(ScreenSpaceDrawQuad.BottomLeft);
-
-            // If not completely on-screen, handle scroll but also allow parent to scroll at the same time (to hopefully bring our content into full view).
-            if (!topRightInView || !bottomLeftInView)
-                return false;
-
-            bool scrollingPastEnd = e.ScrollDelta.Y < 0 && IsScrolledToEnd();
-            bool scrollingPastStart = e.ScrollDelta.Y > 0 && Target <= 0;
-
-            // If at either of our extents, delegate scroll to the horizontal parent container.
-            if (scrollingPastStart || scrollingPastEnd)
-                return false;
-
-            return base.OnScroll(e);
-        }
-    }
-}

From d4c9de8596b88e268893892b36305048d1faa5ba Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sat, 7 May 2022 13:23:48 +0300
Subject: [PATCH 4631/5547] Move button width in mod select to constant

---
 osu.Game/Overlays/Mods/ModSelectScreen.cs          | 8 +++++---
 osu.Game/Screens/OnlinePlay/FreeModSelectScreen.cs | 4 ++--
 2 files changed, 7 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Overlays/Mods/ModSelectScreen.cs b/osu.Game/Overlays/Mods/ModSelectScreen.cs
index 2af65d89b5..a9af48fc06 100644
--- a/osu.Game/Overlays/Mods/ModSelectScreen.cs
+++ b/osu.Game/Overlays/Mods/ModSelectScreen.cs
@@ -29,6 +29,8 @@ namespace osu.Game.Overlays.Mods
 {
     public abstract class ModSelectScreen : ShearedOverlayContainer
     {
+        protected const int BUTTON_WIDTH = 200;
+
         protected override OverlayColourScheme ColourScheme => OverlayColourScheme.Green;
 
         [Cached]
@@ -57,12 +59,12 @@ namespace osu.Game.Overlays.Mods
 
         protected virtual IEnumerable<ShearedButton> CreateFooterButtons() => new[]
         {
-            customisationButton = new ShearedToggleButton(200)
+            customisationButton = new ShearedToggleButton(BUTTON_WIDTH)
             {
                 Text = ModSelectScreenStrings.ModCustomisation,
                 Active = { BindTarget = customisationVisible }
             },
-            new ShearedButton(200)
+            new ShearedButton(BUTTON_WIDTH)
             {
                 Text = CommonStrings.DeselectAll,
                 Action = DeselectAll
@@ -171,7 +173,7 @@ namespace osu.Game.Overlays.Mods
                     Horizontal = 70
                 },
                 Spacing = new Vector2(10),
-                ChildrenEnumerable = CreateFooterButtons().Prepend(new ShearedButton(200)
+                ChildrenEnumerable = CreateFooterButtons().Prepend(new ShearedButton(BUTTON_WIDTH)
                 {
                     Text = CommonStrings.Back,
                     Action = Hide,
diff --git a/osu.Game/Screens/OnlinePlay/FreeModSelectScreen.cs b/osu.Game/Screens/OnlinePlay/FreeModSelectScreen.cs
index 5a7fe8a778..6d241af043 100644
--- a/osu.Game/Screens/OnlinePlay/FreeModSelectScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/FreeModSelectScreen.cs
@@ -31,14 +31,14 @@ namespace osu.Game.Screens.OnlinePlay
 
         protected override IEnumerable<ShearedButton> CreateFooterButtons() => new[]
         {
-            new ShearedButton(200)
+            new ShearedButton(BUTTON_WIDTH)
             {
                 Anchor = Anchor.BottomLeft,
                 Origin = Anchor.BottomLeft,
                 Text = CommonStrings.SelectAll,
                 Action = SelectAll
             },
-            new ShearedButton(200)
+            new ShearedButton(BUTTON_WIDTH)
             {
                 Anchor = Anchor.BottomLeft,
                 Origin = Anchor.BottomLeft,

From a716f62a6a373ed4e37827c7790f2927e5b402c8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 7 May 2022 12:59:15 +0200
Subject: [PATCH 4632/5547] Flash back button when keyboard back binding is
 pressed

---
 osu.Game/Overlays/Mods/ModSelectScreen.cs | 13 +++++++++----
 1 file changed, 9 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Overlays/Mods/ModSelectScreen.cs b/osu.Game/Overlays/Mods/ModSelectScreen.cs
index a9af48fc06..8ec2260370 100644
--- a/osu.Game/Overlays/Mods/ModSelectScreen.cs
+++ b/osu.Game/Overlays/Mods/ModSelectScreen.cs
@@ -77,8 +77,10 @@ namespace osu.Game.Overlays.Mods
         private ModSettingsArea modSettingsArea = null!;
         private ColumnScrollContainer columnScroll = null!;
         private ColumnFlowContainer columnFlow = null!;
-        private ShearedToggleButton? customisationButton;
+
         private FillFlowContainer<ShearedButton> footerButtonFlow = null!;
+        private ShearedButton backButton = null!;
+        private ShearedToggleButton? customisationButton;
 
         [BackgroundDependencyLoader]
         private void load(OsuColour colours)
@@ -173,7 +175,7 @@ namespace osu.Game.Overlays.Mods
                     Horizontal = 70
                 },
                 Spacing = new Vector2(10),
-                ChildrenEnumerable = CreateFooterButtons().Prepend(new ShearedButton(BUTTON_WIDTH)
+                ChildrenEnumerable = CreateFooterButtons().Prepend(backButton = new ShearedButton(BUTTON_WIDTH)
                 {
                     Text = CommonStrings.Back,
                     Action = Hide,
@@ -364,9 +366,12 @@ namespace osu.Game.Overlays.Mods
 
         public override bool OnPressed(KeyBindingPressEvent<GlobalAction> e)
         {
-            if (e.Action == GlobalAction.Back && customisationVisible.Value)
+            if (e.Action == GlobalAction.Back)
             {
-                customisationVisible.Value = false;
+                if (customisationVisible.Value)
+                    customisationVisible.Value = false;
+                else
+                    backButton.TriggerClick();
                 return true;
             }
 

From 5d6d7bb324bab493478d8a843278362bfbdcc330 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 7 May 2022 13:10:03 +0200
Subject: [PATCH 4633/5547] Fix incorrect assert in multiplayer song select
 test scene

---
 .../Multiplayer/TestSceneMultiplayerMatchSongSelect.cs      | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs
index d170b12dc3..061fe5715b 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs
@@ -132,7 +132,11 @@ namespace osu.Game.Tests.Visual.Multiplayer
         private void assertHasFreeModButton(Type type, bool hasButton = true)
         {
             AddAssert($"{type.ReadableName()} {(hasButton ? "displayed" : "not displayed")} in freemod overlay",
-                () => this.ChildrenOfType<FreeModSelectScreen>().Single().ChildrenOfType<ModPanel>().All(b => b.Mod.GetType() != type));
+                () => this.ChildrenOfType<FreeModSelectScreen>()
+                          .Single()
+                          .ChildrenOfType<ModPanel>()
+                          .Where(panel => !panel.Filtered.Value)
+                          .All(b => b.Mod.GetType() != type));
         }
 
         private class TestMultiplayerMatchSongSelect : MultiplayerMatchSongSelect

From 0c2b4a6c0b189571cd175c21e195c9193b8d0f7b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 7 May 2022 15:44:22 +0200
Subject: [PATCH 4634/5547] Fix invalid `IsLoaded` check

Would fail when `availableMods` would be changed from a different thread
while the columns aren't loaded.
---
 osu.Game/Overlays/Mods/ModColumn.cs | 14 ++++++--------
 1 file changed, 6 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Overlays/Mods/ModColumn.cs b/osu.Game/Overlays/Mods/ModColumn.cs
index a1ad435733..346e62e5fa 100644
--- a/osu.Game/Overlays/Mods/ModColumn.cs
+++ b/osu.Game/Overlays/Mods/ModColumn.cs
@@ -250,9 +250,8 @@ namespace osu.Game.Overlays.Mods
         private void load(OsuGameBase game, OverlayColourProvider colourProvider, OsuColour colours)
         {
             availableMods.BindTo(game.AvailableMods);
-            // this `BindValueChanged` callback is intentionally here, to ensure that local available mods are constructed as early as possible.
-            // this is needed to make sure no external changes to mods are dropped while mod panels are asynchronously loading.
-            availableMods.BindValueChanged(_ => updateLocalAvailableMods(), true);
+            updateLocalAvailableMods(asyncLoadContent: false);
+            availableMods.BindValueChanged(_ => updateLocalAvailableMods(asyncLoadContent: true));
 
             headerBackground.Colour = accentColour = colours.ForModType(ModType);
 
@@ -279,7 +278,7 @@ namespace osu.Game.Overlays.Mods
             toggleAllCheckbox.LabelText = toggleAllCheckbox.Current.Value ? CommonStrings.DeselectAll : CommonStrings.SelectAll;
         }
 
-        private void updateLocalAvailableMods()
+        private void updateLocalAvailableMods(bool asyncLoadContent)
         {
             var newMods = ModUtils.FlattenMods(availableMods.Value.GetValueOrDefault(ModType) ?? Array.Empty<Mod>())
                                   .Select(m => m.DeepClone())
@@ -290,11 +289,10 @@ namespace osu.Game.Overlays.Mods
 
             localAvailableMods = newMods;
 
-            if (!IsLoaded)
-                // if we're coming from BDL, perform the first load synchronously to make sure everything is in place as early as possible.
-                onPanelsLoaded(createPanels());
-            else
+            if (asyncLoadContent)
                 asyncLoadPanels();
+            else
+                onPanelsLoaded(createPanels());
         }
 
         private CancellationTokenSource? cancellationTokenSource;

From 0d32bf91eb19af79e5d61bab685fced1f3d26d2e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 8 May 2022 01:30:21 +0900
Subject: [PATCH 4635/5547] Hardcode hide key handling in `ModSelectScreen`

---
 osu.Game/Overlays/Mods/ModSelectScreen.cs     | 33 +++++++++----------
 .../OnlinePlay/OnlinePlaySongSelect.cs        |  2 --
 osu.Game/Screens/Select/SongSelect.cs         |  5 +--
 3 files changed, 16 insertions(+), 24 deletions(-)

diff --git a/osu.Game/Overlays/Mods/ModSelectScreen.cs b/osu.Game/Overlays/Mods/ModSelectScreen.cs
index 3980f6f4b9..2a9e235364 100644
--- a/osu.Game/Overlays/Mods/ModSelectScreen.cs
+++ b/osu.Game/Overlays/Mods/ModSelectScreen.cs
@@ -20,11 +20,10 @@ using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 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 osuTK;
 using osuTK.Input;
-using osu.Game.Localisation;
 
 namespace osu.Game.Overlays.Mods
 {
@@ -49,15 +48,6 @@ namespace osu.Game.Overlays.Mods
             }
         }
 
-        /// <summary>
-        /// Hotkey that should be used to hide the mod select screen.
-        /// </summary>
-        /// <remarks>
-        /// This is handled locally here rather than via <see cref="FooterButtonMods"/>, because this overlay is being registered at the game level
-        /// and therefore takes away keyboard focus from the screen stack.
-        /// </remarks>
-        internal GlobalAction? Hotkey { get; set; }
-
         /// <summary>
         /// Whether the total score multiplier calculated from the current selected set of mods should be shown.
         /// </summary>
@@ -382,6 +372,8 @@ namespace osu.Game.Overlays.Mods
             if (e.Repeat)
                 return false;
 
+            // This is handled locally here because this overlay is being registered at the game level
+            // and therefore takes away keyboard focus from the screen stack.
             if (e.Action == GlobalAction.Back)
             {
                 if (customisationVisible.Value)
@@ -391,15 +383,20 @@ namespace osu.Game.Overlays.Mods
                 return true;
             }
 
-            if (e.Action == Hotkey || e.Action == GlobalAction.Select)
+            switch (e.Action)
             {
-                if (customisationVisible.Value)
-                    customisationVisible.Value = false;
-                Hide();
-                return true;
-            }
+                case GlobalAction.ToggleModSelection:
+                case GlobalAction.Select:
+                {
+                    if (customisationVisible.Value)
+                        customisationVisible.Value = false;
+                    Hide();
+                    return true;
+                }
 
-            return base.OnPressed(e);
+                default:
+                    return base.OnPressed(e);
+            }
         }
 
         internal class ColumnScrollContainer : OsuScrollContainer<ColumnFlowContainer>
diff --git a/osu.Game/Screens/OnlinePlay/OnlinePlaySongSelect.cs b/osu.Game/Screens/OnlinePlay/OnlinePlaySongSelect.cs
index 4b6c06481b..c4503773ad 100644
--- a/osu.Game/Screens/OnlinePlay/OnlinePlaySongSelect.cs
+++ b/osu.Game/Screens/OnlinePlay/OnlinePlaySongSelect.cs
@@ -12,7 +12,6 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Screens;
 using osu.Game.Beatmaps;
-using osu.Game.Input.Bindings;
 using osu.Game.Online.API;
 using osu.Game.Online.Rooms;
 using osu.Game.Overlays;
@@ -163,7 +162,6 @@ namespace osu.Game.Screens.OnlinePlay
 
         protected override ModSelectScreen CreateModSelectOverlay() => new UserModSelectScreen(OverlayColourScheme.Plum)
         {
-            Hotkey = GlobalAction.ToggleModSelection,
             IsValidMod = IsValidMod
         };
 
diff --git a/osu.Game/Screens/Select/SongSelect.cs b/osu.Game/Screens/Select/SongSelect.cs
index 7317b20f88..eb5e996972 100644
--- a/osu.Game/Screens/Select/SongSelect.cs
+++ b/osu.Game/Screens/Select/SongSelect.cs
@@ -333,10 +333,7 @@ namespace osu.Game.Screens.Select
             (new FooterButtonOptions(), BeatmapOptions)
         };
 
-        protected virtual ModSelectScreen CreateModSelectOverlay() => new UserModSelectScreen
-        {
-            Hotkey = GlobalAction.ToggleModSelection
-        };
+        protected virtual ModSelectScreen CreateModSelectOverlay() => new UserModSelectScreen();
 
         protected virtual void ApplyFilterToCarousel(FilterCriteria criteria)
         {

From 1d27ef18dc7d4a02aea655aa357ed8f62ec8a6ea Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 8 May 2022 01:49:29 +0900
Subject: [PATCH 4636/5547] Add xmldoc for `IsValidMod`

---
 osu.Game/Overlays/Mods/ModColumn.cs       | 2 +-
 osu.Game/Overlays/Mods/ModSelectScreen.cs | 5 +++++
 2 files changed, 6 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/Mods/ModColumn.cs b/osu.Game/Overlays/Mods/ModColumn.cs
index 346e62e5fa..f0741cdc40 100644
--- a/osu.Game/Overlays/Mods/ModColumn.cs
+++ b/osu.Game/Overlays/Mods/ModColumn.cs
@@ -41,7 +41,7 @@ namespace osu.Game.Overlays.Mods
         private Func<Mod, bool>? filter;
 
         /// <summary>
-        /// Function determining whether each mod in the column should be displayed.
+        /// 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.
         /// A return value of <see langword="false"/> means that the mod is filtered out and therefore its corresponding panel should be hidden.
         /// </summary>
diff --git a/osu.Game/Overlays/Mods/ModSelectScreen.cs b/osu.Game/Overlays/Mods/ModSelectScreen.cs
index 2a9e235364..8098e8b0f6 100644
--- a/osu.Game/Overlays/Mods/ModSelectScreen.cs
+++ b/osu.Game/Overlays/Mods/ModSelectScreen.cs
@@ -36,6 +36,11 @@ namespace osu.Game.Overlays.Mods
 
         private Func<Mod, bool> isValidMod = m => true;
 
+        /// <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.
+        /// A return value of <see langword="false"/> means that the mod is filtered out and therefore its corresponding panel should be hidden.
+        /// </summary>
         public Func<Mod, bool> IsValidMod
         {
             get => isValidMod;

From 03c80d91978988229b338c4056ef3a7f6d282702 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 8 May 2022 01:58:37 +0900
Subject: [PATCH 4637/5547] Reorder methods / properties in `ModSelectScreen`
 for legibility

---
 osu.Game/Overlays/Mods/ModSelectScreen.cs | 86 ++++++++++++++---------
 1 file changed, 52 insertions(+), 34 deletions(-)

diff --git a/osu.Game/Overlays/Mods/ModSelectScreen.cs b/osu.Game/Overlays/Mods/ModSelectScreen.cs
index 8098e8b0f6..ef96811144 100644
--- a/osu.Game/Overlays/Mods/ModSelectScreen.cs
+++ b/osu.Game/Overlays/Mods/ModSelectScreen.cs
@@ -60,29 +60,20 @@ namespace osu.Game.Overlays.Mods
 
         protected virtual ModColumn CreateModColumn(ModType modType, Key[]? toggleKeys = null) => new ModColumn(modType, false, toggleKeys);
 
-        protected virtual IEnumerable<ShearedButton> CreateFooterButtons() => new[]
-        {
-            customisationButton = new ShearedToggleButton(BUTTON_WIDTH)
-            {
-                Text = ModSelectScreenStrings.ModCustomisation,
-                Active = { BindTarget = customisationVisible }
-            },
-            new ShearedButton(BUTTON_WIDTH)
-            {
-                Text = CommonStrings.DeselectAll,
-                Action = DeselectAll
-            }
-        };
+        protected virtual IReadOnlyList<Mod> ComputeNewModsFromSelection(IReadOnlyList<Mod> oldSelection, IReadOnlyList<Mod> newSelection) => newSelection;
+
+        protected virtual IEnumerable<ShearedButton> CreateFooterButtons() => createDefaultFooterButtons();
 
         private readonly BindableBool customisationVisible = new BindableBool();
 
-        private DifficultyMultiplierDisplay? multiplierDisplay;
         private ModSettingsArea modSettingsArea = null!;
         private ColumnScrollContainer columnScroll = null!;
         private ColumnFlowContainer columnFlow = null!;
-
         private FillFlowContainer<ShearedButton> footerButtonFlow = null!;
         private ShearedButton backButton = null!;
+
+        private DifficultyMultiplierDisplay? multiplierDisplay;
+
         private ShearedToggleButton? customisationButton;
 
         protected ModSelectScreen(OverlayColourScheme colourScheme = OverlayColourScheme.Green)
@@ -193,14 +184,6 @@ namespace osu.Game.Overlays.Mods
             };
         }
 
-        private ColumnDimContainer createModColumnContent(ModType modType, Key[]? toggleKeys = null)
-            => new ColumnDimContainer(CreateModColumn(modType, toggleKeys))
-            {
-                AutoSizeAxes = Axes.X,
-                RelativeSizeAxes = Axes.Y,
-                RequestScroll = column => columnScroll.ScrollIntoView(column, extraScroll: 140)
-            };
-
         protected override void LoadComplete()
         {
             base.LoadComplete();
@@ -224,6 +207,47 @@ namespace osu.Game.Overlays.Mods
             updateAvailableMods();
         }
 
+        /// <summary>
+        /// Select all visible mods in all columns.
+        /// </summary>
+        protected void SelectAll()
+        {
+            foreach (var column in columnFlow.Columns)
+                column.SelectAll();
+        }
+
+        /// <summary>
+        /// Deselect all visible mods in all columns.
+        /// </summary>
+        protected void DeselectAll()
+        {
+            foreach (var column in columnFlow.Columns)
+                column.DeselectAll();
+        }
+
+        private ColumnDimContainer createModColumnContent(ModType modType, Key[]? toggleKeys = null)
+            => new ColumnDimContainer(CreateModColumn(modType, toggleKeys))
+            {
+                AutoSizeAxes = Axes.X,
+                RelativeSizeAxes = Axes.Y,
+                RequestScroll = column => columnScroll.ScrollIntoView(column, extraScroll: 140)
+            };
+
+        private ShearedButton[] createDefaultFooterButtons()
+            => new[]
+            {
+                customisationButton = new ShearedToggleButton(BUTTON_WIDTH)
+                {
+                    Text = ModSelectScreenStrings.ModCustomisation,
+                    Active = { BindTarget = customisationVisible }
+                },
+                new ShearedButton(BUTTON_WIDTH)
+                {
+                    Text = CommonStrings.DeselectAll,
+                    Action = DeselectAll
+                }
+            };
+
         private void updateMultiplier()
         {
             if (multiplierDisplay == null)
@@ -314,7 +338,7 @@ namespace osu.Game.Overlays.Mods
             SelectedMods.Value = ComputeNewModsFromSelection(SelectedMods.Value, candidateSelection);
         }
 
-        protected virtual IReadOnlyList<Mod> ComputeNewModsFromSelection(IReadOnlyList<Mod> oldSelection, IReadOnlyList<Mod> newSelection) => newSelection;
+        #region Transition handling
 
         protected override void PopIn()
         {
@@ -360,17 +384,9 @@ namespace osu.Game.Overlays.Mods
             }
         }
 
-        protected void SelectAll()
-        {
-            foreach (var column in columnFlow.Columns)
-                column.SelectAll();
-        }
+        #endregion
 
-        protected void DeselectAll()
-        {
-            foreach (var column in columnFlow.Columns)
-                column.DeselectAll();
-        }
+        #region Input handling
 
         public override bool OnPressed(KeyBindingPressEvent<GlobalAction> e)
         {
@@ -404,6 +420,8 @@ namespace osu.Game.Overlays.Mods
             }
         }
 
+        #endregion
+
         internal class ColumnScrollContainer : OsuScrollContainer<ColumnFlowContainer>
         {
             public ColumnScrollContainer()

From 2278da563e95e26f4ed6718b6441067df7f67463 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 8 May 2022 02:03:28 +0900
Subject: [PATCH 4638/5547] Add various xmldoc for nested classes

---
 osu.Game/Overlays/Mods/ModSelectScreen.cs | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/osu.Game/Overlays/Mods/ModSelectScreen.cs b/osu.Game/Overlays/Mods/ModSelectScreen.cs
index ef96811144..0a1b4e857e 100644
--- a/osu.Game/Overlays/Mods/ModSelectScreen.cs
+++ b/osu.Game/Overlays/Mods/ModSelectScreen.cs
@@ -422,6 +422,9 @@ namespace osu.Game.Overlays.Mods
 
         #endregion
 
+        /// <summary>
+        /// Manages horizontal scrolling of mod columns, along with the "active" states of each column based on visibility.
+        /// </summary>
         internal class ColumnScrollContainer : OsuScrollContainer<ColumnFlowContainer>
         {
             public ColumnScrollContainer()
@@ -460,6 +463,9 @@ namespace osu.Game.Overlays.Mods
             }
         }
 
+        /// <summary>
+        /// Manages padding and layout of mod columns.
+        /// </summary>
         internal class ColumnFlowContainer : FillFlowContainer<ColumnDimContainer>
         {
             public IEnumerable<ModColumn> Columns => Children.Select(dimWrapper => dimWrapper.Column);
@@ -496,11 +502,21 @@ namespace osu.Game.Overlays.Mods
             }
         }
 
+        /// <summary>
+        /// Encapsulates a column and provides dim and input blocking based on an externally managed "active" state.
+        /// </summary>
         internal class ColumnDimContainer : Container
         {
             public ModColumn Column { get; }
 
+            /// <summary>
+            /// Tracks whether this column is in an interactive state. Generally only the case when the column is on-screen.
+            /// </summary>
             public readonly Bindable<bool> Active = new BindableBool();
+
+            /// <summary>
+            /// Invoked when the column is clicked while not active, requesting a scroll to be performed to bring it on-screen.
+            /// </summary>
             public Action<ColumnDimContainer>? RequestScroll { get; set; }
 
             [Resolved]
@@ -555,6 +571,9 @@ namespace osu.Game.Overlays.Mods
             }
         }
 
+        /// <summary>
+        /// A container which blocks and handles input, managing the "return from customisation" state change.
+        /// </summary>
         private class ClickToReturnContainer : Container
         {
             public BindableBool HandleMouse { get; } = new BindableBool();

From 46d3220c07ea99d4ef4dc67756ddee5d781f06a6 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 7 May 2022 21:20:00 +0200
Subject: [PATCH 4639/5547] Isolate sample screens from global mods bindable

Fixes scenario wherein entering the first run setup overlay, exiting at
the "UI scale" step (which shows a song select), then moving to actua
song select and trying to select a mod would lead to a crash.

The crash was caused by two active mod screen instances attempting to
swap the global mod bindable's mod instances for ones they owned. This
logic - while generally problematic and hard to maintain - was fixing
several issues with mod reference management and setting copying, so I'm
letting it live another day.

This change will mean that the song select preview on the "UI scale"
step will not receive the same mods that the actual game has enabled.
That said, it already doesn't use the same beatmap or ruleset, so this
looks fine to break.
---
 osu.Game/Overlays/FirstRunSetup/ScreenUIScale.cs | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/osu.Game/Overlays/FirstRunSetup/ScreenUIScale.cs b/osu.Game/Overlays/FirstRunSetup/ScreenUIScale.cs
index 862506add2..152d67ab27 100644
--- a/osu.Game/Overlays/FirstRunSetup/ScreenUIScale.cs
+++ b/osu.Game/Overlays/FirstRunSetup/ScreenUIScale.cs
@@ -2,6 +2,7 @@
 // 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.Audio;
@@ -19,6 +20,7 @@ using osu.Game.Graphics.UserInterface;
 using osu.Game.Localisation;
 using osu.Game.Overlays.Settings;
 using osu.Game.Rulesets;
+using osu.Game.Rulesets.Mods;
 using osu.Game.Screens;
 using osu.Game.Screens.Menu;
 using osu.Game.Screens.Select;
@@ -131,6 +133,10 @@ namespace osu.Game.Overlays.FirstRunSetup
             [Cached(typeof(IBindable<WorkingBeatmap>))]
             protected Bindable<WorkingBeatmap> Beatmap { get; private set; } = new Bindable<WorkingBeatmap>();
 
+            [Cached]
+            [Cached(typeof(IBindable<IReadOnlyList<Mod>>))]
+            protected Bindable<IReadOnlyList<Mod>> SelectedMods { get; private set; } = new Bindable<IReadOnlyList<Mod>>(Array.Empty<Mod>());
+
             public override bool HandlePositionalInput => false;
             public override bool HandleNonPositionalInput => false;
             public override bool PropagatePositionalInputSubTree => false;

From 836de491353212ed8acc533437ac72b1c349af38 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 7 May 2022 22:41:48 +0200
Subject: [PATCH 4640/5547] Adjust skin editor scene library test for
 extensibility

---
 .../TestSceneSkinEditorSceneLibrary.cs        | 25 +++++++++++++------
 1 file changed, 18 insertions(+), 7 deletions(-)

diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneSkinEditorSceneLibrary.cs b/osu.Game.Tests/Visual/Navigation/TestSceneSkinEditorSceneLibrary.cs
index d3aeba2c0f..3e6cf325df 100644
--- a/osu.Game.Tests/Visual/Navigation/TestSceneSkinEditorSceneLibrary.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneSkinEditorSceneLibrary.cs
@@ -20,20 +20,21 @@ namespace osu.Game.Tests.Visual.Navigation
 {
     public class TestSceneSkinEditorSceneLibrary : OsuGameTestScene
     {
-        private SkinEditor skinEditor;
+        private TestPlaySongSelect songSelect;
+        private SkinEditor skinEditor => Game.ChildrenOfType<SkinEditor>().FirstOrDefault();
 
-        public override void SetUpSteps()
+        private void advanceToSongSelect()
         {
-            base.SetUpSteps();
-
-            Screens.Select.SongSelect songSelect = null;
             PushAndConfirm(() => songSelect = new TestPlaySongSelect());
             AddUntilStep("wait for song select", () => songSelect.BeatmapSetsLoaded);
 
             AddStep("import beatmap", () => BeatmapImportHelper.LoadQuickOszIntoOsu(Game).WaitSafely());
 
             AddUntilStep("wait for selected", () => !Game.Beatmap.IsDefault);
+        }
 
+        private void openSkinEditor()
+        {
             AddStep("open skin editor", () =>
             {
                 InputManager.PressKey(Key.ControlLeft);
@@ -42,13 +43,15 @@ namespace osu.Game.Tests.Visual.Navigation
                 InputManager.ReleaseKey(Key.ControlLeft);
                 InputManager.ReleaseKey(Key.ShiftLeft);
             });
-
-            AddUntilStep("get skin editor", () => (skinEditor = Game.ChildrenOfType<SkinEditor>().FirstOrDefault()) != null);
+            AddUntilStep("skin editor loaded", () => skinEditor != null);
         }
 
         [Test]
         public void TestEditComponentDuringGameplay()
         {
+            advanceToSongSelect();
+            openSkinEditor();
+
             switchToGameplayScene();
 
             BarHitErrorMeter hitErrorMeter = null;
@@ -85,6 +88,8 @@ namespace osu.Game.Tests.Visual.Navigation
         [Test]
         public void TestAutoplayCompatibleModsRetainedOnEnteringGameplay()
         {
+            advanceToSongSelect();
+            openSkinEditor();
             AddStep("select DT", () => Game.SelectedMods.Value = new Mod[] { new OsuModDoubleTime() });
 
             switchToGameplayScene();
@@ -95,6 +100,8 @@ namespace osu.Game.Tests.Visual.Navigation
         [Test]
         public void TestAutoplayIncompatibleModsRemovedOnEnteringGameplay()
         {
+            advanceToSongSelect();
+            openSkinEditor();
             AddStep("select no fail and spun out", () => Game.SelectedMods.Value = new Mod[] { new OsuModNoFail(), new OsuModSpunOut() });
 
             switchToGameplayScene();
@@ -105,6 +112,8 @@ namespace osu.Game.Tests.Visual.Navigation
         [Test]
         public void TestDuplicateAutoplayModRemovedOnEnteringGameplay()
         {
+            advanceToSongSelect();
+            openSkinEditor();
             AddStep("select autoplay", () => Game.SelectedMods.Value = new Mod[] { new OsuModAutoplay() });
 
             switchToGameplayScene();
@@ -115,6 +124,8 @@ namespace osu.Game.Tests.Visual.Navigation
         [Test]
         public void TestCinemaModRemovedOnEnteringGameplay()
         {
+            advanceToSongSelect();
+            openSkinEditor();
             AddStep("select cinema", () => Game.SelectedMods.Value = new Mod[] { new OsuModCinema() });
 
             switchToGameplayScene();

From a3e61fddcb06c21ed7e12d7af61bd9a7d03a260c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 7 May 2022 22:43:45 +0200
Subject: [PATCH 4641/5547] Rename skin editor scene library test scene to be
 more general

---
 ...inEditorSceneLibrary.cs => TestSceneSkinEditorNavigation.cs} | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
 rename osu.Game.Tests/Visual/Navigation/{TestSceneSkinEditorSceneLibrary.cs => TestSceneSkinEditorNavigation.cs} (98%)

diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneSkinEditorSceneLibrary.cs b/osu.Game.Tests/Visual/Navigation/TestSceneSkinEditorNavigation.cs
similarity index 98%
rename from osu.Game.Tests/Visual/Navigation/TestSceneSkinEditorSceneLibrary.cs
rename to osu.Game.Tests/Visual/Navigation/TestSceneSkinEditorNavigation.cs
index 3e6cf325df..5359d992a1 100644
--- a/osu.Game.Tests/Visual/Navigation/TestSceneSkinEditorSceneLibrary.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneSkinEditorNavigation.cs
@@ -18,7 +18,7 @@ using static osu.Game.Tests.Visual.Navigation.TestSceneScreenNavigation;
 
 namespace osu.Game.Tests.Visual.Navigation
 {
-    public class TestSceneSkinEditorSceneLibrary : OsuGameTestScene
+    public class TestSceneSkinEditorNavigation : OsuGameTestScene
     {
         private TestPlaySongSelect songSelect;
         private SkinEditor skinEditor => Game.ChildrenOfType<SkinEditor>().FirstOrDefault();

From bdea6d865443e51e2ae927b01d3f347473364907 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 7 May 2022 22:47:19 +0200
Subject: [PATCH 4642/5547] Add failing test for mod overlay not closing on
 entering skin editor

---
 .../Navigation/TestSceneSkinEditorNavigation.cs       | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneSkinEditorNavigation.cs b/osu.Game.Tests/Visual/Navigation/TestSceneSkinEditorNavigation.cs
index 5359d992a1..68c44f49cc 100644
--- a/osu.Game.Tests/Visual/Navigation/TestSceneSkinEditorNavigation.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneSkinEditorNavigation.cs
@@ -4,6 +4,7 @@
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Extensions;
+using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.UserInterface;
 using osu.Framework.Testing;
 using osu.Game.Overlays.Settings;
@@ -133,6 +134,16 @@ namespace osu.Game.Tests.Visual.Navigation
             AddAssert("no mod selected", () => !((Player)Game.ScreenStack.CurrentScreen).Mods.Value.Any());
         }
 
+        [Test]
+        public void TestModOverlayClosesOnOpeningSkinEditor()
+        {
+            advanceToSongSelect();
+            AddStep("open mod overlay", () => songSelect.ModSelectOverlay.Show());
+
+            openSkinEditor();
+            AddUntilStep("mod overlay closed", () => songSelect.ModSelectOverlay.State.Value == Visibility.Hidden);
+        }
+
         private void switchToGameplayScene()
         {
             AddStep("Click gameplay scene button", () => skinEditor.ChildrenOfType<SkinEditorSceneLibrary.SceneButton>().First(b => b.Text == "Gameplay").TriggerClick());

From a45ca2ad101957b9e00560a0b66a01508e724168 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 7 May 2022 22:50:10 +0200
Subject: [PATCH 4643/5547] Fix focused overlays not registering as such

Also fixes bug wherein opening skin editor at song select with mod
select open would show mod select on top of the skin editor.
---
 osu.Game/OsuGame.cs | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index c2a96a9082..54c4231b06 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -201,6 +201,10 @@ namespace osu.Game
 
             externalOverlays.Add(overlayContainer);
             overlayContent.Add(overlayContainer);
+
+            if (overlayContainer is OsuFocusedOverlayContainer focusedOverlayContainer)
+                focusedOverlays.Add(focusedOverlayContainer);
+
             return new InvokeOnDisposal(() => unregisterBlockingOverlay(overlayContainer));
         }
 
@@ -223,6 +227,10 @@ namespace osu.Game
         private void unregisterBlockingOverlay(OverlayContainer overlayContainer)
         {
             externalOverlays.Remove(overlayContainer);
+
+            if (overlayContainer is OsuFocusedOverlayContainer focusedOverlayContainer)
+                focusedOverlays.Remove(focusedOverlayContainer);
+
             overlayContainer.Expire();
         }
 

From bec28c5b28219a9eccfedeed3818e97d41c291ea Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Sat, 7 May 2022 22:16:11 +0100
Subject: [PATCH 4644/5547] Remove virtual `ColourInfo` properties from
 `DaySeparator`

---
 osu.Game/Online/Chat/StandAloneChatDisplay.cs |  3 +--
 osu.Game/Overlays/Chat/DrawableChannel.cs     | 18 +-----------------
 osu.Game/Overlays/ChatOverlayV2.cs            | 10 ++--------
 3 files changed, 4 insertions(+), 27 deletions(-)

diff --git a/osu.Game/Online/Chat/StandAloneChatDisplay.cs b/osu.Game/Online/Chat/StandAloneChatDisplay.cs
index c03cd938a5..ac6bc190ca 100644
--- a/osu.Game/Online/Chat/StandAloneChatDisplay.cs
+++ b/osu.Game/Online/Chat/StandAloneChatDisplay.cs
@@ -174,9 +174,8 @@ namespace osu.Game.Online.Chat
             protected override DaySeparator CreateDaySeparator(DateTimeOffset time) => new DaySeparator(time)
             {
                 TextSize = 14,
-                TextColour = daySepColour,
+                Colour = daySepColour,
                 LineHeight = 1,
-                LineColour = daySepColour,
                 Padding = new MarginPadding { Horizontal = 10 },
                 Margin = new MarginPadding { Vertical = 5 },
             };
diff --git a/osu.Game/Overlays/Chat/DrawableChannel.cs b/osu.Game/Overlays/Chat/DrawableChannel.cs
index 7e4e936bee..0dcb52c60a 100644
--- a/osu.Game/Overlays/Chat/DrawableChannel.cs
+++ b/osu.Game/Overlays/Chat/DrawableChannel.cs
@@ -9,7 +9,6 @@ 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.Shapes;
 using osu.Framework.Graphics.Sprites;
@@ -124,8 +123,7 @@ namespace osu.Game.Overlays.Chat
 
         protected virtual DaySeparator CreateDaySeparator(DateTimeOffset time) => new DaySeparator(time)
         {
-            TextColour = colours.ChatBlue.Lighten(0.7f),
-            LineColour = colours.ChatBlue.Lighten(0.7f),
+            Colour = colours.ChatBlue.Lighten(0.7f),
             Margin = new MarginPadding { Vertical = 10 },
         };
 
@@ -214,12 +212,6 @@ namespace osu.Game.Overlays.Chat
                 set => text.Font = text.Font.With(size: value);
             }
 
-            public ColourInfo TextColour
-            {
-                get => text.Colour;
-                set => text.Colour = value;
-            }
-
             private float lineHeight = 2;
 
             public float LineHeight
@@ -228,14 +220,6 @@ namespace osu.Game.Overlays.Chat
                 set => lineHeight = leftBox.Height = rightBox.Height = value;
             }
 
-            private ColourInfo lineColour;
-
-            public ColourInfo LineColour
-            {
-                get => lineColour;
-                set => lineColour = leftBox.Colour = rightBox.Colour = value;
-            }
-
             private readonly SpriteText text;
             private readonly Box leftBox;
             private readonly Box rightBox;
diff --git a/osu.Game/Overlays/ChatOverlayV2.cs b/osu.Game/Overlays/ChatOverlayV2.cs
index e1ac71a125..18a2f593dd 100644
--- a/osu.Game/Overlays/ChatOverlayV2.cs
+++ b/osu.Game/Overlays/ChatOverlayV2.cs
@@ -315,26 +315,20 @@ namespace osu.Game.Overlays
 
     public class ChatOverlayDrawableChannel : DrawableChannel
     {
-        private Colour4 daySepTextColour;
-        private Colour4 daySepLineColour;
-
         public ChatOverlayDrawableChannel(Channel channel)
             : base(channel)
         {
         }
 
         [BackgroundDependencyLoader]
-        private void load(OverlayColourProvider colourProvider)
+        private void load()
         {
             ChatLineFlow.Padding = new MarginPadding(0);
-            daySepTextColour = colourProvider.Content1;
-            daySepLineColour = colourProvider.Background5;
         }
 
         protected override DaySeparator CreateDaySeparator(DateTimeOffset time) => new DaySeparator(time)
         {
-            TextColour = daySepTextColour,
-            LineColour = daySepLineColour,
+            Colour = Colour4.White,
             Margin = new MarginPadding { Vertical = 10 },
             Padding = new MarginPadding { Horizontal = 15 },
         };

From f4acfbd0df4380f1ddf9800abae74135027119cf Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Sat, 7 May 2022 22:23:46 +0100
Subject: [PATCH 4645/5547] Change return type of `CreateDaySeparator` to
 `Drawable`

---
 osu.Game/Online/Chat/StandAloneChatDisplay.cs | 2 +-
 osu.Game/Overlays/Chat/DrawableChannel.cs     | 2 +-
 osu.Game/Overlays/ChatOverlayV2.cs            | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Online/Chat/StandAloneChatDisplay.cs b/osu.Game/Online/Chat/StandAloneChatDisplay.cs
index ac6bc190ca..79c4ed6068 100644
--- a/osu.Game/Online/Chat/StandAloneChatDisplay.cs
+++ b/osu.Game/Online/Chat/StandAloneChatDisplay.cs
@@ -171,7 +171,7 @@ namespace osu.Game.Online.Chat
 
             protected override ChatLine CreateChatLine(Message m) => CreateChatLineAction(m);
 
-            protected override DaySeparator CreateDaySeparator(DateTimeOffset time) => new DaySeparator(time)
+            protected override Drawable CreateDaySeparator(DateTimeOffset time) => new DaySeparator(time)
             {
                 TextSize = 14,
                 Colour = daySepColour,
diff --git a/osu.Game/Overlays/Chat/DrawableChannel.cs b/osu.Game/Overlays/Chat/DrawableChannel.cs
index 0dcb52c60a..f2d4a3e301 100644
--- a/osu.Game/Overlays/Chat/DrawableChannel.cs
+++ b/osu.Game/Overlays/Chat/DrawableChannel.cs
@@ -121,7 +121,7 @@ namespace osu.Game.Overlays.Chat
 
         protected virtual ChatLine CreateChatLine(Message m) => new ChatLine(m);
 
-        protected virtual DaySeparator CreateDaySeparator(DateTimeOffset time) => new DaySeparator(time)
+        protected virtual Drawable CreateDaySeparator(DateTimeOffset time) => new DaySeparator(time)
         {
             Colour = colours.ChatBlue.Lighten(0.7f),
             Margin = new MarginPadding { Vertical = 10 },
diff --git a/osu.Game/Overlays/ChatOverlayV2.cs b/osu.Game/Overlays/ChatOverlayV2.cs
index 18a2f593dd..1f2fb9724b 100644
--- a/osu.Game/Overlays/ChatOverlayV2.cs
+++ b/osu.Game/Overlays/ChatOverlayV2.cs
@@ -326,7 +326,7 @@ namespace osu.Game.Overlays
             ChatLineFlow.Padding = new MarginPadding(0);
         }
 
-        protected override DaySeparator CreateDaySeparator(DateTimeOffset time) => new DaySeparator(time)
+        protected override Drawable CreateDaySeparator(DateTimeOffset time) => new DaySeparator(time)
         {
             Colour = Colour4.White,
             Margin = new MarginPadding { Vertical = 10 },

From c0643cae751fa27e49b5929b2e3ffba0737604b9 Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Sat, 7 May 2022 23:24:34 +0100
Subject: [PATCH 4646/5547] Create `ChatOverlayDaySeparator` and use in
 `ChatOverlayDrawableChannel`

---
 osu.Game/Overlays/ChatOverlayV2.cs | 59 +++++++++++++++++++++++++++---
 1 file changed, 54 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Overlays/ChatOverlayV2.cs b/osu.Game/Overlays/ChatOverlayV2.cs
index 1f2fb9724b..b0f81c217a 100644
--- a/osu.Game/Overlays/ChatOverlayV2.cs
+++ b/osu.Game/Overlays/ChatOverlayV2.cs
@@ -17,7 +17,9 @@ using osu.Framework.Graphics.Shapes;
 using osu.Framework.Input.Events;
 using osu.Framework.Localisation;
 using osu.Game.Configuration;
+using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
+using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Localisation;
 using osu.Game.Online.Chat;
@@ -326,11 +328,58 @@ namespace osu.Game.Overlays
             ChatLineFlow.Padding = new MarginPadding(0);
         }
 
-        protected override Drawable CreateDaySeparator(DateTimeOffset time) => new DaySeparator(time)
+        protected override Drawable CreateDaySeparator(DateTimeOffset time) => new ChatOverlayDaySeparator(time);
+
+        private class ChatOverlayDaySeparator : Container
         {
-            Colour = Colour4.White,
-            Margin = new MarginPadding { Vertical = 10 },
-            Padding = new MarginPadding { Horizontal = 15 },
-        };
+            private readonly DateTimeOffset time;
+
+            public ChatOverlayDaySeparator(DateTimeOffset time)
+            {
+                this.time = time;
+            }
+
+            [BackgroundDependencyLoader]
+            private void load(OverlayColourProvider colourProvider)
+            {
+                RelativeSizeAxes = Axes.X;
+                AutoSizeAxes = Axes.Y;
+                Padding = new MarginPadding(15);
+                Child = new GridContainer
+                {
+                    RelativeSizeAxes = Axes.X,
+                    AutoSizeAxes = Axes.Y,
+                    RowDimensions = new[] { new Dimension(GridSizeMode.AutoSize) },
+                    ColumnDimensions = new[]
+                    {
+                        new Dimension(GridSizeMode.Absolute, 215),
+                        new Dimension(GridSizeMode.AutoSize),
+                        new Dimension(),
+                    },
+                    Content = new[]
+                    {
+                        new Drawable[]
+                        {
+                            Drawable.Empty(),
+                            new OsuSpriteText
+                            {
+                                Text = time.ToLocalTime().ToString("dd MMMM yyyy").ToUpper(),
+                                Font = OsuFont.Torus.With(size: 15, weight: FontWeight.SemiBold),
+                                Colour = colourProvider.Content1,
+                                Margin = new MarginPadding { Right = 10 },
+                            },
+                            new Box
+                            {
+                                Anchor = Anchor.CentreLeft,
+                                Origin = Anchor.CentreLeft,
+                                Colour = colourProvider.Background5,
+                                RelativeSizeAxes = Axes.X,
+                                Height = 2,
+                            },
+                        },
+                    },
+                };
+            }
+        }
     }
 }

From 8da7bbd32271d782d2b65d7f84878a2b46c9552a Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Sat, 7 May 2022 23:30:46 +0100
Subject: [PATCH 4647/5547] Code quality

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

diff --git a/osu.Game/Overlays/ChatOverlayV2.cs b/osu.Game/Overlays/ChatOverlayV2.cs
index b0f81c217a..0702b3ad97 100644
--- a/osu.Game/Overlays/ChatOverlayV2.cs
+++ b/osu.Game/Overlays/ChatOverlayV2.cs
@@ -358,7 +358,7 @@ namespace osu.Game.Overlays
                     },
                     Content = new[]
                     {
-                        new Drawable[]
+                        new[]
                         {
                             Drawable.Empty(),
                             new OsuSpriteText

From 230c4e27b8baee58b553d651d289a5f199f3c962 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 8 May 2022 12:56:07 +0900
Subject: [PATCH 4648/5547] Simplify and centralise hiding logic for mod
 overlay

Behaviourally, this also always toggles via button triggering to add the
button flash animation.
---
 osu.Game/Overlays/Mods/ModSelectScreen.cs | 40 ++++++++++++++---------
 1 file changed, 24 insertions(+), 16 deletions(-)

diff --git a/osu.Game/Overlays/Mods/ModSelectScreen.cs b/osu.Game/Overlays/Mods/ModSelectScreen.cs
index 0a1b4e857e..5ec667bd90 100644
--- a/osu.Game/Overlays/Mods/ModSelectScreen.cs
+++ b/osu.Game/Overlays/Mods/ModSelectScreen.cs
@@ -393,30 +393,38 @@ namespace osu.Game.Overlays.Mods
             if (e.Repeat)
                 return false;
 
-            // This is handled locally here because this overlay is being registered at the game level
-            // and therefore takes away keyboard focus from the screen stack.
-            if (e.Action == GlobalAction.Back)
-            {
-                if (customisationVisible.Value)
-                    customisationVisible.Value = false;
-                else
-                    backButton.TriggerClick();
-                return true;
-            }
-
             switch (e.Action)
             {
+                case GlobalAction.Back:
+                    // Pressing the back binding should only go back one step at a time.
+                    hideOverlay(false);
+                    return true;
+
+                // This is handled locally here because this overlay is being registered at the game level
+                // and therefore takes away keyboard focus from the screen stack.
                 case GlobalAction.ToggleModSelection:
                 case GlobalAction.Select:
                 {
-                    if (customisationVisible.Value)
-                        customisationVisible.Value = false;
-                    Hide();
+                    // Pressing toggle or select should completely hide the overlay in one shot.
+                    hideOverlay(true);
                     return true;
                 }
+            }
 
-                default:
-                    return base.OnPressed(e);
+            return base.OnPressed(e);
+
+            void hideOverlay(bool immediate)
+            {
+                if (customisationVisible.Value)
+                {
+                    Debug.Assert(customisationButton != null);
+                    customisationButton.TriggerClick();
+
+                    if (!immediate)
+                        return;
+                }
+
+                backButton.TriggerClick();
             }
         }
 

From 3eeedd802478279e91d72caf4971a027427cd4b9 Mon Sep 17 00:00:00 2001
From: ekrctb <ekrctb@gmail.com>
Date: Sun, 8 May 2022 13:45:21 +0900
Subject: [PATCH 4649/5547] Fix per-hit object slider velocity ignored in
 osu!catch

---
 osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs b/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs
index 7ddbc2f768..b91a74c4a1 100644
--- a/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs
+++ b/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs
@@ -183,15 +183,15 @@ namespace osu.Game.Beatmaps.Formats
             SampleControlPoint lastRelevantSamplePoint = null;
             DifficultyControlPoint lastRelevantDifficultyPoint = null;
 
-            bool isOsuRuleset = onlineRulesetID == 0;
+            // In osu!taiko and osu!mania, a scroll speed is stored as "slider velocity" in legacy formats.
+            // In that case, a scrolling speed change is a global effect and per-hit object difficulty control points are ignored.
+            bool scrollSpeedEncodedAsSliderVelocity = onlineRulesetID == 1 || onlineRulesetID == 3;
 
             // iterate over hitobjects and pull out all required sample and difficulty changes
             extractDifficultyControlPoints(beatmap.HitObjects);
             extractSampleControlPoints(beatmap.HitObjects);
 
-            // handle scroll speed, which is stored as "slider velocity" in legacy formats.
-            // this is relevant for scrolling ruleset beatmaps.
-            if (!isOsuRuleset)
+            if (scrollSpeedEncodedAsSliderVelocity)
             {
                 foreach (var point in legacyControlPoints.EffectPoints)
                     legacyControlPoints.Add(point.Time, new DifficultyControlPoint { SliderVelocity = point.ScrollSpeed });
@@ -242,7 +242,7 @@ namespace osu.Game.Beatmaps.Formats
 
             IEnumerable<DifficultyControlPoint> collectDifficultyControlPoints(IEnumerable<HitObject> hitObjects)
             {
-                if (!isOsuRuleset)
+                if (scrollSpeedEncodedAsSliderVelocity)
                     yield break;
 
                 foreach (var hitObject in hitObjects)

From 125628dd20076054c6e5a8ab040d08b729558d6c Mon Sep 17 00:00:00 2001
From: ekrctb <ekrctb@gmail.com>
Date: Sun, 8 May 2022 15:52:14 +0900
Subject: [PATCH 4650/5547] Fix hit object not shown in timline while placement
 is waiting

---
 .../Edit/Blueprints/BananaShowerPlacementBlueprint.cs           | 2 ++
 .../Edit/Blueprints/JuiceStreamPlacementBlueprint.cs            | 2 ++
 2 files changed, 4 insertions(+)

diff --git a/osu.Game.Rulesets.Catch/Edit/Blueprints/BananaShowerPlacementBlueprint.cs b/osu.Game.Rulesets.Catch/Edit/Blueprints/BananaShowerPlacementBlueprint.cs
index 6dea8b0712..4613bfd36e 100644
--- a/osu.Game.Rulesets.Catch/Edit/Blueprints/BananaShowerPlacementBlueprint.cs
+++ b/osu.Game.Rulesets.Catch/Edit/Blueprints/BananaShowerPlacementBlueprint.cs
@@ -23,6 +23,8 @@ namespace osu.Game.Rulesets.Catch.Edit.Blueprints
             base.Update();
 
             outline.UpdateFrom(HitObjectContainer, HitObject);
+
+            BeginPlacement();
         }
 
         protected override bool OnMouseDown(MouseDownEvent e)
diff --git a/osu.Game.Rulesets.Catch/Edit/Blueprints/JuiceStreamPlacementBlueprint.cs b/osu.Game.Rulesets.Catch/Edit/Blueprints/JuiceStreamPlacementBlueprint.cs
index cff5bc2417..e9c8e2bb2c 100644
--- a/osu.Game.Rulesets.Catch/Edit/Blueprints/JuiceStreamPlacementBlueprint.cs
+++ b/osu.Game.Rulesets.Catch/Edit/Blueprints/JuiceStreamPlacementBlueprint.cs
@@ -47,6 +47,8 @@ namespace osu.Game.Rulesets.Catch.Edit.Blueprints
             base.LoadComplete();
 
             inputManager = GetContainingInputManager();
+
+            BeginPlacement();
         }
 
         protected override bool OnMouseDown(MouseDownEvent e)

From 9ae019eb3945acb74eecebf58aa7baeeaa2a3e00 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 7 May 2022 16:17:23 +0200
Subject: [PATCH 4651/5547] Move `ISamplePlaybackDisabler` to more general
 namespace

---
 .../Visual/Gameplay/TestSceneGameplaySamplePlayback.cs        | 1 +
 osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableSound.cs     | 1 -
 osu.Game/{Screens/Play => Audio}/ISamplePlaybackDisabler.cs   | 4 ++--
 osu.Game/Screens/Edit/Editor.cs                               | 1 +
 osu.Game/Screens/Play/Player.cs                               | 1 +
 osu.Game/Skinning/PausableSkinnableSound.cs                   | 1 -
 6 files changed, 5 insertions(+), 4 deletions(-)
 rename osu.Game/{Screens/Play => Audio}/ISamplePlaybackDisabler.cs (85%)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneGameplaySamplePlayback.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneGameplaySamplePlayback.cs
index ae2bc60fc6..815cc09448 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneGameplaySamplePlayback.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneGameplaySamplePlayback.cs
@@ -5,6 +5,7 @@ using System.Collections.Generic;
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Testing;
+using osu.Game.Audio;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Osu.Objects.Drawables;
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableSound.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableSound.cs
index 64afe1235b..3953ef8b33 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableSound.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableSound.cs
@@ -15,7 +15,6 @@ using osu.Framework.Graphics.OpenGL.Textures;
 using osu.Framework.Graphics.Textures;
 using osu.Framework.Testing;
 using osu.Game.Audio;
-using osu.Game.Screens.Play;
 using osu.Game.Skinning;
 
 namespace osu.Game.Tests.Visual.Gameplay
diff --git a/osu.Game/Screens/Play/ISamplePlaybackDisabler.cs b/osu.Game/Audio/ISamplePlaybackDisabler.cs
similarity index 85%
rename from osu.Game/Screens/Play/ISamplePlaybackDisabler.cs
rename to osu.Game/Audio/ISamplePlaybackDisabler.cs
index 6b37021fe6..65d36e9171 100644
--- a/osu.Game/Screens/Play/ISamplePlaybackDisabler.cs
+++ b/osu.Game/Audio/ISamplePlaybackDisabler.cs
@@ -4,11 +4,11 @@
 using osu.Framework.Bindables;
 using osu.Game.Skinning;
 
-namespace osu.Game.Screens.Play
+namespace osu.Game.Audio
 {
     /// <summary>
     /// Allows a component to disable sample playback dynamically as required.
-    /// Handled by <see cref="PausableSkinnableSound"/>.
+    /// Automatically handled by <see cref="PausableSkinnableSound"/>.
     /// </summary>
     public interface ISamplePlaybackDisabler
     {
diff --git a/osu.Game/Screens/Edit/Editor.cs b/osu.Game/Screens/Edit/Editor.cs
index 3fde033587..143d975104 100644
--- a/osu.Game/Screens/Edit/Editor.cs
+++ b/osu.Game/Screens/Edit/Editor.cs
@@ -19,6 +19,7 @@ using osu.Framework.Input.Events;
 using osu.Framework.Logging;
 using osu.Framework.Platform;
 using osu.Framework.Screens;
+using osu.Game.Audio;
 using osu.Game.Beatmaps;
 using osu.Game.Configuration;
 using osu.Game.Database;
diff --git a/osu.Game/Screens/Play/Player.cs b/osu.Game/Screens/Play/Player.cs
index ae3eb1ed8b..2f37b578f2 100644
--- a/osu.Game/Screens/Play/Player.cs
+++ b/osu.Game/Screens/Play/Player.cs
@@ -16,6 +16,7 @@ using osu.Framework.Input.Events;
 using osu.Framework.Logging;
 using osu.Framework.Screens;
 using osu.Framework.Threading;
+using osu.Game.Audio;
 using osu.Game.Beatmaps;
 using osu.Game.Configuration;
 using osu.Game.Graphics.Containers;
diff --git a/osu.Game/Skinning/PausableSkinnableSound.cs b/osu.Game/Skinning/PausableSkinnableSound.cs
index 10b8c47028..b34351d4e7 100644
--- a/osu.Game/Skinning/PausableSkinnableSound.cs
+++ b/osu.Game/Skinning/PausableSkinnableSound.cs
@@ -8,7 +8,6 @@ using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Threading;
 using osu.Game.Audio;
-using osu.Game.Screens.Play;
 
 namespace osu.Game.Skinning
 {

From cbd1169495a283d4d439cfc16edd856b23304f9e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 7 May 2022 16:23:30 +0200
Subject: [PATCH 4652/5547] Move cache declarations of
 `ISamplePlaybackDisabler` to interface

---
 osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableSound.cs | 1 -
 osu.Game/Audio/ISamplePlaybackDisabler.cs                 | 2 ++
 osu.Game/Screens/Edit/Editor.cs                           | 1 -
 osu.Game/Screens/Play/Player.cs                           | 1 -
 4 files changed, 2 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableSound.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableSound.cs
index 3953ef8b33..31abcb6748 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableSound.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableSound.cs
@@ -130,7 +130,6 @@ namespace osu.Game.Tests.Visual.Gameplay
         }
 
         [Cached(typeof(ISkinSource))]
-        [Cached(typeof(ISamplePlaybackDisabler))]
         private class TestSkinSourceContainer : Container, ISkinSource, ISamplePlaybackDisabler
         {
             [Resolved]
diff --git a/osu.Game/Audio/ISamplePlaybackDisabler.cs b/osu.Game/Audio/ISamplePlaybackDisabler.cs
index 65d36e9171..2f49e94f34 100644
--- a/osu.Game/Audio/ISamplePlaybackDisabler.cs
+++ b/osu.Game/Audio/ISamplePlaybackDisabler.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.Allocation;
 using osu.Framework.Bindables;
 using osu.Game.Skinning;
 
@@ -10,6 +11,7 @@ namespace osu.Game.Audio
     /// Allows a component to disable sample playback dynamically as required.
     /// Automatically handled by <see cref="PausableSkinnableSound"/>.
     /// </summary>
+    [Cached]
     public interface ISamplePlaybackDisabler
     {
         /// <summary>
diff --git a/osu.Game/Screens/Edit/Editor.cs b/osu.Game/Screens/Edit/Editor.cs
index 143d975104..947c184009 100644
--- a/osu.Game/Screens/Edit/Editor.cs
+++ b/osu.Game/Screens/Edit/Editor.cs
@@ -51,7 +51,6 @@ using osuTK.Input;
 namespace osu.Game.Screens.Edit
 {
     [Cached(typeof(IBeatSnapProvider))]
-    [Cached(typeof(ISamplePlaybackDisabler))]
     [Cached]
     public class Editor : ScreenWithBeatmapBackground, IKeyBindingHandler<GlobalAction>, IKeyBindingHandler<PlatformAction>, IBeatSnapProvider, ISamplePlaybackDisabler
     {
diff --git a/osu.Game/Screens/Play/Player.cs b/osu.Game/Screens/Play/Player.cs
index 2f37b578f2..51c1e6b43b 100644
--- a/osu.Game/Screens/Play/Player.cs
+++ b/osu.Game/Screens/Play/Player.cs
@@ -38,7 +38,6 @@ using osuTK.Graphics;
 namespace osu.Game.Screens.Play
 {
     [Cached]
-    [Cached(typeof(ISamplePlaybackDisabler))]
     public abstract class Player : ScreenWithBeatmapBackground, ISamplePlaybackDisabler, ILocalUserPlayInfo
     {
         /// <summary>

From 81ca534f878879af0cbb3384fb26fb8084aaeae3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 7 May 2022 16:28:28 +0200
Subject: [PATCH 4653/5547] Implement `ISamplePlaybackDisabler` in mod select

---
 osu.Game/Overlays/Mods/ModSelectScreen.cs | 12 +++++++++++-
 1 file changed, 11 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/Mods/ModSelectScreen.cs b/osu.Game/Overlays/Mods/ModSelectScreen.cs
index 5ec667bd90..4e87b5955a 100644
--- a/osu.Game/Overlays/Mods/ModSelectScreen.cs
+++ b/osu.Game/Overlays/Mods/ModSelectScreen.cs
@@ -15,6 +15,7 @@ using osu.Framework.Input.Events;
 using osu.Framework.Layout;
 using osu.Framework.Lists;
 using osu.Framework.Utils;
+using osu.Game.Audio;
 using osu.Game.Configuration;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
@@ -27,7 +28,7 @@ using osuTK.Input;
 
 namespace osu.Game.Overlays.Mods
 {
-    public abstract class ModSelectScreen : ShearedOverlayContainer
+    public abstract class ModSelectScreen : ShearedOverlayContainer, ISamplePlaybackDisabler
     {
         protected const int BUTTON_WIDTH = 200;
 
@@ -188,6 +189,8 @@ namespace osu.Game.Overlays.Mods
         {
             base.LoadComplete();
 
+            State.BindValueChanged(_ => samplePlaybackDisabled.Value = State.Value == Visibility.Hidden, true);
+
             ((IBindable<IReadOnlyList<Mod>>)modSettingsArea.SelectedMods).BindTo(SelectedMods);
 
             SelectedMods.BindValueChanged(val =>
@@ -430,6 +433,13 @@ namespace osu.Game.Overlays.Mods
 
         #endregion
 
+        #region Sample playback control
+
+        private readonly Bindable<bool> samplePlaybackDisabled = new BindableBool(true);
+        IBindable<bool> ISamplePlaybackDisabler.SamplePlaybackDisabled => samplePlaybackDisabled;
+
+        #endregion
+
         /// <summary>
         /// Manages horizontal scrolling of mod columns, along with the "active" states of each column based on visibility.
         /// </summary>

From b92d95a17acb60a0ba671add4a80fc74eda4957f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 7 May 2022 16:35:34 +0200
Subject: [PATCH 4654/5547] Fix mod panels playing samples when hidden at a
 higher level

---
 osu.Game/Audio/ISamplePlaybackDisabler.cs |  1 +
 osu.Game/Overlays/Mods/ModPanel.cs        | 16 ++++++++++++----
 2 files changed, 13 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Audio/ISamplePlaybackDisabler.cs b/osu.Game/Audio/ISamplePlaybackDisabler.cs
index 2f49e94f34..4167316780 100644
--- a/osu.Game/Audio/ISamplePlaybackDisabler.cs
+++ b/osu.Game/Audio/ISamplePlaybackDisabler.cs
@@ -10,6 +10,7 @@ namespace osu.Game.Audio
     /// <summary>
     /// Allows a component to disable sample playback dynamically as required.
     /// Automatically handled by <see cref="PausableSkinnableSound"/>.
+    /// May also be manually handled locally to particular components.
     /// </summary>
     [Cached]
     public interface ISamplePlaybackDisabler
diff --git a/osu.Game/Overlays/Mods/ModPanel.cs b/osu.Game/Overlays/Mods/ModPanel.cs
index f2a97da3b2..4c4951307d 100644
--- a/osu.Game/Overlays/Mods/ModPanel.cs
+++ b/osu.Game/Overlays/Mods/ModPanel.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.
 
+#nullable enable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
@@ -12,6 +14,7 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Input.Events;
 using osu.Framework.Utils;
+using osu.Game.Audio;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
@@ -21,8 +24,6 @@ using osu.Game.Rulesets.UI;
 using osuTK;
 using osuTK.Input;
 
-#nullable enable
-
 namespace osu.Game.Overlays.Mods
 {
     public class ModPanel : OsuClickableContainer
@@ -50,6 +51,7 @@ namespace osu.Game.Overlays.Mods
 
         private Colour4 activeColour;
 
+        private readonly Bindable<bool> samplePlaybackDisabled = new BindableBool();
         private Sample? sampleOff;
         private Sample? sampleOn;
 
@@ -139,13 +141,16 @@ namespace osu.Game.Overlays.Mods
             Action = Active.Toggle;
         }
 
-        [BackgroundDependencyLoader]
-        private void load(AudioManager audio, OsuColour colours)
+        [BackgroundDependencyLoader(true)]
+        private void load(AudioManager audio, OsuColour colours, ISamplePlaybackDisabler? samplePlaybackDisabler)
         {
             sampleOn = audio.Samples.Get(@"UI/check-on");
             sampleOff = audio.Samples.Get(@"UI/check-off");
 
             activeColour = colours.ForModType(Mod.Type);
+
+            if (samplePlaybackDisabler != null)
+                ((IBindable<bool>)samplePlaybackDisabled).BindTo(samplePlaybackDisabler.SamplePlaybackDisabled);
         }
 
         protected override HoverSounds CreateHoverSounds(HoverSampleSet sampleSet) => new HoverSounds(sampleSet);
@@ -166,6 +171,9 @@ namespace osu.Game.Overlays.Mods
 
         private void playStateChangeSamples()
         {
+            if (samplePlaybackDisabled.Value)
+                return;
+
             if (Active.Value)
                 sampleOn?.Play();
             else

From 778497b9e27c0bce96d5580d71d9bb915c997b00 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 8 May 2022 17:00:20 +0900
Subject: [PATCH 4655/5547] Scroll mod select slightly into view on first
 display

---
 osu.Game/Overlays/Mods/ModSelectScreen.cs | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/osu.Game/Overlays/Mods/ModSelectScreen.cs b/osu.Game/Overlays/Mods/ModSelectScreen.cs
index 4e87b5955a..959d9ad2fc 100644
--- a/osu.Game/Overlays/Mods/ModSelectScreen.cs
+++ b/osu.Game/Overlays/Mods/ModSelectScreen.cs
@@ -208,6 +208,14 @@ namespace osu.Game.Overlays.Mods
             customisationVisible.BindValueChanged(_ => updateCustomisationVisualState(), true);
 
             updateAvailableMods();
+
+            // Start scrolled slightly to the right to give the user a sense that
+            // there is more horizontal content available.
+            ScheduleAfterChildren(() =>
+            {
+                columnScroll.ScrollTo(100, false);
+                columnScroll.ScrollToStart();
+            });
         }
 
         /// <summary>

From b8cb2c1b82570100a6c60388f65d7fa2e240c7fe Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 8 May 2022 19:57:03 +0900
Subject: [PATCH 4656/5547] Increase scroll amount slightly

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

diff --git a/osu.Game/Overlays/Mods/ModSelectScreen.cs b/osu.Game/Overlays/Mods/ModSelectScreen.cs
index 959d9ad2fc..fc06af3f9d 100644
--- a/osu.Game/Overlays/Mods/ModSelectScreen.cs
+++ b/osu.Game/Overlays/Mods/ModSelectScreen.cs
@@ -213,7 +213,7 @@ namespace osu.Game.Overlays.Mods
             // there is more horizontal content available.
             ScheduleAfterChildren(() =>
             {
-                columnScroll.ScrollTo(100, false);
+                columnScroll.ScrollTo(200, false);
                 columnScroll.ScrollToStart();
             });
         }

From dcf0d5a9d5b93045385c8f4b9f5fe16844294bb3 Mon Sep 17 00:00:00 2001
From: ekrctb <ekrctb@gmail.com>
Date: Sun, 8 May 2022 21:49:42 +0900
Subject: [PATCH 4657/5547] Fix slider velocity wrongly decoded as scrolling
 speed in osu!catch

---
 osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs b/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
index 79d8bd3bb3..3a893a1238 100644
--- a/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
+++ b/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
@@ -431,9 +431,10 @@ namespace osu.Game.Beatmaps.Formats
                 OmitFirstBarLine = omitFirstBarSignature,
             };
 
-            bool isOsuRuleset = beatmap.BeatmapInfo.Ruleset.OnlineID == 0;
-            // scrolling rulesets use effect points rather than difficulty points for scroll speed adjustments.
-            if (!isOsuRuleset)
+            int onlineRulesetID = beatmap.BeatmapInfo.Ruleset.OnlineID;
+
+            // osu!taiko and osu!mania use effect points rather than difficulty points for scroll speed adjustments.
+            if (onlineRulesetID == 1 || onlineRulesetID == 3)
                 effectPoint.ScrollSpeed = speedMultiplier;
 
             addControlPoint(time, effectPoint, timingChange);

From 92ccec20d787d08e19d81437ab7c89e148175abd Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 8 May 2022 14:44:54 +0200
Subject: [PATCH 4658/5547] Hide mod columns if all mods within are filtered
 out

---
 osu.Game/Overlays/Mods/ModColumn.cs       | 13 +++++++
 osu.Game/Overlays/Mods/ModSelectScreen.cs | 45 +++++++++++++++++------
 2 files changed, 47 insertions(+), 11 deletions(-)

diff --git a/osu.Game/Overlays/Mods/ModColumn.cs b/osu.Game/Overlays/Mods/ModColumn.cs
index f0741cdc40..89f472a290 100644
--- a/osu.Game/Overlays/Mods/ModColumn.cs
+++ b/osu.Game/Overlays/Mods/ModColumn.cs
@@ -55,8 +55,18 @@ namespace osu.Game.Overlays.Mods
             }
         }
 
+        /// <summary>
+        /// Determines whether this column should accept user input.
+        /// </summary>
         public Bindable<bool> Active = new BindableBool(true);
 
+        private readonly Bindable<bool> allFiltered = new BindableBool();
+
+        /// <summary>
+        /// True if all of the panels in this column have been filtered out by the current <see cref="Filter"/>.
+        /// </summary>
+        public IBindable<bool> AllFiltered => allFiltered;
+
         /// <summary>
         /// List of mods marked as selected in this column.
         /// </summary>
@@ -339,6 +349,9 @@ namespace osu.Game.Overlays.Mods
                 panel.ApplyFilter(Filter);
             }
 
+            allFiltered.Value = panelFlow.All(panel => panel.Filtered.Value);
+            Alpha = allFiltered.Value ? 0 : 1;
+
             if (toggleAllCheckbox != null && !SelectionAnimationRunning)
             {
                 toggleAllCheckbox.Alpha = panelFlow.Any(panel => !panel.Filtered.Value) ? 1 : 0;
diff --git a/osu.Game/Overlays/Mods/ModSelectScreen.cs b/osu.Game/Overlays/Mods/ModSelectScreen.cs
index fc06af3f9d..6a3df3fb05 100644
--- a/osu.Game/Overlays/Mods/ModSelectScreen.cs
+++ b/osu.Game/Overlays/Mods/ModSelectScreen.cs
@@ -237,11 +237,11 @@ namespace osu.Game.Overlays.Mods
         }
 
         private ColumnDimContainer createModColumnContent(ModType modType, Key[]? toggleKeys = null)
-            => new ColumnDimContainer(CreateModColumn(modType, toggleKeys))
+            => new ColumnDimContainer(CreateModColumn(modType, toggleKeys).With(column => column.Filter = IsValidMod))
             {
                 AutoSizeAxes = Axes.X,
                 RelativeSizeAxes = Axes.Y,
-                RequestScroll = column => columnScroll.ScrollIntoView(column, extraScroll: 140)
+                RequestScroll = column => columnScroll.ScrollIntoView(column, extraScroll: 140),
             };
 
         private ShearedButton[] createDefaultFooterButtons()
@@ -351,6 +351,8 @@ namespace osu.Game.Overlays.Mods
 
         #region Transition handling
 
+        private const float distance = 700;
+
         protected override void PopIn()
         {
             const double fade_in_duration = 400;
@@ -362,13 +364,26 @@ namespace osu.Game.Overlays.Mods
                 .FadeIn(fade_in_duration / 2, Easing.OutQuint)
                 .ScaleTo(1, fade_in_duration, Easing.OutElastic);
 
+            int nonFilteredColumnCount = 0;
+
             for (int i = 0; i < columnFlow.Count; i++)
             {
-                columnFlow[i].Column
-                             .TopLevelContent
-                             .Delay(i * 30)
-                             .MoveToY(0, fade_in_duration, Easing.OutQuint)
-                             .FadeIn(fade_in_duration, Easing.OutQuint);
+                var column = columnFlow[i].Column;
+
+                double delay = column.AllFiltered.Value ? 0 : nonFilteredColumnCount * 30;
+                double duration = column.AllFiltered.Value ? 0 : fade_in_duration;
+                float startingYPosition = 0;
+                if (!column.AllFiltered.Value)
+                    startingYPosition = nonFilteredColumnCount % 2 == 0 ? -distance : distance;
+
+                column.TopLevelContent
+                      .MoveToY(startingYPosition)
+                      .Delay(delay)
+                      .MoveToY(0, duration, Easing.OutQuint)
+                      .FadeIn(duration, Easing.OutQuint);
+
+                if (!column.AllFiltered.Value)
+                    nonFilteredColumnCount += 1;
             }
         }
 
@@ -382,16 +397,24 @@ namespace osu.Game.Overlays.Mods
                 .FadeOut(fade_out_duration / 2, Easing.OutQuint)
                 .ScaleTo(0.75f, fade_out_duration, Easing.OutQuint);
 
+            int nonFilteredColumnCount = 0;
+
             for (int i = 0; i < columnFlow.Count; i++)
             {
-                const float distance = 700;
-
                 var column = columnFlow[i].Column;
 
+                double duration = column.AllFiltered.Value ? 0 : fade_out_duration;
+                float newYPosition = 0;
+                if (!column.AllFiltered.Value)
+                    newYPosition = nonFilteredColumnCount % 2 == 0 ? -distance : distance;
+
                 column.FlushPendingSelections();
                 column.TopLevelContent
-                      .MoveToY(i % 2 == 0 ? -distance : distance, fade_out_duration, Easing.OutQuint)
-                      .FadeOut(fade_out_duration, Easing.OutQuint);
+                      .MoveToY(newYPosition, duration, Easing.OutQuint)
+                      .FadeOut(duration, Easing.OutQuint);
+
+                if (!column.AllFiltered.Value)
+                    nonFilteredColumnCount += 1;
             }
         }
 

From 38c004d734be28cdc973bbd8eb9f4ca19e5b55db Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 8 May 2022 14:45:01 +0200
Subject: [PATCH 4659/5547] Add test coverage for hiding mod columns

---
 .../UserInterface/TestSceneModSelectScreen.cs | 30 +++++++++++++++++++
 1 file changed, 30 insertions(+)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs
index 42ffeba444..fa7758df59 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs
@@ -451,6 +451,36 @@ namespace osu.Game.Tests.Visual.UserInterface
             AddAssert("mod select hidden", () => modSelectScreen.State.Value == Visibility.Hidden);
         }
 
+        [Test]
+        public void TestColumnHiding()
+        {
+            AddStep("create screen", () => Child = modSelectScreen = new UserModSelectScreen
+            {
+                RelativeSizeAxes = Axes.Both,
+                State = { Value = Visibility.Visible },
+                SelectedMods = { BindTarget = SelectedMods },
+                IsValidMod = mod => mod.Type == ModType.DifficultyIncrease || mod.Type == ModType.Conversion
+            });
+            waitForColumnLoad();
+            changeRuleset(0);
+
+            AddAssert("two columns visible", () => this.ChildrenOfType<ModColumn>().Count(col => col.IsPresent) == 2);
+
+            AddStep("unset filter", () => modSelectScreen.IsValidMod = _ => true);
+            AddAssert("all columns visible", () => this.ChildrenOfType<ModColumn>().All(col => col.IsPresent));
+
+            AddStep("filter out everything", () => modSelectScreen.IsValidMod = _ => false);
+            AddAssert("no columns visible", () => this.ChildrenOfType<ModColumn>().All(col => !col.IsPresent));
+
+            AddStep("hide", () => modSelectScreen.Hide());
+            AddStep("set filter for 3 columns", () => modSelectScreen.IsValidMod = mod => mod.Type == ModType.DifficultyReduction
+                                                                                          || mod.Type == ModType.Automation
+                                                                                          || mod.Type == ModType.Conversion);
+
+            AddStep("show", () => modSelectScreen.Show());
+            AddUntilStep("3 columns visible", () => this.ChildrenOfType<ModColumn>().Count(col => col.IsPresent) == 3);
+        }
+
         private void waitForColumnLoad() => AddUntilStep("all column content loaded",
             () => modSelectScreen.ChildrenOfType<ModColumn>().Any() && modSelectScreen.ChildrenOfType<ModColumn>().All(column => column.IsLoaded && column.ItemsLoaded));
 

From 077c77d52459c92b3b4e4f1beb9f634a0585eada Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sun, 8 May 2022 16:00:07 +0300
Subject: [PATCH 4660/5547] Add method for scaling results screen in tests

---
 .../Multiplayer/TestSceneMultiplayerTeamResults.cs   | 12 ++++++++++++
 .../Visual/Ranking/TestSceneResultsScreen.cs         | 11 +++++++++++
 2 files changed, 23 insertions(+)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerTeamResults.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerTeamResults.cs
index bcb36a585f..0237298fa1 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerTeamResults.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerTeamResults.cs
@@ -8,11 +8,23 @@ using osu.Game.Online.Rooms;
 using osu.Game.Rulesets.Osu;
 using osu.Game.Screens.OnlinePlay.Multiplayer;
 using osu.Game.Tests.Resources;
+using osuTK;
 
 namespace osu.Game.Tests.Visual.Multiplayer
 {
     public class TestSceneMultiplayerTeamResults : ScreenTestScene
     {
+        [Test]
+        public void TestScaling()
+        {
+            // scheduling is needed as scaling the content immediately causes the entire scene to shake badly, for some odd reason.
+            AddSliderStep("scale", 0.5f, 1.6f, 1f, v => Schedule(() =>
+            {
+                Stack.Scale = new Vector2(v);
+                Stack.Size = new Vector2(1f / v);
+            }));
+        }
+
         [TestCase(7483253, 1048576)]
         [TestCase(1048576, 7483253)]
         [TestCase(1048576, 1048576)]
diff --git a/osu.Game.Tests/Visual/Ranking/TestSceneResultsScreen.cs b/osu.Game.Tests/Visual/Ranking/TestSceneResultsScreen.cs
index 4eed2a25f5..a1d51683e4 100644
--- a/osu.Game.Tests/Visual/Ranking/TestSceneResultsScreen.cs
+++ b/osu.Game.Tests/Visual/Ranking/TestSceneResultsScreen.cs
@@ -56,6 +56,17 @@ namespace osu.Game.Tests.Visual.Ranking
             });
         }
 
+        [Test]
+        public void TestScaling()
+        {
+            // scheduling is needed as scaling the content immediately causes the entire scene to shake badly, for some odd reason.
+            AddSliderStep("scale", 0.5f, 1.6f, 1f, v => Schedule(() =>
+            {
+                Content.Scale = new Vector2(v);
+                Content.Size = new Vector2(1f / v);
+            }));
+        }
+
         [Test]
         public void TestResultsWithoutPlayer()
         {

From 298c2a1828bf628d59a5bd7ec1b671e925732ec9 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sun, 8 May 2022 16:03:57 +0300
Subject: [PATCH 4661/5547] Replace vertical scrolling in results screen with
 size-preserving container

---
 .../MultiplayerTeamResultsScreen.cs           |  6 ++---
 osu.Game/Screens/Ranking/ResultsScreen.cs     | 26 ++-----------------
 2 files changed, 5 insertions(+), 27 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerTeamResultsScreen.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerTeamResultsScreen.cs
index 3f0f3e043c..117415ac8f 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerTeamResultsScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerTeamResultsScreen.cs
@@ -46,9 +46,9 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
         {
             const float winner_background_half_height = 250;
 
-            VerticalScrollContent.Anchor = VerticalScrollContent.Origin = Anchor.TopCentre;
-            VerticalScrollContent.Scale = new Vector2(0.9f);
-            VerticalScrollContent.Y = 75;
+            Content.Anchor = Content.Origin = Anchor.TopCentre;
+            Content.Scale = new Vector2(0.9f);
+            Content.Y = 75;
 
             var redScore = teamScores.First().Value;
             var blueScore = teamScores.Last().Value;
diff --git a/osu.Game/Screens/Ranking/ResultsScreen.cs b/osu.Game/Screens/Ranking/ResultsScreen.cs
index 98514cd846..2c91b17917 100644
--- a/osu.Game/Screens/Ranking/ResultsScreen.cs
+++ b/osu.Game/Screens/Ranking/ResultsScreen.cs
@@ -14,7 +14,6 @@ using osu.Framework.Input.Bindings;
 using osu.Framework.Input.Events;
 using osu.Framework.Screens;
 using osu.Game.Graphics;
-using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Input.Bindings;
 using osu.Game.Online.API;
@@ -41,7 +40,7 @@ namespace osu.Game.Screens.Ranking
 
         protected ScorePanelList ScorePanelList { get; private set; }
 
-        protected VerticalScrollContainer VerticalScrollContent { get; private set; }
+        protected Container Content { get; private set; }
 
         [Resolved(CanBeNull = true)]
         private Player player { get; set; }
@@ -79,10 +78,9 @@ namespace osu.Game.Screens.Ranking
                 {
                     new Drawable[]
                     {
-                        VerticalScrollContent = new VerticalScrollContainer
+                        Content = new DrawSizePreservingFillContainer
                         {
                             RelativeSizeAxes = Axes.Both,
-                            ScrollbarVisible = false,
                             Child = new Container
                             {
                                 RelativeSizeAxes = Axes.Both,
@@ -346,25 +344,5 @@ namespace osu.Game.Screens.Ranking
         public void OnReleased(KeyBindingReleaseEvent<GlobalAction> e)
         {
         }
-
-        protected class VerticalScrollContainer : OsuScrollContainer
-        {
-            protected override Container<Drawable> Content => content;
-
-            private readonly Container content;
-
-            public VerticalScrollContainer()
-            {
-                Masking = false;
-
-                base.Content.Add(content = new Container { RelativeSizeAxes = Axes.X });
-            }
-
-            protected override void Update()
-            {
-                base.Update();
-                content.Height = Math.Max(screen_height, DrawHeight);
-            }
-        }
     }
 }

From 7f1ad149d5775606497144af30d94e801222e8a7 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sun, 8 May 2022 16:04:24 +0300
Subject: [PATCH 4662/5547] Remove no longer necessary horizontal scroll
 blocker

---
 osu.Game/Screens/Ranking/ScorePanelList.cs | 10 ----------
 1 file changed, 10 deletions(-)

diff --git a/osu.Game/Screens/Ranking/ScorePanelList.cs b/osu.Game/Screens/Ranking/ScorePanelList.cs
index c2ef5529e8..a5341242e2 100644
--- a/osu.Game/Screens/Ranking/ScorePanelList.cs
+++ b/osu.Game/Screens/Ranking/ScorePanelList.cs
@@ -85,7 +85,6 @@ namespace osu.Game.Screens.Ranking
             InternalChild = scroll = new Scroll
             {
                 RelativeSizeAxes = Axes.Both,
-                HandleScroll = () => expandedPanel?.IsHovered != true, // handle horizontal scroll only when not hovering the expanded panel.
                 Child = flow = new Flow
                 {
                     Anchor = Anchor.Centre,
@@ -359,11 +358,6 @@ namespace osu.Game.Screens.Ranking
             /// </summary>
             public float? InstantScrollTarget;
 
-            /// <summary>
-            /// Whether this container should handle scroll trigger events.
-            /// </summary>
-            public Func<bool> HandleScroll;
-
             protected override void UpdateAfterChildren()
             {
                 if (InstantScrollTarget != null)
@@ -374,10 +368,6 @@ namespace osu.Game.Screens.Ranking
 
                 base.UpdateAfterChildren();
             }
-
-            public override bool HandlePositionalInput => HandleScroll();
-
-            public override bool HandleNonPositionalInput => HandleScroll();
         }
     }
 }

From 6f4cdccf6c5430991c8e4c87a6ad60698faff4ce Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sun, 8 May 2022 16:20:26 +0300
Subject: [PATCH 4663/5547] Remove no longer required constant

---
 osu.Game/Screens/Ranking/ResultsScreen.cs | 1 -
 1 file changed, 1 deletion(-)

diff --git a/osu.Game/Screens/Ranking/ResultsScreen.cs b/osu.Game/Screens/Ranking/ResultsScreen.cs
index 2c91b17917..87e49fcc5e 100644
--- a/osu.Game/Screens/Ranking/ResultsScreen.cs
+++ b/osu.Game/Screens/Ranking/ResultsScreen.cs
@@ -27,7 +27,6 @@ namespace osu.Game.Screens.Ranking
     public abstract class ResultsScreen : ScreenWithBeatmapBackground, IKeyBindingHandler<GlobalAction>
     {
         protected const float BACKGROUND_BLUR = 20;
-        private static readonly float screen_height = 768 - TwoLayerButton.SIZE_EXTENDED.Y;
 
         public override bool DisallowExternalBeatmapRulesetChanges => true;
 

From 4e0155fa4bac0dd8a8316f4cf1e80b610a465e17 Mon Sep 17 00:00:00 2001
From: ekrctb <ekrctb@gmail.com>
Date: Sun, 8 May 2022 18:32:01 +0900
Subject: [PATCH 4664/5547] Make `JuiceStreamPath` time based instead of
 distance based.

And remove the "slope limit" feature.
TODO: for a juice stream with a large slope, the slider velocity of the hit object should be changed.
---
 .../TestSceneJuiceStreamSelectionBlueprint.cs |   8 +-
 .../JuiceStreamPathTest.cs                    |  95 +++++------
 .../Blueprints/Components/EditablePath.cs     |  30 ++--
 .../Components/PlacementEditablePath.cs       |  10 +-
 .../Components/SelectionEditablePath.cs       |  12 +-
 .../JuiceStreamPlacementBlueprint.cs          |   6 +-
 .../JuiceStreamSelectionBlueprint.cs          |   6 +-
 .../Objects/JuiceStreamPath.cs                | 158 ++++++++----------
 .../Objects/JuiceStreamPathVertex.cs          |  10 +-
 9 files changed, 157 insertions(+), 178 deletions(-)

diff --git a/osu.Game.Rulesets.Catch.Tests/Editor/TestSceneJuiceStreamSelectionBlueprint.cs b/osu.Game.Rulesets.Catch.Tests/Editor/TestSceneJuiceStreamSelectionBlueprint.cs
index fb77fb1efd..123316f461 100644
--- a/osu.Game.Rulesets.Catch.Tests/Editor/TestSceneJuiceStreamSelectionBlueprint.cs
+++ b/osu.Game.Rulesets.Catch.Tests/Editor/TestSceneJuiceStreamSelectionBlueprint.cs
@@ -234,10 +234,10 @@ namespace osu.Game.Rulesets.Catch.Tests.Editor
         {
             var path = new JuiceStreamPath();
             for (int i = 1; i < times.Length; i++)
-                path.Add((times[i] - times[0]) * velocity, positions[i] - positions[0]);
+                path.Add(times[i] - times[0], positions[i] - positions[0]);
 
             var sliderPath = new SliderPath();
-            path.ConvertToSliderPath(sliderPath, 0);
+            path.ConvertToSliderPath(sliderPath, 0, velocity);
             addBlueprintStep(times[0], positions[0], sliderPath, velocity);
         }
 
@@ -245,11 +245,11 @@ namespace osu.Game.Rulesets.Catch.Tests.Editor
 
         private void addVertexCheckStep(int count, int index, double time, float x) => AddAssert($"vertex {index} of {count} at {time}, {x}", () =>
         {
-            double expectedDistance = (time - hitObject.StartTime) * hitObject.Velocity;
+            double expectedTime = time - hitObject.StartTime;
             float expectedX = x - hitObject.OriginalX;
             var vertices = getVertices();
             return vertices.Count == count &&
-                   Precision.AlmostEquals(vertices[index].Distance, expectedDistance, 1e-3) &&
+                   Precision.AlmostEquals(vertices[index].Time, expectedTime, 1e-3) &&
                    Precision.AlmostEquals(vertices[index].X, expectedX);
         });
 
diff --git a/osu.Game.Rulesets.Catch.Tests/JuiceStreamPathTest.cs b/osu.Game.Rulesets.Catch.Tests/JuiceStreamPathTest.cs
index 8fa96fb8c9..5248d5a96a 100644
--- a/osu.Game.Rulesets.Catch.Tests/JuiceStreamPathTest.cs
+++ b/osu.Game.Rulesets.Catch.Tests/JuiceStreamPathTest.cs
@@ -5,7 +5,6 @@ using System;
 using System.Collections.Generic;
 using System.Linq;
 using NUnit.Framework;
-using osu.Framework.Utils;
 using osu.Game.Rulesets.Catch.Objects;
 using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Objects.Types;
@@ -37,14 +36,14 @@ namespace osu.Game.Rulesets.Catch.Tests
                 {
                     case 0:
                     {
-                        double distance = rng.NextDouble() * scale * 2 - scale;
+                        double time = rng.NextDouble() * scale * 2 - scale;
                         if (integralValues)
-                            distance = Math.Round(distance);
+                            time = Math.Round(time);
 
-                        float oldX = path.PositionAtDistance(distance);
-                        int index = path.InsertVertex(distance);
+                        float oldX = path.PositionAtTime(time);
+                        int index = path.InsertVertex(time);
                         Assert.That(path.Vertices.Count, Is.EqualTo(vertexCount + 1));
-                        Assert.That(path.Vertices[index].Distance, Is.EqualTo(distance));
+                        Assert.That(path.Vertices[index].Time, Is.EqualTo(time));
                         Assert.That(path.Vertices[index].X, Is.EqualTo(oldX));
                         break;
                     }
@@ -52,20 +51,20 @@ namespace osu.Game.Rulesets.Catch.Tests
                     case 1:
                     {
                         int index = rng.Next(path.Vertices.Count);
-                        double distance = path.Vertices[index].Distance;
+                        double time = path.Vertices[index].Time;
                         float newX = (float)(rng.NextDouble() * scale * 2 - scale);
                         if (integralValues)
                             newX = MathF.Round(newX);
 
                         path.SetVertexPosition(index, newX);
                         Assert.That(path.Vertices.Count, Is.EqualTo(vertexCount));
-                        Assert.That(path.Vertices[index].Distance, Is.EqualTo(distance));
+                        Assert.That(path.Vertices[index].Time, Is.EqualTo(time));
                         Assert.That(path.Vertices[index].X, Is.EqualTo(newX));
                         break;
                     }
                 }
 
-                assertInvariants(path.Vertices, checkSlope);
+                assertInvariants(path.Vertices);
             }
         }
 
@@ -76,7 +75,7 @@ namespace osu.Game.Rulesets.Catch.Tests
             path.Add(10, 5);
             path.Add(20, -5);
 
-            int removeCount = path.RemoveVertices((v, i) => v.Distance == 10 && i == 1);
+            int removeCount = path.RemoveVertices((v, i) => v.Time == 10 && i == 1);
             Assert.That(removeCount, Is.EqualTo(1));
             Assert.That(path.Vertices, Is.EqualTo(new[]
             {
@@ -131,8 +130,9 @@ namespace osu.Game.Rulesets.Catch.Tests
             }));
         }
 
-        [Test]
-        public void TestRandomConvertFromSliderPath()
+        [TestCase(10)]
+        [TestCase(0.1)]
+        public void TestRandomConvertFromSliderPath(double velocity)
         {
             var rng = new Random(1);
             var path = new JuiceStreamPath();
@@ -162,28 +162,28 @@ namespace osu.Game.Rulesets.Catch.Tests
                 else
                     sliderPath.ExpectedDistance.Value = null;
 
-                path.ConvertFromSliderPath(sliderPath);
-                Assert.That(path.Vertices[0].Distance, Is.EqualTo(0));
-                Assert.That(path.Distance, Is.EqualTo(sliderPath.Distance).Within(1e-3));
-                assertInvariants(path.Vertices, true);
+                path.ConvertFromSliderPath(sliderPath, velocity);
+                Assert.That(path.Vertices[0].Time, Is.EqualTo(0));
+                Assert.That(path.Duration * velocity, Is.EqualTo(sliderPath.Distance).Within(1e-3));
+                assertInvariants(path.Vertices);
 
-                double[] sampleDistances = Enumerable.Range(0, 10)
-                                                     .Select(_ => rng.NextDouble() * sliderPath.Distance)
-                                                     .ToArray();
+                double[] sampleTimes = Enumerable.Range(0, 10)
+                                                 .Select(_ => rng.NextDouble() * sliderPath.Distance / velocity)
+                                                 .ToArray();
 
-                foreach (double distance in sampleDistances)
+                foreach (double time in sampleTimes)
                 {
-                    float expected = sliderPath.PositionAt(distance / sliderPath.Distance).X;
-                    Assert.That(path.PositionAtDistance(distance), Is.EqualTo(expected).Within(1e-3));
+                    float expected = sliderPath.PositionAt(time * velocity / sliderPath.Distance).X;
+                    Assert.That(path.PositionAtTime(time), Is.EqualTo(expected).Within(1e-3));
                 }
 
-                path.ResampleVertices(sampleDistances);
-                assertInvariants(path.Vertices, true);
+                path.ResampleVertices(sampleTimes);
+                assertInvariants(path.Vertices);
 
-                foreach (double distance in sampleDistances)
+                foreach (double time in sampleTimes)
                 {
-                    float expected = sliderPath.PositionAt(distance / sliderPath.Distance).X;
-                    Assert.That(path.PositionAtDistance(distance), Is.EqualTo(expected).Within(1e-3));
+                    float expected = sliderPath.PositionAt(time * velocity / sliderPath.Distance).X;
+                    Assert.That(path.PositionAtTime(time), Is.EqualTo(expected).Within(1e-3));
                 }
             }
         }
@@ -201,17 +201,17 @@ namespace osu.Game.Rulesets.Catch.Tests
 
                 do
                 {
-                    double distance = rng.NextDouble() * 1e3;
+                    double time = rng.NextDouble() * 1e3;
                     float x = (float)(rng.NextDouble() * 1e3);
-                    path.Add(distance, x);
+                    path.Add(time, x);
                 } while (rng.Next(5) != 0);
 
                 float sliderStartY = (float)(rng.NextDouble() * JuiceStreamPath.OSU_PLAYFIELD_HEIGHT);
 
-                path.ConvertToSliderPath(sliderPath, sliderStartY);
-                Assert.That(sliderPath.Distance, Is.EqualTo(path.Distance).Within(1e-3));
-                Assert.That(sliderPath.ControlPoints[0].Position.X, Is.EqualTo(path.Vertices[0].X));
-                assertInvariants(path.Vertices, true);
+                double requiredVelocity = path.ComputeRequiredVelocity();
+                double velocity = Math.Clamp(requiredVelocity, 1, 100);
+
+                path.ConvertToSliderPath(sliderPath, sliderStartY, velocity);
 
                 foreach (var point in sliderPath.ControlPoints)
                 {
@@ -219,11 +219,18 @@ namespace osu.Game.Rulesets.Catch.Tests
                     Assert.That(sliderStartY + point.Position.Y, Is.InRange(0, JuiceStreamPath.OSU_PLAYFIELD_HEIGHT));
                 }
 
+                Assert.That(sliderPath.ControlPoints[0].Position.X, Is.EqualTo(path.Vertices[0].X));
+
+                // The path is preserved only if required velocity is used.
+                if (velocity < requiredVelocity) continue;
+
+                Assert.That(sliderPath.Distance / velocity, Is.EqualTo(path.Duration).Within(1e-3));
+
                 for (int i = 0; i < 10; i++)
                 {
-                    double distance = rng.NextDouble() * path.Distance;
-                    float expected = path.PositionAtDistance(distance);
-                    Assert.That(sliderPath.PositionAt(distance / sliderPath.Distance).X, Is.EqualTo(expected).Within(1e-3));
+                    double time = rng.NextDouble() * path.Duration;
+                    float expected = path.PositionAtTime(time);
+                    Assert.That(sliderPath.PositionAt(time * velocity / sliderPath.Distance).X, Is.EqualTo(expected).Within(3e-3));
                 }
             }
         }
@@ -244,7 +251,7 @@ namespace osu.Game.Rulesets.Catch.Tests
             path.Add(20, 0);
             checkNewId();
 
-            path.RemoveVertices((v, _) => v.Distance == 20);
+            path.RemoveVertices((v, _) => v.Time == 20);
             checkNewId();
 
             path.ResampleVertices(new double[] { 5, 10, 15 });
@@ -253,7 +260,7 @@ namespace osu.Game.Rulesets.Catch.Tests
             path.Clear();
             checkNewId();
 
-            path.ConvertFromSliderPath(new SliderPath());
+            path.ConvertFromSliderPath(new SliderPath(), 1);
             checkNewId();
 
             void checkNewId()
@@ -263,25 +270,19 @@ namespace osu.Game.Rulesets.Catch.Tests
             }
         }
 
-        private void assertInvariants(IReadOnlyList<JuiceStreamPathVertex> vertices, bool checkSlope)
+        private void assertInvariants(IReadOnlyList<JuiceStreamPathVertex> vertices)
         {
             Assert.That(vertices, Is.Not.Empty);
 
             for (int i = 0; i < vertices.Count; i++)
             {
-                Assert.That(double.IsFinite(vertices[i].Distance));
+                Assert.That(double.IsFinite(vertices[i].Time));
                 Assert.That(float.IsFinite(vertices[i].X));
             }
 
             for (int i = 1; i < vertices.Count; i++)
             {
-                Assert.That(vertices[i].Distance, Is.GreaterThanOrEqualTo(vertices[i - 1].Distance));
-
-                if (!checkSlope) continue;
-
-                float xDiff = Math.Abs(vertices[i].X - vertices[i - 1].X);
-                double distanceDiff = vertices[i].Distance - vertices[i - 1].Distance;
-                Assert.That(xDiff, Is.LessThanOrEqualTo(distanceDiff).Within(Precision.FLOAT_EPSILON));
+                Assert.That(vertices[i].Time, Is.GreaterThanOrEqualTo(vertices[i - 1].Time));
             }
         }
     }
diff --git a/osu.Game.Rulesets.Catch/Edit/Blueprints/Components/EditablePath.cs b/osu.Game.Rulesets.Catch/Edit/Blueprints/Components/EditablePath.cs
index 1a43a10c81..3004d3644c 100644
--- a/osu.Game.Rulesets.Catch/Edit/Blueprints/Components/EditablePath.cs
+++ b/osu.Game.Rulesets.Catch/Edit/Blueprints/Components/EditablePath.cs
@@ -26,7 +26,7 @@ namespace osu.Game.Rulesets.Catch.Edit.Blueprints.Components
 
         public int VertexCount => path.Vertices.Count;
 
-        protected readonly Func<float, double> PositionToDistance;
+        protected readonly Func<float, double> PositionToTime;
 
         protected IReadOnlyList<VertexState> VertexStates => vertexStates;
 
@@ -44,9 +44,9 @@ namespace osu.Game.Rulesets.Catch.Edit.Blueprints.Components
         [CanBeNull]
         private IBeatSnapProvider beatSnapProvider { get; set; }
 
-        protected EditablePath(Func<float, double> positionToDistance)
+        protected EditablePath(Func<float, double> positionToTime)
         {
-            PositionToDistance = positionToDistance;
+            PositionToTime = positionToTime;
 
             Anchor = Anchor.BottomLeft;
         }
@@ -59,13 +59,13 @@ namespace osu.Game.Rulesets.Catch.Edit.Blueprints.Components
             while (InternalChildren.Count < path.Vertices.Count)
                 AddInternal(new VertexPiece());
 
-            double distanceToYFactor = -hitObjectContainer.LengthAtTime(hitObject.StartTime, hitObject.StartTime + 1 / hitObject.Velocity);
+            double timeToYFactor = -hitObjectContainer.LengthAtTime(hitObject.StartTime, hitObject.StartTime + 1);
 
             for (int i = 0; i < VertexCount; i++)
             {
                 var piece = (VertexPiece)InternalChildren[i];
                 var vertex = path.Vertices[i];
-                piece.Position = new Vector2(vertex.X, (float)(vertex.Distance * distanceToYFactor));
+                piece.Position = new Vector2(vertex.X, (float)(vertex.Time * timeToYFactor));
                 piece.UpdateFrom(vertexStates[i]);
             }
         }
@@ -73,7 +73,7 @@ namespace osu.Game.Rulesets.Catch.Edit.Blueprints.Components
         public void InitializeFromHitObject(JuiceStream hitObject)
         {
             var sliderPath = hitObject.Path;
-            path.ConvertFromSliderPath(sliderPath);
+            path.ConvertFromSliderPath(sliderPath, hitObject.Velocity);
 
             // If the original slider path has non-linear type segments, resample the vertices at nested hit object times to reduce the number of vertices.
             if (sliderPath.ControlPoints.Any(p => p.Type != null && p.Type != PathType.Linear))
@@ -92,11 +92,11 @@ namespace osu.Game.Rulesets.Catch.Edit.Blueprints.Components
 
         public void UpdateHitObjectFromPath(JuiceStream hitObject)
         {
-            path.ConvertToSliderPath(hitObject.Path, hitObject.LegacyConvertedY);
+            path.ConvertToSliderPath(hitObject.Path, hitObject.LegacyConvertedY, hitObject.Velocity);
 
             if (beatSnapProvider == null) return;
 
-            double endTime = hitObject.StartTime + path.Distance / hitObject.Velocity;
+            double endTime = hitObject.StartTime + path.Duration;
             double snappedEndTime = beatSnapProvider.SnapTime(endTime, hitObject.StartTime);
             hitObject.Path.ExpectedDistance.Value = (snappedEndTime - hitObject.StartTime) * hitObject.Velocity;
         }
@@ -108,9 +108,9 @@ namespace osu.Game.Rulesets.Catch.Edit.Blueprints.Components
 
         protected override bool ComputeIsMaskedAway(RectangleF maskingBounds) => false;
 
-        protected int AddVertex(double distance, float x)
+        protected int AddVertex(double time, float x)
         {
-            int index = path.InsertVertex(distance);
+            int index = path.InsertVertex(time);
             path.SetVertexPosition(index, x);
             vertexStates.Insert(index, new VertexState());
 
@@ -138,9 +138,9 @@ namespace osu.Game.Rulesets.Catch.Edit.Blueprints.Components
             return true;
         }
 
-        protected void MoveSelectedVertices(double distanceDelta, float xDelta)
+        protected void MoveSelectedVertices(double timeDelta, float xDelta)
         {
-            // Because the vertex list may be reordered due to distance change, the state list must be reordered as well.
+            // Because the vertex list may be reordered due to time change, the state list must be reordered as well.
             previousVertexStates.Clear();
             previousVertexStates.AddRange(vertexStates);
 
@@ -152,11 +152,11 @@ namespace osu.Game.Rulesets.Catch.Edit.Blueprints.Components
             for (int i = 1; i < vertexCount; i++)
             {
                 var state = previousVertexStates[i];
-                double distance = state.VertexBeforeChange.Distance;
+                double time = state.VertexBeforeChange.Time;
                 if (state.IsSelected)
-                    distance += distanceDelta;
+                    time += timeDelta;
 
-                int newIndex = path.InsertVertex(Math.Max(0, distance));
+                int newIndex = path.InsertVertex(Math.Max(0, time));
                 vertexStates.Insert(newIndex, state);
             }
 
diff --git a/osu.Game.Rulesets.Catch/Edit/Blueprints/Components/PlacementEditablePath.cs b/osu.Game.Rulesets.Catch/Edit/Blueprints/Components/PlacementEditablePath.cs
index 158872fbab..511aec5e5d 100644
--- a/osu.Game.Rulesets.Catch/Edit/Blueprints/Components/PlacementEditablePath.cs
+++ b/osu.Game.Rulesets.Catch/Edit/Blueprints/Components/PlacementEditablePath.cs
@@ -15,15 +15,15 @@ namespace osu.Game.Rulesets.Catch.Edit.Blueprints.Components
         /// </summary>
         private JuiceStreamPathVertex lastVertex;
 
-        public PlacementEditablePath(Func<float, double> positionToDistance)
-            : base(positionToDistance)
+        public PlacementEditablePath(Func<float, double> positionToTime)
+            : base(positionToTime)
         {
         }
 
         public void AddNewVertex()
         {
             var endVertex = Vertices[^1];
-            int index = AddVertex(endVertex.Distance, endVertex.X);
+            int index = AddVertex(endVertex.Time, endVertex.X);
 
             for (int i = 0; i < VertexCount; i++)
             {
@@ -41,9 +41,9 @@ namespace osu.Game.Rulesets.Catch.Edit.Blueprints.Components
         public void MoveLastVertex(Vector2 screenSpacePosition)
         {
             Vector2 position = ToRelativePosition(screenSpacePosition);
-            double distanceDelta = PositionToDistance(position.Y) - lastVertex.Distance;
+            double timeDelta = PositionToTime(position.Y) - lastVertex.Time;
             float xDelta = position.X - lastVertex.X;
-            MoveSelectedVertices(distanceDelta, xDelta);
+            MoveSelectedVertices(timeDelta, xDelta);
         }
     }
 }
diff --git a/osu.Game.Rulesets.Catch/Edit/Blueprints/Components/SelectionEditablePath.cs b/osu.Game.Rulesets.Catch/Edit/Blueprints/Components/SelectionEditablePath.cs
index 8c7314d0b6..b4c353313c 100644
--- a/osu.Game.Rulesets.Catch/Edit/Blueprints/Components/SelectionEditablePath.cs
+++ b/osu.Game.Rulesets.Catch/Edit/Blueprints/Components/SelectionEditablePath.cs
@@ -27,15 +27,15 @@ namespace osu.Game.Rulesets.Catch.Edit.Blueprints.Components
         [CanBeNull]
         private IEditorChangeHandler changeHandler { get; set; }
 
-        public SelectionEditablePath(Func<float, double> positionToDistance)
-            : base(positionToDistance)
+        public SelectionEditablePath(Func<float, double> positionToTime)
+            : base(positionToTime)
         {
         }
 
         public void AddVertex(Vector2 relativePosition)
         {
-            double distance = Math.Max(0, PositionToDistance(relativePosition.Y));
-            int index = AddVertex(distance, relativePosition.X);
+            double time = Math.Max(0, PositionToTime(relativePosition.Y));
+            int index = AddVertex(time, relativePosition.X);
             selectOnly(index);
         }
 
@@ -83,9 +83,9 @@ namespace osu.Game.Rulesets.Catch.Edit.Blueprints.Components
         protected override void OnDrag(DragEvent e)
         {
             Vector2 mousePosition = ToRelativePosition(e.ScreenSpaceMousePosition);
-            double distanceDelta = PositionToDistance(mousePosition.Y) - PositionToDistance(dragStartPosition.Y);
+            double timeDelta = PositionToTime(mousePosition.Y) - PositionToTime(dragStartPosition.Y);
             float xDelta = mousePosition.X - dragStartPosition.X;
-            MoveSelectedVertices(distanceDelta, xDelta);
+            MoveSelectedVertices(timeDelta, xDelta);
         }
 
         protected override void OnDragEnd(DragEndEvent e)
diff --git a/osu.Game.Rulesets.Catch/Edit/Blueprints/JuiceStreamPlacementBlueprint.cs b/osu.Game.Rulesets.Catch/Edit/Blueprints/JuiceStreamPlacementBlueprint.cs
index cff5bc2417..4a5a1d8160 100644
--- a/osu.Game.Rulesets.Catch/Edit/Blueprints/JuiceStreamPlacementBlueprint.cs
+++ b/osu.Game.Rulesets.Catch/Edit/Blueprints/JuiceStreamPlacementBlueprint.cs
@@ -30,7 +30,7 @@ namespace osu.Game.Rulesets.Catch.Edit.Blueprints
             {
                 scrollingPath = new ScrollingPath(),
                 nestedOutlineContainer = new NestedOutlineContainer(),
-                editablePath = new PlacementEditablePath(positionToDistance)
+                editablePath = new PlacementEditablePath(positionToTime)
             };
         }
 
@@ -119,10 +119,10 @@ namespace osu.Game.Rulesets.Catch.Edit.Blueprints
             lastEditablePathId = editablePath.PathId;
         }
 
-        private double positionToDistance(float relativeYPosition)
+        private double positionToTime(float relativeYPosition)
         {
             double time = HitObjectContainer.TimeAtPosition(relativeYPosition, HitObject.StartTime);
-            return (time - HitObject.StartTime) * HitObject.Velocity;
+            return time - HitObject.StartTime;
         }
     }
 }
diff --git a/osu.Game.Rulesets.Catch/Edit/Blueprints/JuiceStreamSelectionBlueprint.cs b/osu.Game.Rulesets.Catch/Edit/Blueprints/JuiceStreamSelectionBlueprint.cs
index 890d059d19..12054a1d16 100644
--- a/osu.Game.Rulesets.Catch/Edit/Blueprints/JuiceStreamSelectionBlueprint.cs
+++ b/osu.Game.Rulesets.Catch/Edit/Blueprints/JuiceStreamSelectionBlueprint.cs
@@ -62,7 +62,7 @@ namespace osu.Game.Rulesets.Catch.Edit.Blueprints
             {
                 scrollingPath = new ScrollingPath(),
                 nestedOutlineContainer = new NestedOutlineContainer(),
-                editablePath = new SelectionEditablePath(positionToDistance)
+                editablePath = new SelectionEditablePath(positionToTime)
             };
         }
 
@@ -145,10 +145,10 @@ namespace osu.Game.Rulesets.Catch.Edit.Blueprints
             return new RectangleF(left, top, right - left, bottom - top).Inflate(objectRadius);
         }
 
-        private double positionToDistance(float relativeYPosition)
+        private double positionToTime(float relativeYPosition)
         {
             double time = HitObjectContainer.TimeAtPosition(relativeYPosition, HitObject.StartTime);
-            return (time - HitObject.StartTime) * HitObject.Velocity;
+            return time - HitObject.StartTime;
         }
 
         private void initializeJuiceStreamPath()
diff --git a/osu.Game.Rulesets.Catch/Objects/JuiceStreamPath.cs b/osu.Game.Rulesets.Catch/Objects/JuiceStreamPath.cs
index 7207833fe6..d8cea3945c 100644
--- a/osu.Game.Rulesets.Catch/Objects/JuiceStreamPath.cs
+++ b/osu.Game.Rulesets.Catch/Objects/JuiceStreamPath.cs
@@ -20,11 +20,6 @@ namespace osu.Game.Rulesets.Catch.Objects
     /// However, the <see cref="SliderPath"/> representation is difficult to work with.
     /// This <see cref="JuiceStreamPath"/> represents the path in a more convenient way, a polyline connecting list of <see cref="JuiceStreamPathVertex"/>s.
     /// </para>
-    /// <para>
-    /// The path can be regarded as a function from the closed interval <c>[Vertices[0].Distance, Vertices[^1].Distance]</c> to the x position, given by <see cref="PositionAtDistance"/>.
-    /// To ensure the path is convertible to a <see cref="SliderPath"/>, the slope of the function must not be more than <c>1</c> everywhere,
-    /// and this slope condition is always maintained as an invariant.
-    /// </para>
     /// </summary>
     public class JuiceStreamPath
     {
@@ -46,9 +41,9 @@ namespace osu.Game.Rulesets.Catch.Objects
         public int InvalidationID { get; private set; } = 1;
 
         /// <summary>
-        /// The difference between first vertex's <see cref="JuiceStreamPathVertex.Distance"/> and last vertex's <see cref="JuiceStreamPathVertex.Distance"/>.
+        /// The difference between first vertex's <see cref="JuiceStreamPathVertex.Time"/> and last vertex's <see cref="JuiceStreamPathVertex.Time"/>.
         /// </summary>
-        public double Distance => vertices[^1].Distance - vertices[0].Distance;
+        public double Duration => vertices[^1].Time - vertices[0].Time;
 
         /// <remarks>
         /// This list should always be non-empty.
@@ -59,15 +54,15 @@ namespace osu.Game.Rulesets.Catch.Objects
         };
 
         /// <summary>
-        /// Compute the x-position of the path at the given <paramref name="distance"/>.
+        /// Compute the x-position of the path at the given <paramref name="time"/>.
         /// </summary>
         /// <remarks>
-        /// When the given distance is outside of the path, the x position at the corresponding endpoint is returned,
+        /// When the given time is outside of the path, the x position at the corresponding endpoint is returned,
         /// </remarks>
-        public float PositionAtDistance(double distance)
+        public float PositionAtTime(double time)
         {
-            int index = vertexIndexAtDistance(distance);
-            return positionAtDistance(distance, index);
+            int index = vertexIndexAtTime(time);
+            return positionAtTime(time, index);
         }
 
         /// <summary>
@@ -81,19 +76,19 @@ namespace osu.Game.Rulesets.Catch.Objects
         }
 
         /// <summary>
-        /// Insert a vertex at given <paramref name="distance"/>.
-        /// The <see cref="PositionAtDistance"/> is used as the position of the new vertex.
+        /// Insert a vertex at given <paramref name="time"/>.
+        /// The <see cref="PositionAtTime"/> is used as the position of the new vertex.
         /// Thus, the set of points of the path is not changed (up to floating-point precision).
         /// </summary>
         /// <returns>The index of the new vertex.</returns>
-        public int InsertVertex(double distance)
+        public int InsertVertex(double time)
         {
-            if (!double.IsFinite(distance))
-                throw new ArgumentOutOfRangeException(nameof(distance));
+            if (!double.IsFinite(time))
+                throw new ArgumentOutOfRangeException(nameof(time));
 
-            int index = vertexIndexAtDistance(distance);
-            float x = positionAtDistance(distance, index);
-            vertices.Insert(index, new JuiceStreamPathVertex(distance, x));
+            int index = vertexIndexAtTime(time);
+            float x = positionAtTime(time, index);
+            vertices.Insert(index, new JuiceStreamPathVertex(time, x));
 
             invalidate();
             return index;
@@ -101,7 +96,6 @@ namespace osu.Game.Rulesets.Catch.Objects
 
         /// <summary>
         /// Move the vertex of given <paramref name="index"/> to the given position <paramref name="newX"/>.
-        /// When the distances between vertices are too small for the new vertex positions, the adjacent vertices are moved towards <paramref name="newX"/>.
         /// </summary>
         public void SetVertexPosition(int index, float newX)
         {
@@ -111,32 +105,17 @@ namespace osu.Game.Rulesets.Catch.Objects
             if (!float.IsFinite(newX))
                 throw new ArgumentOutOfRangeException(nameof(newX));
 
-            var newVertex = new JuiceStreamPathVertex(vertices[index].Distance, newX);
-
-            for (int i = index - 1; i >= 0 && !canConnect(vertices[i], newVertex); i--)
-            {
-                float clampedX = clampToConnectablePosition(newVertex, vertices[i]);
-                vertices[i] = new JuiceStreamPathVertex(vertices[i].Distance, clampedX);
-            }
-
-            for (int i = index + 1; i < vertices.Count; i++)
-            {
-                float clampedX = clampToConnectablePosition(newVertex, vertices[i]);
-                vertices[i] = new JuiceStreamPathVertex(vertices[i].Distance, clampedX);
-            }
-
-            vertices[index] = newVertex;
+            vertices[index] = new JuiceStreamPathVertex(vertices[index].Time, newX);
 
             invalidate();
         }
 
         /// <summary>
-        /// Add a new vertex at given <paramref name="distance"/> and position.
-        /// Adjacent vertices are moved when necessary in the same way as <see cref="SetVertexPosition"/>.
+        /// Add a new vertex at given <paramref name="time"/> and position.
         /// </summary>
-        public void Add(double distance, float x)
+        public void Add(double time, float x)
         {
-            int index = InsertVertex(distance);
+            int index = InsertVertex(time);
             SetVertexPosition(index, x);
         }
 
@@ -163,22 +142,22 @@ namespace osu.Game.Rulesets.Catch.Objects
         }
 
         /// <summary>
-        /// Recreate this path by using difference set of vertices at given distances.
-        /// In addition to the given <paramref name="sampleDistances"/>, the first vertex and the last vertex are always added to the new path.
-        /// New vertices use the positions on the original path. Thus, <see cref="PositionAtDistance"/>s at <paramref name="sampleDistances"/> are preserved.
+        /// Recreate this path by using difference set of vertices at given time points.
+        /// In addition to the given <paramref name="sampleTimes"/>, the first vertex and the last vertex are always added to the new path.
+        /// New vertices use the positions on the original path. Thus, <see cref="PositionAtTime"/>s at <paramref name="sampleTimes"/> are preserved.
         /// </summary>
-        public void ResampleVertices(IEnumerable<double> sampleDistances)
+        public void ResampleVertices(IEnumerable<double> sampleTimes)
         {
             var sampledVertices = new List<JuiceStreamPathVertex>();
 
-            foreach (double distance in sampleDistances)
+            foreach (double time in sampleTimes)
             {
-                if (!double.IsFinite(distance))
-                    throw new ArgumentOutOfRangeException(nameof(sampleDistances));
+                if (!double.IsFinite(time))
+                    throw new ArgumentOutOfRangeException(nameof(sampleTimes));
 
-                double clampedDistance = Math.Clamp(distance, vertices[0].Distance, vertices[^1].Distance);
-                float x = PositionAtDistance(clampedDistance);
-                sampledVertices.Add(new JuiceStreamPathVertex(clampedDistance, x));
+                double clampedTime = Math.Clamp(time, vertices[0].Time, vertices[^1].Time);
+                float x = PositionAtTime(clampedTime);
+                sampledVertices.Add(new JuiceStreamPathVertex(clampedTime, x));
             }
 
             sampledVertices.Sort();
@@ -196,37 +175,57 @@ namespace osu.Game.Rulesets.Catch.Objects
         /// <remarks>
         /// Duplicated vertices are automatically removed.
         /// </remarks>
-        public void ConvertFromSliderPath(SliderPath sliderPath)
+        public void ConvertFromSliderPath(SliderPath sliderPath, double velocity)
         {
             var sliderPathVertices = new List<Vector2>();
             sliderPath.GetPathToProgress(sliderPathVertices, 0, 1);
 
-            double distance = 0;
+            double time = 0;
 
             vertices.Clear();
             vertices.Add(new JuiceStreamPathVertex(0, sliderPathVertices.FirstOrDefault().X));
 
             for (int i = 1; i < sliderPathVertices.Count; i++)
             {
-                distance += Vector2.Distance(sliderPathVertices[i - 1], sliderPathVertices[i]);
+                time += Vector2.Distance(sliderPathVertices[i - 1], sliderPathVertices[i]) / velocity;
 
-                if (!Precision.AlmostEquals(vertices[^1].Distance, distance))
-                    vertices.Add(new JuiceStreamPathVertex(distance, sliderPathVertices[i].X));
+                if (!Precision.AlmostEquals(vertices[^1].Time, time))
+                    Add(time, sliderPathVertices[i].X);
             }
 
             invalidate();
         }
 
+        /// <summary>
+        /// Computes the minimum slider velocity required to convert this path to a <see cref="SliderPath"/>.
+        /// </summary>
+        public double ComputeRequiredVelocity()
+        {
+            double maximumSlope = 0;
+
+            for (int i = 1; i < vertices.Count; i++)
+            {
+                double xDifference = Math.Abs((double)vertices[i].X - vertices[i - 1].X);
+                double timeDifference = vertices[i].Time - vertices[i - 1].Time;
+                maximumSlope = Math.Max(maximumSlope, xDifference / timeDifference);
+            }
+
+            return maximumSlope;
+        }
+
         /// <summary>
         /// Convert the path of this <see cref="JuiceStreamPath"/> to a <see cref="SliderPath"/> and write the result to <paramref name="sliderPath"/>.
         /// The resulting slider is "folded" to make it vertically contained in the playfield `(0..<see cref="OSU_PLAYFIELD_HEIGHT"/>)` assuming the slider start position is <paramref name="sliderStartY"/>.
+        ///
+        /// The velocity of the converted slider is assumed to be <paramref name="velocity"/>.
+        /// To preserve the path, <paramref name="velocity"/> should be at least the value returned by <see cref="ComputeRequiredVelocity"/>.
         /// </summary>
-        public void ConvertToSliderPath(SliderPath sliderPath, float sliderStartY)
+        public void ConvertToSliderPath(SliderPath sliderPath, float sliderStartY, double velocity)
         {
             const float margin = 1;
 
             // Note: these two variables and `sliderPath` are modified by the local functions.
-            double currentDistance = 0;
+            double currentTime = 0;
             Vector2 lastPosition = new Vector2(vertices[0].X, 0);
 
             sliderPath.ControlPoints.Clear();
@@ -237,10 +236,10 @@ namespace osu.Game.Rulesets.Catch.Objects
                 sliderPath.ControlPoints[^1].Type = PathType.Linear;
 
                 float deltaX = vertices[i].X - lastPosition.X;
-                double length = vertices[i].Distance - currentDistance;
+                double length = (vertices[i].Time - currentTime) * velocity;
 
                 // Should satisfy `deltaX^2 + deltaY^2 = length^2`.
-                // By invariants, the expression inside the `sqrt` is (almost) non-negative.
+                // The expression inside the `sqrt` is (almost) non-negative if the slider velocity is large enough.
                 double deltaY = Math.Sqrt(Math.Max(0, length * length - (double)deltaX * deltaX));
 
                 // When `deltaY` is small, one segment is always enough.
@@ -280,59 +279,38 @@ namespace osu.Game.Rulesets.Catch.Objects
             {
                 Vector2 nextPosition = new Vector2(nextX, nextY);
                 sliderPath.ControlPoints.Add(new PathControlPoint(nextPosition));
-                currentDistance += Vector2.Distance(lastPosition, nextPosition);
+                currentTime += Vector2.Distance(lastPosition, nextPosition) / velocity;
                 lastPosition = nextPosition;
             }
         }
 
         /// <summary>
-        /// Find the index at which a new vertex with <paramref name="distance"/> can be inserted.
+        /// Find the index at which a new vertex with <paramref name="time"/> can be inserted.
         /// </summary>
-        private int vertexIndexAtDistance(double distance)
+        private int vertexIndexAtTime(double time)
         {
-            // The position of `(distance, Infinity)` is uniquely determined because infinite positions are not allowed.
-            int i = vertices.BinarySearch(new JuiceStreamPathVertex(distance, float.PositiveInfinity));
+            // The position of `(time, Infinity)` is uniquely determined because infinite positions are not allowed.
+            int i = vertices.BinarySearch(new JuiceStreamPathVertex(time, float.PositiveInfinity));
             return i < 0 ? ~i : i;
         }
 
         /// <summary>
-        /// Compute the position at the given <paramref name="distance"/>, assuming <paramref name="index"/> is the vertex index returned by <see cref="vertexIndexAtDistance"/>.
+        /// Compute the position at the given <paramref name="time"/>, assuming <paramref name="index"/> is the vertex index returned by <see cref="vertexIndexAtTime"/>.
         /// </summary>
-        private float positionAtDistance(double distance, int index)
+        private float positionAtTime(double time, int index)
         {
             if (index <= 0)
                 return vertices[0].X;
             if (index >= vertices.Count)
                 return vertices[^1].X;
 
-            double length = vertices[index].Distance - vertices[index - 1].Distance;
-            if (Precision.AlmostEquals(length, 0))
+            double duration = vertices[index].Time - vertices[index - 1].Time;
+            if (Precision.AlmostEquals(duration, 0))
                 return vertices[index].X;
 
             float deltaX = vertices[index].X - vertices[index - 1].X;
 
-            return (float)(vertices[index - 1].X + deltaX * ((distance - vertices[index - 1].Distance) / length));
-        }
-
-        /// <summary>
-        /// Check the two vertices can connected directly while satisfying the slope condition.
-        /// </summary>
-        private bool canConnect(JuiceStreamPathVertex vertex1, JuiceStreamPathVertex vertex2, float allowance = 0)
-        {
-            double xDistance = Math.Abs((double)vertex2.X - vertex1.X);
-            float length = (float)Math.Abs(vertex2.Distance - vertex1.Distance);
-            return xDistance <= length + allowance;
-        }
-
-        /// <summary>
-        /// Move the position of <paramref name="movableVertex"/> towards the position of <paramref name="fixedVertex"/>
-        /// until the vertex pair satisfies the condition <see cref="canConnect"/>.
-        /// </summary>
-        /// <returns>The resulting position of <paramref name="movableVertex"/>.</returns>
-        private float clampToConnectablePosition(JuiceStreamPathVertex fixedVertex, JuiceStreamPathVertex movableVertex)
-        {
-            float length = (float)Math.Abs(movableVertex.Distance - fixedVertex.Distance);
-            return Math.Clamp(movableVertex.X, fixedVertex.X - length, fixedVertex.X + length);
+            return (float)(vertices[index - 1].X + deltaX * ((time - vertices[index - 1].Time) / duration));
         }
 
         private void invalidate() => InvalidationID++;
diff --git a/osu.Game.Rulesets.Catch/Objects/JuiceStreamPathVertex.cs b/osu.Game.Rulesets.Catch/Objects/JuiceStreamPathVertex.cs
index 58c50603c4..afef2e637f 100644
--- a/osu.Game.Rulesets.Catch/Objects/JuiceStreamPathVertex.cs
+++ b/osu.Game.Rulesets.Catch/Objects/JuiceStreamPathVertex.cs
@@ -12,22 +12,22 @@ namespace osu.Game.Rulesets.Catch.Objects
     /// </summary>
     public readonly struct JuiceStreamPathVertex : IComparable<JuiceStreamPathVertex>
     {
-        public readonly double Distance;
+        public readonly double Time;
 
         public readonly float X;
 
-        public JuiceStreamPathVertex(double distance, float x)
+        public JuiceStreamPathVertex(double time, float x)
         {
-            Distance = distance;
+            Time = time;
             X = x;
         }
 
         public int CompareTo(JuiceStreamPathVertex other)
         {
-            int c = Distance.CompareTo(other.Distance);
+            int c = Time.CompareTo(other.Time);
             return c != 0 ? c : X.CompareTo(other.X);
         }
 
-        public override string ToString() => $"({Distance}, {X})";
+        public override string ToString() => $"({Time}, {X})";
     }
 }

From 9ffa90602bc675ed0a37eac66845b34f36948f8f Mon Sep 17 00:00:00 2001
From: ekrctb <ekrctb@gmail.com>
Date: Sun, 8 May 2022 21:17:57 +0900
Subject: [PATCH 4665/5547] Automatically set slider velocity from juice stream
 path

---
 .../Blueprints/Components/EditablePath.cs     | 22 +++++++++++++++++--
 .../Objects/JuiceStreamPath.cs                |  5 +++++
 2 files changed, 25 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Rulesets.Catch/Edit/Blueprints/Components/EditablePath.cs b/osu.Game.Rulesets.Catch/Edit/Blueprints/Components/EditablePath.cs
index 3004d3644c..20e303dad1 100644
--- a/osu.Game.Rulesets.Catch/Edit/Blueprints/Components/EditablePath.cs
+++ b/osu.Game.Rulesets.Catch/Edit/Blueprints/Components/EditablePath.cs
@@ -92,13 +92,31 @@ namespace osu.Game.Rulesets.Catch.Edit.Blueprints.Components
 
         public void UpdateHitObjectFromPath(JuiceStream hitObject)
         {
-            path.ConvertToSliderPath(hitObject.Path, hitObject.LegacyConvertedY, hitObject.Velocity);
+            // The SV setting may need to be changed for the current path.
+            var svBindable = hitObject.DifficultyControlPoint.SliderVelocityBindable;
+            double svToVelocityFactor = hitObject.Velocity / svBindable.Value;
+            double requiredVelocity = path.ComputeRequiredVelocity();
+
+            // The value is pre-rounded here because setting it to the bindable will rounded to the nearest value
+            // but it should be always rounded up to satisfy the required minimum velocity condition.
+            //
+            // This is rounded to integers instead of using the precision of the bindable
+            // because it results in a smaller number of non-redundant control points.
+            //
+            // The value is clamped here by the bindable min and max values.
+            // In case the required velocity is too large, the path is not preserved.
+            svBindable.Value = Math.Ceiling(requiredVelocity / svToVelocityFactor);
+
+            // Calculate the velocity using the resulting SV because `hitObject.Velocity` is not recomputed yet.
+            double velocity = svBindable.Value * svToVelocityFactor;
+
+            path.ConvertToSliderPath(hitObject.Path, hitObject.LegacyConvertedY, velocity);
 
             if (beatSnapProvider == null) return;
 
             double endTime = hitObject.StartTime + path.Duration;
             double snappedEndTime = beatSnapProvider.SnapTime(endTime, hitObject.StartTime);
-            hitObject.Path.ExpectedDistance.Value = (snappedEndTime - hitObject.StartTime) * hitObject.Velocity;
+            hitObject.Path.ExpectedDistance.Value = (snappedEndTime - hitObject.StartTime) * velocity;
         }
 
         public Vector2 ToRelativePosition(Vector2 screenSpacePosition)
diff --git a/osu.Game.Rulesets.Catch/Objects/JuiceStreamPath.cs b/osu.Game.Rulesets.Catch/Objects/JuiceStreamPath.cs
index d8cea3945c..61f4c580ae 100644
--- a/osu.Game.Rulesets.Catch/Objects/JuiceStreamPath.cs
+++ b/osu.Game.Rulesets.Catch/Objects/JuiceStreamPath.cs
@@ -207,6 +207,11 @@ namespace osu.Game.Rulesets.Catch.Objects
             {
                 double xDifference = Math.Abs((double)vertices[i].X - vertices[i - 1].X);
                 double timeDifference = vertices[i].Time - vertices[i - 1].Time;
+
+                // A short segment won't affect the resulting path much anyways so ignore it to avoid divide-by-zero.
+                if (Precision.AlmostEquals(timeDifference, 0))
+                    continue;
+
                 maximumSlope = Math.Max(maximumSlope, xDifference / timeDifference);
             }
 

From 0e98bb28bda2c7dcedba4d4637493e61c3c28d8e Mon Sep 17 00:00:00 2001
From: ekrctb <ekrctb@gmail.com>
Date: Sun, 8 May 2022 21:21:51 +0900
Subject: [PATCH 4666/5547] Fix wrong resampling times are used for juice
 stream path

---
 .../Edit/Blueprints/Components/EditablePath.cs                  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Catch/Edit/Blueprints/Components/EditablePath.cs b/osu.Game.Rulesets.Catch/Edit/Blueprints/Components/EditablePath.cs
index 20e303dad1..652d083c4e 100644
--- a/osu.Game.Rulesets.Catch/Edit/Blueprints/Components/EditablePath.cs
+++ b/osu.Game.Rulesets.Catch/Edit/Blueprints/Components/EditablePath.cs
@@ -80,7 +80,7 @@ namespace osu.Game.Rulesets.Catch.Edit.Blueprints.Components
             {
                 path.ResampleVertices(hitObject.NestedHitObjects
                                                .Skip(1).TakeWhile(h => !(h is Fruit)) // Only droplets in the first span are used.
-                                               .Select(h => (h.StartTime - hitObject.StartTime) * hitObject.Velocity));
+                                               .Select(h => h.StartTime - hitObject.StartTime));
             }
 
             vertexStates.Clear();

From 670922c8e563c202b6d7e396450f64ce77ecb78d Mon Sep 17 00:00:00 2001
From: ekrctb <ekrctb@gmail.com>
Date: Sun, 8 May 2022 21:32:05 +0900
Subject: [PATCH 4667/5547] Use latest slider velocity for juice stream
 velocity computation.

This fixes one-frame glitch in editor when slider velocity is changed.
---
 osu.Game.Rulesets.Catch/Objects/JuiceStream.cs | 16 ++++++++++------
 1 file changed, 10 insertions(+), 6 deletions(-)

diff --git a/osu.Game.Rulesets.Catch/Objects/JuiceStream.cs b/osu.Game.Rulesets.Catch/Objects/JuiceStream.cs
index 282afb6343..d34452cdbb 100644
--- a/osu.Game.Rulesets.Catch/Objects/JuiceStream.cs
+++ b/osu.Game.Rulesets.Catch/Objects/JuiceStream.cs
@@ -27,10 +27,16 @@ namespace osu.Game.Rulesets.Catch.Objects
         public int RepeatCount { get; set; }
 
         [JsonIgnore]
-        public double Velocity { get; private set; }
+        private double velocityFactor;
 
         [JsonIgnore]
-        public double TickDistance { get; private set; }
+        private double tickDistanceFactor;
+
+        [JsonIgnore]
+        public double Velocity => velocityFactor * DifficultyControlPoint.SliderVelocity;
+
+        [JsonIgnore]
+        public double TickDistance => tickDistanceFactor * DifficultyControlPoint.SliderVelocity;
 
         /// <summary>
         /// The length of one span of this <see cref="JuiceStream"/>.
@@ -43,10 +49,8 @@ namespace osu.Game.Rulesets.Catch.Objects
 
             TimingControlPoint timingPoint = controlPointInfo.TimingPointAt(StartTime);
 
-            double scoringDistance = base_scoring_distance * difficulty.SliderMultiplier * DifficultyControlPoint.SliderVelocity;
-
-            Velocity = scoringDistance / timingPoint.BeatLength;
-            TickDistance = scoringDistance / difficulty.SliderTickRate;
+            velocityFactor = base_scoring_distance * difficulty.SliderMultiplier / timingPoint.BeatLength;
+            tickDistanceFactor = base_scoring_distance * difficulty.SliderMultiplier / difficulty.SliderTickRate;
         }
 
         protected override void CreateNestedHitObjects(CancellationToken cancellationToken)

From 37c9aac49f836bb49f57c0ea246998dcf6815144 Mon Sep 17 00:00:00 2001
From: ekrctb <ekrctb@gmail.com>
Date: Sun, 8 May 2022 21:35:06 +0900
Subject: [PATCH 4668/5547] Make `ScrollingPath` use time instead of distance.

This is consistent as other components now use time instead of distance.
---
 .../Edit/Blueprints/Components/ScrollingPath.cs  | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/osu.Game.Rulesets.Catch/Edit/Blueprints/Components/ScrollingPath.cs b/osu.Game.Rulesets.Catch/Edit/Blueprints/Components/ScrollingPath.cs
index 109bf61ea5..cfaca2f9a4 100644
--- a/osu.Game.Rulesets.Catch/Edit/Blueprints/Components/ScrollingPath.cs
+++ b/osu.Game.Rulesets.Catch/Edit/Blueprints/Components/ScrollingPath.cs
@@ -17,7 +17,7 @@ namespace osu.Game.Rulesets.Catch.Edit.Blueprints.Components
     {
         private readonly Path drawablePath;
 
-        private readonly List<(double Distance, float X)> vertices = new List<(double, float)>();
+        private readonly List<(double Time, float X)> vertices = new List<(double, float)>();
 
         public ScrollingPath()
         {
@@ -35,16 +35,16 @@ namespace osu.Game.Rulesets.Catch.Edit.Blueprints.Components
 
         public void UpdatePathFrom(ScrollingHitObjectContainer hitObjectContainer, JuiceStream hitObject)
         {
-            double distanceToYFactor = -hitObjectContainer.LengthAtTime(hitObject.StartTime, hitObject.StartTime + 1 / hitObject.Velocity);
+            double timeToYFactor = -hitObjectContainer.LengthAtTime(hitObject.StartTime, hitObject.StartTime + 1);
 
-            computeDistanceXs(hitObject);
+            computeTimeXs(hitObject);
             drawablePath.Vertices = vertices
-                                    .Select(v => new Vector2(v.X, (float)(v.Distance * distanceToYFactor)))
+                                    .Select(v => new Vector2(v.X, (float)(v.Time * timeToYFactor)))
                                     .ToArray();
             drawablePath.OriginPosition = drawablePath.PositionInBoundingBox(Vector2.Zero);
         }
 
-        private void computeDistanceXs(JuiceStream hitObject)
+        private void computeTimeXs(JuiceStream hitObject)
         {
             vertices.Clear();
 
@@ -54,17 +54,17 @@ namespace osu.Game.Rulesets.Catch.Edit.Blueprints.Components
             if (sliderVertices.Count == 0)
                 return;
 
-            double distance = 0;
+            double time = 0;
             Vector2 lastPosition = Vector2.Zero;
 
             for (int repeat = 0; repeat < hitObject.RepeatCount + 1; repeat++)
             {
                 foreach (var position in sliderVertices)
                 {
-                    distance += Vector2.Distance(lastPosition, position);
+                    time += Vector2.Distance(lastPosition, position) / hitObject.Velocity;
                     lastPosition = position;
 
-                    vertices.Add((distance, position.X));
+                    vertices.Add((time, position.X));
                 }
 
                 sliderVertices.Reverse();

From 7daa3d8eb79b59756fad96810012c01e3a167dfe Mon Sep 17 00:00:00 2001
From: ekrctb <ekrctb@gmail.com>
Date: Sun, 8 May 2022 21:54:14 +0900
Subject: [PATCH 4669/5547] Remove now-redundant velocity calculation

Velocity is computed from the up-to-date SV now.
---
 .../Edit/Blueprints/Components/EditablePath.cs             | 7 ++-----
 1 file changed, 2 insertions(+), 5 deletions(-)

diff --git a/osu.Game.Rulesets.Catch/Edit/Blueprints/Components/EditablePath.cs b/osu.Game.Rulesets.Catch/Edit/Blueprints/Components/EditablePath.cs
index 652d083c4e..e038562b4b 100644
--- a/osu.Game.Rulesets.Catch/Edit/Blueprints/Components/EditablePath.cs
+++ b/osu.Game.Rulesets.Catch/Edit/Blueprints/Components/EditablePath.cs
@@ -107,16 +107,13 @@ namespace osu.Game.Rulesets.Catch.Edit.Blueprints.Components
             // In case the required velocity is too large, the path is not preserved.
             svBindable.Value = Math.Ceiling(requiredVelocity / svToVelocityFactor);
 
-            // Calculate the velocity using the resulting SV because `hitObject.Velocity` is not recomputed yet.
-            double velocity = svBindable.Value * svToVelocityFactor;
-
-            path.ConvertToSliderPath(hitObject.Path, hitObject.LegacyConvertedY, velocity);
+            path.ConvertToSliderPath(hitObject.Path, hitObject.LegacyConvertedY, hitObject.Velocity);
 
             if (beatSnapProvider == null) return;
 
             double endTime = hitObject.StartTime + path.Duration;
             double snappedEndTime = beatSnapProvider.SnapTime(endTime, hitObject.StartTime);
-            hitObject.Path.ExpectedDistance.Value = (snappedEndTime - hitObject.StartTime) * velocity;
+            hitObject.Path.ExpectedDistance.Value = (snappedEndTime - hitObject.StartTime) * hitObject.Velocity;
         }
 
         public Vector2 ToRelativePosition(Vector2 screenSpacePosition)

From d8a4f9d37ddb42a2e0a73f51e5112edab432964a Mon Sep 17 00:00:00 2001
From: ekrctb <ekrctb@gmail.com>
Date: Sun, 8 May 2022 22:33:16 +0900
Subject: [PATCH 4670/5547] Update juice stream blueprint tests

No "clipping" occur anymore for vertex positions. Instead, clipping may occur when the path is converted to a slider.
Add tests for automatic slider velocity change.
---
 .../TestSceneJuiceStreamPlacementBlueprint.cs | 29 +++++------------
 .../TestSceneJuiceStreamSelectionBlueprint.cs | 31 +++++--------------
 2 files changed, 15 insertions(+), 45 deletions(-)

diff --git a/osu.Game.Rulesets.Catch.Tests/Editor/TestSceneJuiceStreamPlacementBlueprint.cs b/osu.Game.Rulesets.Catch.Tests/Editor/TestSceneJuiceStreamPlacementBlueprint.cs
index 981efc9a13..b1adc4901c 100644
--- a/osu.Game.Rulesets.Catch.Tests/Editor/TestSceneJuiceStreamPlacementBlueprint.cs
+++ b/osu.Game.Rulesets.Catch.Tests/Editor/TestSceneJuiceStreamPlacementBlueprint.cs
@@ -19,7 +19,7 @@ namespace osu.Game.Rulesets.Catch.Tests.Editor
 {
     public class TestSceneJuiceStreamPlacementBlueprint : CatchPlacementBlueprintTestScene
     {
-        private const double velocity = 0.5;
+        private const double velocity_factor = 0.5;
 
         private JuiceStream lastObject => LastObject?.HitObject as JuiceStream;
 
@@ -27,7 +27,7 @@ namespace osu.Game.Rulesets.Catch.Tests.Editor
         {
             var playable = base.GetPlayableBeatmap();
             playable.Difficulty.SliderTickRate = 5;
-            playable.Difficulty.SliderMultiplier = velocity * 10;
+            playable.Difficulty.SliderMultiplier = velocity_factor * 10;
             return playable;
         }
 
@@ -43,6 +43,7 @@ namespace osu.Game.Rulesets.Catch.Tests.Editor
             AddAssert("end time is correct", () => Precision.AlmostEquals(lastObject.EndTime, times[1]));
             AddAssert("start position is correct", () => Precision.AlmostEquals(lastObject.OriginalX, positions[0]));
             AddAssert("end position is correct", () => Precision.AlmostEquals(lastObject.EndX, positions[1]));
+            AddAssert("default slider velocity", () => lastObject.DifficultyControlPoint.SliderVelocityBindable.IsDefault);
         }
 
         [Test]
@@ -66,28 +67,21 @@ namespace osu.Game.Rulesets.Catch.Tests.Editor
         }
 
         [Test]
-        public void TestVelocityLimit()
+        public void TestSliderVelocityChange()
         {
             double[] times = { 100, 300 };
             float[] positions = { 200, 500 };
             addPlacementSteps(times, positions);
-            addPathCheckStep(times, new float[] { 200, 300 });
-        }
+            addPathCheckStep(times, positions);
 
-        [Test]
-        public void TestPreviousVerticesAreFixed()
-        {
-            double[] times = { 100, 300, 500, 700 };
-            float[] positions = { 200, 400, 100, 500 };
-            addPlacementSteps(times, positions);
-            addPathCheckStep(times, new float[] { 200, 300, 200, 300 });
+            AddAssert("slider velocity changed", () => !lastObject.DifficultyControlPoint.SliderVelocityBindable.IsDefault);
         }
 
         [Test]
         public void TestClampedPositionIsRestored()
         {
             double[] times = { 100, 300, 500 };
-            float[] positions = { 200, 200, 0, 250 };
+            float[] positions = { 200, 200, -3000, 250 };
 
             addMoveAndClickSteps(times[0], positions[0]);
             addMoveAndClickSteps(times[1], positions[1]);
@@ -97,15 +91,6 @@ namespace osu.Game.Rulesets.Catch.Tests.Editor
             addPathCheckStep(times, new float[] { 200, 200, 250 });
         }
 
-        [Test]
-        public void TestFirstVertexIsFixed()
-        {
-            double[] times = { 100, 200 };
-            float[] positions = { 100, 300 };
-            addPlacementSteps(times, positions);
-            addPathCheckStep(times, new float[] { 100, 150 });
-        }
-
         [Test]
         public void TestOutOfOrder()
         {
diff --git a/osu.Game.Rulesets.Catch.Tests/Editor/TestSceneJuiceStreamSelectionBlueprint.cs b/osu.Game.Rulesets.Catch.Tests/Editor/TestSceneJuiceStreamSelectionBlueprint.cs
index 123316f461..22a839d847 100644
--- a/osu.Game.Rulesets.Catch.Tests/Editor/TestSceneJuiceStreamSelectionBlueprint.cs
+++ b/osu.Game.Rulesets.Catch.Tests/Editor/TestSceneJuiceStreamSelectionBlueprint.cs
@@ -101,31 +101,16 @@ namespace osu.Game.Rulesets.Catch.Tests.Editor
         }
 
         [Test]
-        public void TestClampedPositionIsRestored()
+        public void TestSliderVelocityChange()
         {
-            const double velocity = 0.25;
-            double[] times = { 100, 500, 700 };
-            float[] positions = { 100, 100, 100 };
-            addBlueprintStep(times, positions, velocity);
+            double[] times = { 100, 300 };
+            float[] positions = { 200, 300 };
+            addBlueprintStep(times, positions);
+            AddAssert("default slider velocity", () => hitObject.DifficultyControlPoint.SliderVelocityBindable.IsDefault);
 
             addDragStartStep(times[1], positions[1]);
-
-            AddMouseMoveStep(times[1], 200);
-            addVertexCheckStep(3, 1, times[1], 200);
-            addVertexCheckStep(3, 2, times[2], 150);
-
-            AddMouseMoveStep(times[1], 100);
-            addVertexCheckStep(3, 1, times[1], 100);
-            // Stored position is restored.
-            addVertexCheckStep(3, 2, times[2], positions[2]);
-
-            AddMouseMoveStep(times[1], 300);
-            addDragEndStep();
-            addDragStartStep(times[1], 300);
-
-            AddMouseMoveStep(times[1], 100);
-            // Position is different because a changed position is committed when the previous drag is ended.
-            addVertexCheckStep(3, 2, times[2], 250);
+            AddMouseMoveStep(times[1], 400);
+            AddAssert("slider velocity changed", () => !hitObject.DifficultyControlPoint.SliderVelocityBindable.IsDefault);
         }
 
         [Test]
@@ -174,7 +159,7 @@ namespace osu.Game.Rulesets.Catch.Tests.Editor
             addAddVertexSteps(500, 150);
             addVertexCheckStep(3, 1, 500, 150);
 
-            addAddVertexSteps(90, 220);
+            addAddVertexSteps(90, 200);
             addVertexCheckStep(4, 1, times[0], positions[0]);
 
             addAddVertexSteps(750, 180);

From 6bdcf893b7d6c960d8154c9908b78f8c92a6c273 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 8 May 2022 15:13:29 +0200
Subject: [PATCH 4671/5547] Move alpha management closer to screen level

Felt bad messing with alpha at the column level.
---
 osu.Game/Overlays/Mods/ModColumn.cs       |  1 -
 osu.Game/Overlays/Mods/ModSelectScreen.cs | 13 ++++++++-----
 2 files changed, 8 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Overlays/Mods/ModColumn.cs b/osu.Game/Overlays/Mods/ModColumn.cs
index 89f472a290..3a2fda0bb0 100644
--- a/osu.Game/Overlays/Mods/ModColumn.cs
+++ b/osu.Game/Overlays/Mods/ModColumn.cs
@@ -350,7 +350,6 @@ namespace osu.Game.Overlays.Mods
             }
 
             allFiltered.Value = panelFlow.All(panel => panel.Filtered.Value);
-            Alpha = allFiltered.Value ? 0 : 1;
 
             if (toggleAllCheckbox != null && !SelectionAnimationRunning)
             {
diff --git a/osu.Game/Overlays/Mods/ModSelectScreen.cs b/osu.Game/Overlays/Mods/ModSelectScreen.cs
index 6a3df3fb05..a2e73b9575 100644
--- a/osu.Game/Overlays/Mods/ModSelectScreen.cs
+++ b/osu.Game/Overlays/Mods/ModSelectScreen.cs
@@ -580,17 +580,20 @@ namespace osu.Game.Overlays.Mods
             protected override void LoadComplete()
             {
                 base.LoadComplete();
-                Active.BindValueChanged(_ => updateDim(), true);
+                Active.BindValueChanged(_ => updateState());
+                Column.AllFiltered.BindValueChanged(_ => updateState(), true);
                 FinishTransforms();
             }
 
             protected override bool RequiresChildrenUpdate => base.RequiresChildrenUpdate || Column.SelectionAnimationRunning;
 
-            private void updateDim()
+            private void updateState()
             {
                 Colour4 targetColour;
 
-                if (Active.Value)
+                Column.Alpha = Column.AllFiltered.Value ? 0 : 1;
+
+                if (Column.Active.Value)
                     targetColour = Colour4.White;
                 else
                     targetColour = IsHovered ? colours.GrayC : colours.Gray8;
@@ -609,14 +612,14 @@ namespace osu.Game.Overlays.Mods
             protected override bool OnHover(HoverEvent e)
             {
                 base.OnHover(e);
-                updateDim();
+                updateState();
                 return Active.Value;
             }
 
             protected override void OnHoverLost(HoverLostEvent e)
             {
                 base.OnHoverLost(e);
-                updateDim();
+                updateState();
             }
         }
 

From d964b4f23c47df79e7c27acdcb7056b7b8774210 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 8 May 2022 15:22:32 +0200
Subject: [PATCH 4672/5547] Fix uneven spacing when some mod columns are hidden

---
 osu.Game/Overlays/Mods/ModSelectScreen.cs | 14 +++++++++++---
 1 file changed, 11 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Overlays/Mods/ModSelectScreen.cs b/osu.Game/Overlays/Mods/ModSelectScreen.cs
index a2e73b9575..8b19e38954 100644
--- a/osu.Game/Overlays/Mods/ModSelectScreen.cs
+++ b/osu.Game/Overlays/Mods/ModSelectScreen.cs
@@ -129,7 +129,6 @@ namespace osu.Game.Overlays.Mods
                                 Shear = new Vector2(SHEAR, 0),
                                 RelativeSizeAxes = Axes.Y,
                                 AutoSizeAxes = Axes.X,
-                                Spacing = new Vector2(10, 0),
                                 Margin = new MarginPadding { Horizontal = 70 },
                                 Children = new[]
                                 {
@@ -237,12 +236,21 @@ namespace osu.Game.Overlays.Mods
         }
 
         private ColumnDimContainer createModColumnContent(ModType modType, Key[]? toggleKeys = null)
-            => new ColumnDimContainer(CreateModColumn(modType, toggleKeys).With(column => column.Filter = IsValidMod))
+        {
+            var column = CreateModColumn(modType, toggleKeys).With(column =>
+            {
+                column.Filter = IsValidMod;
+                // spacing applied here rather than via `columnFlow.Spacing` to avoid uneven gaps when some of the columns are hidden.
+                column.Margin = new MarginPadding { Right = 10 };
+            });
+
+            return new ColumnDimContainer(column)
             {
                 AutoSizeAxes = Axes.X,
                 RelativeSizeAxes = Axes.Y,
-                RequestScroll = column => columnScroll.ScrollIntoView(column, extraScroll: 140),
+                RequestScroll = col => columnScroll.ScrollIntoView(col, extraScroll: 140),
             };
+        }
 
         private ShearedButton[] createDefaultFooterButtons()
             => new[]

From 483a611c411ea64e24ca8e3a63fe58cb53cc99d3 Mon Sep 17 00:00:00 2001
From: ekrctb <ekrctb@gmail.com>
Date: Sun, 8 May 2022 23:10:51 +0900
Subject: [PATCH 4673/5547] Fix `BeginPlacement` location.

---
 .../Edit/Blueprints/BananaShowerPlacementBlueprint.cs    | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Rulesets.Catch/Edit/Blueprints/BananaShowerPlacementBlueprint.cs b/osu.Game.Rulesets.Catch/Edit/Blueprints/BananaShowerPlacementBlueprint.cs
index 4613bfd36e..44cfea7779 100644
--- a/osu.Game.Rulesets.Catch/Edit/Blueprints/BananaShowerPlacementBlueprint.cs
+++ b/osu.Game.Rulesets.Catch/Edit/Blueprints/BananaShowerPlacementBlueprint.cs
@@ -18,13 +18,18 @@ namespace osu.Game.Rulesets.Catch.Edit.Blueprints
             InternalChild = outline = new TimeSpanOutline();
         }
 
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            BeginPlacement();
+        }
+
         protected override void Update()
         {
             base.Update();
 
             outline.UpdateFrom(HitObjectContainer, HitObject);
-
-            BeginPlacement();
         }
 
         protected override bool OnMouseDown(MouseDownEvent e)

From 158f1342608ff147b27ee48ef52652bded7632d2 Mon Sep 17 00:00:00 2001
From: ekrctb <ekrctb@gmail.com>
Date: Mon, 9 May 2022 00:01:05 +0900
Subject: [PATCH 4674/5547] Fix duration is negative while placing banana
 shower in catch editor.

Timeline blueprint is glitched when the hit object has negative duration.
Negative duration is unwanted anyways so placement implementation is fixed instead of supporting it in timline blueprint.
---
 .../TestSceneBananaShowerPlacementBlueprint.cs |  3 +++
 .../BananaShowerPlacementBlueprint.cs          | 18 +++++++++---------
 2 files changed, 12 insertions(+), 9 deletions(-)

diff --git a/osu.Game.Rulesets.Catch.Tests/Editor/TestSceneBananaShowerPlacementBlueprint.cs b/osu.Game.Rulesets.Catch.Tests/Editor/TestSceneBananaShowerPlacementBlueprint.cs
index cca3701a60..fec253924f 100644
--- a/osu.Game.Rulesets.Catch.Tests/Editor/TestSceneBananaShowerPlacementBlueprint.cs
+++ b/osu.Game.Rulesets.Catch.Tests/Editor/TestSceneBananaShowerPlacementBlueprint.cs
@@ -55,7 +55,10 @@ namespace osu.Game.Rulesets.Catch.Tests.Editor
 
             AddMoveStep(end_time, 0);
             AddClickStep(MouseButton.Left);
+
             AddMoveStep(start_time, 0);
+            AddAssert("duration is positive", () => ((BananaShower)CurrentBlueprint.HitObject).Duration > 0);
+
             AddClickStep(MouseButton.Right);
             AddAssert("start time is correct", () => Precision.AlmostEquals(LastObject.HitObject.StartTime, start_time));
             AddAssert("end time is correct", () => Precision.AlmostEquals(LastObject.HitObject.GetEndTime(), end_time));
diff --git a/osu.Game.Rulesets.Catch/Edit/Blueprints/BananaShowerPlacementBlueprint.cs b/osu.Game.Rulesets.Catch/Edit/Blueprints/BananaShowerPlacementBlueprint.cs
index 6dea8b0712..c3a5306b3f 100644
--- a/osu.Game.Rulesets.Catch/Edit/Blueprints/BananaShowerPlacementBlueprint.cs
+++ b/osu.Game.Rulesets.Catch/Edit/Blueprints/BananaShowerPlacementBlueprint.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.Input.Events;
 using osu.Game.Rulesets.Catch.Edit.Blueprints.Components;
 using osu.Game.Rulesets.Catch.Objects;
@@ -13,6 +14,9 @@ namespace osu.Game.Rulesets.Catch.Edit.Blueprints
     {
         private readonly TimeSpanOutline outline;
 
+        private double placementStartTime;
+        private double placementEndTime;
+
         public BananaShowerPlacementBlueprint()
         {
             InternalChild = outline = new TimeSpanOutline();
@@ -38,13 +42,6 @@ namespace osu.Game.Rulesets.Catch.Edit.Blueprints
                 case PlacementState.Active:
                     if (e.Button != MouseButton.Right) break;
 
-                    // If the duration is negative, swap the start and the end time to make the duration positive.
-                    if (HitObject.Duration < 0)
-                    {
-                        HitObject.StartTime = HitObject.EndTime;
-                        HitObject.Duration = -HitObject.Duration;
-                    }
-
                     EndPlacement(HitObject.Duration > 0);
                     return true;
             }
@@ -61,13 +58,16 @@ namespace osu.Game.Rulesets.Catch.Edit.Blueprints
             switch (PlacementActive)
             {
                 case PlacementState.Waiting:
-                    HitObject.StartTime = time;
+                    placementStartTime = placementEndTime = time;
                     break;
 
                 case PlacementState.Active:
-                    HitObject.EndTime = time;
+                    placementEndTime = time;
                     break;
             }
+
+            HitObject.StartTime = Math.Min(placementStartTime, placementEndTime);
+            HitObject.EndTime = Math.Max(placementStartTime, placementEndTime);
         }
     }
 }

From 172d14bcc6675e042b7852845c6122222530c4c5 Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Sun, 8 May 2022 11:40:14 -0700
Subject: [PATCH 4675/5547] Improve code quality of mod column flow container

---
 osu.Game/Overlays/Mods/ModSelectScreen.cs | 29 ++++-------------------
 1 file changed, 4 insertions(+), 25 deletions(-)

diff --git a/osu.Game/Overlays/Mods/ModSelectScreen.cs b/osu.Game/Overlays/Mods/ModSelectScreen.cs
index fc06af3f9d..b232acf11b 100644
--- a/osu.Game/Overlays/Mods/ModSelectScreen.cs
+++ b/osu.Game/Overlays/Mods/ModSelectScreen.cs
@@ -12,7 +12,6 @@ using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Input.Events;
-using osu.Framework.Layout;
 using osu.Framework.Lists;
 using osu.Framework.Utils;
 using osu.Game.Audio;
@@ -125,12 +124,15 @@ namespace osu.Game.Overlays.Mods
                             ScrollbarOverlapsContent = false,
                             Child = columnFlow = new ColumnFlowContainer
                             {
+                                Anchor = Anchor.BottomLeft,
+                                Origin = Anchor.BottomLeft,
                                 Direction = FillDirection.Horizontal,
                                 Shear = new Vector2(SHEAR, 0),
                                 RelativeSizeAxes = Axes.Y,
                                 AutoSizeAxes = Axes.X,
                                 Spacing = new Vector2(10, 0),
                                 Margin = new MarginPadding { Horizontal = 70 },
+                                Padding = new MarginPadding { Bottom = 10 },
                                 Children = new[]
                                 {
                                     createModColumnContent(ModType.DifficultyReduction, new[] { Key.Q, Key.W, Key.E, Key.R, Key.T, Key.Y, Key.U, Key.I, Key.O, Key.P }),
@@ -490,19 +492,12 @@ namespace osu.Game.Overlays.Mods
         }
 
         /// <summary>
-        /// Manages padding and layout of mod columns.
+        /// Manages layout of mod columns.
         /// </summary>
         internal class ColumnFlowContainer : FillFlowContainer<ColumnDimContainer>
         {
             public IEnumerable<ModColumn> Columns => Children.Select(dimWrapper => dimWrapper.Column);
 
-            private readonly LayoutValue drawSizeLayout = new LayoutValue(Invalidation.DrawSize);
-
-            public ColumnFlowContainer()
-            {
-                AddLayout(drawSizeLayout);
-            }
-
             public override void Add(ColumnDimContainer dimContainer)
             {
                 base.Add(dimContainer);
@@ -510,22 +505,6 @@ namespace osu.Game.Overlays.Mods
                 Debug.Assert(dimContainer != null);
                 dimContainer.Column.Shear = Vector2.Zero;
             }
-
-            protected override void Update()
-            {
-                base.Update();
-
-                if (!drawSizeLayout.IsValid)
-                {
-                    Padding = new MarginPadding
-                    {
-                        Left = DrawHeight * SHEAR,
-                        Bottom = 10
-                    };
-
-                    drawSizeLayout.Validate();
-                }
-            }
         }
 
         /// <summary>

From bc839be4d85653fc0872c7e9d923129072eeedff Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Wed, 4 May 2022 09:26:58 -0700
Subject: [PATCH 4676/5547] Add failing rapid back button exit test

---
 .../Navigation/TestSceneScreenNavigation.cs     | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs b/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
index f8eee7be56..9674ef7ae1 100644
--- a/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
@@ -11,6 +11,7 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Screens;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
+using osu.Game.Configuration;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Online.Leaderboards;
 using osu.Game.Overlays;
@@ -503,6 +504,22 @@ namespace osu.Game.Tests.Visual.Navigation
             AddStep("test dispose doesn't crash", () => Game.Dispose());
         }
 
+        [Test]
+        public void TestRapidBackButtonExit()
+        {
+            AddStep("set hold delay to 0", () => Game.LocalConfig.SetValue(OsuSetting.UIHoldActivationDelay, 0.0));
+
+            AddStep("press escape twice rapidly", () =>
+            {
+                InputManager.Key(Key.Escape);
+                InputManager.Key(Key.Escape);
+            });
+
+            pushEscape();
+
+            AddAssert("exit dialog is shown", () => Game.Dependencies.Get<IDialogOverlay>().CurrentDialog != null);
+        }
+
         private Func<Player> playToResults()
         {
             Player player = null;

From 21e1f4546a7dc35eb056748899dd423c6273cf0e Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Wed, 4 May 2022 09:27:53 -0700
Subject: [PATCH 4677/5547] Fix popup dialog potentially not clicking last
 button when dismissed

---
 osu.Game/Overlays/Dialog/PopupDialog.cs | 6 +-----
 1 file changed, 1 insertion(+), 5 deletions(-)

diff --git a/osu.Game/Overlays/Dialog/PopupDialog.cs b/osu.Game/Overlays/Dialog/PopupDialog.cs
index d08b6b7beb..5959fe656c 100644
--- a/osu.Game/Overlays/Dialog/PopupDialog.cs
+++ b/osu.Game/Overlays/Dialog/PopupDialog.cs
@@ -100,10 +100,6 @@ namespace osu.Game.Overlays.Dialog
             }
         }
 
-        // We always want dialogs to show their appear animation, so we request they start hidden.
-        // Normally this would not be required, but is here due to the manual Show() call that occurs before LoadComplete().
-        protected override bool StartHidden => true;
-
         protected PopupDialog()
         {
             RelativeSizeAxes = Axes.Both;
@@ -272,7 +268,7 @@ namespace osu.Game.Overlays.Dialog
 
         protected override void PopOut()
         {
-            if (!actionInvoked && content.IsPresent)
+            if (!actionInvoked)
                 // In the case a user did not choose an action before a hide was triggered, press the last button.
                 // This is presumed to always be a sane default "cancel" action.
                 buttonsContainer.Last().TriggerClick();

From 5f80e344c3f1bcf4953dedd6092d18c1d7d366eb Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Mon, 9 May 2022 00:15:08 +0100
Subject: [PATCH 4678/5547] Update day separator date text to right align
 against username

---
 osu.Game/Overlays/ChatOverlayV2.cs | 45 +++++++++++++++++++++++-------
 1 file changed, 35 insertions(+), 10 deletions(-)

diff --git a/osu.Game/Overlays/ChatOverlayV2.cs b/osu.Game/Overlays/ChatOverlayV2.cs
index 0702b3ad97..8c832baa38 100644
--- a/osu.Game/Overlays/ChatOverlayV2.cs
+++ b/osu.Game/Overlays/ChatOverlayV2.cs
@@ -349,26 +349,51 @@ namespace osu.Game.Overlays
                 {
                     RelativeSizeAxes = Axes.X,
                     AutoSizeAxes = Axes.Y,
-                    RowDimensions = new[] { new Dimension(GridSizeMode.AutoSize) },
                     ColumnDimensions = new[]
                     {
-                        new Dimension(GridSizeMode.Absolute, 215),
-                        new Dimension(GridSizeMode.AutoSize),
+                        new Dimension(GridSizeMode.Absolute, 200),
+                        new Dimension(GridSizeMode.Absolute, 15),
                         new Dimension(),
                     },
                     Content = new[]
                     {
                         new[]
                         {
-                            Drawable.Empty(),
-                            new OsuSpriteText
+                            new GridContainer
                             {
-                                Text = time.ToLocalTime().ToString("dd MMMM yyyy").ToUpper(),
-                                Font = OsuFont.Torus.With(size: 15, weight: FontWeight.SemiBold),
-                                Colour = colourProvider.Content1,
-                                Margin = new MarginPadding { Right = 10 },
+                                RelativeSizeAxes = Axes.Both,
+                                ColumnDimensions = new[]
+                                {
+                                    new Dimension(),
+                                    new Dimension(GridSizeMode.Absolute, 15),
+                                    new Dimension(GridSizeMode.AutoSize),
+                                },
+                                Content = new[]
+                                {
+                                    new[]
+                                    {
+                                        new Circle
+                                        {
+                                            Anchor = Anchor.CentreRight,
+                                            Origin = Anchor.CentreRight,
+                                            Colour = colourProvider.Background5,
+                                            RelativeSizeAxes = Axes.X,
+                                            Height = 2,
+                                        },
+                                        Drawable.Empty(),
+                                        new OsuSpriteText
+                                        {
+                                            Anchor = Anchor.CentreRight,
+                                            Origin = Anchor.CentreRight,
+                                            Text = time.ToLocalTime().ToString("dd MMMM yyyy").ToUpper(),
+                                            Font = OsuFont.Torus.With(size: 15, weight: FontWeight.SemiBold),
+                                            Colour = colourProvider.Content1,
+                                        },
+                                    },
+                                },
                             },
-                            new Box
+                            Drawable.Empty(),
+                            new Circle
                             {
                                 Anchor = Anchor.CentreLeft,
                                 Origin = Anchor.CentreLeft,

From c221058f0f6cb269ed1a9746a6f999a1027c6740 Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Mon, 9 May 2022 00:26:00 +0100
Subject: [PATCH 4679/5547] Simplify fetching `DrawableChannel` in
 `ChatOverlayV2` test

---
 osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs b/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs
index 9d894314f8..259f5540b7 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs
@@ -365,7 +365,7 @@ namespace osu.Game.Tests.Visual.Online
             AddAssert("TextBox is focused", () => InputManager.FocusedDrawable == chatOverlayTextBox);
             AddStep("Click listing", () => clickDrawable(chatOverlay.ChildrenOfType<ChannelListing>().Single()));
             AddAssert("TextBox is focused", () => InputManager.FocusedDrawable == chatOverlayTextBox);
-            AddStep("Click drawable channel", () => clickDrawable(chatOverlay.ChildrenOfType<ChatOverlayDrawableChannel>().Single()));
+            AddStep("Click drawable channel", () => clickDrawable(currentDrawableChannel));
             AddAssert("TextBox is focused", () => InputManager.FocusedDrawable == chatOverlayTextBox);
             AddStep("Click channel list", () => clickDrawable(chatOverlay.ChildrenOfType<ChannelList>().Single()));
             AddAssert("TextBox is focused", () => InputManager.FocusedDrawable == chatOverlayTextBox);
@@ -381,8 +381,8 @@ namespace osu.Game.Tests.Visual.Online
         private Visibility loadingVisibility =>
             chatOverlay.ChildrenOfType<LoadingLayer>().Single().State.Value;
 
-        private ChatOverlayDrawableChannel currentDrawableChannel =>
-            chatOverlay.ChildrenOfType<Container<ChatOverlayDrawableChannel>>().Single().Child;
+        private DrawableChannel currentDrawableChannel =>
+            chatOverlay.ChildrenOfType<DrawableChannel>().Single();
 
         private ChannelListItem getChannelListItem(Channel channel) =>
             chatOverlay.ChildrenOfType<ChannelListItem>().Single(item => item.Channel == channel);

From aeb29849897521108bfc8d94a416272ec2bd69fa Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Mon, 9 May 2022 00:29:40 +0100
Subject: [PATCH 4680/5547] Move `ChatOverlayDrawableChannel` to it's own file

---
 .../Chat/ChatOverlayDrawableChannel.cs        | 109 ++++++++++++++++++
 osu.Game/Overlays/ChatOverlayV2.cs            |  96 ---------------
 2 files changed, 109 insertions(+), 96 deletions(-)
 create mode 100644 osu.Game/Overlays/Chat/ChatOverlayDrawableChannel.cs

diff --git a/osu.Game/Overlays/Chat/ChatOverlayDrawableChannel.cs b/osu.Game/Overlays/Chat/ChatOverlayDrawableChannel.cs
new file mode 100644
index 0000000000..793d81fe26
--- /dev/null
+++ b/osu.Game/Overlays/Chat/ChatOverlayDrawableChannel.cs
@@ -0,0 +1,109 @@
+// 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 enable
+
+using System;
+using osu.Framework.Allocation;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.Shapes;
+using osu.Game.Graphics;
+using osu.Game.Graphics.Sprites;
+using osu.Game.Online.Chat;
+
+namespace osu.Game.Overlays.Chat
+{
+    public class ChatOverlayDrawableChannel : DrawableChannel
+    {
+        public ChatOverlayDrawableChannel(Channel channel)
+            : base(channel)
+        {
+        }
+
+        [BackgroundDependencyLoader]
+        private void load()
+        {
+            ChatLineFlow.Padding = new MarginPadding(0);
+        }
+
+        protected override Drawable CreateDaySeparator(DateTimeOffset time) => new ChatOverlayDaySeparator(time);
+
+        private class ChatOverlayDaySeparator : Container
+        {
+            private readonly DateTimeOffset time;
+
+            public ChatOverlayDaySeparator(DateTimeOffset time)
+            {
+                this.time = time;
+            }
+
+            [BackgroundDependencyLoader]
+            private void load(OverlayColourProvider colourProvider)
+            {
+                RelativeSizeAxes = Axes.X;
+                AutoSizeAxes = Axes.Y;
+                Padding = new MarginPadding(15);
+                Child = new GridContainer
+                {
+                    RelativeSizeAxes = Axes.X,
+                    AutoSizeAxes = Axes.Y,
+                    ColumnDimensions = new[]
+                    {
+                        new Dimension(GridSizeMode.Absolute, 200),
+                        new Dimension(GridSizeMode.Absolute, 15),
+                        new Dimension(),
+                    },
+                    Content = new[]
+                    {
+                        new[]
+                        {
+                            new GridContainer
+                            {
+                                RelativeSizeAxes = Axes.Both,
+                                ColumnDimensions = new[]
+                                {
+                                    new Dimension(),
+                                    new Dimension(GridSizeMode.Absolute, 15),
+                                    new Dimension(GridSizeMode.AutoSize),
+                                },
+                                Content = new[]
+                                {
+                                    new[]
+                                    {
+                                        new Circle
+                                        {
+                                            Anchor = Anchor.CentreRight,
+                                            Origin = Anchor.CentreRight,
+                                            Colour = colourProvider.Background5,
+                                            RelativeSizeAxes = Axes.X,
+                                            Height = 2,
+                                        },
+                                        Drawable.Empty(),
+                                        new OsuSpriteText
+                                        {
+                                            Anchor = Anchor.CentreRight,
+                                            Origin = Anchor.CentreRight,
+                                            Text = time.ToLocalTime().ToString("dd MMMM yyyy").ToUpper(),
+                                            Font = OsuFont.Torus.With(size: 15, weight: FontWeight.SemiBold),
+                                            Colour = colourProvider.Content1,
+                                        },
+                                    },
+                                },
+                            },
+                            Drawable.Empty(),
+                            new Circle
+                            {
+                                Anchor = Anchor.CentreLeft,
+                                Origin = Anchor.CentreLeft,
+                                Colour = colourProvider.Background5,
+                                RelativeSizeAxes = Axes.X,
+                                Height = 2,
+                            },
+                        },
+                    },
+                };
+            }
+        }
+    }
+}
diff --git a/osu.Game/Overlays/ChatOverlayV2.cs b/osu.Game/Overlays/ChatOverlayV2.cs
index 8c832baa38..071f64ce29 100644
--- a/osu.Game/Overlays/ChatOverlayV2.cs
+++ b/osu.Game/Overlays/ChatOverlayV2.cs
@@ -3,7 +3,6 @@
 
 #nullable enable
 
-using System;
 using System.Collections;
 using System.Collections.Generic;
 using System.Collections.Specialized;
@@ -17,9 +16,7 @@ using osu.Framework.Graphics.Shapes;
 using osu.Framework.Input.Events;
 using osu.Framework.Localisation;
 using osu.Game.Configuration;
-using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
-using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Localisation;
 using osu.Game.Online.Chat;
@@ -314,97 +311,4 @@ namespace osu.Game.Overlays
                 channelManager.PostMessage(message);
         }
     }
-
-    public class ChatOverlayDrawableChannel : DrawableChannel
-    {
-        public ChatOverlayDrawableChannel(Channel channel)
-            : base(channel)
-        {
-        }
-
-        [BackgroundDependencyLoader]
-        private void load()
-        {
-            ChatLineFlow.Padding = new MarginPadding(0);
-        }
-
-        protected override Drawable CreateDaySeparator(DateTimeOffset time) => new ChatOverlayDaySeparator(time);
-
-        private class ChatOverlayDaySeparator : Container
-        {
-            private readonly DateTimeOffset time;
-
-            public ChatOverlayDaySeparator(DateTimeOffset time)
-            {
-                this.time = time;
-            }
-
-            [BackgroundDependencyLoader]
-            private void load(OverlayColourProvider colourProvider)
-            {
-                RelativeSizeAxes = Axes.X;
-                AutoSizeAxes = Axes.Y;
-                Padding = new MarginPadding(15);
-                Child = new GridContainer
-                {
-                    RelativeSizeAxes = Axes.X,
-                    AutoSizeAxes = Axes.Y,
-                    ColumnDimensions = new[]
-                    {
-                        new Dimension(GridSizeMode.Absolute, 200),
-                        new Dimension(GridSizeMode.Absolute, 15),
-                        new Dimension(),
-                    },
-                    Content = new[]
-                    {
-                        new[]
-                        {
-                            new GridContainer
-                            {
-                                RelativeSizeAxes = Axes.Both,
-                                ColumnDimensions = new[]
-                                {
-                                    new Dimension(),
-                                    new Dimension(GridSizeMode.Absolute, 15),
-                                    new Dimension(GridSizeMode.AutoSize),
-                                },
-                                Content = new[]
-                                {
-                                    new[]
-                                    {
-                                        new Circle
-                                        {
-                                            Anchor = Anchor.CentreRight,
-                                            Origin = Anchor.CentreRight,
-                                            Colour = colourProvider.Background5,
-                                            RelativeSizeAxes = Axes.X,
-                                            Height = 2,
-                                        },
-                                        Drawable.Empty(),
-                                        new OsuSpriteText
-                                        {
-                                            Anchor = Anchor.CentreRight,
-                                            Origin = Anchor.CentreRight,
-                                            Text = time.ToLocalTime().ToString("dd MMMM yyyy").ToUpper(),
-                                            Font = OsuFont.Torus.With(size: 15, weight: FontWeight.SemiBold),
-                                            Colour = colourProvider.Content1,
-                                        },
-                                    },
-                                },
-                            },
-                            Drawable.Empty(),
-                            new Circle
-                            {
-                                Anchor = Anchor.CentreLeft,
-                                Origin = Anchor.CentreLeft,
-                                Colour = colourProvider.Background5,
-                                RelativeSizeAxes = Axes.X,
-                                Height = 2,
-                            },
-                        },
-                    },
-                };
-            }
-        }
-    }
 }

From 623e2c94ae69cf5049c1c6001863319ca6029ef2 Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Mon, 9 May 2022 00:32:22 +0100
Subject: [PATCH 4681/5547] Adjust padding

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

diff --git a/osu.Game/Overlays/Chat/ChatOverlayDrawableChannel.cs b/osu.Game/Overlays/Chat/ChatOverlayDrawableChannel.cs
index 793d81fe26..3b47adc4b7 100644
--- a/osu.Game/Overlays/Chat/ChatOverlayDrawableChannel.cs
+++ b/osu.Game/Overlays/Chat/ChatOverlayDrawableChannel.cs
@@ -43,7 +43,7 @@ namespace osu.Game.Overlays.Chat
             {
                 RelativeSizeAxes = Axes.X;
                 AutoSizeAxes = Axes.Y;
-                Padding = new MarginPadding(15);
+                Padding = new MarginPadding { Horizontal = 15, Vertical = 20 };
                 Child = new GridContainer
                 {
                     RelativeSizeAxes = Axes.X,

From 3b4fdf20f9c5bb510ab660373c2a8ec498e18321 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Mon, 9 May 2022 12:15:54 +0900
Subject: [PATCH 4682/5547] Prevent throwing exceptions on first run without
 internet

---
 osu.Game/Beatmaps/BeatmapOnlineLookupQueue.cs | 12 +++++++++++-
 1 file changed, 11 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Beatmaps/BeatmapOnlineLookupQueue.cs b/osu.Game/Beatmaps/BeatmapOnlineLookupQueue.cs
index 46f5b418bd..fc39887e79 100644
--- a/osu.Game/Beatmaps/BeatmapOnlineLookupQueue.cs
+++ b/osu.Game/Beatmaps/BeatmapOnlineLookupQueue.cs
@@ -153,7 +153,17 @@ namespace osu.Game.Beatmaps
                 }
             };
 
-            Task.Run(() => cacheDownloadRequest.PerformAsync());
+            Task.Run(async () =>
+            {
+                try
+                {
+                    await cacheDownloadRequest.PerformAsync();
+                }
+                catch
+                {
+                    // Prevent throwing unobserved exceptions, as they will be logged from the network request to the log file anyway.
+                }
+            });
         }
 
         private bool checkLocalCache(BeatmapSetInfo set, BeatmapInfo beatmapInfo)

From e4521b1fff489cc92164d8d5de8c16cb628bd675 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Mon, 9 May 2022 10:16:57 +0300
Subject: [PATCH 4683/5547] Revert scale locking changes for now

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

diff --git a/osu.Game/Screens/Ranking/ResultsScreen.cs b/osu.Game/Screens/Ranking/ResultsScreen.cs
index 87e49fcc5e..70a1b69bcf 100644
--- a/osu.Game/Screens/Ranking/ResultsScreen.cs
+++ b/osu.Game/Screens/Ranking/ResultsScreen.cs
@@ -77,7 +77,7 @@ namespace osu.Game.Screens.Ranking
                 {
                     new Drawable[]
                     {
-                        Content = new DrawSizePreservingFillContainer
+                        Content = new Container
                         {
                             RelativeSizeAxes = Axes.Both,
                             Child = new Container

From 3407a299ef30657d040736d71c7e84687adf927f Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Mon, 9 May 2022 10:35:12 +0300
Subject: [PATCH 4684/5547] Revert "Revert scale locking changes for now"

This reverts commit e4521b1fff489cc92164d8d5de8c16cb628bd675.
---
 osu.Game/Screens/Ranking/ResultsScreen.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Ranking/ResultsScreen.cs b/osu.Game/Screens/Ranking/ResultsScreen.cs
index 70a1b69bcf..87e49fcc5e 100644
--- a/osu.Game/Screens/Ranking/ResultsScreen.cs
+++ b/osu.Game/Screens/Ranking/ResultsScreen.cs
@@ -77,7 +77,7 @@ namespace osu.Game.Screens.Ranking
                 {
                     new Drawable[]
                     {
-                        Content = new Container
+                        Content = new DrawSizePreservingFillContainer
                         {
                             RelativeSizeAxes = Axes.Both,
                             Child = new Container

From 422531d8ec5cb7240b4948c9e426663982e2a973 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Mon, 9 May 2022 10:35:13 +0300
Subject: [PATCH 4685/5547] Revert "Remove no longer required constant"

This reverts commit 6f4cdccf6c5430991c8e4c87a6ad60698faff4ce.
---
 osu.Game/Screens/Ranking/ResultsScreen.cs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Game/Screens/Ranking/ResultsScreen.cs b/osu.Game/Screens/Ranking/ResultsScreen.cs
index 87e49fcc5e..2c91b17917 100644
--- a/osu.Game/Screens/Ranking/ResultsScreen.cs
+++ b/osu.Game/Screens/Ranking/ResultsScreen.cs
@@ -27,6 +27,7 @@ namespace osu.Game.Screens.Ranking
     public abstract class ResultsScreen : ScreenWithBeatmapBackground, IKeyBindingHandler<GlobalAction>
     {
         protected const float BACKGROUND_BLUR = 20;
+        private static readonly float screen_height = 768 - TwoLayerButton.SIZE_EXTENDED.Y;
 
         public override bool DisallowExternalBeatmapRulesetChanges => true;
 

From 2f3ac61b479bae1e4ecef58ffef024809ac1f5b4 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Mon, 9 May 2022 10:35:14 +0300
Subject: [PATCH 4686/5547] Revert "Replace vertical scrolling in results
 screen with size-preserving container"

This reverts commit 298c2a1828bf628d59a5bd7ec1b671e925732ec9.
---
 .../MultiplayerTeamResultsScreen.cs           |  6 ++---
 osu.Game/Screens/Ranking/ResultsScreen.cs     | 26 +++++++++++++++++--
 2 files changed, 27 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerTeamResultsScreen.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerTeamResultsScreen.cs
index 117415ac8f..3f0f3e043c 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerTeamResultsScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerTeamResultsScreen.cs
@@ -46,9 +46,9 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
         {
             const float winner_background_half_height = 250;
 
-            Content.Anchor = Content.Origin = Anchor.TopCentre;
-            Content.Scale = new Vector2(0.9f);
-            Content.Y = 75;
+            VerticalScrollContent.Anchor = VerticalScrollContent.Origin = Anchor.TopCentre;
+            VerticalScrollContent.Scale = new Vector2(0.9f);
+            VerticalScrollContent.Y = 75;
 
             var redScore = teamScores.First().Value;
             var blueScore = teamScores.Last().Value;
diff --git a/osu.Game/Screens/Ranking/ResultsScreen.cs b/osu.Game/Screens/Ranking/ResultsScreen.cs
index 2c91b17917..98514cd846 100644
--- a/osu.Game/Screens/Ranking/ResultsScreen.cs
+++ b/osu.Game/Screens/Ranking/ResultsScreen.cs
@@ -14,6 +14,7 @@ using osu.Framework.Input.Bindings;
 using osu.Framework.Input.Events;
 using osu.Framework.Screens;
 using osu.Game.Graphics;
+using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Input.Bindings;
 using osu.Game.Online.API;
@@ -40,7 +41,7 @@ namespace osu.Game.Screens.Ranking
 
         protected ScorePanelList ScorePanelList { get; private set; }
 
-        protected Container Content { get; private set; }
+        protected VerticalScrollContainer VerticalScrollContent { get; private set; }
 
         [Resolved(CanBeNull = true)]
         private Player player { get; set; }
@@ -78,9 +79,10 @@ namespace osu.Game.Screens.Ranking
                 {
                     new Drawable[]
                     {
-                        Content = new DrawSizePreservingFillContainer
+                        VerticalScrollContent = new VerticalScrollContainer
                         {
                             RelativeSizeAxes = Axes.Both,
+                            ScrollbarVisible = false,
                             Child = new Container
                             {
                                 RelativeSizeAxes = Axes.Both,
@@ -344,5 +346,25 @@ namespace osu.Game.Screens.Ranking
         public void OnReleased(KeyBindingReleaseEvent<GlobalAction> e)
         {
         }
+
+        protected class VerticalScrollContainer : OsuScrollContainer
+        {
+            protected override Container<Drawable> Content => content;
+
+            private readonly Container content;
+
+            public VerticalScrollContainer()
+            {
+                Masking = false;
+
+                base.Content.Add(content = new Container { RelativeSizeAxes = Axes.X });
+            }
+
+            protected override void Update()
+            {
+                base.Update();
+                content.Height = Math.Max(screen_height, DrawHeight);
+            }
+        }
     }
 }

From 72552ecc855a1a30483dd80d4b9c9c41726ac7c0 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 9 May 2022 16:49:20 +0900
Subject: [PATCH 4687/5547] Update framework

---
 osu.Android.props        | 2 +-
 osu.Game/osu.Game.csproj | 2 +-
 osu.iOS.props            | 4 ++--
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Android.props b/osu.Android.props
index 2866ec24a6..97d9dbc380 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -52,7 +52,7 @@
   </ItemGroup>
   <ItemGroup>
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.422.0" />
-    <PackageReference Include="ppy.osu.Framework.Android" Version="2022.430.0" />
+    <PackageReference Include="ppy.osu.Framework.Android" Version="2022.509.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
     <!-- Realm needs to be directly referenced in all Xamarin projects, as it will not pull in its transitive dependencies otherwise. -->
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index fa7563da55..2f32c843c0 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="10.10.0" />
-    <PackageReference Include="ppy.osu.Framework" Version="2022.430.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2022.509.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.422.0" />
     <PackageReference Include="Sentry" Version="3.14.1" />
     <PackageReference Include="SharpCompress" Version="0.30.1" />
diff --git a/osu.iOS.props b/osu.iOS.props
index f987ae9bf8..b483267696 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -61,7 +61,7 @@
     <Reference Include="System.Net.Http" />
   </ItemGroup>
   <ItemGroup Label="Package References">
-    <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.430.0" />
+    <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.509.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.422.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net6.0) -->
@@ -84,7 +84,7 @@
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="5.0.14" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.Core" Version="5.0.14" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
-    <PackageReference Include="ppy.osu.Framework" Version="2022.430.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2022.509.0" />
     <PackageReference Include="SharpCompress" Version="0.30.1" />
     <PackageReference Include="NUnit" Version="3.13.2" />
     <PackageReference Include="System.ComponentModel.Annotations" Version="5.0.0" />

From a16f2349aa6c9b2bf4246e1fc970dcebf5ada2e4 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Mon, 9 May 2022 17:55:40 +0900
Subject: [PATCH 4688/5547] Fix next queued item not selecting after gameplay

---
 .../TestSceneMultiplayerMatchSubScreen.cs     | 37 +++++++++++++++++++
 .../OnlinePlay/DrawableRoomPlaylistItem.cs    |  8 ++--
 2 files changed, 41 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs
index 2abde82e92..6173580f0b 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs
@@ -21,6 +21,7 @@ using osu.Game.Rulesets.Osu.Mods;
 using osu.Game.Rulesets.Taiko;
 using osu.Game.Rulesets.Taiko.Mods;
 using osu.Game.Rulesets.UI;
+using osu.Game.Screens.OnlinePlay;
 using osu.Game.Screens.OnlinePlay.Match;
 using osu.Game.Screens.OnlinePlay.Multiplayer;
 using osu.Game.Screens.OnlinePlay.Multiplayer.Match;
@@ -176,5 +177,41 @@ namespace osu.Game.Tests.Visual.Multiplayer
                           .ChildrenOfType<ModPanel>()
                           .SingleOrDefault(panel => !panel.Filtered.Value)?.Mod is OsuModDoubleTime);
         }
+
+        [Test]
+        public void TestNextPlaylistItemSelectedAfterCompletion()
+        {
+            AddStep("add two playlist items", () =>
+            {
+                SelectedRoom.Value.Playlist.AddRange(new[]
+                {
+                    new PlaylistItem(beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First()).BeatmapInfo)
+                    {
+                        RulesetID = new OsuRuleset().RulesetInfo.OnlineID
+                    },
+                    new PlaylistItem(beatmaps.GetWorkingBeatmap(importedSet.Beatmaps.First()).BeatmapInfo)
+                    {
+                        RulesetID = new OsuRuleset().RulesetInfo.OnlineID
+                    }
+                });
+            });
+
+            ClickButtonWhenEnabled<MultiplayerMatchSettingsOverlay.CreateOrUpdateButton>();
+
+            AddUntilStep("wait for join", () => RoomJoined);
+
+            ClickButtonWhenEnabled<MultiplayerReadyButton>();
+            ClickButtonWhenEnabled<MultiplayerReadyButton>();
+
+            AddStep("change user to loaded", () => MultiplayerClient.ChangeState(MultiplayerUserState.Loaded));
+            AddUntilStep("user playing", () => MultiplayerClient.LocalUser?.State == MultiplayerUserState.Playing);
+            AddStep("abort gameplay", () => MultiplayerClient.AbortGameplay());
+
+            AddUntilStep("last playlist item selected", () =>
+            {
+                var lastItem = this.ChildrenOfType<DrawableRoomPlaylistItem>().Single(p => p.Item.ID == MultiplayerClient.APIRoom?.Playlist.Last().ID);
+                return lastItem.IsSelectedItem;
+            });
+        }
     }
 }
diff --git a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
index 459b861d96..2618e15d31 100644
--- a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
+++ b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
@@ -65,6 +65,8 @@ namespace osu.Game.Screens.OnlinePlay
 
         public readonly PlaylistItem Item;
 
+        public bool IsSelectedItem => SelectedItem.Value?.ID == Item.ID;
+
         private readonly DelayedLoadWrapper onScreenLoader = new DelayedLoadWrapper(Empty) { RelativeSizeAxes = Axes.Both };
         private readonly IBindable<bool> valid = new Bindable<bool>();
 
@@ -128,12 +130,10 @@ namespace osu.Game.Screens.OnlinePlay
 
             SelectedItem.BindValueChanged(selected =>
             {
-                bool isCurrent = selected.NewValue == Model;
-
                 if (!valid.Value)
                 {
                     // Don't allow selection when not valid.
-                    if (isCurrent)
+                    if (IsSelectedItem)
                     {
                         SelectedItem.Value = selected.OldValue;
                     }
@@ -142,7 +142,7 @@ namespace osu.Game.Screens.OnlinePlay
                     return;
                 }
 
-                maskingContainer.BorderThickness = isCurrent ? 5 : 0;
+                maskingContainer.BorderThickness = IsSelectedItem ? 5 : 0;
             }, true);
 
             valid.BindValueChanged(_ => Scheduler.AddOnce(refresh));

From 0fe121f48a8954d25fef2b8059fea1f60d967549 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Mon, 9 May 2022 13:25:22 +0300
Subject: [PATCH 4689/5547] Move and rename settings toolbox group test scene

---
 .../TestSceneSettingsToolboxGroup.cs}                     | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)
 rename osu.Game.Tests/Visual/{Gameplay/TestSceneReplaySettingsOverlay.cs => UserInterface/TestSceneSettingsToolboxGroup.cs} (85%)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneReplaySettingsOverlay.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneSettingsToolboxGroup.cs
similarity index 85%
rename from osu.Game.Tests/Visual/Gameplay/TestSceneReplaySettingsOverlay.cs
rename to osu.Game.Tests/Visual/UserInterface/TestSceneSettingsToolboxGroup.cs
index f8fab784cc..5ca30d07b0 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneReplaySettingsOverlay.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneSettingsToolboxGroup.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 NUnit.Framework;
@@ -8,12 +8,12 @@ using osu.Game.Graphics.UserInterface;
 using osu.Game.Screens.Play.HUD;
 using osu.Game.Screens.Play.PlayerSettings;
 
-namespace osu.Game.Tests.Visual.Gameplay
+namespace osu.Game.Tests.Visual.UserInterface
 {
     [TestFixture]
-    public class TestSceneReplaySettingsOverlay : OsuTestScene
+    public class TestSceneSettingsToolboxGroup : OsuTestScene
     {
-        public TestSceneReplaySettingsOverlay()
+        public TestSceneSettingsToolboxGroup()
         {
             ExampleContainer container;
 

From deda1c83e67779a748d82138215846519dbcfea7 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Mon, 9 May 2022 13:44:18 +0300
Subject: [PATCH 4690/5547] Add failing test case

---
 .../TestSceneSettingsToolboxGroup.cs          | 22 ++++++++++++++++++-
 1 file changed, 21 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneSettingsToolboxGroup.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneSettingsToolboxGroup.cs
index 5ca30d07b0..76657afbcd 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneSettingsToolboxGroup.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneSettingsToolboxGroup.cs
@@ -1,17 +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.Linq;
 using NUnit.Framework;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
+using osu.Framework.Testing;
 using osu.Game.Graphics.UserInterface;
+using osu.Game.Overlays;
 using osu.Game.Screens.Play.HUD;
 using osu.Game.Screens.Play.PlayerSettings;
+using osuTK.Input;
 
 namespace osu.Game.Tests.Visual.UserInterface
 {
     [TestFixture]
-    public class TestSceneSettingsToolboxGroup : OsuTestScene
+    public class TestSceneSettingsToolboxGroup : OsuManualInputManagerTestScene
     {
         public TestSceneSettingsToolboxGroup()
         {
@@ -46,6 +50,22 @@ namespace osu.Game.Tests.Visual.UserInterface
             }));
         }
 
+        [Test]
+        public void TestClickExpandButtonMultipleTimes()
+        {
+            SettingsToolboxGroup group = null;
+
+            AddAssert("group expanded by default", () => (group = this.ChildrenOfType<SettingsToolboxGroup>().First()).Expanded.Value);
+            AddStep("click expand button multiple times", () =>
+            {
+                InputManager.MoveMouseTo(group.ChildrenOfType<IconButton>().Single());
+                Scheduler.AddDelayed(() => InputManager.Click(MouseButton.Left), 100);
+                Scheduler.AddDelayed(() => InputManager.Click(MouseButton.Left), 200);
+                Scheduler.AddDelayed(() => InputManager.Click(MouseButton.Left), 300);
+            });
+            AddAssert("group contracted", () => !group.Expanded.Value);
+        }
+
         private class ExampleContainer : PlayerSettingsGroup
         {
             public ExampleContainer()

From 702c6ae658d671a21985f28ec199b3bc18d7f5bd Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Mon, 9 May 2022 13:49:31 +0300
Subject: [PATCH 4691/5547] Fix `SettingsToolboxGroup` not clearing transforms
 before updating autosize

---
 osu.Game/Overlays/SettingsToolboxGroup.cs | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/osu.Game/Overlays/SettingsToolboxGroup.cs b/osu.Game/Overlays/SettingsToolboxGroup.cs
index 808d4fc422..36d4f03e02 100644
--- a/osu.Game/Overlays/SettingsToolboxGroup.cs
+++ b/osu.Game/Overlays/SettingsToolboxGroup.cs
@@ -156,6 +156,8 @@ namespace osu.Game.Overlays
 
         private void updateExpandedState(ValueChangedEvent<bool> expanded)
         {
+            content.ClearTransforms();
+
             if (expanded.NewValue)
                 content.AutoSizeAxes = Axes.Y;
             else

From 70a90722e8dac2147feaffb764064a65ae5d031c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 9 May 2022 19:48:53 +0900
Subject: [PATCH 4692/5547] Fix dropdown item hover colour not being set in
 time

Turns out to be an osu!-side issue. The colour transform was being
shortcutted for the non-displayed case, which meant it was not in a good
state in time for the first hover.

Closes https://github.com/ppy/osu/issues/18163#issuecomment-1120747301
---
 osu.Game/Graphics/UserInterface/OsuDropdown.cs | 12 +++++-------
 1 file changed, 5 insertions(+), 7 deletions(-)

diff --git a/osu.Game/Graphics/UserInterface/OsuDropdown.cs b/osu.Game/Graphics/UserInterface/OsuDropdown.cs
index b1d4691938..4e391c8221 100644
--- a/osu.Game/Graphics/UserInterface/OsuDropdown.cs
+++ b/osu.Game/Graphics/UserInterface/OsuDropdown.cs
@@ -184,14 +184,12 @@ namespace osu.Game.Graphics.UserInterface
 
                 protected override void UpdateBackgroundColour()
                 {
-                    if (!IsPreSelected && !IsSelected)
-                    {
-                        Background.FadeOut(600, Easing.OutQuint);
-                        return;
-                    }
-
-                    Background.FadeIn(100, Easing.OutQuint);
                     Background.FadeColour(IsPreSelected ? BackgroundColourHover : BackgroundColourSelected, 100, Easing.OutQuint);
+
+                    if (IsPreSelected || IsSelected)
+                        Background.FadeIn(100, Easing.OutQuint);
+                    else
+                        Background.FadeOut(600, Easing.OutQuint);
                 }
 
                 protected override void UpdateForegroundColour()

From 5f3bea846b0e2fe0c435629c9ee056e6b86d3742 Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Mon, 9 May 2022 11:15:12 +0100
Subject: [PATCH 4693/5547] Simplify fetching of `DrawableChannel`

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

diff --git a/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs b/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs
index 7c77ac925e..259f5540b7 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs
@@ -365,7 +365,7 @@ namespace osu.Game.Tests.Visual.Online
             AddAssert("TextBox is focused", () => InputManager.FocusedDrawable == chatOverlayTextBox);
             AddStep("Click listing", () => clickDrawable(chatOverlay.ChildrenOfType<ChannelListing>().Single()));
             AddAssert("TextBox is focused", () => InputManager.FocusedDrawable == chatOverlayTextBox);
-            AddStep("Click drawable channel", () => clickDrawable(chatOverlay.ChildrenOfType<DrawableChannel>().Single()));
+            AddStep("Click drawable channel", () => clickDrawable(currentDrawableChannel));
             AddAssert("TextBox is focused", () => InputManager.FocusedDrawable == chatOverlayTextBox);
             AddStep("Click channel list", () => clickDrawable(chatOverlay.ChildrenOfType<ChannelList>().Single()));
             AddAssert("TextBox is focused", () => InputManager.FocusedDrawable == chatOverlayTextBox);
@@ -382,7 +382,7 @@ namespace osu.Game.Tests.Visual.Online
             chatOverlay.ChildrenOfType<LoadingLayer>().Single().State.Value;
 
         private DrawableChannel currentDrawableChannel =>
-            chatOverlay.ChildrenOfType<Container<DrawableChannel>>().Single().Child;
+            chatOverlay.ChildrenOfType<DrawableChannel>().Single();
 
         private ChannelListItem getChannelListItem(Channel channel) =>
             chatOverlay.ChildrenOfType<ChannelListItem>().Single(item => item.Channel == channel);

From 9ec8b609a8395e1f814604b2c1f1c097f7a90d5b Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Mon, 9 May 2022 12:00:49 +0100
Subject: [PATCH 4694/5547] Update channel visibility tests to be more correct

---
 .../Visual/Online/TestSceneChatOverlayV2.cs   | 42 ++++++++++++-------
 1 file changed, 28 insertions(+), 14 deletions(-)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs b/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs
index 259f5540b7..9956b8977f 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs
@@ -121,6 +121,19 @@ namespace osu.Game.Tests.Visual.Online
             });
         }
 
+        [Test]
+        public void TestBasic()
+        {
+            AddStep("Show overlay with channel", () =>
+            {
+                chatOverlay.Show();
+                Channel joinedChannel = channelManager.JoinChannel(testChannel1);
+                channelManager.CurrentChannel.Value = joinedChannel;
+            });
+            AddAssert("Overlay is visible", () => chatOverlay.State.Value == Visibility.Visible);
+            AddAssert("Channel is visible", () => channelIsVisible && currentDrawableChannel.Channel == testChannel1);
+        }
+
         [Test]
         public void TestShowHide()
         {
@@ -158,20 +171,17 @@ namespace osu.Game.Tests.Visual.Online
         public void TestChannelSelection()
         {
             AddStep("Show overlay", () => chatOverlay.Show());
-            AddAssert("Listing is visible", () => listingVisibility == Visibility.Visible);
+            AddAssert("Listing is visible", () => listingIsVisible);
             AddStep("Join channel 1", () => channelManager.JoinChannel(testChannel1));
             AddStep("Select channel 1", () => clickDrawable(getChannelListItem(testChannel1)));
-            AddAssert("Listing is hidden", () => listingVisibility == Visibility.Hidden);
-            AddAssert("Loading is hidden", () => loadingVisibility == Visibility.Hidden);
-            AddAssert("Current channel is correct", () => channelManager.CurrentChannel.Value == testChannel1);
-            AddAssert("DrawableChannel is correct", () => currentDrawableChannel.Channel == testChannel1);
+            AddAssert("Channel 1 is visible", () => channelIsVisible && currentDrawableChannel.Channel == testChannel1);
         }
 
         [Test]
         public void TestSearchInListing()
         {
             AddStep("Show overlay", () => chatOverlay.Show());
-            AddAssert("Listing is visible", () => listingVisibility == Visibility.Visible);
+            AddAssert("Listing is visible", () => listingIsVisible);
             AddStep("Search for 'number 2'", () => chatOverlayTextBox.Text = "number 2");
             AddUntilStep("Only channel 2 visibile", () =>
             {
@@ -263,6 +273,7 @@ namespace osu.Game.Tests.Visual.Online
                 });
             });
             AddStep("Highlight message", () => chatOverlay.HighlightMessage(message, testChannel1));
+            AddAssert("Channel 1 is visible", () => channelIsVisible && currentDrawableChannel.Channel == testChannel1);
         }
 
         [Test]
@@ -285,8 +296,7 @@ namespace osu.Game.Tests.Visual.Online
                 });
             });
             AddStep("Highlight message", () => chatOverlay.HighlightMessage(message, testChannel2));
-            AddAssert("Channel 2 is selected", () => channelManager.CurrentChannel.Value == testChannel2);
-            AddAssert("Channel 2 is visible", () => currentDrawableChannel.Channel == testChannel2);
+            AddAssert("Channel 2 is visible", () => channelIsVisible && currentDrawableChannel.Channel == testChannel2);
         }
 
         [Test]
@@ -310,8 +320,7 @@ namespace osu.Game.Tests.Visual.Online
             });
             AddStep("Leave channel 2", () => channelManager.LeaveChannel(testChannel2));
             AddStep("Highlight message", () => chatOverlay.HighlightMessage(message, testChannel2));
-            AddAssert("Channel 2 is selected", () => channelManager.CurrentChannel.Value == testChannel2);
-            AddAssert("Channel 2 is visible", () => currentDrawableChannel.Channel == testChannel2);
+            AddAssert("Channel 2 is visible", () => channelIsVisible && currentDrawableChannel.Channel == testChannel2);
         }
 
         [Test]
@@ -331,6 +340,7 @@ namespace osu.Game.Tests.Visual.Online
                 });
             });
             AddStep("Highlight message", () => chatOverlay.HighlightMessage(message, testChannel1));
+            AddAssert("Channel 1 is visible", () => channelIsVisible && currentDrawableChannel.Channel == testChannel1);
         }
 
         [Test]
@@ -351,6 +361,7 @@ namespace osu.Game.Tests.Visual.Online
             });
             AddStep("Set null channel", () => channelManager.CurrentChannel.Value = null);
             AddStep("Highlight message", () => chatOverlay.HighlightMessage(message, testChannel1));
+            AddAssert("Channel 1 is visible", () => channelIsVisible && currentDrawableChannel.Channel == testChannel1);
         }
 
         [Test]
@@ -375,11 +386,14 @@ namespace osu.Game.Tests.Visual.Online
             AddAssert("TextBox is not focused", () => InputManager.FocusedDrawable == null);
         }
 
-        private Visibility listingVisibility =>
-            chatOverlay.ChildrenOfType<ChannelListing>().Single().State.Value;
+        private bool listingIsVisible =>
+            chatOverlay.ChildrenOfType<ChannelListing>().Single().State.Value == Visibility.Visible;
 
-        private Visibility loadingVisibility =>
-            chatOverlay.ChildrenOfType<LoadingLayer>().Single().State.Value;
+        private bool loadingIsVisible =>
+            chatOverlay.ChildrenOfType<LoadingLayer>().Single().State.Value == Visibility.Visible;
+
+        private bool channelIsVisible =>
+            !listingIsVisible && !loadingIsVisible;
 
         private DrawableChannel currentDrawableChannel =>
             chatOverlay.ChildrenOfType<DrawableChannel>().Single();

From d4cc2bd7dd813733c927b69999ef8bcb801450cc Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Mon, 9 May 2022 12:01:30 +0100
Subject: [PATCH 4695/5547] Ensure channel selector is dismissed when the
 current channel is changed

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

diff --git a/osu.Game/Overlays/ChatOverlayV2.cs b/osu.Game/Overlays/ChatOverlayV2.cs
index 4c7fa0f802..48b34726f8 100644
--- a/osu.Game/Overlays/ChatOverlayV2.cs
+++ b/osu.Game/Overlays/ChatOverlayV2.cs
@@ -191,8 +191,6 @@ namespace osu.Game.Overlays
                 channelManager.CurrentChannel.Value = channel;
             }
 
-            selectorActive.Value = false;
-
             channel.HighlightedMessage.Value = message;
 
             Show();
@@ -268,6 +266,8 @@ namespace osu.Game.Overlays
                 return;
             }
 
+            selectorActive.Value = false;
+
             LoadComponentAsync(new DrawableChannel(newChannel), loaded =>
             {
                 currentChannelContainer.Clear();

From ceb6276d2ffd3e0e9b900225ea28bd12efdca146 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Mon, 9 May 2022 18:19:29 +0300
Subject: [PATCH 4696/5547] Add failing test case

---
 .../UserInterface/TestSceneRoundedButton.cs   | 48 ++++++++++++++++---
 1 file changed, 41 insertions(+), 7 deletions(-)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneRoundedButton.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneRoundedButton.cs
index 9ccfba7c74..ef3c0c7fa4 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneRoundedButton.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneRoundedButton.cs
@@ -2,11 +2,16 @@
 // 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.Extensions.IEnumerableExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
-using osu.Framework.Graphics.Shapes;
+using osu.Framework.Testing;
 using osu.Game.Graphics.UserInterfaceV2;
+using osu.Game.Overlays;
+using osuTK;
 
 namespace osu.Game.Tests.Visual.UserInterface
 {
@@ -22,15 +27,10 @@ namespace osu.Game.Tests.Visual.UserInterface
                 RelativeSizeAxes = Axes.Both,
                 Children = new Drawable[]
                 {
-                    new Box
-                    {
-                        RelativeSizeAxes = Axes.Both,
-                        Colour = Colour4.DarkGray
-                    },
                     button = new RoundedButton
                     {
                         Width = 400,
-                        Text = "Test button",
+                        Text = "Test Button",
                         Anchor = Anchor.Centre,
                         Origin = Anchor.Centre,
                         Action = () => { }
@@ -40,5 +40,39 @@ namespace osu.Game.Tests.Visual.UserInterface
 
             AddToggleStep("toggle disabled", disabled => button.Action = disabled ? (Action)null : () => { });
         }
+
+        [Test]
+        public void TestOverlay()
+        {
+            IEnumerable<OverlayColourScheme> schemes = Enum.GetValues(typeof(OverlayColourScheme)).Cast<OverlayColourScheme>();
+
+            AddStep("create buttons", () =>
+            {
+                Child = new FillFlowContainer
+                {
+                    Anchor = Anchor.Centre,
+                    Origin = Anchor.Centre,
+                    AutoSizeAxes = Axes.Both,
+                    Direction = FillDirection.Vertical,
+                    Spacing = new Vector2(5f),
+                    ChildrenEnumerable = schemes.Select(c => new DependencyProvidingContainer
+                    {
+                        AutoSizeAxes = Axes.Both,
+                        CachedDependencies = new (Type, object)[] { (typeof(OverlayColourProvider), new OverlayColourProvider(c)) },
+                        Child = new RoundedButton
+                        {
+                            Width = 400,
+                            Text = $"Test {c}",
+                            Anchor = Anchor.Centre,
+                            Origin = Anchor.Centre,
+                            Action = () => { },
+                        }
+                    }),
+                };
+            });
+
+            AddAssert("first button has correct colour", () => this.ChildrenOfType<RoundedButton>().First().BackgroundColour == new OverlayColourProvider(schemes.First()).Highlight1);
+            AddToggleStep("toggle disabled", disabled => this.ChildrenOfType<RoundedButton>().ForEach(b => b.Action = disabled ? (Action)null : () => { }));
+        }
     }
 }

From 172524ff8a3812ffce89361c5552a6426529df33 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Mon, 9 May 2022 18:21:00 +0300
Subject: [PATCH 4697/5547] Move default background colour specification to
 `OsuButton`

---
 osu.Game/Graphics/UserInterface/OsuButton.cs       |  8 +++++---
 osu.Game/Graphics/UserInterfaceV2/RoundedButton.cs | 11 -----------
 2 files changed, 5 insertions(+), 14 deletions(-)

diff --git a/osu.Game/Graphics/UserInterface/OsuButton.cs b/osu.Game/Graphics/UserInterface/OsuButton.cs
index 29a797bd78..6fa63e5874 100644
--- a/osu.Game/Graphics/UserInterface/OsuButton.cs
+++ b/osu.Game/Graphics/UserInterface/OsuButton.cs
@@ -2,6 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System.Diagnostics;
+using JetBrains.Annotations;
 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 osu.Game.Overlays;
 using osuTK.Graphics;
 
 namespace osu.Game.Graphics.UserInterface
@@ -86,11 +88,11 @@ namespace osu.Game.Graphics.UserInterface
                 AddInternal(new HoverClickSounds(hoverSounds.Value));
         }
 
-        [BackgroundDependencyLoader]
-        private void load(OsuColour colours)
+        [BackgroundDependencyLoader(permitNulls: true)]
+        private void load([CanBeNull] OverlayColourProvider overlayColourProvider, OsuColour colours)
         {
             if (backgroundColour == null)
-                BackgroundColour = colours.BlueDark;
+                BackgroundColour = overlayColourProvider?.Highlight1 ?? colours.Blue3;
         }
 
         protected override void LoadComplete()
diff --git a/osu.Game/Graphics/UserInterfaceV2/RoundedButton.cs b/osu.Game/Graphics/UserInterfaceV2/RoundedButton.cs
index f535a32b39..b1529774d9 100644
--- a/osu.Game/Graphics/UserInterfaceV2/RoundedButton.cs
+++ b/osu.Game/Graphics/UserInterfaceV2/RoundedButton.cs
@@ -2,13 +2,9 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System.Collections.Generic;
-using JetBrains.Annotations;
-using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Graphics.UserInterface;
-using osu.Game.Overlays;
-using osuTK.Graphics;
 
 namespace osu.Game.Graphics.UserInterfaceV2
 {
@@ -26,13 +22,6 @@ namespace osu.Game.Graphics.UserInterfaceV2
             }
         }
 
-        [BackgroundDependencyLoader(true)]
-        private void load([CanBeNull] OverlayColourProvider overlayColourProvider, OsuColour colours)
-        {
-            if (BackgroundColour == Color4.White)
-                BackgroundColour = overlayColourProvider?.Highlight1 ?? colours.Blue3;
-        }
-
         protected override void LoadComplete()
         {
             base.LoadComplete();

From ace25af949ab39946e4a8b57103b40247c96dbfa Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Mon, 9 May 2022 20:55:26 +0300
Subject: [PATCH 4698/5547] Revert "Move default background colour
 specification to `OsuButton`"

This reverts commit 172524ff8a3812ffce89361c5552a6426529df33.
---
 osu.Game/Graphics/UserInterface/OsuButton.cs       |  8 +++-----
 osu.Game/Graphics/UserInterfaceV2/RoundedButton.cs | 11 +++++++++++
 2 files changed, 14 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Graphics/UserInterface/OsuButton.cs b/osu.Game/Graphics/UserInterface/OsuButton.cs
index 6fa63e5874..29a797bd78 100644
--- a/osu.Game/Graphics/UserInterface/OsuButton.cs
+++ b/osu.Game/Graphics/UserInterface/OsuButton.cs
@@ -2,7 +2,6 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System.Diagnostics;
-using JetBrains.Annotations;
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
@@ -13,7 +12,6 @@ using osu.Framework.Graphics.UserInterface;
 using osu.Framework.Input.Events;
 using osu.Framework.Localisation;
 using osu.Game.Graphics.Sprites;
-using osu.Game.Overlays;
 using osuTK.Graphics;
 
 namespace osu.Game.Graphics.UserInterface
@@ -88,11 +86,11 @@ namespace osu.Game.Graphics.UserInterface
                 AddInternal(new HoverClickSounds(hoverSounds.Value));
         }
 
-        [BackgroundDependencyLoader(permitNulls: true)]
-        private void load([CanBeNull] OverlayColourProvider overlayColourProvider, OsuColour colours)
+        [BackgroundDependencyLoader]
+        private void load(OsuColour colours)
         {
             if (backgroundColour == null)
-                BackgroundColour = overlayColourProvider?.Highlight1 ?? colours.Blue3;
+                BackgroundColour = colours.BlueDark;
         }
 
         protected override void LoadComplete()
diff --git a/osu.Game/Graphics/UserInterfaceV2/RoundedButton.cs b/osu.Game/Graphics/UserInterfaceV2/RoundedButton.cs
index b1529774d9..f535a32b39 100644
--- a/osu.Game/Graphics/UserInterfaceV2/RoundedButton.cs
+++ b/osu.Game/Graphics/UserInterfaceV2/RoundedButton.cs
@@ -2,9 +2,13 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System.Collections.Generic;
+using JetBrains.Annotations;
+using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Graphics.UserInterface;
+using osu.Game.Overlays;
+using osuTK.Graphics;
 
 namespace osu.Game.Graphics.UserInterfaceV2
 {
@@ -22,6 +26,13 @@ namespace osu.Game.Graphics.UserInterfaceV2
             }
         }
 
+        [BackgroundDependencyLoader(true)]
+        private void load([CanBeNull] OverlayColourProvider overlayColourProvider, OsuColour colours)
+        {
+            if (BackgroundColour == Color4.White)
+                BackgroundColour = overlayColourProvider?.Highlight1 ?? colours.Blue3;
+        }
+
         protected override void LoadComplete()
         {
             base.LoadComplete();

From 1fcfeac05f8c499ae86c36d32bcfdaf0bfc736f4 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Mon, 9 May 2022 18:52:09 +0300
Subject: [PATCH 4699/5547] Fix `RoundedButton` not using its default
 background colour

---
 osu.Game/Graphics/UserInterface/OsuButton.cs  | 31 ++++++++++++++-----
 .../Graphics/UserInterfaceV2/RoundedButton.cs |  4 +--
 2 files changed, 24 insertions(+), 11 deletions(-)

diff --git a/osu.Game/Graphics/UserInterface/OsuButton.cs b/osu.Game/Graphics/UserInterface/OsuButton.cs
index 29a797bd78..08514d94c3 100644
--- a/osu.Game/Graphics/UserInterface/OsuButton.cs
+++ b/osu.Game/Graphics/UserInterface/OsuButton.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.Diagnostics;
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
@@ -33,9 +32,12 @@ namespace osu.Game.Graphics.UserInterface
 
         private Color4? backgroundColour;
 
+        /// <summary>
+        /// Sets a custom background colour to this button, replacing the provided default.
+        /// </summary>
         public Color4 BackgroundColour
         {
-            get => backgroundColour ?? Color4.White;
+            get => backgroundColour ?? defaultBackgroundColour;
             set
             {
                 backgroundColour = value;
@@ -43,6 +45,23 @@ namespace osu.Game.Graphics.UserInterface
             }
         }
 
+        private Color4 defaultBackgroundColour;
+
+        /// <summary>
+        /// Sets a default background colour to this button.
+        /// </summary>
+        protected Color4 DefaultBackgroundColour
+        {
+            get => defaultBackgroundColour;
+            set
+            {
+                defaultBackgroundColour = value;
+
+                if (backgroundColour == null)
+                    Background.FadeColour(value);
+            }
+        }
+
         protected override Container<Drawable> Content { get; }
 
         protected Box Hover;
@@ -89,8 +108,7 @@ namespace osu.Game.Graphics.UserInterface
         [BackgroundDependencyLoader]
         private void load(OsuColour colours)
         {
-            if (backgroundColour == null)
-                BackgroundColour = colours.BlueDark;
+            DefaultBackgroundColour = colours.BlueDark;
         }
 
         protected override void LoadComplete()
@@ -106,10 +124,7 @@ namespace osu.Game.Graphics.UserInterface
         protected override bool OnClick(ClickEvent e)
         {
             if (Enabled.Value)
-            {
-                Debug.Assert(backgroundColour != null);
-                Background.FlashColour(backgroundColour.Value.Lighten(0.4f), 200);
-            }
+                Background.FlashColour(BackgroundColour.Lighten(0.4f), 200);
 
             return base.OnClick(e);
         }
diff --git a/osu.Game/Graphics/UserInterfaceV2/RoundedButton.cs b/osu.Game/Graphics/UserInterfaceV2/RoundedButton.cs
index f535a32b39..ec56b6d784 100644
--- a/osu.Game/Graphics/UserInterfaceV2/RoundedButton.cs
+++ b/osu.Game/Graphics/UserInterfaceV2/RoundedButton.cs
@@ -8,7 +8,6 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Overlays;
-using osuTK.Graphics;
 
 namespace osu.Game.Graphics.UserInterfaceV2
 {
@@ -29,8 +28,7 @@ namespace osu.Game.Graphics.UserInterfaceV2
         [BackgroundDependencyLoader(true)]
         private void load([CanBeNull] OverlayColourProvider overlayColourProvider, OsuColour colours)
         {
-            if (BackgroundColour == Color4.White)
-                BackgroundColour = overlayColourProvider?.Highlight1 ?? colours.Blue3;
+            DefaultBackgroundColour = overlayColourProvider?.Highlight1 ?? colours.Blue3;
         }
 
         protected override void LoadComplete()

From 5726cf660f7ec219804fb0ebb6315ab5af5017ed Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Mon, 9 May 2022 21:19:34 +0300
Subject: [PATCH 4700/5547] Improve test coverage to use existing
 `ThemeComparisonTestScene`

---
 .../UserInterface/TestSceneRoundedButton.cs   | 74 +++++--------------
 1 file changed, 18 insertions(+), 56 deletions(-)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneRoundedButton.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneRoundedButton.cs
index ef3c0c7fa4..f45c55d912 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneRoundedButton.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneRoundedButton.cs
@@ -1,78 +1,40 @@
 // 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.Extensions.IEnumerableExtensions;
+using osu.Framework.Bindables;
 using osu.Framework.Graphics;
-using osu.Framework.Graphics.Containers;
 using osu.Framework.Testing;
 using osu.Game.Graphics.UserInterfaceV2;
 using osu.Game.Overlays;
-using osuTK;
 
 namespace osu.Game.Tests.Visual.UserInterface
 {
-    public class TestSceneRoundedButton : OsuTestScene
+    public class TestSceneRoundedButton : ThemeComparisonTestScene
     {
-        [Test]
-        public void TestBasic()
+        private readonly BindableBool enabled = new BindableBool(true);
+
+        protected override Drawable CreateContent() => new RoundedButton
         {
-            RoundedButton button = null;
+            Width = 400,
+            Text = "Test button",
+            Anchor = Anchor.Centre,
+            Origin = Anchor.Centre,
+            Enabled = { BindTarget = enabled },
+        };
 
-            AddStep("create button", () => Child = new Container
-            {
-                RelativeSizeAxes = Axes.Both,
-                Children = new Drawable[]
-                {
-                    button = new RoundedButton
-                    {
-                        Width = 400,
-                        Text = "Test Button",
-                        Anchor = Anchor.Centre,
-                        Origin = Anchor.Centre,
-                        Action = () => { }
-                    }
-                }
-            });
-
-            AddToggleStep("toggle disabled", disabled => button.Action = disabled ? (Action)null : () => { });
+        [Test]
+        public void TestDisabled()
+        {
+            AddToggleStep("toggle disabled", disabled => enabled.Value = !disabled);
         }
 
         [Test]
-        public void TestOverlay()
+        public void TestBackgroundColour()
         {
-            IEnumerable<OverlayColourScheme> schemes = Enum.GetValues(typeof(OverlayColourScheme)).Cast<OverlayColourScheme>();
-
-            AddStep("create buttons", () =>
-            {
-                Child = new FillFlowContainer
-                {
-                    Anchor = Anchor.Centre,
-                    Origin = Anchor.Centre,
-                    AutoSizeAxes = Axes.Both,
-                    Direction = FillDirection.Vertical,
-                    Spacing = new Vector2(5f),
-                    ChildrenEnumerable = schemes.Select(c => new DependencyProvidingContainer
-                    {
-                        AutoSizeAxes = Axes.Both,
-                        CachedDependencies = new (Type, object)[] { (typeof(OverlayColourProvider), new OverlayColourProvider(c)) },
-                        Child = new RoundedButton
-                        {
-                            Width = 400,
-                            Text = $"Test {c}",
-                            Anchor = Anchor.Centre,
-                            Origin = Anchor.Centre,
-                            Action = () => { },
-                        }
-                    }),
-                };
-            });
-
-            AddAssert("first button has correct colour", () => this.ChildrenOfType<RoundedButton>().First().BackgroundColour == new OverlayColourProvider(schemes.First()).Highlight1);
-            AddToggleStep("toggle disabled", disabled => this.ChildrenOfType<RoundedButton>().ForEach(b => b.Action = disabled ? (Action)null : () => { }));
+            AddStep("set red scheme", () => CreateThemedContent(OverlayColourScheme.Red));
+            AddAssert("first button has correct colour", () => Cell(0, 1).ChildrenOfType<RoundedButton>().First().BackgroundColour == new OverlayColourProvider(OverlayColourScheme.Red).Highlight1);
         }
     }
 }

From ebb64d1f1ab7fb2b398ba11803690f0e83d56651 Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Mon, 9 May 2022 20:15:43 +0100
Subject: [PATCH 4701/5547] Use `AddUntilStep` to wait for channel to load and
 become visible

---
 .../Visual/Online/TestSceneChatOverlayV2.cs        | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs b/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs
index 9956b8977f..bf1767cc96 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs
@@ -131,7 +131,7 @@ namespace osu.Game.Tests.Visual.Online
                 channelManager.CurrentChannel.Value = joinedChannel;
             });
             AddAssert("Overlay is visible", () => chatOverlay.State.Value == Visibility.Visible);
-            AddAssert("Channel is visible", () => channelIsVisible && currentDrawableChannel.Channel == testChannel1);
+            AddUntilStep("Channel is visible", () => channelIsVisible && currentDrawableChannel.Channel == testChannel1);
         }
 
         [Test]
@@ -174,7 +174,7 @@ namespace osu.Game.Tests.Visual.Online
             AddAssert("Listing is visible", () => listingIsVisible);
             AddStep("Join channel 1", () => channelManager.JoinChannel(testChannel1));
             AddStep("Select channel 1", () => clickDrawable(getChannelListItem(testChannel1)));
-            AddAssert("Channel 1 is visible", () => channelIsVisible && currentDrawableChannel.Channel == testChannel1);
+            AddUntilStep("Channel 1 is visible", () => channelIsVisible && currentDrawableChannel.Channel == testChannel1);
         }
 
         [Test]
@@ -273,7 +273,7 @@ namespace osu.Game.Tests.Visual.Online
                 });
             });
             AddStep("Highlight message", () => chatOverlay.HighlightMessage(message, testChannel1));
-            AddAssert("Channel 1 is visible", () => channelIsVisible && currentDrawableChannel.Channel == testChannel1);
+            AddUntilStep("Channel 1 is visible", () => channelIsVisible && currentDrawableChannel.Channel == testChannel1);
         }
 
         [Test]
@@ -296,7 +296,7 @@ namespace osu.Game.Tests.Visual.Online
                 });
             });
             AddStep("Highlight message", () => chatOverlay.HighlightMessage(message, testChannel2));
-            AddAssert("Channel 2 is visible", () => channelIsVisible && currentDrawableChannel.Channel == testChannel2);
+            AddUntilStep("Channel 2 is visible", () => channelIsVisible && currentDrawableChannel.Channel == testChannel2);
         }
 
         [Test]
@@ -320,7 +320,7 @@ namespace osu.Game.Tests.Visual.Online
             });
             AddStep("Leave channel 2", () => channelManager.LeaveChannel(testChannel2));
             AddStep("Highlight message", () => chatOverlay.HighlightMessage(message, testChannel2));
-            AddAssert("Channel 2 is visible", () => channelIsVisible && currentDrawableChannel.Channel == testChannel2);
+            AddUntilStep("Channel 2 is visible", () => channelIsVisible && currentDrawableChannel.Channel == testChannel2);
         }
 
         [Test]
@@ -340,7 +340,7 @@ namespace osu.Game.Tests.Visual.Online
                 });
             });
             AddStep("Highlight message", () => chatOverlay.HighlightMessage(message, testChannel1));
-            AddAssert("Channel 1 is visible", () => channelIsVisible && currentDrawableChannel.Channel == testChannel1);
+            AddUntilStep("Channel 1 is visible", () => channelIsVisible && currentDrawableChannel.Channel == testChannel1);
         }
 
         [Test]
@@ -361,7 +361,7 @@ namespace osu.Game.Tests.Visual.Online
             });
             AddStep("Set null channel", () => channelManager.CurrentChannel.Value = null);
             AddStep("Highlight message", () => chatOverlay.HighlightMessage(message, testChannel1));
-            AddAssert("Channel 1 is visible", () => channelIsVisible && currentDrawableChannel.Channel == testChannel1);
+            AddUntilStep("Channel 1 is visible", () => channelIsVisible && currentDrawableChannel.Channel == testChannel1);
         }
 
         [Test]

From 38e463d31da24d4721efc22e0541505831268c36 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 9 May 2022 22:16:04 +0200
Subject: [PATCH 4702/5547] Add failing test case for invalid mod adjustment
 management

---
 .../UserInterface/TestSceneModSelectScreen.cs | 32 +++++++++++++++++++
 1 file changed, 32 insertions(+)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs
index fa7758df59..661465b484 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs
@@ -481,6 +481,38 @@ namespace osu.Game.Tests.Visual.UserInterface
             AddUntilStep("3 columns visible", () => this.ChildrenOfType<ModColumn>().Count(col => col.IsPresent) == 3);
         }
 
+        [Test]
+        public void TestCorrectAudioAdjustmentDeapplication()
+        {
+            createScreen();
+            changeRuleset(0);
+
+            AddStep("allow track adjustments", () => MusicController.AllowTrackAdjustments = true);
+
+            AddStep("set wind up", () => modSelectScreen.SelectedMods.Value = new[] { new ModWindUp() });
+            AddStep("open customisation menu", () =>
+            {
+                InputManager.MoveMouseTo(this.ChildrenOfType<ShearedToggleButton>().Single());
+                InputManager.Click(MouseButton.Left);
+            });
+            AddAssert("frequency above 1", () => MusicController.CurrentTrack.AggregateFrequency.Value > 1);
+            AddAssert("tempo is 1", () => MusicController.CurrentTrack.AggregateTempo.Value == 1);
+
+            AddStep("turn off pitch adjustment", () =>
+            {
+                InputManager.MoveMouseTo(this.ChildrenOfType<SettingsCheckbox>().Single());
+                InputManager.Click(MouseButton.Left);
+            });
+            AddAssert("frequency is 1", () => MusicController.CurrentTrack.AggregateFrequency.Value == 1);
+            AddAssert("tempo above 1", () => MusicController.CurrentTrack.AggregateTempo.Value > 1);
+
+            AddStep("reset mods", () => modSelectScreen.SelectedMods.SetDefault());
+            AddAssert("frequency is 1", () => MusicController.CurrentTrack.AggregateFrequency.Value == 1);
+            AddAssert("tempo is 1", () => MusicController.CurrentTrack.AggregateTempo.Value == 1);
+
+            AddStep("disallow track adjustments", () => MusicController.AllowTrackAdjustments = false);
+        }
+
         private void waitForColumnLoad() => AddUntilStep("all column content loaded",
             () => modSelectScreen.ChildrenOfType<ModColumn>().Any() && modSelectScreen.ChildrenOfType<ModColumn>().All(column => column.IsLoaded && column.ItemsLoaded));
 

From 96ea4ee7b33136a4fb563520c730c971eaf63026 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Mon, 9 May 2022 23:49:05 +0300
Subject: [PATCH 4703/5547] Add explanatory comment

---
 osu.Game/Overlays/SettingsToolboxGroup.cs | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/osu.Game/Overlays/SettingsToolboxGroup.cs b/osu.Game/Overlays/SettingsToolboxGroup.cs
index 36d4f03e02..077762c0d0 100644
--- a/osu.Game/Overlays/SettingsToolboxGroup.cs
+++ b/osu.Game/Overlays/SettingsToolboxGroup.cs
@@ -156,6 +156,8 @@ namespace osu.Game.Overlays
 
         private void updateExpandedState(ValueChangedEvent<bool> expanded)
         {
+            // clearing transforms is necessary to avoid a previous height transform
+            // potentially continuing to get processed while content has changed to autosize.
             content.ClearTransforms();
 
             if (expanded.NewValue)

From beb86a7f7c909f27ba0f8fa217338e32a067bac4 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Mon, 9 May 2022 23:57:08 +0300
Subject: [PATCH 4704/5547] Remove usage of player settings in
 `TestSceneSettingsToolboxGroup`

---
 .../TestSceneSettingsToolboxGroup.cs          | 73 ++++++++-----------
 1 file changed, 29 insertions(+), 44 deletions(-)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneSettingsToolboxGroup.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneSettingsToolboxGroup.cs
index 76657afbcd..8ef24e58a0 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneSettingsToolboxGroup.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneSettingsToolboxGroup.cs
@@ -4,12 +4,11 @@
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Graphics;
-using osu.Framework.Graphics.Containers;
 using osu.Framework.Testing;
 using osu.Game.Graphics.UserInterface;
+using osu.Game.Graphics.UserInterfaceV2;
 using osu.Game.Overlays;
-using osu.Game.Screens.Play.HUD;
-using osu.Game.Screens.Play.PlayerSettings;
+using osu.Game.Overlays.Settings;
 using osuTK.Input;
 
 namespace osu.Game.Tests.Visual.UserInterface
@@ -17,45 +16,39 @@ namespace osu.Game.Tests.Visual.UserInterface
     [TestFixture]
     public class TestSceneSettingsToolboxGroup : OsuManualInputManagerTestScene
     {
-        public TestSceneSettingsToolboxGroup()
+        private SettingsToolboxGroup group;
+
+        [SetUp]
+        public void SetUp() => Schedule(() =>
         {
-            ExampleContainer container;
-
-            Add(new PlayerSettingsOverlay
+            Child = group = new SettingsToolboxGroup("example")
             {
-                Anchor = Anchor.TopRight,
-                Origin = Anchor.TopRight,
-                State = { Value = Visibility.Visible }
-            });
-
-            Add(container = new ExampleContainer());
-
-            AddStep(@"Add button", () => container.Add(new TriangleButton
-            {
-                RelativeSizeAxes = Axes.X,
-                Text = @"Button",
-            }));
-
-            AddStep(@"Add checkbox", () => container.Add(new PlayerCheckbox
-            {
-                LabelText = "Checkbox",
-            }));
-
-            AddStep(@"Add textbox", () => container.Add(new FocusedTextBox
-            {
-                RelativeSizeAxes = Axes.X,
-                Height = 30,
-                PlaceholderText = "Textbox",
-                HoldFocus = false,
-            }));
-        }
+                Children = new Drawable[]
+                {
+                    new RoundedButton
+                    {
+                        RelativeSizeAxes = Axes.X,
+                        Text = @"Button",
+                        Enabled = { Value = true },
+                    },
+                    new OsuCheckbox
+                    {
+                        LabelText = @"Checkbox",
+                    },
+                    new OutlinedTextBox
+                    {
+                        RelativeSizeAxes = Axes.X,
+                        Height = 30,
+                        PlaceholderText = @"Textbox",
+                    }
+                },
+            };
+        });
 
         [Test]
         public void TestClickExpandButtonMultipleTimes()
         {
-            SettingsToolboxGroup group = null;
-
-            AddAssert("group expanded by default", () => (group = this.ChildrenOfType<SettingsToolboxGroup>().First()).Expanded.Value);
+            AddAssert("group expanded by default", () => group.Expanded.Value);
             AddStep("click expand button multiple times", () =>
             {
                 InputManager.MoveMouseTo(group.ChildrenOfType<IconButton>().Single());
@@ -65,13 +58,5 @@ namespace osu.Game.Tests.Visual.UserInterface
             });
             AddAssert("group contracted", () => !group.Expanded.Value);
         }
-
-        private class ExampleContainer : PlayerSettingsGroup
-        {
-            public ExampleContainer()
-                : base("example")
-            {
-            }
-        }
     }
 }

From 2481201a734ef248e2f99f58734f136389b93393 Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Mon, 9 May 2022 22:58:46 +0100
Subject: [PATCH 4705/5547] Fix selector dismissal behaviour during user
 actions

---
 osu.Game/Overlays/ChatOverlayV2.cs | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/ChatOverlayV2.cs b/osu.Game/Overlays/ChatOverlayV2.cs
index 48b34726f8..e59bee7977 100644
--- a/osu.Game/Overlays/ChatOverlayV2.cs
+++ b/osu.Game/Overlays/ChatOverlayV2.cs
@@ -165,7 +165,12 @@ namespace osu.Game.Overlays
             };
             channelList.OnRequestLeave += channel => channelManager.LeaveChannel(channel);
 
-            channelListing.OnRequestJoin += channel => channelManager.JoinChannel(channel);
+            channelListing.OnRequestJoin += channel =>
+            {
+                channelManager.JoinChannel(channel);
+                // Manually joining a channel should keep the selector open
+                selectorActive.Value = true;
+            };
             channelListing.OnRequestLeave += channel => channelManager.LeaveChannel(channel);
 
             textBar.OnSearchTermsChanged += searchTerms => channelListing.SearchTerm = searchTerms;
@@ -255,6 +260,10 @@ namespace osu.Game.Overlays
             // Channel is null when leaving the currently selected channel
             if (newChannel == null)
             {
+                // Don't need to autoswitch if the selector is visible
+                if (selectorActive.Value)
+                    return;
+
                 // Find another channel to switch to
                 newChannel = channelManager.JoinedChannels.FirstOrDefault(c => c != channel.OldValue);
 

From 2b7eeadac0fbf52419050fbd8e4fe69ff93de893 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 10 May 2022 14:48:41 +0900
Subject: [PATCH 4706/5547] Workaround bad performance when selecting all
 freemods

---
 osu.Game/Overlays/Mods/ModSelectScreen.cs | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/Mods/ModSelectScreen.cs b/osu.Game/Overlays/Mods/ModSelectScreen.cs
index 16975cfd1d..1c629b7a4f 100644
--- a/osu.Game/Overlays/Mods/ModSelectScreen.cs
+++ b/osu.Game/Overlays/Mods/ModSelectScreen.cs
@@ -192,7 +192,8 @@ namespace osu.Game.Overlays.Mods
 
             State.BindValueChanged(_ => samplePlaybackDisabled.Value = State.Value == Visibility.Hidden, true);
 
-            ((IBindable<IReadOnlyList<Mod>>)modSettingsArea.SelectedMods).BindTo(SelectedMods);
+            if (customisationButton != null)
+                ((IBindable<IReadOnlyList<Mod>>)modSettingsArea.SelectedMods).BindTo(SelectedMods);
 
             SelectedMods.BindValueChanged(val =>
             {

From 8ccf2ee0759e58e14d8544c32297e410a8c5fb5e Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 10 May 2022 15:07:08 +0900
Subject: [PATCH 4707/5547] Add inline comment

---
 osu.Game/Overlays/Mods/ModSelectScreen.cs | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/osu.Game/Overlays/Mods/ModSelectScreen.cs b/osu.Game/Overlays/Mods/ModSelectScreen.cs
index 1c629b7a4f..912c09f05c 100644
--- a/osu.Game/Overlays/Mods/ModSelectScreen.cs
+++ b/osu.Game/Overlays/Mods/ModSelectScreen.cs
@@ -192,6 +192,8 @@ namespace osu.Game.Overlays.Mods
 
             State.BindValueChanged(_ => samplePlaybackDisabled.Value = State.Value == Visibility.Hidden, true);
 
+            // This is an optimisation to prevent refreshing the available settings controls when it can be
+            // reasonably assumed that the settings panel is never to be displayed (e.g. FreeModSelectScreen).
             if (customisationButton != null)
                 ((IBindable<IReadOnlyList<Mod>>)modSettingsArea.SelectedMods).BindTo(SelectedMods);
 

From bcd91ac743885c1bce1df4bf6a84de925004b73d Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Tue, 10 May 2022 10:02:32 +0300
Subject: [PATCH 4708/5547] Move exception soft-handling logic to `OsuGameBase`

---
 osu.Desktop/Program.cs  | 22 ----------------------
 osu.Game/OsuGameBase.cs | 30 ++++++++++++++++++++++++++++++
 2 files changed, 30 insertions(+), 22 deletions(-)

diff --git a/osu.Desktop/Program.cs b/osu.Desktop/Program.cs
index eb9045d9ce..405f0a8006 100644
--- a/osu.Desktop/Program.cs
+++ b/osu.Desktop/Program.cs
@@ -4,8 +4,6 @@
 using System;
 using System.IO;
 using System.Runtime.Versioning;
-using System.Threading;
-using System.Threading.Tasks;
 using osu.Desktop.LegacyIpc;
 using osu.Framework;
 using osu.Framework.Development;
@@ -63,8 +61,6 @@ namespace osu.Desktop
 
             using (DesktopGameHost host = Host.GetSuitableDesktopHost(gameName, new HostOptions { BindIPC = true }))
             {
-                host.ExceptionThrown += handleException;
-
                 if (!host.IsPrimaryInstance)
                 {
                     if (args.Length > 0 && args[0].Contains('.')) // easy way to check for a file import in args
@@ -131,23 +127,5 @@ namespace osu.Desktop
                 // tools.SetProcessAppUserModelId();
             });
         }
-
-        private static int allowableExceptions = DebugUtils.IsDebugBuild ? 0 : 1;
-
-        /// <summary>
-        /// Allow a maximum of one unhandled exception, per second of execution.
-        /// </summary>
-        /// <param name="arg"></param>
-        private static bool handleException(Exception arg)
-        {
-            bool continueExecution = Interlocked.Decrement(ref allowableExceptions) >= 0;
-
-            Logger.Log($"Unhandled exception has been {(continueExecution ? $"allowed with {allowableExceptions} more allowable exceptions" : "denied")} .");
-
-            // restore the stock of allowable exceptions after a short delay.
-            Task.Delay(1000).ContinueWith(_ => Interlocked.Increment(ref allowableExceptions));
-
-            return continueExecution;
-        }
     }
 }
diff --git a/osu.Game/OsuGameBase.cs b/osu.Game/OsuGameBase.cs
index 324fcada89..c5b69a3637 100644
--- a/osu.Game/OsuGameBase.cs
+++ b/osu.Game/OsuGameBase.cs
@@ -7,6 +7,7 @@ using System.IO;
 using System.Linq;
 using System.Reflection;
 using System.Threading;
+using System.Threading.Tasks;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
 using osu.Framework.Bindables;
@@ -180,9 +181,16 @@ namespace osu.Game
         /// </summary>
         protected DatabaseContextFactory EFContextFactory { get; private set; }
 
+        /// <summary>
+        /// Number of exceptions to allow before aborting execution.
+        /// </summary>
+        protected virtual int SoftHandledExceptions => 0;
+
         public OsuGameBase()
         {
             Name = @"osu!";
+
+            allowableExceptions = SoftHandledExceptions;
         }
 
         [BackgroundDependencyLoader]
@@ -408,6 +416,8 @@ namespace osu.Game
             LocalConfig ??= UseDevelopmentServer
                 ? new DevelopmentOsuConfigManager(Storage)
                 : new OsuConfigManager(Storage);
+
+            host.ExceptionThrown += onExceptionThrown;
         }
 
         /// <summary>
@@ -505,6 +515,23 @@ namespace osu.Game
             AvailableMods.Value = dict;
         }
 
+        private int allowableExceptions;
+
+        /// <summary>
+        /// Allows a maximum of one unhandled exception, per second of execution.
+        /// </summary>
+        private bool onExceptionThrown(Exception _)
+        {
+            bool continueExecution = Interlocked.Decrement(ref allowableExceptions) >= 0;
+
+            Logger.Log($"Unhandled exception has been {(continueExecution ? $"allowed with {SoftHandledExceptions} more allowable exceptions" : "denied")} .");
+
+            // restore the stock of allowable exceptions after a short delay.
+            Task.Delay(1000).ContinueWith(_ => Interlocked.Increment(ref allowableExceptions));
+
+            return continueExecution;
+        }
+
         protected override void Dispose(bool isDisposing)
         {
             base.Dispose(isDisposing);
@@ -514,6 +541,9 @@ namespace osu.Game
             LocalConfig?.Dispose();
 
             realm?.Dispose();
+
+            if (Host != null)
+                Host.ExceptionThrown -= onExceptionThrown;
         }
     }
 }

From 725f5f4dcb00616e5f7f65ab6595918ad2812a8a Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Tue, 10 May 2022 10:02:41 +0300
Subject: [PATCH 4709/5547] Allow one more exception per second in `OsuGame`
 and `TournamentGame`

---
 osu.Game.Tournament/TournamentGame.cs | 3 +++
 osu.Game/OsuGame.cs                   | 3 +++
 2 files changed, 6 insertions(+)

diff --git a/osu.Game.Tournament/TournamentGame.cs b/osu.Game.Tournament/TournamentGame.cs
index 7967f54b49..d9db0e6d20 100644
--- a/osu.Game.Tournament/TournamentGame.cs
+++ b/osu.Game.Tournament/TournamentGame.cs
@@ -6,6 +6,7 @@ using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Configuration;
+using osu.Framework.Development;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Colour;
@@ -39,6 +40,8 @@ namespace osu.Game.Tournament
         private Bindable<WindowMode> windowMode;
         private LoadingSpinner loadingSpinner;
 
+        protected override int SoftHandledExceptions => DebugUtils.IsDebugBuild ? 0 : 1;
+
         [BackgroundDependencyLoader]
         private void load(FrameworkConfigManager frameworkConfig, GameHost host)
         {
diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index 54c4231b06..6961dce910 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -13,6 +13,7 @@ using osu.Framework.Allocation;
 using osu.Framework.Audio;
 using osu.Framework.Bindables;
 using osu.Framework.Configuration;
+using osu.Framework.Development;
 using osu.Framework.Extensions.IEnumerableExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
@@ -175,6 +176,8 @@ namespace osu.Game
 
         private readonly List<OverlayContainer> visibleBlockingOverlays = new List<OverlayContainer>();
 
+        protected override int SoftHandledExceptions => DebugUtils.IsDebugBuild ? 0 : 1;
+
         public OsuGame(string[] args = null)
         {
             this.args = args;

From dc3c73f72300af57ad18b9671178c0bed2e1206d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 10 May 2022 14:03:03 +0900
Subject: [PATCH 4710/5547] Enable sentry session tracking

---
 osu.Game/Utils/SentryLogger.cs | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/osu.Game/Utils/SentryLogger.cs b/osu.Game/Utils/SentryLogger.cs
index d9c8199f75..7e0449cec8 100644
--- a/osu.Game/Utils/SentryLogger.cs
+++ b/osu.Game/Utils/SentryLogger.cs
@@ -25,6 +25,8 @@ namespace osu.Game.Utils
             var options = new SentryOptions
             {
                 Dsn = "https://ad9f78529cef40ac874afb95a9aca04e@sentry.ppy.sh/2",
+                AutoSessionTracking = true,
+                IsEnvironmentUser = false,
                 Release = game.Version
             };
 

From 09c21cde8ca15a02ddd29dba669cb200fa9919fb Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 10 May 2022 14:08:42 +0900
Subject: [PATCH 4711/5547] Add log level translation

---
 osu.Game/Utils/SentryLogger.cs | 27 ++++++++++++++++++++++++++-
 1 file changed, 26 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Utils/SentryLogger.cs b/osu.Game/Utils/SentryLogger.cs
index 7e0449cec8..c39d718d62 100644
--- a/osu.Game/Utils/SentryLogger.cs
+++ b/osu.Game/Utils/SentryLogger.cs
@@ -50,12 +50,37 @@ namespace osu.Game.Utils
                 if (lastException != null && lastException.Message == exception.Message && exception.StackTrace.StartsWith(lastException.StackTrace, StringComparison.Ordinal)) return;
 
                 lastException = exception;
-                sentry.CaptureEvent(new SentryEvent(exception) { Message = entry.Message }, sentryScope);
+                sentry.CaptureEvent(new SentryEvent(exception)
+                {
+                    Message = entry.Message,
+                    Level = getSentryLevel(entry.Level),
+                }, sentryScope);
             }
             else
                 sentryScope.AddBreadcrumb(DateTimeOffset.Now, entry.Message, entry.Target.ToString(), "navigation");
         }
 
+        private SentryLevel? getSentryLevel(LogLevel entryLevel)
+        {
+            switch (entryLevel)
+            {
+                case LogLevel.Debug:
+                    return SentryLevel.Debug;
+
+                case LogLevel.Verbose:
+                    return SentryLevel.Info;
+
+                case LogLevel.Important:
+                    return SentryLevel.Warning;
+
+                case LogLevel.Error:
+                    return SentryLevel.Error;
+
+                default:
+                    throw new ArgumentOutOfRangeException(nameof(entryLevel), entryLevel, null);
+            }
+        }
+
         private bool shouldSubmitException(Exception exception)
         {
             switch (exception)

From 64cc6ebddbb090edc7a39bb83415b68dc7f25ece Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 10 May 2022 14:12:31 +0900
Subject: [PATCH 4712/5547] Add local user tracking to sentry reporting

---
 osu.Game/OsuGameBase.cs        |  2 +-
 osu.Game/Utils/SentryLogger.cs | 17 +++++++++++++++++
 2 files changed, 18 insertions(+), 1 deletion(-)

diff --git a/osu.Game/OsuGameBase.cs b/osu.Game/OsuGameBase.cs
index 324fcada89..3f0610e9aa 100644
--- a/osu.Game/OsuGameBase.cs
+++ b/osu.Game/OsuGameBase.cs
@@ -125,7 +125,7 @@ namespace osu.Game
 
         protected MusicController MusicController { get; private set; }
 
-        protected IAPIProvider API { get; set; }
+        protected internal IAPIProvider API { get; protected set; }
 
         protected Storage Storage { get; set; }
 
diff --git a/osu.Game/Utils/SentryLogger.cs b/osu.Game/Utils/SentryLogger.cs
index c39d718d62..5cecc4d776 100644
--- a/osu.Game/Utils/SentryLogger.cs
+++ b/osu.Game/Utils/SentryLogger.cs
@@ -4,7 +4,10 @@
 using System;
 using System.IO;
 using System.Net;
+using JetBrains.Annotations;
+using osu.Framework.Bindables;
 using osu.Framework.Logging;
+using osu.Game.Online.API.Requests.Responses;
 using Sentry;
 
 namespace osu.Game.Utils
@@ -18,6 +21,9 @@ namespace osu.Game.Utils
         private Scope sentryScope;
         private Exception lastException;
 
+        [UsedImplicitly]
+        private readonly IBindable<APIUser> localUser;
+
         public SentryLogger(OsuGame game)
         {
             if (!game.IsDeployedBuild) return;
@@ -34,6 +40,16 @@ namespace osu.Game.Utils
             sentryScope = new Scope(options);
 
             Logger.NewEntry += processLogEntry;
+
+            localUser = game.API.LocalUser.GetBoundCopy();
+            localUser.BindValueChanged(user =>
+            {
+                sentryScope.User = new User
+                {
+                    Username = user.NewValue.Username,
+                    Id = user.NewValue.Id.ToString(),
+                };
+            });
         }
 
         private void processLogEntry(LogEntry entry)
@@ -50,6 +66,7 @@ namespace osu.Game.Utils
                 if (lastException != null && lastException.Message == exception.Message && exception.StackTrace.StartsWith(lastException.StackTrace, StringComparison.Ordinal)) return;
 
                 lastException = exception;
+
                 sentry.CaptureEvent(new SentryEvent(exception)
                 {
                     Message = entry.Message,

From a5b454edc72537daaaf428bca8b34bf8a9c926b7 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 10 May 2022 14:21:49 +0900
Subject: [PATCH 4713/5547] Remove unnecessary DI caching of `SentryLogger`

---
 osu.Game.Tests/Visual/Navigation/TestSceneOsuGame.cs | 2 --
 osu.Game/OsuGame.cs                                  | 2 --
 2 files changed, 4 deletions(-)

diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneOsuGame.cs b/osu.Game.Tests/Visual/Navigation/TestSceneOsuGame.cs
index 0f8337deb6..e4871f611e 100644
--- a/osu.Game.Tests/Visual/Navigation/TestSceneOsuGame.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneOsuGame.cs
@@ -23,7 +23,6 @@ using osu.Game.Rulesets.Mods;
 using osu.Game.Scoring;
 using osu.Game.Screens.Menu;
 using osu.Game.Skinning;
-using osu.Game.Utils;
 
 namespace osu.Game.Tests.Visual.Navigation
 {
@@ -33,7 +32,6 @@ namespace osu.Game.Tests.Visual.Navigation
         private IReadOnlyList<Type> requiredGameDependencies => new[]
         {
             typeof(OsuGame),
-            typeof(SentryLogger),
             typeof(OsuLogo),
             typeof(IdleTracker),
             typeof(OnScreenDisplay),
diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index 54c4231b06..a6c57998b0 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -258,8 +258,6 @@ namespace osu.Game
         {
             dependencies.CacheAs(this);
 
-            dependencies.Cache(SentryLogger);
-
             dependencies.Cache(osuLogo = new OsuLogo { Alpha = 0 });
 
             // bind config int to database RulesetInfo

From 3338bffce3809d78d0f00e6b0b2bf332e62c8af7 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 10 May 2022 14:25:10 +0900
Subject: [PATCH 4714/5547] Attach user to sentry later in startup flow

---
 osu.Game/OsuGame.cs            |  2 ++
 osu.Game/OsuGameBase.cs        |  2 +-
 osu.Game/Utils/SentryLogger.cs | 26 +++++++++++++++-----------
 3 files changed, 18 insertions(+), 12 deletions(-)

diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index a6c57998b0..b8abef38a8 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -258,6 +258,8 @@ namespace osu.Game
         {
             dependencies.CacheAs(this);
 
+            SentryLogger.AttachUser(API.LocalUser);
+
             dependencies.Cache(osuLogo = new OsuLogo { Alpha = 0 });
 
             // bind config int to database RulesetInfo
diff --git a/osu.Game/OsuGameBase.cs b/osu.Game/OsuGameBase.cs
index 3f0610e9aa..324fcada89 100644
--- a/osu.Game/OsuGameBase.cs
+++ b/osu.Game/OsuGameBase.cs
@@ -125,7 +125,7 @@ namespace osu.Game
 
         protected MusicController MusicController { get; private set; }
 
-        protected internal IAPIProvider API { get; protected set; }
+        protected IAPIProvider API { get; set; }
 
         protected Storage Storage { get; set; }
 
diff --git a/osu.Game/Utils/SentryLogger.cs b/osu.Game/Utils/SentryLogger.cs
index 5cecc4d776..92f2902c0e 100644
--- a/osu.Game/Utils/SentryLogger.cs
+++ b/osu.Game/Utils/SentryLogger.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.
 
+#nullable enable
+
 using System;
+using System.Diagnostics;
 using System.IO;
 using System.Net;
-using JetBrains.Annotations;
 using osu.Framework.Bindables;
 using osu.Framework.Logging;
 using osu.Game.Online.API.Requests.Responses;
@@ -19,10 +21,9 @@ namespace osu.Game.Utils
     {
         private SentryClient sentry;
         private Scope sentryScope;
-        private Exception lastException;
+        private Exception? lastException;
 
-        [UsedImplicitly]
-        private readonly IBindable<APIUser> localUser;
+        private IBindable<APIUser>? localUser;
 
         public SentryLogger(OsuGame game)
         {
@@ -40,16 +41,21 @@ namespace osu.Game.Utils
             sentryScope = new Scope(options);
 
             Logger.NewEntry += processLogEntry;
+        }
 
-            localUser = game.API.LocalUser.GetBoundCopy();
-            localUser.BindValueChanged(user =>
+        public void AttachUser(IBindable<APIUser> user)
+        {
+            Debug.Assert(localUser == null);
+
+            localUser = user.GetBoundCopy();
+            localUser.BindValueChanged(u =>
             {
                 sentryScope.User = new User
                 {
-                    Username = user.NewValue.Username,
-                    Id = user.NewValue.Id.ToString(),
+                    Username = u.NewValue.Username,
+                    Id = u.NewValue.Id.ToString(),
                 };
-            });
+            }, true);
         }
 
         private void processLogEntry(LogEntry entry)
@@ -137,8 +143,6 @@ namespace osu.Game.Utils
         protected virtual void Dispose(bool isDisposing)
         {
             Logger.NewEntry -= processLogEntry;
-            sentry = null;
-            sentryScope = null;
         }
 
         #endregion

From 9734d778f4bda85e2f38cd03e326c09cb3c40ac7 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 10 May 2022 14:44:54 +0900
Subject: [PATCH 4715/5547] Update sentry SDK usage in line with more recent
 specifications

---
 osu.Game/Utils/SentryLogger.cs | 33 ++++++++++++++++-----------------
 1 file changed, 16 insertions(+), 17 deletions(-)

diff --git a/osu.Game/Utils/SentryLogger.cs b/osu.Game/Utils/SentryLogger.cs
index 92f2902c0e..02bcdd281a 100644
--- a/osu.Game/Utils/SentryLogger.cs
+++ b/osu.Game/Utils/SentryLogger.cs
@@ -19,26 +19,24 @@ namespace osu.Game.Utils
     /// </summary>
     public class SentryLogger : IDisposable
     {
-        private SentryClient sentry;
-        private Scope sentryScope;
         private Exception? lastException;
 
         private IBindable<APIUser>? localUser;
 
+        private readonly IDisposable? sentrySession;
+
         public SentryLogger(OsuGame game)
         {
-            if (!game.IsDeployedBuild) return;
-
-            var options = new SentryOptions
+            sentrySession = SentrySdk.Init(options =>
             {
-                Dsn = "https://ad9f78529cef40ac874afb95a9aca04e@sentry.ppy.sh/2",
-                AutoSessionTracking = true,
-                IsEnvironmentUser = false,
-                Release = game.Version
-            };
+                // Not setting the dsn will completely disable sentry.
+                if (game.IsDeployedBuild)
+                    options.Dsn = "https://ad9f78529cef40ac874afb95a9aca04e@sentry.ppy.sh/2";
 
-            sentry = new SentryClient(options);
-            sentryScope = new Scope(options);
+                options.AutoSessionTracking = true;
+                options.IsEnvironmentUser = false;
+                options.Release = game.Version;
+            });
 
             Logger.NewEntry += processLogEntry;
         }
@@ -50,11 +48,11 @@ namespace osu.Game.Utils
             localUser = user.GetBoundCopy();
             localUser.BindValueChanged(u =>
             {
-                sentryScope.User = new User
+                SentrySdk.ConfigureScope(scope => scope.User = new User
                 {
                     Username = u.NewValue.Username,
                     Id = u.NewValue.Id.ToString(),
-                };
+                });
             }, true);
         }
 
@@ -73,14 +71,14 @@ namespace osu.Game.Utils
 
                 lastException = exception;
 
-                sentry.CaptureEvent(new SentryEvent(exception)
+                SentrySdk.CaptureEvent(new SentryEvent(exception)
                 {
                     Message = entry.Message,
                     Level = getSentryLevel(entry.Level),
-                }, sentryScope);
+                });
             }
             else
-                sentryScope.AddBreadcrumb(DateTimeOffset.Now, entry.Message, entry.Target.ToString(), "navigation");
+                SentrySdk.AddBreadcrumb(entry.Message, entry.Target.ToString(), "navigation");
         }
 
         private SentryLevel? getSentryLevel(LogLevel entryLevel)
@@ -143,6 +141,7 @@ namespace osu.Game.Utils
         protected virtual void Dispose(bool isDisposing)
         {
             Logger.NewEntry -= processLogEntry;
+            sentrySession?.Dispose();
         }
 
         #endregion

From 99e6d56508799132912238edf898df000f33033a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 10 May 2022 14:45:55 +0900
Subject: [PATCH 4716/5547] Add finalizer to sentry logger for safety

---
 osu.Game/Utils/SentryLogger.cs | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/osu.Game/Utils/SentryLogger.cs b/osu.Game/Utils/SentryLogger.cs
index 02bcdd281a..c6429b6b2c 100644
--- a/osu.Game/Utils/SentryLogger.cs
+++ b/osu.Game/Utils/SentryLogger.cs
@@ -41,6 +41,8 @@ namespace osu.Game.Utils
             Logger.NewEntry += processLogEntry;
         }
 
+        ~SentryLogger() => Dispose(false);
+
         public void AttachUser(IBindable<APIUser> user)
         {
             Debug.Assert(localUser == null);

From c6112b3ae78becb6980053ae047258c103a4db8e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 10 May 2022 15:07:02 +0900
Subject: [PATCH 4717/5547] Add unhandled exception marking

---
 osu.Game/Utils/SentryLogger.cs | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/osu.Game/Utils/SentryLogger.cs b/osu.Game/Utils/SentryLogger.cs
index c6429b6b2c..728d6ab9be 100644
--- a/osu.Game/Utils/SentryLogger.cs
+++ b/osu.Game/Utils/SentryLogger.cs
@@ -11,6 +11,7 @@ using osu.Framework.Bindables;
 using osu.Framework.Logging;
 using osu.Game.Online.API.Requests.Responses;
 using Sentry;
+using Sentry.Protocol;
 
 namespace osu.Game.Utils
 {
@@ -73,6 +74,13 @@ namespace osu.Game.Utils
 
                 lastException = exception;
 
+                // framework does some weird exception redirection which means sentry does not see unhandled exceptions using its automatic methods.
+                // but all unhandled exceptions still arrive via this pathway. we just need to mark them as unhandled for tagging purposes.
+                // easiest solution is to check the message matches what the framework logs this as.
+                // see https://github.com/ppy/osu-framework/blob/f932f8df053f0011d755c95ad9a2ed61b94d136b/osu.Framework/Platform/GameHost.cs#L336
+                bool wasHandled = entry.Message != @"An unhandled exception has occurred.";
+                exception.Data[Mechanism.HandledKey] = wasHandled;
+
                 SentrySdk.CaptureEvent(new SentryEvent(exception)
                 {
                     Message = entry.Message,

From 363643a16d64777ffd0daf681507ec0e53d003c3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 10 May 2022 15:08:49 +0900
Subject: [PATCH 4718/5547] Remove sentry logger debounce

This is probably going to result in a high quantity of exceptions, but I
think this is fine. We can add rules as we go to not log certain
exception types.
---
 osu.Game/Utils/SentryLogger.cs | 7 -------
 1 file changed, 7 deletions(-)

diff --git a/osu.Game/Utils/SentryLogger.cs b/osu.Game/Utils/SentryLogger.cs
index 728d6ab9be..170d8e7cb0 100644
--- a/osu.Game/Utils/SentryLogger.cs
+++ b/osu.Game/Utils/SentryLogger.cs
@@ -20,8 +20,6 @@ namespace osu.Game.Utils
     /// </summary>
     public class SentryLogger : IDisposable
     {
-        private Exception? lastException;
-
         private IBindable<APIUser>? localUser;
 
         private readonly IDisposable? sentrySession;
@@ -69,11 +67,6 @@ namespace osu.Game.Utils
             {
                 if (!shouldSubmitException(exception)) return;
 
-                // since we let unhandled exceptions go ignored at times, we want to ensure they don't get submitted on subsequent reports.
-                if (lastException != null && lastException.Message == exception.Message && exception.StackTrace.StartsWith(lastException.StackTrace, StringComparison.Ordinal)) return;
-
-                lastException = exception;
-
                 // framework does some weird exception redirection which means sentry does not see unhandled exceptions using its automatic methods.
                 // but all unhandled exceptions still arrive via this pathway. we just need to mark them as unhandled for tagging purposes.
                 // easiest solution is to check the message matches what the framework logs this as.

From 216c68e6d018246a37870fa2ada898f7def2a080 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 10 May 2022 15:19:43 +0900
Subject: [PATCH 4719/5547] Add unobserved exception hinting

---
 osu.Game/Utils/SentryLogger.cs | 18 ++++++++++++++++--
 1 file changed, 16 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Utils/SentryLogger.cs b/osu.Game/Utils/SentryLogger.cs
index 170d8e7cb0..96affd85a7 100644
--- a/osu.Game/Utils/SentryLogger.cs
+++ b/osu.Game/Utils/SentryLogger.cs
@@ -71,8 +71,22 @@ namespace osu.Game.Utils
                 // but all unhandled exceptions still arrive via this pathway. we just need to mark them as unhandled for tagging purposes.
                 // easiest solution is to check the message matches what the framework logs this as.
                 // see https://github.com/ppy/osu-framework/blob/f932f8df053f0011d755c95ad9a2ed61b94d136b/osu.Framework/Platform/GameHost.cs#L336
-                bool wasHandled = entry.Message != @"An unhandled exception has occurred.";
-                exception.Data[Mechanism.HandledKey] = wasHandled;
+                bool wasUnhandled = entry.Message == @"An unhandled error has occurred.";
+                bool wasUnobserved = entry.Message == @"An unobserved error has occurred.";
+
+                if (wasUnobserved)
+                {
+                    // see https://github.com/getsentry/sentry-dotnet/blob/c6a660b1affc894441c63df2695a995701671744/src/Sentry/Integrations/TaskUnobservedTaskExceptionIntegration.cs#L39
+                    exception.Data[Mechanism.MechanismKey] = @"UnobservedTaskException";
+                }
+
+                if (wasUnhandled)
+                {
+                    // see https://github.com/getsentry/sentry-dotnet/blob/main/src/Sentry/Integrations/AppDomainUnhandledExceptionIntegration.cs#L38-L39
+                    exception.Data[Mechanism.MechanismKey] = @"AppDomain.UnhandledException";
+                }
+
+                exception.Data[Mechanism.HandledKey] = !wasUnhandled;
 
                 SentrySdk.CaptureEvent(new SentryEvent(exception)
                 {

From 6a49eb68759d89e4d001866a7ae4fcbb7addc8d5 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 10 May 2022 16:14:04 +0900
Subject: [PATCH 4720/5547] Add breadcrumb level mappings

---
 osu.Game/Utils/SentryLogger.cs | 25 +++++++++++++++++++++++--
 1 file changed, 23 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Utils/SentryLogger.cs b/osu.Game/Utils/SentryLogger.cs
index 96affd85a7..ad4bcf6274 100644
--- a/osu.Game/Utils/SentryLogger.cs
+++ b/osu.Game/Utils/SentryLogger.cs
@@ -95,10 +95,31 @@ namespace osu.Game.Utils
                 });
             }
             else
-                SentrySdk.AddBreadcrumb(entry.Message, entry.Target.ToString(), "navigation");
+                SentrySdk.AddBreadcrumb(entry.Message, entry.Target.ToString(), "navigation", level: getBreadcrumbLevel(entry.Level));
         }
 
-        private SentryLevel? getSentryLevel(LogLevel entryLevel)
+        private BreadcrumbLevel getBreadcrumbLevel(LogLevel entryLevel)
+        {
+            switch (entryLevel)
+            {
+                case LogLevel.Debug:
+                    return BreadcrumbLevel.Debug;
+
+                case LogLevel.Verbose:
+                    return BreadcrumbLevel.Info;
+
+                case LogLevel.Important:
+                    return BreadcrumbLevel.Warning;
+
+                case LogLevel.Error:
+                    return BreadcrumbLevel.Error;
+
+                default:
+                    throw new ArgumentOutOfRangeException(nameof(entryLevel), entryLevel, null);
+            }
+        }
+
+        private SentryLevel getSentryLevel(LogLevel entryLevel)
         {
             switch (entryLevel)
             {

From 14a21e92244030a6f1fa758237f9733776b0c6b7 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Tue, 10 May 2022 11:41:41 +0300
Subject: [PATCH 4721/5547] Workaround interface mocks in
 `TestSceneFirstRunSetupOverlay` breaking with hot reload

---
 .../TestSceneFirstRunSetupOverlay.cs          | 36 ++++++++++++++++---
 1 file changed, 32 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunSetupOverlay.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunSetupOverlay.cs
index 39298f56ba..905f53c165 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunSetupOverlay.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunSetupOverlay.cs
@@ -4,9 +4,11 @@
 using System;
 using System.Collections.Generic;
 using System.Linq;
+using JetBrains.Annotations;
 using Moq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
+using osu.Framework.Bindables;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Screens;
 using osu.Framework.Testing;
@@ -25,9 +27,9 @@ namespace osu.Game.Tests.Visual.UserInterface
     {
         private FirstRunSetupOverlay overlay;
 
-        private readonly Mock<IPerformFromScreenRunner> performer = new Mock<IPerformFromScreenRunner>();
+        private readonly Mock<TestPerformerFromScreenRunner> performer = new Mock<TestPerformerFromScreenRunner>();
 
-        private readonly Mock<INotificationOverlay> notificationOverlay = new Mock<INotificationOverlay>();
+        private readonly Mock<TestNotificationOverlay> notificationOverlay = new Mock<TestNotificationOverlay>();
 
         private Notification lastNotification;
 
@@ -37,8 +39,8 @@ namespace osu.Game.Tests.Visual.UserInterface
         private void load()
         {
             Dependencies.Cache(LocalConfig = new OsuConfigManager(LocalStorage));
-            Dependencies.CacheAs(performer.Object);
-            Dependencies.CacheAs(notificationOverlay.Object);
+            Dependencies.CacheAs<IPerformFromScreenRunner>(performer.Object);
+            Dependencies.CacheAs<INotificationOverlay>(notificationOverlay.Object);
         }
 
         [SetUpSteps]
@@ -196,5 +198,31 @@ namespace osu.Game.Tests.Visual.UserInterface
             AddAssert("overlay shown", () => overlay.State.Value == Visibility.Visible);
             AddAssert("is resumed", () => overlay.CurrentScreen is ScreenBeatmaps);
         }
+
+        // interface mocks break hot reload, mocking this stub implementation instead works around it.
+        // see: https://github.com/moq/moq4/issues/1252
+        [UsedImplicitly]
+        public class TestNotificationOverlay : INotificationOverlay
+        {
+            public virtual void Post(Notification notification)
+            {
+            }
+
+            public virtual void Hide()
+            {
+            }
+
+            public virtual IBindable<int> UnreadCount => null;
+        }
+
+        // interface mocks break hot reload, mocking this stub implementation instead works around it.
+        // see: https://github.com/moq/moq4/issues/1252
+        [UsedImplicitly]
+        public class TestPerformerFromScreenRunner : IPerformFromScreenRunner
+        {
+            public virtual void PerformFromScreen(Action<IScreen> action, IEnumerable<Type> validScreens = null)
+            {
+            }
+        }
     }
 }

From 9aadc274bfe5578d2dabe2388ee9f3af4928addd Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 10 May 2022 16:43:38 +0900
Subject: [PATCH 4722/5547] Show first run dialog on first run of the game

---
 .../Visual/UserInterface/TestSceneFirstRunSetupOverlay.cs   | 1 -
 osu.Game/Overlays/FirstRunSetupOverlay.cs                   | 6 ++----
 2 files changed, 2 insertions(+), 5 deletions(-)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunSetupOverlay.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunSetupOverlay.cs
index 905f53c165..48b5690243 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunSetupOverlay.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunSetupOverlay.cs
@@ -74,7 +74,6 @@ namespace osu.Game.Tests.Visual.UserInterface
         }
 
         [Test]
-        [Ignore("Enable when first run setup is being displayed on first run.")]
         public void TestDoesntOpenOnSecondRun()
         {
             AddStep("set first run", () => LocalConfig.SetValue(OsuSetting.ShowFirstRunSetup, true));
diff --git a/osu.Game/Overlays/FirstRunSetupOverlay.cs b/osu.Game/Overlays/FirstRunSetupOverlay.cs
index 607bef76dd..df1e094114 100644
--- a/osu.Game/Overlays/FirstRunSetupOverlay.cs
+++ b/osu.Game/Overlays/FirstRunSetupOverlay.cs
@@ -171,8 +171,7 @@ namespace osu.Game.Overlays
 
             config.BindWith(OsuSetting.ShowFirstRunSetup, showFirstRunSetup);
 
-            // TODO: uncomment when happy with the whole flow.
-            // if (showFirstRunSetup.Value) Show();
+            if (showFirstRunSetup.Value) Show();
         }
 
         public override bool OnPressed(KeyBindingPressEvent<GlobalAction> e)
@@ -304,8 +303,7 @@ namespace osu.Game.Overlays
             }
             else
             {
-                // TODO: uncomment when happy with the whole flow.
-                // showFirstRunSetup.Value = false;
+                showFirstRunSetup.Value = false;
                 currentStepIndex = null;
                 Hide();
             }

From bcce9c5e6772911ff817216c4424ad0ff596e7a1 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 10 May 2022 17:01:36 +0900
Subject: [PATCH 4723/5547] Limit the width of first run overlay content

---
 osu.Game/Overlays/FirstRunSetupOverlay.cs | 71 ++++++++++++++---------
 1 file changed, 43 insertions(+), 28 deletions(-)

diff --git a/osu.Game/Overlays/FirstRunSetupOverlay.cs b/osu.Game/Overlays/FirstRunSetupOverlay.cs
index df1e094114..befa80e839 100644
--- a/osu.Game/Overlays/FirstRunSetupOverlay.cs
+++ b/osu.Game/Overlays/FirstRunSetupOverlay.cs
@@ -62,7 +62,7 @@ namespace osu.Game.Overlays
             typeof(ScreenBehaviour),
         };
 
-        private Container stackContainer = null!;
+        private Container screenContent = null!;
 
         private Bindable<OverlayActivation>? overlayActivationMode;
 
@@ -86,36 +86,51 @@ namespace osu.Game.Overlays
                     Anchor = Anchor.Centre,
                     Origin = Anchor.Centre,
                     RelativeSizeAxes = Axes.Both,
-                    Padding = new MarginPadding
+                    Padding = new MarginPadding { Bottom = 20, },
+                    Child = new GridContainer()
                     {
-                        Horizontal = 70 * 1.2f,
-                        Bottom = 20,
-                    },
-                    Child = new InputBlockingContainer
-                    {
-                        Masking = true,
-                        CornerRadius = 14,
+                        Anchor = Anchor.Centre,
+                        Origin = Anchor.Centre,
                         RelativeSizeAxes = Axes.Both,
-                        Children = new Drawable[]
+                        ColumnDimensions = new[]
                         {
-                            new Box
-                            {
-                                RelativeSizeAxes = Axes.Both,
-                                Colour = ColourProvider.Background6,
-                            },
-                            stackContainer = new Container
-                            {
-                                Anchor = Anchor.Centre,
-                                Origin = Anchor.Centre,
-                                RelativeSizeAxes = Axes.Both,
-                                Padding = new MarginPadding
-                                {
-                                    Vertical = 20,
-                                    Horizontal = 70,
-                                },
-                            }
+                            new Dimension(),
+                            new Dimension(minSize: 640, maxSize: 800),
+                            new Dimension(),
                         },
-                    },
+                        Content = new[]
+                        {
+                            new[]
+                            {
+                                Empty(),
+                                new InputBlockingContainer
+                                {
+                                    Masking = true,
+                                    CornerRadius = 14,
+                                    RelativeSizeAxes = Axes.Both,
+                                    Children = new Drawable[]
+                                    {
+                                        new Box
+                                        {
+                                            RelativeSizeAxes = Axes.Both,
+                                            Colour = ColourProvider.Background6,
+                                        },
+                                        new Container
+                                        {
+                                            RelativeSizeAxes = Axes.Both,
+                                            Padding = new MarginPadding
+                                            {
+                                                Vertical = 20,
+                                                Horizontal = 20,
+                                            },
+                                            Child = screenContent = new Container { RelativeSizeAxes = Axes.Both, },
+                                        },
+                                    },
+                                },
+                                Empty(),
+                            },
+                        }
+                    }
                 },
             });
 
@@ -268,7 +283,7 @@ namespace osu.Game.Overlays
         {
             Debug.Assert(currentStepIndex == null);
 
-            stackContainer.Child = stack = new ScreenStack
+            screenContent.Child = stack = new ScreenStack
             {
                 RelativeSizeAxes = Axes.Both,
             };

From e5204e565dae9946543ca23c72119be7f26e0540 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 10 May 2022 17:23:12 +0900
Subject: [PATCH 4724/5547] Move horizontal padding to content level to better
 align scrollbar

---
 .../FirstRunSetup/FirstRunSetupScreen.cs      | 34 +++++++++++--------
 osu.Game/Overlays/FirstRunSetupOverlay.cs     |  6 +---
 2 files changed, 21 insertions(+), 19 deletions(-)

diff --git a/osu.Game/Overlays/FirstRunSetup/FirstRunSetupScreen.cs b/osu.Game/Overlays/FirstRunSetup/FirstRunSetupScreen.cs
index 1f18d181cb..2990948199 100644
--- a/osu.Game/Overlays/FirstRunSetup/FirstRunSetupScreen.cs
+++ b/osu.Game/Overlays/FirstRunSetup/FirstRunSetupScreen.cs
@@ -33,23 +33,29 @@ namespace osu.Game.Overlays.FirstRunSetup
                 new OsuScrollContainer(Direction.Vertical)
                 {
                     RelativeSizeAxes = Axes.Both,
-                    ScrollbarOverlapsContent = false,
-                    Children = new Drawable[]
+                    Masking = false,
+                    Child = new Container
                     {
-                        new OsuSpriteText
+                        RelativeSizeAxes = Axes.X,
+                        AutoSizeAxes = Axes.Y,
+                        Padding = new MarginPadding { Horizontal = 30 },
+                        Children = new Drawable[]
                         {
-                            Text = this.GetLocalisableDescription(),
-                            Font = OsuFont.Default.With(size: header_size),
-                            Colour = OverlayColourProvider.Light1,
+                            new OsuSpriteText
+                            {
+                                Text = this.GetLocalisableDescription(),
+                                Font = OsuFont.Default.With(size: header_size),
+                                Colour = OverlayColourProvider.Light1,
+                            },
+                            Content = new FillFlowContainer
+                            {
+                                Y = header_size + spacing,
+                                Spacing = new Vector2(spacing),
+                                RelativeSizeAxes = Axes.X,
+                                AutoSizeAxes = Axes.Y,
+                                Direction = FillDirection.Vertical,
+                            }
                         },
-                        Content = new FillFlowContainer
-                        {
-                            Y = header_size + spacing,
-                            Spacing = new Vector2(spacing),
-                            RelativeSizeAxes = Axes.X,
-                            AutoSizeAxes = Axes.Y,
-                            Direction = FillDirection.Vertical,
-                        }
                     },
                 }
             };
diff --git a/osu.Game/Overlays/FirstRunSetupOverlay.cs b/osu.Game/Overlays/FirstRunSetupOverlay.cs
index befa80e839..19a4c09473 100644
--- a/osu.Game/Overlays/FirstRunSetupOverlay.cs
+++ b/osu.Game/Overlays/FirstRunSetupOverlay.cs
@@ -118,11 +118,7 @@ namespace osu.Game.Overlays
                                         new Container
                                         {
                                             RelativeSizeAxes = Axes.Both,
-                                            Padding = new MarginPadding
-                                            {
-                                                Vertical = 20,
-                                                Horizontal = 20,
-                                            },
+                                            Padding = new MarginPadding { Vertical = 20 },
                                             Child = screenContent = new Container { RelativeSizeAxes = Axes.Both, },
                                         },
                                     },

From 61313b69ecd40049dbc13b502e21a0e4cbeb312d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 10 May 2022 17:33:37 +0900
Subject: [PATCH 4725/5547] Standardise font sizes in first run overlay screens

---
 .../Overlays/FirstRunSetup/FirstRunSetupScreen.cs  |  9 ++++++---
 osu.Game/Overlays/FirstRunSetup/ScreenBeatmaps.cs  | 14 +++++++-------
 osu.Game/Overlays/FirstRunSetup/ScreenBehaviour.cs |  2 +-
 osu.Game/Overlays/FirstRunSetup/ScreenUIScale.cs   |  2 +-
 osu.Game/Overlays/FirstRunSetup/ScreenWelcome.cs   |  2 +-
 5 files changed, 16 insertions(+), 13 deletions(-)

diff --git a/osu.Game/Overlays/FirstRunSetup/FirstRunSetupScreen.cs b/osu.Game/Overlays/FirstRunSetup/FirstRunSetupScreen.cs
index 2990948199..2cfa7cd164 100644
--- a/osu.Game/Overlays/FirstRunSetup/FirstRunSetupScreen.cs
+++ b/osu.Game/Overlays/FirstRunSetup/FirstRunSetupScreen.cs
@@ -19,13 +19,16 @@ namespace osu.Game.Overlays.FirstRunSetup
 
         protected FillFlowContainer Content { get; private set; }
 
+        protected const float CONTENT_FONT_SIZE = 16;
+
+        protected const float HEADER_FONT_SIZE = 24;
+
         [Resolved]
         protected OverlayColourProvider OverlayColourProvider { get; private set; }
 
         [BackgroundDependencyLoader]
         private void load()
         {
-            const float header_size = 40;
             const float spacing = 20;
 
             InternalChildren = new Drawable[]
@@ -44,12 +47,12 @@ namespace osu.Game.Overlays.FirstRunSetup
                             new OsuSpriteText
                             {
                                 Text = this.GetLocalisableDescription(),
-                                Font = OsuFont.Default.With(size: header_size),
+                                Font = OsuFont.TorusAlternate.With(size: HEADER_FONT_SIZE),
                                 Colour = OverlayColourProvider.Light1,
                             },
                             Content = new FillFlowContainer
                             {
-                                Y = header_size + spacing,
+                                Y = HEADER_FONT_SIZE + spacing,
                                 Spacing = new Vector2(spacing),
                                 RelativeSizeAxes = Axes.X,
                                 AutoSizeAxes = Axes.Y,
diff --git a/osu.Game/Overlays/FirstRunSetup/ScreenBeatmaps.cs b/osu.Game/Overlays/FirstRunSetup/ScreenBeatmaps.cs
index 190a0badab..66acdca8c7 100644
--- a/osu.Game/Overlays/FirstRunSetup/ScreenBeatmaps.cs
+++ b/osu.Game/Overlays/FirstRunSetup/ScreenBeatmaps.cs
@@ -46,11 +46,11 @@ namespace osu.Game.Overlays.FirstRunSetup
         [BackgroundDependencyLoader(permitNulls: true)]
         private void load(LegacyImportManager? legacyImportManager)
         {
-            Vector2 buttonSize = new Vector2(500, 60);
+            Vector2 buttonSize = new Vector2(400, 50);
 
             Content.Children = new Drawable[]
             {
-                new OsuTextFlowContainer(cp => cp.Font = OsuFont.Default.With(size: 20))
+                new OsuTextFlowContainer(cp => cp.Font = OsuFont.Default.With(size: CONTENT_FONT_SIZE))
                 {
                     Colour = OverlayColourProvider.Content1,
                     Text = FirstRunSetupBeatmapScreenStrings.Description,
@@ -63,7 +63,7 @@ namespace osu.Game.Overlays.FirstRunSetup
                     Height = 30,
                     Children = new Drawable[]
                     {
-                        currentlyLoadedBeatmaps = new OsuTextFlowContainer(cp => cp.Font = OsuFont.Default.With(size: 24, weight: FontWeight.SemiBold))
+                        currentlyLoadedBeatmaps = new OsuTextFlowContainer(cp => cp.Font = OsuFont.Default.With(size: HEADER_FONT_SIZE, weight: FontWeight.SemiBold))
                         {
                             Colour = OverlayColourProvider.Content2,
                             TextAnchor = Anchor.Centre,
@@ -73,7 +73,7 @@ namespace osu.Game.Overlays.FirstRunSetup
                         },
                     }
                 },
-                new OsuTextFlowContainer(cp => cp.Font = OsuFont.Default.With(size: 20))
+                new OsuTextFlowContainer(cp => cp.Font = OsuFont.Default.With(size: CONTENT_FONT_SIZE))
                 {
                     Colour = OverlayColourProvider.Content1,
                     Text = FirstRunSetupBeatmapScreenStrings.TutorialDescription,
@@ -89,7 +89,7 @@ namespace osu.Game.Overlays.FirstRunSetup
                     Text = FirstRunSetupBeatmapScreenStrings.TutorialButton,
                     Action = downloadTutorial
                 },
-                new OsuTextFlowContainer(cp => cp.Font = OsuFont.Default.With(size: 20))
+                new OsuTextFlowContainer(cp => cp.Font = OsuFont.Default.With(size: CONTENT_FONT_SIZE))
                 {
                     Colour = OverlayColourProvider.Content1,
                     Text = FirstRunSetupBeatmapScreenStrings.BundledDescription,
@@ -105,7 +105,7 @@ namespace osu.Game.Overlays.FirstRunSetup
                     Text = FirstRunSetupBeatmapScreenStrings.BundledButton,
                     Action = downloadBundled
                 },
-                new OsuTextFlowContainer(cp => cp.Font = OsuFont.Default.With(size: 20))
+                new OsuTextFlowContainer(cp => cp.Font = OsuFont.Default.With(size: CONTENT_FONT_SIZE))
                 {
                     Colour = OverlayColourProvider.Content1,
                     Text = "If you have an existing osu! install, you can also choose to import your existing beatmap collection.",
@@ -131,7 +131,7 @@ namespace osu.Game.Overlays.FirstRunSetup
                         }));
                     }
                 },
-                new OsuTextFlowContainer(cp => cp.Font = OsuFont.Default.With(size: 20))
+                new OsuTextFlowContainer(cp => cp.Font = OsuFont.Default.With(size: CONTENT_FONT_SIZE))
                 {
                     Colour = OverlayColourProvider.Content1,
                     Text = FirstRunSetupBeatmapScreenStrings.ObtainMoreBeatmaps,
diff --git a/osu.Game/Overlays/FirstRunSetup/ScreenBehaviour.cs b/osu.Game/Overlays/FirstRunSetup/ScreenBehaviour.cs
index dc3d40ad95..9d426bd3fa 100644
--- a/osu.Game/Overlays/FirstRunSetup/ScreenBehaviour.cs
+++ b/osu.Game/Overlays/FirstRunSetup/ScreenBehaviour.cs
@@ -26,7 +26,7 @@ namespace osu.Game.Overlays.FirstRunSetup
         {
             Content.Children = new Drawable[]
             {
-                new OsuTextFlowContainer(cp => cp.Font = OsuFont.Default.With(size: 24))
+                new OsuTextFlowContainer(cp => cp.Font = OsuFont.Default.With(size: CONTENT_FONT_SIZE))
                 {
                     Text = FirstRunSetupOverlayStrings.BehaviourDescription,
                     RelativeSizeAxes = Axes.X,
diff --git a/osu.Game/Overlays/FirstRunSetup/ScreenUIScale.cs b/osu.Game/Overlays/FirstRunSetup/ScreenUIScale.cs
index 152d67ab27..24e113e6a9 100644
--- a/osu.Game/Overlays/FirstRunSetup/ScreenUIScale.cs
+++ b/osu.Game/Overlays/FirstRunSetup/ScreenUIScale.cs
@@ -37,7 +37,7 @@ namespace osu.Game.Overlays.FirstRunSetup
         {
             Content.Children = new Drawable[]
             {
-                new OsuTextFlowContainer(cp => cp.Font = OsuFont.Default.With(size: 24))
+                new OsuTextFlowContainer(cp => cp.Font = OsuFont.Default.With(size: CONTENT_FONT_SIZE))
                 {
                     Text = FirstRunSetupOverlayStrings.UIScaleDescription,
                     RelativeSizeAxes = Axes.X,
diff --git a/osu.Game/Overlays/FirstRunSetup/ScreenWelcome.cs b/osu.Game/Overlays/FirstRunSetup/ScreenWelcome.cs
index 10e15a7555..420d630857 100644
--- a/osu.Game/Overlays/FirstRunSetup/ScreenWelcome.cs
+++ b/osu.Game/Overlays/FirstRunSetup/ScreenWelcome.cs
@@ -18,7 +18,7 @@ namespace osu.Game.Overlays.FirstRunSetup
         {
             Content.Children = new Drawable[]
             {
-                new OsuTextFlowContainer(cp => cp.Font = OsuFont.Default.With(size: 20))
+                new OsuTextFlowContainer(cp => cp.Font = OsuFont.Default.With(size: CONTENT_FONT_SIZE))
                 {
                     Text = FirstRunSetupOverlayStrings.WelcomeDescription,
                     RelativeSizeAxes = Axes.X,

From 63b9e01d384eb8fda2c5439ab98807b1be7244e5 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 10 May 2022 17:35:43 +0900
Subject: [PATCH 4726/5547] Fix behaviour screen using old style buttons

---
 osu.Game/Overlays/FirstRunSetup/ScreenBehaviour.cs | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Overlays/FirstRunSetup/ScreenBehaviour.cs b/osu.Game/Overlays/FirstRunSetup/ScreenBehaviour.cs
index 9d426bd3fa..1a88e6a842 100644
--- a/osu.Game/Overlays/FirstRunSetup/ScreenBehaviour.cs
+++ b/osu.Game/Overlays/FirstRunSetup/ScreenBehaviour.cs
@@ -9,7 +9,7 @@ using osu.Framework.Localisation;
 using osu.Framework.Testing;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
-using osu.Game.Graphics.UserInterface;
+using osu.Game.Graphics.UserInterfaceV2;
 using osu.Game.Localisation;
 using osu.Game.Overlays.Settings;
 using osu.Game.Overlays.Settings.Sections;
@@ -22,7 +22,7 @@ namespace osu.Game.Overlays.FirstRunSetup
         private SearchContainer<SettingsSection> searchContainer;
 
         [BackgroundDependencyLoader]
-        private void load()
+        private void load(OsuColour colours)
         {
             Content.Children = new Drawable[]
             {
@@ -50,7 +50,7 @@ namespace osu.Game.Overlays.FirstRunSetup
                     {
                         new[]
                         {
-                            new TriangleButton
+                            new RoundedButton
                             {
                                 Anchor = Anchor.TopLeft,
                                 Origin = Anchor.TopLeft,
@@ -59,10 +59,11 @@ namespace osu.Game.Overlays.FirstRunSetup
                                 Action = applyStandard,
                             },
                             Empty(),
-                            new DangerousTriangleButton
+                            new RoundedButton
                             {
                                 Anchor = Anchor.TopRight,
                                 Origin = Anchor.TopRight,
+                                BackgroundColour = colours.Pink3,
                                 Text = FirstRunSetupOverlayStrings.ClassicDefaults,
                                 RelativeSizeAxes = Axes.X,
                                 Action = applyClassic

From 493798ae5e5e4ba61e5654b2623eab4a249af750 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 10 May 2022 17:44:23 +0900
Subject: [PATCH 4727/5547] Fix nested ui scale example screens no longer
 fitting

---
 osu.Game/Overlays/FirstRunSetup/ScreenUIScale.cs | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/FirstRunSetup/ScreenUIScale.cs b/osu.Game/Overlays/FirstRunSetup/ScreenUIScale.cs
index 24e113e6a9..4a44a6d391 100644
--- a/osu.Game/Overlays/FirstRunSetup/ScreenUIScale.cs
+++ b/osu.Game/Overlays/FirstRunSetup/ScreenUIScale.cs
@@ -35,6 +35,8 @@ namespace osu.Game.Overlays.FirstRunSetup
         [BackgroundDependencyLoader]
         private void load(OsuConfigManager config)
         {
+            const float screen_width = 640;
+
             Content.Children = new Drawable[]
             {
                 new OsuTextFlowContainer(cp => cp.Font = OsuFont.Default.With(size: CONTENT_FONT_SIZE))
@@ -54,7 +56,7 @@ namespace osu.Game.Overlays.FirstRunSetup
                     Anchor = Anchor.TopCentre,
                     Origin = Anchor.TopCentre,
                     RelativeSizeAxes = Axes.None,
-                    Size = new Vector2(960, 960 / 16f * 9 / 2),
+                    Size = new Vector2(screen_width, screen_width / 16f * 9 / 2),
                     Children = new Drawable[]
                     {
                         new GridContainer

From 25c6226ca9cb7c82ef9a66e4c12f45f13ec7e732 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 10 May 2022 17:47:04 +0900
Subject: [PATCH 4728/5547] Adjust transition length for a more seamless screen
 change

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

diff --git a/osu.Game/Overlays/FirstRunSetup/FirstRunSetupScreen.cs b/osu.Game/Overlays/FirstRunSetup/FirstRunSetupScreen.cs
index 2cfa7cd164..d1ea91e51a 100644
--- a/osu.Game/Overlays/FirstRunSetup/FirstRunSetupScreen.cs
+++ b/osu.Game/Overlays/FirstRunSetup/FirstRunSetupScreen.cs
@@ -68,7 +68,7 @@ namespace osu.Game.Overlays.FirstRunSetup
         {
             base.OnEntering(e);
             this
-                .FadeInFromZero(500)
+                .FadeInFromZero(100)
                 .MoveToX(offset)
                 .MoveToX(0, 500, Easing.OutQuint);
         }
@@ -77,7 +77,7 @@ namespace osu.Game.Overlays.FirstRunSetup
         {
             base.OnResuming(e);
             this
-                .FadeInFromZero(500)
+                .FadeInFromZero(100)
                 .MoveToX(0, 500, Easing.OutQuint);
         }
 

From a93c63b2b5b7d0119b3fb5ee97bee8232d593854 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 10 May 2022 18:04:10 +0900
Subject: [PATCH 4729/5547] Add loading spinner when loading first run screens

---
 osu.Game/Overlays/FirstRunSetupOverlay.cs | 16 +++++++++++++++-
 1 file changed, 15 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/FirstRunSetupOverlay.cs b/osu.Game/Overlays/FirstRunSetupOverlay.cs
index 19a4c09473..c0eed14c99 100644
--- a/osu.Game/Overlays/FirstRunSetupOverlay.cs
+++ b/osu.Game/Overlays/FirstRunSetupOverlay.cs
@@ -15,6 +15,7 @@ using osu.Framework.Graphics.Sprites;
 using osu.Framework.Input.Events;
 using osu.Framework.Localisation;
 using osu.Framework.Screens;
+using osu.Framework.Threading;
 using osu.Game.Configuration;
 using osu.Game.Graphics;
 using osu.Game.Graphics.UserInterface;
@@ -68,6 +69,9 @@ namespace osu.Game.Overlays
 
         private Container content = null!;
 
+        private LoadingSpinner loading = null!;
+        private ScheduledDelegate? loadingShowDelegate;
+
         public FirstRunSetupOverlay()
             : base(OverlayColourScheme.Purple)
         {
@@ -115,6 +119,7 @@ namespace osu.Game.Overlays
                                             RelativeSizeAxes = Axes.Both,
                                             Colour = ColourProvider.Background6,
                                         },
+                                        loading = new LoadingSpinner(),
                                         new Container
                                         {
                                             RelativeSizeAxes = Axes.Both,
@@ -310,7 +315,16 @@ namespace osu.Game.Overlays
 
             if (currentStepIndex < steps.Length)
             {
-                stack.Push((Screen)Activator.CreateInstance(steps[currentStepIndex.Value]));
+                var nextScreen = (Screen)Activator.CreateInstance(steps[currentStepIndex.Value]);
+
+                loadingShowDelegate = Scheduler.AddDelayed(() => loading.Show(), 200);
+                nextScreen.OnLoadComplete += _ =>
+                {
+                    loadingShowDelegate?.Cancel();
+                    loading.Hide();
+                };
+
+                stack.Push(nextScreen);
             }
             else
             {

From a578f7a406a049f8548af177b630c89a6ba32c8a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 10 May 2022 18:08:17 +0900
Subject: [PATCH 4730/5547] Force nested screens to load synchronously

---
 osu.Game/Overlays/FirstRunSetup/ScreenUIScale.cs | 15 +++++++++------
 osu.Game/Screens/OsuScreenStack.cs               |  7 +++++++
 2 files changed, 16 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Overlays/FirstRunSetup/ScreenUIScale.cs b/osu.Game/Overlays/FirstRunSetup/ScreenUIScale.cs
index 4a44a6d391..8452691bb5 100644
--- a/osu.Game/Overlays/FirstRunSetup/ScreenUIScale.cs
+++ b/osu.Game/Overlays/FirstRunSetup/ScreenUIScale.cs
@@ -125,6 +125,7 @@ namespace osu.Game.Overlays.FirstRunSetup
 
         private class SampleScreenContainer : CompositeDrawable
         {
+            private readonly OsuScreen screen;
             // Minimal isolation from main game.
 
             [Cached]
@@ -144,6 +145,12 @@ namespace osu.Game.Overlays.FirstRunSetup
             public override bool PropagatePositionalInputSubTree => false;
             public override bool PropagateNonPositionalInputSubTree => false;
 
+            public SampleScreenContainer(OsuScreen screen)
+            {
+                this.screen = screen;
+                RelativeSizeAxes = Axes.Both;
+            }
+
             [BackgroundDependencyLoader]
             private void load(AudioManager audio, TextureStore textures, RulesetStore rulesets)
             {
@@ -151,13 +158,8 @@ namespace osu.Game.Overlays.FirstRunSetup
                 Beatmap.Value.LoadTrack();
 
                 Ruleset.Value = rulesets.AvailableRulesets.First();
-            }
 
-            public SampleScreenContainer(Screen screen)
-            {
                 OsuScreenStack stack;
-                RelativeSizeAxes = Axes.Both;
-
                 OsuLogo logo;
 
                 Padding = new MarginPadding(5);
@@ -191,7 +193,8 @@ namespace osu.Game.Overlays.FirstRunSetup
                     },
                 };
 
-                stack.Push(screen);
+                // intentionally load synchronously so it is included in the initial load of the first run screen.
+                stack.PushSynchronously(screen);
             }
         }
     }
diff --git a/osu.Game/Screens/OsuScreenStack.cs b/osu.Game/Screens/OsuScreenStack.cs
index ebbcbd7650..18b16ba865 100644
--- a/osu.Game/Screens/OsuScreenStack.cs
+++ b/osu.Game/Screens/OsuScreenStack.cs
@@ -29,6 +29,13 @@ namespace osu.Game.Screens
             ScreenExited += ScreenChanged;
         }
 
+        public void PushSynchronously(OsuScreen screen)
+        {
+            LoadComponent(screen);
+
+            Push(screen);
+        }
+
         private void screenPushed(IScreen prev, IScreen next)
         {
             if (LoadState < LoadState.Ready)

From cac6d5569c8dbd1282330ffadf5a2d20bb0d0cb5 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 10 May 2022 19:07:00 +0900
Subject: [PATCH 4731/5547] Fix incorrect variable reference in log output

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

diff --git a/osu.Game/OsuGameBase.cs b/osu.Game/OsuGameBase.cs
index c5b69a3637..3a35bce05c 100644
--- a/osu.Game/OsuGameBase.cs
+++ b/osu.Game/OsuGameBase.cs
@@ -524,7 +524,7 @@ namespace osu.Game
         {
             bool continueExecution = Interlocked.Decrement(ref allowableExceptions) >= 0;
 
-            Logger.Log($"Unhandled exception has been {(continueExecution ? $"allowed with {SoftHandledExceptions} more allowable exceptions" : "denied")} .");
+            Logger.Log($"Unhandled exception has been {(continueExecution ? $"allowed with {allowableExceptions} more allowable exceptions" : "denied")} .");
 
             // restore the stock of allowable exceptions after a short delay.
             Task.Delay(1000).ContinueWith(_ => Interlocked.Increment(ref allowableExceptions));

From 4d22f262667972c4bf20cf1c117d8a7e1e5f2f45 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 10 May 2022 19:07:07 +0900
Subject: [PATCH 4732/5547] Rename property and improve xmldoc

---
 osu.Game.Tournament/TournamentGame.cs |  2 +-
 osu.Game/OsuGame.cs                   |  2 +-
 osu.Game/OsuGameBase.cs               | 11 ++++++++---
 3 files changed, 10 insertions(+), 5 deletions(-)

diff --git a/osu.Game.Tournament/TournamentGame.cs b/osu.Game.Tournament/TournamentGame.cs
index d9db0e6d20..042e660122 100644
--- a/osu.Game.Tournament/TournamentGame.cs
+++ b/osu.Game.Tournament/TournamentGame.cs
@@ -40,7 +40,7 @@ namespace osu.Game.Tournament
         private Bindable<WindowMode> windowMode;
         private LoadingSpinner loadingSpinner;
 
-        protected override int SoftHandledExceptions => DebugUtils.IsDebugBuild ? 0 : 1;
+        protected override int ExceptionsBeforeCrash => DebugUtils.IsDebugBuild ? 0 : 1;
 
         [BackgroundDependencyLoader]
         private void load(FrameworkConfigManager frameworkConfig, GameHost host)
diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index 6961dce910..0cfb3c2de8 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -176,7 +176,7 @@ namespace osu.Game
 
         private readonly List<OverlayContainer> visibleBlockingOverlays = new List<OverlayContainer>();
 
-        protected override int SoftHandledExceptions => DebugUtils.IsDebugBuild ? 0 : 1;
+        protected override int ExceptionsBeforeCrash => DebugUtils.IsDebugBuild ? 0 : 1;
 
         public OsuGame(string[] args = null)
         {
diff --git a/osu.Game/OsuGameBase.cs b/osu.Game/OsuGameBase.cs
index 3a35bce05c..b17526114a 100644
--- a/osu.Game/OsuGameBase.cs
+++ b/osu.Game/OsuGameBase.cs
@@ -182,15 +182,20 @@ namespace osu.Game
         protected DatabaseContextFactory EFContextFactory { get; private set; }
 
         /// <summary>
-        /// Number of exceptions to allow before aborting execution.
+        /// Number of unhandled exceptions to allow before aborting execution.
         /// </summary>
-        protected virtual int SoftHandledExceptions => 0;
+        /// <remarks>
+        /// When an unhandled exception is encountered, an internal count will be decremented.
+        /// If the count hits zero, the game will crash.
+        /// Each second, the count is incremented until reaching the value specified.
+        /// </remarks>
+        protected virtual int ExceptionsBeforeCrash => 0;
 
         public OsuGameBase()
         {
             Name = @"osu!";
 
-            allowableExceptions = SoftHandledExceptions;
+            allowableExceptions = ExceptionsBeforeCrash;
         }
 
         [BackgroundDependencyLoader]

From b2a57c34bbea091d2e172c03a05c9481e9312bc7 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 10 May 2022 19:10:34 +0900
Subject: [PATCH 4733/5547] Move implementation to base

---
 osu.Game.Tournament/TournamentGame.cs | 3 ---
 osu.Game/OsuGame.cs                   | 3 ---
 osu.Game/OsuGameBase.cs               | 4 ++--
 3 files changed, 2 insertions(+), 8 deletions(-)

diff --git a/osu.Game.Tournament/TournamentGame.cs b/osu.Game.Tournament/TournamentGame.cs
index 042e660122..7967f54b49 100644
--- a/osu.Game.Tournament/TournamentGame.cs
+++ b/osu.Game.Tournament/TournamentGame.cs
@@ -6,7 +6,6 @@ using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Configuration;
-using osu.Framework.Development;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Colour;
@@ -40,8 +39,6 @@ namespace osu.Game.Tournament
         private Bindable<WindowMode> windowMode;
         private LoadingSpinner loadingSpinner;
 
-        protected override int ExceptionsBeforeCrash => DebugUtils.IsDebugBuild ? 0 : 1;
-
         [BackgroundDependencyLoader]
         private void load(FrameworkConfigManager frameworkConfig, GameHost host)
         {
diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index 0cfb3c2de8..54c4231b06 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -13,7 +13,6 @@ using osu.Framework.Allocation;
 using osu.Framework.Audio;
 using osu.Framework.Bindables;
 using osu.Framework.Configuration;
-using osu.Framework.Development;
 using osu.Framework.Extensions.IEnumerableExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
@@ -176,8 +175,6 @@ namespace osu.Game
 
         private readonly List<OverlayContainer> visibleBlockingOverlays = new List<OverlayContainer>();
 
-        protected override int ExceptionsBeforeCrash => DebugUtils.IsDebugBuild ? 0 : 1;
-
         public OsuGame(string[] args = null)
         {
             this.args = args;
diff --git a/osu.Game/OsuGameBase.cs b/osu.Game/OsuGameBase.cs
index b17526114a..ce798d4027 100644
--- a/osu.Game/OsuGameBase.cs
+++ b/osu.Game/OsuGameBase.cs
@@ -189,13 +189,13 @@ namespace osu.Game
         /// If the count hits zero, the game will crash.
         /// Each second, the count is incremented until reaching the value specified.
         /// </remarks>
-        protected virtual int ExceptionsBeforeCrash => 0;
+        protected virtual int UnhandledExceptionsBeforeCrash => DebugUtils.IsDebugBuild ? 0 : 1;
 
         public OsuGameBase()
         {
             Name = @"osu!";
 
-            allowableExceptions = ExceptionsBeforeCrash;
+            allowableExceptions = UnhandledExceptionsBeforeCrash;
         }
 
         [BackgroundDependencyLoader]

From 42fe7082250654233c6c78074a61cfbfec0866fb Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 10 May 2022 19:56:21 +0900
Subject: [PATCH 4734/5547] Fix inspection

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

diff --git a/osu.Game/Overlays/FirstRunSetupOverlay.cs b/osu.Game/Overlays/FirstRunSetupOverlay.cs
index c0eed14c99..cebb2f5e3b 100644
--- a/osu.Game/Overlays/FirstRunSetupOverlay.cs
+++ b/osu.Game/Overlays/FirstRunSetupOverlay.cs
@@ -91,7 +91,7 @@ namespace osu.Game.Overlays
                     Origin = Anchor.Centre,
                     RelativeSizeAxes = Axes.Both,
                     Padding = new MarginPadding { Bottom = 20, },
-                    Child = new GridContainer()
+                    Child = new GridContainer
                     {
                         Anchor = Anchor.Centre,
                         Origin = Anchor.Centre,

From 87f6f74795beb592dd50e5994f2f48bca590eac6 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 10 May 2022 21:03:55 +0900
Subject: [PATCH 4735/5547] Add failing test coverage of adding a file to a
 detached beatmap across threads

---
 .../Database/BeatmapImporterTests.cs          | 31 +++++++++++++++++++
 1 file changed, 31 insertions(+)

diff --git a/osu.Game.Tests/Database/BeatmapImporterTests.cs b/osu.Game.Tests/Database/BeatmapImporterTests.cs
index f9c13a8169..b7bfe14402 100644
--- a/osu.Game.Tests/Database/BeatmapImporterTests.cs
+++ b/osu.Game.Tests/Database/BeatmapImporterTests.cs
@@ -136,6 +136,37 @@ namespace osu.Game.Tests.Database
             });
         }
 
+        [Test]
+        public void TestAddFileToAsyncImportedBeatmap()
+        {
+            RunTestWithRealm((realm, storage) =>
+            {
+                BeatmapSetInfo? detachedSet = null;
+
+                using (var importer = new BeatmapModelManager(realm, storage))
+                using (new RealmRulesetStore(realm, storage))
+                {
+                    Task.Run(async () =>
+                    {
+                        Live<BeatmapSetInfo>? beatmapSet;
+
+                        using (var reader = new ZipArchiveReader(TestResources.GetTestBeatmapStream()))
+                            // ReSharper disable once AccessToDisposedClosure
+                            beatmapSet = await importer.Import(reader);
+
+                        Assert.NotNull(beatmapSet);
+                        Debug.Assert(beatmapSet != null);
+
+                        // Intentionally detach on async thread as to not trigger a refresh on the main thread.
+                        beatmapSet.PerformRead(s => detachedSet = s.Detach());
+                    }).WaitSafely();
+
+                    Debug.Assert(detachedSet != null);
+                    importer.AddFile(detachedSet, new MemoryStream(), "test");
+                }
+            });
+        }
+
         [Test]
         public void TestImportBeatmapThenCleanup()
         {

From 33f024212ffaaa1d70c38b20ff46e42b77fd8654 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 10 May 2022 20:47:26 +0900
Subject: [PATCH 4736/5547] Fix realm refetch operations potentially being
 unsafe

As seen in test failure https://github.com/ppy/osu/runs/6357384721?check_suite_focus=true.
---
 osu.Game/Database/RealmAccess.cs            | 20 +++++++++++++++++
 osu.Game/Stores/RealmArchiveModelManager.cs | 25 ++++++++++++++-------
 2 files changed, 37 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Database/RealmAccess.cs b/osu.Game/Database/RealmAccess.cs
index b0a70b51d0..937876a70e 100644
--- a/osu.Game/Database/RealmAccess.cs
+++ b/osu.Game/Database/RealmAccess.cs
@@ -344,6 +344,26 @@ namespace osu.Game.Database
             }
         }
 
+        /// <summary>
+        /// Write changes to realm.
+        /// </summary>
+        /// <param name="action">The work to run.</param>
+        public T Write<T>(Func<Realm, T> action)
+        {
+            if (ThreadSafety.IsUpdateThread)
+            {
+                total_writes_update.Value++;
+                return Realm.Write(action);
+            }
+            else
+            {
+                total_writes_async.Value++;
+
+                using (var realm = getRealmInstance())
+                    return realm.Write(action);
+            }
+        }
+
         /// <summary>
         /// Write changes to realm.
         /// </summary>
diff --git a/osu.Game/Stores/RealmArchiveModelManager.cs b/osu.Game/Stores/RealmArchiveModelManager.cs
index 57e51b79aa..e349efe5ad 100644
--- a/osu.Game/Stores/RealmArchiveModelManager.cs
+++ b/osu.Game/Stores/RealmArchiveModelManager.cs
@@ -45,11 +45,16 @@ namespace osu.Game.Stores
             // This method should be removed as soon as all the surrounding pieces support non-detached operations.
             if (!item.IsManaged)
             {
-                var managed = Realm.Realm.Find<TModel>(item.ID);
-                managed.Realm.Write(() => operation(managed));
+                // Importantly, begin the realm write *before* re-fetching, else the update realm may not be in a consistent state
+                // (ie. if an async import finished very recently).
+                Realm.Realm.Write(realm =>
+                {
+                    var managed = Realm.Realm.Find<TModel>(item.ID);
+                    operation(managed);
 
-                item.Files.Clear();
-                item.Files.AddRange(managed.Files.Detach());
+                    item.Files.Clear();
+                    item.Files.AddRange(managed.Files.Detach());
+                });
             }
             else
                 operation(item);
@@ -165,7 +170,9 @@ namespace osu.Game.Stores
 
         public bool Delete(TModel item)
         {
-            return Realm.Run(realm =>
+            // Importantly, begin the realm write *before* re-fetching, else the update realm may not be in a consistent state
+            // (ie. if an async import finished very recently).
+            return Realm.Write(realm =>
             {
                 if (!item.IsManaged)
                     item = realm.Find<TModel>(item.ID);
@@ -173,14 +180,16 @@ namespace osu.Game.Stores
                 if (item?.DeletePending != false)
                     return false;
 
-                realm.Write(r => item.DeletePending = true);
+                item.DeletePending = true;
                 return true;
             });
         }
 
         public void Undelete(TModel item)
         {
-            Realm.Run(realm =>
+            // Importantly, begin the realm write *before* re-fetching, else the update realm may not be in a consistent state
+            // (ie. if an async import finished very recently).
+            Realm.Write(realm =>
             {
                 if (!item.IsManaged)
                     item = realm.Find<TModel>(item.ID);
@@ -188,7 +197,7 @@ namespace osu.Game.Stores
                 if (item?.DeletePending != true)
                     return;
 
-                realm.Write(r => item.DeletePending = false);
+                item.DeletePending = false;
             });
         }
 

From 0eb29d56f258a2febc465de501bc22ef219bbecf Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 10 May 2022 19:46:55 +0900
Subject: [PATCH 4737/5547] Rename new test method to be english

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

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs
index 661465b484..6e8ed5ebb4 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs
@@ -482,7 +482,7 @@ namespace osu.Game.Tests.Visual.UserInterface
         }
 
         [Test]
-        public void TestCorrectAudioAdjustmentDeapplication()
+        public void TestCorrectAudioAdjustmentAfterPitchAdjustChange()
         {
             createScreen();
             changeRuleset(0);

From bbbecbb6b7bcf080033b3236dc09918957ef5fb8 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Tue, 10 May 2022 17:54:34 +0300
Subject: [PATCH 4738/5547] Apply time-ramping adjustment using clock instead
 of track

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

diff --git a/osu.Game/Rulesets/Mods/ModTimeRamp.cs b/osu.Game/Rulesets/Mods/ModTimeRamp.cs
index fe6d54332c..12046d1577 100644
--- a/osu.Game/Rulesets/Mods/ModTimeRamp.cs
+++ b/osu.Game/Rulesets/Mods/ModTimeRamp.cs
@@ -90,7 +90,7 @@ namespace osu.Game.Rulesets.Mods
 
         public virtual void Update(Playfield playfield)
         {
-            applyRateAdjustment(track.CurrentTime);
+            applyRateAdjustment(playfield.Clock.CurrentTime);
         }
 
         /// <summary>

From 4f5001704e6b45a4b9e4a4a47f1cde91eb92c8be Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Tue, 10 May 2022 18:01:15 +0300
Subject: [PATCH 4739/5547] Change `IApplicableToTrack` to receive adjustable
 component instead

---
 osu.Game/Rulesets/Mods/IApplicableToTrack.cs | 4 ++--
 osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs   | 6 ++----
 osu.Game/Rulesets/Mods/ModDaycore.cs         | 3 +--
 osu.Game/Rulesets/Mods/ModMuted.cs           | 3 +--
 osu.Game/Rulesets/Mods/ModNightcore.cs       | 2 +-
 osu.Game/Rulesets/Mods/ModRateAdjust.cs      | 3 +--
 osu.Game/Rulesets/Mods/ModTimeRamp.cs        | 5 ++---
 7 files changed, 10 insertions(+), 16 deletions(-)

diff --git a/osu.Game/Rulesets/Mods/IApplicableToTrack.cs b/osu.Game/Rulesets/Mods/IApplicableToTrack.cs
index 9b840cea08..deecd4bf1f 100644
--- a/osu.Game/Rulesets/Mods/IApplicableToTrack.cs
+++ b/osu.Game/Rulesets/Mods/IApplicableToTrack.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 osu.Framework.Audio.Track;
+using osu.Framework.Audio;
 
 namespace osu.Game.Rulesets.Mods
 {
@@ -10,6 +10,6 @@ namespace osu.Game.Rulesets.Mods
     /// </summary>
     public interface IApplicableToTrack : IApplicableMod
     {
-        void ApplyToTrack(ITrack track);
+        void ApplyToTrack(IAdjustableAudioComponent track);
     }
 }
diff --git a/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs b/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs
index 93251f7b2d..c9661662bf 100644
--- a/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs
+++ b/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs
@@ -5,7 +5,6 @@ using System;
 using System.Collections.Generic;
 using System.Linq;
 using osu.Framework.Audio;
-using osu.Framework.Audio.Track;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics.Audio;
 using osu.Framework.Utils;
@@ -79,7 +78,7 @@ namespace osu.Game.Rulesets.Mods
         // Apply a fixed rate change when missing, allowing the player to catch up when the rate is too fast.
         private const double rate_change_on_miss = 0.95d;
 
-        private ITrack track;
+        private IAdjustableAudioComponent track;
         private double targetRate = 1d;
 
         /// <summary>
@@ -141,7 +140,7 @@ namespace osu.Game.Rulesets.Mods
             AdjustPitch.BindValueChanged(adjustPitchChanged);
         }
 
-        public void ApplyToTrack(ITrack track)
+        public void ApplyToTrack(IAdjustableAudioComponent track)
         {
             this.track = track;
 
@@ -210,7 +209,6 @@ namespace osu.Game.Rulesets.Mods
         private void adjustPitchChanged(ValueChangedEvent<bool> adjustPitchSetting)
         {
             track?.RemoveAdjustment(adjustmentForPitchSetting(adjustPitchSetting.OldValue), SpeedChange);
-
             track?.AddAdjustment(adjustmentForPitchSetting(adjustPitchSetting.NewValue), SpeedChange);
         }
 
diff --git a/osu.Game/Rulesets/Mods/ModDaycore.cs b/osu.Game/Rulesets/Mods/ModDaycore.cs
index 61ad7db706..9e8e44229e 100644
--- a/osu.Game/Rulesets/Mods/ModDaycore.cs
+++ b/osu.Game/Rulesets/Mods/ModDaycore.cs
@@ -2,7 +2,6 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using osu.Framework.Audio;
-using osu.Framework.Audio.Track;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics.Sprites;
 
@@ -27,7 +26,7 @@ namespace osu.Game.Rulesets.Mods
             }, true);
         }
 
-        public override void ApplyToTrack(ITrack track)
+        public override void ApplyToTrack(IAdjustableAudioComponent track)
         {
             // base.ApplyToTrack() intentionally not called (different tempo adjustment is applied)
             track.AddAdjustment(AdjustableProperty.Frequency, freqAdjust);
diff --git a/osu.Game/Rulesets/Mods/ModMuted.cs b/osu.Game/Rulesets/Mods/ModMuted.cs
index 1d33b44812..a7d3114f2b 100644
--- a/osu.Game/Rulesets/Mods/ModMuted.cs
+++ b/osu.Game/Rulesets/Mods/ModMuted.cs
@@ -3,7 +3,6 @@
 
 using System.Linq;
 using osu.Framework.Audio;
-using osu.Framework.Audio.Track;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Sprites;
@@ -71,7 +70,7 @@ namespace osu.Game.Rulesets.Mods
             InverseMuting.BindValueChanged(i => MuteComboCount.MinValue = i.NewValue ? 1 : 0, true);
         }
 
-        public void ApplyToTrack(ITrack track)
+        public void ApplyToTrack(IAdjustableAudioComponent track)
         {
             track.AddAdjustment(AdjustableProperty.Volume, mainVolumeAdjust);
         }
diff --git a/osu.Game/Rulesets/Mods/ModNightcore.cs b/osu.Game/Rulesets/Mods/ModNightcore.cs
index 993efead33..7997204450 100644
--- a/osu.Game/Rulesets/Mods/ModNightcore.cs
+++ b/osu.Game/Rulesets/Mods/ModNightcore.cs
@@ -41,7 +41,7 @@ namespace osu.Game.Rulesets.Mods
             }, true);
         }
 
-        public override void ApplyToTrack(ITrack track)
+        public override void ApplyToTrack(IAdjustableAudioComponent track)
         {
             // base.ApplyToTrack() intentionally not called (different tempo adjustment is applied)
             track.AddAdjustment(AdjustableProperty.Frequency, freqAdjust);
diff --git a/osu.Game/Rulesets/Mods/ModRateAdjust.cs b/osu.Game/Rulesets/Mods/ModRateAdjust.cs
index 05953f903f..49590c30ca 100644
--- a/osu.Game/Rulesets/Mods/ModRateAdjust.cs
+++ b/osu.Game/Rulesets/Mods/ModRateAdjust.cs
@@ -3,7 +3,6 @@
 
 using System;
 using osu.Framework.Audio;
-using osu.Framework.Audio.Track;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics.Audio;
 
@@ -15,7 +14,7 @@ namespace osu.Game.Rulesets.Mods
 
         public abstract BindableNumber<double> SpeedChange { get; }
 
-        public virtual void ApplyToTrack(ITrack track)
+        public virtual void ApplyToTrack(IAdjustableAudioComponent track)
         {
             track.AddAdjustment(AdjustableProperty.Tempo, SpeedChange);
         }
diff --git a/osu.Game/Rulesets/Mods/ModTimeRamp.cs b/osu.Game/Rulesets/Mods/ModTimeRamp.cs
index 12046d1577..22d6d4ca29 100644
--- a/osu.Game/Rulesets/Mods/ModTimeRamp.cs
+++ b/osu.Game/Rulesets/Mods/ModTimeRamp.cs
@@ -4,7 +4,6 @@
 using System;
 using System.Linq;
 using osu.Framework.Audio;
-using osu.Framework.Audio.Track;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics.Audio;
 using osu.Game.Beatmaps;
@@ -46,7 +45,7 @@ namespace osu.Game.Rulesets.Mods
             Precision = 0.01,
         };
 
-        private ITrack track;
+        private IAdjustableAudioComponent track;
 
         protected ModTimeRamp()
         {
@@ -55,7 +54,7 @@ namespace osu.Game.Rulesets.Mods
             AdjustPitch.BindValueChanged(applyPitchAdjustment);
         }
 
-        public void ApplyToTrack(ITrack track)
+        public void ApplyToTrack(IAdjustableAudioComponent track)
         {
             this.track = track;
 

From 82b784ce5a2b29839ea3b4177c1274bd31eec2d4 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Tue, 10 May 2022 18:01:36 +0300
Subject: [PATCH 4740/5547] Change `IApplicableToSample` to receive adjustable
 component instead

Done for consistency with `IApplicableToTrack`.
---
 osu.Game/Rulesets/Mods/IApplicableToSample.cs | 4 ++--
 osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs    | 3 +--
 osu.Game/Rulesets/Mods/ModRateAdjust.cs       | 3 +--
 osu.Game/Rulesets/Mods/ModTimeRamp.cs         | 3 +--
 4 files changed, 5 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Rulesets/Mods/IApplicableToSample.cs b/osu.Game/Rulesets/Mods/IApplicableToSample.cs
index 50a6d501b6..efd88f2399 100644
--- a/osu.Game/Rulesets/Mods/IApplicableToSample.cs
+++ b/osu.Game/Rulesets/Mods/IApplicableToSample.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 osu.Framework.Graphics.Audio;
+using osu.Framework.Audio;
 
 namespace osu.Game.Rulesets.Mods
 {
@@ -10,6 +10,6 @@ namespace osu.Game.Rulesets.Mods
     /// </summary>
     public interface IApplicableToSample : IApplicableMod
     {
-        void ApplyToSample(DrawableSample sample);
+        void ApplyToSample(IAdjustableAudioComponent sample);
     }
 }
diff --git a/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs b/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs
index c9661662bf..fb291fe10f 100644
--- a/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs
+++ b/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs
@@ -6,7 +6,6 @@ using System.Collections.Generic;
 using System.Linq;
 using osu.Framework.Audio;
 using osu.Framework.Bindables;
-using osu.Framework.Graphics.Audio;
 using osu.Framework.Utils;
 using osu.Game.Beatmaps;
 using osu.Game.Configuration;
@@ -150,7 +149,7 @@ namespace osu.Game.Rulesets.Mods
             recentRates.AddRange(Enumerable.Repeat(InitialRate.Value, recent_rate_count));
         }
 
-        public void ApplyToSample(DrawableSample sample)
+        public void ApplyToSample(IAdjustableAudioComponent sample)
         {
             sample.AddAdjustment(AdjustableProperty.Frequency, SpeedChange);
         }
diff --git a/osu.Game/Rulesets/Mods/ModRateAdjust.cs b/osu.Game/Rulesets/Mods/ModRateAdjust.cs
index 49590c30ca..7b55ba4ad0 100644
--- a/osu.Game/Rulesets/Mods/ModRateAdjust.cs
+++ b/osu.Game/Rulesets/Mods/ModRateAdjust.cs
@@ -4,7 +4,6 @@
 using System;
 using osu.Framework.Audio;
 using osu.Framework.Bindables;
-using osu.Framework.Graphics.Audio;
 
 namespace osu.Game.Rulesets.Mods
 {
@@ -19,7 +18,7 @@ namespace osu.Game.Rulesets.Mods
             track.AddAdjustment(AdjustableProperty.Tempo, SpeedChange);
         }
 
-        public virtual void ApplyToSample(DrawableSample sample)
+        public virtual void ApplyToSample(IAdjustableAudioComponent sample)
         {
             sample.AddAdjustment(AdjustableProperty.Frequency, SpeedChange);
         }
diff --git a/osu.Game/Rulesets/Mods/ModTimeRamp.cs b/osu.Game/Rulesets/Mods/ModTimeRamp.cs
index 22d6d4ca29..98abda872b 100644
--- a/osu.Game/Rulesets/Mods/ModTimeRamp.cs
+++ b/osu.Game/Rulesets/Mods/ModTimeRamp.cs
@@ -5,7 +5,6 @@ using System;
 using System.Linq;
 using osu.Framework.Audio;
 using osu.Framework.Bindables;
-using osu.Framework.Graphics.Audio;
 using osu.Game.Beatmaps;
 using osu.Game.Configuration;
 using osu.Game.Rulesets.Objects;
@@ -62,7 +61,7 @@ namespace osu.Game.Rulesets.Mods
             AdjustPitch.TriggerChange();
         }
 
-        public void ApplyToSample(DrawableSample sample)
+        public void ApplyToSample(IAdjustableAudioComponent sample)
         {
             sample.AddAdjustment(AdjustableProperty.Frequency, SpeedChange);
         }

From 725ff93f34e9b49cca90e1006089d512e9891f06 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Tue, 10 May 2022 18:02:32 +0300
Subject: [PATCH 4741/5547] Define local adjustments component for mods in
 `MusicController`

Isolates `CurrentTrack` from being directly adjusted by the mod, which could lead to issues depending on how the mod adds adjustments (i.e. `ModTimeRamp`, which adds adjustments based on changes to a setting bindable).
---
 osu.Game/Overlays/MusicController.cs | 20 +++++++++++++++++---
 1 file changed, 17 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Overlays/MusicController.cs b/osu.Game/Overlays/MusicController.cs
index 5fc0da8891..0373856ace 100644
--- a/osu.Game/Overlays/MusicController.cs
+++ b/osu.Game/Overlays/MusicController.cs
@@ -377,6 +377,8 @@ namespace osu.Game.Overlays
             }
         }
 
+        private readonly AudioAdjustments modTrackAdjustments = new AudioAdjustments();
+
         /// <summary>
         /// Resets the adjustments currently applied on <see cref="CurrentTrack"/> and applies the mod adjustments if <see cref="AllowTrackAdjustments"/> is <c>true</c>.
         /// </summary>
@@ -385,15 +387,27 @@ namespace osu.Game.Overlays
         /// </remarks>
         public void ResetTrackAdjustments()
         {
+            // todo: we probably want a helper method rather than this.
             CurrentTrack.RemoveAllAdjustments(AdjustableProperty.Balance);
             CurrentTrack.RemoveAllAdjustments(AdjustableProperty.Frequency);
             CurrentTrack.RemoveAllAdjustments(AdjustableProperty.Tempo);
             CurrentTrack.RemoveAllAdjustments(AdjustableProperty.Volume);
 
-            if (allowTrackAdjustments)
+            modTrackAdjustments.RemoveAllAdjustments(AdjustableProperty.Balance);
+            modTrackAdjustments.RemoveAllAdjustments(AdjustableProperty.Frequency);
+            modTrackAdjustments.RemoveAllAdjustments(AdjustableProperty.Tempo);
+            modTrackAdjustments.RemoveAllAdjustments(AdjustableProperty.Volume);
+
+            var applicableToTrack = mods.Value.OfType<IApplicableToTrack>();
+
+            if (!allowTrackAdjustments || !applicableToTrack.Any())
+                CurrentTrack.UnbindAdjustments(modTrackAdjustments);
+            else
             {
-                foreach (var mod in mods.Value.OfType<IApplicableToTrack>())
-                    mod.ApplyToTrack(CurrentTrack);
+                CurrentTrack.BindAdjustments(modTrackAdjustments);
+
+                foreach (var mod in applicableToTrack)
+                    mod.ApplyToTrack(modTrackAdjustments);
             }
         }
     }

From ec231e0f312eeeecb8229a0fe1ee0660935b455f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 11 May 2022 00:45:17 +0900
Subject: [PATCH 4742/5547] Use more local realm reference
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/Stores/RealmArchiveModelManager.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Stores/RealmArchiveModelManager.cs b/osu.Game/Stores/RealmArchiveModelManager.cs
index e349efe5ad..cc8229b436 100644
--- a/osu.Game/Stores/RealmArchiveModelManager.cs
+++ b/osu.Game/Stores/RealmArchiveModelManager.cs
@@ -49,7 +49,7 @@ namespace osu.Game.Stores
                 // (ie. if an async import finished very recently).
                 Realm.Realm.Write(realm =>
                 {
-                    var managed = Realm.Realm.Find<TModel>(item.ID);
+                    var managed = realm.Find<TModel>(item.ID);
                     operation(managed);
 
                     item.Files.Clear();

From a0f1c48e806ff64f6c58b521b43c1d87f3d83e0b Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Tue, 10 May 2022 19:24:36 +0300
Subject: [PATCH 4743/5547] Fix `ModTimeRampTest` failing due to changes in
 `Update` method

---
 osu.Game.Tests/Rulesets/Mods/ModTimeRampTest.cs | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Rulesets/Mods/ModTimeRampTest.cs b/osu.Game.Tests/Rulesets/Mods/ModTimeRampTest.cs
index 4b9f2181dc..51163efd6a 100644
--- a/osu.Game.Tests/Rulesets/Mods/ModTimeRampTest.cs
+++ b/osu.Game.Tests/Rulesets/Mods/ModTimeRampTest.cs
@@ -3,9 +3,11 @@
 
 using NUnit.Framework;
 using osu.Framework.Audio.Track;
+using osu.Framework.Timing;
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Osu.Objects;
+using osu.Game.Rulesets.Osu.UI;
 
 namespace osu.Game.Tests.Rulesets.Mods
 {
@@ -16,11 +18,14 @@ namespace osu.Game.Tests.Rulesets.Mods
         private const double duration = 9000;
 
         private TrackVirtual track;
+        private OsuPlayfield playfield;
 
         [SetUp]
         public void SetUp()
         {
             track = new TrackVirtual(20_000);
+            // define a fake playfield to re-calculate the current rate by ModTimeRamp.Update(Playfield).
+            playfield = new OsuPlayfield { Clock = new FramedClock(track) };
         }
 
         [TestCase(0, 1)]
@@ -80,8 +85,8 @@ namespace osu.Game.Tests.Rulesets.Mods
         private void seekTrackAndUpdateMod(ModTimeRamp mod, double time)
         {
             track.Seek(time);
-            // update the mod via a fake playfield to re-calculate the current rate.
-            mod.Update(null);
+            playfield.Clock.ProcessFrame();
+            mod.Update(playfield);
         }
 
         private static Beatmap createSingleSpinnerBeatmap()

From 36a764416400d2d8f77793a1e258f5f7d092742a Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Tue, 10 May 2022 20:46:31 +0300
Subject: [PATCH 4744/5547] Reinstantiate mod adjustments layer for safety
 against previous mods

---
 osu.Game/Overlays/MusicController.cs | 17 +++++++++--------
 1 file changed, 9 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Overlays/MusicController.cs b/osu.Game/Overlays/MusicController.cs
index 0373856ace..50495d0a2c 100644
--- a/osu.Game/Overlays/MusicController.cs
+++ b/osu.Game/Overlays/MusicController.cs
@@ -377,7 +377,7 @@ namespace osu.Game.Overlays
             }
         }
 
-        private readonly AudioAdjustments modTrackAdjustments = new AudioAdjustments();
+        private AudioAdjustments modTrackAdjustments;
 
         /// <summary>
         /// Resets the adjustments currently applied on <see cref="CurrentTrack"/> and applies the mod adjustments if <see cref="AllowTrackAdjustments"/> is <c>true</c>.
@@ -393,18 +393,19 @@ namespace osu.Game.Overlays
             CurrentTrack.RemoveAllAdjustments(AdjustableProperty.Tempo);
             CurrentTrack.RemoveAllAdjustments(AdjustableProperty.Volume);
 
-            modTrackAdjustments.RemoveAllAdjustments(AdjustableProperty.Balance);
-            modTrackAdjustments.RemoveAllAdjustments(AdjustableProperty.Frequency);
-            modTrackAdjustments.RemoveAllAdjustments(AdjustableProperty.Tempo);
-            modTrackAdjustments.RemoveAllAdjustments(AdjustableProperty.Volume);
-
             var applicableToTrack = mods.Value.OfType<IApplicableToTrack>();
 
             if (!allowTrackAdjustments || !applicableToTrack.Any())
-                CurrentTrack.UnbindAdjustments(modTrackAdjustments);
+            {
+                if (modTrackAdjustments != null)
+                {
+                    CurrentTrack.UnbindAdjustments(modTrackAdjustments);
+                    modTrackAdjustments = null;
+                }
+            }
             else
             {
-                CurrentTrack.BindAdjustments(modTrackAdjustments);
+                CurrentTrack.BindAdjustments(modTrackAdjustments = new AudioAdjustments());
 
                 foreach (var mod in applicableToTrack)
                     mod.ApplyToTrack(modTrackAdjustments);

From 9446be251117f6b904c67b09aea0155b535738a6 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Tue, 10 May 2022 20:49:15 +0300
Subject: [PATCH 4745/5547] Remove unnecessary `UnbindAdjustments` call

It is not necessary given that `CurrentTrack` already removes all adjustments first.
---
 osu.Game/Overlays/MusicController.cs | 14 ++------------
 1 file changed, 2 insertions(+), 12 deletions(-)

diff --git a/osu.Game/Overlays/MusicController.cs b/osu.Game/Overlays/MusicController.cs
index 50495d0a2c..65b06eb864 100644
--- a/osu.Game/Overlays/MusicController.cs
+++ b/osu.Game/Overlays/MusicController.cs
@@ -393,21 +393,11 @@ namespace osu.Game.Overlays
             CurrentTrack.RemoveAllAdjustments(AdjustableProperty.Tempo);
             CurrentTrack.RemoveAllAdjustments(AdjustableProperty.Volume);
 
-            var applicableToTrack = mods.Value.OfType<IApplicableToTrack>();
-
-            if (!allowTrackAdjustments || !applicableToTrack.Any())
-            {
-                if (modTrackAdjustments != null)
-                {
-                    CurrentTrack.UnbindAdjustments(modTrackAdjustments);
-                    modTrackAdjustments = null;
-                }
-            }
-            else
+            if (allowTrackAdjustments)
             {
                 CurrentTrack.BindAdjustments(modTrackAdjustments = new AudioAdjustments());
 
-                foreach (var mod in applicableToTrack)
+                foreach (var mod in mods.Value.OfType<IApplicableToTrack>())
                     mod.ApplyToTrack(modTrackAdjustments);
             }
         }

From 9cfe2cc310b916f2ca78ca1daefd256a777f2dab Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 10 May 2022 21:43:57 +0200
Subject: [PATCH 4746/5547] Move `TestCustomisableModRuleset` out of
 `TestSceneModSettings`

---
 .../Mods/TestCustomisableModRuleset.cs        | 80 +++++++++++++++++++
 .../Gameplay/TestSceneReplayRecorder.cs       |  6 +-
 .../Gameplay/TestSceneSpectatorPlayback.cs    |  6 +-
 .../UserInterface/TestSceneModSettings.cs     | 78 +-----------------
 4 files changed, 90 insertions(+), 80 deletions(-)
 create mode 100644 osu.Game.Tests/Mods/TestCustomisableModRuleset.cs

diff --git a/osu.Game.Tests/Mods/TestCustomisableModRuleset.cs b/osu.Game.Tests/Mods/TestCustomisableModRuleset.cs
new file mode 100644
index 0000000000..3992d9abe6
--- /dev/null
+++ b/osu.Game.Tests/Mods/TestCustomisableModRuleset.cs
@@ -0,0 +1,80 @@
+// 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.Bindables;
+using osu.Game.Beatmaps;
+using osu.Game.Configuration;
+using osu.Game.Rulesets;
+using osu.Game.Rulesets.Difficulty;
+using osu.Game.Rulesets.Mods;
+using osu.Game.Rulesets.UI;
+
+namespace osu.Game.Tests.Mods
+{
+    public class TestCustomisableModRuleset : Ruleset
+    {
+        public static RulesetInfo CreateTestRulesetInfo() => new TestCustomisableModRuleset().RulesetInfo;
+
+        public override IEnumerable<Mod> GetModsFor(ModType type)
+        {
+            if (type == ModType.Conversion)
+            {
+                return new Mod[]
+                {
+                    new TestModCustomisable1(),
+                    new TestModCustomisable2()
+                };
+            }
+
+            return Array.Empty<Mod>();
+        }
+
+        public override DrawableRuleset CreateDrawableRulesetWith(IBeatmap beatmap, IReadOnlyList<Mod> mods = null) => throw new NotImplementedException();
+
+        public override IBeatmapConverter CreateBeatmapConverter(IBeatmap beatmap) => throw new NotImplementedException();
+
+        public override DifficultyCalculator CreateDifficultyCalculator(IWorkingBeatmap beatmap) => throw new NotImplementedException();
+
+        public override string Description { get; } = "test";
+        public override string ShortName { get; } = "tst";
+
+        public class TestModCustomisable1 : TestModCustomisable
+        {
+            public override string Name => "Customisable Mod 1";
+
+            public override string Acronym => "CM1";
+        }
+
+        public class TestModCustomisable2 : TestModCustomisable
+        {
+            public override string Name => "Customisable Mod 2";
+
+            public override string Acronym => "CM2";
+
+            public override bool RequiresConfiguration => true;
+        }
+
+        public abstract class TestModCustomisable : Mod, IApplicableMod
+        {
+            public override double ScoreMultiplier => 1.0;
+
+            public override string Description => "This is a customisable test mod.";
+
+            public override ModType Type => ModType.Conversion;
+
+            [SettingSource("Sample float", "Change something for a mod")]
+            public BindableFloat SliderBindable { get; } = new BindableFloat
+            {
+                MinValue = 0,
+                MaxValue = 10,
+                Default = 5,
+                Value = 7
+            };
+
+            [SettingSource("Sample bool", "Clicking this changes a setting")]
+            public BindableBool TickBindable { get; } = new BindableBool();
+        }
+    }
+}
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneReplayRecorder.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneReplayRecorder.cs
index 8df32c500e..81763564fa 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneReplayRecorder.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneReplayRecorder.cs
@@ -24,7 +24,7 @@ using osu.Game.Rulesets.Replays;
 using osu.Game.Rulesets.UI;
 using osu.Game.Scoring;
 using osu.Game.Screens.Play;
-using osu.Game.Tests.Visual.UserInterface;
+using osu.Game.Tests.Mods;
 using osuTK;
 using osuTK.Graphics;
 using osuTK.Input;
@@ -59,7 +59,7 @@ namespace osu.Game.Tests.Visual.Gameplay
                     {
                         new Drawable[]
                         {
-                            recordingManager = new TestRulesetInputManager(TestSceneModSettings.CreateTestRulesetInfo(), 0, SimultaneousBindingMode.Unique)
+                            recordingManager = new TestRulesetInputManager(TestCustomisableModRuleset.CreateTestRulesetInfo(), 0, SimultaneousBindingMode.Unique)
                             {
                                 Recorder = recorder = new TestReplayRecorder(new Score
                                 {
@@ -97,7 +97,7 @@ namespace osu.Game.Tests.Visual.Gameplay
                         },
                         new Drawable[]
                         {
-                            playbackManager = new TestRulesetInputManager(TestSceneModSettings.CreateTestRulesetInfo(), 0, SimultaneousBindingMode.Unique)
+                            playbackManager = new TestRulesetInputManager(TestCustomisableModRuleset.CreateTestRulesetInfo(), 0, SimultaneousBindingMode.Unique)
                             {
                                 ReplayInputHandler = new TestFramedReplayInputHandler(replay)
                                 {
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorPlayback.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorPlayback.cs
index 4ec46036f6..f8748922cf 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorPlayback.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorPlayback.cs
@@ -27,8 +27,8 @@ using osu.Game.Rulesets.Replays.Types;
 using osu.Game.Rulesets.UI;
 using osu.Game.Scoring;
 using osu.Game.Screens.Play;
+using osu.Game.Tests.Mods;
 using osu.Game.Tests.Visual.Spectator;
-using osu.Game.Tests.Visual.UserInterface;
 using osuTK;
 using osuTK.Graphics;
 
@@ -77,7 +77,7 @@ namespace osu.Game.Tests.Visual.Gameplay
                             {
                                 new Drawable[]
                                 {
-                                    recordingManager = new TestRulesetInputManager(TestSceneModSettings.CreateTestRulesetInfo(), 0, SimultaneousBindingMode.Unique)
+                                    recordingManager = new TestRulesetInputManager(TestCustomisableModRuleset.CreateTestRulesetInfo(), 0, SimultaneousBindingMode.Unique)
                                     {
                                         Recorder = recorder = new TestReplayRecorder
                                         {
@@ -107,7 +107,7 @@ namespace osu.Game.Tests.Visual.Gameplay
                                 },
                                 new Drawable[]
                                 {
-                                    playbackManager = new TestRulesetInputManager(TestSceneModSettings.CreateTestRulesetInfo(), 0, SimultaneousBindingMode.Unique)
+                                    playbackManager = new TestRulesetInputManager(TestCustomisableModRuleset.CreateTestRulesetInfo(), 0, SimultaneousBindingMode.Unique)
                                     {
                                         Clock = new FramedClock(manualClock),
                                         ReplayInputHandler = replayHandler = new TestFramedReplayInputHandler(replay)
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneModSettings.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneModSettings.cs
index 9a3083e8db..379735a7f5 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneModSettings.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneModSettings.cs
@@ -5,20 +5,15 @@ using System;
 using System.Collections.Generic;
 using System.Linq;
 using NUnit.Framework;
-using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Utils;
 using osu.Framework.Testing;
-using osu.Game.Beatmaps;
-using osu.Game.Configuration;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Overlays.Mods;
-using osu.Game.Rulesets;
-using osu.Game.Rulesets.Difficulty;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Osu.Mods;
-using osu.Game.Rulesets.UI;
+using osu.Game.Tests.Mods;
 using osuTK.Input;
 
 namespace osu.Game.Tests.Visual.UserInterface
@@ -27,15 +22,15 @@ namespace osu.Game.Tests.Visual.UserInterface
     {
         private TestModSelectOverlay modSelect;
 
-        private readonly Mod testCustomisableMod = new TestModCustomisable1();
+        private readonly Mod testCustomisableMod = new TestCustomisableModRuleset.TestModCustomisable1();
 
-        private readonly Mod testCustomisableAutoOpenMod = new TestModCustomisable2();
+        private readonly Mod testCustomisableAutoOpenMod = new TestCustomisableModRuleset.TestModCustomisable2();
 
         [SetUp]
         public void SetUp() => Schedule(() =>
         {
             SelectedMods.Value = Array.Empty<Mod>();
-            Ruleset.Value = CreateTestRulesetInfo();
+            Ruleset.Value = TestCustomisableModRuleset.CreateTestRulesetInfo();
         });
 
         [Test]
@@ -169,70 +164,5 @@ namespace osu.Game.Tests.Visual.UserInterface
             public void SetModSettingsWidth(float newWidth) =>
                 ModSettingsContainer.Parent.Width = newWidth;
         }
-
-        public static RulesetInfo CreateTestRulesetInfo() => new TestCustomisableModRuleset().RulesetInfo;
-
-        public class TestCustomisableModRuleset : Ruleset
-        {
-            public override IEnumerable<Mod> GetModsFor(ModType type)
-            {
-                if (type == ModType.Conversion)
-                {
-                    return new Mod[]
-                    {
-                        new TestModCustomisable1(),
-                        new TestModCustomisable2()
-                    };
-                }
-
-                return Array.Empty<Mod>();
-            }
-
-            public override DrawableRuleset CreateDrawableRulesetWith(IBeatmap beatmap, IReadOnlyList<Mod> mods = null) => throw new NotImplementedException();
-
-            public override IBeatmapConverter CreateBeatmapConverter(IBeatmap beatmap) => throw new NotImplementedException();
-
-            public override DifficultyCalculator CreateDifficultyCalculator(IWorkingBeatmap beatmap) => throw new NotImplementedException();
-
-            public override string Description { get; } = "test";
-            public override string ShortName { get; } = "tst";
-        }
-
-        private class TestModCustomisable1 : TestModCustomisable
-        {
-            public override string Name => "Customisable Mod 1";
-
-            public override string Acronym => "CM1";
-        }
-
-        private class TestModCustomisable2 : TestModCustomisable
-        {
-            public override string Name => "Customisable Mod 2";
-
-            public override string Acronym => "CM2";
-
-            public override bool RequiresConfiguration => true;
-        }
-
-        private abstract class TestModCustomisable : Mod, IApplicableMod
-        {
-            public override double ScoreMultiplier => 1.0;
-
-            public override string Description => "This is a customisable test mod.";
-
-            public override ModType Type => ModType.Conversion;
-
-            [SettingSource("Sample float", "Change something for a mod")]
-            public BindableFloat SliderBindable { get; } = new BindableFloat
-            {
-                MinValue = 0,
-                MaxValue = 10,
-                Default = 5,
-                Value = 7
-            };
-
-            [SettingSource("Sample bool", "Clicking this changes a setting")]
-            public BindableBool TickBindable { get; } = new BindableBool();
-        }
     }
 }

From 4a3447f59f69af6b591f4c6c44f5b3422b229b58 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 10 May 2022 21:45:57 +0200
Subject: [PATCH 4747/5547] Remove old free mod select overlay

---
 .../TestSceneFreeModSelectOverlay.cs          |  21 ---
 .../OnlinePlay/FreeModSelectOverlay.cs        | 157 ------------------
 2 files changed, 178 deletions(-)
 delete mode 100644 osu.Game.Tests/Visual/Multiplayer/TestSceneFreeModSelectOverlay.cs
 delete mode 100644 osu.Game/Screens/OnlinePlay/FreeModSelectOverlay.cs

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneFreeModSelectOverlay.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneFreeModSelectOverlay.cs
deleted file mode 100644
index 26a0301d8a..0000000000
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneFreeModSelectOverlay.cs
+++ /dev/null
@@ -1,21 +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.Graphics.Containers;
-using osu.Game.Screens.OnlinePlay;
-
-namespace osu.Game.Tests.Visual.Multiplayer
-{
-    public class TestSceneFreeModSelectOverlay : MultiplayerTestScene
-    {
-        [SetUp]
-        public new void Setup() => Schedule(() =>
-        {
-            Child = new FreeModSelectOverlay
-            {
-                State = { Value = Visibility.Visible }
-            };
-        });
-    }
-}
diff --git a/osu.Game/Screens/OnlinePlay/FreeModSelectOverlay.cs b/osu.Game/Screens/OnlinePlay/FreeModSelectOverlay.cs
deleted file mode 100644
index d5abaaab4e..0000000000
--- a/osu.Game/Screens/OnlinePlay/FreeModSelectOverlay.cs
+++ /dev/null
@@ -1,157 +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.Linq;
-using osu.Framework.Graphics;
-using osu.Framework.Graphics.Containers;
-using osu.Framework.Graphics.Sprites;
-using osu.Game.Graphics;
-using osu.Game.Graphics.UserInterface;
-using osu.Game.Overlays.Mods;
-using osu.Game.Rulesets.Mods;
-
-namespace osu.Game.Screens.OnlinePlay
-{
-    /// <summary>
-    /// A <see cref="ModSelectOverlay"/> used for free-mod selection in online play.
-    /// </summary>
-    public class FreeModSelectOverlay : ModSelectOverlay
-    {
-        protected override bool Stacked => false;
-
-        protected override bool AllowConfiguration => false;
-
-        public new Func<Mod, bool> IsValidMod
-        {
-            get => base.IsValidMod;
-            set => base.IsValidMod = m => m.HasImplementation && m.UserPlayable && value(m);
-        }
-
-        public FreeModSelectOverlay()
-        {
-            IsValidMod = m => true;
-
-            DeselectAllButton.Alpha = 0;
-
-            Drawable selectAllButton;
-            Drawable deselectAllButton;
-
-            FooterContainer.AddRange(new[]
-            {
-                selectAllButton = new TriangleButton
-                {
-                    Origin = Anchor.CentreLeft,
-                    Anchor = Anchor.CentreLeft,
-                    Width = 180,
-                    Text = "Select All",
-                    Action = selectAll,
-                },
-                // Unlike the base mod select overlay, this button deselects mods instantaneously.
-                deselectAllButton = new TriangleButton
-                {
-                    Origin = Anchor.CentreLeft,
-                    Anchor = Anchor.CentreLeft,
-                    Width = 180,
-                    Text = "Deselect All",
-                    Action = deselectAll,
-                },
-            });
-
-            FooterContainer.SetLayoutPosition(selectAllButton, -2);
-            FooterContainer.SetLayoutPosition(deselectAllButton, -1);
-        }
-
-        private void selectAll()
-        {
-            foreach (var section in ModSectionsContainer.Children)
-                section.SelectAll();
-        }
-
-        private void deselectAll()
-        {
-            foreach (var section in ModSectionsContainer.Children)
-                section.DeselectAll();
-        }
-
-        protected override void OnAvailableModsChanged()
-        {
-            base.OnAvailableModsChanged();
-
-            foreach (var section in ModSectionsContainer.Children)
-                ((FreeModSection)section).UpdateCheckboxState();
-        }
-
-        protected override ModSection CreateModSection(ModType type) => new FreeModSection(type);
-
-        private class FreeModSection : ModSection
-        {
-            private HeaderCheckbox checkbox;
-
-            public FreeModSection(ModType type)
-                : base(type)
-            {
-            }
-
-            protected override Drawable CreateHeader(string text) => new Container
-            {
-                AutoSizeAxes = Axes.Y,
-                RelativeSizeAxes = Axes.X,
-                Child = checkbox = new HeaderCheckbox
-                {
-                    LabelText = text,
-                    Changed = onCheckboxChanged
-                }
-            };
-
-            private void onCheckboxChanged(bool value)
-            {
-                if (value)
-                    SelectAll();
-                else
-                    DeselectAll();
-            }
-
-            protected override void ModButtonStateChanged(Mod mod)
-            {
-                base.ModButtonStateChanged(mod);
-                UpdateCheckboxState();
-            }
-
-            public void UpdateCheckboxState()
-            {
-                if (!SelectionAnimationRunning)
-                {
-                    var validButtons = Buttons.Where(b => b.Mod.HasImplementation);
-                    checkbox.Current.Value = validButtons.All(b => b.Selected);
-                }
-            }
-        }
-
-        private class HeaderCheckbox : OsuCheckbox
-        {
-            public Action<bool> Changed;
-
-            protected override bool PlaySoundsOnUserChange => false;
-
-            public HeaderCheckbox()
-                : base(false)
-
-            {
-            }
-
-            protected override void ApplyLabelParameters(SpriteText text)
-            {
-                base.ApplyLabelParameters(text);
-
-                text.Font = OsuFont.GetFont(weight: FontWeight.Bold);
-            }
-
-            protected override void OnUserChange(bool value)
-            {
-                base.OnUserChange(value);
-                Changed?.Invoke(value);
-            }
-        }
-    }
-}

From 24c59e2f2fa942769843ebd8afd299c4008c3c85 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 10 May 2022 21:48:21 +0200
Subject: [PATCH 4748/5547] Remove old user mod select overlay

---
 .../TestSceneModSelectOverlay.cs              | 472 ------------------
 .../UserInterface/TestSceneModSettings.cs     | 119 -----
 .../IncompatibilityDisplayingModButton.cs     |  66 ---
 .../Overlays/Mods/UserModSelectOverlay.cs     |  30 --
 4 files changed, 687 deletions(-)
 delete mode 100644 osu.Game.Tests/Visual/UserInterface/TestSceneModSelectOverlay.cs
 delete mode 100644 osu.Game/Overlays/Mods/IncompatibilityDisplayingModButton.cs
 delete mode 100644 osu.Game/Overlays/Mods/UserModSelectOverlay.cs

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectOverlay.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectOverlay.cs
deleted file mode 100644
index b429619044..0000000000
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectOverlay.cs
+++ /dev/null
@@ -1,472 +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 NUnit.Framework;
-using osu.Framework.Allocation;
-using osu.Framework.Bindables;
-using osu.Framework.Graphics;
-using osu.Framework.Graphics.Containers;
-using osu.Framework.Testing;
-using osu.Game.Graphics.UserInterface;
-using osu.Game.Overlays.Mods;
-using osu.Game.Overlays.Settings;
-using osu.Game.Rulesets;
-using osu.Game.Rulesets.Mania;
-using osu.Game.Rulesets.Mania.Mods;
-using osu.Game.Rulesets.Mods;
-using osu.Game.Rulesets.Osu;
-using osu.Game.Rulesets.Osu.Mods;
-using osu.Game.Screens.Play.HUD;
-using osuTK;
-using osuTK.Graphics;
-
-namespace osu.Game.Tests.Visual.UserInterface
-{
-    [Description("mod select and icon display")]
-    public class TestSceneModSelectOverlay : OsuTestScene
-    {
-        private RulesetStore rulesets;
-        private ModDisplay modDisplay;
-        private TestModSelectOverlay modSelect;
-
-        [BackgroundDependencyLoader]
-        private void load(RulesetStore rulesets)
-        {
-            this.rulesets = rulesets;
-        }
-
-        [SetUp]
-        public void SetUp() => Schedule(() =>
-        {
-            SelectedMods.Value = Array.Empty<Mod>();
-            createDisplay(() => new TestModSelectOverlay());
-        });
-
-        [SetUpSteps]
-        public void SetUpSteps()
-        {
-            AddStep("show", () => modSelect.Show());
-        }
-
-        /// <summary>
-        /// Ensure that two mod overlays are not cross polluting via central settings instances.
-        /// </summary>
-        [Test]
-        public void TestSettingsNotCrossPolluting()
-        {
-            Bindable<IReadOnlyList<Mod>> selectedMods2 = null;
-
-            AddStep("select diff adjust", () => SelectedMods.Value = new Mod[] { new OsuModDifficultyAdjust() });
-
-            AddStep("set setting", () => modSelect.ChildrenOfType<SettingsSlider<float>>().First().Current.Value = 8);
-
-            AddAssert("ensure setting is propagated", () => SelectedMods.Value.OfType<OsuModDifficultyAdjust>().Single().CircleSize.Value == 8);
-
-            AddStep("create second bindable", () => selectedMods2 = new Bindable<IReadOnlyList<Mod>>(new Mod[] { new OsuModDifficultyAdjust() }));
-
-            AddStep("create second overlay", () =>
-            {
-                Add(modSelect = new TestModSelectOverlay().With(d =>
-                {
-                    d.Origin = Anchor.TopCentre;
-                    d.Anchor = Anchor.TopCentre;
-                    d.SelectedMods.BindTarget = selectedMods2;
-                }));
-            });
-
-            AddStep("show", () => modSelect.Show());
-
-            AddAssert("ensure first is unchanged", () => SelectedMods.Value.OfType<OsuModDifficultyAdjust>().Single().CircleSize.Value == 8);
-            AddAssert("ensure second is default", () => selectedMods2.Value.OfType<OsuModDifficultyAdjust>().Single().CircleSize.Value == null);
-        }
-
-        [Test]
-        public void TestSettingsResetOnDeselection()
-        {
-            var osuModDoubleTime = new OsuModDoubleTime { SpeedChange = { Value = 1.2 } };
-
-            changeRuleset(0);
-
-            AddStep("set dt mod with custom rate", () => { SelectedMods.Value = new[] { osuModDoubleTime }; });
-
-            AddAssert("selected mod matches", () => (SelectedMods.Value.Single() as OsuModDoubleTime)?.SpeedChange.Value == 1.2);
-
-            AddStep("deselect", () => modSelect.DeselectAllButton.TriggerClick());
-            AddAssert("selected mods empty", () => SelectedMods.Value.Count == 0);
-
-            AddStep("reselect", () => modSelect.GetModButton(osuModDoubleTime).TriggerClick());
-            AddAssert("selected mod has default value", () => (SelectedMods.Value.Single() as OsuModDoubleTime)?.SpeedChange.IsDefault == true);
-        }
-
-        [Test]
-        public void TestAnimationFlushOnClose()
-        {
-            changeRuleset(0);
-
-            AddStep("Select all fun mods", () =>
-            {
-                modSelect.ModSectionsContainer
-                         .Single(c => c.ModType == ModType.DifficultyIncrease)
-                         .SelectAll();
-            });
-
-            AddUntilStep("many mods selected", () => modDisplay.Current.Value.Count >= 5);
-
-            AddStep("trigger deselect and close overlay", () =>
-            {
-                modSelect.ModSectionsContainer
-                         .Single(c => c.ModType == ModType.DifficultyIncrease)
-                         .DeselectAll();
-
-                modSelect.Hide();
-            });
-
-            AddAssert("all mods deselected", () => modDisplay.Current.Value.Count == 0);
-        }
-
-        [Test]
-        public void TestOsuMods()
-        {
-            changeRuleset(0);
-
-            var osu = new OsuRuleset();
-
-            var easierMods = osu.GetModsFor(ModType.DifficultyReduction);
-            var harderMods = osu.GetModsFor(ModType.DifficultyIncrease);
-
-            var noFailMod = osu.GetModsFor(ModType.DifficultyReduction).FirstOrDefault(m => m is OsuModNoFail);
-
-            var doubleTimeMod = harderMods.OfType<MultiMod>().FirstOrDefault(m => m.Mods.Any(a => a is OsuModDoubleTime));
-
-            var easy = easierMods.FirstOrDefault(m => m is OsuModEasy);
-            var hardRock = harderMods.FirstOrDefault(m => m is OsuModHardRock);
-
-            testSingleMod(noFailMod);
-            testMultiMod(doubleTimeMod);
-            testIncompatibleMods(easy, hardRock);
-            testDeselectAll(easierMods.Where(m => !(m is MultiMod)));
-        }
-
-        [Test]
-        public void TestManiaMods()
-        {
-            changeRuleset(3);
-
-            var mania = new ManiaRuleset();
-
-            testModsWithSameBaseType(
-                mania.CreateMod<ManiaModFadeIn>(),
-                mania.CreateMod<ManiaModHidden>());
-        }
-
-        [Test]
-        public void TestRulesetChanges()
-        {
-            changeRuleset(0);
-
-            var noFailMod = new OsuRuleset().GetModsFor(ModType.DifficultyReduction).FirstOrDefault(m => m is OsuModNoFail);
-
-            AddStep("set mods externally", () => { SelectedMods.Value = new[] { noFailMod }; });
-
-            changeRuleset(0);
-
-            AddAssert("ensure mods still selected", () => modDisplay.Current.Value.SingleOrDefault(m => m is OsuModNoFail) != null);
-
-            changeRuleset(3);
-
-            AddAssert("ensure mods not selected", () => modDisplay.Current.Value.Count == 0);
-
-            changeRuleset(0);
-
-            AddAssert("ensure mods not selected", () => modDisplay.Current.Value.Count == 0);
-        }
-
-        [Test]
-        public void TestExternallySetCustomizedMod()
-        {
-            changeRuleset(0);
-
-            AddStep("set customized mod externally", () => SelectedMods.Value = new[] { new OsuModDoubleTime { SpeedChange = { Value = 1.01 } } });
-
-            AddAssert("ensure button is selected and customized accordingly", () =>
-            {
-                var button = modSelect.GetModButton(SelectedMods.Value.Single());
-                return ((OsuModDoubleTime)button.SelectedMod).SpeedChange.Value == 1.01;
-            });
-        }
-
-        [Test]
-        public void TestSettingsAreRetainedOnReload()
-        {
-            changeRuleset(0);
-
-            AddStep("set customized mod externally", () => SelectedMods.Value = new[] { new OsuModDoubleTime { SpeedChange = { Value = 1.01 } } });
-
-            AddAssert("setting remains", () => (SelectedMods.Value.SingleOrDefault() as OsuModDoubleTime)?.SpeedChange.Value == 1.01);
-
-            AddStep("create overlay", () => createDisplay(() => new TestNonStackedModSelectOverlay()));
-
-            AddAssert("setting remains", () => (SelectedMods.Value.SingleOrDefault() as OsuModDoubleTime)?.SpeedChange.Value == 1.01);
-        }
-
-        [Test]
-        public void TestExternallySetModIsReplacedByOverlayInstance()
-        {
-            Mod external = new OsuModDoubleTime();
-            Mod overlayButtonMod = null;
-
-            changeRuleset(0);
-
-            AddStep("set mod externally", () => { SelectedMods.Value = new[] { external }; });
-
-            AddAssert("ensure button is selected", () =>
-            {
-                var button = modSelect.GetModButton(SelectedMods.Value.Single());
-                overlayButtonMod = button.SelectedMod;
-                return overlayButtonMod.GetType() == external.GetType();
-            });
-
-            // Right now, when an external change occurs, the ModSelectOverlay will replace the global instance with its own
-            AddAssert("mod instance doesn't match", () => external != overlayButtonMod);
-
-            AddAssert("one mod present in global selected", () => SelectedMods.Value.Count == 1);
-            AddAssert("globally selected matches button's mod instance", () => SelectedMods.Value.Contains(overlayButtonMod));
-            AddAssert("globally selected doesn't contain original external change", () => !SelectedMods.Value.Contains(external));
-        }
-
-        [Test]
-        public void TestNonStacked()
-        {
-            changeRuleset(0);
-
-            AddStep("create overlay", () => createDisplay(() => new TestNonStackedModSelectOverlay()));
-
-            AddStep("show", () => modSelect.Show());
-
-            AddAssert("ensure all buttons are spread out", () => modSelect.ChildrenOfType<ModButton>().All(m => m.Mods.Length <= 1));
-        }
-
-        [Test]
-        public void TestChangeIsValidChangesButtonVisibility()
-        {
-            changeRuleset(0);
-
-            AddAssert("double time visible", () => modSelect.ChildrenOfType<ModButton>().Any(b => b.Mods.Any(m => m is OsuModDoubleTime)));
-
-            AddStep("make double time invalid", () => modSelect.IsValidMod = m => !(m is OsuModDoubleTime));
-            AddUntilStep("double time not visible", () => modSelect.ChildrenOfType<ModButton>().All(b => !b.Mods.Any(m => m is OsuModDoubleTime)));
-            AddAssert("nightcore still visible", () => modSelect.ChildrenOfType<ModButton>().Any(b => b.Mods.Any(m => m is OsuModNightcore)));
-
-            AddStep("make double time valid again", () => modSelect.IsValidMod = m => true);
-            AddUntilStep("double time visible", () => modSelect.ChildrenOfType<ModButton>().Any(b => b.Mods.Any(m => m is OsuModDoubleTime)));
-            AddAssert("nightcore still visible", () => modSelect.ChildrenOfType<ModButton>().Any(b => b.Mods.Any(m => m is OsuModNightcore)));
-        }
-
-        [Test]
-        public void TestChangeIsValidPreservesSelection()
-        {
-            changeRuleset(0);
-
-            AddStep("select DT + HD", () => SelectedMods.Value = new Mod[] { new OsuModDoubleTime(), new OsuModHidden() });
-            AddAssert("DT + HD selected", () => modSelect.ChildrenOfType<ModButton>().Count(b => b.Selected) == 2);
-
-            AddStep("make NF invalid", () => modSelect.IsValidMod = m => !(m is ModNoFail));
-            AddAssert("DT + HD still selected", () => modSelect.ChildrenOfType<ModButton>().Count(b => b.Selected) == 2);
-        }
-
-        [Test]
-        public void TestUnimplementedModIsUnselectable()
-        {
-            var testRuleset = new TestUnimplementedModOsuRuleset();
-            changeTestRuleset(testRuleset.RulesetInfo);
-
-            var conversionMods = testRuleset.GetModsFor(ModType.Conversion);
-
-            var unimplementedMod = conversionMods.FirstOrDefault(m => m is TestUnimplementedMod);
-
-            testUnimplementedMod(unimplementedMod);
-        }
-
-        private void testSingleMod(Mod mod)
-        {
-            selectNext(mod);
-            checkSelected(mod);
-
-            selectPrevious(mod);
-            checkNotSelected(mod);
-
-            selectNext(mod);
-            selectNext(mod);
-            checkNotSelected(mod);
-
-            selectPrevious(mod);
-            selectPrevious(mod);
-            checkNotSelected(mod);
-        }
-
-        private void testMultiMod(MultiMod multiMod)
-        {
-            foreach (var mod in multiMod.Mods)
-            {
-                selectNext(mod);
-                checkSelected(mod);
-            }
-
-            for (int index = multiMod.Mods.Length - 1; index >= 0; index--)
-                selectPrevious(multiMod.Mods[index]);
-
-            foreach (var mod in multiMod.Mods)
-                checkNotSelected(mod);
-        }
-
-        private void testUnimplementedMod(Mod mod)
-        {
-            selectNext(mod);
-            checkNotSelected(mod);
-        }
-
-        private void testIncompatibleMods(Mod modA, Mod modB)
-        {
-            selectNext(modA);
-            checkSelected(modA);
-            checkNotSelected(modB);
-
-            selectNext(modB);
-            checkSelected(modB);
-            checkNotSelected(modA);
-
-            selectPrevious(modB);
-            checkNotSelected(modA);
-            checkNotSelected(modB);
-        }
-
-        private void testDeselectAll(IEnumerable<Mod> mods)
-        {
-            foreach (var mod in mods)
-                selectNext(mod);
-
-            AddAssert("check for any selection", () => modSelect.SelectedMods.Value.Any());
-            AddStep("deselect all", () => modSelect.DeselectAllButton.Action.Invoke());
-            AddAssert("check for no selection", () => !modSelect.SelectedMods.Value.Any());
-        }
-
-        private void testModsWithSameBaseType(Mod modA, Mod modB)
-        {
-            selectNext(modA);
-            checkSelected(modA);
-            selectNext(modB);
-            checkSelected(modB);
-
-            // Backwards
-            selectPrevious(modA);
-            checkSelected(modA);
-        }
-
-        private void selectNext(Mod mod) => AddStep($"left click {mod.Name}", () => modSelect.GetModButton(mod)?.SelectNext(1));
-
-        private void selectPrevious(Mod mod) => AddStep($"right click {mod.Name}", () => modSelect.GetModButton(mod)?.SelectNext(-1));
-
-        private void checkSelected(Mod mod)
-        {
-            AddAssert($"check {mod.Name} is selected", () =>
-            {
-                var button = modSelect.GetModButton(mod);
-                return modSelect.SelectedMods.Value.SingleOrDefault(m => m.Name == mod.Name) != null && button.SelectedMod.GetType() == mod.GetType() && button.Selected;
-            });
-        }
-
-        private void changeRuleset(int? onlineId)
-        {
-            AddStep($"change ruleset to {(onlineId?.ToString() ?? "none")}", () => { Ruleset.Value = rulesets.AvailableRulesets.FirstOrDefault(r => r.OnlineID == onlineId); });
-            waitForLoad();
-        }
-
-        private void changeTestRuleset(RulesetInfo rulesetInfo)
-        {
-            AddStep($"change ruleset to {rulesetInfo.Name}", () => { Ruleset.Value = rulesetInfo; });
-            waitForLoad();
-        }
-
-        private void waitForLoad() =>
-            AddUntilStep("wait for icons to load", () => modSelect.AllLoaded);
-
-        private void checkNotSelected(Mod mod)
-        {
-            AddAssert($"check {mod.Name} is not selected", () =>
-            {
-                var button = modSelect.GetModButton(mod);
-                return modSelect.SelectedMods.Value.All(m => m.GetType() != mod.GetType()) && button.SelectedMod?.GetType() != mod.GetType();
-            });
-        }
-
-        private void createDisplay(Func<TestModSelectOverlay> createOverlayFunc)
-        {
-            Children = new Drawable[]
-            {
-                modSelect = createOverlayFunc().With(d =>
-                {
-                    d.Origin = Anchor.BottomCentre;
-                    d.Anchor = Anchor.BottomCentre;
-                    d.SelectedMods.BindTarget = SelectedMods;
-                }),
-                modDisplay = new ModDisplay
-                {
-                    Anchor = Anchor.TopRight,
-                    Origin = Anchor.TopRight,
-                    Position = new Vector2(-5, 25),
-                    Current = { BindTarget = modSelect.SelectedMods }
-                }
-            };
-        }
-
-        private class TestModSelectOverlay : UserModSelectOverlay
-        {
-            public new Bindable<IReadOnlyList<Mod>> SelectedMods => base.SelectedMods;
-
-            public bool AllLoaded => ModSectionsContainer.Children.All(c => c.ModIconsLoaded);
-
-            public new FillFlowContainer<ModSection> ModSectionsContainer =>
-                base.ModSectionsContainer;
-
-            public ModButton GetModButton(Mod mod)
-            {
-                var section = ModSectionsContainer.Children.Single(s => s.ModType == mod.Type);
-                return section.ButtonsContainer.OfType<ModButton>().Single(b => b.Mods.Any(m => m.GetType() == mod.GetType()));
-            }
-
-            public new TriangleButton DeselectAllButton => base.DeselectAllButton;
-
-            public new Color4 LowMultiplierColour => base.LowMultiplierColour;
-            public new Color4 HighMultiplierColour => base.HighMultiplierColour;
-        }
-
-        private class TestNonStackedModSelectOverlay : TestModSelectOverlay
-        {
-            protected override bool Stacked => false;
-        }
-
-        private class TestUnimplementedMod : Mod
-        {
-            public override string Name => "Unimplemented mod";
-            public override string Acronym => "UM";
-            public override string Description => "A mod that is not implemented.";
-            public override double ScoreMultiplier => 1;
-            public override ModType Type => ModType.Conversion;
-        }
-
-        private class TestUnimplementedModOsuRuleset : OsuRuleset
-        {
-            public override string ShortName => "unimplemented";
-
-            public override IEnumerable<Mod> GetModsFor(ModType type)
-            {
-                if (type == ModType.Conversion) return base.GetModsFor(type).Concat(new[] { new TestUnimplementedMod() });
-
-                return base.GetModsFor(type);
-            }
-        }
-    }
-}
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneModSettings.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneModSettings.cs
index 379735a7f5..1cf3b2651c 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneModSettings.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneModSettings.cs
@@ -1,79 +1,15 @@
 // 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.Graphics;
-using osu.Framework.Graphics.Containers;
 using osu.Framework.Utils;
-using osu.Framework.Testing;
-using osu.Game.Graphics.UserInterface;
-using osu.Game.Overlays.Mods;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Osu.Mods;
-using osu.Game.Tests.Mods;
-using osuTK.Input;
 
 namespace osu.Game.Tests.Visual.UserInterface
 {
     public class TestSceneModSettings : OsuManualInputManagerTestScene
     {
-        private TestModSelectOverlay modSelect;
-
-        private readonly Mod testCustomisableMod = new TestCustomisableModRuleset.TestModCustomisable1();
-
-        private readonly Mod testCustomisableAutoOpenMod = new TestCustomisableModRuleset.TestModCustomisable2();
-
-        [SetUp]
-        public void SetUp() => Schedule(() =>
-        {
-            SelectedMods.Value = Array.Empty<Mod>();
-            Ruleset.Value = TestCustomisableModRuleset.CreateTestRulesetInfo();
-        });
-
-        [Test]
-        public void TestButtonShowsOnCustomisableMod()
-        {
-            createModSelect();
-            openModSelect();
-
-            AddAssert("button disabled", () => !modSelect.CustomiseButton.Enabled.Value);
-            AddUntilStep("wait for button load", () => modSelect.ButtonsLoaded);
-            AddStep("select mod", () => modSelect.SelectMod(testCustomisableMod));
-            AddAssert("button enabled", () => modSelect.CustomiseButton.Enabled.Value);
-            AddStep("open Customisation", () => modSelect.CustomiseButton.TriggerClick());
-            AddStep("deselect mod", () => modSelect.SelectMod(testCustomisableMod));
-            AddAssert("controls hidden", () => modSelect.ModSettingsContainer.State.Value == Visibility.Hidden);
-        }
-
-        [Test]
-        public void TestButtonShowsOnModAlreadyAdded()
-        {
-            AddStep("set active mods", () => SelectedMods.Value = new List<Mod> { testCustomisableMod });
-
-            createModSelect();
-
-            AddAssert("mods still active", () => SelectedMods.Value.Count == 1);
-
-            openModSelect();
-            AddAssert("button enabled", () => modSelect.CustomiseButton.Enabled.Value);
-        }
-
-        [Test]
-        public void TestCustomisationMenuVisibility()
-        {
-            createModSelect();
-            openModSelect();
-
-            AddAssert("Customisation closed", () => modSelect.ModSettingsContainer.State.Value == Visibility.Hidden);
-            AddStep("select mod", () => modSelect.SelectMod(testCustomisableAutoOpenMod));
-            AddAssert("Customisation opened", () => modSelect.ModSettingsContainer.State.Value == Visibility.Visible);
-            AddStep("deselect mod", () => modSelect.SelectMod(testCustomisableAutoOpenMod));
-            AddAssert("Customisation closed", () => modSelect.ModSettingsContainer.State.Value == Visibility.Hidden);
-        }
-
         [Test]
         public void TestModSettingsUnboundWhenCopied()
         {
@@ -109,60 +45,5 @@ namespace osu.Game.Tests.Visual.UserInterface
             AddAssert("original has new value", () => Precision.AlmostEquals(2.0, ((OsuModDoubleTime)original.Mods[0]).SpeedChange.Value));
             AddAssert("copy has original value", () => Precision.AlmostEquals(1.5, ((OsuModDoubleTime)copy.Mods[0]).SpeedChange.Value));
         }
-
-        [Test]
-        public void TestCustomisationMenuNoClickthrough()
-        {
-            createModSelect();
-            openModSelect();
-
-            AddStep("change mod settings menu width to full screen", () => modSelect.SetModSettingsWidth(1.0f));
-            AddStep("select cm2", () => modSelect.SelectMod(testCustomisableAutoOpenMod));
-            AddAssert("Customisation opened", () => modSelect.ModSettingsContainer.State.Value == Visibility.Visible);
-            AddStep("hover over mod behind settings menu", () => InputManager.MoveMouseTo(modSelect.GetModButton(testCustomisableMod)));
-            AddAssert("Mod is not considered hovered over", () => !modSelect.GetModButton(testCustomisableMod).IsHovered);
-            AddStep("left click mod", () => InputManager.Click(MouseButton.Left));
-            AddAssert("only cm2 is active", () => SelectedMods.Value.Count == 1);
-            AddStep("right click mod", () => InputManager.Click(MouseButton.Right));
-            AddAssert("only cm2 is active", () => SelectedMods.Value.Count == 1);
-        }
-
-        private void createModSelect()
-        {
-            AddStep("create mod select", () =>
-            {
-                Child = modSelect = new TestModSelectOverlay
-                {
-                    Origin = Anchor.BottomCentre,
-                    Anchor = Anchor.BottomCentre,
-                    SelectedMods = { BindTarget = SelectedMods }
-                };
-            });
-        }
-
-        private void openModSelect()
-        {
-            AddStep("open", () => modSelect.Show());
-            AddUntilStep("wait for ready", () => modSelect.State.Value == Visibility.Visible && modSelect.ButtonsLoaded);
-        }
-
-        private class TestModSelectOverlay : UserModSelectOverlay
-        {
-            public new VisibilityContainer ModSettingsContainer => base.ModSettingsContainer;
-            public new TriangleButton CustomiseButton => base.CustomiseButton;
-
-            public bool ButtonsLoaded => ModSectionsContainer.Children.All(c => c.ModIconsLoaded);
-
-            public ModButton GetModButton(Mod mod)
-            {
-                return ModSectionsContainer.ChildrenOfType<ModButton>().Single(b => b.Mods.Any(m => m.GetType() == mod.GetType()));
-            }
-
-            public void SelectMod(Mod mod) =>
-                GetModButton(mod).SelectNext(1);
-
-            public void SetModSettingsWidth(float newWidth) =>
-                ModSettingsContainer.Parent.Width = newWidth;
-        }
     }
 }
diff --git a/osu.Game/Overlays/Mods/IncompatibilityDisplayingModButton.cs b/osu.Game/Overlays/Mods/IncompatibilityDisplayingModButton.cs
deleted file mode 100644
index 6e2cb40596..0000000000
--- a/osu.Game/Overlays/Mods/IncompatibilityDisplayingModButton.cs
+++ /dev/null
@@ -1,66 +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.Collections.Generic;
-using System.Linq;
-using osu.Framework.Allocation;
-using osu.Framework.Bindables;
-using osu.Framework.Graphics;
-using osu.Framework.Graphics.Containers;
-using osu.Framework.Graphics.Cursor;
-using osu.Game.Rulesets.Mods;
-using osu.Game.Utils;
-using osuTK;
-
-namespace osu.Game.Overlays.Mods
-{
-    public class IncompatibilityDisplayingModButton : ModButton
-    {
-        private readonly CompositeDrawable incompatibleIcon;
-
-        [Resolved]
-        private Bindable<IReadOnlyList<Mod>> selectedMods { get; set; }
-
-        public IncompatibilityDisplayingModButton(Mod mod)
-            : base(mod)
-        {
-            ButtonContent.Add(incompatibleIcon = new IncompatibleIcon
-            {
-                Anchor = Anchor.BottomRight,
-                Origin = Anchor.Centre,
-                Position = new Vector2(-13),
-            });
-        }
-
-        protected override void LoadComplete()
-        {
-            base.LoadComplete();
-
-            selectedMods.BindValueChanged(_ => Scheduler.AddOnce(updateCompatibility), true);
-        }
-
-        protected override void DisplayMod(Mod mod)
-        {
-            base.DisplayMod(mod);
-
-            Scheduler.AddOnce(updateCompatibility);
-        }
-
-        private void updateCompatibility()
-        {
-            var m = SelectedMod ?? Mods.First();
-
-            bool isIncompatible = false;
-
-            if (selectedMods.Value.Count > 0 && !selectedMods.Value.Contains(m))
-                isIncompatible = !ModUtils.CheckCompatibleSet(selectedMods.Value.Append(m));
-
-            if (isIncompatible)
-                incompatibleIcon.Show();
-            else
-                incompatibleIcon.Hide();
-        }
-
-        public override ITooltip<Mod> GetCustomTooltip() => new IncompatibilityDisplayingTooltip();
-    }
-}
diff --git a/osu.Game/Overlays/Mods/UserModSelectOverlay.cs b/osu.Game/Overlays/Mods/UserModSelectOverlay.cs
deleted file mode 100644
index 161f89c2eb..0000000000
--- a/osu.Game/Overlays/Mods/UserModSelectOverlay.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.Game.Rulesets.Mods;
-
-namespace osu.Game.Overlays.Mods
-{
-    public class UserModSelectOverlay : ModSelectOverlay
-    {
-        protected override void OnModSelected(Mod mod)
-        {
-            base.OnModSelected(mod);
-
-            foreach (var section in ModSectionsContainer.Children)
-                section.DeselectTypes(mod.IncompatibleMods, true, mod);
-        }
-
-        protected override ModSection CreateModSection(ModType type) => new UserModSection(type);
-
-        private class UserModSection : ModSection
-        {
-            public UserModSection(ModType type)
-                : base(type)
-            {
-            }
-
-            protected override ModButton CreateModButton(Mod mod) => new IncompatibilityDisplayingModButton(mod);
-        }
-    }
-}

From 128468e13d87aa8f2ed54ddb4264732b96c2b1ad Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 10 May 2022 21:52:30 +0200
Subject: [PATCH 4749/5547] Remove old base mod select overlay

---
 osu.Game/Overlays/Mods/ModSelectOverlay.cs | 532 ---------------------
 1 file changed, 532 deletions(-)
 delete mode 100644 osu.Game/Overlays/Mods/ModSelectOverlay.cs

diff --git a/osu.Game/Overlays/Mods/ModSelectOverlay.cs b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
deleted file mode 100644
index cf57322594..0000000000
--- a/osu.Game/Overlays/Mods/ModSelectOverlay.cs
+++ /dev/null
@@ -1,532 +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 JetBrains.Annotations;
-using osu.Framework.Allocation;
-using osu.Framework.Audio;
-using osu.Framework.Audio.Sample;
-using osu.Framework.Bindables;
-using osu.Framework.Extensions.Color4Extensions;
-using osu.Framework.Graphics;
-using osu.Framework.Graphics.Containers;
-using osu.Framework.Graphics.Shapes;
-using osu.Framework.Input.Events;
-using osu.Game.Graphics;
-using osu.Game.Graphics.Backgrounds;
-using osu.Game.Graphics.Containers;
-using osu.Game.Graphics.Sprites;
-using osu.Game.Graphics.UserInterface;
-using osu.Game.Input.Bindings;
-using osu.Game.Resources.Localisation.Web;
-using osu.Game.Rulesets.Mods;
-using osu.Game.Screens;
-using osu.Game.Utils;
-using osuTK;
-using osuTK.Graphics;
-using osuTK.Input;
-
-namespace osu.Game.Overlays.Mods
-{
-    public abstract class ModSelectOverlay : WaveOverlayContainer
-    {
-        public const float HEIGHT = 510;
-
-        protected readonly TriangleButton DeselectAllButton;
-        protected readonly TriangleButton CustomiseButton;
-        protected readonly TriangleButton CloseButton;
-
-        protected readonly FillFlowContainer FooterContainer;
-
-        protected override bool BlockNonPositionalInput => false;
-
-        protected override bool DimMainContent => false;
-
-        /// <summary>
-        /// Whether <see cref="Mod"/>s underneath the same <see cref="MultiMod"/> instance should appear as stacked buttons.
-        /// </summary>
-        protected virtual bool Stacked => true;
-
-        /// <summary>
-        /// Whether configurable <see cref="Mod"/>s can be configured by the local user.
-        /// </summary>
-        protected virtual bool AllowConfiguration => true;
-
-        [NotNull]
-        private Func<Mod, bool> isValidMod = m => true;
-
-        /// <summary>
-        /// A function that checks whether a given mod is selectable.
-        /// </summary>
-        [NotNull]
-        public Func<Mod, bool> IsValidMod
-        {
-            get => isValidMod;
-            set
-            {
-                isValidMod = value ?? throw new ArgumentNullException(nameof(value));
-                updateAvailableMods();
-            }
-        }
-
-        protected readonly FillFlowContainer<ModSection> ModSectionsContainer;
-
-        protected readonly ModSettingsContainer ModSettingsContainer;
-
-        [Cached]
-        public readonly Bindable<IReadOnlyList<Mod>> SelectedMods = new Bindable<IReadOnlyList<Mod>>(Array.Empty<Mod>());
-
-        private Bindable<Dictionary<ModType, IReadOnlyList<Mod>>> availableMods;
-
-        protected Color4 LowMultiplierColour;
-        protected Color4 HighMultiplierColour;
-
-        private const float content_width = 0.8f;
-        private const float footer_button_spacing = 20;
-
-        private Sample sampleOn, sampleOff;
-
-        protected ModSelectOverlay()
-        {
-            Waves.FirstWaveColour = Color4Extensions.FromHex(@"19b0e2");
-            Waves.SecondWaveColour = Color4Extensions.FromHex(@"2280a2");
-            Waves.ThirdWaveColour = Color4Extensions.FromHex(@"005774");
-            Waves.FourthWaveColour = Color4Extensions.FromHex(@"003a4e");
-
-            RelativeSizeAxes = Axes.X;
-            Height = HEIGHT;
-
-            Padding = new MarginPadding { Horizontal = -OsuScreen.HORIZONTAL_OVERFLOW_PADDING };
-
-            Children = new Drawable[]
-            {
-                new Container
-                {
-                    RelativeSizeAxes = Axes.Both,
-                    Masking = true,
-                    Children = new Drawable[]
-                    {
-                        new Box
-                        {
-                            RelativeSizeAxes = Axes.Both,
-                            Colour = new Color4(36, 50, 68, 255)
-                        },
-                        new Triangles
-                        {
-                            TriangleScale = 5,
-                            RelativeSizeAxes = Axes.Both,
-                            ColourLight = new Color4(53, 66, 82, 255),
-                            ColourDark = new Color4(41, 54, 70, 255),
-                        },
-                    },
-                },
-                new GridContainer
-                {
-                    RelativeSizeAxes = Axes.Both,
-                    Anchor = Anchor.BottomCentre,
-                    Origin = Anchor.BottomCentre,
-                    RowDimensions = new[]
-                    {
-                        new Dimension(GridSizeMode.Absolute, 90),
-                        new Dimension(),
-                        new Dimension(GridSizeMode.AutoSize),
-                    },
-                    Content = new[]
-                    {
-                        new Drawable[]
-                        {
-                            new Container
-                            {
-                                RelativeSizeAxes = Axes.Both,
-                                Origin = Anchor.TopCentre,
-                                Anchor = Anchor.TopCentre,
-                                Children = new Drawable[]
-                                {
-                                    new Box
-                                    {
-                                        RelativeSizeAxes = Axes.Both,
-                                        Colour = OsuColour.Gray(10).Opacity(100),
-                                    },
-                                    new FillFlowContainer
-                                    {
-                                        Origin = Anchor.Centre,
-                                        Anchor = Anchor.Centre,
-                                        RelativeSizeAxes = Axes.X,
-                                        AutoSizeAxes = Axes.Y,
-                                        Direction = FillDirection.Vertical,
-                                        Width = content_width,
-                                        Padding = new MarginPadding { Horizontal = OsuScreen.HORIZONTAL_OVERFLOW_PADDING },
-                                        Children = new Drawable[]
-                                        {
-                                            new OsuSpriteText
-                                            {
-                                                Text = @"Gameplay Mods",
-                                                Font = OsuFont.GetFont(size: 22, weight: FontWeight.Bold),
-                                                Shadow = true,
-                                                Margin = new MarginPadding
-                                                {
-                                                    Bottom = 4,
-                                                },
-                                            },
-                                            new OsuTextFlowContainer(text =>
-                                            {
-                                                text.Font = text.Font.With(size: 18);
-                                                text.Shadow = true;
-                                            })
-                                            {
-                                                RelativeSizeAxes = Axes.X,
-                                                AutoSizeAxes = Axes.Y,
-                                                Text = "Mods provide different ways to enjoy gameplay. Some have an effect on the score you can achieve during ranked play.\nOthers are just for fun.",
-                                            },
-                                        },
-                                    },
-                                },
-                            },
-                        },
-                        new Drawable[]
-                        {
-                            new Container
-                            {
-                                RelativeSizeAxes = Axes.Both,
-                                Children = new Drawable[]
-                                {
-                                    // Body
-                                    new OsuScrollContainer
-                                    {
-                                        ScrollbarVisible = false,
-                                        Origin = Anchor.TopCentre,
-                                        Anchor = Anchor.TopCentre,
-                                        RelativeSizeAxes = Axes.Both,
-                                        Padding = new MarginPadding
-                                        {
-                                            Vertical = 10,
-                                            Horizontal = OsuScreen.HORIZONTAL_OVERFLOW_PADDING
-                                        },
-                                        Children = new Drawable[]
-                                        {
-                                            ModSectionsContainer = new FillFlowContainer<ModSection>
-                                            {
-                                                Origin = Anchor.TopCentre,
-                                                Anchor = Anchor.TopCentre,
-                                                RelativeSizeAxes = Axes.X,
-                                                AutoSizeAxes = Axes.Y,
-                                                Spacing = new Vector2(0f, 10f),
-                                                Width = content_width,
-                                                LayoutDuration = 200,
-                                                LayoutEasing = Easing.OutQuint,
-                                                Children = new[]
-                                                {
-                                                    CreateModSection(ModType.DifficultyReduction).With(s =>
-                                                    {
-                                                        s.ToggleKeys = new[] { Key.Q, Key.W, Key.E, Key.R, Key.T, Key.Y, Key.U, Key.I, Key.O, Key.P };
-                                                        s.Action = modButtonPressed;
-                                                    }),
-                                                    CreateModSection(ModType.DifficultyIncrease).With(s =>
-                                                    {
-                                                        s.ToggleKeys = new[] { Key.A, Key.S, Key.D, Key.F, Key.G, Key.H, Key.J, Key.K, Key.L };
-                                                        s.Action = modButtonPressed;
-                                                    }),
-                                                    CreateModSection(ModType.Automation).With(s =>
-                                                    {
-                                                        s.ToggleKeys = new[] { Key.Z, Key.X, Key.C, Key.V, Key.B, Key.N, Key.M };
-                                                        s.Action = modButtonPressed;
-                                                    }),
-                                                    CreateModSection(ModType.Conversion).With(s =>
-                                                    {
-                                                        s.Action = modButtonPressed;
-                                                    }),
-                                                    CreateModSection(ModType.Fun).With(s =>
-                                                    {
-                                                        s.Action = modButtonPressed;
-                                                    }),
-                                                }
-                                            },
-                                        }
-                                    },
-                                    new Container
-                                    {
-                                        RelativeSizeAxes = Axes.Both,
-                                        Anchor = Anchor.BottomRight,
-                                        Origin = Anchor.BottomRight,
-                                        Padding = new MarginPadding(30),
-                                        Width = 0.3f,
-                                        Children = new Drawable[]
-                                        {
-                                            ModSettingsContainer = new ModSettingsContainer
-                                            {
-                                                Alpha = 0,
-                                                SelectedMods = { BindTarget = SelectedMods },
-                                            },
-                                        }
-                                    },
-                                }
-                            },
-                        },
-                        new Drawable[]
-                        {
-                            new Container
-                            {
-                                Name = "Footer content",
-                                RelativeSizeAxes = Axes.X,
-                                AutoSizeAxes = Axes.Y,
-                                Origin = Anchor.TopCentre,
-                                Anchor = Anchor.TopCentre,
-                                Children = new Drawable[]
-                                {
-                                    new Box
-                                    {
-                                        RelativeSizeAxes = Axes.Both,
-                                        Colour = new Color4(172, 20, 116, 255),
-                                        Alpha = 0.5f,
-                                    },
-                                    FooterContainer = new FillFlowContainer
-                                    {
-                                        Origin = Anchor.BottomCentre,
-                                        Anchor = Anchor.BottomCentre,
-                                        AutoSizeAxes = Axes.Y,
-                                        RelativeSizeAxes = Axes.X,
-                                        RelativePositionAxes = Axes.X,
-                                        Width = content_width,
-                                        Spacing = new Vector2(footer_button_spacing, footer_button_spacing / 2),
-                                        Padding = new MarginPadding
-                                        {
-                                            Vertical = 15,
-                                            Horizontal = OsuScreen.HORIZONTAL_OVERFLOW_PADDING
-                                        },
-                                        Children = new[]
-                                        {
-                                            DeselectAllButton = new TriangleButton
-                                            {
-                                                Width = 180,
-                                                Text = "Deselect All",
-                                                Action = deselectAll,
-                                                Origin = Anchor.CentreLeft,
-                                                Anchor = Anchor.CentreLeft,
-                                            },
-                                            CustomiseButton = new TriangleButton
-                                            {
-                                                Width = 180,
-                                                Text = "Customisation",
-                                                Action = () => ModSettingsContainer.ToggleVisibility(),
-                                                Enabled = { Value = false },
-                                                Alpha = AllowConfiguration ? 1 : 0,
-                                                Origin = Anchor.CentreLeft,
-                                                Anchor = Anchor.CentreLeft,
-                                            },
-                                            CloseButton = new TriangleButton
-                                            {
-                                                Width = 180,
-                                                Text = CommonStrings.ButtonsClose,
-                                                Action = Hide,
-                                                Origin = Anchor.CentreLeft,
-                                                Anchor = Anchor.CentreLeft,
-                                            },
-                                        }
-                                    }
-                                },
-                            }
-                        },
-                    },
-                },
-            };
-
-            ((IBindable<bool>)CustomiseButton.Enabled).BindTo(ModSettingsContainer.HasSettingsForSelection);
-        }
-
-        [BackgroundDependencyLoader(true)]
-        private void load(AudioManager audio, OsuGameBase osu)
-        {
-            availableMods = osu.AvailableMods.GetBoundCopy();
-
-            sampleOn = audio.Samples.Get(@"UI/check-on");
-            sampleOff = audio.Samples.Get(@"UI/check-off");
-        }
-
-        private void deselectAll()
-        {
-            foreach (var section in ModSectionsContainer.Children)
-                section.DeselectAll();
-
-            refreshSelectedMods();
-        }
-
-        protected override void LoadComplete()
-        {
-            base.LoadComplete();
-
-            availableMods.BindValueChanged(_ => updateAvailableMods(), true);
-
-            // intentionally bound after the above line to avoid a potential update feedback cycle.
-            // i haven't actually observed this happening but as updateAvailableMods() changes the selection it is plausible.
-            SelectedMods.BindValueChanged(_ => updateSelectedButtons());
-        }
-
-        protected override void PopOut()
-        {
-            base.PopOut();
-
-            foreach (var section in ModSectionsContainer)
-            {
-                section.FlushPendingSelections();
-            }
-
-            FooterContainer.MoveToX(content_width, WaveContainer.DISAPPEAR_DURATION, Easing.InSine);
-            FooterContainer.FadeOut(WaveContainer.DISAPPEAR_DURATION, Easing.InSine);
-
-            foreach (var section in ModSectionsContainer.Children)
-            {
-                section.ButtonsContainer.TransformSpacingTo(new Vector2(100f, 0f), WaveContainer.DISAPPEAR_DURATION, Easing.InSine);
-                section.ButtonsContainer.MoveToX(100f, WaveContainer.DISAPPEAR_DURATION, Easing.InSine);
-                section.ButtonsContainer.FadeOut(WaveContainer.DISAPPEAR_DURATION, Easing.InSine);
-            }
-        }
-
-        protected override void PopIn()
-        {
-            base.PopIn();
-
-            FooterContainer.MoveToX(0, WaveContainer.APPEAR_DURATION, Easing.OutQuint);
-            FooterContainer.FadeIn(WaveContainer.APPEAR_DURATION, Easing.OutQuint);
-
-            foreach (var section in ModSectionsContainer.Children)
-            {
-                section.ButtonsContainer.TransformSpacingTo(new Vector2(50f, 0f), WaveContainer.APPEAR_DURATION, Easing.OutQuint);
-                section.ButtonsContainer.MoveToX(0, WaveContainer.APPEAR_DURATION, Easing.OutQuint);
-                section.ButtonsContainer.FadeIn(WaveContainer.APPEAR_DURATION, Easing.OutQuint);
-            }
-        }
-
-        protected override bool OnKeyDown(KeyDownEvent e)
-        {
-            // don't absorb control as ToolbarRulesetSelector uses control + number to navigate
-            if (e.ControlPressed) return false;
-
-            switch (e.Key)
-            {
-                case Key.Number1:
-                    DeselectAllButton.TriggerClick();
-                    return true;
-
-                case Key.Number2:
-                    CloseButton.TriggerClick();
-                    return true;
-            }
-
-            return base.OnKeyDown(e);
-        }
-
-        public override bool OnPressed(KeyBindingPressEvent<GlobalAction> e) => false; // handled by back button
-
-        private void updateAvailableMods()
-        {
-            if (availableMods?.Value == null)
-                return;
-
-            foreach (var section in ModSectionsContainer.Children)
-            {
-                IEnumerable<Mod> modEnumeration = availableMods.Value[section.ModType];
-
-                if (!Stacked)
-                    modEnumeration = ModUtils.FlattenMods(modEnumeration);
-
-                section.Mods = modEnumeration.Select(getValidModOrNull).Where(m => m != null).Select(m => m.DeepClone());
-            }
-
-            updateSelectedButtons();
-            OnAvailableModsChanged();
-        }
-
-        /// <summary>
-        /// Returns a valid form of a given <see cref="Mod"/> if possible, or null otherwise.
-        /// </summary>
-        /// <remarks>
-        /// This is a recursive process during which any invalid mods are culled while preserving <see cref="MultiMod"/> structures where possible.
-        /// </remarks>
-        /// <param name="mod">The <see cref="Mod"/> to check.</param>
-        /// <returns>A valid form of <paramref name="mod"/> if exists, or null otherwise.</returns>
-        [CanBeNull]
-        private Mod getValidModOrNull([NotNull] Mod mod)
-        {
-            if (!(mod is MultiMod multi))
-                return IsValidMod(mod) ? mod : null;
-
-            var validSubset = multi.Mods.Select(getValidModOrNull).Where(m => m != null).ToArray();
-
-            if (validSubset.Length == 0)
-                return null;
-
-            return validSubset.Length == 1 ? validSubset[0] : new MultiMod(validSubset);
-        }
-
-        private void updateSelectedButtons()
-        {
-            // Enumeration below may update the bindable list.
-            var selectedMods = SelectedMods.Value.ToList();
-
-            foreach (var section in ModSectionsContainer.Children)
-                section.UpdateSelectedButtons(selectedMods);
-        }
-
-        private void modButtonPressed(Mod selectedMod)
-        {
-            if (selectedMod != null)
-            {
-                if (State.Value == Visibility.Visible)
-                    Scheduler.AddOnce(playSelectedSound);
-
-                OnModSelected(selectedMod);
-
-                if (selectedMod.RequiresConfiguration && AllowConfiguration)
-                    ModSettingsContainer.Show();
-            }
-            else
-            {
-                if (State.Value == Visibility.Visible)
-                    Scheduler.AddOnce(playDeselectedSound);
-            }
-
-            refreshSelectedMods();
-        }
-
-        private void playSelectedSound() => sampleOn?.Play();
-        private void playDeselectedSound() => sampleOff?.Play();
-
-        /// <summary>
-        /// Invoked after <see cref="availableMods"/> has changed.
-        /// </summary>
-        protected virtual void OnAvailableModsChanged()
-        {
-        }
-
-        /// <summary>
-        /// Invoked when a new <see cref="Mod"/> has been selected.
-        /// </summary>
-        /// <param name="mod">The <see cref="Mod"/> that has been selected.</param>
-        protected virtual void OnModSelected(Mod mod)
-        {
-        }
-
-        private void refreshSelectedMods() => SelectedMods.Value = ModSectionsContainer.Children.SelectMany(s => s.SelectedMods).ToArray();
-
-        /// <summary>
-        /// Creates a <see cref="ModSection"/> that groups <see cref="Mod"/>s with the same <see cref="ModType"/>.
-        /// </summary>
-        /// <param name="type">The <see cref="ModType"/> of <see cref="Mod"/>s in the section.</param>
-        /// <returns>The <see cref="ModSection"/>.</returns>
-        protected virtual ModSection CreateModSection(ModType type) => new ModSection(type);
-
-        #region Disposal
-
-        protected override void Dispose(bool isDisposing)
-        {
-            base.Dispose(isDisposing);
-
-            availableMods?.UnbindAll();
-            SelectedMods?.UnbindAll();
-        }
-
-        #endregion
-    }
-}

From dfd97701d7d17ca559f0d681d8a669cbe2cafb19 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 10 May 2022 21:53:42 +0200
Subject: [PATCH 4750/5547] Remove old mod settings container & related
 controls

---
 osu.Game/Overlays/Mods/ModControlSection.cs   |  54 ---------
 .../Overlays/Mods/ModSettingsContainer.cs     | 111 ------------------
 2 files changed, 165 deletions(-)
 delete mode 100644 osu.Game/Overlays/Mods/ModControlSection.cs
 delete mode 100644 osu.Game/Overlays/Mods/ModSettingsContainer.cs

diff --git a/osu.Game/Overlays/Mods/ModControlSection.cs b/osu.Game/Overlays/Mods/ModControlSection.cs
deleted file mode 100644
index 10b3bc7c2b..0000000000
--- a/osu.Game/Overlays/Mods/ModControlSection.cs
+++ /dev/null
@@ -1,54 +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.Collections.Generic;
-using osu.Framework.Allocation;
-using osu.Framework.Graphics;
-using osu.Framework.Graphics.Containers;
-using osu.Game.Graphics;
-using osu.Game.Graphics.Sprites;
-using osu.Game.Rulesets.Mods;
-using osuTK;
-
-namespace osu.Game.Overlays.Mods
-{
-    public class ModControlSection : CompositeDrawable
-    {
-        protected FillFlowContainer FlowContent;
-
-        public readonly Mod Mod;
-
-        public ModControlSection(Mod mod, IEnumerable<Drawable> modControls)
-        {
-            Mod = mod;
-
-            RelativeSizeAxes = Axes.X;
-            AutoSizeAxes = Axes.Y;
-
-            FlowContent = new FillFlowContainer
-            {
-                Margin = new MarginPadding { Top = 30 },
-                Spacing = new Vector2(0, 5),
-                Direction = FillDirection.Vertical,
-                AutoSizeAxes = Axes.Y,
-                RelativeSizeAxes = Axes.X,
-                ChildrenEnumerable = modControls
-            };
-        }
-
-        [BackgroundDependencyLoader]
-        private void load(OsuColour colours)
-        {
-            AddRangeInternal(new Drawable[]
-            {
-                new OsuSpriteText
-                {
-                    Text = Mod.Name,
-                    Font = OsuFont.GetFont(weight: FontWeight.Bold),
-                    Colour = colours.Yellow,
-                },
-                FlowContent
-            });
-        }
-    }
-}
diff --git a/osu.Game/Overlays/Mods/ModSettingsContainer.cs b/osu.Game/Overlays/Mods/ModSettingsContainer.cs
deleted file mode 100644
index 64d65cab3b..0000000000
--- a/osu.Game/Overlays/Mods/ModSettingsContainer.cs
+++ /dev/null
@@ -1,111 +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.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.Graphics.Containers;
-using osu.Game.Rulesets.Mods;
-using osuTK;
-using osuTK.Graphics;
-
-namespace osu.Game.Overlays.Mods
-{
-    public class ModSettingsContainer : VisibilityContainer
-    {
-        public readonly IBindable<IReadOnlyList<Mod>> SelectedMods = new Bindable<IReadOnlyList<Mod>>(Array.Empty<Mod>());
-
-        public IBindable<bool> HasSettingsForSelection => hasSettingsForSelection;
-
-        private readonly Bindable<bool> hasSettingsForSelection = new Bindable<bool>();
-
-        private readonly FillFlowContainer<ModControlSection> modSettingsContent;
-
-        private readonly Container content;
-
-        private const double transition_duration = 400;
-
-        public ModSettingsContainer()
-        {
-            RelativeSizeAxes = Axes.Both;
-
-            Child = content = new Container
-            {
-                Masking = true,
-                CornerRadius = 10,
-                RelativeSizeAxes = Axes.Both,
-                RelativePositionAxes = Axes.Both,
-                X = 1,
-                Children = new Drawable[]
-                {
-                    new Box
-                    {
-                        RelativeSizeAxes = Axes.Both,
-                        Colour = new Color4(0, 0, 0, 192)
-                    },
-                    new OsuScrollContainer
-                    {
-                        RelativeSizeAxes = Axes.Both,
-                        ScrollbarVisible = false,
-                        Child = modSettingsContent = new FillFlowContainer<ModControlSection>
-                        {
-                            Anchor = Anchor.TopCentre,
-                            Origin = Anchor.TopCentre,
-                            RelativeSizeAxes = Axes.X,
-                            AutoSizeAxes = Axes.Y,
-                            Spacing = new Vector2(0f, 10f),
-                            Padding = new MarginPadding(20),
-                        }
-                    }
-                }
-            };
-        }
-
-        protected override void LoadComplete()
-        {
-            base.LoadComplete();
-
-            SelectedMods.BindValueChanged(modsChanged, true);
-        }
-
-        private void modsChanged(ValueChangedEvent<IReadOnlyList<Mod>> mods)
-        {
-            modSettingsContent.Clear();
-
-            foreach (var mod in mods.NewValue)
-            {
-                var settings = mod.CreateSettingsControls().ToList();
-                if (settings.Count > 0)
-                    modSettingsContent.Add(new ModControlSection(mod, settings));
-            }
-
-            bool hasSettings = modSettingsContent.Count > 0;
-
-            if (!hasSettings)
-                Hide();
-
-            hasSettingsForSelection.Value = hasSettings;
-        }
-
-        protected override bool OnMouseDown(MouseDownEvent e) => true;
-        protected override bool OnHover(HoverEvent e) => true;
-
-        protected override void PopIn()
-        {
-            this.FadeIn(transition_duration, Easing.OutQuint);
-            content.MoveToX(0, transition_duration, Easing.OutQuint);
-        }
-
-        protected override void PopOut()
-        {
-            this.FadeOut(transition_duration, Easing.OutQuint);
-            content.MoveToX(1, transition_duration, Easing.OutQuint);
-        }
-    }
-}

From 8b0ece1c09df40506f813a125bbd9c2f78546eb8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 10 May 2022 21:55:54 +0200
Subject: [PATCH 4751/5547] Remove old mod section

---
 osu.Game/Overlays/Mods/ModSection.cs | 261 ---------------------------
 1 file changed, 261 deletions(-)
 delete mode 100644 osu.Game/Overlays/Mods/ModSection.cs

diff --git a/osu.Game/Overlays/Mods/ModSection.cs b/osu.Game/Overlays/Mods/ModSection.cs
deleted file mode 100644
index a70191a864..0000000000
--- a/osu.Game/Overlays/Mods/ModSection.cs
+++ /dev/null
@@ -1,261 +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 osuTK;
-using osuTK.Input;
-using osu.Framework.Graphics;
-using osu.Framework.Graphics.Containers;
-using osu.Game.Graphics.Sprites;
-using osu.Game.Rulesets.Mods;
-using System;
-using System.Linq;
-using System.Collections.Generic;
-using System.Threading;
-using Humanizer;
-using osu.Framework.Input.Events;
-using osu.Game.Graphics;
-
-namespace osu.Game.Overlays.Mods
-{
-    public class ModSection : CompositeDrawable
-    {
-        private readonly Drawable header;
-
-        public FillFlowContainer<ModButtonEmpty> ButtonsContainer { get; }
-
-        protected IReadOnlyList<ModButton> Buttons { get; private set; } = Array.Empty<ModButton>();
-
-        public Action<Mod> Action;
-
-        public Key[] ToggleKeys;
-
-        public readonly ModType ModType;
-
-        public IEnumerable<Mod> SelectedMods => Buttons.Select(b => b.SelectedMod).Where(m => m != null);
-
-        private CancellationTokenSource modsLoadCts;
-
-        protected bool SelectionAnimationRunning => pendingSelectionOperations.Count > 0;
-
-        /// <summary>
-        /// True when all mod icons have completed loading.
-        /// </summary>
-        public bool ModIconsLoaded { get; private set; } = true;
-
-        public IEnumerable<Mod> Mods
-        {
-            set
-            {
-                var modContainers = value.Select(m =>
-                {
-                    if (m == null)
-                        return new ModButtonEmpty();
-
-                    return CreateModButton(m).With(b =>
-                    {
-                        b.SelectionChanged = mod =>
-                        {
-                            ModButtonStateChanged(mod);
-                            Action?.Invoke(mod);
-                        };
-                    });
-                }).ToArray();
-
-                modsLoadCts?.Cancel();
-
-                if (modContainers.Length == 0)
-                {
-                    ModIconsLoaded = true;
-                    header.Hide();
-                    Hide();
-                    return;
-                }
-
-                ModIconsLoaded = false;
-
-                LoadComponentsAsync(modContainers, c =>
-                {
-                    ModIconsLoaded = true;
-                    ButtonsContainer.ChildrenEnumerable = c;
-                }, (modsLoadCts = new CancellationTokenSource()).Token);
-
-                Buttons = modContainers.OfType<ModButton>().ToArray();
-
-                header.FadeIn(200);
-                this.FadeIn(200);
-            }
-        }
-
-        protected virtual void ModButtonStateChanged(Mod mod)
-        {
-        }
-
-        protected override bool OnKeyDown(KeyDownEvent e)
-        {
-            if (e.ControlPressed) return false;
-
-            if (ToggleKeys != null)
-            {
-                int index = Array.IndexOf(ToggleKeys, e.Key);
-                if (index > -1 && index < Buttons.Count)
-                    Buttons[index].SelectNext(e.ShiftPressed ? -1 : 1);
-            }
-
-            return base.OnKeyDown(e);
-        }
-
-        private const double initial_multiple_selection_delay = 120;
-
-        private double selectionDelay = initial_multiple_selection_delay;
-        private double lastSelection;
-
-        private readonly Queue<Action> pendingSelectionOperations = new Queue<Action>();
-
-        protected override void Update()
-        {
-            base.Update();
-
-            if (selectionDelay == initial_multiple_selection_delay || Time.Current - lastSelection >= selectionDelay)
-            {
-                if (pendingSelectionOperations.TryDequeue(out var dequeuedAction))
-                {
-                    dequeuedAction();
-
-                    // each time we play an animation, we decrease the time until the next animation (to ramp the visual and audible elements).
-                    selectionDelay = Math.Max(30, selectionDelay * 0.8f);
-                    lastSelection = Time.Current;
-                }
-                else
-                {
-                    // reset the selection delay after all animations have been completed.
-                    // this will cause the next action to be immediately performed.
-                    selectionDelay = initial_multiple_selection_delay;
-                }
-            }
-        }
-
-        /// <summary>
-        /// Selects all mods.
-        /// </summary>
-        public void SelectAll()
-        {
-            pendingSelectionOperations.Clear();
-
-            foreach (var button in Buttons.Where(b => !b.Selected))
-                pendingSelectionOperations.Enqueue(() => button.SelectAt(0));
-        }
-
-        /// <summary>
-        /// Deselects all mods.
-        /// </summary>
-        public void DeselectAll()
-        {
-            pendingSelectionOperations.Clear();
-            DeselectTypes(Buttons.Select(b => b.SelectedMod?.GetType()).Where(t => t != null));
-        }
-
-        /// <summary>
-        /// Deselect one or more mods in this section.
-        /// </summary>
-        /// <param name="modTypes">The types of <see cref="Mod"/>s which should be deselected.</param>
-        /// <param name="immediate">Whether the deselection should happen immediately. Should only be used when required to ensure correct selection flow.</param>
-        /// <param name="newSelection">If this deselection is triggered by a user selection, this should contain the newly selected type. This type will never be deselected, even if it matches one provided in <paramref name="modTypes"/>.</param>
-        public void DeselectTypes(IEnumerable<Type> modTypes, bool immediate = false, Mod newSelection = null)
-        {
-            foreach (var button in Buttons)
-            {
-                if (button.SelectedMod == null) continue;
-
-                if (button.SelectedMod == newSelection)
-                    continue;
-
-                foreach (var type in modTypes)
-                {
-                    if (type.IsInstanceOfType(button.SelectedMod))
-                    {
-                        if (immediate)
-                            button.Deselect();
-                        else
-                            pendingSelectionOperations.Enqueue(button.Deselect);
-                    }
-                }
-            }
-        }
-
-        /// <summary>
-        /// Updates all buttons with the given list of selected mods.
-        /// </summary>
-        /// <param name="newSelectedMods">The new list of selected mods to select.</param>
-        public void UpdateSelectedButtons(IReadOnlyList<Mod> newSelectedMods)
-        {
-            foreach (var button in Buttons)
-                updateButtonSelection(button, newSelectedMods);
-        }
-
-        private void updateButtonSelection(ModButton button, IReadOnlyList<Mod> newSelectedMods)
-        {
-            foreach (var mod in newSelectedMods)
-            {
-                int index = Array.FindIndex(button.Mods, m1 => mod.GetType() == m1.GetType());
-                if (index < 0)
-                    continue;
-
-                var buttonMod = button.Mods[index];
-
-                // as this is likely coming from an external change, ensure the settings of the mod are in sync.
-                buttonMod.CopyFrom(mod);
-
-                button.SelectAt(index, false);
-                return;
-            }
-
-            button.Deselect();
-        }
-
-        public ModSection(ModType type)
-        {
-            ModType = type;
-
-            AutoSizeAxes = Axes.Y;
-            RelativeSizeAxes = Axes.X;
-
-            Origin = Anchor.TopCentre;
-            Anchor = Anchor.TopCentre;
-
-            InternalChildren = new[]
-            {
-                header = CreateHeader(type.Humanize(LetterCasing.Title)),
-                ButtonsContainer = new FillFlowContainer<ModButtonEmpty>
-                {
-                    AutoSizeAxes = Axes.Y,
-                    RelativeSizeAxes = Axes.X,
-                    Origin = Anchor.BottomLeft,
-                    Anchor = Anchor.BottomLeft,
-                    Spacing = new Vector2(50f, 0f),
-                    Margin = new MarginPadding
-                    {
-                        Top = 20,
-                    },
-                    AlwaysPresent = true
-                },
-            };
-        }
-
-        protected virtual Drawable CreateHeader(string text) => new OsuSpriteText
-        {
-            Font = OsuFont.GetFont(weight: FontWeight.Bold),
-            Text = text
-        };
-
-        protected virtual ModButton CreateModButton(Mod mod) => new ModButton(mod);
-
-        /// <summary>
-        /// Run any delayed selections (due to animation) immediately to leave mods in a good (final) state.
-        /// </summary>
-        public void FlushPendingSelections()
-        {
-            while (pendingSelectionOperations.TryDequeue(out var dequeuedAction))
-                dequeuedAction();
-        }
-    }
-}

From 33634cba1eb7badf4821c04a7a21954b55d7f11d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 10 May 2022 21:58:22 +0200
Subject: [PATCH 4752/5547] Remove old mod buttons

---
 .../UserInterface/TestSceneModButton.cs       |  64 ----
 osu.Game/Overlays/Mods/IncompatibleIcon.cs    |  64 ----
 osu.Game/Overlays/Mods/ModButton.cs           | 319 ------------------
 osu.Game/Overlays/Mods/ModButtonEmpty.cs      |  20 --
 4 files changed, 467 deletions(-)
 delete mode 100644 osu.Game.Tests/Visual/UserInterface/TestSceneModButton.cs
 delete mode 100644 osu.Game/Overlays/Mods/IncompatibleIcon.cs
 delete mode 100644 osu.Game/Overlays/Mods/ModButton.cs
 delete mode 100644 osu.Game/Overlays/Mods/ModButtonEmpty.cs

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneModButton.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneModButton.cs
deleted file mode 100644
index fdc21d80ff..0000000000
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneModButton.cs
+++ /dev/null
@@ -1,64 +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.Sprites;
-using osu.Game.Overlays.Mods;
-using osu.Game.Rulesets.Mods;
-
-namespace osu.Game.Tests.Visual.UserInterface
-{
-    public class TestSceneModButton : OsuTestScene
-    {
-        public TestSceneModButton()
-        {
-            Children = new Drawable[]
-            {
-                new ModButton(new MultiMod(new TestMod1(), new TestMod2(), new TestMod3(), new TestMod4()))
-                {
-                    Anchor = Anchor.Centre,
-                    Origin = Anchor.Centre
-                }
-            };
-        }
-
-        private class TestMod1 : TestMod
-        {
-            public override string Name => "Test mod 1";
-
-            public override string Acronym => "M1";
-        }
-
-        private class TestMod2 : TestMod
-        {
-            public override string Name => "Test mod 2";
-
-            public override string Acronym => "M2";
-
-            public override IconUsage? Icon => FontAwesome.Solid.Exclamation;
-        }
-
-        private class TestMod3 : TestMod
-        {
-            public override string Name => "Test mod 3";
-
-            public override string Acronym => "M3";
-
-            public override IconUsage? Icon => FontAwesome.Solid.ArrowRight;
-        }
-
-        private class TestMod4 : TestMod
-        {
-            public override string Name => "Test mod 4";
-
-            public override string Acronym => "M4";
-        }
-
-        private abstract class TestMod : Mod, IApplicableMod
-        {
-            public override double ScoreMultiplier => 1.0;
-
-            public override string Description => "This is a test mod.";
-        }
-    }
-}
diff --git a/osu.Game/Overlays/Mods/IncompatibleIcon.cs b/osu.Game/Overlays/Mods/IncompatibleIcon.cs
deleted file mode 100644
index df134fe4a4..0000000000
--- a/osu.Game/Overlays/Mods/IncompatibleIcon.cs
+++ /dev/null
@@ -1,64 +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.Graphics;
-using osu.Framework.Graphics.Containers;
-using osu.Framework.Graphics.Cursor;
-using osu.Framework.Graphics.Shapes;
-using osu.Framework.Graphics.Sprites;
-using osu.Framework.Localisation;
-using osu.Game.Graphics;
-using osuTK;
-using osuTK.Graphics;
-
-namespace osu.Game.Overlays.Mods
-{
-    public class IncompatibleIcon : VisibilityContainer, IHasTooltip
-    {
-        private Circle circle;
-
-        [BackgroundDependencyLoader]
-        private void load(OsuColour colours)
-        {
-            Size = new Vector2(20);
-
-            State.Value = Visibility.Hidden;
-            Alpha = 0;
-
-            InternalChildren = new Drawable[]
-            {
-                circle = new Circle
-                {
-                    RelativeSizeAxes = Axes.Both,
-                    Colour = colours.Gray4,
-                },
-                new SpriteIcon
-                {
-                    RelativeSizeAxes = Axes.Both,
-                    Origin = Anchor.Centre,
-                    Anchor = Anchor.Centre,
-                    Size = new Vector2(0.6f),
-                    Icon = FontAwesome.Solid.Slash,
-                    Colour = Color4.White,
-                    Shadow = true,
-                }
-            };
-        }
-
-        protected override void PopIn()
-        {
-            this.FadeIn(200, Easing.OutQuint);
-            circle.FlashColour(Color4.Red, 500, Easing.OutQuint);
-            this.ScaleTo(1.8f).Then().ScaleTo(1, 500, Easing.OutQuint);
-        }
-
-        protected override void PopOut()
-        {
-            this.FadeOut(200, Easing.OutQuint);
-            this.ScaleTo(0.8f, 200, Easing.In);
-        }
-
-        public LocalisableString TooltipText => "Incompatible with current selected mods";
-    }
-}
diff --git a/osu.Game/Overlays/Mods/ModButton.cs b/osu.Game/Overlays/Mods/ModButton.cs
deleted file mode 100644
index 979e2c8da3..0000000000
--- a/osu.Game/Overlays/Mods/ModButton.cs
+++ /dev/null
@@ -1,319 +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 osuTK;
-using osuTK.Graphics;
-using osuTK.Input;
-using osu.Framework.Graphics;
-using osu.Framework.Graphics.Containers;
-using osu.Framework.Graphics.Sprites;
-using osu.Game.Graphics.Sprites;
-using osu.Game.Rulesets.Mods;
-using osu.Game.Rulesets.UI;
-using System;
-using System.Linq;
-using osu.Framework.Graphics.Cursor;
-using osu.Framework.Input.Events;
-using osu.Framework.Localisation;
-using osu.Game.Graphics;
-using osu.Game.Graphics.UserInterface;
-
-namespace osu.Game.Overlays.Mods
-{
-    /// <summary>
-    /// Represents a clickable button which can cycle through one of more mods.
-    /// </summary>
-    public class ModButton : ModButtonEmpty, IHasCustomTooltip<Mod>
-    {
-        private ModIcon foregroundIcon;
-        private ModIcon backgroundIcon;
-        private readonly SpriteText text;
-        private readonly Container<ModIcon> iconsContainer;
-
-        /// <summary>
-        /// Fired when the selection changes.
-        /// </summary>
-        public Action<Mod> SelectionChanged;
-
-        public LocalisableString TooltipText => (SelectedMod?.Description ?? Mods.FirstOrDefault()?.Description) ?? string.Empty;
-
-        private const Easing mod_switch_easing = Easing.InOutSine;
-        private const double mod_switch_duration = 120;
-
-        // A selected index of -1 means not selected.
-        private int selectedIndex = -1;
-
-        /// <summary>
-        /// Change the selected mod index of this button.
-        /// </summary>
-        /// <param name="newIndex">The new index.</param>
-        /// <param name="resetSettings">Whether any settings applied to the mod should be reset on selection.</param>
-        /// <returns>Whether the selection changed.</returns>
-        private bool changeSelectedIndex(int newIndex, bool resetSettings = true)
-        {
-            if (newIndex == selectedIndex) return false;
-
-            int direction = newIndex < selectedIndex ? -1 : 1;
-
-            bool beforeSelected = Selected;
-
-            Mod previousSelection = SelectedMod ?? Mods[0];
-
-            if (newIndex >= Mods.Length)
-                newIndex = -1;
-            else if (newIndex < -1)
-                newIndex = Mods.Length - 1;
-
-            if (newIndex >= 0 && !Mods[newIndex].HasImplementation)
-                return false;
-
-            selectedIndex = newIndex;
-
-            Mod newSelection = SelectedMod ?? Mods[0];
-
-            if (resetSettings)
-                newSelection.ResetSettingsToDefaults();
-
-            Schedule(() =>
-            {
-                if (beforeSelected != Selected)
-                {
-                    iconsContainer.RotateTo(Selected ? 5f : 0f, 300, Easing.OutElastic);
-                    iconsContainer.ScaleTo(Selected ? 1.1f : 1f, 300, Easing.OutElastic);
-                }
-
-                if (previousSelection != newSelection)
-                {
-                    const float rotate_angle = 16;
-
-                    foregroundIcon.RotateTo(rotate_angle * direction, mod_switch_duration, mod_switch_easing);
-                    backgroundIcon.RotateTo(-rotate_angle * direction, mod_switch_duration, mod_switch_easing);
-
-                    backgroundIcon.Mod = newSelection;
-
-                    using (BeginDelayedSequence(mod_switch_duration))
-                    {
-                        foregroundIcon
-                            .RotateTo(-rotate_angle * direction)
-                            .RotateTo(0f, mod_switch_duration, mod_switch_easing);
-
-                        backgroundIcon
-                            .RotateTo(rotate_angle * direction)
-                            .RotateTo(0f, mod_switch_duration, mod_switch_easing);
-
-                        Schedule(() => DisplayMod(newSelection));
-                    }
-                }
-
-                foregroundIcon.Selected.Value = Selected;
-            });
-
-            SelectionChanged?.Invoke(SelectedMod);
-
-            return true;
-        }
-
-        public bool Selected => selectedIndex != -1;
-
-        private Color4 selectedColour;
-
-        public Color4 SelectedColour
-        {
-            get => selectedColour;
-            set
-            {
-                if (value == selectedColour) return;
-
-                selectedColour = value;
-                if (Selected) foregroundIcon.Colour = value;
-            }
-        }
-
-        private Mod mod;
-
-        protected readonly Container ButtonContent;
-
-        public Mod Mod
-        {
-            get => mod;
-            set
-            {
-                mod = value;
-
-                if (mod == null)
-                {
-                    Mods = Array.Empty<Mod>();
-                    Alpha = 0;
-                }
-                else
-                {
-                    Mods = (mod as MultiMod)?.Mods ?? new[] { mod };
-                    Alpha = 1;
-                }
-
-                createIcons();
-
-                if (Mods.Length > 0)
-                {
-                    DisplayMod(Mods[0]);
-                }
-            }
-        }
-
-        public Mod[] Mods { get; private set; }
-
-        public virtual Mod SelectedMod => Mods.ElementAtOrDefault(selectedIndex);
-
-        protected override bool OnMouseDown(MouseDownEvent e)
-        {
-            ButtonContent.ScaleTo(0.9f, 800, Easing.Out);
-            return base.OnMouseDown(e);
-        }
-
-        protected override void OnMouseUp(MouseUpEvent e)
-        {
-            ButtonContent.ScaleTo(1, 500, Easing.OutElastic);
-
-            // only trigger the event if we are inside the area of the button
-            if (Contains(e.ScreenSpaceMousePosition))
-            {
-                switch (e.Button)
-                {
-                    case MouseButton.Right:
-                        SelectNext(-1);
-                        break;
-                }
-            }
-        }
-
-        protected override bool OnClick(ClickEvent e)
-        {
-            SelectNext(1);
-
-            return true;
-        }
-
-        /// <summary>
-        /// Select the next available mod in a specified direction.
-        /// </summary>
-        /// <param name="direction">1 for forwards, -1 for backwards.</param>
-        public void SelectNext(int direction)
-        {
-            int start = selectedIndex + direction;
-            // wrap around if we are at an extremity.
-            if (start >= Mods.Length)
-                start = -1;
-            else if (start < -1)
-                start = Mods.Length - 1;
-
-            for (int i = start; i < Mods.Length && i >= 0; i += direction)
-            {
-                if (SelectAt(i))
-                    return;
-            }
-
-            Deselect();
-        }
-
-        /// <summary>
-        /// Select the mod at the provided index.
-        /// </summary>
-        /// <param name="index">The index to select.</param>
-        /// <param name="resetSettings">Whether any settings applied to the mod should be reset on selection.</param>
-        /// <returns>Whether the selection changed.</returns>
-        public bool SelectAt(int index, bool resetSettings = true)
-        {
-            if (!Mods[index].HasImplementation) return false;
-
-            changeSelectedIndex(index, resetSettings);
-            return true;
-        }
-
-        public void Deselect() => changeSelectedIndex(-1);
-
-        protected virtual void DisplayMod(Mod mod)
-        {
-            if (backgroundIcon != null)
-                backgroundIcon.Mod = foregroundIcon.Mod;
-            foregroundIcon.Mod = mod;
-            text.Text = mod.Name;
-            Colour = mod.HasImplementation ? Color4.White : Color4.Gray;
-        }
-
-        private void createIcons()
-        {
-            iconsContainer.Clear();
-
-            if (Mods.Length > 1)
-            {
-                iconsContainer.AddRange(new[]
-                {
-                    backgroundIcon = new ModIcon(Mods[1], false)
-                    {
-                        Origin = Anchor.BottomRight,
-                        Anchor = Anchor.BottomRight,
-                        Position = new Vector2(1.5f),
-                    },
-                    foregroundIcon = new ModIcon(Mods[0], false)
-                    {
-                        Origin = Anchor.BottomRight,
-                        Anchor = Anchor.BottomRight,
-                        Position = new Vector2(-1.5f),
-                    },
-                });
-            }
-            else
-            {
-                iconsContainer.Add(foregroundIcon = new ModIcon(Mod, false)
-                {
-                    Origin = Anchor.Centre,
-                    Anchor = Anchor.Centre,
-                });
-            }
-        }
-
-        public ModButton(Mod mod)
-        {
-            Children = new Drawable[]
-            {
-                new Container
-                {
-                    Size = new Vector2(77f, 80f),
-                    Origin = Anchor.TopCentre,
-                    Anchor = Anchor.TopCentre,
-                    Children = new Drawable[]
-                    {
-                        ButtonContent = new Container
-                        {
-                            Children = new Drawable[]
-                            {
-                                iconsContainer = new Container<ModIcon>
-                                {
-                                    RelativeSizeAxes = Axes.Both,
-                                    Origin = Anchor.Centre,
-                                    Anchor = Anchor.Centre,
-                                },
-                            },
-                            RelativeSizeAxes = Axes.Both,
-                            Origin = Anchor.Centre,
-                            Anchor = Anchor.Centre,
-                        }
-                    }
-                },
-                text = new OsuSpriteText
-                {
-                    Y = 75,
-                    Origin = Anchor.TopCentre,
-                    Anchor = Anchor.TopCentre,
-                    Font = OsuFont.GetFont(size: 18)
-                },
-                new HoverSounds()
-            };
-            Mod = mod;
-        }
-
-        public virtual ITooltip<Mod> GetCustomTooltip() => new ModButtonTooltip();
-
-        public Mod TooltipContent => SelectedMod ?? Mods.FirstOrDefault();
-    }
-}
diff --git a/osu.Game/Overlays/Mods/ModButtonEmpty.cs b/osu.Game/Overlays/Mods/ModButtonEmpty.cs
deleted file mode 100644
index 03afe5adba..0000000000
--- a/osu.Game/Overlays/Mods/ModButtonEmpty.cs
+++ /dev/null
@@ -1,20 +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 osuTK;
-using osu.Framework.Graphics.Containers;
-
-namespace osu.Game.Overlays.Mods
-{
-    /// <summary>
-    /// A mod button used exclusively for providing an empty space the size of a mod button.
-    /// </summary>
-    public class ModButtonEmpty : Container
-    {
-        public ModButtonEmpty()
-        {
-            Size = new Vector2(100f);
-            AlwaysPresent = true;
-        }
-    }
-}

From c4c7556fb24407b7c97067729a6bd6c894a71eb5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 10 May 2022 22:07:24 +0200
Subject: [PATCH 4753/5547] Make remains of `TestSceneModSettings` non-visual

As they're not really testing anything visual.
---
 osu.Game.Tests/Mods/ModSettingsTest.cs        | 36 ++++++++++++++
 .../UserInterface/TestSceneModSettings.cs     | 49 -------------------
 2 files changed, 36 insertions(+), 49 deletions(-)
 create mode 100644 osu.Game.Tests/Mods/ModSettingsTest.cs
 delete mode 100644 osu.Game.Tests/Visual/UserInterface/TestSceneModSettings.cs

diff --git a/osu.Game.Tests/Mods/ModSettingsTest.cs b/osu.Game.Tests/Mods/ModSettingsTest.cs
new file mode 100644
index 0000000000..b9ea1f2567
--- /dev/null
+++ b/osu.Game.Tests/Mods/ModSettingsTest.cs
@@ -0,0 +1,36 @@
+// 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.Mods;
+using osu.Game.Rulesets.Osu.Mods;
+
+namespace osu.Game.Tests.Mods
+{
+    public class ModSettingsTest
+    {
+        [Test]
+        public void TestModSettingsUnboundWhenCopied()
+        {
+            var original = new OsuModDoubleTime();
+            var copy = (OsuModDoubleTime)original.DeepClone();
+
+            original.SpeedChange.Value = 2;
+
+            Assert.That(original.SpeedChange.Value, Is.EqualTo(2.0));
+            Assert.That(copy.SpeedChange.Value, Is.EqualTo(1.5));
+        }
+
+        [Test]
+        public void TestMultiModSettingsUnboundWhenCopied()
+        {
+            var original = new MultiMod(new OsuModDoubleTime());
+            var copy = (MultiMod)original.DeepClone();
+
+            ((OsuModDoubleTime)original.Mods[0]).SpeedChange.Value = 2;
+
+            Assert.That(((OsuModDoubleTime)original.Mods[0]).SpeedChange.Value, Is.EqualTo(2.0));
+            Assert.That(((OsuModDoubleTime)copy.Mods[0]).SpeedChange.Value, Is.EqualTo(1.5));
+        }
+    }
+}
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneModSettings.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneModSettings.cs
deleted file mode 100644
index 1cf3b2651c..0000000000
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneModSettings.cs
+++ /dev/null
@@ -1,49 +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.Utils;
-using osu.Game.Rulesets.Mods;
-using osu.Game.Rulesets.Osu.Mods;
-
-namespace osu.Game.Tests.Visual.UserInterface
-{
-    public class TestSceneModSettings : OsuManualInputManagerTestScene
-    {
-        [Test]
-        public void TestModSettingsUnboundWhenCopied()
-        {
-            OsuModDoubleTime original = null;
-            OsuModDoubleTime copy = null;
-
-            AddStep("create mods", () =>
-            {
-                original = new OsuModDoubleTime();
-                copy = (OsuModDoubleTime)original.DeepClone();
-            });
-
-            AddStep("change property", () => original.SpeedChange.Value = 2);
-
-            AddAssert("original has new value", () => Precision.AlmostEquals(2.0, original.SpeedChange.Value));
-            AddAssert("copy has original value", () => Precision.AlmostEquals(1.5, copy.SpeedChange.Value));
-        }
-
-        [Test]
-        public void TestMultiModSettingsUnboundWhenCopied()
-        {
-            MultiMod original = null;
-            MultiMod copy = null;
-
-            AddStep("create mods", () =>
-            {
-                original = new MultiMod(new OsuModDoubleTime());
-                copy = (MultiMod)original.DeepClone();
-            });
-
-            AddStep("change property", () => ((OsuModDoubleTime)original.Mods[0]).SpeedChange.Value = 2);
-
-            AddAssert("original has new value", () => Precision.AlmostEquals(2.0, ((OsuModDoubleTime)original.Mods[0]).SpeedChange.Value));
-            AddAssert("copy has original value", () => Precision.AlmostEquals(1.5, ((OsuModDoubleTime)copy.Mods[0]).SpeedChange.Value));
-        }
-    }
-}

From 76c63f1d0a0a2bda6eb56642c0f417ba8656297c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 10 May 2022 22:29:57 +0200
Subject: [PATCH 4754/5547] Rename `ModSelect{Screen -> Overlay}` in place of
 removed old design

---
 .../TestSceneFreeModSelectScreen.cs           | 18 ++--
 .../Multiplayer/TestSceneMultiplayer.cs       |  2 +-
 .../TestSceneMultiplayerMatchSongSelect.cs    |  2 +-
 .../TestSceneMultiplayerMatchSubScreen.cs     |  2 +-
 .../Navigation/TestSceneScreenNavigation.cs   |  2 +-
 .../SongSelect/TestScenePlaySongSelect.cs     |  2 +-
 .../UserInterface/TestSceneModSelectScreen.cs | 96 +++++++++----------
 osu.Game/Overlays/Mods/ModColumn.cs           |  2 +-
 ...ModSelectScreen.cs => ModSelectOverlay.cs} |  4 +-
 ...electScreen.cs => UserModSelectOverlay.cs} |  4 +-
 ...electScreen.cs => FreeModSelectOverlay.cs} |  4 +-
 .../Screens/OnlinePlay/Match/RoomSubScreen.cs |  4 +-
 .../OnlinePlay/OnlinePlaySongSelect.cs        |  6 +-
 osu.Game/Screens/Select/SongSelect.cs         |  4 +-
 14 files changed, 76 insertions(+), 76 deletions(-)
 rename osu.Game/Overlays/Mods/{ModSelectScreen.cs => ModSelectOverlay.cs} (99%)
 rename osu.Game/Overlays/Mods/{UserModSelectScreen.cs => UserModSelectOverlay.cs} (92%)
 rename osu.Game/Screens/OnlinePlay/{FreeModSelectScreen.cs => FreeModSelectOverlay.cs} (94%)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneFreeModSelectScreen.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneFreeModSelectScreen.cs
index 4eb14542ba..9a24a1c646 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneFreeModSelectScreen.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneFreeModSelectScreen.cs
@@ -19,7 +19,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 {
     public class TestSceneFreeModSelectScreen : MultiplayerTestScene
     {
-        private FreeModSelectScreen freeModSelectScreen;
+        private FreeModSelectOverlay freeModSelectOverlay;
         private readonly Bindable<Dictionary<ModType, IReadOnlyList<Mod>>> availableMods = new Bindable<Dictionary<ModType, IReadOnlyList<Mod>>>();
 
         [BackgroundDependencyLoader]
@@ -40,8 +40,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             AddToggleStep("toggle visibility", visible =>
             {
-                if (freeModSelectScreen != null)
-                    freeModSelectScreen.State.Value = visible ? Visibility.Visible : Visibility.Hidden;
+                if (freeModSelectOverlay != null)
+                    freeModSelectOverlay.State.Value = visible ? Visibility.Visible : Visibility.Hidden;
             });
         }
 
@@ -50,7 +50,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             createFreeModSelect();
 
-            AddStep("select difficulty adjust", () => freeModSelectScreen.SelectedMods.Value = new[] { new OsuModDifficultyAdjust() });
+            AddStep("select difficulty adjust", () => freeModSelectOverlay.SelectedMods.Value = new[] { new OsuModDifficultyAdjust() });
             AddWaitStep("wait some", 3);
             AddAssert("customisation area not expanded", () => this.ChildrenOfType<ModSettingsArea>().Single().Height == 0);
         }
@@ -72,18 +72,18 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 InputManager.MoveMouseTo(this.ChildrenOfType<ShearedButton>().Last());
                 InputManager.Click(MouseButton.Left);
             });
-            AddUntilStep("all mods deselected", () => !freeModSelectScreen.SelectedMods.Value.Any());
+            AddUntilStep("all mods deselected", () => !freeModSelectOverlay.SelectedMods.Value.Any());
         }
 
         private void createFreeModSelect()
         {
-            AddStep("create free mod select screen", () => Child = freeModSelectScreen = new FreeModSelectScreen
+            AddStep("create free mod select screen", () => Child = freeModSelectOverlay = new FreeModSelectOverlay
             {
                 State = { Value = Visibility.Visible }
             });
             AddUntilStep("all column content loaded",
-                () => freeModSelectScreen.ChildrenOfType<ModColumn>().Any()
-                      && freeModSelectScreen.ChildrenOfType<ModColumn>().All(column => column.IsLoaded && column.ItemsLoaded));
+                () => freeModSelectOverlay.ChildrenOfType<ModColumn>().Any()
+                      && freeModSelectOverlay.ChildrenOfType<ModColumn>().All(column => column.IsLoaded && column.ItemsLoaded));
         }
 
         private bool assertAllAvailableModsSelected()
@@ -95,7 +95,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             foreach (var availableMod in allAvailableMods)
             {
-                if (freeModSelectScreen.SelectedMods.Value.All(selectedMod => selectedMod.GetType() != availableMod.GetType()))
+                if (freeModSelectOverlay.SelectedMods.Value.All(selectedMod => selectedMod.GetType() != availableMod.GetType()))
                     return false;
             }
 
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
index 97cb08e3c1..8e45d99eae 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
@@ -627,7 +627,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             AddStep("invoke on back button", () => multiplayerComponents.OnBackButton());
 
-            AddAssert("mod overlay is hidden", () => this.ChildrenOfType<UserModSelectScreen>().Single().State.Value == Visibility.Hidden);
+            AddAssert("mod overlay is hidden", () => this.ChildrenOfType<UserModSelectOverlay>().Single().State.Value == Visibility.Hidden);
 
             AddAssert("dialog overlay is hidden", () => DialogOverlay.State.Value == Visibility.Hidden);
 
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs
index 061fe5715b..eacd80925d 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs
@@ -132,7 +132,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         private void assertHasFreeModButton(Type type, bool hasButton = true)
         {
             AddAssert($"{type.ReadableName()} {(hasButton ? "displayed" : "not displayed")} in freemod overlay",
-                () => this.ChildrenOfType<FreeModSelectScreen>()
+                () => this.ChildrenOfType<FreeModSelectOverlay>()
                           .Single()
                           .ChildrenOfType<ModPanel>()
                           .Where(panel => !panel.Filtered.Value)
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs
index 6173580f0b..ca79fa9cb8 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs
@@ -172,7 +172,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddUntilStep("mod select contents loaded",
                 () => this.ChildrenOfType<ModColumn>().Any() && this.ChildrenOfType<ModColumn>().All(col => col.IsLoaded && col.ItemsLoaded));
             AddUntilStep("mod select contains only double time mod",
-                () => this.ChildrenOfType<UserModSelectScreen>()
+                () => this.ChildrenOfType<UserModSelectOverlay>()
                           .SingleOrDefault()?
                           .ChildrenOfType<ModPanel>()
                           .SingleOrDefault(panel => !panel.Filtered.Value)?.Mod is OsuModDoubleTime);
diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs b/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
index 9674ef7ae1..a3e0caedb9 100644
--- a/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
@@ -568,7 +568,7 @@ namespace osu.Game.Tests.Visual.Navigation
 
         public class TestPlaySongSelect : PlaySongSelect
         {
-            public ModSelectScreen ModSelectOverlay => ModSelect;
+            public ModSelectOverlay ModSelectOverlay => ModSelect;
 
             public BeatmapOptionsOverlay BeatmapOptionsOverlay => BeatmapOptions;
 
diff --git a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
index 083e24be7b..aad7f6b301 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
@@ -1008,7 +1008,7 @@ namespace osu.Game.Tests.Visual.SongSelect
             public WorkingBeatmap CurrentBeatmap => Beatmap.Value;
             public IWorkingBeatmap CurrentBeatmapDetailsBeatmap => BeatmapDetails.Beatmap;
             public new BeatmapCarousel Carousel => base.Carousel;
-            public new ModSelectScreen ModSelect => base.ModSelect;
+            public new ModSelectOverlay ModSelect => base.ModSelect;
 
             public new void PresentScore(ScoreInfo score) => base.PresentScore(score);
 
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs
index fa7758df59..2e2ce6edd7 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs
@@ -29,7 +29,7 @@ namespace osu.Game.Tests.Visual.UserInterface
         [Resolved]
         private RulesetStore rulesetStore { get; set; }
 
-        private UserModSelectScreen modSelectScreen;
+        private UserModSelectOverlay modSelectOverlay;
 
         [SetUpSteps]
         public void SetUpSteps()
@@ -41,7 +41,7 @@ namespace osu.Game.Tests.Visual.UserInterface
 
         private void createScreen()
         {
-            AddStep("create screen", () => Child = modSelectScreen = new UserModSelectScreen
+            AddStep("create screen", () => Child = modSelectOverlay = new UserModSelectOverlay
             {
                 RelativeSizeAxes = Axes.Both,
                 State = { Value = Visibility.Visible },
@@ -54,7 +54,7 @@ namespace osu.Game.Tests.Visual.UserInterface
         public void TestStateChange()
         {
             createScreen();
-            AddStep("toggle state", () => modSelectScreen.ToggleVisibility());
+            AddStep("toggle state", () => modSelectOverlay.ToggleVisibility());
         }
 
         [Test]
@@ -62,14 +62,14 @@ namespace osu.Game.Tests.Visual.UserInterface
         {
             AddStep("set mods", () => SelectedMods.Value = new Mod[] { new OsuModAlternate(), new OsuModDaycore() });
             createScreen();
-            AddUntilStep("two panels active", () => modSelectScreen.ChildrenOfType<ModPanel>().Count(panel => panel.Active.Value) == 2);
+            AddUntilStep("two panels active", () => modSelectOverlay.ChildrenOfType<ModPanel>().Count(panel => panel.Active.Value) == 2);
             AddAssert("mod multiplier correct", () =>
             {
                 double multiplier = SelectedMods.Value.Aggregate(1d, (m, mod) => m * mod.ScoreMultiplier);
-                return Precision.AlmostEquals(multiplier, modSelectScreen.ChildrenOfType<DifficultyMultiplierDisplay>().Single().Current.Value);
+                return Precision.AlmostEquals(multiplier, modSelectOverlay.ChildrenOfType<DifficultyMultiplierDisplay>().Single().Current.Value);
             });
             assertCustomisationToggleState(disabled: false, active: false);
-            AddAssert("setting items created", () => modSelectScreen.ChildrenOfType<ISettingsItem>().Any());
+            AddAssert("setting items created", () => modSelectOverlay.ChildrenOfType<ISettingsItem>().Any());
         }
 
         [Test]
@@ -77,14 +77,14 @@ namespace osu.Game.Tests.Visual.UserInterface
         {
             createScreen();
             AddStep("set mods", () => SelectedMods.Value = new Mod[] { new OsuModAlternate(), new OsuModDaycore() });
-            AddUntilStep("two panels active", () => modSelectScreen.ChildrenOfType<ModPanel>().Count(panel => panel.Active.Value) == 2);
+            AddUntilStep("two panels active", () => modSelectOverlay.ChildrenOfType<ModPanel>().Count(panel => panel.Active.Value) == 2);
             AddAssert("mod multiplier correct", () =>
             {
                 double multiplier = SelectedMods.Value.Aggregate(1d, (m, mod) => m * mod.ScoreMultiplier);
-                return Precision.AlmostEquals(multiplier, modSelectScreen.ChildrenOfType<DifficultyMultiplierDisplay>().Single().Current.Value);
+                return Precision.AlmostEquals(multiplier, modSelectOverlay.ChildrenOfType<DifficultyMultiplierDisplay>().Single().Current.Value);
             });
             assertCustomisationToggleState(disabled: false, active: false);
-            AddAssert("setting items created", () => modSelectScreen.ChildrenOfType<ISettingsItem>().Any());
+            AddAssert("setting items created", () => modSelectOverlay.ChildrenOfType<ISettingsItem>().Any());
         }
 
         [Test]
@@ -139,7 +139,7 @@ namespace osu.Game.Tests.Visual.UserInterface
             AddAssert("last column dimmed", () => !this.ChildrenOfType<ModColumn>().Last().Active.Value);
             AddStep("request scroll to last column", () =>
             {
-                var lastDimContainer = this.ChildrenOfType<ModSelectScreen.ColumnDimContainer>().Last();
+                var lastDimContainer = this.ChildrenOfType<ModSelectOverlay.ColumnDimContainer>().Last();
                 lastColumn = lastDimContainer.Column;
                 lastDimContainer.RequestScroll?.Invoke(lastDimContainer);
             });
@@ -167,7 +167,7 @@ namespace osu.Game.Tests.Visual.UserInterface
 
             AddStep("dismiss mod customisation via toggle", () =>
             {
-                InputManager.MoveMouseTo(modSelectScreen.ChildrenOfType<ShearedToggleButton>().Single());
+                InputManager.MoveMouseTo(modSelectOverlay.ChildrenOfType<ShearedToggleButton>().Single());
                 InputManager.Click(MouseButton.Left);
             });
             assertCustomisationToggleState(disabled: false, active: false);
@@ -205,14 +205,14 @@ namespace osu.Game.Tests.Visual.UserInterface
             AddStep("move mouse to dimmed area", () =>
             {
                 InputManager.MoveMouseTo(new Vector2(
-                    modSelectScreen.ScreenSpaceDrawQuad.TopLeft.X,
-                    (modSelectScreen.ScreenSpaceDrawQuad.TopLeft.Y + modSelectScreen.ScreenSpaceDrawQuad.BottomLeft.Y) / 2));
+                    modSelectOverlay.ScreenSpaceDrawQuad.TopLeft.X,
+                    (modSelectOverlay.ScreenSpaceDrawQuad.TopLeft.Y + modSelectOverlay.ScreenSpaceDrawQuad.BottomLeft.Y) / 2));
             });
             AddStep("click", () => InputManager.Click(MouseButton.Left));
             assertCustomisationToggleState(disabled: false, active: false);
 
-            AddStep("move mouse to first mod panel", () => InputManager.MoveMouseTo(modSelectScreen.ChildrenOfType<ModPanel>().First()));
-            AddAssert("first mod panel is hovered", () => modSelectScreen.ChildrenOfType<ModPanel>().First().IsHovered);
+            AddStep("move mouse to first mod panel", () => InputManager.MoveMouseTo(modSelectOverlay.ChildrenOfType<ModPanel>().First()));
+            AddAssert("first mod panel is hovered", () => modSelectOverlay.ChildrenOfType<ModPanel>().First().IsHovered);
         }
 
         /// <summary>
@@ -222,12 +222,12 @@ namespace osu.Game.Tests.Visual.UserInterface
         public void TestSettingsNotCrossPolluting()
         {
             Bindable<IReadOnlyList<Mod>> selectedMods2 = null;
-            ModSelectScreen modSelectScreen2 = null;
+            ModSelectOverlay modSelectScreen2 = null;
 
             createScreen();
             AddStep("select diff adjust", () => SelectedMods.Value = new Mod[] { new OsuModDifficultyAdjust() });
 
-            AddStep("set setting", () => modSelectScreen.ChildrenOfType<SettingsSlider<float>>().First().Current.Value = 8);
+            AddStep("set setting", () => modSelectOverlay.ChildrenOfType<SettingsSlider<float>>().First().Current.Value = 8);
 
             AddAssert("ensure setting is propagated", () => SelectedMods.Value.OfType<OsuModDifficultyAdjust>().Single().CircleSize.Value == 8);
 
@@ -235,7 +235,7 @@ namespace osu.Game.Tests.Visual.UserInterface
 
             AddStep("create second overlay", () =>
             {
-                Add(modSelectScreen2 = new UserModSelectScreen().With(d =>
+                Add(modSelectScreen2 = new UserModSelectOverlay().With(d =>
                 {
                     d.Origin = Anchor.TopCentre;
                     d.Anchor = Anchor.TopCentre;
@@ -276,20 +276,20 @@ namespace osu.Game.Tests.Visual.UserInterface
 
             AddStep("Select all fun mods", () =>
             {
-                modSelectScreen.ChildrenOfType<ModColumn>()
-                               .Single(c => c.ModType == ModType.DifficultyIncrease)
-                               .SelectAll();
+                modSelectOverlay.ChildrenOfType<ModColumn>()
+                                .Single(c => c.ModType == ModType.DifficultyIncrease)
+                                .SelectAll();
             });
 
             AddUntilStep("many mods selected", () => SelectedMods.Value.Count >= 5);
 
             AddStep("trigger deselect and close overlay", () =>
             {
-                modSelectScreen.ChildrenOfType<ModColumn>()
-                               .Single(c => c.ModType == ModType.DifficultyIncrease)
-                               .DeselectAll();
+                modSelectOverlay.ChildrenOfType<ModColumn>()
+                                .Single(c => c.ModType == ModType.DifficultyIncrease)
+                                .DeselectAll();
 
-                modSelectScreen.Hide();
+                modSelectOverlay.Hide();
             });
 
             AddAssert("all mods deselected", () => SelectedMods.Value.Count == 0);
@@ -378,15 +378,15 @@ namespace osu.Game.Tests.Visual.UserInterface
             createScreen();
             changeRuleset(0);
 
-            AddAssert("double time visible", () => modSelectScreen.ChildrenOfType<ModPanel>().Where(panel => panel.Mod is OsuModDoubleTime).Any(panel => !panel.Filtered.Value));
+            AddAssert("double time visible", () => modSelectOverlay.ChildrenOfType<ModPanel>().Where(panel => panel.Mod is OsuModDoubleTime).Any(panel => !panel.Filtered.Value));
 
-            AddStep("make double time invalid", () => modSelectScreen.IsValidMod = m => !(m is OsuModDoubleTime));
-            AddUntilStep("double time not visible", () => modSelectScreen.ChildrenOfType<ModPanel>().Where(panel => panel.Mod is OsuModDoubleTime).All(panel => panel.Filtered.Value));
-            AddAssert("nightcore still visible", () => modSelectScreen.ChildrenOfType<ModPanel>().Where(panel => panel.Mod is OsuModNightcore).Any(panel => !panel.Filtered.Value));
+            AddStep("make double time invalid", () => modSelectOverlay.IsValidMod = m => !(m is OsuModDoubleTime));
+            AddUntilStep("double time not visible", () => modSelectOverlay.ChildrenOfType<ModPanel>().Where(panel => panel.Mod is OsuModDoubleTime).All(panel => panel.Filtered.Value));
+            AddAssert("nightcore still visible", () => modSelectOverlay.ChildrenOfType<ModPanel>().Where(panel => panel.Mod is OsuModNightcore).Any(panel => !panel.Filtered.Value));
 
-            AddStep("make double time valid again", () => modSelectScreen.IsValidMod = m => true);
-            AddUntilStep("double time visible", () => modSelectScreen.ChildrenOfType<ModPanel>().Where(panel => panel.Mod is OsuModDoubleTime).Any(panel => !panel.Filtered.Value));
-            AddAssert("nightcore still visible", () => modSelectScreen.ChildrenOfType<ModPanel>().Where(b => b.Mod is OsuModNightcore).Any(panel => !panel.Filtered.Value));
+            AddStep("make double time valid again", () => modSelectOverlay.IsValidMod = m => true);
+            AddUntilStep("double time visible", () => modSelectOverlay.ChildrenOfType<ModPanel>().Where(panel => panel.Mod is OsuModDoubleTime).Any(panel => !panel.Filtered.Value));
+            AddAssert("nightcore still visible", () => modSelectOverlay.ChildrenOfType<ModPanel>().Where(b => b.Mod is OsuModNightcore).Any(panel => !panel.Filtered.Value));
         }
 
         [Test]
@@ -396,10 +396,10 @@ namespace osu.Game.Tests.Visual.UserInterface
             changeRuleset(0);
 
             AddStep("select DT + HD", () => SelectedMods.Value = new Mod[] { new OsuModDoubleTime(), new OsuModHidden() });
-            AddAssert("DT + HD selected", () => modSelectScreen.ChildrenOfType<ModPanel>().Count(panel => panel.Active.Value) == 2);
+            AddAssert("DT + HD selected", () => modSelectOverlay.ChildrenOfType<ModPanel>().Count(panel => panel.Active.Value) == 2);
 
-            AddStep("make NF invalid", () => modSelectScreen.IsValidMod = m => !(m is ModNoFail));
-            AddAssert("DT + HD still selected", () => modSelectScreen.ChildrenOfType<ModPanel>().Count(panel => panel.Active.Value) == 2);
+            AddStep("make NF invalid", () => modSelectOverlay.IsValidMod = m => !(m is ModNoFail));
+            AddAssert("DT + HD still selected", () => modSelectOverlay.ChildrenOfType<ModPanel>().Count(panel => panel.Active.Value) == 2);
         }
 
         [Test]
@@ -422,7 +422,7 @@ namespace osu.Game.Tests.Visual.UserInterface
             changeRuleset(0);
 
             AddStep("select DT + HD", () => SelectedMods.Value = new Mod[] { new OsuModDoubleTime(), new OsuModHidden() });
-            AddAssert("DT + HD selected", () => modSelectScreen.ChildrenOfType<ModPanel>().Count(panel => panel.Active.Value) == 2);
+            AddAssert("DT + HD selected", () => modSelectOverlay.ChildrenOfType<ModPanel>().Count(panel => panel.Active.Value) == 2);
 
             AddStep("click deselect all button", () =>
             {
@@ -448,13 +448,13 @@ namespace osu.Game.Tests.Visual.UserInterface
                 InputManager.MoveMouseTo(this.ChildrenOfType<ShearedButton>().First());
                 InputManager.Click(MouseButton.Left);
             });
-            AddAssert("mod select hidden", () => modSelectScreen.State.Value == Visibility.Hidden);
+            AddAssert("mod select hidden", () => modSelectOverlay.State.Value == Visibility.Hidden);
         }
 
         [Test]
         public void TestColumnHiding()
         {
-            AddStep("create screen", () => Child = modSelectScreen = new UserModSelectScreen
+            AddStep("create screen", () => Child = modSelectOverlay = new UserModSelectOverlay
             {
                 RelativeSizeAxes = Axes.Both,
                 State = { Value = Visibility.Visible },
@@ -466,23 +466,23 @@ namespace osu.Game.Tests.Visual.UserInterface
 
             AddAssert("two columns visible", () => this.ChildrenOfType<ModColumn>().Count(col => col.IsPresent) == 2);
 
-            AddStep("unset filter", () => modSelectScreen.IsValidMod = _ => true);
+            AddStep("unset filter", () => modSelectOverlay.IsValidMod = _ => true);
             AddAssert("all columns visible", () => this.ChildrenOfType<ModColumn>().All(col => col.IsPresent));
 
-            AddStep("filter out everything", () => modSelectScreen.IsValidMod = _ => false);
+            AddStep("filter out everything", () => modSelectOverlay.IsValidMod = _ => false);
             AddAssert("no columns visible", () => this.ChildrenOfType<ModColumn>().All(col => !col.IsPresent));
 
-            AddStep("hide", () => modSelectScreen.Hide());
-            AddStep("set filter for 3 columns", () => modSelectScreen.IsValidMod = mod => mod.Type == ModType.DifficultyReduction
-                                                                                          || mod.Type == ModType.Automation
-                                                                                          || mod.Type == ModType.Conversion);
+            AddStep("hide", () => modSelectOverlay.Hide());
+            AddStep("set filter for 3 columns", () => modSelectOverlay.IsValidMod = mod => mod.Type == ModType.DifficultyReduction
+                                                                                           || mod.Type == ModType.Automation
+                                                                                           || mod.Type == ModType.Conversion);
 
-            AddStep("show", () => modSelectScreen.Show());
+            AddStep("show", () => modSelectOverlay.Show());
             AddUntilStep("3 columns visible", () => this.ChildrenOfType<ModColumn>().Count(col => col.IsPresent) == 3);
         }
 
         private void waitForColumnLoad() => AddUntilStep("all column content loaded",
-            () => modSelectScreen.ChildrenOfType<ModColumn>().Any() && modSelectScreen.ChildrenOfType<ModColumn>().All(column => column.IsLoaded && column.ItemsLoaded));
+            () => modSelectOverlay.ChildrenOfType<ModColumn>().Any() && modSelectOverlay.ChildrenOfType<ModColumn>().All(column => column.IsLoaded && column.ItemsLoaded));
 
         private void changeRuleset(int id)
         {
@@ -492,14 +492,14 @@ namespace osu.Game.Tests.Visual.UserInterface
 
         private void assertCustomisationToggleState(bool disabled, bool active)
         {
-            ShearedToggleButton getToggle() => modSelectScreen.ChildrenOfType<ShearedToggleButton>().Single();
+            ShearedToggleButton getToggle() => modSelectOverlay.ChildrenOfType<ShearedToggleButton>().Single();
 
             AddAssert($"customisation toggle is {(disabled ? "" : "not ")}disabled", () => getToggle().Active.Disabled == disabled);
             AddAssert($"customisation toggle is {(active ? "" : "not ")}active", () => getToggle().Active.Value == active);
         }
 
         private ModPanel getPanelForMod(Type modType)
-            => modSelectScreen.ChildrenOfType<ModPanel>().Single(panel => panel.Mod.GetType() == modType);
+            => modSelectOverlay.ChildrenOfType<ModPanel>().Single(panel => panel.Mod.GetType() == modType);
 
         private class TestUnimplementedMod : Mod
         {
diff --git a/osu.Game/Overlays/Mods/ModColumn.cs b/osu.Game/Overlays/Mods/ModColumn.cs
index 3a2fda0bb0..b32ebb4a5c 100644
--- a/osu.Game/Overlays/Mods/ModColumn.cs
+++ b/osu.Game/Overlays/Mods/ModColumn.cs
@@ -384,7 +384,7 @@ namespace osu.Game.Overlays.Mods
         /// </summary>
         /// <remarks>
         /// This method exists to be able to receive mod instances that come from potentially-external sources and to copy the changes across to this column's state.
-        /// <see cref="ModSelectScreen"/> uses this to substitute any external mod references in <see cref="ModSelectScreen.SelectedMods"/>
+        /// <see cref="ModSelectOverlay"/> uses this to substitute any external mod references in <see cref="ModSelectOverlay.SelectedMods"/>
         /// to references that are owned by this column.
         /// </remarks>
         internal void SetSelection(IReadOnlyList<Mod> mods)
diff --git a/osu.Game/Overlays/Mods/ModSelectScreen.cs b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
similarity index 99%
rename from osu.Game/Overlays/Mods/ModSelectScreen.cs
rename to osu.Game/Overlays/Mods/ModSelectOverlay.cs
index 912c09f05c..b589b2e7e1 100644
--- a/osu.Game/Overlays/Mods/ModSelectScreen.cs
+++ b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
@@ -27,7 +27,7 @@ using osuTK.Input;
 
 namespace osu.Game.Overlays.Mods
 {
-    public abstract class ModSelectScreen : ShearedOverlayContainer, ISamplePlaybackDisabler
+    public abstract class ModSelectOverlay : ShearedOverlayContainer, ISamplePlaybackDisabler
     {
         protected const int BUTTON_WIDTH = 200;
 
@@ -76,7 +76,7 @@ namespace osu.Game.Overlays.Mods
 
         private ShearedToggleButton? customisationButton;
 
-        protected ModSelectScreen(OverlayColourScheme colourScheme = OverlayColourScheme.Green)
+        protected ModSelectOverlay(OverlayColourScheme colourScheme = OverlayColourScheme.Green)
             : base(colourScheme)
         {
         }
diff --git a/osu.Game/Overlays/Mods/UserModSelectScreen.cs b/osu.Game/Overlays/Mods/UserModSelectOverlay.cs
similarity index 92%
rename from osu.Game/Overlays/Mods/UserModSelectScreen.cs
rename to osu.Game/Overlays/Mods/UserModSelectOverlay.cs
index a018797cba..8ff5e28c8f 100644
--- a/osu.Game/Overlays/Mods/UserModSelectScreen.cs
+++ b/osu.Game/Overlays/Mods/UserModSelectOverlay.cs
@@ -10,9 +10,9 @@ using osuTK.Input;
 
 namespace osu.Game.Overlays.Mods
 {
-    public class UserModSelectScreen : ModSelectScreen
+    public class UserModSelectOverlay : ModSelectOverlay
     {
-        public UserModSelectScreen(OverlayColourScheme colourScheme = OverlayColourScheme.Green)
+        public UserModSelectOverlay(OverlayColourScheme colourScheme = OverlayColourScheme.Green)
             : base(colourScheme)
         {
         }
diff --git a/osu.Game/Screens/OnlinePlay/FreeModSelectScreen.cs b/osu.Game/Screens/OnlinePlay/FreeModSelectOverlay.cs
similarity index 94%
rename from osu.Game/Screens/OnlinePlay/FreeModSelectScreen.cs
rename to osu.Game/Screens/OnlinePlay/FreeModSelectOverlay.cs
index e92de5e083..6e1c9b7a59 100644
--- a/osu.Game/Screens/OnlinePlay/FreeModSelectScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/FreeModSelectOverlay.cs
@@ -13,7 +13,7 @@ using osu.Game.Localisation;
 
 namespace osu.Game.Screens.OnlinePlay
 {
-    public class FreeModSelectScreen : ModSelectScreen
+    public class FreeModSelectOverlay : ModSelectOverlay
     {
         protected override bool ShowTotalMultiplier => false;
 
@@ -23,7 +23,7 @@ namespace osu.Game.Screens.OnlinePlay
             set => base.IsValidMod = m => m.UserPlayable && value.Invoke(m);
         }
 
-        public FreeModSelectScreen()
+        public FreeModSelectOverlay()
             : base(OverlayColourScheme.Plum)
         {
             IsValidMod = _ => true;
diff --git a/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs b/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
index ec4e329f7a..13b2c37ded 100644
--- a/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
@@ -81,7 +81,7 @@ namespace osu.Game.Screens.OnlinePlay.Match
         public readonly Room Room;
         private readonly bool allowEdit;
 
-        private ModSelectScreen userModsSelectOverlay;
+        private ModSelectOverlay userModsSelectOverlay;
 
         [CanBeNull]
         private IDisposable userModsSelectOverlayRegistration;
@@ -231,7 +231,7 @@ namespace osu.Game.Screens.OnlinePlay.Match
                 }
             };
 
-            LoadComponent(userModsSelectOverlay = new UserModSelectScreen(OverlayColourScheme.Plum)
+            LoadComponent(userModsSelectOverlay = new UserModSelectOverlay(OverlayColourScheme.Plum)
             {
                 SelectedMods = { BindTarget = UserMods },
                 IsValidMod = _ => false
diff --git a/osu.Game/Screens/OnlinePlay/OnlinePlaySongSelect.cs b/osu.Game/Screens/OnlinePlay/OnlinePlaySongSelect.cs
index c4503773ad..fb18a33d66 100644
--- a/osu.Game/Screens/OnlinePlay/OnlinePlaySongSelect.cs
+++ b/osu.Game/Screens/OnlinePlay/OnlinePlaySongSelect.cs
@@ -53,7 +53,7 @@ namespace osu.Game.Screens.OnlinePlay
         private IReadOnlyList<Mod> initialMods;
         private bool itemSelected;
 
-        private readonly FreeModSelectScreen freeModSelectOverlay;
+        private readonly FreeModSelectOverlay freeModSelectOverlay;
         private IDisposable freeModSelectOverlayRegistration;
 
         protected OnlinePlaySongSelect(Room room)
@@ -62,7 +62,7 @@ namespace osu.Game.Screens.OnlinePlay
 
             Padding = new MarginPadding { Horizontal = HORIZONTAL_OVERFLOW_PADDING };
 
-            freeModSelectOverlay = new FreeModSelectScreen
+            freeModSelectOverlay = new FreeModSelectOverlay
             {
                 SelectedMods = { BindTarget = FreeMods },
                 IsValidMod = IsValidFreeMod,
@@ -160,7 +160,7 @@ namespace osu.Game.Screens.OnlinePlay
             return base.OnExiting(e);
         }
 
-        protected override ModSelectScreen CreateModSelectOverlay() => new UserModSelectScreen(OverlayColourScheme.Plum)
+        protected override ModSelectOverlay CreateModSelectOverlay() => new UserModSelectOverlay(OverlayColourScheme.Plum)
         {
             IsValidMod = IsValidMod
         };
diff --git a/osu.Game/Screens/Select/SongSelect.cs b/osu.Game/Screens/Select/SongSelect.cs
index eb5e996972..8870239485 100644
--- a/osu.Game/Screens/Select/SongSelect.cs
+++ b/osu.Game/Screens/Select/SongSelect.cs
@@ -102,7 +102,7 @@ namespace osu.Game.Screens.Select
         [Resolved(CanBeNull = true)]
         private LegacyImportManager legacyImportManager { get; set; }
 
-        protected ModSelectScreen ModSelect { get; private set; }
+        protected ModSelectOverlay ModSelect { get; private set; }
 
         protected Sample SampleConfirm { get; private set; }
 
@@ -333,7 +333,7 @@ namespace osu.Game.Screens.Select
             (new FooterButtonOptions(), BeatmapOptions)
         };
 
-        protected virtual ModSelectScreen CreateModSelectOverlay() => new UserModSelectScreen();
+        protected virtual ModSelectOverlay CreateModSelectOverlay() => new UserModSelectOverlay();
 
         protected virtual void ApplyFilterToCarousel(FilterCriteria criteria)
         {

From 9dce329e998e88c415c7d23576d75a29be3ca47f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 11 May 2022 10:38:35 +0900
Subject: [PATCH 4755/5547] Remove build suffix from version when reporting to
 sentry

---
 osu.Game/OsuGameBase.cs        | 4 +++-
 osu.Game/Utils/SentryLogger.cs | 2 +-
 2 files changed, 4 insertions(+), 2 deletions(-)

diff --git a/osu.Game/OsuGameBase.cs b/osu.Game/OsuGameBase.cs
index ce798d4027..2e4758a134 100644
--- a/osu.Game/OsuGameBase.cs
+++ b/osu.Game/OsuGameBase.cs
@@ -86,6 +86,8 @@ namespace osu.Game
 
         public bool IsDeployedBuild => AssemblyVersion.Major > 0;
 
+        internal const string BUILD_SUFFIX = "lazer";
+
         public virtual string Version
         {
             get
@@ -94,7 +96,7 @@ namespace osu.Game
                     return @"local " + (DebugUtils.IsDebugBuild ? @"debug" : @"release");
 
                 var version = AssemblyVersion;
-                return $@"{version.Major}.{version.Minor}.{version.Build}-lazer";
+                return $@"{version.Major}.{version.Minor}.{version.Build}-{BUILD_SUFFIX}";
             }
         }
 
diff --git a/osu.Game/Utils/SentryLogger.cs b/osu.Game/Utils/SentryLogger.cs
index ad4bcf6274..218d10345f 100644
--- a/osu.Game/Utils/SentryLogger.cs
+++ b/osu.Game/Utils/SentryLogger.cs
@@ -34,7 +34,7 @@ namespace osu.Game.Utils
 
                 options.AutoSessionTracking = true;
                 options.IsEnvironmentUser = false;
-                options.Release = game.Version;
+                options.Release = game.Version.Replace($@"-{OsuGameBase.BUILD_SUFFIX}", string.Empty);
             });
 
             Logger.NewEntry += processLogEntry;

From 533f4b298f5f0a34fa690e33c11ac858cae783ee Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 11 May 2022 10:40:40 +0900
Subject: [PATCH 4756/5547] Add explanation inline for future visitors

---
 osu.Game/Utils/SentryLogger.cs | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/osu.Game/Utils/SentryLogger.cs b/osu.Game/Utils/SentryLogger.cs
index 218d10345f..16f1a8b039 100644
--- a/osu.Game/Utils/SentryLogger.cs
+++ b/osu.Game/Utils/SentryLogger.cs
@@ -34,6 +34,8 @@ namespace osu.Game.Utils
 
                 options.AutoSessionTracking = true;
                 options.IsEnvironmentUser = false;
+                // The reported release needs to match release tags on github in order for sentry
+                // to automatically associate and track against releases.
                 options.Release = game.Version.Replace($@"-{OsuGameBase.BUILD_SUFFIX}", string.Empty);
             });
 

From 843e13a471a0b763ca5cd2f6047478c1fb0241de Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 11 May 2022 12:55:15 +0900
Subject: [PATCH 4757/5547] Add screen stack context to sentry

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

diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index b8abef38a8..9edcf90132 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -56,6 +56,8 @@ using osu.Game.Updater;
 using osu.Game.Users;
 using osu.Game.Utils;
 using osuTK.Graphics;
+using Sentry;
+using Logger = osu.Framework.Logging.Logger;
 
 namespace osu.Game
 {
@@ -1197,6 +1199,15 @@ namespace osu.Game
 
         private void screenChanged(IScreen current, IScreen newScreen)
         {
+            SentrySdk.ConfigureScope(scope =>
+            {
+                scope.Contexts[@"screen stack"] = new
+                {
+                    Current = newScreen.GetType().Name,
+                    Previous = current.GetType().Name,
+                };
+            });
+
             switch (newScreen)
             {
                 case IntroScreen intro:

From b136677bb002565e7736f7947a44fd456685d5df Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 11 May 2022 14:03:16 +0900
Subject: [PATCH 4758/5547] Add config and clock time contexts to sentry

---
 osu.Game/Configuration/OsuConfigManager.cs | 16 ++++++++++++++++
 osu.Game/Utils/SentryLogger.cs             | 18 ++++++++++++++++++
 2 files changed, 34 insertions(+)

diff --git a/osu.Game/Configuration/OsuConfigManager.cs b/osu.Game/Configuration/OsuConfigManager.cs
index 64e77384a2..026a83cceb 100644
--- a/osu.Game/Configuration/OsuConfigManager.cs
+++ b/osu.Game/Configuration/OsuConfigManager.cs
@@ -2,8 +2,10 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
+using System.Collections.Generic;
 using System.Diagnostics;
 using System.Globalization;
+using System.Linq;
 using osu.Framework.Configuration;
 using osu.Framework.Configuration.Tracking;
 using osu.Framework.Extensions;
@@ -164,6 +166,20 @@ namespace osu.Game.Configuration
             SetDefault(OsuSetting.EditorHitAnimations, false);
         }
 
+        public IDictionary<OsuSetting, string> GetLoggableState() =>
+            new Dictionary<OsuSetting, string>(ConfigStore.Where(kvp => !keyContainsPrivateInformation(kvp.Key)).ToDictionary(kvp => kvp.Key, kvp => kvp.Value.ToString()));
+
+        private static bool keyContainsPrivateInformation(OsuSetting argKey)
+        {
+            switch (argKey)
+            {
+                case OsuSetting.Token:
+                    return true;
+            }
+
+            return false;
+        }
+
         public OsuConfigManager(Storage storage)
             : base(storage)
         {
diff --git a/osu.Game/Utils/SentryLogger.cs b/osu.Game/Utils/SentryLogger.cs
index ad4bcf6274..e019e4bb12 100644
--- a/osu.Game/Utils/SentryLogger.cs
+++ b/osu.Game/Utils/SentryLogger.cs
@@ -7,9 +7,12 @@ using System;
 using System.Diagnostics;
 using System.IO;
 using System.Net;
+using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Logging;
+using osu.Game.Configuration;
 using osu.Game.Online.API.Requests.Responses;
+using osu.Game.Overlays;
 using Sentry;
 using Sentry.Protocol;
 
@@ -24,8 +27,11 @@ namespace osu.Game.Utils
 
         private readonly IDisposable? sentrySession;
 
+        private readonly OsuGame game;
+
         public SentryLogger(OsuGame game)
         {
+            this.game = game;
             sentrySession = SentrySdk.Init(options =>
             {
                 // Not setting the dsn will completely disable sentry.
@@ -92,6 +98,18 @@ namespace osu.Game.Utils
                 {
                     Message = entry.Message,
                     Level = getSentryLevel(entry.Level),
+                }, scope =>
+                {
+                    scope.Contexts[@"config"] = new
+                    {
+                        Game = game.Dependencies.Get<OsuConfigManager>().GetLoggableState()
+                        // TODO: add framework config here. needs some consideration on how to expose.
+                    };
+                    scope.Contexts[@"clocks"] = new
+                    {
+                        Audio = game.Dependencies.Get<MusicController>().CurrentTrack.CurrentTime,
+                        Game = game.Clock.CurrentTime,
+                    };
                 });
             }
             else

From 977a0453cc3e18bbc38ba75d77288b0af72834c3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 11 May 2022 14:11:20 +0900
Subject: [PATCH 4759/5547] Add beatmap context to sentry

---
 osu.Game/Utils/SentryLogger.cs | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/osu.Game/Utils/SentryLogger.cs b/osu.Game/Utils/SentryLogger.cs
index e019e4bb12..d02ffcb013 100644
--- a/osu.Game/Utils/SentryLogger.cs
+++ b/osu.Game/Utils/SentryLogger.cs
@@ -10,6 +10,7 @@ using System.Net;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Logging;
+using osu.Game.Beatmaps;
 using osu.Game.Configuration;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays;
@@ -105,6 +106,15 @@ namespace osu.Game.Utils
                         Game = game.Dependencies.Get<OsuConfigManager>().GetLoggableState()
                         // TODO: add framework config here. needs some consideration on how to expose.
                     };
+
+                    var beatmap = game.Dependencies.Get<IBindable<WorkingBeatmap>>().Value.BeatmapInfo;
+
+                    scope.Contexts[@"beatmap"] = new
+                    {
+                        Name = beatmap.ToString(),
+                        beatmap.OnlineID,
+                    };
+
                     scope.Contexts[@"clocks"] = new
                     {
                         Audio = game.Dependencies.Get<MusicController>().CurrentTrack.CurrentTime,

From f53d42d31ff51e6c43878e49f2db6b3da73a5841 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 11 May 2022 14:51:56 +0900
Subject: [PATCH 4760/5547] Add realm context to sentry

---
 osu.Game/Utils/SentryLogger.cs | 20 +++++++++++++++++++-
 1 file changed, 19 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Utils/SentryLogger.cs b/osu.Game/Utils/SentryLogger.cs
index d02ffcb013..a291cee9ae 100644
--- a/osu.Game/Utils/SentryLogger.cs
+++ b/osu.Game/Utils/SentryLogger.cs
@@ -6,14 +6,18 @@
 using System;
 using System.Diagnostics;
 using System.IO;
+using System.Linq;
 using System.Net;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Logging;
 using osu.Game.Beatmaps;
 using osu.Game.Configuration;
+using osu.Game.Database;
+using osu.Game.Models;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays;
+using osu.Game.Skinning;
 using Sentry;
 using Sentry.Protocol;
 
@@ -101,13 +105,27 @@ namespace osu.Game.Utils
                     Level = getSentryLevel(entry.Level),
                 }, scope =>
                 {
+                    var beatmap = game.Dependencies.Get<IBindable<WorkingBeatmap>>().Value.BeatmapInfo;
+
                     scope.Contexts[@"config"] = new
                     {
                         Game = game.Dependencies.Get<OsuConfigManager>().GetLoggableState()
                         // TODO: add framework config here. needs some consideration on how to expose.
                     };
 
-                    var beatmap = game.Dependencies.Get<IBindable<WorkingBeatmap>>().Value.BeatmapInfo;
+                    game.Dependencies.Get<RealmAccess>().Run(realm =>
+                    {
+                        scope.Contexts[@"realm"] = new
+                        {
+                            Counts = new
+                            {
+                                BeatmapSets = realm.All<BeatmapSetInfo>().Count(),
+                                Beatmaps = realm.All<BeatmapInfo>().Count(),
+                                Files = realm.All<RealmFile>().Count(),
+                                Skins = realm.All<SkinInfo>().Count(),
+                            }
+                        };
+                    });
 
                     scope.Contexts[@"beatmap"] = new
                     {

From be09ec833e0b5e271f6fe8d50dd3d0e4d965de30 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 11 May 2022 14:52:08 +0900
Subject: [PATCH 4761/5547] Add global statistics context to sentry

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

diff --git a/osu.Game/Utils/SentryLogger.cs b/osu.Game/Utils/SentryLogger.cs
index a291cee9ae..d68f43e88a 100644
--- a/osu.Game/Utils/SentryLogger.cs
+++ b/osu.Game/Utils/SentryLogger.cs
@@ -11,6 +11,7 @@ using System.Net;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Logging;
+using osu.Framework.Statistics;
 using osu.Game.Beatmaps;
 using osu.Game.Configuration;
 using osu.Game.Database;
@@ -127,6 +128,10 @@ namespace osu.Game.Utils
                         };
                     });
 
+                    scope.Contexts[@"global statistics"] = GlobalStatistics.GetStatistics()
+                                                                           .GroupBy(s => s.Group)
+                                                                           .ToDictionary(g => g.Key, items => items.ToDictionary(i => i.Name, g => g.DisplayValue));
+
                     scope.Contexts[@"beatmap"] = new
                     {
                         Name = beatmap.ToString(),

From 0b597e712ed72de537fc9e8e413bc06a7c477111 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 11 May 2022 09:39:27 +0300
Subject: [PATCH 4762/5547] Fix timeline not handling mouse down events

---
 .../Screens/Edit/Compose/Components/Timeline/Timeline.cs     | 5 +----
 1 file changed, 1 insertion(+), 4 deletions(-)

diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/Timeline.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/Timeline.cs
index 51b8792d87..7e66c57917 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/Timeline.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/Timeline.cs
@@ -270,12 +270,9 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
         protected override bool OnMouseDown(MouseDownEvent e)
         {
             if (base.OnMouseDown(e))
-            {
                 beginUserDrag();
-                return true;
-            }
 
-            return false;
+            return true;
         }
 
         protected override void OnMouseUp(MouseUpEvent e)

From e43ce28ada3a21a1b7c978da2db16ea9fee0f994 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 11 May 2022 09:51:00 +0300
Subject: [PATCH 4763/5547] Remove references of "difficulty point" in sample
 point test scene

Fat-fingered.
---
 .../Editing/TestSceneHitObjectSamplePointAdjustments.cs   | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneHitObjectSamplePointAdjustments.cs b/osu.Game.Tests/Visual/Editing/TestSceneHitObjectSamplePointAdjustments.cs
index dca30a6fc0..f0a2347c31 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneHitObjectSamplePointAdjustments.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneHitObjectSamplePointAdjustments.cs
@@ -173,11 +173,11 @@ namespace osu.Game.Tests.Visual.Editing
             samplePopoverHasSingleBank("normal");
         }
 
-        private void clickSamplePiece(int objectIndex) => AddStep($"click {objectIndex.ToOrdinalWords()} difficulty piece", () =>
+        private void clickSamplePiece(int objectIndex) => AddStep($"click {objectIndex.ToOrdinalWords()} sample piece", () =>
         {
-            var difficultyPiece = this.ChildrenOfType<SamplePointPiece>().Single(piece => piece.HitObject == EditorBeatmap.HitObjects.ElementAt(objectIndex));
+            var samplePiece = this.ChildrenOfType<SamplePointPiece>().Single(piece => piece.HitObject == EditorBeatmap.HitObjects.ElementAt(objectIndex));
 
-            InputManager.MoveMouseTo(difficultyPiece);
+            InputManager.MoveMouseTo(samplePiece);
             InputManager.Click(MouseButton.Left);
         });
 
@@ -216,7 +216,7 @@ namespace osu.Game.Tests.Visual.Editing
         private void dismissPopover()
         {
             AddStep("dismiss popover", () => InputManager.Key(Key.Escape));
-            AddUntilStep("wait for dismiss", () => !this.ChildrenOfType<DifficultyPointPiece.DifficultyEditPopover>().Any(popover => popover.IsPresent));
+            AddUntilStep("wait for dismiss", () => !this.ChildrenOfType<SamplePointPiece.SampleEditPopover>().Any(popover => popover.IsPresent));
         }
 
         private void setVolumeViaPopover(int volume) => AddStep($"set volume {volume} via popover", () =>

From f797514bce5aafb5df020e7fa62c2dd24b0e3139 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 11 May 2022 09:51:59 +0300
Subject: [PATCH 4764/5547] Add failing test cases

---
 ...tSceneHitObjectDifficultyPointAdjustments.cs | 17 +++++++++++++++++
 .../TestSceneHitObjectSamplePointAdjustments.cs | 16 ++++++++++++++++
 2 files changed, 33 insertions(+)

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneHitObjectDifficultyPointAdjustments.cs b/osu.Game.Tests/Visual/Editing/TestSceneHitObjectDifficultyPointAdjustments.cs
index 4012a672ed..7f82d5966e 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneHitObjectDifficultyPointAdjustments.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneHitObjectDifficultyPointAdjustments.cs
@@ -7,6 +7,7 @@ using NUnit.Framework;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.ControlPoints;
+using osu.Game.Graphics.UserInterface;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Osu;
@@ -66,6 +67,13 @@ namespace osu.Game.Tests.Visual.Editing
             });
         }
 
+        [Test]
+        public void TestPopoverHasFocus()
+        {
+            clickDifficultyPiece(0);
+            velocityPopoverHasFocus();
+        }
+
         [Test]
         public void TestSingleSelection()
         {
@@ -133,6 +141,15 @@ namespace osu.Game.Tests.Visual.Editing
             InputManager.Click(MouseButton.Left);
         });
 
+        private void velocityPopoverHasFocus() => AddUntilStep("velocity popover textbox focused", () =>
+        {
+            var popover = this.ChildrenOfType<DifficultyPointPiece.DifficultyEditPopover>().SingleOrDefault();
+            var slider = popover?.ChildrenOfType<IndeterminateSliderWithTextBoxInput<double>>().Single();
+            var textbox = slider?.ChildrenOfType<OsuTextBox>().Single();
+
+            return textbox?.HasFocus == true;
+        });
+
         private void velocityPopoverHasSingleValue(double velocity) => AddUntilStep($"velocity popover has {velocity}", () =>
         {
             var popover = this.ChildrenOfType<DifficultyPointPiece.DifficultyEditPopover>().SingleOrDefault();
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneHitObjectSamplePointAdjustments.cs b/osu.Game.Tests/Visual/Editing/TestSceneHitObjectSamplePointAdjustments.cs
index f0a2347c31..fcdf4a6e33 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneHitObjectSamplePointAdjustments.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneHitObjectSamplePointAdjustments.cs
@@ -57,6 +57,13 @@ namespace osu.Game.Tests.Visual.Editing
             });
         }
 
+        [Test]
+        public void TestPopoverHasFocus()
+        {
+            clickSamplePiece(0);
+            samplePopoverHasFocus();
+        }
+
         [Test]
         public void TestSingleSelection()
         {
@@ -181,6 +188,15 @@ namespace osu.Game.Tests.Visual.Editing
             InputManager.Click(MouseButton.Left);
         });
 
+        private void samplePopoverHasFocus() => AddUntilStep("sample popover textbox focused", () =>
+        {
+            var popover = this.ChildrenOfType<SamplePointPiece.SampleEditPopover>().SingleOrDefault();
+            var slider = popover?.ChildrenOfType<IndeterminateSliderWithTextBoxInput<int>>().Single();
+            var textbox = slider?.ChildrenOfType<OsuTextBox>().Single();
+
+            return textbox?.HasFocus == true;
+        });
+
         private void samplePopoverHasSingleVolume(int volume) => AddUntilStep($"sample popover has volume {volume}", () =>
         {
             var popover = this.ChildrenOfType<SamplePointPiece.SampleEditPopover>().SingleOrDefault();

From 24432dffc4622135e1a296638d1e765ca9801477 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 11 May 2022 09:53:04 +0300
Subject: [PATCH 4765/5547] Add support for focusing intermediate
 slider-textbox component

---
 .../Edit/Timing/IndeterminateSliderWithTextBoxInput.cs   | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/osu.Game/Screens/Edit/Timing/IndeterminateSliderWithTextBoxInput.cs b/osu.Game/Screens/Edit/Timing/IndeterminateSliderWithTextBoxInput.cs
index 0cf2cf6c54..16a04982f5 100644
--- a/osu.Game/Screens/Edit/Timing/IndeterminateSliderWithTextBoxInput.cs
+++ b/osu.Game/Screens/Edit/Timing/IndeterminateSliderWithTextBoxInput.cs
@@ -7,6 +7,7 @@ using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.UserInterface;
+using osu.Framework.Input.Events;
 using osu.Framework.Localisation;
 using osu.Game.Graphics.UserInterfaceV2;
 using osu.Game.Overlays.Settings;
@@ -107,6 +108,14 @@ namespace osu.Game.Screens.Edit.Timing
             Current.BindValueChanged(_ => updateState(), true);
         }
 
+        public override bool AcceptsFocus => true;
+
+        protected override void OnFocus(FocusEvent e)
+        {
+            base.OnFocus(e);
+            GetContainingInputManager().ChangeFocus(textBox);
+        }
+
         private void updateState()
         {
             if (Current.Value is T nonNullValue)

From 96db530de63626afa8ed51f3f8f24de669a7faa2 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 11 May 2022 09:55:34 +0300
Subject: [PATCH 4766/5547] Focus textbox on control point popovers

---
 .../Compose/Components/Timeline/DifficultyPointPiece.cs     | 6 ++++++
 .../Edit/Compose/Components/Timeline/SamplePointPiece.cs    | 6 ++++++
 2 files changed, 12 insertions(+)

diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/DifficultyPointPiece.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/DifficultyPointPiece.cs
index b230bab0c2..eaaa663fe7 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/DifficultyPointPiece.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/DifficultyPointPiece.cs
@@ -122,6 +122,12 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
                     beatmap.EndChange();
                 });
             }
+
+            protected override void LoadComplete()
+            {
+                base.LoadComplete();
+                ScheduleAfterChildren(() => GetContainingInputManager().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 fc0952d4f0..ab21a83c43 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/SamplePointPiece.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/SamplePointPiece.cs
@@ -126,6 +126,12 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
                 volume.Current.BindValueChanged(val => updateVolumeFor(relevantObjects, val.NewValue));
             }
 
+            protected override void LoadComplete()
+            {
+                base.LoadComplete();
+                ScheduleAfterChildren(() => GetContainingInputManager().ChangeFocus(volume));
+            }
+
             private static string? getCommonBank(SampleControlPoint[] relevantControlPoints) => relevantControlPoints.Select(point => point.SampleBank).Distinct().Count() == 1 ? relevantControlPoints.First().SampleBank : null;
             private static int? getCommonVolume(SampleControlPoint[] relevantControlPoints) => relevantControlPoints.Select(point => point.SampleVolume).Distinct().Count() == 1 ? (int?)relevantControlPoints.First().SampleVolume : null;
 

From 1c369956066c28ffe2333d03ae9353e1cf9a09f9 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 11 May 2022 16:09:16 +0900
Subject: [PATCH 4767/5547] Expose `HoldingForHUD` state from `HUDOverlay` as
 bindable

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

diff --git a/osu.Game/Screens/Play/HUDOverlay.cs b/osu.Game/Screens/Play/HUDOverlay.cs
index abfed1acd0..f6087e0958 100644
--- a/osu.Game/Screens/Play/HUDOverlay.cs
+++ b/osu.Game/Screens/Play/HUDOverlay.cs
@@ -68,7 +68,9 @@ namespace osu.Game.Screens.Play
 
         internal readonly IBindable<bool> IsPlaying = new Bindable<bool>();
 
-        private bool holdingForHUD;
+        public IBindable<bool> HoldingForHUD => holdingForHUD;
+
+        private readonly BindableBool holdingForHUD = new BindableBool();
 
         private readonly SkinnableTargetContainer mainComponents;
 
@@ -144,7 +146,8 @@ namespace osu.Game.Screens.Play
             hideTargets.ForEach(d => d.Hide());
         }
 
-        public override void Hide() => throw new InvalidOperationException($"{nameof(HUDOverlay)} should not be hidden as it will remove the ability of a user to quit. Use {nameof(ShowHud)} instead.");
+        public override void Hide() =>
+            throw new InvalidOperationException($"{nameof(HUDOverlay)} should not be hidden as it will remove the ability of a user to quit. Use {nameof(ShowHud)} instead.");
 
         protected override void LoadComplete()
         {
@@ -152,6 +155,7 @@ namespace osu.Game.Screens.Play
 
             ShowHud.BindValueChanged(visible => hideTargets.ForEach(d => d.FadeTo(visible.NewValue ? 1 : 0, FADE_DURATION, FADE_EASING)));
 
+            holdingForHUD.BindValueChanged(_ => updateVisibility());
             IsPlaying.BindValueChanged(_ => updateVisibility());
             configVisibilityMode.BindValueChanged(_ => updateVisibility(), true);
 
@@ -204,7 +208,7 @@ namespace osu.Game.Screens.Play
             if (ShowHud.Disabled)
                 return;
 
-            if (holdingForHUD)
+            if (holdingForHUD.Value)
             {
                 ShowHud.Value = true;
                 return;
@@ -287,8 +291,7 @@ namespace osu.Game.Screens.Play
             switch (e.Action)
             {
                 case GlobalAction.HoldForHUD:
-                    holdingForHUD = true;
-                    updateVisibility();
+                    holdingForHUD.Value = true;
                     return true;
 
                 case GlobalAction.ToggleInGameInterface:
@@ -318,8 +321,7 @@ namespace osu.Game.Screens.Play
             switch (e.Action)
             {
                 case GlobalAction.HoldForHUD:
-                    holdingForHUD = false;
-                    updateVisibility();
+                    holdingForHUD.Value = false;
                     break;
             }
         }

From d05cd6908763cd47ca66281f70d6540b2080ea39 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 11 May 2022 16:12:54 +0900
Subject: [PATCH 4768/5547] Change multiplayer leaderboard to always hide
 during gameplay unless holding-for-HUD

---
 .../OnlinePlay/Multiplayer/MultiplayerPlayer.cs      | 12 ++++++++++--
 1 file changed, 10 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayer.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayer.cs
index 02ff040a94..5dab845999 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayer.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayer.cs
@@ -43,6 +43,8 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
 
         private readonly MultiplayerRoomUser[] users;
 
+        private readonly Bindable<bool> leaderboardExpanded = new BindableBool();
+
         private LoadingLayer loadingDisplay;
         private FillFlowContainer leaderboardFlow;
 
@@ -76,13 +78,16 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
                 Spacing = new Vector2(5)
             });
 
+            HUDOverlay.HoldingForHUD.BindValueChanged(_ => updateLeaderboardExpandedState());
+            LocalUserPlaying.BindValueChanged(_ => updateLeaderboardExpandedState(), true);
+
             // todo: this should be implemented via a custom HUD implementation, and correctly masked to the main content area.
             LoadComponentAsync(leaderboard = new MultiplayerGameplayLeaderboard(GameplayState.Ruleset.RulesetInfo, ScoreProcessor, users), l =>
             {
                 if (!LoadedBeatmapSuccessfully)
                     return;
 
-                ((IBindable<bool>)leaderboard.Expanded).BindTo(HUDOverlay.ShowHud);
+                leaderboard.Expanded.BindTo(leaderboardExpanded);
 
                 leaderboardFlow.Insert(0, l);
 
@@ -99,7 +104,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
 
             LoadComponentAsync(new GameplayChatDisplay(Room)
             {
-                Expanded = { BindTarget = HUDOverlay.ShowHud },
+                Expanded = { BindTarget = leaderboardExpanded },
             }, chat => leaderboardFlow.Insert(2, chat));
 
             HUDOverlay.Add(loadingDisplay = new LoadingLayer(true) { Depth = float.MaxValue });
@@ -152,6 +157,9 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
             }
         }
 
+        private void updateLeaderboardExpandedState() =>
+            leaderboardExpanded.Value = !LocalUserPlaying.Value || HUDOverlay.HoldingForHUD.Value;
+
         private void failAndBail(string message = null)
         {
             if (!string.IsNullOrEmpty(message))

From d51689e9ae38a0f0030ac436701d22d57465b51d Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 11 May 2022 11:25:41 +0300
Subject: [PATCH 4769/5547] Unfocus textbox when dismissing popover in test
 scene

---
 .../Editing/TestSceneHitObjectDifficultyPointAdjustments.cs      | 1 +
 .../Visual/Editing/TestSceneHitObjectSamplePointAdjustments.cs   | 1 +
 2 files changed, 2 insertions(+)

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneHitObjectDifficultyPointAdjustments.cs b/osu.Game.Tests/Visual/Editing/TestSceneHitObjectDifficultyPointAdjustments.cs
index 7f82d5966e..7c05abc2cd 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneHitObjectDifficultyPointAdjustments.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneHitObjectDifficultyPointAdjustments.cs
@@ -168,6 +168,7 @@ namespace osu.Game.Tests.Visual.Editing
 
         private void dismissPopover()
         {
+            AddStep("unfocus textbox", () => InputManager.Key(Key.Escape));
             AddStep("dismiss popover", () => InputManager.Key(Key.Escape));
             AddUntilStep("wait for dismiss", () => !this.ChildrenOfType<DifficultyPointPiece.DifficultyEditPopover>().Any(popover => popover.IsPresent));
         }
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneHitObjectSamplePointAdjustments.cs b/osu.Game.Tests/Visual/Editing/TestSceneHitObjectSamplePointAdjustments.cs
index fcdf4a6e33..4501eea88e 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneHitObjectSamplePointAdjustments.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneHitObjectSamplePointAdjustments.cs
@@ -231,6 +231,7 @@ namespace osu.Game.Tests.Visual.Editing
 
         private void dismissPopover()
         {
+            AddStep("unfocus textbox", () => InputManager.Key(Key.Escape));
             AddStep("dismiss popover", () => InputManager.Key(Key.Escape));
             AddUntilStep("wait for dismiss", () => !this.ChildrenOfType<SamplePointPiece.SampleEditPopover>().Any(popover => popover.IsPresent));
         }

From 551370d27b1a9c4e941335e706efc9bc19896cfe Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 11 May 2022 18:26:08 +0900
Subject: [PATCH 4770/5547] Update ReSharper package

---
 .config/dotnet-tools.json | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.config/dotnet-tools.json b/.config/dotnet-tools.json
index 1132396608..65ac05261a 100644
--- a/.config/dotnet-tools.json
+++ b/.config/dotnet-tools.json
@@ -3,7 +3,7 @@
   "isRoot": true,
   "tools": {
     "jetbrains.resharper.globaltools": {
-      "version": "2022.1.0-eap10",
+      "version": "2022.1.1",
       "commands": [
         "jb"
       ]
@@ -27,4 +27,4 @@
       ]
     }
   }
-}
+}
\ No newline at end of file

From a46894b613df38cb0d4d159f6e86a87dd2a0e8fb Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 11 May 2022 18:27:57 +0900
Subject: [PATCH 4771/5547] Bust CI cache on more files

---
 .github/workflows/ci.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 514acef525..729f2f266d 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -31,7 +31,7 @@ jobs:
         uses: actions/cache@v3
         with:
           path: ${{ github.workspace }}/inspectcode
-          key: inspectcode-${{ hashFiles('.config/dotnet-tools.json') }}-${{ hashFiles('.github/workflows/ci.yml' ) }}
+          key: inspectcode-${{ hashFiles('.config/dotnet-tools.json', '.github/workflows/ci.yml', 'osu.sln*', '.editorconfig', '.globalconfig') }}
 
       - name: Dotnet code style
         run: dotnet build -c Debug -warnaserror osu.Desktop.slnf -p:EnforceCodeStyleInBuild=true

From fecf92e16f926b2d5e2a8f51b2e3c03bf8736d0d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 11 May 2022 19:51:22 +0900
Subject: [PATCH 4772/5547] Update libraries to latest versions

---
 .../osu.Game.Rulesets.EmptyFreeform.Tests.csproj   |  2 +-
 .../osu.Game.Rulesets.Pippidon.Tests.csproj        |  2 +-
 .../osu.Game.Rulesets.EmptyScrolling.Tests.csproj  |  2 +-
 .../osu.Game.Rulesets.Pippidon.Tests.csproj        |  2 +-
 osu.Android.props                                  |  2 +-
 osu.Desktop/osu.Desktop.csproj                     |  2 +-
 osu.Game.Benchmarks/osu.Game.Benchmarks.csproj     |  2 +-
 .../osu.Game.Rulesets.Catch.Tests.csproj           |  2 +-
 .../osu.Game.Rulesets.Mania.Tests.csproj           |  2 +-
 .../osu.Game.Rulesets.Osu.Tests.csproj             |  2 +-
 .../osu.Game.Rulesets.Taiko.Tests.csproj           |  2 +-
 osu.Game.Tests/osu.Game.Tests.csproj               |  2 +-
 .../osu.Game.Tournament.Tests.csproj               |  2 +-
 osu.Game/osu.Game.csproj                           | 14 +++++++-------
 osu.iOS.props                                      |  8 ++++----
 15 files changed, 24 insertions(+), 24 deletions(-)

diff --git a/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform.Tests/osu.Game.Rulesets.EmptyFreeform.Tests.csproj b/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform.Tests/osu.Game.Rulesets.EmptyFreeform.Tests.csproj
index cb922c5a58..bc285dbe11 100644
--- a/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform.Tests/osu.Game.Rulesets.EmptyFreeform.Tests.csproj
+++ b/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform.Tests/osu.Game.Rulesets.EmptyFreeform.Tests.csproj
@@ -11,7 +11,7 @@
   <ItemGroup Label="Package References">
     <PackageReference Include="Appveyor.TestLogger" Version="2.0.0" />
     <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.0.0" />
-    <PackageReference Include="NUnit" Version="3.13.2" />
+    <PackageReference Include="NUnit" Version="3.13.3" />
     <PackageReference Include="NUnit3TestAdapter" Version="4.1.0" />
     <PackageReference Update="Microsoft.EntityFrameworkCore.Sqlite" Version="2.1.4" />
   </ItemGroup>
diff --git a/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon.Tests/osu.Game.Rulesets.Pippidon.Tests.csproj b/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon.Tests/osu.Game.Rulesets.Pippidon.Tests.csproj
index 5ecd9cc675..718ada1905 100644
--- a/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon.Tests/osu.Game.Rulesets.Pippidon.Tests.csproj
+++ b/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon.Tests/osu.Game.Rulesets.Pippidon.Tests.csproj
@@ -11,7 +11,7 @@
   <ItemGroup Label="Package References">
     <PackageReference Include="Appveyor.TestLogger" Version="2.0.0" />
     <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.0.0" />
-    <PackageReference Include="NUnit" Version="3.13.2" />
+    <PackageReference Include="NUnit" Version="3.13.3" />
     <PackageReference Include="NUnit3TestAdapter" Version="4.1.0" />
     <PackageReference Update="Microsoft.EntityFrameworkCore.Sqlite" Version="2.1.4" />
   </ItemGroup>
diff --git a/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling.Tests/osu.Game.Rulesets.EmptyScrolling.Tests.csproj b/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling.Tests/osu.Game.Rulesets.EmptyScrolling.Tests.csproj
index 33ad0ac4f7..6b9c3f4d63 100644
--- a/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling.Tests/osu.Game.Rulesets.EmptyScrolling.Tests.csproj
+++ b/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling.Tests/osu.Game.Rulesets.EmptyScrolling.Tests.csproj
@@ -11,7 +11,7 @@
   <ItemGroup Label="Package References">
     <PackageReference Include="Appveyor.TestLogger" Version="2.0.0" />
     <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.0.0" />
-    <PackageReference Include="NUnit" Version="3.13.2" />
+    <PackageReference Include="NUnit" Version="3.13.3" />
     <PackageReference Include="NUnit3TestAdapter" Version="4.1.0" />
     <PackageReference Update="Microsoft.EntityFrameworkCore.Sqlite" Version="2.1.4" />
   </ItemGroup>
diff --git a/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon.Tests/osu.Game.Rulesets.Pippidon.Tests.csproj b/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon.Tests/osu.Game.Rulesets.Pippidon.Tests.csproj
index 5ecd9cc675..718ada1905 100644
--- a/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon.Tests/osu.Game.Rulesets.Pippidon.Tests.csproj
+++ b/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon.Tests/osu.Game.Rulesets.Pippidon.Tests.csproj
@@ -11,7 +11,7 @@
   <ItemGroup Label="Package References">
     <PackageReference Include="Appveyor.TestLogger" Version="2.0.0" />
     <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.0.0" />
-    <PackageReference Include="NUnit" Version="3.13.2" />
+    <PackageReference Include="NUnit" Version="3.13.3" />
     <PackageReference Include="NUnit3TestAdapter" Version="4.1.0" />
     <PackageReference Update="Microsoft.EntityFrameworkCore.Sqlite" Version="2.1.4" />
   </ItemGroup>
diff --git a/osu.Android.props b/osu.Android.props
index 97d9dbc380..af4a93d191 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -56,6 +56,6 @@
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
     <!-- Realm needs to be directly referenced in all Xamarin projects, as it will not pull in its transitive dependencies otherwise. -->
-    <PackageReference Include="Realm" Version="10.10.0" />
+    <PackageReference Include="Realm" Version="10.12.0" />
   </ItemGroup>
 </Project>
diff --git a/osu.Desktop/osu.Desktop.csproj b/osu.Desktop/osu.Desktop.csproj
index a4f309c6ac..a4f9e2671b 100644
--- a/osu.Desktop/osu.Desktop.csproj
+++ b/osu.Desktop/osu.Desktop.csproj
@@ -24,7 +24,7 @@
     <ProjectReference Include="..\osu.Game.Rulesets.Taiko\osu.Game.Rulesets.Taiko.csproj" />
   </ItemGroup>
   <ItemGroup Label="Package References">
-    <PackageReference Include="Clowd.Squirrel" Version="2.9.23-gc8da1a" />
+    <PackageReference Include="Clowd.Squirrel" Version="2.9.40" />
     <PackageReference Include="Mono.Posix.NETStandard" Version="1.0.0" />
     <PackageReference Include="System.IO.Packaging" Version="6.0.0" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="5.0.14" />
diff --git a/osu.Game.Benchmarks/osu.Game.Benchmarks.csproj b/osu.Game.Benchmarks/osu.Game.Benchmarks.csproj
index 434c0e0367..36ffd3b5b6 100644
--- a/osu.Game.Benchmarks/osu.Game.Benchmarks.csproj
+++ b/osu.Game.Benchmarks/osu.Game.Benchmarks.csproj
@@ -8,7 +8,7 @@
 
   <ItemGroup>
     <PackageReference Include="BenchmarkDotNet" Version="0.13.1" />
-    <PackageReference Include="nunit" Version="3.13.2" />
+    <PackageReference Include="nunit" Version="3.13.3" />
     <PackageReference Include="NUnit3TestAdapter" Version="4.1.0" />
   </ItemGroup>
 
diff --git a/osu.Game.Rulesets.Catch.Tests/osu.Game.Rulesets.Catch.Tests.csproj b/osu.Game.Rulesets.Catch.Tests/osu.Game.Rulesets.Catch.Tests.csproj
index fc6d900567..b957ade952 100644
--- a/osu.Game.Rulesets.Catch.Tests/osu.Game.Rulesets.Catch.Tests.csproj
+++ b/osu.Game.Rulesets.Catch.Tests/osu.Game.Rulesets.Catch.Tests.csproj
@@ -3,7 +3,7 @@
   <ItemGroup Label="Package References">
     <PackageReference Include="Appveyor.TestLogger" Version="2.0.0" />
     <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.0.0" />
-    <PackageReference Include="NUnit" Version="3.13.2" />
+    <PackageReference Include="NUnit" Version="3.13.3" />
     <PackageReference Include="NUnit3TestAdapter" Version="4.1.0" />
     <PackageReference Update="Microsoft.EntityFrameworkCore.Sqlite" Version="2.1.4" />
   </ItemGroup>
diff --git a/osu.Game.Rulesets.Mania.Tests/osu.Game.Rulesets.Mania.Tests.csproj b/osu.Game.Rulesets.Mania.Tests/osu.Game.Rulesets.Mania.Tests.csproj
index ddad2adfea..d3b4b378c0 100644
--- a/osu.Game.Rulesets.Mania.Tests/osu.Game.Rulesets.Mania.Tests.csproj
+++ b/osu.Game.Rulesets.Mania.Tests/osu.Game.Rulesets.Mania.Tests.csproj
@@ -3,7 +3,7 @@
   <ItemGroup Label="Package References">
     <PackageReference Include="Appveyor.TestLogger" Version="2.0.0" />
     <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.0.0" />
-    <PackageReference Include="NUnit" Version="3.13.2" />
+    <PackageReference Include="NUnit" Version="3.13.3" />
     <PackageReference Include="NUnit3TestAdapter" Version="4.1.0" />
     <PackageReference Update="Microsoft.EntityFrameworkCore.Sqlite" Version="2.1.4" />
   </ItemGroup>
diff --git a/osu.Game.Rulesets.Osu.Tests/osu.Game.Rulesets.Osu.Tests.csproj b/osu.Game.Rulesets.Osu.Tests/osu.Game.Rulesets.Osu.Tests.csproj
index 4ce29ab5c7..2c0d3fd937 100644
--- a/osu.Game.Rulesets.Osu.Tests/osu.Game.Rulesets.Osu.Tests.csproj
+++ b/osu.Game.Rulesets.Osu.Tests/osu.Game.Rulesets.Osu.Tests.csproj
@@ -4,7 +4,7 @@
     <PackageReference Include="Appveyor.TestLogger" Version="2.0.0" />
     <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.0.0" />
     <PackageReference Include="Moq" Version="4.17.2" />
-    <PackageReference Include="NUnit" Version="3.13.2" />
+    <PackageReference Include="NUnit" Version="3.13.3" />
     <PackageReference Include="NUnit3TestAdapter" Version="4.1.0" />
     <PackageReference Update="Microsoft.EntityFrameworkCore.Sqlite" Version="2.1.4" />
   </ItemGroup>
diff --git a/osu.Game.Rulesets.Taiko.Tests/osu.Game.Rulesets.Taiko.Tests.csproj b/osu.Game.Rulesets.Taiko.Tests/osu.Game.Rulesets.Taiko.Tests.csproj
index a6b8eb8651..ce468d399b 100644
--- a/osu.Game.Rulesets.Taiko.Tests/osu.Game.Rulesets.Taiko.Tests.csproj
+++ b/osu.Game.Rulesets.Taiko.Tests/osu.Game.Rulesets.Taiko.Tests.csproj
@@ -3,7 +3,7 @@
   <ItemGroup Label="Package References">
     <PackageReference Include="Appveyor.TestLogger" Version="2.0.0" />
     <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.0.0" />
-    <PackageReference Include="NUnit" Version="3.13.2" />
+    <PackageReference Include="NUnit" Version="3.13.3" />
     <PackageReference Include="NUnit3TestAdapter" Version="4.1.0" />
     <PackageReference Update="Microsoft.EntityFrameworkCore.Sqlite" Version="2.1.4" />
   </ItemGroup>
diff --git a/osu.Game.Tests/osu.Game.Tests.csproj b/osu.Game.Tests/osu.Game.Tests.csproj
index 0bcf533653..a1eef4ce47 100644
--- a/osu.Game.Tests/osu.Game.Tests.csproj
+++ b/osu.Game.Tests/osu.Game.Tests.csproj
@@ -5,7 +5,7 @@
     <PackageReference Include="DeepEqual" Version="2.0.0" />
     <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.0.0" />
     <PackageReference Include="Nito.AsyncEx" Version="5.1.2" />
-    <PackageReference Include="NUnit" Version="3.13.2" />
+    <PackageReference Include="NUnit" Version="3.13.3" />
     <PackageReference Include="NUnit3TestAdapter" Version="4.1.0" />
     <PackageReference Update="Microsoft.EntityFrameworkCore.Sqlite" Version="2.1.4" />
     <PackageReference Include="Moq" Version="4.17.2" />
diff --git a/osu.Game.Tournament.Tests/osu.Game.Tournament.Tests.csproj b/osu.Game.Tournament.Tests/osu.Game.Tournament.Tests.csproj
index c7314a4969..6fd53d923b 100644
--- a/osu.Game.Tournament.Tests/osu.Game.Tournament.Tests.csproj
+++ b/osu.Game.Tournament.Tests/osu.Game.Tournament.Tests.csproj
@@ -6,7 +6,7 @@
   <ItemGroup Label="Package References">
     <PackageReference Include="Appveyor.TestLogger" Version="2.0.0" />
     <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.0.0" />
-    <PackageReference Include="NUnit" Version="3.13.2" />
+    <PackageReference Include="NUnit" Version="3.13.3" />
     <PackageReference Include="NUnit3TestAdapter" Version="4.1.0" />
   </ItemGroup>
   <PropertyGroup Label="Project">
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 2f32c843c0..89cb882981 100644
--- a/osu.Game/osu.Game.csproj
+++ b/osu.Game/osu.Game.csproj
@@ -23,9 +23,9 @@
     <PackageReference Include="HtmlAgilityPack" Version="1.11.42" />
     <PackageReference Include="Humanizer" Version="2.14.1" />
     <PackageReference Include="MessagePack" Version="2.3.85" />
-    <PackageReference Include="Microsoft.AspNetCore.SignalR.Client" Version="6.0.3" />
-    <PackageReference Include="Microsoft.AspNetCore.SignalR.Protocols.MessagePack" Version="6.0.3" />
-    <PackageReference Include="Microsoft.AspNetCore.SignalR.Protocols.NewtonsoftJson" Version="6.0.3" />
+    <PackageReference Include="Microsoft.AspNetCore.SignalR.Client" Version="6.0.5" />
+    <PackageReference Include="Microsoft.AspNetCore.SignalR.Protocols.MessagePack" Version="6.0.5" />
+    <PackageReference Include="Microsoft.AspNetCore.SignalR.Protocols.NewtonsoftJson" Version="6.0.5" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="5.0.14" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.Core" Version="5.0.14" />
     <PackageReference Include="Microsoft.Extensions.Configuration.Abstractions" Version="6.0.0" />
@@ -34,12 +34,12 @@
       <PrivateAssets>all</PrivateAssets>
       <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
     </PackageReference>
-    <PackageReference Include="Realm" Version="10.10.0" />
+    <PackageReference Include="Realm" Version="10.12.0" />
     <PackageReference Include="ppy.osu.Framework" Version="2022.509.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.422.0" />
-    <PackageReference Include="Sentry" Version="3.14.1" />
-    <PackageReference Include="SharpCompress" Version="0.30.1" />
-    <PackageReference Include="NUnit" Version="3.13.2" />
+    <PackageReference Include="Sentry" Version="3.17.1" />
+    <PackageReference Include="SharpCompress" Version="0.31.0" />
+    <PackageReference Include="NUnit" Version="3.13.3" />
     <PackageReference Include="System.ComponentModel.Annotations" Version="5.0.0" />
     <PackageReference Include="TagLibSharp" Version="2.2.0" />
   </ItemGroup>
diff --git a/osu.iOS.props b/osu.iOS.props
index b483267696..46580705f7 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -85,10 +85,10 @@
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.Core" Version="5.0.14" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
     <PackageReference Include="ppy.osu.Framework" Version="2022.509.0" />
-    <PackageReference Include="SharpCompress" Version="0.30.1" />
-    <PackageReference Include="NUnit" Version="3.13.2" />
+    <PackageReference Include="SharpCompress" Version="0.31.0" />
+    <PackageReference Include="NUnit" Version="3.13.3" />
     <PackageReference Include="System.ComponentModel.Annotations" Version="5.0.0" />
-    <PackageReference Include="ppy.osu.Framework.NativeLibs" Version="2021.1221.0" ExcludeAssets="all" />
-    <PackageReference Include="Realm" Version="10.10.0" />
+    <PackageReference Include="ppy.osu.Framework.NativeLibs" Version="2022.429.0" ExcludeAssets="all" />
+    <PackageReference Include="Realm" Version="10.12.0" />
   </ItemGroup>
 </Project>

From 3cbd19a9ce09c800005e6b51d263e4d4593362d5 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 11 May 2022 21:17:16 +0900
Subject: [PATCH 4773/5547] Update framework

---
 osu.Android.props        | 2 +-
 osu.Game/osu.Game.csproj | 2 +-
 osu.iOS.props            | 4 ++--
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Android.props b/osu.Android.props
index af4a93d191..98dc28d915 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -52,7 +52,7 @@
   </ItemGroup>
   <ItemGroup>
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.422.0" />
-    <PackageReference Include="ppy.osu.Framework.Android" Version="2022.509.0" />
+    <PackageReference Include="ppy.osu.Framework.Android" Version="2022.511.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
     <!-- Realm needs to be directly referenced in all Xamarin projects, as it will not pull in its transitive dependencies otherwise. -->
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 89cb882981..772a78c8fe 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="10.12.0" />
-    <PackageReference Include="ppy.osu.Framework" Version="2022.509.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2022.511.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.422.0" />
     <PackageReference Include="Sentry" Version="3.17.1" />
     <PackageReference Include="SharpCompress" Version="0.31.0" />
diff --git a/osu.iOS.props b/osu.iOS.props
index 46580705f7..af8f9b617c 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -61,7 +61,7 @@
     <Reference Include="System.Net.Http" />
   </ItemGroup>
   <ItemGroup Label="Package References">
-    <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.509.0" />
+    <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.511.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.422.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net6.0) -->
@@ -84,7 +84,7 @@
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="5.0.14" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.Core" Version="5.0.14" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
-    <PackageReference Include="ppy.osu.Framework" Version="2022.509.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2022.511.0" />
     <PackageReference Include="SharpCompress" Version="0.31.0" />
     <PackageReference Include="NUnit" Version="3.13.3" />
     <PackageReference Include="System.ComponentModel.Annotations" Version="5.0.0" />

From 9d30b490ade53ada8771a704a03163c04f15028f Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 11 May 2022 18:26:04 +0300
Subject: [PATCH 4774/5547] Fix intermittent test failures in results screen

---
 .../Visual/Ranking/TestSceneResultsScreen.cs  | 32 ++++++++++++++-----
 1 file changed, 24 insertions(+), 8 deletions(-)

diff --git a/osu.Game.Tests/Visual/Ranking/TestSceneResultsScreen.cs b/osu.Game.Tests/Visual/Ranking/TestSceneResultsScreen.cs
index a1d51683e4..2a5fc050d3 100644
--- a/osu.Game.Tests/Visual/Ranking/TestSceneResultsScreen.cs
+++ b/osu.Game.Tests/Visual/Ranking/TestSceneResultsScreen.cs
@@ -103,7 +103,7 @@ namespace osu.Game.Tests.Visual.Ranking
             score.Accuracy = accuracy;
             score.Rank = rank;
 
-            AddStep("load results", () => Child = new TestResultsContainer(screen = createResultsScreen(score)));
+            loadResultsScreen(() => screen = createResultsScreen(score));
             AddUntilStep("wait for loaded", () => screen.IsLoaded);
             AddAssert("retry overlay present", () => screen.RetryOverlay != null);
         }
@@ -113,7 +113,7 @@ namespace osu.Game.Tests.Visual.Ranking
         {
             UnrankedSoloResultsScreen screen = null;
 
-            AddStep("load results", () => Child = new TestResultsContainer(screen = createUnrankedSoloResultsScreen()));
+            loadResultsScreen(() => screen = createUnrankedSoloResultsScreen());
             AddUntilStep("wait for loaded", () => screen.IsLoaded);
             AddAssert("retry overlay present", () => screen.RetryOverlay != null);
         }
@@ -123,7 +123,7 @@ namespace osu.Game.Tests.Visual.Ranking
         {
             TestResultsScreen screen = null;
 
-            AddStep("load results", () => Child = new TestResultsContainer(screen = createResultsScreen()));
+            loadResultsScreen(() => screen = createResultsScreen());
             AddUntilStep("wait for load", () => this.ChildrenOfType<ScorePanelList>().Single().AllPanelsVisible);
 
             AddStep("click expanded panel", () =>
@@ -162,7 +162,7 @@ namespace osu.Game.Tests.Visual.Ranking
         {
             TestResultsScreen screen = null;
 
-            AddStep("load results", () => Child = new TestResultsContainer(screen = createResultsScreen()));
+            loadResultsScreen(() => screen = createResultsScreen());
             AddUntilStep("wait for load", () => this.ChildrenOfType<ScorePanelList>().Single().AllPanelsVisible);
 
             AddStep("click expanded panel", () =>
@@ -201,7 +201,7 @@ namespace osu.Game.Tests.Visual.Ranking
         {
             TestResultsScreen screen = null;
 
-            AddStep("load results", () => Child = new TestResultsContainer(screen = createResultsScreen()));
+            loadResultsScreen(() => screen = createResultsScreen());
             AddUntilStep("wait for load", () => this.ChildrenOfType<ScorePanelList>().Single().AllPanelsVisible);
 
             ScorePanel expandedPanel = null;
@@ -231,7 +231,7 @@ namespace osu.Game.Tests.Visual.Ranking
 
             var tcs = new TaskCompletionSource<bool>();
 
-            AddStep("load results", () => Child = new TestResultsContainer(screen = new DelayedFetchResultsScreen(TestResources.CreateTestScoreInfo(), tcs.Task)));
+            loadResultsScreen(() => screen = new DelayedFetchResultsScreen(TestResources.CreateTestScoreInfo(), tcs.Task));
 
             AddUntilStep("wait for loaded", () => screen.IsLoaded);
 
@@ -255,7 +255,7 @@ namespace osu.Game.Tests.Visual.Ranking
         {
             TestResultsScreen screen = null;
 
-            AddStep("load results", () => Child = new TestResultsContainer(screen = createResultsScreen()));
+            loadResultsScreen(() => screen = createResultsScreen());
             AddUntilStep("wait for load", () => this.ChildrenOfType<ScorePanelList>().Single().AllPanelsVisible);
 
             AddAssert("download button is disabled", () => !screen.ChildrenOfType<DownloadButton>().Last().Enabled.Value);
@@ -276,7 +276,7 @@ namespace osu.Game.Tests.Visual.Ranking
             var ruleset = new RulesetWithNoPerformanceCalculator();
             var score = TestResources.CreateTestScoreInfo(ruleset.RulesetInfo);
 
-            AddStep("load results", () => Child = new TestResultsContainer(createResultsScreen(score)));
+            loadResultsScreen(() => createResultsScreen(score));
             AddUntilStep("wait for load", () => this.ChildrenOfType<ScorePanelList>().Single().AllPanelsVisible);
 
             AddAssert("PP displayed as 0", () =>
@@ -287,6 +287,22 @@ namespace osu.Game.Tests.Visual.Ranking
             });
         }
 
+        private void loadResultsScreen(Func<ResultsScreen> createResults)
+        {
+            ResultsScreen results = null;
+
+            AddStep("load results", () => Child = new TestResultsContainer(results = createResults()));
+
+            // expanded panel should be centered the moment results screen is loaded
+            // but can potentially be scrolled away on certain specific load scenarios.
+            // see: https://github.com/ppy/osu/issues/18226
+            AddUntilStep("expanded panel in centre of screen", () =>
+            {
+                var expandedPanel = this.ChildrenOfType<ScorePanel>().Single(p => p.State == PanelState.Expanded);
+                return Precision.AlmostEquals(expandedPanel.ScreenSpaceDrawQuad.Centre.X, results.ScreenSpaceDrawQuad.Centre.X, 1);
+            });
+        }
+
         private TestResultsScreen createResultsScreen(ScoreInfo score = null) => new TestResultsScreen(score ?? TestResources.CreateTestScoreInfo());
 
         private UnrankedSoloResultsScreen createUnrankedSoloResultsScreen() => new UnrankedSoloResultsScreen(TestResources.CreateTestScoreInfo());

From a104277e7fbd1315fa230fa67d6be9ea317f92e4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 11 May 2022 18:01:33 +0200
Subject: [PATCH 4775/5547] Rename `ModSelect{Screen -> Overlay}Strings`

---
 ...ModSelectScreenStrings.cs => ModSelectOverlayStrings.cs} | 6 +++---
 osu.Game/Overlays/Mods/ModSelectOverlay.cs                  | 6 +++---
 2 files changed, 6 insertions(+), 6 deletions(-)
 rename osu.Game/Localisation/{ModSelectScreenStrings.cs => ModSelectOverlayStrings.cs} (94%)

diff --git a/osu.Game/Localisation/ModSelectScreenStrings.cs b/osu.Game/Localisation/ModSelectOverlayStrings.cs
similarity index 94%
rename from osu.Game/Localisation/ModSelectScreenStrings.cs
rename to osu.Game/Localisation/ModSelectOverlayStrings.cs
index 0c113fd381..e9af7147e3 100644
--- a/osu.Game/Localisation/ModSelectScreenStrings.cs
+++ b/osu.Game/Localisation/ModSelectOverlayStrings.cs
@@ -5,9 +5,9 @@ using osu.Framework.Localisation;
 
 namespace osu.Game.Localisation
 {
-    public static class ModSelectScreenStrings
+    public static class ModSelectOverlayStrings
     {
-        private const string prefix = @"osu.Game.Resources.Localisation.ModSelectScreen";
+        private const string prefix = @"osu.Game.Resources.Localisation.ModSelectOverlay";
 
         /// <summary>
         /// "Mod Select"
@@ -26,4 +26,4 @@ namespace osu.Game.Localisation
 
         private static string getKey(string key) => $@"{prefix}:{key}";
     }
-}
\ No newline at end of file
+}
diff --git a/osu.Game/Overlays/Mods/ModSelectOverlay.cs b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
index b589b2e7e1..7a8e89584a 100644
--- a/osu.Game/Overlays/Mods/ModSelectOverlay.cs
+++ b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
@@ -84,8 +84,8 @@ namespace osu.Game.Overlays.Mods
         [BackgroundDependencyLoader]
         private void load(OsuColour colours)
         {
-            Header.Title = ModSelectScreenStrings.ModSelectTitle;
-            Header.Description = ModSelectScreenStrings.ModSelectDescription;
+            Header.Title = ModSelectOverlayStrings.ModSelectTitle;
+            Header.Description = ModSelectOverlayStrings.ModSelectDescription;
 
             AddRange(new Drawable[]
             {
@@ -262,7 +262,7 @@ namespace osu.Game.Overlays.Mods
             {
                 customisationButton = new ShearedToggleButton(BUTTON_WIDTH)
                 {
-                    Text = ModSelectScreenStrings.ModCustomisation,
+                    Text = ModSelectOverlayStrings.ModCustomisation,
                     Active = { BindTarget = customisationVisible }
                 },
                 new ShearedButton(BUTTON_WIDTH)

From 62f6caf76dcc836b08a7db054d7f77d149c551c2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 11 May 2022 18:04:39 +0200
Subject: [PATCH 4776/5547] Rename `ModSelect{Screen -> Overlay}` test scenes

---
 ...eFreeModSelectScreen.cs => TestSceneFreeModSelectOverlay.cs} | 2 +-
 ...TestSceneModSelectScreen.cs => TestSceneModSelectOverlay.cs} | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)
 rename osu.Game.Tests/Visual/Multiplayer/{TestSceneFreeModSelectScreen.cs => TestSceneFreeModSelectOverlay.cs} (98%)
 rename osu.Game.Tests/Visual/UserInterface/{TestSceneModSelectScreen.cs => TestSceneModSelectOverlay.cs} (99%)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneFreeModSelectScreen.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneFreeModSelectOverlay.cs
similarity index 98%
rename from osu.Game.Tests/Visual/Multiplayer/TestSceneFreeModSelectScreen.cs
rename to osu.Game.Tests/Visual/Multiplayer/TestSceneFreeModSelectOverlay.cs
index 9a24a1c646..f40c31b07f 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneFreeModSelectScreen.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneFreeModSelectOverlay.cs
@@ -17,7 +17,7 @@ using osuTK.Input;
 
 namespace osu.Game.Tests.Visual.Multiplayer
 {
-    public class TestSceneFreeModSelectScreen : MultiplayerTestScene
+    public class TestSceneFreeModSelectOverlay : MultiplayerTestScene
     {
         private FreeModSelectOverlay freeModSelectOverlay;
         private readonly Bindable<Dictionary<ModType, IReadOnlyList<Mod>>> availableMods = new Bindable<Dictionary<ModType, IReadOnlyList<Mod>>>();
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectOverlay.cs
similarity index 99%
rename from osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs
rename to osu.Game.Tests/Visual/UserInterface/TestSceneModSelectOverlay.cs
index 2e2ce6edd7..08ad030b39 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectScreen.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectOverlay.cs
@@ -24,7 +24,7 @@ using osuTK.Input;
 namespace osu.Game.Tests.Visual.UserInterface
 {
     [TestFixture]
-    public class TestSceneModSelectScreen : OsuManualInputManagerTestScene
+    public class TestSceneModSelectOverlay : OsuManualInputManagerTestScene
     {
         [Resolved]
         private RulesetStore rulesetStore { get; set; }

From 9b7ff9f2ee3d9aee2eb443c1e354024e8eae07ed Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 11 May 2022 18:05:09 +0200
Subject: [PATCH 4777/5547] Rename `modSelect{Screen -> Overlay}2` variable

---
 .../Visual/UserInterface/TestSceneModSelectOverlay.cs       | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectOverlay.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectOverlay.cs
index 08ad030b39..fc543d9db7 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectOverlay.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectOverlay.cs
@@ -222,7 +222,7 @@ namespace osu.Game.Tests.Visual.UserInterface
         public void TestSettingsNotCrossPolluting()
         {
             Bindable<IReadOnlyList<Mod>> selectedMods2 = null;
-            ModSelectOverlay modSelectScreen2 = null;
+            ModSelectOverlay modSelectOverlay2 = null;
 
             createScreen();
             AddStep("select diff adjust", () => SelectedMods.Value = new Mod[] { new OsuModDifficultyAdjust() });
@@ -235,7 +235,7 @@ namespace osu.Game.Tests.Visual.UserInterface
 
             AddStep("create second overlay", () =>
             {
-                Add(modSelectScreen2 = new UserModSelectOverlay().With(d =>
+                Add(modSelectOverlay2 = new UserModSelectOverlay().With(d =>
                 {
                     d.Origin = Anchor.TopCentre;
                     d.Anchor = Anchor.TopCentre;
@@ -243,7 +243,7 @@ namespace osu.Game.Tests.Visual.UserInterface
                 }));
             });
 
-            AddStep("show", () => modSelectScreen2.Show());
+            AddStep("show", () => modSelectOverlay2.Show());
 
             AddAssert("ensure first is unchanged", () => SelectedMods.Value.OfType<OsuModDifficultyAdjust>().Single().CircleSize.Value == 8);
             AddAssert("ensure second is default", () => selectedMods2.Value.OfType<OsuModDifficultyAdjust>().Single().CircleSize.Value == null);

From ddb2d4eef51220e0f41835ddfe4ec593482279fb Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 11 May 2022 18:06:09 +0200
Subject: [PATCH 4778/5547] Rename `FreeModSelect{Screen -> Overlay}` reference
 in inline comment

---
 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 7a8e89584a..b3c3eee15a 100644
--- a/osu.Game/Overlays/Mods/ModSelectOverlay.cs
+++ b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
@@ -193,7 +193,7 @@ namespace osu.Game.Overlays.Mods
             State.BindValueChanged(_ => samplePlaybackDisabled.Value = State.Value == Visibility.Hidden, true);
 
             // This is an optimisation to prevent refreshing the available settings controls when it can be
-            // reasonably assumed that the settings panel is never to be displayed (e.g. FreeModSelectScreen).
+            // reasonably assumed that the settings panel is never to be displayed (e.g. FreeModSelectOverlay).
             if (customisationButton != null)
                 ((IBindable<IReadOnlyList<Mod>>)modSettingsArea.SelectedMods).BindTo(SelectedMods);
 

From 315c67a316343e8935c61e640aa502c418e887cf Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 11 May 2022 19:59:30 +0200
Subject: [PATCH 4779/5547] Add failing test case for ruleset without all mod
 types

---
 .../UserInterface/TestSceneModSelectOverlay.cs   | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectOverlay.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectOverlay.cs
index fc543d9db7..0b037a10cd 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectOverlay.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectOverlay.cs
@@ -18,6 +18,7 @@ using osu.Game.Rulesets;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Osu.Mods;
+using osu.Game.Tests.Mods;
 using osuTK;
 using osuTK.Input;
 
@@ -481,6 +482,21 @@ namespace osu.Game.Tests.Visual.UserInterface
             AddUntilStep("3 columns visible", () => this.ChildrenOfType<ModColumn>().Count(col => col.IsPresent) == 3);
         }
 
+        [Test]
+        public void TestColumnHidingOnRulesetChange()
+        {
+            createScreen();
+
+            changeRuleset(0);
+            AddAssert("5 columns visible", () => this.ChildrenOfType<ModColumn>().Count(col => col.IsPresent) == 5);
+
+            AddStep("change to ruleset without all mod types", () => Ruleset.Value = TestCustomisableModRuleset.CreateTestRulesetInfo());
+            AddUntilStep("1 column visible", () => this.ChildrenOfType<ModColumn>().Count(col => col.IsPresent) == 1);
+
+            changeRuleset(0);
+            AddAssert("5 columns visible", () => this.ChildrenOfType<ModColumn>().Count(col => col.IsPresent) == 5);
+        }
+
         private void waitForColumnLoad() => AddUntilStep("all column content loaded",
             () => modSelectOverlay.ChildrenOfType<ModColumn>().Any() && modSelectOverlay.ChildrenOfType<ModColumn>().All(column => column.IsLoaded && column.ItemsLoaded));
 

From 478cfc0b87ac3a6062e5948fe8df496df0fac991 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 11 May 2022 18:26:52 +0200
Subject: [PATCH 4780/5547] Split model class for mod state

---
 osu.Game/Overlays/Mods/ModState.cs | 35 ++++++++++++++++++++++++++++++
 1 file changed, 35 insertions(+)
 create mode 100644 osu.Game/Overlays/Mods/ModState.cs

diff --git a/osu.Game/Overlays/Mods/ModState.cs b/osu.Game/Overlays/Mods/ModState.cs
new file mode 100644
index 0000000000..8fdd5db00b
--- /dev/null
+++ b/osu.Game/Overlays/Mods/ModState.cs
@@ -0,0 +1,35 @@
+// 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.Game.Rulesets.Mods;
+
+namespace osu.Game.Overlays.Mods
+{
+    /// <summary>
+    /// Wrapper class used to store the current state of a mod shown on the <see cref="ModSelectOverlay"/>.
+    /// Used primarily to decouple data from drawable logic.
+    /// </summary>
+    public class ModState
+    {
+        /// <summary>
+        /// The mod that whose state this instance describes.
+        /// </summary>
+        public Mod Mod { get; }
+
+        /// <summary>
+        /// Whether the mod is currently selected.
+        /// </summary>
+        public BindableBool Active { get; } = new BindableBool();
+
+        /// <summary>
+        /// Whether the mod is currently filtered out due to not matching imposed criteria.
+        /// </summary>
+        public BindableBool Filtered { get; } = new BindableBool();
+
+        public ModState(Mod mod)
+        {
+            Mod = mod;
+        }
+    }
+}

From 74599c9c625ae9902e16dfd80d2132d0fc0051e0 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 11 May 2022 18:29:14 +0200
Subject: [PATCH 4781/5547] Use `ModState` in mod panels

---
 osu.Game/Overlays/Mods/ModPanel.cs | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Overlays/Mods/ModPanel.cs b/osu.Game/Overlays/Mods/ModPanel.cs
index 4c4951307d..02b8c195ec 100644
--- a/osu.Game/Overlays/Mods/ModPanel.cs
+++ b/osu.Game/Overlays/Mods/ModPanel.cs
@@ -28,9 +28,11 @@ namespace osu.Game.Overlays.Mods
 {
     public class ModPanel : OsuClickableContainer
     {
-        public Mod Mod { get; }
-        public BindableBool Active { get; } = new BindableBool();
-        public BindableBool Filtered { get; } = new BindableBool();
+        public Mod Mod => modState.Mod;
+        public BindableBool Active => modState.Active;
+        public BindableBool Filtered => modState.Filtered;
+
+        private readonly ModState modState;
 
         protected readonly Box Background;
         protected readonly Container SwitchContainer;
@@ -57,7 +59,7 @@ namespace osu.Game.Overlays.Mods
 
         public ModPanel(Mod mod)
         {
-            Mod = mod;
+            modState = new ModState(mod);
 
             RelativeSizeAxes = Axes.X;
             Height = 42;

From e86444c4bf433a34adce2a62f3f0eae9fc9a12ae Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 11 May 2022 18:37:31 +0200
Subject: [PATCH 4782/5547] Hoist `ModState` to column level

---
 .../Mods/IncompatibilityDisplayingModPanel.cs |  5 +++++
 osu.Game/Overlays/Mods/ModColumn.cs           | 21 ++++++++++---------
 osu.Game/Overlays/Mods/ModPanel.cs            | 15 ++++++++-----
 .../Overlays/Mods/UserModSelectOverlay.cs     |  2 +-
 4 files changed, 27 insertions(+), 16 deletions(-)

diff --git a/osu.Game/Overlays/Mods/IncompatibilityDisplayingModPanel.cs b/osu.Game/Overlays/Mods/IncompatibilityDisplayingModPanel.cs
index aeb983d352..34c4458a21 100644
--- a/osu.Game/Overlays/Mods/IncompatibilityDisplayingModPanel.cs
+++ b/osu.Game/Overlays/Mods/IncompatibilityDisplayingModPanel.cs
@@ -19,6 +19,11 @@ namespace osu.Game.Overlays.Mods
         [Resolved]
         private Bindable<IReadOnlyList<Mod>> selectedMods { get; set; }
 
+        public IncompatibilityDisplayingModPanel(ModState modState)
+            : base(modState)
+        {
+        }
+
         public IncompatibilityDisplayingModPanel(Mod mod)
             : base(mod)
         {
diff --git a/osu.Game/Overlays/Mods/ModColumn.cs b/osu.Game/Overlays/Mods/ModColumn.cs
index b32ebb4a5c..c5364fb403 100644
--- a/osu.Game/Overlays/Mods/ModColumn.cs
+++ b/osu.Game/Overlays/Mods/ModColumn.cs
@@ -20,6 +20,7 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Input.Events;
+using osu.Framework.Lists;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.UserInterface;
@@ -83,20 +84,20 @@ namespace osu.Game.Overlays.Mods
 
         protected override bool ReceivePositionalInputAtSubTree(Vector2 screenSpacePos) => base.ReceivePositionalInputAtSubTree(screenSpacePos) && Active.Value;
 
-        protected virtual ModPanel CreateModPanel(Mod mod) => new ModPanel(mod);
+        protected virtual ModPanel CreateModPanel(ModState mod) => new ModPanel(mod);
 
         private readonly Key[]? toggleKeys;
 
         private readonly Bindable<Dictionary<ModType, IReadOnlyList<Mod>>> availableMods = new Bindable<Dictionary<ModType, IReadOnlyList<Mod>>>();
 
         /// <summary>
-        /// All mods that are available for the current ruleset in this particular column.
+        /// Contains information about state of all mods that are available for the current ruleset in this particular column.
         /// </summary>
         /// <remarks>
         /// Note that the mod instances in this list are owned solely by this column
         /// (as in, they are locally-managed clones, to ensure proper isolation from any other external instances).
         /// </remarks>
-        private IReadOnlyList<Mod> localAvailableMods = Array.Empty<Mod>();
+        private IReadOnlyList<ModState> localAvailableMods = Array.Empty<ModState>();
 
         private readonly TextFlowContainer headerText;
         private readonly Box headerBackground;
@@ -291,10 +292,10 @@ namespace osu.Game.Overlays.Mods
         private void updateLocalAvailableMods(bool asyncLoadContent)
         {
             var newMods = ModUtils.FlattenMods(availableMods.Value.GetValueOrDefault(ModType) ?? Array.Empty<Mod>())
-                                  .Select(m => m.DeepClone())
+                                  .Select(m => new ModState(m.DeepClone()))
                                   .ToList();
 
-            if (newMods.SequenceEqual(localAvailableMods))
+            if (newMods.SequenceEqual(localAvailableMods, new FuncEqualityComparer<ModState>((x, y) => ReferenceEquals(x.Mod, y.Mod))))
                 return;
 
             localAvailableMods = newMods;
@@ -393,18 +394,18 @@ namespace osu.Game.Overlays.Mods
 
             var newSelection = new List<Mod>();
 
-            foreach (var mod in localAvailableMods)
+            foreach (var modState in localAvailableMods)
             {
-                var matchingSelectedMod = mods.SingleOrDefault(selected => selected.GetType() == mod.GetType());
+                var matchingSelectedMod = mods.SingleOrDefault(selected => selected.GetType() == modState.GetType());
 
                 if (matchingSelectedMod != null)
                 {
-                    mod.CopyFrom(matchingSelectedMod);
-                    newSelection.Add(mod);
+                    modState.Mod.CopyFrom(matchingSelectedMod);
+                    newSelection.Add(modState.Mod);
                 }
                 else
                 {
-                    mod.ResetSettingsToDefaults();
+                    modState.Mod.ResetSettingsToDefaults();
                 }
             }
 
diff --git a/osu.Game/Overlays/Mods/ModPanel.cs b/osu.Game/Overlays/Mods/ModPanel.cs
index 02b8c195ec..7010342bd8 100644
--- a/osu.Game/Overlays/Mods/ModPanel.cs
+++ b/osu.Game/Overlays/Mods/ModPanel.cs
@@ -57,9 +57,9 @@ namespace osu.Game.Overlays.Mods
         private Sample? sampleOff;
         private Sample? sampleOn;
 
-        public ModPanel(Mod mod)
+        public ModPanel(ModState modState)
         {
-            modState = new ModState(mod);
+            this.modState = modState;
 
             RelativeSizeAxes = Axes.X;
             Height = 42;
@@ -81,7 +81,7 @@ namespace osu.Game.Overlays.Mods
                 SwitchContainer = new Container
                 {
                     RelativeSizeAxes = Axes.Y,
-                    Child = new ModSwitchSmall(mod)
+                    Child = new ModSwitchSmall(Mod)
                     {
                         Anchor = Anchor.Centre,
                         Origin = Anchor.Centre,
@@ -117,7 +117,7 @@ namespace osu.Game.Overlays.Mods
                                 {
                                     new OsuSpriteText
                                     {
-                                        Text = mod.Name,
+                                        Text = Mod.Name,
                                         Font = OsuFont.TorusAlternate.With(size: 18, weight: FontWeight.SemiBold),
                                         Shear = new Vector2(-ShearedOverlayContainer.SHEAR, 0),
                                         Margin = new MarginPadding
@@ -127,7 +127,7 @@ namespace osu.Game.Overlays.Mods
                                     },
                                     new OsuSpriteText
                                     {
-                                        Text = mod.Description,
+                                        Text = Mod.Description,
                                         Font = OsuFont.Default.With(size: 12),
                                         RelativeSizeAxes = Axes.X,
                                         Truncate = true,
@@ -143,6 +143,11 @@ namespace osu.Game.Overlays.Mods
             Action = Active.Toggle;
         }
 
+        public ModPanel(Mod mod)
+            : this(new ModState(mod))
+        {
+        }
+
         [BackgroundDependencyLoader(true)]
         private void load(AudioManager audio, OsuColour colours, ISamplePlaybackDisabler? samplePlaybackDisabler)
         {
diff --git a/osu.Game/Overlays/Mods/UserModSelectOverlay.cs b/osu.Game/Overlays/Mods/UserModSelectOverlay.cs
index 8ff5e28c8f..7100446730 100644
--- a/osu.Game/Overlays/Mods/UserModSelectOverlay.cs
+++ b/osu.Game/Overlays/Mods/UserModSelectOverlay.cs
@@ -47,7 +47,7 @@ namespace osu.Game.Overlays.Mods
             {
             }
 
-            protected override ModPanel CreateModPanel(Mod mod) => new IncompatibilityDisplayingModPanel(mod);
+            protected override ModPanel CreateModPanel(ModState modState) => new IncompatibilityDisplayingModPanel(modState);
         }
     }
 }

From 05a21fbbe0563605fe002dfe49ff1bb7a87632da Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 11 May 2022 19:02:45 +0200
Subject: [PATCH 4783/5547] Hoist `ModState` to overlay level

---
 osu.Game/Overlays/Mods/ModColumn.cs        | 69 ++++++++--------------
 osu.Game/Overlays/Mods/ModSelectOverlay.cs | 47 +++++++++++----
 2 files changed, 58 insertions(+), 58 deletions(-)

diff --git a/osu.Game/Overlays/Mods/ModColumn.cs b/osu.Game/Overlays/Mods/ModColumn.cs
index c5364fb403..8b3896a88c 100644
--- a/osu.Game/Overlays/Mods/ModColumn.cs
+++ b/osu.Game/Overlays/Mods/ModColumn.cs
@@ -20,13 +20,11 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Input.Events;
-using osu.Framework.Lists;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Localisation;
 using osu.Game.Rulesets.Mods;
-using osu.Game.Utils;
 using osuTK;
 using osuTK.Graphics;
 using osuTK.Input;
@@ -39,6 +37,23 @@ namespace osu.Game.Overlays.Mods
 
         public readonly ModType ModType;
 
+        private IReadOnlyList<ModState> availableMods = Array.Empty<ModState>();
+
+        /// <summary>
+        /// Sets the list of mods to show in this column.
+        /// </summary>
+        public IReadOnlyList<ModState> AvailableMods
+        {
+            get => availableMods;
+            set
+            {
+                Debug.Assert(value.All(mod => mod.Mod.Type == ModType));
+
+                availableMods = value;
+                asyncLoadPanels();
+            }
+        }
+
         private Func<Mod, bool>? filter;
 
         /// <summary>
@@ -88,17 +103,6 @@ namespace osu.Game.Overlays.Mods
 
         private readonly Key[]? toggleKeys;
 
-        private readonly Bindable<Dictionary<ModType, IReadOnlyList<Mod>>> availableMods = new Bindable<Dictionary<ModType, IReadOnlyList<Mod>>>();
-
-        /// <summary>
-        /// Contains information about state of all mods that are available for the current ruleset in this particular column.
-        /// </summary>
-        /// <remarks>
-        /// Note that the mod instances in this list are owned solely by this column
-        /// (as in, they are locally-managed clones, to ensure proper isolation from any other external instances).
-        /// </remarks>
-        private IReadOnlyList<ModState> localAvailableMods = Array.Empty<ModState>();
-
         private readonly TextFlowContainer headerText;
         private readonly Box headerBackground;
         private readonly Container contentContainer;
@@ -258,12 +262,8 @@ namespace osu.Game.Overlays.Mods
         }
 
         [BackgroundDependencyLoader]
-        private void load(OsuGameBase game, OverlayColourProvider colourProvider, OsuColour colours)
+        private void load(OverlayColourProvider colourProvider, OsuColour colours)
         {
-            availableMods.BindTo(game.AvailableMods);
-            updateLocalAvailableMods(asyncLoadContent: false);
-            availableMods.BindValueChanged(_ => updateLocalAvailableMods(asyncLoadContent: true));
-
             headerBackground.Colour = accentColour = colours.ForModType(ModType);
 
             if (toggleAllCheckbox != null)
@@ -289,30 +289,13 @@ namespace osu.Game.Overlays.Mods
             toggleAllCheckbox.LabelText = toggleAllCheckbox.Current.Value ? CommonStrings.DeselectAll : CommonStrings.SelectAll;
         }
 
-        private void updateLocalAvailableMods(bool asyncLoadContent)
-        {
-            var newMods = ModUtils.FlattenMods(availableMods.Value.GetValueOrDefault(ModType) ?? Array.Empty<Mod>())
-                                  .Select(m => new ModState(m.DeepClone()))
-                                  .ToList();
-
-            if (newMods.SequenceEqual(localAvailableMods, new FuncEqualityComparer<ModState>((x, y) => ReferenceEquals(x.Mod, y.Mod))))
-                return;
-
-            localAvailableMods = newMods;
-
-            if (asyncLoadContent)
-                asyncLoadPanels();
-            else
-                onPanelsLoaded(createPanels());
-        }
-
         private CancellationTokenSource? cancellationTokenSource;
 
         private void asyncLoadPanels()
         {
             cancellationTokenSource?.Cancel();
 
-            var panels = createPanels();
+            var panels = availableMods.Select(mod => CreateModPanel(mod).With(panel => panel.Shear = new Vector2(-ShearedOverlayContainer.SHEAR, 0)));
 
             Task? loadTask;
 
@@ -324,12 +307,6 @@ namespace osu.Game.Overlays.Mods
             });
         }
 
-        private IEnumerable<ModPanel> createPanels()
-        {
-            var panels = localAvailableMods.Select(mod => CreateModPanel(mod).With(panel => panel.Shear = new Vector2(-ShearedOverlayContainer.SHEAR, 0)));
-            return panels;
-        }
-
         private void onPanelsLoaded(IEnumerable<ModPanel> loaded)
         {
             panelFlow.ChildrenEnumerable = loaded;
@@ -394,7 +371,7 @@ namespace osu.Game.Overlays.Mods
 
             var newSelection = new List<Mod>();
 
-            foreach (var modState in localAvailableMods)
+            foreach (var modState in this.availableMods)
             {
                 var matchingSelectedMod = mods.SingleOrDefault(selected => selected.GetType() == modState.GetType());
 
@@ -554,10 +531,10 @@ namespace osu.Game.Overlays.Mods
             int index = Array.IndexOf(toggleKeys, e.Key);
             if (index < 0) return false;
 
-            var panel = panelFlow.ElementAtOrDefault(index);
-            if (panel == null || panel.Filtered.Value) return false;
+            var modState = availableMods.ElementAtOrDefault(index);
+            if (modState == null || modState.Filtered.Value) return false;
 
-            panel.Active.Toggle();
+            modState.Active.Toggle();
             return true;
         }
 
diff --git a/osu.Game/Overlays/Mods/ModSelectOverlay.cs b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
index b3c3eee15a..ace0576b96 100644
--- a/osu.Game/Overlays/Mods/ModSelectOverlay.cs
+++ b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
@@ -22,6 +22,7 @@ using osu.Game.Graphics.UserInterface;
 using osu.Game.Input.Bindings;
 using osu.Game.Localisation;
 using osu.Game.Rulesets.Mods;
+using osu.Game.Utils;
 using osuTK;
 using osuTK.Input;
 
@@ -47,9 +48,7 @@ namespace osu.Game.Overlays.Mods
             set
             {
                 isValidMod = value ?? throw new ArgumentNullException(nameof(value));
-
-                if (IsLoaded)
-                    updateAvailableMods();
+                filterMods();
             }
         }
 
@@ -64,6 +63,9 @@ namespace osu.Game.Overlays.Mods
 
         protected virtual IEnumerable<ShearedButton> CreateFooterButtons() => createDefaultFooterButtons();
 
+        private readonly Bindable<Dictionary<ModType, IReadOnlyList<Mod>>> availableMods = new Bindable<Dictionary<ModType, IReadOnlyList<Mod>>>();
+        private readonly Dictionary<ModType, IReadOnlyList<ModState>> localAvailableMods = new Dictionary<ModType, IReadOnlyList<ModState>>();
+
         private readonly BindableBool customisationVisible = new BindableBool();
 
         private ModSettingsArea modSettingsArea = null!;
@@ -82,7 +84,7 @@ namespace osu.Game.Overlays.Mods
         }
 
         [BackgroundDependencyLoader]
-        private void load(OsuColour colours)
+        private void load(OsuGameBase game, OsuColour colours)
         {
             Header.Title = ModSelectOverlayStrings.ModSelectTitle;
             Header.Description = ModSelectOverlayStrings.ModSelectDescription;
@@ -184,12 +186,16 @@ namespace osu.Game.Overlays.Mods
                     LighterColour = colours.Pink1
                 })
             };
+
+            availableMods.BindTo(game.AvailableMods);
         }
 
         protected override void LoadComplete()
         {
             base.LoadComplete();
 
+            availableMods.BindValueChanged(_ => createLocalMods(), true);
+
             State.BindValueChanged(_ => samplePlaybackDisabled.Value = State.Value == Visibility.Hidden, true);
 
             // This is an optimisation to prevent refreshing the available settings controls when it can be
@@ -211,8 +217,6 @@ namespace osu.Game.Overlays.Mods
 
             customisationVisible.BindValueChanged(_ => updateCustomisationVisualState(), true);
 
-            updateAvailableMods();
-
             // Start scrolled slightly to the right to give the user a sense that
             // there is more horizontal content available.
             ScheduleAfterChildren(() =>
@@ -272,6 +276,31 @@ namespace osu.Game.Overlays.Mods
                 }
             };
 
+        private void createLocalMods()
+        {
+            localAvailableMods.Clear();
+
+            foreach (var (modType, mods) in availableMods.Value)
+            {
+                var modStates = mods.SelectMany(ModUtils.FlattenMod)
+                                    .Select(mod => new ModState(mod.DeepClone()))
+                                    .ToArray();
+
+                localAvailableMods[modType] = modStates;
+            }
+
+            filterMods();
+
+            foreach (var column in columnFlow.Columns)
+                column.AvailableMods = localAvailableMods.GetValueOrDefault(column.ModType, Array.Empty<ModState>());
+        }
+
+        private void filterMods()
+        {
+            foreach (var modState in localAvailableMods.Values.SelectMany(m => m))
+                modState.Filtered.Value = !modState.Mod.HasImplementation || !IsValidMod.Invoke(modState.Mod);
+        }
+
         private void updateMultiplier()
         {
             if (multiplierDisplay == null)
@@ -285,12 +314,6 @@ namespace osu.Game.Overlays.Mods
             multiplierDisplay.Current.Value = multiplier;
         }
 
-        private void updateAvailableMods()
-        {
-            foreach (var column in columnFlow.Columns)
-                column.Filter = m => m.HasImplementation && isValidMod.Invoke(m);
-        }
-
         private void updateCustomisation(ValueChangedEvent<IReadOnlyList<Mod>> valueChangedEvent)
         {
             if (customisationButton == null)

From 11ae1da65a092266786f4eae988bd0713584dbc7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 11 May 2022 19:30:06 +0200
Subject: [PATCH 4784/5547] Hoist reference replacement logic to overlay level

---
 osu.Game/Overlays/Mods/ModColumn.cs        | 116 ++-------------------
 osu.Game/Overlays/Mods/ModSelectOverlay.cs |  85 ++++++++++-----
 2 files changed, 64 insertions(+), 137 deletions(-)

diff --git a/osu.Game/Overlays/Mods/ModColumn.cs b/osu.Game/Overlays/Mods/ModColumn.cs
index 8b3896a88c..deaaacd775 100644
--- a/osu.Game/Overlays/Mods/ModColumn.cs
+++ b/osu.Game/Overlays/Mods/ModColumn.cs
@@ -13,7 +13,6 @@ using Humanizer;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Extensions.Color4Extensions;
-using osu.Framework.Extensions.IEnumerableExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Colour;
 using osu.Framework.Graphics.Containers;
@@ -54,49 +53,18 @@ namespace osu.Game.Overlays.Mods
             }
         }
 
-        private Func<Mod, bool>? filter;
-
         /// <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.
         /// A return value of <see langword="false"/> means that the mod is filtered out and therefore its corresponding panel should be hidden.
         /// </summary>
-        public Func<Mod, bool>? Filter
-        {
-            get => filter;
-            set
-            {
-                filter = value;
-                updateState();
-            }
-        }
+        public Func<Mod, bool>? Filter { get; set; } // TODO: remove later
 
         /// <summary>
         /// Determines whether this column should accept user input.
         /// </summary>
         public Bindable<bool> Active = new BindableBool(true);
 
-        private readonly Bindable<bool> allFiltered = new BindableBool();
-
-        /// <summary>
-        /// True if all of the panels in this column have been filtered out by the current <see cref="Filter"/>.
-        /// </summary>
-        public IBindable<bool> AllFiltered => allFiltered;
-
-        /// <summary>
-        /// List of mods marked as selected in this column.
-        /// </summary>
-        /// <remarks>
-        /// Note that the mod instances returned by this property are owned solely by this column
-        /// (as in, they are locally-managed clones, to ensure proper isolation from any other external instances).
-        /// </remarks>
-        public IReadOnlyList<Mod> SelectedMods { get; private set; } = Array.Empty<Mod>();
-
-        /// <summary>
-        /// Invoked when a mod panel has been selected interactively by the user.
-        /// </summary>
-        public event Action? SelectionChangedByUser;
-
         protected override bool ReceivePositionalInputAtSubTree(Vector2 screenSpacePos) => base.ReceivePositionalInputAtSubTree(screenSpacePos) && Active.Value;
 
         protected virtual ModPanel CreateModPanel(ModState mod) => new ModPanel(mod);
@@ -299,7 +267,11 @@ namespace osu.Game.Overlays.Mods
 
             Task? loadTask;
 
-            latestLoadTask = loadTask = LoadComponentsAsync(panels, onPanelsLoaded, (cancellationTokenSource = new CancellationTokenSource()).Token);
+            latestLoadTask = loadTask = LoadComponentsAsync(panels, loaded =>
+            {
+                panelFlow.ChildrenEnumerable = loaded;
+                updateState();
+            }, (cancellationTokenSource = new CancellationTokenSource()).Token);
             loadTask.ContinueWith(_ =>
             {
                 if (loadTask == latestLoadTask)
@@ -307,27 +279,9 @@ namespace osu.Game.Overlays.Mods
             });
         }
 
-        private void onPanelsLoaded(IEnumerable<ModPanel> loaded)
-        {
-            panelFlow.ChildrenEnumerable = loaded;
-
-            updateState();
-
-            foreach (var panel in panelFlow)
-            {
-                panel.Active.BindValueChanged(_ => panelStateChanged(panel));
-            }
-        }
-
         private void updateState()
         {
-            foreach (var panel in panelFlow)
-            {
-                panel.Active.Value = SelectedMods.Contains(panel.Mod);
-                panel.ApplyFilter(Filter);
-            }
-
-            allFiltered.Value = panelFlow.All(panel => panel.Filtered.Value);
+            Alpha = availableMods.All(mod => mod.Filtered.Value) ? 0 : 1;
 
             if (toggleAllCheckbox != null && !SelectionAnimationRunning)
             {
@@ -336,62 +290,6 @@ namespace osu.Game.Overlays.Mods
             }
         }
 
-        /// <summary>
-        /// This flag helps to determine the source of changes to <see cref="SelectedMods"/>.
-        /// If the value is false, then <see cref="SelectedMods"/> are changing due to a user selection on the UI.
-        /// If the value is true, then <see cref="SelectedMods"/> are changing due to an external <see cref="SetSelection"/> call.
-        /// </summary>
-        private bool externalSelectionUpdateInProgress;
-
-        private void panelStateChanged(ModPanel panel)
-        {
-            if (externalSelectionUpdateInProgress)
-                return;
-
-            var newSelectedMods = panel.Active.Value
-                ? SelectedMods.Append(panel.Mod)
-                : SelectedMods.Except(panel.Mod.Yield());
-
-            SelectedMods = newSelectedMods.ToArray();
-            updateState();
-            SelectionChangedByUser?.Invoke();
-        }
-
-        /// <summary>
-        /// Adjusts the set of selected mods in this column to match the passed in <paramref name="mods"/>.
-        /// </summary>
-        /// <remarks>
-        /// This method exists to be able to receive mod instances that come from potentially-external sources and to copy the changes across to this column's state.
-        /// <see cref="ModSelectOverlay"/> uses this to substitute any external mod references in <see cref="ModSelectOverlay.SelectedMods"/>
-        /// to references that are owned by this column.
-        /// </remarks>
-        internal void SetSelection(IReadOnlyList<Mod> mods)
-        {
-            externalSelectionUpdateInProgress = true;
-
-            var newSelection = new List<Mod>();
-
-            foreach (var modState in this.availableMods)
-            {
-                var matchingSelectedMod = mods.SingleOrDefault(selected => selected.GetType() == modState.GetType());
-
-                if (matchingSelectedMod != null)
-                {
-                    modState.Mod.CopyFrom(matchingSelectedMod);
-                    newSelection.Add(modState.Mod);
-                }
-                else
-                {
-                    modState.Mod.ResetSettingsToDefaults();
-                }
-            }
-
-            SelectedMods = newSelection;
-            updateState();
-
-            externalSelectionUpdateInProgress = false;
-        }
-
         #region Bulk select / deselect
 
         private const double initial_multiple_selection_delay = 120;
diff --git a/osu.Game/Overlays/Mods/ModSelectOverlay.cs b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
index ace0576b96..567e91e3fa 100644
--- a/osu.Game/Overlays/Mods/ModSelectOverlay.cs
+++ b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
@@ -207,14 +207,9 @@ namespace osu.Game.Overlays.Mods
             {
                 updateMultiplier();
                 updateCustomisation(val);
-                updateSelectionFromBindable();
+                updateFromExternalSelection();
             }, true);
 
-            foreach (var column in columnFlow.Columns)
-            {
-                column.SelectionChangedByUser += updateBindableFromSelection;
-            }
-
             customisationVisible.BindValueChanged(_ => updateCustomisationVisualState(), true);
 
             // Start scrolled slightly to the right to give the user a sense that
@@ -248,7 +243,6 @@ namespace osu.Game.Overlays.Mods
         {
             var column = CreateModColumn(modType, toggleKeys).With(column =>
             {
-                column.Filter = IsValidMod;
                 // spacing applied here rather than via `columnFlow.Spacing` to avoid uneven gaps when some of the columns are hidden.
                 column.Margin = new MarginPadding { Right = 10 };
             });
@@ -286,6 +280,9 @@ namespace osu.Game.Overlays.Mods
                                     .Select(mod => new ModState(mod.DeepClone()))
                                     .ToArray();
 
+                foreach (var modState in modStates)
+                    modState.Active.BindValueChanged(_ => updateFromInternalSelection());
+
                 localAvailableMods[modType] = modStates;
             }
 
@@ -362,20 +359,50 @@ namespace osu.Game.Overlays.Mods
             TopLevelContent.MoveToY(-modAreaHeight, transition_duration, Easing.InOutCubic);
         }
 
-        private void updateSelectionFromBindable()
-        {
-            // `SelectedMods` may contain mod references that come from external sources.
-            // to ensure isolation, first pull in the potentially-external change into the mod columns...
-            foreach (var column in columnFlow.Columns)
-                column.SetSelection(SelectedMods.Value);
+        /// <summary>
+        /// This flag helps to determine the source of changes to <see cref="SelectedMods"/>.
+        /// If the value is false, then <see cref="SelectedMods"/> are changing due to a user selection on the UI.
+        /// If the value is true, then <see cref="SelectedMods"/> are changing due to an external <see cref="SelectedMods"/> change.
+        /// </summary>
+        private bool externalSelectionUpdateInProgress;
 
-            // and then, when done, replace the potentially-external mod references in `SelectedMods` with ones we own.
-            updateBindableFromSelection();
+        private void updateFromExternalSelection()
+        {
+            externalSelectionUpdateInProgress = true;
+
+            var newSelection = new List<Mod>();
+
+            foreach (var modState in localAvailableMods.SelectMany(pair => pair.Value))
+            {
+                var matchingSelectedMod = SelectedMods.Value.SingleOrDefault(selected => selected.GetType() == modState.Mod.GetType());
+
+                if (matchingSelectedMod != null)
+                {
+                    modState.Mod.CopyFrom(matchingSelectedMod);
+                    modState.Active.Value = true;
+                    newSelection.Add(modState.Mod);
+                }
+                else
+                {
+                    modState.Mod.ResetSettingsToDefaults();
+                    modState.Active.Value = false;
+                }
+            }
+
+            SelectedMods.Value = newSelection;
+
+            externalSelectionUpdateInProgress = false;
         }
 
-        private void updateBindableFromSelection()
+        private void updateFromInternalSelection()
         {
-            var candidateSelection = columnFlow.Columns.SelectMany(column => column.SelectedMods).ToArray();
+            if (externalSelectionUpdateInProgress)
+                return;
+
+            var candidateSelection = localAvailableMods.SelectMany(pair => pair.Value)
+                                                       .Where(modState => modState.Active.Value)
+                                                       .Select(modState => modState.Mod)
+                                                       .ToArray();
 
             // the following guard intends to check cases where we've already replaced potentially-external mod references with our own and avoid endless recursion.
             // TODO: replace custom comparer with System.Collections.Generic.ReferenceEqualityComparer when fully on .NET 6
@@ -406,10 +433,12 @@ namespace osu.Game.Overlays.Mods
             {
                 var column = columnFlow[i].Column;
 
-                double delay = column.AllFiltered.Value ? 0 : nonFilteredColumnCount * 30;
-                double duration = column.AllFiltered.Value ? 0 : fade_in_duration;
+                bool allFiltered = column.AvailableMods.All(modState => modState.Filtered.Value);
+
+                double delay = allFiltered ? 0 : nonFilteredColumnCount * 30;
+                double duration = allFiltered ? 0 : fade_in_duration;
                 float startingYPosition = 0;
-                if (!column.AllFiltered.Value)
+                if (!allFiltered)
                     startingYPosition = nonFilteredColumnCount % 2 == 0 ? -distance : distance;
 
                 column.TopLevelContent
@@ -418,7 +447,7 @@ namespace osu.Game.Overlays.Mods
                       .MoveToY(0, duration, Easing.OutQuint)
                       .FadeIn(duration, Easing.OutQuint);
 
-                if (!column.AllFiltered.Value)
+                if (!allFiltered)
                     nonFilteredColumnCount += 1;
             }
         }
@@ -439,9 +468,11 @@ namespace osu.Game.Overlays.Mods
             {
                 var column = columnFlow[i].Column;
 
-                double duration = column.AllFiltered.Value ? 0 : fade_out_duration;
+                bool allFiltered = column.AvailableMods.All(modState => modState.Filtered.Value);
+
+                double duration = allFiltered ? 0 : fade_out_duration;
                 float newYPosition = 0;
-                if (!column.AllFiltered.Value)
+                if (!allFiltered)
                     newYPosition = nonFilteredColumnCount % 2 == 0 ? -distance : distance;
 
                 column.FlushPendingSelections();
@@ -449,7 +480,7 @@ namespace osu.Game.Overlays.Mods
                       .MoveToY(newYPosition, duration, Easing.OutQuint)
                       .FadeOut(duration, Easing.OutQuint);
 
-                if (!column.AllFiltered.Value)
+                if (!allFiltered)
                     nonFilteredColumnCount += 1;
             }
         }
@@ -593,8 +624,8 @@ namespace osu.Game.Overlays.Mods
             protected override void LoadComplete()
             {
                 base.LoadComplete();
-                Active.BindValueChanged(_ => updateState());
-                Column.AllFiltered.BindValueChanged(_ => updateState(), true);
+
+                Active.BindValueChanged(_ => updateState(), true);
                 FinishTransforms();
             }
 
@@ -604,8 +635,6 @@ namespace osu.Game.Overlays.Mods
             {
                 Colour4 targetColour;
 
-                Column.Alpha = Column.AllFiltered.Value ? 0 : 1;
-
                 if (Column.Active.Value)
                     targetColour = Colour4.White;
                 else

From 83ba06e7afc42d59273515a1a8b277daeca64af6 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 11 May 2022 19:33:52 +0200
Subject: [PATCH 4785/5547] Extract helper property for accessing all mods

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

diff --git a/osu.Game/Overlays/Mods/ModSelectOverlay.cs b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
index 567e91e3fa..7e28ab4b1f 100644
--- a/osu.Game/Overlays/Mods/ModSelectOverlay.cs
+++ b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
@@ -65,6 +65,7 @@ namespace osu.Game.Overlays.Mods
 
         private readonly Bindable<Dictionary<ModType, IReadOnlyList<Mod>>> availableMods = new Bindable<Dictionary<ModType, IReadOnlyList<Mod>>>();
         private readonly Dictionary<ModType, IReadOnlyList<ModState>> localAvailableMods = new Dictionary<ModType, IReadOnlyList<ModState>>();
+        private IEnumerable<ModState> allLocalAvailableMods => localAvailableMods.SelectMany(pair => pair.Value);
 
         private readonly BindableBool customisationVisible = new BindableBool();
 
@@ -294,7 +295,7 @@ namespace osu.Game.Overlays.Mods
 
         private void filterMods()
         {
-            foreach (var modState in localAvailableMods.Values.SelectMany(m => m))
+            foreach (var modState in allLocalAvailableMods)
                 modState.Filtered.Value = !modState.Mod.HasImplementation || !IsValidMod.Invoke(modState.Mod);
         }
 
@@ -372,7 +373,7 @@ namespace osu.Game.Overlays.Mods
 
             var newSelection = new List<Mod>();
 
-            foreach (var modState in localAvailableMods.SelectMany(pair => pair.Value))
+            foreach (var modState in allLocalAvailableMods)
             {
                 var matchingSelectedMod = SelectedMods.Value.SingleOrDefault(selected => selected.GetType() == modState.Mod.GetType());
 
@@ -399,10 +400,9 @@ namespace osu.Game.Overlays.Mods
             if (externalSelectionUpdateInProgress)
                 return;
 
-            var candidateSelection = localAvailableMods.SelectMany(pair => pair.Value)
-                                                       .Where(modState => modState.Active.Value)
-                                                       .Select(modState => modState.Mod)
-                                                       .ToArray();
+            var candidateSelection = allLocalAvailableMods.Where(modState => modState.Active.Value)
+                                                          .Select(modState => modState.Mod)
+                                                          .ToArray();
 
             // the following guard intends to check cases where we've already replaced potentially-external mod references with our own and avoid endless recursion.
             // TODO: replace custom comparer with System.Collections.Generic.ReferenceEqualityComparer when fully on .NET 6

From fc24a564782aa31381b8eada9e547f871f5c0978 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 11 May 2022 19:40:56 +0200
Subject: [PATCH 4786/5547] Add protection from recursive updates from external
 selection

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

diff --git a/osu.Game/Overlays/Mods/ModSelectOverlay.cs b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
index 7e28ab4b1f..e478b2afcd 100644
--- a/osu.Game/Overlays/Mods/ModSelectOverlay.cs
+++ b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
@@ -369,6 +369,9 @@ namespace osu.Game.Overlays.Mods
 
         private void updateFromExternalSelection()
         {
+            if (externalSelectionUpdateInProgress)
+                return;
+
             externalSelectionUpdateInProgress = true;
 
             var newSelection = new List<Mod>();

From 7ac6073f13cf31bf6e15489c9f54f31ed87503c3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 11 May 2022 20:23:24 +0200
Subject: [PATCH 4787/5547] Fix column test scene to work

---
 .../UserInterface/TestSceneModColumn.cs       | 59 +++++++++++--------
 1 file changed, 36 insertions(+), 23 deletions(-)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneModColumn.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneModColumn.cs
index e47ae860c6..331509e10f 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneModColumn.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneModColumn.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.
 
+#nullable enable
+
 using System;
 using System.Linq;
 using NUnit.Framework;
@@ -12,11 +14,9 @@ using osu.Framework.Testing;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Overlays;
 using osu.Game.Overlays.Mods;
-using osu.Game.Rulesets.Catch;
-using osu.Game.Rulesets.Mania;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Osu;
-using osu.Game.Rulesets.Taiko;
+using osu.Game.Utils;
 using osuTK.Input;
 
 namespace osu.Game.Tests.Visual.UserInterface
@@ -41,20 +41,16 @@ namespace osu.Game.Tests.Visual.UserInterface
                 Child = new ModColumn(modType, false)
                 {
                     Anchor = Anchor.Centre,
-                    Origin = Anchor.Centre
+                    Origin = Anchor.Centre,
+                    AvailableMods = getExampleModsFor(modType)
                 }
             });
-
-            AddStep("change ruleset to osu!", () => Ruleset.Value = new OsuRuleset().RulesetInfo);
-            AddStep("change ruleset to taiko", () => Ruleset.Value = new TaikoRuleset().RulesetInfo);
-            AddStep("change ruleset to catch", () => Ruleset.Value = new CatchRuleset().RulesetInfo);
-            AddStep("change ruleset to mania", () => Ruleset.Value = new ManiaRuleset().RulesetInfo);
         }
 
         [Test]
         public void TestMultiSelection()
         {
-            ModColumn column = null;
+            ModColumn column = null!;
             AddStep("create content", () => Child = new Container
             {
                 RelativeSizeAxes = Axes.Both,
@@ -62,7 +58,8 @@ namespace osu.Game.Tests.Visual.UserInterface
                 Child = column = new ModColumn(ModType.DifficultyIncrease, true)
                 {
                     Anchor = Anchor.Centre,
-                    Origin = Anchor.Centre
+                    Origin = Anchor.Centre,
+                    AvailableMods = getExampleModsFor(ModType.DifficultyIncrease)
                 }
             });
 
@@ -91,7 +88,7 @@ namespace osu.Game.Tests.Visual.UserInterface
         [Test]
         public void TestFiltering()
         {
-            TestModColumn column = null;
+            TestModColumn column = null!;
 
             AddStep("create content", () => Child = new Container
             {
@@ -100,30 +97,31 @@ namespace osu.Game.Tests.Visual.UserInterface
                 Child = column = new TestModColumn(ModType.Fun, true)
                 {
                     Anchor = Anchor.Centre,
-                    Origin = Anchor.Centre
+                    Origin = Anchor.Centre,
+                    AvailableMods = getExampleModsFor(ModType.Fun)
                 }
             });
 
-            AddStep("set filter", () => column.Filter = mod => mod.Name.Contains("Wind", StringComparison.CurrentCultureIgnoreCase));
+            AddStep("set filter", () => setFilter(mod => mod.Name.Contains("Wind", StringComparison.CurrentCultureIgnoreCase)));
             AddUntilStep("two panels visible", () => column.ChildrenOfType<ModPanel>().Count(panel => !panel.Filtered.Value) == 2);
 
             clickToggle();
             AddUntilStep("wait for animation", () => !column.SelectionAnimationRunning);
             AddAssert("only visible items selected", () => column.ChildrenOfType<ModPanel>().Where(panel => panel.Active.Value).All(panel => !panel.Filtered.Value));
 
-            AddStep("unset filter", () => column.Filter = null);
+            AddStep("unset filter", () => setFilter(null));
             AddUntilStep("all panels visible", () => column.ChildrenOfType<ModPanel>().All(panel => !panel.Filtered.Value));
             AddAssert("checkbox not selected", () => !column.ChildrenOfType<OsuCheckbox>().Single().Current.Value);
 
-            AddStep("set filter", () => column.Filter = mod => mod.Name.Contains("Wind", StringComparison.CurrentCultureIgnoreCase));
+            AddStep("set filter", () => setFilter(mod => mod.Name.Contains("Wind", StringComparison.CurrentCultureIgnoreCase)));
             AddUntilStep("two panels visible", () => column.ChildrenOfType<ModPanel>().Count(panel => !panel.Filtered.Value) == 2);
             AddAssert("checkbox selected", () => column.ChildrenOfType<OsuCheckbox>().Single().Current.Value);
 
-            AddStep("filter out everything", () => column.Filter = _ => false);
+            AddStep("filter out everything", () => setFilter(_ => false));
             AddUntilStep("no panels visible", () => column.ChildrenOfType<ModPanel>().All(panel => panel.Filtered.Value));
             AddUntilStep("checkbox hidden", () => !column.ChildrenOfType<OsuCheckbox>().Single().IsPresent);
 
-            AddStep("inset filter", () => column.Filter = null);
+            AddStep("inset filter", () => setFilter(null));
             AddUntilStep("all panels visible", () => column.ChildrenOfType<ModPanel>().All(panel => !panel.Filtered.Value));
             AddUntilStep("checkbox visible", () => column.ChildrenOfType<OsuCheckbox>().Single().IsPresent);
 
@@ -138,7 +136,7 @@ namespace osu.Game.Tests.Visual.UserInterface
         [Test]
         public void TestKeyboardSelection()
         {
-            ModColumn column = null;
+            ModColumn column = null!;
             AddStep("create content", () => Child = new Container
             {
                 RelativeSizeAxes = Axes.Both,
@@ -146,7 +144,8 @@ namespace osu.Game.Tests.Visual.UserInterface
                 Child = column = new ModColumn(ModType.DifficultyReduction, true, new[] { Key.Q, Key.W, Key.E, Key.R, Key.T, Key.Y, Key.U, Key.I, Key.O, Key.P })
                 {
                     Anchor = Anchor.Centre,
-                    Origin = Anchor.Centre
+                    Origin = Anchor.Centre,
+                    AvailableMods = getExampleModsFor(ModType.DifficultyReduction)
                 }
             });
 
@@ -158,7 +157,7 @@ namespace osu.Game.Tests.Visual.UserInterface
             AddStep("press W again", () => InputManager.Key(Key.W));
             AddAssert("NF panel deselected", () => !this.ChildrenOfType<ModPanel>().Single(panel => panel.Mod.Acronym == "NF").Active.Value);
 
-            AddStep("set filter to NF", () => column.Filter = mod => mod.Acronym == "NF");
+            AddStep("set filter to NF", () => setFilter(mod => mod.Acronym == "NF"));
 
             AddStep("press W", () => InputManager.Key(Key.W));
             AddAssert("NF panel selected", () => this.ChildrenOfType<ModPanel>().Single(panel => panel.Mod.Acronym == "NF").Active.Value);
@@ -166,12 +165,18 @@ namespace osu.Game.Tests.Visual.UserInterface
             AddStep("press W again", () => InputManager.Key(Key.W));
             AddAssert("NF panel deselected", () => !this.ChildrenOfType<ModPanel>().Single(panel => panel.Mod.Acronym == "NF").Active.Value);
 
-            AddStep("filter out everything", () => column.Filter = _ => false);
+            AddStep("filter out everything", () => setFilter(_ => false));
 
             AddStep("press W", () => InputManager.Key(Key.W));
             AddAssert("NF panel not selected", () => !this.ChildrenOfType<ModPanel>().Single(panel => panel.Mod.Acronym == "NF").Active.Value);
 
-            AddStep("clear filter", () => column.Filter = null);
+            AddStep("clear filter", () => setFilter(null));
+        }
+
+        private void setFilter(Func<Mod, bool>? filter)
+        {
+            foreach (var modState in this.ChildrenOfType<ModColumn>().Single().AvailableMods)
+                modState.Filtered.Value = filter?.Invoke(modState.Mod) == false;
         }
 
         private class TestModColumn : ModColumn
@@ -183,5 +188,13 @@ namespace osu.Game.Tests.Visual.UserInterface
             {
             }
         }
+
+        private static ModState[] getExampleModsFor(ModType modType)
+        {
+            return new OsuRuleset().GetModsFor(modType)
+                                   .SelectMany(ModUtils.FlattenMod)
+                                   .Select(mod => new ModState(mod))
+                                   .ToArray();
+        }
     }
 }

From 52bbce12f16d3ba769c8da6fa6ee6a51a8a65d07 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 11 May 2022 20:23:56 +0200
Subject: [PATCH 4788/5547] Fix not being able to set `AvailableMods` before
 loaded

---
 osu.Game/Overlays/Mods/ModColumn.cs | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/Mods/ModColumn.cs b/osu.Game/Overlays/Mods/ModColumn.cs
index deaaacd775..06e96afdca 100644
--- a/osu.Game/Overlays/Mods/ModColumn.cs
+++ b/osu.Game/Overlays/Mods/ModColumn.cs
@@ -49,7 +49,9 @@ namespace osu.Game.Overlays.Mods
                 Debug.Assert(value.All(mod => mod.Mod.Type == ModType));
 
                 availableMods = value;
-                asyncLoadPanels();
+
+                if (IsLoaded)
+                    asyncLoadPanels();
             }
         }
 
@@ -249,6 +251,7 @@ namespace osu.Game.Overlays.Mods
             base.LoadComplete();
 
             toggleAllCheckbox?.Current.BindValueChanged(_ => updateToggleAllText(), true);
+            asyncLoadPanels();
         }
 
         private void updateToggleAllText()

From b5a9f1310a706491c6019b2a2d159583620f4972 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 11 May 2022 20:28:11 +0200
Subject: [PATCH 4789/5547] Fix select/deselect all toggle not working
 correctly after changes

---
 osu.Game/Overlays/Mods/ModColumn.cs | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/osu.Game/Overlays/Mods/ModColumn.cs b/osu.Game/Overlays/Mods/ModColumn.cs
index 06e96afdca..c1904a0bc0 100644
--- a/osu.Game/Overlays/Mods/ModColumn.cs
+++ b/osu.Game/Overlays/Mods/ModColumn.cs
@@ -50,6 +50,14 @@ namespace osu.Game.Overlays.Mods
 
                 availableMods = value;
 
+                foreach (var mod in availableMods)
+                {
+                    mod.Active.BindValueChanged(_ => updateState());
+                    mod.Filtered.BindValueChanged(_ => updateState());
+                }
+
+                updateState();
+
                 if (IsLoaded)
                     asyncLoadPanels();
             }

From 1c0166367d1f12cfaf5194f467d7c64220e1409b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 11 May 2022 20:29:28 +0200
Subject: [PATCH 4790/5547] Fix remaining column operations being coupled to
 drawables

---
 osu.Game/Overlays/Mods/ModColumn.cs | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Overlays/Mods/ModColumn.cs b/osu.Game/Overlays/Mods/ModColumn.cs
index c1904a0bc0..d7ce08e124 100644
--- a/osu.Game/Overlays/Mods/ModColumn.cs
+++ b/osu.Game/Overlays/Mods/ModColumn.cs
@@ -296,8 +296,8 @@ namespace osu.Game.Overlays.Mods
 
             if (toggleAllCheckbox != null && !SelectionAnimationRunning)
             {
-                toggleAllCheckbox.Alpha = panelFlow.Any(panel => !panel.Filtered.Value) ? 1 : 0;
-                toggleAllCheckbox.Current.Value = panelFlow.Where(panel => !panel.Filtered.Value).All(panel => panel.Active.Value);
+                toggleAllCheckbox.Alpha = availableMods.Any(panel => !panel.Filtered.Value) ? 1 : 0;
+                toggleAllCheckbox.Current.Value = availableMods.Where(panel => !panel.Filtered.Value).All(panel => panel.Active.Value);
             }
         }
 
@@ -342,7 +342,7 @@ namespace osu.Game.Overlays.Mods
         {
             pendingSelectionOperations.Clear();
 
-            foreach (var button in panelFlow.Where(b => !b.Active.Value && !b.Filtered.Value))
+            foreach (var button in availableMods.Where(b => !b.Active.Value && !b.Filtered.Value))
                 pendingSelectionOperations.Enqueue(() => button.Active.Value = true);
         }
 
@@ -353,7 +353,7 @@ namespace osu.Game.Overlays.Mods
         {
             pendingSelectionOperations.Clear();
 
-            foreach (var button in panelFlow.Where(b => b.Active.Value && !b.Filtered.Value))
+            foreach (var button in availableMods.Where(b => b.Active.Value && !b.Filtered.Value))
                 pendingSelectionOperations.Enqueue(() => button.Active.Value = false);
         }
 

From 2266a5c9a0588beb5e188197a0dd03c67457dd46 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 11 May 2022 20:38:53 +0200
Subject: [PATCH 4791/5547] Remove no-longer-necessary `ModColumn.Filter`

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

diff --git a/osu.Game/Overlays/Mods/ModColumn.cs b/osu.Game/Overlays/Mods/ModColumn.cs
index d7ce08e124..9bb3f8bd9e 100644
--- a/osu.Game/Overlays/Mods/ModColumn.cs
+++ b/osu.Game/Overlays/Mods/ModColumn.cs
@@ -63,13 +63,6 @@ namespace osu.Game.Overlays.Mods
             }
         }
 
-        /// <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.
-        /// A return value of <see langword="false"/> means that the mod is filtered out and therefore its corresponding panel should be hidden.
-        /// </summary>
-        public Func<Mod, bool>? Filter { get; set; } // TODO: remove later
-
         /// <summary>
         /// Determines whether this column should accept user input.
         /// </summary>

From 93539160adb48a6be40d69ed33c216d46f52327e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 11 May 2022 21:57:57 +0200
Subject: [PATCH 4792/5547] Remove no-longer-necessary guard

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

diff --git a/osu.Game/Overlays/Mods/ModSelectOverlay.cs b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
index e478b2afcd..d94f663962 100644
--- a/osu.Game/Overlays/Mods/ModSelectOverlay.cs
+++ b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
@@ -12,7 +12,6 @@ using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Input.Events;
-using osu.Framework.Lists;
 using osu.Framework.Utils;
 using osu.Game.Audio;
 using osu.Game.Configuration;
@@ -407,11 +406,6 @@ namespace osu.Game.Overlays.Mods
                                                           .Select(modState => modState.Mod)
                                                           .ToArray();
 
-            // the following guard intends to check cases where we've already replaced potentially-external mod references with our own and avoid endless recursion.
-            // TODO: replace custom comparer with System.Collections.Generic.ReferenceEqualityComparer when fully on .NET 6
-            if (candidateSelection.SequenceEqual(SelectedMods.Value, new FuncEqualityComparer<Mod>(ReferenceEquals)))
-                return;
-
             SelectedMods.Value = ComputeNewModsFromSelection(SelectedMods.Value, candidateSelection);
         }
 

From 981ead68bf8a54ece314e00bf0d68a16aa331622 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 11 May 2022 22:20:00 +0200
Subject: [PATCH 4793/5547] Ensure local mods are constructed in time for
 `Pop{In,Out}()`

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

diff --git a/osu.Game/Overlays/Mods/ModSelectOverlay.cs b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
index d94f663962..d068839ab0 100644
--- a/osu.Game/Overlays/Mods/ModSelectOverlay.cs
+++ b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
@@ -192,10 +192,11 @@ namespace osu.Game.Overlays.Mods
 
         protected override void LoadComplete()
         {
-            base.LoadComplete();
-
+            // this is called before base call so that the mod state is populated early, and the transition in `PopIn()` can play out properly.
             availableMods.BindValueChanged(_ => createLocalMods(), true);
 
+            base.LoadComplete();
+
             State.BindValueChanged(_ => samplePlaybackDisabled.Value = State.Value == Visibility.Hidden, true);
 
             // This is an optimisation to prevent refreshing the available settings controls when it can be

From cced8609f6d2190156d24c75d5a048166761eb74 Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Wed, 11 May 2022 22:51:15 +0100
Subject: [PATCH 4794/5547] Add `setCurrent` param to
 `ChannelManager.JoinChannel`

---
 osu.Game/Online/Chat/ChannelManager.cs | 12 +++++++-----
 1 file changed, 7 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Online/Chat/ChannelManager.cs b/osu.Game/Online/Chat/ChannelManager.cs
index 47e45e67d1..1fe784f68b 100644
--- a/osu.Game/Online/Chat/ChannelManager.cs
+++ b/osu.Game/Online/Chat/ChannelManager.cs
@@ -420,10 +420,11 @@ namespace osu.Game.Online.Chat
         /// Joins a channel if it has not already been joined. Must be called from the update thread.
         /// </summary>
         /// <param name="channel">The channel to join.</param>
+        /// <param name="setCurrent">Set the channel to join as the current channel if the current channel is null.</param>
         /// <returns>The joined channel. Note that this may not match the parameter channel as it is a backed object.</returns>
-        public Channel JoinChannel(Channel channel) => joinChannel(channel, true);
+        public Channel JoinChannel(Channel channel, bool setCurrent = true) => joinChannel(channel, true, setCurrent);
 
-        private Channel joinChannel(Channel channel, bool fetchInitialMessages = false)
+        private Channel joinChannel(Channel channel, bool fetchInitialMessages = false, bool setCurrent = true)
         {
             if (channel == null) return null;
 
@@ -439,7 +440,7 @@ namespace osu.Game.Online.Chat
                     case ChannelType.Multiplayer:
                         // join is implicit. happens when you join a multiplayer game.
                         // this will probably change in the future.
-                        joinChannel(channel, fetchInitialMessages);
+                        joinChannel(channel, fetchInitialMessages, setCurrent);
                         return channel;
 
                     case ChannelType.PM:
@@ -460,7 +461,7 @@ namespace osu.Game.Online.Chat
 
                     default:
                         var req = new JoinChannelRequest(channel);
-                        req.Success += () => joinChannel(channel, fetchInitialMessages);
+                        req.Success += () => joinChannel(channel, fetchInitialMessages, setCurrent);
                         req.Failure += ex => LeaveChannel(channel);
                         api.Queue(req);
                         return channel;
@@ -472,7 +473,8 @@ namespace osu.Game.Online.Chat
                     this.fetchInitialMessages(channel);
             }
 
-            CurrentChannel.Value ??= channel;
+            if (setCurrent)
+                CurrentChannel.Value ??= channel;
 
             return channel;
         }

From db371ab0685621d868aa9bb036e963f487ee1a6a Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Wed, 11 May 2022 22:52:15 +0100
Subject: [PATCH 4795/5547] Use `CurrentChannel == null` to show the channel
 selector

---
 .../Overlays/Chat/ChannelList/ChannelList.cs  |  8 ++---
 .../Chat/ChannelList/ChannelListItem.cs       |  5 +---
 .../Chat/ChannelList/ChannelListSelector.cs   | 12 ++++----
 osu.Game/Overlays/ChatOverlayV2.cs            | 29 ++-----------------
 4 files changed, 12 insertions(+), 42 deletions(-)

diff --git a/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs b/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs
index 076dc5719e..6bdf5ee084 100644
--- a/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs
+++ b/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs
@@ -6,7 +6,6 @@
 using System;
 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;
@@ -19,11 +18,9 @@ namespace osu.Game.Overlays.Chat.ChannelList
 {
     public class ChannelList : Container
     {
-        public Action<Channel>? OnRequestSelect;
+        public Action<Channel?>? OnRequestSelect;
         public Action<Channel>? OnRequestLeave;
 
-        public readonly BindableBool SelectorActive = new BindableBool();
-
         private readonly Dictionary<Channel, ChannelListItem> channelMap = new Dictionary<Channel, ChannelListItem>();
 
         private ChannelListItemFlow publicChannelFlow = null!;
@@ -56,7 +53,7 @@ namespace osu.Game.Overlays.Chat.ChannelList
                             new ChannelListSelector
                             {
                                 Margin = new MarginPadding { Bottom = 10 },
-                                SelectorActive = { BindTarget = SelectorActive },
+                                Action = () => OnRequestSelect?.Invoke(null),
                             },
                             privateChannelFlow = new ChannelListItemFlow("DIRECT MESSAGES"),
                         },
@@ -73,7 +70,6 @@ namespace osu.Game.Overlays.Chat.ChannelList
             ChannelListItem item = new ChannelListItem(channel);
             item.OnRequestSelect += chan => OnRequestSelect?.Invoke(chan);
             item.OnRequestLeave += chan => OnRequestLeave?.Invoke(chan);
-            item.SelectorActive.BindTarget = SelectorActive;
 
             ChannelListItemFlow flow = getFlowForChannel(channel);
             channelMap.Add(channel, item);
diff --git a/osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs b/osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs
index c5ac87f527..dd571c9ad9 100644
--- a/osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs
+++ b/osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs
@@ -31,8 +31,6 @@ namespace osu.Game.Overlays.Chat.ChannelList
 
         public readonly BindableBool Unread = new BindableBool();
 
-        public readonly BindableBool SelectorActive = new BindableBool();
-
         private Box hoverBox = null!;
         private Box selectBox = null!;
         private OsuSpriteText text = null!;
@@ -127,7 +125,6 @@ namespace osu.Game.Overlays.Chat.ChannelList
             base.LoadComplete();
 
             selectedChannel.BindValueChanged(_ => updateState(), true);
-            SelectorActive.BindValueChanged(_ => updateState(), true);
             Unread.BindValueChanged(_ => updateState(), true);
         }
 
@@ -163,7 +160,7 @@ namespace osu.Game.Overlays.Chat.ChannelList
 
         private void updateState()
         {
-            bool selected = selectedChannel.Value == Channel && !SelectorActive.Value;
+            bool selected = selectedChannel.Value == Channel;
 
             if (selected)
                 selectBox.FadeIn(300, Easing.OutQuint);
diff --git a/osu.Game/Overlays/Chat/ChannelList/ChannelListSelector.cs b/osu.Game/Overlays/Chat/ChannelList/ChannelListSelector.cs
index 9cba93ffa5..7beef7b16c 100644
--- a/osu.Game/Overlays/Chat/ChannelList/ChannelListSelector.cs
+++ b/osu.Game/Overlays/Chat/ChannelList/ChannelListSelector.cs
@@ -12,17 +12,19 @@ using osu.Framework.Input.Events;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
+using osu.Game.Online.Chat;
 
 namespace osu.Game.Overlays.Chat.ChannelList
 {
     public class ChannelListSelector : OsuClickableContainer
     {
-        public readonly BindableBool SelectorActive = new BindableBool();
-
         private Box hoverBox = null!;
         private Box selectBox = null!;
         private OsuSpriteText text = null!;
 
+        [Resolved]
+        private Bindable<Channel> currentChannel { get; set; } = null!;
+
         [Resolved]
         private OverlayColourProvider colourProvider { get; set; } = null!;
 
@@ -69,9 +71,9 @@ namespace osu.Game.Overlays.Chat.ChannelList
         {
             base.LoadComplete();
 
-            SelectorActive.BindValueChanged(selector =>
+            currentChannel.BindValueChanged(channel =>
             {
-                if (selector.NewValue)
+                if (channel.NewValue == null)
                 {
                     text.FadeColour(colourProvider.Content1, 300, Easing.OutQuint);
                     selectBox.FadeIn(300, Easing.OutQuint);
@@ -82,8 +84,6 @@ namespace osu.Game.Overlays.Chat.ChannelList
                     selectBox.FadeOut(200, Easing.OutQuint);
                 }
             }, true);
-
-            Action = () => SelectorActive.Value = true;
         }
 
         protected override bool OnHover(HoverEvent e)
diff --git a/osu.Game/Overlays/ChatOverlayV2.cs b/osu.Game/Overlays/ChatOverlayV2.cs
index e59bee7977..19609f0702 100644
--- a/osu.Game/Overlays/ChatOverlayV2.cs
+++ b/osu.Game/Overlays/ChatOverlayV2.cs
@@ -100,7 +100,6 @@ namespace osu.Game.Overlays
                     RelativeSizeAxes = Axes.Y,
                     Width = side_bar_width,
                     Padding = new MarginPadding { Top = top_bar_height },
-                    SelectorActive = { BindTarget = selectorActive },
                 },
                 new Container
                 {
@@ -157,20 +156,10 @@ namespace osu.Game.Overlays
             channelManager.JoinedChannels.BindCollectionChanged(joinedChannelsChanged, true);
             channelManager.AvailableChannels.BindCollectionChanged(availableChannelsChanged, true);
 
-            channelList.OnRequestSelect += channel =>
-            {
-                // Manually selecting a channel should dismiss the selector
-                selectorActive.Value = false;
-                channelManager.CurrentChannel.Value = channel;
-            };
+            channelList.OnRequestSelect += channel => channelManager.CurrentChannel.Value = channel;
             channelList.OnRequestLeave += channel => channelManager.LeaveChannel(channel);
 
-            channelListing.OnRequestJoin += channel =>
-            {
-                channelManager.JoinChannel(channel);
-                // Manually joining a channel should keep the selector open
-                selectorActive.Value = true;
-            };
+            channelListing.OnRequestJoin += channel => channelManager.JoinChannel(channel, false);
             channelListing.OnRequestLeave += channel => channelManager.LeaveChannel(channel);
 
             textBar.OnSearchTermsChanged += searchTerms => channelListing.SearchTerm = searchTerms;
@@ -257,21 +246,9 @@ namespace osu.Game.Overlays
 
             loading.Show();
 
-            // Channel is null when leaving the currently selected channel
             if (newChannel == null)
             {
-                // Don't need to autoswitch if the selector is visible
-                if (selectorActive.Value)
-                    return;
-
-                // Find another channel to switch to
-                newChannel = channelManager.JoinedChannels.FirstOrDefault(c => c != channel.OldValue);
-
-                if (newChannel == null)
-                    selectorActive.Value = true;
-                else
-                    currentChannel.Value = newChannel;
-
+                selectorActive.Value = true;
                 return;
             }
 

From c45e8f619b286b2af42a421f9d0337073b7bf5d4 Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Wed, 11 May 2022 22:52:25 +0100
Subject: [PATCH 4796/5547] Update `ChannelList` test scene

---
 .../Visual/Online/TestSceneChannelList.cs       | 17 -----------------
 1 file changed, 17 deletions(-)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneChannelList.cs b/osu.Game.Tests/Visual/Online/TestSceneChannelList.cs
index a3bfbd47a3..9929642539 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneChannelList.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneChannelList.cs
@@ -25,7 +25,6 @@ namespace osu.Game.Tests.Visual.Online
         [Cached]
         private readonly Bindable<Channel> selected = new Bindable<Channel>();
 
-        private OsuSpriteText selectorText;
         private OsuSpriteText selectedText;
         private OsuSpriteText leaveText;
         private ChannelList channelList;
@@ -43,21 +42,12 @@ namespace osu.Game.Tests.Visual.Online
                     Height = 0.7f,
                     RowDimensions = new[]
                     {
-                        new Dimension(GridSizeMode.Absolute, 20),
                         new Dimension(GridSizeMode.Absolute, 20),
                         new Dimension(GridSizeMode.Absolute, 20),
                         new Dimension(),
                     },
                     Content = new[]
                     {
-                        new Drawable[]
-                        {
-                            selectorText = new OsuSpriteText
-                            {
-                                Anchor = Anchor.TopCentre,
-                                Origin = Anchor.TopCentre,
-                            },
-                        },
                         new Drawable[]
                         {
                             selectedText = new OsuSpriteText
@@ -89,7 +79,6 @@ namespace osu.Game.Tests.Visual.Online
 
                 channelList.OnRequestSelect += channel =>
                 {
-                    channelList.SelectorActive.Value = false;
                     selected.Value = channel;
                 };
 
@@ -101,12 +90,6 @@ namespace osu.Game.Tests.Visual.Online
                     channelList.RemoveChannel(channel);
                 };
 
-                channelList.SelectorActive.BindValueChanged(change =>
-                {
-                    selectorText.Text = $"Channel Selector Active: {change.NewValue}";
-                    selected.Value = null;
-                }, true);
-
                 selected.BindValueChanged(change =>
                 {
                     selectedText.Text = $"Selected Channel: {change.NewValue?.Name ?? "[null]"}";

From b794deb5c544e5612745e1d33c32fa3122edd7e1 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 12 May 2022 12:06:51 +0900
Subject: [PATCH 4797/5547] Add null checks to screen context insertion

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

diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index 9edcf90132..3d56d33689 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -14,6 +14,7 @@ using osu.Framework.Audio;
 using osu.Framework.Bindables;
 using osu.Framework.Configuration;
 using osu.Framework.Extensions.IEnumerableExtensions;
+using osu.Framework.Extensions.TypeExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Sprites;
@@ -1203,8 +1204,8 @@ namespace osu.Game
             {
                 scope.Contexts[@"screen stack"] = new
                 {
-                    Current = newScreen.GetType().Name,
-                    Previous = current.GetType().Name,
+                    Current = newScreen?.GetType().ReadableName(),
+                    Previous = current?.GetType().ReadableName(),
                 };
             });
 

From fda61943b074eea3500b32422b032aacf5cac8a0 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 12 May 2022 13:04:17 +0900
Subject: [PATCH 4798/5547] Update distance snap test when cursor at centre of
 grid to be in line with expectations

---
 .../Editor/TestSceneOsuDistanceSnapGrid.cs               | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuDistanceSnapGrid.cs b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuDistanceSnapGrid.cs
index 3c3c5cb939..c50aec40a5 100644
--- a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuDistanceSnapGrid.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuDistanceSnapGrid.cs
@@ -113,7 +113,14 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
         public void TestCursorInCentre()
         {
             AddStep("move mouse to centre", () => InputManager.MoveMouseTo(grid.ToScreenSpace(grid_position)));
-            assertSnappedDistance(0);
+            assertSnappedDistance(beat_length);
+        }
+
+        [Test]
+        public void TestCursorAlmostInCentre()
+        {
+            AddStep("move mouse to almost centre", () => InputManager.MoveMouseTo(grid.ToScreenSpace(grid_position) + new Vector2(1)));
+            assertSnappedDistance(beat_length);
         }
 
         [Test]

From f51607521cef17d7ff4ef62082febe76e7252204 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 12 May 2022 13:11:51 +0900
Subject: [PATCH 4799/5547] Fix distance snap providing zero-distance snaps
 incorrectly

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

diff --git a/osu.Game/Screens/Edit/Compose/Components/CircularDistanceSnapGrid.cs b/osu.Game/Screens/Edit/Compose/Components/CircularDistanceSnapGrid.cs
index 2c6bb766ad..cb50ea0d4b 100644
--- a/osu.Game/Screens/Edit/Compose/Components/CircularDistanceSnapGrid.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/CircularDistanceSnapGrid.cs
@@ -7,6 +7,7 @@ using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Graphics.UserInterface;
+using osu.Framework.Utils;
 using osu.Game.Rulesets.Edit;
 using osu.Game.Rulesets.Objects;
 using osuTK;
@@ -76,14 +77,19 @@ namespace osu.Game.Screens.Edit.Compose.Components
 
             Vector2 travelVector = (position - StartPosition);
 
+            // We need a non-zero travel vector in order to find a valid direction.
             if (travelVector == Vector2.Zero)
-                return (StartPosition, StartTime);
+                travelVector = new Vector2(0, -1);
 
             float travelLength = travelVector.Length;
 
             // FindSnappedDistance will always round down, but we want to potentially round upwards.
             travelLength += DistanceBetweenTicks / 2;
 
+            // We never want to snap towards zero.
+            if (travelLength < DistanceBetweenTicks)
+                travelLength = DistanceBetweenTicks;
+
             // When interacting with the resolved snap provider, the distance spacing multiplier should first be removed
             // to allow for snapping at a non-multiplied ratio.
             float snappedDistance = SnapProvider.FindSnappedDistance(ReferenceObject, travelLength / distanceSpacingMultiplier);

From 2dfed6eda17ac3747fe6f3ac6d1406e25ef0a54e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 12 May 2022 13:53:57 +0900
Subject: [PATCH 4800/5547] Remove `selectorActive` bindable completely

---
 osu.Game/Overlays/ChatOverlayV2.cs | 34 +++++++++++++-----------------
 1 file changed, 15 insertions(+), 19 deletions(-)

diff --git a/osu.Game/Overlays/ChatOverlayV2.cs b/osu.Game/Overlays/ChatOverlayV2.cs
index 19609f0702..60b25ef52d 100644
--- a/osu.Game/Overlays/ChatOverlayV2.cs
+++ b/osu.Game/Overlays/ChatOverlayV2.cs
@@ -50,8 +50,6 @@ namespace osu.Game.Overlays
         private const float side_bar_width = 190;
         private const float chat_bar_height = 60;
 
-        private readonly BindableBool selectorActive = new BindableBool();
-
         [Resolved]
         private OsuConfigManager config { get; set; } = null!;
 
@@ -136,7 +134,6 @@ namespace osu.Game.Overlays
                     Anchor = Anchor.BottomRight,
                     Origin = Anchor.BottomRight,
                     Padding = new MarginPadding { Left = side_bar_width },
-                    ShowSearch = { BindTarget = selectorActive },
                 },
             };
         }
@@ -145,8 +142,6 @@ namespace osu.Game.Overlays
         {
             base.LoadComplete();
 
-            loading.Show();
-
             config.BindWith(OsuSetting.ChatDisplayHeight, chatHeight);
 
             chatHeight.BindValueChanged(height => { Height = height.NewValue; }, true);
@@ -164,8 +159,6 @@ namespace osu.Game.Overlays
 
             textBar.OnSearchTermsChanged += searchTerms => channelListing.SearchTerm = searchTerms;
             textBar.OnChatMessageCommitted += handleChatMessage;
-
-            selectorActive.BindValueChanged(v => channelListing.State.Value = v.NewValue ? Visibility.Visible : Visibility.Hidden, true);
         }
 
         /// <summary>
@@ -244,22 +237,25 @@ namespace osu.Game.Overlays
         {
             Channel? newChannel = channel.NewValue;
 
-            loading.Show();
-
             if (newChannel == null)
             {
-                selectorActive.Value = true;
-                return;
+                // null channel denotes that we should be showing the listing.
+                channelListing.State.Value = Visibility.Visible;
+                textBar.ShowSearch.Value = true;
             }
-
-            selectorActive.Value = false;
-
-            LoadComponentAsync(new DrawableChannel(newChannel), loaded =>
+            else
             {
-                currentChannelContainer.Clear();
-                currentChannelContainer.Add(loaded);
-                loading.Hide();
-            });
+                channelListing.State.Value = Visibility.Hidden;
+                textBar.ShowSearch.Value = false;
+
+                loading.Show();
+                LoadComponentAsync(new DrawableChannel(newChannel), loaded =>
+                {
+                    currentChannelContainer.Clear();
+                    currentChannelContainer.Add(loaded);
+                    loading.Hide();
+                });
+            }
         }
 
         private void joinedChannelsChanged(object sender, NotifyCollectionChangedEventArgs args)

From 1d38e5bd33ad8764ae3b16b468a967430174f3e3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 12 May 2022 13:58:10 +0900
Subject: [PATCH 4801/5547] Add notes about weird local handling in
 `ChannelListSelector`

---
 osu.Game/Overlays/Chat/ChannelList/ChannelListSelector.cs | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/osu.Game/Overlays/Chat/ChannelList/ChannelListSelector.cs b/osu.Game/Overlays/Chat/ChannelList/ChannelListSelector.cs
index 7beef7b16c..a07aad2041 100644
--- a/osu.Game/Overlays/Chat/ChannelList/ChannelListSelector.cs
+++ b/osu.Game/Overlays/Chat/ChannelList/ChannelListSelector.cs
@@ -73,6 +73,8 @@ namespace osu.Game.Overlays.Chat.ChannelList
 
             currentChannel.BindValueChanged(channel =>
             {
+                // This logic should be handled by the chat overlay rather than this component.
+                // Selected state should be moved to an abstract class and shared with ChannelListItem.
                 if (channel.NewValue == null)
                 {
                     text.FadeColour(colourProvider.Content1, 300, Easing.OutQuint);

From c54ca937c505c7056daca10b1fd2f65a938c7d69 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 12 May 2022 14:55:20 +0900
Subject: [PATCH 4802/5547] Fix CI inspections

---
 .../Screens/Edit/Compose/Components/CircularDistanceSnapGrid.cs  | 1 -
 1 file changed, 1 deletion(-)

diff --git a/osu.Game/Screens/Edit/Compose/Components/CircularDistanceSnapGrid.cs b/osu.Game/Screens/Edit/Compose/Components/CircularDistanceSnapGrid.cs
index cb50ea0d4b..771612fcf1 100644
--- a/osu.Game/Screens/Edit/Compose/Components/CircularDistanceSnapGrid.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/CircularDistanceSnapGrid.cs
@@ -7,7 +7,6 @@ using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Graphics.UserInterface;
-using osu.Framework.Utils;
 using osu.Game.Rulesets.Edit;
 using osu.Game.Rulesets.Objects;
 using osuTK;

From c0abce918fbacbd57f10a100d04cc1649d8bfb73 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 12 May 2022 15:23:41 +0900
Subject: [PATCH 4803/5547] Add `enum` to snap method as alternative to
 mutliple nested invocations

---
 .../Edit/CatchHitObjectComposer.cs            | 15 +++++---
 .../Editor/TestSceneManiaBeatSnapGrid.cs      |  7 +---
 .../Edit/ManiaHitObjectComposer.cs            |  4 +-
 .../Edit/OsuHitObjectComposer.cs              | 37 ++++++++-----------
 .../Editing/TestSceneDistanceSnapGrid.cs      |  5 +--
 osu.Game/Rulesets/Edit/HitObjectComposer.cs   | 23 ++++++------
 .../Rulesets/Edit/IPositionSnapProvider.cs    | 14 +------
 osu.Game/Rulesets/Edit/SnapType.cs            | 15 ++++++++
 .../Compose/Components/BlueprintContainer.cs  |  4 +-
 .../Compose/Components/Timeline/Timeline.cs   |  5 +--
 10 files changed, 62 insertions(+), 67 deletions(-)
 create mode 100644 osu.Game/Rulesets/Edit/SnapType.cs

diff --git a/osu.Game.Rulesets.Catch/Edit/CatchHitObjectComposer.cs b/osu.Game.Rulesets.Catch/Edit/CatchHitObjectComposer.cs
index 630a2cf645..6f59b3e543 100644
--- a/osu.Game.Rulesets.Catch/Edit/CatchHitObjectComposer.cs
+++ b/osu.Game.Rulesets.Catch/Edit/CatchHitObjectComposer.cs
@@ -6,6 +6,7 @@ using System.Linq;
 using JetBrains.Annotations;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
+using osu.Framework.Extensions.EnumExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Input;
@@ -89,15 +90,19 @@ namespace osu.Game.Rulesets.Catch.Edit
             new TernaryButton(distanceSnapToggle, "Distance Snap", () => new SpriteIcon { Icon = FontAwesome.Solid.Ruler })
         });
 
-        public override SnapResult FindSnappedPositionAndTime(Vector2 screenSpacePosition)
+        public override SnapResult FindSnappedPositionAndTime(Vector2 screenSpacePosition, SnapType snapType = SnapType.All)
         {
-            var result = base.FindSnappedPositionAndTime(screenSpacePosition);
+            var result = base.FindSnappedPositionAndTime(screenSpacePosition, snapType);
+
             result.ScreenSpacePosition.X = screenSpacePosition.X;
 
-            if (distanceSnapGrid.IsPresent && distanceSnapGrid.GetSnappedPosition(result.ScreenSpacePosition) is SnapResult snapResult &&
-                Vector2.Distance(snapResult.ScreenSpacePosition, result.ScreenSpacePosition) < distance_snap_radius)
+            if (snapType.HasFlagFast(SnapType.Grids))
             {
-                result = snapResult;
+                if (distanceSnapGrid.IsPresent && distanceSnapGrid.GetSnappedPosition(result.ScreenSpacePosition) is SnapResult snapResult &&
+                    Vector2.Distance(snapResult.ScreenSpacePosition, result.ScreenSpacePosition) < distance_snap_radius)
+                {
+                    result = snapResult;
+                }
             }
 
             return result;
diff --git a/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneManiaBeatSnapGrid.cs b/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneManiaBeatSnapGrid.cs
index 4bb049b1a4..6130a80bb4 100644
--- a/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneManiaBeatSnapGrid.cs
+++ b/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneManiaBeatSnapGrid.cs
@@ -97,12 +97,7 @@ namespace osu.Game.Rulesets.Mania.Tests.Editor
             set => InternalChild = value;
         }
 
-        public override SnapResult FindSnappedPositionAndTime(Vector2 screenSpacePosition)
-        {
-            throw new System.NotImplementedException();
-        }
-
-        public override SnapResult FindSnappedPosition(Vector2 screenSpacePosition)
+        public override SnapResult FindSnappedPositionAndTime(Vector2 screenSpacePosition, SnapType snapType = SnapType.All)
         {
             throw new System.NotImplementedException();
         }
diff --git a/osu.Game.Rulesets.Mania/Edit/ManiaHitObjectComposer.cs b/osu.Game.Rulesets.Mania/Edit/ManiaHitObjectComposer.cs
index fef315e2ef..3c022dafc0 100644
--- a/osu.Game.Rulesets.Mania/Edit/ManiaHitObjectComposer.cs
+++ b/osu.Game.Rulesets.Mania/Edit/ManiaHitObjectComposer.cs
@@ -56,9 +56,9 @@ namespace osu.Game.Rulesets.Mania.Edit
         protected override Playfield PlayfieldAtScreenSpacePosition(Vector2 screenSpacePosition) =>
             Playfield.GetColumnByPosition(screenSpacePosition);
 
-        public override SnapResult FindSnappedPositionAndTime(Vector2 screenSpacePosition)
+        public override SnapResult FindSnappedPositionAndTime(Vector2 screenSpacePosition, SnapType snapType = SnapType.All)
         {
-            var result = base.FindSnappedPositionAndTime(screenSpacePosition);
+            var result = base.FindSnappedPositionAndTime(screenSpacePosition, snapType);
 
             switch (ScrollingInfo.Direction.Value)
             {
diff --git a/osu.Game.Rulesets.Osu/Edit/OsuHitObjectComposer.cs b/osu.Game.Rulesets.Osu/Edit/OsuHitObjectComposer.cs
index 02beb0f2a4..b0d6170190 100644
--- a/osu.Game.Rulesets.Osu/Edit/OsuHitObjectComposer.cs
+++ b/osu.Game.Rulesets.Osu/Edit/OsuHitObjectComposer.cs
@@ -7,6 +7,7 @@ using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Caching;
+using osu.Framework.Extensions.EnumExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Sprites;
@@ -123,33 +124,27 @@ namespace osu.Game.Rulesets.Osu.Edit
             }
         }
 
-        public override SnapResult FindSnappedPosition(Vector2 screenSpacePosition)
+        public override SnapResult FindSnappedPositionAndTime(Vector2 screenSpacePosition, SnapType snapType = SnapType.All)
         {
-            if (snapToVisibleBlueprints(screenSpacePosition, out var snapResult))
+            if (snapType.HasFlagFast(SnapType.NearbyObjects) && snapToVisibleBlueprints(screenSpacePosition, out var snapResult))
                 return snapResult;
 
-            return new SnapResult(screenSpacePosition, null);
-        }
-
-        public override SnapResult FindSnappedPositionAndTime(Vector2 screenSpacePosition)
-        {
-            var positionSnap = FindSnappedPosition(screenSpacePosition);
-            if (positionSnap.ScreenSpacePosition != screenSpacePosition)
-                return positionSnap;
-
-            if (distanceSnapToggle.Value == TernaryState.True && distanceSnapGrid != null)
+            if (snapType.HasFlagFast(SnapType.Grids))
             {
-                (Vector2 pos, double time) = distanceSnapGrid.GetSnappedPosition(distanceSnapGrid.ToLocalSpace(screenSpacePosition));
-                return new SnapResult(distanceSnapGrid.ToScreenSpace(pos), time, PlayfieldAtScreenSpacePosition(screenSpacePosition));
+                if (distanceSnapToggle.Value == TernaryState.True && distanceSnapGrid != null)
+                {
+                    (Vector2 pos, double time) = distanceSnapGrid.GetSnappedPosition(distanceSnapGrid.ToLocalSpace(screenSpacePosition));
+                    return new SnapResult(distanceSnapGrid.ToScreenSpace(pos), time, PlayfieldAtScreenSpacePosition(screenSpacePosition));
+                }
+
+                if (rectangularGridSnapToggle.Value == TernaryState.True)
+                {
+                    Vector2 pos = rectangularPositionSnapGrid.GetSnappedPosition(rectangularPositionSnapGrid.ToLocalSpace(screenSpacePosition));
+                    return new SnapResult(rectangularPositionSnapGrid.ToScreenSpace(pos), null, PlayfieldAtScreenSpacePosition(screenSpacePosition));
+                }
             }
 
-            if (rectangularGridSnapToggle.Value == TernaryState.True)
-            {
-                Vector2 pos = rectangularPositionSnapGrid.GetSnappedPosition(rectangularPositionSnapGrid.ToLocalSpace(screenSpacePosition));
-                return new SnapResult(rectangularPositionSnapGrid.ToScreenSpace(pos), null, PlayfieldAtScreenSpacePosition(screenSpacePosition));
-            }
-
-            return base.FindSnappedPositionAndTime(screenSpacePosition);
+            return base.FindSnappedPositionAndTime(screenSpacePosition, snapType);
         }
 
         private bool snapToVisibleBlueprints(Vector2 screenSpacePosition, out SnapResult snapResult)
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneDistanceSnapGrid.cs b/osu.Game.Tests/Visual/Editing/TestSceneDistanceSnapGrid.cs
index 3aa3481cbf..ef07c3e411 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneDistanceSnapGrid.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneDistanceSnapGrid.cs
@@ -185,10 +185,7 @@ namespace osu.Game.Tests.Visual.Editing
 
         private class SnapProvider : IDistanceSnapProvider
         {
-            public SnapResult FindSnappedPosition(Vector2 screenSpacePosition) =>
-                new SnapResult(screenSpacePosition, null);
-
-            public SnapResult FindSnappedPositionAndTime(Vector2 screenSpacePosition) => new SnapResult(screenSpacePosition, 0);
+            public SnapResult FindSnappedPositionAndTime(Vector2 screenSpacePosition, SnapType snapType = SnapType.Grids) => new SnapResult(screenSpacePosition, 0);
 
             public Bindable<double> DistanceSpacingMultiplier { get; } = new BindableDouble(1);
 
diff --git a/osu.Game/Rulesets/Edit/HitObjectComposer.cs b/osu.Game/Rulesets/Edit/HitObjectComposer.cs
index 216510fcf3..f8d796a778 100644
--- a/osu.Game/Rulesets/Edit/HitObjectComposer.cs
+++ b/osu.Game/Rulesets/Edit/HitObjectComposer.cs
@@ -7,6 +7,7 @@ using System.Collections.Specialized;
 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.Input;
@@ -361,20 +362,23 @@ namespace osu.Game.Rulesets.Edit
         /// <returns>The most relevant <see cref="Playfield"/>.</returns>
         protected virtual Playfield PlayfieldAtScreenSpacePosition(Vector2 screenSpacePosition) => drawableRulesetWrapper.Playfield;
 
-        public override SnapResult FindSnappedPositionAndTime(Vector2 screenSpacePosition)
+        public override SnapResult FindSnappedPositionAndTime(Vector2 screenSpacePosition, SnapType snapType = SnapType.All)
         {
             var playfield = PlayfieldAtScreenSpacePosition(screenSpacePosition);
             double? targetTime = null;
 
-            if (playfield is ScrollingPlayfield scrollingPlayfield)
+            if (snapType.HasFlagFast(SnapType.Grids))
             {
-                targetTime = scrollingPlayfield.TimeAtScreenSpacePosition(screenSpacePosition);
+                if (playfield is ScrollingPlayfield scrollingPlayfield)
+                {
+                    targetTime = scrollingPlayfield.TimeAtScreenSpacePosition(screenSpacePosition);
 
-                // apply beat snapping
-                targetTime = BeatSnapProvider.SnapTime(targetTime.Value);
+                    // apply beat snapping
+                    targetTime = BeatSnapProvider.SnapTime(targetTime.Value);
 
-                // convert back to screen space
-                screenSpacePosition = scrollingPlayfield.ScreenSpacePositionAtTime(targetTime.Value);
+                    // convert back to screen space
+                    screenSpacePosition = scrollingPlayfield.ScreenSpacePositionAtTime(targetTime.Value);
+                }
             }
 
             return new SnapResult(screenSpacePosition, targetTime, playfield);
@@ -414,10 +418,7 @@ namespace osu.Game.Rulesets.Edit
 
         #region IPositionSnapProvider
 
-        public abstract SnapResult FindSnappedPositionAndTime(Vector2 screenSpacePosition);
-
-        public virtual SnapResult FindSnappedPosition(Vector2 screenSpacePosition) =>
-            new SnapResult(screenSpacePosition, null);
+        public abstract SnapResult FindSnappedPositionAndTime(Vector2 screenSpacePosition, SnapType snapType = SnapType.All);
 
         #endregion
     }
diff --git a/osu.Game/Rulesets/Edit/IPositionSnapProvider.cs b/osu.Game/Rulesets/Edit/IPositionSnapProvider.cs
index 837b04424a..a6a6e39e23 100644
--- a/osu.Game/Rulesets/Edit/IPositionSnapProvider.cs
+++ b/osu.Game/Rulesets/Edit/IPositionSnapProvider.cs
@@ -8,7 +8,6 @@ namespace osu.Game.Rulesets.Edit
 {
     /// <summary>
     /// A snap provider which given a proposed position for a hit object, potentially offers a more correct position and time value inferred from the context of the beatmap.
-    /// Provided values are inferred in an isolated context, without consideration of other nearby hit objects.
     /// </summary>
     [Cached]
     public interface IPositionSnapProvider
@@ -16,18 +15,9 @@ namespace osu.Game.Rulesets.Edit
         /// <summary>
         /// Given a position, find a valid time and position snap.
         /// </summary>
-        /// <remarks>
-        /// This call should be equivalent to running <see cref="FindSnappedPosition"/> with any additional logic that can be performed without the time immutability restriction.
-        /// </remarks>
         /// <param name="screenSpacePosition">The screen-space position to be snapped.</param>
+        /// <param name="snapType">The type of snapping to apply.</param>
         /// <returns>The time and position post-snapping.</returns>
-        SnapResult FindSnappedPositionAndTime(Vector2 screenSpacePosition);
-
-        /// <summary>
-        /// Given a position, find a valid position snap, without changing the time value.
-        /// </summary>
-        /// <param name="screenSpacePosition">The screen-space position to be snapped.</param>
-        /// <returns>The position post-snapping. Time will always be null.</returns>
-        SnapResult FindSnappedPosition(Vector2 screenSpacePosition);
+        SnapResult FindSnappedPositionAndTime(Vector2 screenSpacePosition, SnapType snapType = SnapType.All);
     }
 }
diff --git a/osu.Game/Rulesets/Edit/SnapType.cs b/osu.Game/Rulesets/Edit/SnapType.cs
new file mode 100644
index 0000000000..4ab67fee63
--- /dev/null
+++ b/osu.Game/Rulesets/Edit/SnapType.cs
@@ -0,0 +1,15 @@
+// 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.Rulesets.Edit
+{
+    [Flags]
+    public enum SnapType
+    {
+        NearbyObjects = 0,
+        Grids = 1,
+        All = NearbyObjects | Grids,
+    }
+}
diff --git a/osu.Game/Screens/Edit/Compose/Components/BlueprintContainer.cs b/osu.Game/Screens/Edit/Compose/Components/BlueprintContainer.cs
index 186c66e0af..d56dc176f6 100644
--- a/osu.Game/Screens/Edit/Compose/Components/BlueprintContainer.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/BlueprintContainer.cs
@@ -486,7 +486,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
                     Vector2 originalPosition = movementBlueprintOriginalPositions[i];
                     var testPosition = originalPosition + distanceTravelled;
 
-                    var positionalResult = snapProvider.FindSnappedPosition(testPosition);
+                    var positionalResult = snapProvider.FindSnappedPositionAndTime(testPosition, SnapType.NearbyObjects);
 
                     if (positionalResult.ScreenSpacePosition == testPosition) continue;
 
@@ -505,7 +505,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
             Vector2 movePosition = movementBlueprintOriginalPositions.First() + distanceTravelled;
 
             // Retrieve a snapped position.
-            var result = snapProvider?.FindSnappedPositionAndTime(movePosition);
+            var result = snapProvider?.FindSnappedPositionAndTime(movePosition, ~SnapType.NearbyObjects);
 
             if (result == null)
             {
diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/Timeline.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/Timeline.cs
index 7e66c57917..992ab7947e 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/Timeline.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/Timeline.cs
@@ -303,10 +303,7 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
         /// </summary>
         public double VisibleRange => track.Length / Zoom;
 
-        public SnapResult FindSnappedPosition(Vector2 screenSpacePosition) =>
-            new SnapResult(screenSpacePosition, null);
-
-        public SnapResult FindSnappedPositionAndTime(Vector2 screenSpacePosition) =>
+        public SnapResult FindSnappedPositionAndTime(Vector2 screenSpacePosition, SnapType snapType = SnapType.All) =>
             new SnapResult(screenSpacePosition, beatSnapProvider.SnapTime(getTimeFromPosition(Content.ToLocalSpace(screenSpacePosition))));
 
         private double getTimeFromPosition(Vector2 localPosition) =>

From f7e055dbfee9b68b6f93b69262e04c281a836245 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 12 May 2022 16:13:31 +0900
Subject: [PATCH 4804/5547] Move mania note height offset application to a much
 more suitable location

---
 .../Blueprints/ManiaPlacementBlueprint.cs     | 25 ++++++++++++++-
 .../Edit/ManiaHitObjectComposer.cs            | 31 +++----------------
 .../UI/Scrolling/ScrollingPlayfield.cs        |  2 +-
 3 files changed, 29 insertions(+), 29 deletions(-)

diff --git a/osu.Game.Rulesets.Mania/Edit/Blueprints/ManiaPlacementBlueprint.cs b/osu.Game.Rulesets.Mania/Edit/Blueprints/ManiaPlacementBlueprint.cs
index 8f25668dd0..ad95fd5e87 100644
--- a/osu.Game.Rulesets.Mania/Edit/Blueprints/ManiaPlacementBlueprint.cs
+++ b/osu.Game.Rulesets.Mania/Edit/Blueprints/ManiaPlacementBlueprint.cs
@@ -5,7 +5,10 @@ using osu.Framework.Graphics;
 using osu.Framework.Input.Events;
 using osu.Game.Rulesets.Edit;
 using osu.Game.Rulesets.Mania.Objects;
+using osu.Game.Rulesets.Mania.Skinning.Default;
 using osu.Game.Rulesets.Mania.UI;
+using osu.Game.Rulesets.UI.Scrolling;
+using osuTK;
 using osuTK.Input;
 
 namespace osu.Game.Rulesets.Mania.Edit.Blueprints
@@ -52,8 +55,28 @@ namespace osu.Game.Rulesets.Mania.Edit.Blueprints
         {
             base.UpdateTimeAndPosition(result);
 
+            var playfield = (Column)result.Playfield;
+
+            // Apply an offset to better align with the visual grid.
+            // This should only be applied during placement, as during selection / drag operations the movement is relative
+            // to the initial point of interaction rather than the grid.
+            switch (playfield.ScrollingInfo.Direction.Value)
+            {
+                case ScrollingDirection.Down:
+                    result.ScreenSpacePosition -= new Vector2(0, getNoteHeight(playfield) / 2);
+                    break;
+
+                case ScrollingDirection.Up:
+                    result.ScreenSpacePosition += new Vector2(0, getNoteHeight(playfield) / 2);
+                    break;
+            }
+
             if (PlacementActive == PlacementState.Waiting)
-                Column = result.Playfield as Column;
+                Column = playfield;
         }
+
+        private float getNoteHeight(Column resultPlayfield) =>
+            resultPlayfield.ToScreenSpace(new Vector2(DefaultNotePiece.NOTE_HEIGHT)).Y -
+            resultPlayfield.ToScreenSpace(Vector2.Zero).Y;
     }
 }
diff --git a/osu.Game.Rulesets.Mania/Edit/ManiaHitObjectComposer.cs b/osu.Game.Rulesets.Mania/Edit/ManiaHitObjectComposer.cs
index 3c022dafc0..c389e1bced 100644
--- a/osu.Game.Rulesets.Mania/Edit/ManiaHitObjectComposer.cs
+++ b/osu.Game.Rulesets.Mania/Edit/ManiaHitObjectComposer.cs
@@ -1,15 +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.Beatmaps;
-using osu.Game.Rulesets.Edit;
-using osu.Game.Rulesets.Edit.Tools;
-using osu.Game.Rulesets.Mania.Objects;
 using System.Collections.Generic;
 using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Input;
-using osu.Game.Rulesets.Mania.Skinning.Default;
+using osu.Game.Beatmaps;
+using osu.Game.Rulesets.Edit;
+using osu.Game.Rulesets.Edit.Tools;
+using osu.Game.Rulesets.Mania.Objects;
 using osu.Game.Rulesets.Mania.UI;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Objects;
@@ -56,28 +55,6 @@ namespace osu.Game.Rulesets.Mania.Edit
         protected override Playfield PlayfieldAtScreenSpacePosition(Vector2 screenSpacePosition) =>
             Playfield.GetColumnByPosition(screenSpacePosition);
 
-        public override SnapResult FindSnappedPositionAndTime(Vector2 screenSpacePosition, SnapType snapType = SnapType.All)
-        {
-            var result = base.FindSnappedPositionAndTime(screenSpacePosition, snapType);
-
-            switch (ScrollingInfo.Direction.Value)
-            {
-                case ScrollingDirection.Down:
-                    result.ScreenSpacePosition -= new Vector2(0, getNoteHeight() / 2);
-                    break;
-
-                case ScrollingDirection.Up:
-                    result.ScreenSpacePosition += new Vector2(0, getNoteHeight() / 2);
-                    break;
-            }
-
-            return result;
-        }
-
-        private float getNoteHeight() =>
-            Playfield.GetColumn(0).ToScreenSpace(new Vector2(DefaultNotePiece.NOTE_HEIGHT)).Y -
-            Playfield.GetColumn(0).ToScreenSpace(Vector2.Zero).Y;
-
         protected override DrawableRuleset<ManiaHitObject> CreateDrawableRuleset(Ruleset ruleset, IBeatmap beatmap, IReadOnlyList<Mod> mods = null)
         {
             drawableRuleset = new DrawableManiaEditorRuleset(ruleset, beatmap, mods);
diff --git a/osu.Game/Rulesets/UI/Scrolling/ScrollingPlayfield.cs b/osu.Game/Rulesets/UI/Scrolling/ScrollingPlayfield.cs
index 2b75f93f9e..782255733f 100644
--- a/osu.Game/Rulesets/UI/Scrolling/ScrollingPlayfield.cs
+++ b/osu.Game/Rulesets/UI/Scrolling/ScrollingPlayfield.cs
@@ -18,7 +18,7 @@ namespace osu.Game.Rulesets.UI.Scrolling
         public new ScrollingHitObjectContainer HitObjectContainer => (ScrollingHitObjectContainer)base.HitObjectContainer;
 
         [Resolved]
-        protected IScrollingInfo ScrollingInfo { get; private set; }
+        public IScrollingInfo ScrollingInfo { get; private set; }
 
         [BackgroundDependencyLoader]
         private void load()

From 10e41d018af6768090cdcebd41ebdc4a4e6c14c4 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 12 May 2022 17:36:35 +0900
Subject: [PATCH 4805/5547] Fix toggling hit animations on the editor not
 applying immediately

---
 osu.Game.Rulesets.Osu/Edit/DrawableOsuEditorRuleset.cs   | 9 +++++++++
 osu.Game/Rulesets/Objects/Drawables/DrawableHitObject.cs | 2 +-
 2 files changed, 10 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu/Edit/DrawableOsuEditorRuleset.cs b/osu.Game.Rulesets.Osu/Edit/DrawableOsuEditorRuleset.cs
index c89527d8bd..866e41d644 100644
--- a/osu.Game.Rulesets.Osu/Edit/DrawableOsuEditorRuleset.cs
+++ b/osu.Game.Rulesets.Osu/Edit/DrawableOsuEditorRuleset.cs
@@ -6,6 +6,7 @@ using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
+using osu.Framework.Lists;
 using osu.Game.Beatmaps;
 using osu.Game.Configuration;
 using osu.Game.Rulesets.Mods;
@@ -46,15 +47,23 @@ namespace osu.Game.Rulesets.Osu.Edit
                 HitPolicy = new AnyOrderHitPolicy();
             }
 
+            private readonly WeakList<DrawableHitObject> drawableHitObjects = new WeakList<DrawableHitObject>();
+
             [BackgroundDependencyLoader]
             private void load(OsuConfigManager config)
             {
                 hitAnimations = config.GetBindable<bool>(OsuSetting.EditorHitAnimations);
+                hitAnimations.BindValueChanged(_ =>
+                {
+                    foreach (var d in drawableHitObjects) d.RefreshStateTransforms();
+                });
             }
 
             protected override void OnNewDrawableHitObject(DrawableHitObject d)
             {
                 d.ApplyCustomUpdateState += updateState;
+
+                drawableHitObjects.Add(d);
             }
 
             private void updateState(DrawableHitObject hitObject, ArmedState state)
diff --git a/osu.Game/Rulesets/Objects/Drawables/DrawableHitObject.cs b/osu.Game/Rulesets/Objects/Drawables/DrawableHitObject.cs
index 5531bf8b5a..2e573a7f85 100644
--- a/osu.Game/Rulesets/Objects/Drawables/DrawableHitObject.cs
+++ b/osu.Game/Rulesets/Objects/Drawables/DrawableHitObject.cs
@@ -448,7 +448,7 @@ namespace osu.Game.Rulesets.Objects.Drawables
         /// <summary>
         /// Reapplies the current <see cref="ArmedState"/>.
         /// </summary>
-        protected void RefreshStateTransforms() => updateState(State.Value, true);
+        public void RefreshStateTransforms() => updateState(State.Value, true);
 
         /// <summary>
         /// Apply (generally fade-in) transforms leading into the <see cref="HitObject"/> start time.

From c4854d40048fde964eff9f54e01e60458c052555 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 12 May 2022 17:55:12 +0900
Subject: [PATCH 4806/5547] Fix slider ball rotation becoming undefined when
 time is not flowing smoothly

---
 osu.Game.Rulesets.Osu/Skinning/Default/SliderBall.cs | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Skinning/Default/SliderBall.cs b/osu.Game.Rulesets.Osu/Skinning/Default/SliderBall.cs
index 8943a91076..710967b741 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Default/SliderBall.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Default/SliderBall.cs
@@ -195,16 +195,16 @@ namespace osu.Game.Rulesets.Osu.Skinning.Default
 
         public void UpdateProgress(double completionProgress)
         {
-            var newPos = drawableSlider.HitObject.CurvePositionAt(completionProgress);
+            Position = drawableSlider.HitObject.CurvePositionAt(completionProgress);
 
-            var diff = lastPosition.HasValue ? lastPosition.Value - newPos : newPos - drawableSlider.HitObject.CurvePositionAt(completionProgress + 0.01f);
-            if (diff == Vector2.Zero)
+            var diff = lastPosition.HasValue ? lastPosition.Value - Position : Position - drawableSlider.HitObject.CurvePositionAt(completionProgress + 0.01f);
+
+            // Ensure the value is substantially high enough to allow for Atan2 to get a valid angle.
+            if (diff.LengthFast < 0.01f)
                 return;
 
-            Position = newPos;
             ball.Rotation = -90 + (float)(-Math.Atan2(diff.X, diff.Y) * 180 / Math.PI);
-
-            lastPosition = newPos;
+            lastPosition = Position;
         }
 
         private class FollowCircleContainer : CircularContainer

From f5649b926a09976f05050534e074f7131c8b46c4 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 12 May 2022 18:04:20 +0900
Subject: [PATCH 4807/5547] Use `AliveObjects` rather than tracking all
 hitobjects manually

---
 osu.Game.Rulesets.Osu/Edit/DrawableOsuEditorRuleset.cs | 8 ++------
 1 file changed, 2 insertions(+), 6 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Edit/DrawableOsuEditorRuleset.cs b/osu.Game.Rulesets.Osu/Edit/DrawableOsuEditorRuleset.cs
index 866e41d644..72d04d4211 100644
--- a/osu.Game.Rulesets.Osu/Edit/DrawableOsuEditorRuleset.cs
+++ b/osu.Game.Rulesets.Osu/Edit/DrawableOsuEditorRuleset.cs
@@ -6,7 +6,6 @@ using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
-using osu.Framework.Lists;
 using osu.Game.Beatmaps;
 using osu.Game.Configuration;
 using osu.Game.Rulesets.Mods;
@@ -47,23 +46,20 @@ namespace osu.Game.Rulesets.Osu.Edit
                 HitPolicy = new AnyOrderHitPolicy();
             }
 
-            private readonly WeakList<DrawableHitObject> drawableHitObjects = new WeakList<DrawableHitObject>();
-
             [BackgroundDependencyLoader]
             private void load(OsuConfigManager config)
             {
                 hitAnimations = config.GetBindable<bool>(OsuSetting.EditorHitAnimations);
                 hitAnimations.BindValueChanged(_ =>
                 {
-                    foreach (var d in drawableHitObjects) d.RefreshStateTransforms();
+                    foreach (var d in HitObjectContainer.AliveObjects)
+                        d.RefreshStateTransforms();
                 });
             }
 
             protected override void OnNewDrawableHitObject(DrawableHitObject d)
             {
                 d.ApplyCustomUpdateState += updateState;
-
-                drawableHitObjects.Add(d);
             }
 
             private void updateState(DrawableHitObject hitObject, ArmedState state)

From 4463a26f4e3c00287de0532fc14b02fdb3b96724 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 12 May 2022 17:19:07 +0900
Subject: [PATCH 4808/5547] Refactor opacity computation algorithm

---
 .../Preprocessing/OsuDifficultyHitObject.cs   | 31 ++++++++++++++-----
 .../Difficulty/Skills/Flashlight.cs           |  2 +-
 osu.Game.Rulesets.Osu/Mods/OsuModHidden.cs    |  8 ++---
 3 files changed, 28 insertions(+), 13 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
index 5cbddb5772..cf4802d282 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
@@ -4,6 +4,7 @@
 using System;
 using osu.Game.Rulesets.Difficulty.Preprocessing;
 using osu.Game.Rulesets.Objects;
+using osu.Game.Rulesets.Osu.Mods;
 using osu.Game.Rulesets.Osu.Objects;
 using osuTK;
 
@@ -85,19 +86,33 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
             setDistances(clockRate);
         }
 
-        public double Opacity(double mapTime, bool hidden)
+        public double OpacityAt(double time, bool hidden)
         {
-            double ms = BaseObject.StartTime - mapTime;
-            if (ms < 0)
+            if (time > BaseObject.StartTime)
+            {
+                // Consider a hitobject as being invisible when its start time is passed.
+                // In reality the hitobject will be visible beyond its start time up until its hittable window has passed,
+                // but this is an approximation and such a case is unlikely to be hit where this function is used.
                 return 0.0;
+            }
 
-            double preemptTime = BaseObject.TimePreempt;
-            double fadeInTime = BaseObject.TimeFadeIn;
+            double fadeInStartTime = BaseObject.StartTime - BaseObject.TimePreempt;
+            double fadeInDuration = BaseObject.TimeFadeIn;
 
             if (hidden)
-                return Math.Clamp(Math.Min((1.0 - ms / preemptTime) * 2.5, (ms / preemptTime - 0.3) * (1.0 / 0.3)), 0.0, 1.0);
-            else
-                return Math.Clamp((preemptTime - ms) / fadeInTime, 0.0, 1.0);
+            {
+                // Taken from OsuModHidden.
+                double fadeOutStartTime = BaseObject.StartTime - BaseObject.TimePreempt + BaseObject.TimeFadeIn;
+                double fadeOutDuration = BaseObject.TimePreempt * OsuModHidden.FADE_OUT_DURATION_MULTIPLIER;
+
+                return Math.Min
+                (
+                    Math.Clamp((time - fadeInStartTime) / fadeInDuration, 0.0, 1.0),
+                    1.0 - Math.Clamp((time - fadeOutStartTime) / fadeOutDuration, 0.0, 1.0)
+                );
+            }
+
+            return Math.Clamp((time - fadeInStartTime) / fadeInDuration, 0.0, 1.0);
         }
 
         private void setDistances(double clockRate)
diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
index 5d2052046b..d93007fae5 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
@@ -70,7 +70,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
                     double stackNerf = Math.Min(1.0, (currentObj.LazyJumpDistance / scalingFactor) / 25.0);
 
                     // Bonus based on how visible the object is.
-                    double opacityBonus = 1.0 + max_opacity_bonus * (1.0 - osuCurrent.Opacity(currentHitObject.StartTime, hidden));
+                    double opacityBonus = 1.0 + max_opacity_bonus * (1.0 - osuCurrent.OpacityAt(currentHitObject.StartTime, hidden));
 
                     result += stackNerf * opacityBonus * scalingFactor * jumpDistance / cumulativeStrainTime;
                 }
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModHidden.cs b/osu.Game.Rulesets.Osu/Mods/OsuModHidden.cs
index d602fe67ee..fc04e4d091 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModHidden.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModHidden.cs
@@ -27,8 +27,8 @@ namespace osu.Game.Rulesets.Osu.Mods
 
         public override Type[] IncompatibleMods => new[] { typeof(IRequiresApproachCircles), typeof(OsuModSpinIn) };
 
-        private const double fade_in_duration_multiplier = 0.4;
-        private const double fade_out_duration_multiplier = 0.3;
+        public const double FADE_IN_DURATION_MULTIPLIER = 0.4;
+        public const double FADE_OUT_DURATION_MULTIPLIER = 0.3;
 
         protected override bool IsFirstAdjustableObject(HitObject hitObject) => !(hitObject is Spinner || hitObject is SpinnerTick);
 
@@ -41,7 +41,7 @@ namespace osu.Game.Rulesets.Osu.Mods
 
             static void applyFadeInAdjustment(OsuHitObject osuObject)
             {
-                osuObject.TimeFadeIn = osuObject.TimePreempt * fade_in_duration_multiplier;
+                osuObject.TimeFadeIn = osuObject.TimePreempt * FADE_IN_DURATION_MULTIPLIER;
                 foreach (var nested in osuObject.NestedHitObjects.OfType<OsuHitObject>())
                     applyFadeInAdjustment(nested);
             }
@@ -156,7 +156,7 @@ namespace osu.Game.Rulesets.Osu.Mods
             static (double fadeStartTime, double fadeDuration) getParameters(OsuHitObject hitObject)
             {
                 double fadeOutStartTime = hitObject.StartTime - hitObject.TimePreempt + hitObject.TimeFadeIn;
-                double fadeOutDuration = hitObject.TimePreempt * fade_out_duration_multiplier;
+                double fadeOutDuration = hitObject.TimePreempt * FADE_OUT_DURATION_MULTIPLIER;
 
                 // new duration from completed fade in to end (before fading out)
                 double longFadeDuration = hitObject.GetEndTime() - fadeOutStartTime;

From 1b2c07e1423ef313b6e5228f347641176255f74e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 12 May 2022 19:25:51 +0900
Subject: [PATCH 4809/5547] Extend lifetime of `OsuSelectionBlueprint` to allow
 for lingering display

---
 .../Edit/Blueprints/OsuSelectionBlueprint.cs              | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/osu.Game.Rulesets.Osu/Edit/Blueprints/OsuSelectionBlueprint.cs b/osu.Game.Rulesets.Osu/Edit/Blueprints/OsuSelectionBlueprint.cs
index 994c5cebeb..dbf53ac9a6 100644
--- a/osu.Game.Rulesets.Osu/Edit/Blueprints/OsuSelectionBlueprint.cs
+++ b/osu.Game.Rulesets.Osu/Edit/Blueprints/OsuSelectionBlueprint.cs
@@ -1,19 +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.Framework.Allocation;
 using osu.Game.Rulesets.Edit;
+using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Osu.Objects;
 using osu.Game.Rulesets.Osu.Objects.Drawables;
+using osu.Game.Screens.Edit;
 
 namespace osu.Game.Rulesets.Osu.Edit.Blueprints
 {
     public abstract class OsuSelectionBlueprint<T> : HitObjectSelectionBlueprint<T>
         where T : OsuHitObject
     {
+        [Resolved]
+        private EditorClock editorClock { get; set; }
+
         protected new DrawableOsuHitObject DrawableObject => (DrawableOsuHitObject)base.DrawableObject;
 
         protected override bool AlwaysShowWhenSelected => true;
 
+        protected override bool ShouldBeAlive => base.ShouldBeAlive || editorClock.CurrentTime - Item.GetEndTime() < DrawableOsuEditorRuleset.EDITOR_HIT_OBJECT_FADE_OUT_EXTENSION;
+
         protected OsuSelectionBlueprint(T hitObject)
             : base(hitObject)
         {

From c63e65c677b5103e4fc18e11cef67bb32ad497a9 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 12 May 2022 19:26:13 +0900
Subject: [PATCH 4810/5547] Don't hide `SelectionBlueprint`s themselves, only
 their children

---
 osu.Game/Rulesets/Edit/SelectionBlueprint.cs | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/osu.Game/Rulesets/Edit/SelectionBlueprint.cs b/osu.Game/Rulesets/Edit/SelectionBlueprint.cs
index 12ab89f79e..5e5bc9036d 100644
--- a/osu.Game/Rulesets/Edit/SelectionBlueprint.cs
+++ b/osu.Game/Rulesets/Edit/SelectionBlueprint.cs
@@ -89,16 +89,12 @@ namespace osu.Game.Rulesets.Edit
             // set the body piece's alpha directly to avoid arbitrarily rendering frame buffers etc. of children.
             foreach (var d in InternalChildren)
                 d.Hide();
-
-            Hide();
         }
 
         protected virtual void OnSelected()
         {
             foreach (var d in InternalChildren)
                 d.Show();
-
-            Show();
         }
 
         // When not selected, input is only required for the blueprint itself to receive IsHovering

From be3d4c9bf5a52e5dfcdb78d834f068389db47035 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 12 May 2022 19:26:34 +0900
Subject: [PATCH 4811/5547] Add circle overlap marker, bringing back
 stable-like visibility of circles in the past

---
 .../Components/HitCircleOverlapMarker.cs      | 87 +++++++++++++++++++
 .../HitCircles/HitCircleSelectionBlueprint.cs |  9 +-
 .../Blueprints/Sliders/SliderCircleOverlay.cs | 23 ++++-
 3 files changed, 116 insertions(+), 3 deletions(-)
 create mode 100644 osu.Game.Rulesets.Osu/Edit/Blueprints/HitCircles/Components/HitCircleOverlapMarker.cs

diff --git a/osu.Game.Rulesets.Osu/Edit/Blueprints/HitCircles/Components/HitCircleOverlapMarker.cs b/osu.Game.Rulesets.Osu/Edit/Blueprints/HitCircles/Components/HitCircleOverlapMarker.cs
new file mode 100644
index 0000000000..34e5e120f1
--- /dev/null
+++ b/osu.Game.Rulesets.Osu/Edit/Blueprints/HitCircles/Components/HitCircleOverlapMarker.cs
@@ -0,0 +1,87 @@
+// 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.Shapes;
+using osu.Framework.Utils;
+using osu.Game.Graphics;
+using osu.Game.Rulesets.Objects.Types;
+using osu.Game.Rulesets.Osu.Objects;
+using osu.Game.Rulesets.Osu.Skinning.Default;
+using osu.Game.Screens.Edit;
+using osu.Game.Skinning;
+using osuTK;
+using osuTK.Graphics;
+
+namespace osu.Game.Rulesets.Osu.Edit.Blueprints.HitCircles.Components
+{
+    public class HitCircleOverlapMarker : BlueprintPiece<HitCircle>
+    {
+        private readonly Circle circle;
+        private readonly RingPiece ring;
+
+        [Resolved]
+        private EditorClock editorClock { get; set; }
+
+        public HitCircleOverlapMarker()
+        {
+            Origin = Anchor.Centre;
+
+            Size = new Vector2(OsuHitObject.OBJECT_RADIUS * 2);
+
+            InternalChildren = new Drawable[]
+            {
+                circle = new Circle
+                {
+                    Anchor = Anchor.Centre,
+                    Origin = Anchor.Centre,
+                    RelativeSizeAxes = Axes.Both,
+                    Colour = Color4.White,
+                },
+                ring = new RingPiece
+                {
+                    BorderThickness = 4,
+                }
+            };
+        }
+
+        [Resolved]
+        private ISkinSource skin { get; set; }
+
+        [BackgroundDependencyLoader]
+        private void load(OsuColour colours)
+        {
+            circle.BorderColour = colours.Yellow;
+        }
+
+        public override void UpdateFrom(HitCircle hitObject)
+        {
+            base.UpdateFrom(hitObject);
+
+            Scale = new Vector2(hitObject.Scale);
+
+            if ((hitObject is IHasComboInformation combo))
+                ring.BorderColour = combo.GetComboColour(skin);
+
+            bool hasReachedObject = editorClock.CurrentTime >= hitObject.StartTime;
+            float interpolation = Interpolation.ValueAt(editorClock.CurrentTime, 0, 1f, hitObject.StartTime, hitObject.StartTime + DrawableOsuEditorRuleset.EDITOR_HIT_OBJECT_FADE_OUT_EXTENSION, Easing.In);
+            float interpolation2 = MathHelper.Clamp(Interpolation.ValueAt(editorClock.CurrentTime, 0, 1f, hitObject.StartTime, hitObject.StartTime + DrawableOsuEditorRuleset.EDITOR_HIT_OBJECT_FADE_OUT_EXTENSION / 2, Easing.OutQuint), 0, 1);
+            float interpolation3 = Interpolation.ValueAt(editorClock.CurrentTime, 0, 1f, hitObject.StartTime, hitObject.StartTime + DrawableOsuEditorRuleset.EDITOR_HIT_OBJECT_FADE_OUT_EXTENSION);
+
+            if (hasReachedObject)
+            {
+                circle.Scale = new Vector2(1 - 0.05f * interpolation3);
+                ring.Scale = new Vector2(1 + 0.1f * interpolation2);
+                Alpha = 0.9f * (1 - (interpolation));
+            }
+            else
+                Alpha = 0;
+        }
+
+        public override void Hide()
+        {
+            // intentional no op so we are not hidden when not selected.
+        }
+    }
+}
diff --git a/osu.Game.Rulesets.Osu/Edit/Blueprints/HitCircles/HitCircleSelectionBlueprint.cs b/osu.Game.Rulesets.Osu/Edit/Blueprints/HitCircles/HitCircleSelectionBlueprint.cs
index b21a3e038e..3f9cfe21d4 100644
--- a/osu.Game.Rulesets.Osu/Edit/Blueprints/HitCircles/HitCircleSelectionBlueprint.cs
+++ b/osu.Game.Rulesets.Osu/Edit/Blueprints/HitCircles/HitCircleSelectionBlueprint.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.Graphics;
 using osu.Framework.Graphics.Primitives;
 using osu.Game.Rulesets.Osu.Edit.Blueprints.HitCircles.Components;
 using osu.Game.Rulesets.Osu.Objects;
@@ -14,11 +15,16 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.HitCircles
         protected new DrawableHitCircle DrawableObject => (DrawableHitCircle)base.DrawableObject;
 
         protected readonly HitCirclePiece CirclePiece;
+        private readonly HitCircleOverlapMarker marker;
 
         public HitCircleSelectionBlueprint(HitCircle circle)
             : base(circle)
         {
-            InternalChild = CirclePiece = new HitCirclePiece();
+            InternalChildren = new Drawable[]
+            {
+                marker = new HitCircleOverlapMarker(),
+                CirclePiece = new HitCirclePiece(),
+            };
         }
 
         protected override void Update()
@@ -26,6 +32,7 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.HitCircles
             base.Update();
 
             CirclePiece.UpdateFrom(HitObject);
+            marker.UpdateFrom(HitObject);
         }
 
         public override bool ReceivePositionalInputAt(Vector2 screenSpacePos) => DrawableObject.HitArea.ReceivePositionalInputAt(screenSpacePos);
diff --git a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/SliderCircleOverlay.cs b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/SliderCircleOverlay.cs
index 241ff70a18..d31d2aed97 100644
--- a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/SliderCircleOverlay.cs
+++ b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/SliderCircleOverlay.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.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Rulesets.Osu.Edit.Blueprints.HitCircles.Components;
 using osu.Game.Rulesets.Osu.Objects;
@@ -13,20 +14,38 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders
 
         private readonly Slider slider;
         private readonly SliderPosition position;
+        private readonly HitCircleOverlapMarker marker;
 
         public SliderCircleOverlay(Slider slider, SliderPosition position)
         {
             this.slider = slider;
             this.position = position;
 
-            InternalChild = CirclePiece = new HitCirclePiece();
+            InternalChildren = new Drawable[]
+            {
+                marker = new HitCircleOverlapMarker(),
+                CirclePiece = new HitCirclePiece(),
+            };
         }
 
         protected override void Update()
         {
             base.Update();
 
-            CirclePiece.UpdateFrom(position == SliderPosition.Start ? (HitCircle)slider.HeadCircle : slider.TailCircle);
+            var circle = position == SliderPosition.Start ? (HitCircle)slider.HeadCircle : slider.TailCircle;
+
+            CirclePiece.UpdateFrom(circle);
+            marker.UpdateFrom(circle);
+        }
+
+        public override void Hide()
+        {
+            CirclePiece.Hide();
+        }
+
+        public override void Show()
+        {
+            CirclePiece.Show();
         }
     }
 }

From f22ff4e087d5567831e6c2388bb0b031080728d6 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 12 May 2022 19:28:56 +0900
Subject: [PATCH 4812/5547] Remove editor animation toggling (replaced by
 overlap markers)

---
 .../Editor/TestSceneOsuEditorHitAnimations.cs | 114 ------------------
 .../Edit/DrawableOsuEditorRuleset.cs          |  76 ------------
 osu.Game/Configuration/OsuConfigManager.cs    |   2 -
 osu.Game/Screens/Edit/Editor.cs               |   1 -
 4 files changed, 193 deletions(-)
 delete mode 100644 osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuEditorHitAnimations.cs

diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuEditorHitAnimations.cs b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuEditorHitAnimations.cs
deleted file mode 100644
index 7ffa2c1f94..0000000000
--- a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuEditorHitAnimations.cs
+++ /dev/null
@@ -1,114 +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 NUnit.Framework;
-using osu.Framework.Allocation;
-using osu.Framework.Graphics;
-using osu.Framework.Graphics.Transforms;
-using osu.Framework.Testing;
-using osu.Framework.Utils;
-using osu.Game.Configuration;
-using osu.Game.Rulesets.Objects;
-using osu.Game.Rulesets.Objects.Drawables;
-using osu.Game.Rulesets.Osu.Edit;
-using osu.Game.Rulesets.Osu.Objects;
-using osu.Game.Rulesets.Osu.Objects.Drawables;
-
-namespace osu.Game.Rulesets.Osu.Tests.Editor
-{
-    [TestFixture]
-    public class TestSceneOsuEditorHitAnimations : TestSceneOsuEditor
-    {
-        [Resolved]
-        private OsuConfigManager config { get; set; }
-
-        [Test]
-        public void TestHitCircleAnimationDisable()
-        {
-            HitCircle hitCircle = null;
-            DrawableHitCircle drawableHitCircle = null;
-
-            AddStep("retrieve first hit circle", () => hitCircle = getHitCircle(0));
-            toggleAnimations(true);
-            seekSmoothlyTo(() => hitCircle.StartTime + 10);
-
-            AddStep("retrieve drawable", () => drawableHitCircle = (DrawableHitCircle)getDrawableObjectFor(hitCircle));
-            assertFutureTransforms(() => drawableHitCircle.CirclePiece, true);
-
-            AddStep("retrieve second hit circle", () => hitCircle = getHitCircle(1));
-            toggleAnimations(false);
-            seekSmoothlyTo(() => hitCircle.StartTime + 10);
-
-            AddStep("retrieve drawable", () => drawableHitCircle = (DrawableHitCircle)getDrawableObjectFor(hitCircle));
-            assertFutureTransforms(() => drawableHitCircle.CirclePiece, false);
-            AddAssert("hit circle has longer fade-out applied", () =>
-            {
-                var alphaTransform = drawableHitCircle.Transforms.Last(t => t.TargetMember == nameof(Alpha));
-                return alphaTransform.EndTime - alphaTransform.StartTime == DrawableOsuEditorRuleset.EDITOR_HIT_OBJECT_FADE_OUT_EXTENSION;
-            });
-        }
-
-        [Test]
-        public void TestSliderAnimationDisable()
-        {
-            Slider slider = null;
-            DrawableSlider drawableSlider = null;
-            DrawableSliderRepeat sliderRepeat = null;
-
-            AddStep("retrieve first slider with repeats", () => slider = getSliderWithRepeats(0));
-            toggleAnimations(true);
-            seekSmoothlyTo(() => slider.StartTime + slider.SpanDuration + 10);
-
-            retrieveDrawables();
-            assertFutureTransforms(() => sliderRepeat, true);
-
-            AddStep("retrieve second slider with repeats", () => slider = getSliderWithRepeats(1));
-            toggleAnimations(false);
-            seekSmoothlyTo(() => slider.StartTime + slider.SpanDuration + 10);
-
-            retrieveDrawables();
-            assertFutureTransforms(() => sliderRepeat.Arrow, false);
-            seekSmoothlyTo(() => slider.GetEndTime());
-            AddAssert("slider has longer fade-out applied", () =>
-            {
-                var alphaTransform = drawableSlider.Transforms.Last(t => t.TargetMember == nameof(Alpha));
-                return alphaTransform.EndTime - alphaTransform.StartTime == DrawableOsuEditorRuleset.EDITOR_HIT_OBJECT_FADE_OUT_EXTENSION;
-            });
-
-            void retrieveDrawables() =>
-                AddStep("retrieve drawables", () =>
-                {
-                    drawableSlider = (DrawableSlider)getDrawableObjectFor(slider);
-                    sliderRepeat = (DrawableSliderRepeat)getDrawableObjectFor(slider.NestedHitObjects.OfType<SliderRepeat>().First());
-                });
-        }
-
-        private HitCircle getHitCircle(int index)
-            => EditorBeatmap.HitObjects.OfType<HitCircle>().ElementAt(index);
-
-        private Slider getSliderWithRepeats(int index)
-            => EditorBeatmap.HitObjects.OfType<Slider>().Where(s => s.RepeatCount >= 1).ElementAt(index);
-
-        private DrawableHitObject getDrawableObjectFor(HitObject hitObject)
-            => this.ChildrenOfType<DrawableHitObject>().Single(ho => ho.HitObject == hitObject);
-
-        private IEnumerable<Transform> getTransformsRecursively(Drawable drawable)
-            => drawable.ChildrenOfType<Drawable>().SelectMany(d => d.Transforms);
-
-        private void toggleAnimations(bool enabled)
-            => AddStep($"toggle animations {(enabled ? "on" : "off")}", () => config.SetValue(OsuSetting.EditorHitAnimations, enabled));
-
-        private void seekSmoothlyTo(Func<double> targetTime)
-        {
-            AddStep("seek smoothly", () => EditorClock.SeekSmoothlyTo(targetTime.Invoke()));
-            AddUntilStep("wait for seek", () => Precision.AlmostEquals(targetTime.Invoke(), EditorClock.CurrentTime));
-        }
-
-        private void assertFutureTransforms(Func<Drawable> getDrawable, bool hasFutureTransforms)
-            => AddAssert($"object {(hasFutureTransforms ? "has" : "has no")} future transforms",
-                () => getTransformsRecursively(getDrawable()).Any(t => t.EndTime >= EditorClock.CurrentTime) == hasFutureTransforms);
-    }
-}
diff --git a/osu.Game.Rulesets.Osu/Edit/DrawableOsuEditorRuleset.cs b/osu.Game.Rulesets.Osu/Edit/DrawableOsuEditorRuleset.cs
index c89527d8bd..f542c88d89 100644
--- a/osu.Game.Rulesets.Osu/Edit/DrawableOsuEditorRuleset.cs
+++ b/osu.Game.Rulesets.Osu/Edit/DrawableOsuEditorRuleset.cs
@@ -2,16 +2,8 @@
 // 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.Beatmaps;
-using osu.Game.Configuration;
 using osu.Game.Rulesets.Mods;
-using osu.Game.Rulesets.Objects.Drawables;
-using osu.Game.Rulesets.Osu.Objects.Drawables;
-using osu.Game.Rulesets.Osu.Skinning.Default;
 using osu.Game.Rulesets.Osu.UI;
 using osu.Game.Rulesets.UI;
 using osuTK;
@@ -37,80 +29,12 @@ namespace osu.Game.Rulesets.Osu.Edit
 
         private class OsuEditorPlayfield : OsuPlayfield
         {
-            private Bindable<bool> hitAnimations;
-
             protected override GameplayCursorContainer CreateCursor() => null;
 
             public OsuEditorPlayfield()
             {
                 HitPolicy = new AnyOrderHitPolicy();
             }
-
-            [BackgroundDependencyLoader]
-            private void load(OsuConfigManager config)
-            {
-                hitAnimations = config.GetBindable<bool>(OsuSetting.EditorHitAnimations);
-            }
-
-            protected override void OnNewDrawableHitObject(DrawableHitObject d)
-            {
-                d.ApplyCustomUpdateState += updateState;
-            }
-
-            private void updateState(DrawableHitObject hitObject, ArmedState state)
-            {
-                if (state == ArmedState.Idle || hitAnimations.Value)
-                    return;
-
-                if (hitObject is DrawableHitCircle circle)
-                {
-                    using (circle.BeginAbsoluteSequence(circle.HitStateUpdateTime))
-                    {
-                        circle.ApproachCircle
-                              .FadeOutFromOne(EDITOR_HIT_OBJECT_FADE_OUT_EXTENSION * 4)
-                              .Expire();
-
-                        circle.ApproachCircle.ScaleTo(1.1f, 300, Easing.OutQuint);
-                    }
-                }
-
-                if (hitObject is IHasMainCirclePiece mainPieceContainer)
-                {
-                    // clear any explode animation logic.
-                    // this is scheduled after children to ensure that the clear happens after invocations of ApplyCustomUpdateState on the circle piece's nested skinnables.
-                    ScheduleAfterChildren(() =>
-                    {
-                        if (hitObject.HitObject == null) return;
-
-                        mainPieceContainer.CirclePiece.ApplyTransformsAt(hitObject.StateUpdateTime, true);
-                        mainPieceContainer.CirclePiece.ClearTransformsAfter(hitObject.StateUpdateTime, true);
-                    });
-                }
-
-                if (hitObject is DrawableSliderRepeat repeat)
-                {
-                    repeat.Arrow.ApplyTransformsAt(hitObject.StateUpdateTime, true);
-                    repeat.Arrow.ClearTransformsAfter(hitObject.StateUpdateTime, true);
-                }
-
-                // adjust the visuals of top-level object types to make them stay on screen for longer than usual.
-                switch (hitObject)
-                {
-                    case DrawableSlider _:
-                    case DrawableHitCircle _:
-                        // Get the existing fade out transform
-                        var existing = hitObject.Transforms.LastOrDefault(t => t.TargetMember == nameof(Alpha));
-
-                        if (existing == null)
-                            return;
-
-                        hitObject.RemoveTransform(existing);
-
-                        using (hitObject.BeginAbsoluteSequence(hitObject.HitStateUpdateTime))
-                            hitObject.FadeOut(EDITOR_HIT_OBJECT_FADE_OUT_EXTENSION).Expire();
-                        break;
-                }
-            }
         }
     }
 }
diff --git a/osu.Game/Configuration/OsuConfigManager.cs b/osu.Game/Configuration/OsuConfigManager.cs
index 026a83cceb..20d555c16c 100644
--- a/osu.Game/Configuration/OsuConfigManager.cs
+++ b/osu.Game/Configuration/OsuConfigManager.cs
@@ -163,7 +163,6 @@ namespace osu.Game.Configuration
             SetDefault(OsuSetting.DiscordRichPresence, DiscordRichPresenceMode.Full);
 
             SetDefault(OsuSetting.EditorWaveformOpacity, 0.25f);
-            SetDefault(OsuSetting.EditorHitAnimations, false);
         }
 
         public IDictionary<OsuSetting, string> GetLoggableState() =>
@@ -356,7 +355,6 @@ namespace osu.Game.Configuration
         GameplayDisableWinKey,
         SeasonalBackgroundMode,
         EditorWaveformOpacity,
-        EditorHitAnimations,
         DiscordRichPresence,
         AutomaticallyDownloadWhenSpectating,
         ShowOnlineExplicitContent,
diff --git a/osu.Game/Screens/Edit/Editor.cs b/osu.Game/Screens/Edit/Editor.cs
index 947c184009..75d2480a97 100644
--- a/osu.Game/Screens/Edit/Editor.cs
+++ b/osu.Game/Screens/Edit/Editor.cs
@@ -270,7 +270,6 @@ namespace osu.Game.Screens.Edit
                                         Items = new MenuItem[]
                                         {
                                             new WaveformOpacityMenuItem(config.GetBindable<float>(OsuSetting.EditorWaveformOpacity)),
-                                            new HitAnimationsMenuItem(config.GetBindable<bool>(OsuSetting.EditorHitAnimations))
                                         }
                                     }
                                 }

From 0c335592b3ed4eebd8428fa91dd4c90abb98010c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 12 May 2022 19:42:35 +0900
Subject: [PATCH 4813/5547] Tidy up interpolation and move `const` to new home

---
 .../Components/HitCircleOverlapMarker.cs      | 23 +++++++++++++------
 .../Edit/Blueprints/OsuSelectionBlueprint.cs  |  3 ++-
 .../Edit/DrawableOsuEditorRuleset.cs          |  6 -----
 3 files changed, 18 insertions(+), 14 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Edit/Blueprints/HitCircles/Components/HitCircleOverlapMarker.cs b/osu.Game.Rulesets.Osu/Edit/Blueprints/HitCircles/Components/HitCircleOverlapMarker.cs
index 34e5e120f1..579c9ef356 100644
--- a/osu.Game.Rulesets.Osu/Edit/Blueprints/HitCircles/Components/HitCircleOverlapMarker.cs
+++ b/osu.Game.Rulesets.Osu/Edit/Blueprints/HitCircles/Components/HitCircleOverlapMarker.cs
@@ -18,6 +18,12 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.HitCircles.Components
 {
     public class HitCircleOverlapMarker : BlueprintPiece<HitCircle>
     {
+        /// <summary>
+        /// Hit objects are intentionally made to fade out at a constant slower rate than in gameplay.
+        /// This allows a mapper to gain better historical context and use recent hitobjects as reference / snap points.
+        /// </summary>
+        public const double FADE_OUT_EXTENSION = 700;
+
         private readonly Circle circle;
         private readonly RingPiece ring;
 
@@ -64,16 +70,19 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.HitCircles.Components
             if ((hitObject is IHasComboInformation combo))
                 ring.BorderColour = combo.GetComboColour(skin);
 
-            bool hasReachedObject = editorClock.CurrentTime >= hitObject.StartTime;
-            float interpolation = Interpolation.ValueAt(editorClock.CurrentTime, 0, 1f, hitObject.StartTime, hitObject.StartTime + DrawableOsuEditorRuleset.EDITOR_HIT_OBJECT_FADE_OUT_EXTENSION, Easing.In);
-            float interpolation2 = MathHelper.Clamp(Interpolation.ValueAt(editorClock.CurrentTime, 0, 1f, hitObject.StartTime, hitObject.StartTime + DrawableOsuEditorRuleset.EDITOR_HIT_OBJECT_FADE_OUT_EXTENSION / 2, Easing.OutQuint), 0, 1);
-            float interpolation3 = Interpolation.ValueAt(editorClock.CurrentTime, 0, 1f, hitObject.StartTime, hitObject.StartTime + DrawableOsuEditorRuleset.EDITOR_HIT_OBJECT_FADE_OUT_EXTENSION);
+            double editorTime = editorClock.CurrentTime;
+            double hitObjectTime = hitObject.StartTime;
+            bool hasReachedObject = editorTime >= hitObjectTime;
 
             if (hasReachedObject)
             {
-                circle.Scale = new Vector2(1 - 0.05f * interpolation3);
-                ring.Scale = new Vector2(1 + 0.1f * interpolation2);
-                Alpha = 0.9f * (1 - (interpolation));
+                float alpha = Interpolation.ValueAt(editorTime, 0, 1f, hitObjectTime, hitObjectTime + FADE_OUT_EXTENSION, Easing.In);
+                float circleScale = Interpolation.ValueAt(editorTime, 0, 1f, hitObjectTime, hitObjectTime + FADE_OUT_EXTENSION);
+                float ringScale = MathHelper.Clamp(Interpolation.ValueAt(editorTime, 0, 1f, hitObjectTime, hitObjectTime + FADE_OUT_EXTENSION / 2, Easing.OutQuint), 0, 1);
+
+                circle.Scale = new Vector2(1 - 0.05f * circleScale);
+                ring.Scale = new Vector2(1 + 0.1f * ringScale);
+                Alpha = 0.9f * (1 - alpha);
             }
             else
                 Alpha = 0;
diff --git a/osu.Game.Rulesets.Osu/Edit/Blueprints/OsuSelectionBlueprint.cs b/osu.Game.Rulesets.Osu/Edit/Blueprints/OsuSelectionBlueprint.cs
index dbf53ac9a6..1d32e922ac 100644
--- a/osu.Game.Rulesets.Osu/Edit/Blueprints/OsuSelectionBlueprint.cs
+++ b/osu.Game.Rulesets.Osu/Edit/Blueprints/OsuSelectionBlueprint.cs
@@ -4,6 +4,7 @@
 using osu.Framework.Allocation;
 using osu.Game.Rulesets.Edit;
 using osu.Game.Rulesets.Objects;
+using osu.Game.Rulesets.Osu.Edit.Blueprints.HitCircles.Components;
 using osu.Game.Rulesets.Osu.Objects;
 using osu.Game.Rulesets.Osu.Objects.Drawables;
 using osu.Game.Screens.Edit;
@@ -20,7 +21,7 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints
 
         protected override bool AlwaysShowWhenSelected => true;
 
-        protected override bool ShouldBeAlive => base.ShouldBeAlive || editorClock.CurrentTime - Item.GetEndTime() < DrawableOsuEditorRuleset.EDITOR_HIT_OBJECT_FADE_OUT_EXTENSION;
+        protected override bool ShouldBeAlive => base.ShouldBeAlive || editorClock.CurrentTime - Item.GetEndTime() < HitCircleOverlapMarker.FADE_OUT_EXTENSION;
 
         protected OsuSelectionBlueprint(T hitObject)
             : base(hitObject)
diff --git a/osu.Game.Rulesets.Osu/Edit/DrawableOsuEditorRuleset.cs b/osu.Game.Rulesets.Osu/Edit/DrawableOsuEditorRuleset.cs
index f542c88d89..516b34d807 100644
--- a/osu.Game.Rulesets.Osu/Edit/DrawableOsuEditorRuleset.cs
+++ b/osu.Game.Rulesets.Osu/Edit/DrawableOsuEditorRuleset.cs
@@ -12,12 +12,6 @@ namespace osu.Game.Rulesets.Osu.Edit
 {
     public class DrawableOsuEditorRuleset : DrawableOsuRuleset
     {
-        /// <summary>
-        /// Hit objects are intentionally made to fade out at a constant slower rate than in gameplay.
-        /// This allows a mapper to gain better historical context and use recent hitobjects as reference / snap points.
-        /// </summary>
-        public const double EDITOR_HIT_OBJECT_FADE_OUT_EXTENSION = 700;
-
         public DrawableOsuEditorRuleset(Ruleset ruleset, IBeatmap beatmap, IReadOnlyList<Mod> mods)
             : base(ruleset, beatmap, mods)
         {

From 0318944b807d8c3a2aa75735f78f955ec3dab837 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 12 May 2022 23:37:29 +0900
Subject: [PATCH 4814/5547] Fix incorrect alive criteria causing clicking
 future objects to be too greedy

---
 osu.Game.Rulesets.Osu/Edit/Blueprints/OsuSelectionBlueprint.cs | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu/Edit/Blueprints/OsuSelectionBlueprint.cs b/osu.Game.Rulesets.Osu/Edit/Blueprints/OsuSelectionBlueprint.cs
index 1d32e922ac..2d0c6fe81d 100644
--- a/osu.Game.Rulesets.Osu/Edit/Blueprints/OsuSelectionBlueprint.cs
+++ b/osu.Game.Rulesets.Osu/Edit/Blueprints/OsuSelectionBlueprint.cs
@@ -21,7 +21,8 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints
 
         protected override bool AlwaysShowWhenSelected => true;
 
-        protected override bool ShouldBeAlive => base.ShouldBeAlive || editorClock.CurrentTime - Item.GetEndTime() < HitCircleOverlapMarker.FADE_OUT_EXTENSION;
+        protected override bool ShouldBeAlive => base.ShouldBeAlive
+                                                 || (editorClock.CurrentTime >= Item.StartTime && editorClock.CurrentTime - Item.GetEndTime() < HitCircleOverlapMarker.FADE_OUT_EXTENSION);
 
         protected OsuSelectionBlueprint(T hitObject)
             : base(hitObject)

From a35c57860cb309ff73ac62d41be0b39b5257c3b8 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 12 May 2022 23:54:43 +0900
Subject: [PATCH 4815/5547] Resolve colour inline

---
 osu.Game/Online/Chat/StandAloneChatDisplay.cs | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Online/Chat/StandAloneChatDisplay.cs b/osu.Game/Online/Chat/StandAloneChatDisplay.cs
index 79c4ed6068..b7e1bc999b 100644
--- a/osu.Game/Online/Chat/StandAloneChatDisplay.cs
+++ b/osu.Game/Online/Chat/StandAloneChatDisplay.cs
@@ -155,7 +155,8 @@ namespace osu.Game.Online.Chat
         {
             public Func<Message, ChatLine> CreateChatLineAction;
 
-            private Colour4 daySepColour;
+            [Resolved]
+            private OsuColour colours { get; set; }
 
             public StandAloneDrawableChannel(Channel channel)
                 : base(channel)
@@ -163,10 +164,9 @@ namespace osu.Game.Online.Chat
             }
 
             [BackgroundDependencyLoader]
-            private void load(OsuColour colours)
+            private void load()
             {
                 ChatLineFlow.Padding = new MarginPadding { Horizontal = 0 };
-                daySepColour = colours.Yellow;
             }
 
             protected override ChatLine CreateChatLine(Message m) => CreateChatLineAction(m);
@@ -174,7 +174,7 @@ namespace osu.Game.Online.Chat
             protected override Drawable CreateDaySeparator(DateTimeOffset time) => new DaySeparator(time)
             {
                 TextSize = 14,
-                Colour = daySepColour,
+                Colour = colours.Yellow,
                 LineHeight = 1,
                 Padding = new MarginPadding { Horizontal = 10 },
                 Margin = new MarginPadding { Vertical = 5 },

From 9f5351e5a195d490db4b19b808263aeeac725e85 Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Thu, 12 May 2022 23:48:58 +0100
Subject: [PATCH 4816/5547] Add drawable channel caching to new chat overlay

---
 osu.Game/Overlays/ChatOverlayV2.cs | 37 +++++++++++++++++++++++-------
 1 file changed, 29 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Overlays/ChatOverlayV2.cs b/osu.Game/Overlays/ChatOverlayV2.cs
index 6eec0bbbf4..bd3823f090 100644
--- a/osu.Game/Overlays/ChatOverlayV2.cs
+++ b/osu.Game/Overlays/ChatOverlayV2.cs
@@ -39,8 +39,9 @@ namespace osu.Game.Overlays
         private ChatTextBar textBar = null!;
         private Container<ChatOverlayDrawableChannel> currentChannelContainer = null!;
 
-        private readonly BindableFloat chatHeight = new BindableFloat();
+        private readonly Dictionary<Channel, ChatOverlayDrawableChannel> loadedChannels = new Dictionary<Channel, ChatOverlayDrawableChannel>();
 
+        private readonly BindableFloat chatHeight = new BindableFloat();
         private bool isDraggingTopBar;
         private float dragStartChatHeight;
 
@@ -173,7 +174,7 @@ namespace osu.Game.Overlays
             if (currentChannel.Value?.Id != channel.Id)
             {
                 if (!channel.Joined.Value)
-                    channel = channelManager.JoinChannel(channel);
+                    channel = channelManager.JoinChannel(channel, false);
 
                 channelManager.CurrentChannel.Value = channel;
             }
@@ -248,13 +249,26 @@ namespace osu.Game.Overlays
                 channelListing.State.Value = Visibility.Hidden;
                 textBar.ShowSearch.Value = false;
 
-                loading.Show();
-                LoadComponentAsync(new ChatOverlayDrawableChannel(newChannel), loaded =>
+                if (loadedChannels.ContainsKey(newChannel))
                 {
-                    currentChannelContainer.Clear();
-                    currentChannelContainer.Add(loaded);
-                    loading.Hide();
-                });
+                    currentChannelContainer.Clear(false);
+                    currentChannelContainer.Add(loadedChannels[newChannel]);
+                }
+                else
+                {
+                    loading.Show();
+
+                    // Ensure the drawable channel is stored before async load to prevent double loading
+                    ChatOverlayDrawableChannel drawableChannel = new ChatOverlayDrawableChannel(newChannel);
+                    loadedChannels.Add(newChannel, drawableChannel);
+
+                    LoadComponentAsync(drawableChannel, loaded =>
+                    {
+                        currentChannelContainer.Clear(false);
+                        currentChannelContainer.Add(loaded);
+                        loading.Hide();
+                    });
+                }
             }
         }
 
@@ -264,14 +278,21 @@ namespace osu.Game.Overlays
             {
                 case NotifyCollectionChangedAction.Add:
                     IEnumerable<Channel> joinedChannels = filterChannels(args.NewItems);
+
                     foreach (var channel in joinedChannels)
                         channelList.AddChannel(channel);
+
                     break;
 
                 case NotifyCollectionChangedAction.Remove:
                     IEnumerable<Channel> leftChannels = filterChannels(args.OldItems);
+
                     foreach (var channel in leftChannels)
+                    {
                         channelList.RemoveChannel(channel);
+                        loadedChannels.Remove(channel);
+                    }
+
                     break;
             }
         }

From ff13ef6bb05e0633d8c59e4a40273e084645336b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 13 May 2022 19:46:21 +0900
Subject: [PATCH 4817/5547] Fix a couple of markdown inspections

---
 README.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index dba0b2670d..9daa9635a9 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,5 @@
 <p align="center">
-  <img width="500px" src="assets/lazer.png">
+  <img width="500" alt="osu! logo" src="assets/lazer.png">
 </p>
 
 # osu!
@@ -31,7 +31,7 @@ If you are looking to install or test osu! without setting up a development envi
 
 **Latest build:**
 
-| [Windows 8.1+ (x64)](https://github.com/ppy/osu/releases/latest/download/install.exe) | macOS 10.15+ ([Intel](https://github.com/ppy/osu/releases/latest/download/osu.app.Intel.zip), [Apple Silicon](https://github.com/ppy/osu/releases/latest/download/osu.app.Apple.Silicon.zip)) | [Linux (x64)](https://github.com/ppy/osu/releases/latest/download/osu.AppImage) | [iOS 10+](https://osu.ppy.sh/home/testflight) | [Android 5+](https://github.com/ppy/osu/releases/latest/download/sh.ppy.osulazer.apk)
+| [Windows 8.1+ (x64)](https://github.com/ppy/osu/releases/latest/download/install.exe) | macOS 10.15+ ([Intel](https://github.com/ppy/osu/releases/latest/download/osu.app.Intel.zip), [Apple Silicon](https://github.com/ppy/osu/releases/latest/download/osu.app.Apple.Silicon.zip)) | [Linux (x64)](https://github.com/ppy/osu/releases/latest/download/osu.AppImage) | [iOS 10+](https://osu.ppy.sh/home/testflight) | [Android 5+](https://github.com/ppy/osu/releases/latest/download/sh.ppy.osulazer.apk) |
 | ------------- | ------------- | ------------- | ------------- | ------------- |
 
 - The iOS testflight link may fill up (Apple has a hard limit of 10,000 users). We reset it occasionally when this happens. Please do not ask about this. Check back regularly for link resets or follow [peppy](https://twitter.com/ppy) on twitter for announcements of link resets.

From 4b4f3ec06432bebadf6f020653c938c8c5bb8d27 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 13 May 2022 19:46:28 +0900
Subject: [PATCH 4818/5547] Add crowdin information to README

---
 README.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/README.md b/README.md
index 9daa9635a9..75d61dad4d 100644
--- a/README.md
+++ b/README.md
@@ -8,6 +8,7 @@
 [![GitHub release](https://img.shields.io/github/release/ppy/osu.svg)](https://github.com/ppy/osu/releases/latest)
 [![CodeFactor](https://www.codefactor.io/repository/github/ppy/osu/badge)](https://www.codefactor.io/repository/github/ppy/osu)
 [![dev chat](https://discordapp.com/api/guilds/188630481301012481/widget.png?style=shield)](https://discord.gg/ppy)
+[![Crowdin](https://d322cqt584bo4o.cloudfront.net/osu-web/localized.svg)](https://crowdin.com/project/osu-web)
 
 A free-to-win rhythm game. Rhythm is just a *click* away!
 
@@ -104,6 +105,8 @@ When it comes to contributing to the project, the two main things you can do to
 
 Note that while we already have certain standards in place, nothing is set in stone. If you have an issue with the way code is structured, with any libraries we are using, or with any processes involved with contributing, *please* bring it up. We welcome all feedback so we can make contributing to this project as painless as possible.
 
+If you wish to help with localisation efforts, head over to [crowdin](https://crowdin.com/project/osu-web).
+
 For those interested, we love to reward quality contributions via [bounties](https://docs.google.com/spreadsheets/d/1jNXfj_S3Pb5PErA-czDdC9DUu4IgUbe1Lt8E7CYUJuE/view?&rm=minimal#gid=523803337), paid out via PayPal or osu!supporter tags. Don't hesitate to [request a bounty](https://docs.google.com/forms/d/e/1FAIpQLSet_8iFAgPMG526pBZ2Kic6HSh7XPM3fE8xPcnWNkMzINDdYg/viewform) for your work on this project.
 
 ## Licence

From 15291623180b570b3687f1e4ae3b2eda1875ad0a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 13 May 2022 21:28:45 +0900
Subject: [PATCH 4819/5547] Remove circle scaling (apparently the fixed scale
 is required for spacing)

---
 .../Blueprints/HitCircles/Components/HitCircleOverlapMarker.cs  | 2 --
 1 file changed, 2 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Edit/Blueprints/HitCircles/Components/HitCircleOverlapMarker.cs b/osu.Game.Rulesets.Osu/Edit/Blueprints/HitCircles/Components/HitCircleOverlapMarker.cs
index 579c9ef356..e00abadb7e 100644
--- a/osu.Game.Rulesets.Osu/Edit/Blueprints/HitCircles/Components/HitCircleOverlapMarker.cs
+++ b/osu.Game.Rulesets.Osu/Edit/Blueprints/HitCircles/Components/HitCircleOverlapMarker.cs
@@ -77,10 +77,8 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.HitCircles.Components
             if (hasReachedObject)
             {
                 float alpha = Interpolation.ValueAt(editorTime, 0, 1f, hitObjectTime, hitObjectTime + FADE_OUT_EXTENSION, Easing.In);
-                float circleScale = Interpolation.ValueAt(editorTime, 0, 1f, hitObjectTime, hitObjectTime + FADE_OUT_EXTENSION);
                 float ringScale = MathHelper.Clamp(Interpolation.ValueAt(editorTime, 0, 1f, hitObjectTime, hitObjectTime + FADE_OUT_EXTENSION / 2, Easing.OutQuint), 0, 1);
 
-                circle.Scale = new Vector2(1 - 0.05f * circleScale);
                 ring.Scale = new Vector2(1 + 0.1f * ringScale);
                 Alpha = 0.9f * (1 - alpha);
             }

From 38b8baf0954a95cbf993144a5533b1d582abda44 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 13 May 2022 21:28:50 +0900
Subject: [PATCH 4820/5547] Remove unused border colour

---
 .../HitCircles/Components/HitCircleOverlapMarker.cs        | 7 -------
 1 file changed, 7 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Edit/Blueprints/HitCircles/Components/HitCircleOverlapMarker.cs b/osu.Game.Rulesets.Osu/Edit/Blueprints/HitCircles/Components/HitCircleOverlapMarker.cs
index e00abadb7e..b2fc310dcb 100644
--- a/osu.Game.Rulesets.Osu/Edit/Blueprints/HitCircles/Components/HitCircleOverlapMarker.cs
+++ b/osu.Game.Rulesets.Osu/Edit/Blueprints/HitCircles/Components/HitCircleOverlapMarker.cs
@@ -5,7 +5,6 @@ using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Utils;
-using osu.Game.Graphics;
 using osu.Game.Rulesets.Objects.Types;
 using osu.Game.Rulesets.Osu.Objects;
 using osu.Game.Rulesets.Osu.Skinning.Default;
@@ -55,12 +54,6 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.HitCircles.Components
         [Resolved]
         private ISkinSource skin { get; set; }
 
-        [BackgroundDependencyLoader]
-        private void load(OsuColour colours)
-        {
-            circle.BorderColour = colours.Yellow;
-        }
-
         public override void UpdateFrom(HitCircle hitObject)
         {
             base.UpdateFrom(hitObject);

From d9782b5ef67627ab3597176f2b38a6d0efd0a37e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 13 May 2022 21:31:49 +0900
Subject: [PATCH 4821/5547] Remove redundant parenthesis

---
 .../Blueprints/HitCircles/Components/HitCircleOverlapMarker.cs  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu/Edit/Blueprints/HitCircles/Components/HitCircleOverlapMarker.cs b/osu.Game.Rulesets.Osu/Edit/Blueprints/HitCircles/Components/HitCircleOverlapMarker.cs
index b2fc310dcb..b9d0d37d02 100644
--- a/osu.Game.Rulesets.Osu/Edit/Blueprints/HitCircles/Components/HitCircleOverlapMarker.cs
+++ b/osu.Game.Rulesets.Osu/Edit/Blueprints/HitCircles/Components/HitCircleOverlapMarker.cs
@@ -60,7 +60,7 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.HitCircles.Components
 
             Scale = new Vector2(hitObject.Scale);
 
-            if ((hitObject is IHasComboInformation combo))
+            if (hitObject is IHasComboInformation combo)
                 ring.BorderColour = combo.GetComboColour(skin);
 
             double editorTime = editorClock.CurrentTime;

From 35026ad6428f35b100575cdd0653d4694bdca3e5 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 13 May 2022 21:39:54 +0900
Subject: [PATCH 4822/5547] Add missing `EditorClock` caching

---
 osu.Game/Tests/Visual/SelectionBlueprintTestScene.cs | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/osu.Game/Tests/Visual/SelectionBlueprintTestScene.cs b/osu.Game/Tests/Visual/SelectionBlueprintTestScene.cs
index c3fb3bfc17..5448783f6d 100644
--- a/osu.Game/Tests/Visual/SelectionBlueprintTestScene.cs
+++ b/osu.Game/Tests/Visual/SelectionBlueprintTestScene.cs
@@ -2,16 +2,21 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using JetBrains.Annotations;
+using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Timing;
 using osu.Game.Rulesets.Edit;
 using osu.Game.Rulesets.Objects.Drawables;
+using osu.Game.Screens.Edit;
 
 namespace osu.Game.Tests.Visual
 {
     public abstract class SelectionBlueprintTestScene : OsuManualInputManagerTestScene
     {
+        [Cached]
+        private readonly EditorClock editorClock = new EditorClock();
+
         protected override Container<Drawable> Content => content ?? base.Content;
         private readonly Container content;
 

From dec298cccbdfd34108c2c34f771ed82d81ce643c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 13 May 2022 21:47:22 +0900
Subject: [PATCH 4823/5547] Update resources

---
 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 98dc28d915..b984f528fe 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -51,7 +51,7 @@
     <Reference Include="Java.Interop" />
   </ItemGroup>
   <ItemGroup>
-    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.422.0" />
+    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.513.0" />
     <PackageReference Include="ppy.osu.Framework.Android" Version="2022.511.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 772a78c8fe..7f149b4e35 100644
--- a/osu.Game/osu.Game.csproj
+++ b/osu.Game/osu.Game.csproj
@@ -36,7 +36,7 @@
     </PackageReference>
     <PackageReference Include="Realm" Version="10.12.0" />
     <PackageReference Include="ppy.osu.Framework" Version="2022.511.0" />
-    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.422.0" />
+    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.513.0" />
     <PackageReference Include="Sentry" Version="3.17.1" />
     <PackageReference Include="SharpCompress" Version="0.31.0" />
     <PackageReference Include="NUnit" Version="3.13.3" />
diff --git a/osu.iOS.props b/osu.iOS.props
index af8f9b617c..932421a705 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -62,7 +62,7 @@
   </ItemGroup>
   <ItemGroup Label="Package References">
     <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.511.0" />
-    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.422.0" />
+    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.513.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net6.0) -->
   <PropertyGroup>

From cf3ead80477621b7b911010f5435269964127d38 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 13 May 2022 22:06:30 +0900
Subject: [PATCH 4824/5547] Remove unused local

---
 .../Blueprints/HitCircles/Components/HitCircleOverlapMarker.cs | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Edit/Blueprints/HitCircles/Components/HitCircleOverlapMarker.cs b/osu.Game.Rulesets.Osu/Edit/Blueprints/HitCircles/Components/HitCircleOverlapMarker.cs
index b9d0d37d02..ad4be2017e 100644
--- a/osu.Game.Rulesets.Osu/Edit/Blueprints/HitCircles/Components/HitCircleOverlapMarker.cs
+++ b/osu.Game.Rulesets.Osu/Edit/Blueprints/HitCircles/Components/HitCircleOverlapMarker.cs
@@ -23,7 +23,6 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.HitCircles.Components
         /// </summary>
         public const double FADE_OUT_EXTENSION = 700;
 
-        private readonly Circle circle;
         private readonly RingPiece ring;
 
         [Resolved]
@@ -37,7 +36,7 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.HitCircles.Components
 
             InternalChildren = new Drawable[]
             {
-                circle = new Circle
+                new Circle
                 {
                     Anchor = Anchor.Centre,
                     Origin = Anchor.Centre,

From c4871ebcf4eaf35b3fe804d74a86b95474410e3a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 14 May 2022 02:50:51 +0900
Subject: [PATCH 4825/5547] Add editor track traversal keys (`Z`-`V`)

---
 osu.Game/Screens/Edit/Editor.cs | 39 +++++++++++++++++++++++++++++++++
 1 file changed, 39 insertions(+)

diff --git a/osu.Game/Screens/Edit/Editor.cs b/osu.Game/Screens/Edit/Editor.cs
index 947c184009..0fa9d4ef01 100644
--- a/osu.Game/Screens/Edit/Editor.cs
+++ b/osu.Game/Screens/Edit/Editor.cs
@@ -33,6 +33,7 @@ using osu.Game.Overlays.Notifications;
 using osu.Game.Resources.Localisation.Web;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Edit;
+using osu.Game.Rulesets.Objects;
 using osu.Game.Screens.Edit.Components;
 using osu.Game.Screens.Edit.Components.Menus;
 using osu.Game.Screens.Edit.Components.Timelines.Summary;
@@ -475,6 +476,44 @@ namespace osu.Game.Screens.Edit
                 case Key.Right:
                     seek(e, 1);
                     return true;
+
+                // Track traversal keys.
+                // Matching osu-stable implementations.
+                case Key.Z:
+                    // Seek to first object time, or track start if already there.
+                    double? firstObjectTime = editorBeatmap.HitObjects.FirstOrDefault()?.StartTime;
+
+                    if (firstObjectTime == null || clock.CurrentTime == firstObjectTime)
+                        clock.Seek(0);
+                    else
+                        clock.Seek(firstObjectTime.Value);
+                    return true;
+
+                case Key.X:
+                    // Restart playback from beginning of track.
+                    clock.Seek(0);
+                    clock.Start();
+                    return true;
+
+                case Key.C:
+                    // Pause or resume.
+                    if (clock.IsRunning)
+                        clock.Stop();
+                    else
+                        clock.Start();
+                    return true;
+
+                case Key.V:
+                    // Seek to last object time, or track end if already there.
+                    // Note that in osu-stable subsequent presses when at track end won't return to last object.
+                    // This has intentionally been changed to make it more useful.
+                    double? lastObjectTime = editorBeatmap.HitObjects.LastOrDefault()?.GetEndTime();
+
+                    if (lastObjectTime == null || clock.CurrentTime == lastObjectTime)
+                        clock.Seek(clock.TrackLength);
+                    else
+                        clock.Seek(lastObjectTime.Value);
+                    return true;
             }
 
             return base.OnKeyDown(e);

From a346456daf26a32b528e7024cc302370c6944206 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 14 May 2022 03:01:42 +0900
Subject: [PATCH 4826/5547] Add test coverage of new traversal keys

---
 .../Visual/Editing/TestSceneEditorSeeking.cs  | 45 +++++++++++++++++++
 1 file changed, 45 insertions(+)

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneEditorSeeking.cs b/osu.Game.Tests/Visual/Editing/TestSceneEditorSeeking.cs
index ff741a8ed5..da28387c4d 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneEditorSeeking.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneEditorSeeking.cs
@@ -28,6 +28,51 @@ namespace osu.Game.Tests.Visual.Editing
             return beatmap;
         }
 
+        [Test]
+        public void TestSeekToFirst()
+        {
+            pressAndCheckTime(Key.Z, 2170);
+            pressAndCheckTime(Key.Z, 0);
+            pressAndCheckTime(Key.Z, 2170);
+
+            AddAssert("track not running", () => !EditorClock.IsRunning);
+        }
+
+        [Test]
+        public void TestRestart()
+        {
+            pressAndCheckTime(Key.V, 227170);
+
+            AddAssert("track not running", () => !EditorClock.IsRunning);
+
+            AddStep("press X", () => InputManager.Key(Key.X));
+
+            AddAssert("track running", () => EditorClock.IsRunning);
+            AddAssert("time restarted", () => EditorClock.CurrentTime < 100000);
+        }
+
+        [Test]
+        public void TestPauseResume()
+        {
+            AddAssert("track not running", () => !EditorClock.IsRunning);
+
+            AddStep("press C", () => InputManager.Key(Key.C));
+            AddAssert("track running", () => EditorClock.IsRunning);
+
+            AddStep("press C", () => InputManager.Key(Key.C));
+            AddAssert("track not running", () => !EditorClock.IsRunning);
+        }
+
+        [Test]
+        public void TestSeekToLast()
+        {
+            pressAndCheckTime(Key.V, 227170);
+            pressAndCheckTime(Key.V, 229170);
+            pressAndCheckTime(Key.V, 227170);
+
+            AddAssert("track not running", () => !EditorClock.IsRunning);
+        }
+
         [Test]
         public void TestSnappedSeeking()
         {

From f88e416d1a7b6f63b0177f8bc042ec7470912d5b Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Fri, 13 May 2022 23:39:09 +0100
Subject: [PATCH 4827/5547] Ensure the wrong drawable channel isn't shown after
 load

---
 osu.Game/Overlays/ChatOverlayV2.cs | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/osu.Game/Overlays/ChatOverlayV2.cs b/osu.Game/Overlays/ChatOverlayV2.cs
index bd3823f090..361c06b04d 100644
--- a/osu.Game/Overlays/ChatOverlayV2.cs
+++ b/osu.Game/Overlays/ChatOverlayV2.cs
@@ -264,6 +264,14 @@ namespace osu.Game.Overlays
 
                     LoadComponentAsync(drawableChannel, loaded =>
                     {
+                        // Ensure the current channel hasn't changed by the time the load completes
+                        if (currentChannel.Value != newChannel)
+                            return;
+
+                        // Ensure the cached reference hasn't been removed from leaving the channel
+                        if (!loadedChannels.ContainsKey(newChannel))
+                            return;
+
                         currentChannelContainer.Clear(false);
                         currentChannelContainer.Add(loaded);
                         loading.Hide();

From 2163a78b7f591518a3e532ed2a4be7835a2953ea Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Sat, 14 May 2022 00:15:02 +0100
Subject: [PATCH 4828/5547] Ensure drawable channels removed from the cache are
 disposed

---
 osu.Game/Overlays/ChatOverlayV2.cs | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/ChatOverlayV2.cs b/osu.Game/Overlays/ChatOverlayV2.cs
index 361c06b04d..e76d395204 100644
--- a/osu.Game/Overlays/ChatOverlayV2.cs
+++ b/osu.Game/Overlays/ChatOverlayV2.cs
@@ -241,6 +241,7 @@ namespace osu.Game.Overlays
             if (newChannel == null)
             {
                 // null channel denotes that we should be showing the listing.
+                currentChannelContainer.Clear(false);
                 channelListing.State.Value = Visibility.Visible;
                 textBar.ShowSearch.Value = true;
             }
@@ -298,7 +299,13 @@ namespace osu.Game.Overlays
                     foreach (var channel in leftChannels)
                     {
                         channelList.RemoveChannel(channel);
-                        loadedChannels.Remove(channel);
+                        if (loadedChannels.ContainsKey(channel))
+                        {
+                            ChatOverlayDrawableChannel loaded = loadedChannels[channel];
+                            loadedChannels.Remove(channel);
+                            // DrawableChannel removed from cache must be manually disposed
+                            loaded.Dispose();
+                        }
                     }
 
                     break;

From bd68ffa805a6f3ae1d1a4a9853ebfa4f9aa1303d Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Sat, 14 May 2022 12:16:00 +0100
Subject: [PATCH 4829/5547] Fix textbox focus test in `ChatOverlayV2`

---
 osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs | 6 +++---
 osu.Game/Overlays/ChatOverlayV2.cs                     | 5 +++--
 2 files changed, 6 insertions(+), 5 deletions(-)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs b/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs
index bf1767cc96..82089ff3d1 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs
@@ -365,19 +365,19 @@ namespace osu.Game.Tests.Visual.Online
         }
 
         [Test]
-        public void TextBoxRetainsFocus()
+        public void TestTextBoxRetainsFocus()
         {
             AddStep("Show overlay", () => chatOverlay.Show());
             AddAssert("TextBox is focused", () => InputManager.FocusedDrawable == chatOverlayTextBox);
             AddStep("Join channel 1", () => channelManager.JoinChannel(testChannel1));
             AddStep("Select channel 1", () => clickDrawable(getChannelListItem(testChannel1)));
             AddAssert("TextBox is focused", () => InputManager.FocusedDrawable == chatOverlayTextBox);
+            AddStep("Click drawable channel", () => clickDrawable(currentDrawableChannel));
+            AddAssert("TextBox is focused", () => InputManager.FocusedDrawable == chatOverlayTextBox);
             AddStep("Click selector", () => clickDrawable(chatOverlay.ChildrenOfType<ChannelListSelector>().Single()));
             AddAssert("TextBox is focused", () => InputManager.FocusedDrawable == chatOverlayTextBox);
             AddStep("Click listing", () => clickDrawable(chatOverlay.ChildrenOfType<ChannelListing>().Single()));
             AddAssert("TextBox is focused", () => InputManager.FocusedDrawable == chatOverlayTextBox);
-            AddStep("Click drawable channel", () => clickDrawable(currentDrawableChannel));
-            AddAssert("TextBox is focused", () => InputManager.FocusedDrawable == chatOverlayTextBox);
             AddStep("Click channel list", () => clickDrawable(chatOverlay.ChildrenOfType<ChannelList>().Single()));
             AddAssert("TextBox is focused", () => InputManager.FocusedDrawable == chatOverlayTextBox);
             AddStep("Click top bar", () => clickDrawable(chatOverlay.ChildrenOfType<ChatOverlayTopBar>().Single()));
diff --git a/osu.Game/Overlays/ChatOverlayV2.cs b/osu.Game/Overlays/ChatOverlayV2.cs
index e76d395204..e91d57f18b 100644
--- a/osu.Game/Overlays/ChatOverlayV2.cs
+++ b/osu.Game/Overlays/ChatOverlayV2.cs
@@ -242,12 +242,12 @@ namespace osu.Game.Overlays
             {
                 // null channel denotes that we should be showing the listing.
                 currentChannelContainer.Clear(false);
-                channelListing.State.Value = Visibility.Visible;
+                channelListing.Show();
                 textBar.ShowSearch.Value = true;
             }
             else
             {
-                channelListing.State.Value = Visibility.Hidden;
+                channelListing.Hide();
                 textBar.ShowSearch.Value = false;
 
                 if (loadedChannels.ContainsKey(newChannel))
@@ -299,6 +299,7 @@ namespace osu.Game.Overlays
                     foreach (var channel in leftChannels)
                     {
                         channelList.RemoveChannel(channel);
+
                         if (loadedChannels.ContainsKey(channel))
                         {
                             ChatOverlayDrawableChannel loaded = loadedChannels[channel];

From d5027cdfbd4418a129687aed5b881c41cc34a823 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sat, 14 May 2022 19:46:13 +0300
Subject: [PATCH 4830/5547] Add `FeaturedInSpotlight` property to API
 beatmapsets

---
 .../Visual/Beatmaps/TestSceneBeatmapCard.cs   | 17 +++++++++----
 .../Online/TestSceneBeatmapSetOverlay.cs      | 24 +++++++++++++++++++
 .../API/Requests/Responses/APIBeatmapSet.cs   |  3 +++
 3 files changed, 39 insertions(+), 5 deletions(-)

diff --git a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs
index 94b693363a..6cb171974a 100644
--- a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs
+++ b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs
@@ -84,20 +84,26 @@ namespace osu.Game.Tests.Visual.Beatmaps
             explicitMap.Title = someDifficulties.TitleUnicode = "explicit beatmap";
             explicitMap.HasExplicitContent = true;
 
+            var spotlightMap = CreateAPIBeatmapSet(Ruleset.Value);
+            spotlightMap.Title = someDifficulties.TitleUnicode = "spotlight beatmap";
+            spotlightMap.FeaturedInSpotlight = true;
+
             var featuredMap = CreateAPIBeatmapSet(Ruleset.Value);
             featuredMap.Title = someDifficulties.TitleUnicode = "featured artist beatmap";
             featuredMap.TrackId = 1;
 
-            var explicitFeaturedMap = CreateAPIBeatmapSet(Ruleset.Value);
-            explicitFeaturedMap.Title = someDifficulties.TitleUnicode = "explicit featured artist";
-            explicitFeaturedMap.HasExplicitContent = true;
-            explicitFeaturedMap.TrackId = 2;
+            var allBadgesMap = CreateAPIBeatmapSet(Ruleset.Value);
+            allBadgesMap.Title = someDifficulties.TitleUnicode = "all-badges beatmap";
+            allBadgesMap.HasExplicitContent = true;
+            allBadgesMap.FeaturedInSpotlight = true;
+            allBadgesMap.TrackId = 2;
 
             var longName = CreateAPIBeatmapSet(Ruleset.Value);
             longName.Title = longName.TitleUnicode = "this track has an incredibly and implausibly long title";
             longName.Artist = longName.ArtistUnicode = "and this artist! who would have thunk it. it's really such a long name.";
             longName.Source = "wow. even the source field has an impossibly long string in it. this really takes the cake, doesn't it?";
             longName.HasExplicitContent = true;
+            longName.FeaturedInSpotlight = true;
             longName.TrackId = 444;
 
             testCases = new[]
@@ -108,8 +114,9 @@ namespace osu.Game.Tests.Visual.Beatmaps
                 someDifficulties,
                 manyDifficulties,
                 explicitMap,
+                spotlightMap,
                 featuredMap,
-                explicitFeaturedMap,
+                allBadgesMap,
                 longName
             };
 
diff --git a/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlay.cs b/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlay.cs
index f87cca80b0..859727e632 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlay.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlay.cs
@@ -165,6 +165,17 @@ namespace osu.Game.Tests.Visual.Online
             });
         }
 
+        [Test]
+        public void TestSpotlightBeatmap()
+        {
+            AddStep("show spotlight map", () =>
+            {
+                var beatmapSet = getBeatmapSet();
+                beatmapSet.FeaturedInSpotlight = true;
+                overlay.ShowBeatmapSet(beatmapSet);
+            });
+        }
+
         [Test]
         public void TestFeaturedBeatmap()
         {
@@ -176,6 +187,19 @@ namespace osu.Game.Tests.Visual.Online
             });
         }
 
+        [Test]
+        public void TestAllBadgesBeatmap()
+        {
+            AddStep("show map with all badges", () =>
+            {
+                var beatmapSet = getBeatmapSet();
+                beatmapSet.HasExplicitContent = true;
+                beatmapSet.FeaturedInSpotlight = true;
+                beatmapSet.TrackId = 1;
+                overlay.ShowBeatmapSet(beatmapSet);
+            });
+        }
+
         [Test]
         public void TestHide()
         {
diff --git a/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs b/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs
index d99c13b977..79c65fa79e 100644
--- a/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs
@@ -42,6 +42,9 @@ namespace osu.Game.Online.API.Requests.Responses
         [JsonProperty(@"nsfw")]
         public bool HasExplicitContent { get; set; }
 
+        [JsonProperty(@"spotlight")]
+        public bool FeaturedInSpotlight { get; set; }
+
         [JsonProperty(@"video")]
         public bool HasVideo { get; set; }
 

From c8bea6273b484018310d654fd80f3499ea531e91 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sat, 14 May 2022 19:46:34 +0300
Subject: [PATCH 4831/5547] Abstractify beatmap badge logic to own class

---
 .../Overlays/BeatmapSet/BeatmapBadgePill.cs   | 67 +++++++++++++++++++
 .../BeatmapSet/ExplicitContentBeatmapPill.cs  | 42 ++----------
 .../BeatmapSet/FeaturedArtistBeatmapPill.cs   | 42 ++----------
 3 files changed, 79 insertions(+), 72 deletions(-)
 create mode 100644 osu.Game/Overlays/BeatmapSet/BeatmapBadgePill.cs

diff --git a/osu.Game/Overlays/BeatmapSet/BeatmapBadgePill.cs b/osu.Game/Overlays/BeatmapSet/BeatmapBadgePill.cs
new file mode 100644
index 0000000000..2c5042942c
--- /dev/null
+++ b/osu.Game/Overlays/BeatmapSet/BeatmapBadgePill.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.Extensions.LocalisationExtensions;
+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.Graphics.Sprites;
+
+#nullable enable
+
+namespace osu.Game.Overlays.BeatmapSet
+{
+    public abstract class BeatmapBadgePill : CompositeDrawable
+    {
+        [Resolved]
+        protected OsuColour Colours { get; private set; } = null!;
+
+        [Resolved(canBeNull: true)]
+        protected OverlayColourProvider? ColourProvider { get; private set; }
+
+        /// <summary>
+        /// The text displayed on the badge's label.
+        /// </summary>
+        public abstract LocalisableString BadgeText { get; }
+
+        /// <summary>
+        /// The colour of the badge's label.
+        /// </summary>
+        public abstract Colour4 BadgeColour { get; }
+
+        // todo: add linking support, to allow redirecting featured artist badge to corresponding track and spotlight badge to wiki page.
+
+        protected BeatmapBadgePill()
+        {
+            AutoSizeAxes = Axes.Both;
+        }
+
+        [BackgroundDependencyLoader(true)]
+        private void load()
+        {
+            InternalChild = new CircularContainer
+            {
+                Masking = true,
+                AutoSizeAxes = Axes.Both,
+                Children = new Drawable[]
+                {
+                    new Box
+                    {
+                        RelativeSizeAxes = Axes.Both,
+                        Colour = ColourProvider?.Background5 ?? Colours.Gray2,
+                    },
+                    new OsuSpriteText
+                    {
+                        Font = OsuFont.GetFont(size: 10, weight: FontWeight.SemiBold),
+                        Margin = new MarginPadding { Horizontal = 10, Vertical = 2 },
+                        Text = BadgeText.ToUpper(),
+                        Colour = BadgeColour,
+                    }
+                }
+            };
+        }
+    }
+}
diff --git a/osu.Game/Overlays/BeatmapSet/ExplicitContentBeatmapPill.cs b/osu.Game/Overlays/BeatmapSet/ExplicitContentBeatmapPill.cs
index 21d1d1172c..f8530f3a16 100644
--- a/osu.Game/Overlays/BeatmapSet/ExplicitContentBeatmapPill.cs
+++ b/osu.Game/Overlays/BeatmapSet/ExplicitContentBeatmapPill.cs
@@ -1,47 +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.Allocation;
-using osu.Framework.Extensions.LocalisationExtensions;
 using osu.Framework.Graphics;
-using osu.Framework.Graphics.Containers;
-using osu.Framework.Graphics.Shapes;
-using osu.Game.Graphics;
-using osu.Game.Graphics.Sprites;
+using osu.Framework.Localisation;
 using osu.Game.Resources.Localisation.Web;
 
+#nullable enable
+
 namespace osu.Game.Overlays.BeatmapSet
 {
-    public class ExplicitContentBeatmapPill : CompositeDrawable
+    public class ExplicitContentBeatmapPill : BeatmapBadgePill
     {
-        public ExplicitContentBeatmapPill()
-        {
-            AutoSizeAxes = Axes.Both;
-        }
-
-        [BackgroundDependencyLoader(true)]
-        private void load(OsuColour colours, OverlayColourProvider colourProvider)
-        {
-            InternalChild = new CircularContainer
-            {
-                Masking = true,
-                AutoSizeAxes = Axes.Both,
-                Children = new Drawable[]
-                {
-                    new Box
-                    {
-                        RelativeSizeAxes = Axes.Both,
-                        Colour = colourProvider?.Background5 ?? colours.Gray2,
-                    },
-                    new OsuSpriteText
-                    {
-                        Margin = new MarginPadding { Horizontal = 10f, Vertical = 2f },
-                        Text = BeatmapsetsStrings.NsfwBadgeLabel.ToUpper(),
-                        Font = OsuFont.GetFont(size: 10, weight: FontWeight.SemiBold),
-                        Colour = colours.Orange2
-                    }
-                }
-            };
-        }
+        public override LocalisableString BadgeText => BeatmapsetsStrings.NsfwBadgeLabel;
+        public override Colour4 BadgeColour => Colours.Orange2;
     }
 }
diff --git a/osu.Game/Overlays/BeatmapSet/FeaturedArtistBeatmapPill.cs b/osu.Game/Overlays/BeatmapSet/FeaturedArtistBeatmapPill.cs
index 1be987cde2..4c29ede12e 100644
--- a/osu.Game/Overlays/BeatmapSet/FeaturedArtistBeatmapPill.cs
+++ b/osu.Game/Overlays/BeatmapSet/FeaturedArtistBeatmapPill.cs
@@ -1,47 +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.Allocation;
-using osu.Framework.Extensions.LocalisationExtensions;
 using osu.Framework.Graphics;
-using osu.Framework.Graphics.Containers;
-using osu.Framework.Graphics.Shapes;
-using osu.Game.Graphics;
-using osu.Game.Graphics.Sprites;
+using osu.Framework.Localisation;
 using osu.Game.Resources.Localisation.Web;
 
+#nullable enable
+
 namespace osu.Game.Overlays.BeatmapSet
 {
-    public class FeaturedArtistBeatmapPill : CompositeDrawable
+    public class FeaturedArtistBeatmapPill : BeatmapBadgePill
     {
-        public FeaturedArtistBeatmapPill()
-        {
-            AutoSizeAxes = Axes.Both;
-        }
-
-        [BackgroundDependencyLoader(true)]
-        private void load(OsuColour colours, OverlayColourProvider colourProvider)
-        {
-            InternalChild = new CircularContainer
-            {
-                Masking = true,
-                AutoSizeAxes = Axes.Both,
-                Children = new Drawable[]
-                {
-                    new Box
-                    {
-                        RelativeSizeAxes = Axes.Both,
-                        Colour = colourProvider?.Background5 ?? colours.Gray2,
-                    },
-                    new OsuSpriteText
-                    {
-                        Margin = new MarginPadding { Horizontal = 10f, Vertical = 2f },
-                        Text = BeatmapsetsStrings.FeaturedArtistBadgeLabel.ToUpper(),
-                        Font = OsuFont.GetFont(size: 10, weight: FontWeight.SemiBold),
-                        Colour = colours.Blue1
-                    }
-                }
-            };
-        }
+        public override LocalisableString BadgeText => BeatmapsetsStrings.FeaturedArtistBadgeLabel;
+        public override Colour4 BadgeColour => Colours.Blue1;
     }
 }

From 56d6cb5764f49eb2aaa98aef0b2ca97b3b88cbd6 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sat, 14 May 2022 19:46:50 +0300
Subject: [PATCH 4832/5547] Add "spotlight" beatmap badge

---
 .../Overlays/BeatmapSet/SpotlightBeatmapPill.cs | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)
 create mode 100644 osu.Game/Overlays/BeatmapSet/SpotlightBeatmapPill.cs

diff --git a/osu.Game/Overlays/BeatmapSet/SpotlightBeatmapPill.cs b/osu.Game/Overlays/BeatmapSet/SpotlightBeatmapPill.cs
new file mode 100644
index 0000000000..7376889d7b
--- /dev/null
+++ b/osu.Game/Overlays/BeatmapSet/SpotlightBeatmapPill.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.Framework.Graphics;
+using osu.Framework.Localisation;
+using osu.Game.Resources.Localisation.Web;
+
+#nullable enable
+
+namespace osu.Game.Overlays.BeatmapSet
+{
+    public class SpotlightBeatmapPill : BeatmapBadgePill
+    {
+        public override LocalisableString BadgeText => BeatmapsetsStrings.SpotlightBadgeLabel;
+        public override Colour4 BadgeColour => Colours.Pink1;
+    }
+}

From 2878a6dcbed331b7f73e5f8eb877fbc73745f7c2 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sat, 14 May 2022 19:47:10 +0300
Subject: [PATCH 4833/5547] Integrate spotlight beatmap badge in info overlay

---
 .../Overlays/BeatmapSet/BeatmapSetHeaderContent.cs    | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/osu.Game/Overlays/BeatmapSet/BeatmapSetHeaderContent.cs b/osu.Game/Overlays/BeatmapSet/BeatmapSetHeaderContent.cs
index 8f4089c707..4233cfcb70 100644
--- a/osu.Game/Overlays/BeatmapSet/BeatmapSetHeaderContent.cs
+++ b/osu.Game/Overlays/BeatmapSet/BeatmapSetHeaderContent.cs
@@ -39,8 +39,11 @@ namespace osu.Game.Overlays.BeatmapSet
         private readonly Box coverGradient;
         private readonly OsuSpriteText title, artist;
         private readonly AuthorInfo author;
+
         private readonly ExplicitContentBeatmapPill explicitContentPill;
+        private readonly SpotlightBeatmapPill spotlightPill;
         private readonly FeaturedArtistBeatmapPill featuredArtistPill;
+
         private readonly FillFlowContainer downloadButtonsContainer;
         private readonly BeatmapAvailability beatmapAvailability;
         private readonly BeatmapSetOnlineStatusPill onlineStatusPill;
@@ -127,6 +130,13 @@ namespace osu.Game.Overlays.BeatmapSet
                                                 Margin = new MarginPadding { Left = 5, Bottom = 4 }, // To better lineup with the font
                                             },
                                             explicitContentPill = new ExplicitContentBeatmapPill
+                                            {
+                                                Alpha = 0f,
+                                                Anchor = Anchor.BottomLeft,
+                                                Origin = Anchor.BottomLeft,
+                                                Margin = new MarginPadding { Left = 10, Bottom = 4 },
+                                            },
+                                            spotlightPill = new SpotlightBeatmapPill
                                             {
                                                 Alpha = 0f,
                                                 Anchor = Anchor.BottomLeft,
@@ -258,6 +268,7 @@ namespace osu.Game.Overlays.BeatmapSet
                     artist.Text = new RomanisableString(setInfo.NewValue.ArtistUnicode, setInfo.NewValue.Artist);
 
                     explicitContentPill.Alpha = setInfo.NewValue.HasExplicitContent ? 1 : 0;
+                    spotlightPill.Alpha = setInfo.NewValue.FeaturedInSpotlight ? 1 : 0;
                     featuredArtistPill.Alpha = setInfo.NewValue.TrackId != null ? 1 : 0;
 
                     onlineStatusPill.FadeIn(500, Easing.OutQuint);

From 9bac33ec9f6fb5a7c91f22356a803a50b3954f1e Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sat, 14 May 2022 19:47:29 +0300
Subject: [PATCH 4834/5547] Integrate spotlight beatmap badge in listing cards

---
 .../Drawables/Cards/BeatmapCardExtra.cs       | 30 +++++++++++++----
 .../Drawables/Cards/BeatmapCardNormal.cs      | 32 ++++++++++++++-----
 2 files changed, 47 insertions(+), 15 deletions(-)

diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtra.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtra.cs
index 535f222228..32da23b27d 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtra.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtra.cs
@@ -54,7 +54,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
             Height = height;
 
             FillFlowContainer leftIconArea = null!;
-            GridContainer titleContainer = null!;
+            FillFlowContainer titleBadgeArea = null!;
             GridContainer artistContainer = null!;
 
             Child = content.With(c =>
@@ -93,7 +93,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                                     Direction = FillDirection.Vertical,
                                     Children = new Drawable[]
                                     {
-                                        titleContainer = new GridContainer
+                                        new GridContainer
                                         {
                                             RelativeSizeAxes = Axes.X,
                                             AutoSizeAxes = Axes.Y,
@@ -108,7 +108,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                                             },
                                             Content = new[]
                                             {
-                                                new[]
+                                                new Drawable[]
                                                 {
                                                     new OsuSpriteText
                                                     {
@@ -117,7 +117,13 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                                                         RelativeSizeAxes = Axes.X,
                                                         Truncate = true
                                                     },
-                                                    Empty()
+                                                    titleBadgeArea = new FillFlowContainer
+                                                    {
+                                                        Anchor = Anchor.BottomRight,
+                                                        Origin = Anchor.BottomRight,
+                                                        AutoSizeAxes = Axes.Both,
+                                                        Direction = FillDirection.Horizontal,
+                                                    }
                                                 }
                                             }
                                         },
@@ -244,14 +250,24 @@ namespace osu.Game.Beatmaps.Drawables.Cards
             if (BeatmapSet.HasStoryboard)
                 leftIconArea.Add(new IconPill(FontAwesome.Solid.Image) { IconSize = new Vector2(20) });
 
-            if (BeatmapSet.HasExplicitContent)
+            if (BeatmapSet.FeaturedInSpotlight)
             {
-                titleContainer.Content[0][1] = new ExplicitContentBeatmapPill
+                titleBadgeArea.Add(new SpotlightBeatmapPill
                 {
                     Anchor = Anchor.BottomRight,
                     Origin = Anchor.BottomRight,
                     Margin = new MarginPadding { Left = 5 }
-                };
+                });
+            }
+
+            if (BeatmapSet.HasExplicitContent)
+            {
+                titleBadgeArea.Add(new ExplicitContentBeatmapPill
+                {
+                    Anchor = Anchor.BottomRight,
+                    Origin = Anchor.BottomRight,
+                    Margin = new MarginPadding { Left = 5 }
+                });
             }
 
             if (BeatmapSet.TrackId != null)
diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardNormal.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardNormal.cs
index 08befd5340..fc91c91e3c 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardNormal.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardNormal.cs
@@ -55,7 +55,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
             Height = height;
 
             FillFlowContainer leftIconArea = null!;
-            GridContainer titleContainer = null!;
+            FillFlowContainer titleBadgeArea = null!;
             GridContainer artistContainer = null!;
 
             Child = content.With(c =>
@@ -94,14 +94,14 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                                     Direction = FillDirection.Vertical,
                                     Children = new Drawable[]
                                     {
-                                        titleContainer = new GridContainer
+                                        new GridContainer
                                         {
                                             RelativeSizeAxes = Axes.X,
                                             AutoSizeAxes = Axes.Y,
                                             ColumnDimensions = new[]
                                             {
                                                 new Dimension(),
-                                                new Dimension(GridSizeMode.AutoSize)
+                                                new Dimension(GridSizeMode.AutoSize),
                                             },
                                             RowDimensions = new[]
                                             {
@@ -109,7 +109,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                                             },
                                             Content = new[]
                                             {
-                                                new[]
+                                                new Drawable[]
                                                 {
                                                     new OsuSpriteText
                                                     {
@@ -118,7 +118,13 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                                                         RelativeSizeAxes = Axes.X,
                                                         Truncate = true
                                                     },
-                                                    Empty()
+                                                    titleBadgeArea = new FillFlowContainer
+                                                    {
+                                                        Anchor = Anchor.BottomRight,
+                                                        Origin = Anchor.BottomRight,
+                                                        AutoSizeAxes = Axes.Both,
+                                                        Direction = FillDirection.Horizontal,
+                                                    }
                                                 }
                                             }
                                         },
@@ -225,14 +231,24 @@ namespace osu.Game.Beatmaps.Drawables.Cards
             if (BeatmapSet.HasStoryboard)
                 leftIconArea.Add(new IconPill(FontAwesome.Solid.Image) { IconSize = new Vector2(20) });
 
-            if (BeatmapSet.HasExplicitContent)
+            if (BeatmapSet.FeaturedInSpotlight)
             {
-                titleContainer.Content[0][1] = new ExplicitContentBeatmapPill
+                titleBadgeArea.Add(new SpotlightBeatmapPill
                 {
                     Anchor = Anchor.BottomRight,
                     Origin = Anchor.BottomRight,
                     Margin = new MarginPadding { Left = 5 }
-                };
+                });
+            }
+
+            if (BeatmapSet.HasExplicitContent)
+            {
+                titleBadgeArea.Add(new ExplicitContentBeatmapPill
+                {
+                    Anchor = Anchor.BottomRight,
+                    Origin = Anchor.BottomRight,
+                    Margin = new MarginPadding { Left = 5 }
+                });
             }
 
             if (BeatmapSet.TrackId != null)

From a759cf2dabd9a5cc4fd4fad57789007845d3699c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 15 May 2022 02:39:54 +0900
Subject: [PATCH 4835/5547] Add key binding to deselect all mods

Defaults to `Backspace`.
---
 .../UserInterface/TestSceneModSelectOverlay.cs | 18 +++++++++++++++++-
 .../Input/Bindings/GlobalActionContainer.cs    |  4 ++++
 .../GlobalActionKeyBindingStrings.cs           |  5 +++++
 osu.Game/Overlays/Mods/ModSelectOverlay.cs     |  4 ++++
 4 files changed, 30 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectOverlay.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectOverlay.cs
index 0b037a10cd..e946524a4b 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectOverlay.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectOverlay.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;
@@ -416,6 +416,22 @@ namespace osu.Game.Tests.Visual.UserInterface
             AddAssert("unimplemented mod panel is filtered", () => getPanelForMod(typeof(TestUnimplementedMod)).Filtered.Value);
         }
 
+        [Test]
+        public void TestDeselectAllViaKey()
+        {
+            createScreen();
+            changeRuleset(0);
+
+            AddStep("select DT + HD", () => SelectedMods.Value = new Mod[] { new OsuModDoubleTime(), new OsuModHidden() });
+            AddAssert("DT + HD selected", () => modSelectOverlay.ChildrenOfType<ModPanel>().Count(panel => panel.Active.Value) == 2);
+
+            AddStep("press bakcspace", () =>
+            {
+                InputManager.Key(Key.BackSpace);
+            });
+            AddUntilStep("all mods deselected", () => !SelectedMods.Value.Any());
+        }
+
         [Test]
         public void TestDeselectAllViaButton()
         {
diff --git a/osu.Game/Input/Bindings/GlobalActionContainer.cs b/osu.Game/Input/Bindings/GlobalActionContainer.cs
index 13a3f006fb..69ea6b00ca 100644
--- a/osu.Game/Input/Bindings/GlobalActionContainer.cs
+++ b/osu.Game/Input/Bindings/GlobalActionContainer.cs
@@ -109,6 +109,7 @@ namespace osu.Game.Input.Bindings
             new KeyBinding(InputKey.F2, GlobalAction.SelectNextRandom),
             new KeyBinding(new[] { InputKey.Shift, InputKey.F2 }, GlobalAction.SelectPreviousRandom),
             new KeyBinding(InputKey.F3, GlobalAction.ToggleBeatmapOptions),
+            new KeyBinding(InputKey.BackSpace, GlobalAction.DeselectAllMods),
         };
 
         public IEnumerable<KeyBinding> AudioControlKeyBindings => new[]
@@ -318,5 +319,8 @@ namespace osu.Game.Input.Bindings
 
         [LocalisableDescription(typeof(GlobalActionKeyBindingStrings), nameof(GlobalActionKeyBindingStrings.SelectNextGroup))]
         SelectNextGroup,
+
+        [LocalisableDescription(typeof(GlobalActionKeyBindingStrings), nameof(GlobalActionKeyBindingStrings.DeselectAllMods))]
+        DeselectAllMods,
     }
 }
diff --git a/osu.Game/Localisation/GlobalActionKeyBindingStrings.cs b/osu.Game/Localisation/GlobalActionKeyBindingStrings.cs
index b2f25de7f2..399e286478 100644
--- a/osu.Game/Localisation/GlobalActionKeyBindingStrings.cs
+++ b/osu.Game/Localisation/GlobalActionKeyBindingStrings.cs
@@ -209,6 +209,11 @@ namespace osu.Game.Localisation
         /// </summary>
         public static LocalisableString ToggleModSelection => new TranslatableString(getKey(@"toggle_mod_selection"), @"Toggle Mod Select");
 
+        /// <summary>
+        /// "Deselect all mods"
+        /// </summary>
+        public static LocalisableString DeselectAllMods => new TranslatableString(getKey(@"deselect_all_mods"), @"Deselect all mods");
+
         /// <summary>
         /// "Random"
         /// </summary>
diff --git a/osu.Game/Overlays/Mods/ModSelectOverlay.cs b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
index d068839ab0..fb988b5bfe 100644
--- a/osu.Game/Overlays/Mods/ModSelectOverlay.cs
+++ b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
@@ -508,6 +508,10 @@ namespace osu.Game.Overlays.Mods
                     hideOverlay(true);
                     return true;
                 }
+
+                case GlobalAction.DeselectAllMods:
+                    DeselectAll();
+                    return true;
             }
 
             return base.OnPressed(e);

From 6c3a4375c529ff4940c37fa376b17b1eff1a2a99 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 15 May 2022 02:40:35 +0900
Subject: [PATCH 4836/5547] Fix case of "toggle mod select" string

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

diff --git a/osu.Game/Localisation/GlobalActionKeyBindingStrings.cs b/osu.Game/Localisation/GlobalActionKeyBindingStrings.cs
index 399e286478..e392ae619f 100644
--- a/osu.Game/Localisation/GlobalActionKeyBindingStrings.cs
+++ b/osu.Game/Localisation/GlobalActionKeyBindingStrings.cs
@@ -207,7 +207,7 @@ namespace osu.Game.Localisation
         /// <summary>
         /// "Toggle Mod Select"
         /// </summary>
-        public static LocalisableString ToggleModSelection => new TranslatableString(getKey(@"toggle_mod_selection"), @"Toggle Mod Select");
+        public static LocalisableString ToggleModSelection => new TranslatableString(getKey(@"toggle_mod_selection"), @"Toggle mod select");
 
         /// <summary>
         /// "Deselect all mods"

From 88ba84ac9cc99c3a60632ca31aed38083a48dc7a Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sat, 14 May 2022 20:52:38 +0300
Subject: [PATCH 4837/5547] Replace `Pill` with `Badge` everywhere

---
 .../Drawables/Cards/BeatmapCardExtra.cs        |  6 +++---
 .../Drawables/Cards/BeatmapCardNormal.cs       |  6 +++---
 .../{BeatmapBadgePill.cs => BeatmapBadge.cs}   |  4 ++--
 .../BeatmapSet/BeatmapSetHeaderContent.cs      | 18 +++++++++---------
 ...pPill.cs => ExplicitContentBeatmapBadge.cs} |  2 +-
 ...apPill.cs => FeaturedArtistBeatmapBadge.cs} |  2 +-
 ...BeatmapPill.cs => SpotlightBeatmapBadge.cs} |  2 +-
 .../OnlinePlay/DrawableRoomPlaylistItem.cs     |  6 +++---
 8 files changed, 23 insertions(+), 23 deletions(-)
 rename osu.Game/Overlays/BeatmapSet/{BeatmapBadgePill.cs => BeatmapBadge.cs} (95%)
 rename osu.Game/Overlays/BeatmapSet/{ExplicitContentBeatmapPill.cs => ExplicitContentBeatmapBadge.cs} (88%)
 rename osu.Game/Overlays/BeatmapSet/{FeaturedArtistBeatmapPill.cs => FeaturedArtistBeatmapBadge.cs} (88%)
 rename osu.Game/Overlays/BeatmapSet/{SpotlightBeatmapPill.cs => SpotlightBeatmapBadge.cs} (89%)

diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtra.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtra.cs
index 32da23b27d..58c1ebee0f 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtra.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtra.cs
@@ -252,7 +252,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
 
             if (BeatmapSet.FeaturedInSpotlight)
             {
-                titleBadgeArea.Add(new SpotlightBeatmapPill
+                titleBadgeArea.Add(new SpotlightBeatmapBadge
                 {
                     Anchor = Anchor.BottomRight,
                     Origin = Anchor.BottomRight,
@@ -262,7 +262,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
 
             if (BeatmapSet.HasExplicitContent)
             {
-                titleBadgeArea.Add(new ExplicitContentBeatmapPill
+                titleBadgeArea.Add(new ExplicitContentBeatmapBadge
                 {
                     Anchor = Anchor.BottomRight,
                     Origin = Anchor.BottomRight,
@@ -272,7 +272,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
 
             if (BeatmapSet.TrackId != null)
             {
-                artistContainer.Content[0][1] = new FeaturedArtistBeatmapPill
+                artistContainer.Content[0][1] = new FeaturedArtistBeatmapBadge
                 {
                     Anchor = Anchor.BottomRight,
                     Origin = Anchor.BottomRight,
diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardNormal.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardNormal.cs
index fc91c91e3c..3d7e81de21 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardNormal.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardNormal.cs
@@ -233,7 +233,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
 
             if (BeatmapSet.FeaturedInSpotlight)
             {
-                titleBadgeArea.Add(new SpotlightBeatmapPill
+                titleBadgeArea.Add(new SpotlightBeatmapBadge
                 {
                     Anchor = Anchor.BottomRight,
                     Origin = Anchor.BottomRight,
@@ -243,7 +243,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
 
             if (BeatmapSet.HasExplicitContent)
             {
-                titleBadgeArea.Add(new ExplicitContentBeatmapPill
+                titleBadgeArea.Add(new ExplicitContentBeatmapBadge
                 {
                     Anchor = Anchor.BottomRight,
                     Origin = Anchor.BottomRight,
@@ -253,7 +253,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
 
             if (BeatmapSet.TrackId != null)
             {
-                artistContainer.Content[0][1] = new FeaturedArtistBeatmapPill
+                artistContainer.Content[0][1] = new FeaturedArtistBeatmapBadge
                 {
                     Anchor = Anchor.BottomRight,
                     Origin = Anchor.BottomRight,
diff --git a/osu.Game/Overlays/BeatmapSet/BeatmapBadgePill.cs b/osu.Game/Overlays/BeatmapSet/BeatmapBadge.cs
similarity index 95%
rename from osu.Game/Overlays/BeatmapSet/BeatmapBadgePill.cs
rename to osu.Game/Overlays/BeatmapSet/BeatmapBadge.cs
index 2c5042942c..6a444cc85f 100644
--- a/osu.Game/Overlays/BeatmapSet/BeatmapBadgePill.cs
+++ b/osu.Game/Overlays/BeatmapSet/BeatmapBadge.cs
@@ -14,7 +14,7 @@ using osu.Game.Graphics.Sprites;
 
 namespace osu.Game.Overlays.BeatmapSet
 {
-    public abstract class BeatmapBadgePill : CompositeDrawable
+    public abstract class BeatmapBadge : CompositeDrawable
     {
         [Resolved]
         protected OsuColour Colours { get; private set; } = null!;
@@ -34,7 +34,7 @@ namespace osu.Game.Overlays.BeatmapSet
 
         // todo: add linking support, to allow redirecting featured artist badge to corresponding track and spotlight badge to wiki page.
 
-        protected BeatmapBadgePill()
+        protected BeatmapBadge()
         {
             AutoSizeAxes = Axes.Both;
         }
diff --git a/osu.Game/Overlays/BeatmapSet/BeatmapSetHeaderContent.cs b/osu.Game/Overlays/BeatmapSet/BeatmapSetHeaderContent.cs
index 4233cfcb70..56efb725cd 100644
--- a/osu.Game/Overlays/BeatmapSet/BeatmapSetHeaderContent.cs
+++ b/osu.Game/Overlays/BeatmapSet/BeatmapSetHeaderContent.cs
@@ -40,9 +40,9 @@ namespace osu.Game.Overlays.BeatmapSet
         private readonly OsuSpriteText title, artist;
         private readonly AuthorInfo author;
 
-        private readonly ExplicitContentBeatmapPill explicitContentPill;
-        private readonly SpotlightBeatmapPill spotlightPill;
-        private readonly FeaturedArtistBeatmapPill featuredArtistPill;
+        private readonly ExplicitContentBeatmapBadge explicitContent;
+        private readonly SpotlightBeatmapBadge spotlight;
+        private readonly FeaturedArtistBeatmapBadge featuredArtist;
 
         private readonly FillFlowContainer downloadButtonsContainer;
         private readonly BeatmapAvailability beatmapAvailability;
@@ -129,14 +129,14 @@ namespace osu.Game.Overlays.BeatmapSet
                                                 Origin = Anchor.BottomLeft,
                                                 Margin = new MarginPadding { Left = 5, Bottom = 4 }, // To better lineup with the font
                                             },
-                                            explicitContentPill = new ExplicitContentBeatmapPill
+                                            explicitContent = new ExplicitContentBeatmapBadge
                                             {
                                                 Alpha = 0f,
                                                 Anchor = Anchor.BottomLeft,
                                                 Origin = Anchor.BottomLeft,
                                                 Margin = new MarginPadding { Left = 10, Bottom = 4 },
                                             },
-                                            spotlightPill = new SpotlightBeatmapPill
+                                            spotlight = new SpotlightBeatmapBadge
                                             {
                                                 Alpha = 0f,
                                                 Anchor = Anchor.BottomLeft,
@@ -156,7 +156,7 @@ namespace osu.Game.Overlays.BeatmapSet
                                             {
                                                 Font = OsuFont.GetFont(size: 20, weight: FontWeight.Medium, italics: true),
                                             },
-                                            featuredArtistPill = new FeaturedArtistBeatmapPill
+                                            featuredArtist = new FeaturedArtistBeatmapBadge
                                             {
                                                 Alpha = 0f,
                                                 Anchor = Anchor.BottomLeft,
@@ -267,9 +267,9 @@ namespace osu.Game.Overlays.BeatmapSet
                     title.Text = new RomanisableString(setInfo.NewValue.TitleUnicode, setInfo.NewValue.Title);
                     artist.Text = new RomanisableString(setInfo.NewValue.ArtistUnicode, setInfo.NewValue.Artist);
 
-                    explicitContentPill.Alpha = setInfo.NewValue.HasExplicitContent ? 1 : 0;
-                    spotlightPill.Alpha = setInfo.NewValue.FeaturedInSpotlight ? 1 : 0;
-                    featuredArtistPill.Alpha = setInfo.NewValue.TrackId != null ? 1 : 0;
+                    explicitContent.Alpha = setInfo.NewValue.HasExplicitContent ? 1 : 0;
+                    spotlight.Alpha = setInfo.NewValue.FeaturedInSpotlight ? 1 : 0;
+                    featuredArtist.Alpha = setInfo.NewValue.TrackId != null ? 1 : 0;
 
                     onlineStatusPill.FadeIn(500, Easing.OutQuint);
                     onlineStatusPill.Status = setInfo.NewValue.Status;
diff --git a/osu.Game/Overlays/BeatmapSet/ExplicitContentBeatmapPill.cs b/osu.Game/Overlays/BeatmapSet/ExplicitContentBeatmapBadge.cs
similarity index 88%
rename from osu.Game/Overlays/BeatmapSet/ExplicitContentBeatmapPill.cs
rename to osu.Game/Overlays/BeatmapSet/ExplicitContentBeatmapBadge.cs
index f8530f3a16..b78b203a21 100644
--- a/osu.Game/Overlays/BeatmapSet/ExplicitContentBeatmapPill.cs
+++ b/osu.Game/Overlays/BeatmapSet/ExplicitContentBeatmapBadge.cs
@@ -9,7 +9,7 @@ using osu.Game.Resources.Localisation.Web;
 
 namespace osu.Game.Overlays.BeatmapSet
 {
-    public class ExplicitContentBeatmapPill : BeatmapBadgePill
+    public class ExplicitContentBeatmapBadge : BeatmapBadge
     {
         public override LocalisableString BadgeText => BeatmapsetsStrings.NsfwBadgeLabel;
         public override Colour4 BadgeColour => Colours.Orange2;
diff --git a/osu.Game/Overlays/BeatmapSet/FeaturedArtistBeatmapPill.cs b/osu.Game/Overlays/BeatmapSet/FeaturedArtistBeatmapBadge.cs
similarity index 88%
rename from osu.Game/Overlays/BeatmapSet/FeaturedArtistBeatmapPill.cs
rename to osu.Game/Overlays/BeatmapSet/FeaturedArtistBeatmapBadge.cs
index 4c29ede12e..b471911217 100644
--- a/osu.Game/Overlays/BeatmapSet/FeaturedArtistBeatmapPill.cs
+++ b/osu.Game/Overlays/BeatmapSet/FeaturedArtistBeatmapBadge.cs
@@ -9,7 +9,7 @@ using osu.Game.Resources.Localisation.Web;
 
 namespace osu.Game.Overlays.BeatmapSet
 {
-    public class FeaturedArtistBeatmapPill : BeatmapBadgePill
+    public class FeaturedArtistBeatmapBadge : BeatmapBadge
     {
         public override LocalisableString BadgeText => BeatmapsetsStrings.FeaturedArtistBadgeLabel;
         public override Colour4 BadgeColour => Colours.Blue1;
diff --git a/osu.Game/Overlays/BeatmapSet/SpotlightBeatmapPill.cs b/osu.Game/Overlays/BeatmapSet/SpotlightBeatmapBadge.cs
similarity index 89%
rename from osu.Game/Overlays/BeatmapSet/SpotlightBeatmapPill.cs
rename to osu.Game/Overlays/BeatmapSet/SpotlightBeatmapBadge.cs
index 7376889d7b..caa2043474 100644
--- a/osu.Game/Overlays/BeatmapSet/SpotlightBeatmapPill.cs
+++ b/osu.Game/Overlays/BeatmapSet/SpotlightBeatmapBadge.cs
@@ -9,7 +9,7 @@ using osu.Game.Resources.Localisation.Web;
 
 namespace osu.Game.Overlays.BeatmapSet
 {
-    public class SpotlightBeatmapPill : BeatmapBadgePill
+    public class SpotlightBeatmapBadge : BeatmapBadge
     {
         public override LocalisableString BadgeText => BeatmapsetsStrings.SpotlightBadgeLabel;
         public override Colour4 BadgeColour => Colours.Pink1;
diff --git a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
index 2618e15d31..39853a5c45 100644
--- a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
+++ b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
@@ -78,7 +78,7 @@ namespace osu.Game.Screens.OnlinePlay
         private Container difficultyIconContainer;
         private LinkFlowContainer beatmapText;
         private LinkFlowContainer authorText;
-        private ExplicitContentBeatmapPill explicitContentPill;
+        private ExplicitContentBeatmapBadge explicitContent;
         private ModDisplay modDisplay;
         private FillFlowContainer buttonsFlow;
         private UpdateableAvatar ownerAvatar;
@@ -293,7 +293,7 @@ namespace osu.Game.Screens.OnlinePlay
             }
 
             bool hasExplicitContent = (beatmap?.BeatmapSet as IBeatmapSetOnlineInfo)?.HasExplicitContent == true;
-            explicitContentPill.Alpha = hasExplicitContent ? 1 : 0;
+            explicitContent.Alpha = hasExplicitContent ? 1 : 0;
 
             modDisplay.Current.Value = requiredMods.ToArray();
 
@@ -380,7 +380,7 @@ namespace osu.Game.Screens.OnlinePlay
                                                     Children = new Drawable[]
                                                     {
                                                         authorText = new LinkFlowContainer(fontParameters) { AutoSizeAxes = Axes.Both },
-                                                        explicitContentPill = new ExplicitContentBeatmapPill
+                                                        explicitContent = new ExplicitContentBeatmapBadge
                                                         {
                                                             Alpha = 0f,
                                                             Anchor = Anchor.CentreLeft,

From 441957e18ee58e4c256002d593b583439921b6cc Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sat, 14 May 2022 21:01:29 +0300
Subject: [PATCH 4838/5547] Convert get-only virtual properties to avoid DI
 order dependency

---
 osu.Game/Overlays/BeatmapSet/BeatmapBadge.cs  | 26 +++++++++----------
 .../BeatmapSet/ExplicitContentBeatmapBadge.cs | 12 ++++++---
 .../BeatmapSet/FeaturedArtistBeatmapBadge.cs  | 12 ++++++---
 .../BeatmapSet/SpotlightBeatmapBadge.cs       | 12 ++++++---
 4 files changed, 37 insertions(+), 25 deletions(-)

diff --git a/osu.Game/Overlays/BeatmapSet/BeatmapBadge.cs b/osu.Game/Overlays/BeatmapSet/BeatmapBadge.cs
index 6a444cc85f..2604a58a2b 100644
--- a/osu.Game/Overlays/BeatmapSet/BeatmapBadge.cs
+++ b/osu.Game/Overlays/BeatmapSet/BeatmapBadge.cs
@@ -16,21 +16,23 @@ namespace osu.Game.Overlays.BeatmapSet
 {
     public abstract class BeatmapBadge : CompositeDrawable
     {
-        [Resolved]
-        protected OsuColour Colours { get; private set; } = null!;
-
-        [Resolved(canBeNull: true)]
-        protected OverlayColourProvider? ColourProvider { get; private set; }
-
         /// <summary>
         /// The text displayed on the badge's label.
         /// </summary>
-        public abstract LocalisableString BadgeText { get; }
+        public LocalisableString BadgeText
+        {
+            set => badgeLabel.Text = value.ToUpper();
+        }
 
         /// <summary>
         /// The colour of the badge's label.
         /// </summary>
-        public abstract Colour4 BadgeColour { get; }
+        public Colour4 BadgeColour
+        {
+            set => badgeLabel.Colour = value;
+        }
+
+        private OsuSpriteText badgeLabel = null!;
 
         // todo: add linking support, to allow redirecting featured artist badge to corresponding track and spotlight badge to wiki page.
 
@@ -40,7 +42,7 @@ namespace osu.Game.Overlays.BeatmapSet
         }
 
         [BackgroundDependencyLoader(true)]
-        private void load()
+        private void load(OsuColour colours, OverlayColourProvider? colourProvider)
         {
             InternalChild = new CircularContainer
             {
@@ -51,14 +53,12 @@ namespace osu.Game.Overlays.BeatmapSet
                     new Box
                     {
                         RelativeSizeAxes = Axes.Both,
-                        Colour = ColourProvider?.Background5 ?? Colours.Gray2,
+                        Colour = colourProvider?.Background5 ?? colours.Gray2,
                     },
-                    new OsuSpriteText
+                    badgeLabel = new OsuSpriteText
                     {
                         Font = OsuFont.GetFont(size: 10, weight: FontWeight.SemiBold),
                         Margin = new MarginPadding { Horizontal = 10, Vertical = 2 },
-                        Text = BadgeText.ToUpper(),
-                        Colour = BadgeColour,
                     }
                 }
             };
diff --git a/osu.Game/Overlays/BeatmapSet/ExplicitContentBeatmapBadge.cs b/osu.Game/Overlays/BeatmapSet/ExplicitContentBeatmapBadge.cs
index b78b203a21..2a20d22b61 100644
--- a/osu.Game/Overlays/BeatmapSet/ExplicitContentBeatmapBadge.cs
+++ b/osu.Game/Overlays/BeatmapSet/ExplicitContentBeatmapBadge.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 osu.Framework.Graphics;
-using osu.Framework.Localisation;
+using osu.Framework.Allocation;
+using osu.Game.Graphics;
 using osu.Game.Resources.Localisation.Web;
 
 #nullable enable
@@ -11,7 +11,11 @@ namespace osu.Game.Overlays.BeatmapSet
 {
     public class ExplicitContentBeatmapBadge : BeatmapBadge
     {
-        public override LocalisableString BadgeText => BeatmapsetsStrings.NsfwBadgeLabel;
-        public override Colour4 BadgeColour => Colours.Orange2;
+        [BackgroundDependencyLoader]
+        private void load(OsuColour colours)
+        {
+            BadgeText = BeatmapsetsStrings.NsfwBadgeLabel;
+            BadgeColour = colours.Orange2;
+        }
     }
 }
diff --git a/osu.Game/Overlays/BeatmapSet/FeaturedArtistBeatmapBadge.cs b/osu.Game/Overlays/BeatmapSet/FeaturedArtistBeatmapBadge.cs
index b471911217..230b8b5243 100644
--- a/osu.Game/Overlays/BeatmapSet/FeaturedArtistBeatmapBadge.cs
+++ b/osu.Game/Overlays/BeatmapSet/FeaturedArtistBeatmapBadge.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 osu.Framework.Graphics;
-using osu.Framework.Localisation;
+using osu.Framework.Allocation;
+using osu.Game.Graphics;
 using osu.Game.Resources.Localisation.Web;
 
 #nullable enable
@@ -11,7 +11,11 @@ namespace osu.Game.Overlays.BeatmapSet
 {
     public class FeaturedArtistBeatmapBadge : BeatmapBadge
     {
-        public override LocalisableString BadgeText => BeatmapsetsStrings.FeaturedArtistBadgeLabel;
-        public override Colour4 BadgeColour => Colours.Blue1;
+        [BackgroundDependencyLoader]
+        private void load(OsuColour colours)
+        {
+            BadgeText = BeatmapsetsStrings.FeaturedArtistBadgeLabel;
+            BadgeColour = colours.Blue1;
+        }
     }
 }
diff --git a/osu.Game/Overlays/BeatmapSet/SpotlightBeatmapBadge.cs b/osu.Game/Overlays/BeatmapSet/SpotlightBeatmapBadge.cs
index caa2043474..8bfd623b2e 100644
--- a/osu.Game/Overlays/BeatmapSet/SpotlightBeatmapBadge.cs
+++ b/osu.Game/Overlays/BeatmapSet/SpotlightBeatmapBadge.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 osu.Framework.Graphics;
-using osu.Framework.Localisation;
+using osu.Framework.Allocation;
+using osu.Game.Graphics;
 using osu.Game.Resources.Localisation.Web;
 
 #nullable enable
@@ -11,7 +11,11 @@ namespace osu.Game.Overlays.BeatmapSet
 {
     public class SpotlightBeatmapBadge : BeatmapBadge
     {
-        public override LocalisableString BadgeText => BeatmapsetsStrings.SpotlightBadgeLabel;
-        public override Colour4 BadgeColour => Colours.Pink1;
+        [BackgroundDependencyLoader]
+        private void load(OsuColour colours)
+        {
+            BadgeText = BeatmapsetsStrings.SpotlightBadgeLabel;
+            BadgeColour = colours.Pink1;
+        }
     }
 }

From 1878578196e157bfb755318d39db742f5e5b74b0 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sat, 14 May 2022 21:02:56 +0300
Subject: [PATCH 4839/5547] Move todo comment to subclasses

---
 osu.Game/Overlays/BeatmapSet/BeatmapBadge.cs               | 2 --
 osu.Game/Overlays/BeatmapSet/FeaturedArtistBeatmapBadge.cs | 1 +
 osu.Game/Overlays/BeatmapSet/SpotlightBeatmapBadge.cs      | 1 +
 3 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Overlays/BeatmapSet/BeatmapBadge.cs b/osu.Game/Overlays/BeatmapSet/BeatmapBadge.cs
index 2604a58a2b..d19aff3a69 100644
--- a/osu.Game/Overlays/BeatmapSet/BeatmapBadge.cs
+++ b/osu.Game/Overlays/BeatmapSet/BeatmapBadge.cs
@@ -34,8 +34,6 @@ namespace osu.Game.Overlays.BeatmapSet
 
         private OsuSpriteText badgeLabel = null!;
 
-        // todo: add linking support, to allow redirecting featured artist badge to corresponding track and spotlight badge to wiki page.
-
         protected BeatmapBadge()
         {
             AutoSizeAxes = Axes.Both;
diff --git a/osu.Game/Overlays/BeatmapSet/FeaturedArtistBeatmapBadge.cs b/osu.Game/Overlays/BeatmapSet/FeaturedArtistBeatmapBadge.cs
index 230b8b5243..4f336d85fc 100644
--- a/osu.Game/Overlays/BeatmapSet/FeaturedArtistBeatmapBadge.cs
+++ b/osu.Game/Overlays/BeatmapSet/FeaturedArtistBeatmapBadge.cs
@@ -16,6 +16,7 @@ namespace osu.Game.Overlays.BeatmapSet
         {
             BadgeText = BeatmapsetsStrings.FeaturedArtistBadgeLabel;
             BadgeColour = colours.Blue1;
+            // todo: add linking support to allow redirecting featured artist badge to corresponding track.
         }
     }
 }
diff --git a/osu.Game/Overlays/BeatmapSet/SpotlightBeatmapBadge.cs b/osu.Game/Overlays/BeatmapSet/SpotlightBeatmapBadge.cs
index 8bfd623b2e..3204f79b21 100644
--- a/osu.Game/Overlays/BeatmapSet/SpotlightBeatmapBadge.cs
+++ b/osu.Game/Overlays/BeatmapSet/SpotlightBeatmapBadge.cs
@@ -16,6 +16,7 @@ namespace osu.Game.Overlays.BeatmapSet
         {
             BadgeText = BeatmapsetsStrings.SpotlightBadgeLabel;
             BadgeColour = colours.Pink1;
+            // todo: add linking support to allow redirecting spotlight badge to https://osu.ppy.sh/wiki/en/Beatmap_Spotlights.
         }
     }
 }

From 282c8aec867ad5adb889bd4b7f7bb488051b8098 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 15 May 2022 03:09:15 +0900
Subject: [PATCH 4840/5547] Fix typo in test step
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>
---
 .../Visual/UserInterface/TestSceneModSelectOverlay.cs           | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectOverlay.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectOverlay.cs
index e946524a4b..2cc9a451a8 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectOverlay.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectOverlay.cs
@@ -425,7 +425,7 @@ namespace osu.Game.Tests.Visual.UserInterface
             AddStep("select DT + HD", () => SelectedMods.Value = new Mod[] { new OsuModDoubleTime(), new OsuModHidden() });
             AddAssert("DT + HD selected", () => modSelectOverlay.ChildrenOfType<ModPanel>().Count(panel => panel.Active.Value) == 2);
 
-            AddStep("press bakcspace", () =>
+            AddStep("press backspace", () =>
             {
                 InputManager.Key(Key.BackSpace);
             });

From 8a01050168038c41c6f8fc33d77848b91b85ccbb Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 15 May 2022 03:16:33 +0900
Subject: [PATCH 4841/5547] Refactor mod select button initialisation to allow
 shared usage of deselect button

---
 osu.Game/Overlays/Mods/ModSelectOverlay.cs    | 43 +++++++++++--------
 .../OnlinePlay/FreeModSelectOverlay.cs        | 16 +++----
 2 files changed, 30 insertions(+), 29 deletions(-)

diff --git a/osu.Game/Overlays/Mods/ModSelectOverlay.cs b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
index fb988b5bfe..1dad185b78 100644
--- a/osu.Game/Overlays/Mods/ModSelectOverlay.cs
+++ b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
@@ -56,11 +56,32 @@ namespace osu.Game.Overlays.Mods
         /// </summary>
         protected virtual bool ShowTotalMultiplier => true;
 
+        /// <summary>
+        /// Whether per-mod customisation controls are visible.
+        /// </summary>
+        protected virtual bool AllowCustomisation => true;
+
         protected virtual ModColumn CreateModColumn(ModType modType, Key[]? toggleKeys = null) => new ModColumn(modType, false, toggleKeys);
 
         protected virtual IReadOnlyList<Mod> ComputeNewModsFromSelection(IReadOnlyList<Mod> oldSelection, IReadOnlyList<Mod> newSelection) => newSelection;
 
-        protected virtual IEnumerable<ShearedButton> CreateFooterButtons() => createDefaultFooterButtons();
+        protected virtual IEnumerable<ShearedButton> CreateFooterButtons()
+        {
+            if (AllowCustomisation)
+            {
+                yield return customisationButton = new ShearedToggleButton(BUTTON_WIDTH)
+                {
+                    Text = ModSelectOverlayStrings.ModCustomisation,
+                    Active = { BindTarget = customisationVisible }
+                };
+            }
+
+            yield return deselectAllButton = new ShearedButton(BUTTON_WIDTH)
+            {
+                Text = CommonStrings.DeselectAll,
+                Action = DeselectAll
+            };
+        }
 
         private readonly Bindable<Dictionary<ModType, IReadOnlyList<Mod>>> availableMods = new Bindable<Dictionary<ModType, IReadOnlyList<Mod>>>();
         private readonly Dictionary<ModType, IReadOnlyList<ModState>> localAvailableMods = new Dictionary<ModType, IReadOnlyList<ModState>>();
@@ -77,6 +98,7 @@ namespace osu.Game.Overlays.Mods
         private DifficultyMultiplierDisplay? multiplierDisplay;
 
         private ShearedToggleButton? customisationButton;
+        private ShearedButton? deselectAllButton;
 
         protected ModSelectOverlay(OverlayColourScheme colourScheme = OverlayColourScheme.Green)
             : base(colourScheme)
@@ -201,7 +223,7 @@ namespace osu.Game.Overlays.Mods
 
             // This is an optimisation to prevent refreshing the available settings controls when it can be
             // reasonably assumed that the settings panel is never to be displayed (e.g. FreeModSelectOverlay).
-            if (customisationButton != null)
+            if (AllowCustomisation)
                 ((IBindable<IReadOnlyList<Mod>>)modSettingsArea.SelectedMods).BindTo(SelectedMods);
 
             SelectedMods.BindValueChanged(val =>
@@ -256,21 +278,6 @@ namespace osu.Game.Overlays.Mods
             };
         }
 
-        private ShearedButton[] createDefaultFooterButtons()
-            => new[]
-            {
-                customisationButton = new ShearedToggleButton(BUTTON_WIDTH)
-                {
-                    Text = ModSelectOverlayStrings.ModCustomisation,
-                    Active = { BindTarget = customisationVisible }
-                },
-                new ShearedButton(BUTTON_WIDTH)
-                {
-                    Text = CommonStrings.DeselectAll,
-                    Action = DeselectAll
-                }
-            };
-
         private void createLocalMods()
         {
             localAvailableMods.Clear();
@@ -510,7 +517,7 @@ namespace osu.Game.Overlays.Mods
                 }
 
                 case GlobalAction.DeselectAllMods:
-                    DeselectAll();
+                    deselectAllButton?.TriggerClick();
                     return true;
             }
 
diff --git a/osu.Game/Screens/OnlinePlay/FreeModSelectOverlay.cs b/osu.Game/Screens/OnlinePlay/FreeModSelectOverlay.cs
index 6e1c9b7a59..790333ea5b 100644
--- a/osu.Game/Screens/OnlinePlay/FreeModSelectOverlay.cs
+++ b/osu.Game/Screens/OnlinePlay/FreeModSelectOverlay.cs
@@ -4,6 +4,7 @@
 using System;
 using osu.Game.Overlays;
 using System.Collections.Generic;
+using System.Linq;
 using osu.Framework.Graphics;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Overlays.Mods;
@@ -17,6 +18,8 @@ namespace osu.Game.Screens.OnlinePlay
     {
         protected override bool ShowTotalMultiplier => false;
 
+        protected override bool AllowCustomisation => false;
+
         public new Func<Mod, bool> IsValidMod
         {
             get => base.IsValidMod;
@@ -31,22 +34,13 @@ namespace osu.Game.Screens.OnlinePlay
 
         protected override ModColumn CreateModColumn(ModType modType, Key[] toggleKeys = null) => new ModColumn(modType, true, toggleKeys);
 
-        protected override IEnumerable<ShearedButton> CreateFooterButtons() => new[]
-        {
+        protected override IEnumerable<ShearedButton> CreateFooterButtons() => base.CreateFooterButtons().Prepend(
             new ShearedButton(BUTTON_WIDTH)
             {
                 Anchor = Anchor.BottomLeft,
                 Origin = Anchor.BottomLeft,
                 Text = CommonStrings.SelectAll,
                 Action = SelectAll
-            },
-            new ShearedButton(BUTTON_WIDTH)
-            {
-                Anchor = Anchor.BottomLeft,
-                Origin = Anchor.BottomLeft,
-                Text = CommonStrings.DeselectAll,
-                Action = DeselectAll
-            }
-        };
+            });
     }
 }

From b6575c216b8945bceee462216d87b4ac79d7e0a4 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 15 May 2022 03:18:44 +0900
Subject: [PATCH 4842/5547] Allow selecting all mods at free mod select using
 `ctrl`+`a`

---
 .../TestSceneFreeModSelectOverlay.cs          | 13 +++++++++
 .../TestSceneModSelectOverlay.cs              |  5 +---
 .../OnlinePlay/FreeModSelectOverlay.cs        | 28 +++++++++++++++++--
 3 files changed, 40 insertions(+), 6 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneFreeModSelectOverlay.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneFreeModSelectOverlay.cs
index f40c31b07f..c37bff2066 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneFreeModSelectOverlay.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneFreeModSelectOverlay.cs
@@ -7,6 +7,7 @@ using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics.Containers;
+using osu.Framework.Input;
 using osu.Framework.Testing;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Overlays.Mods;
@@ -55,6 +56,18 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddAssert("customisation area not expanded", () => this.ChildrenOfType<ModSettingsArea>().Single().Height == 0);
         }
 
+        [Test]
+        public void TestSelectDeselectAllViaKeyboard()
+        {
+            createFreeModSelect();
+
+            AddStep("press ctrl+a", () => InputManager.Keys(PlatformAction.SelectAll));
+            AddUntilStep("all mods selected", assertAllAvailableModsSelected);
+
+            AddStep("press backspace", () => InputManager.Key(Key.BackSpace));
+            AddUntilStep("all mods deselected", () => !freeModSelectOverlay.SelectedMods.Value.Any());
+        }
+
         [Test]
         public void TestSelectDeselectAll()
         {
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectOverlay.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectOverlay.cs
index 2cc9a451a8..75e30f76c3 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectOverlay.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectOverlay.cs
@@ -425,10 +425,7 @@ namespace osu.Game.Tests.Visual.UserInterface
             AddStep("select DT + HD", () => SelectedMods.Value = new Mod[] { new OsuModDoubleTime(), new OsuModHidden() });
             AddAssert("DT + HD selected", () => modSelectOverlay.ChildrenOfType<ModPanel>().Count(panel => panel.Active.Value) == 2);
 
-            AddStep("press backspace", () =>
-            {
-                InputManager.Key(Key.BackSpace);
-            });
+            AddStep("press backspace", () => InputManager.Key(Key.BackSpace));
             AddUntilStep("all mods deselected", () => !SelectedMods.Value.Any());
         }
 
diff --git a/osu.Game/Screens/OnlinePlay/FreeModSelectOverlay.cs b/osu.Game/Screens/OnlinePlay/FreeModSelectOverlay.cs
index 790333ea5b..f494f9799a 100644
--- a/osu.Game/Screens/OnlinePlay/FreeModSelectOverlay.cs
+++ b/osu.Game/Screens/OnlinePlay/FreeModSelectOverlay.cs
@@ -6,6 +6,9 @@ using osu.Game.Overlays;
 using System.Collections.Generic;
 using System.Linq;
 using osu.Framework.Graphics;
+using osu.Framework.Input;
+using osu.Framework.Input.Bindings;
+using osu.Framework.Input.Events;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Overlays.Mods;
 using osu.Game.Rulesets.Mods;
@@ -14,7 +17,7 @@ using osu.Game.Localisation;
 
 namespace osu.Game.Screens.OnlinePlay
 {
-    public class FreeModSelectOverlay : ModSelectOverlay
+    public class FreeModSelectOverlay : ModSelectOverlay, IKeyBindingHandler<PlatformAction>
     {
         protected override bool ShowTotalMultiplier => false;
 
@@ -26,6 +29,8 @@ namespace osu.Game.Screens.OnlinePlay
             set => base.IsValidMod = m => m.UserPlayable && value.Invoke(m);
         }
 
+        private ShearedButton selectAllButton;
+
         public FreeModSelectOverlay()
             : base(OverlayColourScheme.Plum)
         {
@@ -35,12 +40,31 @@ namespace osu.Game.Screens.OnlinePlay
         protected override ModColumn CreateModColumn(ModType modType, Key[] toggleKeys = null) => new ModColumn(modType, true, toggleKeys);
 
         protected override IEnumerable<ShearedButton> CreateFooterButtons() => base.CreateFooterButtons().Prepend(
-            new ShearedButton(BUTTON_WIDTH)
+            selectAllButton = new ShearedButton(BUTTON_WIDTH)
             {
                 Anchor = Anchor.BottomLeft,
                 Origin = Anchor.BottomLeft,
                 Text = CommonStrings.SelectAll,
                 Action = SelectAll
             });
+
+        public bool OnPressed(KeyBindingPressEvent<PlatformAction> e)
+        {
+            if (e.Repeat)
+                return false;
+
+            switch (e.Action)
+            {
+                case PlatformAction.SelectAll:
+                    selectAllButton.TriggerClick();
+                    return true;
+            }
+
+            return false;
+        }
+
+        public void OnReleased(KeyBindingReleaseEvent<PlatformAction> e)
+        {
+        }
     }
 }

From 4bb06873d53d4459268e13305788cb9996d373ec Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sat, 14 May 2022 21:54:52 +0300
Subject: [PATCH 4843/5547] Move badge hierarchy declaration to constructor for
 safer access

---
 osu.Game/Overlays/BeatmapSet/BeatmapBadge.cs | 16 +++++++++-------
 1 file changed, 9 insertions(+), 7 deletions(-)

diff --git a/osu.Game/Overlays/BeatmapSet/BeatmapBadge.cs b/osu.Game/Overlays/BeatmapSet/BeatmapBadge.cs
index d19aff3a69..a75fc8e888 100644
--- a/osu.Game/Overlays/BeatmapSet/BeatmapBadge.cs
+++ b/osu.Game/Overlays/BeatmapSet/BeatmapBadge.cs
@@ -32,26 +32,22 @@ namespace osu.Game.Overlays.BeatmapSet
             set => badgeLabel.Colour = value;
         }
 
-        private OsuSpriteText badgeLabel = null!;
+        private readonly Box background;
+        private readonly OsuSpriteText badgeLabel;
 
         protected BeatmapBadge()
         {
             AutoSizeAxes = Axes.Both;
-        }
 
-        [BackgroundDependencyLoader(true)]
-        private void load(OsuColour colours, OverlayColourProvider? colourProvider)
-        {
             InternalChild = new CircularContainer
             {
                 Masking = true,
                 AutoSizeAxes = Axes.Both,
                 Children = new Drawable[]
                 {
-                    new Box
+                    background = new Box
                     {
                         RelativeSizeAxes = Axes.Both,
-                        Colour = colourProvider?.Background5 ?? colours.Gray2,
                     },
                     badgeLabel = new OsuSpriteText
                     {
@@ -61,5 +57,11 @@ namespace osu.Game.Overlays.BeatmapSet
                 }
             };
         }
+
+        [BackgroundDependencyLoader(true)]
+        private void load(OsuColour colours, OverlayColourProvider? colourProvider)
+        {
+            background.Colour = colourProvider?.Background5 ?? colours.Gray2;
+        }
     }
 }

From 92ae652555a0ca85941d87d1de040d7427cedf5f Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sat, 14 May 2022 22:07:42 +0300
Subject: [PATCH 4844/5547] Enable indirect input events on iOS for proper
 mouse support

---
 osu.Game.Rulesets.Catch.Tests.iOS/Info.plist | 2 ++
 osu.Game.Rulesets.Mania.Tests.iOS/Info.plist | 2 ++
 osu.Game.Rulesets.Osu.Tests.iOS/Info.plist   | 2 ++
 osu.Game.Rulesets.Taiko.Tests.iOS/Info.plist | 2 ++
 osu.Game.Tests.iOS/Info.plist                | 2 ++
 osu.iOS/Info.plist                           | 2 ++
 6 files changed, 12 insertions(+)

diff --git a/osu.Game.Rulesets.Catch.Tests.iOS/Info.plist b/osu.Game.Rulesets.Catch.Tests.iOS/Info.plist
index 33ddac6dfb..16a2b99997 100644
--- a/osu.Game.Rulesets.Catch.Tests.iOS/Info.plist
+++ b/osu.Game.Rulesets.Catch.Tests.iOS/Info.plist
@@ -37,6 +37,8 @@
 	</array>
 	<key>XSAppIconAssets</key>
 	<string>Assets.xcassets/AppIcon.appiconset</string>
+	<key>UIApplicationSupportsIndirectInputEvents</key>
+	<true/>
 	<key>CADisableMinimumFrameDurationOnPhone</key>
 	<true/>
 </dict>
diff --git a/osu.Game.Rulesets.Mania.Tests.iOS/Info.plist b/osu.Game.Rulesets.Mania.Tests.iOS/Info.plist
index 78349334b4..82d1c8ea24 100644
--- a/osu.Game.Rulesets.Mania.Tests.iOS/Info.plist
+++ b/osu.Game.Rulesets.Mania.Tests.iOS/Info.plist
@@ -37,6 +37,8 @@
 	</array>
 	<key>XSAppIconAssets</key>
 	<string>Assets.xcassets/AppIcon.appiconset</string>
+	<key>UIApplicationSupportsIndirectInputEvents</key>
+	<true/>
 	<key>CADisableMinimumFrameDurationOnPhone</key>
 	<true/>
 </dict>
diff --git a/osu.Game.Rulesets.Osu.Tests.iOS/Info.plist b/osu.Game.Rulesets.Osu.Tests.iOS/Info.plist
index b9f371c049..a88b74695c 100644
--- a/osu.Game.Rulesets.Osu.Tests.iOS/Info.plist
+++ b/osu.Game.Rulesets.Osu.Tests.iOS/Info.plist
@@ -37,6 +37,8 @@
 	</array>
 	<key>XSAppIconAssets</key>
 	<string>Assets.xcassets/AppIcon.appiconset</string>
+	<key>UIApplicationSupportsIndirectInputEvents</key>
+	<true/>
 	<key>CADisableMinimumFrameDurationOnPhone</key>
 	<true/>
 </dict>
diff --git a/osu.Game.Rulesets.Taiko.Tests.iOS/Info.plist b/osu.Game.Rulesets.Taiko.Tests.iOS/Info.plist
index 65c47d2115..9628475b3e 100644
--- a/osu.Game.Rulesets.Taiko.Tests.iOS/Info.plist
+++ b/osu.Game.Rulesets.Taiko.Tests.iOS/Info.plist
@@ -37,6 +37,8 @@
 	</array>
 	<key>XSAppIconAssets</key>
 	<string>Assets.xcassets/AppIcon.appiconset</string>
+	<key>UIApplicationSupportsIndirectInputEvents</key>
+	<true/>
 	<key>CADisableMinimumFrameDurationOnPhone</key>
 	<true/>
 </dict>
diff --git a/osu.Game.Tests.iOS/Info.plist b/osu.Game.Tests.iOS/Info.plist
index ed0c2e4dbf..31e2b3f257 100644
--- a/osu.Game.Tests.iOS/Info.plist
+++ b/osu.Game.Tests.iOS/Info.plist
@@ -37,6 +37,8 @@
 	</array>
 	<key>XSAppIconAssets</key>
 	<string>Assets.xcassets/AppIcon.appiconset</string>
+	<key>UIApplicationSupportsIndirectInputEvents</key>
+	<true/>
 	<key>CADisableMinimumFrameDurationOnPhone</key>
 	<true/>
 </dict>
diff --git a/osu.iOS/Info.plist b/osu.iOS/Info.plist
index 02968b87a7..16cb68fa7d 100644
--- a/osu.iOS/Info.plist
+++ b/osu.iOS/Info.plist
@@ -33,6 +33,8 @@
 	<true/>
 	<key>UIStatusBarHidden</key>
 	<true/>
+	<key>UIApplicationSupportsIndirectInputEvents</key>
+	<true/>
 	<key>CADisableMinimumFrameDurationOnPhone</key>
 	<true/>
 	<key>NSCameraUsageDescription</key>

From 170df01b4615b2aa73d6ec67c61b4e7b1101654b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 15 May 2022 20:10:53 +0200
Subject: [PATCH 4845/5547] Adjust difficulty multiplier scale transition on
 mod overlay

The previous transition was supposed to be a center-anchored elastic
scale-in, but this didn't work as intended - because the multiplier
ended up inside of an auto-sized right-aligned container, the animation
itself would end up being anchored right.

Attempts to remove the scale transition resulted in a rather
jarring-looking result, so swap out the elastic scale-in for a sweep-in
effect from the top, to match the header and avoid introducing too many
directions of movement.

Delay values tweaked "to taste" - can be adjusted further if there is an
alternative set of values that feels better.
---
 osu.Game/Overlays/Mods/ModSelectOverlay.cs | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Overlays/Mods/ModSelectOverlay.cs b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
index 1dad185b78..8d72855217 100644
--- a/osu.Game/Overlays/Mods/ModSelectOverlay.cs
+++ b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
@@ -428,9 +428,9 @@ namespace osu.Game.Overlays.Mods
             base.PopIn();
 
             multiplierDisplay?
-                .Delay(fade_in_duration * 0.65f)
-                .FadeIn(fade_in_duration / 2, Easing.OutQuint)
-                .ScaleTo(1, fade_in_duration, Easing.OutElastic);
+                .Delay(fade_in_duration / 5)
+                .FadeIn(fade_in_duration, Easing.OutQuint)
+                .MoveToY(0, fade_in_duration, Easing.OutQuint);
 
             int nonFilteredColumnCount = 0;
 
@@ -465,7 +465,7 @@ namespace osu.Game.Overlays.Mods
 
             multiplierDisplay?
                 .FadeOut(fade_out_duration / 2, Easing.OutQuint)
-                .ScaleTo(0.75f, fade_out_duration, Easing.OutQuint);
+                .MoveToY(-distance, fade_out_duration / 2, Easing.OutQuint);
 
             int nonFilteredColumnCount = 0;
 

From ae5b6c3e1068a130396c3a2f8fab554c362603c5 Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Sun, 15 May 2022 19:38:37 +0100
Subject: [PATCH 4846/5547] Use dummy channel to show selector and remove
 `ChannelListSelector`

Add dummy channel `DummySelectorChannel` which should be set as the
current channel in the channel manager when the selector in the chat
overlay should be shown.

Refactors the `ChannelListItem` to not show mention pill and close
button when the channel is the dummy selector channel.

Ensure that the `ChannelList` selects the dummy channel on clicking the
selector item.

Removes `ChannelListSelector` as it is no longer needed.

Removes the `setCurrent` parameter from `ChannelManager.JoinChannel`
method as it is no longer needed.
---
 .../Visual/Online/TestSceneChannelList.cs     |  12 +-
 .../Visual/Online/TestSceneChatOverlayV2.cs   |   5 +-
 osu.Game/Online/Chat/ChannelManager.cs        |  18 +--
 .../Overlays/Chat/ChannelList/ChannelList.cs  |  10 +-
 .../Chat/ChannelList/ChannelListItem.cs       |  60 +++++++---
 .../Chat/ChannelList/ChannelListSelector.cs   | 103 ------------------
 osu.Game/Overlays/ChatOverlayV2.cs            |  13 ++-
 7 files changed, 80 insertions(+), 141 deletions(-)
 delete mode 100644 osu.Game/Overlays/Chat/ChannelList/ChannelListSelector.cs

diff --git a/osu.Game.Tests/Visual/Online/TestSceneChannelList.cs b/osu.Game.Tests/Visual/Online/TestSceneChannelList.cs
index 9929642539..53a48fcc58 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneChannelList.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneChannelList.cs
@@ -118,35 +118,37 @@ namespace osu.Game.Tests.Visual.Online
         {
             AddStep("Unread Selected", () =>
             {
-                if (selected.Value != null)
+                if (validItem)
                     channelList.GetItem(selected.Value).Unread.Value = true;
             });
 
             AddStep("Read Selected", () =>
             {
-                if (selected.Value != null)
+                if (validItem)
                     channelList.GetItem(selected.Value).Unread.Value = false;
             });
 
             AddStep("Add Mention Selected", () =>
             {
-                if (selected.Value != null)
+                if (validItem)
                     channelList.GetItem(selected.Value).Mentions.Value++;
             });
 
             AddStep("Add 98 Mentions Selected", () =>
             {
-                if (selected.Value != null)
+                if (validItem)
                     channelList.GetItem(selected.Value).Mentions.Value += 98;
             });
 
             AddStep("Clear Mentions Selected", () =>
             {
-                if (selected.Value != null)
+                if (validItem)
                     channelList.GetItem(selected.Value).Mentions.Value = 0;
             });
         }
 
+        private bool validItem => selected.Value != null && !(selected.Value is DummySelectorChannel);
+
         private Channel createRandomPublicChannel()
         {
             int id = RNG.Next(0, 10000);
diff --git a/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs b/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs
index bf1767cc96..48557a4ddb 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs
@@ -372,7 +372,7 @@ namespace osu.Game.Tests.Visual.Online
             AddStep("Join channel 1", () => channelManager.JoinChannel(testChannel1));
             AddStep("Select channel 1", () => clickDrawable(getChannelListItem(testChannel1)));
             AddAssert("TextBox is focused", () => InputManager.FocusedDrawable == chatOverlayTextBox);
-            AddStep("Click selector", () => clickDrawable(chatOverlay.ChildrenOfType<ChannelListSelector>().Single()));
+            AddStep("Click selector", () => clickDrawable(channelSelectorButton));
             AddAssert("TextBox is focused", () => InputManager.FocusedDrawable == chatOverlayTextBox);
             AddStep("Click listing", () => clickDrawable(chatOverlay.ChildrenOfType<ChannelListing>().Single()));
             AddAssert("TextBox is focused", () => InputManager.FocusedDrawable == chatOverlayTextBox);
@@ -407,6 +407,9 @@ namespace osu.Game.Tests.Visual.Online
         private ChatOverlayTopBar chatOverlayTopBar =>
             chatOverlay.ChildrenOfType<ChatOverlayTopBar>().Single();
 
+        private ChannelListItem channelSelectorButton =>
+            chatOverlay.ChildrenOfType<ChannelListItem>().Single(item => item.Channel is DummySelectorChannel);
+
         private void clickDrawable(Drawable d)
         {
             InputManager.MoveMouseTo(d);
diff --git a/osu.Game/Online/Chat/ChannelManager.cs b/osu.Game/Online/Chat/ChannelManager.cs
index 1fe784f68b..9524e8c1a7 100644
--- a/osu.Game/Online/Chat/ChannelManager.cs
+++ b/osu.Game/Online/Chat/ChannelManager.cs
@@ -14,6 +14,7 @@ using osu.Game.Input;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests;
 using osu.Game.Online.API.Requests.Responses;
+using osu.Game.Overlays;
 using osu.Game.Overlays.Chat.Tabs;
 
 namespace osu.Game.Online.Chat
@@ -133,7 +134,9 @@ namespace osu.Game.Online.Chat
 
         private void currentChannelChanged(ValueChangedEvent<Channel> e)
         {
-            if (!(e.NewValue is ChannelSelectorTabItem.ChannelSelectorTabChannel))
+            bool isSelectorChannel = e.NewValue is ChannelSelectorTabItem.ChannelSelectorTabChannel || e.NewValue is DummySelectorChannel;
+
+            if (!isSelectorChannel)
                 JoinChannel(e.NewValue);
         }
 
@@ -194,7 +197,6 @@ namespace osu.Game.Online.Chat
 
                     createNewPrivateMessageRequest.Failure += exception =>
                     {
-                        handlePostException(exception);
                         target.ReplaceMessage(message, null);
                         dequeueAndRun();
                     };
@@ -420,11 +422,10 @@ namespace osu.Game.Online.Chat
         /// Joins a channel if it has not already been joined. Must be called from the update thread.
         /// </summary>
         /// <param name="channel">The channel to join.</param>
-        /// <param name="setCurrent">Set the channel to join as the current channel if the current channel is null.</param>
         /// <returns>The joined channel. Note that this may not match the parameter channel as it is a backed object.</returns>
-        public Channel JoinChannel(Channel channel, bool setCurrent = true) => joinChannel(channel, true, setCurrent);
+        public Channel JoinChannel(Channel channel) => joinChannel(channel, true);
 
-        private Channel joinChannel(Channel channel, bool fetchInitialMessages = false, bool setCurrent = true)
+        private Channel joinChannel(Channel channel, bool fetchInitialMessages = false)
         {
             if (channel == null) return null;
 
@@ -440,7 +441,7 @@ namespace osu.Game.Online.Chat
                     case ChannelType.Multiplayer:
                         // join is implicit. happens when you join a multiplayer game.
                         // this will probably change in the future.
-                        joinChannel(channel, fetchInitialMessages, setCurrent);
+                        joinChannel(channel, fetchInitialMessages);
                         return channel;
 
                     case ChannelType.PM:
@@ -461,7 +462,7 @@ namespace osu.Game.Online.Chat
 
                     default:
                         var req = new JoinChannelRequest(channel);
-                        req.Success += () => joinChannel(channel, fetchInitialMessages, setCurrent);
+                        req.Success += () => joinChannel(channel, fetchInitialMessages);
                         req.Failure += ex => LeaveChannel(channel);
                         api.Queue(req);
                         return channel;
@@ -473,8 +474,7 @@ namespace osu.Game.Online.Chat
                     this.fetchInitialMessages(channel);
             }
 
-            if (setCurrent)
-                CurrentChannel.Value ??= channel;
+            CurrentChannel.Value ??= channel;
 
             return channel;
         }
diff --git a/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs b/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs
index 6bdf5ee084..c9f3a4d380 100644
--- a/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs
+++ b/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs
@@ -18,13 +18,16 @@ namespace osu.Game.Overlays.Chat.ChannelList
 {
     public class ChannelList : Container
     {
-        public Action<Channel?>? OnRequestSelect;
+        public Action<Channel>? OnRequestSelect;
         public Action<Channel>? OnRequestLeave;
 
         private readonly Dictionary<Channel, ChannelListItem> channelMap = new Dictionary<Channel, ChannelListItem>();
 
+        private readonly DummySelectorChannel dummySelectorChannel = new DummySelectorChannel();
+
         private ChannelListItemFlow publicChannelFlow = null!;
         private ChannelListItemFlow privateChannelFlow = null!;
+        private ChannelListItem selector = null!;
 
         [BackgroundDependencyLoader]
         private void load(OverlayColourProvider colourProvider)
@@ -50,16 +53,17 @@ namespace osu.Game.Overlays.Chat.ChannelList
                         Children = new Drawable[]
                         {
                             publicChannelFlow = new ChannelListItemFlow("CHANNELS"),
-                            new ChannelListSelector
+                            selector = new ChannelListItem(dummySelectorChannel)
                             {
                                 Margin = new MarginPadding { Bottom = 10 },
-                                Action = () => OnRequestSelect?.Invoke(null),
                             },
                             privateChannelFlow = new ChannelListItemFlow("DIRECT MESSAGES"),
                         },
                     },
                 },
             };
+
+            selector.OnRequestSelect += chan => OnRequestSelect?.Invoke(chan);
         }
 
         public void AddChannel(Channel channel)
diff --git a/osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs b/osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs
index dd571c9ad9..dfb0b6d781 100644
--- a/osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs
+++ b/osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs
@@ -34,7 +34,7 @@ namespace osu.Game.Overlays.Chat.ChannelList
         private Box hoverBox = null!;
         private Box selectBox = null!;
         private OsuSpriteText text = null!;
-        private ChannelListItemCloseButton close = null!;
+        private Drawable close = null!;
 
         [Resolved]
         private Bindable<Channel> selectedChannel { get; set; } = null!;
@@ -97,20 +97,8 @@ namespace osu.Game.Overlays.Chat.ChannelList
                                     RelativeSizeAxes = Axes.X,
                                     Truncate = true,
                                 },
-                                new ChannelListItemMentionPill
-                                {
-                                    Anchor = Anchor.CentreLeft,
-                                    Origin = Anchor.CentreLeft,
-                                    Margin = new MarginPadding { Right = 3 },
-                                    Mentions = { BindTarget = Mentions },
-                                },
-                                close = new ChannelListItemCloseButton
-                                {
-                                    Anchor = Anchor.CentreLeft,
-                                    Origin = Anchor.CentreLeft,
-                                    Margin = new MarginPadding { Right = 3 },
-                                    Action = () => OnRequestLeave?.Invoke(Channel),
-                                }
+                                createMentionPill(),
+                                close = createCloseButton(),
                             }
                         },
                     },
@@ -131,14 +119,20 @@ namespace osu.Game.Overlays.Chat.ChannelList
         protected override bool OnHover(HoverEvent e)
         {
             hoverBox.FadeIn(300, Easing.OutQuint);
-            close.FadeIn(300, Easing.OutQuint);
+
+            if (!isSelector)
+                close.FadeIn(300, Easing.OutQuint);
+
             return base.OnHover(e);
         }
 
         protected override void OnHoverLost(HoverLostEvent e)
         {
             hoverBox.FadeOut(200, Easing.OutQuint);
-            close.FadeOut(200, Easing.OutQuint);
+
+            if (!isSelector)
+                close.FadeOut(200, Easing.OutQuint);
+
             base.OnHoverLost(e);
         }
 
@@ -158,9 +152,37 @@ namespace osu.Game.Overlays.Chat.ChannelList
             };
         }
 
+        private Drawable createMentionPill()
+        {
+            if (isSelector)
+                return Drawable.Empty();
+
+            return new ChannelListItemMentionPill
+            {
+                Anchor = Anchor.CentreLeft,
+                Origin = Anchor.CentreLeft,
+                Margin = new MarginPadding { Right = 3 },
+                Mentions = { BindTarget = Mentions },
+            };
+        }
+
+        private Drawable createCloseButton()
+        {
+            if (isSelector)
+                return Drawable.Empty();
+
+            return new ChannelListItemCloseButton
+            {
+                Anchor = Anchor.CentreLeft,
+                Origin = Anchor.CentreLeft,
+                Margin = new MarginPadding { Right = 3 },
+                Action = () => OnRequestLeave?.Invoke(Channel),
+            };
+        }
+
         private void updateState()
         {
-            bool selected = selectedChannel.Value == Channel;
+            bool selected = selectedChannel.Value == Channel || (isSelector && selectedChannel.Value == null);
 
             if (selected)
                 selectBox.FadeIn(300, Easing.OutQuint);
@@ -172,5 +194,7 @@ namespace osu.Game.Overlays.Chat.ChannelList
             else
                 text.FadeColour(colourProvider.Light3, 200, Easing.OutQuint);
         }
+
+        private bool isSelector => Channel is DummySelectorChannel;
     }
 }
diff --git a/osu.Game/Overlays/Chat/ChannelList/ChannelListSelector.cs b/osu.Game/Overlays/Chat/ChannelList/ChannelListSelector.cs
deleted file mode 100644
index a07aad2041..0000000000
--- a/osu.Game/Overlays/Chat/ChannelList/ChannelListSelector.cs
+++ /dev/null
@@ -1,103 +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 enable
-
-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.Graphics;
-using osu.Game.Graphics.Containers;
-using osu.Game.Graphics.Sprites;
-using osu.Game.Online.Chat;
-
-namespace osu.Game.Overlays.Chat.ChannelList
-{
-    public class ChannelListSelector : OsuClickableContainer
-    {
-        private Box hoverBox = null!;
-        private Box selectBox = null!;
-        private OsuSpriteText text = null!;
-
-        [Resolved]
-        private Bindable<Channel> currentChannel { get; set; } = null!;
-
-        [Resolved]
-        private OverlayColourProvider colourProvider { get; set; } = null!;
-
-        [BackgroundDependencyLoader]
-        private void load(OverlayColourProvider colourProvider)
-        {
-            Height = 30;
-            RelativeSizeAxes = Axes.X;
-
-            Children = new Drawable[]
-            {
-                hoverBox = new Box
-                {
-                    RelativeSizeAxes = Axes.Both,
-                    Colour = colourProvider.Background3,
-                    Alpha = 0f,
-                },
-                selectBox = new Box
-                {
-                    RelativeSizeAxes = Axes.Both,
-                    Colour = colourProvider.Background4,
-                    Alpha = 0f,
-                },
-                new Container
-                {
-                    RelativeSizeAxes = Axes.Both,
-                    Padding = new MarginPadding { Left = 18, Right = 10 },
-                    Child = text = new OsuSpriteText
-                    {
-                        Anchor = Anchor.CentreLeft,
-                        Origin = Anchor.CentreLeft,
-                        Text = "Add more channels",
-                        Font = OsuFont.Torus.With(size: 17, weight: FontWeight.SemiBold),
-                        Colour = colourProvider.Light3,
-                        Margin = new MarginPadding { Bottom = 2 },
-                        RelativeSizeAxes = Axes.X,
-                        Truncate = true,
-                    },
-                },
-            };
-        }
-
-        protected override void LoadComplete()
-        {
-            base.LoadComplete();
-
-            currentChannel.BindValueChanged(channel =>
-            {
-                // This logic should be handled by the chat overlay rather than this component.
-                // Selected state should be moved to an abstract class and shared with ChannelListItem.
-                if (channel.NewValue == null)
-                {
-                    text.FadeColour(colourProvider.Content1, 300, Easing.OutQuint);
-                    selectBox.FadeIn(300, Easing.OutQuint);
-                }
-                else
-                {
-                    text.FadeColour(colourProvider.Light3, 200, Easing.OutQuint);
-                    selectBox.FadeOut(200, Easing.OutQuint);
-                }
-            }, true);
-        }
-
-        protected override bool OnHover(HoverEvent e)
-        {
-            hoverBox.FadeIn(300, Easing.OutQuint);
-            return base.OnHover(e);
-        }
-
-        protected override void OnHoverLost(HoverLostEvent e)
-        {
-            hoverBox.FadeOut(200, Easing.OutQuint);
-            base.OnHoverLost(e);
-        }
-    }
-}
diff --git a/osu.Game/Overlays/ChatOverlayV2.cs b/osu.Game/Overlays/ChatOverlayV2.cs
index 6eec0bbbf4..0307dcfdf3 100644
--- a/osu.Game/Overlays/ChatOverlayV2.cs
+++ b/osu.Game/Overlays/ChatOverlayV2.cs
@@ -154,7 +154,7 @@ namespace osu.Game.Overlays
             channelList.OnRequestSelect += channel => channelManager.CurrentChannel.Value = channel;
             channelList.OnRequestLeave += channel => channelManager.LeaveChannel(channel);
 
-            channelListing.OnRequestJoin += channel => channelManager.JoinChannel(channel, false);
+            channelListing.OnRequestJoin += channel => channelManager.JoinChannel(channel);
             channelListing.OnRequestLeave += channel => channelManager.LeaveChannel(channel);
 
             textBar.OnSearchTermsChanged += searchTerms => channelListing.SearchTerm = searchTerms;
@@ -237,7 +237,7 @@ namespace osu.Game.Overlays
         {
             Channel? newChannel = channel.NewValue;
 
-            if (newChannel == null)
+            if (newChannel == null || newChannel is DummySelectorChannel)
             {
                 // null channel denotes that we should be showing the listing.
                 channelListing.State.Value = Visibility.Visible;
@@ -293,4 +293,13 @@ namespace osu.Game.Overlays
                 channelManager.PostMessage(message);
         }
     }
+
+    public class DummySelectorChannel : Channel
+    {
+        public DummySelectorChannel()
+        {
+            Name = "Add more channels";
+            Type = ChannelType.System;
+        }
+    }
 }

From a633501687c0535f76b2422cbb5f04f0935afccf Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Mon, 16 May 2022 14:09:37 +0900
Subject: [PATCH 4847/5547] Change FilterTerms to use LocalisableString

---
 osu.Game/Graphics/UserInterface/TriangleButton.cs          | 3 ++-
 osu.Game/Graphics/UserInterfaceV2/RoundedButton.cs         | 3 ++-
 osu.Game/Overlays/Chat/Listing/ChannelListingItem.cs       | 3 ++-
 osu.Game/Overlays/Chat/Selection/ChannelListItem.cs        | 3 ++-
 osu.Game/Overlays/Chat/Selection/ChannelSection.cs         | 3 ++-
 osu.Game/Overlays/Music/PlaylistItem.cs                    | 3 ++-
 .../Overlays/Settings/Sections/Audio/OffsetSettings.cs     | 2 +-
 osu.Game/Overlays/Settings/Sections/AudioSection.cs        | 2 +-
 .../Overlays/Settings/Sections/Gameplay/ModsSettings.cs    | 2 +-
 osu.Game/Overlays/Settings/Sections/Input/KeyBindingRow.cs | 3 ++-
 .../Settings/Sections/Input/KeyBindingsSubsection.cs       | 3 ++-
 osu.Game/Overlays/Settings/SettingsButton.cs               | 5 ++---
 osu.Game/Overlays/Settings/SettingsDropdown.cs             | 3 ++-
 osu.Game/Overlays/Settings/SettingsItem.cs                 | 7 ++++---
 osu.Game/Overlays/Settings/SettingsSection.cs              | 2 +-
 osu.Game/Overlays/Settings/SettingsSubsection.cs           | 6 +-----
 .../Screens/OnlinePlay/Lounge/Components/RoomsContainer.cs | 5 ++++-
 osu.Game/Screens/OnlinePlay/Lounge/DrawableLoungeRoom.cs   | 3 ++-
 18 files changed, 35 insertions(+), 26 deletions(-)

diff --git a/osu.Game/Graphics/UserInterface/TriangleButton.cs b/osu.Game/Graphics/UserInterface/TriangleButton.cs
index 003a81f562..5ae6130039 100644
--- a/osu.Game/Graphics/UserInterface/TriangleButton.cs
+++ b/osu.Game/Graphics/UserInterface/TriangleButton.cs
@@ -5,6 +5,7 @@ using System.Collections.Generic;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
+using osu.Framework.Localisation;
 using osu.Game.Graphics.Backgrounds;
 
 namespace osu.Game.Graphics.UserInterface
@@ -27,7 +28,7 @@ namespace osu.Game.Graphics.UserInterface
             });
         }
 
-        public virtual IEnumerable<string> FilterTerms => new[] { Text.ToString() };
+        public virtual IEnumerable<LocalisableString> FilterTerms => new[] { Text };
 
         public bool MatchingFilter
         {
diff --git a/osu.Game/Graphics/UserInterfaceV2/RoundedButton.cs b/osu.Game/Graphics/UserInterfaceV2/RoundedButton.cs
index ec56b6d784..3c0c3b69e8 100644
--- a/osu.Game/Graphics/UserInterfaceV2/RoundedButton.cs
+++ b/osu.Game/Graphics/UserInterfaceV2/RoundedButton.cs
@@ -6,6 +6,7 @@ using JetBrains.Annotations;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
+using osu.Framework.Localisation;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Overlays;
 
@@ -39,7 +40,7 @@ namespace osu.Game.Graphics.UserInterfaceV2
 
         private void updateCornerRadius() => Content.CornerRadius = DrawHeight / 2;
 
-        public virtual IEnumerable<string> FilterTerms => new[] { Text.ToString() };
+        public virtual IEnumerable<LocalisableString> FilterTerms => new[] { Text };
 
         public bool MatchingFilter
         {
diff --git a/osu.Game/Overlays/Chat/Listing/ChannelListingItem.cs b/osu.Game/Overlays/Chat/Listing/ChannelListingItem.cs
index 1f0cbae7e2..86c81d5d79 100644
--- a/osu.Game/Overlays/Chat/Listing/ChannelListingItem.cs
+++ b/osu.Game/Overlays/Chat/Listing/ChannelListingItem.cs
@@ -12,6 +12,7 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Input.Events;
+using osu.Framework.Localisation;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
@@ -28,7 +29,7 @@ namespace osu.Game.Overlays.Chat.Listing
         public readonly Channel Channel;
 
         public bool FilteringActive { get; set; }
-        public IEnumerable<string> FilterTerms => new[] { Channel.Name, Channel.Topic ?? string.Empty };
+        public IEnumerable<LocalisableString> FilterTerms => new LocalisableString[] { Channel.Name, Channel.Topic ?? string.Empty };
         public bool MatchingFilter { set => this.FadeTo(value ? 1f : 0f, 100); }
 
         private Box hoverBox = null!;
diff --git a/osu.Game/Overlays/Chat/Selection/ChannelListItem.cs b/osu.Game/Overlays/Chat/Selection/ChannelListItem.cs
index 1e58e8b640..59989ade7b 100644
--- a/osu.Game/Overlays/Chat/Selection/ChannelListItem.cs
+++ b/osu.Game/Overlays/Chat/Selection/ChannelListItem.cs
@@ -11,6 +11,7 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Input.Events;
+using osu.Framework.Localisation;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Online.Chat;
@@ -36,7 +37,7 @@ namespace osu.Game.Overlays.Chat.Selection
         private Color4 topicColour;
         private Color4 hoverColour;
 
-        public IEnumerable<string> FilterTerms => new[] { Channel.Name, Channel.Topic ?? string.Empty };
+        public IEnumerable<LocalisableString> FilterTerms => new LocalisableString[] { Channel.Name, Channel.Topic ?? string.Empty };
 
         public bool MatchingFilter
         {
diff --git a/osu.Game/Overlays/Chat/Selection/ChannelSection.cs b/osu.Game/Overlays/Chat/Selection/ChannelSection.cs
index 537ac975ac..070332180c 100644
--- a/osu.Game/Overlays/Chat/Selection/ChannelSection.cs
+++ b/osu.Game/Overlays/Chat/Selection/ChannelSection.cs
@@ -6,6 +6,7 @@ using System.Collections.Generic;
 using System.Linq;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
+using osu.Framework.Localisation;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Online.Chat;
@@ -18,7 +19,7 @@ namespace osu.Game.Overlays.Chat.Selection
         public readonly FillFlowContainer<ChannelListItem> ChannelFlow;
 
         public IEnumerable<IFilterable> FilterableChildren => ChannelFlow.Children;
-        public IEnumerable<string> FilterTerms => Array.Empty<string>();
+        public IEnumerable<LocalisableString> FilterTerms => Array.Empty<LocalisableString>();
 
         public bool MatchingFilter
         {
diff --git a/osu.Game/Overlays/Music/PlaylistItem.cs b/osu.Game/Overlays/Music/PlaylistItem.cs
index f081cc0503..82599d3ec9 100644
--- a/osu.Game/Overlays/Music/PlaylistItem.cs
+++ b/osu.Game/Overlays/Music/PlaylistItem.cs
@@ -3,6 +3,7 @@
 
 using System;
 using System.Collections.Generic;
+using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
@@ -113,7 +114,7 @@ namespace osu.Game.Overlays.Music
             }
         }
 
-        public IEnumerable<string> FilterTerms => Model.PerformRead(m => m.Metadata.GetSearchableTerms());
+        public IEnumerable<LocalisableString> FilterTerms => Model.PerformRead(m => m.Metadata.GetSearchableTerms()).Select(s => (LocalisableString)s).ToArray();
 
         private bool matchingFilter = true;
 
diff --git a/osu.Game/Overlays/Settings/Sections/Audio/OffsetSettings.cs b/osu.Game/Overlays/Settings/Sections/Audio/OffsetSettings.cs
index 673252a99e..eaacb9293f 100644
--- a/osu.Game/Overlays/Settings/Sections/Audio/OffsetSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Audio/OffsetSettings.cs
@@ -16,7 +16,7 @@ namespace osu.Game.Overlays.Settings.Sections.Audio
     {
         protected override LocalisableString Header => AudioSettingsStrings.OffsetHeader;
 
-        public override IEnumerable<string> FilterTerms => base.FilterTerms.Concat(new[] { "universal", "uo", "timing" });
+        public override IEnumerable<LocalisableString> FilterTerms => base.FilterTerms.Concat(new LocalisableString[] { "universal", "uo", "timing" });
 
         [BackgroundDependencyLoader]
         private void load(OsuConfigManager config)
diff --git a/osu.Game/Overlays/Settings/Sections/AudioSection.cs b/osu.Game/Overlays/Settings/Sections/AudioSection.cs
index 694da0529a..7ffa0bd415 100644
--- a/osu.Game/Overlays/Settings/Sections/AudioSection.cs
+++ b/osu.Game/Overlays/Settings/Sections/AudioSection.cs
@@ -20,7 +20,7 @@ namespace osu.Game.Overlays.Settings.Sections
             Icon = FontAwesome.Solid.VolumeUp
         };
 
-        public override IEnumerable<string> FilterTerms => base.FilterTerms.Concat(new[] { "sound" });
+        public override IEnumerable<LocalisableString> FilterTerms => base.FilterTerms.Concat(new LocalisableString[] { "sound" });
 
         public AudioSection()
         {
diff --git a/osu.Game/Overlays/Settings/Sections/Gameplay/ModsSettings.cs b/osu.Game/Overlays/Settings/Sections/Gameplay/ModsSettings.cs
index dfa060e8d5..ed88d80570 100644
--- a/osu.Game/Overlays/Settings/Sections/Gameplay/ModsSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Gameplay/ModsSettings.cs
@@ -14,7 +14,7 @@ namespace osu.Game.Overlays.Settings.Sections.Gameplay
     {
         protected override LocalisableString Header => GameplaySettingsStrings.ModsHeader;
 
-        public override IEnumerable<string> FilterTerms => base.FilterTerms.Concat(new[] { "mod" });
+        public override IEnumerable<LocalisableString> FilterTerms => base.FilterTerms.Concat(new LocalisableString[] { "mod" });
 
         [BackgroundDependencyLoader]
         private void load(OsuConfigManager config)
diff --git a/osu.Game/Overlays/Settings/Sections/Input/KeyBindingRow.cs b/osu.Game/Overlays/Settings/Sections/Input/KeyBindingRow.cs
index 459405f57d..7312748435 100644
--- a/osu.Game/Overlays/Settings/Sections/Input/KeyBindingRow.cs
+++ b/osu.Game/Overlays/Settings/Sections/Input/KeyBindingRow.cs
@@ -15,6 +15,7 @@ using osu.Framework.Graphics.Shapes;
 using osu.Framework.Input;
 using osu.Framework.Input.Bindings;
 using osu.Framework.Input.Events;
+using osu.Framework.Localisation;
 using osu.Game.Database;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
@@ -67,7 +68,7 @@ namespace osu.Game.Overlays.Settings.Sections.Input
 
         private Bindable<bool> isDefault { get; } = new BindableBool(true);
 
-        public IEnumerable<string> FilterTerms => bindings.Select(b => keyCombinationProvider.GetReadableString(b.KeyCombination)).Prepend(text.Text.ToString());
+        public IEnumerable<LocalisableString> FilterTerms => bindings.Select(b => (LocalisableString)keyCombinationProvider.GetReadableString(b.KeyCombination)).Prepend(text.Text);
 
         public KeyBindingRow(object action, List<RealmKeyBinding> bindings)
         {
diff --git a/osu.Game/Overlays/Settings/Sections/Input/KeyBindingsSubsection.cs b/osu.Game/Overlays/Settings/Sections/Input/KeyBindingsSubsection.cs
index 922d371261..297af35fb5 100644
--- a/osu.Game/Overlays/Settings/Sections/Input/KeyBindingsSubsection.cs
+++ b/osu.Game/Overlays/Settings/Sections/Input/KeyBindingsSubsection.cs
@@ -6,6 +6,7 @@ using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.IEnumerableExtensions;
 using osu.Framework.Graphics;
+using osu.Framework.Localisation;
 using osu.Game.Database;
 using osu.Game.Input.Bindings;
 using osu.Game.Rulesets;
@@ -74,6 +75,6 @@ namespace osu.Game.Overlays.Settings.Sections.Input
         }
 
         // Empty FilterTerms so that the ResetButton is visible only when the whole subsection is visible.
-        public override IEnumerable<string> FilterTerms => Enumerable.Empty<string>();
+        public override IEnumerable<LocalisableString> FilterTerms => Enumerable.Empty<LocalisableString>();
     }
 }
diff --git a/osu.Game/Overlays/Settings/SettingsButton.cs b/osu.Game/Overlays/Settings/SettingsButton.cs
index be7f2de480..10aea92b22 100644
--- a/osu.Game/Overlays/Settings/SettingsButton.cs
+++ b/osu.Game/Overlays/Settings/SettingsButton.cs
@@ -20,13 +20,12 @@ namespace osu.Game.Overlays.Settings
 
         public LocalisableString TooltipText { get; set; }
 
-        public override IEnumerable<string> FilterTerms
+        public override IEnumerable<LocalisableString> FilterTerms
         {
             get
             {
                 if (TooltipText != default)
-                    // TODO: this won't work as intended once the tooltip text is translated.
-                    return base.FilterTerms.Append(TooltipText.ToString());
+                    return base.FilterTerms.Append(TooltipText);
 
                 return base.FilterTerms;
             }
diff --git a/osu.Game/Overlays/Settings/SettingsDropdown.cs b/osu.Game/Overlays/Settings/SettingsDropdown.cs
index 1e90222d28..3c10c084ab 100644
--- a/osu.Game/Overlays/Settings/SettingsDropdown.cs
+++ b/osu.Game/Overlays/Settings/SettingsDropdown.cs
@@ -5,6 +5,7 @@ using System.Collections.Generic;
 using System.Linq;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
+using osu.Framework.Localisation;
 using osu.Game.Graphics.UserInterface;
 
 namespace osu.Game.Overlays.Settings
@@ -25,7 +26,7 @@ namespace osu.Game.Overlays.Settings
             set => Control.ItemSource = value;
         }
 
-        public override IEnumerable<string> FilterTerms => base.FilterTerms.Concat(Control.Items.Select(i => i.ToString()));
+        public override IEnumerable<LocalisableString> FilterTerms => base.FilterTerms.Concat(Control.Items.Select(i => (LocalisableString)i.ToString()));
 
         protected sealed override Drawable CreateControl() => CreateDropdown();
 
diff --git a/osu.Game/Overlays/Settings/SettingsItem.cs b/osu.Game/Overlays/Settings/SettingsItem.cs
index afcd41af22..ee9daa1c0d 100644
--- a/osu.Game/Overlays/Settings/SettingsItem.cs
+++ b/osu.Game/Overlays/Settings/SettingsItem.cs
@@ -3,6 +3,7 @@
 
 using System;
 using System.Collections.Generic;
+using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
@@ -98,13 +99,13 @@ namespace osu.Game.Overlays.Settings
             set => controlWithCurrent.Current = value;
         }
 
-        public virtual IEnumerable<string> FilterTerms
+        public virtual IEnumerable<LocalisableString> FilterTerms
         {
             get
             {
-                var keywords = new List<string>(Keywords ?? Array.Empty<string>())
+                var keywords = new List<LocalisableString>(Keywords?.Select(k => (LocalisableString)k) ?? Array.Empty<LocalisableString>())
                 {
-                    LabelText.ToString()
+                    LabelText
                 };
 
                 if (HasClassicDefault)
diff --git a/osu.Game/Overlays/Settings/SettingsSection.cs b/osu.Game/Overlays/Settings/SettingsSection.cs
index cfb0212b8c..da596e4d9d 100644
--- a/osu.Game/Overlays/Settings/SettingsSection.cs
+++ b/osu.Game/Overlays/Settings/SettingsSection.cs
@@ -32,7 +32,7 @@ namespace osu.Game.Overlays.Settings
         public abstract LocalisableString Header { get; }
 
         public IEnumerable<IFilterable> FilterableChildren => Children.OfType<IFilterable>();
-        public virtual IEnumerable<string> FilterTerms => new[] { Header.ToString() };
+        public virtual IEnumerable<LocalisableString> FilterTerms => new[] { Header };
 
         public const int ITEM_SPACING = 14;
 
diff --git a/osu.Game/Overlays/Settings/SettingsSubsection.cs b/osu.Game/Overlays/Settings/SettingsSubsection.cs
index c2cf08ac98..21391d5ccf 100644
--- a/osu.Game/Overlays/Settings/SettingsSubsection.cs
+++ b/osu.Game/Overlays/Settings/SettingsSubsection.cs
@@ -25,11 +25,7 @@ namespace osu.Game.Overlays.Settings
 
         public IEnumerable<IFilterable> FilterableChildren => Children.OfType<IFilterable>();
 
-        // FilterTerms should contains both original string and localised string for user to search.
-        // Since LocalisableString is unable to get original string at this time (2021-08-14),
-        // only call .ToString() to use localised one.
-        // TODO: Update here when FilterTerms accept LocalisableString.
-        public virtual IEnumerable<string> FilterTerms => new[] { Header.ToString() };
+        public virtual IEnumerable<LocalisableString> FilterTerms => new[] { Header };
 
         public bool MatchingFilter
         {
diff --git a/osu.Game/Screens/OnlinePlay/Lounge/Components/RoomsContainer.cs b/osu.Game/Screens/OnlinePlay/Lounge/Components/RoomsContainer.cs
index 74e4225f11..d61fbea387 100644
--- a/osu.Game/Screens/OnlinePlay/Lounge/Components/RoomsContainer.cs
+++ b/osu.Game/Screens/OnlinePlay/Lounge/Components/RoomsContainer.cs
@@ -80,7 +80,10 @@ namespace osu.Game.Screens.OnlinePlay.Lounge.Components
                     matchingFilter &= criteria.Ruleset == null || r.Room.PlaylistItemStats.Value?.RulesetIDs.Any(id => id == criteria.Ruleset.OnlineID) != false;
 
                     if (!string.IsNullOrEmpty(criteria.SearchString))
-                        matchingFilter &= r.FilterTerms.Any(term => term.Contains(criteria.SearchString, StringComparison.InvariantCultureIgnoreCase));
+                    {
+                        // Room name isn't translatable, so ToString() is used here for simplicity.
+                        matchingFilter &= r.FilterTerms.Any(term => term.ToString().Contains(criteria.SearchString, StringComparison.InvariantCultureIgnoreCase));
+                    }
 
                     r.MatchingFilter = matchingFilter;
                 }
diff --git a/osu.Game/Screens/OnlinePlay/Lounge/DrawableLoungeRoom.cs b/osu.Game/Screens/OnlinePlay/Lounge/DrawableLoungeRoom.cs
index 7baa346c6f..35c903eb0c 100644
--- a/osu.Game/Screens/OnlinePlay/Lounge/DrawableLoungeRoom.cs
+++ b/osu.Game/Screens/OnlinePlay/Lounge/DrawableLoungeRoom.cs
@@ -14,6 +14,7 @@ using osu.Framework.Graphics.Shapes;
 using osu.Framework.Graphics.UserInterface;
 using osu.Framework.Input.Bindings;
 using osu.Framework.Input.Events;
+using osu.Framework.Localisation;
 using osu.Game.Extensions;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
@@ -101,7 +102,7 @@ namespace osu.Game.Screens.OnlinePlay.Lounge
 
         public bool FilteringActive { get; set; }
 
-        public IEnumerable<string> FilterTerms => new[] { Room.Name.Value };
+        public IEnumerable<LocalisableString> FilterTerms => new LocalisableString[] { Room.Name.Value };
 
         private bool matchingFilter = true;
 

From 8c9edee360ba44364b5d3796f86e54db8bc04bf1 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 16 May 2022 15:47:00 +0900
Subject: [PATCH 4848/5547] Add ruleset context to sentry error reports

---
 osu.Game/Utils/SentryLogger.cs | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/osu.Game/Utils/SentryLogger.cs b/osu.Game/Utils/SentryLogger.cs
index 3edb27ca9b..ace397708e 100644
--- a/osu.Game/Utils/SentryLogger.cs
+++ b/osu.Game/Utils/SentryLogger.cs
@@ -18,6 +18,7 @@ using osu.Game.Database;
 using osu.Game.Models;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays;
+using osu.Game.Rulesets;
 using osu.Game.Skinning;
 using Sentry;
 using Sentry.Protocol;
@@ -109,6 +110,7 @@ namespace osu.Game.Utils
                 }, scope =>
                 {
                     var beatmap = game.Dependencies.Get<IBindable<WorkingBeatmap>>().Value.BeatmapInfo;
+                    var ruleset = game.Dependencies.Get<IBindable<RulesetInfo>>().Value;
 
                     scope.Contexts[@"config"] = new
                     {
@@ -137,9 +139,17 @@ namespace osu.Game.Utils
                     scope.Contexts[@"beatmap"] = new
                     {
                         Name = beatmap.ToString(),
+                        Ruleset = beatmap.Ruleset.InstantiationInfo,
                         beatmap.OnlineID,
                     };
 
+                    scope.Contexts[@"ruleset"] = new
+                    {
+                        ruleset.Name,
+                        ruleset.InstantiationInfo,
+                        ruleset.OnlineID
+                    };
+
                     scope.Contexts[@"clocks"] = new
                     {
                         Audio = game.Dependencies.Get<MusicController>().CurrentTrack.CurrentTime,

From 5ec05a86535038c8dd2a79d1f34c30d24360ba02 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 16 May 2022 15:50:15 +0900
Subject: [PATCH 4849/5547] Add tags for current screen and ruleset

---
 osu.Game/OsuGame.cs            | 2 ++
 osu.Game/Utils/SentryLogger.cs | 3 +++
 2 files changed, 5 insertions(+)

diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index 3d56d33689..785881d97a 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -1207,6 +1207,8 @@ namespace osu.Game
                     Current = newScreen?.GetType().ReadableName(),
                     Previous = current?.GetType().ReadableName(),
                 };
+
+                scope.SetTag(@"screen", newScreen?.GetType().ReadableName() ?? @"none");
             });
 
             switch (newScreen)
diff --git a/osu.Game/Utils/SentryLogger.cs b/osu.Game/Utils/SentryLogger.cs
index ace397708e..b5d318bc64 100644
--- a/osu.Game/Utils/SentryLogger.cs
+++ b/osu.Game/Utils/SentryLogger.cs
@@ -145,6 +145,7 @@ namespace osu.Game.Utils
 
                     scope.Contexts[@"ruleset"] = new
                     {
+                        ruleset.ShortName,
                         ruleset.Name,
                         ruleset.InstantiationInfo,
                         ruleset.OnlineID
@@ -155,6 +156,8 @@ namespace osu.Game.Utils
                         Audio = game.Dependencies.Get<MusicController>().CurrentTrack.CurrentTime,
                         Game = game.Clock.CurrentTime,
                     };
+
+                    scope.SetTag(@"ruleset", ruleset.ShortName);
                 });
             }
             else

From 9331c6230669ebccdd2a244f317299a5a647a3d4 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 16 May 2022 16:07:56 +0900
Subject: [PATCH 4850/5547] Also add realm ruleset count

---
 osu.Game/Utils/SentryLogger.cs | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/osu.Game/Utils/SentryLogger.cs b/osu.Game/Utils/SentryLogger.cs
index b5d318bc64..5390c666ed 100644
--- a/osu.Game/Utils/SentryLogger.cs
+++ b/osu.Game/Utils/SentryLogger.cs
@@ -127,6 +127,8 @@ namespace osu.Game.Utils
                                 BeatmapSets = realm.All<BeatmapSetInfo>().Count(),
                                 Beatmaps = realm.All<BeatmapInfo>().Count(),
                                 Files = realm.All<RealmFile>().Count(),
+                                Rulesets = realm.All<RulesetInfo>().Count(),
+                                RulesetsAvailable = realm.All<RulesetInfo>().Count(r => r.Available),
                                 Skins = realm.All<SkinInfo>().Count(),
                             }
                         };

From f78eb0066c7066f1f0ba4c71344a17487e8ef7a5 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 16 May 2022 17:51:12 +0900
Subject: [PATCH 4851/5547] Update `Storage` in line with new methods

---
 osu.Game/IO/WrappedStorage.cs | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/osu.Game/IO/WrappedStorage.cs b/osu.Game/IO/WrappedStorage.cs
index a6605de1d2..d4d9d531fa 100644
--- a/osu.Game/IO/WrappedStorage.cs
+++ b/osu.Game/IO/WrappedStorage.cs
@@ -67,9 +67,13 @@ namespace osu.Game.IO
         public override IEnumerable<string> GetFiles(string path, string pattern = "*") =>
             ToLocalRelative(UnderlyingStorage.GetFiles(MutatePath(path), pattern));
 
+        public override Stream CreateFileSafely(string path) => UnderlyingStorage.CreateFileSafely(path);
+
         public override Stream GetStream(string path, FileAccess access = FileAccess.Read, FileMode mode = FileMode.OpenOrCreate) =>
             UnderlyingStorage.GetStream(MutatePath(path), access, mode);
 
+        public override void Move(string from, string to) => UnderlyingStorage.Move(from, to);
+
         public override bool OpenFileExternally(string filename) => UnderlyingStorage.OpenFileExternally(MutatePath(filename));
 
         public override bool PresentFileExternally(string filename) => UnderlyingStorage.PresentFileExternally(MutatePath(filename));

From 218642c300417c38e0b20b7af19911e4a36f6364 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 16 May 2022 18:03:53 +0900
Subject: [PATCH 4852/5547] Update unsafe file write usages

---
 osu.Game.Tests/Database/BeatmapImporterTests.cs              | 2 +-
 osu.Game.Tests/Visual/Navigation/TestEFToRealmMigration.cs   | 3 +--
 osu.Game.Tournament.Tests/NonVisual/DataLoadTest.cs          | 2 +-
 osu.Game.Tournament.Tests/Screens/TestSceneDrawingsScreen.cs | 2 +-
 osu.Game.Tournament/Models/StableInfo.cs                     | 2 +-
 osu.Game.Tournament/Screens/Drawings/DrawingsScreen.cs       | 2 +-
 osu.Game.Tournament/TournamentGameBase.cs                    | 2 +-
 osu.Game/Database/LegacyExporter.cs                          | 2 +-
 osu.Game/Database/RealmAccess.cs                             | 2 +-
 osu.Game/Graphics/ScreenshotManager.cs                       | 2 +-
 osu.Game/OsuGameBase.cs                                      | 2 +-
 osu.Game/Stores/RealmFileStore.cs                            | 2 +-
 12 files changed, 12 insertions(+), 13 deletions(-)

diff --git a/osu.Game.Tests/Database/BeatmapImporterTests.cs b/osu.Game.Tests/Database/BeatmapImporterTests.cs
index b7bfe14402..00276955aa 100644
--- a/osu.Game.Tests/Database/BeatmapImporterTests.cs
+++ b/osu.Game.Tests/Database/BeatmapImporterTests.cs
@@ -507,7 +507,7 @@ namespace osu.Game.Tests.Database
                 using (var stream = storage.GetStream(firstFile.File.GetStoragePath()))
                     originalLength = stream.Length;
 
-                using (var stream = storage.GetStream(firstFile.File.GetStoragePath(), FileAccess.Write, FileMode.Create))
+                using (var stream = storage.CreateFileSafely(firstFile.File.GetStoragePath()))
                     stream.WriteByte(0);
 
                 var importedSecondTime = await LoadOszIntoStore(importer, realm.Realm);
diff --git a/osu.Game.Tests/Visual/Navigation/TestEFToRealmMigration.cs b/osu.Game.Tests/Visual/Navigation/TestEFToRealmMigration.cs
index 8498b9b28f..2ea768b878 100644
--- a/osu.Game.Tests/Visual/Navigation/TestEFToRealmMigration.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestEFToRealmMigration.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.IO;
 using System.Linq;
 using System.Runtime.InteropServices;
 using NUnit.Framework;
@@ -25,7 +24,7 @@ namespace osu.Game.Tests.Visual.Navigation
             if (isDisposing)
                 return;
 
-            using (var outStream = LocalStorage.GetStream(DatabaseContextFactory.DATABASE_NAME, FileAccess.Write, FileMode.Create))
+            using (var outStream = LocalStorage.CreateFileSafely(DatabaseContextFactory.DATABASE_NAME))
             using (var stream = TestResources.OpenResource(DatabaseContextFactory.DATABASE_NAME))
                 stream.CopyTo(outStream);
         }
diff --git a/osu.Game.Tournament.Tests/NonVisual/DataLoadTest.cs b/osu.Game.Tournament.Tests/NonVisual/DataLoadTest.cs
index 4c1256df2e..e5c539bbf1 100644
--- a/osu.Game.Tournament.Tests/NonVisual/DataLoadTest.cs
+++ b/osu.Game.Tournament.Tests/NonVisual/DataLoadTest.cs
@@ -28,7 +28,7 @@ namespace osu.Game.Tournament.Tests.NonVisual
                         // ReSharper disable once AccessToDisposedClosure
                         var storage = host.Storage.GetStorageForDirectory(Path.Combine("tournaments", "default"));
 
-                        using (var stream = storage.GetStream("bracket.json", FileAccess.Write, FileMode.Create))
+                        using (var stream = storage.CreateFileSafely("bracket.json"))
                         using (var writer = new StreamWriter(stream))
                         {
                             writer.Write(@"{
diff --git a/osu.Game.Tournament.Tests/Screens/TestSceneDrawingsScreen.cs b/osu.Game.Tournament.Tests/Screens/TestSceneDrawingsScreen.cs
index e2954c8f10..0e38c777ba 100644
--- a/osu.Game.Tournament.Tests/Screens/TestSceneDrawingsScreen.cs
+++ b/osu.Game.Tournament.Tests/Screens/TestSceneDrawingsScreen.cs
@@ -15,7 +15,7 @@ namespace osu.Game.Tournament.Tests.Screens
         [BackgroundDependencyLoader]
         private void load(Storage storage)
         {
-            using (var stream = storage.GetStream("drawings.txt", FileAccess.Write))
+            using (var stream = storage.CreateFileSafely("drawings.txt"))
             using (var writer = new StreamWriter(stream))
             {
                 writer.WriteLine("KR : South Korea : KOR");
diff --git a/osu.Game.Tournament/Models/StableInfo.cs b/osu.Game.Tournament/Models/StableInfo.cs
index 1ebc81c773..c835b11a4d 100644
--- a/osu.Game.Tournament/Models/StableInfo.cs
+++ b/osu.Game.Tournament/Models/StableInfo.cs
@@ -45,7 +45,7 @@ namespace osu.Game.Tournament.Models
 
         public void SaveChanges()
         {
-            using (var stream = configStorage.GetStream(config_path, FileAccess.Write, FileMode.Create))
+            using (var stream = configStorage.CreateFileSafely(config_path))
             using (var sw = new StreamWriter(stream))
             {
                 sw.Write(JsonConvert.SerializeObject(this,
diff --git a/osu.Game.Tournament/Screens/Drawings/DrawingsScreen.cs b/osu.Game.Tournament/Screens/Drawings/DrawingsScreen.cs
index d02e0ebf86..53ac93afea 100644
--- a/osu.Game.Tournament/Screens/Drawings/DrawingsScreen.cs
+++ b/osu.Game.Tournament/Screens/Drawings/DrawingsScreen.cs
@@ -205,7 +205,7 @@ namespace osu.Game.Tournament.Screens.Drawings
                 try
                 {
                     // Write to drawings_results
-                    using (Stream stream = storage.GetStream(results_filename, FileAccess.Write, FileMode.Create))
+                    using (Stream stream = storage.CreateFileSafely(results_filename))
                     using (StreamWriter sw = new StreamWriter(stream))
                     {
                         sw.Write(text);
diff --git a/osu.Game.Tournament/TournamentGameBase.cs b/osu.Game.Tournament/TournamentGameBase.cs
index a251a043f7..363baccb37 100644
--- a/osu.Game.Tournament/TournamentGameBase.cs
+++ b/osu.Game.Tournament/TournamentGameBase.cs
@@ -321,7 +321,7 @@ namespace osu.Game.Tournament
                     Converters = new JsonConverter[] { new JsonPointConverter() }
                 });
 
-            using (var stream = storage.GetStream(BRACKET_FILENAME, FileAccess.Write, FileMode.Create))
+            using (var stream = storage.CreateFileSafely(BRACKET_FILENAME))
             using (var sw = new StreamWriter(stream))
                 sw.Write(serialisedLadder);
         }
diff --git a/osu.Game/Database/LegacyExporter.cs b/osu.Game/Database/LegacyExporter.cs
index ee960b6b30..992d1854e7 100644
--- a/osu.Game/Database/LegacyExporter.cs
+++ b/osu.Game/Database/LegacyExporter.cs
@@ -37,7 +37,7 @@ namespace osu.Game.Database
         {
             string filename = $"{item.GetDisplayString().GetValidArchiveContentFilename()}{FileExtension}";
 
-            using (var stream = exportStorage.GetStream(filename, FileAccess.Write, FileMode.Create))
+            using (var stream = exportStorage.CreateFileSafely(filename))
                 ExportModelTo(item, stream);
 
             exportStorage.PresentFileExternally(filename);
diff --git a/osu.Game/Database/RealmAccess.cs b/osu.Game/Database/RealmAccess.cs
index 937876a70e..dbd3b96763 100644
--- a/osu.Game/Database/RealmAccess.cs
+++ b/osu.Game/Database/RealmAccess.cs
@@ -242,7 +242,7 @@ namespace osu.Game.Database
             storage.Delete(Filename);
 
             using (var inputStream = storage.GetStream(recoveryFilename))
-            using (var outputStream = storage.GetStream(Filename, FileAccess.Write, FileMode.Create))
+            using (var outputStream = storage.CreateFileSafely(Filename))
                 inputStream.CopyTo(outputStream);
 
             storage.Delete(recoveryFilename);
diff --git a/osu.Game/Graphics/ScreenshotManager.cs b/osu.Game/Graphics/ScreenshotManager.cs
index a2f1a3d7b9..1fc2633143 100644
--- a/osu.Game/Graphics/ScreenshotManager.cs
+++ b/osu.Game/Graphics/ScreenshotManager.cs
@@ -118,7 +118,7 @@ namespace osu.Game.Graphics
 
                 if (filename == null) return;
 
-                using (var stream = storage.GetStream(filename, FileAccess.Write))
+                using (var stream = storage.CreateFileSafely(filename))
                 {
                     switch (screenshotFormat.Value)
                     {
diff --git a/osu.Game/OsuGameBase.cs b/osu.Game/OsuGameBase.cs
index 2e4758a134..564cb6c131 100644
--- a/osu.Game/OsuGameBase.cs
+++ b/osu.Game/OsuGameBase.cs
@@ -243,7 +243,7 @@ namespace osu.Game
                 {
                     if (source != null)
                     {
-                        using (var destination = Storage.GetStream(Path.Combine(backup_folder, $"collection.{migration}.db"), FileAccess.Write, FileMode.CreateNew))
+                        using (var destination = Storage.CreateFileSafely(Path.Combine(backup_folder, $"collection.{migration}.db")))
                             source.CopyTo(destination);
                     }
                 }
diff --git a/osu.Game/Stores/RealmFileStore.cs b/osu.Game/Stores/RealmFileStore.cs
index b5dd3d64e4..457d70f29a 100644
--- a/osu.Game/Stores/RealmFileStore.cs
+++ b/osu.Game/Stores/RealmFileStore.cs
@@ -65,7 +65,7 @@ namespace osu.Game.Stores
         {
             data.Seek(0, SeekOrigin.Begin);
 
-            using (var output = Storage.GetStream(file.GetStoragePath(), FileAccess.Write))
+            using (var output = Storage.CreateFileSafely(file.GetStoragePath()))
                 data.CopyTo(output);
 
             data.Seek(0, SeekOrigin.Begin);

From d7aed77340b2d1b9a16f9de41081af910f304a31 Mon Sep 17 00:00:00 2001
From: "Hugo \"ThePooN\" Denizart" <thepoon@cartooncraft.fr>
Date: Mon, 16 May 2022 16:01:42 +0200
Subject: [PATCH 4853/5547] =?UTF-8?q?=F0=9F=91=B7=20Push=20tagged=20releas?=
 =?UTF-8?q?es=20to=20Sentry?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .github/workflows/sentry-release.yml | 26 ++++++++++++++++++++++++++
 1 file changed, 26 insertions(+)
 create mode 100644 .github/workflows/sentry-release.yml

diff --git a/.github/workflows/sentry-release.yml b/.github/workflows/sentry-release.yml
new file mode 100644
index 0000000000..8ca9f38234
--- /dev/null
+++ b/.github/workflows/sentry-release.yml
@@ -0,0 +1,26 @@
+name: Add Release to Sentry
+
+on:
+  push:
+    tags:
+      - '*'
+
+jobs:
+  sentry_release:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v2
+        with:
+          fetch-depth: 0
+
+      - name: Create Sentry release
+        uses: getsentry/action-release@v1
+        env:
+          SENTRY_AUTH_TOKEN: ${{ secrets.SENTRY_AUTH_TOKEN }}
+          SENTRY_ORG: ppy
+          SENTRY_PROJECT: osu
+          SENTRY_URL: https://sentry.ppy.sh/
+        with:
+          environment: production
+          version: ${{ github.ref }}

From 48b7e0f0900d52a23bb9fa1a753983c373ca6ec8 Mon Sep 17 00:00:00 2001
From: Jay L <jaime@merkids.com>
Date: Tue, 10 May 2022 18:17:40 +1000
Subject: [PATCH 4854/5547] Stamina Skill Rewrite and Refactor

---
 .../Difficulty/Skills/Stamina.cs              | 139 +++++++++---------
 .../Difficulty/TaikoDifficultyCalculator.cs   |  20 +--
 2 files changed, 75 insertions(+), 84 deletions(-)

diff --git a/osu.Game.Rulesets.Taiko/Difficulty/Skills/Stamina.cs b/osu.Game.Rulesets.Taiko/Difficulty/Skills/Stamina.cs
index 54cf233d69..b10da95444 100644
--- a/osu.Game.Rulesets.Taiko/Difficulty/Skills/Stamina.cs
+++ b/osu.Game.Rulesets.Taiko/Difficulty/Skills/Stamina.cs
@@ -1,16 +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.Linq;
+using System;
 using osu.Game.Rulesets.Difficulty.Preprocessing;
 using osu.Game.Rulesets.Difficulty.Skills;
-using osu.Game.Rulesets.Difficulty.Utils;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Taiko.Difficulty.Preprocessing;
 using osu.Game.Rulesets.Taiko.Objects;
 
 namespace osu.Game.Rulesets.Taiko.Difficulty.Skills
 {
+    class SingleKeyStamina
+    {
+        private double previousHitTime = -1;
+
+        private double strainValueOf(DifficultyHitObject current)
+        {
+            if (previousHitTime == -1)
+            {
+                previousHitTime = current.StartTime;
+                return 0;
+            }
+            else
+            {
+                double objectStrain = 0.5;
+                objectStrain += speedBonus(current.StartTime - previousHitTime);
+                previousHitTime = current.StartTime;
+                return objectStrain;
+            }
+        }
+
+        public double StrainValueAt(DifficultyHitObject current)
+        {
+            return strainValueOf(current);
+        }
+
+        /// <summary>
+        /// Applies a speed bonus dependent on the time since the last hit performed using this key.
+        /// </summary>
+        /// <param name="notePairDuration">The duration between the current and previous note hit using the same key.</param>
+        private double speedBonus(double notePairDuration)
+        {
+            return 175 / Math.Pow(notePairDuration + 100, 1);
+        }
+    }
+
     /// <summary>
     /// Calculates the stamina coefficient of taiko difficulty.
     /// </summary>
@@ -22,39 +56,43 @@ namespace osu.Game.Rulesets.Taiko.Difficulty.Skills
         protected override double SkillMultiplier => 1;
         protected override double StrainDecayBase => 0.4;
 
-        /// <summary>
-        /// Maximum number of entries to keep in <see cref="notePairDurationHistory"/>.
-        /// </summary>
-        private const int max_history_length = 2;
+        private SingleKeyStamina[] keyStamina = new SingleKeyStamina[4]
+        {
+            new SingleKeyStamina(),
+            new SingleKeyStamina(),
+            new SingleKeyStamina(),
+            new SingleKeyStamina()
+        };
 
-        /// <summary>
-        /// The index of the hand this <see cref="Stamina"/> instance is associated with.
-        /// </summary>
-        /// <remarks>
-        /// The value of 0 indicates the left hand (full alternating gameplay starting with left hand is assumed).
-        /// This naturally translates onto index offsets of the objects in the map.
-        /// </remarks>
-        private readonly int hand;
-
-        /// <summary>
-        /// Stores the last <see cref="max_history_length"/> durations between notes hit with the hand indicated by <see cref="hand"/>.
-        /// </summary>
-        private readonly LimitedCapacityQueue<double> notePairDurationHistory = new LimitedCapacityQueue<double>(max_history_length);
-
-        /// <summary>
-        /// Stores the <see cref="DifficultyHitObject.DeltaTime"/> of the last object that was hit by the <i>other</i> hand.
-        /// </summary>
-        private double offhandObjectDuration = double.MaxValue;
+        private int donIndex = 1;
+        private int katIndex = 3;
 
         /// <summary>
         /// Creates a <see cref="Stamina"/> skill.
         /// </summary>
         /// <param name="mods">Mods for use in skill calculations.</param>
-        /// <param name="rightHand">Whether this instance is performing calculations for the right hand.</param>
-        public Stamina(Mod[] mods, bool rightHand)
+        public Stamina(Mod[] mods)
             : base(mods)
         {
-            hand = rightHand ? 1 : 0;
+        }
+
+        private SingleKeyStamina getNextSingleKeyStamina(TaikoDifficultyHitObject current)
+        {
+            if (current.HitType == HitType.Centre)
+            {
+                donIndex = donIndex == 0 ? 1 : 0;
+                return keyStamina[donIndex];
+            }
+            else
+            {
+                katIndex = katIndex == 2 ? 3 : 2;
+                return keyStamina[katIndex];
+            }
+        }
+
+        private double sigmoid(double val, double center, double width)
+        {
+            return Math.Tanh(Math.E * -(val - center) / width);
         }
 
         protected override double StrainValueOf(DifficultyHitObject current)
@@ -65,52 +103,9 @@ namespace osu.Game.Rulesets.Taiko.Difficulty.Skills
             }
 
             TaikoDifficultyHitObject hitObject = (TaikoDifficultyHitObject)current;
+            double objectStrain = getNextSingleKeyStamina(hitObject).StrainValueAt(hitObject);
 
-            if (hitObject.ObjectIndex % 2 == hand)
-            {
-                double objectStrain = 1;
-
-                if (hitObject.ObjectIndex == 1)
-                    return 1;
-
-                notePairDurationHistory.Enqueue(hitObject.DeltaTime + offhandObjectDuration);
-
-                double shortestRecentNote = notePairDurationHistory.Min();
-                objectStrain += speedBonus(shortestRecentNote);
-
-                if (hitObject.StaminaCheese)
-                    objectStrain *= cheesePenalty(hitObject.DeltaTime + offhandObjectDuration);
-
-                return objectStrain;
-            }
-
-            offhandObjectDuration = hitObject.DeltaTime;
-            return 0;
-        }
-
-        /// <summary>
-        /// Applies a penalty for hit objects marked with <see cref="TaikoDifficultyHitObject.StaminaCheese"/>.
-        /// </summary>
-        /// <param name="notePairDuration">The duration between the current and previous note hit using the hand indicated by <see cref="hand"/>.</param>
-        private double cheesePenalty(double notePairDuration)
-        {
-            if (notePairDuration > 125) return 1;
-            if (notePairDuration < 100) return 0.6;
-
-            return 0.6 + (notePairDuration - 100) * 0.016;
-        }
-
-        /// <summary>
-        /// Applies a speed bonus dependent on the time since the last hit performed using this hand.
-        /// </summary>
-        /// <param name="notePairDuration">The duration between the current and previous note hit using the hand indicated by <see cref="hand"/>.</param>
-        private double speedBonus(double notePairDuration)
-        {
-            if (notePairDuration >= 200) return 0;
-
-            double bonus = 200 - notePairDuration;
-            bonus *= bonus;
-            return bonus / 100000;
+            return objectStrain;
         }
     }
 }
diff --git a/osu.Game.Rulesets.Taiko/Difficulty/TaikoDifficultyCalculator.cs b/osu.Game.Rulesets.Taiko/Difficulty/TaikoDifficultyCalculator.cs
index a9d512f076..de69f63bf4 100644
--- a/osu.Game.Rulesets.Taiko/Difficulty/TaikoDifficultyCalculator.cs
+++ b/osu.Game.Rulesets.Taiko/Difficulty/TaikoDifficultyCalculator.cs
@@ -22,7 +22,7 @@ namespace osu.Game.Rulesets.Taiko.Difficulty
     {
         private const double rhythm_skill_multiplier = 0.014;
         private const double colour_skill_multiplier = 0.01;
-        private const double stamina_skill_multiplier = 0.02;
+        private const double stamina_skill_multiplier = 0.021;
 
         public TaikoDifficultyCalculator(IRulesetInfo ruleset, IWorkingBeatmap beatmap)
             : base(ruleset, beatmap)
@@ -33,8 +33,7 @@ namespace osu.Game.Rulesets.Taiko.Difficulty
         {
             new Colour(mods),
             new Rhythm(mods),
-            new Stamina(mods, true),
-            new Stamina(mods, false),
+            new Stamina(mods)
         };
 
         protected override Mod[] DifficultyAdjustmentMods => new Mod[]
@@ -58,7 +57,6 @@ namespace osu.Game.Rulesets.Taiko.Difficulty
                 );
             }
 
-            new StaminaCheeseDetector(taikoDifficultyHitObjects).FindCheese();
             return taikoDifficultyHitObjects;
         }
 
@@ -69,17 +67,16 @@ namespace osu.Game.Rulesets.Taiko.Difficulty
 
             var colour = (Colour)skills[0];
             var rhythm = (Rhythm)skills[1];
-            var staminaRight = (Stamina)skills[2];
-            var staminaLeft = (Stamina)skills[3];
+            var stamina = (Stamina)skills[2];
 
             double colourRating = colour.DifficultyValue() * colour_skill_multiplier;
             double rhythmRating = rhythm.DifficultyValue() * rhythm_skill_multiplier;
-            double staminaRating = (staminaRight.DifficultyValue() + staminaLeft.DifficultyValue()) * stamina_skill_multiplier;
+            double staminaRating = stamina.DifficultyValue() * stamina_skill_multiplier;
 
             double staminaPenalty = simpleColourPenalty(staminaRating, colourRating);
             staminaRating *= staminaPenalty;
 
-            double combinedRating = locallyCombinedDifficulty(colour, rhythm, staminaRight, staminaLeft, staminaPenalty);
+            double combinedRating = locallyCombinedDifficulty(colour, rhythm, stamina, staminaPenalty);
             double separatedRating = norm(1.5, colourRating, rhythmRating, staminaRating);
             double starRating = 1.4 * separatedRating + 0.5 * combinedRating;
             starRating = rescale(starRating);
@@ -127,20 +124,19 @@ namespace osu.Game.Rulesets.Taiko.Difficulty
         /// For each section, the peak strains of all separate skills are combined into a single peak strain for the section.
         /// The resulting partial rating of the beatmap is a weighted sum of the combined peaks (higher peaks are weighted more).
         /// </remarks>
-        private double locallyCombinedDifficulty(Colour colour, Rhythm rhythm, Stamina staminaRight, Stamina staminaLeft, double staminaPenalty)
+        private double locallyCombinedDifficulty(Colour colour, Rhythm rhythm, Stamina stamina, double staminaPenalty)
         {
             List<double> peaks = new List<double>();
 
             var colourPeaks = colour.GetCurrentStrainPeaks().ToList();
             var rhythmPeaks = rhythm.GetCurrentStrainPeaks().ToList();
-            var staminaRightPeaks = staminaRight.GetCurrentStrainPeaks().ToList();
-            var staminaLeftPeaks = staminaLeft.GetCurrentStrainPeaks().ToList();
+            var staminaPeaks = stamina.GetCurrentStrainPeaks().ToList();
 
             for (int i = 0; i < colourPeaks.Count; i++)
             {
                 double colourPeak = colourPeaks[i] * colour_skill_multiplier;
                 double rhythmPeak = rhythmPeaks[i] * rhythm_skill_multiplier;
-                double staminaPeak = (staminaRightPeaks[i] + staminaLeftPeaks[i]) * stamina_skill_multiplier * staminaPenalty;
+                double staminaPeak = staminaPeaks[i] * stamina_skill_multiplier * staminaPenalty;
 
                 double peak = norm(2, colourPeak, rhythmPeak, staminaPeak);
 

From f15738fded36c06d022014871effae3c3c380709 Mon Sep 17 00:00:00 2001
From: Jay L <jaime@merkids.com>
Date: Sun, 15 May 2022 22:09:24 +1000
Subject: [PATCH 4855/5547] Remove Redundant Detection

Not needed, as nerf is not required anymore and has negative effect.
---
 .../Preprocessing/StaminaCheeseDetector.cs    | 145 ------------------
 1 file changed, 145 deletions(-)
 delete mode 100644 osu.Game.Rulesets.Taiko/Difficulty/Preprocessing/StaminaCheeseDetector.cs

diff --git a/osu.Game.Rulesets.Taiko/Difficulty/Preprocessing/StaminaCheeseDetector.cs b/osu.Game.Rulesets.Taiko/Difficulty/Preprocessing/StaminaCheeseDetector.cs
deleted file mode 100644
index 3b1a9ad777..0000000000
--- a/osu.Game.Rulesets.Taiko/Difficulty/Preprocessing/StaminaCheeseDetector.cs
+++ /dev/null
@@ -1,145 +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 osu.Game.Rulesets.Difficulty.Utils;
-using osu.Game.Rulesets.Taiko.Objects;
-
-namespace osu.Game.Rulesets.Taiko.Difficulty.Preprocessing
-{
-    /// <summary>
-    /// Detects special hit object patterns which are easier to hit using special techniques
-    /// than normally assumed in the fully-alternating play style.
-    /// </summary>
-    /// <remarks>
-    /// This component detects two basic types of patterns, leveraged by the following techniques:
-    /// <list>
-    /// <item>Rolling allows hitting patterns with quickly and regularly alternating notes with a single hand.</item>
-    /// <item>TL tapping makes hitting longer sequences of consecutive same-colour notes with little to no colour changes in-between.</item>
-    /// </list>
-    /// </remarks>
-    public class StaminaCheeseDetector
-    {
-        /// <summary>
-        /// The minimum number of consecutive objects with repeating patterns that can be classified as hittable using a roll.
-        /// </summary>
-        private const int roll_min_repetitions = 12;
-
-        /// <summary>
-        /// The minimum number of consecutive objects with repeating patterns that can be classified as hittable using a TL tap.
-        /// </summary>
-        private const int tl_min_repetitions = 16;
-
-        /// <summary>
-        /// The list of all <see cref="TaikoDifficultyHitObject"/>s in the map.
-        /// </summary>
-        private readonly List<TaikoDifficultyHitObject> hitObjects;
-
-        public StaminaCheeseDetector(List<TaikoDifficultyHitObject> hitObjects)
-        {
-            this.hitObjects = hitObjects;
-        }
-
-        /// <summary>
-        /// Finds and marks all objects in <see cref="hitObjects"/> that special difficulty-reducing techiques apply to
-        /// with the <see cref="TaikoDifficultyHitObject.StaminaCheese"/> flag.
-        /// </summary>
-        public void FindCheese()
-        {
-            findRolls(3);
-            findRolls(4);
-
-            findTlTap(0, HitType.Rim);
-            findTlTap(1, HitType.Rim);
-            findTlTap(0, HitType.Centre);
-            findTlTap(1, HitType.Centre);
-        }
-
-        /// <summary>
-        /// Finds and marks all sequences hittable using a roll.
-        /// </summary>
-        /// <param name="patternLength">The length of a single repeating pattern to consider (triplets/quadruplets).</param>
-        private void findRolls(int patternLength)
-        {
-            var history = new LimitedCapacityQueue<TaikoDifficultyHitObject>(2 * patternLength);
-
-            // for convenience, we're tracking the index of the item *before* our suspected repeat's start,
-            // as that index can be simply subtracted from the current index to get the number of elements in between
-            // without off-by-one errors
-            int indexBeforeLastRepeat = -1;
-            int lastMarkEnd = 0;
-
-            for (int i = 0; i < hitObjects.Count; i++)
-            {
-                history.Enqueue(hitObjects[i]);
-                if (!history.Full)
-                    continue;
-
-                if (!containsPatternRepeat(history, patternLength))
-                {
-                    // we're setting this up for the next iteration, hence the +1.
-                    // right here this index will point at the queue's front (oldest item),
-                    // but that item is about to be popped next loop with an enqueue.
-                    indexBeforeLastRepeat = i - history.Count + 1;
-                    continue;
-                }
-
-                int repeatedLength = i - indexBeforeLastRepeat;
-                if (repeatedLength < roll_min_repetitions)
-                    continue;
-
-                markObjectsAsCheese(Math.Max(lastMarkEnd, i - repeatedLength + 1), i);
-                lastMarkEnd = i;
-            }
-        }
-
-        /// <summary>
-        /// Determines whether the objects stored in <paramref name="history"/> contain a repetition of a pattern of length <paramref name="patternLength"/>.
-        /// </summary>
-        private static bool containsPatternRepeat(LimitedCapacityQueue<TaikoDifficultyHitObject> history, int patternLength)
-        {
-            for (int j = 0; j < patternLength; j++)
-            {
-                if (history[j].HitType != history[j + patternLength].HitType)
-                    return false;
-            }
-
-            return true;
-        }
-
-        /// <summary>
-        /// Finds and marks all sequences hittable using a TL tap.
-        /// </summary>
-        /// <param name="parity">Whether sequences starting with an odd- (1) or even-indexed (0) hit object should be checked.</param>
-        /// <param name="type">The type of hit to check for TL taps.</param>
-        private void findTlTap(int parity, HitType type)
-        {
-            int tlLength = -2;
-            int lastMarkEnd = 0;
-
-            for (int i = parity; i < hitObjects.Count; i += 2)
-            {
-                if (hitObjects[i].HitType == type)
-                    tlLength += 2;
-                else
-                    tlLength = -2;
-
-                if (tlLength < tl_min_repetitions)
-                    continue;
-
-                markObjectsAsCheese(Math.Max(lastMarkEnd, i - tlLength + 1), i);
-                lastMarkEnd = i;
-            }
-        }
-
-        /// <summary>
-        /// Marks all objects from <paramref name="start"/> to <paramref name="end"/> (inclusive) as <see cref="TaikoDifficultyHitObject.StaminaCheese"/>.
-        /// </summary>
-        private void markObjectsAsCheese(int start, int end)
-        {
-            for (int i = start; i <= end; i++)
-                hitObjects[i].StaminaCheese = true;
-        }
-    }
-}

From d174099016363de0cd77f62b5eb0c183d2df0b47 Mon Sep 17 00:00:00 2001
From: Jay L <jaime@merkids.com>
Date: Sun, 15 May 2022 22:09:54 +1000
Subject: [PATCH 4856/5547] Refactor and Cleanup of Stamina.cs

---
 .../Difficulty/Skills/Stamina.cs              | 60 ++++++++++---------
 1 file changed, 32 insertions(+), 28 deletions(-)

diff --git a/osu.Game.Rulesets.Taiko/Difficulty/Skills/Stamina.cs b/osu.Game.Rulesets.Taiko/Difficulty/Skills/Stamina.cs
index b10da95444..6d4a1fd948 100644
--- a/osu.Game.Rulesets.Taiko/Difficulty/Skills/Stamina.cs
+++ b/osu.Game.Rulesets.Taiko/Difficulty/Skills/Stamina.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.Game.Rulesets.Difficulty.Preprocessing;
 using osu.Game.Rulesets.Difficulty.Skills;
 using osu.Game.Rulesets.Mods;
@@ -10,29 +9,28 @@ using osu.Game.Rulesets.Taiko.Objects;
 
 namespace osu.Game.Rulesets.Taiko.Difficulty.Skills
 {
-    class SingleKeyStamina
+    /// <summary>
+    /// Stamina of a single key, calculated based on repetition speed.
+    /// </summary>
+    public class SingleKeyStamina
     {
         private double previousHitTime = -1;
 
-        private double strainValueOf(DifficultyHitObject current)
+        /// <summary>
+        /// Similar to <see cref="StrainDecaySkill.StrainValueOf(DifficultyHitObject)"/>
+        /// </summary>
+        public double StrainValueOf(DifficultyHitObject current)
         {
             if (previousHitTime == -1)
             {
                 previousHitTime = current.StartTime;
                 return 0;
             }
-            else
-            {
-                double objectStrain = 0.5;
-                objectStrain += speedBonus(current.StartTime - previousHitTime);
-                previousHitTime = current.StartTime;
-                return objectStrain;
-            }
-        }
 
-        public double StrainValueAt(DifficultyHitObject current)
-        {
-            return strainValueOf(current);
+            double objectStrain = 0.5;
+            objectStrain += speedBonus(current.StartTime - previousHitTime);
+            previousHitTime = current.StartTime;
+            return objectStrain;
         }
 
         /// <summary>
@@ -41,7 +39,7 @@ namespace osu.Game.Rulesets.Taiko.Difficulty.Skills
         /// <param name="notePairDuration">The duration between the current and previous note hit using the same key.</param>
         private double speedBonus(double notePairDuration)
         {
-            return 175 / Math.Pow(notePairDuration + 100, 1);
+            return 175 / (notePairDuration + 100);
         }
     }
 
@@ -56,7 +54,10 @@ namespace osu.Game.Rulesets.Taiko.Difficulty.Skills
         protected override double SkillMultiplier => 1;
         protected override double StrainDecayBase => 0.4;
 
-        private SingleKeyStamina[] keyStamina = new SingleKeyStamina[4]
+        /// <summary>
+        /// Stamina of each individual keys, calculated based on repetition speed.
+        /// </summary>
+        private readonly SingleKeyStamina[] keyStamina =
         {
             new SingleKeyStamina(),
             new SingleKeyStamina(),
@@ -64,7 +65,14 @@ namespace osu.Game.Rulesets.Taiko.Difficulty.Skills
             new SingleKeyStamina()
         };
 
+        /// <summary>
+        /// Current index to <see cref="keyStamina" /> for a don hit.
+        /// </summary>
         private int donIndex = 1;
+
+        /// <summary>
+        /// Current index to <see cref="keyStamina" /> for a kat hit.
+        /// </summary>
         private int katIndex = 3;
 
         /// <summary>
@@ -76,23 +84,21 @@ namespace osu.Game.Rulesets.Taiko.Difficulty.Skills
         {
         }
 
+        /// <summary>
+        /// Get the next <see cref="SingleKeyStamina"/> to use for the given <see cref="TaikoDifficultyHitObject"/>.
+        /// </summary>
+        /// <param name="current">The current <see cref="TaikoDifficultyHitObject"/>.</param>
         private SingleKeyStamina getNextSingleKeyStamina(TaikoDifficultyHitObject current)
         {
+            // Alternate key for the same color.
             if (current.HitType == HitType.Centre)
             {
                 donIndex = donIndex == 0 ? 1 : 0;
                 return keyStamina[donIndex];
             }
-            else
-            {
-                katIndex = katIndex == 2 ? 3 : 2;
-                return keyStamina[katIndex];
-            }
-        }
 
-        private double sigmoid(double val, double center, double width)
-        {
-            return Math.Tanh(Math.E * -(val - center) / width);
+            katIndex = katIndex == 2 ? 3 : 2;
+            return keyStamina[katIndex];
         }
 
         protected override double StrainValueOf(DifficultyHitObject current)
@@ -103,9 +109,7 @@ namespace osu.Game.Rulesets.Taiko.Difficulty.Skills
             }
 
             TaikoDifficultyHitObject hitObject = (TaikoDifficultyHitObject)current;
-            double objectStrain = getNextSingleKeyStamina(hitObject).StrainValueAt(hitObject);
-
-            return objectStrain;
+            return getNextSingleKeyStamina(hitObject).StrainValueOf(hitObject);
         }
     }
 }

From b44afb19b16a19e7464c9f1281307f4c396e1fc7 Mon Sep 17 00:00:00 2001
From: Jay L <jaime@merkids.com>
Date: Sun, 15 May 2022 22:10:18 +1000
Subject: [PATCH 4857/5547] Include Convert Penalty

For low colour variance
---
 .../Difficulty/TaikoDifficultyCalculator.cs                  | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/osu.Game.Rulesets.Taiko/Difficulty/TaikoDifficultyCalculator.cs b/osu.Game.Rulesets.Taiko/Difficulty/TaikoDifficultyCalculator.cs
index de69f63bf4..5816b9957c 100644
--- a/osu.Game.Rulesets.Taiko/Difficulty/TaikoDifficultyCalculator.cs
+++ b/osu.Game.Rulesets.Taiko/Difficulty/TaikoDifficultyCalculator.cs
@@ -76,6 +76,11 @@ namespace osu.Game.Rulesets.Taiko.Difficulty
             double staminaPenalty = simpleColourPenalty(staminaRating, colourRating);
             staminaRating *= staminaPenalty;
 
+            if (beatmap.BeatmapInfo.Ruleset.OnlineID == 0 && colourRating < 0.05)
+            {
+                staminaPenalty *= 0.25;
+            }
+
             double combinedRating = locallyCombinedDifficulty(colour, rhythm, stamina, staminaPenalty);
             double separatedRating = norm(1.5, colourRating, rhythmRating, staminaRating);
             double starRating = 1.4 * separatedRating + 0.5 * combinedRating;

From d94e30bed3985f3301ea8d769ad5060affc94755 Mon Sep 17 00:00:00 2001
From: Jay L <jaime@merkids.com>
Date: Sun, 15 May 2022 22:11:01 +1000
Subject: [PATCH 4858/5547] Rewrite Performance difficultyValue Calculation

To change values in line with the community survey, pp has been rescaled immensely, with changes on both the lower and upper end.
---
 .../Difficulty/TaikoPerformanceCalculator.cs                    | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Taiko/Difficulty/TaikoPerformanceCalculator.cs b/osu.Game.Rulesets.Taiko/Difficulty/TaikoPerformanceCalculator.cs
index a8122551ff..8d99fd3b87 100644
--- a/osu.Game.Rulesets.Taiko/Difficulty/TaikoPerformanceCalculator.cs
+++ b/osu.Game.Rulesets.Taiko/Difficulty/TaikoPerformanceCalculator.cs
@@ -59,7 +59,7 @@ namespace osu.Game.Rulesets.Taiko.Difficulty
 
         private double computeDifficultyValue(ScoreInfo score, TaikoDifficultyAttributes attributes)
         {
-            double difficultyValue = Math.Pow(5.0 * Math.Max(1.0, attributes.StarRating / 0.0075) - 4.0, 2.0) / 100000.0;
+            double difficultyValue = Math.Pow(5 * Math.Max(1.0, attributes.StarRating / 0.175) - 4.0, 2.25) / 450.0;
 
             double lengthBonus = 1 + 0.1 * Math.Min(1.0, totalHits / 1500.0);
             difficultyValue *= lengthBonus;

From 94294ba351c2c4609328da2ada403a37b89c55b7 Mon Sep 17 00:00:00 2001
From: Jay L <jaime@merkids.com>
Date: Mon, 16 May 2022 10:26:47 +1000
Subject: [PATCH 4859/5547] Apply Review Changes

---
 osu.Game.Rulesets.Taiko/Difficulty/Skills/Stamina.cs            | 2 +-
 osu.Game.Rulesets.Taiko/Difficulty/TaikoDifficultyCalculator.cs | 1 +
 2 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Taiko/Difficulty/Skills/Stamina.cs b/osu.Game.Rulesets.Taiko/Difficulty/Skills/Stamina.cs
index 6d4a1fd948..7846e97a65 100644
--- a/osu.Game.Rulesets.Taiko/Difficulty/Skills/Stamina.cs
+++ b/osu.Game.Rulesets.Taiko/Difficulty/Skills/Stamina.cs
@@ -14,7 +14,7 @@ namespace osu.Game.Rulesets.Taiko.Difficulty.Skills
     /// </summary>
     public class SingleKeyStamina
     {
-        private double previousHitTime = -1;
+        private double previousHitTime;
 
         /// <summary>
         /// Similar to <see cref="StrainDecaySkill.StrainValueOf(DifficultyHitObject)"/>
diff --git a/osu.Game.Rulesets.Taiko/Difficulty/TaikoDifficultyCalculator.cs b/osu.Game.Rulesets.Taiko/Difficulty/TaikoDifficultyCalculator.cs
index 5816b9957c..1aa31c6fe4 100644
--- a/osu.Game.Rulesets.Taiko/Difficulty/TaikoDifficultyCalculator.cs
+++ b/osu.Game.Rulesets.Taiko/Difficulty/TaikoDifficultyCalculator.cs
@@ -76,6 +76,7 @@ namespace osu.Game.Rulesets.Taiko.Difficulty
             double staminaPenalty = simpleColourPenalty(staminaRating, colourRating);
             staminaRating *= staminaPenalty;
 
+            //TODO : This is a temporary fix for the stamina rating of converts, due to their low colour variance.
             if (beatmap.BeatmapInfo.Ruleset.OnlineID == 0 && colourRating < 0.05)
             {
                 staminaPenalty *= 0.25;

From c7ec95c0d0d4416561ef622e134b1aef81ea285e Mon Sep 17 00:00:00 2001
From: Jay L <jaime@merkids.com>
Date: Mon, 16 May 2022 14:25:07 +1000
Subject: [PATCH 4860/5547] Rectify Review Changes

---
 osu.Game.Rulesets.Taiko/Difficulty/Skills/Stamina.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Rulesets.Taiko/Difficulty/Skills/Stamina.cs b/osu.Game.Rulesets.Taiko/Difficulty/Skills/Stamina.cs
index 7846e97a65..d54da8b869 100644
--- a/osu.Game.Rulesets.Taiko/Difficulty/Skills/Stamina.cs
+++ b/osu.Game.Rulesets.Taiko/Difficulty/Skills/Stamina.cs
@@ -14,14 +14,14 @@ namespace osu.Game.Rulesets.Taiko.Difficulty.Skills
     /// </summary>
     public class SingleKeyStamina
     {
-        private double previousHitTime;
+        private double? previousHitTime;
 
         /// <summary>
         /// Similar to <see cref="StrainDecaySkill.StrainValueOf(DifficultyHitObject)"/>
         /// </summary>
         public double StrainValueOf(DifficultyHitObject current)
         {
-            if (previousHitTime == -1)
+            if (previousHitTime == null)
             {
                 previousHitTime = current.StartTime;
                 return 0;

From db6abd86f03bc538fa2c3ffda98120b883f37d5c Mon Sep 17 00:00:00 2001
From: Jay L <jaime@merkids.com>
Date: Mon, 16 May 2022 14:48:39 +1000
Subject: [PATCH 4861/5547] Rectify null value call

tired programming is never a good idea
---
 osu.Game.Rulesets.Taiko/Difficulty/Skills/Stamina.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Taiko/Difficulty/Skills/Stamina.cs b/osu.Game.Rulesets.Taiko/Difficulty/Skills/Stamina.cs
index d54da8b869..744dafd57e 100644
--- a/osu.Game.Rulesets.Taiko/Difficulty/Skills/Stamina.cs
+++ b/osu.Game.Rulesets.Taiko/Difficulty/Skills/Stamina.cs
@@ -28,7 +28,7 @@ namespace osu.Game.Rulesets.Taiko.Difficulty.Skills
             }
 
             double objectStrain = 0.5;
-            objectStrain += speedBonus(current.StartTime - previousHitTime);
+            objectStrain += speedBonus(current.StartTime - previousHitTime.Value);
             previousHitTime = current.StartTime;
             return objectStrain;
         }

From 934bcaf82e8851415a44656151f30a1c9eb5ed7f Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Mon, 16 May 2022 14:22:30 +0900
Subject: [PATCH 4862/5547] Adjust tests

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

diff --git a/osu.Game.Rulesets.Taiko.Tests/TaikoDifficultyCalculatorTest.cs b/osu.Game.Rulesets.Taiko.Tests/TaikoDifficultyCalculatorTest.cs
index 226da7df09..51332a1ece 100644
--- a/osu.Game.Rulesets.Taiko.Tests/TaikoDifficultyCalculatorTest.cs
+++ b/osu.Game.Rulesets.Taiko.Tests/TaikoDifficultyCalculatorTest.cs
@@ -14,13 +14,13 @@ namespace osu.Game.Rulesets.Taiko.Tests
     {
         protected override string ResourceAssembly => "osu.Game.Rulesets.Taiko";
 
-        [TestCase(2.2420075288523802d, 200, "diffcalc-test")]
-        [TestCase(2.2420075288523802d, 200, "diffcalc-test-strong")]
+        [TestCase(1.9971301024093662d, 200, "diffcalc-test")]
+        [TestCase(1.9971301024093662d, 200, "diffcalc-test-strong")]
         public void Test(double expectedStarRating, int expectedMaxCombo, string name)
             => base.Test(expectedStarRating, expectedMaxCombo, name);
 
-        [TestCase(3.134084469440479d, 200, "diffcalc-test")]
-        [TestCase(3.134084469440479d, 200, "diffcalc-test-strong")]
+        [TestCase(3.1645810961313674d, 200, "diffcalc-test")]
+        [TestCase(3.1645810961313674d, 200, "diffcalc-test-strong")]
         public void TestClockRateAdjusted(double expectedStarRating, int expectedMaxCombo, string name)
             => Test(expectedStarRating, expectedMaxCombo, name, new TaikoModDoubleTime());
 

From bc294b81575b92a878c733ec9fe121cd93675ae7 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 17 May 2022 12:53:13 +0900
Subject: [PATCH 4863/5547] Add sentry tags for operating system and processor
 count

These would usually be in the log header, but right now that's not
conveyed. An example use case would be better understanding
https://sentry.ppy.sh/organizations/ppy/issues/846/?project=2&query=is%3Aunresolved&sort=freq&statsPeriod=14d,
where we currently don't know whether it is a desktop or mobile OS.
---
 osu.Game/Utils/SentryLogger.cs | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/osu.Game/Utils/SentryLogger.cs b/osu.Game/Utils/SentryLogger.cs
index 5390c666ed..137bf7e0aa 100644
--- a/osu.Game/Utils/SentryLogger.cs
+++ b/osu.Game/Utils/SentryLogger.cs
@@ -8,6 +8,7 @@ using System.Diagnostics;
 using System.IO;
 using System.Linq;
 using System.Net;
+using osu.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Logging;
@@ -160,6 +161,8 @@ namespace osu.Game.Utils
                     };
 
                     scope.SetTag(@"ruleset", ruleset.ShortName);
+                    scope.SetTag(@"os", $"{RuntimeInfo.OS} ({Environment.OSVersion})");
+                    scope.SetTag(@"processor count", Environment.ProcessorCount.ToString());
                 });
             }
             else

From 31137bebf8d414cdbcacce62e0365bc271999e6c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 17 May 2022 14:52:27 +0900
Subject: [PATCH 4864/5547] Revert realm to previous release to fix iOS crashes

---
 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 b984f528fe..e867de73f3 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -56,6 +56,6 @@
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
     <!-- Realm needs to be directly referenced in all Xamarin projects, as it will not pull in its transitive dependencies otherwise. -->
-    <PackageReference Include="Realm" Version="10.12.0" />
+    <PackageReference Include="Realm" Version="10.11.2" />
   </ItemGroup>
 </Project>
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 7f149b4e35..cd3a84a504 100644
--- a/osu.Game/osu.Game.csproj
+++ b/osu.Game/osu.Game.csproj
@@ -34,7 +34,7 @@
       <PrivateAssets>all</PrivateAssets>
       <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
     </PackageReference>
-    <PackageReference Include="Realm" Version="10.12.0" />
+    <PackageReference Include="Realm" Version="10.11.2" />
     <PackageReference Include="ppy.osu.Framework" Version="2022.511.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.513.0" />
     <PackageReference Include="Sentry" Version="3.17.1" />
diff --git a/osu.iOS.props b/osu.iOS.props
index 932421a705..1f677e54fd 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -89,6 +89,6 @@
     <PackageReference Include="NUnit" Version="3.13.3" />
     <PackageReference Include="System.ComponentModel.Annotations" Version="5.0.0" />
     <PackageReference Include="ppy.osu.Framework.NativeLibs" Version="2022.429.0" ExcludeAssets="all" />
-    <PackageReference Include="Realm" Version="10.12.0" />
+    <PackageReference Include="Realm" Version="10.11.2" />
   </ItemGroup>
 </Project>

From ef5b2233d7403f671a9ac9e13c708e1d02aef52c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 16 May 2022 19:21:19 +0900
Subject: [PATCH 4865/5547] Improve the first run progress button to show
 loading and completion status

---
 .../FirstRunSetup/ProgressRoundedButton.cs    | 103 ++++++++++++++++++
 .../Overlays/FirstRunSetup/ScreenBeatmaps.cs  |  45 +-------
 2 files changed, 106 insertions(+), 42 deletions(-)
 create mode 100644 osu.Game/Overlays/FirstRunSetup/ProgressRoundedButton.cs

diff --git a/osu.Game/Overlays/FirstRunSetup/ProgressRoundedButton.cs b/osu.Game/Overlays/FirstRunSetup/ProgressRoundedButton.cs
new file mode 100644
index 0000000000..ee2db1f3d4
--- /dev/null
+++ b/osu.Game/Overlays/FirstRunSetup/ProgressRoundedButton.cs
@@ -0,0 +1,103 @@
+// 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 enable
+using System;
+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.UserInterface;
+using osu.Game.Graphics.UserInterfaceV2;
+using osuTK;
+
+namespace osu.Game.Overlays.FirstRunSetup
+{
+    public class ProgressRoundedButton : RoundedButton
+    {
+        public new Action? Action;
+
+        [Resolved]
+        private OsuColour colours { get; set; } = null!;
+
+        private ProgressBar progressBar = null!;
+
+        private LoadingSpinner loading = null!;
+
+        private SpriteIcon tick = null!;
+
+        public ProgressRoundedButton()
+        {
+            base.Action = () =>
+            {
+                loading.Show();
+                Enabled.Value = false;
+
+                Action?.Invoke();
+            };
+        }
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            AddRange(new Drawable[]
+            {
+                progressBar = new ProgressBar(false)
+                {
+                    RelativeSizeAxes = Axes.Both,
+                    Blending = BlendingParameters.Additive,
+                    FillColour = BackgroundColour,
+                    Alpha = 0.5f,
+                    Depth = float.MinValue
+                },
+                new Container
+                {
+                    Anchor = Anchor.CentreRight,
+                    Origin = Anchor.CentreRight,
+                    Margin = new MarginPadding(15),
+                    Size = new Vector2(20),
+                    Children = new Drawable[]
+                    {
+                        loading = new LoadingSpinner
+                        {
+                            RelativeSizeAxes = Axes.Both,
+                            Size = Vector2.One,
+                        },
+                        tick = new SpriteIcon
+                        {
+                            Icon = FontAwesome.Solid.Check,
+                            RelativeSizeAxes = Axes.Both,
+                            Size = Vector2.One,
+                            Alpha = 0,
+                        }
+                    }
+                },
+            });
+        }
+
+        public void Complete()
+        {
+            loading.Hide();
+            tick.FadeIn(500, Easing.OutQuint);
+
+            Background.FadeColour(colours.Green, 500, Easing.OutQuint);
+            progressBar.FillColour = colours.Green;
+
+            this.TransformBindableTo(progressBar.Current, 1, 500, Easing.OutQuint);
+        }
+
+        public void Abort()
+        {
+            loading.Hide();
+            Enabled.Value = true;
+            this.TransformBindableTo(progressBar.Current, 0, 500, Easing.OutQuint);
+        }
+
+        public void SetProgress(double progress, bool animated)
+        {
+            this.TransformBindableTo(progressBar.Current, progress, animated ? 500 : 0, Easing.OutQuint);
+        }
+    }
+}
diff --git a/osu.Game/Overlays/FirstRunSetup/ScreenBeatmaps.cs b/osu.Game/Overlays/FirstRunSetup/ScreenBeatmaps.cs
index 66acdca8c7..f7615d5ce9 100644
--- a/osu.Game/Overlays/FirstRunSetup/ScreenBeatmaps.cs
+++ b/osu.Game/Overlays/FirstRunSetup/ScreenBeatmaps.cs
@@ -14,8 +14,6 @@ using osu.Game.Beatmaps.Drawables;
 using osu.Game.Database;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
-using osu.Game.Graphics.UserInterface;
-using osu.Game.Graphics.UserInterfaceV2;
 using osu.Game.Localisation;
 using osu.Game.Online;
 using osuTK;
@@ -127,7 +125,10 @@ namespace osu.Game.Overlays.FirstRunSetup
                             if (t.IsCompletedSuccessfully)
                                 importBeatmapsButton.Complete();
                             else
+                            {
                                 importBeatmapsButton.Enabled.Value = true;
+                                importBeatmapsButton.Abort();
+                            }
                         }));
                     }
                 },
@@ -214,45 +215,5 @@ namespace osu.Game.Overlays.FirstRunSetup
                     downloadBundledButton.SetProgress(progress, true);
             }
         }
-
-        private class ProgressRoundedButton : RoundedButton
-        {
-            [Resolved]
-            private OsuColour colours { get; set; } = null!;
-
-            private ProgressBar progressBar = null!;
-
-            protected override void LoadComplete()
-            {
-                base.LoadComplete();
-
-                Add(progressBar = new ProgressBar(false)
-                {
-                    RelativeSizeAxes = Axes.Both,
-                    Blending = BlendingParameters.Additive,
-                    FillColour = BackgroundColour,
-                    Alpha = 0.5f,
-                    Depth = float.MinValue
-                });
-            }
-
-            public void Complete()
-            {
-                Enabled.Value = false;
-
-                Background.FadeColour(colours.Green, 500, Easing.OutQuint);
-                progressBar.FillColour = colours.Green;
-
-                this.TransformBindableTo(progressBar.Current, 1, 500, Easing.OutQuint);
-            }
-
-            public void SetProgress(double progress, bool animated)
-            {
-                if (!Enabled.Value)
-                    return;
-
-                this.TransformBindableTo(progressBar.Current, progress, animated ? 500 : 0, Easing.OutQuint);
-            }
-        }
     }
 }

From 4412fec41a0fdc5ea7ff1c063dcbf0aff594210a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 16 May 2022 19:21:26 +0900
Subject: [PATCH 4866/5547] Add import from stable screen

---
 .../FirstRunSetupOverlayStrings.cs            |  10 ++
 .../Overlays/FirstRunSetup/ScreenBeatmaps.cs  |  34 +-----
 .../FirstRunSetup/ScreenImportFromStable.cs   | 105 ++++++++++++++++++
 osu.Game/Overlays/FirstRunSetupOverlay.cs     |  25 +++--
 4 files changed, 131 insertions(+), 43 deletions(-)
 create mode 100644 osu.Game/Overlays/FirstRunSetup/ScreenImportFromStable.cs

diff --git a/osu.Game/Localisation/FirstRunSetupOverlayStrings.cs b/osu.Game/Localisation/FirstRunSetupOverlayStrings.cs
index 91b427e2ca..6b5ca7534d 100644
--- a/osu.Game/Localisation/FirstRunSetupOverlayStrings.cs
+++ b/osu.Game/Localisation/FirstRunSetupOverlayStrings.cs
@@ -74,6 +74,16 @@ We recommend you give the new defaults a try, but if you'd like to have things f
         /// </summary>
         public static LocalisableString ClassicDefaults => new TranslatableString(getKey(@"classic_defaults"), @"Classic defaults");
 
+        /// <summary>
+        /// "Welcome"
+        /// </summary>
+        public static LocalisableString ImportTitle => new TranslatableString(getKey(@"import_title"), @"Import");
+
+        /// <summary>
+        /// "Import content from stable"
+        /// </summary>
+        public static LocalisableString ImportContentFromStable => new TranslatableString(getKey(@"import_content_from_stable"), @"Import content from osu!(stable)");
+
         private static string getKey(string key) => $@"{prefix}:{key}";
     }
 }
diff --git a/osu.Game/Overlays/FirstRunSetup/ScreenBeatmaps.cs b/osu.Game/Overlays/FirstRunSetup/ScreenBeatmaps.cs
index f7615d5ce9..17e04c0c99 100644
--- a/osu.Game/Overlays/FirstRunSetup/ScreenBeatmaps.cs
+++ b/osu.Game/Overlays/FirstRunSetup/ScreenBeatmaps.cs
@@ -25,7 +25,6 @@ namespace osu.Game.Overlays.FirstRunSetup
     public class ScreenBeatmaps : FirstRunSetupScreen
     {
         private ProgressRoundedButton downloadBundledButton = null!;
-        private ProgressRoundedButton importBeatmapsButton = null!;
         private ProgressRoundedButton downloadTutorialButton = null!;
 
         private OsuTextFlowContainer currentlyLoadedBeatmaps = null!;
@@ -41,8 +40,8 @@ namespace osu.Game.Overlays.FirstRunSetup
 
         private IDisposable? beatmapSubscription;
 
-        [BackgroundDependencyLoader(permitNulls: true)]
-        private void load(LegacyImportManager? legacyImportManager)
+        [BackgroundDependencyLoader]
+        private void load()
         {
             Vector2 buttonSize = new Vector2(400, 50);
 
@@ -104,35 +103,6 @@ namespace osu.Game.Overlays.FirstRunSetup
                     Action = downloadBundled
                 },
                 new OsuTextFlowContainer(cp => cp.Font = OsuFont.Default.With(size: CONTENT_FONT_SIZE))
-                {
-                    Colour = OverlayColourProvider.Content1,
-                    Text = "If you have an existing osu! install, you can also choose to import your existing beatmap collection.",
-                    RelativeSizeAxes = Axes.X,
-                    AutoSizeAxes = Axes.Y
-                },
-                importBeatmapsButton = new ProgressRoundedButton
-                {
-                    Size = buttonSize,
-                    Anchor = Anchor.TopCentre,
-                    Origin = Anchor.TopCentre,
-                    BackgroundColour = colours.Blue3,
-                    Text = MaintenanceSettingsStrings.ImportBeatmapsFromStable,
-                    Action = () =>
-                    {
-                        importBeatmapsButton.Enabled.Value = false;
-                        legacyImportManager?.ImportFromStableAsync(StableContent.Beatmaps).ContinueWith(t => Schedule(() =>
-                        {
-                            if (t.IsCompletedSuccessfully)
-                                importBeatmapsButton.Complete();
-                            else
-                            {
-                                importBeatmapsButton.Enabled.Value = true;
-                                importBeatmapsButton.Abort();
-                            }
-                        }));
-                    }
-                },
-                new OsuTextFlowContainer(cp => cp.Font = OsuFont.Default.With(size: CONTENT_FONT_SIZE))
                 {
                     Colour = OverlayColourProvider.Content1,
                     Text = FirstRunSetupBeatmapScreenStrings.ObtainMoreBeatmaps,
diff --git a/osu.Game/Overlays/FirstRunSetup/ScreenImportFromStable.cs b/osu.Game/Overlays/FirstRunSetup/ScreenImportFromStable.cs
new file mode 100644
index 0000000000..c55bb07295
--- /dev/null
+++ b/osu.Game/Overlays/FirstRunSetup/ScreenImportFromStable.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.
+
+#nullable enable
+
+using osu.Framework.Allocation;
+using osu.Framework.Graphics;
+using osu.Framework.Localisation;
+using osu.Game.Database;
+using osu.Game.Graphics;
+using osu.Game.Graphics.Containers;
+using osu.Game.Localisation;
+using osu.Game.Overlays.Settings;
+using osuTK;
+
+namespace osu.Game.Overlays.FirstRunSetup
+{
+    [LocalisableDescription(typeof(FirstRunSetupOverlayStrings), nameof(FirstRunSetupOverlayStrings.ImportTitle))]
+    public class ScreenImportFromStable : FirstRunSetupScreen
+    {
+        private ProgressRoundedButton importButton = null!;
+
+        private SettingsCheckbox checkboxSkins = null!;
+        private SettingsCheckbox checkboxBeatmaps = null!;
+        private SettingsCheckbox checkboxScores = null!;
+        private SettingsCheckbox checkboxCollections = null!;
+
+        [Resolved]
+        private OsuColour colours { get; set; } = null!;
+
+        [Resolved(canBeNull: true)]
+        private LegacyImportManager? legacyImportManager { get; set; }
+
+        [BackgroundDependencyLoader(permitNulls: true)]
+        private void load()
+        {
+            Vector2 buttonSize = new Vector2(400, 50);
+
+            Content.Children = new Drawable[]
+            {
+                new OsuTextFlowContainer(cp => cp.Font = OsuFont.Default.With(size: CONTENT_FONT_SIZE))
+                {
+                    Colour = OverlayColourProvider.Content1,
+                    Text =
+                        "If you have an installation of a previous osu! version, you can choose to migrate your existing content. Note that this will create a copy, and not affect your existing installation.",
+                    RelativeSizeAxes = Axes.X,
+                    AutoSizeAxes = Axes.Y
+                },
+                checkboxBeatmaps = new SettingsCheckbox
+                {
+                    LabelText = "Beatmaps",
+                    Current = { Value = true }
+                },
+                checkboxScores = new SettingsCheckbox
+                {
+                    LabelText = "Scores",
+                    Current = { Value = true }
+                },
+                checkboxSkins = new SettingsCheckbox
+                {
+                    LabelText = "Skins",
+                    Current = { Value = true }
+                },
+                checkboxCollections = new SettingsCheckbox
+                {
+                    LabelText = "Collections",
+                    Current = { Value = true }
+                },
+                importButton = new ProgressRoundedButton
+                {
+                    Size = buttonSize,
+                    Anchor = Anchor.TopCentre,
+                    Origin = Anchor.TopCentre,
+                    BackgroundColour = colours.Blue3,
+                    Text = FirstRunSetupOverlayStrings.ImportContentFromStable,
+                    Action = runImport
+                },
+            };
+        }
+
+        private void runImport()
+        {
+            importButton.Enabled.Value = false;
+
+            StableContent importableContent = 0;
+
+            if (checkboxBeatmaps.Current.Value) importableContent |= StableContent.Beatmaps;
+            if (checkboxScores.Current.Value) importableContent |= StableContent.Scores;
+            if (checkboxSkins.Current.Value) importableContent |= StableContent.Skins;
+            if (checkboxCollections.Current.Value) importableContent |= StableContent.Collections;
+
+            legacyImportManager?.ImportFromStableAsync(importableContent)
+                               .ContinueWith(t => Schedule(() =>
+                               {
+                                   if (t.IsCompletedSuccessfully)
+                                       importButton.Complete();
+                                   else
+                                   {
+                                       importButton.Enabled.Value = true;
+                                       importButton.Abort();
+                                   }
+                               }));
+        }
+    }
+}
diff --git a/osu.Game/Overlays/FirstRunSetupOverlay.cs b/osu.Game/Overlays/FirstRunSetupOverlay.cs
index cebb2f5e3b..dae2815e98 100644
--- a/osu.Game/Overlays/FirstRunSetupOverlay.cs
+++ b/osu.Game/Overlays/FirstRunSetupOverlay.cs
@@ -4,6 +4,7 @@
 #nullable enable
 
 using System;
+using System.Collections.Generic;
 using System.Diagnostics;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
@@ -17,6 +18,7 @@ using osu.Framework.Localisation;
 using osu.Framework.Screens;
 using osu.Framework.Threading;
 using osu.Game.Configuration;
+using osu.Game.Database;
 using osu.Game.Graphics;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Input.Bindings;
@@ -55,13 +57,7 @@ namespace osu.Game.Overlays
         /// </summary>
         public FirstRunSetupScreen? CurrentScreen => (FirstRunSetupScreen?)stack?.CurrentScreen;
 
-        private readonly Type[] steps =
-        {
-            typeof(ScreenWelcome),
-            typeof(ScreenBeatmaps),
-            typeof(ScreenUIScale),
-            typeof(ScreenBehaviour),
-        };
+        private readonly List<Type> steps = new List<Type>();
 
         private Container screenContent = null!;
 
@@ -77,9 +73,16 @@ namespace osu.Game.Overlays
         {
         }
 
-        [BackgroundDependencyLoader]
-        private void load(OsuColour colours)
+        [BackgroundDependencyLoader(permitNulls: true)]
+        private void load(OsuColour colours, LegacyImportManager? legacyImportManager)
         {
+            steps.Add(typeof(ScreenWelcome));
+            steps.Add(typeof(ScreenBeatmaps));
+            if (legacyImportManager?.SupportsImportFromStable == true)
+                steps.Add(typeof(ScreenImportFromStable));
+            steps.Add(typeof(ScreenUIScale));
+            steps.Add(typeof(ScreenBehaviour));
+
             Header.Title = FirstRunSetupOverlayStrings.FirstRunSetupTitle;
             Header.Description = FirstRunSetupOverlayStrings.FirstRunSetupDescription;
 
@@ -313,7 +316,7 @@ namespace osu.Game.Overlays
 
             currentStepIndex++;
 
-            if (currentStepIndex < steps.Length)
+            if (currentStepIndex < steps.Count)
             {
                 var nextScreen = (Screen)Activator.CreateInstance(steps[currentStepIndex.Value]);
 
@@ -345,7 +348,7 @@ namespace osu.Game.Overlays
                 return;
 
             bool isFirstStep = currentStepIndex == 0;
-            bool isLastStep = currentStepIndex == steps.Length - 1;
+            bool isLastStep = currentStepIndex == steps.Count - 1;
 
             if (isFirstStep)
             {

From 6448c97929d56ef86edb13a0808c58026fdfcbf8 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 16 May 2022 19:57:00 +0900
Subject: [PATCH 4867/5547] Allow retrieving count of available stable imports

---
 osu.Game/Collections/CollectionManager.cs | 12 ++++++++++++
 osu.Game/Database/LegacyImportManager.cs  | 23 +++++++++++++++++++++++
 osu.Game/Database/LegacyModelImporter.cs  |  2 ++
 3 files changed, 37 insertions(+)

diff --git a/osu.Game/Collections/CollectionManager.cs b/osu.Game/Collections/CollectionManager.cs
index 5845e0d4d1..700b0f5dcb 100644
--- a/osu.Game/Collections/CollectionManager.cs
+++ b/osu.Game/Collections/CollectionManager.cs
@@ -111,6 +111,18 @@ namespace osu.Game.Collections
 
         public Action<Notification> PostNotification { protected get; set; }
 
+        public Task<int> GetAvailableCount(StableStorage stableStorage)
+        {
+            if (!stableStorage.Exists(database_name))
+                return Task.FromResult(0);
+
+            return Task.Run(() =>
+            {
+                using (var stream = stableStorage.GetStream(database_name))
+                    return readCollections(stream).Count;
+            });
+        }
+
         /// <summary>
         /// This is a temporary method and will likely be replaced by a full-fledged (and more correctly placed) migration process in the future.
         /// </summary>
diff --git a/osu.Game/Database/LegacyImportManager.cs b/osu.Game/Database/LegacyImportManager.cs
index 59394c2952..a9f37fe4a7 100644
--- a/osu.Game/Database/LegacyImportManager.cs
+++ b/osu.Game/Database/LegacyImportManager.cs
@@ -49,6 +49,29 @@ namespace osu.Game.Database
 
         public bool SupportsImportFromStable => RuntimeInfo.IsDesktop;
 
+        public async Task<int> GetImportCount(StableContent content)
+        {
+            var stableStorage = await getStableStorage().ConfigureAwait(false);
+
+            switch (content)
+            {
+                case StableContent.Beatmaps:
+                    return await new LegacyBeatmapImporter(beatmaps).GetAvailableCount(stableStorage);
+
+                case StableContent.Skins:
+                    return await new LegacySkinImporter(skins).GetAvailableCount(stableStorage);
+
+                case StableContent.Collections:
+                    return await collections.GetAvailableCount(stableStorage);
+
+                case StableContent.Scores:
+                    return await new LegacyScoreImporter(scores).GetAvailableCount(stableStorage);
+
+                default:
+                    throw new ArgumentException($"Only one {nameof(StableContent)} flag should be specified.");
+            }
+        }
+
         public async Task ImportFromStableAsync(StableContent content)
         {
             var stableStorage = await getStableStorage().ConfigureAwait(false);
diff --git a/osu.Game/Database/LegacyModelImporter.cs b/osu.Game/Database/LegacyModelImporter.cs
index d85fb5aab2..a6e0f5bf8b 100644
--- a/osu.Game/Database/LegacyModelImporter.cs
+++ b/osu.Game/Database/LegacyModelImporter.cs
@@ -34,6 +34,8 @@ namespace osu.Game.Database
             Importer = importer;
         }
 
+        public Task<int> GetAvailableCount(StableStorage stableStorage) => Task.Run(() => GetStableImportPaths(stableStorage).Count());
+
         public Task ImportFromStableAsync(StableStorage stableStorage)
         {
             var storage = PrepareStableStorage(stableStorage);

From 1666d13d262455c2323fe097f1d4bfbde0006675 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 16 May 2022 20:13:34 +0900
Subject: [PATCH 4868/5547] Add item counts to import screen

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

diff --git a/osu.Game/Overlays/FirstRunSetup/ScreenImportFromStable.cs b/osu.Game/Overlays/FirstRunSetup/ScreenImportFromStable.cs
index c55bb07295..42a10854e8 100644
--- a/osu.Game/Overlays/FirstRunSetup/ScreenImportFromStable.cs
+++ b/osu.Game/Overlays/FirstRunSetup/ScreenImportFromStable.cs
@@ -4,6 +4,7 @@
 #nullable enable
 
 using osu.Framework.Allocation;
+using osu.Framework.Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Localisation;
 using osu.Game.Database;
@@ -28,8 +29,8 @@ namespace osu.Game.Overlays.FirstRunSetup
         [Resolved]
         private OsuColour colours { get; set; } = null!;
 
-        [Resolved(canBeNull: true)]
-        private LegacyImportManager? legacyImportManager { get; set; }
+        [Resolved]
+        private LegacyImportManager legacyImportManager { get; set; } = null!;
 
         [BackgroundDependencyLoader(permitNulls: true)]
         private void load()
@@ -76,6 +77,11 @@ namespace osu.Game.Overlays.FirstRunSetup
                     Action = runImport
                 },
             };
+
+            legacyImportManager.GetImportCount(StableContent.Beatmaps).ContinueWith(task => Schedule(() => checkboxBeatmaps.LabelText += $" ({task.GetResultSafely()} items)"));
+            legacyImportManager.GetImportCount(StableContent.Scores).ContinueWith(task => Schedule(() => checkboxScores.LabelText += $" ({task.GetResultSafely()} items)"));
+            legacyImportManager.GetImportCount(StableContent.Skins).ContinueWith(task => Schedule(() => checkboxSkins.LabelText += $" ({task.GetResultSafely()} items)"));
+            legacyImportManager.GetImportCount(StableContent.Collections).ContinueWith(task => Schedule(() => checkboxCollections.LabelText += $" ({task.GetResultSafely()} items)"));
         }
 
         private void runImport()
@@ -89,7 +95,7 @@ namespace osu.Game.Overlays.FirstRunSetup
             if (checkboxSkins.Current.Value) importableContent |= StableContent.Skins;
             if (checkboxCollections.Current.Value) importableContent |= StableContent.Collections;
 
-            legacyImportManager?.ImportFromStableAsync(importableContent)
+            legacyImportManager.ImportFromStableAsync(importableContent)
                                .ContinueWith(t => Schedule(() =>
                                {
                                    if (t.IsCompletedSuccessfully)

From 13e70eab515c2aeacec660fdf978908deb93e399 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 16 May 2022 20:37:38 +0900
Subject: [PATCH 4869/5547] Allow cancellation of count operations and
 bypassing interactive location logic

---
 osu.Game/Database/LegacyImportManager.cs      | 35 +++++---
 .../FirstRunSetup/ScreenImportFromStable.cs   | 87 +++++++++++++++++--
 2 files changed, 107 insertions(+), 15 deletions(-)

diff --git a/osu.Game/Database/LegacyImportManager.cs b/osu.Game/Database/LegacyImportManager.cs
index a9f37fe4a7..9c436e8903 100644
--- a/osu.Game/Database/LegacyImportManager.cs
+++ b/osu.Game/Database/LegacyImportManager.cs
@@ -3,6 +3,7 @@
 
 using System;
 using System.Collections.Generic;
+using System.Threading;
 using System.Threading.Tasks;
 using osu.Framework;
 using osu.Framework.Allocation;
@@ -49,9 +50,14 @@ namespace osu.Game.Database
 
         public bool SupportsImportFromStable => RuntimeInfo.IsDesktop;
 
-        public async Task<int> GetImportCount(StableContent content)
+        public async Task<int> GetImportCount(StableContent content, CancellationToken cancellationToken)
         {
-            var stableStorage = await getStableStorage().ConfigureAwait(false);
+            var stableStorage = GetCurrentStableStorage();
+
+            if (stableStorage == null)
+                return 0;
+
+            cancellationToken.ThrowIfCancellationRequested();
 
             switch (content)
             {
@@ -72,9 +78,22 @@ namespace osu.Game.Database
             }
         }
 
-        public async Task ImportFromStableAsync(StableContent content)
+        public async Task ImportFromStableAsync(StableContent content, bool interactiveLocateIfNotFound = true)
         {
-            var stableStorage = await getStableStorage().ConfigureAwait(false);
+            var stableStorage = GetCurrentStableStorage();
+
+            if (stableStorage == null)
+            {
+                if (!interactiveLocateIfNotFound)
+                    return;
+
+                var taskCompletionSource = new TaskCompletionSource<string>(TaskCreationOptions.RunContinuationsAsynchronously);
+                Schedule(() => dialogOverlay.Push(new StableDirectoryLocationDialog(taskCompletionSource)));
+                string stablePath = await taskCompletionSource.Task.ConfigureAwait(false);
+
+                stableStorage = cachedStorage = new StableStorage(stablePath, desktopGameHost);
+            }
+
             var importTasks = new List<Task>();
 
             Task beatmapImportTask = Task.CompletedTask;
@@ -93,7 +112,7 @@ namespace osu.Game.Database
             await Task.WhenAll(importTasks.ToArray()).ConfigureAwait(false);
         }
 
-        private async Task<StableStorage> getStableStorage()
+        public StableStorage GetCurrentStableStorage()
         {
             if (cachedStorage != null)
                 return cachedStorage;
@@ -102,11 +121,7 @@ namespace osu.Game.Database
             if (stableStorage != null)
                 return cachedStorage = stableStorage;
 
-            var taskCompletionSource = new TaskCompletionSource<string>(TaskCreationOptions.RunContinuationsAsynchronously);
-            Schedule(() => dialogOverlay.Push(new StableDirectoryLocationDialog(taskCompletionSource)));
-            string stablePath = await taskCompletionSource.Task.ConfigureAwait(false);
-
-            return cachedStorage = new StableStorage(stablePath, desktopGameHost);
+            return null;
         }
     }
 
diff --git a/osu.Game/Overlays/FirstRunSetup/ScreenImportFromStable.cs b/osu.Game/Overlays/FirstRunSetup/ScreenImportFromStable.cs
index 42a10854e8..e31f70b686 100644
--- a/osu.Game/Overlays/FirstRunSetup/ScreenImportFromStable.cs
+++ b/osu.Game/Overlays/FirstRunSetup/ScreenImportFromStable.cs
@@ -3,6 +3,8 @@
 
 #nullable enable
 
+using System.Linq;
+using System.Threading;
 using osu.Framework.Allocation;
 using osu.Framework.Extensions;
 using osu.Framework.Graphics;
@@ -10,6 +12,7 @@ using osu.Framework.Localisation;
 using osu.Game.Database;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
+using osu.Game.Graphics.UserInterfaceV2;
 using osu.Game.Localisation;
 using osu.Game.Overlays.Settings;
 using osuTK;
@@ -26,12 +29,16 @@ namespace osu.Game.Overlays.FirstRunSetup
         private SettingsCheckbox checkboxScores = null!;
         private SettingsCheckbox checkboxCollections = null!;
 
+        private OsuTextFlowContainer currentStablePath = null!;
+
         [Resolved]
         private OsuColour colours { get; set; } = null!;
 
         [Resolved]
         private LegacyImportManager legacyImportManager { get; set; } = null!;
 
+        private CancellationTokenSource? stablePathUpdateCancellation;
+
         [BackgroundDependencyLoader(permitNulls: true)]
         private void load()
         {
@@ -47,6 +54,21 @@ namespace osu.Game.Overlays.FirstRunSetup
                     RelativeSizeAxes = Axes.X,
                     AutoSizeAxes = Axes.Y
                 },
+                currentStablePath = new OsuTextFlowContainer(cp => cp.Font = OsuFont.Default.With(size: HEADER_FONT_SIZE, weight: FontWeight.SemiBold))
+                {
+                    Colour = OverlayColourProvider.Content2,
+                    RelativeSizeAxes = Axes.X,
+                    AutoSizeAxes = Axes.Y,
+                },
+                new RoundedButton
+                {
+                    Size = buttonSize,
+                    Anchor = Anchor.TopCentre,
+                    Origin = Anchor.TopCentre,
+                    BackgroundColour = colours.Blue3,
+                    Text = "Locate osu!(stable) install",
+                    Action = locateStable,
+                },
                 checkboxBeatmaps = new SettingsCheckbox
                 {
                     LabelText = "Beatmaps",
@@ -78,10 +100,65 @@ namespace osu.Game.Overlays.FirstRunSetup
                 },
             };
 
-            legacyImportManager.GetImportCount(StableContent.Beatmaps).ContinueWith(task => Schedule(() => checkboxBeatmaps.LabelText += $" ({task.GetResultSafely()} items)"));
-            legacyImportManager.GetImportCount(StableContent.Scores).ContinueWith(task => Schedule(() => checkboxScores.LabelText += $" ({task.GetResultSafely()} items)"));
-            legacyImportManager.GetImportCount(StableContent.Skins).ContinueWith(task => Schedule(() => checkboxSkins.LabelText += $" ({task.GetResultSafely()} items)"));
-            legacyImportManager.GetImportCount(StableContent.Collections).ContinueWith(task => Schedule(() => checkboxCollections.LabelText += $" ({task.GetResultSafely()} items)"));
+            updateStablePath();
+        }
+
+        private void locateStable()
+        {
+            legacyImportManager.ImportFromStableAsync(0).ContinueWith(task =>
+            {
+                Schedule(updateStablePath);
+            });
+        }
+
+        private void updateStablePath()
+        {
+            stablePathUpdateCancellation?.Cancel();
+
+            var storage = legacyImportManager.GetCurrentStableStorage();
+
+            if (storage == null)
+            {
+                foreach (var c in Content.Children.OfType<SettingsCheckbox>())
+                    c.Current.Disabled = true;
+                currentStablePath.Text = "No installation found";
+                return;
+            }
+
+            foreach (var c in Content.Children.OfType<SettingsCheckbox>())
+                c.Current.Disabled = false;
+
+            currentStablePath.Text = storage.GetFullPath(string.Empty);
+            stablePathUpdateCancellation = new CancellationTokenSource();
+
+            legacyImportManager.GetImportCount(StableContent.Beatmaps, stablePathUpdateCancellation.Token).ContinueWith(task => Schedule(() =>
+            {
+                if (task.IsCanceled)
+                    return;
+
+                checkboxBeatmaps.LabelText = $"Beatmaps ({task.GetResultSafely()} items)";
+            }));
+            legacyImportManager.GetImportCount(StableContent.Scores, stablePathUpdateCancellation.Token).ContinueWith(task => Schedule(() =>
+            {
+                if (task.IsCanceled)
+                    return;
+
+                checkboxScores.LabelText = $"Scores ({task.GetResultSafely()} items)";
+            }));
+            legacyImportManager.GetImportCount(StableContent.Skins, stablePathUpdateCancellation.Token).ContinueWith(task => Schedule(() =>
+            {
+                if (task.IsCanceled)
+                    return;
+
+                checkboxSkins.LabelText = $"Skins ({task.GetResultSafely()} items)";
+            }));
+            legacyImportManager.GetImportCount(StableContent.Collections, stablePathUpdateCancellation.Token).ContinueWith(task => Schedule(() =>
+            {
+                if (task.IsCanceled)
+                    return;
+
+                checkboxCollections.LabelText = $"Collections ({task.GetResultSafely()} items)";
+            }));
         }
 
         private void runImport()
@@ -95,7 +172,7 @@ namespace osu.Game.Overlays.FirstRunSetup
             if (checkboxSkins.Current.Value) importableContent |= StableContent.Skins;
             if (checkboxCollections.Current.Value) importableContent |= StableContent.Collections;
 
-            legacyImportManager.ImportFromStableAsync(importableContent)
+            legacyImportManager.ImportFromStableAsync(importableContent, false)
                                .ContinueWith(t => Schedule(() =>
                                {
                                    if (t.IsCompletedSuccessfully)

From 1593f05ff37c34bad7cc25b2f3d0d9ad9c84738d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 16 May 2022 20:53:04 +0900
Subject: [PATCH 4870/5547] Tidy up checkbox implementation

---
 .../FirstRunSetup/ScreenImportFromStable.cs   | 134 ++++++++----------
 1 file changed, 63 insertions(+), 71 deletions(-)

diff --git a/osu.Game/Overlays/FirstRunSetup/ScreenImportFromStable.cs b/osu.Game/Overlays/FirstRunSetup/ScreenImportFromStable.cs
index e31f70b686..dd3580508a 100644
--- a/osu.Game/Overlays/FirstRunSetup/ScreenImportFromStable.cs
+++ b/osu.Game/Overlays/FirstRunSetup/ScreenImportFromStable.cs
@@ -3,6 +3,7 @@
 
 #nullable enable
 
+using System.Collections.Generic;
 using System.Linq;
 using System.Threading;
 using osu.Framework.Allocation;
@@ -24,11 +25,6 @@ namespace osu.Game.Overlays.FirstRunSetup
     {
         private ProgressRoundedButton importButton = null!;
 
-        private SettingsCheckbox checkboxSkins = null!;
-        private SettingsCheckbox checkboxBeatmaps = null!;
-        private SettingsCheckbox checkboxScores = null!;
-        private SettingsCheckbox checkboxCollections = null!;
-
         private OsuTextFlowContainer currentStablePath = null!;
 
         [Resolved]
@@ -39,6 +35,8 @@ namespace osu.Game.Overlays.FirstRunSetup
 
         private CancellationTokenSource? stablePathUpdateCancellation;
 
+        private IEnumerable<ImportCheckbox> contentCheckboxes => Content.Children.OfType<ImportCheckbox>();
+
         [BackgroundDependencyLoader(permitNulls: true)]
         private void load()
         {
@@ -69,26 +67,10 @@ namespace osu.Game.Overlays.FirstRunSetup
                     Text = "Locate osu!(stable) install",
                     Action = locateStable,
                 },
-                checkboxBeatmaps = new SettingsCheckbox
-                {
-                    LabelText = "Beatmaps",
-                    Current = { Value = true }
-                },
-                checkboxScores = new SettingsCheckbox
-                {
-                    LabelText = "Scores",
-                    Current = { Value = true }
-                },
-                checkboxSkins = new SettingsCheckbox
-                {
-                    LabelText = "Skins",
-                    Current = { Value = true }
-                },
-                checkboxCollections = new SettingsCheckbox
-                {
-                    LabelText = "Collections",
-                    Current = { Value = true }
-                },
+                new ImportCheckbox("Beatmaps", StableContent.Beatmaps),
+                new ImportCheckbox("Scores", StableContent.Scores),
+                new ImportCheckbox("Skins", StableContent.Skins),
+                new ImportCheckbox("Collections", StableContent.Collections),
                 importButton = new ProgressRoundedButton
                 {
                     Size = buttonSize,
@@ -119,46 +101,20 @@ namespace osu.Game.Overlays.FirstRunSetup
 
             if (storage == null)
             {
-                foreach (var c in Content.Children.OfType<SettingsCheckbox>())
+                foreach (var c in contentCheckboxes)
                     c.Current.Disabled = true;
                 currentStablePath.Text = "No installation found";
                 return;
             }
 
-            foreach (var c in Content.Children.OfType<SettingsCheckbox>())
+            foreach (var c in contentCheckboxes)
+            {
                 c.Current.Disabled = false;
+                c.UpdateCount();
+            }
 
             currentStablePath.Text = storage.GetFullPath(string.Empty);
             stablePathUpdateCancellation = new CancellationTokenSource();
-
-            legacyImportManager.GetImportCount(StableContent.Beatmaps, stablePathUpdateCancellation.Token).ContinueWith(task => Schedule(() =>
-            {
-                if (task.IsCanceled)
-                    return;
-
-                checkboxBeatmaps.LabelText = $"Beatmaps ({task.GetResultSafely()} items)";
-            }));
-            legacyImportManager.GetImportCount(StableContent.Scores, stablePathUpdateCancellation.Token).ContinueWith(task => Schedule(() =>
-            {
-                if (task.IsCanceled)
-                    return;
-
-                checkboxScores.LabelText = $"Scores ({task.GetResultSafely()} items)";
-            }));
-            legacyImportManager.GetImportCount(StableContent.Skins, stablePathUpdateCancellation.Token).ContinueWith(task => Schedule(() =>
-            {
-                if (task.IsCanceled)
-                    return;
-
-                checkboxSkins.LabelText = $"Skins ({task.GetResultSafely()} items)";
-            }));
-            legacyImportManager.GetImportCount(StableContent.Collections, stablePathUpdateCancellation.Token).ContinueWith(task => Schedule(() =>
-            {
-                if (task.IsCanceled)
-                    return;
-
-                checkboxCollections.LabelText = $"Collections ({task.GetResultSafely()} items)";
-            }));
         }
 
         private void runImport()
@@ -167,22 +123,58 @@ namespace osu.Game.Overlays.FirstRunSetup
 
             StableContent importableContent = 0;
 
-            if (checkboxBeatmaps.Current.Value) importableContent |= StableContent.Beatmaps;
-            if (checkboxScores.Current.Value) importableContent |= StableContent.Scores;
-            if (checkboxSkins.Current.Value) importableContent |= StableContent.Skins;
-            if (checkboxCollections.Current.Value) importableContent |= StableContent.Collections;
+            foreach (var c in contentCheckboxes.Where(c => c.Current.Value))
+                importableContent |= c.StableContent;
 
-            legacyImportManager.ImportFromStableAsync(importableContent, false)
-                               .ContinueWith(t => Schedule(() =>
-                               {
-                                   if (t.IsCompletedSuccessfully)
-                                       importButton.Complete();
-                                   else
-                                   {
-                                       importButton.Enabled.Value = true;
-                                       importButton.Abort();
-                                   }
-                               }));
+            legacyImportManager.ImportFromStableAsync(importableContent, false).ContinueWith(t => Schedule(() =>
+            {
+                if (t.IsCompletedSuccessfully)
+                    importButton.Complete();
+                else
+                {
+                    importButton.Enabled.Value = true;
+                    importButton.Abort();
+                }
+            }));
+        }
+
+        private class ImportCheckbox : SettingsCheckbox
+        {
+            public readonly StableContent StableContent;
+
+            private readonly LocalisableString title;
+
+            [Resolved]
+            private LegacyImportManager legacyImportManager { get; set; } = null!;
+
+            private CancellationTokenSource? countUpdateCancellation;
+
+            public ImportCheckbox(LocalisableString title, StableContent stableContent)
+            {
+                this.title = title;
+
+                StableContent = stableContent;
+
+                Current.Value = true;
+
+                LabelText = title;
+            }
+
+            public void UpdateCount()
+            {
+                LabelText = LocalisableString.Interpolate($"{title} (calculating...)");
+
+                countUpdateCancellation?.Cancel();
+                countUpdateCancellation = new CancellationTokenSource();
+
+                legacyImportManager.GetImportCount(StableContent, countUpdateCancellation.Token).ContinueWith(task => Schedule(() =>
+                {
+                    if (task.IsCanceled)
+                        return;
+
+                    LabelText = LocalisableString.Interpolate($"{title} ({task.GetResultSafely()} items)");
+                }));
+            }
         }
     }
 }

From 4af1a788d14fadffcbd98953a769aacdd5b87d6a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 16 May 2022 21:07:42 +0900
Subject: [PATCH 4871/5547] Add locate stable button / screen

---
 osu.Game/Database/LegacyImportManager.cs      |   5 +-
 .../FirstRunSetup/FirstRunSetupScreen.cs      |   4 +-
 .../FirstRunSetup/ScreenImportFromStable.cs   | 134 +++++++++++++++++-
 3 files changed, 136 insertions(+), 7 deletions(-)

diff --git a/osu.Game/Database/LegacyImportManager.cs b/osu.Game/Database/LegacyImportManager.cs
index 9c436e8903..35b1d05fa1 100644
--- a/osu.Game/Database/LegacyImportManager.cs
+++ b/osu.Game/Database/LegacyImportManager.cs
@@ -50,6 +50,8 @@ namespace osu.Game.Database
 
         public bool SupportsImportFromStable => RuntimeInfo.IsDesktop;
 
+        public void UpdateStorage(string stablePath) => cachedStorage = new StableStorage(stablePath, desktopGameHost);
+
         public async Task<int> GetImportCount(StableContent content, CancellationToken cancellationToken)
         {
             var stableStorage = GetCurrentStableStorage();
@@ -91,7 +93,8 @@ namespace osu.Game.Database
                 Schedule(() => dialogOverlay.Push(new StableDirectoryLocationDialog(taskCompletionSource)));
                 string stablePath = await taskCompletionSource.Task.ConfigureAwait(false);
 
-                stableStorage = cachedStorage = new StableStorage(stablePath, desktopGameHost);
+                UpdateStorage(stablePath);
+                stableStorage = GetCurrentStableStorage();
             }
 
             var importTasks = new List<Task>();
diff --git a/osu.Game/Overlays/FirstRunSetup/FirstRunSetupScreen.cs b/osu.Game/Overlays/FirstRunSetup/FirstRunSetupScreen.cs
index d1ea91e51a..b043f05bd8 100644
--- a/osu.Game/Overlays/FirstRunSetup/FirstRunSetupScreen.cs
+++ b/osu.Game/Overlays/FirstRunSetup/FirstRunSetupScreen.cs
@@ -21,6 +21,8 @@ namespace osu.Game.Overlays.FirstRunSetup
 
         protected const float CONTENT_FONT_SIZE = 16;
 
+        protected const float CONTENT_PADDING = 30;
+
         protected const float HEADER_FONT_SIZE = 24;
 
         [Resolved]
@@ -41,7 +43,7 @@ namespace osu.Game.Overlays.FirstRunSetup
                     {
                         RelativeSizeAxes = Axes.X,
                         AutoSizeAxes = Axes.Y,
-                        Padding = new MarginPadding { Horizontal = 30 },
+                        Padding = new MarginPadding { Horizontal = CONTENT_PADDING },
                         Children = new Drawable[]
                         {
                             new OsuSpriteText
diff --git a/osu.Game/Overlays/FirstRunSetup/ScreenImportFromStable.cs b/osu.Game/Overlays/FirstRunSetup/ScreenImportFromStable.cs
index dd3580508a..acc0fdbb7c 100644
--- a/osu.Game/Overlays/FirstRunSetup/ScreenImportFromStable.cs
+++ b/osu.Game/Overlays/FirstRunSetup/ScreenImportFromStable.cs
@@ -4,19 +4,24 @@
 #nullable enable
 
 using System.Collections.Generic;
+using System.IO;
 using System.Linq;
 using System.Threading;
 using osu.Framework.Allocation;
 using osu.Framework.Extensions;
 using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
 using osu.Framework.Localisation;
+using osu.Framework.Screens;
 using osu.Game.Database;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.UserInterfaceV2;
+using osu.Game.IO;
 using osu.Game.Localisation;
 using osu.Game.Overlays.Settings;
 using osuTK;
+using CommonStrings = osu.Game.Resources.Localisation.Web.CommonStrings;
 
 namespace osu.Game.Overlays.FirstRunSetup
 {
@@ -24,6 +29,7 @@ namespace osu.Game.Overlays.FirstRunSetup
     public class ScreenImportFromStable : FirstRunSetupScreen
     {
         private ProgressRoundedButton importButton = null!;
+        private RoundedButton locateStableButton = null!;
 
         private OsuTextFlowContainer currentStablePath = null!;
 
@@ -58,7 +64,7 @@ namespace osu.Game.Overlays.FirstRunSetup
                     RelativeSizeAxes = Axes.X,
                     AutoSizeAxes = Axes.Y,
                 },
-                new RoundedButton
+                locateStableButton = new RoundedButton
                 {
                     Size = buttonSize,
                     Anchor = Anchor.TopCentre,
@@ -85,12 +91,15 @@ namespace osu.Game.Overlays.FirstRunSetup
             updateStablePath();
         }
 
-        private void locateStable()
+        private void locateStable() => this.Push(new LocateStableScreen());
+
+        public override void OnResuming(ScreenTransitionEvent e)
         {
-            legacyImportManager.ImportFromStableAsync(0).ContinueWith(task =>
-            {
+            base.OnResuming(e);
+
+            if (e.Last is LocateStableScreen)
+                // stable storage may have changed.
                 Schedule(updateStablePath);
-            });
         }
 
         private void updateStablePath()
@@ -120,6 +129,7 @@ namespace osu.Game.Overlays.FirstRunSetup
         private void runImport()
         {
             importButton.Enabled.Value = false;
+            locateStableButton.Enabled.Value = false;
 
             StableContent importableContent = 0;
 
@@ -128,6 +138,8 @@ namespace osu.Game.Overlays.FirstRunSetup
 
             legacyImportManager.ImportFromStableAsync(importableContent, false).ContinueWith(t => Schedule(() =>
             {
+                locateStableButton.Enabled.Value = true;
+
                 if (t.IsCompletedSuccessfully)
                     importButton.Complete();
                 else
@@ -176,5 +188,117 @@ namespace osu.Game.Overlays.FirstRunSetup
                 }));
             }
         }
+
+        private class LocateStableScreen : FirstRunSetupScreen
+        {
+            private RoundedButton selectionButton = null!;
+
+            private OsuDirectorySelector directorySelector = null!;
+
+            protected bool IsValidDirectory(DirectoryInfo? info) => info?.GetFiles("osu!.*.cfg").Any() ?? false;
+
+            public LocalisableString HeaderText => "Please select your osu!stable install location";
+
+            [BackgroundDependencyLoader]
+            private void load(OsuColour colours)
+            {
+                // Don't want the scroll content provided by `FirstRunSetupScreen` so we don't use `Content`.
+                InternalChild = new Container
+                {
+                    RelativeSizeAxes = Axes.Both,
+                    Padding = new MarginPadding { Horizontal = CONTENT_PADDING },
+                    Children = new Drawable[]
+                    {
+                        new GridContainer
+                        {
+                            RelativeSizeAxes = Axes.Both,
+                            RowDimensions = new[]
+                            {
+                                new Dimension(GridSizeMode.AutoSize),
+                                new Dimension(),
+                                new Dimension(GridSizeMode.AutoSize),
+                            },
+                            Content = new[]
+                            {
+                                new Drawable[]
+                                {
+                                    new OsuTextFlowContainer(cp =>
+                                    {
+                                        cp.Font = OsuFont.Default.With(size: 24);
+                                    })
+                                    {
+                                        Text = HeaderText,
+                                        TextAnchor = Anchor.TopCentre,
+                                        Margin = new MarginPadding(10),
+                                        RelativeSizeAxes = Axes.X,
+                                        AutoSizeAxes = Axes.Y,
+                                    }
+                                },
+                                new Drawable[]
+                                {
+                                    directorySelector = new OsuDirectorySelector
+                                    {
+                                        RelativeSizeAxes = Axes.Both,
+                                    }
+                                },
+                                new Drawable[]
+                                {
+                                    new Container
+                                    {
+                                        RelativeSizeAxes = Axes.X,
+                                        AutoSizeAxes = Axes.Y,
+                                        Children = new Drawable[]
+                                        {
+                                            new RoundedButton
+                                            {
+                                                Anchor = Anchor.CentreLeft,
+                                                Origin = Anchor.CentreLeft,
+                                                Width = 300,
+                                                Margin = new MarginPadding(10),
+                                                Colour = colours.Pink2,
+                                                Text = CommonStrings.ButtonsCancel,
+                                                Action = this.Exit
+                                            },
+                                            selectionButton = new RoundedButton
+                                            {
+                                                Anchor = Anchor.CentreRight,
+                                                Origin = Anchor.CentreRight,
+                                                Width = 300,
+                                                Margin = new MarginPadding(10),
+                                                Text = MaintenanceSettingsStrings.SelectDirectory,
+                                                Action = () =>
+                                                {
+                                                    legacyImportManager.UpdateStorage(directorySelector.CurrentPath.Value.FullName);
+                                                    this.Exit();
+                                                }
+                                            },
+                                        }
+                                    },
+                                }
+                            }
+                        }
+                    }
+                };
+            }
+
+            [Resolved]
+            private LegacyImportManager legacyImportManager { get; set; } = null!;
+
+            protected override void LoadComplete()
+            {
+                if (legacyImportManager.GetCurrentStableStorage() is StableStorage storage)
+                    directorySelector.CurrentPath.Value = new DirectoryInfo(storage.GetFullPath(string.Empty));
+
+                directorySelector.CurrentPath.BindValueChanged(e => selectionButton.Enabled.Value = e.NewValue != null && IsValidDirectory(e.NewValue), true);
+                base.LoadComplete();
+            }
+
+            public override void OnSuspending(ScreenTransitionEvent e)
+            {
+                base.OnSuspending(e);
+
+                this.FadeOut(250);
+            }
+        }
     }
 }

From 98e5ad44a71a090476a55ba40d7a0dfbb67cc327 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 16 May 2022 21:24:36 +0900
Subject: [PATCH 4872/5547] Add `OverlayColourProvider` support to
 `OsuDirectorySelector`

---
 .../UserInterfaceV2/OsuDirectorySelectorDirectory.cs       | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Graphics/UserInterfaceV2/OsuDirectorySelectorDirectory.cs b/osu.Game/Graphics/UserInterfaceV2/OsuDirectorySelectorDirectory.cs
index ce2e7794a9..456bde6d1b 100644
--- a/osu.Game/Graphics/UserInterfaceV2/OsuDirectorySelectorDirectory.cs
+++ b/osu.Game/Graphics/UserInterfaceV2/OsuDirectorySelectorDirectory.cs
@@ -10,6 +10,7 @@ using osu.Framework.Graphics.Sprites;
 using osu.Framework.Graphics.UserInterface;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.UserInterface;
+using osu.Game.Overlays;
 
 namespace osu.Game.Graphics.UserInterfaceV2
 {
@@ -44,8 +45,8 @@ namespace osu.Game.Graphics.UserInterfaceV2
 
         internal class Background : CompositeDrawable
         {
-            [BackgroundDependencyLoader]
-            private void load(OsuColour colours)
+            [BackgroundDependencyLoader(true)]
+            private void load(OverlayColourProvider overlayColourProvider, OsuColour colours)
             {
                 RelativeSizeAxes = Axes.Both;
 
@@ -54,7 +55,7 @@ namespace osu.Game.Graphics.UserInterfaceV2
 
                 InternalChild = new Box
                 {
-                    Colour = colours.GreySeaFoamDarker,
+                    Colour = overlayColourProvider?.Background5 ?? colours.GreySeaFoamDarker,
                     RelativeSizeAxes = Axes.Both,
                 };
             }

From e2ea98693f8761ba0fc0fd76f786963d434eba5e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 16 May 2022 21:33:15 +0900
Subject: [PATCH 4873/5547] Tidy up buttons and text

---
 .../FirstRunSetup/ScreenImportFromStable.cs   | 33 +++++++++++--------
 1 file changed, 20 insertions(+), 13 deletions(-)

diff --git a/osu.Game/Overlays/FirstRunSetup/ScreenImportFromStable.cs b/osu.Game/Overlays/FirstRunSetup/ScreenImportFromStable.cs
index acc0fdbb7c..f867adff79 100644
--- a/osu.Game/Overlays/FirstRunSetup/ScreenImportFromStable.cs
+++ b/osu.Game/Overlays/FirstRunSetup/ScreenImportFromStable.cs
@@ -28,6 +28,8 @@ namespace osu.Game.Overlays.FirstRunSetup
     [LocalisableDescription(typeof(FirstRunSetupOverlayStrings), nameof(FirstRunSetupOverlayStrings.ImportTitle))]
     public class ScreenImportFromStable : FirstRunSetupScreen
     {
+        private static readonly Vector2 button_size = new Vector2(400, 50);
+
         private ProgressRoundedButton importButton = null!;
         private RoundedButton locateStableButton = null!;
 
@@ -46,8 +48,6 @@ namespace osu.Game.Overlays.FirstRunSetup
         [BackgroundDependencyLoader(permitNulls: true)]
         private void load()
         {
-            Vector2 buttonSize = new Vector2(400, 50);
-
             Content.Children = new Drawable[]
             {
                 new OsuTextFlowContainer(cp => cp.Font = OsuFont.Default.With(size: CONTENT_FONT_SIZE))
@@ -63,14 +63,14 @@ namespace osu.Game.Overlays.FirstRunSetup
                     Colour = OverlayColourProvider.Content2,
                     RelativeSizeAxes = Axes.X,
                     AutoSizeAxes = Axes.Y,
+                    TextAnchor = Anchor.Centre,
                 },
                 locateStableButton = new RoundedButton
                 {
-                    Size = buttonSize,
+                    Size = button_size,
                     Anchor = Anchor.TopCentre,
                     Origin = Anchor.TopCentre,
-                    BackgroundColour = colours.Blue3,
-                    Text = "Locate osu!(stable) install",
+                    Text = "Change location",
                     Action = locateStable,
                 },
                 new ImportCheckbox("Beatmaps", StableContent.Beatmaps),
@@ -79,10 +79,9 @@ namespace osu.Game.Overlays.FirstRunSetup
                 new ImportCheckbox("Collections", StableContent.Collections),
                 importButton = new ProgressRoundedButton
                 {
-                    Size = buttonSize,
+                    Size = button_size,
                     Anchor = Anchor.TopCentre,
                     Origin = Anchor.TopCentre,
-                    BackgroundColour = colours.Blue3,
                     Text = FirstRunSetupOverlayStrings.ImportContentFromStable,
                     Action = runImport
                 },
@@ -112,7 +111,10 @@ namespace osu.Game.Overlays.FirstRunSetup
             {
                 foreach (var c in contentCheckboxes)
                     c.Current.Disabled = true;
+                currentStablePath.FadeColour(colours.Red1, 500, Easing.OutQuint);
                 currentStablePath.Text = "No installation found";
+
+                importButton.Enabled.Value = false;
                 return;
             }
 
@@ -122,8 +124,10 @@ namespace osu.Game.Overlays.FirstRunSetup
                 c.UpdateCount();
             }
 
-            currentStablePath.Text = storage.GetFullPath(string.Empty);
+            currentStablePath.FadeColour(OverlayColourProvider.Content2);
+            currentStablePath.Text = $"Found installation: {storage.GetFullPath(string.Empty)}";
             stablePathUpdateCancellation = new CancellationTokenSource();
+            importButton.Enabled.Value = true;
         }
 
         private void runImport()
@@ -138,13 +142,12 @@ namespace osu.Game.Overlays.FirstRunSetup
 
             legacyImportManager.ImportFromStableAsync(importableContent, false).ContinueWith(t => Schedule(() =>
             {
-                locateStableButton.Enabled.Value = true;
-
                 if (t.IsCompletedSuccessfully)
                     importButton.Complete();
                 else
                 {
                     importButton.Enabled.Value = true;
+                    locateStableButton.Enabled.Value = true;
                     importButton.Abort();
                 }
             }));
@@ -253,9 +256,11 @@ namespace osu.Game.Overlays.FirstRunSetup
                                             {
                                                 Anchor = Anchor.CentreLeft,
                                                 Origin = Anchor.CentreLeft,
-                                                Width = 300,
+                                                RelativeSizeAxes = Axes.X,
+                                                Width = 0.45f,
+                                                Height = button_size.Y,
                                                 Margin = new MarginPadding(10),
-                                                Colour = colours.Pink2,
+                                                BackgroundColour = colours.Pink2,
                                                 Text = CommonStrings.ButtonsCancel,
                                                 Action = this.Exit
                                             },
@@ -263,7 +268,9 @@ namespace osu.Game.Overlays.FirstRunSetup
                                             {
                                                 Anchor = Anchor.CentreRight,
                                                 Origin = Anchor.CentreRight,
-                                                Width = 300,
+                                                RelativeSizeAxes = Axes.X,
+                                                Width = 0.45f,
+                                                Height = button_size.Y,
                                                 Margin = new MarginPadding(10),
                                                 Text = MaintenanceSettingsStrings.SelectDirectory,
                                                 Action = () =>

From 8112416335429ee4d18475887d88c40558fd6c1c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 17 May 2022 15:25:45 +0900
Subject: [PATCH 4874/5547] Assert that downloads are queued early enough to
 work

---
 osu.Game/Beatmaps/Drawables/BundledBeatmapDownloader.cs | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/osu.Game/Beatmaps/Drawables/BundledBeatmapDownloader.cs b/osu.Game/Beatmaps/Drawables/BundledBeatmapDownloader.cs
index df0a69cb25..84903d381a 100644
--- a/osu.Game/Beatmaps/Drawables/BundledBeatmapDownloader.cs
+++ b/osu.Game/Beatmaps/Drawables/BundledBeatmapDownloader.cs
@@ -3,9 +3,11 @@
 
 using System;
 using System.Collections.Generic;
+using System.Diagnostics;
 using System.Linq;
 using System.Text.RegularExpressions;
 using osu.Framework.Allocation;
+using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Database;
 using osu.Game.Online;
@@ -89,6 +91,8 @@ namespace osu.Game.Beatmaps.Drawables
 
         private void queueDownloads(string[] sourceFilenames, int? limit = null)
         {
+            Debug.Assert(LoadState == LoadState.NotLoaded);
+
             try
             {
                 // Matches osu-stable, in order to provide new users with roughly the same randomised selection of bundled beatmaps.

From 3ff0399281f2f2ca0b5356aa08c48133623962db Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 17 May 2022 16:32:31 +0900
Subject: [PATCH 4875/5547] Split out `LabelledTextBoxWithPopover` for reuse

---
 .../Edit/Setup/FileChooserLabelledTextBox.cs  | 37 +-------------
 .../Edit/Setup/LabelledTextBoxWithPopover.cs  | 49 +++++++++++++++++++
 2 files changed, 51 insertions(+), 35 deletions(-)
 create mode 100644 osu.Game/Screens/Edit/Setup/LabelledTextBoxWithPopover.cs

diff --git a/osu.Game/Screens/Edit/Setup/FileChooserLabelledTextBox.cs b/osu.Game/Screens/Edit/Setup/FileChooserLabelledTextBox.cs
index d1e35ae20d..aae19396db 100644
--- a/osu.Game/Screens/Edit/Setup/FileChooserLabelledTextBox.cs
+++ b/osu.Game/Screens/Edit/Setup/FileChooserLabelledTextBox.cs
@@ -11,11 +11,8 @@ using osu.Framework.Bindables;
 using osu.Framework.Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
-using osu.Framework.Graphics.Cursor;
 using osu.Framework.Graphics.UserInterface;
-using osu.Framework.Input.Events;
 using osu.Game.Database;
-using osu.Game.Graphics.UserInterface;
 using osu.Game.Graphics.UserInterfaceV2;
 using osuTK;
 
@@ -24,7 +21,7 @@ namespace osu.Game.Screens.Edit.Setup
     /// <summary>
     /// A labelled textbox which reveals an inline file chooser when clicked.
     /// </summary>
-    internal class FileChooserLabelledTextBox : LabelledTextBox, ICanAcceptFiles, IHasPopover
+    internal class FileChooserLabelledTextBox : LabelledTextBoxWithPopover, ICanAcceptFiles
     {
         private readonly string[] handledExtensions;
 
@@ -40,16 +37,6 @@ namespace osu.Game.Screens.Edit.Setup
             this.handledExtensions = handledExtensions;
         }
 
-        protected override OsuTextBox CreateTextBox() =>
-            new FileChooserOsuTextBox
-            {
-                Anchor = Anchor.Centre,
-                Origin = Anchor.Centre,
-                RelativeSizeAxes = Axes.X,
-                CornerRadius = CORNER_RADIUS,
-                OnFocused = this.ShowPopover
-            };
-
         protected override void LoadComplete()
         {
             base.LoadComplete();
@@ -81,27 +68,7 @@ namespace osu.Game.Screens.Edit.Setup
             game.UnregisterImportHandler(this);
         }
 
-        internal class FileChooserOsuTextBox : OsuTextBox
-        {
-            public Action OnFocused;
-
-            protected override bool OnDragStart(DragStartEvent e)
-            {
-                // This text box is intended to be "read only" without actually specifying that.
-                // As such we don't want to allow the user to select its content with a drag.
-                return false;
-            }
-
-            protected override void OnFocus(FocusEvent e)
-            {
-                OnFocused?.Invoke();
-                base.OnFocus(e);
-
-                GetContainingInputManager().TriggerFocusContention(this);
-            }
-        }
-
-        public Popover GetPopover() => new FileChooserPopover(handledExtensions, currentFile);
+        public override Popover GetPopover() => new FileChooserPopover(handledExtensions, currentFile);
 
         private class FileChooserPopover : OsuPopover
         {
diff --git a/osu.Game/Screens/Edit/Setup/LabelledTextBoxWithPopover.cs b/osu.Game/Screens/Edit/Setup/LabelledTextBoxWithPopover.cs
new file mode 100644
index 0000000000..1136675347
--- /dev/null
+++ b/osu.Game/Screens/Edit/Setup/LabelledTextBoxWithPopover.cs
@@ -0,0 +1,49 @@
+// 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.Extensions;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Cursor;
+using osu.Framework.Graphics.UserInterface;
+using osu.Framework.Input.Events;
+using osu.Game.Graphics.UserInterface;
+using osu.Game.Graphics.UserInterfaceV2;
+
+namespace osu.Game.Screens.Edit.Setup
+{
+    internal abstract class LabelledTextBoxWithPopover : LabelledTextBox, IHasPopover
+    {
+        public abstract Popover GetPopover();
+
+        protected override OsuTextBox CreateTextBox() =>
+            new PopoverTextBox
+            {
+                Anchor = Anchor.Centre,
+                Origin = Anchor.Centre,
+                RelativeSizeAxes = Axes.X,
+                CornerRadius = CORNER_RADIUS,
+                OnFocused = this.ShowPopover
+            };
+
+        internal class PopoverTextBox : OsuTextBox
+        {
+            public Action OnFocused;
+
+            protected override bool OnDragStart(DragStartEvent e)
+            {
+                // This text box is intended to be "read only" without actually specifying that.
+                // As such we don't want to allow the user to select its content with a drag.
+                return false;
+            }
+
+            protected override void OnFocus(FocusEvent e)
+            {
+                OnFocused?.Invoke();
+                base.OnFocus(e);
+
+                GetContainingInputManager().TriggerFocusContention(this);
+            }
+        }
+    }
+}

From adc7b61240c55d9b2bec397f1a05a1427cf56558 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 17 May 2022 16:33:02 +0900
Subject: [PATCH 4876/5547] Switch directory selector to use a semi-shared
 popover implementation

---
 .../FirstRunSetup/ScreenImportFromStable.cs   | 226 +++++++-----------
 osu.Game/Overlays/FirstRunSetupOverlay.cs     |   3 +-
 2 files changed, 86 insertions(+), 143 deletions(-)

diff --git a/osu.Game/Overlays/FirstRunSetup/ScreenImportFromStable.cs b/osu.Game/Overlays/FirstRunSetup/ScreenImportFromStable.cs
index f867adff79..8b7550e301 100644
--- a/osu.Game/Overlays/FirstRunSetup/ScreenImportFromStable.cs
+++ b/osu.Game/Overlays/FirstRunSetup/ScreenImportFromStable.cs
@@ -3,25 +3,27 @@
 
 #nullable enable
 
+using System;
 using System.Collections.Generic;
 using System.IO;
 using System.Linq;
 using System.Threading;
+using System.Threading.Tasks;
 using osu.Framework.Allocation;
+using osu.Framework.Bindables;
 using osu.Framework.Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.UserInterface;
 using osu.Framework.Localisation;
-using osu.Framework.Screens;
 using osu.Game.Database;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.UserInterfaceV2;
-using osu.Game.IO;
 using osu.Game.Localisation;
 using osu.Game.Overlays.Settings;
+using osu.Game.Screens.Edit.Setup;
 using osuTK;
-using CommonStrings = osu.Game.Resources.Localisation.Web.CommonStrings;
 
 namespace osu.Game.Overlays.FirstRunSetup
 {
@@ -31,18 +33,14 @@ namespace osu.Game.Overlays.FirstRunSetup
         private static readonly Vector2 button_size = new Vector2(400, 50);
 
         private ProgressRoundedButton importButton = null!;
-        private RoundedButton locateStableButton = null!;
-
-        private OsuTextFlowContainer currentStablePath = null!;
-
-        [Resolved]
-        private OsuColour colours { get; set; } = null!;
 
         [Resolved]
         private LegacyImportManager legacyImportManager { get; set; } = null!;
 
         private CancellationTokenSource? stablePathUpdateCancellation;
 
+        private StableLocatorLabelledTextBox stableLocatorTextBox = null!;
+
         private IEnumerable<ImportCheckbox> contentCheckboxes => Content.Children.OfType<ImportCheckbox>();
 
         [BackgroundDependencyLoader(permitNulls: true)]
@@ -58,20 +56,10 @@ namespace osu.Game.Overlays.FirstRunSetup
                     RelativeSizeAxes = Axes.X,
                     AutoSizeAxes = Axes.Y
                 },
-                currentStablePath = new OsuTextFlowContainer(cp => cp.Font = OsuFont.Default.With(size: HEADER_FONT_SIZE, weight: FontWeight.SemiBold))
+                stableLocatorTextBox = new StableLocatorLabelledTextBox
                 {
-                    Colour = OverlayColourProvider.Content2,
-                    RelativeSizeAxes = Axes.X,
-                    AutoSizeAxes = Axes.Y,
-                    TextAnchor = Anchor.Centre,
-                },
-                locateStableButton = new RoundedButton
-                {
-                    Size = button_size,
-                    Anchor = Anchor.TopCentre,
-                    Origin = Anchor.TopCentre,
-                    Text = "Change location",
-                    Action = locateStable,
+                    Label = "previous osu! install",
+                    PlaceholderText = "Click to locate a previous osu! install"
                 },
                 new ImportCheckbox("Beatmaps", StableContent.Beatmaps),
                 new ImportCheckbox("Scores", StableContent.Scores),
@@ -87,18 +75,7 @@ namespace osu.Game.Overlays.FirstRunSetup
                 },
             };
 
-            updateStablePath();
-        }
-
-        private void locateStable() => this.Push(new LocateStableScreen());
-
-        public override void OnResuming(ScreenTransitionEvent e)
-        {
-            base.OnResuming(e);
-
-            if (e.Last is LocateStableScreen)
-                // stable storage may have changed.
-                Schedule(updateStablePath);
+            stableLocatorTextBox.Current.BindValueChanged(_ => updateStablePath(), true);
         }
 
         private void updateStablePath()
@@ -111,9 +88,8 @@ namespace osu.Game.Overlays.FirstRunSetup
             {
                 foreach (var c in contentCheckboxes)
                     c.Current.Disabled = true;
-                currentStablePath.FadeColour(colours.Red1, 500, Easing.OutQuint);
-                currentStablePath.Text = "No installation found";
 
+                stableLocatorTextBox.Current.Value = string.Empty;
                 importButton.Enabled.Value = false;
                 return;
             }
@@ -124,8 +100,8 @@ namespace osu.Game.Overlays.FirstRunSetup
                 c.UpdateCount();
             }
 
-            currentStablePath.FadeColour(OverlayColourProvider.Content2);
-            currentStablePath.Text = $"Found installation: {storage.GetFullPath(string.Empty)}";
+            stableLocatorTextBox.Current.Value = storage.GetFullPath(string.Empty);
+
             stablePathUpdateCancellation = new CancellationTokenSource();
             importButton.Enabled.Value = true;
         }
@@ -133,7 +109,7 @@ namespace osu.Game.Overlays.FirstRunSetup
         private void runImport()
         {
             importButton.Enabled.Value = false;
-            locateStableButton.Enabled.Value = false;
+            stableLocatorTextBox.Current.Disabled = true;
 
             StableContent importableContent = 0;
 
@@ -147,7 +123,7 @@ namespace osu.Game.Overlays.FirstRunSetup
                 else
                 {
                     importButton.Enabled.Value = true;
-                    locateStableButton.Enabled.Value = true;
+                    stableLocatorTextBox.Current.Disabled = false;
                     importButton.Abort();
                 }
             }));
@@ -192,119 +168,85 @@ namespace osu.Game.Overlays.FirstRunSetup
             }
         }
 
-        private class LocateStableScreen : FirstRunSetupScreen
+        internal class StableLocatorLabelledTextBox : LabelledTextBoxWithPopover, ICanAcceptFiles
         {
-            private RoundedButton selectionButton = null!;
-
-            private OsuDirectorySelector directorySelector = null!;
-
-            protected bool IsValidDirectory(DirectoryInfo? info) => info?.GetFiles("osu!.*.cfg").Any() ?? false;
-
-            public LocalisableString HeaderText => "Please select your osu!stable install location";
-
-            [BackgroundDependencyLoader]
-            private void load(OsuColour colours)
-            {
-                // Don't want the scroll content provided by `FirstRunSetupScreen` so we don't use `Content`.
-                InternalChild = new Container
-                {
-                    RelativeSizeAxes = Axes.Both,
-                    Padding = new MarginPadding { Horizontal = CONTENT_PADDING },
-                    Children = new Drawable[]
-                    {
-                        new GridContainer
-                        {
-                            RelativeSizeAxes = Axes.Both,
-                            RowDimensions = new[]
-                            {
-                                new Dimension(GridSizeMode.AutoSize),
-                                new Dimension(),
-                                new Dimension(GridSizeMode.AutoSize),
-                            },
-                            Content = new[]
-                            {
-                                new Drawable[]
-                                {
-                                    new OsuTextFlowContainer(cp =>
-                                    {
-                                        cp.Font = OsuFont.Default.With(size: 24);
-                                    })
-                                    {
-                                        Text = HeaderText,
-                                        TextAnchor = Anchor.TopCentre,
-                                        Margin = new MarginPadding(10),
-                                        RelativeSizeAxes = Axes.X,
-                                        AutoSizeAxes = Axes.Y,
-                                    }
-                                },
-                                new Drawable[]
-                                {
-                                    directorySelector = new OsuDirectorySelector
-                                    {
-                                        RelativeSizeAxes = Axes.Both,
-                                    }
-                                },
-                                new Drawable[]
-                                {
-                                    new Container
-                                    {
-                                        RelativeSizeAxes = Axes.X,
-                                        AutoSizeAxes = Axes.Y,
-                                        Children = new Drawable[]
-                                        {
-                                            new RoundedButton
-                                            {
-                                                Anchor = Anchor.CentreLeft,
-                                                Origin = Anchor.CentreLeft,
-                                                RelativeSizeAxes = Axes.X,
-                                                Width = 0.45f,
-                                                Height = button_size.Y,
-                                                Margin = new MarginPadding(10),
-                                                BackgroundColour = colours.Pink2,
-                                                Text = CommonStrings.ButtonsCancel,
-                                                Action = this.Exit
-                                            },
-                                            selectionButton = new RoundedButton
-                                            {
-                                                Anchor = Anchor.CentreRight,
-                                                Origin = Anchor.CentreRight,
-                                                RelativeSizeAxes = Axes.X,
-                                                Width = 0.45f,
-                                                Height = button_size.Y,
-                                                Margin = new MarginPadding(10),
-                                                Text = MaintenanceSettingsStrings.SelectDirectory,
-                                                Action = () =>
-                                                {
-                                                    legacyImportManager.UpdateStorage(directorySelector.CurrentPath.Value.FullName);
-                                                    this.Exit();
-                                                }
-                                            },
-                                        }
-                                    },
-                                }
-                            }
-                        }
-                    }
-                };
-            }
-
             [Resolved]
             private LegacyImportManager legacyImportManager { get; set; } = null!;
 
+            // TODO: test
+            public IEnumerable<string> HandledExtensions { get; } = new[] { string.Empty };
+
+            private readonly Bindable<DirectoryInfo> currentDirectory = new Bindable<DirectoryInfo>();
+
+            [Resolved]
+            private OsuGameBase game { get; set; } = null!;
+
             protected override void LoadComplete()
             {
-                if (legacyImportManager.GetCurrentStableStorage() is StableStorage storage)
-                    directorySelector.CurrentPath.Value = new DirectoryInfo(storage.GetFullPath(string.Empty));
-
-                directorySelector.CurrentPath.BindValueChanged(e => selectionButton.Enabled.Value = e.NewValue != null && IsValidDirectory(e.NewValue), true);
                 base.LoadComplete();
+
+                game.RegisterImportHandler(this);
+
+                currentDirectory.BindValueChanged(onDirectorySelected);
+
+                string? fullPath = legacyImportManager.GetCurrentStableStorage()?.GetFullPath(string.Empty);
+                if (fullPath != null)
+                    currentDirectory.Value = new DirectoryInfo(fullPath);
             }
 
-            public override void OnSuspending(ScreenTransitionEvent e)
+            private void onDirectorySelected(ValueChangedEvent<DirectoryInfo> directory)
             {
-                base.OnSuspending(e);
+                if (directory.NewValue == null || directory.OldValue == null)
+                {
+                    Current.Value = string.Empty;
+                    return;
+                }
 
-                this.FadeOut(250);
+                // DirectorySelectors can trigger a noop value changed, but `DirectoryInfo` equality doesn't catch this.
+                if (directory.OldValue.FullName == directory.NewValue.FullName)
+                    return;
+
+                if (directory.NewValue?.GetFiles(@"osu!.*.cfg").Any() ?? false)
+                {
+                    this.HidePopover();
+
+                    string path = directory.NewValue.FullName;
+
+                    legacyImportManager.UpdateStorage(path);
+                    Current.Value = path;
+                }
+            }
+
+            Task ICanAcceptFiles.Import(params string[] paths)
+            {
+                Schedule(() => currentDirectory.Value = new DirectoryInfo(paths.First()));
+                return Task.CompletedTask;
+            }
+
+            Task ICanAcceptFiles.Import(params ImportTask[] tasks) => throw new NotImplementedException();
+
+            protected override void Dispose(bool isDisposing)
+            {
+                base.Dispose(isDisposing);
+                game.UnregisterImportHandler(this);
+            }
+
+            public override Popover GetPopover() => new DirectoryChooserPopover(currentDirectory);
+
+            private class DirectoryChooserPopover : OsuPopover
+            {
+                public DirectoryChooserPopover(Bindable<DirectoryInfo> currentDirectory)
+                {
+                    Child = new Container
+                    {
+                        Size = new Vector2(600, 400),
+                        Child = new OsuDirectorySelector(currentDirectory.Value?.FullName)
+                        {
+                            RelativeSizeAxes = Axes.Both,
+                            CurrentPath = { BindTarget = currentDirectory }
+                        },
+                    };
+                }
             }
         }
     }
diff --git a/osu.Game/Overlays/FirstRunSetupOverlay.cs b/osu.Game/Overlays/FirstRunSetupOverlay.cs
index dae2815e98..890f17b013 100644
--- a/osu.Game/Overlays/FirstRunSetupOverlay.cs
+++ b/osu.Game/Overlays/FirstRunSetupOverlay.cs
@@ -11,6 +11,7 @@ using osu.Framework.Bindables;
 using osu.Framework.Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.Cursor;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Input.Events;
@@ -88,7 +89,7 @@ namespace osu.Game.Overlays
 
             MainAreaContent.AddRange(new Drawable[]
             {
-                content = new Container
+                content = new PopoverContainer
                 {
                     Anchor = Anchor.Centre,
                     Origin = Anchor.Centre,

From 30fdbc3de070fffecdf6e7666de15b4e6e264b42 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 17 May 2022 16:55:41 +0900
Subject: [PATCH 4877/5547] Add safety against calling `GetStableImportPaths`
 when path doesn't exist

---
 osu.Game/Database/LegacyModelImporter.cs | 10 ++++++++--
 osu.Game/Database/LegacyScoreImporter.cs | 10 ++++++++--
 2 files changed, 16 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Database/LegacyModelImporter.cs b/osu.Game/Database/LegacyModelImporter.cs
index a6e0f5bf8b..13a9025ece 100644
--- a/osu.Game/Database/LegacyModelImporter.cs
+++ b/osu.Game/Database/LegacyModelImporter.cs
@@ -24,8 +24,14 @@ namespace osu.Game.Database
         /// <summary>
         /// Select paths to import from stable where all paths should be absolute. Default implementation iterates all directories in <see cref="ImportFromStablePath"/>.
         /// </summary>
-        protected virtual IEnumerable<string> GetStableImportPaths(Storage storage) => storage.GetDirectories(ImportFromStablePath)
-                                                                                              .Select(path => storage.GetFullPath(path));
+        protected virtual IEnumerable<string> GetStableImportPaths(Storage storage)
+        {
+            if (!storage.ExistsDirectory(ImportFromStablePath))
+                return Enumerable.Empty<string>();
+
+            return storage.GetDirectories(ImportFromStablePath)
+                          .Select(path => storage.GetFullPath(path));
+        }
 
         protected readonly IModelImporter<TModel> Importer;
 
diff --git a/osu.Game/Database/LegacyScoreImporter.cs b/osu.Game/Database/LegacyScoreImporter.cs
index 48445b7bdb..131b4ffb0e 100644
--- a/osu.Game/Database/LegacyScoreImporter.cs
+++ b/osu.Game/Database/LegacyScoreImporter.cs
@@ -15,8 +15,14 @@ namespace osu.Game.Database
         protected override string ImportFromStablePath => Path.Combine("Data", "r");
 
         protected override IEnumerable<string> GetStableImportPaths(Storage storage)
-            => storage.GetFiles(ImportFromStablePath).Where(p => Importer.HandledExtensions.Any(ext => Path.GetExtension(p)?.Equals(ext, StringComparison.OrdinalIgnoreCase) ?? false))
-                      .Select(path => storage.GetFullPath(path));
+        {
+            if (!storage.ExistsDirectory(ImportFromStablePath))
+                return Enumerable.Empty<string>();
+
+            return storage.GetFiles(ImportFromStablePath)
+                          .Where(p => Importer.HandledExtensions.Any(ext => Path.GetExtension(p)?.Equals(ext, StringComparison.OrdinalIgnoreCase) ?? false))
+                          .Select(path => storage.GetFullPath(path));
+        }
 
         public LegacyScoreImporter(IModelImporter<ScoreInfo> importer)
             : base(importer)

From 03d3900a02ede396fe0fa0eb095b2579586fde66 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 17 May 2022 17:12:10 +0900
Subject: [PATCH 4878/5547] Fix incorrect default state of checkboxes

---
 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 8b7550e301..7791c3614e 100644
--- a/osu.Game/Overlays/FirstRunSetup/ScreenImportFromStable.cs
+++ b/osu.Game/Overlays/FirstRunSetup/ScreenImportFromStable.cs
@@ -146,6 +146,7 @@ namespace osu.Game.Overlays.FirstRunSetup
 
                 StableContent = stableContent;
 
+                Current.Default = true;
                 Current.Value = true;
 
                 LabelText = title;

From 17e0105c2cff5b17aefd5f9b52c1dd29d6b9482c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 17 May 2022 17:26:26 +0900
Subject: [PATCH 4879/5547] Fix interaction with popover when textbox is
 disabled

---
 osu.Game/Screens/Edit/Setup/LabelledTextBoxWithPopover.cs | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/osu.Game/Screens/Edit/Setup/LabelledTextBoxWithPopover.cs b/osu.Game/Screens/Edit/Setup/LabelledTextBoxWithPopover.cs
index 1136675347..799311dd2d 100644
--- a/osu.Game/Screens/Edit/Setup/LabelledTextBoxWithPopover.cs
+++ b/osu.Game/Screens/Edit/Setup/LabelledTextBoxWithPopover.cs
@@ -39,6 +39,9 @@ namespace osu.Game.Screens.Edit.Setup
 
             protected override void OnFocus(FocusEvent e)
             {
+                if (Current.Disabled)
+                    return;
+
                 OnFocused?.Invoke();
                 base.OnFocus(e);
 

From c0de1f96ff2158a293fc546a11b729d84ea4df77 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 17 May 2022 17:26:44 +0900
Subject: [PATCH 4880/5547] Tidy up interaction toggling and add progress
 message

---
 .../FirstRunSetupOverlayStrings.cs            |  4 +-
 .../FirstRunSetup/ScreenImportFromStable.cs   | 42 ++++++++++++-------
 2 files changed, 30 insertions(+), 16 deletions(-)

diff --git a/osu.Game/Localisation/FirstRunSetupOverlayStrings.cs b/osu.Game/Localisation/FirstRunSetupOverlayStrings.cs
index 6b5ca7534d..181e35e4ce 100644
--- a/osu.Game/Localisation/FirstRunSetupOverlayStrings.cs
+++ b/osu.Game/Localisation/FirstRunSetupOverlayStrings.cs
@@ -80,9 +80,9 @@ We recommend you give the new defaults a try, but if you'd like to have things f
         public static LocalisableString ImportTitle => new TranslatableString(getKey(@"import_title"), @"Import");
 
         /// <summary>
-        /// "Import content from stable"
+        /// "Import content from previous version"
         /// </summary>
-        public static LocalisableString ImportContentFromStable => new TranslatableString(getKey(@"import_content_from_stable"), @"Import content from osu!(stable)");
+        public static LocalisableString ImportContentFromPreviousVersion => new TranslatableString(getKey(@"import_content_from_previous_version"), @"Import content from previous version");
 
         private static string getKey(string key) => $@"{prefix}:{key}";
     }
diff --git a/osu.Game/Overlays/FirstRunSetup/ScreenImportFromStable.cs b/osu.Game/Overlays/FirstRunSetup/ScreenImportFromStable.cs
index 7791c3614e..3b3cf4caf7 100644
--- a/osu.Game/Overlays/FirstRunSetup/ScreenImportFromStable.cs
+++ b/osu.Game/Overlays/FirstRunSetup/ScreenImportFromStable.cs
@@ -34,11 +34,11 @@ namespace osu.Game.Overlays.FirstRunSetup
 
         private ProgressRoundedButton importButton = null!;
 
+        private OsuTextFlowContainer progressText = null!;
+
         [Resolved]
         private LegacyImportManager legacyImportManager { get; set; } = null!;
 
-        private CancellationTokenSource? stablePathUpdateCancellation;
-
         private StableLocatorLabelledTextBox stableLocatorTextBox = null!;
 
         private IEnumerable<ImportCheckbox> contentCheckboxes => Content.Children.OfType<ImportCheckbox>();
@@ -70,9 +70,18 @@ namespace osu.Game.Overlays.FirstRunSetup
                     Size = button_size,
                     Anchor = Anchor.TopCentre,
                     Origin = Anchor.TopCentre,
-                    Text = FirstRunSetupOverlayStrings.ImportContentFromStable,
+                    Text = FirstRunSetupOverlayStrings.ImportContentFromPreviousVersion,
                     Action = runImport
                 },
+                progressText = new OsuTextFlowContainer(cp => cp.Font = OsuFont.Default.With(size: CONTENT_FONT_SIZE))
+                {
+                    Colour = OverlayColourProvider.Content1,
+                    Text =
+                        "Your import will continue in the background. Check on its progress in the notifications sidebar!",
+                    RelativeSizeAxes = Axes.X,
+                    AutoSizeAxes = Axes.Y,
+                    Alpha = 0,
+                },
             };
 
             stableLocatorTextBox.Current.BindValueChanged(_ => updateStablePath(), true);
@@ -80,17 +89,14 @@ namespace osu.Game.Overlays.FirstRunSetup
 
         private void updateStablePath()
         {
-            stablePathUpdateCancellation?.Cancel();
-
             var storage = legacyImportManager.GetCurrentStableStorage();
 
             if (storage == null)
             {
-                foreach (var c in contentCheckboxes)
-                    c.Current.Disabled = true;
+                allowInteraction(false);
 
+                stableLocatorTextBox.Current.Disabled = false;
                 stableLocatorTextBox.Current.Value = string.Empty;
-                importButton.Enabled.Value = false;
                 return;
             }
 
@@ -100,16 +106,15 @@ namespace osu.Game.Overlays.FirstRunSetup
                 c.UpdateCount();
             }
 
+            allowInteraction(true);
             stableLocatorTextBox.Current.Value = storage.GetFullPath(string.Empty);
-
-            stablePathUpdateCancellation = new CancellationTokenSource();
             importButton.Enabled.Value = true;
         }
 
         private void runImport()
         {
-            importButton.Enabled.Value = false;
-            stableLocatorTextBox.Current.Disabled = true;
+            allowInteraction(false);
+            progressText.FadeIn(1000, Easing.OutQuint);
 
             StableContent importableContent = 0;
 
@@ -118,17 +123,26 @@ namespace osu.Game.Overlays.FirstRunSetup
 
             legacyImportManager.ImportFromStableAsync(importableContent, false).ContinueWith(t => Schedule(() =>
             {
+                progressText.FadeOut(500, Easing.OutQuint);
+
                 if (t.IsCompletedSuccessfully)
                     importButton.Complete();
                 else
                 {
-                    importButton.Enabled.Value = true;
-                    stableLocatorTextBox.Current.Disabled = false;
+                    allowInteraction(true);
                     importButton.Abort();
                 }
             }));
         }
 
+        private void allowInteraction(bool allow)
+        {
+            importButton.Enabled.Value = allow;
+            stableLocatorTextBox.Current.Disabled = !allow;
+            foreach (var c in contentCheckboxes)
+                c.Current.Disabled = !allow;
+        }
+
         private class ImportCheckbox : SettingsCheckbox
         {
             public readonly StableContent StableContent;

From 83e781d5a1ef9da5e3c0d6f071ca33c44df20279 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 17 May 2022 17:42:46 +0900
Subject: [PATCH 4881/5547] Allow localisation of `PlaceholderText`

---
 osu.Game/Graphics/UserInterfaceV2/LabelledTextBox.cs           | 3 ++-
 .../Edit/Compose/Components/Timeline/SamplePointPiece.cs       | 2 +-
 2 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Graphics/UserInterfaceV2/LabelledTextBox.cs b/osu.Game/Graphics/UserInterfaceV2/LabelledTextBox.cs
index fd64cc2056..82b9fe559f 100644
--- a/osu.Game/Graphics/UserInterfaceV2/LabelledTextBox.cs
+++ b/osu.Game/Graphics/UserInterfaceV2/LabelledTextBox.cs
@@ -6,6 +6,7 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.UserInterface;
 using osu.Framework.Input.Events;
+using osu.Framework.Localisation;
 using osu.Game.Graphics.UserInterface;
 
 namespace osu.Game.Graphics.UserInterfaceV2
@@ -25,7 +26,7 @@ namespace osu.Game.Graphics.UserInterfaceV2
             set => Component.ReadOnly = value;
         }
 
-        public string PlaceholderText
+        public LocalisableString PlaceholderText
         {
             set => Component.PlaceholderText = value;
         }
diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/SamplePointPiece.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/SamplePointPiece.cs
index ab21a83c43..9abea73f6b 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/SamplePointPiece.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/SamplePointPiece.cs
@@ -154,7 +154,7 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
             private void updateBankPlaceholderText(IEnumerable<HitObject> objects)
             {
                 string? commonBank = getCommonBank(objects.Select(h => h.SampleControlPoint).ToArray());
-                bank.PlaceholderText = string.IsNullOrEmpty(commonBank) ? "(multiple)" : null;
+                bank.PlaceholderText = string.IsNullOrEmpty(commonBank) ? "(multiple)" : string.Empty;
             }
 
             private void updateVolumeFor(IEnumerable<HitObject> objects, int? newVolume)

From f4e0ad8c4c87c41454ce28033f150569fa01174a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 17 May 2022 17:51:28 +0900
Subject: [PATCH 4882/5547] Fix drag drop of osu! folder not working as
 expected

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

diff --git a/osu.Game/Overlays/FirstRunSetup/ScreenImportFromStable.cs b/osu.Game/Overlays/FirstRunSetup/ScreenImportFromStable.cs
index 3b3cf4caf7..b145dadd39 100644
--- a/osu.Game/Overlays/FirstRunSetup/ScreenImportFromStable.cs
+++ b/osu.Game/Overlays/FirstRunSetup/ScreenImportFromStable.cs
@@ -211,14 +211,14 @@ namespace osu.Game.Overlays.FirstRunSetup
 
             private void onDirectorySelected(ValueChangedEvent<DirectoryInfo> directory)
             {
-                if (directory.NewValue == null || directory.OldValue == null)
+                if (directory.NewValue == null)
                 {
                     Current.Value = string.Empty;
                     return;
                 }
 
                 // DirectorySelectors can trigger a noop value changed, but `DirectoryInfo` equality doesn't catch this.
-                if (directory.OldValue.FullName == directory.NewValue.FullName)
+                if (directory.OldValue?.FullName == directory.NewValue.FullName)
                     return;
 
                 if (directory.NewValue?.GetFiles(@"osu!.*.cfg").Any() ?? false)

From bf00b062ad05b000f5cb955881494c6da57ece9e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 17 May 2022 17:58:24 +0900
Subject: [PATCH 4883/5547] Add full localisation of import beatmaps screen

---
 ...RunOverlayImportFromStableScreenStrings.cs | 56 +++++++++++++++++++
 .../FirstRunSetupOverlayStrings.cs            | 10 ----
 .../FirstRunSetup/ScreenImportFromStable.cs   | 20 +++----
 3 files changed, 66 insertions(+), 20 deletions(-)
 create mode 100644 osu.Game/Localisation/FirstRunOverlayImportFromStableScreenStrings.cs

diff --git a/osu.Game/Localisation/FirstRunOverlayImportFromStableScreenStrings.cs b/osu.Game/Localisation/FirstRunOverlayImportFromStableScreenStrings.cs
new file mode 100644
index 0000000000..deac7d8628
--- /dev/null
+++ b/osu.Game/Localisation/FirstRunOverlayImportFromStableScreenStrings.cs
@@ -0,0 +1,56 @@
+// 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 FirstRunOverlayImportFromStableScreenStrings
+    {
+        private const string prefix = @"osu.Game.Resources.Localisation.ScreenImportFromStable";
+
+        /// <summary>
+        /// "Import"
+        /// </summary>
+        public static LocalisableString Header => new TranslatableString(getKey(@"header"), @"Import");
+
+        /// <summary>
+        /// "If you have an installation of a previous osu! version, you can choose to migrate your existing content. Note that this will create a copy, and not affect your existing installation."
+        /// </summary>
+        public static LocalisableString Description => new TranslatableString(getKey(@"description"),
+            @"If you have an installation of a previous osu! version, you can choose to migrate your existing content. Note that this will create a copy, and not affect your existing installation.");
+
+        /// <summary>
+        /// "previous osu! install"
+        /// </summary>
+        public static LocalisableString LocateDirectoryLabel => new TranslatableString(getKey(@"locate_directory_label"), @"previous osu! install");
+
+        /// <summary>
+        /// "Click to locate a previous osu! install"
+        /// </summary>
+        public static LocalisableString LocateDirectoryPlaceholder => new TranslatableString(getKey(@"locate_directory_placeholder"), @"Click to locate a previous osu! install");
+
+        /// <summary>
+        /// "Import content from previous version"
+        /// </summary>
+        public static LocalisableString ImportButton => new TranslatableString(getKey(@"import_button"), @"Import content from previous version");
+
+        /// <summary>
+        /// "Your import will continue in the background. Check on its progress in the notifications sidebar!"
+        /// </summary>
+        public static LocalisableString ImportInProgress =>
+            new TranslatableString(getKey(@"import_in_progress"), @"Your import will continue in the background. Check on its progress in the notifications sidebar!");
+
+        /// <summary>
+        /// "calculating..."
+        /// </summary>
+        public static LocalisableString Calculating => new TranslatableString(getKey(@"calculating"), @"calculating...");
+
+        /// <summary>
+        /// "{0} items"
+        /// </summary>
+        public static LocalisableString Items(int arg0) => new TranslatableString(getKey(@"items"), @"{0} item(s)", arg0);
+
+        private static string getKey(string key) => $@"{prefix}:{key}";
+    }
+}
diff --git a/osu.Game/Localisation/FirstRunSetupOverlayStrings.cs b/osu.Game/Localisation/FirstRunSetupOverlayStrings.cs
index 181e35e4ce..91b427e2ca 100644
--- a/osu.Game/Localisation/FirstRunSetupOverlayStrings.cs
+++ b/osu.Game/Localisation/FirstRunSetupOverlayStrings.cs
@@ -74,16 +74,6 @@ We recommend you give the new defaults a try, but if you'd like to have things f
         /// </summary>
         public static LocalisableString ClassicDefaults => new TranslatableString(getKey(@"classic_defaults"), @"Classic defaults");
 
-        /// <summary>
-        /// "Welcome"
-        /// </summary>
-        public static LocalisableString ImportTitle => new TranslatableString(getKey(@"import_title"), @"Import");
-
-        /// <summary>
-        /// "Import content from previous version"
-        /// </summary>
-        public static LocalisableString ImportContentFromPreviousVersion => new TranslatableString(getKey(@"import_content_from_previous_version"), @"Import content from previous version");
-
         private static string getKey(string key) => $@"{prefix}:{key}";
     }
 }
diff --git a/osu.Game/Overlays/FirstRunSetup/ScreenImportFromStable.cs b/osu.Game/Overlays/FirstRunSetup/ScreenImportFromStable.cs
index b145dadd39..d5ef879479 100644
--- a/osu.Game/Overlays/FirstRunSetup/ScreenImportFromStable.cs
+++ b/osu.Game/Overlays/FirstRunSetup/ScreenImportFromStable.cs
@@ -27,7 +27,7 @@ using osuTK;
 
 namespace osu.Game.Overlays.FirstRunSetup
 {
-    [LocalisableDescription(typeof(FirstRunSetupOverlayStrings), nameof(FirstRunSetupOverlayStrings.ImportTitle))]
+    [LocalisableDescription(typeof(FirstRunOverlayImportFromStableScreenStrings), nameof(FirstRunOverlayImportFromStableScreenStrings.Header))]
     public class ScreenImportFromStable : FirstRunSetupScreen
     {
         private static readonly Vector2 button_size = new Vector2(400, 50);
@@ -51,15 +51,14 @@ namespace osu.Game.Overlays.FirstRunSetup
                 new OsuTextFlowContainer(cp => cp.Font = OsuFont.Default.With(size: CONTENT_FONT_SIZE))
                 {
                     Colour = OverlayColourProvider.Content1,
-                    Text =
-                        "If you have an installation of a previous osu! version, you can choose to migrate your existing content. Note that this will create a copy, and not affect your existing installation.",
+                    Text = FirstRunOverlayImportFromStableScreenStrings.Description,
                     RelativeSizeAxes = Axes.X,
                     AutoSizeAxes = Axes.Y
                 },
                 stableLocatorTextBox = new StableLocatorLabelledTextBox
                 {
-                    Label = "previous osu! install",
-                    PlaceholderText = "Click to locate a previous osu! install"
+                    Label = FirstRunOverlayImportFromStableScreenStrings.LocateDirectoryLabel,
+                    PlaceholderText = FirstRunOverlayImportFromStableScreenStrings.LocateDirectoryPlaceholder
                 },
                 new ImportCheckbox("Beatmaps", StableContent.Beatmaps),
                 new ImportCheckbox("Scores", StableContent.Scores),
@@ -70,14 +69,13 @@ namespace osu.Game.Overlays.FirstRunSetup
                     Size = button_size,
                     Anchor = Anchor.TopCentre,
                     Origin = Anchor.TopCentre,
-                    Text = FirstRunSetupOverlayStrings.ImportContentFromPreviousVersion,
+                    Text = FirstRunOverlayImportFromStableScreenStrings.ImportButton,
                     Action = runImport
                 },
                 progressText = new OsuTextFlowContainer(cp => cp.Font = OsuFont.Default.With(size: CONTENT_FONT_SIZE))
                 {
                     Colour = OverlayColourProvider.Content1,
-                    Text =
-                        "Your import will continue in the background. Check on its progress in the notifications sidebar!",
+                    Text = FirstRunOverlayImportFromStableScreenStrings.ImportInProgress,
                     RelativeSizeAxes = Axes.X,
                     AutoSizeAxes = Axes.Y,
                     Alpha = 0,
@@ -168,7 +166,7 @@ namespace osu.Game.Overlays.FirstRunSetup
 
             public void UpdateCount()
             {
-                LabelText = LocalisableString.Interpolate($"{title} (calculating...)");
+                LabelText = LocalisableString.Interpolate($"{title} ({FirstRunOverlayImportFromStableScreenStrings.Calculating})");
 
                 countUpdateCancellation?.Cancel();
                 countUpdateCancellation = new CancellationTokenSource();
@@ -178,7 +176,9 @@ namespace osu.Game.Overlays.FirstRunSetup
                     if (task.IsCanceled)
                         return;
 
-                    LabelText = LocalisableString.Interpolate($"{title} ({task.GetResultSafely()} items)");
+                    int count = task.GetResultSafely();
+
+                    LabelText = LocalisableString.Interpolate($"{title} ({FirstRunOverlayImportFromStableScreenStrings.Items(count)})");
                 }));
             }
         }

From 1b7ec1be26e806796258298641cba65a9d043370 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 17 May 2022 18:15:14 +0900
Subject: [PATCH 4884/5547] Add basic test coverage of new screen

---
 ...TestSceneFirstRunScreenImportFromStable.cs | 48 +++++++++++++++++++
 osu.Game/Database/LegacyImportManager.cs      |  8 ++--
 2 files changed, 52 insertions(+), 4 deletions(-)
 create mode 100644 osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunScreenImportFromStable.cs

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunScreenImportFromStable.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunScreenImportFromStable.cs
new file mode 100644
index 0000000000..081b240795
--- /dev/null
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunScreenImportFromStable.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 System.Threading;
+using System.Threading.Tasks;
+using Moq;
+using osu.Framework.Allocation;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Cursor;
+using osu.Framework.Screens;
+using osu.Framework.Utils;
+using osu.Game.Database;
+using osu.Game.Overlays;
+using osu.Game.Overlays.FirstRunSetup;
+
+namespace osu.Game.Tests.Visual.UserInterface
+{
+    public class TestSceneFirstRunScreenImportFromStable : OsuManualInputManagerTestScene
+    {
+        [Cached]
+        private OverlayColourProvider colourProvider = new OverlayColourProvider(OverlayColourScheme.Purple);
+
+        private readonly Mock<LegacyImportManager> legacyImportManager = new Mock<LegacyImportManager>();
+
+        [BackgroundDependencyLoader]
+        private void load()
+        {
+            legacyImportManager.Setup(m => m.GetImportCount(It.IsAny<StableContent>(), It.IsAny<CancellationToken>())).Returns(() => Task.FromResult(RNG.Next(0, 256)));
+
+            Dependencies.CacheAs(legacyImportManager.Object);
+        }
+
+        public TestSceneFirstRunScreenImportFromStable()
+        {
+            AddStep("load screen", () =>
+            {
+                Child = new PopoverContainer
+                {
+                    RelativeSizeAxes = Axes.Both,
+                    Children = new Drawable[]
+                    {
+                        new ScreenStack(new ScreenImportFromStable())
+                    }
+                };
+            });
+        }
+    }
+}
diff --git a/osu.Game/Database/LegacyImportManager.cs b/osu.Game/Database/LegacyImportManager.cs
index 35b1d05fa1..af9db1b6ec 100644
--- a/osu.Game/Database/LegacyImportManager.cs
+++ b/osu.Game/Database/LegacyImportManager.cs
@@ -37,13 +37,13 @@ namespace osu.Game.Database
         [Resolved]
         private CollectionManager collections { get; set; }
 
-        [Resolved]
+        [Resolved(canBeNull: true)]
         private OsuGame game { get; set; }
 
         [Resolved]
         private IDialogOverlay dialogOverlay { get; set; }
 
-        [Resolved(CanBeNull = true)]
+        [Resolved(canBeNull: true)]
         private DesktopGameHost desktopGameHost { get; set; }
 
         private StableStorage cachedStorage;
@@ -52,7 +52,7 @@ namespace osu.Game.Database
 
         public void UpdateStorage(string stablePath) => cachedStorage = new StableStorage(stablePath, desktopGameHost);
 
-        public async Task<int> GetImportCount(StableContent content, CancellationToken cancellationToken)
+        public virtual async Task<int> GetImportCount(StableContent content, CancellationToken cancellationToken)
         {
             var stableStorage = GetCurrentStableStorage();
 
@@ -120,7 +120,7 @@ namespace osu.Game.Database
             if (cachedStorage != null)
                 return cachedStorage;
 
-            var stableStorage = game.GetStorageForStableInstall();
+            var stableStorage = game?.GetStorageForStableInstall();
             if (stableStorage != null)
                 return cachedStorage = stableStorage;
 

From 062ffe64acf700d295d22585af9a8d1c95362684 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 17 May 2022 18:21:19 +0900
Subject: [PATCH 4885/5547] Remove delay on pop in

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

diff --git a/osu.Game/Overlays/Mods/ModSelectOverlay.cs b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
index 8d72855217..f1a998bd3c 100644
--- a/osu.Game/Overlays/Mods/ModSelectOverlay.cs
+++ b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
@@ -428,7 +428,6 @@ namespace osu.Game.Overlays.Mods
             base.PopIn();
 
             multiplierDisplay?
-                .Delay(fade_in_duration / 5)
                 .FadeIn(fade_in_duration, Easing.OutQuint)
                 .MoveToY(0, fade_in_duration, Easing.OutQuint);
 

From 5ad969246702e79eef2b10f155891fa4b61ee3ce Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 17 May 2022 14:59:18 +0900
Subject: [PATCH 4886/5547] Adjust minimum health targets to match osu-stable

---
 osu.Game/Rulesets/Scoring/DrainingHealthProcessor.cs | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Rulesets/Scoring/DrainingHealthProcessor.cs b/osu.Game/Rulesets/Scoring/DrainingHealthProcessor.cs
index dfeb6b4788..e7bb6d79f8 100644
--- a/osu.Game/Rulesets/Scoring/DrainingHealthProcessor.cs
+++ b/osu.Game/Rulesets/Scoring/DrainingHealthProcessor.cs
@@ -27,17 +27,17 @@ namespace osu.Game.Rulesets.Scoring
         /// <summary>
         /// The minimum health target at an HP drain rate of 0.
         /// </summary>
-        private const double min_health_target = 0.95;
+        private const double min_health_target = 0.99;
 
         /// <summary>
         /// The minimum health target at an HP drain rate of 5.
         /// </summary>
-        private const double mid_health_target = 0.70;
+        private const double mid_health_target = 0.9;
 
         /// <summary>
         /// The minimum health target at an HP drain rate of 10.
         /// </summary>
-        private const double max_health_target = 0.30;
+        private const double max_health_target = 0.4;
 
         private IBeatmap beatmap;
 

From 932442e2422db30333071d6a441b993d4f50667b Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Tue, 17 May 2022 18:52:19 +0100
Subject: [PATCH 4887/5547] Use `null` for empty grid cells in
 `ChannelListItem`

---
 .../Chat/ChannelList/ChannelListItem.cs       | 22 ++++++++-----------
 1 file changed, 9 insertions(+), 13 deletions(-)

diff --git a/osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs b/osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs
index dfb0b6d781..da1cfaf617 100644
--- a/osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs
+++ b/osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs
@@ -34,7 +34,7 @@ namespace osu.Game.Overlays.Chat.ChannelList
         private Box hoverBox = null!;
         private Box selectBox = null!;
         private OsuSpriteText text = null!;
-        private Drawable close = null!;
+        private Drawable? close;
 
         [Resolved]
         private Bindable<Channel> selectedChannel { get; set; } = null!;
@@ -119,9 +119,7 @@ namespace osu.Game.Overlays.Chat.ChannelList
         protected override bool OnHover(HoverEvent e)
         {
             hoverBox.FadeIn(300, Easing.OutQuint);
-
-            if (!isSelector)
-                close.FadeIn(300, Easing.OutQuint);
+            close?.FadeIn(300, Easing.OutQuint);
 
             return base.OnHover(e);
         }
@@ -129,17 +127,15 @@ namespace osu.Game.Overlays.Chat.ChannelList
         protected override void OnHoverLost(HoverLostEvent e)
         {
             hoverBox.FadeOut(200, Easing.OutQuint);
-
-            if (!isSelector)
-                close.FadeOut(200, Easing.OutQuint);
+            close?.FadeOut(200, Easing.OutQuint);
 
             base.OnHoverLost(e);
         }
 
-        private Drawable createIcon()
+        private UpdateableAvatar? createIcon()
         {
             if (Channel.Type != ChannelType.PM)
-                return Drawable.Empty();
+                return null;
 
             return new UpdateableAvatar(Channel.Users.First(), isInteractive: false)
             {
@@ -152,10 +148,10 @@ namespace osu.Game.Overlays.Chat.ChannelList
             };
         }
 
-        private Drawable createMentionPill()
+        private ChannelListItemMentionPill? createMentionPill()
         {
             if (isSelector)
-                return Drawable.Empty();
+                return null;
 
             return new ChannelListItemMentionPill
             {
@@ -166,10 +162,10 @@ namespace osu.Game.Overlays.Chat.ChannelList
             };
         }
 
-        private Drawable createCloseButton()
+        private ChannelListItemCloseButton? createCloseButton()
         {
             if (isSelector)
-                return Drawable.Empty();
+                return null;
 
             return new ChannelListItemCloseButton
             {

From 4015042e369a6d0900cca61beb0a13ee795d1639 Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Wed, 18 May 2022 01:35:39 +0100
Subject: [PATCH 4888/5547] Ensure close button component is not stored as a
 `Drawable`

---
 osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs b/osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs
index da1cfaf617..eb2bdfdf8a 100644
--- a/osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs
+++ b/osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs
@@ -34,7 +34,7 @@ namespace osu.Game.Overlays.Chat.ChannelList
         private Box hoverBox = null!;
         private Box selectBox = null!;
         private OsuSpriteText text = null!;
-        private Drawable? close;
+        private ChannelListItemCloseButton? close;
 
         [Resolved]
         private Bindable<Channel> selectedChannel { get; set; } = null!;
@@ -83,7 +83,7 @@ namespace osu.Game.Overlays.Chat.ChannelList
                         },
                         Content = new[]
                         {
-                            new[]
+                            new Drawable?[]
                             {
                                 createIcon(),
                                 text = new OsuSpriteText

From dd4b11c593f7869295e246241e388c701e641f99 Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Wed, 18 May 2022 01:47:23 +0100
Subject: [PATCH 4889/5547] Re-add exception handling on PM message request
 failure

---
 osu.Game/Online/Chat/ChannelManager.cs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Game/Online/Chat/ChannelManager.cs b/osu.Game/Online/Chat/ChannelManager.cs
index 9524e8c1a7..9e85067f15 100644
--- a/osu.Game/Online/Chat/ChannelManager.cs
+++ b/osu.Game/Online/Chat/ChannelManager.cs
@@ -197,6 +197,7 @@ namespace osu.Game.Online.Chat
 
                     createNewPrivateMessageRequest.Failure += exception =>
                     {
+                        handlePostException(exception);
                         target.ReplaceMessage(message, null);
                         dequeueAndRun();
                     };

From 49340888c09cd27e9e030648404947474d07510f Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 18 May 2022 10:56:42 +0900
Subject: [PATCH 4890/5547] Fix compile errors

---
 osu.Game.Tests/Visual/Settings/TestSceneSettingsPanel.cs        | 2 +-
 osu.Game.Tests/Visual/UserInterface/TestScenePlaylistOverlay.cs | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Visual/Settings/TestSceneSettingsPanel.cs b/osu.Game.Tests/Visual/Settings/TestSceneSettingsPanel.cs
index 377873f64a..97463b7466 100644
--- a/osu.Game.Tests/Visual/Settings/TestSceneSettingsPanel.cs
+++ b/osu.Game.Tests/Visual/Settings/TestSceneSettingsPanel.cs
@@ -55,7 +55,7 @@ namespace osu.Game.Tests.Visual.Settings
                                                                                 .OfType<ISettingsItem>()
                                                                                 .OfType<IFilterable>()
                                                                                 .Where(f => !(f is IHasFilterableChildren))
-                                                                                .All(f => f.FilterTerms.Any(t => t.Contains("scaling")))
+                                                                                .All(f => f.FilterTerms.Any(t => t.ToString().Contains("scaling")))
                                                                      ));
 
             AddAssert("ensure section is current", () => settings.CurrentSection.Value is GraphicsSection);
diff --git a/osu.Game.Tests/Visual/UserInterface/TestScenePlaylistOverlay.cs b/osu.Game.Tests/Visual/UserInterface/TestScenePlaylistOverlay.cs
index 09e5bc849e..84a06d97df 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestScenePlaylistOverlay.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestScenePlaylistOverlay.cs
@@ -89,7 +89,7 @@ namespace osu.Game.Tests.Visual.UserInterface
             AddAssert("results filtered correctly",
                 () => playlistOverlay.ChildrenOfType<PlaylistItem>()
                                      .Where(item => item.MatchingFilter)
-                                     .All(item => item.FilterTerms.Any(term => term.Contains("10"))));
+                                     .All(item => item.FilterTerms.Any(term => term.ToString().Contains("10"))));
         }
     }
 }

From 3f71224dfc26a7cd87c6737bac79f86af84de2b2 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 18 May 2022 14:05:21 +0900
Subject: [PATCH 4891/5547] Package .json files in nupkg output

---
 osu.Desktop/osu.nuspec | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Desktop/osu.nuspec b/osu.Desktop/osu.nuspec
index dc1ec17e2c..db58c325bd 100644
--- a/osu.Desktop/osu.nuspec
+++ b/osu.Desktop/osu.nuspec
@@ -18,5 +18,6 @@
       <file src="**.exe" target="lib\net45\" exclude="**vshost**"/>
       <file src="**.dll" target="lib\net45\"/>
       <file src="**.config" target="lib\net45\"/>
+      <file src="**.json" target="lib\net45\"/>
     </files>
 </package>

From 69351d2cdf9de1b4c01ef5740c73983cb3a94fe2 Mon Sep 17 00:00:00 2001
From: Noah M <noahcodes@protonmail.com>
Date: Wed, 18 May 2022 01:09:58 -0500
Subject: [PATCH 4892/5547] Implement button to delete all beatmap videos

---
 osu.Game/Beatmaps/BeatmapManager.cs           | 12 ++++++
 .../MaintenanceSettingsStrings.cs             |  5 +++
 .../Sections/Maintenance/GeneralSettings.cs   | 14 +++++++
 .../MassDeleteConfirmationDialog.cs           |  7 ++++
 osu.Game/Stores/RealmArchiveModelManager.cs   | 38 +++++++++++++++++++
 5 files changed, 76 insertions(+)

diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index 5f7de0d762..2a5df9e206 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -319,6 +319,18 @@ namespace osu.Game.Beatmaps
             });
         }
 
+        public void DeleteVideos(Expression<Func<BeatmapSetInfo, bool>>? filter = null, bool silent = false)
+        {
+            realm.Write(r =>
+            {
+                var items = r.All<BeatmapSetInfo>().Where(s => !s.DeletePending && !s.Protected);
+
+                if (filter != null)
+                    items = items.Where(filter);
+                beatmapModelManager.DeleteVideos(items.ToList(), silent);
+            });
+        }
+
         public void UndeleteAll()
         {
             realm.Run(r => beatmapModelManager.Undelete(r.All<BeatmapSetInfo>().Where(s => s.DeletePending).ToList()));
diff --git a/osu.Game/Localisation/MaintenanceSettingsStrings.cs b/osu.Game/Localisation/MaintenanceSettingsStrings.cs
index a0e1a9ddab..7a04bcd1ca 100644
--- a/osu.Game/Localisation/MaintenanceSettingsStrings.cs
+++ b/osu.Game/Localisation/MaintenanceSettingsStrings.cs
@@ -29,6 +29,11 @@ namespace osu.Game.Localisation
         /// </summary>
         public static LocalisableString DeleteAllBeatmaps => new TranslatableString(getKey(@"delete_all_beatmaps"), @"Delete ALL beatmaps");
 
+        /// <summary>
+        /// "Delete ALL beatmap videos"
+        /// </summary>
+        public static LocalisableString DeleteAllBeatmapVideos => new TranslatableString(getKey(@"delete_all_beatmap_videos"), @"Delete ALL beatmap videos");
+
         /// <summary>
         /// "Import scores from stable"
         /// </summary>
diff --git a/osu.Game/Overlays/Settings/Sections/Maintenance/GeneralSettings.cs b/osu.Game/Overlays/Settings/Sections/Maintenance/GeneralSettings.cs
index be4b0decd9..c2ebb59ecc 100644
--- a/osu.Game/Overlays/Settings/Sections/Maintenance/GeneralSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Maintenance/GeneralSettings.cs
@@ -28,6 +28,7 @@ namespace osu.Game.Overlays.Settings.Sections.Maintenance
         private SettingsButton deleteSkinsButton;
         private SettingsButton restoreButton;
         private SettingsButton undeleteButton;
+        private SettingsButton deleteBeatmapVideosButton;
 
         [BackgroundDependencyLoader(permitNulls: true)]
         private void load(BeatmapManager beatmaps, ScoreManager scores, SkinManager skins, [CanBeNull] CollectionManager collectionManager, [CanBeNull] LegacyImportManager legacyImportManager, IDialogOverlay dialogOverlay)
@@ -58,6 +59,19 @@ namespace osu.Game.Overlays.Settings.Sections.Maintenance
                 }
             });
 
+            Add(deleteBeatmapVideosButton = new DangerousSettingsButton
+            {
+                Text = MaintenanceSettingsStrings.DeleteAllBeatmapVideos,
+                Action = () =>
+                {
+                    dialogOverlay?.Push(new MassVideoDeleteConfirmationDialog(() =>
+                    {
+                        deleteBeatmapVideosButton.Enabled.Value = false;
+                        Task.Run(() => beatmaps.DeleteVideos()).ContinueWith(t => Schedule(() => deleteBeatmapsButton.Enabled.Value = true));
+                    }));
+                }
+            });
+
             if (legacyImportManager?.SupportsImportFromStable == true)
             {
                 Add(importScoresButton = new SettingsButton
diff --git a/osu.Game/Overlays/Settings/Sections/Maintenance/MassDeleteConfirmationDialog.cs b/osu.Game/Overlays/Settings/Sections/Maintenance/MassDeleteConfirmationDialog.cs
index c481c80d82..274b1060ca 100644
--- a/osu.Game/Overlays/Settings/Sections/Maintenance/MassDeleteConfirmationDialog.cs
+++ b/osu.Game/Overlays/Settings/Sections/Maintenance/MassDeleteConfirmationDialog.cs
@@ -29,4 +29,11 @@ namespace osu.Game.Overlays.Settings.Sections.Maintenance
             };
         }
     }
+    public class MassVideoDeleteConfirmationDialog : MassDeleteConfirmationDialog
+    {
+        public MassVideoDeleteConfirmationDialog(Action deleteAction) : base(deleteAction)
+        {
+            BodyText = "All beatmap videos? This cannot be undone!";
+        }
+    }
 }
diff --git a/osu.Game/Stores/RealmArchiveModelManager.cs b/osu.Game/Stores/RealmArchiveModelManager.cs
index cc8229b436..f70aa41cfb 100644
--- a/osu.Game/Stores/RealmArchiveModelManager.cs
+++ b/osu.Game/Stores/RealmArchiveModelManager.cs
@@ -132,6 +132,44 @@ namespace osu.Game.Stores
             notification.State = ProgressNotificationState.Completed;
         }
 
+        /// <summary>
+        /// Delete videos from a list of items.
+        /// This will post notifications tracking progress.
+        /// </summary>
+        public void DeleteVideos(List<TModel> items, bool silent = false)
+        {
+            if (items.Count == 0) return;
+
+            var notification = new ProgressNotification
+            {
+                Progress = 0,
+                Text = $"Preparing to delete all {HumanisedModelName} videos...",
+                CompletionText = $"Deleted all {HumanisedModelName} videos!",
+                State = ProgressNotificationState.Active,
+            };
+            if (!silent)
+                PostNotification?.Invoke(notification);
+
+            int i = 0;
+
+            foreach (var b in items)
+            {
+                if (notification.State == ProgressNotificationState.Cancelled)
+                    // user requested abort
+                    return;
+
+                notification.Text = $"Deleting videos from {HumanisedModelName}s ({++i} of {items.Count})";
+
+                var video = b.Files.FirstOrDefault(f => f.Filename.EndsWith(".mp4") || f.Filename.EndsWith(".avi") || f.Filename.EndsWith(".mov") || f.Filename.EndsWith(".flv"));
+                if (video != null)
+                    DeleteFile(b, video);
+
+                notification.Progress = (float)i / items.Count;
+            }
+
+            notification.State = ProgressNotificationState.Completed;
+        }
+
         /// <summary>
         /// Restore multiple items that were previously deleted.
         /// This will post notifications tracking progress.

From fe49a7e6782e66dedbe5805192c6930589aa6522 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 18 May 2022 17:10:19 +0900
Subject: [PATCH 4893/5547] Add failing tests

---
 .../Formats/LegacyBeatmapDecoderTest.cs       | 35 +++++++++++++++++++
 .../Resources/adjacent-catmull-segments.osu   |  2 ++
 2 files changed, 37 insertions(+)
 create mode 100644 osu.Game.Tests/Resources/adjacent-catmull-segments.osu

diff --git a/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs b/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs
index 468cb7683c..89baaf228d 100644
--- a/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs
+++ b/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs
@@ -863,5 +863,40 @@ namespace osu.Game.Tests.Beatmaps.Formats
                 Assert.That(decoded.Difficulty.OverallDifficulty, Is.EqualTo(1));
             }
         }
+
+        [Test]
+        public void TestLegacyAdjacentImplicitCatmullSegmentsAreMerged()
+        {
+            var decoder = new LegacyBeatmapDecoder { ApplyOffsets = false };
+
+            using (var resStream = TestResources.OpenResource("adjacent-catmull-segments.osu"))
+            using (var stream = new LineBufferedReader(resStream))
+            {
+                var decoded = decoder.Decode(stream);
+                var controlPoints = ((IHasPath)decoded.HitObjects[0]).Path.ControlPoints;
+
+                Assert.That(controlPoints.Count, Is.EqualTo(6));
+                Assert.That(controlPoints.Single(c => c.Type != null).Type, Is.EqualTo(PathType.Catmull));
+            }
+        }
+
+        [Test]
+        public void TestNonLegacyAdjacentImplicitCatmullSegmentsAreNotMerged()
+        {
+            var decoder = new LegacyBeatmapDecoder(LegacyBeatmapEncoder.FIRST_LAZER_VERSION) { ApplyOffsets = false };
+
+            using (var resStream = TestResources.OpenResource("adjacent-catmull-segments.osu"))
+            using (var stream = new LineBufferedReader(resStream))
+            {
+                var decoded = decoder.Decode(stream);
+                var controlPoints = ((IHasPath)decoded.HitObjects[0]).Path.ControlPoints;
+
+                Assert.That(controlPoints.Count, Is.EqualTo(4));
+                Assert.That(controlPoints[0].Type, Is.EqualTo(PathType.Catmull));
+                Assert.That(controlPoints[1].Type, Is.EqualTo(PathType.Catmull));
+                Assert.That(controlPoints[2].Type, Is.EqualTo(PathType.Catmull));
+                Assert.That(controlPoints[3].Type, Is.Null);
+            }
+        }
     }
 }
diff --git a/osu.Game.Tests/Resources/adjacent-catmull-segments.osu b/osu.Game.Tests/Resources/adjacent-catmull-segments.osu
new file mode 100644
index 0000000000..a436fe5228
--- /dev/null
+++ b/osu.Game.Tests/Resources/adjacent-catmull-segments.osu
@@ -0,0 +1,2 @@
+[HitObjects]
+200,304,23875,6,0,C|288:304|288:304|288:208|288:208|352:208,1,260,8|0
\ No newline at end of file

From 731f0960ec53ed3a6059ae5a29cfd5a27f5c3d67 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 18 May 2022 17:11:08 +0900
Subject: [PATCH 4894/5547] Don't merge adjacent legacy Catmull segments

---
 osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs          | 4 ++--
 osu.Game/Rulesets/Objects/Legacy/ConvertHitObjectParser.cs | 6 +++++-
 2 files changed, 7 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs b/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs
index b91a74c4a1..3b4200e7a9 100644
--- a/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs
+++ b/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs
@@ -22,7 +22,7 @@ namespace osu.Game.Beatmaps.Formats
 {
     public class LegacyBeatmapEncoder
     {
-        public const int LATEST_VERSION = 128;
+        public const int FIRST_LAZER_VERSION = 128;
 
         /// <summary>
         /// osu! is generally slower than taiko, so a factor is added to increase
@@ -55,7 +55,7 @@ namespace osu.Game.Beatmaps.Formats
 
         public void Encode(TextWriter writer)
         {
-            writer.WriteLine($"osu file format v{LATEST_VERSION}");
+            writer.WriteLine($"osu file format v{FIRST_LAZER_VERSION}");
 
             writer.WriteLine();
             handleGeneral(writer);
diff --git a/osu.Game/Rulesets/Objects/Legacy/ConvertHitObjectParser.cs b/osu.Game/Rulesets/Objects/Legacy/ConvertHitObjectParser.cs
index 2a7f2b037f..7cf68a2df7 100644
--- a/osu.Game/Rulesets/Objects/Legacy/ConvertHitObjectParser.cs
+++ b/osu.Game/Rulesets/Objects/Legacy/ConvertHitObjectParser.cs
@@ -336,10 +336,14 @@ namespace osu.Game.Rulesets.Objects.Legacy
 
             while (++endIndex < vertices.Length - endPointLength)
             {
-                // Keep incrementing while an implicit segment doesn't need to be started
+                // Keep incrementing while an implicit segment doesn't need to be started.
                 if (vertices[endIndex].Position != vertices[endIndex - 1].Position)
                     continue;
 
+                // Adjacent legacy Catmull segments should be treated as a single segment.
+                if (FormatVersion < LegacyBeatmapEncoder.FIRST_LAZER_VERSION && type == PathType.Catmull)
+                    continue;
+
                 // The last control point of each segment is not allowed to start a new implicit segment.
                 if (endIndex == vertices.Length - endPointLength - 1)
                     continue;

From df4968a55bda4c0d6dcc0cd9bb9d18ca94f511f9 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 18 May 2022 21:20:14 +0900
Subject: [PATCH 4895/5547] Add `new Guid` bannedsymbols rule

---
 CodeAnalysis/BannedSymbols.txt | 1 +
 1 file changed, 1 insertion(+)

diff --git a/CodeAnalysis/BannedSymbols.txt b/CodeAnalysis/BannedSymbols.txt
index e96ad48325..b3cca21c98 100644
--- a/CodeAnalysis/BannedSymbols.txt
+++ b/CodeAnalysis/BannedSymbols.txt
@@ -11,6 +11,7 @@ T:Microsoft.EntityFrameworkCore.Internal.TypeExtensions;Don't use internal exten
 T:NuGet.Packaging.CollectionExtensions;Don't use internal extension methods.
 M:System.Enum.HasFlag(System.Enum);Use osu.Framework.Extensions.EnumExtensions.HasFlagFast<T>() instead.
 M:Realms.IRealmCollection`1.SubscribeForNotifications`1(Realms.NotificationCallbackDelegate{``0});Use osu.Game.Database.RealmObjectExtensions.QueryAsyncWithNotifications(IRealmCollection<T>,NotificationCallbackDelegate<T>) instead.
+M:System.Guid.#ctor;Probably meaning to use Guid.New() instead. If actually wanting empty, use Guid.Empty().
 M:Realms.CollectionExtensions.SubscribeForNotifications`1(System.Linq.IQueryable{``0},Realms.NotificationCallbackDelegate{``0});Use osu.Game.Database.RealmObjectExtensions.QueryAsyncWithNotifications(IQueryable<T>,NotificationCallbackDelegate<T>) instead.
 M:Realms.CollectionExtensions.SubscribeForNotifications`1(System.Collections.Generic.IList{``0},Realms.NotificationCallbackDelegate{``0});Use osu.Game.Database.RealmObjectExtensions.QueryAsyncWithNotifications(IList<T>,NotificationCallbackDelegate<T>) instead.
 M:System.Threading.Tasks.Task.Wait();Don't use Task.Wait. Use Task.WaitSafely() to ensure we avoid deadlocks.

From fa09270e6278ad808c82021938227b1fb3f46b36 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 18 May 2022 21:21:20 +0900
Subject: [PATCH 4896/5547] Remove left-over todo

---
 osu.Game/Overlays/FirstRunSetup/ScreenImportFromStable.cs | 1 -
 1 file changed, 1 deletion(-)

diff --git a/osu.Game/Overlays/FirstRunSetup/ScreenImportFromStable.cs b/osu.Game/Overlays/FirstRunSetup/ScreenImportFromStable.cs
index d5ef879479..ad6ff21353 100644
--- a/osu.Game/Overlays/FirstRunSetup/ScreenImportFromStable.cs
+++ b/osu.Game/Overlays/FirstRunSetup/ScreenImportFromStable.cs
@@ -188,7 +188,6 @@ namespace osu.Game.Overlays.FirstRunSetup
             [Resolved]
             private LegacyImportManager legacyImportManager { get; set; } = null!;
 
-            // TODO: test
             public IEnumerable<string> HandledExtensions { get; } = new[] { string.Empty };
 
             private readonly Bindable<DirectoryInfo> currentDirectory = new Bindable<DirectoryInfo>();

From d54e1503c763f735360bc8caac09019a4a5dbd60 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 18 May 2022 21:22:17 +0900
Subject: [PATCH 4897/5547] Rename interaction toggle method

---
 .../Overlays/FirstRunSetup/ScreenImportFromStable.cs   | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Overlays/FirstRunSetup/ScreenImportFromStable.cs b/osu.Game/Overlays/FirstRunSetup/ScreenImportFromStable.cs
index ad6ff21353..106e78dc18 100644
--- a/osu.Game/Overlays/FirstRunSetup/ScreenImportFromStable.cs
+++ b/osu.Game/Overlays/FirstRunSetup/ScreenImportFromStable.cs
@@ -91,7 +91,7 @@ namespace osu.Game.Overlays.FirstRunSetup
 
             if (storage == null)
             {
-                allowInteraction(false);
+                toggleInteraction(false);
 
                 stableLocatorTextBox.Current.Disabled = false;
                 stableLocatorTextBox.Current.Value = string.Empty;
@@ -104,14 +104,14 @@ namespace osu.Game.Overlays.FirstRunSetup
                 c.UpdateCount();
             }
 
-            allowInteraction(true);
+            toggleInteraction(true);
             stableLocatorTextBox.Current.Value = storage.GetFullPath(string.Empty);
             importButton.Enabled.Value = true;
         }
 
         private void runImport()
         {
-            allowInteraction(false);
+            toggleInteraction(false);
             progressText.FadeIn(1000, Easing.OutQuint);
 
             StableContent importableContent = 0;
@@ -127,13 +127,13 @@ namespace osu.Game.Overlays.FirstRunSetup
                     importButton.Complete();
                 else
                 {
-                    allowInteraction(true);
+                    toggleInteraction(true);
                     importButton.Abort();
                 }
             }));
         }
 
-        private void allowInteraction(bool allow)
+        private void toggleInteraction(bool allow)
         {
             importButton.Enabled.Value = allow;
             stableLocatorTextBox.Current.Disabled = !allow;

From 0cee90e156f31492bd81283c7e4b39238f10734d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 18 May 2022 21:32:32 +0900
Subject: [PATCH 4898/5547] Add common strings for missing localisable content

---
 osu.Game/Localisation/CommonStrings.cs        | 22 ++++++++++++++++++-
 .../FirstRunSetup/ScreenImportFromStable.cs   |  8 +++----
 2 files changed, 25 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Localisation/CommonStrings.cs b/osu.Game/Localisation/CommonStrings.cs
index 9cd626af0f..1fd677034d 100644
--- a/osu.Game/Localisation/CommonStrings.cs
+++ b/osu.Game/Localisation/CommonStrings.cs
@@ -69,6 +69,26 @@ namespace osu.Game.Localisation
         /// </summary>
         public static LocalisableString SelectAll => new TranslatableString(getKey(@"select_all"), @"Select All");
 
+        /// <summary>
+        /// "Beatmaps"
+        /// </summary>
+        public static LocalisableString Beatmaps => new TranslatableString(getKey(@"beatmaps"), @"Beatmaps");
+
+        /// <summary>
+        /// "Scores"
+        /// </summary>
+        public static LocalisableString Scores => new TranslatableString(getKey(@"scores"), @"Scores");
+
+        /// <summary>
+        /// "Skins"
+        /// </summary>
+        public static LocalisableString Skins => new TranslatableString(getKey(@"skins"), @"Skins");
+
+        /// <summary>
+        /// "Collections"
+        /// </summary>
+        public static LocalisableString Collections => new TranslatableString(getKey(@"collections"), @"Collections");
+
         private static string getKey(string key) => $@"{prefix}:{key}";
     }
-}
+}
\ No newline at end of file
diff --git a/osu.Game/Overlays/FirstRunSetup/ScreenImportFromStable.cs b/osu.Game/Overlays/FirstRunSetup/ScreenImportFromStable.cs
index 106e78dc18..cf8abf0a76 100644
--- a/osu.Game/Overlays/FirstRunSetup/ScreenImportFromStable.cs
+++ b/osu.Game/Overlays/FirstRunSetup/ScreenImportFromStable.cs
@@ -60,10 +60,10 @@ namespace osu.Game.Overlays.FirstRunSetup
                     Label = FirstRunOverlayImportFromStableScreenStrings.LocateDirectoryLabel,
                     PlaceholderText = FirstRunOverlayImportFromStableScreenStrings.LocateDirectoryPlaceholder
                 },
-                new ImportCheckbox("Beatmaps", StableContent.Beatmaps),
-                new ImportCheckbox("Scores", StableContent.Scores),
-                new ImportCheckbox("Skins", StableContent.Skins),
-                new ImportCheckbox("Collections", StableContent.Collections),
+                new ImportCheckbox(CommonStrings.Beatmaps, StableContent.Beatmaps),
+                new ImportCheckbox(CommonStrings.Scores, StableContent.Scores),
+                new ImportCheckbox(CommonStrings.Skins, StableContent.Skins),
+                new ImportCheckbox(CommonStrings.Collections, StableContent.Collections),
                 importButton = new ProgressRoundedButton
                 {
                     Size = button_size,

From f5235f6a563a013529387a73ea481ea3dc9fd5aa Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 18 May 2022 20:38:13 +0300
Subject: [PATCH 4899/5547] Correctify recommended method and property

---
 CodeAnalysis/BannedSymbols.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/CodeAnalysis/BannedSymbols.txt b/CodeAnalysis/BannedSymbols.txt
index b3cca21c98..b72df0a306 100644
--- a/CodeAnalysis/BannedSymbols.txt
+++ b/CodeAnalysis/BannedSymbols.txt
@@ -11,7 +11,7 @@ T:Microsoft.EntityFrameworkCore.Internal.TypeExtensions;Don't use internal exten
 T:NuGet.Packaging.CollectionExtensions;Don't use internal extension methods.
 M:System.Enum.HasFlag(System.Enum);Use osu.Framework.Extensions.EnumExtensions.HasFlagFast<T>() instead.
 M:Realms.IRealmCollection`1.SubscribeForNotifications`1(Realms.NotificationCallbackDelegate{``0});Use osu.Game.Database.RealmObjectExtensions.QueryAsyncWithNotifications(IRealmCollection<T>,NotificationCallbackDelegate<T>) instead.
-M:System.Guid.#ctor;Probably meaning to use Guid.New() instead. If actually wanting empty, use Guid.Empty().
+M:System.Guid.#ctor;Probably meaning to use Guid.NewGuid() instead. If actually wanting empty, use Guid.Empty.
 M:Realms.CollectionExtensions.SubscribeForNotifications`1(System.Linq.IQueryable{``0},Realms.NotificationCallbackDelegate{``0});Use osu.Game.Database.RealmObjectExtensions.QueryAsyncWithNotifications(IQueryable<T>,NotificationCallbackDelegate<T>) instead.
 M:Realms.CollectionExtensions.SubscribeForNotifications`1(System.Collections.Generic.IList{``0},Realms.NotificationCallbackDelegate{``0});Use osu.Game.Database.RealmObjectExtensions.QueryAsyncWithNotifications(IList<T>,NotificationCallbackDelegate<T>) instead.
 M:System.Threading.Tasks.Task.Wait();Don't use Task.Wait. Use Task.WaitSafely() to ensure we avoid deadlocks.

From 371738b047105ec1f14b84baf992b1acc52b068d Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Wed, 18 May 2022 20:00:42 +0100
Subject: [PATCH 4900/5547] Check against the loaded drawable channel

---
 osu.Game/Overlays/ChatOverlayV2.cs | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Overlays/ChatOverlayV2.cs b/osu.Game/Overlays/ChatOverlayV2.cs
index e91d57f18b..611c539f8f 100644
--- a/osu.Game/Overlays/ChatOverlayV2.cs
+++ b/osu.Game/Overlays/ChatOverlayV2.cs
@@ -263,18 +263,18 @@ namespace osu.Game.Overlays
                     ChatOverlayDrawableChannel drawableChannel = new ChatOverlayDrawableChannel(newChannel);
                     loadedChannels.Add(newChannel, drawableChannel);
 
-                    LoadComponentAsync(drawableChannel, loaded =>
+                    LoadComponentAsync(drawableChannel, loadedDrawable =>
                     {
                         // Ensure the current channel hasn't changed by the time the load completes
-                        if (currentChannel.Value != newChannel)
+                        if (currentChannel.Value != loadedDrawable.Channel)
                             return;
 
                         // Ensure the cached reference hasn't been removed from leaving the channel
-                        if (!loadedChannels.ContainsKey(newChannel))
+                        if (!loadedChannels.ContainsKey(loadedDrawable.Channel))
                             return;
 
                         currentChannelContainer.Clear(false);
-                        currentChannelContainer.Add(loaded);
+                        currentChannelContainer.Add(loadedDrawable);
                         loading.Hide();
                     });
                 }

From 5d3878a737ae957c359aff643285954172731a52 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 18 May 2022 22:58:39 +0300
Subject: [PATCH 4901/5547] Add test coverage for slow-loading channels

---
 .../Visual/Online/TestSceneChatOverlayV2.cs   | 64 ++++++++++++++++++-
 osu.Game/Overlays/ChatOverlayV2.cs            |  6 +-
 2 files changed, 67 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs b/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs
index 82089ff3d1..3e3c8122b3 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs
@@ -5,6 +5,8 @@ using System;
 using System.Linq;
 using System.Collections.Generic;
 using System.Net;
+using System.Threading;
+using JetBrains.Annotations;
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
@@ -31,7 +33,7 @@ namespace osu.Game.Tests.Visual.Online
     [TestFixture]
     public class TestSceneChatOverlayV2 : OsuManualInputManagerTestScene
     {
-        private ChatOverlayV2 chatOverlay;
+        private TestChatOverlayV2 chatOverlay;
         private ChannelManager channelManager;
 
         private APIUser testUser;
@@ -61,7 +63,7 @@ namespace osu.Game.Tests.Visual.Online
                 Children = new Drawable[]
                 {
                     channelManager,
-                    chatOverlay = new ChatOverlayV2 { RelativeSizeAxes = Axes.Both },
+                    chatOverlay = new TestChatOverlayV2 { RelativeSizeAxes = Axes.Both },
                 },
             };
         });
@@ -386,6 +388,34 @@ namespace osu.Game.Tests.Visual.Online
             AddAssert("TextBox is not focused", () => InputManager.FocusedDrawable == null);
         }
 
+        [Test]
+        public void TestSlowLoadingChannel()
+        {
+            AddStep("Show overlay (slow-loading)", () =>
+            {
+                chatOverlay.Show();
+                chatOverlay.SlowLoading = true;
+            });
+            AddStep("Join channel 1", () => channelManager.JoinChannel(testChannel1));
+            AddAssert("Channel 1 loading", () => !channelIsVisible && chatOverlay.GetSlowLoadingChannel(testChannel1).LoadState == LoadState.Loading);
+
+            AddStep("Join channel 2", () => channelManager.JoinChannel(testChannel2));
+            AddStep("Select channel 2", () => clickDrawable(getChannelListItem(testChannel2)));
+            AddAssert("Channel 2 loading", () => !channelIsVisible && chatOverlay.GetSlowLoadingChannel(testChannel2).LoadState == LoadState.Loading);
+
+            AddStep("Finish channel 1 load", () => chatOverlay.GetSlowLoadingChannel(testChannel1).LoadEvent.Set());
+            AddAssert("Channel 1 ready", () => chatOverlay.GetSlowLoadingChannel(testChannel1).LoadState == LoadState.Ready);
+            AddAssert("Channel 1 not displayed", () => !channelIsVisible);
+
+            AddStep("Finish channel 2 load", () => chatOverlay.GetSlowLoadingChannel(testChannel2).LoadEvent.Set());
+            AddAssert("Channel 2 loaded", () => chatOverlay.GetSlowLoadingChannel(testChannel2).IsLoaded);
+            AddAssert("Channel 2 displayed", () => channelIsVisible && currentDrawableChannel.Channel == testChannel2);
+
+            AddStep("Select channel 1", () => clickDrawable(getChannelListItem(testChannel1)));
+            AddAssert("Channel 1 loaded", () => chatOverlay.GetSlowLoadingChannel(testChannel1).IsLoaded);
+            AddAssert("Channel 1 displayed", () => channelIsVisible && currentDrawableChannel.Channel == testChannel1);
+        }
+
         private bool listingIsVisible =>
             chatOverlay.ChildrenOfType<ChannelListing>().Single().State.Value == Visibility.Visible;
 
@@ -432,5 +462,35 @@ namespace osu.Game.Tests.Visual.Online
             Topic = $"We talk about the number {id} here",
             Type = ChannelType.Public,
         };
+
+        private class TestChatOverlayV2 : ChatOverlayV2
+        {
+            public bool SlowLoading { get; set; }
+
+            public SlowLoadingDrawableChannel GetSlowLoadingChannel(Channel channel) => DrawableChannels.OfType<SlowLoadingDrawableChannel>().Single(c => c.Channel == channel);
+
+            protected override ChatOverlayDrawableChannel CreateDrawableChannel(Channel newChannel)
+            {
+                return SlowLoading
+                    ? new SlowLoadingDrawableChannel(newChannel)
+                    : new ChatOverlayDrawableChannel(newChannel);
+            }
+        }
+
+        private class SlowLoadingDrawableChannel : ChatOverlayDrawableChannel
+        {
+            public readonly ManualResetEventSlim LoadEvent = new ManualResetEventSlim();
+
+            public SlowLoadingDrawableChannel([NotNull] Channel channel)
+                : base(channel)
+            {
+            }
+
+            [BackgroundDependencyLoader]
+            private void load()
+            {
+                LoadEvent.Wait(10000);
+            }
+        }
     }
 }
diff --git a/osu.Game/Overlays/ChatOverlayV2.cs b/osu.Game/Overlays/ChatOverlayV2.cs
index 611c539f8f..b2c1f6858c 100644
--- a/osu.Game/Overlays/ChatOverlayV2.cs
+++ b/osu.Game/Overlays/ChatOverlayV2.cs
@@ -41,6 +41,8 @@ namespace osu.Game.Overlays
 
         private readonly Dictionary<Channel, ChatOverlayDrawableChannel> loadedChannels = new Dictionary<Channel, ChatOverlayDrawableChannel>();
 
+        protected IEnumerable<DrawableChannel> DrawableChannels => loadedChannels.Values;
+
         private readonly BindableFloat chatHeight = new BindableFloat();
         private bool isDraggingTopBar;
         private float dragStartChatHeight;
@@ -260,7 +262,7 @@ namespace osu.Game.Overlays
                     loading.Show();
 
                     // Ensure the drawable channel is stored before async load to prevent double loading
-                    ChatOverlayDrawableChannel drawableChannel = new ChatOverlayDrawableChannel(newChannel);
+                    ChatOverlayDrawableChannel drawableChannel = CreateDrawableChannel(newChannel);
                     loadedChannels.Add(newChannel, drawableChannel);
 
                     LoadComponentAsync(drawableChannel, loadedDrawable =>
@@ -281,6 +283,8 @@ namespace osu.Game.Overlays
             }
         }
 
+        protected virtual ChatOverlayDrawableChannel CreateDrawableChannel(Channel newChannel) => new ChatOverlayDrawableChannel(newChannel);
+
         private void joinedChannelsChanged(object sender, NotifyCollectionChangedEventArgs args)
         {
             switch (args.Action)

From 617382a56f19d628122f5842d8e939efbf2ecbad Mon Sep 17 00:00:00 2001
From: Noah M <noahcodes@protonmail.com>
Date: Wed, 18 May 2022 15:20:02 -0500
Subject: [PATCH 4902/5547] Split off MassVideoDeleteConfirmationDialog into
 its own file

---
 .../Maintenance/MassDeleteConfirmationDialog.cs   |  7 -------
 .../MassVideoDeleteConfirmationDialog.cs          | 15 +++++++++++++++
 2 files changed, 15 insertions(+), 7 deletions(-)
 create mode 100644 osu.Game/Overlays/Settings/Sections/Maintenance/MassVideoDeleteConfirmationDialog.cs

diff --git a/osu.Game/Overlays/Settings/Sections/Maintenance/MassDeleteConfirmationDialog.cs b/osu.Game/Overlays/Settings/Sections/Maintenance/MassDeleteConfirmationDialog.cs
index 274b1060ca..c481c80d82 100644
--- a/osu.Game/Overlays/Settings/Sections/Maintenance/MassDeleteConfirmationDialog.cs
+++ b/osu.Game/Overlays/Settings/Sections/Maintenance/MassDeleteConfirmationDialog.cs
@@ -29,11 +29,4 @@ namespace osu.Game.Overlays.Settings.Sections.Maintenance
             };
         }
     }
-    public 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/MassVideoDeleteConfirmationDialog.cs b/osu.Game/Overlays/Settings/Sections/Maintenance/MassVideoDeleteConfirmationDialog.cs
new file mode 100644
index 0000000000..522177807c
--- /dev/null
+++ b/osu.Game/Overlays/Settings/Sections/Maintenance/MassVideoDeleteConfirmationDialog.cs
@@ -0,0 +1,15 @@
+// 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 class MassVideoDeleteConfirmationDialog : MassDeleteConfirmationDialog
+    {
+        public MassVideoDeleteConfirmationDialog(Action deleteAction) : base(deleteAction)
+        {
+            BodyText = "All beatmap videos? This cannot be undone!";
+        }
+    }
+}

From a93a2fcafba1b0f3af7e52ea6b36e72a592b9e51 Mon Sep 17 00:00:00 2001
From: Noah M <noahcodes@protonmail.com>
Date: Wed, 18 May 2022 15:37:46 -0500
Subject: [PATCH 4903/5547] Move implementation of DeleteVideos to
 BeatmapModelManager

---
 osu.Game/Beatmaps/BeatmapModelManager.cs    | 39 +++++++++++++++++++++
 osu.Game/Stores/RealmArchiveModelManager.cs | 38 --------------------
 2 files changed, 39 insertions(+), 38 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapModelManager.cs b/osu.Game/Beatmaps/BeatmapModelManager.cs
index 4c680bbcc9..3cd2e8c8bd 100644
--- a/osu.Game/Beatmaps/BeatmapModelManager.cs
+++ b/osu.Game/Beatmaps/BeatmapModelManager.cs
@@ -16,6 +16,7 @@ using osu.Game.Database;
 using osu.Game.Extensions;
 using osu.Game.Skinning;
 using osu.Game.Stores;
+using osu.Game.Overlays.Notifications;
 
 #nullable enable
 
@@ -114,5 +115,43 @@ namespace osu.Game.Beatmaps
                 item.CopyChangesToRealm(existing);
             });
         }
+
+        /// <summary>
+        /// Delete videos from a list of beatmaps.
+        /// This will post notifications tracking progress.
+        /// </summary>
+        public void DeleteVideos(List<BeatmapSetInfo> items, bool silent = false)
+        {
+            if (items.Count == 0) return;
+
+            var notification = new ProgressNotification
+            {
+                Progress = 0,
+                Text = $"Preparing to delete all {HumanisedModelName} videos...",
+                CompletionText = $"Deleted all {HumanisedModelName} videos!",
+                State = ProgressNotificationState.Active,
+            };
+            if (!silent)
+                PostNotification?.Invoke(notification);
+
+            int i = 0;
+
+            foreach (var b in items)
+            {
+                if (notification.State == ProgressNotificationState.Cancelled)
+                    // user requested abort
+                    return;
+
+                notification.Text = $"Deleting videos from {HumanisedModelName}s ({++i} of {items.Count})";
+
+                var video = b.Files.FirstOrDefault(f => f.Filename.EndsWith(".mp4") || f.Filename.EndsWith(".avi") || f.Filename.EndsWith(".mov") || f.Filename.EndsWith(".flv"));
+                if (video != null)
+                    DeleteFile(b, video);
+
+                notification.Progress = (float)i / items.Count;
+            }
+
+            notification.State = ProgressNotificationState.Completed;
+        }
     }
 }
diff --git a/osu.Game/Stores/RealmArchiveModelManager.cs b/osu.Game/Stores/RealmArchiveModelManager.cs
index f70aa41cfb..cc8229b436 100644
--- a/osu.Game/Stores/RealmArchiveModelManager.cs
+++ b/osu.Game/Stores/RealmArchiveModelManager.cs
@@ -132,44 +132,6 @@ namespace osu.Game.Stores
             notification.State = ProgressNotificationState.Completed;
         }
 
-        /// <summary>
-        /// Delete videos from a list of items.
-        /// This will post notifications tracking progress.
-        /// </summary>
-        public void DeleteVideos(List<TModel> items, bool silent = false)
-        {
-            if (items.Count == 0) return;
-
-            var notification = new ProgressNotification
-            {
-                Progress = 0,
-                Text = $"Preparing to delete all {HumanisedModelName} videos...",
-                CompletionText = $"Deleted all {HumanisedModelName} videos!",
-                State = ProgressNotificationState.Active,
-            };
-            if (!silent)
-                PostNotification?.Invoke(notification);
-
-            int i = 0;
-
-            foreach (var b in items)
-            {
-                if (notification.State == ProgressNotificationState.Cancelled)
-                    // user requested abort
-                    return;
-
-                notification.Text = $"Deleting videos from {HumanisedModelName}s ({++i} of {items.Count})";
-
-                var video = b.Files.FirstOrDefault(f => f.Filename.EndsWith(".mp4") || f.Filename.EndsWith(".avi") || f.Filename.EndsWith(".mov") || f.Filename.EndsWith(".flv"));
-                if (video != null)
-                    DeleteFile(b, video);
-
-                notification.Progress = (float)i / items.Count;
-            }
-
-            notification.State = ProgressNotificationState.Completed;
-        }
-
         /// <summary>
         /// Restore multiple items that were previously deleted.
         /// This will post notifications tracking progress.

From 60eb0ea69edd1c8e9a9b41c2db071d385536493e Mon Sep 17 00:00:00 2001
From: Noah M <noahcodes@protonmail.com>
Date: Wed, 18 May 2022 15:40:46 -0500
Subject: [PATCH 4904/5547] Remove unnecessary parameters from DeleteVideos

---
 osu.Game/Beatmaps/BeatmapManager.cs | 7 ++-----
 1 file changed, 2 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index 2a5df9e206..92266924df 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -319,15 +319,12 @@ namespace osu.Game.Beatmaps
             });
         }
 
-        public void DeleteVideos(Expression<Func<BeatmapSetInfo, bool>>? filter = null, bool silent = false)
+        public void DeleteVideos()
         {
             realm.Write(r =>
             {
                 var items = r.All<BeatmapSetInfo>().Where(s => !s.DeletePending && !s.Protected);
-
-                if (filter != null)
-                    items = items.Where(filter);
-                beatmapModelManager.DeleteVideos(items.ToList(), silent);
+                beatmapModelManager.DeleteVideos(items.ToList());
             });
         }
 

From d1fcd73c87ca9fe93123ad66b0259521587d15a0 Mon Sep 17 00:00:00 2001
From: Noah M <noahcodes@protonmail.com>
Date: Wed, 18 May 2022 16:25:10 -0500
Subject: [PATCH 4905/5547] Convert extension checking to checking against
 string array

---
 osu.Game/Beatmaps/BeatmapModelManager.cs | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Beatmaps/BeatmapModelManager.cs b/osu.Game/Beatmaps/BeatmapModelManager.cs
index 3cd2e8c8bd..9d3ea7d192 100644
--- a/osu.Game/Beatmaps/BeatmapModelManager.cs
+++ b/osu.Game/Beatmaps/BeatmapModelManager.cs
@@ -34,6 +34,8 @@ namespace osu.Game.Beatmaps
 
         protected override string[] HashableFileTypes => new[] { ".osu" };
 
+        private static readonly string[] video_extensions = { ".mp4", ".mov", ".avi", ".flv" };
+
         public BeatmapModelManager(RealmAccess realm, Storage storage, BeatmapOnlineLookupQueue? onlineLookupQueue = null)
             : base(realm, storage, onlineLookupQueue)
         {
@@ -144,7 +146,7 @@ namespace osu.Game.Beatmaps
 
                 notification.Text = $"Deleting videos from {HumanisedModelName}s ({++i} of {items.Count})";
 
-                var video = b.Files.FirstOrDefault(f => f.Filename.EndsWith(".mp4") || f.Filename.EndsWith(".avi") || f.Filename.EndsWith(".mov") || f.Filename.EndsWith(".flv"));
+                var video = b.Files.FirstOrDefault(f => video_extensions.Any(ex => f.Filename.EndsWith(ex, StringComparison.Ordinal)));
                 if (video != null)
                     DeleteFile(b, video);
 

From 0ef94067872805047679d948585ce6fb81d8a463 Mon Sep 17 00:00:00 2001
From: Noah M <noahcodes@protonmail.com>
Date: Wed, 18 May 2022 16:35:14 -0500
Subject: [PATCH 4906/5547] Fix deleteBeatmapVideosButton not being reenabled

My bad
---
 .../Overlays/Settings/Sections/Maintenance/GeneralSettings.cs   | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/Settings/Sections/Maintenance/GeneralSettings.cs b/osu.Game/Overlays/Settings/Sections/Maintenance/GeneralSettings.cs
index c2ebb59ecc..afc5cad893 100644
--- a/osu.Game/Overlays/Settings/Sections/Maintenance/GeneralSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Maintenance/GeneralSettings.cs
@@ -67,7 +67,7 @@ namespace osu.Game.Overlays.Settings.Sections.Maintenance
                     dialogOverlay?.Push(new MassVideoDeleteConfirmationDialog(() =>
                     {
                         deleteBeatmapVideosButton.Enabled.Value = false;
-                        Task.Run(() => beatmaps.DeleteVideos()).ContinueWith(t => Schedule(() => deleteBeatmapsButton.Enabled.Value = true));
+                        Task.Run(() => beatmaps.DeleteVideos()).ContinueWith(t => Schedule(() => deleteBeatmapVideosButton.Enabled.Value = true));
                     }));
                 }
             });

From 3bca014b52b2b7ea11b3b0ce491d0f0456854311 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 19 May 2022 09:44:11 +0900
Subject: [PATCH 4907/5547] Bust CI cache on CodeAnalysis ruleset changes

---
 .github/workflows/ci.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 729f2f266d..1d5c565d60 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -31,7 +31,7 @@ jobs:
         uses: actions/cache@v3
         with:
           path: ${{ github.workspace }}/inspectcode
-          key: inspectcode-${{ hashFiles('.config/dotnet-tools.json', '.github/workflows/ci.yml', 'osu.sln*', '.editorconfig', '.globalconfig') }}
+          key: inspectcode-${{ hashFiles('.config/dotnet-tools.json', '.github/workflows/ci.yml', 'osu.sln*', '.editorconfig', '.globalconfig', 'CodeAnalysis/*') }}
 
       - name: Dotnet code style
         run: dotnet build -c Debug -warnaserror osu.Desktop.slnf -p:EnforceCodeStyleInBuild=true

From a443200d0d25c54a0e28a0691b9ada5a9bd2bab1 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 19 May 2022 13:49:52 +0900
Subject: [PATCH 4908/5547] Make dependency nullable to allow for safer
 disposal unbinding

---
 .../Skinning/Legacy/LegacyMainCirclePiece.cs              | 2 +-
 osu.Game/Overlays/FirstRunSetup/ScreenImportFromStable.cs | 8 ++++----
 2 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyMainCirclePiece.cs b/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyMainCirclePiece.cs
index 391147648f..dd6226e19b 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyMainCirclePiece.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyMainCirclePiece.cs
@@ -41,7 +41,7 @@ namespace osu.Game.Rulesets.Osu.Skinning.Legacy
         private readonly Bindable<Color4> accentColour = new Bindable<Color4>();
         private readonly IBindable<int> indexInCurrentCombo = new Bindable<int>();
 
-        [Resolved(canBeNull: true)]
+        [Resolved(canBeNull: true)] // Can't really be null but required to handle potential of disposal before DI completes.
         private DrawableHitObject? drawableObject { get; set; }
 
         [Resolved]
diff --git a/osu.Game/Overlays/FirstRunSetup/ScreenImportFromStable.cs b/osu.Game/Overlays/FirstRunSetup/ScreenImportFromStable.cs
index cf8abf0a76..62b517d982 100644
--- a/osu.Game/Overlays/FirstRunSetup/ScreenImportFromStable.cs
+++ b/osu.Game/Overlays/FirstRunSetup/ScreenImportFromStable.cs
@@ -192,14 +192,14 @@ namespace osu.Game.Overlays.FirstRunSetup
 
             private readonly Bindable<DirectoryInfo> currentDirectory = new Bindable<DirectoryInfo>();
 
-            [Resolved]
-            private OsuGameBase game { get; set; } = null!;
+            [Resolved(canBeNull: true)] // Can't really be null but required to handle potential of disposal before DI completes.
+            private OsuGameBase? game { get; set; }
 
             protected override void LoadComplete()
             {
                 base.LoadComplete();
 
-                game.RegisterImportHandler(this);
+                game?.RegisterImportHandler(this);
 
                 currentDirectory.BindValueChanged(onDirectorySelected);
 
@@ -242,7 +242,7 @@ namespace osu.Game.Overlays.FirstRunSetup
             protected override void Dispose(bool isDisposing)
             {
                 base.Dispose(isDisposing);
-                game.UnregisterImportHandler(this);
+                game?.UnregisterImportHandler(this);
             }
 
             public override Popover GetPopover() => new DirectoryChooserPopover(currentDirectory);

From f6fb8f3fb99be7352e40d4cd7b4df12e755349b7 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 19 May 2022 13:54:44 +0900
Subject: [PATCH 4909/5547] Delete and ignore rider's `misc.xml`

This file has changed on us too many times. Doesn't seem to contain
anything of value.
---
 .gitignore                             |  2 ++
 .idea/.idea.osu.Desktop/.idea/misc.xml | 11 -----------
 2 files changed, 2 insertions(+), 11 deletions(-)
 delete mode 100644 .idea/.idea.osu.Desktop/.idea/misc.xml

diff --git a/.gitignore b/.gitignore
index 5b19270ab9..0c7a18b437 100644
--- a/.gitignore
+++ b/.gitignore
@@ -340,3 +340,5 @@ inspectcode
 # Fody (pulled in by Realm) - schema file
 FodyWeavers.xsd
 **/FodyWeavers.xml
+
+.idea/.idea.osu.Desktop/.idea/misc.xml
\ No newline at end of file
diff --git a/.idea/.idea.osu.Desktop/.idea/misc.xml b/.idea/.idea.osu.Desktop/.idea/misc.xml
deleted file mode 100644
index 4e1d56f4dd..0000000000
--- a/.idea/.idea.osu.Desktop/.idea/misc.xml
+++ /dev/null
@@ -1,11 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="SwUserDefinedSpecifications">
-    <option name="specTypeByUrl">
-      <map />
-    </option>
-  </component>
-  <component name="com.jetbrains.rider.android.RiderAndroidMiscFileCreationComponent">
-    <option name="ENSURE_MISC_FILE_EXISTS" value="true" />
-  </component>
-</project>
\ No newline at end of file

From 70bd40ce443cf7ece4df644dd013afe9f3842c89 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 19 May 2022 14:01:24 +0900
Subject: [PATCH 4910/5547] Fix incorrect count of beatmaps available to import

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

diff --git a/osu.Game/Database/LegacyModelImporter.cs b/osu.Game/Database/LegacyModelImporter.cs
index 13a9025ece..9b2a54dada 100644
--- a/osu.Game/Database/LegacyModelImporter.cs
+++ b/osu.Game/Database/LegacyModelImporter.cs
@@ -40,7 +40,7 @@ namespace osu.Game.Database
             Importer = importer;
         }
 
-        public Task<int> GetAvailableCount(StableStorage stableStorage) => Task.Run(() => GetStableImportPaths(stableStorage).Count());
+        public Task<int> GetAvailableCount(StableStorage stableStorage) => Task.Run(() => GetStableImportPaths(PrepareStableStorage(stableStorage)).Count());
 
         public Task ImportFromStableAsync(StableStorage stableStorage)
         {

From 5af7641e946939a15e7729f58ac76de4b6511269 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 19 May 2022 15:53:53 +0900
Subject: [PATCH 4911/5547] Add safety against playfield potentially not being
 available during mania note placement

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

diff --git a/osu.Game.Rulesets.Mania/Edit/Blueprints/ManiaPlacementBlueprint.cs b/osu.Game.Rulesets.Mania/Edit/Blueprints/ManiaPlacementBlueprint.cs
index ad95fd5e87..7a99565e8a 100644
--- a/osu.Game.Rulesets.Mania/Edit/Blueprints/ManiaPlacementBlueprint.cs
+++ b/osu.Game.Rulesets.Mania/Edit/Blueprints/ManiaPlacementBlueprint.cs
@@ -55,24 +55,25 @@ namespace osu.Game.Rulesets.Mania.Edit.Blueprints
         {
             base.UpdateTimeAndPosition(result);
 
-            var playfield = (Column)result.Playfield;
-
-            // Apply an offset to better align with the visual grid.
-            // This should only be applied during placement, as during selection / drag operations the movement is relative
-            // to the initial point of interaction rather than the grid.
-            switch (playfield.ScrollingInfo.Direction.Value)
+            if (result.Playfield is Column col)
             {
-                case ScrollingDirection.Down:
-                    result.ScreenSpacePosition -= new Vector2(0, getNoteHeight(playfield) / 2);
-                    break;
+                // Apply an offset to better align with the visual grid.
+                // This should only be applied during placement, as during selection / drag operations the movement is relative
+                // to the initial point of interaction rather than the grid.
+                switch (col.ScrollingInfo.Direction.Value)
+                {
+                    case ScrollingDirection.Down:
+                        result.ScreenSpacePosition -= new Vector2(0, getNoteHeight(col) / 2);
+                        break;
 
-                case ScrollingDirection.Up:
-                    result.ScreenSpacePosition += new Vector2(0, getNoteHeight(playfield) / 2);
-                    break;
+                    case ScrollingDirection.Up:
+                        result.ScreenSpacePosition += new Vector2(0, getNoteHeight(col) / 2);
+                        break;
+                }
+
+                if (PlacementActive == PlacementState.Waiting)
+                    Column = col;
             }
-
-            if (PlacementActive == PlacementState.Waiting)
-                Column = playfield;
         }
 
         private float getNoteHeight(Column resultPlayfield) =>

From b3d6f76cfacdca8ec3906c8f92d324b71f1e54fc Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 19 May 2022 15:57:17 +0900
Subject: [PATCH 4912/5547] Add "None" snap type to fix flags not working
 correctly

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

diff --git a/osu.Game/Rulesets/Edit/SnapType.cs b/osu.Game/Rulesets/Edit/SnapType.cs
index 4ab67fee63..6761356331 100644
--- a/osu.Game/Rulesets/Edit/SnapType.cs
+++ b/osu.Game/Rulesets/Edit/SnapType.cs
@@ -8,8 +8,9 @@ namespace osu.Game.Rulesets.Edit
     [Flags]
     public enum SnapType
     {
-        NearbyObjects = 0,
-        Grids = 1,
+        None = 0,
+        NearbyObjects = 1 << 0,
+        Grids = 1 << 1,
         All = NearbyObjects | Grids,
     }
 }

From 363e7a6f537b7feda0f8825192391d64e791a749 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 19 May 2022 16:42:43 +0900
Subject: [PATCH 4913/5547] Simplify toolbar hiding logic in
 `FirstRunSetupOverlay`

Rather than fiddling around with the activation modes, this seems like a
much cleaner way to make things work.

Closes https://github.com/ppy/osu/issues/18277.
---
 osu.Game/Overlays/FirstRunSetupOverlay.cs | 22 +++-------------------
 osu.Game/Screens/Menu/MainMenu.cs         |  2 ++
 2 files changed, 5 insertions(+), 19 deletions(-)

diff --git a/osu.Game/Overlays/FirstRunSetupOverlay.cs b/osu.Game/Overlays/FirstRunSetupOverlay.cs
index 890f17b013..7b0de4affe 100644
--- a/osu.Game/Overlays/FirstRunSetupOverlay.cs
+++ b/osu.Game/Overlays/FirstRunSetupOverlay.cs
@@ -62,8 +62,6 @@ namespace osu.Game.Overlays
 
         private Container screenContent = null!;
 
-        private Bindable<OverlayActivation>? overlayActivationMode;
-
         private Container content = null!;
 
         private LoadingSpinner loading = null!;
@@ -225,16 +223,9 @@ namespace osu.Game.Overlays
             // if we are valid for display, only do so after reaching the main menu.
             performer.PerformFromScreen(screen =>
             {
-                MainMenu menu = (MainMenu)screen;
-
-                // Eventually I'd like to replace this with a better method that doesn't access the screen.
-                // Either this dialog would be converted to its own screen, or at very least be "hosted" by a screen pushed to the main menu.
-                // Alternatively, another method of disabling notifications could be added to `INotificationOverlay`.
-                if (menu != null)
-                {
-                    overlayActivationMode = menu.OverlayActivationMode.GetBoundCopy();
-                    overlayActivationMode.Value = OverlayActivation.UserTriggered;
-                }
+                // Hides the toolbar for us.
+                if (screen is MainMenu menu)
+                    menu.ReturnToOsuLogo();
 
                 base.Show();
             }, new[] { typeof(MainMenu) });
@@ -257,13 +248,6 @@ namespace osu.Game.Overlays
 
             content.ScaleTo(0.99f, 400, Easing.OutQuint);
 
-            if (overlayActivationMode != null)
-            {
-                // If this is non-null we are guaranteed to have come from the main menu.
-                overlayActivationMode.Value = OverlayActivation.All;
-                overlayActivationMode = null;
-            }
-
             if (currentStepIndex != null)
             {
                 notificationOverlay.Post(new SimpleNotification
diff --git a/osu.Game/Screens/Menu/MainMenu.cs b/osu.Game/Screens/Menu/MainMenu.cs
index 4401ee93ec..6fc8039413 100644
--- a/osu.Game/Screens/Menu/MainMenu.cs
+++ b/osu.Game/Screens/Menu/MainMenu.cs
@@ -150,6 +150,8 @@ namespace osu.Game.Screens.Menu
         [Resolved(canBeNull: true)]
         private IPerformFromScreenRunner performer { get; set; }
 
+        public void ReturnToOsuLogo() => Buttons.State = ButtonSystemState.Initial;
+
         private void confirmAndExit()
         {
             if (exitConfirmed) return;

From 63c97763658c490de30239d0b1e41799dbed9d2e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 19 May 2022 19:24:18 +0900
Subject: [PATCH 4914/5547] Fix oversight in bindable logic in new overlay
 class

---
 osu.Game/Overlays/ChatOverlayV2.cs | 17 ++++++++++++-----
 1 file changed, 12 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Overlays/ChatOverlayV2.cs b/osu.Game/Overlays/ChatOverlayV2.cs
index 0307dcfdf3..42c928014a 100644
--- a/osu.Game/Overlays/ChatOverlayV2.cs
+++ b/osu.Game/Overlays/ChatOverlayV2.cs
@@ -62,6 +62,9 @@ namespace osu.Game.Overlays
         [Cached]
         private readonly Bindable<Channel> currentChannel = new Bindable<Channel>();
 
+        private readonly IBindableList<Channel> availableChannels = new BindableList<Channel>();
+        private readonly IBindableList<Channel> joinedChannels = new BindableList<Channel>();
+
         public ChatOverlayV2()
         {
             Height = default_chat_height;
@@ -147,9 +150,13 @@ namespace osu.Game.Overlays
             chatHeight.BindValueChanged(height => { Height = height.NewValue; }, true);
 
             currentChannel.BindTo(channelManager.CurrentChannel);
-            channelManager.CurrentChannel.BindValueChanged(currentChannelChanged, true);
-            channelManager.JoinedChannels.BindCollectionChanged(joinedChannelsChanged, true);
-            channelManager.AvailableChannels.BindCollectionChanged(availableChannelsChanged, true);
+            currentChannel.BindValueChanged(currentChannelChanged, true);
+
+            joinedChannels.BindTo(channelManager.JoinedChannels);
+            joinedChannels.BindCollectionChanged(joinedChannelsChanged, true);
+
+            availableChannels.BindTo(channelManager.AvailableChannels);
+            availableChannels.BindCollectionChanged(availableChannelsChanged, true);
 
             channelList.OnRequestSelect += channel => channelManager.CurrentChannel.Value = channel;
             channelList.OnRequestLeave += channel => channelManager.LeaveChannel(channel);
@@ -263,8 +270,8 @@ namespace osu.Game.Overlays
             switch (args.Action)
             {
                 case NotifyCollectionChangedAction.Add:
-                    IEnumerable<Channel> joinedChannels = filterChannels(args.NewItems);
-                    foreach (var channel in joinedChannels)
+                    IEnumerable<Channel> newChannels = filterChannels(args.NewItems);
+                    foreach (var channel in newChannels)
                         channelList.AddChannel(channel);
                     break;
 

From 136ecb45e241b6d0dd4358107ddb2d9b4299f3bf Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 19 May 2022 19:26:14 +0900
Subject: [PATCH 4915/5547] Rename dummy channel and move to a nested class
 inside the `ChannelListing` itself

---
 osu.Game.Tests/Visual/Online/TestSceneChannelList.cs  |  3 ++-
 .../Visual/Online/TestSceneChatOverlayV2.cs           |  2 +-
 osu.Game/Online/Chat/ChannelManager.cs                |  4 ++--
 osu.Game/Overlays/Chat/ChannelList/ChannelList.cs     |  5 +++--
 osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs |  3 ++-
 osu.Game/Overlays/Chat/Listing/ChannelListing.cs      |  9 +++++++++
 osu.Game/Overlays/ChatOverlayV2.cs                    | 11 +----------
 7 files changed, 20 insertions(+), 17 deletions(-)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneChannelList.cs b/osu.Game.Tests/Visual/Online/TestSceneChannelList.cs
index 53a48fcc58..e4bc5645b6 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneChannelList.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneChannelList.cs
@@ -13,6 +13,7 @@ using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Chat;
 using osu.Game.Overlays;
 using osu.Game.Overlays.Chat.ChannelList;
+using osu.Game.Overlays.Chat.Listing;
 
 namespace osu.Game.Tests.Visual.Online
 {
@@ -147,7 +148,7 @@ namespace osu.Game.Tests.Visual.Online
             });
         }
 
-        private bool validItem => selected.Value != null && !(selected.Value is DummySelectorChannel);
+        private bool validItem => selected.Value != null && !(selected.Value is ChannelListing.ChannelListingChannel);
 
         private Channel createRandomPublicChannel()
         {
diff --git a/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs b/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs
index 48557a4ddb..3b8849f7c9 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs
@@ -408,7 +408,7 @@ namespace osu.Game.Tests.Visual.Online
             chatOverlay.ChildrenOfType<ChatOverlayTopBar>().Single();
 
         private ChannelListItem channelSelectorButton =>
-            chatOverlay.ChildrenOfType<ChannelListItem>().Single(item => item.Channel is DummySelectorChannel);
+            chatOverlay.ChildrenOfType<ChannelListItem>().Single(item => item.Channel is ChannelListing.ChannelListingChannel);
 
         private void clickDrawable(Drawable d)
         {
diff --git a/osu.Game/Online/Chat/ChannelManager.cs b/osu.Game/Online/Chat/ChannelManager.cs
index 9e85067f15..b7d67de04d 100644
--- a/osu.Game/Online/Chat/ChannelManager.cs
+++ b/osu.Game/Online/Chat/ChannelManager.cs
@@ -14,7 +14,7 @@ using osu.Game.Input;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests;
 using osu.Game.Online.API.Requests.Responses;
-using osu.Game.Overlays;
+using osu.Game.Overlays.Chat.Listing;
 using osu.Game.Overlays.Chat.Tabs;
 
 namespace osu.Game.Online.Chat
@@ -134,7 +134,7 @@ namespace osu.Game.Online.Chat
 
         private void currentChannelChanged(ValueChangedEvent<Channel> e)
         {
-            bool isSelectorChannel = e.NewValue is ChannelSelectorTabItem.ChannelSelectorTabChannel || e.NewValue is DummySelectorChannel;
+            bool isSelectorChannel = e.NewValue is ChannelSelectorTabItem.ChannelSelectorTabChannel || e.NewValue is ChannelListing.ChannelListingChannel;
 
             if (!isSelectorChannel)
                 JoinChannel(e.NewValue);
diff --git a/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs b/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs
index c9f3a4d380..555b54155c 100644
--- a/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs
+++ b/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs
@@ -13,6 +13,7 @@ using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Online.Chat;
+using osu.Game.Overlays.Chat.Listing;
 
 namespace osu.Game.Overlays.Chat.ChannelList
 {
@@ -23,7 +24,7 @@ namespace osu.Game.Overlays.Chat.ChannelList
 
         private readonly Dictionary<Channel, ChannelListItem> channelMap = new Dictionary<Channel, ChannelListItem>();
 
-        private readonly DummySelectorChannel dummySelectorChannel = new DummySelectorChannel();
+        private readonly ChannelListing.ChannelListingChannel channelListingChannel = new ChannelListing.ChannelListingChannel();
 
         private ChannelListItemFlow publicChannelFlow = null!;
         private ChannelListItemFlow privateChannelFlow = null!;
@@ -53,7 +54,7 @@ namespace osu.Game.Overlays.Chat.ChannelList
                         Children = new Drawable[]
                         {
                             publicChannelFlow = new ChannelListItemFlow("CHANNELS"),
-                            selector = new ChannelListItem(dummySelectorChannel)
+                            selector = new ChannelListItem(channelListingChannel)
                             {
                                 Margin = new MarginPadding { Bottom = 10 },
                             },
diff --git a/osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs b/osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs
index eb2bdfdf8a..2967d9df11 100644
--- a/osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs
+++ b/osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs
@@ -15,6 +15,7 @@ using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Online.Chat;
+using osu.Game.Overlays.Chat.Listing;
 using osu.Game.Users.Drawables;
 using osuTK;
 
@@ -191,6 +192,6 @@ namespace osu.Game.Overlays.Chat.ChannelList
                 text.FadeColour(colourProvider.Light3, 200, Easing.OutQuint);
         }
 
-        private bool isSelector => Channel is DummySelectorChannel;
+        private bool isSelector => Channel is ChannelListing.ChannelListingChannel;
     }
 }
diff --git a/osu.Game/Overlays/Chat/Listing/ChannelListing.cs b/osu.Game/Overlays/Chat/Listing/ChannelListing.cs
index 732c78de15..8a5bc18cbf 100644
--- a/osu.Game/Overlays/Chat/Listing/ChannelListing.cs
+++ b/osu.Game/Overlays/Chat/Listing/ChannelListing.cs
@@ -75,5 +75,14 @@ namespace osu.Game.Overlays.Chat.Listing
         protected override void PopIn() => this.FadeIn();
 
         protected override void PopOut() => this.FadeOut();
+
+        public class ChannelListingChannel : Channel
+        {
+            public ChannelListingChannel()
+            {
+                Name = "Add more channels";
+                Type = ChannelType.System;
+            }
+        }
     }
 }
diff --git a/osu.Game/Overlays/ChatOverlayV2.cs b/osu.Game/Overlays/ChatOverlayV2.cs
index 42c928014a..202d70d99b 100644
--- a/osu.Game/Overlays/ChatOverlayV2.cs
+++ b/osu.Game/Overlays/ChatOverlayV2.cs
@@ -244,7 +244,7 @@ namespace osu.Game.Overlays
         {
             Channel? newChannel = channel.NewValue;
 
-            if (newChannel == null || newChannel is DummySelectorChannel)
+            if (newChannel == null || newChannel is ChannelListing.ChannelListingChannel)
             {
                 // null channel denotes that we should be showing the listing.
                 channelListing.State.Value = Visibility.Visible;
@@ -300,13 +300,4 @@ namespace osu.Game.Overlays
                 channelManager.PostMessage(message);
         }
     }
-
-    public class DummySelectorChannel : Channel
-    {
-        public DummySelectorChannel()
-        {
-            Name = "Add more channels";
-            Type = ChannelType.System;
-        }
-    }
 }

From c37d1e4fae4fe827e7ae36b485407d280fd29ba5 Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Thu, 19 May 2022 11:45:39 +0100
Subject: [PATCH 4916/5547] Ensure current channel is set to the
 `ChannelListingChannel` when it becomes `null`

---
 osu.Game/Overlays/Chat/ChannelList/ChannelList.cs     |  6 +++---
 osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs |  2 +-
 osu.Game/Overlays/ChatOverlayV2.cs                    | 10 ++++++++--
 3 files changed, 12 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs b/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs
index 555b54155c..d1ceae604c 100644
--- a/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs
+++ b/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs
@@ -22,9 +22,9 @@ namespace osu.Game.Overlays.Chat.ChannelList
         public Action<Channel>? OnRequestSelect;
         public Action<Channel>? OnRequestLeave;
 
-        private readonly Dictionary<Channel, ChannelListItem> channelMap = new Dictionary<Channel, ChannelListItem>();
+        public readonly ChannelListing.ChannelListingChannel ChannelListingChannel = new ChannelListing.ChannelListingChannel();
 
-        private readonly ChannelListing.ChannelListingChannel channelListingChannel = new ChannelListing.ChannelListingChannel();
+        private readonly Dictionary<Channel, ChannelListItem> channelMap = new Dictionary<Channel, ChannelListItem>();
 
         private ChannelListItemFlow publicChannelFlow = null!;
         private ChannelListItemFlow privateChannelFlow = null!;
@@ -54,7 +54,7 @@ namespace osu.Game.Overlays.Chat.ChannelList
                         Children = new Drawable[]
                         {
                             publicChannelFlow = new ChannelListItemFlow("CHANNELS"),
-                            selector = new ChannelListItem(channelListingChannel)
+                            selector = new ChannelListItem(ChannelListingChannel)
                             {
                                 Margin = new MarginPadding { Bottom = 10 },
                             },
diff --git a/osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs b/osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs
index 2967d9df11..9ab0c2792a 100644
--- a/osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs
+++ b/osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs
@@ -179,7 +179,7 @@ namespace osu.Game.Overlays.Chat.ChannelList
 
         private void updateState()
         {
-            bool selected = selectedChannel.Value == Channel || (isSelector && selectedChannel.Value == null);
+            bool selected = selectedChannel.Value == Channel;
 
             if (selected)
                 selectBox.FadeIn(300, Easing.OutQuint);
diff --git a/osu.Game/Overlays/ChatOverlayV2.cs b/osu.Game/Overlays/ChatOverlayV2.cs
index 202d70d99b..fe3f8ba8cb 100644
--- a/osu.Game/Overlays/ChatOverlayV2.cs
+++ b/osu.Game/Overlays/ChatOverlayV2.cs
@@ -244,9 +244,15 @@ namespace osu.Game.Overlays
         {
             Channel? newChannel = channel.NewValue;
 
-            if (newChannel == null || newChannel is ChannelListing.ChannelListingChannel)
+            // null channel denotes that we should be showing the listing.
+            if (newChannel == null)
+            {
+                currentChannel.Value = channelList.ChannelListingChannel;
+                return;
+            }
+
+            if (newChannel is ChannelListing.ChannelListingChannel)
             {
-                // null channel denotes that we should be showing the listing.
                 channelListing.State.Value = Visibility.Visible;
                 textBar.ShowSearch.Value = true;
             }

From 3fdff7bbcb5a6f17a736f8e71e59a1fdacf8b3a7 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 17 May 2022 15:11:22 +0900
Subject: [PATCH 4917/5547] Make Meh judgements not drain HP

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

diff --git a/osu.Game/Rulesets/Judgements/Judgement.cs b/osu.Game/Rulesets/Judgements/Judgement.cs
index fd576e9b9f..4fe34e15fd 100644
--- a/osu.Game/Rulesets/Judgements/Judgement.cs
+++ b/osu.Game/Rulesets/Judgements/Judgement.cs
@@ -103,7 +103,7 @@ namespace osu.Game.Rulesets.Judgements
                     return -DEFAULT_MAX_HEALTH_INCREASE;
 
                 case HitResult.Meh:
-                    return -DEFAULT_MAX_HEALTH_INCREASE * 0.05;
+                    return DEFAULT_MAX_HEALTH_INCREASE * 0.05;
 
                 case HitResult.Ok:
                     return DEFAULT_MAX_HEALTH_INCREASE * 0.5;

From ce7be940e2dd4f220583318bdf623a63d0f6e4f9 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 20 May 2022 14:34:33 +0900
Subject: [PATCH 4918/5547] Setup basics for control and test

---
 .../Editing/TestSceneTapTimingControl.cs      |  94 +++++++++
 .../UserInterfaceV2/LabelledDrawable.cs       |   3 +-
 .../Screens/Edit/Timing/TapTimingControl.cs   | 189 ++++++++++++++++++
 osu.Game/Screens/Edit/Timing/TimingSection.cs |   2 +
 4 files changed, 287 insertions(+), 1 deletion(-)
 create mode 100644 osu.Game.Tests/Visual/Editing/TestSceneTapTimingControl.cs
 create mode 100644 osu.Game/Screens/Edit/Timing/TapTimingControl.cs

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneTapTimingControl.cs b/osu.Game.Tests/Visual/Editing/TestSceneTapTimingControl.cs
new file mode 100644
index 0000000000..c2889b2549
--- /dev/null
+++ b/osu.Game.Tests/Visual/Editing/TestSceneTapTimingControl.cs
@@ -0,0 +1,94 @@
+// 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.Bindables;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
+using osu.Framework.Testing;
+using osu.Game.Beatmaps.ControlPoints;
+using osu.Game.Graphics.UserInterfaceV2;
+using osu.Game.Overlays;
+using osu.Game.Rulesets.Edit;
+using osu.Game.Rulesets.Osu;
+using osu.Game.Screens.Edit;
+using osu.Game.Screens.Edit.Timing;
+using osuTK;
+
+namespace osu.Game.Tests.Visual.Editing
+{
+    [TestFixture]
+    public class TestSceneTapTimingControl : EditorClockTestScene
+    {
+        [Cached(typeof(EditorBeatmap))]
+        [Cached(typeof(IBeatSnapProvider))]
+        private readonly EditorBeatmap editorBeatmap;
+
+        [Cached]
+        private readonly OverlayColourProvider colourProvider = new OverlayColourProvider(OverlayColourScheme.Blue);
+
+        [Cached]
+        private Bindable<ControlPointGroup> selectedGroup = new Bindable<ControlPointGroup>();
+
+        private TapTimingControl control;
+
+        public TestSceneTapTimingControl()
+        {
+            editorBeatmap = new EditorBeatmap(CreateBeatmap(new OsuRuleset().RulesetInfo));
+            selectedGroup.Value = editorBeatmap.ControlPointInfo.Groups.First();
+        }
+
+        [Test]
+        public void TestTapThenReset()
+        {
+            AddStep("click tap button", () =>
+            {
+                control.ChildrenOfType<RoundedButton>()
+                       .First(b => b.Text == "Tap to beat")
+                       .TriggerClick();
+            });
+
+            AddUntilStep("wait for track playing", () => Clock.IsRunning);
+
+            AddStep("click reset button", () =>
+            {
+                control.ChildrenOfType<RoundedButton>()
+                       .First(b => b.Text == "Reset")
+                       .TriggerClick();
+            });
+
+            AddUntilStep("wait for track stopped", () => !Clock.IsRunning);
+        }
+
+        [Test]
+        public void TestBasic()
+        {
+        }
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            Beatmap.Value = CreateWorkingBeatmap(editorBeatmap.PlayableBeatmap);
+            Beatmap.Disabled = true;
+
+            Child = new Container
+            {
+                Anchor = Anchor.Centre,
+                Origin = Anchor.Centre,
+                AutoSizeAxes = Axes.Y,
+                Width = 400,
+                Scale = new Vector2(1.5f),
+                Child = control = new TapTimingControl(),
+            };
+        }
+
+        protected override void Dispose(bool isDisposing)
+        {
+            Beatmap.Disabled = false;
+            base.Dispose(isDisposing);
+        }
+    }
+}
diff --git a/osu.Game/Graphics/UserInterfaceV2/LabelledDrawable.cs b/osu.Game/Graphics/UserInterfaceV2/LabelledDrawable.cs
index 1e6032c1d0..066e1a7978 100644
--- a/osu.Game/Graphics/UserInterfaceV2/LabelledDrawable.cs
+++ b/osu.Game/Graphics/UserInterfaceV2/LabelledDrawable.cs
@@ -41,7 +41,8 @@ namespace osu.Game.Graphics.UserInterfaceV2
 
         protected const float CONTENT_PADDING_VERTICAL = 10;
         protected const float CONTENT_PADDING_HORIZONTAL = 15;
-        protected const float CORNER_RADIUS = 15;
+
+        public const float CORNER_RADIUS = 15;
 
         /// <summary>
         /// The component that is being displayed.
diff --git a/osu.Game/Screens/Edit/Timing/TapTimingControl.cs b/osu.Game/Screens/Edit/Timing/TapTimingControl.cs
new file mode 100644
index 0000000000..3867a4bcec
--- /dev/null
+++ b/osu.Game/Screens/Edit/Timing/TapTimingControl.cs
@@ -0,0 +1,189 @@
+// 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.Game.Graphics;
+using osu.Game.Graphics.Containers;
+using osu.Game.Graphics.Sprites;
+using osu.Game.Graphics.UserInterfaceV2;
+using osu.Game.Overlays;
+using osuTK;
+
+namespace osu.Game.Screens.Edit.Timing
+{
+    public class TapTimingControl : CompositeDrawable
+    {
+        [Resolved]
+        private EditorClock editorClock { get; set; }
+
+        [BackgroundDependencyLoader]
+        private void load(OverlayColourProvider colourProvider, OsuColour colours)
+        {
+            Height = 200;
+            RelativeSizeAxes = Axes.X;
+
+            CornerRadius = LabelledDrawable<Drawable>.CORNER_RADIUS;
+            Masking = true;
+
+            InternalChildren = new Drawable[]
+            {
+                new Box
+                {
+                    Colour = colourProvider.Background4,
+                    RelativeSizeAxes = Axes.Both,
+                },
+                new GridContainer
+                {
+                    RelativeSizeAxes = Axes.Both,
+                    RowDimensions = new[]
+                    {
+                        new Dimension(),
+                        new Dimension(GridSizeMode.Absolute, 60),
+                    },
+                    Content = new[]
+                    {
+                        new Drawable[]
+                        {
+                            new Metronome()
+                        },
+                        new Drawable[]
+                        {
+                            new Container
+                            {
+                                RelativeSizeAxes = Axes.Both,
+                                Padding = new MarginPadding(10),
+                                Children = new Drawable[]
+                                {
+                                    new RoundedButton
+                                    {
+                                        Text = "Reset",
+                                        BackgroundColour = colours.Pink,
+                                        RelativeSizeAxes = Axes.X,
+                                        Width = 0.3f,
+                                        Action = reset,
+                                    },
+                                    new RoundedButton
+                                    {
+                                        Anchor = Anchor.TopRight,
+                                        Origin = Anchor.TopRight,
+                                        Text = "Tap to beat",
+                                        RelativeSizeAxes = Axes.X,
+                                        BackgroundColour = colourProvider.Background1,
+                                        Width = 0.68f,
+                                        Action = tap,
+                                    }
+                                }
+                            },
+                        }
+                    }
+                },
+            };
+        }
+
+        private void tap()
+        {
+            if (!editorClock.IsRunning)
+            {
+                editorClock.Seek(0);
+                editorClock.Start();
+            }
+        }
+
+        private void reset()
+        {
+            editorClock.Stop();
+        }
+
+        private class Metronome : BeatSyncedContainer
+        {
+            private Container swing;
+            private Box weight;
+            private OsuSpriteText bpm;
+
+            [BackgroundDependencyLoader]
+            private void load(OverlayColourProvider overlayColourProvider)
+            {
+                Margin = new MarginPadding(10);
+                AutoSizeAxes = Axes.Both;
+
+                InternalChildren = new Drawable[]
+                {
+                    new Triangle
+                    {
+                        Anchor = Anchor.Centre,
+                        Origin = Anchor.Centre,
+                        Size = new Vector2(80, 120),
+                        Colour = overlayColourProvider.Background1,
+                    },
+                    new Circle
+                    {
+                        Y = -25,
+                        Anchor = Anchor.BottomCentre,
+                        Origin = Anchor.Centre,
+                        Colour = overlayColourProvider.Content2,
+                        Size = new Vector2(10)
+                    },
+                    bpm = new OsuSpriteText
+                    {
+                        Colour = overlayColourProvider.Content1,
+                        Anchor = Anchor.Centre,
+                        Origin = Anchor.Centre,
+                    },
+                    swing = new Container
+                    {
+                        RelativeSizeAxes = Axes.Both,
+                        Y = -25,
+                        Height = 0.8f,
+                        Anchor = Anchor.BottomCentre,
+                        Origin = Anchor.BottomCentre,
+                        Children = new Drawable[]
+                        {
+                            new Box
+                            {
+                                Colour = overlayColourProvider.Content2,
+                                RelativeSizeAxes = Axes.Y,
+                                Anchor = Anchor.BottomCentre,
+                                Origin = Anchor.BottomCentre,
+                                Width = 4,
+                            },
+                            weight = new Box
+                            {
+                                Anchor = Anchor.TopCentre,
+                                Origin = Anchor.Centre,
+                                Colour = overlayColourProvider.Content2,
+                                Size = new Vector2(15),
+                                RelativePositionAxes = Axes.Y,
+                                Y = -0.4f,
+                            },
+                        }
+                    },
+                };
+            }
+
+            protected override void LoadComplete()
+            {
+                base.LoadComplete();
+                swing
+                    .RotateTo(20, 500, Easing.InOutQuad)
+                    .Then()
+                    .RotateTo(-20, 500, Easing.InOutQuad)
+                    .Loop();
+            }
+
+            protected override void Update()
+            {
+                base.Update();
+
+                if (CurrentTimingPoint == null)
+                    return;
+
+                weight.Y = Math.Clamp((float)CurrentTimingPoint.BPM / 480, 0, 0.95f);
+                bpm.Text = $"{CurrentTimingPoint.BPM:F0}";
+            }
+        }
+    }
+}
diff --git a/osu.Game/Screens/Edit/Timing/TimingSection.cs b/osu.Game/Screens/Edit/Timing/TimingSection.cs
index 13af04cd4b..be719d0cb6 100644
--- a/osu.Game/Screens/Edit/Timing/TimingSection.cs
+++ b/osu.Game/Screens/Edit/Timing/TimingSection.cs
@@ -19,6 +19,7 @@ namespace osu.Game.Screens.Edit.Timing
         {
             Flow.AddRange(new Drawable[]
             {
+                new TapTimingControl(),
                 bpmTextEntry = new BPMTextBox(),
                 timeSignature = new LabelledTimeSignature
                 {
@@ -96,5 +97,6 @@ namespace osu.Game.Screens.Edit.Timing
         }
 
         private static double beatLengthToBpm(double beatLength) => 60000 / beatLength;
+
     }
 }

From 42179568f3aca7d67c574ae615dcf8c65920eae3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 20 May 2022 15:56:39 +0900
Subject: [PATCH 4919/5547] Initial animation pass on metronome

---
 .../Editing/TestSceneTapTimingControl.cs      |  58 +++++++---
 .../Screens/Edit/Timing/TapTimingControl.cs   | 105 +++++++++++++-----
 osu.Game/Screens/Edit/Timing/TimingSection.cs |   1 -
 3 files changed, 117 insertions(+), 47 deletions(-)

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneTapTimingControl.cs b/osu.Game.Tests/Visual/Editing/TestSceneTapTimingControl.cs
index c2889b2549..9b2618df5b 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneTapTimingControl.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneTapTimingControl.cs
@@ -36,10 +36,37 @@ namespace osu.Game.Tests.Visual.Editing
 
         public TestSceneTapTimingControl()
         {
-            editorBeatmap = new EditorBeatmap(CreateBeatmap(new OsuRuleset().RulesetInfo));
+            var playableBeatmap = CreateBeatmap(new OsuRuleset().RulesetInfo);
+
+            // Ensure time doesn't end while testing
+            playableBeatmap.BeatmapInfo.Length = 1200000;
+
+            editorBeatmap = new EditorBeatmap(playableBeatmap);
+
             selectedGroup.Value = editorBeatmap.ControlPointInfo.Groups.First();
         }
 
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            Beatmap.Value = CreateWorkingBeatmap(editorBeatmap.PlayableBeatmap);
+            Beatmap.Disabled = true;
+
+            Children = new Drawable[]
+            {
+                new Container
+                {
+                    Anchor = Anchor.Centre,
+                    Origin = Anchor.Centre,
+                    AutoSizeAxes = Axes.Y,
+                    Width = 400,
+                    Scale = new Vector2(1.5f),
+                    Child = control = new TapTimingControl(),
+                }
+            };
+        }
+
         [Test]
         public void TestTapThenReset()
         {
@@ -65,24 +92,19 @@ namespace osu.Game.Tests.Visual.Editing
         [Test]
         public void TestBasic()
         {
-        }
-
-        protected override void LoadComplete()
-        {
-            base.LoadComplete();
-
-            Beatmap.Value = CreateWorkingBeatmap(editorBeatmap.PlayableBeatmap);
-            Beatmap.Disabled = true;
-
-            Child = new Container
+            AddStep("set low bpm", () =>
             {
-                Anchor = Anchor.Centre,
-                Origin = Anchor.Centre,
-                AutoSizeAxes = Axes.Y,
-                Width = 400,
-                Scale = new Vector2(1.5f),
-                Child = control = new TapTimingControl(),
-            };
+                editorBeatmap.ControlPointInfo.TimingPoints.First().BeatLength = 1000;
+            });
+
+            AddStep("click tap button", () =>
+            {
+                control.ChildrenOfType<RoundedButton>()
+                       .First(b => b.Text == "Tap to beat")
+                       .TriggerClick();
+            });
+
+            AddSliderStep("BPM", 30, 400, 60, bpm => editorBeatmap.ControlPointInfo.TimingPoints.First().BeatLength = 60000f / bpm);
         }
 
         protected override void Dispose(bool isDisposing)
diff --git a/osu.Game/Screens/Edit/Timing/TapTimingControl.cs b/osu.Game/Screens/Edit/Timing/TapTimingControl.cs
index 3867a4bcec..e23982ddc7 100644
--- a/osu.Game/Screens/Edit/Timing/TapTimingControl.cs
+++ b/osu.Game/Screens/Edit/Timing/TapTimingControl.cs
@@ -3,15 +3,19 @@
 
 using System;
 using osu.Framework.Allocation;
+using osu.Framework.Audio.Track;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
+using osu.Framework.Utils;
+using osu.Game.Beatmaps.ControlPoints;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.UserInterfaceV2;
 using osu.Game.Overlays;
 using osuTK;
+using osuTK.Graphics;
 
 namespace osu.Game.Screens.Edit.Timing
 {
@@ -103,9 +107,13 @@ namespace osu.Game.Screens.Edit.Timing
             private Container swing;
             private Box weight;
             private OsuSpriteText bpm;
+            private Box stick;
+
+            [Resolved]
+            private OverlayColourProvider overlayColourProvider { get; set; }
 
             [BackgroundDependencyLoader]
-            private void load(OverlayColourProvider overlayColourProvider)
+            private void load()
             {
                 Margin = new MarginPadding(10);
                 AutoSizeAxes = Axes.Both;
@@ -117,21 +125,13 @@ namespace osu.Game.Screens.Edit.Timing
                         Anchor = Anchor.Centre,
                         Origin = Anchor.Centre,
                         Size = new Vector2(80, 120),
-                        Colour = overlayColourProvider.Background1,
-                    },
-                    new Circle
-                    {
-                        Y = -25,
-                        Anchor = Anchor.BottomCentre,
-                        Origin = Anchor.Centre,
-                        Colour = overlayColourProvider.Content2,
-                        Size = new Vector2(10)
+                        Colour = overlayColourProvider.Background2,
                     },
                     bpm = new OsuSpriteText
                     {
                         Colour = overlayColourProvider.Content1,
-                        Anchor = Anchor.Centre,
-                        Origin = Anchor.Centre,
+                        Anchor = Anchor.BottomCentre,
+                        Origin = Anchor.BottomCentre,
                     },
                     swing = new Container
                     {
@@ -142,10 +142,10 @@ namespace osu.Game.Screens.Edit.Timing
                         Origin = Anchor.BottomCentre,
                         Children = new Drawable[]
                         {
-                            new Box
+                            stick = new Box
                             {
-                                Colour = overlayColourProvider.Content2,
                                 RelativeSizeAxes = Axes.Y,
+                                Colour = overlayColourProvider.Colour2,
                                 Anchor = Anchor.BottomCentre,
                                 Origin = Anchor.BottomCentre,
                                 Width = 4,
@@ -154,35 +154,84 @@ namespace osu.Game.Screens.Edit.Timing
                             {
                                 Anchor = Anchor.TopCentre,
                                 Origin = Anchor.Centre,
-                                Colour = overlayColourProvider.Content2,
+                                Colour = overlayColourProvider.Colour1,
                                 Size = new Vector2(15),
                                 RelativePositionAxes = Axes.Y,
-                                Y = -0.4f,
+                                Y = 0.4f,
                             },
                         }
                     },
+                    new Circle
+                    {
+                        Y = -25,
+                        Anchor = Anchor.BottomCentre,
+                        Origin = Anchor.Centre,
+                        Colour = overlayColourProvider.Colour0,
+                        Size = new Vector2(10)
+                    },
                 };
             }
 
-            protected override void LoadComplete()
-            {
-                base.LoadComplete();
-                swing
-                    .RotateTo(20, 500, Easing.InOutQuad)
-                    .Then()
-                    .RotateTo(-20, 500, Easing.InOutQuad)
-                    .Loop();
-            }
+            private double beatLength;
+
+            private TimingControlPoint timingPoint;
+
+            private float bpmRatio;
+            private bool isSwinging;
 
             protected override void Update()
             {
                 base.Update();
 
-                if (CurrentTimingPoint == null)
+                timingPoint = Beatmap.Value.Beatmap.ControlPointInfo.TimingPointAt(BeatSyncClock.CurrentTime);
+
+                if (beatLength != timingPoint.BeatLength)
+                {
+                    beatLength = timingPoint.BeatLength;
+                    bpm.Text = $"{timingPoint.BPM:F0}";
+
+                    EarlyActivationMilliseconds = timingPoint.BeatLength / 2;
+
+                    bpmRatio = (float)Interpolation.ApplyEasing(Easing.OutQuad, Math.Clamp((timingPoint.BPM - 30) / 480, 0, 1));
+
+                    weight.MoveToY((float)Interpolation.Lerp(0, 0.9f, bpmRatio), 600, Easing.OutQuint);
+                }
+
+                if (BeatSyncClock?.IsRunning != true && isSwinging)
+                {
+                    swing.ClearTransforms(true);
+
+                    using (swing.BeginDelayedSequence(350))
+                    {
+                        swing.RotateTo(0, 1000, Easing.OutQuint);
+                        stick.FadeColour(overlayColourProvider.Colour2, 1000, Easing.OutQuint);
+                    }
+
+                    isSwinging = false;
+                }
+            }
+
+            protected override void OnNewBeat(int beatIndex, TimingControlPoint timingPoint, EffectControlPoint effectPoint, ChannelAmplitudes amplitudes)
+            {
+                base.OnNewBeat(beatIndex, timingPoint, effectPoint, amplitudes);
+
+                float angle = (float)Interpolation.Lerp(25, 4, bpmRatio);
+
+                if (!IsBeatSyncedWithTrack)
                     return;
 
-                weight.Y = Math.Clamp((float)CurrentTimingPoint.BPM / 480, 0, 0.95f);
-                bpm.Text = $"{CurrentTimingPoint.BPM:F0}";
+                isSwinging = true;
+
+                float currentAngle = swing.Rotation;
+                float targetAngle = currentAngle > 0 ? -angle : angle;
+
+                swing.RotateTo(targetAngle, beatLength, Easing.InOutQuad);
+
+                if (currentAngle != 0 && Math.Abs(currentAngle - targetAngle) > angle * 1.8f && isSwinging)
+                {
+                    using (stick.BeginDelayedSequence(beatLength / 2))
+                        stick.FlashColour(overlayColourProvider.Content1, beatLength, Easing.OutQuint);
+                }
             }
         }
     }
diff --git a/osu.Game/Screens/Edit/Timing/TimingSection.cs b/osu.Game/Screens/Edit/Timing/TimingSection.cs
index be719d0cb6..a5abd96d72 100644
--- a/osu.Game/Screens/Edit/Timing/TimingSection.cs
+++ b/osu.Game/Screens/Edit/Timing/TimingSection.cs
@@ -97,6 +97,5 @@ namespace osu.Game.Screens.Edit.Timing
         }
 
         private static double beatLengthToBpm(double beatLength) => 60000 / beatLength;
-
     }
 }

From cf1ef28f72235a4f5d742e3d404ccfd94d2dcab1 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 20 May 2022 16:22:16 +0900
Subject: [PATCH 4920/5547] Add taper and more correctly shaped weight

---
 .../Screens/Edit/Timing/TapTimingControl.cs   | 91 ++++++++++++++-----
 1 file changed, 70 insertions(+), 21 deletions(-)

diff --git a/osu.Game/Screens/Edit/Timing/TapTimingControl.cs b/osu.Game/Screens/Edit/Timing/TapTimingControl.cs
index e23982ddc7..7507a7dd35 100644
--- a/osu.Game/Screens/Edit/Timing/TapTimingControl.cs
+++ b/osu.Game/Screens/Edit/Timing/TapTimingControl.cs
@@ -15,7 +15,6 @@ using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.UserInterfaceV2;
 using osu.Game.Overlays;
 using osuTK;
-using osuTK.Graphics;
 
 namespace osu.Game.Screens.Edit.Timing
 {
@@ -105,9 +104,11 @@ namespace osu.Game.Screens.Edit.Timing
         private class Metronome : BeatSyncedContainer
         {
             private Container swing;
-            private Box weight;
+
             private OsuSpriteText bpm;
-            private Box stick;
+
+            private Drawable weight;
+            private Drawable stick;
 
             [Resolved]
             private OverlayColourProvider overlayColourProvider { get; set; }
@@ -116,33 +117,41 @@ namespace osu.Game.Screens.Edit.Timing
             private void load()
             {
                 Margin = new MarginPadding(10);
+
+                const float taper = 10;
+
+                var triangleSize = new Vector2(80, 120);
+
                 AutoSizeAxes = Axes.Both;
 
+                const float stick_vertical_offset = -23;
+
                 InternalChildren = new Drawable[]
                 {
-                    new Triangle
+                    new Container
                     {
-                        Anchor = Anchor.Centre,
-                        Origin = Anchor.Centre,
-                        Size = new Vector2(80, 120),
-                        Colour = overlayColourProvider.Background2,
-                    },
-                    bpm = new OsuSpriteText
-                    {
-                        Colour = overlayColourProvider.Content1,
+                        Masking = true,
                         Anchor = Anchor.BottomCentre,
                         Origin = Anchor.BottomCentre,
+                        Size = new Vector2(triangleSize.X * 1.2f, triangleSize.Y - taper),
+                        Child = new Triangle
+                        {
+                            Anchor = Anchor.BottomCentre,
+                            Origin = Anchor.BottomCentre,
+                            Size = triangleSize,
+                            Colour = overlayColourProvider.Background3,
+                        },
                     },
                     swing = new Container
                     {
                         RelativeSizeAxes = Axes.Both,
-                        Y = -25,
+                        Y = stick_vertical_offset,
                         Height = 0.8f,
                         Anchor = Anchor.BottomCentre,
                         Origin = Anchor.BottomCentre,
-                        Children = new Drawable[]
+                        Children = new[]
                         {
-                            stick = new Box
+                            stick = new Circle
                             {
                                 RelativeSizeAxes = Axes.Y,
                                 Colour = overlayColourProvider.Colour2,
@@ -150,24 +159,64 @@ namespace osu.Game.Screens.Edit.Timing
                                 Origin = Anchor.BottomCentre,
                                 Width = 4,
                             },
-                            weight = new Box
+                            weight = new Container
                             {
                                 Anchor = Anchor.TopCentre,
                                 Origin = Anchor.Centre,
                                 Colour = overlayColourProvider.Colour1,
-                                Size = new Vector2(15),
+                                Size = new Vector2(10),
+                                Rotation = 180,
                                 RelativePositionAxes = Axes.Y,
                                 Y = 0.4f,
+                                Children = new Drawable[]
+                                {
+                                    new Box
+                                    {
+                                        RelativeSizeAxes = Axes.Both,
+                                        Shear = new Vector2(0.2f, 0),
+                                    },
+                                    new Box
+                                    {
+                                        RelativeSizeAxes = Axes.Both,
+                                        Shear = new Vector2(-0.2f, 0),
+                                    },
+                                }
                             },
                         }
                     },
                     new Circle
                     {
-                        Y = -25,
+                        Y = stick_vertical_offset,
                         Anchor = Anchor.BottomCentre,
                         Origin = Anchor.Centre,
                         Colour = overlayColourProvider.Colour0,
-                        Size = new Vector2(10)
+                        Size = new Vector2(8)
+                    },
+                    new Container
+                    {
+                        Anchor = Anchor.BottomCentre,
+                        Origin = Anchor.BottomCentre,
+                        RelativeSizeAxes = Axes.Both,
+                        Masking = true,
+                        Height = 0.3f,
+                        Children = new Drawable[]
+                        {
+                            new Triangle
+                            {
+                                Anchor = Anchor.BottomCentre,
+                                Origin = Anchor.BottomCentre,
+                                Size = triangleSize,
+                                Colour = overlayColourProvider.Background2,
+                                Alpha = 0.8f
+                            },
+                        }
+                    },
+                    bpm = new OsuSpriteText
+                    {
+                        Colour = overlayColourProvider.Content1,
+                        Anchor = Anchor.BottomCentre,
+                        Origin = Anchor.BottomCentre,
+                        Y = -3,
                     },
                 };
             }
@@ -194,7 +243,7 @@ namespace osu.Game.Screens.Edit.Timing
 
                     bpmRatio = (float)Interpolation.ApplyEasing(Easing.OutQuad, Math.Clamp((timingPoint.BPM - 30) / 480, 0, 1));
 
-                    weight.MoveToY((float)Interpolation.Lerp(0, 0.9f, bpmRatio), 600, Easing.OutQuint);
+                    weight.MoveToY((float)Interpolation.Lerp(0.07f, 0.9f, bpmRatio), 600, Easing.OutQuint);
                 }
 
                 if (BeatSyncClock?.IsRunning != true && isSwinging)
@@ -215,7 +264,7 @@ namespace osu.Game.Screens.Edit.Timing
             {
                 base.OnNewBeat(beatIndex, timingPoint, effectPoint, amplitudes);
 
-                float angle = (float)Interpolation.Lerp(25, 4, bpmRatio);
+                float angle = (float)Interpolation.Lerp(30, 5, bpmRatio);
 
                 if (!IsBeatSyncedWithTrack)
                     return;

From 79878a4ec21cab922d4ed10295fa0f9eac8ecda2 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 20 May 2022 16:25:24 +0900
Subject: [PATCH 4921/5547] Metrics adjust and labelling

---
 .../Screens/Edit/Timing/TapTimingControl.cs   | 25 ++++++++++++-------
 1 file changed, 16 insertions(+), 9 deletions(-)

diff --git a/osu.Game/Screens/Edit/Timing/TapTimingControl.cs b/osu.Game/Screens/Edit/Timing/TapTimingControl.cs
index 7507a7dd35..3aff74d359 100644
--- a/osu.Game/Screens/Edit/Timing/TapTimingControl.cs
+++ b/osu.Game/Screens/Edit/Timing/TapTimingControl.cs
@@ -116,26 +116,27 @@ namespace osu.Game.Screens.Edit.Timing
             [BackgroundDependencyLoader]
             private void load()
             {
+                const float taper = 30;
+                const float swing_vertical_offset = -23;
+
+                var triangleSize = new Vector2(90, 120 + taper);
+
                 Margin = new MarginPadding(10);
 
-                const float taper = 10;
-
-                var triangleSize = new Vector2(80, 120);
-
                 AutoSizeAxes = Axes.Both;
 
-                const float stick_vertical_offset = -23;
-
                 InternalChildren = new Drawable[]
                 {
                     new Container
                     {
+                        Name = @"Taper adjust",
                         Masking = true,
                         Anchor = Anchor.BottomCentre,
                         Origin = Anchor.BottomCentre,
                         Size = new Vector2(triangleSize.X * 1.2f, triangleSize.Y - taper),
                         Child = new Triangle
                         {
+                            Name = @"Main body",
                             Anchor = Anchor.BottomCentre,
                             Origin = Anchor.BottomCentre,
                             Size = triangleSize,
@@ -144,15 +145,17 @@ namespace osu.Game.Screens.Edit.Timing
                     },
                     swing = new Container
                     {
+                        Name = @"Swing",
                         RelativeSizeAxes = Axes.Both,
-                        Y = stick_vertical_offset,
-                        Height = 0.8f,
+                        Y = swing_vertical_offset,
+                        Height = 0.80f,
                         Anchor = Anchor.BottomCentre,
                         Origin = Anchor.BottomCentre,
                         Children = new[]
                         {
                             stick = new Circle
                             {
+                                Name = @"Stick",
                                 RelativeSizeAxes = Axes.Y,
                                 Colour = overlayColourProvider.Colour2,
                                 Anchor = Anchor.BottomCentre,
@@ -161,6 +164,7 @@ namespace osu.Game.Screens.Edit.Timing
                             },
                             weight = new Container
                             {
+                                Name = @"Weight",
                                 Anchor = Anchor.TopCentre,
                                 Origin = Anchor.Centre,
                                 Colour = overlayColourProvider.Colour1,
@@ -186,7 +190,8 @@ namespace osu.Game.Screens.Edit.Timing
                     },
                     new Circle
                     {
-                        Y = stick_vertical_offset,
+                        Name = @"Swing connection point",
+                        Y = swing_vertical_offset,
                         Anchor = Anchor.BottomCentre,
                         Origin = Anchor.Centre,
                         Colour = overlayColourProvider.Colour0,
@@ -194,6 +199,7 @@ namespace osu.Game.Screens.Edit.Timing
                     },
                     new Container
                     {
+                        Name = @"Lower cover",
                         Anchor = Anchor.BottomCentre,
                         Origin = Anchor.BottomCentre,
                         RelativeSizeAxes = Axes.Both,
@@ -213,6 +219,7 @@ namespace osu.Game.Screens.Edit.Timing
                     },
                     bpm = new OsuSpriteText
                     {
+                        Name = @"BPM display",
                         Colour = overlayColourProvider.Content1,
                         Anchor = Anchor.BottomCentre,
                         Origin = Anchor.BottomCentre,

From 21072a26ef30547bbbee7b802bcd918caac4296c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 20 May 2022 16:33:27 +0900
Subject: [PATCH 4922/5547] Add locking wedge

---
 .../Screens/Edit/Timing/TapTimingControl.cs   | 36 +++++++++++++++----
 1 file changed, 29 insertions(+), 7 deletions(-)

diff --git a/osu.Game/Screens/Edit/Timing/TapTimingControl.cs b/osu.Game/Screens/Edit/Timing/TapTimingControl.cs
index 3aff74d359..323561f0a8 100644
--- a/osu.Game/Screens/Edit/Timing/TapTimingControl.cs
+++ b/osu.Game/Screens/Edit/Timing/TapTimingControl.cs
@@ -133,14 +133,17 @@ namespace osu.Game.Screens.Edit.Timing
                         Masking = true,
                         Anchor = Anchor.BottomCentre,
                         Origin = Anchor.BottomCentre,
-                        Size = new Vector2(triangleSize.X * 1.2f, triangleSize.Y - taper),
-                        Child = new Triangle
+                        Size = new Vector2(triangleSize.X, triangleSize.Y - taper),
+                        Children = new Drawable[]
                         {
-                            Name = @"Main body",
-                            Anchor = Anchor.BottomCentre,
-                            Origin = Anchor.BottomCentre,
-                            Size = triangleSize,
-                            Colour = overlayColourProvider.Background3,
+                            new Triangle
+                            {
+                                Name = @"Main body",
+                                Anchor = Anchor.BottomCentre,
+                                Origin = Anchor.BottomCentre,
+                                Size = triangleSize,
+                                Colour = overlayColourProvider.Background3,
+                            },
                         },
                     },
                     swing = new Container
@@ -188,6 +191,25 @@ namespace osu.Game.Screens.Edit.Timing
                             },
                         }
                     },
+                    new Container
+                    {
+                        Name = @"Taper adjust",
+                        Masking = true,
+                        Anchor = Anchor.BottomCentre,
+                        Origin = Anchor.BottomCentre,
+                        Size = new Vector2(triangleSize.X, triangleSize.Y - taper),
+                        Children = new Drawable[]
+                        {
+                            new Circle
+                            {
+                                Name = @"Locking wedge",
+                                Anchor = Anchor.TopCentre,
+                                Origin = Anchor.Centre,
+                                Colour = overlayColourProvider.Background1,
+                                Size = new Vector2(8),
+                            }
+                        },
+                    },
                     new Circle
                     {
                         Name = @"Swing connection point",

From 8487d2c48a41010245ba0b1a527ab821935520ac Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 20 May 2022 16:45:01 +0900
Subject: [PATCH 4923/5547] Interpolate bpm label and fix incorrect angle logic

---
 .../Screens/Edit/Timing/TapTimingControl.cs   | 27 ++++++++++++-------
 1 file changed, 18 insertions(+), 9 deletions(-)

diff --git a/osu.Game/Screens/Edit/Timing/TapTimingControl.cs b/osu.Game/Screens/Edit/Timing/TapTimingControl.cs
index 323561f0a8..4ab731c897 100644
--- a/osu.Game/Screens/Edit/Timing/TapTimingControl.cs
+++ b/osu.Game/Screens/Edit/Timing/TapTimingControl.cs
@@ -4,6 +4,7 @@
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Audio.Track;
+using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
@@ -105,7 +106,7 @@ namespace osu.Game.Screens.Edit.Timing
         {
             private Container swing;
 
-            private OsuSpriteText bpm;
+            private OsuSpriteText bpmText;
 
             private Drawable weight;
             private Drawable stick;
@@ -116,7 +117,7 @@ namespace osu.Game.Screens.Edit.Timing
             [BackgroundDependencyLoader]
             private void load()
             {
-                const float taper = 30;
+                const float taper = 25;
                 const float swing_vertical_offset = -23;
 
                 var triangleSize = new Vector2(90, 120 + taper);
@@ -226,7 +227,7 @@ namespace osu.Game.Screens.Edit.Timing
                         Origin = Anchor.BottomCentre,
                         RelativeSizeAxes = Axes.Both,
                         Masking = true,
-                        Height = 0.3f,
+                        Height = 0.28f,
                         Children = new Drawable[]
                         {
                             new Triangle
@@ -239,7 +240,7 @@ namespace osu.Game.Screens.Edit.Timing
                             },
                         }
                     },
-                    bpm = new OsuSpriteText
+                    bpmText = new OsuSpriteText
                     {
                         Name = @"BPM display",
                         Colour = overlayColourProvider.Content1,
@@ -254,9 +255,17 @@ namespace osu.Game.Screens.Edit.Timing
 
             private TimingControlPoint timingPoint;
 
-            private float bpmRatio;
             private bool isSwinging;
 
+            private readonly BindableInt interpolatedBpm = new BindableInt();
+
+            protected override void LoadComplete()
+            {
+                base.LoadComplete();
+
+                interpolatedBpm.BindValueChanged(bpm => bpmText.Text = bpm.NewValue.ToString());
+            }
+
             protected override void Update()
             {
                 base.Update();
@@ -266,13 +275,13 @@ namespace osu.Game.Screens.Edit.Timing
                 if (beatLength != timingPoint.BeatLength)
                 {
                     beatLength = timingPoint.BeatLength;
-                    bpm.Text = $"{timingPoint.BPM:F0}";
 
                     EarlyActivationMilliseconds = timingPoint.BeatLength / 2;
 
-                    bpmRatio = (float)Interpolation.ApplyEasing(Easing.OutQuad, Math.Clamp((timingPoint.BPM - 30) / 480, 0, 1));
+                    float bpmRatio = (float)Interpolation.ApplyEasing(Easing.OutQuad, Math.Clamp((timingPoint.BPM - 30) / 480, 0, 1));
 
-                    weight.MoveToY((float)Interpolation.Lerp(0.07f, 0.9f, bpmRatio), 600, Easing.OutQuint);
+                    weight.MoveToY((float)Interpolation.Lerp(0.1f, 0.83f, bpmRatio), 600, Easing.OutQuint);
+                    this.TransformBindableTo(interpolatedBpm, (int)timingPoint.BPM, 600, Easing.OutQuint);
                 }
 
                 if (BeatSyncClock?.IsRunning != true && isSwinging)
@@ -293,7 +302,7 @@ namespace osu.Game.Screens.Edit.Timing
             {
                 base.OnNewBeat(beatIndex, timingPoint, effectPoint, amplitudes);
 
-                float angle = (float)Interpolation.Lerp(30, 5, bpmRatio);
+                const float angle = 27.5f;
 
                 if (!IsBeatSyncedWithTrack)
                     return;

From 4712e512d71810e0be81428275382372eca91fac Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 20 May 2022 16:48:07 +0900
Subject: [PATCH 4924/5547] Apply edge smoothness and make weight more accented

---
 osu.Game/Screens/Edit/Timing/TapTimingControl.cs | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Edit/Timing/TapTimingControl.cs b/osu.Game/Screens/Edit/Timing/TapTimingControl.cs
index 4ab731c897..bdab427c58 100644
--- a/osu.Game/Screens/Edit/Timing/TapTimingControl.cs
+++ b/osu.Game/Screens/Edit/Timing/TapTimingControl.cs
@@ -140,6 +140,7 @@ namespace osu.Game.Screens.Edit.Timing
                             new Triangle
                             {
                                 Name = @"Main body",
+                                EdgeSmoothness = new Vector2(1),
                                 Anchor = Anchor.BottomCentre,
                                 Origin = Anchor.BottomCentre,
                                 Size = triangleSize,
@@ -171,7 +172,7 @@ namespace osu.Game.Screens.Edit.Timing
                                 Name = @"Weight",
                                 Anchor = Anchor.TopCentre,
                                 Origin = Anchor.Centre,
-                                Colour = overlayColourProvider.Colour1,
+                                Colour = overlayColourProvider.Colour0,
                                 Size = new Vector2(10),
                                 Rotation = 180,
                                 RelativePositionAxes = Axes.Y,
@@ -182,11 +183,13 @@ namespace osu.Game.Screens.Edit.Timing
                                     {
                                         RelativeSizeAxes = Axes.Both,
                                         Shear = new Vector2(0.2f, 0),
+                                        EdgeSmoothness = new Vector2(1),
                                     },
                                     new Box
                                     {
                                         RelativeSizeAxes = Axes.Both,
                                         Shear = new Vector2(-0.2f, 0),
+                                        EdgeSmoothness = new Vector2(1),
                                     },
                                 }
                             },
@@ -236,6 +239,7 @@ namespace osu.Game.Screens.Edit.Timing
                                 Origin = Anchor.BottomCentre,
                                 Size = triangleSize,
                                 Colour = overlayColourProvider.Background2,
+                                EdgeSmoothness = new Vector2(1),
                                 Alpha = 0.8f
                             },
                         }

From cf97f4e409aa57e7883b0a36d037ae588c4683b7 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 20 May 2022 16:55:07 +0900
Subject: [PATCH 4925/5547] Add centre marker

---
 osu.Game/Screens/Edit/Timing/TapTimingControl.cs | 16 ++++++++++++++--
 1 file changed, 14 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/Edit/Timing/TapTimingControl.cs b/osu.Game/Screens/Edit/Timing/TapTimingControl.cs
index bdab427c58..a99468fbff 100644
--- a/osu.Game/Screens/Edit/Timing/TapTimingControl.cs
+++ b/osu.Game/Screens/Edit/Timing/TapTimingControl.cs
@@ -119,6 +119,7 @@ namespace osu.Game.Screens.Edit.Timing
             {
                 const float taper = 25;
                 const float swing_vertical_offset = -23;
+                const float lower_cover_height = 32;
 
                 var triangleSize = new Vector2(90, 120 + taper);
 
@@ -148,6 +149,17 @@ namespace osu.Game.Screens.Edit.Timing
                             },
                         },
                     },
+                    new Circle
+                    {
+                        Name = "Centre marker",
+                        Colour = overlayColourProvider.Background5,
+                        RelativeSizeAxes = Axes.Y,
+                        Width = 2,
+                        Anchor = Anchor.BottomCentre,
+                        Origin = Anchor.BottomCentre,
+                        Y = -(lower_cover_height + 3),
+                        Height = 0.65f,
+                    },
                     swing = new Container
                     {
                         Name = @"Swing",
@@ -228,9 +240,9 @@ namespace osu.Game.Screens.Edit.Timing
                         Name = @"Lower cover",
                         Anchor = Anchor.BottomCentre,
                         Origin = Anchor.BottomCentre,
-                        RelativeSizeAxes = Axes.Both,
+                        RelativeSizeAxes = Axes.X,
                         Masking = true,
-                        Height = 0.28f,
+                        Height = lower_cover_height,
                         Children = new Drawable[]
                         {
                             new Triangle

From 2e21d75b101d4aabb3a2dba05ef2e7306c6976ce Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 20 May 2022 17:12:35 +0900
Subject: [PATCH 4926/5547] Move metronome into own class and rename to avoid
 conflict with mod sounds

---
 .../Mods/TestSceneOsuModMuted.cs              |   2 +-
 osu.Game.Rulesets.Osu/Mods/OsuModTarget.cs    |   2 +-
 .../Editing/TestSceneTapTimingControl.cs      |   6 +-
 .../Mods/{Metronome.cs => MetronomeBeat.cs}   |   4 +-
 osu.Game/Rulesets/Mods/ModMuted.cs            |   6 +-
 .../Screens/Edit/Timing/MetronomeDisplay.cs   | 255 +++++++++++++++++
 .../Screens/Edit/Timing/TapTimingControl.cs   | 261 +-----------------
 7 files changed, 277 insertions(+), 259 deletions(-)
 rename osu.Game/Rulesets/Mods/{Metronome.cs => MetronomeBeat.cs} (95%)
 create mode 100644 osu.Game/Screens/Edit/Timing/MetronomeDisplay.cs

diff --git a/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModMuted.cs b/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModMuted.cs
index c14dc78f38..e08d66fa31 100644
--- a/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModMuted.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModMuted.cs
@@ -22,7 +22,7 @@ namespace osu.Game.Rulesets.Osu.Tests.Mods
                 MuteComboCount = { Value = 0 },
             },
             PassCondition = () => Beatmap.Value.Track.AggregateVolume.Value == 0.0 &&
-                                  Player.ChildrenOfType<Metronome>().SingleOrDefault()?.AggregateVolume.Value == 1.0,
+                                  Player.ChildrenOfType<MetronomeBeat>().SingleOrDefault()?.AggregateVolume.Value == 1.0,
         });
 
         /// <summary>
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModTarget.cs b/osu.Game.Rulesets.Osu/Mods/OsuModTarget.cs
index 5b121f4673..c58c624f5c 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModTarget.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModTarget.cs
@@ -339,7 +339,7 @@ namespace osu.Game.Rulesets.Osu.Mods
 
         public void ApplyToDrawableRuleset(DrawableRuleset<OsuHitObject> drawableRuleset)
         {
-            drawableRuleset.Overlays.Add(new Metronome(drawableRuleset.Beatmap.HitObjects.First().StartTime));
+            drawableRuleset.Overlays.Add(new MetronomeBeat(drawableRuleset.Beatmap.HitObjects.First().StartTime));
         }
 
         #endregion
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneTapTimingControl.cs b/osu.Game.Tests/Visual/Editing/TestSceneTapTimingControl.cs
index 9b2618df5b..de441995b5 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneTapTimingControl.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneTapTimingControl.cs
@@ -73,7 +73,7 @@ namespace osu.Game.Tests.Visual.Editing
             AddStep("click tap button", () =>
             {
                 control.ChildrenOfType<RoundedButton>()
-                       .First(b => b.Text == "Tap to beat")
+                       .Last()
                        .TriggerClick();
             });
 
@@ -82,7 +82,7 @@ namespace osu.Game.Tests.Visual.Editing
             AddStep("click reset button", () =>
             {
                 control.ChildrenOfType<RoundedButton>()
-                       .First(b => b.Text == "Reset")
+                       .First()
                        .TriggerClick();
             });
 
@@ -100,7 +100,7 @@ namespace osu.Game.Tests.Visual.Editing
             AddStep("click tap button", () =>
             {
                 control.ChildrenOfType<RoundedButton>()
-                       .First(b => b.Text == "Tap to beat")
+                       .Last()
                        .TriggerClick();
             });
 
diff --git a/osu.Game/Rulesets/Mods/Metronome.cs b/osu.Game/Rulesets/Mods/MetronomeBeat.cs
similarity index 95%
rename from osu.Game/Rulesets/Mods/Metronome.cs
rename to osu.Game/Rulesets/Mods/MetronomeBeat.cs
index b85a341577..c7a8b02130 100644
--- a/osu.Game/Rulesets/Mods/Metronome.cs
+++ b/osu.Game/Rulesets/Mods/MetronomeBeat.cs
@@ -11,14 +11,14 @@ using osu.Game.Skinning;
 
 namespace osu.Game.Rulesets.Mods
 {
-    public class Metronome : BeatSyncedContainer, IAdjustableAudioComponent
+    public class MetronomeBeat : BeatSyncedContainer, IAdjustableAudioComponent
     {
         private readonly double firstHitTime;
 
         private readonly PausableSkinnableSound sample;
 
         /// <param name="firstHitTime">Start time of the first hit object, used for providing a count down.</param>
-        public Metronome(double firstHitTime)
+        public MetronomeBeat(double firstHitTime)
         {
             this.firstHitTime = firstHitTime;
             AllowMistimedEventFiring = false;
diff --git a/osu.Game/Rulesets/Mods/ModMuted.cs b/osu.Game/Rulesets/Mods/ModMuted.cs
index a7d3114f2b..84341faab7 100644
--- a/osu.Game/Rulesets/Mods/ModMuted.cs
+++ b/osu.Game/Rulesets/Mods/ModMuted.cs
@@ -79,11 +79,11 @@ namespace osu.Game.Rulesets.Mods
         {
             if (EnableMetronome.Value)
             {
-                Metronome metronome;
+                MetronomeBeat metronomeBeat;
 
-                drawableRuleset.Overlays.Add(metronome = new Metronome(drawableRuleset.Beatmap.HitObjects.First().StartTime));
+                drawableRuleset.Overlays.Add(metronomeBeat = new MetronomeBeat(drawableRuleset.Beatmap.HitObjects.First().StartTime));
 
-                metronome.AddAdjustment(AdjustableProperty.Volume, metronomeVolumeAdjust);
+                metronomeBeat.AddAdjustment(AdjustableProperty.Volume, metronomeVolumeAdjust);
             }
 
             if (AffectsHitSounds.Value)
diff --git a/osu.Game/Screens/Edit/Timing/MetronomeDisplay.cs b/osu.Game/Screens/Edit/Timing/MetronomeDisplay.cs
new file mode 100644
index 0000000000..fdd5bd1e4e
--- /dev/null
+++ b/osu.Game/Screens/Edit/Timing/MetronomeDisplay.cs
@@ -0,0 +1,255 @@
+// 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.Audio.Track;
+using osu.Framework.Bindables;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.Shapes;
+using osu.Framework.Utils;
+using osu.Game.Beatmaps.ControlPoints;
+using osu.Game.Graphics.Containers;
+using osu.Game.Graphics.Sprites;
+using osu.Game.Overlays;
+using osuTK;
+
+namespace osu.Game.Screens.Edit.Timing
+{
+    public class MetronomeDisplay : BeatSyncedContainer
+    {
+        private Container swing;
+
+        private OsuSpriteText bpmText;
+
+        private Drawable weight;
+        private Drawable stick;
+
+        [Resolved]
+        private OverlayColourProvider overlayColourProvider { get; set; }
+
+        [BackgroundDependencyLoader]
+        private void load()
+        {
+            const float taper = 25;
+            const float swing_vertical_offset = -23;
+            const float lower_cover_height = 32;
+
+            var triangleSize = new Vector2(90, 120 + taper);
+
+            Margin = new MarginPadding(10);
+
+            AutoSizeAxes = Axes.Both;
+
+            InternalChildren = new Drawable[]
+            {
+                new Container
+                {
+                    Name = @"Taper adjust",
+                    Masking = true,
+                    Anchor = Anchor.BottomCentre,
+                    Origin = Anchor.BottomCentre,
+                    Size = new Vector2(triangleSize.X, triangleSize.Y - taper),
+                    Children = new Drawable[]
+                    {
+                        new Triangle
+                        {
+                            Name = @"Main body",
+                            EdgeSmoothness = new Vector2(1),
+                            Anchor = Anchor.BottomCentre,
+                            Origin = Anchor.BottomCentre,
+                            Size = triangleSize,
+                            Colour = overlayColourProvider.Background3,
+                        },
+                    },
+                },
+                new Circle
+                {
+                    Name = "Centre marker",
+                    Colour = overlayColourProvider.Background5,
+                    RelativeSizeAxes = Axes.Y,
+                    Width = 2,
+                    Anchor = Anchor.BottomCentre,
+                    Origin = Anchor.BottomCentre,
+                    Y = -(lower_cover_height + 3),
+                    Height = 0.65f,
+                },
+                swing = new Container
+                {
+                    Name = @"Swing",
+                    RelativeSizeAxes = Axes.Both,
+                    Y = swing_vertical_offset,
+                    Height = 0.80f,
+                    Anchor = Anchor.BottomCentre,
+                    Origin = Anchor.BottomCentre,
+                    Children = new[]
+                    {
+                        stick = new Circle
+                        {
+                            Name = @"Stick",
+                            RelativeSizeAxes = Axes.Y,
+                            Colour = overlayColourProvider.Colour2,
+                            Anchor = Anchor.BottomCentre,
+                            Origin = Anchor.BottomCentre,
+                            Width = 4,
+                        },
+                        weight = new Container
+                        {
+                            Name = @"Weight",
+                            Anchor = Anchor.TopCentre,
+                            Origin = Anchor.Centre,
+                            Colour = overlayColourProvider.Colour0,
+                            Size = new Vector2(10),
+                            Rotation = 180,
+                            RelativePositionAxes = Axes.Y,
+                            Y = 0.4f,
+                            Children = new Drawable[]
+                            {
+                                new Box
+                                {
+                                    RelativeSizeAxes = Axes.Both,
+                                    Shear = new Vector2(0.2f, 0),
+                                    EdgeSmoothness = new Vector2(1),
+                                },
+                                new Box
+                                {
+                                    RelativeSizeAxes = Axes.Both,
+                                    Shear = new Vector2(-0.2f, 0),
+                                    EdgeSmoothness = new Vector2(1),
+                                },
+                            }
+                        },
+                    }
+                },
+                new Container
+                {
+                    Name = @"Taper adjust",
+                    Masking = true,
+                    Anchor = Anchor.BottomCentre,
+                    Origin = Anchor.BottomCentre,
+                    Size = new Vector2(triangleSize.X, triangleSize.Y - taper),
+                    Children = new Drawable[]
+                    {
+                        new Circle
+                        {
+                            Name = @"Locking wedge",
+                            Anchor = Anchor.TopCentre,
+                            Origin = Anchor.Centre,
+                            Colour = overlayColourProvider.Background1,
+                            Size = new Vector2(8),
+                        }
+                    },
+                },
+                new Circle
+                {
+                    Name = @"Swing connection point",
+                    Y = swing_vertical_offset,
+                    Anchor = Anchor.BottomCentre,
+                    Origin = Anchor.Centre,
+                    Colour = overlayColourProvider.Colour0,
+                    Size = new Vector2(8)
+                },
+                new Container
+                {
+                    Name = @"Lower cover",
+                    Anchor = Anchor.BottomCentre,
+                    Origin = Anchor.BottomCentre,
+                    RelativeSizeAxes = Axes.X,
+                    Masking = true,
+                    Height = lower_cover_height,
+                    Children = new Drawable[]
+                    {
+                        new Triangle
+                        {
+                            Anchor = Anchor.BottomCentre,
+                            Origin = Anchor.BottomCentre,
+                            Size = triangleSize,
+                            Colour = overlayColourProvider.Background2,
+                            EdgeSmoothness = new Vector2(1),
+                            Alpha = 0.8f
+                        },
+                    }
+                },
+                bpmText = new OsuSpriteText
+                {
+                    Name = @"BPM display",
+                    Colour = overlayColourProvider.Content1,
+                    Anchor = Anchor.BottomCentre,
+                    Origin = Anchor.BottomCentre,
+                    Y = -3,
+                },
+            };
+        }
+
+        private double beatLength;
+
+        private TimingControlPoint timingPoint;
+
+        private bool isSwinging;
+
+        private readonly BindableInt interpolatedBpm = new BindableInt();
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            interpolatedBpm.BindValueChanged(bpm => bpmText.Text = bpm.NewValue.ToString());
+        }
+
+        protected override void Update()
+        {
+            base.Update();
+
+            timingPoint = Beatmap.Value.Beatmap.ControlPointInfo.TimingPointAt(BeatSyncClock.CurrentTime);
+
+            if (beatLength != timingPoint.BeatLength)
+            {
+                beatLength = timingPoint.BeatLength;
+
+                EarlyActivationMilliseconds = timingPoint.BeatLength / 2;
+
+                float bpmRatio = (float)Interpolation.ApplyEasing(Easing.OutQuad, Math.Clamp((timingPoint.BPM - 30) / 480, 0, 1));
+
+                weight.MoveToY((float)Interpolation.Lerp(0.1f, 0.83f, bpmRatio), 600, Easing.OutQuint);
+                this.TransformBindableTo(interpolatedBpm, (int)timingPoint.BPM, 600, Easing.OutQuint);
+            }
+
+            if (BeatSyncClock?.IsRunning != true && isSwinging)
+            {
+                swing.ClearTransforms(true);
+
+                using (swing.BeginDelayedSequence(350))
+                {
+                    swing.RotateTo(0, 1000, Easing.OutQuint);
+                    stick.FadeColour(overlayColourProvider.Colour2, 1000, Easing.OutQuint);
+                }
+
+                isSwinging = false;
+            }
+        }
+
+        protected override void OnNewBeat(int beatIndex, TimingControlPoint timingPoint, EffectControlPoint effectPoint, ChannelAmplitudes amplitudes)
+        {
+            base.OnNewBeat(beatIndex, timingPoint, effectPoint, amplitudes);
+
+            const float angle = 27.5f;
+
+            if (!IsBeatSyncedWithTrack)
+                return;
+
+            isSwinging = true;
+
+            float currentAngle = swing.Rotation;
+            float targetAngle = currentAngle > 0 ? -angle : angle;
+
+            swing.RotateTo(targetAngle, beatLength, Easing.InOutQuad);
+
+            if (currentAngle != 0 && Math.Abs(currentAngle - targetAngle) > angle * 1.8f && isSwinging)
+            {
+                using (stick.BeginDelayedSequence(beatLength / 2))
+                    stick.FlashColour(overlayColourProvider.Content1, beatLength, Easing.OutQuint);
+            }
+        }
+    }
+}
diff --git a/osu.Game/Screens/Edit/Timing/TapTimingControl.cs b/osu.Game/Screens/Edit/Timing/TapTimingControl.cs
index a99468fbff..1b0f0a3f5e 100644
--- a/osu.Game/Screens/Edit/Timing/TapTimingControl.cs
+++ b/osu.Game/Screens/Edit/Timing/TapTimingControl.cs
@@ -1,21 +1,15 @@
 // 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.Audio.Track;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
-using osu.Framework.Utils;
 using osu.Game.Beatmaps.ControlPoints;
 using osu.Game.Graphics;
-using osu.Game.Graphics.Containers;
-using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.UserInterfaceV2;
 using osu.Game.Overlays;
-using osuTK;
 
 namespace osu.Game.Screens.Edit.Timing
 {
@@ -24,6 +18,9 @@ namespace osu.Game.Screens.Edit.Timing
         [Resolved]
         private EditorClock editorClock { get; set; }
 
+        [Resolved]
+        private Bindable<ControlPointGroup> selectedGroup { get; set; }
+
         [BackgroundDependencyLoader]
         private void load(OverlayColourProvider colourProvider, OsuColour colours)
         {
@@ -52,7 +49,11 @@ namespace osu.Game.Screens.Edit.Timing
                     {
                         new Drawable[]
                         {
-                            new Metronome()
+                            new MetronomeDisplay
+                            {
+                                Anchor = Anchor.Centre,
+                                Origin = Anchor.Centre,
+                            }
                         },
                         new Drawable[]
                         {
@@ -74,7 +75,7 @@ namespace osu.Game.Screens.Edit.Timing
                                     {
                                         Anchor = Anchor.TopRight,
                                         Origin = Anchor.TopRight,
-                                        Text = "Tap to beat",
+                                        Text = "Play from start",
                                         RelativeSizeAxes = Axes.X,
                                         BackgroundColour = colourProvider.Background1,
                                         Width = 0.68f,
@@ -90,252 +91,14 @@ namespace osu.Game.Screens.Edit.Timing
 
         private void tap()
         {
-            if (!editorClock.IsRunning)
-            {
-                editorClock.Seek(0);
-                editorClock.Start();
-            }
+            editorClock.Seek(selectedGroup.Value.Time);
+            editorClock.Start();
         }
 
         private void reset()
         {
             editorClock.Stop();
-        }
-
-        private class Metronome : BeatSyncedContainer
-        {
-            private Container swing;
-
-            private OsuSpriteText bpmText;
-
-            private Drawable weight;
-            private Drawable stick;
-
-            [Resolved]
-            private OverlayColourProvider overlayColourProvider { get; set; }
-
-            [BackgroundDependencyLoader]
-            private void load()
-            {
-                const float taper = 25;
-                const float swing_vertical_offset = -23;
-                const float lower_cover_height = 32;
-
-                var triangleSize = new Vector2(90, 120 + taper);
-
-                Margin = new MarginPadding(10);
-
-                AutoSizeAxes = Axes.Both;
-
-                InternalChildren = new Drawable[]
-                {
-                    new Container
-                    {
-                        Name = @"Taper adjust",
-                        Masking = true,
-                        Anchor = Anchor.BottomCentre,
-                        Origin = Anchor.BottomCentre,
-                        Size = new Vector2(triangleSize.X, triangleSize.Y - taper),
-                        Children = new Drawable[]
-                        {
-                            new Triangle
-                            {
-                                Name = @"Main body",
-                                EdgeSmoothness = new Vector2(1),
-                                Anchor = Anchor.BottomCentre,
-                                Origin = Anchor.BottomCentre,
-                                Size = triangleSize,
-                                Colour = overlayColourProvider.Background3,
-                            },
-                        },
-                    },
-                    new Circle
-                    {
-                        Name = "Centre marker",
-                        Colour = overlayColourProvider.Background5,
-                        RelativeSizeAxes = Axes.Y,
-                        Width = 2,
-                        Anchor = Anchor.BottomCentre,
-                        Origin = Anchor.BottomCentre,
-                        Y = -(lower_cover_height + 3),
-                        Height = 0.65f,
-                    },
-                    swing = new Container
-                    {
-                        Name = @"Swing",
-                        RelativeSizeAxes = Axes.Both,
-                        Y = swing_vertical_offset,
-                        Height = 0.80f,
-                        Anchor = Anchor.BottomCentre,
-                        Origin = Anchor.BottomCentre,
-                        Children = new[]
-                        {
-                            stick = new Circle
-                            {
-                                Name = @"Stick",
-                                RelativeSizeAxes = Axes.Y,
-                                Colour = overlayColourProvider.Colour2,
-                                Anchor = Anchor.BottomCentre,
-                                Origin = Anchor.BottomCentre,
-                                Width = 4,
-                            },
-                            weight = new Container
-                            {
-                                Name = @"Weight",
-                                Anchor = Anchor.TopCentre,
-                                Origin = Anchor.Centre,
-                                Colour = overlayColourProvider.Colour0,
-                                Size = new Vector2(10),
-                                Rotation = 180,
-                                RelativePositionAxes = Axes.Y,
-                                Y = 0.4f,
-                                Children = new Drawable[]
-                                {
-                                    new Box
-                                    {
-                                        RelativeSizeAxes = Axes.Both,
-                                        Shear = new Vector2(0.2f, 0),
-                                        EdgeSmoothness = new Vector2(1),
-                                    },
-                                    new Box
-                                    {
-                                        RelativeSizeAxes = Axes.Both,
-                                        Shear = new Vector2(-0.2f, 0),
-                                        EdgeSmoothness = new Vector2(1),
-                                    },
-                                }
-                            },
-                        }
-                    },
-                    new Container
-                    {
-                        Name = @"Taper adjust",
-                        Masking = true,
-                        Anchor = Anchor.BottomCentre,
-                        Origin = Anchor.BottomCentre,
-                        Size = new Vector2(triangleSize.X, triangleSize.Y - taper),
-                        Children = new Drawable[]
-                        {
-                            new Circle
-                            {
-                                Name = @"Locking wedge",
-                                Anchor = Anchor.TopCentre,
-                                Origin = Anchor.Centre,
-                                Colour = overlayColourProvider.Background1,
-                                Size = new Vector2(8),
-                            }
-                        },
-                    },
-                    new Circle
-                    {
-                        Name = @"Swing connection point",
-                        Y = swing_vertical_offset,
-                        Anchor = Anchor.BottomCentre,
-                        Origin = Anchor.Centre,
-                        Colour = overlayColourProvider.Colour0,
-                        Size = new Vector2(8)
-                    },
-                    new Container
-                    {
-                        Name = @"Lower cover",
-                        Anchor = Anchor.BottomCentre,
-                        Origin = Anchor.BottomCentre,
-                        RelativeSizeAxes = Axes.X,
-                        Masking = true,
-                        Height = lower_cover_height,
-                        Children = new Drawable[]
-                        {
-                            new Triangle
-                            {
-                                Anchor = Anchor.BottomCentre,
-                                Origin = Anchor.BottomCentre,
-                                Size = triangleSize,
-                                Colour = overlayColourProvider.Background2,
-                                EdgeSmoothness = new Vector2(1),
-                                Alpha = 0.8f
-                            },
-                        }
-                    },
-                    bpmText = new OsuSpriteText
-                    {
-                        Name = @"BPM display",
-                        Colour = overlayColourProvider.Content1,
-                        Anchor = Anchor.BottomCentre,
-                        Origin = Anchor.BottomCentre,
-                        Y = -3,
-                    },
-                };
-            }
-
-            private double beatLength;
-
-            private TimingControlPoint timingPoint;
-
-            private bool isSwinging;
-
-            private readonly BindableInt interpolatedBpm = new BindableInt();
-
-            protected override void LoadComplete()
-            {
-                base.LoadComplete();
-
-                interpolatedBpm.BindValueChanged(bpm => bpmText.Text = bpm.NewValue.ToString());
-            }
-
-            protected override void Update()
-            {
-                base.Update();
-
-                timingPoint = Beatmap.Value.Beatmap.ControlPointInfo.TimingPointAt(BeatSyncClock.CurrentTime);
-
-                if (beatLength != timingPoint.BeatLength)
-                {
-                    beatLength = timingPoint.BeatLength;
-
-                    EarlyActivationMilliseconds = timingPoint.BeatLength / 2;
-
-                    float bpmRatio = (float)Interpolation.ApplyEasing(Easing.OutQuad, Math.Clamp((timingPoint.BPM - 30) / 480, 0, 1));
-
-                    weight.MoveToY((float)Interpolation.Lerp(0.1f, 0.83f, bpmRatio), 600, Easing.OutQuint);
-                    this.TransformBindableTo(interpolatedBpm, (int)timingPoint.BPM, 600, Easing.OutQuint);
-                }
-
-                if (BeatSyncClock?.IsRunning != true && isSwinging)
-                {
-                    swing.ClearTransforms(true);
-
-                    using (swing.BeginDelayedSequence(350))
-                    {
-                        swing.RotateTo(0, 1000, Easing.OutQuint);
-                        stick.FadeColour(overlayColourProvider.Colour2, 1000, Easing.OutQuint);
-                    }
-
-                    isSwinging = false;
-                }
-            }
-
-            protected override void OnNewBeat(int beatIndex, TimingControlPoint timingPoint, EffectControlPoint effectPoint, ChannelAmplitudes amplitudes)
-            {
-                base.OnNewBeat(beatIndex, timingPoint, effectPoint, amplitudes);
-
-                const float angle = 27.5f;
-
-                if (!IsBeatSyncedWithTrack)
-                    return;
-
-                isSwinging = true;
-
-                float currentAngle = swing.Rotation;
-                float targetAngle = currentAngle > 0 ? -angle : angle;
-
-                swing.RotateTo(targetAngle, beatLength, Easing.InOutQuad);
-
-                if (currentAngle != 0 && Math.Abs(currentAngle - targetAngle) > angle * 1.8f && isSwinging)
-                {
-                    using (stick.BeginDelayedSequence(beatLength / 2))
-                        stick.FlashColour(overlayColourProvider.Content1, beatLength, Easing.OutQuint);
-                }
-            }
+            editorClock.Seek(selectedGroup.Value.Time);
         }
     }
 }

From 82eb5fd2c9007945d7432e22433ebeded94b7066 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 20 May 2022 17:21:56 +0900
Subject: [PATCH 4927/5547] Add centre line on weight

---
 osu.Game/Screens/Edit/Timing/MetronomeDisplay.cs | 13 ++++++++++++-
 1 file changed, 12 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Edit/Timing/MetronomeDisplay.cs b/osu.Game/Screens/Edit/Timing/MetronomeDisplay.cs
index fdd5bd1e4e..5429165fe0 100644
--- a/osu.Game/Screens/Edit/Timing/MetronomeDisplay.cs
+++ b/osu.Game/Screens/Edit/Timing/MetronomeDisplay.cs
@@ -6,6 +6,7 @@ using osu.Framework.Allocation;
 using osu.Framework.Audio.Track;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
+using osu.Framework.Graphics.Colour;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Utils;
@@ -99,7 +100,6 @@ namespace osu.Game.Screens.Edit.Timing
                             Name = @"Weight",
                             Anchor = Anchor.TopCentre,
                             Origin = Anchor.Centre,
-                            Colour = overlayColourProvider.Colour0,
                             Size = new Vector2(10),
                             Rotation = 180,
                             RelativePositionAxes = Axes.Y,
@@ -110,14 +110,25 @@ namespace osu.Game.Screens.Edit.Timing
                                 {
                                     RelativeSizeAxes = Axes.Both,
                                     Shear = new Vector2(0.2f, 0),
+                                    Colour = overlayColourProvider.Colour1,
                                     EdgeSmoothness = new Vector2(1),
                                 },
                                 new Box
                                 {
                                     RelativeSizeAxes = Axes.Both,
                                     Shear = new Vector2(-0.2f, 0),
+                                    Colour = overlayColourProvider.Colour1,
                                     EdgeSmoothness = new Vector2(1),
                                 },
+                                new Circle
+                                {
+                                    Anchor = Anchor.Centre,
+                                    Origin = Anchor.Centre,
+                                    Colour = ColourInfo.GradientVertical(overlayColourProvider.Colour1, overlayColourProvider.Colour0),
+                                    RelativeSizeAxes = Axes.Y,
+                                    Width = 1,
+                                    Height = 0.9f
+                                },
                             }
                         },
                     }

From b29172ea45fea63d8e48b85aee346d9d607f0dfa Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 19 May 2022 19:55:51 +0900
Subject: [PATCH 4928/5547] Increase HP lost for misses

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

diff --git a/osu.Game/Rulesets/Judgements/Judgement.cs b/osu.Game/Rulesets/Judgements/Judgement.cs
index 4fe34e15fd..99dce82ec2 100644
--- a/osu.Game/Rulesets/Judgements/Judgement.cs
+++ b/osu.Game/Rulesets/Judgements/Judgement.cs
@@ -100,7 +100,7 @@ namespace osu.Game.Rulesets.Judgements
                     return -DEFAULT_MAX_HEALTH_INCREASE;
 
                 case HitResult.Miss:
-                    return -DEFAULT_MAX_HEALTH_INCREASE;
+                    return -DEFAULT_MAX_HEALTH_INCREASE * 2;
 
                 case HitResult.Meh:
                     return DEFAULT_MAX_HEALTH_INCREASE * 0.05;

From c78d90ccbdc92bb090c9840934ce70986c409a08 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 20 May 2022 14:43:07 +0300
Subject: [PATCH 4929/5547] Refactor track transferring logic for ability to
 override and disallow

---
 osu.Game/Beatmaps/WorkingBeatmap.cs  | 16 ++++++++++++----
 osu.Game/Overlays/MusicController.cs |  9 +--------
 2 files changed, 13 insertions(+), 12 deletions(-)

diff --git a/osu.Game/Beatmaps/WorkingBeatmap.cs b/osu.Game/Beatmaps/WorkingBeatmap.cs
index bb64ec796c..a1a8306b76 100644
--- a/osu.Game/Beatmaps/WorkingBeatmap.cs
+++ b/osu.Game/Beatmaps/WorkingBeatmap.cs
@@ -126,11 +126,19 @@ namespace osu.Game.Beatmaps
         }
 
         /// <summary>
-        /// Transfer a valid audio track into this working beatmap. Used as an optimisation to avoid reload / track swap
-        /// across difficulties in the same beatmap set.
+        /// Attempts to transfer the audio track to a target working beatmap, if valid for transferring.
+        /// Used as an optimisation to avoid reload / track swap across difficulties in the same beatmap set.
         /// </summary>
-        /// <param name="track">The track to transfer.</param>
-        public void TransferTrack([NotNull] Track track) => this.track = track ?? throw new ArgumentNullException(nameof(track));
+        /// <param name="target">The target working beatmap to transfer this track to.</param>
+        /// <returns>Whether the track is valid and has been transferred to this working beatmap.</returns>
+        public virtual bool TryTransferTrack([NotNull] WorkingBeatmap target)
+        {
+            if (BeatmapInfo?.AudioEquals(target.BeatmapInfo) != true)
+                return false;
+
+            target.track = track;
+            return true;
+        }
 
         /// <summary>
         /// Get the loaded audio track instance. <see cref="LoadTrack"/> must have first been called.
diff --git a/osu.Game/Overlays/MusicController.cs b/osu.Game/Overlays/MusicController.cs
index 65b06eb864..509da4302d 100644
--- a/osu.Game/Overlays/MusicController.cs
+++ b/osu.Game/Overlays/MusicController.cs
@@ -290,15 +290,8 @@ namespace osu.Game.Overlays
 
             current = newWorking;
 
-            if (!audioEquals || CurrentTrack.IsDummyDevice)
-            {
+            if (lastWorking == null || !lastWorking.TryTransferTrack(current))
                 changeTrack();
-            }
-            else
-            {
-                // transfer still valid track to new working beatmap
-                current.TransferTrack(lastWorking.Track);
-            }
 
             TrackChanged?.Invoke(current, direction);
 

From cef99fd0205ba17f515a95530adb2ad0a6296bed Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 20 May 2022 14:43:50 +0300
Subject: [PATCH 4930/5547] Disallow transferring track from test
 `WorkingBeatmap`s which have local stores

---
 osu.Game.Tests/WaveformTestBeatmap.cs | 7 +++++++
 osu.Game/Tests/Visual/OsuTestScene.cs | 7 +++++++
 2 files changed, 14 insertions(+)

diff --git a/osu.Game.Tests/WaveformTestBeatmap.cs b/osu.Game.Tests/WaveformTestBeatmap.cs
index 9c85fa0c9c..ab7bf7fb73 100644
--- a/osu.Game.Tests/WaveformTestBeatmap.cs
+++ b/osu.Game.Tests/WaveformTestBeatmap.cs
@@ -59,6 +59,13 @@ namespace osu.Game.Tests
 
         protected override Track GetBeatmapTrack() => trackStore.Get(firstAudioFile);
 
+        public override bool TryTransferTrack(WorkingBeatmap target)
+        {
+            // Our track comes from a local track store that's disposed on finalizer,
+            // therefore it's unsafe to transfer it to another working beatmap.
+            return false;
+        }
+
         private string firstAudioFile
         {
             get
diff --git a/osu.Game/Tests/Visual/OsuTestScene.cs b/osu.Game/Tests/Visual/OsuTestScene.cs
index f2d280417e..1582bdfca4 100644
--- a/osu.Game/Tests/Visual/OsuTestScene.cs
+++ b/osu.Game/Tests/Visual/OsuTestScene.cs
@@ -373,6 +373,13 @@ namespace osu.Game.Tests.Visual
 
             protected override Track GetBeatmapTrack() => track;
 
+            public override bool TryTransferTrack(WorkingBeatmap target)
+            {
+                // Our track comes from a local track store that's disposed on finalizer,
+                // therefore it's unsafe to transfer it to another working beatmap.
+                return false;
+            }
+
             public class TrackVirtualStore : AudioCollectionManager<Track>, ITrackStore
             {
                 private readonly IFrameBasedClock referenceClock;

From abf9039109389dd8b869fed1c2778dedd0c76b5c Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 20 May 2022 14:44:07 +0300
Subject: [PATCH 4931/5547] Use `==` instead of `??`

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

diff --git a/osu.Game/Overlays/MusicController.cs b/osu.Game/Overlays/MusicController.cs
index 509da4302d..aa09ff6b97 100644
--- a/osu.Game/Overlays/MusicController.cs
+++ b/osu.Game/Overlays/MusicController.cs
@@ -267,7 +267,7 @@ namespace osu.Game.Overlays
 
             TrackChangeDirection direction = TrackChangeDirection.None;
 
-            bool audioEquals = newWorking?.BeatmapInfo?.AudioEquals(current?.BeatmapInfo) ?? false;
+            bool audioEquals = newWorking?.BeatmapInfo?.AudioEquals(current?.BeatmapInfo) == true;
 
             if (current != null)
             {

From c3bfbe888003f733137617e8629725bdadd1c506 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 20 May 2022 23:23:51 +0900
Subject: [PATCH 4932/5547] Allow `BeatSyncedContainer` to prefer
 `EditorBeatmap` when available

---
 .../TestSceneBeatSyncedContainer.cs           | 19 +------------
 .../Containers/BeatSyncedContainer.cs         | 28 +++++++++++++------
 2 files changed, 20 insertions(+), 27 deletions(-)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneBeatSyncedContainer.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneBeatSyncedContainer.cs
index ede89c6096..1881f6d718 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneBeatSyncedContainer.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneBeatSyncedContainer.cs
@@ -258,24 +258,7 @@ namespace osu.Game.Tests.Visual.UserInterface
                 };
             }
 
-            protected override void LoadComplete()
-            {
-                base.LoadComplete();
-
-                Beatmap.BindValueChanged(_ =>
-                {
-                    timingPointCount.Value = 0;
-                    currentTimingPoint.Value = 0;
-                    beatCount.Value = 0;
-                    currentBeat.Value = 0;
-                    beatsPerMinute.Value = 0;
-                    adjustedBeatLength.Value = 0;
-                    timeUntilNextBeat.Value = 0;
-                    timeSinceLastBeat.Value = 0;
-                }, true);
-            }
-
-            private List<TimingControlPoint> timingPoints => Beatmap.Value.Beatmap.ControlPointInfo.TimingPoints.ToList();
+            private List<TimingControlPoint> timingPoints => Beatmap.ControlPointInfo.TimingPoints.ToList();
 
             private TimingControlPoint getNextTimingPoint(TimingControlPoint current)
             {
diff --git a/osu.Game/Graphics/Containers/BeatSyncedContainer.cs b/osu.Game/Graphics/Containers/BeatSyncedContainer.cs
index 2024d18570..48936f7aa9 100644
--- a/osu.Game/Graphics/Containers/BeatSyncedContainer.cs
+++ b/osu.Game/Graphics/Containers/BeatSyncedContainer.cs
@@ -10,6 +10,7 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Timing;
 using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.ControlPoints;
+using osu.Game.Screens.Edit;
 using osu.Game.Screens.Play;
 
 namespace osu.Game.Graphics.Containers
@@ -79,20 +80,31 @@ namespace osu.Game.Graphics.Containers
         }
 
         [Resolved]
-        protected IBindable<WorkingBeatmap> Beatmap { get; private set; }
+        private IBindable<WorkingBeatmap> beatmap { get; set; }
 
         [Resolved(canBeNull: true)]
         protected GameplayClock GameplayClock { get; private set; }
 
+        [Resolved(canBeNull: true)]
+        protected EditorBeatmap EditorBeatmap { get; private set; }
+
+        [Resolved(canBeNull: true)]
+        protected EditorClock EditorClock { get; private set; }
+
+        protected IBeatmap Beatmap => EditorBeatmap ?? beatmap?.Value.Beatmap;
+
         protected IClock BeatSyncClock
         {
             get
             {
+                if (EditorClock != null)
+                    return EditorClock;
+
                 if (GameplayClock != null)
                     return GameplayClock;
 
-                if (Beatmap.Value.TrackLoaded)
-                    return Beatmap.Value.Track;
+                if (beatmap.Value.TrackLoaded)
+                    return beatmap.Value.Track;
 
                 return null;
             }
@@ -101,7 +113,6 @@ namespace osu.Game.Graphics.Containers
         protected override void Update()
         {
             ITrack track = null;
-            IBeatmap beatmap = null;
 
             TimingControlPoint timingPoint;
             EffectControlPoint effectPoint;
@@ -113,10 +124,9 @@ namespace osu.Game.Graphics.Containers
 
             double currentTrackTime = clock.CurrentTime + EarlyActivationMilliseconds;
 
-            if (Beatmap.Value.TrackLoaded && Beatmap.Value.BeatmapLoaded)
+            if (this.beatmap.Value.TrackLoaded && this.beatmap.Value.BeatmapLoaded)
             {
-                track = Beatmap.Value.Track;
-                beatmap = Beatmap.Value.Beatmap;
+                track = this.beatmap.Value.Track;
             }
 
             IsBeatSyncedWithTrack = beatmap != null && clock.IsRunning && track?.Length > 0;
@@ -125,8 +135,8 @@ namespace osu.Game.Graphics.Containers
             {
                 Debug.Assert(beatmap != null);
 
-                timingPoint = beatmap.ControlPointInfo.TimingPointAt(currentTrackTime);
-                effectPoint = beatmap.ControlPointInfo.EffectPointAt(currentTrackTime);
+                timingPoint = Beatmap.ControlPointInfo.TimingPointAt(currentTrackTime);
+                effectPoint = Beatmap.ControlPointInfo.EffectPointAt(currentTrackTime);
             }
             else
             {

From 8db80b92bb04f642e58e95de70c6309e2be44876 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 20 May 2022 23:24:21 +0900
Subject: [PATCH 4933/5547] Fix metronome not using `EditorBeatmap` causing
 editor updates to not propagate immediately

---
 osu.Game/Screens/Edit/Timing/MetronomeDisplay.cs | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Screens/Edit/Timing/MetronomeDisplay.cs b/osu.Game/Screens/Edit/Timing/MetronomeDisplay.cs
index 5429165fe0..d51d7b9c58 100644
--- a/osu.Game/Screens/Edit/Timing/MetronomeDisplay.cs
+++ b/osu.Game/Screens/Edit/Timing/MetronomeDisplay.cs
@@ -2,6 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
+using System.Globalization;
 using osu.Framework.Allocation;
 using osu.Framework.Audio.Track;
 using osu.Framework.Bindables;
@@ -30,6 +31,9 @@ namespace osu.Game.Screens.Edit.Timing
         [Resolved]
         private OverlayColourProvider overlayColourProvider { get; set; }
 
+        [Resolved]
+        private EditorBeatmap editorBeatmap { get; set; }
+
         [BackgroundDependencyLoader]
         private void load()
         {
@@ -205,14 +209,14 @@ namespace osu.Game.Screens.Edit.Timing
         {
             base.LoadComplete();
 
-            interpolatedBpm.BindValueChanged(bpm => bpmText.Text = bpm.NewValue.ToString());
+            interpolatedBpm.BindValueChanged(bpm => bpmText.Text = bpm.NewValue.ToString(CultureInfo.CurrentCulture));
         }
 
         protected override void Update()
         {
             base.Update();
 
-            timingPoint = Beatmap.Value.Beatmap.ControlPointInfo.TimingPointAt(BeatSyncClock.CurrentTime);
+            timingPoint = editorBeatmap.ControlPointInfo.TimingPointAt(BeatSyncClock.CurrentTime);
 
             if (beatLength != timingPoint.BeatLength)
             {
@@ -223,7 +227,7 @@ namespace osu.Game.Screens.Edit.Timing
                 float bpmRatio = (float)Interpolation.ApplyEasing(Easing.OutQuad, Math.Clamp((timingPoint.BPM - 30) / 480, 0, 1));
 
                 weight.MoveToY((float)Interpolation.Lerp(0.1f, 0.83f, bpmRatio), 600, Easing.OutQuint);
-                this.TransformBindableTo(interpolatedBpm, (int)timingPoint.BPM, 600, Easing.OutQuint);
+                this.TransformBindableTo(interpolatedBpm, (int)Math.Round(timingPoint.BPM), 600, Easing.OutQuint);
             }
 
             if (BeatSyncClock?.IsRunning != true && isSwinging)

From a2950d9d4e096ca6d09506e0ab01736651e9100f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 20 May 2022 23:49:03 +0900
Subject: [PATCH 4934/5547] Update framework

---
 osu.Android.props        | 2 +-
 osu.Game/osu.Game.csproj | 2 +-
 osu.iOS.props            | 4 ++--
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Android.props b/osu.Android.props
index b984f528fe..27fcdd4f6e 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -52,7 +52,7 @@
   </ItemGroup>
   <ItemGroup>
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.513.0" />
-    <PackageReference Include="ppy.osu.Framework.Android" Version="2022.511.0" />
+    <PackageReference Include="ppy.osu.Framework.Android" Version="2022.520.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
     <!-- Realm needs to be directly referenced in all Xamarin projects, as it will not pull in its transitive dependencies otherwise. -->
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 7f149b4e35..53a4753223 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="10.12.0" />
-    <PackageReference Include="ppy.osu.Framework" Version="2022.511.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2022.520.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.513.0" />
     <PackageReference Include="Sentry" Version="3.17.1" />
     <PackageReference Include="SharpCompress" Version="0.31.0" />
diff --git a/osu.iOS.props b/osu.iOS.props
index 932421a705..2e861faa1f 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -61,7 +61,7 @@
     <Reference Include="System.Net.Http" />
   </ItemGroup>
   <ItemGroup Label="Package References">
-    <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.511.0" />
+    <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.520.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.513.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net6.0) -->
@@ -84,7 +84,7 @@
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="5.0.14" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.Core" Version="5.0.14" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
-    <PackageReference Include="ppy.osu.Framework" Version="2022.511.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2022.520.0" />
     <PackageReference Include="SharpCompress" Version="0.31.0" />
     <PackageReference Include="NUnit" Version="3.13.3" />
     <PackageReference Include="System.ComponentModel.Annotations" Version="5.0.0" />

From de8aedf3484229b27920873abd4bc02a50bc81cd Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 20 May 2022 17:29:37 +0300
Subject: [PATCH 4935/5547] Add failing test case

---
 .../SongSelect/TestSceneBeatmapInfoWedge.cs   | 40 +++++++++++++++----
 1 file changed, 32 insertions(+), 8 deletions(-)

diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapInfoWedge.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapInfoWedge.cs
index 644a333fcf..995274e722 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapInfoWedge.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapInfoWedge.cs
@@ -2,7 +2,6 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System.Collections.Generic;
-using System.Globalization;
 using System.Linq;
 using JetBrains.Annotations;
 using NUnit.Framework;
@@ -127,6 +126,12 @@ namespace osu.Game.Tests.Visual.SongSelect
             AddAssert("check info labels count", () => infoWedge.Info.ChildrenOfType<BeatmapInfoWedge.WedgeInfoText.InfoLabel>().Count() == expectedCount);
         }
 
+        [SetUpSteps]
+        public void SetUpSteps()
+        {
+            AddStep("reset mods", () => SelectedMods.SetDefault());
+        }
+
         [Test]
         public void TestNullBeatmap()
         {
@@ -147,24 +152,43 @@ namespace osu.Game.Tests.Visual.SongSelect
         [Test]
         public void TestBPMUpdates()
         {
-            const float bpm = 120;
+            const double bpm = 120;
             IBeatmap beatmap = createTestBeatmap(new OsuRuleset().RulesetInfo);
             beatmap.ControlPointInfo.Add(0, new TimingControlPoint { BeatLength = 60 * 1000 / bpm });
 
             OsuModDoubleTime doubleTime = null;
 
             selectBeatmap(beatmap);
-            checkDisplayedBPM(bpm);
+            checkDisplayedBPM($"{bpm}");
 
             AddStep("select DT", () => SelectedMods.Value = new[] { doubleTime = new OsuModDoubleTime() });
-            checkDisplayedBPM(bpm * 1.5f);
+            checkDisplayedBPM($"{bpm * 1.5f}");
 
             AddStep("change DT rate", () => doubleTime.SpeedChange.Value = 2);
-            checkDisplayedBPM(bpm * 2);
+            checkDisplayedBPM($"{bpm * 2}");
+        }
 
-            void checkDisplayedBPM(float target) =>
-                AddUntilStep($"displayed bpm is {target}", () => this.ChildrenOfType<BeatmapInfoWedge.WedgeInfoText.InfoLabel>().Any(
-                    label => label.Statistic.Name == "BPM" && label.Statistic.Content == target.ToString(CultureInfo.InvariantCulture)));
+        [TestCase(120, 125, "120-125 (mostly 120)")]
+        [TestCase(120, 120.6, "120-121 (mostly 120)")]
+        [TestCase(120, 120.4, "120")]
+        public void TestVaryingBPM(double commonBpm, double otherBpm, string expectedDisplay)
+        {
+            IBeatmap beatmap = createTestBeatmap(new OsuRuleset().RulesetInfo);
+            beatmap.ControlPointInfo.Add(0, new TimingControlPoint { BeatLength = 60 * 1000 / commonBpm });
+            beatmap.ControlPointInfo.Add(100, new TimingControlPoint { BeatLength = 60 * 1000 / otherBpm });
+            beatmap.ControlPointInfo.Add(200, new TimingControlPoint { BeatLength = 60 * 1000 / commonBpm });
+
+            selectBeatmap(beatmap);
+            checkDisplayedBPM(expectedDisplay);
+        }
+
+        private void checkDisplayedBPM(string target)
+        {
+            AddUntilStep($"displayed bpm is {target}", () =>
+            {
+                var label = this.ChildrenOfType<BeatmapInfoWedge.WedgeInfoText.InfoLabel>().Single(l => l.Statistic.Name == "BPM");
+                return label.Statistic.Content == target;
+            });
         }
 
         private void setRuleset(RulesetInfo rulesetInfo)

From 596853da8feb59a5f2c7252e1f0de11763979ad0 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 20 May 2022 17:43:40 +0300
Subject: [PATCH 4936/5547] Fix song select potentially displaying BPM range
 with equal min/max values

---
 osu.Game/Screens/Select/BeatmapInfoWedge.cs | 13 ++++++-------
 1 file changed, 6 insertions(+), 7 deletions(-)

diff --git a/osu.Game/Screens/Select/BeatmapInfoWedge.cs b/osu.Game/Screens/Select/BeatmapInfoWedge.cs
index 7db1016f62..55ade6fa33 100644
--- a/osu.Game/Screens/Select/BeatmapInfoWedge.cs
+++ b/osu.Game/Screens/Select/BeatmapInfoWedge.cs
@@ -12,7 +12,6 @@ using osu.Framework.Bindables;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
-using osu.Framework.Utils;
 using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.Drawables;
 using osu.Game.Graphics;
@@ -416,13 +415,13 @@ namespace osu.Game.Screens.Select
                 foreach (var mod in mods.Value.OfType<IApplicableToRate>())
                     rate = mod.ApplyToRate(0, rate);
 
-                double bpmMax = beatmap.ControlPointInfo.BPMMaximum * rate;
-                double bpmMin = beatmap.ControlPointInfo.BPMMinimum * rate;
-                double mostCommonBPM = 60000 / beatmap.GetMostCommonBeatLength() * rate;
+                int bpmMax = (int)Math.Round(beatmap.ControlPointInfo.BPMMaximum * rate);
+                int bpmMin = (int)Math.Round(beatmap.ControlPointInfo.BPMMinimum * rate);
+                int mostCommonBPM = (int)Math.Round(60000 / beatmap.GetMostCommonBeatLength() * rate);
 
-                string labelText = Precision.AlmostEquals(bpmMin, bpmMax)
-                    ? $"{bpmMin:0}"
-                    : $"{bpmMin:0}-{bpmMax:0} (mostly {mostCommonBPM:0})";
+                string labelText = bpmMin == bpmMax
+                    ? $"{bpmMin}"
+                    : $"{bpmMin}-{bpmMax} (mostly {mostCommonBPM})";
 
                 bpmLabelContainer.Child = new InfoLabel(new BeatmapStatistic
                 {

From 84a3cee452364173ed73d405e3a6caade62263b7 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 20 May 2022 17:47:45 +0300
Subject: [PATCH 4937/5547] Apply rate multiplier outside BPM rounding

---
 .../Visual/SongSelect/TestSceneBeatmapInfoWedge.cs  | 13 +++++++++----
 osu.Game/Screens/Select/BeatmapInfoWedge.cs         |  6 +++---
 2 files changed, 12 insertions(+), 7 deletions(-)

diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapInfoWedge.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapInfoWedge.cs
index 995274e722..030055903f 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapInfoWedge.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapInfoWedge.cs
@@ -168,16 +168,21 @@ namespace osu.Game.Tests.Visual.SongSelect
             checkDisplayedBPM($"{bpm * 2}");
         }
 
-        [TestCase(120, 125, "120-125 (mostly 120)")]
-        [TestCase(120, 120.6, "120-121 (mostly 120)")]
-        [TestCase(120, 120.4, "120")]
-        public void TestVaryingBPM(double commonBpm, double otherBpm, string expectedDisplay)
+        [TestCase(120, 125, null, "120-125 (mostly 120)")]
+        [TestCase(120, 120.6, null, "120-121 (mostly 120)")]
+        [TestCase(120, 120.4, null, "120")]
+        [TestCase(120, 120.6, "DT", "180-182 (mostly 180)")]
+        [TestCase(120, 120.4, "DT", "180")]
+        public void TestVaryingBPM(double commonBpm, double otherBpm, string mod, string expectedDisplay)
         {
             IBeatmap beatmap = createTestBeatmap(new OsuRuleset().RulesetInfo);
             beatmap.ControlPointInfo.Add(0, new TimingControlPoint { BeatLength = 60 * 1000 / commonBpm });
             beatmap.ControlPointInfo.Add(100, new TimingControlPoint { BeatLength = 60 * 1000 / otherBpm });
             beatmap.ControlPointInfo.Add(200, new TimingControlPoint { BeatLength = 60 * 1000 / commonBpm });
 
+            if (mod != null)
+                AddStep($"select {mod}", () => SelectedMods.Value = new[] { Ruleset.Value.CreateInstance().CreateModFromAcronym(mod) });
+
             selectBeatmap(beatmap);
             checkDisplayedBPM(expectedDisplay);
         }
diff --git a/osu.Game/Screens/Select/BeatmapInfoWedge.cs b/osu.Game/Screens/Select/BeatmapInfoWedge.cs
index 55ade6fa33..d98238f518 100644
--- a/osu.Game/Screens/Select/BeatmapInfoWedge.cs
+++ b/osu.Game/Screens/Select/BeatmapInfoWedge.cs
@@ -415,9 +415,9 @@ namespace osu.Game.Screens.Select
                 foreach (var mod in mods.Value.OfType<IApplicableToRate>())
                     rate = mod.ApplyToRate(0, rate);
 
-                int bpmMax = (int)Math.Round(beatmap.ControlPointInfo.BPMMaximum * rate);
-                int bpmMin = (int)Math.Round(beatmap.ControlPointInfo.BPMMinimum * rate);
-                int mostCommonBPM = (int)Math.Round(60000 / beatmap.GetMostCommonBeatLength() * rate);
+                int bpmMax = (int)Math.Round(Math.Round(beatmap.ControlPointInfo.BPMMaximum) * rate);
+                int bpmMin = (int)Math.Round(Math.Round(beatmap.ControlPointInfo.BPMMinimum) * rate);
+                int mostCommonBPM = (int)Math.Round(Math.Round(60000 / beatmap.GetMostCommonBeatLength()) * rate);
 
                 string labelText = bpmMin == bpmMax
                     ? $"{bpmMin}"

From 7dcb88759afcf00ce46e930ce117729fe9d7416f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 21 May 2022 00:28:17 +0900
Subject: [PATCH 4938/5547] Remove unnecessary using statement

---
 osu.Game/Graphics/ScreenshotManager.cs | 1 -
 1 file changed, 1 deletion(-)

diff --git a/osu.Game/Graphics/ScreenshotManager.cs b/osu.Game/Graphics/ScreenshotManager.cs
index 1fc2633143..53f7d5791b 100644
--- a/osu.Game/Graphics/ScreenshotManager.cs
+++ b/osu.Game/Graphics/ScreenshotManager.cs
@@ -2,7 +2,6 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
-using System.IO;
 using System.Threading;
 using System.Threading.Tasks;
 using osu.Framework.Allocation;

From 1f17652c1d55d0f42a9394af259f668961982077 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 20 May 2022 19:08:41 +0300
Subject: [PATCH 4939/5547] Fix test failure due to async-loading of content

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

diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapInfoWedge.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapInfoWedge.cs
index 030055903f..ef04baefa2 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapInfoWedge.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapInfoWedge.cs
@@ -191,7 +191,7 @@ namespace osu.Game.Tests.Visual.SongSelect
         {
             AddUntilStep($"displayed bpm is {target}", () =>
             {
-                var label = this.ChildrenOfType<BeatmapInfoWedge.WedgeInfoText.InfoLabel>().Single(l => l.Statistic.Name == "BPM");
+                var label = infoWedge.DisplayedContent.ChildrenOfType<BeatmapInfoWedge.WedgeInfoText.InfoLabel>().Single(l => l.Statistic.Name == "BPM");
                 return label.Statistic.Content == target;
             });
         }

From d3f115bfe2b321a9309be155995d44e6fc0423a4 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 21 May 2022 13:53:58 +0900
Subject: [PATCH 4940/5547] Remove redundant qualifiers

---
 osu.Game/Graphics/Containers/BeatSyncedContainer.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Graphics/Containers/BeatSyncedContainer.cs b/osu.Game/Graphics/Containers/BeatSyncedContainer.cs
index 48936f7aa9..bd46a20434 100644
--- a/osu.Game/Graphics/Containers/BeatSyncedContainer.cs
+++ b/osu.Game/Graphics/Containers/BeatSyncedContainer.cs
@@ -124,9 +124,9 @@ namespace osu.Game.Graphics.Containers
 
             double currentTrackTime = clock.CurrentTime + EarlyActivationMilliseconds;
 
-            if (this.beatmap.Value.TrackLoaded && this.beatmap.Value.BeatmapLoaded)
+            if (beatmap.Value.TrackLoaded && beatmap.Value.BeatmapLoaded)
             {
-                track = this.beatmap.Value.Track;
+                track = beatmap.Value.Track;
             }
 
             IsBeatSyncedWithTrack = beatmap != null && clock.IsRunning && track?.Length > 0;

From 5bf17dde9fd244c76a61960f6689741128ed6a60 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 21 May 2022 14:35:07 +0900
Subject: [PATCH 4941/5547] Fix missing `MutatePath` calls

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

diff --git a/osu.Game/IO/WrappedStorage.cs b/osu.Game/IO/WrappedStorage.cs
index d4d9d531fa..a465c215e2 100644
--- a/osu.Game/IO/WrappedStorage.cs
+++ b/osu.Game/IO/WrappedStorage.cs
@@ -67,12 +67,12 @@ namespace osu.Game.IO
         public override IEnumerable<string> GetFiles(string path, string pattern = "*") =>
             ToLocalRelative(UnderlyingStorage.GetFiles(MutatePath(path), pattern));
 
-        public override Stream CreateFileSafely(string path) => UnderlyingStorage.CreateFileSafely(path);
+        public override Stream CreateFileSafely(string path) => UnderlyingStorage.CreateFileSafely(MutatePath(path));
 
         public override Stream GetStream(string path, FileAccess access = FileAccess.Read, FileMode mode = FileMode.OpenOrCreate) =>
             UnderlyingStorage.GetStream(MutatePath(path), access, mode);
 
-        public override void Move(string from, string to) => UnderlyingStorage.Move(from, to);
+        public override void Move(string from, string to) => UnderlyingStorage.Move(MutatePath(from), MutatePath(to));
 
         public override bool OpenFileExternally(string filename) => UnderlyingStorage.OpenFileExternally(MutatePath(filename));
 

From 72386d9377412eb2ba5adef5e06ade4b389cb2ec Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 21 May 2022 15:15:52 +0900
Subject: [PATCH 4942/5547] Fix incorrect storage being used in
 `CreateFileSafely` implementation

---
 osu.Game/IO/WrappedStorage.cs | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/osu.Game/IO/WrappedStorage.cs b/osu.Game/IO/WrappedStorage.cs
index a465c215e2..5887704768 100644
--- a/osu.Game/IO/WrappedStorage.cs
+++ b/osu.Game/IO/WrappedStorage.cs
@@ -11,7 +11,7 @@ namespace osu.Game.IO
     /// <summary>
     /// A storage which wraps another storage and delegates implementation, potentially mutating the lookup path.
     /// </summary>
-    public class WrappedStorage : Storage
+    public class WrappedStorage : NativeStorage // TODO: Revert to Storage inheritance after https://github.com/ppy/osu-framework/pull/5189
     {
         protected Storage UnderlyingStorage { get; private set; }
 
@@ -67,8 +67,6 @@ namespace osu.Game.IO
         public override IEnumerable<string> GetFiles(string path, string pattern = "*") =>
             ToLocalRelative(UnderlyingStorage.GetFiles(MutatePath(path), pattern));
 
-        public override Stream CreateFileSafely(string path) => UnderlyingStorage.CreateFileSafely(MutatePath(path));
-
         public override Stream GetStream(string path, FileAccess access = FileAccess.Read, FileMode mode = FileMode.OpenOrCreate) =>
             UnderlyingStorage.GetStream(MutatePath(path), access, mode);
 

From ba21556d4e9271b7f7e9185eb19b5ccec2b2901c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 21 May 2022 15:54:43 +0900
Subject: [PATCH 4943/5547] Update framework

---
 osu.Android.props        | 2 +-
 osu.Game/osu.Game.csproj | 2 +-
 osu.iOS.props            | 4 ++--
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Android.props b/osu.Android.props
index 7910100b1f..aaea784852 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -52,7 +52,7 @@
   </ItemGroup>
   <ItemGroup>
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.513.0" />
-    <PackageReference Include="ppy.osu.Framework.Android" Version="2022.520.0" />
+    <PackageReference Include="ppy.osu.Framework.Android" Version="2022.521.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
     <!-- Realm needs to be directly referenced in all Xamarin projects, as it will not pull in its transitive dependencies otherwise. -->
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 17bc056b59..5bc65ca507 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="10.11.2" />
-    <PackageReference Include="ppy.osu.Framework" Version="2022.520.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2022.521.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.513.0" />
     <PackageReference Include="Sentry" Version="3.17.1" />
     <PackageReference Include="SharpCompress" Version="0.31.0" />
diff --git a/osu.iOS.props b/osu.iOS.props
index 191d1bd5ca..3597e7e5c0 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -61,7 +61,7 @@
     <Reference Include="System.Net.Http" />
   </ItemGroup>
   <ItemGroup Label="Package References">
-    <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.520.0" />
+    <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.521.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.513.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net6.0) -->
@@ -84,7 +84,7 @@
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="5.0.14" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.Core" Version="5.0.14" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
-    <PackageReference Include="ppy.osu.Framework" Version="2022.520.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2022.521.0" />
     <PackageReference Include="SharpCompress" Version="0.31.0" />
     <PackageReference Include="NUnit" Version="3.13.3" />
     <PackageReference Include="System.ComponentModel.Annotations" Version="5.0.0" />

From c587d10cc3dcef9be569b2b6d453bb2b1c79b1cd Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 21 May 2022 15:55:07 +0900
Subject: [PATCH 4944/5547] Revert storage workaround

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

diff --git a/osu.Game/IO/WrappedStorage.cs b/osu.Game/IO/WrappedStorage.cs
index 5887704768..7205ea3adb 100644
--- a/osu.Game/IO/WrappedStorage.cs
+++ b/osu.Game/IO/WrappedStorage.cs
@@ -11,7 +11,7 @@ namespace osu.Game.IO
     /// <summary>
     /// A storage which wraps another storage and delegates implementation, potentially mutating the lookup path.
     /// </summary>
-    public class WrappedStorage : NativeStorage // TODO: Revert to Storage inheritance after https://github.com/ppy/osu-framework/pull/5189
+    public class WrappedStorage : Storage
     {
         protected Storage UnderlyingStorage { get; private set; }
 

From a7aa36a825cc9589ee6f3cf5bf2f5792d8df09cd Mon Sep 17 00:00:00 2001
From: maromalo <54760464+maromalo@users.noreply.github.com>
Date: Sat, 21 May 2022 04:55:42 -0300
Subject: [PATCH 4945/5547] Add OnPressed to button

---
 .../Screens/OnlinePlay/Match/RoomSubScreen.cs    | 16 +++++++++++++++-
 1 file changed, 15 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs b/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
index 13b2c37ded..61798b5413 100644
--- a/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
@@ -15,9 +15,12 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Cursor;
 using osu.Framework.Graphics.Shapes;
+using osu.Framework.Input.Bindings;
+using osu.Framework.Input.Events;
 using osu.Framework.Screens;
 using osu.Game.Audio;
 using osu.Game.Beatmaps;
+using osu.Game.Input.Bindings;
 using osu.Game.Online.Rooms;
 using osu.Game.Overlays;
 using osu.Game.Overlays.Mods;
@@ -473,8 +476,19 @@ namespace osu.Game.Screens.OnlinePlay.Match
         /// <param name="room">The room to change the settings of.</param>
         protected abstract RoomSettingsOverlay CreateRoomSettingsOverlay(Room room);
 
-        public class UserModSelectButton : PurpleTriangleButton
+        public class UserModSelectButton : PurpleTriangleButton, IKeyBindingHandler<GlobalAction>
         {
+            public virtual bool OnPressed(KeyBindingPressEvent<GlobalAction> e)
+            {
+                if (e.Action == GlobalAction.ToggleModSelection && !e.Repeat)
+                {
+                    TriggerClick();
+                    return true;
+                }
+                return false;
+            }
+
+            public virtual void OnReleased(KeyBindingReleaseEvent<GlobalAction> e) { }
         }
 
         protected override void Dispose(bool isDisposing)

From 2bd4c126d39223990260535b2f4874ef8229e0b8 Mon Sep 17 00:00:00 2001
From: maromalo <54760464+maromalo@users.noreply.github.com>
Date: Sat, 21 May 2022 05:07:24 -0300
Subject: [PATCH 4946/5547] Blank line

Forgot to save.
---
 osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs b/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
index 61798b5413..0dc6e52770 100644
--- a/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
@@ -485,6 +485,7 @@ namespace osu.Game.Screens.OnlinePlay.Match
                     TriggerClick();
                     return true;
                 }
+
                 return false;
             }
 

From 376549ce09a2570811ff8b7ea1e6ce3b1636b812 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 21 May 2022 21:48:51 +0900
Subject: [PATCH 4947/5547] Use `ToLocalisableString` instead of
 `CurrentCulture`

---
 osu.Game/Screens/Edit/Timing/MetronomeDisplay.cs | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Edit/Timing/MetronomeDisplay.cs b/osu.Game/Screens/Edit/Timing/MetronomeDisplay.cs
index d51d7b9c58..98ce9f0f46 100644
--- a/osu.Game/Screens/Edit/Timing/MetronomeDisplay.cs
+++ b/osu.Game/Screens/Edit/Timing/MetronomeDisplay.cs
@@ -6,6 +6,7 @@ using System.Globalization;
 using osu.Framework.Allocation;
 using osu.Framework.Audio.Track;
 using osu.Framework.Bindables;
+using osu.Framework.Extensions.LocalisationExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Colour;
 using osu.Framework.Graphics.Containers;
@@ -209,7 +210,7 @@ namespace osu.Game.Screens.Edit.Timing
         {
             base.LoadComplete();
 
-            interpolatedBpm.BindValueChanged(bpm => bpmText.Text = bpm.NewValue.ToString(CultureInfo.CurrentCulture));
+            interpolatedBpm.BindValueChanged(bpm => bpmText.Text = bpm.NewValue.ToLocalisableString());
         }
 
         protected override void Update()

From 9a780bcad3b6e7e4b14fe11f3bc1f2c23c13c6d0 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 21 May 2022 21:56:05 +0900
Subject: [PATCH 4948/5547] Remove unused using

---
 osu.Game/Screens/Edit/Timing/MetronomeDisplay.cs | 1 -
 1 file changed, 1 deletion(-)

diff --git a/osu.Game/Screens/Edit/Timing/MetronomeDisplay.cs b/osu.Game/Screens/Edit/Timing/MetronomeDisplay.cs
index 98ce9f0f46..b59865ac1a 100644
--- a/osu.Game/Screens/Edit/Timing/MetronomeDisplay.cs
+++ b/osu.Game/Screens/Edit/Timing/MetronomeDisplay.cs
@@ -2,7 +2,6 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
-using System.Globalization;
 using osu.Framework.Allocation;
 using osu.Framework.Audio.Track;
 using osu.Framework.Bindables;

From 466ed3c791507796151fb504ad353902a71c1f32 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sat, 21 May 2022 16:43:31 +0300
Subject: [PATCH 4949/5547] Fix wrong return 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/Beatmaps/WorkingBeatmap.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Beatmaps/WorkingBeatmap.cs b/osu.Game/Beatmaps/WorkingBeatmap.cs
index a1a8306b76..5551e0b3e5 100644
--- a/osu.Game/Beatmaps/WorkingBeatmap.cs
+++ b/osu.Game/Beatmaps/WorkingBeatmap.cs
@@ -130,7 +130,7 @@ namespace osu.Game.Beatmaps
         /// Used as an optimisation to avoid reload / track swap across difficulties in the same beatmap set.
         /// </summary>
         /// <param name="target">The target working beatmap to transfer this track to.</param>
-        /// <returns>Whether the track is valid and has been transferred to this working beatmap.</returns>
+        /// <returns>Whether the track has been transferred to the <paramref name="target"/>.</returns>
         public virtual bool TryTransferTrack([NotNull] WorkingBeatmap target)
         {
             if (BeatmapInfo?.AudioEquals(target.BeatmapInfo) != true)

From a42f5ea34ec5c88b002037692029422931a4dcb8 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sat, 21 May 2022 16:50:40 +0300
Subject: [PATCH 4950/5547] Bring back virtual track condition given its
 cheapness

Will still keep the override in `ClockBackedTestWorkingBeatmap` because
it still relies on a local track store and will fail the moment it uses
a non-virtual track.
---
 osu.Game/Beatmaps/WorkingBeatmap.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Beatmaps/WorkingBeatmap.cs b/osu.Game/Beatmaps/WorkingBeatmap.cs
index 5551e0b3e5..5fc579b47c 100644
--- a/osu.Game/Beatmaps/WorkingBeatmap.cs
+++ b/osu.Game/Beatmaps/WorkingBeatmap.cs
@@ -133,7 +133,7 @@ namespace osu.Game.Beatmaps
         /// <returns>Whether the track has been transferred to the <paramref name="target"/>.</returns>
         public virtual bool TryTransferTrack([NotNull] WorkingBeatmap target)
         {
-            if (BeatmapInfo?.AudioEquals(target.BeatmapInfo) != true)
+            if (BeatmapInfo?.AudioEquals(target.BeatmapInfo) != true || track.IsDummyDevice)
                 return false;
 
             target.track = track;

From a17eed64f96c2557bbf632d894694fd57bc1d00c Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sat, 21 May 2022 16:51:04 +0300
Subject: [PATCH 4951/5547] Use `Track` to ensure its loaded before
 transferring

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

diff --git a/osu.Game/Beatmaps/WorkingBeatmap.cs b/osu.Game/Beatmaps/WorkingBeatmap.cs
index 5fc579b47c..09072ec897 100644
--- a/osu.Game/Beatmaps/WorkingBeatmap.cs
+++ b/osu.Game/Beatmaps/WorkingBeatmap.cs
@@ -133,10 +133,10 @@ namespace osu.Game.Beatmaps
         /// <returns>Whether the track has been transferred to the <paramref name="target"/>.</returns>
         public virtual bool TryTransferTrack([NotNull] WorkingBeatmap target)
         {
-            if (BeatmapInfo?.AudioEquals(target.BeatmapInfo) != true || track.IsDummyDevice)
+            if (BeatmapInfo?.AudioEquals(target.BeatmapInfo) != true || Track.IsDummyDevice)
                 return false;
 
-            target.track = track;
+            target.track = Track;
             return true;
         }
 

From d73afcaf484185ac1d1102b8b2c4df4a118c98b5 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 12 May 2022 17:29:28 +0300
Subject: [PATCH 4952/5547] Fix existing test coverage false-passing

Also improves general test coverage to test more realisticly, in order
to produce accurate results.
---
 .../TestSceneMultiSpectatorScreen.cs          | 46 ++++++++++---------
 1 file changed, 24 insertions(+), 22 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs
index 703b526e8c..c048722804 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.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 NUnit.Framework;
@@ -15,13 +16,14 @@ using osu.Game.Configuration;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Multiplayer.MatchTypes.TeamVersus;
-using osu.Game.Online.Rooms;
 using osu.Game.Rulesets.UI;
 using osu.Game.Screens.OnlinePlay.Multiplayer.Spectate;
 using osu.Game.Screens.Play;
 using osu.Game.Screens.Play.HUD;
 using osu.Game.Screens.Play.PlayerSettings;
+using osu.Game.Storyboards;
 using osu.Game.Tests.Beatmaps.IO;
+using osuTK;
 using osuTK.Graphics;
 
 namespace osu.Game.Tests.Visual.Multiplayer
@@ -349,15 +351,27 @@ namespace osu.Game.Tests.Visual.Multiplayer
         }
 
         /// <summary>
-        /// Tests spectating with a gameplay start time set to a negative value.
-        /// Simulating beatmaps with high <see cref="BeatmapInfo.AudioLeadIn"/> or negative time storyboard elements.
+        /// Tests spectating with a beatmap that has a high <see cref="BeatmapInfo.AudioLeadIn"/> value.
         /// </summary>
         [Test]
-        public void TestNegativeGameplayStartTime()
+        public void TestAudioLeadIn() => testLeadIn(b => b.BeatmapInfo.AudioLeadIn = 2000);
+
+        /// <summary>
+        /// Tests spectating with a beatmap that has a storyboard element with a negative start time (i.e. intro storyboard element).
+        /// </summary>
+        [Test]
+        public void TestIntroStoryboardElement() => testLeadIn(b =>
+        {
+            var sprite = new StoryboardSprite("unknown", Anchor.TopLeft, Vector2.Zero);
+            sprite.TimelineGroup.Alpha.Add(Easing.None, -2000, 0, 0, 1);
+            b.Storyboard.GetLayer("Background").Add(sprite);
+        });
+
+        private void testLeadIn(Action<WorkingBeatmap> applyToBeatmap = null)
         {
             start(PLAYER_1_ID);
 
-            loadSpectateScreen(false, -500);
+            loadSpectateScreen(false, applyToBeatmap);
 
             // to ensure negative gameplay start time does not affect spectator, send frames exactly after StartGameplay().
             // (similar to real spectating sessions in which the first frames get sent between StartGameplay() and player load complete)
@@ -371,14 +385,16 @@ namespace osu.Game.Tests.Visual.Multiplayer
             assertRunning(PLAYER_1_ID);
         }
 
-        private void loadSpectateScreen(bool waitForPlayerLoad = true, double? gameplayStartTime = null)
+        private void loadSpectateScreen(bool waitForPlayerLoad = true, Action<WorkingBeatmap> applyToBeatmap = null)
         {
-            AddStep(!gameplayStartTime.HasValue ? "load screen" : $"load screen (start = {gameplayStartTime}ms)", () =>
+            AddStep("load screen", () =>
             {
                 Beatmap.Value = beatmapManager.GetWorkingBeatmap(importedBeatmap);
                 Ruleset.Value = importedBeatmap.Ruleset;
 
-                LoadScreen(spectatorScreen = new TestMultiSpectatorScreen(SelectedRoom.Value, playingUsers.ToArray(), gameplayStartTime));
+                applyToBeatmap?.Invoke(Beatmap.Value);
+
+                LoadScreen(spectatorScreen = new MultiSpectatorScreen(SelectedRoom.Value, playingUsers.ToArray()));
             });
 
             AddUntilStep("wait for screen load", () => spectatorScreen.LoadState == LoadState.Loaded && (!waitForPlayerLoad || spectatorScreen.AllPlayersLoaded));
@@ -461,19 +477,5 @@ namespace osu.Game.Tests.Visual.Multiplayer
         private GameplayLeaderboardScore getLeaderboardScore(int userId) => spectatorScreen.ChildrenOfType<GameplayLeaderboardScore>().Single(s => s.User?.Id == userId);
 
         private int[] getPlayerIds(int count) => Enumerable.Range(PLAYER_1_ID, count).ToArray();
-
-        private class TestMultiSpectatorScreen : MultiSpectatorScreen
-        {
-            private readonly double? startTime;
-
-            public TestMultiSpectatorScreen(Room room, MultiplayerRoomUser[] users, double? startTime = null)
-                : base(room, users)
-            {
-                this.startTime = startTime;
-            }
-
-            protected override MasterGameplayClockContainer CreateMasterGameplayClockContainer(WorkingBeatmap beatmap)
-                => new MasterGameplayClockContainer(beatmap, 0) { StartTime = startTime ?? 0 };
-        }
     }
 }

From 27da293b4053d9fce0ca0cd161f32c1e7127d535 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 13 May 2022 00:07:11 +0300
Subject: [PATCH 4953/5547] Make catch-up spectator clocks running state
 immutable externally

---
 .../Spectate/CatchUpSpectatorPlayerClock.cs            | 10 ++++++++++
 .../Multiplayer/Spectate/CatchUpSyncManager.cs         |  2 ++
 .../Multiplayer/Spectate/ISpectatorPlayerClock.cs      | 10 ++++++++++
 3 files changed, 22 insertions(+)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/CatchUpSpectatorPlayerClock.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/CatchUpSpectatorPlayerClock.cs
index 20d12d62a3..48d0b063ff 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/CatchUpSpectatorPlayerClock.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/CatchUpSpectatorPlayerClock.cs
@@ -34,6 +34,16 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Spectate
 
         public void Stop() => IsRunning = false;
 
+        void IAdjustableClock.Start()
+        {
+            // Our running state should only be managed by an ISyncManager, ignore calls from external sources.
+        }
+
+        void IAdjustableClock.Stop()
+        {
+            // Our running state should only be managed by an ISyncManager, ignore calls from external sources.
+        }
+
         public bool Seek(double position)
         {
             CurrentTime = position;
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/CatchUpSyncManager.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/CatchUpSyncManager.cs
index b8f47c16ff..b0fdeddd56 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/CatchUpSyncManager.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/CatchUpSyncManager.cs
@@ -144,6 +144,8 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Spectate
                 // Make sure the player clock is running if it can.
                 if (!clock.WaitingOnFrames.Value)
                     clock.Start();
+                else
+                    clock.Stop();
 
                 if (clock.IsCatchingUp)
                 {
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/ISpectatorPlayerClock.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/ISpectatorPlayerClock.cs
index de23b4fef7..b2ecb105c2 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/ISpectatorPlayerClock.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/ISpectatorPlayerClock.cs
@@ -11,6 +11,16 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Spectate
     /// </summary>
     public interface ISpectatorPlayerClock : IFrameBasedClock, IAdjustableClock
     {
+        /// <summary>
+        /// Starts this <see cref="ISpectatorPlayerClock"/>.
+        /// </summary>
+        new void Start();
+
+        /// <summary>
+        /// Stops this <see cref="ISpectatorPlayerClock"/>.
+        /// </summary>
+        new void Stop();
+
         /// <summary>
         /// Whether this clock is waiting on frames to continue playback.
         /// </summary>

From efae934e0199713368a4e9cf563cb77a6202f6a6 Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Sat, 21 May 2022 17:35:31 +0100
Subject: [PATCH 4954/5547] Fix slow loading channel test

---
 osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs b/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs
index 4f916eec18..e27db00003 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs
@@ -397,6 +397,7 @@ namespace osu.Game.Tests.Visual.Online
                 chatOverlay.SlowLoading = true;
             });
             AddStep("Join channel 1", () => channelManager.JoinChannel(testChannel1));
+            AddStep("Select channel 1", () => clickDrawable(getChannelListItem(testChannel1)));
             AddAssert("Channel 1 loading", () => !channelIsVisible && chatOverlay.GetSlowLoadingChannel(testChannel1).LoadState == LoadState.Loading);
 
             AddStep("Join channel 2", () => channelManager.JoinChannel(testChannel2));

From 21e1576b2fccaf00eaf980265c8b6590103d4767 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 21 May 2022 20:49:29 +0200
Subject: [PATCH 4955/5547] Fix appearance of sheared button borders after
 click

The border would previously get brighter after click, but then dim
instantly when the flash layer has fully faded out. The underlying issue
there is https://github.com/ppy/osu-framework/issues/5191, but
`ShearedButton` was placing the flashing layer incorrectly anyway, as
the intent was that it should also apply to the border.
---
 .../Graphics/UserInterface/ShearedButton.cs   | 37 +++++++++++++------
 1 file changed, 25 insertions(+), 12 deletions(-)

diff --git a/osu.Game/Graphics/UserInterface/ShearedButton.cs b/osu.Game/Graphics/UserInterface/ShearedButton.cs
index dea44e6d99..66c6eedd0c 100644
--- a/osu.Game/Graphics/UserInterface/ShearedButton.cs
+++ b/osu.Game/Graphics/UserInterface/ShearedButton.cs
@@ -5,6 +5,7 @@
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Colour;
+using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Input.Events;
 using osu.Framework.Localisation;
@@ -68,6 +69,7 @@ namespace osu.Game.Graphics.UserInterface
         private Colour4? lighterColour;
         private Colour4? textColour;
 
+        private readonly Container backgroundLayer;
         private readonly Box flashLayer;
 
         /// <summary>
@@ -85,24 +87,35 @@ namespace osu.Game.Graphics.UserInterface
             Height = 50;
             Padding = new MarginPadding { Horizontal = shear * 50 };
 
-            Content.CornerRadius = 7;
+            const float corner_radius = 7;
+
+            Content.CornerRadius = corner_radius;
             Content.Shear = new Vector2(shear, 0);
             Content.Masking = true;
-            Content.BorderThickness = 2;
             Content.Anchor = Content.Origin = Anchor.Centre;
 
             Children = new Drawable[]
             {
-                background = new Box
+                backgroundLayer = new Container
                 {
-                    RelativeSizeAxes = Axes.Both
-                },
-                text = new OsuSpriteText
-                {
-                    Anchor = Anchor.Centre,
-                    Origin = Anchor.Centre,
-                    Font = OsuFont.TorusAlternate.With(size: 17),
-                    Shear = new Vector2(-shear, 0)
+                    RelativeSizeAxes = Axes.Both,
+                    CornerRadius = corner_radius,
+                    Masking = true,
+                    BorderThickness = 2,
+                    Children = new Drawable[]
+                    {
+                        background = new Box
+                        {
+                            RelativeSizeAxes = Axes.Both
+                        },
+                        text = new OsuSpriteText
+                        {
+                            Anchor = Anchor.Centre,
+                            Origin = Anchor.Centre,
+                            Font = OsuFont.TorusAlternate.With(size: 17),
+                            Shear = new Vector2(-shear, 0)
+                        },
+                    }
                 },
                 flashLayer = new Box
                 {
@@ -186,7 +199,7 @@ namespace osu.Game.Graphics.UserInterface
             }
 
             background.FadeColour(colourDark, 150, Easing.OutQuint);
-            Content.TransformTo(nameof(BorderColour), ColourInfo.GradientVertical(colourDark, colourLight), 150, Easing.OutQuint);
+            backgroundLayer.TransformTo(nameof(BorderColour), ColourInfo.GradientVertical(colourDark, colourLight), 150, Easing.OutQuint);
 
             if (!Enabled.Value)
                 colourText = colourText.Opacity(0.6f);

From fc25d248ad18d4af683347fe0a3b444504e4161c Mon Sep 17 00:00:00 2001
From: maromalo <54760464+maromalo@users.noreply.github.com>
Date: Sat, 21 May 2022 18:16:29 -0300
Subject: [PATCH 4956/5547] Test coverage + no virtual

---
 .../TestSceneMultiplayerMatchSubScreen.cs     | 42 +++++++++++++++++++
 .../Screens/OnlinePlay/Match/RoomSubScreen.cs |  4 +-
 2 files changed, 44 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs
index ca79fa9cb8..dd281e7738 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs
@@ -178,6 +178,48 @@ namespace osu.Game.Tests.Visual.Multiplayer
                           .SingleOrDefault(panel => !panel.Filtered.Value)?.Mod is OsuModDoubleTime);
         }
 
+        [Test]
+        public void TestModSelectKeyWithAllowedMods()
+        {
+            AddStep("add playlist item with allowed mod", () =>
+            {
+                SelectedRoom.Value.Playlist.Add(new PlaylistItem(new TestBeatmap(new OsuRuleset().RulesetInfo).BeatmapInfo)
+                {
+                    RulesetID = new OsuRuleset().RulesetInfo.OnlineID,
+                    AllowedMods = new[] { new APIMod(new OsuModDoubleTime()) }
+                });
+            });
+
+            ClickButtonWhenEnabled<MultiplayerMatchSettingsOverlay.CreateOrUpdateButton>();
+
+            AddUntilStep("wait for join", () => RoomJoined);
+
+            AddStep("press toggle mod select key", () => InputManager.Key(osuTK.Input.Key.F1));
+
+            AddUntilStep("mod select contents loaded",
+                () => this.ChildrenOfType<ModColumn>().Any() && this.ChildrenOfType<ModColumn>().All(col => col.IsLoaded && col.ItemsLoaded));
+        }
+
+        [Test]
+        public void TestModSelectKeyWithNoAllowedMods()
+        {
+            AddStep("add playlist item with no allowed mods", () =>
+            {
+                SelectedRoom.Value.Playlist.Add(new PlaylistItem(new TestBeatmap(new OsuRuleset().RulesetInfo).BeatmapInfo)
+                {
+                    RulesetID = new OsuRuleset().RulesetInfo.OnlineID,
+                });
+            });
+            ClickButtonWhenEnabled<MultiplayerMatchSettingsOverlay.CreateOrUpdateButton>();
+
+            AddUntilStep("wait for join", () => RoomJoined);
+
+            AddStep("press toggle mod select key", () => InputManager.Key(osuTK.Input.Key.F1));
+
+            AddAssert("mod select contents not loaded",
+                () => !(this.ChildrenOfType<ModColumn>().Any() && this.ChildrenOfType<ModColumn>().All(col => col.IsLoaded && col.ItemsLoaded)));
+        }
+
         [Test]
         public void TestNextPlaylistItemSelectedAfterCompletion()
         {
diff --git a/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs b/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
index 0dc6e52770..a612b6a0e6 100644
--- a/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
@@ -478,7 +478,7 @@ namespace osu.Game.Screens.OnlinePlay.Match
 
         public class UserModSelectButton : PurpleTriangleButton, IKeyBindingHandler<GlobalAction>
         {
-            public virtual bool OnPressed(KeyBindingPressEvent<GlobalAction> e)
+            public bool OnPressed(KeyBindingPressEvent<GlobalAction> e)
             {
                 if (e.Action == GlobalAction.ToggleModSelection && !e.Repeat)
                 {
@@ -489,7 +489,7 @@ namespace osu.Game.Screens.OnlinePlay.Match
                 return false;
             }
 
-            public virtual void OnReleased(KeyBindingReleaseEvent<GlobalAction> e) { }
+            public void OnReleased(KeyBindingReleaseEvent<GlobalAction> e) { }
         }
 
         protected override void Dispose(bool isDisposing)

From eabf57828276ce8ce2b2ad16305e54df271b34ed Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 22 May 2022 22:15:53 +0900
Subject: [PATCH 4957/5547] Use interface to convey beat sync information

---
 .../TestSceneBeatSyncedContainer.cs           | 22 +++++--
 .../Containers/BeatSyncedContainer.cs         | 65 ++++---------------
 .../Graphics/Containers/IBeatSyncProvider.cs  | 26 ++++++++
 osu.Game/OsuGameBase.cs                       | 10 ++-
 osu.Game/Rulesets/Mods/MetronomeBeat.cs       |  2 +-
 osu.Game/Screens/Edit/Editor.cs               | 10 ++-
 .../Screens/Edit/Timing/MetronomeDisplay.cs   | 12 ++--
 .../Play/MasterGameplayClockContainer.cs      |  8 ++-
 osu.Game/Screens/Play/Player.cs               |  9 ++-
 9 files changed, 96 insertions(+), 68 deletions(-)
 create mode 100644 osu.Game/Graphics/Containers/IBeatSyncProvider.cs

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneBeatSyncedContainer.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneBeatSyncedContainer.cs
index 1881f6d718..3cbb7daf51 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneBeatSyncedContainer.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneBeatSyncedContainer.cs
@@ -3,6 +3,7 @@
 
 using System;
 using System.Collections.Generic;
+using System.Diagnostics;
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Audio.Track;
@@ -82,11 +83,15 @@ namespace osu.Game.Tests.Visual.UserInterface
 
             if (!allowMistimed)
             {
-                AddAssert("trigger is near beat length", () => lastActuationTime != null && lastBeatIndex != null && Precision.AlmostEquals(lastTimingPoint.Time + lastBeatIndex.Value * lastTimingPoint.BeatLength, lastActuationTime.Value, BeatSyncedContainer.MISTIMED_ALLOWANCE));
+                AddAssert("trigger is near beat length",
+                    () => lastActuationTime != null && lastBeatIndex != null && Precision.AlmostEquals(lastTimingPoint.Time + lastBeatIndex.Value * lastTimingPoint.BeatLength, lastActuationTime.Value,
+                        BeatSyncedContainer.MISTIMED_ALLOWANCE));
             }
             else
             {
-                AddAssert("trigger is not near beat length", () => lastActuationTime != null && lastBeatIndex != null && !Precision.AlmostEquals(lastTimingPoint.Time + lastBeatIndex.Value * lastTimingPoint.BeatLength, lastActuationTime.Value, BeatSyncedContainer.MISTIMED_ALLOWANCE));
+                AddAssert("trigger is not near beat length",
+                    () => lastActuationTime != null && lastBeatIndex != null && !Precision.AlmostEquals(lastTimingPoint.Time + lastBeatIndex.Value * lastTimingPoint.BeatLength,
+                        lastActuationTime.Value, BeatSyncedContainer.MISTIMED_ALLOWANCE));
             }
         }
 
@@ -258,7 +263,7 @@ namespace osu.Game.Tests.Visual.UserInterface
                 };
             }
 
-            private List<TimingControlPoint> timingPoints => Beatmap.ControlPointInfo.TimingPoints.ToList();
+            private List<TimingControlPoint> timingPoints => BeatSyncSource.ControlPoints?.TimingPoints.ToList();
 
             private TimingControlPoint getNextTimingPoint(TimingControlPoint current)
             {
@@ -275,7 +280,11 @@ namespace osu.Game.Tests.Visual.UserInterface
                 if (timingPoints.Count == 0) return 0;
 
                 if (timingPoints[^1] == current)
-                    return (int)Math.Ceiling((BeatSyncClock.CurrentTime - current.Time) / current.BeatLength);
+                {
+                    Debug.Assert(BeatSyncSource.Clock != null);
+
+                    return (int)Math.Ceiling((BeatSyncSource.Clock.CurrentTime - current.Time) / current.BeatLength);
+                }
 
                 return (int)Math.Ceiling((getNextTimingPoint(current).Time - current.Time) / current.BeatLength);
             }
@@ -283,9 +292,12 @@ namespace osu.Game.Tests.Visual.UserInterface
             protected override void Update()
             {
                 base.Update();
+
+                Debug.Assert(BeatSyncSource.Clock != null);
+
                 timeUntilNextBeat.Value = TimeUntilNextBeat;
                 timeSinceLastBeat.Value = TimeSinceLastBeat;
-                currentTime.Value = BeatSyncClock.CurrentTime;
+                currentTime.Value = BeatSyncSource.Clock.CurrentTime;
             }
 
             public Action<int, TimingControlPoint, EffectControlPoint, ChannelAmplitudes> NewBeat;
diff --git a/osu.Game/Graphics/Containers/BeatSyncedContainer.cs b/osu.Game/Graphics/Containers/BeatSyncedContainer.cs
index bd46a20434..953731244d 100644
--- a/osu.Game/Graphics/Containers/BeatSyncedContainer.cs
+++ b/osu.Game/Graphics/Containers/BeatSyncedContainer.cs
@@ -5,12 +5,9 @@ using System;
 using System.Diagnostics;
 using osu.Framework.Allocation;
 using osu.Framework.Audio.Track;
-using osu.Framework.Bindables;
 using osu.Framework.Graphics.Containers;
-using osu.Framework.Timing;
 using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.ControlPoints;
-using osu.Game.Screens.Edit;
 using osu.Game.Screens.Play;
 
 namespace osu.Game.Graphics.Containers
@@ -75,74 +72,38 @@ namespace osu.Game.Graphics.Containers
         /// </summary>
         protected bool IsBeatSyncedWithTrack { get; private set; }
 
+        [Resolved]
+        protected IBeatSyncProvider BeatSyncSource { get; private set; }
+
         protected virtual void OnNewBeat(int beatIndex, TimingControlPoint timingPoint, EffectControlPoint effectPoint, ChannelAmplitudes amplitudes)
         {
         }
 
-        [Resolved]
-        private IBindable<WorkingBeatmap> beatmap { get; set; }
-
-        [Resolved(canBeNull: true)]
-        protected GameplayClock GameplayClock { get; private set; }
-
-        [Resolved(canBeNull: true)]
-        protected EditorBeatmap EditorBeatmap { get; private set; }
-
-        [Resolved(canBeNull: true)]
-        protected EditorClock EditorClock { get; private set; }
-
-        protected IBeatmap Beatmap => EditorBeatmap ?? beatmap?.Value.Beatmap;
-
-        protected IClock BeatSyncClock
-        {
-            get
-            {
-                if (EditorClock != null)
-                    return EditorClock;
-
-                if (GameplayClock != null)
-                    return GameplayClock;
-
-                if (beatmap.Value.TrackLoaded)
-                    return beatmap.Value.Track;
-
-                return null;
-            }
-        }
-
         protected override void Update()
         {
-            ITrack track = null;
-
             TimingControlPoint timingPoint;
             EffectControlPoint effectPoint;
 
-            IClock clock = BeatSyncClock;
+            IsBeatSyncedWithTrack = BeatSyncSource.Clock?.IsRunning == true;
 
-            if (clock == null)
-                return;
-
-            double currentTrackTime = clock.CurrentTime + EarlyActivationMilliseconds;
-
-            if (beatmap.Value.TrackLoaded && beatmap.Value.BeatmapLoaded)
-            {
-                track = beatmap.Value.Track;
-            }
-
-            IsBeatSyncedWithTrack = beatmap != null && clock.IsRunning && track?.Length > 0;
+            double currentTrackTime;
 
             if (IsBeatSyncedWithTrack)
             {
-                Debug.Assert(beatmap != null);
+                Debug.Assert(BeatSyncSource.ControlPoints != null);
+                Debug.Assert(BeatSyncSource.Clock != null);
 
-                timingPoint = Beatmap.ControlPointInfo.TimingPointAt(currentTrackTime);
-                effectPoint = Beatmap.ControlPointInfo.EffectPointAt(currentTrackTime);
+                currentTrackTime = BeatSyncSource.Clock.CurrentTime + EarlyActivationMilliseconds;
+
+                timingPoint = BeatSyncSource.ControlPoints.TimingPointAt(currentTrackTime);
+                effectPoint = BeatSyncSource.ControlPoints.EffectPointAt(currentTrackTime);
             }
             else
             {
                 // this may be the case where the beat syncing clock has been paused.
                 // we still want to show an idle animation, so use this container's time instead.
                 currentTrackTime = Clock.CurrentTime + EarlyActivationMilliseconds;
+
                 timingPoint = TimingControlPoint.DEFAULT;
                 effectPoint = EffectControlPoint.DEFAULT;
             }
@@ -172,7 +133,7 @@ namespace osu.Game.Graphics.Containers
             if (AllowMistimedEventFiring || Math.Abs(TimeSinceLastBeat) < MISTIMED_ALLOWANCE)
             {
                 using (BeginDelayedSequence(-TimeSinceLastBeat))
-                    OnNewBeat(beatIndex, timingPoint, effectPoint, track?.CurrentAmplitudes ?? ChannelAmplitudes.Empty);
+                    OnNewBeat(beatIndex, timingPoint, effectPoint, BeatSyncSource.Amplitudes ?? ChannelAmplitudes.Empty);
             }
 
             lastBeat = beatIndex;
diff --git a/osu.Game/Graphics/Containers/IBeatSyncProvider.cs b/osu.Game/Graphics/Containers/IBeatSyncProvider.cs
new file mode 100644
index 0000000000..d5be50297c
--- /dev/null
+++ b/osu.Game/Graphics/Containers/IBeatSyncProvider.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.
+
+#nullable enable
+
+using osu.Framework.Allocation;
+using osu.Framework.Audio.Track;
+using osu.Framework.Timing;
+using osu.Game.Beatmaps.ControlPoints;
+
+namespace osu.Game.Graphics.Containers
+{
+    /// <summary>
+    /// Provides various data sources which allow for synchronising visuals to a known beat.
+    /// Primarily intended for use with <see cref="BeatSyncedContainer"/>.
+    /// </summary>
+    [Cached(typeof(IBeatSyncProvider))]
+    public interface IBeatSyncProvider
+    {
+        ControlPointInfo? ControlPoints { get; }
+
+        IClock? Clock { get; }
+
+        ChannelAmplitudes? Amplitudes { get; }
+    }
+}
diff --git a/osu.Game/OsuGameBase.cs b/osu.Game/OsuGameBase.cs
index 2e4758a134..52052efd5d 100644
--- a/osu.Game/OsuGameBase.cs
+++ b/osu.Game/OsuGameBase.cs
@@ -10,6 +10,7 @@ using System.Threading;
 using System.Threading.Tasks;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
+using osu.Framework.Audio.Track;
 using osu.Framework.Bindables;
 using osu.Framework.Development;
 using osu.Framework.Extensions;
@@ -21,12 +22,15 @@ using osu.Framework.Input;
 using osu.Framework.IO.Stores;
 using osu.Framework.Logging;
 using osu.Framework.Platform;
+using osu.Framework.Timing;
 using osu.Game.Audio;
 using osu.Game.Beatmaps;
+using osu.Game.Beatmaps.ControlPoints;
 using osu.Game.Beatmaps.Formats;
 using osu.Game.Configuration;
 using osu.Game.Database;
 using osu.Game.Graphics;
+using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Cursor;
 using osu.Game.Input;
 using osu.Game.Input.Bindings;
@@ -52,7 +56,7 @@ namespace osu.Game
     /// Unlike <see cref="OsuGame"/>, this class will not load any kind of UI, allowing it to be used
     /// for provide dependencies to test cases without interfering with them.
     /// </summary>
-    public partial class OsuGameBase : Framework.Game, ICanAcceptFiles
+    public partial class OsuGameBase : Framework.Game, ICanAcceptFiles, IBeatSyncProvider
     {
         public const string OSU_PROTOCOL = "osu://";
 
@@ -552,5 +556,9 @@ namespace osu.Game
             if (Host != null)
                 Host.ExceptionThrown -= onExceptionThrown;
         }
+
+        ControlPointInfo IBeatSyncProvider.ControlPoints => Beatmap.Value.Beatmap.ControlPointInfo;
+        IClock IBeatSyncProvider.Clock => Beatmap.Value.TrackLoaded ? Beatmap.Value.Track : (IClock)null;
+        ChannelAmplitudes? IBeatSyncProvider.Amplitudes => Beatmap.Value.TrackLoaded ? Beatmap.Value.Track.CurrentAmplitudes : (ChannelAmplitudes?)null;
     }
 }
diff --git a/osu.Game/Rulesets/Mods/MetronomeBeat.cs b/osu.Game/Rulesets/Mods/MetronomeBeat.cs
index c7a8b02130..149af1e30a 100644
--- a/osu.Game/Rulesets/Mods/MetronomeBeat.cs
+++ b/osu.Game/Rulesets/Mods/MetronomeBeat.cs
@@ -36,7 +36,7 @@ namespace osu.Game.Rulesets.Mods
             int timeSignature = timingPoint.TimeSignature.Numerator;
 
             // play metronome from one measure before the first object.
-            if (BeatSyncClock.CurrentTime < firstHitTime - timingPoint.BeatLength * timeSignature)
+            if (BeatSyncSource.Clock?.CurrentTime < firstHitTime - timingPoint.BeatLength * timeSignature)
                 return;
 
             sample.Frequency.Value = beatIndex % timeSignature == 0 ? 1 : 0.5f;
diff --git a/osu.Game/Screens/Edit/Editor.cs b/osu.Game/Screens/Edit/Editor.cs
index 3a2b195eed..a50a70374b 100644
--- a/osu.Game/Screens/Edit/Editor.cs
+++ b/osu.Game/Screens/Edit/Editor.cs
@@ -8,6 +8,7 @@ using System.Linq;
 using JetBrains.Annotations;
 using osu.Framework;
 using osu.Framework.Allocation;
+using osu.Framework.Audio.Track;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
@@ -19,11 +20,14 @@ using osu.Framework.Input.Events;
 using osu.Framework.Logging;
 using osu.Framework.Platform;
 using osu.Framework.Screens;
+using osu.Framework.Timing;
 using osu.Game.Audio;
 using osu.Game.Beatmaps;
+using osu.Game.Beatmaps.ControlPoints;
 using osu.Game.Configuration;
 using osu.Game.Database;
 using osu.Game.Graphics;
+using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Cursor;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Input.Bindings;
@@ -53,7 +57,7 @@ namespace osu.Game.Screens.Edit
 {
     [Cached(typeof(IBeatSnapProvider))]
     [Cached]
-    public class Editor : ScreenWithBeatmapBackground, IKeyBindingHandler<GlobalAction>, IKeyBindingHandler<PlatformAction>, IBeatSnapProvider, ISamplePlaybackDisabler
+    public class Editor : ScreenWithBeatmapBackground, IKeyBindingHandler<GlobalAction>, IKeyBindingHandler<PlatformAction>, IBeatSnapProvider, ISamplePlaybackDisabler, IBeatSyncProvider
     {
         public override float BackgroundParallaxAmount => 0.1f;
 
@@ -954,5 +958,9 @@ namespace osu.Game.Screens.Edit
         public double GetBeatLengthAtTime(double referenceTime) => editorBeatmap.GetBeatLengthAtTime(referenceTime);
 
         public int BeatDivisor => beatDivisor.Value;
+
+        ControlPointInfo IBeatSyncProvider.ControlPoints => editorBeatmap.ControlPointInfo;
+        IClock IBeatSyncProvider.Clock => clock;
+        ChannelAmplitudes? IBeatSyncProvider.Amplitudes => Beatmap.Value.TrackLoaded ? Beatmap.Value.Track.CurrentAmplitudes : (ChannelAmplitudes?)null;
     }
 }
diff --git a/osu.Game/Screens/Edit/Timing/MetronomeDisplay.cs b/osu.Game/Screens/Edit/Timing/MetronomeDisplay.cs
index b59865ac1a..7b0b8440e6 100644
--- a/osu.Game/Screens/Edit/Timing/MetronomeDisplay.cs
+++ b/osu.Game/Screens/Edit/Timing/MetronomeDisplay.cs
@@ -31,9 +31,6 @@ namespace osu.Game.Screens.Edit.Timing
         [Resolved]
         private OverlayColourProvider overlayColourProvider { get; set; }
 
-        [Resolved]
-        private EditorBeatmap editorBeatmap { get; set; }
-
         [BackgroundDependencyLoader]
         private void load()
         {
@@ -216,7 +213,10 @@ namespace osu.Game.Screens.Edit.Timing
         {
             base.Update();
 
-            timingPoint = editorBeatmap.ControlPointInfo.TimingPointAt(BeatSyncClock.CurrentTime);
+            if (BeatSyncSource.ControlPoints == null || BeatSyncSource.Clock == null)
+                return;
+
+            timingPoint = BeatSyncSource.ControlPoints.TimingPointAt(BeatSyncSource.Clock.CurrentTime);
 
             if (beatLength != timingPoint.BeatLength)
             {
@@ -230,7 +230,7 @@ namespace osu.Game.Screens.Edit.Timing
                 this.TransformBindableTo(interpolatedBpm, (int)Math.Round(timingPoint.BPM), 600, Easing.OutQuint);
             }
 
-            if (BeatSyncClock?.IsRunning != true && isSwinging)
+            if (BeatSyncSource.Clock?.IsRunning != true && isSwinging)
             {
                 swing.ClearTransforms(true);
 
@@ -258,7 +258,7 @@ namespace osu.Game.Screens.Edit.Timing
             float currentAngle = swing.Rotation;
             float targetAngle = currentAngle > 0 ? -angle : angle;
 
-            swing.RotateTo(targetAngle, beatLength, Easing.InOutQuad);
+            swing.RotateTo(targetAngle, beatLength, Easing.InOutSine);
 
             if (currentAngle != 0 && Math.Abs(currentAngle - targetAngle) > angle * 1.8f && isSwinging)
             {
diff --git a/osu.Game/Screens/Play/MasterGameplayClockContainer.cs b/osu.Game/Screens/Play/MasterGameplayClockContainer.cs
index ea43fb1546..4ca5541362 100644
--- a/osu.Game/Screens/Play/MasterGameplayClockContainer.cs
+++ b/osu.Game/Screens/Play/MasterGameplayClockContainer.cs
@@ -12,8 +12,10 @@ using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Timing;
 using osu.Game.Beatmaps;
+using osu.Game.Beatmaps.ControlPoints;
 using osu.Game.Configuration;
 using osu.Game.Database;
+using osu.Game.Graphics.Containers;
 
 namespace osu.Game.Screens.Play
 {
@@ -27,7 +29,7 @@ namespace osu.Game.Screens.Play
     /// <remarks>
     /// This is intended to be used as a single controller for gameplay, or as a reference source for other <see cref="GameplayClockContainer"/>s.
     /// </remarks>
-    public class MasterGameplayClockContainer : GameplayClockContainer
+    public class MasterGameplayClockContainer : GameplayClockContainer, IBeatSyncProvider
     {
         /// <summary>
         /// Duration before gameplay start time required before skip button displays.
@@ -250,6 +252,10 @@ namespace osu.Game.Screens.Play
             removeSourceClockAdjustments();
         }
 
+        ControlPointInfo IBeatSyncProvider.ControlPoints => beatmap.Beatmap.ControlPointInfo;
+        IClock IBeatSyncProvider.Clock => GameplayClock;
+        ChannelAmplitudes? IBeatSyncProvider.Amplitudes => beatmap.TrackLoaded ? beatmap.Track.CurrentAmplitudes : (ChannelAmplitudes?)null;
+
         private class HardwareCorrectionOffsetClock : FramedOffsetClock
         {
             private readonly BindableDouble pauseRateAdjust;
diff --git a/osu.Game/Screens/Play/Player.cs b/osu.Game/Screens/Play/Player.cs
index 51c1e6b43b..cbd9b03c32 100644
--- a/osu.Game/Screens/Play/Player.cs
+++ b/osu.Game/Screens/Play/Player.cs
@@ -8,6 +8,7 @@ using System.Threading.Tasks;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
 using osu.Framework.Audio.Sample;
+using osu.Framework.Audio.Track;
 using osu.Framework.Bindables;
 using osu.Framework.Extensions;
 using osu.Framework.Graphics;
@@ -16,8 +17,10 @@ using osu.Framework.Input.Events;
 using osu.Framework.Logging;
 using osu.Framework.Screens;
 using osu.Framework.Threading;
+using osu.Framework.Timing;
 using osu.Game.Audio;
 using osu.Game.Beatmaps;
+using osu.Game.Beatmaps.ControlPoints;
 using osu.Game.Configuration;
 using osu.Game.Graphics.Containers;
 using osu.Game.IO.Archives;
@@ -38,7 +41,7 @@ using osuTK.Graphics;
 namespace osu.Game.Screens.Play
 {
     [Cached]
-    public abstract class Player : ScreenWithBeatmapBackground, ISamplePlaybackDisabler, ILocalUserPlayInfo
+    public abstract class Player : ScreenWithBeatmapBackground, ISamplePlaybackDisabler, ILocalUserPlayInfo, IBeatSyncProvider
     {
         /// <summary>
         /// The delay upon completion of the beatmap before displaying the results screen.
@@ -1108,5 +1111,9 @@ namespace osu.Game.Screens.Play
         IBindable<bool> ISamplePlaybackDisabler.SamplePlaybackDisabled => samplePlaybackDisabled;
 
         IBindable<bool> ILocalUserPlayInfo.IsPlaying => LocalUserPlaying;
+
+        ControlPointInfo IBeatSyncProvider.ControlPoints => Beatmap.Value.Beatmap.ControlPointInfo;
+        IClock IBeatSyncProvider.Clock => GameplayClockContainer.GameplayClock;
+        ChannelAmplitudes? IBeatSyncProvider.Amplitudes => Beatmap.Value.TrackLoaded ? Beatmap.Value.Track.CurrentAmplitudes : (ChannelAmplitudes?)null;
     }
 }

From 3a7233bd6ed5e2a3784de1825ac58ea1ec7ae840 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 22 May 2022 22:49:24 +0900
Subject: [PATCH 4958/5547] Move interface to more appropriate namespace

---
 .../{Graphics/Containers => Beatmaps}/IBeatSyncProvider.cs     | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)
 rename osu.Game/{Graphics/Containers => Beatmaps}/IBeatSyncProvider.cs (91%)

diff --git a/osu.Game/Graphics/Containers/IBeatSyncProvider.cs b/osu.Game/Beatmaps/IBeatSyncProvider.cs
similarity index 91%
rename from osu.Game/Graphics/Containers/IBeatSyncProvider.cs
rename to osu.Game/Beatmaps/IBeatSyncProvider.cs
index d5be50297c..573f06ef9f 100644
--- a/osu.Game/Graphics/Containers/IBeatSyncProvider.cs
+++ b/osu.Game/Beatmaps/IBeatSyncProvider.cs
@@ -7,8 +7,9 @@ using osu.Framework.Allocation;
 using osu.Framework.Audio.Track;
 using osu.Framework.Timing;
 using osu.Game.Beatmaps.ControlPoints;
+using osu.Game.Graphics.Containers;
 
-namespace osu.Game.Graphics.Containers
+namespace osu.Game.Beatmaps
 {
     /// <summary>
     /// Provides various data sources which allow for synchronising visuals to a known beat.

From 007582afb9082782b1c18a61401a673198fe3370 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 22 May 2022 23:55:33 +0900
Subject: [PATCH 4959/5547] Remove unused usings resulting from namespace move

---
 osu.Game/OsuGameBase.cs                               | 1 -
 osu.Game/Screens/Edit/Editor.cs                       | 1 -
 osu.Game/Screens/Play/MasterGameplayClockContainer.cs | 1 -
 3 files changed, 3 deletions(-)

diff --git a/osu.Game/OsuGameBase.cs b/osu.Game/OsuGameBase.cs
index 52052efd5d..ed2bfbc6e3 100644
--- a/osu.Game/OsuGameBase.cs
+++ b/osu.Game/OsuGameBase.cs
@@ -30,7 +30,6 @@ using osu.Game.Beatmaps.Formats;
 using osu.Game.Configuration;
 using osu.Game.Database;
 using osu.Game.Graphics;
-using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Cursor;
 using osu.Game.Input;
 using osu.Game.Input.Bindings;
diff --git a/osu.Game/Screens/Edit/Editor.cs b/osu.Game/Screens/Edit/Editor.cs
index a50a70374b..0bb3f51903 100644
--- a/osu.Game/Screens/Edit/Editor.cs
+++ b/osu.Game/Screens/Edit/Editor.cs
@@ -27,7 +27,6 @@ using osu.Game.Beatmaps.ControlPoints;
 using osu.Game.Configuration;
 using osu.Game.Database;
 using osu.Game.Graphics;
-using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Cursor;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Input.Bindings;
diff --git a/osu.Game/Screens/Play/MasterGameplayClockContainer.cs b/osu.Game/Screens/Play/MasterGameplayClockContainer.cs
index 4ca5541362..d87d57ec49 100644
--- a/osu.Game/Screens/Play/MasterGameplayClockContainer.cs
+++ b/osu.Game/Screens/Play/MasterGameplayClockContainer.cs
@@ -15,7 +15,6 @@ using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.ControlPoints;
 using osu.Game.Configuration;
 using osu.Game.Database;
-using osu.Game.Graphics.Containers;
 
 namespace osu.Game.Screens.Play
 {

From c9ea87e6be1885fdb18bcc4e93bf21b5d0ad11e1 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 23 May 2022 00:03:42 +0900
Subject: [PATCH 4960/5547] Revert easing for now

---
 osu.Game/Screens/Edit/Timing/MetronomeDisplay.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Edit/Timing/MetronomeDisplay.cs b/osu.Game/Screens/Edit/Timing/MetronomeDisplay.cs
index 7b0b8440e6..4dd7a75d4a 100644
--- a/osu.Game/Screens/Edit/Timing/MetronomeDisplay.cs
+++ b/osu.Game/Screens/Edit/Timing/MetronomeDisplay.cs
@@ -258,7 +258,7 @@ namespace osu.Game.Screens.Edit.Timing
             float currentAngle = swing.Rotation;
             float targetAngle = currentAngle > 0 ? -angle : angle;
 
-            swing.RotateTo(targetAngle, beatLength, Easing.InOutSine);
+            swing.RotateTo(targetAngle, beatLength, Easing.InOutQuad);
 
             if (currentAngle != 0 && Math.Abs(currentAngle - targetAngle) > angle * 1.8f && isSwinging)
             {

From 26985ca8afa855658cd32c7eb0c5669c5b32687f Mon Sep 17 00:00:00 2001
From: apollo-dw <83023433+apollo-dw@users.noreply.github.com>
Date: Sun, 22 May 2022 16:26:22 +0100
Subject: [PATCH 4961/5547] Store hitobject history in the hitobject

---
 .../Difficulty/CatchDifficultyCalculator.cs   | 10 ++++++++-
 .../Preprocessing/CatchDifficultyHitObject.cs |  5 +++--
 .../Difficulty/ManiaDifficultyCalculator.cs   |  6 ++++-
 .../Preprocessing/ManiaDifficultyHitObject.cs |  5 +++--
 .../Difficulty/Skills/Strain.cs               |  6 ++---
 .../Difficulty/OsuDifficultyCalculator.cs     | 10 ++++-----
 .../Preprocessing/OsuDifficultyHitObject.cs   |  9 ++++----
 .../Difficulty/Skills/Aim.cs                  | 10 ++++-----
 .../Difficulty/Skills/Flashlight.cs           |  7 +++---
 .../Difficulty/Skills/Speed.cs                | 22 +++++++++----------
 .../Preprocessing/StaminaCheeseDetector.cs    | 15 +++++++------
 .../Preprocessing/TaikoDifficultyHitObject.cs | 15 +++++--------
 .../Difficulty/Skills/Rhythm.cs               |  2 +-
 .../Difficulty/Skills/Stamina.cs              |  4 ++--
 .../Difficulty/TaikoDifficultyCalculator.cs   |  4 ++--
 .../Preprocessing/DifficultyHitObject.cs      | 18 ++++++++++++++-
 osu.Game/Rulesets/Difficulty/Skills/Skill.cs  | 20 +----------------
 .../Difficulty/Skills/StrainDecaySkill.cs     |  2 +-
 .../Rulesets/Difficulty/Skills/StrainSkill.cs | 12 +++++-----
 19 files changed, 94 insertions(+), 88 deletions(-)

diff --git a/osu.Game.Rulesets.Catch/Difficulty/CatchDifficultyCalculator.cs b/osu.Game.Rulesets.Catch/Difficulty/CatchDifficultyCalculator.cs
index 0054047573..3826e4cec4 100644
--- a/osu.Game.Rulesets.Catch/Difficulty/CatchDifficultyCalculator.cs
+++ b/osu.Game.Rulesets.Catch/Difficulty/CatchDifficultyCalculator.cs
@@ -49,6 +49,9 @@ namespace osu.Game.Rulesets.Catch.Difficulty
         {
             CatchHitObject lastObject = null;
 
+            List<DifficultyHitObject> objects = new List<DifficultyHitObject>();
+            int index = 0;
+
             // In 2B beatmaps, it is possible that a normal Fruit is placed in the middle of a JuiceStream.
             foreach (var hitObject in beatmap.HitObjects
                                              .SelectMany(obj => obj is JuiceStream stream ? stream.NestedHitObjects.AsEnumerable() : new[] { obj })
@@ -60,10 +63,15 @@ namespace osu.Game.Rulesets.Catch.Difficulty
                     continue;
 
                 if (lastObject != null)
-                    yield return new CatchDifficultyHitObject(hitObject, lastObject, clockRate, halfCatcherWidth);
+                {
+                    objects.Add(new CatchDifficultyHitObject(hitObject, lastObject, clockRate, halfCatcherWidth, objects, index));
+                    index++;
+                }
 
                 lastObject = hitObject;
             }
+
+            return objects;
         }
 
         protected override Skill[] CreateSkills(IBeatmap beatmap, Mod[] mods, double clockRate)
diff --git a/osu.Game.Rulesets.Catch/Difficulty/Preprocessing/CatchDifficultyHitObject.cs b/osu.Game.Rulesets.Catch/Difficulty/Preprocessing/CatchDifficultyHitObject.cs
index b22ec93b43..8c229cf6c5 100644
--- a/osu.Game.Rulesets.Catch/Difficulty/Preprocessing/CatchDifficultyHitObject.cs
+++ b/osu.Game.Rulesets.Catch/Difficulty/Preprocessing/CatchDifficultyHitObject.cs
@@ -2,6 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
+using System.Collections.Generic;
 using osu.Game.Rulesets.Catch.Objects;
 using osu.Game.Rulesets.Difficulty.Preprocessing;
 using osu.Game.Rulesets.Objects;
@@ -24,8 +25,8 @@ namespace osu.Game.Rulesets.Catch.Difficulty.Preprocessing
         /// </summary>
         public readonly double StrainTime;
 
-        public CatchDifficultyHitObject(HitObject hitObject, HitObject lastObject, double clockRate, float halfCatcherWidth)
-            : base(hitObject, lastObject, clockRate)
+        public CatchDifficultyHitObject(HitObject hitObject, HitObject lastObject, double clockRate, float halfCatcherWidth, List<DifficultyHitObject> objects, int position)
+            : base(hitObject, lastObject, clockRate, objects, position)
         {
             // We will scale everything by this factor, so we can assume a uniform CircleSize among beatmaps.
             float scalingFactor = normalized_hitobject_radius / halfCatcherWidth;
diff --git a/osu.Game.Rulesets.Mania/Difficulty/ManiaDifficultyCalculator.cs b/osu.Game.Rulesets.Mania/Difficulty/ManiaDifficultyCalculator.cs
index b17aa7fc4d..7ce73c98d1 100644
--- a/osu.Game.Rulesets.Mania/Difficulty/ManiaDifficultyCalculator.cs
+++ b/osu.Game.Rulesets.Mania/Difficulty/ManiaDifficultyCalculator.cs
@@ -62,8 +62,12 @@ namespace osu.Game.Rulesets.Mania.Difficulty
 
             LegacySortHelper<HitObject>.Sort(sortedObjects, Comparer<HitObject>.Create((a, b) => (int)Math.Round(a.StartTime) - (int)Math.Round(b.StartTime)));
 
+            List<DifficultyHitObject> objects = new List<DifficultyHitObject>();
+
             for (int i = 1; i < sortedObjects.Length; i++)
-                yield return new ManiaDifficultyHitObject(sortedObjects[i], sortedObjects[i - 1], clockRate);
+                objects.Add(new ManiaDifficultyHitObject(sortedObjects[i], sortedObjects[i - 1], clockRate, objects, i - 1));
+
+            return objects;
         }
 
         // Sorting is done in CreateDifficultyHitObjects, since the full list of hitobjects is required.
diff --git a/osu.Game.Rulesets.Mania/Difficulty/Preprocessing/ManiaDifficultyHitObject.cs b/osu.Game.Rulesets.Mania/Difficulty/Preprocessing/ManiaDifficultyHitObject.cs
index 29ba934e9f..5c9b3b9b54 100644
--- a/osu.Game.Rulesets.Mania/Difficulty/Preprocessing/ManiaDifficultyHitObject.cs
+++ b/osu.Game.Rulesets.Mania/Difficulty/Preprocessing/ManiaDifficultyHitObject.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.Game.Rulesets.Difficulty.Preprocessing;
 using osu.Game.Rulesets.Mania.Objects;
 using osu.Game.Rulesets.Objects;
@@ -11,8 +12,8 @@ namespace osu.Game.Rulesets.Mania.Difficulty.Preprocessing
     {
         public new ManiaHitObject BaseObject => (ManiaHitObject)base.BaseObject;
 
-        public ManiaDifficultyHitObject(HitObject hitObject, HitObject lastObject, double clockRate)
-            : base(hitObject, lastObject, clockRate)
+        public ManiaDifficultyHitObject(HitObject hitObject, HitObject lastObject, double clockRate, List<DifficultyHitObject> objects, int position)
+            : base(hitObject, lastObject, clockRate, objects, position)
         {
         }
     }
diff --git a/osu.Game.Rulesets.Mania/Difficulty/Skills/Strain.cs b/osu.Game.Rulesets.Mania/Difficulty/Skills/Strain.cs
index 31550a8105..626f1bebbd 100644
--- a/osu.Game.Rulesets.Mania/Difficulty/Skills/Strain.cs
+++ b/osu.Game.Rulesets.Mania/Difficulty/Skills/Strain.cs
@@ -84,9 +84,9 @@ namespace osu.Game.Rulesets.Mania.Difficulty.Skills
             return individualStrain + overallStrain - CurrentStrain;
         }
 
-        protected override double CalculateInitialStrain(double offset)
-            => applyDecay(individualStrain, offset - Previous[0].StartTime, individual_decay_base)
-               + applyDecay(overallStrain, offset - Previous[0].StartTime, overall_decay_base);
+        protected override double CalculateInitialStrain(double offset, DifficultyHitObject current)
+            => applyDecay(individualStrain, offset - current.Previous(0).StartTime, individual_decay_base)
+               + applyDecay(overallStrain, offset - current.Previous(0).StartTime, overall_decay_base);
 
         private double applyDecay(double value, double deltaTime, double decayBase)
             => value * Math.Pow(decayBase, deltaTime / 1000);
diff --git a/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs b/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs
index 4eb5c79808..3b21ab49c2 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs
@@ -87,16 +87,14 @@ namespace osu.Game.Rulesets.Osu.Difficulty
 
         protected override IEnumerable<DifficultyHitObject> CreateDifficultyHitObjects(IBeatmap beatmap, double clockRate)
         {
+            List<DifficultyHitObject> objects = new List<DifficultyHitObject>();
+
             // The first jump is formed by the first two hitobjects of the map.
             // If the map has less than two OsuHitObjects, the enumerator will not return anything.
             for (int i = 1; i < beatmap.HitObjects.Count; i++)
-            {
-                var lastLast = i > 1 ? beatmap.HitObjects[i - 2] : null;
-                var last = beatmap.HitObjects[i - 1];
-                var current = beatmap.HitObjects[i];
+                objects.Add(new OsuDifficultyHitObject(beatmap.HitObjects[i], beatmap.HitObjects[i - 1], clockRate, objects, i - 1));
 
-                yield return new OsuDifficultyHitObject(current, lastLast, last, clockRate);
-            }
+            return objects;
         }
 
         protected override Skill[] CreateSkills(IBeatmap beatmap, Mod[] mods, double clockRate)
diff --git a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
index cf4802d282..0598cbe4c9 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
@@ -2,6 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
+using System.Collections.Generic;
 using osu.Game.Rulesets.Difficulty.Preprocessing;
 using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Osu.Mods;
@@ -12,7 +13,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
 {
     public class OsuDifficultyHitObject : DifficultyHitObject
     {
-        private const int normalised_radius = 50; // Change radius to 50 to make 100 the diameter. Easier for mental maths.
+        private const int normalised_radius = 50;
         private const int min_delta_time = 25;
         private const float maximum_slider_radius = normalised_radius * 2.4f;
         private const float assumed_slider_radius = normalised_radius * 1.8f;
@@ -74,10 +75,10 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
         private readonly OsuHitObject lastLastObject;
         private readonly OsuHitObject lastObject;
 
-        public OsuDifficultyHitObject(HitObject hitObject, HitObject lastLastObject, HitObject lastObject, double clockRate)
-            : base(hitObject, lastObject, clockRate)
+        public OsuDifficultyHitObject(HitObject hitObject, HitObject lastObject, double clockRate, List<DifficultyHitObject> objects, int position)
+            : base(hitObject, lastObject, clockRate, objects, position)
         {
-            this.lastLastObject = (OsuHitObject)lastLastObject;
+            lastLastObject = position > 1 ? (OsuHitObject)Previous(1).BaseObject : null;
             this.lastObject = (OsuHitObject)lastObject;
 
             // Capped to 25ms to prevent difficulty calculation breaking from simultaneous objects.
diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
index a6301aed6d..e3ec997740 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
@@ -22,8 +22,6 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
 
         private readonly bool withSliders;
 
-        protected override int HistoryLength => 2;
-
         private const double wide_angle_multiplier = 1.5;
         private const double acute_angle_multiplier = 2.0;
         private const double slider_multiplier = 1.5;
@@ -36,12 +34,12 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
 
         private double strainValueOf(DifficultyHitObject current)
         {
-            if (current.BaseObject is Spinner || Previous.Count <= 1 || Previous[0].BaseObject is Spinner)
+            if (current.BaseObject is Spinner || current.Position <= 1 || current.Previous(0).BaseObject is Spinner)
                 return 0;
 
             var osuCurrObj = (OsuDifficultyHitObject)current;
-            var osuLastObj = (OsuDifficultyHitObject)Previous[0];
-            var osuLastLastObj = (OsuDifficultyHitObject)Previous[1];
+            var osuLastObj = (OsuDifficultyHitObject)current.Previous(0);
+            var osuLastLastObj = (OsuDifficultyHitObject)current.Previous(1);
 
             // Calculate the velocity to the current hitobject, which starts with a base distance / time assuming the last object is a hitcircle.
             double currVelocity = osuCurrObj.LazyJumpDistance / osuCurrObj.StrainTime;
@@ -152,7 +150,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
 
         private double strainDecay(double ms) => Math.Pow(strainDecayBase, ms / 1000);
 
-        protected override double CalculateInitialStrain(double time) => currentStrain * strainDecay(time - Previous[0].StartTime);
+        protected override double CalculateInitialStrain(double time, DifficultyHitObject current) => currentStrain * strainDecay(time - current.Previous(0).StartTime);
 
         protected override double StrainValueAt(DifficultyHitObject current)
         {
diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
index d93007fae5..75796a5993 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
@@ -25,7 +25,6 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
         private double skillMultiplier => 0.05;
         private double strainDecayBase => 0.15;
         protected override double DecayWeight => 1.0;
-        protected override int HistoryLength => 10; // Look back for 10 notes is added for the sake of flashlight calculations.
 
         private readonly bool hidden;
 
@@ -51,9 +50,9 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
             OsuDifficultyHitObject lastObj = osuCurrent;
 
             // This is iterating backwards in time from the current object.
-            for (int i = 0; i < Previous.Count; i++)
+            for (int i = 0; i < Math.Min(current.Position, 10); i++)
             {
-                var currentObj = (OsuDifficultyHitObject)Previous[i];
+                var currentObj = (OsuDifficultyHitObject)current.Previous(i);
                 var currentHitObject = (OsuHitObject)(currentObj.BaseObject);
 
                 if (!(currentObj.BaseObject is Spinner))
@@ -89,7 +88,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
 
         private double strainDecay(double ms) => Math.Pow(strainDecayBase, ms / 1000);
 
-        protected override double CalculateInitialStrain(double time) => currentStrain * strainDecay(time - Previous[0].StartTime);
+        protected override double CalculateInitialStrain(double time, DifficultyHitObject current) => currentStrain * strainDecay(time - current.Previous(0).StartTime);
 
         protected override double StrainValueAt(DifficultyHitObject current)
         {
diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Speed.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Speed.cs
index 06d1ef7346..f8905664f4 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Speed.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Speed.cs
@@ -29,8 +29,6 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
 
         protected override int ReducedSectionCount => 5;
         protected override double DifficultyMultiplier => 1.04;
-        protected override int HistoryLength => 32;
-
         private readonly double greatWindow;
 
         public Speed(Mod[] mods, double hitWindowGreat)
@@ -55,20 +53,22 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
 
             bool firstDeltaSwitch = false;
 
+            int historicalNoteCount = Math.Min(current.Position, 32);
+
             int rhythmStart = 0;
 
-            while (rhythmStart < Previous.Count - 2 && current.StartTime - Previous[rhythmStart].StartTime < history_time_max)
+            while (rhythmStart < historicalNoteCount - 2 && current.StartTime - current.Previous(rhythmStart).StartTime < history_time_max)
                 rhythmStart++;
 
             for (int i = rhythmStart; i > 0; i--)
             {
-                OsuDifficultyHitObject currObj = (OsuDifficultyHitObject)Previous[i - 1];
-                OsuDifficultyHitObject prevObj = (OsuDifficultyHitObject)Previous[i];
-                OsuDifficultyHitObject lastObj = (OsuDifficultyHitObject)Previous[i + 1];
+                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
 
-                currHistoricalDecay = Math.Min((double)(Previous.Count - i) / Previous.Count, currHistoricalDecay); // either we're limited by time or limited by object count.
+                currHistoricalDecay = Math.Min((double)(historicalNoteCount - i) / historicalNoteCount, currHistoricalDecay); // either we're limited by time or limited by object count.
 
                 double currDelta = currObj.StrainTime;
                 double prevDelta = prevObj.StrainTime;
@@ -90,10 +90,10 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
                     }
                     else
                     {
-                        if (Previous[i - 1].BaseObject is Slider) // bpm change is into slider, this is easy acc window
+                        if (current.Previous(i - 1).BaseObject is Slider) // bpm change is into slider, this is easy acc window
                             effectiveRatio *= 0.125;
 
-                        if (Previous[i].BaseObject is Slider) // bpm change was from a slider, this is easier typically than circle -> circle
+                        if (current.Previous(i).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)
@@ -136,7 +136,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
 
             // derive strainTime for calculation
             var osuCurrObj = (OsuDifficultyHitObject)current;
-            var osuPrevObj = Previous.Count > 0 ? (OsuDifficultyHitObject)Previous[0] : null;
+            var osuPrevObj = current.Position > 0 ? (OsuDifficultyHitObject)current.Previous(0) : null;
 
             double strainTime = osuCurrObj.StrainTime;
             double greatWindowFull = greatWindow * 2;
@@ -164,7 +164,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
 
         private double strainDecay(double ms) => Math.Pow(strainDecayBase, ms / 1000);
 
-        protected override double CalculateInitialStrain(double time) => (currentStrain * currentRhythm) * strainDecay(time - Previous[0].StartTime);
+        protected override double CalculateInitialStrain(double time, DifficultyHitObject current) => (currentStrain * currentRhythm) * strainDecay(time - current.Previous(0).StartTime);
 
         protected override double StrainValueAt(DifficultyHitObject current)
         {
diff --git a/osu.Game.Rulesets.Taiko/Difficulty/Preprocessing/StaminaCheeseDetector.cs b/osu.Game.Rulesets.Taiko/Difficulty/Preprocessing/StaminaCheeseDetector.cs
index 3b1a9ad777..586a7fb6a7 100644
--- a/osu.Game.Rulesets.Taiko/Difficulty/Preprocessing/StaminaCheeseDetector.cs
+++ b/osu.Game.Rulesets.Taiko/Difficulty/Preprocessing/StaminaCheeseDetector.cs
@@ -3,6 +3,7 @@
 
 using System;
 using System.Collections.Generic;
+using osu.Game.Rulesets.Difficulty.Preprocessing;
 using osu.Game.Rulesets.Difficulty.Utils;
 using osu.Game.Rulesets.Taiko.Objects;
 
@@ -34,9 +35,9 @@ namespace osu.Game.Rulesets.Taiko.Difficulty.Preprocessing
         /// <summary>
         /// The list of all <see cref="TaikoDifficultyHitObject"/>s in the map.
         /// </summary>
-        private readonly List<TaikoDifficultyHitObject> hitObjects;
+        private readonly List<DifficultyHitObject> hitObjects;
 
-        public StaminaCheeseDetector(List<TaikoDifficultyHitObject> hitObjects)
+        public StaminaCheeseDetector(List<DifficultyHitObject> hitObjects)
         {
             this.hitObjects = hitObjects;
         }
@@ -62,7 +63,7 @@ namespace osu.Game.Rulesets.Taiko.Difficulty.Preprocessing
         /// <param name="patternLength">The length of a single repeating pattern to consider (triplets/quadruplets).</param>
         private void findRolls(int patternLength)
         {
-            var history = new LimitedCapacityQueue<TaikoDifficultyHitObject>(2 * patternLength);
+            var history = new LimitedCapacityQueue<DifficultyHitObject>(2 * patternLength);
 
             // for convenience, we're tracking the index of the item *before* our suspected repeat's start,
             // as that index can be simply subtracted from the current index to get the number of elements in between
@@ -97,11 +98,11 @@ namespace osu.Game.Rulesets.Taiko.Difficulty.Preprocessing
         /// <summary>
         /// Determines whether the objects stored in <paramref name="history"/> contain a repetition of a pattern of length <paramref name="patternLength"/>.
         /// </summary>
-        private static bool containsPatternRepeat(LimitedCapacityQueue<TaikoDifficultyHitObject> history, int patternLength)
+        private static bool containsPatternRepeat(LimitedCapacityQueue<DifficultyHitObject> history, int patternLength)
         {
             for (int j = 0; j < patternLength; j++)
             {
-                if (history[j].HitType != history[j + patternLength].HitType)
+                if (((TaikoDifficultyHitObject)history[j]).HitType != ((TaikoDifficultyHitObject)history[j + patternLength]).HitType)
                     return false;
             }
 
@@ -120,7 +121,7 @@ namespace osu.Game.Rulesets.Taiko.Difficulty.Preprocessing
 
             for (int i = parity; i < hitObjects.Count; i += 2)
             {
-                if (hitObjects[i].HitType == type)
+                if (((TaikoDifficultyHitObject)hitObjects[i]).HitType == type)
                     tlLength += 2;
                 else
                     tlLength = -2;
@@ -139,7 +140,7 @@ namespace osu.Game.Rulesets.Taiko.Difficulty.Preprocessing
         private void markObjectsAsCheese(int start, int end)
         {
             for (int i = start; i <= end; i++)
-                hitObjects[i].StaminaCheese = true;
+                ((TaikoDifficultyHitObject)hitObjects[i]).StaminaCheese = true;
         }
     }
 }
diff --git a/osu.Game.Rulesets.Taiko/Difficulty/Preprocessing/TaikoDifficultyHitObject.cs b/osu.Game.Rulesets.Taiko/Difficulty/Preprocessing/TaikoDifficultyHitObject.cs
index ae33c184d0..79e760d149 100644
--- a/osu.Game.Rulesets.Taiko/Difficulty/Preprocessing/TaikoDifficultyHitObject.cs
+++ b/osu.Game.Rulesets.Taiko/Difficulty/Preprocessing/TaikoDifficultyHitObject.cs
@@ -2,6 +2,7 @@
 // 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.Preprocessing;
 using osu.Game.Rulesets.Objects;
@@ -24,11 +25,6 @@ namespace osu.Game.Rulesets.Taiko.Difficulty.Preprocessing
         /// </summary>
         public readonly HitType? HitType;
 
-        /// <summary>
-        /// The index of the object in the beatmap.
-        /// </summary>
-        public readonly int ObjectIndex;
-
         /// <summary>
         /// Whether the object should carry a penalty due to being hittable using special techniques
         /// making it easier to do so.
@@ -42,16 +38,15 @@ namespace osu.Game.Rulesets.Taiko.Difficulty.Preprocessing
         /// <param name="lastObject">The gameplay <see cref="HitObject"/> preceding <paramref name="hitObject"/>.</param>
         /// <param name="lastLastObject">The gameplay <see cref="HitObject"/> preceding <paramref name="lastObject"/>.</param>
         /// <param name="clockRate">The rate of the gameplay clock. Modified by speed-changing mods.</param>
-        /// <param name="objectIndex">The index of the object in the beatmap.</param>
-        public TaikoDifficultyHitObject(HitObject hitObject, HitObject lastObject, HitObject lastLastObject, double clockRate, int objectIndex)
-            : base(hitObject, lastObject, clockRate)
+        /// <param name="objects">The list of <see cref="DifficultyHitObject"/>s in the current beatmap.</param>
+        /// <param name="position">The index of the object in the beatmap.</param>
+        public TaikoDifficultyHitObject(HitObject hitObject, HitObject lastObject, HitObject lastLastObject, double clockRate, List<DifficultyHitObject> objects, int position)
+            : base(hitObject, lastObject, clockRate, objects, position)
         {
             var currentHit = hitObject as Hit;
 
             Rhythm = getClosestRhythm(lastObject, lastLastObject, clockRate);
             HitType = currentHit?.Type;
-
-            ObjectIndex = objectIndex;
         }
 
         /// <summary>
diff --git a/osu.Game.Rulesets.Taiko/Difficulty/Skills/Rhythm.cs b/osu.Game.Rulesets.Taiko/Difficulty/Skills/Rhythm.cs
index 973e55f4b4..9150b6980b 100644
--- a/osu.Game.Rulesets.Taiko/Difficulty/Skills/Rhythm.cs
+++ b/osu.Game.Rulesets.Taiko/Difficulty/Skills/Rhythm.cs
@@ -106,7 +106,7 @@ namespace osu.Game.Rulesets.Taiko.Difficulty.Skills
                     if (!samePattern(start, mostRecentPatternsToCompare))
                         continue;
 
-                    int notesSince = hitObject.ObjectIndex - rhythmHistory[start].ObjectIndex;
+                    int notesSince = hitObject.Position - rhythmHistory[start].Position;
                     penalty *= repetitionPenalty(notesSince);
                     break;
                 }
diff --git a/osu.Game.Rulesets.Taiko/Difficulty/Skills/Stamina.cs b/osu.Game.Rulesets.Taiko/Difficulty/Skills/Stamina.cs
index 54cf233d69..6922f57060 100644
--- a/osu.Game.Rulesets.Taiko/Difficulty/Skills/Stamina.cs
+++ b/osu.Game.Rulesets.Taiko/Difficulty/Skills/Stamina.cs
@@ -66,11 +66,11 @@ namespace osu.Game.Rulesets.Taiko.Difficulty.Skills
 
             TaikoDifficultyHitObject hitObject = (TaikoDifficultyHitObject)current;
 
-            if (hitObject.ObjectIndex % 2 == hand)
+            if (hitObject.Position % 2 == hand)
             {
                 double objectStrain = 1;
 
-                if (hitObject.ObjectIndex == 1)
+                if (hitObject.Position == 1)
                     return 1;
 
                 notePairDurationHistory.Enqueue(hitObject.DeltaTime + offhandObjectDuration);
diff --git a/osu.Game.Rulesets.Taiko/Difficulty/TaikoDifficultyCalculator.cs b/osu.Game.Rulesets.Taiko/Difficulty/TaikoDifficultyCalculator.cs
index a9d512f076..f14765a925 100644
--- a/osu.Game.Rulesets.Taiko/Difficulty/TaikoDifficultyCalculator.cs
+++ b/osu.Game.Rulesets.Taiko/Difficulty/TaikoDifficultyCalculator.cs
@@ -47,13 +47,13 @@ namespace osu.Game.Rulesets.Taiko.Difficulty
 
         protected override IEnumerable<DifficultyHitObject> CreateDifficultyHitObjects(IBeatmap beatmap, double clockRate)
         {
-            List<TaikoDifficultyHitObject> taikoDifficultyHitObjects = new List<TaikoDifficultyHitObject>();
+            List<DifficultyHitObject> taikoDifficultyHitObjects = new List<DifficultyHitObject>();
 
             for (int i = 2; i < beatmap.HitObjects.Count; i++)
             {
                 taikoDifficultyHitObjects.Add(
                     new TaikoDifficultyHitObject(
-                        beatmap.HitObjects[i], beatmap.HitObjects[i - 1], beatmap.HitObjects[i - 2], clockRate, i
+                        beatmap.HitObjects[i], beatmap.HitObjects[i - 1], beatmap.HitObjects[i - 2], clockRate, taikoDifficultyHitObjects, i - 2
                     )
                 );
             }
diff --git a/osu.Game/Rulesets/Difficulty/Preprocessing/DifficultyHitObject.cs b/osu.Game/Rulesets/Difficulty/Preprocessing/DifficultyHitObject.cs
index 5edfb2207b..4f001a520c 100644
--- a/osu.Game/Rulesets/Difficulty/Preprocessing/DifficultyHitObject.cs
+++ b/osu.Game/Rulesets/Difficulty/Preprocessing/DifficultyHitObject.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.Game.Rulesets.Objects;
 
 namespace osu.Game.Rulesets.Difficulty.Preprocessing
@@ -10,6 +11,13 @@ namespace osu.Game.Rulesets.Difficulty.Preprocessing
     /// </summary>
     public class DifficultyHitObject
     {
+        private readonly List<DifficultyHitObject> difficultyHitObjects;
+
+        /// <summary>
+        /// The position of this <see cref="DifficultyHitObject"/> in the <see cref="difficultyHitObjects"/> list.
+        /// </summary>
+        public int Position;
+
         /// <summary>
         /// The <see cref="HitObject"/> this <see cref="DifficultyHitObject"/> wraps.
         /// </summary>
@@ -41,13 +49,21 @@ namespace osu.Game.Rulesets.Difficulty.Preprocessing
         /// <param name="hitObject">The <see cref="HitObject"/> which this <see cref="DifficultyHitObject"/> wraps.</param>
         /// <param name="lastObject">The last <see cref="HitObject"/> which occurs before <paramref name="hitObject"/> in the beatmap.</param>
         /// <param name="clockRate">The rate at which the gameplay clock is run at.</param>
-        public DifficultyHitObject(HitObject hitObject, HitObject lastObject, double clockRate)
+        /// <param name="objects">The list of <see cref="DifficultyHitObject"/>s in the current beatmap.</param>
+        /// <param name="position">The position of this <see cref="DifficultyHitObject"/> in the <see cref="difficultyHitObjects"/> list.</param>
+        public DifficultyHitObject(HitObject hitObject, HitObject lastObject, double clockRate, List<DifficultyHitObject> objects, int position)
         {
+            difficultyHitObjects = objects;
+            Position = position;
             BaseObject = hitObject;
             LastObject = lastObject;
             DeltaTime = (hitObject.StartTime - lastObject.StartTime) / clockRate;
             StartTime = hitObject.StartTime / clockRate;
             EndTime = hitObject.GetEndTime() / clockRate;
         }
+
+        public DifficultyHitObject Previous(int backwardsIndex) => difficultyHitObjects[Position - (backwardsIndex + 1)];
+
+        public DifficultyHitObject Next(int forwardsIndex) => difficultyHitObjects[Position + (forwardsIndex + 1)];
     }
 }
diff --git a/osu.Game/Rulesets/Difficulty/Skills/Skill.cs b/osu.Game/Rulesets/Difficulty/Skills/Skill.cs
index b5c94ad806..f23f3b5f2a 100644
--- a/osu.Game/Rulesets/Difficulty/Skills/Skill.cs
+++ b/osu.Game/Rulesets/Difficulty/Skills/Skill.cs
@@ -3,7 +3,6 @@
 
 using System.Collections.Generic;
 using osu.Game.Rulesets.Difficulty.Preprocessing;
-using osu.Game.Rulesets.Difficulty.Utils;
 using osu.Game.Rulesets.Mods;
 
 namespace osu.Game.Rulesets.Difficulty.Skills
@@ -12,21 +11,10 @@ namespace osu.Game.Rulesets.Difficulty.Skills
     /// A bare minimal abstract skill for fully custom skill implementations.
     /// </summary>
     /// <remarks>
-    /// This class should be considered a "processing" class and not persisted, as it keeps references to
-    /// gameplay objects after processing is run (see <see cref="Previous"/>).
+    /// This class should be considered a "processing" class and not persisted.
     /// </remarks>
     public abstract class Skill
     {
-        /// <summary>
-        /// <see cref="DifficultyHitObject"/>s that were processed previously. They can affect the strain values of the following objects.
-        /// </summary>
-        protected readonly ReverseQueue<DifficultyHitObject> Previous;
-
-        /// <summary>
-        /// Number of previous <see cref="DifficultyHitObject"/>s to keep inside the <see cref="Previous"/> queue.
-        /// </summary>
-        protected virtual int HistoryLength => 1;
-
         /// <summary>
         /// Mods for use in skill calculations.
         /// </summary>
@@ -37,17 +25,11 @@ namespace osu.Game.Rulesets.Difficulty.Skills
         protected Skill(Mod[] mods)
         {
             this.mods = mods;
-            Previous = new ReverseQueue<DifficultyHitObject>(HistoryLength + 1);
         }
 
         internal void ProcessInternal(DifficultyHitObject current)
         {
-            while (Previous.Count > HistoryLength)
-                Previous.Dequeue();
-
             Process(current);
-
-            Previous.Enqueue(current);
         }
 
         /// <summary>
diff --git a/osu.Game/Rulesets/Difficulty/Skills/StrainDecaySkill.cs b/osu.Game/Rulesets/Difficulty/Skills/StrainDecaySkill.cs
index d8babf2f32..3f3d57938b 100644
--- a/osu.Game/Rulesets/Difficulty/Skills/StrainDecaySkill.cs
+++ b/osu.Game/Rulesets/Difficulty/Skills/StrainDecaySkill.cs
@@ -34,7 +34,7 @@ namespace osu.Game.Rulesets.Difficulty.Skills
         {
         }
 
-        protected override double CalculateInitialStrain(double time) => CurrentStrain * strainDecay(time - Previous[0].StartTime);
+        protected override double CalculateInitialStrain(double time, DifficultyHitObject current) => CurrentStrain * strainDecay(time - current.Previous(0).StartTime);
 
         protected override double StrainValueAt(DifficultyHitObject current)
         {
diff --git a/osu.Game/Rulesets/Difficulty/Skills/StrainSkill.cs b/osu.Game/Rulesets/Difficulty/Skills/StrainSkill.cs
index 97266562e4..eb3203e9ec 100644
--- a/osu.Game/Rulesets/Difficulty/Skills/StrainSkill.cs
+++ b/osu.Game/Rulesets/Difficulty/Skills/StrainSkill.cs
@@ -47,13 +47,13 @@ namespace osu.Game.Rulesets.Difficulty.Skills
         protected sealed override void Process(DifficultyHitObject current)
         {
             // The first object doesn't generate a strain, so we begin with an incremented section end
-            if (Previous.Count == 0)
+            if (current.Position == 0)
                 currentSectionEnd = Math.Ceiling(current.StartTime / SectionLength) * SectionLength;
 
             while (current.StartTime > currentSectionEnd)
             {
                 saveCurrentPeak();
-                startNewSectionFrom(currentSectionEnd);
+                startNewSectionFrom(currentSectionEnd, current);
                 currentSectionEnd += SectionLength;
             }
 
@@ -72,19 +72,21 @@ namespace osu.Game.Rulesets.Difficulty.Skills
         /// Sets the initial strain level for a new section.
         /// </summary>
         /// <param name="time">The beginning of the new section in milliseconds.</param>
-        private void startNewSectionFrom(double time)
+        /// <param name="current">The current hit object.</param>
+        private void startNewSectionFrom(double time, DifficultyHitObject current)
         {
             // The maximum strain of the new section is not zero by default
             // This means we need to capture the strain level at the beginning of the new section, and use that as the initial peak level.
-            currentSectionPeak = CalculateInitialStrain(time);
+            currentSectionPeak = CalculateInitialStrain(time, current);
         }
 
         /// <summary>
         /// Retrieves the peak strain at a point in time.
         /// </summary>
         /// <param name="time">The time to retrieve the peak strain at.</param>
+        /// <param name="current">The current hit object.</param>
         /// <returns>The peak strain.</returns>
-        protected abstract double CalculateInitialStrain(double time);
+        protected abstract double CalculateInitialStrain(double time, DifficultyHitObject current);
 
         /// <summary>
         /// Returns a live enumerable of the peak strains for each <see cref="SectionLength"/> section of the beatmap,

From 267bef959fd7049dcf80557196cd211e3f81686f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 23 May 2022 02:00:04 +0900
Subject: [PATCH 4962/5547] Remove unnecessary cache type specification
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/Beatmaps/IBeatSyncProvider.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Beatmaps/IBeatSyncProvider.cs b/osu.Game/Beatmaps/IBeatSyncProvider.cs
index 573f06ef9f..cc1cfc3cb5 100644
--- a/osu.Game/Beatmaps/IBeatSyncProvider.cs
+++ b/osu.Game/Beatmaps/IBeatSyncProvider.cs
@@ -15,7 +15,7 @@ namespace osu.Game.Beatmaps
     /// Provides various data sources which allow for synchronising visuals to a known beat.
     /// Primarily intended for use with <see cref="BeatSyncedContainer"/>.
     /// </summary>
-    [Cached(typeof(IBeatSyncProvider))]
+    [Cached]
     public interface IBeatSyncProvider
     {
         ControlPointInfo? ControlPoints { get; }

From 9c3d0dafbdba852857197bf13dbc2879328dceb3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 23 May 2022 02:00:20 +0900
Subject: [PATCH 4963/5547] Remove implementation at `Player` level

Turns out this isn't required in the end due to implementation at
`MasterGameplayClockContainer`.
---
 osu.Game/Screens/Play/Player.cs | 9 +--------
 1 file changed, 1 insertion(+), 8 deletions(-)

diff --git a/osu.Game/Screens/Play/Player.cs b/osu.Game/Screens/Play/Player.cs
index cbd9b03c32..51c1e6b43b 100644
--- a/osu.Game/Screens/Play/Player.cs
+++ b/osu.Game/Screens/Play/Player.cs
@@ -8,7 +8,6 @@ using System.Threading.Tasks;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
 using osu.Framework.Audio.Sample;
-using osu.Framework.Audio.Track;
 using osu.Framework.Bindables;
 using osu.Framework.Extensions;
 using osu.Framework.Graphics;
@@ -17,10 +16,8 @@ using osu.Framework.Input.Events;
 using osu.Framework.Logging;
 using osu.Framework.Screens;
 using osu.Framework.Threading;
-using osu.Framework.Timing;
 using osu.Game.Audio;
 using osu.Game.Beatmaps;
-using osu.Game.Beatmaps.ControlPoints;
 using osu.Game.Configuration;
 using osu.Game.Graphics.Containers;
 using osu.Game.IO.Archives;
@@ -41,7 +38,7 @@ using osuTK.Graphics;
 namespace osu.Game.Screens.Play
 {
     [Cached]
-    public abstract class Player : ScreenWithBeatmapBackground, ISamplePlaybackDisabler, ILocalUserPlayInfo, IBeatSyncProvider
+    public abstract class Player : ScreenWithBeatmapBackground, ISamplePlaybackDisabler, ILocalUserPlayInfo
     {
         /// <summary>
         /// The delay upon completion of the beatmap before displaying the results screen.
@@ -1111,9 +1108,5 @@ namespace osu.Game.Screens.Play
         IBindable<bool> ISamplePlaybackDisabler.SamplePlaybackDisabled => samplePlaybackDisabled;
 
         IBindable<bool> ILocalUserPlayInfo.IsPlaying => LocalUserPlaying;
-
-        ControlPointInfo IBeatSyncProvider.ControlPoints => Beatmap.Value.Beatmap.ControlPointInfo;
-        IClock IBeatSyncProvider.Clock => GameplayClockContainer.GameplayClock;
-        ChannelAmplitudes? IBeatSyncProvider.Amplitudes => Beatmap.Value.TrackLoaded ? Beatmap.Value.Track.CurrentAmplitudes : (ChannelAmplitudes?)null;
     }
 }

From 0bef2ca7526295767db063b0b9e92035411cda83 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 22 May 2022 19:27:20 +0200
Subject: [PATCH 4964/5547] Adjust test slightly

* Import `osuTK.Input` instead of using full qualified name
* Use some more straightforward assertions
---
 .../TestSceneMultiplayerMatchSubScreen.cs           | 13 +++++++------
 1 file changed, 7 insertions(+), 6 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs
index dd281e7738..7ae81c9800 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs
@@ -6,6 +6,7 @@ using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
 using osu.Framework.Extensions;
+using osu.Framework.Graphics.Containers;
 using osu.Framework.Platform;
 using osu.Framework.Screens;
 using osu.Framework.Testing;
@@ -28,6 +29,7 @@ using osu.Game.Screens.OnlinePlay.Multiplayer.Match;
 using osu.Game.Screens.OnlinePlay.Multiplayer.Participants;
 using osu.Game.Tests.Beatmaps;
 using osu.Game.Tests.Resources;
+using osuTK.Input;
 
 namespace osu.Game.Tests.Visual.Multiplayer
 {
@@ -194,10 +196,9 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             AddUntilStep("wait for join", () => RoomJoined);
 
-            AddStep("press toggle mod select key", () => InputManager.Key(osuTK.Input.Key.F1));
+            AddStep("press toggle mod select key", () => InputManager.Key(Key.F1));
 
-            AddUntilStep("mod select contents loaded",
-                () => this.ChildrenOfType<ModColumn>().Any() && this.ChildrenOfType<ModColumn>().All(col => col.IsLoaded && col.ItemsLoaded));
+            AddUntilStep("mod select shown", () => this.ChildrenOfType<ModSelectOverlay>().Single().State.Value == Visibility.Visible);
         }
 
         [Test]
@@ -214,10 +215,10 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             AddUntilStep("wait for join", () => RoomJoined);
 
-            AddStep("press toggle mod select key", () => InputManager.Key(osuTK.Input.Key.F1));
+            AddStep("press toggle mod select key", () => InputManager.Key(Key.F1));
 
-            AddAssert("mod select contents not loaded",
-                () => !(this.ChildrenOfType<ModColumn>().Any() && this.ChildrenOfType<ModColumn>().All(col => col.IsLoaded && col.ItemsLoaded)));
+            AddWaitStep("wait some", 3);
+            AddAssert("mod select not shown", () => this.ChildrenOfType<ModSelectOverlay>().Single().State.Value == Visibility.Hidden);
         }
 
         [Test]

From 40f560d7d0022c9882c0571e40d34658600e447d Mon Sep 17 00:00:00 2001
From: apollo-dw <83023433+apollo-dw@users.noreply.github.com>
Date: Sun, 22 May 2022 21:45:27 +0100
Subject: [PATCH 4965/5547] Remove internal process method

---
 osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs | 4 ++--
 osu.Game/Rulesets/Difficulty/Skills/Skill.cs         | 7 +------
 osu.Game/Rulesets/Difficulty/Skills/StrainSkill.cs   | 2 +-
 3 files changed, 4 insertions(+), 9 deletions(-)

diff --git a/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs b/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs
index b5aec0d659..b030c0c560 100644
--- a/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs
+++ b/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs
@@ -67,7 +67,7 @@ namespace osu.Game.Rulesets.Difficulty
                 foreach (var skill in skills)
                 {
                     cancellationToken.ThrowIfCancellationRequested();
-                    skill.ProcessInternal(hitObject);
+                    skill.Process(hitObject);
                 }
             }
 
@@ -108,7 +108,7 @@ namespace osu.Game.Rulesets.Difficulty
                 foreach (var skill in skills)
                 {
                     cancellationToken.ThrowIfCancellationRequested();
-                    skill.ProcessInternal(hitObject);
+                    skill.Process(hitObject);
                 }
 
                 attribs.Add(new TimedDifficultyAttributes(hitObject.EndTime * clockRate, CreateDifficultyAttributes(progressiveBeatmap, playableMods, skills, clockRate)));
diff --git a/osu.Game/Rulesets/Difficulty/Skills/Skill.cs b/osu.Game/Rulesets/Difficulty/Skills/Skill.cs
index f23f3b5f2a..770754f304 100644
--- a/osu.Game/Rulesets/Difficulty/Skills/Skill.cs
+++ b/osu.Game/Rulesets/Difficulty/Skills/Skill.cs
@@ -27,16 +27,11 @@ namespace osu.Game.Rulesets.Difficulty.Skills
             this.mods = mods;
         }
 
-        internal void ProcessInternal(DifficultyHitObject current)
-        {
-            Process(current);
-        }
-
         /// <summary>
         /// Process a <see cref="DifficultyHitObject"/>.
         /// </summary>
         /// <param name="current">The <see cref="DifficultyHitObject"/> to process.</param>
-        protected abstract void Process(DifficultyHitObject current);
+        public abstract void Process(DifficultyHitObject current);
 
         /// <summary>
         /// Returns the calculated difficulty value representing all <see cref="DifficultyHitObject"/>s that have been processed up to this point.
diff --git a/osu.Game/Rulesets/Difficulty/Skills/StrainSkill.cs b/osu.Game/Rulesets/Difficulty/Skills/StrainSkill.cs
index eb3203e9ec..6be10db8b3 100644
--- a/osu.Game/Rulesets/Difficulty/Skills/StrainSkill.cs
+++ b/osu.Game/Rulesets/Difficulty/Skills/StrainSkill.cs
@@ -44,7 +44,7 @@ namespace osu.Game.Rulesets.Difficulty.Skills
         /// <summary>
         /// Process a <see cref="DifficultyHitObject"/> and update current strain values accordingly.
         /// </summary>
-        protected sealed override void Process(DifficultyHitObject current)
+        public sealed override void Process(DifficultyHitObject current)
         {
             // The first object doesn't generate a strain, so we begin with an incremented section end
             if (current.Position == 0)

From afbb1fa750e8560481fbf43509ae166e822d87ff Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 23 May 2022 14:06:00 +0900
Subject: [PATCH 4966/5547] Fix tournament user stat population potentially
 using wrong ruleset

`OsuGameBase.Ruleset` is bound
[late](https://github.com/ppy/osu/blob/7d0470794bcd454d3a93954ec4fe3415933627ef/osu.Game.Tournament/TournamentGameBase.cs#L169)
so we must use the ladder one during user retrieval.

Closes https://github.com/ppy/osu/issues/18363.
---
 osu.Game.Tournament/TournamentGameBase.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Tournament/TournamentGameBase.cs b/osu.Game.Tournament/TournamentGameBase.cs
index 363baccb37..6ae0312cce 100644
--- a/osu.Game.Tournament/TournamentGameBase.cs
+++ b/osu.Game.Tournament/TournamentGameBase.cs
@@ -259,7 +259,7 @@ namespace osu.Game.Tournament
 
         public void PopulateUser(APIUser user, Action success = null, Action failure = null, bool immediate = false)
         {
-            var req = new GetUserRequest(user.Id, Ruleset.Value);
+            var req = new GetUserRequest(user.Id, ladder.Ruleset.Value);
 
             if (immediate)
             {

From 63a3829768be608c125076767538910104b4fe89 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Mon, 23 May 2022 14:19:25 +0900
Subject: [PATCH 4967/5547] Split out SingleKeyStamina class

---
 .../Difficulty/Skills/SingleKeyStamina.cs     | 42 +++++++++++++++++++
 .../Difficulty/Skills/Stamina.cs              | 34 ---------------
 2 files changed, 42 insertions(+), 34 deletions(-)
 create mode 100644 osu.Game.Rulesets.Taiko/Difficulty/Skills/SingleKeyStamina.cs

diff --git a/osu.Game.Rulesets.Taiko/Difficulty/Skills/SingleKeyStamina.cs b/osu.Game.Rulesets.Taiko/Difficulty/Skills/SingleKeyStamina.cs
new file mode 100644
index 0000000000..cabfd231d8
--- /dev/null
+++ b/osu.Game.Rulesets.Taiko/Difficulty/Skills/SingleKeyStamina.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 osu.Game.Rulesets.Difficulty.Preprocessing;
+using osu.Game.Rulesets.Difficulty.Skills;
+
+namespace osu.Game.Rulesets.Taiko.Difficulty.Skills
+{
+    /// <summary>
+    /// Stamina of a single key, calculated based on repetition speed.
+    /// </summary>
+    public class SingleKeyStamina
+    {
+        private double? previousHitTime;
+
+        /// <summary>
+        /// Similar to <see cref="StrainDecaySkill.StrainValueOf"/>
+        /// </summary>
+        public double StrainValueOf(DifficultyHitObject current)
+        {
+            if (previousHitTime == null)
+            {
+                previousHitTime = current.StartTime;
+                return 0;
+            }
+
+            double objectStrain = 0.5;
+            objectStrain += speedBonus(current.StartTime - previousHitTime.Value);
+            previousHitTime = current.StartTime;
+            return objectStrain;
+        }
+
+        /// <summary>
+        /// Applies a speed bonus dependent on the time since the last hit performed using this key.
+        /// </summary>
+        /// <param name="notePairDuration">The duration between the current and previous note hit using the same key.</param>
+        private double speedBonus(double notePairDuration)
+        {
+            return 175 / (notePairDuration + 100);
+        }
+    }
+}
diff --git a/osu.Game.Rulesets.Taiko/Difficulty/Skills/Stamina.cs b/osu.Game.Rulesets.Taiko/Difficulty/Skills/Stamina.cs
index 744dafd57e..32d8b70485 100644
--- a/osu.Game.Rulesets.Taiko/Difficulty/Skills/Stamina.cs
+++ b/osu.Game.Rulesets.Taiko/Difficulty/Skills/Stamina.cs
@@ -9,40 +9,6 @@ using osu.Game.Rulesets.Taiko.Objects;
 
 namespace osu.Game.Rulesets.Taiko.Difficulty.Skills
 {
-    /// <summary>
-    /// Stamina of a single key, calculated based on repetition speed.
-    /// </summary>
-    public class SingleKeyStamina
-    {
-        private double? previousHitTime;
-
-        /// <summary>
-        /// Similar to <see cref="StrainDecaySkill.StrainValueOf(DifficultyHitObject)"/>
-        /// </summary>
-        public double StrainValueOf(DifficultyHitObject current)
-        {
-            if (previousHitTime == null)
-            {
-                previousHitTime = current.StartTime;
-                return 0;
-            }
-
-            double objectStrain = 0.5;
-            objectStrain += speedBonus(current.StartTime - previousHitTime.Value);
-            previousHitTime = current.StartTime;
-            return objectStrain;
-        }
-
-        /// <summary>
-        /// Applies a speed bonus dependent on the time since the last hit performed using this key.
-        /// </summary>
-        /// <param name="notePairDuration">The duration between the current and previous note hit using the same key.</param>
-        private double speedBonus(double notePairDuration)
-        {
-            return 175 / (notePairDuration + 100);
-        }
-    }
-
     /// <summary>
     /// Calculates the stamina coefficient of taiko difficulty.
     /// </summary>

From 6cfe35360a6ed2e666047dce18a45570b098041a Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Mon, 23 May 2022 14:36:06 +0900
Subject: [PATCH 4968/5547] Refactor key indexing

---
 .../Difficulty/Skills/Stamina.cs              | 27 ++++++++++---------
 1 file changed, 14 insertions(+), 13 deletions(-)

diff --git a/osu.Game.Rulesets.Taiko/Difficulty/Skills/Stamina.cs b/osu.Game.Rulesets.Taiko/Difficulty/Skills/Stamina.cs
index 32d8b70485..61bcbfa59d 100644
--- a/osu.Game.Rulesets.Taiko/Difficulty/Skills/Stamina.cs
+++ b/osu.Game.Rulesets.Taiko/Difficulty/Skills/Stamina.cs
@@ -20,26 +20,27 @@ namespace osu.Game.Rulesets.Taiko.Difficulty.Skills
         protected override double SkillMultiplier => 1;
         protected override double StrainDecayBase => 0.4;
 
-        /// <summary>
-        /// Stamina of each individual keys, calculated based on repetition speed.
-        /// </summary>
-        private readonly SingleKeyStamina[] keyStamina =
+        private readonly SingleKeyStamina[] centreKeyStamina =
         {
             new SingleKeyStamina(),
-            new SingleKeyStamina(),
+            new SingleKeyStamina()
+        };
+
+        private readonly SingleKeyStamina[] rimKeyStamina =
+        {
             new SingleKeyStamina(),
             new SingleKeyStamina()
         };
 
         /// <summary>
-        /// Current index to <see cref="keyStamina" /> for a don hit.
+        /// Current index into <see cref="centreKeyStamina" /> for a centre hit.
         /// </summary>
-        private int donIndex = 1;
+        private int centreKeyIndex;
 
         /// <summary>
-        /// Current index to <see cref="keyStamina" /> for a kat hit.
+        /// Current index into <see cref="rimKeyStamina" /> for a rim hit.
         /// </summary>
-        private int katIndex = 3;
+        private int rimKeyIndex;
 
         /// <summary>
         /// Creates a <see cref="Stamina"/> skill.
@@ -59,12 +60,12 @@ namespace osu.Game.Rulesets.Taiko.Difficulty.Skills
             // Alternate key for the same color.
             if (current.HitType == HitType.Centre)
             {
-                donIndex = donIndex == 0 ? 1 : 0;
-                return keyStamina[donIndex];
+                centreKeyIndex = (centreKeyIndex + 1) % 2;
+                return centreKeyStamina[centreKeyIndex];
             }
 
-            katIndex = katIndex == 2 ? 3 : 2;
-            return keyStamina[katIndex];
+            rimKeyIndex = (rimKeyIndex + 1) % 2;
+            return rimKeyStamina[rimKeyIndex];
         }
 
         protected override double StrainValueOf(DifficultyHitObject current)

From d054e404dab139e3ec6a0d76cadb89f4cc6667a7 Mon Sep 17 00:00:00 2001
From: apollo-dw <83023433+apollo-dw@users.noreply.github.com>
Date: Mon, 23 May 2022 13:10:42 +0100
Subject: [PATCH 4969/5547] Set object list to read-only

---
 .../Rulesets/Difficulty/Preprocessing/DifficultyHitObject.cs    | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Rulesets/Difficulty/Preprocessing/DifficultyHitObject.cs b/osu.Game/Rulesets/Difficulty/Preprocessing/DifficultyHitObject.cs
index 4f001a520c..e082e077cf 100644
--- a/osu.Game/Rulesets/Difficulty/Preprocessing/DifficultyHitObject.cs
+++ b/osu.Game/Rulesets/Difficulty/Preprocessing/DifficultyHitObject.cs
@@ -11,7 +11,7 @@ namespace osu.Game.Rulesets.Difficulty.Preprocessing
     /// </summary>
     public class DifficultyHitObject
     {
-        private readonly List<DifficultyHitObject> difficultyHitObjects;
+        private readonly IReadOnlyList<DifficultyHitObject> difficultyHitObjects;
 
         /// <summary>
         /// The position of this <see cref="DifficultyHitObject"/> in the <see cref="difficultyHitObjects"/> list.

From 88217e0c984b63a29e0c70bdf41372067743b7ea Mon Sep 17 00:00:00 2001
From: Susko3 <Susko3@protonmail.com>
Date: Mon, 23 May 2022 20:22:27 +0200
Subject: [PATCH 4970/5547] Adjust `ScrollDelta` usages to account for
 normalised `IsPrecise` values

---
 osu.Game/Overlays/Volume/VolumeMeter.cs              | 2 +-
 osu.Game/Rulesets/Edit/DistancedHitObjectComposer.cs | 8 +++++---
 osu.Game/Screens/Edit/Editor.cs                      | 2 +-
 3 files changed, 7 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Overlays/Volume/VolumeMeter.cs b/osu.Game/Overlays/Volume/VolumeMeter.cs
index 46b8b35da2..929c362bd8 100644
--- a/osu.Game/Overlays/Volume/VolumeMeter.cs
+++ b/osu.Game/Overlays/Volume/VolumeMeter.cs
@@ -329,7 +329,7 @@ namespace osu.Game.Overlays.Volume
 
             if (isPrecise)
             {
-                scrollAccumulation += delta * adjust_step * 0.1;
+                scrollAccumulation += delta * adjust_step;
 
                 while (Precision.AlmostBigger(Math.Abs(scrollAccumulation), precision))
                 {
diff --git a/osu.Game/Rulesets/Edit/DistancedHitObjectComposer.cs b/osu.Game/Rulesets/Edit/DistancedHitObjectComposer.cs
index 5e6d9dbe34..27a3685f89 100644
--- a/osu.Game/Rulesets/Edit/DistancedHitObjectComposer.cs
+++ b/osu.Game/Rulesets/Edit/DistancedHitObjectComposer.cs
@@ -26,6 +26,8 @@ namespace osu.Game.Rulesets.Edit
     public abstract class DistancedHitObjectComposer<TObject> : HitObjectComposer<TObject>, IDistanceSnapProvider, IScrollBindingHandler<GlobalAction>
         where TObject : HitObject
     {
+        private const float adjust_step = 0.1f;
+
         public Bindable<double> DistanceSpacingMultiplier { get; } = new BindableDouble(1.0)
         {
             MinValue = 0.1,
@@ -61,7 +63,7 @@ namespace osu.Game.Rulesets.Edit
                     Child = distanceSpacingSlider = new ExpandableSlider<double, SizeSlider<double>>
                     {
                         Current = { BindTarget = DistanceSpacingMultiplier },
-                        KeyboardStep = 0.1f,
+                        KeyboardStep = adjust_step,
                     }
                 }
             });
@@ -93,7 +95,7 @@ namespace osu.Game.Rulesets.Edit
             {
                 case GlobalAction.EditorIncreaseDistanceSpacing:
                 case GlobalAction.EditorDecreaseDistanceSpacing:
-                    return adjustDistanceSpacing(e.Action, 0.1f);
+                    return adjustDistanceSpacing(e.Action, adjust_step);
             }
 
             return false;
@@ -109,7 +111,7 @@ namespace osu.Game.Rulesets.Edit
             {
                 case GlobalAction.EditorIncreaseDistanceSpacing:
                 case GlobalAction.EditorDecreaseDistanceSpacing:
-                    return adjustDistanceSpacing(e.Action, e.ScrollAmount * (e.IsPrecise ? 0.01f : 0.1f));
+                    return adjustDistanceSpacing(e.Action, e.ScrollAmount * adjust_step);
             }
 
             return false;
diff --git a/osu.Game/Screens/Edit/Editor.cs b/osu.Game/Screens/Edit/Editor.cs
index 0bb3f51903..eaacf74af3 100644
--- a/osu.Game/Screens/Edit/Editor.cs
+++ b/osu.Game/Screens/Edit/Editor.cs
@@ -540,7 +540,7 @@ namespace osu.Game.Screens.Edit
             if (scrollAccumulation != 0 && Math.Sign(scrollAccumulation) != scrollDirection)
                 scrollAccumulation = scrollDirection * (precision - Math.Abs(scrollAccumulation));
 
-            scrollAccumulation += scrollComponent * (e.IsPrecise ? 0.1 : 1);
+            scrollAccumulation += scrollComponent;
 
             // because we are doing snapped seeking, we need to add up precise scrolls until they accumulate to an arbitrary cut-off.
             while (Math.Abs(scrollAccumulation) >= precision)

From 58d39734d07c0fdd90c2310b68186b82df4ac6c0 Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Mon, 23 May 2022 20:23:50 +0100
Subject: [PATCH 4971/5547] Integrate `ChatOverlayV2` into main game

---
 osu.Game.Tests/Visual/Navigation/TestSceneOsuGame.cs   |  2 +-
 osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs |  2 +-
 osu.Game/Configuration/OsuConfigManager.cs             |  2 +-
 osu.Game/OsuGame.cs                                    |  4 ++--
 osu.Game/Overlays/ChatOverlayV2.cs                     | 10 ++++++++--
 .../Profile/Header/Components/MessageUserButton.cs     |  2 +-
 osu.Game/Overlays/Toolbar/ToolbarChatButton.cs         |  2 +-
 7 files changed, 15 insertions(+), 9 deletions(-)

diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneOsuGame.cs b/osu.Game.Tests/Visual/Navigation/TestSceneOsuGame.cs
index e4871f611e..c8ea692bb2 100644
--- a/osu.Game.Tests/Visual/Navigation/TestSceneOsuGame.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneOsuGame.cs
@@ -40,7 +40,7 @@ namespace osu.Game.Tests.Visual.Navigation
             typeof(DashboardOverlay),
             typeof(NewsOverlay),
             typeof(ChannelManager),
-            typeof(ChatOverlay),
+            typeof(ChatOverlayV2),
             typeof(SettingsOverlay),
             typeof(UserProfileOverlay),
             typeof(BeatmapSetOverlay),
diff --git a/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs b/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs
index e27db00003..7268dd31f6 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs
@@ -63,7 +63,7 @@ namespace osu.Game.Tests.Visual.Online
                 Children = new Drawable[]
                 {
                     channelManager,
-                    chatOverlay = new TestChatOverlayV2 { RelativeSizeAxes = Axes.Both },
+                    chatOverlay = new TestChatOverlayV2(),
                 },
             };
         });
diff --git a/osu.Game/Configuration/OsuConfigManager.cs b/osu.Game/Configuration/OsuConfigManager.cs
index 20d555c16c..69e7dee1a5 100644
--- a/osu.Game/Configuration/OsuConfigManager.cs
+++ b/osu.Game/Configuration/OsuConfigManager.cs
@@ -46,7 +46,7 @@ namespace osu.Game.Configuration
 
             SetDefault(OsuSetting.RandomSelectAlgorithm, RandomSelectAlgorithm.RandomPermutation);
 
-            SetDefault(OsuSetting.ChatDisplayHeight, ChatOverlay.DEFAULT_HEIGHT, 0.2f, 1f);
+            SetDefault(OsuSetting.ChatDisplayHeight, ChatOverlayV2.DEFAULT_HEIGHT, 0.2f, 1f);
 
             SetDefault(OsuSetting.BeatmapListingCardSize, BeatmapCardSize.Normal);
 
diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index 785881d97a..402bd94f31 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -75,7 +75,7 @@ namespace osu.Game
 
         public Toolbar Toolbar;
 
-        private ChatOverlay chatOverlay;
+        private ChatOverlayV2 chatOverlay;
 
         private ChannelManager channelManager;
 
@@ -848,7 +848,7 @@ namespace osu.Game
             loadComponentSingleFile(news = new NewsOverlay(), overlayContent.Add, true);
             var rankingsOverlay = loadComponentSingleFile(new RankingsOverlay(), overlayContent.Add, true);
             loadComponentSingleFile(channelManager = new ChannelManager(), AddInternal, true);
-            loadComponentSingleFile(chatOverlay = new ChatOverlay(), overlayContent.Add, true);
+            loadComponentSingleFile(chatOverlay = new ChatOverlayV2(), overlayContent.Add, true);
             loadComponentSingleFile(new MessageNotifier(), AddInternal, true);
             loadComponentSingleFile(Settings = new SettingsOverlay(), leftFloatingOverlayContent.Add, true);
             loadComponentSingleFile(changelogOverlay = new ChangelogOverlay(), overlayContent.Add, true);
diff --git a/osu.Game/Overlays/ChatOverlayV2.cs b/osu.Game/Overlays/ChatOverlayV2.cs
index ef479ea21b..441042432a 100644
--- a/osu.Game/Overlays/ChatOverlayV2.cs
+++ b/osu.Game/Overlays/ChatOverlayV2.cs
@@ -47,8 +47,9 @@ namespace osu.Game.Overlays
         private bool isDraggingTopBar;
         private float dragStartChatHeight;
 
+        public const float DEFAULT_HEIGHT = 0.4f;
+
         private const int transition_length = 500;
-        private const float default_chat_height = 0.4f;
         private const float top_bar_height = 40;
         private const float side_bar_width = 190;
         private const float chat_bar_height = 60;
@@ -70,7 +71,7 @@ namespace osu.Game.Overlays
 
         public ChatOverlayV2()
         {
-            Height = default_chat_height;
+            Height = DEFAULT_HEIGHT;
 
             Masking = true;
 
@@ -82,6 +83,7 @@ namespace osu.Game.Overlays
             Margin = new MarginPadding { Bottom = -corner_radius };
             Padding = new MarginPadding { Bottom = corner_radius };
 
+            RelativeSizeAxes = Axes.Both;
             Anchor = Anchor.BottomCentre;
             Origin = Anchor.BottomCentre;
         }
@@ -294,6 +296,10 @@ namespace osu.Game.Overlays
                     });
                 }
             }
+
+            // Mark channel as read when channel switched
+            if (newChannel.Messages.Any())
+                channelManager.MarkChannelAsRead(newChannel);
         }
 
         protected virtual ChatOverlayDrawableChannel CreateDrawableChannel(Channel newChannel) => new ChatOverlayDrawableChannel(newChannel);
diff --git a/osu.Game/Overlays/Profile/Header/Components/MessageUserButton.cs b/osu.Game/Overlays/Profile/Header/Components/MessageUserButton.cs
index e3dc5f818a..eafb453f75 100644
--- a/osu.Game/Overlays/Profile/Header/Components/MessageUserButton.cs
+++ b/osu.Game/Overlays/Profile/Header/Components/MessageUserButton.cs
@@ -27,7 +27,7 @@ namespace osu.Game.Overlays.Profile.Header.Components
         private UserProfileOverlay userOverlay { get; set; }
 
         [Resolved(CanBeNull = true)]
-        private ChatOverlay chatOverlay { get; set; }
+        private ChatOverlayV2 chatOverlay { get; set; }
 
         [Resolved]
         private IAPIProvider apiProvider { get; set; }
diff --git a/osu.Game/Overlays/Toolbar/ToolbarChatButton.cs b/osu.Game/Overlays/Toolbar/ToolbarChatButton.cs
index 2d3b33e9bc..20f405aae2 100644
--- a/osu.Game/Overlays/Toolbar/ToolbarChatButton.cs
+++ b/osu.Game/Overlays/Toolbar/ToolbarChatButton.cs
@@ -17,7 +17,7 @@ namespace osu.Game.Overlays.Toolbar
         }
 
         [BackgroundDependencyLoader(true)]
-        private void load(ChatOverlay chat)
+        private void load(ChatOverlayV2 chat)
         {
             StateContainer = chat;
         }

From d2a49ca266087d5342fb1c9aa65b45db9204a7a1 Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Mon, 23 May 2022 20:24:17 +0100
Subject: [PATCH 4972/5547] Use `ChatOverlayV2` in message notifier and tests

---
 osu.Game.Tests/Visual/Online/TestSceneMessageNotifier.cs | 2 +-
 osu.Game/Online/Chat/MessageNotifier.cs                  | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneMessageNotifier.cs b/osu.Game.Tests/Visual/Online/TestSceneMessageNotifier.cs
index 79f62a16e3..46f426597a 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneMessageNotifier.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneMessageNotifier.cs
@@ -208,7 +208,7 @@ namespace osu.Game.Tests.Visual.Online
             };
 
             [Cached]
-            public ChatOverlay ChatOverlay { get; } = new ChatOverlay();
+            public ChatOverlayV2 ChatOverlay { get; } = new ChatOverlayV2();
 
             private readonly MessageNotifier messageNotifier = new MessageNotifier();
 
diff --git a/osu.Game/Online/Chat/MessageNotifier.cs b/osu.Game/Online/Chat/MessageNotifier.cs
index ca6082e19b..cea3e321fa 100644
--- a/osu.Game/Online/Chat/MessageNotifier.cs
+++ b/osu.Game/Online/Chat/MessageNotifier.cs
@@ -27,7 +27,7 @@ namespace osu.Game.Online.Chat
         private INotificationOverlay notifications { get; set; }
 
         [Resolved]
-        private ChatOverlay chatOverlay { get; set; }
+        private ChatOverlayV2 chatOverlay { get; set; }
 
         [Resolved]
         private ChannelManager channelManager { get; set; }
@@ -170,7 +170,7 @@ namespace osu.Game.Online.Chat
             public override bool IsImportant => false;
 
             [BackgroundDependencyLoader]
-            private void load(OsuColour colours, ChatOverlay chatOverlay, INotificationOverlay notificationOverlay)
+            private void load(OsuColour colours, ChatOverlayV2 chatOverlay, INotificationOverlay notificationOverlay)
             {
                 IconBackground.Colour = colours.PurpleDark;
 

From 606f3b2bd18bc2ed780441a02f6698ba4bcbe6f0 Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Mon, 23 May 2022 20:24:49 +0100
Subject: [PATCH 4973/5547] Use `ChatOverlayV2` in screen navigation tests

---
 .../Visual/Navigation/TestScenePerformFromScreen.cs           | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Visual/Navigation/TestScenePerformFromScreen.cs b/osu.Game.Tests/Visual/Navigation/TestScenePerformFromScreen.cs
index 2ce914ba3d..5d0116f80e 100644
--- a/osu.Game.Tests/Visual/Navigation/TestScenePerformFromScreen.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestScenePerformFromScreen.cs
@@ -86,9 +86,9 @@ namespace osu.Game.Tests.Visual.Navigation
         [Test]
         public void TestOverlaysAlwaysClosed()
         {
-            ChatOverlay chat = null;
+            ChatOverlayV2 chat = null;
             AddUntilStep("is at menu", () => Game.ScreenStack.CurrentScreen is MainMenu);
-            AddUntilStep("wait for chat load", () => (chat = Game.ChildrenOfType<ChatOverlay>().SingleOrDefault()) != null);
+            AddUntilStep("wait for chat load", () => (chat = Game.ChildrenOfType<ChatOverlayV2>().SingleOrDefault()) != null);
 
             AddStep("show chat", () => InputManager.Key(Key.F8));
 

From 60b10fca4ec969997f77861beb12d724f0f15297 Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Mon, 23 May 2022 20:25:01 +0100
Subject: [PATCH 4974/5547] Remove redundant caching of overlays in `ChatLink`
 test

---
 osu.Game.Tests/Visual/Online/TestSceneChatLink.cs | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneChatLink.cs b/osu.Game.Tests/Visual/Online/TestSceneChatLink.cs
index 6818147da4..a28de3be1e 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneChatLink.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneChatLink.cs
@@ -12,7 +12,6 @@ using osu.Framework.Graphics.Containers;
 using osu.Game.Graphics;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Chat;
-using osu.Game.Overlays;
 using osu.Game.Overlays.Chat;
 using osuTK.Graphics;
 
@@ -22,12 +21,10 @@ namespace osu.Game.Tests.Visual.Online
     public class TestSceneChatLink : OsuTestScene
     {
         private readonly TestChatLineContainer textContainer;
-        private readonly DialogOverlay dialogOverlay;
         private Color4 linkColour;
 
         public TestSceneChatLink()
         {
-            Add(dialogOverlay = new DialogOverlay { Depth = float.MinValue });
             Add(textContainer = new TestChatLineContainer
             {
                 Padding = new MarginPadding { Left = 20, Right = 20 },
@@ -47,9 +44,6 @@ namespace osu.Game.Tests.Visual.Online
             availableChannels.Add(new Channel { Name = "#english" });
             availableChannels.Add(new Channel { Name = "#japanese" });
             Dependencies.Cache(chatManager);
-
-            Dependencies.Cache(new ChatOverlay());
-            Dependencies.CacheAs<IDialogOverlay>(dialogOverlay);
         }
 
         [SetUp]

From e990a247230d086f14a88e3976230055c5fd331a Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Mon, 23 May 2022 20:40:01 +0100
Subject: [PATCH 4975/5547] Remove redundant installation of `libavformat` in
 Linux CI runs

Linux `libavformat` native libraries are now packaged with framework.
---
 .github/workflows/ci.yml | 9 ---------
 1 file changed, 9 deletions(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 1d5c565d60..320197b88e 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -78,15 +78,6 @@ jobs:
         with:
           dotnet-version: "6.0.x"
 
-      # FIXME: libavformat is not included in Ubuntu. Let's fix that.
-      # https://github.com/ppy/osu-framework/issues/4349
-      # Remove this once https://github.com/actions/virtual-environments/issues/3306 has been resolved.
-      - name: Install libavformat-dev
-        if: ${{matrix.os.fullname == 'ubuntu-latest'}}
-        run: |
-         sudo apt-get update && \
-         sudo apt-get -y install libavformat-dev
-
       - name: Compile
         run: dotnet build -c Debug -warnaserror osu.Desktop.slnf
 

From 5dbec92d9e9973b144028edd8e72671f1635ea73 Mon Sep 17 00:00:00 2001
From: apollo-dw <83023433+apollo-dw@users.noreply.github.com>
Date: Mon, 23 May 2022 22:17:29 +0100
Subject: [PATCH 4976/5547] Update comments

---
 .../Difficulty/Preprocessing/OsuDifficultyHitObject.cs          | 2 +-
 .../Difficulty/Preprocessing/TaikoDifficultyHitObject.cs        | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
index 0598cbe4c9..591a6e4aa2 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
@@ -13,7 +13,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
 {
     public class OsuDifficultyHitObject : DifficultyHitObject
     {
-        private const int normalised_radius = 50;
+        private const int normalised_radius = 50; // Change radius to 50 to make 100 the diameter. Easier for mental maths.
         private const int min_delta_time = 25;
         private const float maximum_slider_radius = normalised_radius * 2.4f;
         private const float assumed_slider_radius = normalised_radius * 1.8f;
diff --git a/osu.Game.Rulesets.Taiko/Difficulty/Preprocessing/TaikoDifficultyHitObject.cs b/osu.Game.Rulesets.Taiko/Difficulty/Preprocessing/TaikoDifficultyHitObject.cs
index 79e760d149..a4b7609328 100644
--- a/osu.Game.Rulesets.Taiko/Difficulty/Preprocessing/TaikoDifficultyHitObject.cs
+++ b/osu.Game.Rulesets.Taiko/Difficulty/Preprocessing/TaikoDifficultyHitObject.cs
@@ -39,7 +39,7 @@ namespace osu.Game.Rulesets.Taiko.Difficulty.Preprocessing
         /// <param name="lastLastObject">The gameplay <see cref="HitObject"/> preceding <paramref name="lastObject"/>.</param>
         /// <param name="clockRate">The rate of the gameplay clock. Modified by speed-changing mods.</param>
         /// <param name="objects">The list of <see cref="DifficultyHitObject"/>s in the current beatmap.</param>
-        /// <param name="position">The index of the object in the beatmap.</param>
+        /// <param name="position">The position of this <see cref="DifficultyHitObject"/> in the <paramref name="objects"/> list.</param>
         public TaikoDifficultyHitObject(HitObject hitObject, HitObject lastObject, HitObject lastLastObject, double clockRate, List<DifficultyHitObject> objects, int position)
             : base(hitObject, lastObject, clockRate, objects, position)
         {

From 14f14b431154f9f86d14f794ad64d60e1bd9b76a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 23 May 2022 23:37:05 +0200
Subject: [PATCH 4977/5547] Add failing test case for back button behaviour in
 song select

---
 .../Navigation/TestSceneScreenNavigation.cs   | 35 +++++++++++++++++++
 1 file changed, 35 insertions(+)

diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs b/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
index a3e0caedb9..256f4a7423 100644
--- a/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
@@ -8,9 +8,11 @@ using osu.Framework.Allocation;
 using osu.Framework.Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.UserInterface;
 using osu.Framework.Screens;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
+using osu.Game.Collections;
 using osu.Game.Configuration;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Online.Leaderboards;
@@ -54,6 +56,39 @@ namespace osu.Game.Tests.Visual.Navigation
             exitViaEscapeAndConfirm();
         }
 
+        [Test]
+        public void TestSongSelectBackActionHandling()
+        {
+            TestPlaySongSelect songSelect = null;
+
+            PushAndConfirm(() => songSelect = new TestPlaySongSelect());
+
+            AddStep("set filter", () => songSelect.ChildrenOfType<SearchTextBox>().Single().Current.Value = "test");
+            AddStep("press back", () => InputManager.Click(MouseButton.Button1));
+
+            AddAssert("still at song select", () => Game.ScreenStack.CurrentScreen == songSelect);
+            AddAssert("filter cleared", () => string.IsNullOrEmpty(songSelect.ChildrenOfType<SearchTextBox>().Single().Current.Value));
+
+            AddStep("set filter again", () => songSelect.ChildrenOfType<SearchTextBox>().Single().Current.Value = "test");
+            AddStep("open collections dropdown", () =>
+            {
+                InputManager.MoveMouseTo(songSelect.ChildrenOfType<CollectionFilterDropdown>().Single());
+                InputManager.Click(MouseButton.Left);
+            });
+
+            AddStep("press back once", () => InputManager.Click(MouseButton.Button1));
+            AddAssert("still at song select", () => Game.ScreenStack.CurrentScreen == songSelect);
+            AddAssert("collections dropdown closed", () => songSelect
+                                                           .ChildrenOfType<CollectionFilterDropdown>().Single()
+                                                           .ChildrenOfType<Dropdown<CollectionFilterMenuItem>.DropdownMenu>().Single().State == MenuState.Closed);
+
+            AddStep("press back a second time", () => InputManager.Click(MouseButton.Button1));
+            AddAssert("filter cleared", () => string.IsNullOrEmpty(songSelect.ChildrenOfType<SearchTextBox>().Single().Current.Value));
+
+            AddStep("press back a third time", () => InputManager.Click(MouseButton.Button1));
+            ConfirmAtMainMenu();
+        }
+
         /// <summary>
         /// This tests that the F1 key will open the mod select overlay, and not be handled / blocked by the music controller (which has the same default binding
         /// but should be handled *after* song select).

From 3847a586f110fec99f82645582a373da98776bff Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 23 May 2022 23:37:40 +0200
Subject: [PATCH 4978/5547] Make `GlobalAction.Back` close all opened dropdown
 menus

---
 .../Graphics/UserInterface/OsuDropdown.cs     | 22 ++++++++++++++++++-
 1 file changed, 21 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Graphics/UserInterface/OsuDropdown.cs b/osu.Game/Graphics/UserInterface/OsuDropdown.cs
index 4e391c8221..23e05c7ccc 100644
--- a/osu.Game/Graphics/UserInterface/OsuDropdown.cs
+++ b/osu.Game/Graphics/UserInterface/OsuDropdown.cs
@@ -12,9 +12,12 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Graphics.UserInterface;
+using osu.Framework.Input.Bindings;
+using osu.Framework.Input.Events;
 using osu.Framework.Localisation;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
+using osu.Game.Input.Bindings;
 using osu.Game.Overlays;
 using osuTK;
 using osuTK.Graphics;
@@ -31,7 +34,7 @@ namespace osu.Game.Graphics.UserInterface
 
         #region OsuDropdownMenu
 
-        protected class OsuDropdownMenu : DropdownMenu
+        protected class OsuDropdownMenu : DropdownMenu, IKeyBindingHandler<GlobalAction>
         {
             public override bool HandleNonPositionalInput => State == MenuState.Open;
 
@@ -275,6 +278,23 @@ namespace osu.Game.Graphics.UserInterface
             }
 
             #endregion
+
+            public bool OnPressed(KeyBindingPressEvent<GlobalAction> e)
+            {
+                if (e.Repeat) return false;
+
+                if (e.Action == GlobalAction.Back)
+                {
+                    State = MenuState.Closed;
+                    return true;
+                }
+
+                return false;
+            }
+
+            public void OnReleased(KeyBindingReleaseEvent<GlobalAction> e)
+            {
+            }
         }
 
         #endregion

From 4cf8df16286337e07294a7e30565a204abccdcc0 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 23 May 2022 23:58:12 +0200
Subject: [PATCH 4979/5547] Fix test inteference from `TestOverlayClosing`

---
 osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs b/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
index 256f4a7423..c1f5f110d1 100644
--- a/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
@@ -522,6 +522,9 @@ namespace osu.Game.Tests.Visual.Navigation
             AddStep("move cursor to background", () => InputManager.MoveMouseTo(Game.ScreenSpaceDrawQuad.BottomRight));
             AddStep("click left mouse button", () => InputManager.Click(MouseButton.Left));
             AddAssert("now playing is hidden", () => nowPlayingOverlay.State.Value == Visibility.Hidden);
+
+            // move the mouse firmly inside game bounds to avoid interfering with other tests.
+            AddStep("center cursor", () => InputManager.MoveMouseTo(Game.ScreenSpaceDrawQuad.Centre));
         }
 
         [Test]

From eae23784662e89b9d1bdc4d5b0710afe77d41303 Mon Sep 17 00:00:00 2001
From: apollo-dw <83023433+apollo-dw@users.noreply.github.com>
Date: Tue, 24 May 2022 01:49:07 +0100
Subject: [PATCH 4980/5547] Add WIP to search filters

---
 osu.Game/Overlays/BeatmapListing/SearchCategory.cs | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/osu.Game/Overlays/BeatmapListing/SearchCategory.cs b/osu.Game/Overlays/BeatmapListing/SearchCategory.cs
index d6ae41aba1..b52df6234f 100644
--- a/osu.Game/Overlays/BeatmapListing/SearchCategory.cs
+++ b/osu.Game/Overlays/BeatmapListing/SearchCategory.cs
@@ -32,6 +32,9 @@ namespace osu.Game.Overlays.BeatmapListing
         [Description("Pending & WIP")]
         Pending,
 
+        [LocalisableDescription(typeof(BeatmapsStrings), nameof(BeatmapsStrings.StatusWip))]
+        Wip,
+
         [LocalisableDescription(typeof(BeatmapsStrings), nameof(BeatmapsStrings.StatusGraveyard))]
         Graveyard,
 

From ed0b841df0ea3bd95315fd79f658e83446239e60 Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Mon, 23 May 2022 13:19:01 -0700
Subject: [PATCH 4981/5547] Fix incorrect left/right clicking area of mod
 panels

---
 osu.Game/Overlays/Mods/ModColumn.cs | 2 +-
 osu.Game/Overlays/Mods/ModPanel.cs  | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Overlays/Mods/ModColumn.cs b/osu.Game/Overlays/Mods/ModColumn.cs
index 9bb3f8bd9e..42f9daec4d 100644
--- a/osu.Game/Overlays/Mods/ModColumn.cs
+++ b/osu.Game/Overlays/Mods/ModColumn.cs
@@ -267,7 +267,7 @@ namespace osu.Game.Overlays.Mods
         {
             cancellationTokenSource?.Cancel();
 
-            var panels = availableMods.Select(mod => CreateModPanel(mod).With(panel => panel.Shear = new Vector2(-ShearedOverlayContainer.SHEAR, 0)));
+            var panels = availableMods.Select(mod => CreateModPanel(mod).With(panel => panel.Shear = Vector2.Zero));
 
             Task? loadTask;
 
diff --git a/osu.Game/Overlays/Mods/ModPanel.cs b/osu.Game/Overlays/Mods/ModPanel.cs
index 7010342bd8..358bdd3202 100644
--- a/osu.Game/Overlays/Mods/ModPanel.cs
+++ b/osu.Game/Overlays/Mods/ModPanel.cs
@@ -70,7 +70,7 @@ namespace osu.Game.Overlays.Mods
             Content.Masking = true;
             Content.CornerRadius = CORNER_RADIUS;
             Content.BorderThickness = 2;
-            Content.Shear = new Vector2(ShearedOverlayContainer.SHEAR, 0);
+            Shear = new Vector2(ShearedOverlayContainer.SHEAR, 0);
 
             Children = new Drawable[]
             {

From 1f935cacf452b3a9f212551082d4a14e4a286972 Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Mon, 23 May 2022 18:45:53 -0700
Subject: [PATCH 4982/5547] Add spotlighted beatmaps filter to beatmap listing

---
 osu.Game/Overlays/BeatmapListing/SearchGeneral.cs | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/osu.Game/Overlays/BeatmapListing/SearchGeneral.cs b/osu.Game/Overlays/BeatmapListing/SearchGeneral.cs
index 9387020bdf..34ff5b9840 100644
--- a/osu.Game/Overlays/BeatmapListing/SearchGeneral.cs
+++ b/osu.Game/Overlays/BeatmapListing/SearchGeneral.cs
@@ -21,6 +21,9 @@ namespace osu.Game.Overlays.BeatmapListing
         [Description("Subscribed mappers")]
         Follows,
 
+        [LocalisableDescription(typeof(BeatmapsStrings), nameof(BeatmapsStrings.GeneralSpotlights))]
+        Spotlights,
+
         [LocalisableDescription(typeof(BeatmapsStrings), nameof(BeatmapsStrings.GeneralFeaturedArtists))]
         [Description("Featured artists")]
         FeaturedArtists

From 9259aa94f10897d044e590ad61e0aa6e5506bf7a Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 24 May 2022 11:47:42 +0900
Subject: [PATCH 4983/5547] Fix Catmull slider parsing with duplicate initial
 point

---
 .../Formats/LegacyBeatmapDecoderTest.cs       | 19 +++++++++++++++++++
 ...catmull-duplicate-initial-controlpoint.osu |  2 ++
 .../Objects/Legacy/ConvertHitObjectParser.cs  |  6 ++++--
 3 files changed, 25 insertions(+), 2 deletions(-)
 create mode 100644 osu.Game.Tests/Resources/catmull-duplicate-initial-controlpoint.osu

diff --git a/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs b/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs
index 89baaf228d..e2d9910b82 100644
--- a/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs
+++ b/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs
@@ -898,5 +898,24 @@ namespace osu.Game.Tests.Beatmaps.Formats
                 Assert.That(controlPoints[3].Type, Is.Null);
             }
         }
+
+        [Test]
+        public void TestLegacyDuplicateInitialCatmullPointIsMerged()
+        {
+            var decoder = new LegacyBeatmapDecoder { ApplyOffsets = false };
+
+            using (var resStream = TestResources.OpenResource("catmull-duplicate-initial-controlpoint.osu"))
+            using (var stream = new LineBufferedReader(resStream))
+            {
+                var decoded = decoder.Decode(stream);
+                var controlPoints = ((IHasPath)decoded.HitObjects[0]).Path.ControlPoints;
+
+                Assert.That(controlPoints.Count, Is.EqualTo(4));
+                Assert.That(controlPoints[0].Type, Is.EqualTo(PathType.Catmull));
+                Assert.That(controlPoints[0].Position, Is.EqualTo(Vector2.Zero));
+                Assert.That(controlPoints[1].Type, Is.Null);
+                Assert.That(controlPoints[1].Position, Is.Not.EqualTo(Vector2.Zero));
+            }
+        }
     }
 }
diff --git a/osu.Game.Tests/Resources/catmull-duplicate-initial-controlpoint.osu b/osu.Game.Tests/Resources/catmull-duplicate-initial-controlpoint.osu
new file mode 100644
index 0000000000..7062229eed
--- /dev/null
+++ b/osu.Game.Tests/Resources/catmull-duplicate-initial-controlpoint.osu
@@ -0,0 +1,2 @@
+[HitObjects]
+200,304,23875,6,0,C|200:304|288:304|288:208|352:208,1,260,8|0
\ No newline at end of file
diff --git a/osu.Game/Rulesets/Objects/Legacy/ConvertHitObjectParser.cs b/osu.Game/Rulesets/Objects/Legacy/ConvertHitObjectParser.cs
index 7cf68a2df7..d3d1196eae 100644
--- a/osu.Game/Rulesets/Objects/Legacy/ConvertHitObjectParser.cs
+++ b/osu.Game/Rulesets/Objects/Legacy/ConvertHitObjectParser.cs
@@ -340,8 +340,10 @@ namespace osu.Game.Rulesets.Objects.Legacy
                 if (vertices[endIndex].Position != vertices[endIndex - 1].Position)
                     continue;
 
-                // Adjacent legacy Catmull segments should be treated as a single segment.
-                if (FormatVersion < LegacyBeatmapEncoder.FIRST_LAZER_VERSION && type == PathType.Catmull)
+                // Legacy Catmull sliders don't support multiple segments, so adjacent Catmull segments should be treated as a single one.
+                // Importantly, this is not applied to the first control point, which may duplicate the slider path's position
+                // resulting in a duplicate (0,0) control point in the resultant list.
+                if (type == PathType.Catmull && endIndex > 1 && FormatVersion < LegacyBeatmapEncoder.FIRST_LAZER_VERSION)
                     continue;
 
                 // The last control point of each segment is not allowed to start a new implicit segment.

From 4bcf15f63257eb741775623ce5605bc5fb31220c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 23 May 2022 17:56:32 +0900
Subject: [PATCH 4984/5547] Refactor test to allow waveform testing

---
 .../Editing/TestSceneTapTimingControl.cs      | 76 +++++++++++--------
 1 file changed, 46 insertions(+), 30 deletions(-)

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneTapTimingControl.cs b/osu.Game.Tests/Visual/Editing/TestSceneTapTimingControl.cs
index de441995b5..46b45979ea 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneTapTimingControl.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneTapTimingControl.cs
@@ -4,15 +4,15 @@
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
+using osu.Framework.Audio;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps.ControlPoints;
+using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.UserInterfaceV2;
 using osu.Game.Overlays;
-using osu.Game.Rulesets.Edit;
-using osu.Game.Rulesets.Osu;
 using osu.Game.Screens.Edit;
 using osu.Game.Screens.Edit.Timing;
 using osuTK;
@@ -22,9 +22,9 @@ namespace osu.Game.Tests.Visual.Editing
     [TestFixture]
     public class TestSceneTapTimingControl : EditorClockTestScene
     {
-        [Cached(typeof(EditorBeatmap))]
-        [Cached(typeof(IBeatSnapProvider))]
-        private readonly EditorBeatmap editorBeatmap;
+        private EditorBeatmap editorBeatmap => editorBeatmapContainer?.EditorBeatmap;
+
+        private TestSceneHitObjectComposer.EditorBeatmapContainer editorBeatmapContainer;
 
         [Cached]
         private readonly OverlayColourProvider colourProvider = new OverlayColourProvider(OverlayColourScheme.Blue);
@@ -33,38 +33,48 @@ namespace osu.Game.Tests.Visual.Editing
         private Bindable<ControlPointGroup> selectedGroup = new Bindable<ControlPointGroup>();
 
         private TapTimingControl control;
+        private OsuSpriteText timingInfo;
 
-        public TestSceneTapTimingControl()
+        [Resolved]
+        private AudioManager audio { get; set; }
+
+        [SetUpSteps]
+        public void SetUpSteps()
         {
-            var playableBeatmap = CreateBeatmap(new OsuRuleset().RulesetInfo);
+            AddStep("create beatmap", () =>
+            {
+                Beatmap.Value = new WaveformTestBeatmap(audio);
+            });
 
-            // Ensure time doesn't end while testing
-            playableBeatmap.BeatmapInfo.Length = 1200000;
+            AddStep("Create component", () =>
+            {
+                Child = editorBeatmapContainer = new TestSceneHitObjectComposer.EditorBeatmapContainer(Beatmap.Value)
+                {
+                    Children = new Drawable[]
+                    {
+                        new Container
+                        {
+                            Anchor = Anchor.Centre,
+                            Origin = Anchor.Centre,
+                            AutoSizeAxes = Axes.Y,
+                            Width = 400,
+                            Scale = new Vector2(1.5f),
+                            Child = control = new TapTimingControl(),
+                        },
+                        timingInfo = new OsuSpriteText(),
+                    }
+                };
 
-            editorBeatmap = new EditorBeatmap(playableBeatmap);
-
-            selectedGroup.Value = editorBeatmap.ControlPointInfo.Groups.First();
+                selectedGroup.Value = editorBeatmap.ControlPointInfo.Groups.First();
+            });
         }
 
-        protected override void LoadComplete()
+        protected override void Update()
         {
-            base.LoadComplete();
+            base.Update();
 
-            Beatmap.Value = CreateWorkingBeatmap(editorBeatmap.PlayableBeatmap);
-            Beatmap.Disabled = true;
-
-            Children = new Drawable[]
-            {
-                new Container
-                {
-                    Anchor = Anchor.Centre,
-                    Origin = Anchor.Centre,
-                    AutoSizeAxes = Axes.Y,
-                    Width = 400,
-                    Scale = new Vector2(1.5f),
-                    Child = control = new TapTimingControl(),
-                }
-            };
+            if (selectedGroup.Value != null)
+                timingInfo.Text = $"offset: {selectedGroup.Value.Time:N2} bpm: {selectedGroup.Value.ControlPoints.OfType<TimingControlPoint>().First().BPM:N2}";
         }
 
         [Test]
@@ -104,7 +114,13 @@ namespace osu.Game.Tests.Visual.Editing
                        .TriggerClick();
             });
 
-            AddSliderStep("BPM", 30, 400, 60, bpm => editorBeatmap.ControlPointInfo.TimingPoints.First().BeatLength = 60000f / bpm);
+            AddSliderStep("BPM", 30, 400, 128, bpm =>
+            {
+                if (editorBeatmap == null)
+                    return;
+
+                editorBeatmap.ControlPointInfo.TimingPoints.First().BeatLength = 60000f / bpm;
+            });
         }
 
         protected override void Dispose(bool isDisposing)

From 588c5d158320bf5ad26e85337a46084b92d5bda8 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 23 May 2022 19:52:01 +0900
Subject: [PATCH 4985/5547] Add initial waveform comparison display

---
 .../ControlPoints/TimingControlPoint.cs       |   2 +
 .../Screens/Edit/Timing/TapTimingControl.cs   |  36 ++++-
 .../Edit/Timing/WaveformComparisonDisplay.cs  | 152 ++++++++++++++++++
 3 files changed, 184 insertions(+), 6 deletions(-)
 create mode 100644 osu.Game/Screens/Edit/Timing/WaveformComparisonDisplay.cs

diff --git a/osu.Game/Beatmaps/ControlPoints/TimingControlPoint.cs b/osu.Game/Beatmaps/ControlPoints/TimingControlPoint.cs
index 922439fcb8..3a7c8b2ec0 100644
--- a/osu.Game/Beatmaps/ControlPoints/TimingControlPoint.cs
+++ b/osu.Game/Beatmaps/ControlPoints/TimingControlPoint.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.
 
+#nullable enable
+
 using osu.Framework.Bindables;
 using osu.Game.Beatmaps.Timing;
 using osu.Game.Graphics;
diff --git a/osu.Game/Screens/Edit/Timing/TapTimingControl.cs b/osu.Game/Screens/Edit/Timing/TapTimingControl.cs
index 1b0f0a3f5e..d0ab4d1f98 100644
--- a/osu.Game/Screens/Edit/Timing/TapTimingControl.cs
+++ b/osu.Game/Screens/Edit/Timing/TapTimingControl.cs
@@ -24,8 +24,8 @@ namespace osu.Game.Screens.Edit.Timing
         [BackgroundDependencyLoader]
         private void load(OverlayColourProvider colourProvider, OsuColour colours)
         {
-            Height = 200;
             RelativeSizeAxes = Axes.X;
+            AutoSizeAxes = Axes.Y;
 
             CornerRadius = LabelledDrawable<Drawable>.CORNER_RADIUS;
             Masking = true;
@@ -39,20 +39,44 @@ namespace osu.Game.Screens.Edit.Timing
                 },
                 new GridContainer
                 {
-                    RelativeSizeAxes = Axes.Both,
+                    RelativeSizeAxes = Axes.X,
+                    AutoSizeAxes = Axes.Y,
                     RowDimensions = new[]
                     {
-                        new Dimension(),
+                        new Dimension(GridSizeMode.Absolute, 200),
                         new Dimension(GridSizeMode.Absolute, 60),
                     },
                     Content = new[]
                     {
                         new Drawable[]
                         {
-                            new MetronomeDisplay
+                            new Container
                             {
-                                Anchor = Anchor.Centre,
-                                Origin = Anchor.Centre,
+                                RelativeSizeAxes = Axes.Both,
+                                Children = new Drawable[]
+                                {
+                                    new GridContainer
+                                    {
+                                        RelativeSizeAxes = Axes.Both,
+                                        ColumnDimensions = new[]
+                                        {
+                                            new Dimension(GridSizeMode.AutoSize),
+                                            new Dimension()
+                                        },
+                                        Content = new[]
+                                        {
+                                            new Drawable[]
+                                            {
+                                                new MetronomeDisplay
+                                                {
+                                                    Anchor = Anchor.CentreLeft,
+                                                    Origin = Anchor.CentreLeft,
+                                                },
+                                                new WaveformComparisonDisplay(),
+                                            }
+                                        },
+                                    }
+                                }
                             }
                         },
                         new Drawable[]
diff --git a/osu.Game/Screens/Edit/Timing/WaveformComparisonDisplay.cs b/osu.Game/Screens/Edit/Timing/WaveformComparisonDisplay.cs
new file mode 100644
index 0000000000..67a1d30ebe
--- /dev/null
+++ b/osu.Game/Screens/Edit/Timing/WaveformComparisonDisplay.cs
@@ -0,0 +1,152 @@
+// 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 enable
+
+using System;
+using System.Linq;
+using osu.Framework.Allocation;
+using osu.Framework.Bindables;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Audio;
+using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.Shapes;
+using osu.Framework.Input.Events;
+using osu.Game.Beatmaps;
+using osu.Game.Beatmaps.ControlPoints;
+using osu.Game.Graphics.Sprites;
+using osu.Game.Graphics.UserInterfaceV2;
+using osu.Game.Overlays;
+using osuTK;
+using osuTK.Graphics;
+
+namespace osu.Game.Screens.Edit.Timing
+{
+    internal class WaveformComparisonDisplay : CompositeDrawable
+    {
+        private const int total_waveforms = 8;
+
+        private OsuSpriteText beatIndexText = null!;
+
+        private readonly BindableNumber<double> beatLength = new BindableDouble();
+
+        [Resolved]
+        private IBindable<WorkingBeatmap> beatmap { get; set; } = null!;
+
+        [Resolved]
+        private Bindable<ControlPointGroup> selectedGroup { get; set; } = null!;
+
+        [Resolved]
+        private EditorClock editorClock { get; set; } = null!;
+
+        [Resolved]
+        private OverlayColourProvider colourProvider { get; set; } = null!;
+
+        private TimingControlPoint timingPoint = TimingControlPoint.DEFAULT;
+
+        private int lastDisplayedBeatIndex;
+
+        public WaveformComparisonDisplay()
+        {
+            RelativeSizeAxes = Axes.Both;
+
+            CornerRadius = LabelledDrawable<Drawable>.CORNER_RADIUS;
+            Masking = true;
+        }
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            for (int i = 0; i < total_waveforms; i++)
+            {
+                AddInternal(new WaveformGraph
+                {
+                    RelativeSizeAxes = Axes.Both,
+                    BaseColour = colourProvider.Colour0,
+                    LowColour = colourProvider.Colour1,
+                    MidColour = colourProvider.Colour2,
+                    HighColour = colourProvider.Colour4,
+                    Waveform = beatmap.Value.Waveform,
+                    Resolution = 1,
+                    RelativePositionAxes = Axes.Both,
+                    Height = 1f / total_waveforms,
+                    Y = (float)i / total_waveforms,
+                });
+            }
+
+            AddInternal(new Circle
+            {
+                Anchor = Anchor.Centre,
+                Origin = Anchor.Centre,
+                Colour = Color4.White,
+                RelativeSizeAxes = Axes.Y,
+                Width = 3,
+            });
+
+            AddInternal(beatIndexText = new OsuSpriteText
+            {
+                Margin = new MarginPadding(5),
+            });
+
+            selectedGroup.BindValueChanged(selectedGroupChanged, true);
+            beatLength.BindValueChanged(_ => showFrom(lastDisplayedBeatIndex), true);
+        }
+
+        private void selectedGroupChanged(ValueChangedEvent<ControlPointGroup> group)
+        {
+            timingPoint = selectedGroup.Value?.ControlPoints.OfType<TimingControlPoint>().FirstOrDefault()
+                          ?? TimingControlPoint.DEFAULT;
+
+            beatLength.UnbindBindings();
+            beatLength.BindTo(timingPoint.BeatLengthBindable);
+        }
+
+        protected override bool OnHover(HoverEvent e) => true;
+
+        protected override bool OnMouseMove(MouseMoveEvent e)
+        {
+            float trackLength = (float)beatmap.Value.Track.Length;
+            int totalBeatsAvailable = (int)(trackLength / timingPoint.BeatLength);
+
+            Scheduler.AddOnce(showFrom, (int)(e.MousePosition.X / DrawWidth * totalBeatsAvailable));
+
+            return base.OnMouseMove(e);
+        }
+
+        protected override void Update()
+        {
+            base.Update();
+
+            if (!IsHovered)
+            {
+                int beatOffset = (int)Math.Max(0, ((editorClock.CurrentTime - selectedGroup.Value.Time) / timingPoint.BeatLength));
+
+                showFrom(beatOffset);
+            }
+        }
+
+        private void showFrom(int beatIndex)
+        {
+            const float visible_width = 300;
+
+            float trackLength = (float)beatmap.Value.Track.Length;
+            float scale = trackLength / visible_width;
+
+            beatIndexText.Text = beatIndex.ToString();
+
+            foreach (var waveform in InternalChildren.OfType<WaveformGraph>())
+            {
+                // offset to the required beat index.
+                float offset = (float)(selectedGroup.Value.Time + (beatIndex * timingPoint.BeatLength - (visible_width / 2))) / trackLength * scale;
+
+                waveform.X = -offset;
+                waveform.Scale = new Vector2(scale, 1);
+
+                beatIndex++;
+            }
+
+            lastDisplayedBeatIndex = beatIndex;
+        }
+    }
+}

From 7040dec013d1c050d7d1d068af770f337f2be5f7 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 23 May 2022 20:01:25 +0900
Subject: [PATCH 4986/5547] Fix disabled bindable woes by not using
 `TimingControlPoint.DEFAULT`

---
 .../Screens/Edit/Timing/WaveformComparisonDisplay.cs | 12 +++++++-----
 1 file changed, 7 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Screens/Edit/Timing/WaveformComparisonDisplay.cs b/osu.Game/Screens/Edit/Timing/WaveformComparisonDisplay.cs
index 67a1d30ebe..e410d380d6 100644
--- a/osu.Game/Screens/Edit/Timing/WaveformComparisonDisplay.cs
+++ b/osu.Game/Screens/Edit/Timing/WaveformComparisonDisplay.cs
@@ -34,7 +34,7 @@ namespace osu.Game.Screens.Edit.Timing
         private IBindable<WorkingBeatmap> beatmap { get; set; } = null!;
 
         [Resolved]
-        private Bindable<ControlPointGroup> selectedGroup { get; set; } = null!;
+        private Bindable<ControlPointGroup?> selectedGroup { get; set; } = null!;
 
         [Resolved]
         private EditorClock editorClock { get; set; } = null!;
@@ -46,6 +46,8 @@ namespace osu.Game.Screens.Edit.Timing
 
         private int lastDisplayedBeatIndex;
 
+        private double offsetZeroTime => selectedGroup.Value?.Time ?? 0;
+
         public WaveformComparisonDisplay()
         {
             RelativeSizeAxes = Axes.Both;
@@ -93,10 +95,10 @@ namespace osu.Game.Screens.Edit.Timing
             beatLength.BindValueChanged(_ => showFrom(lastDisplayedBeatIndex), true);
         }
 
-        private void selectedGroupChanged(ValueChangedEvent<ControlPointGroup> group)
+        private void selectedGroupChanged(ValueChangedEvent<ControlPointGroup?> group)
         {
             timingPoint = selectedGroup.Value?.ControlPoints.OfType<TimingControlPoint>().FirstOrDefault()
-                          ?? TimingControlPoint.DEFAULT;
+                          ?? new TimingControlPoint();
 
             beatLength.UnbindBindings();
             beatLength.BindTo(timingPoint.BeatLengthBindable);
@@ -120,7 +122,7 @@ namespace osu.Game.Screens.Edit.Timing
 
             if (!IsHovered)
             {
-                int beatOffset = (int)Math.Max(0, ((editorClock.CurrentTime - selectedGroup.Value.Time) / timingPoint.BeatLength));
+                int beatOffset = (int)Math.Max(0, ((editorClock.CurrentTime - offsetZeroTime) / timingPoint.BeatLength));
 
                 showFrom(beatOffset);
             }
@@ -138,7 +140,7 @@ namespace osu.Game.Screens.Edit.Timing
             foreach (var waveform in InternalChildren.OfType<WaveformGraph>())
             {
                 // offset to the required beat index.
-                float offset = (float)(selectedGroup.Value.Time + (beatIndex * timingPoint.BeatLength - (visible_width / 2))) / trackLength * scale;
+                float offset = (float)(offsetZeroTime + (beatIndex * timingPoint.BeatLength - (visible_width / 2))) / trackLength * scale;
 
                 waveform.X = -offset;
                 waveform.Scale = new Vector2(scale, 1);

From c1720c128d1f591281194b4b76744ea7dcefd7cd Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 23 May 2022 21:00:21 +0900
Subject: [PATCH 4987/5547] Dim rows which are not part of the active control
 point (and offset centre)

---
 .../Edit/Timing/WaveformComparisonDisplay.cs  | 55 ++++++++++++++++---
 1 file changed, 46 insertions(+), 9 deletions(-)

diff --git a/osu.Game/Screens/Edit/Timing/WaveformComparisonDisplay.cs b/osu.Game/Screens/Edit/Timing/WaveformComparisonDisplay.cs
index e410d380d6..2667ae5396 100644
--- a/osu.Game/Screens/Edit/Timing/WaveformComparisonDisplay.cs
+++ b/osu.Game/Screens/Edit/Timing/WaveformComparisonDisplay.cs
@@ -33,6 +33,9 @@ namespace osu.Game.Screens.Edit.Timing
         [Resolved]
         private IBindable<WorkingBeatmap> beatmap { get; set; } = null!;
 
+        [Resolved]
+        private EditorBeatmap editorBeatmap { get; set; } = null!;
+
         [Resolved]
         private Bindable<ControlPointGroup?> selectedGroup { get; set; } = null!;
 
@@ -46,7 +49,10 @@ namespace osu.Game.Screens.Edit.Timing
 
         private int lastDisplayedBeatIndex;
 
-        private double offsetZeroTime => selectedGroup.Value?.Time ?? 0;
+        private double selectedGroupStartTime;
+        private double selectedGroupEndTime;
+
+        private readonly BindableList<ControlPointGroup> controlPointGroups = new BindableList<ControlPointGroup>();
 
         public WaveformComparisonDisplay()
         {
@@ -88,20 +94,45 @@ namespace osu.Game.Screens.Edit.Timing
 
             AddInternal(beatIndexText = new OsuSpriteText
             {
-                Margin = new MarginPadding(5),
+                Anchor = Anchor.CentreLeft,
+                Margin = new MarginPadding(4),
             });
 
-            selectedGroup.BindValueChanged(selectedGroupChanged, true);
+            selectedGroup.BindValueChanged(_ => updateTimingGroup(), true);
+
+            ((IBindableList<ControlPointGroup>)controlPointGroups).BindTo(editorBeatmap.ControlPointInfo.Groups);
+            controlPointGroups.BindCollectionChanged((_, __) => updateTimingGroup());
+
             beatLength.BindValueChanged(_ => showFrom(lastDisplayedBeatIndex), true);
         }
 
-        private void selectedGroupChanged(ValueChangedEvent<ControlPointGroup?> group)
+        private void updateTimingGroup()
         {
-            timingPoint = selectedGroup.Value?.ControlPoints.OfType<TimingControlPoint>().FirstOrDefault()
-                          ?? new TimingControlPoint();
-
             beatLength.UnbindBindings();
+
+            selectedGroupStartTime = 0;
+            selectedGroupEndTime = beatmap.Value.Track.Length;
+
+            var tcp = selectedGroup.Value?.ControlPoints.OfType<TimingControlPoint>().FirstOrDefault();
+
+            if (tcp == null)
+            {
+                timingPoint = new TimingControlPoint();
+                return;
+            }
+
+            timingPoint = tcp;
             beatLength.BindTo(timingPoint.BeatLengthBindable);
+
+            selectedGroupStartTime = selectedGroup.Value?.Time ?? 0;
+
+            var nextGroup = editorBeatmap.ControlPointInfo.TimingPoints
+                                         .SkipWhile(g => g != tcp)
+                                         .Skip(1)
+                                         .FirstOrDefault();
+
+            if (nextGroup != null)
+                selectedGroupEndTime = nextGroup.Time;
         }
 
         protected override bool OnHover(HoverEvent e) => true;
@@ -122,7 +153,7 @@ namespace osu.Game.Screens.Edit.Timing
 
             if (!IsHovered)
             {
-                int beatOffset = (int)Math.Max(0, ((editorClock.CurrentTime - offsetZeroTime) / timingPoint.BeatLength));
+                int beatOffset = (int)Math.Floor((editorClock.CurrentTimeAccurate - selectedGroupStartTime) / timingPoint.BeatLength);
 
                 showFrom(beatOffset);
             }
@@ -137,11 +168,17 @@ namespace osu.Game.Screens.Edit.Timing
 
             beatIndexText.Text = beatIndex.ToString();
 
+            // Start displaying from before the current beat
+            beatIndex -= total_waveforms / 2;
+
             foreach (var waveform in InternalChildren.OfType<WaveformGraph>())
             {
                 // offset to the required beat index.
-                float offset = (float)(offsetZeroTime + (beatIndex * timingPoint.BeatLength - (visible_width / 2))) / trackLength * scale;
+                double time = selectedGroupStartTime + beatIndex * timingPoint.BeatLength;
 
+                float offset = (float)(time - visible_width / 2) / trackLength * scale;
+
+                waveform.Alpha = time < selectedGroupStartTime || time > selectedGroupEndTime ? 0.2f : 1;
                 waveform.X = -offset;
                 waveform.Scale = new Vector2(scale, 1);
 

From 4fcdcef166b5089fd9403011d2f8ae3405308059 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 23 May 2022 21:32:55 +0900
Subject: [PATCH 4988/5547] Add indexing on each wavefrom row

---
 .../Edit/Timing/WaveformComparisonDisplay.cs  | 72 ++++++++++++-------
 1 file changed, 46 insertions(+), 26 deletions(-)

diff --git a/osu.Game/Screens/Edit/Timing/WaveformComparisonDisplay.cs b/osu.Game/Screens/Edit/Timing/WaveformComparisonDisplay.cs
index 2667ae5396..ad4e1e737d 100644
--- a/osu.Game/Screens/Edit/Timing/WaveformComparisonDisplay.cs
+++ b/osu.Game/Screens/Edit/Timing/WaveformComparisonDisplay.cs
@@ -26,8 +26,6 @@ namespace osu.Game.Screens.Edit.Timing
     {
         private const int total_waveforms = 8;
 
-        private OsuSpriteText beatIndexText = null!;
-
         private readonly BindableNumber<double> beatLength = new BindableDouble();
 
         [Resolved]
@@ -42,9 +40,6 @@ namespace osu.Game.Screens.Edit.Timing
         [Resolved]
         private EditorClock editorClock { get; set; } = null!;
 
-        [Resolved]
-        private OverlayColourProvider colourProvider { get; set; } = null!;
-
         private TimingControlPoint timingPoint = TimingControlPoint.DEFAULT;
 
         private int lastDisplayedBeatIndex;
@@ -68,15 +63,9 @@ namespace osu.Game.Screens.Edit.Timing
 
             for (int i = 0; i < total_waveforms; i++)
             {
-                AddInternal(new WaveformGraph
+                AddInternal(new WaveformRow
                 {
                     RelativeSizeAxes = Axes.Both,
-                    BaseColour = colourProvider.Colour0,
-                    LowColour = colourProvider.Colour1,
-                    MidColour = colourProvider.Colour2,
-                    HighColour = colourProvider.Colour4,
-                    Waveform = beatmap.Value.Waveform,
-                    Resolution = 1,
                     RelativePositionAxes = Axes.Both,
                     Height = 1f / total_waveforms,
                     Y = (float)i / total_waveforms,
@@ -92,12 +81,6 @@ namespace osu.Game.Screens.Edit.Timing
                 Width = 3,
             });
 
-            AddInternal(beatIndexText = new OsuSpriteText
-            {
-                Anchor = Anchor.CentreLeft,
-                Margin = new MarginPadding(4),
-            });
-
             selectedGroup.BindValueChanged(_ => updateTimingGroup(), true);
 
             ((IBindableList<ControlPointGroup>)controlPointGroups).BindTo(editorBeatmap.ControlPointInfo.Groups);
@@ -166,26 +149,63 @@ namespace osu.Game.Screens.Edit.Timing
             float trackLength = (float)beatmap.Value.Track.Length;
             float scale = trackLength / visible_width;
 
-            beatIndexText.Text = beatIndex.ToString();
-
             // Start displaying from before the current beat
             beatIndex -= total_waveforms / 2;
 
-            foreach (var waveform in InternalChildren.OfType<WaveformGraph>())
+            foreach (var row in InternalChildren.OfType<WaveformRow>())
             {
                 // offset to the required beat index.
                 double time = selectedGroupStartTime + beatIndex * timingPoint.BeatLength;
 
                 float offset = (float)(time - visible_width / 2) / trackLength * scale;
 
-                waveform.Alpha = time < selectedGroupStartTime || time > selectedGroupEndTime ? 0.2f : 1;
-                waveform.X = -offset;
-                waveform.Scale = new Vector2(scale, 1);
-
-                beatIndex++;
+                row.Alpha = time < selectedGroupStartTime || time > selectedGroupEndTime ? 0.2f : 1;
+                row.WaveformOffset = -offset;
+                row.WaveformScale = new Vector2(scale, 1);
+                row.BeatIndex = beatIndex++;
             }
 
             lastDisplayedBeatIndex = beatIndex;
         }
+
+        internal class WaveformRow : CompositeDrawable
+        {
+            private OsuSpriteText beatIndexText = null!;
+            private WaveformGraph waveformGraph = null!;
+
+            [Resolved]
+            private OverlayColourProvider colourProvider { get; set; } = null!;
+
+            [BackgroundDependencyLoader]
+            private void load(IBindable<WorkingBeatmap> beatmap)
+            {
+                InternalChildren = new Drawable[]
+                {
+                    waveformGraph = new WaveformGraph
+                    {
+                        RelativeSizeAxes = Axes.Both,
+                        RelativePositionAxes = Axes.Both,
+                        Waveform = beatmap.Value.Waveform,
+                        Resolution = 1,
+
+                        BaseColour = colourProvider.Colour0,
+                        LowColour = colourProvider.Colour1,
+                        MidColour = colourProvider.Colour2,
+                        HighColour = colourProvider.Colour4,
+                    },
+                    beatIndexText = new OsuSpriteText
+                    {
+                        Anchor = Anchor.CentreLeft,
+                        Origin = Anchor.CentreLeft,
+                        Padding = new MarginPadding(5),
+                        Colour = colourProvider.Content2
+                    }
+                };
+            }
+
+            public int BeatIndex { set => beatIndexText.Text = value.ToString(); }
+            public Vector2 WaveformScale { set => waveformGraph.Scale = value; }
+            public float WaveformOffset { set => waveformGraph.X = value; }
+        }
     }
 }

From 49a21736464330baf0333ff5bfec2461885edd50 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 24 May 2022 14:33:05 +0900
Subject: [PATCH 4989/5547] Avoid needlessly updating display (and add better
 documentation on chosen scale)

---
 .../Screens/Edit/Timing/WaveformComparisonDisplay.cs  | 11 +++++++++--
 1 file changed, 9 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/Edit/Timing/WaveformComparisonDisplay.cs b/osu.Game/Screens/Edit/Timing/WaveformComparisonDisplay.cs
index ad4e1e737d..0830ba8cf4 100644
--- a/osu.Game/Screens/Edit/Timing/WaveformComparisonDisplay.cs
+++ b/osu.Game/Screens/Edit/Timing/WaveformComparisonDisplay.cs
@@ -136,14 +136,21 @@ namespace osu.Game.Screens.Edit.Timing
 
             if (!IsHovered)
             {
-                int beatOffset = (int)Math.Floor((editorClock.CurrentTimeAccurate - selectedGroupStartTime) / timingPoint.BeatLength);
+                int currentBeat = (int)Math.Floor((editorClock.CurrentTimeAccurate - selectedGroupStartTime) / timingPoint.BeatLength);
 
-                showFrom(beatOffset);
+                showFrom(currentBeat);
             }
         }
 
         private void showFrom(int beatIndex)
         {
+            if (lastDisplayedBeatIndex == beatIndex)
+                return;
+
+            // Chosen as a pretty usable number across all BPMs.
+            // Optimally we'd want this to scale with the BPM in question, but performing
+            // scaling of the display is both expensive in resampling, and decreases usability
+            // (as it is harder to track the waveform when making realtime adjustments).
             const float visible_width = 300;
 
             float trackLength = (float)beatmap.Value.Track.Length;

From 1137545d4ab4d59e58891a5171932d900120cd2d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 24 May 2022 16:02:01 +0900
Subject: [PATCH 4990/5547] Fix `Timeline` potentially not updating visuals to
 correct state on first display

---
 .../Screens/Edit/Compose/Components/Timeline/Timeline.cs     | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/Timeline.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/Timeline.cs
index 992ab7947e..6812bbb72d 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/Timeline.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/Timeline.cs
@@ -163,10 +163,11 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
         {
             base.LoadComplete();
 
+            WaveformVisible.BindValueChanged(_ => updateWaveformOpacity());
             waveformOpacity.BindValueChanged(_ => updateWaveformOpacity(), true);
 
-            WaveformVisible.ValueChanged += _ => updateWaveformOpacity();
-            TicksVisible.ValueChanged += visible => ticks.FadeTo(visible.NewValue ? 1 : 0, 200, Easing.OutQuint);
+            TicksVisible.BindValueChanged(visible => ticks.FadeTo(visible.NewValue ? 1 : 0, 200, Easing.OutQuint), true);
+
             ControlPointsVisible.BindValueChanged(visible =>
             {
                 if (visible.NewValue)

From f00dd27fcdd762eccdec2ec780d427c0da023518 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 24 May 2022 17:50:23 +0900
Subject: [PATCH 4991/5547] Move `OverlayColourProvider` provisioning of
 `RoundedButton` to `SettingsButton` for now

---
 osu.Game/Graphics/UserInterfaceV2/RoundedButton.cs | 9 +++++----
 osu.Game/Overlays/Settings/SettingsButton.cs       | 9 +++++++++
 2 files changed, 14 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Graphics/UserInterfaceV2/RoundedButton.cs b/osu.Game/Graphics/UserInterfaceV2/RoundedButton.cs
index 3c0c3b69e8..cb8c63371d 100644
--- a/osu.Game/Graphics/UserInterfaceV2/RoundedButton.cs
+++ b/osu.Game/Graphics/UserInterfaceV2/RoundedButton.cs
@@ -2,13 +2,11 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System.Collections.Generic;
-using JetBrains.Annotations;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Localisation;
 using osu.Game.Graphics.UserInterface;
-using osu.Game.Overlays;
 
 namespace osu.Game.Graphics.UserInterfaceV2
 {
@@ -27,9 +25,12 @@ namespace osu.Game.Graphics.UserInterfaceV2
         }
 
         [BackgroundDependencyLoader(true)]
-        private void load([CanBeNull] OverlayColourProvider overlayColourProvider, OsuColour colours)
+        private void load(OsuColour colours)
         {
-            DefaultBackgroundColour = overlayColourProvider?.Highlight1 ?? colours.Blue3;
+            // According to flyte, buttons are supposed to have explicit colours for now.
+            // Not sure this is the correct direction, but we haven't decided on an `OverlayColourProvider` stand-in yet.
+            // This is a better default. See `SettingsButton` for an override which uses `OverlayColourProvider`.
+            DefaultBackgroundColour = colours.Blue3;
         }
 
         protected override void LoadComplete()
diff --git a/osu.Game/Overlays/Settings/SettingsButton.cs b/osu.Game/Overlays/Settings/SettingsButton.cs
index 10aea92b22..9e4dc763ec 100644
--- a/osu.Game/Overlays/Settings/SettingsButton.cs
+++ b/osu.Game/Overlays/Settings/SettingsButton.cs
@@ -3,9 +3,12 @@
 
 using System.Collections.Generic;
 using System.Linq;
+using JetBrains.Annotations;
+using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Cursor;
 using osu.Framework.Localisation;
+using osu.Game.Graphics;
 using osu.Game.Graphics.UserInterfaceV2;
 
 namespace osu.Game.Overlays.Settings
@@ -18,6 +21,12 @@ namespace osu.Game.Overlays.Settings
             Padding = new MarginPadding { Left = SettingsPanel.CONTENT_MARGINS, Right = SettingsPanel.CONTENT_MARGINS };
         }
 
+        [BackgroundDependencyLoader(true)]
+        private void load([CanBeNull] OverlayColourProvider overlayColourProvider, OsuColour colours)
+        {
+            DefaultBackgroundColour = overlayColourProvider?.Highlight1 ?? colours.Blue3;
+        }
+
         public LocalisableString TooltipText { get; set; }
 
         public override IEnumerable<LocalisableString> FilterTerms

From a346990a8c7a3b9986d8c712ea4be568e6cf9bec Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 24 May 2022 16:02:08 +0900
Subject: [PATCH 4992/5547] Remove `TriangleButton` usage in editor

---
 osu.Game/Screens/Edit/Timing/GroupSection.cs | 4 ++--
 osu.Game/Screens/Edit/Timing/TimingScreen.cs | 5 +++--
 osu.Game/Screens/Edit/Verify/IssueList.cs    | 4 ++--
 3 files changed, 7 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Screens/Edit/Timing/GroupSection.cs b/osu.Game/Screens/Edit/Timing/GroupSection.cs
index 03059ff6e1..bb2dd35a9c 100644
--- a/osu.Game/Screens/Edit/Timing/GroupSection.cs
+++ b/osu.Game/Screens/Edit/Timing/GroupSection.cs
@@ -17,7 +17,7 @@ namespace osu.Game.Screens.Edit.Timing
     {
         private LabelledTextBox textBox;
 
-        private TriangleButton button;
+        private OsuButton button;
 
         [Resolved]
         protected Bindable<ControlPointGroup> SelectedGroup { get; private set; }
@@ -53,7 +53,7 @@ namespace osu.Game.Screens.Edit.Timing
                         {
                             Label = "Time"
                         },
-                        button = new TriangleButton
+                        button = new RoundedButton
                         {
                             Text = "Use current time",
                             RelativeSizeAxes = Axes.X,
diff --git a/osu.Game/Screens/Edit/Timing/TimingScreen.cs b/osu.Game/Screens/Edit/Timing/TimingScreen.cs
index a4193d5084..5f1fd14617 100644
--- a/osu.Game/Screens/Edit/Timing/TimingScreen.cs
+++ b/osu.Game/Screens/Edit/Timing/TimingScreen.cs
@@ -10,6 +10,7 @@ using osu.Framework.Graphics.Shapes;
 using osu.Game.Beatmaps.ControlPoints;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.UserInterface;
+using osu.Game.Graphics.UserInterfaceV2;
 using osu.Game.Overlays;
 using osuTK;
 
@@ -100,7 +101,7 @@ namespace osu.Game.Screens.Edit.Timing
                         Spacing = new Vector2(5),
                         Children = new Drawable[]
                         {
-                            deleteButton = new OsuButton
+                            deleteButton = new RoundedButton
                             {
                                 Text = "-",
                                 Size = new Vector2(30, 30),
@@ -108,7 +109,7 @@ namespace osu.Game.Screens.Edit.Timing
                                 Anchor = Anchor.BottomRight,
                                 Origin = Anchor.BottomRight,
                             },
-                            new OsuButton
+                            new RoundedButton
                             {
                                 Text = "+ Add at current time",
                                 Action = addNew,
diff --git a/osu.Game/Screens/Edit/Verify/IssueList.cs b/osu.Game/Screens/Edit/Verify/IssueList.cs
index 5fe43199cc..415acc0e22 100644
--- a/osu.Game/Screens/Edit/Verify/IssueList.cs
+++ b/osu.Game/Screens/Edit/Verify/IssueList.cs
@@ -10,7 +10,7 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
 using osu.Game.Beatmaps;
 using osu.Game.Graphics.Containers;
-using osu.Game.Graphics.UserInterface;
+using osu.Game.Graphics.UserInterfaceV2;
 using osu.Game.Overlays;
 using osu.Game.Rulesets.Edit;
 using osu.Game.Rulesets.Edit.Checks.Components;
@@ -67,7 +67,7 @@ namespace osu.Game.Screens.Edit.Verify
                     Margin = new MarginPadding(20),
                     Children = new Drawable[]
                     {
-                        new TriangleButton
+                        new RoundedButton
                         {
                             Text = "Refresh",
                             Action = refresh,

From 4a88affd036f505c67e2ddbebdbb5e41ed1db339 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 24 May 2022 17:02:19 +0900
Subject: [PATCH 4993/5547] Move beat divisor tick size retrieval to static
 methods

---
 osu.Game/Screens/Edit/BindableBeatDivisor.cs  | 27 +++++++++
 .../Timeline/TimelineTickDisplay.cs           | 58 +++----------------
 2 files changed, 35 insertions(+), 50 deletions(-)

diff --git a/osu.Game/Screens/Edit/BindableBeatDivisor.cs b/osu.Game/Screens/Edit/BindableBeatDivisor.cs
index af958e3448..8f430dce77 100644
--- a/osu.Game/Screens/Edit/BindableBeatDivisor.cs
+++ b/osu.Game/Screens/Edit/BindableBeatDivisor.cs
@@ -5,6 +5,7 @@ using System.Linq;
 using osu.Framework.Bindables;
 using osu.Game.Graphics;
 using osu.Game.Screens.Edit.Compose.Components;
+using osuTK;
 using osuTK.Graphics;
 
 namespace osu.Game.Screens.Edit
@@ -100,6 +101,32 @@ namespace osu.Game.Screens.Edit
             }
         }
 
+        /// <summary>
+        /// Get a relative display size for the specified divisor.
+        /// </summary>
+        /// <param name="beatDivisor">The beat divisor.</param>
+        /// <returns>A relative size which can be used to display ticks.</returns>
+        public static Vector2 GetSize(int beatDivisor)
+        {
+            switch (beatDivisor)
+            {
+                case 1:
+                case 2:
+                    return new Vector2(0.6f, 0.9f);
+
+                case 3:
+                case 4:
+                    return new Vector2(0.5f, 0.8f);
+
+                case 6:
+                case 8:
+                    return new Vector2(0.4f, 0.7f);
+
+                default:
+                    return new Vector2(0.3f, 0.6f);
+            }
+        }
+
         /// <summary>
         /// Retrieves the applicable divisor for a specific beat index.
         /// </summary>
diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineTickDisplay.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineTickDisplay.cs
index 3a32dc18e5..fda8416ecd 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineTickDisplay.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineTickDisplay.cs
@@ -11,6 +11,7 @@ using osu.Game.Beatmaps;
 using osu.Game.Graphics;
 using osu.Game.Screens.Edit.Components.Timelines.Summary.Parts;
 using osu.Game.Screens.Edit.Components.Timelines.Summary.Visualisations;
+using osuTK;
 
 namespace osu.Game.Screens.Edit.Compose.Components.Timeline
 {
@@ -132,10 +133,15 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
 
                         // even though "bar lines" take up the full vertical space, we render them in two pieces because it allows for less anchor/origin churn.
 
+                        Vector2 size = Vector2.One;
+
+                        if (indexInBar != 1)
+                            size = BindableBeatDivisor.GetSize(divisor);
+
                         var line = getNextUsableLine();
                         line.X = xPos;
-                        line.Width = PointVisualisation.MAX_WIDTH * getWidth(indexInBar, divisor);
-                        line.Height = 0.9f * getHeight(indexInBar, divisor);
+                        line.Width = PointVisualisation.MAX_WIDTH * size.X;
+                        line.Height = 0.9f * size.Y;
                         line.Colour = colour;
                     }
 
@@ -170,54 +176,6 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
             }
         }
 
-        private static float getWidth(int indexInBar, int divisor)
-        {
-            if (indexInBar == 0)
-                return 1;
-
-            switch (divisor)
-            {
-                case 1:
-                case 2:
-                    return 0.6f;
-
-                case 3:
-                case 4:
-                    return 0.5f;
-
-                case 6:
-                case 8:
-                    return 0.4f;
-
-                default:
-                    return 0.3f;
-            }
-        }
-
-        private static float getHeight(int indexInBar, int divisor)
-        {
-            if (indexInBar == 0)
-                return 1;
-
-            switch (divisor)
-            {
-                case 1:
-                case 2:
-                    return 0.9f;
-
-                case 3:
-                case 4:
-                    return 0.8f;
-
-                case 6:
-                case 8:
-                    return 0.7f;
-
-                default:
-                    return 0.6f;
-            }
-        }
-
         protected override void Dispose(bool isDisposing)
         {
             base.Dispose(isDisposing);

From e6087f5f5be6c6d2038a8909564ae2bd3fc23386 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 24 May 2022 16:51:21 +0900
Subject: [PATCH 4994/5547] Handle beat divisor input on mouse down, rather
 than mouse up

It felt way too unresponsive.
---
 osu.Game/Screens/Edit/Compose/Components/BeatDivisorControl.cs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Game/Screens/Edit/Compose/Components/BeatDivisorControl.cs b/osu.Game/Screens/Edit/Compose/Components/BeatDivisorControl.cs
index 370c9016c7..9eda540b70 100644
--- a/osu.Game/Screens/Edit/Compose/Components/BeatDivisorControl.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/BeatDivisorControl.cs
@@ -453,6 +453,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
             protected override bool OnMouseDown(MouseDownEvent e)
             {
                 marker.Active = true;
+                handleMouseInput(e.ScreenSpaceMousePosition);
                 return base.OnMouseDown(e);
             }
 

From 3c2e57bf00f04cbe2ad74ba786674c986298ff7a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 24 May 2022 16:50:16 +0900
Subject: [PATCH 4995/5547] Update `BeatDivisorControl` to better match new
 designs and metrics

---
 .../Editing/TestSceneBeatDivisorControl.cs    |  5 ++
 .../Compose/Components/BeatDivisorControl.cs  | 78 ++++++-------------
 2 files changed, 28 insertions(+), 55 deletions(-)

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneBeatDivisorControl.cs b/osu.Game.Tests/Visual/Editing/TestSceneBeatDivisorControl.cs
index 6a0950c6dd..79be8a02c8 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneBeatDivisorControl.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneBeatDivisorControl.cs
@@ -5,11 +5,13 @@ using System;
 using System.Diagnostics;
 using System.Linq;
 using NUnit.Framework;
+using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Cursor;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Graphics.UserInterface;
 using osu.Framework.Testing;
+using osu.Game.Overlays;
 using osu.Game.Screens.Edit;
 using osu.Game.Screens.Edit.Compose.Components;
 using osuTK;
@@ -25,6 +27,9 @@ namespace osu.Game.Tests.Visual.Editing
         private SliderBar<int> tickSliderBar => beatDivisorControl.ChildrenOfType<SliderBar<int>>().Single();
         private EquilateralTriangle tickMarkerHead => tickSliderBar.ChildrenOfType<EquilateralTriangle>().Single();
 
+        [Cached]
+        private readonly OverlayColourProvider overlayColour = new OverlayColourProvider(OverlayColourScheme.Green);
+
         [SetUp]
         public void SetUp() => Schedule(() =>
         {
diff --git a/osu.Game/Screens/Edit/Compose/Components/BeatDivisorControl.cs b/osu.Game/Screens/Edit/Compose/Components/BeatDivisorControl.cs
index 370c9016c7..47f7f4b388 100644
--- a/osu.Game/Screens/Edit/Compose/Components/BeatDivisorControl.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/BeatDivisorControl.cs
@@ -8,9 +8,7 @@ using Humanizer;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Extensions;
-using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
-using osu.Framework.Graphics.Colour;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Cursor;
 using osu.Framework.Graphics.Shapes;
@@ -22,6 +20,7 @@ using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Graphics.UserInterfaceV2;
+using osu.Game.Overlays;
 using osuTK;
 using osuTK.Graphics;
 using osuTK.Input;
@@ -38,18 +37,17 @@ namespace osu.Game.Screens.Edit.Compose.Components
         }
 
         [BackgroundDependencyLoader]
-        private void load(OsuColour colours)
+        private void load(OverlayColourProvider colourProvider)
         {
             Masking = true;
-            CornerRadius = 5;
 
             InternalChildren = new Drawable[]
             {
                 new Box
                 {
-                    Name = "Gray Background",
+                    Name = "Main background",
                     RelativeSizeAxes = Axes.Both,
-                    Colour = colours.Gray4
+                    Colour = colourProvider.Background3,
                 },
                 new GridContainer
                 {
@@ -65,9 +63,9 @@ namespace osu.Game.Screens.Edit.Compose.Components
                                 {
                                     new Box
                                     {
-                                        Name = "Black Background",
+                                        Name = "Tick area background",
                                         RelativeSizeAxes = Axes.Both,
-                                        Colour = Color4.Black
+                                        Colour = colourProvider.Background5,
                                     },
                                     new TickSliderBar(beatDivisor)
                                     {
@@ -86,7 +84,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
                                     new Box
                                     {
                                         RelativeSizeAxes = Axes.Both,
-                                        Colour = colours.Gray4
+                                        Colour = colourProvider.Background3
                                     },
                                     new Container
                                     {
@@ -139,11 +137,6 @@ namespace osu.Game.Screens.Edit.Compose.Components
                                 RelativeSizeAxes = Axes.Both,
                                 Children = new Drawable[]
                                 {
-                                    new Box
-                                    {
-                                        RelativeSizeAxes = Axes.Both,
-                                        Colour = colours.Gray4
-                                    },
                                     new Container
                                     {
                                         RelativeSizeAxes = Axes.Both,
@@ -402,15 +395,15 @@ namespace osu.Game.Screens.Edit.Compose.Components
                 ClearInternal();
                 CurrentNumber.ValueChanged -= moveMarker;
 
-                foreach (int t in beatDivisor.ValidDivisors.Value.Presets)
+                foreach (int divisor in beatDivisor.ValidDivisors.Value.Presets)
                 {
-                    AddInternal(new Tick
+                    AddInternal(new Tick(divisor)
                     {
-                        Anchor = Anchor.TopLeft,
-                        Origin = Anchor.TopCentre,
-                        RelativePositionAxes = Axes.X,
-                        Colour = BindableBeatDivisor.GetColourFor(t, colours),
-                        X = getMappedPosition(t)
+                        Anchor = Anchor.CentreLeft,
+                        Origin = Anchor.Centre,
+                        RelativePositionAxes = Axes.Both,
+                        Colour = BindableBeatDivisor.GetColourFor(divisor, colours),
+                        X = getMappedPosition(divisor),
                     });
                 }
 
@@ -422,7 +415,6 @@ namespace osu.Game.Screens.Edit.Compose.Components
             private void moveMarker(ValueChangedEvent<int> divisor)
             {
                 marker.MoveToX(getMappedPosition(divisor.NewValue), 100, Easing.OutQuint);
-                marker.Flash();
             }
 
             protected override void UpdateValue(float value)
@@ -489,29 +481,26 @@ namespace osu.Game.Screens.Edit.Compose.Components
 
             private float getMappedPosition(float divisor) => MathF.Pow((divisor - 1) / (beatDivisor.ValidDivisors.Value.Presets.Last() - 1), 0.90f);
 
-            private class Tick : CompositeDrawable
+            private class Tick : Circle
             {
-                public Tick()
+                public Tick(int divisor)
                 {
-                    Size = new Vector2(2.5f, 10);
-
+                    Size = new Vector2(6f, 12) * BindableBeatDivisor.GetSize(divisor);
                     InternalChild = new Box { RelativeSizeAxes = Axes.Both };
-
-                    CornerRadius = 0.5f;
-                    Masking = true;
                 }
             }
 
             private class Marker : CompositeDrawable
             {
-                private Color4 defaultColour;
+                [Resolved]
+                private OverlayColourProvider colourProvider { get; set; }
 
-                private const float size = 7;
+                private const float size = 10;
 
                 [BackgroundDependencyLoader]
-                private void load(OsuColour colours)
+                private void load()
                 {
-                    Colour = defaultColour = colours.Gray4;
+                    Colour = colourProvider.Background3;
                     Anchor = Anchor.TopLeft;
                     Origin = Anchor.TopCentre;
 
@@ -521,15 +510,6 @@ namespace osu.Game.Screens.Edit.Compose.Components
 
                     InternalChildren = new Drawable[]
                     {
-                        new Box
-                        {
-                            Width = 2,
-                            RelativeSizeAxes = Axes.Y,
-                            Origin = Anchor.BottomCentre,
-                            Anchor = Anchor.BottomCentre,
-                            Colour = ColourInfo.GradientVertical(Color4.White.Opacity(0.2f), Color4.White),
-                            Blending = BlendingParameters.Additive,
-                        },
                         new EquilateralTriangle
                         {
                             Origin = Anchor.BottomCentre,
@@ -548,22 +528,10 @@ namespace osu.Game.Screens.Edit.Compose.Components
                     get => active;
                     set
                     {
-                        this.FadeColour(value ? Color4.White : defaultColour, 500, Easing.OutQuint);
+                        this.FadeColour(value ? colourProvider.Background1 : colourProvider.Background3, 500, Easing.OutQuint);
                         active = value;
                     }
                 }
-
-                public void Flash()
-                {
-                    bool wasActive = active;
-
-                    Active = true;
-
-                    if (wasActive) return;
-
-                    using (BeginDelayedSequence(50))
-                        Active = false;
-                }
             }
         }
     }

From 3ace5f135e826ae73e7e5630ae7a369f5ee7d6fc Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 24 May 2022 18:25:57 +0900
Subject: [PATCH 4996/5547] Adjust marker to match design proportions

---
 .../Compose/Components/BeatDivisorControl.cs     | 16 ++++++----------
 1 file changed, 6 insertions(+), 10 deletions(-)

diff --git a/osu.Game/Screens/Edit/Compose/Components/BeatDivisorControl.cs b/osu.Game/Screens/Edit/Compose/Components/BeatDivisorControl.cs
index 47f7f4b388..e3c862f91b 100644
--- a/osu.Game/Screens/Edit/Compose/Components/BeatDivisorControl.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/BeatDivisorControl.cs
@@ -495,26 +495,22 @@ namespace osu.Game.Screens.Edit.Compose.Components
                 [Resolved]
                 private OverlayColourProvider colourProvider { get; set; }
 
-                private const float size = 10;
-
                 [BackgroundDependencyLoader]
                 private void load()
                 {
                     Colour = colourProvider.Background3;
-                    Anchor = Anchor.TopLeft;
-                    Origin = Anchor.TopCentre;
+                    Anchor = Anchor.BottomLeft;
+                    Origin = Anchor.BottomCentre;
+
+                    Size = new Vector2(8, 6.5f);
 
-                    Width = size;
-                    RelativeSizeAxes = Axes.Y;
                     RelativePositionAxes = Axes.X;
 
                     InternalChildren = new Drawable[]
                     {
-                        new EquilateralTriangle
+                        new Triangle
                         {
-                            Origin = Anchor.BottomCentre,
-                            Anchor = Anchor.BottomCentre,
-                            Height = size,
+                            RelativeSizeAxes = Axes.Both,
                             EdgeSmoothness = new Vector2(1),
                             Colour = Color4.White,
                         }

From bb82abe48d81d596946d1781d0621c1bbf5f18da Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 24 May 2022 18:38:08 +0900
Subject: [PATCH 4997/5547] Update test to use new triangle type resolution

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

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneBeatDivisorControl.cs b/osu.Game.Tests/Visual/Editing/TestSceneBeatDivisorControl.cs
index 79be8a02c8..cdd1175692 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneBeatDivisorControl.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneBeatDivisorControl.cs
@@ -25,7 +25,7 @@ namespace osu.Game.Tests.Visual.Editing
         private BindableBeatDivisor bindableBeatDivisor;
 
         private SliderBar<int> tickSliderBar => beatDivisorControl.ChildrenOfType<SliderBar<int>>().Single();
-        private EquilateralTriangle tickMarkerHead => tickSliderBar.ChildrenOfType<EquilateralTriangle>().Single();
+        private Triangle tickMarkerHead => tickSliderBar.ChildrenOfType<Triangle>().Single();
 
         [Cached]
         private readonly OverlayColourProvider overlayColour = new OverlayColourProvider(OverlayColourScheme.Green);

From 33fd1555f23a45c4d325c4db4d4d2aa643a6c0c1 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 24 May 2022 18:42:40 +0900
Subject: [PATCH 4998/5547] Update `TestSceneRoundedButton` with new colour
 assertions

---
 .../UserInterface/TestSceneRoundedButton.cs   | 37 +++++++++++++++----
 1 file changed, 29 insertions(+), 8 deletions(-)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneRoundedButton.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneRoundedButton.cs
index f45c55d912..454a71e6d2 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneRoundedButton.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneRoundedButton.cs
@@ -5,9 +5,12 @@ using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
 using osu.Framework.Testing;
+using osu.Game.Graphics;
 using osu.Game.Graphics.UserInterfaceV2;
 using osu.Game.Overlays;
+using osu.Game.Overlays.Settings;
 
 namespace osu.Game.Tests.Visual.UserInterface
 {
@@ -15,14 +18,31 @@ namespace osu.Game.Tests.Visual.UserInterface
     {
         private readonly BindableBool enabled = new BindableBool(true);
 
-        protected override Drawable CreateContent() => new RoundedButton
+        protected override Drawable CreateContent()
         {
-            Width = 400,
-            Text = "Test button",
-            Anchor = Anchor.Centre,
-            Origin = Anchor.Centre,
-            Enabled = { BindTarget = enabled },
-        };
+            return new FillFlowContainer
+            {
+                RelativeSizeAxes = Axes.Both,
+                Children = new Drawable[]
+                {
+                    new RoundedButton
+                    {
+                        Width = 400,
+                        Text = "Test button",
+                        Anchor = Anchor.Centre,
+                        Origin = Anchor.Centre,
+                        Enabled = { BindTarget = enabled },
+                    },
+                    new SettingsButton
+                    {
+                        Text = "Test button",
+                        Anchor = Anchor.Centre,
+                        Origin = Anchor.Centre,
+                        Enabled = { BindTarget = enabled },
+                    },
+                }
+            };
+        }
 
         [Test]
         public void TestDisabled()
@@ -34,7 +54,8 @@ namespace osu.Game.Tests.Visual.UserInterface
         public void TestBackgroundColour()
         {
             AddStep("set red scheme", () => CreateThemedContent(OverlayColourScheme.Red));
-            AddAssert("first button has correct colour", () => Cell(0, 1).ChildrenOfType<RoundedButton>().First().BackgroundColour == new OverlayColourProvider(OverlayColourScheme.Red).Highlight1);
+            AddAssert("rounded button has correct colour", () => Cell(0, 1).ChildrenOfType<RoundedButton>().First().BackgroundColour == new OsuColour().Blue3);
+            AddAssert("settings button has correct colour", () => Cell(0, 1).ChildrenOfType<SettingsButton>().First().BackgroundColour == new OverlayColourProvider(OverlayColourScheme.Red).Highlight1);
         }
     }
 }

From 17206bbebf4635a635b612255ec8112466dd14c5 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 24 May 2022 16:15:24 +0900
Subject: [PATCH 4999/5547] Update screen padding and colouring to better match
 new designs

---
 .../Edit/DistancedHitObjectComposer.cs        |  2 +-
 osu.Game/Rulesets/Edit/HitObjectComposer.cs   |  4 +--
 .../Screens/Edit/EditorScreenWithTimeline.cs  | 13 ++-----
 osu.Game/Screens/Edit/Timing/TimingScreen.cs  | 36 +++++++++----------
 4 files changed, 22 insertions(+), 33 deletions(-)

diff --git a/osu.Game/Rulesets/Edit/DistancedHitObjectComposer.cs b/osu.Game/Rulesets/Edit/DistancedHitObjectComposer.cs
index 5e6d9dbe34..7019dad803 100644
--- a/osu.Game/Rulesets/Edit/DistancedHitObjectComposer.cs
+++ b/osu.Game/Rulesets/Edit/DistancedHitObjectComposer.cs
@@ -52,7 +52,7 @@ namespace osu.Game.Rulesets.Edit
         {
             AddInternal(RightSideToolboxContainer = new ExpandingToolboxContainer(130, 250)
             {
-                Padding = new MarginPadding { Right = 10 },
+                Padding = new MarginPadding(10),
                 Alpha = DistanceSpacingMultiplier.Disabled ? 0 : 1,
                 Anchor = Anchor.TopRight,
                 Origin = Anchor.TopRight,
diff --git a/osu.Game/Rulesets/Edit/HitObjectComposer.cs b/osu.Game/Rulesets/Edit/HitObjectComposer.cs
index f8d796a778..f6fdb228ce 100644
--- a/osu.Game/Rulesets/Edit/HitObjectComposer.cs
+++ b/osu.Game/Rulesets/Edit/HitObjectComposer.cs
@@ -114,9 +114,9 @@ namespace osu.Game.Rulesets.Edit
                                               .WithChild(BlueprintContainer = CreateBlueprintContainer())
                     }
                 },
-                new ExpandingToolboxContainer(80, 200)
+                new ExpandingToolboxContainer(90, 200)
                 {
-                    Padding = new MarginPadding { Left = 10 },
+                    Padding = new MarginPadding(10),
                     Children = new Drawable[]
                     {
                         new EditorToolboxGroup("toolbox (1-9)")
diff --git a/osu.Game/Screens/Edit/EditorScreenWithTimeline.cs b/osu.Game/Screens/Edit/EditorScreenWithTimeline.cs
index 0d59a7a1a8..5482aa4ff0 100644
--- a/osu.Game/Screens/Edit/EditorScreenWithTimeline.cs
+++ b/osu.Game/Screens/Edit/EditorScreenWithTimeline.cs
@@ -3,14 +3,13 @@
 
 using JetBrains.Annotations;
 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.Game.Graphics.UserInterface;
+using osu.Game.Overlays;
 using osu.Game.Screens.Edit.Compose.Components;
 using osu.Game.Screens.Edit.Compose.Components.Timeline;
-using osuTK.Graphics;
 
 namespace osu.Game.Screens.Edit
 {
@@ -33,7 +32,7 @@ namespace osu.Game.Screens.Edit
         private LoadingSpinner spinner;
 
         [BackgroundDependencyLoader(true)]
-        private void load([CanBeNull] BindableBeatDivisor beatDivisor)
+        private void load(OverlayColourProvider colourProvider, [CanBeNull] BindableBeatDivisor beatDivisor)
         {
             if (beatDivisor != null)
                 this.beatDivisor.BindTo(beatDivisor);
@@ -60,7 +59,7 @@ namespace osu.Game.Screens.Edit
                                 new Box
                                 {
                                     RelativeSizeAxes = Axes.Both,
-                                    Colour = Color4.Black.Opacity(0.5f)
+                                    Colour = colourProvider.Background4
                                 },
                                 new Container
                                 {
@@ -106,12 +105,6 @@ namespace osu.Game.Screens.Edit
                             Name = "Main content",
                             RelativeSizeAxes = Axes.Both,
                             Depth = float.MaxValue,
-                            Padding = new MarginPadding
-                            {
-                                Horizontal = horizontal_margins,
-                                Top = vertical_margins,
-                                Bottom = vertical_margins
-                            },
                             Child = spinner = new LoadingSpinner(true)
                             {
                                 State = { Value = Visibility.Visible },
diff --git a/osu.Game/Screens/Edit/Timing/TimingScreen.cs b/osu.Game/Screens/Edit/Timing/TimingScreen.cs
index 5f1fd14617..f71a8d7d22 100644
--- a/osu.Game/Screens/Edit/Timing/TimingScreen.cs
+++ b/osu.Game/Screens/Edit/Timing/TimingScreen.cs
@@ -16,7 +16,7 @@ using osuTK;
 
 namespace osu.Game.Screens.Edit.Timing
 {
-    public class TimingScreen : EditorRoundedScreen
+    public class TimingScreen : EditorScreenWithTimeline
     {
         [Cached]
         private Bindable<ControlPointGroup> selectedGroup = new Bindable<ControlPointGroup>();
@@ -26,27 +26,23 @@ namespace osu.Game.Screens.Edit.Timing
         {
         }
 
-        [BackgroundDependencyLoader]
-        private void load()
+        protected override Drawable CreateMainContent() => new GridContainer
         {
-            Add(new GridContainer
+            RelativeSizeAxes = Axes.Both,
+            ColumnDimensions = new[]
             {
-                RelativeSizeAxes = Axes.Both,
-                ColumnDimensions = new[]
+                new Dimension(),
+                new Dimension(GridSizeMode.Absolute, 350),
+            },
+            Content = new[]
+            {
+                new Drawable[]
                 {
-                    new Dimension(),
-                    new Dimension(GridSizeMode.Absolute, 350),
+                    new ControlPointList(),
+                    new ControlPointSettings(),
                 },
-                Content = new[]
-                {
-                    new Drawable[]
-                    {
-                        new ControlPointList(),
-                        new ControlPointSettings(),
-                    },
-                }
-            });
-        }
+            }
+        };
 
         public class ControlPointList : CompositeDrawable
         {
@@ -77,12 +73,12 @@ namespace osu.Game.Screens.Edit.Timing
                 {
                     new Box
                     {
-                        Colour = colours.Background3,
+                        Colour = colours.Background4,
                         RelativeSizeAxes = Axes.Both,
                     },
                     new Box
                     {
-                        Colour = colours.Background2,
+                        Colour = colours.Background3,
                         RelativeSizeAxes = Axes.Y,
                         Width = ControlPointTable.TIMING_COLUMN_WIDTH + margins,
                     },

From a905731053c2dfbcdab9466f0da2fe97a2cb1925 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 24 May 2022 16:32:44 +0900
Subject: [PATCH 5000/5547] Update timeline colours and paddings to match new
 designs

---
 .../Compose/Components/Timeline/TimelineArea.cs     | 13 +++++++------
 osu.Game/Screens/Edit/EditorScreenWithTimeline.cs   |  5 ++---
 2 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineArea.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineArea.cs
index 1541ceade5..4cffebc57c 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineArea.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineArea.cs
@@ -2,12 +2,12 @@
 // See the LICENCE file in the repository root for full licence text.
 
 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.Game.Graphics.UserInterface;
+using osu.Game.Overlays;
 using osuTK;
 
 namespace osu.Game.Screens.Edit.Compose.Components.Timeline
@@ -27,10 +27,9 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
         }
 
         [BackgroundDependencyLoader]
-        private void load()
+        private void load(OverlayColourProvider colourProvider)
         {
             Masking = true;
-            CornerRadius = 5;
 
             OsuCheckbox waveformCheckbox;
             OsuCheckbox controlPointsCheckbox;
@@ -41,7 +40,7 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
                 new Box
                 {
                     RelativeSizeAxes = Axes.Both,
-                    Colour = Color4Extensions.FromHex("111")
+                    Colour = colourProvider.Background5
                 },
                 new GridContainer
                 {
@@ -55,12 +54,13 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
                             {
                                 RelativeSizeAxes = Axes.Y,
                                 AutoSizeAxes = Axes.X,
+                                Name = @"Toggle controls",
                                 Children = new Drawable[]
                                 {
                                     new Box
                                     {
                                         RelativeSizeAxes = Axes.Both,
-                                        Colour = Color4Extensions.FromHex("222")
+                                        Colour = colourProvider.Background2,
                                     },
                                     new FillFlowContainer
                                     {
@@ -94,12 +94,13 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
                             {
                                 RelativeSizeAxes = Axes.Y,
                                 AutoSizeAxes = Axes.X,
+                                Name = @"Zoom controls",
                                 Children = new Drawable[]
                                 {
                                     new Box
                                     {
                                         RelativeSizeAxes = Axes.Both,
-                                        Colour = Color4Extensions.FromHex("333")
+                                        Colour = colourProvider.Background3,
                                     },
                                     new Container<TimelineButton>
                                     {
diff --git a/osu.Game/Screens/Edit/EditorScreenWithTimeline.cs b/osu.Game/Screens/Edit/EditorScreenWithTimeline.cs
index 5482aa4ff0..186a4bddb3 100644
--- a/osu.Game/Screens/Edit/EditorScreenWithTimeline.cs
+++ b/osu.Game/Screens/Edit/EditorScreenWithTimeline.cs
@@ -15,8 +15,7 @@ namespace osu.Game.Screens.Edit
 {
     public abstract class EditorScreenWithTimeline : EditorScreen
     {
-        private const float vertical_margins = 10;
-        private const float horizontal_margins = 20;
+        private const float padding = 10;
 
         private readonly BindableBeatDivisor beatDivisor = new BindableBeatDivisor();
 
@@ -66,7 +65,7 @@ namespace osu.Game.Screens.Edit
                                     Name = "Timeline content",
                                     RelativeSizeAxes = Axes.X,
                                     AutoSizeAxes = Axes.Y,
-                                    Padding = new MarginPadding { Horizontal = horizontal_margins, Vertical = vertical_margins },
+                                    Padding = new MarginPadding { Horizontal = padding, Top = padding },
                                     Child = new GridContainer
                                     {
                                         RelativeSizeAxes = Axes.X,

From 1d196262d0a06e5d03db25ca1c99082a255c341e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 24 May 2022 16:33:20 +0900
Subject: [PATCH 5001/5547] Remove unused `OnTimelineLoaded` flow

---
 osu.Game/Screens/Edit/EditorScreenWithTimeline.cs | 10 +---------
 1 file changed, 1 insertion(+), 9 deletions(-)

diff --git a/osu.Game/Screens/Edit/EditorScreenWithTimeline.cs b/osu.Game/Screens/Edit/EditorScreenWithTimeline.cs
index 186a4bddb3..0b80af68f2 100644
--- a/osu.Game/Screens/Edit/EditorScreenWithTimeline.cs
+++ b/osu.Game/Screens/Edit/EditorScreenWithTimeline.cs
@@ -125,18 +125,10 @@ namespace osu.Game.Screens.Edit
                 mainContent.Add(content);
                 content.FadeInFromZero(300, Easing.OutQuint);
 
-                LoadComponentAsync(new TimelineArea(CreateTimelineContent()), t =>
-                {
-                    timelineContainer.Add(t);
-                    OnTimelineLoaded(t);
-                });
+                LoadComponentAsync(new TimelineArea(CreateTimelineContent()), timelineContainer.Add);
             });
         }
 
-        protected virtual void OnTimelineLoaded(TimelineArea timelineArea)
-        {
-        }
-
         protected abstract Drawable CreateMainContent();
 
         protected virtual Drawable CreateTimelineContent() => new Container();

From c02ec050569e86811c1ad937a41edcbc95900451 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 24 May 2022 17:13:44 +0900
Subject: [PATCH 5002/5547] Remove remaining usage of `EditorRoundedScreen`

---
 osu.Game/Screens/Edit/EditorRoundedScreen.cs  | 53 -------------------
 osu.Game/Screens/Edit/Setup/SetupScreen.cs    | 12 ++++-
 .../Screens/Edit/Setup/SetupScreenHeader.cs   |  2 +-
 osu.Game/Screens/Edit/Setup/SetupSection.cs   |  2 +-
 osu.Game/Screens/Edit/Verify/VerifyScreen.cs  |  5 +-
 5 files changed, 14 insertions(+), 60 deletions(-)
 delete mode 100644 osu.Game/Screens/Edit/EditorRoundedScreen.cs

diff --git a/osu.Game/Screens/Edit/EditorRoundedScreen.cs b/osu.Game/Screens/Edit/EditorRoundedScreen.cs
deleted file mode 100644
index 62f40f0325..0000000000
--- a/osu.Game/Screens/Edit/EditorRoundedScreen.cs
+++ /dev/null
@@ -1,53 +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.Graphics;
-using osu.Framework.Graphics.Containers;
-using osu.Framework.Graphics.Shapes;
-using osu.Game.Overlays;
-
-namespace osu.Game.Screens.Edit
-{
-    public class EditorRoundedScreen : EditorScreen
-    {
-        public const int HORIZONTAL_PADDING = 100;
-
-        private Container roundedContent;
-
-        protected override Container<Drawable> Content => roundedContent;
-
-        public EditorRoundedScreen(EditorScreenMode mode)
-            : base(mode)
-        {
-        }
-
-        [BackgroundDependencyLoader]
-        private void load(OverlayColourProvider colourProvider)
-        {
-            base.Content.Add(new Container
-            {
-                RelativeSizeAxes = Axes.Both,
-                Padding = new MarginPadding(50),
-                Child = new Container
-                {
-                    RelativeSizeAxes = Axes.Both,
-                    Masking = true,
-                    CornerRadius = 10,
-                    Children = new Drawable[]
-                    {
-                        new Box
-                        {
-                            Colour = colourProvider.Background3,
-                            RelativeSizeAxes = Axes.Both,
-                        },
-                        roundedContent = new Container
-                        {
-                            RelativeSizeAxes = Axes.Both,
-                        },
-                    }
-                }
-            });
-        }
-    }
-}
diff --git a/osu.Game/Screens/Edit/Setup/SetupScreen.cs b/osu.Game/Screens/Edit/Setup/SetupScreen.cs
index 231d977aab..b95aabc1c4 100644
--- a/osu.Game/Screens/Edit/Setup/SetupScreen.cs
+++ b/osu.Game/Screens/Edit/Setup/SetupScreen.cs
@@ -4,11 +4,13 @@
 using System.Collections.Generic;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
+using osu.Framework.Graphics.Shapes;
 using osu.Game.Graphics.Containers;
+using osu.Game.Overlays;
 
 namespace osu.Game.Screens.Edit.Setup
 {
-    public class SetupScreen : EditorRoundedScreen
+    public class SetupScreen : EditorScreen
     {
         [Cached]
         private SectionsContainer<SetupSection> sections { get; } = new SetupScreenSectionsContainer();
@@ -22,7 +24,7 @@ namespace osu.Game.Screens.Edit.Setup
         }
 
         [BackgroundDependencyLoader]
-        private void load(EditorBeatmap beatmap)
+        private void load(EditorBeatmap beatmap, OverlayColourProvider colourProvider)
         {
             var sectionsEnumerable = new List<SetupSection>
             {
@@ -37,6 +39,12 @@ namespace osu.Game.Screens.Edit.Setup
             if (rulesetSpecificSection != null)
                 sectionsEnumerable.Add(rulesetSpecificSection);
 
+            Add(new Box
+            {
+                Colour = colourProvider.Background2,
+                RelativeSizeAxes = Axes.Both,
+            });
+
             Add(sections.With(s =>
             {
                 s.RelativeSizeAxes = Axes.Both;
diff --git a/osu.Game/Screens/Edit/Setup/SetupScreenHeader.cs b/osu.Game/Screens/Edit/Setup/SetupScreenHeader.cs
index 2d0afda001..2412f1c4ed 100644
--- a/osu.Game/Screens/Edit/Setup/SetupScreenHeader.cs
+++ b/osu.Game/Screens/Edit/Setup/SetupScreenHeader.cs
@@ -93,7 +93,7 @@ namespace osu.Game.Screens.Edit.Setup
 
             public SetupScreenTabControl()
             {
-                TabContainer.Margin = new MarginPadding { Horizontal = EditorRoundedScreen.HORIZONTAL_PADDING };
+                TabContainer.Margin = new MarginPadding { Horizontal = 100 };
 
                 AddInternal(background = new Box
                 {
diff --git a/osu.Game/Screens/Edit/Setup/SetupSection.cs b/osu.Game/Screens/Edit/Setup/SetupSection.cs
index 1dde6fb926..02bb05d227 100644
--- a/osu.Game/Screens/Edit/Setup/SetupSection.cs
+++ b/osu.Game/Screens/Edit/Setup/SetupSection.cs
@@ -40,7 +40,7 @@ namespace osu.Game.Screens.Edit.Setup
             Padding = new MarginPadding
             {
                 Vertical = 10,
-                Horizontal = EditorRoundedScreen.HORIZONTAL_PADDING
+                Horizontal = 100
             };
 
             InternalChild = new FillFlowContainer
diff --git a/osu.Game/Screens/Edit/Verify/VerifyScreen.cs b/osu.Game/Screens/Edit/Verify/VerifyScreen.cs
index 08643eb8c1..9dc5a53907 100644
--- a/osu.Game/Screens/Edit/Verify/VerifyScreen.cs
+++ b/osu.Game/Screens/Edit/Verify/VerifyScreen.cs
@@ -11,7 +11,7 @@ using osu.Game.Rulesets.Edit.Checks.Components;
 namespace osu.Game.Screens.Edit.Verify
 {
     [Cached]
-    public class VerifyScreen : EditorRoundedScreen
+    public class VerifyScreen : EditorScreen
     {
         public readonly Bindable<Issue> SelectedIssue = new Bindable<Issue>();
 
@@ -32,7 +32,6 @@ namespace osu.Game.Screens.Edit.Verify
             InterpretedDifficulty.Default = BeatmapDifficultyCache.GetDifficultyRating(EditorBeatmap.BeatmapInfo.StarRating);
             InterpretedDifficulty.SetDefault();
 
-            IssueList = new IssueList();
             Child = new Container
             {
                 RelativeSizeAxes = Axes.Both,
@@ -48,7 +47,7 @@ namespace osu.Game.Screens.Edit.Verify
                     {
                         new Drawable[]
                         {
-                            IssueList,
+                            IssueList = new IssueList(),
                             new IssueSettings(),
                         },
                     }

From 3f5ccd4db8c5aa6ae027b4c00a1df344891d3896 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 24 May 2022 18:02:37 +0900
Subject: [PATCH 5003/5547] Update timing screen sections to newer design
 metrics

---
 osu.Game/Graphics/UserInterfaceV2/LabelledDrawable.cs |  2 +-
 osu.Game/Screens/Edit/EditorRoundedScreenSettings.cs  |  5 ++++-
 osu.Game/Screens/Edit/Timing/Section.cs               | 11 ++++++-----
 .../Screens/Edit/Timing/SliderWithTextBoxInput.cs     |  2 ++
 4 files changed, 13 insertions(+), 7 deletions(-)

diff --git a/osu.Game/Graphics/UserInterfaceV2/LabelledDrawable.cs b/osu.Game/Graphics/UserInterfaceV2/LabelledDrawable.cs
index 066e1a7978..2353d9e0e8 100644
--- a/osu.Game/Graphics/UserInterfaceV2/LabelledDrawable.cs
+++ b/osu.Game/Graphics/UserInterfaceV2/LabelledDrawable.cs
@@ -154,7 +154,7 @@ namespace osu.Game.Graphics.UserInterfaceV2
         [BackgroundDependencyLoader(true)]
         private void load(OverlayColourProvider? colourProvider, OsuColour osuColour)
         {
-            background.Colour = colourProvider?.Background4 ?? Color4Extensions.FromHex(@"1c2125");
+            background.Colour = colourProvider?.Background5 ?? Color4Extensions.FromHex(@"1c2125");
             descriptionText.Colour = osuColour.Yellow;
         }
 
diff --git a/osu.Game/Screens/Edit/EditorRoundedScreenSettings.cs b/osu.Game/Screens/Edit/EditorRoundedScreenSettings.cs
index cb17484d27..94a83a82aa 100644
--- a/osu.Game/Screens/Edit/EditorRoundedScreenSettings.cs
+++ b/osu.Game/Screens/Edit/EditorRoundedScreenSettings.cs
@@ -8,6 +8,7 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
 using osu.Game.Graphics.Containers;
 using osu.Game.Overlays;
+using osuTK;
 
 namespace osu.Game.Screens.Edit
 {
@@ -22,7 +23,7 @@ namespace osu.Game.Screens.Edit
             {
                 new Box
                 {
-                    Colour = colours.Background4,
+                    Colour = colours.Background6,
                     RelativeSizeAxes = Axes.Both,
                 },
                 new OsuScrollContainer
@@ -33,6 +34,8 @@ namespace osu.Game.Screens.Edit
                         RelativeSizeAxes = Axes.X,
                         AutoSizeAxes = Axes.Y,
                         Direction = FillDirection.Vertical,
+                        Padding = new MarginPadding(10),
+                        Spacing = new Vector2(10),
                         Children = CreateSections()
                     },
                 }
diff --git a/osu.Game/Screens/Edit/Timing/Section.cs b/osu.Game/Screens/Edit/Timing/Section.cs
index 8659b7aff6..139abfb187 100644
--- a/osu.Game/Screens/Edit/Timing/Section.cs
+++ b/osu.Game/Screens/Edit/Timing/Section.cs
@@ -44,9 +44,15 @@ namespace osu.Game.Screens.Edit.Timing
             AutoSizeAxes = Axes.Y;
 
             Masking = true;
+            CornerRadius = 5;
 
             InternalChildren = new Drawable[]
             {
+                new Box
+                {
+                    Colour = colours.Background4,
+                    RelativeSizeAxes = Axes.Both,
+                },
                 new Container
                 {
                     RelativeSizeAxes = Axes.X,
@@ -69,11 +75,6 @@ namespace osu.Game.Screens.Edit.Timing
                     AutoSizeAxes = Axes.Y,
                     Children = new Drawable[]
                     {
-                        new Box
-                        {
-                            Colour = colours.Background3,
-                            RelativeSizeAxes = Axes.Both,
-                        },
                         Flow = new FillFlowContainer
                         {
                             Padding = new MarginPadding(20),
diff --git a/osu.Game/Screens/Edit/Timing/SliderWithTextBoxInput.cs b/osu.Game/Screens/Edit/Timing/SliderWithTextBoxInput.cs
index 67f1dacec4..9f036f0215 100644
--- a/osu.Game/Screens/Edit/Timing/SliderWithTextBoxInput.cs
+++ b/osu.Game/Screens/Edit/Timing/SliderWithTextBoxInput.cs
@@ -11,6 +11,7 @@ using osu.Framework.Localisation;
 using osu.Game.Graphics.UserInterfaceV2;
 using osu.Game.Overlays.Settings;
 using osu.Game.Utils;
+using osuTK;
 
 namespace osu.Game.Screens.Edit.Timing
 {
@@ -33,6 +34,7 @@ namespace osu.Game.Screens.Edit.Timing
                     RelativeSizeAxes = Axes.X,
                     AutoSizeAxes = Axes.Y,
                     Direction = FillDirection.Vertical,
+                    Spacing = new Vector2(20),
                     Children = new Drawable[]
                     {
                         textBox = new LabelledTextBox

From 648cee71061f043eb813c5eb7e01bebfd63ecb22 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 24 May 2022 17:23:42 +0900
Subject: [PATCH 5004/5547] Remove editor screen transitions for now

---
 osu.Game/Screens/Edit/Editor.cs       |  1 +
 osu.Game/Screens/Edit/EditorScreen.cs | 12 ++----------
 2 files changed, 3 insertions(+), 10 deletions(-)

diff --git a/osu.Game/Screens/Edit/Editor.cs b/osu.Game/Screens/Edit/Editor.cs
index 0bb3f51903..90bf9c6c3c 100644
--- a/osu.Game/Screens/Edit/Editor.cs
+++ b/osu.Game/Screens/Edit/Editor.cs
@@ -777,6 +777,7 @@ namespace osu.Game.Screens.Edit
                 if ((currentScreen = screenContainer.SingleOrDefault(s => s.Type == e.NewValue)) != null)
                 {
                     screenContainer.ChangeChildDepth(currentScreen, lastScreen?.Depth + 1 ?? 0);
+
                     currentScreen.Show();
                     return;
                 }
diff --git a/osu.Game/Screens/Edit/EditorScreen.cs b/osu.Game/Screens/Edit/EditorScreen.cs
index 2837cdcd9a..31c34edd7c 100644
--- a/osu.Game/Screens/Edit/EditorScreen.cs
+++ b/osu.Game/Screens/Edit/EditorScreen.cs
@@ -33,17 +33,9 @@ namespace osu.Game.Screens.Edit
             InternalChild = content = new PopoverContainer { RelativeSizeAxes = Axes.Both };
         }
 
-        protected override void PopIn()
-        {
-            this.ScaleTo(1f, 200, Easing.OutQuint)
-                .FadeIn(200, Easing.OutQuint);
-        }
+        protected override void PopIn() => this.FadeIn();
 
-        protected override void PopOut()
-        {
-            this.ScaleTo(0.98f, 200, Easing.OutQuint)
-                .FadeOut(200, Easing.OutQuint);
-        }
+        protected override void PopOut() => this.FadeOut();
 
         #region Clipboard operations
 

From 0bcf8c846c91fb5482615d39fb82b0b45498a82b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 24 May 2022 17:36:43 +0900
Subject: [PATCH 5005/5547] Change editor colour scheme to aquamarine

---
 osu.Game.Tests/Visual/Editing/TestSceneBeatDivisorControl.cs | 2 +-
 osu.Game/Overlays/OverlayColourProvider.cs                   | 4 ++++
 osu.Game/Screens/Edit/Editor.cs                              | 2 +-
 osu.Game/Tests/Visual/EditorClockTestScene.cs                | 4 ++++
 4 files changed, 10 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneBeatDivisorControl.cs b/osu.Game.Tests/Visual/Editing/TestSceneBeatDivisorControl.cs
index cdd1175692..073a228224 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneBeatDivisorControl.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneBeatDivisorControl.cs
@@ -28,7 +28,7 @@ namespace osu.Game.Tests.Visual.Editing
         private Triangle tickMarkerHead => tickSliderBar.ChildrenOfType<Triangle>().Single();
 
         [Cached]
-        private readonly OverlayColourProvider overlayColour = new OverlayColourProvider(OverlayColourScheme.Green);
+        private readonly OverlayColourProvider overlayColour = new OverlayColourProvider(OverlayColourScheme.Aquamarine);
 
         [SetUp]
         public void SetUp() => Schedule(() =>
diff --git a/osu.Game/Overlays/OverlayColourProvider.cs b/osu.Game/Overlays/OverlayColourProvider.cs
index 7bddb924a0..a4f6527024 100644
--- a/osu.Game/Overlays/OverlayColourProvider.cs
+++ b/osu.Game/Overlays/OverlayColourProvider.cs
@@ -72,6 +72,9 @@ namespace osu.Game.Overlays
                 case OverlayColourScheme.Green:
                     return 125 / 360f;
 
+                case OverlayColourScheme.Aquamarine:
+                    return 160 / 360f;
+
                 case OverlayColourScheme.Purple:
                     return 255 / 360f;
 
@@ -94,5 +97,6 @@ namespace osu.Game.Overlays
         Purple,
         Blue,
         Plum,
+        Aquamarine
     }
 }
diff --git a/osu.Game/Screens/Edit/Editor.cs b/osu.Game/Screens/Edit/Editor.cs
index 90bf9c6c3c..7e7764397c 100644
--- a/osu.Game/Screens/Edit/Editor.cs
+++ b/osu.Game/Screens/Edit/Editor.cs
@@ -140,7 +140,7 @@ namespace osu.Game.Screens.Edit
         public readonly EditorClipboard Clipboard = new EditorClipboard();
 
         [Cached]
-        private readonly OverlayColourProvider colourProvider = new OverlayColourProvider(OverlayColourScheme.Blue);
+        private readonly OverlayColourProvider colourProvider = new OverlayColourProvider(OverlayColourScheme.Aquamarine);
 
         public Editor(EditorLoader loader = null)
         {
diff --git a/osu.Game/Tests/Visual/EditorClockTestScene.cs b/osu.Game/Tests/Visual/EditorClockTestScene.cs
index 66ab427565..542f06f86b 100644
--- a/osu.Game/Tests/Visual/EditorClockTestScene.cs
+++ b/osu.Game/Tests/Visual/EditorClockTestScene.cs
@@ -5,6 +5,7 @@ using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Input.Events;
 using osu.Game.Beatmaps;
+using osu.Game.Overlays;
 using osu.Game.Screens.Edit;
 
 namespace osu.Game.Tests.Visual
@@ -15,6 +16,9 @@ namespace osu.Game.Tests.Visual
     /// </summary>
     public abstract class EditorClockTestScene : OsuManualInputManagerTestScene
     {
+        [Cached]
+        private readonly OverlayColourProvider overlayColour = new OverlayColourProvider(OverlayColourScheme.Aquamarine);
+
         protected readonly BindableBeatDivisor BeatDivisor = new BindableBeatDivisor();
         protected new readonly EditorClock Clock;
 

From 30b9e0e7abdc59c69c8ee9192b60c2a2430af263 Mon Sep 17 00:00:00 2001
From: apollo-dw <83023433+apollo-dw@users.noreply.github.com>
Date: Tue, 24 May 2022 16:30:25 +0100
Subject: [PATCH 5006/5547] Use object list size for object position

---
 .../Difficulty/CatchDifficultyCalculator.cs                 | 6 +-----
 .../Difficulty/Preprocessing/CatchDifficultyHitObject.cs    | 4 ++--
 .../Difficulty/ManiaDifficultyCalculator.cs                 | 2 +-
 .../Difficulty/Preprocessing/ManiaDifficultyHitObject.cs    | 4 ++--
 osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs | 2 +-
 .../Difficulty/Preprocessing/OsuDifficultyHitObject.cs      | 6 +++---
 .../Difficulty/Preprocessing/TaikoDifficultyHitObject.cs    | 5 ++---
 .../Difficulty/TaikoDifficultyCalculator.cs                 | 2 +-
 .../Difficulty/Preprocessing/DifficultyHitObject.cs         | 5 ++---
 9 files changed, 15 insertions(+), 21 deletions(-)

diff --git a/osu.Game.Rulesets.Catch/Difficulty/CatchDifficultyCalculator.cs b/osu.Game.Rulesets.Catch/Difficulty/CatchDifficultyCalculator.cs
index 3826e4cec4..da85840171 100644
--- a/osu.Game.Rulesets.Catch/Difficulty/CatchDifficultyCalculator.cs
+++ b/osu.Game.Rulesets.Catch/Difficulty/CatchDifficultyCalculator.cs
@@ -50,7 +50,6 @@ namespace osu.Game.Rulesets.Catch.Difficulty
             CatchHitObject lastObject = null;
 
             List<DifficultyHitObject> objects = new List<DifficultyHitObject>();
-            int index = 0;
 
             // In 2B beatmaps, it is possible that a normal Fruit is placed in the middle of a JuiceStream.
             foreach (var hitObject in beatmap.HitObjects
@@ -63,10 +62,7 @@ namespace osu.Game.Rulesets.Catch.Difficulty
                     continue;
 
                 if (lastObject != null)
-                {
-                    objects.Add(new CatchDifficultyHitObject(hitObject, lastObject, clockRate, halfCatcherWidth, objects, index));
-                    index++;
-                }
+                    objects.Add(new CatchDifficultyHitObject(hitObject, lastObject, clockRate, halfCatcherWidth, objects));
 
                 lastObject = hitObject;
             }
diff --git a/osu.Game.Rulesets.Catch/Difficulty/Preprocessing/CatchDifficultyHitObject.cs b/osu.Game.Rulesets.Catch/Difficulty/Preprocessing/CatchDifficultyHitObject.cs
index 8c229cf6c5..60d6213525 100644
--- a/osu.Game.Rulesets.Catch/Difficulty/Preprocessing/CatchDifficultyHitObject.cs
+++ b/osu.Game.Rulesets.Catch/Difficulty/Preprocessing/CatchDifficultyHitObject.cs
@@ -25,8 +25,8 @@ namespace osu.Game.Rulesets.Catch.Difficulty.Preprocessing
         /// </summary>
         public readonly double StrainTime;
 
-        public CatchDifficultyHitObject(HitObject hitObject, HitObject lastObject, double clockRate, float halfCatcherWidth, List<DifficultyHitObject> objects, int position)
-            : base(hitObject, lastObject, clockRate, objects, position)
+        public CatchDifficultyHitObject(HitObject hitObject, HitObject lastObject, double clockRate, float halfCatcherWidth, List<DifficultyHitObject> objects)
+            : base(hitObject, lastObject, clockRate, objects)
         {
             // We will scale everything by this factor, so we can assume a uniform CircleSize among beatmaps.
             float scalingFactor = normalized_hitobject_radius / halfCatcherWidth;
diff --git a/osu.Game.Rulesets.Mania/Difficulty/ManiaDifficultyCalculator.cs b/osu.Game.Rulesets.Mania/Difficulty/ManiaDifficultyCalculator.cs
index 7ce73c98d1..68c2acb2ed 100644
--- a/osu.Game.Rulesets.Mania/Difficulty/ManiaDifficultyCalculator.cs
+++ b/osu.Game.Rulesets.Mania/Difficulty/ManiaDifficultyCalculator.cs
@@ -65,7 +65,7 @@ namespace osu.Game.Rulesets.Mania.Difficulty
             List<DifficultyHitObject> objects = new List<DifficultyHitObject>();
 
             for (int i = 1; i < sortedObjects.Length; i++)
-                objects.Add(new ManiaDifficultyHitObject(sortedObjects[i], sortedObjects[i - 1], clockRate, objects, i - 1));
+                objects.Add(new ManiaDifficultyHitObject(sortedObjects[i], sortedObjects[i - 1], clockRate, objects));
 
             return objects;
         }
diff --git a/osu.Game.Rulesets.Mania/Difficulty/Preprocessing/ManiaDifficultyHitObject.cs b/osu.Game.Rulesets.Mania/Difficulty/Preprocessing/ManiaDifficultyHitObject.cs
index 5c9b3b9b54..68f14ed128 100644
--- a/osu.Game.Rulesets.Mania/Difficulty/Preprocessing/ManiaDifficultyHitObject.cs
+++ b/osu.Game.Rulesets.Mania/Difficulty/Preprocessing/ManiaDifficultyHitObject.cs
@@ -12,8 +12,8 @@ namespace osu.Game.Rulesets.Mania.Difficulty.Preprocessing
     {
         public new ManiaHitObject BaseObject => (ManiaHitObject)base.BaseObject;
 
-        public ManiaDifficultyHitObject(HitObject hitObject, HitObject lastObject, double clockRate, List<DifficultyHitObject> objects, int position)
-            : base(hitObject, lastObject, clockRate, objects, position)
+        public ManiaDifficultyHitObject(HitObject hitObject, HitObject lastObject, double clockRate, List<DifficultyHitObject> objects)
+            : base(hitObject, lastObject, clockRate, objects)
         {
         }
     }
diff --git a/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs b/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs
index 3b21ab49c2..da9fb2bb08 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs
@@ -92,7 +92,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty
             // The first jump is formed by the first two hitobjects of the map.
             // If the map has less than two OsuHitObjects, the enumerator will not return anything.
             for (int i = 1; i < beatmap.HitObjects.Count; i++)
-                objects.Add(new OsuDifficultyHitObject(beatmap.HitObjects[i], beatmap.HitObjects[i - 1], clockRate, objects, i - 1));
+                objects.Add(new OsuDifficultyHitObject(beatmap.HitObjects[i], beatmap.HitObjects[i - 1], clockRate, objects));
 
             return objects;
         }
diff --git a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
index 591a6e4aa2..c0d5f56cb5 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
@@ -75,10 +75,10 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
         private readonly OsuHitObject lastLastObject;
         private readonly OsuHitObject lastObject;
 
-        public OsuDifficultyHitObject(HitObject hitObject, HitObject lastObject, double clockRate, List<DifficultyHitObject> objects, int position)
-            : base(hitObject, lastObject, clockRate, objects, position)
+        public OsuDifficultyHitObject(HitObject hitObject, HitObject lastObject, double clockRate, List<DifficultyHitObject> objects)
+            : base(hitObject, lastObject, clockRate, objects)
         {
-            lastLastObject = position > 1 ? (OsuHitObject)Previous(1).BaseObject : null;
+            lastLastObject = Position > 1 ? (OsuHitObject)Previous(1).BaseObject : null;
             this.lastObject = (OsuHitObject)lastObject;
 
             // Capped to 25ms to prevent difficulty calculation breaking from simultaneous objects.
diff --git a/osu.Game.Rulesets.Taiko/Difficulty/Preprocessing/TaikoDifficultyHitObject.cs b/osu.Game.Rulesets.Taiko/Difficulty/Preprocessing/TaikoDifficultyHitObject.cs
index a4b7609328..6dbaab44cf 100644
--- a/osu.Game.Rulesets.Taiko/Difficulty/Preprocessing/TaikoDifficultyHitObject.cs
+++ b/osu.Game.Rulesets.Taiko/Difficulty/Preprocessing/TaikoDifficultyHitObject.cs
@@ -39,9 +39,8 @@ namespace osu.Game.Rulesets.Taiko.Difficulty.Preprocessing
         /// <param name="lastLastObject">The gameplay <see cref="HitObject"/> preceding <paramref name="lastObject"/>.</param>
         /// <param name="clockRate">The rate of the gameplay clock. Modified by speed-changing mods.</param>
         /// <param name="objects">The list of <see cref="DifficultyHitObject"/>s in the current beatmap.</param>
-        /// <param name="position">The position of this <see cref="DifficultyHitObject"/> in the <paramref name="objects"/> list.</param>
-        public TaikoDifficultyHitObject(HitObject hitObject, HitObject lastObject, HitObject lastLastObject, double clockRate, List<DifficultyHitObject> objects, int position)
-            : base(hitObject, lastObject, clockRate, objects, position)
+        public TaikoDifficultyHitObject(HitObject hitObject, HitObject lastObject, HitObject lastLastObject, double clockRate, List<DifficultyHitObject> objects)
+            : base(hitObject, lastObject, clockRate, objects)
         {
             var currentHit = hitObject as Hit;
 
diff --git a/osu.Game.Rulesets.Taiko/Difficulty/TaikoDifficultyCalculator.cs b/osu.Game.Rulesets.Taiko/Difficulty/TaikoDifficultyCalculator.cs
index 54cf0ae4fd..d6792f7227 100644
--- a/osu.Game.Rulesets.Taiko/Difficulty/TaikoDifficultyCalculator.cs
+++ b/osu.Game.Rulesets.Taiko/Difficulty/TaikoDifficultyCalculator.cs
@@ -52,7 +52,7 @@ namespace osu.Game.Rulesets.Taiko.Difficulty
             {
                 taikoDifficultyHitObjects.Add(
                     new TaikoDifficultyHitObject(
-                        beatmap.HitObjects[i], beatmap.HitObjects[i - 1], beatmap.HitObjects[i - 2], clockRate, taikoDifficultyHitObjects, i - 2
+                        beatmap.HitObjects[i], beatmap.HitObjects[i - 1], beatmap.HitObjects[i - 2], clockRate, taikoDifficultyHitObjects
                     )
                 );
             }
diff --git a/osu.Game/Rulesets/Difficulty/Preprocessing/DifficultyHitObject.cs b/osu.Game/Rulesets/Difficulty/Preprocessing/DifficultyHitObject.cs
index e082e077cf..2891434e01 100644
--- a/osu.Game/Rulesets/Difficulty/Preprocessing/DifficultyHitObject.cs
+++ b/osu.Game/Rulesets/Difficulty/Preprocessing/DifficultyHitObject.cs
@@ -50,11 +50,10 @@ namespace osu.Game.Rulesets.Difficulty.Preprocessing
         /// <param name="lastObject">The last <see cref="HitObject"/> which occurs before <paramref name="hitObject"/> in the beatmap.</param>
         /// <param name="clockRate">The rate at which the gameplay clock is run at.</param>
         /// <param name="objects">The list of <see cref="DifficultyHitObject"/>s in the current beatmap.</param>
-        /// <param name="position">The position of this <see cref="DifficultyHitObject"/> in the <see cref="difficultyHitObjects"/> list.</param>
-        public DifficultyHitObject(HitObject hitObject, HitObject lastObject, double clockRate, List<DifficultyHitObject> objects, int position)
+        public DifficultyHitObject(HitObject hitObject, HitObject lastObject, double clockRate, List<DifficultyHitObject> objects)
         {
             difficultyHitObjects = objects;
-            Position = position;
+            Position = objects.Count;
             BaseObject = hitObject;
             LastObject = lastObject;
             DeltaTime = (hitObject.StartTime - lastObject.StartTime) / clockRate;

From 1ef711de411008ee7c1d76f538921aeafc8bc6ed Mon Sep 17 00:00:00 2001
From: apollo-dw <83023433+apollo-dw@users.noreply.github.com>
Date: Tue, 24 May 2022 16:40:24 +0100
Subject: [PATCH 5007/5547] Return null for out of range objects

---
 .../Difficulty/Preprocessing/OsuDifficultyHitObject.cs       | 2 +-
 .../Rulesets/Difficulty/Preprocessing/DifficultyHitObject.cs | 5 +++--
 2 files changed, 4 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
index c0d5f56cb5..f599d2e32d 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
@@ -78,7 +78,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
         public OsuDifficultyHitObject(HitObject hitObject, HitObject lastObject, double clockRate, List<DifficultyHitObject> objects)
             : base(hitObject, lastObject, clockRate, objects)
         {
-            lastLastObject = Position > 1 ? (OsuHitObject)Previous(1).BaseObject : null;
+            lastLastObject = (OsuHitObject)Previous(1)?.BaseObject;
             this.lastObject = (OsuHitObject)lastObject;
 
             // Capped to 25ms to prevent difficulty calculation breaking from simultaneous objects.
diff --git a/osu.Game/Rulesets/Difficulty/Preprocessing/DifficultyHitObject.cs b/osu.Game/Rulesets/Difficulty/Preprocessing/DifficultyHitObject.cs
index 2891434e01..7e9c28f73c 100644
--- a/osu.Game/Rulesets/Difficulty/Preprocessing/DifficultyHitObject.cs
+++ b/osu.Game/Rulesets/Difficulty/Preprocessing/DifficultyHitObject.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 osu.Game.Rulesets.Objects;
 
 namespace osu.Game.Rulesets.Difficulty.Preprocessing
@@ -61,8 +62,8 @@ namespace osu.Game.Rulesets.Difficulty.Preprocessing
             EndTime = hitObject.GetEndTime() / clockRate;
         }
 
-        public DifficultyHitObject Previous(int backwardsIndex) => difficultyHitObjects[Position - (backwardsIndex + 1)];
+        public DifficultyHitObject Previous(int backwardsIndex) => difficultyHitObjects.ElementAtOrDefault(Position - (backwardsIndex + 1));
 
-        public DifficultyHitObject Next(int forwardsIndex) => difficultyHitObjects[Position + (forwardsIndex + 1)];
+        public DifficultyHitObject Next(int forwardsIndex) => difficultyHitObjects.ElementAtOrDefault(Position - (forwardsIndex + 1));
     }
 }

From bf35ded8711e0ccb439e80f7d09b3eff3aa3a085 Mon Sep 17 00:00:00 2001
From: apollo <83023433+apollo-dw@users.noreply.github.com>
Date: Tue, 24 May 2022 17:06:11 +0100
Subject: [PATCH 5008/5547] Correct operation

Co-authored-by: Salman Ahmed <frenzibyte@gmail.com>
---
 .../Rulesets/Difficulty/Preprocessing/DifficultyHitObject.cs    | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Rulesets/Difficulty/Preprocessing/DifficultyHitObject.cs b/osu.Game/Rulesets/Difficulty/Preprocessing/DifficultyHitObject.cs
index 7e9c28f73c..e067b0bb2f 100644
--- a/osu.Game/Rulesets/Difficulty/Preprocessing/DifficultyHitObject.cs
+++ b/osu.Game/Rulesets/Difficulty/Preprocessing/DifficultyHitObject.cs
@@ -64,6 +64,6 @@ namespace osu.Game.Rulesets.Difficulty.Preprocessing
 
         public DifficultyHitObject Previous(int backwardsIndex) => difficultyHitObjects.ElementAtOrDefault(Position - (backwardsIndex + 1));
 
-        public DifficultyHitObject Next(int forwardsIndex) => difficultyHitObjects.ElementAtOrDefault(Position - (forwardsIndex + 1));
+        public DifficultyHitObject Next(int forwardsIndex) => difficultyHitObjects.ElementAtOrDefault(Position + (forwardsIndex + 1));
     }
 }

From fce527b0dfbcd056dc2b2590448ae2925c803d9e Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Tue, 24 May 2022 21:25:27 +0100
Subject: [PATCH 5009/5547] Schedule channel manager bindable events to ensure
 they happen after the first poll

---
 osu.Game/Overlays/ChatOverlayV2.cs | 12 +++++++-----
 1 file changed, 7 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Overlays/ChatOverlayV2.cs b/osu.Game/Overlays/ChatOverlayV2.cs
index 441042432a..3aab81cb04 100644
--- a/osu.Game/Overlays/ChatOverlayV2.cs
+++ b/osu.Game/Overlays/ChatOverlayV2.cs
@@ -155,13 +155,15 @@ namespace osu.Game.Overlays
             chatHeight.BindValueChanged(height => { Height = height.NewValue; }, true);
 
             currentChannel.BindTo(channelManager.CurrentChannel);
-            currentChannel.BindValueChanged(currentChannelChanged, true);
-
             joinedChannels.BindTo(channelManager.JoinedChannels);
-            joinedChannels.BindCollectionChanged(joinedChannelsChanged, true);
-
             availableChannels.BindTo(channelManager.AvailableChannels);
-            availableChannels.BindCollectionChanged(availableChannelsChanged, true);
+
+            Schedule(() =>
+            {
+                currentChannel.BindValueChanged(currentChannelChanged, true);
+                joinedChannels.BindCollectionChanged(joinedChannelsChanged, true);
+                availableChannels.BindCollectionChanged(availableChannelsChanged, true);
+            });
 
             channelList.OnRequestSelect += channel => channelManager.CurrentChannel.Value = channel;
             channelList.OnRequestLeave += channel => channelManager.LeaveChannel(channel);

From c33aee17b002cc863ebb4826560de4257fe59ca5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 24 May 2022 23:14:28 +0200
Subject: [PATCH 5010/5547] Cache some more `OverlayColourProvider`s to fix
 tests

---
 .../Editor/TestSceneManiaComposeScreen.cs                     | 2 ++
 osu.Game.Tests/Visual/Editing/TestSceneComposeScreen.cs       | 2 ++
 osu.Game.Tests/Visual/Editing/TestSceneTimelineTickDisplay.cs | 4 ++++
 3 files changed, 8 insertions(+)

diff --git a/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneManiaComposeScreen.cs b/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneManiaComposeScreen.cs
index 5dd7c23ab6..746bdae02e 100644
--- a/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneManiaComposeScreen.cs
+++ b/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneManiaComposeScreen.cs
@@ -9,6 +9,7 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Testing;
 using osu.Game.Database;
+using osu.Game.Overlays;
 using osu.Game.Rulesets.Edit;
 using osu.Game.Rulesets.Mania.Beatmaps;
 using osu.Game.Screens.Edit;
@@ -45,6 +46,7 @@ namespace osu.Game.Rulesets.Mania.Tests.Editor
                     {
                         (typeof(EditorBeatmap), editorBeatmap),
                         (typeof(IBeatSnapProvider), editorBeatmap),
+                        (typeof(OverlayColourProvider), new OverlayColourProvider(OverlayColourScheme.Green)),
                     },
                     Child = new ComposeScreen { State = { Value = Visibility.Visible } },
                 };
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneComposeScreen.cs b/osu.Game.Tests/Visual/Editing/TestSceneComposeScreen.cs
index 30c8539d85..fa15c00cd4 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneComposeScreen.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneComposeScreen.cs
@@ -9,6 +9,7 @@ using osu.Framework.Extensions.ObjectExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Testing;
+using osu.Game.Overlays;
 using osu.Game.Rulesets.Edit;
 using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Osu.Beatmaps;
@@ -47,6 +48,7 @@ namespace osu.Game.Tests.Visual.Editing
                     {
                         (typeof(EditorBeatmap), editorBeatmap),
                         (typeof(IBeatSnapProvider), editorBeatmap),
+                        (typeof(OverlayColourProvider), new OverlayColourProvider(OverlayColourScheme.Green)),
                     },
                     Child = new ComposeScreen { State = { Value = Visibility.Visible } },
                 };
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneTimelineTickDisplay.cs b/osu.Game.Tests/Visual/Editing/TestSceneTimelineTickDisplay.cs
index 20e58c3d2a..b78512e469 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneTimelineTickDisplay.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneTimelineTickDisplay.cs
@@ -4,6 +4,7 @@
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
+using osu.Game.Overlays;
 using osu.Game.Screens.Edit.Compose.Components;
 using osuTK;
 
@@ -14,6 +15,9 @@ namespace osu.Game.Tests.Visual.Editing
     {
         public override Drawable CreateTestComponent() => Empty(); // tick display is implicitly inside the timeline.
 
+        [Cached]
+        private readonly OverlayColourProvider overlayColour = new OverlayColourProvider(OverlayColourScheme.Green);
+
         [BackgroundDependencyLoader]
         private void load()
         {

From f6810d3f59d831e02ae1c4a42fe61001746858d8 Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Tue, 24 May 2022 23:05:25 +0100
Subject: [PATCH 5011/5547] Add keyboard shortcuts to `ChatOverlayV2` with
 tests

---
 .../Visual/Online/TestSceneChatOverlayV2.cs   | 72 +++++++++++++++++++
 osu.Game/Overlays/ChatOverlayV2.cs            | 52 +++++++++++++-
 2 files changed, 122 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs b/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs
index 7268dd31f6..0580d20171 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs
@@ -12,6 +12,7 @@ using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
+using osu.Framework.Input;
 using osu.Framework.Logging;
 using osu.Framework.Testing;
 using osu.Framework.Utils;
@@ -417,6 +418,67 @@ namespace osu.Game.Tests.Visual.Online
             AddAssert("Channel 1 displayed", () => channelIsVisible && currentDrawableChannel.Channel == testChannel1);
         }
 
+        [Test]
+        public void TestKeyboardCloseAndRestoreChannel()
+        {
+            AddStep("Show overlay with channel 1", () =>
+            {
+                channelManager.JoinChannel(testChannel1);
+                chatOverlay.Show();
+            });
+            AddAssert("Channel 1 displayed", () => channelIsVisible && currentDrawableChannel.Channel == testChannel1);
+
+            AddStep("Press document close keys", () => InputManager.Keys(PlatformAction.DocumentClose));
+            AddAssert("Listing is visible", () => listingIsVisible);
+
+            AddStep("Press tab restore keys", () => InputManager.Keys(PlatformAction.TabRestore));
+            AddAssert("Channel 1 displayed", () => channelIsVisible && currentDrawableChannel.Channel == testChannel1);
+        }
+
+        [Test]
+        public void TestKeyboardNewChannel()
+        {
+            AddStep("Show overlay with channel 1", () =>
+            {
+                channelManager.JoinChannel(testChannel1);
+                chatOverlay.Show();
+            });
+            AddAssert("Channel 1 displayed", () => channelIsVisible && currentDrawableChannel.Channel == testChannel1);
+
+            AddStep("Press tab new keys", () => InputManager.Keys(PlatformAction.TabNew));
+            AddAssert("Listing is visible", () => listingIsVisible);
+        }
+
+        [Test]
+        public void TestKeyboardNextChannel()
+        {
+            Channel pmChannel1 = createPrivateChannel();
+            Channel pmChannel2 = createPrivateChannel();
+
+            AddStep("Show overlay with channels", () =>
+            {
+                channelManager.JoinChannel(testChannel1);
+                channelManager.JoinChannel(testChannel2);
+                channelManager.JoinChannel(pmChannel1);
+                channelManager.JoinChannel(pmChannel2);
+                chatOverlay.Show();
+            });
+
+            AddAssert("Channel 1 displayed", () => channelIsVisible && currentDrawableChannel.Channel == testChannel1);
+
+            AddStep("Press document next keys", () => InputManager.Keys(PlatformAction.DocumentNext));
+            AddAssert("Channel 2 displayed", () => channelIsVisible && currentDrawableChannel.Channel == testChannel2);
+
+            AddStep("Press document next keys", () => InputManager.Keys(PlatformAction.DocumentNext));
+            AddAssert("PM Channel 1 displayed", () => channelIsVisible && currentDrawableChannel.Channel == pmChannel1);
+
+            AddStep("Press document next keys", () => InputManager.Keys(PlatformAction.DocumentNext));
+            AddAssert("PM Channel 2 displayed", () => channelIsVisible && currentDrawableChannel.Channel == pmChannel2);
+
+            AddStep("Press document next keys", () => InputManager.Keys(PlatformAction.DocumentNext));
+            AddAssert("Channel 1 displayed", () => channelIsVisible && currentDrawableChannel.Channel == testChannel1);
+        }
+
         private bool listingIsVisible =>
             chatOverlay.ChildrenOfType<ChannelListing>().Single().State.Value == Visibility.Visible;
 
@@ -467,6 +529,16 @@ namespace osu.Game.Tests.Visual.Online
             Type = ChannelType.Public,
         };
 
+        private Channel createPrivateChannel()
+        {
+            int id = RNG.Next(0, 10000);
+            return new Channel(new APIUser
+            {
+                Id = id,
+                Username = $"test user {id}",
+            });
+        }
+
         private class TestChatOverlayV2 : ChatOverlayV2
         {
             public bool SlowLoading { get; set; }
diff --git a/osu.Game/Overlays/ChatOverlayV2.cs b/osu.Game/Overlays/ChatOverlayV2.cs
index 3aab81cb04..39717b1f31 100644
--- a/osu.Game/Overlays/ChatOverlayV2.cs
+++ b/osu.Game/Overlays/ChatOverlayV2.cs
@@ -13,6 +13,8 @@ using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
+using osu.Framework.Input;
+using osu.Framework.Input.Bindings;
 using osu.Framework.Input.Events;
 using osu.Framework.Localisation;
 using osu.Game.Configuration;
@@ -26,7 +28,7 @@ using osu.Game.Overlays.Chat.Listing;
 
 namespace osu.Game.Overlays
 {
-    public class ChatOverlayV2 : OsuFocusedOverlayContainer, INamedOverlayComponent
+    public class ChatOverlayV2 : OsuFocusedOverlayContainer, INamedOverlayComponent, IKeyBindingHandler<PlatformAction>
     {
         public string IconTexture => "Icons/Hexacons/messaging";
         public LocalisableString Title => ChatStrings.HeaderTitle;
@@ -197,6 +199,35 @@ namespace osu.Game.Overlays
             Show();
         }
 
+        public bool OnPressed(KeyBindingPressEvent<PlatformAction> e)
+        {
+            switch (e.Action)
+            {
+                case PlatformAction.TabNew:
+                    currentChannel.Value = channelList.ChannelListingChannel;
+                    return true;
+
+                case PlatformAction.DocumentClose:
+                    channelManager.LeaveChannel(currentChannel.Value);
+                    return true;
+
+                case PlatformAction.TabRestore:
+                    channelManager.JoinLastClosedChannel();
+                    return true;
+
+                case PlatformAction.DocumentNext:
+                    cycleChannel();
+                    return true;
+
+                default:
+                    return false;
+            }
+        }
+
+        public void OnReleased(KeyBindingReleaseEvent<PlatformAction> e)
+        {
+        }
+
         protected override bool OnDragStart(DragStartEvent e)
         {
             isDraggingTopBar = topBar.IsHovered;
@@ -341,7 +372,7 @@ namespace osu.Game.Overlays
         private void availableChannelsChanged(object sender, NotifyCollectionChangedEventArgs args)
             => channelListing.UpdateAvailableChannels(channelManager.AvailableChannels);
 
-        private IEnumerable<Channel> filterChannels(IList channels)
+        private IEnumerable<Channel> filterChannels(IEnumerable channels)
             => channels.Cast<Channel>().Where(c => c.Type == ChannelType.Public || c.Type == ChannelType.PM);
 
         private void handleChatMessage(string message)
@@ -354,5 +385,22 @@ namespace osu.Game.Overlays
             else
                 channelManager.PostMessage(message);
         }
+
+        private void cycleChannel()
+        {
+            List<Channel> overlayChannels = filterChannels(channelManager.JoinedChannels).ToList();
+
+            if (overlayChannels.Count < 2)
+                return;
+
+            int currentIdx = overlayChannels.IndexOf(currentChannel.Value);
+            int nextIdx = currentIdx + 1;
+
+            // Cycle the list when reaching the end
+            if (nextIdx > overlayChannels.Count - 1)
+                nextIdx = 0;
+
+            currentChannel.Value = overlayChannels[nextIdx];
+        }
     }
 }

From de5d2df100a58a5dcd407ab434f2512be215d400 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 25 May 2022 12:17:11 +0900
Subject: [PATCH 5012/5547] Move UI scale setup to the beginning of the first
 run setup

---
 .../Visual/UserInterface/TestSceneFirstRunSetupOverlay.cs     | 4 ++--
 osu.Game/Overlays/FirstRunSetupOverlay.cs                     | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunSetupOverlay.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunSetupOverlay.cs
index 48b5690243..d09efdc925 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunSetupOverlay.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunSetupOverlay.cs
@@ -185,7 +185,7 @@ namespace osu.Game.Tests.Visual.UserInterface
         {
             AddStep("step to next", () => overlay.NextButton.TriggerClick());
 
-            AddAssert("is at known screen", () => overlay.CurrentScreen is ScreenBeatmaps);
+            AddAssert("is at known screen", () => overlay.CurrentScreen is ScreenUIScale);
 
             AddStep("hide", () => overlay.Hide());
             AddAssert("overlay hidden", () => overlay.State.Value == Visibility.Hidden);
@@ -195,7 +195,7 @@ namespace osu.Game.Tests.Visual.UserInterface
             AddStep("run notification action", () => lastNotification.Activated());
 
             AddAssert("overlay shown", () => overlay.State.Value == Visibility.Visible);
-            AddAssert("is resumed", () => overlay.CurrentScreen is ScreenBeatmaps);
+            AddAssert("is resumed", () => overlay.CurrentScreen is ScreenUIScale);
         }
 
         // interface mocks break hot reload, mocking this stub implementation instead works around it.
diff --git a/osu.Game/Overlays/FirstRunSetupOverlay.cs b/osu.Game/Overlays/FirstRunSetupOverlay.cs
index 7b0de4affe..a5bece0832 100644
--- a/osu.Game/Overlays/FirstRunSetupOverlay.cs
+++ b/osu.Game/Overlays/FirstRunSetupOverlay.cs
@@ -76,10 +76,10 @@ namespace osu.Game.Overlays
         private void load(OsuColour colours, LegacyImportManager? legacyImportManager)
         {
             steps.Add(typeof(ScreenWelcome));
+            steps.Add(typeof(ScreenUIScale));
             steps.Add(typeof(ScreenBeatmaps));
             if (legacyImportManager?.SupportsImportFromStable == true)
                 steps.Add(typeof(ScreenImportFromStable));
-            steps.Add(typeof(ScreenUIScale));
             steps.Add(typeof(ScreenBehaviour));
 
             Header.Title = FirstRunSetupOverlayStrings.FirstRunSetupTitle;

From 87959a59d980286daf6c082ef3edda8494e94bf6 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 25 May 2022 18:28:29 +0900
Subject: [PATCH 5013/5547] Add missing "announce" channel type

Of note, this doesn't mean the channels will display, but it does fix
parsing errors which cause the whole chat display to fail.
---
 osu.Game/Online/Chat/ChannelType.cs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Game/Online/Chat/ChannelType.cs b/osu.Game/Online/Chat/ChannelType.cs
index 151efc4645..bd628e90c4 100644
--- a/osu.Game/Online/Chat/ChannelType.cs
+++ b/osu.Game/Online/Chat/ChannelType.cs
@@ -13,5 +13,6 @@ namespace osu.Game.Online.Chat
         PM,
         Group,
         System,
+        Announce,
     }
 }

From a92089c443b9cd256f145aef6711b76bd4e18579 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 25 May 2022 18:42:33 +0900
Subject: [PATCH 5014/5547] Change filter method to consider all non-system
 channels as joinable

---
 osu.Game/Overlays/ChatOverlayV2.cs | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Overlays/ChatOverlayV2.cs b/osu.Game/Overlays/ChatOverlayV2.cs
index 39717b1f31..a23595e1c0 100644
--- a/osu.Game/Overlays/ChatOverlayV2.cs
+++ b/osu.Game/Overlays/ChatOverlayV2.cs
@@ -342,7 +342,7 @@ namespace osu.Game.Overlays
             switch (args.Action)
             {
                 case NotifyCollectionChangedAction.Add:
-                    IEnumerable<Channel> newChannels = filterChannels(args.NewItems);
+                    IEnumerable<Channel> newChannels = filterToChatChannels(args.NewItems);
 
                     foreach (var channel in newChannels)
                         channelList.AddChannel(channel);
@@ -350,7 +350,7 @@ namespace osu.Game.Overlays
                     break;
 
                 case NotifyCollectionChangedAction.Remove:
-                    IEnumerable<Channel> leftChannels = filterChannels(args.OldItems);
+                    IEnumerable<Channel> leftChannels = filterToChatChannels(args.OldItems);
 
                     foreach (var channel in leftChannels)
                     {
@@ -372,8 +372,6 @@ namespace osu.Game.Overlays
         private void availableChannelsChanged(object sender, NotifyCollectionChangedEventArgs args)
             => channelListing.UpdateAvailableChannels(channelManager.AvailableChannels);
 
-        private IEnumerable<Channel> filterChannels(IEnumerable channels)
-            => channels.Cast<Channel>().Where(c => c.Type == ChannelType.Public || c.Type == ChannelType.PM);
 
         private void handleChatMessage(string message)
         {
@@ -402,5 +400,7 @@ namespace osu.Game.Overlays
 
             currentChannel.Value = overlayChannels[nextIdx];
         }
+
+        private IEnumerable<Channel> filterToChatChannels(IEnumerable channels) => channels.Cast<Channel>().Where(c => c.Type != ChannelType.System);
     }
 }

From 49ab031e75f0398ed321b0664d68acee9aba5b31 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 25 May 2022 18:42:49 +0900
Subject: [PATCH 5015/5547] Allow traversing in both directions using ctrl-tab
 shortcuts

---
 osu.Game/Overlays/ChatOverlayV2.cs | 20 +++++++++-----------
 1 file changed, 9 insertions(+), 11 deletions(-)

diff --git a/osu.Game/Overlays/ChatOverlayV2.cs b/osu.Game/Overlays/ChatOverlayV2.cs
index a23595e1c0..d0355e0165 100644
--- a/osu.Game/Overlays/ChatOverlayV2.cs
+++ b/osu.Game/Overlays/ChatOverlayV2.cs
@@ -215,8 +215,12 @@ namespace osu.Game.Overlays
                     channelManager.JoinLastClosedChannel();
                     return true;
 
+                case PlatformAction.DocumentPrevious:
+                    cycleChannel(-1);
+                    return true;
+
                 case PlatformAction.DocumentNext:
-                    cycleChannel();
+                    cycleChannel(1);
                     return true;
 
                 default:
@@ -372,7 +376,6 @@ namespace osu.Game.Overlays
         private void availableChannelsChanged(object sender, NotifyCollectionChangedEventArgs args)
             => channelListing.UpdateAvailableChannels(channelManager.AvailableChannels);
 
-
         private void handleChatMessage(string message)
         {
             if (string.IsNullOrWhiteSpace(message))
@@ -384,21 +387,16 @@ namespace osu.Game.Overlays
                 channelManager.PostMessage(message);
         }
 
-        private void cycleChannel()
+        private void cycleChannel(int direction)
         {
-            List<Channel> overlayChannels = filterChannels(channelManager.JoinedChannels).ToList();
+            List<Channel> overlayChannels = filterToChatChannels(channelManager.JoinedChannels).ToList();
 
             if (overlayChannels.Count < 2)
                 return;
 
-            int currentIdx = overlayChannels.IndexOf(currentChannel.Value);
-            int nextIdx = currentIdx + 1;
+            int currentIndex = overlayChannels.IndexOf(currentChannel.Value);
 
-            // Cycle the list when reaching the end
-            if (nextIdx > overlayChannels.Count - 1)
-                nextIdx = 0;
-
-            currentChannel.Value = overlayChannels[nextIdx];
+            currentChannel.Value = overlayChannels[(currentIndex + direction + overlayChannels.Count) % overlayChannels.Count];
         }
 
         private IEnumerable<Channel> filterToChatChannels(IEnumerable channels) => channels.Cast<Channel>().Where(c => c.Type != ChannelType.System);

From f1d4902be524cbd65a73c8298739ba36f1990ef4 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 25 May 2022 19:25:23 +0900
Subject: [PATCH 5016/5547] Remove unnecessary bindable cast

---
 osu.Game/Screens/Edit/Timing/WaveformComparisonDisplay.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/Edit/Timing/WaveformComparisonDisplay.cs b/osu.Game/Screens/Edit/Timing/WaveformComparisonDisplay.cs
index 0830ba8cf4..c80d3c4261 100644
--- a/osu.Game/Screens/Edit/Timing/WaveformComparisonDisplay.cs
+++ b/osu.Game/Screens/Edit/Timing/WaveformComparisonDisplay.cs
@@ -47,7 +47,7 @@ namespace osu.Game.Screens.Edit.Timing
         private double selectedGroupStartTime;
         private double selectedGroupEndTime;
 
-        private readonly BindableList<ControlPointGroup> controlPointGroups = new BindableList<ControlPointGroup>();
+        private readonly IBindableList<ControlPointGroup> controlPointGroups = new BindableList<ControlPointGroup>();
 
         public WaveformComparisonDisplay()
         {
@@ -83,7 +83,7 @@ namespace osu.Game.Screens.Edit.Timing
 
             selectedGroup.BindValueChanged(_ => updateTimingGroup(), true);
 
-            ((IBindableList<ControlPointGroup>)controlPointGroups).BindTo(editorBeatmap.ControlPointInfo.Groups);
+            controlPointGroups.BindTo(editorBeatmap.ControlPointInfo.Groups);
             controlPointGroups.BindCollectionChanged((_, __) => updateTimingGroup());
 
             beatLength.BindValueChanged(_ => showFrom(lastDisplayedBeatIndex), true);

From 795c9fcbc9cfa9345d9ed1cbde3a8e9fc4a7606d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 25 May 2022 19:38:50 +0900
Subject: [PATCH 5017/5547] Update framework

---
 osu.Android.props        | 2 +-
 osu.Game/osu.Game.csproj | 2 +-
 osu.iOS.props            | 4 ++--
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Android.props b/osu.Android.props
index aaea784852..d5a77c6349 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -52,7 +52,7 @@
   </ItemGroup>
   <ItemGroup>
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.513.0" />
-    <PackageReference Include="ppy.osu.Framework.Android" Version="2022.521.0" />
+    <PackageReference Include="ppy.osu.Framework.Android" Version="2022.525.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
     <!-- Realm needs to be directly referenced in all Xamarin projects, as it will not pull in its transitive dependencies otherwise. -->
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 5bc65ca507..32a0adb859 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="10.11.2" />
-    <PackageReference Include="ppy.osu.Framework" Version="2022.521.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2022.525.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.513.0" />
     <PackageReference Include="Sentry" Version="3.17.1" />
     <PackageReference Include="SharpCompress" Version="0.31.0" />
diff --git a/osu.iOS.props b/osu.iOS.props
index 3597e7e5c0..112b5b4615 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -61,7 +61,7 @@
     <Reference Include="System.Net.Http" />
   </ItemGroup>
   <ItemGroup Label="Package References">
-    <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.521.0" />
+    <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.525.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.513.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net6.0) -->
@@ -84,7 +84,7 @@
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="5.0.14" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.Core" Version="5.0.14" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
-    <PackageReference Include="ppy.osu.Framework" Version="2022.521.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2022.525.0" />
     <PackageReference Include="SharpCompress" Version="0.31.0" />
     <PackageReference Include="NUnit" Version="3.13.3" />
     <PackageReference Include="System.ComponentModel.Annotations" Version="5.0.0" />

From 4a36f3aa4c5f7c6af19627ed38ccc48dc353a39f Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Wed, 25 May 2022 12:29:04 +0100
Subject: [PATCH 5018/5547] Ensure channel traversal shortcut is using visual
 order

---
 osu.Game/Overlays/Chat/ChannelList/ChannelList.cs | 7 +++++++
 osu.Game/Overlays/ChatOverlayV2.cs                | 5 +++--
 2 files changed, 10 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs b/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs
index d1ceae604c..f212f5b162 100644
--- a/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs
+++ b/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs
@@ -4,6 +4,7 @@
 #nullable enable
 
 using System;
+using System.Linq;
 using System.Collections.Generic;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
@@ -22,6 +23,8 @@ namespace osu.Game.Overlays.Chat.ChannelList
         public Action<Channel>? OnRequestSelect;
         public Action<Channel>? OnRequestLeave;
 
+        public IEnumerable<Channel> Channels => publicChannelFlow.Channels.Concat(privateChannelFlow.Channels);
+
         public readonly ChannelListing.ChannelListingChannel ChannelListingChannel = new ChannelListing.ChannelListingChannel();
 
         private readonly Dictionary<Channel, ChannelListItem> channelMap = new Dictionary<Channel, ChannelListItem>();
@@ -118,6 +121,10 @@ namespace osu.Game.Overlays.Chat.ChannelList
 
         private class ChannelListItemFlow : FillFlowContainer
         {
+            public IEnumerable<Channel> Channels => Children.Where(c => c is ChannelListItem)
+                                                            .Cast<ChannelListItem>()
+                                                            .Select(c => c.Channel);
+
             public ChannelListItemFlow(string label)
             {
                 Direction = FillDirection.Vertical;
diff --git a/osu.Game/Overlays/ChatOverlayV2.cs b/osu.Game/Overlays/ChatOverlayV2.cs
index d0355e0165..cc780073ce 100644
--- a/osu.Game/Overlays/ChatOverlayV2.cs
+++ b/osu.Game/Overlays/ChatOverlayV2.cs
@@ -389,7 +389,7 @@ namespace osu.Game.Overlays
 
         private void cycleChannel(int direction)
         {
-            List<Channel> overlayChannels = filterToChatChannels(channelManager.JoinedChannels).ToList();
+            List<Channel> overlayChannels = channelList.Channels.ToList();
 
             if (overlayChannels.Count < 2)
                 return;
@@ -399,6 +399,7 @@ namespace osu.Game.Overlays
             currentChannel.Value = overlayChannels[(currentIndex + direction + overlayChannels.Count) % overlayChannels.Count];
         }
 
-        private IEnumerable<Channel> filterToChatChannels(IEnumerable channels) => channels.Cast<Channel>().Where(c => c.Type != ChannelType.System);
+        private IEnumerable<Channel> filterToChatChannels(IEnumerable channels)
+            => channels.Cast<Channel>().Where(c => c.Type == ChannelType.PM || c.Type == ChannelType.Public);
     }
 }

From cd90d2931534bf8210fedfc6a4c2efbb5863d05a Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Wed, 25 May 2022 12:37:28 +0100
Subject: [PATCH 5019/5547] Ensure channel traversal shortcut scrolls channel
 list item into view

---
 osu.Game/Overlays/Chat/ChannelList/ChannelList.cs | 5 ++++-
 osu.Game/Overlays/ChatOverlayV2.cs                | 2 ++
 2 files changed, 6 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs b/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs
index f212f5b162..2798841925 100644
--- a/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs
+++ b/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs
@@ -29,6 +29,7 @@ namespace osu.Game.Overlays.Chat.ChannelList
 
         private readonly Dictionary<Channel, ChannelListItem> channelMap = new Dictionary<Channel, ChannelListItem>();
 
+        private OsuScrollContainer scroll = null!;
         private ChannelListItemFlow publicChannelFlow = null!;
         private ChannelListItemFlow privateChannelFlow = null!;
         private ChannelListItem selector = null!;
@@ -43,7 +44,7 @@ namespace osu.Game.Overlays.Chat.ChannelList
                     RelativeSizeAxes = Axes.Both,
                     Colour = colourProvider.Background6,
                 },
-                new OsuScrollContainer
+                scroll = new OsuScrollContainer
                 {
                     Padding = new MarginPadding { Vertical = 7 },
                     RelativeSizeAxes = Axes.Both,
@@ -104,6 +105,8 @@ namespace osu.Game.Overlays.Chat.ChannelList
             return channelMap[channel];
         }
 
+        public void ScrollChannelIntoView(Channel channel) => scroll.ScrollIntoView(this.GetItem(channel));
+
         private ChannelListItemFlow getFlowForChannel(Channel channel)
         {
             switch (channel.Type)
diff --git a/osu.Game/Overlays/ChatOverlayV2.cs b/osu.Game/Overlays/ChatOverlayV2.cs
index cc780073ce..ad7a856dbc 100644
--- a/osu.Game/Overlays/ChatOverlayV2.cs
+++ b/osu.Game/Overlays/ChatOverlayV2.cs
@@ -397,6 +397,8 @@ namespace osu.Game.Overlays
             int currentIndex = overlayChannels.IndexOf(currentChannel.Value);
 
             currentChannel.Value = overlayChannels[(currentIndex + direction + overlayChannels.Count) % overlayChannels.Count];
+
+            channelList.ScrollChannelIntoView(currentChannel.Value);
         }
 
         private IEnumerable<Channel> filterToChatChannels(IEnumerable channels)

From c4cae7f677968a72a4363ce9970f00b7891b9c2b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 25 May 2022 22:19:24 +0900
Subject: [PATCH 5020/5547] Update `EditorMenuBar` to match new design language

---
 .../Edit/Components/Menus/EditorMenuBar.cs    | 107 +++++++-----------
 1 file changed, 44 insertions(+), 63 deletions(-)

diff --git a/osu.Game/Screens/Edit/Components/Menus/EditorMenuBar.cs b/osu.Game/Screens/Edit/Components/Menus/EditorMenuBar.cs
index 2a8435ff47..440071bc4c 100644
--- a/osu.Game/Screens/Edit/Components/Menus/EditorMenuBar.cs
+++ b/osu.Game/Screens/Edit/Components/Menus/EditorMenuBar.cs
@@ -2,16 +2,13 @@
 // See the LICENCE file in the repository root for full licence text.
 
 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.UserInterface;
 using osu.Framework.Input.Events;
 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
 {
@@ -24,7 +21,12 @@ namespace osu.Game.Screens.Edit.Components.Menus
 
             MaskingContainer.CornerRadius = 0;
             ItemsContainer.Padding = new MarginPadding { Left = 100 };
-            BackgroundColour = Color4Extensions.FromHex("111");
+        }
+
+        [BackgroundDependencyLoader]
+        private void load(OverlayColourProvider colourProvider)
+        {
+            BackgroundColour = colourProvider.Background3;
         }
 
         protected override Framework.Graphics.UserInterface.Menu CreateSubMenu() => new SubMenu();
@@ -33,29 +35,26 @@ namespace osu.Game.Screens.Edit.Components.Menus
 
         private class DrawableEditorBarMenuItem : DrawableOsuMenuItem
         {
-            private BackgroundBox background;
-
             public DrawableEditorBarMenuItem(MenuItem item)
                 : base(item)
             {
-                Anchor = Anchor.CentreLeft;
-                Origin = Anchor.CentreLeft;
-
-                StateChanged += stateChanged;
             }
 
             [BackgroundDependencyLoader]
-            private void load(OsuColour colours)
+            private void load(OverlayColourProvider colourProvider)
             {
-                ForegroundColour = colours.BlueLight;
-                BackgroundColour = Color4.Transparent;
-                ForegroundColourHover = Color4.White;
-                BackgroundColourHover = colours.Gray3;
+                ForegroundColour = colourProvider.Light3;
+                BackgroundColour = colourProvider.Background2;
+                ForegroundColourHover = colourProvider.Content1;
+                BackgroundColourHover = colourProvider.Background1;
             }
 
-            public override void SetFlowDirection(Direction direction)
+            protected override void LoadComplete()
             {
-                AutoSizeAxes = Axes.Both;
+                base.LoadComplete();
+
+                Foreground.Anchor = Anchor.CentreLeft;
+                Foreground.Origin = Anchor.CentreLeft;
             }
 
             protected override void UpdateBackgroundColour()
@@ -74,54 +73,16 @@ namespace osu.Game.Screens.Edit.Components.Menus
                     base.UpdateForegroundColour();
             }
 
-            private void stateChanged(MenuItemState newState)
-            {
-                if (newState == MenuItemState.Selected)
-                    background.Expand();
-                else
-                    background.Contract();
-            }
-
-            protected override Drawable CreateBackground() => background = new BackgroundBox();
             protected override DrawableOsuMenuItem.TextContainer CreateTextContainer() => new TextContainer();
 
             private new class TextContainer : DrawableOsuMenuItem.TextContainer
             {
                 public TextContainer()
                 {
-                    NormalText.Font = NormalText.Font.With(size: 14);
-                    BoldText.Font = BoldText.Font.With(size: 14);
-                    NormalText.Margin = BoldText.Margin = new MarginPadding { Horizontal = 10, Vertical = MARGIN_VERTICAL };
+                    NormalText.Font = OsuFont.TorusAlternate;
+                    BoldText.Font = OsuFont.TorusAlternate.With(weight: FontWeight.Bold);
                 }
             }
-
-            private class BackgroundBox : CompositeDrawable
-            {
-                private readonly Container innerBackground;
-
-                public BackgroundBox()
-                {
-                    RelativeSizeAxes = Axes.Both;
-                    Masking = true;
-                    InternalChild = innerBackground = new Container
-                    {
-                        RelativeSizeAxes = Axes.Both,
-                        Masking = true,
-                        CornerRadius = 4,
-                        Child = new Box { RelativeSizeAxes = Axes.Both }
-                    };
-                }
-
-                /// <summary>
-                /// Expands the background such that it doesn't show the bottom corners.
-                /// </summary>
-                public void Expand() => innerBackground.Height = 2;
-
-                /// <summary>
-                /// Contracts the background such that it shows the bottom corners.
-                /// </summary>
-                public void Contract() => innerBackground.Height = 1;
-            }
         }
 
         private class SubMenu : OsuMenu
@@ -129,14 +90,15 @@ namespace osu.Game.Screens.Edit.Components.Menus
             public SubMenu()
                 : base(Direction.Vertical)
             {
-                OriginPosition = new Vector2(5, 1);
-                ItemsContainer.Padding = new MarginPadding { Top = 5, Bottom = 5 };
+                ItemsContainer.Padding = new MarginPadding();
+
+                MaskingContainer.CornerRadius = 0;
             }
 
             [BackgroundDependencyLoader]
-            private void load(OsuColour colours)
+            private void load(OverlayColourProvider colourProvider)
             {
-                BackgroundColour = colours.Gray3;
+                BackgroundColour = colourProvider.Background2;
             }
 
             protected override Framework.Graphics.UserInterface.Menu CreateSubMenu() => new SubMenu();
@@ -147,9 +109,27 @@ namespace osu.Game.Screens.Edit.Components.Menus
                 {
                     case EditorMenuItemSpacer spacer:
                         return new DrawableSpacer(spacer);
+
+                    default:
+                        return new EditorMenuItem(item);
+                }
+            }
+
+            private class EditorMenuItem : DrawableOsuMenuItem
+            {
+                public EditorMenuItem(MenuItem item)
+                    : base(item)
+                {
                 }
 
-                return base.CreateDrawableMenuItem(item);
+                [BackgroundDependencyLoader]
+                private void load(OverlayColourProvider colourProvider)
+                {
+                    BackgroundColour = colourProvider.Background2;
+                    BackgroundColourHover = colourProvider.Background1;
+
+                    Foreground.Padding = new MarginPadding { Vertical = 2 };
+                }
             }
 
             private class DrawableSpacer : DrawableOsuMenuItem
@@ -157,6 +137,7 @@ namespace osu.Game.Screens.Edit.Components.Menus
                 public DrawableSpacer(MenuItem item)
                     : base(item)
                 {
+                    Scale = new Vector2(1, 0.3f);
                 }
 
                 protected override bool OnHover(HoverEvent e) => true;

From 206f2ca208fafa01fbfbf616077027ba8360dc41 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 25 May 2022 22:20:33 +0900
Subject: [PATCH 5021/5547] Rename screen switcher control to be in line with
 naming expectations

---
 ...nSelectionTabControl.cs => EditorScreenSwitcherControl.cs} | 4 ++--
 osu.Game/Screens/Edit/Editor.cs                               | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)
 rename osu.Game/Screens/Edit/Components/Menus/{ScreenSelectionTabControl.cs => EditorScreenSwitcherControl.cs} (94%)

diff --git a/osu.Game/Screens/Edit/Components/Menus/ScreenSelectionTabControl.cs b/osu.Game/Screens/Edit/Components/Menus/EditorScreenSwitcherControl.cs
similarity index 94%
rename from osu.Game/Screens/Edit/Components/Menus/ScreenSelectionTabControl.cs
rename to osu.Game/Screens/Edit/Components/Menus/EditorScreenSwitcherControl.cs
index b8bc5cdf36..28a8efcdd2 100644
--- a/osu.Game/Screens/Edit/Components/Menus/ScreenSelectionTabControl.cs
+++ b/osu.Game/Screens/Edit/Components/Menus/EditorScreenSwitcherControl.cs
@@ -13,9 +13,9 @@ using osuTK.Graphics;
 
 namespace osu.Game.Screens.Edit.Components.Menus
 {
-    public class ScreenSelectionTabControl : OsuTabControl<EditorScreenMode>
+    public class EditorScreenSwitcherControl : OsuTabControl<EditorScreenMode>
     {
-        public ScreenSelectionTabControl()
+        public EditorScreenSwitcherControl()
         {
             AutoSizeAxes = Axes.X;
             RelativeSizeAxes = Axes.Y;
diff --git a/osu.Game/Screens/Edit/Editor.cs b/osu.Game/Screens/Edit/Editor.cs
index 7e7764397c..bdf204c1b6 100644
--- a/osu.Game/Screens/Edit/Editor.cs
+++ b/osu.Game/Screens/Edit/Editor.cs
@@ -278,7 +278,7 @@ namespace osu.Game.Screens.Edit
                                     }
                                 }
                             },
-                            new ScreenSelectionTabControl
+                            new EditorScreenSwitcherControl
                             {
                                 Anchor = Anchor.BottomRight,
                                 Origin = Anchor.BottomRight,

From 463b8130c8351e14d7c7295e54b0ea886739beee Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 25 May 2022 22:31:27 +0900
Subject: [PATCH 5022/5547] Update editor screen switcher to match new design
 language

---
 .../Menus/EditorScreenSwitcherControl.cs      | 33 +++++++++++--------
 1 file changed, 19 insertions(+), 14 deletions(-)

diff --git a/osu.Game/Screens/Edit/Components/Menus/EditorScreenSwitcherControl.cs b/osu.Game/Screens/Edit/Components/Menus/EditorScreenSwitcherControl.cs
index 28a8efcdd2..8b868a4649 100644
--- a/osu.Game/Screens/Edit/Components/Menus/EditorScreenSwitcherControl.cs
+++ b/osu.Game/Screens/Edit/Components/Menus/EditorScreenSwitcherControl.cs
@@ -2,14 +2,13 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using osu.Framework.Allocation;
-using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Graphics.UserInterface;
 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
 {
@@ -22,22 +21,19 @@ namespace osu.Game.Screens.Edit.Components.Menus
 
             TabContainer.RelativeSizeAxes &= ~Axes.X;
             TabContainer.AutoSizeAxes = Axes.X;
-            TabContainer.Padding = new MarginPadding();
-
-            AddInternal(new Box
-            {
-                Anchor = Anchor.BottomLeft,
-                Origin = Anchor.BottomLeft,
-                RelativeSizeAxes = Axes.X,
-                Height = 1,
-                Colour = Color4.White.Opacity(0.2f),
-            });
+            TabContainer.Padding = new MarginPadding(10);
         }
 
         [BackgroundDependencyLoader]
-        private void load(OsuColour colours)
+        private void load(OverlayColourProvider colourProvider)
         {
-            AccentColour = colours.Yellow;
+            AccentColour = colourProvider.Light3;
+
+            AddInternal(new Box
+            {
+                RelativeSizeAxes = Axes.Both,
+                Colour = colourProvider.Background2,
+            });
         }
 
         protected override Dropdown<EditorScreenMode> CreateDropdown() => null;
@@ -54,6 +50,15 @@ namespace osu.Game.Screens.Edit.Components.Menus
                 Text.Margin = new MarginPadding();
                 Text.Anchor = Anchor.CentreLeft;
                 Text.Origin = Anchor.CentreLeft;
+
+                Text.Font = OsuFont.TorusAlternate;
+
+                Bar.Expire();
+            }
+
+            [BackgroundDependencyLoader]
+            private void load(OverlayColourProvider colourProvider)
+            {
             }
 
             protected override void OnActivated()

From 91834f03190bfe66303975a54c3c07fbfb415b6a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 25 May 2022 22:56:47 +0900
Subject: [PATCH 5023/5547] Fix missing colour dependency in menu bar test
 scene

---
 osu.Game.Tests/Visual/Editing/TestSceneEditorMenuBar.cs | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneEditorMenuBar.cs b/osu.Game.Tests/Visual/Editing/TestSceneEditorMenuBar.cs
index 3cb44d9ae8..ad6fc55a32 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneEditorMenuBar.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneEditorMenuBar.cs
@@ -2,10 +2,12 @@
 // 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.Graphics.UserInterface;
 using osu.Game.Graphics.UserInterface;
+using osu.Game.Overlays;
 using osu.Game.Screens.Edit.Components.Menus;
 
 namespace osu.Game.Tests.Visual.Editing
@@ -13,6 +15,9 @@ namespace osu.Game.Tests.Visual.Editing
     [TestFixture]
     public class TestSceneEditorMenuBar : OsuTestScene
     {
+        [Cached]
+        private readonly OverlayColourProvider overlayColour = new OverlayColourProvider(OverlayColourScheme.Aquamarine);
+
         public TestSceneEditorMenuBar()
         {
             Add(new Container

From c0da05dda0454690d11d3d5536d322c80cced4c6 Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Wed, 25 May 2022 15:15:26 +0100
Subject: [PATCH 5024/5547] Use an array of channels to exclude from the
 overlay

---
 osu.Game/Overlays/ChatOverlayV2.cs | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/ChatOverlayV2.cs b/osu.Game/Overlays/ChatOverlayV2.cs
index ad7a856dbc..9ca4d9cb6c 100644
--- a/osu.Game/Overlays/ChatOverlayV2.cs
+++ b/osu.Game/Overlays/ChatOverlayV2.cs
@@ -56,6 +56,13 @@ namespace osu.Game.Overlays
         private const float side_bar_width = 190;
         private const float chat_bar_height = 60;
 
+        private readonly ChannelType[] excluded_channel_types = new[]
+        {
+            ChannelType.Multiplayer,
+            ChannelType.Spectator,
+            ChannelType.Temporary,
+        };
+
         [Resolved]
         private OsuConfigManager config { get; set; } = null!;
 
@@ -402,6 +409,6 @@ namespace osu.Game.Overlays
         }
 
         private IEnumerable<Channel> filterToChatChannels(IEnumerable channels)
-            => channels.Cast<Channel>().Where(c => c.Type == ChannelType.PM || c.Type == ChannelType.Public);
+            => channels.Cast<Channel>().Where(c => !excluded_channel_types.Contains(c.Type));
     }
 }

From 997fc716e8609d84e157cf602e468699dff4d04b Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Wed, 25 May 2022 15:15:46 +0100
Subject: [PATCH 5025/5547] Split out the channel list labels from the channel
 list item flow

---
 .../Overlays/Chat/ChannelList/ChannelList.cs  | 35 ++++++++++---------
 1 file changed, 19 insertions(+), 16 deletions(-)

diff --git a/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs b/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs
index 2798841925..21b2251aca 100644
--- a/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs
+++ b/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs
@@ -57,12 +57,14 @@ namespace osu.Game.Overlays.Chat.ChannelList
                         AutoSizeAxes = Axes.Y,
                         Children = new Drawable[]
                         {
-                            publicChannelFlow = new ChannelListItemFlow("CHANNELS"),
+                            new ChannelListLabel("CHANNELS"),
+                            publicChannelFlow = new ChannelListItemFlow(),
                             selector = new ChannelListItem(ChannelListingChannel)
                             {
                                 Margin = new MarginPadding { Bottom = 10 },
                             },
-                            privateChannelFlow = new ChannelListItemFlow("DIRECT MESSAGES"),
+                            new ChannelListLabel("DIRECT MESSAGES"),
+                            privateChannelFlow = new ChannelListItemFlow(),
                         },
                     },
                 },
@@ -105,7 +107,7 @@ namespace osu.Game.Overlays.Chat.ChannelList
             return channelMap[channel];
         }
 
-        public void ScrollChannelIntoView(Channel channel) => scroll.ScrollIntoView(this.GetItem(channel));
+        public void ScrollChannelIntoView(Channel channel) => scroll.ScrollIntoView(GetItem(channel));
 
         private ChannelListItemFlow getFlowForChannel(Channel channel)
         {
@@ -118,28 +120,29 @@ namespace osu.Game.Overlays.Chat.ChannelList
                     return privateChannelFlow;
 
                 default:
-                    throw new ArgumentOutOfRangeException();
+                    return publicChannelFlow;
             }
         }
 
-        private class ChannelListItemFlow : FillFlowContainer
+        private class ChannelListLabel : OsuSpriteText
         {
-            public IEnumerable<Channel> Channels => Children.Where(c => c is ChannelListItem)
-                                                            .Cast<ChannelListItem>()
-                                                            .Select(c => c.Channel);
+            public ChannelListLabel(string label)
+            {
+                Text = label;
+                Margin = new MarginPadding { Left = 18, Bottom = 5 };
+                Font = OsuFont.Torus.With(size: 12, weight: FontWeight.SemiBold);
+            }
+        }
 
-            public ChannelListItemFlow(string label)
+        private class ChannelListItemFlow : FillFlowContainer<ChannelListItem>
+        {
+            public IEnumerable<Channel> Channels => Children.Select(c => c.Channel);
+
+            public ChannelListItemFlow()
             {
                 Direction = FillDirection.Vertical;
                 RelativeSizeAxes = Axes.X;
                 AutoSizeAxes = Axes.Y;
-
-                Add(new OsuSpriteText
-                {
-                    Text = label,
-                    Margin = new MarginPadding { Left = 18, Bottom = 5 },
-                    Font = OsuFont.Torus.With(size: 12, weight: FontWeight.SemiBold),
-                });
             }
         }
     }

From 8791e3b9ef37071dae3f1e44a56060e889f3f7d1 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 25 May 2022 23:10:58 +0900
Subject: [PATCH 5026/5547] Split `BottomBar` out of `Editor`

---
 osu.Game/Screens/Edit/BottomBar.cs |  83 +++++++++++++++++++++
 osu.Game/Screens/Edit/Editor.cs    | 113 ++++++-----------------------
 2 files changed, 107 insertions(+), 89 deletions(-)
 create mode 100644 osu.Game/Screens/Edit/BottomBar.cs

diff --git a/osu.Game/Screens/Edit/BottomBar.cs b/osu.Game/Screens/Edit/BottomBar.cs
new file mode 100644
index 0000000000..e48d54e811
--- /dev/null
+++ b/osu.Game/Screens/Edit/BottomBar.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 osu.Framework.Allocation;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.Shapes;
+using osu.Game.Overlays;
+using osu.Game.Screens.Edit.Components;
+using osu.Game.Screens.Edit.Components.Timelines.Summary;
+using osuTK;
+
+namespace osu.Game.Screens.Edit
+{
+    internal class BottomBar : CompositeDrawable
+    {
+        public TestGameplayButton TestGameplayButton { get; private set; }
+
+        [BackgroundDependencyLoader]
+        private void load(OverlayColourProvider colourProvider, Editor editor)
+        {
+            Anchor = Anchor.BottomLeft;
+            Origin = Anchor.BottomLeft;
+
+            RelativeSizeAxes = Axes.X;
+
+            Height = 60;
+
+            InternalChildren = new Drawable[]
+            {
+                new Box
+                {
+                    RelativeSizeAxes = Axes.Both,
+                    Colour = colourProvider.Background4,
+                },
+                new Container
+                {
+                    RelativeSizeAxes = Axes.Both,
+                    Child = new GridContainer
+                    {
+                        RelativeSizeAxes = Axes.Both,
+                        ColumnDimensions = new[]
+                        {
+                            new Dimension(GridSizeMode.Absolute, 220),
+                            new Dimension(),
+                            new Dimension(GridSizeMode.Absolute, 220),
+                            new Dimension(GridSizeMode.Absolute, 120),
+                        },
+                        Content = new[]
+                        {
+                            new Drawable[]
+                            {
+                                new Container
+                                {
+                                    RelativeSizeAxes = Axes.Both,
+                                    Padding = new MarginPadding { Right = 10 },
+                                    Child = new TimeInfoContainer { RelativeSizeAxes = Axes.Both },
+                                },
+                                new SummaryTimeline
+                                {
+                                    RelativeSizeAxes = Axes.Both,
+                                },
+                                new Container
+                                {
+                                    RelativeSizeAxes = Axes.Both,
+                                    Padding = new MarginPadding { Left = 10 },
+                                    Child = new PlaybackControl { RelativeSizeAxes = Axes.Both },
+                                },
+                                TestGameplayButton = new TestGameplayButton
+                                {
+                                    RelativeSizeAxes = Axes.Both,
+                                    Padding = new MarginPadding { Left = 10 },
+                                    Size = new Vector2(1),
+                                    Action = editor.TestGameplay,
+                                }
+                            },
+                        }
+                    },
+                }
+            };
+        }
+    }
+}
diff --git a/osu.Game/Screens/Edit/Editor.cs b/osu.Game/Screens/Edit/Editor.cs
index 7e7764397c..4281b49e76 100644
--- a/osu.Game/Screens/Edit/Editor.cs
+++ b/osu.Game/Screens/Edit/Editor.cs
@@ -12,7 +12,6 @@ using osu.Framework.Audio.Track;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
-using osu.Framework.Graphics.Shapes;
 using osu.Framework.Graphics.UserInterface;
 using osu.Framework.Input;
 using osu.Framework.Input.Bindings;
@@ -26,7 +25,6 @@ using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.ControlPoints;
 using osu.Game.Configuration;
 using osu.Game.Database;
-using osu.Game.Graphics;
 using osu.Game.Graphics.Cursor;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Input.Bindings;
@@ -37,9 +35,7 @@ using osu.Game.Resources.Localisation.Web;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Edit;
 using osu.Game.Rulesets.Objects;
-using osu.Game.Screens.Edit.Components;
 using osu.Game.Screens.Edit.Components.Menus;
-using osu.Game.Screens.Edit.Components.Timelines.Summary;
 using osu.Game.Screens.Edit.Compose;
 using osu.Game.Screens.Edit.Design;
 using osu.Game.Screens.Edit.GameplayTest;
@@ -48,7 +44,6 @@ using osu.Game.Screens.Edit.Timing;
 using osu.Game.Screens.Edit.Verify;
 using osu.Game.Screens.Play;
 using osu.Game.Users;
-using osuTK;
 using osuTK.Graphics;
 using osuTK.Input;
 
@@ -119,13 +114,13 @@ namespace osu.Game.Screens.Edit
         private IBeatmap playableBeatmap;
         private EditorBeatmap editorBeatmap;
 
+        private BottomBar bottomBar;
+
         [CanBeNull] // Should be non-null once it can support custom rulesets.
         private EditorChangeHandler changeHandler;
 
         private DependencyContainer dependencies;
 
-        private TestGameplayButton testGameplayButton;
-
         private bool isNewBeatmap;
 
         protected override UserActivity InitialActivity => new UserActivity.Editing(Beatmap.Value.BeatmapInfo);
@@ -148,7 +143,7 @@ namespace osu.Game.Screens.Edit
         }
 
         [BackgroundDependencyLoader]
-        private void load(OsuColour colours, OsuConfigManager config)
+        private void load(OsuConfigManager config)
         {
             var loadableBeatmap = Beatmap.Value;
 
@@ -226,7 +221,7 @@ namespace osu.Game.Screens.Edit
             AddInternal(new OsuContextMenuContainer
             {
                 RelativeSizeAxes = Axes.Both,
-                Children = new[]
+                Children = new Drawable[]
                 {
                     new Container
                     {
@@ -287,67 +282,7 @@ namespace osu.Game.Screens.Edit
                             },
                         },
                     },
-                    new Container
-                    {
-                        Name = "Bottom bar",
-                        Anchor = Anchor.BottomLeft,
-                        Origin = Anchor.BottomLeft,
-                        RelativeSizeAxes = Axes.X,
-                        Height = 60,
-                        Children = new Drawable[]
-                        {
-                            new Box
-                            {
-                                RelativeSizeAxes = Axes.Both,
-                                Colour = colours.Gray2
-                            },
-                            new Container
-                            {
-                                RelativeSizeAxes = Axes.Both,
-                                Padding = new MarginPadding { Vertical = 5, Horizontal = 10 },
-                                Child = new GridContainer
-                                {
-                                    RelativeSizeAxes = Axes.Both,
-                                    ColumnDimensions = new[]
-                                    {
-                                        new Dimension(GridSizeMode.Absolute, 220),
-                                        new Dimension(),
-                                        new Dimension(GridSizeMode.Absolute, 220),
-                                        new Dimension(GridSizeMode.Absolute, 120),
-                                    },
-                                    Content = new[]
-                                    {
-                                        new Drawable[]
-                                        {
-                                            new Container
-                                            {
-                                                RelativeSizeAxes = Axes.Both,
-                                                Padding = new MarginPadding { Right = 10 },
-                                                Child = new TimeInfoContainer { RelativeSizeAxes = Axes.Both },
-                                            },
-                                            new SummaryTimeline
-                                            {
-                                                RelativeSizeAxes = Axes.Both,
-                                            },
-                                            new Container
-                                            {
-                                                RelativeSizeAxes = Axes.Both,
-                                                Padding = new MarginPadding { Left = 10 },
-                                                Child = new PlaybackControl { RelativeSizeAxes = Axes.Both },
-                                            },
-                                            testGameplayButton = new TestGameplayButton
-                                            {
-                                                RelativeSizeAxes = Axes.Both,
-                                                Padding = new MarginPadding { Left = 10 },
-                                                Size = new Vector2(1),
-                                                Action = testGameplay
-                                            }
-                                        },
-                                    }
-                                },
-                            }
-                        }
-                    },
+                    bottomBar = new BottomBar(),
                 }
             });
 
@@ -392,6 +327,24 @@ namespace osu.Game.Screens.Edit
             Clipboard.Content.Value = state.ClipboardContent;
         });
 
+        public void TestGameplay()
+        {
+            if (HasUnsavedChanges)
+            {
+                dialogOverlay.Push(new SaveBeforeGameplayTestDialog(() =>
+                {
+                    Save();
+                    pushEditorPlayer();
+                }));
+            }
+            else
+            {
+                pushEditorPlayer();
+            }
+
+            void pushEditorPlayer() => this.Push(new EditorPlayerLoader(this));
+        }
+
         /// <summary>
         /// Saves the currently edited beatmap.
         /// </summary>
@@ -589,7 +542,7 @@ namespace osu.Game.Screens.Edit
                     return true;
 
                 case GlobalAction.EditorTestGameplay:
-                    testGameplayButton.TriggerClick();
+                    bottomBar.TestGameplayButton.TriggerClick();
                     return true;
 
                 default:
@@ -935,24 +888,6 @@ namespace osu.Game.Screens.Edit
             loader?.CancelPendingDifficultySwitch();
         }
 
-        private void testGameplay()
-        {
-            if (HasUnsavedChanges)
-            {
-                dialogOverlay.Push(new SaveBeforeGameplayTestDialog(() =>
-                {
-                    Save();
-                    pushEditorPlayer();
-                }));
-            }
-            else
-            {
-                pushEditorPlayer();
-            }
-
-            void pushEditorPlayer() => this.Push(new EditorPlayerLoader(this));
-        }
-
         public double SnapTime(double time, double? referenceTime) => editorBeatmap.SnapTime(time, referenceTime);
 
         public double GetBeatLengthAtTime(double referenceTime) => editorBeatmap.GetBeatLengthAtTime(referenceTime);

From 2c61a9d3d1b4cf1035d3a087c283ac086c2682a4 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 25 May 2022 23:17:52 +0900
Subject: [PATCH 5027/5547] Update bottom bar components to new design language
 (mostly)

---
 osu.Game/Screens/Edit/BottomBar.cs            | 19 +++----------------
 .../Edit/Components/BottomBarContainer.cs     | 16 ++++++++--------
 .../Edit/Components/PlaybackControl.cs        |  7 ++++---
 .../Edit/Components/TimeInfoContainer.cs      |  8 ++++++--
 .../Timelines/Summary/SummaryTimeline.cs      | 10 ++++++----
 .../Timelines/Summary/TestGameplayButton.cs   |  2 ++
 6 files changed, 29 insertions(+), 33 deletions(-)

diff --git a/osu.Game/Screens/Edit/BottomBar.cs b/osu.Game/Screens/Edit/BottomBar.cs
index e48d54e811..0f857940b3 100644
--- a/osu.Game/Screens/Edit/BottomBar.cs
+++ b/osu.Game/Screens/Edit/BottomBar.cs
@@ -50,22 +50,9 @@ namespace osu.Game.Screens.Edit
                         {
                             new Drawable[]
                             {
-                                new Container
-                                {
-                                    RelativeSizeAxes = Axes.Both,
-                                    Padding = new MarginPadding { Right = 10 },
-                                    Child = new TimeInfoContainer { RelativeSizeAxes = Axes.Both },
-                                },
-                                new SummaryTimeline
-                                {
-                                    RelativeSizeAxes = Axes.Both,
-                                },
-                                new Container
-                                {
-                                    RelativeSizeAxes = Axes.Both,
-                                    Padding = new MarginPadding { Left = 10 },
-                                    Child = new PlaybackControl { RelativeSizeAxes = Axes.Both },
-                                },
+                                new TimeInfoContainer { RelativeSizeAxes = Axes.Both },
+                                new SummaryTimeline { RelativeSizeAxes = Axes.Both },
+                                new PlaybackControl { RelativeSizeAxes = Axes.Both },
                                 TestGameplayButton = new TestGameplayButton
                                 {
                                     RelativeSizeAxes = Axes.Both,
diff --git a/osu.Game/Screens/Edit/Components/BottomBarContainer.cs b/osu.Game/Screens/Edit/Components/BottomBarContainer.cs
index 08091fc3f7..3c63da3a4a 100644
--- a/osu.Game/Screens/Edit/Components/BottomBarContainer.cs
+++ b/osu.Game/Screens/Edit/Components/BottomBarContainer.cs
@@ -8,20 +8,19 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
 using osu.Game.Beatmaps;
-using osu.Game.Graphics;
+using osuTK.Graphics;
 
 namespace osu.Game.Screens.Edit.Components
 {
     public class BottomBarContainer : Container
     {
-        private const float corner_radius = 5;
         private const float contents_padding = 15;
 
         protected readonly IBindable<WorkingBeatmap> Beatmap = new Bindable<WorkingBeatmap>();
 
         protected readonly IBindable<Track> Track = new Bindable<Track>();
 
-        private readonly Drawable background;
+        protected readonly Drawable Background;
         private readonly Container content;
 
         protected override Container<Drawable> Content => content;
@@ -29,11 +28,14 @@ namespace osu.Game.Screens.Edit.Components
         public BottomBarContainer()
         {
             Masking = true;
-            CornerRadius = corner_radius;
 
             InternalChildren = new[]
             {
-                background = new Box { RelativeSizeAxes = Axes.Both },
+                Background = new Box
+                {
+                    RelativeSizeAxes = Axes.Both,
+                    Colour = Color4.Transparent,
+                },
                 content = new Container
                 {
                     RelativeSizeAxes = Axes.Both,
@@ -43,12 +45,10 @@ namespace osu.Game.Screens.Edit.Components
         }
 
         [BackgroundDependencyLoader]
-        private void load(IBindable<WorkingBeatmap> beatmap, OsuColour colours, EditorClock clock)
+        private void load(IBindable<WorkingBeatmap> beatmap, EditorClock clock)
         {
             Beatmap.BindTo(beatmap);
             Track.BindTo(clock.Track);
-
-            background.Colour = colours.Gray1;
         }
     }
 }
diff --git a/osu.Game/Screens/Edit/Components/PlaybackControl.cs b/osu.Game/Screens/Edit/Components/PlaybackControl.cs
index bdc6e238c8..d1a999c2d1 100644
--- a/osu.Game/Screens/Edit/Components/PlaybackControl.cs
+++ b/osu.Game/Screens/Edit/Components/PlaybackControl.cs
@@ -16,6 +16,7 @@ using osu.Framework.Input.Events;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.UserInterface;
+using osu.Game.Overlays;
 using osuTK.Input;
 
 namespace osu.Game.Screens.Edit.Components
@@ -155,10 +156,10 @@ namespace osu.Game.Screens.Edit.Components
                 private Color4 normalColour;
 
                 [BackgroundDependencyLoader]
-                private void load(OsuColour colours)
+                private void load(OverlayColourProvider colourProvider)
                 {
-                    text.Colour = normalColour = colours.YellowDarker;
-                    textBold.Colour = hoveredColour = colours.Yellow;
+                    text.Colour = normalColour = colourProvider.Light3;
+                    textBold.Colour = hoveredColour = colourProvider.Content1;
                 }
 
                 protected override bool OnHover(HoverEvent e)
diff --git a/osu.Game/Screens/Edit/Components/TimeInfoContainer.cs b/osu.Game/Screens/Edit/Components/TimeInfoContainer.cs
index 0a8c339559..ac79a8ce7e 100644
--- a/osu.Game/Screens/Edit/Components/TimeInfoContainer.cs
+++ b/osu.Game/Screens/Edit/Components/TimeInfoContainer.cs
@@ -6,18 +6,22 @@ using osu.Game.Graphics.Sprites;
 using osu.Framework.Allocation;
 using osu.Game.Extensions;
 using osu.Game.Graphics;
+using osu.Game.Overlays;
 
 namespace osu.Game.Screens.Edit.Components
 {
     public class TimeInfoContainer : BottomBarContainer
     {
-        private readonly OsuSpriteText trackTimer;
+        private OsuSpriteText trackTimer;
 
         [Resolved]
         private EditorClock editorClock { get; set; }
 
-        public TimeInfoContainer()
+        [BackgroundDependencyLoader]
+        private void load(OverlayColourProvider colourProvider)
         {
+            Background.Colour = colourProvider.Background5;
+
             Children = new Drawable[]
             {
                 trackTimer = new OsuSpriteText
diff --git a/osu.Game/Screens/Edit/Components/Timelines/Summary/SummaryTimeline.cs b/osu.Game/Screens/Edit/Components/Timelines/Summary/SummaryTimeline.cs
index e90ae411de..1706c47c96 100644
--- a/osu.Game/Screens/Edit/Components/Timelines/Summary/SummaryTimeline.cs
+++ b/osu.Game/Screens/Edit/Components/Timelines/Summary/SummaryTimeline.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 osuTK;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
-using osu.Game.Graphics;
+using osu.Game.Overlays;
 using osu.Game.Screens.Edit.Components.Timelines.Summary.Parts;
+using osuTK;
 
 namespace osu.Game.Screens.Edit.Components.Timelines.Summary
 {
@@ -17,8 +17,10 @@ namespace osu.Game.Screens.Edit.Components.Timelines.Summary
     public class SummaryTimeline : BottomBarContainer
     {
         [BackgroundDependencyLoader]
-        private void load(OsuColour colours)
+        private void load(OverlayColourProvider colourProvider)
         {
+            Background.Colour = colourProvider.Background6;
+
             Children = new Drawable[]
             {
                 new MarkerPart { RelativeSizeAxes = Axes.Both },
@@ -41,7 +43,7 @@ namespace osu.Game.Screens.Edit.Components.Timelines.Summary
                 {
                     Name = "centre line",
                     RelativeSizeAxes = Axes.Both,
-                    Colour = colours.Gray5,
+                    Colour = colourProvider.Background2,
                     Children = new Drawable[]
                     {
                         new Circle
diff --git a/osu.Game/Screens/Edit/Components/Timelines/Summary/TestGameplayButton.cs b/osu.Game/Screens/Edit/Components/Timelines/Summary/TestGameplayButton.cs
index 0d7a4ad057..99cdc014aa 100644
--- a/osu.Game/Screens/Edit/Components/Timelines/Summary/TestGameplayButton.cs
+++ b/osu.Game/Screens/Edit/Components/Timelines/Summary/TestGameplayButton.cs
@@ -28,6 +28,8 @@ namespace osu.Game.Screens.Edit.Components.Timelines.Summary
             BackgroundColour = colours.Orange1;
             SpriteText.Colour = colourProvider.Background6;
 
+            Content.CornerRadius = 0;
+
             Text = "Test!";
         }
     }

From acd554d91820fa861612c9978d80bbbf2ad6c42c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 25 May 2022 23:30:53 +0900
Subject: [PATCH 5028/5547] Update time info and add bpm

---
 .../Editing/TestScenePlaybackControl.cs       |  2 +-
 .../Edit/Components/TimeInfoContainer.cs      | 23 +++++++++++++++----
 osu.Game/Tests/Visual/EditorClockTestScene.cs |  9 +++++++-
 3 files changed, 27 insertions(+), 7 deletions(-)

diff --git a/osu.Game.Tests/Visual/Editing/TestScenePlaybackControl.cs b/osu.Game.Tests/Visual/Editing/TestScenePlaybackControl.cs
index 6aa884a197..bf0a7876a9 100644
--- a/osu.Game.Tests/Visual/Editing/TestScenePlaybackControl.cs
+++ b/osu.Game.Tests/Visual/Editing/TestScenePlaybackControl.cs
@@ -12,7 +12,7 @@ using osuTK;
 namespace osu.Game.Tests.Visual.Editing
 {
     [TestFixture]
-    public class TestScenePlaybackControl : OsuTestScene
+    public class TestScenePlaybackControl : EditorClockTestScene
     {
         [BackgroundDependencyLoader]
         private void load()
diff --git a/osu.Game/Screens/Edit/Components/TimeInfoContainer.cs b/osu.Game/Screens/Edit/Components/TimeInfoContainer.cs
index ac79a8ce7e..6024716f4b 100644
--- a/osu.Game/Screens/Edit/Components/TimeInfoContainer.cs
+++ b/osu.Game/Screens/Edit/Components/TimeInfoContainer.cs
@@ -7,18 +7,23 @@ using osu.Framework.Allocation;
 using osu.Game.Extensions;
 using osu.Game.Graphics;
 using osu.Game.Overlays;
+using osuTK;
 
 namespace osu.Game.Screens.Edit.Components
 {
     public class TimeInfoContainer : BottomBarContainer
     {
         private OsuSpriteText trackTimer;
+        private OsuSpriteText bpm;
+
+        [Resolved]
+        private EditorBeatmap editorBeatmap { get; set; }
 
         [Resolved]
         private EditorClock editorClock { get; set; }
 
         [BackgroundDependencyLoader]
-        private void load(OverlayColourProvider colourProvider)
+        private void load(OsuColour colours, OverlayColourProvider colourProvider)
         {
             Background.Colour = colourProvider.Background5;
 
@@ -28,10 +33,16 @@ namespace osu.Game.Screens.Edit.Components
                 {
                     Anchor = Anchor.CentreRight,
                     Origin = Anchor.CentreRight,
-                    // intentionally fudged centre to avoid movement of the number portion when
-                    // going negative.
-                    X = -35,
-                    Font = OsuFont.GetFont(size: 25, fixedWidth: true),
+                    Spacing = new Vector2(-2, 0),
+                    Font = OsuFont.Torus.With(size: 36, fixedWidth: true, weight: FontWeight.Light),
+                    Y = -10,
+                },
+                bpm = new OsuSpriteText
+                {
+                    Colour = colours.Orange1,
+                    Anchor = Anchor.CentreRight,
+                    Font = OsuFont.Torus.With(size: 18, weight: FontWeight.SemiBold),
+                    Y = 5,
                 }
             };
         }
@@ -40,6 +51,8 @@ namespace osu.Game.Screens.Edit.Components
         {
             base.Update();
             trackTimer.Text = editorClock.CurrentTime.ToEditorFormattedString();
+            bpm.Text = @$"{editorBeatmap.ControlPointInfo.TimingPointAt(editorClock.CurrentTime).BPM:0} BPM";
+            bpm.X = 5 - trackTimer.DrawWidth;
         }
     }
 }
diff --git a/osu.Game/Tests/Visual/EditorClockTestScene.cs b/osu.Game/Tests/Visual/EditorClockTestScene.cs
index 542f06f86b..93dfe58076 100644
--- a/osu.Game/Tests/Visual/EditorClockTestScene.cs
+++ b/osu.Game/Tests/Visual/EditorClockTestScene.cs
@@ -6,6 +6,7 @@ using osu.Framework.Bindables;
 using osu.Framework.Input.Events;
 using osu.Game.Beatmaps;
 using osu.Game.Overlays;
+using osu.Game.Rulesets.Edit;
 using osu.Game.Screens.Edit;
 
 namespace osu.Game.Tests.Visual
@@ -19,6 +20,10 @@ namespace osu.Game.Tests.Visual
         [Cached]
         private readonly OverlayColourProvider overlayColour = new OverlayColourProvider(OverlayColourScheme.Aquamarine);
 
+        [Cached(typeof(EditorBeatmap))]
+        [Cached(typeof(IBeatSnapProvider))]
+        private readonly EditorBeatmap editorBeatmap;
+
         protected readonly BindableBeatDivisor BeatDivisor = new BindableBeatDivisor();
         protected new readonly EditorClock Clock;
 
@@ -26,7 +31,9 @@ namespace osu.Game.Tests.Visual
 
         protected EditorClockTestScene()
         {
-            Clock = new EditorClock(new Beatmap(), BeatDivisor) { IsCoupled = false };
+            editorBeatmap = new EditorBeatmap(new Beatmap());
+
+            Clock = new EditorClock(editorBeatmap, BeatDivisor) { IsCoupled = false };
         }
 
         protected override IReadOnlyDependencyContainer CreateChildDependencies(IReadOnlyDependencyContainer parent)

From f94afa5f8cf0b384322ba12a1ca527b36bae1580 Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Wed, 25 May 2022 18:28:18 +0100
Subject: [PATCH 5029/5547] Code quality

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

diff --git a/osu.Game/Overlays/ChatOverlayV2.cs b/osu.Game/Overlays/ChatOverlayV2.cs
index 9ca4d9cb6c..68199c9d25 100644
--- a/osu.Game/Overlays/ChatOverlayV2.cs
+++ b/osu.Game/Overlays/ChatOverlayV2.cs
@@ -56,7 +56,7 @@ namespace osu.Game.Overlays
         private const float side_bar_width = 190;
         private const float chat_bar_height = 60;
 
-        private readonly ChannelType[] excluded_channel_types = new[]
+        private readonly ChannelType[] excludedChannelTypes =
         {
             ChannelType.Multiplayer,
             ChannelType.Spectator,
@@ -409,6 +409,6 @@ namespace osu.Game.Overlays
         }
 
         private IEnumerable<Channel> filterToChatChannels(IEnumerable channels)
-            => channels.Cast<Channel>().Where(c => !excluded_channel_types.Contains(c.Type));
+            => channels.Cast<Channel>().Where(c => !excludedChannelTypes.Contains(c.Type));
     }
 }

From 4f8b6b52ba1757396e1ef407d47bed974d5568f0 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 25 May 2022 21:49:31 +0200
Subject: [PATCH 5030/5547] Add failing test coverage for select/deselect all
 enable behaviour

---
 .../Visual/Multiplayer/TestSceneFreeModSelectOverlay.cs       | 4 ++++
 .../Visual/UserInterface/TestSceneModSelectOverlay.cs         | 4 ++++
 2 files changed, 8 insertions(+)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneFreeModSelectOverlay.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneFreeModSelectOverlay.cs
index c37bff2066..44ae467c80 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneFreeModSelectOverlay.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneFreeModSelectOverlay.cs
@@ -73,12 +73,15 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             createFreeModSelect();
 
+            AddAssert("select all button enabled", () => this.ChildrenOfType<ShearedButton>().ElementAt(1).Enabled.Value);
+
             AddStep("click select all button", () =>
             {
                 InputManager.MoveMouseTo(this.ChildrenOfType<ShearedButton>().ElementAt(1));
                 InputManager.Click(MouseButton.Left);
             });
             AddUntilStep("all mods selected", assertAllAvailableModsSelected);
+            AddAssert("select all button disabled", () => !this.ChildrenOfType<ShearedButton>().ElementAt(1).Enabled.Value);
 
             AddStep("click deselect all button", () =>
             {
@@ -86,6 +89,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 InputManager.Click(MouseButton.Left);
             });
             AddUntilStep("all mods deselected", () => !freeModSelectOverlay.SelectedMods.Value.Any());
+            AddAssert("select all button enabled", () => this.ChildrenOfType<ShearedButton>().ElementAt(1).Enabled.Value);
         }
 
         private void createFreeModSelect()
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectOverlay.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectOverlay.cs
index 75e30f76c3..0c3acded88 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectOverlay.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectOverlay.cs
@@ -435,8 +435,11 @@ namespace osu.Game.Tests.Visual.UserInterface
             createScreen();
             changeRuleset(0);
 
+            AddAssert("deselect all button disabled", () => !this.ChildrenOfType<ShearedButton>().Last().Enabled.Value);
+
             AddStep("select DT + HD", () => SelectedMods.Value = new Mod[] { new OsuModDoubleTime(), new OsuModHidden() });
             AddAssert("DT + HD selected", () => modSelectOverlay.ChildrenOfType<ModPanel>().Count(panel => panel.Active.Value) == 2);
+            AddAssert("deselect all button enabled", () => this.ChildrenOfType<ShearedButton>().Last().Enabled.Value);
 
             AddStep("click deselect all button", () =>
             {
@@ -444,6 +447,7 @@ namespace osu.Game.Tests.Visual.UserInterface
                 InputManager.Click(MouseButton.Left);
             });
             AddUntilStep("all mods deselected", () => !SelectedMods.Value.Any());
+            AddAssert("deselect all button disabled", () => !this.ChildrenOfType<ShearedButton>().Last().Enabled.Value);
         }
 
         [Test]

From a4bd399b0cbd6a1c14a20fbb8fc2b431f2e97ea7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 25 May 2022 22:09:31 +0200
Subject: [PATCH 5031/5547] Split off "deselect all mods" button to separate
 class

---
 .../Overlays/Mods/DeselectAllModsButton.cs    | 38 +++++++++++++++++++
 osu.Game/Overlays/Mods/ModSelectOverlay.cs    | 15 ++------
 2 files changed, 41 insertions(+), 12 deletions(-)
 create mode 100644 osu.Game/Overlays/Mods/DeselectAllModsButton.cs

diff --git a/osu.Game/Overlays/Mods/DeselectAllModsButton.cs b/osu.Game/Overlays/Mods/DeselectAllModsButton.cs
new file mode 100644
index 0000000000..39009c8656
--- /dev/null
+++ b/osu.Game/Overlays/Mods/DeselectAllModsButton.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 System.Linq;
+using osu.Framework.Bindables;
+using osu.Framework.Input.Bindings;
+using osu.Framework.Input.Events;
+using osu.Game.Graphics.UserInterface;
+using osu.Game.Input.Bindings;
+using osu.Game.Localisation;
+using osu.Game.Rulesets.Mods;
+
+namespace osu.Game.Overlays.Mods
+{
+    public class DeselectAllModsButton : ShearedButton, IKeyBindingHandler<GlobalAction>
+    {
+        public DeselectAllModsButton(ModSelectOverlay modSelectOverlay)
+            : base(ModSelectOverlay.BUTTON_WIDTH)
+        {
+            Text = CommonStrings.DeselectAll;
+            Action = modSelectOverlay.DeselectAll;
+        }
+
+        public bool OnPressed(KeyBindingPressEvent<GlobalAction> e)
+        {
+            if (e.Repeat || e.Action != GlobalAction.DeselectAllMods)
+                return false;
+
+            TriggerClick();
+            return true;
+        }
+
+        public void OnReleased(KeyBindingReleaseEvent<GlobalAction> e)
+        {
+        }
+    }
+}
diff --git a/osu.Game/Overlays/Mods/ModSelectOverlay.cs b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
index f1a998bd3c..ea7f969450 100644
--- a/osu.Game/Overlays/Mods/ModSelectOverlay.cs
+++ b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
@@ -29,7 +29,7 @@ namespace osu.Game.Overlays.Mods
 {
     public abstract class ModSelectOverlay : ShearedOverlayContainer, ISamplePlaybackDisabler
     {
-        protected const int BUTTON_WIDTH = 200;
+        public const int BUTTON_WIDTH = 200;
 
         [Cached]
         public Bindable<IReadOnlyList<Mod>> SelectedMods { get; private set; } = new Bindable<IReadOnlyList<Mod>>(Array.Empty<Mod>());
@@ -76,11 +76,7 @@ namespace osu.Game.Overlays.Mods
                 };
             }
 
-            yield return deselectAllButton = new ShearedButton(BUTTON_WIDTH)
-            {
-                Text = CommonStrings.DeselectAll,
-                Action = DeselectAll
-            };
+            yield return new DeselectAllModsButton(this);
         }
 
         private readonly Bindable<Dictionary<ModType, IReadOnlyList<Mod>>> availableMods = new Bindable<Dictionary<ModType, IReadOnlyList<Mod>>>();
@@ -98,7 +94,6 @@ namespace osu.Game.Overlays.Mods
         private DifficultyMultiplierDisplay? multiplierDisplay;
 
         private ShearedToggleButton? customisationButton;
-        private ShearedButton? deselectAllButton;
 
         protected ModSelectOverlay(OverlayColourScheme colourScheme = OverlayColourScheme.Green)
             : base(colourScheme)
@@ -256,7 +251,7 @@ namespace osu.Game.Overlays.Mods
         /// <summary>
         /// Deselect all visible mods in all columns.
         /// </summary>
-        protected void DeselectAll()
+        public void DeselectAll()
         {
             foreach (var column in columnFlow.Columns)
                 column.DeselectAll();
@@ -514,10 +509,6 @@ namespace osu.Game.Overlays.Mods
                     hideOverlay(true);
                     return true;
                 }
-
-                case GlobalAction.DeselectAllMods:
-                    deselectAllButton?.TriggerClick();
-                    return true;
             }
 
             return base.OnPressed(e);

From a3f29625587fd0cb52c8d4042dd1b48f82d62db2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 25 May 2022 22:12:09 +0200
Subject: [PATCH 5032/5547] Disable "deselect all mods" button if none are
 selected

---
 osu.Game/Overlays/Mods/DeselectAllModsButton.cs | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/osu.Game/Overlays/Mods/DeselectAllModsButton.cs b/osu.Game/Overlays/Mods/DeselectAllModsButton.cs
index 39009c8656..8288d34c95 100644
--- a/osu.Game/Overlays/Mods/DeselectAllModsButton.cs
+++ b/osu.Game/Overlays/Mods/DeselectAllModsButton.cs
@@ -15,11 +15,27 @@ namespace osu.Game.Overlays.Mods
 {
     public class DeselectAllModsButton : ShearedButton, IKeyBindingHandler<GlobalAction>
     {
+        private readonly Bindable<IReadOnlyList<Mod>> selectedMods = new Bindable<IReadOnlyList<Mod>>();
+
         public DeselectAllModsButton(ModSelectOverlay modSelectOverlay)
             : base(ModSelectOverlay.BUTTON_WIDTH)
         {
             Text = CommonStrings.DeselectAll;
             Action = modSelectOverlay.DeselectAll;
+
+            selectedMods.BindTo(modSelectOverlay.SelectedMods);
+        }
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            selectedMods.BindValueChanged(_ => updateEnabledState(), true);
+        }
+
+        private void updateEnabledState()
+        {
+            Enabled.Value = selectedMods.Value.Any();
         }
 
         public bool OnPressed(KeyBindingPressEvent<GlobalAction> e)

From f0303d76e8e8dfb4b174bec2bd15e5a9aae23f08 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 25 May 2022 22:18:30 +0200
Subject: [PATCH 5033/5547] Split off "select all mods" button to separate
 class

---
 osu.Game/Overlays/Mods/ModSelectOverlay.cs    |  2 +-
 osu.Game/Overlays/Mods/SelectAllModsButton.cs | 35 +++++++++++++++++++
 .../OnlinePlay/FreeModSelectOverlay.cs        | 31 ++--------------
 3 files changed, 38 insertions(+), 30 deletions(-)
 create mode 100644 osu.Game/Overlays/Mods/SelectAllModsButton.cs

diff --git a/osu.Game/Overlays/Mods/ModSelectOverlay.cs b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
index ea7f969450..d8355a4dea 100644
--- a/osu.Game/Overlays/Mods/ModSelectOverlay.cs
+++ b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
@@ -242,7 +242,7 @@ namespace osu.Game.Overlays.Mods
         /// <summary>
         /// Select all visible mods in all columns.
         /// </summary>
-        protected void SelectAll()
+        public void SelectAll()
         {
             foreach (var column in columnFlow.Columns)
                 column.SelectAll();
diff --git a/osu.Game/Overlays/Mods/SelectAllModsButton.cs b/osu.Game/Overlays/Mods/SelectAllModsButton.cs
new file mode 100644
index 0000000000..b9d6bf9633
--- /dev/null
+++ b/osu.Game/Overlays/Mods/SelectAllModsButton.cs
@@ -0,0 +1,35 @@
+// 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.Input;
+using osu.Framework.Input.Bindings;
+using osu.Framework.Input.Events;
+using osu.Game.Graphics.UserInterface;
+using osu.Game.Localisation;
+using osu.Game.Screens.OnlinePlay;
+
+namespace osu.Game.Overlays.Mods
+{
+    public class SelectAllModsButton : ShearedButton, IKeyBindingHandler<PlatformAction>
+    {
+        public SelectAllModsButton(FreeModSelectOverlay modSelectOverlay)
+            : base(ModSelectOverlay.BUTTON_WIDTH)
+        {
+            Text = CommonStrings.SelectAll;
+            Action = modSelectOverlay.SelectAll;
+        }
+
+        public bool OnPressed(KeyBindingPressEvent<PlatformAction> e)
+        {
+            if (e.Repeat || e.Action != PlatformAction.SelectAll)
+                return false;
+
+            TriggerClick();
+            return true;
+        }
+
+        public void OnReleased(KeyBindingReleaseEvent<PlatformAction> e)
+        {
+        }
+    }
+}
diff --git a/osu.Game/Screens/OnlinePlay/FreeModSelectOverlay.cs b/osu.Game/Screens/OnlinePlay/FreeModSelectOverlay.cs
index f494f9799a..7c9184cc0f 100644
--- a/osu.Game/Screens/OnlinePlay/FreeModSelectOverlay.cs
+++ b/osu.Game/Screens/OnlinePlay/FreeModSelectOverlay.cs
@@ -6,18 +6,14 @@ using osu.Game.Overlays;
 using System.Collections.Generic;
 using System.Linq;
 using osu.Framework.Graphics;
-using osu.Framework.Input;
-using osu.Framework.Input.Bindings;
-using osu.Framework.Input.Events;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Overlays.Mods;
 using osu.Game.Rulesets.Mods;
 using osuTK.Input;
-using osu.Game.Localisation;
 
 namespace osu.Game.Screens.OnlinePlay
 {
-    public class FreeModSelectOverlay : ModSelectOverlay, IKeyBindingHandler<PlatformAction>
+    public class FreeModSelectOverlay : ModSelectOverlay
     {
         protected override bool ShowTotalMultiplier => false;
 
@@ -29,8 +25,6 @@ namespace osu.Game.Screens.OnlinePlay
             set => base.IsValidMod = m => m.UserPlayable && value.Invoke(m);
         }
 
-        private ShearedButton selectAllButton;
-
         public FreeModSelectOverlay()
             : base(OverlayColourScheme.Plum)
         {
@@ -40,31 +34,10 @@ namespace osu.Game.Screens.OnlinePlay
         protected override ModColumn CreateModColumn(ModType modType, Key[] toggleKeys = null) => new ModColumn(modType, true, toggleKeys);
 
         protected override IEnumerable<ShearedButton> CreateFooterButtons() => base.CreateFooterButtons().Prepend(
-            selectAllButton = new ShearedButton(BUTTON_WIDTH)
+            new SelectAllModsButton(this)
             {
                 Anchor = Anchor.BottomLeft,
                 Origin = Anchor.BottomLeft,
-                Text = CommonStrings.SelectAll,
-                Action = SelectAll
             });
-
-        public bool OnPressed(KeyBindingPressEvent<PlatformAction> e)
-        {
-            if (e.Repeat)
-                return false;
-
-            switch (e.Action)
-            {
-                case PlatformAction.SelectAll:
-                    selectAllButton.TriggerClick();
-                    return true;
-            }
-
-            return false;
-        }
-
-        public void OnReleased(KeyBindingReleaseEvent<PlatformAction> e)
-        {
-        }
     }
 }

From 071e158a297139bff0812b567cf6f6064e98839e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 25 May 2022 22:20:10 +0200
Subject: [PATCH 5034/5547] Expose available mod state outwardly as a bindable

---
 osu.Game/Overlays/Mods/ModSelectOverlay.cs | 38 ++++++++++++++--------
 1 file changed, 24 insertions(+), 14 deletions(-)

diff --git a/osu.Game/Overlays/Mods/ModSelectOverlay.cs b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
index d8355a4dea..4bad34d94f 100644
--- a/osu.Game/Overlays/Mods/ModSelectOverlay.cs
+++ b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
@@ -34,6 +34,15 @@ 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>
+        /// <remarks>
+        /// Contrary to <see cref="OsuGameBase.AvailableMods"/> and <see cref="globalAvailableMods"/>, the <see cref="Mod"/> instances
+        /// inside the <see cref="ModState"/> objects are owned solely by this <see cref="ModSelectOverlay"/> instance.
+        /// </remarks>
+        public Bindable<Dictionary<ModType, IReadOnlyList<ModState>>> AvailableMods { get; } = new Bindable<Dictionary<ModType, IReadOnlyList<ModState>>>(new Dictionary<ModType, IReadOnlyList<ModState>>());
+
         private Func<Mod, bool> isValidMod = m => true;
 
         /// <summary>
@@ -79,9 +88,9 @@ namespace osu.Game.Overlays.Mods
             yield return new DeselectAllModsButton(this);
         }
 
-        private readonly Bindable<Dictionary<ModType, IReadOnlyList<Mod>>> availableMods = new Bindable<Dictionary<ModType, IReadOnlyList<Mod>>>();
-        private readonly Dictionary<ModType, IReadOnlyList<ModState>> localAvailableMods = new Dictionary<ModType, IReadOnlyList<ModState>>();
-        private IEnumerable<ModState> allLocalAvailableMods => localAvailableMods.SelectMany(pair => pair.Value);
+        private readonly Bindable<Dictionary<ModType, IReadOnlyList<Mod>>> globalAvailableMods = new Bindable<Dictionary<ModType, IReadOnlyList<Mod>>>();
+
+        private IEnumerable<ModState> allAvailableMods => AvailableMods.Value.SelectMany(pair => pair.Value);
 
         private readonly BindableBool customisationVisible = new BindableBool();
 
@@ -204,13 +213,13 @@ namespace osu.Game.Overlays.Mods
                 })
             };
 
-            availableMods.BindTo(game.AvailableMods);
+            globalAvailableMods.BindTo(game.AvailableMods);
         }
 
         protected override void LoadComplete()
         {
             // this is called before base call so that the mod state is populated early, and the transition in `PopIn()` can play out properly.
-            availableMods.BindValueChanged(_ => createLocalMods(), true);
+            globalAvailableMods.BindValueChanged(_ => createLocalMods(), true);
 
             base.LoadComplete();
 
@@ -275,9 +284,9 @@ namespace osu.Game.Overlays.Mods
 
         private void createLocalMods()
         {
-            localAvailableMods.Clear();
+            var newLocalAvailableMods = new Dictionary<ModType, IReadOnlyList<ModState>>();
 
-            foreach (var (modType, mods) in availableMods.Value)
+            foreach (var (modType, mods) in globalAvailableMods.Value)
             {
                 var modStates = mods.SelectMany(ModUtils.FlattenMod)
                                     .Select(mod => new ModState(mod.DeepClone()))
@@ -286,18 +295,19 @@ namespace osu.Game.Overlays.Mods
                 foreach (var modState in modStates)
                     modState.Active.BindValueChanged(_ => updateFromInternalSelection());
 
-                localAvailableMods[modType] = modStates;
+                newLocalAvailableMods[modType] = modStates;
             }
 
+            AvailableMods.Value = newLocalAvailableMods;
             filterMods();
 
             foreach (var column in columnFlow.Columns)
-                column.AvailableMods = localAvailableMods.GetValueOrDefault(column.ModType, Array.Empty<ModState>());
+                column.AvailableMods = AvailableMods.Value.GetValueOrDefault(column.ModType, Array.Empty<ModState>());
         }
 
         private void filterMods()
         {
-            foreach (var modState in allLocalAvailableMods)
+            foreach (var modState in allAvailableMods)
                 modState.Filtered.Value = !modState.Mod.HasImplementation || !IsValidMod.Invoke(modState.Mod);
         }
 
@@ -378,7 +388,7 @@ namespace osu.Game.Overlays.Mods
 
             var newSelection = new List<Mod>();
 
-            foreach (var modState in allLocalAvailableMods)
+            foreach (var modState in allAvailableMods)
             {
                 var matchingSelectedMod = SelectedMods.Value.SingleOrDefault(selected => selected.GetType() == modState.Mod.GetType());
 
@@ -405,9 +415,9 @@ namespace osu.Game.Overlays.Mods
             if (externalSelectionUpdateInProgress)
                 return;
 
-            var candidateSelection = allLocalAvailableMods.Where(modState => modState.Active.Value)
-                                                          .Select(modState => modState.Mod)
-                                                          .ToArray();
+            var candidateSelection = allAvailableMods.Where(modState => modState.Active.Value)
+                                                     .Select(modState => modState.Mod)
+                                                     .ToArray();
 
             SelectedMods.Value = ComputeNewModsFromSelection(SelectedMods.Value, candidateSelection);
         }

From a1b8fa09921666ee65531cea264aeade2aa5718b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 25 May 2022 22:24:26 +0200
Subject: [PATCH 5035/5547] Disable "select all mods" button if all are
 selected

---
 osu.Game/Overlays/Mods/SelectAllModsButton.cs | 26 +++++++++++++++++++
 1 file changed, 26 insertions(+)

diff --git a/osu.Game/Overlays/Mods/SelectAllModsButton.cs b/osu.Game/Overlays/Mods/SelectAllModsButton.cs
index b9d6bf9633..f7078b2fa5 100644
--- a/osu.Game/Overlays/Mods/SelectAllModsButton.cs
+++ b/osu.Game/Overlays/Mods/SelectAllModsButton.cs
@@ -1,22 +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 System.Collections.Generic;
+using System.Linq;
+using osu.Framework.Bindables;
 using osu.Framework.Input;
 using osu.Framework.Input.Bindings;
 using osu.Framework.Input.Events;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Localisation;
+using osu.Game.Rulesets.Mods;
 using osu.Game.Screens.OnlinePlay;
 
 namespace osu.Game.Overlays.Mods
 {
     public class SelectAllModsButton : ShearedButton, IKeyBindingHandler<PlatformAction>
     {
+        private readonly Bindable<IReadOnlyList<Mod>> selectedMods = new Bindable<IReadOnlyList<Mod>>();
+        private readonly Bindable<Dictionary<ModType, IReadOnlyList<ModState>>> availableMods = new Bindable<Dictionary<ModType, IReadOnlyList<ModState>>>();
+
         public SelectAllModsButton(FreeModSelectOverlay modSelectOverlay)
             : base(ModSelectOverlay.BUTTON_WIDTH)
         {
             Text = CommonStrings.SelectAll;
             Action = modSelectOverlay.SelectAll;
+
+            selectedMods.BindTo(modSelectOverlay.SelectedMods);
+            availableMods.BindTo(modSelectOverlay.AvailableMods);
+        }
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            selectedMods.BindValueChanged(_ => Scheduler.AddOnce(updateEnabledState));
+            availableMods.BindValueChanged(_ => Scheduler.AddOnce(updateEnabledState));
+            updateEnabledState();
+        }
+
+        private void updateEnabledState()
+        {
+            Enabled.Value = availableMods.Value
+                                         .SelectMany(pair => pair.Value)
+                                         .Any(modState => !modState.Active.Value && !modState.Filtered.Value);
         }
 
         public bool OnPressed(KeyBindingPressEvent<PlatformAction> e)

From af1d4d3aee582950473057e8733855c71ddbff62 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 25 May 2022 22:27:54 +0200
Subject: [PATCH 5036/5547] Use more proper button subtypes in tests

---
 .../Multiplayer/TestSceneFreeModSelectOverlay.cs      | 11 +++++------
 .../Visual/UserInterface/TestSceneModSelectOverlay.cs |  8 ++++----
 2 files changed, 9 insertions(+), 10 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneFreeModSelectOverlay.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneFreeModSelectOverlay.cs
index 44ae467c80..a8471edbf8 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneFreeModSelectOverlay.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneFreeModSelectOverlay.cs
@@ -9,7 +9,6 @@ using osu.Framework.Bindables;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Input;
 using osu.Framework.Testing;
-using osu.Game.Graphics.UserInterface;
 using osu.Game.Overlays.Mods;
 using osu.Game.Rulesets.Osu.Mods;
 using osu.Game.Rulesets.Mods;
@@ -73,23 +72,23 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             createFreeModSelect();
 
-            AddAssert("select all button enabled", () => this.ChildrenOfType<ShearedButton>().ElementAt(1).Enabled.Value);
+            AddAssert("select all button enabled", () => this.ChildrenOfType<SelectAllModsButton>().Single().Enabled.Value);
 
             AddStep("click select all button", () =>
             {
-                InputManager.MoveMouseTo(this.ChildrenOfType<ShearedButton>().ElementAt(1));
+                InputManager.MoveMouseTo(this.ChildrenOfType<SelectAllModsButton>().Single());
                 InputManager.Click(MouseButton.Left);
             });
             AddUntilStep("all mods selected", assertAllAvailableModsSelected);
-            AddAssert("select all button disabled", () => !this.ChildrenOfType<ShearedButton>().ElementAt(1).Enabled.Value);
+            AddAssert("select all button disabled", () => !this.ChildrenOfType<SelectAllModsButton>().Single().Enabled.Value);
 
             AddStep("click deselect all button", () =>
             {
-                InputManager.MoveMouseTo(this.ChildrenOfType<ShearedButton>().Last());
+                InputManager.MoveMouseTo(this.ChildrenOfType<DeselectAllModsButton>().Single());
                 InputManager.Click(MouseButton.Left);
             });
             AddUntilStep("all mods deselected", () => !freeModSelectOverlay.SelectedMods.Value.Any());
-            AddAssert("select all button enabled", () => this.ChildrenOfType<ShearedButton>().ElementAt(1).Enabled.Value);
+            AddAssert("select all button enabled", () => this.ChildrenOfType<SelectAllModsButton>().Single().Enabled.Value);
         }
 
         private void createFreeModSelect()
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectOverlay.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectOverlay.cs
index 0c3acded88..9bb02c3e75 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectOverlay.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectOverlay.cs
@@ -435,19 +435,19 @@ namespace osu.Game.Tests.Visual.UserInterface
             createScreen();
             changeRuleset(0);
 
-            AddAssert("deselect all button disabled", () => !this.ChildrenOfType<ShearedButton>().Last().Enabled.Value);
+            AddAssert("deselect all button disabled", () => !this.ChildrenOfType<DeselectAllModsButton>().Single().Enabled.Value);
 
             AddStep("select DT + HD", () => SelectedMods.Value = new Mod[] { new OsuModDoubleTime(), new OsuModHidden() });
             AddAssert("DT + HD selected", () => modSelectOverlay.ChildrenOfType<ModPanel>().Count(panel => panel.Active.Value) == 2);
-            AddAssert("deselect all button enabled", () => this.ChildrenOfType<ShearedButton>().Last().Enabled.Value);
+            AddAssert("deselect all button enabled", () => this.ChildrenOfType<DeselectAllModsButton>().Single().Enabled.Value);
 
             AddStep("click deselect all button", () =>
             {
-                InputManager.MoveMouseTo(this.ChildrenOfType<ShearedButton>().Last());
+                InputManager.MoveMouseTo(this.ChildrenOfType<DeselectAllModsButton>().Single());
                 InputManager.Click(MouseButton.Left);
             });
             AddUntilStep("all mods deselected", () => !SelectedMods.Value.Any());
-            AddAssert("deselect all button disabled", () => !this.ChildrenOfType<ShearedButton>().Last().Enabled.Value);
+            AddAssert("deselect all button disabled", () => !this.ChildrenOfType<DeselectAllModsButton>().Single().Enabled.Value);
         }
 
         [Test]

From b550cbc5a3e22421073401059c43c7b54095a623 Mon Sep 17 00:00:00 2001
From: Noah M <noahcodes@protonmail.com>
Date: Wed, 25 May 2022 17:01:30 -0500
Subject: [PATCH 5037/5547] Fix failing code quality checks

---
 .../Overlays/Settings/Sections/Maintenance/GeneralSettings.cs  | 2 +-
 .../Sections/Maintenance/MassVideoDeleteConfirmationDialog.cs  | 3 ++-
 2 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Overlays/Settings/Sections/Maintenance/GeneralSettings.cs b/osu.Game/Overlays/Settings/Sections/Maintenance/GeneralSettings.cs
index afc5cad893..37758875ea 100644
--- a/osu.Game/Overlays/Settings/Sections/Maintenance/GeneralSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Maintenance/GeneralSettings.cs
@@ -67,7 +67,7 @@ namespace osu.Game.Overlays.Settings.Sections.Maintenance
                     dialogOverlay?.Push(new MassVideoDeleteConfirmationDialog(() =>
                     {
                         deleteBeatmapVideosButton.Enabled.Value = false;
-                        Task.Run(() => beatmaps.DeleteVideos()).ContinueWith(t => Schedule(() => deleteBeatmapVideosButton.Enabled.Value = true));
+                        Task.Run(beatmaps.DeleteVideos).ContinueWith(t => Schedule(() => deleteBeatmapVideosButton.Enabled.Value = true));
                     }));
                 }
             });
diff --git a/osu.Game/Overlays/Settings/Sections/Maintenance/MassVideoDeleteConfirmationDialog.cs b/osu.Game/Overlays/Settings/Sections/Maintenance/MassVideoDeleteConfirmationDialog.cs
index 522177807c..fc8c9d497b 100644
--- a/osu.Game/Overlays/Settings/Sections/Maintenance/MassVideoDeleteConfirmationDialog.cs
+++ b/osu.Game/Overlays/Settings/Sections/Maintenance/MassVideoDeleteConfirmationDialog.cs
@@ -7,7 +7,8 @@ namespace osu.Game.Overlays.Settings.Sections.Maintenance
 {
     public class MassVideoDeleteConfirmationDialog : MassDeleteConfirmationDialog
     {
-        public MassVideoDeleteConfirmationDialog(Action deleteAction) : base(deleteAction)
+        public MassVideoDeleteConfirmationDialog(Action deleteAction)
+            : base(deleteAction)
         {
             BodyText = "All beatmap videos? This cannot be undone!";
         }

From 63dd9bd49372f0f051d86124fcd6b0a71a95ea1e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 26 May 2022 18:02:50 +0900
Subject: [PATCH 5038/5547] Expose `Reconnect` logic in `HubClientConnector`

---
 osu.Game/Online/HubClientConnector.cs  | 34 ++++++++++++++++----------
 osu.Game/Online/IHubClientConnector.cs |  5 ++++
 2 files changed, 26 insertions(+), 13 deletions(-)

diff --git a/osu.Game/Online/HubClientConnector.cs b/osu.Game/Online/HubClientConnector.cs
index ca9bf00b23..5c11eed381 100644
--- a/osu.Game/Online/HubClientConnector.cs
+++ b/osu.Game/Online/HubClientConnector.cs
@@ -64,20 +64,28 @@ namespace osu.Game.Online
             this.preferMessagePack = preferMessagePack;
 
             apiState.BindTo(api.State);
-            apiState.BindValueChanged(state =>
-            {
-                switch (state.NewValue)
-                {
-                    case APIState.Failing:
-                    case APIState.Offline:
-                        Task.Run(() => disconnect(true));
-                        break;
+            apiState.BindValueChanged(state => connectIfPossible(), true);
+        }
 
-                    case APIState.Online:
-                        Task.Run(connect);
-                        break;
-                }
-            }, true);
+        public void Reconnect()
+        {
+            Logger.Log($"{clientName} reconnecting...", LoggingTarget.Network);
+            Task.Run(connectIfPossible);
+        }
+
+        private void connectIfPossible()
+        {
+            switch (apiState.Value)
+            {
+                case APIState.Failing:
+                case APIState.Offline:
+                    Task.Run(() => disconnect(true));
+                    break;
+
+                case APIState.Online:
+                    Task.Run(connect);
+                    break;
+            }
         }
 
         private async Task connect()
diff --git a/osu.Game/Online/IHubClientConnector.cs b/osu.Game/Online/IHubClientConnector.cs
index d2ceb1f030..b168e4669f 100644
--- a/osu.Game/Online/IHubClientConnector.cs
+++ b/osu.Game/Online/IHubClientConnector.cs
@@ -30,5 +30,10 @@ namespace osu.Game.Online
         /// Invoked whenever a new hub connection is built, to configure it before it's started.
         /// </summary>
         public Action<HubConnection>? ConfigureConnection { get; set; }
+
+        /// <summary>
+        /// Reconnect if already connected.
+        /// </summary>
+        void Reconnect();
     }
 }

From abb69a49b05591586adeb8034203cef2a07eee81 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 26 May 2022 18:03:41 +0900
Subject: [PATCH 5039/5547] Handle server shutdown messages in room creation
 and spectator initialisation

---
 osu.Game/Online/HubClientConnector.cs          |  2 ++
 .../Multiplayer/MultiplayerClientExtensions.cs | 18 ++++++++++++------
 .../Multiplayer/OnlineMultiplayerClient.cs     | 17 ++++++++++++++---
 .../Online/Spectator/OnlineSpectatorClient.cs  | 17 ++++++++++++++---
 4 files changed, 42 insertions(+), 12 deletions(-)

diff --git a/osu.Game/Online/HubClientConnector.cs b/osu.Game/Online/HubClientConnector.cs
index 5c11eed381..261724e315 100644
--- a/osu.Game/Online/HubClientConnector.cs
+++ b/osu.Game/Online/HubClientConnector.cs
@@ -20,6 +20,8 @@ namespace osu.Game.Online
 {
     public class HubClientConnector : IHubClientConnector
     {
+        public const string SERVER_SHUTDOWN_MESSAGE = "Server is shutting down.";
+
         /// <summary>
         /// Invoked whenever a new hub connection is built, to configure it before it's started.
         /// </summary>
diff --git a/osu.Game/Online/Multiplayer/MultiplayerClientExtensions.cs b/osu.Game/Online/Multiplayer/MultiplayerClientExtensions.cs
index 4729765084..cda313bd0a 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerClientExtensions.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerClientExtensions.cs
@@ -25,12 +25,7 @@ namespace osu.Game.Online.Multiplayer
 
                     Debug.Assert(exception != null);
 
-                    string message = exception is HubException
-                        // HubExceptions arrive with additional message context added, but we want to display the human readable message:
-                        // "An unexpected error occurred invoking 'AddPlaylistItem' on the server.InvalidStateException: Can't enqueue more than 3 items at once."
-                        // We generally use the message field for a user-parseable error (eventually to be replaced), so drop the first part for now.
-                        ? exception.Message.Substring(exception.Message.IndexOf(':') + 1).Trim()
-                        : exception.Message;
+                    string message = exception.GetHubExceptionMessage() ?? exception.Message;
 
                     Logger.Log(message, level: LogLevel.Important);
                     onError?.Invoke(exception);
@@ -40,5 +35,16 @@ namespace osu.Game.Online.Multiplayer
                     onSuccess?.Invoke();
                 }
             });
+
+        public static string? GetHubExceptionMessage(this Exception exception)
+        {
+            if (exception is HubException hubException)
+                // HubExceptions arrive with additional message context added, but we want to display the human readable message:
+                // "An unexpected error occurred invoking 'AddPlaylistItem' on the server.InvalidStateException: Can't enqueue more than 3 items at once."
+                // We generally use the message field for a user-parseable error (eventually to be replaced), so drop the first part for now.
+                return hubException.Message.Substring(exception.Message.IndexOf(':') + 1).Trim();
+
+            return null;
+        }
     }
 }
diff --git a/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs b/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs
index 4dc23d8b85..a3423d4189 100644
--- a/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs
@@ -3,10 +3,12 @@
 
 #nullable enable
 
+using System;
 using System.Collections.Generic;
 using System.Diagnostics;
 using System.Threading;
 using System.Threading.Tasks;
+using Microsoft.AspNetCore.SignalR;
 using Microsoft.AspNetCore.SignalR.Client;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
@@ -71,14 +73,23 @@ namespace osu.Game.Online.Multiplayer
             }
         }
 
-        protected override Task<MultiplayerRoom> JoinRoom(long roomId, string? password = null)
+        protected override async Task<MultiplayerRoom> JoinRoom(long roomId, string? password = null)
         {
             if (!IsConnected.Value)
-                return Task.FromCanceled<MultiplayerRoom>(new CancellationToken(true));
+                throw new OperationCanceledException();
 
             Debug.Assert(connection != null);
 
-            return connection.InvokeAsync<MultiplayerRoom>(nameof(IMultiplayerServer.JoinRoomWithPassword), roomId, password ?? string.Empty);
+            try
+            {
+                return await connection.InvokeAsync<MultiplayerRoom>(nameof(IMultiplayerServer.JoinRoomWithPassword), roomId, password ?? string.Empty);
+            }
+            catch (HubException exception)
+            {
+                if (exception.GetHubExceptionMessage() == HubClientConnector.SERVER_SHUTDOWN_MESSAGE)
+                    connector?.Reconnect();
+                throw;
+            }
         }
 
         protected override Task LeaveRoomInternal()
diff --git a/osu.Game/Online/Spectator/OnlineSpectatorClient.cs b/osu.Game/Online/Spectator/OnlineSpectatorClient.cs
index 4d6ca0b311..0f77f723db 100644
--- a/osu.Game/Online/Spectator/OnlineSpectatorClient.cs
+++ b/osu.Game/Online/Spectator/OnlineSpectatorClient.cs
@@ -5,10 +5,12 @@
 
 using System.Diagnostics;
 using System.Threading.Tasks;
+using Microsoft.AspNetCore.SignalR;
 using Microsoft.AspNetCore.SignalR.Client;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Game.Online.API;
+using osu.Game.Online.Multiplayer;
 
 namespace osu.Game.Online.Spectator
 {
@@ -47,14 +49,23 @@ namespace osu.Game.Online.Spectator
             }
         }
 
-        protected override Task BeginPlayingInternal(SpectatorState state)
+        protected override async Task BeginPlayingInternal(SpectatorState state)
         {
             if (!IsConnected.Value)
-                return Task.CompletedTask;
+                return;
 
             Debug.Assert(connection != null);
 
-            return connection.SendAsync(nameof(ISpectatorServer.BeginPlaySession), state);
+            try
+            {
+                await connection.SendAsync(nameof(ISpectatorServer.BeginPlaySession), state);
+            }
+            catch (HubException exception)
+            {
+                if (exception.GetHubExceptionMessage() == HubClientConnector.SERVER_SHUTDOWN_MESSAGE)
+                    connector?.Reconnect();
+                throw;
+            }
         }
 
         protected override Task SendFramesInternal(FrameDataBundle bundle)

From 7f4ea5d522de3dc6c53d9e6cb892720b580c47c5 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 26 May 2022 18:12:28 +0900
Subject: [PATCH 5040/5547] Use left alignment and remove hacky text
 positioning code

---
 osu.Game/Screens/Edit/BottomBar.cs                    | 2 +-
 osu.Game/Screens/Edit/Components/TimeInfoContainer.cs | 9 ++++-----
 2 files changed, 5 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Screens/Edit/BottomBar.cs b/osu.Game/Screens/Edit/BottomBar.cs
index 0f857940b3..5994184c11 100644
--- a/osu.Game/Screens/Edit/BottomBar.cs
+++ b/osu.Game/Screens/Edit/BottomBar.cs
@@ -41,7 +41,7 @@ namespace osu.Game.Screens.Edit
                         RelativeSizeAxes = Axes.Both,
                         ColumnDimensions = new[]
                         {
-                            new Dimension(GridSizeMode.Absolute, 220),
+                            new Dimension(GridSizeMode.Absolute, 170),
                             new Dimension(),
                             new Dimension(GridSizeMode.Absolute, 220),
                             new Dimension(GridSizeMode.Absolute, 120),
diff --git a/osu.Game/Screens/Edit/Components/TimeInfoContainer.cs b/osu.Game/Screens/Edit/Components/TimeInfoContainer.cs
index 6024716f4b..bd5377e578 100644
--- a/osu.Game/Screens/Edit/Components/TimeInfoContainer.cs
+++ b/osu.Game/Screens/Edit/Components/TimeInfoContainer.cs
@@ -31,8 +31,8 @@ namespace osu.Game.Screens.Edit.Components
             {
                 trackTimer = new OsuSpriteText
                 {
-                    Anchor = Anchor.CentreRight,
-                    Origin = Anchor.CentreRight,
+                    Anchor = Anchor.CentreLeft,
+                    Origin = Anchor.CentreLeft,
                     Spacing = new Vector2(-2, 0),
                     Font = OsuFont.Torus.With(size: 36, fixedWidth: true, weight: FontWeight.Light),
                     Y = -10,
@@ -40,9 +40,9 @@ namespace osu.Game.Screens.Edit.Components
                 bpm = new OsuSpriteText
                 {
                     Colour = colours.Orange1,
-                    Anchor = Anchor.CentreRight,
+                    Anchor = Anchor.CentreLeft,
                     Font = OsuFont.Torus.With(size: 18, weight: FontWeight.SemiBold),
-                    Y = 5,
+                    Position = new Vector2(2, 5),
                 }
             };
         }
@@ -52,7 +52,6 @@ namespace osu.Game.Screens.Edit.Components
             base.Update();
             trackTimer.Text = editorClock.CurrentTime.ToEditorFormattedString();
             bpm.Text = @$"{editorBeatmap.ControlPointInfo.TimingPointAt(editorClock.CurrentTime).BPM:0} BPM";
-            bpm.X = 5 - trackTimer.DrawWidth;
         }
     }
 }

From 93c94b8ea0f21cb19cfb22a1376b6a0ec61f4911 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 26 May 2022 18:30:37 +0900
Subject: [PATCH 5041/5547] Fix test caching woes

---
 osu.Game.Tests/Visual/Editing/TestSceneEditorClock.cs |  6 ++++++
 osu.Game/Tests/Visual/EditorClockTestScene.cs         | 11 +++--------
 2 files changed, 9 insertions(+), 8 deletions(-)

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneEditorClock.cs b/osu.Game.Tests/Visual/Editing/TestSceneEditorClock.cs
index 4b9be77471..393d3886e7 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneEditorClock.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneEditorClock.cs
@@ -2,10 +2,13 @@
 // 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.Game.Rulesets.Osu;
+using osu.Game.Screens.Edit;
 using osu.Game.Screens.Edit.Components;
+using osu.Game.Tests.Beatmaps;
 using osuTK;
 
 namespace osu.Game.Tests.Visual.Editing
@@ -13,6 +16,9 @@ namespace osu.Game.Tests.Visual.Editing
     [TestFixture]
     public class TestSceneEditorClock : EditorClockTestScene
     {
+        [Cached]
+        private EditorBeatmap editorBeatmap = new EditorBeatmap(new TestBeatmap(new OsuRuleset().RulesetInfo));
+
         public TestSceneEditorClock()
         {
             Add(new FillFlowContainer
diff --git a/osu.Game/Tests/Visual/EditorClockTestScene.cs b/osu.Game/Tests/Visual/EditorClockTestScene.cs
index 93dfe58076..2d3e1960d9 100644
--- a/osu.Game/Tests/Visual/EditorClockTestScene.cs
+++ b/osu.Game/Tests/Visual/EditorClockTestScene.cs
@@ -6,7 +6,6 @@ using osu.Framework.Bindables;
 using osu.Framework.Input.Events;
 using osu.Game.Beatmaps;
 using osu.Game.Overlays;
-using osu.Game.Rulesets.Edit;
 using osu.Game.Screens.Edit;
 
 namespace osu.Game.Tests.Visual
@@ -20,20 +19,16 @@ namespace osu.Game.Tests.Visual
         [Cached]
         private readonly OverlayColourProvider overlayColour = new OverlayColourProvider(OverlayColourScheme.Aquamarine);
 
-        [Cached(typeof(EditorBeatmap))]
-        [Cached(typeof(IBeatSnapProvider))]
-        private readonly EditorBeatmap editorBeatmap;
-
         protected readonly BindableBeatDivisor BeatDivisor = new BindableBeatDivisor();
+
+        [Cached]
         protected new readonly EditorClock Clock;
 
         protected virtual bool ScrollUsingMouseWheel => true;
 
         protected EditorClockTestScene()
         {
-            editorBeatmap = new EditorBeatmap(new Beatmap());
-
-            Clock = new EditorClock(editorBeatmap, BeatDivisor) { IsCoupled = false };
+            Clock = new EditorClock(new Beatmap(), BeatDivisor) { IsCoupled = false };
         }
 
         protected override IReadOnlyDependencyContainer CreateChildDependencies(IReadOnlyDependencyContainer parent)

From 08935cff86f8d962ea04044c720fea6cfed5964c Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 26 May 2022 18:37:04 +0900
Subject: [PATCH 5042/5547] Detect exclusive fullscreen on Windows

---
 .../Sections/Graphics/LayoutSettings.cs       | 38 ++++++++++++++++++-
 1 file changed, 36 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Overlays/Settings/Sections/Graphics/LayoutSettings.cs b/osu.Game/Overlays/Settings/Sections/Graphics/LayoutSettings.cs
index 602ace6dea..981f5dbac3 100644
--- a/osu.Game/Overlays/Settings/Sections/Graphics/LayoutSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Graphics/LayoutSettings.cs
@@ -13,6 +13,7 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Localisation;
 using osu.Framework.Platform;
+using osu.Framework.Platform.Windows;
 using osu.Game.Configuration;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.UserInterface;
@@ -34,10 +35,14 @@ namespace osu.Game.Overlays.Settings.Sections.Graphics
         private Bindable<Size> sizeFullscreen;
 
         private readonly BindableList<Size> resolutions = new BindableList<Size>(new[] { new Size(9999, 9999) });
+        private readonly IBindable<FullscreenCapability> fullscreenCapability = new Bindable<FullscreenCapability>(FullscreenCapability.Capable);
 
         [Resolved]
         private OsuGameBase game { get; set; }
 
+        [Resolved]
+        private GameHost host { get; set; }
+
         private SettingsDropdown<Size> resolutionDropdown;
         private SettingsDropdown<Display> displayDropdown;
         private SettingsDropdown<WindowMode> windowModeDropdown;
@@ -65,6 +70,9 @@ namespace osu.Game.Overlays.Settings.Sections.Graphics
                 windowModes.BindTo(host.Window.SupportedWindowModes);
             }
 
+            if (host.Window is WindowsWindow windowsWindow)
+                fullscreenCapability.BindTo(windowsWindow.FullscreenCapability);
+
             Children = new Drawable[]
             {
                 windowModeDropdown = new SettingsDropdown<WindowMode>
@@ -139,6 +147,8 @@ namespace osu.Game.Overlays.Settings.Sections.Graphics
                     }
                 },
             };
+
+            fullscreenCapability.BindValueChanged(_ => Schedule(updateScreenModeWarning), true);
         }
 
         protected override void LoadComplete()
@@ -150,8 +160,7 @@ namespace osu.Game.Overlays.Settings.Sections.Graphics
             windowModeDropdown.Current.BindValueChanged(mode =>
             {
                 updateDisplayModeDropdowns();
-
-                windowModeDropdown.WarningText = mode.NewValue != WindowMode.Fullscreen ? GraphicsSettingsStrings.NotFullscreenNote : default;
+                updateScreenModeWarning();
             }, true);
 
             windowModes.BindCollectionChanged((sender, args) =>
@@ -213,6 +222,31 @@ namespace osu.Game.Overlays.Settings.Sections.Graphics
             }
         }
 
+        private void updateScreenModeWarning()
+        {
+            if (windowModeDropdown.Current.Value != WindowMode.Fullscreen)
+            {
+                windowModeDropdown.WarningText = GraphicsSettingsStrings.NotFullscreenNote;
+                return;
+            }
+
+            switch (fullscreenCapability.Value)
+            {
+                case FullscreenCapability.Unknown:
+                    if (host.Window is WindowsWindow)
+                        windowModeDropdown.WarningText = "Checking for exclusive fullscreen...";
+                    break;
+
+                case FullscreenCapability.Capable:
+                    windowModeDropdown.WarningText = default;
+                    break;
+
+                case FullscreenCapability.Incapable:
+                    windowModeDropdown.WarningText = "Unable to enter exclusive fullscreen. You'll still experience some input latency.";
+                    break;
+            }
+        }
+
         private void bindPreviewEvent(Bindable<float> bindable)
         {
             bindable.ValueChanged += _ =>

From a98d0cf0d8b6d8c91cdaff9626cc76859ca71537 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 26 May 2022 18:47:50 +0900
Subject: [PATCH 5043/5547] Simplify channel filter method

---
 osu.Game/Overlays/ChatOverlayV2.cs | 30 ++++++++++++++++++------------
 1 file changed, 18 insertions(+), 12 deletions(-)

diff --git a/osu.Game/Overlays/ChatOverlayV2.cs b/osu.Game/Overlays/ChatOverlayV2.cs
index 68199c9d25..f2ec007b19 100644
--- a/osu.Game/Overlays/ChatOverlayV2.cs
+++ b/osu.Game/Overlays/ChatOverlayV2.cs
@@ -3,7 +3,6 @@
 
 #nullable enable
 
-using System.Collections;
 using System.Collections.Generic;
 using System.Collections.Specialized;
 using System.Diagnostics;
@@ -56,13 +55,6 @@ namespace osu.Game.Overlays
         private const float side_bar_width = 190;
         private const float chat_bar_height = 60;
 
-        private readonly ChannelType[] excludedChannelTypes =
-        {
-            ChannelType.Multiplayer,
-            ChannelType.Spectator,
-            ChannelType.Temporary,
-        };
-
         [Resolved]
         private OsuConfigManager config { get; set; } = null!;
 
@@ -353,7 +345,7 @@ namespace osu.Game.Overlays
             switch (args.Action)
             {
                 case NotifyCollectionChangedAction.Add:
-                    IEnumerable<Channel> newChannels = filterToChatChannels(args.NewItems);
+                    IEnumerable<Channel> newChannels = args.NewItems.OfType<Channel>().Where(isChatChannel);
 
                     foreach (var channel in newChannels)
                         channelList.AddChannel(channel);
@@ -361,7 +353,7 @@ namespace osu.Game.Overlays
                     break;
 
                 case NotifyCollectionChangedAction.Remove:
-                    IEnumerable<Channel> leftChannels = filterToChatChannels(args.OldItems);
+                    IEnumerable<Channel> leftChannels = args.OldItems.OfType<Channel>().Where(isChatChannel);
 
                     foreach (var channel in leftChannels)
                     {
@@ -408,7 +400,21 @@ namespace osu.Game.Overlays
             channelList.ScrollChannelIntoView(currentChannel.Value);
         }
 
-        private IEnumerable<Channel> filterToChatChannels(IEnumerable channels)
-            => channels.Cast<Channel>().Where(c => !excludedChannelTypes.Contains(c.Type));
+        /// <summary>
+        /// Whether a channel should be displayed in this overlay, based on its type.
+        /// </summary>
+        private static bool isChatChannel(Channel channel)
+        {
+            switch (channel.Type)
+            {
+                case ChannelType.Multiplayer:
+                case ChannelType.Spectator:
+                case ChannelType.Temporary:
+                    return false;
+
+                default:
+                    return true;
+            }
+        }
     }
 }

From 3915b8e414a00e085e6c59a2da6c7df76f32fcc1 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 26 May 2022 20:01:33 +0900
Subject: [PATCH 5044/5547] Fix multiplayer race condition when starting
 gameplay

---
 .../Screens/OnlinePlay/Multiplayer/MultiplayerPlayer.cs  | 6 ++++++
 .../OnlinePlay/Multiplayer/MultiplayerPlayerLoader.cs    | 9 +++++++--
 2 files changed, 13 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayer.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayer.cs
index 5dab845999..d9125dc0a0 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayer.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayer.cs
@@ -149,6 +149,12 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
 
         protected override void StartGameplay()
         {
+            // We can enter this screen one of two ways:
+            // 1. Via the automatic natural progression of PlayerLoader into Player.
+            //    We'll arrive here in a Loaded state, and we need to let the server know that we're ready to start.
+            // 2. Via the server forcefully starting gameplay because players have been hanging out in PlayerLoader for too long.
+            //    We'll arrive here in a Playing state, and we should neither show the loading spinner nor tell the server that we're ready to start (gameplay has already started).
+
             if (client.LocalUser?.State == MultiplayerUserState.Loaded)
             {
                 // block base call, but let the server know we are ready to start.
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayerLoader.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayerLoader.cs
index 7f01bd64ab..e9bf5339a9 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayerLoader.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayerLoader.cs
@@ -26,8 +26,13 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
         }
 
         protected override bool ReadyForGameplay =>
-            base.ReadyForGameplay
-            // The server is forcefully starting gameplay.
+            (
+                // The user is ready to enter gameplay.
+                base.ReadyForGameplay
+                // And the server has received the message that we're loaded.
+                && multiplayerClient.LocalUser?.State == MultiplayerUserState.Loaded
+            )
+            // Or the server is forcefully starting gameplay.
             || multiplayerClient.LocalUser?.State == MultiplayerUserState.Playing;
 
         protected override void OnPlayerLoaded()

From 0224947de0b886468dad7940c4dd6cd94b242e13 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 26 May 2022 20:09:28 +0900
Subject: [PATCH 5045/5547] Add comment about how starting gameplay works

---
 osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayer.cs | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayer.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayer.cs
index d9125dc0a0..3bf8a09cb9 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayer.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayer.cs
@@ -154,10 +154,11 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
             //    We'll arrive here in a Loaded state, and we need to let the server know that we're ready to start.
             // 2. Via the server forcefully starting gameplay because players have been hanging out in PlayerLoader for too long.
             //    We'll arrive here in a Playing state, and we should neither show the loading spinner nor tell the server that we're ready to start (gameplay has already started).
+            //
+            // The base call is blocked here because in both cases gameplay is started only when the server says so via onGameplayStarted().
 
             if (client.LocalUser?.State == MultiplayerUserState.Loaded)
             {
-                // block base call, but let the server know we are ready to start.
                 loadingDisplay.Show();
                 client.ChangeState(MultiplayerUserState.ReadyForGameplay);
             }

From 66a6467403d195013590f117eb362f249a692631 Mon Sep 17 00:00:00 2001
From: apollo-dw <83023433+apollo-dw@users.noreply.github.com>
Date: Thu, 26 May 2022 19:26:14 +0100
Subject: [PATCH 5046/5547] Pass object position to the object

---
 .../Difficulty/CatchDifficultyCalculator.cs                  | 2 +-
 .../Difficulty/Preprocessing/CatchDifficultyHitObject.cs     | 4 ++--
 .../Difficulty/ManiaDifficultyCalculator.cs                  | 2 +-
 .../Difficulty/Preprocessing/ManiaDifficultyHitObject.cs     | 4 ++--
 osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs  | 2 +-
 .../Difficulty/Preprocessing/OsuDifficultyHitObject.cs       | 4 ++--
 .../Difficulty/Preprocessing/TaikoDifficultyHitObject.cs     | 5 +++--
 .../Difficulty/TaikoDifficultyCalculator.cs                  | 2 +-
 .../Rulesets/Difficulty/Preprocessing/DifficultyHitObject.cs | 5 +++--
 9 files changed, 16 insertions(+), 14 deletions(-)

diff --git a/osu.Game.Rulesets.Catch/Difficulty/CatchDifficultyCalculator.cs b/osu.Game.Rulesets.Catch/Difficulty/CatchDifficultyCalculator.cs
index da85840171..8140ea6eaa 100644
--- a/osu.Game.Rulesets.Catch/Difficulty/CatchDifficultyCalculator.cs
+++ b/osu.Game.Rulesets.Catch/Difficulty/CatchDifficultyCalculator.cs
@@ -62,7 +62,7 @@ namespace osu.Game.Rulesets.Catch.Difficulty
                     continue;
 
                 if (lastObject != null)
-                    objects.Add(new CatchDifficultyHitObject(hitObject, lastObject, clockRate, halfCatcherWidth, objects));
+                    objects.Add(new CatchDifficultyHitObject(hitObject, lastObject, clockRate, halfCatcherWidth, objects, objects.Count));
 
                 lastObject = hitObject;
             }
diff --git a/osu.Game.Rulesets.Catch/Difficulty/Preprocessing/CatchDifficultyHitObject.cs b/osu.Game.Rulesets.Catch/Difficulty/Preprocessing/CatchDifficultyHitObject.cs
index 60d6213525..8c229cf6c5 100644
--- a/osu.Game.Rulesets.Catch/Difficulty/Preprocessing/CatchDifficultyHitObject.cs
+++ b/osu.Game.Rulesets.Catch/Difficulty/Preprocessing/CatchDifficultyHitObject.cs
@@ -25,8 +25,8 @@ namespace osu.Game.Rulesets.Catch.Difficulty.Preprocessing
         /// </summary>
         public readonly double StrainTime;
 
-        public CatchDifficultyHitObject(HitObject hitObject, HitObject lastObject, double clockRate, float halfCatcherWidth, List<DifficultyHitObject> objects)
-            : base(hitObject, lastObject, clockRate, objects)
+        public CatchDifficultyHitObject(HitObject hitObject, HitObject lastObject, double clockRate, float halfCatcherWidth, List<DifficultyHitObject> objects, int position)
+            : base(hitObject, lastObject, clockRate, objects, position)
         {
             // We will scale everything by this factor, so we can assume a uniform CircleSize among beatmaps.
             float scalingFactor = normalized_hitobject_radius / halfCatcherWidth;
diff --git a/osu.Game.Rulesets.Mania/Difficulty/ManiaDifficultyCalculator.cs b/osu.Game.Rulesets.Mania/Difficulty/ManiaDifficultyCalculator.cs
index 68c2acb2ed..d1f6c2b5db 100644
--- a/osu.Game.Rulesets.Mania/Difficulty/ManiaDifficultyCalculator.cs
+++ b/osu.Game.Rulesets.Mania/Difficulty/ManiaDifficultyCalculator.cs
@@ -65,7 +65,7 @@ namespace osu.Game.Rulesets.Mania.Difficulty
             List<DifficultyHitObject> objects = new List<DifficultyHitObject>();
 
             for (int i = 1; i < sortedObjects.Length; i++)
-                objects.Add(new ManiaDifficultyHitObject(sortedObjects[i], sortedObjects[i - 1], clockRate, objects));
+                objects.Add(new ManiaDifficultyHitObject(sortedObjects[i], sortedObjects[i - 1], clockRate, objects, objects.Count));
 
             return objects;
         }
diff --git a/osu.Game.Rulesets.Mania/Difficulty/Preprocessing/ManiaDifficultyHitObject.cs b/osu.Game.Rulesets.Mania/Difficulty/Preprocessing/ManiaDifficultyHitObject.cs
index 68f14ed128..5c9b3b9b54 100644
--- a/osu.Game.Rulesets.Mania/Difficulty/Preprocessing/ManiaDifficultyHitObject.cs
+++ b/osu.Game.Rulesets.Mania/Difficulty/Preprocessing/ManiaDifficultyHitObject.cs
@@ -12,8 +12,8 @@ namespace osu.Game.Rulesets.Mania.Difficulty.Preprocessing
     {
         public new ManiaHitObject BaseObject => (ManiaHitObject)base.BaseObject;
 
-        public ManiaDifficultyHitObject(HitObject hitObject, HitObject lastObject, double clockRate, List<DifficultyHitObject> objects)
-            : base(hitObject, lastObject, clockRate, objects)
+        public ManiaDifficultyHitObject(HitObject hitObject, HitObject lastObject, double clockRate, List<DifficultyHitObject> objects, int position)
+            : base(hitObject, lastObject, clockRate, objects, position)
         {
         }
     }
diff --git a/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs b/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs
index da9fb2bb08..f074783ccf 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs
@@ -92,7 +92,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty
             // The first jump is formed by the first two hitobjects of the map.
             // If the map has less than two OsuHitObjects, the enumerator will not return anything.
             for (int i = 1; i < beatmap.HitObjects.Count; i++)
-                objects.Add(new OsuDifficultyHitObject(beatmap.HitObjects[i], beatmap.HitObjects[i - 1], clockRate, objects));
+                objects.Add(new OsuDifficultyHitObject(beatmap.HitObjects[i], beatmap.HitObjects[i - 1], clockRate, objects, objects.Count));
 
             return objects;
         }
diff --git a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
index f599d2e32d..0400dd0db1 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
@@ -75,8 +75,8 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
         private readonly OsuHitObject lastLastObject;
         private readonly OsuHitObject lastObject;
 
-        public OsuDifficultyHitObject(HitObject hitObject, HitObject lastObject, double clockRate, List<DifficultyHitObject> objects)
-            : base(hitObject, lastObject, clockRate, objects)
+        public OsuDifficultyHitObject(HitObject hitObject, HitObject lastObject, double clockRate, List<DifficultyHitObject> objects, int position)
+            : base(hitObject, lastObject, clockRate, objects, position)
         {
             lastLastObject = (OsuHitObject)Previous(1)?.BaseObject;
             this.lastObject = (OsuHitObject)lastObject;
diff --git a/osu.Game.Rulesets.Taiko/Difficulty/Preprocessing/TaikoDifficultyHitObject.cs b/osu.Game.Rulesets.Taiko/Difficulty/Preprocessing/TaikoDifficultyHitObject.cs
index 6dbaab44cf..450eb63636 100644
--- a/osu.Game.Rulesets.Taiko/Difficulty/Preprocessing/TaikoDifficultyHitObject.cs
+++ b/osu.Game.Rulesets.Taiko/Difficulty/Preprocessing/TaikoDifficultyHitObject.cs
@@ -39,8 +39,9 @@ namespace osu.Game.Rulesets.Taiko.Difficulty.Preprocessing
         /// <param name="lastLastObject">The gameplay <see cref="HitObject"/> preceding <paramref name="lastObject"/>.</param>
         /// <param name="clockRate">The rate of the gameplay clock. Modified by speed-changing mods.</param>
         /// <param name="objects">The list of <see cref="DifficultyHitObject"/>s in the current beatmap.</param>
-        public TaikoDifficultyHitObject(HitObject hitObject, HitObject lastObject, HitObject lastLastObject, double clockRate, List<DifficultyHitObject> objects)
-            : base(hitObject, lastObject, clockRate, objects)
+        /// /// <param name="position">The position of this <see cref="DifficultyHitObject"/> in the <paramref name="objects"/> list.</param>
+        public TaikoDifficultyHitObject(HitObject hitObject, HitObject lastObject, HitObject lastLastObject, double clockRate, List<DifficultyHitObject> objects, int position)
+            : base(hitObject, lastObject, clockRate, objects, position)
         {
             var currentHit = hitObject as Hit;
 
diff --git a/osu.Game.Rulesets.Taiko/Difficulty/TaikoDifficultyCalculator.cs b/osu.Game.Rulesets.Taiko/Difficulty/TaikoDifficultyCalculator.cs
index d6792f7227..ce5b1d2236 100644
--- a/osu.Game.Rulesets.Taiko/Difficulty/TaikoDifficultyCalculator.cs
+++ b/osu.Game.Rulesets.Taiko/Difficulty/TaikoDifficultyCalculator.cs
@@ -52,7 +52,7 @@ namespace osu.Game.Rulesets.Taiko.Difficulty
             {
                 taikoDifficultyHitObjects.Add(
                     new TaikoDifficultyHitObject(
-                        beatmap.HitObjects[i], beatmap.HitObjects[i - 1], beatmap.HitObjects[i - 2], clockRate, taikoDifficultyHitObjects
+                        beatmap.HitObjects[i], beatmap.HitObjects[i - 1], beatmap.HitObjects[i - 2], clockRate, taikoDifficultyHitObjects, taikoDifficultyHitObjects.Count
                     )
                 );
             }
diff --git a/osu.Game/Rulesets/Difficulty/Preprocessing/DifficultyHitObject.cs b/osu.Game/Rulesets/Difficulty/Preprocessing/DifficultyHitObject.cs
index e067b0bb2f..a886a0d992 100644
--- a/osu.Game/Rulesets/Difficulty/Preprocessing/DifficultyHitObject.cs
+++ b/osu.Game/Rulesets/Difficulty/Preprocessing/DifficultyHitObject.cs
@@ -51,10 +51,11 @@ namespace osu.Game.Rulesets.Difficulty.Preprocessing
         /// <param name="lastObject">The last <see cref="HitObject"/> which occurs before <paramref name="hitObject"/> in the beatmap.</param>
         /// <param name="clockRate">The rate at which the gameplay clock is run at.</param>
         /// <param name="objects">The list of <see cref="DifficultyHitObject"/>s in the current beatmap.</param>
-        public DifficultyHitObject(HitObject hitObject, HitObject lastObject, double clockRate, List<DifficultyHitObject> objects)
+        /// <param name="position">The position of this <see cref="DifficultyHitObject"/> in the <see cref="difficultyHitObjects"/> list.</param>
+        public DifficultyHitObject(HitObject hitObject, HitObject lastObject, double clockRate, List<DifficultyHitObject> objects, int position)
         {
             difficultyHitObjects = objects;
-            Position = objects.Count;
+            Position = position;
             BaseObject = hitObject;
             LastObject = lastObject;
             DeltaTime = (hitObject.StartTime - lastObject.StartTime) / clockRate;

From 3183621d3d20e05d65d4f6b9ea383d7cc6df3512 Mon Sep 17 00:00:00 2001
From: sw1tchbl4d3 <sw1tchbl4d3@sw1tchbl4d3.com>
Date: Thu, 26 May 2022 22:57:24 +0200
Subject: [PATCH 5047/5547] Add search bar for the `CurrentlyPlayingDisplay`

---
 .../Dashboard/CurrentlyPlayingDisplay.cs      | 119 ++++++++++++++----
 1 file changed, 98 insertions(+), 21 deletions(-)

diff --git a/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs b/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs
index a9312e9a3a..1c14eee9c7 100644
--- a/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs
+++ b/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.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.Collections.Specialized;
 using System.Diagnostics;
 using System.Linq;
@@ -11,6 +12,8 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Screens;
 using osu.Game.Database;
+using osu.Game.Graphics;
+using osu.Game.Graphics.UserInterface;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Spectator;
@@ -24,10 +27,17 @@ namespace osu.Game.Overlays.Dashboard
 {
     internal class CurrentlyPlayingDisplay : CompositeDrawable
     {
+        private const float search_bar_height = 40;
+        private const float search_bar_width = 250;
+
         private readonly IBindableList<int> playingUsers = new BindableList<int>();
 
         private FillFlowContainer<PlayingUserPanel> userFlow;
 
+        private List<int> currentUsers = new List<int>();
+        private FocusedTextBox searchBar;
+        private Container<FocusedTextBox> searchBarContainer;
+
         [Resolved]
         private SpectatorClient spectatorClient { get; set; }
 
@@ -37,13 +47,46 @@ namespace osu.Game.Overlays.Dashboard
             RelativeSizeAxes = Axes.X;
             AutoSizeAxes = Axes.Y;
 
-            InternalChild = userFlow = new FillFlowContainer<PlayingUserPanel>
+            searchBarContainer = new Container<FocusedTextBox>
+            {
+                Anchor = Anchor.TopCentre,
+                Origin = Anchor.TopCentre,
+                Padding = new MarginPadding(10),
+                Child = searchBar = new FocusedTextBox
+                {
+                    Anchor = Anchor.TopCentre,
+                    Origin = Anchor.TopCentre,
+                    Height = search_bar_height,
+                    Width = search_bar_width,
+
+                    Colour = OsuColour.Gray(0.8f),
+
+                    PlaceholderText = "Search for User...",
+                    HoldFocus = true,
+                    ReleaseFocusOnCommit = true,
+                },
+            };
+
+            userFlow = new FillFlowContainer<PlayingUserPanel>
             {
                 RelativeSizeAxes = Axes.X,
                 AutoSizeAxes = Axes.Y,
-                Padding = new MarginPadding(10),
+                Padding = new MarginPadding {
+                    Top = 10 + 10 + search_bar_height,
+                    Bottom = 10,
+                    Right = 10,
+                    Left = 10,
+                },
                 Spacing = new Vector2(10),
             };
+
+            InternalChildren = new Drawable[]
+            {
+                searchBarContainer,
+                userFlow,
+            };
+
+            searchBar.Current.ValueChanged += onSearchBarValueChanged;
         }
 
         [Resolved]
@@ -57,6 +100,57 @@ namespace osu.Game.Overlays.Dashboard
             playingUsers.BindCollectionChanged(onPlayingUsersChanged, true);
         }
 
+        private void addCard(int userId)
+        {
+            if (currentUsers.Contains(userId))
+                return;
+
+            users.GetUserAsync(userId).ContinueWith(task =>
+            {
+                var user = task.GetResultSafely();
+
+                if (user == null)
+                    return;
+
+                if (!user.Username.ToLower().Contains(searchBar.Text.ToLower()))
+                    return;
+
+                Schedule(() =>
+                {
+                    // user may no longer be playing.
+                    if (!playingUsers.Contains(user.Id))
+                        return;
+
+                    currentUsers.Add(user.Id);
+
+                    userFlow.Add(createUserPanel(user));
+                });
+            });
+        }
+
+        private void removeCard(PlayingUserPanel card)
+        {
+            if (card == null)
+                return;
+
+            currentUsers.Remove(card.User.Id);
+            card.Expire();
+        }
+
+        private void onSearchBarValueChanged(ValueChangedEvent<string> change)
+        {
+            foreach (PlayingUserPanel card in userFlow)
+            {
+                if (!card.User.Username.ToLower().Contains(change.NewValue.ToLower()))
+                    removeCard(card);
+            }
+
+            foreach (int userId in playingUsers)
+            {
+                addCard(userId);
+            }
+        }
+
         private void onPlayingUsersChanged(object sender, NotifyCollectionChangedEventArgs e) => Schedule(() =>
         {
             switch (e.Action)
@@ -65,24 +159,7 @@ namespace osu.Game.Overlays.Dashboard
                     Debug.Assert(e.NewItems != null);
 
                     foreach (int userId in e.NewItems)
-                    {
-                        users.GetUserAsync(userId).ContinueWith(task =>
-                        {
-                            var user = task.GetResultSafely();
-
-                            if (user == null)
-                                return;
-
-                            Schedule(() =>
-                            {
-                                // user may no longer be playing.
-                                if (!playingUsers.Contains(user.Id))
-                                    return;
-
-                                userFlow.Add(createUserPanel(user));
-                            });
-                        });
-                    }
+                        addCard(userId);
 
                     break;
 
@@ -90,7 +167,7 @@ namespace osu.Game.Overlays.Dashboard
                     Debug.Assert(e.OldItems != null);
 
                     foreach (int userId in e.OldItems)
-                        userFlow.FirstOrDefault(card => card.User.Id == userId)?.Expire();
+                        removeCard(userFlow.FirstOrDefault(card => card.User.Id == userId));
                     break;
             }
         });

From de5b60ab66a6d33655e7b003c1ff21caa87867ad Mon Sep 17 00:00:00 2001
From: sw1tchbl4d3 <sw1tchbl4d3@sw1tchbl4d3.com>
Date: Fri, 27 May 2022 00:40:23 +0200
Subject: [PATCH 5048/5547] Move filtering from manual loops to
 `SearchContainer`

---
 .../Dashboard/CurrentlyPlayingDisplay.cs      | 57 ++++++++-----------
 1 file changed, 25 insertions(+), 32 deletions(-)

diff --git a/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs b/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs
index 1c14eee9c7..7dd5c73b79 100644
--- a/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs
+++ b/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs
@@ -10,6 +10,7 @@ using osu.Framework.Bindables;
 using osu.Framework.Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
+using osu.Framework.Localisation;
 using osu.Framework.Screens;
 using osu.Game.Database;
 using osu.Game.Graphics;
@@ -32,9 +33,8 @@ namespace osu.Game.Overlays.Dashboard
 
         private readonly IBindableList<int> playingUsers = new BindableList<int>();
 
-        private FillFlowContainer<PlayingUserPanel> userFlow;
+        private SearchContainer<PlayingUserPanel> userFlow;
 
-        private List<int> currentUsers = new List<int>();
         private FocusedTextBox searchBar;
         private Container<FocusedTextBox> searchBarContainer;
 
@@ -67,7 +67,7 @@ namespace osu.Game.Overlays.Dashboard
                 },
             };
 
-            userFlow = new FillFlowContainer<PlayingUserPanel>
+            userFlow = new SearchContainer<PlayingUserPanel>
             {
                 RelativeSizeAxes = Axes.X,
                 AutoSizeAxes = Axes.Y,
@@ -102,9 +102,6 @@ namespace osu.Game.Overlays.Dashboard
 
         private void addCard(int userId)
         {
-            if (currentUsers.Contains(userId))
-                return;
-
             users.GetUserAsync(userId).ContinueWith(task =>
             {
                 var user = task.GetResultSafely();
@@ -121,35 +118,12 @@ namespace osu.Game.Overlays.Dashboard
                     if (!playingUsers.Contains(user.Id))
                         return;
 
-                    currentUsers.Add(user.Id);
-
                     userFlow.Add(createUserPanel(user));
                 });
             });
         }
 
-        private void removeCard(PlayingUserPanel card)
-        {
-            if (card == null)
-                return;
-
-            currentUsers.Remove(card.User.Id);
-            card.Expire();
-        }
-
-        private void onSearchBarValueChanged(ValueChangedEvent<string> change)
-        {
-            foreach (PlayingUserPanel card in userFlow)
-            {
-                if (!card.User.Username.ToLower().Contains(change.NewValue.ToLower()))
-                    removeCard(card);
-            }
-
-            foreach (int userId in playingUsers)
-            {
-                addCard(userId);
-            }
-        }
+        private void onSearchBarValueChanged(ValueChangedEvent<string> change) => userFlow.SearchTerm = searchBar.Text;
 
         private void onPlayingUsersChanged(object sender, NotifyCollectionChangedEventArgs e) => Schedule(() =>
         {
@@ -167,7 +141,7 @@ namespace osu.Game.Overlays.Dashboard
                     Debug.Assert(e.OldItems != null);
 
                     foreach (int userId in e.OldItems)
-                        removeCard(userFlow.FirstOrDefault(card => card.User.Id == userId));
+                        userFlow.FirstOrDefault(card => card.User.Id == userId)?.Expire();
                     break;
             }
         });
@@ -179,16 +153,35 @@ namespace osu.Game.Overlays.Dashboard
                 panel.Origin = Anchor.TopCentre;
             });
 
-        private class PlayingUserPanel : CompositeDrawable
+        private class PlayingUserPanel : CompositeDrawable, IFilterable
         {
             public readonly APIUser User;
+            public IEnumerable<LocalisableString> FilterTerms => filterTerm;
 
             [Resolved(canBeNull: true)]
             private IPerformFromScreenRunner performer { get; set; }
+            private IEnumerable<LocalisableString> filterTerm;
+
+            public bool MatchingFilter
+            {
+                set
+                {
+                    if (value)
+                        Show();
+                    else
+                        Hide();
+                }
+            }
+
+            public bool FilteringActive
+            {
+                set { }
+            }
 
             public PlayingUserPanel(APIUser user)
             {
                 User = user;
+                filterTerm = new LocalisableString[] { User.Username };
 
                 AutoSizeAxes = Axes.Both;
             }

From a8e453e6601f495613b11ebbe42c635113cf4d8d Mon Sep 17 00:00:00 2001
From: sw1tchbl4d3 <sw1tchbl4d3@sw1tchbl4d3.com>
Date: Fri, 27 May 2022 00:43:29 +0200
Subject: [PATCH 5049/5547] Remove now unnecessary username filter check

---
 osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs b/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs
index 7dd5c73b79..f57c808144 100644
--- a/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs
+++ b/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs
@@ -109,9 +109,6 @@ namespace osu.Game.Overlays.Dashboard
                 if (user == null)
                     return;
 
-                if (!user.Username.ToLower().Contains(searchBar.Text.ToLower()))
-                    return;
-
                 Schedule(() =>
                 {
                     // user may no longer be playing.

From 0cdefbc6df3200bbb758f99cad47d55168a9a812 Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Thu, 26 May 2022 17:39:29 -0700
Subject: [PATCH 5050/5547] Add failing beatmap info status test

---
 .../Visual/Online/TestSceneBeatmapSetOverlay.cs          | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlay.cs b/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlay.cs
index 859727e632..80bb2aa2e8 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlay.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlay.cs
@@ -10,6 +10,8 @@ using osu.Game.Rulesets;
 using System;
 using System.Collections.Generic;
 using System.Linq;
+using osu.Framework.Testing;
+using osu.Game.Beatmaps.Drawables;
 using osu.Game.Online.API.Requests.Responses;
 using APIUser = osu.Game.Online.API.Requests.Responses.APIUser;
 
@@ -101,6 +103,12 @@ namespace osu.Game.Tests.Visual.Online
 
             AddStep("show many difficulties", () => overlay.ShowBeatmapSet(createManyDifficultiesBeatmapSet()));
             downloadAssert(true);
+
+            AddAssert("status is loved", () => overlay.ChildrenOfType<BeatmapSetOnlineStatusPill>().Single().Status == BeatmapOnlineStatus.Loved);
+
+            AddStep("go to second beatmap", () => overlay.ChildrenOfType<BeatmapPicker.DifficultySelectorButton>().ElementAt(1).TriggerClick());
+
+            AddAssert("status is graveyard", () => overlay.ChildrenOfType<BeatmapSetOnlineStatusPill>().Single().Status == BeatmapOnlineStatus.Graveyard);
         }
 
         [Test]
@@ -232,6 +240,7 @@ namespace osu.Game.Tests.Visual.Online
                         Fails = Enumerable.Range(1, 100).Select(j => j % 12 - 6).ToArray(),
                         Retries = Enumerable.Range(-2, 100).Select(j => j % 12 - 6).ToArray(),
                     },
+                    Status = i % 2 == 0 ? BeatmapOnlineStatus.Graveyard : BeatmapOnlineStatus.Loved,
                 });
             }
 

From 2b5aa35b56a0c23058ef9c658b4411f3d7e3ce4a Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Thu, 26 May 2022 17:39:16 -0700
Subject: [PATCH 5051/5547] Fix beatmap info status pill being incorrect on
 multiple status beatmaps

---
 osu.Game/Overlays/BeatmapSet/BeatmapSetHeaderContent.cs | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/BeatmapSet/BeatmapSetHeaderContent.cs b/osu.Game/Overlays/BeatmapSet/BeatmapSetHeaderContent.cs
index 56efb725cd..e0fc7482f6 100644
--- a/osu.Game/Overlays/BeatmapSet/BeatmapSetHeaderContent.cs
+++ b/osu.Game/Overlays/BeatmapSet/BeatmapSetHeaderContent.cs
@@ -10,6 +10,7 @@ using osu.Framework.Graphics.Colour;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Localisation;
+using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.Drawables;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
@@ -229,6 +230,8 @@ namespace osu.Game.Overlays.BeatmapSet
             {
                 Details.BeatmapInfo = b.NewValue;
                 externalLink.Link = $@"{api.WebsiteRootUrl}/beatmapsets/{BeatmapSet.Value?.OnlineID}#{b.NewValue?.Ruleset.ShortName}/{b.NewValue?.OnlineID}";
+
+                onlineStatusPill.Status = b.NewValue?.Status ?? BeatmapOnlineStatus.None;
             };
         }
 
@@ -272,7 +275,6 @@ namespace osu.Game.Overlays.BeatmapSet
                     featuredArtist.Alpha = setInfo.NewValue.TrackId != null ? 1 : 0;
 
                     onlineStatusPill.FadeIn(500, Easing.OutQuint);
-                    onlineStatusPill.Status = setInfo.NewValue.Status;
 
                     downloadButtonsContainer.FadeIn(transition_duration);
                     favouriteButton.FadeIn(transition_duration);

From 125dda716dbd42b0b2203a441c80c6eb546b893a Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Thu, 26 May 2022 19:46:42 -0700
Subject: [PATCH 5052/5547] Add failing scores container visibility test

---
 osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlay.cs | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlay.cs b/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlay.cs
index 80bb2aa2e8..9d206af40e 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlay.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlay.cs
@@ -13,6 +13,7 @@ using System.Linq;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps.Drawables;
 using osu.Game.Online.API.Requests.Responses;
+using osu.Game.Overlays.BeatmapSet.Scores;
 using APIUser = osu.Game.Online.API.Requests.Responses.APIUser;
 
 namespace osu.Game.Tests.Visual.Online
@@ -105,10 +106,12 @@ namespace osu.Game.Tests.Visual.Online
             downloadAssert(true);
 
             AddAssert("status is loved", () => overlay.ChildrenOfType<BeatmapSetOnlineStatusPill>().Single().Status == BeatmapOnlineStatus.Loved);
+            AddAssert("scores container is visible", () => overlay.ChildrenOfType<ScoresContainer>().Single().Alpha == 1);
 
             AddStep("go to second beatmap", () => overlay.ChildrenOfType<BeatmapPicker.DifficultySelectorButton>().ElementAt(1).TriggerClick());
 
             AddAssert("status is graveyard", () => overlay.ChildrenOfType<BeatmapSetOnlineStatusPill>().Single().Status == BeatmapOnlineStatus.Graveyard);
+            AddAssert("scores container is hidden", () => overlay.ChildrenOfType<ScoresContainer>().Single().Alpha == 0);
         }
 
         [Test]

From 355456311447d46394adf2114d6118a11daf6564 Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Thu, 26 May 2022 19:50:54 -0700
Subject: [PATCH 5053/5547] Fix beatmap info scores container not hiding when
 there's no leaderboard

---
 osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.cs b/osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.cs
index 591e4cf73e..5f24a6549d 100644
--- a/osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.cs
+++ b/osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.cs
@@ -253,7 +253,7 @@ namespace osu.Game.Overlays.BeatmapSet.Scores
 
             noScoresPlaceholder.Hide();
 
-            if (Beatmap.Value == null || Beatmap.Value.OnlineID <= 0 || (Beatmap.Value.BeatmapSet as IBeatmapSetOnlineInfo)?.Status <= BeatmapOnlineStatus.Pending)
+            if (Beatmap.Value == null || Beatmap.Value.OnlineID <= 0 || (Beatmap.Value.Status <= BeatmapOnlineStatus.Pending))
             {
                 Scores = null;
                 Hide();

From 389020b4975636f63962e35c60049ac468ccae7f Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Thu, 26 May 2022 20:58:47 -0700
Subject: [PATCH 5054/5547] Fix scores container test failures

---
 osu.Game/Tests/Beatmaps/TestBeatmap.cs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Game/Tests/Beatmaps/TestBeatmap.cs b/osu.Game/Tests/Beatmaps/TestBeatmap.cs
index 3b4547cb49..ff670e1232 100644
--- a/osu.Game/Tests/Beatmaps/TestBeatmap.cs
+++ b/osu.Game/Tests/Beatmaps/TestBeatmap.cs
@@ -35,6 +35,7 @@ namespace osu.Game.Tests.Beatmaps
             BeatmapInfo.Length = 75000;
             BeatmapInfo.OnlineInfo = new APIBeatmap();
             BeatmapInfo.OnlineID = Interlocked.Increment(ref onlineBeatmapID);
+            BeatmapInfo.Status = BeatmapOnlineStatus.Ranked;
 
             Debug.Assert(BeatmapInfo.BeatmapSet != null);
 

From e551a536015a691297993eb5ce005c50e4d8f11a Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Thu, 26 May 2022 21:45:07 -0700
Subject: [PATCH 5055/5547] Fix checkmarks not showing on editor stateful menu
 items

---
 .../Edit/Components/Menus/EditorMenuBar.cs    | 20 +++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/osu.Game/Screens/Edit/Components/Menus/EditorMenuBar.cs b/osu.Game/Screens/Edit/Components/Menus/EditorMenuBar.cs
index 440071bc4c..20b8bba6da 100644
--- a/osu.Game/Screens/Edit/Components/Menus/EditorMenuBar.cs
+++ b/osu.Game/Screens/Edit/Components/Menus/EditorMenuBar.cs
@@ -110,11 +110,31 @@ namespace osu.Game.Screens.Edit.Components.Menus
                     case EditorMenuItemSpacer spacer:
                         return new DrawableSpacer(spacer);
 
+                    case StatefulMenuItem stateful:
+                        return new EditorStatefulMenuItem(stateful);
+
                     default:
                         return new EditorMenuItem(item);
                 }
             }
 
+            private class EditorStatefulMenuItem : DrawableStatefulMenuItem
+            {
+                public EditorStatefulMenuItem(StatefulMenuItem item)
+                    : base(item)
+                {
+                }
+
+                [BackgroundDependencyLoader]
+                private void load(OverlayColourProvider colourProvider)
+                {
+                    BackgroundColour = colourProvider.Background2;
+                    BackgroundColourHover = colourProvider.Background1;
+
+                    Foreground.Padding = new MarginPadding { Vertical = 2 };
+                }
+            }
+
             private class EditorMenuItem : DrawableOsuMenuItem
             {
                 public EditorMenuItem(MenuItem item)

From 105d581f247ce41a9235e356104334b4c903ba46 Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Thu, 26 May 2022 22:23:03 -0700
Subject: [PATCH 5056/5547] Use existing web localisation for chat strings

---
 osu.Game/Overlays/Chat/ChannelList/ChannelList.cs | 9 ++++++---
 osu.Game/Overlays/Chat/ChatOverlayTopBar.cs       | 3 ++-
 osu.Game/Overlays/Chat/ChatTextBar.cs             | 5 +++--
 osu.Game/Overlays/Chat/ChatTextBox.cs             | 3 ++-
 4 files changed, 13 insertions(+), 7 deletions(-)

diff --git a/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs b/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs
index 21b2251aca..ce1ed2b4d7 100644
--- a/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs
+++ b/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs
@@ -7,14 +7,17 @@ using System;
 using System.Linq;
 using System.Collections.Generic;
 using osu.Framework.Allocation;
+using osu.Framework.Extensions.LocalisationExtensions;
 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.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Online.Chat;
 using osu.Game.Overlays.Chat.Listing;
+using osu.Game.Resources.Localisation.Web;
 
 namespace osu.Game.Overlays.Chat.ChannelList
 {
@@ -57,13 +60,13 @@ namespace osu.Game.Overlays.Chat.ChannelList
                         AutoSizeAxes = Axes.Y,
                         Children = new Drawable[]
                         {
-                            new ChannelListLabel("CHANNELS"),
+                            new ChannelListLabel(ChatStrings.ChannelsListTitlePUBLIC.ToUpper()),
                             publicChannelFlow = new ChannelListItemFlow(),
                             selector = new ChannelListItem(ChannelListingChannel)
                             {
                                 Margin = new MarginPadding { Bottom = 10 },
                             },
-                            new ChannelListLabel("DIRECT MESSAGES"),
+                            new ChannelListLabel(ChatStrings.ChannelsListTitlePM.ToUpper()),
                             privateChannelFlow = new ChannelListItemFlow(),
                         },
                     },
@@ -126,7 +129,7 @@ namespace osu.Game.Overlays.Chat.ChannelList
 
         private class ChannelListLabel : OsuSpriteText
         {
-            public ChannelListLabel(string label)
+            public ChannelListLabel(LocalisableString label)
             {
                 Text = label;
                 Margin = new MarginPadding { Left = 18, Bottom = 5 };
diff --git a/osu.Game/Overlays/Chat/ChatOverlayTopBar.cs b/osu.Game/Overlays/Chat/ChatOverlayTopBar.cs
index 3a8cd1fb91..79f22b51f7 100644
--- a/osu.Game/Overlays/Chat/ChatOverlayTopBar.cs
+++ b/osu.Game/Overlays/Chat/ChatOverlayTopBar.cs
@@ -13,6 +13,7 @@ using osu.Framework.Graphics.Textures;
 using osu.Framework.Input.Events;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
+using osu.Game.Resources.Localisation.Web;
 using osuTK;
 using osuTK.Graphics;
 
@@ -58,7 +59,7 @@ namespace osu.Game.Overlays.Chat
                             {
                                 Anchor = Anchor.CentreLeft,
                                 Origin = Anchor.CentreLeft,
-                                Text = "osu!chat",
+                                Text = ChatStrings.TitleCompact,
                                 Font = OsuFont.Torus.With(size: 16, weight: FontWeight.SemiBold),
                                 Margin = new MarginPadding { Bottom = 2f },
                             },
diff --git a/osu.Game/Overlays/Chat/ChatTextBar.cs b/osu.Game/Overlays/Chat/ChatTextBar.cs
index 404d686d91..4dc609acd1 100644
--- a/osu.Game/Overlays/Chat/ChatTextBar.cs
+++ b/osu.Game/Overlays/Chat/ChatTextBar.cs
@@ -14,6 +14,7 @@ using osu.Framework.Graphics.UserInterface;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Online.Chat;
+using osu.Game.Resources.Localisation.Web;
 using osuTK;
 
 namespace osu.Game.Overlays.Chat
@@ -141,11 +142,11 @@ namespace osu.Game.Overlays.Chat
                 switch (newChannel?.Type)
                 {
                     case ChannelType.Public:
-                        chattingText.Text = $"chatting in {newChannel.Name}";
+                        chattingText.Text = ChatStrings.TalkingIn(newChannel.Name);
                         break;
 
                     case ChannelType.PM:
-                        chattingText.Text = $"chatting with {newChannel.Name}";
+                        chattingText.Text = ChatStrings.TalkingWith(newChannel.Name);
                         break;
 
                     default:
diff --git a/osu.Game/Overlays/Chat/ChatTextBox.cs b/osu.Game/Overlays/Chat/ChatTextBox.cs
index e0f949caba..1ee0e8445f 100644
--- a/osu.Game/Overlays/Chat/ChatTextBox.cs
+++ b/osu.Game/Overlays/Chat/ChatTextBox.cs
@@ -5,6 +5,7 @@
 
 using osu.Framework.Bindables;
 using osu.Game.Graphics.UserInterface;
+using osu.Game.Resources.Localisation.Web;
 
 namespace osu.Game.Overlays.Chat
 {
@@ -22,7 +23,7 @@ namespace osu.Game.Overlays.Chat
             {
                 bool showSearch = change.NewValue;
 
-                PlaceholderText = showSearch ? "type here to search" : "type here";
+                PlaceholderText = showSearch ? HomeStrings.SearchPlaceholder : ChatStrings.InputPlaceholder;
                 Text = string.Empty;
             }, true);
         }

From 4967d036063f954cdd37ac33134288ebfb26a881 Mon Sep 17 00:00:00 2001
From: sw1tchbl4d3 <sw1tchbl4d3@sw1tchbl4d3.com>
Date: Fri, 27 May 2022 09:58:40 +0200
Subject: [PATCH 5057/5547] Update currently playing search bar to resemble
 existing UI

---
 .../Dashboard/CurrentlyPlayingDisplay.cs      | 37 +++++++++++--------
 1 file changed, 22 insertions(+), 15 deletions(-)

diff --git a/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs b/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs
index f57c808144..b6deae27e5 100644
--- a/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs
+++ b/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs
@@ -10,6 +10,8 @@ using osu.Framework.Bindables;
 using osu.Framework.Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.Effects;
+using osu.Framework.Graphics.Shapes;
 using osu.Framework.Localisation;
 using osu.Framework.Screens;
 using osu.Game.Database;
@@ -35,35 +37,42 @@ namespace osu.Game.Overlays.Dashboard
 
         private SearchContainer<PlayingUserPanel> userFlow;
 
-        private FocusedTextBox searchBar;
-        private Container<FocusedTextBox> searchBarContainer;
+        private Box searchBarBackground;
+        private BasicSearchTextBox searchBar;
+        private Container<BasicSearchTextBox> searchBarContainer;
 
         [Resolved]
         private SpectatorClient spectatorClient { get; set; }
 
         [BackgroundDependencyLoader]
-        private void load()
+        private void load(OverlayColourProvider colourProvider)
         {
             RelativeSizeAxes = Axes.X;
             AutoSizeAxes = Axes.Y;
 
-            searchBarContainer = new Container<FocusedTextBox>
+            searchBarBackground = new Box
+            {
+                RelativeSizeAxes = Axes.X,
+                Height = 10*2 + search_bar_height,
+                Colour = colourProvider.Background4,
+            };
+
+            searchBarContainer = new Container<BasicSearchTextBox>
             {
                 Anchor = Anchor.TopCentre,
                 Origin = Anchor.TopCentre,
+                RelativeSizeAxes = Axes.X,
                 Padding = new MarginPadding(10),
-                Child = searchBar = new FocusedTextBox
+
+                Child = searchBar = new BasicSearchTextBox
                 {
                     Anchor = Anchor.TopCentre,
                     Origin = Anchor.TopCentre,
                     Height = search_bar_height,
-                    Width = search_bar_width,
 
-                    Colour = OsuColour.Gray(0.8f),
+                    RelativeSizeAxes = Axes.X,
 
-                    PlaceholderText = "Search for User...",
-                    HoldFocus = true,
-                    ReleaseFocusOnCommit = true,
+                    PlaceholderText = "type to search",
                 },
             };
 
@@ -72,7 +81,7 @@ namespace osu.Game.Overlays.Dashboard
                 RelativeSizeAxes = Axes.X,
                 AutoSizeAxes = Axes.Y,
                 Padding = new MarginPadding {
-                    Top = 10 + 10 + search_bar_height,
+                    Top = 10*3 + search_bar_height,
                     Bottom = 10,
                     Right = 10,
                     Left = 10,
@@ -82,6 +91,7 @@ namespace osu.Game.Overlays.Dashboard
 
             InternalChildren = new Drawable[]
             {
+                searchBarBackground,
                 searchBarContainer,
                 userFlow,
             };
@@ -170,10 +180,7 @@ namespace osu.Game.Overlays.Dashboard
                 }
             }
 
-            public bool FilteringActive
-            {
-                set { }
-            }
+            public bool FilteringActive { set; get; }
 
             public PlayingUserPanel(APIUser user)
             {

From 7c459faaf0bd9978f44ec6b2436b08818561866b Mon Sep 17 00:00:00 2001
From: sw1tchbl4d3 <sw1tchbl4d3@sw1tchbl4d3.com>
Date: Fri, 27 May 2022 10:05:59 +0200
Subject: [PATCH 5058/5547] Remove unneeded search_bar_width and more

---
 osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs | 10 ++++------
 1 file changed, 4 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs b/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs
index b6deae27e5..c7b08a1ffc 100644
--- a/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs
+++ b/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs
@@ -10,7 +10,6 @@ using osu.Framework.Bindables;
 using osu.Framework.Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
-using osu.Framework.Graphics.Effects;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Localisation;
 using osu.Framework.Screens;
@@ -30,8 +29,7 @@ namespace osu.Game.Overlays.Dashboard
 {
     internal class CurrentlyPlayingDisplay : CompositeDrawable
     {
-        private const float search_bar_height = 40;
-        private const float search_bar_width = 250;
+        private const float SEARCHBAR_HEIGHT = 40;
 
         private readonly IBindableList<int> playingUsers = new BindableList<int>();
 
@@ -53,7 +51,7 @@ namespace osu.Game.Overlays.Dashboard
             searchBarBackground = new Box
             {
                 RelativeSizeAxes = Axes.X,
-                Height = 10*2 + search_bar_height,
+                Height = 10*2 + SEARCHBAR_HEIGHT,
                 Colour = colourProvider.Background4,
             };
 
@@ -68,7 +66,7 @@ namespace osu.Game.Overlays.Dashboard
                 {
                     Anchor = Anchor.TopCentre,
                     Origin = Anchor.TopCentre,
-                    Height = search_bar_height,
+                    Height = SEARCHBAR_HEIGHT,
 
                     RelativeSizeAxes = Axes.X,
 
@@ -81,7 +79,7 @@ namespace osu.Game.Overlays.Dashboard
                 RelativeSizeAxes = Axes.X,
                 AutoSizeAxes = Axes.Y,
                 Padding = new MarginPadding {
-                    Top = 10*3 + search_bar_height,
+                    Top = 10*3 + SEARCHBAR_HEIGHT,
                     Bottom = 10,
                     Right = 10,
                     Left = 10,

From e53c8518debd9bf30961c620f7dffd4d92c450dd Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 27 May 2022 19:18:37 +0900
Subject: [PATCH 5059/5547] Don't output beatmap parse failures in a visible
 manner

The user can't do much about this. When a user reports a beatmap issue,
the logs will still contain this useful information. Should be fine I
think.

As mentioned in

https://github.com/ppy/osu/discussions/18426
https://github.com/ppy/osu/issues/750
https://github.com/ppy/osu/issues/18372

etc.
---
 osu.Game/Beatmaps/Formats/LegacyDecoder.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Beatmaps/Formats/LegacyDecoder.cs b/osu.Game/Beatmaps/Formats/LegacyDecoder.cs
index 0276abc3ff..ff13e61360 100644
--- a/osu.Game/Beatmaps/Formats/LegacyDecoder.cs
+++ b/osu.Game/Beatmaps/Formats/LegacyDecoder.cs
@@ -59,7 +59,7 @@ namespace osu.Game.Beatmaps.Formats
                 }
                 catch (Exception e)
                 {
-                    Logger.Log($"Failed to process line \"{line}\" into \"{output}\": {e.Message}", LoggingTarget.Runtime, LogLevel.Important);
+                    Logger.Log($"Failed to process line \"{line}\" into \"{output}\": {e.Message}");
                 }
             }
         }

From 6a0cf26722cfa9ab08de4f8f00156657c798afbd Mon Sep 17 00:00:00 2001
From: sw1tchbl4d3 <sw1tchbl4d3@sw1tchbl4d3.com>
Date: Fri, 27 May 2022 12:36:43 +0200
Subject: [PATCH 5060/5547] Make text localisable and add padding constant

---
 osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs b/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs
index c7b08a1ffc..d9418a303e 100644
--- a/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs
+++ b/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs
@@ -30,6 +30,7 @@ namespace osu.Game.Overlays.Dashboard
     internal class CurrentlyPlayingDisplay : CompositeDrawable
     {
         private const float SEARCHBAR_HEIGHT = 40;
+        private const float CONTAINER_PADDING = 10;
 
         private readonly IBindableList<int> playingUsers = new BindableList<int>();
 
@@ -51,7 +52,7 @@ namespace osu.Game.Overlays.Dashboard
             searchBarBackground = new Box
             {
                 RelativeSizeAxes = Axes.X,
-                Height = 10*2 + SEARCHBAR_HEIGHT,
+                Height = CONTAINER_PADDING * 2 + SEARCHBAR_HEIGHT,
                 Colour = colourProvider.Background4,
             };
 
@@ -70,7 +71,7 @@ namespace osu.Game.Overlays.Dashboard
 
                     RelativeSizeAxes = Axes.X,
 
-                    PlaceholderText = "type to search",
+                    PlaceholderText = Resources.Localisation.Web.HomeStrings.SearchPlaceholder,
                 },
             };
 
@@ -79,7 +80,7 @@ namespace osu.Game.Overlays.Dashboard
                 RelativeSizeAxes = Axes.X,
                 AutoSizeAxes = Axes.Y,
                 Padding = new MarginPadding {
-                    Top = 10*3 + SEARCHBAR_HEIGHT,
+                    Top = CONTAINER_PADDING * 3 + SEARCHBAR_HEIGHT,
                     Bottom = 10,
                     Right = 10,
                     Left = 10,

From e1fd37fd4481a7bbee4e2bd20e4a65da943382f3 Mon Sep 17 00:00:00 2001
From: sw1tchbl4d3 <sw1tchbl4d3@sw1tchbl4d3.com>
Date: Fri, 27 May 2022 12:40:31 +0200
Subject: [PATCH 5061/5547] Use new padding constant where appropriate

---
 osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs b/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs
index d9418a303e..a9e9932b5b 100644
--- a/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs
+++ b/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs
@@ -61,7 +61,7 @@ namespace osu.Game.Overlays.Dashboard
                 Anchor = Anchor.TopCentre,
                 Origin = Anchor.TopCentre,
                 RelativeSizeAxes = Axes.X,
-                Padding = new MarginPadding(10),
+                Padding = new MarginPadding(CONTAINER_PADDING),
 
                 Child = searchBar = new BasicSearchTextBox
                 {
@@ -81,9 +81,9 @@ namespace osu.Game.Overlays.Dashboard
                 AutoSizeAxes = Axes.Y,
                 Padding = new MarginPadding {
                     Top = CONTAINER_PADDING * 3 + SEARCHBAR_HEIGHT,
-                    Bottom = 10,
-                    Right = 10,
-                    Left = 10,
+                    Bottom = CONTAINER_PADDING,
+                    Right = CONTAINER_PADDING,
+                    Left = CONTAINER_PADDING,
                 },
                 Spacing = new Vector2(10),
             };

From d94315ee3f320c4edcc562c642dabcd63ecceebd Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 27 May 2022 20:03:30 +0900
Subject: [PATCH 5062/5547] Fix potential crash from unsafe drawable mutation
 in scoreboard update code

---
 .../Screens/OnlinePlay/Match/Components/MatchLeaderboard.cs   | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Match/Components/MatchLeaderboard.cs b/osu.Game/Screens/OnlinePlay/Match/Components/MatchLeaderboard.cs
index ea7de917e2..b92c197f5a 100644
--- a/osu.Game/Screens/OnlinePlay/Match/Components/MatchLeaderboard.cs
+++ b/osu.Game/Screens/OnlinePlay/Match/Components/MatchLeaderboard.cs
@@ -38,13 +38,13 @@ namespace osu.Game.Screens.OnlinePlay.Match.Components
 
             var req = new GetRoomLeaderboardRequest(roomId.Value ?? 0);
 
-            req.Success += r =>
+            req.Success += r => Schedule(() =>
             {
                 if (cancellationToken.IsCancellationRequested)
                     return;
 
                 SetScores(r.Leaderboard, r.UserScore);
-            };
+            });
 
             return req;
         }

From ef47b380c602095a3d635017adb106b294f21e54 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 27 May 2022 20:18:46 +0900
Subject: [PATCH 5063/5547] Add featured artist playlist category

---
 .../Visual/Multiplayer/TestSceneDrawableRoom.cs        |  6 ++++++
 osu.Game/Online/Rooms/RoomCategory.cs                  |  5 +++++
 .../OnlinePlay/Lounge/Components/DrawableRoom.cs       |  2 +-
 .../OnlinePlay/Lounge/Components/RoomsContainer.cs     |  2 +-
 .../OnlinePlay/Playlists/PlaylistsLoungeSubScreen.cs   | 10 +++++++++-
 5 files changed, 22 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoom.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoom.cs
index 7d010592ae..7c1620a345 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoom.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoom.cs
@@ -124,6 +124,12 @@ namespace osu.Game.Tests.Visual.Multiplayer
                             Status = { Value = new RoomStatusOpen() },
                             Category = { Value = RoomCategory.Spotlight },
                         }),
+                        createLoungeRoom(new Room
+                        {
+                            Name = { Value = "Featured artist room" },
+                            Status = { Value = new RoomStatusOpen() },
+                            Category = { Value = RoomCategory.FeaturedArtist },
+                        }),
                     }
                 };
             });
diff --git a/osu.Game/Online/Rooms/RoomCategory.cs b/osu.Game/Online/Rooms/RoomCategory.cs
index a1dcfa5fd9..bca4d78359 100644
--- a/osu.Game/Online/Rooms/RoomCategory.cs
+++ b/osu.Game/Online/Rooms/RoomCategory.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.ComponentModel;
+
 namespace osu.Game.Online.Rooms
 {
     public enum RoomCategory
@@ -8,5 +10,8 @@ namespace osu.Game.Online.Rooms
         // used for osu-web deserialization so names shouldn't be changed.
         Normal,
         Spotlight,
+
+        [Description("Featured Artist")]
+        FeaturedArtist,
     }
 }
diff --git a/osu.Game/Screens/OnlinePlay/Lounge/Components/DrawableRoom.cs b/osu.Game/Screens/OnlinePlay/Lounge/Components/DrawableRoom.cs
index 8e3aa77e7b..772232f6b4 100644
--- a/osu.Game/Screens/OnlinePlay/Lounge/Components/DrawableRoom.cs
+++ b/osu.Game/Screens/OnlinePlay/Lounge/Components/DrawableRoom.cs
@@ -237,7 +237,7 @@ namespace osu.Game.Screens.OnlinePlay.Lounge.Components
                 roomCategory.BindTo(Room.Category);
                 roomCategory.BindValueChanged(c =>
                 {
-                    if (c.NewValue == RoomCategory.Spotlight)
+                    if (c.NewValue > RoomCategory.Normal)
                         specialCategoryPill.Show();
                     else
                         specialCategoryPill.Hide();
diff --git a/osu.Game/Screens/OnlinePlay/Lounge/Components/RoomsContainer.cs b/osu.Game/Screens/OnlinePlay/Lounge/Components/RoomsContainer.cs
index d61fbea387..0fd9290880 100644
--- a/osu.Game/Screens/OnlinePlay/Lounge/Components/RoomsContainer.cs
+++ b/osu.Game/Screens/OnlinePlay/Lounge/Components/RoomsContainer.cs
@@ -128,7 +128,7 @@ namespace osu.Game.Screens.OnlinePlay.Lounge.Components
         {
             foreach (var room in roomFlow)
             {
-                roomFlow.SetLayoutPosition(room, room.Room.Category.Value == RoomCategory.Spotlight
+                roomFlow.SetLayoutPosition(room, room.Room.Category.Value > RoomCategory.Normal
                     // Always show spotlight playlists at the top of the listing.
                     ? float.MinValue
                     : -(room.Room.RoomID.Value ?? 0));
diff --git a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsLoungeSubScreen.cs b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsLoungeSubScreen.cs
index dced9b8691..b36e162e3d 100644
--- a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsLoungeSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsLoungeSubScreen.cs
@@ -2,6 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System.Collections.Generic;
+using System.ComponentModel;
 using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
@@ -49,6 +50,10 @@ namespace osu.Game.Screens.OnlinePlay.Playlists
                 case PlaylistsCategory.Spotlight:
                     criteria.Category = @"spotlight";
                     break;
+
+                case PlaylistsCategory.FeaturedArtist:
+                    criteria.Category = @"featured_artist";
+                    break;
             }
 
             return criteria;
@@ -73,7 +78,10 @@ namespace osu.Game.Screens.OnlinePlay.Playlists
         {
             Any,
             Normal,
-            Spotlight
+            Spotlight,
+
+            [Description("Featured Artist")]
+            FeaturedArtist,
         }
     }
 }

From 883c6f1eb30f460790d4d74fbe16e96f08e866e6 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 27 May 2022 20:19:03 +0900
Subject: [PATCH 5064/5547] Update colour of spotlights playlist to match new
 specs

---
 .../Components/RoomSpecialCategoryPill.cs     | 26 ++++++++++++++++---
 1 file changed, 23 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Lounge/Components/RoomSpecialCategoryPill.cs b/osu.Game/Screens/OnlinePlay/Lounge/Components/RoomSpecialCategoryPill.cs
index 6cdbeb2af4..00e4fbf5eb 100644
--- a/osu.Game/Screens/OnlinePlay/Lounge/Components/RoomSpecialCategoryPill.cs
+++ b/osu.Game/Screens/OnlinePlay/Lounge/Components/RoomSpecialCategoryPill.cs
@@ -2,10 +2,12 @@
 // 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.Graphics.Sprites;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
+using osu.Game.Online.Rooms;
 using osuTK.Graphics;
 
 namespace osu.Game.Screens.OnlinePlay.Lounge.Components
@@ -13,6 +15,10 @@ namespace osu.Game.Screens.OnlinePlay.Lounge.Components
     public class RoomSpecialCategoryPill : OnlinePlayComposite
     {
         private SpriteText text;
+        private PillContainer pill;
+
+        [Resolved]
+        private OsuColour colours { get; set; }
 
         public RoomSpecialCategoryPill()
         {
@@ -20,9 +26,9 @@ namespace osu.Game.Screens.OnlinePlay.Lounge.Components
         }
 
         [BackgroundDependencyLoader]
-        private void load(OsuColour colours)
+        private void load()
         {
-            InternalChild = new PillContainer
+            InternalChild = pill = new PillContainer
             {
                 Background =
                 {
@@ -43,7 +49,21 @@ namespace osu.Game.Screens.OnlinePlay.Lounge.Components
         {
             base.LoadComplete();
 
-            Category.BindValueChanged(c => text.Text = c.NewValue.ToString(), true);
+            Category.BindValueChanged(c =>
+            {
+                text.Text = c.NewValue.GetLocalisableDescription();
+
+                switch (c.NewValue)
+                {
+                    case RoomCategory.Spotlight:
+                        pill.Background.Colour = colours.Green2;
+                        break;
+
+                    case RoomCategory.FeaturedArtist:
+                        pill.Background.Colour = colours.Blue2;
+                        break;
+                }
+            }, true);
         }
     }
 }

From 2f57849bcba348d5eeb24c731d30234d465cab1a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 27 May 2022 20:58:13 +0900
Subject: [PATCH 5065/5547] Fix unexpected assertion failure

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

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoom.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoom.cs
index 7c1620a345..3172a68b81 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoom.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoom.cs
@@ -134,9 +134,9 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 };
             });
 
-            AddUntilStep("wait for panel load", () => rooms.Count == 5);
+            AddUntilStep("wait for panel load", () => rooms.Count == 6);
             AddUntilStep("correct status text", () => rooms.ChildrenOfType<OsuSpriteText>().Count(s => s.Text.ToString().StartsWith("Currently playing", StringComparison.Ordinal)) == 2);
-            AddUntilStep("correct status text", () => rooms.ChildrenOfType<OsuSpriteText>().Count(s => s.Text.ToString().StartsWith("Ready to play", StringComparison.Ordinal)) == 3);
+            AddUntilStep("correct status text", () => rooms.ChildrenOfType<OsuSpriteText>().Count(s => s.Text.ToString().StartsWith("Ready to play", StringComparison.Ordinal)) == 4);
         }
 
         [Test]

From d9ecf69d208e8754cec9dae644a827180e473722 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 27 May 2022 23:29:39 +0900
Subject: [PATCH 5066/5547] Update framework

---
 osu.Android.props        | 2 +-
 osu.Game/osu.Game.csproj | 2 +-
 osu.iOS.props            | 4 ++--
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Android.props b/osu.Android.props
index aaea784852..c51919894e 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -52,7 +52,7 @@
   </ItemGroup>
   <ItemGroup>
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.513.0" />
-    <PackageReference Include="ppy.osu.Framework.Android" Version="2022.521.0" />
+    <PackageReference Include="ppy.osu.Framework.Android" Version="2022.527.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
     <!-- Realm needs to be directly referenced in all Xamarin projects, as it will not pull in its transitive dependencies otherwise. -->
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 5bc65ca507..8cf530ea3c 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="10.11.2" />
-    <PackageReference Include="ppy.osu.Framework" Version="2022.521.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2022.527.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.513.0" />
     <PackageReference Include="Sentry" Version="3.17.1" />
     <PackageReference Include="SharpCompress" Version="0.31.0" />
diff --git a/osu.iOS.props b/osu.iOS.props
index 3597e7e5c0..79bd6bed9e 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -61,7 +61,7 @@
     <Reference Include="System.Net.Http" />
   </ItemGroup>
   <ItemGroup Label="Package References">
-    <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.521.0" />
+    <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.527.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.513.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net6.0) -->
@@ -84,7 +84,7 @@
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="5.0.14" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.Core" Version="5.0.14" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
-    <PackageReference Include="ppy.osu.Framework" Version="2022.521.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2022.527.0" />
     <PackageReference Include="SharpCompress" Version="0.31.0" />
     <PackageReference Include="NUnit" Version="3.13.3" />
     <PackageReference Include="System.ComponentModel.Annotations" Version="5.0.0" />

From 6960bec52d8824a086e96823c49a6a9f571a07c1 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 27 May 2022 23:29:48 +0900
Subject: [PATCH 5067/5547] Update resources

---
 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 d5a77c6349..5688fd8cc4 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -51,7 +51,7 @@
     <Reference Include="Java.Interop" />
   </ItemGroup>
   <ItemGroup>
-    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.513.0" />
+    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.527.0" />
     <PackageReference Include="ppy.osu.Framework.Android" Version="2022.525.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 32a0adb859..5de0f4346c 100644
--- a/osu.Game/osu.Game.csproj
+++ b/osu.Game/osu.Game.csproj
@@ -36,7 +36,7 @@
     </PackageReference>
     <PackageReference Include="Realm" Version="10.11.2" />
     <PackageReference Include="ppy.osu.Framework" Version="2022.525.0" />
-    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.513.0" />
+    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.527.0" />
     <PackageReference Include="Sentry" Version="3.17.1" />
     <PackageReference Include="SharpCompress" Version="0.31.0" />
     <PackageReference Include="NUnit" Version="3.13.3" />
diff --git a/osu.iOS.props b/osu.iOS.props
index 112b5b4615..c1a473ff75 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -62,7 +62,7 @@
   </ItemGroup>
   <ItemGroup Label="Package References">
     <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.525.0" />
-    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.513.0" />
+    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.527.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net6.0) -->
   <PropertyGroup>

From e2951d70d1eac5ee0f2291c2192ac9d8f8598269 Mon Sep 17 00:00:00 2001
From: sw1tchbl4d3 <sw1tchbl4d3@sw1tchbl4d3.com>
Date: Fri, 27 May 2022 16:38:54 +0200
Subject: [PATCH 5068/5547] Address code style issues

---
 .../TestSceneCurrentlyPlayingDisplay.cs       |   4 +-
 .../Dashboard/CurrentlyPlayingDisplay.cs      | 143 ++++++++----------
 2 files changed, 68 insertions(+), 79 deletions(-)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneCurrentlyPlayingDisplay.cs b/osu.Game.Tests/Visual/Online/TestSceneCurrentlyPlayingDisplay.cs
index 35a4f8cf2d..edee26c081 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneCurrentlyPlayingDisplay.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneCurrentlyPlayingDisplay.cs
@@ -11,6 +11,7 @@ using osu.Framework.Testing;
 using osu.Game.Database;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Spectator;
+using osu.Game.Overlays;
 using osu.Game.Overlays.Dashboard;
 using osu.Game.Tests.Visual.Spectator;
 using osu.Game.Users;
@@ -42,7 +43,8 @@ namespace osu.Game.Tests.Visual.Online
                         CachedDependencies = new (Type, object)[]
                         {
                             (typeof(SpectatorClient), spectatorClient),
-                            (typeof(UserLookupCache), lookupCache)
+                            (typeof(UserLookupCache), lookupCache),
+                            (typeof(OverlayColourProvider), new OverlayColourProvider(OverlayColourScheme.Purple)),
                         },
                         Child = currentlyPlaying = new CurrentlyPlayingDisplay
                         {
diff --git a/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs b/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs
index a9e9932b5b..3020b37351 100644
--- a/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs
+++ b/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs
@@ -14,7 +14,6 @@ using osu.Framework.Graphics.Shapes;
 using osu.Framework.Localisation;
 using osu.Framework.Screens;
 using osu.Game.Database;
-using osu.Game.Graphics;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests.Responses;
@@ -29,16 +28,13 @@ namespace osu.Game.Overlays.Dashboard
 {
     internal class CurrentlyPlayingDisplay : CompositeDrawable
     {
-        private const float SEARCHBAR_HEIGHT = 40;
-        private const float CONTAINER_PADDING = 10;
+        private const float searchbox_height = 40f;
+        private const float container_padding = 10f;
 
         private readonly IBindableList<int> playingUsers = new BindableList<int>();
 
         private SearchContainer<PlayingUserPanel> userFlow;
-
-        private Box searchBarBackground;
-        private BasicSearchTextBox searchBar;
-        private Container<BasicSearchTextBox> searchBarContainer;
+        private BasicSearchTextBox userFlowSearchTextBox;
 
         [Resolved]
         private SpectatorClient spectatorClient { get; set; }
@@ -49,53 +45,48 @@ namespace osu.Game.Overlays.Dashboard
             RelativeSizeAxes = Axes.X;
             AutoSizeAxes = Axes.Y;
 
-            searchBarBackground = new Box
-            {
-                RelativeSizeAxes = Axes.X,
-                Height = CONTAINER_PADDING * 2 + SEARCHBAR_HEIGHT,
-                Colour = colourProvider.Background4,
-            };
-
-            searchBarContainer = new Container<BasicSearchTextBox>
-            {
-                Anchor = Anchor.TopCentre,
-                Origin = Anchor.TopCentre,
-                RelativeSizeAxes = Axes.X,
-                Padding = new MarginPadding(CONTAINER_PADDING),
-
-                Child = searchBar = new BasicSearchTextBox
-                {
-                    Anchor = Anchor.TopCentre,
-                    Origin = Anchor.TopCentre,
-                    Height = SEARCHBAR_HEIGHT,
-
-                    RelativeSizeAxes = Axes.X,
-
-                    PlaceholderText = Resources.Localisation.Web.HomeStrings.SearchPlaceholder,
-                },
-            };
-
-            userFlow = new SearchContainer<PlayingUserPanel>
-            {
-                RelativeSizeAxes = Axes.X,
-                AutoSizeAxes = Axes.Y,
-                Padding = new MarginPadding {
-                    Top = CONTAINER_PADDING * 3 + SEARCHBAR_HEIGHT,
-                    Bottom = CONTAINER_PADDING,
-                    Right = CONTAINER_PADDING,
-                    Left = CONTAINER_PADDING,
-                },
-                Spacing = new Vector2(10),
-            };
-
             InternalChildren = new Drawable[]
             {
-                searchBarBackground,
-                searchBarContainer,
-                userFlow,
+                new Box
+                {
+                    RelativeSizeAxes = Axes.X,
+                    Height = container_padding * 2 + searchbox_height,
+                    Colour = colourProvider.Background4,
+                },
+
+                new Container<BasicSearchTextBox>
+                {
+                    RelativeSizeAxes = Axes.X,
+                    Anchor = Anchor.TopCentre,
+                    Origin = Anchor.TopCentre,
+                    Padding = new MarginPadding(container_padding),
+
+                    Child = userFlowSearchTextBox = new BasicSearchTextBox
+                    {
+                        RelativeSizeAxes = Axes.X,
+                        Anchor = Anchor.TopCentre,
+                        Origin = Anchor.TopCentre,
+                        Height = searchbox_height,
+                        PlaceholderText = Resources.Localisation.Web.HomeStrings.SearchPlaceholder,
+                    },
+                },
+
+                userFlow = new SearchContainer<PlayingUserPanel>
+                {
+                    RelativeSizeAxes = Axes.X,
+                    AutoSizeAxes = Axes.Y,
+                    Padding = new MarginPadding
+                    {
+                        Top = container_padding * 3 + searchbox_height,
+                        Bottom = container_padding,
+                        Right = container_padding,
+                        Left = container_padding,
+                    },
+                    Spacing = new Vector2(10),
+                },
             };
 
-            searchBar.Current.ValueChanged += onSearchBarValueChanged;
+            userFlowSearchTextBox.Current.ValueChanged += onSearchBarValueChanged;
         }
 
         [Resolved]
@@ -109,27 +100,7 @@ namespace osu.Game.Overlays.Dashboard
             playingUsers.BindCollectionChanged(onPlayingUsersChanged, true);
         }
 
-        private void addCard(int userId)
-        {
-            users.GetUserAsync(userId).ContinueWith(task =>
-            {
-                var user = task.GetResultSafely();
-
-                if (user == null)
-                    return;
-
-                Schedule(() =>
-                {
-                    // user may no longer be playing.
-                    if (!playingUsers.Contains(user.Id))
-                        return;
-
-                    userFlow.Add(createUserPanel(user));
-                });
-            });
-        }
-
-        private void onSearchBarValueChanged(ValueChangedEvent<string> change) => userFlow.SearchTerm = searchBar.Text;
+        private void onSearchBarValueChanged(ValueChangedEvent<string> change) => userFlow.SearchTerm = userFlowSearchTextBox.Text;
 
         private void onPlayingUsersChanged(object sender, NotifyCollectionChangedEventArgs e) => Schedule(() =>
         {
@@ -139,7 +110,24 @@ namespace osu.Game.Overlays.Dashboard
                     Debug.Assert(e.NewItems != null);
 
                     foreach (int userId in e.NewItems)
-                        addCard(userId);
+                    {
+                        users.GetUserAsync(userId).ContinueWith(task =>
+                        {
+                            var user = task.GetResultSafely();
+
+                            if (user == null)
+                                return;
+
+                            Schedule(() =>
+                            {
+                                // user may no longer be playing.
+                                if (!playingUsers.Contains(user.Id))
+                                    return;
+
+                                userFlow.Add(createUserPanel(user));
+                            });
+                        });
+                    }
 
                     break;
 
@@ -159,14 +147,15 @@ namespace osu.Game.Overlays.Dashboard
                 panel.Origin = Anchor.TopCentre;
             });
 
-        private class PlayingUserPanel : CompositeDrawable, IFilterable
+        public class PlayingUserPanel : CompositeDrawable, IFilterable
         {
             public readonly APIUser User;
-            public IEnumerable<LocalisableString> FilterTerms => filterTerm;
+            public IEnumerable<LocalisableString> FilterTerms { get; set; }
 
             [Resolved(canBeNull: true)]
             private IPerformFromScreenRunner performer { get; set; }
-            private IEnumerable<LocalisableString> filterTerm;
+
+            public bool FilteringActive { set; get; }
 
             public bool MatchingFilter
             {
@@ -179,12 +168,10 @@ namespace osu.Game.Overlays.Dashboard
                 }
             }
 
-            public bool FilteringActive { set; get; }
-
             public PlayingUserPanel(APIUser user)
             {
                 User = user;
-                filterTerm = new LocalisableString[] { User.Username };
+                FilterTerms = new LocalisableString[] { User.Username };
 
                 AutoSizeAxes = Axes.Both;
             }

From a94432f3bd743ec4c98f8d45a2e095f6f5f85e16 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 27 May 2022 16:40:15 +0200
Subject: [PATCH 5069/5547] Fix drawable room border colour not matching badge

---
 osu.Game/Graphics/OsuColour.cs                | 19 +++++++++++++++++++
 .../Components/StatusColouredContainer.cs     |  3 +--
 .../Components/RoomSpecialCategoryPill.cs     | 14 +++-----------
 3 files changed, 23 insertions(+), 13 deletions(-)

diff --git a/osu.Game/Graphics/OsuColour.cs b/osu.Game/Graphics/OsuColour.cs
index afedf36cad..7a6a677940 100644
--- a/osu.Game/Graphics/OsuColour.cs
+++ b/osu.Game/Graphics/OsuColour.cs
@@ -4,6 +4,7 @@
 using System;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Game.Beatmaps;
+using osu.Game.Online.Rooms;
 using osu.Game.Overlays;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Scoring;
@@ -188,6 +189,24 @@ namespace osu.Game.Graphics
             }
         }
 
+        /// <summary>
+        /// Retrieves the main accent colour for a <see cref="RoomCategory"/>.
+        /// </summary>
+        public Color4? ForRoomCategory(RoomCategory roomCategory)
+        {
+            switch (roomCategory)
+            {
+                case RoomCategory.Spotlight:
+                    return Green2;
+
+                case RoomCategory.FeaturedArtist:
+                    return Blue2;
+
+                default:
+                    return null;
+            }
+        }
+
         /// <summary>
         /// Returns a foreground text colour that is supposed to contrast well with
         /// the supplied <paramref name="backgroundColour"/>.
diff --git a/osu.Game/Screens/OnlinePlay/Components/StatusColouredContainer.cs b/osu.Game/Screens/OnlinePlay/Components/StatusColouredContainer.cs
index 760de354dc..a7ea32ee7c 100644
--- a/osu.Game/Screens/OnlinePlay/Components/StatusColouredContainer.cs
+++ b/osu.Game/Screens/OnlinePlay/Components/StatusColouredContainer.cs
@@ -30,8 +30,7 @@ namespace osu.Game.Screens.OnlinePlay.Components
         {
             status.BindValueChanged(s =>
             {
-                this.FadeColour(category.Value == RoomCategory.Spotlight ? colours.Pink : s.NewValue.GetAppropriateColour(colours)
-                    , transitionDuration);
+                this.FadeColour(colours.ForRoomCategory(category.Value) ?? s.NewValue.GetAppropriateColour(colours), transitionDuration);
             }, true);
         }
     }
diff --git a/osu.Game/Screens/OnlinePlay/Lounge/Components/RoomSpecialCategoryPill.cs b/osu.Game/Screens/OnlinePlay/Lounge/Components/RoomSpecialCategoryPill.cs
index 00e4fbf5eb..539af2ebaf 100644
--- a/osu.Game/Screens/OnlinePlay/Lounge/Components/RoomSpecialCategoryPill.cs
+++ b/osu.Game/Screens/OnlinePlay/Lounge/Components/RoomSpecialCategoryPill.cs
@@ -7,7 +7,6 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Sprites;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
-using osu.Game.Online.Rooms;
 using osuTK.Graphics;
 
 namespace osu.Game.Screens.OnlinePlay.Lounge.Components
@@ -53,16 +52,9 @@ namespace osu.Game.Screens.OnlinePlay.Lounge.Components
             {
                 text.Text = c.NewValue.GetLocalisableDescription();
 
-                switch (c.NewValue)
-                {
-                    case RoomCategory.Spotlight:
-                        pill.Background.Colour = colours.Green2;
-                        break;
-
-                    case RoomCategory.FeaturedArtist:
-                        pill.Background.Colour = colours.Blue2;
-                        break;
-                }
+                var backgroundColour = colours.ForRoomCategory(Category.Value);
+                if (backgroundColour != null)
+                    pill.Background.Colour = backgroundColour.Value;
             }, true);
         }
     }

From 320b6ca6317139acb9b75df645c4bf4722266c9d Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Fri, 27 May 2022 16:06:23 +0100
Subject: [PATCH 5070/5547] Display Announce type channels separately in new
 chat overlay

---
 .../Visual/Online/TestSceneChannelList.cs     | 19 +++++++++-
 .../Visual/Online/TestSceneChatOverlayV2.cs   | 16 +++++++++
 .../Overlays/Chat/ChannelList/ChannelList.cs  | 36 +++++++++++++++----
 osu.Game/Overlays/Chat/ChatTextBar.cs         |  6 ++--
 4 files changed, 66 insertions(+), 11 deletions(-)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneChannelList.cs b/osu.Game.Tests/Visual/Online/TestSceneChannelList.cs
index e4bc5645b6..39a4f1a8a1 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneChannelList.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneChannelList.cs
@@ -87,7 +87,7 @@ namespace osu.Game.Tests.Visual.Online
                 {
                     leaveText.Text = $"OnRequestLeave: {channel.Name}";
                     leaveText.FadeOutFromOne(1000, Easing.InQuint);
-                    selected.Value = null;
+                    selected.Value = channelList.ChannelListingChannel;
                     channelList.RemoveChannel(channel);
                 };
 
@@ -112,6 +112,12 @@ namespace osu.Game.Tests.Visual.Online
                 for (int i = 0; i < 10; i++)
                     channelList.AddChannel(createRandomPrivateChannel());
             });
+
+            AddStep("Add Announce Channels", () =>
+            {
+                for (int i = 0; i < 2; i++)
+                    channelList.AddChannel(createRandomAnnounceChannel());
+            });
         }
 
         [Test]
@@ -170,5 +176,16 @@ namespace osu.Game.Tests.Visual.Online
                 Username = $"test user {id}",
             });
         }
+
+        private Channel createRandomAnnounceChannel()
+        {
+            int id = RNG.Next(0, 10000);
+            return new Channel
+            {
+                Name = $"Announce {id}",
+                Type = ChannelType.Announce,
+                Id = id,
+            };
+        }
     }
 }
diff --git a/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs b/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs
index 0580d20171..ed6e2bb2c0 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs
@@ -452,6 +452,7 @@ namespace osu.Game.Tests.Visual.Online
         [Test]
         public void TestKeyboardNextChannel()
         {
+            Channel announceChannel = createAnnounceChannel();
             Channel pmChannel1 = createPrivateChannel();
             Channel pmChannel2 = createPrivateChannel();
 
@@ -461,6 +462,7 @@ namespace osu.Game.Tests.Visual.Online
                 channelManager.JoinChannel(testChannel2);
                 channelManager.JoinChannel(pmChannel1);
                 channelManager.JoinChannel(pmChannel2);
+                channelManager.JoinChannel(announceChannel);
                 chatOverlay.Show();
             });
 
@@ -475,6 +477,9 @@ namespace osu.Game.Tests.Visual.Online
             AddStep("Press document next keys", () => InputManager.Keys(PlatformAction.DocumentNext));
             AddAssert("PM Channel 2 displayed", () => channelIsVisible && currentDrawableChannel.Channel == pmChannel2);
 
+            AddStep("Press document next keys", () => InputManager.Keys(PlatformAction.DocumentNext));
+            AddAssert("Announce channel displayed", () => channelIsVisible && currentDrawableChannel.Channel == announceChannel);
+
             AddStep("Press document next keys", () => InputManager.Keys(PlatformAction.DocumentNext));
             AddAssert("Channel 1 displayed", () => channelIsVisible && currentDrawableChannel.Channel == testChannel1);
         }
@@ -539,6 +544,17 @@ namespace osu.Game.Tests.Visual.Online
             });
         }
 
+        private Channel createAnnounceChannel()
+        {
+            int id = RNG.Next(0, 10000);
+            return new Channel
+            {
+                Name = $"Announce {id}",
+                Type = ChannelType.Announce,
+                Id = id,
+            };
+        }
+
         private class TestChatOverlayV2 : ChatOverlayV2
         {
             public bool SlowLoading { get; set; }
diff --git a/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs b/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs
index ce1ed2b4d7..881491d2af 100644
--- a/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs
+++ b/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs
@@ -26,13 +26,16 @@ namespace osu.Game.Overlays.Chat.ChannelList
         public Action<Channel>? OnRequestSelect;
         public Action<Channel>? OnRequestLeave;
 
-        public IEnumerable<Channel> Channels => publicChannelFlow.Channels.Concat(privateChannelFlow.Channels);
+        public IEnumerable<Channel> Channels =>
+            announceChannelFlow.Channels.Concat(publicChannelFlow.Channels).Concat(privateChannelFlow.Channels);
 
         public readonly ChannelListing.ChannelListingChannel ChannelListingChannel = new ChannelListing.ChannelListingChannel();
 
         private readonly Dictionary<Channel, ChannelListItem> channelMap = new Dictionary<Channel, ChannelListItem>();
 
         private OsuScrollContainer scroll = null!;
+        private ChannelListLabel announceChannelLabel = null!;
+        private ChannelListItemFlow announceChannelFlow = null!;
         private ChannelListItemFlow publicChannelFlow = null!;
         private ChannelListItemFlow privateChannelFlow = null!;
         private ChannelListItem selector = null!;
@@ -49,7 +52,6 @@ namespace osu.Game.Overlays.Chat.ChannelList
                 },
                 scroll = new OsuScrollContainer
                 {
-                    Padding = new MarginPadding { Vertical = 7 },
                     RelativeSizeAxes = Axes.Both,
                     ScrollbarAnchor = Anchor.TopRight,
                     ScrollDistance = 35f,
@@ -60,12 +62,11 @@ namespace osu.Game.Overlays.Chat.ChannelList
                         AutoSizeAxes = Axes.Y,
                         Children = new Drawable[]
                         {
+                            announceChannelLabel = new ChannelListLabel(ChatStrings.ChannelsListTitleANNOUNCE.ToUpper()),
+                            announceChannelFlow = new ChannelListItemFlow(),
                             new ChannelListLabel(ChatStrings.ChannelsListTitlePUBLIC.ToUpper()),
                             publicChannelFlow = new ChannelListItemFlow(),
-                            selector = new ChannelListItem(ChannelListingChannel)
-                            {
-                                Margin = new MarginPadding { Bottom = 10 },
-                            },
+                            selector = new ChannelListItem(ChannelListingChannel),
                             new ChannelListLabel(ChatStrings.ChannelsListTitlePM.ToUpper()),
                             privateChannelFlow = new ChannelListItemFlow(),
                         },
@@ -88,6 +89,8 @@ namespace osu.Game.Overlays.Chat.ChannelList
             ChannelListItemFlow flow = getFlowForChannel(channel);
             channelMap.Add(channel, item);
             flow.Add(item);
+
+            updateVisibility();
         }
 
         public void RemoveChannel(Channel channel)
@@ -100,6 +103,8 @@ namespace osu.Game.Overlays.Chat.ChannelList
 
             channelMap.Remove(channel);
             flow.Remove(item);
+
+            updateVisibility();
         }
 
         public ChannelListItem GetItem(Channel channel)
@@ -122,17 +127,34 @@ namespace osu.Game.Overlays.Chat.ChannelList
                 case ChannelType.PM:
                     return privateChannelFlow;
 
+                case ChannelType.Announce:
+                    return announceChannelFlow;
+
                 default:
                     return publicChannelFlow;
             }
         }
 
+        private void updateVisibility()
+        {
+            if (announceChannelFlow.Channels.Count() == 0)
+            {
+                announceChannelLabel.Hide();
+                announceChannelFlow.Hide();
+            }
+            else
+            {
+                announceChannelLabel.Show();
+                announceChannelFlow.Show();
+            }
+        }
+
         private class ChannelListLabel : OsuSpriteText
         {
             public ChannelListLabel(LocalisableString label)
             {
                 Text = label;
-                Margin = new MarginPadding { Left = 18, Bottom = 5 };
+                Margin = new MarginPadding { Left = 18, Bottom = 5, Top = 8 };
                 Font = OsuFont.Torus.With(size: 12, weight: FontWeight.SemiBold);
             }
         }
diff --git a/osu.Game/Overlays/Chat/ChatTextBar.cs b/osu.Game/Overlays/Chat/ChatTextBar.cs
index 4dc609acd1..5100959eeb 100644
--- a/osu.Game/Overlays/Chat/ChatTextBar.cs
+++ b/osu.Game/Overlays/Chat/ChatTextBar.cs
@@ -141,8 +141,8 @@ namespace osu.Game.Overlays.Chat
 
                 switch (newChannel?.Type)
                 {
-                    case ChannelType.Public:
-                        chattingText.Text = ChatStrings.TalkingIn(newChannel.Name);
+                    case null:
+                        chattingText.Text = string.Empty;
                         break;
 
                     case ChannelType.PM:
@@ -150,7 +150,7 @@ namespace osu.Game.Overlays.Chat
                         break;
 
                     default:
-                        chattingText.Text = string.Empty;
+                        chattingText.Text = ChatStrings.TalkingIn(newChannel.Name);
                         break;
                 }
             }, true);

From e950c8c1d032ac0aaae54cb35baab53a834e0acd Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Fri, 27 May 2022 19:46:53 +0100
Subject: [PATCH 5071/5547] Refactor `ChannelList` to use new `ChannelGroup`
 class for each type of channel

---
 .../Overlays/Chat/ChannelList/ChannelList.cs  | 84 ++++++++++---------
 1 file changed, 43 insertions(+), 41 deletions(-)

diff --git a/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs b/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs
index 881491d2af..a46ae98dfa 100644
--- a/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs
+++ b/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs
@@ -26,18 +26,20 @@ namespace osu.Game.Overlays.Chat.ChannelList
         public Action<Channel>? OnRequestSelect;
         public Action<Channel>? OnRequestLeave;
 
-        public IEnumerable<Channel> Channels =>
-            announceChannelFlow.Channels.Concat(publicChannelFlow.Channels).Concat(privateChannelFlow.Channels);
+        public IEnumerable<Channel> Channels => groupFlow.Children.Where(child => child is ChannelGroup)
+                                                                  .Cast<ChannelGroup>()
+                                                                  .SelectMany(channelGroup => channelGroup.ItemFlow)
+                                                                  .Select(item => item.Channel);
 
         public readonly ChannelListing.ChannelListingChannel ChannelListingChannel = new ChannelListing.ChannelListingChannel();
 
         private readonly Dictionary<Channel, ChannelListItem> channelMap = new Dictionary<Channel, ChannelListItem>();
 
         private OsuScrollContainer scroll = null!;
-        private ChannelListLabel announceChannelLabel = null!;
-        private ChannelListItemFlow announceChannelFlow = null!;
-        private ChannelListItemFlow publicChannelFlow = null!;
-        private ChannelListItemFlow privateChannelFlow = null!;
+        private FillFlowContainer groupFlow = null!;
+        private ChannelGroup announceChannelGroup = null!;
+        private ChannelGroup publicChannelGroup = null!;
+        private ChannelGroup privateChannelGroup = null!;
         private ChannelListItem selector = null!;
 
         [BackgroundDependencyLoader]
@@ -55,20 +57,17 @@ namespace osu.Game.Overlays.Chat.ChannelList
                     RelativeSizeAxes = Axes.Both,
                     ScrollbarAnchor = Anchor.TopRight,
                     ScrollDistance = 35f,
-                    Child = new FillFlowContainer
+                    Child = groupFlow = new FillFlowContainer
                     {
                         Direction = FillDirection.Vertical,
                         RelativeSizeAxes = Axes.X,
                         AutoSizeAxes = Axes.Y,
                         Children = new Drawable[]
                         {
-                            announceChannelLabel = new ChannelListLabel(ChatStrings.ChannelsListTitleANNOUNCE.ToUpper()),
-                            announceChannelFlow = new ChannelListItemFlow(),
-                            new ChannelListLabel(ChatStrings.ChannelsListTitlePUBLIC.ToUpper()),
-                            publicChannelFlow = new ChannelListItemFlow(),
+                            announceChannelGroup = new ChannelGroup(ChatStrings.ChannelsListTitleANNOUNCE.ToUpper()),
+                            publicChannelGroup = new ChannelGroup(ChatStrings.ChannelsListTitlePUBLIC.ToUpper()),
                             selector = new ChannelListItem(ChannelListingChannel),
-                            new ChannelListLabel(ChatStrings.ChannelsListTitlePM.ToUpper()),
-                            privateChannelFlow = new ChannelListItemFlow(),
+                            privateChannelGroup = new ChannelGroup(ChatStrings.ChannelsListTitlePM.ToUpper()),
                         },
                     },
                 },
@@ -86,7 +85,7 @@ namespace osu.Game.Overlays.Chat.ChannelList
             item.OnRequestSelect += chan => OnRequestSelect?.Invoke(chan);
             item.OnRequestLeave += chan => OnRequestLeave?.Invoke(chan);
 
-            ChannelListItemFlow flow = getFlowForChannel(channel);
+            FillFlowContainer<ChannelListItem> flow = getFlowForChannel(channel);
             channelMap.Add(channel, item);
             flow.Add(item);
 
@@ -99,7 +98,7 @@ namespace osu.Game.Overlays.Chat.ChannelList
                 return;
 
             ChannelListItem item = channelMap[channel];
-            ChannelListItemFlow flow = getFlowForChannel(channel);
+            FillFlowContainer<ChannelListItem> flow = getFlowForChannel(channel);
 
             channelMap.Remove(channel);
             flow.Remove(item);
@@ -117,57 +116,60 @@ namespace osu.Game.Overlays.Chat.ChannelList
 
         public void ScrollChannelIntoView(Channel channel) => scroll.ScrollIntoView(GetItem(channel));
 
-        private ChannelListItemFlow getFlowForChannel(Channel channel)
+        private FillFlowContainer<ChannelListItem> getFlowForChannel(Channel channel)
         {
             switch (channel.Type)
             {
                 case ChannelType.Public:
-                    return publicChannelFlow;
+                    return publicChannelGroup.ItemFlow;
 
                 case ChannelType.PM:
-                    return privateChannelFlow;
+                    return privateChannelGroup.ItemFlow;
 
                 case ChannelType.Announce:
-                    return announceChannelFlow;
+                    return announceChannelGroup.ItemFlow;
 
                 default:
-                    return publicChannelFlow;
+                    return publicChannelGroup.ItemFlow;
             }
         }
 
         private void updateVisibility()
         {
-            if (announceChannelFlow.Channels.Count() == 0)
-            {
-                announceChannelLabel.Hide();
-                announceChannelFlow.Hide();
-            }
+            if (announceChannelGroup.ItemFlow.Children.Count == 0)
+                announceChannelGroup.Hide();
             else
-            {
-                announceChannelLabel.Show();
-                announceChannelFlow.Show();
-            }
+                announceChannelGroup.Show();
         }
 
-        private class ChannelListLabel : OsuSpriteText
+        private class ChannelGroup : FillFlowContainer
         {
-            public ChannelListLabel(LocalisableString label)
-            {
-                Text = label;
-                Margin = new MarginPadding { Left = 18, Bottom = 5, Top = 8 };
-                Font = OsuFont.Torus.With(size: 12, weight: FontWeight.SemiBold);
-            }
-        }
+            public FillFlowContainer<ChannelListItem> ItemFlow => flow;
 
-        private class ChannelListItemFlow : FillFlowContainer<ChannelListItem>
-        {
-            public IEnumerable<Channel> Channels => Children.Select(c => c.Channel);
+            private readonly FillFlowContainer<ChannelListItem> flow;
 
-            public ChannelListItemFlow()
+            public ChannelGroup(LocalisableString label)
             {
                 Direction = FillDirection.Vertical;
                 RelativeSizeAxes = Axes.X;
                 AutoSizeAxes = Axes.Y;
+                Padding = new MarginPadding { Top = 8 };
+
+                Children = new Drawable[]
+                {
+                    new OsuSpriteText
+                    {
+                        Text = label,
+                        Margin = new MarginPadding { Left = 18, Bottom = 5 },
+                        Font = OsuFont.Torus.With(size: 12, weight: FontWeight.SemiBold),
+                    },
+                    flow = new FillFlowContainer<ChannelListItem>
+                    {
+                        Direction = FillDirection.Vertical,
+                        RelativeSizeAxes = Axes.X,
+                        AutoSizeAxes = Axes.Y,
+                    },
+                };
             }
         }
     }

From 254039b8fe9fa21ae584663b792aa7b81d650a29 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 28 May 2022 04:01:51 +0900
Subject: [PATCH 5072/5547] Address remaining code quality concerns

---
 .../Dashboard/CurrentlyPlayingDisplay.cs      | 40 +++++++++----------
 1 file changed, 18 insertions(+), 22 deletions(-)

diff --git a/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs b/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs
index 3020b37351..0a1cf5524f 100644
--- a/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs
+++ b/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs
@@ -18,6 +18,7 @@ using osu.Game.Graphics.UserInterface;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Spectator;
+using osu.Game.Resources.Localisation.Web;
 using osu.Game.Screens;
 using osu.Game.Screens.OnlinePlay.Match.Components;
 using osu.Game.Screens.Play;
@@ -28,13 +29,13 @@ namespace osu.Game.Overlays.Dashboard
 {
     internal class CurrentlyPlayingDisplay : CompositeDrawable
     {
-        private const float searchbox_height = 40f;
-        private const float container_padding = 10f;
+        private const float search_textbox_height = 40;
+        private const float padding = 10;
 
         private readonly IBindableList<int> playingUsers = new BindableList<int>();
 
         private SearchContainer<PlayingUserPanel> userFlow;
-        private BasicSearchTextBox userFlowSearchTextBox;
+        private BasicSearchTextBox searchTextBox;
 
         [Resolved]
         private SpectatorClient spectatorClient { get; set; }
@@ -50,43 +51,38 @@ namespace osu.Game.Overlays.Dashboard
                 new Box
                 {
                     RelativeSizeAxes = Axes.X,
-                    Height = container_padding * 2 + searchbox_height,
+                    Height = padding * 2 + search_textbox_height,
                     Colour = colourProvider.Background4,
                 },
-
                 new Container<BasicSearchTextBox>
                 {
                     RelativeSizeAxes = Axes.X,
-                    Anchor = Anchor.TopCentre,
-                    Origin = Anchor.TopCentre,
-                    Padding = new MarginPadding(container_padding),
-
-                    Child = userFlowSearchTextBox = new BasicSearchTextBox
+                    Padding = new MarginPadding(padding),
+                    Child = searchTextBox = new BasicSearchTextBox
                     {
                         RelativeSizeAxes = Axes.X,
                         Anchor = Anchor.TopCentre,
                         Origin = Anchor.TopCentre,
-                        Height = searchbox_height,
-                        PlaceholderText = Resources.Localisation.Web.HomeStrings.SearchPlaceholder,
+                        Height = search_textbox_height,
+                        PlaceholderText = HomeStrings.SearchPlaceholder,
                     },
                 },
-
                 userFlow = new SearchContainer<PlayingUserPanel>
                 {
                     RelativeSizeAxes = Axes.X,
                     AutoSizeAxes = Axes.Y,
+                    Spacing = new Vector2(10),
                     Padding = new MarginPadding
                     {
-                        Top = container_padding * 3 + searchbox_height,
-                        Bottom = container_padding,
-                        Right = container_padding,
-                        Left = container_padding,
+                        Top = padding * 3 + search_textbox_height,
+                        Bottom = padding,
+                        Right = padding,
+                        Left = padding,
                     },
-                    Spacing = new Vector2(10),
                 },
             };
 
-            userFlowSearchTextBox.Current.ValueChanged += onSearchBarValueChanged;
+            searchTextBox.Current.ValueChanged += text => userFlow.SearchTerm = text.NewValue;
         }
 
         [Resolved]
@@ -100,8 +96,6 @@ namespace osu.Game.Overlays.Dashboard
             playingUsers.BindCollectionChanged(onPlayingUsersChanged, true);
         }
 
-        private void onSearchBarValueChanged(ValueChangedEvent<string> change) => userFlow.SearchTerm = userFlowSearchTextBox.Text;
-
         private void onPlayingUsersChanged(object sender, NotifyCollectionChangedEventArgs e) => Schedule(() =>
         {
             switch (e.Action)
@@ -150,7 +144,8 @@ namespace osu.Game.Overlays.Dashboard
         public class PlayingUserPanel : CompositeDrawable, IFilterable
         {
             public readonly APIUser User;
-            public IEnumerable<LocalisableString> FilterTerms { get; set; }
+
+            public IEnumerable<LocalisableString> FilterTerms { get; }
 
             [Resolved(canBeNull: true)]
             private IPerformFromScreenRunner performer { get; set; }
@@ -171,6 +166,7 @@ namespace osu.Game.Overlays.Dashboard
             public PlayingUserPanel(APIUser user)
             {
                 User = user;
+
                 FilterTerms = new LocalisableString[] { User.Username };
 
                 AutoSizeAxes = Axes.Both;

From 5eb16ff46c604417f4249eb4c7ebe03cd4d74b4a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 28 May 2022 04:02:35 +0900
Subject: [PATCH 5073/5547] Update framework

---
 osu.Android.props        | 2 +-
 osu.Game/osu.Game.csproj | 2 +-
 osu.iOS.props            | 4 ++--
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Android.props b/osu.Android.props
index 96a99cfdd2..ecc929a66d 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -52,7 +52,7 @@
   </ItemGroup>
   <ItemGroup>
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.527.0" />
-    <PackageReference Include="ppy.osu.Framework.Android" Version="2022.527.0" />
+    <PackageReference Include="ppy.osu.Framework.Android" Version="2022.528.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
     <!-- Realm needs to be directly referenced in all Xamarin projects, as it will not pull in its transitive dependencies otherwise. -->
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 1ae8275444..950d4ceae1 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="10.11.2" />
-    <PackageReference Include="ppy.osu.Framework" Version="2022.527.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2022.528.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.527.0" />
     <PackageReference Include="Sentry" Version="3.17.1" />
     <PackageReference Include="SharpCompress" Version="0.31.0" />
diff --git a/osu.iOS.props b/osu.iOS.props
index 0a3bfa7ae8..bcff0d3c44 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -61,7 +61,7 @@
     <Reference Include="System.Net.Http" />
   </ItemGroup>
   <ItemGroup Label="Package References">
-    <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.527.0" />
+    <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.528.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.527.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net6.0) -->
@@ -84,7 +84,7 @@
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="5.0.14" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.Core" Version="5.0.14" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
-    <PackageReference Include="ppy.osu.Framework" Version="2022.527.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2022.528.0" />
     <PackageReference Include="SharpCompress" Version="0.31.0" />
     <PackageReference Include="NUnit" Version="3.13.3" />
     <PackageReference Include="System.ComponentModel.Annotations" Version="5.0.0" />

From c5845f307a7cac07a13f39b52ef9ac71fd7e261c Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Fri, 27 May 2022 20:12:00 +0100
Subject: [PATCH 5074/5547] Code quality

---
 osu.Game/Overlays/Chat/ChannelList/ChannelList.cs | 12 +++++-------
 1 file changed, 5 insertions(+), 7 deletions(-)

diff --git a/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs b/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs
index a46ae98dfa..0f3d8574c1 100644
--- a/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs
+++ b/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs
@@ -27,9 +27,9 @@ namespace osu.Game.Overlays.Chat.ChannelList
         public Action<Channel>? OnRequestLeave;
 
         public IEnumerable<Channel> Channels => groupFlow.Children.Where(child => child is ChannelGroup)
-                                                                  .Cast<ChannelGroup>()
-                                                                  .SelectMany(channelGroup => channelGroup.ItemFlow)
-                                                                  .Select(item => item.Channel);
+                                                .Cast<ChannelGroup>()
+                                                .SelectMany(channelGroup => channelGroup.ItemFlow)
+                                                .Select(item => item.Channel);
 
         public readonly ChannelListing.ChannelListingChannel ChannelListingChannel = new ChannelListing.ChannelListingChannel();
 
@@ -144,9 +144,7 @@ namespace osu.Game.Overlays.Chat.ChannelList
 
         private class ChannelGroup : FillFlowContainer
         {
-            public FillFlowContainer<ChannelListItem> ItemFlow => flow;
-
-            private readonly FillFlowContainer<ChannelListItem> flow;
+            public readonly FillFlowContainer<ChannelListItem> ItemFlow;
 
             public ChannelGroup(LocalisableString label)
             {
@@ -163,7 +161,7 @@ namespace osu.Game.Overlays.Chat.ChannelList
                         Margin = new MarginPadding { Left = 18, Bottom = 5 },
                         Font = OsuFont.Torus.With(size: 12, weight: FontWeight.SemiBold),
                     },
-                    flow = new FillFlowContainer<ChannelListItem>
+                    ItemFlow = new FillFlowContainer<ChannelListItem>
                     {
                         Direction = FillDirection.Vertical,
                         RelativeSizeAxes = Axes.X,

From cd84200ad9486ad9b4f1e62941244750a1dc593b Mon Sep 17 00:00:00 2001
From: sw1tchbl4d3 <sw1tchbl4d3@sw1tchbl4d3.com>
Date: Fri, 27 May 2022 21:23:37 +0200
Subject: [PATCH 5075/5547] Add HoldFocus and ReleaseFocusOnCommit attributes
 to searchbar

---
 osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs b/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs
index 0a1cf5524f..c8c53ec507 100644
--- a/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs
+++ b/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs
@@ -64,6 +64,8 @@ namespace osu.Game.Overlays.Dashboard
                         Anchor = Anchor.TopCentre,
                         Origin = Anchor.TopCentre,
                         Height = search_textbox_height,
+                        ReleaseFocusOnCommit = false,
+                        HoldFocus = true,
                         PlaceholderText = HomeStrings.SearchPlaceholder,
                     },
                 },

From 06832a4baf0cb8f6804aa31fcb4d540769be45e4 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sat, 28 May 2022 01:05:07 +0300
Subject: [PATCH 5076/5547] Fix beatmap badge colours not updated inline with
 recent changes

---
 osu.Game/Graphics/OsuColour.cs                             | 7 +++++--
 osu.Game/Overlays/BeatmapSet/FeaturedArtistBeatmapBadge.cs | 2 +-
 osu.Game/Overlays/BeatmapSet/SpotlightBeatmapBadge.cs      | 2 +-
 3 files changed, 7 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Graphics/OsuColour.cs b/osu.Game/Graphics/OsuColour.cs
index 7a6a677940..7fd94b57f3 100644
--- a/osu.Game/Graphics/OsuColour.cs
+++ b/osu.Game/Graphics/OsuColour.cs
@@ -197,10 +197,10 @@ namespace osu.Game.Graphics
             switch (roomCategory)
             {
                 case RoomCategory.Spotlight:
-                    return Green2;
+                    return SpotlightColour;
 
                 case RoomCategory.FeaturedArtist:
-                    return Blue2;
+                    return FeaturedArtistColour;
 
                 default:
                     return null;
@@ -379,5 +379,8 @@ namespace osu.Game.Graphics
         public readonly Color4 ChatBlue = Color4Extensions.FromHex(@"17292e");
 
         public readonly Color4 ContextMenuGray = Color4Extensions.FromHex(@"223034");
+
+        public Color4 SpotlightColour => Green2;
+        public Color4 FeaturedArtistColour => Blue2;
     }
 }
diff --git a/osu.Game/Overlays/BeatmapSet/FeaturedArtistBeatmapBadge.cs b/osu.Game/Overlays/BeatmapSet/FeaturedArtistBeatmapBadge.cs
index 4f336d85fc..20ee11c7f6 100644
--- a/osu.Game/Overlays/BeatmapSet/FeaturedArtistBeatmapBadge.cs
+++ b/osu.Game/Overlays/BeatmapSet/FeaturedArtistBeatmapBadge.cs
@@ -15,7 +15,7 @@ namespace osu.Game.Overlays.BeatmapSet
         private void load(OsuColour colours)
         {
             BadgeText = BeatmapsetsStrings.FeaturedArtistBadgeLabel;
-            BadgeColour = colours.Blue1;
+            BadgeColour = colours.FeaturedArtistColour;
             // todo: add linking support to allow redirecting featured artist badge to corresponding track.
         }
     }
diff --git a/osu.Game/Overlays/BeatmapSet/SpotlightBeatmapBadge.cs b/osu.Game/Overlays/BeatmapSet/SpotlightBeatmapBadge.cs
index 3204f79b21..9c5378a967 100644
--- a/osu.Game/Overlays/BeatmapSet/SpotlightBeatmapBadge.cs
+++ b/osu.Game/Overlays/BeatmapSet/SpotlightBeatmapBadge.cs
@@ -15,7 +15,7 @@ namespace osu.Game.Overlays.BeatmapSet
         private void load(OsuColour colours)
         {
             BadgeText = BeatmapsetsStrings.SpotlightBadgeLabel;
-            BadgeColour = colours.Pink1;
+            BadgeColour = colours.SpotlightColour;
             // todo: add linking support to allow redirecting spotlight badge to https://osu.ppy.sh/wiki/en/Beatmap_Spotlights.
         }
     }

From aee3e2a4ed0c66f5e5ec2257d2ac11e9cbbcb950 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sat, 28 May 2022 01:58:17 +0300
Subject: [PATCH 5077/5547] Add shadow effect to editor's bottom bar

---
 osu.Game/Screens/Edit/BottomBar.cs | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/osu.Game/Screens/Edit/BottomBar.cs b/osu.Game/Screens/Edit/BottomBar.cs
index 5994184c11..62caaced89 100644
--- a/osu.Game/Screens/Edit/BottomBar.cs
+++ b/osu.Game/Screens/Edit/BottomBar.cs
@@ -2,13 +2,16 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using osu.Framework.Allocation;
+using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.Effects;
 using osu.Framework.Graphics.Shapes;
 using osu.Game.Overlays;
 using osu.Game.Screens.Edit.Components;
 using osu.Game.Screens.Edit.Components.Timelines.Summary;
 using osuTK;
+using osuTK.Graphics;
 
 namespace osu.Game.Screens.Edit
 {
@@ -26,6 +29,14 @@ namespace osu.Game.Screens.Edit
 
             Height = 60;
 
+            Masking = true;
+            EdgeEffect = new EdgeEffectParameters
+            {
+                Colour = Color4.Black.Opacity(0.2f),
+                Type = EdgeEffectType.Shadow,
+                Radius = 10f,
+            };
+
             InternalChildren = new Drawable[]
             {
                 new Box

From eec9248cdee0257912d936086147344d66eb2983 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sat, 28 May 2022 02:10:18 +0300
Subject: [PATCH 5078/5547] Darken background colour in "setup" and "verify"
 screens

---
 osu.Game/Screens/Edit/Setup/SetupScreen.cs | 2 +-
 osu.Game/Screens/Edit/Verify/IssueList.cs  | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/Edit/Setup/SetupScreen.cs b/osu.Game/Screens/Edit/Setup/SetupScreen.cs
index b95aabc1c4..e0fc5f1aff 100644
--- a/osu.Game/Screens/Edit/Setup/SetupScreen.cs
+++ b/osu.Game/Screens/Edit/Setup/SetupScreen.cs
@@ -41,7 +41,7 @@ namespace osu.Game.Screens.Edit.Setup
 
             Add(new Box
             {
-                Colour = colourProvider.Background2,
+                Colour = colourProvider.Background3,
                 RelativeSizeAxes = Axes.Both,
             });
 
diff --git a/osu.Game/Screens/Edit/Verify/IssueList.cs b/osu.Game/Screens/Edit/Verify/IssueList.cs
index 415acc0e22..84b2609a61 100644
--- a/osu.Game/Screens/Edit/Verify/IssueList.cs
+++ b/osu.Game/Screens/Edit/Verify/IssueList.cs
@@ -51,7 +51,7 @@ namespace osu.Game.Screens.Edit.Verify
             {
                 new Box
                 {
-                    Colour = colours.Background2,
+                    Colour = colours.Background3,
                     RelativeSizeAxes = Axes.Both,
                 },
                 new OsuScrollContainer

From e71d90716401b8e2bff5fd8c34a34f0cbee513ec Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sat, 28 May 2022 02:20:04 +0300
Subject: [PATCH 5079/5547] Update row attribute background colour to fit
 screen

---
 osu.Game/Screens/Edit/Timing/RowAttribute.cs              | 8 +++++---
 .../Edit/Timing/RowAttributes/TimingRowAttribute.cs       | 5 ++++-
 2 files changed, 9 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Screens/Edit/Timing/RowAttribute.cs b/osu.Game/Screens/Edit/Timing/RowAttribute.cs
index 74d43628e1..46bb62c9e0 100644
--- a/osu.Game/Screens/Edit/Timing/RowAttribute.cs
+++ b/osu.Game/Screens/Edit/Timing/RowAttribute.cs
@@ -19,6 +19,8 @@ namespace osu.Game.Screens.Edit.Timing
 
         private readonly string label;
 
+        protected Drawable Background { get; private set; }
+
         protected FillFlowContainer Content { get; private set; }
 
         public RowAttribute(ControlPoint point, string label)
@@ -41,11 +43,11 @@ namespace osu.Game.Screens.Edit.Timing
             Masking = true;
             CornerRadius = 3;
 
-            InternalChildren = new Drawable[]
+            InternalChildren = new[]
             {
-                new Box
+                Background = new Box
                 {
-                    Colour = overlayColours.Background4,
+                    Colour = overlayColours.Background5,
                     RelativeSizeAxes = Axes.Both,
                 },
                 Content = new FillFlowContainer
diff --git a/osu.Game/Screens/Edit/Timing/RowAttributes/TimingRowAttribute.cs b/osu.Game/Screens/Edit/Timing/RowAttributes/TimingRowAttribute.cs
index f8ec4aef25..8a07088545 100644
--- a/osu.Game/Screens/Edit/Timing/RowAttributes/TimingRowAttribute.cs
+++ b/osu.Game/Screens/Edit/Timing/RowAttributes/TimingRowAttribute.cs
@@ -7,6 +7,7 @@ using osu.Framework.Extensions;
 using osu.Game.Beatmaps.ControlPoints;
 using osu.Game.Beatmaps.Timing;
 using osu.Game.Graphics.Sprites;
+using osu.Game.Overlays;
 
 namespace osu.Game.Screens.Edit.Timing.RowAttributes
 {
@@ -24,10 +25,12 @@ namespace osu.Game.Screens.Edit.Timing.RowAttributes
         }
 
         [BackgroundDependencyLoader]
-        private void load()
+        private void load(OverlayColourProvider colourProvider)
         {
             Content.Add(text = new AttributeText(Point));
 
+            Background.Colour = colourProvider.Background4;
+
             timeSignature.BindValueChanged(_ => updateText());
             beatLength.BindValueChanged(_ => updateText(), true);
         }

From d12e4928e62023e26aa90ce32bbf84f087886e7d Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sat, 28 May 2022 03:09:04 +0300
Subject: [PATCH 5080/5547] Increase editor verify settings width to give more
 breathing space

---
 osu.Game/Screens/Edit/Verify/VerifyScreen.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Edit/Verify/VerifyScreen.cs b/osu.Game/Screens/Edit/Verify/VerifyScreen.cs
index 9dc5a53907..036d7760b8 100644
--- a/osu.Game/Screens/Edit/Verify/VerifyScreen.cs
+++ b/osu.Game/Screens/Edit/Verify/VerifyScreen.cs
@@ -41,7 +41,7 @@ namespace osu.Game.Screens.Edit.Verify
                     ColumnDimensions = new[]
                     {
                         new Dimension(),
-                        new Dimension(GridSizeMode.Absolute, 200),
+                        new Dimension(GridSizeMode.Absolute, 225),
                     },
                     Content = new[]
                     {

From e12d188dad2c1bc47e77ae96222b36bb7d735a34 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sat, 28 May 2022 04:05:24 +0300
Subject: [PATCH 5081/5547] Fix metronome speed not adjusted on different
 playback rates

---
 osu.Game/Screens/Edit/Timing/MetronomeDisplay.cs | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/osu.Game/Screens/Edit/Timing/MetronomeDisplay.cs b/osu.Game/Screens/Edit/Timing/MetronomeDisplay.cs
index 4dd7a75d4a..57fcff6a4c 100644
--- a/osu.Game/Screens/Edit/Timing/MetronomeDisplay.cs
+++ b/osu.Game/Screens/Edit/Timing/MetronomeDisplay.cs
@@ -10,6 +10,7 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Colour;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
+using osu.Framework.Timing;
 using osu.Framework.Utils;
 using osu.Game.Beatmaps.ControlPoints;
 using osu.Game.Graphics.Containers;
@@ -28,6 +29,8 @@ namespace osu.Game.Screens.Edit.Timing
         private Drawable weight;
         private Drawable stick;
 
+        private IAdjustableClock metronomeClock;
+
         [Resolved]
         private OverlayColourProvider overlayColourProvider { get; set; }
 
@@ -192,6 +195,8 @@ namespace osu.Game.Screens.Edit.Timing
                     Y = -3,
                 },
             };
+
+            Clock = new FramedClock(metronomeClock = new StopwatchClock(true));
         }
 
         private double beatLength;
@@ -216,6 +221,8 @@ namespace osu.Game.Screens.Edit.Timing
             if (BeatSyncSource.ControlPoints == null || BeatSyncSource.Clock == null)
                 return;
 
+            metronomeClock.Rate = IsBeatSyncedWithTrack ? BeatSyncSource.Clock.Rate : 1;
+
             timingPoint = BeatSyncSource.ControlPoints.TimingPointAt(BeatSyncSource.Clock.CurrentTime);
 
             if (beatLength != timingPoint.BeatLength)

From 2fac710d4b728aff4b16a173408be1688c5e1739 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sat, 28 May 2022 04:05:33 +0300
Subject: [PATCH 5082/5547] Add step for adjusting editor clock rate in test
 scene

---
 osu.Game/Tests/Visual/EditorClockTestScene.cs | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/osu.Game/Tests/Visual/EditorClockTestScene.cs b/osu.Game/Tests/Visual/EditorClockTestScene.cs
index 2d3e1960d9..15e4fc4d8f 100644
--- a/osu.Game/Tests/Visual/EditorClockTestScene.cs
+++ b/osu.Game/Tests/Visual/EditorClockTestScene.cs
@@ -2,6 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using osu.Framework.Allocation;
+using osu.Framework.Audio;
 using osu.Framework.Bindables;
 using osu.Framework.Input.Events;
 using osu.Game.Beatmaps;
@@ -24,6 +25,8 @@ namespace osu.Game.Tests.Visual
         [Cached]
         protected new readonly EditorClock Clock;
 
+        private readonly Bindable<double> frequencyAdjustment = new BindableDouble(1);
+
         protected virtual bool ScrollUsingMouseWheel => true;
 
         protected EditorClockTestScene()
@@ -44,14 +47,21 @@ namespace osu.Game.Tests.Visual
         protected override void LoadComplete()
         {
             base.LoadComplete();
+
             Beatmap.BindValueChanged(beatmapChanged, true);
+
+            AddSliderStep("editor clock rate", 0.0, 2.0, 1.0, v => frequencyAdjustment.Value = v);
         }
 
         private void beatmapChanged(ValueChangedEvent<WorkingBeatmap> e)
         {
+            e.OldValue?.Track.RemoveAdjustment(AdjustableProperty.Frequency, frequencyAdjustment);
+
             Clock.Beatmap = e.NewValue.Beatmap;
             Clock.ChangeSource(e.NewValue.Track);
             Clock.ProcessFrame();
+
+            e.NewValue.Track.AddAdjustment(AdjustableProperty.Frequency, frequencyAdjustment);
         }
 
         protected override void Update()

From 93a8092da6504019b871ba4f219e8b9634715b28 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 28 May 2022 10:51:39 +0900
Subject: [PATCH 5083/5547] Increase usable width slightly further

---
 osu.Game/Screens/Edit/Verify/VerifyScreen.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Edit/Verify/VerifyScreen.cs b/osu.Game/Screens/Edit/Verify/VerifyScreen.cs
index 036d7760b8..56e16bb746 100644
--- a/osu.Game/Screens/Edit/Verify/VerifyScreen.cs
+++ b/osu.Game/Screens/Edit/Verify/VerifyScreen.cs
@@ -41,7 +41,7 @@ namespace osu.Game.Screens.Edit.Verify
                     ColumnDimensions = new[]
                     {
                         new Dimension(),
-                        new Dimension(GridSizeMode.Absolute, 225),
+                        new Dimension(GridSizeMode.Absolute, 250),
                     },
                     Content = new[]
                     {

From ede3ab9dc00692559786b6e5691e07d8af3c12ee Mon Sep 17 00:00:00 2001
From: sw1tchbl4d3 <sw1tchbl4d3@sw1tchbl4d3.com>
Date: Sat, 28 May 2022 12:04:25 +0200
Subject: [PATCH 5084/5547] Add OnFocus handler to CurrentlyPlayingDisplay

---
 osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs | 8 ++++++++
 osu.Game/Overlays/DashboardOverlay.cs                  | 2 ++
 2 files changed, 10 insertions(+)

diff --git a/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs b/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs
index c8c53ec507..23f67a06cb 100644
--- a/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs
+++ b/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs
@@ -11,6 +11,7 @@ using osu.Framework.Extensions;
 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.Framework.Screens;
 using osu.Game.Database;
@@ -98,6 +99,13 @@ namespace osu.Game.Overlays.Dashboard
             playingUsers.BindCollectionChanged(onPlayingUsersChanged, true);
         }
 
+        protected override void OnFocus(FocusEvent e)
+        {
+            base.OnFocus(e);
+
+            searchTextBox.TakeFocus();
+        }
+
         private void onPlayingUsersChanged(object sender, NotifyCollectionChangedEventArgs e) => Schedule(() =>
         {
             switch (e.Action)
diff --git a/osu.Game/Overlays/DashboardOverlay.cs b/osu.Game/Overlays/DashboardOverlay.cs
index 83ad8faf1c..79d972bdcc 100644
--- a/osu.Game/Overlays/DashboardOverlay.cs
+++ b/osu.Game/Overlays/DashboardOverlay.cs
@@ -16,6 +16,8 @@ namespace osu.Game.Overlays
 
         protected override DashboardOverlayHeader CreateHeader() => new DashboardOverlayHeader();
 
+        public override bool AcceptsFocus => false;
+
         protected override void CreateDisplayToLoad(DashboardOverlayTabs tab)
         {
             switch (tab)

From e18fec3d896d8e0325614a65b4dc5e2f50af5b92 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 28 May 2022 13:59:10 +0200
Subject: [PATCH 5085/5547] Fix unobserved exceptions due to unimplemented
 beatmap converter

`TestSceneStatisticsPanel` intends to check the operation of statistics
panels using dummy ruleset classes. However, `StatisticsPanel` relies on
being able to retrieve the playable beatmap, which requires a converter.
One was not provided by the dummy rulesets, therefore the retrieval
would fail with an unobserved exception.

To fix, add a barebones converter implementation that is enough for the
test to pass.
---
 .../Ranking/TestSceneStatisticsPanel.cs       | 25 ++++++++++++++++---
 1 file changed, 21 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Tests/Visual/Ranking/TestSceneStatisticsPanel.cs b/osu.Game.Tests/Visual/Ranking/TestSceneStatisticsPanel.cs
index 35281a85eb..1efe6d7380 100644
--- a/osu.Game.Tests/Visual/Ranking/TestSceneStatisticsPanel.cs
+++ b/osu.Game.Tests/Visual/Ranking/TestSceneStatisticsPanel.cs
@@ -3,6 +3,7 @@
 
 using System;
 using System.Collections.Generic;
+using System.Threading;
 using NUnit.Framework;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
@@ -13,6 +14,7 @@ using osu.Game.Graphics.Sprites;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Difficulty;
 using osu.Game.Rulesets.Mods;
+using osu.Game.Rulesets.Objects;
 using osu.Game.Scoring;
 using osu.Game.Screens.Ranking.Statistics;
 using osu.Game.Rulesets.Osu.Objects;
@@ -114,10 +116,7 @@ namespace osu.Game.Tests.Visual.Ranking
                 throw new NotImplementedException();
             }
 
-            public override IBeatmapConverter CreateBeatmapConverter(IBeatmap beatmap)
-            {
-                throw new NotImplementedException();
-            }
+            public override IBeatmapConverter CreateBeatmapConverter(IBeatmap beatmap) => new TestBeatmapConverter(beatmap);
 
             public override DifficultyCalculator CreateDifficultyCalculator(IWorkingBeatmap beatmap)
             {
@@ -151,6 +150,24 @@ namespace osu.Game.Tests.Visual.Ranking
                     }
                 }
             };
+
+            private class TestBeatmapConverter : IBeatmapConverter
+            {
+#pragma warning disable CS0067 // The event is never used
+                public event Action<HitObject, IEnumerable<HitObject>> ObjectConverted;
+#pragma warning restore CS0067
+
+                public IBeatmap Beatmap { get; }
+
+                public TestBeatmapConverter(IBeatmap beatmap)
+                {
+                    Beatmap = beatmap;
+                }
+
+                public bool CanConvert() => true;
+
+                public IBeatmap Convert(CancellationToken cancellationToken = default) => Beatmap.Clone();
+            }
         }
 
         private class TestRulesetAllStatsRequireHitEvents : TestRuleset

From 777d9af0f50082f24862d462aa891416ceef7235 Mon Sep 17 00:00:00 2001
From: apollo-dw <83023433+apollo-dw@users.noreply.github.com>
Date: Sat, 28 May 2022 13:28:04 +0100
Subject: [PATCH 5086/5547] Move object difficulty calculation to evaluator
 methods

---
 .../Difficulty/Evaluators/AimEvaluator.cs              | 10 ++++++++++
 .../Difficulty/Evaluators/FlashlightEvaluator.cs       | 10 ++++++++++
 .../Difficulty/Evaluators/RhythmEvaluator.cs           | 10 ++++++++++
 .../Difficulty/Evaluators/SpeedEvaluator.cs            | 10 ++++++++++
 4 files changed, 40 insertions(+)
 create mode 100644 osu.Game.Rulesets.Osu/Difficulty/Evaluators/AimEvaluator.cs
 create mode 100644 osu.Game.Rulesets.Osu/Difficulty/Evaluators/FlashlightEvaluator.cs
 create mode 100644 osu.Game.Rulesets.Osu/Difficulty/Evaluators/RhythmEvaluator.cs
 create mode 100644 osu.Game.Rulesets.Osu/Difficulty/Evaluators/SpeedEvaluator.cs

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Evaluators/AimEvaluator.cs b/osu.Game.Rulesets.Osu/Difficulty/Evaluators/AimEvaluator.cs
new file mode 100644
index 0000000000..a573dd492c
--- /dev/null
+++ b/osu.Game.Rulesets.Osu/Difficulty/Evaluators/AimEvaluator.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.Game.Rulesets.Osu.Difficulty.Evaluators
+{
+    public class AimEvaluator
+    {
+        
+    }
+}
diff --git a/osu.Game.Rulesets.Osu/Difficulty/Evaluators/FlashlightEvaluator.cs b/osu.Game.Rulesets.Osu/Difficulty/Evaluators/FlashlightEvaluator.cs
new file mode 100644
index 0000000000..83b6cc75dd
--- /dev/null
+++ b/osu.Game.Rulesets.Osu/Difficulty/Evaluators/FlashlightEvaluator.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.Game.Rulesets.Osu.Difficulty.Evaluators
+{
+    public class FlashlightEvaluator
+    {
+        
+    }
+}
diff --git a/osu.Game.Rulesets.Osu/Difficulty/Evaluators/RhythmEvaluator.cs b/osu.Game.Rulesets.Osu/Difficulty/Evaluators/RhythmEvaluator.cs
new file mode 100644
index 0000000000..0dd16f7313
--- /dev/null
+++ b/osu.Game.Rulesets.Osu/Difficulty/Evaluators/RhythmEvaluator.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.Game.Rulesets.Osu.Difficulty.Evaluators
+{
+    public class RhythmEvaluator
+    {
+        
+    }
+}
diff --git a/osu.Game.Rulesets.Osu/Difficulty/Evaluators/SpeedEvaluator.cs b/osu.Game.Rulesets.Osu/Difficulty/Evaluators/SpeedEvaluator.cs
new file mode 100644
index 0000000000..84a39d8f9b
--- /dev/null
+++ b/osu.Game.Rulesets.Osu/Difficulty/Evaluators/SpeedEvaluator.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.Game.Rulesets.Osu.Difficulty.Evaluators
+{
+    public class SpeedEvaluator
+    {
+        
+    }
+}

From b631cefc55c0f42f8528a9a92068ecb89c5c143a Mon Sep 17 00:00:00 2001
From: apollo-dw <83023433+apollo-dw@users.noreply.github.com>
Date: Sat, 28 May 2022 13:29:09 +0100
Subject: [PATCH 5087/5547] Move object difficulty calculation to evaluator
 methods

---
 .../Difficulty/Evaluators/AimEvaluator.cs     | 129 +++++++++++++++-
 .../Evaluators/FlashlightEvaluator.cs         |  63 +++++++-
 .../Difficulty/Evaluators/RhythmEvaluator.cs  | 102 ++++++++++++-
 .../Difficulty/Evaluators/SpeedEvaluator.cs   |  45 +++++-
 .../Difficulty/Skills/Aim.cs                  | 126 +---------------
 .../Difficulty/Skills/Flashlight.cs           |  64 +-------
 .../Difficulty/Skills/Speed.cs                | 139 +-----------------
 7 files changed, 338 insertions(+), 330 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Evaluators/AimEvaluator.cs b/osu.Game.Rulesets.Osu/Difficulty/Evaluators/AimEvaluator.cs
index a573dd492c..fb9ac0cafb 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Evaluators/AimEvaluator.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Evaluators/AimEvaluator.cs
@@ -1,10 +1,135 @@
 // 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.Game.Rulesets.Difficulty.Preprocessing;
+using osu.Game.Rulesets.Osu.Difficulty.Preprocessing;
+using osu.Game.Rulesets.Osu.Objects;
+
 namespace osu.Game.Rulesets.Osu.Difficulty.Evaluators
 {
-    public class AimEvaluator
+    public static class AimEvaluator
     {
-        
+        private const double wide_angle_multiplier = 1.5;
+        private const double acute_angle_multiplier = 2.0;
+        private const double slider_multiplier = 1.5;
+        private const double velocity_change_multiplier = 0.75;
+
+        /// <summary>
+        /// Evaluates the difficulty of aiming the current object.
+        /// </summary>
+        public static double EvaluateDifficultyOf(DifficultyHitObject current, bool withSliders)
+        {
+            if (current.BaseObject is Spinner || current.Position <= 1 || current.Previous(0).BaseObject is Spinner)
+                return 0;
+
+            var osuCurrObj = (OsuDifficultyHitObject)current;
+            var osuLastObj = (OsuDifficultyHitObject)current.Previous(0);
+            var osuLastLastObj = (OsuDifficultyHitObject)current.Previous(1);
+
+            // Calculate the velocity to the current hitobject, which starts with a base distance / time assuming the last object is a hitcircle.
+            double currVelocity = osuCurrObj.LazyJumpDistance / osuCurrObj.StrainTime;
+
+            // But if the last object is a slider, then we extend the travel velocity through the slider into the current object.
+            if (osuLastObj.BaseObject is Slider && withSliders)
+            {
+                double travelVelocity = osuLastObj.TravelDistance / osuLastObj.TravelTime; // calculate the slider velocity from slider head to slider end.
+                double movementVelocity = osuCurrObj.MinimumJumpDistance / osuCurrObj.MinimumJumpTime; // calculate the movement velocity from slider end to current object
+
+                currVelocity = Math.Max(currVelocity, movementVelocity + travelVelocity); // take the larger total combined velocity.
+            }
+
+            // As above, do the same for the previous hitobject.
+            double prevVelocity = osuLastObj.LazyJumpDistance / osuLastObj.StrainTime;
+
+            if (osuLastLastObj.BaseObject is Slider && withSliders)
+            {
+                double travelVelocity = osuLastLastObj.TravelDistance / osuLastLastObj.TravelTime;
+                double movementVelocity = osuLastObj.MinimumJumpDistance / osuLastObj.MinimumJumpTime;
+
+                prevVelocity = Math.Max(prevVelocity, movementVelocity + travelVelocity);
+            }
+
+            double wideAngleBonus = 0;
+            double acuteAngleBonus = 0;
+            double sliderBonus = 0;
+            double velocityChangeBonus = 0;
+
+            double aimStrain = currVelocity; // Start strain with regular velocity.
+
+            if (Math.Max(osuCurrObj.StrainTime, osuLastObj.StrainTime) < 1.25 * Math.Min(osuCurrObj.StrainTime, osuLastObj.StrainTime)) // If rhythms are the same.
+            {
+                if (osuCurrObj.Angle != null && osuLastObj.Angle != null && osuLastLastObj.Angle != null)
+                {
+                    double currAngle = osuCurrObj.Angle.Value;
+                    double lastAngle = osuLastObj.Angle.Value;
+                    double lastLastAngle = osuLastLastObj.Angle.Value;
+
+                    // Rewarding angles, take the smaller velocity as base.
+                    double angleBonus = Math.Min(currVelocity, prevVelocity);
+
+                    wideAngleBonus = calcWideAngleBonus(currAngle);
+                    acuteAngleBonus = calcAcuteAngleBonus(currAngle);
+
+                    if (osuCurrObj.StrainTime > 100) // Only buff deltaTime exceeding 300 bpm 1/2.
+                        acuteAngleBonus = 0;
+                    else
+                    {
+                        acuteAngleBonus *= calcAcuteAngleBonus(lastAngle) // Multiply by previous angle, we don't want to buff unless this is a wiggle type pattern.
+                                           * Math.Min(angleBonus, 125 / osuCurrObj.StrainTime) // The maximum velocity we buff is equal to 125 / strainTime
+                                           * Math.Pow(Math.Sin(Math.PI / 2 * Math.Min(1, (100 - osuCurrObj.StrainTime) / 25)), 2) // scale buff from 150 bpm 1/4 to 200 bpm 1/4
+                                           * Math.Pow(Math.Sin(Math.PI / 2 * (Math.Clamp(osuCurrObj.LazyJumpDistance, 50, 100) - 50) / 50), 2); // Buff distance exceeding 50 (radius) up to 100 (diameter).
+                    }
+
+                    // Penalize wide angles if they're repeated, reducing the penalty as the lastAngle gets more acute.
+                    wideAngleBonus *= angleBonus * (1 - Math.Min(wideAngleBonus, Math.Pow(calcWideAngleBonus(lastAngle), 3)));
+                    // Penalize acute angles if they're repeated, reducing the penalty as the lastLastAngle gets more obtuse.
+                    acuteAngleBonus *= 0.5 + 0.5 * (1 - Math.Min(acuteAngleBonus, Math.Pow(calcAcuteAngleBonus(lastLastAngle), 3)));
+                }
+            }
+
+            if (Math.Max(prevVelocity, currVelocity) != 0)
+            {
+                // We want to use the average velocity over the whole object when awarding differences, not the individual jump and slider path velocities.
+                prevVelocity = (osuLastObj.LazyJumpDistance + osuLastLastObj.TravelDistance) / osuLastObj.StrainTime;
+                currVelocity = (osuCurrObj.LazyJumpDistance + osuLastObj.TravelDistance) / osuCurrObj.StrainTime;
+
+                // Scale with ratio of difference compared to 0.5 * max dist.
+                double distRatio = Math.Pow(Math.Sin(Math.PI / 2 * Math.Abs(prevVelocity - currVelocity) / Math.Max(prevVelocity, currVelocity)), 2);
+
+                // Reward for % distance up to 125 / strainTime for overlaps where velocity is still changing.
+                double overlapVelocityBuff = Math.Min(125 / Math.Min(osuCurrObj.StrainTime, osuLastObj.StrainTime), Math.Abs(prevVelocity - currVelocity));
+
+                // Reward for % distance slowed down compared to previous, paying attention to not award overlap
+                double nonOverlapVelocityBuff = Math.Abs(prevVelocity - currVelocity)
+                                                // do not award overlap
+                                                * Math.Pow(Math.Sin(Math.PI / 2 * Math.Min(1, Math.Min(osuCurrObj.LazyJumpDistance, osuLastObj.LazyJumpDistance) / 100)), 2);
+
+                // Choose the largest bonus, multiplied by ratio.
+                velocityChangeBonus = Math.Max(overlapVelocityBuff, nonOverlapVelocityBuff) * distRatio;
+
+                // Penalize for rhythm changes.
+                velocityChangeBonus *= Math.Pow(Math.Min(osuCurrObj.StrainTime, osuLastObj.StrainTime) / Math.Max(osuCurrObj.StrainTime, osuLastObj.StrainTime), 2);
+            }
+
+            if (osuLastObj.TravelTime != 0)
+            {
+                // Reward sliders based on velocity.
+                sliderBonus = osuLastObj.TravelDistance / osuLastObj.TravelTime;
+            }
+
+            // Add in acute angle bonus or wide angle bonus + velocity change bonus, whichever is larger.
+            aimStrain += Math.Max(acuteAngleBonus * acute_angle_multiplier, wideAngleBonus * wide_angle_multiplier + velocityChangeBonus * velocity_change_multiplier);
+
+            // Add in additional slider velocity bonus.
+            if (withSliders)
+                aimStrain += sliderBonus * slider_multiplier;
+
+            return aimStrain;
+        }
+
+        private static double calcWideAngleBonus(double angle) => Math.Pow(Math.Sin(3.0 / 4 * (Math.Min(5.0 / 6 * Math.PI, Math.Max(Math.PI / 6, angle)) - Math.PI / 6)), 2);
+
+        private static double calcAcuteAngleBonus(double angle) => 1 - calcWideAngleBonus(angle);
     }
 }
diff --git a/osu.Game.Rulesets.Osu/Difficulty/Evaluators/FlashlightEvaluator.cs b/osu.Game.Rulesets.Osu/Difficulty/Evaluators/FlashlightEvaluator.cs
index 83b6cc75dd..d606527a1c 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Evaluators/FlashlightEvaluator.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Evaluators/FlashlightEvaluator.cs
@@ -1,10 +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;
+using osu.Game.Rulesets.Difficulty.Preprocessing;
+using osu.Game.Rulesets.Osu.Difficulty.Preprocessing;
+using osu.Game.Rulesets.Osu.Objects;
+
 namespace osu.Game.Rulesets.Osu.Difficulty.Evaluators
 {
-    public class FlashlightEvaluator
+    public static class FlashlightEvaluator
     {
-        
+        private const double max_opacity_bonus = 0.4;
+        private const double hidden_bonus = 0.2;
+
+        public static double EvaluateDifficultyOf(DifficultyHitObject current, bool hidden)
+        {
+            if (current.BaseObject is Spinner)
+                return 0;
+
+            var osuCurrent = (OsuDifficultyHitObject)current;
+            var osuHitObject = (OsuHitObject)(osuCurrent.BaseObject);
+
+            double scalingFactor = 52.0 / osuHitObject.Radius;
+            double smallDistNerf = 1.0;
+            double cumulativeStrainTime = 0.0;
+
+            double result = 0.0;
+
+            OsuDifficultyHitObject lastObj = osuCurrent;
+
+            // This is iterating backwards in time from the current object.
+            for (int i = 0; i < Math.Min(current.Position, 10); i++)
+            {
+                var currentObj = (OsuDifficultyHitObject)current.Previous(i);
+                var currentHitObject = (OsuHitObject)(currentObj.BaseObject);
+
+                if (!(currentObj.BaseObject is Spinner))
+                {
+                    double jumpDistance = (osuHitObject.StackedPosition - currentHitObject.EndPosition).Length;
+
+                    cumulativeStrainTime += lastObj.StrainTime;
+
+                    // We want to nerf objects that can be easily seen within the Flashlight circle radius.
+                    if (i == 0)
+                        smallDistNerf = Math.Min(1.0, jumpDistance / 75.0);
+
+                    // We also want to nerf stacks so that only the first object of the stack is accounted for.
+                    double stackNerf = Math.Min(1.0, (currentObj.LazyJumpDistance / scalingFactor) / 25.0);
+
+                    // Bonus based on how visible the object is.
+                    double opacityBonus = 1.0 + max_opacity_bonus * (1.0 - osuCurrent.OpacityAt(currentHitObject.StartTime, hidden));
+
+                    result += stackNerf * opacityBonus * scalingFactor * jumpDistance / cumulativeStrainTime;
+                }
+
+                lastObj = currentObj;
+            }
+
+            result = Math.Pow(smallDistNerf * result, 2.0);
+
+            // Additional bonus for Hidden due to there being no approach circles.
+            if (hidden)
+                result *= 1.0 + hidden_bonus;
+
+            return result;
+        }
     }
 }
diff --git a/osu.Game.Rulesets.Osu/Difficulty/Evaluators/RhythmEvaluator.cs b/osu.Game.Rulesets.Osu/Difficulty/Evaluators/RhythmEvaluator.cs
index 0dd16f7313..1da5dd52d9 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Evaluators/RhythmEvaluator.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Evaluators/RhythmEvaluator.cs
@@ -1,10 +1,108 @@
 // 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.Game.Rulesets.Difficulty.Preprocessing;
+using osu.Game.Rulesets.Osu.Difficulty.Preprocessing;
+using osu.Game.Rulesets.Osu.Objects;
+
 namespace osu.Game.Rulesets.Osu.Difficulty.Evaluators
 {
-    public class RhythmEvaluator
+    public static class RhythmEvaluator
     {
-        
+        private const int history_time_max = 5000; // 5 seconds of calculatingRhythmBonus max.
+        private const double rhythm_multiplier = 0.75;
+
+        /// <summary>
+        /// Calculates a rhythm multiplier for the difficulty of the tap associated with historic data of the current <see cref="OsuDifficultyHitObject"/>.
+        /// </summary>
+        public static double EvaluateDifficultyOf(DifficultyHitObject current, double greatWindow)
+        {
+            if (current.BaseObject is Spinner)
+                return 0;
+
+            int previousIslandSize = 0;
+
+            double rhythmComplexitySum = 0;
+            int islandSize = 1;
+            double startRatio = 0; // store the ratio of the current start of an island to buff for tighter rhythms
+
+            bool firstDeltaSwitch = false;
+
+            int historicalNoteCount = Math.Min(current.Position, 32);
+
+            int rhythmStart = 0;
+
+            while (rhythmStart < historicalNoteCount - 2 && current.StartTime - current.Previous(rhythmStart).StartTime < history_time_max)
+                rhythmStart++;
+
+            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
+
+                currHistoricalDecay = Math.Min((double)(historicalNoteCount - i) / historicalNoteCount, currHistoricalDecay); // either we're limited by time or limited by object count.
+
+                double currDelta = currObj.StrainTime;
+                double prevDelta = prevObj.StrainTime;
+                double lastDelta = lastObj.StrainTime;
+                double currRatio = 1.0 + 6.0 * Math.Min(0.5, Math.Pow(Math.Sin(Math.PI / (Math.Min(prevDelta, currDelta) / Math.Max(prevDelta, currDelta))), 2)); // fancy function to calculate rhythmbonuses.
+
+                double windowPenalty = Math.Min(1, Math.Max(0, Math.Abs(prevDelta - currDelta) - greatWindow * 0.6) / (greatWindow * 0.6));
+
+                windowPenalty = Math.Min(1, windowPenalty);
+
+                double effectiveRatio = windowPenalty * currRatio;
+
+                if (firstDeltaSwitch)
+                {
+                    if (!(prevDelta > 1.25 * currDelta || prevDelta * 1.25 < currDelta))
+                    {
+                        if (islandSize < 7)
+                            islandSize++; // island is still progressing, count size.
+                    }
+                    else
+                    {
+                        if (current.Previous(i - 1).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
+                            effectiveRatio *= 0.25;
+
+                        if (previousIslandSize == islandSize) // repeated island size (ex: triplet -> triplet)
+                            effectiveRatio *= 0.25;
+
+                        if (previousIslandSize % 2 == islandSize % 2) // repeated island polartiy (2 -> 4, 3 -> 5)
+                            effectiveRatio *= 0.50;
+
+                        if (lastDelta > prevDelta + 10 && prevDelta > currDelta + 10) // previous increase happened a note ago, 1/1->1/2-1/4, dont want to buff this.
+                            effectiveRatio *= 0.125;
+
+                        rhythmComplexitySum += Math.Sqrt(effectiveRatio * startRatio) * currHistoricalDecay * Math.Sqrt(4 + islandSize) / 2 * Math.Sqrt(4 + previousIslandSize) / 2;
+
+                        startRatio = effectiveRatio;
+
+                        previousIslandSize = islandSize; // log the last island size.
+
+                        if (prevDelta * 1.25 < currDelta) // we're slowing down, stop counting
+                            firstDeltaSwitch = false; // if we're speeding up, this stays true and  we keep counting island size.
+
+                        islandSize = 1;
+                    }
+                }
+                else if (prevDelta > 1.25 * currDelta) // we want to be speeding up.
+                {
+                    // Begin counting island until we change speed again.
+                    firstDeltaSwitch = true;
+                    startRatio = effectiveRatio;
+                    islandSize = 1;
+                }
+            }
+
+            return Math.Sqrt(4 + rhythmComplexitySum * rhythm_multiplier) / 2; //produces multiplier that can be applied to strain. range [1, infinity) (not really though)
+        }
     }
 }
diff --git a/osu.Game.Rulesets.Osu/Difficulty/Evaluators/SpeedEvaluator.cs b/osu.Game.Rulesets.Osu/Difficulty/Evaluators/SpeedEvaluator.cs
index 84a39d8f9b..bf0f3e2a69 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Evaluators/SpeedEvaluator.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Evaluators/SpeedEvaluator.cs
@@ -1,10 +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 System;
+using osu.Framework.Utils;
+using osu.Game.Rulesets.Difficulty.Preprocessing;
+using osu.Game.Rulesets.Osu.Difficulty.Preprocessing;
+using osu.Game.Rulesets.Osu.Objects;
+
 namespace osu.Game.Rulesets.Osu.Difficulty.Evaluators
 {
-    public class SpeedEvaluator
+    public static class SpeedEvaluator
     {
-        
+        private const double single_spacing_threshold = 125;
+        private const double min_speed_bonus = 75; // ~200BPM
+        private const double speed_balancing_factor = 40;
+
+        public static double EvaluateDifficultyOf(DifficultyHitObject current, double greatWindow)
+        {
+            if (current.BaseObject is Spinner)
+                return 0;
+
+            // derive strainTime for calculation
+            var osuCurrObj = (OsuDifficultyHitObject)current;
+            var osuPrevObj = current.Position > 0 ? (OsuDifficultyHitObject)current.Previous(0) : null;
+
+            double strainTime = osuCurrObj.StrainTime;
+            double greatWindowFull = greatWindow * 2;
+            double speedWindowRatio = strainTime / greatWindowFull;
+
+            // Aim to nerf cheesy rhythms (Very fast consecutive doubles with large deltatimes between)
+            if (osuPrevObj != null && strainTime < greatWindowFull && osuPrevObj.StrainTime > strainTime)
+                strainTime = Interpolation.Lerp(osuPrevObj.StrainTime, strainTime, speedWindowRatio);
+
+            // Cap deltatime to the OD 300 hitwindow.
+            // 0.93 is derived from making sure 260bpm OD8 streams aren't nerfed harshly, whilst 0.92 limits the effect of the cap.
+            strainTime /= Math.Clamp((strainTime / greatWindowFull) / 0.93, 0.92, 1);
+
+            // derive speedBonus for calculation
+            double speedBonus = 1.0;
+
+            if (strainTime < min_speed_bonus)
+                speedBonus = 1 + 0.75 * Math.Pow((min_speed_bonus - strainTime) / speed_balancing_factor, 2);
+
+            double travelDistance = osuPrevObj?.TravelDistance ?? 0;
+            double distance = Math.Min(single_spacing_threshold, travelDistance + osuCurrObj.MinimumJumpDistance);
+
+            return (speedBonus + speedBonus * Math.Pow(distance / single_spacing_threshold, 3.5)) / strainTime;
+        }
     }
 }
diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
index e3ec997740..df6a5e3d00 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
@@ -4,8 +4,7 @@
 using System;
 using osu.Game.Rulesets.Difficulty.Preprocessing;
 using osu.Game.Rulesets.Mods;
-using osu.Game.Rulesets.Osu.Difficulty.Preprocessing;
-using osu.Game.Rulesets.Osu.Objects;
+using osu.Game.Rulesets.Osu.Difficulty.Evaluators;
 
 namespace osu.Game.Rulesets.Osu.Difficulty.Skills
 {
@@ -22,132 +21,11 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
 
         private readonly bool withSliders;
 
-        private const double wide_angle_multiplier = 1.5;
-        private const double acute_angle_multiplier = 2.0;
-        private const double slider_multiplier = 1.5;
-        private const double velocity_change_multiplier = 0.75;
-
         private double currentStrain;
 
         private double skillMultiplier => 23.25;
         private double strainDecayBase => 0.15;
 
-        private double strainValueOf(DifficultyHitObject current)
-        {
-            if (current.BaseObject is Spinner || current.Position <= 1 || current.Previous(0).BaseObject is Spinner)
-                return 0;
-
-            var osuCurrObj = (OsuDifficultyHitObject)current;
-            var osuLastObj = (OsuDifficultyHitObject)current.Previous(0);
-            var osuLastLastObj = (OsuDifficultyHitObject)current.Previous(1);
-
-            // Calculate the velocity to the current hitobject, which starts with a base distance / time assuming the last object is a hitcircle.
-            double currVelocity = osuCurrObj.LazyJumpDistance / osuCurrObj.StrainTime;
-
-            // But if the last object is a slider, then we extend the travel velocity through the slider into the current object.
-            if (osuLastObj.BaseObject is Slider && withSliders)
-            {
-                double travelVelocity = osuLastObj.TravelDistance / osuLastObj.TravelTime; // calculate the slider velocity from slider head to slider end.
-                double movementVelocity = osuCurrObj.MinimumJumpDistance / osuCurrObj.MinimumJumpTime; // calculate the movement velocity from slider end to current object
-
-                currVelocity = Math.Max(currVelocity, movementVelocity + travelVelocity); // take the larger total combined velocity.
-            }
-
-            // As above, do the same for the previous hitobject.
-            double prevVelocity = osuLastObj.LazyJumpDistance / osuLastObj.StrainTime;
-
-            if (osuLastLastObj.BaseObject is Slider && withSliders)
-            {
-                double travelVelocity = osuLastLastObj.TravelDistance / osuLastLastObj.TravelTime;
-                double movementVelocity = osuLastObj.MinimumJumpDistance / osuLastObj.MinimumJumpTime;
-
-                prevVelocity = Math.Max(prevVelocity, movementVelocity + travelVelocity);
-            }
-
-            double wideAngleBonus = 0;
-            double acuteAngleBonus = 0;
-            double sliderBonus = 0;
-            double velocityChangeBonus = 0;
-
-            double aimStrain = currVelocity; // Start strain with regular velocity.
-
-            if (Math.Max(osuCurrObj.StrainTime, osuLastObj.StrainTime) < 1.25 * Math.Min(osuCurrObj.StrainTime, osuLastObj.StrainTime)) // If rhythms are the same.
-            {
-                if (osuCurrObj.Angle != null && osuLastObj.Angle != null && osuLastLastObj.Angle != null)
-                {
-                    double currAngle = osuCurrObj.Angle.Value;
-                    double lastAngle = osuLastObj.Angle.Value;
-                    double lastLastAngle = osuLastLastObj.Angle.Value;
-
-                    // Rewarding angles, take the smaller velocity as base.
-                    double angleBonus = Math.Min(currVelocity, prevVelocity);
-
-                    wideAngleBonus = calcWideAngleBonus(currAngle);
-                    acuteAngleBonus = calcAcuteAngleBonus(currAngle);
-
-                    if (osuCurrObj.StrainTime > 100) // Only buff deltaTime exceeding 300 bpm 1/2.
-                        acuteAngleBonus = 0;
-                    else
-                    {
-                        acuteAngleBonus *= calcAcuteAngleBonus(lastAngle) // Multiply by previous angle, we don't want to buff unless this is a wiggle type pattern.
-                                           * Math.Min(angleBonus, 125 / osuCurrObj.StrainTime) // The maximum velocity we buff is equal to 125 / strainTime
-                                           * Math.Pow(Math.Sin(Math.PI / 2 * Math.Min(1, (100 - osuCurrObj.StrainTime) / 25)), 2) // scale buff from 150 bpm 1/4 to 200 bpm 1/4
-                                           * Math.Pow(Math.Sin(Math.PI / 2 * (Math.Clamp(osuCurrObj.LazyJumpDistance, 50, 100) - 50) / 50), 2); // Buff distance exceeding 50 (radius) up to 100 (diameter).
-                    }
-
-                    // Penalize wide angles if they're repeated, reducing the penalty as the lastAngle gets more acute.
-                    wideAngleBonus *= angleBonus * (1 - Math.Min(wideAngleBonus, Math.Pow(calcWideAngleBonus(lastAngle), 3)));
-                    // Penalize acute angles if they're repeated, reducing the penalty as the lastLastAngle gets more obtuse.
-                    acuteAngleBonus *= 0.5 + 0.5 * (1 - Math.Min(acuteAngleBonus, Math.Pow(calcAcuteAngleBonus(lastLastAngle), 3)));
-                }
-            }
-
-            if (Math.Max(prevVelocity, currVelocity) != 0)
-            {
-                // We want to use the average velocity over the whole object when awarding differences, not the individual jump and slider path velocities.
-                prevVelocity = (osuLastObj.LazyJumpDistance + osuLastLastObj.TravelDistance) / osuLastObj.StrainTime;
-                currVelocity = (osuCurrObj.LazyJumpDistance + osuLastObj.TravelDistance) / osuCurrObj.StrainTime;
-
-                // Scale with ratio of difference compared to 0.5 * max dist.
-                double distRatio = Math.Pow(Math.Sin(Math.PI / 2 * Math.Abs(prevVelocity - currVelocity) / Math.Max(prevVelocity, currVelocity)), 2);
-
-                // Reward for % distance up to 125 / strainTime for overlaps where velocity is still changing.
-                double overlapVelocityBuff = Math.Min(125 / Math.Min(osuCurrObj.StrainTime, osuLastObj.StrainTime), Math.Abs(prevVelocity - currVelocity));
-
-                // Reward for % distance slowed down compared to previous, paying attention to not award overlap
-                double nonOverlapVelocityBuff = Math.Abs(prevVelocity - currVelocity)
-                                                // do not award overlap
-                                                * Math.Pow(Math.Sin(Math.PI / 2 * Math.Min(1, Math.Min(osuCurrObj.LazyJumpDistance, osuLastObj.LazyJumpDistance) / 100)), 2);
-
-                // Choose the largest bonus, multiplied by ratio.
-                velocityChangeBonus = Math.Max(overlapVelocityBuff, nonOverlapVelocityBuff) * distRatio;
-
-                // Penalize for rhythm changes.
-                velocityChangeBonus *= Math.Pow(Math.Min(osuCurrObj.StrainTime, osuLastObj.StrainTime) / Math.Max(osuCurrObj.StrainTime, osuLastObj.StrainTime), 2);
-            }
-
-            if (osuLastObj.TravelTime != 0)
-            {
-                // Reward sliders based on velocity.
-                sliderBonus = osuLastObj.TravelDistance / osuLastObj.TravelTime;
-            }
-
-            // Add in acute angle bonus or wide angle bonus + velocity change bonus, whichever is larger.
-            aimStrain += Math.Max(acuteAngleBonus * acute_angle_multiplier, wideAngleBonus * wide_angle_multiplier + velocityChangeBonus * velocity_change_multiplier);
-
-            // Add in additional slider velocity bonus.
-            if (withSliders)
-                aimStrain += sliderBonus * slider_multiplier;
-
-            return aimStrain;
-        }
-
-        private double calcWideAngleBonus(double angle) => Math.Pow(Math.Sin(3.0 / 4 * (Math.Min(5.0 / 6 * Math.PI, Math.Max(Math.PI / 6, angle)) - Math.PI / 6)), 2);
-
-        private double calcAcuteAngleBonus(double angle) => 1 - calcWideAngleBonus(angle);
-
-        private double applyDiminishingExp(double val) => Math.Pow(val, 0.99);
-
         private double strainDecay(double ms) => Math.Pow(strainDecayBase, ms / 1000);
 
         protected override double CalculateInitialStrain(double time, DifficultyHitObject current) => currentStrain * strainDecay(time - current.Previous(0).StartTime);
@@ -155,7 +33,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
         protected override double StrainValueAt(DifficultyHitObject current)
         {
             currentStrain *= strainDecay(current.DeltaTime);
-            currentStrain += strainValueOf(current) * skillMultiplier;
+            currentStrain += AimEvaluator.EvaluateDifficultyOf(current, withSliders) * skillMultiplier;
 
             return currentStrain;
         }
diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
index 75796a5993..bd8e962122 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
@@ -5,9 +5,8 @@ using System;
 using System.Linq;
 using osu.Game.Rulesets.Difficulty.Preprocessing;
 using osu.Game.Rulesets.Mods;
+using osu.Game.Rulesets.Osu.Difficulty.Evaluators;
 using osu.Game.Rulesets.Osu.Mods;
-using osu.Game.Rulesets.Osu.Difficulty.Preprocessing;
-using osu.Game.Rulesets.Osu.Objects;
 
 namespace osu.Game.Rulesets.Osu.Difficulty.Skills
 {
@@ -19,73 +18,14 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
         public Flashlight(Mod[] mods)
             : base(mods)
         {
-            hidden = mods.Any(m => m is OsuModHidden);
         }
 
         private double skillMultiplier => 0.05;
         private double strainDecayBase => 0.15;
         protected override double DecayWeight => 1.0;
 
-        private readonly bool hidden;
-
-        private const double max_opacity_bonus = 0.4;
-        private const double hidden_bonus = 0.2;
-
         private double currentStrain;
 
-        private double strainValueOf(DifficultyHitObject current)
-        {
-            if (current.BaseObject is Spinner)
-                return 0;
-
-            var osuCurrent = (OsuDifficultyHitObject)current;
-            var osuHitObject = (OsuHitObject)(osuCurrent.BaseObject);
-
-            double scalingFactor = 52.0 / osuHitObject.Radius;
-            double smallDistNerf = 1.0;
-            double cumulativeStrainTime = 0.0;
-
-            double result = 0.0;
-
-            OsuDifficultyHitObject lastObj = osuCurrent;
-
-            // This is iterating backwards in time from the current object.
-            for (int i = 0; i < Math.Min(current.Position, 10); i++)
-            {
-                var currentObj = (OsuDifficultyHitObject)current.Previous(i);
-                var currentHitObject = (OsuHitObject)(currentObj.BaseObject);
-
-                if (!(currentObj.BaseObject is Spinner))
-                {
-                    double jumpDistance = (osuHitObject.StackedPosition - currentHitObject.EndPosition).Length;
-
-                    cumulativeStrainTime += lastObj.StrainTime;
-
-                    // We want to nerf objects that can be easily seen within the Flashlight circle radius.
-                    if (i == 0)
-                        smallDistNerf = Math.Min(1.0, jumpDistance / 75.0);
-
-                    // We also want to nerf stacks so that only the first object of the stack is accounted for.
-                    double stackNerf = Math.Min(1.0, (currentObj.LazyJumpDistance / scalingFactor) / 25.0);
-
-                    // Bonus based on how visible the object is.
-                    double opacityBonus = 1.0 + max_opacity_bonus * (1.0 - osuCurrent.OpacityAt(currentHitObject.StartTime, hidden));
-
-                    result += stackNerf * opacityBonus * scalingFactor * jumpDistance / cumulativeStrainTime;
-                }
-
-                lastObj = currentObj;
-            }
-
-            result = Math.Pow(smallDistNerf * result, 2.0);
-
-            // Additional bonus for Hidden due to there being no approach circles.
-            if (hidden)
-                result *= 1.0 + hidden_bonus;
-
-            return result;
-        }
-
         private double strainDecay(double ms) => Math.Pow(strainDecayBase, ms / 1000);
 
         protected override double CalculateInitialStrain(double time, DifficultyHitObject current) => currentStrain * strainDecay(time - current.Previous(0).StartTime);
@@ -93,7 +33,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
         protected override double StrainValueAt(DifficultyHitObject current)
         {
             currentStrain *= strainDecay(current.DeltaTime);
-            currentStrain += strainValueOf(current) * skillMultiplier;
+            currentStrain += currentStrain += FlashlightEvaluator.EvaluateDifficultyOf(current, Mods.Any(m => m is OsuModHidden)) * skillMultiplier;
 
             return currentStrain;
         }
diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Speed.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Speed.cs
index f8905664f4..055e1cb66e 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Speed.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Speed.cs
@@ -4,9 +4,7 @@
 using System;
 using osu.Game.Rulesets.Difficulty.Preprocessing;
 using osu.Game.Rulesets.Mods;
-using osu.Game.Rulesets.Osu.Difficulty.Preprocessing;
-using osu.Game.Rulesets.Osu.Objects;
-using osu.Framework.Utils;
+using osu.Game.Rulesets.Osu.Difficulty.Evaluators;
 
 namespace osu.Game.Rulesets.Osu.Difficulty.Skills
 {
@@ -15,12 +13,6 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
     /// </summary>
     public class Speed : OsuStrainSkill
     {
-        private const double single_spacing_threshold = 125;
-        private const double rhythm_multiplier = 0.75;
-        private const int history_time_max = 5000; // 5 seconds of calculatingRhythmBonus max.
-        private const double min_speed_bonus = 75; // ~200BPM
-        private const double speed_balancing_factor = 40;
-
         private double skillMultiplier => 1375;
         private double strainDecayBase => 0.3;
 
@@ -37,131 +29,6 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
             greatWindow = hitWindowGreat;
         }
 
-        /// <summary>
-        /// Calculates a rhythm multiplier for the difficulty of the tap associated with historic data of the current <see cref="OsuDifficultyHitObject"/>.
-        /// </summary>
-        private double calculateRhythmBonus(DifficultyHitObject current)
-        {
-            if (current.BaseObject is Spinner)
-                return 0;
-
-            int previousIslandSize = 0;
-
-            double rhythmComplexitySum = 0;
-            int islandSize = 1;
-            double startRatio = 0; // store the ratio of the current start of an island to buff for tighter rhythms
-
-            bool firstDeltaSwitch = false;
-
-            int historicalNoteCount = Math.Min(current.Position, 32);
-
-            int rhythmStart = 0;
-
-            while (rhythmStart < historicalNoteCount - 2 && current.StartTime - current.Previous(rhythmStart).StartTime < history_time_max)
-                rhythmStart++;
-
-            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
-
-                currHistoricalDecay = Math.Min((double)(historicalNoteCount - i) / historicalNoteCount, currHistoricalDecay); // either we're limited by time or limited by object count.
-
-                double currDelta = currObj.StrainTime;
-                double prevDelta = prevObj.StrainTime;
-                double lastDelta = lastObj.StrainTime;
-                double currRatio = 1.0 + 6.0 * Math.Min(0.5, Math.Pow(Math.Sin(Math.PI / (Math.Min(prevDelta, currDelta) / Math.Max(prevDelta, currDelta))), 2)); // fancy function to calculate rhythmbonuses.
-
-                double windowPenalty = Math.Min(1, Math.Max(0, Math.Abs(prevDelta - currDelta) - greatWindow * 0.6) / (greatWindow * 0.6));
-
-                windowPenalty = Math.Min(1, windowPenalty);
-
-                double effectiveRatio = windowPenalty * currRatio;
-
-                if (firstDeltaSwitch)
-                {
-                    if (!(prevDelta > 1.25 * currDelta || prevDelta * 1.25 < currDelta))
-                    {
-                        if (islandSize < 7)
-                            islandSize++; // island is still progressing, count size.
-                    }
-                    else
-                    {
-                        if (current.Previous(i - 1).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
-                            effectiveRatio *= 0.25;
-
-                        if (previousIslandSize == islandSize) // repeated island size (ex: triplet -> triplet)
-                            effectiveRatio *= 0.25;
-
-                        if (previousIslandSize % 2 == islandSize % 2) // repeated island polartiy (2 -> 4, 3 -> 5)
-                            effectiveRatio *= 0.50;
-
-                        if (lastDelta > prevDelta + 10 && prevDelta > currDelta + 10) // previous increase happened a note ago, 1/1->1/2-1/4, dont want to buff this.
-                            effectiveRatio *= 0.125;
-
-                        rhythmComplexitySum += Math.Sqrt(effectiveRatio * startRatio) * currHistoricalDecay * Math.Sqrt(4 + islandSize) / 2 * Math.Sqrt(4 + previousIslandSize) / 2;
-
-                        startRatio = effectiveRatio;
-
-                        previousIslandSize = islandSize; // log the last island size.
-
-                        if (prevDelta * 1.25 < currDelta) // we're slowing down, stop counting
-                            firstDeltaSwitch = false; // if we're speeding up, this stays true and  we keep counting island size.
-
-                        islandSize = 1;
-                    }
-                }
-                else if (prevDelta > 1.25 * currDelta) // we want to be speeding up.
-                {
-                    // Begin counting island until we change speed again.
-                    firstDeltaSwitch = true;
-                    startRatio = effectiveRatio;
-                    islandSize = 1;
-                }
-            }
-
-            return Math.Sqrt(4 + rhythmComplexitySum * rhythm_multiplier) / 2; //produces multiplier that can be applied to strain. range [1, infinity) (not really though)
-        }
-
-        private double strainValueOf(DifficultyHitObject current)
-        {
-            if (current.BaseObject is Spinner)
-                return 0;
-
-            // derive strainTime for calculation
-            var osuCurrObj = (OsuDifficultyHitObject)current;
-            var osuPrevObj = current.Position > 0 ? (OsuDifficultyHitObject)current.Previous(0) : null;
-
-            double strainTime = osuCurrObj.StrainTime;
-            double greatWindowFull = greatWindow * 2;
-            double speedWindowRatio = strainTime / greatWindowFull;
-
-            // Aim to nerf cheesy rhythms (Very fast consecutive doubles with large deltatimes between)
-            if (osuPrevObj != null && strainTime < greatWindowFull && osuPrevObj.StrainTime > strainTime)
-                strainTime = Interpolation.Lerp(osuPrevObj.StrainTime, strainTime, speedWindowRatio);
-
-            // Cap deltatime to the OD 300 hitwindow.
-            // 0.93 is derived from making sure 260bpm OD8 streams aren't nerfed harshly, whilst 0.92 limits the effect of the cap.
-            strainTime /= Math.Clamp((strainTime / greatWindowFull) / 0.93, 0.92, 1);
-
-            // derive speedBonus for calculation
-            double speedBonus = 1.0;
-
-            if (strainTime < min_speed_bonus)
-                speedBonus = 1 + 0.75 * Math.Pow((min_speed_bonus - strainTime) / speed_balancing_factor, 2);
-
-            double travelDistance = osuPrevObj?.TravelDistance ?? 0;
-            double distance = Math.Min(single_spacing_threshold, travelDistance + osuCurrObj.MinimumJumpDistance);
-
-            return (speedBonus + speedBonus * Math.Pow(distance / single_spacing_threshold, 3.5)) / strainTime;
-        }
-
         private double strainDecay(double ms) => Math.Pow(strainDecayBase, ms / 1000);
 
         protected override double CalculateInitialStrain(double time, DifficultyHitObject current) => (currentStrain * currentRhythm) * strainDecay(time - current.Previous(0).StartTime);
@@ -169,9 +36,9 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
         protected override double StrainValueAt(DifficultyHitObject current)
         {
             currentStrain *= strainDecay(current.DeltaTime);
-            currentStrain += strainValueOf(current) * skillMultiplier;
+            currentStrain += SpeedEvaluator.EvaluateDifficultyOf(current, greatWindow) * skillMultiplier;
 
-            currentRhythm = calculateRhythmBonus(current);
+            currentRhythm = RhythmEvaluator.EvaluateDifficultyOf(current, greatWindow);
 
             return currentStrain * currentRhythm;
         }

From 774ac13900677cdfe4c7de61e69dfa4ebde63ff3 Mon Sep 17 00:00:00 2001
From: apollo-dw <83023433+apollo-dw@users.noreply.github.com>
Date: Sat, 28 May 2022 14:09:08 +0100
Subject: [PATCH 5088/5547] Add xmldocs

---
 .../Difficulty/Evaluators/AimEvaluator.cs                 | 8 +++++++-
 .../Difficulty/Evaluators/FlashlightEvaluator.cs          | 8 ++++++++
 .../Difficulty/Evaluators/SpeedEvaluator.cs               | 8 ++++++++
 3 files changed, 23 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Evaluators/AimEvaluator.cs b/osu.Game.Rulesets.Osu/Difficulty/Evaluators/AimEvaluator.cs
index fb9ac0cafb..f16e62d2a7 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Evaluators/AimEvaluator.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Evaluators/AimEvaluator.cs
@@ -16,7 +16,13 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Evaluators
         private const double velocity_change_multiplier = 0.75;
 
         /// <summary>
-        /// Evaluates the difficulty of aiming the current object.
+        /// Evaluates the difficulty of aiming the current object, based on:
+        /// <list type="bullet">
+        /// <item><description>cursor velocity to the current object,</description></item>
+        /// <item><description>angle difficulty,</description></item>
+        /// <item><description>sharp velocity increases,</description></item>
+        /// <item><description>and slider difficulty.</description></item>
+        /// </list>
         /// </summary>
         public static double EvaluateDifficultyOf(DifficultyHitObject current, bool withSliders)
         {
diff --git a/osu.Game.Rulesets.Osu/Difficulty/Evaluators/FlashlightEvaluator.cs b/osu.Game.Rulesets.Osu/Difficulty/Evaluators/FlashlightEvaluator.cs
index d606527a1c..b13b641c6b 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Evaluators/FlashlightEvaluator.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Evaluators/FlashlightEvaluator.cs
@@ -13,6 +13,14 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Evaluators
         private const double max_opacity_bonus = 0.4;
         private const double hidden_bonus = 0.2;
 
+        /// <summary>
+        /// Evaluates the difficulty of memorising and hitting an object, based on:
+        /// <list type="bullet">
+        /// <item><description>distance between the previous and current object,</description></item>
+        /// <item><description>the visual opacity of the current object,</description></item>
+        /// <item><description>and whether the hidden mod is enabled.</description></item>
+        /// </list>
+        /// </summary>
         public static double EvaluateDifficultyOf(DifficultyHitObject current, bool hidden)
         {
             if (current.BaseObject is Spinner)
diff --git a/osu.Game.Rulesets.Osu/Difficulty/Evaluators/SpeedEvaluator.cs b/osu.Game.Rulesets.Osu/Difficulty/Evaluators/SpeedEvaluator.cs
index bf0f3e2a69..17d4246c72 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Evaluators/SpeedEvaluator.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Evaluators/SpeedEvaluator.cs
@@ -15,6 +15,14 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Evaluators
         private const double min_speed_bonus = 75; // ~200BPM
         private const double speed_balancing_factor = 40;
 
+        /// <summary>
+        /// Evaluates the difficulty of tapping the current object, based on:
+        /// <list type="bullet">
+        /// <item><description>time between pressing the previous and current object,</description></item>
+        /// <item><description>distance between those objects,</description></item>
+        /// <item><description>and how easily they can be cheesed.</description></item>
+        /// </list>
+        /// </summary>
         public static double EvaluateDifficultyOf(DifficultyHitObject current, double greatWindow)
         {
             if (current.BaseObject is Spinner)

From 1641918c515a49530f6c5ce921b40c52b2418463 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 28 May 2022 14:25:59 +0200
Subject: [PATCH 5089/5547] Revert "Avoid throwing unobserved exception when
 `PerformancePointsCounter` requests timed attributes"

This reverts commit 19b655d75bd589f25fa76057fe3e66ec5d98eb96.
---
 osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs b/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs
index 019a9f9730..bdc98e53f9 100644
--- a/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs
+++ b/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs
@@ -6,6 +6,7 @@ using System.Collections.Generic;
 using System.IO;
 using System.Linq;
 using System.Threading;
+using System.Threading.Tasks;
 using JetBrains.Annotations;
 using osu.Framework.Allocation;
 using osu.Framework.Audio.Track;
@@ -80,16 +81,13 @@ namespace osu.Game.Screens.Play.HUD
                 difficultyCache.GetTimedDifficultyAttributesAsync(gameplayWorkingBeatmap, gameplayState.Ruleset, clonedMods, loadCancellationSource.Token)
                                .ContinueWith(task => Schedule(() =>
                                {
-                                   if (task.Exception != null)
-                                       return;
-
                                    timedAttributes = task.GetResultSafely();
 
                                    IsValid = true;
 
                                    if (lastJudgement != null)
                                        onJudgementChanged(lastJudgement);
-                               }));
+                               }), TaskContinuationOptions.OnlyOnRanToCompletion);
             }
         }
 

From dcf3d7695484a7bc92b1892a5cf66af5ea0ba208 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 28 May 2022 13:33:09 +0200
Subject: [PATCH 5090/5547] Fix unobserved exceptions due to using unconverted
 beatmap

`TestSceneBeatmapSkinFallbacks` was locally caching a `GameplayState`
instance to fulfill dependencies of a
`SkinnableTargetComponentsContainer`. However, it was doing so using
`new TestBeatmap()`, which is a raw decoded beatmap that hasn't been
converted to any ruleset yet, which was causing failures in
`BeatmapDifficultyCache.GetTimedDifficultyAttributesAsync()` as that
method is expecting to receive a post-conversion, ready-for-gameplay
beatmap.

Resolve by proxying forward dependency instances from the
already-known-to-be-working `actualComponentsContainer`.
---
 .../Gameplay/TestSceneBeatmapSkinFallbacks.cs | 24 +++++++------------
 1 file changed, 9 insertions(+), 15 deletions(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneBeatmapSkinFallbacks.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneBeatmapSkinFallbacks.cs
index 53364b6d89..e9aa85f4ce 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneBeatmapSkinFallbacks.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneBeatmapSkinFallbacks.cs
@@ -6,7 +6,6 @@ using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
-using osu.Framework.Graphics.Containers;
 using osu.Framework.Lists;
 using osu.Framework.Testing;
 using osu.Framework.Timing;
@@ -22,7 +21,6 @@ using osu.Game.Screens.Play;
 using osu.Game.Screens.Play.HUD;
 using osu.Game.Skinning;
 using osu.Game.Storyboards;
-using osu.Game.Tests.Beatmaps;
 
 namespace osu.Game.Tests.Visual.Gameplay
 {
@@ -33,18 +31,6 @@ namespace osu.Game.Tests.Visual.Gameplay
         [Resolved]
         private SkinManager skinManager { get; set; }
 
-        [Cached]
-        private ScoreProcessor scoreProcessor = new ScoreProcessor(new OsuRuleset());
-
-        [Cached(typeof(HealthProcessor))]
-        private HealthProcessor healthProcessor = new DrainingHealthProcessor(0);
-
-        [Cached]
-        private GameplayState gameplayState = new GameplayState(new TestBeatmap(new OsuRuleset().RulesetInfo), new OsuRuleset());
-
-        [Cached]
-        private readonly GameplayClock gameplayClock = new GameplayClock(new FramedClock());
-
         protected override bool HasCustomSteps => true;
 
         [Test]
@@ -81,11 +67,19 @@ namespace osu.Game.Tests.Visual.Gameplay
             if (expectedComponentsContainer == null)
                 return false;
 
-            var expectedComponentsAdjustmentContainer = new Container
+            var expectedComponentsAdjustmentContainer = new DependencyProvidingContainer
             {
                 Position = actualComponentsContainer.Parent.ToSpaceOfOtherDrawable(actualComponentsContainer.DrawPosition, Content),
                 Size = actualComponentsContainer.DrawSize,
                 Child = expectedComponentsContainer,
+                // proxy the same required dependencies that `actualComponentsContainer` is using.
+                CachedDependencies = new (Type, object)[]
+                {
+                    (typeof(ScoreProcessor), actualComponentsContainer.Dependencies.Get<ScoreProcessor>()),
+                    (typeof(HealthProcessor), actualComponentsContainer.Dependencies.Get<HealthProcessor>()),
+                    (typeof(GameplayState), actualComponentsContainer.Dependencies.Get<GameplayState>()),
+                    (typeof(GameplayClock), actualComponentsContainer.Dependencies.Get<GameplayClock>())
+                },
             };
 
             Add(expectedComponentsAdjustmentContainer);

From a8e1c5ba87f53dbe2a30bd81bad67f029dc02234 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 28 May 2022 14:55:57 +0200
Subject: [PATCH 5091/5547] Fix remaining cases of incorrect `GameplayState`
 construction in tests

Manual attempts to initialise replaced by a new `TestGameplayState`
helper for ease of use.
---
 .../TestSceneGameplayCursor.cs                |  4 +--
 .../Visual/Gameplay/TestSceneHUDOverlay.cs    |  4 +--
 .../Gameplay/TestSceneReplayRecorder.cs       |  6 ++--
 .../TestSceneSkinEditorMultipleSkins.cs       |  4 +--
 .../Gameplay/TestSceneSkinnableHUDOverlay.cs  |  4 +--
 .../Visual/Gameplay/TestSceneSpectator.cs     |  9 ++++--
 .../Gameplay/TestSceneSpectatorPlayback.cs    |  4 +--
 osu.Game/Tests/Gameplay/TestGameplayState.cs  | 32 +++++++++++++++++++
 8 files changed, 50 insertions(+), 17 deletions(-)
 create mode 100644 osu.Game/Tests/Gameplay/TestGameplayState.cs

diff --git a/osu.Game.Rulesets.Osu.Tests/TestSceneGameplayCursor.cs b/osu.Game.Rulesets.Osu.Tests/TestSceneGameplayCursor.cs
index a36f07ff7b..496d495b43 100644
--- a/osu.Game.Rulesets.Osu.Tests/TestSceneGameplayCursor.cs
+++ b/osu.Game.Rulesets.Osu.Tests/TestSceneGameplayCursor.cs
@@ -17,11 +17,11 @@ using osu.Framework.Testing.Input;
 using osu.Framework.Utils;
 using osu.Game.Audio;
 using osu.Game.Configuration;
-using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Osu.Skinning;
 using osu.Game.Rulesets.Osu.UI.Cursor;
 using osu.Game.Screens.Play;
 using osu.Game.Skinning;
+using osu.Game.Tests.Gameplay;
 using osuTK;
 
 namespace osu.Game.Rulesets.Osu.Tests
@@ -42,7 +42,7 @@ namespace osu.Game.Rulesets.Osu.Tests
         public TestSceneGameplayCursor()
         {
             var ruleset = new OsuRuleset();
-            gameplayState = new GameplayState(CreateBeatmap(ruleset.RulesetInfo), ruleset, Array.Empty<Mod>());
+            gameplayState = TestGameplayState.Create(ruleset);
 
             AddStep("change background colour", () =>
             {
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneHUDOverlay.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneHUDOverlay.cs
index 2d12645811..83c557ee51 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneHUDOverlay.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneHUDOverlay.cs
@@ -15,7 +15,7 @@ using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Scoring;
 using osu.Game.Screens.Play;
 using osu.Game.Skinning;
-using osu.Game.Tests.Beatmaps;
+using osu.Game.Tests.Gameplay;
 using osuTK.Input;
 
 namespace osu.Game.Tests.Visual.Gameplay
@@ -33,7 +33,7 @@ namespace osu.Game.Tests.Visual.Gameplay
         private HealthProcessor healthProcessor = new DrainingHealthProcessor(0);
 
         [Cached]
-        private GameplayState gameplayState = new GameplayState(new TestBeatmap(new OsuRuleset().RulesetInfo), new OsuRuleset());
+        private GameplayState gameplayState = TestGameplayState.Create(new OsuRuleset());
 
         [Cached]
         private readonly GameplayClock gameplayClock = new GameplayClock(new FramedClock());
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneReplayRecorder.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneReplayRecorder.cs
index 81763564fa..8362739d3b 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneReplayRecorder.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneReplayRecorder.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.Linq;
 using NUnit.Framework;
@@ -14,16 +13,15 @@ using osu.Framework.Input.Events;
 using osu.Framework.Input.StateChanges;
 using osu.Framework.Testing;
 using osu.Framework.Threading;
-using osu.Game.Beatmaps;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Replays;
 using osu.Game.Rulesets;
-using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Replays;
 using osu.Game.Rulesets.UI;
 using osu.Game.Scoring;
 using osu.Game.Screens.Play;
+using osu.Game.Tests.Gameplay;
 using osu.Game.Tests.Mods;
 using osuTK;
 using osuTK.Graphics;
@@ -41,7 +39,7 @@ namespace osu.Game.Tests.Visual.Gameplay
         private TestReplayRecorder recorder;
 
         [Cached]
-        private GameplayState gameplayState = new GameplayState(new Beatmap(), new OsuRuleset(), Array.Empty<Mod>());
+        private GameplayState gameplayState = TestGameplayState.Create(new OsuRuleset());
 
         [SetUpSteps]
         public void SetUpSteps()
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSkinEditorMultipleSkins.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSkinEditorMultipleSkins.cs
index 8150252d45..5f838b8813 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSkinEditorMultipleSkins.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSkinEditorMultipleSkins.cs
@@ -11,7 +11,7 @@ using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Scoring;
 using osu.Game.Screens.Play;
 using osu.Game.Skinning.Editor;
-using osu.Game.Tests.Beatmaps;
+using osu.Game.Tests.Gameplay;
 using osuTK.Input;
 
 namespace osu.Game.Tests.Visual.Gameplay
@@ -25,7 +25,7 @@ namespace osu.Game.Tests.Visual.Gameplay
         private HealthProcessor healthProcessor = new DrainingHealthProcessor(0);
 
         [Cached]
-        private GameplayState gameplayState = new GameplayState(new TestBeatmap(new OsuRuleset().RulesetInfo), new OsuRuleset());
+        private GameplayState gameplayState = TestGameplayState.Create(new OsuRuleset());
 
         [Cached]
         private readonly GameplayClock gameplayClock = new GameplayClock(new FramedClock());
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableHUDOverlay.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableHUDOverlay.cs
index ac5e408d90..5f2d9ee9e8 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableHUDOverlay.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableHUDOverlay.cs
@@ -16,7 +16,7 @@ using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Scoring;
 using osu.Game.Screens.Play;
-using osu.Game.Tests.Beatmaps;
+using osu.Game.Tests.Gameplay;
 using osuTK.Input;
 
 namespace osu.Game.Tests.Visual.Gameplay
@@ -32,7 +32,7 @@ namespace osu.Game.Tests.Visual.Gameplay
         private HealthProcessor healthProcessor = new DrainingHealthProcessor(0);
 
         [Cached]
-        private GameplayState gameplayState = new GameplayState(new TestBeatmap(new OsuRuleset().RulesetInfo), new OsuRuleset());
+        private GameplayState gameplayState = TestGameplayState.Create(new OsuRuleset());
 
         [Cached]
         private readonly GameplayClock gameplayClock = new GameplayClock(new FramedClock());
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs
index 8b420cebc8..b5cdd61ee5 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs
@@ -18,8 +18,8 @@ using osu.Game.Rulesets.UI;
 using osu.Game.Scoring;
 using osu.Game.Screens;
 using osu.Game.Screens.Play;
-using osu.Game.Tests.Beatmaps;
 using osu.Game.Tests.Beatmaps.IO;
+using osu.Game.Tests.Gameplay;
 using osu.Game.Tests.Visual.Multiplayer;
 using osu.Game.Tests.Visual.Spectator;
 using osuTK;
@@ -259,12 +259,15 @@ namespace osu.Game.Tests.Visual.Gameplay
         [Test]
         public void TestFinalFramesPurgedBeforeEndingPlay()
         {
-            AddStep("begin playing", () => spectatorClient.BeginPlaying(new GameplayState(new TestBeatmap(new OsuRuleset().RulesetInfo), new OsuRuleset()), new Score()));
+            AddStep("begin playing", () => spectatorClient.BeginPlaying(TestGameplayState.Create(new OsuRuleset()), new Score()));
 
             AddStep("send frames and finish play", () =>
             {
                 spectatorClient.HandleFrame(new OsuReplayFrame(1000, Vector2.Zero));
-                spectatorClient.EndPlaying(new GameplayState(new TestBeatmap(new OsuRuleset().RulesetInfo), new OsuRuleset()) { HasPassed = true });
+
+                var completedGameplayState = TestGameplayState.Create(new OsuRuleset());
+                completedGameplayState.HasPassed = true;
+                spectatorClient.EndPlaying(completedGameplayState);
             });
 
             // We can't access API because we're an "online" test.
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorPlayback.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorPlayback.cs
index f8748922cf..2d2e05c4c9 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorPlayback.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorPlayback.cs
@@ -20,13 +20,13 @@ using osu.Game.Online.Spectator;
 using osu.Game.Replays;
 using osu.Game.Replays.Legacy;
 using osu.Game.Rulesets;
-using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Replays;
 using osu.Game.Rulesets.Replays.Types;
 using osu.Game.Rulesets.UI;
 using osu.Game.Scoring;
 using osu.Game.Screens.Play;
+using osu.Game.Tests.Gameplay;
 using osu.Game.Tests.Mods;
 using osu.Game.Tests.Visual.Spectator;
 using osuTK;
@@ -65,7 +65,7 @@ namespace osu.Game.Tests.Visual.Gameplay
                     CachedDependencies = new[]
                     {
                         (typeof(SpectatorClient), (object)(spectatorClient = new TestSpectatorClient())),
-                        (typeof(GameplayState), new GameplayState(new Beatmap(), new OsuRuleset(), Array.Empty<Mod>()))
+                        (typeof(GameplayState), TestGameplayState.Create(new OsuRuleset()))
                     },
                     Children = new Drawable[]
                     {
diff --git a/osu.Game/Tests/Gameplay/TestGameplayState.cs b/osu.Game/Tests/Gameplay/TestGameplayState.cs
new file mode 100644
index 0000000000..0d00f52d15
--- /dev/null
+++ b/osu.Game/Tests/Gameplay/TestGameplayState.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.
+
+#nullable enable
+
+using System.Collections.Generic;
+using osu.Game.Rulesets;
+using osu.Game.Rulesets.Mods;
+using osu.Game.Scoring;
+using osu.Game.Screens.Play;
+using osu.Game.Tests.Beatmaps;
+
+namespace osu.Game.Tests.Gameplay
+{
+    /// <summary>
+    /// Static class providing a <see cref="Create"/> convenience method to retrieve a correctly-initialised <see cref="GameplayState"/> instance in testing scenarios.
+    /// </summary>
+    public static class TestGameplayState
+    {
+        /// <summary>
+        /// Creates a correctly-initialised <see cref="GameplayState"/> instance for use in testing.
+        /// </summary>
+        public static GameplayState Create(Ruleset ruleset, IReadOnlyList<Mod>? mods = null, Score? score = null)
+        {
+            var beatmap = new TestBeatmap(ruleset.RulesetInfo);
+            var workingBeatmap = new TestWorkingBeatmap(beatmap);
+            var playableBeatmap = workingBeatmap.GetPlayableBeatmap(ruleset.RulesetInfo, mods);
+
+            return new GameplayState(playableBeatmap, ruleset, mods, score);
+        }
+    }
+}

From 0349d92f8b0b6802423efc5304df52f6db5af81c Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sat, 28 May 2022 17:45:00 +0300
Subject: [PATCH 5092/5547] Add failing test case

---
 .../Visual/Editing/TestSceneTimelineZoom.cs   | 48 +++++++++++++++++++
 1 file changed, 48 insertions(+)
 create mode 100644 osu.Game.Tests/Visual/Editing/TestSceneTimelineZoom.cs

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneTimelineZoom.cs b/osu.Game.Tests/Visual/Editing/TestSceneTimelineZoom.cs
new file mode 100644
index 0000000000..10f1f2fceb
--- /dev/null
+++ b/osu.Game.Tests/Visual/Editing/TestSceneTimelineZoom.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 NUnit.Framework;
+using osu.Framework.Graphics;
+using osu.Framework.Utils;
+
+namespace osu.Game.Tests.Visual.Editing
+{
+    public class TestSceneTimelineZoom : TimelineTestScene
+    {
+        public override Drawable CreateTestComponent() => Empty();
+
+        [Test]
+        public void TestVisibleRangeViaZoom()
+        {
+            double initialVisibleRange = 0;
+
+            AddStep("reset zoom", () => TimelineArea.Timeline.Zoom = 100);
+            AddStep("get initial range", () => initialVisibleRange = TimelineArea.Timeline.VisibleRange);
+
+            AddStep("scale zoom", () => TimelineArea.Timeline.Zoom = 200);
+            AddAssert("range halved", () => Precision.AlmostEquals(TimelineArea.Timeline.VisibleRange, initialVisibleRange / 2, 1));
+            AddStep("descale zoom", () => TimelineArea.Timeline.Zoom = 50);
+            AddAssert("range doubled", () => Precision.AlmostEquals(TimelineArea.Timeline.VisibleRange, initialVisibleRange * 2, 1));
+
+            AddStep("restore zoom", () => TimelineArea.Timeline.Zoom = 100);
+            AddAssert("range restored", () => Precision.AlmostEquals(TimelineArea.Timeline.VisibleRange, initialVisibleRange, 1));
+        }
+
+        [Test]
+        public void TestVisibleRangeViaTimelineSize()
+        {
+            double initialVisibleRange = 0;
+
+            AddStep("reset timeline size", () => TimelineArea.Timeline.Width = 1);
+            AddStep("get initial range", () => initialVisibleRange = TimelineArea.Timeline.VisibleRange);
+
+            AddStep("scale timeline size", () => TimelineArea.Timeline.Width = 2);
+            AddAssert("range doubled", () => TimelineArea.Timeline.VisibleRange == initialVisibleRange * 2);
+            AddStep("descale timeline size", () => TimelineArea.Timeline.Width = 0.5f);
+            AddAssert("range halved", () => TimelineArea.Timeline.VisibleRange == initialVisibleRange / 2);
+
+            AddStep("restore timeline size", () => TimelineArea.Timeline.Width = 1);
+            AddAssert("range restored", () => TimelineArea.Timeline.VisibleRange == initialVisibleRange);
+        }
+    }
+}

From 02baf9a97abe0fb6e94af53b83708a15a508d437 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sat, 28 May 2022 17:45:33 +0300
Subject: [PATCH 5093/5547] Fix timeline objects disappearing prematurely on
 wide-screens

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

diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/Timeline.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/Timeline.cs
index 6812bbb72d..2a6e8f5453 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/Timeline.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/Timeline.cs
@@ -302,7 +302,7 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
         /// <summary>
         /// The total amount of time visible on the timeline.
         /// </summary>
-        public double VisibleRange => track.Length / Zoom;
+        public double VisibleRange => (DisplayableContent / Content.DrawWidth) * track.Length;
 
         public SnapResult FindSnappedPositionAndTime(Vector2 screenSpacePosition, SnapType snapType = SnapType.All) =>
             new SnapResult(screenSpacePosition, beatSnapProvider.SnapTime(getTimeFromPosition(Content.ToLocalSpace(screenSpacePosition))));

From c7570fbce516ad0b35def7d696c885fd80f347f1 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 29 May 2022 15:15:03 +0900
Subject: [PATCH 5094/5547] Fix potential `ObjectDisposedException` on realm
 notification in `SkinSection`

---
 osu.Game/Overlays/Settings/Sections/SkinSection.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Overlays/Settings/Sections/SkinSection.cs b/osu.Game/Overlays/Settings/Sections/SkinSection.cs
index a34776ddf0..264a05b4a7 100644
--- a/osu.Game/Overlays/Settings/Sections/SkinSection.cs
+++ b/osu.Game/Overlays/Settings/Sections/SkinSection.cs
@@ -111,7 +111,7 @@ namespace osu.Game.Overlays.Settings.Sections
             configBindable.Value = skin.NewValue.ID.ToString();
         }
 
-        private void skinsChanged(IRealmCollection<SkinInfo> sender, ChangeSet changes, Exception error)
+        private void skinsChanged(IRealmCollection<SkinInfo> sender, ChangeSet changes, Exception error) => Schedule(() =>
         {
             // This can only mean that realm is recycling, else we would see the protected skins.
             // Because we are using `Live<>` in this class, we don't need to worry about this scenario too much.
@@ -130,7 +130,7 @@ namespace osu.Game.Overlays.Settings.Sections
             skinDropdown.Items = dropdownItems;
 
             updateSelectedSkinFromConfig();
-        }
+        });
 
         private void updateSelectedSkinFromConfig()
         {

From 12d5b355e4d0385a0e0512adfc9a3d602c27c452 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sun, 29 May 2022 15:22:23 +0300
Subject: [PATCH 5095/5547] Add failing test coverage

---
 .../TestSceneTimelineHitObjectBlueprint.cs    | 24 +++++++++++++
 .../Visual/Editing/TimelineTestScene.cs       | 35 +++++++++++--------
 2 files changed, 44 insertions(+), 15 deletions(-)

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneTimelineHitObjectBlueprint.cs b/osu.Game.Tests/Visual/Editing/TestSceneTimelineHitObjectBlueprint.cs
index e6fad33a51..4bd90a0730 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneTimelineHitObjectBlueprint.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneTimelineHitObjectBlueprint.cs
@@ -4,7 +4,9 @@
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Graphics;
+using osu.Framework.Graphics.UserInterface;
 using osu.Framework.Testing;
+using osu.Game.Graphics.UserInterface;
 using osu.Game.Rulesets.Objects.Types;
 using osu.Game.Rulesets.Osu.Objects;
 using osu.Game.Screens.Edit.Compose.Components.Timeline;
@@ -18,6 +20,28 @@ namespace osu.Game.Tests.Visual.Editing
     {
         public override Drawable CreateTestComponent() => new TimelineBlueprintContainer(Composer);
 
+        [Test]
+        public void TestContextMenu()
+        {
+            TimelineHitObjectBlueprint blueprint = null;
+
+            AddStep("add object", () =>
+            {
+                EditorBeatmap.Clear();
+                EditorBeatmap.Add(new HitCircle { StartTime = 3000 });
+            });
+
+            AddStep("click object", () =>
+            {
+                blueprint = this.ChildrenOfType<TimelineHitObjectBlueprint>().Single();
+                InputManager.MoveMouseTo(blueprint);
+                InputManager.Click(MouseButton.Left);
+            });
+
+            AddStep("right click", () => InputManager.Click(MouseButton.Right));
+            AddAssert("context menu open", () => this.ChildrenOfType<OsuContextMenu>().SingleOrDefault()?.State == MenuState.Open);
+        }
+
         [Test]
         public void TestDisallowZeroDurationObjects()
         {
diff --git a/osu.Game.Tests/Visual/Editing/TimelineTestScene.cs b/osu.Game.Tests/Visual/Editing/TimelineTestScene.cs
index 4aed445d9d..93bfb288d2 100644
--- a/osu.Game.Tests/Visual/Editing/TimelineTestScene.cs
+++ b/osu.Game.Tests/Visual/Editing/TimelineTestScene.cs
@@ -8,6 +8,7 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
 using osu.Game.Beatmaps;
+using osu.Game.Graphics.Cursor;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Rulesets.Edit;
 using osu.Game.Screens.Edit;
@@ -38,25 +39,29 @@ namespace osu.Game.Tests.Visual.Editing
 
             Composer = playable.BeatmapInfo.Ruleset.CreateInstance().CreateHitObjectComposer().With(d => d.Alpha = 0);
 
-            AddRange(new Drawable[]
+            Add(new OsuContextMenuContainer
             {
-                EditorBeatmap,
-                Composer,
-                new FillFlowContainer
+                RelativeSizeAxes = Axes.Both,
+                Children = new Drawable[]
                 {
-                    AutoSizeAxes = Axes.Both,
-                    Direction = FillDirection.Vertical,
-                    Spacing = new Vector2(0, 5),
-                    Children = new Drawable[]
+                    EditorBeatmap,
+                    Composer,
+                    new FillFlowContainer
                     {
-                        new StartStopButton(),
-                        new AudioVisualiser(),
+                        AutoSizeAxes = Axes.Both,
+                        Direction = FillDirection.Vertical,
+                        Spacing = new Vector2(0, 5),
+                        Children = new Drawable[]
+                        {
+                            new StartStopButton(),
+                            new AudioVisualiser(),
+                        }
+                    },
+                    TimelineArea = new TimelineArea(CreateTestComponent())
+                    {
+                        Anchor = Anchor.Centre,
+                        Origin = Anchor.Centre,
                     }
-                },
-                TimelineArea = new TimelineArea(CreateTestComponent())
-                {
-                    Anchor = Anchor.Centre,
-                    Origin = Anchor.Centre,
                 }
             });
         }

From 9cc5df9b133450e987afce2187b01e73f0ba8c03 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sun, 29 May 2022 14:56:51 +0300
Subject: [PATCH 5096/5547] Fix context menu no longer open on hitobjects in
 timeline

---
 osu.Game/Screens/Edit/Compose/Components/Timeline/Timeline.cs | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/Timeline.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/Timeline.cs
index 6812bbb72d..89e9fb2404 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/Timeline.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/Timeline.cs
@@ -16,6 +16,7 @@ using osu.Game.Configuration;
 using osu.Game.Graphics;
 using osu.Game.Rulesets.Edit;
 using osuTK;
+using osuTK.Input;
 
 namespace osu.Game.Screens.Edit.Compose.Components.Timeline
 {
@@ -273,7 +274,8 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
             if (base.OnMouseDown(e))
                 beginUserDrag();
 
-            return true;
+            // handling right button as well breaks context menus inside the timeline, only handle left button for now.
+            return e.Button == MouseButton.Left;
         }
 
         protected override void OnMouseUp(MouseUpEvent e)

From 7c97719db1fa10a03ec3e5769b8c8cff4e67f4d6 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 29 May 2022 21:28:09 +0900
Subject: [PATCH 5097/5547] Move `Schedule` to only drawable pieces

---
 osu.Game/Overlays/Settings/Sections/SkinSection.cs | 11 +++++++----
 1 file changed, 7 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Overlays/Settings/Sections/SkinSection.cs b/osu.Game/Overlays/Settings/Sections/SkinSection.cs
index 264a05b4a7..a87e65b735 100644
--- a/osu.Game/Overlays/Settings/Sections/SkinSection.cs
+++ b/osu.Game/Overlays/Settings/Sections/SkinSection.cs
@@ -111,7 +111,7 @@ namespace osu.Game.Overlays.Settings.Sections
             configBindable.Value = skin.NewValue.ID.ToString();
         }
 
-        private void skinsChanged(IRealmCollection<SkinInfo> sender, ChangeSet changes, Exception error) => Schedule(() =>
+        private void skinsChanged(IRealmCollection<SkinInfo> sender, ChangeSet changes, Exception error)
         {
             // This can only mean that realm is recycling, else we would see the protected skins.
             // Because we are using `Live<>` in this class, we don't need to worry about this scenario too much.
@@ -127,10 +127,13 @@ namespace osu.Game.Overlays.Settings.Sections
                 dropdownItems.Add(skin.ToLive(realm));
             dropdownItems.Insert(protectedCount, random_skin_info);
 
-            skinDropdown.Items = dropdownItems;
+            Schedule(() =>
+            {
+                skinDropdown.Items = dropdownItems;
 
-            updateSelectedSkinFromConfig();
-        });
+                updateSelectedSkinFromConfig();
+            });
+        }
 
         private void updateSelectedSkinFromConfig()
         {

From 70c8a439619910541cf4748d165efc3704103e05 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 29 May 2022 21:31:20 +0900
Subject: [PATCH 5098/5547] Update framework

---
 osu.Android.props        | 2 +-
 osu.Game/osu.Game.csproj | 2 +-
 osu.iOS.props            | 4 ++--
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Android.props b/osu.Android.props
index ecc929a66d..c28085557e 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -52,7 +52,7 @@
   </ItemGroup>
   <ItemGroup>
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.527.0" />
-    <PackageReference Include="ppy.osu.Framework.Android" Version="2022.528.0" />
+    <PackageReference Include="ppy.osu.Framework.Android" Version="2022.529.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
     <!-- Realm needs to be directly referenced in all Xamarin projects, as it will not pull in its transitive dependencies otherwise. -->
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 950d4ceae1..79cfd7c917 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="10.11.2" />
-    <PackageReference Include="ppy.osu.Framework" Version="2022.528.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2022.529.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.527.0" />
     <PackageReference Include="Sentry" Version="3.17.1" />
     <PackageReference Include="SharpCompress" Version="0.31.0" />
diff --git a/osu.iOS.props b/osu.iOS.props
index bcff0d3c44..b1ba64beba 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -61,7 +61,7 @@
     <Reference Include="System.Net.Http" />
   </ItemGroup>
   <ItemGroup Label="Package References">
-    <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.528.0" />
+    <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.529.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.527.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net6.0) -->
@@ -84,7 +84,7 @@
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="5.0.14" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.Core" Version="5.0.14" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
-    <PackageReference Include="ppy.osu.Framework" Version="2022.528.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2022.529.0" />
     <PackageReference Include="SharpCompress" Version="0.31.0" />
     <PackageReference Include="NUnit" Version="3.13.3" />
     <PackageReference Include="System.ComponentModel.Annotations" Version="5.0.0" />

From c078c06902014195534d24991d8e7168ddd4badc Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 29 May 2022 22:55:53 +0900
Subject: [PATCH 5099/5547] Fix unsafe config fetching

---
 osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs b/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs
index 0580d20171..4127b5f19b 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs
@@ -150,10 +150,14 @@ namespace osu.Game.Tests.Visual.Online
         public void TestChatHeight()
         {
             BindableFloat configChatHeight = new BindableFloat();
-            config.BindWith(OsuSetting.ChatDisplayHeight, configChatHeight);
+
             float newHeight = 0;
 
-            AddStep("Reset config chat height", () => configChatHeight.SetDefault());
+            AddStep("Reset config chat height", () =>
+            {
+                config.BindWith(OsuSetting.ChatDisplayHeight, configChatHeight);
+                configChatHeight.SetDefault();
+            });
             AddStep("Show overlay", () => chatOverlay.Show());
             AddAssert("Overlay uses config height", () => chatOverlay.Height == configChatHeight.Default);
             AddStep("Click top bar", () =>

From 18f75d8c58e3aeb21011d1392ab8899d35ec9406 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 29 May 2022 16:06:01 +0200
Subject: [PATCH 5100/5547] Remove redundant initialiser

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

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneTimelineHitObjectBlueprint.cs b/osu.Game.Tests/Visual/Editing/TestSceneTimelineHitObjectBlueprint.cs
index 4bd90a0730..d55852ec43 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneTimelineHitObjectBlueprint.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneTimelineHitObjectBlueprint.cs
@@ -23,7 +23,7 @@ namespace osu.Game.Tests.Visual.Editing
         [Test]
         public void TestContextMenu()
         {
-            TimelineHitObjectBlueprint blueprint = null;
+            TimelineHitObjectBlueprint blueprint;
 
             AddStep("add object", () =>
             {

From caee9e67b6687f94c1fa4e40b115c67a61a442b0 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 29 May 2022 23:03:34 +0900
Subject: [PATCH 5101/5547] Centralise `DrawableChannel` checks and account for
 async load delays

---
 .../Visual/Online/TestSceneChatOverlayV2.cs   | 51 ++++++++++---------
 1 file changed, 28 insertions(+), 23 deletions(-)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs b/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs
index 4127b5f19b..b333eee21b 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs
@@ -134,7 +134,7 @@ namespace osu.Game.Tests.Visual.Online
                 channelManager.CurrentChannel.Value = joinedChannel;
             });
             AddAssert("Overlay is visible", () => chatOverlay.State.Value == Visibility.Visible);
-            AddUntilStep("Channel is visible", () => channelIsVisible && currentDrawableChannel.Channel == testChannel1);
+            waitForChannel1Visible();
         }
 
         [Test]
@@ -181,7 +181,7 @@ namespace osu.Game.Tests.Visual.Online
             AddAssert("Listing is visible", () => listingIsVisible);
             AddStep("Join channel 1", () => channelManager.JoinChannel(testChannel1));
             AddStep("Select channel 1", () => clickDrawable(getChannelListItem(testChannel1)));
-            AddUntilStep("Channel 1 is visible", () => channelIsVisible && currentDrawableChannel.Channel == testChannel1);
+            waitForChannel1Visible();
         }
 
         [Test]
@@ -190,7 +190,7 @@ namespace osu.Game.Tests.Visual.Online
             AddStep("Show overlay", () => chatOverlay.Show());
             AddAssert("Listing is visible", () => listingIsVisible);
             AddStep("Search for 'number 2'", () => chatOverlayTextBox.Text = "number 2");
-            AddUntilStep("Only channel 2 visibile", () =>
+            AddUntilStep("Only channel 2 visible", () =>
             {
                 IEnumerable<ChannelListingItem> listingItems = chatOverlay.ChildrenOfType<ChannelListingItem>()
                                                                           .Where(item => item.IsPresent);
@@ -280,7 +280,7 @@ namespace osu.Game.Tests.Visual.Online
                 });
             });
             AddStep("Highlight message", () => chatOverlay.HighlightMessage(message, testChannel1));
-            AddUntilStep("Channel 1 is visible", () => channelIsVisible && currentDrawableChannel.Channel == testChannel1);
+            waitForChannel1Visible();
         }
 
         [Test]
@@ -303,7 +303,7 @@ namespace osu.Game.Tests.Visual.Online
                 });
             });
             AddStep("Highlight message", () => chatOverlay.HighlightMessage(message, testChannel2));
-            AddUntilStep("Channel 2 is visible", () => channelIsVisible && currentDrawableChannel.Channel == testChannel2);
+            waitForChannel2Visible();
         }
 
         [Test]
@@ -327,7 +327,7 @@ namespace osu.Game.Tests.Visual.Online
             });
             AddStep("Leave channel 2", () => channelManager.LeaveChannel(testChannel2));
             AddStep("Highlight message", () => chatOverlay.HighlightMessage(message, testChannel2));
-            AddUntilStep("Channel 2 is visible", () => channelIsVisible && currentDrawableChannel.Channel == testChannel2);
+            waitForChannel2Visible();
         }
 
         [Test]
@@ -347,7 +347,7 @@ namespace osu.Game.Tests.Visual.Online
                 });
             });
             AddStep("Highlight message", () => chatOverlay.HighlightMessage(message, testChannel1));
-            AddUntilStep("Channel 1 is visible", () => channelIsVisible && currentDrawableChannel.Channel == testChannel1);
+            waitForChannel1Visible();
         }
 
         [Test]
@@ -368,7 +368,7 @@ namespace osu.Game.Tests.Visual.Online
             });
             AddStep("Set null channel", () => channelManager.CurrentChannel.Value = null);
             AddStep("Highlight message", () => chatOverlay.HighlightMessage(message, testChannel1));
-            AddUntilStep("Channel 1 is visible", () => channelIsVisible && currentDrawableChannel.Channel == testChannel1);
+            waitForChannel1Visible();
         }
 
         [Test]
@@ -378,6 +378,7 @@ namespace osu.Game.Tests.Visual.Online
             AddAssert("TextBox is focused", () => InputManager.FocusedDrawable == chatOverlayTextBox);
             AddStep("Join channel 1", () => channelManager.JoinChannel(testChannel1));
             AddStep("Select channel 1", () => clickDrawable(getChannelListItem(testChannel1)));
+            waitForChannel1Visible();
             AddAssert("TextBox is focused", () => InputManager.FocusedDrawable == chatOverlayTextBox);
             AddStep("Click drawable channel", () => clickDrawable(currentDrawableChannel));
             AddAssert("TextBox is focused", () => InputManager.FocusedDrawable == chatOverlayTextBox);
@@ -415,11 +416,11 @@ namespace osu.Game.Tests.Visual.Online
 
             AddStep("Finish channel 2 load", () => chatOverlay.GetSlowLoadingChannel(testChannel2).LoadEvent.Set());
             AddAssert("Channel 2 loaded", () => chatOverlay.GetSlowLoadingChannel(testChannel2).IsLoaded);
-            AddAssert("Channel 2 displayed", () => channelIsVisible && currentDrawableChannel.Channel == testChannel2);
+            waitForChannel2Visible();
 
             AddStep("Select channel 1", () => clickDrawable(getChannelListItem(testChannel1)));
             AddAssert("Channel 1 loaded", () => chatOverlay.GetSlowLoadingChannel(testChannel1).IsLoaded);
-            AddAssert("Channel 1 displayed", () => channelIsVisible && currentDrawableChannel.Channel == testChannel1);
+            waitForChannel1Visible();
         }
 
         [Test]
@@ -430,13 +431,12 @@ namespace osu.Game.Tests.Visual.Online
                 channelManager.JoinChannel(testChannel1);
                 chatOverlay.Show();
             });
-            AddAssert("Channel 1 displayed", () => channelIsVisible && currentDrawableChannel.Channel == testChannel1);
-
+            waitForChannel1Visible();
             AddStep("Press document close keys", () => InputManager.Keys(PlatformAction.DocumentClose));
             AddAssert("Listing is visible", () => listingIsVisible);
 
             AddStep("Press tab restore keys", () => InputManager.Keys(PlatformAction.TabRestore));
-            AddAssert("Channel 1 displayed", () => channelIsVisible && currentDrawableChannel.Channel == testChannel1);
+            waitForChannel1Visible();
         }
 
         [Test]
@@ -447,8 +447,7 @@ namespace osu.Game.Tests.Visual.Online
                 channelManager.JoinChannel(testChannel1);
                 chatOverlay.Show();
             });
-            AddAssert("Channel 1 displayed", () => channelIsVisible && currentDrawableChannel.Channel == testChannel1);
-
+            waitForChannel1Visible();
             AddStep("Press tab new keys", () => InputManager.Keys(PlatformAction.TabNew));
             AddAssert("Listing is visible", () => listingIsVisible);
         }
@@ -468,21 +467,26 @@ namespace osu.Game.Tests.Visual.Online
                 chatOverlay.Show();
             });
 
-            AddAssert("Channel 1 displayed", () => channelIsVisible && currentDrawableChannel.Channel == testChannel1);
+            waitForChannel1Visible();
+            AddStep("Press document next keys", () => InputManager.Keys(PlatformAction.DocumentNext));
+            waitForChannel2Visible();
 
             AddStep("Press document next keys", () => InputManager.Keys(PlatformAction.DocumentNext));
-            AddAssert("Channel 2 displayed", () => channelIsVisible && currentDrawableChannel.Channel == testChannel2);
+            AddUntilStep("PM Channel 1 displayed", () => channelIsVisible && currentDrawableChannel?.Channel == pmChannel1);
 
             AddStep("Press document next keys", () => InputManager.Keys(PlatformAction.DocumentNext));
-            AddAssert("PM Channel 1 displayed", () => channelIsVisible && currentDrawableChannel.Channel == pmChannel1);
+            AddUntilStep("PM Channel 2 displayed", () => channelIsVisible && currentDrawableChannel?.Channel == pmChannel2);
 
             AddStep("Press document next keys", () => InputManager.Keys(PlatformAction.DocumentNext));
-            AddAssert("PM Channel 2 displayed", () => channelIsVisible && currentDrawableChannel.Channel == pmChannel2);
-
-            AddStep("Press document next keys", () => InputManager.Keys(PlatformAction.DocumentNext));
-            AddAssert("Channel 1 displayed", () => channelIsVisible && currentDrawableChannel.Channel == testChannel1);
+            waitForChannel1Visible();
         }
 
+        private void waitForChannel1Visible() =>
+            AddUntilStep("Channel 1 is visible", () => channelIsVisible && currentDrawableChannel?.Channel == testChannel1);
+
+        private void waitForChannel2Visible() =>
+            AddUntilStep("Channel 2 is visible", () => channelIsVisible && currentDrawableChannel?.Channel == testChannel2);
+
         private bool listingIsVisible =>
             chatOverlay.ChildrenOfType<ChannelListing>().Single().State.Value == Visibility.Visible;
 
@@ -492,8 +496,9 @@ namespace osu.Game.Tests.Visual.Online
         private bool channelIsVisible =>
             !listingIsVisible && !loadingIsVisible;
 
+        [CanBeNull]
         private DrawableChannel currentDrawableChannel =>
-            chatOverlay.ChildrenOfType<DrawableChannel>().Single();
+            chatOverlay.ChildrenOfType<DrawableChannel>().SingleOrDefault();
 
         private ChannelListItem getChannelListItem(Channel channel) =>
             chatOverlay.ChildrenOfType<ChannelListItem>().Single(item => item.Channel == channel);

From e69f8716cd05105e029f31ff3600200dec58c8c4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 29 May 2022 18:56:37 +0200
Subject: [PATCH 5102/5547] Fix incorrect indent size

---
 osu.Game/Overlays/Chat/ChannelList/ChannelList.cs | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs b/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs
index 0f3d8574c1..20c8b6d32d 100644
--- a/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs
+++ b/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs
@@ -27,9 +27,9 @@ namespace osu.Game.Overlays.Chat.ChannelList
         public Action<Channel>? OnRequestLeave;
 
         public IEnumerable<Channel> Channels => groupFlow.Children.Where(child => child is ChannelGroup)
-                                                .Cast<ChannelGroup>()
-                                                .SelectMany(channelGroup => channelGroup.ItemFlow)
-                                                .Select(item => item.Channel);
+                                                         .Cast<ChannelGroup>()
+                                                         .SelectMany(channelGroup => channelGroup.ItemFlow)
+                                                         .Select(item => item.Channel);
 
         public readonly ChannelListing.ChannelListingChannel ChannelListingChannel = new ChannelListing.ChannelListingChannel();
 

From e329c160b37bbccbd0231b67db2dd0ae6fa40be5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 29 May 2022 18:58:27 +0200
Subject: [PATCH 5103/5547] Simplify channel retrieval expression

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

diff --git a/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs b/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs
index 20c8b6d32d..47a2d234d1 100644
--- a/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs
+++ b/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs
@@ -26,8 +26,8 @@ namespace osu.Game.Overlays.Chat.ChannelList
         public Action<Channel>? OnRequestSelect;
         public Action<Channel>? OnRequestLeave;
 
-        public IEnumerable<Channel> Channels => groupFlow.Children.Where(child => child is ChannelGroup)
-                                                         .Cast<ChannelGroup>()
+        public IEnumerable<Channel> Channels => groupFlow.Children
+                                                         .OfType<ChannelGroup>()
                                                          .SelectMany(channelGroup => channelGroup.ItemFlow)
                                                          .Select(item => item.Channel);
 

From c892ec83efb478c12c617bc191a7b964bc4d672b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 29 May 2022 20:15:17 +0200
Subject: [PATCH 5104/5547] Fix wrong sizing of editor timeline ticks

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

diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineTickDisplay.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineTickDisplay.cs
index fda8416ecd..9904d91653 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineTickDisplay.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineTickDisplay.cs
@@ -135,7 +135,7 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
 
                         Vector2 size = Vector2.One;
 
-                        if (indexInBar != 1)
+                        if (indexInBar != 0)
                             size = BindableBeatDivisor.GetSize(divisor);
 
                         var line = getNextUsableLine();

From 8f596520f3ea360cd5398fa42c762a9a3ee37e66 Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Sun, 29 May 2022 20:07:42 +0100
Subject: [PATCH 5105/5547] Remove old chat overlay components

---
 .../Online/TestSceneChannelTabControl.cs      | 129 ----
 .../Visual/Online/TestSceneChatOverlay.cs     | 663 ------------------
 osu.Game/Online/Chat/ChannelManager.cs        |   3 +-
 .../Chat/Selection/ChannelListItem.cs         | 191 -----
 .../Overlays/Chat/Selection/ChannelSection.cs |  58 --
 .../Chat/Selection/ChannelSelectionOverlay.cs | 194 -----
 .../Chat/Tabs/ChannelSelectorTabItem.cs       |  46 --
 .../Overlays/Chat/Tabs/ChannelTabControl.cs   | 114 ---
 osu.Game/Overlays/Chat/Tabs/ChannelTabItem.cs | 238 -------
 .../Chat/Tabs/PrivateChannelTabItem.cs        |  95 ---
 osu.Game/Overlays/Chat/Tabs/TabCloseButton.cs |  55 --
 osu.Game/Overlays/ChatOverlay.cs              | 525 --------------
 12 files changed, 1 insertion(+), 2310 deletions(-)
 delete mode 100644 osu.Game.Tests/Visual/Online/TestSceneChannelTabControl.cs
 delete mode 100644 osu.Game.Tests/Visual/Online/TestSceneChatOverlay.cs
 delete mode 100644 osu.Game/Overlays/Chat/Selection/ChannelListItem.cs
 delete mode 100644 osu.Game/Overlays/Chat/Selection/ChannelSection.cs
 delete mode 100644 osu.Game/Overlays/Chat/Selection/ChannelSelectionOverlay.cs
 delete mode 100644 osu.Game/Overlays/Chat/Tabs/ChannelSelectorTabItem.cs
 delete mode 100644 osu.Game/Overlays/Chat/Tabs/ChannelTabControl.cs
 delete mode 100644 osu.Game/Overlays/Chat/Tabs/ChannelTabItem.cs
 delete mode 100644 osu.Game/Overlays/Chat/Tabs/PrivateChannelTabItem.cs
 delete mode 100644 osu.Game/Overlays/Chat/Tabs/TabCloseButton.cs
 delete mode 100644 osu.Game/Overlays/ChatOverlay.cs

diff --git a/osu.Game.Tests/Visual/Online/TestSceneChannelTabControl.cs b/osu.Game.Tests/Visual/Online/TestSceneChannelTabControl.cs
deleted file mode 100644
index e6eaffc4c1..0000000000
--- a/osu.Game.Tests/Visual/Online/TestSceneChannelTabControl.cs
+++ /dev/null
@@ -1,129 +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.Collections.Generic;
-using System.Linq;
-using osu.Framework.Extensions.Color4Extensions;
-using osu.Framework.Extensions.IEnumerableExtensions;
-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.Graphics.Sprites;
-using osu.Game.Online.API.Requests.Responses;
-using osu.Game.Online.Chat;
-using osu.Game.Overlays.Chat.Tabs;
-using osuTK.Graphics;
-
-namespace osu.Game.Tests.Visual.Online
-{
-    public class TestSceneChannelTabControl : OsuTestScene
-    {
-        private readonly TestTabControl channelTabControl;
-
-        public TestSceneChannelTabControl()
-        {
-            SpriteText currentText;
-            Add(new Container
-            {
-                RelativeSizeAxes = Axes.X,
-                Origin = Anchor.Centre,
-                Anchor = Anchor.Centre,
-                Children = new Drawable[]
-                {
-                    channelTabControl = new TestTabControl
-                    {
-                        RelativeSizeAxes = Axes.X,
-                        Origin = Anchor.Centre,
-                        Anchor = Anchor.Centre,
-                        Height = 50
-                    },
-                    new Box
-                    {
-                        Colour = Color4.Black.Opacity(0.1f),
-                        RelativeSizeAxes = Axes.X,
-                        Height = 50,
-                        Depth = -1,
-                        Origin = Anchor.Centre,
-                        Anchor = Anchor.Centre,
-                    }
-                }
-            });
-
-            Add(new Container
-            {
-                Origin = Anchor.TopLeft,
-                Anchor = Anchor.TopLeft,
-                Children = new Drawable[]
-                {
-                    currentText = new OsuSpriteText
-                    {
-                        Text = "Currently selected channel:"
-                    }
-                }
-            });
-
-            channelTabControl.OnRequestLeave += channel => channelTabControl.RemoveChannel(channel);
-            channelTabControl.Current.ValueChanged += channel => currentText.Text = "Currently selected channel: " + channel.NewValue;
-
-            AddStep("Add random private channel", addRandomPrivateChannel);
-            AddAssert("There is only one channels", () => channelTabControl.Items.Count == 2);
-            AddRepeatStep("Add 3 random private channels", addRandomPrivateChannel, 3);
-            AddAssert("There are four channels", () => channelTabControl.Items.Count == 5);
-            AddStep("Add random public channel", () => addChannel(RNG.Next().ToString()));
-
-            AddRepeatStep("Select a random channel", () =>
-            {
-                List<Channel> validChannels = channelTabControl.Items.Where(c => !(c is ChannelSelectorTabItem.ChannelSelectorTabChannel)).ToList();
-                channelTabControl.SelectChannel(validChannels[RNG.Next(0, validChannels.Count)]);
-            }, 20);
-
-            Channel channelBefore = null;
-            AddStep("set first channel", () => channelTabControl.SelectChannel(channelBefore = channelTabControl.Items.First(c => !(c is ChannelSelectorTabItem.ChannelSelectorTabChannel))));
-
-            AddStep("select selector tab", () => channelTabControl.SelectChannel(channelTabControl.Items.Single(c => c is ChannelSelectorTabItem.ChannelSelectorTabChannel)));
-            AddAssert("selector tab is active", () => channelTabControl.ChannelSelectorActive.Value);
-
-            AddAssert("check channel unchanged", () => channelBefore == channelTabControl.Current.Value);
-
-            AddStep("set second channel", () => channelTabControl.SelectChannel(channelTabControl.Items.GetNext(channelBefore)));
-            AddAssert("selector tab is inactive", () => !channelTabControl.ChannelSelectorActive.Value);
-
-            AddUntilStep("remove all channels", () =>
-            {
-                foreach (var item in channelTabControl.Items.ToList())
-                {
-                    if (item is ChannelSelectorTabItem.ChannelSelectorTabChannel)
-                        continue;
-
-                    channelTabControl.RemoveChannel(item);
-                    return false;
-                }
-
-                return true;
-            });
-
-            AddAssert("selector tab is active", () => channelTabControl.ChannelSelectorActive.Value);
-        }
-
-        private void addRandomPrivateChannel() =>
-            channelTabControl.AddChannel(new Channel(new APIUser
-            {
-                Id = RNG.Next(1000, 10000000),
-                Username = "Test User " + RNG.Next(1000)
-            }));
-
-        private void addChannel(string name) =>
-            channelTabControl.AddChannel(new Channel
-            {
-                Type = ChannelType.Public,
-                Name = name
-            });
-
-        private class TestTabControl : ChannelTabControl
-        {
-            public void SelectChannel(Channel channel) => base.SelectTab(TabMap[channel]);
-        }
-    }
-}
diff --git a/osu.Game.Tests/Visual/Online/TestSceneChatOverlay.cs b/osu.Game.Tests/Visual/Online/TestSceneChatOverlay.cs
deleted file mode 100644
index 4d1dee1650..0000000000
--- a/osu.Game.Tests/Visual/Online/TestSceneChatOverlay.cs
+++ /dev/null
@@ -1,663 +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 System.Net;
-using JetBrains.Annotations;
-using NUnit.Framework;
-using osu.Framework.Allocation;
-using osu.Framework.Bindables;
-using osu.Framework.Graphics;
-using osu.Framework.Graphics.Containers;
-using osu.Framework.Graphics.UserInterface;
-using osu.Framework.Input;
-using osu.Framework.Testing;
-using osu.Game.Graphics.UserInterface;
-using osu.Game.Online.API;
-using osu.Game.Online.API.Requests;
-using osu.Game.Online.API.Requests.Responses;
-using osu.Game.Online.Chat;
-using osu.Game.Overlays;
-using osu.Game.Overlays.Chat;
-using osu.Game.Overlays.Chat.Selection;
-using osu.Game.Overlays.Chat.Tabs;
-using osuTK.Input;
-
-namespace osu.Game.Tests.Visual.Online
-{
-    public class TestSceneChatOverlay : OsuManualInputManagerTestScene
-    {
-        private TestChatOverlay chatOverlay;
-        private ChannelManager channelManager;
-
-        private IEnumerable<Channel> visibleChannels => chatOverlay.ChannelTabControl.VisibleItems.Where(channel => channel.Name != "+");
-        private IEnumerable<Channel> joinedChannels => chatOverlay.ChannelTabControl.Items.Where(channel => channel.Name != "+");
-        private readonly List<Channel> channels;
-
-        private Channel currentChannel => channelManager.CurrentChannel.Value;
-        private Channel nextChannel => joinedChannels.ElementAt(joinedChannels.ToList().IndexOf(currentChannel) + 1);
-        private Channel previousChannel => joinedChannels.ElementAt(joinedChannels.ToList().IndexOf(currentChannel) - 1);
-        private Channel channel1 => channels[0];
-        private Channel channel2 => channels[1];
-        private Channel channel3 => channels[2];
-
-        [CanBeNull]
-        private Func<Channel, List<Message>> onGetMessages;
-
-        public TestSceneChatOverlay()
-        {
-            channels = Enumerable.Range(1, 10)
-                                 .Select(index => new Channel(new APIUser())
-                                 {
-                                     Name = $"Channel no. {index}",
-                                     Topic = index == 3 ? null : $"We talk about the number {index} here",
-                                     Type = index % 2 == 0 ? ChannelType.PM : ChannelType.Temporary,
-                                     Id = index
-                                 })
-                                 .ToList();
-        }
-
-        [SetUp]
-        public void Setup()
-        {
-            Schedule(() =>
-            {
-                ChannelManagerContainer container;
-
-                Child = container = new ChannelManagerContainer(channels)
-                {
-                    RelativeSizeAxes = Axes.Both,
-                };
-
-                chatOverlay = container.ChatOverlay;
-                channelManager = container.ChannelManager;
-            });
-        }
-
-        [SetUpSteps]
-        public void SetUpSteps()
-        {
-            AddStep("register request handling", () =>
-            {
-                onGetMessages = null;
-
-                ((DummyAPIAccess)API).HandleRequest = req =>
-                {
-                    switch (req)
-                    {
-                        case JoinChannelRequest joinChannel:
-                            joinChannel.TriggerSuccess();
-                            return true;
-
-                        case GetUserRequest getUser:
-                            if (getUser.Lookup.Equals("some body", StringComparison.OrdinalIgnoreCase))
-                            {
-                                getUser.TriggerSuccess(new APIUser
-                                {
-                                    Username = "some body",
-                                    Id = 1,
-                                });
-                            }
-                            else
-                            {
-                                getUser.TriggerFailure(new WebException());
-                            }
-
-                            return true;
-
-                        case GetMessagesRequest getMessages:
-                            var messages = onGetMessages?.Invoke(getMessages.Channel);
-                            if (messages != null)
-                                getMessages.TriggerSuccess(messages);
-                            return true;
-                    }
-
-                    return false;
-                };
-            });
-        }
-
-        [Test]
-        public void TestHideOverlay()
-        {
-            AddStep("Open chat overlay", () => chatOverlay.Show());
-
-            AddAssert("Chat overlay is visible", () => chatOverlay.State.Value == Visibility.Visible);
-            AddAssert("Selector is visible", () => chatOverlay.SelectionOverlayState == Visibility.Visible);
-
-            AddStep("Close chat overlay", () => chatOverlay.Hide());
-
-            AddAssert("Chat overlay was hidden", () => chatOverlay.State.Value == Visibility.Hidden);
-            AddAssert("Channel selection overlay was hidden", () => chatOverlay.SelectionOverlayState == Visibility.Hidden);
-        }
-
-        [Test]
-        public void TestChannelSelection()
-        {
-            AddStep("Open chat overlay", () => chatOverlay.Show());
-            AddAssert("Selector is visible", () => chatOverlay.SelectionOverlayState == Visibility.Visible);
-            AddStep("Setup get message response", () => onGetMessages = channel =>
-            {
-                if (channel == channel1)
-                {
-                    return new List<Message>
-                    {
-                        new Message(1)
-                        {
-                            ChannelId = channel1.Id,
-                            Content = "hello from channel 1!",
-                            Sender = new APIUser
-                            {
-                                Id = 2,
-                                Username = "test_user"
-                            }
-                        }
-                    };
-                }
-
-                return null;
-            });
-
-            AddStep("Join channel 1", () => channelManager.JoinChannel(channel1));
-            AddStep("Switch to channel 1", () => clickDrawable(chatOverlay.TabMap[channel1]));
-
-            AddAssert("Current channel is channel 1", () => currentChannel == channel1);
-            AddUntilStep("Loading spinner hidden", () => chatOverlay.ChildrenOfType<LoadingSpinner>().All(spinner => !spinner.IsPresent));
-            AddAssert("Channel message shown", () => chatOverlay.ChildrenOfType<ChatLine>().Count() == 1);
-            AddAssert("Channel selector was closed", () => chatOverlay.SelectionOverlayState == Visibility.Hidden);
-        }
-
-        [Test]
-        public void TestSearchInSelector()
-        {
-            AddStep("Open chat overlay", () => chatOverlay.Show());
-            AddStep("Search for 'no. 2'", () => chatOverlay.ChildrenOfType<SearchTextBox>().First().Text = "no. 2");
-            AddUntilStep("Only channel 2 visible", () =>
-            {
-                var listItems = chatOverlay.ChildrenOfType<ChannelListItem>().Where(c => c.IsPresent);
-                return listItems.Count() == 1 && listItems.Single().Channel == channel2;
-            });
-        }
-
-        [Test]
-        public void TestChannelShortcutKeys()
-        {
-            AddStep("Open chat overlay", () => chatOverlay.Show());
-            AddStep("Join channels", () => channels.ForEach(channel => channelManager.JoinChannel(channel)));
-            AddStep("Close channel selector", () => InputManager.Key(Key.Escape));
-            AddUntilStep("Wait for close", () => chatOverlay.SelectionOverlayState == Visibility.Hidden);
-
-            for (int zeroBasedIndex = 0; zeroBasedIndex < 10; ++zeroBasedIndex)
-            {
-                int oneBasedIndex = zeroBasedIndex + 1;
-                int targetNumberKey = oneBasedIndex % 10;
-                var targetChannel = channels[zeroBasedIndex];
-                AddStep($"Press Alt+{targetNumberKey}", () => pressChannelHotkey(targetNumberKey));
-                AddAssert($"Channel #{oneBasedIndex} is selected", () => currentChannel == targetChannel);
-            }
-        }
-
-        private Channel expectedChannel;
-
-        [Test]
-        public void TestCloseChannelBehaviour()
-        {
-            AddStep("Open chat overlay", () => chatOverlay.Show());
-            AddUntilStep("Join until dropdown has channels", () =>
-            {
-                if (visibleChannels.Count() < joinedChannels.Count())
-                    return true;
-
-                // Using temporary channels because they don't hide their names when not active
-                channelManager.JoinChannel(new Channel
-                {
-                    Name = $"Channel no. {joinedChannels.Count() + 11}",
-                    Type = ChannelType.Temporary
-                });
-
-                return false;
-            });
-
-            AddStep("Switch to last tab", () => clickDrawable(chatOverlay.TabMap[visibleChannels.Last()]));
-            AddAssert("Last visible selected", () => currentChannel == visibleChannels.Last());
-
-            // Closing the last channel before dropdown
-            AddStep("Close current channel", () =>
-            {
-                expectedChannel = nextChannel;
-                chatOverlay.ChannelTabControl.RemoveChannel(currentChannel);
-            });
-            AddAssert("Next channel selected", () => currentChannel == expectedChannel);
-            AddAssert("Selector remained closed", () => chatOverlay.SelectionOverlayState == Visibility.Hidden);
-
-            // Depending on the window size, one more channel might need to be closed for the selectorTab to appear
-            AddUntilStep("Close channels until selector visible", () =>
-            {
-                if (chatOverlay.ChannelTabControl.VisibleItems.Last().Name == "+")
-                    return true;
-
-                chatOverlay.ChannelTabControl.RemoveChannel(visibleChannels.Last());
-                return false;
-            });
-            AddAssert("Last visible selected", () => currentChannel == visibleChannels.Last());
-
-            // Closing the last channel with dropdown no longer present
-            AddStep("Close last when selector next", () =>
-            {
-                expectedChannel = previousChannel;
-                chatOverlay.ChannelTabControl.RemoveChannel(currentChannel);
-            });
-            AddAssert("Previous channel selected", () => currentChannel == expectedChannel);
-
-            // Standard channel closing
-            AddStep("Switch to previous channel", () => chatOverlay.ChannelTabControl.SwitchTab(-1));
-            AddStep("Close current channel", () =>
-            {
-                expectedChannel = nextChannel;
-                chatOverlay.ChannelTabControl.RemoveChannel(currentChannel);
-            });
-            AddAssert("Next channel selected", () => currentChannel == expectedChannel);
-
-            // Selector reappearing after all channels closed
-            AddUntilStep("Close all channels", () =>
-            {
-                if (!joinedChannels.Any())
-                    return true;
-
-                chatOverlay.ChannelTabControl.RemoveChannel(joinedChannels.Last());
-                return false;
-            });
-            AddAssert("Selector is visible", () => chatOverlay.SelectionOverlayState == Visibility.Visible);
-        }
-
-        [Test]
-        public void TestChannelCloseButton()
-        {
-            AddStep("Open chat overlay", () => chatOverlay.Show());
-            AddStep("Join 2 channels", () =>
-            {
-                channelManager.JoinChannel(channel1);
-                channelManager.JoinChannel(channel2);
-            });
-
-            // PM channel close button only appears when active
-            AddStep("Select PM channel", () => clickDrawable(chatOverlay.TabMap[channel2]));
-            AddStep("Click PM close button", () => clickDrawable(((TestPrivateChannelTabItem)chatOverlay.TabMap[channel2]).CloseButton.Child));
-            AddAssert("PM channel closed", () => !channelManager.JoinedChannels.Contains(channel2));
-
-            // Non-PM chat channel close button only appears when hovered
-            AddStep("Hover normal channel tab", () => InputManager.MoveMouseTo(chatOverlay.TabMap[channel1]));
-            AddStep("Click normal close button", () => clickDrawable(((TestChannelTabItem)chatOverlay.TabMap[channel1]).CloseButton.Child));
-            AddAssert("All channels closed", () => !channelManager.JoinedChannels.Any());
-        }
-
-        [Test]
-        public void TestCloseTabShortcut()
-        {
-            AddStep("Open chat overlay", () => chatOverlay.Show());
-            AddStep("Join 2 channels", () =>
-            {
-                channelManager.JoinChannel(channel1);
-                channelManager.JoinChannel(channel2);
-            });
-
-            // Want to close channel 2
-            AddStep("Select channel 2", () => clickDrawable(chatOverlay.TabMap[channel2]));
-            AddStep("Close tab via shortcut", pressCloseDocumentKeys);
-
-            // Channel 2 should be closed
-            AddAssert("Channel 1 open", () => channelManager.JoinedChannels.Contains(channel1));
-            AddAssert("Channel 2 closed", () => !channelManager.JoinedChannels.Contains(channel2));
-
-            // Want to close channel 1
-            AddStep("Select channel 1", () => clickDrawable(chatOverlay.TabMap[channel1]));
-
-            AddStep("Close tab via shortcut", pressCloseDocumentKeys);
-            // Channel 1 and channel 2 should be closed
-            AddAssert("All channels closed", () => !channelManager.JoinedChannels.Any());
-        }
-
-        [Test]
-        public void TestNewTabShortcut()
-        {
-            AddStep("Open chat overlay", () => chatOverlay.Show());
-            AddStep("Join 2 channels", () =>
-            {
-                channelManager.JoinChannel(channel1);
-                channelManager.JoinChannel(channel2);
-            });
-
-            // Want to join another channel
-            AddStep("Press new tab shortcut", pressNewTabKeys);
-
-            // Selector should be visible
-            AddAssert("Selector is visible", () => chatOverlay.SelectionOverlayState == Visibility.Visible);
-        }
-
-        [Test]
-        public void TestRestoreTabShortcut()
-        {
-            AddStep("Open chat overlay", () => chatOverlay.Show());
-            AddStep("Join 3 channels", () =>
-            {
-                channelManager.JoinChannel(channel1);
-                channelManager.JoinChannel(channel2);
-                channelManager.JoinChannel(channel3);
-            });
-
-            // Should do nothing
-            AddStep("Restore tab via shortcut", pressRestoreTabKeys);
-            AddAssert("All channels still open", () => channelManager.JoinedChannels.Count == 3);
-
-            // Close channel 1
-            AddStep("Select channel 1", () => clickDrawable(chatOverlay.TabMap[channel1]));
-            AddStep("Click normal close button", () => clickDrawable(((TestChannelTabItem)chatOverlay.TabMap[channel1]).CloseButton.Child));
-            AddAssert("Channel 1 closed", () => !channelManager.JoinedChannels.Contains(channel1));
-            AddAssert("Other channels still open", () => channelManager.JoinedChannels.Count == 2);
-
-            // Reopen channel 1
-            AddStep("Restore tab via shortcut", pressRestoreTabKeys);
-            AddAssert("All channels now open", () => channelManager.JoinedChannels.Count == 3);
-            AddAssert("Current channel is channel 1", () => currentChannel == channel1);
-
-            // Close two channels
-            AddStep("Select channel 1", () => clickDrawable(chatOverlay.TabMap[channel1]));
-            AddStep("Close channel 1", () => clickDrawable(((TestChannelTabItem)chatOverlay.TabMap[channel1]).CloseButton.Child));
-            AddStep("Select channel 2", () => clickDrawable(chatOverlay.TabMap[channel2]));
-            AddStep("Close channel 2", () => clickDrawable(((TestPrivateChannelTabItem)chatOverlay.TabMap[channel2]).CloseButton.Child));
-            AddAssert("Only one channel open", () => channelManager.JoinedChannels.Count == 1);
-            AddAssert("Current channel is channel 3", () => currentChannel == channel3);
-
-            // Should first re-open channel 2
-            AddStep("Restore tab via shortcut", pressRestoreTabKeys);
-            AddAssert("Channel 1 still closed", () => !channelManager.JoinedChannels.Contains(channel1));
-            AddAssert("Channel 2 now open", () => channelManager.JoinedChannels.Contains(channel2));
-            AddAssert("Current channel is channel 2", () => currentChannel == channel2);
-
-            // Should then re-open channel 1
-            AddStep("Restore tab via shortcut", pressRestoreTabKeys);
-            AddAssert("All channels now open", () => channelManager.JoinedChannels.Count == 3);
-            AddAssert("Current channel is channel 1", () => currentChannel == channel1);
-        }
-
-        [Test]
-        public void TestChatCommand()
-        {
-            AddStep("Open chat overlay", () => chatOverlay.Show());
-            AddStep("Join channel 1", () => channelManager.JoinChannel(channel1));
-            AddStep("Select channel 1", () => clickDrawable(chatOverlay.TabMap[channel1]));
-
-            AddStep("Open chat with user", () => channelManager.PostCommand("chat some body"));
-            AddAssert("PM channel is selected", () =>
-                channelManager.CurrentChannel.Value.Type == ChannelType.PM && channelManager.CurrentChannel.Value.Users.Single().Username == "some body");
-
-            AddStep("Open chat with non-existent user", () => channelManager.PostCommand("chat nobody"));
-            AddAssert("Last message is error", () => channelManager.CurrentChannel.Value.Messages.Last() is ErrorMessage);
-
-            // Make sure no unnecessary requests are made when the PM channel is already open.
-            AddStep("Select channel 1", () => clickDrawable(chatOverlay.TabMap[channel1]));
-            AddStep("Unregister request handling", () => ((DummyAPIAccess)API).HandleRequest = null);
-            AddStep("Open chat with user", () => channelManager.PostCommand("chat some body"));
-            AddAssert("PM channel is selected", () =>
-                channelManager.CurrentChannel.Value.Type == ChannelType.PM && channelManager.CurrentChannel.Value.Users.Single().Username == "some body");
-        }
-
-        [Test]
-        public void TestMultiplayerChannelIsNotShown()
-        {
-            Channel multiplayerChannel = null;
-
-            AddStep("open chat overlay", () => chatOverlay.Show());
-
-            AddStep("join multiplayer channel", () => channelManager.JoinChannel(multiplayerChannel = new Channel(new APIUser())
-            {
-                Name = "#mp_1",
-                Type = ChannelType.Multiplayer,
-            }));
-
-            AddAssert("channel joined", () => channelManager.JoinedChannels.Contains(multiplayerChannel));
-            AddAssert("channel not present in overlay", () => !chatOverlay.TabMap.ContainsKey(multiplayerChannel));
-            AddAssert("multiplayer channel is not current", () => channelManager.CurrentChannel.Value != multiplayerChannel);
-
-            AddStep("leave channel", () => channelManager.LeaveChannel(multiplayerChannel));
-            AddAssert("channel left", () => !channelManager.JoinedChannels.Contains(multiplayerChannel));
-        }
-
-        [Test]
-        public void TestHighlightOnCurrentChannel()
-        {
-            Message message = null;
-
-            AddStep("Open chat overlay", () => chatOverlay.Show());
-            AddStep("Join channel 1", () => channelManager.JoinChannel(channel1));
-            AddStep("Select channel 1", () => clickDrawable(chatOverlay.TabMap[channel1]));
-
-            AddStep("Send message in channel 1", () =>
-            {
-                channel1.AddNewMessages(message = new Message
-                {
-                    ChannelId = channel1.Id,
-                    Content = "Message to highlight!",
-                    Timestamp = DateTimeOffset.Now,
-                    Sender = new APIUser
-                    {
-                        Id = 2,
-                        Username = "Someone",
-                    }
-                });
-            });
-
-            AddStep("Highlight message", () => chatOverlay.HighlightMessage(message, channel1));
-        }
-
-        [Test]
-        public void TestHighlightOnAnotherChannel()
-        {
-            Message message = null;
-
-            AddStep("Open chat overlay", () => chatOverlay.Show());
-            AddStep("Join channel 1", () => channelManager.JoinChannel(channel1));
-            AddStep("Select channel 1", () => clickDrawable(chatOverlay.TabMap[channel1]));
-
-            AddStep("Join channel 2", () => channelManager.JoinChannel(channel2));
-            AddStep("Send message in channel 2", () =>
-            {
-                channel2.AddNewMessages(message = new Message
-                {
-                    ChannelId = channel2.Id,
-                    Content = "Message to highlight!",
-                    Timestamp = DateTimeOffset.Now,
-                    Sender = new APIUser
-                    {
-                        Id = 2,
-                        Username = "Someone",
-                    }
-                });
-            });
-
-            AddStep("Highlight message", () => chatOverlay.HighlightMessage(message, channel2));
-            AddAssert("Switched to channel 2", () => channelManager.CurrentChannel.Value == channel2);
-        }
-
-        [Test]
-        public void TestHighlightOnLeftChannel()
-        {
-            Message message = null;
-
-            AddStep("Open chat overlay", () => chatOverlay.Show());
-
-            AddStep("Join channel 1", () => channelManager.JoinChannel(channel1));
-            AddStep("Select channel 1", () => clickDrawable(chatOverlay.TabMap[channel1]));
-
-            AddStep("Join channel 2", () => channelManager.JoinChannel(channel2));
-            AddStep("Send message in channel 2", () =>
-            {
-                channel2.AddNewMessages(message = new Message
-                {
-                    ChannelId = channel2.Id,
-                    Content = "Message to highlight!",
-                    Timestamp = DateTimeOffset.Now,
-                    Sender = new APIUser
-                    {
-                        Id = 2,
-                        Username = "Someone",
-                    }
-                });
-            });
-            AddStep("Leave channel 2", () => channelManager.LeaveChannel(channel2));
-
-            AddStep("Highlight message", () => chatOverlay.HighlightMessage(message, channel2));
-            AddAssert("Switched to channel 2", () => channelManager.CurrentChannel.Value == channel2);
-        }
-
-        [Test]
-        public void TestHighlightWhileChatNeverOpen()
-        {
-            Message message = null;
-
-            AddStep("Join channel 1", () => channelManager.JoinChannel(channel1));
-
-            AddStep("Send message in channel 1", () =>
-            {
-                channel1.AddNewMessages(message = new Message
-                {
-                    ChannelId = channel1.Id,
-                    Content = "Message to highlight!",
-                    Timestamp = DateTimeOffset.Now,
-                    Sender = new APIUser
-                    {
-                        Id = 2,
-                        Username = "Someone",
-                    }
-                });
-            });
-
-            AddStep("Highlight message", () => chatOverlay.HighlightMessage(message, channel1));
-        }
-
-        [Test]
-        public void TestHighlightWithNullChannel()
-        {
-            Message message = null;
-
-            AddStep("Join channel 1", () => channelManager.JoinChannel(channel1));
-
-            AddStep("Send message in channel 1", () =>
-            {
-                channel1.AddNewMessages(message = new Message
-                {
-                    ChannelId = channel1.Id,
-                    Content = "Message to highlight!",
-                    Timestamp = DateTimeOffset.Now,
-                    Sender = new APIUser
-                    {
-                        Id = 2,
-                        Username = "Someone",
-                    }
-                });
-            });
-
-            AddStep("Set null channel", () => channelManager.CurrentChannel.Value = null);
-            AddStep("Highlight message", () => chatOverlay.HighlightMessage(message, channel1));
-        }
-
-        private void pressChannelHotkey(int number)
-        {
-            var channelKey = Key.Number0 + number;
-            InputManager.PressKey(Key.AltLeft);
-            InputManager.Key(channelKey);
-            InputManager.ReleaseKey(Key.AltLeft);
-        }
-
-        private void pressCloseDocumentKeys() => InputManager.Keys(PlatformAction.DocumentClose);
-
-        private void pressNewTabKeys() => InputManager.Keys(PlatformAction.TabNew);
-
-        private void pressRestoreTabKeys() => InputManager.Keys(PlatformAction.TabRestore);
-
-        private void clickDrawable(Drawable d)
-        {
-            InputManager.MoveMouseTo(d);
-            InputManager.Click(MouseButton.Left);
-        }
-
-        private class ChannelManagerContainer : Container
-        {
-            public TestChatOverlay ChatOverlay { get; private set; }
-
-            [Cached]
-            public ChannelManager ChannelManager { get; } = new ChannelManager();
-
-            private readonly List<Channel> channels;
-
-            public ChannelManagerContainer(List<Channel> channels)
-            {
-                this.channels = channels;
-            }
-
-            [BackgroundDependencyLoader]
-            private void load()
-            {
-                ((BindableList<Channel>)ChannelManager.AvailableChannels).AddRange(channels);
-
-                InternalChildren = new Drawable[]
-                {
-                    ChannelManager,
-                    ChatOverlay = new TestChatOverlay { RelativeSizeAxes = Axes.Both, },
-                };
-            }
-        }
-
-        private class TestChatOverlay : ChatOverlay
-        {
-            public Visibility SelectionOverlayState => ChannelSelectionOverlay.State.Value;
-
-            public new ChannelTabControl ChannelTabControl => base.ChannelTabControl;
-
-            public new ChannelSelectionOverlay ChannelSelectionOverlay => base.ChannelSelectionOverlay;
-
-            protected override ChannelTabControl CreateChannelTabControl() => new TestTabControl();
-
-            public IReadOnlyDictionary<Channel, TabItem<Channel>> TabMap => ((TestTabControl)ChannelTabControl).TabMap;
-        }
-
-        private class TestTabControl : ChannelTabControl
-        {
-            protected override TabItem<Channel> CreateTabItem(Channel value)
-            {
-                switch (value.Type)
-                {
-                    case ChannelType.PM:
-                        return new TestPrivateChannelTabItem(value);
-
-                    default:
-                        return new TestChannelTabItem(value);
-                }
-            }
-
-            public new IReadOnlyDictionary<Channel, TabItem<Channel>> TabMap => base.TabMap;
-        }
-
-        private class TestChannelTabItem : ChannelTabItem
-        {
-            public TestChannelTabItem(Channel channel)
-                : base(channel)
-            {
-            }
-
-            public new ClickableContainer CloseButton => base.CloseButton;
-        }
-
-        private class TestPrivateChannelTabItem : PrivateChannelTabItem
-        {
-            public TestPrivateChannelTabItem(Channel channel)
-                : base(channel)
-            {
-            }
-
-            public new ClickableContainer CloseButton => base.CloseButton;
-        }
-    }
-}
diff --git a/osu.Game/Online/Chat/ChannelManager.cs b/osu.Game/Online/Chat/ChannelManager.cs
index b7d67de04d..31f67bcecc 100644
--- a/osu.Game/Online/Chat/ChannelManager.cs
+++ b/osu.Game/Online/Chat/ChannelManager.cs
@@ -15,7 +15,6 @@ using osu.Game.Online.API;
 using osu.Game.Online.API.Requests;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays.Chat.Listing;
-using osu.Game.Overlays.Chat.Tabs;
 
 namespace osu.Game.Online.Chat
 {
@@ -134,7 +133,7 @@ namespace osu.Game.Online.Chat
 
         private void currentChannelChanged(ValueChangedEvent<Channel> e)
         {
-            bool isSelectorChannel = e.NewValue is ChannelSelectorTabItem.ChannelSelectorTabChannel || e.NewValue is ChannelListing.ChannelListingChannel;
+            bool isSelectorChannel = e.NewValue is ChannelListing.ChannelListingChannel;
 
             if (!isSelectorChannel)
                 JoinChannel(e.NewValue);
diff --git a/osu.Game/Overlays/Chat/Selection/ChannelListItem.cs b/osu.Game/Overlays/Chat/Selection/ChannelListItem.cs
deleted file mode 100644
index 59989ade7b..0000000000
--- a/osu.Game/Overlays/Chat/Selection/ChannelListItem.cs
+++ /dev/null
@@ -1,191 +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 osuTK;
-using osuTK.Graphics;
-using osu.Framework.Allocation;
-using osu.Framework.Bindables;
-using osu.Framework.Graphics;
-using osu.Framework.Graphics.Containers;
-using osu.Framework.Graphics.Sprites;
-using osu.Framework.Input.Events;
-using osu.Framework.Localisation;
-using osu.Game.Graphics;
-using osu.Game.Graphics.Sprites;
-using osu.Game.Online.Chat;
-using osu.Game.Graphics.Containers;
-
-namespace osu.Game.Overlays.Chat.Selection
-{
-    public class ChannelListItem : OsuClickableContainer, IFilterable
-    {
-        private const float width_padding = 5;
-        private const float channel_width = 150;
-        private const float text_size = 15;
-        private const float transition_duration = 100;
-
-        public readonly Channel Channel;
-
-        private readonly Bindable<bool> joinedBind = new Bindable<bool>();
-        private readonly OsuSpriteText name;
-        private readonly OsuSpriteText topic;
-        private readonly SpriteIcon joinedCheckmark;
-
-        private Color4 joinedColour;
-        private Color4 topicColour;
-        private Color4 hoverColour;
-
-        public IEnumerable<LocalisableString> FilterTerms => new LocalisableString[] { Channel.Name, Channel.Topic ?? string.Empty };
-
-        public bool MatchingFilter
-        {
-            set => this.FadeTo(value ? 1f : 0f, 100);
-        }
-
-        public bool FilteringActive { get; set; }
-
-        public Action<Channel> OnRequestJoin;
-        public Action<Channel> OnRequestLeave;
-
-        public ChannelListItem(Channel channel)
-        {
-            Channel = channel;
-
-            RelativeSizeAxes = Axes.X;
-            AutoSizeAxes = Axes.Y;
-
-            Action = () => { (channel.Joined.Value ? OnRequestLeave : OnRequestJoin)?.Invoke(channel); };
-
-            Children = new Drawable[]
-            {
-                new FillFlowContainer
-                {
-                    RelativeSizeAxes = Axes.X,
-                    AutoSizeAxes = Axes.Y,
-                    Direction = FillDirection.Horizontal,
-                    Children = new Drawable[]
-                    {
-                        new Container
-                        {
-                            Children = new[]
-                            {
-                                joinedCheckmark = new SpriteIcon
-                                {
-                                    Anchor = Anchor.TopRight,
-                                    Origin = Anchor.TopRight,
-                                    Icon = FontAwesome.Solid.CheckCircle,
-                                    Size = new Vector2(text_size),
-                                    Shadow = false,
-                                    Margin = new MarginPadding { Right = 10f },
-                                },
-                            },
-                        },
-                        new Container
-                        {
-                            Width = channel_width,
-                            AutoSizeAxes = Axes.Y,
-                            Children = new[]
-                            {
-                                name = new OsuSpriteText
-                                {
-                                    Text = channel.ToString(),
-                                    Font = OsuFont.GetFont(size: text_size, weight: FontWeight.Bold),
-                                    Shadow = false,
-                                },
-                            },
-                        },
-                        new Container
-                        {
-                            RelativeSizeAxes = Axes.X,
-                            Width = 0.7f,
-                            AutoSizeAxes = Axes.Y,
-                            Margin = new MarginPadding { Left = width_padding },
-                            Children = new[]
-                            {
-                                topic = new OsuSpriteText
-                                {
-                                    Text = channel.Topic,
-                                    Font = OsuFont.GetFont(size: text_size, weight: FontWeight.SemiBold),
-                                    Shadow = false,
-                                },
-                            },
-                        },
-                        new FillFlowContainer
-                        {
-                            AutoSizeAxes = Axes.Both,
-                            Direction = FillDirection.Horizontal,
-                            Margin = new MarginPadding { Left = width_padding },
-                            Spacing = new Vector2(3f, 0f),
-                            Children = new Drawable[]
-                            {
-                                new SpriteIcon
-                                {
-                                    Anchor = Anchor.CentreLeft,
-                                    Origin = Anchor.CentreLeft,
-                                    Icon = FontAwesome.Solid.User,
-                                    Size = new Vector2(text_size - 2),
-                                    Shadow = false,
-                                },
-                                new OsuSpriteText
-                                {
-                                    Text = @"0",
-                                    Font = OsuFont.GetFont(size: text_size, weight: FontWeight.SemiBold),
-                                    Shadow = false,
-                                },
-                            },
-                        },
-                    },
-                },
-            };
-        }
-
-        [BackgroundDependencyLoader]
-        private void load(OsuColour colours)
-        {
-            topicColour = colours.Gray9;
-            joinedColour = colours.Blue;
-            hoverColour = colours.Yellow;
-
-            joinedBind.ValueChanged += joined => updateColour(joined.NewValue);
-            joinedBind.BindTo(Channel.Joined);
-
-            joinedBind.TriggerChange();
-            FinishTransforms(true);
-        }
-
-        protected override bool OnHover(HoverEvent e)
-        {
-            if (!Channel.Joined.Value)
-                name.FadeColour(hoverColour, 50, Easing.OutQuint);
-
-            return base.OnHover(e);
-        }
-
-        protected override void OnHoverLost(HoverLostEvent e)
-        {
-            if (!Channel.Joined.Value)
-                name.FadeColour(Color4.White, transition_duration);
-        }
-
-        private void updateColour(bool joined)
-        {
-            if (joined)
-            {
-                name.FadeColour(Color4.White, transition_duration);
-                joinedCheckmark.FadeTo(1f, transition_duration);
-                topic.FadeTo(0.8f, transition_duration);
-                topic.FadeColour(Color4.White, transition_duration);
-                this.FadeColour(joinedColour, transition_duration);
-            }
-            else
-            {
-                joinedCheckmark.FadeTo(0f, transition_duration);
-                topic.FadeTo(1f, transition_duration);
-                topic.FadeColour(topicColour, transition_duration);
-                this.FadeColour(Color4.White, transition_duration);
-            }
-        }
-    }
-}
diff --git a/osu.Game/Overlays/Chat/Selection/ChannelSection.cs b/osu.Game/Overlays/Chat/Selection/ChannelSection.cs
deleted file mode 100644
index 070332180c..0000000000
--- a/osu.Game/Overlays/Chat/Selection/ChannelSection.cs
+++ /dev/null
@@ -1,58 +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.Framework.Graphics.Containers;
-using osu.Framework.Localisation;
-using osu.Game.Graphics;
-using osu.Game.Graphics.Sprites;
-using osu.Game.Online.Chat;
-using osuTK;
-
-namespace osu.Game.Overlays.Chat.Selection
-{
-    public class ChannelSection : Container, IHasFilterableChildren
-    {
-        public readonly FillFlowContainer<ChannelListItem> ChannelFlow;
-
-        public IEnumerable<IFilterable> FilterableChildren => ChannelFlow.Children;
-        public IEnumerable<LocalisableString> FilterTerms => Array.Empty<LocalisableString>();
-
-        public bool MatchingFilter
-        {
-            set => this.FadeTo(value ? 1f : 0f, 100);
-        }
-
-        public bool FilteringActive { get; set; }
-
-        public IEnumerable<Channel> Channels
-        {
-            set => ChannelFlow.ChildrenEnumerable = value.Select(c => new ChannelListItem(c));
-        }
-
-        public ChannelSection()
-        {
-            RelativeSizeAxes = Axes.X;
-            AutoSizeAxes = Axes.Y;
-
-            Children = new Drawable[]
-            {
-                new OsuSpriteText
-                {
-                    Font = OsuFont.GetFont(size: 15, weight: FontWeight.Bold),
-                    Text = "All Channels".ToUpperInvariant()
-                },
-                ChannelFlow = new FillFlowContainer<ChannelListItem>
-                {
-                    RelativeSizeAxes = Axes.X,
-                    AutoSizeAxes = Axes.Y,
-                    Margin = new MarginPadding { Top = 25 },
-                    Spacing = new Vector2(0f, 5f),
-                },
-            };
-        }
-    }
-}
diff --git a/osu.Game/Overlays/Chat/Selection/ChannelSelectionOverlay.cs b/osu.Game/Overlays/Chat/Selection/ChannelSelectionOverlay.cs
deleted file mode 100644
index 9b0354e264..0000000000
--- a/osu.Game/Overlays/Chat/Selection/ChannelSelectionOverlay.cs
+++ /dev/null
@@ -1,194 +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 osuTK;
-using osuTK.Graphics;
-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.Input.Events;
-using osu.Game.Graphics;
-using osu.Game.Graphics.Backgrounds;
-using osu.Game.Graphics.Sprites;
-using osu.Game.Graphics.UserInterface;
-using osu.Game.Online.Chat;
-using osu.Game.Graphics.Containers;
-
-namespace osu.Game.Overlays.Chat.Selection
-{
-    public class ChannelSelectionOverlay : WaveOverlayContainer
-    {
-        public new const float WIDTH_PADDING = 170;
-
-        private const float transition_duration = 500;
-
-        private readonly Box bg;
-        private readonly Triangles triangles;
-        private readonly Box headerBg;
-        private readonly SearchTextBox search;
-        private readonly SearchContainer<ChannelSection> sectionsFlow;
-
-        protected override bool DimMainContent => false;
-
-        public Action<Channel> OnRequestJoin;
-        public Action<Channel> OnRequestLeave;
-
-        public ChannelSelectionOverlay()
-        {
-            RelativeSizeAxes = Axes.X;
-
-            Waves.FirstWaveColour = Color4Extensions.FromHex("353535");
-            Waves.SecondWaveColour = Color4Extensions.FromHex("434343");
-            Waves.ThirdWaveColour = Color4Extensions.FromHex("515151");
-            Waves.FourthWaveColour = Color4Extensions.FromHex("595959");
-
-            Children = new Drawable[]
-            {
-                new Container
-                {
-                    RelativeSizeAxes = Axes.Both,
-                    Masking = true,
-                    Children = new Drawable[]
-                    {
-                        bg = new Box
-                        {
-                            RelativeSizeAxes = Axes.Both,
-                        },
-                        triangles = new Triangles
-                        {
-                            RelativeSizeAxes = Axes.Both,
-                            TriangleScale = 5,
-                        },
-                    },
-                },
-                new Container
-                {
-                    RelativeSizeAxes = Axes.Both,
-                    Padding = new MarginPadding { Top = 85, Right = WIDTH_PADDING },
-                    Children = new[]
-                    {
-                        new OsuScrollContainer
-                        {
-                            RelativeSizeAxes = Axes.Both,
-                            Children = new[]
-                            {
-                                sectionsFlow = new SearchContainer<ChannelSection>
-                                {
-                                    RelativeSizeAxes = Axes.X,
-                                    AutoSizeAxes = Axes.Y,
-                                    Direction = FillDirection.Vertical,
-                                    LayoutDuration = 200,
-                                    LayoutEasing = Easing.OutQuint,
-                                    Spacing = new Vector2(0f, 20f),
-                                    Padding = new MarginPadding { Vertical = 20, Left = WIDTH_PADDING },
-                                },
-                            },
-                        },
-                    },
-                },
-                new Container
-                {
-                    RelativeSizeAxes = Axes.X,
-                    AutoSizeAxes = Axes.Y,
-                    Children = new Drawable[]
-                    {
-                        headerBg = new Box
-                        {
-                            RelativeSizeAxes = Axes.Both,
-                        },
-                        new FillFlowContainer
-                        {
-                            RelativeSizeAxes = Axes.X,
-                            AutoSizeAxes = Axes.Y,
-                            Direction = FillDirection.Vertical,
-                            Spacing = new Vector2(0f, 10f),
-                            Padding = new MarginPadding { Top = 10f, Bottom = 10f, Left = WIDTH_PADDING, Right = WIDTH_PADDING },
-                            Children = new Drawable[]
-                            {
-                                new OsuSpriteText
-                                {
-                                    Text = @"Chat Channels",
-                                    Font = OsuFont.GetFont(size: 20),
-                                    Shadow = false,
-                                },
-                                search = new HeaderSearchTextBox { RelativeSizeAxes = Axes.X },
-                            },
-                        },
-                    },
-                },
-            };
-
-            search.Current.ValueChanged += term => sectionsFlow.SearchTerm = term.NewValue;
-        }
-
-        public void UpdateAvailableChannels(IEnumerable<Channel> channels)
-        {
-            Scheduler.Add(() =>
-            {
-                sectionsFlow.ChildrenEnumerable = new[]
-                {
-                    new ChannelSection { Channels = channels, },
-                };
-
-                foreach (ChannelSection s in sectionsFlow.Children)
-                {
-                    foreach (ChannelListItem c in s.ChannelFlow.Children)
-                    {
-                        c.OnRequestJoin = channel => { OnRequestJoin?.Invoke(channel); };
-                        c.OnRequestLeave = channel => { OnRequestLeave?.Invoke(channel); };
-                    }
-                }
-            });
-        }
-
-        [BackgroundDependencyLoader]
-        private void load(OsuColour colours)
-        {
-            bg.Colour = colours.Gray3;
-            triangles.ColourDark = colours.Gray3;
-            triangles.ColourLight = Color4Extensions.FromHex(@"353535");
-
-            headerBg.Colour = colours.Gray2.Opacity(0.75f);
-        }
-
-        protected override void OnFocus(FocusEvent e)
-        {
-            search.TakeFocus();
-            base.OnFocus(e);
-        }
-
-        protected override void PopIn()
-        {
-            if (Alpha == 0) this.MoveToY(DrawHeight);
-
-            this.FadeIn(transition_duration, Easing.OutQuint);
-            this.MoveToY(0, transition_duration, Easing.OutQuint);
-
-            search.HoldFocus = true;
-            base.PopIn();
-        }
-
-        protected override void PopOut()
-        {
-            this.FadeOut(transition_duration, Easing.InSine);
-            this.MoveToY(DrawHeight, transition_duration, Easing.InSine);
-
-            search.HoldFocus = false;
-            base.PopOut();
-        }
-
-        private class HeaderSearchTextBox : BasicSearchTextBox
-        {
-            [BackgroundDependencyLoader]
-            private void load()
-            {
-                BackgroundFocused = Color4.Black.Opacity(0.2f);
-                BackgroundUnfocused = Color4.Black.Opacity(0.2f);
-            }
-        }
-    }
-}
diff --git a/osu.Game/Overlays/Chat/Tabs/ChannelSelectorTabItem.cs b/osu.Game/Overlays/Chat/Tabs/ChannelSelectorTabItem.cs
deleted file mode 100644
index e3ede04edd..0000000000
--- a/osu.Game/Overlays/Chat/Tabs/ChannelSelectorTabItem.cs
+++ /dev/null
@@ -1,46 +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.Game.Graphics;
-using osu.Game.Online.Chat;
-
-namespace osu.Game.Overlays.Chat.Tabs
-{
-    public class ChannelSelectorTabItem : ChannelTabItem
-    {
-        public override bool IsRemovable => false;
-
-        public override bool IsSwitchable => false;
-
-        protected override bool IsBoldWhenActive => false;
-
-        public ChannelSelectorTabItem()
-            : base(new ChannelSelectorTabChannel())
-        {
-            Depth = float.MaxValue;
-            Width = 45;
-
-            Icon.Alpha = 0;
-
-            Text.Font = Text.Font.With(size: 45);
-            Text.Truncate = false;
-        }
-
-        [BackgroundDependencyLoader]
-        private void load(OsuColour colour)
-        {
-            BackgroundInactive = colour.Gray2;
-            BackgroundActive = colour.Gray3;
-        }
-
-        public class ChannelSelectorTabChannel : Channel
-        {
-            public ChannelSelectorTabChannel()
-            {
-                Name = "+";
-                Type = ChannelType.System;
-            }
-        }
-    }
-}
diff --git a/osu.Game/Overlays/Chat/Tabs/ChannelTabControl.cs b/osu.Game/Overlays/Chat/Tabs/ChannelTabControl.cs
deleted file mode 100644
index c0de093425..0000000000
--- a/osu.Game/Overlays/Chat/Tabs/ChannelTabControl.cs
+++ /dev/null
@@ -1,114 +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.UserInterface;
-using osu.Game.Graphics.UserInterface;
-using osu.Game.Online.Chat;
-using osuTK;
-using System;
-using System.Linq;
-using osu.Framework.Bindables;
-using osu.Framework.Graphics.Containers;
-
-namespace osu.Game.Overlays.Chat.Tabs
-{
-    public class ChannelTabControl : OsuTabControl<Channel>
-    {
-        public const float SHEAR_WIDTH = 10;
-
-        public Action<Channel> OnRequestLeave;
-
-        public readonly Bindable<bool> ChannelSelectorActive = new Bindable<bool>();
-
-        private readonly ChannelSelectorTabItem selectorTab;
-
-        public ChannelTabControl()
-        {
-            Padding = new MarginPadding { Left = 50 };
-
-            TabContainer.Spacing = new Vector2(-SHEAR_WIDTH, 0);
-            TabContainer.Masking = false;
-
-            AddTabItem(selectorTab = new ChannelSelectorTabItem());
-
-            ChannelSelectorActive.BindTo(selectorTab.Active);
-        }
-
-        protected override void AddTabItem(TabItem<Channel> item, bool addToDropdown = true)
-        {
-            if (item != selectorTab && TabContainer.GetLayoutPosition(selectorTab) < float.MaxValue)
-                // performTabSort might've made selectorTab's position wonky, fix it
-                TabContainer.SetLayoutPosition(selectorTab, float.MaxValue);
-
-            ((ChannelTabItem)item).OnRequestClose += channelItem => OnRequestLeave?.Invoke(channelItem.Value);
-
-            base.AddTabItem(item, addToDropdown);
-        }
-
-        protected override TabItem<Channel> CreateTabItem(Channel value)
-        {
-            switch (value.Type)
-            {
-                default:
-                    return new ChannelTabItem(value);
-
-                case ChannelType.PM:
-                    return new PrivateChannelTabItem(value);
-            }
-        }
-
-        /// <summary>
-        /// Adds a channel to the ChannelTabControl.
-        /// The first channel added will automaticly selected.
-        /// </summary>
-        /// <param name="channel">The channel that is going to be added.</param>
-        public void AddChannel(Channel channel)
-        {
-            if (!Items.Contains(channel))
-                AddItem(channel);
-
-            Current.Value ??= channel;
-        }
-
-        /// <summary>
-        /// Removes a channel from the ChannelTabControl.
-        /// If the selected channel is the one that is being removed, the next available channel will be selected.
-        /// </summary>
-        /// <param name="channel">The channel that is going to be removed.</param>
-        public void RemoveChannel(Channel channel)
-        {
-            RemoveItem(channel);
-
-            if (SelectedTab == null)
-                SelectChannelSelectorTab();
-        }
-
-        public void SelectChannelSelectorTab() => SelectTab(selectorTab);
-
-        protected override void SelectTab(TabItem<Channel> tab)
-        {
-            if (tab is ChannelSelectorTabItem)
-            {
-                tab.Active.Value = true;
-                return;
-            }
-
-            base.SelectTab(tab);
-            selectorTab.Active.Value = false;
-        }
-
-        protected override TabFillFlowContainer CreateTabFlow() => new ChannelTabFillFlowContainer
-        {
-            Direction = FillDirection.Full,
-            RelativeSizeAxes = Axes.Both,
-            Depth = -1,
-            Masking = true
-        };
-
-        private class ChannelTabFillFlowContainer : TabFillFlowContainer
-        {
-            protected override int Compare(Drawable x, Drawable y) => CompareReverseChildID(x, y);
-        }
-    }
-}
diff --git a/osu.Game/Overlays/Chat/Tabs/ChannelTabItem.cs b/osu.Game/Overlays/Chat/Tabs/ChannelTabItem.cs
deleted file mode 100644
index 9d2cd8a21d..0000000000
--- a/osu.Game/Overlays/Chat/Tabs/ChannelTabItem.cs
+++ /dev/null
@@ -1,238 +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 osu.Framework.Allocation;
-using osu.Framework.Audio;
-using osu.Framework.Audio.Sample;
-using osu.Framework.Extensions;
-using osu.Framework.Extensions.Color4Extensions;
-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.Framework.Input.Events;
-using osu.Game.Graphics;
-using osu.Game.Graphics.Sprites;
-using osu.Game.Graphics.UserInterface;
-using osu.Game.Online.Chat;
-using osuTK;
-using osuTK.Graphics;
-using osuTK.Input;
-
-namespace osu.Game.Overlays.Chat.Tabs
-{
-    public class ChannelTabItem : TabItem<Channel>
-    {
-        protected Color4 BackgroundInactive;
-        private Color4 backgroundHover;
-        protected Color4 BackgroundActive;
-
-        public override bool IsRemovable => !Pinned;
-
-        protected readonly SpriteText Text;
-        protected readonly ClickableContainer CloseButton;
-        private readonly Box box;
-        private readonly Box highlightBox;
-        protected readonly SpriteIcon Icon;
-
-        public Action<ChannelTabItem> OnRequestClose;
-        private readonly Container content;
-
-        protected override Container<Drawable> Content => content;
-
-        private Sample sampleTabSwitched;
-
-        public ChannelTabItem(Channel value)
-            : base(value)
-        {
-            Width = 150;
-
-            RelativeSizeAxes = Axes.Y;
-
-            Anchor = Anchor.BottomLeft;
-            Origin = Anchor.BottomLeft;
-
-            Shear = new Vector2(ChannelTabControl.SHEAR_WIDTH / ChatOverlay.TAB_AREA_HEIGHT, 0);
-
-            Masking = true;
-
-            InternalChildren = new Drawable[]
-            {
-                box = new Box
-                {
-                    EdgeSmoothness = new Vector2(1, 0),
-                    RelativeSizeAxes = Axes.Both,
-                },
-                highlightBox = new Box
-                {
-                    Width = 5,
-                    Alpha = 0,
-                    Anchor = Anchor.BottomRight,
-                    Origin = Anchor.BottomRight,
-                    EdgeSmoothness = new Vector2(1, 0),
-                    RelativeSizeAxes = Axes.Y,
-                },
-                content = new Container
-                {
-                    Shear = new Vector2(-ChannelTabControl.SHEAR_WIDTH / ChatOverlay.TAB_AREA_HEIGHT, 0),
-                    RelativeSizeAxes = Axes.Both,
-                    Children = new Drawable[]
-                    {
-                        Icon = new SpriteIcon
-                        {
-                            Icon = DisplayIcon,
-                            Anchor = Anchor.CentreLeft,
-                            Origin = Anchor.CentreLeft,
-                            Colour = Color4.Black,
-                            X = -10,
-                            Alpha = 0.2f,
-                            Size = new Vector2(ChatOverlay.TAB_AREA_HEIGHT),
-                        },
-                        Text = new OsuSpriteText
-                        {
-                            Origin = Anchor.CentreLeft,
-                            Anchor = Anchor.CentreLeft,
-                            Text = value.ToString(),
-                            Font = OsuFont.GetFont(size: 18),
-                            Padding = new MarginPadding(5)
-                            {
-                                Left = LeftTextPadding,
-                                Right = RightTextPadding,
-                            },
-                            RelativeSizeAxes = Axes.X,
-                            Truncate = true,
-                        },
-                        CloseButton = new TabCloseButton
-                        {
-                            Alpha = 0,
-                            Margin = new MarginPadding { Right = 20 },
-                            Origin = Anchor.CentreRight,
-                            Anchor = Anchor.CentreRight,
-                            Action = delegate
-                            {
-                                if (IsRemovable) OnRequestClose?.Invoke(this);
-                            },
-                        },
-                    },
-                },
-                new HoverSounds()
-            };
-        }
-
-        protected virtual float LeftTextPadding => 5;
-
-        protected virtual float RightTextPadding => IsRemovable ? 40 : 5;
-
-        protected virtual IconUsage DisplayIcon => FontAwesome.Solid.Hashtag;
-
-        protected virtual bool ShowCloseOnHover => true;
-
-        protected virtual bool IsBoldWhenActive => true;
-
-        protected override bool OnHover(HoverEvent e)
-        {
-            if (IsRemovable && ShowCloseOnHover)
-                CloseButton.FadeIn(200, Easing.OutQuint);
-
-            if (!Active.Value)
-                box.FadeColour(backgroundHover, TRANSITION_LENGTH, Easing.OutQuint);
-            return true;
-        }
-
-        protected override void OnHoverLost(HoverLostEvent e)
-        {
-            CloseButton.FadeOut(200, Easing.OutQuint);
-            updateState();
-        }
-
-        protected override void OnMouseUp(MouseUpEvent e)
-        {
-            switch (e.Button)
-            {
-                case MouseButton.Middle:
-                    CloseButton.TriggerClick();
-                    break;
-            }
-        }
-
-        [BackgroundDependencyLoader]
-        private void load(OsuColour colours, AudioManager audio)
-        {
-            BackgroundActive = colours.ChatBlue;
-            BackgroundInactive = colours.Gray4;
-            backgroundHover = colours.Gray7;
-            sampleTabSwitched = audio.Samples.Get($@"UI/{HoverSampleSet.Default.GetDescription()}-select");
-
-            highlightBox.Colour = colours.Yellow;
-        }
-
-        protected override void LoadComplete()
-        {
-            base.LoadComplete();
-
-            updateState();
-            FinishTransforms(true);
-        }
-
-        private void updateState()
-        {
-            if (Active.Value)
-                FadeActive();
-            else
-                FadeInactive();
-        }
-
-        protected const float TRANSITION_LENGTH = 400;
-
-        private readonly EdgeEffectParameters activateEdgeEffect = new EdgeEffectParameters
-        {
-            Type = EdgeEffectType.Shadow,
-            Radius = 15,
-            Colour = Color4.Black.Opacity(0.4f),
-        };
-
-        private readonly EdgeEffectParameters deactivateEdgeEffect = new EdgeEffectParameters
-        {
-            Type = EdgeEffectType.Shadow,
-            Radius = 10,
-            Colour = Color4.Black.Opacity(0.2f),
-        };
-
-        protected virtual void FadeActive()
-        {
-            this.ResizeHeightTo(1.1f, TRANSITION_LENGTH, Easing.OutQuint);
-
-            TweenEdgeEffectTo(activateEdgeEffect, TRANSITION_LENGTH);
-
-            box.FadeColour(BackgroundActive, TRANSITION_LENGTH, Easing.OutQuint);
-            highlightBox.FadeIn(TRANSITION_LENGTH, Easing.OutQuint);
-
-            if (IsBoldWhenActive) Text.Font = Text.Font.With(weight: FontWeight.Bold);
-        }
-
-        protected virtual void FadeInactive()
-        {
-            this.ResizeHeightTo(1, TRANSITION_LENGTH, Easing.OutQuint);
-
-            TweenEdgeEffectTo(deactivateEdgeEffect, TRANSITION_LENGTH);
-
-            box.FadeColour(IsHovered ? backgroundHover : BackgroundInactive, TRANSITION_LENGTH, Easing.OutQuint);
-            highlightBox.FadeOut(TRANSITION_LENGTH, Easing.OutQuint);
-
-            Text.Font = Text.Font.With(weight: FontWeight.Medium);
-        }
-
-        protected override void OnActivated()
-        {
-            if (IsLoaded)
-                sampleTabSwitched?.Play();
-
-            updateState();
-        }
-
-        protected override void OnDeactivated() => updateState();
-    }
-}
diff --git a/osu.Game/Overlays/Chat/Tabs/PrivateChannelTabItem.cs b/osu.Game/Overlays/Chat/Tabs/PrivateChannelTabItem.cs
deleted file mode 100644
index d01aec630e..0000000000
--- a/osu.Game/Overlays/Chat/Tabs/PrivateChannelTabItem.cs
+++ /dev/null
@@ -1,95 +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.Linq;
-using osu.Framework.Allocation;
-using osu.Framework.Extensions.Color4Extensions;
-using osu.Framework.Graphics;
-using osu.Framework.Graphics.Containers;
-using osu.Framework.Graphics.Sprites;
-using osu.Game.Graphics;
-using osu.Game.Online.Chat;
-using osu.Game.Users.Drawables;
-using osuTK;
-
-namespace osu.Game.Overlays.Chat.Tabs
-{
-    public class PrivateChannelTabItem : ChannelTabItem
-    {
-        protected override IconUsage DisplayIcon => FontAwesome.Solid.At;
-
-        public PrivateChannelTabItem(Channel value)
-            : base(value)
-        {
-            if (value.Type != ChannelType.PM)
-                throw new ArgumentException("Argument value needs to have the targettype user!");
-
-            DrawableAvatar avatar;
-
-            AddRange(new Drawable[]
-            {
-                new Container
-                {
-                    RelativeSizeAxes = Axes.Y,
-                    AutoSizeAxes = Axes.X,
-                    Margin = new MarginPadding
-                    {
-                        Horizontal = 3
-                    },
-                    Origin = Anchor.BottomLeft,
-                    Anchor = Anchor.BottomLeft,
-                    Children = new Drawable[]
-                    {
-                        new CircularContainer
-                        {
-                            Scale = new Vector2(0.95f),
-                            Size = new Vector2(ChatOverlay.TAB_AREA_HEIGHT),
-                            Anchor = Anchor.Centre,
-                            Origin = Anchor.Centre,
-                            Masking = true,
-                            Child = new DelayedLoadWrapper(avatar = new DrawableAvatar(value.Users.First())
-                            {
-                                RelativeSizeAxes = Axes.Both
-                            })
-                            {
-                                RelativeSizeAxes = Axes.Both,
-                            }
-                        },
-                    }
-                },
-            });
-
-            avatar.OnLoadComplete += d => d.FadeInFromZero(300, Easing.OutQuint);
-        }
-
-        protected override float LeftTextPadding => base.LeftTextPadding + ChatOverlay.TAB_AREA_HEIGHT;
-
-        protected override bool ShowCloseOnHover => false;
-
-        protected override void FadeActive()
-        {
-            base.FadeActive();
-
-            this.ResizeWidthTo(200, TRANSITION_LENGTH, Easing.OutQuint);
-            CloseButton.FadeIn(TRANSITION_LENGTH, Easing.OutQuint);
-        }
-
-        protected override void FadeInactive()
-        {
-            base.FadeInactive();
-
-            this.ResizeWidthTo(ChatOverlay.TAB_AREA_HEIGHT + 10, TRANSITION_LENGTH, Easing.OutQuint);
-            CloseButton.FadeOut(TRANSITION_LENGTH, Easing.OutQuint);
-        }
-
-        [BackgroundDependencyLoader]
-        private void load(OsuColour colours)
-        {
-            var user = Value.Users.First();
-
-            BackgroundActive = user.Colour != null ? Color4Extensions.FromHex(user.Colour) : colours.BlueDark;
-            BackgroundInactive = BackgroundActive.Darken(0.5f);
-        }
-    }
-}
diff --git a/osu.Game/Overlays/Chat/Tabs/TabCloseButton.cs b/osu.Game/Overlays/Chat/Tabs/TabCloseButton.cs
deleted file mode 100644
index 178afda5ac..0000000000
--- a/osu.Game/Overlays/Chat/Tabs/TabCloseButton.cs
+++ /dev/null
@@ -1,55 +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.Sprites;
-using osu.Framework.Input.Events;
-using osu.Game.Graphics.Containers;
-using osuTK;
-using osuTK.Graphics;
-
-namespace osu.Game.Overlays.Chat.Tabs
-{
-    public class TabCloseButton : OsuClickableContainer
-    {
-        private readonly SpriteIcon icon;
-
-        public TabCloseButton()
-        {
-            Size = new Vector2(20);
-
-            Child = icon = new SpriteIcon
-            {
-                Anchor = Anchor.Centre,
-                Origin = Anchor.Centre,
-                Scale = new Vector2(0.75f),
-                Icon = FontAwesome.Solid.TimesCircle,
-                RelativeSizeAxes = Axes.Both,
-            };
-        }
-
-        protected override bool OnMouseDown(MouseDownEvent e)
-        {
-            icon.ScaleTo(0.5f, 1000, Easing.OutQuint);
-            return base.OnMouseDown(e);
-        }
-
-        protected override void OnMouseUp(MouseUpEvent e)
-        {
-            icon.ScaleTo(0.75f, 1000, Easing.OutElastic);
-            base.OnMouseUp(e);
-        }
-
-        protected override bool OnHover(HoverEvent e)
-        {
-            icon.FadeColour(Color4.Red, 200, Easing.OutQuint);
-            return base.OnHover(e);
-        }
-
-        protected override void OnHoverLost(HoverLostEvent e)
-        {
-            icon.FadeColour(Color4.White, 200, Easing.OutQuint);
-            base.OnHoverLost(e);
-        }
-    }
-}
diff --git a/osu.Game/Overlays/ChatOverlay.cs b/osu.Game/Overlays/ChatOverlay.cs
deleted file mode 100644
index 034670cf37..0000000000
--- a/osu.Game/Overlays/ChatOverlay.cs
+++ /dev/null
@@ -1,525 +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.Collections.Generic;
-using System.Collections.Specialized;
-using System.Diagnostics;
-using System.Linq;
-using osuTK;
-using osuTK.Graphics;
-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.Graphics.UserInterface;
-using osu.Framework.Input.Events;
-using osu.Game.Configuration;
-using osu.Game.Graphics;
-using osu.Game.Graphics.Containers;
-using osu.Game.Graphics.UserInterface;
-using osu.Game.Online.Chat;
-using osu.Game.Overlays.Chat;
-using osu.Game.Overlays.Chat.Selection;
-using osu.Game.Overlays.Chat.Tabs;
-using osuTK.Input;
-using osu.Framework.Graphics.Sprites;
-using osu.Framework.Graphics.Textures;
-using osu.Framework.Input;
-using osu.Framework.Input.Bindings;
-using osu.Framework.Localisation;
-using osu.Game.Localisation;
-using osu.Game.Online;
-
-namespace osu.Game.Overlays
-{
-    public class ChatOverlay : OsuFocusedOverlayContainer, INamedOverlayComponent, IKeyBindingHandler<PlatformAction>
-    {
-        public string IconTexture => "Icons/Hexacons/messaging";
-        public LocalisableString Title => ChatStrings.HeaderTitle;
-        public LocalisableString Description => ChatStrings.HeaderDescription;
-
-        private const float text_box_height = 60;
-        private const float channel_selection_min_height = 0.3f;
-
-        [Resolved]
-        private ChannelManager channelManager { get; set; }
-
-        private Container<DrawableChannel> currentChannelContainer;
-
-        private readonly List<DrawableChannel> loadedChannels = new List<DrawableChannel>();
-
-        private LoadingSpinner loading;
-
-        private FocusedTextBox textBox;
-
-        private const int transition_length = 500;
-
-        public const float DEFAULT_HEIGHT = 0.4f;
-
-        public const float TAB_AREA_HEIGHT = 50;
-
-        protected ChannelTabControl ChannelTabControl;
-
-        protected virtual ChannelTabControl CreateChannelTabControl() => new ChannelTabControl();
-
-        private Container chatContainer;
-        private TabsArea tabsArea;
-        private Box chatBackground;
-        private Box tabBackground;
-
-        public Bindable<float> ChatHeight { get; set; }
-
-        private Container channelSelectionContainer;
-        protected ChannelSelectionOverlay ChannelSelectionOverlay;
-
-        private readonly IBindableList<Channel> availableChannels = new BindableList<Channel>();
-        private readonly IBindableList<Channel> joinedChannels = new BindableList<Channel>();
-        private readonly Bindable<Channel> currentChannel = new Bindable<Channel>();
-
-        public override bool Contains(Vector2 screenSpacePos) => chatContainer.ReceivePositionalInputAt(screenSpacePos)
-                                                                 || (ChannelSelectionOverlay.State.Value == Visibility.Visible && ChannelSelectionOverlay.ReceivePositionalInputAt(screenSpacePos));
-
-        public ChatOverlay()
-        {
-            RelativeSizeAxes = Axes.Both;
-            RelativePositionAxes = Axes.Both;
-            Anchor = Anchor.BottomLeft;
-            Origin = Anchor.BottomLeft;
-        }
-
-        [BackgroundDependencyLoader]
-        private void load(OsuConfigManager config, OsuColour colours, TextureStore textures)
-        {
-            const float padding = 5;
-
-            Children = new Drawable[]
-            {
-                channelSelectionContainer = new Container
-                {
-                    RelativeSizeAxes = Axes.Both,
-                    Height = 1f - DEFAULT_HEIGHT,
-                    Masking = true,
-                    Children = new[]
-                    {
-                        ChannelSelectionOverlay = new ChannelSelectionOverlay
-                        {
-                            RelativeSizeAxes = Axes.Both,
-                        },
-                    },
-                },
-                chatContainer = new Container
-                {
-                    Name = @"chat container",
-                    Anchor = Anchor.BottomLeft,
-                    Origin = Anchor.BottomLeft,
-                    RelativeSizeAxes = Axes.Both,
-                    Height = DEFAULT_HEIGHT,
-                    Children = new[]
-                    {
-                        new Container
-                        {
-                            Name = @"chat area",
-                            RelativeSizeAxes = Axes.Both,
-                            Padding = new MarginPadding { Top = TAB_AREA_HEIGHT },
-                            Children = new Drawable[]
-                            {
-                                chatBackground = new Box
-                                {
-                                    RelativeSizeAxes = Axes.Both,
-                                },
-                                new OnlineViewContainer("Sign in to chat")
-                                {
-                                    RelativeSizeAxes = Axes.Both,
-                                    Children = new Drawable[]
-                                    {
-                                        currentChannelContainer = new Container<DrawableChannel>
-                                        {
-                                            RelativeSizeAxes = Axes.Both,
-                                            Padding = new MarginPadding
-                                            {
-                                                Bottom = text_box_height
-                                            },
-                                        },
-                                        new Container
-                                        {
-                                            Anchor = Anchor.BottomLeft,
-                                            Origin = Anchor.BottomLeft,
-                                            RelativeSizeAxes = Axes.X,
-                                            Height = text_box_height,
-                                            Padding = new MarginPadding
-                                            {
-                                                Top = padding * 2,
-                                                Bottom = padding * 2,
-                                                Left = ChatLine.LEFT_PADDING + padding * 2,
-                                                Right = padding * 2,
-                                            },
-                                            Children = new Drawable[]
-                                            {
-                                                textBox = new FocusedTextBox
-                                                {
-                                                    RelativeSizeAxes = Axes.Both,
-                                                    Height = 1,
-                                                    PlaceholderText = Resources.Localisation.Web.ChatStrings.InputPlaceholder,
-                                                    ReleaseFocusOnCommit = false,
-                                                    HoldFocus = true,
-                                                }
-                                            }
-                                        },
-                                        loading = new LoadingSpinner(),
-                                    },
-                                }
-                            }
-                        },
-                        tabsArea = new TabsArea
-                        {
-                            Children = new Drawable[]
-                            {
-                                tabBackground = new Box
-                                {
-                                    RelativeSizeAxes = Axes.Both,
-                                    Colour = Color4.Black,
-                                },
-                                new Sprite
-                                {
-                                    Texture = textures.Get(IconTexture),
-                                    Anchor = Anchor.CentreLeft,
-                                    Origin = Anchor.CentreLeft,
-                                    Size = new Vector2(OverlayTitle.ICON_SIZE),
-                                    Margin = new MarginPadding { Left = 10 },
-                                },
-                                ChannelTabControl = CreateChannelTabControl().With(d =>
-                                {
-                                    d.Anchor = Anchor.BottomLeft;
-                                    d.Origin = Anchor.BottomLeft;
-                                    d.RelativeSizeAxes = Axes.Both;
-                                    d.OnRequestLeave = channelManager.LeaveChannel;
-                                    d.IsSwitchable = true;
-                                }),
-                            }
-                        },
-                    },
-                },
-            };
-
-            availableChannels.BindTo(channelManager.AvailableChannels);
-            joinedChannels.BindTo(channelManager.JoinedChannels);
-            currentChannel.BindTo(channelManager.CurrentChannel);
-
-            textBox.OnCommit += postMessage;
-
-            ChannelTabControl.Current.ValueChanged += current => currentChannel.Value = current.NewValue;
-            ChannelTabControl.ChannelSelectorActive.ValueChanged += active => ChannelSelectionOverlay.State.Value = active.NewValue ? Visibility.Visible : Visibility.Hidden;
-            ChannelSelectionOverlay.State.ValueChanged += state =>
-            {
-                // Propagate the visibility state to ChannelSelectorActive
-                ChannelTabControl.ChannelSelectorActive.Value = state.NewValue == Visibility.Visible;
-
-                if (state.NewValue == Visibility.Visible)
-                {
-                    textBox.HoldFocus = false;
-                    if (1f - ChatHeight.Value < channel_selection_min_height)
-                        this.TransformBindableTo(ChatHeight, 1f - channel_selection_min_height, 800, Easing.OutQuint);
-                }
-                else
-                    textBox.HoldFocus = true;
-            };
-
-            ChannelSelectionOverlay.OnRequestJoin = channel => channelManager.JoinChannel(channel);
-            ChannelSelectionOverlay.OnRequestLeave = channelManager.LeaveChannel;
-
-            ChatHeight = config.GetBindable<float>(OsuSetting.ChatDisplayHeight);
-            ChatHeight.BindValueChanged(height =>
-            {
-                chatContainer.Height = height.NewValue;
-                channelSelectionContainer.Height = 1f - height.NewValue;
-                tabBackground.FadeTo(height.NewValue == 1f ? 1f : 0.8f, 200);
-            }, true);
-
-            chatBackground.Colour = colours.ChatBlue;
-
-            loading.Show();
-
-            // This is a relatively expensive (and blocking) operation.
-            // Scheduling it ensures that it won't be performed unless the user decides to open chat.
-            // TODO: Refactor OsuFocusedOverlayContainer / OverlayContainer to support delayed content loading.
-            Schedule(() =>
-            {
-                // TODO: consider scheduling bindable callbacks to not perform when overlay is not present.
-                joinedChannels.BindCollectionChanged(joinedChannelsChanged, true);
-                availableChannels.BindCollectionChanged(availableChannelsChanged, true);
-                currentChannel.BindValueChanged(currentChannelChanged, true);
-            });
-        }
-
-        private void currentChannelChanged(ValueChangedEvent<Channel> e)
-        {
-            if (e.NewValue == null)
-            {
-                textBox.Current.Disabled = true;
-                currentChannelContainer.Clear(false);
-                ChannelSelectionOverlay.Show();
-                return;
-            }
-
-            if (e.NewValue is ChannelSelectorTabItem.ChannelSelectorTabChannel)
-                return;
-
-            textBox.Current.Disabled = e.NewValue.ReadOnly;
-
-            if (ChannelTabControl.Current.Value != e.NewValue)
-                Scheduler.Add(() => ChannelTabControl.Current.Value = e.NewValue);
-
-            var loaded = loadedChannels.Find(d => d.Channel == e.NewValue);
-
-            if (loaded == null)
-            {
-                currentChannelContainer.FadeOut(500, Easing.OutQuint);
-                loading.Show();
-
-                loaded = new DrawableChannel(e.NewValue);
-                loadedChannels.Add(loaded);
-                LoadComponentAsync(loaded, l =>
-                {
-                    if (currentChannel.Value != e.NewValue)
-                        return;
-
-                    // check once more to ensure the channel hasn't since been removed from the loaded channels list (may have been left by some automated means).
-                    if (!loadedChannels.Contains(loaded))
-                        return;
-
-                    loading.Hide();
-
-                    currentChannelContainer.Clear(false);
-                    currentChannelContainer.Add(loaded);
-                    currentChannelContainer.FadeIn(500, Easing.OutQuint);
-                });
-            }
-            else
-            {
-                currentChannelContainer.Clear(false);
-                currentChannelContainer.Add(loaded);
-            }
-
-            // mark channel as read when channel switched
-            if (e.NewValue.Messages.Any())
-                channelManager.MarkChannelAsRead(e.NewValue);
-        }
-
-        /// <summary>
-        /// Highlights a certain message in the specified channel.
-        /// </summary>
-        /// <param name="message">The message to highlight.</param>
-        /// <param name="channel">The channel containing the message.</param>
-        public void HighlightMessage(Message message, Channel channel)
-        {
-            Debug.Assert(channel.Id == message.ChannelId);
-
-            if (currentChannel.Value?.Id != channel.Id)
-            {
-                if (!channel.Joined.Value)
-                    channel = channelManager.JoinChannel(channel);
-
-                currentChannel.Value = channel;
-            }
-
-            channel.HighlightedMessage.Value = message;
-
-            Show();
-        }
-
-        private float startDragChatHeight;
-        private bool isDragging;
-
-        protected override bool OnDragStart(DragStartEvent e)
-        {
-            isDragging = tabsArea.IsHovered;
-
-            if (!isDragging)
-                return base.OnDragStart(e);
-
-            startDragChatHeight = ChatHeight.Value;
-            return true;
-        }
-
-        protected override void OnDrag(DragEvent e)
-        {
-            if (isDragging)
-            {
-                float targetChatHeight = startDragChatHeight - (e.MousePosition.Y - e.MouseDownPosition.Y) / Parent.DrawSize.Y;
-
-                // If the channel selection screen is shown, mind its minimum height
-                if (ChannelSelectionOverlay.State.Value == Visibility.Visible && targetChatHeight > 1f - channel_selection_min_height)
-                    targetChatHeight = 1f - channel_selection_min_height;
-
-                ChatHeight.Value = targetChatHeight;
-            }
-        }
-
-        protected override void OnDragEnd(DragEndEvent e)
-        {
-            isDragging = false;
-            base.OnDragEnd(e);
-        }
-
-        private void selectTab(int index)
-        {
-            var channel = ChannelTabControl.Items
-                                           .Where(tab => !(tab is ChannelSelectorTabItem.ChannelSelectorTabChannel))
-                                           .ElementAtOrDefault(index);
-            if (channel != null)
-                ChannelTabControl.Current.Value = channel;
-        }
-
-        protected override bool OnKeyDown(KeyDownEvent e)
-        {
-            if (e.AltPressed)
-            {
-                switch (e.Key)
-                {
-                    case Key.Number1:
-                    case Key.Number2:
-                    case Key.Number3:
-                    case Key.Number4:
-                    case Key.Number5:
-                    case Key.Number6:
-                    case Key.Number7:
-                    case Key.Number8:
-                    case Key.Number9:
-                        selectTab((int)e.Key - (int)Key.Number1);
-                        return true;
-
-                    case Key.Number0:
-                        selectTab(9);
-                        return true;
-                }
-            }
-
-            return base.OnKeyDown(e);
-        }
-
-        public bool OnPressed(KeyBindingPressEvent<PlatformAction> e)
-        {
-            switch (e.Action)
-            {
-                case PlatformAction.TabNew:
-                    ChannelTabControl.SelectChannelSelectorTab();
-                    return true;
-
-                case PlatformAction.TabRestore:
-                    channelManager.JoinLastClosedChannel();
-                    return true;
-
-                case PlatformAction.DocumentClose:
-                    channelManager.LeaveChannel(currentChannel.Value);
-                    return true;
-            }
-
-            return false;
-        }
-
-        public void OnReleased(KeyBindingReleaseEvent<PlatformAction> e)
-        {
-        }
-
-        public override bool AcceptsFocus => true;
-
-        protected override void OnFocus(FocusEvent e)
-        {
-            // this is necessary as textbox is masked away and therefore can't get focus :(
-            textBox.TakeFocus();
-            base.OnFocus(e);
-        }
-
-        protected override void PopIn()
-        {
-            this.MoveToY(0, transition_length, Easing.OutQuint);
-            this.FadeIn(transition_length, Easing.OutQuint);
-
-            textBox.HoldFocus = true;
-
-            base.PopIn();
-        }
-
-        protected override void PopOut()
-        {
-            this.MoveToY(Height, transition_length, Easing.InSine);
-            this.FadeOut(transition_length, Easing.InSine);
-
-            ChannelSelectionOverlay.Hide();
-
-            textBox.HoldFocus = false;
-            base.PopOut();
-        }
-
-        private void joinedChannelsChanged(object sender, NotifyCollectionChangedEventArgs args)
-        {
-            switch (args.Action)
-            {
-                case NotifyCollectionChangedAction.Add:
-                    foreach (Channel channel in args.NewItems.Cast<Channel>())
-                    {
-                        if (channel.Type != ChannelType.Multiplayer)
-                            ChannelTabControl.AddChannel(channel);
-                    }
-
-                    break;
-
-                case NotifyCollectionChangedAction.Remove:
-                    foreach (Channel channel in args.OldItems.Cast<Channel>())
-                    {
-                        if (!ChannelTabControl.Items.Contains(channel))
-                            continue;
-
-                        ChannelTabControl.RemoveChannel(channel);
-
-                        var loaded = loadedChannels.Find(c => c.Channel == channel);
-
-                        if (loaded != null)
-                        {
-                            // Because the container is only cleared in the async load callback of a new channel, it is forcefully cleared
-                            // to ensure that the previous channel doesn't get updated after it's disposed
-                            loadedChannels.Remove(loaded);
-                            currentChannelContainer.Remove(loaded);
-                            loaded.Dispose();
-                        }
-                    }
-
-                    break;
-            }
-        }
-
-        private void availableChannelsChanged(object sender, NotifyCollectionChangedEventArgs args)
-        {
-            ChannelSelectionOverlay.UpdateAvailableChannels(availableChannels);
-        }
-
-        private void postMessage(TextBox textBox, bool newText)
-        {
-            string text = textBox.Text.Trim();
-
-            if (string.IsNullOrWhiteSpace(text))
-                return;
-
-            if (text[0] == '/')
-                channelManager.PostCommand(text.Substring(1));
-            else
-                channelManager.PostMessage(text);
-
-            textBox.Text = string.Empty;
-        }
-
-        private class TabsArea : Container
-        {
-            // IsHovered is used
-            public override bool HandlePositionalInput => true;
-
-            public TabsArea()
-            {
-                Name = @"tabs area";
-                RelativeSizeAxes = Axes.X;
-                Height = TAB_AREA_HEIGHT;
-            }
-        }
-    }
-}

From 03deb336b280aa3ccb86d0333186b871f17a8b95 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 30 May 2022 04:34:08 +0900
Subject: [PATCH 5106/5547] Fix some more chat tests failing intermittently
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

```
TearDown : osu.Framework.Testing.Drawables.Steps.AssertButton+TracedException : Channel 1 ready
--TearDown
   at osu.Framework.Threading.ScheduledDelegate.RunTaskInternal()
   at osu.Framework.Threading.Scheduler.Update()
   at osu.Framework.Graphics.Drawable.UpdateSubTree()
   at osu.Framework.Graphics.Containers.CompositeDrawable.UpdateSubTree()
   at osu.Framework.Graphics.Containers.CompositeDrawable.UpdateSubTree()
   at osu.Framework.Graphics.Containers.CompositeDrawable.UpdateSubTree()
   at osu.Framework.Graphics.Containers.CompositeDrawable.UpdateSubTree()
   at osu.Framework.Graphics.Containers.CompositeDrawable.UpdateSubTree()
   at osu.Framework.Graphics.Containers.CompositeDrawable.UpdateSubTree()
   at osu.Framework.Graphics.Containers.CompositeDrawable.UpdateSubTree()
   at osu.Framework.Graphics.Containers.CompositeDrawable.UpdateSubTree()
   at osu.Framework.Graphics.Containers.CompositeDrawable.UpdateSubTree()
   at osu.Framework.Graphics.Containers.CompositeDrawable.UpdateSubTree()
   at osu.Framework.Graphics.Containers.CompositeDrawable.UpdateSubTree()
   at osu.Framework.Graphics.Containers.CompositeDrawable.UpdateSubTree()
   at osu.Framework.Graphics.Containers.CompositeDrawable.UpdateSubTree()
   at osu.Framework.Graphics.Containers.CompositeDrawable.UpdateSubTree()
   at osu.Framework.Graphics.Containers.CompositeDrawable.UpdateSubTree()
   at osu.Framework.Platform.GameHost.UpdateFrame()
   at osu.Framework.Threading.GameThread.processFrame()
   at osu.Framework.Threading.GameThread.RunSingleFrame()
   at osu.Framework.Threading.GameThread.<createThread>g__runWork|66_0()
   at System.Threading.Thread.StartHelper.Callback(Object state)
   at System.Threading.ExecutionContext.RunInternal(ExecutionContext executionContext, ContextCallback callback, Object state)

-----

One or more child tests had errors
  Exception doesn't have a stacktrace

[runtime] 2022-05-29 19:29:09 [verbose]: 💨 Class: TestSceneChatOverlayV2
[runtime] 2022-05-29 19:29:09 [verbose]: 🔶 Test:  TestSlowLoadingChannel
[runtime] 2022-05-29 19:29:09 [verbose]: Chat is now polling every 60000 ms
[runtime] 2022-05-29 19:29:09 [verbose]: 🔸 Step #1 Setup request handler
[runtime] 2022-05-29 19:29:09 [verbose]: 🔸 Step #2 Add test channels
[runtime] 2022-05-29 19:29:09 [verbose]: 🔸 Step #3 Show overlay (slow-loading)
[runtime] 2022-05-29 19:29:09 [verbose]: 🔸 Step #4 Join channel 1
[runtime] 2022-05-29 19:29:09 [verbose]: 🔸 Step #5 Select channel 1
[runtime] 2022-05-29 19:29:09 [verbose]: 🔸 Step #6 Channel 1 loading
[runtime] 2022-05-29 19:29:09 [verbose]: 🔸 Step #7 Join channel 2
[runtime] 2022-05-29 19:29:09 [verbose]: 🔸 Step #8 Select channel 2
[runtime] 2022-05-29 19:29:09 [verbose]: 🔸 Step #9 Channel 2 loading
[runtime] 2022-05-29 19:29:09 [verbose]: 🔸 Step #10 Finish channel 1 load
[runtime] 2022-05-29 19:29:09 [verbose]: 🔸 Step #11 Channel 1 ready
[runtime] 2022-05-29 19:29:09 [verbose]: 💥 Failed
[runtime] 2022-05-29 19:29:09 [verbose]: ⏳ Currently loading components (2)
[runtime] 2022-05-29 19:29:09 [verbose]: TestSceneChatOverlayV2+SlowLoadingDrawableChannel
[runtime] 2022-05-29 19:29:09 [verbose]: - thread: ThreadedTaskScheduler (LoadComponentsAsync (standard))
[runtime] 2022-05-29 19:29:09 [verbose]: - state:  Loading
[runtime] 2022-05-29 19:29:09 [verbose]: TestSceneChatOverlayV2+SlowLoadingDrawableChannel
[runtime] 2022-05-29 19:29:09 [verbose]: - thread: ThreadedTaskScheduler (LoadComponentsAsync (standard))
[runtime] 2022-05-29 19:29:09 [verbose]: - state:  Ready
[runtime] 2022-05-29 19:29:09 [verbose]: 🧵 Task schedulers
[runtime] 2022-05-29 19:29:09 [verbose]: LoadComponentsAsync (standard) concurrency:4 running:1 pending:0
[runtime] 2022-05-29 19:29:09 [verbose]: LoadComponentsAsync (long load) concurrency:4 running:0 pending:0
[runtime] 2022-05-29 19:29:09 [verbose]: 🎱 Thread pool
[runtime] 2022-05-29 19:29:09 [verbose]: worker:          min 32     max 32,767 available 32,765
[runtime] 2022-05-29 19:29:09 [verbose]: completion:      min 32     max 1,000  available 1,000

```
---
 osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs b/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs
index b333eee21b..ba4db50a11 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs
@@ -404,22 +404,22 @@ namespace osu.Game.Tests.Visual.Online
             });
             AddStep("Join channel 1", () => channelManager.JoinChannel(testChannel1));
             AddStep("Select channel 1", () => clickDrawable(getChannelListItem(testChannel1)));
-            AddAssert("Channel 1 loading", () => !channelIsVisible && chatOverlay.GetSlowLoadingChannel(testChannel1).LoadState == LoadState.Loading);
+            AddUntilStep("Channel 1 loading", () => !channelIsVisible && chatOverlay.GetSlowLoadingChannel(testChannel1).LoadState == LoadState.Loading);
 
             AddStep("Join channel 2", () => channelManager.JoinChannel(testChannel2));
             AddStep("Select channel 2", () => clickDrawable(getChannelListItem(testChannel2)));
-            AddAssert("Channel 2 loading", () => !channelIsVisible && chatOverlay.GetSlowLoadingChannel(testChannel2).LoadState == LoadState.Loading);
+            AddUntilStep("Channel 2 loading", () => !channelIsVisible && chatOverlay.GetSlowLoadingChannel(testChannel2).LoadState == LoadState.Loading);
 
             AddStep("Finish channel 1 load", () => chatOverlay.GetSlowLoadingChannel(testChannel1).LoadEvent.Set());
-            AddAssert("Channel 1 ready", () => chatOverlay.GetSlowLoadingChannel(testChannel1).LoadState == LoadState.Ready);
+            AddUntilStep("Channel 1 ready", () => chatOverlay.GetSlowLoadingChannel(testChannel1).LoadState == LoadState.Ready);
             AddAssert("Channel 1 not displayed", () => !channelIsVisible);
 
             AddStep("Finish channel 2 load", () => chatOverlay.GetSlowLoadingChannel(testChannel2).LoadEvent.Set());
-            AddAssert("Channel 2 loaded", () => chatOverlay.GetSlowLoadingChannel(testChannel2).IsLoaded);
+            AddUntilStep("Channel 2 loaded", () => chatOverlay.GetSlowLoadingChannel(testChannel2).IsLoaded);
             waitForChannel2Visible();
 
             AddStep("Select channel 1", () => clickDrawable(getChannelListItem(testChannel1)));
-            AddAssert("Channel 1 loaded", () => chatOverlay.GetSlowLoadingChannel(testChannel1).IsLoaded);
+            AddUntilStep("Channel 1 loaded", () => chatOverlay.GetSlowLoadingChannel(testChannel1).IsLoaded);
             waitForChannel1Visible();
         }
 

From 45841673f6704da52cd689836950c8967e0cae57 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 30 May 2022 15:44:16 +0900
Subject: [PATCH 5107/5547] Update `OnlineLookupCache` to use async version of
 `Perform` call

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

diff --git a/osu.Game/Database/OnlineLookupCache.cs b/osu.Game/Database/OnlineLookupCache.cs
index 2f98aef58a..506103a2c0 100644
--- a/osu.Game/Database/OnlineLookupCache.cs
+++ b/osu.Game/Database/OnlineLookupCache.cs
@@ -91,7 +91,7 @@ namespace osu.Game.Database
             }
         }
 
-        private void performLookup()
+        private async Task performLookup()
         {
             // contains at most 50 unique IDs from tasks, which is used to perform the lookup.
             var nextTaskBatch = new Dictionary<TLookup, List<TaskCompletionSource<TValue>>>();
@@ -127,7 +127,7 @@ namespace osu.Game.Database
 
             // rather than queueing, we maintain our own single-threaded request stream.
             // todo: we probably want retry logic here.
-            api.Perform(request);
+            await api.PerformAsync(request).ConfigureAwait(false);
 
             finishPendingTask();
 

From a2a057440e87e5f494a8248f07f851e3a505d460 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 30 May 2022 16:05:32 +0900
Subject: [PATCH 5108/5547] Fail requests taretting the fake API with a more
 deliberate exception

I think this feels better than relying on some other method to throw an
exception.
---
 osu.Game/Online/API/DummyAPIAccess.cs | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/osu.Game/Online/API/DummyAPIAccess.cs b/osu.Game/Online/API/DummyAPIAccess.cs
index f292e95bd1..8614cc79cb 100644
--- a/osu.Game/Online/API/DummyAPIAccess.cs
+++ b/osu.Game/Online/API/DummyAPIAccess.cs
@@ -65,9 +65,7 @@ namespace osu.Game.Online.API
         {
             if (HandleRequest?.Invoke(request) != true)
             {
-                // this will fail due to not receiving an APIAccess, and trigger a failure on the request.
-                // this is intended - any request in testing that needs non-failures should use HandleRequest.
-                request.Perform(this);
+                request.Fail(new InvalidOperationException($@"{nameof(DummyAPIAccess)} cannot process this request."));
             }
         }
 

From c18dd8c8fb29fb84c9459a3bed7bb58e429e257e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 30 May 2022 16:32:44 +0900
Subject: [PATCH 5109/5547] Ensure `Queue` operations on `DummyAPIAccess` are
 performed on the update thread

---
 osu.Game/Online/API/DummyAPIAccess.cs | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Online/API/DummyAPIAccess.cs b/osu.Game/Online/API/DummyAPIAccess.cs
index 8614cc79cb..d3707d977c 100644
--- a/osu.Game/Online/API/DummyAPIAccess.cs
+++ b/osu.Game/Online/API/DummyAPIAccess.cs
@@ -63,10 +63,13 @@ namespace osu.Game.Online.API
 
         public virtual void Queue(APIRequest request)
         {
-            if (HandleRequest?.Invoke(request) != true)
+            Schedule(() =>
             {
-                request.Fail(new InvalidOperationException($@"{nameof(DummyAPIAccess)} cannot process this request."));
-            }
+                if (HandleRequest?.Invoke(request) != true)
+                {
+                    request.Fail(new InvalidOperationException($@"{nameof(DummyAPIAccess)} cannot process this request."));
+                }
+            });
         }
 
         public void Perform(APIRequest request) => HandleRequest?.Invoke(request);

From f935f034c2a573bb5002b11d5f70b0987b2786a1 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 30 May 2022 16:33:07 +0900
Subject: [PATCH 5110/5547] Ensure request handling for `OnlinePlayTestScene`
 runs in a scheduled fashion

---
 .../Visual/OnlinePlay/OnlinePlayTestScene.cs  | 20 ++++++++++++++++++-
 1 file changed, 19 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Tests/Visual/OnlinePlay/OnlinePlayTestScene.cs b/osu.Game/Tests/Visual/OnlinePlay/OnlinePlayTestScene.cs
index b6a347a896..32e42a945d 100644
--- a/osu.Game/Tests/Visual/OnlinePlay/OnlinePlayTestScene.cs
+++ b/osu.Game/Tests/Visual/OnlinePlay/OnlinePlayTestScene.cs
@@ -2,6 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
+using System.Threading.Tasks;
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
@@ -67,7 +68,24 @@ namespace osu.Game.Tests.Visual.OnlinePlay
             // To get around this, the BeatmapManager is looked up from the dependencies provided to the children of the test scene instead.
             var beatmapManager = dependencies.Get<BeatmapManager>();
 
-            ((DummyAPIAccess)API).HandleRequest = request => handler.HandleRequest(request, API.LocalUser.Value, beatmapManager);
+            ((DummyAPIAccess)API).HandleRequest = request =>
+            {
+                TaskCompletionSource<bool> tcs = new TaskCompletionSource<bool>();
+
+                // Because some of the handlers use realm, we need to ensure the game is still alive when firing.
+                // If we don't, a stray `PerformAsync` could hit an `ObjectDisposedException` if running too late.
+                Scheduler.Add(() =>
+                {
+                    bool result = handler.HandleRequest(request, API.LocalUser.Value, beatmapManager);
+                    tcs.SetResult(result);
+                }, false);
+
+#pragma warning disable RS0030
+                // We can't GetResultSafely() here (will fail with "Can't use GetResultSafely from inside an async operation."), but Wait is safe enough due to
+                // the task being a TaskCompletionSource.
+                return tcs.Task.Result;
+#pragma warning restore RS0030
+            };
         });
 
         /// <summary>

From dea7a27553a25caab9104b2a78fa2abc548ce6e1 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Mon, 30 May 2022 17:18:29 +0900
Subject: [PATCH 5111/5547] Adjust wording, add text for capable state

---
 .../Overlays/Settings/Sections/Graphics/LayoutSettings.cs   | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Overlays/Settings/Sections/Graphics/LayoutSettings.cs b/osu.Game/Overlays/Settings/Sections/Graphics/LayoutSettings.cs
index 981f5dbac3..acbcdfcf76 100644
--- a/osu.Game/Overlays/Settings/Sections/Graphics/LayoutSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Graphics/LayoutSettings.cs
@@ -234,15 +234,15 @@ namespace osu.Game.Overlays.Settings.Sections.Graphics
             {
                 case FullscreenCapability.Unknown:
                     if (host.Window is WindowsWindow)
-                        windowModeDropdown.WarningText = "Checking for exclusive fullscreen...";
+                        windowModeDropdown.WarningText = "Checking for fullscreen capabilities...";
                     break;
 
                 case FullscreenCapability.Capable:
-                    windowModeDropdown.WarningText = default;
+                    windowModeDropdown.WarningText = "osu! is running exclusive fullscreen, guaranteeing low latency!";
                     break;
 
                 case FullscreenCapability.Incapable:
-                    windowModeDropdown.WarningText = "Unable to enter exclusive fullscreen. You'll still experience some input latency.";
+                    windowModeDropdown.WarningText = "Unable to run exclusive fullscreen. You'll still experience some input latency.";
                     break;
             }
         }

From 5f9a69e5c2f060cbcc2143f53cc7938953a94509 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Mon, 30 May 2022 17:19:03 +0900
Subject: [PATCH 5112/5547] Add localisation

---
 .../Localisation/LayoutSettingsStrings.cs     | 29 +++++++++++++++++++
 .../Sections/Graphics/LayoutSettings.cs       |  6 ++--
 2 files changed, 32 insertions(+), 3 deletions(-)
 create mode 100644 osu.Game/Localisation/LayoutSettingsStrings.cs

diff --git a/osu.Game/Localisation/LayoutSettingsStrings.cs b/osu.Game/Localisation/LayoutSettingsStrings.cs
new file mode 100644
index 0000000000..5ac28f19b3
--- /dev/null
+++ b/osu.Game/Localisation/LayoutSettingsStrings.cs
@@ -0,0 +1,29 @@
+// 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 LayoutSettingsStrings
+    {
+        private const string prefix = @"osu.Game.Resources.Localisation.LayoutSettings";
+
+        /// <summary>
+        /// "Checking for fullscreen capabilities..."
+        /// </summary>
+        public static LocalisableString CheckingForFullscreenCapabilities => new TranslatableString(getKey(@"checking_for_fullscreen_capabilities"), @"Checking for fullscreen capabilities...");
+
+        /// <summary>
+        /// "osu! is running exclusive fullscreen, guaranteeing low latency!"
+        /// </summary>
+        public static LocalisableString OsuIsRunningExclusiveFullscreen => new TranslatableString(getKey(@"osu_is_running_exclusive_fullscreen"), @"osu! is running exclusive fullscreen, guaranteeing low latency!");
+
+        /// <summary>
+        /// "Unable to run exclusive fullscreen. You&#39;ll still experience some input latency."
+        /// </summary>
+        public static LocalisableString UnableToRunExclusiveFullscreen => new TranslatableString(getKey(@"unable_to_run_exclusive_fullscreen"), @"Unable to run exclusive fullscreen. You'll still experience some input latency.");
+
+        private static string getKey(string key) => $@"{prefix}:{key}";
+    }
+}
\ No newline at end of file
diff --git a/osu.Game/Overlays/Settings/Sections/Graphics/LayoutSettings.cs b/osu.Game/Overlays/Settings/Sections/Graphics/LayoutSettings.cs
index acbcdfcf76..69a50c19b4 100644
--- a/osu.Game/Overlays/Settings/Sections/Graphics/LayoutSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Graphics/LayoutSettings.cs
@@ -234,15 +234,15 @@ namespace osu.Game.Overlays.Settings.Sections.Graphics
             {
                 case FullscreenCapability.Unknown:
                     if (host.Window is WindowsWindow)
-                        windowModeDropdown.WarningText = "Checking for fullscreen capabilities...";
+                        windowModeDropdown.WarningText = LayoutSettingsStrings.CheckingForFullscreenCapabilities;
                     break;
 
                 case FullscreenCapability.Capable:
-                    windowModeDropdown.WarningText = "osu! is running exclusive fullscreen, guaranteeing low latency!";
+                    windowModeDropdown.WarningText = LayoutSettingsStrings.OsuIsRunningExclusiveFullscreen;
                     break;
 
                 case FullscreenCapability.Incapable:
-                    windowModeDropdown.WarningText = "Unable to run exclusive fullscreen. You'll still experience some input latency.";
+                    windowModeDropdown.WarningText = LayoutSettingsStrings.UnableToRunExclusiveFullscreen;
                     break;
             }
         }

From f65d2db77f4374d57694f1e15583dfa95f0575a9 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 30 May 2022 17:54:09 +0900
Subject: [PATCH 5113/5547] Remove "V2" suffix from `ChatOverlay` components

---
 osu.Game.Tests/Visual/Navigation/TestSceneOsuGame.cs      | 2 +-
 .../Visual/Navigation/TestScenePerformFromScreen.cs       | 4 ++--
 ...{TestSceneChatOverlayV2.cs => TestSceneChatOverlay.cs} | 8 ++++----
 osu.Game.Tests/Visual/Online/TestSceneMessageNotifier.cs  | 2 +-
 osu.Game/Configuration/OsuConfigManager.cs                | 2 +-
 osu.Game/Online/Chat/MessageNotifier.cs                   | 4 ++--
 osu.Game/OsuGame.cs                                       | 4 ++--
 osu.Game/Overlays/{ChatOverlayV2.cs => ChatOverlay.cs}    | 4 ++--
 .../Profile/Header/Components/MessageUserButton.cs        | 2 +-
 osu.Game/Overlays/Toolbar/ToolbarChatButton.cs            | 2 +-
 10 files changed, 17 insertions(+), 17 deletions(-)
 rename osu.Game.Tests/Visual/Online/{TestSceneChatOverlayV2.cs => TestSceneChatOverlay.cs} (99%)
 rename osu.Game/Overlays/{ChatOverlayV2.cs => ChatOverlay.cs} (98%)

diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneOsuGame.cs b/osu.Game.Tests/Visual/Navigation/TestSceneOsuGame.cs
index c8ea692bb2..e4871f611e 100644
--- a/osu.Game.Tests/Visual/Navigation/TestSceneOsuGame.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneOsuGame.cs
@@ -40,7 +40,7 @@ namespace osu.Game.Tests.Visual.Navigation
             typeof(DashboardOverlay),
             typeof(NewsOverlay),
             typeof(ChannelManager),
-            typeof(ChatOverlayV2),
+            typeof(ChatOverlay),
             typeof(SettingsOverlay),
             typeof(UserProfileOverlay),
             typeof(BeatmapSetOverlay),
diff --git a/osu.Game.Tests/Visual/Navigation/TestScenePerformFromScreen.cs b/osu.Game.Tests/Visual/Navigation/TestScenePerformFromScreen.cs
index 5d0116f80e..2ce914ba3d 100644
--- a/osu.Game.Tests/Visual/Navigation/TestScenePerformFromScreen.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestScenePerformFromScreen.cs
@@ -86,9 +86,9 @@ namespace osu.Game.Tests.Visual.Navigation
         [Test]
         public void TestOverlaysAlwaysClosed()
         {
-            ChatOverlayV2 chat = null;
+            ChatOverlay chat = null;
             AddUntilStep("is at menu", () => Game.ScreenStack.CurrentScreen is MainMenu);
-            AddUntilStep("wait for chat load", () => (chat = Game.ChildrenOfType<ChatOverlayV2>().SingleOrDefault()) != null);
+            AddUntilStep("wait for chat load", () => (chat = Game.ChildrenOfType<ChatOverlay>().SingleOrDefault()) != null);
 
             AddStep("show chat", () => InputManager.Key(Key.F8));
 
diff --git a/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs b/osu.Game.Tests/Visual/Online/TestSceneChatOverlay.cs
similarity index 99%
rename from osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs
rename to osu.Game.Tests/Visual/Online/TestSceneChatOverlay.cs
index 5f237b4b2d..4edbb9f215 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneChatOverlayV2.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneChatOverlay.cs
@@ -32,9 +32,9 @@ using osuTK.Input;
 namespace osu.Game.Tests.Visual.Online
 {
     [TestFixture]
-    public class TestSceneChatOverlayV2 : OsuManualInputManagerTestScene
+    public class TestSceneChatOverlay : OsuManualInputManagerTestScene
     {
-        private TestChatOverlayV2 chatOverlay;
+        private TestChatOverlay chatOverlay;
         private ChannelManager channelManager;
 
         private APIUser testUser;
@@ -64,7 +64,7 @@ namespace osu.Game.Tests.Visual.Online
                 Children = new Drawable[]
                 {
                     channelManager,
-                    chatOverlay = new TestChatOverlayV2(),
+                    chatOverlay = new TestChatOverlay(),
                 },
             };
         });
@@ -564,7 +564,7 @@ namespace osu.Game.Tests.Visual.Online
             };
         }
 
-        private class TestChatOverlayV2 : ChatOverlayV2
+        private class TestChatOverlay : ChatOverlay
         {
             public bool SlowLoading { get; set; }
 
diff --git a/osu.Game.Tests/Visual/Online/TestSceneMessageNotifier.cs b/osu.Game.Tests/Visual/Online/TestSceneMessageNotifier.cs
index 46f426597a..79f62a16e3 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneMessageNotifier.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneMessageNotifier.cs
@@ -208,7 +208,7 @@ namespace osu.Game.Tests.Visual.Online
             };
 
             [Cached]
-            public ChatOverlayV2 ChatOverlay { get; } = new ChatOverlayV2();
+            public ChatOverlay ChatOverlay { get; } = new ChatOverlay();
 
             private readonly MessageNotifier messageNotifier = new MessageNotifier();
 
diff --git a/osu.Game/Configuration/OsuConfigManager.cs b/osu.Game/Configuration/OsuConfigManager.cs
index 69e7dee1a5..20d555c16c 100644
--- a/osu.Game/Configuration/OsuConfigManager.cs
+++ b/osu.Game/Configuration/OsuConfigManager.cs
@@ -46,7 +46,7 @@ namespace osu.Game.Configuration
 
             SetDefault(OsuSetting.RandomSelectAlgorithm, RandomSelectAlgorithm.RandomPermutation);
 
-            SetDefault(OsuSetting.ChatDisplayHeight, ChatOverlayV2.DEFAULT_HEIGHT, 0.2f, 1f);
+            SetDefault(OsuSetting.ChatDisplayHeight, ChatOverlay.DEFAULT_HEIGHT, 0.2f, 1f);
 
             SetDefault(OsuSetting.BeatmapListingCardSize, BeatmapCardSize.Normal);
 
diff --git a/osu.Game/Online/Chat/MessageNotifier.cs b/osu.Game/Online/Chat/MessageNotifier.cs
index cea3e321fa..ca6082e19b 100644
--- a/osu.Game/Online/Chat/MessageNotifier.cs
+++ b/osu.Game/Online/Chat/MessageNotifier.cs
@@ -27,7 +27,7 @@ namespace osu.Game.Online.Chat
         private INotificationOverlay notifications { get; set; }
 
         [Resolved]
-        private ChatOverlayV2 chatOverlay { get; set; }
+        private ChatOverlay chatOverlay { get; set; }
 
         [Resolved]
         private ChannelManager channelManager { get; set; }
@@ -170,7 +170,7 @@ namespace osu.Game.Online.Chat
             public override bool IsImportant => false;
 
             [BackgroundDependencyLoader]
-            private void load(OsuColour colours, ChatOverlayV2 chatOverlay, INotificationOverlay notificationOverlay)
+            private void load(OsuColour colours, ChatOverlay chatOverlay, INotificationOverlay notificationOverlay)
             {
                 IconBackground.Colour = colours.PurpleDark;
 
diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index 402bd94f31..785881d97a 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -75,7 +75,7 @@ namespace osu.Game
 
         public Toolbar Toolbar;
 
-        private ChatOverlayV2 chatOverlay;
+        private ChatOverlay chatOverlay;
 
         private ChannelManager channelManager;
 
@@ -848,7 +848,7 @@ namespace osu.Game
             loadComponentSingleFile(news = new NewsOverlay(), overlayContent.Add, true);
             var rankingsOverlay = loadComponentSingleFile(new RankingsOverlay(), overlayContent.Add, true);
             loadComponentSingleFile(channelManager = new ChannelManager(), AddInternal, true);
-            loadComponentSingleFile(chatOverlay = new ChatOverlayV2(), overlayContent.Add, true);
+            loadComponentSingleFile(chatOverlay = new ChatOverlay(), overlayContent.Add, true);
             loadComponentSingleFile(new MessageNotifier(), AddInternal, true);
             loadComponentSingleFile(Settings = new SettingsOverlay(), leftFloatingOverlayContent.Add, true);
             loadComponentSingleFile(changelogOverlay = new ChangelogOverlay(), overlayContent.Add, true);
diff --git a/osu.Game/Overlays/ChatOverlayV2.cs b/osu.Game/Overlays/ChatOverlay.cs
similarity index 98%
rename from osu.Game/Overlays/ChatOverlayV2.cs
rename to osu.Game/Overlays/ChatOverlay.cs
index f2ec007b19..02769b5d68 100644
--- a/osu.Game/Overlays/ChatOverlayV2.cs
+++ b/osu.Game/Overlays/ChatOverlay.cs
@@ -27,7 +27,7 @@ using osu.Game.Overlays.Chat.Listing;
 
 namespace osu.Game.Overlays
 {
-    public class ChatOverlayV2 : OsuFocusedOverlayContainer, INamedOverlayComponent, IKeyBindingHandler<PlatformAction>
+    public class ChatOverlay : OsuFocusedOverlayContainer, INamedOverlayComponent, IKeyBindingHandler<PlatformAction>
     {
         public string IconTexture => "Icons/Hexacons/messaging";
         public LocalisableString Title => ChatStrings.HeaderTitle;
@@ -70,7 +70,7 @@ namespace osu.Game.Overlays
         private readonly IBindableList<Channel> availableChannels = new BindableList<Channel>();
         private readonly IBindableList<Channel> joinedChannels = new BindableList<Channel>();
 
-        public ChatOverlayV2()
+        public ChatOverlay()
         {
             Height = DEFAULT_HEIGHT;
 
diff --git a/osu.Game/Overlays/Profile/Header/Components/MessageUserButton.cs b/osu.Game/Overlays/Profile/Header/Components/MessageUserButton.cs
index eafb453f75..e3dc5f818a 100644
--- a/osu.Game/Overlays/Profile/Header/Components/MessageUserButton.cs
+++ b/osu.Game/Overlays/Profile/Header/Components/MessageUserButton.cs
@@ -27,7 +27,7 @@ namespace osu.Game.Overlays.Profile.Header.Components
         private UserProfileOverlay userOverlay { get; set; }
 
         [Resolved(CanBeNull = true)]
-        private ChatOverlayV2 chatOverlay { get; set; }
+        private ChatOverlay chatOverlay { get; set; }
 
         [Resolved]
         private IAPIProvider apiProvider { get; set; }
diff --git a/osu.Game/Overlays/Toolbar/ToolbarChatButton.cs b/osu.Game/Overlays/Toolbar/ToolbarChatButton.cs
index 20f405aae2..2d3b33e9bc 100644
--- a/osu.Game/Overlays/Toolbar/ToolbarChatButton.cs
+++ b/osu.Game/Overlays/Toolbar/ToolbarChatButton.cs
@@ -17,7 +17,7 @@ namespace osu.Game.Overlays.Toolbar
         }
 
         [BackgroundDependencyLoader(true)]
-        private void load(ChatOverlayV2 chat)
+        private void load(ChatOverlay chat)
         {
             StateContainer = chat;
         }

From 0981d415a1fe5ed295b21049cc451f5817b36e68 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 30 May 2022 17:57:48 +0900
Subject: [PATCH 5114/5547] Select correct channel regardless of load order

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

diff --git a/osu.Game.Tests/Visual/Online/TestSceneChatOverlay.cs b/osu.Game.Tests/Visual/Online/TestSceneChatOverlay.cs
index 4edbb9f215..2cf1114f30 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneChatOverlay.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneChatOverlay.cs
@@ -469,6 +469,8 @@ namespace osu.Game.Tests.Visual.Online
                 chatOverlay.Show();
             });
 
+            AddStep("Select channel 1", () => clickDrawable(getChannelListItem(testChannel1)));
+
             waitForChannel1Visible();
             AddStep("Press document next keys", () => InputManager.Keys(PlatformAction.DocumentNext));
             waitForChannel2Visible();

From c97b477485bc87d5841c6dffd884ad37971a51e5 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Mon, 30 May 2022 19:11:54 +0900
Subject: [PATCH 5115/5547] Fix inverted operation order

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

diff --git a/osu.Game/Screens/Play/Player.cs b/osu.Game/Screens/Play/Player.cs
index 51c1e6b43b..b68ac3cb05 100644
--- a/osu.Game/Screens/Play/Player.cs
+++ b/osu.Game/Screens/Play/Player.cs
@@ -213,8 +213,8 @@ namespace osu.Game.Screens.Play
             dependencies.CacheAs(DrawableRuleset);
 
             ScoreProcessor = ruleset.CreateScoreProcessor();
-            ScoreProcessor.ApplyBeatmap(playableBeatmap);
             ScoreProcessor.Mods.Value = gameplayMods;
+            ScoreProcessor.ApplyBeatmap(playableBeatmap);
 
             dependencies.CacheAs(ScoreProcessor);
 

From a052e09ac3d4a9e8c0aa3a46f0bf859f3bab60a0 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Mon, 30 May 2022 19:14:03 +0900
Subject: [PATCH 5116/5547] Send ScoreProcessor statistics in SpectatorState

---
 osu.Game/Online/Spectator/SpectatorClient.cs |  3 +
 osu.Game/Online/Spectator/SpectatorState.cs  | 18 ++++++
 osu.Game/Rulesets/Scoring/ScoreProcessor.cs  | 59 ++++++++++----------
 osu.Game/Screens/Play/GameplayState.cs       | 12 ++--
 osu.Game/Screens/Play/Player.cs              |  2 +-
 5 files changed, 61 insertions(+), 33 deletions(-)

diff --git a/osu.Game/Online/Spectator/SpectatorClient.cs b/osu.Game/Online/Spectator/SpectatorClient.cs
index 78beda6298..3c31acca01 100644
--- a/osu.Game/Online/Spectator/SpectatorClient.cs
+++ b/osu.Game/Online/Spectator/SpectatorClient.cs
@@ -172,6 +172,9 @@ namespace osu.Game.Online.Spectator
                 currentState.RulesetID = score.ScoreInfo.RulesetID;
                 currentState.Mods = score.ScoreInfo.Mods.Select(m => new APIMod(m)).ToArray();
                 currentState.State = SpectatedUserState.Playing;
+                currentState.MaxAchievableCombo = state.ScoreProcessor.MaxAchievableCombo;
+                currentState.MaxAchievableBaseScore = state.ScoreProcessor.MaxAchievableBaseScore;
+                currentState.TotalBasicHitObjects = state.ScoreProcessor.TotalBasicHitObjects;
 
                 currentBeatmap = state.Beatmap;
                 currentScore = score;
diff --git a/osu.Game/Online/Spectator/SpectatorState.cs b/osu.Game/Online/Spectator/SpectatorState.cs
index 77686d12da..8b2e90ead0 100644
--- a/osu.Game/Online/Spectator/SpectatorState.cs
+++ b/osu.Game/Online/Spectator/SpectatorState.cs
@@ -27,6 +27,24 @@ namespace osu.Game.Online.Spectator
         [Key(3)]
         public SpectatedUserState State { get; set; }
 
+        /// <summary>
+        /// The maximum achievable combo, if everything is hit perfectly.
+        /// </summary>
+        [Key(4)]
+        public int MaxAchievableCombo { get; set; }
+
+        /// <summary>
+        /// The maximum achievable base score, if everything is hit perfectly.
+        /// </summary>
+        [Key(5)]
+        public double MaxAchievableBaseScore { get; set; }
+
+        /// <summary>
+        /// The total number of basic (non-tick and non-bonus) hitobjects that can be hit.
+        /// </summary>
+        [Key(6)]
+        public int TotalBasicHitObjects { get; set; }
+
         public bool Equals(SpectatorState other)
         {
             if (ReferenceEquals(null, other)) return false;
diff --git a/osu.Game/Rulesets/Scoring/ScoreProcessor.cs b/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
index 1dd1d1aeb6..ec09bfcfa3 100644
--- a/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
+++ b/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
@@ -88,17 +88,20 @@ namespace osu.Game.Rulesets.Scoring
         private readonly double accuracyPortion;
         private readonly double comboPortion;
 
-        private int maxAchievableCombo;
+        /// <summary>
+        /// The maximum achievable combo, if everything is hit perfectly.
+        /// </summary>
+        internal int MaxAchievableCombo;
 
         /// <summary>
-        /// The maximum achievable base score.
+        /// The maximum achievable base score, if everything is hit perfectly.
         /// </summary>
-        private double maxBaseScore;
+        internal double MaxAchievableBaseScore;
 
         /// <summary>
-        /// The maximum number of basic (non-tick and non-bonus) hitobjects.
+        /// The total number of basic (non-tick and non-bonus) hitobjects that can be hit.
         /// </summary>
-        private int maxBasicHitObjects;
+        internal int TotalBasicHitObjects;
 
         /// <summary>
         /// The maximum <see cref="HitResult"/> of a basic (non-tick and non-bonus) hitobject.
@@ -106,9 +109,9 @@ namespace osu.Game.Rulesets.Scoring
         /// </summary>
         private HitResult? maxBasicResult;
 
-        private double rollingMaxBaseScore;
-        private double baseScore;
-        private int basicHitObjects;
+        private double rollingMaxAchievableBaseScore;
+        private double rollingBaseScore;
+        private int rollingBasicHitObjects;
         private bool beatmapApplied;
 
         private readonly Dictionary<HitResult, int> scoreResultCounts = new Dictionary<HitResult, int>();
@@ -175,12 +178,12 @@ namespace osu.Game.Rulesets.Scoring
 
             if (!result.Type.IsBonus())
             {
-                baseScore += scoreIncrease;
-                rollingMaxBaseScore += result.Judgement.MaxNumericResult;
+                rollingBaseScore += scoreIncrease;
+                rollingMaxAchievableBaseScore += result.Judgement.MaxNumericResult;
             }
 
             if (result.Type.IsBasic())
-                basicHitObjects++;
+                rollingBasicHitObjects++;
 
             hitEvents.Add(CreateHitEvent(result));
             lastHitObject = result.HitObject;
@@ -213,12 +216,12 @@ namespace osu.Game.Rulesets.Scoring
 
             if (!result.Type.IsBonus())
             {
-                baseScore -= scoreIncrease;
-                rollingMaxBaseScore -= result.Judgement.MaxNumericResult;
+                rollingBaseScore -= scoreIncrease;
+                rollingMaxAchievableBaseScore -= result.Judgement.MaxNumericResult;
             }
 
             if (result.Type.IsBasic())
-                basicHitObjects--;
+                rollingBasicHitObjects--;
 
             Debug.Assert(hitEvents.Count > 0);
             lastHitObject = hitEvents[^1].LastHitObject;
@@ -229,12 +232,12 @@ namespace osu.Game.Rulesets.Scoring
 
         private void updateScore()
         {
-            double rollingAccuracyRatio = rollingMaxBaseScore > 0 ? baseScore / rollingMaxBaseScore : 1;
-            double accuracyRatio = maxBaseScore > 0 ? baseScore / maxBaseScore : 1;
-            double comboRatio = maxAchievableCombo > 0 ? (double)HighestCombo.Value / maxAchievableCombo : 1;
+            double rollingAccuracyRatio = rollingMaxAchievableBaseScore > 0 ? rollingBaseScore / rollingMaxAchievableBaseScore : 1;
+            double accuracyRatio = MaxAchievableBaseScore > 0 ? rollingBaseScore / MaxAchievableBaseScore : 1;
+            double comboRatio = MaxAchievableCombo > 0 ? (double)HighestCombo.Value / MaxAchievableCombo : 1;
 
             Accuracy.Value = rollingAccuracyRatio;
-            TotalScore.Value = ComputeScore(Mode.Value, accuracyRatio, comboRatio, getBonusScore(scoreResultCounts), maxBasicHitObjects);
+            TotalScore.Value = ComputeScore(Mode.Value, accuracyRatio, comboRatio, getBonusScore(scoreResultCounts), TotalBasicHitObjects);
         }
 
         /// <summary>
@@ -288,10 +291,10 @@ namespace osu.Game.Rulesets.Scoring
                 out _,
                 out _);
 
-            double accuracyRatio = maxBaseScore > 0 ? extractedBaseScore / maxBaseScore : 1;
-            double comboRatio = maxAchievableCombo > 0 ? (double)scoreInfo.MaxCombo / maxAchievableCombo : 1;
+            double accuracyRatio = MaxAchievableBaseScore > 0 ? extractedBaseScore / MaxAchievableBaseScore : 1;
+            double comboRatio = MaxAchievableCombo > 0 ? (double)scoreInfo.MaxCombo / MaxAchievableCombo : 1;
 
-            return ComputeScore(mode, accuracyRatio, comboRatio, getBonusScore(scoreInfo.Statistics), maxBasicHitObjects);
+            return ComputeScore(mode, accuracyRatio, comboRatio, getBonusScore(scoreInfo.Statistics), TotalBasicHitObjects);
         }
 
         /// <summary>
@@ -403,14 +406,14 @@ namespace osu.Game.Rulesets.Scoring
 
             if (storeResults)
             {
-                maxAchievableCombo = HighestCombo.Value;
-                maxBaseScore = baseScore;
-                maxBasicHitObjects = basicHitObjects;
+                MaxAchievableCombo = HighestCombo.Value;
+                MaxAchievableBaseScore = rollingBaseScore;
+                TotalBasicHitObjects = rollingBasicHitObjects;
             }
 
-            baseScore = 0;
-            rollingMaxBaseScore = 0;
-            basicHitObjects = 0;
+            rollingBaseScore = 0;
+            rollingMaxAchievableBaseScore = 0;
+            rollingBasicHitObjects = 0;
 
             TotalScore.Value = 0;
             Accuracy.Value = 1;
@@ -444,7 +447,7 @@ namespace osu.Game.Rulesets.Scoring
             if (frame.Header == null)
                 return;
 
-            extractFromStatistics(ruleset, frame.Header.Statistics, out baseScore, out rollingMaxBaseScore, out _, out _);
+            extractFromStatistics(ruleset, frame.Header.Statistics, out rollingBaseScore, out rollingMaxAchievableBaseScore, out _, out _);
             HighestCombo.Value = frame.Header.MaxCombo;
 
             scoreResultCounts.Clear();
diff --git a/osu.Game/Screens/Play/GameplayState.cs b/osu.Game/Screens/Play/GameplayState.cs
index c6a072da74..586cdcda51 100644
--- a/osu.Game/Screens/Play/GameplayState.cs
+++ b/osu.Game/Screens/Play/GameplayState.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.
 
+#nullable enable
+
 using System;
 using System.Collections.Generic;
 using osu.Framework.Bindables;
@@ -8,10 +10,9 @@ using osu.Game.Beatmaps;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Judgements;
 using osu.Game.Rulesets.Mods;
+using osu.Game.Rulesets.Scoring;
 using osu.Game.Scoring;
 
-#nullable enable
-
 namespace osu.Game.Screens.Play
 {
     /// <summary>
@@ -39,6 +40,8 @@ namespace osu.Game.Screens.Play
         /// </summary>
         public readonly Score Score;
 
+        public readonly ScoreProcessor ScoreProcessor;
+
         /// <summary>
         /// Whether gameplay completed without the user failing.
         /// </summary>
@@ -61,7 +64,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)
+        public GameplayState(IBeatmap beatmap, Ruleset ruleset, IReadOnlyList<Mod>? mods = null, Score? score = null, ScoreProcessor? scoreProcessor = null)
         {
             Beatmap = beatmap;
             Ruleset = ruleset;
@@ -72,7 +75,8 @@ namespace osu.Game.Screens.Play
                     Ruleset = ruleset.RulesetInfo
                 }
             };
-            Mods = mods ?? ArraySegment<Mod>.Empty;
+            Mods = mods ?? Array.Empty<Mod>();
+            ScoreProcessor = scoreProcessor ?? ruleset.CreateScoreProcessor();
         }
 
         /// <summary>
diff --git a/osu.Game/Screens/Play/Player.cs b/osu.Game/Screens/Play/Player.cs
index b68ac3cb05..dfc0fa1d1d 100644
--- a/osu.Game/Screens/Play/Player.cs
+++ b/osu.Game/Screens/Play/Player.cs
@@ -237,7 +237,7 @@ namespace osu.Game.Screens.Play
             Score.ScoreInfo.Ruleset = ruleset.RulesetInfo;
             Score.ScoreInfo.Mods = gameplayMods;
 
-            dependencies.CacheAs(GameplayState = new GameplayState(playableBeatmap, ruleset, gameplayMods, Score));
+            dependencies.CacheAs(GameplayState = new GameplayState(playableBeatmap, ruleset, gameplayMods, Score, ScoreProcessor));
 
             var rulesetSkinProvider = new RulesetSkinProvidingContainer(ruleset, playableBeatmap, Beatmap.Value.Skin);
 

From 75b50de26971218024636fcdda74df87dbbc160b Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Mon, 30 May 2022 19:15:30 +0900
Subject: [PATCH 5117/5547] Implement score processor for spectator states

---
 .../Spectator/SpectatorScoreProcessor.cs      | 204 ++++++++++++++++++
 1 file changed, 204 insertions(+)
 create mode 100644 osu.Game/Online/Spectator/SpectatorScoreProcessor.cs

diff --git a/osu.Game/Online/Spectator/SpectatorScoreProcessor.cs b/osu.Game/Online/Spectator/SpectatorScoreProcessor.cs
new file mode 100644
index 0000000000..99596fa1d3
--- /dev/null
+++ b/osu.Game/Online/Spectator/SpectatorScoreProcessor.cs
@@ -0,0 +1,204 @@
+// 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 enable
+
+using System;
+using System.Collections.Generic;
+using System.Diagnostics;
+using System.Linq;
+using osu.Framework.Allocation;
+using osu.Framework.Bindables;
+using osu.Framework.Graphics;
+using osu.Game.Beatmaps;
+using osu.Game.Beatmaps.ControlPoints;
+using osu.Game.Beatmaps.Timing;
+using osu.Game.Rulesets;
+using osu.Game.Rulesets.Mods;
+using osu.Game.Rulesets.Objects;
+using osu.Game.Rulesets.Scoring;
+using osu.Game.Scoring;
+
+namespace osu.Game.Online.Spectator
+{
+    /// <summary>
+    /// A wrapper over a <see cref="ScoreProcessor"/> for spectated users.
+    /// This should be used when a local "playable" beatmap is unavailable or expensive to generate for the spectated user.
+    /// </summary>
+    public class SpectatorScoreProcessor : Component
+    {
+        /// <summary>
+        /// The current total score.
+        /// </summary>
+        public readonly BindableDouble TotalScore = new BindableDouble { MinValue = 0 };
+
+        /// <summary>
+        /// The current accuracy.
+        /// </summary>
+        public readonly BindableDouble Accuracy = new BindableDouble(1) { MinValue = 0, MaxValue = 1 };
+
+        /// <summary>
+        /// The current combo.
+        /// </summary>
+        public readonly BindableInt Combo = new BindableInt();
+
+        /// <summary>
+        /// The <see cref="ScoringMode"/> used to calculate scores.
+        /// </summary>
+        public readonly Bindable<ScoringMode> Mode = new Bindable<ScoringMode>();
+
+        /// <summary>
+        /// The applied <see cref="Mod"/>s.
+        /// </summary>
+        public IReadOnlyList<Mod> Mods => scoreProcessor?.Mods.Value ?? Array.Empty<Mod>();
+
+        [Resolved]
+        private SpectatorClient spectatorClient { get; set; } = null!;
+
+        [Resolved]
+        private RulesetStore rulesetStore { get; set; } = null!;
+
+        private readonly IBindableDictionary<int, SpectatorState> spectatorStates = new BindableDictionary<int, SpectatorState>();
+        private readonly List<TimedFrame> replayFrames = new List<TimedFrame>();
+        private readonly int userId;
+
+        private ScoreProcessor? scoreProcessor;
+        private ScoreInfo? scoreInfo;
+
+        public SpectatorScoreProcessor(int userId)
+        {
+            this.userId = userId;
+        }
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            Mode.BindValueChanged(_ => UpdateScore());
+
+            spectatorStates.BindTo(spectatorClient.WatchedUserStates);
+            spectatorStates.BindCollectionChanged(onSpectatorStatesChanged, true);
+
+            spectatorClient.OnNewFrames += onNewFrames;
+        }
+
+        private void onSpectatorStatesChanged(object? sender, NotifyDictionaryChangedEventArgs<int, SpectatorState> e)
+        {
+            if (!spectatorStates.TryGetValue(userId, out var userState) || userState.BeatmapID == null || userState.RulesetID == null)
+            {
+                scoreProcessor?.RemoveAndDisposeImmediately();
+                scoreProcessor = null;
+                scoreInfo = null;
+                replayFrames.Clear();
+                return;
+            }
+
+            if (scoreProcessor != null)
+                return;
+
+            Debug.Assert(scoreInfo == null);
+
+            RulesetInfo? rulesetInfo = rulesetStore.GetRuleset(userState.RulesetID.Value);
+            if (rulesetInfo == null)
+                return;
+
+            Ruleset ruleset = rulesetInfo.CreateInstance();
+
+            scoreInfo = new ScoreInfo { Ruleset = rulesetInfo };
+            scoreProcessor = ruleset.CreateScoreProcessor();
+
+            // Mods are required for score multiplier.
+            scoreProcessor.Mods.Value = userState.Mods.Select(m => m.ToMod(ruleset)).ToArray();
+
+            // Applying beatmap required to call ComputePartialScore().
+            scoreProcessor.ApplyBeatmap(new DummyBeatmap());
+
+            scoreProcessor.MaxAchievableCombo = userState.MaxAchievableCombo;
+            scoreProcessor.MaxAchievableBaseScore = userState.MaxAchievableBaseScore;
+            scoreProcessor.TotalBasicHitObjects = userState.TotalBasicHitObjects;
+        }
+
+        private void onNewFrames(int incomingUserId, FrameDataBundle bundle)
+        {
+            if (incomingUserId != userId)
+                return;
+
+            Schedule(() =>
+            {
+                if (scoreProcessor == null)
+                    return;
+
+                replayFrames.Add(new TimedFrame(bundle.Frames.First().Time, bundle.Header));
+                UpdateScore();
+            });
+        }
+
+        public void UpdateScore()
+        {
+            if (scoreInfo == null || replayFrames.Count == 0)
+                return;
+
+            Debug.Assert(scoreProcessor != null);
+
+            int frameIndex = replayFrames.BinarySearch(new TimedFrame(Time.Current));
+            if (frameIndex < 0)
+                frameIndex = ~frameIndex;
+            frameIndex = Math.Clamp(frameIndex - 1, 0, replayFrames.Count - 1);
+
+            TimedFrame frame = replayFrames[frameIndex];
+            Debug.Assert(frame.Header != null);
+
+            scoreInfo.MaxCombo = frame.Header.MaxCombo;
+            scoreInfo.Statistics = frame.Header.Statistics;
+
+            Accuracy.Value = frame.Header.Accuracy;
+            Combo.Value = frame.Header.Combo;
+            TotalScore.Value = scoreProcessor.ComputePartialScore(Mode.Value, scoreInfo);
+        }
+
+        protected override void Dispose(bool isDisposing)
+        {
+            base.Dispose(isDisposing);
+
+            // ReSharper disable once ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract
+            if (spectatorClient != null)
+                spectatorClient.OnNewFrames -= onNewFrames;
+        }
+
+        private class DummyBeatmap : IBeatmap
+        {
+            public BeatmapInfo BeatmapInfo { get; set; } = new BeatmapInfo();
+            public BeatmapMetadata Metadata { get; } = new BeatmapMetadata();
+            public BeatmapDifficulty Difficulty { get; set; } = new BeatmapDifficulty();
+            public ControlPointInfo ControlPointInfo { get; set; } = new ControlPointInfo();
+            public List<BreakPeriod> Breaks { get; } = new List<BreakPeriod>();
+            public double TotalBreakTime => 0;
+            public IReadOnlyList<HitObject> HitObjects => Array.Empty<HitObject>();
+
+            public IEnumerable<BeatmapStatistic> GetStatistics() => Array.Empty<BeatmapStatistic>();
+
+            public double GetMostCommonBeatLength() => 0;
+
+            public IBeatmap Clone() => throw new NotImplementedException();
+        }
+
+        private class TimedFrame : IComparable<TimedFrame>
+        {
+            public readonly double Time;
+            public readonly FrameHeader? Header;
+
+            public TimedFrame(double time)
+            {
+                Time = time;
+            }
+
+            public TimedFrame(double time, FrameHeader header)
+            {
+                Time = time;
+                Header = header;
+            }
+
+            public int CompareTo(TimedFrame other) => Time.CompareTo(other.Time);
+        }
+    }
+}

From 22d998dc2a518728c00d1f2d84c40aef12479110 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Mon, 30 May 2022 19:18:38 +0900
Subject: [PATCH 5118/5547] Use new score processor in
 MultiplayerGameplayLeaderboard

---
 ...MultiplayerGameplayLeaderboardTestScene.cs |  35 +++--
 .../TestSceneMultiSpectatorLeaderboard.cs     |   6 +-
 ...TestSceneMultiplayerGameplayLeaderboard.cs |  42 ++++-
 ...ceneMultiplayerGameplayLeaderboardTeams.cs |   5 +-
 osu.Game/Online/Spectator/SpectatorClient.cs  |   2 +-
 .../Multiplayer/MultiplayerPlayer.cs          |  11 +-
 .../Spectate/MultiSpectatorLeaderboard.cs     |  48 +-----
 .../Spectate/MultiSpectatorScreen.cs          |   8 +-
 .../HUD/MultiplayerGameplayLeaderboard.cs     | 147 +++++-------------
 9 files changed, 110 insertions(+), 194 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/MultiplayerGameplayLeaderboardTestScene.cs b/osu.Game.Tests/Visual/Multiplayer/MultiplayerGameplayLeaderboardTestScene.cs
index 4e6342868a..62cea378e6 100644
--- a/osu.Game.Tests/Visual/Multiplayer/MultiplayerGameplayLeaderboardTestScene.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/MultiplayerGameplayLeaderboardTestScene.cs
@@ -18,7 +18,6 @@ using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Spectator;
 using osu.Game.Replays.Legacy;
-using osu.Game.Rulesets.Osu.Scoring;
 using osu.Game.Rulesets.Scoring;
 using osu.Game.Scoring;
 using osu.Game.Screens.Play.HUD;
@@ -27,7 +26,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
 {
     public abstract class MultiplayerGameplayLeaderboardTestScene : OsuTestScene
     {
-        private const int total_users = 16;
+        protected const int TOTAL_USERS = 16;
 
         protected readonly BindableList<MultiplayerRoomUser> MultiplayerUsers = new BindableList<MultiplayerRoomUser>();
 
@@ -35,9 +34,10 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
         protected virtual MultiplayerRoomUser CreateUser(int userId) => new MultiplayerRoomUser(userId);
 
-        protected abstract MultiplayerGameplayLeaderboard CreateLeaderboard(OsuScoreProcessor scoreProcessor);
+        protected abstract MultiplayerGameplayLeaderboard CreateLeaderboard();
 
         private readonly BindableList<int> multiplayerUserIds = new BindableList<int>();
+        private readonly BindableDictionary<int, SpectatorState> watchedUserStates = new BindableDictionary<int, SpectatorState>();
 
         private OsuConfigManager config;
 
@@ -81,6 +81,9 @@ namespace osu.Game.Tests.Visual.Multiplayer
 
             multiplayerClient.SetupGet(c => c.CurrentMatchPlayingUserIds)
                              .Returns(() => multiplayerUserIds);
+
+            spectatorClient.SetupGet(c => c.WatchedUserStates)
+                           .Returns(() => watchedUserStates);
         }
 
         [SetUpSteps]
@@ -100,8 +103,23 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddStep("populate users", () =>
             {
                 MultiplayerUsers.Clear();
-                for (int i = 0; i < total_users; i++)
-                    MultiplayerUsers.Add(CreateUser(i));
+
+                for (int i = 0; i < TOTAL_USERS; i++)
+                {
+                    var user = CreateUser(i);
+
+                    MultiplayerUsers.Add(user);
+
+                    watchedUserStates[i] = new SpectatorState
+                    {
+                        BeatmapID = 0,
+                        RulesetID = 0,
+                        Mods = user.Mods,
+                        MaxAchievableCombo = 1000,
+                        MaxAchievableBaseScore = 10000,
+                        TotalBasicHitObjects = 1000
+                    };
+                }
             });
 
             AddStep("create leaderboard", () =>
@@ -109,13 +127,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 Leaderboard?.Expire();
 
                 Beatmap.Value = CreateWorkingBeatmap(Ruleset.Value);
-                var playableBeatmap = Beatmap.Value.GetPlayableBeatmap(Ruleset.Value);
-                OsuScoreProcessor scoreProcessor = new OsuScoreProcessor();
-                scoreProcessor.ApplyBeatmap(playableBeatmap);
 
-                Child = scoreProcessor;
-
-                LoadComponentAsync(Leaderboard = CreateLeaderboard(scoreProcessor), Add);
+                LoadComponentAsync(Leaderboard = CreateLeaderboard(), Add);
             });
 
             AddUntilStep("wait for load", () => Leaderboard.IsLoaded);
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorLeaderboard.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorLeaderboard.cs
index f57a54d84c..e94e198a4a 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorLeaderboard.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorLeaderboard.cs
@@ -8,7 +8,6 @@ using osu.Framework.Testing;
 using osu.Framework.Timing;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Multiplayer;
-using osu.Game.Rulesets.Osu.Scoring;
 using osu.Game.Screens.OnlinePlay.Multiplayer.Spectate;
 using osu.Game.Screens.Play.HUD;
 
@@ -42,11 +41,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddStep("create leaderboard", () =>
             {
                 Beatmap.Value = CreateWorkingBeatmap(Ruleset.Value);
-                var playable = Beatmap.Value.GetPlayableBeatmap(Ruleset.Value);
-                var scoreProcessor = new OsuScoreProcessor();
-                scoreProcessor.ApplyBeatmap(playable);
 
-                LoadComponentAsync(leaderboard = new MultiSpectatorLeaderboard(Ruleset.Value, scoreProcessor, clocks.Keys.Select(id => new MultiplayerRoomUser(id)).ToArray())
+                LoadComponentAsync(leaderboard = new MultiSpectatorLeaderboard(clocks.Keys.Select(id => new MultiplayerRoomUser(id)).ToArray())
                 {
                     Expanded = { Value = true }
                 }, Add);
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs
index 6e4aa48b0e..cbbd535cee 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs
@@ -1,22 +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 System.Collections.Generic;
 using System.Linq;
+using NUnit.Framework;
 using osu.Framework.Graphics;
-using osu.Game.Rulesets.Osu.Scoring;
+using osu.Game.Online.API;
+using osu.Game.Online.Multiplayer;
+using osu.Game.Rulesets.Mods;
+using osu.Game.Rulesets.Osu.Mods;
 using osu.Game.Screens.Play.HUD;
 
 namespace osu.Game.Tests.Visual.Multiplayer
 {
     public class TestSceneMultiplayerGameplayLeaderboard : MultiplayerGameplayLeaderboardTestScene
     {
-        protected override MultiplayerGameplayLeaderboard CreateLeaderboard(OsuScoreProcessor scoreProcessor)
+        protected override MultiplayerRoomUser CreateUser(int userId)
         {
-            return new MultiplayerGameplayLeaderboard(Ruleset.Value, scoreProcessor, MultiplayerUsers.ToArray())
+            var user = base.CreateUser(userId);
+
+            if (userId == TOTAL_USERS - 1)
+                user.Mods = new[] { new APIMod(new OsuModNoFail()) };
+
+            return user;
+        }
+
+        protected override MultiplayerGameplayLeaderboard CreateLeaderboard()
+        {
+            return new TestLeaderboard(MultiplayerUsers.ToArray())
             {
                 Anchor = Anchor.Centre,
                 Origin = Anchor.Centre,
             };
         }
+
+        [Test]
+        public void TestPerUserMods()
+        {
+            AddStep("first user has no mods", () => Assert.That(((TestLeaderboard)Leaderboard).UserMods[0], Is.Empty));
+            AddStep("last user has NF mod", () =>
+            {
+                Assert.That(((TestLeaderboard)Leaderboard).UserMods[TOTAL_USERS - 1], Has.One.Items);
+                Assert.That(((TestLeaderboard)Leaderboard).UserMods[TOTAL_USERS - 1].Single(), Is.TypeOf<OsuModNoFail>());
+            });
+        }
+
+        private class TestLeaderboard : MultiplayerGameplayLeaderboard
+        {
+            public Dictionary<int, IReadOnlyList<Mod>> UserMods => UserScores.ToDictionary(kvp => kvp.Key, kvp => kvp.Value.ScoreProcessor.Mods);
+
+            public TestLeaderboard(MultiplayerRoomUser[] users)
+                : base(users)
+            {
+            }
+        }
     }
 }
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboardTeams.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboardTeams.cs
index 5caab9487e..c25884039f 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboardTeams.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboardTeams.cs
@@ -5,7 +5,6 @@ using System.Linq;
 using osu.Framework.Graphics;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Multiplayer.MatchTypes.TeamVersus;
-using osu.Game.Rulesets.Osu.Scoring;
 using osu.Game.Screens.OnlinePlay.Multiplayer;
 using osu.Game.Screens.Play.HUD;
 
@@ -25,8 +24,8 @@ namespace osu.Game.Tests.Visual.Multiplayer
             return user;
         }
 
-        protected override MultiplayerGameplayLeaderboard CreateLeaderboard(OsuScoreProcessor scoreProcessor) =>
-            new MultiplayerGameplayLeaderboard(Ruleset.Value, scoreProcessor, MultiplayerUsers.ToArray())
+        protected override MultiplayerGameplayLeaderboard CreateLeaderboard() =>
+            new MultiplayerGameplayLeaderboard(MultiplayerUsers.ToArray())
             {
                 Anchor = Anchor.Centre,
                 Origin = Anchor.Centre,
diff --git a/osu.Game/Online/Spectator/SpectatorClient.cs b/osu.Game/Online/Spectator/SpectatorClient.cs
index 3c31acca01..527f6d06ce 100644
--- a/osu.Game/Online/Spectator/SpectatorClient.cs
+++ b/osu.Game/Online/Spectator/SpectatorClient.cs
@@ -39,7 +39,7 @@ namespace osu.Game.Online.Spectator
         /// <summary>
         /// The states of all users currently being watched.
         /// </summary>
-        public IBindableDictionary<int, SpectatorState> WatchedUserStates => watchedUserStates;
+        public virtual IBindableDictionary<int, SpectatorState> WatchedUserStates => watchedUserStates;
 
         /// <summary>
         /// A global list of all players currently playing.
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayer.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayer.cs
index 3bf8a09cb9..f4bfec169d 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayer.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayer.cs
@@ -82,7 +82,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
             LocalUserPlaying.BindValueChanged(_ => updateLeaderboardExpandedState(), true);
 
             // todo: this should be implemented via a custom HUD implementation, and correctly masked to the main content area.
-            LoadComponentAsync(leaderboard = new MultiplayerGameplayLeaderboard(GameplayState.Ruleset.RulesetInfo, ScoreProcessor, users), l =>
+            LoadComponentAsync(leaderboard = new MultiplayerGameplayLeaderboard(users), l =>
             {
                 if (!LoadedBeatmapSuccessfully)
                     return;
@@ -149,16 +149,9 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
 
         protected override void StartGameplay()
         {
-            // We can enter this screen one of two ways:
-            // 1. Via the automatic natural progression of PlayerLoader into Player.
-            //    We'll arrive here in a Loaded state, and we need to let the server know that we're ready to start.
-            // 2. Via the server forcefully starting gameplay because players have been hanging out in PlayerLoader for too long.
-            //    We'll arrive here in a Playing state, and we should neither show the loading spinner nor tell the server that we're ready to start (gameplay has already started).
-            //
-            // The base call is blocked here because in both cases gameplay is started only when the server says so via onGameplayStarted().
-
             if (client.LocalUser?.State == MultiplayerUserState.Loaded)
             {
+                // block base call, but let the server know we are ready to start.
                 loadingDisplay.Show();
                 client.ChangeState(MultiplayerUserState.ReadyForGameplay);
             }
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorLeaderboard.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorLeaderboard.cs
index 4545913db8..589f5ce988 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorLeaderboard.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorLeaderboard.cs
@@ -2,19 +2,16 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
-using JetBrains.Annotations;
 using osu.Framework.Timing;
 using osu.Game.Online.Multiplayer;
-using osu.Game.Rulesets;
-using osu.Game.Rulesets.Scoring;
 using osu.Game.Screens.Play.HUD;
 
 namespace osu.Game.Screens.OnlinePlay.Multiplayer.Spectate
 {
     public class MultiSpectatorLeaderboard : MultiplayerGameplayLeaderboard
     {
-        public MultiSpectatorLeaderboard(RulesetInfo ruleset, [NotNull] ScoreProcessor scoreProcessor, MultiplayerRoomUser[] users)
-            : base(ruleset, scoreProcessor, users)
+        public MultiSpectatorLeaderboard(MultiplayerRoomUser[] users)
+            : base(users)
         {
         }
 
@@ -23,52 +20,15 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Spectate
             if (!UserScores.TryGetValue(userId, out var data))
                 throw new ArgumentException(@"Provided user is not tracked by this leaderboard", nameof(userId));
 
-            ((SpectatingTrackedUserData)data).Clock = clock;
+            data.ScoreProcessor.Clock = new FramedClock(clock);
         }
 
-        public void RemoveClock(int userId)
-        {
-            if (!UserScores.TryGetValue(userId, out var data))
-                throw new ArgumentException(@"Provided user is not tracked by this leaderboard", nameof(userId));
-
-            ((SpectatingTrackedUserData)data).Clock = null;
-        }
-
-        protected override TrackedUserData CreateUserData(MultiplayerRoomUser user, RulesetInfo ruleset, ScoreProcessor scoreProcessor) => new SpectatingTrackedUserData(user, ruleset, scoreProcessor);
-
         protected override void Update()
         {
             base.Update();
 
             foreach (var (_, data) in UserScores)
-                data.UpdateScore();
-        }
-
-        private class SpectatingTrackedUserData : TrackedUserData
-        {
-            [CanBeNull]
-            public IClock Clock;
-
-            public SpectatingTrackedUserData(MultiplayerRoomUser user, RulesetInfo ruleset, ScoreProcessor scoreProcessor)
-                : base(user, ruleset, scoreProcessor)
-            {
-            }
-
-            public override void UpdateScore()
-            {
-                if (Frames.Count == 0)
-                    return;
-
-                if (Clock == null)
-                    return;
-
-                int frameIndex = Frames.BinarySearch(new TimedFrame(Clock.CurrentTime));
-                if (frameIndex < 0)
-                    frameIndex = ~frameIndex;
-                frameIndex = Math.Clamp(frameIndex - 1, 0, Frames.Count - 1);
-
-                SetFrame(Frames[frameIndex]);
-            }
+                data.ScoreProcessor.UpdateScore();
         }
     }
 }
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorScreen.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorScreen.cs
index 2d03276fe5..d9c19cdfdd 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorScreen.cs
@@ -128,12 +128,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Spectate
                 syncManager.AddPlayerClock(instances[i].GameplayClock);
             }
 
-            // Todo: This is not quite correct - it should be per-user to adjust for other mod combinations.
-            var playableBeatmap = Beatmap.Value.GetPlayableBeatmap(Ruleset.Value);
-            var scoreProcessor = Ruleset.Value.CreateInstance().CreateScoreProcessor();
-            scoreProcessor.ApplyBeatmap(playableBeatmap);
-
-            LoadComponentAsync(leaderboard = new MultiSpectatorLeaderboard(Ruleset.Value, scoreProcessor, users)
+            LoadComponentAsync(leaderboard = new MultiSpectatorLeaderboard(users)
             {
                 Expanded = { Value = true },
             }, l =>
@@ -240,7 +235,6 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Spectate
 
             instance.FadeColour(colours.Gray4, 400, Easing.OutQuint);
             syncManager.RemovePlayerClock(instance.GameplayClock);
-            leaderboard.RemoveClock(userId);
         }
 
         public override bool OnBackButton()
diff --git a/osu.Game/Screens/Play/HUD/MultiplayerGameplayLeaderboard.cs b/osu.Game/Screens/Play/HUD/MultiplayerGameplayLeaderboard.cs
index 41b40e9a91..5ee6000cf0 100644
--- a/osu.Game/Screens/Play/HUD/MultiplayerGameplayLeaderboard.cs
+++ b/osu.Game/Screens/Play/HUD/MultiplayerGameplayLeaderboard.cs
@@ -5,6 +5,7 @@ using System;
 using System.Collections.Generic;
 using System.Collections.Specialized;
 using System.Linq;
+using System.Threading;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Extensions;
@@ -17,9 +18,7 @@ using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Multiplayer.MatchTypes.TeamVersus;
 using osu.Game.Online.Spectator;
-using osu.Game.Rulesets;
 using osu.Game.Rulesets.Scoring;
-using osu.Game.Scoring;
 using osuTK.Graphics;
 
 namespace osu.Game.Screens.Play.HUD
@@ -43,8 +42,6 @@ namespace osu.Game.Screens.Play.HUD
         [Resolved]
         private UserLookupCache userLookupCache { get; set; }
 
-        private readonly RulesetInfo ruleset;
-        private readonly ScoreProcessor scoreProcessor;
         private readonly MultiplayerRoomUser[] playingUsers;
         private Bindable<ScoringMode> scoringMode;
 
@@ -55,57 +52,56 @@ namespace osu.Game.Screens.Play.HUD
         /// <summary>
         /// Construct a new leaderboard.
         /// </summary>
-        /// <param name="ruleset">The ruleset.</param>
-        /// <param name="scoreProcessor">A score processor instance to handle score calculation for scores of users in the match.</param>
         /// <param name="users">IDs of all users in this match.</param>
-        public MultiplayerGameplayLeaderboard(RulesetInfo ruleset, ScoreProcessor scoreProcessor, MultiplayerRoomUser[] users)
+        public MultiplayerGameplayLeaderboard(MultiplayerRoomUser[] users)
         {
-            // todo: this will eventually need to be created per user to support different mod combinations.
-            this.ruleset = ruleset;
-            this.scoreProcessor = scoreProcessor;
-
             playingUsers = users;
         }
 
         [BackgroundDependencyLoader]
-        private void load(OsuConfigManager config, IAPIProvider api)
+        private void load(OsuConfigManager config, IAPIProvider api, CancellationToken cancellationToken)
         {
             scoringMode = config.GetBindable<ScoringMode>(OsuSetting.ScoreDisplayMode);
 
             foreach (var user in playingUsers)
             {
-                var trackedUser = CreateUserData(user, ruleset, scoreProcessor);
-
-                trackedUser.ScoringMode.BindTo(scoringMode);
-                trackedUser.Score.BindValueChanged(_ => Scheduler.AddOnce(updateTotals));
+                var scoreProcessor = new SpectatorScoreProcessor(user.UserID);
+                scoreProcessor.Mode.BindTo(scoringMode);
+                scoreProcessor.TotalScore.BindValueChanged(_ => Scheduler.AddOnce(updateTotals));
+                AddInternal(scoreProcessor);
 
+                var trackedUser = new TrackedUserData(user, scoreProcessor);
                 UserScores[user.UserID] = trackedUser;
 
                 if (trackedUser.Team is int team && !TeamScores.ContainsKey(team))
                     TeamScores.Add(team, new BindableLong());
             }
 
-            userLookupCache.GetUsersAsync(playingUsers.Select(u => u.UserID).ToArray()).ContinueWith(task => Schedule(() =>
-            {
-                var users = task.GetResultSafely();
+            userLookupCache.GetUsersAsync(playingUsers.Select(u => u.UserID).ToArray(), cancellationToken)
+                           .ContinueWith(task =>
+                           {
+                               Schedule(() =>
+                               {
+                                   var users = task.GetResultSafely();
 
-                for (int i = 0; i < users.Length; i++)
-                {
-                    var user = users[i] ?? new APIUser
-                    {
-                        Id = playingUsers[i].UserID,
-                        Username = "Unknown user",
-                    };
+                                   for (int i = 0; i < users.Length; i++)
+                                   {
+                                       var user = users[i] ?? new APIUser
+                                       {
+                                           Id = playingUsers[i].UserID,
+                                           Username = "Unknown user",
+                                       };
 
-                    var trackedUser = UserScores[user.Id];
+                                       var trackedUser = UserScores[user.Id];
 
-                    var leaderboardScore = Add(user, user.Id == api.LocalUser.Value.Id);
-                    leaderboardScore.Accuracy.BindTo(trackedUser.Accuracy);
-                    leaderboardScore.TotalScore.BindTo(trackedUser.Score);
-                    leaderboardScore.Combo.BindTo(trackedUser.CurrentCombo);
-                    leaderboardScore.HasQuit.BindTo(trackedUser.UserQuit);
-                }
-            }));
+                                       var leaderboardScore = Add(user, user.Id == api.LocalUser.Value.Id);
+                                       leaderboardScore.Accuracy.BindTo(trackedUser.ScoreProcessor.Accuracy);
+                                       leaderboardScore.TotalScore.BindTo(trackedUser.ScoreProcessor.TotalScore);
+                                       leaderboardScore.Combo.BindTo(trackedUser.ScoreProcessor.Combo);
+                                       leaderboardScore.HasQuit.BindTo(trackedUser.UserQuit);
+                                   }
+                               });
+                           }, cancellationToken);
         }
 
         protected override void LoadComplete()
@@ -118,20 +114,15 @@ namespace osu.Game.Screens.Play.HUD
                 spectatorClient.WatchUser(user.UserID);
 
                 if (!multiplayerClient.CurrentMatchPlayingUserIds.Contains(user.UserID))
-                    usersChanged(this, new NotifyCollectionChangedEventArgs(NotifyCollectionChangedAction.Remove, new[] { user.UserID }));
+                    playingUsersChanged(this, new NotifyCollectionChangedEventArgs(NotifyCollectionChangedAction.Remove, new[] { user.UserID }));
             }
 
             // bind here is to support players leaving the match.
             // new players are not supported.
             playingUserIds.BindTo(multiplayerClient.CurrentMatchPlayingUserIds);
-            playingUserIds.BindCollectionChanged(usersChanged);
-
-            // this leaderboard should be guaranteed to be completely loaded before the gameplay starts (is a prerequisite in MultiplayerPlayer).
-            spectatorClient.OnNewFrames += handleIncomingFrames;
+            playingUserIds.BindCollectionChanged(playingUsersChanged);
         }
 
-        protected virtual TrackedUserData CreateUserData(MultiplayerRoomUser user, RulesetInfo ruleset, ScoreProcessor scoreProcessor) => new TrackedUserData(user, ruleset, scoreProcessor);
-
         protected override GameplayLeaderboardScore CreateLeaderboardScoreDrawable(APIUser user, bool isTracked)
         {
             var leaderboardScore = base.CreateLeaderboardScoreDrawable(user, isTracked);
@@ -157,7 +148,7 @@ namespace osu.Game.Screens.Play.HUD
             }
         }
 
-        private void usersChanged(object sender, NotifyCollectionChangedEventArgs e)
+        private void playingUsersChanged(object sender, NotifyCollectionChangedEventArgs e)
         {
             switch (e.Action)
             {
@@ -174,15 +165,6 @@ namespace osu.Game.Screens.Play.HUD
             }
         }
 
-        private void handleIncomingFrames(int userId, FrameDataBundle bundle) => Schedule(() =>
-        {
-            if (!UserScores.TryGetValue(userId, out var trackedData))
-                return;
-
-            trackedData.Frames.Add(new TimedFrame(bundle.Frames.First().Time, bundle.Header));
-            trackedData.UpdateScore();
-        });
-
         private void updateTotals()
         {
             if (!hasTeams)
@@ -196,7 +178,7 @@ namespace osu.Game.Screens.Play.HUD
                     continue;
 
                 if (TeamScores.TryGetValue(u.Team.Value, out var team))
-                    team.Value += (int)Math.Round(u.Score.Value);
+                    team.Value += (int)Math.Round(u.ScoreProcessor.TotalScore.Value);
             }
         }
 
@@ -207,83 +189,26 @@ namespace osu.Game.Screens.Play.HUD
             if (spectatorClient != null)
             {
                 foreach (var user in playingUsers)
-                {
                     spectatorClient.StopWatchingUser(user.UserID);
-                }
-
-                spectatorClient.OnNewFrames -= handleIncomingFrames;
             }
         }
 
         protected class TrackedUserData
         {
             public readonly MultiplayerRoomUser User;
-            public readonly ScoreProcessor ScoreProcessor;
+            public readonly SpectatorScoreProcessor ScoreProcessor;
 
-            public readonly BindableDouble Score = new BindableDouble();
-            public readonly BindableDouble Accuracy = new BindableDouble(1);
-            public readonly BindableInt CurrentCombo = new BindableInt();
             public readonly BindableBool UserQuit = new BindableBool();
 
-            public readonly IBindable<ScoringMode> ScoringMode = new Bindable<ScoringMode>();
-
-            public readonly List<TimedFrame> Frames = new List<TimedFrame>();
-
             public int? Team => (User.MatchState as TeamVersusUserState)?.TeamID;
 
-            private readonly ScoreInfo scoreInfo;
-
-            public TrackedUserData(MultiplayerRoomUser user, RulesetInfo ruleset, ScoreProcessor scoreProcessor)
+            public TrackedUserData(MultiplayerRoomUser user, SpectatorScoreProcessor scoreProcessor)
             {
                 User = user;
                 ScoreProcessor = scoreProcessor;
-
-                scoreInfo = new ScoreInfo { Ruleset = ruleset };
-
-                ScoringMode.BindValueChanged(_ => UpdateScore());
             }
 
             public void MarkUserQuit() => UserQuit.Value = true;
-
-            public virtual void UpdateScore()
-            {
-                if (Frames.Count == 0)
-                    return;
-
-                SetFrame(Frames.Last());
-            }
-
-            protected void SetFrame(TimedFrame frame)
-            {
-                var header = frame.Header;
-
-                scoreInfo.MaxCombo = header.MaxCombo;
-                scoreInfo.Statistics = header.Statistics;
-
-                Score.Value = ScoreProcessor.ComputePartialScore(ScoringMode.Value, scoreInfo);
-
-                Accuracy.Value = header.Accuracy;
-                CurrentCombo.Value = header.Combo;
-            }
-        }
-
-        protected class TimedFrame : IComparable<TimedFrame>
-        {
-            public readonly double Time;
-            public readonly FrameHeader Header;
-
-            public TimedFrame(double time)
-            {
-                Time = time;
-            }
-
-            public TimedFrame(double time, FrameHeader header)
-            {
-                Time = time;
-                Header = header;
-            }
-
-            public int CompareTo(TimedFrame other) => Time.CompareTo(other.Time);
         }
     }
 }

From 17174a7b099b753a2d6c8e7c90754f2060c8f163 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 30 May 2022 19:29:13 +0900
Subject: [PATCH 5119/5547] Ensure some results have been loaded in playlist
 results screen tests

Basically, the failing delayed test would fire two web requests during
the proceedings. In unfortunate timing, the first would succeed and the
test would think "everything is okay", but the actual request loading
results has not yet run.

This check ensures *something* is loaded, which seems to be enough to
make things reliable.
---
 .../Visual/Playlists/TestScenePlaylistsResultsScreen.cs         | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsResultsScreen.cs b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsResultsScreen.cs
index f5fe00458a..c532e8bc05 100644
--- a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsResultsScreen.cs
+++ b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsResultsScreen.cs
@@ -173,6 +173,8 @@ namespace osu.Game.Tests.Visual.Playlists
         {
             AddUntilStep("wait for scores loaded", () =>
                 requestComplete
+                // request handler may need to fire more than once to get scores.
+                && totalCount > 0
                 && resultsScreen.ScorePanelList.GetScorePanels().Count() == totalCount
                 && resultsScreen.ScorePanelList.AllPanelsVisible);
             AddWaitStep("wait for display", 5);

From 82a1ba1d46650bf11164e26537ddfa64ae995c84 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 30 May 2022 17:42:27 +0900
Subject: [PATCH 5120/5547] Use pooled memory for memory copies performed by
 `ZipArchiveReader`

---
 osu.Game/IO/Archives/ZipArchiveReader.cs | 56 +++++++++++++++++++++---
 osu.Game/osu.Game.csproj                 |  1 +
 2 files changed, 51 insertions(+), 6 deletions(-)

diff --git a/osu.Game/IO/Archives/ZipArchiveReader.cs b/osu.Game/IO/Archives/ZipArchiveReader.cs
index 80dfa104f3..ae2b85da51 100644
--- a/osu.Game/IO/Archives/ZipArchiveReader.cs
+++ b/osu.Game/IO/Archives/ZipArchiveReader.cs
@@ -1,11 +1,15 @@
 // 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.Buffers;
 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;
 
 namespace osu.Game.IO.Archives
 {
@@ -27,15 +31,12 @@ namespace osu.Game.IO.Archives
             if (entry == null)
                 throw new FileNotFoundException();
 
-            // allow seeking
-            MemoryStream copy = new MemoryStream();
+            var owner = MemoryAllocator.Default.Allocate<byte>((int)entry.Size);
 
             using (Stream s = entry.OpenEntryStream())
-                s.CopyTo(copy);
+                s.ReadToFill(owner.Memory.Span);
 
-            copy.Position = 0;
-
-            return copy;
+            return new MemoryOwnerMemoryStream(owner);
         }
 
         public override void Dispose()
@@ -45,5 +46,48 @@ namespace osu.Game.IO.Archives
         }
 
         public override IEnumerable<string> Filenames => archive.Entries.Select(e => e.Key).ExcludeSystemFileNames();
+
+        private class MemoryOwnerMemoryStream : Stream
+        {
+            private readonly IMemoryOwner<byte> owner;
+            private readonly Stream stream;
+
+            public MemoryOwnerMemoryStream(IMemoryOwner<byte> owner)
+            {
+                this.owner = owner;
+
+                stream = owner.Memory.AsStream();
+            }
+
+            protected override void Dispose(bool disposing)
+            {
+                owner?.Dispose();
+                base.Dispose(disposing);
+            }
+
+            public override void Flush() => stream.Flush();
+
+            public override int Read(byte[] buffer, int offset, int count) => stream.Read(buffer, offset, count);
+
+            public override long Seek(long offset, SeekOrigin origin) => stream.Seek(offset, origin);
+
+            public override void SetLength(long value) => stream.SetLength(value);
+
+            public override void Write(byte[] buffer, int offset, int count) => stream.Write(buffer, offset, count);
+
+            public override bool CanRead => stream.CanRead;
+
+            public override bool CanSeek => stream.CanSeek;
+
+            public override bool CanWrite => stream.CanWrite;
+
+            public override long Length => stream.Length;
+
+            public override long Position
+            {
+                get => stream.Position;
+                set => stream.Position = value;
+            }
+        }
     }
 }
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 79cfd7c917..6ce21ccad6 100644
--- a/osu.Game/osu.Game.csproj
+++ b/osu.Game/osu.Game.csproj
@@ -29,6 +29,7 @@
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="5.0.14" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.Core" Version="5.0.14" />
     <PackageReference Include="Microsoft.Extensions.Configuration.Abstractions" Version="6.0.0" />
+    <PackageReference Include="Microsoft.Toolkit.HighPerformance" Version="7.1.2" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
     <PackageReference Include="ppy.LocalisationAnalyser" Version="2022.417.0">
       <PrivateAssets>all</PrivateAssets>

From d6b18d87b8f7c14bb078dca1863a4283ee16cb7f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 30 May 2022 19:58:47 +0900
Subject: [PATCH 5121/5547] Update framework

---
 osu.Android.props        | 2 +-
 osu.Game/osu.Game.csproj | 2 +-
 osu.iOS.props            | 4 ++--
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Android.props b/osu.Android.props
index c28085557e..116c7dbfcd 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -52,7 +52,7 @@
   </ItemGroup>
   <ItemGroup>
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.527.0" />
-    <PackageReference Include="ppy.osu.Framework.Android" Version="2022.529.0" />
+    <PackageReference Include="ppy.osu.Framework.Android" Version="2022.530.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
     <!-- Realm needs to be directly referenced in all Xamarin projects, as it will not pull in its transitive dependencies otherwise. -->
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 6ce21ccad6..eb47d0468f 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="10.11.2" />
-    <PackageReference Include="ppy.osu.Framework" Version="2022.529.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2022.530.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.527.0" />
     <PackageReference Include="Sentry" Version="3.17.1" />
     <PackageReference Include="SharpCompress" Version="0.31.0" />
diff --git a/osu.iOS.props b/osu.iOS.props
index b1ba64beba..ccecad6f82 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -61,7 +61,7 @@
     <Reference Include="System.Net.Http" />
   </ItemGroup>
   <ItemGroup Label="Package References">
-    <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.529.0" />
+    <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.530.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.527.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net6.0) -->
@@ -84,7 +84,7 @@
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="5.0.14" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.Core" Version="5.0.14" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
-    <PackageReference Include="ppy.osu.Framework" Version="2022.529.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2022.530.0" />
     <PackageReference Include="SharpCompress" Version="0.31.0" />
     <PackageReference Include="NUnit" Version="3.13.3" />
     <PackageReference Include="System.ComponentModel.Annotations" Version="5.0.0" />

From 0d7fa3b55cd0b7e1822b1d73e42969ee3e4d5be6 Mon Sep 17 00:00:00 2001
From: tornac1234 <tortornac@gmail.com>
Date: Mon, 30 May 2022 22:38:47 +0200
Subject: [PATCH 5122/5547] Added rulesets rankings updating for Discord RPC

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

diff --git a/osu.Desktop/DiscordRichPresence.cs b/osu.Desktop/DiscordRichPresence.cs
index d87b25a4c7..9f3a5b2f07 100644
--- a/osu.Desktop/DiscordRichPresence.cs
+++ b/osu.Desktop/DiscordRichPresence.cs
@@ -2,6 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
+using System.Collections.Generic;
 using System.Text;
 using DiscordRPC;
 using DiscordRPC.Message;
@@ -12,6 +13,7 @@ using osu.Framework.Logging;
 using osu.Game.Configuration;
 using osu.Game.Extensions;
 using osu.Game.Online.API;
+using osu.Game.Online.API.Requests;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets;
 using osu.Game.Users;
@@ -30,6 +32,9 @@ namespace osu.Desktop
 
         private IBindable<APIUser> user;
 
+        [Resolved]
+        private IAPIProvider api { get; set; }
+
         private readonly IBindable<UserStatus> status = new Bindable<UserStatus>();
         private readonly IBindable<UserActivity> activity = new Bindable<UserActivity>();
 
@@ -66,7 +71,7 @@ namespace osu.Desktop
                 activity.BindTo(u.NewValue.Activity);
             }, true);
 
-            ruleset.BindValueChanged(_ => updateStatus());
+            ruleset.BindValueChanged(_ => requestUserRulesetsRankings());
             status.BindValueChanged(_ => updateStatus());
             activity.BindValueChanged(_ => updateStatus());
             privacyMode.BindValueChanged(_ => updateStatus());
@@ -77,7 +82,7 @@ namespace osu.Desktop
         private void onReady(object _, ReadyMessage __)
         {
             Logger.Log("Discord RPC Client ready.", LoggingTarget.Network, LogLevel.Debug);
-            updateStatus();
+            requestUserRulesetsRankings();
         }
 
         private void updateStatus()
@@ -106,7 +111,12 @@ namespace osu.Desktop
             if (privacyMode.Value == DiscordRichPresenceMode.Limited)
                 presence.Assets.LargeImageText = string.Empty;
             else
-                presence.Assets.LargeImageText = $"{user.Value.Username}" + (user.Value.Statistics?.GlobalRank > 0 ? $" (rank #{user.Value.Statistics.GlobalRank:N0})" : string.Empty);
+            {
+                if (user.Value.RulesetsStatistics != null && user.Value.RulesetsStatistics.TryGetValue(ruleset.Value.ShortName, out UserStatistics statistics))
+                    presence.Assets.LargeImageText = $"{user.Value.Username}" + (statistics.GlobalRank > 0 ? $" (rank #{statistics.GlobalRank:N0})" : string.Empty);
+                else
+                    presence.Assets.LargeImageText = $"{user.Value.Username}" + (user.Value.Statistics?.GlobalRank > 0 ? $" (rank #{user.Value.Statistics.GlobalRank:N0})" : string.Empty);
+            }
 
             // update ruleset
             presence.Assets.SmallImageKey = ruleset.Value.IsLegacyRuleset() ? $"mode_{ruleset.Value.OnlineID}" : "mode_custom";
@@ -115,6 +125,47 @@ namespace osu.Desktop
             client.SetPresence(presence);
         }
 
+        private void requestUserRulesetsRankings()
+        {
+            RulesetInfo cachedRuleset = ruleset.Value;
+
+            // When first logging in, we can't send a request with an empty id
+            if (api.LocalUser.Value.Id > 1)
+            {
+                var req = new GetUsersRequest(new int[] { api.LocalUser.Value.Id });
+                req.Success += result =>
+                {
+                    if (result.Users.Count == 1)
+                    {
+                        APIUser apiUser = result.Users[0];
+                        user.Value.RulesetsStatistics = apiUser.RulesetsStatistics;
+                    }
+
+                    updateStatus();
+                };
+                req.Failure += _ => updateStatus();
+
+                api.Queue(req);
+            }
+            else
+            {
+                var req = new GetUserRequest(api.LocalUser.Value.Username, ruleset.Value);
+
+                req.Success += result =>
+                {
+                    user.Value.RulesetsStatistics ??= new Dictionary<string, UserStatistics>();
+                    user.Value.RulesetsStatistics[ruleset.Value.ShortName] = result.Statistics;
+                    updateStatus();
+                };
+                req.Failure += error =>
+                {
+                    updateStatus();
+                };
+
+                api.Queue(req);
+            }
+        }
+
         private static readonly int ellipsis_length = Encoding.UTF8.GetByteCount(new[] { '…' });
 
         private string truncate(string str)

From a3f5e2458dd1a88d8448e157f2d751f9bcc7a2c6 Mon Sep 17 00:00:00 2001
From: tornac1234 <tortornac@gmail.com>
Date: Mon, 30 May 2022 22:39:49 +0200
Subject: [PATCH 5123/5547] Show beatmap star rating in RPC

---
 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 9f3a5b2f07..32c6931930 100644
--- a/osu.Desktop/DiscordRichPresence.cs
+++ b/osu.Desktop/DiscordRichPresence.cs
@@ -192,7 +192,7 @@ namespace osu.Desktop
             switch (activity)
             {
                 case UserActivity.InGame game:
-                    return game.BeatmapInfo.ToString();
+                    return $"[{Math.Round(game.BeatmapInfo.StarRating, 2)}*] {game.BeatmapInfo}";
 
                 case UserActivity.Editing edit:
                     return edit.BeatmapInfo.ToString();

From bc1b20291bab23b2532b89985290b64e7fee169f Mon Sep 17 00:00:00 2001
From: tornac1234 <tortornac@gmail.com>
Date: Mon, 30 May 2022 23:12:39 +0200
Subject: [PATCH 5124/5547] Revert "Show beatmap star rating in RPC"

This reverts commit a3f5e2458dd1a88d8448e157f2d751f9bcc7a2c6.
---
 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 32c6931930..9f3a5b2f07 100644
--- a/osu.Desktop/DiscordRichPresence.cs
+++ b/osu.Desktop/DiscordRichPresence.cs
@@ -192,7 +192,7 @@ namespace osu.Desktop
             switch (activity)
             {
                 case UserActivity.InGame game:
-                    return $"[{Math.Round(game.BeatmapInfo.StarRating, 2)}*] {game.BeatmapInfo}";
+                    return game.BeatmapInfo.ToString();
 
                 case UserActivity.Editing edit:
                     return edit.BeatmapInfo.ToString();

From 80fa90f65d149d806a05a2e616f047616591ae04 Mon Sep 17 00:00:00 2001
From: tornac1234 <tortornac@gmail.com>
Date: Mon, 30 May 2022 23:23:54 +0200
Subject: [PATCH 5125/5547] Removed a useless branch in the statistics request

---
 osu.Desktop/DiscordRichPresence.cs | 43 ++++++++----------------------
 1 file changed, 11 insertions(+), 32 deletions(-)

diff --git a/osu.Desktop/DiscordRichPresence.cs b/osu.Desktop/DiscordRichPresence.cs
index 9f3a5b2f07..44a3a1622c 100644
--- a/osu.Desktop/DiscordRichPresence.cs
+++ b/osu.Desktop/DiscordRichPresence.cs
@@ -71,7 +71,7 @@ namespace osu.Desktop
                 activity.BindTo(u.NewValue.Activity);
             }, true);
 
-            ruleset.BindValueChanged(_ => requestUserRulesetsRankings());
+            ruleset.BindValueChanged(_ => updateStatus());
             status.BindValueChanged(_ => updateStatus());
             activity.BindValueChanged(_ => updateStatus());
             privacyMode.BindValueChanged(_ => updateStatus());
@@ -129,41 +129,20 @@ namespace osu.Desktop
         {
             RulesetInfo cachedRuleset = ruleset.Value;
 
-            // When first logging in, we can't send a request with an empty id
-            if (api.LocalUser.Value.Id > 1)
+            var req = new GetUsersRequest(new int[] { api.LocalUser.Value.Id });
+            req.Success += result =>
             {
-                var req = new GetUsersRequest(new int[] { api.LocalUser.Value.Id });
-                req.Success += result =>
+                if (result.Users.Count == 1)
                 {
-                    if (result.Users.Count == 1)
-                    {
-                        APIUser apiUser = result.Users[0];
-                        user.Value.RulesetsStatistics = apiUser.RulesetsStatistics;
-                    }
+                    APIUser apiUser = result.Users[0];
+                    user.Value.RulesetsStatistics = apiUser.RulesetsStatistics;
+                }
 
-                    updateStatus();
-                };
-                req.Failure += _ => updateStatus();
+                updateStatus();
+            };
+            req.Failure += _ => updateStatus();
 
-                api.Queue(req);
-            }
-            else
-            {
-                var req = new GetUserRequest(api.LocalUser.Value.Username, ruleset.Value);
-
-                req.Success += result =>
-                {
-                    user.Value.RulesetsStatistics ??= new Dictionary<string, UserStatistics>();
-                    user.Value.RulesetsStatistics[ruleset.Value.ShortName] = result.Statistics;
-                    updateStatus();
-                };
-                req.Failure += error =>
-                {
-                    updateStatus();
-                };
-
-                api.Queue(req);
-            }
+            api.Queue(req);
         }
 
         private static readonly int ellipsis_length = Encoding.UTF8.GetByteCount(new[] { '…' });

From bcee9ac438cfbf755741279f3c2e9aaee19ec794 Mon Sep 17 00:00:00 2001
From: tornac1234 <tortornac@gmail.com>
Date: Mon, 30 May 2022 23:32:55 +0200
Subject: [PATCH 5126/5547] Removed IAPIProvider from load and unified it's
 usage

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

diff --git a/osu.Desktop/DiscordRichPresence.cs b/osu.Desktop/DiscordRichPresence.cs
index 44a3a1622c..14fea7a08d 100644
--- a/osu.Desktop/DiscordRichPresence.cs
+++ b/osu.Desktop/DiscordRichPresence.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.Text;
 using DiscordRPC;
 using DiscordRPC.Message;
@@ -33,7 +32,7 @@ namespace osu.Desktop
         private IBindable<APIUser> user;
 
         [Resolved]
-        private IAPIProvider api { get; set; }
+        private IAPIProvider provider { get; set; }
 
         private readonly IBindable<UserStatus> status = new Bindable<UserStatus>();
         private readonly IBindable<UserActivity> activity = new Bindable<UserActivity>();
@@ -46,7 +45,7 @@ namespace osu.Desktop
         };
 
         [BackgroundDependencyLoader]
-        private void load(IAPIProvider provider, OsuConfigManager config)
+        private void load(OsuConfigManager config)
         {
             client = new DiscordRpcClient(client_id)
             {
@@ -129,7 +128,7 @@ namespace osu.Desktop
         {
             RulesetInfo cachedRuleset = ruleset.Value;
 
-            var req = new GetUsersRequest(new int[] { api.LocalUser.Value.Id });
+            var req = new GetUsersRequest(new int[] { provider.LocalUser.Value.Id });
             req.Success += result =>
             {
                 if (result.Users.Count == 1)
@@ -142,7 +141,7 @@ namespace osu.Desktop
             };
             req.Failure += _ => updateStatus();
 
-            api.Queue(req);
+            provider.Queue(req);
         }
 
         private static readonly int ellipsis_length = Encoding.UTF8.GetByteCount(new[] { '…' });

From 477e520766ef2924e4bbc37ab5cb33cf085debfe Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 31 May 2022 12:24:44 +0900
Subject: [PATCH 5127/5547] Add comment regarding deadlock avoidance

---
 osu.Game/Tests/Visual/OnlinePlay/OnlinePlayTestScene.cs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Game/Tests/Visual/OnlinePlay/OnlinePlayTestScene.cs b/osu.Game/Tests/Visual/OnlinePlay/OnlinePlayTestScene.cs
index 32e42a945d..df3974664e 100644
--- a/osu.Game/Tests/Visual/OnlinePlay/OnlinePlayTestScene.cs
+++ b/osu.Game/Tests/Visual/OnlinePlay/OnlinePlayTestScene.cs
@@ -83,6 +83,7 @@ namespace osu.Game.Tests.Visual.OnlinePlay
 #pragma warning disable RS0030
                 // We can't GetResultSafely() here (will fail with "Can't use GetResultSafely from inside an async operation."), but Wait is safe enough due to
                 // the task being a TaskCompletionSource.
+                // Importantly, this doesn't deadlock because of the scheduler call above running inline where feasible (see the `false` argument).
                 return tcs.Task.Result;
 #pragma warning restore RS0030
             };

From 53844d3df1548a1db0c31ebc6cd82b9b529655af Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 31 May 2022 14:01:42 +0900
Subject: [PATCH 5128/5547] Refactor settings item "warning" text to allow
 non-warning state

---
 .../Visual/Settings/TestSceneSettingsItem.cs  | 19 +++++----
 .../Sections/Graphics/LayoutSettings.cs       |  8 ++--
 .../Sections/Graphics/RendererSettings.cs     | 11 +++++-
 .../Settings/Sections/Input/MouseSettings.cs  |  4 +-
 .../Settings/Sections/Input/TabletSettings.cs |  5 ++-
 .../UserInterface/MainMenuSettings.cs         |  5 ++-
 osu.Game/Overlays/Settings/SettingsItem.cs    | 39 +++++++++++--------
 .../Overlays/Settings/SettingsNoticeText.cs   | 19 ---------
 8 files changed, 57 insertions(+), 53 deletions(-)
 delete mode 100644 osu.Game/Overlays/Settings/SettingsNoticeText.cs

diff --git a/osu.Game.Tests/Visual/Settings/TestSceneSettingsItem.cs b/osu.Game.Tests/Visual/Settings/TestSceneSettingsItem.cs
index 83265e13ad..f631e1603b 100644
--- a/osu.Game.Tests/Visual/Settings/TestSceneSettingsItem.cs
+++ b/osu.Game.Tests/Visual/Settings/TestSceneSettingsItem.cs
@@ -6,6 +6,7 @@ using NUnit.Framework;
 using osu.Framework.Bindables;
 using osu.Framework.Testing;
 using osu.Framework.Utils;
+using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Overlays.Settings;
@@ -83,7 +84,7 @@ namespace osu.Game.Tests.Visual.Settings
             AddStep("clear label", () => textBox.LabelText = default);
             AddAssert("default value button centre aligned to control size", () => Precision.AlmostEquals(restoreDefaultValueButton.Parent.DrawHeight, control.DrawHeight, 1));
 
-            AddStep("set warning text", () => textBox.WarningText = "This is some very important warning text! Hopefully it doesn't break the alignment of the default value indicator...");
+            AddStep("set warning text", () => textBox.SetWarningText("This is some very important warning text! Hopefully it doesn't break the alignment of the default value indicator..."));
             AddAssert("default value button centre aligned to control size", () => Precision.AlmostEquals(restoreDefaultValueButton.Parent.DrawHeight, control.DrawHeight, 1));
         }
 
@@ -129,16 +130,18 @@ namespace osu.Game.Tests.Visual.Settings
             SettingsNumberBox numberBox = null;
 
             AddStep("create settings item", () => Child = numberBox = new SettingsNumberBox());
-            AddAssert("warning text not created", () => !numberBox.ChildrenOfType<SettingsNoticeText>().Any());
+            AddAssert("warning text not created", () => !numberBox.ChildrenOfType<LinkFlowContainer>().Any());
 
-            AddStep("set warning text", () => numberBox.WarningText = "this is a warning!");
-            AddAssert("warning text created", () => numberBox.ChildrenOfType<SettingsNoticeText>().Single().Alpha == 1);
+            AddStep("set warning text", () => numberBox.SetWarningText("this is a warning!"));
+            AddAssert("warning text created", () => numberBox.ChildrenOfType<LinkFlowContainer>().Single().Alpha == 1);
 
-            AddStep("unset warning text", () => numberBox.WarningText = default);
-            AddAssert("warning text hidden", () => numberBox.ChildrenOfType<SettingsNoticeText>().Single().Alpha == 0);
+            AddStep("unset warning text", () => numberBox.ClearWarningText());
+            AddAssert("warning text hidden", () => !numberBox.ChildrenOfType<LinkFlowContainer>().Any());
 
-            AddStep("set warning text again", () => numberBox.WarningText = "another warning!");
-            AddAssert("warning text shown again", () => numberBox.ChildrenOfType<SettingsNoticeText>().Single().Alpha == 1);
+            AddStep("set warning text again", () => numberBox.SetWarningText("another warning!"));
+            AddAssert("warning text shown again", () => numberBox.ChildrenOfType<LinkFlowContainer>().Single().Alpha == 1);
+
+            AddStep("set non warning text", () => numberBox.SetWarningText("you did good!", false));
         }
     }
 }
diff --git a/osu.Game/Overlays/Settings/Sections/Graphics/LayoutSettings.cs b/osu.Game/Overlays/Settings/Sections/Graphics/LayoutSettings.cs
index 69a50c19b4..1ebe5aa85e 100644
--- a/osu.Game/Overlays/Settings/Sections/Graphics/LayoutSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Graphics/LayoutSettings.cs
@@ -226,7 +226,7 @@ namespace osu.Game.Overlays.Settings.Sections.Graphics
         {
             if (windowModeDropdown.Current.Value != WindowMode.Fullscreen)
             {
-                windowModeDropdown.WarningText = GraphicsSettingsStrings.NotFullscreenNote;
+                windowModeDropdown.SetWarningText(GraphicsSettingsStrings.NotFullscreenNote);
                 return;
             }
 
@@ -234,15 +234,15 @@ namespace osu.Game.Overlays.Settings.Sections.Graphics
             {
                 case FullscreenCapability.Unknown:
                     if (host.Window is WindowsWindow)
-                        windowModeDropdown.WarningText = LayoutSettingsStrings.CheckingForFullscreenCapabilities;
+                        windowModeDropdown.SetWarningText(LayoutSettingsStrings.CheckingForFullscreenCapabilities);
                     break;
 
                 case FullscreenCapability.Capable:
-                    windowModeDropdown.WarningText = LayoutSettingsStrings.OsuIsRunningExclusiveFullscreen;
+                    windowModeDropdown.SetWarningText(LayoutSettingsStrings.OsuIsRunningExclusiveFullscreen, false);
                     break;
 
                 case FullscreenCapability.Incapable:
-                    windowModeDropdown.WarningText = LayoutSettingsStrings.UnableToRunExclusiveFullscreen;
+                    windowModeDropdown.SetWarningText(LayoutSettingsStrings.UnableToRunExclusiveFullscreen);
                     break;
             }
         }
diff --git a/osu.Game/Overlays/Settings/Sections/Graphics/RendererSettings.cs b/osu.Game/Overlays/Settings/Sections/Graphics/RendererSettings.cs
index 653f30a018..6ec4decdda 100644
--- a/osu.Game/Overlays/Settings/Sections/Graphics/RendererSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Graphics/RendererSettings.cs
@@ -48,7 +48,16 @@ namespace osu.Game.Overlays.Settings.Sections.Graphics
 
             frameLimiterDropdown.Current.BindValueChanged(limit =>
             {
-                frameLimiterDropdown.WarningText = limit.NewValue == FrameSync.Unlimited ? GraphicsSettingsStrings.UnlimitedFramesNote : default;
+                switch (limit.NewValue)
+                {
+                    case FrameSync.Unlimited:
+                        frameLimiterDropdown.SetWarningText(GraphicsSettingsStrings.UnlimitedFramesNote);
+                        break;
+
+                    default:
+                        frameLimiterDropdown.ClearWarningText();
+                        break;
+                }
             }, true);
         }
     }
diff --git a/osu.Game/Overlays/Settings/Sections/Input/MouseSettings.cs b/osu.Game/Overlays/Settings/Sections/Input/MouseSettings.cs
index 4235dc0a05..042cec106a 100644
--- a/osu.Game/Overlays/Settings/Sections/Input/MouseSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Input/MouseSettings.cs
@@ -117,9 +117,9 @@ namespace osu.Game.Overlays.Settings.Sections.Input
                 if (RuntimeInfo.OS != RuntimeInfo.Platform.Windows)
                 {
                     if (highPrecision.NewValue)
-                        highPrecisionMouse.WarningText = MouseSettingsStrings.HighPrecisionPlatformWarning;
+                        highPrecisionMouse.SetWarningText(MouseSettingsStrings.HighPrecisionPlatformWarning);
                     else
-                        highPrecisionMouse.WarningText = null;
+                        highPrecisionMouse.ClearWarningText();
                 }
             }, true);
         }
diff --git a/osu.Game/Overlays/Settings/Sections/Input/TabletSettings.cs b/osu.Game/Overlays/Settings/Sections/Input/TabletSettings.cs
index 802d442ced..5d31c38ae7 100644
--- a/osu.Game/Overlays/Settings/Sections/Input/TabletSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Input/TabletSettings.cs
@@ -11,6 +11,7 @@ using osu.Framework.Localisation;
 using osu.Framework.Platform;
 using osu.Framework.Threading;
 using osu.Game.Graphics;
+using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
 using osuTK;
 using osu.Game.Localisation;
@@ -95,11 +96,13 @@ namespace osu.Game.Overlays.Settings.Sections.Input
                             Origin = Anchor.TopCentre,
                             Text = TabletSettingsStrings.NoTabletDetected,
                         },
-                        new SettingsNoticeText(colours)
+                        new LinkFlowContainer(cp => cp.Colour = colours.Yellow)
                         {
                             TextAnchor = Anchor.TopCentre,
                             Anchor = Anchor.TopCentre,
                             Origin = Anchor.TopCentre,
+                            RelativeSizeAxes = Axes.X,
+                            AutoSizeAxes = Axes.Y,
                         }.With(t =>
                         {
                             if (RuntimeInfo.OS == RuntimeInfo.Platform.Windows || RuntimeInfo.OS == RuntimeInfo.Platform.Linux)
diff --git a/osu.Game/Overlays/Settings/Sections/UserInterface/MainMenuSettings.cs b/osu.Game/Overlays/Settings/Sections/UserInterface/MainMenuSettings.cs
index 284e9cb2de..d3cc889abe 100644
--- a/osu.Game/Overlays/Settings/Sections/UserInterface/MainMenuSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/UserInterface/MainMenuSettings.cs
@@ -61,7 +61,10 @@ namespace osu.Game.Overlays.Settings.Sections.UserInterface
 
             user.BindValueChanged(u =>
             {
-                backgroundSourceDropdown.WarningText = u.NewValue?.IsSupporter != true ? UserInterfaceStrings.NotSupporterNote : default;
+                if (u.NewValue?.IsSupporter != true)
+                    backgroundSourceDropdown.SetWarningText(UserInterfaceStrings.NotSupporterNote);
+                else
+                    backgroundSourceDropdown.ClearWarningText();
             }, true);
         }
     }
diff --git a/osu.Game/Overlays/Settings/SettingsItem.cs b/osu.Game/Overlays/Settings/SettingsItem.cs
index ee9daa1c0d..fa521c0126 100644
--- a/osu.Game/Overlays/Settings/SettingsItem.cs
+++ b/osu.Game/Overlays/Settings/SettingsItem.cs
@@ -70,27 +70,32 @@ namespace osu.Game.Overlays.Settings
         }
 
         /// <summary>
-        /// Text to be displayed at the bottom of this <see cref="SettingsItem{T}"/>.
+        /// Clear any warning text.
+        /// </summary>
+        public void ClearWarningText()
+        {
+            warningText?.Expire();
+            warningText = null;
+        }
+
+        /// <summary>
+        /// Set the text to be displayed at the bottom of this <see cref="SettingsItem{T}"/>.
         /// Generally used to recommend the user change their setting as the current one is considered sub-optimal.
         /// </summary>
-        public LocalisableString? WarningText
+        /// <param name="text">The text to display.</param>
+        /// <param name="isWarning">Whether the text is in a warning state. Will decide how this is visually represented.</param>
+        public void SetWarningText(LocalisableString text, bool isWarning = true)
         {
-            set
+            ClearWarningText();
+
+            // construct lazily for cases where the label is not needed (may be provided by the Control).
+            FlowContent.Add(warningText = new LinkFlowContainer(cp => cp.Colour = isWarning ? colours.Yellow : colours.Green)
             {
-                bool hasValue = value != default;
-
-                if (warningText == null)
-                {
-                    if (!hasValue)
-                        return;
-
-                    // construct lazily for cases where the label is not needed (may be provided by the Control).
-                    FlowContent.Add(warningText = new SettingsNoticeText(colours) { Margin = new MarginPadding { Bottom = 5 } });
-                }
-
-                warningText.Alpha = hasValue ? 1 : 0;
-                warningText.Text = value ?? default;
-            }
+                RelativeSizeAxes = Axes.X,
+                AutoSizeAxes = Axes.Y,
+                Margin = new MarginPadding { Bottom = 5 },
+                Text = text,
+            });
         }
 
         public virtual Bindable<T> Current
diff --git a/osu.Game/Overlays/Settings/SettingsNoticeText.cs b/osu.Game/Overlays/Settings/SettingsNoticeText.cs
deleted file mode 100644
index 76ecf7edd4..0000000000
--- a/osu.Game/Overlays/Settings/SettingsNoticeText.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.Graphics;
-using osu.Game.Graphics;
-using osu.Game.Graphics.Containers;
-
-namespace osu.Game.Overlays.Settings
-{
-    public class SettingsNoticeText : LinkFlowContainer
-    {
-        public SettingsNoticeText(OsuColour colours)
-            : base(s => s.Colour = colours.Yellow)
-        {
-            RelativeSizeAxes = Axes.X;
-            AutoSizeAxes = Axes.Y;
-        }
-    }
-}

From f7110116de361f40e6c8aeb76b761eb250714c9b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 31 May 2022 14:04:56 +0900
Subject: [PATCH 5129/5547] Only display exclusive fullscreen hinting on
 windows

---
 .../Sections/Graphics/LayoutSettings.cs       | 27 ++++++++++++-------
 1 file changed, 17 insertions(+), 10 deletions(-)

diff --git a/osu.Game/Overlays/Settings/Sections/Graphics/LayoutSettings.cs b/osu.Game/Overlays/Settings/Sections/Graphics/LayoutSettings.cs
index 1ebe5aa85e..53f84a9bb2 100644
--- a/osu.Game/Overlays/Settings/Sections/Graphics/LayoutSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Graphics/LayoutSettings.cs
@@ -230,20 +230,27 @@ namespace osu.Game.Overlays.Settings.Sections.Graphics
                 return;
             }
 
-            switch (fullscreenCapability.Value)
+            if (host.Window is WindowsWindow)
             {
-                case FullscreenCapability.Unknown:
-                    if (host.Window is WindowsWindow)
+                switch (fullscreenCapability.Value)
+                {
+                    case FullscreenCapability.Unknown:
                         windowModeDropdown.SetWarningText(LayoutSettingsStrings.CheckingForFullscreenCapabilities);
-                    break;
+                        break;
 
-                case FullscreenCapability.Capable:
-                    windowModeDropdown.SetWarningText(LayoutSettingsStrings.OsuIsRunningExclusiveFullscreen, false);
-                    break;
+                    case FullscreenCapability.Capable:
+                        windowModeDropdown.SetWarningText(LayoutSettingsStrings.OsuIsRunningExclusiveFullscreen, false);
+                        break;
 
-                case FullscreenCapability.Incapable:
-                    windowModeDropdown.SetWarningText(LayoutSettingsStrings.UnableToRunExclusiveFullscreen);
-                    break;
+                    case FullscreenCapability.Incapable:
+                        windowModeDropdown.SetWarningText(LayoutSettingsStrings.UnableToRunExclusiveFullscreen);
+                        break;
+                }
+            }
+            else
+            {
+                // We can only detect exclusive fullscreen status on windows currently.
+                windowModeDropdown.ClearWarningText();
             }
         }
 

From 27efeb7d4e1ce134aeb923d8f2f456d6b5b70f4e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 31 May 2022 14:58:49 +0900
Subject: [PATCH 5130/5547] Fix `TimingSection` performing a beatmap save when
 switching bound timing points

---
 osu.Game/Screens/Edit/Timing/TimingSection.cs | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/osu.Game/Screens/Edit/Timing/TimingSection.cs b/osu.Game/Screens/Edit/Timing/TimingSection.cs
index a5abd96d72..bebd4c1049 100644
--- a/osu.Game/Screens/Edit/Timing/TimingSection.cs
+++ b/osu.Game/Screens/Edit/Timing/TimingSection.cs
@@ -32,9 +32,11 @@ namespace osu.Game.Screens.Edit.Timing
         {
             if (point.NewValue != null)
             {
+                bpmTextEntry.Current.UnbindEvents();
                 bpmTextEntry.Bindable = point.NewValue.BeatLengthBindable;
                 bpmTextEntry.Current.BindValueChanged(_ => ChangeHandler?.SaveState());
 
+                timeSignature.Current.UnbindEvents();
                 timeSignature.Current = point.NewValue.TimeSignatureBindable;
                 timeSignature.Current.BindValueChanged(_ => ChangeHandler?.SaveState());
             }

From cf5da44492a4d7da9c40d8e3f390e078e85cb94b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 31 May 2022 15:00:30 +0900
Subject: [PATCH 5131/5547] Add automatic control point tracking to the timing
 screen

---
 .../Visual/Editing/TestSceneTimingScreen.cs   | 48 ++++++++++++++-
 osu.Game/Screens/Edit/Timing/TimingScreen.cs  | 58 ++++++++++++++++++-
 2 files changed, 104 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneTimingScreen.cs b/osu.Game.Tests/Visual/Editing/TestSceneTimingScreen.cs
index 17b8189fc7..3a709cb66d 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneTimingScreen.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneTimingScreen.cs
@@ -1,14 +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.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics.Containers;
+using osu.Framework.Testing;
 using osu.Game.Overlays;
 using osu.Game.Rulesets.Edit;
 using osu.Game.Rulesets.Osu;
 using osu.Game.Screens.Edit;
 using osu.Game.Screens.Edit.Timing;
+using osu.Game.Screens.Edit.Timing.RowAttributes;
+using osuTK.Input;
 
 namespace osu.Game.Tests.Visual.Editing
 {
@@ -22,6 +26,8 @@ namespace osu.Game.Tests.Visual.Editing
         [Cached]
         private readonly OverlayColourProvider colourProvider = new OverlayColourProvider(OverlayColourScheme.Blue);
 
+        private TimingScreen timingScreen;
+
         protected override bool ScrollUsingMouseWheel => false;
 
         public TestSceneTimingScreen()
@@ -36,12 +42,52 @@ namespace osu.Game.Tests.Visual.Editing
             Beatmap.Value = CreateWorkingBeatmap(editorBeatmap.PlayableBeatmap);
             Beatmap.Disabled = true;
 
-            Child = new TimingScreen
+            Child = timingScreen = new TimingScreen
             {
                 State = { Value = Visibility.Visible },
             };
         }
 
+        [SetUpSteps]
+        public void SetUpSteps()
+        {
+            AddStep("Stop clock", () => Clock.Stop());
+        }
+
+        [Test]
+        public void TestTrackingCurrentTimeWhileRunning()
+        {
+            AddStep("Select first effect point", () =>
+            {
+                InputManager.MoveMouseTo(Child.ChildrenOfType<EffectRowAttribute>().First());
+                InputManager.Click(MouseButton.Left);
+            });
+
+            AddUntilStep("Selection changed", () => timingScreen.SelectedGroup.Value.Time == 54670);
+            AddUntilStep("Ensure seeked to correct time", () => Clock.CurrentTimeAccurate == 54670);
+
+            AddStep("Seek to just before next point", () => Clock.Seek(69000));
+            AddStep("Start clock", () => Clock.Start());
+
+            AddUntilStep("Selection changed", () => timingScreen.SelectedGroup.Value.Time == 69670);
+        }
+
+        [Test]
+        public void TestTrackingCurrentTimeWhilePaused()
+        {
+            AddStep("Select first effect point", () =>
+            {
+                InputManager.MoveMouseTo(Child.ChildrenOfType<EffectRowAttribute>().First());
+                InputManager.Click(MouseButton.Left);
+            });
+
+            AddUntilStep("Selection changed", () => timingScreen.SelectedGroup.Value.Time == 54670);
+            AddUntilStep("Ensure seeked to correct time", () => Clock.CurrentTimeAccurate == 54670);
+
+            AddStep("Seek to later", () => Clock.Seek(80000));
+            AddUntilStep("Selection changed", () => timingScreen.SelectedGroup.Value.Time == 69670);
+        }
+
         protected override void Dispose(bool isDisposing)
         {
             Beatmap.Disabled = false;
diff --git a/osu.Game/Screens/Edit/Timing/TimingScreen.cs b/osu.Game/Screens/Edit/Timing/TimingScreen.cs
index f71a8d7d22..0cf4fca58a 100644
--- a/osu.Game/Screens/Edit/Timing/TimingScreen.cs
+++ b/osu.Game/Screens/Edit/Timing/TimingScreen.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.Bindables;
@@ -19,7 +20,7 @@ namespace osu.Game.Screens.Edit.Timing
     public class TimingScreen : EditorScreenWithTimeline
     {
         [Cached]
-        private Bindable<ControlPointGroup> selectedGroup = new Bindable<ControlPointGroup>();
+        public readonly Bindable<ControlPointGroup> SelectedGroup = new Bindable<ControlPointGroup>();
 
         public TimingScreen()
             : base(EditorScreenMode.Timing)
@@ -132,6 +133,61 @@ namespace osu.Game.Screens.Edit.Timing
                 }, true);
             }
 
+            protected override void Update()
+            {
+                base.Update();
+
+                trackActivePoint();
+            }
+
+            /// <summary>
+            /// Given the user has selected a control point group, we want to track any group which is
+            /// active at the current point in time which matches the type the user has selected.
+            ///
+            /// So if the user is currently looking at a timing point and seeks into the future, a
+            /// future timing point would be automatically selected if it is now the new "current" point.
+            /// </summary>
+            private void trackActivePoint()
+            {
+                // For simplicity only match on the first type of the active control point.
+                var selectedPointType = selectedGroup.Value?.ControlPoints.FirstOrDefault()?.GetType();
+
+                if (selectedPointType != null)
+                {
+                    // 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.
+                    IEnumerable<ControlPointGroup> groups = Beatmap.ControlPointInfo.Groups;
+
+                    bool currentTimeBeforeSelectedGroup = clock.CurrentTimeAccurate < selectedGroup.Value.Time;
+
+                    // Decide whether we are searching backwards or forwards.
+                    if (currentTimeBeforeSelectedGroup)
+                        groups = groups.Reverse();
+
+                    // Find the next group which has the same type as the selected one.
+                    groups = groups.SkipWhile(g => g != selectedGroup.Value)
+                                   .Skip(1)
+                                   .Where(g => g.ControlPoints.Any(cp => cp.GetType() == selectedPointType));
+
+                    ControlPointGroup newGroup = groups.FirstOrDefault();
+
+                    if (newGroup != null)
+                    {
+                        if (currentTimeBeforeSelectedGroup)
+                        {
+                            // When seeking backwards, the first match from the LINQ query is always what we want.
+                            selectedGroup.Value = newGroup;
+                        }
+                        else
+                        {
+                            // When seeking forwards, we also need to check that the next match is before the current time.
+                            if (newGroup.Time <= clock.CurrentTimeAccurate)
+                                selectedGroup.Value = newGroup;
+                        }
+                    }
+                }
+            }
+
             private void delete()
             {
                 if (selectedGroup.Value == null)

From ebb83a5e497e69027aaaa9cef28704f7688e6d22 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 31 May 2022 15:10:55 +0900
Subject: [PATCH 5132/5547] Add TODO about scroll behaviour which is missing

---
 osu.Game/Screens/Edit/Timing/ControlPointTable.cs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Game/Screens/Edit/Timing/ControlPointTable.cs b/osu.Game/Screens/Edit/Timing/ControlPointTable.cs
index 0c12eff503..77d875b67f 100644
--- a/osu.Game/Screens/Edit/Timing/ControlPointTable.cs
+++ b/osu.Game/Screens/Edit/Timing/ControlPointTable.cs
@@ -61,6 +61,7 @@ namespace osu.Game.Screens.Edit.Timing
 
             selectedGroup.BindValueChanged(group =>
             {
+                // TODO: This should scroll the selected row into view.
                 foreach (var b in BackgroundFlow) b.Selected = b.Item == group.NewValue;
             }, true);
         }

From 9746cbb1610383ccafc7957335a393b895c007f0 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 31 May 2022 15:54:07 +0900
Subject: [PATCH 5133/5547] Ensure rows have loaded before attempting to click
 them

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

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneTimingScreen.cs b/osu.Game.Tests/Visual/Editing/TestSceneTimingScreen.cs
index 3a709cb66d..a358166477 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneTimingScreen.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneTimingScreen.cs
@@ -52,6 +52,8 @@ namespace osu.Game.Tests.Visual.Editing
         public void SetUpSteps()
         {
             AddStep("Stop clock", () => Clock.Stop());
+
+            AddUntilStep("wait for rows to load", () => Child.ChildrenOfType<EffectRowAttribute>().Any());
         }
 
         [Test]

From 132c94c1b57ce391c48a1446b29ab606ca61789f Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 31 May 2022 17:16:23 +0900
Subject: [PATCH 5134/5547] Remove Ruleset parameter from
 ResetFromReplayFrame()

---
 .../Gameplay/TestSceneScoreProcessor.cs        |  6 +++---
 .../Rulesets/Scoring/JudgementProcessor.cs     |  3 +--
 osu.Game/Rulesets/Scoring/ScoreProcessor.cs    | 18 +++++++-----------
 osu.Game/Rulesets/UI/RulesetInputManager.cs    |  6 +-----
 4 files changed, 12 insertions(+), 21 deletions(-)

diff --git a/osu.Game.Tests/Gameplay/TestSceneScoreProcessor.cs b/osu.Game.Tests/Gameplay/TestSceneScoreProcessor.cs
index 9c307341bd..af4b002bc9 100644
--- a/osu.Game.Tests/Gameplay/TestSceneScoreProcessor.cs
+++ b/osu.Game.Tests/Gameplay/TestSceneScoreProcessor.cs
@@ -61,13 +61,13 @@ namespace osu.Game.Tests.Gameplay
             Assert.That(scoreProcessor.JudgedHits, Is.EqualTo(1));
 
             // No header shouldn't cause any change
-            scoreProcessor.ResetFromReplayFrame(new OsuRuleset(), new OsuReplayFrame());
+            scoreProcessor.ResetFromReplayFrame(new OsuReplayFrame());
 
             Assert.That(scoreProcessor.TotalScore.Value, Is.EqualTo(1_000_000));
             Assert.That(scoreProcessor.JudgedHits, Is.EqualTo(1));
 
             // Reset with a miss instead.
-            scoreProcessor.ResetFromReplayFrame(new OsuRuleset(), new OsuReplayFrame
+            scoreProcessor.ResetFromReplayFrame(new OsuReplayFrame
             {
                 Header = new FrameHeader(0, 0, 0, new Dictionary<HitResult, int> { { HitResult.Miss, 1 } }, DateTimeOffset.Now)
             });
@@ -76,7 +76,7 @@ namespace osu.Game.Tests.Gameplay
             Assert.That(scoreProcessor.JudgedHits, Is.EqualTo(1));
 
             // Reset with no judged hit.
-            scoreProcessor.ResetFromReplayFrame(new OsuRuleset(), new OsuReplayFrame
+            scoreProcessor.ResetFromReplayFrame(new OsuReplayFrame
             {
                 Header = new FrameHeader(0, 0, 0, new Dictionary<HitResult, int>(), DateTimeOffset.Now)
             });
diff --git a/osu.Game/Rulesets/Scoring/JudgementProcessor.cs b/osu.Game/Rulesets/Scoring/JudgementProcessor.cs
index 94ddc32bb7..bfa67b8c45 100644
--- a/osu.Game/Rulesets/Scoring/JudgementProcessor.cs
+++ b/osu.Game/Rulesets/Scoring/JudgementProcessor.cs
@@ -117,9 +117,8 @@ namespace osu.Game.Rulesets.Scoring
         /// <remarks>
         /// If the provided replay frame does not have any header information, this will be a noop.
         /// </remarks>
-        /// <param name="ruleset">The ruleset to be used for retrieving statistics.</param>
         /// <param name="frame">The replay frame to read header statistics from.</param>
-        public virtual void ResetFromReplayFrame(Ruleset ruleset, ReplayFrame frame)
+        public virtual void ResetFromReplayFrame(ReplayFrame frame)
         {
             if (frame.Header == null)
                 return;
diff --git a/osu.Game/Rulesets/Scoring/ScoreProcessor.cs b/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
index 1dd1d1aeb6..1403a3f243 100644
--- a/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
+++ b/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
@@ -251,8 +251,7 @@ namespace osu.Game.Rulesets.Scoring
             if (!ruleset.RulesetInfo.Equals(scoreInfo.Ruleset))
                 throw new ArgumentException($"Unexpected score ruleset. Expected \"{ruleset.RulesetInfo.ShortName}\" but was \"{scoreInfo.Ruleset.ShortName}\".");
 
-            extractFromStatistics(ruleset,
-                scoreInfo.Statistics,
+            extractFromStatistics(scoreInfo.Statistics,
                 out double extractedBaseScore,
                 out double extractedMaxBaseScore,
                 out int extractedMaxCombo,
@@ -281,8 +280,7 @@ namespace osu.Game.Rulesets.Scoring
             if (!beatmapApplied)
                 throw new InvalidOperationException($"Cannot compute partial score without calling {nameof(ApplyBeatmap)}.");
 
-            extractFromStatistics(ruleset,
-                scoreInfo.Statistics,
+            extractFromStatistics(scoreInfo.Statistics,
                 out double extractedBaseScore,
                 out _,
                 out _,
@@ -318,9 +316,7 @@ namespace osu.Game.Rulesets.Scoring
             // Note: This cannot be applied universally to all legacy scores, as some rulesets (e.g. catch) group multiple judgements together.
             if (scoreInfo.IsLegacyScore && scoreInfo.Ruleset.OnlineID == 3)
             {
-                extractFromStatistics(
-                    ruleset,
-                    scoreInfo.Statistics,
+                extractFromStatistics(scoreInfo.Statistics,
                     out double computedBaseScore,
                     out double computedMaxBaseScore,
                     out _,
@@ -437,14 +433,14 @@ namespace osu.Game.Rulesets.Scoring
             score.TotalScore = (long)Math.Round(ComputeFinalScore(ScoringMode.Standardised, score));
         }
 
-        public override void ResetFromReplayFrame(Ruleset ruleset, ReplayFrame frame)
+        public override void ResetFromReplayFrame(ReplayFrame frame)
         {
-            base.ResetFromReplayFrame(ruleset, frame);
+            base.ResetFromReplayFrame(frame);
 
             if (frame.Header == null)
                 return;
 
-            extractFromStatistics(ruleset, frame.Header.Statistics, out baseScore, out rollingMaxBaseScore, out _, out _);
+            extractFromStatistics(frame.Header.Statistics, out baseScore, out rollingMaxBaseScore, out _, out _);
             HighestCombo.Value = frame.Header.MaxCombo;
 
             scoreResultCounts.Clear();
@@ -455,7 +451,7 @@ namespace osu.Game.Rulesets.Scoring
             OnResetFromReplayFrame?.Invoke();
         }
 
-        private void extractFromStatistics(Ruleset ruleset, IReadOnlyDictionary<HitResult, int> statistics, out double baseScore, out double maxBaseScore, out int maxCombo,
+        private void extractFromStatistics(IReadOnlyDictionary<HitResult, int> statistics, out double baseScore, out double maxBaseScore, out int maxCombo,
                                            out int basicHitObjects)
         {
             baseScore = 0;
diff --git a/osu.Game/Rulesets/UI/RulesetInputManager.cs b/osu.Game/Rulesets/UI/RulesetInputManager.cs
index 7d1b23f48b..b5390eb6e2 100644
--- a/osu.Game/Rulesets/UI/RulesetInputManager.cs
+++ b/osu.Game/Rulesets/UI/RulesetInputManager.cs
@@ -27,8 +27,6 @@ namespace osu.Game.Rulesets.UI
     {
         public readonly KeyBindingContainer<T> KeyBindingContainer;
 
-        private readonly Ruleset ruleset;
-
         [Resolved(CanBeNull = true)]
         private ScoreProcessor scoreProcessor { get; set; }
 
@@ -57,8 +55,6 @@ namespace osu.Game.Rulesets.UI
 
         protected RulesetInputManager(RulesetInfo ruleset, int variant, SimultaneousBindingMode unique)
         {
-            this.ruleset = ruleset.CreateInstance();
-
             InternalChild = KeyBindingContainer =
                 CreateKeyBindingContainer(ruleset, variant, unique)
                     .WithChild(content = new Container { RelativeSizeAxes = Axes.Both });
@@ -85,7 +81,7 @@ namespace osu.Game.Rulesets.UI
                     break;
 
                 case ReplayStatisticsFrameEvent statisticsStateChangeEvent:
-                    scoreProcessor?.ResetFromReplayFrame(ruleset, statisticsStateChangeEvent.Frame);
+                    scoreProcessor?.ResetFromReplayFrame(statisticsStateChangeEvent.Frame);
                     break;
 
                 default:

From 655780fd986785d65db914275157825f0fad5046 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 31 May 2022 18:27:18 +0900
Subject: [PATCH 5135/5547] Fix regression in bpm textbox binding logic

---
 osu.Game/Screens/Edit/Timing/TimingSection.cs | 24 +++++++++++++++----
 1 file changed, 19 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Screens/Edit/Timing/TimingSection.cs b/osu.Game/Screens/Edit/Timing/TimingSection.cs
index bebd4c1049..1a97058d73 100644
--- a/osu.Game/Screens/Edit/Timing/TimingSection.cs
+++ b/osu.Game/Screens/Edit/Timing/TimingSection.cs
@@ -28,17 +28,31 @@ namespace osu.Game.Screens.Edit.Timing
             });
         }
 
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            bpmTextEntry.Current.BindValueChanged(_ => saveChanges());
+            timeSignature.Current.BindValueChanged(_ => saveChanges());
+
+            void saveChanges()
+            {
+                if (!isRebinding) ChangeHandler?.SaveState();
+            }
+        }
+
+        private bool isRebinding;
+
         protected override void OnControlPointChanged(ValueChangedEvent<TimingControlPoint> point)
         {
             if (point.NewValue != null)
             {
-                bpmTextEntry.Current.UnbindEvents();
-                bpmTextEntry.Bindable = point.NewValue.BeatLengthBindable;
-                bpmTextEntry.Current.BindValueChanged(_ => ChangeHandler?.SaveState());
+                isRebinding = true;
 
-                timeSignature.Current.UnbindEvents();
+                bpmTextEntry.Bindable = point.NewValue.BeatLengthBindable;
                 timeSignature.Current = point.NewValue.TimeSignatureBindable;
-                timeSignature.Current.BindValueChanged(_ => ChangeHandler?.SaveState());
+
+                isRebinding = false;
             }
         }
 

From c0804803fd530beddd1f07ced27720b02ad92273 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 31 May 2022 18:09:26 +0900
Subject: [PATCH 5136/5547] Add background to main waveform row

---
 .../Edit/Timing/WaveformComparisonDisplay.cs       | 14 +++++++++++++-
 1 file changed, 13 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Edit/Timing/WaveformComparisonDisplay.cs b/osu.Game/Screens/Edit/Timing/WaveformComparisonDisplay.cs
index c80d3c4261..d212738d8d 100644
--- a/osu.Game/Screens/Edit/Timing/WaveformComparisonDisplay.cs
+++ b/osu.Game/Screens/Edit/Timing/WaveformComparisonDisplay.cs
@@ -63,7 +63,7 @@ namespace osu.Game.Screens.Edit.Timing
 
             for (int i = 0; i < total_waveforms; i++)
             {
-                AddInternal(new WaveformRow
+                AddInternal(new WaveformRow(i == total_waveforms / 2)
                 {
                     RelativeSizeAxes = Axes.Both,
                     RelativePositionAxes = Axes.Both,
@@ -177,17 +177,29 @@ namespace osu.Game.Screens.Edit.Timing
 
         internal class WaveformRow : CompositeDrawable
         {
+            private readonly bool isMainRow;
             private OsuSpriteText beatIndexText = null!;
             private WaveformGraph waveformGraph = null!;
 
             [Resolved]
             private OverlayColourProvider colourProvider { get; set; } = null!;
 
+            public WaveformRow(bool isMainRow)
+            {
+                this.isMainRow = isMainRow;
+            }
+
             [BackgroundDependencyLoader]
             private void load(IBindable<WorkingBeatmap> beatmap)
             {
                 InternalChildren = new Drawable[]
                 {
+                    new Box
+                    {
+                        Colour = colourProvider.Background3,
+                        Alpha = isMainRow ? 1 : 0,
+                        RelativeSizeAxes = Axes.Both,
+                    },
                     waveformGraph = new WaveformGraph
                     {
                         RelativeSizeAxes = Axes.Both,

From 6bc68ada4380a612c243e207c56d3691f60cce7a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 31 May 2022 16:15:53 +0900
Subject: [PATCH 5137/5547] Add ability to lock the `WaveformComparison`
 display to a current location

---
 .../Edit/Timing/WaveformComparisonDisplay.cs  | 86 ++++++++++++++++++-
 1 file changed, 85 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Edit/Timing/WaveformComparisonDisplay.cs b/osu.Game/Screens/Edit/Timing/WaveformComparisonDisplay.cs
index c80d3c4261..e86e75ad0d 100644
--- a/osu.Game/Screens/Edit/Timing/WaveformComparisonDisplay.cs
+++ b/osu.Game/Screens/Edit/Timing/WaveformComparisonDisplay.cs
@@ -14,6 +14,7 @@ using osu.Framework.Graphics.Shapes;
 using osu.Framework.Input.Events;
 using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.ControlPoints;
+using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.UserInterfaceV2;
 using osu.Game.Overlays;
@@ -26,6 +27,8 @@ namespace osu.Game.Screens.Edit.Timing
     {
         private const int total_waveforms = 8;
 
+        private const float corner_radius = LabelledDrawable<Drawable>.CORNER_RADIUS;
+
         private readonly BindableNumber<double> beatLength = new BindableDouble();
 
         [Resolved]
@@ -49,11 +52,18 @@ namespace osu.Game.Screens.Edit.Timing
 
         private readonly IBindableList<ControlPointGroup> controlPointGroups = new BindableList<ControlPointGroup>();
 
+        private readonly BindableBool displayLocked = new BindableBool();
+
+        private LockedOverlay lockedOverlay = null!;
+
+        [Resolved]
+        private OsuColour colours { get; set; } = null!;
+
         public WaveformComparisonDisplay()
         {
             RelativeSizeAxes = Axes.Both;
 
-            CornerRadius = LabelledDrawable<Drawable>.CORNER_RADIUS;
+            CornerRadius = corner_radius;
             Masking = true;
         }
 
@@ -81,12 +91,19 @@ namespace osu.Game.Screens.Edit.Timing
                 Width = 3,
             });
 
+            AddInternal(lockedOverlay = new LockedOverlay());
+
             selectedGroup.BindValueChanged(_ => updateTimingGroup(), true);
 
             controlPointGroups.BindTo(editorBeatmap.ControlPointInfo.Groups);
             controlPointGroups.BindCollectionChanged((_, __) => updateTimingGroup());
 
             beatLength.BindValueChanged(_ => showFrom(lastDisplayedBeatIndex), true);
+
+            displayLocked.BindValueChanged(locked =>
+            {
+                lockedOverlay.FadeTo(locked.NewValue ? 1 : 0, 200, Easing.OutQuint);
+            }, true);
         }
 
         private void updateTimingGroup()
@@ -130,6 +147,12 @@ namespace osu.Game.Screens.Edit.Timing
             return base.OnMouseMove(e);
         }
 
+        protected override bool OnClick(ClickEvent e)
+        {
+            displayLocked.Toggle();
+            return true;
+        }
+
         protected override void Update()
         {
             base.Update();
@@ -147,6 +170,9 @@ namespace osu.Game.Screens.Edit.Timing
             if (lastDisplayedBeatIndex == beatIndex)
                 return;
 
+            if (displayLocked.Value)
+                return;
+
             // Chosen as a pretty usable number across all BPMs.
             // Optimally we'd want this to scale with the BPM in question, but performing
             // scaling of the display is both expensive in resampling, and decreases usability
@@ -175,6 +201,64 @@ namespace osu.Game.Screens.Edit.Timing
             lastDisplayedBeatIndex = beatIndex;
         }
 
+        internal class LockedOverlay : CompositeDrawable
+        {
+            private OsuSpriteText text = null!;
+
+            [BackgroundDependencyLoader]
+            private void load(OsuColour colours)
+            {
+                RelativeSizeAxes = Axes.Both;
+                Masking = true;
+                CornerRadius = corner_radius;
+                BorderColour = colours.Red;
+                BorderThickness = 3;
+                Alpha = 0;
+
+                InternalChildren = new Drawable[]
+                {
+                    new Box
+                    {
+                        AlwaysPresent = true,
+                        RelativeSizeAxes = Axes.Both,
+                        Alpha = 0,
+                    },
+                    new Container
+                    {
+                        Anchor = Anchor.TopRight,
+                        Origin = Anchor.TopRight,
+                        AutoSizeAxes = Axes.Both,
+                        Children = new Drawable[]
+                        {
+                            new Box
+                            {
+                                Colour = colours.Red,
+                                RelativeSizeAxes = Axes.Both,
+                            },
+                            text = new OsuSpriteText
+                            {
+                                Colour = colours.GrayF,
+                                Text = "Locked",
+                                Margin = new MarginPadding(5),
+                                Shadow = false,
+                                Font = OsuFont.Default.With(size: 12, weight: FontWeight.SemiBold),
+                            }
+                        }
+                    },
+                };
+            }
+
+            protected override void LoadComplete()
+            {
+                base.LoadComplete();
+
+                text
+                    .FadeIn().Then().Delay(500)
+                    .FadeOut().Then().Delay(500)
+                    .Loop();
+            }
+        }
+
         internal class WaveformRow : CompositeDrawable
         {
             private OsuSpriteText beatIndexText = null!;

From c8f21ee8b2a8765477c62ff732678684869e010d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 31 May 2022 16:32:02 +0900
Subject: [PATCH 5138/5547] Change `WaveformComparisonDisplay` to centre around
 a time offset rather than beat

---
 .../Edit/Timing/WaveformComparisonDisplay.cs  | 48 +++++++++++--------
 1 file changed, 29 insertions(+), 19 deletions(-)

diff --git a/osu.Game/Screens/Edit/Timing/WaveformComparisonDisplay.cs b/osu.Game/Screens/Edit/Timing/WaveformComparisonDisplay.cs
index e86e75ad0d..46ecf3d9f2 100644
--- a/osu.Game/Screens/Edit/Timing/WaveformComparisonDisplay.cs
+++ b/osu.Game/Screens/Edit/Timing/WaveformComparisonDisplay.cs
@@ -45,7 +45,7 @@ namespace osu.Game.Screens.Edit.Timing
 
         private TimingControlPoint timingPoint = TimingControlPoint.DEFAULT;
 
-        private int lastDisplayedBeatIndex;
+        private double displayedTime;
 
         private double selectedGroupStartTime;
         private double selectedGroupEndTime;
@@ -56,9 +56,6 @@ namespace osu.Game.Screens.Edit.Timing
 
         private LockedOverlay lockedOverlay = null!;
 
-        [Resolved]
-        private OsuColour colours { get; set; } = null!;
-
         public WaveformComparisonDisplay()
         {
             RelativeSizeAxes = Axes.Both;
@@ -98,7 +95,7 @@ namespace osu.Game.Screens.Edit.Timing
             controlPointGroups.BindTo(editorBeatmap.ControlPointInfo.Groups);
             controlPointGroups.BindCollectionChanged((_, __) => updateTimingGroup());
 
-            beatLength.BindValueChanged(_ => showFrom(lastDisplayedBeatIndex), true);
+            beatLength.BindValueChanged(_ => regenerateDisplay(), true);
 
             displayLocked.BindValueChanged(locked =>
             {
@@ -139,10 +136,13 @@ namespace osu.Game.Screens.Edit.Timing
 
         protected override bool OnMouseMove(MouseMoveEvent e)
         {
-            float trackLength = (float)beatmap.Value.Track.Length;
-            int totalBeatsAvailable = (int)(trackLength / timingPoint.BeatLength);
+            if (!displayLocked.Value)
+            {
+                float trackLength = (float)beatmap.Value.Track.Length;
+                int totalBeatsAvailable = (int)(trackLength / timingPoint.BeatLength);
 
-            Scheduler.AddOnce(showFrom, (int)(e.MousePosition.X / DrawWidth * totalBeatsAvailable));
+                Scheduler.AddOnce(showFromBeat, (int)(e.MousePosition.X / DrawWidth * totalBeatsAvailable));
+            }
 
             return base.OnMouseMove(e);
         }
@@ -157,21 +157,29 @@ namespace osu.Game.Screens.Edit.Timing
         {
             base.Update();
 
-            if (!IsHovered)
+            if (!IsHovered && !displayLocked.Value)
             {
                 int currentBeat = (int)Math.Floor((editorClock.CurrentTimeAccurate - selectedGroupStartTime) / timingPoint.BeatLength);
 
-                showFrom(currentBeat);
+                showFromBeat(currentBeat);
             }
         }
 
-        private void showFrom(int beatIndex)
+        private void showFromBeat(int beatIndex) =>
+            showFromTime(selectedGroupStartTime + beatIndex * timingPoint.BeatLength);
+
+        private void showFromTime(double time)
         {
-            if (lastDisplayedBeatIndex == beatIndex)
+            if (displayedTime == time)
                 return;
 
-            if (displayLocked.Value)
-                return;
+            displayedTime = time;
+            regenerateDisplay();
+        }
+
+        private void regenerateDisplay()
+        {
+            double index = (displayedTime - selectedGroupStartTime) / timingPoint.BeatLength;
 
             // Chosen as a pretty usable number across all BPMs.
             // Optimally we'd want this to scale with the BPM in question, but performing
@@ -182,23 +190,25 @@ namespace osu.Game.Screens.Edit.Timing
             float trackLength = (float)beatmap.Value.Track.Length;
             float scale = trackLength / visible_width;
 
+            const int start_offset = total_waveforms / 2;
+
             // Start displaying from before the current beat
-            beatIndex -= total_waveforms / 2;
+            index -= start_offset;
 
             foreach (var row in InternalChildren.OfType<WaveformRow>())
             {
                 // offset to the required beat index.
-                double time = selectedGroupStartTime + beatIndex * timingPoint.BeatLength;
+                double time = selectedGroupStartTime + index * timingPoint.BeatLength;
 
                 float offset = (float)(time - visible_width / 2) / trackLength * scale;
 
                 row.Alpha = time < selectedGroupStartTime || time > selectedGroupEndTime ? 0.2f : 1;
                 row.WaveformOffset = -offset;
                 row.WaveformScale = new Vector2(scale, 1);
-                row.BeatIndex = beatIndex++;
-            }
+                row.BeatIndex = (int)Math.Floor(index);
 
-            lastDisplayedBeatIndex = beatIndex;
+                index++;
+            }
         }
 
         internal class LockedOverlay : CompositeDrawable

From 51014b8748a77964f0ff9b2266119e4e697e724b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 31 May 2022 16:59:19 +0900
Subject: [PATCH 5139/5547] Ensure offset changes are correctly tracked by the
 display, even when locked

---
 .../Edit/Timing/WaveformComparisonDisplay.cs  | 20 +++++++++++++------
 1 file changed, 14 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Screens/Edit/Timing/WaveformComparisonDisplay.cs b/osu.Game/Screens/Edit/Timing/WaveformComparisonDisplay.cs
index 46ecf3d9f2..390965fbea 100644
--- a/osu.Game/Screens/Edit/Timing/WaveformComparisonDisplay.cs
+++ b/osu.Game/Screens/Edit/Timing/WaveformComparisonDisplay.cs
@@ -107,29 +107,37 @@ namespace osu.Game.Screens.Edit.Timing
         {
             beatLength.UnbindBindings();
 
-            selectedGroupStartTime = 0;
-            selectedGroupEndTime = beatmap.Value.Track.Length;
-
             var tcp = selectedGroup.Value?.ControlPoints.OfType<TimingControlPoint>().FirstOrDefault();
 
             if (tcp == null)
             {
                 timingPoint = new TimingControlPoint();
+                // During movement of a control point's offset, this clause can be hit momentarily.
+                // We don't want to reset the `selectedGroupStartTime` here as we rely on having the
+                // last value to perform an offset traversal below.
+                selectedGroupEndTime = beatmap.Value.Track.Length;
                 return;
             }
 
             timingPoint = tcp;
             beatLength.BindTo(timingPoint.BeatLengthBindable);
 
-            selectedGroupStartTime = selectedGroup.Value?.Time ?? 0;
+            double? newStartTime = selectedGroup.Value?.Time;
+
+            if (newStartTime.HasValue && selectedGroupStartTime != newStartTime)
+            {
+                // The offset of the selected point may have changed.
+                // This handles the case the user has locked the view and expects the display to update with this change.
+                showFromTime(displayedTime + (newStartTime.Value - selectedGroupStartTime));
+            }
 
             var nextGroup = editorBeatmap.ControlPointInfo.TimingPoints
                                          .SkipWhile(g => g != tcp)
                                          .Skip(1)
                                          .FirstOrDefault();
 
-            if (nextGroup != null)
-                selectedGroupEndTime = nextGroup.Time;
+            selectedGroupStartTime = newStartTime ?? 0;
+            selectedGroupEndTime = nextGroup?.Time ?? beatmap.Value.Track.Length;
         }
 
         protected override bool OnHover(HoverEvent e) => true;

From 94194a04f2931f5068b9ebb9e01de5f6dd13d8b0 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 31 May 2022 18:05:38 +0900
Subject: [PATCH 5140/5547] Animate adjustments

---
 .../Edit/Timing/WaveformComparisonDisplay.cs  | 24 ++++++++++++-------
 1 file changed, 16 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Screens/Edit/Timing/WaveformComparisonDisplay.cs b/osu.Game/Screens/Edit/Timing/WaveformComparisonDisplay.cs
index 390965fbea..172f0ac9b1 100644
--- a/osu.Game/Screens/Edit/Timing/WaveformComparisonDisplay.cs
+++ b/osu.Game/Screens/Edit/Timing/WaveformComparisonDisplay.cs
@@ -95,7 +95,7 @@ namespace osu.Game.Screens.Edit.Timing
             controlPointGroups.BindTo(editorBeatmap.ControlPointInfo.Groups);
             controlPointGroups.BindCollectionChanged((_, __) => updateTimingGroup());
 
-            beatLength.BindValueChanged(_ => regenerateDisplay(), true);
+            beatLength.BindValueChanged(_ => regenerateDisplay(true), true);
 
             displayLocked.BindValueChanged(locked =>
             {
@@ -128,7 +128,7 @@ namespace osu.Game.Screens.Edit.Timing
             {
                 // The offset of the selected point may have changed.
                 // This handles the case the user has locked the view and expects the display to update with this change.
-                showFromTime(displayedTime + (newStartTime.Value - selectedGroupStartTime));
+                showFromTime(displayedTime + (newStartTime.Value - selectedGroupStartTime), true);
             }
 
             var nextGroup = editorBeatmap.ControlPointInfo.TimingPoints
@@ -174,18 +174,18 @@ namespace osu.Game.Screens.Edit.Timing
         }
 
         private void showFromBeat(int beatIndex) =>
-            showFromTime(selectedGroupStartTime + beatIndex * timingPoint.BeatLength);
+            showFromTime(selectedGroupStartTime + beatIndex * timingPoint.BeatLength, false);
 
-        private void showFromTime(double time)
+        private void showFromTime(double time, bool animated)
         {
             if (displayedTime == time)
                 return;
 
             displayedTime = time;
-            regenerateDisplay();
+            regenerateDisplay(animated);
         }
 
-        private void regenerateDisplay()
+        private void regenerateDisplay(bool animated)
         {
             double index = (displayedTime - selectedGroupStartTime) / timingPoint.BeatLength;
 
@@ -211,7 +211,7 @@ namespace osu.Game.Screens.Edit.Timing
                 float offset = (float)(time - visible_width / 2) / trackLength * scale;
 
                 row.Alpha = time < selectedGroupStartTime || time > selectedGroupEndTime ? 0.2f : 1;
-                row.WaveformOffset = -offset;
+                row.WaveformOffsetTo(-offset, animated);
                 row.WaveformScale = new Vector2(scale, 1);
                 row.BeatIndex = (int)Math.Floor(index);
 
@@ -314,7 +314,15 @@ namespace osu.Game.Screens.Edit.Timing
 
             public int BeatIndex { set => beatIndexText.Text = value.ToString(); }
             public Vector2 WaveformScale { set => waveformGraph.Scale = value; }
-            public float WaveformOffset { set => waveformGraph.X = value; }
+
+            public void WaveformOffsetTo(float value, bool animated) =>
+                this.TransformTo(nameof(waveformOffset), value, animated ? 300 : 0, Easing.OutQuint);
+
+            private float waveformOffset
+            {
+                get => waveformGraph.X;
+                set => waveformGraph.X = value;
+            }
         }
     }
 }

From 475cc8174ff036f626f883ab6a75774c960a5e74 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 31 May 2022 18:17:08 +0900
Subject: [PATCH 5141/5547] Fix off-by-one display issue when adjusting offset

---
 .../Edit/Timing/WaveformComparisonDisplay.cs      | 15 ++++++++-------
 1 file changed, 8 insertions(+), 7 deletions(-)

diff --git a/osu.Game/Screens/Edit/Timing/WaveformComparisonDisplay.cs b/osu.Game/Screens/Edit/Timing/WaveformComparisonDisplay.cs
index 172f0ac9b1..ce13a8a244 100644
--- a/osu.Game/Screens/Edit/Timing/WaveformComparisonDisplay.cs
+++ b/osu.Game/Screens/Edit/Timing/WaveformComparisonDisplay.cs
@@ -123,13 +123,7 @@ namespace osu.Game.Screens.Edit.Timing
             beatLength.BindTo(timingPoint.BeatLengthBindable);
 
             double? newStartTime = selectedGroup.Value?.Time;
-
-            if (newStartTime.HasValue && selectedGroupStartTime != newStartTime)
-            {
-                // The offset of the selected point may have changed.
-                // This handles the case the user has locked the view and expects the display to update with this change.
-                showFromTime(displayedTime + (newStartTime.Value - selectedGroupStartTime), true);
-            }
+            double? offsetChange = newStartTime - selectedGroupStartTime;
 
             var nextGroup = editorBeatmap.ControlPointInfo.TimingPoints
                                          .SkipWhile(g => g != tcp)
@@ -138,6 +132,13 @@ namespace osu.Game.Screens.Edit.Timing
 
             selectedGroupStartTime = newStartTime ?? 0;
             selectedGroupEndTime = nextGroup?.Time ?? beatmap.Value.Track.Length;
+
+            if (newStartTime.HasValue && offsetChange.HasValue)
+            {
+                // The offset of the selected point may have changed.
+                // This handles the case the user has locked the view and expects the display to update with this change.
+                showFromTime(displayedTime + offsetChange.Value, true);
+            }
         }
 
         protected override bool OnHover(HoverEvent e) => true;

From af0f934e1a1b47080aefb8f4353a411c3e20c732 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 31 May 2022 17:37:48 +0900
Subject: [PATCH 5142/5547] Move raw ScoreProcessor values into ScoringValues
 struct

---
 osu.Game/Rulesets/Scoring/ScoreProcessor.cs | 111 +++++++++++++-------
 osu.Game/Scoring/ScoringValues.cs           |  38 +++++++
 2 files changed, 111 insertions(+), 38 deletions(-)
 create mode 100644 osu.Game/Scoring/ScoringValues.cs

diff --git a/osu.Game/Rulesets/Scoring/ScoreProcessor.cs b/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
index 1403a3f243..493da763cb 100644
--- a/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
+++ b/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
@@ -88,17 +88,20 @@ namespace osu.Game.Rulesets.Scoring
         private readonly double accuracyPortion;
         private readonly double comboPortion;
 
-        private int maxAchievableCombo;
+        /// <summary>
+        /// Maximum achievable scoring values.
+        /// </summary>
+        private ScoringValues maximumScoringValues;
 
         /// <summary>
-        /// The maximum achievable base score.
+        /// Maximum achievable scoring values up to the current point in time.
         /// </summary>
-        private double maxBaseScore;
+        private ScoringValues rollingMaximumScoringValues;
 
         /// <summary>
-        /// The maximum number of basic (non-tick and non-bonus) hitobjects.
+        /// Scoring values for the current play.
         /// </summary>
-        private int maxBasicHitObjects;
+        private ScoringValues currentScoringValues;
 
         /// <summary>
         /// The maximum <see cref="HitResult"/> of a basic (non-tick and non-bonus) hitobject.
@@ -106,9 +109,6 @@ namespace osu.Game.Rulesets.Scoring
         /// </summary>
         private HitResult? maxBasicResult;
 
-        private double rollingMaxBaseScore;
-        private double baseScore;
-        private int basicHitObjects;
         private bool beatmapApplied;
 
         private readonly Dictionary<HitResult, int> scoreResultCounts = new Dictionary<HitResult, int>();
@@ -164,23 +164,42 @@ namespace osu.Game.Rulesets.Scoring
             scoreResultCounts[result.Type] = scoreResultCounts.GetValueOrDefault(result.Type) + 1;
 
             if (!result.Type.IsScorable())
-                return;
+            {
+                // The inverse of non-scorable (ignore) judgements may be bonus judgements.
+                if (result.Judgement.MaxResult.IsBonus())
+                    rollingMaximumScoringValues.BonusScore += result.Judgement.MaxNumericResult;
 
+                return;
+            }
+
+            // Update rolling combo.
             if (result.Type.IncreasesCombo())
                 Combo.Value++;
             else if (result.Type.BreaksCombo())
                 Combo.Value = 0;
 
-            double scoreIncrease = result.Type.IsHit() ? result.Judgement.NumericResultFor(result) : 0;
+            // Update maximum combo.
+            currentScoringValues.MaxCombo = HighestCombo.Value;
+            rollingMaximumScoringValues.MaxCombo += result.Judgement.MaxResult.AffectsCombo() ? 1 : 0;
 
-            if (!result.Type.IsBonus())
+            // Update base/bonus score.
+            if (result.Type.IsBonus())
             {
-                baseScore += scoreIncrease;
-                rollingMaxBaseScore += result.Judgement.MaxNumericResult;
+                currentScoringValues.BonusScore += result.Type.IsHit() ? result.Judgement.NumericResultFor(result) : 0;
+                rollingMaximumScoringValues.BonusScore += result.Judgement.MaxNumericResult;
+            }
+            else
+            {
+                currentScoringValues.BaseScore += result.Type.IsHit() ? result.Judgement.NumericResultFor(result) : 0;
+                rollingMaximumScoringValues.BaseScore += result.Judgement.MaxNumericResult;
             }
 
+            // Update hitobject count.
             if (result.Type.IsBasic())
-                basicHitObjects++;
+            {
+                currentScoringValues.HitObjects++;
+                rollingMaximumScoringValues.HitObjects++;
+            }
 
             hitEvents.Add(CreateHitEvent(result));
             lastHitObject = result.HitObject;
@@ -207,18 +226,36 @@ namespace osu.Game.Rulesets.Scoring
             scoreResultCounts[result.Type] = scoreResultCounts.GetValueOrDefault(result.Type) - 1;
 
             if (!result.Type.IsScorable())
-                return;
-
-            double scoreIncrease = result.Type.IsHit() ? result.Judgement.NumericResultFor(result) : 0;
-
-            if (!result.Type.IsBonus())
             {
-                baseScore -= scoreIncrease;
-                rollingMaxBaseScore -= result.Judgement.MaxNumericResult;
+                // The inverse of non-scorable (ignore) judgements may be bonus judgements.
+                if (result.Judgement.MaxResult.IsBonus())
+                    rollingMaximumScoringValues.BonusScore -= result.Judgement.MaxNumericResult;
+
+                return;
             }
 
+            // Update maximum combo.
+            currentScoringValues.MaxCombo = HighestCombo.Value;
+            rollingMaximumScoringValues.MaxCombo -= result.Judgement.MaxResult.AffectsCombo() ? 1 : 0;
+
+            // Update base/bonus score.
+            if (result.Type.IsBonus())
+            {
+                currentScoringValues.BonusScore -= result.Type.IsHit() ? result.Judgement.NumericResultFor(result) : 0;
+                rollingMaximumScoringValues.BonusScore -= result.Judgement.MaxNumericResult;
+            }
+            else
+            {
+                currentScoringValues.BaseScore -= result.Type.IsHit() ? result.Judgement.NumericResultFor(result) : 0;
+                rollingMaximumScoringValues.BaseScore -= result.Judgement.MaxNumericResult;
+            }
+
+            // Update hitobject count.
             if (result.Type.IsBasic())
-                basicHitObjects--;
+            {
+                currentScoringValues.HitObjects--;
+                rollingMaximumScoringValues.HitObjects--;
+            }
 
             Debug.Assert(hitEvents.Count > 0);
             lastHitObject = hitEvents[^1].LastHitObject;
@@ -229,12 +266,12 @@ namespace osu.Game.Rulesets.Scoring
 
         private void updateScore()
         {
-            double rollingAccuracyRatio = rollingMaxBaseScore > 0 ? baseScore / rollingMaxBaseScore : 1;
-            double accuracyRatio = maxBaseScore > 0 ? baseScore / maxBaseScore : 1;
-            double comboRatio = maxAchievableCombo > 0 ? (double)HighestCombo.Value / maxAchievableCombo : 1;
+            double rollingAccuracyRatio = rollingMaximumScoringValues.BaseScore > 0 ? currentScoringValues.BaseScore / rollingMaximumScoringValues.BaseScore : 1;
+            double accuracyRatio = maximumScoringValues.BaseScore > 0 ? currentScoringValues.BaseScore / maximumScoringValues.BaseScore : 1;
+            double comboRatio = maximumScoringValues.MaxCombo > 0 ? currentScoringValues.MaxCombo / maximumScoringValues.MaxCombo : 1;
 
             Accuracy.Value = rollingAccuracyRatio;
-            TotalScore.Value = ComputeScore(Mode.Value, accuracyRatio, comboRatio, getBonusScore(scoreResultCounts), maxBasicHitObjects);
+            TotalScore.Value = ComputeScore(Mode.Value, accuracyRatio, comboRatio, getBonusScore(scoreResultCounts), maximumScoringValues.HitObjects);
         }
 
         /// <summary>
@@ -286,10 +323,10 @@ namespace osu.Game.Rulesets.Scoring
                 out _,
                 out _);
 
-            double accuracyRatio = maxBaseScore > 0 ? extractedBaseScore / maxBaseScore : 1;
-            double comboRatio = maxAchievableCombo > 0 ? (double)scoreInfo.MaxCombo / maxAchievableCombo : 1;
+            double accuracyRatio = maximumScoringValues.BaseScore > 0 ? extractedBaseScore / maximumScoringValues.BaseScore : 1;
+            double comboRatio = maximumScoringValues.MaxCombo > 0 ? (double)scoreInfo.MaxCombo / maximumScoringValues.MaxCombo : 1;
 
-            return ComputeScore(mode, accuracyRatio, comboRatio, getBonusScore(scoreInfo.Statistics), maxBasicHitObjects);
+            return ComputeScore(mode, accuracyRatio, comboRatio, getBonusScore(scoreInfo.Statistics), maximumScoringValues.HitObjects);
         }
 
         /// <summary>
@@ -398,15 +435,10 @@ namespace osu.Game.Rulesets.Scoring
             lastHitObject = null;
 
             if (storeResults)
-            {
-                maxAchievableCombo = HighestCombo.Value;
-                maxBaseScore = baseScore;
-                maxBasicHitObjects = basicHitObjects;
-            }
+                maximumScoringValues = currentScoringValues;
 
-            baseScore = 0;
-            rollingMaxBaseScore = 0;
-            basicHitObjects = 0;
+            currentScoringValues = default;
+            rollingMaximumScoringValues = default;
 
             TotalScore.Value = 0;
             Accuracy.Value = 1;
@@ -440,7 +472,10 @@ namespace osu.Game.Rulesets.Scoring
             if (frame.Header == null)
                 return;
 
-            extractFromStatistics(frame.Header.Statistics, out baseScore, out rollingMaxBaseScore, out _, out _);
+            extractFromStatistics(frame.Header.Statistics, out double baseScore, out double rollingMaxBaseScore, out _, out _);
+            currentScoringValues.BaseScore = baseScore;
+            rollingMaximumScoringValues.BaseScore = rollingMaxBaseScore;
+
             HighestCombo.Value = frame.Header.MaxCombo;
 
             scoreResultCounts.Clear();
diff --git a/osu.Game/Scoring/ScoringValues.cs b/osu.Game/Scoring/ScoringValues.cs
new file mode 100644
index 0000000000..4b562c20e4
--- /dev/null
+++ b/osu.Game/Scoring/ScoringValues.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 MessagePack;
+using osu.Game.Rulesets.Judgements;
+using osu.Game.Rulesets.Objects;
+using osu.Game.Rulesets.Scoring;
+
+namespace osu.Game.Scoring
+{
+    [MessagePackObject]
+    public struct ScoringValues
+    {
+        /// <summary>
+        /// The sum of all "basic" <see cref="HitObject"/> scoring values. See: <see cref="HitResultExtensions.IsBasic"/> and <see cref="Judgement.ToNumericResult"/>.
+        /// </summary>
+        [Key(0)]
+        public double BaseScore;
+
+        /// <summary>
+        /// The sum of all "bonus" <see cref="HitObject"/> scoring values. See: <see cref="HitResultExtensions.IsBonus"/> and <see cref="Judgement.ToNumericResult"/>.
+        /// </summary>
+        [Key(1)]
+        public double BonusScore;
+
+        /// <summary>
+        /// The highest achieved combo.
+        /// </summary>
+        [Key(2)]
+        public int MaxCombo;
+
+        /// <summary>
+        /// The count of "basic" <see cref="HitObject"/>s. See: <see cref="HitResultExtensions.IsBasic"/>.
+        /// </summary>
+        [Key(3)]
+        public int HitObjects;
+    }
+}

From d0e3e50ca7c3ca2fa8b6a40ab74805b0e2904c58 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 31 May 2022 17:50:18 +0900
Subject: [PATCH 5143/5547] Extract score statistics directly into
 ScoringValues

---
 osu.Game/Rulesets/Scoring/ScoreProcessor.cs | 104 +++++++++-----------
 1 file changed, 49 insertions(+), 55 deletions(-)

diff --git a/osu.Game/Rulesets/Scoring/ScoreProcessor.cs b/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
index 493da763cb..c108380396 100644
--- a/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
+++ b/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
@@ -288,16 +288,12 @@ namespace osu.Game.Rulesets.Scoring
             if (!ruleset.RulesetInfo.Equals(scoreInfo.Ruleset))
                 throw new ArgumentException($"Unexpected score ruleset. Expected \"{ruleset.RulesetInfo.ShortName}\" but was \"{scoreInfo.Ruleset.ShortName}\".");
 
-            extractFromStatistics(scoreInfo.Statistics,
-                out double extractedBaseScore,
-                out double extractedMaxBaseScore,
-                out int extractedMaxCombo,
-                out int extractedBasicHitObjects);
+            extractFromStatistics(scoreInfo.Statistics, out var current, out var max);
 
-            double accuracyRatio = extractedMaxBaseScore > 0 ? extractedBaseScore / extractedMaxBaseScore : 1;
-            double comboRatio = extractedMaxCombo > 0 ? (double)scoreInfo.MaxCombo / extractedMaxCombo : 1;
+            double accuracyRatio = max.BaseScore > 0 ? current.BaseScore / max.BaseScore : 1;
+            double comboRatio = max.MaxCombo > 0 ? (double)scoreInfo.MaxCombo / max.MaxCombo : 1;
 
-            return ComputeScore(mode, accuracyRatio, comboRatio, getBonusScore(scoreInfo.Statistics), extractedBasicHitObjects);
+            return ComputeScore(mode, accuracyRatio, comboRatio, getBonusScore(scoreInfo.Statistics), max.HitObjects);
         }
 
         /// <summary>
@@ -317,13 +313,9 @@ namespace osu.Game.Rulesets.Scoring
             if (!beatmapApplied)
                 throw new InvalidOperationException($"Cannot compute partial score without calling {nameof(ApplyBeatmap)}.");
 
-            extractFromStatistics(scoreInfo.Statistics,
-                out double extractedBaseScore,
-                out _,
-                out _,
-                out _);
+            extractFromStatistics(scoreInfo.Statistics, out var current, out _);
 
-            double accuracyRatio = maximumScoringValues.BaseScore > 0 ? extractedBaseScore / maximumScoringValues.BaseScore : 1;
+            double accuracyRatio = maximumScoringValues.BaseScore > 0 ? current.BaseScore / maximumScoringValues.BaseScore : 1;
             double comboRatio = maximumScoringValues.MaxCombo > 0 ? (double)scoreInfo.MaxCombo / maximumScoringValues.MaxCombo : 1;
 
             return ComputeScore(mode, accuracyRatio, comboRatio, getBonusScore(scoreInfo.Statistics), maximumScoringValues.HitObjects);
@@ -353,14 +345,9 @@ namespace osu.Game.Rulesets.Scoring
             // Note: This cannot be applied universally to all legacy scores, as some rulesets (e.g. catch) group multiple judgements together.
             if (scoreInfo.IsLegacyScore && scoreInfo.Ruleset.OnlineID == 3)
             {
-                extractFromStatistics(scoreInfo.Statistics,
-                    out double computedBaseScore,
-                    out double computedMaxBaseScore,
-                    out _,
-                    out _);
-
-                if (computedMaxBaseScore > 0)
-                    accuracyRatio = computedBaseScore / computedMaxBaseScore;
+                extractFromStatistics(scoreInfo.Statistics, out var current, out var maximum);
+                if (maximum.BaseScore > 0)
+                    accuracyRatio = current.BaseScore / current.MaxCombo;
             }
 
             int computedBasicHitObjects = scoreInfo.Statistics.Where(kvp => kvp.Key.IsBasic()).Select(kvp => kvp.Value).Sum();
@@ -472,10 +459,7 @@ namespace osu.Game.Rulesets.Scoring
             if (frame.Header == null)
                 return;
 
-            extractFromStatistics(frame.Header.Statistics, out double baseScore, out double rollingMaxBaseScore, out _, out _);
-            currentScoringValues.BaseScore = baseScore;
-            rollingMaximumScoringValues.BaseScore = rollingMaxBaseScore;
-
+            extractFromStatistics(frame.Header.Statistics, out currentScoringValues, out rollingMaximumScoringValues);
             HighestCombo.Value = frame.Header.MaxCombo;
 
             scoreResultCounts.Clear();
@@ -486,49 +470,59 @@ namespace osu.Game.Rulesets.Scoring
             OnResetFromReplayFrame?.Invoke();
         }
 
-        private void extractFromStatistics(IReadOnlyDictionary<HitResult, int> statistics, out double baseScore, out double maxBaseScore, out int maxCombo,
-                                           out int basicHitObjects)
+        private void extractFromStatistics(IReadOnlyDictionary<HitResult, int> statistics, out ScoringValues current, out ScoringValues maximum)
         {
-            baseScore = 0;
-            maxBaseScore = 0;
-            maxCombo = 0;
-            basicHitObjects = 0;
+            current = default;
+            maximum = default;
 
             foreach ((HitResult result, int count) in statistics)
             {
-                // Bonus scores are counted separately directly from the statistics dictionary later on.
-                if (!result.IsScorable() || result.IsBonus())
+                if (!result.IsScorable())
                     continue;
 
-                // The maximum result of this judgement if it wasn't a miss.
-                // E.g. For a GOOD judgement, the max result is either GREAT/PERFECT depending on which one the ruleset uses (osu!: GREAT, osu!mania: PERFECT).
-                HitResult maxResult;
-
-                switch (result)
+                if (result.IsBonus())
                 {
-                    case HitResult.LargeTickHit:
-                    case HitResult.LargeTickMiss:
-                        maxResult = HitResult.LargeTickHit;
-                        break;
+                    current.BonusScore += count * Judgement.ToNumericResult(result);
+                    maximum.BonusScore += count * Judgement.ToNumericResult(result);
+                }
+                else
+                {
+                    // The maximum result of this judgement if it wasn't a miss.
+                    // E.g. For a GOOD judgement, the max result is either GREAT/PERFECT depending on which one the ruleset uses (osu!: GREAT, osu!mania: PERFECT).
+                    HitResult maxResult;
 
-                    case HitResult.SmallTickHit:
-                    case HitResult.SmallTickMiss:
-                        maxResult = HitResult.SmallTickHit;
-                        break;
+                    switch (result)
+                    {
+                        case HitResult.LargeTickHit:
+                        case HitResult.LargeTickMiss:
+                            maxResult = HitResult.LargeTickHit;
+                            break;
 
-                    default:
-                        maxResult = maxBasicResult ??= ruleset.GetHitResults().OrderByDescending(kvp => Judgement.ToNumericResult(kvp.result)).First().result;
-                        break;
+                        case HitResult.SmallTickHit:
+                        case HitResult.SmallTickMiss:
+                            maxResult = HitResult.SmallTickHit;
+                            break;
+
+                        default:
+                            maxResult = maxBasicResult ??= ruleset.GetHitResults().OrderByDescending(kvp => Judgement.ToNumericResult(kvp.result)).First().result;
+                            break;
+                    }
+
+                    current.BaseScore += count * Judgement.ToNumericResult(result);
+                    maximum.BaseScore += count * Judgement.ToNumericResult(maxResult);
                 }
 
-                baseScore += count * Judgement.ToNumericResult(result);
-                maxBaseScore += count * Judgement.ToNumericResult(maxResult);
-
                 if (result.AffectsCombo())
-                    maxCombo += count;
+                {
+                    current.MaxCombo += count;
+                    maximum.MaxCombo += count;
+                }
 
                 if (result.IsBasic())
-                    basicHitObjects += count;
+                {
+                    current.HitObjects += count;
+                    maximum.HitObjects += count;
+                }
             }
         }
 

From a809a19eeca00c59d67b7b3e638526137ea95e0d Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 31 May 2022 17:51:46 +0900
Subject: [PATCH 5144/5547] Remove getBonusScore()

---
 osu.Game/Rulesets/Scoring/ScoreProcessor.cs | 29 ++++++---------------
 1 file changed, 8 insertions(+), 21 deletions(-)

diff --git a/osu.Game/Rulesets/Scoring/ScoreProcessor.cs b/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
index c108380396..372fcbb061 100644
--- a/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
+++ b/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
@@ -271,7 +271,7 @@ namespace osu.Game.Rulesets.Scoring
             double comboRatio = maximumScoringValues.MaxCombo > 0 ? currentScoringValues.MaxCombo / maximumScoringValues.MaxCombo : 1;
 
             Accuracy.Value = rollingAccuracyRatio;
-            TotalScore.Value = ComputeScore(Mode.Value, accuracyRatio, comboRatio, getBonusScore(scoreResultCounts), maximumScoringValues.HitObjects);
+            TotalScore.Value = ComputeScore(Mode.Value, accuracyRatio, comboRatio, currentScoringValues.BonusScore, maximumScoringValues.HitObjects);
         }
 
         /// <summary>
@@ -293,7 +293,7 @@ namespace osu.Game.Rulesets.Scoring
             double accuracyRatio = max.BaseScore > 0 ? current.BaseScore / max.BaseScore : 1;
             double comboRatio = max.MaxCombo > 0 ? (double)scoreInfo.MaxCombo / max.MaxCombo : 1;
 
-            return ComputeScore(mode, accuracyRatio, comboRatio, getBonusScore(scoreInfo.Statistics), max.HitObjects);
+            return ComputeScore(mode, accuracyRatio, comboRatio, current.BonusScore, max.HitObjects);
         }
 
         /// <summary>
@@ -318,7 +318,7 @@ namespace osu.Game.Rulesets.Scoring
             double accuracyRatio = maximumScoringValues.BaseScore > 0 ? current.BaseScore / maximumScoringValues.BaseScore : 1;
             double comboRatio = maximumScoringValues.MaxCombo > 0 ? (double)scoreInfo.MaxCombo / maximumScoringValues.MaxCombo : 1;
 
-            return ComputeScore(mode, accuracyRatio, comboRatio, getBonusScore(scoreInfo.Statistics), maximumScoringValues.HitObjects);
+            return ComputeScore(mode, accuracyRatio, comboRatio, current.BonusScore, maximumScoringValues.HitObjects);
         }
 
         /// <summary>
@@ -340,19 +340,15 @@ namespace osu.Game.Rulesets.Scoring
             double accuracyRatio = scoreInfo.Accuracy;
             double comboRatio = maxAchievableCombo > 0 ? (double)scoreInfo.MaxCombo / maxAchievableCombo : 1;
 
+            extractFromStatistics(scoreInfo.Statistics, out var current, out var maximum);
+
             // For legacy osu!mania scores, a full-GREAT score has 100% accuracy. If combined with a full-combo, the score becomes indistinguishable from a full-PERFECT score.
             // To get around this, the accuracy ratio is always recalculated based on the hit statistics rather than trusting the score.
             // Note: This cannot be applied universally to all legacy scores, as some rulesets (e.g. catch) group multiple judgements together.
-            if (scoreInfo.IsLegacyScore && scoreInfo.Ruleset.OnlineID == 3)
-            {
-                extractFromStatistics(scoreInfo.Statistics, out var current, out var maximum);
-                if (maximum.BaseScore > 0)
-                    accuracyRatio = current.BaseScore / current.MaxCombo;
-            }
+            if (scoreInfo.IsLegacyScore && scoreInfo.Ruleset.OnlineID == 3 && maximum.BaseScore > 0)
+                accuracyRatio = current.BaseScore / current.MaxCombo;
 
-            int computedBasicHitObjects = scoreInfo.Statistics.Where(kvp => kvp.Key.IsBasic()).Select(kvp => kvp.Value).Sum();
-
-            return ComputeScore(mode, accuracyRatio, comboRatio, getBonusScore(scoreInfo.Statistics), computedBasicHitObjects);
+            return ComputeScore(mode, accuracyRatio, comboRatio, current.BonusScore, maximum.HitObjects);
         }
 
         /// <summary>
@@ -382,15 +378,6 @@ namespace osu.Game.Rulesets.Scoring
             }
         }
 
-        /// <summary>
-        /// Calculates the total bonus score from score statistics.
-        /// </summary>
-        /// <param name="statistics">The score statistics.</param>
-        /// <returns>The total bonus score.</returns>
-        private double getBonusScore(IReadOnlyDictionary<HitResult, int> statistics)
-            => statistics.GetValueOrDefault(HitResult.SmallBonus) * Judgement.SMALL_BONUS_SCORE
-               + statistics.GetValueOrDefault(HitResult.LargeBonus) * Judgement.LARGE_BONUS_SCORE;
-
         private ScoreRank rankFrom(double acc)
         {
             if (acc == 1)

From 2289812801ffc632dd318e626688b68b18613428 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 31 May 2022 17:57:12 +0900
Subject: [PATCH 5145/5547] Add method to compute score from ScoringValues

---
 osu.Game/Rulesets/Scoring/ScoreProcessor.cs | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/osu.Game/Rulesets/Scoring/ScoreProcessor.cs b/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
index 372fcbb061..27c2712641 100644
--- a/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
+++ b/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
@@ -351,6 +351,20 @@ namespace osu.Game.Rulesets.Scoring
             return ComputeScore(mode, accuracyRatio, comboRatio, current.BonusScore, maximum.HitObjects);
         }
 
+        /// <summary>
+        /// Computes the total score from scoring values.
+        /// </summary>
+        /// <param name="mode">The <see cref="ScoringMode"/> to represent the score as.</param>
+        /// <param name="current">The current scoring values.</param>
+        /// <param name="maximum">The maximum scoring values.</param>
+        /// <returns>The total score computed from the given scoring values.</returns>
+        public double ComputeScore(ScoringMode mode, ScoringValues current, ScoringValues maximum)
+        {
+            double accuracyRatio = maximum.BaseScore > 0 ? current.BaseScore / maximum.BaseScore : 1;
+            double comboRatio = maximum.MaxCombo > 0 ? current.MaxCombo / maximum.MaxCombo : 1;
+            return ComputeScore(mode, accuracyRatio, comboRatio, current.BonusScore, maximum.HitObjects);
+        }
+
         /// <summary>
         /// Computes the total score from individual scoring components.
         /// </summary>

From 6ccdb618531dd10a906bcc60649a1545a0cacb16 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 31 May 2022 18:01:02 +0900
Subject: [PATCH 5146/5547] Use new ComputeScore() overload in more cases

---
 osu.Game/Rulesets/Scoring/ScoreProcessor.cs | 22 +++++++--------------
 1 file changed, 7 insertions(+), 15 deletions(-)

diff --git a/osu.Game/Rulesets/Scoring/ScoreProcessor.cs b/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
index 27c2712641..b286839fa7 100644
--- a/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
+++ b/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
@@ -266,12 +266,8 @@ namespace osu.Game.Rulesets.Scoring
 
         private void updateScore()
         {
-            double rollingAccuracyRatio = rollingMaximumScoringValues.BaseScore > 0 ? currentScoringValues.BaseScore / rollingMaximumScoringValues.BaseScore : 1;
-            double accuracyRatio = maximumScoringValues.BaseScore > 0 ? currentScoringValues.BaseScore / maximumScoringValues.BaseScore : 1;
-            double comboRatio = maximumScoringValues.MaxCombo > 0 ? currentScoringValues.MaxCombo / maximumScoringValues.MaxCombo : 1;
-
-            Accuracy.Value = rollingAccuracyRatio;
-            TotalScore.Value = ComputeScore(Mode.Value, accuracyRatio, comboRatio, currentScoringValues.BonusScore, maximumScoringValues.HitObjects);
+            Accuracy.Value = rollingMaximumScoringValues.BaseScore > 0 ? currentScoringValues.BaseScore / rollingMaximumScoringValues.BaseScore : 1;
+            TotalScore.Value = ComputeScore(Mode.Value, currentScoringValues, maximumScoringValues);
         }
 
         /// <summary>
@@ -288,12 +284,10 @@ namespace osu.Game.Rulesets.Scoring
             if (!ruleset.RulesetInfo.Equals(scoreInfo.Ruleset))
                 throw new ArgumentException($"Unexpected score ruleset. Expected \"{ruleset.RulesetInfo.ShortName}\" but was \"{scoreInfo.Ruleset.ShortName}\".");
 
-            extractFromStatistics(scoreInfo.Statistics, out var current, out var max);
+            extractFromStatistics(scoreInfo.Statistics, out var current, out var maximum);
+            current.MaxCombo = scoreInfo.MaxCombo;
 
-            double accuracyRatio = max.BaseScore > 0 ? current.BaseScore / max.BaseScore : 1;
-            double comboRatio = max.MaxCombo > 0 ? (double)scoreInfo.MaxCombo / max.MaxCombo : 1;
-
-            return ComputeScore(mode, accuracyRatio, comboRatio, current.BonusScore, max.HitObjects);
+            return ComputeScore(mode, current, maximum);
         }
 
         /// <summary>
@@ -314,11 +308,9 @@ namespace osu.Game.Rulesets.Scoring
                 throw new InvalidOperationException($"Cannot compute partial score without calling {nameof(ApplyBeatmap)}.");
 
             extractFromStatistics(scoreInfo.Statistics, out var current, out _);
+            current.MaxCombo = scoreInfo.MaxCombo;
 
-            double accuracyRatio = maximumScoringValues.BaseScore > 0 ? current.BaseScore / maximumScoringValues.BaseScore : 1;
-            double comboRatio = maximumScoringValues.MaxCombo > 0 ? (double)scoreInfo.MaxCombo / maximumScoringValues.MaxCombo : 1;
-
-            return ComputeScore(mode, accuracyRatio, comboRatio, current.BonusScore, maximumScoringValues.HitObjects);
+            return ComputeScore(mode, current, maximumScoringValues);
         }
 
         /// <summary>

From 20988be6bbad41cc663a8a216096b4a9c6bc5799 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 31 May 2022 18:01:11 +0900
Subject: [PATCH 5147/5547] Fix incorrect value

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

diff --git a/osu.Game/Rulesets/Scoring/ScoreProcessor.cs b/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
index b286839fa7..18b978b413 100644
--- a/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
+++ b/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
@@ -338,7 +338,7 @@ namespace osu.Game.Rulesets.Scoring
             // To get around this, the accuracy ratio is always recalculated based on the hit statistics rather than trusting the score.
             // Note: This cannot be applied universally to all legacy scores, as some rulesets (e.g. catch) group multiple judgements together.
             if (scoreInfo.IsLegacyScore && scoreInfo.Ruleset.OnlineID == 3 && maximum.BaseScore > 0)
-                accuracyRatio = current.BaseScore / current.MaxCombo;
+                accuracyRatio = current.BaseScore / maximum.BaseScore;
 
             return ComputeScore(mode, accuracyRatio, comboRatio, current.BonusScore, maximum.HitObjects);
         }

From 44ca350822afee38e7f2c8f464a8b2d608871de2 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 31 May 2022 18:17:25 +0900
Subject: [PATCH 5148/5547] Reset minimal scoring values from frames

---
 osu.Game/Rulesets/Scoring/ScoreProcessor.cs | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Rulesets/Scoring/ScoreProcessor.cs b/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
index 18b978b413..6351d15649 100644
--- a/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
+++ b/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
@@ -452,7 +452,12 @@ namespace osu.Game.Rulesets.Scoring
             if (frame.Header == null)
                 return;
 
-            extractFromStatistics(frame.Header.Statistics, out currentScoringValues, out rollingMaximumScoringValues);
+            extractFromStatistics(frame.Header.Statistics, out var current, out var maximum);
+            currentScoringValues.BaseScore = current.BaseScore;
+            currentScoringValues.MaxCombo = frame.Header.MaxCombo;
+            rollingMaximumScoringValues.BaseScore = maximum.BaseScore;
+            rollingMaximumScoringValues.MaxCombo = maximum.MaxCombo;
+
             HighestCombo.Value = frame.Header.MaxCombo;
 
             scoreResultCounts.Clear();

From d6d56ee22dfed6ab20f195efb7d53d48a4b9de35 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 31 May 2022 18:17:40 +0900
Subject: [PATCH 5149/5547] Fix unintentional truncation

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

diff --git a/osu.Game/Rulesets/Scoring/ScoreProcessor.cs b/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
index 6351d15649..afeef9341a 100644
--- a/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
+++ b/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
@@ -353,7 +353,7 @@ namespace osu.Game.Rulesets.Scoring
         public double ComputeScore(ScoringMode mode, ScoringValues current, ScoringValues maximum)
         {
             double accuracyRatio = maximum.BaseScore > 0 ? current.BaseScore / maximum.BaseScore : 1;
-            double comboRatio = maximum.MaxCombo > 0 ? current.MaxCombo / maximum.MaxCombo : 1;
+            double comboRatio = maximum.MaxCombo > 0 ? (double)current.MaxCombo / maximum.MaxCombo : 1;
             return ComputeScore(mode, accuracyRatio, comboRatio, current.BonusScore, maximum.HitObjects);
         }
 

From 28d8799e119318b860c1d551ba79b66645a8682c Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 31 May 2022 18:39:29 +0900
Subject: [PATCH 5150/5547] Add overloads to + document + expose
 ExtractScoringValues

---
 osu.Game/Rulesets/Scoring/ScoreProcessor.cs | 89 ++++++++++++++++++---
 1 file changed, 77 insertions(+), 12 deletions(-)

diff --git a/osu.Game/Rulesets/Scoring/ScoreProcessor.cs b/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
index afeef9341a..96cf4bcc24 100644
--- a/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
+++ b/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
@@ -11,6 +11,7 @@ using osu.Framework.Bindables;
 using osu.Framework.Utils;
 using osu.Game.Beatmaps;
 using osu.Game.Extensions;
+using osu.Game.Online.Spectator;
 using osu.Game.Rulesets.Judgements;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Objects;
@@ -89,13 +90,16 @@ namespace osu.Game.Rulesets.Scoring
         private readonly double comboPortion;
 
         /// <summary>
-        /// Maximum achievable scoring values.
+        /// Scoring values for a perfect play.
         /// </summary>
         private ScoringValues maximumScoringValues;
 
         /// <summary>
         /// Maximum achievable scoring values up to the current point in time.
         /// </summary>
+        /// <remarks>
+        /// This is only used to determine the accuracy with respect to the current point in time for an ongoing play session.
+        /// </remarks>
         private ScoringValues rollingMaximumScoringValues;
 
         /// <summary>
@@ -284,7 +288,7 @@ namespace osu.Game.Rulesets.Scoring
             if (!ruleset.RulesetInfo.Equals(scoreInfo.Ruleset))
                 throw new ArgumentException($"Unexpected score ruleset. Expected \"{ruleset.RulesetInfo.ShortName}\" but was \"{scoreInfo.Ruleset.ShortName}\".");
 
-            extractFromStatistics(scoreInfo.Statistics, out var current, out var maximum);
+            extractScoringValues(scoreInfo.Statistics, out var current, out var maximum);
             current.MaxCombo = scoreInfo.MaxCombo;
 
             return ComputeScore(mode, current, maximum);
@@ -307,7 +311,7 @@ namespace osu.Game.Rulesets.Scoring
             if (!beatmapApplied)
                 throw new InvalidOperationException($"Cannot compute partial score without calling {nameof(ApplyBeatmap)}.");
 
-            extractFromStatistics(scoreInfo.Statistics, out var current, out _);
+            extractScoringValues(scoreInfo.Statistics, out var current, out _);
             current.MaxCombo = scoreInfo.MaxCombo;
 
             return ComputeScore(mode, current, maximumScoringValues);
@@ -332,7 +336,7 @@ namespace osu.Game.Rulesets.Scoring
             double accuracyRatio = scoreInfo.Accuracy;
             double comboRatio = maxAchievableCombo > 0 ? (double)scoreInfo.MaxCombo / maxAchievableCombo : 1;
 
-            extractFromStatistics(scoreInfo.Statistics, out var current, out var maximum);
+            extractScoringValues(scoreInfo.Statistics, out var current, out var maximum);
 
             // For legacy osu!mania scores, a full-GREAT score has 100% accuracy. If combined with a full-combo, the score becomes indistinguishable from a full-PERFECT score.
             // To get around this, the accuracy ratio is always recalculated based on the hit statistics rather than trusting the score.
@@ -452,7 +456,7 @@ namespace osu.Game.Rulesets.Scoring
             if (frame.Header == null)
                 return;
 
-            extractFromStatistics(frame.Header.Statistics, out var current, out var maximum);
+            extractScoringValues(frame.Header.Statistics, out var current, out var maximum);
             currentScoringValues.BaseScore = current.BaseScore;
             currentScoringValues.MaxCombo = frame.Header.MaxCombo;
             rollingMaximumScoringValues.BaseScore = maximum.BaseScore;
@@ -468,7 +472,72 @@ namespace osu.Game.Rulesets.Scoring
             OnResetFromReplayFrame?.Invoke();
         }
 
-        private void extractFromStatistics(IReadOnlyDictionary<HitResult, int> statistics, out ScoringValues current, out ScoringValues maximum)
+        #region ScoringValue extraction
+
+        /// <summary>
+        /// Applies a best-effort extraction of hit statistics into <see cref="ScoringValues"/>.
+        /// </summary>
+        /// <remarks>
+        /// This method is useful in a variety of situations, with a few drawbacks that need to be considered:
+        /// <list type="bullet">
+        ///     <item>The maximum <see cref="ScoringValues.BonusScore"/> will always be 0.</item>
+        ///     <item>The current and maximum <see cref="ScoringValues.HitObjects"/> will always be the same value.</item>
+        /// </list>
+        /// Consumers are expected to more accurately fill in the above values through external means.
+        /// <para>
+        /// <b>Ensure</b> to fill in the maximum <see cref="ScoringValues.HitObjects"/> for use in
+        /// <see cref="ComputeScore(osu.Game.Rulesets.Scoring.ScoringMode,osu.Game.Scoring.ScoringValues,osu.Game.Scoring.ScoringValues)"/>.
+        /// </para>
+        /// </remarks>
+        /// <param name="scoreInfo">The score to extract scoring values from.</param>
+        /// <param name="current">The "current" scoring values, representing the hit statistics as they appear.</param>
+        /// <param name="maximum">The "maximum" scoring values, representing the hit statistics as if the maximum hit result was attained each time.</param>
+        public void ExtractScoringValues(ScoreInfo scoreInfo, out ScoringValues current, out ScoringValues maximum)
+        {
+            extractScoringValues(scoreInfo.Statistics, out current, out maximum);
+            current.MaxCombo = scoreInfo.MaxCombo;
+        }
+
+        /// <summary>
+        /// Applies a best-effort extraction of hit statistics into <see cref="ScoringValues"/>.
+        /// </summary>
+        /// <remarks>
+        /// This method is useful in a variety of situations, with a few drawbacks that need to be considered:
+        /// <list type="bullet">
+        ///     <item>The maximum <see cref="ScoringValues.BonusScore"/> will always be 0.</item>
+        ///     <item>The current and maximum <see cref="ScoringValues.HitObjects"/> will always be the same value.</item>
+        /// </list>
+        /// Consumers are expected to more accurately fill in the above values through external means.
+        /// <para>
+        /// <b>Ensure</b> to fill in the maximum <see cref="ScoringValues.HitObjects"/> for use in
+        /// <see cref="ComputeScore(osu.Game.Rulesets.Scoring.ScoringMode,osu.Game.Scoring.ScoringValues,osu.Game.Scoring.ScoringValues)"/>.
+        /// </para>
+        /// </remarks>
+        /// <param name="header">The replay frame header to extract scoring values from.</param>
+        /// <param name="current">The "current" scoring values, representing the hit statistics as they appear.</param>
+        /// <param name="maximum">The "maximum" scoring values, representing the hit statistics as if the maximum hit result was attained each time.</param>
+        public void ExtractScoringValues(FrameHeader header, out ScoringValues current, out ScoringValues maximum)
+        {
+            extractScoringValues(header.Statistics, out current, out maximum);
+            current.MaxCombo = header.MaxCombo;
+        }
+
+        /// <summary>
+        /// Applies a best-effort extraction of hit statistics into <see cref="ScoringValues"/>.
+        /// </summary>
+        /// <remarks>
+        /// This method is useful in a variety of situations, with a few drawbacks that need to be considered:
+        /// <list type="bullet">
+        ///     <item>The current <see cref="ScoringValues.MaxCombo"/> will always be 0.</item>
+        ///     <item>The maximum <see cref="ScoringValues.BonusScore"/> will always be 0.</item>
+        ///     <item>The current and maximum <see cref="ScoringValues.HitObjects"/> will always be the same value.</item>
+        /// </list>
+        /// Consumers are expected to more accurately fill in the above values (especially the current <see cref="ScoringValues.MaxCombo"/>) via external means (e.g. <see cref="ScoreInfo"/>).
+        /// </remarks>
+        /// <param name="statistics">The hit statistics to extract scoring values from.</param>
+        /// <param name="current">The "current" scoring values, representing the hit statistics as they appear.</param>
+        /// <param name="maximum">The "maximum" scoring values, representing the hit statistics as if the maximum hit result was attained each time.</param>
+        private void extractScoringValues(IReadOnlyDictionary<HitResult, int> statistics, out ScoringValues current, out ScoringValues maximum)
         {
             current = default;
             maximum = default;
@@ -479,10 +548,7 @@ namespace osu.Game.Rulesets.Scoring
                     continue;
 
                 if (result.IsBonus())
-                {
                     current.BonusScore += count * Judgement.ToNumericResult(result);
-                    maximum.BonusScore += count * Judgement.ToNumericResult(result);
-                }
                 else
                 {
                     // The maximum result of this judgement if it wasn't a miss.
@@ -511,10 +577,7 @@ namespace osu.Game.Rulesets.Scoring
                 }
 
                 if (result.AffectsCombo())
-                {
-                    current.MaxCombo += count;
                     maximum.MaxCombo += count;
-                }
 
                 if (result.IsBasic())
                 {
@@ -524,6 +587,8 @@ namespace osu.Game.Rulesets.Scoring
             }
         }
 
+        #endregion
+
         protected override void Dispose(bool isDisposing)
         {
             base.Dispose(isDisposing);

From 93240073a645642f540fa9aab46e2fa7ce52490a Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 31 May 2022 19:34:51 +0900
Subject: [PATCH 5151/5547] Rename field + rewrite xmldoc a bit

---
 osu.Game/Rulesets/Scoring/ScoreProcessor.cs | 32 ++++++++++-----------
 1 file changed, 16 insertions(+), 16 deletions(-)

diff --git a/osu.Game/Rulesets/Scoring/ScoreProcessor.cs b/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
index 96cf4bcc24..4463941ec2 100644
--- a/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
+++ b/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
@@ -95,12 +95,12 @@ namespace osu.Game.Rulesets.Scoring
         private ScoringValues maximumScoringValues;
 
         /// <summary>
-        /// Maximum achievable scoring values up to the current point in time.
+        /// Scoring values for the current play assuming all perfect hits.
         /// </summary>
         /// <remarks>
         /// This is only used to determine the accuracy with respect to the current point in time for an ongoing play session.
         /// </remarks>
-        private ScoringValues rollingMaximumScoringValues;
+        private ScoringValues currentMaximumScoringValues;
 
         /// <summary>
         /// Scoring values for the current play.
@@ -171,7 +171,7 @@ namespace osu.Game.Rulesets.Scoring
             {
                 // The inverse of non-scorable (ignore) judgements may be bonus judgements.
                 if (result.Judgement.MaxResult.IsBonus())
-                    rollingMaximumScoringValues.BonusScore += result.Judgement.MaxNumericResult;
+                    currentMaximumScoringValues.BonusScore += result.Judgement.MaxNumericResult;
 
                 return;
             }
@@ -184,25 +184,25 @@ namespace osu.Game.Rulesets.Scoring
 
             // Update maximum combo.
             currentScoringValues.MaxCombo = HighestCombo.Value;
-            rollingMaximumScoringValues.MaxCombo += result.Judgement.MaxResult.AffectsCombo() ? 1 : 0;
+            currentMaximumScoringValues.MaxCombo += result.Judgement.MaxResult.AffectsCombo() ? 1 : 0;
 
             // Update base/bonus score.
             if (result.Type.IsBonus())
             {
                 currentScoringValues.BonusScore += result.Type.IsHit() ? result.Judgement.NumericResultFor(result) : 0;
-                rollingMaximumScoringValues.BonusScore += result.Judgement.MaxNumericResult;
+                currentMaximumScoringValues.BonusScore += result.Judgement.MaxNumericResult;
             }
             else
             {
                 currentScoringValues.BaseScore += result.Type.IsHit() ? result.Judgement.NumericResultFor(result) : 0;
-                rollingMaximumScoringValues.BaseScore += result.Judgement.MaxNumericResult;
+                currentMaximumScoringValues.BaseScore += result.Judgement.MaxNumericResult;
             }
 
             // Update hitobject count.
             if (result.Type.IsBasic())
             {
                 currentScoringValues.HitObjects++;
-                rollingMaximumScoringValues.HitObjects++;
+                currentMaximumScoringValues.HitObjects++;
             }
 
             hitEvents.Add(CreateHitEvent(result));
@@ -233,32 +233,32 @@ namespace osu.Game.Rulesets.Scoring
             {
                 // The inverse of non-scorable (ignore) judgements may be bonus judgements.
                 if (result.Judgement.MaxResult.IsBonus())
-                    rollingMaximumScoringValues.BonusScore -= result.Judgement.MaxNumericResult;
+                    currentMaximumScoringValues.BonusScore -= result.Judgement.MaxNumericResult;
 
                 return;
             }
 
             // Update maximum combo.
             currentScoringValues.MaxCombo = HighestCombo.Value;
-            rollingMaximumScoringValues.MaxCombo -= result.Judgement.MaxResult.AffectsCombo() ? 1 : 0;
+            currentMaximumScoringValues.MaxCombo -= result.Judgement.MaxResult.AffectsCombo() ? 1 : 0;
 
             // Update base/bonus score.
             if (result.Type.IsBonus())
             {
                 currentScoringValues.BonusScore -= result.Type.IsHit() ? result.Judgement.NumericResultFor(result) : 0;
-                rollingMaximumScoringValues.BonusScore -= result.Judgement.MaxNumericResult;
+                currentMaximumScoringValues.BonusScore -= result.Judgement.MaxNumericResult;
             }
             else
             {
                 currentScoringValues.BaseScore -= result.Type.IsHit() ? result.Judgement.NumericResultFor(result) : 0;
-                rollingMaximumScoringValues.BaseScore -= result.Judgement.MaxNumericResult;
+                currentMaximumScoringValues.BaseScore -= result.Judgement.MaxNumericResult;
             }
 
             // Update hitobject count.
             if (result.Type.IsBasic())
             {
                 currentScoringValues.HitObjects--;
-                rollingMaximumScoringValues.HitObjects--;
+                currentMaximumScoringValues.HitObjects--;
             }
 
             Debug.Assert(hitEvents.Count > 0);
@@ -270,7 +270,7 @@ namespace osu.Game.Rulesets.Scoring
 
         private void updateScore()
         {
-            Accuracy.Value = rollingMaximumScoringValues.BaseScore > 0 ? currentScoringValues.BaseScore / rollingMaximumScoringValues.BaseScore : 1;
+            Accuracy.Value = currentMaximumScoringValues.BaseScore > 0 ? currentScoringValues.BaseScore / currentMaximumScoringValues.BaseScore : 1;
             TotalScore.Value = ComputeScore(Mode.Value, currentScoringValues, maximumScoringValues);
         }
 
@@ -422,7 +422,7 @@ namespace osu.Game.Rulesets.Scoring
                 maximumScoringValues = currentScoringValues;
 
             currentScoringValues = default;
-            rollingMaximumScoringValues = default;
+            currentMaximumScoringValues = default;
 
             TotalScore.Value = 0;
             Accuracy.Value = 1;
@@ -459,8 +459,8 @@ namespace osu.Game.Rulesets.Scoring
             extractScoringValues(frame.Header.Statistics, out var current, out var maximum);
             currentScoringValues.BaseScore = current.BaseScore;
             currentScoringValues.MaxCombo = frame.Header.MaxCombo;
-            rollingMaximumScoringValues.BaseScore = maximum.BaseScore;
-            rollingMaximumScoringValues.MaxCombo = maximum.MaxCombo;
+            currentMaximumScoringValues.BaseScore = maximum.BaseScore;
+            currentMaximumScoringValues.MaxCombo = maximum.MaxCombo;
 
             HighestCombo.Value = frame.Header.MaxCombo;
 

From 1e0ee1b2147ff532e7f3cea26e0c2708c4077fdc Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 31 May 2022 19:49:37 +0900
Subject: [PATCH 5152/5547] Expose MaximumScoringValues for user consumption

---
 osu.Game/Rulesets/Scoring/ScoreProcessor.cs | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Rulesets/Scoring/ScoreProcessor.cs b/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
index 4463941ec2..8e69ffa0a0 100644
--- a/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
+++ b/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
@@ -92,7 +92,7 @@ namespace osu.Game.Rulesets.Scoring
         /// <summary>
         /// Scoring values for a perfect play.
         /// </summary>
-        private ScoringValues maximumScoringValues;
+        public ScoringValues MaximumScoringValues { get; private set; }
 
         /// <summary>
         /// Scoring values for the current play assuming all perfect hits.
@@ -271,7 +271,7 @@ namespace osu.Game.Rulesets.Scoring
         private void updateScore()
         {
             Accuracy.Value = currentMaximumScoringValues.BaseScore > 0 ? currentScoringValues.BaseScore / currentMaximumScoringValues.BaseScore : 1;
-            TotalScore.Value = ComputeScore(Mode.Value, currentScoringValues, maximumScoringValues);
+            TotalScore.Value = ComputeScore(Mode.Value, currentScoringValues, MaximumScoringValues);
         }
 
         /// <summary>
@@ -314,7 +314,7 @@ namespace osu.Game.Rulesets.Scoring
             extractScoringValues(scoreInfo.Statistics, out var current, out _);
             current.MaxCombo = scoreInfo.MaxCombo;
 
-            return ComputeScore(mode, current, maximumScoringValues);
+            return ComputeScore(mode, current, MaximumScoringValues);
         }
 
         /// <summary>
@@ -419,7 +419,7 @@ namespace osu.Game.Rulesets.Scoring
             lastHitObject = null;
 
             if (storeResults)
-                maximumScoringValues = currentScoringValues;
+                MaximumScoringValues = currentScoringValues;
 
             currentScoringValues = default;
             currentMaximumScoringValues = default;

From eaeb66547e3ceda671dcaa04850d247439893944 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 31 May 2022 19:58:44 +0900
Subject: [PATCH 5153/5547] Revert comment removal

---
 .../Screens/OnlinePlay/Multiplayer/MultiplayerPlayer.cs  | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayer.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayer.cs
index f4bfec169d..43b128b971 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayer.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayer.cs
@@ -149,9 +149,16 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
 
         protected override void StartGameplay()
         {
+            // We can enter this screen one of two ways:
+            // 1. Via the automatic natural progression of PlayerLoader into Player.
+            //    We'll arrive here in a Loaded state, and we need to let the server know that we're ready to start.
+            // 2. Via the server forcefully starting gameplay because players have been hanging out in PlayerLoader for too long.
+            //    We'll arrive here in a Playing state, and we should neither show the loading spinner nor tell the server that we're ready to start (gameplay has already started).
+            //
+            // The base call is blocked here because in both cases gameplay is started only when the server says so via onGameplayStarted().
+
             if (client.LocalUser?.State == MultiplayerUserState.Loaded)
             {
-                // block base call, but let the server know we are ready to start.
                 loadingDisplay.Show();
                 client.ChangeState(MultiplayerUserState.ReadyForGameplay);
             }

From a940676fc2ae5d24b34a8c500a8d6bc9fc4a57a2 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 31 May 2022 21:10:02 +0900
Subject: [PATCH 5154/5547] Add adjustment buttons

---
 .../Editing/TestSceneTapTimingControl.cs      |   6 +
 osu.Game/Screens/Edit/Timing/AdjustButton.cs  | 235 ++++++++++++++++++
 .../Screens/Edit/Timing/TapTimingControl.cs   |  65 ++++-
 3 files changed, 305 insertions(+), 1 deletion(-)
 create mode 100644 osu.Game/Screens/Edit/Timing/AdjustButton.cs

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneTapTimingControl.cs b/osu.Game.Tests/Visual/Editing/TestSceneTapTimingControl.cs
index 46b45979ea..8dd368f2a9 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneTapTimingControl.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneTapTimingControl.cs
@@ -77,6 +77,12 @@ namespace osu.Game.Tests.Visual.Editing
                 timingInfo.Text = $"offset: {selectedGroup.Value.Time:N2} bpm: {selectedGroup.Value.ControlPoints.OfType<TimingControlPoint>().First().BPM:N2}";
         }
 
+        [Test]
+        public void TestNoop()
+        {
+            AddStep("do nothing", () => { });
+        }
+
         [Test]
         public void TestTapThenReset()
         {
diff --git a/osu.Game/Screens/Edit/Timing/AdjustButton.cs b/osu.Game/Screens/Edit/Timing/AdjustButton.cs
new file mode 100644
index 0000000000..b0a0517e94
--- /dev/null
+++ b/osu.Game/Screens/Edit/Timing/AdjustButton.cs
@@ -0,0 +1,235 @@
+// 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.Graphics;
+using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.Shapes;
+using osu.Framework.Input.Events;
+using osu.Framework.Localisation;
+using osu.Framework.Threading;
+using osu.Game.Graphics;
+using osu.Game.Graphics.Sprites;
+using osu.Game.Overlays;
+
+namespace osu.Game.Screens.Edit.Timing
+{
+    public class AdjustButton : CompositeDrawable
+    {
+        public Action<double> Action;
+
+        private readonly double adjustAmount;
+        private ScheduledDelegate adjustDelegate;
+
+        private const int adjust_levels = 4;
+
+        private const double initial_delay = 300;
+
+        private const double minimum_delay = 80;
+
+        public Container Content { get; set; }
+
+        private double adjustDelay = initial_delay;
+
+        private readonly Box background;
+
+        private readonly OsuSpriteText text;
+
+        public LocalisableString Text
+        {
+            get => text?.Text ?? default;
+            set
+            {
+                if (text != null)
+                    text.Text = value;
+            }
+        }
+
+        [Resolved]
+        private OverlayColourProvider colourProvider { get; set; }
+
+        public AdjustButton(double adjustAmount)
+        {
+            this.adjustAmount = adjustAmount;
+
+            CornerRadius = 5;
+            Masking = true;
+
+            AddInternal(Content = new Container
+            {
+                RelativeSizeAxes = Axes.Both,
+                Children = new Drawable[]
+                {
+                    background = new Box
+                    {
+                        RelativeSizeAxes = Axes.Both,
+                        Depth = float.MaxValue
+                    },
+                    text = new OsuSpriteText
+                    {
+                        Anchor = Anchor.Centre,
+                        Origin = Anchor.Centre,
+                        Font = OsuFont.Default.With(weight: FontWeight.SemiBold),
+                        Padding = new MarginPadding(5),
+                        Depth = float.MinValue
+                    }
+                }
+            });
+        }
+
+        [BackgroundDependencyLoader]
+        private void load()
+        {
+            background.Colour = colourProvider.Background3;
+
+            for (int i = 1; i <= adjust_levels; i++)
+            {
+                Content.Add(new IncrementBox(i, adjustAmount));
+                Content.Add(new IncrementBox(-i, adjustAmount));
+            }
+        }
+
+        protected override bool OnMouseDown(MouseDownEvent e)
+        {
+            beginRepeat();
+            return true;
+        }
+
+        protected override void OnMouseUp(MouseUpEvent e)
+        {
+            adjustDelegate?.Cancel();
+            base.OnMouseUp(e);
+        }
+
+        private void beginRepeat()
+        {
+            adjustDelegate?.Cancel();
+
+            adjustDelay = initial_delay;
+            adjustNext();
+
+            void adjustNext()
+            {
+                var hoveredBox = Content.OfType<IncrementBox>().FirstOrDefault(d => d.IsHovered);
+
+                if (hoveredBox != null)
+                {
+                    Action(adjustAmount * hoveredBox.Multiplier);
+
+                    adjustDelay = Math.Max(minimum_delay, adjustDelay * 0.9f);
+
+                    hoveredBox.Flash();
+                }
+                else
+                {
+                    adjustDelay = initial_delay;
+                }
+
+                adjustDelegate = Scheduler.AddDelayed(adjustNext, adjustDelay);
+            }
+        }
+
+        private class IncrementBox : CompositeDrawable
+        {
+            public readonly float Multiplier;
+
+            private readonly Box box;
+            private readonly OsuSpriteText text;
+
+            public IncrementBox(int index, double amount)
+            {
+                Multiplier = Math.Sign(index) * convertMultiplier(index);
+
+                float ratio = (float)index / adjust_levels;
+
+                RelativeSizeAxes = Axes.Both;
+
+                Width = 0.5f * Math.Abs(ratio);
+
+                Anchor direction = index < 0 ? Anchor.x2 : Anchor.x0;
+
+                Origin |= direction;
+
+                Depth = Math.Abs(index);
+
+                Anchor = Anchor.TopCentre;
+
+                InternalChildren = new Drawable[]
+                {
+                    box = new Box
+                    {
+                        RelativeSizeAxes = Axes.Both,
+                        Blending = BlendingParameters.Additive
+                    },
+                    text = new OsuSpriteText
+                    {
+                        Anchor = direction,
+                        Origin = direction,
+                        Font = OsuFont.Default.With(size: 10, weight: FontWeight.Bold),
+                        Text = $"{(index > 0 ? "+" : "-")}{Math.Abs(Multiplier * amount)}",
+                        Padding = new MarginPadding(5),
+                        Alpha = 0,
+                    }
+                };
+            }
+
+            [Resolved]
+            private OverlayColourProvider colourProvider { get; set; }
+
+            protected override void LoadComplete()
+            {
+                base.LoadComplete();
+
+                box.Colour = colourProvider.Background1;
+                box.Alpha = 0.1f;
+            }
+
+            private float convertMultiplier(int m)
+            {
+                switch (Math.Abs(m))
+                {
+                    default: return 1;
+
+                    case 2: return 2;
+
+                    case 3: return 5;
+
+                    case 4: return 10;
+                }
+            }
+
+            protected override bool OnHover(HoverEvent e)
+            {
+                box.Colour = colourProvider.Colour0;
+
+                box.FadeTo(0.2f, 100, Easing.OutQuint);
+                text.FadeIn(100, Easing.OutQuint);
+                return true;
+            }
+
+            protected override void OnHoverLost(HoverLostEvent e)
+            {
+                box.Colour = colourProvider.Background1;
+
+                box.FadeTo(0.1f, 500, Easing.OutQuint);
+                text.FadeOut(100, Easing.OutQuint);
+                base.OnHoverLost(e);
+            }
+
+            public void Flash()
+            {
+                box
+                    .FadeTo(0.4f, 20, Easing.OutQuint)
+                    .Then()
+                    .FadeTo(0.2f, 400, Easing.OutQuint);
+
+                text
+                    .MoveToY(-5, 20, Easing.OutQuint)
+                    .Then()
+                    .MoveToY(0, 400, Easing.OutQuint);
+            }
+        }
+    }
+}
diff --git a/osu.Game/Screens/Edit/Timing/TapTimingControl.cs b/osu.Game/Screens/Edit/Timing/TapTimingControl.cs
index d0ab4d1f98..f9f5a20405 100644
--- a/osu.Game/Screens/Edit/Timing/TapTimingControl.cs
+++ b/osu.Game/Screens/Edit/Timing/TapTimingControl.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.Bindables;
 using osu.Framework.Graphics;
@@ -18,6 +19,9 @@ namespace osu.Game.Screens.Edit.Timing
         [Resolved]
         private EditorClock editorClock { get; set; }
 
+        [Resolved]
+        private EditorBeatmap beatmap { get; set; }
+
         [Resolved]
         private Bindable<ControlPointGroup> selectedGroup { get; set; }
 
@@ -45,6 +49,7 @@ namespace osu.Game.Screens.Edit.Timing
                     {
                         new Dimension(GridSizeMode.Absolute, 200),
                         new Dimension(GridSizeMode.Absolute, 60),
+                        new Dimension(GridSizeMode.Absolute, 60),
                     },
                     Content = new[]
                     {
@@ -77,7 +82,36 @@ namespace osu.Game.Screens.Edit.Timing
                                         },
                                     }
                                 }
-                            }
+                            },
+                        },
+                        new Drawable[]
+                        {
+                            new Container
+                            {
+                                RelativeSizeAxes = Axes.Both,
+                                Padding = new MarginPadding(10),
+                                Children = new Drawable[]
+                                {
+                                    new AdjustButton(1)
+                                    {
+                                        Text = "Offset",
+                                        RelativeSizeAxes = Axes.X,
+                                        Width = 0.48f,
+                                        Height = 50,
+                                        Action = adjustOffset,
+                                    },
+                                    new AdjustButton(0.1)
+                                    {
+                                        Anchor = Anchor.TopRight,
+                                        Origin = Anchor.TopRight,
+                                        Text = "BPM",
+                                        RelativeSizeAxes = Axes.X,
+                                        Width = 0.48f,
+                                        Height = 50,
+                                        Action = adjustBpm,
+                                    }
+                                }
+                            },
                         },
                         new Drawable[]
                         {
@@ -113,6 +147,35 @@ namespace osu.Game.Screens.Edit.Timing
             };
         }
 
+        private void adjustOffset(double adjust)
+        {
+            // VERY TEMPORARY
+            var currentGroupItems = selectedGroup.Value.ControlPoints.ToArray();
+
+            beatmap.ControlPointInfo.RemoveGroup(selectedGroup.Value);
+
+            double newOffset = selectedGroup.Value.Time + adjust;
+
+            foreach (var cp in currentGroupItems)
+                beatmap.ControlPointInfo.Add(newOffset, cp);
+
+            // the control point might not necessarily exist yet, if currentGroupItems was empty.
+            selectedGroup.Value = beatmap.ControlPointInfo.GroupAt(newOffset, true);
+
+            if (!editorClock.IsRunning)
+                editorClock.Seek(newOffset);
+        }
+
+        private void adjustBpm(double adjust)
+        {
+            var timing = selectedGroup.Value.ControlPoints.OfType<TimingControlPoint>().FirstOrDefault();
+
+            if (timing == null)
+                return;
+
+            timing.BeatLength = 60000 / (timing.BPM + adjust);
+        }
+
         private void tap()
         {
             editorClock.Seek(selectedGroup.Value.Time);

From f99bcb23a0d296ef7cfd462276d86e730ed13cd8 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 31 May 2022 21:49:32 +0900
Subject: [PATCH 5155/5547] Automatically make first control point added to
 beatmap have timing data

---
 osu.Game/Screens/Edit/Timing/TimingScreen.cs | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Edit/Timing/TimingScreen.cs b/osu.Game/Screens/Edit/Timing/TimingScreen.cs
index f71a8d7d22..c3b804c2d6 100644
--- a/osu.Game/Screens/Edit/Timing/TimingScreen.cs
+++ b/osu.Game/Screens/Edit/Timing/TimingScreen.cs
@@ -144,7 +144,14 @@ namespace osu.Game.Screens.Edit.Timing
 
             private void addNew()
             {
-                selectedGroup.Value = Beatmap.ControlPointInfo.GroupAt(clock.CurrentTime, true);
+                bool isFirstControlPoint = !Beatmap.ControlPointInfo.TimingPoints.Any();
+
+                var group = Beatmap.ControlPointInfo.GroupAt(clock.CurrentTime, true);
+
+                if (isFirstControlPoint)
+                    group.Add(new TimingControlPoint());
+
+                selectedGroup.Value = group;
             }
         }
     }

From 8240b645b4c93c2d83d2deaa31c49274e8920463 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 31 May 2022 21:49:47 +0900
Subject: [PATCH 5156/5547] Copy attribute types from currently selected
 control point to new placements

---
 osu.Game/Screens/Edit/Timing/TimingScreen.cs | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/osu.Game/Screens/Edit/Timing/TimingScreen.cs b/osu.Game/Screens/Edit/Timing/TimingScreen.cs
index c3b804c2d6..5ee6106c46 100644
--- a/osu.Game/Screens/Edit/Timing/TimingScreen.cs
+++ b/osu.Game/Screens/Edit/Timing/TimingScreen.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 osu.Framework.Allocation;
 using osu.Framework.Bindables;
@@ -150,6 +151,23 @@ namespace osu.Game.Screens.Edit.Timing
 
                 if (isFirstControlPoint)
                     group.Add(new TimingControlPoint());
+                else
+                {
+                    // Try and create matching types from the currently selected control point.
+                    var selected = selectedGroup.Value;
+
+                    if (selected != null)
+                    {
+                        foreach (var controlPoint in selected.ControlPoints)
+                        {
+                            if (Activator.CreateInstance(controlPoint.GetType()) is ControlPoint copy)
+                            {
+                                copy.CopyFrom(controlPoint);
+                                group.Add(copy);
+                            }
+                        }
+                    }
+                }
 
                 selectedGroup.Value = group;
             }

From bc22079fdcf4c06d89c38298ba83a526abc6f7b7 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 31 May 2022 22:02:30 +0900
Subject: [PATCH 5157/5547] Fix row selected colour flicker when changing
 offset rapidly

---
 osu.Game/Screens/Edit/EditorTable.cs | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/osu.Game/Screens/Edit/EditorTable.cs b/osu.Game/Screens/Edit/EditorTable.cs
index a67a060134..26819dcfe7 100644
--- a/osu.Game/Screens/Edit/EditorTable.cs
+++ b/osu.Game/Screens/Edit/EditorTable.cs
@@ -99,6 +99,15 @@ namespace osu.Game.Screens.Edit
                 colourSelected = colours.Colour3;
             }
 
+            protected override void LoadComplete()
+            {
+                base.LoadComplete();
+
+                // Reduce flicker of rows when offset is being changed rapidly.
+                // Probably need to reconsider this.
+                FinishTransforms(true);
+            }
+
             private bool selected;
 
             public bool Selected

From a434cc14a46eb7a4e7e301e12f90b60d1e220439 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 1 Jun 2022 09:34:46 +0900
Subject: [PATCH 5158/5547] Apply code reviews

---
 osu.Game/Rulesets/Scoring/ScoreProcessor.cs | 13 +++++++++++--
 1 file changed, 11 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Rulesets/Scoring/ScoreProcessor.cs b/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
index 8e69ffa0a0..5712d9c94a 100644
--- a/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
+++ b/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
@@ -6,6 +6,7 @@
 using System;
 using System.Collections.Generic;
 using System.Diagnostics;
+using System.Diagnostics.Contracts;
 using System.Linq;
 using osu.Framework.Bindables;
 using osu.Framework.Utils;
@@ -283,6 +284,7 @@ namespace osu.Game.Rulesets.Scoring
         /// <param name="mode">The <see cref="ScoringMode"/> to represent the score as.</param>
         /// <param name="scoreInfo">The <see cref="ScoreInfo"/> to compute the total score of.</param>
         /// <returns>The total score in the given <see cref="ScoringMode"/>.</returns>
+        [Pure]
         public double ComputeFinalScore(ScoringMode mode, ScoreInfo scoreInfo)
         {
             if (!ruleset.RulesetInfo.Equals(scoreInfo.Ruleset))
@@ -303,6 +305,7 @@ namespace osu.Game.Rulesets.Scoring
         /// <param name="mode">The <see cref="ScoringMode"/> to represent the score as.</param>
         /// <param name="scoreInfo">The <see cref="ScoreInfo"/> to compute the total score of.</param>
         /// <returns>The total score in the given <see cref="ScoringMode"/>.</returns>
+        [Pure]
         public double ComputePartialScore(ScoringMode mode, ScoreInfo scoreInfo)
         {
             if (!ruleset.RulesetInfo.Equals(scoreInfo.Ruleset))
@@ -328,6 +331,7 @@ namespace osu.Game.Rulesets.Scoring
         /// <param name="scoreInfo">The <see cref="ScoreInfo"/> to compute the total score of.</param>
         /// <param name="maxAchievableCombo">The maximum achievable combo for the provided beatmap.</param>
         /// <returns>The total score in the given <see cref="ScoringMode"/>.</returns>
+        [Pure]
         public double ComputeFinalLegacyScore(ScoringMode mode, ScoreInfo scoreInfo, int maxAchievableCombo)
         {
             if (!ruleset.RulesetInfo.Equals(scoreInfo.Ruleset))
@@ -354,6 +358,7 @@ namespace osu.Game.Rulesets.Scoring
         /// <param name="current">The current scoring values.</param>
         /// <param name="maximum">The maximum scoring values.</param>
         /// <returns>The total score computed from the given scoring values.</returns>
+        [Pure]
         public double ComputeScore(ScoringMode mode, ScoringValues current, ScoringValues maximum)
         {
             double accuracyRatio = maximum.BaseScore > 0 ? current.BaseScore / maximum.BaseScore : 1;
@@ -370,6 +375,7 @@ namespace osu.Game.Rulesets.Scoring
         /// <param name="bonusScore">The total bonus score.</param>
         /// <param name="totalBasicHitObjects">The total number of basic (non-tick and non-bonus) hitobjects in the beatmap.</param>
         /// <returns>The total score computed from the given scoring component ratios.</returns>
+        [Pure]
         public double ComputeScore(ScoringMode mode, double accuracyRatio, double comboRatio, double bonusScore, int totalBasicHitObjects)
         {
             switch (mode)
@@ -492,7 +498,8 @@ namespace osu.Game.Rulesets.Scoring
         /// <param name="scoreInfo">The score to extract scoring values from.</param>
         /// <param name="current">The "current" scoring values, representing the hit statistics as they appear.</param>
         /// <param name="maximum">The "maximum" scoring values, representing the hit statistics as if the maximum hit result was attained each time.</param>
-        public void ExtractScoringValues(ScoreInfo scoreInfo, out ScoringValues current, out ScoringValues maximum)
+        [Pure]
+        internal void ExtractScoringValues(ScoreInfo scoreInfo, out ScoringValues current, out ScoringValues maximum)
         {
             extractScoringValues(scoreInfo.Statistics, out current, out maximum);
             current.MaxCombo = scoreInfo.MaxCombo;
@@ -516,7 +523,8 @@ namespace osu.Game.Rulesets.Scoring
         /// <param name="header">The replay frame header to extract scoring values from.</param>
         /// <param name="current">The "current" scoring values, representing the hit statistics as they appear.</param>
         /// <param name="maximum">The "maximum" scoring values, representing the hit statistics as if the maximum hit result was attained each time.</param>
-        public void ExtractScoringValues(FrameHeader header, out ScoringValues current, out ScoringValues maximum)
+        [Pure]
+        internal void ExtractScoringValues(FrameHeader header, out ScoringValues current, out ScoringValues maximum)
         {
             extractScoringValues(header.Statistics, out current, out maximum);
             current.MaxCombo = header.MaxCombo;
@@ -537,6 +545,7 @@ namespace osu.Game.Rulesets.Scoring
         /// <param name="statistics">The hit statistics to extract scoring values from.</param>
         /// <param name="current">The "current" scoring values, representing the hit statistics as they appear.</param>
         /// <param name="maximum">The "maximum" scoring values, representing the hit statistics as if the maximum hit result was attained each time.</param>
+        [Pure]
         private void extractScoringValues(IReadOnlyDictionary<HitResult, int> statistics, out ScoringValues current, out ScoringValues maximum)
         {
             current = default;

From fc079ad8cfc1b458cbbf266bd39e8093b1ec91b2 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 1 Jun 2022 09:51:06 +0900
Subject: [PATCH 5159/5547] Refactor to reduce nested conditions

---
 osu.Game/Rulesets/Scoring/ScoreProcessor.cs | 93 +++++++++------------
 1 file changed, 38 insertions(+), 55 deletions(-)

diff --git a/osu.Game/Rulesets/Scoring/ScoreProcessor.cs b/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
index 5712d9c94a..26a32ab1a0 100644
--- a/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
+++ b/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
@@ -168,43 +168,20 @@ namespace osu.Game.Rulesets.Scoring
 
             scoreResultCounts[result.Type] = scoreResultCounts.GetValueOrDefault(result.Type) + 1;
 
+            // Always update the maximum scoring values.
+            applyResult(result.Judgement.MaxResult, ref currentMaximumScoringValues);
+            currentMaximumScoringValues.MaxCombo += result.Judgement.MaxResult.IncreasesCombo() ? 1 : 0;
+
             if (!result.Type.IsScorable())
-            {
-                // The inverse of non-scorable (ignore) judgements may be bonus judgements.
-                if (result.Judgement.MaxResult.IsBonus())
-                    currentMaximumScoringValues.BonusScore += result.Judgement.MaxNumericResult;
-
                 return;
-            }
 
-            // Update rolling combo.
             if (result.Type.IncreasesCombo())
                 Combo.Value++;
             else if (result.Type.BreaksCombo())
                 Combo.Value = 0;
 
-            // Update maximum combo.
+            applyResult(result.Type, ref currentScoringValues);
             currentScoringValues.MaxCombo = HighestCombo.Value;
-            currentMaximumScoringValues.MaxCombo += result.Judgement.MaxResult.AffectsCombo() ? 1 : 0;
-
-            // Update base/bonus score.
-            if (result.Type.IsBonus())
-            {
-                currentScoringValues.BonusScore += result.Type.IsHit() ? result.Judgement.NumericResultFor(result) : 0;
-                currentMaximumScoringValues.BonusScore += result.Judgement.MaxNumericResult;
-            }
-            else
-            {
-                currentScoringValues.BaseScore += result.Type.IsHit() ? result.Judgement.NumericResultFor(result) : 0;
-                currentMaximumScoringValues.BaseScore += result.Judgement.MaxNumericResult;
-            }
-
-            // Update hitobject count.
-            if (result.Type.IsBasic())
-            {
-                currentScoringValues.HitObjects++;
-                currentMaximumScoringValues.HitObjects++;
-            }
 
             hitEvents.Add(CreateHitEvent(result));
             lastHitObject = result.HitObject;
@@ -212,6 +189,20 @@ namespace osu.Game.Rulesets.Scoring
             updateScore();
         }
 
+        private static void applyResult(HitResult result, ref ScoringValues scoringValues)
+        {
+            if (!result.IsScorable())
+                return;
+
+            if (result.IsBonus())
+                scoringValues.BonusScore += result.IsHit() ? Judgement.ToNumericResult(result) : 0;
+            else
+                scoringValues.BaseScore += result.IsHit() ? Judgement.ToNumericResult(result) : 0;
+
+            if (result.IsBasic())
+                scoringValues.HitObjects++;
+        }
+
         /// <summary>
         /// Creates the <see cref="HitEvent"/> that describes a <see cref="JudgementResult"/>.
         /// </summary>
@@ -230,37 +221,15 @@ namespace osu.Game.Rulesets.Scoring
 
             scoreResultCounts[result.Type] = scoreResultCounts.GetValueOrDefault(result.Type) - 1;
 
+            // Always update the maximum scoring values.
+            revertResult(result.Judgement.MaxResult, ref currentMaximumScoringValues);
+            currentMaximumScoringValues.MaxCombo -= result.Judgement.MaxResult.IncreasesCombo() ? 1 : 0;
+
             if (!result.Type.IsScorable())
-            {
-                // The inverse of non-scorable (ignore) judgements may be bonus judgements.
-                if (result.Judgement.MaxResult.IsBonus())
-                    currentMaximumScoringValues.BonusScore -= result.Judgement.MaxNumericResult;
-
                 return;
-            }
 
-            // Update maximum combo.
+            revertResult(result.Type, ref currentScoringValues);
             currentScoringValues.MaxCombo = HighestCombo.Value;
-            currentMaximumScoringValues.MaxCombo -= result.Judgement.MaxResult.AffectsCombo() ? 1 : 0;
-
-            // Update base/bonus score.
-            if (result.Type.IsBonus())
-            {
-                currentScoringValues.BonusScore -= result.Type.IsHit() ? result.Judgement.NumericResultFor(result) : 0;
-                currentMaximumScoringValues.BonusScore -= result.Judgement.MaxNumericResult;
-            }
-            else
-            {
-                currentScoringValues.BaseScore -= result.Type.IsHit() ? result.Judgement.NumericResultFor(result) : 0;
-                currentMaximumScoringValues.BaseScore -= result.Judgement.MaxNumericResult;
-            }
-
-            // Update hitobject count.
-            if (result.Type.IsBasic())
-            {
-                currentScoringValues.HitObjects--;
-                currentMaximumScoringValues.HitObjects--;
-            }
 
             Debug.Assert(hitEvents.Count > 0);
             lastHitObject = hitEvents[^1].LastHitObject;
@@ -269,6 +238,20 @@ namespace osu.Game.Rulesets.Scoring
             updateScore();
         }
 
+        private static void revertResult(HitResult result, ref ScoringValues scoringValues)
+        {
+            if (!result.IsScorable())
+                return;
+
+            if (result.IsBonus())
+                scoringValues.BonusScore -= result.IsHit() ? Judgement.ToNumericResult(result) : 0;
+            else
+                scoringValues.BaseScore -= result.IsHit() ? Judgement.ToNumericResult(result) : 0;
+
+            if (result.IsBasic())
+                scoringValues.HitObjects--;
+        }
+
         private void updateScore()
         {
             Accuracy.Value = currentMaximumScoringValues.BaseScore > 0 ? currentScoringValues.BaseScore / currentMaximumScoringValues.BaseScore : 1;

From 50c3dfca318ee462abffa7435ebce3326ed68972 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 1 Jun 2022 09:34:46 +0900
Subject: [PATCH 5160/5547] Apply code reviews

---
 osu.Game/Rulesets/Scoring/ScoreProcessor.cs | 13 +++++++++++--
 1 file changed, 11 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Rulesets/Scoring/ScoreProcessor.cs b/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
index 8e69ffa0a0..5712d9c94a 100644
--- a/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
+++ b/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
@@ -6,6 +6,7 @@
 using System;
 using System.Collections.Generic;
 using System.Diagnostics;
+using System.Diagnostics.Contracts;
 using System.Linq;
 using osu.Framework.Bindables;
 using osu.Framework.Utils;
@@ -283,6 +284,7 @@ namespace osu.Game.Rulesets.Scoring
         /// <param name="mode">The <see cref="ScoringMode"/> to represent the score as.</param>
         /// <param name="scoreInfo">The <see cref="ScoreInfo"/> to compute the total score of.</param>
         /// <returns>The total score in the given <see cref="ScoringMode"/>.</returns>
+        [Pure]
         public double ComputeFinalScore(ScoringMode mode, ScoreInfo scoreInfo)
         {
             if (!ruleset.RulesetInfo.Equals(scoreInfo.Ruleset))
@@ -303,6 +305,7 @@ namespace osu.Game.Rulesets.Scoring
         /// <param name="mode">The <see cref="ScoringMode"/> to represent the score as.</param>
         /// <param name="scoreInfo">The <see cref="ScoreInfo"/> to compute the total score of.</param>
         /// <returns>The total score in the given <see cref="ScoringMode"/>.</returns>
+        [Pure]
         public double ComputePartialScore(ScoringMode mode, ScoreInfo scoreInfo)
         {
             if (!ruleset.RulesetInfo.Equals(scoreInfo.Ruleset))
@@ -328,6 +331,7 @@ namespace osu.Game.Rulesets.Scoring
         /// <param name="scoreInfo">The <see cref="ScoreInfo"/> to compute the total score of.</param>
         /// <param name="maxAchievableCombo">The maximum achievable combo for the provided beatmap.</param>
         /// <returns>The total score in the given <see cref="ScoringMode"/>.</returns>
+        [Pure]
         public double ComputeFinalLegacyScore(ScoringMode mode, ScoreInfo scoreInfo, int maxAchievableCombo)
         {
             if (!ruleset.RulesetInfo.Equals(scoreInfo.Ruleset))
@@ -354,6 +358,7 @@ namespace osu.Game.Rulesets.Scoring
         /// <param name="current">The current scoring values.</param>
         /// <param name="maximum">The maximum scoring values.</param>
         /// <returns>The total score computed from the given scoring values.</returns>
+        [Pure]
         public double ComputeScore(ScoringMode mode, ScoringValues current, ScoringValues maximum)
         {
             double accuracyRatio = maximum.BaseScore > 0 ? current.BaseScore / maximum.BaseScore : 1;
@@ -370,6 +375,7 @@ namespace osu.Game.Rulesets.Scoring
         /// <param name="bonusScore">The total bonus score.</param>
         /// <param name="totalBasicHitObjects">The total number of basic (non-tick and non-bonus) hitobjects in the beatmap.</param>
         /// <returns>The total score computed from the given scoring component ratios.</returns>
+        [Pure]
         public double ComputeScore(ScoringMode mode, double accuracyRatio, double comboRatio, double bonusScore, int totalBasicHitObjects)
         {
             switch (mode)
@@ -492,7 +498,8 @@ namespace osu.Game.Rulesets.Scoring
         /// <param name="scoreInfo">The score to extract scoring values from.</param>
         /// <param name="current">The "current" scoring values, representing the hit statistics as they appear.</param>
         /// <param name="maximum">The "maximum" scoring values, representing the hit statistics as if the maximum hit result was attained each time.</param>
-        public void ExtractScoringValues(ScoreInfo scoreInfo, out ScoringValues current, out ScoringValues maximum)
+        [Pure]
+        internal void ExtractScoringValues(ScoreInfo scoreInfo, out ScoringValues current, out ScoringValues maximum)
         {
             extractScoringValues(scoreInfo.Statistics, out current, out maximum);
             current.MaxCombo = scoreInfo.MaxCombo;
@@ -516,7 +523,8 @@ namespace osu.Game.Rulesets.Scoring
         /// <param name="header">The replay frame header to extract scoring values from.</param>
         /// <param name="current">The "current" scoring values, representing the hit statistics as they appear.</param>
         /// <param name="maximum">The "maximum" scoring values, representing the hit statistics as if the maximum hit result was attained each time.</param>
-        public void ExtractScoringValues(FrameHeader header, out ScoringValues current, out ScoringValues maximum)
+        [Pure]
+        internal void ExtractScoringValues(FrameHeader header, out ScoringValues current, out ScoringValues maximum)
         {
             extractScoringValues(header.Statistics, out current, out maximum);
             current.MaxCombo = header.MaxCombo;
@@ -537,6 +545,7 @@ namespace osu.Game.Rulesets.Scoring
         /// <param name="statistics">The hit statistics to extract scoring values from.</param>
         /// <param name="current">The "current" scoring values, representing the hit statistics as they appear.</param>
         /// <param name="maximum">The "maximum" scoring values, representing the hit statistics as if the maximum hit result was attained each time.</param>
+        [Pure]
         private void extractScoringValues(IReadOnlyDictionary<HitResult, int> statistics, out ScoringValues current, out ScoringValues maximum)
         {
             current = default;

From 425390e13bcb3aca9deb7329819883db4f2831e4 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 1 Jun 2022 09:51:06 +0900
Subject: [PATCH 5161/5547] Refactor to reduce nested conditions

---
 osu.Game/Rulesets/Scoring/ScoreProcessor.cs | 93 +++++++++------------
 1 file changed, 38 insertions(+), 55 deletions(-)

diff --git a/osu.Game/Rulesets/Scoring/ScoreProcessor.cs b/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
index 5712d9c94a..26a32ab1a0 100644
--- a/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
+++ b/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
@@ -168,43 +168,20 @@ namespace osu.Game.Rulesets.Scoring
 
             scoreResultCounts[result.Type] = scoreResultCounts.GetValueOrDefault(result.Type) + 1;
 
+            // Always update the maximum scoring values.
+            applyResult(result.Judgement.MaxResult, ref currentMaximumScoringValues);
+            currentMaximumScoringValues.MaxCombo += result.Judgement.MaxResult.IncreasesCombo() ? 1 : 0;
+
             if (!result.Type.IsScorable())
-            {
-                // The inverse of non-scorable (ignore) judgements may be bonus judgements.
-                if (result.Judgement.MaxResult.IsBonus())
-                    currentMaximumScoringValues.BonusScore += result.Judgement.MaxNumericResult;
-
                 return;
-            }
 
-            // Update rolling combo.
             if (result.Type.IncreasesCombo())
                 Combo.Value++;
             else if (result.Type.BreaksCombo())
                 Combo.Value = 0;
 
-            // Update maximum combo.
+            applyResult(result.Type, ref currentScoringValues);
             currentScoringValues.MaxCombo = HighestCombo.Value;
-            currentMaximumScoringValues.MaxCombo += result.Judgement.MaxResult.AffectsCombo() ? 1 : 0;
-
-            // Update base/bonus score.
-            if (result.Type.IsBonus())
-            {
-                currentScoringValues.BonusScore += result.Type.IsHit() ? result.Judgement.NumericResultFor(result) : 0;
-                currentMaximumScoringValues.BonusScore += result.Judgement.MaxNumericResult;
-            }
-            else
-            {
-                currentScoringValues.BaseScore += result.Type.IsHit() ? result.Judgement.NumericResultFor(result) : 0;
-                currentMaximumScoringValues.BaseScore += result.Judgement.MaxNumericResult;
-            }
-
-            // Update hitobject count.
-            if (result.Type.IsBasic())
-            {
-                currentScoringValues.HitObjects++;
-                currentMaximumScoringValues.HitObjects++;
-            }
 
             hitEvents.Add(CreateHitEvent(result));
             lastHitObject = result.HitObject;
@@ -212,6 +189,20 @@ namespace osu.Game.Rulesets.Scoring
             updateScore();
         }
 
+        private static void applyResult(HitResult result, ref ScoringValues scoringValues)
+        {
+            if (!result.IsScorable())
+                return;
+
+            if (result.IsBonus())
+                scoringValues.BonusScore += result.IsHit() ? Judgement.ToNumericResult(result) : 0;
+            else
+                scoringValues.BaseScore += result.IsHit() ? Judgement.ToNumericResult(result) : 0;
+
+            if (result.IsBasic())
+                scoringValues.HitObjects++;
+        }
+
         /// <summary>
         /// Creates the <see cref="HitEvent"/> that describes a <see cref="JudgementResult"/>.
         /// </summary>
@@ -230,37 +221,15 @@ namespace osu.Game.Rulesets.Scoring
 
             scoreResultCounts[result.Type] = scoreResultCounts.GetValueOrDefault(result.Type) - 1;
 
+            // Always update the maximum scoring values.
+            revertResult(result.Judgement.MaxResult, ref currentMaximumScoringValues);
+            currentMaximumScoringValues.MaxCombo -= result.Judgement.MaxResult.IncreasesCombo() ? 1 : 0;
+
             if (!result.Type.IsScorable())
-            {
-                // The inverse of non-scorable (ignore) judgements may be bonus judgements.
-                if (result.Judgement.MaxResult.IsBonus())
-                    currentMaximumScoringValues.BonusScore -= result.Judgement.MaxNumericResult;
-
                 return;
-            }
 
-            // Update maximum combo.
+            revertResult(result.Type, ref currentScoringValues);
             currentScoringValues.MaxCombo = HighestCombo.Value;
-            currentMaximumScoringValues.MaxCombo -= result.Judgement.MaxResult.AffectsCombo() ? 1 : 0;
-
-            // Update base/bonus score.
-            if (result.Type.IsBonus())
-            {
-                currentScoringValues.BonusScore -= result.Type.IsHit() ? result.Judgement.NumericResultFor(result) : 0;
-                currentMaximumScoringValues.BonusScore -= result.Judgement.MaxNumericResult;
-            }
-            else
-            {
-                currentScoringValues.BaseScore -= result.Type.IsHit() ? result.Judgement.NumericResultFor(result) : 0;
-                currentMaximumScoringValues.BaseScore -= result.Judgement.MaxNumericResult;
-            }
-
-            // Update hitobject count.
-            if (result.Type.IsBasic())
-            {
-                currentScoringValues.HitObjects--;
-                currentMaximumScoringValues.HitObjects--;
-            }
 
             Debug.Assert(hitEvents.Count > 0);
             lastHitObject = hitEvents[^1].LastHitObject;
@@ -269,6 +238,20 @@ namespace osu.Game.Rulesets.Scoring
             updateScore();
         }
 
+        private static void revertResult(HitResult result, ref ScoringValues scoringValues)
+        {
+            if (!result.IsScorable())
+                return;
+
+            if (result.IsBonus())
+                scoringValues.BonusScore -= result.IsHit() ? Judgement.ToNumericResult(result) : 0;
+            else
+                scoringValues.BaseScore -= result.IsHit() ? Judgement.ToNumericResult(result) : 0;
+
+            if (result.IsBasic())
+                scoringValues.HitObjects--;
+        }
+
         private void updateScore()
         {
             Accuracy.Value = currentMaximumScoringValues.BaseScore > 0 ? currentScoringValues.BaseScore / currentMaximumScoringValues.BaseScore : 1;

From 25941f618786ffd007f2be0e7be303d424593b2b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 1 Jun 2022 10:47:45 +0900
Subject: [PATCH 5162/5547] Use `DeepClone` instead of reflection call
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/Screens/Edit/Timing/TimingScreen.cs | 6 +-----
 1 file changed, 1 insertion(+), 5 deletions(-)

diff --git a/osu.Game/Screens/Edit/Timing/TimingScreen.cs b/osu.Game/Screens/Edit/Timing/TimingScreen.cs
index 5ee6106c46..b94f3e3ef4 100644
--- a/osu.Game/Screens/Edit/Timing/TimingScreen.cs
+++ b/osu.Game/Screens/Edit/Timing/TimingScreen.cs
@@ -160,11 +160,7 @@ namespace osu.Game.Screens.Edit.Timing
                     {
                         foreach (var controlPoint in selected.ControlPoints)
                         {
-                            if (Activator.CreateInstance(controlPoint.GetType()) is ControlPoint copy)
-                            {
-                                copy.CopyFrom(controlPoint);
-                                group.Add(copy);
-                            }
+                            group.Add(controlPoint.DeepClone());
                         }
                     }
                 }

From 6042cf1a3b9fe2255346853ce791f037823d7ef6 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 1 Jun 2022 14:36:25 +0900
Subject: [PATCH 5163/5547] Add metronome sound

Placeholder pending follow-up from @nekodex (which as discussed should
probably have a second sound for the metronome locking into "stopped"
position).
---
 .../Screens/Edit/Timing/MetronomeDisplay.cs     | 17 +++++++++++++++--
 1 file changed, 15 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/Edit/Timing/MetronomeDisplay.cs b/osu.Game/Screens/Edit/Timing/MetronomeDisplay.cs
index 57fcff6a4c..1f065d1551 100644
--- a/osu.Game/Screens/Edit/Timing/MetronomeDisplay.cs
+++ b/osu.Game/Screens/Edit/Timing/MetronomeDisplay.cs
@@ -3,6 +3,8 @@
 
 using System;
 using osu.Framework.Allocation;
+using osu.Framework.Audio;
+using osu.Framework.Audio.Sample;
 using osu.Framework.Audio.Track;
 using osu.Framework.Bindables;
 using osu.Framework.Extensions.LocalisationExtensions;
@@ -31,12 +33,16 @@ namespace osu.Game.Screens.Edit.Timing
 
         private IAdjustableClock metronomeClock;
 
+        private Sample clunk;
+
         [Resolved]
         private OverlayColourProvider overlayColourProvider { get; set; }
 
         [BackgroundDependencyLoader]
-        private void load()
+        private void load(AudioManager audio)
         {
+            clunk = audio.Samples.Get(@"Multiplayer/countdown-tick");
+
             const float taper = 25;
             const float swing_vertical_offset = -23;
             const float lower_cover_height = 32;
@@ -269,8 +275,15 @@ namespace osu.Game.Screens.Edit.Timing
 
             if (currentAngle != 0 && Math.Abs(currentAngle - targetAngle) > angle * 1.8f && isSwinging)
             {
-                using (stick.BeginDelayedSequence(beatLength / 2))
+                using (BeginDelayedSequence(beatLength / 2))
+                {
                     stick.FlashColour(overlayColourProvider.Content1, beatLength, Easing.OutQuint);
+                    Schedule(() =>
+                    {
+                        clunk.Frequency.Value = RNG.NextDouble(0.98f, 1.02f);
+                        clunk?.Play();
+                    });
+                }
             }
         }
     }

From 58ba92772cd8acde594fb9dbc1ad6ba0271ecdf3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 1 Jun 2022 16:01:34 +0900
Subject: [PATCH 5164/5547] Reword comment to read better
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/Screens/Edit/Timing/WaveformComparisonDisplay.cs | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/Edit/Timing/WaveformComparisonDisplay.cs b/osu.Game/Screens/Edit/Timing/WaveformComparisonDisplay.cs
index ce13a8a244..1f12e2e5c9 100644
--- a/osu.Game/Screens/Edit/Timing/WaveformComparisonDisplay.cs
+++ b/osu.Game/Screens/Edit/Timing/WaveformComparisonDisplay.cs
@@ -112,9 +112,10 @@ namespace osu.Game.Screens.Edit.Timing
             if (tcp == null)
             {
                 timingPoint = new TimingControlPoint();
-                // During movement of a control point's offset, this clause can be hit momentarily.
+                // During movement of a control point's offset, this clause can be hit momentarily,
+                // as moving a control point is implemented by removing it and inserting it at the new time.
                 // We don't want to reset the `selectedGroupStartTime` here as we rely on having the
-                // last value to perform an offset traversal below.
+                // last value to update the waveform display below.
                 selectedGroupEndTime = beatmap.Value.Track.Length;
                 return;
             }

From f3fd5bbfc13b027cbae8d657e2d5b8d32ddf9f40 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 1 Jun 2022 16:05:29 +0900
Subject: [PATCH 5165/5547] Increase flash delay and ensure text is always
 shown immediately on lock

---
 .../Edit/Timing/WaveformComparisonDisplay.cs   | 18 +++++++++++++-----
 1 file changed, 13 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Screens/Edit/Timing/WaveformComparisonDisplay.cs b/osu.Game/Screens/Edit/Timing/WaveformComparisonDisplay.cs
index 1f12e2e5c9..4275eaf7d3 100644
--- a/osu.Game/Screens/Edit/Timing/WaveformComparisonDisplay.cs
+++ b/osu.Game/Screens/Edit/Timing/WaveformComparisonDisplay.cs
@@ -99,7 +99,10 @@ namespace osu.Game.Screens.Edit.Timing
 
             displayLocked.BindValueChanged(locked =>
             {
-                lockedOverlay.FadeTo(locked.NewValue ? 1 : 0, 200, Easing.OutQuint);
+                if (locked.NewValue)
+                    lockedOverlay.Show();
+                else
+                    lockedOverlay.Hide();
             }, true);
         }
 
@@ -268,15 +271,20 @@ namespace osu.Game.Screens.Edit.Timing
                 };
             }
 
-            protected override void LoadComplete()
+            public override void Show()
             {
-                base.LoadComplete();
+                this.FadeIn(100, Easing.OutQuint);
 
                 text
-                    .FadeIn().Then().Delay(500)
-                    .FadeOut().Then().Delay(500)
+                    .FadeIn().Then().Delay(600)
+                    .FadeOut().Then().Delay(600)
                     .Loop();
             }
+
+            public override void Hide()
+            {
+                this.FadeOut(100, Easing.OutQuint);
+            }
         }
 
         internal class WaveformRow : CompositeDrawable

From 42598ce22aa7852054ce74771b685db186d434aa Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 1 Jun 2022 16:51:34 +0900
Subject: [PATCH 5166/5547] Refactor `warning` to `notice` in method names and
 usages

---
 .../Visual/Settings/TestSceneSettingsItem.cs     | 10 +++++-----
 .../Settings/Sections/Graphics/LayoutSettings.cs | 10 +++++-----
 .../Sections/Graphics/RendererSettings.cs        |  4 ++--
 .../Settings/Sections/Input/MouseSettings.cs     |  4 ++--
 .../Sections/UserInterface/MainMenuSettings.cs   |  4 ++--
 osu.Game/Overlays/Settings/SettingsItem.cs       | 16 ++++++++--------
 6 files changed, 24 insertions(+), 24 deletions(-)

diff --git a/osu.Game.Tests/Visual/Settings/TestSceneSettingsItem.cs b/osu.Game.Tests/Visual/Settings/TestSceneSettingsItem.cs
index f631e1603b..3e679a7905 100644
--- a/osu.Game.Tests/Visual/Settings/TestSceneSettingsItem.cs
+++ b/osu.Game.Tests/Visual/Settings/TestSceneSettingsItem.cs
@@ -84,7 +84,7 @@ namespace osu.Game.Tests.Visual.Settings
             AddStep("clear label", () => textBox.LabelText = default);
             AddAssert("default value button centre aligned to control size", () => Precision.AlmostEquals(restoreDefaultValueButton.Parent.DrawHeight, control.DrawHeight, 1));
 
-            AddStep("set warning text", () => textBox.SetWarningText("This is some very important warning text! Hopefully it doesn't break the alignment of the default value indicator..."));
+            AddStep("set warning text", () => textBox.SetNoticeText("This is some very important warning text! Hopefully it doesn't break the alignment of the default value indicator...", true));
             AddAssert("default value button centre aligned to control size", () => Precision.AlmostEquals(restoreDefaultValueButton.Parent.DrawHeight, control.DrawHeight, 1));
         }
 
@@ -132,16 +132,16 @@ namespace osu.Game.Tests.Visual.Settings
             AddStep("create settings item", () => Child = numberBox = new SettingsNumberBox());
             AddAssert("warning text not created", () => !numberBox.ChildrenOfType<LinkFlowContainer>().Any());
 
-            AddStep("set warning text", () => numberBox.SetWarningText("this is a warning!"));
+            AddStep("set warning text", () => numberBox.SetNoticeText("this is a warning!", true));
             AddAssert("warning text created", () => numberBox.ChildrenOfType<LinkFlowContainer>().Single().Alpha == 1);
 
-            AddStep("unset warning text", () => numberBox.ClearWarningText());
+            AddStep("unset warning text", () => numberBox.ClearNoticeText());
             AddAssert("warning text hidden", () => !numberBox.ChildrenOfType<LinkFlowContainer>().Any());
 
-            AddStep("set warning text again", () => numberBox.SetWarningText("another warning!"));
+            AddStep("set warning text again", () => numberBox.SetNoticeText("another warning!", true));
             AddAssert("warning text shown again", () => numberBox.ChildrenOfType<LinkFlowContainer>().Single().Alpha == 1);
 
-            AddStep("set non warning text", () => numberBox.SetWarningText("you did good!", false));
+            AddStep("set non warning text", () => numberBox.SetNoticeText("you did good!"));
         }
     }
 }
diff --git a/osu.Game/Overlays/Settings/Sections/Graphics/LayoutSettings.cs b/osu.Game/Overlays/Settings/Sections/Graphics/LayoutSettings.cs
index 53f84a9bb2..d79ba593f7 100644
--- a/osu.Game/Overlays/Settings/Sections/Graphics/LayoutSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Graphics/LayoutSettings.cs
@@ -226,7 +226,7 @@ namespace osu.Game.Overlays.Settings.Sections.Graphics
         {
             if (windowModeDropdown.Current.Value != WindowMode.Fullscreen)
             {
-                windowModeDropdown.SetWarningText(GraphicsSettingsStrings.NotFullscreenNote);
+                windowModeDropdown.SetNoticeText(GraphicsSettingsStrings.NotFullscreenNote, true);
                 return;
             }
 
@@ -235,22 +235,22 @@ namespace osu.Game.Overlays.Settings.Sections.Graphics
                 switch (fullscreenCapability.Value)
                 {
                     case FullscreenCapability.Unknown:
-                        windowModeDropdown.SetWarningText(LayoutSettingsStrings.CheckingForFullscreenCapabilities);
+                        windowModeDropdown.SetNoticeText(LayoutSettingsStrings.CheckingForFullscreenCapabilities, true);
                         break;
 
                     case FullscreenCapability.Capable:
-                        windowModeDropdown.SetWarningText(LayoutSettingsStrings.OsuIsRunningExclusiveFullscreen, false);
+                        windowModeDropdown.SetNoticeText(LayoutSettingsStrings.OsuIsRunningExclusiveFullscreen);
                         break;
 
                     case FullscreenCapability.Incapable:
-                        windowModeDropdown.SetWarningText(LayoutSettingsStrings.UnableToRunExclusiveFullscreen);
+                        windowModeDropdown.SetNoticeText(LayoutSettingsStrings.UnableToRunExclusiveFullscreen, true);
                         break;
                 }
             }
             else
             {
                 // We can only detect exclusive fullscreen status on windows currently.
-                windowModeDropdown.ClearWarningText();
+                windowModeDropdown.ClearNoticeText();
             }
         }
 
diff --git a/osu.Game/Overlays/Settings/Sections/Graphics/RendererSettings.cs b/osu.Game/Overlays/Settings/Sections/Graphics/RendererSettings.cs
index 6ec4decdda..8c3e45cd62 100644
--- a/osu.Game/Overlays/Settings/Sections/Graphics/RendererSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Graphics/RendererSettings.cs
@@ -51,11 +51,11 @@ namespace osu.Game.Overlays.Settings.Sections.Graphics
                 switch (limit.NewValue)
                 {
                     case FrameSync.Unlimited:
-                        frameLimiterDropdown.SetWarningText(GraphicsSettingsStrings.UnlimitedFramesNote);
+                        frameLimiterDropdown.SetNoticeText(GraphicsSettingsStrings.UnlimitedFramesNote, true);
                         break;
 
                     default:
-                        frameLimiterDropdown.ClearWarningText();
+                        frameLimiterDropdown.ClearNoticeText();
                         break;
                 }
             }, true);
diff --git a/osu.Game/Overlays/Settings/Sections/Input/MouseSettings.cs b/osu.Game/Overlays/Settings/Sections/Input/MouseSettings.cs
index 042cec106a..1511d53b6b 100644
--- a/osu.Game/Overlays/Settings/Sections/Input/MouseSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Input/MouseSettings.cs
@@ -117,9 +117,9 @@ namespace osu.Game.Overlays.Settings.Sections.Input
                 if (RuntimeInfo.OS != RuntimeInfo.Platform.Windows)
                 {
                     if (highPrecision.NewValue)
-                        highPrecisionMouse.SetWarningText(MouseSettingsStrings.HighPrecisionPlatformWarning);
+                        highPrecisionMouse.SetNoticeText(MouseSettingsStrings.HighPrecisionPlatformWarning, true);
                     else
-                        highPrecisionMouse.ClearWarningText();
+                        highPrecisionMouse.ClearNoticeText();
                 }
             }, true);
         }
diff --git a/osu.Game/Overlays/Settings/Sections/UserInterface/MainMenuSettings.cs b/osu.Game/Overlays/Settings/Sections/UserInterface/MainMenuSettings.cs
index d3cc889abe..fceffa09c5 100644
--- a/osu.Game/Overlays/Settings/Sections/UserInterface/MainMenuSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/UserInterface/MainMenuSettings.cs
@@ -62,9 +62,9 @@ namespace osu.Game.Overlays.Settings.Sections.UserInterface
             user.BindValueChanged(u =>
             {
                 if (u.NewValue?.IsSupporter != true)
-                    backgroundSourceDropdown.SetWarningText(UserInterfaceStrings.NotSupporterNote);
+                    backgroundSourceDropdown.SetNoticeText(UserInterfaceStrings.NotSupporterNote, true);
                 else
-                    backgroundSourceDropdown.ClearWarningText();
+                    backgroundSourceDropdown.ClearNoticeText();
             }, true);
         }
     }
diff --git a/osu.Game/Overlays/Settings/SettingsItem.cs b/osu.Game/Overlays/Settings/SettingsItem.cs
index fa521c0126..ea076b77ac 100644
--- a/osu.Game/Overlays/Settings/SettingsItem.cs
+++ b/osu.Game/Overlays/Settings/SettingsItem.cs
@@ -41,7 +41,7 @@ namespace osu.Game.Overlays.Settings
 
         private SpriteText labelText;
 
-        private OsuTextFlowContainer warningText;
+        private OsuTextFlowContainer noticeText;
 
         public bool ShowsDefaultIndicator = true;
         private readonly Container defaultValueIndicatorContainer;
@@ -72,24 +72,24 @@ namespace osu.Game.Overlays.Settings
         /// <summary>
         /// Clear any warning text.
         /// </summary>
-        public void ClearWarningText()
+        public void ClearNoticeText()
         {
-            warningText?.Expire();
-            warningText = null;
+            noticeText?.Expire();
+            noticeText = null;
         }
 
         /// <summary>
         /// Set the text to be displayed at the bottom of this <see cref="SettingsItem{T}"/>.
-        /// Generally used to recommend the user change their setting as the current one is considered sub-optimal.
+        /// Generally used to provide feedback to a user about a sub-optimal setting.
         /// </summary>
         /// <param name="text">The text to display.</param>
         /// <param name="isWarning">Whether the text is in a warning state. Will decide how this is visually represented.</param>
-        public void SetWarningText(LocalisableString text, bool isWarning = true)
+        public void SetNoticeText(LocalisableString text, bool isWarning = false)
         {
-            ClearWarningText();
+            ClearNoticeText();
 
             // construct lazily for cases where the label is not needed (may be provided by the Control).
-            FlowContent.Add(warningText = new LinkFlowContainer(cp => cp.Colour = isWarning ? colours.Yellow : colours.Green)
+            FlowContent.Add(noticeText = new LinkFlowContainer(cp => cp.Colour = isWarning ? colours.Yellow : colours.Green)
             {
                 RelativeSizeAxes = Axes.X,
                 AutoSizeAxes = Axes.Y,

From c55c3325a4c7df43dbd8df314e29c9dc7e21354c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 1 Jun 2022 17:43:40 +0900
Subject: [PATCH 5167/5547] Remove unused using statements

---
 osu.Game/Screens/Edit/Timing/TimingScreen.cs | 1 -
 1 file changed, 1 deletion(-)

diff --git a/osu.Game/Screens/Edit/Timing/TimingScreen.cs b/osu.Game/Screens/Edit/Timing/TimingScreen.cs
index b94f3e3ef4..3c59cfff64 100644
--- a/osu.Game/Screens/Edit/Timing/TimingScreen.cs
+++ b/osu.Game/Screens/Edit/Timing/TimingScreen.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.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;

From 8c54bd46bb2209e8f09965b2a2e5e06d82311e2a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 1 Jun 2022 17:46:05 +0900
Subject: [PATCH 5168/5547] Rename button to more appropriate name

---
 osu.Game/Screens/Edit/Timing/TapTimingControl.cs           | 4 ++--
 .../Edit/Timing/{AdjustButton.cs => TimingAdjustButton.cs} | 7 +++++--
 2 files changed, 7 insertions(+), 4 deletions(-)
 rename osu.Game/Screens/Edit/Timing/{AdjustButton.cs => TimingAdjustButton.cs} (96%)

diff --git a/osu.Game/Screens/Edit/Timing/TapTimingControl.cs b/osu.Game/Screens/Edit/Timing/TapTimingControl.cs
index f9f5a20405..990f8d2ce0 100644
--- a/osu.Game/Screens/Edit/Timing/TapTimingControl.cs
+++ b/osu.Game/Screens/Edit/Timing/TapTimingControl.cs
@@ -92,7 +92,7 @@ namespace osu.Game.Screens.Edit.Timing
                                 Padding = new MarginPadding(10),
                                 Children = new Drawable[]
                                 {
-                                    new AdjustButton(1)
+                                    new TimingAdjustButton(1)
                                     {
                                         Text = "Offset",
                                         RelativeSizeAxes = Axes.X,
@@ -100,7 +100,7 @@ namespace osu.Game.Screens.Edit.Timing
                                         Height = 50,
                                         Action = adjustOffset,
                                     },
-                                    new AdjustButton(0.1)
+                                    new TimingAdjustButton(0.1)
                                     {
                                         Anchor = Anchor.TopRight,
                                         Origin = Anchor.TopRight,
diff --git a/osu.Game/Screens/Edit/Timing/AdjustButton.cs b/osu.Game/Screens/Edit/Timing/TimingAdjustButton.cs
similarity index 96%
rename from osu.Game/Screens/Edit/Timing/AdjustButton.cs
rename to osu.Game/Screens/Edit/Timing/TimingAdjustButton.cs
index b0a0517e94..335f593772 100644
--- a/osu.Game/Screens/Edit/Timing/AdjustButton.cs
+++ b/osu.Game/Screens/Edit/Timing/TimingAdjustButton.cs
@@ -16,7 +16,10 @@ using osu.Game.Overlays;
 
 namespace osu.Game.Screens.Edit.Timing
 {
-    public class AdjustButton : CompositeDrawable
+    /// <summary>
+    /// A button with variable constant output based on hold position and length.
+    /// </summary>
+    public class TimingAdjustButton : CompositeDrawable
     {
         public Action<double> Action;
 
@@ -50,7 +53,7 @@ namespace osu.Game.Screens.Edit.Timing
         [Resolved]
         private OverlayColourProvider colourProvider { get; set; }
 
-        public AdjustButton(double adjustAmount)
+        public TimingAdjustButton(double adjustAmount)
         {
             this.adjustAmount = adjustAmount;
 

From 1293bbdbd931a7f17f5c5249e69593d0f16430c8 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 1 Jun 2022 17:46:33 +0900
Subject: [PATCH 5169/5547] Remove unnecessary null checks on `Text` property

---
 osu.Game/Screens/Edit/Timing/TimingAdjustButton.cs | 8 ++------
 1 file changed, 2 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Screens/Edit/Timing/TimingAdjustButton.cs b/osu.Game/Screens/Edit/Timing/TimingAdjustButton.cs
index 335f593772..46bb8356f7 100644
--- a/osu.Game/Screens/Edit/Timing/TimingAdjustButton.cs
+++ b/osu.Game/Screens/Edit/Timing/TimingAdjustButton.cs
@@ -42,12 +42,8 @@ namespace osu.Game.Screens.Edit.Timing
 
         public LocalisableString Text
         {
-            get => text?.Text ?? default;
-            set
-            {
-                if (text != null)
-                    text.Text = value;
-            }
+            get => text.Text;
+            set => text.Text = value;
         }
 
         [Resolved]

From 187acb0718bda64c693f19ea9da3bb041d556161 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 1 Jun 2022 17:57:53 +0900
Subject: [PATCH 5170/5547] Simplify linq tracking logic

---
 osu.Game/Screens/Edit/Timing/TimingScreen.cs | 30 ++------------------
 1 file changed, 3 insertions(+), 27 deletions(-)

diff --git a/osu.Game/Screens/Edit/Timing/TimingScreen.cs b/osu.Game/Screens/Edit/Timing/TimingScreen.cs
index 0cf4fca58a..ebb958f884 100644
--- a/osu.Game/Screens/Edit/Timing/TimingScreen.cs
+++ b/osu.Game/Screens/Edit/Timing/TimingScreen.cs
@@ -156,35 +156,11 @@ namespace osu.Game.Screens.Edit.Timing
                 {
                     // 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.
-                    IEnumerable<ControlPointGroup> groups = Beatmap.ControlPointInfo.Groups;
-
-                    bool currentTimeBeforeSelectedGroup = clock.CurrentTimeAccurate < selectedGroup.Value.Time;
-
-                    // Decide whether we are searching backwards or forwards.
-                    if (currentTimeBeforeSelectedGroup)
-                        groups = groups.Reverse();
 
                     // Find the next group which has the same type as the selected one.
-                    groups = groups.SkipWhile(g => g != selectedGroup.Value)
-                                   .Skip(1)
-                                   .Where(g => g.ControlPoints.Any(cp => cp.GetType() == selectedPointType));
-
-                    ControlPointGroup newGroup = groups.FirstOrDefault();
-
-                    if (newGroup != null)
-                    {
-                        if (currentTimeBeforeSelectedGroup)
-                        {
-                            // When seeking backwards, the first match from the LINQ query is always what we want.
-                            selectedGroup.Value = newGroup;
-                        }
-                        else
-                        {
-                            // When seeking forwards, we also need to check that the next match is before the current time.
-                            if (newGroup.Time <= clock.CurrentTimeAccurate)
-                                selectedGroup.Value = newGroup;
-                        }
-                    }
+                    selectedGroup.Value = Beatmap.ControlPointInfo.Groups
+                                                 .Where(g => g.ControlPoints.Any(cp => cp.GetType() == selectedPointType))
+                                                 .LastOrDefault(g => g.Time <= clock.CurrentTimeAccurate);
                 }
             }
 

From 0472881078490377697b66a7b4201dc341d87d84 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 1 Jun 2022 18:03:03 +0900
Subject: [PATCH 5171/5547] Fix null check only covering one of two calls

---
 osu.Game/Screens/Edit/Timing/MetronomeDisplay.cs | 12 ++++++++----
 1 file changed, 8 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Screens/Edit/Timing/MetronomeDisplay.cs b/osu.Game/Screens/Edit/Timing/MetronomeDisplay.cs
index 1f065d1551..3a067a281e 100644
--- a/osu.Game/Screens/Edit/Timing/MetronomeDisplay.cs
+++ b/osu.Game/Screens/Edit/Timing/MetronomeDisplay.cs
@@ -278,11 +278,15 @@ namespace osu.Game.Screens.Edit.Timing
                 using (BeginDelayedSequence(beatLength / 2))
                 {
                     stick.FlashColour(overlayColourProvider.Content1, beatLength, Easing.OutQuint);
-                    Schedule(() =>
+
+                    if (clunk != null)
                     {
-                        clunk.Frequency.Value = RNG.NextDouble(0.98f, 1.02f);
-                        clunk?.Play();
-                    });
+                        Schedule(() =>
+                        {
+                            clunk.Frequency.Value = RNG.NextDouble(0.98f, 1.02f);
+                            clunk.Play();
+                        });
+                    }
                 }
             }
         }

From 93b8c90ecca5cae08e7fce1b331f3c0f0bfe5739 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 1 Jun 2022 18:04:13 +0900
Subject: [PATCH 5172/5547] Apply frequency adjust to channel rather than
 sample for safety

---
 osu.Game/Screens/Edit/Timing/MetronomeDisplay.cs | 14 ++++++++------
 1 file changed, 8 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Screens/Edit/Timing/MetronomeDisplay.cs b/osu.Game/Screens/Edit/Timing/MetronomeDisplay.cs
index 3a067a281e..4143c5ea55 100644
--- a/osu.Game/Screens/Edit/Timing/MetronomeDisplay.cs
+++ b/osu.Game/Screens/Edit/Timing/MetronomeDisplay.cs
@@ -279,14 +279,16 @@ namespace osu.Game.Screens.Edit.Timing
                 {
                     stick.FlashColour(overlayColourProvider.Content1, beatLength, Easing.OutQuint);
 
-                    if (clunk != null)
+                    Schedule(() =>
                     {
-                        Schedule(() =>
+                        var channel = clunk?.GetChannel();
+
+                        if (channel != null)
                         {
-                            clunk.Frequency.Value = RNG.NextDouble(0.98f, 1.02f);
-                            clunk.Play();
-                        });
-                    }
+                            channel.Frequency.Value = RNG.NextDouble(0.98f, 1.02f);
+                            channel.Play();
+                        }
+                    });
                 }
             }
         }

From a4ec32b499dabcc1280033b1fe37688fbec1f5c0 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 1 Jun 2022 18:02:17 +0900
Subject: [PATCH 5173/5547] Add button sound effect

---
 .../Screens/Edit/Timing/TimingAdjustButton.cs | 24 +++++++++++++++++--
 1 file changed, 22 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/Edit/Timing/TimingAdjustButton.cs b/osu.Game/Screens/Edit/Timing/TimingAdjustButton.cs
index 46bb8356f7..9fc7e56a3d 100644
--- a/osu.Game/Screens/Edit/Timing/TimingAdjustButton.cs
+++ b/osu.Game/Screens/Edit/Timing/TimingAdjustButton.cs
@@ -4,6 +4,8 @@
 using System;
 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;
@@ -26,6 +28,8 @@ namespace osu.Game.Screens.Edit.Timing
         private readonly double adjustAmount;
         private ScheduledDelegate adjustDelegate;
 
+        private const int max_multiplier = 10;
+
         private const int adjust_levels = 4;
 
         private const double initial_delay = 300;
@@ -40,6 +44,8 @@ namespace osu.Game.Screens.Edit.Timing
 
         private readonly OsuSpriteText text;
 
+        private Sample sample;
+
         public LocalisableString Text
         {
             get => text.Text;
@@ -79,8 +85,10 @@ namespace osu.Game.Screens.Edit.Timing
         }
 
         [BackgroundDependencyLoader]
-        private void load()
+        private void load(AudioManager audio)
         {
+            sample = audio.Samples.Get(@"UI/notch-tick");
+
             background.Colour = colourProvider.Background3;
 
             for (int i = 1; i <= adjust_levels; i++)
@@ -120,6 +128,17 @@ namespace osu.Game.Screens.Edit.Timing
                     adjustDelay = Math.Max(minimum_delay, adjustDelay * 0.9f);
 
                     hoveredBox.Flash();
+
+                    var channel = sample?.GetChannel();
+
+                    if (channel != null)
+                    {
+                        double repeatModifier = 0.05f * (Math.Abs(adjustDelay - initial_delay) / minimum_delay);
+                        double multiplierModifier = (hoveredBox.Multiplier / max_multiplier) * 0.2f;
+
+                        channel.Frequency.Value = 1 + multiplierModifier + repeatModifier;
+                        channel.Play();
+                    }
                 }
                 else
                 {
@@ -195,7 +214,8 @@ namespace osu.Game.Screens.Edit.Timing
 
                     case 3: return 5;
 
-                    case 4: return 10;
+                    case 4:
+                        return max_multiplier;
                 }
             }
 

From caa29e1f9ecff4c86e973a7ad7309c482d13927d Mon Sep 17 00:00:00 2001
From: tornac1234 <tortornac@gmail.com>
Date: Wed, 1 Jun 2022 12:05:24 +0200
Subject: [PATCH 5174/5547] Removed ruleset rankings request from
 DiscordRichPresence.cs

---
 osu.Desktop/DiscordRichPresence.cs | 23 +----------------------
 1 file changed, 1 insertion(+), 22 deletions(-)

diff --git a/osu.Desktop/DiscordRichPresence.cs b/osu.Desktop/DiscordRichPresence.cs
index 14fea7a08d..0d276d963f 100644
--- a/osu.Desktop/DiscordRichPresence.cs
+++ b/osu.Desktop/DiscordRichPresence.cs
@@ -12,7 +12,6 @@ using osu.Framework.Logging;
 using osu.Game.Configuration;
 using osu.Game.Extensions;
 using osu.Game.Online.API;
-using osu.Game.Online.API.Requests;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets;
 using osu.Game.Users;
@@ -81,7 +80,7 @@ namespace osu.Desktop
         private void onReady(object _, ReadyMessage __)
         {
             Logger.Log("Discord RPC Client ready.", LoggingTarget.Network, LogLevel.Debug);
-            requestUserRulesetsRankings();
+            updateStatus();
         }
 
         private void updateStatus()
@@ -124,26 +123,6 @@ namespace osu.Desktop
             client.SetPresence(presence);
         }
 
-        private void requestUserRulesetsRankings()
-        {
-            RulesetInfo cachedRuleset = ruleset.Value;
-
-            var req = new GetUsersRequest(new int[] { provider.LocalUser.Value.Id });
-            req.Success += result =>
-            {
-                if (result.Users.Count == 1)
-                {
-                    APIUser apiUser = result.Users[0];
-                    user.Value.RulesetsStatistics = apiUser.RulesetsStatistics;
-                }
-
-                updateStatus();
-            };
-            req.Failure += _ => updateStatus();
-
-            provider.Queue(req);
-        }
-
         private static readonly int ellipsis_length = Encoding.UTF8.GetByteCount(new[] { '…' });
 
         private string truncate(string str)

From 534e8f8fac69c2df110922f17b1b6f79ecfde98f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 1 Jun 2022 20:20:16 +0900
Subject: [PATCH 5175/5547] Only switch to found group if non-null

---
 osu.Game/Screens/Edit/Timing/TimingScreen.cs | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Screens/Edit/Timing/TimingScreen.cs b/osu.Game/Screens/Edit/Timing/TimingScreen.cs
index ebb958f884..d7ca306037 100644
--- a/osu.Game/Screens/Edit/Timing/TimingScreen.cs
+++ b/osu.Game/Screens/Edit/Timing/TimingScreen.cs
@@ -158,9 +158,12 @@ namespace osu.Game.Screens.Edit.Timing
                     // 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.
-                    selectedGroup.Value = Beatmap.ControlPointInfo.Groups
-                                                 .Where(g => g.ControlPoints.Any(cp => cp.GetType() == selectedPointType))
-                                                 .LastOrDefault(g => g.Time <= clock.CurrentTimeAccurate);
+                    var found = Beatmap.ControlPointInfo.Groups
+                                       .Where(g => g.ControlPoints.Any(cp => cp.GetType() == selectedPointType))
+                                       .LastOrDefault(g => g.Time <= clock.CurrentTimeAccurate);
+
+                    if (found != null)
+                        selectedGroup.Value = found;
                 }
             }
 

From e2cdc66f6d378c20511c3be2fe724aa0f68a3eca Mon Sep 17 00:00:00 2001
From: tornac1234 <tortornac@gmail.com>
Date: Wed, 1 Jun 2022 13:31:38 +0200
Subject: [PATCH 5176/5547] Added user RulesetsStatistics fetching when
 connecting

---
 osu.Game/Online/API/APIAccess.cs | 26 +++++++++++++++++++++++---
 1 file changed, 23 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Online/API/APIAccess.cs b/osu.Game/Online/API/APIAccess.cs
index 62ddd49881..f59bee1065 100644
--- a/osu.Game/Online/API/APIAccess.cs
+++ b/osu.Game/Online/API/APIAccess.cs
@@ -171,12 +171,32 @@ namespace osu.Game.Online.API
                         };
                         userReq.Success += u =>
                         {
-                            localUser.Value = u;
-
                             // todo: save/pull from settings
-                            localUser.Value.Status.Value = new UserStatusOnline();
+                            u.Status.Value = new UserStatusOnline();
 
                             failureCount = 0;
+
+                            // getting user's full statistics (concerning every ruleset)
+                            // we delay the localUser.Value setting because BindValueChanged won't record two value changes in a row
+                            var statsRequest = new GetUsersRequest(new int[] { u.Id });
+                            statsRequest.Failure += _ =>
+                            {
+                                localUser.Value = u;
+                                failConnectionProcess();
+                            };
+                            statsRequest.Success += result =>
+                            {
+                                if (result.Users.Count == 1)
+                                {
+                                    u.RulesetsStatistics = result.Users[0].RulesetsStatistics;
+                                    localUser.Value = u;
+                                    return;
+                                }
+                                // Should never... happen ?
+                                statsRequest.Fail(new Exception("Empty response for GetUsersRequest"));
+                            };
+
+                            handleRequest(statsRequest);
                         };
 
                         if (!handleRequest(userReq))

From cb37dd74c19f9bb21c754128f8850123f1a83359 Mon Sep 17 00:00:00 2001
From: "Hugo \"ThePooN\" Denizart" <thepoon@cartooncraft.fr>
Date: Wed, 1 Jun 2022 17:14:07 +0200
Subject: [PATCH 5177/5547] =?UTF-8?q?=F0=9F=94=A7=20Add=20prefix=20to=20Se?=
 =?UTF-8?q?ntry=20release=20name?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .github/workflows/sentry-release.yml | 2 +-
 osu.Game/Utils/SentryLogger.cs       | 5 ++---
 2 files changed, 3 insertions(+), 4 deletions(-)

diff --git a/.github/workflows/sentry-release.yml b/.github/workflows/sentry-release.yml
index 8ca9f38234..794943c4b1 100644
--- a/.github/workflows/sentry-release.yml
+++ b/.github/workflows/sentry-release.yml
@@ -23,4 +23,4 @@ jobs:
           SENTRY_URL: https://sentry.ppy.sh/
         with:
           environment: production
-          version: ${{ github.ref }}
+          version: osu/${{ github.ref_name }}
diff --git a/osu.Game/Utils/SentryLogger.cs b/osu.Game/Utils/SentryLogger.cs
index 137bf7e0aa..a4f8ea0ef6 100644
--- a/osu.Game/Utils/SentryLogger.cs
+++ b/osu.Game/Utils/SentryLogger.cs
@@ -48,9 +48,8 @@ namespace osu.Game.Utils
 
                 options.AutoSessionTracking = true;
                 options.IsEnvironmentUser = false;
-                // The reported release needs to match release tags on github in order for sentry
-                // to automatically associate and track against releases.
-                options.Release = game.Version.Replace($@"-{OsuGameBase.BUILD_SUFFIX}", string.Empty);
+                // The reported release needs to match version as reported to Sentry in .github/workflows/sentry-release.yml
+                options.Release = $"osu/{game.Version.Replace($@"-{OsuGameBase.BUILD_SUFFIX}", string.Empty)}";
             });
 
             Logger.NewEntry += processLogEntry;

From 384cdcbc40e0a193a7e8d9102e44b93579eef869 Mon Sep 17 00:00:00 2001
From: "Hugo \"ThePooN\" Denizart" <thepoon@cartooncraft.fr>
Date: Wed, 1 Jun 2022 18:12:29 +0200
Subject: [PATCH 5178/5547] =?UTF-8?q?=F0=9F=9A=91=20Fix=20use=20of=20illeg?=
 =?UTF-8?q?al=20character=20in=20Sentry's=20release=20name=20scheme?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .github/workflows/sentry-release.yml | 2 +-
 osu.Game/Utils/SentryLogger.cs       | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/sentry-release.yml b/.github/workflows/sentry-release.yml
index 794943c4b1..442b97c473 100644
--- a/.github/workflows/sentry-release.yml
+++ b/.github/workflows/sentry-release.yml
@@ -23,4 +23,4 @@ jobs:
           SENTRY_URL: https://sentry.ppy.sh/
         with:
           environment: production
-          version: osu/${{ github.ref_name }}
+          version: osu@${{ github.ref_name }}
diff --git a/osu.Game/Utils/SentryLogger.cs b/osu.Game/Utils/SentryLogger.cs
index a4f8ea0ef6..ecc7fc4774 100644
--- a/osu.Game/Utils/SentryLogger.cs
+++ b/osu.Game/Utils/SentryLogger.cs
@@ -49,7 +49,7 @@ namespace osu.Game.Utils
                 options.AutoSessionTracking = true;
                 options.IsEnvironmentUser = false;
                 // The reported release needs to match version as reported to Sentry in .github/workflows/sentry-release.yml
-                options.Release = $"osu/{game.Version.Replace($@"-{OsuGameBase.BUILD_SUFFIX}", string.Empty)}";
+                options.Release = $"osu@{game.Version.Replace($@"-{OsuGameBase.BUILD_SUFFIX}", string.Empty)}";
             });
 
             Logger.NewEntry += processLogEntry;

From 6b709de2c26d259676e158e35a228e82eab13071 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 1 Jun 2022 20:18:02 +0200
Subject: [PATCH 5179/5547] Remove unused using directive

---
 osu.Game/Screens/Edit/Timing/TimingScreen.cs | 1 -
 1 file changed, 1 deletion(-)

diff --git a/osu.Game/Screens/Edit/Timing/TimingScreen.cs b/osu.Game/Screens/Edit/Timing/TimingScreen.cs
index d7ca306037..d104cc4b5c 100644
--- a/osu.Game/Screens/Edit/Timing/TimingScreen.cs
+++ b/osu.Game/Screens/Edit/Timing/TimingScreen.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.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;

From 801e11d8418b49018d9174629d413e14bd7b36ff Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 1 Jun 2022 20:25:56 +0200
Subject: [PATCH 5180/5547] Apply performance regression fix to effect section
 too

---
 osu.Game/Screens/Edit/Timing/EffectSection.cs | 25 +++++++++++++++----
 1 file changed, 20 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Screens/Edit/Timing/EffectSection.cs b/osu.Game/Screens/Edit/Timing/EffectSection.cs
index c8944d0357..c9f73411f1 100644
--- a/osu.Game/Screens/Edit/Timing/EffectSection.cs
+++ b/osu.Game/Screens/Edit/Timing/EffectSection.cs
@@ -31,18 +31,33 @@ namespace osu.Game.Screens.Edit.Timing
             });
         }
 
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            kiai.Current.BindValueChanged(_ => saveChanges());
+            omitBarLine.Current.BindValueChanged(_ => saveChanges());
+            scrollSpeedSlider.Current.BindValueChanged(_ => saveChanges());
+
+            void saveChanges()
+            {
+                if (!isRebinding) ChangeHandler?.SaveState();
+            }
+        }
+
+        private bool isRebinding;
+
         protected override void OnControlPointChanged(ValueChangedEvent<EffectControlPoint> point)
         {
             if (point.NewValue != null)
             {
+                isRebinding = true;
+
                 kiai.Current = point.NewValue.KiaiModeBindable;
-                kiai.Current.BindValueChanged(_ => ChangeHandler?.SaveState());
-
                 omitBarLine.Current = point.NewValue.OmitFirstBarLineBindable;
-                omitBarLine.Current.BindValueChanged(_ => ChangeHandler?.SaveState());
-
                 scrollSpeedSlider.Current = point.NewValue.ScrollSpeedBindable;
-                scrollSpeedSlider.Current.BindValueChanged(_ => ChangeHandler?.SaveState());
+
+                isRebinding = false;
             }
         }
 

From e551e486977bef815098a9047a4b89529a7267df Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 2 Jun 2022 11:01:46 +0900
Subject: [PATCH 5181/5547] Use ScoreInfo overload in more places

---
 osu.Game/Rulesets/Scoring/ScoreProcessor.cs | 8 +++-----
 1 file changed, 3 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Rulesets/Scoring/ScoreProcessor.cs b/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
index 26a32ab1a0..853f43ddb6 100644
--- a/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
+++ b/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
@@ -273,8 +273,7 @@ namespace osu.Game.Rulesets.Scoring
             if (!ruleset.RulesetInfo.Equals(scoreInfo.Ruleset))
                 throw new ArgumentException($"Unexpected score ruleset. Expected \"{ruleset.RulesetInfo.ShortName}\" but was \"{scoreInfo.Ruleset.ShortName}\".");
 
-            extractScoringValues(scoreInfo.Statistics, out var current, out var maximum);
-            current.MaxCombo = scoreInfo.MaxCombo;
+            ExtractScoringValues(scoreInfo, out var current, out var maximum);
 
             return ComputeScore(mode, current, maximum);
         }
@@ -297,8 +296,7 @@ namespace osu.Game.Rulesets.Scoring
             if (!beatmapApplied)
                 throw new InvalidOperationException($"Cannot compute partial score without calling {nameof(ApplyBeatmap)}.");
 
-            extractScoringValues(scoreInfo.Statistics, out var current, out _);
-            current.MaxCombo = scoreInfo.MaxCombo;
+            ExtractScoringValues(scoreInfo, out var current, out _);
 
             return ComputeScore(mode, current, MaximumScoringValues);
         }
@@ -323,7 +321,7 @@ namespace osu.Game.Rulesets.Scoring
             double accuracyRatio = scoreInfo.Accuracy;
             double comboRatio = maxAchievableCombo > 0 ? (double)scoreInfo.MaxCombo / maxAchievableCombo : 1;
 
-            extractScoringValues(scoreInfo.Statistics, out var current, out var maximum);
+            ExtractScoringValues(scoreInfo, out var current, out var maximum);
 
             // For legacy osu!mania scores, a full-GREAT score has 100% accuracy. If combined with a full-combo, the score becomes indistinguishable from a full-PERFECT score.
             // To get around this, the accuracy ratio is always recalculated based on the hit statistics rather than trusting the score.

From d12f6ea2213da50789f48c9cf3f0e65a55e1ae93 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 1 Jun 2022 18:53:35 +0900
Subject: [PATCH 5182/5547] Add basics of tap button

---
 .../Visual/Editing/TestSceneTapButton.cs      |  48 +++++++
 osu.Game/Screens/Edit/Timing/TapButton.cs     | 122 ++++++++++++++++++
 .../Screens/Edit/Timing/TapTimingControl.cs   |   9 ++
 3 files changed, 179 insertions(+)
 create mode 100644 osu.Game.Tests/Visual/Editing/TestSceneTapButton.cs
 create mode 100644 osu.Game/Screens/Edit/Timing/TapButton.cs

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneTapButton.cs b/osu.Game.Tests/Visual/Editing/TestSceneTapButton.cs
new file mode 100644
index 0000000000..d8141619ab
--- /dev/null
+++ b/osu.Game.Tests/Visual/Editing/TestSceneTapButton.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 NUnit.Framework;
+using osu.Framework.Allocation;
+using osu.Framework.Graphics;
+using osu.Game.Overlays;
+using osu.Game.Screens.Edit.Timing;
+using osuTK;
+using osuTK.Input;
+
+namespace osu.Game.Tests.Visual.Editing
+{
+    public class TestSceneTapButton : OsuManualInputManagerTestScene
+    {
+        private TapButton tapButton;
+
+        [Cached]
+        private readonly OverlayColourProvider overlayColour = new OverlayColourProvider(OverlayColourScheme.Aquamarine);
+
+        [Test]
+        public void TestBasic()
+        {
+            AddStep("create button", () =>
+            {
+                Child = tapButton = new TapButton
+                {
+                    Anchor = Anchor.Centre,
+                    Origin = Anchor.Centre,
+                    Scale = new Vector2(4),
+                };
+            });
+
+            bool pressed = false;
+
+            AddRepeatStep("Press button", () =>
+            {
+                InputManager.MoveMouseTo(tapButton);
+                if (!pressed)
+                    InputManager.PressButton(MouseButton.Left);
+                else
+                    InputManager.ReleaseButton(MouseButton.Left);
+
+                pressed = !pressed;
+            }, 100);
+        }
+    }
+}
diff --git a/osu.Game/Screens/Edit/Timing/TapButton.cs b/osu.Game/Screens/Edit/Timing/TapButton.cs
new file mode 100644
index 0000000000..59ec966fe0
--- /dev/null
+++ b/osu.Game/Screens/Edit/Timing/TapButton.cs
@@ -0,0 +1,122 @@
+// 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.Extensions.Color4Extensions;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.Shapes;
+using osu.Framework.Input.Events;
+using osu.Game.Overlays;
+using osuTK;
+using osuTK.Graphics;
+
+namespace osu.Game.Screens.Edit.Timing
+{
+    internal class TapButton : CircularContainer
+    {
+        public const float SIZE = 100;
+
+        [Resolved]
+        private OverlayColourProvider colourProvider { get; set; }
+
+        private Circle hoverLayer;
+        private CircularContainer innerCircle;
+        private Circle outerCircle;
+
+        private Container scaleContainer;
+
+        [BackgroundDependencyLoader]
+        private void load()
+        {
+            Size = new Vector2(SIZE);
+
+            const float ring_width = 20;
+            const float light_padding = 3;
+
+            InternalChild = scaleContainer = new Container
+            {
+                Anchor = Anchor.Centre,
+                Origin = Anchor.Centre,
+                RelativeSizeAxes = Axes.Both,
+                Children = new Drawable[]
+                {
+                    outerCircle = new Circle
+                    {
+                        RelativeSizeAxes = Axes.Both,
+                        Colour = colourProvider.Background3
+                    },
+                    new CircularContainer
+                    {
+                        RelativeSizeAxes = Axes.Both,
+                        Name = "outer masking",
+                        Masking = true,
+                        BorderThickness = light_padding,
+                        BorderColour = colourProvider.Background3,
+                        Children = new Drawable[]
+                        {
+                            new Box
+                            {
+                                Colour = Color4.Black,
+                                RelativeSizeAxes = Axes.Both,
+                                Alpha = 0,
+                                AlwaysPresent = true,
+                            },
+                        }
+                    },
+                    innerCircle = new CircularContainer
+                    {
+                        Size = new Vector2(SIZE - ring_width + light_padding),
+                        Anchor = Anchor.Centre,
+                        Origin = Anchor.Centre,
+                        Masking = true,
+                        BorderThickness = light_padding,
+                        BorderColour = colourProvider.Background3,
+                        Children = new Drawable[]
+                        {
+                            new Box
+                            {
+                                Colour = colourProvider.Background2,
+                                RelativeSizeAxes = Axes.Both,
+                                AlwaysPresent = true,
+                            },
+                        }
+                    },
+                    hoverLayer = new Circle
+                    {
+                        RelativeSizeAxes = Axes.Both,
+                        Colour = Color4.White.Opacity(0.01f),
+                        Blending = BlendingParameters.Additive,
+                        Alpha = 0,
+                    },
+                }
+            };
+        }
+
+        protected override bool OnHover(HoverEvent e)
+        {
+            hoverLayer.FadeIn(500, Easing.OutQuint);
+            return base.OnHover(e);
+        }
+
+        protected override void OnHoverLost(HoverLostEvent e)
+        {
+            hoverLayer.FadeOut(500, Easing.OutQuint);
+            base.OnHoverLost(e);
+        }
+
+        protected override bool OnMouseDown(MouseDownEvent e)
+        {
+            scaleContainer.ScaleTo(0.98f, 200, Easing.OutQuint);
+            innerCircle.ScaleTo(0.95f, 200, Easing.OutQuint);
+            return base.OnMouseDown(e);
+        }
+
+        protected override void OnMouseUp(MouseUpEvent e)
+        {
+            scaleContainer.ScaleTo(1, 1200, Easing.OutQuint);
+            innerCircle.ScaleTo(1, 1200, Easing.OutQuint);
+            base.OnMouseUp(e);
+        }
+    }
+}
diff --git a/osu.Game/Screens/Edit/Timing/TapTimingControl.cs b/osu.Game/Screens/Edit/Timing/TapTimingControl.cs
index 990f8d2ce0..20d6c656ff 100644
--- a/osu.Game/Screens/Edit/Timing/TapTimingControl.cs
+++ b/osu.Game/Screens/Edit/Timing/TapTimingControl.cs
@@ -50,6 +50,7 @@ namespace osu.Game.Screens.Edit.Timing
                         new Dimension(GridSizeMode.Absolute, 200),
                         new Dimension(GridSizeMode.Absolute, 60),
                         new Dimension(GridSizeMode.Absolute, 60),
+                        new Dimension(GridSizeMode.Absolute, 120),
                     },
                     Content = new[]
                     {
@@ -141,6 +142,14 @@ namespace osu.Game.Screens.Edit.Timing
                                     }
                                 }
                             },
+                        },
+                        new Drawable[]
+                        {
+                            new TapButton
+                            {
+                                Anchor = Anchor.Centre,
+                                Origin = Anchor.Centre,
+                            }
                         }
                     }
                 },

From c3ba7b2c3beef436f9a03b4210ff3181e9d79a4d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 1 Jun 2022 19:45:11 +0900
Subject: [PATCH 5183/5547] Add lights

---
 osu.Game/Screens/Edit/Timing/TapButton.cs | 150 +++++++++++++++++++---
 1 file changed, 132 insertions(+), 18 deletions(-)

diff --git a/osu.Game/Screens/Edit/Timing/TapButton.cs b/osu.Game/Screens/Edit/Timing/TapButton.cs
index 59ec966fe0..3eb8e23bad 100644
--- a/osu.Game/Screens/Edit/Timing/TapButton.cs
+++ b/osu.Game/Screens/Edit/Timing/TapButton.cs
@@ -6,7 +6,10 @@ using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
+using osu.Framework.Graphics.UserInterface;
 using osu.Framework.Input.Events;
+using osu.Game.Graphics;
+using osu.Game.Graphics.Sprites;
 using osu.Game.Overlays;
 using osuTK;
 using osuTK.Graphics;
@@ -21,17 +24,23 @@ namespace osu.Game.Screens.Edit.Timing
         private OverlayColourProvider colourProvider { get; set; }
 
         private Circle hoverLayer;
+
         private CircularContainer innerCircle;
-        private Circle outerCircle;
+        private Box innerCircleHighlight;
+
+        private int currentLight;
 
         private Container scaleContainer;
+        private Container lights;
+
+        private const int light_count = 6;
 
         [BackgroundDependencyLoader]
         private void load()
         {
             Size = new Vector2(SIZE);
 
-            const float ring_width = 20;
+            const float ring_width = 18;
             const float light_padding = 3;
 
             InternalChild = scaleContainer = new Container
@@ -41,11 +50,15 @@ namespace osu.Game.Screens.Edit.Timing
                 RelativeSizeAxes = Axes.Both,
                 Children = new Drawable[]
                 {
-                    outerCircle = new Circle
+                    new Circle
                     {
                         RelativeSizeAxes = Axes.Both,
                         Colour = colourProvider.Background3
                     },
+                    lights = new Container
+                    {
+                        RelativeSizeAxes = Axes.Both,
+                    },
                     new CircularContainer
                     {
                         RelativeSizeAxes = Axes.Both,
@@ -64,35 +77,65 @@ namespace osu.Game.Screens.Edit.Timing
                             },
                         }
                     },
+                    new Circle
+                    {
+                        Size = new Vector2(SIZE - ring_width * 2 + light_padding * 2),
+                        Anchor = Anchor.Centre,
+                        Origin = Anchor.Centre,
+                        Colour = colourProvider.Background3,
+                    },
                     innerCircle = new CircularContainer
                     {
-                        Size = new Vector2(SIZE - ring_width + light_padding),
+                        Size = new Vector2(SIZE - ring_width * 2),
                         Anchor = Anchor.Centre,
                         Origin = Anchor.Centre,
                         Masking = true,
-                        BorderThickness = light_padding,
-                        BorderColour = colourProvider.Background3,
                         Children = new Drawable[]
                         {
                             new Box
                             {
                                 Colour = colourProvider.Background2,
                                 RelativeSizeAxes = Axes.Both,
-                                AlwaysPresent = true,
+                            },
+                            innerCircleHighlight = new Box
+                            {
+                                Colour = colourProvider.Colour3,
+                                Blending = BlendingParameters.Additive,
+                                RelativeSizeAxes = Axes.Both,
+                                Alpha = 0,
+                            },
+                            new OsuSpriteText
+                            {
+                                Font = OsuFont.Torus.With(size: 20),
+                                Colour = colourProvider.Background1,
+                                Anchor = Anchor.Centre,
+                                Origin = Anchor.Centre,
+                                Text = "Tap!"
+                            },
+                            hoverLayer = new Circle
+                            {
+                                RelativeSizeAxes = Axes.Both,
+                                Colour = colourProvider.Background1.Opacity(0.3f),
+                                Blending = BlendingParameters.Additive,
+                                Alpha = 0,
                             },
                         }
                     },
-                    hoverLayer = new Circle
-                    {
-                        RelativeSizeAxes = Axes.Both,
-                        Colour = Color4.White.Opacity(0.01f),
-                        Blending = BlendingParameters.Additive,
-                        Alpha = 0,
-                    },
                 }
             };
+
+            for (int i = 0; i < light_count; i++)
+            {
+                lights.Add(new Light
+                {
+                    Rotation = i * (360f / light_count)
+                });
+            }
         }
 
+        public override bool ReceivePositionalInputAt(Vector2 screenSpacePos) =>
+            hoverLayer.ReceivePositionalInputAt(screenSpacePos);
+
         protected override bool OnHover(HoverEvent e)
         {
             hoverLayer.FadeIn(500, Easing.OutQuint);
@@ -107,16 +150,87 @@ namespace osu.Game.Screens.Edit.Timing
 
         protected override bool OnMouseDown(MouseDownEvent e)
         {
-            scaleContainer.ScaleTo(0.98f, 200, Easing.OutQuint);
-            innerCircle.ScaleTo(0.95f, 200, Easing.OutQuint);
+            const double in_duration = 100;
+
+            scaleContainer.ScaleTo(0.99f, in_duration, Easing.OutQuint);
+            innerCircle.ScaleTo(0.96f, in_duration, Easing.OutQuint);
+
+            innerCircleHighlight
+                .FadeIn(50, Easing.OutQuint)
+                .FlashColour(Color4.White, 1000, Easing.OutQuint);
+
+            lights[currentLight % light_count].Hide();
+            lights[(currentLight + light_count / 2) % light_count].Hide();
+
+            currentLight++;
+
+            lights[currentLight % light_count].Show();
+            lights[(currentLight + light_count / 2) % light_count].Show();
+
             return base.OnMouseDown(e);
         }
 
         protected override void OnMouseUp(MouseUpEvent e)
         {
-            scaleContainer.ScaleTo(1, 1200, Easing.OutQuint);
-            innerCircle.ScaleTo(1, 1200, Easing.OutQuint);
+            const double out_duration = 800;
+
+            scaleContainer.ScaleTo(1, out_duration, Easing.OutQuint);
+            innerCircle.ScaleTo(1, out_duration, Easing.OutQuint);
+            innerCircleHighlight.FadeOut(out_duration, Easing.OutQuint);
             base.OnMouseUp(e);
         }
+
+        private class Light : CompositeDrawable
+        {
+            private CircularProgress fill;
+
+            [Resolved]
+            private OverlayColourProvider colourProvider { get; set; }
+
+            [BackgroundDependencyLoader]
+            private void load()
+            {
+                RelativeSizeAxes = Axes.Both;
+                Anchor = Anchor.Centre;
+                Origin = Anchor.Centre;
+
+                InternalChildren = new Drawable[]
+                {
+                    new CircularProgress
+                    {
+                        RelativeSizeAxes = Axes.Both,
+                        Anchor = Anchor.Centre,
+                        Origin = Anchor.Centre,
+                        Size = new Vector2(0.99f),
+                        Current = { Value = 1f / light_count - 0.01f },
+                        Colour = colourProvider.Background2,
+                    },
+                    fill = new CircularProgress
+                    {
+                        RelativeSizeAxes = Axes.Both,
+                        Anchor = Anchor.Centre,
+                        Origin = Anchor.Centre,
+                        Alpha = 0,
+                        Size = new Vector2(0.99f),
+                        Current = { Value = 1f / light_count - 0.01f },
+                        Colour = colourProvider.Colour1,
+                        Blending = BlendingParameters.Additive
+                    },
+                };
+            }
+
+            public override void Show()
+            {
+                fill
+                    .FadeIn(50, Easing.OutQuint)
+                    .FlashColour(Color4.White, 1000, Easing.OutQuint);
+            }
+
+            public override void Hide()
+            {
+                fill
+                    .FadeOut(300, Easing.OutQuint);
+            }
+        }
     }
 }

From 3c7a04256fda8041f4e8e5b51a4a2ba8050cb345 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 1 Jun 2022 20:04:44 +0900
Subject: [PATCH 5184/5547] Add glow

---
 osu.Game/Screens/Edit/Timing/TapButton.cs | 62 +++++++++++++++++------
 1 file changed, 47 insertions(+), 15 deletions(-)

diff --git a/osu.Game/Screens/Edit/Timing/TapButton.cs b/osu.Game/Screens/Edit/Timing/TapButton.cs
index 3eb8e23bad..f7a5a0ca7b 100644
--- a/osu.Game/Screens/Edit/Timing/TapButton.cs
+++ b/osu.Game/Screens/Edit/Timing/TapButton.cs
@@ -5,6 +5,7 @@ using osu.Framework.Allocation;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.Effects;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Graphics.UserInterface;
 using osu.Framework.Input.Events;
@@ -32,6 +33,8 @@ namespace osu.Game.Screens.Edit.Timing
 
         private Container scaleContainer;
         private Container lights;
+        private Container lightsGlow;
+        private OsuSpriteText text;
 
         private const int light_count = 6;
 
@@ -79,11 +82,16 @@ namespace osu.Game.Screens.Edit.Timing
                     },
                     new Circle
                     {
+                        Name = "inner masking",
                         Size = new Vector2(SIZE - ring_width * 2 + light_padding * 2),
                         Anchor = Anchor.Centre,
                         Origin = Anchor.Centre,
                         Colour = colourProvider.Background3,
                     },
+                    lightsGlow = new Container
+                    {
+                        RelativeSizeAxes = Axes.Both,
+                    },
                     innerCircle = new CircularContainer
                     {
                         Size = new Vector2(SIZE - ring_width * 2),
@@ -104,7 +112,7 @@ namespace osu.Game.Screens.Edit.Timing
                                 RelativeSizeAxes = Axes.Both,
                                 Alpha = 0,
                             },
-                            new OsuSpriteText
+                            text = new OsuSpriteText
                             {
                                 Font = OsuFont.Torus.With(size: 20),
                                 Colour = colourProvider.Background1,
@@ -126,10 +134,13 @@ namespace osu.Game.Screens.Edit.Timing
 
             for (int i = 0; i < light_count; i++)
             {
-                lights.Add(new Light
+                var light = new Light
                 {
                     Rotation = i * (360f / light_count)
-                });
+                };
+
+                lights.Add(light);
+                lightsGlow.Add(light.Glow.CreateProxy());
             }
         }
 
@@ -152,6 +163,8 @@ namespace osu.Game.Screens.Edit.Timing
         {
             const double in_duration = 100;
 
+            text.FadeColour(colourProvider.Background4, in_duration, Easing.OutQuint);
+
             scaleContainer.ScaleTo(0.99f, in_duration, Easing.OutQuint);
             innerCircle.ScaleTo(0.96f, in_duration, Easing.OutQuint);
 
@@ -174,6 +187,8 @@ namespace osu.Game.Screens.Edit.Timing
         {
             const double out_duration = 800;
 
+            text.FadeColour(colourProvider.Background1, out_duration, Easing.OutQuint);
+
             scaleContainer.ScaleTo(1, out_duration, Easing.OutQuint);
             innerCircle.ScaleTo(1, out_duration, Easing.OutQuint);
             innerCircleHighlight.FadeOut(out_duration, Easing.OutQuint);
@@ -182,7 +197,9 @@ namespace osu.Game.Screens.Edit.Timing
 
         private class Light : CompositeDrawable
         {
-            private CircularProgress fill;
+            public Drawable Glow { get; private set; }
+
+            private Container fillContent;
 
             [Resolved]
             private OverlayColourProvider colourProvider { get; set; }
@@ -194,41 +211,56 @@ namespace osu.Game.Screens.Edit.Timing
                 Anchor = Anchor.Centre;
                 Origin = Anchor.Centre;
 
+                Size = new Vector2(0.98f); // Avoid bleed into masking edge.
+
                 InternalChildren = new Drawable[]
                 {
                     new CircularProgress
                     {
                         RelativeSizeAxes = Axes.Both,
-                        Anchor = Anchor.Centre,
-                        Origin = Anchor.Centre,
-                        Size = new Vector2(0.99f),
                         Current = { Value = 1f / light_count - 0.01f },
                         Colour = colourProvider.Background2,
                     },
-                    fill = new CircularProgress
+                    fillContent = new Container
                     {
                         RelativeSizeAxes = Axes.Both,
-                        Anchor = Anchor.Centre,
-                        Origin = Anchor.Centre,
                         Alpha = 0,
-                        Size = new Vector2(0.99f),
-                        Current = { Value = 1f / light_count - 0.01f },
                         Colour = colourProvider.Colour1,
-                        Blending = BlendingParameters.Additive
+                        Children = new[]
+                        {
+                            new CircularProgress
+                            {
+                                RelativeSizeAxes = Axes.Both,
+                                Current = { Value = 1f / light_count - 0.01f },
+                                Blending = BlendingParameters.Additive
+                            },
+                            Glow = new CircularProgress
+                            {
+                                RelativeSizeAxes = Axes.Both,
+                                Current = { Value = 1f / light_count - 0.01f },
+                                Blending = BlendingParameters.Additive
+                            }.WithEffect(new GlowEffect
+                            {
+                                Colour = colourProvider.Colour1.Opacity(0.4f),
+                                BlurSigma = new Vector2(9f),
+                                Strength = 10,
+                                PadExtent = true
+                            }),
+                        }
                     },
                 };
             }
 
             public override void Show()
             {
-                fill
+                fillContent
                     .FadeIn(50, Easing.OutQuint)
                     .FlashColour(Color4.White, 1000, Easing.OutQuint);
             }
 
             public override void Hide()
             {
-                fill
+                fillContent
                     .FadeOut(300, Easing.OutQuint);
             }
         }

From a2d177d7d258cba760086a59a413584367ff7efd Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 1 Jun 2022 20:37:02 +0900
Subject: [PATCH 5185/5547] Add BPM display and tracking

---
 osu.Game/Screens/Edit/Timing/TapButton.cs | 109 +++++++++++++++++++---
 1 file changed, 98 insertions(+), 11 deletions(-)

diff --git a/osu.Game/Screens/Edit/Timing/TapButton.cs b/osu.Game/Screens/Edit/Timing/TapButton.cs
index f7a5a0ca7b..9c6dde4ffe 100644
--- a/osu.Game/Screens/Edit/Timing/TapButton.cs
+++ b/osu.Game/Screens/Edit/Timing/TapButton.cs
@@ -1,14 +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 System;
+using System.Collections.Generic;
+using System.Linq;
 using osu.Framework.Allocation;
 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;
 using osu.Framework.Graphics.UserInterface;
 using osu.Framework.Input.Events;
+using osu.Framework.Threading;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Overlays;
@@ -34,7 +39,12 @@ namespace osu.Game.Screens.Edit.Timing
         private Container scaleContainer;
         private Container lights;
         private Container lightsGlow;
-        private OsuSpriteText text;
+        private OsuSpriteText bpmText;
+        private Container textContainer;
+
+        private bool grabbedMouseDown;
+
+        private ScheduledDelegate resetDelegate;
 
         private const int light_count = 6;
 
@@ -65,7 +75,7 @@ namespace osu.Game.Screens.Edit.Timing
                     new CircularContainer
                     {
                         RelativeSizeAxes = Axes.Both,
-                        Name = "outer masking",
+                        Name = @"outer masking",
                         Masking = true,
                         BorderThickness = light_padding,
                         BorderColour = colourProvider.Background3,
@@ -82,7 +92,7 @@ namespace osu.Game.Screens.Edit.Timing
                     },
                     new Circle
                     {
-                        Name = "inner masking",
+                        Name = @"inner masking",
                         Size = new Vector2(SIZE - ring_width * 2 + light_padding * 2),
                         Anchor = Anchor.Centre,
                         Origin = Anchor.Centre,
@@ -112,13 +122,27 @@ namespace osu.Game.Screens.Edit.Timing
                                 RelativeSizeAxes = Axes.Both,
                                 Alpha = 0,
                             },
-                            text = new OsuSpriteText
+                            textContainer = new Container
                             {
-                                Font = OsuFont.Torus.With(size: 20),
+                                RelativeSizeAxes = Axes.Both,
                                 Colour = colourProvider.Background1,
-                                Anchor = Anchor.Centre,
-                                Origin = Anchor.Centre,
-                                Text = "Tap!"
+                                Children = new Drawable[]
+                                {
+                                    new OsuSpriteText
+                                    {
+                                        Font = OsuFont.Torus.With(size: 20),
+                                        Anchor = Anchor.Centre,
+                                        Origin = Anchor.BottomCentre,
+                                        Y = 3,
+                                        Text = "Tap"
+                                    },
+                                    bpmText = new OsuSpriteText
+                                    {
+                                        Font = OsuFont.Torus.With(size: 14),
+                                        Anchor = Anchor.Centre,
+                                        Origin = Anchor.TopCentre,
+                                    },
+                                }
                             },
                             hoverLayer = new Circle
                             {
@@ -142,20 +166,38 @@ namespace osu.Game.Screens.Edit.Timing
                 lights.Add(light);
                 lightsGlow.Add(light.Glow.CreateProxy());
             }
+
+            reset();
         }
 
         public override bool ReceivePositionalInputAt(Vector2 screenSpacePos) =>
             hoverLayer.ReceivePositionalInputAt(screenSpacePos);
 
+        private ColourInfo textColour
+        {
+            get
+            {
+                if (grabbedMouseDown)
+                    return colourProvider.Background4;
+
+                if (IsHovered)
+                    return colourProvider.Content2;
+
+                return colourProvider.Background1;
+            }
+        }
+
         protected override bool OnHover(HoverEvent e)
         {
             hoverLayer.FadeIn(500, Easing.OutQuint);
+            textContainer.FadeColour(textColour, 500, Easing.OutQuint);
             return base.OnHover(e);
         }
 
         protected override void OnHoverLost(HoverLostEvent e)
         {
             hoverLayer.FadeOut(500, Easing.OutQuint);
+            textContainer.FadeColour(textColour, 500, Easing.OutQuint);
             base.OnHoverLost(e);
         }
 
@@ -163,7 +205,14 @@ namespace osu.Game.Screens.Edit.Timing
         {
             const double in_duration = 100;
 
-            text.FadeColour(colourProvider.Background4, in_duration, Easing.OutQuint);
+            grabbedMouseDown = true;
+
+            handleTap();
+
+            resetDelegate?.Cancel();
+            resetDelegate = Scheduler.AddDelayed(reset, 1000);
+
+            textContainer.FadeColour(textColour, in_duration, Easing.OutQuint);
 
             scaleContainer.ScaleTo(0.99f, in_duration, Easing.OutQuint);
             innerCircle.ScaleTo(0.96f, in_duration, Easing.OutQuint);
@@ -180,14 +229,16 @@ namespace osu.Game.Screens.Edit.Timing
             lights[currentLight % light_count].Show();
             lights[(currentLight + light_count / 2) % light_count].Show();
 
-            return base.OnMouseDown(e);
+            return true;
         }
 
         protected override void OnMouseUp(MouseUpEvent e)
         {
             const double out_duration = 800;
 
-            text.FadeColour(colourProvider.Background1, out_duration, Easing.OutQuint);
+            grabbedMouseDown = false;
+
+            textContainer.FadeColour(textColour, out_duration, Easing.OutQuint);
 
             scaleContainer.ScaleTo(1, out_duration, Easing.OutQuint);
             innerCircle.ScaleTo(1, out_duration, Easing.OutQuint);
@@ -195,6 +246,42 @@ namespace osu.Game.Screens.Edit.Timing
             base.OnMouseUp(e);
         }
 
+        private readonly List<double> tapTimings = new List<double>();
+
+        private void reset()
+        {
+            bpmText.FadeOut(500, Easing.OutQuint);
+
+            using (BeginDelayedSequence(tapTimings.Count > 0 ? 500 : 0))
+            {
+                Schedule(() => bpmText.Text = "the beat!");
+                bpmText.FadeIn(800, Easing.OutQuint);
+            }
+
+            foreach (var light in lights)
+                light.Hide();
+
+            tapTimings.Clear();
+        }
+
+        private void handleTap()
+        {
+            tapTimings.Add(Clock.CurrentTime);
+
+            if (tapTimings.Count > 8)
+                tapTimings.RemoveAt(0);
+
+            if (tapTimings.Count < 5)
+            {
+                bpmText.Text = new string('.', tapTimings.Count);
+                return;
+            }
+
+            double bpm = Math.Round(60000 / ((tapTimings.Last() - tapTimings.First()) / (tapTimings.Count - 1)));
+
+            bpmText.Text = $"{bpm} BPM";
+        }
+
         private class Light : CompositeDrawable
         {
             public Drawable Glow { get; private set; }

From d47a3bb8e4948aefff1d8d07e965eac729455cf6 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 1 Jun 2022 20:44:05 +0900
Subject: [PATCH 5186/5547] Use NRT and transfer BPM

---
 osu.Game/Screens/Edit/Timing/TapButton.cs | 41 ++++++++++++++++-------
 1 file changed, 28 insertions(+), 13 deletions(-)

diff --git a/osu.Game/Screens/Edit/Timing/TapButton.cs b/osu.Game/Screens/Edit/Timing/TapButton.cs
index 9c6dde4ffe..d85edb6cce 100644
--- a/osu.Game/Screens/Edit/Timing/TapButton.cs
+++ b/osu.Game/Screens/Edit/Timing/TapButton.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.
 
+#nullable enable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
 using osu.Framework.Allocation;
+using osu.Framework.Bindables;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Colour;
@@ -14,6 +17,7 @@ using osu.Framework.Graphics.Shapes;
 using osu.Framework.Graphics.UserInterface;
 using osu.Framework.Input.Events;
 using osu.Framework.Threading;
+using osu.Game.Beatmaps.ControlPoints;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Overlays;
@@ -27,24 +31,27 @@ namespace osu.Game.Screens.Edit.Timing
         public const float SIZE = 100;
 
         [Resolved]
-        private OverlayColourProvider colourProvider { get; set; }
+        private OverlayColourProvider colourProvider { get; set; } = null!;
 
-        private Circle hoverLayer;
+        [Resolved(canBeNull: true)]
+        private Bindable<ControlPointGroup>? selectedGroup { get; set; }
 
-        private CircularContainer innerCircle;
-        private Box innerCircleHighlight;
+        private Circle hoverLayer = null!;
+
+        private CircularContainer innerCircle = null!;
+        private Box innerCircleHighlight = null!;
 
         private int currentLight;
 
-        private Container scaleContainer;
-        private Container lights;
-        private Container lightsGlow;
-        private OsuSpriteText bpmText;
-        private Container textContainer;
+        private Container scaleContainer = null!;
+        private Container lights = null!;
+        private Container lightsGlow = null!;
+        private OsuSpriteText bpmText = null!;
+        private Container textContainer = null!;
 
         private bool grabbedMouseDown;
 
-        private ScheduledDelegate resetDelegate;
+        private ScheduledDelegate? resetDelegate;
 
         private const int light_count = 6;
 
@@ -280,16 +287,24 @@ namespace osu.Game.Screens.Edit.Timing
             double bpm = Math.Round(60000 / ((tapTimings.Last() - tapTimings.First()) / (tapTimings.Count - 1)));
 
             bpmText.Text = $"{bpm} BPM";
+
+            var timingPoint = selectedGroup?.Value.ControlPoints.OfType<TimingControlPoint>().FirstOrDefault();
+
+            if (timingPoint != null)
+            {
+                // Intentionally use the rounded BPM here.
+                timingPoint.BeatLength = 60000 / bpm;
+            }
         }
 
         private class Light : CompositeDrawable
         {
-            public Drawable Glow { get; private set; }
+            public Drawable Glow { get; private set; } = null!;
 
-            private Container fillContent;
+            private Container fillContent = null!;
 
             [Resolved]
-            private OverlayColourProvider colourProvider { get; set; }
+            private OverlayColourProvider colourProvider { get; set; } = null!;
 
             [BackgroundDependencyLoader]
             private void load()

From 96ccd29bdc9d2372abdca8fe1a8ba284e87ceb3c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 1 Jun 2022 20:48:06 +0900
Subject: [PATCH 5187/5547] Don't play metronome click when tapping for timing

---
 osu.Game/Screens/Edit/Timing/MetronomeDisplay.cs |  5 +++++
 osu.Game/Screens/Edit/Timing/TapButton.cs        |  4 ++++
 osu.Game/Screens/Edit/Timing/TapTimingControl.cs | 12 +++++++++++-
 3 files changed, 20 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Edit/Timing/MetronomeDisplay.cs b/osu.Game/Screens/Edit/Timing/MetronomeDisplay.cs
index 4143c5ea55..2ecd66a05f 100644
--- a/osu.Game/Screens/Edit/Timing/MetronomeDisplay.cs
+++ b/osu.Game/Screens/Edit/Timing/MetronomeDisplay.cs
@@ -38,6 +38,8 @@ namespace osu.Game.Screens.Edit.Timing
         [Resolved]
         private OverlayColourProvider overlayColourProvider { get; set; }
 
+        public bool EnableClicking { get; set; } = true;
+
         [BackgroundDependencyLoader]
         private void load(AudioManager audio)
         {
@@ -281,6 +283,9 @@ namespace osu.Game.Screens.Edit.Timing
 
                     Schedule(() =>
                     {
+                        if (!EnableClicking)
+                            return;
+
                         var channel = clunk?.GetChannel();
 
                         if (channel != null)
diff --git a/osu.Game/Screens/Edit/Timing/TapButton.cs b/osu.Game/Screens/Edit/Timing/TapButton.cs
index d85edb6cce..fb5580c6ac 100644
--- a/osu.Game/Screens/Edit/Timing/TapButton.cs
+++ b/osu.Game/Screens/Edit/Timing/TapButton.cs
@@ -30,6 +30,8 @@ namespace osu.Game.Screens.Edit.Timing
     {
         public const float SIZE = 100;
 
+        public readonly BindableBool IsHandlingTapping = new BindableBool();
+
         [Resolved]
         private OverlayColourProvider colourProvider { get; set; } = null!;
 
@@ -213,6 +215,7 @@ namespace osu.Game.Screens.Edit.Timing
             const double in_duration = 100;
 
             grabbedMouseDown = true;
+            IsHandlingTapping.Value = true;
 
             handleTap();
 
@@ -269,6 +272,7 @@ namespace osu.Game.Screens.Edit.Timing
                 light.Hide();
 
             tapTimings.Clear();
+            IsHandlingTapping.Value = false;
         }
 
         private void handleTap()
diff --git a/osu.Game/Screens/Edit/Timing/TapTimingControl.cs b/osu.Game/Screens/Edit/Timing/TapTimingControl.cs
index 20d6c656ff..16e9f703c8 100644
--- a/osu.Game/Screens/Edit/Timing/TapTimingControl.cs
+++ b/osu.Game/Screens/Edit/Timing/TapTimingControl.cs
@@ -25,6 +25,10 @@ namespace osu.Game.Screens.Edit.Timing
         [Resolved]
         private Bindable<ControlPointGroup> selectedGroup { get; set; }
 
+        private readonly BindableBool isHandlingTapping = new BindableBool();
+
+        private MetronomeDisplay metronome;
+
         [BackgroundDependencyLoader]
         private void load(OverlayColourProvider colourProvider, OsuColour colours)
         {
@@ -73,7 +77,7 @@ namespace osu.Game.Screens.Edit.Timing
                                         {
                                             new Drawable[]
                                             {
-                                                new MetronomeDisplay
+                                                metronome = new MetronomeDisplay
                                                 {
                                                     Anchor = Anchor.CentreLeft,
                                                     Origin = Anchor.CentreLeft,
@@ -149,11 +153,17 @@ namespace osu.Game.Screens.Edit.Timing
                             {
                                 Anchor = Anchor.Centre,
                                 Origin = Anchor.Centre,
+                                IsHandlingTapping = { BindTarget = isHandlingTapping }
                             }
                         }
                     }
                 },
             };
+
+            isHandlingTapping.BindValueChanged(handling =>
+            {
+                metronome.EnableClicking = !handling.NewValue;
+            }, true);
         }
 
         private void adjustOffset(double adjust)

From b88bce9b8baf47dc54b27e041d9a51c41e672dfc Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 1 Jun 2022 20:57:16 +0900
Subject: [PATCH 5188/5547] Restart track playback when tapping to time

---
 osu.Game/Screens/Edit/Timing/TapTimingControl.cs | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/osu.Game/Screens/Edit/Timing/TapTimingControl.cs b/osu.Game/Screens/Edit/Timing/TapTimingControl.cs
index 16e9f703c8..6640eeaa38 100644
--- a/osu.Game/Screens/Edit/Timing/TapTimingControl.cs
+++ b/osu.Game/Screens/Edit/Timing/TapTimingControl.cs
@@ -163,6 +163,12 @@ namespace osu.Game.Screens.Edit.Timing
             isHandlingTapping.BindValueChanged(handling =>
             {
                 metronome.EnableClicking = !handling.NewValue;
+
+                if (handling.NewValue)
+                {
+                    editorClock.Seek(selectedGroup.Value.Time);
+                    editorClock.Start();
+                }
             }, true);
         }
 

From f3f7e28353d340b916a2d4ba7735e21de3c51c16 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 1 Jun 2022 20:57:24 +0900
Subject: [PATCH 5189/5547] Ignore initial taps as they are generally
 inaccurate

---
 osu.Game/Screens/Edit/Timing/TapButton.cs | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Screens/Edit/Timing/TapButton.cs b/osu.Game/Screens/Edit/Timing/TapButton.cs
index fb5580c6ac..65f31f4396 100644
--- a/osu.Game/Screens/Edit/Timing/TapButton.cs
+++ b/osu.Game/Screens/Edit/Timing/TapButton.cs
@@ -275,20 +275,23 @@ namespace osu.Game.Screens.Edit.Timing
             IsHandlingTapping.Value = false;
         }
 
+        private const int initial_taps_to_ignore = 4;
+        private const int max_taps_to_consider = 8;
+
         private void handleTap()
         {
             tapTimings.Add(Clock.CurrentTime);
 
-            if (tapTimings.Count > 8)
+            if (tapTimings.Count > initial_taps_to_ignore + max_taps_to_consider)
                 tapTimings.RemoveAt(0);
 
-            if (tapTimings.Count < 5)
+            if (tapTimings.Count < initial_taps_to_ignore * 2)
             {
                 bpmText.Text = new string('.', tapTimings.Count);
                 return;
             }
 
-            double bpm = Math.Round(60000 / ((tapTimings.Last() - tapTimings.First()) / (tapTimings.Count - 1)));
+            double bpm = Math.Round(60000 / ((tapTimings.Last() - tapTimings.Skip(initial_taps_to_ignore).First()) / (tapTimings.Count - initial_taps_to_ignore - 1)));
 
             bpmText.Text = $"{bpm} BPM";
 

From d4e88441eceabfd2fce25cfb268836e896c5473d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 1 Jun 2022 22:00:34 +0900
Subject: [PATCH 5190/5547] Adjust metrics to make timing section fit better in
 editor

---
 osu.Game/Screens/Edit/Timing/GroupSection.cs       | 2 +-
 osu.Game/Screens/Edit/Timing/Section.cs            | 2 +-
 osu.Game/Screens/Edit/Timing/TimingAdjustButton.cs | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Screens/Edit/Timing/GroupSection.cs b/osu.Game/Screens/Edit/Timing/GroupSection.cs
index bb2dd35a9c..f613488aae 100644
--- a/osu.Game/Screens/Edit/Timing/GroupSection.cs
+++ b/osu.Game/Screens/Edit/Timing/GroupSection.cs
@@ -37,7 +37,7 @@ namespace osu.Game.Screens.Edit.Timing
             RelativeSizeAxes = Axes.X;
             AutoSizeAxes = Axes.Y;
 
-            Padding = new MarginPadding(10);
+            Padding = new MarginPadding(10) { Bottom = 0 };
 
             InternalChildren = new Drawable[]
             {
diff --git a/osu.Game/Screens/Edit/Timing/Section.cs b/osu.Game/Screens/Edit/Timing/Section.cs
index 139abfb187..17147c21f4 100644
--- a/osu.Game/Screens/Edit/Timing/Section.cs
+++ b/osu.Game/Screens/Edit/Timing/Section.cs
@@ -77,7 +77,7 @@ namespace osu.Game.Screens.Edit.Timing
                     {
                         Flow = new FillFlowContainer
                         {
-                            Padding = new MarginPadding(20),
+                            Padding = new MarginPadding(10) { Top = 0 },
                             Spacing = new Vector2(20),
                             RelativeSizeAxes = Axes.X,
                             AutoSizeAxes = Axes.Y,
diff --git a/osu.Game/Screens/Edit/Timing/TimingAdjustButton.cs b/osu.Game/Screens/Edit/Timing/TimingAdjustButton.cs
index 9fc7e56a3d..eecd85fbca 100644
--- a/osu.Game/Screens/Edit/Timing/TimingAdjustButton.cs
+++ b/osu.Game/Screens/Edit/Timing/TimingAdjustButton.cs
@@ -187,7 +187,7 @@ namespace osu.Game.Screens.Edit.Timing
                         Origin = direction,
                         Font = OsuFont.Default.With(size: 10, weight: FontWeight.Bold),
                         Text = $"{(index > 0 ? "+" : "-")}{Math.Abs(Multiplier * amount)}",
-                        Padding = new MarginPadding(5),
+                        Padding = new MarginPadding(2),
                         Alpha = 0,
                     }
                 };

From 781a1527b10e8c5d846b335e2961d1749aa2c995 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 1 Jun 2022 22:00:54 +0900
Subject: [PATCH 5191/5547] Adjust button metrics and move surrounding buttons
 to be more integrated

---
 osu.Game/Screens/Edit/Timing/TapButton.cs     |  27 +--
 .../Screens/Edit/Timing/TapTimingControl.cs   | 159 +++++++++++++-----
 2 files changed, 130 insertions(+), 56 deletions(-)

diff --git a/osu.Game/Screens/Edit/Timing/TapButton.cs b/osu.Game/Screens/Edit/Timing/TapButton.cs
index 65f31f4396..d18f65c2eb 100644
--- a/osu.Game/Screens/Edit/Timing/TapButton.cs
+++ b/osu.Game/Screens/Edit/Timing/TapButton.cs
@@ -28,7 +28,7 @@ namespace osu.Game.Screens.Edit.Timing
 {
     internal class TapButton : CircularContainer
     {
-        public const float SIZE = 100;
+        public const float SIZE = 140;
 
         public readonly BindableBool IsHandlingTapping = new BindableBool();
 
@@ -62,7 +62,7 @@ namespace osu.Game.Screens.Edit.Timing
         {
             Size = new Vector2(SIZE);
 
-            const float ring_width = 18;
+            const float ring_width = 22;
             const float light_padding = 3;
 
             InternalChild = scaleContainer = new Container
@@ -75,7 +75,7 @@ namespace osu.Game.Screens.Edit.Timing
                     new Circle
                     {
                         RelativeSizeAxes = Axes.Both,
-                        Colour = colourProvider.Background3
+                        Colour = colourProvider.Background4
                     },
                     lights = new Container
                     {
@@ -87,7 +87,7 @@ namespace osu.Game.Screens.Edit.Timing
                         Name = @"outer masking",
                         Masking = true,
                         BorderThickness = light_padding,
-                        BorderColour = colourProvider.Background3,
+                        BorderColour = colourProvider.Background4,
                         Children = new Drawable[]
                         {
                             new Box
@@ -105,7 +105,7 @@ namespace osu.Game.Screens.Edit.Timing
                         Size = new Vector2(SIZE - ring_width * 2 + light_padding * 2),
                         Anchor = Anchor.Centre,
                         Origin = Anchor.Centre,
-                        Colour = colourProvider.Background3,
+                        Colour = colourProvider.Background4,
                     },
                     lightsGlow = new Container
                     {
@@ -139,17 +139,18 @@ namespace osu.Game.Screens.Edit.Timing
                                 {
                                     new OsuSpriteText
                                     {
-                                        Font = OsuFont.Torus.With(size: 20),
+                                        Font = OsuFont.Torus.With(size: 34, weight: FontWeight.SemiBold),
                                         Anchor = Anchor.Centre,
                                         Origin = Anchor.BottomCentre,
-                                        Y = 3,
-                                        Text = "Tap"
+                                        Y = 5,
+                                        Text = "Tap",
                                     },
                                     bpmText = new OsuSpriteText
                                     {
-                                        Font = OsuFont.Torus.With(size: 14),
+                                        Font = OsuFont.Torus.With(size: 23, weight: FontWeight.Regular),
                                         Anchor = Anchor.Centre,
                                         Origin = Anchor.TopCentre,
+                                        Y = -1,
                                     },
                                 }
                             },
@@ -200,7 +201,7 @@ namespace osu.Game.Screens.Edit.Timing
         {
             hoverLayer.FadeIn(500, Easing.OutQuint);
             textContainer.FadeColour(textColour, 500, Easing.OutQuint);
-            return base.OnHover(e);
+            return true;
         }
 
         protected override void OnHoverLost(HoverLostEvent e)
@@ -322,12 +323,14 @@ namespace osu.Game.Screens.Edit.Timing
 
                 Size = new Vector2(0.98f); // Avoid bleed into masking edge.
 
+                const float angular_gap = 0.007f;
+
                 InternalChildren = new Drawable[]
                 {
                     new CircularProgress
                     {
                         RelativeSizeAxes = Axes.Both,
-                        Current = { Value = 1f / light_count - 0.01f },
+                        Current = { Value = 1f / light_count - angular_gap },
                         Colour = colourProvider.Background2,
                     },
                     fillContent = new Container
@@ -340,7 +343,7 @@ namespace osu.Game.Screens.Edit.Timing
                             new CircularProgress
                             {
                                 RelativeSizeAxes = Axes.Both,
-                                Current = { Value = 1f / light_count - 0.01f },
+                                Current = { Value = 1f / light_count - angular_gap },
                                 Blending = BlendingParameters.Additive
                             },
                             Glow = new CircularProgress
diff --git a/osu.Game/Screens/Edit/Timing/TapTimingControl.cs b/osu.Game/Screens/Edit/Timing/TapTimingControl.cs
index 6640eeaa38..f8975c5b11 100644
--- a/osu.Game/Screens/Edit/Timing/TapTimingControl.cs
+++ b/osu.Game/Screens/Edit/Timing/TapTimingControl.cs
@@ -7,10 +7,14 @@ using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
+using osu.Framework.Graphics.Sprites;
+using osu.Framework.Input.Events;
 using osu.Game.Beatmaps.ControlPoints;
 using osu.Game.Graphics;
+using osu.Game.Graphics.UserInterface;
 using osu.Game.Graphics.UserInterfaceV2;
 using osu.Game.Overlays;
+using osuTK;
 
 namespace osu.Game.Screens.Edit.Timing
 {
@@ -32,6 +36,8 @@ namespace osu.Game.Screens.Edit.Timing
         [BackgroundDependencyLoader]
         private void load(OverlayColourProvider colourProvider, OsuColour colours)
         {
+            const float padding = 10;
+
             RelativeSizeAxes = Axes.X;
             AutoSizeAxes = Axes.Y;
 
@@ -52,9 +58,8 @@ namespace osu.Game.Screens.Edit.Timing
                     RowDimensions = new[]
                     {
                         new Dimension(GridSizeMode.Absolute, 200),
-                        new Dimension(GridSizeMode.Absolute, 60),
-                        new Dimension(GridSizeMode.Absolute, 60),
-                        new Dimension(GridSizeMode.Absolute, 120),
+                        new Dimension(GridSizeMode.Absolute, 50),
+                        new Dimension(GridSizeMode.Absolute, TapButton.SIZE + padding),
                     },
                     Content = new[]
                     {
@@ -63,6 +68,7 @@ namespace osu.Game.Screens.Edit.Timing
                             new Container
                             {
                                 RelativeSizeAxes = Axes.Both,
+                                Padding = new MarginPadding(padding),
                                 Children = new Drawable[]
                                 {
                                     new GridContainer
@@ -94,15 +100,14 @@ namespace osu.Game.Screens.Edit.Timing
                             new Container
                             {
                                 RelativeSizeAxes = Axes.Both,
-                                Padding = new MarginPadding(10),
+                                Padding = new MarginPadding { Bottom = padding, Horizontal = padding },
                                 Children = new Drawable[]
                                 {
                                     new TimingAdjustButton(1)
                                     {
                                         Text = "Offset",
-                                        RelativeSizeAxes = Axes.X,
-                                        Width = 0.48f,
-                                        Height = 50,
+                                        RelativeSizeAxes = Axes.Both,
+                                        Size = new Vector2(0.48f, 1),
                                         Action = adjustOffset,
                                     },
                                     new TimingAdjustButton(0.1)
@@ -110,9 +115,8 @@ namespace osu.Game.Screens.Edit.Timing
                                         Anchor = Anchor.TopRight,
                                         Origin = Anchor.TopRight,
                                         Text = "BPM",
-                                        RelativeSizeAxes = Axes.X,
-                                        Width = 0.48f,
-                                        Height = 50,
+                                        RelativeSizeAxes = Axes.Both,
+                                        Size = new Vector2(0.48f, 1),
                                         Action = adjustBpm,
                                     }
                                 }
@@ -123,39 +127,47 @@ namespace osu.Game.Screens.Edit.Timing
                             new Container
                             {
                                 RelativeSizeAxes = Axes.Both,
-                                Padding = new MarginPadding(10),
+                                Padding = new MarginPadding { Bottom = padding, Horizontal = padding },
                                 Children = new Drawable[]
                                 {
-                                    new RoundedButton
+                                    new Container
                                     {
-                                        Text = "Reset",
-                                        BackgroundColour = colours.Pink,
-                                        RelativeSizeAxes = Axes.X,
-                                        Width = 0.3f,
-                                        Action = reset,
+                                        RelativeSizeAxes = Axes.Y,
+                                        Anchor = Anchor.Centre,
+                                        Origin = Anchor.CentreRight,
+                                        Height = 0.98f,
+                                        Width = TapButton.SIZE / 1.3f,
+                                        Masking = true,
+                                        CornerRadius = 15,
+                                        Children = new Drawable[]
+                                        {
+                                            new LessRoundedButton(FontAwesome.Solid.Stop, Anchor.TopLeft)
+                                            {
+                                                BackgroundColour = colourProvider.Background1,
+                                                RelativeSizeAxes = Axes.Both,
+                                                Height = 0.49f,
+                                                Action = reset,
+                                            },
+                                            new LessRoundedButton(FontAwesome.Solid.Play, Anchor.BottomLeft)
+                                            {
+                                                BackgroundColour = colourProvider.Background1,
+                                                RelativeSizeAxes = Axes.Both,
+                                                Height = 0.49f,
+                                                Anchor = Anchor.BottomLeft,
+                                                Origin = Anchor.BottomLeft,
+                                                Action = start,
+                                            },
+                                        },
                                     },
-                                    new RoundedButton
+                                    new TapButton
                                     {
-                                        Anchor = Anchor.TopRight,
-                                        Origin = Anchor.TopRight,
-                                        Text = "Play from start",
-                                        RelativeSizeAxes = Axes.X,
-                                        BackgroundColour = colourProvider.Background1,
-                                        Width = 0.68f,
-                                        Action = tap,
+                                        Anchor = Anchor.Centre,
+                                        Origin = Anchor.Centre,
+                                        IsHandlingTapping = { BindTarget = isHandlingTapping }
                                     }
                                 }
                             },
                         },
-                        new Drawable[]
-                        {
-                            new TapButton
-                            {
-                                Anchor = Anchor.Centre,
-                                Origin = Anchor.Centre,
-                                IsHandlingTapping = { BindTarget = isHandlingTapping }
-                            }
-                        }
                     }
                 },
             };
@@ -165,13 +177,78 @@ namespace osu.Game.Screens.Edit.Timing
                 metronome.EnableClicking = !handling.NewValue;
 
                 if (handling.NewValue)
-                {
-                    editorClock.Seek(selectedGroup.Value.Time);
-                    editorClock.Start();
-                }
+                    start();
             }, true);
         }
 
+        private class LessRoundedButton : OsuButton
+        {
+            private readonly IconUsage icon;
+            private readonly Anchor anchor;
+
+            private SpriteIcon spriteIcon;
+
+            public LessRoundedButton(IconUsage icon, Anchor anchor)
+            {
+                this.icon = icon;
+                this.anchor = anchor;
+            }
+
+            [Resolved]
+            private OverlayColourProvider colourProvider { get; set; }
+
+            protected override void LoadComplete()
+            {
+                base.LoadComplete();
+
+                Content.CornerRadius = 0;
+                Content.Masking = false;
+
+                BackgroundColour = colourProvider.Background2;
+
+                Content.Add(new Container
+                {
+                    RelativeSizeAxes = Axes.Both,
+                    Padding = new MarginPadding(15),
+                    Children = new Drawable[]
+                    {
+                        spriteIcon = new SpriteIcon
+                        {
+                            Icon = icon,
+                            Size = new Vector2(22),
+                            Anchor = anchor,
+                            Origin = anchor,
+                            Colour = colourProvider.Background1,
+                        },
+                    }
+                });
+            }
+
+            protected override bool OnMouseDown(MouseDownEvent e)
+            {
+                // scale looks bad so don't call base.
+                return false;
+            }
+
+            protected override bool OnHover(HoverEvent e)
+            {
+                spriteIcon.FadeColour(colourProvider.Content2, 200, Easing.OutQuint);
+                return base.OnHover(e);
+            }
+
+            protected override void OnHoverLost(HoverLostEvent e)
+            {
+                spriteIcon.FadeColour(colourProvider.Background1, 200, Easing.OutQuint);
+                base.OnHoverLost(e);
+            }
+        }
+
+        private void start()
+        {
+            editorClock.Seek(selectedGroup.Value.Time);
+            editorClock.Start();
+        }
+
         private void adjustOffset(double adjust)
         {
             // VERY TEMPORARY
@@ -201,12 +278,6 @@ namespace osu.Game.Screens.Edit.Timing
             timing.BeatLength = 60000 / (timing.BPM + adjust);
         }
 
-        private void tap()
-        {
-            editorClock.Seek(selectedGroup.Value.Time);
-            editorClock.Start();
-        }
-
         private void reset()
         {
             editorClock.Stop();

From 0c493dd3592f96abd63f3390bb1160f9a99ecf6d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 2 Jun 2022 12:27:11 +0900
Subject: [PATCH 5192/5547] Add key binding for tap button

---
 .../Input/Bindings/GlobalActionContainer.cs   |  4 +++
 .../GlobalActionKeyBindingStrings.cs          |  5 ++++
 osu.Game/Screens/Edit/Timing/TapButton.cs     | 25 +++++++++++++++++--
 3 files changed, 32 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Input/Bindings/GlobalActionContainer.cs b/osu.Game/Input/Bindings/GlobalActionContainer.cs
index 69ea6b00ca..3da5f3212e 100644
--- a/osu.Game/Input/Bindings/GlobalActionContainer.cs
+++ b/osu.Game/Input/Bindings/GlobalActionContainer.cs
@@ -80,6 +80,7 @@ namespace osu.Game.Input.Bindings
             new KeyBinding(new[] { InputKey.K }, GlobalAction.EditorNudgeRight),
             new KeyBinding(new[] { InputKey.G }, GlobalAction.EditorCycleGridDisplayMode),
             new KeyBinding(new[] { InputKey.F5 }, GlobalAction.EditorTestGameplay),
+            new KeyBinding(new[] { InputKey.T }, GlobalAction.EditorTapForBPM),
             new KeyBinding(new[] { InputKey.Control, InputKey.H }, GlobalAction.EditorFlipHorizontally),
             new KeyBinding(new[] { InputKey.Control, InputKey.J }, GlobalAction.EditorFlipVertically),
             new KeyBinding(new[] { InputKey.Control, InputKey.Alt, InputKey.MouseWheelDown }, GlobalAction.EditorDecreaseDistanceSpacing),
@@ -322,5 +323,8 @@ namespace osu.Game.Input.Bindings
 
         [LocalisableDescription(typeof(GlobalActionKeyBindingStrings), nameof(GlobalActionKeyBindingStrings.DeselectAllMods))]
         DeselectAllMods,
+
+        [LocalisableDescription(typeof(GlobalActionKeyBindingStrings), nameof(GlobalActionKeyBindingStrings.EditorTapForBPM))]
+        EditorTapForBPM,
     }
 }
diff --git a/osu.Game/Localisation/GlobalActionKeyBindingStrings.cs b/osu.Game/Localisation/GlobalActionKeyBindingStrings.cs
index e392ae619f..586e29a432 100644
--- a/osu.Game/Localisation/GlobalActionKeyBindingStrings.cs
+++ b/osu.Game/Localisation/GlobalActionKeyBindingStrings.cs
@@ -174,6 +174,11 @@ namespace osu.Game.Localisation
         /// </summary>
         public static LocalisableString EditorTimingMode => new TranslatableString(getKey(@"editor_timing_mode"), @"Timing mode");
 
+        /// <summary>
+        /// "Tap for BPM"
+        /// </summary>
+        public static LocalisableString EditorTapForBPM => new TranslatableString(getKey(@"editor_tap_for_bpm"), @"Tap for BPM");
+
         /// <summary>
         /// "Cycle grid display mode"
         /// </summary>
diff --git a/osu.Game/Screens/Edit/Timing/TapButton.cs b/osu.Game/Screens/Edit/Timing/TapButton.cs
index d18f65c2eb..614e7aecde 100644
--- a/osu.Game/Screens/Edit/Timing/TapButton.cs
+++ b/osu.Game/Screens/Edit/Timing/TapButton.cs
@@ -15,18 +15,21 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Effects;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Graphics.UserInterface;
+using osu.Framework.Input.Bindings;
 using osu.Framework.Input.Events;
 using osu.Framework.Threading;
 using osu.Game.Beatmaps.ControlPoints;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
+using osu.Game.Input.Bindings;
 using osu.Game.Overlays;
 using osuTK;
 using osuTK.Graphics;
+using osuTK.Input;
 
 namespace osu.Game.Screens.Edit.Timing
 {
-    internal class TapButton : CircularContainer
+    internal class TapButton : CircularContainer, IKeyBindingHandler<GlobalAction>
     {
         public const float SIZE = 140;
 
@@ -57,6 +60,8 @@ namespace osu.Game.Screens.Edit.Timing
 
         private const int light_count = 6;
 
+        private readonly List<double> tapTimings = new List<double>();
+
         [BackgroundDependencyLoader]
         private void load()
         {
@@ -257,7 +262,23 @@ namespace osu.Game.Screens.Edit.Timing
             base.OnMouseUp(e);
         }
 
-        private readonly List<double> tapTimings = new List<double>();
+        public bool OnPressed(KeyBindingPressEvent<GlobalAction> e)
+        {
+            if (e.Action == GlobalAction.EditorTapForBPM && !e.Repeat)
+            {
+                // Direct through mouse handling to achieve animation
+                OnMouseDown(new MouseDownEvent(e.CurrentState, MouseButton.Left));
+                return true;
+            }
+
+            return false;
+        }
+
+        public void OnReleased(KeyBindingReleaseEvent<GlobalAction> e)
+        {
+            if (e.Action == GlobalAction.EditorTapForBPM)
+                OnMouseUp(new MouseUpEvent(e.CurrentState, MouseButton.Left));
+        }
 
         private void reset()
         {

From 943e904c71f74feda0765075798140c2370ac46c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 2 Jun 2022 12:55:03 +0900
Subject: [PATCH 5193/5547] Fix reset happening on mouse down instead of mouse
 up

Also some reorganisation of file content for legibility
---
 osu.Game/Screens/Edit/Timing/TapButton.cs | 49 ++++++++++++-----------
 1 file changed, 26 insertions(+), 23 deletions(-)

diff --git a/osu.Game/Screens/Edit/Timing/TapButton.cs b/osu.Game/Screens/Edit/Timing/TapButton.cs
index 614e7aecde..7f913e386e 100644
--- a/osu.Game/Screens/Edit/Timing/TapButton.cs
+++ b/osu.Game/Screens/Edit/Timing/TapButton.cs
@@ -60,6 +60,10 @@ namespace osu.Game.Screens.Edit.Timing
 
         private const int light_count = 6;
 
+        private const int initial_taps_to_ignore = 4;
+
+        private const int max_taps_to_consider = 8;
+
         private readonly List<double> tapTimings = new List<double>();
 
         [BackgroundDependencyLoader]
@@ -223,10 +227,9 @@ namespace osu.Game.Screens.Edit.Timing
             grabbedMouseDown = true;
             IsHandlingTapping.Value = true;
 
-            handleTap();
-
             resetDelegate?.Cancel();
-            resetDelegate = Scheduler.AddDelayed(reset, 1000);
+
+            handleTap();
 
             textContainer.FadeColour(textColour, in_duration, Easing.OutQuint);
 
@@ -259,6 +262,9 @@ namespace osu.Game.Screens.Edit.Timing
             scaleContainer.ScaleTo(1, out_duration, Easing.OutQuint);
             innerCircle.ScaleTo(1, out_duration, Easing.OutQuint);
             innerCircleHighlight.FadeOut(out_duration, Easing.OutQuint);
+
+            resetDelegate = Scheduler.AddDelayed(reset, 1000);
+
             base.OnMouseUp(e);
         }
 
@@ -280,26 +286,6 @@ namespace osu.Game.Screens.Edit.Timing
                 OnMouseUp(new MouseUpEvent(e.CurrentState, MouseButton.Left));
         }
 
-        private void reset()
-        {
-            bpmText.FadeOut(500, Easing.OutQuint);
-
-            using (BeginDelayedSequence(tapTimings.Count > 0 ? 500 : 0))
-            {
-                Schedule(() => bpmText.Text = "the beat!");
-                bpmText.FadeIn(800, Easing.OutQuint);
-            }
-
-            foreach (var light in lights)
-                light.Hide();
-
-            tapTimings.Clear();
-            IsHandlingTapping.Value = false;
-        }
-
-        private const int initial_taps_to_ignore = 4;
-        private const int max_taps_to_consider = 8;
-
         private void handleTap()
         {
             tapTimings.Add(Clock.CurrentTime);
@@ -326,6 +312,23 @@ namespace osu.Game.Screens.Edit.Timing
             }
         }
 
+        private void reset()
+        {
+            bpmText.FadeOut(500, Easing.OutQuint);
+
+            using (BeginDelayedSequence(tapTimings.Count > 0 ? 500 : 0))
+            {
+                Schedule(() => bpmText.Text = "the beat!");
+                bpmText.FadeIn(800, Easing.OutQuint);
+            }
+
+            foreach (var light in lights)
+                light.Hide();
+
+            tapTimings.Clear();
+            IsHandlingTapping.Value = false;
+        }
+
         private class Light : CompositeDrawable
         {
             public Drawable Glow { get; private set; } = null!;

From d99d37c0a60c6eb95d43e920331210d4af315d6f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 2 Jun 2022 13:06:18 +0900
Subject: [PATCH 5194/5547] Apply current track rate to calculated BPM

---
 osu.Game/Screens/Edit/Timing/TapButton.cs | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Edit/Timing/TapButton.cs b/osu.Game/Screens/Edit/Timing/TapButton.cs
index 7f913e386e..6b9ac7be5c 100644
--- a/osu.Game/Screens/Edit/Timing/TapButton.cs
+++ b/osu.Game/Screens/Edit/Timing/TapButton.cs
@@ -18,6 +18,7 @@ using osu.Framework.Graphics.UserInterface;
 using osu.Framework.Input.Bindings;
 using osu.Framework.Input.Events;
 using osu.Framework.Threading;
+using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.ControlPoints;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
@@ -41,6 +42,9 @@ namespace osu.Game.Screens.Edit.Timing
         [Resolved(canBeNull: true)]
         private Bindable<ControlPointGroup>? selectedGroup { get; set; }
 
+        [Resolved(canBeNull: true)]
+        private IBeatSyncProvider? beatSyncSource { get; set; }
+
         private Circle hoverLayer = null!;
 
         private CircularContainer innerCircle = null!;
@@ -299,7 +303,10 @@ namespace osu.Game.Screens.Edit.Timing
                 return;
             }
 
-            double bpm = Math.Round(60000 / ((tapTimings.Last() - tapTimings.Skip(initial_taps_to_ignore).First()) / (tapTimings.Count - initial_taps_to_ignore - 1)));
+            double averageBeatLength = (tapTimings.Last() - tapTimings.Skip(initial_taps_to_ignore).First()) / (tapTimings.Count - initial_taps_to_ignore - 1);
+            double clockRate = beatSyncSource?.Clock?.Rate ?? 1;
+
+            double bpm = Math.Round(60000 / averageBeatLength / clockRate);
 
             bpmText.Text = $"{bpm} BPM";
 

From ac3793f340d14cd3a9d0a7b4dc738f3ee6c96f35 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 2 Jun 2022 13:10:50 +0900
Subject: [PATCH 5195/5547] Move inline class to end and apply NRT

---
 .../Screens/Edit/Timing/TapTimingControl.cs   | 108 +++++++++---------
 1 file changed, 55 insertions(+), 53 deletions(-)

diff --git a/osu.Game/Screens/Edit/Timing/TapTimingControl.cs b/osu.Game/Screens/Edit/Timing/TapTimingControl.cs
index f8975c5b11..9b5574d3cb 100644
--- a/osu.Game/Screens/Edit/Timing/TapTimingControl.cs
+++ b/osu.Game/Screens/Edit/Timing/TapTimingControl.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.
 
+#nullable enable
+
 using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
@@ -21,17 +23,17 @@ namespace osu.Game.Screens.Edit.Timing
     public class TapTimingControl : CompositeDrawable
     {
         [Resolved]
-        private EditorClock editorClock { get; set; }
+        private EditorClock editorClock { get; set; } = null!;
 
         [Resolved]
-        private EditorBeatmap beatmap { get; set; }
+        private EditorBeatmap beatmap { get; set; } = null!;
 
         [Resolved]
-        private Bindable<ControlPointGroup> selectedGroup { get; set; }
+        private Bindable<ControlPointGroup> selectedGroup { get; set; } = null!;
 
         private readonly BindableBool isHandlingTapping = new BindableBool();
 
-        private MetronomeDisplay metronome;
+        private MetronomeDisplay metronome = null!;
 
         [BackgroundDependencyLoader]
         private void load(OverlayColourProvider colourProvider, OsuColour colours)
@@ -141,14 +143,14 @@ namespace osu.Game.Screens.Edit.Timing
                                         CornerRadius = 15,
                                         Children = new Drawable[]
                                         {
-                                            new LessRoundedButton(FontAwesome.Solid.Stop, Anchor.TopLeft)
+                                            new InlineButton(FontAwesome.Solid.Stop, Anchor.TopLeft)
                                             {
                                                 BackgroundColour = colourProvider.Background1,
                                                 RelativeSizeAxes = Axes.Both,
                                                 Height = 0.49f,
                                                 Action = reset,
                                             },
-                                            new LessRoundedButton(FontAwesome.Solid.Play, Anchor.BottomLeft)
+                                            new InlineButton(FontAwesome.Solid.Play, Anchor.BottomLeft)
                                             {
                                                 BackgroundColour = colourProvider.Background1,
                                                 RelativeSizeAxes = Axes.Both,
@@ -181,22 +183,63 @@ namespace osu.Game.Screens.Edit.Timing
             }, true);
         }
 
-        private class LessRoundedButton : OsuButton
+        private void start()
+        {
+            editorClock.Seek(selectedGroup.Value.Time);
+            editorClock.Start();
+        }
+
+        private void reset()
+        {
+            editorClock.Stop();
+            editorClock.Seek(selectedGroup.Value.Time);
+        }
+
+        private void adjustOffset(double adjust)
+        {
+            // VERY TEMPORARY
+            var currentGroupItems = selectedGroup.Value.ControlPoints.ToArray();
+
+            beatmap.ControlPointInfo.RemoveGroup(selectedGroup.Value);
+
+            double newOffset = selectedGroup.Value.Time + adjust;
+
+            foreach (var cp in currentGroupItems)
+                beatmap.ControlPointInfo.Add(newOffset, cp);
+
+            // the control point might not necessarily exist yet, if currentGroupItems was empty.
+            selectedGroup.Value = beatmap.ControlPointInfo.GroupAt(newOffset, true);
+
+            if (!editorClock.IsRunning)
+                editorClock.Seek(newOffset);
+        }
+
+        private void adjustBpm(double adjust)
+        {
+            var timing = selectedGroup.Value.ControlPoints.OfType<TimingControlPoint>().FirstOrDefault();
+
+            if (timing == null)
+                return;
+
+            timing.BeatLength = 60000 / (timing.BPM + adjust);
+        }
+
+        private class InlineButton : OsuButton
         {
             private readonly IconUsage icon;
             private readonly Anchor anchor;
 
-            private SpriteIcon spriteIcon;
+            private SpriteIcon spriteIcon = null!;
 
-            public LessRoundedButton(IconUsage icon, Anchor anchor)
+            [Resolved]
+            private OverlayColourProvider colourProvider { get; set; } = null!;
+
+            public InlineButton(IconUsage icon, Anchor anchor)
             {
                 this.icon = icon;
                 this.anchor = anchor;
             }
 
-            [Resolved]
-            private OverlayColourProvider colourProvider { get; set; }
-
             protected override void LoadComplete()
             {
                 base.LoadComplete();
@@ -242,46 +285,5 @@ namespace osu.Game.Screens.Edit.Timing
                 base.OnHoverLost(e);
             }
         }
-
-        private void start()
-        {
-            editorClock.Seek(selectedGroup.Value.Time);
-            editorClock.Start();
-        }
-
-        private void adjustOffset(double adjust)
-        {
-            // VERY TEMPORARY
-            var currentGroupItems = selectedGroup.Value.ControlPoints.ToArray();
-
-            beatmap.ControlPointInfo.RemoveGroup(selectedGroup.Value);
-
-            double newOffset = selectedGroup.Value.Time + adjust;
-
-            foreach (var cp in currentGroupItems)
-                beatmap.ControlPointInfo.Add(newOffset, cp);
-
-            // the control point might not necessarily exist yet, if currentGroupItems was empty.
-            selectedGroup.Value = beatmap.ControlPointInfo.GroupAt(newOffset, true);
-
-            if (!editorClock.IsRunning)
-                editorClock.Seek(newOffset);
-        }
-
-        private void adjustBpm(double adjust)
-        {
-            var timing = selectedGroup.Value.ControlPoints.OfType<TimingControlPoint>().FirstOrDefault();
-
-            if (timing == null)
-                return;
-
-            timing.BeatLength = 60000 / (timing.BPM + adjust);
-        }
-
-        private void reset()
-        {
-            editorClock.Stop();
-            editorClock.Seek(selectedGroup.Value.Time);
-        }
     }
 }

From 15f8d318eb05355d09fce8e457d0bbfb9660377a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 2 Jun 2022 13:13:00 +0900
Subject: [PATCH 5196/5547] Add note about glow code (please look away)

---
 osu.Game/Screens/Edit/Timing/TapButton.cs | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/osu.Game/Screens/Edit/Timing/TapButton.cs b/osu.Game/Screens/Edit/Timing/TapButton.cs
index 6b9ac7be5c..0cb2ac3d1a 100644
--- a/osu.Game/Screens/Edit/Timing/TapButton.cs
+++ b/osu.Game/Screens/Edit/Timing/TapButton.cs
@@ -377,6 +377,9 @@ namespace osu.Game.Screens.Edit.Timing
                                 Current = { Value = 1f / light_count - angular_gap },
                                 Blending = BlendingParameters.Additive
                             },
+                            // Please do not try and make sense of this.
+                            // Getting the visual effect I was going for relies on what I can only imagine is broken implementation
+                            // of `PadExtent`. If that's ever fixed in the future this will likely need to be adjusted.
                             Glow = new CircularProgress
                             {
                                 RelativeSizeAxes = Axes.Both,

From 060372a129a4e42fc3d2f67a9118874e3aa13fb3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 2 Jun 2022 13:16:31 +0900
Subject: [PATCH 5197/5547] Split out transition length constants

---
 osu.Game/Screens/Edit/Timing/TapButton.cs | 15 +++++++++------
 1 file changed, 9 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Screens/Edit/Timing/TapButton.cs b/osu.Game/Screens/Edit/Timing/TapButton.cs
index 0cb2ac3d1a..4eeb358066 100644
--- a/osu.Game/Screens/Edit/Timing/TapButton.cs
+++ b/osu.Game/Screens/Edit/Timing/TapButton.cs
@@ -68,6 +68,8 @@ namespace osu.Game.Screens.Edit.Timing
 
         private const int max_taps_to_consider = 8;
 
+        private const double transition_length = 500;
+
         private readonly List<double> tapTimings = new List<double>();
 
         [BackgroundDependencyLoader]
@@ -212,15 +214,15 @@ namespace osu.Game.Screens.Edit.Timing
 
         protected override bool OnHover(HoverEvent e)
         {
-            hoverLayer.FadeIn(500, Easing.OutQuint);
-            textContainer.FadeColour(textColour, 500, Easing.OutQuint);
+            hoverLayer.FadeIn(transition_length, Easing.OutQuint);
+            textContainer.FadeColour(textColour, transition_length, Easing.OutQuint);
             return true;
         }
 
         protected override void OnHoverLost(HoverLostEvent e)
         {
-            hoverLayer.FadeOut(500, Easing.OutQuint);
-            textContainer.FadeColour(textColour, 500, Easing.OutQuint);
+            hoverLayer.FadeOut(transition_length, Easing.OutQuint);
+            textContainer.FadeColour(textColour, transition_length, Easing.OutQuint);
             base.OnHoverLost(e);
         }
 
@@ -265,6 +267,7 @@ namespace osu.Game.Screens.Edit.Timing
 
             scaleContainer.ScaleTo(1, out_duration, Easing.OutQuint);
             innerCircle.ScaleTo(1, out_duration, Easing.OutQuint);
+
             innerCircleHighlight.FadeOut(out_duration, Easing.OutQuint);
 
             resetDelegate = Scheduler.AddDelayed(reset, 1000);
@@ -321,9 +324,9 @@ namespace osu.Game.Screens.Edit.Timing
 
         private void reset()
         {
-            bpmText.FadeOut(500, Easing.OutQuint);
+            bpmText.FadeOut(transition_length, Easing.OutQuint);
 
-            using (BeginDelayedSequence(tapTimings.Count > 0 ? 500 : 0))
+            using (BeginDelayedSequence(tapTimings.Count > 0 ? transition_length : 0))
             {
                 Schedule(() => bpmText.Text = "the beat!");
                 bpmText.FadeIn(800, Easing.OutQuint);

From 600da89f72bcca5668b548896d5a3c9880deb1fd Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 2 Jun 2022 14:22:12 +0900
Subject: [PATCH 5198/5547] Fix disposing previous leaderboard too late

---
 .../Visual/Multiplayer/TestSceneMultiSpectatorLeaderboard.cs   | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorLeaderboard.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorLeaderboard.cs
index e94e198a4a..b115fa4ff2 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorLeaderboard.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorLeaderboard.cs
@@ -4,6 +4,7 @@
 using System.Collections.Generic;
 using System.Linq;
 using NUnit.Framework;
+using osu.Framework.Graphics;
 using osu.Framework.Testing;
 using osu.Framework.Timing;
 using osu.Game.Online.API.Requests.Responses;
@@ -23,7 +24,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         {
             AddStep("reset", () =>
             {
-                Clear();
+                leaderboard?.RemoveAndDisposeImmediately();
 
                 clocks = new Dictionary<int, ManualClock>
                 {

From 793dfe2bc82f6dbff756b08bafe8c024fcee016b Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 2 Jun 2022 14:22:45 +0900
Subject: [PATCH 5199/5547] Mark players as playing

---
 .../Visual/Multiplayer/TestSceneMultiSpectatorLeaderboard.cs  | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorLeaderboard.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorLeaderboard.cs
index b115fa4ff2..60215dc8b3 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorLeaderboard.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorLeaderboard.cs
@@ -32,10 +32,10 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     { PLAYER_2_ID, new ManualClock() }
                 };
 
-                foreach ((int userId, var _) in clocks)
+                foreach ((int userId, _) in clocks)
                 {
                     SpectatorClient.SendStartPlay(userId, 0);
-                    OnlinePlayDependencies.MultiplayerClient.AddUser(new APIUser { Id = userId });
+                    OnlinePlayDependencies.MultiplayerClient.AddUser(new APIUser { Id = userId }, true);
                 }
             });
 

From 6fb1fe06a03c56325f0f3d97fbbb8f3912ab79a1 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 2 Jun 2022 14:47:04 +0900
Subject: [PATCH 5200/5547] Remove unnecessary ApplyBeatmap call

---
 .../Spectator/SpectatorScoreProcessor.cs      | 24 -------------------
 1 file changed, 24 deletions(-)

diff --git a/osu.Game/Online/Spectator/SpectatorScoreProcessor.cs b/osu.Game/Online/Spectator/SpectatorScoreProcessor.cs
index e81cf433a5..634af73c44 100644
--- a/osu.Game/Online/Spectator/SpectatorScoreProcessor.cs
+++ b/osu.Game/Online/Spectator/SpectatorScoreProcessor.cs
@@ -10,12 +10,8 @@ using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
-using osu.Game.Beatmaps;
-using osu.Game.Beatmaps.ControlPoints;
-using osu.Game.Beatmaps.Timing;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Mods;
-using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Scoring;
 using osu.Game.Scoring;
 
@@ -109,10 +105,7 @@ namespace osu.Game.Online.Spectator
             spectatorState = userState;
             scoreInfo = new ScoreInfo { Ruleset = rulesetInfo };
             scoreProcessor = ruleset.CreateScoreProcessor();
-
-            // Mods are required for score multiplier.
             scoreProcessor.Mods.Value = userState.Mods.Select(m => m.ToMod(ruleset)).ToArray();
-            scoreProcessor.ApplyBeatmap(new DummyBeatmap());
         }
 
         private void onNewFrames(int incomingUserId, FrameDataBundle bundle)
@@ -165,23 +158,6 @@ namespace osu.Game.Online.Spectator
                 spectatorClient.OnNewFrames -= onNewFrames;
         }
 
-        private class DummyBeatmap : IBeatmap
-        {
-            public BeatmapInfo BeatmapInfo { get; set; } = new BeatmapInfo();
-            public BeatmapMetadata Metadata { get; } = new BeatmapMetadata();
-            public BeatmapDifficulty Difficulty { get; set; } = new BeatmapDifficulty();
-            public ControlPointInfo ControlPointInfo { get; set; } = new ControlPointInfo();
-            public List<BreakPeriod> Breaks { get; } = new List<BreakPeriod>();
-            public double TotalBreakTime => 0;
-            public IReadOnlyList<HitObject> HitObjects => Array.Empty<HitObject>();
-
-            public IEnumerable<BeatmapStatistic> GetStatistics() => Array.Empty<BeatmapStatistic>();
-
-            public double GetMostCommonBeatLength() => 0;
-
-            public IBeatmap Clone() => throw new NotImplementedException();
-        }
-
         private class TimedFrame : IComparable<TimedFrame>
         {
             public readonly double Time;

From 2209a009f9dc15f857a16e6580ce904bc796583a Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 2 Jun 2022 14:48:55 +0900
Subject: [PATCH 5201/5547] Don't process clock

---
 .../OnlinePlay/Multiplayer/Spectate/MultiSpectatorLeaderboard.cs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorLeaderboard.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorLeaderboard.cs
index 589f5ce988..671f872188 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorLeaderboard.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorLeaderboard.cs
@@ -20,6 +20,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Spectate
             if (!UserScores.TryGetValue(userId, out var data))
                 throw new ArgumentException(@"Provided user is not tracked by this leaderboard", nameof(userId));
 
+            data.ScoreProcessor.ProcessCustomClock = false;
             data.ScoreProcessor.Clock = new FramedClock(clock);
         }
 

From 4d9a77bdc06cc3ea368ff8865f8fdfc710c6098d Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 2 Jun 2022 15:02:44 +0900
Subject: [PATCH 5202/5547] Stop using Drawable.Clock altogether

---
 .../Online/Spectator/SpectatorScoreProcessor.cs    | 14 +++++++++++++-
 .../Spectate/MultiSpectatorLeaderboard.cs          |  3 +--
 2 files changed, 14 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Online/Spectator/SpectatorScoreProcessor.cs b/osu.Game/Online/Spectator/SpectatorScoreProcessor.cs
index 634af73c44..c1829a7023 100644
--- a/osu.Game/Online/Spectator/SpectatorScoreProcessor.cs
+++ b/osu.Game/Online/Spectator/SpectatorScoreProcessor.cs
@@ -10,6 +10,7 @@ using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
+using osu.Framework.Timing;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Scoring;
@@ -48,6 +49,17 @@ namespace osu.Game.Online.Spectator
         /// </summary>
         public IReadOnlyList<Mod> Mods => scoreProcessor?.Mods.Value ?? Array.Empty<Mod>();
 
+        private IClock? referenceClock;
+
+        /// <summary>
+        /// The clock used to determine the current score.
+        /// </summary>
+        public IClock ReferenceClock
+        {
+            get => referenceClock ?? Clock;
+            set => referenceClock = value;
+        }
+
         [Resolved]
         private SpectatorClient spectatorClient { get; set; } = null!;
 
@@ -131,7 +143,7 @@ namespace osu.Game.Online.Spectator
             Debug.Assert(spectatorState != null);
             Debug.Assert(scoreProcessor != null);
 
-            int frameIndex = replayFrames.BinarySearch(new TimedFrame(Time.Current));
+            int frameIndex = replayFrames.BinarySearch(new TimedFrame(ReferenceClock.CurrentTime));
             if (frameIndex < 0)
                 frameIndex = ~frameIndex;
             frameIndex = Math.Clamp(frameIndex - 1, 0, replayFrames.Count - 1);
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorLeaderboard.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorLeaderboard.cs
index 671f872188..4e9ab07e4c 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorLeaderboard.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorLeaderboard.cs
@@ -20,8 +20,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Spectate
             if (!UserScores.TryGetValue(userId, out var data))
                 throw new ArgumentException(@"Provided user is not tracked by this leaderboard", nameof(userId));
 
-            data.ScoreProcessor.ProcessCustomClock = false;
-            data.ScoreProcessor.Clock = new FramedClock(clock);
+            data.ScoreProcessor.ReferenceClock = clock;
         }
 
         protected override void Update()

From 5bd9d882195dbe1f1f60032f2456a062a2072501 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 2 Jun 2022 16:34:23 +0900
Subject: [PATCH 5203/5547] Fix tutorial download state not matching correctly
 when already available locally

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

This doesn't stop the tutorial from downloading a second time, but at
least displays the correct status afterwards. Avoiding the download is a
bit more involved and requires a change to the flow. Probably not worth
it just yet.

To test, recommend switching to production environment, as dev server
doesn't have correct metadata for tutorial resulting in weirdness.
---
 osu.Game/Beatmaps/Drawables/BundledBeatmapDownloader.cs | 2 ++
 osu.Game/Overlays/FirstRunSetup/ScreenBeatmaps.cs       | 9 ++++++---
 2 files changed, 8 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Beatmaps/Drawables/BundledBeatmapDownloader.cs b/osu.Game/Beatmaps/Drawables/BundledBeatmapDownloader.cs
index 84903d381a..5ebdee0b09 100644
--- a/osu.Game/Beatmaps/Drawables/BundledBeatmapDownloader.cs
+++ b/osu.Game/Beatmaps/Drawables/BundledBeatmapDownloader.cs
@@ -85,6 +85,8 @@ namespace osu.Game.Beatmaps.Drawables
                 downloadTrackers.Add(beatmapDownloadTracker);
                 AddInternal(beatmapDownloadTracker);
 
+                // Note that this is downloading the beatmaps even if they are already downloaded.
+                // We could rely more on `BeatmapDownloadTracker`'s exposed state to avoid this.
                 beatmapDownloader.Download(beatmapSet);
             }
         }
diff --git a/osu.Game/Overlays/FirstRunSetup/ScreenBeatmaps.cs b/osu.Game/Overlays/FirstRunSetup/ScreenBeatmaps.cs
index 17e04c0c99..ddcee7c040 100644
--- a/osu.Game/Overlays/FirstRunSetup/ScreenBeatmaps.cs
+++ b/osu.Game/Overlays/FirstRunSetup/ScreenBeatmaps.cs
@@ -154,12 +154,15 @@ namespace osu.Game.Overlays.FirstRunSetup
 
             var downloadTracker = tutorialDownloader.DownloadTrackers.First();
 
+            downloadTracker.State.BindValueChanged(state =>
+            {
+                if (state.NewValue == DownloadState.LocallyAvailable)
+                    downloadTutorialButton.Complete();
+            }, true);
+
             downloadTracker.Progress.BindValueChanged(progress =>
             {
                 downloadTutorialButton.SetProgress(progress.NewValue, false);
-
-                if (progress.NewValue == 1)
-                    downloadTutorialButton.Complete();
             }, true);
         }
 

From 055845d4f56db74f7840adf74d76cbce1fe6b687 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 2 Jun 2022 16:34:36 +0900
Subject: [PATCH 5204/5547] Throw exception on access before ApplyBeatmap()

---
 osu.Game/Rulesets/Scoring/ScoreProcessor.cs | 17 ++++++++++++++---
 1 file changed, 14 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Rulesets/Scoring/ScoreProcessor.cs b/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
index 853f43ddb6..dd977a5c50 100644
--- a/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
+++ b/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
@@ -93,7 +93,18 @@ namespace osu.Game.Rulesets.Scoring
         /// <summary>
         /// Scoring values for a perfect play.
         /// </summary>
-        public ScoringValues MaximumScoringValues { get; private set; }
+        public ScoringValues MaximumScoringValues
+        {
+            get
+            {
+                if (!beatmapApplied)
+                    throw new InvalidOperationException($"Cannot access maximum scoring values before calling {nameof(ApplyBeatmap)}.");
+
+                return maximumScoringValues;
+            }
+        }
+
+        private ScoringValues maximumScoringValues;
 
         /// <summary>
         /// Scoring values for the current play assuming all perfect hits.
@@ -255,7 +266,7 @@ namespace osu.Game.Rulesets.Scoring
         private void updateScore()
         {
             Accuracy.Value = currentMaximumScoringValues.BaseScore > 0 ? currentScoringValues.BaseScore / currentMaximumScoringValues.BaseScore : 1;
-            TotalScore.Value = ComputeScore(Mode.Value, currentScoringValues, MaximumScoringValues);
+            TotalScore.Value = ComputeScore(Mode.Value, currentScoringValues, maximumScoringValues);
         }
 
         /// <summary>
@@ -406,7 +417,7 @@ namespace osu.Game.Rulesets.Scoring
             lastHitObject = null;
 
             if (storeResults)
-                MaximumScoringValues = currentScoringValues;
+                maximumScoringValues = currentScoringValues;
 
             currentScoringValues = default;
             currentMaximumScoringValues = default;

From a638392e81e9656b305a0b4c9ed8b0c8d4cd347d Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 2 Jun 2022 16:35:50 +0900
Subject: [PATCH 5205/5547] Rename member

---
 osu.Game/Rulesets/Scoring/ScoreProcessor.cs | 22 ++++++++++-----------
 osu.Game/Scoring/ScoringValues.cs           |  2 +-
 2 files changed, 12 insertions(+), 12 deletions(-)

diff --git a/osu.Game/Rulesets/Scoring/ScoreProcessor.cs b/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
index dd977a5c50..4a5897c621 100644
--- a/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
+++ b/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
@@ -211,7 +211,7 @@ namespace osu.Game.Rulesets.Scoring
                 scoringValues.BaseScore += result.IsHit() ? Judgement.ToNumericResult(result) : 0;
 
             if (result.IsBasic())
-                scoringValues.HitObjects++;
+                scoringValues.CountBasicHitObjects++;
         }
 
         /// <summary>
@@ -260,7 +260,7 @@ namespace osu.Game.Rulesets.Scoring
                 scoringValues.BaseScore -= result.IsHit() ? Judgement.ToNumericResult(result) : 0;
 
             if (result.IsBasic())
-                scoringValues.HitObjects--;
+                scoringValues.CountBasicHitObjects--;
         }
 
         private void updateScore()
@@ -340,7 +340,7 @@ namespace osu.Game.Rulesets.Scoring
             if (scoreInfo.IsLegacyScore && scoreInfo.Ruleset.OnlineID == 3 && maximum.BaseScore > 0)
                 accuracyRatio = current.BaseScore / maximum.BaseScore;
 
-            return ComputeScore(mode, accuracyRatio, comboRatio, current.BonusScore, maximum.HitObjects);
+            return ComputeScore(mode, accuracyRatio, comboRatio, current.BonusScore, maximum.CountBasicHitObjects);
         }
 
         /// <summary>
@@ -355,7 +355,7 @@ namespace osu.Game.Rulesets.Scoring
         {
             double accuracyRatio = maximum.BaseScore > 0 ? current.BaseScore / maximum.BaseScore : 1;
             double comboRatio = maximum.MaxCombo > 0 ? (double)current.MaxCombo / maximum.MaxCombo : 1;
-            return ComputeScore(mode, accuracyRatio, comboRatio, current.BonusScore, maximum.HitObjects);
+            return ComputeScore(mode, accuracyRatio, comboRatio, current.BonusScore, maximum.CountBasicHitObjects);
         }
 
         /// <summary>
@@ -479,11 +479,11 @@ namespace osu.Game.Rulesets.Scoring
         /// This method is useful in a variety of situations, with a few drawbacks that need to be considered:
         /// <list type="bullet">
         ///     <item>The maximum <see cref="ScoringValues.BonusScore"/> will always be 0.</item>
-        ///     <item>The current and maximum <see cref="ScoringValues.HitObjects"/> will always be the same value.</item>
+        ///     <item>The current and maximum <see cref="ScoringValues.CountBasicHitObjects"/> will always be the same value.</item>
         /// </list>
         /// Consumers are expected to more accurately fill in the above values through external means.
         /// <para>
-        /// <b>Ensure</b> to fill in the maximum <see cref="ScoringValues.HitObjects"/> for use in
+        /// <b>Ensure</b> to fill in the maximum <see cref="ScoringValues.CountBasicHitObjects"/> for use in
         /// <see cref="ComputeScore(osu.Game.Rulesets.Scoring.ScoringMode,osu.Game.Scoring.ScoringValues,osu.Game.Scoring.ScoringValues)"/>.
         /// </para>
         /// </remarks>
@@ -504,11 +504,11 @@ namespace osu.Game.Rulesets.Scoring
         /// This method is useful in a variety of situations, with a few drawbacks that need to be considered:
         /// <list type="bullet">
         ///     <item>The maximum <see cref="ScoringValues.BonusScore"/> will always be 0.</item>
-        ///     <item>The current and maximum <see cref="ScoringValues.HitObjects"/> will always be the same value.</item>
+        ///     <item>The current and maximum <see cref="ScoringValues.CountBasicHitObjects"/> will always be the same value.</item>
         /// </list>
         /// Consumers are expected to more accurately fill in the above values through external means.
         /// <para>
-        /// <b>Ensure</b> to fill in the maximum <see cref="ScoringValues.HitObjects"/> for use in
+        /// <b>Ensure</b> to fill in the maximum <see cref="ScoringValues.CountBasicHitObjects"/> for use in
         /// <see cref="ComputeScore(osu.Game.Rulesets.Scoring.ScoringMode,osu.Game.Scoring.ScoringValues,osu.Game.Scoring.ScoringValues)"/>.
         /// </para>
         /// </remarks>
@@ -530,7 +530,7 @@ namespace osu.Game.Rulesets.Scoring
         /// <list type="bullet">
         ///     <item>The current <see cref="ScoringValues.MaxCombo"/> will always be 0.</item>
         ///     <item>The maximum <see cref="ScoringValues.BonusScore"/> will always be 0.</item>
-        ///     <item>The current and maximum <see cref="ScoringValues.HitObjects"/> will always be the same value.</item>
+        ///     <item>The current and maximum <see cref="ScoringValues.CountBasicHitObjects"/> will always be the same value.</item>
         /// </list>
         /// Consumers are expected to more accurately fill in the above values (especially the current <see cref="ScoringValues.MaxCombo"/>) via external means (e.g. <see cref="ScoreInfo"/>).
         /// </remarks>
@@ -582,8 +582,8 @@ namespace osu.Game.Rulesets.Scoring
 
                 if (result.IsBasic())
                 {
-                    current.HitObjects += count;
-                    maximum.HitObjects += count;
+                    current.CountBasicHitObjects += count;
+                    maximum.CountBasicHitObjects += count;
                 }
             }
         }
diff --git a/osu.Game/Scoring/ScoringValues.cs b/osu.Game/Scoring/ScoringValues.cs
index 4b562c20e4..09ecd8e336 100644
--- a/osu.Game/Scoring/ScoringValues.cs
+++ b/osu.Game/Scoring/ScoringValues.cs
@@ -33,6 +33,6 @@ namespace osu.Game.Scoring
         /// The count of "basic" <see cref="HitObject"/>s. See: <see cref="HitResultExtensions.IsBasic"/>.
         /// </summary>
         [Key(3)]
-        public int HitObjects;
+        public int CountBasicHitObjects;
     }
 }

From 773ba971173ef2a79fa5cfe2cdc4a91b2c676af4 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 2 Jun 2022 16:39:50 +0900
Subject: [PATCH 5206/5547] Add xmldoc to ScoringValues

---
 osu.Game/Scoring/ScoringValues.cs | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/osu.Game/Scoring/ScoringValues.cs b/osu.Game/Scoring/ScoringValues.cs
index 09ecd8e336..d31cd7c68b 100644
--- a/osu.Game/Scoring/ScoringValues.cs
+++ b/osu.Game/Scoring/ScoringValues.cs
@@ -8,6 +8,9 @@ using osu.Game.Rulesets.Scoring;
 
 namespace osu.Game.Scoring
 {
+    /// <summary>
+    /// Stores the required scoring data that fulfils the minimum requirements for a <see cref="ScoreProcessor"/> to calculate score.
+    /// </summary>
     [MessagePackObject]
     public struct ScoringValues
     {

From 4abfb3561142fef1eb9e2a8b8cb2169bff0955c3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 2 Jun 2022 16:58:14 +0900
Subject: [PATCH 5207/5547] Improve light rotational alignment and increase
 light count to 8

---
 osu.Game/Screens/Edit/Timing/TapButton.cs | 13 +++++++------
 1 file changed, 7 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Screens/Edit/Timing/TapButton.cs b/osu.Game/Screens/Edit/Timing/TapButton.cs
index 4eeb358066..3b4d63f7b8 100644
--- a/osu.Game/Screens/Edit/Timing/TapButton.cs
+++ b/osu.Game/Screens/Edit/Timing/TapButton.cs
@@ -62,7 +62,7 @@ namespace osu.Game.Screens.Edit.Timing
 
         private ScheduledDelegate? resetDelegate;
 
-        private const int light_count = 6;
+        private const int light_count = 8;
 
         private const int initial_taps_to_ignore = 4;
 
@@ -70,6 +70,8 @@ namespace osu.Game.Screens.Edit.Timing
 
         private const double transition_length = 500;
 
+        private const float angular_light_gap = 0.007f;
+
         private readonly List<double> tapTimings = new List<double>();
 
         [BackgroundDependencyLoader]
@@ -185,7 +187,7 @@ namespace osu.Game.Screens.Edit.Timing
             {
                 var light = new Light
                 {
-                    Rotation = i * (360f / light_count)
+                    Rotation = (i + 1) * (360f / light_count) + 360 * angular_light_gap / 2,
                 };
 
                 lights.Add(light);
@@ -336,6 +338,7 @@ namespace osu.Game.Screens.Edit.Timing
                 light.Hide();
 
             tapTimings.Clear();
+            currentLight = 0;
             IsHandlingTapping.Value = false;
         }
 
@@ -357,14 +360,12 @@ namespace osu.Game.Screens.Edit.Timing
 
                 Size = new Vector2(0.98f); // Avoid bleed into masking edge.
 
-                const float angular_gap = 0.007f;
-
                 InternalChildren = new Drawable[]
                 {
                     new CircularProgress
                     {
                         RelativeSizeAxes = Axes.Both,
-                        Current = { Value = 1f / light_count - angular_gap },
+                        Current = { Value = 1f / light_count - angular_light_gap },
                         Colour = colourProvider.Background2,
                     },
                     fillContent = new Container
@@ -377,7 +378,7 @@ namespace osu.Game.Screens.Edit.Timing
                             new CircularProgress
                             {
                                 RelativeSizeAxes = Axes.Both,
-                                Current = { Value = 1f / light_count - angular_gap },
+                                Current = { Value = 1f / light_count - angular_light_gap },
                                 Blending = BlendingParameters.Additive
                             },
                             // Please do not try and make sense of this.

From e75609dfb9dd33cc30ffb5779da80e9988c7031b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 2 Jun 2022 17:03:48 +0900
Subject: [PATCH 5208/5547] Increase taps to consider for better results for
 longer tap periods

---
 osu.Game/Screens/Edit/Timing/TapButton.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Edit/Timing/TapButton.cs b/osu.Game/Screens/Edit/Timing/TapButton.cs
index 3b4d63f7b8..5453fcd68d 100644
--- a/osu.Game/Screens/Edit/Timing/TapButton.cs
+++ b/osu.Game/Screens/Edit/Timing/TapButton.cs
@@ -66,7 +66,7 @@ namespace osu.Game.Screens.Edit.Timing
 
         private const int initial_taps_to_ignore = 4;
 
-        private const int max_taps_to_consider = 8;
+        private const int max_taps_to_consider = 16;
 
         private const double transition_length = 500;
 

From ee4beefd9584358229f2478f0aee7ef3e98cc093 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 2 Jun 2022 17:27:51 +0900
Subject: [PATCH 5209/5547] Increase max taps to 128 for now

Will revisit this in the future with a more sound algorithm.
---
 osu.Game/Screens/Edit/Timing/TapButton.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Edit/Timing/TapButton.cs b/osu.Game/Screens/Edit/Timing/TapButton.cs
index 5453fcd68d..a6227cbe27 100644
--- a/osu.Game/Screens/Edit/Timing/TapButton.cs
+++ b/osu.Game/Screens/Edit/Timing/TapButton.cs
@@ -66,7 +66,7 @@ namespace osu.Game.Screens.Edit.Timing
 
         private const int initial_taps_to_ignore = 4;
 
-        private const int max_taps_to_consider = 16;
+        private const int max_taps_to_consider = 128;
 
         private const double transition_length = 500;
 

From c42485cea9314356e93c507d42516cc00ac36c6e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 2 Jun 2022 17:29:39 +0900
Subject: [PATCH 5210/5547] Fix test button references

---
 .../Editing/TestSceneTapTimingControl.cs      | 54 +++++++++----------
 1 file changed, 24 insertions(+), 30 deletions(-)

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneTapTimingControl.cs b/osu.Game.Tests/Visual/Editing/TestSceneTapTimingControl.cs
index 8dd368f2a9..a1218aa3e7 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneTapTimingControl.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneTapTimingControl.cs
@@ -11,7 +11,7 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps.ControlPoints;
 using osu.Game.Graphics.Sprites;
-using osu.Game.Graphics.UserInterfaceV2;
+using osu.Game.Graphics.UserInterface;
 using osu.Game.Overlays;
 using osu.Game.Screens.Edit;
 using osu.Game.Screens.Edit.Timing;
@@ -77,34 +77,6 @@ namespace osu.Game.Tests.Visual.Editing
                 timingInfo.Text = $"offset: {selectedGroup.Value.Time:N2} bpm: {selectedGroup.Value.ControlPoints.OfType<TimingControlPoint>().First().BPM:N2}";
         }
 
-        [Test]
-        public void TestNoop()
-        {
-            AddStep("do nothing", () => { });
-        }
-
-        [Test]
-        public void TestTapThenReset()
-        {
-            AddStep("click tap button", () =>
-            {
-                control.ChildrenOfType<RoundedButton>()
-                       .Last()
-                       .TriggerClick();
-            });
-
-            AddUntilStep("wait for track playing", () => Clock.IsRunning);
-
-            AddStep("click reset button", () =>
-            {
-                control.ChildrenOfType<RoundedButton>()
-                       .First()
-                       .TriggerClick();
-            });
-
-            AddUntilStep("wait for track stopped", () => !Clock.IsRunning);
-        }
-
         [Test]
         public void TestBasic()
         {
@@ -115,7 +87,7 @@ namespace osu.Game.Tests.Visual.Editing
 
             AddStep("click tap button", () =>
             {
-                control.ChildrenOfType<RoundedButton>()
+                control.ChildrenOfType<OsuButton>()
                        .Last()
                        .TriggerClick();
             });
@@ -129,6 +101,28 @@ namespace osu.Game.Tests.Visual.Editing
             });
         }
 
+        [Test]
+        public void TestTapThenReset()
+        {
+            AddStep("click tap button", () =>
+            {
+                control.ChildrenOfType<OsuButton>()
+                       .Last()
+                       .TriggerClick();
+            });
+
+            AddUntilStep("wait for track playing", () => Clock.IsRunning);
+
+            AddStep("click reset button", () =>
+            {
+                control.ChildrenOfType<OsuButton>()
+                       .First()
+                       .TriggerClick();
+            });
+
+            AddUntilStep("wait for track stopped", () => !Clock.IsRunning);
+        }
+
         protected override void Dispose(bool isDisposing)
         {
             Beatmap.Disabled = false;

From 5a0f716bf24b8613564f75eb293e9b76699144fd Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 2 Jun 2022 18:14:26 +0900
Subject: [PATCH 5211/5547] Fix timing screen crash when attempting to add
 group to self

Closes #18527.
---
 osu.Game/Screens/Edit/Timing/TimingScreen.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Edit/Timing/TimingScreen.cs b/osu.Game/Screens/Edit/Timing/TimingScreen.cs
index 40e6e8082a..8b1f881f88 100644
--- a/osu.Game/Screens/Edit/Timing/TimingScreen.cs
+++ b/osu.Game/Screens/Edit/Timing/TimingScreen.cs
@@ -189,7 +189,7 @@ namespace osu.Game.Screens.Edit.Timing
                     // Try and create matching types from the currently selected control point.
                     var selected = selectedGroup.Value;
 
-                    if (selected != null)
+                    if (selected != null && selected != group)
                     {
                         foreach (var controlPoint in selected.ControlPoints)
                         {

From 0b125ade4c439b1c3a664b683f1040f95cb58efc Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 2 Jun 2022 18:18:18 +0900
Subject: [PATCH 5212/5547] Allow clicking away to deselect the current control
 point group

---
 osu.Game/Screens/Edit/Timing/TimingScreen.cs | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/osu.Game/Screens/Edit/Timing/TimingScreen.cs b/osu.Game/Screens/Edit/Timing/TimingScreen.cs
index 40e6e8082a..fabc087952 100644
--- a/osu.Game/Screens/Edit/Timing/TimingScreen.cs
+++ b/osu.Game/Screens/Edit/Timing/TimingScreen.cs
@@ -7,6 +7,7 @@ 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.Beatmaps.ControlPoints;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.UserInterface;
@@ -132,6 +133,12 @@ namespace osu.Game.Screens.Edit.Timing
                 }, true);
             }
 
+            protected override bool OnClick(ClickEvent e)
+            {
+                selectedGroup.Value = null;
+                return true;
+            }
+
             protected override void Update()
             {
                 base.Update();

From 2fa4d46f73f2e4ec778605acf9b9fc6c69b1fad5 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 2 Jun 2022 18:28:13 +0900
Subject: [PATCH 5213/5547] Change text on timing group add button when it is
 going to clone instead

Also disables the button when it would otherwise have no effect.
---
 osu.Game/Screens/Edit/Timing/TimingScreen.cs | 16 +++++++++++++---
 1 file changed, 13 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Screens/Edit/Timing/TimingScreen.cs b/osu.Game/Screens/Edit/Timing/TimingScreen.cs
index 40e6e8082a..c6ac859cce 100644
--- a/osu.Game/Screens/Edit/Timing/TimingScreen.cs
+++ b/osu.Game/Screens/Edit/Timing/TimingScreen.cs
@@ -51,6 +51,8 @@ namespace osu.Game.Screens.Edit.Timing
 
             private readonly IBindableList<ControlPointGroup> controlPointGroups = new BindableList<ControlPointGroup>();
 
+            private RoundedButton addButton;
+
             [Resolved]
             private EditorClock clock { get; set; }
 
@@ -105,9 +107,8 @@ namespace osu.Game.Screens.Edit.Timing
                                 Anchor = Anchor.BottomRight,
                                 Origin = Anchor.BottomRight,
                             },
-                            new RoundedButton
+                            addButton = new RoundedButton
                             {
-                                Text = "+ Add at current time",
                                 Action = addNew,
                                 Size = new Vector2(160, 30),
                                 Anchor = Anchor.BottomRight,
@@ -122,7 +123,14 @@ namespace osu.Game.Screens.Edit.Timing
             {
                 base.LoadComplete();
 
-                selectedGroup.BindValueChanged(selected => { deleteButton.Enabled.Value = selected.NewValue != null; }, true);
+                selectedGroup.BindValueChanged(selected =>
+                {
+                    deleteButton.Enabled.Value = selected.NewValue != null;
+
+                    addButton.Text = selected.NewValue != null
+                        ? "+ Clone to current time"
+                        : "+ Add at current time";
+                }, true);
 
                 controlPointGroups.BindTo(Beatmap.ControlPointInfo.Groups);
                 controlPointGroups.BindCollectionChanged((sender, args) =>
@@ -137,6 +145,8 @@ namespace osu.Game.Screens.Edit.Timing
                 base.Update();
 
                 trackActivePoint();
+
+                addButton.Enabled.Value = clock.CurrentTimeAccurate != selectedGroup.Value?.Time;
             }
 
             /// <summary>

From ad3c093a084cf035b2982a4497937fcbdfaa2551 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 2 Jun 2022 18:33:09 +0900
Subject: [PATCH 5214/5547] Improve group tracking logic to avoid switching
 which point type unnecessarily

---
 osu.Game/Screens/Edit/Timing/TimingScreen.cs | 20 +++++++++++++++++---
 1 file changed, 17 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Screens/Edit/Timing/TimingScreen.cs b/osu.Game/Screens/Edit/Timing/TimingScreen.cs
index 40e6e8082a..aba6b2f23e 100644
--- a/osu.Game/Screens/Edit/Timing/TimingScreen.cs
+++ b/osu.Game/Screens/Edit/Timing/TimingScreen.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 osu.Framework.Allocation;
 using osu.Framework.Bindables;
@@ -139,6 +140,8 @@ namespace osu.Game.Screens.Edit.Timing
                 trackActivePoint();
             }
 
+            private Type trackedType;
+
             /// <summary>
             /// Given the user has selected a control point group, we want to track any group which is
             /// active at the current point in time which matches the type the user has selected.
@@ -149,16 +152,27 @@ namespace osu.Game.Screens.Edit.Timing
             private void trackActivePoint()
             {
                 // For simplicity only match on the first type of the active control point.
-                var selectedPointType = selectedGroup.Value?.ControlPoints.FirstOrDefault()?.GetType();
+                if (selectedGroup.Value == null)
+                    trackedType = null;
+                else
+                {
+                    // If the selected group only has one control point, update the tracking type.
+                    if (selectedGroup.Value.ControlPoints.Count == 1)
+                        trackedType = selectedGroup.Value?.ControlPoints.Single().GetType();
+                    // 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.
+                    else if (trackedType == null)
+                        trackedType = selectedGroup.Value?.ControlPoints.FirstOrDefault()?.GetType();
+                }
 
-                if (selectedPointType != null)
+                if (trackedType != null)
                 {
                     // 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() == selectedPointType))
+                                       .Where(g => g.ControlPoints.Any(cp => cp.GetType() == trackedType))
                                        .LastOrDefault(g => g.Time <= clock.CurrentTimeAccurate);
 
                     if (found != null)

From b1ffffc1acfbf216103b4a683db98800d7f883ca Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 2 Jun 2022 19:16:31 +0900
Subject: [PATCH 5215/5547] Calculate true combo value in
 ManiaDifficultyCalculator

---
 .../Difficulty/ManiaDifficultyCalculator.cs            | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Mania/Difficulty/ManiaDifficultyCalculator.cs b/osu.Game.Rulesets.Mania/Difficulty/ManiaDifficultyCalculator.cs
index b17aa7fc4d..88f51bf961 100644
--- a/osu.Game.Rulesets.Mania/Difficulty/ManiaDifficultyCalculator.cs
+++ b/osu.Game.Rulesets.Mania/Difficulty/ManiaDifficultyCalculator.cs
@@ -52,10 +52,18 @@ namespace osu.Game.Rulesets.Mania.Difficulty
                 // This is done the way it is to introduce fractional differences in order to match osu-stable for the time being.
                 GreatHitWindow = Math.Ceiling((int)(getHitWindow300(mods) * clockRate) / clockRate),
                 ScoreMultiplier = getScoreMultiplier(mods),
-                MaxCombo = beatmap.HitObjects.Sum(h => h is HoldNote ? 2 : 1),
+                MaxCombo = beatmap.HitObjects.Sum(maxComboForObject)
             };
         }
 
+        private static int maxComboForObject(HitObject hitObject)
+        {
+            if (hitObject is HoldNote hold)
+                return 1 + (int)((hold.EndTime - hold.StartTime) / 100);
+
+            return 1;
+        }
+
         protected override IEnumerable<DifficultyHitObject> CreateDifficultyHitObjects(IBeatmap beatmap, double clockRate)
         {
             var sortedObjects = beatmap.HitObjects.ToArray();

From a287fd73bbc81ca412d7b67fb33783483ed5b964 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 2 Jun 2022 19:16:38 +0900
Subject: [PATCH 5216/5547] Write MaxCombo attribute for mania

---
 .../Difficulty/ManiaDifficultyAttributes.cs                    | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Mania/Difficulty/ManiaDifficultyAttributes.cs b/osu.Game.Rulesets.Mania/Difficulty/ManiaDifficultyAttributes.cs
index 5b7a460079..c35a3dcdc2 100644
--- a/osu.Game.Rulesets.Mania/Difficulty/ManiaDifficultyAttributes.cs
+++ b/osu.Game.Rulesets.Mania/Difficulty/ManiaDifficultyAttributes.cs
@@ -29,7 +29,7 @@ namespace osu.Game.Rulesets.Mania.Difficulty
             foreach (var v in base.ToDatabaseAttributes())
                 yield return v;
 
-            // Todo: osu!mania doesn't output MaxCombo attribute for some reason.
+            yield return (ATTRIB_ID_MAX_COMBO, MaxCombo);
             yield return (ATTRIB_ID_DIFFICULTY, StarRating);
             yield return (ATTRIB_ID_GREAT_HIT_WINDOW, GreatHitWindow);
             yield return (ATTRIB_ID_SCORE_MULTIPLIER, ScoreMultiplier);
@@ -39,6 +39,7 @@ namespace osu.Game.Rulesets.Mania.Difficulty
         {
             base.FromDatabaseAttributes(values);
 
+            MaxCombo = (int)values[ATTRIB_ID_MAX_COMBO];
             StarRating = values[ATTRIB_ID_DIFFICULTY];
             GreatHitWindow = values[ATTRIB_ID_GREAT_HIT_WINDOW];
             ScoreMultiplier = values[ATTRIB_ID_SCORE_MULTIPLIER];

From ec24b32fa69a85fccd9df7da892397eb2b90e41b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 2 Jun 2022 20:36:28 +0200
Subject: [PATCH 5217/5547] Add NRT coverage for `FileChooserLabelledTextBox`

---
 .../Screens/Edit/Setup/FileChooserLabelledTextBox.cs   | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Screens/Edit/Setup/FileChooserLabelledTextBox.cs b/osu.Game/Screens/Edit/Setup/FileChooserLabelledTextBox.cs
index aae19396db..790613fc74 100644
--- a/osu.Game/Screens/Edit/Setup/FileChooserLabelledTextBox.cs
+++ b/osu.Game/Screens/Edit/Setup/FileChooserLabelledTextBox.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.
 
+#nullable enable
+
 using System;
 using System.Collections.Generic;
 using System.IO;
@@ -27,10 +29,10 @@ namespace osu.Game.Screens.Edit.Setup
 
         public IEnumerable<string> HandledExtensions => handledExtensions;
 
-        private readonly Bindable<FileInfo> currentFile = new Bindable<FileInfo>();
+        private readonly Bindable<FileInfo?> currentFile = new Bindable<FileInfo?>();
 
         [Resolved]
-        private OsuGameBase game { get; set; }
+        private OsuGameBase game { get; set; } = null!;
 
         public FileChooserLabelledTextBox(params string[] handledExtensions)
         {
@@ -45,7 +47,7 @@ namespace osu.Game.Screens.Edit.Setup
             currentFile.BindValueChanged(onFileSelected);
         }
 
-        private void onFileSelected(ValueChangedEvent<FileInfo> file)
+        private void onFileSelected(ValueChangedEvent<FileInfo?> file)
         {
             if (file.NewValue == null)
                 return;
@@ -72,7 +74,7 @@ namespace osu.Game.Screens.Edit.Setup
 
         private class FileChooserPopover : OsuPopover
         {
-            public FileChooserPopover(string[] handledExtensions, Bindable<FileInfo> currentFile)
+            public FileChooserPopover(string[] handledExtensions, Bindable<FileInfo?> currentFile)
             {
                 Child = new Container
                 {

From cf9b78ea2a11f1c44d90bfa1702ad3daad4d4173 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 2 Jun 2022 20:38:14 +0200
Subject: [PATCH 5218/5547] Improve safety of `FileChooserLabelledTextBox`
 disposal

---
 osu.Game/Screens/Edit/Setup/FileChooserLabelledTextBox.cs | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Edit/Setup/FileChooserLabelledTextBox.cs b/osu.Game/Screens/Edit/Setup/FileChooserLabelledTextBox.cs
index 790613fc74..fd916894ea 100644
--- a/osu.Game/Screens/Edit/Setup/FileChooserLabelledTextBox.cs
+++ b/osu.Game/Screens/Edit/Setup/FileChooserLabelledTextBox.cs
@@ -11,6 +11,7 @@ using System.Threading.Tasks;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Extensions;
+using osu.Framework.Extensions.ObjectExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.UserInterface;
@@ -67,7 +68,9 @@ namespace osu.Game.Screens.Edit.Setup
         protected override void Dispose(bool isDisposing)
         {
             base.Dispose(isDisposing);
-            game.UnregisterImportHandler(this);
+
+            if (game.IsNotNull())
+                game.UnregisterImportHandler(this);
         }
 
         public override Popover GetPopover() => new FileChooserPopover(handledExtensions, currentFile);

From 6f1437e73dcb62e2253d4285fc34c8b33f37e9dd Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 2 Jun 2022 21:15:11 +0200
Subject: [PATCH 5219/5547] Fix compilation failure due not applying rename
 fully

---
 .../Multiplayer/MultiplayerGameplayLeaderboardTestScene.cs      | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/MultiplayerGameplayLeaderboardTestScene.cs b/osu.Game.Tests/Visual/Multiplayer/MultiplayerGameplayLeaderboardTestScene.cs
index 5e125c1a62..a738debecc 100644
--- a/osu.Game.Tests/Visual/Multiplayer/MultiplayerGameplayLeaderboardTestScene.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/MultiplayerGameplayLeaderboardTestScene.cs
@@ -119,7 +119,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
                         {
                             BaseScore = 10000,
                             MaxCombo = 1000,
-                            HitObjects = 1000
+                            CountBasicHitObjects = 1000
                         }
                     };
                 }

From 60fb5d5e6c721b6a975356524869a4785bee2f70 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 3 Jun 2022 02:03:04 +0300
Subject: [PATCH 5220/5547] Revert "Fix timeline objects disappearing
 prematurely on wide-screens"

This reverts commit 02baf9a97abe0fb6e94af53b83708a15a508d437.
---
 osu.Game/Screens/Edit/Compose/Components/Timeline/Timeline.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/Timeline.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/Timeline.cs
index 733b6c5f24..89e9fb2404 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/Timeline.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/Timeline.cs
@@ -304,7 +304,7 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
         /// <summary>
         /// The total amount of time visible on the timeline.
         /// </summary>
-        public double VisibleRange => (DisplayableContent / Content.DrawWidth) * track.Length;
+        public double VisibleRange => track.Length / Zoom;
 
         public SnapResult FindSnappedPositionAndTime(Vector2 screenSpacePosition, SnapType snapType = SnapType.All) =>
             new SnapResult(screenSpacePosition, beatSnapProvider.SnapTime(getTimeFromPosition(Content.ToLocalSpace(screenSpacePosition))));

From ca68751fdcd1c3b0a01ead44e776600f0127e05b Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 3 Jun 2022 02:22:16 +0300
Subject: [PATCH 5221/5547] Update test to match expectation

---
 osu.Game.Tests/Visual/Editing/TestSceneTimelineZoom.cs | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneTimelineZoom.cs b/osu.Game.Tests/Visual/Editing/TestSceneTimelineZoom.cs
index 10f1f2fceb..d726bd004e 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneTimelineZoom.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneTimelineZoom.cs
@@ -12,7 +12,7 @@ namespace osu.Game.Tests.Visual.Editing
         public override Drawable CreateTestComponent() => Empty();
 
         [Test]
-        public void TestVisibleRangeViaZoom()
+        public void TestVisibleRangeUpdatesOnZoomChange()
         {
             double initialVisibleRange = 0;
 
@@ -29,7 +29,7 @@ namespace osu.Game.Tests.Visual.Editing
         }
 
         [Test]
-        public void TestVisibleRangeViaTimelineSize()
+        public void TestVisibleRangeConstantOnSizeChange()
         {
             double initialVisibleRange = 0;
 
@@ -37,12 +37,12 @@ namespace osu.Game.Tests.Visual.Editing
             AddStep("get initial range", () => initialVisibleRange = TimelineArea.Timeline.VisibleRange);
 
             AddStep("scale timeline size", () => TimelineArea.Timeline.Width = 2);
-            AddAssert("range doubled", () => TimelineArea.Timeline.VisibleRange == initialVisibleRange * 2);
+            AddAssert("same range", () => TimelineArea.Timeline.VisibleRange == initialVisibleRange);
             AddStep("descale timeline size", () => TimelineArea.Timeline.Width = 0.5f);
-            AddAssert("range halved", () => TimelineArea.Timeline.VisibleRange == initialVisibleRange / 2);
+            AddAssert("same range", () => TimelineArea.Timeline.VisibleRange == initialVisibleRange);
 
             AddStep("restore timeline size", () => TimelineArea.Timeline.Width = 1);
-            AddAssert("range restored", () => TimelineArea.Timeline.VisibleRange == initialVisibleRange);
+            AddAssert("same range", () => TimelineArea.Timeline.VisibleRange == initialVisibleRange);
         }
     }
 }

From 588151f48b3afde6d8e006daaa235367d5583a7d Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 3 Jun 2022 02:26:46 +0300
Subject: [PATCH 5222/5547] Add new failing test coverage

---
 .../Editing/TestSceneZoomableScrollContainer.cs | 17 +++++++++++++++--
 1 file changed, 15 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneZoomableScrollContainer.cs b/osu.Game.Tests/Visual/Editing/TestSceneZoomableScrollContainer.cs
index 95d11d6909..2d056bafdd 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneZoomableScrollContainer.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneZoomableScrollContainer.cs
@@ -44,7 +44,12 @@ namespace osu.Game.Tests.Visual.Editing
                                 RelativeSizeAxes = Axes.Both,
                                 Colour = OsuColour.Gray(30)
                             },
-                            scrollContainer = new ZoomableScrollContainer { RelativeSizeAxes = Axes.Both }
+                            scrollContainer = new ZoomableScrollContainer
+                            {
+                                Anchor = Anchor.Centre,
+                                Origin = Anchor.Centre,
+                                RelativeSizeAxes = Axes.Both,
+                            }
                         }
                     },
                     new MenuCursor()
@@ -62,7 +67,15 @@ namespace osu.Game.Tests.Visual.Editing
         [Test]
         public void TestWidthInitialization()
         {
-            AddAssert("Inner container width was initialized", () => innerBox.DrawWidth > 0);
+            AddAssert("Inner container width was initialized", () => innerBox.DrawWidth == scrollContainer.DrawWidth);
+        }
+
+        [Test]
+        public void TestWidthUpdatesOnDrawSizeChanges()
+        {
+            AddStep("Shrink scroll container", () => scrollContainer.Width = 0.5f);
+            AddAssert("Scroll container width shrunk", () => scrollContainer.DrawWidth == scrollContainer.Parent.DrawWidth / 2);
+            AddAssert("Inner container width matches scroll container", () => innerBox.DrawWidth == scrollContainer.DrawWidth);
         }
 
         [Test]

From 21385655fed9137e350811f66b5ff9ae418f0ada Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 3 Jun 2022 02:27:16 +0300
Subject: [PATCH 5223/5547] Fix `ZoomableScrollContainer` not updating on
 parent size changes

---
 .../Timeline/ZoomableScrollContainer.cs       | 21 +++++++++++++------
 1 file changed, 15 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/ZoomableScrollContainer.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/ZoomableScrollContainer.cs
index 35d103ddf1..d008368b69 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/ZoomableScrollContainer.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/ZoomableScrollContainer.cs
@@ -7,6 +7,7 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Transforms;
 using osu.Framework.Input.Events;
+using osu.Framework.Layout;
 using osu.Framework.Timing;
 using osu.Framework.Utils;
 using osu.Game.Graphics.Containers;
@@ -40,10 +41,14 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
         [Resolved(canBeNull: true)]
         private IFrameBasedClock editorClock { get; set; }
 
+        private readonly LayoutValue zoomedContentWidthCache = new LayoutValue(Invalidation.DrawSize);
+
         public ZoomableScrollContainer()
             : base(Direction.Horizontal)
         {
             base.Content.Add(zoomedContent = new Container { RelativeSizeAxes = Axes.Y });
+
+            AddLayout(zoomedContentWidthCache);
         }
 
         private float minZoom = 1;
@@ -103,12 +108,12 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
             }
         }
 
-        protected override void LoadComplete()
+        protected override void Update()
         {
-            base.LoadComplete();
+            base.Update();
 
-            // This width only gets updated on the application of a transform, so this needs to be initialized here.
-            updateZoomedContentWidth();
+            if (!zoomedContentWidthCache.IsValid)
+                updateZoomedContentWidth();
         }
 
         protected override bool OnScroll(ScrollEvent e)
@@ -128,7 +133,11 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
             return base.OnScroll(e);
         }
 
-        private void updateZoomedContentWidth() => zoomedContent.Width = DrawWidth * currentZoom;
+        private void updateZoomedContentWidth()
+        {
+            zoomedContent.Width = DrawWidth * currentZoom;
+            zoomedContentWidthCache.Validate();
+        }
 
         private float zoomTarget = 1;
 
@@ -199,8 +208,8 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
                 float targetOffset = expectedWidth * (focusPoint / contentSize) - focusOffset;
 
                 d.currentZoom = newZoom;
-
                 d.updateZoomedContentWidth();
+
                 // Temporarily here to make sure ScrollTo gets the correct DrawSize for scrollable area.
                 // TODO: Make sure draw size gets invalidated properly on the framework side, and remove this once it is.
                 d.Invalidate(Invalidation.DrawSize);

From efbde06c11229a3a8501ece576b1a10c13cc70ae Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 3 Jun 2022 05:02:00 +0300
Subject: [PATCH 5224/5547] Split button repeating logic from
 `TimingAdjustButton` to own component

---
 .../Edit/Timing/RepeatingButtonBehaviour.cs   | 93 +++++++++++++++++++
 .../Screens/Edit/Timing/TimingAdjustButton.cs | 80 ++++------------
 2 files changed, 110 insertions(+), 63 deletions(-)
 create mode 100644 osu.Game/Screens/Edit/Timing/RepeatingButtonBehaviour.cs

diff --git a/osu.Game/Screens/Edit/Timing/RepeatingButtonBehaviour.cs b/osu.Game/Screens/Edit/Timing/RepeatingButtonBehaviour.cs
new file mode 100644
index 0000000000..5c9f384a2e
--- /dev/null
+++ b/osu.Game/Screens/Edit/Timing/RepeatingButtonBehaviour.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;
+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.Input.Events;
+using osu.Framework.Threading;
+
+namespace osu.Game.Screens.Edit.Timing
+{
+    /// <summary>
+    /// Represents a component that provides the behaviour of triggering button clicks repeatedly while holding with mouse.
+    /// </summary>
+    public class RepeatingButtonBehaviour : CompositeDrawable
+    {
+        private const double initial_delay = 300;
+        private const double minimum_delay = 80;
+
+        private readonly Drawable button;
+
+        private Sample sample;
+
+        /// <summary>
+        /// An additive modifier for the frequency of the sample played on next actuation.
+        /// This can be adjusted during the button's <see cref="Drawable.OnClick"/> event to affect the repeat sample playback of that click.
+        /// </summary>
+        public double SampleFrequencyModifier { get; set; }
+
+        public RepeatingButtonBehaviour(Drawable button)
+        {
+            this.button = button;
+
+            RelativeSizeAxes = Axes.Both;
+        }
+
+        [BackgroundDependencyLoader]
+        private void load(AudioManager audio)
+        {
+            sample = audio.Samples.Get(@"UI/notch-tick");
+        }
+
+        protected override bool OnMouseDown(MouseDownEvent e)
+        {
+            beginRepeat();
+            return true;
+        }
+
+        protected override void OnMouseUp(MouseUpEvent e)
+        {
+            adjustDelegate?.Cancel();
+            base.OnMouseUp(e);
+        }
+
+        private ScheduledDelegate adjustDelegate;
+        private double adjustDelay = initial_delay;
+
+        private void beginRepeat()
+        {
+            adjustDelegate?.Cancel();
+
+            adjustDelay = initial_delay;
+            adjustNext();
+
+            void adjustNext()
+            {
+                if (IsHovered)
+                {
+                    button.TriggerClick();
+                    adjustDelay = Math.Max(minimum_delay, adjustDelay * 0.9f);
+
+                    var channel = sample?.GetChannel();
+
+                    if (channel != null)
+                    {
+                        double repeatModifier = 0.05f * (Math.Abs(adjustDelay - initial_delay) / minimum_delay);
+                        channel.Frequency.Value = 1 + repeatModifier + SampleFrequencyModifier;
+                        channel.Play();
+                    }
+                }
+                else
+                {
+                    adjustDelay = initial_delay;
+                }
+
+                adjustDelegate = Scheduler.AddDelayed(adjustNext, adjustDelay);
+            }
+        }
+    }
+}
diff --git a/osu.Game/Screens/Edit/Timing/TimingAdjustButton.cs b/osu.Game/Screens/Edit/Timing/TimingAdjustButton.cs
index 9fc7e56a3d..6e7338fa15 100644
--- a/osu.Game/Screens/Edit/Timing/TimingAdjustButton.cs
+++ b/osu.Game/Screens/Edit/Timing/TimingAdjustButton.cs
@@ -4,14 +4,11 @@
 using System;
 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;
 using osu.Framework.Input.Events;
 using osu.Framework.Localisation;
-using osu.Framework.Threading;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Overlays;
@@ -26,32 +23,24 @@ namespace osu.Game.Screens.Edit.Timing
         public Action<double> Action;
 
         private readonly double adjustAmount;
-        private ScheduledDelegate adjustDelegate;
 
         private const int max_multiplier = 10;
-
         private const int adjust_levels = 4;
 
-        private const double initial_delay = 300;
-
-        private const double minimum_delay = 80;
-
         public Container Content { get; set; }
 
-        private double adjustDelay = initial_delay;
-
         private readonly Box background;
 
         private readonly OsuSpriteText text;
 
-        private Sample sample;
-
         public LocalisableString Text
         {
             get => text.Text;
             set => text.Text = value;
         }
 
+        private readonly RepeatingButtonBehaviour repeatBehaviour;
+
         [Resolved]
         private OverlayColourProvider colourProvider { get; set; }
 
@@ -82,13 +71,13 @@ namespace osu.Game.Screens.Edit.Timing
                     }
                 }
             });
+
+            AddInternal(repeatBehaviour = new RepeatingButtonBehaviour(this));
         }
 
         [BackgroundDependencyLoader]
-        private void load(AudioManager audio)
+        private void load()
         {
-            sample = audio.Samples.Get(@"UI/notch-tick");
-
             background.Colour = colourProvider.Background3;
 
             for (int i = 1; i <= adjust_levels; i++)
@@ -98,57 +87,22 @@ namespace osu.Game.Screens.Edit.Timing
             }
         }
 
-        protected override bool OnMouseDown(MouseDownEvent e)
+        protected override bool OnHover(HoverEvent e) => true;
+
+        protected override bool OnClick(ClickEvent e)
         {
-            beginRepeat();
+            var hoveredBox = Content.OfType<IncrementBox>().FirstOrDefault(d => d.IsHovered);
+            if (hoveredBox == null)
+                return false;
+
+            Action(adjustAmount * hoveredBox.Multiplier);
+
+            hoveredBox.Flash();
+
+            repeatBehaviour.SampleFrequencyModifier = (hoveredBox.Multiplier / max_multiplier) * 0.2;
             return true;
         }
 
-        protected override void OnMouseUp(MouseUpEvent e)
-        {
-            adjustDelegate?.Cancel();
-            base.OnMouseUp(e);
-        }
-
-        private void beginRepeat()
-        {
-            adjustDelegate?.Cancel();
-
-            adjustDelay = initial_delay;
-            adjustNext();
-
-            void adjustNext()
-            {
-                var hoveredBox = Content.OfType<IncrementBox>().FirstOrDefault(d => d.IsHovered);
-
-                if (hoveredBox != null)
-                {
-                    Action(adjustAmount * hoveredBox.Multiplier);
-
-                    adjustDelay = Math.Max(minimum_delay, adjustDelay * 0.9f);
-
-                    hoveredBox.Flash();
-
-                    var channel = sample?.GetChannel();
-
-                    if (channel != null)
-                    {
-                        double repeatModifier = 0.05f * (Math.Abs(adjustDelay - initial_delay) / minimum_delay);
-                        double multiplierModifier = (hoveredBox.Multiplier / max_multiplier) * 0.2f;
-
-                        channel.Frequency.Value = 1 + multiplierModifier + repeatModifier;
-                        channel.Play();
-                    }
-                }
-                else
-                {
-                    adjustDelay = initial_delay;
-                }
-
-                adjustDelegate = Scheduler.AddDelayed(adjustNext, adjustDelay);
-            }
-        }
-
         private class IncrementBox : CompositeDrawable
         {
             public readonly float Multiplier;

From b51e0a50472e2415928a38dd9263bdfa04e3e8d5 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 3 Jun 2022 05:03:22 +0300
Subject: [PATCH 5225/5547] Share button repeating logic with `TimelineButton`
 for better UX

---
 .../Components/Timeline/TimelineButton.cs     | 47 ++-----------------
 1 file changed, 5 insertions(+), 42 deletions(-)

diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineButton.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineButton.cs
index 5550c6a748..4c0c0335dd 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineButton.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineButton.cs
@@ -6,13 +6,11 @@ using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Sprites;
-using osu.Framework.Input.Events;
-using osu.Framework.Threading;
 using osu.Game.Graphics;
 using osu.Game.Graphics.UserInterface;
+using osu.Game.Screens.Edit.Timing;
 using osuTK;
 using osuTK.Graphics;
-using osuTK.Input;
 
 namespace osu.Game.Screens.Edit.Compose.Components.Timeline
 {
@@ -27,7 +25,7 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
             set => button.Icon = value;
         }
 
-        private readonly IconButton button;
+        private readonly TimelineIconButton button;
 
         public TimelineButton()
         {
@@ -54,46 +52,11 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
                 IconHoverColour = Color4.White;
                 HoverColour = OsuColour.Gray(0.25f);
                 FlashColour = OsuColour.Gray(0.5f);
+
+                Add(new RepeatingButtonBehaviour(this));
             }
 
-            private ScheduledDelegate repeatSchedule;
-
-            /// <summary>
-            /// The initial delay before mouse down repeat begins.
-            /// </summary>
-            private const int repeat_initial_delay = 250;
-
-            /// <summary>
-            /// The delay between mouse down repeats after the initial repeat.
-            /// </summary>
-            private const int repeat_tick_rate = 70;
-
-            protected override bool OnClick(ClickEvent e)
-            {
-                // don't actuate a click since we are manually handling repeats.
-                return true;
-            }
-
-            protected override bool OnMouseDown(MouseDownEvent e)
-            {
-                if (e.Button == MouseButton.Left)
-                {
-                    Action clickAction = () => base.OnClick(new ClickEvent(e.CurrentState, e.Button));
-
-                    // run once for initial down
-                    clickAction();
-
-                    Scheduler.Add(repeatSchedule = new ScheduledDelegate(clickAction, Clock.CurrentTime + repeat_initial_delay, repeat_tick_rate));
-                }
-
-                return base.OnMouseDown(e);
-            }
-
-            protected override void OnMouseUp(MouseUpEvent e)
-            {
-                repeatSchedule?.Cancel();
-                base.OnMouseUp(e);
-            }
+            protected override HoverSounds CreateHoverSounds(HoverSampleSet sampleSet) => new HoverSounds(sampleSet);
         }
     }
 }

From 1b4c89c418a66aecadac765be1560f1ad3d4a215 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 3 Jun 2022 14:01:04 +0900
Subject: [PATCH 5226/5547] Update realm to latest version

Contains minor changes to async usage in line with upstream API changes.

I believe a feedback issue we were seeing with offset changes (the only
component using async write flow) may have been resolved by these
upstream changes (see [release
notes](https://github.com/realm/realm-dotnet/releases/tag/10.14.0)) but
am not investigating further just yet.
---
 osu.Game.Tests/Database/BeatmapImporterTests.cs | 2 +-
 osu.Game/Database/RealmAccess.cs                | 2 +-
 osu.Game/osu.Game.csproj                        | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Tests/Database/BeatmapImporterTests.cs b/osu.Game.Tests/Database/BeatmapImporterTests.cs
index 00276955aa..d4956e97e0 100644
--- a/osu.Game.Tests/Database/BeatmapImporterTests.cs
+++ b/osu.Game.Tests/Database/BeatmapImporterTests.cs
@@ -710,7 +710,7 @@ namespace osu.Game.Tests.Database
 
                 var imported = await LoadOszIntoStore(importer, realm.Realm);
 
-                realm.Realm.Write(() =>
+                await realm.Realm.WriteAsync(() =>
                 {
                     foreach (var b in imported.Beatmaps)
                         b.OnlineID = -1;
diff --git a/osu.Game/Database/RealmAccess.cs b/osu.Game/Database/RealmAccess.cs
index dbd3b96763..086ec52d80 100644
--- a/osu.Game/Database/RealmAccess.cs
+++ b/osu.Game/Database/RealmAccess.cs
@@ -392,7 +392,7 @@ namespace osu.Game.Database
         {
             total_writes_async.Value++;
             using (var realm = getRealmInstance())
-                await realm.WriteAsync(action);
+                await realm.WriteAsync(() => action(realm));
         }
 
         /// <summary>
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index eb47d0468f..97a36e9bc6 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="10.11.2" />
+    <PackageReference Include="Realm" Version="10.14.0" />
     <PackageReference Include="ppy.osu.Framework" Version="2022.530.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.527.0" />
     <PackageReference Include="Sentry" Version="3.17.1" />

From f224a3e922d5d8953b5c1446bb3aad4d0d11d363 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 3 Jun 2022 14:18:47 +0900
Subject: [PATCH 5227/5547] Update silly mobile project references

---
 osu.Android.props | 2 +-
 osu.iOS.props     | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Android.props b/osu.Android.props
index 116c7dbfcd..35d902493e 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -56,6 +56,6 @@
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
     <!-- Realm needs to be directly referenced in all Xamarin projects, as it will not pull in its transitive dependencies otherwise. -->
-    <PackageReference Include="Realm" Version="10.11.2" />
+    <PackageReference Include="Realm" Version="10.14.0" />
   </ItemGroup>
 </Project>
diff --git a/osu.iOS.props b/osu.iOS.props
index ccecad6f82..64ba7fe22e 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -89,6 +89,6 @@
     <PackageReference Include="NUnit" Version="3.13.3" />
     <PackageReference Include="System.ComponentModel.Annotations" Version="5.0.0" />
     <PackageReference Include="ppy.osu.Framework.NativeLibs" Version="2022.429.0" ExcludeAssets="all" />
-    <PackageReference Include="Realm" Version="10.11.2" />
+    <PackageReference Include="Realm" Version="10.14.0" />
   </ItemGroup>
 </Project>

From 3aa8bc933dc45f8c5428e0f8a5e9a73aa51e651f Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 3 Jun 2022 08:21:35 +0300
Subject: [PATCH 5228/5547] Add sentry tag for selected beatmap

---
 osu.Game/Utils/SentryLogger.cs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Game/Utils/SentryLogger.cs b/osu.Game/Utils/SentryLogger.cs
index ecc7fc4774..bba1e514c5 100644
--- a/osu.Game/Utils/SentryLogger.cs
+++ b/osu.Game/Utils/SentryLogger.cs
@@ -159,6 +159,7 @@ namespace osu.Game.Utils
                         Game = game.Clock.CurrentTime,
                     };
 
+                    scope.SetTag(@"beatmap", $"{beatmap.OnlineID}");
                     scope.SetTag(@"ruleset", ruleset.ShortName);
                     scope.SetTag(@"os", $"{RuntimeInfo.OS} ({Environment.OSVersion})");
                     scope.SetTag(@"processor count", Environment.ProcessorCount.ToString());

From 6cb8b2d6f47f64591d9aa3e6768a68f23c582a1e Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 3 Jun 2022 09:37:17 +0300
Subject: [PATCH 5229/5547] Set default window mode to "Borderless" rather than
 "Fullscreen" on macOS

---
 osu.Game/OsuGame.cs | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index 785881d97a..1c25c45bc3 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -9,6 +9,7 @@ using System.Threading;
 using System.Threading.Tasks;
 using Humanizer;
 using JetBrains.Annotations;
+using osu.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
 using osu.Framework.Bindables;
@@ -658,11 +659,14 @@ namespace osu.Game
         }
 
         protected override IDictionary<FrameworkSetting, object> GetFrameworkConfigDefaults()
-            => new Dictionary<FrameworkSetting, object>
+        {
+            return new Dictionary<FrameworkSetting, object>
             {
-                // General expectation that osu! starts in fullscreen by default (also gives the most predictable performance)
-                { FrameworkSetting.WindowMode, WindowMode.Fullscreen }
+                // 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.IsApple ? WindowMode.Borderless : WindowMode.Fullscreen }
             };
+        }
 
         protected override void LoadComplete()
         {

From 1af51a2b1919a39bb90d63b1edfd1e29f6f18dad Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 3 Jun 2022 16:00:40 +0900
Subject: [PATCH 5230/5547] Update framework

---
 osu.Android.props        | 2 +-
 osu.Game/osu.Game.csproj | 2 +-
 osu.iOS.props            | 4 ++--
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Android.props b/osu.Android.props
index 35d902493e..d5f0d32b80 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -52,7 +52,7 @@
   </ItemGroup>
   <ItemGroup>
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.527.0" />
-    <PackageReference Include="ppy.osu.Framework.Android" Version="2022.530.0" />
+    <PackageReference Include="ppy.osu.Framework.Android" Version="2022.603.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
     <!-- Realm needs to be directly referenced in all Xamarin projects, as it will not pull in its transitive dependencies otherwise. -->
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 97a36e9bc6..45e7ff91c0 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="10.14.0" />
-    <PackageReference Include="ppy.osu.Framework" Version="2022.530.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2022.603.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.527.0" />
     <PackageReference Include="Sentry" Version="3.17.1" />
     <PackageReference Include="SharpCompress" Version="0.31.0" />
diff --git a/osu.iOS.props b/osu.iOS.props
index 64ba7fe22e..16b7d49f3f 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -61,7 +61,7 @@
     <Reference Include="System.Net.Http" />
   </ItemGroup>
   <ItemGroup Label="Package References">
-    <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.530.0" />
+    <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.603.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.527.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net6.0) -->
@@ -84,7 +84,7 @@
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="5.0.14" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.Core" Version="5.0.14" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
-    <PackageReference Include="ppy.osu.Framework" Version="2022.530.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2022.603.0" />
     <PackageReference Include="SharpCompress" Version="0.31.0" />
     <PackageReference Include="NUnit" Version="3.13.3" />
     <PackageReference Include="System.ComponentModel.Annotations" Version="5.0.0" />

From eb2d822530227d303d2d10f661a2a544c3f1a3ae Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 2 Jun 2022 14:28:48 +0900
Subject: [PATCH 5231/5547] Fix web requests potentially being performed after
 cancelled

Closes https://github.com/ppy/osu/issues/18524.
---
 osu.Game/Online/API/APIRequest.cs | 12 ++++++++++--
 1 file changed, 10 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Online/API/APIRequest.cs b/osu.Game/Online/API/APIRequest.cs
index 776ff5fd8f..451ea117d5 100644
--- a/osu.Game/Online/API/APIRequest.cs
+++ b/osu.Game/Online/API/APIRequest.cs
@@ -121,8 +121,16 @@ namespace osu.Game.Online.API
 
             if (isFailing) return;
 
-            Logger.Log($@"Performing request {this}", LoggingTarget.Network);
-            WebRequest.Perform();
+            try
+            {
+                Logger.Log($@"Performing request {this}", LoggingTarget.Network);
+                WebRequest.Perform();
+            }
+            catch (OperationCanceledException)
+            {
+                // ignore this. internally Perform is running async and the fail state may have changed since
+                // the last check of `isFailing` above.
+            }
 
             if (isFailing) return;
 

From 54a32bde44fd1fdc421a47fbd2b9cc89978d5703 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 3 Jun 2022 16:29:55 +0900
Subject: [PATCH 5232/5547] Don't report sentry errors from builds targetting a
 different server

---
 osu.Game/OsuGameBase.cs        | 5 ++++-
 osu.Game/Utils/SentryLogger.cs | 2 +-
 2 files changed, 5 insertions(+), 2 deletions(-)

diff --git a/osu.Game/OsuGameBase.cs b/osu.Game/OsuGameBase.cs
index 666413004a..5dbdf6f602 100644
--- a/osu.Game/OsuGameBase.cs
+++ b/osu.Game/OsuGameBase.cs
@@ -80,6 +80,9 @@ namespace osu.Game
 
         public virtual bool UseDevelopmentServer => DebugUtils.IsDebugBuild;
 
+        internal EndpointConfiguration CreateEndpoints() =>
+            UseDevelopmentServer ? (EndpointConfiguration)new DevelopmentEndpointConfiguration() : new ProductionEndpointConfiguration();
+
         public virtual Version AssemblyVersion => Assembly.GetEntryAssembly()?.GetName().Version ?? new Version();
 
         /// <summary>
@@ -268,7 +271,7 @@ namespace osu.Game
             dependencies.Cache(SkinManager = new SkinManager(Storage, realm, Host, Resources, Audio, Scheduler));
             dependencies.CacheAs<ISkinSource>(SkinManager);
 
-            EndpointConfiguration endpoints = UseDevelopmentServer ? (EndpointConfiguration)new DevelopmentEndpointConfiguration() : new ProductionEndpointConfiguration();
+            EndpointConfiguration endpoints = CreateEndpoints();
 
             MessageFormatter.WebsiteRootUrl = endpoints.WebsiteRootUrl;
 
diff --git a/osu.Game/Utils/SentryLogger.cs b/osu.Game/Utils/SentryLogger.cs
index bba1e514c5..c12fd607b4 100644
--- a/osu.Game/Utils/SentryLogger.cs
+++ b/osu.Game/Utils/SentryLogger.cs
@@ -43,7 +43,7 @@ namespace osu.Game.Utils
             sentrySession = SentrySdk.Init(options =>
             {
                 // Not setting the dsn will completely disable sentry.
-                if (game.IsDeployedBuild)
+                if (game.IsDeployedBuild && game.CreateEndpoints().WebsiteRootUrl.EndsWith(@".ppy.sh", StringComparison.Ordinal))
                     options.Dsn = "https://ad9f78529cef40ac874afb95a9aca04e@sentry.ppy.sh/2";
 
                 options.AutoSessionTracking = true;

From 1a835f062213c8d86fddaa73e30f33f75245996d Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 3 Jun 2022 10:23:38 +0300
Subject: [PATCH 5233/5547] Add warning note when running fullscreen on macOS

---
 osu.Game/Localisation/LayoutSettingsStrings.cs             | 5 +++++
 .../Overlays/Settings/Sections/Graphics/LayoutSettings.cs  | 7 +++++++
 2 files changed, 12 insertions(+)

diff --git a/osu.Game/Localisation/LayoutSettingsStrings.cs b/osu.Game/Localisation/LayoutSettingsStrings.cs
index 5ac28f19b3..8b7ad5918b 100644
--- a/osu.Game/Localisation/LayoutSettingsStrings.cs
+++ b/osu.Game/Localisation/LayoutSettingsStrings.cs
@@ -24,6 +24,11 @@ namespace osu.Game.Localisation
         /// </summary>
         public static LocalisableString UnableToRunExclusiveFullscreen => new TranslatableString(getKey(@"unable_to_run_exclusive_fullscreen"), @"Unable to run exclusive fullscreen. You'll still experience some input latency.");
 
+        /// <summary>
+        /// "Running fullscreen on macOS takes full control away from the system, this could lead to system-wide freezes if the game becomes unresponsive."
+        /// </summary>
+        public static LocalisableString FullscreenMacOSNote => new TranslatableString(getKey(@"fullscreen_macos_note"), @"Running fullscreen on macOS takes full control away from the system, this could lead to system-wide freezes if the game becomes unresponsive.");
+
         private static string getKey(string key) => $@"{prefix}:{key}";
     }
 }
\ No newline at end of file
diff --git a/osu.Game/Overlays/Settings/Sections/Graphics/LayoutSettings.cs b/osu.Game/Overlays/Settings/Sections/Graphics/LayoutSettings.cs
index d79ba593f7..53b6f89c1f 100644
--- a/osu.Game/Overlays/Settings/Sections/Graphics/LayoutSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Graphics/LayoutSettings.cs
@@ -4,6 +4,7 @@
 using System;
 using System.Drawing;
 using System.Linq;
+using osu.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Configuration;
@@ -230,6 +231,12 @@ namespace osu.Game.Overlays.Settings.Sections.Graphics
                 return;
             }
 
+            if (RuntimeInfo.OS == RuntimeInfo.Platform.macOS)
+            {
+                windowModeDropdown.SetNoticeText(LayoutSettingsStrings.FullscreenMacOSNote, true);
+                return;
+            }
+
             if (host.Window is WindowsWindow)
             {
                 switch (fullscreenCapability.Value)

From 3ad1180c48c1856a5f10640d4688e4c2be25b245 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 3 Jun 2022 10:32:43 +0300
Subject: [PATCH 5234/5547] Use `macOS` instead of `IsApple` for better safety

---
 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 1c25c45bc3..b91d523151 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -664,7 +664,7 @@ 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.IsApple ? WindowMode.Borderless : WindowMode.Fullscreen }
+                { FrameworkSetting.WindowMode, RuntimeInfo.OS == RuntimeInfo.Platform.macOS ? WindowMode.Borderless : WindowMode.Fullscreen }
             };
         }
 

From e779b460e42cb89f4a196035164dda9f4cae9dd5 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 3 Jun 2022 16:49:08 +0900
Subject: [PATCH 5235/5547] Use `Component` instead of `CompositeDrawable`

---
 osu.Game/Screens/Edit/Timing/RepeatingButtonBehaviour.cs | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/osu.Game/Screens/Edit/Timing/RepeatingButtonBehaviour.cs b/osu.Game/Screens/Edit/Timing/RepeatingButtonBehaviour.cs
index 5c9f384a2e..595305b20f 100644
--- a/osu.Game/Screens/Edit/Timing/RepeatingButtonBehaviour.cs
+++ b/osu.Game/Screens/Edit/Timing/RepeatingButtonBehaviour.cs
@@ -6,7 +6,6 @@ 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.Input.Events;
 using osu.Framework.Threading;
 
@@ -15,7 +14,7 @@ namespace osu.Game.Screens.Edit.Timing
     /// <summary>
     /// Represents a component that provides the behaviour of triggering button clicks repeatedly while holding with mouse.
     /// </summary>
-    public class RepeatingButtonBehaviour : CompositeDrawable
+    public class RepeatingButtonBehaviour : Component
     {
         private const double initial_delay = 300;
         private const double minimum_delay = 80;

From 902a0a3255d2773988e74eaa27dc9a061c79b56d Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 3 Jun 2022 16:50:42 +0900
Subject: [PATCH 5236/5547] Update max combo test value

---
 .../ManiaDifficultyCalculatorTest.cs                          | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Rulesets.Mania.Tests/ManiaDifficultyCalculatorTest.cs b/osu.Game.Rulesets.Mania.Tests/ManiaDifficultyCalculatorTest.cs
index 715614a201..a5bd126782 100644
--- a/osu.Game.Rulesets.Mania.Tests/ManiaDifficultyCalculatorTest.cs
+++ b/osu.Game.Rulesets.Mania.Tests/ManiaDifficultyCalculatorTest.cs
@@ -14,11 +14,11 @@ namespace osu.Game.Rulesets.Mania.Tests
     {
         protected override string ResourceAssembly => "osu.Game.Rulesets.Mania";
 
-        [TestCase(2.3449735700206298d, 151, "diffcalc-test")]
+        [TestCase(2.3449735700206298d, 242, "diffcalc-test")]
         public void Test(double expectedStarRating, int expectedMaxCombo, string name)
             => base.Test(expectedStarRating, expectedMaxCombo, name);
 
-        [TestCase(2.7879104989252959d, 151, "diffcalc-test")]
+        [TestCase(2.7879104989252959d, 242, "diffcalc-test")]
         public void TestClockRateAdjusted(double expectedStarRating, int expectedMaxCombo, string name)
             => Test(expectedStarRating, expectedMaxCombo, name, new ManiaModDoubleTime());
 

From 7b28451e3d872d03fac0411e189da2642a0426a2 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 3 Jun 2022 10:50:52 +0300
Subject: [PATCH 5237/5547] Improve warning message for user

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

diff --git a/osu.Game/Localisation/LayoutSettingsStrings.cs b/osu.Game/Localisation/LayoutSettingsStrings.cs
index 8b7ad5918b..b4326b8e39 100644
--- a/osu.Game/Localisation/LayoutSettingsStrings.cs
+++ b/osu.Game/Localisation/LayoutSettingsStrings.cs
@@ -25,10 +25,10 @@ namespace osu.Game.Localisation
         public static LocalisableString UnableToRunExclusiveFullscreen => new TranslatableString(getKey(@"unable_to_run_exclusive_fullscreen"), @"Unable to run exclusive fullscreen. You'll still experience some input latency.");
 
         /// <summary>
-        /// "Running fullscreen on macOS takes full control away from the system, this could lead to system-wide freezes if the game becomes unresponsive."
+        /// "Using fullscreen on macOS makes interacting with the menu bar and spaces no longer work, and may lead to freezes if a system dialog is presented. Using borderless is recommended."
         /// </summary>
-        public static LocalisableString FullscreenMacOSNote => new TranslatableString(getKey(@"fullscreen_macos_note"), @"Running fullscreen on macOS takes full control away from the system, this could lead to system-wide freezes if the game becomes unresponsive.");
+        public static LocalisableString FullscreenMacOSNote => new TranslatableString(getKey(@"fullscreen_macos_note"), @"Using fullscreen on macOS makes interacting with the menu bar and spaces no longer work, and may lead to freezes if a system dialog is presented. Using borderless is recommended.");
 
         private static string getKey(string key) => $@"{prefix}:{key}";
     }
-}
\ No newline at end of file
+}

From cd999cf7ac936756f055fe57e88b20d6af6c47ed Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 3 Jun 2022 10:51:20 +0300
Subject: [PATCH 5238/5547] Fix back-to-front conditional

---
 .../Settings/Sections/Graphics/LayoutSettings.cs     | 12 ++++++++----
 1 file changed, 8 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Overlays/Settings/Sections/Graphics/LayoutSettings.cs b/osu.Game/Overlays/Settings/Sections/Graphics/LayoutSettings.cs
index 53b6f89c1f..05890ad882 100644
--- a/osu.Game/Overlays/Settings/Sections/Graphics/LayoutSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Graphics/LayoutSettings.cs
@@ -225,15 +225,19 @@ namespace osu.Game.Overlays.Settings.Sections.Graphics
 
         private void updateScreenModeWarning()
         {
-            if (windowModeDropdown.Current.Value != WindowMode.Fullscreen)
+            if (RuntimeInfo.OS == RuntimeInfo.Platform.macOS)
             {
-                windowModeDropdown.SetNoticeText(GraphicsSettingsStrings.NotFullscreenNote, true);
+                if (windowModeDropdown.Current.Value == WindowMode.Fullscreen)
+                    windowModeDropdown.SetNoticeText(LayoutSettingsStrings.FullscreenMacOSNote, true);
+                else
+                    windowModeDropdown.ClearNoticeText();
+
                 return;
             }
 
-            if (RuntimeInfo.OS == RuntimeInfo.Platform.macOS)
+            if (windowModeDropdown.Current.Value != WindowMode.Fullscreen)
             {
-                windowModeDropdown.SetNoticeText(LayoutSettingsStrings.FullscreenMacOSNote, true);
+                windowModeDropdown.SetNoticeText(GraphicsSettingsStrings.NotFullscreenNote, true);
                 return;
             }
 

From cd3edc869c3455fd77aa0348566faccd079a1b97 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 3 Jun 2022 17:00:00 +0900
Subject: [PATCH 5239/5547] Remove unnecessary nesting of `IconButton` and
 update design a touch

---
 .../Components/Timeline/TimelineButton.cs     | 63 +++++--------------
 1 file changed, 15 insertions(+), 48 deletions(-)

diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineButton.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineButton.cs
index 4c0c0335dd..e0b21b2e22 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineButton.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineButton.cs
@@ -1,62 +1,29 @@
 // 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.Graphics;
-using osu.Framework.Graphics.Containers;
-using osu.Framework.Graphics.Sprites;
-using osu.Game.Graphics;
+using osu.Framework.Allocation;
 using osu.Game.Graphics.UserInterface;
+using osu.Game.Overlays;
 using osu.Game.Screens.Edit.Timing;
-using osuTK;
-using osuTK.Graphics;
 
 namespace osu.Game.Screens.Edit.Compose.Components.Timeline
 {
-    public class TimelineButton : CompositeDrawable
+    public class TimelineButton : IconButton
     {
-        public Action Action;
-        public readonly BindableBool Enabled = new BindableBool(true);
-
-        public IconUsage Icon
+        [BackgroundDependencyLoader]
+        private void load(OverlayColourProvider colourProvider)
         {
-            get => button.Icon;
-            set => button.Icon = value;
+            // These are using colourProvider but don't match the design.
+            // Just something to fit until someone implements the updated design.
+            IconColour = colourProvider.Background1;
+            IconHoverColour = colourProvider.Content2;
+
+            HoverColour = colourProvider.Background1;
+            FlashColour = colourProvider.Content2;
+
+            Add(new RepeatingButtonBehaviour(this));
         }
 
-        private readonly TimelineIconButton button;
-
-        public TimelineButton()
-        {
-            InternalChild = button = new TimelineIconButton { Action = () => Action?.Invoke() };
-
-            button.Enabled.BindTo(Enabled);
-            Width = button.Width;
-        }
-
-        protected override void Update()
-        {
-            base.Update();
-
-            button.Size = new Vector2(button.Width, DrawHeight);
-        }
-
-        private class TimelineIconButton : IconButton
-        {
-            public TimelineIconButton()
-            {
-                Anchor = Anchor.Centre;
-                Origin = Anchor.Centre;
-                IconColour = OsuColour.Gray(0.35f);
-                IconHoverColour = Color4.White;
-                HoverColour = OsuColour.Gray(0.25f);
-                FlashColour = OsuColour.Gray(0.5f);
-
-                Add(new RepeatingButtonBehaviour(this));
-            }
-
-            protected override HoverSounds CreateHoverSounds(HoverSampleSet sampleSet) => new HoverSounds(sampleSet);
-        }
+        protected override HoverSounds CreateHoverSounds(HoverSampleSet sampleSet) => new HoverSounds(sampleSet);
     }
 }

From 2aabcf51ae9271d51ed97d6b425115d31d8bea9d Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 3 Jun 2022 18:47:07 +0900
Subject: [PATCH 5240/5547] Update framework again

---
 osu.Android.props        | 2 +-
 osu.Game/osu.Game.csproj | 2 +-
 osu.iOS.props            | 4 ++--
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Android.props b/osu.Android.props
index d5f0d32b80..0058bb3577 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -52,7 +52,7 @@
   </ItemGroup>
   <ItemGroup>
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.527.0" />
-    <PackageReference Include="ppy.osu.Framework.Android" Version="2022.603.0" />
+    <PackageReference Include="ppy.osu.Framework.Android" Version="2022.603.1" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
     <!-- Realm needs to be directly referenced in all Xamarin projects, as it will not pull in its transitive dependencies otherwise. -->
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 45e7ff91c0..2285f61331 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="10.14.0" />
-    <PackageReference Include="ppy.osu.Framework" Version="2022.603.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2022.603.1" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.527.0" />
     <PackageReference Include="Sentry" Version="3.17.1" />
     <PackageReference Include="SharpCompress" Version="0.31.0" />
diff --git a/osu.iOS.props b/osu.iOS.props
index 16b7d49f3f..b134a7e356 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -61,7 +61,7 @@
     <Reference Include="System.Net.Http" />
   </ItemGroup>
   <ItemGroup Label="Package References">
-    <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.603.0" />
+    <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.603.1" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.527.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net6.0) -->
@@ -84,7 +84,7 @@
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="5.0.14" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.Core" Version="5.0.14" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
-    <PackageReference Include="ppy.osu.Framework" Version="2022.603.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2022.603.1" />
     <PackageReference Include="SharpCompress" Version="0.31.0" />
     <PackageReference Include="NUnit" Version="3.13.3" />
     <PackageReference Include="System.ComponentModel.Annotations" Version="5.0.0" />

From 646f5f0f33c47efb4fcfd6656bc470209ff538c3 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 3 Jun 2022 19:17:31 +0900
Subject: [PATCH 5241/5547] Isolate "server-side" multiplayer rooms in testing

---
 osu.Game/Online/Rooms/Room.cs                          |  7 +++++++
 .../Tests/Visual/OnlinePlay/TestRoomRequestsHandler.cs | 10 +++++-----
 2 files changed, 12 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Online/Rooms/Room.cs b/osu.Game/Online/Rooms/Room.cs
index 60c0503ddd..1933267efd 100644
--- a/osu.Game/Online/Rooms/Room.cs
+++ b/osu.Game/Online/Rooms/Room.cs
@@ -162,6 +162,13 @@ namespace osu.Game.Online.Rooms
             Password.BindValueChanged(p => HasPassword.Value = !string.IsNullOrEmpty(p.NewValue));
         }
 
+        /// <summary>
+        /// Copies values from another <see cref="Room"/> into this one.
+        /// </summary>
+        /// <remarks>
+        /// **Beware**: This will store references between <see cref="Room"/>s.
+        /// </remarks>
+        /// <param name="other">The <see cref="Room"/> to copy values from.</param>
         public void CopyFrom(Room other)
         {
             RoomID.Value = other.RoomID.Value;
diff --git a/osu.Game/Tests/Visual/OnlinePlay/TestRoomRequestsHandler.cs b/osu.Game/Tests/Visual/OnlinePlay/TestRoomRequestsHandler.cs
index 8290af8f78..392f32badc 100644
--- a/osu.Game/Tests/Visual/OnlinePlay/TestRoomRequestsHandler.cs
+++ b/osu.Game/Tests/Visual/OnlinePlay/TestRoomRequestsHandler.cs
@@ -4,6 +4,7 @@
 using System;
 using System.Collections.Generic;
 using System.Linq;
+using Newtonsoft.Json;
 using osu.Game.Beatmaps;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests;
@@ -44,9 +45,7 @@ namespace osu.Game.Tests.Visual.OnlinePlay
             switch (request)
             {
                 case CreateRoomRequest createRoomRequest:
-                    var apiRoom = new Room();
-
-                    apiRoom.CopyFrom(createRoomRequest.Room);
+                    var apiRoom = cloneRoom(createRoomRequest.Room);
 
                     // Passwords are explicitly not copied between rooms.
                     apiRoom.HasPassword.Value = !string.IsNullOrEmpty(createRoomRequest.Room.Password.Value);
@@ -178,12 +177,13 @@ namespace osu.Game.Tests.Visual.OnlinePlay
 
         private Room createResponseRoom(Room room, bool withParticipants)
         {
-            var responseRoom = new Room();
-            responseRoom.CopyFrom(room);
+            var responseRoom = cloneRoom(room);
             responseRoom.Password.Value = null;
             if (!withParticipants)
                 responseRoom.RecentParticipants.Clear();
             return responseRoom;
         }
+
+        private Room cloneRoom(Room source) => JsonConvert.DeserializeObject<Room>(JsonConvert.SerializeObject(source));
     }
 }

From 524599568919c6b03c0fa3fc19f3ea69b77ab094 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 3 Jun 2022 19:50:21 +0900
Subject: [PATCH 5242/5547] Use IsNotNull() helper

---
 osu.Game/Online/Spectator/SpectatorScoreProcessor.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Online/Spectator/SpectatorScoreProcessor.cs b/osu.Game/Online/Spectator/SpectatorScoreProcessor.cs
index c1829a7023..a1e8715c8f 100644
--- a/osu.Game/Online/Spectator/SpectatorScoreProcessor.cs
+++ b/osu.Game/Online/Spectator/SpectatorScoreProcessor.cs
@@ -9,6 +9,7 @@ using System.Diagnostics;
 using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
+using osu.Framework.Extensions.ObjectExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Timing;
 using osu.Game.Rulesets;
@@ -165,8 +166,7 @@ namespace osu.Game.Online.Spectator
         {
             base.Dispose(isDisposing);
 
-            // ReSharper disable once ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract
-            if (spectatorClient != null)
+            if (spectatorClient.IsNotNull())
                 spectatorClient.OnNewFrames -= onNewFrames;
         }
 

From 68337df64377032faa9b86538164dacb30551fcf Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 3 Jun 2022 20:04:20 +0900
Subject: [PATCH 5243/5547] Fix tests by creating a score processor

---
 osu.Game/Tests/Gameplay/TestGameplayState.cs | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Tests/Gameplay/TestGameplayState.cs b/osu.Game/Tests/Gameplay/TestGameplayState.cs
index 0d00f52d15..f14f8c44ec 100644
--- a/osu.Game/Tests/Gameplay/TestGameplayState.cs
+++ b/osu.Game/Tests/Gameplay/TestGameplayState.cs
@@ -26,7 +26,10 @@ namespace osu.Game.Tests.Gameplay
             var workingBeatmap = new TestWorkingBeatmap(beatmap);
             var playableBeatmap = workingBeatmap.GetPlayableBeatmap(ruleset.RulesetInfo, mods);
 
-            return new GameplayState(playableBeatmap, ruleset, mods, score);
+            var scoreProcessor = ruleset.CreateScoreProcessor();
+            scoreProcessor.ApplyBeatmap(playableBeatmap);
+
+            return new GameplayState(playableBeatmap, ruleset, mods, score, scoreProcessor);
         }
     }
 }

From 77289c72249566cea9fd1fc10854af4cddca4cb5 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 3 Jun 2022 20:36:11 +0900
Subject: [PATCH 5244/5547] Fix inability to serialise-then-deserialise
 playlist items

---
 osu.Game/Online/Rooms/PlaylistItem.cs | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Online/Rooms/PlaylistItem.cs b/osu.Game/Online/Rooms/PlaylistItem.cs
index 6ec884d79c..12091bae88 100644
--- a/osu.Game/Online/Rooms/PlaylistItem.cs
+++ b/osu.Game/Online/Rooms/PlaylistItem.cs
@@ -61,7 +61,13 @@ namespace osu.Game.Online.Rooms
         /// Used for serialising to the API.
         /// </summary>
         [JsonProperty("beatmap_id")]
-        private int onlineBeatmapId => Beatmap.OnlineID;
+        private int onlineBeatmapId
+        {
+            get => Beatmap.OnlineID;
+            // This setter is only required for client-side serialise-then-deserialise operations.
+            // Serialisation is supposed to emit only a `beatmap_id`, but a (non-null) `beatmap` is required on deserialise.
+            set => Beatmap = new APIBeatmap { OnlineID = value };
+        }
 
         /// <summary>
         /// A beatmap representing this playlist item.

From 41ff170b6043d67308673182765837e10fabca6c Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 3 Jun 2022 21:12:09 +0900
Subject: [PATCH 5245/5547] Fix playlist IDs not being returned

---
 .../Visual/OnlinePlay/TestRoomRequestsHandler.cs  | 15 ++++++++++++++-
 1 file changed, 14 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Tests/Visual/OnlinePlay/TestRoomRequestsHandler.cs b/osu.Game/Tests/Visual/OnlinePlay/TestRoomRequestsHandler.cs
index 392f32badc..3a668d6931 100644
--- a/osu.Game/Tests/Visual/OnlinePlay/TestRoomRequestsHandler.cs
+++ b/osu.Game/Tests/Visual/OnlinePlay/TestRoomRequestsHandler.cs
@@ -3,6 +3,7 @@
 
 using System;
 using System.Collections.Generic;
+using System.Diagnostics;
 using System.Linq;
 using Newtonsoft.Json;
 using osu.Game.Beatmaps;
@@ -184,6 +185,18 @@ namespace osu.Game.Tests.Visual.OnlinePlay
             return responseRoom;
         }
 
-        private Room cloneRoom(Room source) => JsonConvert.DeserializeObject<Room>(JsonConvert.SerializeObject(source));
+        private Room cloneRoom(Room source)
+        {
+            var result = JsonConvert.DeserializeObject<Room>(JsonConvert.SerializeObject(source));
+            Debug.Assert(result != null);
+
+            // Playlist item IDs aren't serialised.
+            if (source.CurrentPlaylistItem.Value != null)
+                result.CurrentPlaylistItem.Value.ID = source.CurrentPlaylistItem.Value.ID;
+            for (int i = 0; i < source.Playlist.Count; i++)
+                result.Playlist[i].ID = source.Playlist[i].ID;
+
+            return result;
+        }
     }
 }

From 06ac3c1ad353bdbe25caba972759eb531bd5c5d2 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 3 Jun 2022 21:12:28 +0900
Subject: [PATCH 5246/5547] Make MultiplayerClient update CurrentPlaylistItem

---
 osu.Game/Online/Multiplayer/MultiplayerClient.cs | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/osu.Game/Online/Multiplayer/MultiplayerClient.cs b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
index cae675b406..c95f3fa579 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
@@ -197,6 +197,7 @@ namespace osu.Game.Online.Multiplayer
 
                     APIRoom.Playlist.Clear();
                     APIRoom.Playlist.AddRange(joinedRoom.Playlist.Select(createPlaylistItem));
+                    APIRoom.CurrentPlaylistItem.Value = APIRoom.Playlist.Single(item => item.ID == joinedRoom.Settings.PlaylistItemId);
 
                     Debug.Assert(LocalUser != null);
                     addUserToAPIRoom(LocalUser);
@@ -737,6 +738,7 @@ namespace osu.Game.Online.Multiplayer
             APIRoom.Type.Value = Room.Settings.MatchType;
             APIRoom.QueueMode.Value = Room.Settings.QueueMode;
             APIRoom.AutoStartDuration.Value = Room.Settings.AutoStartDuration;
+            APIRoom.CurrentPlaylistItem.Value = APIRoom.Playlist.Single(item => item.ID == settings.PlaylistItemId);
 
             RoomUpdated?.Invoke();
         }

From 3df4d1b0e6328da0d20d1d24e36508666bdb1afb Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 3 Jun 2022 21:17:47 +0900
Subject: [PATCH 5247/5547] Fix incorrect HasPassword value for returned rooms

---
 osu.Game/Tests/Visual/OnlinePlay/TestRoomRequestsHandler.cs | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/osu.Game/Tests/Visual/OnlinePlay/TestRoomRequestsHandler.cs b/osu.Game/Tests/Visual/OnlinePlay/TestRoomRequestsHandler.cs
index 3a668d6931..8fea77833e 100644
--- a/osu.Game/Tests/Visual/OnlinePlay/TestRoomRequestsHandler.cs
+++ b/osu.Game/Tests/Visual/OnlinePlay/TestRoomRequestsHandler.cs
@@ -179,9 +179,15 @@ namespace osu.Game.Tests.Visual.OnlinePlay
         private Room createResponseRoom(Room room, bool withParticipants)
         {
             var responseRoom = cloneRoom(room);
+
+            // Password is hidden from the response, and is only propagated via HasPassword.
+            bool hadPassword = responseRoom.HasPassword.Value;
             responseRoom.Password.Value = null;
+            responseRoom.HasPassword.Value = hadPassword;
+
             if (!withParticipants)
                 responseRoom.RecentParticipants.Clear();
+
             return responseRoom;
         }
 

From 365819865e04b490c30784b8fec3805a7a1fdb66 Mon Sep 17 00:00:00 2001
From: Jamie Taylor <me@nekodex.net>
Date: Wed, 1 Jun 2022 21:00:14 +0900
Subject: [PATCH 5248/5547] Remove 'submit' sample usages

---
 osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs            | 2 +-
 osu.Game/Graphics/UserInterface/BackButton.cs               | 2 +-
 osu.Game/Graphics/UserInterface/DialogButton.cs             | 4 ++--
 osu.Game/Graphics/UserInterface/ExternalLinkButton.cs       | 2 +-
 osu.Game/Graphics/UserInterface/HoverSampleSet.cs           | 3 ---
 osu.Game/Online/Chat/DrawableLinkCompiler.cs                | 1 -
 osu.Game/Overlays/News/NewsCard.cs                          | 2 --
 osu.Game/Overlays/News/Sidebar/MonthSection.cs              | 2 --
 .../Overlays/Profile/Sections/BeatmapMetadataContainer.cs   | 2 --
 osu.Game/Screens/OnlinePlay/Lounge/DrawableLoungeRoom.cs    | 2 +-
 osu.Game/Screens/Select/Options/BeatmapOptionsButton.cs     | 2 +-
 osu.Game/Users/Drawables/ClickableAvatar.cs                 | 6 ------
 osu.Game/Users/Drawables/UpdateableFlag.cs                  | 2 +-
 osu.Game/Users/UserPanel.cs                                 | 2 +-
 14 files changed, 9 insertions(+), 25 deletions(-)

diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
index 9a17d6dc9b..08aaa8da42 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
@@ -35,7 +35,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
         protected readonly BeatmapDownloadTracker DownloadTracker;
 
         protected BeatmapCard(APIBeatmapSet beatmapSet, bool allowExpansion = true)
-            : base(HoverSampleSet.Submit)
+            : base(HoverSampleSet.Button)
         {
             Expanded = new BindableBool { Disabled = !allowExpansion };
 
diff --git a/osu.Game/Graphics/UserInterface/BackButton.cs b/osu.Game/Graphics/UserInterface/BackButton.cs
index 1b564ef1b4..2b59ee0282 100644
--- a/osu.Game/Graphics/UserInterface/BackButton.cs
+++ b/osu.Game/Graphics/UserInterface/BackButton.cs
@@ -21,7 +21,7 @@ namespace osu.Game.Graphics.UserInterface
         {
             Size = TwoLayerButton.SIZE_EXTENDED;
 
-            Child = button = new TwoLayerButton(HoverSampleSet.Submit)
+            Child = button = new TwoLayerButton
             {
                 Anchor = Anchor.TopLeft,
                 Origin = Anchor.TopLeft,
diff --git a/osu.Game/Graphics/UserInterface/DialogButton.cs b/osu.Game/Graphics/UserInterface/DialogButton.cs
index ad69ec4078..69fbd744c9 100644
--- a/osu.Game/Graphics/UserInterface/DialogButton.cs
+++ b/osu.Game/Graphics/UserInterface/DialogButton.cs
@@ -56,8 +56,8 @@ namespace osu.Game.Graphics.UserInterface
         private readonly SpriteText spriteText;
         private Vector2 hoverSpacing => new Vector2(3f, 0f);
 
-        public DialogButton()
-            : base(HoverSampleSet.Submit)
+        public DialogButton(HoverSampleSet sampleSet = HoverSampleSet.Button)
+            : base(sampleSet)
         {
             RelativeSizeAxes = Axes.X;
 
diff --git a/osu.Game/Graphics/UserInterface/ExternalLinkButton.cs b/osu.Game/Graphics/UserInterface/ExternalLinkButton.cs
index 0df69a5b54..1730e1478f 100644
--- a/osu.Game/Graphics/UserInterface/ExternalLinkButton.cs
+++ b/osu.Game/Graphics/UserInterface/ExternalLinkButton.cs
@@ -36,7 +36,7 @@ namespace osu.Game.Graphics.UserInterface
                     Icon = FontAwesome.Solid.ExternalLinkAlt,
                     RelativeSizeAxes = Axes.Both
                 },
-                new HoverClickSounds(HoverSampleSet.Submit)
+                new HoverClickSounds()
             };
         }
 
diff --git a/osu.Game/Graphics/UserInterface/HoverSampleSet.cs b/osu.Game/Graphics/UserInterface/HoverSampleSet.cs
index a5ea6fcfbf..b88f81a143 100644
--- a/osu.Game/Graphics/UserInterface/HoverSampleSet.cs
+++ b/osu.Game/Graphics/UserInterface/HoverSampleSet.cs
@@ -10,9 +10,6 @@ namespace osu.Game.Graphics.UserInterface
         [Description("default")]
         Default,
 
-        [Description("submit")]
-        Submit,
-
         [Description("button")]
         Button,
 
diff --git a/osu.Game/Online/Chat/DrawableLinkCompiler.cs b/osu.Game/Online/Chat/DrawableLinkCompiler.cs
index 8356b36667..3b0d049528 100644
--- a/osu.Game/Online/Chat/DrawableLinkCompiler.cs
+++ b/osu.Game/Online/Chat/DrawableLinkCompiler.cs
@@ -38,7 +38,6 @@ namespace osu.Game.Online.Chat
         }
 
         public DrawableLinkCompiler(IEnumerable<Drawable> parts)
-            : base(HoverSampleSet.Submit)
         {
             Parts = parts.ToList();
         }
diff --git a/osu.Game/Overlays/News/NewsCard.cs b/osu.Game/Overlays/News/NewsCard.cs
index 68d0704825..5ce0b9df9c 100644
--- a/osu.Game/Overlays/News/NewsCard.cs
+++ b/osu.Game/Overlays/News/NewsCard.cs
@@ -14,7 +14,6 @@ using osu.Framework.Platform;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
-using osu.Game.Graphics.UserInterface;
 using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Overlays.News
@@ -29,7 +28,6 @@ namespace osu.Game.Overlays.News
         private TextFlowContainer main;
 
         public NewsCard(APINewsPost post)
-            : base(HoverSampleSet.Submit)
         {
             this.post = post;
 
diff --git a/osu.Game/Overlays/News/Sidebar/MonthSection.cs b/osu.Game/Overlays/News/Sidebar/MonthSection.cs
index aa83f89689..e2ce25660e 100644
--- a/osu.Game/Overlays/News/Sidebar/MonthSection.cs
+++ b/osu.Game/Overlays/News/Sidebar/MonthSection.cs
@@ -18,7 +18,6 @@ using System.Diagnostics;
 using osu.Framework.Audio;
 using osu.Framework.Audio.Sample;
 using osu.Framework.Platform;
-using osu.Game.Graphics.UserInterface;
 
 namespace osu.Game.Overlays.News.Sidebar
 {
@@ -129,7 +128,6 @@ namespace osu.Game.Overlays.News.Sidebar
             private readonly APINewsPost post;
 
             public PostButton(APINewsPost post)
-                : base(HoverSampleSet.Submit)
             {
                 this.post = post;
 
diff --git a/osu.Game/Overlays/Profile/Sections/BeatmapMetadataContainer.cs b/osu.Game/Overlays/Profile/Sections/BeatmapMetadataContainer.cs
index 94ef5e5d86..13465f3bf8 100644
--- a/osu.Game/Overlays/Profile/Sections/BeatmapMetadataContainer.cs
+++ b/osu.Game/Overlays/Profile/Sections/BeatmapMetadataContainer.cs
@@ -6,7 +6,6 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Beatmaps;
 using osu.Game.Graphics.Containers;
-using osu.Game.Graphics.UserInterface;
 
 namespace osu.Game.Overlays.Profile.Sections
 {
@@ -18,7 +17,6 @@ namespace osu.Game.Overlays.Profile.Sections
         private readonly IBeatmapInfo beatmapInfo;
 
         protected BeatmapMetadataContainer(IBeatmapInfo beatmapInfo)
-            : base(HoverSampleSet.Submit)
         {
             this.beatmapInfo = beatmapInfo;
 
diff --git a/osu.Game/Screens/OnlinePlay/Lounge/DrawableLoungeRoom.cs b/osu.Game/Screens/OnlinePlay/Lounge/DrawableLoungeRoom.cs
index 35c903eb0c..0015cf8bf9 100644
--- a/osu.Game/Screens/OnlinePlay/Lounge/DrawableLoungeRoom.cs
+++ b/osu.Game/Screens/OnlinePlay/Lounge/DrawableLoungeRoom.cs
@@ -55,7 +55,7 @@ namespace osu.Game.Screens.OnlinePlay.Lounge
         private void load(AudioManager audio)
         {
             sampleSelect = audio.Samples.Get($@"UI/{HoverSampleSet.Default.GetDescription()}-select");
-            sampleJoin = audio.Samples.Get($@"UI/{HoverSampleSet.Submit.GetDescription()}-select");
+            sampleJoin = audio.Samples.Get($@"UI/{HoverSampleSet.Button.GetDescription()}-select");
 
             AddRangeInternal(new Drawable[]
             {
diff --git a/osu.Game/Screens/Select/Options/BeatmapOptionsButton.cs b/osu.Game/Screens/Select/Options/BeatmapOptionsButton.cs
index 6ecb96f723..df7dd47ef3 100644
--- a/osu.Game/Screens/Select/Options/BeatmapOptionsButton.cs
+++ b/osu.Game/Screens/Select/Options/BeatmapOptionsButton.cs
@@ -77,7 +77,7 @@ namespace osu.Game.Screens.Select.Options
         public override bool ReceivePositionalInputAt(Vector2 screenSpacePos) => box.ReceivePositionalInputAt(screenSpacePos);
 
         public BeatmapOptionsButton()
-            : base(HoverSampleSet.Submit)
+            : base(HoverSampleSet.Button)
         {
             Width = width;
             RelativeSizeAxes = Axes.Y;
diff --git a/osu.Game/Users/Drawables/ClickableAvatar.cs b/osu.Game/Users/Drawables/ClickableAvatar.cs
index 0dd135b500..d85648c078 100644
--- a/osu.Game/Users/Drawables/ClickableAvatar.cs
+++ b/osu.Game/Users/Drawables/ClickableAvatar.cs
@@ -7,7 +7,6 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Input.Events;
 using osu.Framework.Localisation;
 using osu.Game.Graphics.Containers;
-using osu.Game.Graphics.UserInterface;
 using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Users.Drawables
@@ -74,11 +73,6 @@ namespace osu.Game.Users.Drawables
         {
             private LocalisableString tooltip = default_tooltip_text;
 
-            public ClickableArea()
-                : base(HoverSampleSet.Submit)
-            {
-            }
-
             public override LocalisableString TooltipText
             {
                 get => Enabled.Value ? tooltip : default;
diff --git a/osu.Game/Users/Drawables/UpdateableFlag.cs b/osu.Game/Users/Drawables/UpdateableFlag.cs
index e5debc0683..d0ef760e59 100644
--- a/osu.Game/Users/Drawables/UpdateableFlag.cs
+++ b/osu.Game/Users/Drawables/UpdateableFlag.cs
@@ -49,7 +49,7 @@ namespace osu.Game.Users.Drawables
                     {
                         RelativeSizeAxes = Axes.Both
                     },
-                    new HoverClickSounds(HoverSampleSet.Submit)
+                    new HoverClickSounds()
                 }
             };
         }
diff --git a/osu.Game/Users/UserPanel.cs b/osu.Game/Users/UserPanel.cs
index 248debf1d3..40d70ca406 100644
--- a/osu.Game/Users/UserPanel.cs
+++ b/osu.Game/Users/UserPanel.cs
@@ -32,7 +32,7 @@ namespace osu.Game.Users
         protected Drawable Background { get; private set; }
 
         protected UserPanel(APIUser user)
-            : base(HoverSampleSet.Submit)
+            : base(HoverSampleSet.Button)
         {
             if (user == null)
                 throw new ArgumentNullException(nameof(user));

From 2878bb592fc317b36b6f49127da42543027fb28b Mon Sep 17 00:00:00 2001
From: Jamie Taylor <me@nekodex.net>
Date: Fri, 3 Jun 2022 22:22:32 +0900
Subject: [PATCH 5249/5547] Use more appropriate sounds for certain components

---
 .../UserInterface/ShearedToggleButton.cs      |  8 ++++--
 .../Overlays/BeatmapListing/FilterTabItem.cs  |  2 +-
 .../Chat/Listing/ChannelListingItem.cs        | 27 +++++++++++++++++--
 .../Header/Components/ExpandDetailsButton.cs  |  2 +-
 4 files changed, 33 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Graphics/UserInterface/ShearedToggleButton.cs b/osu.Game/Graphics/UserInterface/ShearedToggleButton.cs
index 4780270f66..ee59da7279 100644
--- a/osu.Game/Graphics/UserInterface/ShearedToggleButton.cs
+++ b/osu.Game/Graphics/UserInterface/ShearedToggleButton.cs
@@ -13,6 +13,7 @@ namespace osu.Game.Graphics.UserInterface
 {
     public class ShearedToggleButton : ShearedButton
     {
+        private Sample? sampleClick;
         private Sample? sampleOff;
         private Sample? sampleOn;
 
@@ -39,8 +40,9 @@ namespace osu.Game.Graphics.UserInterface
         [BackgroundDependencyLoader]
         private void load(AudioManager audio)
         {
-            sampleOn = audio.Samples.Get(@"UI/check-on");
-            sampleOff = audio.Samples.Get(@"UI/check-off");
+            sampleClick = audio.Samples.Get(@"UI/default-select");
+            sampleOn = audio.Samples.Get(@"UI/dropdown-open");
+            sampleOff = audio.Samples.Get(@"UI/dropdown-close");
         }
 
         protected override HoverSounds CreateHoverSounds(HoverSampleSet sampleSet) => new HoverSounds(sampleSet);
@@ -67,6 +69,8 @@ namespace osu.Game.Graphics.UserInterface
 
         private void playSample()
         {
+            sampleClick?.Play();
+
             if (Active.Value)
                 sampleOn?.Play();
             else
diff --git a/osu.Game/Overlays/BeatmapListing/FilterTabItem.cs b/osu.Game/Overlays/BeatmapListing/FilterTabItem.cs
index 52dfcad2cc..ff43170207 100644
--- a/osu.Game/Overlays/BeatmapListing/FilterTabItem.cs
+++ b/osu.Game/Overlays/BeatmapListing/FilterTabItem.cs
@@ -40,7 +40,7 @@ namespace osu.Game.Overlays.BeatmapListing
                     Font = OsuFont.GetFont(size: 13, weight: FontWeight.Regular),
                     Text = LabelFor(Value)
                 },
-                new HoverClickSounds()
+                new HoverClickSounds(HoverSampleSet.TabSelect)
             });
 
             Enabled.Value = true;
diff --git a/osu.Game/Overlays/Chat/Listing/ChannelListingItem.cs b/osu.Game/Overlays/Chat/Listing/ChannelListingItem.cs
index 86c81d5d79..2a21d30a4a 100644
--- a/osu.Game/Overlays/Chat/Listing/ChannelListingItem.cs
+++ b/osu.Game/Overlays/Chat/Listing/ChannelListingItem.cs
@@ -6,6 +6,8 @@
 using System;
 using System.Collections.Generic;
 using osu.Framework.Allocation;
+using osu.Framework.Audio;
+using osu.Framework.Audio.Sample;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
@@ -16,6 +18,7 @@ using osu.Framework.Localisation;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
+using osu.Game.Graphics.UserInterface;
 using osu.Game.Online.Chat;
 using osuTK;
 
@@ -32,6 +35,8 @@ namespace osu.Game.Overlays.Chat.Listing
         public IEnumerable<LocalisableString> FilterTerms => new LocalisableString[] { Channel.Name, Channel.Topic ?? string.Empty };
         public bool MatchingFilter { set => this.FadeTo(value ? 1f : 0f, 100); }
 
+        protected override HoverSounds CreateHoverSounds(HoverSampleSet sampleSet) => new HoverSounds();
+
         private Box hoverBox = null!;
         private SpriteIcon checkbox = null!;
         private OsuSpriteText channelText = null!;
@@ -46,14 +51,20 @@ namespace osu.Game.Overlays.Chat.Listing
 
         private const float vertical_margin = 1.5f;
 
+        private Sample? sampleJoin;
+        private Sample? sampleLeave;
+
         public ChannelListingItem(Channel channel)
         {
             Channel = channel;
         }
 
         [BackgroundDependencyLoader]
-        private void load()
+        private void load(AudioManager audio)
         {
+            sampleJoin = audio.Samples.Get(@"UI/check-on");
+            sampleLeave = audio.Samples.Get(@"UI/check-off");
+
             Masking = true;
             CornerRadius = 5;
             RelativeSizeAxes = Axes.X;
@@ -156,7 +167,19 @@ namespace osu.Game.Overlays.Chat.Listing
                 }
             }, true);
 
-            Action = () => (channelJoined.Value ? OnRequestLeave : OnRequestJoin)?.Invoke(Channel);
+            Action = () =>
+            {
+                if (channelJoined.Value)
+                {
+                    OnRequestLeave?.Invoke(Channel);
+                    sampleLeave?.Play();
+                }
+                else
+                {
+                    OnRequestJoin?.Invoke(Channel);
+                    sampleJoin?.Play();
+                }
+            };
         }
 
         protected override bool OnHover(HoverEvent e)
diff --git a/osu.Game/Overlays/Profile/Header/Components/ExpandDetailsButton.cs b/osu.Game/Overlays/Profile/Header/Components/ExpandDetailsButton.cs
index b4a5d5e31b..4cfdf5cc86 100644
--- a/osu.Game/Overlays/Profile/Header/Components/ExpandDetailsButton.cs
+++ b/osu.Game/Overlays/Profile/Header/Components/ExpandDetailsButton.cs
@@ -25,7 +25,7 @@ namespace osu.Game.Overlays.Profile.Header.Components
         private Sample sampleOpen;
         private Sample sampleClose;
 
-        protected override HoverSounds CreateHoverSounds(HoverSampleSet sampleSet) => new HoverSounds();
+        protected override HoverSounds CreateHoverSounds(HoverSampleSet sampleSet) => new HoverClickSounds();
 
         public ExpandDetailsButton()
         {

From 6115275bc240e72a1744c8917e59d0ecef653cbb Mon Sep 17 00:00:00 2001
From: Jamie Taylor <me@nekodex.net>
Date: Fri, 3 Jun 2022 22:28:36 +0900
Subject: [PATCH 5250/5547] Use 'default' sampleset for toolbar and repurpose
 'toolbar' select sample temporarily

---
 osu.Game/Overlays/Toolbar/ToolbarButton.cs | 2 --
 osu.Game/Overlays/Toolbar/ToolbarClock.cs  | 2 --
 osu.Game/Screens/Select/FooterButton.cs    | 2 +-
 3 files changed, 1 insertion(+), 5 deletions(-)

diff --git a/osu.Game/Overlays/Toolbar/ToolbarButton.cs b/osu.Game/Overlays/Toolbar/ToolbarButton.cs
index 4a839b048c..b686f11c13 100644
--- a/osu.Game/Overlays/Toolbar/ToolbarButton.cs
+++ b/osu.Game/Overlays/Toolbar/ToolbarButton.cs
@@ -20,7 +20,6 @@ using osu.Game.Graphics;
 using osu.Game.Graphics.Backgrounds;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
-using osu.Game.Graphics.UserInterface;
 using osu.Game.Input.Bindings;
 using osuTK;
 using osuTK.Graphics;
@@ -83,7 +82,6 @@ namespace osu.Game.Overlays.Toolbar
         private RealmAccess realm { get; set; }
 
         protected ToolbarButton()
-            : base(HoverSampleSet.Toolbar)
         {
             Width = Toolbar.HEIGHT;
             RelativeSizeAxes = Axes.Y;
diff --git a/osu.Game/Overlays/Toolbar/ToolbarClock.cs b/osu.Game/Overlays/Toolbar/ToolbarClock.cs
index 308359570f..12529da07f 100644
--- a/osu.Game/Overlays/Toolbar/ToolbarClock.cs
+++ b/osu.Game/Overlays/Toolbar/ToolbarClock.cs
@@ -11,7 +11,6 @@ using osu.Framework.Input.Events;
 using osu.Game.Configuration;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
-using osu.Game.Graphics.UserInterface;
 using osuTK;
 using osuTK.Graphics;
 
@@ -29,7 +28,6 @@ namespace osu.Game.Overlays.Toolbar
         private AnalogClockDisplay analog;
 
         public ToolbarClock()
-            : base(HoverSampleSet.Toolbar)
         {
             RelativeSizeAxes = Axes.Y;
             AutoSizeAxes = Axes.X;
diff --git a/osu.Game/Screens/Select/FooterButton.cs b/osu.Game/Screens/Select/FooterButton.cs
index 9cb178ca8b..1587f43258 100644
--- a/osu.Game/Screens/Select/FooterButton.cs
+++ b/osu.Game/Screens/Select/FooterButton.cs
@@ -66,7 +66,7 @@ namespace osu.Game.Screens.Select
         private readonly Box light;
 
         public FooterButton()
-            : base(HoverSampleSet.Button)
+            : base(HoverSampleSet.Toolbar)
         {
             AutoSizeAxes = Axes.Both;
             Shear = SHEAR;

From 396a566a0e577b0f2b1a2ba71ee2f1aa687b6c7b Mon Sep 17 00:00:00 2001
From: Jamie Taylor <me@nekodex.net>
Date: Fri, 3 Jun 2022 22:29:03 +0900
Subject: [PATCH 5251/5547] Add some randomness to click samples

---
 osu.Game/Graphics/UserInterface/HoverClickSounds.cs | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Graphics/UserInterface/HoverClickSounds.cs b/osu.Game/Graphics/UserInterface/HoverClickSounds.cs
index 12819840e5..ba253a7c71 100644
--- a/osu.Game/Graphics/UserInterface/HoverClickSounds.cs
+++ b/osu.Game/Graphics/UserInterface/HoverClickSounds.cs
@@ -7,6 +7,7 @@ using osu.Framework.Audio;
 using osu.Framework.Audio.Sample;
 using osu.Framework.Extensions;
 using osu.Framework.Input.Events;
+using osu.Framework.Utils;
 using osuTK.Input;
 
 namespace osu.Game.Graphics.UserInterface
@@ -37,7 +38,10 @@ namespace osu.Game.Graphics.UserInterface
         protected override bool OnClick(ClickEvent e)
         {
             if (buttons.Contains(e.Button) && Contains(e.ScreenSpaceMousePosition))
-                sampleClick?.Play();
+            {
+                sampleClick.Frequency.Value = 0.99 + RNG.NextDouble(0.02);
+                sampleClick.Play();
+            }
 
             return base.OnClick(e);
         }

From 64616a6d73b3f074b2b133ff4acfce32c3297ee1 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 4 Jun 2022 00:18:54 +0900
Subject: [PATCH 5252/5547] Remove completely gimped implementation in
 `VolumeMeter`

---
 osu.Game/Overlays/Volume/VolumeMeter.cs | 24 +-----------------------
 1 file changed, 1 insertion(+), 23 deletions(-)

diff --git a/osu.Game/Overlays/Volume/VolumeMeter.cs b/osu.Game/Overlays/Volume/VolumeMeter.cs
index 929c362bd8..5dfcb94faf 100644
--- a/osu.Game/Overlays/Volume/VolumeMeter.cs
+++ b/osu.Game/Overlays/Volume/VolumeMeter.cs
@@ -15,7 +15,6 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Effects;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Graphics.UserInterface;
-using osu.Framework.Input.Bindings;
 using osu.Framework.Input.Events;
 using osu.Framework.Threading;
 using osu.Framework.Utils;
@@ -28,7 +27,7 @@ using osuTK.Graphics;
 
 namespace osu.Game.Overlays.Volume
 {
-    public class VolumeMeter : Container, IKeyBindingHandler<GlobalAction>, IStateful<SelectionState>
+    public class VolumeMeter : Container, IStateful<SelectionState>
     {
         private CircularProgress volumeCircle;
         private CircularProgress volumeCircleGlow;
@@ -365,27 +364,6 @@ namespace osu.Game.Overlays.Volume
         {
         }
 
-        public bool OnPressed(KeyBindingPressEvent<GlobalAction> e)
-        {
-            if (!IsHovered)
-                return false;
-
-            switch (e.Action)
-            {
-                case GlobalAction.SelectPreviousGroup:
-                    State = SelectionState.Selected;
-                    adjust(1, false);
-                    return true;
-
-                case GlobalAction.SelectNextGroup:
-                    State = SelectionState.Selected;
-                    adjust(-1, false);
-                    return true;
-            }
-
-            return false;
-        }
-
         public void OnReleased(KeyBindingReleaseEvent<GlobalAction> e)
         {
         }

From 712253a35b74d2c5fb4c92bb86e298ebec8f2717 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 4 Jun 2022 01:04:23 +0900
Subject: [PATCH 5253/5547] Make non-localisable strings in `VolumeMeter`
 verbatim

---
 osu.Game/Overlays/Volume/VolumeMeter.cs | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Overlays/Volume/VolumeMeter.cs b/osu.Game/Overlays/Volume/VolumeMeter.cs
index 5dfcb94faf..24d9f785f2 100644
--- a/osu.Game/Overlays/Volume/VolumeMeter.cs
+++ b/osu.Game/Overlays/Volume/VolumeMeter.cs
@@ -79,7 +79,7 @@ namespace osu.Game.Overlays.Volume
         [BackgroundDependencyLoader]
         private void load(OsuColour colours, AudioManager audio)
         {
-            hoverSample = audio.Samples.Get($"UI/{HoverSampleSet.Button.GetDescription()}-hover");
+            hoverSample = audio.Samples.Get($@"UI/{HoverSampleSet.Button.GetDescription()}-hover");
             notchSample = audio.Samples.Get(@"UI/notch-tick");
             sampleLastPlaybackTime = Time.Current;
 
@@ -131,7 +131,7 @@ namespace osu.Game.Overlays.Volume
                                         {
                                             Anchor = Anchor.Centre,
                                             Origin = Anchor.Centre,
-                                            Name = "Progress under covers for smoothing",
+                                            Name = @"Progress under covers for smoothing",
                                             RelativeSizeAxes = Axes.Both,
                                             Rotation = 180,
                                             Child = volumeCircle = new CircularProgress
@@ -143,7 +143,7 @@ namespace osu.Game.Overlays.Volume
                                 },
                                 new Circle
                                 {
-                                    Name = "Inner Cover",
+                                    Name = @"Inner Cover",
                                     Anchor = Anchor.Centre,
                                     Origin = Anchor.Centre,
                                     RelativeSizeAxes = Axes.Both,
@@ -152,7 +152,7 @@ namespace osu.Game.Overlays.Volume
                                 },
                                 new Container
                                 {
-                                    Name = "Progress overlay for glow",
+                                    Name = @"Progress overlay for glow",
                                     Anchor = Anchor.Centre,
                                     Origin = Anchor.Centre,
                                     RelativeSizeAxes = Axes.Both,

From d0e098fbcdb02b597a28b07123605d7aef561205 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 4 Jun 2022 01:04:46 +0900
Subject: [PATCH 5254/5547] Allow using arrow keys to navigate volume controls
 when controls are already visible

---
 osu.Game/Overlays/VolumeOverlay.cs | 25 +++++++++++++++++++++++++
 1 file changed, 25 insertions(+)

diff --git a/osu.Game/Overlays/VolumeOverlay.cs b/osu.Game/Overlays/VolumeOverlay.cs
index a96949e96f..9d2ed3f837 100644
--- a/osu.Game/Overlays/VolumeOverlay.cs
+++ b/osu.Game/Overlays/VolumeOverlay.cs
@@ -17,6 +17,7 @@ using osu.Game.Input.Bindings;
 using osu.Game.Overlays.Volume;
 using osuTK;
 using osuTK.Graphics;
+using osuTK.Input;
 
 namespace osu.Game.Overlays
 {
@@ -171,6 +172,30 @@ namespace osu.Game.Overlays
             return base.OnMouseMove(e);
         }
 
+        protected override bool OnKeyDown(KeyDownEvent e)
+        {
+            switch (e.Key)
+            {
+                case Key.Left:
+                    Adjust(GlobalAction.PreviousVolumeMeter);
+                    return true;
+
+                case Key.Right:
+                    Adjust(GlobalAction.NextVolumeMeter);
+                    return true;
+
+                case Key.Down:
+                    Adjust(GlobalAction.DecreaseVolume);
+                    return true;
+
+                case Key.Up:
+                    Adjust(GlobalAction.IncreaseVolume);
+                    return true;
+            }
+
+            return base.OnKeyDown(e);
+        }
+
         protected override bool OnHover(HoverEvent e)
         {
             schedulePopOut();

From 045e0446370a7ff0c4b4d7d5035ae7ca92ec3189 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sat, 4 Jun 2022 01:14:41 +0300
Subject: [PATCH 5255/5547] Expose `LegacySkinTransformer`'s underlying skin
 for pattern-matching

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

diff --git a/osu.Game/Skinning/LegacySkinTransformer.cs b/osu.Game/Skinning/LegacySkinTransformer.cs
index 9481fc7182..34714b9dc5 100644
--- a/osu.Game/Skinning/LegacySkinTransformer.cs
+++ b/osu.Game/Skinning/LegacySkinTransformer.cs
@@ -23,7 +23,7 @@ namespace osu.Game.Skinning
         /// The <see cref="ISkin"/> which is being transformed.
         /// </summary>
         [NotNull]
-        protected internal ISkin Skin { get; }
+        public ISkin Skin { get; }
 
         protected LegacySkinTransformer([NotNull] ISkin skin)
         {

From fe96e15b1b32301d405b8755431f301e0555a80f Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sat, 4 Jun 2022 01:15:03 +0300
Subject: [PATCH 5256/5547] Update spinner approach circle to handle
 `LegacySkinTransformer`

---
 .../Skinning/Legacy/LegacyNewStyleSpinner.cs                  | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyNewStyleSpinner.cs b/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyNewStyleSpinner.cs
index 1e170036e4..a58f62736b 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyNewStyleSpinner.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyNewStyleSpinner.cs
@@ -78,7 +78,9 @@ namespace osu.Game.Rulesets.Osu.Skinning.Legacy
                 }
             });
 
-            if (!(source.FindProvider(s => s.GetTexture("spinner-top") != null) is DefaultLegacySkin))
+            var topProvider = source.FindProvider(s => s.GetTexture("spinner-top") != null);
+
+            if (topProvider is LegacySkinTransformer transformer && !(transformer.Skin is DefaultLegacySkin))
             {
                 AddInternal(ApproachCircle = new Sprite
                 {

From b342aad24a906f15da6652935fefdb9aee91c776 Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Thu, 2 Jun 2022 20:53:14 -0700
Subject: [PATCH 5257/5547] Revert/fix some incorrectly used sorting
 localisation

---
 osu.Game/Screens/Select/Filter/SortMode.cs | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Screens/Select/Filter/SortMode.cs b/osu.Game/Screens/Select/Filter/SortMode.cs
index 5dfa2a2664..3dd3381059 100644
--- a/osu.Game/Screens/Select/Filter/SortMode.cs
+++ b/osu.Game/Screens/Select/Filter/SortMode.cs
@@ -15,7 +15,7 @@ namespace osu.Game.Screens.Select.Filter
         [Description("Author")]
         Author,
 
-        [LocalisableDescription(typeof(BeatmapsetsStrings), nameof(BeatmapsetsStrings.ShowStatsBpm))]
+        [LocalisableDescription(typeof(SortStrings), nameof(SortStrings.ArtistTracksBpm))]
         BPM,
 
         [Description("Date Added")]
@@ -28,10 +28,10 @@ namespace osu.Game.Screens.Select.Filter
         Length,
 
         // todo: pending support (https://github.com/ppy/osu/issues/4917)
-        // [LocalisableDescription(typeof(BeatmapsStrings), nameof(BeatmapsStrings.ListingSearchFiltersRank))]
+        // [Description("Rank Achieved")]
         // RankAchieved,
 
-        [LocalisableDescription(typeof(BeatmapsetsStrings), nameof(BeatmapsetsStrings.ShowInfoSource))]
+        [Description("Source")]
         Source,
 
         [LocalisableDescription(typeof(BeatmapsStrings), nameof(BeatmapsStrings.ListingSearchSortingTitle))]

From 58c8562cb0d64ef5287a5a5d7dc8ff022dd3ce11 Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Thu, 2 Jun 2022 20:30:56 -0700
Subject: [PATCH 5258/5547] Fix username placeholder text casing and missing
 localisation on registration form

---
 osu.Game/Overlays/AccountCreation/ScreenEntry.cs | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Overlays/AccountCreation/ScreenEntry.cs b/osu.Game/Overlays/AccountCreation/ScreenEntry.cs
index 1be1321d85..f4f958e4a4 100644
--- a/osu.Game/Overlays/AccountCreation/ScreenEntry.cs
+++ b/osu.Game/Overlays/AccountCreation/ScreenEntry.cs
@@ -5,6 +5,7 @@ using System;
 using System.Linq;
 using System.Threading.Tasks;
 using osu.Framework.Allocation;
+using osu.Framework.Extensions.LocalisationExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Utils;
@@ -69,7 +70,7 @@ namespace osu.Game.Overlays.AccountCreation
                         },
                         usernameTextBox = new OsuTextBox
                         {
-                            PlaceholderText = UsersStrings.LoginUsername,
+                            PlaceholderText = UsersStrings.LoginUsername.ToLower(),
                             RelativeSizeAxes = Axes.X,
                             TabbableContentContainer = this
                         },
@@ -91,7 +92,7 @@ namespace osu.Game.Overlays.AccountCreation
                         },
                         passwordTextBox = new OsuPasswordTextBox
                         {
-                            PlaceholderText = "password",
+                            PlaceholderText = UsersStrings.LoginPassword.ToLower(),
                             RelativeSizeAxes = Axes.X,
                             TabbableContentContainer = this,
                         },

From 4b54fedd88e5389eda73e2f363fc6c8a115032b0 Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Thu, 2 Jun 2022 20:28:59 -0700
Subject: [PATCH 5259/5547] Add back hide common string using new
 `ToSentence()` extension method

---
 osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmap.cs | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmap.cs b/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmap.cs
index 9772b1feb3..98b885eb43 100644
--- a/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmap.cs
+++ b/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmap.cs
@@ -8,6 +8,7 @@ using System.Threading;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Extensions.Color4Extensions;
+using osu.Framework.Extensions.LocalisationExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Colour;
 using osu.Framework.Graphics.Containers;
@@ -244,7 +245,7 @@ namespace osu.Game.Screens.Select.Carousel
                 }
 
                 if (hideRequested != null)
-                    items.Add(new OsuMenuItem("Hide", MenuItemType.Destructive, () => hideRequested(beatmapInfo)));
+                    items.Add(new OsuMenuItem(CommonStrings.ButtonsHide.ToSentence(), MenuItemType.Destructive, () => hideRequested(beatmapInfo)));
 
                 return items.ToArray();
             }

From 30cf6bffad8a0848ed32ca60f0fd0c8f6c914a71 Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Fri, 3 Jun 2022 21:41:34 -0700
Subject: [PATCH 5260/5547] Add tooltips to beatmap card icon pills

---
 .../Drawables/Cards/BeatmapCardExtra.cs       |  5 ++---
 .../Drawables/Cards/BeatmapCardNormal.cs      |  5 ++---
 osu.Game/Beatmaps/Drawables/Cards/IconPill.cs |  8 ++++++--
 .../Drawables/Cards/StoryboardIconPill.cs     | 19 +++++++++++++++++++
 .../Beatmaps/Drawables/Cards/VideoIconPill.cs | 19 +++++++++++++++++++
 5 files changed, 48 insertions(+), 8 deletions(-)
 create mode 100644 osu.Game/Beatmaps/Drawables/Cards/StoryboardIconPill.cs
 create mode 100644 osu.Game/Beatmaps/Drawables/Cards/VideoIconPill.cs

diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtra.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtra.cs
index 58c1ebee0f..7826d64296 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtra.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtra.cs
@@ -6,7 +6,6 @@
 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.Beatmaps.Drawables.Cards.Statistics;
 using osu.Game.Graphics;
@@ -245,10 +244,10 @@ namespace osu.Game.Beatmaps.Drawables.Cards
             });
 
             if (BeatmapSet.HasVideo)
-                leftIconArea.Add(new IconPill(FontAwesome.Solid.Film) { IconSize = new Vector2(20) });
+                leftIconArea.Add(new VideoIconPill { IconSize = new Vector2(20) });
 
             if (BeatmapSet.HasStoryboard)
-                leftIconArea.Add(new IconPill(FontAwesome.Solid.Image) { IconSize = new Vector2(20) });
+                leftIconArea.Add(new StoryboardIconPill { IconSize = new Vector2(20) });
 
             if (BeatmapSet.FeaturedInSpotlight)
             {
diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardNormal.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardNormal.cs
index 3d7e81de21..c1ba521925 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardNormal.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardNormal.cs
@@ -7,7 +7,6 @@ using System.Collections.Generic;
 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.Beatmaps.Drawables.Cards.Statistics;
 using osu.Game.Graphics;
@@ -226,10 +225,10 @@ namespace osu.Game.Beatmaps.Drawables.Cards
             });
 
             if (BeatmapSet.HasVideo)
-                leftIconArea.Add(new IconPill(FontAwesome.Solid.Film) { IconSize = new Vector2(20) });
+                leftIconArea.Add(new VideoIconPill { IconSize = new Vector2(20) });
 
             if (BeatmapSet.HasStoryboard)
-                leftIconArea.Add(new IconPill(FontAwesome.Solid.Image) { IconSize = new Vector2(20) });
+                leftIconArea.Add(new StoryboardIconPill { IconSize = new Vector2(20) });
 
             if (BeatmapSet.FeaturedInSpotlight)
             {
diff --git a/osu.Game/Beatmaps/Drawables/Cards/IconPill.cs b/osu.Game/Beatmaps/Drawables/Cards/IconPill.cs
index c55e9c0a28..1b2c5d3ffc 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/IconPill.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/IconPill.cs
@@ -3,14 +3,16 @@
 
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.Cursor;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Graphics.Sprites;
+using osu.Framework.Localisation;
 using osuTK;
 using osuTK.Graphics;
 
 namespace osu.Game.Beatmaps.Drawables.Cards
 {
-    public class IconPill : CircularContainer
+    public abstract class IconPill : CircularContainer, IHasTooltip
     {
         public Vector2 IconSize
         {
@@ -20,7 +22,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
 
         private readonly Container iconContainer;
 
-        public IconPill(IconUsage icon)
+        protected IconPill(IconUsage icon)
         {
             AutoSizeAxes = Axes.Both;
             Masking = true;
@@ -47,5 +49,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                 },
             };
         }
+
+        public abstract LocalisableString TooltipText { get; }
     }
 }
diff --git a/osu.Game/Beatmaps/Drawables/Cards/StoryboardIconPill.cs b/osu.Game/Beatmaps/Drawables/Cards/StoryboardIconPill.cs
new file mode 100644
index 0000000000..2ebf9107f5
--- /dev/null
+++ b/osu.Game/Beatmaps/Drawables/Cards/StoryboardIconPill.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.Sprites;
+using osu.Framework.Localisation;
+using osu.Game.Resources.Localisation.Web;
+
+namespace osu.Game.Beatmaps.Drawables.Cards
+{
+    public class StoryboardIconPill : IconPill
+    {
+        public StoryboardIconPill()
+            : base(FontAwesome.Solid.Image)
+        {
+        }
+
+        public override LocalisableString TooltipText => BeatmapsetsStrings.ShowInfoStoryboard;
+    }
+}
diff --git a/osu.Game/Beatmaps/Drawables/Cards/VideoIconPill.cs b/osu.Game/Beatmaps/Drawables/Cards/VideoIconPill.cs
new file mode 100644
index 0000000000..b81e18b0dd
--- /dev/null
+++ b/osu.Game/Beatmaps/Drawables/Cards/VideoIconPill.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.Sprites;
+using osu.Framework.Localisation;
+using osu.Game.Resources.Localisation.Web;
+
+namespace osu.Game.Beatmaps.Drawables.Cards
+{
+    public class VideoIconPill : IconPill
+    {
+        public VideoIconPill()
+            : base(FontAwesome.Solid.Film)
+        {
+        }
+
+        public override LocalisableString TooltipText => BeatmapsetsStrings.ShowInfoVideo;
+    }
+}

From 8ad588d9279058f0746c204e9dfe08e7dbdc43f9 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 4 Jun 2022 22:12:53 +0900
Subject: [PATCH 5261/5547] Update framework

---
 osu.Android.props        | 2 +-
 osu.Game/osu.Game.csproj | 2 +-
 osu.iOS.props            | 4 ++--
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Android.props b/osu.Android.props
index 0058bb3577..ab96504e94 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -52,7 +52,7 @@
   </ItemGroup>
   <ItemGroup>
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.527.0" />
-    <PackageReference Include="ppy.osu.Framework.Android" Version="2022.603.1" />
+    <PackageReference Include="ppy.osu.Framework.Android" Version="2022.604.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
     <!-- Realm needs to be directly referenced in all Xamarin projects, as it will not pull in its transitive dependencies otherwise. -->
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 2285f61331..fd6715c58a 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="10.14.0" />
-    <PackageReference Include="ppy.osu.Framework" Version="2022.603.1" />
+    <PackageReference Include="ppy.osu.Framework" Version="2022.604.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.527.0" />
     <PackageReference Include="Sentry" Version="3.17.1" />
     <PackageReference Include="SharpCompress" Version="0.31.0" />
diff --git a/osu.iOS.props b/osu.iOS.props
index b134a7e356..9a36e1073b 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -61,7 +61,7 @@
     <Reference Include="System.Net.Http" />
   </ItemGroup>
   <ItemGroup Label="Package References">
-    <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.603.1" />
+    <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.604.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.527.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net6.0) -->
@@ -84,7 +84,7 @@
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="5.0.14" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.Core" Version="5.0.14" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
-    <PackageReference Include="ppy.osu.Framework" Version="2022.603.1" />
+    <PackageReference Include="ppy.osu.Framework" Version="2022.604.0" />
     <PackageReference Include="SharpCompress" Version="0.31.0" />
     <PackageReference Include="NUnit" Version="3.13.3" />
     <PackageReference Include="System.ComponentModel.Annotations" Version="5.0.0" />

From c0aaeff2b3cfbf7ab75d17ba839af27165986afd Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Sat, 4 Jun 2022 16:11:49 +0100
Subject: [PATCH 5262/5547] Update `DaySeparator` to use new design throughout

Moves `DaySeparator` chat component to it's own file and update it to
match new chat design. Makes use of several virtual attributes that can
be overridden to update spacing and layout in other usage contexts.

Remove redundant usage of `ChatOverlayDaySeparator`, since the new
design is now part of the base class.

Create `StandAloneDaySeparator` to use in `StandAloneChatDisplay` which
overrides attributes to match correct spacing and layout for its design.

Ensure that `DrawableChannel.CreateDaySeparator` returns type of
`DaySeparator` instead of `Drawable`.
---
 .../Online/TestSceneStandAloneChatDisplay.cs  |   4 +-
 osu.Game/Online/Chat/StandAloneChatDisplay.cs |  34 ++++--
 .../Chat/ChatOverlayDrawableChannel.cs        |  82 +-------------
 osu.Game/Overlays/Chat/DaySeparator.cs        | 105 ++++++++++++++++++
 osu.Game/Overlays/Chat/DrawableChannel.cs     |  80 +------------
 5 files changed, 138 insertions(+), 167 deletions(-)
 create mode 100644 osu.Game/Overlays/Chat/DaySeparator.cs

diff --git a/osu.Game.Tests/Visual/Online/TestSceneStandAloneChatDisplay.cs b/osu.Game.Tests/Visual/Online/TestSceneStandAloneChatDisplay.cs
index 860ef5d565..cb52f41c33 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneStandAloneChatDisplay.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneStandAloneChatDisplay.cs
@@ -128,11 +128,11 @@ namespace osu.Game.Tests.Visual.Online
 
             AddAssert("Ensure no adjacent day separators", () =>
             {
-                var indices = chatDisplay.FillFlow.OfType<DrawableChannel.DaySeparator>().Select(ds => chatDisplay.FillFlow.IndexOf(ds));
+                var indices = chatDisplay.FillFlow.OfType<DaySeparator>().Select(ds => chatDisplay.FillFlow.IndexOf(ds));
 
                 foreach (int i in indices)
                 {
-                    if (i < chatDisplay.FillFlow.Count && chatDisplay.FillFlow[i + 1] is DrawableChannel.DaySeparator)
+                    if (i < chatDisplay.FillFlow.Count && chatDisplay.FillFlow[i + 1] is DaySeparator)
                         return false;
                 }
 
diff --git a/osu.Game/Online/Chat/StandAloneChatDisplay.cs b/osu.Game/Online/Chat/StandAloneChatDisplay.cs
index b7e1bc999b..f57ffcfe25 100644
--- a/osu.Game/Online/Chat/StandAloneChatDisplay.cs
+++ b/osu.Game/Online/Chat/StandAloneChatDisplay.cs
@@ -155,9 +155,6 @@ namespace osu.Game.Online.Chat
         {
             public Func<Message, ChatLine> CreateChatLineAction;
 
-            [Resolved]
-            private OsuColour colours { get; set; }
-
             public StandAloneDrawableChannel(Channel channel)
                 : base(channel)
             {
@@ -166,25 +163,40 @@ namespace osu.Game.Online.Chat
             [BackgroundDependencyLoader]
             private void load()
             {
+                // TODO: Remove once DrawableChannel & ChatLine padding is fixed
                 ChatLineFlow.Padding = new MarginPadding { Horizontal = 0 };
             }
 
             protected override ChatLine CreateChatLine(Message m) => CreateChatLineAction(m);
 
-            protected override Drawable CreateDaySeparator(DateTimeOffset time) => new DaySeparator(time)
+            protected override DaySeparator CreateDaySeparator(DateTimeOffset time) => new StandAloneDaySeparator(time);
+        }
+
+        protected class StandAloneDaySeparator : DaySeparator
+        {
+            protected override float TextSize => 14;
+            protected override float LineHeight => 1;
+            protected override float Spacing => 10;
+            protected override float DateAlign => 120;
+
+            public StandAloneDaySeparator(DateTimeOffset time)
+                : base(time)
             {
-                TextSize = 14,
-                Colour = colours.Yellow,
-                LineHeight = 1,
-                Padding = new MarginPadding { Horizontal = 10 },
-                Margin = new MarginPadding { Vertical = 5 },
-            };
+            }
+
+            [BackgroundDependencyLoader]
+            private void load(OsuColour colours)
+            {
+                Height = 25;
+                Colour = colours.Yellow;
+                // TODO: Remove once DrawableChannel & ChatLine padding is fixed
+                Padding = new MarginPadding { Horizontal = 10 };
+            }
         }
 
         protected class StandAloneMessage : ChatLine
         {
             protected override float TextSize => 15;
-
             protected override float HorizontalPadding => 10;
             protected override float MessagePadding => 120;
             protected override float TimestampPadding => 50;
diff --git a/osu.Game/Overlays/Chat/ChatOverlayDrawableChannel.cs b/osu.Game/Overlays/Chat/ChatOverlayDrawableChannel.cs
index 3b47adc4b7..a5d22f678e 100644
--- a/osu.Game/Overlays/Chat/ChatOverlayDrawableChannel.cs
+++ b/osu.Game/Overlays/Chat/ChatOverlayDrawableChannel.cs
@@ -6,10 +6,6 @@
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
-using osu.Framework.Graphics.Containers;
-using osu.Framework.Graphics.Shapes;
-using osu.Game.Graphics;
-using osu.Game.Graphics.Sprites;
 using osu.Game.Online.Chat;
 
 namespace osu.Game.Overlays.Chat
@@ -24,85 +20,19 @@ namespace osu.Game.Overlays.Chat
         [BackgroundDependencyLoader]
         private void load()
         {
+            // TODO: Remove once DrawableChannel & ChatLine padding is fixed
             ChatLineFlow.Padding = new MarginPadding(0);
         }
 
-        protected override Drawable CreateDaySeparator(DateTimeOffset time) => new ChatOverlayDaySeparator(time);
+        protected override DaySeparator CreateDaySeparator(DateTimeOffset time) => new ChatOverlayDaySeparator(time);
 
-        private class ChatOverlayDaySeparator : Container
+        private class ChatOverlayDaySeparator : DaySeparator
         {
-            private readonly DateTimeOffset time;
-
             public ChatOverlayDaySeparator(DateTimeOffset time)
+                : base(time)
             {
-                this.time = time;
-            }
-
-            [BackgroundDependencyLoader]
-            private void load(OverlayColourProvider colourProvider)
-            {
-                RelativeSizeAxes = Axes.X;
-                AutoSizeAxes = Axes.Y;
-                Padding = new MarginPadding { Horizontal = 15, Vertical = 20 };
-                Child = new GridContainer
-                {
-                    RelativeSizeAxes = Axes.X,
-                    AutoSizeAxes = Axes.Y,
-                    ColumnDimensions = new[]
-                    {
-                        new Dimension(GridSizeMode.Absolute, 200),
-                        new Dimension(GridSizeMode.Absolute, 15),
-                        new Dimension(),
-                    },
-                    Content = new[]
-                    {
-                        new[]
-                        {
-                            new GridContainer
-                            {
-                                RelativeSizeAxes = Axes.Both,
-                                ColumnDimensions = new[]
-                                {
-                                    new Dimension(),
-                                    new Dimension(GridSizeMode.Absolute, 15),
-                                    new Dimension(GridSizeMode.AutoSize),
-                                },
-                                Content = new[]
-                                {
-                                    new[]
-                                    {
-                                        new Circle
-                                        {
-                                            Anchor = Anchor.CentreRight,
-                                            Origin = Anchor.CentreRight,
-                                            Colour = colourProvider.Background5,
-                                            RelativeSizeAxes = Axes.X,
-                                            Height = 2,
-                                        },
-                                        Drawable.Empty(),
-                                        new OsuSpriteText
-                                        {
-                                            Anchor = Anchor.CentreRight,
-                                            Origin = Anchor.CentreRight,
-                                            Text = time.ToLocalTime().ToString("dd MMMM yyyy").ToUpper(),
-                                            Font = OsuFont.Torus.With(size: 15, weight: FontWeight.SemiBold),
-                                            Colour = colourProvider.Content1,
-                                        },
-                                    },
-                                },
-                            },
-                            Drawable.Empty(),
-                            new Circle
-                            {
-                                Anchor = Anchor.CentreLeft,
-                                Origin = Anchor.CentreLeft,
-                                Colour = colourProvider.Background5,
-                                RelativeSizeAxes = Axes.X,
-                                Height = 2,
-                            },
-                        },
-                    },
-                };
+                // TODO: Remove once DrawableChannel & ChatLine padding is fixed
+                Padding = new MarginPadding { Horizontal = 15 };
             }
         }
     }
diff --git a/osu.Game/Overlays/Chat/DaySeparator.cs b/osu.Game/Overlays/Chat/DaySeparator.cs
new file mode 100644
index 0000000000..2e3796151c
--- /dev/null
+++ b/osu.Game/Overlays/Chat/DaySeparator.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.
+
+#nullable enable
+
+using System;
+using osu.Framework.Allocation;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.Shapes;
+using osu.Game.Graphics;
+using osu.Game.Graphics.Sprites;
+
+namespace osu.Game.Overlays.Chat
+{
+    public class DaySeparator : Container
+    {
+        protected virtual float TextSize => 15;
+
+        protected virtual float LineHeight => 2;
+
+        protected virtual float DateAlign => 200;
+
+        protected virtual float Spacing => 15;
+
+        private readonly DateTimeOffset time;
+
+        [Resolved(CanBeNull = true)]
+        private OverlayColourProvider? colourProvider { get; set; }
+
+        public DaySeparator(DateTimeOffset time)
+        {
+            this.time = time;
+            Height = 40;
+        }
+
+        [BackgroundDependencyLoader]
+        private void load()
+        {
+            RelativeSizeAxes = Axes.X;
+            Child = new GridContainer
+            {
+                RelativeSizeAxes = Axes.Both,
+                Anchor = Anchor.CentreLeft,
+                Origin = Anchor.CentreLeft,
+                RowDimensions = new[] { new Dimension() },
+                ColumnDimensions = new[]
+                {
+                    new Dimension(GridSizeMode.Absolute, DateAlign),
+                    new Dimension(GridSizeMode.Absolute, Spacing),
+                    new Dimension(),
+                },
+                Content = new[]
+                {
+                    new[]
+                    {
+                        new GridContainer
+                        {
+                            RelativeSizeAxes = Axes.Both,
+                            RowDimensions = new[] { new Dimension() },
+                            ColumnDimensions = new[]
+                            {
+                                new Dimension(),
+                                new Dimension(GridSizeMode.Absolute, Spacing),
+                                new Dimension(GridSizeMode.AutoSize),
+                            },
+                            Content = new[]
+                            {
+                                new[]
+                                {
+                                    new Circle
+                                    {
+                                        Anchor = Anchor.Centre,
+                                        Origin = Anchor.Centre,
+                                        RelativeSizeAxes = Axes.X,
+                                        Height = LineHeight,
+                                        Colour = colourProvider?.Background5 ?? Colour4.White,
+                                    },
+                                    Drawable.Empty(),
+                                    new OsuSpriteText
+                                    {
+                                        Anchor = Anchor.CentreRight,
+                                        Origin = Anchor.CentreRight,
+                                        Text = time.ToLocalTime().ToString("dd MMMM yyyy").ToUpper(),
+                                        Font = OsuFont.Torus.With(size: TextSize, weight: FontWeight.SemiBold),
+                                        Colour = colourProvider?.Content1 ?? Colour4.White,
+                                    },
+                                }
+                            },
+                        },
+                        Drawable.Empty(),
+                        new Circle
+                        {
+                            Anchor = Anchor.Centre,
+                            Origin = Anchor.Centre,
+                            RelativeSizeAxes = Axes.X,
+                            Height = LineHeight,
+                            Colour = colourProvider?.Background5 ?? Colour4.White,
+                        },
+                    }
+                }
+            };
+        }
+    }
+}
diff --git a/osu.Game/Overlays/Chat/DrawableChannel.cs b/osu.Game/Overlays/Chat/DrawableChannel.cs
index f2d4a3e301..f0d4d12f4f 100644
--- a/osu.Game/Overlays/Chat/DrawableChannel.cs
+++ b/osu.Game/Overlays/Chat/DrawableChannel.cs
@@ -7,14 +7,9 @@ using System.Diagnostics;
 using System.Linq;
 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.Shapes;
-using osu.Framework.Graphics.Sprites;
-using osu.Game.Graphics;
 using osu.Game.Graphics.Cursor;
-using osu.Game.Graphics.Sprites;
 using osu.Game.Online.Chat;
 using osuTK.Graphics;
 
@@ -40,9 +35,6 @@ namespace osu.Game.Overlays.Chat
             }
         }
 
-        [Resolved]
-        private OsuColour colours { get; set; }
-
         public DrawableChannel(Channel channel)
         {
             Channel = channel;
@@ -67,7 +59,7 @@ namespace osu.Game.Overlays.Chat
                     Padding = new MarginPadding { Bottom = 5 },
                     Child = ChatLineFlow = new FillFlowContainer
                     {
-                        Padding = new MarginPadding { Left = 20, Right = 20 },
+                        Padding = new MarginPadding { Horizontal = 15 },
                         RelativeSizeAxes = Axes.X,
                         AutoSizeAxes = Axes.Y,
                         Direction = FillDirection.Vertical,
@@ -121,11 +113,7 @@ namespace osu.Game.Overlays.Chat
 
         protected virtual ChatLine CreateChatLine(Message m) => new ChatLine(m);
 
-        protected virtual Drawable CreateDaySeparator(DateTimeOffset time) => new DaySeparator(time)
-        {
-            Colour = colours.ChatBlue.Lighten(0.7f),
-            Margin = new MarginPadding { Vertical = 10 },
-        };
+        protected virtual DaySeparator CreateDaySeparator(DateTimeOffset time) => new DaySeparator(time);
 
         private void newMessagesArrived(IEnumerable<Message> newMessages) => Schedule(() =>
         {
@@ -203,69 +191,5 @@ namespace osu.Game.Overlays.Chat
         });
 
         private IEnumerable<ChatLine> chatLines => ChatLineFlow.Children.OfType<ChatLine>();
-
-        public class DaySeparator : Container
-        {
-            public float TextSize
-            {
-                get => text.Font.Size;
-                set => text.Font = text.Font.With(size: value);
-            }
-
-            private float lineHeight = 2;
-
-            public float LineHeight
-            {
-                get => lineHeight;
-                set => lineHeight = leftBox.Height = rightBox.Height = value;
-            }
-
-            private readonly SpriteText text;
-            private readonly Box leftBox;
-            private readonly Box rightBox;
-
-            public DaySeparator(DateTimeOffset time)
-            {
-                RelativeSizeAxes = Axes.X;
-                AutoSizeAxes = Axes.Y;
-                Child = new GridContainer
-                {
-                    RelativeSizeAxes = Axes.X,
-                    AutoSizeAxes = Axes.Y,
-                    ColumnDimensions = new[]
-                    {
-                        new Dimension(),
-                        new Dimension(GridSizeMode.AutoSize),
-                        new Dimension(),
-                    },
-                    RowDimensions = new[] { new Dimension(GridSizeMode.AutoSize), },
-                    Content = new[]
-                    {
-                        new Drawable[]
-                        {
-                            leftBox = new Box
-                            {
-                                Anchor = Anchor.Centre,
-                                Origin = Anchor.Centre,
-                                RelativeSizeAxes = Axes.X,
-                                Height = lineHeight,
-                            },
-                            text = new OsuSpriteText
-                            {
-                                Margin = new MarginPadding { Horizontal = 10 },
-                                Text = time.ToLocalTime().ToString("dd MMM yyyy"),
-                            },
-                            rightBox = new Box
-                            {
-                                Anchor = Anchor.Centre,
-                                Origin = Anchor.Centre,
-                                RelativeSizeAxes = Axes.X,
-                                Height = lineHeight,
-                            },
-                        }
-                    }
-                };
-            }
-        }
     }
 }

From f1af3205ca2ee2a92727e9c95b0cc8044b215a41 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 5 Jun 2022 13:15:05 +0900
Subject: [PATCH 5263/5547] Update framework

---
 osu.Android.props        | 2 +-
 osu.Game/osu.Game.csproj | 2 +-
 osu.iOS.props            | 4 ++--
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Android.props b/osu.Android.props
index ab96504e94..aad8cf10d0 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -52,7 +52,7 @@
   </ItemGroup>
   <ItemGroup>
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.527.0" />
-    <PackageReference Include="ppy.osu.Framework.Android" Version="2022.604.0" />
+    <PackageReference Include="ppy.osu.Framework.Android" Version="2022.605.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
     <!-- Realm needs to be directly referenced in all Xamarin projects, as it will not pull in its transitive dependencies otherwise. -->
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index fd6715c58a..ca92d06aed 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="10.14.0" />
-    <PackageReference Include="ppy.osu.Framework" Version="2022.604.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2022.605.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.527.0" />
     <PackageReference Include="Sentry" Version="3.17.1" />
     <PackageReference Include="SharpCompress" Version="0.31.0" />
diff --git a/osu.iOS.props b/osu.iOS.props
index 9a36e1073b..a0fafa635b 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -61,7 +61,7 @@
     <Reference Include="System.Net.Http" />
   </ItemGroup>
   <ItemGroup Label="Package References">
-    <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.604.0" />
+    <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.605.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.527.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net6.0) -->
@@ -84,7 +84,7 @@
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="5.0.14" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.Core" Version="5.0.14" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
-    <PackageReference Include="ppy.osu.Framework" Version="2022.604.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2022.605.0" />
     <PackageReference Include="SharpCompress" Version="0.31.0" />
     <PackageReference Include="NUnit" Version="3.13.3" />
     <PackageReference Include="System.ComponentModel.Annotations" Version="5.0.0" />

From 6351f652a2eeaeb2128254638bb9e4143edb5f59 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Mon, 6 Jun 2022 17:56:25 +0900
Subject: [PATCH 5264/5547] Fix combo starting at 0 when spectating

---
 osu.Game/Rulesets/Scoring/ScoreProcessor.cs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Game/Rulesets/Scoring/ScoreProcessor.cs b/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
index 4a5897c621..df094ddb7c 100644
--- a/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
+++ b/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
@@ -460,6 +460,7 @@ namespace osu.Game.Rulesets.Scoring
             currentMaximumScoringValues.BaseScore = maximum.BaseScore;
             currentMaximumScoringValues.MaxCombo = maximum.MaxCombo;
 
+            Combo.Value = frame.Header.Combo;
             HighestCombo.Value = frame.Header.MaxCombo;
 
             scoreResultCounts.Clear();

From 4e35ac8d4c5bba0c1577f9ab859b4d319c34dc7c Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Mon, 6 Jun 2022 18:01:52 +0900
Subject: [PATCH 5265/5547] Add test

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

diff --git a/osu.Game.Tests/Gameplay/TestSceneScoreProcessor.cs b/osu.Game.Tests/Gameplay/TestSceneScoreProcessor.cs
index af4b002bc9..97be1dcfaa 100644
--- a/osu.Game.Tests/Gameplay/TestSceneScoreProcessor.cs
+++ b/osu.Game.Tests/Gameplay/TestSceneScoreProcessor.cs
@@ -59,12 +59,14 @@ namespace osu.Game.Tests.Gameplay
             scoreProcessor.ApplyResult(new JudgementResult(beatmap.HitObjects[0], new TestJudgement(HitResult.Great)) { Type = HitResult.Great });
             Assert.That(scoreProcessor.TotalScore.Value, Is.EqualTo(1_000_000));
             Assert.That(scoreProcessor.JudgedHits, Is.EqualTo(1));
+            Assert.That(scoreProcessor.Combo.Value, Is.EqualTo(1));
 
             // No header shouldn't cause any change
             scoreProcessor.ResetFromReplayFrame(new OsuReplayFrame());
 
             Assert.That(scoreProcessor.TotalScore.Value, Is.EqualTo(1_000_000));
             Assert.That(scoreProcessor.JudgedHits, Is.EqualTo(1));
+            Assert.That(scoreProcessor.Combo.Value, Is.EqualTo(1));
 
             // Reset with a miss instead.
             scoreProcessor.ResetFromReplayFrame(new OsuReplayFrame
@@ -74,6 +76,7 @@ namespace osu.Game.Tests.Gameplay
 
             Assert.That(scoreProcessor.TotalScore.Value, Is.Zero);
             Assert.That(scoreProcessor.JudgedHits, Is.EqualTo(1));
+            Assert.That(scoreProcessor.Combo.Value, Is.EqualTo(0));
 
             // Reset with no judged hit.
             scoreProcessor.ResetFromReplayFrame(new OsuReplayFrame
@@ -83,6 +86,7 @@ namespace osu.Game.Tests.Gameplay
 
             Assert.That(scoreProcessor.TotalScore.Value, Is.Zero);
             Assert.That(scoreProcessor.JudgedHits, Is.Zero);
+            Assert.That(scoreProcessor.Combo.Value, Is.EqualTo(0));
         }
 
         private class TestJudgement : Judgement

From cd0e0fe70feda949ced24a7b4ba0e3f522001b40 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 6 Jun 2022 18:02:42 +0900
Subject: [PATCH 5266/5547] Fix skin editor not accounting for aspect ratios in
 base-game sizing logic

---
 .../Screens/Edit/Components/EditorSidebar.cs  |  4 ++-
 osu.Game/Skinning/Editor/SkinEditor.cs        |  6 ++--
 osu.Game/Skinning/Editor/SkinEditorOverlay.cs | 31 +++++++++++++++++--
 .../Skinning/Editor/SkinEditorSceneLibrary.cs |  4 ++-
 4 files changed, 37 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Screens/Edit/Components/EditorSidebar.cs b/osu.Game/Screens/Edit/Components/EditorSidebar.cs
index 4edcef41b1..4e9b1d5222 100644
--- a/osu.Game/Screens/Edit/Components/EditorSidebar.cs
+++ b/osu.Game/Screens/Edit/Components/EditorSidebar.cs
@@ -16,13 +16,15 @@ namespace osu.Game.Screens.Edit.Components
     /// </summary>
     internal class EditorSidebar : Container<EditorSidebarSection>
     {
+        public const float WIDTH = 250;
+
         private readonly Box background;
 
         protected override Container<EditorSidebarSection> Content { get; }
 
         public EditorSidebar()
         {
-            Width = 250;
+            Width = WIDTH;
             RelativeSizeAxes = Axes.Y;
 
             InternalChildren = new Drawable[]
diff --git a/osu.Game/Skinning/Editor/SkinEditor.cs b/osu.Game/Skinning/Editor/SkinEditor.cs
index e36d5ca3c6..30c33006ad 100644
--- a/osu.Game/Skinning/Editor/SkinEditor.cs
+++ b/osu.Game/Skinning/Editor/SkinEditor.cs
@@ -29,6 +29,8 @@ namespace osu.Game.Skinning.Editor
     {
         public const double TRANSITION_DURATION = 500;
 
+        public const float MENU_HEIGHT = 40;
+
         public readonly BindableList<ISkinnableDrawable> SelectedComponents = new BindableList<ISkinnableDrawable>();
 
         protected override bool StartHidden => true;
@@ -78,8 +80,6 @@ namespace osu.Game.Skinning.Editor
         {
             RelativeSizeAxes = Axes.Both;
 
-            const float menu_height = 40;
-
             InternalChild = new OsuContextMenuContainer
             {
                 RelativeSizeAxes = Axes.Both,
@@ -102,7 +102,7 @@ namespace osu.Game.Skinning.Editor
                                 Name = "Menu container",
                                 RelativeSizeAxes = Axes.X,
                                 Depth = float.MinValue,
-                                Height = menu_height,
+                                Height = MENU_HEIGHT,
                                 Children = new Drawable[]
                                 {
                                     new EditorMenuBar
diff --git a/osu.Game/Skinning/Editor/SkinEditorOverlay.cs b/osu.Game/Skinning/Editor/SkinEditorOverlay.cs
index 497283a820..6b4b8abe1a 100644
--- a/osu.Game/Skinning/Editor/SkinEditorOverlay.cs
+++ b/osu.Game/Skinning/Editor/SkinEditorOverlay.cs
@@ -4,14 +4,17 @@
 using System.Diagnostics;
 using JetBrains.Annotations;
 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.Input.Bindings;
 using osu.Framework.Input.Events;
+using osu.Framework.Layout;
 using osu.Game.Graphics.Containers;
 using osu.Game.Input.Bindings;
 using osu.Game.Screens;
+using osu.Game.Screens.Edit.Components;
 
 namespace osu.Game.Skinning.Editor
 {
@@ -81,15 +84,37 @@ namespace osu.Game.Skinning.Editor
 
         protected override void PopOut() => skinEditor?.Hide();
 
+        protected override bool OnInvalidate(Invalidation invalidation, InvalidationSource source)
+        {
+            if (invalidation.HasFlagFast(Invalidation.DrawSize))
+                Scheduler.AddOnce(updateScreenSizing);
+
+            return base.OnInvalidate(invalidation, source);
+        }
+
+        private void updateScreenSizing()
+        {
+            if (skinEditor?.State.Value != Visibility.Visible) return;
+
+            float relativeSidebarWidth = EditorSidebar.WIDTH / DrawWidth;
+            float relativeToolbarHeight = (SkinEditorSceneLibrary.HEIGHT + SkinEditor.MENU_HEIGHT) / DrawHeight;
+
+            var rect = new RectangleF(
+                relativeSidebarWidth,
+                relativeToolbarHeight,
+                1 - relativeSidebarWidth * 2,
+                1f - relativeToolbarHeight);
+
+            scalingContainer.SetCustomRect(rect, true);
+        }
+
         private void updateComponentVisibility()
         {
             Debug.Assert(skinEditor != null);
 
-            const float toolbar_padding_requirement = 0.18f;
-
             if (skinEditor.State.Value == Visibility.Visible)
             {
-                scalingContainer.SetCustomRect(new RectangleF(toolbar_padding_requirement, 0.2f, 0.8f - toolbar_padding_requirement, 0.7f), true);
+                Scheduler.AddOnce(updateScreenSizing);
 
                 game?.Toolbar.Hide();
                 game?.CloseAllOverlays();
diff --git a/osu.Game/Skinning/Editor/SkinEditorSceneLibrary.cs b/osu.Game/Skinning/Editor/SkinEditorSceneLibrary.cs
index 2124ba9b6d..dc5a8aefc0 100644
--- a/osu.Game/Skinning/Editor/SkinEditorSceneLibrary.cs
+++ b/osu.Game/Skinning/Editor/SkinEditorSceneLibrary.cs
@@ -27,6 +27,8 @@ namespace osu.Game.Skinning.Editor
 {
     public class SkinEditorSceneLibrary : CompositeDrawable
     {
+        public const float HEIGHT = BUTTON_HEIGHT + padding * 2;
+
         public const float BUTTON_HEIGHT = 40;
 
         private const float padding = 10;
@@ -42,7 +44,7 @@ namespace osu.Game.Skinning.Editor
 
         public SkinEditorSceneLibrary()
         {
-            Height = BUTTON_HEIGHT + padding * 2;
+            Height = HEIGHT;
         }
 
         [BackgroundDependencyLoader]

From 003a3de270ad5585ce5bdbc02ef2d622bc8b4a84 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 6 Jun 2022 18:06:46 +0900
Subject: [PATCH 5267/5547] Adjust transitions to look better

---
 osu.Game/Graphics/Containers/ScalingContainer.cs | 14 +++++++-------
 osu.Game/Skinning/Editor/SkinEditor.cs           |  5 ++++-
 2 files changed, 11 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Graphics/Containers/ScalingContainer.cs b/osu.Game/Graphics/Containers/ScalingContainer.cs
index 11bfd80ec1..5c6e315225 100644
--- a/osu.Game/Graphics/Containers/ScalingContainer.cs
+++ b/osu.Game/Graphics/Containers/ScalingContainer.cs
@@ -21,7 +21,7 @@ namespace osu.Game.Graphics.Containers
     /// </summary>
     public class ScalingContainer : Container
     {
-        private const float duration = 500;
+        internal const float TRANSITION_DURATION = 500;
 
         private Bindable<float> sizeX;
         private Bindable<float> sizeY;
@@ -99,7 +99,7 @@ namespace osu.Game.Graphics.Containers
                 if (applyUIScale)
                 {
                     uiScale = osuConfig.GetBindable<float>(OsuSetting.UIScale);
-                    uiScale.BindValueChanged(args => this.TransformTo(nameof(CurrentScale), args.NewValue, duration, Easing.OutQuart), true);
+                    uiScale.BindValueChanged(args => this.TransformTo(nameof(CurrentScale), args.NewValue, TRANSITION_DURATION, Easing.OutQuart), true);
                 }
             }
 
@@ -163,10 +163,10 @@ namespace osu.Game.Graphics.Containers
                         backgroundStack.Push(new ScalingBackgroundScreen());
                     }
 
-                    backgroundStack.FadeIn(duration);
+                    backgroundStack.FadeIn(TRANSITION_DURATION);
                 }
                 else
-                    backgroundStack?.FadeOut(duration);
+                    backgroundStack?.FadeOut(TRANSITION_DURATION);
             }
 
             RectangleF targetRect = new RectangleF(Vector2.Zero, Vector2.One);
@@ -195,13 +195,13 @@ namespace osu.Game.Graphics.Containers
             if (requiresMasking)
                 sizableContainer.Masking = true;
 
-            sizableContainer.MoveTo(targetRect.Location, duration, Easing.OutQuart);
-            sizableContainer.ResizeTo(targetRect.Size, duration, Easing.OutQuart);
+            sizableContainer.MoveTo(targetRect.Location, TRANSITION_DURATION, Easing.OutQuart);
+            sizableContainer.ResizeTo(targetRect.Size, TRANSITION_DURATION, Easing.OutQuart);
 
             // Of note, this will not work great in the case of nested ScalingContainers where multiple are applying corner radius.
             // Masking and corner radius should likely only be applied at one point in the full game stack to fix this.
             // An example of how this can occur is when the skin editor is visible and the game screen scaling is set to "Everything".
-            sizableContainer.TransformTo(nameof(CornerRadius), requiresMasking ? corner_radius : 0, duration, requiresMasking ? Easing.OutQuart : Easing.None)
+            sizableContainer.TransformTo(nameof(CornerRadius), requiresMasking ? corner_radius : 0, TRANSITION_DURATION, requiresMasking ? Easing.OutQuart : Easing.None)
                             .OnComplete(_ => { sizableContainer.Masking = requiresMasking; });
         }
 
diff --git a/osu.Game/Skinning/Editor/SkinEditor.cs b/osu.Game/Skinning/Editor/SkinEditor.cs
index 30c33006ad..095763de18 100644
--- a/osu.Game/Skinning/Editor/SkinEditor.cs
+++ b/osu.Game/Skinning/Editor/SkinEditor.cs
@@ -322,7 +322,10 @@ namespace osu.Game.Skinning.Editor
 
         protected override void PopIn()
         {
-            this.FadeIn(TRANSITION_DURATION, Easing.OutQuint);
+            this
+                // align animation to happen after the majority of the ScalingContainer animation completes.
+                .Delay(ScalingContainer.TRANSITION_DURATION * 0.3f)
+                .FadeIn(TRANSITION_DURATION, Easing.OutQuint);
         }
 
         protected override void PopOut()

From 28c9c61f71e89d80528369718e02d4cbe7a5499f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 6 Jun 2022 18:26:52 +0900
Subject: [PATCH 5268/5547] Fix potential null reference in skin editor if
 target screen is null (during exit)

```csharp
[runtime] 2022-06-06 09:24:31 [verbose]: Host execution state changed to
Stopping
[runtime] 2022-06-06 09:24:31 [error]: An unhandled error has occurred.
[runtime] 2022-06-06 09:24:31 [error]: System.NullReferenceException:
Object reference not set to an instance of an object.
[runtime] 2022-06-06 09:24:31 [error]: at
osu.Game.Skinning.Editor.SkinEditorOverlay.setTarget(OsuScreen target)
in
/Users/dean/Projects/osu/osu.Game/Skinning/Editor/SkinEditorOverlay.cs:line
173
[runtime] 2022-06-06 09:24:31 [error]: at
osu.Framework.Threading.ScheduledDelegate.RunTaskInternal()
[runtime] 2022-06-06 09:24:31 [error]: at
osu.Framework.Threading.Scheduler.Update()
[runtime] 2022-06-06 09:24:31 [error]: at
osu.Framework.Graphics.Drawable.UpdateSubTree()
[runtime] 2022-06-06 09:24:31 [error]: at
osu.Framework.Graphics.Containers.CompositeDrawable.UpdateSubTree()
[runtime] 2022-06-06 09:24:31 [error]: at
osu.Framework.Graphics.Containers.CompositeDrawable.UpdateSubTree()
[runtime] 2022-06-06 09:24:31 [error]: at
osu.Framework.Graphics.Containers.CompositeDrawable.UpdateSubTree()
[runtime] 2022-06-06 09:24:31 [error]: at
osu.Framework.Graphics.Containers.CompositeDrawable.UpdateSubTree()
```
---
 osu.Game/Skinning/Editor/SkinEditorOverlay.cs | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/osu.Game/Skinning/Editor/SkinEditorOverlay.cs b/osu.Game/Skinning/Editor/SkinEditorOverlay.cs
index 497283a820..d4acfd1c4e 100644
--- a/osu.Game/Skinning/Editor/SkinEditorOverlay.cs
+++ b/osu.Game/Skinning/Editor/SkinEditorOverlay.cs
@@ -127,6 +127,9 @@ namespace osu.Game.Skinning.Editor
 
         private void setTarget(OsuScreen target)
         {
+            if (target == null)
+                return;
+
             Debug.Assert(skinEditor != null);
 
             if (!target.IsLoaded)

From a8764b67e1ac962cdbb78d97ddba6ab270167e78 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 6 Jun 2022 18:27:41 +0900
Subject: [PATCH 5269/5547] Add padding and avoid using invalidation (triggers
 too often when toolbar is being toggled)

---
 osu.Game/Skinning/Editor/SkinEditorOverlay.cs | 22 ++++++++++++++++---
 1 file changed, 19 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Skinning/Editor/SkinEditorOverlay.cs b/osu.Game/Skinning/Editor/SkinEditorOverlay.cs
index 6b4b8abe1a..c96abe3e1e 100644
--- a/osu.Game/Skinning/Editor/SkinEditorOverlay.cs
+++ b/osu.Game/Skinning/Editor/SkinEditorOverlay.cs
@@ -15,6 +15,7 @@ using osu.Game.Graphics.Containers;
 using osu.Game.Input.Bindings;
 using osu.Game.Screens;
 using osu.Game.Screens.Edit.Components;
+using osuTK;
 
 namespace osu.Game.Skinning.Editor
 {
@@ -36,6 +37,8 @@ namespace osu.Game.Skinning.Editor
 
         private OsuScreen lastTargetScreen;
 
+        private Vector2 lastDrawSize;
+
         public SkinEditorOverlay(ScalingContainer scalingContainer)
         {
             this.scalingContainer = scalingContainer;
@@ -92,18 +95,31 @@ namespace osu.Game.Skinning.Editor
             return base.OnInvalidate(invalidation, source);
         }
 
+        protected override void Update()
+        {
+            base.Update();
+
+            if (game.DrawSize != lastDrawSize)
+            {
+                lastDrawSize = game.DrawSize;
+                updateScreenSizing();
+            }
+        }
+
         private void updateScreenSizing()
         {
             if (skinEditor?.State.Value != Visibility.Visible) return;
 
-            float relativeSidebarWidth = EditorSidebar.WIDTH / DrawWidth;
-            float relativeToolbarHeight = (SkinEditorSceneLibrary.HEIGHT + SkinEditor.MENU_HEIGHT) / DrawHeight;
+            const float padding = 10;
+
+            float relativeSidebarWidth = (EditorSidebar.WIDTH + padding) / DrawWidth;
+            float relativeToolbarHeight = (SkinEditorSceneLibrary.HEIGHT + SkinEditor.MENU_HEIGHT + padding) / DrawHeight;
 
             var rect = new RectangleF(
                 relativeSidebarWidth,
                 relativeToolbarHeight,
                 1 - relativeSidebarWidth * 2,
-                1f - relativeToolbarHeight);
+                1f - relativeToolbarHeight - padding / DrawHeight);
 
             scalingContainer.SetCustomRect(rect, true);
         }

From 3862681d94d93b1a6642b15d2416d31102a8754b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 6 Jun 2022 19:43:08 +0900
Subject: [PATCH 5270/5547] Change `skin.ini` boolean parsing to match
 osu!stable

Closes https://github.com/ppy/osu/issues/18579.
---
 osu.Game/Skinning/LegacySkin.cs | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Skinning/LegacySkin.cs b/osu.Game/Skinning/LegacySkin.cs
index b65ba8b04c..9524d3f615 100644
--- a/osu.Game/Skinning/LegacySkin.cs
+++ b/osu.Game/Skinning/LegacySkin.cs
@@ -303,8 +303,13 @@ namespace osu.Game.Skinning
                 if (Configuration.ConfigDictionary.TryGetValue(lookup.ToString(), out string val))
                 {
                     // special case for handling skins which use 1 or 0 to signify a boolean state.
+                    // ..or in some cases 2 (https://github.com/ppy/osu/issues/18579).
                     if (typeof(TValue) == typeof(bool))
-                        val = val == "1" ? "true" : "false";
+                    {
+                        val = bool.TryParse(val, out bool boolVal)
+                            ? Convert.ChangeType(boolVal, typeof(bool)).ToString()
+                            : Convert.ChangeType(Convert.ToInt32(val), typeof(bool)).ToString();
+                    }
 
                     var bindable = new Bindable<TValue>();
                     if (val != null)

From da000ee5f0f28b162ae5f09054158e62123f03d2 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 6 Jun 2022 20:11:43 +0900
Subject: [PATCH 5271/5547] Centralise video file extensions

---
 osu.Game/Beatmaps/BeatmapModelManager.cs             |  4 ++--
 osu.Game/Graphics/UserInterfaceV2/OsuFileSelector.cs | 11 +++++------
 2 files changed, 7 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapModelManager.cs b/osu.Game/Beatmaps/BeatmapModelManager.cs
index 9d3ea7d192..541a78089e 100644
--- a/osu.Game/Beatmaps/BeatmapModelManager.cs
+++ b/osu.Game/Beatmaps/BeatmapModelManager.cs
@@ -34,7 +34,7 @@ namespace osu.Game.Beatmaps
 
         protected override string[] HashableFileTypes => new[] { ".osu" };
 
-        private static readonly string[] video_extensions = { ".mp4", ".mov", ".avi", ".flv" };
+        public static readonly string[] VIDEO_EXTENSIONS = { ".mp4", ".mov", ".avi", ".flv" };
 
         public BeatmapModelManager(RealmAccess realm, Storage storage, BeatmapOnlineLookupQueue? onlineLookupQueue = null)
             : base(realm, storage, onlineLookupQueue)
@@ -146,7 +146,7 @@ namespace osu.Game.Beatmaps
 
                 notification.Text = $"Deleting videos from {HumanisedModelName}s ({++i} of {items.Count})";
 
-                var video = b.Files.FirstOrDefault(f => video_extensions.Any(ex => f.Filename.EndsWith(ex, StringComparison.Ordinal)));
+                var video = b.Files.FirstOrDefault(f => VIDEO_EXTENSIONS.Any(ex => f.Filename.EndsWith(ex, StringComparison.Ordinal)));
                 if (video != null)
                     DeleteFile(b, video);
 
diff --git a/osu.Game/Graphics/UserInterfaceV2/OsuFileSelector.cs b/osu.Game/Graphics/UserInterfaceV2/OsuFileSelector.cs
index 3d09d09833..d9dbf4974b 100644
--- a/osu.Game/Graphics/UserInterfaceV2/OsuFileSelector.cs
+++ b/osu.Game/Graphics/UserInterfaceV2/OsuFileSelector.cs
@@ -2,11 +2,13 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System.IO;
+using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Graphics.UserInterface;
+using osu.Game.Beatmaps;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.UserInterface;
@@ -65,6 +67,9 @@ namespace osu.Game.Graphics.UserInterfaceV2
             {
                 get
                 {
+                    if (BeatmapModelManager.VIDEO_EXTENSIONS.Contains(File.Extension))
+                        return FontAwesome.Regular.FileVideo;
+
                     switch (File.Extension)
                     {
                         case @".ogg":
@@ -77,12 +82,6 @@ namespace osu.Game.Graphics.UserInterfaceV2
                         case @".png":
                             return FontAwesome.Regular.FileImage;
 
-                        case @".mp4":
-                        case @".avi":
-                        case @".mov":
-                        case @".flv":
-                            return FontAwesome.Regular.FileVideo;
-
                         default:
                             return FontAwesome.Regular.File;
                     }

From b104b7a90d3a50f3c89ac791a8d5bf316a686600 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 6 Jun 2022 20:12:18 +0900
Subject: [PATCH 5272/5547] Rename method to mention "all"

---
 osu.Game/Beatmaps/BeatmapManager.cs                             | 2 +-
 .../Overlays/Settings/Sections/Maintenance/GeneralSettings.cs   | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index 92266924df..dba457c81c 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -319,7 +319,7 @@ namespace osu.Game.Beatmaps
             });
         }
 
-        public void DeleteVideos()
+        public void DeleteAllVideos()
         {
             realm.Write(r =>
             {
diff --git a/osu.Game/Overlays/Settings/Sections/Maintenance/GeneralSettings.cs b/osu.Game/Overlays/Settings/Sections/Maintenance/GeneralSettings.cs
index 37758875ea..054de8dbd7 100644
--- a/osu.Game/Overlays/Settings/Sections/Maintenance/GeneralSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Maintenance/GeneralSettings.cs
@@ -67,7 +67,7 @@ namespace osu.Game.Overlays.Settings.Sections.Maintenance
                     dialogOverlay?.Push(new MassVideoDeleteConfirmationDialog(() =>
                     {
                         deleteBeatmapVideosButton.Enabled.Value = false;
-                        Task.Run(beatmaps.DeleteVideos).ContinueWith(t => Schedule(() => deleteBeatmapVideosButton.Enabled.Value = true));
+                        Task.Run(beatmaps.DeleteAllVideos).ContinueWith(t => Schedule(() => deleteBeatmapVideosButton.Enabled.Value = true));
                     }));
                 }
             });

From f96340e37d3d852a67132175dd0bffc70d8b360e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 6 Jun 2022 20:18:32 +0900
Subject: [PATCH 5273/5547] Improve messaging of deletion progress / completion

---
 osu.Game/Beatmaps/BeatmapModelManager.cs | 19 +++++++++++++------
 1 file changed, 13 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapModelManager.cs b/osu.Game/Beatmaps/BeatmapModelManager.cs
index 541a78089e..ed64a43097 100644
--- a/osu.Game/Beatmaps/BeatmapModelManager.cs
+++ b/osu.Game/Beatmaps/BeatmapModelManager.cs
@@ -130,13 +130,15 @@ namespace osu.Game.Beatmaps
             {
                 Progress = 0,
                 Text = $"Preparing to delete all {HumanisedModelName} videos...",
-                CompletionText = $"Deleted all {HumanisedModelName} videos!",
+                CompletionText = $"No videos found to delete!",
                 State = ProgressNotificationState.Active,
             };
+
             if (!silent)
                 PostNotification?.Invoke(notification);
 
             int i = 0;
+            int deleted = 0;
 
             foreach (var b in items)
             {
@@ -144,13 +146,18 @@ namespace osu.Game.Beatmaps
                     // user requested abort
                     return;
 
-                notification.Text = $"Deleting videos from {HumanisedModelName}s ({++i} of {items.Count})";
-
                 var video = b.Files.FirstOrDefault(f => VIDEO_EXTENSIONS.Any(ex => f.Filename.EndsWith(ex, StringComparison.Ordinal)));
-                if (video != null)
-                    DeleteFile(b, video);
 
-                notification.Progress = (float)i / items.Count;
+                if (video != null)
+                {
+                    DeleteFile(b, video);
+                    deleted++;
+                    notification.CompletionText = $"Deleted {deleted} {HumanisedModelName} video(s)!";
+                }
+
+                notification.Text = $"Deleting videos from {HumanisedModelName}s ({deleted} deleted)";
+
+                notification.Progress = (float)++i / items.Count;
             }
 
             notification.State = ProgressNotificationState.Completed;

From 3b4b35c51e3618e995058dde2494053d76e704f9 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 6 Jun 2022 20:18:57 +0900
Subject: [PATCH 5274/5547] Remove unnecessary string interpolation

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

diff --git a/osu.Game/Beatmaps/BeatmapModelManager.cs b/osu.Game/Beatmaps/BeatmapModelManager.cs
index ed64a43097..277047348e 100644
--- a/osu.Game/Beatmaps/BeatmapModelManager.cs
+++ b/osu.Game/Beatmaps/BeatmapModelManager.cs
@@ -130,7 +130,7 @@ namespace osu.Game.Beatmaps
             {
                 Progress = 0,
                 Text = $"Preparing to delete all {HumanisedModelName} videos...",
-                CompletionText = $"No videos found to delete!",
+                CompletionText = "No videos found to delete!",
                 State = ProgressNotificationState.Active,
             };
 

From 211f0d1e04c5cad2d892dfae2086f1bb299db163 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 6 Jun 2022 19:57:08 +0200
Subject: [PATCH 5275/5547] Expand test coverage for parsing bool skin config
 values

---
 .../Skins/TestSceneSkinConfigurationLookup.cs          | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Tests/Skins/TestSceneSkinConfigurationLookup.cs b/osu.Game.Tests/Skins/TestSceneSkinConfigurationLookup.cs
index d3cacaa88c..d68398236a 100644
--- a/osu.Game.Tests/Skins/TestSceneSkinConfigurationLookup.cs
+++ b/osu.Game.Tests/Skins/TestSceneSkinConfigurationLookup.cs
@@ -59,11 +59,13 @@ namespace osu.Game.Tests.Skins
             AddAssert("Check float parse lookup", () => requester.GetConfig<string, float>("FloatTest")?.Value == 1.1f);
         }
 
-        [Test]
-        public void TestBoolLookup()
+        [TestCase("0", false)]
+        [TestCase("1", true)]
+        [TestCase("2", true)] // https://github.com/ppy/osu/issues/18579
+        public void TestBoolLookup(string originalValue, bool expectedParsedValue)
         {
-            AddStep("Add config values", () => userSource.Configuration.ConfigDictionary["BoolTest"] = "1");
-            AddAssert("Check bool parse lookup", () => requester.GetConfig<string, bool>("BoolTest")?.Value == true);
+            AddStep("Add config values", () => userSource.Configuration.ConfigDictionary["BoolTest"] = originalValue);
+            AddAssert("Check bool parse lookup", () => requester.GetConfig<string, bool>("BoolTest")?.Value == expectedParsedValue);
         }
 
         [Test]

From 0eaf420fa1d20c94b1b867f204294ddbff04a560 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Tue, 7 Jun 2022 00:29:14 +0300
Subject: [PATCH 5276/5547] Specify full size for spinner ticks container

---
 osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSpinner.cs | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSpinner.cs b/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSpinner.cs
index a904658a4c..fa095edafa 100644
--- a/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSpinner.cs
+++ b/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSpinner.cs
@@ -79,7 +79,10 @@ namespace osu.Game.Rulesets.Osu.Objects.Drawables
                 {
                     Result = { BindTarget = SpinsPerMinute },
                 },
-                ticks = new Container<DrawableSpinnerTick>(),
+                ticks = new Container<DrawableSpinnerTick>
+                {
+                    RelativeSizeAxes = Axes.Both,
+                },
                 new AspectContainer
                 {
                     Anchor = Anchor.Centre,

From 4158146c719f6ef3d7f58991b284cf599426d8e5 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Tue, 7 Jun 2022 00:29:53 +0300
Subject: [PATCH 5277/5547] Fix spinenr tick samples not positioned at centre

Causing samples to be played at left ear rather than centre.
---
 .../Objects/Drawables/DrawableSpinnerTick.cs                | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSpinnerTick.cs b/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSpinnerTick.cs
index 726fbd3ea6..39239c8233 100644
--- a/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSpinnerTick.cs
+++ b/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSpinnerTick.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.Framework.Graphics;
+
 namespace osu.Game.Rulesets.Osu.Objects.Drawables
 {
     public class DrawableSpinnerTick : DrawableOsuHitObject
@@ -10,13 +12,15 @@ namespace osu.Game.Rulesets.Osu.Objects.Drawables
         protected DrawableSpinner DrawableSpinner => (DrawableSpinner)ParentHitObject;
 
         public DrawableSpinnerTick()
-            : base(null)
+            : this(null)
         {
         }
 
         public DrawableSpinnerTick(SpinnerTick spinnerTick)
             : base(spinnerTick)
         {
+            Anchor = Anchor.Centre;
+            Origin = Anchor.Centre;
         }
 
         protected override double MaximumJudgementOffset => DrawableSpinner.HitObject.Duration;

From b6e97e699a9f411f07062228697713e9a61b5539 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Tue, 7 Jun 2022 00:34:18 +0300
Subject: [PATCH 5278/5547] Remove unnecessary position specification

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

diff --git a/osu.Game.Rulesets.Osu/Objects/Spinner.cs b/osu.Game.Rulesets.Osu/Objects/Spinner.cs
index ddee4d3ebd..1a130e96b3 100644
--- a/osu.Game.Rulesets.Osu/Objects/Spinner.cs
+++ b/osu.Game.Rulesets.Osu/Objects/Spinner.cs
@@ -69,8 +69,8 @@ namespace osu.Game.Rulesets.Osu.Objects
                 double startTime = StartTime + (float)(i + 1) / totalSpins * Duration;
 
                 AddNested(i < SpinsRequired
-                    ? new SpinnerTick { StartTime = startTime, Position = Position }
-                    : new SpinnerBonusTick { StartTime = startTime, Position = Position });
+                    ? new SpinnerTick { StartTime = startTime }
+                    : new SpinnerBonusTick { StartTime = startTime });
             }
         }
 

From 46eba86ad17f9721c57f66fbb7578b9b8e59695b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 7 Jun 2022 09:29:30 +0900
Subject: [PATCH 5279/5547] Remove unintended left-over invalidation code

---
 osu.Game/Skinning/Editor/SkinEditorOverlay.cs | 10 ----------
 1 file changed, 10 deletions(-)

diff --git a/osu.Game/Skinning/Editor/SkinEditorOverlay.cs b/osu.Game/Skinning/Editor/SkinEditorOverlay.cs
index c96abe3e1e..ffd94e0aad 100644
--- a/osu.Game/Skinning/Editor/SkinEditorOverlay.cs
+++ b/osu.Game/Skinning/Editor/SkinEditorOverlay.cs
@@ -4,13 +4,11 @@
 using System.Diagnostics;
 using JetBrains.Annotations;
 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.Input.Bindings;
 using osu.Framework.Input.Events;
-using osu.Framework.Layout;
 using osu.Game.Graphics.Containers;
 using osu.Game.Input.Bindings;
 using osu.Game.Screens;
@@ -87,14 +85,6 @@ namespace osu.Game.Skinning.Editor
 
         protected override void PopOut() => skinEditor?.Hide();
 
-        protected override bool OnInvalidate(Invalidation invalidation, InvalidationSource source)
-        {
-            if (invalidation.HasFlagFast(Invalidation.DrawSize))
-                Scheduler.AddOnce(updateScreenSizing);
-
-            return base.OnInvalidate(invalidation, source);
-        }
-
         protected override void Update()
         {
             base.Update();

From 0bfbfc6411afaf3315b151594832f4d62e518a6c Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 7 Jun 2022 11:51:24 +0900
Subject: [PATCH 5280/5547] Update package

---
 .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 65ac05261a..cbd0231fdb 100644
--- a/.config/dotnet-tools.json
+++ b/.config/dotnet-tools.json
@@ -21,7 +21,7 @@
       ]
     },
     "ppy.localisationanalyser.tools": {
-      "version": "2022.417.0",
+      "version": "2022.607.0",
       "commands": [
         "localisation"
       ]
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index ca92d06aed..63b8cf4cb5 100644
--- a/osu.Game/osu.Game.csproj
+++ b/osu.Game/osu.Game.csproj
@@ -31,7 +31,7 @@
     <PackageReference Include="Microsoft.Extensions.Configuration.Abstractions" Version="6.0.0" />
     <PackageReference Include="Microsoft.Toolkit.HighPerformance" Version="7.1.2" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
-    <PackageReference Include="ppy.LocalisationAnalyser" Version="2022.417.0">
+    <PackageReference Include="ppy.LocalisationAnalyser" Version="2022.607.0">
       <PrivateAssets>all</PrivateAssets>
       <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
     </PackageReference>

From f576d53aed47845b562360dd77c5d018d5a3cef2 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 7 Jun 2022 11:54:31 +0900
Subject: [PATCH 5281/5547] Update some unmatching strings

---
 osu.Game/Localisation/AudioSettingsStrings.cs          | 6 +++---
 osu.Game/Localisation/GlobalActionKeyBindingStrings.cs | 4 ++--
 osu.Game/Localisation/JoystickSettingsStrings.cs       | 4 ++--
 3 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/osu.Game/Localisation/AudioSettingsStrings.cs b/osu.Game/Localisation/AudioSettingsStrings.cs
index f298717c99..0f0f560df9 100644
--- a/osu.Game/Localisation/AudioSettingsStrings.cs
+++ b/osu.Game/Localisation/AudioSettingsStrings.cs
@@ -30,12 +30,12 @@ namespace osu.Game.Localisation
         public static LocalisableString OutputDevice => new TranslatableString(getKey(@"output_device"), @"Output device");
 
         /// <summary>
-        /// "Master"
+        /// "Hitsound stereo separation"
         /// </summary>
         public static LocalisableString PositionalLevel => new TranslatableString(getKey(@"positional_hitsound_audio_level"), @"Hitsound stereo separation");
 
         /// <summary>
-        /// "Level"
+        /// "Master"
         /// </summary>
         public static LocalisableString MasterVolume => new TranslatableString(getKey(@"master_volume"), @"Master");
 
@@ -69,6 +69,6 @@ namespace osu.Game.Localisation
         /// </summary>
         public static LocalisableString OffsetWizard => new TranslatableString(getKey(@"offset_wizard"), @"Offset wizard");
 
-        private static string getKey(string key) => $"{prefix}:{key}";
+        private static string getKey(string key) => $@"{prefix}:{key}";
     }
 }
diff --git a/osu.Game/Localisation/GlobalActionKeyBindingStrings.cs b/osu.Game/Localisation/GlobalActionKeyBindingStrings.cs
index 586e29a432..82d03dbb5b 100644
--- a/osu.Game/Localisation/GlobalActionKeyBindingStrings.cs
+++ b/osu.Game/Localisation/GlobalActionKeyBindingStrings.cs
@@ -210,7 +210,7 @@ namespace osu.Game.Localisation
         public static LocalisableString ToggleInGameInterface => new TranslatableString(getKey(@"toggle_in_game_interface"), @"Toggle in-game interface");
 
         /// <summary>
-        /// "Toggle Mod Select"
+        /// "Toggle mod select"
         /// </summary>
         public static LocalisableString ToggleModSelection => new TranslatableString(getKey(@"toggle_mod_selection"), @"Toggle mod select");
 
@@ -299,6 +299,6 @@ namespace osu.Game.Localisation
         /// </summary>
         public static LocalisableString ToggleChatFocus => new TranslatableString(getKey(@"toggle_chat_focus"), @"Toggle chat focus");
 
-        private static string getKey(string key) => $"{prefix}:{key}";
+        private static string getKey(string key) => $@"{prefix}:{key}";
     }
 }
diff --git a/osu.Game/Localisation/JoystickSettingsStrings.cs b/osu.Game/Localisation/JoystickSettingsStrings.cs
index 410cd0a6f5..976ec1adde 100644
--- a/osu.Game/Localisation/JoystickSettingsStrings.cs
+++ b/osu.Game/Localisation/JoystickSettingsStrings.cs
@@ -15,10 +15,10 @@ namespace osu.Game.Localisation
         public static LocalisableString JoystickGamepad => new TranslatableString(getKey(@"joystick_gamepad"), @"Joystick / Gamepad");
 
         /// <summary>
-        /// "Deadzone Threshold"
+        /// "Deadzone"
         /// </summary>
         public static LocalisableString DeadzoneThreshold => new TranslatableString(getKey(@"deadzone_threshold"), @"Deadzone");
 
         private static string getKey(string key) => $@"{prefix}:{key}";
     }
-}
\ No newline at end of file
+}

From ef5d601f6783ab6e5d0cc452e8a00f142132288e Mon Sep 17 00:00:00 2001
From: Henry Lin <henry.ys.lin@gmail.com>
Date: Tue, 7 Jun 2022 12:05:03 +0800
Subject: [PATCH 5282/5547] Fix difficulty name overflow in score panel

---
 .../Visual/Ranking/TestSceneExpandedPanelMiddleContent.cs       | 1 +
 osu.Game/Screens/Ranking/Expanded/ExpandedPanelMiddleContent.cs | 2 ++
 2 files changed, 3 insertions(+)

diff --git a/osu.Game.Tests/Visual/Ranking/TestSceneExpandedPanelMiddleContent.cs b/osu.Game.Tests/Visual/Ranking/TestSceneExpandedPanelMiddleContent.cs
index 8b646df362..2a31728f87 100644
--- a/osu.Game.Tests/Visual/Ranking/TestSceneExpandedPanelMiddleContent.cs
+++ b/osu.Game.Tests/Visual/Ranking/TestSceneExpandedPanelMiddleContent.cs
@@ -96,6 +96,7 @@ namespace osu.Game.Tests.Visual.Ranking
             beatmap.Metadata.Author = author;
             beatmap.Metadata.Title = "Verrrrrrrrrrrrrrrrrrry looooooooooooooooooooooooong beatmap title";
             beatmap.Metadata.Artist = "Verrrrrrrrrrrrrrrrrrry looooooooooooooooooooooooong beatmap artist";
+            beatmap.DifficultyName = "Verrrrrrrrrrrrrrrrrrry looooooooooooooooooooooooong difficulty name";
 
             return beatmap;
         }
diff --git a/osu.Game/Screens/Ranking/Expanded/ExpandedPanelMiddleContent.cs b/osu.Game/Screens/Ranking/Expanded/ExpandedPanelMiddleContent.cs
index 5b3129dad6..b924fbd5df 100644
--- a/osu.Game/Screens/Ranking/Expanded/ExpandedPanelMiddleContent.cs
+++ b/osu.Game/Screens/Ranking/Expanded/ExpandedPanelMiddleContent.cs
@@ -159,6 +159,8 @@ namespace osu.Game.Screens.Ranking.Expanded
                                         Origin = Anchor.TopCentre,
                                         Text = beatmap.DifficultyName,
                                         Font = OsuFont.Torus.With(size: 16, weight: FontWeight.SemiBold),
+                                        MaxWidth = ScorePanel.EXPANDED_WIDTH - padding * 2,
+                                        Truncate = true,
                                     },
                                     new OsuTextFlowContainer(s => s.Font = OsuFont.Torus.With(size: 12))
                                     {

From ac5b1fba1fc5993a61d60cbdcd7e48c20f6809c6 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 7 Jun 2022 15:36:26 +0900
Subject: [PATCH 5283/5547] Add blacklisted auto-import rules which conflict
 with osu!/osu!framework naming

---
 osu.sln.DotSettings | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/osu.sln.DotSettings b/osu.sln.DotSettings
index 68cf8138e2..286a1eb29f 100644
--- a/osu.sln.DotSettings
+++ b/osu.sln.DotSettings
@@ -790,6 +790,15 @@ See the LICENCE file in the repository root for full licence text.&#xD;
 	<s:String x:Key="/Default/CodeStyle/Naming/XamlNaming/UserRules/=XAML_005FFIELD/@EntryIndexedValue">&lt;Policy Inspect="True" Prefix="" Suffix="" Style="AaBb" /&gt;</s:String>
 	<s:String x:Key="/Default/CodeStyle/Naming/XamlNaming/UserRules/=XAML_005FRESOURCE/@EntryIndexedValue">&lt;Policy Inspect="True" Prefix="" Suffix="" Style="AaBb" /&gt;</s:String>
 	<s:String x:Key="/Default/CustomTools/CustomToolsData/@EntryValue"></s:String>
+	<s:Boolean x:Key="/Default/Environment/AutoImport2/=CSHARP/BlackLists/=Microsoft_002EExtensions_002ELogging_002E_002A/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/Environment/AutoImport2/=CSHARP/BlackLists/=Microsoft_002EToolkit_002EHighPeformance_002EBox_002A/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/Environment/AutoImport2/=CSHARP/BlackLists/=NUnit_002EFramework_002EInternal_002ELogger/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/Environment/AutoImport2/=CSHARP/BlackLists/=OpenTabletDriver_002EPlugin_002EDependencyInjection_002E_002A/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/Environment/AutoImport2/=CSHARP/BlackLists/=Realms_002ELogging_002ELogger/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/Environment/AutoImport2/=CSHARP/BlackLists/=System_002EComponentModel_002EContainer/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/Environment/AutoImport2/=CSHARP/BlackLists/=System_002ENumerics_002E_002A/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/Environment/AutoImport2/=CSHARP/BlackLists/=System_002ESecurity_002ECryptography_002ERSA/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/Environment/AutoImport2/=CSHARP/BlackLists/=TagLib_002EMpeg4_002EBox/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/Environment/SettingsMigration/IsMigratorApplied/=JetBrains_002EReSharper_002EFeature_002EServices_002EDaemon_002ESettings_002EMigration_002ESwaWarningsModeSettingsMigrate/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/Environment/SettingsMigration/IsMigratorApplied/=JetBrains_002EReSharper_002EPsi_002ECSharp_002ECodeStyle_002ECSharpAttributeForSingleLineMethodUpgrade/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/Environment/SettingsMigration/IsMigratorApplied/=JetBrains_002EReSharper_002EPsi_002ECSharp_002ECodeStyle_002ECSharpKeepExistingMigration/@EntryIndexedValue">True</s:Boolean>

From df9174ec009fe71e873ea5712937fa85cd1a8a51 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 7 Jun 2022 15:40:54 +0900
Subject: [PATCH 5284/5547] Remove import popup dialog from song select

This has been replaced in spirit by the first run overlay.
---
 .../Navigation/TestSceneScreenNavigation.cs   |  2 --
 .../Screens/Select/ImportFromStablePopup.cs   | 33 -------------------
 osu.Game/Screens/Select/SongSelect.cs         | 30 +++--------------
 3 files changed, 4 insertions(+), 61 deletions(-)
 delete mode 100644 osu.Game/Screens/Select/ImportFromStablePopup.cs

diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs b/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
index c1f5f110d1..51bb27f93e 100644
--- a/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
@@ -609,8 +609,6 @@ namespace osu.Game.Tests.Visual.Navigation
             public ModSelectOverlay ModSelectOverlay => ModSelect;
 
             public BeatmapOptionsOverlay BeatmapOptionsOverlay => BeatmapOptions;
-
-            protected override bool DisplayStableImportPrompt => false;
         }
     }
 }
diff --git a/osu.Game/Screens/Select/ImportFromStablePopup.cs b/osu.Game/Screens/Select/ImportFromStablePopup.cs
deleted file mode 100644
index d8137432bd..0000000000
--- a/osu.Game/Screens/Select/ImportFromStablePopup.cs
+++ /dev/null
@@ -1,33 +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 osu.Framework.Graphics.Sprites;
-using osu.Game.Overlays.Dialog;
-
-namespace osu.Game.Screens.Select
-{
-    public class ImportFromStablePopup : PopupDialog
-    {
-        public ImportFromStablePopup(Action importFromStable)
-        {
-            HeaderText = @"You have no beatmaps!";
-            BodyText = "Would you like to import your beatmaps, skins, collections and scores from an existing osu!stable installation?\nThis will create a second copy of all files on disk.";
-
-            Icon = FontAwesome.Solid.Plane;
-
-            Buttons = new PopupDialogButton[]
-            {
-                new PopupDialogOkButton
-                {
-                    Text = @"Yes please!",
-                    Action = importFromStable
-                },
-                new PopupDialogCancelButton
-                {
-                    Text = @"No, I'd like to start from scratch",
-                },
-            };
-        }
-    }
-}
diff --git a/osu.Game/Screens/Select/SongSelect.cs b/osu.Game/Screens/Select/SongSelect.cs
index 8870239485..242e741475 100644
--- a/osu.Game/Screens/Select/SongSelect.cs
+++ b/osu.Game/Screens/Select/SongSelect.cs
@@ -28,7 +28,6 @@ using osuTK.Input;
 using System;
 using System.Collections.Generic;
 using System.Linq;
-using System.Threading.Tasks;
 using osu.Framework.Audio.Track;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Input.Bindings;
@@ -37,7 +36,6 @@ using osu.Game.Graphics.UserInterface;
 using System.Diagnostics;
 using JetBrains.Annotations;
 using osu.Game.Screens.Play;
-using osu.Game.Database;
 using osu.Game.Skinning;
 
 namespace osu.Game.Screens.Select
@@ -59,8 +57,6 @@ namespace osu.Game.Screens.Select
 
         protected virtual bool ShowFooter => true;
 
-        protected virtual bool DisplayStableImportPrompt => legacyImportManager?.SupportsImportFromStable == true;
-
         public override bool? AllowTrackAdjustments => true;
 
         /// <summary>
@@ -94,14 +90,13 @@ namespace osu.Game.Screens.Select
         protected Container LeftArea { get; private set; }
 
         private BeatmapInfoWedge beatmapInfoWedge;
-        private IDialogOverlay dialogOverlay;
+
+        [Resolved]
+        private IDialogOverlay dialogOverlay { get; set; }
 
         [Resolved]
         private BeatmapManager beatmaps { get; set; }
 
-        [Resolved(CanBeNull = true)]
-        private LegacyImportManager legacyImportManager { get; set; }
-
         protected ModSelectOverlay ModSelect { get; private set; }
 
         protected Sample SampleConfirm { get; private set; }
@@ -127,7 +122,7 @@ namespace osu.Game.Screens.Select
         internal IOverlayManager OverlayManager { get; private set; }
 
         [BackgroundDependencyLoader(true)]
-        private void load(AudioManager audio, IDialogOverlay dialog, OsuColour colours, ManageCollectionsDialog manageCollectionsDialog, DifficultyRecommender recommender)
+        private void load(AudioManager audio, OsuColour colours, ManageCollectionsDialog manageCollectionsDialog, DifficultyRecommender recommender)
         {
             // initial value transfer is required for FilterControl (it uses our re-cached bindables in its async load for the initial filter).
             transferRulesetValue();
@@ -289,26 +284,9 @@ namespace osu.Game.Screens.Select
                 BeatmapOptions.AddButton(@"Clear", @"local scores", FontAwesome.Solid.Eraser, colours.Purple, () => clearScores(Beatmap.Value.BeatmapInfo));
             }
 
-            dialogOverlay = dialog;
-
             sampleChangeDifficulty = audio.Samples.Get(@"SongSelect/select-difficulty");
             sampleChangeBeatmap = audio.Samples.Get(@"SongSelect/select-expand");
             SampleConfirm = audio.Samples.Get(@"SongSelect/confirm-selection");
-
-            if (dialogOverlay != null)
-            {
-                Schedule(() =>
-                {
-                    // if we have no beatmaps, let's prompt the user to import from over a stable install if he has one.
-                    if (beatmaps.QueryBeatmapSet(s => !s.Protected && !s.DeletePending) == null && DisplayStableImportPrompt)
-                    {
-                        dialogOverlay.Push(new ImportFromStablePopup(() =>
-                        {
-                            Task.Run(() => legacyImportManager.ImportFromStableAsync(StableContent.All));
-                        }));
-                    }
-                });
-            }
         }
 
         protected override void LoadComplete()

From 0d32c94104d9da5b47d5b835d2cf91d6a0d077f6 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 7 Jun 2022 16:32:15 +0900
Subject: [PATCH 5285/5547] Add initial implementation of beatmap carousel
 no-results-placeholder

---
 .../SongSelect/TestScenePlaySongSelect.cs     |  34 +++++
 osu.Game/Screens/Select/BeatmapCarousel.cs    |  15 ++-
 .../Screens/Select/NoResultsPlaceholder.cs    | 122 ++++++++++++++++++
 3 files changed, 170 insertions(+), 1 deletion(-)
 create mode 100644 osu.Game/Screens/Select/NoResultsPlaceholder.cs

diff --git a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
index aad7f6b301..77f5bd83d6 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
@@ -18,6 +18,7 @@ using osu.Game.Database;
 using osu.Game.Extensions;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Online.API.Requests.Responses;
+using osu.Game.Online.Chat;
 using osu.Game.Overlays;
 using osu.Game.Overlays.Mods;
 using osu.Game.Rulesets;
@@ -80,6 +81,37 @@ namespace osu.Game.Tests.Visual.SongSelect
             AddStep("delete all beatmaps", () => manager?.Delete());
         }
 
+        [Test]
+        public void TestPlaceholderBeatmapPresence()
+        {
+            createSongSelect();
+
+            AddUntilStep("wait for placeholder visible", () => getPlaceholder()?.State.Value == Visibility.Visible);
+
+            addRulesetImportStep(0);
+            AddUntilStep("wait for placeholder hidden", () => getPlaceholder()?.State.Value == Visibility.Hidden);
+
+            AddStep("delete all beatmaps", () => manager?.Delete());
+            AddUntilStep("wait for placeholder visible", () => getPlaceholder()?.State.Value == Visibility.Visible);
+        }
+
+        [Test]
+        public void TestPlaceholderConvertSetting()
+        {
+            changeRuleset(2);
+            addRulesetImportStep(0);
+            AddStep("change convert setting", () => config.SetValue(OsuSetting.ShowConvertedBeatmaps, false));
+
+            createSongSelect();
+
+            AddUntilStep("wait for placeholder visible", () => getPlaceholder()?.State.Value == Visibility.Visible);
+
+            AddStep("click link in placeholder", () => getPlaceholder().ChildrenOfType<DrawableLinkCompiler>().First().TriggerClick());
+
+            AddUntilStep("convert setting changed", () => config.Get<bool>(OsuSetting.ShowConvertedBeatmaps));
+            AddUntilStep("wait for placeholder visible", () => getPlaceholder()?.State.Value == Visibility.Hidden);
+        }
+
         [Test]
         public void TestSingleFilterOnEnter()
         {
@@ -941,6 +973,8 @@ namespace osu.Game.Tests.Visual.SongSelect
 
         private int getBeatmapIndex(BeatmapSetInfo set, BeatmapInfo info) => set.Beatmaps.IndexOf(info);
 
+        private NoResultsPlaceholder getPlaceholder() => songSelect.ChildrenOfType<NoResultsPlaceholder>().FirstOrDefault();
+
         private int getCurrentBeatmapIndex() => getBeatmapIndex(songSelect.Carousel.SelectedBeatmapSet, songSelect.Carousel.SelectedBeatmapInfo);
 
         private int getDifficultyIconIndex(DrawableCarouselBeatmapSet set, FilterableDifficultyIcon icon)
diff --git a/osu.Game/Screens/Select/BeatmapCarousel.cs b/osu.Game/Screens/Select/BeatmapCarousel.cs
index a59f14647d..b7d253d7de 100644
--- a/osu.Game/Screens/Select/BeatmapCarousel.cs
+++ b/osu.Game/Screens/Select/BeatmapCarousel.cs
@@ -97,6 +97,8 @@ namespace osu.Game.Screens.Select
 
         protected readonly CarouselScrollContainer Scroll;
 
+        private readonly NoResultsPlaceholder noResultsPlaceholder;
+
         private IEnumerable<CarouselBeatmapSet> beatmapSets => root.Children.OfType<CarouselBeatmapSet>();
 
         // todo: only used for testing, maybe remove.
@@ -170,7 +172,8 @@ namespace osu.Game.Screens.Select
                     Scroll = new CarouselScrollContainer
                     {
                         RelativeSizeAxes = Axes.Both,
-                    }
+                    },
+                    noResultsPlaceholder = new NoResultsPlaceholder()
                 }
             };
         }
@@ -648,8 +651,18 @@ namespace osu.Game.Screens.Select
             // First we iterate over all non-filtered carousel items and populate their
             // vertical position data.
             if (revalidateItems)
+            {
                 updateYPositions();
 
+                if (visibleItems.Count == 0)
+                {
+                    noResultsPlaceholder.Filter = activeCriteria;
+                    noResultsPlaceholder.Show();
+                }
+                else
+                    noResultsPlaceholder.Hide();
+            }
+
             // if there is a pending scroll action we apply it without animation and transfer the difference in position to the panels.
             // this is intentionally applied before updating the visible range below, to avoid animating new items (sourced from pool) from locations off-screen, as it looks bad.
             if (pendingScrollOperation != PendingScrollOperation.None)
diff --git a/osu.Game/Screens/Select/NoResultsPlaceholder.cs b/osu.Game/Screens/Select/NoResultsPlaceholder.cs
new file mode 100644
index 0000000000..0188dbd7db
--- /dev/null
+++ b/osu.Game/Screens/Select/NoResultsPlaceholder.cs
@@ -0,0 +1,122 @@
+// 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.Graphics.Sprites;
+using osu.Game.Beatmaps;
+using osu.Game.Graphics;
+using osu.Game.Graphics.Containers;
+using osu.Game.Online.Chat;
+using osu.Game.Overlays;
+using osuTK;
+
+namespace osu.Game.Screens.Select
+{
+    public class NoResultsPlaceholder : CompositeDrawable
+    {
+        private FilterCriteria filter;
+
+        private LinkFlowContainer textFlow;
+
+        [Resolved]
+        private BeatmapManager beatmaps { get; set; }
+
+        [Resolved(CanBeNull = true)]
+        private FirstRunSetupOverlay firstRunSetupOverlay { get; set; }
+
+        public FilterCriteria Filter
+        {
+            get => filter;
+            set
+            {
+                filter = value;
+                Scheduler.AddOnce(updateText);
+            }
+        }
+
+        [BackgroundDependencyLoader]
+        private void load(OsuColour colours)
+        {
+            Masking = true;
+            CornerRadius = 10;
+
+            Width = 300;
+            AutoSizeAxes = Axes.Y;
+
+            Anchor = Anchor.Centre;
+            Origin = Anchor.Centre;
+
+            InternalChildren = new Drawable[]
+            {
+                new Box
+                {
+                    Colour = colours.Gray2,
+                    RelativeSizeAxes = Axes.Both,
+                },
+                new SpriteIcon
+                {
+                    Icon = FontAwesome.Regular.QuestionCircle,
+                    Anchor = Anchor.TopCentre,
+                    Origin = Anchor.TopCentre,
+                    Margin = new MarginPadding(10),
+                    Size = new Vector2(50),
+                },
+                textFlow = new LinkFlowContainer
+                {
+                    Y = 70,
+                    Padding = new MarginPadding(10),
+                    TextAnchor = Anchor.TopCentre,
+                    RelativeSizeAxes = Axes.X,
+                    AutoSizeAxes = Axes.Y,
+                }
+            };
+        }
+
+        public override void Show()
+        {
+            this.FadeIn(600, Easing.OutQuint);
+
+            this.ScaleTo(0.8f)
+                .ScaleTo(1f, 1000, Easing.OutElastic);
+
+            Scheduler.AddOnce(updateText);
+        }
+
+        public override void Hide()
+        {
+            this.FadeOut(200, Easing.OutQuint);
+        }
+
+        private void updateText()
+        {
+            textFlow.Clear();
+
+            if (beatmaps.QueryBeatmapSet(s => !s.Protected && !s.DeletePending) == null)
+            {
+                textFlow.AddParagraph("No beatmaps found!");
+                textFlow.AddParagraph(string.Empty);
+
+                textFlow.AddParagraph("Consider running the ");
+                textFlow.AddLink("first run setup", () => firstRunSetupOverlay?.Show());
+                textFlow.AddText(" to load or import some beatmaps!");
+            }
+            else
+            {
+                textFlow.AddParagraph("No beatmaps match your filter criteria!");
+                textFlow.AddParagraph(string.Empty);
+
+                // TODO: hint when beatmaps are available in another ruleset
+                // TODO: hint when beatmaps are available by toggling "show converted".
+                if (!string.IsNullOrEmpty(filter?.SearchText))
+                {
+                    textFlow.AddParagraph("You can try ");
+                    textFlow.AddLink("searching online", LinkAction.SearchBeatmapSet, filter.SearchText);
+                    textFlow.AddText(" for this query.");
+                }
+            }
+        }
+    }
+}

From a04af1ca5f4ffb39b31b9ca3d33f47d5cec1393e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 7 Jun 2022 16:45:20 +0900
Subject: [PATCH 5286/5547] Enable nullable and add hinting at convert filter
 criteria

---
 .../Screens/Select/NoResultsPlaceholder.cs    | 32 +++++++++++++------
 1 file changed, 23 insertions(+), 9 deletions(-)

diff --git a/osu.Game/Screens/Select/NoResultsPlaceholder.cs b/osu.Game/Screens/Select/NoResultsPlaceholder.cs
index 0188dbd7db..1b81deb30e 100644
--- a/osu.Game/Screens/Select/NoResultsPlaceholder.cs
+++ b/osu.Game/Screens/Select/NoResultsPlaceholder.cs
@@ -1,12 +1,15 @@
 // 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 enable
+
 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.Game.Beatmaps;
+using osu.Game.Configuration;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Online.Chat;
@@ -17,19 +20,21 @@ namespace osu.Game.Screens.Select
 {
     public class NoResultsPlaceholder : CompositeDrawable
     {
-        private FilterCriteria filter;
+        private FilterCriteria? filter;
 
-        private LinkFlowContainer textFlow;
+        private LinkFlowContainer textFlow = null!;
 
         [Resolved]
-        private BeatmapManager beatmaps { get; set; }
+        private BeatmapManager beatmaps { get; set; } = null!;
 
-        [Resolved(CanBeNull = true)]
-        private FirstRunSetupOverlay firstRunSetupOverlay { get; set; }
+        [Resolved]
+        private FirstRunSetupOverlay? firstRunSetupOverlay { get; set; }
+
+        [Resolved]
+        private OsuConfigManager config { get; set; } = null!;
 
         public FilterCriteria Filter
         {
-            get => filter;
             set
             {
                 filter = value;
@@ -108,9 +113,18 @@ namespace osu.Game.Screens.Select
                 textFlow.AddParagraph("No beatmaps match your filter criteria!");
                 textFlow.AddParagraph(string.Empty);
 
-                // TODO: hint when beatmaps are available in another ruleset
-                // TODO: hint when beatmaps are available by toggling "show converted".
-                if (!string.IsNullOrEmpty(filter?.SearchText))
+                if (string.IsNullOrEmpty(filter?.SearchText))
+                {
+                    // TODO: Add realm queries to hint at which ruleset results are available in (and allow clicking to switch).
+                    // TODO: Make this message more certain by ensuring the osu! beatmaps exist before suggesting.
+                    if (filter?.Ruleset.OnlineID > 0 && !filter.AllowConvertedBeatmaps)
+                    {
+                        textFlow.AddParagraph("Beatmaps may be available by ");
+                        textFlow.AddLink("enabling automatic conversion", () => config.SetValue(OsuSetting.ShowConvertedBeatmaps, true));
+                        textFlow.AddText("!");
+                    }
+                }
+                else
                 {
                     textFlow.AddParagraph("You can try ");
                     textFlow.AddLink("searching online", LinkAction.SearchBeatmapSet, filter.SearchText);

From f8524c3af4409d799b28a681b0ac3e35b25c87b0 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 7 Jun 2022 17:13:04 +0900
Subject: [PATCH 5287/5547] Use `VisibilityContainer` to avoid too many
 animations triggering

---
 .../Screens/Select/NoResultsPlaceholder.cs    | 31 ++++++++++++-------
 1 file changed, 20 insertions(+), 11 deletions(-)

diff --git a/osu.Game/Screens/Select/NoResultsPlaceholder.cs b/osu.Game/Screens/Select/NoResultsPlaceholder.cs
index 1b81deb30e..28a0541a22 100644
--- a/osu.Game/Screens/Select/NoResultsPlaceholder.cs
+++ b/osu.Game/Screens/Select/NoResultsPlaceholder.cs
@@ -12,13 +12,14 @@ using osu.Game.Beatmaps;
 using osu.Game.Configuration;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
+using osu.Game.Localisation;
 using osu.Game.Online.Chat;
 using osu.Game.Overlays;
 using osuTK;
 
 namespace osu.Game.Screens.Select
 {
-    public class NoResultsPlaceholder : CompositeDrawable
+    public class NoResultsPlaceholder : VisibilityContainer
     {
         private FilterCriteria? filter;
 
@@ -37,6 +38,9 @@ namespace osu.Game.Screens.Select
         {
             set
             {
+                if (filter == value)
+                    return;
+
                 filter = value;
                 Scheduler.AddOnce(updateText);
             }
@@ -63,7 +67,7 @@ namespace osu.Game.Screens.Select
                 },
                 new SpriteIcon
                 {
-                    Icon = FontAwesome.Regular.QuestionCircle,
+                    Icon = FontAwesome.Regular.SadTear,
                     Anchor = Anchor.TopCentre,
                     Origin = Anchor.TopCentre,
                     Margin = new MarginPadding(10),
@@ -71,7 +75,7 @@ namespace osu.Game.Screens.Select
                 },
                 textFlow = new LinkFlowContainer
                 {
-                    Y = 70,
+                    Y = 60,
                     Padding = new MarginPadding(10),
                     TextAnchor = Anchor.TopCentre,
                     RelativeSizeAxes = Axes.X,
@@ -80,23 +84,26 @@ namespace osu.Game.Screens.Select
             };
         }
 
-        public override void Show()
+        protected override void PopIn()
         {
             this.FadeIn(600, Easing.OutQuint);
 
-            this.ScaleTo(0.8f)
-                .ScaleTo(1f, 1000, Easing.OutElastic);
-
             Scheduler.AddOnce(updateText);
         }
 
-        public override void Hide()
+        protected override void PopOut()
         {
             this.FadeOut(200, Easing.OutQuint);
         }
 
         private void updateText()
         {
+            // TODO: Refresh this text when new beatmaps are imported. Right now it won't get up-to-date suggestions.
+
+            // Bounce should play every time the filter criteria is updated.
+            this.ScaleTo(0.9f)
+                .ScaleTo(1f, 1000, Easing.OutElastic);
+
             textFlow.Clear();
 
             if (beatmaps.QueryBeatmapSet(s => !s.Protected && !s.DeletePending) == null)
@@ -104,9 +111,9 @@ namespace osu.Game.Screens.Select
                 textFlow.AddParagraph("No beatmaps found!");
                 textFlow.AddParagraph(string.Empty);
 
-                textFlow.AddParagraph("Consider running the ");
-                textFlow.AddLink("first run setup", () => firstRunSetupOverlay?.Show());
-                textFlow.AddText(" to load or import some beatmaps!");
+                textFlow.AddParagraph("Consider using the \"");
+                textFlow.AddLink(FirstRunSetupOverlayStrings.FirstRunSetupTitle, () => firstRunSetupOverlay?.Show());
+                textFlow.AddText("\" to download or import some beatmaps!");
             }
             else
             {
@@ -131,6 +138,8 @@ namespace osu.Game.Screens.Select
                     textFlow.AddText(" for this query.");
                 }
             }
+
+            // TODO: add clickable link to reset criteria.
         }
     }
 }

From 430bacf91722a182472f6ab45a931aea2b808ab9 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 7 Jun 2022 13:50:53 +0900
Subject: [PATCH 5288/5547] Add initial layout of comparison screens

---
 .../Settings/TestSceneLatencyComparer.cs      | 261 ++++++++++++++++++
 1 file changed, 261 insertions(+)
 create mode 100644 osu.Game.Tests/Visual/Settings/TestSceneLatencyComparer.cs

diff --git a/osu.Game.Tests/Visual/Settings/TestSceneLatencyComparer.cs b/osu.Game.Tests/Visual/Settings/TestSceneLatencyComparer.cs
new file mode 100644
index 0000000000..cf9a01f0b1
--- /dev/null
+++ b/osu.Game.Tests/Visual/Settings/TestSceneLatencyComparer.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.
+
+#nullable enable
+
+using NUnit.Framework;
+using osu.Framework.Allocation;
+using osu.Framework.Configuration;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.Shapes;
+using osu.Framework.Input;
+using osu.Framework.Input.Events;
+using osu.Framework.Screens;
+using osu.Game.Screens;
+using osuTK;
+using osuTK.Graphics;
+using osuTK.Input;
+
+namespace osu.Game.Tests.Visual.Settings
+{
+    public class TestSceneLatencyComparer : ScreenTestScene
+    {
+        [Test]
+        public void TestBasic()
+        {
+            AddStep("Load screen", () => LoadScreen(new LatencyComparerScreen()));
+        }
+    }
+
+    public class LatencyComparerScreen : OsuScreen
+    {
+        private FrameSync previousFrameSyncMode;
+
+        public override bool HideOverlaysOnEnter => true;
+
+        public override bool CursorVisible => false;
+
+        [Resolved]
+        private FrameworkConfigManager config { get; set; } = null!;
+
+        public LatencyComparerScreen()
+        {
+            InternalChildren = new Drawable[]
+            {
+                new GridContainer
+                {
+                    RelativeSizeAxes = Axes.Both,
+                    RowDimensions = new[]
+                    {
+                        new Dimension(GridSizeMode.Absolute, 100),
+                        new Dimension(),
+                        new Dimension(GridSizeMode.Absolute, 100),
+                    },
+                    Content = new[]
+                    {
+                        new Drawable[]
+                        {
+                            // header content
+                        },
+                        new Drawable[]
+                        {
+                            new Container
+                            {
+                                RelativeSizeAxes = Axes.Both,
+                                Children = new Drawable[]
+                                {
+                                    new LatencyArea(10)
+                                    {
+                                        Width = 0.5f,
+                                        Anchor = Anchor.TopLeft,
+                                        Origin = Anchor.TopLeft,
+                                    },
+                                    new LatencyArea(0)
+                                    {
+                                        Width = 0.5f,
+                                        Anchor = Anchor.TopRight,
+                                        Origin = Anchor.TopRight,
+                                    },
+                                    new Box
+                                    {
+                                        Colour = Color4.Black,
+                                        Width = 50,
+                                        RelativeSizeAxes = Axes.Y,
+                                        Anchor = Anchor.TopCentre,
+                                        Origin = Anchor.TopCentre,
+                                    },
+                                }
+                            },
+                        },
+                        new Drawable[]
+                        {
+                            // footer content
+                        },
+                    }
+                }
+            };
+        }
+
+        public override void OnEntering(ScreenTransitionEvent e)
+        {
+            base.OnEntering(e);
+
+            previousFrameSyncMode = config.Get<FrameSync>(FrameworkSetting.FrameSync);
+            config.SetValue(FrameworkSetting.FrameSync, FrameSync.Unlimited);
+            // host.AllowBenchmarkUnlimitedFrames = true;
+        }
+
+        public override bool OnExiting(ScreenExitEvent e)
+        {
+            // host.AllowBenchmarkUnlimitedFrames = false;
+            config.SetValue(FrameworkSetting.FrameSync, previousFrameSyncMode);
+            return base.OnExiting(e);
+        }
+
+        public class LatencyArea : CompositeDrawable
+        {
+            private readonly int inducedLatency;
+
+            public LatencyArea(int inducedLatency)
+            {
+                this.inducedLatency = inducedLatency;
+                RelativeSizeAxes = Axes.Both;
+
+                InternalChildren = new Drawable[]
+                {
+                    new Box
+                    {
+                        Colour = Color4.Blue,
+                        RelativeSizeAxes = Axes.Both,
+                    },
+                    new LatencyMovableBox
+                    {
+                        RelativeSizeAxes = Axes.Both,
+                    },
+                    new LatencyCursorContainer
+                    {
+                        RelativeSizeAxes = Axes.Both,
+                    }
+                };
+            }
+
+            private long frameCount;
+
+            public override bool UpdateSubTree()
+            {
+                if (inducedLatency > 0 && ++frameCount % inducedLatency != 0)
+                    return false;
+
+                return base.UpdateSubTree();
+            }
+
+            public class LatencyMovableBox : CompositeDrawable
+            {
+                private Box box = null!;
+                private InputManager inputManager = null!;
+
+                public LatencyMovableBox()
+                {
+                    Masking = true;
+                }
+
+                protected override void LoadComplete()
+                {
+                    base.LoadComplete();
+
+                    inputManager = GetContainingInputManager();
+
+                    InternalChild = box = new Box
+                    {
+                        Size = new Vector2(40),
+                        Position = DrawSize / 2,
+                        Origin = Anchor.Centre,
+                    };
+                }
+
+                protected override bool OnHover(HoverEvent e) => false;
+
+                private double? lastFrameTime;
+
+                protected override void Update()
+                {
+                    base.Update();
+
+                    if (!IsHovered)
+                        return;
+
+                    if (lastFrameTime != null)
+                    {
+                        float movementAmount = (float)(Clock.CurrentTime - lastFrameTime);
+
+                        foreach (var key in inputManager.CurrentState.Keyboard.Keys)
+                        {
+                            switch (key)
+                            {
+                                case Key.Up:
+                                    box.Y -= movementAmount;
+                                    break;
+
+                                case Key.Down:
+                                    box.Y += movementAmount;
+                                    break;
+
+                                case Key.Left:
+                                    box.X -= movementAmount;
+                                    break;
+
+                                case Key.Right:
+                                    box.X += movementAmount;
+                                    break;
+                            }
+                        }
+                    }
+
+                    lastFrameTime = Clock.CurrentTime;
+                }
+            }
+
+            public class LatencyCursorContainer : CompositeDrawable
+            {
+                private readonly Circle cursor;
+                private InputManager inputManager = null!;
+
+                public LatencyCursorContainer()
+                {
+                    Masking = true;
+
+                    InternalChild = cursor = new Circle
+                    {
+                        Size = new Vector2(40),
+                        Origin = Anchor.Centre,
+                    };
+                }
+
+                protected override void LoadComplete()
+                {
+                    base.LoadComplete();
+
+                    inputManager = GetContainingInputManager();
+                }
+
+                protected override bool OnHover(HoverEvent e) => false;
+
+                protected override void Update()
+                {
+                    if (IsHovered)
+                    {
+                        cursor.Position = ToLocalSpace(inputManager.CurrentState.Mouse.Position);
+                        cursor.Alpha = 1;
+                    }
+                    else
+                    {
+                        cursor.Alpha = 0;
+                    }
+
+                    base.Update();
+                }
+            }
+        }
+    }
+}

From 0adeccbf03fa872b0d937f4a0ce3142324809ede Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 7 Jun 2022 14:40:21 +0900
Subject: [PATCH 5289/5547] Add full latency testing flow

---
 .../Settings/TestSceneLatencyComparer.cs      | 242 -----------
 osu.Game/Screens/LatencyComparerScreen.cs     | 385 ++++++++++++++++++
 2 files changed, 385 insertions(+), 242 deletions(-)
 create mode 100644 osu.Game/Screens/LatencyComparerScreen.cs

diff --git a/osu.Game.Tests/Visual/Settings/TestSceneLatencyComparer.cs b/osu.Game.Tests/Visual/Settings/TestSceneLatencyComparer.cs
index cf9a01f0b1..8a5db7bd95 100644
--- a/osu.Game.Tests/Visual/Settings/TestSceneLatencyComparer.cs
+++ b/osu.Game.Tests/Visual/Settings/TestSceneLatencyComparer.cs
@@ -4,18 +4,7 @@
 #nullable enable
 
 using NUnit.Framework;
-using osu.Framework.Allocation;
-using osu.Framework.Configuration;
-using osu.Framework.Graphics;
-using osu.Framework.Graphics.Containers;
-using osu.Framework.Graphics.Shapes;
-using osu.Framework.Input;
-using osu.Framework.Input.Events;
-using osu.Framework.Screens;
 using osu.Game.Screens;
-using osuTK;
-using osuTK.Graphics;
-using osuTK.Input;
 
 namespace osu.Game.Tests.Visual.Settings
 {
@@ -27,235 +16,4 @@ namespace osu.Game.Tests.Visual.Settings
             AddStep("Load screen", () => LoadScreen(new LatencyComparerScreen()));
         }
     }
-
-    public class LatencyComparerScreen : OsuScreen
-    {
-        private FrameSync previousFrameSyncMode;
-
-        public override bool HideOverlaysOnEnter => true;
-
-        public override bool CursorVisible => false;
-
-        [Resolved]
-        private FrameworkConfigManager config { get; set; } = null!;
-
-        public LatencyComparerScreen()
-        {
-            InternalChildren = new Drawable[]
-            {
-                new GridContainer
-                {
-                    RelativeSizeAxes = Axes.Both,
-                    RowDimensions = new[]
-                    {
-                        new Dimension(GridSizeMode.Absolute, 100),
-                        new Dimension(),
-                        new Dimension(GridSizeMode.Absolute, 100),
-                    },
-                    Content = new[]
-                    {
-                        new Drawable[]
-                        {
-                            // header content
-                        },
-                        new Drawable[]
-                        {
-                            new Container
-                            {
-                                RelativeSizeAxes = Axes.Both,
-                                Children = new Drawable[]
-                                {
-                                    new LatencyArea(10)
-                                    {
-                                        Width = 0.5f,
-                                        Anchor = Anchor.TopLeft,
-                                        Origin = Anchor.TopLeft,
-                                    },
-                                    new LatencyArea(0)
-                                    {
-                                        Width = 0.5f,
-                                        Anchor = Anchor.TopRight,
-                                        Origin = Anchor.TopRight,
-                                    },
-                                    new Box
-                                    {
-                                        Colour = Color4.Black,
-                                        Width = 50,
-                                        RelativeSizeAxes = Axes.Y,
-                                        Anchor = Anchor.TopCentre,
-                                        Origin = Anchor.TopCentre,
-                                    },
-                                }
-                            },
-                        },
-                        new Drawable[]
-                        {
-                            // footer content
-                        },
-                    }
-                }
-            };
-        }
-
-        public override void OnEntering(ScreenTransitionEvent e)
-        {
-            base.OnEntering(e);
-
-            previousFrameSyncMode = config.Get<FrameSync>(FrameworkSetting.FrameSync);
-            config.SetValue(FrameworkSetting.FrameSync, FrameSync.Unlimited);
-            // host.AllowBenchmarkUnlimitedFrames = true;
-        }
-
-        public override bool OnExiting(ScreenExitEvent e)
-        {
-            // host.AllowBenchmarkUnlimitedFrames = false;
-            config.SetValue(FrameworkSetting.FrameSync, previousFrameSyncMode);
-            return base.OnExiting(e);
-        }
-
-        public class LatencyArea : CompositeDrawable
-        {
-            private readonly int inducedLatency;
-
-            public LatencyArea(int inducedLatency)
-            {
-                this.inducedLatency = inducedLatency;
-                RelativeSizeAxes = Axes.Both;
-
-                InternalChildren = new Drawable[]
-                {
-                    new Box
-                    {
-                        Colour = Color4.Blue,
-                        RelativeSizeAxes = Axes.Both,
-                    },
-                    new LatencyMovableBox
-                    {
-                        RelativeSizeAxes = Axes.Both,
-                    },
-                    new LatencyCursorContainer
-                    {
-                        RelativeSizeAxes = Axes.Both,
-                    }
-                };
-            }
-
-            private long frameCount;
-
-            public override bool UpdateSubTree()
-            {
-                if (inducedLatency > 0 && ++frameCount % inducedLatency != 0)
-                    return false;
-
-                return base.UpdateSubTree();
-            }
-
-            public class LatencyMovableBox : CompositeDrawable
-            {
-                private Box box = null!;
-                private InputManager inputManager = null!;
-
-                public LatencyMovableBox()
-                {
-                    Masking = true;
-                }
-
-                protected override void LoadComplete()
-                {
-                    base.LoadComplete();
-
-                    inputManager = GetContainingInputManager();
-
-                    InternalChild = box = new Box
-                    {
-                        Size = new Vector2(40),
-                        Position = DrawSize / 2,
-                        Origin = Anchor.Centre,
-                    };
-                }
-
-                protected override bool OnHover(HoverEvent e) => false;
-
-                private double? lastFrameTime;
-
-                protected override void Update()
-                {
-                    base.Update();
-
-                    if (!IsHovered)
-                        return;
-
-                    if (lastFrameTime != null)
-                    {
-                        float movementAmount = (float)(Clock.CurrentTime - lastFrameTime);
-
-                        foreach (var key in inputManager.CurrentState.Keyboard.Keys)
-                        {
-                            switch (key)
-                            {
-                                case Key.Up:
-                                    box.Y -= movementAmount;
-                                    break;
-
-                                case Key.Down:
-                                    box.Y += movementAmount;
-                                    break;
-
-                                case Key.Left:
-                                    box.X -= movementAmount;
-                                    break;
-
-                                case Key.Right:
-                                    box.X += movementAmount;
-                                    break;
-                            }
-                        }
-                    }
-
-                    lastFrameTime = Clock.CurrentTime;
-                }
-            }
-
-            public class LatencyCursorContainer : CompositeDrawable
-            {
-                private readonly Circle cursor;
-                private InputManager inputManager = null!;
-
-                public LatencyCursorContainer()
-                {
-                    Masking = true;
-
-                    InternalChild = cursor = new Circle
-                    {
-                        Size = new Vector2(40),
-                        Origin = Anchor.Centre,
-                    };
-                }
-
-                protected override void LoadComplete()
-                {
-                    base.LoadComplete();
-
-                    inputManager = GetContainingInputManager();
-                }
-
-                protected override bool OnHover(HoverEvent e) => false;
-
-                protected override void Update()
-                {
-                    if (IsHovered)
-                    {
-                        cursor.Position = ToLocalSpace(inputManager.CurrentState.Mouse.Position);
-                        cursor.Alpha = 1;
-                    }
-                    else
-                    {
-                        cursor.Alpha = 0;
-                    }
-
-                    base.Update();
-                }
-            }
-        }
-    }
 }
diff --git a/osu.Game/Screens/LatencyComparerScreen.cs b/osu.Game/Screens/LatencyComparerScreen.cs
new file mode 100644
index 0000000000..b247337e4e
--- /dev/null
+++ b/osu.Game/Screens/LatencyComparerScreen.cs
@@ -0,0 +1,385 @@
+// 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 enable
+
+using System;
+using osu.Framework.Allocation;
+using osu.Framework.Configuration;
+using osu.Framework.Extensions.Color4Extensions;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Colour;
+using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.Shapes;
+using osu.Framework.Input;
+using osu.Framework.Input.Events;
+using osu.Framework.Screens;
+using osu.Framework.Utils;
+using osu.Game.Graphics;
+using osu.Game.Graphics.Containers;
+using osu.Game.Graphics.Sprites;
+using osu.Game.Overlays;
+using osu.Game.Overlays.Settings;
+using osuTK;
+using osuTK.Input;
+
+namespace osu.Game.Screens
+{
+    public class LatencyComparerScreen : OsuScreen
+    {
+        private FrameSync previousFrameSyncMode;
+
+        private readonly OsuSpriteText statusText;
+
+        public override bool HideOverlaysOnEnter => true;
+
+        public override bool CursorVisible => false;
+
+        public override float BackgroundParallaxAmount => 0;
+
+        private readonly Container latencyAreaContainer;
+
+        [Cached]
+        private readonly OverlayColourProvider overlayColourProvider = new OverlayColourProvider(OverlayColourScheme.Orange);
+
+        [Resolved]
+        private FrameworkConfigManager config { get; set; } = null!;
+
+        public LatencyComparerScreen()
+        {
+            InternalChildren = new Drawable[]
+            {
+                latencyAreaContainer = new Container
+                {
+                    RelativeSizeAxes = Axes.Both,
+                },
+                // Make sure the edge between the two comparisons can't be used to ascertain latency.
+                new Box
+                {
+                    Name = "separator",
+                    Colour = ColourInfo.GradientHorizontal(overlayColourProvider.Background6, overlayColourProvider.Background6.Opacity(0)),
+                    Width = 50,
+                    RelativeSizeAxes = Axes.Y,
+                    Anchor = Anchor.TopCentre,
+                    Origin = Anchor.TopLeft,
+                },
+                new Box
+                {
+                    Name = "separator",
+                    Colour = ColourInfo.GradientHorizontal(overlayColourProvider.Background6.Opacity(0), overlayColourProvider.Background6),
+                    Width = 50,
+                    RelativeSizeAxes = Axes.Y,
+                    Anchor = Anchor.TopCentre,
+                    Origin = Anchor.TopRight,
+                },
+                statusText = new OsuSpriteText
+                {
+                    Font = OsuFont.Default.With(size: 40),
+                    Anchor = Anchor.Centre,
+                    Origin = Anchor.Centre,
+                },
+            };
+        }
+
+        public override void OnEntering(ScreenTransitionEvent e)
+        {
+            base.OnEntering(e);
+
+            previousFrameSyncMode = config.Get<FrameSync>(FrameworkSetting.FrameSync);
+            config.SetValue(FrameworkSetting.FrameSync, FrameSync.Unlimited);
+            // host.AllowBenchmarkUnlimitedFrames = true;
+        }
+
+        public override bool OnExiting(ScreenExitEvent e)
+        {
+            // host.AllowBenchmarkUnlimitedFrames = false;
+            config.SetValue(FrameworkSetting.FrameSync, previousFrameSyncMode);
+            return base.OnExiting(e);
+        }
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            loadNextRound();
+        }
+
+        private int round;
+
+        private const int rounds_to_complete = 10;
+
+        private int correctCount;
+
+        private void recordResult(bool correct)
+        {
+            if (correct)
+                correctCount++;
+
+            if (round < rounds_to_complete)
+                loadNextRound();
+            else
+            {
+                showResults();
+            }
+        }
+
+        private void loadNextRound()
+        {
+            round++;
+            statusText.Text = $"Round {round} of {rounds_to_complete}";
+
+            latencyAreaContainer.Clear();
+
+            const int induced_latency = 1;
+
+            int betterSide = RNG.Next(0, 2);
+
+            latencyAreaContainer.Add(new LatencyArea(betterSide == 1 ? induced_latency : 0)
+            {
+                Width = 0.5f,
+                ReportBetter = () => recordResult(betterSide == 0)
+            });
+
+            latencyAreaContainer.Add(new LatencyArea(betterSide == 0 ? induced_latency : 0)
+            {
+                Width = 0.5f,
+                Anchor = Anchor.TopRight,
+                Origin = Anchor.TopRight,
+                ReportBetter = () => recordResult(betterSide == 1)
+            });
+        }
+
+        private void showResults()
+        {
+            AddInternal(new Container
+            {
+                RelativeSizeAxes = Axes.Both,
+                Children = new Drawable[]
+                {
+                    new Box
+                    {
+                        Colour = overlayColourProvider.Background1,
+                        RelativeSizeAxes = Axes.Both,
+                    },
+
+                    new OsuTextFlowContainer(cp => cp.Font = OsuFont.Default.With(size: 40))
+                    {
+                        Anchor = Anchor.Centre,
+                        Origin = Anchor.Centre,
+                        TextAnchor = Anchor.TopCentre,
+                        RelativeSizeAxes = Axes.X,
+                        AutoSizeAxes = Axes.Y,
+                        Text = $"You scored {correctCount} out of {rounds_to_complete} ({(float)correctCount / rounds_to_complete:P0})!"
+                    }
+                }
+            });
+        }
+
+        public class LatencyArea : CompositeDrawable
+        {
+            [Resolved]
+            private OverlayColourProvider overlayColourProvider { get; set; } = null!;
+
+            public Action? ReportBetter { get; set; }
+
+            private Drawable background = null!;
+
+            private readonly int inducedLatency;
+
+            public LatencyArea(int inducedLatency)
+            {
+                this.inducedLatency = inducedLatency;
+
+                RelativeSizeAxes = Axes.Both;
+                Masking = true;
+            }
+
+            protected override void LoadComplete()
+            {
+                base.LoadComplete();
+
+                InternalChildren = new[]
+                {
+                    background = new Box
+                    {
+                        Colour = overlayColourProvider.Background6,
+                        RelativeSizeAxes = Axes.Both,
+                    },
+                    new LatencyMovableBox
+                    {
+                        RelativeSizeAxes = Axes.Both,
+                    },
+                    new LatencyCursorContainer
+                    {
+                        RelativeSizeAxes = Axes.Both,
+                    },
+                    new Button
+                    {
+                        Text = "Feels better",
+                        Y = 20,
+                        Width = 0.8f,
+                        Anchor = Anchor.TopCentre,
+                        Origin = Anchor.TopCentre,
+                        Action = () => ReportBetter?.Invoke(),
+                    },
+                };
+
+                base.LoadComplete();
+                this.FadeInFromZero(500, Easing.OutQuint);
+            }
+
+            public class Button : SettingsButton
+            {
+                [Resolved]
+                private OverlayColourProvider overlayColourProvider { get; set; } = null!;
+
+                protected override void LoadComplete()
+                {
+                    base.LoadComplete();
+
+                    Height = 50;
+                    SpriteText.Colour = overlayColourProvider.Background6;
+                    SpriteText.Font = OsuFont.TorusAlternate.With(size: 34);
+                }
+            }
+
+            protected override bool OnHover(HoverEvent e)
+            {
+                background.FadeColour(overlayColourProvider.Background4, 200, Easing.OutQuint);
+                return base.OnHover(e);
+            }
+
+            protected override void OnHoverLost(HoverLostEvent e)
+            {
+                background.FadeColour(overlayColourProvider.Background6, 200, Easing.OutQuint);
+                base.OnHoverLost(e);
+            }
+
+            private long frameCount;
+
+            public override bool UpdateSubTree()
+            {
+                if (inducedLatency > 0 && ++frameCount % inducedLatency != 0)
+                    return false;
+
+                return base.UpdateSubTree();
+            }
+
+            public class LatencyMovableBox : CompositeDrawable
+            {
+                private Box box = null!;
+                private InputManager inputManager = null!;
+
+                [Resolved]
+                private OverlayColourProvider overlayColourProvider { get; set; } = null!;
+
+                protected override void LoadComplete()
+                {
+                    base.LoadComplete();
+
+                    inputManager = GetContainingInputManager();
+
+                    InternalChild = box = new Box
+                    {
+                        Size = new Vector2(40),
+                        RelativePositionAxes = Axes.Both,
+                        Position = new Vector2(0.5f),
+                        Origin = Anchor.Centre,
+                        Colour = overlayColourProvider.Colour1,
+                    };
+                }
+
+                protected override bool OnHover(HoverEvent e) => false;
+
+                private double? lastFrameTime;
+
+                protected override void Update()
+                {
+                    base.Update();
+
+                    if (!IsHovered)
+                    {
+                        lastFrameTime = null;
+                        return;
+                    }
+
+                    if (lastFrameTime != null)
+                    {
+                        float movementAmount = (float)(Clock.CurrentTime - lastFrameTime) / 400;
+
+                        foreach (var key in inputManager.CurrentState.Keyboard.Keys)
+                        {
+                            switch (key)
+                            {
+                                case Key.Up:
+                                    box.Y = MathHelper.Clamp(box.Y - movementAmount, 0.1f, 0.9f);
+                                    break;
+
+                                case Key.Down:
+                                    box.Y = MathHelper.Clamp(box.Y + movementAmount, 0.1f, 0.9f);
+                                    break;
+
+                                case Key.Z:
+                                case Key.Left:
+                                    box.X = MathHelper.Clamp(box.X - movementAmount, 0.1f, 0.9f);
+                                    break;
+
+                                case Key.X:
+                                case Key.Right:
+                                    box.X = MathHelper.Clamp(box.X + movementAmount, 0.1f, 0.9f);
+                                    break;
+                            }
+                        }
+                    }
+
+                    lastFrameTime = Clock.CurrentTime;
+                }
+            }
+
+            public class LatencyCursorContainer : CompositeDrawable
+            {
+                private Circle cursor = null!;
+                private InputManager inputManager = null!;
+
+                [Resolved]
+                private OverlayColourProvider overlayColourProvider { get; set; } = null!;
+
+                public LatencyCursorContainer()
+                {
+                    Masking = true;
+                }
+
+                protected override void LoadComplete()
+                {
+                    base.LoadComplete();
+
+                    InternalChild = cursor = new Circle
+                    {
+                        Size = new Vector2(40),
+                        Origin = Anchor.Centre,
+                        Colour = overlayColourProvider.Colour2,
+                    };
+
+                    inputManager = GetContainingInputManager();
+                }
+
+                protected override bool OnHover(HoverEvent e) => false;
+
+                protected override void Update()
+                {
+                    if (IsHovered)
+                    {
+                        cursor.Position = ToLocalSpace(inputManager.CurrentState.Mouse.Position);
+                        cursor.Alpha = 1;
+                    }
+                    else
+                    {
+                        cursor.Alpha = 0;
+                    }
+
+                    base.Update();
+                }
+            }
+        }
+    }
+}

From 20cfa5d83fbe783e3f0520c216c871ccc27d17c8 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 7 Jun 2022 14:40:28 +0900
Subject: [PATCH 5290/5547] Add button to access latency comparer from game

---
 .../Sections/DebugSettings/GeneralSettings.cs     | 15 ++++++++++-----
 1 file changed, 10 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Overlays/Settings/Sections/DebugSettings/GeneralSettings.cs b/osu.Game/Overlays/Settings/Sections/DebugSettings/GeneralSettings.cs
index 8833420523..318cdbd6a7 100644
--- a/osu.Game/Overlays/Settings/Sections/DebugSettings/GeneralSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/DebugSettings/GeneralSettings.cs
@@ -30,13 +30,18 @@ namespace osu.Game.Overlays.Settings.Sections.DebugSettings
                 {
                     LabelText = DebugSettingsStrings.BypassFrontToBackPass,
                     Current = config.GetBindable<bool>(DebugSetting.BypassFrontToBackPass)
+                },
+                new SettingsButton
+                {
+                    Text = DebugSettingsStrings.ImportFiles,
+                    Action = () => performer?.PerformFromScreen(menu => menu.Push(new FileImportScreen()))
+                },
+                new SettingsButton
+                {
+                    Text = @"Run latency comparer",
+                    Action = () => performer?.PerformFromScreen(menu => menu.Push(new LatencyComparerScreen()))
                 }
             };
-            Add(new SettingsButton
-            {
-                Text = DebugSettingsStrings.ImportFiles,
-                Action = () => performer?.PerformFromScreen(menu => menu.Push(new FileImportScreen()))
-            });
         }
     }
 }

From c323c67d7d20da709af17d690d4abe52a17edb0b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 7 Jun 2022 14:51:16 +0900
Subject: [PATCH 5291/5547] Allow increasing confidence by playing longer

---
 osu.Game/Screens/LatencyComparerScreen.cs | 123 ++++++++++++++--------
 1 file changed, 80 insertions(+), 43 deletions(-)

diff --git a/osu.Game/Screens/LatencyComparerScreen.cs b/osu.Game/Screens/LatencyComparerScreen.cs
index b247337e4e..c39760e5be 100644
--- a/osu.Game/Screens/LatencyComparerScreen.cs
+++ b/osu.Game/Screens/LatencyComparerScreen.cs
@@ -29,7 +29,7 @@ namespace osu.Game.Screens
     {
         private FrameSync previousFrameSyncMode;
 
-        private readonly OsuSpriteText statusText;
+        private readonly OsuTextFlowContainer statusText;
 
         public override bool HideOverlaysOnEnter => true;
 
@@ -37,7 +37,9 @@ namespace osu.Game.Screens
 
         public override float BackgroundParallaxAmount => 0;
 
-        private readonly Container latencyAreaContainer;
+        private readonly Container mainArea;
+
+        private readonly Container resultsArea;
 
         [Cached]
         private readonly OverlayColourProvider overlayColourProvider = new OverlayColourProvider(OverlayColourScheme.Orange);
@@ -49,7 +51,12 @@ namespace osu.Game.Screens
         {
             InternalChildren = new Drawable[]
             {
-                latencyAreaContainer = new Container
+                new Box
+                {
+                    Colour = overlayColourProvider.Background6,
+                    RelativeSizeAxes = Axes.Both,
+                },
+                mainArea = new Container
                 {
                     RelativeSizeAxes = Axes.Both,
                 },
@@ -72,11 +79,17 @@ namespace osu.Game.Screens
                     Anchor = Anchor.TopCentre,
                     Origin = Anchor.TopRight,
                 },
-                statusText = new OsuSpriteText
+                statusText = new OsuTextFlowContainer(cp => cp.Font = OsuFont.Default.With(size: 40))
                 {
-                    Font = OsuFont.Default.With(size: 40),
                     Anchor = Anchor.Centre,
                     Origin = Anchor.Centre,
+                    TextAnchor = Anchor.TopCentre,
+                    RelativeSizeAxes = Axes.X,
+                    AutoSizeAxes = Axes.Y,
+                },
+                resultsArea = new Container
+                {
+                    RelativeSizeAxes = Axes.Both,
                 },
             };
         }
@@ -109,13 +122,14 @@ namespace osu.Game.Screens
         private const int rounds_to_complete = 10;
 
         private int correctCount;
+        private int targetRoundCount = rounds_to_complete;
 
         private void recordResult(bool correct)
         {
             if (correct)
                 correctCount++;
 
-            if (round < rounds_to_complete)
+            if (round < targetRoundCount)
                 loadNextRound();
             else
             {
@@ -126,21 +140,21 @@ namespace osu.Game.Screens
         private void loadNextRound()
         {
             round++;
-            statusText.Text = $"Round {round} of {rounds_to_complete}";
+            statusText.Text = $"Round {round} of {targetRoundCount}";
 
-            latencyAreaContainer.Clear();
+            mainArea.Clear();
 
             const int induced_latency = 1;
 
             int betterSide = RNG.Next(0, 2);
 
-            latencyAreaContainer.Add(new LatencyArea(betterSide == 1 ? induced_latency : 0)
+            mainArea.Add(new LatencyArea(betterSide == 1 ? induced_latency : 0)
             {
                 Width = 0.5f,
                 ReportBetter = () => recordResult(betterSide == 0)
             });
 
-            latencyAreaContainer.Add(new LatencyArea(betterSide == 0 ? induced_latency : 0)
+            mainArea.Add(new LatencyArea(betterSide == 0 ? induced_latency : 0)
             {
                 Width = 0.5f,
                 Anchor = Anchor.TopRight,
@@ -151,25 +165,27 @@ namespace osu.Game.Screens
 
         private void showResults()
         {
-            AddInternal(new Container
+            mainArea.Clear();
+
+            statusText.Text = $"You scored {correctCount} out of {targetRoundCount} ({(float)correctCount / targetRoundCount:P0})!";
+
+            resultsArea.Add(new Container
             {
                 RelativeSizeAxes = Axes.Both,
                 Children = new Drawable[]
                 {
-                    new Box
-                    {
-                        Colour = overlayColourProvider.Background1,
-                        RelativeSizeAxes = Axes.Both,
-                    },
-
-                    new OsuTextFlowContainer(cp => cp.Font = OsuFont.Default.With(size: 40))
+                    new Button
                     {
+                        Text = "Increase confidence",
                         Anchor = Anchor.Centre,
                         Origin = Anchor.Centre,
-                        TextAnchor = Anchor.TopCentre,
-                        RelativeSizeAxes = Axes.X,
-                        AutoSizeAxes = Axes.Y,
-                        Text = $"You scored {correctCount} out of {rounds_to_complete} ({(float)correctCount / rounds_to_complete:P0})!"
+                        Y = 100,
+                        Action = () =>
+                        {
+                            resultsArea.Clear();
+                            targetRoundCount += rounds_to_complete;
+                            loadNextRound();
+                        }
                     }
                 }
             });
@@ -186,6 +202,12 @@ namespace osu.Game.Screens
 
             private readonly int inducedLatency;
 
+            private Container interactivePieces = null!;
+
+            private Button button = null!;
+
+            private long frameCount;
+
             public LatencyArea(int inducedLatency)
             {
                 this.inducedLatency = inducedLatency;
@@ -205,17 +227,26 @@ namespace osu.Game.Screens
                         Colour = overlayColourProvider.Background6,
                         RelativeSizeAxes = Axes.Both,
                     },
-                    new LatencyMovableBox
+                    interactivePieces = new Container
                     {
                         RelativeSizeAxes = Axes.Both,
+                        Alpha = 0,
+                        Children = new Drawable[]
+                        {
+                            new LatencyMovableBox
+                            {
+                                RelativeSizeAxes = Axes.Both,
+                            },
+                            new LatencyCursorContainer
+                            {
+                                RelativeSizeAxes = Axes.Both,
+                            },
+                        }
                     },
-                    new LatencyCursorContainer
-                    {
-                        RelativeSizeAxes = Axes.Both,
-                    },
-                    new Button
+                    button = new Button
                     {
                         Text = "Feels better",
+                        Alpha = 0,
                         Y = 20,
                         Width = 0.8f,
                         Anchor = Anchor.TopCentre,
@@ -226,20 +257,11 @@ namespace osu.Game.Screens
 
                 base.LoadComplete();
                 this.FadeInFromZero(500, Easing.OutQuint);
-            }
 
-            public class Button : SettingsButton
-            {
-                [Resolved]
-                private OverlayColourProvider overlayColourProvider { get; set; } = null!;
-
-                protected override void LoadComplete()
+                using (BeginDelayedSequence(500))
                 {
-                    base.LoadComplete();
-
-                    Height = 50;
-                    SpriteText.Colour = overlayColourProvider.Background6;
-                    SpriteText.Font = OsuFont.TorusAlternate.With(size: 34);
+                    interactivePieces.FadeIn(500, Easing.OutQuint);
+                    button.FadeIn(500, Easing.OutQuint);
                 }
             }
 
@@ -255,11 +277,9 @@ namespace osu.Game.Screens
                 base.OnHoverLost(e);
             }
 
-            private long frameCount;
-
             public override bool UpdateSubTree()
             {
-                if (inducedLatency > 0 && ++frameCount % inducedLatency != 0)
+                if (background?.Alpha == 1 && inducedLatency > 0 && ++frameCount % inducedLatency != 0)
                     return false;
 
                 return base.UpdateSubTree();
@@ -367,6 +387,8 @@ namespace osu.Game.Screens
 
                 protected override void Update()
                 {
+                    cursor.Colour = inputManager.CurrentState.Mouse.IsPressed(MouseButton.Left) ? overlayColourProvider.Content1 : overlayColourProvider.Colour2;
+
                     if (IsHovered)
                     {
                         cursor.Position = ToLocalSpace(inputManager.CurrentState.Mouse.Position);
@@ -381,5 +403,20 @@ namespace osu.Game.Screens
                 }
             }
         }
+
+        public class Button : SettingsButton
+        {
+            [Resolved]
+            private OverlayColourProvider overlayColourProvider { get; set; } = null!;
+
+            protected override void LoadComplete()
+            {
+                base.LoadComplete();
+
+                Height = 100;
+                SpriteText.Colour = overlayColourProvider.Background6;
+                SpriteText.Font = OsuFont.TorusAlternate.With(size: 34);
+            }
+        }
     }
 }

From 3bd8bbd297b623bc53e1b974afa2067ba92e4005 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 7 Jun 2022 15:21:19 +0900
Subject: [PATCH 5292/5547] Add explanatory text

---
 osu.Game/Screens/LatencyComparerScreen.cs | 21 +++++++++++++++++++--
 1 file changed, 19 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/LatencyComparerScreen.cs b/osu.Game/Screens/LatencyComparerScreen.cs
index c39760e5be..75bf7795ce 100644
--- a/osu.Game/Screens/LatencyComparerScreen.cs
+++ b/osu.Game/Screens/LatencyComparerScreen.cs
@@ -17,7 +17,6 @@ using osu.Framework.Screens;
 using osu.Framework.Utils;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
-using osu.Game.Graphics.Sprites;
 using osu.Game.Overlays;
 using osu.Game.Overlays.Settings;
 using osuTK;
@@ -37,6 +36,8 @@ namespace osu.Game.Screens
 
         public override float BackgroundParallaxAmount => 0;
 
+        private readonly OsuTextFlowContainer explanatoryText;
+
         private readonly Container mainArea;
 
         private readonly Container resultsArea;
@@ -79,6 +80,20 @@ namespace osu.Game.Screens
                     Anchor = Anchor.TopCentre,
                     Origin = Anchor.TopRight,
                 },
+                explanatoryText = new OsuTextFlowContainer(cp => cp.Font = OsuFont.Default.With(size: 20))
+                {
+                    Anchor = Anchor.TopCentre,
+                    Origin = Anchor.TopCentre,
+                    TextAnchor = Anchor.TopCentre,
+                    RelativeSizeAxes = Axes.X,
+                    AutoSizeAxes = Axes.Y,
+                    Y = 200,
+                    Text = @"Welcome to the latency comparer!
+Use the arrow keys or Z/X to move the square.
+You can click the targets but you don't have to.
+Do whatever you need to try and perceive the difference in latency, then choose your best side.
+",
+                },
                 statusText = new OsuTextFlowContainer(cp => cp.Font = OsuFont.Default.With(size: 40))
                 {
                     Anchor = Anchor.Centre,
@@ -126,6 +141,8 @@ namespace osu.Game.Screens
 
         private void recordResult(bool correct)
         {
+            explanatoryText.FadeOut(500, Easing.OutQuint);
+
             if (correct)
                 correctCount++;
 
@@ -198,7 +215,7 @@ namespace osu.Game.Screens
 
             public Action? ReportBetter { get; set; }
 
-            private Drawable background = null!;
+            private Drawable? background;
 
             private readonly int inducedLatency;
 

From a175defefd3bc40d98d916de5608da9b656742fd Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 7 Jun 2022 18:11:54 +0900
Subject: [PATCH 5293/5547] Add difficulty levels

---
 osu.Game/Screens/LatencyComparerScreen.cs | 110 ++++++++++++++--------
 1 file changed, 73 insertions(+), 37 deletions(-)

diff --git a/osu.Game/Screens/LatencyComparerScreen.cs b/osu.Game/Screens/LatencyComparerScreen.cs
index 75bf7795ce..689729fa68 100644
--- a/osu.Game/Screens/LatencyComparerScreen.cs
+++ b/osu.Game/Screens/LatencyComparerScreen.cs
@@ -4,6 +4,7 @@
 #nullable enable
 
 using System;
+using System.Diagnostics;
 using osu.Framework.Allocation;
 using osu.Framework.Configuration;
 using osu.Framework.Extensions.Color4Extensions;
@@ -45,9 +46,20 @@ namespace osu.Game.Screens
         [Cached]
         private readonly OverlayColourProvider overlayColourProvider = new OverlayColourProvider(OverlayColourScheme.Orange);
 
+        [Resolved]
+        private OsuColour colours { get; set; } = null!;
+
         [Resolved]
         private FrameworkConfigManager config { get; set; } = null!;
 
+        private const int rounds_to_complete = 5;
+
+        private int round;
+        private int correctCount;
+        private int targetRoundCount = rounds_to_complete;
+
+        private int difficulty = 1;
+
         public LatencyComparerScreen()
         {
             InternalChildren = new Drawable[]
@@ -82,12 +94,11 @@ namespace osu.Game.Screens
                 },
                 explanatoryText = new OsuTextFlowContainer(cp => cp.Font = OsuFont.Default.With(size: 20))
                 {
-                    Anchor = Anchor.TopCentre,
-                    Origin = Anchor.TopCentre,
+                    Anchor = Anchor.BottomCentre,
+                    Origin = Anchor.BottomCentre,
                     TextAnchor = Anchor.TopCentre,
                     RelativeSizeAxes = Axes.X,
                     AutoSizeAxes = Axes.Y,
-                    Y = 200,
                     Text = @"Welcome to the latency comparer!
 Use the arrow keys or Z/X to move the square.
 You can click the targets but you don't have to.
@@ -96,9 +107,10 @@ Do whatever you need to try and perceive the difference in latency, then choose
                 },
                 statusText = new OsuTextFlowContainer(cp => cp.Font = OsuFont.Default.With(size: 40))
                 {
-                    Anchor = Anchor.Centre,
-                    Origin = Anchor.Centre,
+                    Anchor = Anchor.TopCentre,
+                    Origin = Anchor.TopCentre,
                     TextAnchor = Anchor.TopCentre,
+                    Y = 200,
                     RelativeSizeAxes = Axes.X,
                     AutoSizeAxes = Axes.Y,
                 },
@@ -132,13 +144,6 @@ Do whatever you need to try and perceive the difference in latency, then choose
             loadNextRound();
         }
 
-        private int round;
-
-        private const int rounds_to_complete = 10;
-
-        private int correctCount;
-        private int targetRoundCount = rounds_to_complete;
-
         private void recordResult(bool correct)
         {
             explanatoryText.FadeOut(500, Easing.OutQuint);
@@ -157,21 +162,21 @@ Do whatever you need to try and perceive the difference in latency, then choose
         private void loadNextRound()
         {
             round++;
-            statusText.Text = $"Round {round} of {targetRoundCount}";
+            statusText.Text = $"Difficulty {difficulty}\nRound {round} of {targetRoundCount}";
 
             mainArea.Clear();
 
-            const int induced_latency = 1;
+            const int induced_latency = 500;
 
             int betterSide = RNG.Next(0, 2);
 
-            mainArea.Add(new LatencyArea(betterSide == 1 ? induced_latency : 0)
+            mainArea.Add(new LatencyArea(betterSide == 1 ? induced_latency / difficulty : 0)
             {
                 Width = 0.5f,
                 ReportBetter = () => recordResult(betterSide == 0)
             });
 
-            mainArea.Add(new LatencyArea(betterSide == 0 ? induced_latency : 0)
+            mainArea.Add(new LatencyArea(betterSide == 0 ? induced_latency / difficulty : 0)
             {
                 Width = 0.5f,
                 Anchor = Anchor.TopRight,
@@ -186,28 +191,70 @@ Do whatever you need to try and perceive the difference in latency, then choose
 
             statusText.Text = $"You scored {correctCount} out of {targetRoundCount} ({(float)correctCount / targetRoundCount:P0})!";
 
-            resultsArea.Add(new Container
+            resultsArea.Add(new FillFlowContainer
             {
                 RelativeSizeAxes = Axes.Both,
+                Y = 100,
+                Spacing = new Vector2(20),
                 Children = new Drawable[]
                 {
                     new Button
                     {
-                        Text = "Increase confidence",
+                        Text = "Increase confidence at current level",
                         Anchor = Anchor.Centre,
                         Origin = Anchor.Centre,
-                        Y = 100,
                         Action = () =>
                         {
                             resultsArea.Clear();
                             targetRoundCount += rounds_to_complete;
                             loadNextRound();
                         }
+                    },
+                    new Button
+                    {
+                        Text = "Increase difficulty",
+                        BackgroundColour = colours.Red2,
+                        Anchor = Anchor.Centre,
+                        Origin = Anchor.Centre,
+                        Action = () =>
+                        {
+                            changeDifficulty(difficulty + 1);
+                        }
+                    },
+                    new Button
+                    {
+                        Text = "Decrease difficulty",
+                        BackgroundColour = colours.Green,
+                        Anchor = Anchor.Centre,
+                        Origin = Anchor.Centre,
+                        Enabled = { Value = difficulty > 1 },
+                        Action = () =>
+                        {
+                            resultsArea.Clear();
+                            correctCount = 0;
+                            targetRoundCount = rounds_to_complete;
+                            difficulty--;
+                            loadNextRound();
+                        }
                     }
                 }
             });
         }
 
+        private void changeDifficulty(int diff)
+        {
+            Debug.Assert(diff > 0);
+
+            resultsArea.Clear();
+
+            correctCount = 0;
+            round = 0;
+
+            targetRoundCount = rounds_to_complete;
+            difficulty = diff;
+            loadNextRound();
+        }
+
         public class LatencyArea : CompositeDrawable
         {
             [Resolved]
@@ -219,10 +266,6 @@ Do whatever you need to try and perceive the difference in latency, then choose
 
             private readonly int inducedLatency;
 
-            private Container interactivePieces = null!;
-
-            private Button button = null!;
-
             private long frameCount;
 
             public LatencyArea(int inducedLatency)
@@ -244,10 +287,9 @@ Do whatever you need to try and perceive the difference in latency, then choose
                         Colour = overlayColourProvider.Background6,
                         RelativeSizeAxes = Axes.Both,
                     },
-                    interactivePieces = new Container
+                    new Container
                     {
                         RelativeSizeAxes = Axes.Both,
-                        Alpha = 0,
                         Children = new Drawable[]
                         {
                             new LatencyMovableBox
@@ -260,10 +302,9 @@ Do whatever you need to try and perceive the difference in latency, then choose
                             },
                         }
                     },
-                    button = new Button
+                    new Button
                     {
                         Text = "Feels better",
-                        Alpha = 0,
                         Y = 20,
                         Width = 0.8f,
                         Anchor = Anchor.TopCentre,
@@ -271,15 +312,6 @@ Do whatever you need to try and perceive the difference in latency, then choose
                         Action = () => ReportBetter?.Invoke(),
                     },
                 };
-
-                base.LoadComplete();
-                this.FadeInFromZero(500, Easing.OutQuint);
-
-                using (BeginDelayedSequence(500))
-                {
-                    interactivePieces.FadeIn(500, Easing.OutQuint);
-                    button.FadeIn(500, Easing.OutQuint);
-                }
             }
 
             protected override bool OnHover(HoverEvent e)
@@ -344,7 +376,11 @@ Do whatever you need to try and perceive the difference in latency, then choose
                     {
                         float movementAmount = (float)(Clock.CurrentTime - lastFrameTime) / 400;
 
-                        foreach (var key in inputManager.CurrentState.Keyboard.Keys)
+                        var buttons = inputManager.CurrentState.Keyboard.Keys;
+
+                        box.Colour = buttons.HasAnyButtonPressed ? overlayColourProvider.Content1 : overlayColourProvider.Colour1;
+
+                        foreach (var key in buttons)
                         {
                             switch (key)
                             {

From 3fc8ac0ec72f51c47dab588acbea8679f66b90bd Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 7 Jun 2022 18:27:42 +0900
Subject: [PATCH 5294/5547] Add key bindings everywhere

---
 osu.Game/Graphics/UserInterface/OsuButton.cs |  2 +-
 osu.Game/Screens/LatencyComparerScreen.cs    | 56 +++++++++++++-------
 2 files changed, 38 insertions(+), 20 deletions(-)

diff --git a/osu.Game/Graphics/UserInterface/OsuButton.cs b/osu.Game/Graphics/UserInterface/OsuButton.cs
index 08514d94c3..044df13152 100644
--- a/osu.Game/Graphics/UserInterface/OsuButton.cs
+++ b/osu.Game/Graphics/UserInterface/OsuButton.cs
@@ -20,7 +20,7 @@ namespace osu.Game.Graphics.UserInterface
     /// </summary>
     public class OsuButton : Button
     {
-        public LocalisableString Text
+        public virtual LocalisableString Text
         {
             get => SpriteText?.Text ?? default;
             set
diff --git a/osu.Game/Screens/LatencyComparerScreen.cs b/osu.Game/Screens/LatencyComparerScreen.cs
index 689729fa68..b61905a1e7 100644
--- a/osu.Game/Screens/LatencyComparerScreen.cs
+++ b/osu.Game/Screens/LatencyComparerScreen.cs
@@ -14,8 +14,10 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Input;
 using osu.Framework.Input.Events;
+using osu.Framework.Localisation;
 using osu.Framework.Screens;
 using osu.Framework.Utils;
+using osu.Game.Extensions;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Overlays;
@@ -170,13 +172,13 @@ Do whatever you need to try and perceive the difference in latency, then choose
 
             int betterSide = RNG.Next(0, 2);
 
-            mainArea.Add(new LatencyArea(betterSide == 1 ? induced_latency / difficulty : 0)
+            mainArea.Add(new LatencyArea(Key.Number1, betterSide == 1 ? induced_latency / difficulty : 0)
             {
                 Width = 0.5f,
                 ReportBetter = () => recordResult(betterSide == 0)
             });
 
-            mainArea.Add(new LatencyArea(betterSide == 0 ? induced_latency / difficulty : 0)
+            mainArea.Add(new LatencyArea(Key.Number2, betterSide == 0 ? induced_latency / difficulty : 0)
             {
                 Width = 0.5f,
                 Anchor = Anchor.TopRight,
@@ -198,7 +200,7 @@ Do whatever you need to try and perceive the difference in latency, then choose
                 Spacing = new Vector2(20),
                 Children = new Drawable[]
                 {
-                    new Button
+                    new Button(Key.R)
                     {
                         Text = "Increase confidence at current level",
                         Anchor = Anchor.Centre,
@@ -210,32 +212,22 @@ Do whatever you need to try and perceive the difference in latency, then choose
                             loadNextRound();
                         }
                     },
-                    new Button
+                    new Button(Key.I)
                     {
                         Text = "Increase difficulty",
                         BackgroundColour = colours.Red2,
                         Anchor = Anchor.Centre,
                         Origin = Anchor.Centre,
-                        Action = () =>
-                        {
-                            changeDifficulty(difficulty + 1);
-                        }
+                        Action = () => changeDifficulty(difficulty + 1)
                     },
-                    new Button
+                    new Button(Key.D)
                     {
                         Text = "Decrease difficulty",
                         BackgroundColour = colours.Green,
                         Anchor = Anchor.Centre,
                         Origin = Anchor.Centre,
+                        Action = () => changeDifficulty(difficulty - 1),
                         Enabled = { Value = difficulty > 1 },
-                        Action = () =>
-                        {
-                            resultsArea.Clear();
-                            correctCount = 0;
-                            targetRoundCount = rounds_to_complete;
-                            difficulty--;
-                            loadNextRound();
-                        }
                     }
                 }
             });
@@ -264,12 +256,14 @@ Do whatever you need to try and perceive the difference in latency, then choose
 
             private Drawable? background;
 
+            private readonly Key key;
             private readonly int inducedLatency;
 
             private long frameCount;
 
-            public LatencyArea(int inducedLatency)
+            public LatencyArea(Key key, int inducedLatency)
             {
+                this.key = key;
                 this.inducedLatency = inducedLatency;
 
                 RelativeSizeAxes = Axes.Both;
@@ -302,7 +296,7 @@ Do whatever you need to try and perceive the difference in latency, then choose
                             },
                         }
                     },
-                    new Button
+                    new Button(key)
                     {
                         Text = "Feels better",
                         Y = 20,
@@ -459,6 +453,30 @@ Do whatever you need to try and perceive the difference in latency, then choose
 
         public class Button : SettingsButton
         {
+            private readonly Key key;
+
+            public Button(Key key)
+            {
+                this.key = key;
+            }
+
+            public override LocalisableString Text
+            {
+                get => base.Text;
+                set => base.Text = $"{value} (Press {key.ToString().Replace("Number", string.Empty)})";
+            }
+
+            protected override bool OnKeyDown(KeyDownEvent e)
+            {
+                if (!e.Repeat && e.Key == key)
+                {
+                    TriggerClick();
+                    return true;
+                }
+
+                return base.OnKeyDown(e);
+            }
+
             [Resolved]
             private OverlayColourProvider overlayColourProvider { get; set; } = null!;
 

From 8578f12a58a5b4043fa97b512686a227a90b4067 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 7 Jun 2022 18:35:10 +0900
Subject: [PATCH 5295/5547] Fix taiko circle fills missing after rewind

---
 osu.Game.Rulesets.Taiko/UI/TaikoPlayfield.cs | 13 ++++++++-----
 1 file changed, 8 insertions(+), 5 deletions(-)

diff --git a/osu.Game.Rulesets.Taiko/UI/TaikoPlayfield.cs b/osu.Game.Rulesets.Taiko/UI/TaikoPlayfield.cs
index 504b10e9bc..2dd332fc13 100644
--- a/osu.Game.Rulesets.Taiko/UI/TaikoPlayfield.cs
+++ b/osu.Game.Rulesets.Taiko/UI/TaikoPlayfield.cs
@@ -8,6 +8,7 @@ using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Pooling;
+using osu.Framework.Graphics.Primitives;
 using osu.Game.Graphics;
 using osu.Game.Rulesets.Objects.Drawables;
 using osu.Game.Rulesets.Judgements;
@@ -321,12 +322,14 @@ namespace osu.Game.Rulesets.Taiko.UI
 
         private class ProxyContainer : LifetimeManagementContainer
         {
-            public new MarginPadding Padding
-            {
-                set => base.Padding = value;
-            }
-
             public void Add(Drawable proxy) => AddInternal(proxy);
+
+            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.
+                return false;
+            }
         }
     }
 }

From c0e88d957730239a3a7ad6c24bbecaf1e43a0432 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 7 Jun 2022 19:03:26 +0900
Subject: [PATCH 5296/5547] Add better messaging and pass/fail cutoff

---
 osu.Game/Screens/LatencyComparerScreen.cs | 89 +++++++++++++++++++++--
 1 file changed, 83 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Screens/LatencyComparerScreen.cs b/osu.Game/Screens/LatencyComparerScreen.cs
index b61905a1e7..31d2a56770 100644
--- a/osu.Game/Screens/LatencyComparerScreen.cs
+++ b/osu.Game/Screens/LatencyComparerScreen.cs
@@ -15,9 +15,10 @@ using osu.Framework.Graphics.Shapes;
 using osu.Framework.Input;
 using osu.Framework.Input.Events;
 using osu.Framework.Localisation;
+using osu.Framework.Platform;
+using osu.Framework.Platform.Windows;
 using osu.Framework.Screens;
 using osu.Framework.Utils;
-using osu.Game.Extensions;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Overlays;
@@ -30,6 +31,7 @@ namespace osu.Game.Screens
     public class LatencyComparerScreen : OsuScreen
     {
         private FrameSync previousFrameSyncMode;
+        private double previousActiveHz;
 
         private readonly OsuTextFlowContainer statusText;
 
@@ -45,6 +47,11 @@ namespace osu.Game.Screens
 
         private readonly Container resultsArea;
 
+        /// <summary>
+        /// The rate at which the game host should attempt to run.
+        /// </summary>
+        private const int target_host_update_frames = 4000;
+
         [Cached]
         private readonly OverlayColourProvider overlayColourProvider = new OverlayColourProvider(OverlayColourScheme.Orange);
 
@@ -62,6 +69,9 @@ namespace osu.Game.Screens
 
         private int difficulty = 1;
 
+        [Resolved]
+        private GameHost host { get; set; } = null!;
+
         public LatencyComparerScreen()
         {
             InternalChildren = new Drawable[]
@@ -128,7 +138,9 @@ Do whatever you need to try and perceive the difference in latency, then choose
             base.OnEntering(e);
 
             previousFrameSyncMode = config.Get<FrameSync>(FrameworkSetting.FrameSync);
+            previousActiveHz = host.UpdateThread.ActiveHz;
             config.SetValue(FrameworkSetting.FrameSync, FrameSync.Unlimited);
+            host.UpdateThread.ActiveHz = target_host_update_frames;
             // host.AllowBenchmarkUnlimitedFrames = true;
         }
 
@@ -136,6 +148,7 @@ Do whatever you need to try and perceive the difference in latency, then choose
         {
             // host.AllowBenchmarkUnlimitedFrames = false;
             config.SetValue(FrameworkSetting.FrameSync, previousFrameSyncMode);
+            host.UpdateThread.ActiveHz = previousActiveHz;
             return base.OnExiting(e);
         }
 
@@ -191,7 +204,33 @@ Do whatever you need to try and perceive the difference in latency, then choose
         {
             mainArea.Clear();
 
-            statusText.Text = $"You scored {correctCount} out of {targetRoundCount} ({(float)correctCount / targetRoundCount:P0})!";
+            var displayMode = host.Window.CurrentDisplayMode.Value;
+
+            string exclusive = "unknown";
+
+            if (host.Window is WindowsWindow windowsWindow)
+                exclusive = windowsWindow.FullscreenCapability.ToString();
+
+            statusText.Clear();
+
+            float successRate = (float)correctCount / targetRoundCount;
+            bool isPass = successRate > 0.8f;
+
+            statusText.AddParagraph($"You scored {correctCount} out of {targetRoundCount} ({successRate:P0})!", cp => cp.Colour = isPass ? colours.Green : colours.Red);
+
+            statusText.AddParagraph($"Level {difficulty} (comparing {host.UpdateThread.Clock.FramesPerSecond:N0}hz and {mapDifficultyToTargetFrameRate(difficulty):N0}hz)",
+                cp => cp.Font = OsuFont.Default.With(size: 15));
+
+            statusText.AddParagraph($"Refresh rate: {displayMode.RefreshRate:N0} ExclusiveFullscren: {exclusive}", cp => cp.Font = OsuFont.Default.With(size: 15));
+
+            string cannotIncreaseReason = string.Empty;
+
+            if (!isPass)
+                cannotIncreaseReason = "You didn't score high enough (over 80% required)!";
+            else if (mapDifficultyToTargetFrameRate(difficulty + 1) > target_host_update_frames)
+                cannotIncreaseReason = "You've reached the limits of this comparison mode.";
+            else if (mapDifficultyToTargetFrameRate(difficulty + 1) < host.UpdateThread.ActiveHz)
+                cannotIncreaseReason = "Game is not running fast enough to test this level";
 
             resultsArea.Add(new FillFlowContainer
             {
@@ -205,6 +244,7 @@ Do whatever you need to try and perceive the difference in latency, then choose
                         Text = "Increase confidence at current level",
                         Anchor = Anchor.Centre,
                         Origin = Anchor.Centre,
+                        TooltipText = "The longer you chain, the more sure you will be!",
                         Action = () =>
                         {
                             resultsArea.Clear();
@@ -218,16 +258,17 @@ Do whatever you need to try and perceive the difference in latency, then choose
                         BackgroundColour = colours.Red2,
                         Anchor = Anchor.Centre,
                         Origin = Anchor.Centre,
-                        Action = () => changeDifficulty(difficulty + 1)
+                        Action = () => changeDifficulty(difficulty + 1),
+                        Enabled = { Value = string.IsNullOrEmpty(cannotIncreaseReason) },
+                        TooltipText = cannotIncreaseReason
                     },
                     new Button(Key.D)
                     {
-                        Text = "Decrease difficulty",
+                        Text = difficulty == 1 ? "Restart" : "Decrease difficulty",
                         BackgroundColour = colours.Green,
                         Anchor = Anchor.Centre,
                         Origin = Anchor.Centre,
-                        Action = () => changeDifficulty(difficulty - 1),
-                        Enabled = { Value = difficulty > 1 },
+                        Action = () => changeDifficulty(Math.Max(difficulty - 1, 1)),
                     }
                 }
             });
@@ -247,6 +288,42 @@ Do whatever you need to try and perceive the difference in latency, then choose
             loadNextRound();
         }
 
+        private static int mapDifficultyToTargetFrameRate(int difficulty)
+        {
+            switch (difficulty)
+            {
+                case 1:
+                    return 15;
+
+                case 2:
+                    return 30;
+
+                case 3:
+                    return 45;
+
+                case 4:
+                    return 60;
+
+                case 5:
+                    return 120;
+
+                case 6:
+                    return 240;
+
+                case 7:
+                    return 480;
+
+                case 8:
+                    return 720;
+
+                case 9:
+                    return 960;
+
+                default:
+                    return 1000 + ((difficulty - 10) * 500);
+            }
+        }
+
         public class LatencyArea : CompositeDrawable
         {
             [Resolved]

From 2e7a96621896904db8976b75575ed6700b9a05c3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 7 Jun 2022 19:31:56 +0900
Subject: [PATCH 5297/5547] Add proper frame rate limiting and fix mouse cursor
 missing at results

---
 osu.Game/Screens/LatencyComparerScreen.cs | 50 ++++++++++++-----------
 1 file changed, 26 insertions(+), 24 deletions(-)

diff --git a/osu.Game/Screens/LatencyComparerScreen.cs b/osu.Game/Screens/LatencyComparerScreen.cs
index 31d2a56770..405b13cfc1 100644
--- a/osu.Game/Screens/LatencyComparerScreen.cs
+++ b/osu.Game/Screens/LatencyComparerScreen.cs
@@ -37,7 +37,7 @@ namespace osu.Game.Screens
 
         public override bool HideOverlaysOnEnter => true;
 
-        public override bool CursorVisible => false;
+        public override bool CursorVisible => mainArea.Count == 0;
 
         public override float BackgroundParallaxAmount => 0;
 
@@ -181,17 +181,15 @@ Do whatever you need to try and perceive the difference in latency, then choose
 
             mainArea.Clear();
 
-            const int induced_latency = 500;
-
             int betterSide = RNG.Next(0, 2);
 
-            mainArea.Add(new LatencyArea(Key.Number1, betterSide == 1 ? induced_latency / difficulty : 0)
+            mainArea.Add(new LatencyArea(Key.Number1, betterSide == 1 ? mapDifficultyToTargetFrameRate(difficulty) : 0)
             {
                 Width = 0.5f,
                 ReportBetter = () => recordResult(betterSide == 0)
             });
 
-            mainArea.Add(new LatencyArea(Key.Number2, betterSide == 0 ? induced_latency / difficulty : 0)
+            mainArea.Add(new LatencyArea(Key.Number2, betterSide == 0 ? mapDifficultyToTargetFrameRate(difficulty) : 0)
             {
                 Width = 0.5f,
                 Anchor = Anchor.TopRight,
@@ -218,7 +216,7 @@ Do whatever you need to try and perceive the difference in latency, then choose
 
             statusText.AddParagraph($"You scored {correctCount} out of {targetRoundCount} ({successRate:P0})!", cp => cp.Colour = isPass ? colours.Green : colours.Red);
 
-            statusText.AddParagraph($"Level {difficulty} (comparing {host.UpdateThread.Clock.FramesPerSecond:N0}hz and {mapDifficultyToTargetFrameRate(difficulty):N0}hz)",
+            statusText.AddParagraph($"Level {difficulty} (comparing {mapDifficultyToTargetFrameRate(difficulty):N0}hz with {host.UpdateThread.Clock.FramesPerSecond:N0}hz)",
                 cp => cp.Font = OsuFont.Default.With(size: 15));
 
             statusText.AddParagraph($"Refresh rate: {displayMode.RefreshRate:N0} ExclusiveFullscren: {exclusive}", cp => cp.Font = OsuFont.Default.With(size: 15));
@@ -229,7 +227,7 @@ Do whatever you need to try and perceive the difference in latency, then choose
                 cannotIncreaseReason = "You didn't score high enough (over 80% required)!";
             else if (mapDifficultyToTargetFrameRate(difficulty + 1) > target_host_update_frames)
                 cannotIncreaseReason = "You've reached the limits of this comparison mode.";
-            else if (mapDifficultyToTargetFrameRate(difficulty + 1) < host.UpdateThread.ActiveHz)
+            else if (mapDifficultyToTargetFrameRate(difficulty + 1) > Clock.FramesPerSecond)
                 cannotIncreaseReason = "Game is not running fast enough to test this level";
 
             resultsArea.Add(new FillFlowContainer
@@ -244,13 +242,14 @@ Do whatever you need to try and perceive the difference in latency, then choose
                         Text = "Increase confidence at current level",
                         Anchor = Anchor.Centre,
                         Origin = Anchor.Centre,
-                        TooltipText = "The longer you chain, the more sure you will be!",
                         Action = () =>
                         {
                             resultsArea.Clear();
                             targetRoundCount += rounds_to_complete;
                             loadNextRound();
-                        }
+                        },
+                        TooltipText = isPass ? "The longer you chain, the more sure you will be!" : "You've reached your limits",
+                        Enabled = { Value = string.IsNullOrEmpty(cannotIncreaseReason) },
                     },
                     new Button(Key.I)
                     {
@@ -334,14 +333,12 @@ Do whatever you need to try and perceive the difference in latency, then choose
             private Drawable? background;
 
             private readonly Key key;
-            private readonly int inducedLatency;
+            private readonly int targetFrameRate;
 
-            private long frameCount;
-
-            public LatencyArea(Key key, int inducedLatency)
+            public LatencyArea(Key key, int targetFrameRate)
             {
                 this.key = key;
-                this.inducedLatency = inducedLatency;
+                this.targetFrameRate = targetFrameRate;
 
                 RelativeSizeAxes = Axes.Both;
                 Masking = true;
@@ -358,6 +355,15 @@ Do whatever you need to try and perceive the difference in latency, then choose
                         Colour = overlayColourProvider.Background6,
                         RelativeSizeAxes = Axes.Both,
                     },
+                    new Button(key)
+                    {
+                        Text = "Feels better",
+                        Y = 20,
+                        Width = 0.8f,
+                        Anchor = Anchor.TopCentre,
+                        Origin = Anchor.TopCentre,
+                        Action = () => ReportBetter?.Invoke(),
+                    },
                     new Container
                     {
                         RelativeSizeAxes = Axes.Both,
@@ -373,15 +379,6 @@ Do whatever you need to try and perceive the difference in latency, then choose
                             },
                         }
                     },
-                    new Button(key)
-                    {
-                        Text = "Feels better",
-                        Y = 20,
-                        Width = 0.8f,
-                        Anchor = Anchor.TopCentre,
-                        Origin = Anchor.TopCentre,
-                        Action = () => ReportBetter?.Invoke(),
-                    },
                 };
             }
 
@@ -397,11 +394,16 @@ Do whatever you need to try and perceive the difference in latency, then choose
                 base.OnHoverLost(e);
             }
 
+            private double lastFrameTime;
+
             public override bool UpdateSubTree()
             {
-                if (background?.Alpha == 1 && inducedLatency > 0 && ++frameCount % inducedLatency != 0)
+                double elapsed = Clock.CurrentTime - lastFrameTime;
+                if (targetFrameRate > 0 && elapsed < 1000.0 / targetFrameRate)
                     return false;
 
+                lastFrameTime = Clock.CurrentTime;
+
                 return base.UpdateSubTree();
             }
 

From 43a04010a784c3284a15a1c38afc0a0266b2fc5d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 7 Jun 2022 19:43:33 +0900
Subject: [PATCH 5298/5547] Add display of polling rate

---
 osu.Game/Screens/LatencyComparerScreen.cs | 17 +++++++++++++++--
 1 file changed, 15 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/LatencyComparerScreen.cs b/osu.Game/Screens/LatencyComparerScreen.cs
index 405b13cfc1..ba3355110d 100644
--- a/osu.Game/Screens/LatencyComparerScreen.cs
+++ b/osu.Game/Screens/LatencyComparerScreen.cs
@@ -69,6 +69,9 @@ namespace osu.Game.Screens
 
         private int difficulty = 1;
 
+        private double lastPoll;
+        private int pollingMax;
+
         [Resolved]
         private GameHost host { get; set; } = null!;
 
@@ -133,6 +136,14 @@ Do whatever you need to try and perceive the difference in latency, then choose
             };
         }
 
+        protected override bool OnMouseMove(MouseMoveEvent e)
+        {
+            if (lastPoll > 0)
+                pollingMax = (int)Math.Max(pollingMax, 1000 / (Clock.CurrentTime - lastPoll));
+            lastPoll = Clock.CurrentTime;
+            return base.OnMouseMove(e);
+        }
+
         public override void OnEntering(ScreenTransitionEvent e)
         {
             base.OnEntering(e);
@@ -217,9 +228,9 @@ Do whatever you need to try and perceive the difference in latency, then choose
             statusText.AddParagraph($"You scored {correctCount} out of {targetRoundCount} ({successRate:P0})!", cp => cp.Colour = isPass ? colours.Green : colours.Red);
 
             statusText.AddParagraph($"Level {difficulty} (comparing {mapDifficultyToTargetFrameRate(difficulty):N0}hz with {host.UpdateThread.Clock.FramesPerSecond:N0}hz)",
-                cp => cp.Font = OsuFont.Default.With(size: 15));
+                cp => cp.Font = OsuFont.Default.With(size: 24));
 
-            statusText.AddParagraph($"Refresh rate: {displayMode.RefreshRate:N0} ExclusiveFullscren: {exclusive}", cp => cp.Font = OsuFont.Default.With(size: 15));
+            statusText.AddParagraph($"Input: {pollingMax}hz Monitor: {displayMode.RefreshRate:N0}hz Exclusive: {exclusive}", cp => cp.Font = OsuFont.Default.With(size: 15));
 
             string cannotIncreaseReason = string.Empty;
 
@@ -281,6 +292,8 @@ Do whatever you need to try and perceive the difference in latency, then choose
 
             correctCount = 0;
             round = 0;
+            pollingMax = 0;
+            lastPoll = 0;
 
             targetRoundCount = rounds_to_complete;
             difficulty = diff;

From 146225d87eca2222979b892d01074643c2c5b00d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 7 Jun 2022 20:02:26 +0900
Subject: [PATCH 5299/5547] Fix multiple issues with layout and text

---
 osu.Game/Screens/LatencyComparerScreen.cs | 27 +++++++++++++++++------
 1 file changed, 20 insertions(+), 7 deletions(-)

diff --git a/osu.Game/Screens/LatencyComparerScreen.cs b/osu.Game/Screens/LatencyComparerScreen.cs
index ba3355110d..0af0ab8419 100644
--- a/osu.Game/Screens/LatencyComparerScreen.cs
+++ b/osu.Game/Screens/LatencyComparerScreen.cs
@@ -12,6 +12,7 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Colour;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
+using osu.Framework.Graphics.Sprites;
 using osu.Framework.Input;
 using osu.Framework.Input.Events;
 using osu.Framework.Localisation;
@@ -125,7 +126,7 @@ Do whatever you need to try and perceive the difference in latency, then choose
                     Anchor = Anchor.TopCentre,
                     Origin = Anchor.TopCentre,
                     TextAnchor = Anchor.TopCentre,
-                    Y = 200,
+                    Y = 150,
                     RelativeSizeAxes = Axes.X,
                     AutoSizeAxes = Axes.Y,
                 },
@@ -225,12 +226,21 @@ Do whatever you need to try and perceive the difference in latency, then choose
             float successRate = (float)correctCount / targetRoundCount;
             bool isPass = successRate > 0.8f;
 
-            statusText.AddParagraph($"You scored {correctCount} out of {targetRoundCount} ({successRate:P0})!", cp => cp.Colour = isPass ? colours.Green : colours.Red);
-
-            statusText.AddParagraph($"Level {difficulty} (comparing {mapDifficultyToTargetFrameRate(difficulty):N0}hz with {host.UpdateThread.Clock.FramesPerSecond:N0}hz)",
+            statusText.AddParagraph($"You scored {correctCount} out of {targetRoundCount} ({successRate:0%})!", cp => cp.Colour = isPass ? colours.Green : colours.Red);
+            statusText.AddParagraph($"Level {difficulty} ({mapDifficultyToTargetFrameRate(difficulty):N0} hz)",
                 cp => cp.Font = OsuFont.Default.With(size: 24));
 
-            statusText.AddParagraph($"Input: {pollingMax}hz Monitor: {displayMode.RefreshRate:N0}hz Exclusive: {exclusive}", cp => cp.Font = OsuFont.Default.With(size: 15));
+            statusText.AddParagraph(string.Empty);
+            statusText.AddParagraph(string.Empty);
+            statusText.AddIcon(isPass ? FontAwesome.Regular.CheckCircle : FontAwesome.Regular.TimesCircle, cp => cp.Colour = isPass ? colours.Green : colours.Red);
+            statusText.AddParagraph(string.Empty);
+
+            statusText.AddParagraph($"Polling: {pollingMax} hz Monitor: {displayMode.RefreshRate:N0} hz Exclusive: {exclusive}", cp => cp.Font = OsuFont.Default.With(size: 15));
+
+            statusText.AddParagraph($"Input: {host.InputThread.Clock.FramesPerSecond} hz "
+                                    + $"Update: {host.UpdateThread.Clock.FramesPerSecond} hz "
+                                    + $"Draw: {host.DrawThread.Clock.FramesPerSecond} hz"
+                , cp => cp.Font = OsuFont.Default.With(size: 15));
 
             string cannotIncreaseReason = string.Empty;
 
@@ -243,9 +253,12 @@ Do whatever you need to try and perceive the difference in latency, then choose
 
             resultsArea.Add(new FillFlowContainer
             {
-                RelativeSizeAxes = Axes.Both,
-                Y = 100,
+                RelativeSizeAxes = Axes.X,
+                AutoSizeAxes = Axes.Y,
+                Anchor = Anchor.BottomLeft,
+                Origin = Anchor.BottomLeft,
                 Spacing = new Vector2(20),
+                Padding = new MarginPadding(20),
                 Children = new Drawable[]
                 {
                     new Button(Key.R)

From 00a6cbe53f623fc4e1cc058e305ba526895a7813 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 7 Jun 2022 20:03:49 +0900
Subject: [PATCH 5300/5547] Allow using J/K to move box as well

---
 osu.Game/Screens/LatencyComparerScreen.cs | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Screens/LatencyComparerScreen.cs b/osu.Game/Screens/LatencyComparerScreen.cs
index 0af0ab8419..3cbce0e995 100644
--- a/osu.Game/Screens/LatencyComparerScreen.cs
+++ b/osu.Game/Screens/LatencyComparerScreen.cs
@@ -116,7 +116,7 @@ namespace osu.Game.Screens
                     RelativeSizeAxes = Axes.X,
                     AutoSizeAxes = Axes.Y,
                     Text = @"Welcome to the latency comparer!
-Use the arrow keys or Z/X to move the square.
+Use the arrow keys, Z/X/J/K to move the square.
 You can click the targets but you don't have to.
 Do whatever you need to try and perceive the difference in latency, then choose your best side.
 ",
@@ -483,10 +483,12 @@ Do whatever you need to try and perceive the difference in latency, then choose
                         {
                             switch (key)
                             {
+                                case Key.K:
                                 case Key.Up:
                                     box.Y = MathHelper.Clamp(box.Y - movementAmount, 0.1f, 0.9f);
                                     break;
 
+                                case Key.J:
                                 case Key.Down:
                                     box.Y = MathHelper.Clamp(box.Y + movementAmount, 0.1f, 0.9f);
                                     break;

From 60d7060baa9737fc05267b7790aec6c7c1f083cb Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 7 Jun 2022 20:28:42 +0900
Subject: [PATCH 5301/5547] Add tab focus support

---
 osu.Game/Screens/LatencyComparerScreen.cs | 68 ++++++++++++++++++-----
 1 file changed, 53 insertions(+), 15 deletions(-)

diff --git a/osu.Game/Screens/LatencyComparerScreen.cs b/osu.Game/Screens/LatencyComparerScreen.cs
index 3cbce0e995..6758908c3e 100644
--- a/osu.Game/Screens/LatencyComparerScreen.cs
+++ b/osu.Game/Screens/LatencyComparerScreen.cs
@@ -5,7 +5,9 @@
 
 using System;
 using System.Diagnostics;
+using System.Linq;
 using osu.Framework.Allocation;
+using osu.Framework.Bindables;
 using osu.Framework.Configuration;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
@@ -44,7 +46,7 @@ namespace osu.Game.Screens
 
         private readonly OsuTextFlowContainer explanatoryText;
 
-        private readonly Container mainArea;
+        private readonly Container<LatencyArea> mainArea;
 
         private readonly Container resultsArea;
 
@@ -85,7 +87,7 @@ namespace osu.Game.Screens
                     Colour = overlayColourProvider.Background6,
                     RelativeSizeAxes = Axes.Both,
                 },
-                mainArea = new Container
+                mainArea = new Container<LatencyArea>
                 {
                     RelativeSizeAxes = Axes.Both,
                 },
@@ -118,6 +120,7 @@ namespace osu.Game.Screens
                     Text = @"Welcome to the latency comparer!
 Use the arrow keys, Z/X/J/K to move the square.
 You can click the targets but you don't have to.
+Use the Tab key to change focus.
 Do whatever you need to try and perceive the difference in latency, then choose your best side.
 ",
                 },
@@ -171,6 +174,20 @@ Do whatever you need to try and perceive the difference in latency, then choose
             loadNextRound();
         }
 
+        protected override bool OnKeyDown(KeyDownEvent e)
+        {
+            switch (e.Key)
+            {
+                case Key.Tab:
+                    var firstArea = mainArea.FirstOrDefault(a => !a.IsActiveArea.Value);
+                    if (firstArea != null)
+                        firstArea.IsActiveArea.Value = true;
+                    return true;
+            }
+
+            return base.OnKeyDown(e);
+        }
+
         private void recordResult(bool correct)
         {
             explanatoryText.FadeOut(500, Easing.OutQuint);
@@ -198,7 +215,8 @@ Do whatever you need to try and perceive the difference in latency, then choose
             mainArea.Add(new LatencyArea(Key.Number1, betterSide == 1 ? mapDifficultyToTargetFrameRate(difficulty) : 0)
             {
                 Width = 0.5f,
-                ReportBetter = () => recordResult(betterSide == 0)
+                ReportBetter = () => recordResult(betterSide == 0),
+                IsActiveArea = { Value = true }
             });
 
             mainArea.Add(new LatencyArea(Key.Number2, betterSide == 0 ? mapDifficultyToTargetFrameRate(difficulty) : 0)
@@ -208,6 +226,15 @@ Do whatever you need to try and perceive the difference in latency, then choose
                 Origin = Anchor.TopRight,
                 ReportBetter = () => recordResult(betterSide == 1)
             });
+
+            foreach (var area in mainArea)
+            {
+                area.IsActiveArea.BindValueChanged(active =>
+                {
+                    if (active.NewValue)
+                        mainArea.Children.First(a => a != area).IsActiveArea.Value = false;
+                });
+            }
         }
 
         private void showResults()
@@ -361,6 +388,8 @@ Do whatever you need to try and perceive the difference in latency, then choose
             private readonly Key key;
             private readonly int targetFrameRate;
 
+            public readonly BindableBool IsActiveArea = new BindableBool();
+
             public LatencyArea(Key key, int targetFrameRate)
             {
                 this.key = key;
@@ -395,31 +424,30 @@ Do whatever you need to try and perceive the difference in latency, then choose
                         RelativeSizeAxes = Axes.Both,
                         Children = new Drawable[]
                         {
-                            new LatencyMovableBox
+                            new LatencyMovableBox(IsActiveArea)
                             {
                                 RelativeSizeAxes = Axes.Both,
                             },
-                            new LatencyCursorContainer
+                            new LatencyCursorContainer(IsActiveArea)
                             {
                                 RelativeSizeAxes = Axes.Both,
                             },
                         }
                     },
                 };
+
+                IsActiveArea.BindValueChanged(active =>
+                {
+                    background.FadeColour(active.NewValue ? overlayColourProvider.Background4 : overlayColourProvider.Background6, 200, Easing.OutQuint);
+                }, true);
             }
 
             protected override bool OnHover(HoverEvent e)
             {
-                background.FadeColour(overlayColourProvider.Background4, 200, Easing.OutQuint);
+                IsActiveArea.Value = true;
                 return base.OnHover(e);
             }
 
-            protected override void OnHoverLost(HoverLostEvent e)
-            {
-                background.FadeColour(overlayColourProvider.Background6, 200, Easing.OutQuint);
-                base.OnHoverLost(e);
-            }
-
             private double lastFrameTime;
 
             public override bool UpdateSubTree()
@@ -438,9 +466,16 @@ Do whatever you need to try and perceive the difference in latency, then choose
                 private Box box = null!;
                 private InputManager inputManager = null!;
 
+                private readonly BindableBool isActive;
+
                 [Resolved]
                 private OverlayColourProvider overlayColourProvider { get; set; } = null!;
 
+                public LatencyMovableBox(BindableBool isActive)
+                {
+                    this.isActive = isActive;
+                }
+
                 protected override void LoadComplete()
                 {
                     base.LoadComplete();
@@ -465,7 +500,7 @@ Do whatever you need to try and perceive the difference in latency, then choose
                 {
                     base.Update();
 
-                    if (!IsHovered)
+                    if (!isActive.Value)
                     {
                         lastFrameTime = null;
                         return;
@@ -515,11 +550,14 @@ Do whatever you need to try and perceive the difference in latency, then choose
                 private Circle cursor = null!;
                 private InputManager inputManager = null!;
 
+                private readonly BindableBool isActive;
+
                 [Resolved]
                 private OverlayColourProvider overlayColourProvider { get; set; } = null!;
 
-                public LatencyCursorContainer()
+                public LatencyCursorContainer(BindableBool isActive)
                 {
+                    this.isActive = isActive;
                     Masking = true;
                 }
 
@@ -543,7 +581,7 @@ Do whatever you need to try and perceive the difference in latency, then choose
                 {
                     cursor.Colour = inputManager.CurrentState.Mouse.IsPressed(MouseButton.Left) ? overlayColourProvider.Content1 : overlayColourProvider.Colour2;
 
-                    if (IsHovered)
+                    if (isActive.Value)
                     {
                         cursor.Position = ToLocalSpace(inputManager.CurrentState.Mouse.Position);
                         cursor.Alpha = 1;

From f2524fc3d7e7ad8515d12cbce8f4a3bf17bbb677 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 7 Jun 2022 20:42:19 +0900
Subject: [PATCH 5302/5547] Increase separator width

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

diff --git a/osu.Game/Screens/LatencyComparerScreen.cs b/osu.Game/Screens/LatencyComparerScreen.cs
index 6758908c3e..75e6643e32 100644
--- a/osu.Game/Screens/LatencyComparerScreen.cs
+++ b/osu.Game/Screens/LatencyComparerScreen.cs
@@ -96,7 +96,7 @@ namespace osu.Game.Screens
                 {
                     Name = "separator",
                     Colour = ColourInfo.GradientHorizontal(overlayColourProvider.Background6, overlayColourProvider.Background6.Opacity(0)),
-                    Width = 50,
+                    Width = 100,
                     RelativeSizeAxes = Axes.Y,
                     Anchor = Anchor.TopCentre,
                     Origin = Anchor.TopLeft,
@@ -105,7 +105,7 @@ namespace osu.Game.Screens
                 {
                     Name = "separator",
                     Colour = ColourInfo.GradientHorizontal(overlayColourProvider.Background6.Opacity(0), overlayColourProvider.Background6),
-                    Width = 50,
+                    Width = 100,
                     RelativeSizeAxes = Axes.Y,
                     Anchor = Anchor.TopCentre,
                     Origin = Anchor.TopRight,

From 0561e9cc751915a5bab9cb6434eff0842e5e7449 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 7 Jun 2022 20:45:37 +0900
Subject: [PATCH 5303/5547] Fix mouse focus not always working

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

diff --git a/osu.Game/Screens/LatencyComparerScreen.cs b/osu.Game/Screens/LatencyComparerScreen.cs
index 75e6643e32..0a966502b5 100644
--- a/osu.Game/Screens/LatencyComparerScreen.cs
+++ b/osu.Game/Screens/LatencyComparerScreen.cs
@@ -442,10 +442,10 @@ Do whatever you need to try and perceive the difference in latency, then choose
                 }, true);
             }
 
-            protected override bool OnHover(HoverEvent e)
+            protected override bool OnMouseMove(MouseMoveEvent e)
             {
                 IsActiveArea.Value = true;
-                return base.OnHover(e);
+                return base.OnMouseMove(e);
             }
 
             private double lastFrameTime;

From c1ef59ab03fa2d4c2e496378dc20a36182e53a46 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 7 Jun 2022 22:52:24 +0900
Subject: [PATCH 5304/5547] Add more comprehensive certification flow (and
 remove "difficulty" terminology)

---
 osu.Game/Screens/LatencyComparerScreen.cs | 122 +++++++++++++++-------
 1 file changed, 87 insertions(+), 35 deletions(-)

diff --git a/osu.Game/Screens/LatencyComparerScreen.cs b/osu.Game/Screens/LatencyComparerScreen.cs
index 0a966502b5..c1e514687a 100644
--- a/osu.Game/Screens/LatencyComparerScreen.cs
+++ b/osu.Game/Screens/LatencyComparerScreen.cs
@@ -13,6 +13,7 @@ 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;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Input;
@@ -24,6 +25,7 @@ using osu.Framework.Screens;
 using osu.Framework.Utils;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
+using osu.Game.Graphics.Sprites;
 using osu.Game.Overlays;
 using osu.Game.Overlays.Settings;
 using osuTK;
@@ -66,11 +68,13 @@ namespace osu.Game.Screens
 
         private const int rounds_to_complete = 5;
 
+        private const int rounds_to_complete_certified = 20;
+
         private int round;
         private int correctCount;
         private int targetRoundCount = rounds_to_complete;
 
-        private int difficulty = 1;
+        private int difficultyLevel = 1;
 
         private double lastPoll;
         private int pollingMax;
@@ -124,6 +128,10 @@ Use the Tab key to change focus.
 Do whatever you need to try and perceive the difference in latency, then choose your best side.
 ",
                 },
+                resultsArea = new Container
+                {
+                    RelativeSizeAxes = Axes.Both,
+                },
                 statusText = new OsuTextFlowContainer(cp => cp.Font = OsuFont.Default.With(size: 40))
                 {
                     Anchor = Anchor.TopCentre,
@@ -133,10 +141,6 @@ Do whatever you need to try and perceive the difference in latency, then choose
                     RelativeSizeAxes = Axes.X,
                     AutoSizeAxes = Axes.Y,
                 },
-                resultsArea = new Container
-                {
-                    RelativeSizeAxes = Axes.Both,
-                },
             };
         }
 
@@ -206,20 +210,20 @@ Do whatever you need to try and perceive the difference in latency, then choose
         private void loadNextRound()
         {
             round++;
-            statusText.Text = $"Difficulty {difficulty}\nRound {round} of {targetRoundCount}";
+            statusText.Text = $"Level {difficultyLevel}\nRound {round} of {targetRoundCount}";
 
             mainArea.Clear();
 
             int betterSide = RNG.Next(0, 2);
 
-            mainArea.Add(new LatencyArea(Key.Number1, betterSide == 1 ? mapDifficultyToTargetFrameRate(difficulty) : 0)
+            mainArea.Add(new LatencyArea(Key.Number1, betterSide == 1 ? mapDifficultyToTargetFrameRate(difficultyLevel) : 0)
             {
                 Width = 0.5f,
                 ReportBetter = () => recordResult(betterSide == 0),
                 IsActiveArea = { Value = true }
             });
 
-            mainArea.Add(new LatencyArea(Key.Number2, betterSide == 0 ? mapDifficultyToTargetFrameRate(difficulty) : 0)
+            mainArea.Add(new LatencyArea(Key.Number2, betterSide == 0 ? mapDifficultyToTargetFrameRate(difficultyLevel) : 0)
             {
                 Width = 0.5f,
                 Anchor = Anchor.TopRight,
@@ -251,10 +255,10 @@ Do whatever you need to try and perceive the difference in latency, then choose
             statusText.Clear();
 
             float successRate = (float)correctCount / targetRoundCount;
-            bool isPass = successRate > 0.8f;
+            bool isPass = successRate == 1;
 
             statusText.AddParagraph($"You scored {correctCount} out of {targetRoundCount} ({successRate:0%})!", cp => cp.Colour = isPass ? colours.Green : colours.Red);
-            statusText.AddParagraph($"Level {difficulty} ({mapDifficultyToTargetFrameRate(difficulty):N0} hz)",
+            statusText.AddParagraph($"Level {difficultyLevel} ({mapDifficultyToTargetFrameRate(difficultyLevel):N0} hz)",
                 cp => cp.Font = OsuFont.Default.With(size: 24));
 
             statusText.AddParagraph(string.Empty);
@@ -262,6 +266,12 @@ Do whatever you need to try and perceive the difference in latency, then choose
             statusText.AddIcon(isPass ? FontAwesome.Regular.CheckCircle : FontAwesome.Regular.TimesCircle, cp => cp.Colour = isPass ? colours.Green : colours.Red);
             statusText.AddParagraph(string.Empty);
 
+            if (!isPass && difficultyLevel > 1)
+            {
+                statusText.AddParagraph("To complete certification, decrease the difficulty level until you can get 20 tests correct in a row!", cp => cp.Font = OsuFont.Default.With(size: 24));
+                statusText.AddParagraph(string.Empty);
+            }
+
             statusText.AddParagraph($"Polling: {pollingMax} hz Monitor: {displayMode.RefreshRate:N0} hz Exclusive: {exclusive}", cp => cp.Font = OsuFont.Default.With(size: 15));
 
             statusText.AddParagraph($"Input: {host.InputThread.Clock.FramesPerSecond} hz "
@@ -269,13 +279,55 @@ Do whatever you need to try and perceive the difference in latency, then choose
                                     + $"Draw: {host.DrawThread.Clock.FramesPerSecond} hz"
                 , cp => cp.Font = OsuFont.Default.With(size: 15));
 
+            int certificationRemaining = !isPass ? rounds_to_complete_certified : rounds_to_complete_certified - correctCount;
+
+            if (isPass && certificationRemaining <= 0)
+            {
+                Drawable background;
+                Drawable certifiedText;
+
+                resultsArea.AddRange(new[]
+                {
+                    background = new Box
+                    {
+                        Colour = overlayColourProvider.Background4,
+                        RelativeSizeAxes = Axes.Both,
+                    },
+                    (certifiedText = new OsuSpriteText
+                    {
+                        Alpha = 0,
+                        Font = OsuFont.TorusAlternate.With(size: 80, weight: FontWeight.Bold),
+                        Text = "Certified!",
+                        Blending = BlendingParameters.Additive,
+                    }).WithEffect(new GlowEffect
+                    {
+                        Colour = overlayColourProvider.Colour1,
+                    }).With(e =>
+                    {
+                        e.Anchor = Anchor.Centre;
+                        e.Origin = Anchor.Centre;
+                    })
+                });
+
+                background.FadeInFromZero(1000, Easing.OutQuint);
+
+                certifiedText.FadeInFromZero(500, Easing.InQuint);
+
+                certifiedText
+                    .ScaleTo(10)
+                    .ScaleTo(1, 600, Easing.InQuad)
+                    .Then()
+                    .ScaleTo(1.05f, 10000, Easing.OutQuint);
+                return;
+            }
+
             string cannotIncreaseReason = string.Empty;
 
             if (!isPass)
-                cannotIncreaseReason = "You didn't score high enough (over 80% required)!";
-            else if (mapDifficultyToTargetFrameRate(difficulty + 1) > target_host_update_frames)
+                cannotIncreaseReason = "You didn't get a perfect score.";
+            else if (mapDifficultyToTargetFrameRate(difficultyLevel + 1) > target_host_update_frames)
                 cannotIncreaseReason = "You've reached the limits of this comparison mode.";
-            else if (mapDifficultyToTargetFrameRate(difficulty + 1) > Clock.FramesPerSecond)
+            else if (mapDifficultyToTargetFrameRate(difficultyLevel + 1) > Clock.FramesPerSecond)
                 cannotIncreaseReason = "Game is not running fast enough to test this level";
 
             resultsArea.Add(new FillFlowContainer
@@ -288,9 +340,27 @@ Do whatever you need to try and perceive the difference in latency, then choose
                 Padding = new MarginPadding(20),
                 Children = new Drawable[]
                 {
+                    new Button(Key.Enter)
+                    {
+                        Text = "Continue to next level",
+                        BackgroundColour = colours.Red2,
+                        Anchor = Anchor.Centre,
+                        Origin = Anchor.Centre,
+                        Action = () => changeDifficulty(difficultyLevel + 1),
+                        Enabled = { Value = string.IsNullOrEmpty(cannotIncreaseReason) },
+                        TooltipText = cannotIncreaseReason
+                    },
+                    new Button(Key.D)
+                    {
+                        Text = difficultyLevel == 1 ? "Retry" : "Return to last level",
+                        BackgroundColour = colours.Green,
+                        Anchor = Anchor.Centre,
+                        Origin = Anchor.Centre,
+                        Action = () => changeDifficulty(Math.Max(difficultyLevel - 1, 1)),
+                    },
                     new Button(Key.R)
                     {
-                        Text = "Increase confidence at current level",
+                        Text = $"Continue towards certification at this level ({certificationRemaining} more)",
                         Anchor = Anchor.Centre,
                         Origin = Anchor.Centre,
                         Action = () =>
@@ -299,27 +369,9 @@ Do whatever you need to try and perceive the difference in latency, then choose
                             targetRoundCount += rounds_to_complete;
                             loadNextRound();
                         },
-                        TooltipText = isPass ? "The longer you chain, the more sure you will be!" : "You've reached your limits",
-                        Enabled = { Value = string.IsNullOrEmpty(cannotIncreaseReason) },
+                        TooltipText = isPass ? $"Chain {rounds_to_complete_certified} to confirm your perception!" : "You've reached your limits. Go to the previous level to complete certification!",
+                        Enabled = { Value = isPass },
                     },
-                    new Button(Key.I)
-                    {
-                        Text = "Increase difficulty",
-                        BackgroundColour = colours.Red2,
-                        Anchor = Anchor.Centre,
-                        Origin = Anchor.Centre,
-                        Action = () => changeDifficulty(difficulty + 1),
-                        Enabled = { Value = string.IsNullOrEmpty(cannotIncreaseReason) },
-                        TooltipText = cannotIncreaseReason
-                    },
-                    new Button(Key.D)
-                    {
-                        Text = difficulty == 1 ? "Restart" : "Decrease difficulty",
-                        BackgroundColour = colours.Green,
-                        Anchor = Anchor.Centre,
-                        Origin = Anchor.Centre,
-                        Action = () => changeDifficulty(Math.Max(difficulty - 1, 1)),
-                    }
                 }
             });
         }
@@ -336,7 +388,7 @@ Do whatever you need to try and perceive the difference in latency, then choose
             lastPoll = 0;
 
             targetRoundCount = rounds_to_complete;
-            difficulty = diff;
+            difficultyLevel = diff;
             loadNextRound();
         }
 

From 058760253a225bcbc90e1248960d0fd3e7696fbc Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 7 Jun 2022 23:02:15 +0900
Subject: [PATCH 5305/5547] Add test coverage of certification flow

---
 .../Settings/TestSceneLatencyComparer.cs      | 44 +++++++++++++++++--
 osu.Game/Screens/LatencyComparerScreen.cs     |  9 ++--
 2 files changed, 46 insertions(+), 7 deletions(-)

diff --git a/osu.Game.Tests/Visual/Settings/TestSceneLatencyComparer.cs b/osu.Game.Tests/Visual/Settings/TestSceneLatencyComparer.cs
index 8a5db7bd95..4706ecb149 100644
--- a/osu.Game.Tests/Visual/Settings/TestSceneLatencyComparer.cs
+++ b/osu.Game.Tests/Visual/Settings/TestSceneLatencyComparer.cs
@@ -3,17 +3,55 @@
 
 #nullable enable
 
+using System.Linq;
 using NUnit.Framework;
+using osu.Framework.Testing;
+using osu.Game.Graphics.UserInterface;
 using osu.Game.Screens;
+using osuTK.Input;
 
 namespace osu.Game.Tests.Visual.Settings
 {
     public class TestSceneLatencyComparer : ScreenTestScene
     {
-        [Test]
-        public void TestBasic()
+        private LatencyComparerScreen latencyComparer = null!;
+
+        public override void SetUpSteps()
         {
-            AddStep("Load screen", () => LoadScreen(new LatencyComparerScreen()));
+            base.SetUpSteps();
+            AddStep("Load screen", () => LoadScreen(latencyComparer = new LatencyComparerScreen()));
+        }
+
+        [Test]
+        public void TestCertification()
+        {
+            for (int i = 0; i < 4; i++)
+            {
+                clickCorrectUntilResults();
+                AddAssert("check at results", () => !latencyComparer.ChildrenOfType<LatencyComparerScreen.LatencyArea>().Any());
+                AddStep("hit c to continue", () => InputManager.Key(Key.C));
+            }
+
+            AddAssert("check at results", () => !latencyComparer.ChildrenOfType<LatencyComparerScreen.LatencyArea>().Any());
+
+            AddAssert("check no buttons", () => !latencyComparer.ChildrenOfType<OsuButton>().Any());
+        }
+
+        private void clickCorrectUntilResults()
+        {
+            AddUntilStep("click correct button until results", () =>
+            {
+                var latencyArea = latencyComparer
+                                  .ChildrenOfType<LatencyComparerScreen.LatencyArea>()
+                                  .SingleOrDefault(a => a.TargetFrameRate == 0);
+
+                // reached results
+                if (latencyArea == null)
+                    return true;
+
+                latencyArea.ChildrenOfType<OsuButton>().Single().TriggerClick();
+                return false;
+            });
         }
     }
 }
diff --git a/osu.Game/Screens/LatencyComparerScreen.cs b/osu.Game/Screens/LatencyComparerScreen.cs
index c1e514687a..45e62646b1 100644
--- a/osu.Game/Screens/LatencyComparerScreen.cs
+++ b/osu.Game/Screens/LatencyComparerScreen.cs
@@ -358,7 +358,7 @@ Do whatever you need to try and perceive the difference in latency, then choose
                         Origin = Anchor.Centre,
                         Action = () => changeDifficulty(Math.Max(difficultyLevel - 1, 1)),
                     },
-                    new Button(Key.R)
+                    new Button(Key.C)
                     {
                         Text = $"Continue towards certification at this level ({certificationRemaining} more)",
                         Anchor = Anchor.Centre,
@@ -438,14 +438,15 @@ Do whatever you need to try and perceive the difference in latency, then choose
             private Drawable? background;
 
             private readonly Key key;
-            private readonly int targetFrameRate;
+
+            public readonly int TargetFrameRate;
 
             public readonly BindableBool IsActiveArea = new BindableBool();
 
             public LatencyArea(Key key, int targetFrameRate)
             {
                 this.key = key;
-                this.targetFrameRate = targetFrameRate;
+                TargetFrameRate = targetFrameRate;
 
                 RelativeSizeAxes = Axes.Both;
                 Masking = true;
@@ -505,7 +506,7 @@ Do whatever you need to try and perceive the difference in latency, then choose
             public override bool UpdateSubTree()
             {
                 double elapsed = Clock.CurrentTime - lastFrameTime;
-                if (targetFrameRate > 0 && elapsed < 1000.0 / targetFrameRate)
+                if (TargetFrameRate > 0 && elapsed < 1000.0 / TargetFrameRate)
                     return false;
 
                 lastFrameTime = Clock.CurrentTime;

From 95dea00725ed8c4c669a54d517a95405449d14f8 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 7 Jun 2022 23:10:08 +0900
Subject: [PATCH 5306/5547] Tidy up code and namespaces

---
 .../Settings/TestSceneLatencyComparer.cs      |   8 +-
 .../Sections/DebugSettings/GeneralSettings.cs |   1 +
 osu.Game/Screens/Utility/ButtonWithKeyBind.cs |  53 +++
 osu.Game/Screens/Utility/LatencyArea.cs       | 239 +++++++++++
 .../{ => Utility}/LatencyComparerScreen.cs    | 379 +++---------------
 5 files changed, 355 insertions(+), 325 deletions(-)
 create mode 100644 osu.Game/Screens/Utility/ButtonWithKeyBind.cs
 create mode 100644 osu.Game/Screens/Utility/LatencyArea.cs
 rename osu.Game/Screens/{ => Utility}/LatencyComparerScreen.cs (59%)

diff --git a/osu.Game.Tests/Visual/Settings/TestSceneLatencyComparer.cs b/osu.Game.Tests/Visual/Settings/TestSceneLatencyComparer.cs
index 4706ecb149..e4b9b21470 100644
--- a/osu.Game.Tests/Visual/Settings/TestSceneLatencyComparer.cs
+++ b/osu.Game.Tests/Visual/Settings/TestSceneLatencyComparer.cs
@@ -7,7 +7,7 @@ using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Testing;
 using osu.Game.Graphics.UserInterface;
-using osu.Game.Screens;
+using osu.Game.Screens.Utility;
 using osuTK.Input;
 
 namespace osu.Game.Tests.Visual.Settings
@@ -28,11 +28,11 @@ namespace osu.Game.Tests.Visual.Settings
             for (int i = 0; i < 4; i++)
             {
                 clickCorrectUntilResults();
-                AddAssert("check at results", () => !latencyComparer.ChildrenOfType<LatencyComparerScreen.LatencyArea>().Any());
+                AddAssert("check at results", () => !latencyComparer.ChildrenOfType<LatencyArea>().Any());
                 AddStep("hit c to continue", () => InputManager.Key(Key.C));
             }
 
-            AddAssert("check at results", () => !latencyComparer.ChildrenOfType<LatencyComparerScreen.LatencyArea>().Any());
+            AddAssert("check at results", () => !latencyComparer.ChildrenOfType<LatencyArea>().Any());
 
             AddAssert("check no buttons", () => !latencyComparer.ChildrenOfType<OsuButton>().Any());
         }
@@ -42,7 +42,7 @@ namespace osu.Game.Tests.Visual.Settings
             AddUntilStep("click correct button until results", () =>
             {
                 var latencyArea = latencyComparer
-                                  .ChildrenOfType<LatencyComparerScreen.LatencyArea>()
+                                  .ChildrenOfType<LatencyArea>()
                                   .SingleOrDefault(a => a.TargetFrameRate == 0);
 
                 // reached results
diff --git a/osu.Game/Overlays/Settings/Sections/DebugSettings/GeneralSettings.cs b/osu.Game/Overlays/Settings/Sections/DebugSettings/GeneralSettings.cs
index 318cdbd6a7..80e5235449 100644
--- a/osu.Game/Overlays/Settings/Sections/DebugSettings/GeneralSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/DebugSettings/GeneralSettings.cs
@@ -9,6 +9,7 @@ using osu.Framework.Screens;
 using osu.Game.Localisation;
 using osu.Game.Screens;
 using osu.Game.Screens.Import;
+using osu.Game.Screens.Utility;
 
 namespace osu.Game.Overlays.Settings.Sections.DebugSettings
 {
diff --git a/osu.Game/Screens/Utility/ButtonWithKeyBind.cs b/osu.Game/Screens/Utility/ButtonWithKeyBind.cs
new file mode 100644
index 0000000000..20e39ffa6a
--- /dev/null
+++ b/osu.Game/Screens/Utility/ButtonWithKeyBind.cs
@@ -0,0 +1,53 @@
+// 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 enable
+using osu.Framework.Allocation;
+using osu.Framework.Input.Events;
+using osu.Framework.Localisation;
+using osu.Game.Graphics;
+using osu.Game.Overlays;
+using osu.Game.Overlays.Settings;
+using osuTK.Input;
+
+namespace osu.Game.Screens.Utility
+{
+    public class ButtonWithKeyBind : SettingsButton
+    {
+        private readonly Key key;
+
+        public ButtonWithKeyBind(Key key)
+        {
+            this.key = key;
+        }
+
+        public override LocalisableString Text
+        {
+            get => base.Text;
+            set => base.Text = $"{value} (Press {key.ToString().Replace("Number", string.Empty)})";
+        }
+
+        protected override bool OnKeyDown(KeyDownEvent e)
+        {
+            if (!e.Repeat && e.Key == key)
+            {
+                TriggerClick();
+                return true;
+            }
+
+            return base.OnKeyDown(e);
+        }
+
+        [Resolved]
+        private OverlayColourProvider overlayColourProvider { get; set; } = null!;
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            Height = 100;
+            SpriteText.Colour = overlayColourProvider.Background6;
+            SpriteText.Font = OsuFont.TorusAlternate.With(size: 34);
+        }
+    }
+}
diff --git a/osu.Game/Screens/Utility/LatencyArea.cs b/osu.Game/Screens/Utility/LatencyArea.cs
new file mode 100644
index 0000000000..a82efa1e26
--- /dev/null
+++ b/osu.Game/Screens/Utility/LatencyArea.cs
@@ -0,0 +1,239 @@
+// 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 enable
+using System;
+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;
+using osu.Framework.Input.Events;
+using osu.Game.Overlays;
+using osuTK;
+using osuTK.Input;
+
+namespace osu.Game.Screens.Utility
+{
+    public class LatencyArea : CompositeDrawable
+    {
+        [Resolved]
+        private OverlayColourProvider overlayColourProvider { get; set; } = null!;
+
+        public Action? ReportUserBest { get; set; }
+
+        private Drawable? background;
+
+        private readonly Key key;
+
+        public readonly int TargetFrameRate;
+
+        public readonly BindableBool IsActiveArea = new BindableBool();
+
+        public LatencyArea(Key key, int targetFrameRate)
+        {
+            this.key = key;
+            TargetFrameRate = targetFrameRate;
+
+            RelativeSizeAxes = Axes.Both;
+            Masking = true;
+        }
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            InternalChildren = new[]
+            {
+                background = new Box
+                {
+                    Colour = overlayColourProvider.Background6,
+                    RelativeSizeAxes = Axes.Both,
+                },
+                new ButtonWithKeyBind(key)
+                {
+                    Text = "Feels better",
+                    Y = 20,
+                    Width = 0.8f,
+                    Anchor = Anchor.TopCentre,
+                    Origin = Anchor.TopCentre,
+                    Action = () => ReportUserBest?.Invoke(),
+                },
+                new Container
+                {
+                    RelativeSizeAxes = Axes.Both,
+                    Children = new Drawable[]
+                    {
+                        new LatencyMovableBox(IsActiveArea)
+                        {
+                            RelativeSizeAxes = Axes.Both,
+                        },
+                        new LatencyCursorContainer(IsActiveArea)
+                        {
+                            RelativeSizeAxes = Axes.Both,
+                        },
+                    }
+                },
+            };
+
+            IsActiveArea.BindValueChanged(active =>
+            {
+                background.FadeColour(active.NewValue ? overlayColourProvider.Background4 : overlayColourProvider.Background6, 200, Easing.OutQuint);
+            }, true);
+        }
+
+        protected override bool OnMouseMove(MouseMoveEvent e)
+        {
+            IsActiveArea.Value = true;
+            return base.OnMouseMove(e);
+        }
+
+        private double lastFrameTime;
+
+        public override bool UpdateSubTree()
+        {
+            double elapsed = Clock.CurrentTime - lastFrameTime;
+            if (TargetFrameRate > 0 && elapsed < 1000.0 / TargetFrameRate)
+                return false;
+
+            lastFrameTime = Clock.CurrentTime;
+
+            return base.UpdateSubTree();
+        }
+
+        public class LatencyMovableBox : CompositeDrawable
+        {
+            private Box box = null!;
+            private InputManager inputManager = null!;
+
+            private readonly BindableBool isActive;
+
+            [Resolved]
+            private OverlayColourProvider overlayColourProvider { get; set; } = null!;
+
+            public LatencyMovableBox(BindableBool isActive)
+            {
+                this.isActive = isActive;
+            }
+
+            protected override void LoadComplete()
+            {
+                base.LoadComplete();
+
+                inputManager = GetContainingInputManager();
+
+                InternalChild = box = new Box
+                {
+                    Size = new Vector2(40),
+                    RelativePositionAxes = Axes.Both,
+                    Position = new Vector2(0.5f),
+                    Origin = Anchor.Centre,
+                    Colour = overlayColourProvider.Colour1,
+                };
+            }
+
+            protected override bool OnHover(HoverEvent e) => false;
+
+            private double? lastFrameTime;
+
+            protected override void Update()
+            {
+                base.Update();
+
+                if (!isActive.Value)
+                {
+                    lastFrameTime = null;
+                    return;
+                }
+
+                if (lastFrameTime != null)
+                {
+                    float movementAmount = (float)(Clock.CurrentTime - lastFrameTime) / 400;
+
+                    var buttons = inputManager.CurrentState.Keyboard.Keys;
+
+                    box.Colour = buttons.HasAnyButtonPressed ? overlayColourProvider.Content1 : overlayColourProvider.Colour1;
+
+                    foreach (var key in buttons)
+                    {
+                        switch (key)
+                        {
+                            case Key.K:
+                            case Key.Up:
+                                box.Y = MathHelper.Clamp(box.Y - movementAmount, 0.1f, 0.9f);
+                                break;
+
+                            case Key.J:
+                            case Key.Down:
+                                box.Y = MathHelper.Clamp(box.Y + movementAmount, 0.1f, 0.9f);
+                                break;
+
+                            case Key.Z:
+                            case Key.Left:
+                                box.X = MathHelper.Clamp(box.X - movementAmount, 0.1f, 0.9f);
+                                break;
+
+                            case Key.X:
+                            case Key.Right:
+                                box.X = MathHelper.Clamp(box.X + movementAmount, 0.1f, 0.9f);
+                                break;
+                        }
+                    }
+                }
+
+                lastFrameTime = Clock.CurrentTime;
+            }
+        }
+
+        public class LatencyCursorContainer : CompositeDrawable
+        {
+            private Circle cursor = null!;
+            private InputManager inputManager = null!;
+
+            private readonly BindableBool isActive;
+
+            [Resolved]
+            private OverlayColourProvider overlayColourProvider { get; set; } = null!;
+
+            public LatencyCursorContainer(BindableBool isActive)
+            {
+                this.isActive = isActive;
+                Masking = true;
+            }
+
+            protected override void LoadComplete()
+            {
+                base.LoadComplete();
+
+                InternalChild = cursor = new Circle
+                {
+                    Size = new Vector2(40),
+                    Origin = Anchor.Centre,
+                    Colour = overlayColourProvider.Colour2,
+                };
+
+                inputManager = GetContainingInputManager();
+            }
+
+            protected override bool OnHover(HoverEvent e) => false;
+
+            protected override void Update()
+            {
+                cursor.Colour = inputManager.CurrentState.Mouse.IsPressed(MouseButton.Left) ? overlayColourProvider.Content1 : overlayColourProvider.Colour2;
+
+                if (isActive.Value)
+                {
+                    cursor.Position = ToLocalSpace(inputManager.CurrentState.Mouse.Position);
+                    cursor.Alpha = 1;
+                }
+                else
+                {
+                    cursor.Alpha = 0;
+                }
+
+                base.Update();
+            }
+        }
+    }
+}
diff --git a/osu.Game/Screens/LatencyComparerScreen.cs b/osu.Game/Screens/Utility/LatencyComparerScreen.cs
similarity index 59%
rename from osu.Game/Screens/LatencyComparerScreen.cs
rename to osu.Game/Screens/Utility/LatencyComparerScreen.cs
index 45e62646b1..1e859a2956 100644
--- a/osu.Game/Screens/LatencyComparerScreen.cs
+++ b/osu.Game/Screens/Utility/LatencyComparerScreen.cs
@@ -7,7 +7,6 @@ using System;
 using System.Diagnostics;
 using System.Linq;
 using osu.Framework.Allocation;
-using osu.Framework.Bindables;
 using osu.Framework.Configuration;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
@@ -16,9 +15,7 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Effects;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Graphics.Sprites;
-using osu.Framework.Input;
 using osu.Framework.Input.Events;
-using osu.Framework.Localisation;
 using osu.Framework.Platform;
 using osu.Framework.Platform.Windows;
 using osu.Framework.Screens;
@@ -27,11 +24,10 @@ using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Overlays;
-using osu.Game.Overlays.Settings;
 using osuTK;
 using osuTK.Input;
 
-namespace osu.Game.Screens
+namespace osu.Game.Screens.Utility
 {
     public class LatencyComparerScreen : OsuScreen
     {
@@ -174,7 +170,6 @@ Do whatever you need to try and perceive the difference in latency, then choose
         protected override void LoadComplete()
         {
             base.LoadComplete();
-
             loadNextRound();
         }
 
@@ -192,55 +187,6 @@ Do whatever you need to try and perceive the difference in latency, then choose
             return base.OnKeyDown(e);
         }
 
-        private void recordResult(bool correct)
-        {
-            explanatoryText.FadeOut(500, Easing.OutQuint);
-
-            if (correct)
-                correctCount++;
-
-            if (round < targetRoundCount)
-                loadNextRound();
-            else
-            {
-                showResults();
-            }
-        }
-
-        private void loadNextRound()
-        {
-            round++;
-            statusText.Text = $"Level {difficultyLevel}\nRound {round} of {targetRoundCount}";
-
-            mainArea.Clear();
-
-            int betterSide = RNG.Next(0, 2);
-
-            mainArea.Add(new LatencyArea(Key.Number1, betterSide == 1 ? mapDifficultyToTargetFrameRate(difficultyLevel) : 0)
-            {
-                Width = 0.5f,
-                ReportBetter = () => recordResult(betterSide == 0),
-                IsActiveArea = { Value = true }
-            });
-
-            mainArea.Add(new LatencyArea(Key.Number2, betterSide == 0 ? mapDifficultyToTargetFrameRate(difficultyLevel) : 0)
-            {
-                Width = 0.5f,
-                Anchor = Anchor.TopRight,
-                Origin = Anchor.TopRight,
-                ReportBetter = () => recordResult(betterSide == 1)
-            });
-
-            foreach (var area in mainArea)
-            {
-                area.IsActiveArea.BindValueChanged(active =>
-                {
-                    if (active.NewValue)
-                        mainArea.Children.First(a => a != area).IsActiveArea.Value = false;
-                });
-            }
-        }
-
         private void showResults()
         {
             mainArea.Clear();
@@ -340,7 +286,7 @@ Do whatever you need to try and perceive the difference in latency, then choose
                 Padding = new MarginPadding(20),
                 Children = new Drawable[]
                 {
-                    new Button(Key.Enter)
+                    new ButtonWithKeyBind(Key.Enter)
                     {
                         Text = "Continue to next level",
                         BackgroundColour = colours.Red2,
@@ -350,7 +296,7 @@ Do whatever you need to try and perceive the difference in latency, then choose
                         Enabled = { Value = string.IsNullOrEmpty(cannotIncreaseReason) },
                         TooltipText = cannotIncreaseReason
                     },
-                    new Button(Key.D)
+                    new ButtonWithKeyBind(Key.D)
                     {
                         Text = difficultyLevel == 1 ? "Retry" : "Return to last level",
                         BackgroundColour = colours.Green,
@@ -358,7 +304,7 @@ Do whatever you need to try and perceive the difference in latency, then choose
                         Origin = Anchor.Centre,
                         Action = () => changeDifficulty(Math.Max(difficultyLevel - 1, 1)),
                     },
-                    new Button(Key.C)
+                    new ButtonWithKeyBind(Key.C)
                     {
                         Text = $"Continue towards certification at this level ({certificationRemaining} more)",
                         Anchor = Anchor.Centre,
@@ -376,9 +322,9 @@ Do whatever you need to try and perceive the difference in latency, then choose
             });
         }
 
-        private void changeDifficulty(int diff)
+        private void changeDifficulty(int difficulty)
         {
-            Debug.Assert(diff > 0);
+            Debug.Assert(difficulty > 0);
 
             resultsArea.Clear();
 
@@ -388,10 +334,61 @@ Do whatever you need to try and perceive the difference in latency, then choose
             lastPoll = 0;
 
             targetRoundCount = rounds_to_complete;
-            difficultyLevel = diff;
+            difficultyLevel = difficulty;
+
             loadNextRound();
         }
 
+        private void loadNextRound()
+        {
+            round++;
+            statusText.Text = $"Level {difficultyLevel}\nRound {round} of {targetRoundCount}";
+
+            mainArea.Clear();
+
+            int betterSide = RNG.Next(0, 2);
+
+            mainArea.AddRange(new[]
+            {
+                new LatencyArea(Key.Number1, betterSide == 1 ? mapDifficultyToTargetFrameRate(difficultyLevel) : 0)
+                {
+                    Width = 0.5f,
+                    IsActiveArea = { Value = true },
+                    ReportUserBest = () => recordResult(betterSide == 0),
+                },
+                new LatencyArea(Key.Number2, betterSide == 0 ? mapDifficultyToTargetFrameRate(difficultyLevel) : 0)
+                {
+                    Width = 0.5f,
+                    Anchor = Anchor.TopRight,
+                    Origin = Anchor.TopRight,
+                    ReportUserBest = () => recordResult(betterSide == 1)
+                }
+            });
+
+            foreach (var area in mainArea)
+            {
+                area.IsActiveArea.BindValueChanged(active =>
+                {
+                    if (active.NewValue)
+                        mainArea.Children.First(a => a != area).IsActiveArea.Value = false;
+                });
+            }
+        }
+
+        private void recordResult(bool correct)
+        {
+            // Fading this out will improve the frame rate after the first round due to less text on screen.
+            explanatoryText.FadeOut(500, Easing.OutQuint);
+
+            if (correct)
+                correctCount++;
+
+            if (round < targetRoundCount)
+                loadNextRound();
+            else
+                showResults();
+        }
+
         private static int mapDifficultyToTargetFrameRate(int difficulty)
         {
             switch (difficulty)
@@ -427,265 +424,5 @@ Do whatever you need to try and perceive the difference in latency, then choose
                     return 1000 + ((difficulty - 10) * 500);
             }
         }
-
-        public class LatencyArea : CompositeDrawable
-        {
-            [Resolved]
-            private OverlayColourProvider overlayColourProvider { get; set; } = null!;
-
-            public Action? ReportBetter { get; set; }
-
-            private Drawable? background;
-
-            private readonly Key key;
-
-            public readonly int TargetFrameRate;
-
-            public readonly BindableBool IsActiveArea = new BindableBool();
-
-            public LatencyArea(Key key, int targetFrameRate)
-            {
-                this.key = key;
-                TargetFrameRate = targetFrameRate;
-
-                RelativeSizeAxes = Axes.Both;
-                Masking = true;
-            }
-
-            protected override void LoadComplete()
-            {
-                base.LoadComplete();
-
-                InternalChildren = new[]
-                {
-                    background = new Box
-                    {
-                        Colour = overlayColourProvider.Background6,
-                        RelativeSizeAxes = Axes.Both,
-                    },
-                    new Button(key)
-                    {
-                        Text = "Feels better",
-                        Y = 20,
-                        Width = 0.8f,
-                        Anchor = Anchor.TopCentre,
-                        Origin = Anchor.TopCentre,
-                        Action = () => ReportBetter?.Invoke(),
-                    },
-                    new Container
-                    {
-                        RelativeSizeAxes = Axes.Both,
-                        Children = new Drawable[]
-                        {
-                            new LatencyMovableBox(IsActiveArea)
-                            {
-                                RelativeSizeAxes = Axes.Both,
-                            },
-                            new LatencyCursorContainer(IsActiveArea)
-                            {
-                                RelativeSizeAxes = Axes.Both,
-                            },
-                        }
-                    },
-                };
-
-                IsActiveArea.BindValueChanged(active =>
-                {
-                    background.FadeColour(active.NewValue ? overlayColourProvider.Background4 : overlayColourProvider.Background6, 200, Easing.OutQuint);
-                }, true);
-            }
-
-            protected override bool OnMouseMove(MouseMoveEvent e)
-            {
-                IsActiveArea.Value = true;
-                return base.OnMouseMove(e);
-            }
-
-            private double lastFrameTime;
-
-            public override bool UpdateSubTree()
-            {
-                double elapsed = Clock.CurrentTime - lastFrameTime;
-                if (TargetFrameRate > 0 && elapsed < 1000.0 / TargetFrameRate)
-                    return false;
-
-                lastFrameTime = Clock.CurrentTime;
-
-                return base.UpdateSubTree();
-            }
-
-            public class LatencyMovableBox : CompositeDrawable
-            {
-                private Box box = null!;
-                private InputManager inputManager = null!;
-
-                private readonly BindableBool isActive;
-
-                [Resolved]
-                private OverlayColourProvider overlayColourProvider { get; set; } = null!;
-
-                public LatencyMovableBox(BindableBool isActive)
-                {
-                    this.isActive = isActive;
-                }
-
-                protected override void LoadComplete()
-                {
-                    base.LoadComplete();
-
-                    inputManager = GetContainingInputManager();
-
-                    InternalChild = box = new Box
-                    {
-                        Size = new Vector2(40),
-                        RelativePositionAxes = Axes.Both,
-                        Position = new Vector2(0.5f),
-                        Origin = Anchor.Centre,
-                        Colour = overlayColourProvider.Colour1,
-                    };
-                }
-
-                protected override bool OnHover(HoverEvent e) => false;
-
-                private double? lastFrameTime;
-
-                protected override void Update()
-                {
-                    base.Update();
-
-                    if (!isActive.Value)
-                    {
-                        lastFrameTime = null;
-                        return;
-                    }
-
-                    if (lastFrameTime != null)
-                    {
-                        float movementAmount = (float)(Clock.CurrentTime - lastFrameTime) / 400;
-
-                        var buttons = inputManager.CurrentState.Keyboard.Keys;
-
-                        box.Colour = buttons.HasAnyButtonPressed ? overlayColourProvider.Content1 : overlayColourProvider.Colour1;
-
-                        foreach (var key in buttons)
-                        {
-                            switch (key)
-                            {
-                                case Key.K:
-                                case Key.Up:
-                                    box.Y = MathHelper.Clamp(box.Y - movementAmount, 0.1f, 0.9f);
-                                    break;
-
-                                case Key.J:
-                                case Key.Down:
-                                    box.Y = MathHelper.Clamp(box.Y + movementAmount, 0.1f, 0.9f);
-                                    break;
-
-                                case Key.Z:
-                                case Key.Left:
-                                    box.X = MathHelper.Clamp(box.X - movementAmount, 0.1f, 0.9f);
-                                    break;
-
-                                case Key.X:
-                                case Key.Right:
-                                    box.X = MathHelper.Clamp(box.X + movementAmount, 0.1f, 0.9f);
-                                    break;
-                            }
-                        }
-                    }
-
-                    lastFrameTime = Clock.CurrentTime;
-                }
-            }
-
-            public class LatencyCursorContainer : CompositeDrawable
-            {
-                private Circle cursor = null!;
-                private InputManager inputManager = null!;
-
-                private readonly BindableBool isActive;
-
-                [Resolved]
-                private OverlayColourProvider overlayColourProvider { get; set; } = null!;
-
-                public LatencyCursorContainer(BindableBool isActive)
-                {
-                    this.isActive = isActive;
-                    Masking = true;
-                }
-
-                protected override void LoadComplete()
-                {
-                    base.LoadComplete();
-
-                    InternalChild = cursor = new Circle
-                    {
-                        Size = new Vector2(40),
-                        Origin = Anchor.Centre,
-                        Colour = overlayColourProvider.Colour2,
-                    };
-
-                    inputManager = GetContainingInputManager();
-                }
-
-                protected override bool OnHover(HoverEvent e) => false;
-
-                protected override void Update()
-                {
-                    cursor.Colour = inputManager.CurrentState.Mouse.IsPressed(MouseButton.Left) ? overlayColourProvider.Content1 : overlayColourProvider.Colour2;
-
-                    if (isActive.Value)
-                    {
-                        cursor.Position = ToLocalSpace(inputManager.CurrentState.Mouse.Position);
-                        cursor.Alpha = 1;
-                    }
-                    else
-                    {
-                        cursor.Alpha = 0;
-                    }
-
-                    base.Update();
-                }
-            }
-        }
-
-        public class Button : SettingsButton
-        {
-            private readonly Key key;
-
-            public Button(Key key)
-            {
-                this.key = key;
-            }
-
-            public override LocalisableString Text
-            {
-                get => base.Text;
-                set => base.Text = $"{value} (Press {key.ToString().Replace("Number", string.Empty)})";
-            }
-
-            protected override bool OnKeyDown(KeyDownEvent e)
-            {
-                if (!e.Repeat && e.Key == key)
-                {
-                    TriggerClick();
-                    return true;
-                }
-
-                return base.OnKeyDown(e);
-            }
-
-            [Resolved]
-            private OverlayColourProvider overlayColourProvider { get; set; } = null!;
-
-            protected override void LoadComplete()
-            {
-                base.LoadComplete();
-
-                Height = 100;
-                SpriteText.Colour = overlayColourProvider.Background6;
-                SpriteText.Font = OsuFont.TorusAlternate.With(size: 34);
-            }
-        }
     }
 }

From 1a1dfaeae66628ff4b8a8cab18b6477cade2c0c4 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 7 Jun 2022 23:25:45 +0900
Subject: [PATCH 5307/5547] Update framework

---
 osu.Android.props                                 | 2 +-
 osu.Game/Screens/Utility/LatencyComparerScreen.cs | 4 ++--
 osu.Game/osu.Game.csproj                          | 2 +-
 osu.iOS.props                                     | 4 ++--
 4 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/osu.Android.props b/osu.Android.props
index aad8cf10d0..155a21bacb 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -52,7 +52,7 @@
   </ItemGroup>
   <ItemGroup>
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.527.0" />
-    <PackageReference Include="ppy.osu.Framework.Android" Version="2022.605.0" />
+    <PackageReference Include="ppy.osu.Framework.Android" Version="2022.607.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
     <!-- Realm needs to be directly referenced in all Xamarin projects, as it will not pull in its transitive dependencies otherwise. -->
diff --git a/osu.Game/Screens/Utility/LatencyComparerScreen.cs b/osu.Game/Screens/Utility/LatencyComparerScreen.cs
index 1e859a2956..b25e6ee901 100644
--- a/osu.Game/Screens/Utility/LatencyComparerScreen.cs
+++ b/osu.Game/Screens/Utility/LatencyComparerScreen.cs
@@ -156,12 +156,12 @@ Do whatever you need to try and perceive the difference in latency, then choose
             previousActiveHz = host.UpdateThread.ActiveHz;
             config.SetValue(FrameworkSetting.FrameSync, FrameSync.Unlimited);
             host.UpdateThread.ActiveHz = target_host_update_frames;
-            // host.AllowBenchmarkUnlimitedFrames = true;
+            host.AllowBenchmarkUnlimitedFrames = true;
         }
 
         public override bool OnExiting(ScreenExitEvent e)
         {
-            // host.AllowBenchmarkUnlimitedFrames = false;
+            host.AllowBenchmarkUnlimitedFrames = false;
             config.SetValue(FrameworkSetting.FrameSync, previousFrameSyncMode);
             host.UpdateThread.ActiveHz = previousActiveHz;
             return base.OnExiting(e);
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 63b8cf4cb5..b6218c5950 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="10.14.0" />
-    <PackageReference Include="ppy.osu.Framework" Version="2022.605.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2022.607.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.527.0" />
     <PackageReference Include="Sentry" Version="3.17.1" />
     <PackageReference Include="SharpCompress" Version="0.31.0" />
diff --git a/osu.iOS.props b/osu.iOS.props
index a0fafa635b..ba57aba01b 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -61,7 +61,7 @@
     <Reference Include="System.Net.Http" />
   </ItemGroup>
   <ItemGroup Label="Package References">
-    <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.605.0" />
+    <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.607.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.527.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net6.0) -->
@@ -84,7 +84,7 @@
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="5.0.14" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.Core" Version="5.0.14" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
-    <PackageReference Include="ppy.osu.Framework" Version="2022.605.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2022.607.0" />
     <PackageReference Include="SharpCompress" Version="0.31.0" />
     <PackageReference Include="NUnit" Version="3.13.3" />
     <PackageReference Include="System.ComponentModel.Annotations" Version="5.0.0" />

From 9da99a0ddfe730b96db3375636b903217cfe0e01 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 7 Jun 2022 23:34:19 +0900
Subject: [PATCH 5308/5547] Rename to latency certifier

---
 ...parer.cs => TestSceneLatencyCertifierScreen.cs} | 14 +++++++-------
 .../Sections/DebugSettings/GeneralSettings.cs      |  2 +-
 ...ComparerScreen.cs => LatencyCertifierScreen.cs} |  7 +++----
 3 files changed, 11 insertions(+), 12 deletions(-)
 rename osu.Game.Tests/Visual/Settings/{TestSceneLatencyComparer.cs => TestSceneLatencyCertifierScreen.cs} (68%)
 rename osu.Game/Screens/Utility/{LatencyComparerScreen.cs => LatencyCertifierScreen.cs} (98%)

diff --git a/osu.Game.Tests/Visual/Settings/TestSceneLatencyComparer.cs b/osu.Game.Tests/Visual/Settings/TestSceneLatencyCertifierScreen.cs
similarity index 68%
rename from osu.Game.Tests/Visual/Settings/TestSceneLatencyComparer.cs
rename to osu.Game.Tests/Visual/Settings/TestSceneLatencyCertifierScreen.cs
index e4b9b21470..687d7c490c 100644
--- a/osu.Game.Tests/Visual/Settings/TestSceneLatencyComparer.cs
+++ b/osu.Game.Tests/Visual/Settings/TestSceneLatencyCertifierScreen.cs
@@ -12,14 +12,14 @@ using osuTK.Input;
 
 namespace osu.Game.Tests.Visual.Settings
 {
-    public class TestSceneLatencyComparer : ScreenTestScene
+    public class TestSceneLatencyCertifierScreen : ScreenTestScene
     {
-        private LatencyComparerScreen latencyComparer = null!;
+        private LatencyCertifierScreen latencyCertifier = null!;
 
         public override void SetUpSteps()
         {
             base.SetUpSteps();
-            AddStep("Load screen", () => LoadScreen(latencyComparer = new LatencyComparerScreen()));
+            AddStep("Load screen", () => LoadScreen(latencyCertifier = new LatencyCertifierScreen()));
         }
 
         [Test]
@@ -28,20 +28,20 @@ namespace osu.Game.Tests.Visual.Settings
             for (int i = 0; i < 4; i++)
             {
                 clickCorrectUntilResults();
-                AddAssert("check at results", () => !latencyComparer.ChildrenOfType<LatencyArea>().Any());
+                AddAssert("check at results", () => !latencyCertifier.ChildrenOfType<LatencyArea>().Any());
                 AddStep("hit c to continue", () => InputManager.Key(Key.C));
             }
 
-            AddAssert("check at results", () => !latencyComparer.ChildrenOfType<LatencyArea>().Any());
+            AddAssert("check at results", () => !latencyCertifier.ChildrenOfType<LatencyArea>().Any());
 
-            AddAssert("check no buttons", () => !latencyComparer.ChildrenOfType<OsuButton>().Any());
+            AddAssert("check no buttons", () => !latencyCertifier.ChildrenOfType<OsuButton>().Any());
         }
 
         private void clickCorrectUntilResults()
         {
             AddUntilStep("click correct button until results", () =>
             {
-                var latencyArea = latencyComparer
+                var latencyArea = latencyCertifier
                                   .ChildrenOfType<LatencyArea>()
                                   .SingleOrDefault(a => a.TargetFrameRate == 0);
 
diff --git a/osu.Game/Overlays/Settings/Sections/DebugSettings/GeneralSettings.cs b/osu.Game/Overlays/Settings/Sections/DebugSettings/GeneralSettings.cs
index 80e5235449..cd8cf8f64f 100644
--- a/osu.Game/Overlays/Settings/Sections/DebugSettings/GeneralSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/DebugSettings/GeneralSettings.cs
@@ -40,7 +40,7 @@ namespace osu.Game.Overlays.Settings.Sections.DebugSettings
                 new SettingsButton
                 {
                     Text = @"Run latency comparer",
-                    Action = () => performer?.PerformFromScreen(menu => menu.Push(new LatencyComparerScreen()))
+                    Action = () => performer?.PerformFromScreen(menu => menu.Push(new LatencyCertifierScreen()))
                 }
             };
         }
diff --git a/osu.Game/Screens/Utility/LatencyComparerScreen.cs b/osu.Game/Screens/Utility/LatencyCertifierScreen.cs
similarity index 98%
rename from osu.Game/Screens/Utility/LatencyComparerScreen.cs
rename to osu.Game/Screens/Utility/LatencyCertifierScreen.cs
index b25e6ee901..157998184c 100644
--- a/osu.Game/Screens/Utility/LatencyComparerScreen.cs
+++ b/osu.Game/Screens/Utility/LatencyCertifierScreen.cs
@@ -29,7 +29,7 @@ using osuTK.Input;
 
 namespace osu.Game.Screens.Utility
 {
-    public class LatencyComparerScreen : OsuScreen
+    public class LatencyCertifierScreen : OsuScreen
     {
         private FrameSync previousFrameSyncMode;
         private double previousActiveHz;
@@ -78,7 +78,7 @@ namespace osu.Game.Screens.Utility
         [Resolved]
         private GameHost host { get; set; } = null!;
 
-        public LatencyComparerScreen()
+        public LatencyCertifierScreen()
         {
             InternalChildren = new Drawable[]
             {
@@ -117,9 +117,8 @@ namespace osu.Game.Screens.Utility
                     TextAnchor = Anchor.TopCentre,
                     RelativeSizeAxes = Axes.X,
                     AutoSizeAxes = Axes.Y,
-                    Text = @"Welcome to the latency comparer!
+                    Text = @"Welcome to the latency certifier!
 Use the arrow keys, Z/X/J/K to move the square.
-You can click the targets but you don't have to.
 Use the Tab key to change focus.
 Do whatever you need to try and perceive the difference in latency, then choose your best side.
 ",

From 2e0b8884105f977ed6cfc2d582a7aca1796bf004 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 7 Jun 2022 16:31:58 +0900
Subject: [PATCH 5309/5547] Fix song select carousel invalidating every frame
 during global overlay dimming

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

diff --git a/osu.Game/Screens/Select/BeatmapCarousel.cs b/osu.Game/Screens/Select/BeatmapCarousel.cs
index a59f14647d..8a588c519b 100644
--- a/osu.Game/Screens/Select/BeatmapCarousel.cs
+++ b/osu.Game/Screens/Select/BeatmapCarousel.cs
@@ -10,6 +10,7 @@ using osu.Framework.Audio;
 using osu.Framework.Audio.Sample;
 using osu.Framework.Bindables;
 using osu.Framework.Caching;
+using osu.Framework.Extensions.EnumExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Pooling;
@@ -633,7 +634,7 @@ namespace osu.Game.Screens.Select
         protected override bool OnInvalidate(Invalidation invalidation, InvalidationSource source)
         {
             // handles the vertical size of the carousel changing (ie. on window resize when aspect ratio has changed).
-            if ((invalidation & Invalidation.Layout) > 0)
+            if (invalidation.HasFlagFast(Invalidation.DrawSize))
                 itemsCache.Invalidate();
 
             return base.OnInvalidate(invalidation, source);

From 228683e956217baaa211117af3d256fca8190303 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 7 Jun 2022 23:48:34 +0900
Subject: [PATCH 5310/5547] Fix nullability of `dialogOverlay` dependency

---
 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 242e741475..3bfdc845ab 100644
--- a/osu.Game/Screens/Select/SongSelect.cs
+++ b/osu.Game/Screens/Select/SongSelect.cs
@@ -91,7 +91,7 @@ namespace osu.Game.Screens.Select
 
         private BeatmapInfoWedge beatmapInfoWedge;
 
-        [Resolved]
+        [Resolved(canBeNull: true)]
         private IDialogOverlay dialogOverlay { get; set; }
 
         [Resolved]

From b924aa3296bbc6ccb9c6cf0f1f4140580ffc833b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 8 Jun 2022 00:36:19 +0900
Subject: [PATCH 5311/5547] Fix tests failing when run headless

---
 .../Visual/Settings/TestSceneLatencyCertifierScreen.cs        | 3 ++-
 osu.Game/Screens/Utility/LatencyCertifierScreen.cs            | 4 ++--
 2 files changed, 4 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Tests/Visual/Settings/TestSceneLatencyCertifierScreen.cs b/osu.Game.Tests/Visual/Settings/TestSceneLatencyCertifierScreen.cs
index 687d7c490c..6d8c6d3c54 100644
--- a/osu.Game.Tests/Visual/Settings/TestSceneLatencyCertifierScreen.cs
+++ b/osu.Game.Tests/Visual/Settings/TestSceneLatencyCertifierScreen.cs
@@ -19,7 +19,9 @@ namespace osu.Game.Tests.Visual.Settings
         public override void SetUpSteps()
         {
             base.SetUpSteps();
+
             AddStep("Load screen", () => LoadScreen(latencyCertifier = new LatencyCertifierScreen()));
+            AddUntilStep("wait for load", () => latencyCertifier.IsLoaded);
         }
 
         [Test]
@@ -33,7 +35,6 @@ namespace osu.Game.Tests.Visual.Settings
             }
 
             AddAssert("check at results", () => !latencyCertifier.ChildrenOfType<LatencyArea>().Any());
-
             AddAssert("check no buttons", () => !latencyCertifier.ChildrenOfType<OsuButton>().Any());
         }
 
diff --git a/osu.Game/Screens/Utility/LatencyCertifierScreen.cs b/osu.Game/Screens/Utility/LatencyCertifierScreen.cs
index 157998184c..568e477d8f 100644
--- a/osu.Game/Screens/Utility/LatencyCertifierScreen.cs
+++ b/osu.Game/Screens/Utility/LatencyCertifierScreen.cs
@@ -190,7 +190,7 @@ Do whatever you need to try and perceive the difference in latency, then choose
         {
             mainArea.Clear();
 
-            var displayMode = host.Window.CurrentDisplayMode.Value;
+            var displayMode = host.Window?.CurrentDisplayMode.Value;
 
             string exclusive = "unknown";
 
@@ -217,7 +217,7 @@ Do whatever you need to try and perceive the difference in latency, then choose
                 statusText.AddParagraph(string.Empty);
             }
 
-            statusText.AddParagraph($"Polling: {pollingMax} hz Monitor: {displayMode.RefreshRate:N0} hz Exclusive: {exclusive}", cp => cp.Font = OsuFont.Default.With(size: 15));
+            statusText.AddParagraph($"Polling: {pollingMax} hz Monitor: {displayMode?.RefreshRate ?? 0:N0} hz Exclusive: {exclusive}", cp => cp.Font = OsuFont.Default.With(size: 15));
 
             statusText.AddParagraph($"Input: {host.InputThread.Clock.FramesPerSecond} hz "
                                     + $"Update: {host.UpdateThread.Clock.FramesPerSecond} hz "

From 2f635fa8546bbd5efabb6ecb60b0c32792c32703 Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Tue, 7 Jun 2022 01:37:46 +0100
Subject: [PATCH 5312/5547] Refactor `ChatLine` and fix `DrawableChannel` flow
 padding

Refactors `ChatLine` component to use more sensible override properties
and layout using grid container. Moves creation of username component
into its own method to simplify BDL.

Updates padding of base `DrawableChannel` flow padding.

Removes usage of `ChatOverlayDrawableChannel` since it's overrides are
no longer needed.

Updates usage of `StandAloneChatDisplay` to use new override properties
of `DrawableChannel`.
---
 .../Visual/Online/TestSceneChatOverlay.cs     |   6 +-
 osu.Game/Online/Chat/StandAloneChatDisplay.cs |  19 +-
 osu.Game/Overlays/Chat/ChatLine.cs            | 192 +++++++++---------
 .../Chat/ChatOverlayDrawableChannel.cs        |  39 ----
 osu.Game/Overlays/Chat/DaySeparator.cs        |   2 +-
 osu.Game/Overlays/Chat/DrawableChannel.cs     |   2 +-
 osu.Game/Overlays/ChatOverlay.cs              |  12 +-
 7 files changed, 114 insertions(+), 158 deletions(-)
 delete mode 100644 osu.Game/Overlays/Chat/ChatOverlayDrawableChannel.cs

diff --git a/osu.Game.Tests/Visual/Online/TestSceneChatOverlay.cs b/osu.Game.Tests/Visual/Online/TestSceneChatOverlay.cs
index 2cf1114f30..97221329f5 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneChatOverlay.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneChatOverlay.cs
@@ -572,15 +572,15 @@ namespace osu.Game.Tests.Visual.Online
 
             public SlowLoadingDrawableChannel GetSlowLoadingChannel(Channel channel) => DrawableChannels.OfType<SlowLoadingDrawableChannel>().Single(c => c.Channel == channel);
 
-            protected override ChatOverlayDrawableChannel CreateDrawableChannel(Channel newChannel)
+            protected override DrawableChannel CreateDrawableChannel(Channel newChannel)
             {
                 return SlowLoading
                     ? new SlowLoadingDrawableChannel(newChannel)
-                    : new ChatOverlayDrawableChannel(newChannel);
+                    : new DrawableChannel(newChannel);
             }
         }
 
-        private class SlowLoadingDrawableChannel : ChatOverlayDrawableChannel
+        private class SlowLoadingDrawableChannel : DrawableChannel
         {
             public readonly ManualResetEventSlim LoadEvent = new ManualResetEventSlim();
 
diff --git a/osu.Game/Online/Chat/StandAloneChatDisplay.cs b/osu.Game/Online/Chat/StandAloneChatDisplay.cs
index f57ffcfe25..bbfffea6fd 100644
--- a/osu.Game/Online/Chat/StandAloneChatDisplay.cs
+++ b/osu.Game/Online/Chat/StandAloneChatDisplay.cs
@@ -160,13 +160,6 @@ namespace osu.Game.Online.Chat
             {
             }
 
-            [BackgroundDependencyLoader]
-            private void load()
-            {
-                // TODO: Remove once DrawableChannel & ChatLine padding is fixed
-                ChatLineFlow.Padding = new MarginPadding { Horizontal = 0 };
-            }
-
             protected override ChatLine CreateChatLine(Message m) => CreateChatLineAction(m);
 
             protected override DaySeparator CreateDaySeparator(DateTimeOffset time) => new StandAloneDaySeparator(time);
@@ -176,8 +169,8 @@ namespace osu.Game.Online.Chat
         {
             protected override float TextSize => 14;
             protected override float LineHeight => 1;
-            protected override float Spacing => 10;
-            protected override float DateAlign => 120;
+            protected override float Spacing => 5;
+            protected override float DateAlign => 125;
 
             public StandAloneDaySeparator(DateTimeOffset time)
                 : base(time)
@@ -189,17 +182,15 @@ namespace osu.Game.Online.Chat
             {
                 Height = 25;
                 Colour = colours.Yellow;
-                // TODO: Remove once DrawableChannel & ChatLine padding is fixed
-                Padding = new MarginPadding { Horizontal = 10 };
             }
         }
 
         protected class StandAloneMessage : ChatLine
         {
             protected override float TextSize => 15;
-            protected override float HorizontalPadding => 10;
-            protected override float MessagePadding => 120;
-            protected override float TimestampPadding => 50;
+            protected override float Spacing => 5;
+            protected override float TimestampWidth => 45;
+            protected override float UsernameWidth => 75;
 
             public StandAloneMessage(Message message)
                 : base(message)
diff --git a/osu.Game/Overlays/Chat/ChatLine.cs b/osu.Game/Overlays/Chat/ChatLine.cs
index a1d8cd5d38..13f66089d9 100644
--- a/osu.Game/Overlays/Chat/ChatLine.cs
+++ b/osu.Game/Overlays/Chat/ChatLine.cs
@@ -26,22 +26,14 @@ namespace osu.Game.Overlays.Chat
 {
     public class ChatLine : CompositeDrawable
     {
-        public const float LEFT_PADDING = default_message_padding + default_horizontal_padding * 2;
-
-        private const float default_message_padding = 200;
-
-        protected virtual float MessagePadding => default_message_padding;
-
-        private const float default_timestamp_padding = 65;
-
-        protected virtual float TimestampPadding => default_timestamp_padding;
-
-        private const float default_horizontal_padding = 15;
-
-        protected virtual float HorizontalPadding => default_horizontal_padding;
-
         protected virtual float TextSize => 20;
 
+        protected virtual float Spacing => 15;
+
+        protected virtual float TimestampWidth => 60;
+
+        protected virtual float UsernameWidth => 130;
+
         private Color4 usernameColour;
 
         private OsuSpriteText timestamp;
@@ -49,7 +41,6 @@ namespace osu.Game.Overlays.Chat
         public ChatLine(Message message)
         {
             Message = message;
-            Padding = new MarginPadding { Left = HorizontalPadding, Right = HorizontalPadding };
             RelativeSizeAxes = Axes.X;
             AutoSizeAxes = Axes.Y;
         }
@@ -90,88 +81,45 @@ namespace osu.Game.Overlays.Chat
                 ? Color4Extensions.FromHex(message.Sender.Colour)
                 : username_colours[message.Sender.Id % username_colours.Length];
 
-            Drawable effectedUsername = username = new OsuSpriteText
+            InternalChild = new GridContainer
             {
-                Shadow = false,
-                Colour = senderHasColour ? colours.ChatBlue : usernameColour,
-                Truncate = true,
-                EllipsisString = "… :",
-                Font = OsuFont.GetFont(size: TextSize, weight: FontWeight.Bold, italics: true),
-                Anchor = Anchor.TopRight,
-                Origin = Anchor.TopRight,
-                MaxWidth = MessagePadding - TimestampPadding
-            };
-
-            if (senderHasColour)
-            {
-                // Background effect
-                effectedUsername = new Container
+                RelativeSizeAxes = Axes.X,
+                AutoSizeAxes = Axes.Y,
+                RowDimensions = new[] { new Dimension(GridSizeMode.AutoSize) },
+                ColumnDimensions = new[]
                 {
-                    AutoSizeAxes = Axes.Both,
-                    Masking = true,
-                    CornerRadius = 4,
-                    EdgeEffect = new EdgeEffectParameters
-                    {
-                        Roundness = 1,
-                        Radius = 1,
-                        Colour = Color4.Black.Opacity(0.3f),
-                        Offset = new Vector2(0, 1),
-                        Type = EdgeEffectType.Shadow,
-                    },
-                    Child = new Container
-                    {
-                        AutoSizeAxes = Axes.Both,
-                        Y = 0,
-                        Masking = true,
-                        CornerRadius = 4,
-                        Children = new Drawable[]
-                        {
-                            new Box
-                            {
-                                RelativeSizeAxes = Axes.Both,
-                                Colour = usernameColour,
-                            },
-                            new Container
-                            {
-                                AutoSizeAxes = Axes.Both,
-                                Padding = new MarginPadding { Left = 4, Right = 4, Bottom = 1, Top = -2 },
-                                Child = username
-                            }
-                        }
-                    }
-                };
-            }
-
-            InternalChildren = new Drawable[]
-            {
-                new Container
-                {
-                    Size = new Vector2(MessagePadding, TextSize),
-                    Children = new Drawable[]
-                    {
-                        timestamp = new OsuSpriteText
-                        {
-                            Shadow = false,
-                            Anchor = Anchor.CentreLeft,
-                            Origin = Anchor.CentreLeft,
-                            Font = OsuFont.GetFont(size: TextSize * 0.75f, weight: FontWeight.SemiBold, fixedWidth: true)
-                        },
-                        new MessageSender(message.Sender)
-                        {
-                            AutoSizeAxes = Axes.Both,
-                            Origin = Anchor.TopRight,
-                            Anchor = Anchor.TopRight,
-                            Child = effectedUsername,
-                        },
-                    }
+                    new Dimension(GridSizeMode.Absolute, TimestampWidth + Spacing + UsernameWidth + Spacing),
+                    new Dimension(),
                 },
-                new Container
+                Content = new[]
                 {
-                    RelativeSizeAxes = Axes.X,
-                    AutoSizeAxes = Axes.Y,
-                    Padding = new MarginPadding { Left = MessagePadding + HorizontalPadding },
-                    Children = new Drawable[]
+                    new Drawable[]
                     {
+                        new Container
+                        {
+                            RelativeSizeAxes = Axes.X,
+                            AutoSizeAxes = Axes.Y,
+                            Children = new Drawable[]
+                            {
+                                timestamp = new OsuSpriteText
+                                {
+                                    Shadow = false,
+                                    Anchor = Anchor.CentreLeft,
+                                    Origin = Anchor.CentreLeft,
+                                    Font = OsuFont.GetFont(size: TextSize * 0.75f, weight: FontWeight.SemiBold, fixedWidth: true),
+                                    MaxWidth = TimestampWidth,
+                                },
+                                new MessageSender(message.Sender)
+                                {
+                                    Width = UsernameWidth,
+                                    AutoSizeAxes = Axes.Y,
+                                    Origin = Anchor.TopRight,
+                                    Anchor = Anchor.TopRight,
+                                    Child = createUsername(),
+                                    Margin = new MarginPadding { Horizontal = Spacing },
+                                },
+                            },
+                        },
                         ContentFlow = new LinkFlowContainer(t =>
                         {
                             t.Shadow = false;
@@ -190,7 +138,7 @@ namespace osu.Game.Overlays.Chat
                             AutoSizeAxes = Axes.Y,
                             RelativeSizeAxes = Axes.X,
                         }
-                    }
+                    },
                 }
             };
         }
@@ -233,7 +181,7 @@ namespace osu.Game.Overlays.Chat
             timestamp.FadeTo(message is LocalEchoMessage ? 0 : 1, 500, Easing.OutQuint);
 
             timestamp.Text = $@"{message.Timestamp.LocalDateTime:HH:mm:ss}";
-            username.Text = $@"{message.Sender.Username}" + (senderHasColour || message.IsAction ? "" : ":");
+            username.Text = $@"{message.Sender.Username}";
 
             // remove non-existent channels from the link list
             message.Links.RemoveAll(link => link.Action == LinkAction.OpenChannel && chatManager?.AvailableChannels.Any(c => c.Name == link.Argument.ToString()) != true);
@@ -242,6 +190,62 @@ namespace osu.Game.Overlays.Chat
             ContentFlow.AddLinks(message.DisplayContent, message.Links);
         }
 
+        private Drawable createUsername()
+        {
+            username = new OsuSpriteText
+            {
+                Shadow = false,
+                Colour = senderHasColour ? colours.ChatBlue : usernameColour,
+                Truncate = true,
+                EllipsisString = "…",
+                Font = OsuFont.GetFont(size: TextSize, weight: FontWeight.Bold, italics: true),
+                Anchor = Anchor.TopRight,
+                Origin = Anchor.TopRight,
+                MaxWidth = UsernameWidth,
+            };
+
+            if (!senderHasColour)
+                return username;
+
+            // Background effect
+            return new Container
+            {
+                Anchor = Anchor.TopRight,
+                Origin = Anchor.TopRight,
+                AutoSizeAxes = Axes.Both,
+                Masking = true,
+                CornerRadius = 4,
+                EdgeEffect = new EdgeEffectParameters
+                {
+                    Roundness = 1,
+                    Radius = 1,
+                    Colour = Color4.Black.Opacity(0.3f),
+                    Offset = new Vector2(0, 1),
+                    Type = EdgeEffectType.Shadow,
+                },
+                Child = new Container
+                {
+                    AutoSizeAxes = Axes.Both,
+                    Masking = true,
+                    CornerRadius = 4,
+                    Children = new Drawable[]
+                    {
+                        new Box
+                        {
+                            RelativeSizeAxes = Axes.Both,
+                            Colour = usernameColour,
+                        },
+                        new Container
+                        {
+                            AutoSizeAxes = Axes.Both,
+                            Padding = new MarginPadding { Left = 4, Right = 4, Bottom = 1, Top = -2 },
+                            Child = username
+                        }
+                    }
+                }
+            };
+        }
+
         private class MessageSender : OsuClickableContainer, IHasContextMenu
         {
             private readonly APIUser sender;
diff --git a/osu.Game/Overlays/Chat/ChatOverlayDrawableChannel.cs b/osu.Game/Overlays/Chat/ChatOverlayDrawableChannel.cs
deleted file mode 100644
index a5d22f678e..0000000000
--- a/osu.Game/Overlays/Chat/ChatOverlayDrawableChannel.cs
+++ /dev/null
@@ -1,39 +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 enable
-
-using System;
-using osu.Framework.Allocation;
-using osu.Framework.Graphics;
-using osu.Game.Online.Chat;
-
-namespace osu.Game.Overlays.Chat
-{
-    public class ChatOverlayDrawableChannel : DrawableChannel
-    {
-        public ChatOverlayDrawableChannel(Channel channel)
-            : base(channel)
-        {
-        }
-
-        [BackgroundDependencyLoader]
-        private void load()
-        {
-            // TODO: Remove once DrawableChannel & ChatLine padding is fixed
-            ChatLineFlow.Padding = new MarginPadding(0);
-        }
-
-        protected override DaySeparator CreateDaySeparator(DateTimeOffset time) => new ChatOverlayDaySeparator(time);
-
-        private class ChatOverlayDaySeparator : DaySeparator
-        {
-            public ChatOverlayDaySeparator(DateTimeOffset time)
-                : base(time)
-            {
-                // TODO: Remove once DrawableChannel & ChatLine padding is fixed
-                Padding = new MarginPadding { Horizontal = 15 };
-            }
-        }
-    }
-}
diff --git a/osu.Game/Overlays/Chat/DaySeparator.cs b/osu.Game/Overlays/Chat/DaySeparator.cs
index 2e3796151c..9ae35b0c38 100644
--- a/osu.Game/Overlays/Chat/DaySeparator.cs
+++ b/osu.Game/Overlays/Chat/DaySeparator.cs
@@ -19,7 +19,7 @@ namespace osu.Game.Overlays.Chat
 
         protected virtual float LineHeight => 2;
 
-        protected virtual float DateAlign => 200;
+        protected virtual float DateAlign => 205;
 
         protected virtual float Spacing => 15;
 
diff --git a/osu.Game/Overlays/Chat/DrawableChannel.cs b/osu.Game/Overlays/Chat/DrawableChannel.cs
index f0d4d12f4f..c3a341bca4 100644
--- a/osu.Game/Overlays/Chat/DrawableChannel.cs
+++ b/osu.Game/Overlays/Chat/DrawableChannel.cs
@@ -59,7 +59,7 @@ namespace osu.Game.Overlays.Chat
                     Padding = new MarginPadding { Bottom = 5 },
                     Child = ChatLineFlow = new FillFlowContainer
                     {
-                        Padding = new MarginPadding { Horizontal = 15 },
+                        Padding = new MarginPadding { Horizontal = 10 },
                         RelativeSizeAxes = Axes.X,
                         AutoSizeAxes = Axes.Y,
                         Direction = FillDirection.Vertical,
diff --git a/osu.Game/Overlays/ChatOverlay.cs b/osu.Game/Overlays/ChatOverlay.cs
index 02769b5d68..f04bf76c18 100644
--- a/osu.Game/Overlays/ChatOverlay.cs
+++ b/osu.Game/Overlays/ChatOverlay.cs
@@ -38,9 +38,9 @@ namespace osu.Game.Overlays
         private LoadingLayer loading = null!;
         private ChannelListing channelListing = null!;
         private ChatTextBar textBar = null!;
-        private Container<ChatOverlayDrawableChannel> currentChannelContainer = null!;
+        private Container<DrawableChannel> currentChannelContainer = null!;
 
-        private readonly Dictionary<Channel, ChatOverlayDrawableChannel> loadedChannels = new Dictionary<Channel, ChatOverlayDrawableChannel>();
+        private readonly Dictionary<Channel, DrawableChannel> loadedChannels = new Dictionary<Channel, DrawableChannel>();
 
         protected IEnumerable<DrawableChannel> DrawableChannels => loadedChannels.Values;
 
@@ -126,7 +126,7 @@ namespace osu.Game.Overlays
                             RelativeSizeAxes = Axes.Both,
                             Colour = colourProvider.Background4,
                         },
-                        currentChannelContainer = new Container<ChatOverlayDrawableChannel>
+                        currentChannelContainer = new Container<DrawableChannel>
                         {
                             RelativeSizeAxes = Axes.Both,
                         },
@@ -313,7 +313,7 @@ namespace osu.Game.Overlays
                     loading.Show();
 
                     // Ensure the drawable channel is stored before async load to prevent double loading
-                    ChatOverlayDrawableChannel drawableChannel = CreateDrawableChannel(newChannel);
+                    DrawableChannel drawableChannel = CreateDrawableChannel(newChannel);
                     loadedChannels.Add(newChannel, drawableChannel);
 
                     LoadComponentAsync(drawableChannel, loadedDrawable =>
@@ -338,7 +338,7 @@ namespace osu.Game.Overlays
                 channelManager.MarkChannelAsRead(newChannel);
         }
 
-        protected virtual ChatOverlayDrawableChannel CreateDrawableChannel(Channel newChannel) => new ChatOverlayDrawableChannel(newChannel);
+        protected virtual DrawableChannel CreateDrawableChannel(Channel newChannel) => new DrawableChannel(newChannel);
 
         private void joinedChannelsChanged(object sender, NotifyCollectionChangedEventArgs args)
         {
@@ -361,7 +361,7 @@ namespace osu.Game.Overlays
 
                         if (loadedChannels.ContainsKey(channel))
                         {
-                            ChatOverlayDrawableChannel loaded = loadedChannels[channel];
+                            DrawableChannel loaded = loadedChannels[channel];
                             loadedChannels.Remove(channel);
                             // DrawableChannel removed from cache must be manually disposed
                             loaded.Dispose();

From 6c053291443ead7a3f9f0afe18085fe8c915d77f Mon Sep 17 00:00:00 2001
From: theangryepicbanana <alan.invents@gmail.com>
Date: Tue, 7 Jun 2022 18:01:40 -0400
Subject: [PATCH 5313/5547] Close #5820 (Ability to delete a single skin)

---
 osu.Game/Localisation/SkinSettingsStrings.cs  |  5 ++
 .../Overlays/Settings/Sections/SkinSection.cs | 34 +++++++++++++
 osu.Game/Screens/Select/SkinDeleteDialog.cs   | 48 +++++++++++++++++++
 3 files changed, 87 insertions(+)
 create mode 100644 osu.Game/Screens/Select/SkinDeleteDialog.cs

diff --git a/osu.Game/Localisation/SkinSettingsStrings.cs b/osu.Game/Localisation/SkinSettingsStrings.cs
index 8b74b94d59..81035c5a5e 100644
--- a/osu.Game/Localisation/SkinSettingsStrings.cs
+++ b/osu.Game/Localisation/SkinSettingsStrings.cs
@@ -54,6 +54,11 @@ namespace osu.Game.Localisation
         /// </summary>
         public static LocalisableString ExportSkinButton => new TranslatableString(getKey(@"export_skin_button"), @"Export selected skin");
 
+        /// <summary>
+        /// "Delete selected skin"
+        /// </summary>
+        public static LocalisableString DeleteSkinButton => new TranslatableString(getKey(@"delete_skin_button"), @"Delete selected skin");
+
         private static string getKey(string key) => $"{prefix}:{key}";
     }
 }
diff --git a/osu.Game/Overlays/Settings/Sections/SkinSection.cs b/osu.Game/Overlays/Settings/Sections/SkinSection.cs
index a87e65b735..e9713ad507 100644
--- a/osu.Game/Overlays/Settings/Sections/SkinSection.cs
+++ b/osu.Game/Overlays/Settings/Sections/SkinSection.cs
@@ -16,6 +16,7 @@ using osu.Game.Configuration;
 using osu.Game.Database;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Localisation;
+using osu.Game.Screens.Select;
 using osu.Game.Skinning;
 using osu.Game.Skinning.Editor;
 using Realms;
@@ -67,6 +68,7 @@ namespace osu.Game.Overlays.Settings.Sections
                     Action = () => skinEditor?.ToggleVisibility(),
                 },
                 new ExportSkinButton(),
+                new DeleteSkinButton(),
             };
 
             config.BindWith(OsuSetting.Skin, configBindable);
@@ -202,5 +204,37 @@ namespace osu.Game.Overlays.Settings.Sections
                 }
             }
         }
+
+        public class DeleteSkinButton : DangerousSettingsButton
+        {
+            [Resolved]
+            private SkinManager skins { get; set; }
+
+            [Resolved(CanBeNull = true)]
+            private IDialogOverlay dialogOverlay { get; set; }
+
+            private Bindable<Skin> currentSkin;
+
+            [BackgroundDependencyLoader]
+            private void load()
+            {
+                Text = SkinSettingsStrings.DeleteSkinButton;
+                Action = delete;
+            }
+
+            protected override void LoadComplete()
+            {
+                base.LoadComplete();
+
+                currentSkin = skins.CurrentSkin.GetBoundCopy();
+                currentSkin.BindValueChanged(skin => Enabled.Value = skin.NewValue.SkinInfo.PerformRead(s => !s.Protected), true);
+            }
+
+            private void delete()
+            {
+                if (dialogOverlay != null)
+                    dialogOverlay.Push(new SkinDeleteDialog(currentSkin.Value));
+            }
+        }
     }
 }
diff --git a/osu.Game/Screens/Select/SkinDeleteDialog.cs b/osu.Game/Screens/Select/SkinDeleteDialog.cs
new file mode 100644
index 0000000000..a971cca401
--- /dev/null
+++ b/osu.Game/Screens/Select/SkinDeleteDialog.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.Allocation;
+using osu.Framework.Graphics.Sprites;
+using osu.Game.Skinning;
+using osu.Game.Overlays.Dialog;
+using osu.Game.Database;
+
+namespace osu.Game.Screens.Select
+{
+    public class SkinDeleteDialog : PopupDialog
+    {
+        private SkinManager manager;
+
+        [BackgroundDependencyLoader]
+        private void load(SkinManager skinManager)
+        {
+            manager = skinManager;
+        }
+
+        public SkinDeleteDialog(Skin skin)
+        {
+            skin.SkinInfo.PerformRead(s =>
+            {
+                BodyText = s.Name;
+
+                Icon = FontAwesome.Regular.TrashAlt;
+                HeaderText = @"Confirm deletion of";
+                Buttons = new PopupDialogButton[]
+                {
+                    new PopupDialogDangerousButton
+                    {
+                        Text = @"Yes. Totally. Delete it.",
+                        Action = () => {
+                            manager.Delete(s);
+                            manager.CurrentSkinInfo.Value = DefaultSkin.CreateInfo().ToLiveUnmanaged();
+                        },
+                    },
+                    new PopupDialogCancelButton
+                    {
+                        Text = @"Firetruck, I didn't mean to!",
+                    },
+                };
+            });
+        }
+    }
+}

From c69d53df0035ed1a469233cbbcd145ca706979ad Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 8 Jun 2022 04:29:48 +0300
Subject: [PATCH 5314/5547] Add failing test case

---
 .../Visual/Online/TestSceneMessageNotifier.cs | 31 +++++++++++++++++++
 1 file changed, 31 insertions(+)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneMessageNotifier.cs b/osu.Game.Tests/Visual/Online/TestSceneMessageNotifier.cs
index 79f62a16e3..5f7c8b3c51 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneMessageNotifier.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneMessageNotifier.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 NUnit.Framework;
 using osu.Framework.Allocation;
@@ -178,6 +179,36 @@ namespace osu.Game.Tests.Visual.Online
             AddAssert("1 notification fired", () => testContainer.NotificationOverlay.UnreadCount.Value == 1);
         }
 
+        /// <summary>
+        /// Ensures that <see cref="MessageNotifier"/> handles channels which have not been or could not be resolved (i.e. <see cref="Channel.Id"/> = 0).
+        /// </summary>
+        [Test]
+        public void TestSendInUnresolvedChannel()
+        {
+            int i = 1;
+            Channel unresolved = null;
+
+            AddRepeatStep("join unresolved channels", () => testContainer.ChannelManager.JoinChannel(unresolved = new Channel(new APIUser
+            {
+                Id = 100 + i,
+                Username = $"Foreign #{i++}",
+            })), 5);
+
+            AddStep("send message in unresolved channel", () =>
+            {
+                Debug.Assert(unresolved.Id == 0);
+
+                unresolved.AddLocalEcho(new LocalEchoMessage
+                {
+                    Sender = API.LocalUser.Value,
+                    ChannelId = unresolved.Id,
+                    Content = "Some message",
+                });
+            });
+
+            AddAssert("no notifications fired", () => testContainer.NotificationOverlay.UnreadCount.Value == 0);
+        }
+
         private void receiveMessage(APIUser sender, Channel channel, string content) => channel.AddNewMessages(createMessage(sender, channel, content));
 
         private Message createMessage(APIUser sender, Channel channel, string content) => new Message(messageIdCounter++)

From 830ff666888e2d82303c38e6284553e1c169c698 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 8 Jun 2022 04:31:31 +0300
Subject: [PATCH 5315/5547] Fix message notifier not handling unresolved PM
 channels

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

diff --git a/osu.Game/Online/Chat/MessageNotifier.cs b/osu.Game/Online/Chat/MessageNotifier.cs
index ca6082e19b..fbc5ef79ef 100644
--- a/osu.Game/Online/Chat/MessageNotifier.cs
+++ b/osu.Game/Online/Chat/MessageNotifier.cs
@@ -77,7 +77,7 @@ namespace osu.Game.Online.Chat
             if (!messages.Any())
                 return;
 
-            var channel = channelManager.JoinedChannels.SingleOrDefault(c => c.Id == messages.First().ChannelId);
+            var channel = channelManager.JoinedChannels.SingleOrDefault(c => c.Id > 0 && c.Id == messages.First().ChannelId);
 
             if (channel == null)
                 return;

From 5157a78ae6f7fbb2c94482aeae8ac0b0e556bd2a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 8 Jun 2022 16:53:06 +0900
Subject: [PATCH 5316/5547] Isolate nested sample screens from main game to
 avoid toolbar interactions

---
 .../Overlays/FirstRunSetup/ScreenUIScale.cs   | 40 +++++++++++++++++++
 1 file changed, 40 insertions(+)

diff --git a/osu.Game/Overlays/FirstRunSetup/ScreenUIScale.cs b/osu.Game/Overlays/FirstRunSetup/ScreenUIScale.cs
index 8452691bb5..f09a26a527 100644
--- a/osu.Game/Overlays/FirstRunSetup/ScreenUIScale.cs
+++ b/osu.Game/Overlays/FirstRunSetup/ScreenUIScale.cs
@@ -126,6 +126,7 @@ namespace osu.Game.Overlays.FirstRunSetup
         private class SampleScreenContainer : CompositeDrawable
         {
             private readonly OsuScreen screen;
+
             // Minimal isolation from main game.
 
             [Cached]
@@ -151,6 +152,9 @@ namespace osu.Game.Overlays.FirstRunSetup
                 RelativeSizeAxes = Axes.Both;
             }
 
+            protected override IReadOnlyDependencyContainer CreateChildDependencies(IReadOnlyDependencyContainer parent) =>
+                new DependencyContainer(new DependencyIsolationContainer(base.CreateChildDependencies(parent)));
+
             [BackgroundDependencyLoader]
             private void load(AudioManager audio, TextureStore textures, RulesetStore rulesets)
             {
@@ -197,5 +201,41 @@ namespace osu.Game.Overlays.FirstRunSetup
                 stack.PushSynchronously(screen);
             }
         }
+
+        private class DependencyIsolationContainer : IReadOnlyDependencyContainer
+        {
+            private readonly IReadOnlyDependencyContainer parentDependencies;
+
+            private readonly Type[] isolatedTypes =
+            {
+                typeof(OsuGame)
+            };
+
+            public DependencyIsolationContainer(IReadOnlyDependencyContainer parentDependencies)
+            {
+                this.parentDependencies = parentDependencies;
+            }
+
+            public object Get(Type type)
+            {
+                if (isolatedTypes.Contains(type))
+                    return null;
+
+                return parentDependencies.Get(type);
+            }
+
+            public object Get(Type type, CacheInfo info)
+            {
+                if (isolatedTypes.Contains(type))
+                    return null;
+
+                return parentDependencies.Get(type, info);
+            }
+
+            public void Inject<T>(T instance) where T : class
+            {
+                parentDependencies.Inject(instance);
+            }
+        }
     }
 }

From 3a90aa0b9b9ccb909616a9c828c9c0fdaeb845a3 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 8 Jun 2022 17:57:59 +0900
Subject: [PATCH 5317/5547] Fix code styling

---
 osu.Game/Overlays/Settings/Sections/SkinSection.cs | 3 +--
 osu.Game/Screens/Select/SkinDeleteDialog.cs        | 6 +++++-
 2 files changed, 6 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Overlays/Settings/Sections/SkinSection.cs b/osu.Game/Overlays/Settings/Sections/SkinSection.cs
index e9713ad507..b83600a16d 100644
--- a/osu.Game/Overlays/Settings/Sections/SkinSection.cs
+++ b/osu.Game/Overlays/Settings/Sections/SkinSection.cs
@@ -232,8 +232,7 @@ namespace osu.Game.Overlays.Settings.Sections
 
             private void delete()
             {
-                if (dialogOverlay != null)
-                    dialogOverlay.Push(new SkinDeleteDialog(currentSkin.Value));
+                dialogOverlay?.Push(new SkinDeleteDialog(currentSkin.Value));
             }
         }
     }
diff --git a/osu.Game/Screens/Select/SkinDeleteDialog.cs b/osu.Game/Screens/Select/SkinDeleteDialog.cs
index a971cca401..c7c36fb92c 100644
--- a/osu.Game/Screens/Select/SkinDeleteDialog.cs
+++ b/osu.Game/Screens/Select/SkinDeleteDialog.cs
@@ -32,7 +32,11 @@ namespace osu.Game.Screens.Select
                     new PopupDialogDangerousButton
                     {
                         Text = @"Yes. Totally. Delete it.",
-                        Action = () => {
+                        Action = () =>
+                        {
+                            if (manager == null)
+                                return;
+
                             manager.Delete(s);
                             manager.CurrentSkinInfo.Value = DefaultSkin.CreateInfo().ToLiveUnmanaged();
                         },

From cf438b1a44781bfc0bee8597f8945eddec5a2036 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 8 Jun 2022 18:01:54 +0900
Subject: [PATCH 5318/5547] Add index on `MD5Hash` property

Reduces actual query overhead significantly
---
 osu.Game/Beatmaps/BeatmapInfo.cs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Game/Beatmaps/BeatmapInfo.cs b/osu.Game/Beatmaps/BeatmapInfo.cs
index abc9020dc6..5925dd7064 100644
--- a/osu.Game/Beatmaps/BeatmapInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapInfo.cs
@@ -90,6 +90,7 @@ namespace osu.Game.Beatmaps
 
         public double StarRating { get; set; }
 
+        [Indexed]
         public string MD5Hash { get; set; } = string.Empty;
 
         [JsonIgnore]

From f8594acb1d4018feb2e12af710f103be72580f15 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 8 Jun 2022 18:10:41 +0900
Subject: [PATCH 5319/5547] Cleanup dialog implementation

---
 osu.Game/Screens/Select/SkinDeleteDialog.cs | 48 ++++++++-------------
 1 file changed, 19 insertions(+), 29 deletions(-)

diff --git a/osu.Game/Screens/Select/SkinDeleteDialog.cs b/osu.Game/Screens/Select/SkinDeleteDialog.cs
index c7c36fb92c..4262118658 100644
--- a/osu.Game/Screens/Select/SkinDeleteDialog.cs
+++ b/osu.Game/Screens/Select/SkinDeleteDialog.cs
@@ -5,48 +5,38 @@ using osu.Framework.Allocation;
 using osu.Framework.Graphics.Sprites;
 using osu.Game.Skinning;
 using osu.Game.Overlays.Dialog;
-using osu.Game.Database;
 
 namespace osu.Game.Screens.Select
 {
     public class SkinDeleteDialog : PopupDialog
     {
-        private SkinManager manager;
-
-        [BackgroundDependencyLoader]
-        private void load(SkinManager skinManager)
-        {
-            manager = skinManager;
-        }
+        [Resolved]
+        private SkinManager manager { get; set; }
 
         public SkinDeleteDialog(Skin skin)
         {
-            skin.SkinInfo.PerformRead(s =>
+            BodyText = skin.SkinInfo.Value.Name;
+            Icon = FontAwesome.Regular.TrashAlt;
+            HeaderText = @"Confirm deletion of";
+            Buttons = new PopupDialogButton[]
             {
-                BodyText = s.Name;
-
-                Icon = FontAwesome.Regular.TrashAlt;
-                HeaderText = @"Confirm deletion of";
-                Buttons = new PopupDialogButton[]
+                new PopupDialogDangerousButton
                 {
-                    new PopupDialogDangerousButton
+                    Text = @"Yes. Totally. Delete it.",
+                    Action = () =>
                     {
-                        Text = @"Yes. Totally. Delete it.",
-                        Action = () =>
-                        {
-                            if (manager == null)
-                                return;
+                        if (manager == null)
+                            return;
 
-                            manager.Delete(s);
-                            manager.CurrentSkinInfo.Value = DefaultSkin.CreateInfo().ToLiveUnmanaged();
-                        },
+                        manager.Delete(skin.SkinInfo.Value);
+                        manager.CurrentSkinInfo.SetDefault();
                     },
-                    new PopupDialogCancelButton
-                    {
-                        Text = @"Firetruck, I didn't mean to!",
-                    },
-                };
-            });
+                },
+                new PopupDialogCancelButton
+                {
+                    Text = @"Firetruck, I didn't mean to!",
+                },
+            };
         }
     }
 }

From 42cd7d9e6ea9942edad6e2751c008d1281718aec Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 8 Jun 2022 18:23:09 +0900
Subject: [PATCH 5320/5547] Change `CollectionManager` to only store MD5 hashes
 instead of full `BeatmapInfo`

---
 .../TestSceneManageCollectionsDialog.cs         |  6 +++---
 .../Visual/SongSelect/TestSceneFilterControl.cs |  6 +++---
 osu.Game/Collections/BeatmapCollection.cs       |  4 ++--
 .../Collections/CollectionFilterDropdown.cs     | 10 +++++-----
 osu.Game/Collections/CollectionManager.cs       | 17 ++++++-----------
 osu.Game/Overlays/Music/Playlist.cs             | 17 ++++++++++++++++-
 .../Screens/Select/Carousel/CarouselBeatmap.cs  |  2 +-
 .../Select/Carousel/DrawableCarouselBeatmap.cs  |  6 +++---
 .../Carousel/DrawableCarouselBeatmapSet.cs      |  8 ++++----
 9 files changed, 43 insertions(+), 33 deletions(-)

diff --git a/osu.Game.Tests/Visual/Collections/TestSceneManageCollectionsDialog.cs b/osu.Game.Tests/Visual/Collections/TestSceneManageCollectionsDialog.cs
index 888002eb36..caf3473c45 100644
--- a/osu.Game.Tests/Visual/Collections/TestSceneManageCollectionsDialog.cs
+++ b/osu.Game.Tests/Visual/Collections/TestSceneManageCollectionsDialog.cs
@@ -152,7 +152,7 @@ namespace osu.Game.Tests.Visual.Collections
             AddStep("add two collections with same name", () => manager.Collections.AddRange(new[]
             {
                 new BeatmapCollection { Name = { Value = "1" } },
-                new BeatmapCollection { Name = { Value = "1" }, Beatmaps = { beatmapManager.GetAllUsableBeatmapSets().First().Beatmaps[0] } },
+                new BeatmapCollection { Name = { Value = "1" }, Beatmaps = { beatmapManager.GetAllUsableBeatmapSets().First().Beatmaps[0].MD5Hash } },
             }));
         }
 
@@ -162,7 +162,7 @@ namespace osu.Game.Tests.Visual.Collections
             AddStep("add two collections", () => manager.Collections.AddRange(new[]
             {
                 new BeatmapCollection { Name = { Value = "1" } },
-                new BeatmapCollection { Name = { Value = "2" }, Beatmaps = { beatmapManager.GetAllUsableBeatmapSets().First().Beatmaps[0] } },
+                new BeatmapCollection { Name = { Value = "2" }, Beatmaps = { beatmapManager.GetAllUsableBeatmapSets().First().Beatmaps[0].MD5Hash } },
             }));
 
             assertCollectionCount(2);
@@ -198,7 +198,7 @@ namespace osu.Game.Tests.Visual.Collections
         {
             AddStep("add two collections", () => manager.Collections.AddRange(new[]
             {
-                new BeatmapCollection { Name = { Value = "1" }, Beatmaps = { beatmapManager.GetAllUsableBeatmapSets().First().Beatmaps[0] } },
+                new BeatmapCollection { Name = { Value = "1" }, Beatmaps = { beatmapManager.GetAllUsableBeatmapSets().First().Beatmaps[0].MD5Hash } },
             }));
 
             assertCollectionCount(1);
diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneFilterControl.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneFilterControl.cs
index b7ec128596..db49ec06f8 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneFilterControl.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneFilterControl.cs
@@ -151,7 +151,7 @@ namespace osu.Game.Tests.Visual.SongSelect
             AddStep("add collection", () => collectionManager.Collections.Add(new BeatmapCollection { Name = { Value = "1" } }));
             AddAssert("button is plus", () => getAddOrRemoveButton(1).Icon.Equals(FontAwesome.Solid.PlusSquare));
 
-            AddStep("add beatmap to collection", () => collectionManager.Collections[0].Beatmaps.Add(Beatmap.Value.BeatmapInfo));
+            AddStep("add beatmap to collection", () => collectionManager.Collections[0].Beatmaps.Add(Beatmap.Value.BeatmapInfo.MD5Hash));
             AddAssert("button is minus", () => getAddOrRemoveButton(1).Icon.Equals(FontAwesome.Solid.MinusSquare));
 
             AddStep("remove beatmap from collection", () => collectionManager.Collections[0].Beatmaps.Clear());
@@ -169,11 +169,11 @@ namespace osu.Game.Tests.Visual.SongSelect
             AddAssert("button is plus", () => getAddOrRemoveButton(1).Icon.Equals(FontAwesome.Solid.PlusSquare));
 
             addClickAddOrRemoveButtonStep(1);
-            AddAssert("collection contains beatmap", () => collectionManager.Collections[0].Beatmaps.Contains(Beatmap.Value.BeatmapInfo));
+            AddAssert("collection contains beatmap", () => collectionManager.Collections[0].Beatmaps.Contains(Beatmap.Value.BeatmapInfo.MD5Hash));
             AddAssert("button is minus", () => getAddOrRemoveButton(1).Icon.Equals(FontAwesome.Solid.MinusSquare));
 
             addClickAddOrRemoveButtonStep(1);
-            AddAssert("collection does not contain beatmap", () => !collectionManager.Collections[0].Beatmaps.Contains(Beatmap.Value.BeatmapInfo));
+            AddAssert("collection does not contain beatmap", () => !collectionManager.Collections[0].Beatmaps.Contains(Beatmap.Value.BeatmapInfo.MD5Hash));
             AddAssert("button is plus", () => getAddOrRemoveButton(1).Icon.Equals(FontAwesome.Solid.PlusSquare));
         }
 
diff --git a/osu.Game/Collections/BeatmapCollection.cs b/osu.Game/Collections/BeatmapCollection.cs
index 7e4b15ecf9..ca0f57f638 100644
--- a/osu.Game/Collections/BeatmapCollection.cs
+++ b/osu.Game/Collections/BeatmapCollection.cs
@@ -23,9 +23,9 @@ namespace osu.Game.Collections
         public readonly Bindable<string> Name = new Bindable<string>();
 
         /// <summary>
-        /// The beatmaps contained by the collection.
+        /// The <see cref="BeatmapInfo.MD5Hash"/>es of beatmaps contained by the collection.
         /// </summary>
-        public readonly BindableList<BeatmapInfo> Beatmaps = new BindableList<BeatmapInfo>();
+        public readonly BindableList<string> Beatmaps = new BindableList<string>();
 
         /// <summary>
         /// The date when this collection was last modified.
diff --git a/osu.Game/Collections/CollectionFilterDropdown.cs b/osu.Game/Collections/CollectionFilterDropdown.cs
index c46ba8e06e..97e5711d75 100644
--- a/osu.Game/Collections/CollectionFilterDropdown.cs
+++ b/osu.Game/Collections/CollectionFilterDropdown.cs
@@ -38,7 +38,7 @@ namespace osu.Game.Collections
         }
 
         private readonly IBindableList<BeatmapCollection> collections = new BindableList<BeatmapCollection>();
-        private readonly IBindableList<BeatmapInfo> beatmaps = new BindableList<BeatmapInfo>();
+        private readonly IBindableList<string> beatmaps = new BindableList<string>();
         private readonly BindableList<CollectionFilterMenuItem> filters = new BindableList<CollectionFilterMenuItem>();
 
         [Resolved(CanBeNull = true)]
@@ -196,7 +196,7 @@ namespace osu.Game.Collections
             private IBindable<WorkingBeatmap> beatmap { get; set; }
 
             [CanBeNull]
-            private readonly BindableList<BeatmapInfo> collectionBeatmaps;
+            private readonly BindableList<string> collectionBeatmaps;
 
             [NotNull]
             private readonly Bindable<string> collectionName;
@@ -258,7 +258,7 @@ namespace osu.Game.Collections
             {
                 Debug.Assert(collectionBeatmaps != null);
 
-                beatmapInCollection = collectionBeatmaps.Contains(beatmap.Value.BeatmapInfo);
+                beatmapInCollection = collectionBeatmaps.Contains(beatmap.Value.BeatmapInfo.MD5Hash);
 
                 addOrRemoveButton.Enabled.Value = !beatmap.IsDefault;
                 addOrRemoveButton.Icon = beatmapInCollection ? FontAwesome.Solid.MinusSquare : FontAwesome.Solid.PlusSquare;
@@ -285,8 +285,8 @@ namespace osu.Game.Collections
             {
                 Debug.Assert(collectionBeatmaps != null);
 
-                if (!collectionBeatmaps.Remove(beatmap.Value.BeatmapInfo))
-                    collectionBeatmaps.Add(beatmap.Value.BeatmapInfo);
+                if (!collectionBeatmaps.Remove(beatmap.Value.BeatmapInfo.MD5Hash))
+                    collectionBeatmaps.Add(beatmap.Value.BeatmapInfo.MD5Hash);
             }
 
             protected override Drawable CreateContent() => content = (Content)base.CreateContent();
diff --git a/osu.Game/Collections/CollectionManager.cs b/osu.Game/Collections/CollectionManager.cs
index 700b0f5dcb..30171a71af 100644
--- a/osu.Game/Collections/CollectionManager.cs
+++ b/osu.Game/Collections/CollectionManager.cs
@@ -13,7 +13,6 @@ using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Logging;
 using osu.Framework.Platform;
-using osu.Game.Beatmaps;
 using osu.Game.Database;
 using osu.Game.IO;
 using osu.Game.IO.Legacy;
@@ -40,9 +39,6 @@ namespace osu.Game.Collections
 
         public readonly BindableList<BeatmapCollection> Collections = new BindableList<BeatmapCollection>();
 
-        [Resolved]
-        private BeatmapManager beatmaps { get; set; }
-
         private readonly Storage storage;
 
         public CollectionManager(Storage storage)
@@ -173,7 +169,7 @@ namespace osu.Game.Collections
                         if (existing == null)
                             Collections.Add(existing = new BeatmapCollection { Name = { Value = newCol.Name.Value } });
 
-                        foreach (var newBeatmap in newCol.Beatmaps)
+                        foreach (string newBeatmap in newCol.Beatmaps)
                         {
                             if (!existing.Beatmaps.Contains(newBeatmap))
                                 existing.Beatmaps.Add(newBeatmap);
@@ -226,9 +222,7 @@ namespace osu.Game.Collections
 
                             string checksum = sr.ReadString();
 
-                            var beatmap = beatmaps.QueryBeatmap(b => b.MD5Hash == checksum);
-                            if (beatmap != null)
-                                collection.Beatmaps.Add(beatmap);
+                            collection.Beatmaps.Add(checksum);
                         }
 
                         if (notification != null)
@@ -299,11 +293,12 @@ namespace osu.Game.Collections
                             {
                                 sw.Write(c.Name.Value);
 
-                                var beatmapsCopy = c.Beatmaps.ToArray();
+                                string[] beatmapsCopy = c.Beatmaps.ToArray();
+
                                 sw.Write(beatmapsCopy.Length);
 
-                                foreach (var b in beatmapsCopy)
-                                    sw.Write(b.MD5Hash);
+                                foreach (string b in beatmapsCopy)
+                                    sw.Write(b);
                             }
                         }
 
diff --git a/osu.Game/Overlays/Music/Playlist.cs b/osu.Game/Overlays/Music/Playlist.cs
index 24d867141c..4653a65041 100644
--- a/osu.Game/Overlays/Music/Playlist.cs
+++ b/osu.Game/Overlays/Music/Playlist.cs
@@ -30,7 +30,22 @@ namespace osu.Game.Overlays.Music
             var items = (SearchContainer<RearrangeableListItem<Live<BeatmapSetInfo>>>)ListContainer;
 
             foreach (var item in items.OfType<PlaylistItem>())
-                item.InSelectedCollection = criteria.Collection?.Beatmaps.Any(b => item.Model.ID == b.BeatmapSet?.ID) ?? true;
+            {
+                var beatmapHashes = item.Model.Value.Beatmaps.Select(b => b.MD5Hash);
+
+                bool contained = false;
+
+                foreach (string hash in beatmapHashes)
+                {
+                    if (criteria.Collection?.Beatmaps.Contains(hash) == true)
+                    {
+                        contained = true;
+                        break;
+                    }
+                }
+
+                item.InSelectedCollection = contained;
+            }
 
             items.SearchTerm = criteria.SearchText;
         }
diff --git a/osu.Game/Screens/Select/Carousel/CarouselBeatmap.cs b/osu.Game/Screens/Select/Carousel/CarouselBeatmap.cs
index fd6a869938..de9899f288 100644
--- a/osu.Game/Screens/Select/Carousel/CarouselBeatmap.cs
+++ b/osu.Game/Screens/Select/Carousel/CarouselBeatmap.cs
@@ -72,7 +72,7 @@ namespace osu.Game.Screens.Select.Carousel
             }
 
             if (match)
-                match &= criteria.Collection?.Beatmaps.Contains(BeatmapInfo) ?? true;
+                match &= criteria.Collection?.Beatmaps.Contains(BeatmapInfo.MD5Hash) ?? true;
 
             if (match && criteria.RulesetCriteria != null)
                 match &= criteria.RulesetCriteria.Matches(BeatmapInfo);
diff --git a/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmap.cs b/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmap.cs
index 98b885eb43..79d27e9d9d 100644
--- a/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmap.cs
+++ b/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmap.cs
@@ -256,12 +256,12 @@ namespace osu.Game.Screens.Select.Carousel
             return new ToggleMenuItem(collection.Name.Value, MenuItemType.Standard, s =>
             {
                 if (s)
-                    collection.Beatmaps.Add(beatmapInfo);
+                    collection.Beatmaps.Add(beatmapInfo.MD5Hash);
                 else
-                    collection.Beatmaps.Remove(beatmapInfo);
+                    collection.Beatmaps.Remove(beatmapInfo.MD5Hash);
             })
             {
-                State = { Value = collection.Beatmaps.Contains(beatmapInfo) }
+                State = { Value = collection.Beatmaps.Contains(beatmapInfo.MD5Hash) }
             };
         }
 
diff --git a/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmapSet.cs b/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmapSet.cs
index 2d70b1aecb..ade89c5b35 100644
--- a/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmapSet.cs
+++ b/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmapSet.cs
@@ -245,7 +245,7 @@ namespace osu.Game.Screens.Select.Carousel
 
             TernaryState state;
 
-            int countExisting = beatmapSet.Beatmaps.Count(b => collection.Beatmaps.Contains(b));
+            int countExisting = beatmapSet.Beatmaps.Count(b => collection.Beatmaps.Contains(b.MD5Hash));
 
             if (countExisting == beatmapSet.Beatmaps.Count)
                 state = TernaryState.True;
@@ -261,14 +261,14 @@ namespace osu.Game.Screens.Select.Carousel
                     switch (s)
                     {
                         case TernaryState.True:
-                            if (collection.Beatmaps.Contains(b))
+                            if (collection.Beatmaps.Contains(b.MD5Hash))
                                 continue;
 
-                            collection.Beatmaps.Add(b);
+                            collection.Beatmaps.Add(b.MD5Hash);
                             break;
 
                         case TernaryState.False:
-                            collection.Beatmaps.Remove(b);
+                            collection.Beatmaps.Remove(b.MD5Hash);
                             break;
                     }
                 }

From 3d4d87bcb2194ad2c48aa9d41569170a0d91913a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 8 Jun 2022 18:34:28 +0900
Subject: [PATCH 5321/5547] Update test expectations

---
 osu.Game.Tests/Collections/IO/ImportCollectionsTest.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Collections/IO/ImportCollectionsTest.cs b/osu.Game.Tests/Collections/IO/ImportCollectionsTest.cs
index 5cbede54f5..db6e93206d 100644
--- a/osu.Game.Tests/Collections/IO/ImportCollectionsTest.cs
+++ b/osu.Game.Tests/Collections/IO/ImportCollectionsTest.cs
@@ -50,10 +50,10 @@ namespace osu.Game.Tests.Collections.IO
                     Assert.That(osu.CollectionManager.Collections.Count, Is.EqualTo(2));
 
                     Assert.That(osu.CollectionManager.Collections[0].Name.Value, Is.EqualTo("First"));
-                    Assert.That(osu.CollectionManager.Collections[0].Beatmaps.Count, Is.Zero);
+                    Assert.That(osu.CollectionManager.Collections[0].Beatmaps.Count, Is.EqualTo(1));
 
                     Assert.That(osu.CollectionManager.Collections[1].Name.Value, Is.EqualTo("Second"));
-                    Assert.That(osu.CollectionManager.Collections[1].Beatmaps.Count, Is.Zero);
+                    Assert.That(osu.CollectionManager.Collections[1].Beatmaps.Count, Is.EqualTo(12));
                 }
                 finally
                 {

From c661f2b059e983938a4b2cbdb5f90e915968c1cb Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 8 Jun 2022 18:54:23 +0900
Subject: [PATCH 5322/5547] Ensure `ChannelManager` has access to API from
 point of construction

Closes https://github.com/ppy/osu/issues/18451.
---
 osu.Game.Tests/Chat/TestSceneChannelManager.cs     |  8 ++++----
 osu.Game.Tests/Visual/Online/TestSceneChatLink.cs  |  2 +-
 .../Visual/Online/TestSceneChatOverlay.cs          |  2 +-
 .../Visual/Online/TestSceneMessageNotifier.cs      |  7 ++++---
 .../Online/TestSceneStandAloneChatDisplay.cs       | 14 ++++++++++----
 .../Components/TournamentMatchChatDisplay.cs       |  5 +++--
 osu.Game/Online/Chat/ChannelManager.cs             |  6 +++---
 osu.Game/OsuGame.cs                                |  2 +-
 8 files changed, 27 insertions(+), 19 deletions(-)

diff --git a/osu.Game.Tests/Chat/TestSceneChannelManager.cs b/osu.Game.Tests/Chat/TestSceneChannelManager.cs
index eaacc623c9..2bb6459f20 100644
--- a/osu.Game.Tests/Chat/TestSceneChannelManager.cs
+++ b/osu.Game.Tests/Chat/TestSceneChannelManager.cs
@@ -25,7 +25,7 @@ namespace osu.Game.Tests.Chat
         [SetUp]
         public void Setup() => Schedule(() =>
         {
-            var container = new ChannelManagerContainer();
+            var container = new ChannelManagerContainer(API);
             Child = container;
             channelManager = container.ChannelManager;
         });
@@ -145,11 +145,11 @@ namespace osu.Game.Tests.Chat
         private class ChannelManagerContainer : CompositeDrawable
         {
             [Cached]
-            public ChannelManager ChannelManager { get; } = new ChannelManager();
+            public ChannelManager ChannelManager { get; }
 
-            public ChannelManagerContainer()
+            public ChannelManagerContainer(IAPIProvider apiProvider)
             {
-                InternalChild = ChannelManager;
+                InternalChild = ChannelManager = new ChannelManager(apiProvider);
             }
         }
     }
diff --git a/osu.Game.Tests/Visual/Online/TestSceneChatLink.cs b/osu.Game.Tests/Visual/Online/TestSceneChatLink.cs
index a28de3be1e..4d227af2cb 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneChatLink.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneChatLink.cs
@@ -39,7 +39,7 @@ namespace osu.Game.Tests.Visual.Online
         {
             linkColour = colours.Blue;
 
-            var chatManager = new ChannelManager();
+            var chatManager = new ChannelManager(API);
             BindableList<Channel> availableChannels = (BindableList<Channel>)chatManager.AvailableChannels;
             availableChannels.Add(new Channel { Name = "#english" });
             availableChannels.Add(new Channel { Name = "#japanese" });
diff --git a/osu.Game.Tests/Visual/Online/TestSceneChatOverlay.cs b/osu.Game.Tests/Visual/Online/TestSceneChatOverlay.cs
index 97221329f5..e3792c0780 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneChatOverlay.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneChatOverlay.cs
@@ -59,7 +59,7 @@ namespace osu.Game.Tests.Visual.Online
                 RelativeSizeAxes = Axes.Both,
                 CachedDependencies = new (Type, object)[]
                 {
-                    (typeof(ChannelManager), channelManager = new ChannelManager()),
+                    (typeof(ChannelManager), channelManager = new ChannelManager(API)),
                 },
                 Children = new Drawable[]
                 {
diff --git a/osu.Game.Tests/Visual/Online/TestSceneMessageNotifier.cs b/osu.Game.Tests/Visual/Online/TestSceneMessageNotifier.cs
index 5f7c8b3c51..c7ca3b4457 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneMessageNotifier.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneMessageNotifier.cs
@@ -44,7 +44,7 @@ namespace osu.Game.Tests.Visual.Online
 
             Schedule(() =>
             {
-                Child = testContainer = new TestContainer(new[] { publicChannel, privateMessageChannel })
+                Child = testContainer = new TestContainer(API, new[] { publicChannel, privateMessageChannel })
                 {
                     RelativeSizeAxes = Axes.Both,
                 };
@@ -229,7 +229,7 @@ namespace osu.Game.Tests.Visual.Online
         private class TestContainer : Container
         {
             [Cached]
-            public ChannelManager ChannelManager { get; } = new ChannelManager();
+            public ChannelManager ChannelManager { get; }
 
             [Cached(typeof(INotificationOverlay))]
             public NotificationOverlay NotificationOverlay { get; } = new NotificationOverlay
@@ -245,9 +245,10 @@ namespace osu.Game.Tests.Visual.Online
 
             private readonly Channel[] channels;
 
-            public TestContainer(Channel[] channels)
+            public TestContainer(IAPIProvider api, Channel[] channels)
             {
                 this.channels = channels;
+                ChannelManager = new ChannelManager(api);
             }
 
             [BackgroundDependencyLoader]
diff --git a/osu.Game.Tests/Visual/Online/TestSceneStandAloneChatDisplay.cs b/osu.Game.Tests/Visual/Online/TestSceneStandAloneChatDisplay.cs
index cb52f41c33..8d5eebd31f 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneStandAloneChatDisplay.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneStandAloneChatDisplay.cs
@@ -11,6 +11,7 @@ using NUnit.Framework;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Testing;
 using osu.Framework.Utils;
+using osu.Game.Online.API;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays.Chat;
 using osuTK.Input;
@@ -44,17 +45,22 @@ namespace osu.Game.Tests.Visual.Online
             Id = 5,
         };
 
-        [Cached]
-        private ChannelManager channelManager = new ChannelManager();
+        private ChannelManager channelManager;
 
         private TestStandAloneChatDisplay chatDisplay;
         private int messageIdSequence;
 
         private Channel testChannel;
 
-        public TestSceneStandAloneChatDisplay()
+        protected override IReadOnlyDependencyContainer CreateChildDependencies(IReadOnlyDependencyContainer parent)
         {
-            Add(channelManager);
+            Add(channelManager = new ChannelManager(parent.Get<IAPIProvider>()));
+
+            var dependencies = new DependencyContainer(base.CreateChildDependencies(parent));
+
+            dependencies.Cache(channelManager);
+
+            return dependencies;
         }
 
         [SetUp]
diff --git a/osu.Game.Tournament/Components/TournamentMatchChatDisplay.cs b/osu.Game.Tournament/Components/TournamentMatchChatDisplay.cs
index a5ead6c2f0..c30250c86a 100644
--- a/osu.Game.Tournament/Components/TournamentMatchChatDisplay.cs
+++ b/osu.Game.Tournament/Components/TournamentMatchChatDisplay.cs
@@ -5,6 +5,7 @@ using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
+using osu.Game.Online.API;
 using osu.Game.Online.Chat;
 using osu.Game.Overlays.Chat;
 using osu.Game.Tournament.IPC;
@@ -29,7 +30,7 @@ namespace osu.Game.Tournament.Components
         }
 
         [BackgroundDependencyLoader(true)]
-        private void load(MatchIPCInfo ipc)
+        private void load(MatchIPCInfo ipc, IAPIProvider api)
         {
             if (ipc != null)
             {
@@ -45,7 +46,7 @@ namespace osu.Game.Tournament.Components
 
                     if (manager == null)
                     {
-                        AddInternal(manager = new ChannelManager { HighPollRate = { Value = true } });
+                        AddInternal(manager = new ChannelManager(api) { HighPollRate = { Value = true } });
                         Channel.BindTo(manager.CurrentChannel);
                     }
 
diff --git a/osu.Game/Online/Chat/ChannelManager.cs b/osu.Game/Online/Chat/ChannelManager.cs
index 31f67bcecc..c96e7c4cd3 100644
--- a/osu.Game/Online/Chat/ChannelManager.cs
+++ b/osu.Game/Online/Chat/ChannelManager.cs
@@ -61,8 +61,7 @@ namespace osu.Game.Online.Chat
         /// </summary>
         public IBindableList<Channel> AvailableChannels => availableChannels;
 
-        [Resolved]
-        private IAPIProvider api { get; set; }
+        private readonly IAPIProvider api;
 
         [Resolved]
         private UserLookupCache users { get; set; }
@@ -71,8 +70,9 @@ namespace osu.Game.Online.Chat
 
         private readonly IBindable<bool> isIdle = new BindableBool();
 
-        public ChannelManager()
+        public ChannelManager(IAPIProvider api)
         {
+            this.api = api;
             CurrentChannel.ValueChanged += currentChannelChanged;
         }
 
diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index b91d523151..1f9a1ce938 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -851,7 +851,7 @@ namespace osu.Game
             loadComponentSingleFile(dashboard = new DashboardOverlay(), overlayContent.Add, true);
             loadComponentSingleFile(news = new NewsOverlay(), overlayContent.Add, true);
             var rankingsOverlay = loadComponentSingleFile(new RankingsOverlay(), overlayContent.Add, true);
-            loadComponentSingleFile(channelManager = new ChannelManager(), AddInternal, true);
+            loadComponentSingleFile(channelManager = new ChannelManager(API), AddInternal, true);
             loadComponentSingleFile(chatOverlay = new ChatOverlay(), overlayContent.Add, true);
             loadComponentSingleFile(new MessageNotifier(), AddInternal, true);
             loadComponentSingleFile(Settings = new SettingsOverlay(), leftFloatingOverlayContent.Add, true);

From 6aa84425a28eb420c0388d20b93d38cc26f61f17 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 8 Jun 2022 19:26:34 +0900
Subject: [PATCH 5323/5547] Add comment explaining test expectations

---
 osu.Game.Tests/Collections/IO/ImportCollectionsTest.cs | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/osu.Game.Tests/Collections/IO/ImportCollectionsTest.cs b/osu.Game.Tests/Collections/IO/ImportCollectionsTest.cs
index db6e93206d..73152c33d9 100644
--- a/osu.Game.Tests/Collections/IO/ImportCollectionsTest.cs
+++ b/osu.Game.Tests/Collections/IO/ImportCollectionsTest.cs
@@ -49,6 +49,11 @@ namespace osu.Game.Tests.Collections.IO
 
                     Assert.That(osu.CollectionManager.Collections.Count, Is.EqualTo(2));
 
+                    // Even with no beatmaps imported, collections are tracking the hashes and will continue to.
+                    // In the future this whole mechanism will be replaced with having the collections in realm,
+                    // but until that happens it makes rough sense that we want to track not-yet-imported beatmaps
+                    // and have them associate with collections if/when they become available.
+
                     Assert.That(osu.CollectionManager.Collections[0].Name.Value, Is.EqualTo("First"));
                     Assert.That(osu.CollectionManager.Collections[0].Beatmaps.Count, Is.EqualTo(1));
 

From c22bffaa012ed7750c011fc3796e9ef6d997786b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 8 Jun 2022 19:30:18 +0900
Subject: [PATCH 5324/5547] Fix filter failure when no collection is selected

---
 osu.Game/Overlays/Music/Playlist.cs | 29 +++++++++++++++++------------
 1 file changed, 17 insertions(+), 12 deletions(-)

diff --git a/osu.Game/Overlays/Music/Playlist.cs b/osu.Game/Overlays/Music/Playlist.cs
index 4653a65041..1d8163b57b 100644
--- a/osu.Game/Overlays/Music/Playlist.cs
+++ b/osu.Game/Overlays/Music/Playlist.cs
@@ -31,20 +31,25 @@ namespace osu.Game.Overlays.Music
 
             foreach (var item in items.OfType<PlaylistItem>())
             {
-                var beatmapHashes = item.Model.Value.Beatmaps.Select(b => b.MD5Hash);
-
-                bool contained = false;
-
-                foreach (string hash in beatmapHashes)
+                if (criteria.Collection == null)
+                    item.InSelectedCollection = true;
+                else
                 {
-                    if (criteria.Collection?.Beatmaps.Contains(hash) == true)
-                    {
-                        contained = true;
-                        break;
-                    }
-                }
+                    var beatmapHashes = item.Model.Value.Beatmaps.Select(b => b.MD5Hash);
 
-                item.InSelectedCollection = contained;
+                    bool contained = false;
+
+                    foreach (string hash in beatmapHashes)
+                    {
+                        if (criteria.Collection?.Beatmaps.Contains(hash) == true)
+                        {
+                            contained = true;
+                            break;
+                        }
+                    }
+
+                    item.InSelectedCollection = contained;
+                }
             }
 
             items.SearchTerm = criteria.SearchText;

From dfa31df2af366a5f3cf7e836a80d335151f3ba37 Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Wed, 8 Jun 2022 13:42:30 +0100
Subject: [PATCH 5325/5547] Use `#nullable enable` in `ChatLine`

---
 osu.Game/Overlays/Chat/ChatLine.cs | 69 ++++++++++++++++--------------
 1 file changed, 36 insertions(+), 33 deletions(-)

diff --git a/osu.Game/Overlays/Chat/ChatLine.cs b/osu.Game/Overlays/Chat/ChatLine.cs
index 13f66089d9..6cd0b76a49 100644
--- a/osu.Game/Overlays/Chat/ChatLine.cs
+++ b/osu.Game/Overlays/Chat/ChatLine.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.
 
+#nullable enable
+
 using System;
 using System.Linq;
 using System.Collections.Generic;
@@ -26,33 +28,6 @@ namespace osu.Game.Overlays.Chat
 {
     public class ChatLine : CompositeDrawable
     {
-        protected virtual float TextSize => 20;
-
-        protected virtual float Spacing => 15;
-
-        protected virtual float TimestampWidth => 60;
-
-        protected virtual float UsernameWidth => 130;
-
-        private Color4 usernameColour;
-
-        private OsuSpriteText timestamp;
-
-        public ChatLine(Message message)
-        {
-            Message = message;
-            RelativeSizeAxes = Axes.X;
-            AutoSizeAxes = Axes.Y;
-        }
-
-        [Resolved(CanBeNull = true)]
-        private ChannelManager chatManager { get; set; }
-
-        private Message message;
-        private OsuSpriteText username;
-
-        public LinkFlowContainer ContentFlow { get; private set; }
-
         public Message Message
         {
             get => message;
@@ -69,10 +44,40 @@ namespace osu.Game.Overlays.Chat
             }
         }
 
+        public LinkFlowContainer ContentFlow { get; private set; } = null!;
+
+        protected virtual float TextSize => 20;
+
+        protected virtual float Spacing => 15;
+
+        protected virtual float TimestampWidth => 60;
+
+        protected virtual float UsernameWidth => 130;
+
+        private Color4 usernameColour;
+
+        private OsuSpriteText timestamp = null!;
+
+        private Message message = null!;
+
+        private OsuSpriteText username = null!;
+
+        private Container? highlight;
+
         private bool senderHasColour => !string.IsNullOrEmpty(message.Sender.Colour);
 
+        [Resolved(CanBeNull = true)]
+        private ChannelManager? chatManager { get; set; }
+
         [Resolved]
-        private OsuColour colours { get; set; }
+        private OsuColour colours { get; set; } = null!;
+
+        public ChatLine(Message message)
+        {
+            Message = message;
+            RelativeSizeAxes = Axes.X;
+            AutoSizeAxes = Axes.Y;
+        }
 
         [BackgroundDependencyLoader]
         private void load()
@@ -151,8 +156,6 @@ namespace osu.Game.Overlays.Chat
             FinishTransforms(true);
         }
 
-        private Container highlight;
-
         /// <summary>
         /// Performs a highlight animation on this <see cref="ChatLine"/>.
         /// </summary>
@@ -250,10 +253,10 @@ namespace osu.Game.Overlays.Chat
         {
             private readonly APIUser sender;
 
-            private Action startChatAction;
+            private Action startChatAction = null!;
 
             [Resolved]
-            private IAPIProvider api { get; set; }
+            private IAPIProvider api { get; set; } = null!;
 
             public MessageSender(APIUser sender)
             {
@@ -261,7 +264,7 @@ namespace osu.Game.Overlays.Chat
             }
 
             [BackgroundDependencyLoader(true)]
-            private void load(UserProfileOverlay profile, ChannelManager chatManager)
+            private void load(UserProfileOverlay? profile, ChannelManager? chatManager)
             {
                 Action = () => profile?.ShowUser(sender);
                 startChatAction = () => chatManager?.OpenPrivateChannel(sender);

From 04b434b8cee80b5d90a290caf766ea7e02287a06 Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Wed, 8 Jun 2022 13:51:16 +0100
Subject: [PATCH 5326/5547] Update `ChatLine` timestamp and message colours

---
 osu.Game/Overlays/Chat/ChatLine.cs | 17 ++++++-----------
 1 file changed, 6 insertions(+), 11 deletions(-)

diff --git a/osu.Game/Overlays/Chat/ChatLine.cs b/osu.Game/Overlays/Chat/ChatLine.cs
index 6cd0b76a49..a6ea4307ee 100644
--- a/osu.Game/Overlays/Chat/ChatLine.cs
+++ b/osu.Game/Overlays/Chat/ChatLine.cs
@@ -66,6 +66,8 @@ namespace osu.Game.Overlays.Chat
 
         private bool senderHasColour => !string.IsNullOrEmpty(message.Sender.Colour);
 
+        private bool messageHasColour => Message.IsAction && senderHasColour;
+
         [Resolved(CanBeNull = true)]
         private ChannelManager? chatManager { get; set; }
 
@@ -80,7 +82,7 @@ namespace osu.Game.Overlays.Chat
         }
 
         [BackgroundDependencyLoader]
-        private void load()
+        private void load(OverlayColourProvider? colourProvider)
         {
             usernameColour = senderHasColour
                 ? Color4Extensions.FromHex(message.Sender.Colour)
@@ -113,6 +115,7 @@ namespace osu.Game.Overlays.Chat
                                     Origin = Anchor.CentreLeft,
                                     Font = OsuFont.GetFont(size: TextSize * 0.75f, weight: FontWeight.SemiBold, fixedWidth: true),
                                     MaxWidth = TimestampWidth,
+                                    Colour = colourProvider?.Background1 ?? Colour4.White,
                                 },
                                 new MessageSender(message.Sender)
                                 {
@@ -128,16 +131,8 @@ namespace osu.Game.Overlays.Chat
                         ContentFlow = new LinkFlowContainer(t =>
                         {
                             t.Shadow = false;
-
-                            if (Message.IsAction)
-                            {
-                                t.Font = OsuFont.GetFont(italics: true);
-
-                                if (senderHasColour)
-                                    t.Colour = Color4Extensions.FromHex(message.Sender.Colour);
-                            }
-
-                            t.Font = t.Font.With(size: TextSize);
+                            t.Font = t.Font.With(size: TextSize, italics: Message.IsAction);
+                            t.Colour = messageHasColour ? Color4Extensions.FromHex(message.Sender.Colour) : colourProvider?.Content1 ?? Colour4.White;
                         })
                         {
                             AutoSizeAxes = Axes.Y,

From c2ed41d097f67659c684fa8cdb18984ff3db88b5 Mon Sep 17 00:00:00 2001
From: Jai Sharma <jai@jai.moe>
Date: Wed, 8 Jun 2022 15:10:19 +0100
Subject: [PATCH 5327/5547] Remove `CanBeNull` specification from DI attributes

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

diff --git a/osu.Game/Overlays/Chat/ChatLine.cs b/osu.Game/Overlays/Chat/ChatLine.cs
index a6ea4307ee..56e39f212d 100644
--- a/osu.Game/Overlays/Chat/ChatLine.cs
+++ b/osu.Game/Overlays/Chat/ChatLine.cs
@@ -68,7 +68,7 @@ namespace osu.Game.Overlays.Chat
 
         private bool messageHasColour => Message.IsAction && senderHasColour;
 
-        [Resolved(CanBeNull = true)]
+        [Resolved]
         private ChannelManager? chatManager { get; set; }
 
         [Resolved]
@@ -258,7 +258,7 @@ namespace osu.Game.Overlays.Chat
                 this.sender = sender;
             }
 
-            [BackgroundDependencyLoader(true)]
+            [BackgroundDependencyLoader]
             private void load(UserProfileOverlay? profile, ChannelManager? chatManager)
             {
                 Action = () => profile?.ShowUser(sender);

From bf67b35aded88dbe5a553ea480c36d04824e8fce Mon Sep 17 00:00:00 2001
From: Endrik Tombak <littleendu@gmail.com>
Date: Wed, 8 Jun 2022 17:44:57 +0300
Subject: [PATCH 5328/5547] Use new own profile statistics in difficulty
 recommender

---
 .../TestSceneBeatmapRecommendations.cs        | 43 +++++--------
 osu.Game/Beatmaps/DifficultyRecommender.cs    | 64 +++++--------------
 2 files changed, 32 insertions(+), 75 deletions(-)

diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapRecommendations.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapRecommendations.cs
index 940d001c5b..a78a8aa028 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapRecommendations.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapRecommendations.cs
@@ -5,12 +5,11 @@ using System;
 using System.Collections.Generic;
 using System.Linq;
 using NUnit.Framework;
+using osu.Framework.Allocation;
+using osu.Framework.Extensions.IEnumerableExtensions;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
 using osu.Game.Extensions;
-using osu.Game.Online.API;
-using osu.Game.Online.API.Requests;
-using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Catch;
 using osu.Game.Rulesets.Mania;
@@ -23,38 +22,28 @@ namespace osu.Game.Tests.Visual.SongSelect
 {
     public class TestSceneBeatmapRecommendations : OsuGameTestScene
     {
+        [Resolved]
+        private IRulesetStore rulesetStore { get; set; }
+
         [SetUpSteps]
         public override void SetUpSteps()
         {
-            AddStep("register request handling", () =>
-            {
-                ((DummyAPIAccess)API).HandleRequest = req =>
-                {
-                    switch (req)
-                    {
-                        case GetUserRequest userRequest:
-                            userRequest.TriggerSuccess(getUser(userRequest.Ruleset.OnlineID));
-                            return true;
-                    }
-
-                    return false;
-                };
-            });
-
             base.SetUpSteps();
 
-            APIUser getUser(int? rulesetID)
+            AddStep("populate ruleset statistics", () =>
             {
-                return new APIUser
+                Dictionary<string, UserStatistics> rulesetStatistics = new Dictionary<string, UserStatistics>();
+
+                rulesetStore.AvailableRulesets.Where(ruleset => ruleset.IsLegacyRuleset()).ForEach(rulesetInfo =>
                 {
-                    Username = @"Dummy",
-                    Id = 1001,
-                    Statistics = new UserStatistics
+                    rulesetStatistics[rulesetInfo.ShortName] = new UserStatistics
                     {
-                        PP = getNecessaryPP(rulesetID)
-                    }
-                };
-            }
+                        PP = getNecessaryPP(rulesetInfo.OnlineID)
+                    };
+                });
+
+                API.LocalUser.Value.RulesetsStatistics = rulesetStatistics;
+            });
 
             decimal getNecessaryPP(int? rulesetID)
             {
diff --git a/osu.Game/Beatmaps/DifficultyRecommender.cs b/osu.Game/Beatmaps/DifficultyRecommender.cs
index 93c2fccbc7..72f1931c86 100644
--- a/osu.Game/Beatmaps/DifficultyRecommender.cs
+++ b/osu.Game/Beatmaps/DifficultyRecommender.cs
@@ -7,11 +7,8 @@ using System.Linq;
 using JetBrains.Annotations;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
-using osu.Framework.Extensions.IEnumerableExtensions;
 using osu.Framework.Graphics;
-using osu.Game.Extensions;
 using osu.Game.Online.API;
-using osu.Game.Online.API.Requests;
 using osu.Game.Rulesets;
 
 namespace osu.Game.Beatmaps
@@ -25,26 +22,15 @@ namespace osu.Game.Beatmaps
         [Resolved]
         private IAPIProvider api { get; set; }
 
-        [Resolved]
-        private IRulesetStore rulesets { get; set; }
-
         [Resolved]
         private Bindable<RulesetInfo> ruleset { get; set; }
 
-        /// <summary>
-        /// The user for which the last requests were run.
-        /// </summary>
-        private int? requestedUserId;
-
-        private readonly Dictionary<IRulesetInfo, double> recommendedDifficultyMapping = new Dictionary<IRulesetInfo, double>();
-
-        private readonly IBindable<APIState> apiState = new Bindable<APIState>();
+        private readonly Dictionary<string, double> recommendedDifficultyMapping = new Dictionary<string, double>();
 
         [BackgroundDependencyLoader]
         private void load()
         {
-            apiState.BindTo(api.State);
-            apiState.BindValueChanged(onlineStateChanged, true);
+            api.LocalUser.BindValueChanged(_ => populateValues(), true);
         }
 
         /// <summary>
@@ -58,12 +44,12 @@ namespace osu.Game.Beatmaps
         [CanBeNull]
         public BeatmapInfo GetRecommendedBeatmap(IEnumerable<BeatmapInfo> beatmaps)
         {
-            foreach (var r in orderedRulesets)
+            foreach (string r in orderedRulesets)
             {
                 if (!recommendedDifficultyMapping.TryGetValue(r, out double recommendation))
                     continue;
 
-                BeatmapInfo beatmapInfo = beatmaps.Where(b => b.Ruleset.Equals(r)).OrderBy(b =>
+                BeatmapInfo beatmapInfo = beatmaps.Where(b => b.Ruleset.ShortName.Equals(r)).OrderBy(b =>
                 {
                     double difference = b.StarRating - recommendation;
                     return difference >= 0 ? difference * 2 : difference * -1; // prefer easier over harder
@@ -76,55 +62,37 @@ namespace osu.Game.Beatmaps
             return null;
         }
 
-        private void fetchRecommendedValues()
+        private void populateValues()
         {
-            if (recommendedDifficultyMapping.Count > 0 && api.LocalUser.Value.Id == requestedUserId)
+            if (api.LocalUser.Value.RulesetsStatistics == null)
                 return;
 
-            requestedUserId = api.LocalUser.Value.Id;
-
-            // only query API for built-in rulesets
-            rulesets.AvailableRulesets.Where(ruleset => ruleset.IsLegacyRuleset()).ForEach(rulesetInfo =>
+            foreach (var statistic in api.LocalUser.Value.RulesetsStatistics)
             {
-                var req = new GetUserRequest(api.LocalUser.Value.Id, rulesetInfo);
-
-                req.Success += result =>
-                {
-                    // algorithm taken from https://github.com/ppy/osu-web/blob/e6e2825516449e3d0f3f5e1852c6bdd3428c3437/app/Models/User.php#L1505
-                    recommendedDifficultyMapping[rulesetInfo] = Math.Pow((double)(result.Statistics.PP ?? 0), 0.4) * 0.195;
-                };
-
-                api.Queue(req);
-            });
+                decimal? pp = api.LocalUser.Value.RulesetsStatistics[statistic.Key].PP;
+                // algorithm taken from https://github.com/ppy/osu-web/blob/e6e2825516449e3d0f3f5e1852c6bdd3428c3437/app/Models/User.php#L1505
+                double recommended = Math.Pow((double)(pp ?? 0), 0.4) * 0.195;
+                recommendedDifficultyMapping[statistic.Key] = recommended;
+            }
         }
 
         /// <returns>
         /// Rulesets ordered descending by their respective recommended difficulties.
         /// The currently selected ruleset will always be first.
         /// </returns>
-        private IEnumerable<IRulesetInfo> orderedRulesets
+        private IEnumerable<string> orderedRulesets
         {
             get
             {
                 if (LoadState < LoadState.Ready || ruleset.Value == null)
-                    return Enumerable.Empty<RulesetInfo>();
+                    return Enumerable.Empty<string>();
 
                 return recommendedDifficultyMapping
                        .OrderByDescending(pair => pair.Value)
                        .Select(pair => pair.Key)
-                       .Where(r => !r.Equals(ruleset.Value))
-                       .Prepend(ruleset.Value);
+                       .Where(r => !r.Equals(ruleset.Value.ShortName))
+                       .Prepend(ruleset.Value.ShortName);
             }
         }
-
-        private void onlineStateChanged(ValueChangedEvent<APIState> state) => Schedule(() =>
-        {
-            switch (state.NewValue)
-            {
-                case APIState.Online:
-                    fetchRecommendedValues();
-                    break;
-            }
-        });
     }
 }

From eb33922417f451914a57d763b4a304a501309e63 Mon Sep 17 00:00:00 2001
From: tornac1234 <tortornac@gmail.com>
Date: Wed, 8 Jun 2022 18:13:08 +0200
Subject: [PATCH 5329/5547] Revert "Added user RulesetsStatistics fetching when
 connecting"

This reverts commit e2cdc66f6d378c20511c3be2fe724aa0f68a3eca.
---
 osu.Game/Online/API/APIAccess.cs | 26 +++-----------------------
 1 file changed, 3 insertions(+), 23 deletions(-)

diff --git a/osu.Game/Online/API/APIAccess.cs b/osu.Game/Online/API/APIAccess.cs
index f59bee1065..62ddd49881 100644
--- a/osu.Game/Online/API/APIAccess.cs
+++ b/osu.Game/Online/API/APIAccess.cs
@@ -171,32 +171,12 @@ namespace osu.Game.Online.API
                         };
                         userReq.Success += u =>
                         {
+                            localUser.Value = u;
+
                             // todo: save/pull from settings
-                            u.Status.Value = new UserStatusOnline();
+                            localUser.Value.Status.Value = new UserStatusOnline();
 
                             failureCount = 0;
-
-                            // getting user's full statistics (concerning every ruleset)
-                            // we delay the localUser.Value setting because BindValueChanged won't record two value changes in a row
-                            var statsRequest = new GetUsersRequest(new int[] { u.Id });
-                            statsRequest.Failure += _ =>
-                            {
-                                localUser.Value = u;
-                                failConnectionProcess();
-                            };
-                            statsRequest.Success += result =>
-                            {
-                                if (result.Users.Count == 1)
-                                {
-                                    u.RulesetsStatistics = result.Users[0].RulesetsStatistics;
-                                    localUser.Value = u;
-                                    return;
-                                }
-                                // Should never... happen ?
-                                statsRequest.Fail(new Exception("Empty response for GetUsersRequest"));
-                            };
-
-                            handleRequest(statsRequest);
                         };
 
                         if (!handleRequest(userReq))

From c90b2858619e6a03d58e192a8912de64646b827d Mon Sep 17 00:00:00 2001
From: Endrik Tombak <littleendu@gmail.com>
Date: Wed, 8 Jun 2022 21:10:27 +0300
Subject: [PATCH 5330/5547] Change variable name and inline it

---
 osu.Game/Beatmaps/DifficultyRecommender.cs | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Beatmaps/DifficultyRecommender.cs b/osu.Game/Beatmaps/DifficultyRecommender.cs
index 72f1931c86..4629b20569 100644
--- a/osu.Game/Beatmaps/DifficultyRecommender.cs
+++ b/osu.Game/Beatmaps/DifficultyRecommender.cs
@@ -67,12 +67,10 @@ namespace osu.Game.Beatmaps
             if (api.LocalUser.Value.RulesetsStatistics == null)
                 return;
 
-            foreach (var statistic in api.LocalUser.Value.RulesetsStatistics)
+            foreach (var kvp in api.LocalUser.Value.RulesetsStatistics)
             {
-                decimal? pp = api.LocalUser.Value.RulesetsStatistics[statistic.Key].PP;
                 // algorithm taken from https://github.com/ppy/osu-web/blob/e6e2825516449e3d0f3f5e1852c6bdd3428c3437/app/Models/User.php#L1505
-                double recommended = Math.Pow((double)(pp ?? 0), 0.4) * 0.195;
-                recommendedDifficultyMapping[statistic.Key] = recommended;
+                recommendedDifficultyMapping[kvp.Key] = Math.Pow((double)(kvp.Value.PP ?? 0), 0.4) * 0.195;
             }
         }
 

From c6264d5b3d5487fac84f94eb8d915e83af20cd68 Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Wed, 8 Jun 2022 11:57:20 -0700
Subject: [PATCH 5331/5547] Split beatmap set overlay tests to online and
 offline

---
 .../Online/TestSceneBeatmapSetOverlay.cs      |  9 -------
 .../TestSceneOnlineBeatmapSetOverlay.cs       | 26 +++++++++++++++++++
 2 files changed, 26 insertions(+), 9 deletions(-)
 create mode 100644 osu.Game.Tests/Visual/Online/TestSceneOnlineBeatmapSetOverlay.cs

diff --git a/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlay.cs b/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlay.cs
index 9d206af40e..417296a1a1 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlay.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlay.cs
@@ -18,13 +18,10 @@ using APIUser = osu.Game.Online.API.Requests.Responses.APIUser;
 
 namespace osu.Game.Tests.Visual.Online
 {
-    [TestFixture]
     public class TestSceneBeatmapSetOverlay : OsuTestScene
     {
         private readonly TestBeatmapSetOverlay overlay;
 
-        protected override bool UseOnlineAPI => true;
-
         private int nextBeatmapSetId = 1;
 
         public TestSceneBeatmapSetOverlay()
@@ -41,12 +38,6 @@ namespace osu.Game.Tests.Visual.Online
             AddStep(@"show loading", () => overlay.ShowBeatmapSet(null));
         }
 
-        [Test]
-        public void TestOnline()
-        {
-            AddStep(@"show online", () => overlay.FetchAndShowBeatmapSet(55));
-        }
-
         [Test]
         public void TestLocalBeatmaps()
         {
diff --git a/osu.Game.Tests/Visual/Online/TestSceneOnlineBeatmapSetOverlay.cs b/osu.Game.Tests/Visual/Online/TestSceneOnlineBeatmapSetOverlay.cs
new file mode 100644
index 0000000000..4e88570ca0
--- /dev/null
+++ b/osu.Game.Tests/Visual/Online/TestSceneOnlineBeatmapSetOverlay.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 NUnit.Framework;
+using osu.Game.Overlays;
+
+namespace osu.Game.Tests.Visual.Online
+{
+    public class TestSceneOnlineBeatmapSetOverlay : OsuTestScene
+    {
+        private readonly BeatmapSetOverlay overlay;
+
+        protected override bool UseOnlineAPI => true;
+
+        public TestSceneOnlineBeatmapSetOverlay()
+        {
+            Add(overlay = new BeatmapSetOverlay());
+        }
+
+        [Test]
+        public void TestOnline()
+        {
+            AddStep(@"show online", () => overlay.FetchAndShowBeatmapSet(55));
+        }
+    }
+}

From 5c138de446f2fc157a21d977c774d47ab4e0a9b1 Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Wed, 8 Jun 2022 12:10:02 -0700
Subject: [PATCH 5332/5547] Add failing mod selector visibility test

---
 osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlay.cs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlay.cs b/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlay.cs
index 417296a1a1..c933e1a54e 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlay.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlay.cs
@@ -98,6 +98,7 @@ namespace osu.Game.Tests.Visual.Online
 
             AddAssert("status is loved", () => overlay.ChildrenOfType<BeatmapSetOnlineStatusPill>().Single().Status == BeatmapOnlineStatus.Loved);
             AddAssert("scores container is visible", () => overlay.ChildrenOfType<ScoresContainer>().Single().Alpha == 1);
+            AddAssert("mod selector is visible", () => overlay.ChildrenOfType<LeaderboardModSelector>().Single().Alpha == 1);
 
             AddStep("go to second beatmap", () => overlay.ChildrenOfType<BeatmapPicker.DifficultySelectorButton>().ElementAt(1).TriggerClick());
 

From f3371e8bc8bd4065c4115ff8ae6200ebbf9869ae Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Sun, 29 May 2022 21:13:53 -0700
Subject: [PATCH 5333/5547] Always show mod selector on beatmap info
 leaderboards regardless of supporter

---
 osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.cs | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.cs b/osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.cs
index 5f24a6549d..ebfb8f124b 100644
--- a/osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.cs
+++ b/osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.cs
@@ -242,8 +242,6 @@ namespace osu.Game.Overlays.BeatmapSet.Scores
                 modSelector.DeselectAll();
             else
                 getScores();
-
-            modSelector.FadeTo(userIsSupporter ? 1 : 0);
         }
 
         private void getScores()
@@ -260,7 +258,7 @@ namespace osu.Game.Overlays.BeatmapSet.Scores
                 return;
             }
 
-            if (scope.Value != BeatmapLeaderboardScope.Global && !userIsSupporter)
+            if ((scope.Value != BeatmapLeaderboardScope.Global || modSelector.SelectedMods.Count > 0) && !userIsSupporter)
             {
                 Scores = null;
                 notSupporterPlaceholder.Show();

From 3799689c7dd6ac73560f8f24a483b3734a6505e2 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 9 Jun 2022 12:32:30 +0900
Subject: [PATCH 5334/5547] Tidy up variable naming and layout

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

diff --git a/osu.Desktop/DiscordRichPresence.cs b/osu.Desktop/DiscordRichPresence.cs
index 0d276d963f..bc5763a3b4 100644
--- a/osu.Desktop/DiscordRichPresence.cs
+++ b/osu.Desktop/DiscordRichPresence.cs
@@ -31,7 +31,7 @@ namespace osu.Desktop
         private IBindable<APIUser> user;
 
         [Resolved]
-        private IAPIProvider provider { get; set; }
+        private IAPIProvider api { get; set; }
 
         private readonly IBindable<UserStatus> status = new Bindable<UserStatus>();
         private readonly IBindable<UserActivity> activity = new Bindable<UserActivity>();
@@ -60,7 +60,8 @@ namespace osu.Desktop
 
             config.BindWith(OsuSetting.DiscordRichPresence, privacyMode);
 
-            (user = provider.LocalUser.GetBoundCopy()).BindValueChanged(u =>
+            user = api.LocalUser.GetBoundCopy();
+            user.BindValueChanged(u =>
             {
                 status.UnbindBindings();
                 status.BindTo(u.NewValue.Status);

From bfde334e77f4c297618e161d02654405521279f4 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 9 Jun 2022 14:03:21 +0900
Subject: [PATCH 5335/5547] Allow beatmaps to load endlessly when entering
 Player

---
 osu.Game/Screens/Play/Player.cs | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Screens/Play/Player.cs b/osu.Game/Screens/Play/Player.cs
index dfc0fa1d1d..8151bb452e 100644
--- a/osu.Game/Screens/Play/Player.cs
+++ b/osu.Game/Screens/Play/Player.cs
@@ -4,6 +4,7 @@
 using System;
 using System.IO;
 using System.Linq;
+using System.Threading;
 using System.Threading.Tasks;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
@@ -181,7 +182,7 @@ namespace osu.Game.Screens.Play
         }
 
         [BackgroundDependencyLoader(true)]
-        private void load(AudioManager audio, OsuConfigManager config, OsuGameBase game)
+        private void load(AudioManager audio, OsuConfigManager config, OsuGameBase game, CancellationToken cancellationToken)
         {
             var gameplayMods = Mods.Value.Select(m => m.DeepClone()).ToArray();
 
@@ -194,7 +195,7 @@ namespace osu.Game.Screens.Play
             if (Beatmap.Value is DummyWorkingBeatmap)
                 return;
 
-            IBeatmap playableBeatmap = loadPlayableBeatmap(gameplayMods);
+            IBeatmap playableBeatmap = loadPlayableBeatmap(gameplayMods, cancellationToken);
 
             if (playableBeatmap == null)
                 return;
@@ -483,7 +484,7 @@ namespace osu.Game.Screens.Play
             }
         }
 
-        private IBeatmap loadPlayableBeatmap(Mod[] gameplayMods)
+        private IBeatmap loadPlayableBeatmap(Mod[] gameplayMods, CancellationToken cancellationToken)
         {
             IBeatmap playable;
 
@@ -500,7 +501,7 @@ namespace osu.Game.Screens.Play
 
                 try
                 {
-                    playable = Beatmap.Value.GetPlayableBeatmap(ruleset.RulesetInfo, gameplayMods);
+                    playable = Beatmap.Value.GetPlayableBeatmap(ruleset.RulesetInfo, gameplayMods, cancellationToken);
                 }
                 catch (BeatmapInvalidForRulesetException)
                 {
@@ -508,7 +509,7 @@ namespace osu.Game.Screens.Play
                     rulesetInfo = Beatmap.Value.BeatmapInfo.Ruleset;
                     ruleset = rulesetInfo.CreateInstance();
 
-                    playable = Beatmap.Value.GetPlayableBeatmap(rulesetInfo, gameplayMods);
+                    playable = Beatmap.Value.GetPlayableBeatmap(rulesetInfo, gameplayMods, cancellationToken);
                 }
 
                 if (playable.HitObjects.Count == 0)

From ec03dc16db09e501fb2c73ab031c32c98faa4e40 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 9 Jun 2022 14:13:13 +0900
Subject: [PATCH 5336/5547] Don't trigger notification when user quit

---
 osu.Game/Screens/Play/Player.cs | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Play/Player.cs b/osu.Game/Screens/Play/Player.cs
index 8151bb452e..5548203fe2 100644
--- a/osu.Game/Screens/Play/Player.cs
+++ b/osu.Game/Screens/Play/Player.cs
@@ -520,7 +520,8 @@ namespace osu.Game.Screens.Play
             }
             catch (Exception e)
             {
-                Logger.Error(e, "Could not load beatmap successfully!");
+                if (this.IsCurrentScreen())
+                    Logger.Error(e, "Could not load beatmap successfully!");
                 //couldn't load, hard abort!
                 return null;
             }

From 6e450b7350ccc570509f343112883b6d473b4ca6 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 9 Jun 2022 14:35:52 +0900
Subject: [PATCH 5337/5547] Explicitly handle operation cancelled exceptions

---
 osu.Game/Screens/Play/Player.cs | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/Play/Player.cs b/osu.Game/Screens/Play/Player.cs
index 5548203fe2..d6f6a06eb7 100644
--- a/osu.Game/Screens/Play/Player.cs
+++ b/osu.Game/Screens/Play/Player.cs
@@ -518,10 +518,14 @@ namespace osu.Game.Screens.Play
                     return null;
                 }
             }
+            catch (OperationCanceledException)
+            {
+                // Load has been cancelled. No logging is required.
+                return null;
+            }
             catch (Exception e)
             {
-                if (this.IsCurrentScreen())
-                    Logger.Error(e, "Could not load beatmap successfully!");
+                Logger.Error(e, "Could not load beatmap successfully!");
                 //couldn't load, hard abort!
                 return null;
             }

From 6d2a2ba7d6fcb5e22397f13d9755453a3e3678da Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 9 Jun 2022 18:49:11 +0900
Subject: [PATCH 5338/5547] Rename Position -> Index

---
 .../Preprocessing/CatchDifficultyHitObject.cs      |  4 ++--
 .../Preprocessing/ManiaDifficultyHitObject.cs      |  4 ++--
 .../Preprocessing/OsuDifficultyHitObject.cs        |  4 ++--
 osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs     |  2 +-
 .../Difficulty/Skills/Flashlight.cs                |  2 +-
 osu.Game.Rulesets.Osu/Difficulty/Skills/Speed.cs   |  4 ++--
 .../Preprocessing/TaikoDifficultyHitObject.cs      |  6 +++---
 .../Difficulty/Skills/Rhythm.cs                    |  2 +-
 .../Preprocessing/DifficultyHitObject.cs           | 14 +++++++-------
 osu.Game/Rulesets/Difficulty/Skills/StrainSkill.cs |  2 +-
 10 files changed, 22 insertions(+), 22 deletions(-)

diff --git a/osu.Game.Rulesets.Catch/Difficulty/Preprocessing/CatchDifficultyHitObject.cs b/osu.Game.Rulesets.Catch/Difficulty/Preprocessing/CatchDifficultyHitObject.cs
index 8c229cf6c5..3bcfce3a56 100644
--- a/osu.Game.Rulesets.Catch/Difficulty/Preprocessing/CatchDifficultyHitObject.cs
+++ b/osu.Game.Rulesets.Catch/Difficulty/Preprocessing/CatchDifficultyHitObject.cs
@@ -25,8 +25,8 @@ namespace osu.Game.Rulesets.Catch.Difficulty.Preprocessing
         /// </summary>
         public readonly double StrainTime;
 
-        public CatchDifficultyHitObject(HitObject hitObject, HitObject lastObject, double clockRate, float halfCatcherWidth, List<DifficultyHitObject> objects, int position)
-            : base(hitObject, lastObject, clockRate, objects, position)
+        public CatchDifficultyHitObject(HitObject hitObject, HitObject lastObject, double clockRate, float halfCatcherWidth, List<DifficultyHitObject> objects, int index)
+            : base(hitObject, lastObject, clockRate, objects, index)
         {
             // We will scale everything by this factor, so we can assume a uniform CircleSize among beatmaps.
             float scalingFactor = normalized_hitobject_radius / halfCatcherWidth;
diff --git a/osu.Game.Rulesets.Mania/Difficulty/Preprocessing/ManiaDifficultyHitObject.cs b/osu.Game.Rulesets.Mania/Difficulty/Preprocessing/ManiaDifficultyHitObject.cs
index 5c9b3b9b54..1c4204145b 100644
--- a/osu.Game.Rulesets.Mania/Difficulty/Preprocessing/ManiaDifficultyHitObject.cs
+++ b/osu.Game.Rulesets.Mania/Difficulty/Preprocessing/ManiaDifficultyHitObject.cs
@@ -12,8 +12,8 @@ namespace osu.Game.Rulesets.Mania.Difficulty.Preprocessing
     {
         public new ManiaHitObject BaseObject => (ManiaHitObject)base.BaseObject;
 
-        public ManiaDifficultyHitObject(HitObject hitObject, HitObject lastObject, double clockRate, List<DifficultyHitObject> objects, int position)
-            : base(hitObject, lastObject, clockRate, objects, position)
+        public ManiaDifficultyHitObject(HitObject hitObject, HitObject lastObject, double clockRate, List<DifficultyHitObject> objects, int index)
+            : base(hitObject, lastObject, clockRate, objects, index)
         {
         }
     }
diff --git a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
index 0400dd0db1..989d407bd0 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
@@ -75,8 +75,8 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
         private readonly OsuHitObject lastLastObject;
         private readonly OsuHitObject lastObject;
 
-        public OsuDifficultyHitObject(HitObject hitObject, HitObject lastObject, double clockRate, List<DifficultyHitObject> objects, int position)
-            : base(hitObject, lastObject, clockRate, objects, position)
+        public OsuDifficultyHitObject(HitObject hitObject, HitObject lastObject, double clockRate, List<DifficultyHitObject> objects, int index)
+            : base(hitObject, lastObject, clockRate, objects, index)
         {
             lastLastObject = (OsuHitObject)Previous(1)?.BaseObject;
             this.lastObject = (OsuHitObject)lastObject;
diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
index e3ec997740..7e0b9b572b 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
@@ -34,7 +34,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
 
         private double strainValueOf(DifficultyHitObject current)
         {
-            if (current.BaseObject is Spinner || current.Position <= 1 || current.Previous(0).BaseObject is Spinner)
+            if (current.BaseObject is Spinner || current.Index <= 1 || current.Previous(0).BaseObject is Spinner)
                 return 0;
 
             var osuCurrObj = (OsuDifficultyHitObject)current;
diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
index 75796a5993..cf0a7d3359 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
@@ -50,7 +50,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
             OsuDifficultyHitObject lastObj = osuCurrent;
 
             // This is iterating backwards in time from the current object.
-            for (int i = 0; i < Math.Min(current.Position, 10); i++)
+            for (int i = 0; i < Math.Min(current.Index, 10); i++)
             {
                 var currentObj = (OsuDifficultyHitObject)current.Previous(i);
                 var currentHitObject = (OsuHitObject)(currentObj.BaseObject);
diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Speed.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Speed.cs
index f8905664f4..232c9526bc 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Speed.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Speed.cs
@@ -53,7 +53,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
 
             bool firstDeltaSwitch = false;
 
-            int historicalNoteCount = Math.Min(current.Position, 32);
+            int historicalNoteCount = Math.Min(current.Index, 32);
 
             int rhythmStart = 0;
 
@@ -136,7 +136,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
 
             // derive strainTime for calculation
             var osuCurrObj = (OsuDifficultyHitObject)current;
-            var osuPrevObj = current.Position > 0 ? (OsuDifficultyHitObject)current.Previous(0) : null;
+            var osuPrevObj = current.Index > 0 ? (OsuDifficultyHitObject)current.Previous(0) : null;
 
             double strainTime = osuCurrObj.StrainTime;
             double greatWindowFull = greatWindow * 2;
diff --git a/osu.Game.Rulesets.Taiko/Difficulty/Preprocessing/TaikoDifficultyHitObject.cs b/osu.Game.Rulesets.Taiko/Difficulty/Preprocessing/TaikoDifficultyHitObject.cs
index 450eb63636..d9049c45ea 100644
--- a/osu.Game.Rulesets.Taiko/Difficulty/Preprocessing/TaikoDifficultyHitObject.cs
+++ b/osu.Game.Rulesets.Taiko/Difficulty/Preprocessing/TaikoDifficultyHitObject.cs
@@ -39,9 +39,9 @@ namespace osu.Game.Rulesets.Taiko.Difficulty.Preprocessing
         /// <param name="lastLastObject">The gameplay <see cref="HitObject"/> preceding <paramref name="lastObject"/>.</param>
         /// <param name="clockRate">The rate of the gameplay clock. Modified by speed-changing mods.</param>
         /// <param name="objects">The list of <see cref="DifficultyHitObject"/>s in the current beatmap.</param>
-        /// /// <param name="position">The position of this <see cref="DifficultyHitObject"/> in the <paramref name="objects"/> list.</param>
-        public TaikoDifficultyHitObject(HitObject hitObject, HitObject lastObject, HitObject lastLastObject, double clockRate, List<DifficultyHitObject> objects, int position)
-            : base(hitObject, lastObject, clockRate, objects, position)
+        /// /// <param name="index">The position of this <see cref="DifficultyHitObject"/> in the <paramref name="objects"/> list.</param>
+        public TaikoDifficultyHitObject(HitObject hitObject, HitObject lastObject, HitObject lastLastObject, double clockRate, List<DifficultyHitObject> objects, int index)
+            : base(hitObject, lastObject, clockRate, objects, index)
         {
             var currentHit = hitObject as Hit;
 
diff --git a/osu.Game.Rulesets.Taiko/Difficulty/Skills/Rhythm.cs b/osu.Game.Rulesets.Taiko/Difficulty/Skills/Rhythm.cs
index 9150b6980b..46b24af903 100644
--- a/osu.Game.Rulesets.Taiko/Difficulty/Skills/Rhythm.cs
+++ b/osu.Game.Rulesets.Taiko/Difficulty/Skills/Rhythm.cs
@@ -106,7 +106,7 @@ namespace osu.Game.Rulesets.Taiko.Difficulty.Skills
                     if (!samePattern(start, mostRecentPatternsToCompare))
                         continue;
 
-                    int notesSince = hitObject.Position - rhythmHistory[start].Position;
+                    int notesSince = hitObject.Index - rhythmHistory[start].Index;
                     penalty *= repetitionPenalty(notesSince);
                     break;
                 }
diff --git a/osu.Game/Rulesets/Difficulty/Preprocessing/DifficultyHitObject.cs b/osu.Game/Rulesets/Difficulty/Preprocessing/DifficultyHitObject.cs
index a886a0d992..5a2a40e241 100644
--- a/osu.Game/Rulesets/Difficulty/Preprocessing/DifficultyHitObject.cs
+++ b/osu.Game/Rulesets/Difficulty/Preprocessing/DifficultyHitObject.cs
@@ -15,9 +15,9 @@ namespace osu.Game.Rulesets.Difficulty.Preprocessing
         private readonly IReadOnlyList<DifficultyHitObject> difficultyHitObjects;
 
         /// <summary>
-        /// The position of this <see cref="DifficultyHitObject"/> in the <see cref="difficultyHitObjects"/> list.
+        /// The index of this <see cref="DifficultyHitObject"/> in the list of all <see cref="DifficultyHitObject"/>s.
         /// </summary>
-        public int Position;
+        public int Index;
 
         /// <summary>
         /// The <see cref="HitObject"/> this <see cref="DifficultyHitObject"/> wraps.
@@ -51,11 +51,11 @@ namespace osu.Game.Rulesets.Difficulty.Preprocessing
         /// <param name="lastObject">The last <see cref="HitObject"/> which occurs before <paramref name="hitObject"/> in the beatmap.</param>
         /// <param name="clockRate">The rate at which the gameplay clock is run at.</param>
         /// <param name="objects">The list of <see cref="DifficultyHitObject"/>s in the current beatmap.</param>
-        /// <param name="position">The position of this <see cref="DifficultyHitObject"/> in the <see cref="difficultyHitObjects"/> list.</param>
-        public DifficultyHitObject(HitObject hitObject, HitObject lastObject, double clockRate, List<DifficultyHitObject> objects, int position)
+        /// <param name="index">The index of this <see cref="DifficultyHitObject"/> in <paramref name="objects"/> list.</param>
+        public DifficultyHitObject(HitObject hitObject, HitObject lastObject, double clockRate, List<DifficultyHitObject> objects, int index)
         {
             difficultyHitObjects = objects;
-            Position = position;
+            Index = index;
             BaseObject = hitObject;
             LastObject = lastObject;
             DeltaTime = (hitObject.StartTime - lastObject.StartTime) / clockRate;
@@ -63,8 +63,8 @@ namespace osu.Game.Rulesets.Difficulty.Preprocessing
             EndTime = hitObject.GetEndTime() / clockRate;
         }
 
-        public DifficultyHitObject Previous(int backwardsIndex) => difficultyHitObjects.ElementAtOrDefault(Position - (backwardsIndex + 1));
+        public DifficultyHitObject Previous(int backwardsIndex) => difficultyHitObjects.ElementAtOrDefault(Index - (backwardsIndex + 1));
 
-        public DifficultyHitObject Next(int forwardsIndex) => difficultyHitObjects.ElementAtOrDefault(Position + (forwardsIndex + 1));
+        public DifficultyHitObject Next(int forwardsIndex) => difficultyHitObjects.ElementAtOrDefault(Index + (forwardsIndex + 1));
     }
 }
diff --git a/osu.Game/Rulesets/Difficulty/Skills/StrainSkill.cs b/osu.Game/Rulesets/Difficulty/Skills/StrainSkill.cs
index 6be10db8b3..0b327046b3 100644
--- a/osu.Game/Rulesets/Difficulty/Skills/StrainSkill.cs
+++ b/osu.Game/Rulesets/Difficulty/Skills/StrainSkill.cs
@@ -47,7 +47,7 @@ namespace osu.Game.Rulesets.Difficulty.Skills
         public sealed override void Process(DifficultyHitObject current)
         {
             // The first object doesn't generate a strain, so we begin with an incremented section end
-            if (current.Position == 0)
+            if (current.Index == 0)
                 currentSectionEnd = Math.Ceiling(current.StartTime / SectionLength) * SectionLength;
 
             while (current.StartTime > currentSectionEnd)

From 70ebfbcf5e9372658a500a8d861dfa5bc22f7e81 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 9 Jun 2022 19:26:24 +0900
Subject: [PATCH 5339/5547] Add recommendation text and adjust weightings to
 read better

---
 .../Screens/Utility/LatencyCertifierScreen.cs   | 17 +++++++++++++----
 1 file changed, 13 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Screens/Utility/LatencyCertifierScreen.cs b/osu.Game/Screens/Utility/LatencyCertifierScreen.cs
index 568e477d8f..2fb673c537 100644
--- a/osu.Game/Screens/Utility/LatencyCertifierScreen.cs
+++ b/osu.Game/Screens/Utility/LatencyCertifierScreen.cs
@@ -213,16 +213,16 @@ Do whatever you need to try and perceive the difference in latency, then choose
 
             if (!isPass && difficultyLevel > 1)
             {
-                statusText.AddParagraph("To complete certification, decrease the difficulty level until you can get 20 tests correct in a row!", cp => cp.Font = OsuFont.Default.With(size: 24));
+                statusText.AddParagraph("To complete certification, decrease the difficulty level until you can get 20 tests correct in a row!", cp => cp.Font = OsuFont.Default.With(size: 24, weight: FontWeight.SemiBold));
                 statusText.AddParagraph(string.Empty);
             }
 
-            statusText.AddParagraph($"Polling: {pollingMax} hz Monitor: {displayMode?.RefreshRate ?? 0:N0} hz Exclusive: {exclusive}", cp => cp.Font = OsuFont.Default.With(size: 15));
+            statusText.AddParagraph($"Polling: {pollingMax} hz Monitor: {displayMode?.RefreshRate ?? 0:N0} hz Exclusive: {exclusive}", cp => cp.Font = OsuFont.Default.With(size: 15, weight: FontWeight.SemiBold));
 
             statusText.AddParagraph($"Input: {host.InputThread.Clock.FramesPerSecond} hz "
                                     + $"Update: {host.UpdateThread.Clock.FramesPerSecond} hz "
                                     + $"Draw: {host.DrawThread.Clock.FramesPerSecond} hz"
-                , cp => cp.Font = OsuFont.Default.With(size: 15));
+                , cp => cp.Font = OsuFont.Default.With(size: 15, weight: FontWeight.SemiBold));
 
             int certificationRemaining = !isPass ? rounds_to_complete_certified : rounds_to_complete_certified - correctCount;
 
@@ -247,11 +247,20 @@ Do whatever you need to try and perceive the difference in latency, then choose
                     }).WithEffect(new GlowEffect
                     {
                         Colour = overlayColourProvider.Colour1,
+                        PadExtent = true
                     }).With(e =>
                     {
                         e.Anchor = Anchor.Centre;
                         e.Origin = Anchor.Centre;
-                    })
+                    }),
+                    new OsuSpriteText
+                    {
+                        Text = $"You should use a frame limiter with update rate of {mapDifficultyToTargetFrameRate(difficultyLevel + 1)} hz (or fps) for best results!",
+                        Anchor = Anchor.Centre,
+                        Origin = Anchor.Centre,
+                        Font = OsuFont.Torus.With(size: 24, weight: FontWeight.SemiBold),
+                        Y = 80,
+                    }
                 });
 
                 background.FadeInFromZero(1000, Easing.OutQuint);

From 3b229624dd2c257b7ccbc85d9b057eb3938a7ed3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 10 Jun 2022 14:02:58 +0900
Subject: [PATCH 5340/5547] Simplify contains check to use LINQ the whole way

---
 osu.Game/Overlays/Music/Playlist.cs | 16 ++--------------
 1 file changed, 2 insertions(+), 14 deletions(-)

diff --git a/osu.Game/Overlays/Music/Playlist.cs b/osu.Game/Overlays/Music/Playlist.cs
index 1d8163b57b..9d31af256f 100644
--- a/osu.Game/Overlays/Music/Playlist.cs
+++ b/osu.Game/Overlays/Music/Playlist.cs
@@ -35,20 +35,8 @@ namespace osu.Game.Overlays.Music
                     item.InSelectedCollection = true;
                 else
                 {
-                    var beatmapHashes = item.Model.Value.Beatmaps.Select(b => b.MD5Hash);
-
-                    bool contained = false;
-
-                    foreach (string hash in beatmapHashes)
-                    {
-                        if (criteria.Collection?.Beatmaps.Contains(hash) == true)
-                        {
-                            contained = true;
-                            break;
-                        }
-                    }
-
-                    item.InSelectedCollection = contained;
+                    item.InSelectedCollection = item.Model.Value.Beatmaps.Select(b => b.MD5Hash)
+                                                    .Any(criteria.Collection.Beatmaps.Contains);
                 }
             }
 

From 4a5e86e451733c7b0fe9fdf7622f0392905be4fb Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 10 Jun 2022 14:03:51 +0900
Subject: [PATCH 5341/5547] Rename `Beatmaps` to `BeatmapHashes` for clarity

---
 .../Collections/IO/ImportCollectionsTest.cs      | 16 ++++++++--------
 .../TestSceneManageCollectionsDialog.cs          |  6 +++---
 .../Visual/SongSelect/TestSceneFilterControl.cs  |  8 ++++----
 osu.Game/Collections/BeatmapCollection.cs        |  4 ++--
 osu.Game/Collections/CollectionFilterDropdown.cs |  6 +++---
 osu.Game/Collections/CollectionManager.cs        | 10 +++++-----
 osu.Game/Collections/DeleteCollectionDialog.cs   |  2 +-
 .../Collections/DrawableCollectionListItem.cs    |  2 +-
 osu.Game/Overlays/Music/Playlist.cs              |  2 +-
 .../Screens/Select/Carousel/CarouselBeatmap.cs   |  2 +-
 .../Select/Carousel/DrawableCarouselBeatmap.cs   |  6 +++---
 .../Carousel/DrawableCarouselBeatmapSet.cs       |  8 ++++----
 12 files changed, 36 insertions(+), 36 deletions(-)

diff --git a/osu.Game.Tests/Collections/IO/ImportCollectionsTest.cs b/osu.Game.Tests/Collections/IO/ImportCollectionsTest.cs
index 73152c33d9..41bc075803 100644
--- a/osu.Game.Tests/Collections/IO/ImportCollectionsTest.cs
+++ b/osu.Game.Tests/Collections/IO/ImportCollectionsTest.cs
@@ -55,10 +55,10 @@ namespace osu.Game.Tests.Collections.IO
                     // and have them associate with collections if/when they become available.
 
                     Assert.That(osu.CollectionManager.Collections[0].Name.Value, Is.EqualTo("First"));
-                    Assert.That(osu.CollectionManager.Collections[0].Beatmaps.Count, Is.EqualTo(1));
+                    Assert.That(osu.CollectionManager.Collections[0].BeatmapHashes.Count, Is.EqualTo(1));
 
                     Assert.That(osu.CollectionManager.Collections[1].Name.Value, Is.EqualTo("Second"));
-                    Assert.That(osu.CollectionManager.Collections[1].Beatmaps.Count, Is.EqualTo(12));
+                    Assert.That(osu.CollectionManager.Collections[1].BeatmapHashes.Count, Is.EqualTo(12));
                 }
                 finally
                 {
@@ -81,10 +81,10 @@ namespace osu.Game.Tests.Collections.IO
                     Assert.That(osu.CollectionManager.Collections.Count, Is.EqualTo(2));
 
                     Assert.That(osu.CollectionManager.Collections[0].Name.Value, Is.EqualTo("First"));
-                    Assert.That(osu.CollectionManager.Collections[0].Beatmaps.Count, Is.EqualTo(1));
+                    Assert.That(osu.CollectionManager.Collections[0].BeatmapHashes.Count, Is.EqualTo(1));
 
                     Assert.That(osu.CollectionManager.Collections[1].Name.Value, Is.EqualTo("Second"));
-                    Assert.That(osu.CollectionManager.Collections[1].Beatmaps.Count, Is.EqualTo(12));
+                    Assert.That(osu.CollectionManager.Collections[1].BeatmapHashes.Count, Is.EqualTo(12));
                 }
                 finally
                 {
@@ -147,8 +147,8 @@ namespace osu.Game.Tests.Collections.IO
                     await importCollectionsFromStream(osu, TestResources.OpenResource("Collections/collections.db"));
 
                     // Move first beatmap from second collection into the first.
-                    osu.CollectionManager.Collections[0].Beatmaps.Add(osu.CollectionManager.Collections[1].Beatmaps[0]);
-                    osu.CollectionManager.Collections[1].Beatmaps.RemoveAt(0);
+                    osu.CollectionManager.Collections[0].BeatmapHashes.Add(osu.CollectionManager.Collections[1].BeatmapHashes[0]);
+                    osu.CollectionManager.Collections[1].BeatmapHashes.RemoveAt(0);
 
                     // Rename the second collecction.
                     osu.CollectionManager.Collections[1].Name.Value = "Another";
@@ -169,10 +169,10 @@ namespace osu.Game.Tests.Collections.IO
                     Assert.That(osu.CollectionManager.Collections.Count, Is.EqualTo(2));
 
                     Assert.That(osu.CollectionManager.Collections[0].Name.Value, Is.EqualTo("First"));
-                    Assert.That(osu.CollectionManager.Collections[0].Beatmaps.Count, Is.EqualTo(2));
+                    Assert.That(osu.CollectionManager.Collections[0].BeatmapHashes.Count, Is.EqualTo(2));
 
                     Assert.That(osu.CollectionManager.Collections[1].Name.Value, Is.EqualTo("Another"));
-                    Assert.That(osu.CollectionManager.Collections[1].Beatmaps.Count, Is.EqualTo(11));
+                    Assert.That(osu.CollectionManager.Collections[1].BeatmapHashes.Count, Is.EqualTo(11));
                 }
                 finally
                 {
diff --git a/osu.Game.Tests/Visual/Collections/TestSceneManageCollectionsDialog.cs b/osu.Game.Tests/Visual/Collections/TestSceneManageCollectionsDialog.cs
index caf3473c45..602c7c84b8 100644
--- a/osu.Game.Tests/Visual/Collections/TestSceneManageCollectionsDialog.cs
+++ b/osu.Game.Tests/Visual/Collections/TestSceneManageCollectionsDialog.cs
@@ -152,7 +152,7 @@ namespace osu.Game.Tests.Visual.Collections
             AddStep("add two collections with same name", () => manager.Collections.AddRange(new[]
             {
                 new BeatmapCollection { Name = { Value = "1" } },
-                new BeatmapCollection { Name = { Value = "1" }, Beatmaps = { beatmapManager.GetAllUsableBeatmapSets().First().Beatmaps[0].MD5Hash } },
+                new BeatmapCollection { Name = { Value = "1" }, BeatmapHashes = { beatmapManager.GetAllUsableBeatmapSets().First().Beatmaps[0].MD5Hash } },
             }));
         }
 
@@ -162,7 +162,7 @@ namespace osu.Game.Tests.Visual.Collections
             AddStep("add two collections", () => manager.Collections.AddRange(new[]
             {
                 new BeatmapCollection { Name = { Value = "1" } },
-                new BeatmapCollection { Name = { Value = "2" }, Beatmaps = { beatmapManager.GetAllUsableBeatmapSets().First().Beatmaps[0].MD5Hash } },
+                new BeatmapCollection { Name = { Value = "2" }, BeatmapHashes = { beatmapManager.GetAllUsableBeatmapSets().First().Beatmaps[0].MD5Hash } },
             }));
 
             assertCollectionCount(2);
@@ -198,7 +198,7 @@ namespace osu.Game.Tests.Visual.Collections
         {
             AddStep("add two collections", () => manager.Collections.AddRange(new[]
             {
-                new BeatmapCollection { Name = { Value = "1" }, Beatmaps = { beatmapManager.GetAllUsableBeatmapSets().First().Beatmaps[0].MD5Hash } },
+                new BeatmapCollection { Name = { Value = "1" }, BeatmapHashes = { beatmapManager.GetAllUsableBeatmapSets().First().Beatmaps[0].MD5Hash } },
             }));
 
             assertCollectionCount(1);
diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneFilterControl.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneFilterControl.cs
index db49ec06f8..b42ce3ff87 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneFilterControl.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneFilterControl.cs
@@ -151,10 +151,10 @@ namespace osu.Game.Tests.Visual.SongSelect
             AddStep("add collection", () => collectionManager.Collections.Add(new BeatmapCollection { Name = { Value = "1" } }));
             AddAssert("button is plus", () => getAddOrRemoveButton(1).Icon.Equals(FontAwesome.Solid.PlusSquare));
 
-            AddStep("add beatmap to collection", () => collectionManager.Collections[0].Beatmaps.Add(Beatmap.Value.BeatmapInfo.MD5Hash));
+            AddStep("add beatmap to collection", () => collectionManager.Collections[0].BeatmapHashes.Add(Beatmap.Value.BeatmapInfo.MD5Hash));
             AddAssert("button is minus", () => getAddOrRemoveButton(1).Icon.Equals(FontAwesome.Solid.MinusSquare));
 
-            AddStep("remove beatmap from collection", () => collectionManager.Collections[0].Beatmaps.Clear());
+            AddStep("remove beatmap from collection", () => collectionManager.Collections[0].BeatmapHashes.Clear());
             AddAssert("button is plus", () => getAddOrRemoveButton(1).Icon.Equals(FontAwesome.Solid.PlusSquare));
         }
 
@@ -169,11 +169,11 @@ namespace osu.Game.Tests.Visual.SongSelect
             AddAssert("button is plus", () => getAddOrRemoveButton(1).Icon.Equals(FontAwesome.Solid.PlusSquare));
 
             addClickAddOrRemoveButtonStep(1);
-            AddAssert("collection contains beatmap", () => collectionManager.Collections[0].Beatmaps.Contains(Beatmap.Value.BeatmapInfo.MD5Hash));
+            AddAssert("collection contains beatmap", () => collectionManager.Collections[0].BeatmapHashes.Contains(Beatmap.Value.BeatmapInfo.MD5Hash));
             AddAssert("button is minus", () => getAddOrRemoveButton(1).Icon.Equals(FontAwesome.Solid.MinusSquare));
 
             addClickAddOrRemoveButtonStep(1);
-            AddAssert("collection does not contain beatmap", () => !collectionManager.Collections[0].Beatmaps.Contains(Beatmap.Value.BeatmapInfo.MD5Hash));
+            AddAssert("collection does not contain beatmap", () => !collectionManager.Collections[0].BeatmapHashes.Contains(Beatmap.Value.BeatmapInfo.MD5Hash));
             AddAssert("button is plus", () => getAddOrRemoveButton(1).Icon.Equals(FontAwesome.Solid.PlusSquare));
         }
 
diff --git a/osu.Game/Collections/BeatmapCollection.cs b/osu.Game/Collections/BeatmapCollection.cs
index ca0f57f638..cf95c74b46 100644
--- a/osu.Game/Collections/BeatmapCollection.cs
+++ b/osu.Game/Collections/BeatmapCollection.cs
@@ -25,7 +25,7 @@ namespace osu.Game.Collections
         /// <summary>
         /// The <see cref="BeatmapInfo.MD5Hash"/>es of beatmaps contained by the collection.
         /// </summary>
-        public readonly BindableList<string> Beatmaps = new BindableList<string>();
+        public readonly BindableList<string> BeatmapHashes = new BindableList<string>();
 
         /// <summary>
         /// The date when this collection was last modified.
@@ -34,7 +34,7 @@ namespace osu.Game.Collections
 
         public BeatmapCollection()
         {
-            Beatmaps.CollectionChanged += (_, __) => onChange();
+            BeatmapHashes.CollectionChanged += (_, __) => onChange();
             Name.ValueChanged += _ => onChange();
         }
 
diff --git a/osu.Game/Collections/CollectionFilterDropdown.cs b/osu.Game/Collections/CollectionFilterDropdown.cs
index 97e5711d75..100074d186 100644
--- a/osu.Game/Collections/CollectionFilterDropdown.cs
+++ b/osu.Game/Collections/CollectionFilterDropdown.cs
@@ -95,10 +95,10 @@ namespace osu.Game.Collections
             beatmaps.CollectionChanged -= filterBeatmapsChanged;
 
             if (filter.OldValue?.Collection != null)
-                beatmaps.UnbindFrom(filter.OldValue.Collection.Beatmaps);
+                beatmaps.UnbindFrom(filter.OldValue.Collection.BeatmapHashes);
 
             if (filter.NewValue?.Collection != null)
-                beatmaps.BindTo(filter.NewValue.Collection.Beatmaps);
+                beatmaps.BindTo(filter.NewValue.Collection.BeatmapHashes);
 
             beatmaps.CollectionChanged += filterBeatmapsChanged;
 
@@ -208,7 +208,7 @@ namespace osu.Game.Collections
             public CollectionDropdownMenuItem(MenuItem item)
                 : base(item)
             {
-                collectionBeatmaps = Item.Collection?.Beatmaps.GetBoundCopy();
+                collectionBeatmaps = Item.Collection?.BeatmapHashes.GetBoundCopy();
                 collectionName = Item.CollectionName.GetBoundCopy();
             }
 
diff --git a/osu.Game/Collections/CollectionManager.cs b/osu.Game/Collections/CollectionManager.cs
index 30171a71af..104ec4beb2 100644
--- a/osu.Game/Collections/CollectionManager.cs
+++ b/osu.Game/Collections/CollectionManager.cs
@@ -169,10 +169,10 @@ namespace osu.Game.Collections
                         if (existing == null)
                             Collections.Add(existing = new BeatmapCollection { Name = { Value = newCol.Name.Value } });
 
-                        foreach (string newBeatmap in newCol.Beatmaps)
+                        foreach (string newBeatmap in newCol.BeatmapHashes)
                         {
-                            if (!existing.Beatmaps.Contains(newBeatmap))
-                                existing.Beatmaps.Add(newBeatmap);
+                            if (!existing.BeatmapHashes.Contains(newBeatmap))
+                                existing.BeatmapHashes.Add(newBeatmap);
                         }
                     }
 
@@ -222,7 +222,7 @@ namespace osu.Game.Collections
 
                             string checksum = sr.ReadString();
 
-                            collection.Beatmaps.Add(checksum);
+                            collection.BeatmapHashes.Add(checksum);
                         }
 
                         if (notification != null)
@@ -293,7 +293,7 @@ namespace osu.Game.Collections
                             {
                                 sw.Write(c.Name.Value);
 
-                                string[] beatmapsCopy = c.Beatmaps.ToArray();
+                                string[] beatmapsCopy = c.BeatmapHashes.ToArray();
 
                                 sw.Write(beatmapsCopy.Length);
 
diff --git a/osu.Game/Collections/DeleteCollectionDialog.cs b/osu.Game/Collections/DeleteCollectionDialog.cs
index e5a2f6fb81..e59adb14a6 100644
--- a/osu.Game/Collections/DeleteCollectionDialog.cs
+++ b/osu.Game/Collections/DeleteCollectionDialog.cs
@@ -13,7 +13,7 @@ namespace osu.Game.Collections
         public DeleteCollectionDialog(BeatmapCollection collection, Action deleteAction)
         {
             HeaderText = "Confirm deletion of";
-            BodyText = $"{collection.Name.Value} ({"beatmap".ToQuantity(collection.Beatmaps.Count)})";
+            BodyText = $"{collection.Name.Value} ({"beatmap".ToQuantity(collection.BeatmapHashes.Count)})";
 
             Icon = FontAwesome.Regular.TrashAlt;
 
diff --git a/osu.Game/Collections/DrawableCollectionListItem.cs b/osu.Game/Collections/DrawableCollectionListItem.cs
index 5a20b7e7bd..5064041737 100644
--- a/osu.Game/Collections/DrawableCollectionListItem.cs
+++ b/osu.Game/Collections/DrawableCollectionListItem.cs
@@ -225,7 +225,7 @@ namespace osu.Game.Collections
             {
                 background.FlashColour(Color4.White, 150);
 
-                if (collection.Beatmaps.Count == 0)
+                if (collection.BeatmapHashes.Count == 0)
                     deleteCollection();
                 else
                     dialogOverlay?.Push(new DeleteCollectionDialog(collection, deleteCollection));
diff --git a/osu.Game/Overlays/Music/Playlist.cs b/osu.Game/Overlays/Music/Playlist.cs
index 9d31af256f..ff8f3197f9 100644
--- a/osu.Game/Overlays/Music/Playlist.cs
+++ b/osu.Game/Overlays/Music/Playlist.cs
@@ -36,7 +36,7 @@ namespace osu.Game.Overlays.Music
                 else
                 {
                     item.InSelectedCollection = item.Model.Value.Beatmaps.Select(b => b.MD5Hash)
-                                                    .Any(criteria.Collection.Beatmaps.Contains);
+                                                    .Any(criteria.Collection.BeatmapHashes.Contains);
                 }
             }
 
diff --git a/osu.Game/Screens/Select/Carousel/CarouselBeatmap.cs b/osu.Game/Screens/Select/Carousel/CarouselBeatmap.cs
index de9899f288..c3f6b3ad83 100644
--- a/osu.Game/Screens/Select/Carousel/CarouselBeatmap.cs
+++ b/osu.Game/Screens/Select/Carousel/CarouselBeatmap.cs
@@ -72,7 +72,7 @@ namespace osu.Game.Screens.Select.Carousel
             }
 
             if (match)
-                match &= criteria.Collection?.Beatmaps.Contains(BeatmapInfo.MD5Hash) ?? true;
+                match &= criteria.Collection?.BeatmapHashes.Contains(BeatmapInfo.MD5Hash) ?? true;
 
             if (match && criteria.RulesetCriteria != null)
                 match &= criteria.RulesetCriteria.Matches(BeatmapInfo);
diff --git a/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmap.cs b/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmap.cs
index 79d27e9d9d..065a29b53c 100644
--- a/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmap.cs
+++ b/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmap.cs
@@ -256,12 +256,12 @@ namespace osu.Game.Screens.Select.Carousel
             return new ToggleMenuItem(collection.Name.Value, MenuItemType.Standard, s =>
             {
                 if (s)
-                    collection.Beatmaps.Add(beatmapInfo.MD5Hash);
+                    collection.BeatmapHashes.Add(beatmapInfo.MD5Hash);
                 else
-                    collection.Beatmaps.Remove(beatmapInfo.MD5Hash);
+                    collection.BeatmapHashes.Remove(beatmapInfo.MD5Hash);
             })
             {
-                State = { Value = collection.Beatmaps.Contains(beatmapInfo.MD5Hash) }
+                State = { Value = collection.BeatmapHashes.Contains(beatmapInfo.MD5Hash) }
             };
         }
 
diff --git a/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmapSet.cs b/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmapSet.cs
index ade89c5b35..80f1231454 100644
--- a/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmapSet.cs
+++ b/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmapSet.cs
@@ -245,7 +245,7 @@ namespace osu.Game.Screens.Select.Carousel
 
             TernaryState state;
 
-            int countExisting = beatmapSet.Beatmaps.Count(b => collection.Beatmaps.Contains(b.MD5Hash));
+            int countExisting = beatmapSet.Beatmaps.Count(b => collection.BeatmapHashes.Contains(b.MD5Hash));
 
             if (countExisting == beatmapSet.Beatmaps.Count)
                 state = TernaryState.True;
@@ -261,14 +261,14 @@ namespace osu.Game.Screens.Select.Carousel
                     switch (s)
                     {
                         case TernaryState.True:
-                            if (collection.Beatmaps.Contains(b.MD5Hash))
+                            if (collection.BeatmapHashes.Contains(b.MD5Hash))
                                 continue;
 
-                            collection.Beatmaps.Add(b.MD5Hash);
+                            collection.BeatmapHashes.Add(b.MD5Hash);
                             break;
 
                         case TernaryState.False:
-                            collection.Beatmaps.Remove(b.MD5Hash);
+                            collection.BeatmapHashes.Remove(b.MD5Hash);
                             break;
                     }
                 }

From c625c929e5974f0b544758eb72a422a4cbf2def2 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 10 Jun 2022 14:16:56 +0900
Subject: [PATCH 5342/5547] Update button text to match new terminology

---
 .../Overlays/Settings/Sections/DebugSettings/GeneralSettings.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/Settings/Sections/DebugSettings/GeneralSettings.cs b/osu.Game/Overlays/Settings/Sections/DebugSettings/GeneralSettings.cs
index cd8cf8f64f..2b845e9d6b 100644
--- a/osu.Game/Overlays/Settings/Sections/DebugSettings/GeneralSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/DebugSettings/GeneralSettings.cs
@@ -39,7 +39,7 @@ namespace osu.Game.Overlays.Settings.Sections.DebugSettings
                 },
                 new SettingsButton
                 {
-                    Text = @"Run latency comparer",
+                    Text = @"Run latency certifier",
                     Action = () => performer?.PerformFromScreen(menu => menu.Push(new LatencyCertifierScreen()))
                 }
             };

From 613814c26cbec49a6c8b2952864c560b1a0dd49a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 10 Jun 2022 14:18:35 +0900
Subject: [PATCH 5343/5547] Make `TargetFrameRate` nullable

---
 osu.Game/Screens/Utility/LatencyArea.cs            | 7 ++++---
 osu.Game/Screens/Utility/LatencyCertifierScreen.cs | 4 ++--
 2 files changed, 6 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Screens/Utility/LatencyArea.cs b/osu.Game/Screens/Utility/LatencyArea.cs
index a82efa1e26..a2991d3fa8 100644
--- a/osu.Game/Screens/Utility/LatencyArea.cs
+++ b/osu.Game/Screens/Utility/LatencyArea.cs
@@ -2,6 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 #nullable enable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
@@ -27,11 +28,11 @@ namespace osu.Game.Screens.Utility
 
         private readonly Key key;
 
-        public readonly int TargetFrameRate;
+        public readonly int? TargetFrameRate;
 
         public readonly BindableBool IsActiveArea = new BindableBool();
 
-        public LatencyArea(Key key, int targetFrameRate)
+        public LatencyArea(Key key, int? targetFrameRate)
         {
             this.key = key;
             TargetFrameRate = targetFrameRate;
@@ -94,7 +95,7 @@ namespace osu.Game.Screens.Utility
         public override bool UpdateSubTree()
         {
             double elapsed = Clock.CurrentTime - lastFrameTime;
-            if (TargetFrameRate > 0 && elapsed < 1000.0 / TargetFrameRate)
+            if (TargetFrameRate.HasValue && elapsed < 1000.0 / TargetFrameRate)
                 return false;
 
             lastFrameTime = Clock.CurrentTime;
diff --git a/osu.Game/Screens/Utility/LatencyCertifierScreen.cs b/osu.Game/Screens/Utility/LatencyCertifierScreen.cs
index 2fb673c537..a5ed573d88 100644
--- a/osu.Game/Screens/Utility/LatencyCertifierScreen.cs
+++ b/osu.Game/Screens/Utility/LatencyCertifierScreen.cs
@@ -358,13 +358,13 @@ Do whatever you need to try and perceive the difference in latency, then choose
 
             mainArea.AddRange(new[]
             {
-                new LatencyArea(Key.Number1, betterSide == 1 ? mapDifficultyToTargetFrameRate(difficultyLevel) : 0)
+                new LatencyArea(Key.Number1, betterSide == 1 ? mapDifficultyToTargetFrameRate(difficultyLevel) : (int?)null)
                 {
                     Width = 0.5f,
                     IsActiveArea = { Value = true },
                     ReportUserBest = () => recordResult(betterSide == 0),
                 },
-                new LatencyArea(Key.Number2, betterSide == 0 ? mapDifficultyToTargetFrameRate(difficultyLevel) : 0)
+                new LatencyArea(Key.Number2, betterSide == 0 ? mapDifficultyToTargetFrameRate(difficultyLevel) : (int?)null)
                 {
                     Width = 0.5f,
                     Anchor = Anchor.TopRight,

From 69b856bd58d37f18433ae95363d5416c5581c7e3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 10 Jun 2022 14:23:24 +0900
Subject: [PATCH 5344/5547] Rename rounds variables to hopefully read better

---
 .../Screens/Utility/LatencyCertifierScreen.cs | 35 ++++++++++---------
 1 file changed, 19 insertions(+), 16 deletions(-)

diff --git a/osu.Game/Screens/Utility/LatencyCertifierScreen.cs b/osu.Game/Screens/Utility/LatencyCertifierScreen.cs
index a5ed573d88..2602238820 100644
--- a/osu.Game/Screens/Utility/LatencyCertifierScreen.cs
+++ b/osu.Game/Screens/Utility/LatencyCertifierScreen.cs
@@ -66,9 +66,9 @@ namespace osu.Game.Screens.Utility
 
         private const int rounds_to_complete_certified = 20;
 
-        private int round;
-        private int correctCount;
-        private int targetRoundCount = rounds_to_complete;
+        private int attemptsAtCurrentDifficulty;
+        private int correctAtCurrentDifficulty;
+        private int totalRoundForNextResultsScreen = rounds_to_complete;
 
         private int difficultyLevel = 1;
 
@@ -199,10 +199,10 @@ Do whatever you need to try and perceive the difference in latency, then choose
 
             statusText.Clear();
 
-            float successRate = (float)correctCount / targetRoundCount;
+            float successRate = (float)correctAtCurrentDifficulty / totalRoundForNextResultsScreen;
             bool isPass = successRate == 1;
 
-            statusText.AddParagraph($"You scored {correctCount} out of {targetRoundCount} ({successRate:0%})!", cp => cp.Colour = isPass ? colours.Green : colours.Red);
+            statusText.AddParagraph($"You scored {correctAtCurrentDifficulty} out of {totalRoundForNextResultsScreen} ({successRate:0%})!", cp => cp.Colour = isPass ? colours.Green : colours.Red);
             statusText.AddParagraph($"Level {difficultyLevel} ({mapDifficultyToTargetFrameRate(difficultyLevel):N0} hz)",
                 cp => cp.Font = OsuFont.Default.With(size: 24));
 
@@ -213,18 +213,20 @@ Do whatever you need to try and perceive the difference in latency, then choose
 
             if (!isPass && difficultyLevel > 1)
             {
-                statusText.AddParagraph("To complete certification, decrease the difficulty level until you can get 20 tests correct in a row!", cp => cp.Font = OsuFont.Default.With(size: 24, weight: FontWeight.SemiBold));
+                statusText.AddParagraph("To complete certification, decrease the difficulty level until you can get 20 tests correct in a row!",
+                    cp => cp.Font = OsuFont.Default.With(size: 24, weight: FontWeight.SemiBold));
                 statusText.AddParagraph(string.Empty);
             }
 
-            statusText.AddParagraph($"Polling: {pollingMax} hz Monitor: {displayMode?.RefreshRate ?? 0:N0} hz Exclusive: {exclusive}", cp => cp.Font = OsuFont.Default.With(size: 15, weight: FontWeight.SemiBold));
+            statusText.AddParagraph($"Polling: {pollingMax} hz Monitor: {displayMode?.RefreshRate ?? 0:N0} hz Exclusive: {exclusive}",
+                cp => cp.Font = OsuFont.Default.With(size: 15, weight: FontWeight.SemiBold));
 
             statusText.AddParagraph($"Input: {host.InputThread.Clock.FramesPerSecond} hz "
                                     + $"Update: {host.UpdateThread.Clock.FramesPerSecond} hz "
                                     + $"Draw: {host.DrawThread.Clock.FramesPerSecond} hz"
                 , cp => cp.Font = OsuFont.Default.With(size: 15, weight: FontWeight.SemiBold));
 
-            int certificationRemaining = !isPass ? rounds_to_complete_certified : rounds_to_complete_certified - correctCount;
+            int certificationRemaining = !isPass ? rounds_to_complete_certified : rounds_to_complete_certified - correctAtCurrentDifficulty;
 
             if (isPass && certificationRemaining <= 0)
             {
@@ -320,7 +322,7 @@ Do whatever you need to try and perceive the difference in latency, then choose
                         Action = () =>
                         {
                             resultsArea.Clear();
-                            targetRoundCount += rounds_to_complete;
+                            totalRoundForNextResultsScreen += rounds_to_complete;
                             loadNextRound();
                         },
                         TooltipText = isPass ? $"Chain {rounds_to_complete_certified} to confirm your perception!" : "You've reached your limits. Go to the previous level to complete certification!",
@@ -336,12 +338,13 @@ Do whatever you need to try and perceive the difference in latency, then choose
 
             resultsArea.Clear();
 
-            correctCount = 0;
-            round = 0;
+            correctAtCurrentDifficulty = 0;
+            attemptsAtCurrentDifficulty = 0;
+
             pollingMax = 0;
             lastPoll = 0;
 
-            targetRoundCount = rounds_to_complete;
+            totalRoundForNextResultsScreen = rounds_to_complete;
             difficultyLevel = difficulty;
 
             loadNextRound();
@@ -349,8 +352,8 @@ Do whatever you need to try and perceive the difference in latency, then choose
 
         private void loadNextRound()
         {
-            round++;
-            statusText.Text = $"Level {difficultyLevel}\nRound {round} of {targetRoundCount}";
+            attemptsAtCurrentDifficulty++;
+            statusText.Text = $"Level {difficultyLevel}\nRound {attemptsAtCurrentDifficulty} of {totalRoundForNextResultsScreen}";
 
             mainArea.Clear();
 
@@ -389,9 +392,9 @@ Do whatever you need to try and perceive the difference in latency, then choose
             explanatoryText.FadeOut(500, Easing.OutQuint);
 
             if (correct)
-                correctCount++;
+                correctAtCurrentDifficulty++;
 
-            if (round < targetRoundCount)
+            if (attemptsAtCurrentDifficulty < totalRoundForNextResultsScreen)
                 loadNextRound();
             else
                 showResults();

From 5b8bd24140e08e468e751e5746c65b2349cf2603 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 10 Jun 2022 14:25:15 +0900
Subject: [PATCH 5345/5547] Simplify text when reaching maximum supported level
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/Screens/Utility/LatencyCertifierScreen.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Utility/LatencyCertifierScreen.cs b/osu.Game/Screens/Utility/LatencyCertifierScreen.cs
index 2602238820..678a2855a7 100644
--- a/osu.Game/Screens/Utility/LatencyCertifierScreen.cs
+++ b/osu.Game/Screens/Utility/LatencyCertifierScreen.cs
@@ -282,7 +282,7 @@ Do whatever you need to try and perceive the difference in latency, then choose
             if (!isPass)
                 cannotIncreaseReason = "You didn't get a perfect score.";
             else if (mapDifficultyToTargetFrameRate(difficultyLevel + 1) > target_host_update_frames)
-                cannotIncreaseReason = "You've reached the limits of this comparison mode.";
+                cannotIncreaseReason = "You've reached the maximum level.";
             else if (mapDifficultyToTargetFrameRate(difficultyLevel + 1) > Clock.FramesPerSecond)
                 cannotIncreaseReason = "Game is not running fast enough to test this level";
 

From f71343c880294fa905bd728fe288ea8db5fff0fa Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 10 Jun 2022 14:28:46 +0900
Subject: [PATCH 5346/5547] Fix box colour getting stuck when changing active
 mode

---
 osu.Game/Screens/Utility/LatencyArea.cs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Game/Screens/Utility/LatencyArea.cs b/osu.Game/Screens/Utility/LatencyArea.cs
index a2991d3fa8..2ef48bb571 100644
--- a/osu.Game/Screens/Utility/LatencyArea.cs
+++ b/osu.Game/Screens/Utility/LatencyArea.cs
@@ -145,6 +145,7 @@ namespace osu.Game.Screens.Utility
                 if (!isActive.Value)
                 {
                     lastFrameTime = null;
+                    box.Colour = overlayColourProvider.Colour1;
                     return;
                 }
 

From eb16de9c718b7374753ba5f8ab55a273f7d40af7 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 10 Jun 2022 14:38:04 +0900
Subject: [PATCH 5347/5547] Use upper-case "Hz"

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

diff --git a/osu.Game/Screens/Utility/LatencyCertifierScreen.cs b/osu.Game/Screens/Utility/LatencyCertifierScreen.cs
index 678a2855a7..41952faf25 100644
--- a/osu.Game/Screens/Utility/LatencyCertifierScreen.cs
+++ b/osu.Game/Screens/Utility/LatencyCertifierScreen.cs
@@ -203,7 +203,7 @@ Do whatever you need to try and perceive the difference in latency, then choose
             bool isPass = successRate == 1;
 
             statusText.AddParagraph($"You scored {correctAtCurrentDifficulty} out of {totalRoundForNextResultsScreen} ({successRate:0%})!", cp => cp.Colour = isPass ? colours.Green : colours.Red);
-            statusText.AddParagraph($"Level {difficultyLevel} ({mapDifficultyToTargetFrameRate(difficultyLevel):N0} hz)",
+            statusText.AddParagraph($"Level {difficultyLevel} ({mapDifficultyToTargetFrameRate(difficultyLevel):N0} Hz)",
                 cp => cp.Font = OsuFont.Default.With(size: 24));
 
             statusText.AddParagraph(string.Empty);
@@ -218,12 +218,12 @@ Do whatever you need to try and perceive the difference in latency, then choose
                 statusText.AddParagraph(string.Empty);
             }
 
-            statusText.AddParagraph($"Polling: {pollingMax} hz Monitor: {displayMode?.RefreshRate ?? 0:N0} hz Exclusive: {exclusive}",
+            statusText.AddParagraph($"Polling: {pollingMax} Hz Monitor: {displayMode?.RefreshRate ?? 0:N0} Hz Exclusive: {exclusive}",
                 cp => cp.Font = OsuFont.Default.With(size: 15, weight: FontWeight.SemiBold));
 
-            statusText.AddParagraph($"Input: {host.InputThread.Clock.FramesPerSecond} hz "
-                                    + $"Update: {host.UpdateThread.Clock.FramesPerSecond} hz "
-                                    + $"Draw: {host.DrawThread.Clock.FramesPerSecond} hz"
+            statusText.AddParagraph($"Input: {host.InputThread.Clock.FramesPerSecond} Hz "
+                                    + $"Update: {host.UpdateThread.Clock.FramesPerSecond} Hz "
+                                    + $"Draw: {host.DrawThread.Clock.FramesPerSecond} Hz"
                 , cp => cp.Font = OsuFont.Default.With(size: 15, weight: FontWeight.SemiBold));
 
             int certificationRemaining = !isPass ? rounds_to_complete_certified : rounds_to_complete_certified - correctAtCurrentDifficulty;
@@ -257,7 +257,7 @@ Do whatever you need to try and perceive the difference in latency, then choose
                     }),
                     new OsuSpriteText
                     {
-                        Text = $"You should use a frame limiter with update rate of {mapDifficultyToTargetFrameRate(difficultyLevel + 1)} hz (or fps) for best results!",
+                        Text = $"You should use a frame limiter with update rate of {mapDifficultyToTargetFrameRate(difficultyLevel + 1)} Hz (or fps) for best results!",
                         Anchor = Anchor.Centre,
                         Origin = Anchor.Centre,
                         Font = OsuFont.Torus.With(size: 24, weight: FontWeight.SemiBold),

From 7d8601090336f41df99676b0b8fc79e35be20225 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 10 Jun 2022 14:41:22 +0900
Subject: [PATCH 5348/5547] Fix test regression

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

diff --git a/osu.Game.Tests/Visual/Settings/TestSceneLatencyCertifierScreen.cs b/osu.Game.Tests/Visual/Settings/TestSceneLatencyCertifierScreen.cs
index 6d8c6d3c54..dd287c4f6a 100644
--- a/osu.Game.Tests/Visual/Settings/TestSceneLatencyCertifierScreen.cs
+++ b/osu.Game.Tests/Visual/Settings/TestSceneLatencyCertifierScreen.cs
@@ -44,7 +44,7 @@ namespace osu.Game.Tests.Visual.Settings
             {
                 var latencyArea = latencyCertifier
                                   .ChildrenOfType<LatencyArea>()
-                                  .SingleOrDefault(a => a.TargetFrameRate == 0);
+                                  .SingleOrDefault(a => a.TargetFrameRate == null);
 
                 // reached results
                 if (latencyArea == null)

From 5541ebc76b438d0caa56060a73b9e3078b743258 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 10 Jun 2022 15:02:26 +0900
Subject: [PATCH 5349/5547] Revert `OsuButton` changes

---
 osu.Game/Graphics/UserInterface/OsuButton.cs  | 2 +-
 osu.Game/Screens/Utility/ButtonWithKeyBind.cs | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Graphics/UserInterface/OsuButton.cs b/osu.Game/Graphics/UserInterface/OsuButton.cs
index 044df13152..08514d94c3 100644
--- a/osu.Game/Graphics/UserInterface/OsuButton.cs
+++ b/osu.Game/Graphics/UserInterface/OsuButton.cs
@@ -20,7 +20,7 @@ namespace osu.Game.Graphics.UserInterface
     /// </summary>
     public class OsuButton : Button
     {
-        public virtual LocalisableString Text
+        public LocalisableString Text
         {
             get => SpriteText?.Text ?? default;
             set
diff --git a/osu.Game/Screens/Utility/ButtonWithKeyBind.cs b/osu.Game/Screens/Utility/ButtonWithKeyBind.cs
index 20e39ffa6a..ef87e0bca7 100644
--- a/osu.Game/Screens/Utility/ButtonWithKeyBind.cs
+++ b/osu.Game/Screens/Utility/ButtonWithKeyBind.cs
@@ -21,7 +21,7 @@ namespace osu.Game.Screens.Utility
             this.key = key;
         }
 
-        public override LocalisableString Text
+        public new LocalisableString Text
         {
             get => base.Text;
             set => base.Text = $"{value} (Press {key.ToString().Replace("Number", string.Empty)})";

From e0644f27262daa99187180a74211cfe8dcbf42be Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 10 Jun 2022 15:19:10 +0900
Subject: [PATCH 5350/5547] Simplify flow of progression to be linear

---
 .../TestSceneLatencyCertifierScreen.cs        |  34 ++-
 .../Screens/Utility/LatencyCertifierScreen.cs | 204 ++++++++++--------
 2 files changed, 142 insertions(+), 96 deletions(-)

diff --git a/osu.Game.Tests/Visual/Settings/TestSceneLatencyCertifierScreen.cs b/osu.Game.Tests/Visual/Settings/TestSceneLatencyCertifierScreen.cs
index dd287c4f6a..81faf31c69 100644
--- a/osu.Game.Tests/Visual/Settings/TestSceneLatencyCertifierScreen.cs
+++ b/osu.Game.Tests/Visual/Settings/TestSceneLatencyCertifierScreen.cs
@@ -29,22 +29,46 @@ namespace osu.Game.Tests.Visual.Settings
         {
             for (int i = 0; i < 4; i++)
             {
-                clickCorrectUntilResults();
-                AddAssert("check at results", () => !latencyCertifier.ChildrenOfType<LatencyArea>().Any());
-                AddStep("hit c to continue", () => InputManager.Key(Key.C));
+                int difficulty = i + 1;
+
+                checkDifficulty(difficulty);
+                clickUntilResults(true);
+                continueFromResults();
             }
 
+            checkDifficulty(5);
+            clickUntilResults(false);
+            continueFromResults();
+            checkDifficulty(4);
+
+            clickUntilResults(false);
+            continueFromResults();
+            checkDifficulty(3);
+
+            clickUntilResults(true);
             AddAssert("check at results", () => !latencyCertifier.ChildrenOfType<LatencyArea>().Any());
             AddAssert("check no buttons", () => !latencyCertifier.ChildrenOfType<OsuButton>().Any());
+            checkDifficulty(3);
         }
 
-        private void clickCorrectUntilResults()
+        private void continueFromResults()
+        {
+            AddAssert("check at results", () => !latencyCertifier.ChildrenOfType<LatencyArea>().Any());
+            AddStep("hit enter to continue", () => InputManager.Key(Key.Enter));
+        }
+
+        private void checkDifficulty(int difficulty)
+        {
+            AddAssert($"difficulty is {difficulty}", () => latencyCertifier.DifficultyLevel == difficulty);
+        }
+
+        private void clickUntilResults(bool clickCorrect)
         {
             AddUntilStep("click correct button until results", () =>
             {
                 var latencyArea = latencyCertifier
                                   .ChildrenOfType<LatencyArea>()
-                                  .SingleOrDefault(a => a.TargetFrameRate == null);
+                                  .SingleOrDefault(a => clickCorrect ? a.TargetFrameRate == null : a.TargetFrameRate != null);
 
                 // reached results
                 if (latencyArea == null)
diff --git a/osu.Game/Screens/Utility/LatencyCertifierScreen.cs b/osu.Game/Screens/Utility/LatencyCertifierScreen.cs
index 41952faf25..0a9d98450f 100644
--- a/osu.Game/Screens/Utility/LatencyCertifierScreen.cs
+++ b/osu.Game/Screens/Utility/LatencyCertifierScreen.cs
@@ -66,11 +66,17 @@ namespace osu.Game.Screens.Utility
 
         private const int rounds_to_complete_certified = 20;
 
+        /// <summary>
+        /// Whether we are now in certification mode and decreasing difficulty.
+        /// </summary>
+        private bool isCertifying;
+
+        private int totalRoundForNextResultsScreen => isCertifying ? rounds_to_complete_certified : rounds_to_complete;
+
         private int attemptsAtCurrentDifficulty;
         private int correctAtCurrentDifficulty;
-        private int totalRoundForNextResultsScreen = rounds_to_complete;
 
-        private int difficultyLevel = 1;
+        public int DifficultyLevel { get; private set; } = 1;
 
         private double lastPoll;
         private int pollingMax;
@@ -199,11 +205,11 @@ Do whatever you need to try and perceive the difference in latency, then choose
 
             statusText.Clear();
 
-            float successRate = (float)correctAtCurrentDifficulty / totalRoundForNextResultsScreen;
+            float successRate = (float)correctAtCurrentDifficulty / attemptsAtCurrentDifficulty;
             bool isPass = successRate == 1;
 
-            statusText.AddParagraph($"You scored {correctAtCurrentDifficulty} out of {totalRoundForNextResultsScreen} ({successRate:0%})!", cp => cp.Colour = isPass ? colours.Green : colours.Red);
-            statusText.AddParagraph($"Level {difficultyLevel} ({mapDifficultyToTargetFrameRate(difficultyLevel):N0} Hz)",
+            statusText.AddParagraph($"You scored {correctAtCurrentDifficulty} out of {attemptsAtCurrentDifficulty} ({successRate:0%})!", cp => cp.Colour = isPass ? colours.Green : colours.Red);
+            statusText.AddParagraph($"Level {DifficultyLevel} ({mapDifficultyToTargetFrameRate(DifficultyLevel):N0} Hz)",
                 cp => cp.Font = OsuFont.Default.With(size: 24));
 
             statusText.AddParagraph(string.Empty);
@@ -211,9 +217,9 @@ Do whatever you need to try and perceive the difference in latency, then choose
             statusText.AddIcon(isPass ? FontAwesome.Regular.CheckCircle : FontAwesome.Regular.TimesCircle, cp => cp.Colour = isPass ? colours.Green : colours.Red);
             statusText.AddParagraph(string.Empty);
 
-            if (!isPass && difficultyLevel > 1)
+            if (!isPass && DifficultyLevel > 1)
             {
-                statusText.AddParagraph("To complete certification, decrease the difficulty level until you can get 20 tests correct in a row!",
+                statusText.AddParagraph("To complete certification, the difficulty level will now decrease until you can get 20 rounds correct in a row!",
                     cp => cp.Font = OsuFont.Default.With(size: 24, weight: FontWeight.SemiBold));
                 statusText.AddParagraph(string.Empty);
             }
@@ -226,67 +232,22 @@ Do whatever you need to try and perceive the difference in latency, then choose
                                     + $"Draw: {host.DrawThread.Clock.FramesPerSecond} Hz"
                 , cp => cp.Font = OsuFont.Default.With(size: 15, weight: FontWeight.SemiBold));
 
-            int certificationRemaining = !isPass ? rounds_to_complete_certified : rounds_to_complete_certified - correctAtCurrentDifficulty;
-
-            if (isPass && certificationRemaining <= 0)
+            if (isCertifying && isPass)
             {
-                Drawable background;
-                Drawable certifiedText;
-
-                resultsArea.AddRange(new[]
-                {
-                    background = new Box
-                    {
-                        Colour = overlayColourProvider.Background4,
-                        RelativeSizeAxes = Axes.Both,
-                    },
-                    (certifiedText = new OsuSpriteText
-                    {
-                        Alpha = 0,
-                        Font = OsuFont.TorusAlternate.With(size: 80, weight: FontWeight.Bold),
-                        Text = "Certified!",
-                        Blending = BlendingParameters.Additive,
-                    }).WithEffect(new GlowEffect
-                    {
-                        Colour = overlayColourProvider.Colour1,
-                        PadExtent = true
-                    }).With(e =>
-                    {
-                        e.Anchor = Anchor.Centre;
-                        e.Origin = Anchor.Centre;
-                    }),
-                    new OsuSpriteText
-                    {
-                        Text = $"You should use a frame limiter with update rate of {mapDifficultyToTargetFrameRate(difficultyLevel + 1)} Hz (or fps) for best results!",
-                        Anchor = Anchor.Centre,
-                        Origin = Anchor.Centre,
-                        Font = OsuFont.Torus.With(size: 24, weight: FontWeight.SemiBold),
-                        Y = 80,
-                    }
-                });
-
-                background.FadeInFromZero(1000, Easing.OutQuint);
-
-                certifiedText.FadeInFromZero(500, Easing.InQuint);
-
-                certifiedText
-                    .ScaleTo(10)
-                    .ScaleTo(1, 600, Easing.InQuad)
-                    .Then()
-                    .ScaleTo(1.05f, 10000, Easing.OutQuint);
+                showCertifiedScreen();
                 return;
             }
 
             string cannotIncreaseReason = string.Empty;
 
-            if (!isPass)
-                cannotIncreaseReason = "You didn't get a perfect score.";
-            else if (mapDifficultyToTargetFrameRate(difficultyLevel + 1) > target_host_update_frames)
+            if (mapDifficultyToTargetFrameRate(DifficultyLevel + 1) > target_host_update_frames)
                 cannotIncreaseReason = "You've reached the maximum level.";
-            else if (mapDifficultyToTargetFrameRate(difficultyLevel + 1) > Clock.FramesPerSecond)
+            else if (mapDifficultyToTargetFrameRate(DifficultyLevel + 1) > Clock.FramesPerSecond)
                 cannotIncreaseReason = "Game is not running fast enough to test this level";
 
-            resultsArea.Add(new FillFlowContainer
+            FillFlowContainer buttonFlow;
+
+            resultsArea.Add(buttonFlow = new FillFlowContainer
             {
                 RelativeSizeAxes = Axes.X,
                 AutoSizeAxes = Axes.Y,
@@ -294,42 +255,104 @@ Do whatever you need to try and perceive the difference in latency, then choose
                 Origin = Anchor.BottomLeft,
                 Spacing = new Vector2(20),
                 Padding = new MarginPadding(20),
-                Children = new Drawable[]
+            });
+
+            if (isPass)
+            {
+                buttonFlow.Add(new ButtonWithKeyBind(Key.Enter)
                 {
-                    new ButtonWithKeyBind(Key.Enter)
+                    Text = "Continue to next level",
+                    BackgroundColour = colours.Green,
+                    Anchor = Anchor.Centre,
+                    Origin = Anchor.Centre,
+                    Action = () => changeDifficulty(DifficultyLevel + 1),
+                    Enabled = { Value = string.IsNullOrEmpty(cannotIncreaseReason) },
+                    TooltipText = cannotIncreaseReason
+                });
+            }
+            else
+            {
+                if (DifficultyLevel == 1)
+                {
+                    buttonFlow.Add(new ButtonWithKeyBind(Key.Enter)
                     {
-                        Text = "Continue to next level",
-                        BackgroundColour = colours.Red2,
-                        Anchor = Anchor.Centre,
-                        Origin = Anchor.Centre,
-                        Action = () => changeDifficulty(difficultyLevel + 1),
-                        Enabled = { Value = string.IsNullOrEmpty(cannotIncreaseReason) },
-                        TooltipText = cannotIncreaseReason
-                    },
-                    new ButtonWithKeyBind(Key.D)
-                    {
-                        Text = difficultyLevel == 1 ? "Retry" : "Return to last level",
-                        BackgroundColour = colours.Green,
-                        Anchor = Anchor.Centre,
-                        Origin = Anchor.Centre,
-                        Action = () => changeDifficulty(Math.Max(difficultyLevel - 1, 1)),
-                    },
-                    new ButtonWithKeyBind(Key.C)
-                    {
-                        Text = $"Continue towards certification at this level ({certificationRemaining} more)",
+                        Text = "Retry",
+                        TooltipText = "Are you even trying..?",
+                        BackgroundColour = colours.Pink2,
                         Anchor = Anchor.Centre,
                         Origin = Anchor.Centre,
                         Action = () =>
                         {
-                            resultsArea.Clear();
-                            totalRoundForNextResultsScreen += rounds_to_complete;
-                            loadNextRound();
+                            isCertifying = false;
+                            changeDifficulty(1);
                         },
-                        TooltipText = isPass ? $"Chain {rounds_to_complete_certified} to confirm your perception!" : "You've reached your limits. Go to the previous level to complete certification!",
-                        Enabled = { Value = isPass },
-                    },
+                    });
+                }
+                else
+                {
+                    buttonFlow.Add(new ButtonWithKeyBind(Key.Enter)
+                    {
+                        Text = "Begin certification at last level",
+                        BackgroundColour = colours.Yellow,
+                        Anchor = Anchor.Centre,
+                        Origin = Anchor.Centre,
+                        Action = () =>
+                        {
+                            isCertifying = true;
+                            changeDifficulty(DifficultyLevel - 1);
+                        },
+                        TooltipText = isPass ? $"Chain {rounds_to_complete_certified} rounds to confirm your perception!" : "You've reached your limits. Go to the previous level to complete certification!",
+                    });
+                }
+            }
+        }
+
+        private void showCertifiedScreen()
+        {
+            Drawable background;
+            Drawable certifiedText;
+
+            resultsArea.AddRange(new[]
+            {
+                background = new Box
+                {
+                    Colour = overlayColourProvider.Background4,
+                    RelativeSizeAxes = Axes.Both,
+                },
+                (certifiedText = new OsuSpriteText
+                {
+                    Alpha = 0,
+                    Font = OsuFont.TorusAlternate.With(size: 80, weight: FontWeight.Bold),
+                    Text = "Certified!",
+                    Blending = BlendingParameters.Additive,
+                }).WithEffect(new GlowEffect
+                {
+                    Colour = overlayColourProvider.Colour1,
+                    PadExtent = true
+                }).With(e =>
+                {
+                    e.Anchor = Anchor.Centre;
+                    e.Origin = Anchor.Centre;
+                }),
+                new OsuSpriteText
+                {
+                    Text = $"You should use a frame limiter with update rate of {mapDifficultyToTargetFrameRate(DifficultyLevel + 1)} Hz (or fps) for best results!",
+                    Anchor = Anchor.Centre,
+                    Origin = Anchor.Centre,
+                    Font = OsuFont.Torus.With(size: 24, weight: FontWeight.SemiBold),
+                    Y = 80,
                 }
             });
+
+            background.FadeInFromZero(1000, Easing.OutQuint);
+
+            certifiedText.FadeInFromZero(500, Easing.InQuint);
+
+            certifiedText
+                .ScaleTo(10)
+                .ScaleTo(1, 600, Easing.InQuad)
+                .Then()
+                .ScaleTo(1.05f, 10000, Easing.OutQuint);
         }
 
         private void changeDifficulty(int difficulty)
@@ -344,8 +367,7 @@ Do whatever you need to try and perceive the difference in latency, then choose
             pollingMax = 0;
             lastPoll = 0;
 
-            totalRoundForNextResultsScreen = rounds_to_complete;
-            difficultyLevel = difficulty;
+            DifficultyLevel = difficulty;
 
             loadNextRound();
         }
@@ -353,7 +375,7 @@ Do whatever you need to try and perceive the difference in latency, then choose
         private void loadNextRound()
         {
             attemptsAtCurrentDifficulty++;
-            statusText.Text = $"Level {difficultyLevel}\nRound {attemptsAtCurrentDifficulty} of {totalRoundForNextResultsScreen}";
+            statusText.Text = $"Level {DifficultyLevel}\nRound {attemptsAtCurrentDifficulty} of {totalRoundForNextResultsScreen}";
 
             mainArea.Clear();
 
@@ -361,13 +383,13 @@ Do whatever you need to try and perceive the difference in latency, then choose
 
             mainArea.AddRange(new[]
             {
-                new LatencyArea(Key.Number1, betterSide == 1 ? mapDifficultyToTargetFrameRate(difficultyLevel) : (int?)null)
+                new LatencyArea(Key.Number1, betterSide == 1 ? mapDifficultyToTargetFrameRate(DifficultyLevel) : (int?)null)
                 {
                     Width = 0.5f,
                     IsActiveArea = { Value = true },
                     ReportUserBest = () => recordResult(betterSide == 0),
                 },
-                new LatencyArea(Key.Number2, betterSide == 0 ? mapDifficultyToTargetFrameRate(difficultyLevel) : (int?)null)
+                new LatencyArea(Key.Number2, betterSide == 0 ? mapDifficultyToTargetFrameRate(DifficultyLevel) : (int?)null)
                 {
                     Width = 0.5f,
                     Anchor = Anchor.TopRight,

From 936b38e0c54f878442dae0b670148f16931d0ff0 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 10 Jun 2022 16:13:53 +0900
Subject: [PATCH 5351/5547] Reduce test coverage to a point where headless
 tests will run correctly

---
 .../TestSceneLatencyCertifierScreen.cs        | 19 +++++--------------
 1 file changed, 5 insertions(+), 14 deletions(-)

diff --git a/osu.Game.Tests/Visual/Settings/TestSceneLatencyCertifierScreen.cs b/osu.Game.Tests/Visual/Settings/TestSceneLatencyCertifierScreen.cs
index 81faf31c69..af6681e9cf 100644
--- a/osu.Game.Tests/Visual/Settings/TestSceneLatencyCertifierScreen.cs
+++ b/osu.Game.Tests/Visual/Settings/TestSceneLatencyCertifierScreen.cs
@@ -27,28 +27,19 @@ namespace osu.Game.Tests.Visual.Settings
         [Test]
         public void TestCertification()
         {
-            for (int i = 0; i < 4; i++)
-            {
-                int difficulty = i + 1;
-
-                checkDifficulty(difficulty);
-                clickUntilResults(true);
-                continueFromResults();
-            }
-
-            checkDifficulty(5);
-            clickUntilResults(false);
+            checkDifficulty(1);
+            clickUntilResults(true);
             continueFromResults();
-            checkDifficulty(4);
+            checkDifficulty(2);
 
             clickUntilResults(false);
             continueFromResults();
-            checkDifficulty(3);
+            checkDifficulty(1);
 
             clickUntilResults(true);
             AddAssert("check at results", () => !latencyCertifier.ChildrenOfType<LatencyArea>().Any());
             AddAssert("check no buttons", () => !latencyCertifier.ChildrenOfType<OsuButton>().Any());
-            checkDifficulty(3);
+            checkDifficulty(1);
         }
 
         private void continueFromResults()

From e7602563fb770d9f82b92c3bf7b50e7e10753f50 Mon Sep 17 00:00:00 2001
From: apollo-dw <83023433+apollo-dw@users.noreply.github.com>
Date: Fri, 10 Jun 2022 10:28:14 +0100
Subject: [PATCH 5352/5547] Fetch lastlast object from beatmap, not objects
 list

---
 osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs  | 5 ++++-
 .../Difficulty/Preprocessing/OsuDifficultyHitObject.cs       | 4 ++--
 2 files changed, 6 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs b/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs
index f074783ccf..0fa69c180a 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs
@@ -92,7 +92,10 @@ namespace osu.Game.Rulesets.Osu.Difficulty
             // The first jump is formed by the first two hitobjects of the map.
             // If the map has less than two OsuHitObjects, the enumerator will not return anything.
             for (int i = 1; i < beatmap.HitObjects.Count; i++)
-                objects.Add(new OsuDifficultyHitObject(beatmap.HitObjects[i], beatmap.HitObjects[i - 1], clockRate, objects, objects.Count));
+            {
+                var lastLast = i > 1 ? beatmap.HitObjects[i - 2] : null;
+                objects.Add(new OsuDifficultyHitObject(beatmap.HitObjects[i], beatmap.HitObjects[i - 1], lastLast, clockRate, objects, objects.Count));
+            }
 
             return objects;
         }
diff --git a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
index 989d407bd0..20921dd282 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
@@ -75,10 +75,10 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Preprocessing
         private readonly OsuHitObject lastLastObject;
         private readonly OsuHitObject lastObject;
 
-        public OsuDifficultyHitObject(HitObject hitObject, HitObject lastObject, double clockRate, List<DifficultyHitObject> objects, int index)
+        public OsuDifficultyHitObject(HitObject hitObject, HitObject lastObject, HitObject lastLastObject, double clockRate, List<DifficultyHitObject> objects, int index)
             : base(hitObject, lastObject, clockRate, objects, index)
         {
-            lastLastObject = (OsuHitObject)Previous(1)?.BaseObject;
+            this.lastLastObject = (OsuHitObject)lastLastObject;
             this.lastObject = (OsuHitObject)lastObject;
 
             // Capped to 25ms to prevent difficulty calculation breaking from simultaneous objects.

From 53eb5c176c48fd86677f22a5cf09fe7575ce64e4 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 10 Jun 2022 16:22:34 +0900
Subject: [PATCH 5353/5547] Create setup for adding other visual display modes

---
 osu.Game/Screens/Utility/CircleGameplay.cs    |  12 +
 osu.Game/Screens/Utility/LatencyArea.cs       | 206 +++++-------------
 .../Screens/Utility/LatencyCertifierScreen.cs |  16 +-
 osu.Game/Screens/Utility/LatencyVisualMode.cs |  13 ++
 .../LatencyCursorContainer.cs                 |  67 ++++++
 .../SampleComponents/LatencyMovableBox.cs     | 102 +++++++++
 osu.Game/Screens/Utility/ScrollingGameplay.cs |  12 +
 7 files changed, 277 insertions(+), 151 deletions(-)
 create mode 100644 osu.Game/Screens/Utility/CircleGameplay.cs
 create mode 100644 osu.Game/Screens/Utility/LatencyVisualMode.cs
 create mode 100644 osu.Game/Screens/Utility/SampleComponents/LatencyCursorContainer.cs
 create mode 100644 osu.Game/Screens/Utility/SampleComponents/LatencyMovableBox.cs
 create mode 100644 osu.Game/Screens/Utility/ScrollingGameplay.cs

diff --git a/osu.Game/Screens/Utility/CircleGameplay.cs b/osu.Game/Screens/Utility/CircleGameplay.cs
new file mode 100644
index 0000000000..0667a54ced
--- /dev/null
+++ b/osu.Game/Screens/Utility/CircleGameplay.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.
+
+#nullable enable
+using osu.Framework.Graphics.Containers;
+
+namespace osu.Game.Screens.Utility
+{
+    public class CircleGameplay : CompositeDrawable
+    {
+    }
+}
diff --git a/osu.Game/Screens/Utility/LatencyArea.cs b/osu.Game/Screens/Utility/LatencyArea.cs
index 2ef48bb571..5b48a10a49 100644
--- a/osu.Game/Screens/Utility/LatencyArea.cs
+++ b/osu.Game/Screens/Utility/LatencyArea.cs
@@ -9,10 +9,9 @@ using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
-using osu.Framework.Input;
 using osu.Framework.Input.Events;
 using osu.Game.Overlays;
-using osuTK;
+using osu.Game.Screens.Utility.SampleComponents;
 using osuTK.Input;
 
 namespace osu.Game.Screens.Utility
@@ -28,10 +27,14 @@ namespace osu.Game.Screens.Utility
 
         private readonly Key key;
 
+        private Container visualContent = null!;
+
         public readonly int? TargetFrameRate;
 
         public readonly BindableBool IsActiveArea = new BindableBool();
 
+        public readonly Bindable<LatencyVisualMode> VisualMode = new Bindable<LatencyVisualMode>();
+
         public LatencyArea(Key key, int? targetFrameRate)
         {
             this.key = key;
@@ -61,20 +64,9 @@ namespace osu.Game.Screens.Utility
                     Origin = Anchor.TopCentre,
                     Action = () => ReportUserBest?.Invoke(),
                 },
-                new Container
+                visualContent = new Container
                 {
                     RelativeSizeAxes = Axes.Both,
-                    Children = new Drawable[]
-                    {
-                        new LatencyMovableBox(IsActiveArea)
-                        {
-                            RelativeSizeAxes = Axes.Both,
-                        },
-                        new LatencyCursorContainer(IsActiveArea)
-                        {
-                            RelativeSizeAxes = Axes.Both,
-                        },
-                    }
                 },
             };
 
@@ -82,6 +74,57 @@ namespace osu.Game.Screens.Utility
             {
                 background.FadeColour(active.NewValue ? overlayColourProvider.Background4 : overlayColourProvider.Background6, 200, Easing.OutQuint);
             }, true);
+
+            VisualMode.BindValueChanged(mode =>
+            {
+                switch (mode.NewValue)
+                {
+                    case LatencyVisualMode.Simple:
+                        visualContent.Children = new Drawable[]
+                        {
+                            new LatencyMovableBox(IsActiveArea)
+                            {
+                                RelativeSizeAxes = Axes.Both,
+                            },
+                            new LatencyCursorContainer(IsActiveArea)
+                            {
+                                RelativeSizeAxes = Axes.Both,
+                            },
+                        };
+                        break;
+
+                    case LatencyVisualMode.CircleGameplay:
+                        visualContent.Children = new Drawable[]
+                        {
+                            new CircleGameplay
+                            {
+                                RelativeSizeAxes = Axes.Both,
+                            },
+                            new LatencyCursorContainer(IsActiveArea)
+                            {
+                                RelativeSizeAxes = Axes.Both,
+                            },
+                        };
+                        break;
+
+                    case LatencyVisualMode.ScrollingGameplay:
+                        visualContent.Children = new Drawable[]
+                        {
+                            new ScrollingGameplay
+                            {
+                                RelativeSizeAxes = Axes.Both,
+                            },
+                            new LatencyCursorContainer(IsActiveArea)
+                            {
+                                RelativeSizeAxes = Axes.Both,
+                            },
+                        };
+                        break;
+
+                    default:
+                        throw new ArgumentOutOfRangeException();
+                }
+            }, true);
         }
 
         protected override bool OnMouseMove(MouseMoveEvent e)
@@ -102,140 +145,5 @@ namespace osu.Game.Screens.Utility
 
             return base.UpdateSubTree();
         }
-
-        public class LatencyMovableBox : CompositeDrawable
-        {
-            private Box box = null!;
-            private InputManager inputManager = null!;
-
-            private readonly BindableBool isActive;
-
-            [Resolved]
-            private OverlayColourProvider overlayColourProvider { get; set; } = null!;
-
-            public LatencyMovableBox(BindableBool isActive)
-            {
-                this.isActive = isActive;
-            }
-
-            protected override void LoadComplete()
-            {
-                base.LoadComplete();
-
-                inputManager = GetContainingInputManager();
-
-                InternalChild = box = new Box
-                {
-                    Size = new Vector2(40),
-                    RelativePositionAxes = Axes.Both,
-                    Position = new Vector2(0.5f),
-                    Origin = Anchor.Centre,
-                    Colour = overlayColourProvider.Colour1,
-                };
-            }
-
-            protected override bool OnHover(HoverEvent e) => false;
-
-            private double? lastFrameTime;
-
-            protected override void Update()
-            {
-                base.Update();
-
-                if (!isActive.Value)
-                {
-                    lastFrameTime = null;
-                    box.Colour = overlayColourProvider.Colour1;
-                    return;
-                }
-
-                if (lastFrameTime != null)
-                {
-                    float movementAmount = (float)(Clock.CurrentTime - lastFrameTime) / 400;
-
-                    var buttons = inputManager.CurrentState.Keyboard.Keys;
-
-                    box.Colour = buttons.HasAnyButtonPressed ? overlayColourProvider.Content1 : overlayColourProvider.Colour1;
-
-                    foreach (var key in buttons)
-                    {
-                        switch (key)
-                        {
-                            case Key.K:
-                            case Key.Up:
-                                box.Y = MathHelper.Clamp(box.Y - movementAmount, 0.1f, 0.9f);
-                                break;
-
-                            case Key.J:
-                            case Key.Down:
-                                box.Y = MathHelper.Clamp(box.Y + movementAmount, 0.1f, 0.9f);
-                                break;
-
-                            case Key.Z:
-                            case Key.Left:
-                                box.X = MathHelper.Clamp(box.X - movementAmount, 0.1f, 0.9f);
-                                break;
-
-                            case Key.X:
-                            case Key.Right:
-                                box.X = MathHelper.Clamp(box.X + movementAmount, 0.1f, 0.9f);
-                                break;
-                        }
-                    }
-                }
-
-                lastFrameTime = Clock.CurrentTime;
-            }
-        }
-
-        public class LatencyCursorContainer : CompositeDrawable
-        {
-            private Circle cursor = null!;
-            private InputManager inputManager = null!;
-
-            private readonly BindableBool isActive;
-
-            [Resolved]
-            private OverlayColourProvider overlayColourProvider { get; set; } = null!;
-
-            public LatencyCursorContainer(BindableBool isActive)
-            {
-                this.isActive = isActive;
-                Masking = true;
-            }
-
-            protected override void LoadComplete()
-            {
-                base.LoadComplete();
-
-                InternalChild = cursor = new Circle
-                {
-                    Size = new Vector2(40),
-                    Origin = Anchor.Centre,
-                    Colour = overlayColourProvider.Colour2,
-                };
-
-                inputManager = GetContainingInputManager();
-            }
-
-            protected override bool OnHover(HoverEvent e) => false;
-
-            protected override void Update()
-            {
-                cursor.Colour = inputManager.CurrentState.Mouse.IsPressed(MouseButton.Left) ? overlayColourProvider.Content1 : overlayColourProvider.Colour2;
-
-                if (isActive.Value)
-                {
-                    cursor.Position = ToLocalSpace(inputManager.CurrentState.Mouse.Position);
-                    cursor.Alpha = 1;
-                }
-                else
-                {
-                    cursor.Alpha = 0;
-                }
-
-                base.Update();
-            }
-        }
     }
 }
diff --git a/osu.Game/Screens/Utility/LatencyCertifierScreen.cs b/osu.Game/Screens/Utility/LatencyCertifierScreen.cs
index 0a9d98450f..00821ab773 100644
--- a/osu.Game/Screens/Utility/LatencyCertifierScreen.cs
+++ b/osu.Game/Screens/Utility/LatencyCertifierScreen.cs
@@ -7,6 +7,7 @@ using System;
 using System.Diagnostics;
 using System.Linq;
 using osu.Framework.Allocation;
+using osu.Framework.Bindables;
 using osu.Framework.Configuration;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
@@ -62,6 +63,8 @@ namespace osu.Game.Screens.Utility
         [Resolved]
         private FrameworkConfigManager config { get; set; } = null!;
 
+        private readonly Bindable<LatencyVisualMode> visualMode = new Bindable<LatencyVisualMode>();
+
         private const int rounds_to_complete = 5;
 
         private const int rounds_to_complete_certified = 20;
@@ -124,8 +127,9 @@ namespace osu.Game.Screens.Utility
                     RelativeSizeAxes = Axes.X,
                     AutoSizeAxes = Axes.Y,
                     Text = @"Welcome to the latency certifier!
-Use the arrow keys, Z/X/J/K to move the square.
+Use the arrow keys, Z/X/F/J to control the display.
 Use the Tab key to change focus.
+Change display modes with Space.
 Do whatever you need to try and perceive the difference in latency, then choose your best side.
 ",
                 },
@@ -182,6 +186,10 @@ Do whatever you need to try and perceive the difference in latency, then choose
         {
             switch (e.Key)
             {
+                case Key.Space:
+                    visualMode.Value = (LatencyVisualMode)(((int)visualMode.Value + 1) % 3);
+                    return true;
+
                 case Key.Tab:
                     var firstArea = mainArea.FirstOrDefault(a => !a.IsActiveArea.Value);
                     if (firstArea != null)
@@ -301,7 +309,9 @@ Do whatever you need to try and perceive the difference in latency, then choose
                             isCertifying = true;
                             changeDifficulty(DifficultyLevel - 1);
                         },
-                        TooltipText = isPass ? $"Chain {rounds_to_complete_certified} rounds to confirm your perception!" : "You've reached your limits. Go to the previous level to complete certification!",
+                        TooltipText = isPass
+                            ? $"Chain {rounds_to_complete_certified} rounds to confirm your perception!"
+                            : "You've reached your limits. Go to the previous level to complete certification!",
                     });
                 }
             }
@@ -386,12 +396,14 @@ Do whatever you need to try and perceive the difference in latency, then choose
                 new LatencyArea(Key.Number1, betterSide == 1 ? mapDifficultyToTargetFrameRate(DifficultyLevel) : (int?)null)
                 {
                     Width = 0.5f,
+                    VisualMode = { BindTarget = visualMode },
                     IsActiveArea = { Value = true },
                     ReportUserBest = () => recordResult(betterSide == 0),
                 },
                 new LatencyArea(Key.Number2, betterSide == 0 ? mapDifficultyToTargetFrameRate(DifficultyLevel) : (int?)null)
                 {
                     Width = 0.5f,
+                    VisualMode = { BindTarget = visualMode },
                     Anchor = Anchor.TopRight,
                     Origin = Anchor.TopRight,
                     ReportUserBest = () => recordResult(betterSide == 1)
diff --git a/osu.Game/Screens/Utility/LatencyVisualMode.cs b/osu.Game/Screens/Utility/LatencyVisualMode.cs
new file mode 100644
index 0000000000..55dab86f9e
--- /dev/null
+++ b/osu.Game/Screens/Utility/LatencyVisualMode.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.
+
+#nullable enable
+namespace osu.Game.Screens.Utility
+{
+    public enum LatencyVisualMode
+    {
+        Simple,
+        CircleGameplay,
+        ScrollingGameplay,
+    }
+}
diff --git a/osu.Game/Screens/Utility/SampleComponents/LatencyCursorContainer.cs b/osu.Game/Screens/Utility/SampleComponents/LatencyCursorContainer.cs
new file mode 100644
index 0000000000..753310c3b3
--- /dev/null
+++ b/osu.Game/Screens/Utility/SampleComponents/LatencyCursorContainer.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.
+
+#nullable enable
+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;
+using osu.Framework.Input.Events;
+using osu.Game.Overlays;
+using osuTK;
+using osuTK.Input;
+
+namespace osu.Game.Screens.Utility.SampleComponents
+{
+    public class LatencyCursorContainer : CompositeDrawable
+    {
+        private Circle cursor = null!;
+        private InputManager inputManager = null!;
+
+        private readonly BindableBool isActive;
+
+        [Resolved]
+        private OverlayColourProvider overlayColourProvider { get; set; } = null!;
+
+        public LatencyCursorContainer(BindableBool isActive)
+        {
+            this.isActive = isActive;
+            Masking = true;
+        }
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            InternalChild = cursor = new Circle
+            {
+                Size = new Vector2(40),
+                Origin = Anchor.Centre,
+                Colour = overlayColourProvider.Colour2,
+            };
+
+            inputManager = GetContainingInputManager();
+        }
+
+        protected override bool OnHover(HoverEvent e) => false;
+
+        protected override void Update()
+        {
+            cursor.Colour = inputManager.CurrentState.Mouse.IsPressed(MouseButton.Left) ? overlayColourProvider.Content1 : overlayColourProvider.Colour2;
+
+            if (isActive.Value)
+            {
+                cursor.Position = ToLocalSpace(inputManager.CurrentState.Mouse.Position);
+                cursor.Alpha = 1;
+            }
+            else
+            {
+                cursor.Alpha = 0;
+            }
+
+            base.Update();
+        }
+    }
+}
diff --git a/osu.Game/Screens/Utility/SampleComponents/LatencyMovableBox.cs b/osu.Game/Screens/Utility/SampleComponents/LatencyMovableBox.cs
new file mode 100644
index 0000000000..418d45489f
--- /dev/null
+++ b/osu.Game/Screens/Utility/SampleComponents/LatencyMovableBox.cs
@@ -0,0 +1,102 @@
+// 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 enable
+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;
+using osu.Framework.Input.Events;
+using osu.Game.Overlays;
+using osuTK;
+using osuTK.Input;
+
+namespace osu.Game.Screens.Utility.SampleComponents
+{
+    public class LatencyMovableBox : CompositeDrawable
+    {
+        private Box box = null!;
+        private InputManager inputManager = null!;
+
+        private readonly BindableBool isActive;
+
+        [Resolved]
+        private OverlayColourProvider overlayColourProvider { get; set; } = null!;
+
+        public LatencyMovableBox(BindableBool isActive)
+        {
+            this.isActive = isActive;
+        }
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            inputManager = GetContainingInputManager();
+
+            InternalChild = box = new Box
+            {
+                Size = new Vector2(40),
+                RelativePositionAxes = Axes.Both,
+                Position = new Vector2(0.5f),
+                Origin = Anchor.Centre,
+                Colour = overlayColourProvider.Colour1,
+            };
+        }
+
+        protected override bool OnHover(HoverEvent e) => false;
+
+        private double? lastFrameTime;
+
+        protected override void Update()
+        {
+            base.Update();
+
+            if (!isActive.Value)
+            {
+                lastFrameTime = null;
+                box.Colour = overlayColourProvider.Colour1;
+                return;
+            }
+
+            if (lastFrameTime != null)
+            {
+                float movementAmount = (float)(Clock.CurrentTime - lastFrameTime) / 400;
+
+                var buttons = inputManager.CurrentState.Keyboard.Keys;
+
+                box.Colour = buttons.HasAnyButtonPressed ? overlayColourProvider.Content1 : overlayColourProvider.Colour1;
+
+                foreach (var key in buttons)
+                {
+                    switch (key)
+                    {
+                        case Key.F:
+                        case Key.Up:
+                            box.Y = MathHelper.Clamp(box.Y - movementAmount, 0.1f, 0.9f);
+                            break;
+
+                        case Key.K:
+                        case Key.Down:
+                            box.Y = MathHelper.Clamp(box.Y + movementAmount, 0.1f, 0.9f);
+                            break;
+
+                        case Key.Z:
+                        case Key.Left:
+                            box.X = MathHelper.Clamp(box.X - movementAmount, 0.1f, 0.9f);
+                            break;
+
+                        case Key.X:
+                        case Key.Right:
+                            box.X = MathHelper.Clamp(box.X + movementAmount, 0.1f, 0.9f);
+                            break;
+                    }
+                }
+            }
+
+            lastFrameTime = Clock.CurrentTime;
+        }
+    }
+}
diff --git a/osu.Game/Screens/Utility/ScrollingGameplay.cs b/osu.Game/Screens/Utility/ScrollingGameplay.cs
new file mode 100644
index 0000000000..31920d27e7
--- /dev/null
+++ b/osu.Game/Screens/Utility/ScrollingGameplay.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.
+
+#nullable enable
+using osu.Framework.Graphics.Containers;
+
+namespace osu.Game.Screens.Utility
+{
+    public class ScrollingGameplay : CompositeDrawable
+    {
+    }
+}

From e9547542ead87b0f2df143f191daf0d4d74009e0 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 10 Jun 2022 17:17:09 +0900
Subject: [PATCH 5354/5547] Add circle gameplay

---
 osu.Game/Screens/Utility/CircleGameplay.cs | 163 ++++++++++++++++++++-
 1 file changed, 162 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Utility/CircleGameplay.cs b/osu.Game/Screens/Utility/CircleGameplay.cs
index 0667a54ced..abd7c40532 100644
--- a/osu.Game/Screens/Utility/CircleGameplay.cs
+++ b/osu.Game/Screens/Utility/CircleGameplay.cs
@@ -2,11 +2,172 @@
 // See the LICENCE file in the repository root for full licence text.
 
 #nullable enable
+using System;
+using System.Collections.Generic;
+using osu.Framework.Audio.Track;
+using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.Shapes;
+using osu.Framework.Input.Events;
+using osu.Game.Beatmaps.ControlPoints;
+using osu.Game.Graphics;
+using osu.Game.Graphics.Containers;
+using osu.Game.Graphics.Sprites;
+using osu.Game.Rulesets.Objects;
+using osu.Game.Rulesets.Scoring;
+using osuTK;
+using osuTK.Graphics;
 
 namespace osu.Game.Screens.Utility
 {
-    public class CircleGameplay : CompositeDrawable
+    public class CircleGameplay : BeatSyncedContainer
     {
+        private int nextLocation;
+
+        private OsuSpriteText unstableRate = null!;
+
+        private readonly List<HitEvent> hitEvents = new List<HitEvent>();
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            InternalChildren = new Drawable[]
+            {
+                unstableRate = new OsuSpriteText
+                {
+                    Anchor = Anchor.Centre,
+                    Origin = Anchor.Centre,
+                    Font = OsuFont.Default.With(size: 24)
+                }
+            };
+        }
+
+        protected override void OnNewBeat(int beatIndex, TimingControlPoint timingPoint, EffectControlPoint effectPoint, ChannelAmplitudes amplitudes)
+        {
+            base.OnNewBeat(beatIndex, timingPoint, effectPoint, amplitudes);
+
+            nextLocation++;
+
+            Vector2 location;
+
+            switch (nextLocation % 4)
+            {
+                default:
+                    location = new Vector2(0.25f, 0.25f);
+                    break;
+
+                case 1:
+                    location = new Vector2(0.75f, 0.75f);
+                    break;
+
+                case 2:
+                    location = new Vector2(0.75f, 0.25f);
+                    break;
+
+                case 3:
+                    location = new Vector2(0.25f, 0.75f);
+                    break;
+            }
+
+            AddInternal(new SampleHitCircle(Clock.CurrentTime + timingPoint.BeatLength)
+            {
+                RelativePositionAxes = Axes.Both,
+                Position = location,
+                Hit = hit,
+            });
+        }
+
+        private void hit(HitEvent h)
+        {
+            hitEvents.Add(h);
+            unstableRate.Text = $"{hitEvents.CalculateUnstableRate():N1}";
+        }
+
+        public class SampleHitCircle : CompositeDrawable
+        {
+            public HitEvent? HitEvent;
+
+            public Action<HitEvent>? Hit { get; set; }
+
+            public readonly double HitTime;
+
+            private readonly CircularContainer approach;
+            private readonly Circle circle;
+
+            private const float size = 100;
+
+            public SampleHitCircle(double hitTime)
+            {
+                HitTime = hitTime;
+
+                Origin = Anchor.Centre;
+
+                AutoSizeAxes = Axes.Both;
+
+                InternalChildren = new Drawable[]
+                {
+                    circle = new Circle
+                    {
+                        Colour = Color4.White,
+                        Size = new Vector2(size),
+                        Anchor = Anchor.Centre,
+                        Origin = Anchor.Centre,
+                    },
+                    approach = new CircularContainer
+                    {
+                        BorderColour = Color4.Yellow,
+                        Size = new Vector2(size),
+                        Masking = true,
+                        BorderThickness = 4,
+                        Anchor = Anchor.Centre,
+                        Origin = Anchor.Centre,
+                        Children = new Drawable[]
+                        {
+                            new Box
+                            {
+                                Colour = Color4.Black,
+                                Alpha = 0,
+                                AlwaysPresent = true,
+                                RelativeSizeAxes = Axes.Both,
+                            },
+                        }
+                    },
+                };
+            }
+
+            protected override bool OnMouseDown(MouseDownEvent e)
+            {
+                if (HitEvent != null)
+                    return false;
+
+                approach.Expire();
+
+                circle
+                    .FadeOut(200)
+                    .ScaleTo(1.5f, 200);
+
+                HitEvent = new HitEvent(Clock.CurrentTime - HitTime, HitResult.Good, new HitObject
+                {
+                    HitWindows = new HitWindows(),
+                }, null, null);
+
+                Hit?.Invoke(HitEvent.Value);
+
+                this.Delay(200).Expire();
+
+                return true;
+            }
+
+            protected override void Update()
+            {
+                base.Update();
+
+                approach.Scale = new Vector2((float)MathHelper.Clamp((HitTime - Clock.CurrentTime) / 40, 1, 100));
+
+                if (Clock.CurrentTime > HitTime + 80)
+                    Expire();
+            }
+        }
     }
 }

From c657ef272287d0c83d57f652363b23abb55eb2cb Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 10 Jun 2022 17:27:06 +0900
Subject: [PATCH 5355/5547] Add ability to adjust spacing

---
 osu.Game/Screens/Utility/CircleGameplay.cs | 18 +++++++++++++-----
 1 file changed, 13 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Screens/Utility/CircleGameplay.cs b/osu.Game/Screens/Utility/CircleGameplay.cs
index abd7c40532..c97b5dd7a7 100644
--- a/osu.Game/Screens/Utility/CircleGameplay.cs
+++ b/osu.Game/Screens/Utility/CircleGameplay.cs
@@ -51,22 +51,27 @@ namespace osu.Game.Screens.Utility
 
             Vector2 location;
 
+            const float spacing = 0.1f;
+
+            const float spacing_low = 0.5f - spacing;
+            const float spacing_high = 0.5f + spacing;
+
             switch (nextLocation % 4)
             {
                 default:
-                    location = new Vector2(0.25f, 0.25f);
+                    location = new Vector2(spacing_low, spacing_low);
                     break;
 
                 case 1:
-                    location = new Vector2(0.75f, 0.75f);
+                    location = new Vector2(spacing_high, spacing_high);
                     break;
 
                 case 2:
-                    location = new Vector2(0.75f, 0.25f);
+                    location = new Vector2(spacing_high, spacing_low);
                     break;
 
                 case 3:
-                    location = new Vector2(0.25f, 0.75f);
+                    location = new Vector2(spacing_low, spacing_high);
                     break;
             }
 
@@ -97,6 +102,9 @@ namespace osu.Game.Screens.Utility
 
             private const float size = 100;
 
+            public override bool ReceivePositionalInputAt(Vector2 screenSpacePos)
+                => circle.ReceivePositionalInputAt(screenSpacePos);
+
             public SampleHitCircle(double hitTime)
             {
                 HitTime = hitTime;
@@ -163,7 +171,7 @@ namespace osu.Game.Screens.Utility
             {
                 base.Update();
 
-                approach.Scale = new Vector2((float)MathHelper.Clamp((HitTime - Clock.CurrentTime) / 40, 1, 100));
+                approach.Scale = new Vector2((float)MathHelper.Clamp((HitTime - Clock.CurrentTime) / 60, 1, 100));
 
                 if (Clock.CurrentTime > HitTime + 80)
                     Expire();

From d46739ff0bc53f5dc2bceaa3894c3d9509ab99e0 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 10 Jun 2022 18:18:18 +0900
Subject: [PATCH 5356/5547] Add circle gameplay test coverage

---
 .../Visual/Settings/TestSceneLatencyCertifierScreen.cs    | 6 ++++++
 osu.Game/Screens/Utility/LatencyCertifierScreen.cs        | 8 ++++----
 2 files changed, 10 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Tests/Visual/Settings/TestSceneLatencyCertifierScreen.cs b/osu.Game.Tests/Visual/Settings/TestSceneLatencyCertifierScreen.cs
index af6681e9cf..079796df2e 100644
--- a/osu.Game.Tests/Visual/Settings/TestSceneLatencyCertifierScreen.cs
+++ b/osu.Game.Tests/Visual/Settings/TestSceneLatencyCertifierScreen.cs
@@ -24,6 +24,12 @@ namespace osu.Game.Tests.Visual.Settings
             AddUntilStep("wait for load", () => latencyCertifier.IsLoaded);
         }
 
+        [Test]
+        public void TestCircleGameplay()
+        {
+            AddStep("set visual mode to circles", () => latencyCertifier.VisualMode.Value = LatencyVisualMode.CircleGameplay);
+        }
+
         [Test]
         public void TestCertification()
         {
diff --git a/osu.Game/Screens/Utility/LatencyCertifierScreen.cs b/osu.Game/Screens/Utility/LatencyCertifierScreen.cs
index 00821ab773..658e0537c6 100644
--- a/osu.Game/Screens/Utility/LatencyCertifierScreen.cs
+++ b/osu.Game/Screens/Utility/LatencyCertifierScreen.cs
@@ -63,7 +63,7 @@ namespace osu.Game.Screens.Utility
         [Resolved]
         private FrameworkConfigManager config { get; set; } = null!;
 
-        private readonly Bindable<LatencyVisualMode> visualMode = new Bindable<LatencyVisualMode>();
+        public readonly Bindable<LatencyVisualMode> VisualMode = new Bindable<LatencyVisualMode>();
 
         private const int rounds_to_complete = 5;
 
@@ -187,7 +187,7 @@ Do whatever you need to try and perceive the difference in latency, then choose
             switch (e.Key)
             {
                 case Key.Space:
-                    visualMode.Value = (LatencyVisualMode)(((int)visualMode.Value + 1) % 3);
+                    VisualMode.Value = (LatencyVisualMode)(((int)VisualMode.Value + 1) % 3);
                     return true;
 
                 case Key.Tab:
@@ -396,14 +396,14 @@ Do whatever you need to try and perceive the difference in latency, then choose
                 new LatencyArea(Key.Number1, betterSide == 1 ? mapDifficultyToTargetFrameRate(DifficultyLevel) : (int?)null)
                 {
                     Width = 0.5f,
-                    VisualMode = { BindTarget = visualMode },
+                    VisualMode = { BindTarget = VisualMode },
                     IsActiveArea = { Value = true },
                     ReportUserBest = () => recordResult(betterSide == 0),
                 },
                 new LatencyArea(Key.Number2, betterSide == 0 ? mapDifficultyToTargetFrameRate(DifficultyLevel) : (int?)null)
                 {
                     Width = 0.5f,
-                    VisualMode = { BindTarget = visualMode },
+                    VisualMode = { BindTarget = VisualMode },
                     Anchor = Anchor.TopRight,
                     Origin = Anchor.TopRight,
                     ReportUserBest = () => recordResult(betterSide == 1)

From 5c7d29cd31de5b62ba70cd37ff1904b2747fcd73 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 10 Jun 2022 18:18:24 +0900
Subject: [PATCH 5357/5547] Remove dependency on game-wide audio

---
 osu.Game/Screens/Utility/CircleGameplay.cs | 38 +++++++++++++++-------
 1 file changed, 27 insertions(+), 11 deletions(-)

diff --git a/osu.Game/Screens/Utility/CircleGameplay.cs b/osu.Game/Screens/Utility/CircleGameplay.cs
index c97b5dd7a7..2847f1b84d 100644
--- a/osu.Game/Screens/Utility/CircleGameplay.cs
+++ b/osu.Game/Screens/Utility/CircleGameplay.cs
@@ -4,14 +4,11 @@
 #nullable enable
 using System;
 using System.Collections.Generic;
-using osu.Framework.Audio.Track;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Input.Events;
-using osu.Game.Beatmaps.ControlPoints;
 using osu.Game.Graphics;
-using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Scoring;
@@ -20,7 +17,7 @@ using osuTK.Graphics;
 
 namespace osu.Game.Screens.Utility
 {
-    public class CircleGameplay : BeatSyncedContainer
+    public class CircleGameplay : CompositeDrawable
     {
         private int nextLocation;
 
@@ -28,6 +25,12 @@ namespace osu.Game.Screens.Utility
 
         private readonly List<HitEvent> hitEvents = new List<HitEvent>();
 
+        private int? lastGeneratedBeat;
+
+        private const double beat_length = 500;
+        private const double approach_rate_milliseconds = 100;
+        private const float spacing = 0.1f;
+
         protected override void LoadComplete()
         {
             base.LoadComplete();
@@ -43,16 +46,26 @@ namespace osu.Game.Screens.Utility
             };
         }
 
-        protected override void OnNewBeat(int beatIndex, TimingControlPoint timingPoint, EffectControlPoint effectPoint, ChannelAmplitudes amplitudes)
+        protected override void Update()
         {
-            base.OnNewBeat(beatIndex, timingPoint, effectPoint, amplitudes);
+            base.Update();
 
+            int nextBeat = (int)(Clock.CurrentTime / beat_length);
+
+            if (lastGeneratedBeat == null || nextBeat != lastGeneratedBeat)
+            {
+                // generate four beats ahead to allow time for beats to display.
+                newBeat(nextBeat + 4);
+                lastGeneratedBeat = nextBeat;
+            }
+        }
+
+        private void newBeat(int index)
+        {
             nextLocation++;
 
             Vector2 location;
 
-            const float spacing = 0.1f;
-
             const float spacing_low = 0.5f - spacing;
             const float spacing_high = 0.5f + spacing;
 
@@ -75,7 +88,7 @@ namespace osu.Game.Screens.Utility
                     break;
             }
 
-            AddInternal(new SampleHitCircle(Clock.CurrentTime + timingPoint.BeatLength)
+            AddInternal(new SampleHitCircle(index * beat_length)
             {
                 RelativePositionAxes = Axes.Both,
                 Position = location,
@@ -113,6 +126,8 @@ namespace osu.Game.Screens.Utility
 
                 AutoSizeAxes = Axes.Both;
 
+                AlwaysPresent = true;
+
                 InternalChildren = new Drawable[]
                 {
                     circle = new Circle
@@ -171,9 +186,10 @@ namespace osu.Game.Screens.Utility
             {
                 base.Update();
 
-                approach.Scale = new Vector2((float)MathHelper.Clamp((HitTime - Clock.CurrentTime) / 60, 1, 100));
+                approach.Scale = new Vector2(1 + (float)MathHelper.Clamp((HitTime - Clock.CurrentTime) / approach_rate_milliseconds, 0, 100));
+                Alpha = (float)MathHelper.Clamp((Clock.CurrentTime - HitTime + 600) / 400, 0, 1);
 
-                if (Clock.CurrentTime > HitTime + 80)
+                if (Clock.CurrentTime > HitTime + 200)
                     Expire();
             }
         }

From 5deaa42e9feaa8b9dfe5610e32225015d2f95df0 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 10 Jun 2022 18:20:15 +0900
Subject: [PATCH 5358/5547] Stop music on entering latency certification screen

---
 osu.Game/Screens/Utility/LatencyCertifierScreen.cs | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/osu.Game/Screens/Utility/LatencyCertifierScreen.cs b/osu.Game/Screens/Utility/LatencyCertifierScreen.cs
index 658e0537c6..2570db0e24 100644
--- a/osu.Game/Screens/Utility/LatencyCertifierScreen.cs
+++ b/osu.Game/Screens/Utility/LatencyCertifierScreen.cs
@@ -87,6 +87,9 @@ namespace osu.Game.Screens.Utility
         [Resolved]
         private GameHost host { get; set; } = null!;
 
+        [Resolved]
+        private MusicController musicController { get; set; } = null!;
+
         public LatencyCertifierScreen()
         {
             InternalChildren = new Drawable[]
@@ -166,6 +169,8 @@ Do whatever you need to try and perceive the difference in latency, then choose
             config.SetValue(FrameworkSetting.FrameSync, FrameSync.Unlimited);
             host.UpdateThread.ActiveHz = target_host_update_frames;
             host.AllowBenchmarkUnlimitedFrames = true;
+
+            musicController.Stop();
         }
 
         public override bool OnExiting(ScreenExitEvent e)

From ba14d646c337a0e31e021a6077a2417e5f3d7729 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 10 Jun 2022 18:27:58 +0900
Subject: [PATCH 5359/5547] Add static configuration

---
 osu.Game/Screens/Utility/CircleGameplay.cs | 79 ++++++++++++++++------
 1 file changed, 59 insertions(+), 20 deletions(-)

diff --git a/osu.Game/Screens/Utility/CircleGameplay.cs b/osu.Game/Screens/Utility/CircleGameplay.cs
index 2847f1b84d..91bf582fd6 100644
--- a/osu.Game/Screens/Utility/CircleGameplay.cs
+++ b/osu.Game/Screens/Utility/CircleGameplay.cs
@@ -4,12 +4,15 @@
 #nullable enable
 using System;
 using System.Collections.Generic;
+using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
+using osu.Framework.Graphics.UserInterface;
 using osu.Framework.Input.Events;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
+using osu.Game.Overlays.Settings;
 using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Scoring;
 using osuTK;
@@ -25,11 +28,11 @@ namespace osu.Game.Screens.Utility
 
         private readonly List<HitEvent> hitEvents = new List<HitEvent>();
 
-        private int? lastGeneratedBeat;
+        private double? lastGeneratedBeatTime;
 
-        private const double beat_length = 500;
-        private const double approach_rate_milliseconds = 100;
-        private const float spacing = 0.1f;
+        private static readonly BindableDouble beat_length = new BindableDouble(500) { MinValue = 200, MaxValue = 1000 };
+        private static readonly BindableDouble approach_rate_milliseconds = new BindableDouble(100) { MinValue = 50, MaxValue = 500 };
+        private static readonly BindableFloat spacing = new BindableFloat(0.2f) { MinValue = 0.05f, MaxValue = 0.4f };
 
         protected override void LoadComplete()
         {
@@ -37,12 +40,40 @@ namespace osu.Game.Screens.Utility
 
             InternalChildren = new Drawable[]
             {
+                new FillFlowContainer
+                {
+                    AutoSizeAxes = Axes.Y,
+                    Width = 400,
+                    Spacing = new Vector2(2),
+                    Direction = FillDirection.Vertical,
+                    Anchor = Anchor.Centre,
+                    Origin = Anchor.Centre,
+                    Children = new Drawable[]
+                    {
+                        new SettingsSlider<double>
+                        {
+                            LabelText = "time spacing",
+                            Current = beat_length
+                        },
+                        new SettingsSlider<float>
+                        {
+                            LabelText = "visual spacing",
+                            Current = spacing
+                        },
+                        new SettingsSlider<double>
+                        {
+                            LabelText = "approach time",
+                            Current = approach_rate_milliseconds
+                        },
+                    }
+                },
                 unstableRate = new OsuSpriteText
                 {
                     Anchor = Anchor.Centre,
                     Origin = Anchor.Centre,
-                    Font = OsuFont.Default.With(size: 24)
-                }
+                    Font = OsuFont.Default.With(size: 24),
+                    Y = -100,
+                },
             };
         }
 
@@ -50,45 +81,53 @@ namespace osu.Game.Screens.Utility
         {
             base.Update();
 
-            int nextBeat = (int)(Clock.CurrentTime / beat_length);
+            // We want to generate a few hit objects ahead of the current time (to allow them to animate).
 
-            if (lastGeneratedBeat == null || nextBeat != lastGeneratedBeat)
+            int nextBeat = (int)(Clock.CurrentTime / beat_length.Value) + 1;
+
+            double generateUpTo = (nextBeat + 2) * beat_length.Value;
+
+            while (lastGeneratedBeatTime == null || lastGeneratedBeatTime < generateUpTo)
             {
-                // generate four beats ahead to allow time for beats to display.
-                newBeat(nextBeat + 4);
-                lastGeneratedBeat = nextBeat;
+                double time = ++nextBeat * beat_length.Value;
+
+                if (time <= lastGeneratedBeatTime)
+                    continue;
+
+                newBeat(time);
+                lastGeneratedBeatTime = time;
             }
         }
 
-        private void newBeat(int index)
+        private void newBeat(double time)
         {
             nextLocation++;
 
             Vector2 location;
 
-            const float spacing_low = 0.5f - spacing;
-            const float spacing_high = 0.5f + spacing;
+            float spacingLow = 0.5f - spacing.Value;
+            float spacingHigh = 0.5f + spacing.Value;
 
             switch (nextLocation % 4)
             {
                 default:
-                    location = new Vector2(spacing_low, spacing_low);
+                    location = new Vector2(spacingLow, spacingLow);
                     break;
 
                 case 1:
-                    location = new Vector2(spacing_high, spacing_high);
+                    location = new Vector2(spacingHigh, spacingHigh);
                     break;
 
                 case 2:
-                    location = new Vector2(spacing_high, spacing_low);
+                    location = new Vector2(spacingHigh, spacingLow);
                     break;
 
                 case 3:
-                    location = new Vector2(spacing_low, spacing_high);
+                    location = new Vector2(spacingLow, spacingHigh);
                     break;
             }
 
-            AddInternal(new SampleHitCircle(index * beat_length)
+            AddInternal(new SampleHitCircle(time)
             {
                 RelativePositionAxes = Axes.Both,
                 Position = location,
@@ -186,7 +225,7 @@ namespace osu.Game.Screens.Utility
             {
                 base.Update();
 
-                approach.Scale = new Vector2(1 + (float)MathHelper.Clamp((HitTime - Clock.CurrentTime) / approach_rate_milliseconds, 0, 100));
+                approach.Scale = new Vector2(1 + (float)MathHelper.Clamp((HitTime - Clock.CurrentTime) / approach_rate_milliseconds.Value, 0, 100));
                 Alpha = (float)MathHelper.Clamp((Clock.CurrentTime - HitTime + 600) / 400, 0, 1);
 
                 if (Clock.CurrentTime > HitTime + 200)

From 7f4a54096f41fef7073153df5bbc8ce8e7bc30af Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 10 Jun 2022 18:37:53 +0900
Subject: [PATCH 5360/5547] Fix circles in the future being hittable

---
 osu.Game/Screens/Utility/CircleGameplay.cs | 14 ++++++++++----
 1 file changed, 10 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Screens/Utility/CircleGameplay.cs b/osu.Game/Screens/Utility/CircleGameplay.cs
index 91bf582fd6..c55c10dcb8 100644
--- a/osu.Game/Screens/Utility/CircleGameplay.cs
+++ b/osu.Game/Screens/Utility/CircleGameplay.cs
@@ -203,6 +203,9 @@ namespace osu.Game.Screens.Utility
                 if (HitEvent != null)
                     return false;
 
+                if (Math.Abs(Clock.CurrentTime - HitTime) > 200)
+                    return false;
+
                 approach.Expire();
 
                 circle
@@ -225,11 +228,14 @@ namespace osu.Game.Screens.Utility
             {
                 base.Update();
 
-                approach.Scale = new Vector2(1 + (float)MathHelper.Clamp((HitTime - Clock.CurrentTime) / approach_rate_milliseconds.Value, 0, 100));
-                Alpha = (float)MathHelper.Clamp((Clock.CurrentTime - HitTime + 600) / 400, 0, 1);
+                if (HitEvent == null)
+                {
+                    approach.Scale = new Vector2(1 + (float)MathHelper.Clamp((HitTime - Clock.CurrentTime) / approach_rate_milliseconds.Value, 0, 100));
+                    Alpha = (float)MathHelper.Clamp((Clock.CurrentTime - HitTime + 600) / 400, 0, 1);
 
-                if (Clock.CurrentTime > HitTime + 200)
-                    Expire();
+                    if (Clock.CurrentTime > HitTime + 200)
+                        Expire();
+                }
             }
         }
     }

From 2f1c331f65027aed7c3dafaf89d8717521728af9 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 10 Jun 2022 19:33:01 +0900
Subject: [PATCH 5361/5547] Move shared logic to `LatencySampleComponent` and
 implement key support for circle gameplay

---
 osu.Game/Screens/Utility/CircleGameplay.cs    | 56 ++++++++++++-------
 osu.Game/Screens/Utility/LatencyArea.cs       |  9 +--
 .../LatencyCursorContainer.cs                 | 24 +++-----
 .../SampleComponents/LatencyMovableBox.cs     | 36 +++---------
 .../LatencySampleComponent.cs                 | 43 ++++++++++++++
 5 files changed, 101 insertions(+), 67 deletions(-)
 create mode 100644 osu.Game/Screens/Utility/SampleComponents/LatencySampleComponent.cs

diff --git a/osu.Game/Screens/Utility/CircleGameplay.cs b/osu.Game/Screens/Utility/CircleGameplay.cs
index c55c10dcb8..bc3342fa3f 100644
--- a/osu.Game/Screens/Utility/CircleGameplay.cs
+++ b/osu.Game/Screens/Utility/CircleGameplay.cs
@@ -8,13 +8,14 @@ using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
-using osu.Framework.Graphics.UserInterface;
 using osu.Framework.Input.Events;
+using osu.Framework.Input.States;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Overlays.Settings;
 using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Scoring;
+using osu.Game.Screens.Utility.SampleComponents;
 using osuTK;
 using osuTK.Graphics;
 
@@ -141,7 +142,7 @@ namespace osu.Game.Screens.Utility
             unstableRate.Text = $"{hitEvents.CalculateUnstableRate():N1}";
         }
 
-        public class SampleHitCircle : CompositeDrawable
+        public class SampleHitCircle : LatencySampleComponent
         {
             public HitEvent? HitEvent;
 
@@ -198,6 +199,8 @@ namespace osu.Game.Screens.Utility
                 };
             }
 
+            protected override bool OnHover(HoverEvent e) => true;
+
             protected override bool OnMouseDown(MouseDownEvent e)
             {
                 if (HitEvent != null)
@@ -206,6 +209,37 @@ namespace osu.Game.Screens.Utility
                 if (Math.Abs(Clock.CurrentTime - HitTime) > 200)
                     return false;
 
+                attemptHit();
+                return true;
+            }
+
+            protected override bool OnKeyDown(KeyDownEvent e)
+            {
+                if (!IsActive.Value)
+                    return false;
+
+                if (IsHovered)
+                    attemptHit();
+                return base.OnKeyDown(e);
+            }
+
+            protected override void UpdateAtLimitedRate(InputState inputState)
+            {
+                if (HitEvent == null)
+                {
+                    approach.Scale = new Vector2(1 + (float)MathHelper.Clamp((HitTime - Clock.CurrentTime) / approach_rate_milliseconds.Value, 0, 100));
+                    Alpha = (float)MathHelper.Clamp((Clock.CurrentTime - HitTime + 600) / 400, 0, 1);
+
+                    if (Clock.CurrentTime > HitTime + 200)
+                        Expire();
+                }
+            }
+
+            private void attemptHit() => Schedule(() =>
+            {
+                if (HitEvent != null)
+                    return;
+
                 approach.Expire();
 
                 circle
@@ -220,23 +254,7 @@ namespace osu.Game.Screens.Utility
                 Hit?.Invoke(HitEvent.Value);
 
                 this.Delay(200).Expire();
-
-                return true;
-            }
-
-            protected override void Update()
-            {
-                base.Update();
-
-                if (HitEvent == null)
-                {
-                    approach.Scale = new Vector2(1 + (float)MathHelper.Clamp((HitTime - Clock.CurrentTime) / approach_rate_milliseconds.Value, 0, 100));
-                    Alpha = (float)MathHelper.Clamp((Clock.CurrentTime - HitTime + 600) / 400, 0, 1);
-
-                    if (Clock.CurrentTime > HitTime + 200)
-                        Expire();
-                }
-            }
+            });
         }
     }
 }
diff --git a/osu.Game/Screens/Utility/LatencyArea.cs b/osu.Game/Screens/Utility/LatencyArea.cs
index 5b48a10a49..21688f0b0c 100644
--- a/osu.Game/Screens/Utility/LatencyArea.cs
+++ b/osu.Game/Screens/Utility/LatencyArea.cs
@@ -16,6 +16,7 @@ using osuTK.Input;
 
 namespace osu.Game.Screens.Utility
 {
+    [Cached]
     public class LatencyArea : CompositeDrawable
     {
         [Resolved]
@@ -82,11 +83,11 @@ namespace osu.Game.Screens.Utility
                     case LatencyVisualMode.Simple:
                         visualContent.Children = new Drawable[]
                         {
-                            new LatencyMovableBox(IsActiveArea)
+                            new LatencyMovableBox
                             {
                                 RelativeSizeAxes = Axes.Both,
                             },
-                            new LatencyCursorContainer(IsActiveArea)
+                            new LatencyCursorContainer
                             {
                                 RelativeSizeAxes = Axes.Both,
                             },
@@ -100,7 +101,7 @@ namespace osu.Game.Screens.Utility
                             {
                                 RelativeSizeAxes = Axes.Both,
                             },
-                            new LatencyCursorContainer(IsActiveArea)
+                            new LatencyCursorContainer
                             {
                                 RelativeSizeAxes = Axes.Both,
                             },
@@ -114,7 +115,7 @@ namespace osu.Game.Screens.Utility
                             {
                                 RelativeSizeAxes = Axes.Both,
                             },
-                            new LatencyCursorContainer(IsActiveArea)
+                            new LatencyCursorContainer
                             {
                                 RelativeSizeAxes = Axes.Both,
                             },
diff --git a/osu.Game/Screens/Utility/SampleComponents/LatencyCursorContainer.cs b/osu.Game/Screens/Utility/SampleComponents/LatencyCursorContainer.cs
index 753310c3b3..e4c2b504cb 100644
--- a/osu.Game/Screens/Utility/SampleComponents/LatencyCursorContainer.cs
+++ b/osu.Game/Screens/Utility/SampleComponents/LatencyCursorContainer.cs
@@ -3,31 +3,25 @@
 
 #nullable enable
 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;
 using osu.Framework.Input.Events;
+using osu.Framework.Input.States;
 using osu.Game.Overlays;
 using osuTK;
 using osuTK.Input;
 
 namespace osu.Game.Screens.Utility.SampleComponents
 {
-    public class LatencyCursorContainer : CompositeDrawable
+    public class LatencyCursorContainer : LatencySampleComponent
     {
         private Circle cursor = null!;
-        private InputManager inputManager = null!;
-
-        private readonly BindableBool isActive;
 
         [Resolved]
         private OverlayColourProvider overlayColourProvider { get; set; } = null!;
 
-        public LatencyCursorContainer(BindableBool isActive)
+        public LatencyCursorContainer()
         {
-            this.isActive = isActive;
             Masking = true;
         }
 
@@ -41,27 +35,23 @@ namespace osu.Game.Screens.Utility.SampleComponents
                 Origin = Anchor.Centre,
                 Colour = overlayColourProvider.Colour2,
             };
-
-            inputManager = GetContainingInputManager();
         }
 
         protected override bool OnHover(HoverEvent e) => false;
 
-        protected override void Update()
+        protected override void UpdateAtLimitedRate(InputState inputState)
         {
-            cursor.Colour = inputManager.CurrentState.Mouse.IsPressed(MouseButton.Left) ? overlayColourProvider.Content1 : overlayColourProvider.Colour2;
+            cursor.Colour = inputState.Mouse.IsPressed(MouseButton.Left) ? overlayColourProvider.Content1 : overlayColourProvider.Colour2;
 
-            if (isActive.Value)
+            if (IsActive.Value)
             {
-                cursor.Position = ToLocalSpace(inputManager.CurrentState.Mouse.Position);
+                cursor.Position = ToLocalSpace(inputState.Mouse.Position);
                 cursor.Alpha = 1;
             }
             else
             {
                 cursor.Alpha = 0;
             }
-
-            base.Update();
         }
     }
 }
diff --git a/osu.Game/Screens/Utility/SampleComponents/LatencyMovableBox.cs b/osu.Game/Screens/Utility/SampleComponents/LatencyMovableBox.cs
index 418d45489f..56c8aa2ed5 100644
--- a/osu.Game/Screens/Utility/SampleComponents/LatencyMovableBox.cs
+++ b/osu.Game/Screens/Utility/SampleComponents/LatencyMovableBox.cs
@@ -2,47 +2,31 @@
 // See the LICENCE file in the repository root for full licence text.
 
 #nullable enable
-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;
 using osu.Framework.Input.Events;
-using osu.Game.Overlays;
+using osu.Framework.Input.States;
 using osuTK;
 using osuTK.Input;
 
 namespace osu.Game.Screens.Utility.SampleComponents
 {
-    public class LatencyMovableBox : CompositeDrawable
+    public class LatencyMovableBox : LatencySampleComponent
     {
         private Box box = null!;
-        private InputManager inputManager = null!;
-
-        private readonly BindableBool isActive;
-
-        [Resolved]
-        private OverlayColourProvider overlayColourProvider { get; set; } = null!;
-
-        public LatencyMovableBox(BindableBool isActive)
-        {
-            this.isActive = isActive;
-        }
 
         protected override void LoadComplete()
         {
             base.LoadComplete();
 
-            inputManager = GetContainingInputManager();
-
             InternalChild = box = new Box
             {
                 Size = new Vector2(40),
                 RelativePositionAxes = Axes.Both,
                 Position = new Vector2(0.5f),
                 Origin = Anchor.Centre,
-                Colour = overlayColourProvider.Colour1,
+                Colour = OverlayColourProvider.Colour1,
             };
         }
 
@@ -50,14 +34,12 @@ namespace osu.Game.Screens.Utility.SampleComponents
 
         private double? lastFrameTime;
 
-        protected override void Update()
+        protected override void UpdateAtLimitedRate(InputState inputState)
         {
-            base.Update();
-
-            if (!isActive.Value)
+            if (!IsActive.Value)
             {
                 lastFrameTime = null;
-                box.Colour = overlayColourProvider.Colour1;
+                box.Colour = OverlayColourProvider.Colour1;
                 return;
             }
 
@@ -65,9 +47,9 @@ namespace osu.Game.Screens.Utility.SampleComponents
             {
                 float movementAmount = (float)(Clock.CurrentTime - lastFrameTime) / 400;
 
-                var buttons = inputManager.CurrentState.Keyboard.Keys;
+                var buttons = inputState.Keyboard.Keys;
 
-                box.Colour = buttons.HasAnyButtonPressed ? overlayColourProvider.Content1 : overlayColourProvider.Colour1;
+                box.Colour = buttons.HasAnyButtonPressed ? OverlayColourProvider.Content1 : OverlayColourProvider.Colour1;
 
                 foreach (var key in buttons)
                 {
diff --git a/osu.Game/Screens/Utility/SampleComponents/LatencySampleComponent.cs b/osu.Game/Screens/Utility/SampleComponents/LatencySampleComponent.cs
new file mode 100644
index 0000000000..03f6b46852
--- /dev/null
+++ b/osu.Game/Screens/Utility/SampleComponents/LatencySampleComponent.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.
+
+#nullable enable
+
+using osu.Framework.Allocation;
+using osu.Framework.Bindables;
+using osu.Framework.Graphics.Containers;
+using osu.Framework.Input;
+using osu.Framework.Input.States;
+using osu.Game.Overlays;
+
+namespace osu.Game.Screens.Utility.SampleComponents
+{
+    public abstract class LatencySampleComponent : CompositeDrawable
+    {
+        protected readonly BindableBool IsActive = new BindableBool();
+
+        private InputManager inputManager = null!;
+
+        [Resolved]
+        private LatencyArea latencyArea { get; set; } = null!;
+
+        [Resolved]
+        protected OverlayColourProvider OverlayColourProvider { get; private set; } = null!;
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            inputManager = GetContainingInputManager();
+            IsActive.BindTo(latencyArea.IsActiveArea);
+        }
+
+        protected sealed override void Update()
+        {
+            base.Update();
+            UpdateAtLimitedRate(inputManager.CurrentState);
+        }
+
+        protected abstract void UpdateAtLimitedRate(InputState inputState);
+    }
+}

From 41d16c613da5a93cc48b97f8b62ab00ff480bd11 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 10 Jun 2022 19:35:21 +0900
Subject: [PATCH 5362/5547] Fix being able to hit way too early using keyboard

---
 osu.Game/Screens/Utility/CircleGameplay.cs | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/osu.Game/Screens/Utility/CircleGameplay.cs b/osu.Game/Screens/Utility/CircleGameplay.cs
index bc3342fa3f..d31b98fe6e 100644
--- a/osu.Game/Screens/Utility/CircleGameplay.cs
+++ b/osu.Game/Screens/Utility/CircleGameplay.cs
@@ -218,6 +218,9 @@ namespace osu.Game.Screens.Utility
                 if (!IsActive.Value)
                     return false;
 
+                if (Math.Abs(Clock.CurrentTime - HitTime) > 200)
+                    return false;
+
                 if (IsHovered)
                     attemptHit();
                 return base.OnKeyDown(e);
@@ -240,6 +243,10 @@ namespace osu.Game.Screens.Utility
                 if (HitEvent != null)
                     return;
 
+                // in case it was hit outside of display range, show immediately
+                // so the user isn't confused.
+                this.FadeIn();
+
                 approach.Expire();
 
                 circle

From a6fd61c4448a4e77495f41a95f04a8abcaeb6999 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 10 Jun 2022 19:42:07 +0900
Subject: [PATCH 5363/5547] Default to circle gameplay mode

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

diff --git a/osu.Game/Screens/Utility/LatencyVisualMode.cs b/osu.Game/Screens/Utility/LatencyVisualMode.cs
index 55dab86f9e..cc15f79be8 100644
--- a/osu.Game/Screens/Utility/LatencyVisualMode.cs
+++ b/osu.Game/Screens/Utility/LatencyVisualMode.cs
@@ -6,8 +6,8 @@ namespace osu.Game.Screens.Utility
 {
     public enum LatencyVisualMode
     {
-        Simple,
         CircleGameplay,
         ScrollingGameplay,
+        Simple,
     }
 }

From ef5c1a1ecbd51d82b92fc6490c540a4c002d3fd3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 10 Jun 2022 19:42:17 +0900
Subject: [PATCH 5364/5547] Improve visuals of circle gameplay mode

---
 osu.Game/Screens/Utility/CircleGameplay.cs | 17 +++++++++--------
 1 file changed, 9 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Screens/Utility/CircleGameplay.cs b/osu.Game/Screens/Utility/CircleGameplay.cs
index d31b98fe6e..9fb8eb2761 100644
--- a/osu.Game/Screens/Utility/CircleGameplay.cs
+++ b/osu.Game/Screens/Utility/CircleGameplay.cs
@@ -4,6 +4,7 @@
 #nullable enable
 using System;
 using System.Collections.Generic;
+using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
@@ -17,7 +18,6 @@ using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Scoring;
 using osu.Game.Screens.Utility.SampleComponents;
 using osuTK;
-using osuTK.Graphics;
 
 namespace osu.Game.Screens.Utility
 {
@@ -150,8 +150,8 @@ namespace osu.Game.Screens.Utility
 
             public readonly double HitTime;
 
-            private readonly CircularContainer approach;
-            private readonly Circle circle;
+            private CircularContainer approach = null!;
+            private Circle circle = null!;
 
             private const float size = 100;
 
@@ -163,23 +163,25 @@ namespace osu.Game.Screens.Utility
                 HitTime = hitTime;
 
                 Origin = Anchor.Centre;
-
                 AutoSizeAxes = Axes.Both;
-
                 AlwaysPresent = true;
+            }
 
+            [BackgroundDependencyLoader]
+            private void load()
+            {
                 InternalChildren = new Drawable[]
                 {
                     circle = new Circle
                     {
-                        Colour = Color4.White,
+                        Colour = OverlayColourProvider.Content1,
                         Size = new Vector2(size),
                         Anchor = Anchor.Centre,
                         Origin = Anchor.Centre,
                     },
                     approach = new CircularContainer
                     {
-                        BorderColour = Color4.Yellow,
+                        BorderColour = OverlayColourProvider.Colour1,
                         Size = new Vector2(size),
                         Masking = true,
                         BorderThickness = 4,
@@ -189,7 +191,6 @@ namespace osu.Game.Screens.Utility
                         {
                             new Box
                             {
-                                Colour = Color4.Black,
                                 Alpha = 0,
                                 AlwaysPresent = true,
                                 RelativeSizeAxes = Axes.Both,

From 837958b254943d025914db3c664ba1784137aeba Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 10 Jun 2022 19:43:09 +0900
Subject: [PATCH 5365/5547] Remove scrolling gameplay mode for now

---
 osu.Game/Screens/Utility/LatencyArea.cs       | 14 --------------
 osu.Game/Screens/Utility/LatencyVisualMode.cs |  1 -
 2 files changed, 15 deletions(-)

diff --git a/osu.Game/Screens/Utility/LatencyArea.cs b/osu.Game/Screens/Utility/LatencyArea.cs
index 21688f0b0c..3b9e95ce16 100644
--- a/osu.Game/Screens/Utility/LatencyArea.cs
+++ b/osu.Game/Screens/Utility/LatencyArea.cs
@@ -108,20 +108,6 @@ namespace osu.Game.Screens.Utility
                         };
                         break;
 
-                    case LatencyVisualMode.ScrollingGameplay:
-                        visualContent.Children = new Drawable[]
-                        {
-                            new ScrollingGameplay
-                            {
-                                RelativeSizeAxes = Axes.Both,
-                            },
-                            new LatencyCursorContainer
-                            {
-                                RelativeSizeAxes = Axes.Both,
-                            },
-                        };
-                        break;
-
                     default:
                         throw new ArgumentOutOfRangeException();
                 }
diff --git a/osu.Game/Screens/Utility/LatencyVisualMode.cs b/osu.Game/Screens/Utility/LatencyVisualMode.cs
index cc15f79be8..f9f51f0829 100644
--- a/osu.Game/Screens/Utility/LatencyVisualMode.cs
+++ b/osu.Game/Screens/Utility/LatencyVisualMode.cs
@@ -7,7 +7,6 @@ namespace osu.Game.Screens.Utility
     public enum LatencyVisualMode
     {
         CircleGameplay,
-        ScrollingGameplay,
         Simple,
     }
 }

From 18f74b2840fd2e3ecc8bb8322262e5fa5c3a6a98 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 10 Jun 2022 20:04:51 +0900
Subject: [PATCH 5366/5547] Move settings and bindables to a sane location

---
 osu.Game/Screens/Utility/CircleGameplay.cs    | 68 +++++++------------
 .../Screens/Utility/LatencyCertifierScreen.cs | 60 ++++++++++++++--
 .../LatencySampleComponent.cs                 | 12 ++++
 3 files changed, 90 insertions(+), 50 deletions(-)

diff --git a/osu.Game/Screens/Utility/CircleGameplay.cs b/osu.Game/Screens/Utility/CircleGameplay.cs
index 9fb8eb2761..4bfc10548f 100644
--- a/osu.Game/Screens/Utility/CircleGameplay.cs
+++ b/osu.Game/Screens/Utility/CircleGameplay.cs
@@ -5,7 +5,6 @@
 using System;
 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;
@@ -13,7 +12,6 @@ using osu.Framework.Input.Events;
 using osu.Framework.Input.States;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
-using osu.Game.Overlays.Settings;
 using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Scoring;
 using osu.Game.Screens.Utility.SampleComponents;
@@ -21,7 +19,7 @@ using osuTK;
 
 namespace osu.Game.Screens.Utility
 {
-    public class CircleGameplay : CompositeDrawable
+    public class CircleGameplay : LatencySampleComponent
     {
         private int nextLocation;
 
@@ -31,9 +29,7 @@ namespace osu.Game.Screens.Utility
 
         private double? lastGeneratedBeatTime;
 
-        private static readonly BindableDouble beat_length = new BindableDouble(500) { MinValue = 200, MaxValue = 1000 };
-        private static readonly BindableDouble approach_rate_milliseconds = new BindableDouble(100) { MinValue = 50, MaxValue = 500 };
-        private static readonly BindableFloat spacing = new BindableFloat(0.2f) { MinValue = 0.05f, MaxValue = 0.4f };
+        private Container circles = null!;
 
         protected override void LoadComplete()
         {
@@ -41,33 +37,6 @@ namespace osu.Game.Screens.Utility
 
             InternalChildren = new Drawable[]
             {
-                new FillFlowContainer
-                {
-                    AutoSizeAxes = Axes.Y,
-                    Width = 400,
-                    Spacing = new Vector2(2),
-                    Direction = FillDirection.Vertical,
-                    Anchor = Anchor.Centre,
-                    Origin = Anchor.Centre,
-                    Children = new Drawable[]
-                    {
-                        new SettingsSlider<double>
-                        {
-                            LabelText = "time spacing",
-                            Current = beat_length
-                        },
-                        new SettingsSlider<float>
-                        {
-                            LabelText = "visual spacing",
-                            Current = spacing
-                        },
-                        new SettingsSlider<double>
-                        {
-                            LabelText = "approach time",
-                            Current = approach_rate_milliseconds
-                        },
-                    }
-                },
                 unstableRate = new OsuSpriteText
                 {
                     Anchor = Anchor.Centre,
@@ -75,22 +44,31 @@ namespace osu.Game.Screens.Utility
                     Font = OsuFont.Default.With(size: 24),
                     Y = -100,
                 },
+                circles = new Container
+                {
+                    RelativeSizeAxes = Axes.Both,
+                },
             };
+
+            SampleBPM.BindValueChanged(_ =>
+            {
+                circles.Clear();
+                lastGeneratedBeatTime = null;
+            });
         }
 
-        protected override void Update()
+        protected override void UpdateAtLimitedRate(InputState inputState)
         {
-            base.Update();
+            double beatLength = 60000 / SampleBPM.Value;
+
+            int nextBeat = (int)(Clock.CurrentTime / beatLength) + 1;
 
             // We want to generate a few hit objects ahead of the current time (to allow them to animate).
-
-            int nextBeat = (int)(Clock.CurrentTime / beat_length.Value) + 1;
-
-            double generateUpTo = (nextBeat + 2) * beat_length.Value;
+            double generateUpTo = (nextBeat + 2) * beatLength;
 
             while (lastGeneratedBeatTime == null || lastGeneratedBeatTime < generateUpTo)
             {
-                double time = ++nextBeat * beat_length.Value;
+                double time = ++nextBeat * beatLength;
 
                 if (time <= lastGeneratedBeatTime)
                     continue;
@@ -106,8 +84,8 @@ namespace osu.Game.Screens.Utility
 
             Vector2 location;
 
-            float spacingLow = 0.5f - spacing.Value;
-            float spacingHigh = 0.5f + spacing.Value;
+            float spacingLow = 0.5f - SampleVisualSpacing.Value;
+            float spacingHigh = 0.5f + SampleVisualSpacing.Value;
 
             switch (nextLocation % 4)
             {
@@ -128,7 +106,7 @@ namespace osu.Game.Screens.Utility
                     break;
             }
 
-            AddInternal(new SampleHitCircle(time)
+            circles.Add(new SampleHitCircle(time)
             {
                 RelativePositionAxes = Axes.Both,
                 Position = location,
@@ -139,7 +117,7 @@ namespace osu.Game.Screens.Utility
         private void hit(HitEvent h)
         {
             hitEvents.Add(h);
-            unstableRate.Text = $"{hitEvents.CalculateUnstableRate():N1}";
+            unstableRate.Text = $"UR: {hitEvents.CalculateUnstableRate()}";
         }
 
         public class SampleHitCircle : LatencySampleComponent
@@ -231,7 +209,7 @@ namespace osu.Game.Screens.Utility
             {
                 if (HitEvent == null)
                 {
-                    approach.Scale = new Vector2(1 + (float)MathHelper.Clamp((HitTime - Clock.CurrentTime) / approach_rate_milliseconds.Value, 0, 100));
+                    approach.Scale = new Vector2(1 + (float)MathHelper.Clamp((HitTime - Clock.CurrentTime) / SampleApproachRate.Value, 0, 100));
                     Alpha = (float)MathHelper.Clamp((Clock.CurrentTime - HitTime + 600) / 400, 0, 1);
 
                     if (Clock.CurrentTime > HitTime + 200)
diff --git a/osu.Game/Screens/Utility/LatencyCertifierScreen.cs b/osu.Game/Screens/Utility/LatencyCertifierScreen.cs
index 2570db0e24..79736ea17d 100644
--- a/osu.Game/Screens/Utility/LatencyCertifierScreen.cs
+++ b/osu.Game/Screens/Utility/LatencyCertifierScreen.cs
@@ -25,11 +25,13 @@ using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Overlays;
+using osu.Game.Overlays.Settings;
 using osuTK;
 using osuTK.Input;
 
 namespace osu.Game.Screens.Utility
 {
+    [Cached]
     public class LatencyCertifierScreen : OsuScreen
     {
         private FrameSync previousFrameSyncMode;
@@ -49,6 +51,10 @@ namespace osu.Game.Screens.Utility
 
         private readonly Container resultsArea;
 
+        public readonly BindableDouble SampleBPM = new BindableDouble(120) { MinValue = 60, MaxValue = 300 };
+        public readonly BindableDouble SampleApproachRate = new BindableDouble(100) { MinValue = 50, MaxValue = 500 };
+        public readonly BindableFloat SampleVisualSpacing = new BindableFloat(0.2f) { MinValue = 0.05f, MaxValue = 0.3f };
+
         /// <summary>
         /// The rate at which the game host should attempt to run.
         /// </summary>
@@ -84,6 +90,8 @@ namespace osu.Game.Screens.Utility
         private double lastPoll;
         private int pollingMax;
 
+        private readonly FillFlowContainer settings;
+
         [Resolved]
         private GameHost host { get; set; } = null!;
 
@@ -122,19 +130,30 @@ namespace osu.Game.Screens.Utility
                     Anchor = Anchor.TopCentre,
                     Origin = Anchor.TopRight,
                 },
-                explanatoryText = new OsuTextFlowContainer(cp => cp.Font = OsuFont.Default.With(size: 20))
+                settings = new FillFlowContainer
                 {
+                    Name = "Settings",
+                    AutoSizeAxes = Axes.Y,
+                    RelativeSizeAxes = Axes.X,
+                    Padding = new MarginPadding(10),
+                    Spacing = new Vector2(2),
+                    Direction = FillDirection.Vertical,
                     Anchor = Anchor.BottomCentre,
                     Origin = Anchor.BottomCentre,
-                    TextAnchor = Anchor.TopCentre,
-                    RelativeSizeAxes = Axes.X,
-                    AutoSizeAxes = Axes.Y,
-                    Text = @"Welcome to the latency certifier!
+                    Child = explanatoryText = new OsuTextFlowContainer(cp => cp.Font = OsuFont.Default.With(size: 20))
+                    {
+                        AutoSizeAxes = Axes.Y,
+                        RelativeSizeAxes = Axes.X,
+                        Anchor = Anchor.TopCentre,
+                        Origin = Anchor.TopCentre,
+                        TextAnchor = Anchor.TopCentre,
+                        Text = @"Welcome to the latency certifier!
 Use the arrow keys, Z/X/F/J to control the display.
 Use the Tab key to change focus.
 Change display modes with Space.
 Do whatever you need to try and perceive the difference in latency, then choose your best side.
 ",
+                    },
                 },
                 resultsArea = new Container
                 {
@@ -423,6 +442,37 @@ Do whatever you need to try and perceive the difference in latency, then choose
                         mainArea.Children.First(a => a != area).IsActiveArea.Value = false;
                 });
             }
+
+            settings.AddRange(new Drawable[]
+            {
+                new SettingsSlider<double>
+                {
+                    Anchor = Anchor.TopCentre,
+                    Origin = Anchor.TopCentre,
+                    RelativeSizeAxes = Axes.None,
+                    Width = 400,
+                    LabelText = "bpm",
+                    Current = SampleBPM
+                },
+                new SettingsSlider<float>
+                {
+                    Anchor = Anchor.TopCentre,
+                    Origin = Anchor.TopCentre,
+                    RelativeSizeAxes = Axes.None,
+                    Width = 400,
+                    LabelText = "visual spacing",
+                    Current = SampleVisualSpacing
+                },
+                new SettingsSlider<double>
+                {
+                    Anchor = Anchor.TopCentre,
+                    Origin = Anchor.TopCentre,
+                    RelativeSizeAxes = Axes.None,
+                    Width = 400,
+                    LabelText = "approach rate",
+                    Current = SampleApproachRate
+                },
+            });
         }
 
         private void recordResult(bool correct)
diff --git a/osu.Game/Screens/Utility/SampleComponents/LatencySampleComponent.cs b/osu.Game/Screens/Utility/SampleComponents/LatencySampleComponent.cs
index 03f6b46852..c3233d5aa5 100644
--- a/osu.Game/Screens/Utility/SampleComponents/LatencySampleComponent.cs
+++ b/osu.Game/Screens/Utility/SampleComponents/LatencySampleComponent.cs
@@ -14,6 +14,10 @@ namespace osu.Game.Screens.Utility.SampleComponents
 {
     public abstract class LatencySampleComponent : CompositeDrawable
     {
+        protected readonly BindableDouble SampleBPM = new BindableDouble();
+        protected readonly BindableDouble SampleApproachRate = new BindableDouble();
+        protected readonly BindableFloat SampleVisualSpacing = new BindableFloat();
+
         protected readonly BindableBool IsActive = new BindableBool();
 
         private InputManager inputManager = null!;
@@ -24,6 +28,14 @@ namespace osu.Game.Screens.Utility.SampleComponents
         [Resolved]
         protected OverlayColourProvider OverlayColourProvider { get; private set; } = null!;
 
+        [BackgroundDependencyLoader]
+        private void load(LatencyCertifierScreen latencyCertifierScreen)
+        {
+            SampleBPM.BindTo(latencyCertifierScreen.SampleBPM);
+            SampleApproachRate.BindTo(latencyCertifierScreen.SampleApproachRate);
+            SampleVisualSpacing.BindTo(latencyCertifierScreen.SampleVisualSpacing);
+        }
+
         protected override void LoadComplete()
         {
             base.LoadComplete();

From 213ccfb74330bc4f7b42068e6be881213cbf25ee Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 10 Jun 2022 20:08:53 +0900
Subject: [PATCH 5367/5547] Improve explanation text and add link to wiki

---
 .../Screens/Utility/LatencyCertifierScreen.cs  | 18 +++++++++---------
 .../SampleComponents/LatencyMovableBox.cs      |  2 +-
 2 files changed, 10 insertions(+), 10 deletions(-)

diff --git a/osu.Game/Screens/Utility/LatencyCertifierScreen.cs b/osu.Game/Screens/Utility/LatencyCertifierScreen.cs
index 79736ea17d..bcdba370f5 100644
--- a/osu.Game/Screens/Utility/LatencyCertifierScreen.cs
+++ b/osu.Game/Screens/Utility/LatencyCertifierScreen.cs
@@ -45,7 +45,7 @@ namespace osu.Game.Screens.Utility
 
         public override float BackgroundParallaxAmount => 0;
 
-        private readonly OsuTextFlowContainer explanatoryText;
+        private readonly LinkFlowContainer explanatoryText;
 
         private readonly Container<LatencyArea> mainArea;
 
@@ -134,25 +134,19 @@ namespace osu.Game.Screens.Utility
                 {
                     Name = "Settings",
                     AutoSizeAxes = Axes.Y,
-                    RelativeSizeAxes = Axes.X,
+                    Width = 800,
                     Padding = new MarginPadding(10),
                     Spacing = new Vector2(2),
                     Direction = FillDirection.Vertical,
                     Anchor = Anchor.BottomCentre,
                     Origin = Anchor.BottomCentre,
-                    Child = explanatoryText = new OsuTextFlowContainer(cp => cp.Font = OsuFont.Default.With(size: 20))
+                    Child = explanatoryText = new LinkFlowContainer(cp => cp.Font = OsuFont.Default.With(size: 20))
                     {
                         AutoSizeAxes = Axes.Y,
                         RelativeSizeAxes = Axes.X,
                         Anchor = Anchor.TopCentre,
                         Origin = Anchor.TopCentre,
                         TextAnchor = Anchor.TopCentre,
-                        Text = @"Welcome to the latency certifier!
-Use the arrow keys, Z/X/F/J to control the display.
-Use the Tab key to change focus.
-Change display modes with Space.
-Do whatever you need to try and perceive the difference in latency, then choose your best side.
-",
                     },
                 },
                 resultsArea = new Container
@@ -169,6 +163,12 @@ Do whatever you need to try and perceive the difference in latency, then choose
                     AutoSizeAxes = Axes.Y,
                 },
             };
+
+            explanatoryText.AddParagraph(@"Welcome to the latency certifier!");
+            explanatoryText.AddParagraph(@"Do whatever you need to try and perceive the difference in latency, then choose your best side. Read more about the methodology ");
+            explanatoryText.AddLink("here", "https://github.com/ppy/osu/wiki/Latency-and-unlimited-frame-rates");
+            explanatoryText.AddParagraph(@"Use the arrow keys or Z/X/F/J to control the display.");
+            explanatoryText.AddParagraph(@"Tab key to change focus. Space to change display mode");
         }
 
         protected override bool OnMouseMove(MouseMoveEvent e)
diff --git a/osu.Game/Screens/Utility/SampleComponents/LatencyMovableBox.cs b/osu.Game/Screens/Utility/SampleComponents/LatencyMovableBox.cs
index 56c8aa2ed5..a7da05fbb1 100644
--- a/osu.Game/Screens/Utility/SampleComponents/LatencyMovableBox.cs
+++ b/osu.Game/Screens/Utility/SampleComponents/LatencyMovableBox.cs
@@ -60,7 +60,7 @@ namespace osu.Game.Screens.Utility.SampleComponents
                             box.Y = MathHelper.Clamp(box.Y - movementAmount, 0.1f, 0.9f);
                             break;
 
-                        case Key.K:
+                        case Key.J:
                         case Key.Down:
                             box.Y = MathHelper.Clamp(box.Y + movementAmount, 0.1f, 0.9f);
                             break;

From b956a916c1309f3fd599938dfea6fea39c152217 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 10 Jun 2022 20:21:03 +0900
Subject: [PATCH 5368/5547] Make units sane

---
 osu.Game/Screens/Utility/CircleGameplay.cs         | 11 ++++++++---
 osu.Game/Screens/Utility/LatencyCertifierScreen.cs |  4 ++--
 2 files changed, 10 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Screens/Utility/CircleGameplay.cs b/osu.Game/Screens/Utility/CircleGameplay.cs
index 4bfc10548f..5f08367336 100644
--- a/osu.Game/Screens/Utility/CircleGameplay.cs
+++ b/osu.Game/Screens/Utility/CircleGameplay.cs
@@ -10,6 +10,7 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Input.Events;
 using osu.Framework.Input.States;
+using osu.Game.Beatmaps;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Rulesets.Objects;
@@ -84,8 +85,10 @@ namespace osu.Game.Screens.Utility
 
             Vector2 location;
 
-            float spacingLow = 0.5f - SampleVisualSpacing.Value;
-            float spacingHigh = 0.5f + SampleVisualSpacing.Value;
+            float adjust = SampleVisualSpacing.Value * 0.25f;
+
+            float spacingLow = 0.5f - adjust;
+            float spacingHigh = 0.5f + adjust;
 
             switch (nextLocation % 4)
             {
@@ -209,7 +212,9 @@ namespace osu.Game.Screens.Utility
             {
                 if (HitEvent == null)
                 {
-                    approach.Scale = new Vector2(1 + (float)MathHelper.Clamp((HitTime - Clock.CurrentTime) / SampleApproachRate.Value, 0, 100));
+                    double preempt = (float)IBeatmapDifficultyInfo.DifficultyRange(SampleApproachRate.Value, 1800, 1200, 450);
+
+                    approach.Scale = new Vector2(1 + 4 * (float)MathHelper.Clamp((HitTime - Clock.CurrentTime) / preempt, 0, 100));
                     Alpha = (float)MathHelper.Clamp((Clock.CurrentTime - HitTime + 600) / 400, 0, 1);
 
                     if (Clock.CurrentTime > HitTime + 200)
diff --git a/osu.Game/Screens/Utility/LatencyCertifierScreen.cs b/osu.Game/Screens/Utility/LatencyCertifierScreen.cs
index bcdba370f5..251a94e705 100644
--- a/osu.Game/Screens/Utility/LatencyCertifierScreen.cs
+++ b/osu.Game/Screens/Utility/LatencyCertifierScreen.cs
@@ -52,8 +52,8 @@ namespace osu.Game.Screens.Utility
         private readonly Container resultsArea;
 
         public readonly BindableDouble SampleBPM = new BindableDouble(120) { MinValue = 60, MaxValue = 300 };
-        public readonly BindableDouble SampleApproachRate = new BindableDouble(100) { MinValue = 50, MaxValue = 500 };
-        public readonly BindableFloat SampleVisualSpacing = new BindableFloat(0.2f) { MinValue = 0.05f, MaxValue = 0.3f };
+        public readonly BindableDouble SampleApproachRate = new BindableDouble(9) { MinValue = 5, MaxValue = 12, Precision = 0.1 };
+        public readonly BindableFloat SampleVisualSpacing = new BindableFloat(0.5f) { MinValue = 0f, MaxValue = 1, Precision = 0.1f };
 
         /// <summary>
         /// The rate at which the game host should attempt to run.

From 8ce545ff9d87f13706ed77182988b9baeb2dec2c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 10 Jun 2022 20:25:33 +0900
Subject: [PATCH 5369/5547] Fix visuals in circle gameplay and greedy hover

---
 osu.Game/Screens/Utility/CircleGameplay.cs | 8 +++-----
 1 file changed, 3 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Screens/Utility/CircleGameplay.cs b/osu.Game/Screens/Utility/CircleGameplay.cs
index 5f08367336..47129c7581 100644
--- a/osu.Game/Screens/Utility/CircleGameplay.cs
+++ b/osu.Game/Screens/Utility/CircleGameplay.cs
@@ -120,7 +120,7 @@ namespace osu.Game.Screens.Utility
         private void hit(HitEvent h)
         {
             hitEvents.Add(h);
-            unstableRate.Text = $"UR: {hitEvents.CalculateUnstableRate()}";
+            unstableRate.Text = $"UR: {hitEvents.CalculateUnstableRate():N0}";
         }
 
         public class SampleHitCircle : LatencySampleComponent
@@ -149,7 +149,7 @@ namespace osu.Game.Screens.Utility
             }
 
             [BackgroundDependencyLoader]
-            private void load()
+            private void load(OsuColour colours)
             {
                 InternalChildren = new Drawable[]
                 {
@@ -162,7 +162,7 @@ namespace osu.Game.Screens.Utility
                     },
                     approach = new CircularContainer
                     {
-                        BorderColour = OverlayColourProvider.Colour1,
+                        BorderColour = colours.Blue,
                         Size = new Vector2(size),
                         Masking = true,
                         BorderThickness = 4,
@@ -181,8 +181,6 @@ namespace osu.Game.Screens.Utility
                 };
             }
 
-            protected override bool OnHover(HoverEvent e) => true;
-
             protected override bool OnMouseDown(MouseDownEvent e)
             {
                 if (HitEvent != null)

From 096d6df8684d5eda673ef6f081c3c744ee4f5daa Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 10 Jun 2022 20:33:01 +0900
Subject: [PATCH 5370/5547] Fix regression in testing and setting logic

---
 .../TestSceneLatencyCertifierScreen.cs        |  1 -
 .../Screens/Utility/LatencyCertifierScreen.cs | 78 +++++++++----------
 2 files changed, 38 insertions(+), 41 deletions(-)

diff --git a/osu.Game.Tests/Visual/Settings/TestSceneLatencyCertifierScreen.cs b/osu.Game.Tests/Visual/Settings/TestSceneLatencyCertifierScreen.cs
index 079796df2e..ee18afcbaf 100644
--- a/osu.Game.Tests/Visual/Settings/TestSceneLatencyCertifierScreen.cs
+++ b/osu.Game.Tests/Visual/Settings/TestSceneLatencyCertifierScreen.cs
@@ -44,7 +44,6 @@ namespace osu.Game.Tests.Visual.Settings
 
             clickUntilResults(true);
             AddAssert("check at results", () => !latencyCertifier.ChildrenOfType<LatencyArea>().Any());
-            AddAssert("check no buttons", () => !latencyCertifier.ChildrenOfType<OsuButton>().Any());
             checkDifficulty(1);
         }
 
diff --git a/osu.Game/Screens/Utility/LatencyCertifierScreen.cs b/osu.Game/Screens/Utility/LatencyCertifierScreen.cs
index 251a94e705..00b6a25ac3 100644
--- a/osu.Game/Screens/Utility/LatencyCertifierScreen.cs
+++ b/osu.Game/Screens/Utility/LatencyCertifierScreen.cs
@@ -90,8 +90,6 @@ namespace osu.Game.Screens.Utility
         private double lastPoll;
         private int pollingMax;
 
-        private readonly FillFlowContainer settings;
-
         [Resolved]
         private GameHost host { get; set; } = null!;
 
@@ -130,7 +128,7 @@ namespace osu.Game.Screens.Utility
                     Anchor = Anchor.TopCentre,
                     Origin = Anchor.TopRight,
                 },
-                settings = new FillFlowContainer
+                new FillFlowContainer
                 {
                     Name = "Settings",
                     AutoSizeAxes = Axes.Y,
@@ -140,13 +138,43 @@ namespace osu.Game.Screens.Utility
                     Direction = FillDirection.Vertical,
                     Anchor = Anchor.BottomCentre,
                     Origin = Anchor.BottomCentre,
-                    Child = explanatoryText = new LinkFlowContainer(cp => cp.Font = OsuFont.Default.With(size: 20))
+                    Children = new Drawable[]
                     {
-                        AutoSizeAxes = Axes.Y,
-                        RelativeSizeAxes = Axes.X,
-                        Anchor = Anchor.TopCentre,
-                        Origin = Anchor.TopCentre,
-                        TextAnchor = Anchor.TopCentre,
+                        explanatoryText = new LinkFlowContainer(cp => cp.Font = OsuFont.Default.With(size: 20))
+                        {
+                            AutoSizeAxes = Axes.Y,
+                            RelativeSizeAxes = Axes.X,
+                            Anchor = Anchor.TopCentre,
+                            Origin = Anchor.TopCentre,
+                            TextAnchor = Anchor.TopCentre,
+                        },
+                        new SettingsSlider<double>
+                        {
+                            Anchor = Anchor.TopCentre,
+                            Origin = Anchor.TopCentre,
+                            RelativeSizeAxes = Axes.None,
+                            Width = 400,
+                            LabelText = "bpm",
+                            Current = SampleBPM
+                        },
+                        new SettingsSlider<float>
+                        {
+                            Anchor = Anchor.TopCentre,
+                            Origin = Anchor.TopCentre,
+                            RelativeSizeAxes = Axes.None,
+                            Width = 400,
+                            LabelText = "visual spacing",
+                            Current = SampleVisualSpacing
+                        },
+                        new SettingsSlider<double>
+                        {
+                            Anchor = Anchor.TopCentre,
+                            Origin = Anchor.TopCentre,
+                            RelativeSizeAxes = Axes.None,
+                            Width = 400,
+                            LabelText = "approach rate",
+                            Current = SampleApproachRate
+                        },
                     },
                 },
                 resultsArea = new Container
@@ -227,6 +255,7 @@ namespace osu.Game.Screens.Utility
         private void showResults()
         {
             mainArea.Clear();
+            resultsArea.Clear();
 
             var displayMode = host.Window?.CurrentDisplayMode.Value;
 
@@ -442,37 +471,6 @@ namespace osu.Game.Screens.Utility
                         mainArea.Children.First(a => a != area).IsActiveArea.Value = false;
                 });
             }
-
-            settings.AddRange(new Drawable[]
-            {
-                new SettingsSlider<double>
-                {
-                    Anchor = Anchor.TopCentre,
-                    Origin = Anchor.TopCentre,
-                    RelativeSizeAxes = Axes.None,
-                    Width = 400,
-                    LabelText = "bpm",
-                    Current = SampleBPM
-                },
-                new SettingsSlider<float>
-                {
-                    Anchor = Anchor.TopCentre,
-                    Origin = Anchor.TopCentre,
-                    RelativeSizeAxes = Axes.None,
-                    Width = 400,
-                    LabelText = "visual spacing",
-                    Current = SampleVisualSpacing
-                },
-                new SettingsSlider<double>
-                {
-                    Anchor = Anchor.TopCentre,
-                    Origin = Anchor.TopCentre,
-                    RelativeSizeAxes = Axes.None,
-                    Width = 400,
-                    LabelText = "approach rate",
-                    Current = SampleApproachRate
-                },
-            });
         }
 
         private void recordResult(bool correct)

From e3418f570ab76610fb7c4658263e3686b843c2e7 Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Mon, 25 Apr 2022 22:48:12 -0700
Subject: [PATCH 5371/5547] Fix app version not updating on windows uninstaller
 entry

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

diff --git a/osu.Desktop/Program.cs b/osu.Desktop/Program.cs
index 405f0a8006..f95348aa3f 100644
--- a/osu.Desktop/Program.cs
+++ b/osu.Desktop/Program.cs
@@ -113,6 +113,9 @@ namespace osu.Desktop
             {
                 tools.CreateShortcutForThisExe();
                 tools.CreateUninstallerRegistryEntry();
+            }, onAppUpdate: (version, tools) =>
+            {
+                tools.CreateUninstallerRegistryEntry();
             }, onAppUninstall: (version, tools) =>
             {
                 tools.RemoveShortcutForThisExe();

From 8562641560345f3c000a63ea1c9a15baf9853507 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 11 Jun 2022 12:48:31 +0900
Subject: [PATCH 5372/5547] Update framework

---
 osu.Android.props        | 2 +-
 osu.Game/osu.Game.csproj | 2 +-
 osu.iOS.props            | 4 ++--
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Android.props b/osu.Android.props
index 155a21bacb..3b70df82c2 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -52,7 +52,7 @@
   </ItemGroup>
   <ItemGroup>
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.527.0" />
-    <PackageReference Include="ppy.osu.Framework.Android" Version="2022.607.0" />
+    <PackageReference Include="ppy.osu.Framework.Android" Version="2022.611.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
     <!-- Realm needs to be directly referenced in all Xamarin projects, as it will not pull in its transitive dependencies otherwise. -->
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index b6218c5950..19ec7ebcd0 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="10.14.0" />
-    <PackageReference Include="ppy.osu.Framework" Version="2022.607.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2022.611.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.527.0" />
     <PackageReference Include="Sentry" Version="3.17.1" />
     <PackageReference Include="SharpCompress" Version="0.31.0" />
diff --git a/osu.iOS.props b/osu.iOS.props
index ba57aba01b..c971612f62 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -61,7 +61,7 @@
     <Reference Include="System.Net.Http" />
   </ItemGroup>
   <ItemGroup Label="Package References">
-    <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.607.0" />
+    <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.611.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.527.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net6.0) -->
@@ -84,7 +84,7 @@
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="5.0.14" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.Core" Version="5.0.14" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
-    <PackageReference Include="ppy.osu.Framework" Version="2022.607.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2022.611.0" />
     <PackageReference Include="SharpCompress" Version="0.31.0" />
     <PackageReference Include="NUnit" Version="3.13.3" />
     <PackageReference Include="System.ComponentModel.Annotations" Version="5.0.0" />

From 06f070c3ec118a6f1b8df8430c5c046b0c4bed3f Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sat, 11 Jun 2022 14:58:16 +0300
Subject: [PATCH 5373/5547] Fix latency certifier potentially reporting
 infinite mouse polling rate

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

diff --git a/osu.Game/Screens/Utility/LatencyCertifierScreen.cs b/osu.Game/Screens/Utility/LatencyCertifierScreen.cs
index 0a9d98450f..5c12dd3a83 100644
--- a/osu.Game/Screens/Utility/LatencyCertifierScreen.cs
+++ b/osu.Game/Screens/Utility/LatencyCertifierScreen.cs
@@ -147,7 +147,7 @@ Do whatever you need to try and perceive the difference in latency, then choose
 
         protected override bool OnMouseMove(MouseMoveEvent e)
         {
-            if (lastPoll > 0)
+            if (lastPoll > 0 && Clock.CurrentTime != lastPoll)
                 pollingMax = (int)Math.Max(pollingMax, 1000 / (Clock.CurrentTime - lastPoll));
             lastPoll = Clock.CurrentTime;
             return base.OnMouseMove(e);

From 68da9f038661544f54c3a102e0a13527d3a3945d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 11 Jun 2022 21:27:44 +0900
Subject: [PATCH 5374/5547] Add explicit precision for BPM adjustment

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

diff --git a/osu.Game/Screens/Utility/LatencyCertifierScreen.cs b/osu.Game/Screens/Utility/LatencyCertifierScreen.cs
index 00b6a25ac3..2195298ff1 100644
--- a/osu.Game/Screens/Utility/LatencyCertifierScreen.cs
+++ b/osu.Game/Screens/Utility/LatencyCertifierScreen.cs
@@ -51,7 +51,7 @@ namespace osu.Game.Screens.Utility
 
         private readonly Container resultsArea;
 
-        public readonly BindableDouble SampleBPM = new BindableDouble(120) { MinValue = 60, MaxValue = 300 };
+        public readonly BindableDouble SampleBPM = new BindableDouble(120) { MinValue = 60, MaxValue = 300, Precision = 1 };
         public readonly BindableDouble SampleApproachRate = new BindableDouble(9) { MinValue = 5, MaxValue = 12, Precision = 0.1 };
         public readonly BindableFloat SampleVisualSpacing = new BindableFloat(0.5f) { MinValue = 0f, MaxValue = 1, Precision = 0.1f };
 

From d130e7ebff5167f48f4d39ef108aa33abc98dc80 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 11 Jun 2022 21:30:33 +0900
Subject: [PATCH 5375/5547] Remove `ScrollingGameplay` class for now

---
 osu.Game/Screens/Utility/ScrollingGameplay.cs | 12 ------------
 1 file changed, 12 deletions(-)
 delete mode 100644 osu.Game/Screens/Utility/ScrollingGameplay.cs

diff --git a/osu.Game/Screens/Utility/ScrollingGameplay.cs b/osu.Game/Screens/Utility/ScrollingGameplay.cs
deleted file mode 100644
index 31920d27e7..0000000000
--- a/osu.Game/Screens/Utility/ScrollingGameplay.cs
+++ /dev/null
@@ -1,12 +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 enable
-using osu.Framework.Graphics.Containers;
-
-namespace osu.Game.Screens.Utility
-{
-    public class ScrollingGameplay : CompositeDrawable
-    {
-    }
-}

From c697dc90e4ae1fca938104920a3092519aa220b7 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 11 Jun 2022 21:32:02 +0900
Subject: [PATCH 5376/5547] Hide settings at results screen

---
 osu.Game/Screens/Utility/LatencyCertifierScreen.cs | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Utility/LatencyCertifierScreen.cs b/osu.Game/Screens/Utility/LatencyCertifierScreen.cs
index 2195298ff1..558a16db6d 100644
--- a/osu.Game/Screens/Utility/LatencyCertifierScreen.cs
+++ b/osu.Game/Screens/Utility/LatencyCertifierScreen.cs
@@ -90,6 +90,8 @@ namespace osu.Game.Screens.Utility
         private double lastPoll;
         private int pollingMax;
 
+        private readonly FillFlowContainer settings;
+
         [Resolved]
         private GameHost host { get; set; } = null!;
 
@@ -128,7 +130,7 @@ namespace osu.Game.Screens.Utility
                     Anchor = Anchor.TopCentre,
                     Origin = Anchor.TopRight,
                 },
-                new FillFlowContainer
+                settings = new FillFlowContainer
                 {
                     Name = "Settings",
                     AutoSizeAxes = Axes.Y,
@@ -256,6 +258,7 @@ namespace osu.Game.Screens.Utility
         {
             mainArea.Clear();
             resultsArea.Clear();
+            settings.Hide();
 
             var displayMode = host.Window?.CurrentDisplayMode.Value;
 
@@ -437,6 +440,8 @@ namespace osu.Game.Screens.Utility
 
         private void loadNextRound()
         {
+            settings.Show();
+
             attemptsAtCurrentDifficulty++;
             statusText.Text = $"Level {DifficultyLevel}\nRound {attemptsAtCurrentDifficulty} of {totalRoundForNextResultsScreen}";
 

From 0c333e5c0884ece7e336e1656fafd56a2e5a9650 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 11 Jun 2022 21:34:00 +0900
Subject: [PATCH 5377/5547] Link directly to methodology section

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

diff --git a/osu.Game/Screens/Utility/LatencyCertifierScreen.cs b/osu.Game/Screens/Utility/LatencyCertifierScreen.cs
index 558a16db6d..6bd07ac1a4 100644
--- a/osu.Game/Screens/Utility/LatencyCertifierScreen.cs
+++ b/osu.Game/Screens/Utility/LatencyCertifierScreen.cs
@@ -196,7 +196,7 @@ namespace osu.Game.Screens.Utility
 
             explanatoryText.AddParagraph(@"Welcome to the latency certifier!");
             explanatoryText.AddParagraph(@"Do whatever you need to try and perceive the difference in latency, then choose your best side. Read more about the methodology ");
-            explanatoryText.AddLink("here", "https://github.com/ppy/osu/wiki/Latency-and-unlimited-frame-rates");
+            explanatoryText.AddLink("here", "https://github.com/ppy/osu/wiki/Latency-and-unlimited-frame-rates#methodology");
             explanatoryText.AddParagraph(@"Use the arrow keys or Z/X/F/J to control the display.");
             explanatoryText.AddParagraph(@"Tab key to change focus. Space to change display mode");
         }

From 8d53ed64a3d8da3d3925a8675c9eb590cf878141 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 11 Jun 2022 21:36:41 +0900
Subject: [PATCH 5378/5547] Fix mode cycling and add test coverage

---
 .../Visual/Settings/TestSceneLatencyCertifierScreen.cs      | 6 ++++++
 osu.Game/Screens/Utility/LatencyCertifierScreen.cs          | 3 ++-
 2 files changed, 8 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/Settings/TestSceneLatencyCertifierScreen.cs b/osu.Game.Tests/Visual/Settings/TestSceneLatencyCertifierScreen.cs
index ee18afcbaf..151d9236ea 100644
--- a/osu.Game.Tests/Visual/Settings/TestSceneLatencyCertifierScreen.cs
+++ b/osu.Game.Tests/Visual/Settings/TestSceneLatencyCertifierScreen.cs
@@ -30,6 +30,12 @@ namespace osu.Game.Tests.Visual.Settings
             AddStep("set visual mode to circles", () => latencyCertifier.VisualMode.Value = LatencyVisualMode.CircleGameplay);
         }
 
+        [Test]
+        public void TestCycleVisualModes()
+        {
+            AddRepeatStep("cycle mode", () => InputManager.Key(Key.Space), 6);
+        }
+
         [Test]
         public void TestCertification()
         {
diff --git a/osu.Game/Screens/Utility/LatencyCertifierScreen.cs b/osu.Game/Screens/Utility/LatencyCertifierScreen.cs
index 6bd07ac1a4..514fa42248 100644
--- a/osu.Game/Screens/Utility/LatencyCertifierScreen.cs
+++ b/osu.Game/Screens/Utility/LatencyCertifierScreen.cs
@@ -241,7 +241,8 @@ namespace osu.Game.Screens.Utility
             switch (e.Key)
             {
                 case Key.Space:
-                    VisualMode.Value = (LatencyVisualMode)(((int)VisualMode.Value + 1) % 3);
+                    int availableModes = Enum.GetValues(typeof(LatencyVisualMode)).Length;
+                    VisualMode.Value = (LatencyVisualMode)(((int)VisualMode.Value + 1) % availableModes);
                     return true;
 
                 case Key.Tab:

From 419b5791c968e15889150d24beabd1e971ee9783 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sat, 11 Jun 2022 15:50:34 +0300
Subject: [PATCH 5379/5547] Move circle duration to constant

---
 osu.Game/Screens/Utility/CircleGameplay.cs | 13 +++++++------
 1 file changed, 7 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Screens/Utility/CircleGameplay.cs b/osu.Game/Screens/Utility/CircleGameplay.cs
index 47129c7581..6c7cc0b80b 100644
--- a/osu.Game/Screens/Utility/CircleGameplay.cs
+++ b/osu.Game/Screens/Utility/CircleGameplay.cs
@@ -135,6 +135,7 @@ namespace osu.Game.Screens.Utility
             private Circle circle = null!;
 
             private const float size = 100;
+            private const float duration = 200;
 
             public override bool ReceivePositionalInputAt(Vector2 screenSpacePos)
                 => circle.ReceivePositionalInputAt(screenSpacePos);
@@ -186,7 +187,7 @@ namespace osu.Game.Screens.Utility
                 if (HitEvent != null)
                     return false;
 
-                if (Math.Abs(Clock.CurrentTime - HitTime) > 200)
+                if (Math.Abs(Clock.CurrentTime - HitTime) > duration)
                     return false;
 
                 attemptHit();
@@ -198,7 +199,7 @@ namespace osu.Game.Screens.Utility
                 if (!IsActive.Value)
                     return false;
 
-                if (Math.Abs(Clock.CurrentTime - HitTime) > 200)
+                if (Math.Abs(Clock.CurrentTime - HitTime) > duration)
                     return false;
 
                 if (IsHovered)
@@ -215,7 +216,7 @@ namespace osu.Game.Screens.Utility
                     approach.Scale = new Vector2(1 + 4 * (float)MathHelper.Clamp((HitTime - Clock.CurrentTime) / preempt, 0, 100));
                     Alpha = (float)MathHelper.Clamp((Clock.CurrentTime - HitTime + 600) / 400, 0, 1);
 
-                    if (Clock.CurrentTime > HitTime + 200)
+                    if (Clock.CurrentTime > HitTime + duration)
                         Expire();
                 }
             }
@@ -232,8 +233,8 @@ namespace osu.Game.Screens.Utility
                 approach.Expire();
 
                 circle
-                    .FadeOut(200)
-                    .ScaleTo(1.5f, 200);
+                    .FadeOut(duration)
+                    .ScaleTo(1.5f, duration);
 
                 HitEvent = new HitEvent(Clock.CurrentTime - HitTime, HitResult.Good, new HitObject
                 {
@@ -242,7 +243,7 @@ namespace osu.Game.Screens.Utility
 
                 Hit?.Invoke(HitEvent.Value);
 
-                this.Delay(200).Expire();
+                this.Delay(duration).Expire();
             });
         }
     }

From 5b3b9a2cd34541a20abee4d53f8e12621fff2090 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sat, 11 Jun 2022 16:21:22 +0300
Subject: [PATCH 5380/5547] Add test coverage for "simple" mode

---
 .../Visual/Settings/TestSceneLatencyCertifierScreen.cs      | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/osu.Game.Tests/Visual/Settings/TestSceneLatencyCertifierScreen.cs b/osu.Game.Tests/Visual/Settings/TestSceneLatencyCertifierScreen.cs
index 151d9236ea..d6e0f995e5 100644
--- a/osu.Game.Tests/Visual/Settings/TestSceneLatencyCertifierScreen.cs
+++ b/osu.Game.Tests/Visual/Settings/TestSceneLatencyCertifierScreen.cs
@@ -24,6 +24,12 @@ namespace osu.Game.Tests.Visual.Settings
             AddUntilStep("wait for load", () => latencyCertifier.IsLoaded);
         }
 
+        [Test]
+        public void TestSimple()
+        {
+            AddStep("set visual mode to simple", () => latencyCertifier.VisualMode.Value = LatencyVisualMode.Simple);
+        }
+
         [Test]
         public void TestCircleGameplay()
         {

From 52c8cea27dc8e0400fd125b80e262378b8a79153 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 11 Jun 2022 22:30:56 +0900
Subject: [PATCH 5381/5547] Update spectator/multiplayer endpoint in line with
 new deployment

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

diff --git a/osu.Game/Online/ProductionEndpointConfiguration.cs b/osu.Game/Online/ProductionEndpointConfiguration.cs
index e44dad1db5..c6ddc03564 100644
--- a/osu.Game/Online/ProductionEndpointConfiguration.cs
+++ b/osu.Game/Online/ProductionEndpointConfiguration.cs
@@ -10,8 +10,8 @@ namespace osu.Game.Online
             WebsiteRootUrl = APIEndpointUrl = @"https://osu.ppy.sh";
             APIClientSecret = @"FGc9GAtyHzeQDshWP5Ah7dega8hJACAJpQtw6OXk";
             APIClientID = "5";
-            SpectatorEndpointUrl = "https://spectator2.ppy.sh/spectator";
-            MultiplayerEndpointUrl = "https://spectator2.ppy.sh/multiplayer";
+            SpectatorEndpointUrl = "https://spectator.ppy.sh/spectator";
+            MultiplayerEndpointUrl = "https://spectator.ppy.sh/multiplayer";
         }
     }
 }

From af353c37c0b1a021d409aecfc267799abd0a2023 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 11 Jun 2022 23:54:11 +0900
Subject: [PATCH 5382/5547] Don't show UR for now

---
 osu.Game/Screens/Utility/CircleGameplay.cs | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Utility/CircleGameplay.cs b/osu.Game/Screens/Utility/CircleGameplay.cs
index 6c7cc0b80b..d710b26738 100644
--- a/osu.Game/Screens/Utility/CircleGameplay.cs
+++ b/osu.Game/Screens/Utility/CircleGameplay.cs
@@ -120,7 +120,10 @@ namespace osu.Game.Screens.Utility
         private void hit(HitEvent h)
         {
             hitEvents.Add(h);
-            unstableRate.Text = $"UR: {hitEvents.CalculateUnstableRate():N0}";
+
+            // Disabled to keep things simple based on internal feedback nothing it's not helpful.
+            // Can be reconsidered in the future.
+            // unstableRate.Text = $"UR: {hitEvents.CalculateUnstableRate():N0}";
         }
 
         public class SampleHitCircle : LatencySampleComponent

From 486f762f44cf3d1c7173e01c23cab5135307e388 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Sun, 12 Jun 2022 00:13:35 +0900
Subject: [PATCH 5383/5547] Fix inspection by removing unstable rate code

---
 osu.Game/Screens/Utility/CircleGameplay.cs | 15 +--------------
 1 file changed, 1 insertion(+), 14 deletions(-)

diff --git a/osu.Game/Screens/Utility/CircleGameplay.cs b/osu.Game/Screens/Utility/CircleGameplay.cs
index d710b26738..dd59721a65 100644
--- a/osu.Game/Screens/Utility/CircleGameplay.cs
+++ b/osu.Game/Screens/Utility/CircleGameplay.cs
@@ -2,6 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 #nullable enable
+
 using System;
 using System.Collections.Generic;
 using osu.Framework.Allocation;
@@ -12,7 +13,6 @@ using osu.Framework.Input.Events;
 using osu.Framework.Input.States;
 using osu.Game.Beatmaps;
 using osu.Game.Graphics;
-using osu.Game.Graphics.Sprites;
 using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Scoring;
 using osu.Game.Screens.Utility.SampleComponents;
@@ -24,8 +24,6 @@ namespace osu.Game.Screens.Utility
     {
         private int nextLocation;
 
-        private OsuSpriteText unstableRate = null!;
-
         private readonly List<HitEvent> hitEvents = new List<HitEvent>();
 
         private double? lastGeneratedBeatTime;
@@ -38,13 +36,6 @@ namespace osu.Game.Screens.Utility
 
             InternalChildren = new Drawable[]
             {
-                unstableRate = new OsuSpriteText
-                {
-                    Anchor = Anchor.Centre,
-                    Origin = Anchor.Centre,
-                    Font = OsuFont.Default.With(size: 24),
-                    Y = -100,
-                },
                 circles = new Container
                 {
                     RelativeSizeAxes = Axes.Both,
@@ -120,10 +111,6 @@ namespace osu.Game.Screens.Utility
         private void hit(HitEvent h)
         {
             hitEvents.Add(h);
-
-            // Disabled to keep things simple based on internal feedback nothing it's not helpful.
-            // Can be reconsidered in the future.
-            // unstableRate.Text = $"UR: {hitEvents.CalculateUnstableRate():N0}";
         }
 
         public class SampleHitCircle : LatencySampleComponent

From 038021f682c5fcbc9fd4f6a34bda5e5f9db5e659 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sat, 11 Jun 2022 20:24:50 +0300
Subject: [PATCH 5384/5547] Add failing test case

---
 .../Visual/Editing/TestSceneComposerSelection.cs | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneComposerSelection.cs b/osu.Game.Tests/Visual/Editing/TestSceneComposerSelection.cs
index dddd9f07ab..7fe98b9f09 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneComposerSelection.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneComposerSelection.cs
@@ -10,6 +10,7 @@ using osu.Framework.Graphics.UserInterface;
 using osu.Game.Beatmaps;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Rulesets;
+using osu.Game.Rulesets.Edit;
 using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Osu.Objects;
@@ -61,6 +62,21 @@ namespace osu.Game.Tests.Visual.Editing
             AddUntilStep("context menu is visible", () => contextMenuContainer.ChildrenOfType<OsuContextMenu>().Single().State == MenuState.Open);
         }
 
+        [Test]
+        public void TestSelectAndShowContextMenuOutsideBounds()
+        {
+            var addedObject = new HitCircle { StartTime = 100, Position = OsuPlayfield.BASE_SIZE };
+            AddStep("add hitobject", () => EditorBeatmap.Add(addedObject));
+
+            AddStep("descale blueprint container", () => this.ChildrenOfType<HitObjectComposer>().Single().Scale = new Vector2(0.5f));
+            AddStep("move mouse to bottom-right", () => InputManager.MoveMouseTo(blueprintContainer.ScreenSpaceDrawQuad.BottomRight + new Vector2(20)));
+
+            AddStep("right click", () => InputManager.Click(MouseButton.Right));
+
+            AddUntilStep("hitobject selected", () => EditorBeatmap.SelectedHitObjects.Single() == addedObject);
+            AddUntilStep("context menu is visible", () => contextMenuContainer.ChildrenOfType<OsuContextMenu>().Single().State == MenuState.Open);
+        }
+
         [Test]
         public void TestNudgeSelection()
         {

From 85fc218edf0d8f2c688af226265ef3e9373c5a4c Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sat, 11 Jun 2022 20:53:53 +0300
Subject: [PATCH 5385/5547] Provide context menu items at `BlueprintContainer`
 for out-of-bounds support

---
 .../Compose/Components/BlueprintContainer.cs  | 30 ++++++++++++++++++-
 .../Components/EditorSelectionHandler.cs      |  2 +-
 .../Compose/Components/SelectionHandler.cs    | 28 ++---------------
 .../Skinning/Editor/SkinSelectionHandler.cs   |  2 +-
 4 files changed, 34 insertions(+), 28 deletions(-)

diff --git a/osu.Game/Screens/Edit/Compose/Components/BlueprintContainer.cs b/osu.Game/Screens/Edit/Compose/Components/BlueprintContainer.cs
index d56dc176f6..5fdd7c0e81 100644
--- a/osu.Game/Screens/Edit/Compose/Components/BlueprintContainer.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/BlueprintContainer.cs
@@ -11,11 +11,14 @@ using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.Cursor;
 using osu.Framework.Graphics.Primitives;
+using osu.Framework.Graphics.UserInterface;
 using osu.Framework.Input;
 using osu.Framework.Input.Bindings;
 using osu.Framework.Input.Events;
 using osu.Game.Graphics.UserInterface;
+using osu.Game.Resources.Localisation.Web;
 using osu.Game.Rulesets.Edit;
 using osuTK;
 using osuTK.Input;
@@ -26,7 +29,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
     /// A container which provides a "blueprint" display of items.
     /// Includes selection and manipulation support via a <see cref="Components.SelectionHandler{T}"/>.
     /// </summary>
-    public abstract class BlueprintContainer<T> : CompositeDrawable, IKeyBindingHandler<PlatformAction>
+    public abstract class BlueprintContainer<T> : CompositeDrawable, IKeyBindingHandler<PlatformAction>, IHasContextMenu
         where T : class
     {
         protected DragBox DragBox { get; private set; }
@@ -534,5 +537,30 @@ namespace osu.Game.Screens.Edit.Compose.Components
         }
 
         #endregion
+
+        #region Context Menu
+
+        public MenuItem[] ContextMenuItems
+        {
+            get
+            {
+                var selectedBlueprints = SelectionHandler.SelectedBlueprints;
+                if (!selectedBlueprints.Any(b => b.IsHovered))
+                    return Array.Empty<MenuItem>();
+
+                var items = new List<MenuItem>();
+
+                items.AddRange(SelectionHandler.GetContextMenuItemsForSelection(selectedBlueprints));
+
+                if (selectedBlueprints.Count == 1)
+                    items.AddRange(selectedBlueprints[0].ContextMenuItems);
+
+                items.Add(new OsuMenuItem(CommonStrings.ButtonsDelete, MenuItemType.Destructive, SelectionHandler.DeleteSelected));
+
+                return items.ToArray();
+            }
+        }
+
+        #endregion
     }
 }
diff --git a/osu.Game/Screens/Edit/Compose/Components/EditorSelectionHandler.cs b/osu.Game/Screens/Edit/Compose/Components/EditorSelectionHandler.cs
index 7f693996a4..5fa98aea01 100644
--- a/osu.Game/Screens/Edit/Compose/Components/EditorSelectionHandler.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/EditorSelectionHandler.cs
@@ -165,7 +165,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
         /// </summary>
         /// <param name="selection">The current selection.</param>
         /// <returns>The relevant menu items.</returns>
-        protected override IEnumerable<MenuItem> GetContextMenuItemsForSelection(IEnumerable<SelectionBlueprint<HitObject>> selection)
+        protected internal override IEnumerable<MenuItem> GetContextMenuItemsForSelection(IEnumerable<SelectionBlueprint<HitObject>> selection)
         {
             if (SelectedBlueprints.All(b => b.Item is IHasComboInformation))
             {
diff --git a/osu.Game/Screens/Edit/Compose/Components/SelectionHandler.cs b/osu.Game/Screens/Edit/Compose/Components/SelectionHandler.cs
index 78b98a3649..d4ffb67a51 100644
--- a/osu.Game/Screens/Edit/Compose/Components/SelectionHandler.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/SelectionHandler.cs
@@ -8,7 +8,6 @@ using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
-using osu.Framework.Graphics.Cursor;
 using osu.Framework.Graphics.Primitives;
 using osu.Framework.Graphics.UserInterface;
 using osu.Framework.Input;
@@ -17,7 +16,6 @@ using osu.Framework.Input.Events;
 using osu.Framework.Utils;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Input.Bindings;
-using osu.Game.Resources.Localisation.Web;
 using osu.Game.Rulesets.Edit;
 using osuTK;
 using osuTK.Input;
@@ -27,7 +25,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
     /// <summary>
     /// A component which outlines items and handles movement of selections.
     /// </summary>
-    public abstract class SelectionHandler<T> : CompositeDrawable, IKeyBindingHandler<PlatformAction>, IKeyBindingHandler<GlobalAction>, IHasContextMenu
+    public abstract class SelectionHandler<T> : CompositeDrawable, IKeyBindingHandler<PlatformAction>, IKeyBindingHandler<GlobalAction>
     {
         /// <summary>
         /// The currently selected blueprints.
@@ -292,7 +290,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
             return true;
         }
 
-        protected void DeleteSelected()
+        protected internal void DeleteSelected()
         {
             DeleteItems(selectedBlueprints.Select(b => b.Item));
         }
@@ -345,32 +343,12 @@ namespace osu.Game.Screens.Edit.Compose.Components
 
         #region Context Menu
 
-        public MenuItem[] ContextMenuItems
-        {
-            get
-            {
-                if (!SelectedBlueprints.Any(b => b.IsHovered))
-                    return Array.Empty<MenuItem>();
-
-                var items = new List<MenuItem>();
-
-                items.AddRange(GetContextMenuItemsForSelection(SelectedBlueprints));
-
-                if (SelectedBlueprints.Count == 1)
-                    items.AddRange(SelectedBlueprints[0].ContextMenuItems);
-
-                items.Add(new OsuMenuItem(CommonStrings.ButtonsDelete, MenuItemType.Destructive, DeleteSelected));
-
-                return items.ToArray();
-            }
-        }
-
         /// <summary>
         /// Provide context menu items relevant to current selection. Calling base is not required.
         /// </summary>
         /// <param name="selection">The current selection.</param>
         /// <returns>The relevant menu items.</returns>
-        protected virtual IEnumerable<MenuItem> GetContextMenuItemsForSelection(IEnumerable<SelectionBlueprint<T>> selection)
+        protected internal virtual IEnumerable<MenuItem> GetContextMenuItemsForSelection(IEnumerable<SelectionBlueprint<T>> selection)
             => Enumerable.Empty<MenuItem>();
 
         #endregion
diff --git a/osu.Game/Skinning/Editor/SkinSelectionHandler.cs b/osu.Game/Skinning/Editor/SkinSelectionHandler.cs
index 943425e099..3ead8fee17 100644
--- a/osu.Game/Skinning/Editor/SkinSelectionHandler.cs
+++ b/osu.Game/Skinning/Editor/SkinSelectionHandler.cs
@@ -180,7 +180,7 @@ namespace osu.Game.Skinning.Editor
         protected override void DeleteItems(IEnumerable<ISkinnableDrawable> items) =>
             skinEditor.DeleteItems(items.ToArray());
 
-        protected override IEnumerable<MenuItem> GetContextMenuItemsForSelection(IEnumerable<SelectionBlueprint<ISkinnableDrawable>> selection)
+        protected internal override IEnumerable<MenuItem> GetContextMenuItemsForSelection(IEnumerable<SelectionBlueprint<ISkinnableDrawable>> selection)
         {
             var closestItem = new TernaryStateRadioMenuItem("Closest", MenuItemType.Standard, _ => applyClosestAnchors())
             {

From 20e7f32fd9b495f2437048a0cb1bddb549a3f92d Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sun, 12 Jun 2022 17:53:10 +0300
Subject: [PATCH 5386/5547] Improve test case to work in headless

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

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneComposerSelection.cs b/osu.Game.Tests/Visual/Editing/TestSceneComposerSelection.cs
index 7fe98b9f09..17ca9da8f8 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneComposerSelection.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneComposerSelection.cs
@@ -69,7 +69,7 @@ namespace osu.Game.Tests.Visual.Editing
             AddStep("add hitobject", () => EditorBeatmap.Add(addedObject));
 
             AddStep("descale blueprint container", () => this.ChildrenOfType<HitObjectComposer>().Single().Scale = new Vector2(0.5f));
-            AddStep("move mouse to bottom-right", () => InputManager.MoveMouseTo(blueprintContainer.ScreenSpaceDrawQuad.BottomRight + new Vector2(20)));
+            AddStep("move mouse to bottom-right", () => InputManager.MoveMouseTo(blueprintContainer.ToScreenSpace(blueprintContainer.LayoutRectangle.BottomRight + new Vector2(10))));
 
             AddStep("right click", () => InputManager.Click(MouseButton.Right));
 

From 051aa8f028d8235c648331899e72d6cddd971b92 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Mon, 13 Jun 2022 04:43:14 +0300
Subject: [PATCH 5387/5547] Mark family strings as verbatim

---
 osu.Game/Graphics/OsuFont.cs | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Graphics/OsuFont.cs b/osu.Game/Graphics/OsuFont.cs
index edb484021c..080d952cbd 100644
--- a/osu.Game/Graphics/OsuFont.cs
+++ b/osu.Game/Graphics/OsuFont.cs
@@ -54,16 +54,16 @@ namespace osu.Game.Graphics
             switch (typeface)
             {
                 case Typeface.Venera:
-                    return "Venera";
+                    return @"Venera";
 
                 case Typeface.Torus:
-                    return "Torus";
+                    return @"Torus";
 
                 case Typeface.TorusAlternate:
-                    return "Torus-Alternate";
+                    return @"Torus-Alternate";
 
                 case Typeface.Inter:
-                    return "Inter";
+                    return @"Inter";
             }
 
             return null;

From 79713556608b60d4e5b80fb23ad3322245dbfe69 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Mon, 13 Jun 2022 04:44:28 +0300
Subject: [PATCH 5388/5547] Fix torus "medium" weight not mapped to "regular"
 when using `With`

---
 osu.Game/Graphics/OsuFont.cs | 25 ++++++++++---------------
 1 file changed, 10 insertions(+), 15 deletions(-)

diff --git a/osu.Game/Graphics/OsuFont.cs b/osu.Game/Graphics/OsuFont.cs
index 080d952cbd..44303b8527 100644
--- a/osu.Game/Graphics/OsuFont.cs
+++ b/osu.Game/Graphics/OsuFont.cs
@@ -35,7 +35,10 @@ namespace osu.Game.Graphics
         /// <param name="fixedWidth">Whether all characters should be spaced the same distance apart.</param>
         /// <returns>The <see cref="FontUsage"/>.</returns>
         public static FontUsage GetFont(Typeface typeface = Typeface.Torus, float size = DEFAULT_FONT_SIZE, FontWeight weight = FontWeight.Medium, bool italics = false, bool fixedWidth = false)
-            => new FontUsage(GetFamilyString(typeface), size, GetWeightString(typeface, weight), getItalics(italics), fixedWidth);
+        {
+            string familyString = GetFamilyString(typeface);
+            return new FontUsage(familyString, size, GetWeightString(familyString, weight), getItalics(italics), fixedWidth);
+        }
 
         private static bool getItalics(in bool italicsRequested)
         {
@@ -72,25 +75,17 @@ namespace osu.Game.Graphics
         /// <summary>
         /// Retrieves the string representation of a <see cref="FontWeight"/>.
         /// </summary>
-        /// <param name="typeface">The <see cref="Typeface"/>.</param>
-        /// <param name="weight">The <see cref="FontWeight"/>.</param>
-        /// <returns>The string representation of <paramref name="weight"/> in the specified <paramref name="typeface"/>.</returns>
-        public static string GetWeightString(Typeface typeface, FontWeight weight)
+        /// <param name="family">The font family.</param>
+        /// <param name="weight">The font weight.</param>
+        /// <returns>The string representation of <paramref name="weight"/> in the specified <paramref name="family"/>.</returns>
+        public static string GetWeightString(string family, FontWeight weight)
         {
-            if (typeface == Typeface.Torus && weight == FontWeight.Medium)
+            if (family == @"Torus" && weight == FontWeight.Medium)
                 // torus doesn't have a medium; fallback to regular.
                 weight = FontWeight.Regular;
 
-            return GetWeightString(GetFamilyString(typeface), weight);
+            return weight.ToString();
         }
-
-        /// <summary>
-        /// Retrieves the string representation of a <see cref="FontWeight"/>.
-        /// </summary>
-        /// <param name="family">The family string.</param>
-        /// <param name="weight">The <see cref="FontWeight"/>.</param>
-        /// <returns>The string representation of <paramref name="weight"/> in the specified <paramref name="family"/>.</returns>
-        public static string GetWeightString(string family, FontWeight weight) => weight.ToString();
     }
 
     public static class OsuFontExtensions

From 3aec0fe9b6c07348e71c4b929fe0d0e09a764c66 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Mon, 13 Jun 2022 04:45:07 +0300
Subject: [PATCH 5389/5547] Fix torus alternate not mapping "medium" weight to
 "regular"

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

diff --git a/osu.Game/Graphics/OsuFont.cs b/osu.Game/Graphics/OsuFont.cs
index 44303b8527..0cd3097af5 100644
--- a/osu.Game/Graphics/OsuFont.cs
+++ b/osu.Game/Graphics/OsuFont.cs
@@ -80,7 +80,7 @@ namespace osu.Game.Graphics
         /// <returns>The string representation of <paramref name="weight"/> in the specified <paramref name="family"/>.</returns>
         public static string GetWeightString(string family, FontWeight weight)
         {
-            if (family == @"Torus" && weight == FontWeight.Medium)
+            if ((family == @"Torus" || family == @"Torus-Alternate") && weight == FontWeight.Medium)
                 // torus doesn't have a medium; fallback to regular.
                 weight = FontWeight.Regular;
 

From dfc643fd8ccce3266ba5a0cd326466e118732e6e Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Mon, 13 Jun 2022 12:35:09 +0900
Subject: [PATCH 5390/5547] Match family string via GetFamilyString()

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

diff --git a/osu.Game/Graphics/OsuFont.cs b/osu.Game/Graphics/OsuFont.cs
index 0cd3097af5..9d4e97b88e 100644
--- a/osu.Game/Graphics/OsuFont.cs
+++ b/osu.Game/Graphics/OsuFont.cs
@@ -80,7 +80,7 @@ namespace osu.Game.Graphics
         /// <returns>The string representation of <paramref name="weight"/> in the specified <paramref name="family"/>.</returns>
         public static string GetWeightString(string family, FontWeight weight)
         {
-            if ((family == @"Torus" || family == @"Torus-Alternate") && weight == FontWeight.Medium)
+            if ((family == GetFamilyString(Typeface.Torus) || family == GetFamilyString(Typeface.TorusAlternate)) && weight == FontWeight.Medium)
                 // torus doesn't have a medium; fallback to regular.
                 weight = FontWeight.Regular;
 

From 77fcf35d1d56211e865fd8e774068cf20bb956d1 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 13 Jun 2022 15:40:21 +0900
Subject: [PATCH 5391/5547] Remove unlimited frame limiter warning

This should not be required now that we have a 1,000 Hz limiter in
place.
---
 .../Localisation/GraphicsSettingsStrings.cs   |  5 ----
 .../Sections/Graphics/RendererSettings.cs     | 23 +------------------
 2 files changed, 1 insertion(+), 27 deletions(-)

diff --git a/osu.Game/Localisation/GraphicsSettingsStrings.cs b/osu.Game/Localisation/GraphicsSettingsStrings.cs
index 1c9aa64df5..38355d9041 100644
--- a/osu.Game/Localisation/GraphicsSettingsStrings.cs
+++ b/osu.Game/Localisation/GraphicsSettingsStrings.cs
@@ -34,11 +34,6 @@ namespace osu.Game.Localisation
         /// </summary>
         public static LocalisableString ShowFPS => new TranslatableString(getKey(@"show_fps"), @"Show FPS");
 
-        /// <summary>
-        /// "Using unlimited frame limiter can lead to stutters, bad performance and overheating. It will not improve perceived latency. "2x refresh rate" is recommended."
-        /// </summary>
-        public static LocalisableString UnlimitedFramesNote => new TranslatableString(getKey(@"unlimited_frames_note"), @"Using unlimited frame limiter can lead to stutters, bad performance and overheating. It will not improve perceived latency. ""2x refresh rate"" is recommended.");
-
         /// <summary>
         /// "Layout"
         /// </summary>
diff --git a/osu.Game/Overlays/Settings/Sections/Graphics/RendererSettings.cs b/osu.Game/Overlays/Settings/Sections/Graphics/RendererSettings.cs
index 8c3e45cd62..5ba8e724cf 100644
--- a/osu.Game/Overlays/Settings/Sections/Graphics/RendererSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Graphics/RendererSettings.cs
@@ -15,8 +15,6 @@ namespace osu.Game.Overlays.Settings.Sections.Graphics
     {
         protected override LocalisableString Header => GraphicsSettingsStrings.RendererHeader;
 
-        private SettingsEnumDropdown<FrameSync> frameLimiterDropdown;
-
         [BackgroundDependencyLoader]
         private void load(FrameworkConfigManager config, OsuConfigManager osuConfig)
         {
@@ -24,7 +22,7 @@ namespace osu.Game.Overlays.Settings.Sections.Graphics
             Children = new Drawable[]
             {
                 // TODO: this needs to be a custom dropdown at some point
-                frameLimiterDropdown = new SettingsEnumDropdown<FrameSync>
+                new SettingsEnumDropdown<FrameSync>
                 {
                     LabelText = GraphicsSettingsStrings.FrameLimiter,
                     Current = config.GetBindable<FrameSync>(FrameworkSetting.FrameSync)
@@ -41,24 +39,5 @@ namespace osu.Game.Overlays.Settings.Sections.Graphics
                 },
             };
         }
-
-        protected override void LoadComplete()
-        {
-            base.LoadComplete();
-
-            frameLimiterDropdown.Current.BindValueChanged(limit =>
-            {
-                switch (limit.NewValue)
-                {
-                    case FrameSync.Unlimited:
-                        frameLimiterDropdown.SetNoticeText(GraphicsSettingsStrings.UnlimitedFramesNote, true);
-                        break;
-
-                    default:
-                        frameLimiterDropdown.ClearNoticeText();
-                        break;
-                }
-            }, true);
-        }
     }
 }

From 17eaf7bb5c2d1041738ccf780c96e1b1214a2e21 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 13 Jun 2022 16:35:46 +0900
Subject: [PATCH 5392/5547] Add failing test coverage showing hit meters don't
 update when not visible

---
 .../Visual/Gameplay/TestSceneHitErrorMeter.cs | 30 +++++++++++++++++++
 .../HUD/HitErrorMeters/ColourHitErrorMeter.cs | 12 ++++----
 2 files changed, 36 insertions(+), 6 deletions(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneHitErrorMeter.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneHitErrorMeter.cs
index 7febb54010..cbf9760e21 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneHitErrorMeter.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneHitErrorMeter.cs
@@ -142,6 +142,36 @@ namespace osu.Game.Tests.Visual.Gameplay
             AddAssert("no circle added", () => !this.ChildrenOfType<ColourHitErrorMeter.HitErrorCircle>().Any());
         }
 
+        [Test]
+        public void TestProcessingWhileHidden()
+        {
+            AddStep("OD 1", () => recreateDisplay(new OsuHitWindows(), 1));
+
+            AddStep("hide displays", () =>
+            {
+                foreach (var hitErrorMeter in this.ChildrenOfType<HitErrorMeter>())
+                    hitErrorMeter.Hide();
+            });
+
+            AddRepeatStep("hit", () => newJudgement(), ColourHitErrorMeter.MAX_DISPLAYED_JUDGEMENTS * 2);
+
+            AddAssert("bars added", () => this.ChildrenOfType<BarHitErrorMeter.JudgementLine>().Any());
+            AddAssert("circle added", () => this.ChildrenOfType<ColourHitErrorMeter.HitErrorCircle>().Any());
+
+            AddUntilStep("wait for bars to disappear", () => !this.ChildrenOfType<BarHitErrorMeter.JudgementLine>().Any());
+            AddUntilStep("ensure max circles not exceeded", () =>
+            {
+                return this.ChildrenOfType<ColourHitErrorMeter>()
+                           .All(m => m.ChildrenOfType<ColourHitErrorMeter.HitErrorCircle>().Count() <= ColourHitErrorMeter.MAX_DISPLAYED_JUDGEMENTS);
+            });
+
+            AddStep("show displays", () =>
+            {
+                foreach (var hitErrorMeter in this.ChildrenOfType<HitErrorMeter>())
+                    hitErrorMeter.Show();
+            });
+        }
+
         [Test]
         public void TestClear()
         {
diff --git a/osu.Game/Screens/Play/HUD/HitErrorMeters/ColourHitErrorMeter.cs b/osu.Game/Screens/Play/HUD/HitErrorMeters/ColourHitErrorMeter.cs
index 5012be7249..9948b968d1 100644
--- a/osu.Game/Screens/Play/HUD/HitErrorMeters/ColourHitErrorMeter.cs
+++ b/osu.Game/Screens/Play/HUD/HitErrorMeters/ColourHitErrorMeter.cs
@@ -15,7 +15,11 @@ namespace osu.Game.Screens.Play.HUD.HitErrorMeters
 {
     public class ColourHitErrorMeter : HitErrorMeter
     {
+        internal const int MAX_DISPLAYED_JUDGEMENTS = 20;
+
         private const int animation_duration = 200;
+        private const int drawable_judgement_size = 8;
+        private const int spacing = 2;
 
         private readonly JudgementFlow judgementsFlow;
 
@@ -37,16 +41,12 @@ namespace osu.Game.Screens.Play.HUD.HitErrorMeters
 
         private class JudgementFlow : FillFlowContainer<HitErrorCircle>
         {
-            private const int max_available_judgements = 20;
-            private const int drawable_judgement_size = 8;
-            private const int spacing = 2;
-
             public override IEnumerable<Drawable> FlowingChildren => base.FlowingChildren.Reverse();
 
             public JudgementFlow()
             {
                 AutoSizeAxes = Axes.X;
-                Height = max_available_judgements * (drawable_judgement_size + spacing) - spacing;
+                Height = MAX_DISPLAYED_JUDGEMENTS * (drawable_judgement_size + spacing) - spacing;
                 Spacing = new Vector2(0, spacing);
                 Direction = FillDirection.Vertical;
                 LayoutDuration = animation_duration;
@@ -57,7 +57,7 @@ namespace osu.Game.Screens.Play.HUD.HitErrorMeters
             {
                 Add(new HitErrorCircle(colour, drawable_judgement_size));
 
-                if (Children.Count > max_available_judgements)
+                if (Children.Count > MAX_DISPLAYED_JUDGEMENTS)
                     Children.FirstOrDefault(c => !c.IsRemoved)?.Remove();
             }
         }

From 86163d2225157af9c874af5b2dd59208572f8349 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 13 Jun 2022 16:37:26 +0900
Subject: [PATCH 5393/5547] Fix hit error meters not updating visual state when
 hidden

It is an expectation of users that when the HUD is shown after a period
of being hidden, it will visually reflect the state based on recent
judgements.

To achieve this, I've added `AlwaysPresent` and moved the transform
application to the meter level, rather than at a child level. If this is
seen as a bad direction, `AlwaysPresent` can be applied to the drawable
children and the transforms can be moved back.

Also of note, `ColourHitErrorMeter` is pretty weird. The flow class
could potentially be removed and reduce `AlwaysPresent` usage by one.
Can do that refactor as part of this PR if preferred.

Closes #18624.
---
 .../HUD/HitErrorMeters/BarHitErrorMeter.cs    | 35 ++++++++++---------
 .../HUD/HitErrorMeters/ColourHitErrorMeter.cs | 34 +++++++-----------
 .../Play/HUD/HitErrorMeters/HitErrorMeter.cs  |  2 ++
 3 files changed, 33 insertions(+), 38 deletions(-)

diff --git a/osu.Game/Screens/Play/HUD/HitErrorMeters/BarHitErrorMeter.cs b/osu.Game/Screens/Play/HUD/HitErrorMeters/BarHitErrorMeter.cs
index dca50c07ad..79fd22eb0e 100644
--- a/osu.Game/Screens/Play/HUD/HitErrorMeters/BarHitErrorMeter.cs
+++ b/osu.Game/Screens/Play/HUD/HitErrorMeters/BarHitErrorMeter.cs
@@ -400,6 +400,9 @@ namespace osu.Game.Screens.Play.HUD.HitErrorMeters
         {
             const int arrow_move_duration = 800;
 
+            const int judgement_fade_in_duration = 100;
+            const int judgement_fade_out_duration = 5000;
+
             if (!judgement.IsHit || judgement.HitObject.HitWindows?.WindowFor(HitResult.Miss) == 0)
                 return;
 
@@ -420,12 +423,26 @@ namespace osu.Game.Screens.Play.HUD.HitErrorMeters
                 }
             }
 
-            judgementsContainer.Add(new JudgementLine
+            var judgementLine = new JudgementLine
             {
                 JudgementLineThickness = { BindTarget = JudgementLineThickness },
                 Y = getRelativeJudgementPosition(judgement.TimeOffset),
                 Colour = GetColourForHitResult(judgement.Type),
-            });
+                Alpha = 0,
+                Width = 0,
+            };
+
+            judgementsContainer.Add(judgementLine);
+
+            // Importantly, transforms should be applied in this method rather than constructed drawables
+            // to ensure that they are applied even when the `HitErrorMeter` is hidden (see `AlwaysPresent` usage).
+            judgementLine
+                .FadeTo(0.6f, judgement_fade_in_duration, Easing.OutQuint)
+                .ResizeWidthTo(1, judgement_fade_in_duration, Easing.OutQuint)
+                .Then()
+                .FadeOut(judgement_fade_out_duration)
+                .ResizeWidthTo(0, judgement_fade_out_duration, Easing.InQuint)
+                .Expire();
 
             arrow.MoveToY(
                 getRelativeJudgementPosition(floatingAverage = floatingAverage * 0.9 + judgement.TimeOffset * 0.1)
@@ -456,23 +473,9 @@ namespace osu.Game.Screens.Play.HUD.HitErrorMeters
 
             protected override void LoadComplete()
             {
-                const int judgement_fade_in_duration = 100;
-                const int judgement_fade_out_duration = 5000;
-
                 base.LoadComplete();
 
-                Alpha = 0;
-                Width = 0;
-
                 JudgementLineThickness.BindValueChanged(thickness => Height = thickness.NewValue, true);
-
-                this
-                    .FadeTo(0.6f, judgement_fade_in_duration, Easing.OutQuint)
-                    .ResizeWidthTo(1, judgement_fade_in_duration, Easing.OutQuint)
-                    .Then()
-                    .FadeOut(judgement_fade_out_duration)
-                    .ResizeWidthTo(0, judgement_fade_out_duration, Easing.InQuint)
-                    .Expire();
             }
         }
 
diff --git a/osu.Game/Screens/Play/HUD/HitErrorMeters/ColourHitErrorMeter.cs b/osu.Game/Screens/Play/HUD/HitErrorMeters/ColourHitErrorMeter.cs
index 9948b968d1..285a2f8251 100644
--- a/osu.Game/Screens/Play/HUD/HitErrorMeters/ColourHitErrorMeter.cs
+++ b/osu.Game/Screens/Play/HUD/HitErrorMeters/ColourHitErrorMeter.cs
@@ -51,47 +51,37 @@ namespace osu.Game.Screens.Play.HUD.HitErrorMeters
                 Direction = FillDirection.Vertical;
                 LayoutDuration = animation_duration;
                 LayoutEasing = Easing.OutQuint;
+                AlwaysPresent = true;
             }
 
             public void Push(Color4 colour)
             {
-                Add(new HitErrorCircle(colour, drawable_judgement_size));
+                var hitErrorCircle = new HitErrorCircle(colour);
+
+                Add(hitErrorCircle);
+
+                hitErrorCircle.FadeInFromZero(animation_duration, Easing.OutQuint);
+                hitErrorCircle.MoveToY(-drawable_judgement_size);
+                hitErrorCircle.MoveToY(0, animation_duration, Easing.OutQuint);
 
                 if (Children.Count > MAX_DISPLAYED_JUDGEMENTS)
                     Children.FirstOrDefault(c => !c.IsRemoved)?.Remove();
             }
         }
 
-        internal class HitErrorCircle : Container
+        internal class HitErrorCircle : Circle
         {
             public bool IsRemoved { get; private set; }
 
-            private readonly Circle circle;
-
-            public HitErrorCircle(Color4 colour, int size)
+            public HitErrorCircle(Color4 colour)
             {
-                Size = new Vector2(size);
-                Child = circle = new Circle
-                {
-                    RelativeSizeAxes = Axes.Both,
-                    Alpha = 0,
-                    Colour = colour
-                };
-            }
-
-            protected override void LoadComplete()
-            {
-                base.LoadComplete();
-
-                circle.FadeInFromZero(animation_duration, Easing.OutQuint);
-                circle.MoveToY(-DrawSize.Y);
-                circle.MoveToY(0, animation_duration, Easing.OutQuint);
+                Colour = colour;
+                Size = new Vector2(drawable_judgement_size);
             }
 
             public void Remove()
             {
                 IsRemoved = true;
-
                 this.FadeOut(animation_duration, Easing.OutQuint).Expire();
             }
         }
diff --git a/osu.Game/Screens/Play/HUD/HitErrorMeters/HitErrorMeter.cs b/osu.Game/Screens/Play/HUD/HitErrorMeters/HitErrorMeter.cs
index 1f08cb8aa7..c4e738de28 100644
--- a/osu.Game/Screens/Play/HUD/HitErrorMeters/HitErrorMeter.cs
+++ b/osu.Game/Screens/Play/HUD/HitErrorMeters/HitErrorMeter.cs
@@ -37,6 +37,8 @@ namespace osu.Game.Screens.Play.HUD.HitErrorMeters
         {
             base.LoadComplete();
 
+            AlwaysPresent = true;
+
             if (gameplayClockContainer != null)
                 gameplayClockContainer.OnSeek += Clear;
 

From f997886142cf6fcad1e4c20078bb4f45be2f74cb Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 13 Jun 2022 17:18:32 +0900
Subject: [PATCH 5394/5547] Add scrolling gameplay visualisation mode to
 latency certifier

---
 .../TestSceneLatencyCertifierScreen.cs        |   6 +
 osu.Game/Screens/Utility/LatencyArea.cs       |  14 ++
 osu.Game/Screens/Utility/LatencyVisualMode.cs |   1 +
 osu.Game/Screens/Utility/ScrollingGameplay.cs | 201 ++++++++++++++++++
 4 files changed, 222 insertions(+)
 create mode 100644 osu.Game/Screens/Utility/ScrollingGameplay.cs

diff --git a/osu.Game.Tests/Visual/Settings/TestSceneLatencyCertifierScreen.cs b/osu.Game.Tests/Visual/Settings/TestSceneLatencyCertifierScreen.cs
index d6e0f995e5..fe14935479 100644
--- a/osu.Game.Tests/Visual/Settings/TestSceneLatencyCertifierScreen.cs
+++ b/osu.Game.Tests/Visual/Settings/TestSceneLatencyCertifierScreen.cs
@@ -36,6 +36,12 @@ namespace osu.Game.Tests.Visual.Settings
             AddStep("set visual mode to circles", () => latencyCertifier.VisualMode.Value = LatencyVisualMode.CircleGameplay);
         }
 
+        [Test]
+        public void TestScrollingGameplay()
+        {
+            AddStep("set visual mode to scrolling", () => latencyCertifier.VisualMode.Value = LatencyVisualMode.ScrollingGameplay);
+        }
+
         [Test]
         public void TestCycleVisualModes()
         {
diff --git a/osu.Game/Screens/Utility/LatencyArea.cs b/osu.Game/Screens/Utility/LatencyArea.cs
index 3b9e95ce16..21688f0b0c 100644
--- a/osu.Game/Screens/Utility/LatencyArea.cs
+++ b/osu.Game/Screens/Utility/LatencyArea.cs
@@ -108,6 +108,20 @@ namespace osu.Game.Screens.Utility
                         };
                         break;
 
+                    case LatencyVisualMode.ScrollingGameplay:
+                        visualContent.Children = new Drawable[]
+                        {
+                            new ScrollingGameplay
+                            {
+                                RelativeSizeAxes = Axes.Both,
+                            },
+                            new LatencyCursorContainer
+                            {
+                                RelativeSizeAxes = Axes.Both,
+                            },
+                        };
+                        break;
+
                     default:
                         throw new ArgumentOutOfRangeException();
                 }
diff --git a/osu.Game/Screens/Utility/LatencyVisualMode.cs b/osu.Game/Screens/Utility/LatencyVisualMode.cs
index f9f51f0829..cc15f79be8 100644
--- a/osu.Game/Screens/Utility/LatencyVisualMode.cs
+++ b/osu.Game/Screens/Utility/LatencyVisualMode.cs
@@ -7,6 +7,7 @@ namespace osu.Game.Screens.Utility
     public enum LatencyVisualMode
     {
         CircleGameplay,
+        ScrollingGameplay,
         Simple,
     }
 }
diff --git a/osu.Game/Screens/Utility/ScrollingGameplay.cs b/osu.Game/Screens/Utility/ScrollingGameplay.cs
new file mode 100644
index 0000000000..a32fd3b37f
--- /dev/null
+++ b/osu.Game/Screens/Utility/ScrollingGameplay.cs
@@ -0,0 +1,201 @@
+// 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 enable
+using System;
+using System.Collections.Generic;
+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.Input.States;
+using osu.Game.Beatmaps;
+using osu.Game.Rulesets.Objects;
+using osu.Game.Rulesets.Scoring;
+using osu.Game.Screens.Utility.SampleComponents;
+using osuTK;
+using osuTK.Input;
+
+namespace osu.Game.Screens.Utility
+{
+    public class ScrollingGameplay : LatencySampleComponent
+    {
+        private const float judgement_position = 0.8f;
+        private const float bar_height = 20;
+
+        private int nextLocation;
+
+        private readonly List<HitEvent> hitEvents = new List<HitEvent>();
+
+        private double? lastGeneratedBeatTime;
+
+        private Container circles = null!;
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            InternalChildren = new Drawable[]
+            {
+                new Box
+                {
+                    Name = "judgement bar",
+                    Colour = OverlayColourProvider.Content2,
+                    RelativeSizeAxes = Axes.X,
+                    RelativePositionAxes = Axes.Y,
+                    Y = judgement_position,
+                    Height = bar_height,
+                },
+                circles = new Container
+                {
+                    RelativeSizeAxes = Axes.Both,
+                },
+            };
+
+            SampleBPM.BindValueChanged(_ =>
+            {
+                circles.Clear();
+                lastGeneratedBeatTime = null;
+            });
+        }
+
+        protected override void UpdateAtLimitedRate(InputState inputState)
+        {
+            double beatLength = 60000 / SampleBPM.Value;
+
+            int nextBeat = (int)(Clock.CurrentTime / beatLength) + 1;
+
+            // We want to generate a few hit objects ahead of the current time (to allow them to animate).
+            double generateUpTo = (nextBeat + 2) * beatLength;
+
+            while (lastGeneratedBeatTime == null || lastGeneratedBeatTime < generateUpTo)
+            {
+                double time = ++nextBeat * beatLength;
+
+                if (time <= lastGeneratedBeatTime)
+                    continue;
+
+                newBeat(time);
+                lastGeneratedBeatTime = time;
+            }
+        }
+
+        private void newBeat(double time)
+        {
+            const float columns = 4;
+
+            float adjustedXPos = ((1f + nextLocation++ % columns) - columns / 2) / columns;
+
+            circles.Add(new SampleNote(time)
+            {
+                RelativePositionAxes = Axes.Both,
+                X = 0.5f + SampleVisualSpacing.Value * (adjustedXPos * 0.5f),
+                Scale = new Vector2(0.4f + (0.8f * SampleVisualSpacing.Value), 1),
+                Hit = hit,
+            });
+        }
+
+        private void hit(HitEvent h)
+        {
+            hitEvents.Add(h);
+        }
+
+        public class SampleNote : LatencySampleComponent
+        {
+            public HitEvent? HitEvent;
+
+            public Action<HitEvent>? Hit { get; set; }
+
+            public readonly double HitTime;
+
+            private Box box = null!;
+
+            private const float size = 100;
+            private const float duration = 200;
+
+            public SampleNote(double hitTime)
+            {
+                HitTime = hitTime;
+
+                Origin = Anchor.Centre;
+                AutoSizeAxes = Axes.Both;
+                AlwaysPresent = true;
+            }
+
+            [BackgroundDependencyLoader]
+            private void load()
+            {
+                InternalChildren = new Drawable[]
+                {
+                    box = new Box
+                    {
+                        Colour = OverlayColourProvider.Content1,
+                        Size = new Vector2(size, bar_height),
+                        Anchor = Anchor.Centre,
+                        Origin = Anchor.Centre,
+                    },
+                };
+            }
+
+            protected override bool OnKeyDown(KeyDownEvent e)
+            {
+                if (!IsActive.Value)
+                    return false;
+
+                if (Math.Abs(Clock.CurrentTime - HitTime) > duration)
+                    return false;
+
+                // Allow using any key that isn't used by the latency certifier itself.
+                switch (e.Key)
+                {
+                    case Key.Space:
+                    case Key.Number1:
+                    case Key.Number2:
+                    case Key.Tab:
+                        return false;
+                }
+
+                attemptHit();
+                return true;
+            }
+
+            protected override void UpdateAtLimitedRate(InputState inputState)
+            {
+                if (HitEvent == null)
+                {
+                    double preempt = (float)IBeatmapDifficultyInfo.DifficultyRange(SampleApproachRate.Value, 1800, 1200, 450);
+
+                    Alpha = (float)MathHelper.Clamp((Clock.CurrentTime - HitTime + 600) / 400, 0, 1);
+                    Y = judgement_position - (float)((HitTime - Clock.CurrentTime) / preempt);
+
+                    if (Clock.CurrentTime > HitTime + duration)
+                        Expire();
+                }
+            }
+
+            private void attemptHit() => Schedule(() =>
+            {
+                if (HitEvent != null)
+                    return;
+
+                // in case it was hit outside of display range, show immediately
+                // so the user isn't confused.
+                this.FadeIn();
+
+                box
+                    .FadeOut(duration / 2)
+                    .ScaleTo(1.5f, duration / 2);
+
+                HitEvent = new HitEvent(Clock.CurrentTime - HitTime, HitResult.Good, new HitObject
+                {
+                    HitWindows = new HitWindows(),
+                }, null, null);
+
+                Hit?.Invoke(HitEvent.Value);
+
+                this.Delay(duration).Expire();
+            });
+        }
+    }
+}

From 336df62a1fb0c6d3556db8e348ebbb0f9233d97f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 13 Jun 2022 18:57:29 +0900
Subject: [PATCH 5395/5547] Remove unnecessary file existence check

This is not required due to `createFileInfos` always being run before we
get to this point (I believe this was added after the initial code to
check existence was added).

This flow is covered in
`BeatmapImportTests.TestImportThenReimportAfterMissingFiles`, which
still passes with the change.

While this check isn't doing any harm, as I'm going through the flow for
import-skipping, less checks are appreciated.
---
 osu.Game/Stores/RealmArchiveModelImporter.cs | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/osu.Game/Stores/RealmArchiveModelImporter.cs b/osu.Game/Stores/RealmArchiveModelImporter.cs
index 6d1449a4b4..e7477cfffc 100644
--- a/osu.Game/Stores/RealmArchiveModelImporter.cs
+++ b/osu.Game/Stores/RealmArchiveModelImporter.cs
@@ -521,8 +521,7 @@ namespace osu.Game.Stores
             // for the best or worst, we copy and import files of a new import before checking whether
             // it is a duplicate. so to check if anything has changed, we can just compare all File IDs.
             getIDs(existing.Files).SequenceEqual(getIDs(import.Files)) &&
-            getFilenames(existing.Files).SequenceEqual(getFilenames(import.Files)) &&
-            checkAllFilesExist(existing);
+            getFilenames(existing.Files).SequenceEqual(getFilenames(import.Files));
 
         private bool checkAllFilesExist(TModel model) =>
             model.Files.All(f => Files.Storage.Exists(f.File.GetStoragePath()));

From b300bc1e24d758416e2f6c1e2e27621e44b0cdee Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Mon, 13 Jun 2022 20:41:32 +0900
Subject: [PATCH 5396/5547] Fix ever-increasing flashlight-strain

---
 osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
index bd8e962122..f5b8afb40a 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
@@ -33,7 +33,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
         protected override double StrainValueAt(DifficultyHitObject current)
         {
             currentStrain *= strainDecay(current.DeltaTime);
-            currentStrain += currentStrain += FlashlightEvaluator.EvaluateDifficultyOf(current, Mods.Any(m => m is OsuModHidden)) * skillMultiplier;
+            currentStrain += FlashlightEvaluator.EvaluateDifficultyOf(current, Mods.Any(m => m is OsuModHidden)) * skillMultiplier;
 
             return currentStrain;
         }

From f73142c50f841711baf3a5354a919cdbb51d97de Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Mon, 13 Jun 2022 20:43:54 +0900
Subject: [PATCH 5397/5547] Remove for loop

---
 osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
index f5b8afb40a..590ab6ea61 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
@@ -15,9 +15,12 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
     /// </summary>
     public class Flashlight : OsuStrainSkill
     {
+        private readonly bool hasHiddenMod;
+
         public Flashlight(Mod[] mods)
             : base(mods)
         {
+            hasHiddenMod = mods.Any(m => m is OsuModHidden);
         }
 
         private double skillMultiplier => 0.05;
@@ -33,7 +36,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
         protected override double StrainValueAt(DifficultyHitObject current)
         {
             currentStrain *= strainDecay(current.DeltaTime);
-            currentStrain += FlashlightEvaluator.EvaluateDifficultyOf(current, Mods.Any(m => m is OsuModHidden)) * skillMultiplier;
+            currentStrain += FlashlightEvaluator.EvaluateDifficultyOf(current, hasHiddenMod) * skillMultiplier;
 
             return currentStrain;
         }

From bd9ea9bd6fa8f1717e601ef5b7c24076714875e2 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 13 Jun 2022 23:54:43 +0900
Subject: [PATCH 5398/5547] Revert most unnecessary changes

Turns out `AlwaysPresent` at top level is actually enough.

This reverts commit 86163d2225157af9c874af5b2dd59208572f8349.
---
 .../HUD/HitErrorMeters/BarHitErrorMeter.cs    | 35 +++++++++----------
 .../HUD/HitErrorMeters/ColourHitErrorMeter.cs | 34 +++++++++++-------
 .../Play/HUD/HitErrorMeters/HitErrorMeter.cs  |  5 +--
 3 files changed, 41 insertions(+), 33 deletions(-)

diff --git a/osu.Game/Screens/Play/HUD/HitErrorMeters/BarHitErrorMeter.cs b/osu.Game/Screens/Play/HUD/HitErrorMeters/BarHitErrorMeter.cs
index 79fd22eb0e..dca50c07ad 100644
--- a/osu.Game/Screens/Play/HUD/HitErrorMeters/BarHitErrorMeter.cs
+++ b/osu.Game/Screens/Play/HUD/HitErrorMeters/BarHitErrorMeter.cs
@@ -400,9 +400,6 @@ namespace osu.Game.Screens.Play.HUD.HitErrorMeters
         {
             const int arrow_move_duration = 800;
 
-            const int judgement_fade_in_duration = 100;
-            const int judgement_fade_out_duration = 5000;
-
             if (!judgement.IsHit || judgement.HitObject.HitWindows?.WindowFor(HitResult.Miss) == 0)
                 return;
 
@@ -423,26 +420,12 @@ namespace osu.Game.Screens.Play.HUD.HitErrorMeters
                 }
             }
 
-            var judgementLine = new JudgementLine
+            judgementsContainer.Add(new JudgementLine
             {
                 JudgementLineThickness = { BindTarget = JudgementLineThickness },
                 Y = getRelativeJudgementPosition(judgement.TimeOffset),
                 Colour = GetColourForHitResult(judgement.Type),
-                Alpha = 0,
-                Width = 0,
-            };
-
-            judgementsContainer.Add(judgementLine);
-
-            // Importantly, transforms should be applied in this method rather than constructed drawables
-            // to ensure that they are applied even when the `HitErrorMeter` is hidden (see `AlwaysPresent` usage).
-            judgementLine
-                .FadeTo(0.6f, judgement_fade_in_duration, Easing.OutQuint)
-                .ResizeWidthTo(1, judgement_fade_in_duration, Easing.OutQuint)
-                .Then()
-                .FadeOut(judgement_fade_out_duration)
-                .ResizeWidthTo(0, judgement_fade_out_duration, Easing.InQuint)
-                .Expire();
+            });
 
             arrow.MoveToY(
                 getRelativeJudgementPosition(floatingAverage = floatingAverage * 0.9 + judgement.TimeOffset * 0.1)
@@ -473,9 +456,23 @@ namespace osu.Game.Screens.Play.HUD.HitErrorMeters
 
             protected override void LoadComplete()
             {
+                const int judgement_fade_in_duration = 100;
+                const int judgement_fade_out_duration = 5000;
+
                 base.LoadComplete();
 
+                Alpha = 0;
+                Width = 0;
+
                 JudgementLineThickness.BindValueChanged(thickness => Height = thickness.NewValue, true);
+
+                this
+                    .FadeTo(0.6f, judgement_fade_in_duration, Easing.OutQuint)
+                    .ResizeWidthTo(1, judgement_fade_in_duration, Easing.OutQuint)
+                    .Then()
+                    .FadeOut(judgement_fade_out_duration)
+                    .ResizeWidthTo(0, judgement_fade_out_duration, Easing.InQuint)
+                    .Expire();
             }
         }
 
diff --git a/osu.Game/Screens/Play/HUD/HitErrorMeters/ColourHitErrorMeter.cs b/osu.Game/Screens/Play/HUD/HitErrorMeters/ColourHitErrorMeter.cs
index 285a2f8251..9948b968d1 100644
--- a/osu.Game/Screens/Play/HUD/HitErrorMeters/ColourHitErrorMeter.cs
+++ b/osu.Game/Screens/Play/HUD/HitErrorMeters/ColourHitErrorMeter.cs
@@ -51,37 +51,47 @@ namespace osu.Game.Screens.Play.HUD.HitErrorMeters
                 Direction = FillDirection.Vertical;
                 LayoutDuration = animation_duration;
                 LayoutEasing = Easing.OutQuint;
-                AlwaysPresent = true;
             }
 
             public void Push(Color4 colour)
             {
-                var hitErrorCircle = new HitErrorCircle(colour);
-
-                Add(hitErrorCircle);
-
-                hitErrorCircle.FadeInFromZero(animation_duration, Easing.OutQuint);
-                hitErrorCircle.MoveToY(-drawable_judgement_size);
-                hitErrorCircle.MoveToY(0, animation_duration, Easing.OutQuint);
+                Add(new HitErrorCircle(colour, drawable_judgement_size));
 
                 if (Children.Count > MAX_DISPLAYED_JUDGEMENTS)
                     Children.FirstOrDefault(c => !c.IsRemoved)?.Remove();
             }
         }
 
-        internal class HitErrorCircle : Circle
+        internal class HitErrorCircle : Container
         {
             public bool IsRemoved { get; private set; }
 
-            public HitErrorCircle(Color4 colour)
+            private readonly Circle circle;
+
+            public HitErrorCircle(Color4 colour, int size)
             {
-                Colour = colour;
-                Size = new Vector2(drawable_judgement_size);
+                Size = new Vector2(size);
+                Child = circle = new Circle
+                {
+                    RelativeSizeAxes = Axes.Both,
+                    Alpha = 0,
+                    Colour = colour
+                };
+            }
+
+            protected override void LoadComplete()
+            {
+                base.LoadComplete();
+
+                circle.FadeInFromZero(animation_duration, Easing.OutQuint);
+                circle.MoveToY(-DrawSize.Y);
+                circle.MoveToY(0, animation_duration, Easing.OutQuint);
             }
 
             public void Remove()
             {
                 IsRemoved = true;
+
                 this.FadeOut(animation_duration, Easing.OutQuint).Expire();
             }
         }
diff --git a/osu.Game/Screens/Play/HUD/HitErrorMeters/HitErrorMeter.cs b/osu.Game/Screens/Play/HUD/HitErrorMeters/HitErrorMeter.cs
index c4e738de28..e7aaee9fa1 100644
--- a/osu.Game/Screens/Play/HUD/HitErrorMeters/HitErrorMeter.cs
+++ b/osu.Game/Screens/Play/HUD/HitErrorMeters/HitErrorMeter.cs
@@ -31,14 +31,15 @@ namespace osu.Game.Screens.Play.HUD.HitErrorMeters
         private void load(DrawableRuleset drawableRuleset)
         {
             HitWindows = drawableRuleset?.FirstAvailableHitWindows ?? HitWindows.Empty;
+
+            // This is to allow the visual state to be correct after HUD comes visible after being hidden.
+            AlwaysPresent = true;
         }
 
         protected override void LoadComplete()
         {
             base.LoadComplete();
 
-            AlwaysPresent = true;
-
             if (gameplayClockContainer != null)
                 gameplayClockContainer.OnSeek += Clear;
 

From 737197591d812d0abdbf733d05bd4e411b050a9a Mon Sep 17 00:00:00 2001
From: apollo-dw <83023433+apollo-dw@users.noreply.github.com>
Date: Mon, 13 Jun 2022 17:49:56 +0100
Subject: [PATCH 5399/5547] Change doubletap algorithm

---
 .../Difficulty/Evaluators/SpeedEvaluator.cs    | 18 ++++++++++++------
 .../Difficulty/Skills/Speed.cs                 |  3 ++-
 2 files changed, 14 insertions(+), 7 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Evaluators/SpeedEvaluator.cs b/osu.Game.Rulesets.Osu/Difficulty/Evaluators/SpeedEvaluator.cs
index 85203dd157..e68e7a8653 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Evaluators/SpeedEvaluator.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Evaluators/SpeedEvaluator.cs
@@ -2,7 +2,6 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
-using osu.Framework.Utils;
 using osu.Game.Rulesets.Difficulty.Preprocessing;
 using osu.Game.Rulesets.Osu.Difficulty.Preprocessing;
 using osu.Game.Rulesets.Osu.Objects;
@@ -31,14 +30,21 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Evaluators
             // derive strainTime for calculation
             var osuCurrObj = (OsuDifficultyHitObject)current;
             var osuPrevObj = current.Index > 0 ? (OsuDifficultyHitObject)current.Previous(0) : null;
+            var osuNextObj = (OsuDifficultyHitObject)current.Next(0);
 
             double strainTime = osuCurrObj.StrainTime;
             double greatWindowFull = greatWindow * 2;
-            double speedWindowRatio = strainTime / greatWindowFull;
+            double doubletapness = 1;
 
-            // Aim to nerf cheesy rhythms (Very fast consecutive doubles with large deltatimes between)
-            if (osuPrevObj != null && strainTime < greatWindowFull && osuPrevObj.StrainTime > strainTime)
-                strainTime = Interpolation.Lerp(osuPrevObj.StrainTime, strainTime, speedWindowRatio);
+            // Nerf doubletappable doubles.
+            if (osuNextObj != null)
+            {
+                double currDeltaTime = Math.Max(1, osuCurrObj.DeltaTime);
+                double nextDeltaTime = Math.Max(1, osuNextObj.DeltaTime);
+                double speedRatio = Math.Min(1, currDeltaTime / nextDeltaTime);
+                double windowRatio = Math.Min(1, currDeltaTime / greatWindowFull);
+                doubletapness = Math.Pow(speedRatio, 1 - windowRatio);
+            }
 
             // Cap deltatime to the OD 300 hitwindow.
             // 0.93 is derived from making sure 260bpm OD8 streams aren't nerfed harshly, whilst 0.92 limits the effect of the cap.
@@ -53,7 +59,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Evaluators
             double travelDistance = osuPrevObj?.TravelDistance ?? 0;
             double distance = Math.Min(single_spacing_threshold, travelDistance + osuCurrObj.MinimumJumpDistance);
 
-            return (speedBonus + speedBonus * Math.Pow(distance / single_spacing_threshold, 3.5)) / strainTime;
+            return (speedBonus + speedBonus * Math.Pow(distance / single_spacing_threshold, 3.5)) * doubletapness / strainTime;
         }
     }
 }
diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Speed.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Speed.cs
index 055e1cb66e..3e4e55262c 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Speed.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Speed.cs
@@ -5,6 +5,7 @@ using System;
 using osu.Game.Rulesets.Difficulty.Preprocessing;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Osu.Difficulty.Evaluators;
+using osu.Game.Rulesets.Osu.Difficulty.Preprocessing;
 
 namespace osu.Game.Rulesets.Osu.Difficulty.Skills
 {
@@ -35,7 +36,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Skills
 
         protected override double StrainValueAt(DifficultyHitObject current)
         {
-            currentStrain *= strainDecay(current.DeltaTime);
+            currentStrain *= strainDecay(((OsuDifficultyHitObject)current).StrainTime);
             currentStrain += SpeedEvaluator.EvaluateDifficultyOf(current, greatWindow) * skillMultiplier;
 
             currentRhythm = RhythmEvaluator.EvaluateDifficultyOf(current, greatWindow);

From 9fc04924eba411f1bcdf6794fa694718abac34ff Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Tue, 14 Jun 2022 00:02:02 +0300
Subject: [PATCH 5400/5547] Revert "Provide context menu items at
 `BlueprintContainer` for out-of-bounds support"

This reverts commit 85fc218edf0d8f2c688af226265ef3e9373c5a4c.
---
 .../Compose/Components/BlueprintContainer.cs  | 30 +------------------
 .../Components/EditorSelectionHandler.cs      |  2 +-
 .../Compose/Components/SelectionHandler.cs    | 28 +++++++++++++++--
 .../Skinning/Editor/SkinSelectionHandler.cs   |  2 +-
 4 files changed, 28 insertions(+), 34 deletions(-)

diff --git a/osu.Game/Screens/Edit/Compose/Components/BlueprintContainer.cs b/osu.Game/Screens/Edit/Compose/Components/BlueprintContainer.cs
index 5fdd7c0e81..d56dc176f6 100644
--- a/osu.Game/Screens/Edit/Compose/Components/BlueprintContainer.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/BlueprintContainer.cs
@@ -11,14 +11,11 @@ using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
-using osu.Framework.Graphics.Cursor;
 using osu.Framework.Graphics.Primitives;
-using osu.Framework.Graphics.UserInterface;
 using osu.Framework.Input;
 using osu.Framework.Input.Bindings;
 using osu.Framework.Input.Events;
 using osu.Game.Graphics.UserInterface;
-using osu.Game.Resources.Localisation.Web;
 using osu.Game.Rulesets.Edit;
 using osuTK;
 using osuTK.Input;
@@ -29,7 +26,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
     /// A container which provides a "blueprint" display of items.
     /// Includes selection and manipulation support via a <see cref="Components.SelectionHandler{T}"/>.
     /// </summary>
-    public abstract class BlueprintContainer<T> : CompositeDrawable, IKeyBindingHandler<PlatformAction>, IHasContextMenu
+    public abstract class BlueprintContainer<T> : CompositeDrawable, IKeyBindingHandler<PlatformAction>
         where T : class
     {
         protected DragBox DragBox { get; private set; }
@@ -537,30 +534,5 @@ namespace osu.Game.Screens.Edit.Compose.Components
         }
 
         #endregion
-
-        #region Context Menu
-
-        public MenuItem[] ContextMenuItems
-        {
-            get
-            {
-                var selectedBlueprints = SelectionHandler.SelectedBlueprints;
-                if (!selectedBlueprints.Any(b => b.IsHovered))
-                    return Array.Empty<MenuItem>();
-
-                var items = new List<MenuItem>();
-
-                items.AddRange(SelectionHandler.GetContextMenuItemsForSelection(selectedBlueprints));
-
-                if (selectedBlueprints.Count == 1)
-                    items.AddRange(selectedBlueprints[0].ContextMenuItems);
-
-                items.Add(new OsuMenuItem(CommonStrings.ButtonsDelete, MenuItemType.Destructive, SelectionHandler.DeleteSelected));
-
-                return items.ToArray();
-            }
-        }
-
-        #endregion
     }
 }
diff --git a/osu.Game/Screens/Edit/Compose/Components/EditorSelectionHandler.cs b/osu.Game/Screens/Edit/Compose/Components/EditorSelectionHandler.cs
index 5fa98aea01..7f693996a4 100644
--- a/osu.Game/Screens/Edit/Compose/Components/EditorSelectionHandler.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/EditorSelectionHandler.cs
@@ -165,7 +165,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
         /// </summary>
         /// <param name="selection">The current selection.</param>
         /// <returns>The relevant menu items.</returns>
-        protected internal override IEnumerable<MenuItem> GetContextMenuItemsForSelection(IEnumerable<SelectionBlueprint<HitObject>> selection)
+        protected override IEnumerable<MenuItem> GetContextMenuItemsForSelection(IEnumerable<SelectionBlueprint<HitObject>> selection)
         {
             if (SelectedBlueprints.All(b => b.Item is IHasComboInformation))
             {
diff --git a/osu.Game/Screens/Edit/Compose/Components/SelectionHandler.cs b/osu.Game/Screens/Edit/Compose/Components/SelectionHandler.cs
index d4ffb67a51..78b98a3649 100644
--- a/osu.Game/Screens/Edit/Compose/Components/SelectionHandler.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/SelectionHandler.cs
@@ -8,6 +8,7 @@ using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.Cursor;
 using osu.Framework.Graphics.Primitives;
 using osu.Framework.Graphics.UserInterface;
 using osu.Framework.Input;
@@ -16,6 +17,7 @@ using osu.Framework.Input.Events;
 using osu.Framework.Utils;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Input.Bindings;
+using osu.Game.Resources.Localisation.Web;
 using osu.Game.Rulesets.Edit;
 using osuTK;
 using osuTK.Input;
@@ -25,7 +27,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
     /// <summary>
     /// A component which outlines items and handles movement of selections.
     /// </summary>
-    public abstract class SelectionHandler<T> : CompositeDrawable, IKeyBindingHandler<PlatformAction>, IKeyBindingHandler<GlobalAction>
+    public abstract class SelectionHandler<T> : CompositeDrawable, IKeyBindingHandler<PlatformAction>, IKeyBindingHandler<GlobalAction>, IHasContextMenu
     {
         /// <summary>
         /// The currently selected blueprints.
@@ -290,7 +292,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
             return true;
         }
 
-        protected internal void DeleteSelected()
+        protected void DeleteSelected()
         {
             DeleteItems(selectedBlueprints.Select(b => b.Item));
         }
@@ -343,12 +345,32 @@ namespace osu.Game.Screens.Edit.Compose.Components
 
         #region Context Menu
 
+        public MenuItem[] ContextMenuItems
+        {
+            get
+            {
+                if (!SelectedBlueprints.Any(b => b.IsHovered))
+                    return Array.Empty<MenuItem>();
+
+                var items = new List<MenuItem>();
+
+                items.AddRange(GetContextMenuItemsForSelection(SelectedBlueprints));
+
+                if (SelectedBlueprints.Count == 1)
+                    items.AddRange(SelectedBlueprints[0].ContextMenuItems);
+
+                items.Add(new OsuMenuItem(CommonStrings.ButtonsDelete, MenuItemType.Destructive, DeleteSelected));
+
+                return items.ToArray();
+            }
+        }
+
         /// <summary>
         /// Provide context menu items relevant to current selection. Calling base is not required.
         /// </summary>
         /// <param name="selection">The current selection.</param>
         /// <returns>The relevant menu items.</returns>
-        protected internal virtual IEnumerable<MenuItem> GetContextMenuItemsForSelection(IEnumerable<SelectionBlueprint<T>> selection)
+        protected virtual IEnumerable<MenuItem> GetContextMenuItemsForSelection(IEnumerable<SelectionBlueprint<T>> selection)
             => Enumerable.Empty<MenuItem>();
 
         #endregion
diff --git a/osu.Game/Skinning/Editor/SkinSelectionHandler.cs b/osu.Game/Skinning/Editor/SkinSelectionHandler.cs
index 3ead8fee17..943425e099 100644
--- a/osu.Game/Skinning/Editor/SkinSelectionHandler.cs
+++ b/osu.Game/Skinning/Editor/SkinSelectionHandler.cs
@@ -180,7 +180,7 @@ namespace osu.Game.Skinning.Editor
         protected override void DeleteItems(IEnumerable<ISkinnableDrawable> items) =>
             skinEditor.DeleteItems(items.ToArray());
 
-        protected internal override IEnumerable<MenuItem> GetContextMenuItemsForSelection(IEnumerable<SelectionBlueprint<ISkinnableDrawable>> selection)
+        protected override IEnumerable<MenuItem> GetContextMenuItemsForSelection(IEnumerable<SelectionBlueprint<ISkinnableDrawable>> selection)
         {
             var closestItem = new TernaryStateRadioMenuItem("Closest", MenuItemType.Standard, _ => applyClosestAnchors())
             {

From c49b8e4a5cc4ae14c9dd25d2030c7410bb1f1dba Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Tue, 14 Jun 2022 00:19:15 +0300
Subject: [PATCH 5401/5547] Allow `BlueprintContainer` and `SelectionHandler`
 to receive input outside bounds

---
 .../Screens/Edit/Compose/Components/BlueprintContainer.cs  | 7 +++++++
 .../Edit/Compose/Components/ComposeBlueprintContainer.cs   | 2 --
 .../Screens/Edit/Compose/Components/SelectionHandler.cs    | 7 +++++++
 3 files changed, 14 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/Edit/Compose/Components/BlueprintContainer.cs b/osu.Game/Screens/Edit/Compose/Components/BlueprintContainer.cs
index d56dc176f6..fbec80a63b 100644
--- a/osu.Game/Screens/Edit/Compose/Components/BlueprintContainer.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/BlueprintContainer.cs
@@ -106,6 +106,13 @@ namespace osu.Game.Screens.Edit.Compose.Components
         /// </summary>
         protected virtual bool AllowDeselectionDuringDrag => true;
 
+        /// <remarks>
+        /// Positional input must be received outside the container's bounds,
+        /// in order to handle blueprints which are partially offscreen.
+        /// </remarks>
+        /// <seealso cref="SelectionHandler{T}.ReceivePositionalInputAt"/>
+        public override bool ReceivePositionalInputAt(Vector2 screenSpacePos) => true;
+
         protected override bool OnMouseDown(MouseDownEvent e)
         {
             bool selectionPerformed = performMouseDownActions(e);
diff --git a/osu.Game/Screens/Edit/Compose/Components/ComposeBlueprintContainer.cs b/osu.Game/Screens/Edit/Compose/Components/ComposeBlueprintContainer.cs
index 68be20720d..0be2cb4462 100644
--- a/osu.Game/Screens/Edit/Compose/Components/ComposeBlueprintContainer.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/ComposeBlueprintContainer.cs
@@ -30,8 +30,6 @@ namespace osu.Game.Screens.Edit.Compose.Components
     /// </summary>
     public class ComposeBlueprintContainer : EditorBlueprintContainer
     {
-        public override bool ReceivePositionalInputAt(Vector2 screenSpacePos) => true;
-
         private readonly Container<PlacementBlueprint> placementBlueprintContainer;
 
         protected new EditorSelectionHandler SelectionHandler => (EditorSelectionHandler)base.SelectionHandler;
diff --git a/osu.Game/Screens/Edit/Compose/Components/SelectionHandler.cs b/osu.Game/Screens/Edit/Compose/Components/SelectionHandler.cs
index 78b98a3649..e5020afcde 100644
--- a/osu.Game/Screens/Edit/Compose/Components/SelectionHandler.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/SelectionHandler.cs
@@ -97,6 +97,13 @@ namespace osu.Game.Screens.Edit.Compose.Components
 
         #region User Input Handling
 
+        /// <remarks>
+        /// Positional input must be received outside the container's bounds,
+        /// in order to handle blueprints which are partially offscreen.
+        /// </remarks>
+        /// <seealso cref="BlueprintContainer{T}.ReceivePositionalInputAt"/>
+        public override bool ReceivePositionalInputAt(Vector2 screenSpacePos) => true;
+
         /// <summary>
         /// Handles the selected items being moved.
         /// </summary>

From fa4930c5865a414bb3d1d811cbca69b9a08f2c13 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Tue, 14 Jun 2022 00:19:47 +0300
Subject: [PATCH 5402/5547] Remove no longer necessary
 `ReceivePositionalInputAt` overrides in timeline components

---
 .../Components/Timeline/TimelineBlueprintContainer.cs      | 3 ---
 .../Components/Timeline/TimelineSelectionHandler.cs        | 7 -------
 2 files changed, 10 deletions(-)

diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineBlueprintContainer.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineBlueprintContainer.cs
index a9e9ef5001..1c0c2fb215 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineBlueprintContainer.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineBlueprintContainer.cs
@@ -33,9 +33,6 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
         private Bindable<HitObject> placement;
         private SelectionBlueprint<HitObject> placementBlueprint;
 
-        // We want children within the timeline to be interactable
-        public override bool ReceivePositionalInputAt(Vector2 screenSpacePos) => timeline.ScreenSpaceDrawQuad.Contains(screenSpacePos);
-
         public TimelineBlueprintContainer(HitObjectComposer composer)
             : base(composer)
         {
diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineSelectionHandler.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineSelectionHandler.cs
index e98cf8332f..da12ab521f 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineSelectionHandler.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineSelectionHandler.cs
@@ -6,23 +6,16 @@ using System.Collections.Generic;
 using System.Diagnostics;
 using System.Linq;
 using JetBrains.Annotations;
-using osu.Framework.Allocation;
 using osu.Framework.Input.Events;
 using osu.Game.Input.Bindings;
 using osu.Game.Rulesets.Edit;
 using osu.Game.Rulesets.Objects;
-using osuTK;
 using osuTK.Input;
 
 namespace osu.Game.Screens.Edit.Compose.Components.Timeline
 {
     internal class TimelineSelectionHandler : EditorSelectionHandler
     {
-        [Resolved]
-        private Timeline timeline { get; set; }
-
-        public override bool ReceivePositionalInputAt(Vector2 screenSpacePos) => timeline.ScreenSpaceDrawQuad.Contains(screenSpacePos);
-
         // for now we always allow movement. snapping is provided by the Timeline's "distance" snap implementation
         public override bool HandleMovement(MoveSelectionEvent<HitObject> moveEvent) => true;
 

From a20e43c2ae9f7fad40736eb8658a2245731b782d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 14 Jun 2022 18:22:23 +0900
Subject: [PATCH 5403/5547] Ensure containers which are being used to hide HUD
 elements still update for now

I don't think this is necessarily a final solution (as this means all
HUD elements are adding overhead even when not visible), but this will
make the implementations much easier for the time being.

I've checked and can't notice any perceivable overhead in profiling so
we should be fine for now.
---
 osu.Game/Screens/Play/HUDOverlay.cs | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Play/HUDOverlay.cs b/osu.Game/Screens/Play/HUDOverlay.cs
index f6087e0958..6419532221 100644
--- a/osu.Game/Screens/Play/HUDOverlay.cs
+++ b/osu.Game/Screens/Play/HUDOverlay.cs
@@ -86,7 +86,10 @@ namespace osu.Game.Screens.Play
             Children = new Drawable[]
             {
                 CreateFailingLayer(),
-                mainComponents = new MainComponentsContainer(),
+                mainComponents = new MainComponentsContainer
+                {
+                    AlwaysPresent = true,
+                },
                 topRightElements = new FillFlowContainer
                 {
                     Anchor = Anchor.TopRight,
@@ -108,6 +111,7 @@ namespace osu.Game.Screens.Play
                     Margin = new MarginPadding(10),
                     Spacing = new Vector2(10),
                     AutoSizeAxes = Axes.Both,
+                    AlwaysPresent = true,
                     LayoutDuration = FADE_DURATION / 2,
                     LayoutEasing = FADE_EASING,
                     Direction = FillDirection.Vertical,

From 0147a8ecee356c4454dda943ad6f9c5f5bc0bcf2 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 14 Jun 2022 18:35:33 +0900
Subject: [PATCH 5404/5547] Add test coverage of HUD components still getting
 updated when hidden

---
 .../Visual/Gameplay/TestSceneHUDOverlay.cs    | 23 ++++++++++++++++++-
 1 file changed, 22 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneHUDOverlay.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneHUDOverlay.cs
index 83c557ee51..949f0f667b 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneHUDOverlay.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneHUDOverlay.cs
@@ -14,6 +14,7 @@ using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Scoring;
 using osu.Game.Screens.Play;
+using osu.Game.Screens.Play.HUD.HitErrorMeters;
 using osu.Game.Skinning;
 using osu.Game.Tests.Gameplay;
 using osuTK.Input;
@@ -145,6 +146,26 @@ namespace osu.Game.Tests.Visual.Gameplay
             AddAssert("key counters still hidden", () => !keyCounterFlow.IsPresent);
         }
 
+        [Test]
+        public void TestHiddenHUDDoesntBlockComponentUpdates()
+        {
+            int updateCount = 0;
+
+            AddStep("set hud to never show", () => localConfig.SetValue(OsuSetting.HUDVisibilityMode, HUDVisibilityMode.Never));
+
+            createNew();
+
+            AddUntilStep("wait for hud load", () => hudOverlay.IsLoaded);
+            AddUntilStep("wait for components to be hidden", () => hudOverlay.ChildrenOfType<SkinnableTargetContainer>().Single().Alpha == 0);
+
+            AddStep("bind on update", () =>
+            {
+                hudOverlay.ChildrenOfType<BarHitErrorMeter>().First().OnUpdate += _ => updateCount++;
+            });
+
+            AddUntilStep("wait for updates", () => updateCount > 0);
+        }
+
         [Test]
         public void TestHiddenHUDDoesntBlockSkinnableComponentsLoad()
         {
@@ -153,7 +174,7 @@ namespace osu.Game.Tests.Visual.Gameplay
             createNew();
 
             AddUntilStep("wait for hud load", () => hudOverlay.IsLoaded);
-            AddUntilStep("wait for components to be hidden", () => !hudOverlay.ChildrenOfType<SkinnableTargetContainer>().Single().IsPresent);
+            AddUntilStep("wait for components to be hidden", () => hudOverlay.ChildrenOfType<SkinnableTargetContainer>().Single().Alpha == 0);
 
             AddStep("reload components", () => hudOverlay.ChildrenOfType<SkinnableTargetContainer>().Single().Reload());
             AddUntilStep("skinnable components loaded", () => hudOverlay.ChildrenOfType<SkinnableTargetContainer>().Single().ComponentsLoaded);

From aeca138930f7ab95eae73f3fea586c25606d9032 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 14 Jun 2022 18:48:57 +0900
Subject: [PATCH 5405/5547] Fix ctrl-z in editor also seeking to start in
 addition to undo

---
 osu.Game/Screens/Edit/Editor.cs | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/osu.Game/Screens/Edit/Editor.cs b/osu.Game/Screens/Edit/Editor.cs
index 1414644a54..e4a18b8478 100644
--- a/osu.Game/Screens/Edit/Editor.cs
+++ b/osu.Game/Screens/Edit/Editor.cs
@@ -422,6 +422,8 @@ namespace osu.Game.Screens.Edit
 
         protected override bool OnKeyDown(KeyDownEvent e)
         {
+            if (e.ControlPressed || e.AltPressed || e.SuperPressed) return false;
+
             switch (e.Key)
             {
                 case Key.Left:

From c30644328cf1a9e855dde91ba4676d73f384cee4 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 14 Jun 2022 19:21:02 +0900
Subject: [PATCH 5406/5547] Fix timing adjustment repeat buttons firing one
 change per repeat invocation

---
 osu.Game/Screens/Edit/Timing/RepeatingButtonBehaviour.cs | 5 +++++
 osu.Game/Screens/Edit/Timing/TimingAdjustButton.cs       | 9 ++++++++-
 2 files changed, 13 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Edit/Timing/RepeatingButtonBehaviour.cs b/osu.Game/Screens/Edit/Timing/RepeatingButtonBehaviour.cs
index 595305b20f..3b78402f8a 100644
--- a/osu.Game/Screens/Edit/Timing/RepeatingButtonBehaviour.cs
+++ b/osu.Game/Screens/Edit/Timing/RepeatingButtonBehaviour.cs
@@ -23,6 +23,9 @@ namespace osu.Game.Screens.Edit.Timing
 
         private Sample sample;
 
+        public Action RepeatBegan;
+        public Action RepeatEnded;
+
         /// <summary>
         /// An additive modifier for the frequency of the sample played on next actuation.
         /// This can be adjusted during the button's <see cref="Drawable.OnClick"/> event to affect the repeat sample playback of that click.
@@ -44,6 +47,7 @@ namespace osu.Game.Screens.Edit.Timing
 
         protected override bool OnMouseDown(MouseDownEvent e)
         {
+            RepeatBegan?.Invoke();
             beginRepeat();
             return true;
         }
@@ -51,6 +55,7 @@ namespace osu.Game.Screens.Edit.Timing
         protected override void OnMouseUp(MouseUpEvent e)
         {
             adjustDelegate?.Cancel();
+            RepeatEnded?.Invoke();
             base.OnMouseUp(e);
         }
 
diff --git a/osu.Game/Screens/Edit/Timing/TimingAdjustButton.cs b/osu.Game/Screens/Edit/Timing/TimingAdjustButton.cs
index 9540547d89..8aa0a88c3b 100644
--- a/osu.Game/Screens/Edit/Timing/TimingAdjustButton.cs
+++ b/osu.Game/Screens/Edit/Timing/TimingAdjustButton.cs
@@ -44,6 +44,9 @@ namespace osu.Game.Screens.Edit.Timing
         [Resolved]
         private OverlayColourProvider colourProvider { get; set; }
 
+        [Resolved]
+        private EditorBeatmap editorBeatmap { get; set; }
+
         public TimingAdjustButton(double adjustAmount)
         {
             this.adjustAmount = adjustAmount;
@@ -72,7 +75,11 @@ namespace osu.Game.Screens.Edit.Timing
                 }
             });
 
-            AddInternal(repeatBehaviour = new RepeatingButtonBehaviour(this));
+            AddInternal(repeatBehaviour = new RepeatingButtonBehaviour(this)
+            {
+                RepeatBegan = () => editorBeatmap.BeginChange(),
+                RepeatEnded = () => editorBeatmap.EndChange()
+            });
         }
 
         [BackgroundDependencyLoader]

From d73c0ca65949fa2bff7f8fb4602a350ac8048856 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 14 Jun 2022 19:38:51 +0900
Subject: [PATCH 5407/5547] Remove unused methods from `IModelImporter`

All the xmldoc is already present in `RealmArchiveModelImporter` so
nothing is lost here.
---
 osu.Game/Database/IModelImporter.cs | 43 +++++++----------------------
 1 file changed, 10 insertions(+), 33 deletions(-)

diff --git a/osu.Game/Database/IModelImporter.cs b/osu.Game/Database/IModelImporter.cs
index 90df13477e..b59636e88d 100644
--- a/osu.Game/Database/IModelImporter.cs
+++ b/osu.Game/Database/IModelImporter.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 System.Collections.Generic;
-using System.Threading;
-using System.Threading.Tasks;
-using osu.Game.IO.Archives;
-using osu.Game.Overlays.Notifications;
-
 #nullable enable
 
+using System.Collections.Generic;
+using System.Threading.Tasks;
+using osu.Game.Overlays.Notifications;
+
 namespace osu.Game.Database
 {
     /// <summary>
@@ -18,35 +16,14 @@ namespace osu.Game.Database
     public interface IModelImporter<TModel> : IPostNotifications, IPostImports<TModel>, ICanAcceptFiles
         where TModel : class, IHasGuidPrimaryKey
     {
+        /// <summary>
+        /// Process multiple import tasks, updating a tracking notification with progress.
+        /// </summary>
+        /// <param name="notification">The notification to update.</param>
+        /// <param name="tasks">The import tasks.</param>
+        /// <returns>The imported models.</returns>
         Task<IEnumerable<Live<TModel>>> Import(ProgressNotification notification, params ImportTask[] tasks);
 
-        /// <summary>
-        /// Import one <typeparamref name="TModel"/> from the filesystem and delete the file on success.
-        /// Note that this bypasses the UI flow and should only be used for special cases or testing.
-        /// </summary>
-        /// <param name="task">The <see cref="ImportTask"/> containing data about the <typeparamref name="TModel"/> to import.</param>
-        /// <param name="lowPriority">Whether this is a low priority import.</param>
-        /// <param name="cancellationToken">An optional cancellation token.</param>
-        /// <returns>The imported model, if successful.</returns>
-        Task<Live<TModel>?> Import(ImportTask task, bool lowPriority = false, CancellationToken cancellationToken = default);
-
-        /// <summary>
-        /// Silently import an item from an <see cref="ArchiveReader"/>.
-        /// </summary>
-        /// <param name="archive">The archive to be imported.</param>
-        /// <param name="lowPriority">Whether this is a low priority import.</param>
-        /// <param name="cancellationToken">An optional cancellation token.</param>
-        Task<Live<TModel>?> Import(ArchiveReader archive, bool lowPriority = false, CancellationToken cancellationToken = default);
-
-        /// <summary>
-        /// Silently import an item from a <typeparamref name="TModel"/>.
-        /// </summary>
-        /// <param name="item">The model to be imported.</param>
-        /// <param name="archive">An optional archive to use for model population.</param>
-        /// <param name="lowPriority">Whether this is a low priority import.</param>
-        /// <param name="cancellationToken">An optional cancellation token.</param>
-        Live<TModel>? Import(TModel item, ArchiveReader? archive = null, bool lowPriority = false, CancellationToken cancellationToken = default);
-
         /// <summary>
         /// A user displayable name for the model type associated with this manager.
         /// </summary>

From ca0765a9326100a25994df7acee884a913e60170 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 14 Jun 2022 19:46:59 +0900
Subject: [PATCH 5408/5547] Tidy up various delegation implementations

---
 osu.Game/Scoring/ScoreManager.cs   | 50 +++--------------
 osu.Game/Skinning/SkinManager.cs   | 88 ++++++++----------------------
 osu.Game/Stores/BeatmapImporter.cs |  3 -
 3 files changed, 32 insertions(+), 109 deletions(-)

diff --git a/osu.Game/Scoring/ScoreManager.cs b/osu.Game/Scoring/ScoreManager.cs
index fbec6ea1fb..e086135296 100644
--- a/osu.Game/Scoring/ScoreManager.cs
+++ b/osu.Game/Scoring/ScoreManager.cs
@@ -266,57 +266,23 @@ namespace osu.Game.Scoring
             });
         }
 
-        public void Delete(List<ScoreInfo> items, bool silent = false)
-        {
-            scoreModelManager.Delete(items, silent);
-        }
+        public void Delete(List<ScoreInfo> items, bool silent = false) => scoreModelManager.Delete(items, silent);
 
-        public void Undelete(List<ScoreInfo> items, bool silent = false)
-        {
-            scoreModelManager.Undelete(items, silent);
-        }
+        public void Undelete(List<ScoreInfo> items, bool silent = false) => scoreModelManager.Undelete(items, silent);
 
-        public void Undelete(ScoreInfo item)
-        {
-            scoreModelManager.Undelete(item);
-        }
+        public void Undelete(ScoreInfo item) => scoreModelManager.Undelete(item);
 
-        public Task Import(params string[] paths)
-        {
-            return scoreModelManager.Import(paths);
-        }
+        public Task Import(params string[] paths) => scoreModelManager.Import(paths);
 
-        public Task Import(params ImportTask[] tasks)
-        {
-            return scoreModelManager.Import(tasks);
-        }
+        public Task Import(params ImportTask[] tasks) => scoreModelManager.Import(tasks);
 
         public IEnumerable<string> HandledExtensions => scoreModelManager.HandledExtensions;
 
-        public Task<IEnumerable<Live<ScoreInfo>>> Import(ProgressNotification notification, params ImportTask[] tasks)
-        {
-            return scoreModelManager.Import(notification, tasks);
-        }
+        public Task<IEnumerable<Live<ScoreInfo>>> Import(ProgressNotification notification, params ImportTask[] tasks) => scoreModelManager.Import(notification, tasks);
 
-        public Task<Live<ScoreInfo>> Import(ImportTask task, bool lowPriority = false, CancellationToken cancellationToken = default)
-        {
-            return scoreModelManager.Import(task, lowPriority, cancellationToken);
-        }
+        public Live<ScoreInfo> Import(ScoreInfo item, ArchiveReader archive = null, bool lowPriority = false, CancellationToken cancellationToken = default) => scoreModelManager.Import(item, archive, lowPriority, cancellationToken);
 
-        public Task<Live<ScoreInfo>> Import(ArchiveReader archive, bool lowPriority = false, CancellationToken cancellationToken = default)
-        {
-            return scoreModelManager.Import(archive, lowPriority, cancellationToken);
-        }
-
-        public Live<ScoreInfo> Import(ScoreInfo item, ArchiveReader archive = null, bool lowPriority = false, CancellationToken cancellationToken = default)
-        {
-            return scoreModelManager.Import(item, archive, lowPriority, cancellationToken);
-        }
-
-        public bool IsAvailableLocally(ScoreInfo model)
-        {
-            return scoreModelManager.IsAvailableLocally(model);
-        }
+        public bool IsAvailableLocally(ScoreInfo model) => scoreModelManager.IsAvailableLocally(model);
 
         #endregion
 
diff --git a/osu.Game/Skinning/SkinManager.cs b/osu.Game/Skinning/SkinManager.cs
index 5e1902f520..e04bdce5fd 100644
--- a/osu.Game/Skinning/SkinManager.cs
+++ b/osu.Game/Skinning/SkinManager.cs
@@ -268,37 +268,21 @@ namespace osu.Game.Skinning
             set => skinModelManager.PostImport = value;
         }
 
-        public Task Import(params string[] paths)
-        {
-            return skinModelManager.Import(paths);
-        }
+        public Task Import(params string[] paths) => skinModelManager.Import(paths);
 
-        public Task Import(params ImportTask[] tasks)
-        {
-            return skinModelManager.Import(tasks);
-        }
+        public Task Import(params ImportTask[] tasks) => skinModelManager.Import(tasks);
 
         public IEnumerable<string> HandledExtensions => skinModelManager.HandledExtensions;
 
-        public Task<IEnumerable<Live<SkinInfo>>> Import(ProgressNotification notification, params ImportTask[] tasks)
-        {
-            return skinModelManager.Import(notification, tasks);
-        }
+        public Task<IEnumerable<Live<SkinInfo>>> Import(ProgressNotification notification, params ImportTask[] tasks) => skinModelManager.Import(notification, tasks);
 
-        public Task<Live<SkinInfo>> Import(ImportTask task, bool lowPriority = false, CancellationToken cancellationToken = default)
-        {
-            return skinModelManager.Import(task, lowPriority, cancellationToken);
-        }
+        public Task<Live<SkinInfo>> Import(ImportTask task, bool lowPriority = false, CancellationToken cancellationToken = default) => skinModelManager.Import(task, lowPriority, cancellationToken);
 
-        public Task<Live<SkinInfo>> Import(ArchiveReader archive, bool lowPriority = false, CancellationToken cancellationToken = default)
-        {
-            return skinModelManager.Import(archive, lowPriority, cancellationToken);
-        }
+        public Task<Live<SkinInfo>> Import(ArchiveReader archive, bool lowPriority = false, CancellationToken cancellationToken = default) =>
+            skinModelManager.Import(archive, lowPriority, cancellationToken);
 
-        public Live<SkinInfo> Import(SkinInfo item, ArchiveReader archive = null, bool lowPriority = false, CancellationToken cancellationToken = default)
-        {
-            return skinModelManager.Import(item, archive, lowPriority, cancellationToken);
-        }
+        public Live<SkinInfo> Import(SkinInfo item, ArchiveReader archive = null, bool lowPriority = false, CancellationToken cancellationToken = default) =>
+            skinModelManager.Import(item, archive, lowPriority, cancellationToken);
 
         #endregion
 
@@ -323,46 +307,22 @@ namespace osu.Game.Skinning
             });
         }
 
+        public bool Delete(SkinInfo item) => skinModelManager.Delete(item);
+
+        public void Delete(List<SkinInfo> items, bool silent = false) => skinModelManager.Delete(items, silent);
+
+        public void Undelete(List<SkinInfo> items, bool silent = false) => skinModelManager.Undelete(items, silent);
+
+        public void Undelete(SkinInfo item) => skinModelManager.Undelete(item);
+
+        public bool IsAvailableLocally(SkinInfo model) => skinModelManager.IsAvailableLocally(model);
+
+        public void ReplaceFile(SkinInfo model, RealmNamedFileUsage file, Stream contents) => skinModelManager.ReplaceFile(model, file, contents);
+
+        public void DeleteFile(SkinInfo model, RealmNamedFileUsage file) => skinModelManager.DeleteFile(model, file);
+
+        public void AddFile(SkinInfo model, Stream contents, string filename) => skinModelManager.AddFile(model, contents, filename);
+
         #endregion
-
-        public bool Delete(SkinInfo item)
-        {
-            return skinModelManager.Delete(item);
-        }
-
-        public void Delete(List<SkinInfo> items, bool silent = false)
-        {
-            skinModelManager.Delete(items, silent);
-        }
-
-        public void Undelete(List<SkinInfo> items, bool silent = false)
-        {
-            skinModelManager.Undelete(items, silent);
-        }
-
-        public void Undelete(SkinInfo item)
-        {
-            skinModelManager.Undelete(item);
-        }
-
-        public bool IsAvailableLocally(SkinInfo model)
-        {
-            return skinModelManager.IsAvailableLocally(model);
-        }
-
-        public void ReplaceFile(SkinInfo model, RealmNamedFileUsage file, Stream contents)
-        {
-            skinModelManager.ReplaceFile(model, file, contents);
-        }
-
-        public void DeleteFile(SkinInfo model, RealmNamedFileUsage file)
-        {
-            skinModelManager.DeleteFile(model, file);
-        }
-
-        public void AddFile(SkinInfo model, Stream contents, string filename)
-        {
-            skinModelManager.AddFile(model, contents, filename);
-        }
     }
 }
diff --git a/osu.Game/Stores/BeatmapImporter.cs b/osu.Game/Stores/BeatmapImporter.cs
index f04a0210ef..3d89dfeca9 100644
--- a/osu.Game/Stores/BeatmapImporter.cs
+++ b/osu.Game/Stores/BeatmapImporter.cs
@@ -39,9 +39,6 @@ namespace osu.Game.Stores
 
         protected override string[] HashableFileTypes => new[] { ".osu" };
 
-        // protected override bool CheckLocalAvailability(RealmBeatmapSet model, System.Linq.IQueryable<RealmBeatmapSet> items)
-        //     => base.CheckLocalAvailability(model, items) || (model.OnlineID > -1));
-
         private readonly BeatmapOnlineLookupQueue? onlineLookupQueue;
 
         protected BeatmapImporter(RealmAccess realm, Storage storage, BeatmapOnlineLookupQueue? onlineLookupQueue = null)

From 9f599a5ab4b32cace5f90cc9eb158a4da90c759f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 14 Jun 2022 19:52:30 +0900
Subject: [PATCH 5409/5547] Remove unused `lowPriority` flag from one `Import`
 method

---
 .../Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs  | 4 ++--
 osu.Game/Beatmaps/BeatmapManager.cs                          | 2 +-
 osu.Game/Scoring/ScoreManager.cs                             | 2 +-
 osu.Game/Skinning/SkinManager.cs                             | 2 +-
 osu.Game/Stores/RealmArchiveModelImporter.cs                 | 5 ++---
 5 files changed, 7 insertions(+), 8 deletions(-)

diff --git a/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs b/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
index db988a544d..278acce3e5 100644
--- a/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
+++ b/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
@@ -225,10 +225,10 @@ namespace osu.Game.Tests.Online
                     this.testBeatmapManager = testBeatmapManager;
                 }
 
-                public override Live<BeatmapSetInfo> Import(BeatmapSetInfo item, ArchiveReader archive = null, bool lowPriority = false, CancellationToken cancellationToken = default)
+                public override Live<BeatmapSetInfo> Import(BeatmapSetInfo item, ArchiveReader archive = null, CancellationToken cancellationToken = default)
                 {
                     testBeatmapManager.AllowImport.Task.WaitSafely();
-                    return (testBeatmapManager.CurrentImport = base.Import(item, archive, lowPriority, cancellationToken));
+                    return (testBeatmapManager.CurrentImport = base.Import(item, archive, cancellationToken));
                 }
             }
         }
diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index dba457c81c..1a536a22b1 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -374,7 +374,7 @@ namespace osu.Game.Beatmaps
 
         public Live<BeatmapSetInfo>? Import(BeatmapSetInfo item, ArchiveReader? archive = null, bool lowPriority = false, CancellationToken cancellationToken = default)
         {
-            return beatmapModelManager.Import(item, archive, lowPriority, cancellationToken);
+            return beatmapModelManager.Import(item, archive, cancellationToken);
         }
 
         public IEnumerable<string> HandledExtensions => beatmapModelManager.HandledExtensions;
diff --git a/osu.Game/Scoring/ScoreManager.cs b/osu.Game/Scoring/ScoreManager.cs
index e086135296..d42bf1b454 100644
--- a/osu.Game/Scoring/ScoreManager.cs
+++ b/osu.Game/Scoring/ScoreManager.cs
@@ -280,7 +280,7 @@ namespace osu.Game.Scoring
 
         public Task<IEnumerable<Live<ScoreInfo>>> Import(ProgressNotification notification, params ImportTask[] tasks) => scoreModelManager.Import(notification, tasks);
 
-        public Live<ScoreInfo> Import(ScoreInfo item, ArchiveReader archive = null, bool lowPriority = false, CancellationToken cancellationToken = default) => scoreModelManager.Import(item, archive, lowPriority, cancellationToken);
+        public Live<ScoreInfo> Import(ScoreInfo item, ArchiveReader archive = null, bool lowPriority = false, CancellationToken cancellationToken = default) => scoreModelManager.Import(item, archive, cancellationToken);
 
         public bool IsAvailableLocally(ScoreInfo model) => scoreModelManager.IsAvailableLocally(model);
 
diff --git a/osu.Game/Skinning/SkinManager.cs b/osu.Game/Skinning/SkinManager.cs
index e04bdce5fd..7ec922987b 100644
--- a/osu.Game/Skinning/SkinManager.cs
+++ b/osu.Game/Skinning/SkinManager.cs
@@ -282,7 +282,7 @@ namespace osu.Game.Skinning
             skinModelManager.Import(archive, lowPriority, cancellationToken);
 
         public Live<SkinInfo> Import(SkinInfo item, ArchiveReader archive = null, bool lowPriority = false, CancellationToken cancellationToken = default) =>
-            skinModelManager.Import(item, archive, lowPriority, cancellationToken);
+            skinModelManager.Import(item, archive, cancellationToken);
 
         #endregion
 
diff --git a/osu.Game/Stores/RealmArchiveModelImporter.cs b/osu.Game/Stores/RealmArchiveModelImporter.cs
index e7477cfffc..1ff42130b1 100644
--- a/osu.Game/Stores/RealmArchiveModelImporter.cs
+++ b/osu.Game/Stores/RealmArchiveModelImporter.cs
@@ -250,7 +250,7 @@ namespace osu.Game.Stores
                 return null;
             }
 
-            var scheduledImport = Task.Factory.StartNew(() => Import(model, archive, lowPriority, cancellationToken),
+            var scheduledImport = Task.Factory.StartNew(() => Import(model, archive, cancellationToken),
                 cancellationToken,
                 TaskCreationOptions.HideScheduler,
                 lowPriority ? import_scheduler_low_priority : import_scheduler);
@@ -318,9 +318,8 @@ namespace osu.Game.Stores
         /// </summary>
         /// <param name="item">The model to be imported.</param>
         /// <param name="archive">An optional archive to use for model population.</param>
-        /// <param name="lowPriority">Whether this is a low priority import.</param>
         /// <param name="cancellationToken">An optional cancellation token.</param>
-        public virtual Live<TModel>? Import(TModel item, ArchiveReader? archive = null, bool lowPriority = false, CancellationToken cancellationToken = default)
+        public virtual Live<TModel>? Import(TModel item, ArchiveReader? archive = null, CancellationToken cancellationToken = default)
         {
             return Realm.Run(realm =>
             {

From 84e526a2d94d7a20fa53c3a84b0bcdda53a4c70f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 14 Jun 2022 20:00:08 +0900
Subject: [PATCH 5410/5547] Move methods around to make more sense

---
 osu.Game/Stores/RealmArchiveModelImporter.cs | 110 +++++++++----------
 1 file changed, 55 insertions(+), 55 deletions(-)

diff --git a/osu.Game/Stores/RealmArchiveModelImporter.cs b/osu.Game/Stores/RealmArchiveModelImporter.cs
index 1ff42130b1..4ea2a10288 100644
--- a/osu.Game/Stores/RealmArchiveModelImporter.cs
+++ b/osu.Game/Stores/RealmArchiveModelImporter.cs
@@ -258,61 +258,6 @@ namespace osu.Game.Stores
             return await scheduledImport.ConfigureAwait(false);
         }
 
-        /// <summary>
-        /// Any file extensions which should be included in hash creation.
-        /// Generally should include all file types which determine the file's uniqueness.
-        /// Large files should be avoided if possible.
-        /// </summary>
-        /// <remarks>
-        /// This is only used by the default hash implementation. If <see cref="ComputeHash"/> is overridden, it will not be used.
-        /// </remarks>
-        protected abstract string[] HashableFileTypes { get; }
-
-        internal static void LogForModel(TModel? model, string message, Exception? e = null)
-        {
-            string trimmedHash;
-            if (model == null || !model.IsValid || string.IsNullOrEmpty(model.Hash))
-                trimmedHash = "?????";
-            else
-                trimmedHash = model.Hash.Substring(0, 5);
-
-            string prefix = $"[{trimmedHash}]";
-
-            if (e != null)
-                Logger.Error(e, $"{prefix} {message}", LoggingTarget.Database);
-            else
-                Logger.Log($"{prefix} {message}", LoggingTarget.Database);
-        }
-
-        /// <summary>
-        /// Whether the implementation overrides <see cref="ComputeHash"/> with a custom implementation.
-        /// Custom hash implementations must bypass the early exit in the import flow (see <see cref="computeHashFast"/> usage).
-        /// </summary>
-        protected virtual bool HasCustomHashFunction => false;
-
-        /// <summary>
-        /// Create a SHA-2 hash from the provided archive based on file content of all files matching <see cref="HashableFileTypes"/>.
-        /// </summary>
-        /// <remarks>
-        ///  In the case of no matching files, a hash will be generated from the passed archive's <see cref="ArchiveReader.Name"/>.
-        /// </remarks>
-        protected virtual string ComputeHash(TModel item)
-        {
-            // for now, concatenate all hashable files in the set to create a unique hash.
-            MemoryStream hashable = new MemoryStream();
-
-            foreach (RealmNamedFileUsage file in item.Files.Where(f => HashableFileTypes.Any(ext => f.Filename.EndsWith(ext, StringComparison.OrdinalIgnoreCase))).OrderBy(f => f.Filename))
-            {
-                using (Stream s = Files.Store.GetStream(file.File.GetStoragePath()))
-                    s.CopyTo(hashable);
-            }
-
-            if (hashable.Length > 0)
-                return hashable.ComputeSHA2Hash();
-
-            return item.Hash;
-        }
-
         /// <summary>
         /// Silently import an item from a <typeparamref name="TModel"/>.
         /// </summary>
@@ -419,6 +364,61 @@ namespace osu.Game.Stores
             });
         }
 
+        /// <summary>
+        /// Any file extensions which should be included in hash creation.
+        /// Generally should include all file types which determine the file's uniqueness.
+        /// Large files should be avoided if possible.
+        /// </summary>
+        /// <remarks>
+        /// This is only used by the default hash implementation. If <see cref="ComputeHash"/> is overridden, it will not be used.
+        /// </remarks>
+        protected abstract string[] HashableFileTypes { get; }
+
+        internal static void LogForModel(TModel? model, string message, Exception? e = null)
+        {
+            string trimmedHash;
+            if (model == null || !model.IsValid || string.IsNullOrEmpty(model.Hash))
+                trimmedHash = "?????";
+            else
+                trimmedHash = model.Hash.Substring(0, 5);
+
+            string prefix = $"[{trimmedHash}]";
+
+            if (e != null)
+                Logger.Error(e, $"{prefix} {message}", LoggingTarget.Database);
+            else
+                Logger.Log($"{prefix} {message}", LoggingTarget.Database);
+        }
+
+        /// <summary>
+        /// Whether the implementation overrides <see cref="ComputeHash"/> with a custom implementation.
+        /// Custom hash implementations must bypass the early exit in the import flow (see <see cref="computeHashFast"/> usage).
+        /// </summary>
+        protected virtual bool HasCustomHashFunction => false;
+
+        /// <summary>
+        /// Create a SHA-2 hash from the provided archive based on file content of all files matching <see cref="HashableFileTypes"/>.
+        /// </summary>
+        /// <remarks>
+        ///  In the case of no matching files, a hash will be generated from the passed archive's <see cref="ArchiveReader.Name"/>.
+        /// </remarks>
+        protected virtual string ComputeHash(TModel item)
+        {
+            // for now, concatenate all hashable files in the set to create a unique hash.
+            MemoryStream hashable = new MemoryStream();
+
+            foreach (RealmNamedFileUsage file in item.Files.Where(f => HashableFileTypes.Any(ext => f.Filename.EndsWith(ext, StringComparison.OrdinalIgnoreCase))).OrderBy(f => f.Filename))
+            {
+                using (Stream s = Files.Store.GetStream(file.File.GetStoragePath()))
+                    s.CopyTo(hashable);
+            }
+
+            if (hashable.Length > 0)
+                return hashable.ComputeSHA2Hash();
+
+            return item.Hash;
+        }
+
         private string computeHashFast(ArchiveReader reader)
         {
             MemoryStream hashable = new MemoryStream();

From e96c5ce70375a9011da05a4e8bc61a01a7ec16f1 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 14 Jun 2022 20:00:16 +0900
Subject: [PATCH 5411/5547] Move and correct xmldoc to interfaces

---
 osu.Game/Database/ICanAcceptFiles.cs         | 10 +++++++++-
 osu.Game/Stores/RealmArchiveModelImporter.cs |  8 --------
 2 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/osu.Game/Database/ICanAcceptFiles.cs b/osu.Game/Database/ICanAcceptFiles.cs
index 74fd6fcc36..3cec3b8a8e 100644
--- a/osu.Game/Database/ICanAcceptFiles.cs
+++ b/osu.Game/Database/ICanAcceptFiles.cs
@@ -12,14 +12,22 @@ namespace osu.Game.Database
     public interface ICanAcceptFiles
     {
         /// <summary>
-        /// Import the specified paths.
+        /// Import one or more items from filesystem <paramref name="paths"/>.
         /// </summary>
+        /// <remarks>
+        /// This will be treated as a low priority batch import if more than one path is specified.
+        /// This will post notifications tracking progress.
+        /// </remarks>
         /// <param name="paths">The files which should be imported.</param>
         Task Import(params string[] paths);
 
         /// <summary>
         /// Import the specified files from the given import tasks.
         /// </summary>
+        /// <remarks>
+        /// This will be treated as a low priority batch import if more than one path is specified.
+        /// This will post notifications tracking progress.
+        /// </remarks>
         /// <param name="tasks">The import tasks from which the files should be imported.</param>
         Task Import(params ImportTask[] tasks);
 
diff --git a/osu.Game/Stores/RealmArchiveModelImporter.cs b/osu.Game/Stores/RealmArchiveModelImporter.cs
index 4ea2a10288..35ec0c8532 100644
--- a/osu.Game/Stores/RealmArchiveModelImporter.cs
+++ b/osu.Game/Stores/RealmArchiveModelImporter.cs
@@ -78,14 +78,6 @@ namespace osu.Game.Stores
             Files = new RealmFileStore(realm, storage);
         }
 
-        /// <summary>
-        /// Import one or more <typeparamref name="TModel"/> items from filesystem <paramref name="paths"/>.
-        /// </summary>
-        /// <remarks>
-        /// This will be treated as a low priority import if more than one path is specified; use <see cref="Import(ImportTask[])"/> to always import at standard priority.
-        /// This will post notifications tracking progress.
-        /// </remarks>
-        /// <param name="paths">One or more archive locations on disk.</param>
         public Task Import(params string[] paths)
         {
             var notification = new ProgressNotification { State = ProgressNotificationState.Active };

From 6250caca29a086a4d8861c5b8c1a13e2510af1dd Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 14 Jun 2022 20:01:11 +0900
Subject: [PATCH 5412/5547] Remove duplicate implementation of same thing

---
 osu.Game/Stores/RealmArchiveModelImporter.cs | 9 +--------
 1 file changed, 1 insertion(+), 8 deletions(-)

diff --git a/osu.Game/Stores/RealmArchiveModelImporter.cs b/osu.Game/Stores/RealmArchiveModelImporter.cs
index 35ec0c8532..82b77bfb05 100644
--- a/osu.Game/Stores/RealmArchiveModelImporter.cs
+++ b/osu.Game/Stores/RealmArchiveModelImporter.cs
@@ -78,14 +78,7 @@ namespace osu.Game.Stores
             Files = new RealmFileStore(realm, storage);
         }
 
-        public Task Import(params string[] paths)
-        {
-            var notification = new ProgressNotification { State = ProgressNotificationState.Active };
-
-            PostNotification?.Invoke(notification);
-
-            return Import(notification, paths.Select(p => new ImportTask(p)).ToArray());
-        }
+        public Task Import(params string[] paths) => Import(paths.Select(p => new ImportTask(p)).ToArray());
 
         public Task Import(params ImportTask[] tasks)
         {

From 94ba71aa1323d27ccf97949b914ca15e9b61fd85 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 14 Jun 2022 20:21:28 +0900
Subject: [PATCH 5413/5547] Remove one more usage of `lowPriority`

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

diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index 1a536a22b1..51f4d23bb4 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -347,35 +347,17 @@ namespace osu.Game.Beatmaps
 
         #region Implementation of ICanAcceptFiles
 
-        public Task Import(params string[] paths)
-        {
-            return beatmapModelManager.Import(paths);
-        }
+        public Task Import(params string[] paths) => beatmapModelManager.Import(paths);
 
-        public Task Import(params ImportTask[] tasks)
-        {
-            return beatmapModelManager.Import(tasks);
-        }
+        public Task Import(params ImportTask[] tasks) => beatmapModelManager.Import(tasks);
 
-        public Task<IEnumerable<Live<BeatmapSetInfo>>> Import(ProgressNotification notification, params ImportTask[] tasks)
-        {
-            return beatmapModelManager.Import(notification, tasks);
-        }
+        public Task<IEnumerable<Live<BeatmapSetInfo>>> Import(ProgressNotification notification, params ImportTask[] tasks) => beatmapModelManager.Import(notification, tasks);
 
-        public Task<Live<BeatmapSetInfo>?> Import(ImportTask task, bool lowPriority = false, CancellationToken cancellationToken = default)
-        {
-            return beatmapModelManager.Import(task, lowPriority, cancellationToken);
-        }
+        public Task<Live<BeatmapSetInfo>?> Import(ImportTask task, bool lowPriority = false, CancellationToken cancellationToken = default) => beatmapModelManager.Import(task, lowPriority, cancellationToken);
 
-        public Task<Live<BeatmapSetInfo>?> Import(ArchiveReader archive, bool lowPriority = false, CancellationToken cancellationToken = default)
-        {
-            return beatmapModelManager.Import(archive, lowPriority, cancellationToken);
-        }
+        public Task<Live<BeatmapSetInfo>?> Import(ArchiveReader archive, bool lowPriority = false, CancellationToken cancellationToken = default) => beatmapModelManager.Import(archive, lowPriority, cancellationToken);
 
-        public Live<BeatmapSetInfo>? Import(BeatmapSetInfo item, ArchiveReader? archive = null, bool lowPriority = false, CancellationToken cancellationToken = default)
-        {
-            return beatmapModelManager.Import(item, archive, cancellationToken);
-        }
+        public Live<BeatmapSetInfo>? Import(BeatmapSetInfo item, ArchiveReader? archive = null, CancellationToken cancellationToken = default) => beatmapModelManager.Import(item, archive, cancellationToken);
 
         public IEnumerable<string> HandledExtensions => beatmapModelManager.HandledExtensions;
 

From 2634e569440d8ada58be6995f07929d5d42a1ae9 Mon Sep 17 00:00:00 2001
From: apollo-dw <83023433+apollo-dw@users.noreply.github.com>
Date: Tue, 14 Jun 2022 16:16:12 +0100
Subject: [PATCH 5414/5547] Further adjustments

---
 .../Difficulty/Evaluators/SpeedEvaluator.cs                  | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Evaluators/SpeedEvaluator.cs b/osu.Game.Rulesets.Osu/Difficulty/Evaluators/SpeedEvaluator.cs
index e68e7a8653..3be4d621eb 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Evaluators/SpeedEvaluator.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Evaluators/SpeedEvaluator.cs
@@ -41,8 +41,9 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Evaluators
             {
                 double currDeltaTime = Math.Max(1, osuCurrObj.DeltaTime);
                 double nextDeltaTime = Math.Max(1, osuNextObj.DeltaTime);
-                double speedRatio = Math.Min(1, currDeltaTime / nextDeltaTime);
-                double windowRatio = Math.Min(1, currDeltaTime / greatWindowFull);
+                double deltaDifference = Math.Abs(nextDeltaTime - currDeltaTime);
+                double speedRatio = Math.Min(1, currDeltaTime / deltaDifference);
+                double windowRatio = Math.Pow(Math.Min(1, currDeltaTime / greatWindowFull), 2);
                 doubletapness = Math.Pow(speedRatio, 1 - windowRatio);
             }
 

From 7affef75b05ac886b74f7d5580ba8d2ab4714faa Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 14 Jun 2022 20:25:38 +0900
Subject: [PATCH 5415/5547] Remove unused `Import` method in `SkinManager`

---
 osu.Game/Skinning/SkinManager.cs | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/osu.Game/Skinning/SkinManager.cs b/osu.Game/Skinning/SkinManager.cs
index 7ec922987b..6002bafa8d 100644
--- a/osu.Game/Skinning/SkinManager.cs
+++ b/osu.Game/Skinning/SkinManager.cs
@@ -281,9 +281,6 @@ namespace osu.Game.Skinning
         public Task<Live<SkinInfo>> Import(ArchiveReader archive, bool lowPriority = false, CancellationToken cancellationToken = default) =>
             skinModelManager.Import(archive, lowPriority, cancellationToken);
 
-        public Live<SkinInfo> Import(SkinInfo item, ArchiveReader archive = null, bool lowPriority = false, CancellationToken cancellationToken = default) =>
-            skinModelManager.Import(item, archive, cancellationToken);
-
         #endregion
 
         #region Implementation of IModelManager<SkinInfo>

From 2f8290831a3a370ae2d677b4227a60e9e5589f1c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 14 Jun 2022 20:34:23 +0900
Subject: [PATCH 5416/5547] Skip quick import clause when importing a single
 item

Closes https://github.com/ppy/osu/issues/18600.
---
 ...eneOnlinePlayBeatmapAvailabilityTracker.cs |   4 +-
 osu.Game/Beatmaps/BeatmapManager.cs           |   2 +-
 osu.Game/Scoring/ScoreManager.cs              |   2 +-
 osu.Game/Stores/RealmArchiveModelImporter.cs  | 156 +++++++++---------
 4 files changed, 81 insertions(+), 83 deletions(-)

diff --git a/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs b/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
index 278acce3e5..5cae576db1 100644
--- a/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
+++ b/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
@@ -225,10 +225,10 @@ namespace osu.Game.Tests.Online
                     this.testBeatmapManager = testBeatmapManager;
                 }
 
-                public override Live<BeatmapSetInfo> Import(BeatmapSetInfo item, ArchiveReader archive = null, CancellationToken cancellationToken = default)
+                public override Live<BeatmapSetInfo> Import(BeatmapSetInfo item, ArchiveReader archive = null, bool quickSkipIfExisting = false, CancellationToken cancellationToken = default)
                 {
                     testBeatmapManager.AllowImport.Task.WaitSafely();
-                    return (testBeatmapManager.CurrentImport = base.Import(item, archive, cancellationToken));
+                    return (testBeatmapManager.CurrentImport = base.Import(item, archive, quickSkipIfExisting, cancellationToken));
                 }
             }
         }
diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index 51f4d23bb4..ab614106cc 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -357,7 +357,7 @@ namespace osu.Game.Beatmaps
 
         public Task<Live<BeatmapSetInfo>?> Import(ArchiveReader archive, bool lowPriority = false, CancellationToken cancellationToken = default) => beatmapModelManager.Import(archive, lowPriority, cancellationToken);
 
-        public Live<BeatmapSetInfo>? Import(BeatmapSetInfo item, ArchiveReader? archive = null, CancellationToken cancellationToken = default) => beatmapModelManager.Import(item, archive, cancellationToken);
+        public Live<BeatmapSetInfo>? Import(BeatmapSetInfo item, ArchiveReader? archive = null, CancellationToken cancellationToken = default) => beatmapModelManager.Import(item, archive, false, cancellationToken);
 
         public IEnumerable<string> HandledExtensions => beatmapModelManager.HandledExtensions;
 
diff --git a/osu.Game/Scoring/ScoreManager.cs b/osu.Game/Scoring/ScoreManager.cs
index d42bf1b454..e086135296 100644
--- a/osu.Game/Scoring/ScoreManager.cs
+++ b/osu.Game/Scoring/ScoreManager.cs
@@ -280,7 +280,7 @@ namespace osu.Game.Scoring
 
         public Task<IEnumerable<Live<ScoreInfo>>> Import(ProgressNotification notification, params ImportTask[] tasks) => scoreModelManager.Import(notification, tasks);
 
-        public Live<ScoreInfo> Import(ScoreInfo item, ArchiveReader archive = null, bool lowPriority = false, CancellationToken cancellationToken = default) => scoreModelManager.Import(item, archive, cancellationToken);
+        public Live<ScoreInfo> Import(ScoreInfo item, ArchiveReader archive = null, bool lowPriority = false, CancellationToken cancellationToken = default) => scoreModelManager.Import(item, archive, lowPriority, cancellationToken);
 
         public bool IsAvailableLocally(ScoreInfo model) => scoreModelManager.IsAvailableLocally(model);
 
diff --git a/osu.Game/Stores/RealmArchiveModelImporter.cs b/osu.Game/Stores/RealmArchiveModelImporter.cs
index 82b77bfb05..ac8a38fe37 100644
--- a/osu.Game/Stores/RealmArchiveModelImporter.cs
+++ b/osu.Game/Stores/RealmArchiveModelImporter.cs
@@ -235,7 +235,7 @@ namespace osu.Game.Stores
                 return null;
             }
 
-            var scheduledImport = Task.Factory.StartNew(() => Import(model, archive, cancellationToken),
+            var scheduledImport = Task.Factory.StartNew(() => Import(model, archive, lowPriority, cancellationToken),
                 cancellationToken,
                 TaskCreationOptions.HideScheduler,
                 lowPriority ? import_scheduler_low_priority : import_scheduler);
@@ -248,106 +248,104 @@ namespace osu.Game.Stores
         /// </summary>
         /// <param name="item">The model to be imported.</param>
         /// <param name="archive">An optional archive to use for model population.</param>
+        /// <param name="quickSkipIfExisting">If <c>true</c>, imports will be skipped before they begin, given an existing model matches on hash and filenames. Should generally only be used for large batch imports, as it may defy user expectations when updating an existing model.</param>
         /// <param name="cancellationToken">An optional cancellation token.</param>
-        public virtual Live<TModel>? Import(TModel item, ArchiveReader? archive = null, CancellationToken cancellationToken = default)
+        public virtual Live<TModel>? Import(TModel item, ArchiveReader? archive = null, bool quickSkipIfExisting = false, CancellationToken cancellationToken = default) => Realm.Run(realm =>
         {
-            return Realm.Run(realm =>
+            cancellationToken.ThrowIfCancellationRequested();
+
+            bool checkedExisting = false;
+            TModel? existing = null;
+
+            if (quickSkipIfExisting && archive != null && !HasCustomHashFunction)
             {
-                cancellationToken.ThrowIfCancellationRequested();
+                // this is a fast bail condition to improve large import performance.
+                item.Hash = computeHashFast(archive);
 
-                bool checkedExisting = false;
-                TModel? existing = null;
+                checkedExisting = true;
+                existing = CheckForExisting(item, realm);
 
-                if (archive != null && !HasCustomHashFunction)
+                if (existing != null)
                 {
-                    // this is a fast bail condition to improve large import performance.
-                    item.Hash = computeHashFast(archive);
+                    // bare minimum comparisons
+                    //
+                    // note that this should really be checking filesizes on disk (of existing files) for some degree of sanity.
+                    // or alternatively doing a faster hash check. either of these require database changes and reprocessing of existing files.
+                    if (CanSkipImport(existing, item) &&
+                        getFilenames(existing.Files).SequenceEqual(getShortenedFilenames(archive).Select(p => p.shortened).OrderBy(f => f)) &&
+                        checkAllFilesExist(existing))
+                    {
+                        LogForModel(item, @$"Found existing (optimised) {HumanisedModelName} for {item} (ID {existing.ID}) – skipping import.");
 
-                    checkedExisting = true;
-                    existing = CheckForExisting(item, realm);
+                        using (var transaction = realm.BeginWrite())
+                        {
+                            UndeleteForReuse(existing);
+                            transaction.Commit();
+                        }
+
+                        return existing.ToLive(Realm);
+                    }
+
+                    LogForModel(item, @"Found existing (optimised) but failed pre-check.");
+                }
+            }
+
+            try
+            {
+                LogForModel(item, @"Beginning import...");
+
+                // TODO: do we want to make the transaction this local? not 100% sure, will need further investigation.
+                using (var transaction = realm.BeginWrite())
+                {
+                    if (archive != null)
+                        // TODO: look into rollback of file additions (or delayed commit).
+                        item.Files.AddRange(createFileInfos(archive, Files, realm));
+
+                    item.Hash = ComputeHash(item);
+
+                    // TODO: we may want to run this outside of the transaction.
+                    Populate(item, archive, realm, cancellationToken);
+
+                    if (!checkedExisting)
+                        existing = CheckForExisting(item, realm);
 
                     if (existing != null)
                     {
-                        // bare minimum comparisons
-                        //
-                        // note that this should really be checking filesizes on disk (of existing files) for some degree of sanity.
-                        // or alternatively doing a faster hash check. either of these require database changes and reprocessing of existing files.
-                        if (CanSkipImport(existing, item) &&
-                            getFilenames(existing.Files).SequenceEqual(getShortenedFilenames(archive).Select(p => p.shortened).OrderBy(f => f)) &&
-                            checkAllFilesExist(existing))
+                        if (CanReuseExisting(existing, item))
                         {
-                            LogForModel(item, @$"Found existing (optimised) {HumanisedModelName} for {item} (ID {existing.ID}) – skipping import.");
+                            LogForModel(item, @$"Found existing {HumanisedModelName} for {item} (ID {existing.ID}) – skipping import.");
 
-                            using (var transaction = realm.BeginWrite())
-                            {
-                                UndeleteForReuse(existing);
-                                transaction.Commit();
-                            }
+                            UndeleteForReuse(existing);
+                            transaction.Commit();
 
                             return existing.ToLive(Realm);
                         }
 
-                        LogForModel(item, @"Found existing (optimised) but failed pre-check.");
-                    }
-                }
+                        LogForModel(item, @"Found existing but failed re-use check.");
 
-                try
-                {
-                    LogForModel(item, @"Beginning import...");
-
-                    // TODO: do we want to make the transaction this local? not 100% sure, will need further investigation.
-                    using (var transaction = realm.BeginWrite())
-                    {
-                        if (archive != null)
-                            // TODO: look into rollback of file additions (or delayed commit).
-                            item.Files.AddRange(createFileInfos(archive, Files, realm));
-
-                        item.Hash = ComputeHash(item);
-
-                        // TODO: we may want to run this outside of the transaction.
-                        Populate(item, archive, realm, cancellationToken);
-
-                        if (!checkedExisting)
-                            existing = CheckForExisting(item, realm);
-
-                        if (existing != null)
-                        {
-                            if (CanReuseExisting(existing, item))
-                            {
-                                LogForModel(item, @$"Found existing {HumanisedModelName} for {item} (ID {existing.ID}) – skipping import.");
-
-                                UndeleteForReuse(existing);
-                                transaction.Commit();
-
-                                return existing.ToLive(Realm);
-                            }
-
-                            LogForModel(item, @"Found existing but failed re-use check.");
-
-                            existing.DeletePending = true;
-                        }
-
-                        PreImport(item, realm);
-
-                        // import to store
-                        realm.Add(item);
-
-                        transaction.Commit();
+                        existing.DeletePending = true;
                     }
 
-                    LogForModel(item, @"Import successfully completed!");
-                }
-                catch (Exception e)
-                {
-                    if (!(e is TaskCanceledException))
-                        LogForModel(item, @"Database import or population failed and has been rolled back.", e);
+                    PreImport(item, realm);
 
-                    throw;
+                    // import to store
+                    realm.Add(item);
+
+                    transaction.Commit();
                 }
 
-                return (Live<TModel>?)item.ToLive(Realm);
-            });
-        }
+                LogForModel(item, @"Import successfully completed!");
+            }
+            catch (Exception e)
+            {
+                if (!(e is TaskCanceledException))
+                    LogForModel(item, @"Database import or population failed and has been rolled back.", e);
+
+                throw;
+            }
+
+            return (Live<TModel>?)item.ToLive(Realm);
+        });
 
         /// <summary>
         /// Any file extensions which should be included in hash creation.

From f11fe543859fcefed2a94145e47d399c5d5b14f9 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 15 Jun 2022 00:27:09 +0900
Subject: [PATCH 5417/5547] Remove custom hash function flow

---
 .../Database/BeatmapImporterTests.cs          | 23 +++++--------------
 osu.Game/Skinning/SkinModelManager.cs         |  2 --
 osu.Game/Stores/RealmArchiveModelImporter.cs  | 10 ++------
 osu.Game/Tests/Visual/EditorTestScene.cs      | 13 +----------
 4 files changed, 9 insertions(+), 39 deletions(-)

diff --git a/osu.Game.Tests/Database/BeatmapImporterTests.cs b/osu.Game.Tests/Database/BeatmapImporterTests.cs
index d4956e97e0..ab40ed2453 100644
--- a/osu.Game.Tests/Database/BeatmapImporterTests.cs
+++ b/osu.Game.Tests/Database/BeatmapImporterTests.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.
 
+#nullable enable
+
 using System;
 using System.Collections.Generic;
 using System.Diagnostics;
@@ -12,7 +14,6 @@ using NUnit.Framework;
 using osu.Framework.Extensions;
 using osu.Framework.Extensions.ObjectExtensions;
 using osu.Framework.Logging;
-using osu.Framework.Platform;
 using osu.Game.Beatmaps;
 using osu.Game.Database;
 using osu.Game.Extensions;
@@ -28,8 +29,6 @@ using SharpCompress.Archives.Zip;
 using SharpCompress.Common;
 using SharpCompress.Writers.Zip;
 
-#nullable enable
-
 namespace osu.Game.Tests.Database
 {
     [TestFixture]
@@ -622,7 +621,7 @@ namespace osu.Game.Tests.Database
                 using var importer = new BeatmapModelManager(realm, storage);
                 using var store = new RealmRulesetStore(realm, storage);
 
-                var imported = await LoadOszIntoStore(importer, realm.Realm);
+                var imported = await LoadOszIntoStore(importer, realm.Realm, batchImport: true);
 
                 deleteBeatmapSet(imported, realm.Realm);
 
@@ -678,7 +677,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealmAsync(async (realm, storage) =>
             {
-                using var importer = new NonOptimisedBeatmapImporter(realm, storage);
+                using var importer = new BeatmapModelManager(realm, storage);
                 using var store = new RealmRulesetStore(realm, storage);
 
                 var imported = await LoadOszIntoStore(importer, realm.Realm);
@@ -960,11 +959,11 @@ namespace osu.Game.Tests.Database
             return realm.All<BeatmapSetInfo>().FirstOrDefault(beatmapSet => beatmapSet.ID == importedSet!.ID);
         }
 
-        public static async Task<BeatmapSetInfo> LoadOszIntoStore(BeatmapImporter importer, Realm realm, string? path = null, bool virtualTrack = false)
+        public static async Task<BeatmapSetInfo> LoadOszIntoStore(BeatmapImporter importer, Realm realm, string? path = null, bool virtualTrack = false, bool batchImport = false)
         {
             string? temp = path ?? TestResources.GetTestBeatmapForImport(virtualTrack);
 
-            var importedSet = await importer.Import(new ImportTask(temp));
+            var importedSet = await importer.Import(new ImportTask(temp), batchImport);
 
             Assert.NotNull(importedSet);
             Debug.Assert(importedSet != null);
@@ -1081,15 +1080,5 @@ namespace osu.Game.Tests.Database
 
             Assert.Fail(failureMessage);
         }
-
-        public class NonOptimisedBeatmapImporter : BeatmapImporter
-        {
-            public NonOptimisedBeatmapImporter(RealmAccess realm, Storage storage)
-                : base(realm, storage)
-            {
-            }
-
-            protected override bool HasCustomHashFunction => true;
-        }
     }
 }
diff --git a/osu.Game/Skinning/SkinModelManager.cs b/osu.Game/Skinning/SkinModelManager.cs
index 23813e8eb2..0a18449800 100644
--- a/osu.Game/Skinning/SkinModelManager.cs
+++ b/osu.Game/Skinning/SkinModelManager.cs
@@ -46,8 +46,6 @@ namespace osu.Game.Skinning
 
         private const string unknown_creator_string = @"Unknown";
 
-        protected override bool HasCustomHashFunction => true;
-
         protected override void Populate(SkinInfo model, ArchiveReader? archive, Realm realm, CancellationToken cancellationToken = default)
         {
             var skinInfoFile = model.Files.SingleOrDefault(f => f.Filename == skin_info_file);
diff --git a/osu.Game/Stores/RealmArchiveModelImporter.cs b/osu.Game/Stores/RealmArchiveModelImporter.cs
index ac8a38fe37..976b26aac2 100644
--- a/osu.Game/Stores/RealmArchiveModelImporter.cs
+++ b/osu.Game/Stores/RealmArchiveModelImporter.cs
@@ -257,7 +257,7 @@ namespace osu.Game.Stores
             bool checkedExisting = false;
             TModel? existing = null;
 
-            if (quickSkipIfExisting && archive != null && !HasCustomHashFunction)
+            if (quickSkipIfExisting && archive != null)
             {
                 // this is a fast bail condition to improve large import performance.
                 item.Hash = computeHashFast(archive);
@@ -373,19 +373,13 @@ namespace osu.Game.Stores
                 Logger.Log($"{prefix} {message}", LoggingTarget.Database);
         }
 
-        /// <summary>
-        /// Whether the implementation overrides <see cref="ComputeHash"/> with a custom implementation.
-        /// Custom hash implementations must bypass the early exit in the import flow (see <see cref="computeHashFast"/> usage).
-        /// </summary>
-        protected virtual bool HasCustomHashFunction => false;
-
         /// <summary>
         /// Create a SHA-2 hash from the provided archive based on file content of all files matching <see cref="HashableFileTypes"/>.
         /// </summary>
         /// <remarks>
         ///  In the case of no matching files, a hash will be generated from the passed archive's <see cref="ArchiveReader.Name"/>.
         /// </remarks>
-        protected virtual string ComputeHash(TModel item)
+        protected string ComputeHash(TModel item)
         {
             // for now, concatenate all hashable files in the set to create a unique hash.
             MemoryStream hashable = new MemoryStream();
diff --git a/osu.Game/Tests/Visual/EditorTestScene.cs b/osu.Game/Tests/Visual/EditorTestScene.cs
index 46f31ae53b..8e9bb6ff78 100644
--- a/osu.Game/Tests/Visual/EditorTestScene.cs
+++ b/osu.Game/Tests/Visual/EditorTestScene.cs
@@ -147,7 +147,7 @@ namespace osu.Game.Tests.Visual
 
             protected override BeatmapModelManager CreateBeatmapModelManager(Storage storage, RealmAccess realm, RulesetStore rulesets, BeatmapOnlineLookupQueue onlineLookupQueue)
             {
-                return new TestBeatmapModelManager(storage, realm, onlineLookupQueue);
+                return new BeatmapModelManager(realm, storage, onlineLookupQueue);
             }
 
             protected override WorkingBeatmapCache CreateWorkingBeatmapCache(AudioManager audioManager, IResourceStore<byte[]> resources, IResourceStore<byte[]> storage, WorkingBeatmap defaultBeatmap, GameHost host)
@@ -181,17 +181,6 @@ namespace osu.Game.Tests.Visual
                     => testBeatmapManager.TestBeatmap;
             }
 
-            internal class TestBeatmapModelManager : BeatmapModelManager
-            {
-                public TestBeatmapModelManager(Storage storage, RealmAccess databaseAccess, BeatmapOnlineLookupQueue beatmapOnlineLookupQueue)
-                    : base(databaseAccess, storage, beatmapOnlineLookupQueue)
-                {
-                }
-
-                protected override string ComputeHash(BeatmapSetInfo item)
-                    => string.Empty;
-            }
-
             public override void Save(BeatmapInfo info, IBeatmap beatmapContent, ISkin beatmapSkin = null)
             {
                 // don't actually care about saving for this context.

From 88d5e074a8c6ca4060101ca0747bfc5bf01b4f1a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 15 Jun 2022 00:46:00 +0900
Subject: [PATCH 5418/5547] Rename `lowPriority` to `batchImport`

---
 ...eneOnlinePlayBeatmapAvailabilityTracker.cs |  4 +--
 osu.Game/Beatmaps/BeatmapManager.cs           |  4 +--
 osu.Game/Scoring/ScoreManager.cs              |  2 +-
 osu.Game/Skinning/SkinManager.cs              |  6 ++--
 osu.Game/Stores/RealmArchiveModelImporter.cs  | 33 ++++++++-----------
 5 files changed, 22 insertions(+), 27 deletions(-)

diff --git a/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs b/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
index 5cae576db1..4f255ddd00 100644
--- a/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
+++ b/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
@@ -225,10 +225,10 @@ namespace osu.Game.Tests.Online
                     this.testBeatmapManager = testBeatmapManager;
                 }
 
-                public override Live<BeatmapSetInfo> Import(BeatmapSetInfo item, ArchiveReader archive = null, bool quickSkipIfExisting = false, CancellationToken cancellationToken = default)
+                public override Live<BeatmapSetInfo> Import(BeatmapSetInfo item, ArchiveReader archive = null, bool batchImport = false, CancellationToken cancellationToken = default)
                 {
                     testBeatmapManager.AllowImport.Task.WaitSafely();
-                    return (testBeatmapManager.CurrentImport = base.Import(item, archive, quickSkipIfExisting, cancellationToken));
+                    return (testBeatmapManager.CurrentImport = base.Import(item, archive, batchImport, cancellationToken));
                 }
             }
         }
diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index ab614106cc..e156c2b430 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -353,9 +353,9 @@ namespace osu.Game.Beatmaps
 
         public Task<IEnumerable<Live<BeatmapSetInfo>>> Import(ProgressNotification notification, params ImportTask[] tasks) => beatmapModelManager.Import(notification, tasks);
 
-        public Task<Live<BeatmapSetInfo>?> Import(ImportTask task, bool lowPriority = false, CancellationToken cancellationToken = default) => beatmapModelManager.Import(task, lowPriority, cancellationToken);
+        public Task<Live<BeatmapSetInfo>?> Import(ImportTask task, bool batchImport = false, CancellationToken cancellationToken = default) => beatmapModelManager.Import(task, batchImport, cancellationToken);
 
-        public Task<Live<BeatmapSetInfo>?> Import(ArchiveReader archive, bool lowPriority = false, CancellationToken cancellationToken = default) => beatmapModelManager.Import(archive, lowPriority, cancellationToken);
+        public Task<Live<BeatmapSetInfo>?> Import(ArchiveReader archive, bool batchImport = false, CancellationToken cancellationToken = default) => beatmapModelManager.Import(archive, batchImport, cancellationToken);
 
         public Live<BeatmapSetInfo>? Import(BeatmapSetInfo item, ArchiveReader? archive = null, CancellationToken cancellationToken = default) => beatmapModelManager.Import(item, archive, false, cancellationToken);
 
diff --git a/osu.Game/Scoring/ScoreManager.cs b/osu.Game/Scoring/ScoreManager.cs
index e086135296..e857d2109f 100644
--- a/osu.Game/Scoring/ScoreManager.cs
+++ b/osu.Game/Scoring/ScoreManager.cs
@@ -280,7 +280,7 @@ namespace osu.Game.Scoring
 
         public Task<IEnumerable<Live<ScoreInfo>>> Import(ProgressNotification notification, params ImportTask[] tasks) => scoreModelManager.Import(notification, tasks);
 
-        public Live<ScoreInfo> Import(ScoreInfo item, ArchiveReader archive = null, bool lowPriority = false, CancellationToken cancellationToken = default) => scoreModelManager.Import(item, archive, lowPriority, cancellationToken);
+        public Live<ScoreInfo> Import(ScoreInfo item, ArchiveReader archive = null, bool batchImport = false, CancellationToken cancellationToken = default) => scoreModelManager.Import(item, archive, batchImport, cancellationToken);
 
         public bool IsAvailableLocally(ScoreInfo model) => scoreModelManager.IsAvailableLocally(model);
 
diff --git a/osu.Game/Skinning/SkinManager.cs b/osu.Game/Skinning/SkinManager.cs
index 6002bafa8d..f296386d34 100644
--- a/osu.Game/Skinning/SkinManager.cs
+++ b/osu.Game/Skinning/SkinManager.cs
@@ -276,10 +276,10 @@ namespace osu.Game.Skinning
 
         public Task<IEnumerable<Live<SkinInfo>>> Import(ProgressNotification notification, params ImportTask[] tasks) => skinModelManager.Import(notification, tasks);
 
-        public Task<Live<SkinInfo>> Import(ImportTask task, bool lowPriority = false, CancellationToken cancellationToken = default) => skinModelManager.Import(task, lowPriority, cancellationToken);
+        public Task<Live<SkinInfo>> Import(ImportTask task, bool batchImport = false, CancellationToken cancellationToken = default) => skinModelManager.Import(task, batchImport, cancellationToken);
 
-        public Task<Live<SkinInfo>> Import(ArchiveReader archive, bool lowPriority = false, CancellationToken cancellationToken = default) =>
-            skinModelManager.Import(archive, lowPriority, cancellationToken);
+        public Task<Live<SkinInfo>> Import(ArchiveReader archive, bool batchImport = false, CancellationToken cancellationToken = default) =>
+            skinModelManager.Import(archive, batchImport, cancellationToken);
 
         #endregion
 
diff --git a/osu.Game/Stores/RealmArchiveModelImporter.cs b/osu.Game/Stores/RealmArchiveModelImporter.cs
index 976b26aac2..c6231e5583 100644
--- a/osu.Game/Stores/RealmArchiveModelImporter.cs
+++ b/osu.Game/Stores/RealmArchiveModelImporter.cs
@@ -34,11 +34,6 @@ namespace osu.Game.Stores
     {
         private const int import_queue_request_concurrency = 1;
 
-        /// <summary>
-        /// The size of a batch import operation before considering it a lower priority operation.
-        /// </summary>
-        private const int low_priority_import_batch_size = 1;
-
         /// <summary>
         /// A singleton scheduler shared by all <see cref="RealmArchiveModelImporter{TModel}"/>.
         /// </summary>
@@ -49,11 +44,11 @@ namespace osu.Game.Stores
         private static readonly ThreadedTaskScheduler import_scheduler = new ThreadedTaskScheduler(import_queue_request_concurrency, nameof(RealmArchiveModelImporter<TModel>));
 
         /// <summary>
-        /// A second scheduler for lower priority imports.
+        /// A second scheduler for batch imports.
         /// For simplicity, these will just run in parallel with normal priority imports, but a future refactor would see this implemented via a custom scheduler/queue.
         /// See https://gist.github.com/peppy/f0e118a14751fc832ca30dd48ba3876b for an incomplete version of this.
         /// </summary>
-        private static readonly ThreadedTaskScheduler import_scheduler_low_priority = new ThreadedTaskScheduler(import_queue_request_concurrency, nameof(RealmArchiveModelImporter<TModel>));
+        private static readonly ThreadedTaskScheduler import_scheduler_batch = new ThreadedTaskScheduler(import_queue_request_concurrency, nameof(RealmArchiveModelImporter<TModel>));
 
         public virtual IEnumerable<string> HandledExtensions => new[] { @".zip" };
 
@@ -105,7 +100,7 @@ namespace osu.Game.Stores
 
             var imported = new List<Live<TModel>>();
 
-            bool isLowPriorityImport = tasks.Length > low_priority_import_batch_size;
+            bool isBatchImport = tasks.Length > 1;
 
             try
             {
@@ -115,7 +110,7 @@ namespace osu.Game.Stores
 
                     try
                     {
-                        var model = await Import(task, isLowPriorityImport, notification.CancellationToken).ConfigureAwait(false);
+                        var model = await Import(task, isBatchImport, notification.CancellationToken).ConfigureAwait(false);
 
                         lock (imported)
                         {
@@ -178,16 +173,16 @@ namespace osu.Game.Stores
         /// Note that this bypasses the UI flow and should only be used for special cases or testing.
         /// </summary>
         /// <param name="task">The <see cref="ImportTask"/> containing data about the <typeparamref name="TModel"/> to import.</param>
-        /// <param name="lowPriority">Whether this is a low priority import.</param>
+        /// <param name="batchImport">Whether this is a low priority import.</param>
         /// <param name="cancellationToken">An optional cancellation token.</param>
         /// <returns>The imported model, if successful.</returns>
-        public async Task<Live<TModel>?> Import(ImportTask task, bool lowPriority = false, CancellationToken cancellationToken = default)
+        public async Task<Live<TModel>?> Import(ImportTask task, bool batchImport = false, CancellationToken cancellationToken = default)
         {
             cancellationToken.ThrowIfCancellationRequested();
 
             Live<TModel>? import;
             using (ArchiveReader reader = task.GetReader())
-                import = await Import(reader, lowPriority, cancellationToken).ConfigureAwait(false);
+                import = await Import(reader, batchImport, cancellationToken).ConfigureAwait(false);
 
             // We may or may not want to delete the file depending on where it is stored.
             //  e.g. reconstructing/repairing database with items from default storage.
@@ -210,9 +205,9 @@ namespace osu.Game.Stores
         /// Silently import an item from an <see cref="ArchiveReader"/>.
         /// </summary>
         /// <param name="archive">The archive to be imported.</param>
-        /// <param name="lowPriority">Whether this is a low priority import.</param>
+        /// <param name="batchImport">Whether this is a low priority import.</param>
         /// <param name="cancellationToken">An optional cancellation token.</param>
-        public async Task<Live<TModel>?> Import(ArchiveReader archive, bool lowPriority = false, CancellationToken cancellationToken = default)
+        public async Task<Live<TModel>?> Import(ArchiveReader archive, bool batchImport = false, CancellationToken cancellationToken = default)
         {
             cancellationToken.ThrowIfCancellationRequested();
 
@@ -235,10 +230,10 @@ namespace osu.Game.Stores
                 return null;
             }
 
-            var scheduledImport = Task.Factory.StartNew(() => Import(model, archive, lowPriority, cancellationToken),
+            var scheduledImport = Task.Factory.StartNew(() => Import(model, archive, batchImport, cancellationToken),
                 cancellationToken,
                 TaskCreationOptions.HideScheduler,
-                lowPriority ? import_scheduler_low_priority : import_scheduler);
+                batchImport ? import_scheduler_batch : import_scheduler);
 
             return await scheduledImport.ConfigureAwait(false);
         }
@@ -248,16 +243,16 @@ namespace osu.Game.Stores
         /// </summary>
         /// <param name="item">The model to be imported.</param>
         /// <param name="archive">An optional archive to use for model population.</param>
-        /// <param name="quickSkipIfExisting">If <c>true</c>, imports will be skipped before they begin, given an existing model matches on hash and filenames. Should generally only be used for large batch imports, as it may defy user expectations when updating an existing model.</param>
+        /// <param name="batchImport">If <c>true</c>, imports will be skipped before they begin, given an existing model matches on hash and filenames. Should generally only be used for large batch imports, as it may defy user expectations when updating an existing model.</param>
         /// <param name="cancellationToken">An optional cancellation token.</param>
-        public virtual Live<TModel>? Import(TModel item, ArchiveReader? archive = null, bool quickSkipIfExisting = false, CancellationToken cancellationToken = default) => Realm.Run(realm =>
+        public virtual Live<TModel>? Import(TModel item, ArchiveReader? archive = null, bool batchImport = false, CancellationToken cancellationToken = default) => Realm.Run(realm =>
         {
             cancellationToken.ThrowIfCancellationRequested();
 
             bool checkedExisting = false;
             TModel? existing = null;
 
-            if (quickSkipIfExisting && archive != null)
+            if (batchImport && archive != null)
             {
                 // this is a fast bail condition to improve large import performance.
                 item.Hash = computeHashFast(archive);

From cac724f43679950579ba217d3a337d6d96d0d9da Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 15 Jun 2022 00:48:00 +0900
Subject: [PATCH 5419/5547] Re-enable ignored tests that will work again now

---
 osu.Game.Tests/Database/BeatmapImporterTests.cs | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/osu.Game.Tests/Database/BeatmapImporterTests.cs b/osu.Game.Tests/Database/BeatmapImporterTests.cs
index ab40ed2453..de2bbeb791 100644
--- a/osu.Game.Tests/Database/BeatmapImporterTests.cs
+++ b/osu.Game.Tests/Database/BeatmapImporterTests.cs
@@ -393,7 +393,6 @@ namespace osu.Game.Tests.Database
         }
 
         [Test]
-        [Ignore("intentionally broken by import optimisations")]
         public void TestImportThenImportWithChangedFile()
         {
             RunTestWithRealmAsync(async (realm, storage) =>
@@ -490,7 +489,6 @@ namespace osu.Game.Tests.Database
         }
 
         [Test]
-        [Ignore("intentionally broken by import optimisations")]
         public void TestImportCorruptThenImport()
         {
             RunTestWithRealmAsync(async (realm, storage) =>
@@ -502,16 +500,18 @@ namespace osu.Game.Tests.Database
 
                 var firstFile = imported.Files.First();
 
+                var fileStorage = storage.GetStorageForDirectory("files");
+
                 long originalLength;
-                using (var stream = storage.GetStream(firstFile.File.GetStoragePath()))
+                using (var stream = fileStorage.GetStream(firstFile.File.GetStoragePath()))
                     originalLength = stream.Length;
 
-                using (var stream = storage.CreateFileSafely(firstFile.File.GetStoragePath()))
+                using (var stream = fileStorage.CreateFileSafely(firstFile.File.GetStoragePath()))
                     stream.WriteByte(0);
 
                 var importedSecondTime = await LoadOszIntoStore(importer, realm.Realm);
 
-                using (var stream = storage.GetStream(firstFile.File.GetStoragePath()))
+                using (var stream = fileStorage.GetStream(firstFile.File.GetStoragePath()))
                     Assert.AreEqual(stream.Length, originalLength, "Corruption was not fixed on second import");
 
                 // check the newly "imported" beatmap is actually just the restored previous import. since it matches hash.

From 6be42094581b72719011148b8018463ebe4057b8 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 15 Jun 2022 01:04:43 +0900
Subject: [PATCH 5420/5547] Fix `AlwaysPresent` specification in wrong
 container

---
 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 6419532221..89329bfc65 100644
--- a/osu.Game/Screens/Play/HUDOverlay.cs
+++ b/osu.Game/Screens/Play/HUDOverlay.cs
@@ -94,6 +94,7 @@ namespace osu.Game.Screens.Play
                 {
                     Anchor = Anchor.TopRight,
                     Origin = Anchor.TopRight,
+                    AlwaysPresent = true,
                     Margin = new MarginPadding(10),
                     Spacing = new Vector2(10),
                     AutoSizeAxes = Axes.Both,
@@ -111,7 +112,6 @@ namespace osu.Game.Screens.Play
                     Margin = new MarginPadding(10),
                     Spacing = new Vector2(10),
                     AutoSizeAxes = Axes.Both,
-                    AlwaysPresent = true,
                     LayoutDuration = FADE_DURATION / 2,
                     LayoutEasing = FADE_EASING,
                     Direction = FillDirection.Vertical,

From cd74f22e12b67165899120e17edf5456e66e2aae Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Tue, 14 Jun 2022 19:04:01 +0300
Subject: [PATCH 5421/5547] Add failing test case

---
 .../Visual/Menus/TestSceneToolbar.cs          | 27 +++++++++++++++++++
 1 file changed, 27 insertions(+)

diff --git a/osu.Game.Tests/Visual/Menus/TestSceneToolbar.cs b/osu.Game.Tests/Visual/Menus/TestSceneToolbar.cs
index dbc7e54b5e..eb77453199 100644
--- a/osu.Game.Tests/Visual/Menus/TestSceneToolbar.cs
+++ b/osu.Game.Tests/Visual/Menus/TestSceneToolbar.cs
@@ -6,11 +6,16 @@ using Moq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Colour;
 using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.Shapes;
 using osu.Framework.Testing;
+using osu.Game.Graphics.Containers;
 using osu.Game.Overlays;
 using osu.Game.Overlays.Toolbar;
 using osu.Game.Rulesets;
+using osuTK.Graphics;
 using osuTK.Input;
 
 namespace osu.Game.Tests.Visual.Menus
@@ -95,6 +100,28 @@ namespace osu.Game.Tests.Visual.Menus
                 AddAssert("toolbar is visible", () => toolbar.State.Value == Visibility.Visible);
         }
 
+        [Test]
+        public void TestScrollInput()
+        {
+            OsuScrollContainer scroll = null;
+
+            AddStep("add scroll layer", () => Add(scroll = new OsuScrollContainer
+            {
+                Depth = 1f,
+                RelativeSizeAxes = Axes.Both,
+                Child = new Box
+                {
+                    RelativeSizeAxes = Axes.X,
+                    Height = DrawHeight * 2,
+                    Colour = ColourInfo.GradientVertical(Color4.Gray, Color4.DarkGray),
+                }
+            }));
+
+            AddStep("hover toolbar", () => InputManager.MoveMouseTo(toolbar));
+            AddStep("perform scroll", () => InputManager.ScrollVerticalBy(500));
+            AddAssert("not scrolled", () => scroll.Current == 0);
+        }
+
         public class TestToolbar : Toolbar
         {
             public new Bindable<OverlayActivation> OverlayActivationMode => base.OverlayActivationMode as Bindable<OverlayActivation>;

From d89c11e49e8cf37a24afbafbfa723166a90d4464 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Tue, 14 Jun 2022 19:04:32 +0300
Subject: [PATCH 5422/5547] Allow `Toolbar` to block scroll input from passing
 through

---
 osu.Game/Overlays/Toolbar/Toolbar.cs | 2 --
 1 file changed, 2 deletions(-)

diff --git a/osu.Game/Overlays/Toolbar/Toolbar.cs b/osu.Game/Overlays/Toolbar/Toolbar.cs
index b7fb2e45be..3b6e99fe98 100644
--- a/osu.Game/Overlays/Toolbar/Toolbar.cs
+++ b/osu.Game/Overlays/Toolbar/Toolbar.cs
@@ -41,8 +41,6 @@ namespace osu.Game.Overlays.Toolbar
         // Toolbar and its components need keyboard input even when hidden.
         public override bool PropagateNonPositionalInputSubTree => true;
 
-        protected override bool BlockScrollInput => false;
-
         public Toolbar()
         {
             RelativeSizeAxes = Axes.X;

From 49ec2572b8e5bc9eec1d0e929a8bd79878a25da4 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 15 Jun 2022 01:43:10 +0900
Subject: [PATCH 5423/5547] Allow scrolling overflow of ruleset buttons in the
 toolbar

---
 osu.Game/Overlays/Toolbar/Toolbar.cs       | 141 ++++++++++++++++-----
 osu.Game/Overlays/Toolbar/ToolbarButton.cs |   2 +-
 2 files changed, 107 insertions(+), 36 deletions(-)

diff --git a/osu.Game/Overlays/Toolbar/Toolbar.cs b/osu.Game/Overlays/Toolbar/Toolbar.cs
index 3b6e99fe98..1e21e7e16c 100644
--- a/osu.Game/Overlays/Toolbar/Toolbar.cs
+++ b/osu.Game/Overlays/Toolbar/Toolbar.cs
@@ -14,6 +14,7 @@ using osu.Framework.Bindables;
 using osu.Framework.Input.Events;
 using osu.Game.Rulesets;
 using osu.Framework.Input.Bindings;
+using osu.Game.Graphics.Containers;
 using osu.Game.Input.Bindings;
 
 namespace osu.Game.Overlays.Toolbar
@@ -65,45 +66,115 @@ namespace osu.Game.Overlays.Toolbar
             Children = new Drawable[]
             {
                 new ToolbarBackground(),
-                new FillFlowContainer
+                new GridContainer
                 {
-                    Direction = FillDirection.Horizontal,
-                    RelativeSizeAxes = Axes.Y,
-                    AutoSizeAxes = Axes.X,
-                    Children = new Drawable[]
+                    RelativeSizeAxes = Axes.Both,
+                    ColumnDimensions = new[]
                     {
-                        new ToolbarSettingsButton(),
-                        new ToolbarHomeButton
+                        new Dimension(GridSizeMode.AutoSize),
+                        new Dimension(),
+                        new Dimension(GridSizeMode.AutoSize)
+                    },
+                    Content = new[]
+                    {
+                        new Drawable[]
                         {
-                            Action = () => OnHome?.Invoke()
+                            new Container
+                            {
+                                Name = "Left buttons",
+                                RelativeSizeAxes = Axes.Y,
+                                AutoSizeAxes = Axes.X,
+                                Depth = float.MinValue,
+                                Children = new Drawable[]
+                                {
+                                    new Box
+                                    {
+                                        Colour = OsuColour.Gray(0.1f),
+                                        RelativeSizeAxes = Axes.Both,
+                                    },
+                                    new FillFlowContainer
+                                    {
+                                        Direction = FillDirection.Horizontal,
+                                        RelativeSizeAxes = Axes.Y,
+                                        AutoSizeAxes = Axes.X,
+                                        Children = new Drawable[]
+                                        {
+                                            new ToolbarSettingsButton(),
+                                            new ToolbarHomeButton
+                                            {
+                                                Action = () => OnHome?.Invoke()
+                                            },
+                                        },
+                                    },
+                                }
+                            },
+                            new Container
+                            {
+                                Name = "Ruleset selector",
+                                RelativeSizeAxes = Axes.Both,
+                                Children = new Drawable[]
+                                {
+                                    new OsuScrollContainer(Direction.Horizontal)
+                                    {
+                                        ScrollbarVisible = false,
+                                        RelativeSizeAxes = Axes.Both,
+                                        Masking = false,
+                                        Children = new Drawable[]
+                                        {
+                                            rulesetSelector = new ToolbarRulesetSelector()
+                                        }
+                                    },
+                                    new Box
+                                    {
+                                        Colour = ColourInfo.GradientHorizontal(OsuColour.Gray(0.1f).Opacity(0), OsuColour.Gray(0.1f)),
+                                        Width = 50,
+                                        RelativeSizeAxes = Axes.Y,
+                                        Anchor = Anchor.TopRight,
+                                        Origin = Anchor.TopRight,
+                                    },
+                                }
+                            },
+                            new Container
+                            {
+                                Name = "Right buttons",
+                                RelativeSizeAxes = Axes.Y,
+                                AutoSizeAxes = Axes.X,
+                                Children = new Drawable[]
+                                {
+                                    new Box
+                                    {
+                                        Colour = OsuColour.Gray(0.1f),
+                                        RelativeSizeAxes = Axes.Both,
+                                    },
+                                    new FillFlowContainer
+                                    {
+                                        Anchor = Anchor.TopRight,
+                                        Origin = Anchor.TopRight,
+                                        Direction = FillDirection.Horizontal,
+                                        RelativeSizeAxes = Axes.Y,
+                                        AutoSizeAxes = Axes.X,
+                                        Children = new Drawable[]
+                                        {
+                                            new ToolbarNewsButton(),
+                                            new ToolbarChangelogButton(),
+                                            new ToolbarRankingsButton(),
+                                            new ToolbarBeatmapListingButton(),
+                                            new ToolbarChatButton(),
+                                            new ToolbarSocialButton(),
+                                            new ToolbarWikiButton(),
+                                            new ToolbarMusicButton(),
+                                            //new ToolbarButton
+                                            //{
+                                            //    Icon = FontAwesome.Solid.search
+                                            //},
+                                            userButton = new ToolbarUserButton(),
+                                            new ToolbarClock(),
+                                            new ToolbarNotificationButton(),
+                                        }
+                                    },
+                                }
+                            },
                         },
-                        rulesetSelector = new ToolbarRulesetSelector()
-                    }
-                },
-                new FillFlowContainer
-                {
-                    Anchor = Anchor.TopRight,
-                    Origin = Anchor.TopRight,
-                    Direction = FillDirection.Horizontal,
-                    RelativeSizeAxes = Axes.Y,
-                    AutoSizeAxes = Axes.X,
-                    Children = new Drawable[]
-                    {
-                        new ToolbarNewsButton(),
-                        new ToolbarChangelogButton(),
-                        new ToolbarRankingsButton(),
-                        new ToolbarBeatmapListingButton(),
-                        new ToolbarChatButton(),
-                        new ToolbarSocialButton(),
-                        new ToolbarWikiButton(),
-                        new ToolbarMusicButton(),
-                        //new ToolbarButton
-                        //{
-                        //    Icon = FontAwesome.Solid.search
-                        //},
-                        userButton = new ToolbarUserButton(),
-                        new ToolbarClock(),
-                        new ToolbarNotificationButton(),
                     }
                 }
             };
diff --git a/osu.Game/Overlays/Toolbar/ToolbarButton.cs b/osu.Game/Overlays/Toolbar/ToolbarButton.cs
index b686f11c13..b2b80f0e05 100644
--- a/osu.Game/Overlays/Toolbar/ToolbarButton.cs
+++ b/osu.Game/Overlays/Toolbar/ToolbarButton.cs
@@ -161,7 +161,7 @@ namespace osu.Game.Overlays.Toolbar
             };
         }
 
-        protected override bool OnMouseDown(MouseDownEvent e) => true;
+        protected override bool OnMouseDown(MouseDownEvent e) => false;
 
         protected override bool OnClick(ClickEvent e)
         {

From 0d36495cfca7d79a3b81f51550613f82a551823a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 15 Jun 2022 02:25:06 +0900
Subject: [PATCH 5424/5547] Fix up code quality, use more correct URL and
 update button text

---
 osu.Desktop/DiscordRichPresence.cs | 37 +++++++++++++++++++-----------
 1 file changed, 24 insertions(+), 13 deletions(-)

diff --git a/osu.Desktop/DiscordRichPresence.cs b/osu.Desktop/DiscordRichPresence.cs
index 6700184e0b..27c6062bb3 100644
--- a/osu.Desktop/DiscordRichPresence.cs
+++ b/osu.Desktop/DiscordRichPresence.cs
@@ -9,6 +9,7 @@ using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Logging;
+using osu.Game.Beatmaps;
 using osu.Game.Configuration;
 using osu.Game.Extensions;
 using osu.Game.Online.API;
@@ -102,11 +103,17 @@ namespace osu.Desktop
                 presence.State = truncate(activity.Value.Status);
                 presence.Details = truncate(getDetails(activity.Value));
 
-                if (getOnlineID(activity.Value) != null)
+                if (getBeatmap(activity.Value) is IBeatmapInfo beatmap && beatmap.OnlineID > 0)
                 {
-                    presence.Buttons = new Button[]
+                    string rulesetShortName = (activity.Value as UserActivity.InGame)?.Ruleset.ShortName ?? string.Empty;
+
+                    presence.Buttons = new[]
                     {
-                        new Button() { Label = "Open Beatmap", Url = $"https://osu.ppy.sh/b/{getOnlineID(activity.Value)}" }
+                        new Button
+                        {
+                            Label = "View beatmap",
+                            Url = $@"{api.WebsiteRootUrl}/beatmapsets/{beatmap.BeatmapSet?.OnlineID}#{rulesetShortName}/{beatmap.OnlineID}"
+                        }
                     };
                 }
                 else
@@ -159,6 +166,20 @@ namespace osu.Desktop
             });
         }
 
+        private IBeatmapInfo getBeatmap(UserActivity activity)
+        {
+            switch (activity)
+            {
+                case UserActivity.InGame game:
+                    return game.BeatmapInfo;
+
+                case UserActivity.Editing edit:
+                    return edit.BeatmapInfo;
+            }
+
+            return null;
+        }
+
         private string getDetails(UserActivity activity)
         {
             switch (activity)
@@ -176,16 +197,6 @@ namespace osu.Desktop
             return string.Empty;
         }
 
-        private int? getOnlineID(UserActivity activity)
-        {
-            if (activity is UserActivity.InGame game && game.BeatmapInfo.OnlineID > 0)
-            {
-                return game.BeatmapInfo.OnlineID;
-            }
-
-            return null;
-        }
-
         protected override void Dispose(bool isDisposing)
         {
             client.Dispose();

From 1951eb30bc52d3991125557b76d570d9c5e0cc74 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 15 Jun 2022 02:27:49 +0900
Subject: [PATCH 5425/5547] Remove call to `RegisterUriScheme`

Seems both unnecessary, and crashes the whole came on macOS.
---
 osu.Desktop/DiscordRichPresence.cs | 2 --
 1 file changed, 2 deletions(-)

diff --git a/osu.Desktop/DiscordRichPresence.cs b/osu.Desktop/DiscordRichPresence.cs
index 27c6062bb3..82e5932443 100644
--- a/osu.Desktop/DiscordRichPresence.cs
+++ b/osu.Desktop/DiscordRichPresence.cs
@@ -52,8 +52,6 @@ namespace osu.Desktop
                 SkipIdenticalPresence = false // handles better on discord IPC loss, see updateStatus call in onReady.
             };
 
-            client.RegisterUriScheme();
-
             client.OnReady += onReady;
 
             // safety measure for now, until we performance test / improve backoff for failed connections.

From c55c7becba0bfec5794400ea153cdfb7d403d7d4 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 15 Jun 2022 02:38:44 +0900
Subject: [PATCH 5426/5547] Always use current ruleset to ensure URL is valid

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

diff --git a/osu.Desktop/DiscordRichPresence.cs b/osu.Desktop/DiscordRichPresence.cs
index 82e5932443..43acac4f3e 100644
--- a/osu.Desktop/DiscordRichPresence.cs
+++ b/osu.Desktop/DiscordRichPresence.cs
@@ -103,14 +103,12 @@ namespace osu.Desktop
 
                 if (getBeatmap(activity.Value) is IBeatmapInfo beatmap && beatmap.OnlineID > 0)
                 {
-                    string rulesetShortName = (activity.Value as UserActivity.InGame)?.Ruleset.ShortName ?? string.Empty;
-
                     presence.Buttons = new[]
                     {
                         new Button
                         {
                             Label = "View beatmap",
-                            Url = $@"{api.WebsiteRootUrl}/beatmapsets/{beatmap.BeatmapSet?.OnlineID}#{rulesetShortName}/{beatmap.OnlineID}"
+                            Url = $@"{api.WebsiteRootUrl}/beatmapsets/{beatmap.BeatmapSet?.OnlineID}#{ruleset.Value.ShortName}/{beatmap.OnlineID}"
                         }
                     };
                 }

From 6fe5cacd3c5ccc9102a1444ecbeef563f35381d8 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Tue, 14 Jun 2022 20:05:07 +0300
Subject: [PATCH 5427/5547] Fix hot reload crashing toolbar test scene

---
 .../Visual/Menus/TestSceneToolbar.cs          | 22 +++++++++++++++++--
 1 file changed, 20 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Visual/Menus/TestSceneToolbar.cs b/osu.Game.Tests/Visual/Menus/TestSceneToolbar.cs
index eb77453199..7cb467aa19 100644
--- a/osu.Game.Tests/Visual/Menus/TestSceneToolbar.cs
+++ b/osu.Game.Tests/Visual/Menus/TestSceneToolbar.cs
@@ -2,6 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System.Linq;
+using JetBrains.Annotations;
 using Moq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
@@ -13,6 +14,7 @@ using osu.Framework.Graphics.Shapes;
 using osu.Framework.Testing;
 using osu.Game.Graphics.Containers;
 using osu.Game.Overlays;
+using osu.Game.Overlays.Notifications;
 using osu.Game.Overlays.Toolbar;
 using osu.Game.Rulesets;
 using osuTK.Graphics;
@@ -28,14 +30,14 @@ namespace osu.Game.Tests.Visual.Menus
         [Resolved]
         private IRulesetStore rulesets { get; set; }
 
-        private readonly Mock<INotificationOverlay> notifications = new Mock<INotificationOverlay>();
+        private readonly Mock<TestNotificationOverlay> notifications = new Mock<TestNotificationOverlay>();
 
         private readonly BindableInt unreadNotificationCount = new BindableInt();
 
         [BackgroundDependencyLoader]
         private void load()
         {
-            Dependencies.CacheAs(notifications.Object);
+            Dependencies.CacheAs<INotificationOverlay>(notifications.Object);
             notifications.SetupGet(n => n.UnreadCount).Returns(unreadNotificationCount);
         }
 
@@ -126,5 +128,21 @@ namespace osu.Game.Tests.Visual.Menus
         {
             public new Bindable<OverlayActivation> OverlayActivationMode => base.OverlayActivationMode as Bindable<OverlayActivation>;
         }
+
+        // interface mocks break hot reload, mocking this stub implementation instead works around it.
+        // see: https://github.com/moq/moq4/issues/1252
+        [UsedImplicitly]
+        public class TestNotificationOverlay : INotificationOverlay
+        {
+            public virtual void Post(Notification notification)
+            {
+            }
+
+            public virtual void Hide()
+            {
+            }
+
+            public virtual IBindable<int> UnreadCount => null;
+        }
     }
 }

From 7f23677972b5bfc794eabdfce1361d025fa5bf70 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Tue, 14 Jun 2022 20:35:09 +0300
Subject: [PATCH 5428/5547] Add volume control support via toolbar music button

---
 .../Visual/Menus/TestSceneToolbar.cs          | 38 ++++++++++++++++++-
 .../Overlays/Toolbar/ToolbarMusicButton.cs    | 10 +++++
 2 files changed, 47 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/Menus/TestSceneToolbar.cs b/osu.Game.Tests/Visual/Menus/TestSceneToolbar.cs
index 7cb467aa19..09fae2fb77 100644
--- a/osu.Game.Tests/Visual/Menus/TestSceneToolbar.cs
+++ b/osu.Game.Tests/Visual/Menus/TestSceneToolbar.cs
@@ -30,6 +30,21 @@ namespace osu.Game.Tests.Visual.Menus
         [Resolved]
         private IRulesetStore rulesets { get; set; }
 
+        [Cached]
+        private readonly NowPlayingOverlay nowPlayingOverlay = new NowPlayingOverlay
+        {
+            Anchor = Anchor.TopRight,
+            Origin = Anchor.TopRight,
+            Y = Toolbar.HEIGHT,
+        };
+
+        [Cached]
+        private readonly VolumeOverlay volumeOverlay = new VolumeOverlay
+        {
+            Anchor = Anchor.CentreLeft,
+            Origin = Anchor.CentreLeft,
+        };
+
         private readonly Mock<TestNotificationOverlay> notifications = new Mock<TestNotificationOverlay>();
 
         private readonly BindableInt unreadNotificationCount = new BindableInt();
@@ -44,7 +59,15 @@ namespace osu.Game.Tests.Visual.Menus
         [SetUp]
         public void SetUp() => Schedule(() =>
         {
-            Child = toolbar = new TestToolbar { State = { Value = Visibility.Visible } };
+            Remove(nowPlayingOverlay);
+            Remove(volumeOverlay);
+
+            Children = new Drawable[]
+            {
+                nowPlayingOverlay,
+                volumeOverlay,
+                toolbar = new TestToolbar { State = { Value = Visibility.Visible } },
+            };
         });
 
         [Test]
@@ -124,6 +147,19 @@ namespace osu.Game.Tests.Visual.Menus
             AddAssert("not scrolled", () => scroll.Current == 0);
         }
 
+        [Test]
+        public void TestVolumeControlViaMusicButton()
+        {
+            AddStep("hover toolbar music button", () => InputManager.MoveMouseTo(this.ChildrenOfType<ToolbarMusicButton>().Single()));
+
+            AddStep("reset volume", () => Audio.Volume.Value = 1);
+
+            AddRepeatStep("scroll down", () => InputManager.ScrollVerticalBy(-10), 5);
+            AddAssert("volume lowered down", () => Audio.Volume.Value < 1);
+            AddRepeatStep("scroll up", () => InputManager.ScrollVerticalBy(10), 5);
+            AddAssert("volume raised up", () => Audio.Volume.Value == 1);
+        }
+
         public class TestToolbar : Toolbar
         {
             public new Bindable<OverlayActivation> OverlayActivationMode => base.OverlayActivationMode as Bindable<OverlayActivation>;
diff --git a/osu.Game/Overlays/Toolbar/ToolbarMusicButton.cs b/osu.Game/Overlays/Toolbar/ToolbarMusicButton.cs
index 0f5e8e5456..9804c857bf 100644
--- a/osu.Game/Overlays/Toolbar/ToolbarMusicButton.cs
+++ b/osu.Game/Overlays/Toolbar/ToolbarMusicButton.cs
@@ -3,6 +3,7 @@
 
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
+using osu.Framework.Input.Events;
 using osu.Game.Input.Bindings;
 
 namespace osu.Game.Overlays.Toolbar
@@ -21,5 +22,14 @@ namespace osu.Game.Overlays.Toolbar
         {
             StateContainer = music;
         }
+
+        [Resolved(canBeNull: true)]
+        private VolumeOverlay volume { get; set; }
+
+        protected override bool OnScroll(ScrollEvent e)
+        {
+            volume?.Adjust(GlobalAction.IncreaseVolume, e.ScrollDelta.Y, e.IsPrecise);
+            return true;
+        }
     }
 }

From 1f31e3fb5199b646c00ed448fe1ca2b7658752e8 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Tue, 14 Jun 2022 22:13:26 +0300
Subject: [PATCH 5429/5547] Add volume UI to toolbar music button

---
 .../Overlays/Toolbar/ToolbarMusicButton.cs    | 49 +++++++++++++++++++
 1 file changed, 49 insertions(+)

diff --git a/osu.Game/Overlays/Toolbar/ToolbarMusicButton.cs b/osu.Game/Overlays/Toolbar/ToolbarMusicButton.cs
index 9804c857bf..34dc3b4080 100644
--- a/osu.Game/Overlays/Toolbar/ToolbarMusicButton.cs
+++ b/osu.Game/Overlays/Toolbar/ToolbarMusicButton.cs
@@ -2,30 +2,79 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using osu.Framework.Allocation;
+using osu.Framework.Audio;
+using osu.Framework.Bindables;
+using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.Shapes;
 using osu.Framework.Input.Events;
 using osu.Game.Input.Bindings;
+using osuTK.Graphics;
 
 namespace osu.Game.Overlays.Toolbar
 {
     public class ToolbarMusicButton : ToolbarOverlayToggleButton
     {
+        private Circle volumeBar;
+
         protected override Anchor TooltipAnchor => Anchor.TopRight;
 
         public ToolbarMusicButton()
         {
             Hotkey = GlobalAction.ToggleNowPlaying;
+            AutoSizeAxes = Axes.X;
         }
 
         [BackgroundDependencyLoader(true)]
         private void load(NowPlayingOverlay music)
         {
             StateContainer = music;
+
+            Flow.Padding = new MarginPadding { Horizontal = Toolbar.HEIGHT / 4 };
+            Flow.Add(new Container
+            {
+                Anchor = Anchor.CentreLeft,
+                Origin = Anchor.CentreLeft,
+                Width = 3f,
+                Height = IconContainer.Height,
+                Margin = new MarginPadding { Horizontal = 2.5f },
+                Masking = true,
+                Children = new[]
+                {
+                    new Circle
+                    {
+                        RelativeSizeAxes = Axes.Both,
+                        Colour = Color4.White.Opacity(0.25f),
+                    },
+                    volumeBar = new Circle
+                    {
+                        RelativeSizeAxes = Axes.Both,
+                        Height = 0f,
+                        Anchor = Anchor.BottomLeft,
+                        Origin = Anchor.BottomLeft,
+                        Colour = Color4.White,
+                    }
+                }
+            });
         }
 
+        [Resolved]
+        private AudioManager audio { get; set; }
+
         [Resolved(canBeNull: true)]
         private VolumeOverlay volume { get; set; }
 
+        private IBindable<double> globalVolume;
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            globalVolume = audio.Volume.GetBoundCopy();
+            globalVolume.BindValueChanged(v => volumeBar.Height = (float)v.NewValue, true);
+        }
+
         protected override bool OnScroll(ScrollEvent e)
         {
             volume?.Adjust(GlobalAction.IncreaseVolume, e.ScrollDelta.Y, e.IsPrecise);

From 1171d44ad972573af689ee469c752f32168017a2 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 15 Jun 2022 03:34:08 +0300
Subject: [PATCH 5430/5547] Add failing test case

---
 .../Navigation/TestSceneFirstRunGame.cs       | 46 +++++++++++++++++++
 osu.Game/OsuGame.cs                           |  8 ++--
 osu.Game/Tests/Visual/OsuGameTestScene.cs     |  2 +
 3 files changed, 52 insertions(+), 4 deletions(-)
 create mode 100644 osu.Game.Tests/Visual/Navigation/TestSceneFirstRunGame.cs

diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneFirstRunGame.cs b/osu.Game.Tests/Visual/Navigation/TestSceneFirstRunGame.cs
new file mode 100644
index 0000000000..37d7faf1fb
--- /dev/null
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneFirstRunGame.cs
@@ -0,0 +1,46 @@
+// 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.Containers;
+using osu.Framework.Platform;
+using osu.Game.Configuration;
+using osu.Game.Online.API;
+using osu.Game.Overlays.Notifications;
+
+namespace osu.Game.Tests.Visual.Navigation
+{
+    [System.ComponentModel.Description("game with first-run setup overlay")]
+    public class TestSceneFirstRunGame : OsuGameTestScene
+    {
+        public override void SetUpSteps()
+        {
+            base.SetUpSteps();
+
+            AddUntilStep("Wait for first-run setup", () => Game.FirstRunOverlay.State.Value == Visibility.Visible);
+        }
+
+        [Test]
+        public void TestImportantNotificationDoesntInterruptSetup()
+        {
+            AddStep("post important notification", () => Game.Notifications.Post(new SimpleNotification { Text = "Important notification" }));
+            AddAssert("first-run setup still visible", () => Game.FirstRunOverlay.State.Value == Visibility.Visible);
+        }
+
+        protected override TestOsuGame CreateTestGame() => new FirstRunGame(LocalStorage, API);
+
+        private class FirstRunGame : TestOsuGame
+        {
+            public FirstRunGame(Storage storage, IAPIProvider api, string[] args = null)
+                : base(storage, api, args)
+            {
+            }
+
+            protected override void LoadComplete()
+            {
+                base.LoadComplete();
+                LocalConfig.SetValue(OsuSetting.ShowFirstRunSetup, true);
+            }
+        }
+    }
+}
diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index 1f9a1ce938..200f7613a1 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -153,7 +153,7 @@ namespace osu.Game
 
         protected SettingsOverlay Settings;
 
-        private FirstRunSetupOverlay firstRunOverlay;
+        protected FirstRunSetupOverlay FirstRunOverlay { get; private set; }
 
         private VolumeOverlay volume;
 
@@ -845,7 +845,7 @@ namespace osu.Game
             loadComponentSingleFile(CreateUpdateManager(), Add, true);
 
             // overlay elements
-            loadComponentSingleFile(firstRunOverlay = new FirstRunSetupOverlay(), overlayContent.Add, true);
+            loadComponentSingleFile(FirstRunOverlay = new FirstRunSetupOverlay(), overlayContent.Add, true);
             loadComponentSingleFile(new ManageCollectionsDialog(), overlayContent.Add, true);
             loadComponentSingleFile(beatmapListing = new BeatmapListingOverlay(), overlayContent.Add, true);
             loadComponentSingleFile(dashboard = new DashboardOverlay(), overlayContent.Add, true);
@@ -896,7 +896,7 @@ namespace osu.Game
             Add(new MusicKeyBindingHandler());
 
             // side overlays which cancel each other.
-            var singleDisplaySideOverlays = new OverlayContainer[] { Settings, Notifications, firstRunOverlay };
+            var singleDisplaySideOverlays = new OverlayContainer[] { Settings, Notifications, FirstRunOverlay };
 
             foreach (var overlay in singleDisplaySideOverlays)
             {
@@ -921,7 +921,7 @@ namespace osu.Game
             }
 
             // ensure only one of these overlays are open at once.
-            var singleDisplayOverlays = new OverlayContainer[] { firstRunOverlay, chatOverlay, news, dashboard, beatmapListing, changelogOverlay, rankingsOverlay, wikiOverlay };
+            var singleDisplayOverlays = new OverlayContainer[] { FirstRunOverlay, chatOverlay, news, dashboard, beatmapListing, changelogOverlay, rankingsOverlay, wikiOverlay };
 
             foreach (var overlay in singleDisplayOverlays)
             {
diff --git a/osu.Game/Tests/Visual/OsuGameTestScene.cs b/osu.Game/Tests/Visual/OsuGameTestScene.cs
index 6e4adb4d4c..5995b30b60 100644
--- a/osu.Game/Tests/Visual/OsuGameTestScene.cs
+++ b/osu.Game/Tests/Visual/OsuGameTestScene.cs
@@ -132,6 +132,8 @@ namespace osu.Game.Tests.Visual
 
             public new NotificationOverlay Notifications => base.Notifications;
 
+            public new FirstRunSetupOverlay FirstRunOverlay => base.FirstRunOverlay;
+
             public new MusicController MusicController => base.MusicController;
 
             public new OsuConfigManager LocalConfig => base.LocalConfig;

From ddeee09a5193fd79135540b26c54e81a14590e70 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 15 Jun 2022 03:36:38 +0300
Subject: [PATCH 5431/5547] Fix important notifications interrupting first-run
 setup

---
 osu.Game/Overlays/NotificationOverlay.cs | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/NotificationOverlay.cs b/osu.Game/Overlays/NotificationOverlay.cs
index f1ed5c4ba6..e4ee2fe049 100644
--- a/osu.Game/Overlays/NotificationOverlay.cs
+++ b/osu.Game/Overlays/NotificationOverlay.cs
@@ -35,6 +35,9 @@ namespace osu.Game.Overlays
         [Resolved]
         private AudioManager audio { get; set; }
 
+        [Resolved(canBeNull: true)]
+        private FirstRunSetupOverlay firstRunSetup { get; set; }
+
         [BackgroundDependencyLoader]
         private void load()
         {
@@ -130,7 +133,9 @@ namespace osu.Game.Overlays
             var section = sections.Children.FirstOrDefault(s => s.AcceptTypes.Any(accept => accept.IsAssignableFrom(ourType)));
             section?.Add(notification, notification.DisplayOnTop ? -runningDepth : runningDepth);
 
-            if (notification.IsImportant)
+            // we don't want important notifications interrupting user on first-run setup.
+            // (this can happen when importing beatmaps inside setup, which posts import notifications)
+            if (notification.IsImportant && firstRunSetup?.State.Value != Visibility.Visible)
                 Show();
 
             updateCounts();

From 850afcb1c3f9d8dfb35a39ae85a24458e180f1f2 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 15 Jun 2022 05:43:39 +0300
Subject: [PATCH 5432/5547] Add failing test case

---
 .../Editing/TestSceneZoomableScrollContainer.cs   | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneZoomableScrollContainer.cs b/osu.Game.Tests/Visual/Editing/TestSceneZoomableScrollContainer.cs
index 2d056bafdd..43e3404d98 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneZoomableScrollContainer.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneZoomableScrollContainer.cs
@@ -78,6 +78,21 @@ namespace osu.Game.Tests.Visual.Editing
             AddAssert("Inner container width matches scroll container", () => innerBox.DrawWidth == scrollContainer.DrawWidth);
         }
 
+        [Test]
+        public void TestZoomRangeUpdate()
+        {
+            AddStep("set zoom to 2", () => scrollContainer.Zoom = 2);
+            AddStep("set min zoom to 5", () => scrollContainer.MinZoom = 5);
+            AddAssert("zoom = 5", () => scrollContainer.Zoom == 5);
+
+            AddStep("set max zoom to 10", () => scrollContainer.MaxZoom = 10);
+            AddAssert("zoom = 5", () => scrollContainer.Zoom == 5);
+
+            AddStep("set min zoom to 20", () => scrollContainer.MinZoom = 20);
+            AddStep("set max zoom to 40", () => scrollContainer.MaxZoom = 40);
+            AddAssert("zoom = 20", () => scrollContainer.Zoom == 20);
+        }
+
         [Test]
         public void TestZoom0()
         {

From 268a7e13343c13001384ac9a700582f9f81464c9 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 15 Jun 2022 05:19:51 +0300
Subject: [PATCH 5433/5547] Fix `ZoomableScrollContainer` attempting to update
 zoom with overlapping range

---
 .../Components/Timeline/ZoomableScrollContainer.cs     | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/ZoomableScrollContainer.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/ZoomableScrollContainer.cs
index d008368b69..d58cb27274 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/ZoomableScrollContainer.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/ZoomableScrollContainer.cs
@@ -66,8 +66,9 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
 
                 minZoom = value;
 
-                if (Zoom < value)
-                    Zoom = value;
+                // ensure zoom range is in valid state before updating zoom.
+                if (MinZoom < MaxZoom)
+                    Zoom = Zoom;
             }
         }
 
@@ -86,8 +87,9 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
 
                 maxZoom = value;
 
-                if (Zoom > value)
-                    Zoom = value;
+                // ensure zoom range is in valid state before updating zoom.
+                if (MaxZoom > MinZoom)
+                    Zoom = Zoom;
             }
         }
 

From ee8045d5079b8cda129910297d00baa26c3420ec Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 15 Jun 2022 06:31:26 +0300
Subject: [PATCH 5434/5547] Add failing test case

---
 .../Database/LegacyBeatmapImporterTest.cs     | 67 +++++++++++++++++++
 osu.Game/IO/StableStorage.cs                  |  4 +-
 2 files changed, 69 insertions(+), 2 deletions(-)
 create mode 100644 osu.Game.Tests/Database/LegacyBeatmapImporterTest.cs

diff --git a/osu.Game.Tests/Database/LegacyBeatmapImporterTest.cs b/osu.Game.Tests/Database/LegacyBeatmapImporterTest.cs
new file mode 100644
index 0000000000..145ba2c730
--- /dev/null
+++ b/osu.Game.Tests/Database/LegacyBeatmapImporterTest.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 System.Collections.Generic;
+using System.IO;
+using System.Linq;
+using NUnit.Framework;
+using osu.Framework.Platform;
+using osu.Framework.Testing;
+using osu.Game.Database;
+using osu.Game.IO;
+
+namespace osu.Game.Tests.Database
+{
+    [TestFixture]
+    public class LegacyBeatmapImporterTest
+    {
+        private readonly TestLegacyBeatmapImporter importer = new TestLegacyBeatmapImporter();
+
+        [Test]
+        public void TestSongsSubdirectories()
+        {
+            using (var storage = new TemporaryNativeStorage("stable-songs-folder"))
+            {
+                var songsStorage = storage.GetStorageForDirectory(StableStorage.STABLE_DEFAULT_SONGS_PATH);
+
+                // normal beatmap folder
+                var beatmap1 = songsStorage.GetStorageForDirectory("beatmap1");
+                beatmap1.CreateFileSafely("beatmap.osu");
+
+                // songs subdirectory
+                var subdirectory = songsStorage.GetStorageForDirectory("subdirectory");
+                subdirectory.CreateFileSafely(subdirectory.GetFullPath(Path.Combine("beatmap2", "beatmap.osu"), true));
+                subdirectory.CreateFileSafely(subdirectory.GetFullPath(Path.Combine("beatmap3", "beatmap.osu"), true));
+                subdirectory.CreateFileSafely(subdirectory.GetFullPath(Path.Combine("sub-subdirectory", "beatmap4", "beatmap.osu"), true));
+
+                // songs subdirectory with system file
+                var subdirectory2 = songsStorage.GetStorageForDirectory("subdirectory2");
+                subdirectory2.CreateFileSafely(subdirectory2.GetFullPath(".DS_Store"));
+                subdirectory2.CreateFileSafely(subdirectory2.GetFullPath(Path.Combine("beatmap5", "beatmap.osu"), true));
+                subdirectory2.CreateFileSafely(subdirectory2.GetFullPath(Path.Combine("beatmap6", "beatmap.osu"), true));
+
+                // empty songs subdirectory
+                songsStorage.GetStorageForDirectory("subdirectory3");
+
+                string[] paths = importer.GetStableImportPaths(songsStorage).ToArray();
+                Assert.That(paths.Length, Is.EqualTo(6));
+                Assert.That(paths.Contains(songsStorage.GetFullPath("beatmap1")));
+                Assert.That(paths.Contains(songsStorage.GetFullPath(Path.Combine("subdirectory", "beatmap2"))));
+                Assert.That(paths.Contains(songsStorage.GetFullPath(Path.Combine("subdirectory", "beatmap3"))));
+                Assert.That(paths.Contains(songsStorage.GetFullPath(Path.Combine("subdirectory", "sub-subdirectory", "beatmap4"))));
+                Assert.That(paths.Contains(songsStorage.GetFullPath(Path.Combine("subdirectory2", "beatmap5"))));
+                Assert.That(paths.Contains(songsStorage.GetFullPath(Path.Combine("subdirectory2", "beatmap6"))));
+            }
+        }
+
+        private class TestLegacyBeatmapImporter : LegacyBeatmapImporter
+        {
+            public TestLegacyBeatmapImporter()
+                : base(null)
+            {
+            }
+
+            public new IEnumerable<string> GetStableImportPaths(Storage storage) => base.GetStableImportPaths(storage);
+        }
+    }
+}
diff --git a/osu.Game/IO/StableStorage.cs b/osu.Game/IO/StableStorage.cs
index 84b7da91fc..d4ff8fcdda 100644
--- a/osu.Game/IO/StableStorage.cs
+++ b/osu.Game/IO/StableStorage.cs
@@ -14,7 +14,7 @@ namespace osu.Game.IO
     /// </summary>
     public class StableStorage : DesktopStorage
     {
-        private const string stable_default_songs_path = "Songs";
+        public const string STABLE_DEFAULT_SONGS_PATH = "Songs";
 
         private readonly DesktopGameHost host;
         private readonly Lazy<string> songsPath;
@@ -62,7 +62,7 @@ namespace osu.Game.IO
                 }
             }
 
-            return GetFullPath(stable_default_songs_path);
+            return GetFullPath(STABLE_DEFAULT_SONGS_PATH);
         }
     }
 }

From 22c09ec893b184b6a3611eae18a5daa43b85b5a7 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 15 Jun 2022 06:53:49 +0300
Subject: [PATCH 5435/5547] Handle subdirectories during beatmap stable import

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

diff --git a/osu.Game/Database/LegacyBeatmapImporter.cs b/osu.Game/Database/LegacyBeatmapImporter.cs
index 97f6eba6c2..9ce267086d 100644
--- a/osu.Game/Database/LegacyBeatmapImporter.cs
+++ b/osu.Game/Database/LegacyBeatmapImporter.cs
@@ -1,6 +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 System.Linq;
+using osu.Framework.IO.Stores;
 using osu.Framework.Platform;
 using osu.Game.Beatmaps;
 using osu.Game.IO;
@@ -13,6 +16,24 @@ namespace osu.Game.Database
 
         protected override Storage PrepareStableStorage(StableStorage stableStorage) => stableStorage.GetSongStorage();
 
+        protected override IEnumerable<string> GetStableImportPaths(Storage storage)
+        {
+            foreach (string beatmapDirectory in storage.GetDirectories(string.Empty))
+            {
+                var beatmapStorage = storage.GetStorageForDirectory(beatmapDirectory);
+
+                if (!beatmapStorage.GetFiles(string.Empty).ExcludeSystemFileNames().Any())
+                {
+                    // if a directory doesn't contain files, attempt looking for beatmaps inside of that directory.
+                    // this is a special behaviour in stable for beatmaps only, see https://github.com/ppy/osu/issues/18615.
+                    foreach (string beatmapInDirectory in GetStableImportPaths(beatmapStorage))
+                        yield return beatmapStorage.GetFullPath(beatmapInDirectory);
+                }
+                else
+                    yield return storage.GetFullPath(beatmapDirectory);
+            }
+        }
+
         public LegacyBeatmapImporter(IModelImporter<BeatmapSetInfo> importer)
             : base(importer)
         {

From d3feb07bc1b6b861ac9db641226eee5c14344469 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 15 Jun 2022 07:57:16 +0300
Subject: [PATCH 5436/5547] Split zoom updating to named method with value as
 optional

---
 .../Timeline/ZoomableScrollContainer.cs       | 22 ++++++++++---------
 1 file changed, 12 insertions(+), 10 deletions(-)

diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/ZoomableScrollContainer.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/ZoomableScrollContainer.cs
index d58cb27274..bc6c66625c 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/ZoomableScrollContainer.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/ZoomableScrollContainer.cs
@@ -68,7 +68,7 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
 
                 // ensure zoom range is in valid state before updating zoom.
                 if (MinZoom < MaxZoom)
-                    Zoom = Zoom;
+                    updateZoom();
             }
         }
 
@@ -89,7 +89,7 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
 
                 // ensure zoom range is in valid state before updating zoom.
                 if (MaxZoom > MinZoom)
-                    Zoom = Zoom;
+                    updateZoom();
             }
         }
 
@@ -99,15 +99,17 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
         public float Zoom
         {
             get => zoomTarget;
-            set
-            {
-                value = Math.Clamp(value, MinZoom, MaxZoom);
+            set => updateZoom(value);
+        }
 
-                if (IsLoaded)
-                    setZoomTarget(value, ToSpaceOfOtherDrawable(new Vector2(DrawWidth / 2, 0), zoomedContent).X);
-                else
-                    currentZoom = zoomTarget = value;
-            }
+        private void updateZoom(float? value = null)
+        {
+            float newZoom = Math.Clamp(value ?? Zoom, MinZoom, MaxZoom);
+
+            if (IsLoaded)
+                setZoomTarget(newZoom, ToSpaceOfOtherDrawable(new Vector2(DrawWidth / 2, 0), zoomedContent).X);
+            else
+                currentZoom = zoomTarget = newZoom;
         }
 
         protected override void Update()

From 3d638abc52d39a33b64388610a006f007f413100 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 15 Jun 2022 08:24:18 +0300
Subject: [PATCH 5437/5547] Fix test files stream not disposed after creation

---
 .../Database/LegacyBeatmapImporterTest.cs     | 20 ++++++++++++-------
 1 file changed, 13 insertions(+), 7 deletions(-)

diff --git a/osu.Game.Tests/Database/LegacyBeatmapImporterTest.cs b/osu.Game.Tests/Database/LegacyBeatmapImporterTest.cs
index 145ba2c730..2af46374fe 100644
--- a/osu.Game.Tests/Database/LegacyBeatmapImporterTest.cs
+++ b/osu.Game.Tests/Database/LegacyBeatmapImporterTest.cs
@@ -26,19 +26,19 @@ namespace osu.Game.Tests.Database
 
                 // normal beatmap folder
                 var beatmap1 = songsStorage.GetStorageForDirectory("beatmap1");
-                beatmap1.CreateFileSafely("beatmap.osu");
+                createFile(beatmap1, "beatmap.osu");
 
                 // songs subdirectory
                 var subdirectory = songsStorage.GetStorageForDirectory("subdirectory");
-                subdirectory.CreateFileSafely(subdirectory.GetFullPath(Path.Combine("beatmap2", "beatmap.osu"), true));
-                subdirectory.CreateFileSafely(subdirectory.GetFullPath(Path.Combine("beatmap3", "beatmap.osu"), true));
-                subdirectory.CreateFileSafely(subdirectory.GetFullPath(Path.Combine("sub-subdirectory", "beatmap4", "beatmap.osu"), true));
+                createFile(subdirectory, Path.Combine("beatmap2", "beatmap.osu"));
+                createFile(subdirectory, Path.Combine("beatmap3", "beatmap.osu"));
+                createFile(subdirectory, Path.Combine("sub-subdirectory", "beatmap4", "beatmap.osu"));
 
                 // songs subdirectory with system file
                 var subdirectory2 = songsStorage.GetStorageForDirectory("subdirectory2");
-                subdirectory2.CreateFileSafely(subdirectory2.GetFullPath(".DS_Store"));
-                subdirectory2.CreateFileSafely(subdirectory2.GetFullPath(Path.Combine("beatmap5", "beatmap.osu"), true));
-                subdirectory2.CreateFileSafely(subdirectory2.GetFullPath(Path.Combine("beatmap6", "beatmap.osu"), true));
+                createFile(subdirectory2, ".DS_Store");
+                createFile(subdirectory2, Path.Combine("beatmap5", "beatmap.osu"));
+                createFile(subdirectory2, Path.Combine("beatmap6", "beatmap.osu"));
 
                 // empty songs subdirectory
                 songsStorage.GetStorageForDirectory("subdirectory3");
@@ -52,6 +52,12 @@ namespace osu.Game.Tests.Database
                 Assert.That(paths.Contains(songsStorage.GetFullPath(Path.Combine("subdirectory2", "beatmap5"))));
                 Assert.That(paths.Contains(songsStorage.GetFullPath(Path.Combine("subdirectory2", "beatmap6"))));
             }
+
+            static void createFile(Storage storage, string path)
+            {
+                using (var stream = storage.CreateFileSafely(path))
+                    stream.WriteByte(0);
+            }
         }
 
         private class TestLegacyBeatmapImporter : LegacyBeatmapImporter

From f3f0960335303bcdc8a53a491fe02fd12580dff2 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 15 Jun 2022 09:02:48 +0300
Subject: [PATCH 5438/5547] Use unified filename for background and track
 during editor import

---
 .../Editing/TestSceneEditorBeatmapCreation.cs |  3 ++
 .../Screens/Edit/Setup/ResourcesSection.cs    | 29 +++++++++++--------
 2 files changed, 20 insertions(+), 12 deletions(-)

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneEditorBeatmapCreation.cs b/osu.Game.Tests/Visual/Editing/TestSceneEditorBeatmapCreation.cs
index b109234fec..841f50e7bd 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneEditorBeatmapCreation.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneEditorBeatmapCreation.cs
@@ -101,6 +101,9 @@ namespace osu.Game.Tests.Visual.Editing
                 File.Delete(temp);
                 Directory.Delete(extractedFolder, true);
 
+                // ensure audio file is copied to beatmap as "audio.mp3" rather than original filename.
+                Assert.That(Beatmap.Value.Metadata.AudioFile == "audio.mp3");
+
                 return success;
             });
 
diff --git a/osu.Game/Screens/Edit/Setup/ResourcesSection.cs b/osu.Game/Screens/Edit/Setup/ResourcesSection.cs
index 1e97218074..9d4e72d1f3 100644
--- a/osu.Game/Screens/Edit/Setup/ResourcesSection.cs
+++ b/osu.Game/Screens/Edit/Setup/ResourcesSection.cs
@@ -64,26 +64,28 @@ namespace osu.Game.Screens.Edit.Setup
 
         public bool ChangeBackgroundImage(string path)
         {
-            var info = new FileInfo(path);
+            var source = new FileInfo(path);
 
-            if (!info.Exists)
+            if (!source.Exists)
                 return false;
 
             var set = working.Value.BeatmapSetInfo;
 
+            var destination = new FileInfo($@"bg{source.Extension}");
+
             // remove the previous background for now.
             // in the future we probably want to check if this is being used elsewhere (other difficulties?)
-            var oldFile = set.Files.FirstOrDefault(f => f.Filename == working.Value.Metadata.BackgroundFile);
+            var oldFile = set.Files.FirstOrDefault(f => Path.GetFileNameWithoutExtension(f.Filename) == destination.Name);
 
-            using (var stream = info.OpenRead())
+            using (var stream = source.OpenRead())
             {
                 if (oldFile != null)
                     beatmaps.DeleteFile(set, oldFile);
 
-                beatmaps.AddFile(set, stream, info.Name);
+                beatmaps.AddFile(set, stream, destination.Name);
             }
 
-            working.Value.Metadata.BackgroundFile = info.Name;
+            working.Value.Metadata.BackgroundFile = destination.Name;
             header.Background.UpdateBackground();
 
             return true;
@@ -91,25 +93,28 @@ namespace osu.Game.Screens.Edit.Setup
 
         public bool ChangeAudioTrack(string path)
         {
-            var info = new FileInfo(path);
+            var source = new FileInfo(path);
 
-            if (!info.Exists)
+            if (!source.Exists)
                 return false;
 
             var set = working.Value.BeatmapSetInfo;
 
+            var destination = new FileInfo($@"audio{source.Extension}");
+
             // remove the previous audio track for now.
             // in the future we probably want to check if this is being used elsewhere (other difficulties?)
-            var oldFile = set.Files.FirstOrDefault(f => f.Filename == working.Value.Metadata.AudioFile);
+            var oldFile = set.Files.FirstOrDefault(f => Path.GetFileNameWithoutExtension(f.Filename) == destination.Name);
 
-            using (var stream = info.OpenRead())
+            using (var stream = source.OpenRead())
             {
                 if (oldFile != null)
                     beatmaps.DeleteFile(set, oldFile);
-                beatmaps.AddFile(set, stream, info.Name);
+
+                beatmaps.AddFile(set, stream, destination.Name);
             }
 
-            working.Value.Metadata.AudioFile = info.Name;
+            working.Value.Metadata.AudioFile = destination.Name;
 
             music.ReloadCurrentTrack();
 

From cca7633e590700a483d71ed27a3bd3debfb4891d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 15 Jun 2022 15:05:51 +0900
Subject: [PATCH 5439/5547] Rename variables and remove unnecessary nested call
 to `GetFullPath`

---
 osu.Game/Database/LegacyBeatmapImporter.cs | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Database/LegacyBeatmapImporter.cs b/osu.Game/Database/LegacyBeatmapImporter.cs
index 9ce267086d..3477312154 100644
--- a/osu.Game/Database/LegacyBeatmapImporter.cs
+++ b/osu.Game/Database/LegacyBeatmapImporter.cs
@@ -18,19 +18,19 @@ namespace osu.Game.Database
 
         protected override IEnumerable<string> GetStableImportPaths(Storage storage)
         {
-            foreach (string beatmapDirectory in storage.GetDirectories(string.Empty))
+            foreach (string directory in storage.GetDirectories(string.Empty))
             {
-                var beatmapStorage = storage.GetStorageForDirectory(beatmapDirectory);
+                var directoryStorage = storage.GetStorageForDirectory(directory);
 
-                if (!beatmapStorage.GetFiles(string.Empty).ExcludeSystemFileNames().Any())
+                if (!directoryStorage.GetFiles(string.Empty).ExcludeSystemFileNames().Any())
                 {
                     // if a directory doesn't contain files, attempt looking for beatmaps inside of that directory.
                     // this is a special behaviour in stable for beatmaps only, see https://github.com/ppy/osu/issues/18615.
-                    foreach (string beatmapInDirectory in GetStableImportPaths(beatmapStorage))
-                        yield return beatmapStorage.GetFullPath(beatmapInDirectory);
+                    foreach (string subDirectory in GetStableImportPaths(directoryStorage))
+                        yield return subDirectory;
                 }
                 else
-                    yield return storage.GetFullPath(beatmapDirectory);
+                    yield return storage.GetFullPath(directory);
             }
         }
 

From abe947bcb07ff67e974b67f580dac0dd07f28d2f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 15 Jun 2022 15:31:45 +0900
Subject: [PATCH 5440/5547] Update outdated xmldoc comments

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

diff --git a/osu.Game/Stores/RealmArchiveModelImporter.cs b/osu.Game/Stores/RealmArchiveModelImporter.cs
index c6231e5583..4bbd6b2264 100644
--- a/osu.Game/Stores/RealmArchiveModelImporter.cs
+++ b/osu.Game/Stores/RealmArchiveModelImporter.cs
@@ -173,7 +173,7 @@ namespace osu.Game.Stores
         /// Note that this bypasses the UI flow and should only be used for special cases or testing.
         /// </summary>
         /// <param name="task">The <see cref="ImportTask"/> containing data about the <typeparamref name="TModel"/> to import.</param>
-        /// <param name="batchImport">Whether this is a low priority import.</param>
+        /// <param name="batchImport">Whether this import is part of a larger batch.</param>
         /// <param name="cancellationToken">An optional cancellation token.</param>
         /// <returns>The imported model, if successful.</returns>
         public async Task<Live<TModel>?> Import(ImportTask task, bool batchImport = false, CancellationToken cancellationToken = default)
@@ -205,7 +205,7 @@ namespace osu.Game.Stores
         /// Silently import an item from an <see cref="ArchiveReader"/>.
         /// </summary>
         /// <param name="archive">The archive to be imported.</param>
-        /// <param name="batchImport">Whether this is a low priority import.</param>
+        /// <param name="batchImport">Whether this import is part of a larger batch.</param>
         /// <param name="cancellationToken">An optional cancellation token.</param>
         public async Task<Live<TModel>?> Import(ArchiveReader archive, bool batchImport = false, CancellationToken cancellationToken = default)
         {

From 5201057a626f5f5fa6eeff0105df50621e1d03df Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 15 Jun 2022 15:31:58 +0900
Subject: [PATCH 5441/5547] Change batch import to require at least 10 items

---
 osu.Game/Stores/RealmArchiveModelImporter.cs | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Stores/RealmArchiveModelImporter.cs b/osu.Game/Stores/RealmArchiveModelImporter.cs
index 4bbd6b2264..7f31bc66be 100644
--- a/osu.Game/Stores/RealmArchiveModelImporter.cs
+++ b/osu.Game/Stores/RealmArchiveModelImporter.cs
@@ -32,8 +32,17 @@ namespace osu.Game.Stores
     public abstract class RealmArchiveModelImporter<TModel> : IModelImporter<TModel>
         where TModel : RealmObject, IHasRealmFiles, IHasGuidPrimaryKey, ISoftDelete
     {
+        /// <summary>
+        /// The maximum number of concurrent imports to run per import scheduler.
+        /// </summary>
         private const int import_queue_request_concurrency = 1;
 
+        /// <summary>
+        /// The minimum number of items in a single import call in order for the import to be processed as a batch.
+        /// Batch imports will apply optimisations preferring speed over consistency when detecting changes in already-imported items.
+        /// </summary>
+        private const int minimum_items_considered_batch_import = 10;
+
         /// <summary>
         /// A singleton scheduler shared by all <see cref="RealmArchiveModelImporter{TModel}"/>.
         /// </summary>
@@ -100,7 +109,7 @@ namespace osu.Game.Stores
 
             var imported = new List<Live<TModel>>();
 
-            bool isBatchImport = tasks.Length > 1;
+            bool isBatchImport = tasks.Length >= minimum_items_considered_batch_import;
 
             try
             {

From 930ec2a19775cc43719dc648a1568f3b6b742df7 Mon Sep 17 00:00:00 2001
From: Jamie Taylor <me@nekodex.net>
Date: Wed, 15 Jun 2022 12:33:21 +0900
Subject: [PATCH 5442/5547] Add specific samples for dialog 'Ok' and 'Cancel'
 buttons

---
 osu.Game/Graphics/UserInterface/HoverSampleSet.cs   | 8 +++++++-
 osu.Game/Overlays/Dialog/PopupDialogButton.cs       | 3 ++-
 osu.Game/Overlays/Dialog/PopupDialogCancelButton.cs | 6 ++++++
 osu.Game/Overlays/Dialog/PopupDialogOkButton.cs     | 6 ++++++
 4 files changed, 21 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Graphics/UserInterface/HoverSampleSet.cs b/osu.Game/Graphics/UserInterface/HoverSampleSet.cs
index b88f81a143..0bf44321dd 100644
--- a/osu.Game/Graphics/UserInterface/HoverSampleSet.cs
+++ b/osu.Game/Graphics/UserInterface/HoverSampleSet.cs
@@ -20,6 +20,12 @@ namespace osu.Game.Graphics.UserInterface
         TabSelect,
 
         [Description("scrolltotop")]
-        ScrollToTop
+        ScrollToTop,
+
+        [Description("dialog-cancel")]
+        DialogCancel,
+
+        [Description("dialog-ok")]
+        DialogOk
     }
 }
diff --git a/osu.Game/Overlays/Dialog/PopupDialogButton.cs b/osu.Game/Overlays/Dialog/PopupDialogButton.cs
index 76ee438d6d..9ee1018651 100644
--- a/osu.Game/Overlays/Dialog/PopupDialogButton.cs
+++ b/osu.Game/Overlays/Dialog/PopupDialogButton.cs
@@ -8,7 +8,8 @@ namespace osu.Game.Overlays.Dialog
 {
     public class PopupDialogButton : DialogButton
     {
-        public PopupDialogButton()
+        public PopupDialogButton(HoverSampleSet sampleSet = HoverSampleSet.Button)
+            : base(sampleSet)
         {
             Height = 50;
             BackgroundColour = Color4Extensions.FromHex(@"150e14");
diff --git a/osu.Game/Overlays/Dialog/PopupDialogCancelButton.cs b/osu.Game/Overlays/Dialog/PopupDialogCancelButton.cs
index 754003c1c1..186099ce23 100644
--- a/osu.Game/Overlays/Dialog/PopupDialogCancelButton.cs
+++ b/osu.Game/Overlays/Dialog/PopupDialogCancelButton.cs
@@ -3,6 +3,7 @@
 
 using osu.Framework.Allocation;
 using osu.Game.Graphics;
+using osu.Game.Graphics.UserInterface;
 
 namespace osu.Game.Overlays.Dialog
 {
@@ -13,5 +14,10 @@ namespace osu.Game.Overlays.Dialog
         {
             ButtonColour = colours.Blue;
         }
+
+        public PopupDialogCancelButton()
+            : base(HoverSampleSet.DialogCancel)
+        {
+        }
     }
 }
diff --git a/osu.Game/Overlays/Dialog/PopupDialogOkButton.cs b/osu.Game/Overlays/Dialog/PopupDialogOkButton.cs
index 6c2bf6f1e6..1ac8dd0db6 100644
--- a/osu.Game/Overlays/Dialog/PopupDialogOkButton.cs
+++ b/osu.Game/Overlays/Dialog/PopupDialogOkButton.cs
@@ -3,6 +3,7 @@
 
 using osu.Framework.Allocation;
 using osu.Game.Graphics;
+using osu.Game.Graphics.UserInterface;
 
 namespace osu.Game.Overlays.Dialog
 {
@@ -13,5 +14,10 @@ namespace osu.Game.Overlays.Dialog
         {
             ButtonColour = colours.Pink;
         }
+
+        public PopupDialogOkButton()
+            : base(HoverSampleSet.DialogOk)
+        {
+        }
     }
 }

From af87722be8024c8c93a6cc29792af150ff18a48d Mon Sep 17 00:00:00 2001
From: Jamie Taylor <me@nekodex.net>
Date: Wed, 15 Jun 2022 12:43:21 +0900
Subject: [PATCH 5443/5547] Add audio feedback for 'Dangerous' dialog buttons

---
 .../Dialog/PopupDialogDangerousButton.cs      | 63 +++++++++++++++++++
 1 file changed, 63 insertions(+)

diff --git a/osu.Game/Overlays/Dialog/PopupDialogDangerousButton.cs b/osu.Game/Overlays/Dialog/PopupDialogDangerousButton.cs
index 6239c5e409..9db2589147 100644
--- a/osu.Game/Overlays/Dialog/PopupDialogDangerousButton.cs
+++ b/osu.Game/Overlays/Dialog/PopupDialogDangerousButton.cs
@@ -2,9 +2,13 @@
 // 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.Graphics;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Input.Events;
+using osu.Framework.Utils;
+using osu.Game.Audio.Effects;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
 
@@ -47,8 +51,39 @@ namespace osu.Game.Overlays.Dialog
             {
             }
 
+            private Sample tickSample;
+            private Sample confirmSample;
+            private bool isTicking;
+            private double lastTickPlaybackTime;
+            private AudioFilter lowPassFilter = null!;
+
+            [BackgroundDependencyLoader]
+            private void load(AudioManager audio)
+            {
+                lowPassFilter = new AudioFilter(audio.SampleMixer);
+                tickSample = audio.Samples.Get(@"UI/dialog-dangerous-tick");
+                confirmSample = audio.Samples.Get(@"UI/dialog-dangerous-select");
+            }
+
+            protected override void Update()
+            {
+                base.Update();
+
+                if (!isTicking) return;
+
+                if (Precision.AlmostEquals(Progress.Value, 1))
+                {
+                    confirmSample?.Play();
+                    isTicking = false;
+                }
+
+                if (Clock.CurrentTime - lastTickPlaybackTime >= 30)
+                    playTick(Progress.Value);
+            }
+
             protected override bool OnMouseDown(MouseDownEvent e)
             {
+                startTickSound();
                 BeginConfirm();
                 return true;
             }
@@ -56,7 +91,35 @@ namespace osu.Game.Overlays.Dialog
             protected override void OnMouseUp(MouseUpEvent e)
             {
                 if (!e.HasAnyButtonPressed)
+                {
+                    stopTickSound();
                     AbortConfirm();
+                }
+            }
+
+            private void playTick(double progress)
+            {
+                lowPassFilter.CutoffTo((int)(Progress.Value * AudioFilter.MAX_LOWPASS_CUTOFF * 0.5f));
+
+                tickSample.Frequency.Value = 1 + progress * 0.5f;
+                tickSample.Volume.Value = 0.5f + progress / 2f;
+                tickSample.Play();
+
+                lastTickPlaybackTime = Clock.CurrentTime;
+            }
+
+            private void startTickSound()
+            {
+                lowPassFilter.CutoffTo(0);
+                playTick(Progress.Value);
+                isTicking = true;
+            }
+
+            private void stopTickSound()
+            {
+                isTicking = false;
+                lastTickPlaybackTime = Clock.CurrentTime;
+                lowPassFilter.CutoffTo(AudioFilter.MAX_LOWPASS_CUTOFF);
             }
         }
     }

From 6b744a14b0b7be3c0a0a36764359707cc5f80dab Mon Sep 17 00:00:00 2001
From: Jamie Taylor <me@nekodex.net>
Date: Wed, 15 Jun 2022 13:04:08 +0900
Subject: [PATCH 5444/5547] Move 'back' sample playback from OnResuming to
 OnExiting

---
 osu.Game/Screens/Menu/MainMenu.cs     | 2 ++
 osu.Game/Screens/OsuScreen.cs         | 8 ++++----
 osu.Game/Screens/Play/PlayerLoader.cs | 2 +-
 3 files changed, 7 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Screens/Menu/MainMenu.cs b/osu.Game/Screens/Menu/MainMenu.cs
index 6fc8039413..bcd4baa818 100644
--- a/osu.Game/Screens/Menu/MainMenu.cs
+++ b/osu.Game/Screens/Menu/MainMenu.cs
@@ -66,6 +66,8 @@ namespace osu.Game.Screens.Menu
 
         protected override BackgroundScreen CreateBackground() => background;
 
+        protected override bool PlayExitSound => false;
+
         private Bindable<double> holdDelay;
         private Bindable<bool> loginDisplayed;
 
diff --git a/osu.Game/Screens/OsuScreen.cs b/osu.Game/Screens/OsuScreen.cs
index 77db1285bd..e742a2821f 100644
--- a/osu.Game/Screens/OsuScreen.cs
+++ b/osu.Game/Screens/OsuScreen.cs
@@ -77,7 +77,7 @@ namespace osu.Game.Screens
 
         private Sample sampleExit;
 
-        protected virtual bool PlayResumeSound => true;
+        protected virtual bool PlayExitSound => true;
 
         public virtual float BackgroundParallaxAmount => 1;
 
@@ -173,9 +173,6 @@ namespace osu.Game.Screens
 
         public override void OnResuming(ScreenTransitionEvent e)
         {
-            if (PlayResumeSound)
-                sampleExit?.Play();
-
             applyArrivingDefaults(true);
 
             // it's feasible to resume to a screen if the target screen never loaded successfully.
@@ -215,6 +212,9 @@ namespace osu.Game.Screens
 
         public override bool OnExiting(ScreenExitEvent e)
         {
+            if (PlayExitSound)
+                sampleExit?.Play();
+
             if (ValidForResume && logo != null)
                 onExitingLogo();
 
diff --git a/osu.Game/Screens/Play/PlayerLoader.cs b/osu.Game/Screens/Play/PlayerLoader.cs
index d75466764d..b7b3c6fde1 100644
--- a/osu.Game/Screens/Play/PlayerLoader.cs
+++ b/osu.Game/Screens/Play/PlayerLoader.cs
@@ -51,7 +51,7 @@ namespace osu.Game.Screens.Play
         // We show the previous screen status
         protected override UserActivity? InitialActivity => null;
 
-        protected override bool PlayResumeSound => false;
+        protected override bool PlayExitSound => false;
 
         protected BeatmapMetadataDisplay MetadataInfo { get; private set; } = null!;
 

From 5e3ccf7087d3a7ca4c6562eeb1728c98439341d0 Mon Sep 17 00:00:00 2001
From: Jamie Taylor <me@nekodex.net>
Date: Wed, 15 Jun 2022 13:04:17 +0900
Subject: [PATCH 5445/5547] Don't play 'back' sample when exiting Editor

---
 osu.Game/Screens/Edit/Editor.cs       | 2 ++
 osu.Game/Screens/Edit/EditorLoader.cs | 2 ++
 2 files changed, 4 insertions(+)

diff --git a/osu.Game/Screens/Edit/Editor.cs b/osu.Game/Screens/Edit/Editor.cs
index e4a18b8478..2c13fe79b6 100644
--- a/osu.Game/Screens/Edit/Editor.cs
+++ b/osu.Game/Screens/Edit/Editor.cs
@@ -63,6 +63,8 @@ namespace osu.Game.Screens.Edit
 
         public override bool? AllowTrackAdjustments => false;
 
+        protected override bool PlayExitSound => false;
+
         protected bool HasUnsavedChanges
         {
             get
diff --git a/osu.Game/Screens/Edit/EditorLoader.cs b/osu.Game/Screens/Edit/EditorLoader.cs
index 0a2b8437fa..94eb6d5e70 100644
--- a/osu.Game/Screens/Edit/EditorLoader.cs
+++ b/osu.Game/Screens/Edit/EditorLoader.cs
@@ -40,6 +40,8 @@ namespace osu.Game.Screens.Edit
 
         public override bool DisallowExternalBeatmapRulesetChanges => true;
 
+        protected override bool PlayExitSound => false;
+
         [Resolved]
         private BeatmapManager beatmapManager { get; set; }
 

From 5eb56ab814a465e0ef52daaeb40b59a626bc4dae Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 15 Jun 2022 15:41:38 +0900
Subject: [PATCH 5446/5547] Ensure `Master` volume is updated when scrolling on
 toolbar button

---
 osu.Game/Overlays/Toolbar/ToolbarMusicButton.cs | 1 +
 osu.Game/Overlays/VolumeOverlay.cs              | 7 ++++++-
 2 files changed, 7 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/Toolbar/ToolbarMusicButton.cs b/osu.Game/Overlays/Toolbar/ToolbarMusicButton.cs
index 34dc3b4080..0c948990a0 100644
--- a/osu.Game/Overlays/Toolbar/ToolbarMusicButton.cs
+++ b/osu.Game/Overlays/Toolbar/ToolbarMusicButton.cs
@@ -77,6 +77,7 @@ namespace osu.Game.Overlays.Toolbar
 
         protected override bool OnScroll(ScrollEvent e)
         {
+            volume?.FocusMasterVolume();
             volume?.Adjust(GlobalAction.IncreaseVolume, e.ScrollDelta.Y, e.IsPrecise);
             return true;
         }
diff --git a/osu.Game/Overlays/VolumeOverlay.cs b/osu.Game/Overlays/VolumeOverlay.cs
index 9d2ed3f837..46ea45491e 100644
--- a/osu.Game/Overlays/VolumeOverlay.cs
+++ b/osu.Game/Overlays/VolumeOverlay.cs
@@ -140,11 +140,16 @@ namespace osu.Game.Overlays
 
         private ScheduledDelegate popOutDelegate;
 
+        public void FocusMasterVolume()
+        {
+            volumeMeters.Select(volumeMeterMaster);
+        }
+
         public override void Show()
         {
             // Focus on the master meter as a default if previously hidden
             if (State.Value == Visibility.Hidden)
-                volumeMeters.Select(volumeMeterMaster);
+                FocusMasterVolume();
 
             if (State.Value == Visibility.Visible)
                 schedulePopOut();

From 6a8cf514e0f18291d6d136db3f565dadf31740d1 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 15 Jun 2022 09:52:12 +0300
Subject: [PATCH 5447/5547] Update background/track file chooser to not display
 filename

---
 .../UserInterfaceV2/LabelledComponent.cs      |  2 +-
 ...elledTextBox.cs => LabelledFileChooser.cs} | 15 +++++---
 .../Screens/Edit/Setup/ResourcesSection.cs    | 37 ++++++++++++-------
 3 files changed, 35 insertions(+), 19 deletions(-)
 rename osu.Game/Screens/Edit/Setup/{FileChooserLabelledTextBox.cs => LabelledFileChooser.cs} (86%)

diff --git a/osu.Game/Graphics/UserInterfaceV2/LabelledComponent.cs b/osu.Game/Graphics/UserInterfaceV2/LabelledComponent.cs
index dd6a902989..77267e453c 100644
--- a/osu.Game/Graphics/UserInterfaceV2/LabelledComponent.cs
+++ b/osu.Game/Graphics/UserInterfaceV2/LabelledComponent.cs
@@ -15,7 +15,7 @@ namespace osu.Game.Graphics.UserInterfaceV2
         {
         }
 
-        public Bindable<TValue> Current
+        public virtual Bindable<TValue> Current
         {
             get => Component.Current;
             set => Component.Current = value;
diff --git a/osu.Game/Screens/Edit/Setup/FileChooserLabelledTextBox.cs b/osu.Game/Screens/Edit/Setup/LabelledFileChooser.cs
similarity index 86%
rename from osu.Game/Screens/Edit/Setup/FileChooserLabelledTextBox.cs
rename to osu.Game/Screens/Edit/Setup/LabelledFileChooser.cs
index fd916894ea..745c989b3b 100644
--- a/osu.Game/Screens/Edit/Setup/FileChooserLabelledTextBox.cs
+++ b/osu.Game/Screens/Edit/Setup/LabelledFileChooser.cs
@@ -21,10 +21,7 @@ using osuTK;
 
 namespace osu.Game.Screens.Edit.Setup
 {
-    /// <summary>
-    /// A labelled textbox which reveals an inline file chooser when clicked.
-    /// </summary>
-    internal class FileChooserLabelledTextBox : LabelledTextBoxWithPopover, ICanAcceptFiles
+    internal class LabelledFileChooser : LabelledTextBoxWithPopover, ICanAcceptFiles
     {
         private readonly string[] handledExtensions;
 
@@ -35,7 +32,15 @@ namespace osu.Game.Screens.Edit.Setup
         [Resolved]
         private OsuGameBase game { get; set; } = null!;
 
-        public FileChooserLabelledTextBox(params string[] handledExtensions)
+        private readonly BindableWithCurrent<string> current = new BindableWithCurrent<string>();
+
+        public override Bindable<string> Current
+        {
+            get => current.Current;
+            set => current.Current = value;
+        }
+
+        public LabelledFileChooser(params string[] handledExtensions)
         {
             this.handledExtensions = handledExtensions;
         }
diff --git a/osu.Game/Screens/Edit/Setup/ResourcesSection.cs b/osu.Game/Screens/Edit/Setup/ResourcesSection.cs
index 9d4e72d1f3..36edb5dd83 100644
--- a/osu.Game/Screens/Edit/Setup/ResourcesSection.cs
+++ b/osu.Game/Screens/Edit/Setup/ResourcesSection.cs
@@ -8,15 +8,14 @@ using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Localisation;
 using osu.Game.Beatmaps;
-using osu.Game.Graphics.UserInterfaceV2;
 using osu.Game.Overlays;
 
 namespace osu.Game.Screens.Edit.Setup
 {
     internal class ResourcesSection : SetupSection
     {
-        private LabelledTextBox audioTrackTextBox;
-        private LabelledTextBox backgroundTextBox;
+        private LabelledFileChooser audioTrackChooser;
+        private LabelledFileChooser backgroundChooser;
 
         public override LocalisableString Title => "Resources";
 
@@ -40,26 +39,24 @@ namespace osu.Game.Screens.Edit.Setup
         {
             Children = new Drawable[]
             {
-                backgroundTextBox = new FileChooserLabelledTextBox(".jpg", ".jpeg", ".png")
+                backgroundChooser = new LabelledFileChooser(".jpg", ".jpeg", ".png")
                 {
                     Label = "Background",
                     FixedLabelWidth = LABEL_WIDTH,
-                    PlaceholderText = "Click to select a background image",
                     Current = { Value = working.Value.Metadata.BackgroundFile },
                     TabbableContentContainer = this
                 },
-                audioTrackTextBox = new FileChooserLabelledTextBox(".mp3", ".ogg")
+                audioTrackChooser = new LabelledFileChooser(".mp3", ".ogg")
                 {
                     Label = "Audio Track",
                     FixedLabelWidth = LABEL_WIDTH,
-                    PlaceholderText = "Click to select a track",
                     Current = { Value = working.Value.Metadata.AudioFile },
                     TabbableContentContainer = this
                 },
             };
 
-            backgroundTextBox.Current.BindValueChanged(backgroundChanged);
-            audioTrackTextBox.Current.BindValueChanged(audioTrackChanged);
+            backgroundChooser.Current.BindValueChanged(backgroundChanged, true);
+            audioTrackChooser.Current.BindValueChanged(audioTrackChanged, true);
         }
 
         public bool ChangeBackgroundImage(string path)
@@ -124,14 +121,28 @@ namespace osu.Game.Screens.Edit.Setup
 
         private void backgroundChanged(ValueChangedEvent<string> filePath)
         {
-            if (!ChangeBackgroundImage(filePath.NewValue))
-                backgroundTextBox.Current.Value = filePath.OldValue;
+            backgroundChooser.PlaceholderText = string.IsNullOrEmpty(filePath.NewValue)
+                ? "Click to select a background image"
+                : "Click to replace the background image";
+
+            if (filePath.NewValue != filePath.OldValue)
+            {
+                if (!ChangeBackgroundImage(filePath.NewValue))
+                    backgroundChooser.Current.Value = filePath.OldValue;
+            }
         }
 
         private void audioTrackChanged(ValueChangedEvent<string> filePath)
         {
-            if (!ChangeAudioTrack(filePath.NewValue))
-                audioTrackTextBox.Current.Value = filePath.OldValue;
+            audioTrackChooser.PlaceholderText = string.IsNullOrEmpty(filePath.NewValue)
+                ? "Click to select a track"
+                : "Click to replace the track";
+
+            if (filePath.NewValue != filePath.OldValue)
+            {
+                if (!ChangeAudioTrack(filePath.NewValue))
+                    audioTrackChooser.Current.Value = filePath.OldValue;
+            }
         }
     }
 }

From 3df9d7c9e1b37d386b43f739eb8f8383122d2d2a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 15 Jun 2022 15:56:59 +0900
Subject: [PATCH 5448/5547] Add a bit more animation when adjusting

---
 .../Overlays/Toolbar/ToolbarMusicButton.cs    | 34 +++++++++++++++++--
 1 file changed, 31 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Overlays/Toolbar/ToolbarMusicButton.cs b/osu.Game/Overlays/Toolbar/ToolbarMusicButton.cs
index 0c948990a0..689b750826 100644
--- a/osu.Game/Overlays/Toolbar/ToolbarMusicButton.cs
+++ b/osu.Game/Overlays/Toolbar/ToolbarMusicButton.cs
@@ -8,7 +8,9 @@ using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
+using osu.Framework.Graphics.Transforms;
 using osu.Framework.Input.Events;
+using osu.Framework.Threading;
 using osu.Game.Input.Bindings;
 using osuTK.Graphics;
 
@@ -32,7 +34,7 @@ namespace osu.Game.Overlays.Toolbar
             StateContainer = music;
 
             Flow.Padding = new MarginPadding { Horizontal = Toolbar.HEIGHT / 4 };
-            Flow.Add(new Container
+            Flow.Add(volumeDisplay = new Container
             {
                 Anchor = Anchor.CentreLeft,
                 Origin = Anchor.CentreLeft,
@@ -66,20 +68,46 @@ namespace osu.Game.Overlays.Toolbar
         private VolumeOverlay volume { get; set; }
 
         private IBindable<double> globalVolume;
+        private Container volumeDisplay;
 
         protected override void LoadComplete()
         {
             base.LoadComplete();
 
             globalVolume = audio.Volume.GetBoundCopy();
-            globalVolume.BindValueChanged(v => volumeBar.Height = (float)v.NewValue, true);
+            globalVolume.BindValueChanged(v => volumeBar.ResizeHeightTo((float)v.NewValue, 200, Easing.OutQuint), true);
         }
 
         protected override bool OnScroll(ScrollEvent e)
         {
-            volume?.FocusMasterVolume();
+            focusForAdjustment();
             volume?.Adjust(GlobalAction.IncreaseVolume, e.ScrollDelta.Y, e.IsPrecise);
             return true;
         }
+
+        private void focusForAdjustment()
+        {
+            volume?.FocusMasterVolume();
+            expandVolumeBarTemporarily();
+        }
+
+        private TransformSequence<Container> expandTransform;
+        private ScheduledDelegate contractTransform;
+
+        private void expandVolumeBarTemporarily()
+        {
+            // avoid starting a new transform if one is already active.
+            if (expandTransform == null)
+            {
+                expandTransform = volumeDisplay.ResizeWidthTo(6, 500, Easing.OutQuint);
+                expandTransform.Finally(_ => expandTransform = null);
+            }
+
+            contractTransform?.Cancel();
+            contractTransform = Scheduler.AddDelayed(() =>
+            {
+                volumeDisplay.ResizeWidthTo(3f, 500, Easing.OutQuint);
+            }, 1000);
+        }
     }
 }

From 873806c2ea4112d4ef7510d37933340b7921a1b1 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 15 Jun 2022 15:57:09 +0900
Subject: [PATCH 5449/5547] Add keyboard adjustment support

---
 .../Visual/Menus/TestSceneToolbar.cs          | 15 ++++++++++++++-
 .../Overlays/Toolbar/ToolbarMusicButton.cs    | 19 +++++++++++++++++++
 2 files changed, 33 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/Menus/TestSceneToolbar.cs b/osu.Game.Tests/Visual/Menus/TestSceneToolbar.cs
index 09fae2fb77..f230e48b11 100644
--- a/osu.Game.Tests/Visual/Menus/TestSceneToolbar.cs
+++ b/osu.Game.Tests/Visual/Menus/TestSceneToolbar.cs
@@ -148,7 +148,7 @@ namespace osu.Game.Tests.Visual.Menus
         }
 
         [Test]
-        public void TestVolumeControlViaMusicButton()
+        public void TestVolumeControlViaMusicButtonScroll()
         {
             AddStep("hover toolbar music button", () => InputManager.MoveMouseTo(this.ChildrenOfType<ToolbarMusicButton>().Single()));
 
@@ -160,6 +160,19 @@ namespace osu.Game.Tests.Visual.Menus
             AddAssert("volume raised up", () => Audio.Volume.Value == 1);
         }
 
+        [Test]
+        public void TestVolumeControlViaMusicButtonArrowKeys()
+        {
+            AddStep("hover toolbar music button", () => InputManager.MoveMouseTo(this.ChildrenOfType<ToolbarMusicButton>().Single()));
+
+            AddStep("reset volume", () => Audio.Volume.Value = 1);
+
+            AddRepeatStep("arrow down", () => InputManager.Key(Key.Down), 5);
+            AddAssert("volume lowered down", () => Audio.Volume.Value < 1);
+            AddRepeatStep("arrow up", () => InputManager.Key(Key.Up), 5);
+            AddAssert("volume raised up", () => Audio.Volume.Value == 1);
+        }
+
         public class TestToolbar : Toolbar
         {
             public new Bindable<OverlayActivation> OverlayActivationMode => base.OverlayActivationMode as Bindable<OverlayActivation>;
diff --git a/osu.Game/Overlays/Toolbar/ToolbarMusicButton.cs b/osu.Game/Overlays/Toolbar/ToolbarMusicButton.cs
index 689b750826..2104fcbbfe 100644
--- a/osu.Game/Overlays/Toolbar/ToolbarMusicButton.cs
+++ b/osu.Game/Overlays/Toolbar/ToolbarMusicButton.cs
@@ -13,6 +13,7 @@ using osu.Framework.Input.Events;
 using osu.Framework.Threading;
 using osu.Game.Input.Bindings;
 using osuTK.Graphics;
+using osuTK.Input;
 
 namespace osu.Game.Overlays.Toolbar
 {
@@ -78,6 +79,24 @@ namespace osu.Game.Overlays.Toolbar
             globalVolume.BindValueChanged(v => volumeBar.ResizeHeightTo((float)v.NewValue, 200, Easing.OutQuint), true);
         }
 
+        protected override bool OnKeyDown(KeyDownEvent e)
+        {
+            switch (e.Key)
+            {
+                case Key.Up:
+                    focusForAdjustment();
+                    volume?.Adjust(GlobalAction.IncreaseVolume);
+                    return true;
+
+                case Key.Down:
+                    focusForAdjustment();
+                    volume?.Adjust(GlobalAction.IncreaseVolume, -1);
+                    return true;
+            }
+
+            return base.OnKeyDown(e);
+        }
+
         protected override bool OnScroll(ScrollEvent e)
         {
             focusForAdjustment();

From eac0ca4db6c4daca0e962802beca715735484549 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 15 Jun 2022 16:14:46 +0900
Subject: [PATCH 5450/5547] Update resources

---
 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 3b70df82c2..81f1a3e259 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -51,7 +51,7 @@
     <Reference Include="Java.Interop" />
   </ItemGroup>
   <ItemGroup>
-    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.527.0" />
+    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.615.0" />
     <PackageReference Include="ppy.osu.Framework.Android" Version="2022.611.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 19ec7ebcd0..f8ff29d58a 100644
--- a/osu.Game/osu.Game.csproj
+++ b/osu.Game/osu.Game.csproj
@@ -37,7 +37,7 @@
     </PackageReference>
     <PackageReference Include="Realm" Version="10.14.0" />
     <PackageReference Include="ppy.osu.Framework" Version="2022.611.0" />
-    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.527.0" />
+    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.615.0" />
     <PackageReference Include="Sentry" Version="3.17.1" />
     <PackageReference Include="SharpCompress" Version="0.31.0" />
     <PackageReference Include="NUnit" Version="3.13.3" />
diff --git a/osu.iOS.props b/osu.iOS.props
index c971612f62..929df0736b 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -62,7 +62,7 @@
   </ItemGroup>
   <ItemGroup Label="Package References">
     <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.611.0" />
-    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.527.0" />
+    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.615.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net6.0) -->
   <PropertyGroup>

From 583619b9151fad54c4abde8c915846fda62b0bd5 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 15 Jun 2022 10:21:27 +0300
Subject: [PATCH 5451/5547] Use `GlobalAction.DecreaseVolume` instead

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

diff --git a/osu.Game/Overlays/Toolbar/ToolbarMusicButton.cs b/osu.Game/Overlays/Toolbar/ToolbarMusicButton.cs
index 2104fcbbfe..d59127d61f 100644
--- a/osu.Game/Overlays/Toolbar/ToolbarMusicButton.cs
+++ b/osu.Game/Overlays/Toolbar/ToolbarMusicButton.cs
@@ -90,7 +90,7 @@ namespace osu.Game.Overlays.Toolbar
 
                 case Key.Down:
                     focusForAdjustment();
-                    volume?.Adjust(GlobalAction.IncreaseVolume, -1);
+                    volume?.Adjust(GlobalAction.DecreaseVolume);
                     return true;
             }
 

From 1f1633ddc2260fe6c71ce64e04d3509eb617c377 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 15 Jun 2022 16:50:23 +0900
Subject: [PATCH 5452/5547] Remove `Update` method processing of samples in
 `PopupDialogDangerousButton`

---
 .../Dialog/PopupDialogDangerousButton.cs      | 62 ++++++++-----------
 1 file changed, 26 insertions(+), 36 deletions(-)

diff --git a/osu.Game/Overlays/Dialog/PopupDialogDangerousButton.cs b/osu.Game/Overlays/Dialog/PopupDialogDangerousButton.cs
index 9db2589147..1cf8578852 100644
--- a/osu.Game/Overlays/Dialog/PopupDialogDangerousButton.cs
+++ b/osu.Game/Overlays/Dialog/PopupDialogDangerousButton.cs
@@ -4,10 +4,10 @@
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
 using osu.Framework.Audio.Sample;
+using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Input.Events;
-using osu.Framework.Utils;
 using osu.Game.Audio.Effects;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
@@ -53,37 +53,33 @@ namespace osu.Game.Overlays.Dialog
 
             private Sample tickSample;
             private Sample confirmSample;
-            private bool isTicking;
             private double lastTickPlaybackTime;
             private AudioFilter lowPassFilter = null!;
 
             [BackgroundDependencyLoader]
             private void load(AudioManager audio)
             {
-                lowPassFilter = new AudioFilter(audio.SampleMixer);
                 tickSample = audio.Samples.Get(@"UI/dialog-dangerous-tick");
                 confirmSample = audio.Samples.Get(@"UI/dialog-dangerous-select");
+
+                AddInternal(lowPassFilter = new AudioFilter(audio.SampleMixer));
             }
 
-            protected override void Update()
+            protected override void LoadComplete()
             {
-                base.Update();
+                base.LoadComplete();
+                Progress.BindValueChanged(progressChanged);
+            }
 
-                if (!isTicking) return;
-
-                if (Precision.AlmostEquals(Progress.Value, 1))
-                {
-                    confirmSample?.Play();
-                    isTicking = false;
-                }
-
-                if (Clock.CurrentTime - lastTickPlaybackTime >= 30)
-                    playTick(Progress.Value);
+            protected override void Confirm()
+            {
+                lowPassFilter.CutoffTo(AudioFilter.MAX_LOWPASS_CUTOFF);
+                confirmSample?.Play();
+                base.Confirm();
             }
 
             protected override bool OnMouseDown(MouseDownEvent e)
             {
-                startTickSound();
                 BeginConfirm();
                 return true;
             }
@@ -92,34 +88,28 @@ namespace osu.Game.Overlays.Dialog
             {
                 if (!e.HasAnyButtonPressed)
                 {
-                    stopTickSound();
                     AbortConfirm();
                 }
             }
 
-            private void playTick(double progress)
+            private void progressChanged(ValueChangedEvent<double> progress)
             {
-                lowPassFilter.CutoffTo((int)(Progress.Value * AudioFilter.MAX_LOWPASS_CUTOFF * 0.5f));
+                if (progress.NewValue < progress.OldValue)
+                {
+                    lowPassFilter.CutoffTo(AudioFilter.MAX_LOWPASS_CUTOFF);
+                    return;
+                }
 
-                tickSample.Frequency.Value = 1 + progress * 0.5f;
-                tickSample.Volume.Value = 0.5f + progress / 2f;
-                tickSample.Play();
+                if (Clock.CurrentTime - lastTickPlaybackTime >= 30)
+                {
+                    lowPassFilter.CutoffTo((int)(progress.NewValue * AudioFilter.MAX_LOWPASS_CUTOFF * 0.5));
 
-                lastTickPlaybackTime = Clock.CurrentTime;
-            }
+                    tickSample.Frequency.Value = 1 + progress.NewValue * 0.5f;
+                    tickSample.Volume.Value = 0.5f + progress.NewValue / 2f;
+                    tickSample.Play();
 
-            private void startTickSound()
-            {
-                lowPassFilter.CutoffTo(0);
-                playTick(Progress.Value);
-                isTicking = true;
-            }
-
-            private void stopTickSound()
-            {
-                isTicking = false;
-                lastTickPlaybackTime = Clock.CurrentTime;
-                lowPassFilter.CutoffTo(AudioFilter.MAX_LOWPASS_CUTOFF);
+                    lastTickPlaybackTime = Clock.CurrentTime;
+                }
             }
         }
     }

From accd6031bdf041bcee12ffdf7265d3c01616f872 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 15 Jun 2022 16:53:56 +0900
Subject: [PATCH 5453/5547] Update framework

---
 osu.Android.props        | 2 +-
 osu.Game/osu.Game.csproj | 2 +-
 osu.iOS.props            | 4 ++--
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Android.props b/osu.Android.props
index 3b70df82c2..4d9f86cc64 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -52,7 +52,7 @@
   </ItemGroup>
   <ItemGroup>
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.527.0" />
-    <PackageReference Include="ppy.osu.Framework.Android" Version="2022.611.0" />
+    <PackageReference Include="ppy.osu.Framework.Android" Version="2022.615.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
     <!-- Realm needs to be directly referenced in all Xamarin projects, as it will not pull in its transitive dependencies otherwise. -->
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 19ec7ebcd0..51950c0bdc 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="10.14.0" />
-    <PackageReference Include="ppy.osu.Framework" Version="2022.611.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2022.615.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.527.0" />
     <PackageReference Include="Sentry" Version="3.17.1" />
     <PackageReference Include="SharpCompress" Version="0.31.0" />
diff --git a/osu.iOS.props b/osu.iOS.props
index c971612f62..a009885458 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -61,7 +61,7 @@
     <Reference Include="System.Net.Http" />
   </ItemGroup>
   <ItemGroup Label="Package References">
-    <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.611.0" />
+    <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.615.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2022.527.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net6.0) -->
@@ -84,7 +84,7 @@
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="5.0.14" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.Core" Version="5.0.14" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
-    <PackageReference Include="ppy.osu.Framework" Version="2022.611.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2022.615.0" />
     <PackageReference Include="SharpCompress" Version="0.31.0" />
     <PackageReference Include="NUnit" Version="3.13.3" />
     <PackageReference Include="System.ComponentModel.Annotations" Version="5.0.0" />

From 94aa2248cae85c8843fa7f7fe2887c8d2513d0fa Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 15 Jun 2022 17:31:45 +0900
Subject: [PATCH 5454/5547] Move filter reset to more appropriate location

---
 .../Dialog/PopupDialogDangerousButton.cs      | 22 ++++++++-----------
 1 file changed, 9 insertions(+), 13 deletions(-)

diff --git a/osu.Game/Overlays/Dialog/PopupDialogDangerousButton.cs b/osu.Game/Overlays/Dialog/PopupDialogDangerousButton.cs
index 1cf8578852..90ac2d8a08 100644
--- a/osu.Game/Overlays/Dialog/PopupDialogDangerousButton.cs
+++ b/osu.Game/Overlays/Dialog/PopupDialogDangerousButton.cs
@@ -88,28 +88,24 @@ namespace osu.Game.Overlays.Dialog
             {
                 if (!e.HasAnyButtonPressed)
                 {
+                    lowPassFilter.CutoffTo(AudioFilter.MAX_LOWPASS_CUTOFF);
                     AbortConfirm();
                 }
             }
 
             private void progressChanged(ValueChangedEvent<double> progress)
             {
-                if (progress.NewValue < progress.OldValue)
-                {
-                    lowPassFilter.CutoffTo(AudioFilter.MAX_LOWPASS_CUTOFF);
-                    return;
-                }
+                if (progress.NewValue < progress.OldValue) return;
 
-                if (Clock.CurrentTime - lastTickPlaybackTime >= 30)
-                {
-                    lowPassFilter.CutoffTo((int)(progress.NewValue * AudioFilter.MAX_LOWPASS_CUTOFF * 0.5));
+                if (Clock.CurrentTime - lastTickPlaybackTime < 30) return;
 
-                    tickSample.Frequency.Value = 1 + progress.NewValue * 0.5f;
-                    tickSample.Volume.Value = 0.5f + progress.NewValue / 2f;
-                    tickSample.Play();
+                lowPassFilter.CutoffTo((int)(progress.NewValue * AudioFilter.MAX_LOWPASS_CUTOFF * 0.5));
 
-                    lastTickPlaybackTime = Clock.CurrentTime;
-                }
+                tickSample.Frequency.Value = 1 + progress.NewValue * 0.5f;
+                tickSample.Volume.Value = 0.5f + progress.NewValue / 2f;
+                tickSample.Play();
+
+                lastTickPlaybackTime = Clock.CurrentTime;
             }
         }
     }

From b3aa4fcf02b6b289ea7979135369a0bfdb459791 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 15 Jun 2022 17:33:05 +0900
Subject: [PATCH 5455/5547] Adjust a channel rather than the overall sample

---
 osu.Game/Overlays/Dialog/PopupDialogDangerousButton.cs | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Overlays/Dialog/PopupDialogDangerousButton.cs b/osu.Game/Overlays/Dialog/PopupDialogDangerousButton.cs
index 90ac2d8a08..d145a1c7da 100644
--- a/osu.Game/Overlays/Dialog/PopupDialogDangerousButton.cs
+++ b/osu.Game/Overlays/Dialog/PopupDialogDangerousButton.cs
@@ -101,9 +101,12 @@ namespace osu.Game.Overlays.Dialog
 
                 lowPassFilter.CutoffTo((int)(progress.NewValue * AudioFilter.MAX_LOWPASS_CUTOFF * 0.5));
 
-                tickSample.Frequency.Value = 1 + progress.NewValue * 0.5f;
-                tickSample.Volume.Value = 0.5f + progress.NewValue / 2f;
-                tickSample.Play();
+                var channel = tickSample.GetChannel();
+
+                channel.Frequency.Value = 1 + progress.NewValue * 0.5f;
+                channel.Volume.Value = 0.5f + progress.NewValue / 2f;
+
+                channel.Play();
 
                 lastTickPlaybackTime = Clock.CurrentTime;
             }

From 6136e4e27aeb09a69bce778b85362813867d7f05 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 15 Jun 2022 17:37:14 +0900
Subject: [PATCH 5456/5547] Don't play exit sound if screen is in a
 non-resumable state when exiting

---
 osu.Game/Screens/Edit/EditorLoader.cs | 2 --
 osu.Game/Screens/OsuScreen.cs         | 2 +-
 osu.Game/Screens/Play/PlayerLoader.cs | 2 --
 3 files changed, 1 insertion(+), 5 deletions(-)

diff --git a/osu.Game/Screens/Edit/EditorLoader.cs b/osu.Game/Screens/Edit/EditorLoader.cs
index 94eb6d5e70..0a2b8437fa 100644
--- a/osu.Game/Screens/Edit/EditorLoader.cs
+++ b/osu.Game/Screens/Edit/EditorLoader.cs
@@ -40,8 +40,6 @@ namespace osu.Game.Screens.Edit
 
         public override bool DisallowExternalBeatmapRulesetChanges => true;
 
-        protected override bool PlayExitSound => false;
-
         [Resolved]
         private BeatmapManager beatmapManager { get; set; }
 
diff --git a/osu.Game/Screens/OsuScreen.cs b/osu.Game/Screens/OsuScreen.cs
index e742a2821f..810aadffad 100644
--- a/osu.Game/Screens/OsuScreen.cs
+++ b/osu.Game/Screens/OsuScreen.cs
@@ -212,7 +212,7 @@ namespace osu.Game.Screens
 
         public override bool OnExiting(ScreenExitEvent e)
         {
-            if (PlayExitSound)
+            if (ValidForResume && PlayExitSound)
                 sampleExit?.Play();
 
             if (ValidForResume && logo != null)
diff --git a/osu.Game/Screens/Play/PlayerLoader.cs b/osu.Game/Screens/Play/PlayerLoader.cs
index b7b3c6fde1..f3b22c3355 100644
--- a/osu.Game/Screens/Play/PlayerLoader.cs
+++ b/osu.Game/Screens/Play/PlayerLoader.cs
@@ -51,8 +51,6 @@ namespace osu.Game.Screens.Play
         // We show the previous screen status
         protected override UserActivity? InitialActivity => null;
 
-        protected override bool PlayExitSound => false;
-
         protected BeatmapMetadataDisplay MetadataInfo { get; private set; } = null!;
 
         /// <summary>

From 7ac5019c0828e78062521afba451bbb2c2f5b8a0 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 15 Jun 2022 17:37:30 +0900
Subject: [PATCH 5457/5547] Fix intro screens playing exit sounds

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

diff --git a/osu.Game/Screens/Menu/IntroScreen.cs b/osu.Game/Screens/Menu/IntroScreen.cs
index d4072d6202..c9b9bb344d 100644
--- a/osu.Game/Screens/Menu/IntroScreen.cs
+++ b/osu.Game/Screens/Menu/IntroScreen.cs
@@ -63,6 +63,8 @@ namespace osu.Game.Screens.Menu
 
         protected virtual string SeeyaSampleName => "Intro/seeya";
 
+        protected override bool PlayExitSound => false;
+
         private LeasedBindable<WorkingBeatmap> beatmap;
 
         private OsuScreen nextScreen;

From fd4529aa7c504cf2f820ee75c99bef219189f41f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 15 Jun 2022 17:37:54 +0900
Subject: [PATCH 5458/5547] Play editor exit sound if no confirmation buttons
 were shown during exit process

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

diff --git a/osu.Game/Screens/Edit/Editor.cs b/osu.Game/Screens/Edit/Editor.cs
index 2c13fe79b6..4e35f3c34e 100644
--- a/osu.Game/Screens/Edit/Editor.cs
+++ b/osu.Game/Screens/Edit/Editor.cs
@@ -63,7 +63,7 @@ namespace osu.Game.Screens.Edit
 
         public override bool? AllowTrackAdjustments => false;
 
-        protected override bool PlayExitSound => false;
+        protected override bool PlayExitSound => !HasUnsavedChanges;
 
         protected bool HasUnsavedChanges
         {

From 713cff3403d31c628965915262dd7b0a664858b7 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 15 Jun 2022 17:49:09 +0900
Subject: [PATCH 5459/5547] Don't play editor exit sound when changing
 difficulties

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

diff --git a/osu.Game/Screens/Edit/Editor.cs b/osu.Game/Screens/Edit/Editor.cs
index 4e35f3c34e..6c30413d8c 100644
--- a/osu.Game/Screens/Edit/Editor.cs
+++ b/osu.Game/Screens/Edit/Editor.cs
@@ -63,7 +63,9 @@ namespace osu.Game.Screens.Edit
 
         public override bool? AllowTrackAdjustments => false;
 
-        protected override bool PlayExitSound => !HasUnsavedChanges;
+        protected override bool PlayExitSound => !HasUnsavedChanges && !isChangingDifficulties;
+
+        private bool isChangingDifficulties;
 
         protected bool HasUnsavedChanges
         {
@@ -859,7 +861,10 @@ namespace osu.Game.Screens.Edit
         }
 
         private void switchToNewDifficulty(RulesetInfo rulesetInfo, bool createCopy)
-            => loader?.ScheduleSwitchToNewDifficulty(editorBeatmap.BeatmapInfo, rulesetInfo, createCopy, GetState(rulesetInfo));
+        {
+            isChangingDifficulties = true;
+            loader?.ScheduleSwitchToNewDifficulty(editorBeatmap.BeatmapInfo, rulesetInfo, createCopy, GetState(rulesetInfo));
+        }
 
         private EditorMenuItem createDifficultySwitchMenu()
         {

From be2b4e68b9e90fb42cc27032015b4885da10293e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 15 Jun 2022 17:49:18 +0900
Subject: [PATCH 5460/5547] Don't play player exit sound when restarting

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

diff --git a/osu.Game/Screens/Play/Player.cs b/osu.Game/Screens/Play/Player.cs
index d6f6a06eb7..33a20ff190 100644
--- a/osu.Game/Screens/Play/Player.cs
+++ b/osu.Game/Screens/Play/Player.cs
@@ -53,6 +53,8 @@ namespace osu.Game.Screens.Play
 
         public override bool AllowBackButton => false; // handled by HoldForMenuButton
 
+        protected override bool PlayExitSound => !isRestarting;
+
         protected override UserActivity InitialActivity => new UserActivity.InSoloGame(Beatmap.Value.BeatmapInfo, Ruleset.Value);
 
         public override float BackgroundParallaxAmount => 0.1f;
@@ -75,6 +77,8 @@ namespace osu.Game.Screens.Play
 
         public Action RestartRequested;
 
+        private bool isRestarting;
+
         private Bindable<bool> mouseWheelDisabled;
 
         private readonly Bindable<bool> storyboardReplacesBackground = new Bindable<bool>();
@@ -643,6 +647,8 @@ namespace osu.Game.Screens.Play
             if (!Configuration.AllowRestart)
                 return;
 
+            isRestarting = true;
+
             // at the point of restarting the track should either already be paused or the volume should be zero.
             // stopping here is to ensure music doesn't become audible after exiting back to PlayerLoader.
             musicController.Stop();

From c27e5d1216e7be5f9c149b58e0ff9e42a5206aa4 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 15 Jun 2022 18:44:02 +0900
Subject: [PATCH 5461/5547] Fix editor still playing back sound when exiting
 with confirmation

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

diff --git a/osu.Game/Screens/Edit/Editor.cs b/osu.Game/Screens/Edit/Editor.cs
index 6c30413d8c..1fbc1b4bd6 100644
--- a/osu.Game/Screens/Edit/Editor.cs
+++ b/osu.Game/Screens/Edit/Editor.cs
@@ -63,9 +63,7 @@ namespace osu.Game.Screens.Edit
 
         public override bool? AllowTrackAdjustments => false;
 
-        protected override bool PlayExitSound => !HasUnsavedChanges && !isChangingDifficulties;
-
-        private bool isChangingDifficulties;
+        protected override bool PlayExitSound => !ExitConfirmed && !switchingDifficulty;
 
         protected bool HasUnsavedChanges
         {
@@ -103,6 +101,8 @@ namespace osu.Game.Screens.Edit
 
         protected bool ExitConfirmed { get; private set; }
 
+        private bool switchingDifficulty;
+
         private string lastSavedHash;
 
         private Container<EditorScreen> screenContainer;
@@ -862,7 +862,7 @@ namespace osu.Game.Screens.Edit
 
         private void switchToNewDifficulty(RulesetInfo rulesetInfo, bool createCopy)
         {
-            isChangingDifficulties = true;
+            switchingDifficulty = true;
             loader?.ScheduleSwitchToNewDifficulty(editorBeatmap.BeatmapInfo, rulesetInfo, createCopy, GetState(rulesetInfo));
         }
 

From 1520ccf865a4b019be3191231ee526a29b7882ae Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 15 Jun 2022 18:44:16 +0900
Subject: [PATCH 5462/5547] Fix double back sound due to sub screen presence in
 multiplayer/playlists

---
 osu.Game/Screens/OnlinePlay/Lounge/LoungeSubScreen.cs | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/osu.Game/Screens/OnlinePlay/Lounge/LoungeSubScreen.cs b/osu.Game/Screens/OnlinePlay/Lounge/LoungeSubScreen.cs
index f2429c1944..b1c10f4a4a 100644
--- a/osu.Game/Screens/OnlinePlay/Lounge/LoungeSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Lounge/LoungeSubScreen.cs
@@ -37,6 +37,8 @@ namespace osu.Game.Screens.OnlinePlay.Lounge
     {
         public override string Title => "Lounge";
 
+        protected override bool PlayExitSound => false;
+
         protected override BackgroundScreen CreateBackground() => new LoungeBackgroundScreen
         {
             SelectedRoom = { BindTarget = SelectedRoom }

From d89c80ace2df4bdb7e26e5543d692e0ffc053261 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 15 Jun 2022 18:44:15 +0900
Subject: [PATCH 5463/5547] Block operations during beatmap selection in match

---
 .../Multiplayer/MultiplayerMatchSongSelect.cs | 43 +++++++++++++------
 1 file changed, 31 insertions(+), 12 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs
index 929c3ee321..b2355a9021 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs
@@ -1,6 +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 enable
+
+using System;
 using System.Linq;
 using System.Threading.Tasks;
 using osu.Framework.Allocation;
@@ -18,11 +21,15 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
     public class MultiplayerMatchSongSelect : OnlinePlaySongSelect
     {
         [Resolved]
-        private MultiplayerClient client { get; set; }
+        private MultiplayerClient client { get; set; } = null!;
+
+        [Resolved]
+        private OngoingOperationTracker operationTracker { get; set; } = null!;
 
         private readonly long? itemToEdit;
 
-        private LoadingLayer loadingLayer;
+        private LoadingLayer loadingLayer = null!;
+        private IDisposable? selectionOperation;
 
         /// <summary>
         /// Construct a new instance of multiplayer song select.
@@ -31,7 +38,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
         /// <param name="itemToEdit">The item to be edited. May be null, in which case a new item will be added to the playlist.</param>
         /// <param name="beatmap">An optional initial beatmap selection to perform.</param>
         /// <param name="ruleset">An optional initial ruleset selection to perform.</param>
-        public MultiplayerMatchSongSelect(Room room, long? itemToEdit = null, WorkingBeatmap beatmap = null, RulesetInfo ruleset = null)
+        public MultiplayerMatchSongSelect(Room room, long? itemToEdit = null, WorkingBeatmap? beatmap = null, RulesetInfo? ruleset = null)
             : base(room)
         {
             this.itemToEdit = itemToEdit;
@@ -58,6 +65,8 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
             // Otherwise, update the playlist directly in preparation for it to be submitted to the API on match creation.
             if (client.Room != null)
             {
+                selectionOperation = operationTracker.BeginOperation();
+
                 loadingLayer.Show();
 
                 var multiplayerItem = new MultiplayerPlaylistItem
@@ -72,18 +81,28 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
 
                 Task task = itemToEdit != null ? client.EditPlaylistItem(multiplayerItem) : client.AddPlaylistItem(multiplayerItem);
 
-                task.FireAndForget(onSuccess: () => Schedule(() =>
+                task.FireAndForget(onSuccess: () =>
                 {
-                    loadingLayer.Hide();
+                    selectionOperation.Dispose();
 
-                    // If an error or server side trigger occurred this screen may have already exited by external means.
-                    if (this.IsCurrentScreen())
-                        this.Exit();
-                }), onError: _ => Schedule(() =>
+                    Schedule(() =>
+                    {
+                        loadingLayer.Hide();
+
+                        // If an error or server side trigger occurred this screen may have already exited by external means.
+                        if (this.IsCurrentScreen())
+                            this.Exit();
+                    });
+                }, onError: _ =>
                 {
-                    loadingLayer.Hide();
-                    Carousel.AllowSelection = true;
-                }));
+                    selectionOperation.Dispose();
+
+                    Schedule(() =>
+                    {
+                        loadingLayer.Hide();
+                        Carousel.AllowSelection = true;
+                    });
+                });
             }
             else
             {

From 7a2919975a93bac1279abfc62f3ff61293f1207c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 15 Jun 2022 18:48:22 +0900
Subject: [PATCH 5464/5547] Fix sound clash when exiting a multiplayer room
 with confirmation

---
 .../Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
index 769873f74c..dc78cb10ef 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
@@ -41,6 +41,8 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
 
         public override string ShortTitle => "room";
 
+        protected override bool PlayExitSound => !exitConfirmed;
+
         [Resolved]
         private MultiplayerClient client { get; set; }
 

From 9edc4fc181ccf0e4c8e9d276a5adf989f7474b16 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 15 Jun 2022 17:11:11 +0900
Subject: [PATCH 5465/5547] Remove unnecessary `ShouldDeleteArchive` override
 (already done in base implementation)

---
 osu.Game/Beatmaps/BeatmapModelManager.cs | 2 --
 1 file changed, 2 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapModelManager.cs b/osu.Game/Beatmaps/BeatmapModelManager.cs
index 277047348e..c7600bf64c 100644
--- a/osu.Game/Beatmaps/BeatmapModelManager.cs
+++ b/osu.Game/Beatmaps/BeatmapModelManager.cs
@@ -41,8 +41,6 @@ namespace osu.Game.Beatmaps
         {
         }
 
-        protected override bool ShouldDeleteArchive(string path) => Path.GetExtension(path)?.ToLowerInvariant() == ".osz";
-
         /// <summary>
         /// Saves an <see cref="IBeatmap"/> file against a given <see cref="BeatmapInfo"/>.
         /// </summary>

From 23d7667f39929ee41234510ffdd521f9623b5f60 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 15 Jun 2022 17:12:01 +0900
Subject: [PATCH 5466/5547] Move `BeatmapImporter` to correct namespace

---
 osu.Game/{Stores => Beatmaps}/BeatmapImporter.cs | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)
 rename osu.Game/{Stores => Beatmaps}/BeatmapImporter.cs (99%)

diff --git a/osu.Game/Stores/BeatmapImporter.cs b/osu.Game/Beatmaps/BeatmapImporter.cs
similarity index 99%
rename from osu.Game/Stores/BeatmapImporter.cs
rename to osu.Game/Beatmaps/BeatmapImporter.cs
index 3d89dfeca9..4a50e8da98 100644
--- a/osu.Game/Stores/BeatmapImporter.cs
+++ b/osu.Game/Beatmaps/BeatmapImporter.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.
 
+#nullable enable
+
 using System;
 using System.Collections.Generic;
 using System.IO;
@@ -13,7 +15,6 @@ using osu.Framework.Graphics.Textures;
 using osu.Framework.Logging;
 using osu.Framework.Platform;
 using osu.Framework.Testing;
-using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.Formats;
 using osu.Game.Database;
 using osu.Game.Extensions;
@@ -23,11 +24,10 @@ using osu.Game.Models;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Objects;
 using osu.Game.Skinning;
+using osu.Game.Stores;
 using Realms;
 
-#nullable enable
-
-namespace osu.Game.Stores
+namespace osu.Game.Beatmaps
 {
     /// <summary>
     /// Handles the storage and retrieval of Beatmaps/WorkingBeatmaps.

From f23ddfe6ccf7a966773848a61c659aca83454f5b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 15 Jun 2022 17:13:32 +0900
Subject: [PATCH 5467/5547] Move remaining realm classes out of `Stores`
 namespace

---
 osu.Game.Tests/Database/BeatmapImporterTests.cs            | 1 -
 osu.Game.Tests/Database/FileStoreTests.cs                  | 6 +++---
 osu.Game/Beatmaps/BeatmapImporter.cs                       | 1 -
 osu.Game/Beatmaps/BeatmapManager.cs                        | 1 -
 osu.Game/Beatmaps/BeatmapModelManager.cs                   | 1 -
 osu.Game/Beatmaps/BeatmapOnlineLookupQueue.cs              | 1 -
 osu.Game/Database/ImportTask.cs                            | 1 -
 osu.Game/Database/RealmAccess.cs                           | 1 -
 osu.Game/{Stores => Database}/RealmArchiveModelImporter.cs | 7 +++----
 osu.Game/{Stores => Database}/RealmArchiveModelManager.cs  | 7 +++----
 osu.Game/{Stores => Database}/RealmFileStore.cs            | 7 +++----
 osu.Game/Scoring/ScoreModelManager.cs                      | 1 -
 osu.Game/Skinning/SkinModelManager.cs                      | 1 -
 osu.Game/Storyboards/Drawables/DrawableStoryboard.cs       | 1 -
 14 files changed, 12 insertions(+), 25 deletions(-)
 rename osu.Game/{Stores => Database}/RealmArchiveModelImporter.cs (99%)
 rename osu.Game/{Stores => Database}/RealmArchiveModelManager.cs (99%)
 rename osu.Game/{Stores => Database}/RealmFileStore.cs (98%)

diff --git a/osu.Game.Tests/Database/BeatmapImporterTests.cs b/osu.Game.Tests/Database/BeatmapImporterTests.cs
index de2bbeb791..a057f893f4 100644
--- a/osu.Game.Tests/Database/BeatmapImporterTests.cs
+++ b/osu.Game.Tests/Database/BeatmapImporterTests.cs
@@ -21,7 +21,6 @@ using osu.Game.IO.Archives;
 using osu.Game.Models;
 using osu.Game.Overlays.Notifications;
 using osu.Game.Rulesets;
-using osu.Game.Stores;
 using osu.Game.Tests.Resources;
 using Realms;
 using SharpCompress.Archives;
diff --git a/osu.Game.Tests/Database/FileStoreTests.cs b/osu.Game.Tests/Database/FileStoreTests.cs
index 98b0ed99b5..13af05bbbb 100644
--- a/osu.Game.Tests/Database/FileStoreTests.cs
+++ b/osu.Game.Tests/Database/FileStoreTests.cs
@@ -1,16 +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.
 
+#nullable enable
+
 using System.Diagnostics;
 using System.IO;
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Logging;
+using osu.Game.Database;
 using osu.Game.Extensions;
 using osu.Game.Models;
-using osu.Game.Stores;
-
-#nullable enable
 
 namespace osu.Game.Tests.Database
 {
diff --git a/osu.Game/Beatmaps/BeatmapImporter.cs b/osu.Game/Beatmaps/BeatmapImporter.cs
index 4a50e8da98..a2ab70fed8 100644
--- a/osu.Game/Beatmaps/BeatmapImporter.cs
+++ b/osu.Game/Beatmaps/BeatmapImporter.cs
@@ -24,7 +24,6 @@ using osu.Game.Models;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Objects;
 using osu.Game.Skinning;
-using osu.Game.Stores;
 using Realms;
 
 namespace osu.Game.Beatmaps
diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index e156c2b430..9397c2f3b2 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -21,7 +21,6 @@ using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays.Notifications;
 using osu.Game.Rulesets;
 using osu.Game.Skinning;
-using osu.Game.Stores;
 using osu.Game.Utils;
 
 #nullable enable
diff --git a/osu.Game/Beatmaps/BeatmapModelManager.cs b/osu.Game/Beatmaps/BeatmapModelManager.cs
index c7600bf64c..055eb36850 100644
--- a/osu.Game/Beatmaps/BeatmapModelManager.cs
+++ b/osu.Game/Beatmaps/BeatmapModelManager.cs
@@ -15,7 +15,6 @@ using osu.Game.Beatmaps.Formats;
 using osu.Game.Database;
 using osu.Game.Extensions;
 using osu.Game.Skinning;
-using osu.Game.Stores;
 using osu.Game.Overlays.Notifications;
 
 #nullable enable
diff --git a/osu.Game/Beatmaps/BeatmapOnlineLookupQueue.cs b/osu.Game/Beatmaps/BeatmapOnlineLookupQueue.cs
index fc39887e79..44fa8092fb 100644
--- a/osu.Game/Beatmaps/BeatmapOnlineLookupQueue.cs
+++ b/osu.Game/Beatmaps/BeatmapOnlineLookupQueue.cs
@@ -17,7 +17,6 @@ using osu.Framework.Threading;
 using osu.Game.Database;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests;
-using osu.Game.Stores;
 using SharpCompress.Compressors;
 using SharpCompress.Compressors.BZip2;
 
diff --git a/osu.Game/Database/ImportTask.cs b/osu.Game/Database/ImportTask.cs
index d75c1a73e6..41ce0339a1 100644
--- a/osu.Game/Database/ImportTask.cs
+++ b/osu.Game/Database/ImportTask.cs
@@ -6,7 +6,6 @@
 using System.IO;
 using osu.Framework.Extensions;
 using osu.Game.IO.Archives;
-using osu.Game.Stores;
 using osu.Game.Utils;
 using SharpCompress.Common;
 
diff --git a/osu.Game/Database/RealmAccess.cs b/osu.Game/Database/RealmAccess.cs
index 086ec52d80..de7e3020c6 100644
--- a/osu.Game/Database/RealmAccess.cs
+++ b/osu.Game/Database/RealmAccess.cs
@@ -28,7 +28,6 @@ using osu.Game.Models;
 using osu.Game.Rulesets;
 using osu.Game.Scoring;
 using osu.Game.Skinning;
-using osu.Game.Stores;
 using Realms;
 using Realms.Exceptions;
 
diff --git a/osu.Game/Stores/RealmArchiveModelImporter.cs b/osu.Game/Database/RealmArchiveModelImporter.cs
similarity index 99%
rename from osu.Game/Stores/RealmArchiveModelImporter.cs
rename to osu.Game/Database/RealmArchiveModelImporter.cs
index 7f31bc66be..4153f421ef 100644
--- a/osu.Game/Stores/RealmArchiveModelImporter.cs
+++ b/osu.Game/Database/RealmArchiveModelImporter.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.
 
+#nullable enable
+
 using System;
 using System.Collections.Generic;
 using System.IO;
@@ -13,16 +15,13 @@ using osu.Framework.Extensions.IEnumerableExtensions;
 using osu.Framework.Logging;
 using osu.Framework.Platform;
 using osu.Framework.Threading;
-using osu.Game.Database;
 using osu.Game.Extensions;
 using osu.Game.IO.Archives;
 using osu.Game.Models;
 using osu.Game.Overlays.Notifications;
 using Realms;
 
-#nullable enable
-
-namespace osu.Game.Stores
+namespace osu.Game.Database
 {
     /// <summary>
     /// Encapsulates a model store class to give it import functionality.
diff --git a/osu.Game/Stores/RealmArchiveModelManager.cs b/osu.Game/Database/RealmArchiveModelManager.cs
similarity index 99%
rename from osu.Game/Stores/RealmArchiveModelManager.cs
rename to osu.Game/Database/RealmArchiveModelManager.cs
index cc8229b436..371b9be575 100644
--- a/osu.Game/Stores/RealmArchiveModelManager.cs
+++ b/osu.Game/Database/RealmArchiveModelManager.cs
@@ -1,20 +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.
 
+#nullable enable
+
 using System;
 using System.Collections.Generic;
 using System.IO;
 using System.Linq;
 using osu.Framework.Platform;
-using osu.Game.Database;
 using osu.Game.Extensions;
 using osu.Game.Models;
 using osu.Game.Overlays.Notifications;
 using Realms;
 
-#nullable enable
-
-namespace osu.Game.Stores
+namespace osu.Game.Database
 {
     /// <summary>
     /// Class which adds all the missing pieces bridging the gap between <see cref="RealmArchiveModelImporter{TModel}"/> and (legacy) ArchiveModelManager.
diff --git a/osu.Game/Stores/RealmFileStore.cs b/osu.Game/Database/RealmFileStore.cs
similarity index 98%
rename from osu.Game/Stores/RealmFileStore.cs
rename to osu.Game/Database/RealmFileStore.cs
index 457d70f29a..94f04ff0f3 100644
--- a/osu.Game/Stores/RealmFileStore.cs
+++ b/osu.Game/Database/RealmFileStore.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.
 
+#nullable enable
+
 using System;
 using System.IO;
 using System.Linq;
@@ -9,14 +11,11 @@ using osu.Framework.IO.Stores;
 using osu.Framework.Logging;
 using osu.Framework.Platform;
 using osu.Framework.Testing;
-using osu.Game.Database;
 using osu.Game.Extensions;
 using osu.Game.Models;
 using Realms;
 
-#nullable enable
-
-namespace osu.Game.Stores
+namespace osu.Game.Database
 {
     /// <summary>
     /// Handles the storing of files to the file system (and database) backing.
diff --git a/osu.Game/Scoring/ScoreModelManager.cs b/osu.Game/Scoring/ScoreModelManager.cs
index 59102360f9..c88955c5fd 100644
--- a/osu.Game/Scoring/ScoreModelManager.cs
+++ b/osu.Game/Scoring/ScoreModelManager.cs
@@ -13,7 +13,6 @@ using osu.Game.Database;
 using osu.Game.IO.Archives;
 using osu.Game.Rulesets;
 using osu.Game.Scoring.Legacy;
-using osu.Game.Stores;
 using Realms;
 
 #nullable enable
diff --git a/osu.Game/Skinning/SkinModelManager.cs b/osu.Game/Skinning/SkinModelManager.cs
index 0a18449800..ca90f41080 100644
--- a/osu.Game/Skinning/SkinModelManager.cs
+++ b/osu.Game/Skinning/SkinModelManager.cs
@@ -14,7 +14,6 @@ using osu.Game.Database;
 using osu.Game.Extensions;
 using osu.Game.IO;
 using osu.Game.IO.Archives;
-using osu.Game.Stores;
 using Realms;
 
 #nullable enable
diff --git a/osu.Game/Storyboards/Drawables/DrawableStoryboard.cs b/osu.Game/Storyboards/Drawables/DrawableStoryboard.cs
index a0fb7b0b4a..0a5d51f62e 100644
--- a/osu.Game/Storyboards/Drawables/DrawableStoryboard.cs
+++ b/osu.Game/Storyboards/Drawables/DrawableStoryboard.cs
@@ -15,7 +15,6 @@ using osu.Framework.Platform;
 using osu.Game.Database;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Screens.Play;
-using osu.Game.Stores;
 
 namespace osu.Game.Storyboards.Drawables
 {

From 1ff070f5ff3722ee464c1196f987f678b725aa21 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 15 Jun 2022 17:45:31 +0300
Subject: [PATCH 5468/5547] Decouple `LabelledFileChooser` from
 `LabelledTextBoxWithPopover`

---
 .../Screens/Edit/Setup/LabelledFileChooser.cs | 33 +++++++++++++++++--
 .../Screens/Edit/Setup/ResourcesSection.cs    |  4 +--
 2 files changed, 32 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Screens/Edit/Setup/LabelledFileChooser.cs b/osu.Game/Screens/Edit/Setup/LabelledFileChooser.cs
index 745c989b3b..2cb3af61c8 100644
--- a/osu.Game/Screens/Edit/Setup/LabelledFileChooser.cs
+++ b/osu.Game/Screens/Edit/Setup/LabelledFileChooser.cs
@@ -14,14 +14,20 @@ using osu.Framework.Extensions;
 using osu.Framework.Extensions.ObjectExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.Cursor;
 using osu.Framework.Graphics.UserInterface;
+using osu.Framework.Localisation;
 using osu.Game.Database;
 using osu.Game.Graphics.UserInterfaceV2;
 using osuTK;
 
 namespace osu.Game.Screens.Edit.Setup
 {
-    internal class LabelledFileChooser : LabelledTextBoxWithPopover, ICanAcceptFiles
+    /// <summary>
+    /// A labelled drawable displaying file chooser on click, with placeholder text support.
+    /// todo: this should probably not use PopoverTextBox just to display placeholder text, but is the best way for now.
+    /// </summary>
+    internal class LabelledFileChooser : LabelledDrawable<LabelledTextBoxWithPopover.PopoverTextBox>, IHasCurrentValue<string>, ICanAcceptFiles, IHasPopover
     {
         private readonly string[] handledExtensions;
 
@@ -34,13 +40,25 @@ namespace osu.Game.Screens.Edit.Setup
 
         private readonly BindableWithCurrent<string> current = new BindableWithCurrent<string>();
 
-        public override Bindable<string> Current
+        public Bindable<string> Current
         {
             get => current.Current;
             set => current.Current = value;
         }
 
+        public LocalisableString Text
+        {
+            get => Component.PlaceholderText;
+            set => Component.PlaceholderText = value;
+        }
+
+        public CompositeDrawable TabbableContentContainer
+        {
+            set => Component.TabbableContentContainer = value;
+        }
+
         public LabelledFileChooser(params string[] handledExtensions)
+            : base(false)
         {
             this.handledExtensions = handledExtensions;
         }
@@ -78,7 +96,16 @@ namespace osu.Game.Screens.Edit.Setup
                 game.UnregisterImportHandler(this);
         }
 
-        public override Popover GetPopover() => new FileChooserPopover(handledExtensions, currentFile);
+        protected override LabelledTextBoxWithPopover.PopoverTextBox CreateComponent() => new LabelledTextBoxWithPopover.PopoverTextBox
+        {
+            Anchor = Anchor.Centre,
+            Origin = Anchor.Centre,
+            RelativeSizeAxes = Axes.X,
+            CornerRadius = CORNER_RADIUS,
+            OnFocused = this.ShowPopover,
+        };
+
+        public Popover GetPopover() => new FileChooserPopover(handledExtensions, currentFile);
 
         private class FileChooserPopover : OsuPopover
         {
diff --git a/osu.Game/Screens/Edit/Setup/ResourcesSection.cs b/osu.Game/Screens/Edit/Setup/ResourcesSection.cs
index 36edb5dd83..b4e350b94b 100644
--- a/osu.Game/Screens/Edit/Setup/ResourcesSection.cs
+++ b/osu.Game/Screens/Edit/Setup/ResourcesSection.cs
@@ -121,7 +121,7 @@ namespace osu.Game.Screens.Edit.Setup
 
         private void backgroundChanged(ValueChangedEvent<string> filePath)
         {
-            backgroundChooser.PlaceholderText = string.IsNullOrEmpty(filePath.NewValue)
+            backgroundChooser.Text = string.IsNullOrEmpty(filePath.NewValue)
                 ? "Click to select a background image"
                 : "Click to replace the background image";
 
@@ -134,7 +134,7 @@ namespace osu.Game.Screens.Edit.Setup
 
         private void audioTrackChanged(ValueChangedEvent<string> filePath)
         {
-            audioTrackChooser.PlaceholderText = string.IsNullOrEmpty(filePath.NewValue)
+            audioTrackChooser.Text = string.IsNullOrEmpty(filePath.NewValue)
                 ? "Click to select a track"
                 : "Click to replace the track";
 

From 026bad7fc49bdbd116910514c1c9836eaba30d13 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 15 Jun 2022 18:11:28 +0300
Subject: [PATCH 5469/5547] Use notification processing mode logic instead

---
 osu.Game/Overlays/NotificationOverlay.cs | 12 ++++++++----
 1 file changed, 8 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Overlays/NotificationOverlay.cs b/osu.Game/Overlays/NotificationOverlay.cs
index e4ee2fe049..b772dffa73 100644
--- a/osu.Game/Overlays/NotificationOverlay.cs
+++ b/osu.Game/Overlays/NotificationOverlay.cs
@@ -38,6 +38,8 @@ namespace osu.Game.Overlays
         [Resolved(canBeNull: true)]
         private FirstRunSetupOverlay firstRunSetup { get; set; }
 
+        private IBindable<Visibility> firstRunSetupState;
+
         [BackgroundDependencyLoader]
         private void load()
         {
@@ -84,7 +86,7 @@ namespace osu.Game.Overlays
 
         private void updateProcessingMode()
         {
-            bool enabled = OverlayActivationMode.Value == OverlayActivation.All || State.Value == Visibility.Visible;
+            bool enabled = (OverlayActivationMode.Value == OverlayActivation.All && firstRunSetupState?.Value != Visibility.Visible) || State.Value == Visibility.Visible;
 
             notificationsEnabler?.Cancel();
 
@@ -100,6 +102,10 @@ namespace osu.Game.Overlays
             base.LoadComplete();
 
             State.ValueChanged += _ => updateProcessingMode();
+
+            firstRunSetupState = firstRunSetup.State.GetBoundCopy();
+            firstRunSetupState.ValueChanged += _ => updateProcessingMode();
+
             OverlayActivationMode.BindValueChanged(_ => updateProcessingMode(), true);
         }
 
@@ -133,9 +139,7 @@ namespace osu.Game.Overlays
             var section = sections.Children.FirstOrDefault(s => s.AcceptTypes.Any(accept => accept.IsAssignableFrom(ourType)));
             section?.Add(notification, notification.DisplayOnTop ? -runningDepth : runningDepth);
 
-            // we don't want important notifications interrupting user on first-run setup.
-            // (this can happen when importing beatmaps inside setup, which posts import notifications)
-            if (notification.IsImportant && firstRunSetup?.State.Value != Visibility.Visible)
+            if (notification.IsImportant)
                 Show();
 
             updateCounts();

From 387c54c25219aea13c8473880823b51e5201ff1f Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 15 Jun 2022 18:11:46 +0300
Subject: [PATCH 5470/5547] Ensure notification is displayed after first-run
 setup is hidden

---
 .../Visual/Navigation/TestSceneFirstRunGame.cs         | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneFirstRunGame.cs b/osu.Game.Tests/Visual/Navigation/TestSceneFirstRunGame.cs
index 37d7faf1fb..18c6e84950 100644
--- a/osu.Game.Tests/Visual/Navigation/TestSceneFirstRunGame.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneFirstRunGame.cs
@@ -24,7 +24,17 @@ namespace osu.Game.Tests.Visual.Navigation
         public void TestImportantNotificationDoesntInterruptSetup()
         {
             AddStep("post important notification", () => Game.Notifications.Post(new SimpleNotification { Text = "Important notification" }));
+            AddAssert("no notification posted", () => Game.Notifications.UnreadCount.Value == 0);
             AddAssert("first-run setup still visible", () => Game.FirstRunOverlay.State.Value == Visibility.Visible);
+
+            AddUntilStep("finish first-run setup", () =>
+            {
+                Game.FirstRunOverlay.NextButton.TriggerClick();
+                return Game.FirstRunOverlay.State.Value == Visibility.Hidden;
+            });
+            AddWaitStep("wait for post delay", 5);
+            AddAssert("notifications shown", () => Game.Notifications.State.Value == Visibility.Visible);
+            AddAssert("notification posted", () => Game.Notifications.UnreadCount.Value == 1);
         }
 
         protected override TestOsuGame CreateTestGame() => new FirstRunGame(LocalStorage, API);

From 0418d70056c3211ff20b48293bf3e04de64fdafa Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 15 Jun 2022 16:38:02 +0200
Subject: [PATCH 5471/5547] Add test coverage for ignoring null mods returned
 by rulesets

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

diff --git a/osu.Game.Tests/Rulesets/TestSceneBrokenRulesetHandling.cs b/osu.Game.Tests/Rulesets/TestSceneBrokenRulesetHandling.cs
new file mode 100644
index 0000000000..9d27abf0b4
--- /dev/null
+++ b/osu.Game.Tests/Rulesets/TestSceneBrokenRulesetHandling.cs
@@ -0,0 +1,49 @@
+// 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 enable
+
+using System.Collections.Generic;
+using System.Linq;
+using NUnit.Framework;
+using osu.Framework.Allocation;
+using osu.Framework.Testing;
+using osu.Game.Beatmaps;
+using osu.Game.Rulesets;
+using osu.Game.Rulesets.Difficulty;
+using osu.Game.Rulesets.Mods;
+using osu.Game.Rulesets.UI;
+using osu.Game.Tests.Visual;
+
+namespace osu.Game.Tests.Rulesets
+{
+    [HeadlessTest]
+    public class TestSceneBrokenRulesetHandling : OsuTestScene
+    {
+        [Resolved]
+        private OsuGameBase gameBase { get; set; } = null!;
+
+        [Test]
+        public void TestNullModsReturnedByRulesetAreIgnored()
+        {
+            AddStep("set ruleset with null mods", () => Ruleset.Value = new TestRulesetWithNullMods().RulesetInfo);
+            AddAssert("no null mods in available mods", () => gameBase.AvailableMods.Value.SelectMany(kvp => kvp.Value).All(mod => mod != null));
+        }
+
+#nullable disable // purposefully disabling nullability to simulate broken or unannotated API user code.
+
+        private class TestRulesetWithNullMods : Ruleset
+        {
+            public override string ShortName => "nullmods";
+            public override string Description => "nullmods";
+
+            public override IEnumerable<Mod> GetModsFor(ModType type) => new Mod[] { null };
+
+            public override DrawableRuleset CreateDrawableRulesetWith(IBeatmap beatmap, IReadOnlyList<Mod> mods = null) => null;
+            public override IBeatmapConverter CreateBeatmapConverter(IBeatmap beatmap) => null;
+            public override DifficultyCalculator CreateDifficultyCalculator(IWorkingBeatmap beatmap) => null;
+        }
+
+#nullable enable
+    }
+}

From 6e5e506fb46adca7971089acb75e7a1d446b130e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 15 Jun 2022 16:18:56 +0200
Subject: [PATCH 5472/5547] Add protection against rulesets returning null mods

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

diff --git a/osu.Game/OsuGameBase.cs b/osu.Game/OsuGameBase.cs
index 5dbdf6f602..e6f1452c3f 100644
--- a/osu.Game/OsuGameBase.cs
+++ b/osu.Game/OsuGameBase.cs
@@ -519,7 +519,9 @@ namespace osu.Game
 
             foreach (ModType type in Enum.GetValues(typeof(ModType)))
             {
-                dict[type] = instance.GetModsFor(type).ToList();
+                dict[type] = instance.GetModsFor(type)
+                                     .Where(mod => mod != null)
+                                     .ToList();
             }
 
             if (!SelectedMods.Disabled)

From 665ef5fdcc06c9d8bcdb8bfb705b1ebee8e61047 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 15 Jun 2022 17:16:17 +0200
Subject: [PATCH 5473/5547] Add test coverage for API-incompatible rulesets wrt
 mods

---
 .../TestSceneBrokenRulesetHandling.cs         | 32 +++++++++++++++++++
 1 file changed, 32 insertions(+)

diff --git a/osu.Game.Tests/Rulesets/TestSceneBrokenRulesetHandling.cs b/osu.Game.Tests/Rulesets/TestSceneBrokenRulesetHandling.cs
index 9d27abf0b4..243a93b4e5 100644
--- a/osu.Game.Tests/Rulesets/TestSceneBrokenRulesetHandling.cs
+++ b/osu.Game.Tests/Rulesets/TestSceneBrokenRulesetHandling.cs
@@ -3,6 +3,7 @@
 
 #nullable enable
 
+using System;
 using System.Collections.Generic;
 using System.Linq;
 using NUnit.Framework;
@@ -12,6 +13,7 @@ using osu.Game.Beatmaps;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Difficulty;
 using osu.Game.Rulesets.Mods;
+using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.UI;
 using osu.Game.Tests.Visual;
 
@@ -23,6 +25,12 @@ namespace osu.Game.Tests.Rulesets
         [Resolved]
         private OsuGameBase gameBase { get; set; } = null!;
 
+        [SetUpSteps]
+        public void SetUpSteps()
+        {
+            AddStep("reset ruleset", () => Ruleset.Value = new OsuRuleset().RulesetInfo);
+        }
+
         [Test]
         public void TestNullModsReturnedByRulesetAreIgnored()
         {
@@ -30,6 +38,17 @@ namespace osu.Game.Tests.Rulesets
             AddAssert("no null mods in available mods", () => gameBase.AvailableMods.Value.SelectMany(kvp => kvp.Value).All(mod => mod != null));
         }
 
+        [Test]
+        public void TestRulesetRevertedIfModsCannotBeRetrieved()
+        {
+            RulesetInfo ruleset = null!;
+
+            AddStep("store current ruleset", () => ruleset = Ruleset.Value);
+
+            AddStep("set API incompatible ruleset", () => Ruleset.Value = new TestAPIIncompatibleRuleset().RulesetInfo);
+            AddAssert("ruleset not changed", () => Ruleset.Value.Equals(ruleset));
+        }
+
 #nullable disable // purposefully disabling nullability to simulate broken or unannotated API user code.
 
         private class TestRulesetWithNullMods : Ruleset
@@ -44,6 +63,19 @@ namespace osu.Game.Tests.Rulesets
             public override DifficultyCalculator CreateDifficultyCalculator(IWorkingBeatmap beatmap) => null;
         }
 
+        private class TestAPIIncompatibleRuleset : Ruleset
+        {
+            public override string ShortName => "incompatible";
+            public override string Description => "incompatible";
+
+            // simulate API incompatibility by throwing similar exceptions.
+            public override IEnumerable<Mod> GetModsFor(ModType type) => throw new MissingMethodException();
+
+            public override DrawableRuleset CreateDrawableRulesetWith(IBeatmap beatmap, IReadOnlyList<Mod> mods = null) => null;
+            public override IBeatmapConverter CreateBeatmapConverter(IBeatmap beatmap) => null;
+            public override DifficultyCalculator CreateDifficultyCalculator(IWorkingBeatmap beatmap) => null;
+        }
+
 #nullable enable
     }
 }

From e74b563b91e1526420363e4c507f19d494e241ed Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 15 Jun 2022 17:22:39 +0200
Subject: [PATCH 5474/5547] Add protection against arbitrary exceptions from
 `GetModsFor()`

---
 osu.Game/OsuGameBase.cs | 21 ++++++++++++++++-----
 1 file changed, 16 insertions(+), 5 deletions(-)

diff --git a/osu.Game/OsuGameBase.cs b/osu.Game/OsuGameBase.cs
index e6f1452c3f..2885d9413d 100644
--- a/osu.Game/OsuGameBase.cs
+++ b/osu.Game/OsuGameBase.cs
@@ -511,23 +511,34 @@ namespace osu.Game
             if (instance == null)
             {
                 // reject the change if the ruleset is not available.
-                Ruleset.Value = r.OldValue?.Available == true ? r.OldValue : RulesetStore.AvailableRulesets.First();
+                revertRulesetChange();
                 return;
             }
 
             var dict = new Dictionary<ModType, IReadOnlyList<Mod>>();
 
-            foreach (ModType type in Enum.GetValues(typeof(ModType)))
+            try
             {
-                dict[type] = instance.GetModsFor(type)
-                                     .Where(mod => mod != null)
-                                     .ToList();
+                foreach (ModType type in Enum.GetValues(typeof(ModType)))
+                {
+                    dict[type] = instance.GetModsFor(type)
+                                         .Where(mod => mod != null)
+                                         .ToList();
+                }
+            }
+            catch (Exception e)
+            {
+                Logger.Error(e, $"Could not load mods for \"{instance.RulesetInfo.Name}\" ruleset. Current ruleset has been rolled back.");
+                revertRulesetChange();
+                return;
             }
 
             if (!SelectedMods.Disabled)
                 SelectedMods.Value = Array.Empty<Mod>();
 
             AvailableMods.Value = dict;
+
+            void revertRulesetChange() => Ruleset.Value = r.OldValue?.Available == true ? r.OldValue : RulesetStore.AvailableRulesets.First();
         }
 
         private int allowableExceptions;

From 30382b0445e4676ecf73710c8cfb4d7fcc5fb622 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 15 Jun 2022 17:26:54 +0200
Subject: [PATCH 5475/5547] Fill out `GetModsFor()` xmldoc and annotate items
 as non-null

---
 osu.Game/OsuGameBase.cs      | 2 ++
 osu.Game/Rulesets/Ruleset.cs | 9 +++++++++
 2 files changed, 11 insertions(+)

diff --git a/osu.Game/OsuGameBase.cs b/osu.Game/OsuGameBase.cs
index 2885d9413d..e34a67fd02 100644
--- a/osu.Game/OsuGameBase.cs
+++ b/osu.Game/OsuGameBase.cs
@@ -522,6 +522,8 @@ namespace osu.Game
                 foreach (ModType type in Enum.GetValues(typeof(ModType)))
                 {
                     dict[type] = instance.GetModsFor(type)
+                                         // Rulesets should never return null mods, but let's be defensive just in case.
+                                         // ReSharper disable once ConditionIsAlwaysTrueOrFalse
                                          .Where(mod => mod != null)
                                          .ToList();
                 }
diff --git a/osu.Game/Rulesets/Ruleset.cs b/osu.Game/Rulesets/Ruleset.cs
index b7c6132bdb..9dec6984ea 100644
--- a/osu.Game/Rulesets/Ruleset.cs
+++ b/osu.Game/Rulesets/Ruleset.cs
@@ -93,6 +93,15 @@ namespace osu.Game.Rulesets
             return AllMods.FirstOrDefault(m => m is T)?.CreateInstance() as T;
         }
 
+        /// <summary>
+        /// Creates an enumerable with mods that are supported by the ruleset for the supplied <paramref name="type"/>.
+        /// </summary>
+        /// <remarks>
+        /// If there are no applicable mods from the given <paramref name="type"/> in this ruleset,
+        /// then the proper behaviour is to return an empty enumerable.
+        /// <see langword="null"/> mods should not be present in the returned enumerable.
+        /// </remarks>
+        [ItemNotNull]
         public abstract IEnumerable<Mod> GetModsFor(ModType type);
 
         /// <summary>

From 6ee1c35c8f4db78a4c74970618656a424be59a03 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 15 Jun 2022 17:28:31 +0200
Subject: [PATCH 5476/5547] Fix template projects returning null mods from
 `GetModsFor()`

---
 .../osu.Game.Rulesets.EmptyFreeform/EmptyFreeformRuleset.cs    | 3 ++-
 .../osu.Game.Rulesets.Pippidon/PippidonRuleset.cs              | 3 ++-
 .../osu.Game.Rulesets.EmptyScrolling/EmptyScrollingRuleset.cs  | 3 ++-
 .../osu.Game.Rulesets.Pippidon/PippidonRuleset.cs              | 3 ++-
 4 files changed, 8 insertions(+), 4 deletions(-)

diff --git a/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform/EmptyFreeformRuleset.cs b/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform/EmptyFreeformRuleset.cs
index baf503085d..00754c6346 100644
--- a/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform/EmptyFreeformRuleset.cs
+++ b/Templates/Rulesets/ruleset-empty/osu.Game.Rulesets.EmptyFreeform/EmptyFreeformRuleset.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 osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
@@ -41,7 +42,7 @@ namespace osu.Game.Rulesets.EmptyFreeform
                     return new[] { new EmptyFreeformModAutoplay() };
 
                 default:
-                    return new Mod[] { null };
+                    return Array.Empty<Mod>();
             }
         }
 
diff --git a/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon/PippidonRuleset.cs b/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon/PippidonRuleset.cs
index 15e988f466..7dcdac7019 100644
--- a/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon/PippidonRuleset.cs
+++ b/Templates/Rulesets/ruleset-example/osu.Game.Rulesets.Pippidon/PippidonRuleset.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 osu.Framework.Graphics;
 using osu.Framework.Graphics.Sprites;
@@ -37,7 +38,7 @@ namespace osu.Game.Rulesets.Pippidon
                     return new[] { new PippidonModAutoplay() };
 
                 default:
-                    return new Mod[] { null };
+                    return Array.Empty<Mod>();
             }
         }
 
diff --git a/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling/EmptyScrollingRuleset.cs b/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling/EmptyScrollingRuleset.cs
index b9bed74c88..c8f0c07724 100644
--- a/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling/EmptyScrollingRuleset.cs
+++ b/Templates/Rulesets/ruleset-scrolling-empty/osu.Game.Rulesets.EmptyScrolling/EmptyScrollingRuleset.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 osu.Framework.Graphics;
 using osu.Framework.Graphics.Sprites;
@@ -34,7 +35,7 @@ namespace osu.Game.Rulesets.EmptyScrolling
                     return new[] { new EmptyScrollingModAutoplay() };
 
                 default:
-                    return new Mod[] { null };
+                    return Array.Empty<Mod>();
             }
         }
 
diff --git a/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon/PippidonRuleset.cs b/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon/PippidonRuleset.cs
index ea94ceb4b5..d4566477db 100644
--- a/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon/PippidonRuleset.cs
+++ b/Templates/Rulesets/ruleset-scrolling-example/osu.Game.Rulesets.Pippidon/PippidonRuleset.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 osu.Framework.Graphics;
 using osu.Framework.Graphics.Sprites;
@@ -34,7 +35,7 @@ namespace osu.Game.Rulesets.Pippidon
                     return new[] { new PippidonModAutoplay() };
 
                 default:
-                    return new Mod[] { null };
+                    return Array.Empty<Mod>();
             }
         }
 

From 1acbb87aa6d88555f3f783b8f4088c783e82792a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 15 Jun 2022 17:39:30 +0200
Subject: [PATCH 5477/5547] Ensure `AvailableMods.Value` is never null

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

diff --git a/osu.Game/OsuGameBase.cs b/osu.Game/OsuGameBase.cs
index e34a67fd02..993ca5b5e8 100644
--- a/osu.Game/OsuGameBase.cs
+++ b/osu.Game/OsuGameBase.cs
@@ -159,7 +159,7 @@ namespace osu.Game
         /// <summary>
         /// Mods available for the current <see cref="Ruleset"/>.
         /// </summary>
-        public readonly Bindable<Dictionary<ModType, IReadOnlyList<Mod>>> AvailableMods = new Bindable<Dictionary<ModType, IReadOnlyList<Mod>>>();
+        public readonly Bindable<Dictionary<ModType, IReadOnlyList<Mod>>> AvailableMods = new Bindable<Dictionary<ModType, IReadOnlyList<Mod>>>(new Dictionary<ModType, IReadOnlyList<Mod>>());
 
         private BeatmapDifficultyCache difficultyCache;
 

From e7dcbddbeb4eb4febf48c79578c3d2595b27e765 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 15 Jun 2022 18:53:49 +0300
Subject: [PATCH 5478/5547] Fix potential null reference

---
 osu.Game/Overlays/NotificationOverlay.cs | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Overlays/NotificationOverlay.cs b/osu.Game/Overlays/NotificationOverlay.cs
index b772dffa73..1fe446454c 100644
--- a/osu.Game/Overlays/NotificationOverlay.cs
+++ b/osu.Game/Overlays/NotificationOverlay.cs
@@ -2,6 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System.Linq;
+using JetBrains.Annotations;
 using osu.Framework.Extensions.IEnumerableExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
@@ -36,8 +37,10 @@ namespace osu.Game.Overlays
         private AudioManager audio { get; set; }
 
         [Resolved(canBeNull: true)]
+        [CanBeNull]
         private FirstRunSetupOverlay firstRunSetup { get; set; }
 
+        [CanBeNull]
         private IBindable<Visibility> firstRunSetupState;
 
         [BackgroundDependencyLoader]
@@ -103,8 +106,10 @@ namespace osu.Game.Overlays
 
             State.ValueChanged += _ => updateProcessingMode();
 
-            firstRunSetupState = firstRunSetup.State.GetBoundCopy();
-            firstRunSetupState.ValueChanged += _ => updateProcessingMode();
+            firstRunSetupState = firstRunSetup?.State.GetBoundCopy();
+
+            if (firstRunSetupState != null)
+                firstRunSetupState.ValueChanged += _ => updateProcessingMode();
 
             OverlayActivationMode.BindValueChanged(_ => updateProcessingMode(), true);
         }

From 5d74d92fcf030d6c98fb8941ea3159914b09a6dd Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 15 Jun 2022 19:28:43 +0300
Subject: [PATCH 5479/5547] Revert `virtual` current bindable

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

diff --git a/osu.Game/Graphics/UserInterfaceV2/LabelledComponent.cs b/osu.Game/Graphics/UserInterfaceV2/LabelledComponent.cs
index 77267e453c..dd6a902989 100644
--- a/osu.Game/Graphics/UserInterfaceV2/LabelledComponent.cs
+++ b/osu.Game/Graphics/UserInterfaceV2/LabelledComponent.cs
@@ -15,7 +15,7 @@ namespace osu.Game.Graphics.UserInterfaceV2
         {
         }
 
-        public virtual Bindable<TValue> Current
+        public Bindable<TValue> Current
         {
             get => Component.Current;
             set => Component.Current = value;

From 2c35b1404b877767e2c39ac6218a05c3e6b1572c Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 15 Jun 2022 19:29:09 +0300
Subject: [PATCH 5480/5547] Use `FileInfo` as current bindable type

---
 .../Editing/TestSceneEditorBeatmapCreation.cs |  2 +-
 .../Screens/Edit/Setup/LabelledFileChooser.cs | 21 +++++------
 .../Screens/Edit/Setup/ResourcesSection.cs    | 36 +++++++++----------
 3 files changed, 27 insertions(+), 32 deletions(-)

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneEditorBeatmapCreation.cs b/osu.Game.Tests/Visual/Editing/TestSceneEditorBeatmapCreation.cs
index 841f50e7bd..6bcd947f2f 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneEditorBeatmapCreation.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneEditorBeatmapCreation.cs
@@ -96,7 +96,7 @@ namespace osu.Game.Tests.Visual.Editing
                 using (var zip = ZipArchive.Open(temp))
                     zip.WriteToDirectory(extractedFolder);
 
-                bool success = setup.ChildrenOfType<ResourcesSection>().First().ChangeAudioTrack(Path.Combine(extractedFolder, "03. Renatus - Soleily 192kbps.mp3"));
+                bool success = setup.ChildrenOfType<ResourcesSection>().First().ChangeAudioTrack(new FileInfo(Path.Combine(extractedFolder, "03. Renatus - Soleily 192kbps.mp3")));
 
                 File.Delete(temp);
                 Directory.Delete(extractedFolder, true);
diff --git a/osu.Game/Screens/Edit/Setup/LabelledFileChooser.cs b/osu.Game/Screens/Edit/Setup/LabelledFileChooser.cs
index 2cb3af61c8..6c56320666 100644
--- a/osu.Game/Screens/Edit/Setup/LabelledFileChooser.cs
+++ b/osu.Game/Screens/Edit/Setup/LabelledFileChooser.cs
@@ -27,20 +27,18 @@ namespace osu.Game.Screens.Edit.Setup
     /// A labelled drawable displaying file chooser on click, with placeholder text support.
     /// todo: this should probably not use PopoverTextBox just to display placeholder text, but is the best way for now.
     /// </summary>
-    internal class LabelledFileChooser : LabelledDrawable<LabelledTextBoxWithPopover.PopoverTextBox>, IHasCurrentValue<string>, ICanAcceptFiles, IHasPopover
+    internal class LabelledFileChooser : LabelledDrawable<LabelledTextBoxWithPopover.PopoverTextBox>, IHasCurrentValue<FileInfo?>, ICanAcceptFiles, IHasPopover
     {
         private readonly string[] handledExtensions;
 
         public IEnumerable<string> HandledExtensions => handledExtensions;
 
-        private readonly Bindable<FileInfo?> currentFile = new Bindable<FileInfo?>();
-
         [Resolved]
         private OsuGameBase game { get; set; } = null!;
 
-        private readonly BindableWithCurrent<string> current = new BindableWithCurrent<string>();
+        private readonly BindableWithCurrent<FileInfo?> current = new BindableWithCurrent<FileInfo?>();
 
-        public Bindable<string> Current
+        public Bindable<FileInfo?> Current
         {
             get => current.Current;
             set => current.Current = value;
@@ -68,21 +66,18 @@ namespace osu.Game.Screens.Edit.Setup
             base.LoadComplete();
 
             game.RegisterImportHandler(this);
-            currentFile.BindValueChanged(onFileSelected);
+            Current.BindValueChanged(onFileSelected);
         }
 
         private void onFileSelected(ValueChangedEvent<FileInfo?> file)
         {
-            if (file.NewValue == null)
-                return;
-
-            this.HidePopover();
-            Current.Value = file.NewValue.FullName;
+            if (file.NewValue != null)
+                this.HidePopover();
         }
 
         Task ICanAcceptFiles.Import(params string[] paths)
         {
-            Schedule(() => currentFile.Value = new FileInfo(paths.First()));
+            Schedule(() => Current.Value = new FileInfo(paths.First()));
             return Task.CompletedTask;
         }
 
@@ -105,7 +100,7 @@ namespace osu.Game.Screens.Edit.Setup
             OnFocused = this.ShowPopover,
         };
 
-        public Popover GetPopover() => new FileChooserPopover(handledExtensions, currentFile);
+        public Popover GetPopover() => new FileChooserPopover(handledExtensions, Current);
 
         private class FileChooserPopover : OsuPopover
         {
diff --git a/osu.Game/Screens/Edit/Setup/ResourcesSection.cs b/osu.Game/Screens/Edit/Setup/ResourcesSection.cs
index b4e350b94b..2471886d9b 100644
--- a/osu.Game/Screens/Edit/Setup/ResourcesSection.cs
+++ b/osu.Game/Screens/Edit/Setup/ResourcesSection.cs
@@ -43,26 +43,28 @@ namespace osu.Game.Screens.Edit.Setup
                 {
                     Label = "Background",
                     FixedLabelWidth = LABEL_WIDTH,
-                    Current = { Value = working.Value.Metadata.BackgroundFile },
                     TabbableContentContainer = this
                 },
                 audioTrackChooser = new LabelledFileChooser(".mp3", ".ogg")
                 {
                     Label = "Audio Track",
                     FixedLabelWidth = LABEL_WIDTH,
-                    Current = { Value = working.Value.Metadata.AudioFile },
                     TabbableContentContainer = this
                 },
             };
 
+            if (!string.IsNullOrEmpty(working.Value.Metadata.BackgroundFile))
+                backgroundChooser.Current.Value = new FileInfo(working.Value.Metadata.BackgroundFile);
+
+            if (!string.IsNullOrEmpty(working.Value.Metadata.AudioFile))
+                audioTrackChooser.Current.Value = new FileInfo(working.Value.Metadata.AudioFile);
+
             backgroundChooser.Current.BindValueChanged(backgroundChanged, true);
             audioTrackChooser.Current.BindValueChanged(audioTrackChanged, true);
         }
 
-        public bool ChangeBackgroundImage(string path)
+        public bool ChangeBackgroundImage(FileInfo source)
         {
-            var source = new FileInfo(path);
-
             if (!source.Exists)
                 return false;
 
@@ -88,10 +90,8 @@ namespace osu.Game.Screens.Edit.Setup
             return true;
         }
 
-        public bool ChangeAudioTrack(string path)
+        public bool ChangeAudioTrack(FileInfo source)
         {
-            var source = new FileInfo(path);
-
             if (!source.Exists)
                 return false;
 
@@ -119,29 +119,29 @@ namespace osu.Game.Screens.Edit.Setup
             return true;
         }
 
-        private void backgroundChanged(ValueChangedEvent<string> filePath)
+        private void backgroundChanged(ValueChangedEvent<FileInfo> file)
         {
-            backgroundChooser.Text = string.IsNullOrEmpty(filePath.NewValue)
+            backgroundChooser.Text = file.NewValue == null
                 ? "Click to select a background image"
                 : "Click to replace the background image";
 
-            if (filePath.NewValue != filePath.OldValue)
+            if (file.NewValue != file.OldValue)
             {
-                if (!ChangeBackgroundImage(filePath.NewValue))
-                    backgroundChooser.Current.Value = filePath.OldValue;
+                if (!ChangeBackgroundImage(file.NewValue))
+                    backgroundChooser.Current.Value = file.OldValue;
             }
         }
 
-        private void audioTrackChanged(ValueChangedEvent<string> filePath)
+        private void audioTrackChanged(ValueChangedEvent<FileInfo> file)
         {
-            audioTrackChooser.Text = string.IsNullOrEmpty(filePath.NewValue)
+            audioTrackChooser.Text = file.NewValue == null
                 ? "Click to select a track"
                 : "Click to replace the track";
 
-            if (filePath.NewValue != filePath.OldValue)
+            if (file.NewValue != file.OldValue)
             {
-                if (!ChangeAudioTrack(filePath.NewValue))
-                    audioTrackChooser.Current.Value = filePath.OldValue;
+                if (!ChangeAudioTrack(file.NewValue))
+                    audioTrackChooser.Current.Value = file.OldValue;
             }
         }
     }

From f88c568c8d684920f72d8b74d617e114de8811e9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 15 Jun 2022 19:53:04 +0200
Subject: [PATCH 5481/5547] Update flag sizes after switch to twemoji assets

The old flags used a size of 150x100, while the new assets based on
twemoji use a size of 150x108. Update existing usages to match this new
aspect ratio better.
---
 osu.Game.Tournament/Components/DrawableTeamFlag.cs              | 2 +-
 .../Screens/Drawings/Components/ScrollingTeamContainer.cs       | 2 +-
 osu.Game/Online/Leaderboards/LeaderboardScore.cs                | 2 +-
 osu.Game/Overlays/BeatmapSet/Scores/ScoreTable.cs               | 2 +-
 osu.Game/Overlays/BeatmapSet/Scores/TopScoreUserSection.cs      | 2 +-
 osu.Game/Overlays/Profile/Header/TopHeaderContainer.cs          | 2 +-
 osu.Game/Overlays/Rankings/CountryPill.cs                       | 2 +-
 osu.Game/Overlays/Rankings/Tables/RankingsTable.cs              | 2 +-
 .../OnlinePlay/Multiplayer/Participants/ParticipantPanel.cs     | 2 +-
 osu.Game/Users/ExtendedUserPanel.cs                             | 2 +-
 10 files changed, 10 insertions(+), 10 deletions(-)

diff --git a/osu.Game.Tournament/Components/DrawableTeamFlag.cs b/osu.Game.Tournament/Components/DrawableTeamFlag.cs
index 75991a1ab8..f8c2612d71 100644
--- a/osu.Game.Tournament/Components/DrawableTeamFlag.cs
+++ b/osu.Game.Tournament/Components/DrawableTeamFlag.cs
@@ -32,7 +32,7 @@ namespace osu.Game.Tournament.Components
         {
             if (team == null) return;
 
-            Size = new Vector2(75, 50);
+            Size = new Vector2(75, 54);
             Masking = true;
             CornerRadius = 5;
             Child = flagSprite = new Sprite
diff --git a/osu.Game.Tournament/Screens/Drawings/Components/ScrollingTeamContainer.cs b/osu.Game.Tournament/Screens/Drawings/Components/ScrollingTeamContainer.cs
index 6fec74f95b..f1022a0402 100644
--- a/osu.Game.Tournament/Screens/Drawings/Components/ScrollingTeamContainer.cs
+++ b/osu.Game.Tournament/Screens/Drawings/Components/ScrollingTeamContainer.cs
@@ -310,7 +310,7 @@ namespace osu.Game.Tournament.Screens.Drawings.Components
         public class ScrollingTeam : DrawableTournamentTeam
         {
             public const float WIDTH = 58;
-            public const float HEIGHT = 41;
+            public const float HEIGHT = 44;
 
             private readonly Box outline;
 
diff --git a/osu.Game/Online/Leaderboards/LeaderboardScore.cs b/osu.Game/Online/Leaderboards/LeaderboardScore.cs
index c75e98cdaa..93a42bffb0 100644
--- a/osu.Game/Online/Leaderboards/LeaderboardScore.cs
+++ b/osu.Game/Online/Leaderboards/LeaderboardScore.cs
@@ -183,7 +183,7 @@ namespace osu.Game.Online.Leaderboards
                                                         {
                                                             Anchor = Anchor.CentreLeft,
                                                             Origin = Anchor.CentreLeft,
-                                                            Size = new Vector2(30f, 20f),
+                                                            Size = new Vector2(28, 20),
                                                         },
                                                         new DateLabel(Score.Date)
                                                         {
diff --git a/osu.Game/Overlays/BeatmapSet/Scores/ScoreTable.cs b/osu.Game/Overlays/BeatmapSet/Scores/ScoreTable.cs
index 86e72e9faa..4b3407ba4c 100644
--- a/osu.Game/Overlays/BeatmapSet/Scores/ScoreTable.cs
+++ b/osu.Game/Overlays/BeatmapSet/Scores/ScoreTable.cs
@@ -165,7 +165,7 @@ namespace osu.Game.Overlays.BeatmapSet.Scores
                 },
                 new UpdateableFlag(score.User.Country)
                 {
-                    Size = new Vector2(19, 13),
+                    Size = new Vector2(19, 14),
                     ShowPlaceholderOnNull = false,
                 },
                 username,
diff --git a/osu.Game/Overlays/BeatmapSet/Scores/TopScoreUserSection.cs b/osu.Game/Overlays/BeatmapSet/Scores/TopScoreUserSection.cs
index 5c3906cb39..1c0fcf0e3c 100644
--- a/osu.Game/Overlays/BeatmapSet/Scores/TopScoreUserSection.cs
+++ b/osu.Game/Overlays/BeatmapSet/Scores/TopScoreUserSection.cs
@@ -116,7 +116,7 @@ namespace osu.Game.Overlays.BeatmapSet.Scores
                             {
                                 Anchor = Anchor.CentreLeft,
                                 Origin = Anchor.CentreLeft,
-                                Size = new Vector2(19, 13),
+                                Size = new Vector2(19, 14),
                                 Margin = new MarginPadding { Top = 3 }, // makes spacing look more even
                                 ShowPlaceholderOnNull = false,
                             },
diff --git a/osu.Game/Overlays/Profile/Header/TopHeaderContainer.cs b/osu.Game/Overlays/Profile/Header/TopHeaderContainer.cs
index 6ba5cb2f7f..3b76dc01ee 100644
--- a/osu.Game/Overlays/Profile/Header/TopHeaderContainer.cs
+++ b/osu.Game/Overlays/Profile/Header/TopHeaderContainer.cs
@@ -133,7 +133,7 @@ namespace osu.Game.Overlays.Profile.Header
                                             {
                                                 userFlag = new UpdateableFlag
                                                 {
-                                                    Size = new Vector2(30, 20),
+                                                    Size = new Vector2(28, 20),
                                                     ShowPlaceholderOnNull = false,
                                                 },
                                                 userCountryText = new OsuSpriteText
diff --git a/osu.Game/Overlays/Rankings/CountryPill.cs b/osu.Game/Overlays/Rankings/CountryPill.cs
index edd7b596d2..3878e2ea4e 100644
--- a/osu.Game/Overlays/Rankings/CountryPill.cs
+++ b/osu.Game/Overlays/Rankings/CountryPill.cs
@@ -77,7 +77,7 @@ namespace osu.Game.Overlays.Rankings
                                     {
                                         Anchor = Anchor.Centre,
                                         Origin = Anchor.Centre,
-                                        Size = new Vector2(30, 20)
+                                        Size = new Vector2(28, 20)
                                     },
                                     countryName = new OsuSpriteText
                                     {
diff --git a/osu.Game/Overlays/Rankings/Tables/RankingsTable.cs b/osu.Game/Overlays/Rankings/Tables/RankingsTable.cs
index fd69b6c80a..9658679067 100644
--- a/osu.Game/Overlays/Rankings/Tables/RankingsTable.cs
+++ b/osu.Game/Overlays/Rankings/Tables/RankingsTable.cs
@@ -97,7 +97,7 @@ namespace osu.Game.Overlays.Rankings.Tables
             {
                 new UpdateableFlag(GetCountry(item))
                 {
-                    Size = new Vector2(30, 20),
+                    Size = new Vector2(28, 20),
                     ShowPlaceholderOnNull = false,
                 },
                 CreateFlagContent(item)
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantPanel.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantPanel.cs
index e091559046..498a7d9972 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantPanel.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantPanel.cs
@@ -125,7 +125,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Participants
                                         {
                                             Anchor = Anchor.CentreLeft,
                                             Origin = Anchor.CentreLeft,
-                                            Size = new Vector2(30, 20),
+                                            Size = new Vector2(28, 20),
                                             Country = user?.Country
                                         },
                                         new OsuSpriteText
diff --git a/osu.Game/Users/ExtendedUserPanel.cs b/osu.Game/Users/ExtendedUserPanel.cs
index d0f693c37c..6733ff8b05 100644
--- a/osu.Game/Users/ExtendedUserPanel.cs
+++ b/osu.Game/Users/ExtendedUserPanel.cs
@@ -53,7 +53,7 @@ namespace osu.Game.Users
 
         protected UpdateableFlag CreateFlag() => new UpdateableFlag(User.Country)
         {
-            Size = new Vector2(39, 26),
+            Size = new Vector2(36, 26),
             Action = Action,
         };
 

From 88376da2cfc3f8d129e3a87e454ddd4c0a960265 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 16 Jun 2022 13:47:30 +0900
Subject: [PATCH 5482/5547] Run template tests on CI

---
 .github/workflows/ci.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 320197b88e..6281357648 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -82,7 +82,7 @@ jobs:
         run: dotnet build -c Debug -warnaserror osu.Desktop.slnf
 
       - name: Test
-        run: dotnet test $pwd/*.Tests/bin/Debug/*/*.Tests.dll --logger "trx;LogFileName=TestResults-${{matrix.os.prettyname}}-${{matrix.threadingMode}}.trx"
+        run: dotnet test $pwd/**/*.Tests/bin/Debug/*/*.Tests.dll --logger "trx;LogFileName=TestResults-${{matrix.os.prettyname}}-${{matrix.threadingMode}}.trx"
         shell: pwsh
 
       # Attempt to upload results even if test fails.

From ac554ca51f80f9dc5cddf584793fa6980b8366c1 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 16 Jun 2022 15:06:34 +0900
Subject: [PATCH 5483/5547] Update resources

---
 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 eb5e209e29..8fcd7ef8c0 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -51,7 +51,7 @@
     <Reference Include="Java.Interop" />
   </ItemGroup>
   <ItemGroup>
-    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.615.0" />
+    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.616.0" />
     <PackageReference Include="ppy.osu.Framework.Android" Version="2022.615.0" />
   </ItemGroup>
   <ItemGroup Label="Transitive Dependencies">
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index a0bf43e06b..e9bf000109 100644
--- a/osu.Game/osu.Game.csproj
+++ b/osu.Game/osu.Game.csproj
@@ -37,7 +37,7 @@
     </PackageReference>
     <PackageReference Include="Realm" Version="10.14.0" />
     <PackageReference Include="ppy.osu.Framework" Version="2022.615.0" />
-    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.615.0" />
+    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.616.0" />
     <PackageReference Include="Sentry" Version="3.17.1" />
     <PackageReference Include="SharpCompress" Version="0.31.0" />
     <PackageReference Include="NUnit" Version="3.13.3" />
diff --git a/osu.iOS.props b/osu.iOS.props
index 6f76bd654a..dd344b0cd0 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -62,7 +62,7 @@
   </ItemGroup>
   <ItemGroup Label="Package References">
     <PackageReference Include="ppy.osu.Framework.iOS" Version="2022.615.0" />
-    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.615.0" />
+    <PackageReference Include="ppy.osu.Game.Resources" Version="2022.616.0" />
   </ItemGroup>
   <!-- See https://github.com/dotnet/runtime/issues/35988 (can be removed after Xamarin uses net6.0) -->
   <PropertyGroup>

From 89533fa33d32954a889ff0dcc307a16b2a4519bb Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 16 Jun 2022 15:40:17 +0900
Subject: [PATCH 5484/5547] Fix `Disclaimer` screen handling user change events
 after initial display

Unnecessary overhead, but also should resolve a production hard crash.
---
 osu.Game/Screens/Menu/Disclaimer.cs | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/osu.Game/Screens/Menu/Disclaimer.cs b/osu.Game/Screens/Menu/Disclaimer.cs
index 24412cd85e..3482b171a3 100644
--- a/osu.Game/Screens/Menu/Disclaimer.cs
+++ b/osu.Game/Screens/Menu/Disclaimer.cs
@@ -171,6 +171,14 @@ namespace osu.Game.Screens.Menu
             ((IBindable<APIUser>)currentUser).BindTo(api.LocalUser);
         }
 
+        public override void OnSuspending(ScreenTransitionEvent e)
+        {
+            base.OnSuspending(e);
+
+            // Once this screen has finished being displayed, we don't want to unnecessarily handle user change events.
+            currentUser.UnbindAll();
+        }
+
         public override void OnEntering(ScreenTransitionEvent e)
         {
             base.OnEntering(e);

From ec53d87c307f286c725fd612b2d897100c2b86af Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 16 Jun 2022 16:04:52 +0900
Subject: [PATCH 5485/5547] Fix unsafe sample playback in
 `GameplaySampleTriggerSource`

Resolves https://github.com/ppy/osu/issues/18727.

Added delay from `Schedule` should be minimal as it is always called
from the `Update` thread (input propagation) anyway.
---
 osu.Game/Rulesets/UI/GameplaySampleTriggerSource.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Rulesets/UI/GameplaySampleTriggerSource.cs b/osu.Game/Rulesets/UI/GameplaySampleTriggerSource.cs
index c18698f77e..6b5cdc4ddf 100644
--- a/osu.Game/Rulesets/UI/GameplaySampleTriggerSource.cs
+++ b/osu.Game/Rulesets/UI/GameplaySampleTriggerSource.cs
@@ -56,12 +56,12 @@ namespace osu.Game.Rulesets.UI
             PlaySamples(samples);
         }
 
-        protected void PlaySamples(ISampleInfo[] samples)
+        protected void PlaySamples(ISampleInfo[] samples) => Schedule(() =>
         {
             var hitSound = getNextSample();
             hitSound.Samples = samples;
             hitSound.Play();
-        }
+        });
 
         protected HitObject GetMostValidObject()
         {

From 739a69646798bfdcdbd8ab42554cd4c89744eb83 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 16 Jun 2022 16:48:06 +0900
Subject: [PATCH 5486/5547] Ensure reading of existing databases when making
 backups doesn't create a file

---
 osu.Game/Database/DatabaseContextFactory.cs | 2 +-
 osu.Game/Database/RealmAccess.cs            | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Database/DatabaseContextFactory.cs b/osu.Game/Database/DatabaseContextFactory.cs
index 45557aa5ec..d222aec6b3 100644
--- a/osu.Game/Database/DatabaseContextFactory.cs
+++ b/osu.Game/Database/DatabaseContextFactory.cs
@@ -151,7 +151,7 @@ namespace osu.Game.Database
         {
             Logger.Log($"Creating full EF database backup at {backupFilename}", LoggingTarget.Database);
 
-            using (var source = storage.GetStream(DATABASE_NAME))
+            using (var source = storage.GetStream(DATABASE_NAME, mode: FileMode.Open))
             using (var destination = storage.GetStream(backupFilename, FileAccess.Write, FileMode.CreateNew))
                 source.CopyTo(destination);
         }
diff --git a/osu.Game/Database/RealmAccess.cs b/osu.Game/Database/RealmAccess.cs
index de7e3020c6..bd47920f82 100644
--- a/osu.Game/Database/RealmAccess.cs
+++ b/osu.Game/Database/RealmAccess.cs
@@ -762,7 +762,7 @@ namespace osu.Game.Database
                 {
                     try
                     {
-                        using (var source = storage.GetStream(Filename))
+                        using (var source = storage.GetStream(Filename, mode: FileMode.Open))
                         using (var destination = storage.GetStream(backupFilename, FileAccess.Write, FileMode.CreateNew))
                             source.CopyTo(destination);
                         return;

From 17dbb599d145248a013cd639dd4efdf37fcee162 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 16 Jun 2022 16:48:52 +0900
Subject: [PATCH 5487/5547] Don't backup collection database

This is no longer required due to recent changes which mean the
collection database will retain beatmap references even if they aren't
loaded locally (see https://github.com/ppy/osu/pull/18619).
---
 osu.Game/OsuGameBase.cs | 9 ---------
 1 file changed, 9 deletions(-)

diff --git a/osu.Game/OsuGameBase.cs b/osu.Game/OsuGameBase.cs
index 5dbdf6f602..3f896ff52e 100644
--- a/osu.Game/OsuGameBase.cs
+++ b/osu.Game/OsuGameBase.cs
@@ -244,15 +244,6 @@ namespace osu.Game
 
                 EFContextFactory.CreateBackup(Path.Combine(backup_folder, $"client.{migration}.db"));
                 realm.CreateBackup(Path.Combine(backup_folder, $"client.{migration}.realm"));
-
-                using (var source = Storage.GetStream("collection.db"))
-                {
-                    if (source != null)
-                    {
-                        using (var destination = Storage.CreateFileSafely(Path.Combine(backup_folder, $"collection.{migration}.db")))
-                            source.CopyTo(destination);
-                    }
-                }
             }
 
             dependencies.CacheAs(Storage);

From 4526f8c07d79d380a39cda62204b30e15e4c75f1 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 16 Jun 2022 16:50:00 +0900
Subject: [PATCH 5488/5547] Move database backup creation to async thread where
 possible

---
 osu.Game/Database/EFToRealmMigrator.cs | 13 ++++++++++++-
 osu.Game/Database/RealmAccess.cs       |  4 ++--
 osu.Game/OsuGameBase.cs                | 13 -------------
 3 files changed, 14 insertions(+), 16 deletions(-)

diff --git a/osu.Game/Database/EFToRealmMigrator.cs b/osu.Game/Database/EFToRealmMigrator.cs
index 4e98b7d3d2..d2f52fa635 100644
--- a/osu.Game/Database/EFToRealmMigrator.cs
+++ b/osu.Game/Database/EFToRealmMigrator.cs
@@ -123,8 +123,18 @@ namespace osu.Game.Database
 
         private void beginMigration()
         {
+            const string backup_folder = "backups";
+
+            string backupSuffix = $"before_final_migration_{DateTimeOffset.UtcNow.ToUnixTimeSeconds()}";
+
+            // required for initial backup.
+            var realmBlockOperations = realm.BlockAllOperations();
+
             Task.Factory.StartNew(() =>
             {
+                realm.CreateBackup(Path.Combine(backup_folder, $"client.{backupSuffix}.realm"), realmBlockOperations);
+                efContextFactory.CreateBackup(Path.Combine(backup_folder, $"client.{backupSuffix}.db"));
+
                 using (var ef = efContextFactory.Get())
                 {
                     realm.Write(r =>
@@ -182,7 +192,6 @@ namespace osu.Game.Database
                                 true);
 
                             const string attachment_filename = "attach_me.zip";
-                            const string backup_folder = "backups";
 
                             var backupStorage = storage.GetStorageForDirectory(backup_folder);
 
@@ -209,6 +218,8 @@ namespace osu.Game.Database
                 // If we were to not do this, the migration would run another time the next time the user starts the game.
                 deletePreRealmData();
 
+                realmBlockOperations.Dispose();
+
                 migrationCompleted.SetResult(true);
                 efContextFactory.SetMigrationCompletion();
             });
diff --git a/osu.Game/Database/RealmAccess.cs b/osu.Game/Database/RealmAccess.cs
index bd47920f82..b144b70574 100644
--- a/osu.Game/Database/RealmAccess.cs
+++ b/osu.Game/Database/RealmAccess.cs
@@ -750,9 +750,9 @@ namespace osu.Game.Database
         private string? getRulesetShortNameFromLegacyID(long rulesetId) =>
             efContextFactory?.Get().RulesetInfo.FirstOrDefault(r => r.ID == rulesetId)?.ShortName;
 
-        public void CreateBackup(string backupFilename)
+        public void CreateBackup(string backupFilename, IDisposable? blockAllOperations = null)
         {
-            using (BlockAllOperations())
+            using (blockAllOperations ?? BlockAllOperations())
             {
                 Logger.Log($"Creating full realm database backup at {backupFilename}", LoggingTarget.Database);
 
diff --git a/osu.Game/OsuGameBase.cs b/osu.Game/OsuGameBase.cs
index 3f896ff52e..a4e6486c46 100644
--- a/osu.Game/OsuGameBase.cs
+++ b/osu.Game/OsuGameBase.cs
@@ -233,19 +233,6 @@ namespace osu.Game
 
             Decoder.RegisterDependencies(RulesetStore);
 
-            // Backup is taken here rather than in EFToRealmMigrator to avoid recycling realm contexts
-            // after initial usages below. It can be moved once a direction is established for handling re-subscription.
-            // See https://github.com/ppy/osu/pull/16547 for more discussion.
-            if (EFContextFactory != null)
-            {
-                const string backup_folder = "backups";
-
-                string migration = $"before_final_migration_{DateTimeOffset.UtcNow.ToUnixTimeSeconds()}";
-
-                EFContextFactory.CreateBackup(Path.Combine(backup_folder, $"client.{migration}.db"));
-                realm.CreateBackup(Path.Combine(backup_folder, $"client.{migration}.realm"));
-            }
-
             dependencies.CacheAs(Storage);
 
             var largeStore = new LargeTextureStore(Host.CreateTextureLoaderStore(new NamespacedResourceStore<byte[]>(Resources, @"Textures")));

From 6b30ee095041719fbeed4149e4e8f4c0325fc78b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 16 Jun 2022 17:26:43 +0900
Subject: [PATCH 5489/5547] Tidy up DI and binding logic

---
 osu.Game/Overlays/NotificationOverlay.cs | 25 +++++++++---------------
 1 file changed, 9 insertions(+), 16 deletions(-)

diff --git a/osu.Game/Overlays/NotificationOverlay.cs b/osu.Game/Overlays/NotificationOverlay.cs
index 1fe446454c..d50768f43e 100644
--- a/osu.Game/Overlays/NotificationOverlay.cs
+++ b/osu.Game/Overlays/NotificationOverlay.cs
@@ -36,15 +36,10 @@ namespace osu.Game.Overlays
         [Resolved]
         private AudioManager audio { get; set; }
 
-        [Resolved(canBeNull: true)]
-        [CanBeNull]
-        private FirstRunSetupOverlay firstRunSetup { get; set; }
+        private readonly IBindable<Visibility> firstRunSetupVisibility = new Bindable<Visibility>();
 
-        [CanBeNull]
-        private IBindable<Visibility> firstRunSetupState;
-
-        [BackgroundDependencyLoader]
-        private void load()
+        [BackgroundDependencyLoader(true)]
+        private void load([CanBeNull] FirstRunSetupOverlay firstRunSetup)
         {
             X = WIDTH;
             Width = WIDTH;
@@ -83,13 +78,16 @@ namespace osu.Game.Overlays
                     }
                 }
             };
+
+            if (firstRunSetup != null)
+                firstRunSetupVisibility.BindTo(firstRunSetup.State);
         }
 
         private ScheduledDelegate notificationsEnabler;
 
         private void updateProcessingMode()
         {
-            bool enabled = (OverlayActivationMode.Value == OverlayActivation.All && firstRunSetupState?.Value != Visibility.Visible) || State.Value == Visibility.Visible;
+            bool enabled = (OverlayActivationMode.Value == OverlayActivation.All && firstRunSetupVisibility?.Value != Visibility.Visible) || State.Value == Visibility.Visible;
 
             notificationsEnabler?.Cancel();
 
@@ -104,13 +102,8 @@ namespace osu.Game.Overlays
         {
             base.LoadComplete();
 
-            State.ValueChanged += _ => updateProcessingMode();
-
-            firstRunSetupState = firstRunSetup?.State.GetBoundCopy();
-
-            if (firstRunSetupState != null)
-                firstRunSetupState.ValueChanged += _ => updateProcessingMode();
-
+            State.BindValueChanged(_ => updateProcessingMode());
+            firstRunSetupVisibility.BindValueChanged(_ => updateProcessingMode());
             OverlayActivationMode.BindValueChanged(_ => updateProcessingMode(), true);
         }
 

From 251923c1067ab2e5e43c1ea8b4a819dff2187b37 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 16 Jun 2022 17:28:08 +0900
Subject: [PATCH 5490/5547] Convert `NotificationOverlay` to NRT

---
 osu.Game/Overlays/NotificationOverlay.cs | 27 ++++++++++++------------
 1 file changed, 14 insertions(+), 13 deletions(-)

diff --git a/osu.Game/Overlays/NotificationOverlay.cs b/osu.Game/Overlays/NotificationOverlay.cs
index d50768f43e..d83839fa2c 100644
--- a/osu.Game/Overlays/NotificationOverlay.cs
+++ b/osu.Game/Overlays/NotificationOverlay.cs
@@ -1,21 +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 enable
+
 using System.Linq;
-using JetBrains.Annotations;
-using osu.Framework.Extensions.IEnumerableExtensions;
-using osu.Framework.Graphics;
-using osu.Framework.Graphics.Containers;
-using osu.Game.Overlays.Notifications;
-using osu.Framework.Graphics.Shapes;
-using osu.Game.Graphics.Containers;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
 using osu.Framework.Bindables;
+using osu.Framework.Extensions.IEnumerableExtensions;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.Shapes;
 using osu.Framework.Localisation;
 using osu.Framework.Logging;
 using osu.Framework.Threading;
 using osu.Game.Graphics;
+using osu.Game.Graphics.Containers;
+using osu.Game.Overlays.Notifications;
 using osu.Game.Resources.Localisation.Web;
 using NotificationsStrings = osu.Game.Localisation.NotificationsStrings;
 
@@ -31,15 +32,15 @@ namespace osu.Game.Overlays
 
         public const float TRANSITION_LENGTH = 600;
 
-        private FlowContainer<NotificationSection> sections;
+        private FlowContainer<NotificationSection> sections = null!;
 
         [Resolved]
-        private AudioManager audio { get; set; }
+        private AudioManager audio { get; set; } = null!;
 
         private readonly IBindable<Visibility> firstRunSetupVisibility = new Bindable<Visibility>();
 
-        [BackgroundDependencyLoader(true)]
-        private void load([CanBeNull] FirstRunSetupOverlay firstRunSetup)
+        [BackgroundDependencyLoader]
+        private void load(FirstRunSetupOverlay? firstRunSetup)
         {
             X = WIDTH;
             Width = WIDTH;
@@ -83,11 +84,11 @@ namespace osu.Game.Overlays
                 firstRunSetupVisibility.BindTo(firstRunSetup.State);
         }
 
-        private ScheduledDelegate notificationsEnabler;
+        private ScheduledDelegate? notificationsEnabler;
 
         private void updateProcessingMode()
         {
-            bool enabled = (OverlayActivationMode.Value == OverlayActivation.All && firstRunSetupVisibility?.Value != Visibility.Visible) || State.Value == Visibility.Visible;
+            bool enabled = (OverlayActivationMode.Value == OverlayActivation.All && firstRunSetupVisibility.Value != Visibility.Visible) || State.Value == Visibility.Visible;
 
             notificationsEnabler?.Cancel();
 

From 4c372539a15fc1be0ff437dc3a007c9019282244 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 16 Jun 2022 17:57:04 +0900
Subject: [PATCH 5491/5547] Consolidate remaining methods in
 `BeatmapModelManager`

---
 osu.Game/Beatmaps/BeatmapModelManager.cs | 30 +++++++-----------------
 1 file changed, 9 insertions(+), 21 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapModelManager.cs b/osu.Game/Beatmaps/BeatmapModelManager.cs
index 055eb36850..11230caa7d 100644
--- a/osu.Game/Beatmaps/BeatmapModelManager.cs
+++ b/osu.Game/Beatmaps/BeatmapModelManager.cs
@@ -29,10 +29,6 @@ namespace osu.Game.Beatmaps
         /// </summary>
         public IWorkingBeatmapCache? WorkingBeatmapCache { private get; set; }
 
-        public override IEnumerable<string> HandledExtensions => new[] { ".osz" };
-
-        protected override string[] HashableFileTypes => new[] { ".osu" };
-
         public static readonly string[] VIDEO_EXTENSIONS = { ".mp4", ".mov", ".avi", ".flv" };
 
         public BeatmapModelManager(RealmAccess realm, Storage storage, BeatmapOnlineLookupQueue? onlineLookupQueue = null)
@@ -71,7 +67,7 @@ namespace osu.Game.Beatmaps
 
                 // AddFile generally handles updating/replacing files, but this is a case where the filename may have also changed so let's delete for simplicity.
                 var existingFileInfo = setInfo.Files.SingleOrDefault(f => string.Equals(f.Filename, beatmapInfo.Path, StringComparison.OrdinalIgnoreCase));
-                string targetFilename = getFilename(beatmapInfo);
+                string targetFilename = createBeatmapFilenameFromMetadata(beatmapInfo);
 
                 // ensure that two difficulties from the set don't point at the same beatmap file.
                 if (setInfo.Beatmaps.Any(b => b.ID != beatmapInfo.ID && string.Equals(b.Path, targetFilename, StringComparison.OrdinalIgnoreCase)))
@@ -83,17 +79,18 @@ namespace osu.Game.Beatmaps
                 beatmapInfo.MD5Hash = stream.ComputeMD5Hash();
                 beatmapInfo.Hash = stream.ComputeSHA2Hash();
 
-                AddFile(setInfo, stream, getFilename(beatmapInfo));
-                Update(setInfo);
+                AddFile(setInfo, stream, createBeatmapFilenameFromMetadata(beatmapInfo));
+
+                Realm.Write(r => setInfo.CopyChangesToRealm(r.Find<BeatmapSetInfo>(setInfo.ID)));
             }
 
             WorkingBeatmapCache?.Invalidate(beatmapInfo);
-        }
 
-        private static string getFilename(BeatmapInfo beatmapInfo)
-        {
-            var metadata = beatmapInfo.Metadata;
-            return $"{metadata.Artist} - {metadata.Title} ({metadata.Author.Username}) [{beatmapInfo.DifficultyName}].osu".GetValidArchiveContentFilename();
+            static string createBeatmapFilenameFromMetadata(BeatmapInfo beatmapInfo)
+            {
+                var metadata = beatmapInfo.Metadata;
+                return $"{metadata.Artist} - {metadata.Title} ({metadata.Author.Username}) [{beatmapInfo.DifficultyName}].osu".GetValidArchiveContentFilename();
+            }
         }
 
         /// <summary>
@@ -106,15 +103,6 @@ namespace osu.Game.Beatmaps
             return Realm.Run(realm => realm.All<BeatmapInfo>().FirstOrDefault(query)?.Detach());
         }
 
-        public void Update(BeatmapSetInfo item)
-        {
-            Realm.Write(r =>
-            {
-                var existing = r.Find<BeatmapSetInfo>(item.ID);
-                item.CopyChangesToRealm(existing);
-            });
-        }
-
         /// <summary>
         /// Delete videos from a list of beatmaps.
         /// This will post notifications tracking progress.

From 84dba36cf564e49cdf526588d111c2ed28975587 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 16 Jun 2022 17:59:07 +0900
Subject: [PATCH 5492/5547] Update usages of `BeatmapModelManager` which only
 require importing to use `BeatmapImporter`

---
 .../Database/BeatmapImporterTests.cs          | 52 +++++++++----------
 osu.Game/Beatmaps/BeatmapImporter.cs          |  4 +-
 2 files changed, 28 insertions(+), 28 deletions(-)

diff --git a/osu.Game.Tests/Database/BeatmapImporterTests.cs b/osu.Game.Tests/Database/BeatmapImporterTests.cs
index a057f893f4..03e388c821 100644
--- a/osu.Game.Tests/Database/BeatmapImporterTests.cs
+++ b/osu.Game.Tests/Database/BeatmapImporterTests.cs
@@ -38,7 +38,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealmAsync(async (realm, storage) =>
             {
-                using (var importer = new BeatmapModelManager(realm, storage))
+                using (var importer = new BeatmapImporter(realm, storage))
                 using (new RealmRulesetStore(realm, storage))
                 {
                     Live<BeatmapSetInfo>? beatmapSet;
@@ -82,7 +82,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealmAsync(async (realm, storage) =>
             {
-                using (var importer = new BeatmapModelManager(realm, storage))
+                using (var importer = new BeatmapImporter(realm, storage))
                 using (new RealmRulesetStore(realm, storage))
                 {
                     Live<BeatmapSetInfo>? beatmapSet;
@@ -141,7 +141,7 @@ namespace osu.Game.Tests.Database
             {
                 BeatmapSetInfo? detachedSet = null;
 
-                using (var importer = new BeatmapModelManager(realm, storage))
+                using (var importer = new BeatmapImporter(realm, storage))
                 using (new RealmRulesetStore(realm, storage))
                 {
                     Task.Run(async () =>
@@ -170,7 +170,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealmAsync(async (realm, storage) =>
             {
-                using (var importer = new BeatmapModelManager(realm, storage))
+                using (var importer = new BeatmapImporter(realm, storage))
                 using (new RealmRulesetStore(realm, storage))
                 {
                     Live<BeatmapSetInfo>? imported;
@@ -202,7 +202,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealmAsync(async (realm, storage) =>
             {
-                using var importer = new BeatmapModelManager(realm, storage);
+                using var importer = new BeatmapImporter(realm, storage);
                 using var store = new RealmRulesetStore(realm, storage);
 
                 await LoadOszIntoStore(importer, realm.Realm);
@@ -214,7 +214,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealmAsync(async (realm, storage) =>
             {
-                using var importer = new BeatmapModelManager(realm, storage);
+                using var importer = new BeatmapImporter(realm, storage);
                 using var store = new RealmRulesetStore(realm, storage);
 
                 var imported = await LoadOszIntoStore(importer, realm.Realm);
@@ -232,7 +232,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealmAsync(async (realm, storage) =>
             {
-                using var importer = new BeatmapModelManager(realm, storage);
+                using var importer = new BeatmapImporter(realm, storage);
                 using var store = new RealmRulesetStore(realm, storage);
 
                 var imported = await LoadOszIntoStore(importer, realm.Realm);
@@ -246,7 +246,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealmAsync(async (realm, storage) =>
             {
-                using var importer = new BeatmapModelManager(realm, storage);
+                using var importer = new BeatmapImporter(realm, storage);
                 using var store = new RealmRulesetStore(realm, storage);
 
                 string? tempPath = TestResources.GetTestBeatmapForImport();
@@ -276,7 +276,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealmAsync(async (realm, storage) =>
             {
-                using var importer = new BeatmapModelManager(realm, storage);
+                using var importer = new BeatmapImporter(realm, storage);
                 using var store = new RealmRulesetStore(realm, storage);
 
                 var imported = await LoadOszIntoStore(importer, realm.Realm);
@@ -296,7 +296,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealmAsync(async (realm, storage) =>
             {
-                using var importer = new BeatmapModelManager(realm, storage);
+                using var importer = new BeatmapImporter(realm, storage);
                 using var store = new RealmRulesetStore(realm, storage);
 
                 string? temp = TestResources.GetTestBeatmapForImport();
@@ -345,7 +345,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealmAsync(async (realm, storage) =>
             {
-                using var importer = new BeatmapModelManager(realm, storage);
+                using var importer = new BeatmapImporter(realm, storage);
                 using var store = new RealmRulesetStore(realm, storage);
 
                 string? temp = TestResources.GetTestBeatmapForImport();
@@ -396,7 +396,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealmAsync(async (realm, storage) =>
             {
-                using var importer = new BeatmapModelManager(realm, storage);
+                using var importer = new BeatmapImporter(realm, storage);
                 using var store = new RealmRulesetStore(realm, storage);
 
                 string? temp = TestResources.GetTestBeatmapForImport();
@@ -444,7 +444,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealmAsync(async (realm, storage) =>
             {
-                using var importer = new BeatmapModelManager(realm, storage);
+                using var importer = new BeatmapImporter(realm, storage);
                 using var store = new RealmRulesetStore(realm, storage);
 
                 string? temp = TestResources.GetTestBeatmapForImport();
@@ -492,7 +492,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealmAsync(async (realm, storage) =>
             {
-                using var importer = new BeatmapModelManager(realm, storage);
+                using var importer = new BeatmapImporter(realm, storage);
                 using var store = new RealmRulesetStore(realm, storage);
 
                 var imported = await LoadOszIntoStore(importer, realm.Realm);
@@ -527,7 +527,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealmAsync(async (realm, storage) =>
             {
-                using var importer = new BeatmapModelManager(realm, storage);
+                using var importer = new BeatmapImporter(realm, storage);
                 using var store = new RealmRulesetStore(realm, storage);
 
                 var progressNotification = new ImportProgressNotification();
@@ -565,7 +565,7 @@ namespace osu.Game.Tests.Database
                         Interlocked.Increment(ref loggedExceptionCount);
                 };
 
-                using var importer = new BeatmapModelManager(realm, storage);
+                using var importer = new BeatmapImporter(realm, storage);
                 using var store = new RealmRulesetStore(realm, storage);
 
                 var imported = await LoadOszIntoStore(importer, realm.Realm);
@@ -617,7 +617,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealmAsync(async (realm, storage) =>
             {
-                using var importer = new BeatmapModelManager(realm, storage);
+                using var importer = new BeatmapImporter(realm, storage);
                 using var store = new RealmRulesetStore(realm, storage);
 
                 var imported = await LoadOszIntoStore(importer, realm.Realm, batchImport: true);
@@ -644,7 +644,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealmAsync(async (realmFactory, storage) =>
             {
-                using var importer = new BeatmapModelManager(realmFactory, storage);
+                using var importer = new BeatmapImporter(realmFactory, storage);
                 using var store = new RealmRulesetStore(realmFactory, storage);
 
                 var imported = await LoadOszIntoStore(importer, realmFactory.Realm);
@@ -676,7 +676,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealmAsync(async (realm, storage) =>
             {
-                using var importer = new BeatmapModelManager(realm, storage);
+                using var importer = new BeatmapImporter(realm, storage);
                 using var store = new RealmRulesetStore(realm, storage);
 
                 var imported = await LoadOszIntoStore(importer, realm.Realm);
@@ -703,7 +703,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealmAsync(async (realm, storage) =>
             {
-                using var importer = new BeatmapModelManager(realm, storage);
+                using var importer = new BeatmapImporter(realm, storage);
                 using var store = new RealmRulesetStore(realm, storage);
 
                 var imported = await LoadOszIntoStore(importer, realm.Realm);
@@ -729,7 +729,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealm((realm, storage) =>
             {
-                using var importer = new BeatmapModelManager(realm, storage);
+                using var importer = new BeatmapImporter(realm, storage);
                 using var store = new RealmRulesetStore(realm, storage);
 
                 var metadata = new BeatmapMetadata
@@ -777,7 +777,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealmAsync(async (realm, storage) =>
             {
-                using var importer = new BeatmapModelManager(realm, storage);
+                using var importer = new BeatmapImporter(realm, storage);
                 using var store = new RealmRulesetStore(realm, storage);
 
                 string? temp = TestResources.GetTestBeatmapForImport();
@@ -794,7 +794,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealmAsync(async (realm, storage) =>
             {
-                using var importer = new BeatmapModelManager(realm, storage);
+                using var importer = new BeatmapImporter(realm, storage);
                 using var store = new RealmRulesetStore(realm, storage);
 
                 string? temp = TestResources.GetTestBeatmapForImport();
@@ -830,7 +830,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealmAsync(async (realm, storage) =>
             {
-                using var importer = new BeatmapModelManager(realm, storage);
+                using var importer = new BeatmapImporter(realm, storage);
                 using var store = new RealmRulesetStore(realm, storage);
 
                 string? temp = TestResources.GetTestBeatmapForImport();
@@ -872,7 +872,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealmAsync(async (realm, storage) =>
             {
-                using var importer = new BeatmapModelManager(realm, storage);
+                using var importer = new BeatmapImporter(realm, storage);
                 using var store = new RealmRulesetStore(realm, storage);
 
                 string? temp = TestResources.GetTestBeatmapForImport();
@@ -923,7 +923,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealmAsync(async (realm, storage) =>
             {
-                using var importer = new BeatmapModelManager(realm, storage);
+                using var importer = new BeatmapImporter(realm, storage);
                 using var store = new RealmRulesetStore(realm, storage);
 
                 string? temp = TestResources.GetTestBeatmapForImport();
diff --git a/osu.Game/Beatmaps/BeatmapImporter.cs b/osu.Game/Beatmaps/BeatmapImporter.cs
index a2ab70fed8..eded4cf9d1 100644
--- a/osu.Game/Beatmaps/BeatmapImporter.cs
+++ b/osu.Game/Beatmaps/BeatmapImporter.cs
@@ -32,7 +32,7 @@ namespace osu.Game.Beatmaps
     /// Handles the storage and retrieval of Beatmaps/WorkingBeatmaps.
     /// </summary>
     [ExcludeFromDynamicCompile]
-    public abstract class BeatmapImporter : RealmArchiveModelManager<BeatmapSetInfo>, IDisposable
+    public class BeatmapImporter : RealmArchiveModelManager<BeatmapSetInfo>, IDisposable
     {
         public override IEnumerable<string> HandledExtensions => new[] { ".osz" };
 
@@ -40,7 +40,7 @@ namespace osu.Game.Beatmaps
 
         private readonly BeatmapOnlineLookupQueue? onlineLookupQueue;
 
-        protected BeatmapImporter(RealmAccess realm, Storage storage, BeatmapOnlineLookupQueue? onlineLookupQueue = null)
+        public BeatmapImporter(RealmAccess realm, Storage storage, BeatmapOnlineLookupQueue? onlineLookupQueue = null)
             : base(storage, realm)
         {
             this.onlineLookupQueue = onlineLookupQueue;

From 8ea3042435ed60906f01037c1cc36bb312cd5f73 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 16 Jun 2022 18:00:27 +0900
Subject: [PATCH 5493/5547] Move file extensions specification to common class

---
 osu.Game/Beatmaps/BeatmapModelManager.cs             | 4 +---
 osu.Game/Graphics/UserInterfaceV2/OsuFileSelector.cs | 3 +--
 osu.Game/OsuGameBase.cs                              | 2 ++
 3 files changed, 4 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapModelManager.cs b/osu.Game/Beatmaps/BeatmapModelManager.cs
index 11230caa7d..768bed6d67 100644
--- a/osu.Game/Beatmaps/BeatmapModelManager.cs
+++ b/osu.Game/Beatmaps/BeatmapModelManager.cs
@@ -29,8 +29,6 @@ namespace osu.Game.Beatmaps
         /// </summary>
         public IWorkingBeatmapCache? WorkingBeatmapCache { private get; set; }
 
-        public static readonly string[] VIDEO_EXTENSIONS = { ".mp4", ".mov", ".avi", ".flv" };
-
         public BeatmapModelManager(RealmAccess realm, Storage storage, BeatmapOnlineLookupQueue? onlineLookupQueue = null)
             : base(realm, storage, onlineLookupQueue)
         {
@@ -131,7 +129,7 @@ namespace osu.Game.Beatmaps
                     // user requested abort
                     return;
 
-                var video = b.Files.FirstOrDefault(f => VIDEO_EXTENSIONS.Any(ex => f.Filename.EndsWith(ex, StringComparison.Ordinal)));
+                var video = b.Files.FirstOrDefault(f => OsuGameBase.VIDEO_EXTENSIONS.Any(ex => f.Filename.EndsWith(ex, StringComparison.Ordinal)));
 
                 if (video != null)
                 {
diff --git a/osu.Game/Graphics/UserInterfaceV2/OsuFileSelector.cs b/osu.Game/Graphics/UserInterfaceV2/OsuFileSelector.cs
index d9dbf4974b..7c88e12dd3 100644
--- a/osu.Game/Graphics/UserInterfaceV2/OsuFileSelector.cs
+++ b/osu.Game/Graphics/UserInterfaceV2/OsuFileSelector.cs
@@ -8,7 +8,6 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Graphics.UserInterface;
-using osu.Game.Beatmaps;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.UserInterface;
@@ -67,7 +66,7 @@ namespace osu.Game.Graphics.UserInterfaceV2
             {
                 get
                 {
-                    if (BeatmapModelManager.VIDEO_EXTENSIONS.Contains(File.Extension))
+                    if (OsuGameBase.VIDEO_EXTENSIONS.Contains(File.Extension))
                         return FontAwesome.Regular.FileVideo;
 
                     switch (File.Extension)
diff --git a/osu.Game/OsuGameBase.cs b/osu.Game/OsuGameBase.cs
index 993ca5b5e8..5c8620fba4 100644
--- a/osu.Game/OsuGameBase.cs
+++ b/osu.Game/OsuGameBase.cs
@@ -57,6 +57,8 @@ namespace osu.Game
     /// </summary>
     public partial class OsuGameBase : Framework.Game, ICanAcceptFiles, IBeatSyncProvider
     {
+        public static readonly string[] VIDEO_EXTENSIONS = { ".mp4", ".mov", ".avi", ".flv" };
+
         public const string OSU_PROTOCOL = "osu://";
 
         public const string CLIENT_STREAM_NAME = @"lazer";

From 1f3e1b2d974f5e4c2fd1383963b744408f99ed9c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 16 Jun 2022 18:07:04 +0900
Subject: [PATCH 5494/5547] Combine `BeatmapManager` and `BeatmapModelManager`
 into one class

---
 ...eneOnlinePlayBeatmapAvailabilityTracker.cs |   8 +-
 osu.Game/Beatmaps/BeatmapManager.cs           | 192 ++++++++++++++----
 osu.Game/Beatmaps/BeatmapModelManager.cs      | 149 --------------
 .../Database/RealmArchiveModelImporter.cs     |   2 +-
 osu.Game/Tests/Visual/EditorTestScene.cs      |   4 +-
 5 files changed, 154 insertions(+), 201 deletions(-)
 delete mode 100644 osu.Game/Beatmaps/BeatmapModelManager.cs

diff --git a/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs b/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
index 4f255ddd00..915ad50d2b 100644
--- a/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
+++ b/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
@@ -210,16 +210,16 @@ namespace osu.Game.Tests.Online
             {
             }
 
-            protected override BeatmapModelManager CreateBeatmapModelManager(Storage storage, RealmAccess realm, RulesetStore rulesets, BeatmapOnlineLookupQueue onlineLookupQueue)
+            protected override BeatmapImporter CreateBeatmapImporter(Storage storage, RealmAccess realm, RulesetStore rulesets, BeatmapOnlineLookupQueue onlineLookupQueue)
             {
-                return new TestBeatmapModelManager(this, storage, realm, onlineLookupQueue);
+                return new TestBeatmapImporter(this, storage, realm, onlineLookupQueue);
             }
 
-            internal class TestBeatmapModelManager : BeatmapModelManager
+            internal class TestBeatmapImporter : BeatmapImporter
             {
                 private readonly TestBeatmapManager testBeatmapManager;
 
-                public TestBeatmapModelManager(TestBeatmapManager testBeatmapManager, Storage storage, RealmAccess databaseAccess, BeatmapOnlineLookupQueue beatmapOnlineLookupQueue)
+                public TestBeatmapImporter(TestBeatmapManager testBeatmapManager, Storage storage, RealmAccess databaseAccess, BeatmapOnlineLookupQueue beatmapOnlineLookupQueue)
                     : base(databaseAccess, storage, beatmapOnlineLookupQueue)
                 {
                     this.testBeatmapManager = testBeatmapManager;
diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index 9397c2f3b2..63bd7dc710 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -1,19 +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.
 
+#nullable enable
+
 using System;
 using System.Collections.Generic;
+using System.Diagnostics;
 using System.IO;
 using System.Linq;
 using System.Linq.Expressions;
+using System.Text;
 using System.Threading;
 using System.Threading.Tasks;
 using osu.Framework.Audio;
 using osu.Framework.Audio.Track;
+using osu.Framework.Extensions;
 using osu.Framework.IO.Stores;
 using osu.Framework.Platform;
 using osu.Framework.Testing;
+using osu.Game.Beatmaps.Formats;
 using osu.Game.Database;
+using osu.Game.Extensions;
 using osu.Game.IO.Archives;
 using osu.Game.Models;
 using osu.Game.Online.API;
@@ -23,8 +30,6 @@ using osu.Game.Rulesets;
 using osu.Game.Skinning;
 using osu.Game.Utils;
 
-#nullable enable
-
 namespace osu.Game.Beatmaps
 {
     /// <summary>
@@ -35,14 +40,15 @@ namespace osu.Game.Beatmaps
     {
         public ITrackStore BeatmapTrackStore { get; }
 
-        private readonly BeatmapModelManager beatmapModelManager;
+        private readonly BeatmapImporter beatmapImporter;
 
         private readonly WorkingBeatmapCache workingBeatmapCache;
         private readonly BeatmapOnlineLookupQueue? onlineBeatmapLookupQueue;
 
         private readonly RealmAccess realm;
 
-        public BeatmapManager(Storage storage, RealmAccess realm, RulesetStore rulesets, IAPIProvider? api, AudioManager audioManager, IResourceStore<byte[]> gameResources, GameHost? host = null, WorkingBeatmap? defaultBeatmap = null, bool performOnlineLookups = false)
+        public BeatmapManager(Storage storage, RealmAccess realm, RulesetStore rulesets, IAPIProvider? api, AudioManager audioManager, IResourceStore<byte[]> gameResources, GameHost? host = null,
+                              WorkingBeatmap? defaultBeatmap = null, bool performOnlineLookups = false)
         {
             this.realm = realm;
 
@@ -58,19 +64,18 @@ namespace osu.Game.Beatmaps
 
             BeatmapTrackStore = audioManager.GetTrackStore(userResources);
 
-            beatmapModelManager = CreateBeatmapModelManager(storage, realm, rulesets, onlineBeatmapLookupQueue);
+            beatmapImporter = CreateBeatmapImporter(storage, realm, rulesets, onlineBeatmapLookupQueue);
             workingBeatmapCache = CreateWorkingBeatmapCache(audioManager, gameResources, userResources, defaultBeatmap, host);
-
-            beatmapModelManager.WorkingBeatmapCache = workingBeatmapCache;
         }
 
-        protected virtual WorkingBeatmapCache CreateWorkingBeatmapCache(AudioManager audioManager, IResourceStore<byte[]> resources, IResourceStore<byte[]> storage, WorkingBeatmap? defaultBeatmap, GameHost? host)
+        protected virtual WorkingBeatmapCache CreateWorkingBeatmapCache(AudioManager audioManager, IResourceStore<byte[]> resources, IResourceStore<byte[]> storage, WorkingBeatmap? defaultBeatmap,
+                                                                        GameHost? host)
         {
             return new WorkingBeatmapCache(BeatmapTrackStore, audioManager, resources, storage, defaultBeatmap, host);
         }
 
-        protected virtual BeatmapModelManager CreateBeatmapModelManager(Storage storage, RealmAccess realm, RulesetStore rulesets, BeatmapOnlineLookupQueue? onlineLookupQueue) =>
-            new BeatmapModelManager(realm, storage, onlineLookupQueue);
+        protected virtual BeatmapImporter CreateBeatmapImporter(Storage storage, RealmAccess realm, RulesetStore rulesets, BeatmapOnlineLookupQueue? onlineLookupQueue) =>
+            new BeatmapImporter(realm, storage, onlineLookupQueue);
 
         /// <summary>
         /// Create a new beatmap set, backed by a <see cref="BeatmapSetInfo"/> model,
@@ -99,7 +104,7 @@ namespace osu.Game.Beatmaps
             foreach (BeatmapInfo b in beatmapSet.Beatmaps)
                 b.BeatmapSet = beatmapSet;
 
-            var imported = beatmapModelManager.Import(beatmapSet);
+            var imported = beatmapImporter.Import(beatmapSet);
 
             if (imported == null)
                 throw new InvalidOperationException("Failed to import new beatmap");
@@ -169,12 +174,12 @@ namespace osu.Game.Beatmaps
         private WorkingBeatmap addDifficultyToSet(BeatmapSetInfo targetBeatmapSet, IBeatmap newBeatmap, ISkin beatmapSkin)
         {
             // populate circular beatmap set info <-> beatmap info references manually.
-            // several places like `BeatmapModelManager.Save()` or `GetWorkingBeatmap()`
+            // several places like `BeatmapImporter.Save()` or `GetWorkingBeatmap()`
             // rely on them being freely traversable in both directions for correct operation.
             targetBeatmapSet.Beatmaps.Add(newBeatmap.BeatmapInfo);
             newBeatmap.BeatmapInfo.BeatmapSet = targetBeatmapSet;
 
-            beatmapModelManager.Save(newBeatmap.BeatmapInfo, newBeatmap, beatmapSkin);
+            Save(newBeatmap.BeatmapInfo, newBeatmap, beatmapSkin);
 
             workingBeatmapCache.Invalidate(targetBeatmapSet);
             return GetWorkingBeatmap(newBeatmap.BeatmapInfo);
@@ -255,23 +260,14 @@ namespace osu.Game.Beatmaps
             return realm.Run(r => r.All<BeatmapSetInfo>().FirstOrDefault(query)?.ToLive(realm));
         }
 
-        #region Delegation to BeatmapModelManager (methods which previously existed locally).
+        #region Delegation to BeatmapImporter (methods which previously existed locally).
 
         /// <summary>
         /// Perform a lookup query on available <see cref="BeatmapInfo"/>s.
         /// </summary>
         /// <param name="query">The query.</param>
         /// <returns>The first result for the provided query, or null if no results were found.</returns>
-        public BeatmapInfo? QueryBeatmap(Expression<Func<BeatmapInfo, bool>> query) => beatmapModelManager.QueryBeatmap(query)?.Detach();
-
-        /// <summary>
-        /// Saves an <see cref="IBeatmap"/> file against a given <see cref="BeatmapInfo"/>.
-        /// </summary>
-        /// <param name="info">The <see cref="BeatmapInfo"/> to save the content against. The file referenced by <see cref="BeatmapInfo.Path"/> will be replaced.</param>
-        /// <param name="beatmapContent">The <see cref="IBeatmap"/> content to write.</param>
-        /// <param name="beatmapSkin">The beatmap <see cref="ISkin"/> content to write, null if to be omitted.</param>
-        public virtual void Save(BeatmapInfo info, IBeatmap beatmapContent, ISkin? beatmapSkin = null) =>
-            beatmapModelManager.Save(info, beatmapContent, beatmapSkin);
+        public BeatmapInfo? QueryBeatmap(Expression<Func<BeatmapInfo, bool>> query) => realm.Run(r => r.All<BeatmapInfo>().FirstOrDefault(query)?.Detach());
 
         /// <summary>
         /// A default representation of a WorkingBeatmap to use when no beatmap is available.
@@ -281,9 +277,10 @@ namespace osu.Game.Beatmaps
         /// <summary>
         /// Fired when a notification should be presented to the user.
         /// </summary>
-        public Action<Notification> PostNotification
+        public Action<Notification>? PostNotification
         {
-            set => beatmapModelManager.PostNotification = value;
+            get => beatmapImporter.PostNotification;
+            set => beatmapImporter.PostNotification = value;
         }
 
         #endregion
@@ -292,17 +289,17 @@ namespace osu.Game.Beatmaps
 
         public bool IsAvailableLocally(BeatmapSetInfo model)
         {
-            return beatmapModelManager.IsAvailableLocally(model);
+            return beatmapImporter.IsAvailableLocally(model);
         }
 
         public bool Delete(BeatmapSetInfo item)
         {
-            return beatmapModelManager.Delete(item);
+            return beatmapImporter.Delete(item);
         }
 
         public void Delete(List<BeatmapSetInfo> items, bool silent = false)
         {
-            beatmapModelManager.Delete(items, silent);
+            beatmapImporter.Delete(items, silent);
         }
 
         public void Delete(Expression<Func<BeatmapSetInfo, bool>>? filter = null, bool silent = false)
@@ -314,51 +311,156 @@ namespace osu.Game.Beatmaps
                 if (filter != null)
                     items = items.Where(filter);
 
-                beatmapModelManager.Delete(items.ToList(), silent);
+                beatmapImporter.Delete(items.ToList(), silent);
             });
         }
 
+        /// <summary>
+        /// Saves an <see cref="IBeatmap"/> file against a given <see cref="BeatmapInfo"/>.
+        /// </summary>
+        /// <param name="beatmapInfo">The <see cref="BeatmapInfo"/> to save the content against. The file referenced by <see cref="BeatmapInfo.Path"/> will be replaced.</param>
+        /// <param name="beatmapContent">The <see cref="IBeatmap"/> content to write.</param>
+        /// <param name="beatmapSkin">The beatmap <see cref="ISkin"/> content to write, null if to be omitted.</param>
+        public virtual void Save(BeatmapInfo beatmapInfo, IBeatmap beatmapContent, ISkin? beatmapSkin = null)
+        {
+            var setInfo = beatmapInfo.BeatmapSet;
+            Debug.Assert(setInfo != null);
+
+            // Difficulty settings must be copied first due to the clone in `Beatmap<>.BeatmapInfo_Set`.
+            // This should hopefully be temporary, assuming said clone is eventually removed.
+
+            // Warning: The directionality here is important. Changes have to be copied *from* beatmapContent (which comes from editor and is being saved)
+            // *to* the beatmapInfo (which is a database model and needs to receive values without the taiko slider velocity multiplier for correct operation).
+            // CopyTo() will undo such adjustments, while CopyFrom() will not.
+            beatmapContent.Difficulty.CopyTo(beatmapInfo.Difficulty);
+
+            // All changes to metadata are made in the provided beatmapInfo, so this should be copied to the `IBeatmap` before encoding.
+            beatmapContent.BeatmapInfo = beatmapInfo;
+
+            using (var stream = new MemoryStream())
+            {
+                using (var sw = new StreamWriter(stream, Encoding.UTF8, 1024, true))
+                    new LegacyBeatmapEncoder(beatmapContent, beatmapSkin).Encode(sw);
+
+                stream.Seek(0, SeekOrigin.Begin);
+
+                // AddFile generally handles updating/replacing files, but this is a case where the filename may have also changed so let's delete for simplicity.
+                var existingFileInfo = setInfo.Files.SingleOrDefault(f => string.Equals(f.Filename, beatmapInfo.Path, StringComparison.OrdinalIgnoreCase));
+                string targetFilename = createBeatmapFilenameFromMetadata(beatmapInfo);
+
+                // ensure that two difficulties from the set don't point at the same beatmap file.
+                if (setInfo.Beatmaps.Any(b => b.ID != beatmapInfo.ID && string.Equals(b.Path, targetFilename, StringComparison.OrdinalIgnoreCase)))
+                    throw new InvalidOperationException($"{setInfo.GetDisplayString()} already has a difficulty with the name of '{beatmapInfo.DifficultyName}'.");
+
+                if (existingFileInfo != null)
+                    DeleteFile(setInfo, existingFileInfo);
+
+                beatmapInfo.MD5Hash = stream.ComputeMD5Hash();
+                beatmapInfo.Hash = stream.ComputeSHA2Hash();
+
+                AddFile(setInfo, stream, createBeatmapFilenameFromMetadata(beatmapInfo));
+
+                realm.Write(r => setInfo.CopyChangesToRealm(r.Find<BeatmapSetInfo>(setInfo.ID)));
+            }
+
+            workingBeatmapCache.Invalidate(beatmapInfo);
+
+            static string createBeatmapFilenameFromMetadata(BeatmapInfo beatmapInfo)
+            {
+                var metadata = beatmapInfo.Metadata;
+                return $"{metadata.Artist} - {metadata.Title} ({metadata.Author.Username}) [{beatmapInfo.DifficultyName}].osu".GetValidArchiveContentFilename();
+            }
+        }
+
         public void DeleteAllVideos()
         {
             realm.Write(r =>
             {
                 var items = r.All<BeatmapSetInfo>().Where(s => !s.DeletePending && !s.Protected);
-                beatmapModelManager.DeleteVideos(items.ToList());
+                DeleteVideos(items.ToList());
             });
         }
 
+        /// <summary>
+        /// Delete videos from a list of beatmaps.
+        /// This will post notifications tracking progress.
+        /// </summary>
+        public void DeleteVideos(List<BeatmapSetInfo> items, bool silent = false)
+        {
+            if (items.Count == 0) return;
+
+            var notification = new ProgressNotification
+            {
+                Progress = 0,
+                Text = $"Preparing to delete all {beatmapImporter.HumanisedModelName} videos...",
+                CompletionText = "No videos found to delete!",
+                State = ProgressNotificationState.Active,
+            };
+
+            if (!silent)
+                PostNotification?.Invoke(notification);
+
+            int i = 0;
+            int deleted = 0;
+
+            foreach (var b in items)
+            {
+                if (notification.State == ProgressNotificationState.Cancelled)
+                    // user requested abort
+                    return;
+
+                var video = b.Files.FirstOrDefault(f => OsuGameBase.VIDEO_EXTENSIONS.Any(ex => f.Filename.EndsWith(ex, StringComparison.Ordinal)));
+
+                if (video != null)
+                {
+                    DeleteFile(b, video);
+                    deleted++;
+                    notification.CompletionText = $"Deleted {deleted} {beatmapImporter.HumanisedModelName} video(s)!";
+                }
+
+                notification.Text = $"Deleting videos from {beatmapImporter.HumanisedModelName}s ({deleted} deleted)";
+
+                notification.Progress = (float)++i / items.Count;
+            }
+
+            notification.State = ProgressNotificationState.Completed;
+        }
+
         public void UndeleteAll()
         {
-            realm.Run(r => beatmapModelManager.Undelete(r.All<BeatmapSetInfo>().Where(s => s.DeletePending).ToList()));
+            realm.Run(r => beatmapImporter.Undelete(r.All<BeatmapSetInfo>().Where(s => s.DeletePending).ToList()));
         }
 
         public void Undelete(List<BeatmapSetInfo> items, bool silent = false)
         {
-            beatmapModelManager.Undelete(items, silent);
+            beatmapImporter.Undelete(items, silent);
         }
 
         public void Undelete(BeatmapSetInfo item)
         {
-            beatmapModelManager.Undelete(item);
+            beatmapImporter.Undelete(item);
         }
 
         #endregion
 
         #region Implementation of ICanAcceptFiles
 
-        public Task Import(params string[] paths) => beatmapModelManager.Import(paths);
+        public Task Import(params string[] paths) => beatmapImporter.Import(paths);
 
-        public Task Import(params ImportTask[] tasks) => beatmapModelManager.Import(tasks);
+        public Task Import(params ImportTask[] tasks) => beatmapImporter.Import(tasks);
 
-        public Task<IEnumerable<Live<BeatmapSetInfo>>> Import(ProgressNotification notification, params ImportTask[] tasks) => beatmapModelManager.Import(notification, tasks);
+        public Task<IEnumerable<Live<BeatmapSetInfo>>> Import(ProgressNotification notification, params ImportTask[] tasks) => beatmapImporter.Import(notification, tasks);
 
-        public Task<Live<BeatmapSetInfo>?> Import(ImportTask task, bool batchImport = false, CancellationToken cancellationToken = default) => beatmapModelManager.Import(task, batchImport, cancellationToken);
+        public Task<Live<BeatmapSetInfo>?> Import(ImportTask task, bool batchImport = false, CancellationToken cancellationToken = default) =>
+            beatmapImporter.Import(task, batchImport, cancellationToken);
 
-        public Task<Live<BeatmapSetInfo>?> Import(ArchiveReader archive, bool batchImport = false, CancellationToken cancellationToken = default) => beatmapModelManager.Import(archive, batchImport, cancellationToken);
+        public Task<Live<BeatmapSetInfo>?> Import(ArchiveReader archive, bool batchImport = false, CancellationToken cancellationToken = default) =>
+            beatmapImporter.Import(archive, batchImport, cancellationToken);
 
-        public Live<BeatmapSetInfo>? Import(BeatmapSetInfo item, ArchiveReader? archive = null, CancellationToken cancellationToken = default) => beatmapModelManager.Import(item, archive, false, cancellationToken);
+        public Live<BeatmapSetInfo>? Import(BeatmapSetInfo item, ArchiveReader? archive = null, CancellationToken cancellationToken = default) =>
+            beatmapImporter.Import(item, archive, false, cancellationToken);
 
-        public IEnumerable<string> HandledExtensions => beatmapModelManager.HandledExtensions;
+        public IEnumerable<string> HandledExtensions => beatmapImporter.HandledExtensions;
 
         #endregion
 
@@ -400,17 +502,17 @@ namespace osu.Game.Beatmaps
 
         public void ReplaceFile(BeatmapSetInfo model, RealmNamedFileUsage file, Stream contents)
         {
-            beatmapModelManager.ReplaceFile(model, file, contents);
+            beatmapImporter.ReplaceFile(model, file, contents);
         }
 
         public void DeleteFile(BeatmapSetInfo model, RealmNamedFileUsage file)
         {
-            beatmapModelManager.DeleteFile(model, file);
+            beatmapImporter.DeleteFile(model, file);
         }
 
         public void AddFile(BeatmapSetInfo model, Stream contents, string filename)
         {
-            beatmapModelManager.AddFile(model, contents, filename);
+            beatmapImporter.AddFile(model, contents, filename);
         }
 
         #endregion
@@ -428,7 +530,7 @@ namespace osu.Game.Beatmaps
 
         public Action<IEnumerable<Live<BeatmapSetInfo>>>? PostImport
         {
-            set => beatmapModelManager.PostImport = value;
+            set => beatmapImporter.PostImport = value;
         }
 
         #endregion
diff --git a/osu.Game/Beatmaps/BeatmapModelManager.cs b/osu.Game/Beatmaps/BeatmapModelManager.cs
deleted file mode 100644
index 768bed6d67..0000000000
--- a/osu.Game/Beatmaps/BeatmapModelManager.cs
+++ /dev/null
@@ -1,149 +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.Diagnostics;
-using System.IO;
-using System.Linq;
-using System.Linq.Expressions;
-using System.Text;
-using osu.Framework.Extensions;
-using osu.Framework.Platform;
-using osu.Framework.Testing;
-using osu.Game.Beatmaps.Formats;
-using osu.Game.Database;
-using osu.Game.Extensions;
-using osu.Game.Skinning;
-using osu.Game.Overlays.Notifications;
-
-#nullable enable
-
-namespace osu.Game.Beatmaps
-{
-    [ExcludeFromDynamicCompile]
-    public class BeatmapModelManager : BeatmapImporter
-    {
-        /// <summary>
-        /// The game working beatmap cache, used to invalidate entries on changes.
-        /// </summary>
-        public IWorkingBeatmapCache? WorkingBeatmapCache { private get; set; }
-
-        public BeatmapModelManager(RealmAccess realm, Storage storage, BeatmapOnlineLookupQueue? onlineLookupQueue = null)
-            : base(realm, storage, onlineLookupQueue)
-        {
-        }
-
-        /// <summary>
-        /// Saves an <see cref="IBeatmap"/> file against a given <see cref="BeatmapInfo"/>.
-        /// </summary>
-        /// <param name="beatmapInfo">The <see cref="BeatmapInfo"/> to save the content against. The file referenced by <see cref="BeatmapInfo.Path"/> will be replaced.</param>
-        /// <param name="beatmapContent">The <see cref="IBeatmap"/> content to write.</param>
-        /// <param name="beatmapSkin">The beatmap <see cref="ISkin"/> content to write, null if to be omitted.</param>
-        public void Save(BeatmapInfo beatmapInfo, IBeatmap beatmapContent, ISkin? beatmapSkin = null)
-        {
-            var setInfo = beatmapInfo.BeatmapSet;
-            Debug.Assert(setInfo != null);
-
-            // Difficulty settings must be copied first due to the clone in `Beatmap<>.BeatmapInfo_Set`.
-            // This should hopefully be temporary, assuming said clone is eventually removed.
-
-            // Warning: The directionality here is important. Changes have to be copied *from* beatmapContent (which comes from editor and is being saved)
-            // *to* the beatmapInfo (which is a database model and needs to receive values without the taiko slider velocity multiplier for correct operation).
-            // CopyTo() will undo such adjustments, while CopyFrom() will not.
-            beatmapContent.Difficulty.CopyTo(beatmapInfo.Difficulty);
-
-            // All changes to metadata are made in the provided beatmapInfo, so this should be copied to the `IBeatmap` before encoding.
-            beatmapContent.BeatmapInfo = beatmapInfo;
-
-            using (var stream = new MemoryStream())
-            {
-                using (var sw = new StreamWriter(stream, Encoding.UTF8, 1024, true))
-                    new LegacyBeatmapEncoder(beatmapContent, beatmapSkin).Encode(sw);
-
-                stream.Seek(0, SeekOrigin.Begin);
-
-                // AddFile generally handles updating/replacing files, but this is a case where the filename may have also changed so let's delete for simplicity.
-                var existingFileInfo = setInfo.Files.SingleOrDefault(f => string.Equals(f.Filename, beatmapInfo.Path, StringComparison.OrdinalIgnoreCase));
-                string targetFilename = createBeatmapFilenameFromMetadata(beatmapInfo);
-
-                // ensure that two difficulties from the set don't point at the same beatmap file.
-                if (setInfo.Beatmaps.Any(b => b.ID != beatmapInfo.ID && string.Equals(b.Path, targetFilename, StringComparison.OrdinalIgnoreCase)))
-                    throw new InvalidOperationException($"{setInfo.GetDisplayString()} already has a difficulty with the name of '{beatmapInfo.DifficultyName}'.");
-
-                if (existingFileInfo != null)
-                    DeleteFile(setInfo, existingFileInfo);
-
-                beatmapInfo.MD5Hash = stream.ComputeMD5Hash();
-                beatmapInfo.Hash = stream.ComputeSHA2Hash();
-
-                AddFile(setInfo, stream, createBeatmapFilenameFromMetadata(beatmapInfo));
-
-                Realm.Write(r => setInfo.CopyChangesToRealm(r.Find<BeatmapSetInfo>(setInfo.ID)));
-            }
-
-            WorkingBeatmapCache?.Invalidate(beatmapInfo);
-
-            static string createBeatmapFilenameFromMetadata(BeatmapInfo beatmapInfo)
-            {
-                var metadata = beatmapInfo.Metadata;
-                return $"{metadata.Artist} - {metadata.Title} ({metadata.Author.Username}) [{beatmapInfo.DifficultyName}].osu".GetValidArchiveContentFilename();
-            }
-        }
-
-        /// <summary>
-        /// Perform a lookup query on available <see cref="BeatmapInfo"/>s.
-        /// </summary>
-        /// <param name="query">The query.</param>
-        /// <returns>The first result for the provided query, or null if no results were found.</returns>
-        public BeatmapInfo? QueryBeatmap(Expression<Func<BeatmapInfo, bool>> query)
-        {
-            return Realm.Run(realm => realm.All<BeatmapInfo>().FirstOrDefault(query)?.Detach());
-        }
-
-        /// <summary>
-        /// Delete videos from a list of beatmaps.
-        /// This will post notifications tracking progress.
-        /// </summary>
-        public void DeleteVideos(List<BeatmapSetInfo> items, bool silent = false)
-        {
-            if (items.Count == 0) return;
-
-            var notification = new ProgressNotification
-            {
-                Progress = 0,
-                Text = $"Preparing to delete all {HumanisedModelName} videos...",
-                CompletionText = "No videos found to delete!",
-                State = ProgressNotificationState.Active,
-            };
-
-            if (!silent)
-                PostNotification?.Invoke(notification);
-
-            int i = 0;
-            int deleted = 0;
-
-            foreach (var b in items)
-            {
-                if (notification.State == ProgressNotificationState.Cancelled)
-                    // user requested abort
-                    return;
-
-                var video = b.Files.FirstOrDefault(f => OsuGameBase.VIDEO_EXTENSIONS.Any(ex => f.Filename.EndsWith(ex, StringComparison.Ordinal)));
-
-                if (video != null)
-                {
-                    DeleteFile(b, video);
-                    deleted++;
-                    notification.CompletionText = $"Deleted {deleted} {HumanisedModelName} video(s)!";
-                }
-
-                notification.Text = $"Deleting videos from {HumanisedModelName}s ({deleted} deleted)";
-
-                notification.Progress = (float)++i / items.Count;
-            }
-
-            notification.State = ProgressNotificationState.Completed;
-        }
-    }
-}
diff --git a/osu.Game/Database/RealmArchiveModelImporter.cs b/osu.Game/Database/RealmArchiveModelImporter.cs
index 4153f421ef..32e71c5521 100644
--- a/osu.Game/Database/RealmArchiveModelImporter.cs
+++ b/osu.Game/Database/RealmArchiveModelImporter.cs
@@ -72,7 +72,7 @@ namespace osu.Game.Database
         /// <summary>
         /// Set an endpoint for notifications to be posted to.
         /// </summary>
-        public Action<Notification>? PostNotification { protected get; set; }
+        public Action<Notification>? PostNotification { get; set; }
 
         protected RealmArchiveModelImporter(Storage storage, RealmAccess realm)
         {
diff --git a/osu.Game/Tests/Visual/EditorTestScene.cs b/osu.Game/Tests/Visual/EditorTestScene.cs
index 8e9bb6ff78..fbb5209513 100644
--- a/osu.Game/Tests/Visual/EditorTestScene.cs
+++ b/osu.Game/Tests/Visual/EditorTestScene.cs
@@ -145,9 +145,9 @@ namespace osu.Game.Tests.Visual
             {
             }
 
-            protected override BeatmapModelManager CreateBeatmapModelManager(Storage storage, RealmAccess realm, RulesetStore rulesets, BeatmapOnlineLookupQueue onlineLookupQueue)
+            protected override BeatmapImporter CreateBeatmapImporter(Storage storage, RealmAccess realm, RulesetStore rulesets, BeatmapOnlineLookupQueue onlineLookupQueue)
             {
-                return new BeatmapModelManager(realm, storage, onlineLookupQueue);
+                return new BeatmapImporter(realm, storage, onlineLookupQueue);
             }
 
             protected override WorkingBeatmapCache CreateWorkingBeatmapCache(AudioManager audioManager, IResourceStore<byte[]> resources, IResourceStore<byte[]> storage, WorkingBeatmap defaultBeatmap, GameHost host)

From 4d9e3d1982b836c7ff4eaf10d6a4b83bc0c1719f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 16 Jun 2022 18:11:50 +0900
Subject: [PATCH 5495/5547] Rename Score/Skin `ModelManager` classes to
 `Importer` for now

---
 ...{ScoreModelManager.cs => ScoreImporter.cs} |  4 +-
 osu.Game/Scoring/ScoreManager.cs              | 34 +++++++--------
 .../{SkinModelManager.cs => SkinImporter.cs}  |  4 +-
 osu.Game/Skinning/SkinManager.cs              | 42 +++++++++----------
 4 files changed, 42 insertions(+), 42 deletions(-)
 rename osu.Game/Scoring/{ScoreModelManager.cs => ScoreImporter.cs} (93%)
 rename osu.Game/Skinning/{SkinModelManager.cs => SkinImporter.cs} (98%)

diff --git a/osu.Game/Scoring/ScoreModelManager.cs b/osu.Game/Scoring/ScoreImporter.cs
similarity index 93%
rename from osu.Game/Scoring/ScoreModelManager.cs
rename to osu.Game/Scoring/ScoreImporter.cs
index c88955c5fd..76c43ba2e2 100644
--- a/osu.Game/Scoring/ScoreModelManager.cs
+++ b/osu.Game/Scoring/ScoreImporter.cs
@@ -19,7 +19,7 @@ using Realms;
 
 namespace osu.Game.Scoring
 {
-    public class ScoreModelManager : RealmArchiveModelManager<ScoreInfo>
+    public class ScoreImporter : RealmArchiveModelManager<ScoreInfo>
     {
         public override IEnumerable<string> HandledExtensions => new[] { ".osr" };
 
@@ -28,7 +28,7 @@ namespace osu.Game.Scoring
         private readonly RulesetStore rulesets;
         private readonly Func<BeatmapManager> beatmaps;
 
-        public ScoreModelManager(RulesetStore rulesets, Func<BeatmapManager> beatmaps, Storage storage, RealmAccess realm)
+        public ScoreImporter(RulesetStore rulesets, Func<BeatmapManager> beatmaps, Storage storage, RealmAccess realm)
             : base(storage, realm)
         {
             this.rulesets = rulesets;
diff --git a/osu.Game/Scoring/ScoreManager.cs b/osu.Game/Scoring/ScoreManager.cs
index e857d2109f..125746d5dd 100644
--- a/osu.Game/Scoring/ScoreManager.cs
+++ b/osu.Game/Scoring/ScoreManager.cs
@@ -28,7 +28,7 @@ namespace osu.Game.Scoring
         private readonly Scheduler scheduler;
         private readonly Func<BeatmapDifficultyCache> difficulties;
         private readonly OsuConfigManager configManager;
-        private readonly ScoreModelManager scoreModelManager;
+        private readonly ScoreImporter scoreImporter;
 
         public ScoreManager(RulesetStore rulesets, Func<BeatmapManager> beatmaps, Storage storage, RealmAccess realm, Scheduler scheduler,
                             Func<BeatmapDifficultyCache> difficulties = null, OsuConfigManager configManager = null)
@@ -38,10 +38,10 @@ namespace osu.Game.Scoring
             this.difficulties = difficulties;
             this.configManager = configManager;
 
-            scoreModelManager = new ScoreModelManager(rulesets, beatmaps, storage, realm);
+            scoreImporter = new ScoreImporter(rulesets, beatmaps, storage, realm);
         }
 
-        public Score GetScore(ScoreInfo score) => scoreModelManager.GetScore(score);
+        public Score GetScore(ScoreInfo score) => scoreImporter.GetScore(score);
 
         /// <summary>
         /// Perform a lookup query on available <see cref="ScoreInfo"/>s.
@@ -231,7 +231,7 @@ namespace osu.Game.Scoring
 
         public Action<Notification> PostNotification
         {
-            set => scoreModelManager.PostNotification = value;
+            set => scoreImporter.PostNotification = value;
         }
 
         #endregion
@@ -240,7 +240,7 @@ namespace osu.Game.Scoring
 
         public bool Delete(ScoreInfo item)
         {
-            return scoreModelManager.Delete(item);
+            return scoreImporter.Delete(item);
         }
 
         public void Delete([CanBeNull] Expression<Func<ScoreInfo, bool>> filter = null, bool silent = false)
@@ -253,7 +253,7 @@ namespace osu.Game.Scoring
                 if (filter != null)
                     items = items.Where(filter);
 
-                scoreModelManager.Delete(items.ToList(), silent);
+                scoreImporter.Delete(items.ToList(), silent);
             });
         }
 
@@ -262,27 +262,27 @@ namespace osu.Game.Scoring
             realm.Run(r =>
             {
                 var beatmapScores = r.Find<BeatmapInfo>(beatmap.ID).Scores.ToList();
-                scoreModelManager.Delete(beatmapScores, silent);
+                scoreImporter.Delete(beatmapScores, silent);
             });
         }
 
-        public void Delete(List<ScoreInfo> items, bool silent = false) => scoreModelManager.Delete(items, silent);
+        public void Delete(List<ScoreInfo> items, bool silent = false) => scoreImporter.Delete(items, silent);
 
-        public void Undelete(List<ScoreInfo> items, bool silent = false) => scoreModelManager.Undelete(items, silent);
+        public void Undelete(List<ScoreInfo> items, bool silent = false) => scoreImporter.Undelete(items, silent);
 
-        public void Undelete(ScoreInfo item) => scoreModelManager.Undelete(item);
+        public void Undelete(ScoreInfo item) => scoreImporter.Undelete(item);
 
-        public Task Import(params string[] paths) => scoreModelManager.Import(paths);
+        public Task Import(params string[] paths) => scoreImporter.Import(paths);
 
-        public Task Import(params ImportTask[] tasks) => scoreModelManager.Import(tasks);
+        public Task Import(params ImportTask[] tasks) => scoreImporter.Import(tasks);
 
-        public IEnumerable<string> HandledExtensions => scoreModelManager.HandledExtensions;
+        public IEnumerable<string> HandledExtensions => scoreImporter.HandledExtensions;
 
-        public Task<IEnumerable<Live<ScoreInfo>>> Import(ProgressNotification notification, params ImportTask[] tasks) => scoreModelManager.Import(notification, tasks);
+        public Task<IEnumerable<Live<ScoreInfo>>> Import(ProgressNotification notification, params ImportTask[] tasks) => scoreImporter.Import(notification, tasks);
 
-        public Live<ScoreInfo> Import(ScoreInfo item, ArchiveReader archive = null, bool batchImport = false, CancellationToken cancellationToken = default) => scoreModelManager.Import(item, archive, batchImport, cancellationToken);
+        public Live<ScoreInfo> Import(ScoreInfo item, ArchiveReader archive = null, bool batchImport = false, CancellationToken cancellationToken = default) => scoreImporter.Import(item, archive, batchImport, cancellationToken);
 
-        public bool IsAvailableLocally(ScoreInfo model) => scoreModelManager.IsAvailableLocally(model);
+        public bool IsAvailableLocally(ScoreInfo model) => scoreImporter.IsAvailableLocally(model);
 
         #endregion
 
@@ -290,7 +290,7 @@ namespace osu.Game.Scoring
 
         public Action<IEnumerable<Live<ScoreInfo>>> PostImport
         {
-            set => scoreModelManager.PostImport = value;
+            set => scoreImporter.PostImport = value;
         }
 
         #endregion
diff --git a/osu.Game/Skinning/SkinModelManager.cs b/osu.Game/Skinning/SkinImporter.cs
similarity index 98%
rename from osu.Game/Skinning/SkinModelManager.cs
rename to osu.Game/Skinning/SkinImporter.cs
index ca90f41080..67626a45a8 100644
--- a/osu.Game/Skinning/SkinModelManager.cs
+++ b/osu.Game/Skinning/SkinImporter.cs
@@ -20,13 +20,13 @@ using Realms;
 
 namespace osu.Game.Skinning
 {
-    public class SkinModelManager : RealmArchiveModelManager<SkinInfo>
+    public class SkinImporter : RealmArchiveModelManager<SkinInfo>
     {
         private const string skin_info_file = "skininfo.json";
 
         private readonly IStorageResourceProvider skinResources;
 
-        public SkinModelManager(Storage storage, RealmAccess realm, IStorageResourceProvider skinResources)
+        public SkinImporter(Storage storage, RealmAccess realm, IStorageResourceProvider skinResources)
             : base(storage, realm)
         {
             this.skinResources = skinResources;
diff --git a/osu.Game/Skinning/SkinManager.cs b/osu.Game/Skinning/SkinManager.cs
index f296386d34..f244657ea3 100644
--- a/osu.Game/Skinning/SkinManager.cs
+++ b/osu.Game/Skinning/SkinManager.cs
@@ -55,7 +55,7 @@ namespace osu.Game.Skinning
             Default = Skinning.DefaultSkin.CreateInfo().ToLiveUnmanaged()
         };
 
-        private readonly SkinModelManager skinModelManager;
+        private readonly SkinImporter skinImporter;
         private readonly RealmAccess realm;
 
         private readonly IResourceStore<byte[]> userFiles;
@@ -80,7 +80,7 @@ namespace osu.Game.Skinning
 
             userFiles = new StorageBackedResourceStore(storage.GetStorageForDirectory("files"));
 
-            skinModelManager = new SkinModelManager(storage, realm, this);
+            skinImporter = new SkinImporter(storage, realm, this);
 
             var defaultSkins = new[]
             {
@@ -166,7 +166,7 @@ namespace osu.Game.Skinning
                     Name = NamingUtils.GetNextBestName(existingSkinNames, $@"{s.Name} (modified)")
                 };
 
-                var result = skinModelManager.Import(skinInfo);
+                var result = skinImporter.Import(skinInfo);
 
                 if (result != null)
                 {
@@ -186,7 +186,7 @@ namespace osu.Game.Skinning
             if (!skin.SkinInfo.IsManaged)
                 throw new InvalidOperationException($"Attempting to save a skin which is not yet tracked. Call {nameof(EnsureMutableSkin)} first.");
 
-            skinModelManager.Save(skin);
+            skinImporter.Save(skin);
         }
 
         /// <summary>
@@ -260,26 +260,26 @@ namespace osu.Game.Skinning
 
         public Action<Notification> PostNotification
         {
-            set => skinModelManager.PostNotification = value;
+            set => skinImporter.PostNotification = value;
         }
 
         public Action<IEnumerable<Live<SkinInfo>>> PostImport
         {
-            set => skinModelManager.PostImport = value;
+            set => skinImporter.PostImport = value;
         }
 
-        public Task Import(params string[] paths) => skinModelManager.Import(paths);
+        public Task Import(params string[] paths) => skinImporter.Import(paths);
 
-        public Task Import(params ImportTask[] tasks) => skinModelManager.Import(tasks);
+        public Task Import(params ImportTask[] tasks) => skinImporter.Import(tasks);
 
-        public IEnumerable<string> HandledExtensions => skinModelManager.HandledExtensions;
+        public IEnumerable<string> HandledExtensions => skinImporter.HandledExtensions;
 
-        public Task<IEnumerable<Live<SkinInfo>>> Import(ProgressNotification notification, params ImportTask[] tasks) => skinModelManager.Import(notification, tasks);
+        public Task<IEnumerable<Live<SkinInfo>>> Import(ProgressNotification notification, params ImportTask[] tasks) => skinImporter.Import(notification, tasks);
 
-        public Task<Live<SkinInfo>> Import(ImportTask task, bool batchImport = false, CancellationToken cancellationToken = default) => skinModelManager.Import(task, batchImport, cancellationToken);
+        public Task<Live<SkinInfo>> Import(ImportTask task, bool batchImport = false, CancellationToken cancellationToken = default) => skinImporter.Import(task, batchImport, cancellationToken);
 
         public Task<Live<SkinInfo>> Import(ArchiveReader archive, bool batchImport = false, CancellationToken cancellationToken = default) =>
-            skinModelManager.Import(archive, batchImport, cancellationToken);
+            skinImporter.Import(archive, batchImport, cancellationToken);
 
         #endregion
 
@@ -300,25 +300,25 @@ namespace osu.Game.Skinning
                 if (items.Any(s => s.ID == currentUserSkin))
                     scheduler.Add(() => CurrentSkinInfo.Value = Skinning.DefaultSkin.CreateInfo().ToLiveUnmanaged());
 
-                skinModelManager.Delete(items.ToList(), silent);
+                skinImporter.Delete(items.ToList(), silent);
             });
         }
 
-        public bool Delete(SkinInfo item) => skinModelManager.Delete(item);
+        public bool Delete(SkinInfo item) => skinImporter.Delete(item);
 
-        public void Delete(List<SkinInfo> items, bool silent = false) => skinModelManager.Delete(items, silent);
+        public void Delete(List<SkinInfo> items, bool silent = false) => skinImporter.Delete(items, silent);
 
-        public void Undelete(List<SkinInfo> items, bool silent = false) => skinModelManager.Undelete(items, silent);
+        public void Undelete(List<SkinInfo> items, bool silent = false) => skinImporter.Undelete(items, silent);
 
-        public void Undelete(SkinInfo item) => skinModelManager.Undelete(item);
+        public void Undelete(SkinInfo item) => skinImporter.Undelete(item);
 
-        public bool IsAvailableLocally(SkinInfo model) => skinModelManager.IsAvailableLocally(model);
+        public bool IsAvailableLocally(SkinInfo model) => skinImporter.IsAvailableLocally(model);
 
-        public void ReplaceFile(SkinInfo model, RealmNamedFileUsage file, Stream contents) => skinModelManager.ReplaceFile(model, file, contents);
+        public void ReplaceFile(SkinInfo model, RealmNamedFileUsage file, Stream contents) => skinImporter.ReplaceFile(model, file, contents);
 
-        public void DeleteFile(SkinInfo model, RealmNamedFileUsage file) => skinModelManager.DeleteFile(model, file);
+        public void DeleteFile(SkinInfo model, RealmNamedFileUsage file) => skinImporter.DeleteFile(model, file);
 
-        public void AddFile(SkinInfo model, Stream contents, string filename) => skinModelManager.AddFile(model, contents, filename);
+        public void AddFile(SkinInfo model, Stream contents, string filename) => skinImporter.AddFile(model, contents, filename);
 
         #endregion
     }

From 04e4c5ef8867a043ce722e8067fa27d6fc629d80 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 16 Jun 2022 18:26:13 +0900
Subject: [PATCH 5496/5547] Move and adjust implementation regions to restore
 sanity

---
 osu.Game/Beatmaps/BeatmapManager.cs | 65 ++++++++++-------------------
 1 file changed, 23 insertions(+), 42 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index 63bd7dc710..a4ac161223 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -260,8 +260,6 @@ namespace osu.Game.Beatmaps
             return realm.Run(r => r.All<BeatmapSetInfo>().FirstOrDefault(query)?.ToLive(realm));
         }
 
-        #region Delegation to BeatmapImporter (methods which previously existed locally).
-
         /// <summary>
         /// Perform a lookup query on available <see cref="BeatmapInfo"/>s.
         /// </summary>
@@ -283,38 +281,6 @@ namespace osu.Game.Beatmaps
             set => beatmapImporter.PostNotification = value;
         }
 
-        #endregion
-
-        #region Implementation of IModelManager<BeatmapSetInfo>
-
-        public bool IsAvailableLocally(BeatmapSetInfo model)
-        {
-            return beatmapImporter.IsAvailableLocally(model);
-        }
-
-        public bool Delete(BeatmapSetInfo item)
-        {
-            return beatmapImporter.Delete(item);
-        }
-
-        public void Delete(List<BeatmapSetInfo> items, bool silent = false)
-        {
-            beatmapImporter.Delete(items, silent);
-        }
-
-        public void Delete(Expression<Func<BeatmapSetInfo, bool>>? filter = null, bool silent = false)
-        {
-            realm.Run(r =>
-            {
-                var items = r.All<BeatmapSetInfo>().Where(s => !s.DeletePending && !s.Protected);
-
-                if (filter != null)
-                    items = items.Where(filter);
-
-                beatmapImporter.Delete(items.ToList(), silent);
-            });
-        }
-
         /// <summary>
         /// Saves an <see cref="IBeatmap"/> file against a given <see cref="BeatmapInfo"/>.
         /// </summary>
@@ -381,6 +347,19 @@ namespace osu.Game.Beatmaps
             });
         }
 
+        public void Delete(Expression<Func<BeatmapSetInfo, bool>>? filter = null, bool silent = false)
+        {
+            realm.Run(r =>
+            {
+                var items = r.All<BeatmapSetInfo>().Where(s => !s.DeletePending && !s.Protected);
+
+                if (filter != null)
+                    items = items.Where(filter);
+
+                beatmapImporter.Delete(items.ToList(), silent);
+            });
+        }
+
         /// <summary>
         /// Delete videos from a list of beatmaps.
         /// This will post notifications tracking progress.
@@ -431,15 +410,17 @@ namespace osu.Game.Beatmaps
             realm.Run(r => beatmapImporter.Undelete(r.All<BeatmapSetInfo>().Where(s => s.DeletePending).ToList()));
         }
 
-        public void Undelete(List<BeatmapSetInfo> items, bool silent = false)
-        {
-            beatmapImporter.Undelete(items, silent);
-        }
+        #region Implementation of IModelManager<BeatmapSetInfo>
 
-        public void Undelete(BeatmapSetInfo item)
-        {
-            beatmapImporter.Undelete(item);
-        }
+        public bool IsAvailableLocally(BeatmapSetInfo model) => beatmapImporter.IsAvailableLocally(model);
+
+        public bool Delete(BeatmapSetInfo item) => beatmapImporter.Delete(item);
+
+        public void Delete(List<BeatmapSetInfo> items, bool silent = false) => beatmapImporter.Delete(items, silent);
+
+        public void Undelete(List<BeatmapSetInfo> items, bool silent = false) => beatmapImporter.Undelete(items, silent);
+
+        public void Undelete(BeatmapSetInfo item) => beatmapImporter.Undelete(item);
 
         #endregion
 

From 8a5755ca527965acbf913611ddb464992d204f88 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 16 Jun 2022 18:27:16 +0900
Subject: [PATCH 5497/5547] Remove pointless override in test implementation

---
 osu.Game/Tests/Visual/EditorTestScene.cs | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/osu.Game/Tests/Visual/EditorTestScene.cs b/osu.Game/Tests/Visual/EditorTestScene.cs
index fbb5209513..d4a624f26a 100644
--- a/osu.Game/Tests/Visual/EditorTestScene.cs
+++ b/osu.Game/Tests/Visual/EditorTestScene.cs
@@ -145,11 +145,6 @@ namespace osu.Game.Tests.Visual
             {
             }
 
-            protected override BeatmapImporter CreateBeatmapImporter(Storage storage, RealmAccess realm, RulesetStore rulesets, BeatmapOnlineLookupQueue onlineLookupQueue)
-            {
-                return new BeatmapImporter(realm, storage, onlineLookupQueue);
-            }
-
             protected override WorkingBeatmapCache CreateWorkingBeatmapCache(AudioManager audioManager, IResourceStore<byte[]> resources, IResourceStore<byte[]> storage, WorkingBeatmap defaultBeatmap, GameHost host)
             {
                 return new TestWorkingBeatmapCache(this, audioManager, resources, storage, defaultBeatmap, host);

From f3984d98e654fdf93d011d795672270b9f7692b0 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 16 Jun 2022 18:53:13 +0900
Subject: [PATCH 5498/5547] Remove `RealmArchiveModelManager` from hierarchy

---
 .../Database/BeatmapImporterTests.cs          | 56 ++++++++++---------
 ...eneOnlinePlayBeatmapAvailabilityTracker.cs |  2 +-
 osu.Game/Beatmaps/BeatmapImporter.cs          |  9 +--
 osu.Game/Beatmaps/BeatmapManager.cs           | 51 ++---------------
 osu.Game/Database/ImportTask.cs               |  2 +-
 osu.Game/Database/RealmArchiveModelManager.cs | 22 ++++----
 osu.Game/Scoring/ScoreImporter.cs             |  7 +--
 osu.Game/Scoring/ScoreManager.cs              | 33 ++---------
 osu.Game/Skinning/SkinImporter.cs             | 20 ++++---
 osu.Game/Skinning/SkinManager.cs              | 32 +----------
 10 files changed, 69 insertions(+), 165 deletions(-)

diff --git a/osu.Game.Tests/Database/BeatmapImporterTests.cs b/osu.Game.Tests/Database/BeatmapImporterTests.cs
index 03e388c821..53d13f0d4e 100644
--- a/osu.Game.Tests/Database/BeatmapImporterTests.cs
+++ b/osu.Game.Tests/Database/BeatmapImporterTests.cs
@@ -38,7 +38,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealmAsync(async (realm, storage) =>
             {
-                using (var importer = new BeatmapImporter(realm, storage))
+                using (var importer = new BeatmapImporter(storage, realm))
                 using (new RealmRulesetStore(realm, storage))
                 {
                     Live<BeatmapSetInfo>? beatmapSet;
@@ -82,7 +82,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealmAsync(async (realm, storage) =>
             {
-                using (var importer = new BeatmapImporter(realm, storage))
+                using (var importer = new BeatmapImporter(storage, realm))
                 using (new RealmRulesetStore(realm, storage))
                 {
                     Live<BeatmapSetInfo>? beatmapSet;
@@ -141,7 +141,9 @@ namespace osu.Game.Tests.Database
             {
                 BeatmapSetInfo? detachedSet = null;
 
-                using (var importer = new BeatmapImporter(realm, storage))
+                var manager = new ModelManager<BeatmapSetInfo>(storage, realm);
+
+                using (var importer = new BeatmapImporter(storage, realm))
                 using (new RealmRulesetStore(realm, storage))
                 {
                     Task.Run(async () =>
@@ -160,7 +162,7 @@ namespace osu.Game.Tests.Database
                     }).WaitSafely();
 
                     Debug.Assert(detachedSet != null);
-                    importer.AddFile(detachedSet, new MemoryStream(), "test");
+                    manager.AddFile(detachedSet, new MemoryStream(), "test");
                 }
             });
         }
@@ -170,7 +172,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealmAsync(async (realm, storage) =>
             {
-                using (var importer = new BeatmapImporter(realm, storage))
+                using (var importer = new BeatmapImporter(storage, realm))
                 using (new RealmRulesetStore(realm, storage))
                 {
                     Live<BeatmapSetInfo>? imported;
@@ -202,7 +204,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealmAsync(async (realm, storage) =>
             {
-                using var importer = new BeatmapImporter(realm, storage);
+                using var importer = new BeatmapImporter(storage, realm);
                 using var store = new RealmRulesetStore(realm, storage);
 
                 await LoadOszIntoStore(importer, realm.Realm);
@@ -214,7 +216,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealmAsync(async (realm, storage) =>
             {
-                using var importer = new BeatmapImporter(realm, storage);
+                using var importer = new BeatmapImporter(storage, realm);
                 using var store = new RealmRulesetStore(realm, storage);
 
                 var imported = await LoadOszIntoStore(importer, realm.Realm);
@@ -232,7 +234,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealmAsync(async (realm, storage) =>
             {
-                using var importer = new BeatmapImporter(realm, storage);
+                using var importer = new BeatmapImporter(storage, realm);
                 using var store = new RealmRulesetStore(realm, storage);
 
                 var imported = await LoadOszIntoStore(importer, realm.Realm);
@@ -246,7 +248,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealmAsync(async (realm, storage) =>
             {
-                using var importer = new BeatmapImporter(realm, storage);
+                using var importer = new BeatmapImporter(storage, realm);
                 using var store = new RealmRulesetStore(realm, storage);
 
                 string? tempPath = TestResources.GetTestBeatmapForImport();
@@ -276,7 +278,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealmAsync(async (realm, storage) =>
             {
-                using var importer = new BeatmapImporter(realm, storage);
+                using var importer = new BeatmapImporter(storage, realm);
                 using var store = new RealmRulesetStore(realm, storage);
 
                 var imported = await LoadOszIntoStore(importer, realm.Realm);
@@ -296,7 +298,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealmAsync(async (realm, storage) =>
             {
-                using var importer = new BeatmapImporter(realm, storage);
+                using var importer = new BeatmapImporter(storage, realm);
                 using var store = new RealmRulesetStore(realm, storage);
 
                 string? temp = TestResources.GetTestBeatmapForImport();
@@ -345,7 +347,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealmAsync(async (realm, storage) =>
             {
-                using var importer = new BeatmapImporter(realm, storage);
+                using var importer = new BeatmapImporter(storage, realm);
                 using var store = new RealmRulesetStore(realm, storage);
 
                 string? temp = TestResources.GetTestBeatmapForImport();
@@ -396,7 +398,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealmAsync(async (realm, storage) =>
             {
-                using var importer = new BeatmapImporter(realm, storage);
+                using var importer = new BeatmapImporter(storage, realm);
                 using var store = new RealmRulesetStore(realm, storage);
 
                 string? temp = TestResources.GetTestBeatmapForImport();
@@ -444,7 +446,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealmAsync(async (realm, storage) =>
             {
-                using var importer = new BeatmapImporter(realm, storage);
+                using var importer = new BeatmapImporter(storage, realm);
                 using var store = new RealmRulesetStore(realm, storage);
 
                 string? temp = TestResources.GetTestBeatmapForImport();
@@ -492,7 +494,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealmAsync(async (realm, storage) =>
             {
-                using var importer = new BeatmapImporter(realm, storage);
+                using var importer = new BeatmapImporter(storage, realm);
                 using var store = new RealmRulesetStore(realm, storage);
 
                 var imported = await LoadOszIntoStore(importer, realm.Realm);
@@ -527,7 +529,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealmAsync(async (realm, storage) =>
             {
-                using var importer = new BeatmapImporter(realm, storage);
+                using var importer = new BeatmapImporter(storage, realm);
                 using var store = new RealmRulesetStore(realm, storage);
 
                 var progressNotification = new ImportProgressNotification();
@@ -565,7 +567,7 @@ namespace osu.Game.Tests.Database
                         Interlocked.Increment(ref loggedExceptionCount);
                 };
 
-                using var importer = new BeatmapImporter(realm, storage);
+                using var importer = new BeatmapImporter(storage, realm);
                 using var store = new RealmRulesetStore(realm, storage);
 
                 var imported = await LoadOszIntoStore(importer, realm.Realm);
@@ -617,7 +619,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealmAsync(async (realm, storage) =>
             {
-                using var importer = new BeatmapImporter(realm, storage);
+                using var importer = new BeatmapImporter(storage, realm);
                 using var store = new RealmRulesetStore(realm, storage);
 
                 var imported = await LoadOszIntoStore(importer, realm.Realm, batchImport: true);
@@ -644,7 +646,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealmAsync(async (realmFactory, storage) =>
             {
-                using var importer = new BeatmapImporter(realmFactory, storage);
+                using var importer = new BeatmapImporter(storage, realmFactory);
                 using var store = new RealmRulesetStore(realmFactory, storage);
 
                 var imported = await LoadOszIntoStore(importer, realmFactory.Realm);
@@ -676,7 +678,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealmAsync(async (realm, storage) =>
             {
-                using var importer = new BeatmapImporter(realm, storage);
+                using var importer = new BeatmapImporter(storage, realm);
                 using var store = new RealmRulesetStore(realm, storage);
 
                 var imported = await LoadOszIntoStore(importer, realm.Realm);
@@ -703,7 +705,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealmAsync(async (realm, storage) =>
             {
-                using var importer = new BeatmapImporter(realm, storage);
+                using var importer = new BeatmapImporter(storage, realm);
                 using var store = new RealmRulesetStore(realm, storage);
 
                 var imported = await LoadOszIntoStore(importer, realm.Realm);
@@ -729,7 +731,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealm((realm, storage) =>
             {
-                using var importer = new BeatmapImporter(realm, storage);
+                using var importer = new BeatmapImporter(storage, realm);
                 using var store = new RealmRulesetStore(realm, storage);
 
                 var metadata = new BeatmapMetadata
@@ -777,7 +779,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealmAsync(async (realm, storage) =>
             {
-                using var importer = new BeatmapImporter(realm, storage);
+                using var importer = new BeatmapImporter(storage, realm);
                 using var store = new RealmRulesetStore(realm, storage);
 
                 string? temp = TestResources.GetTestBeatmapForImport();
@@ -794,7 +796,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealmAsync(async (realm, storage) =>
             {
-                using var importer = new BeatmapImporter(realm, storage);
+                using var importer = new BeatmapImporter(storage, realm);
                 using var store = new RealmRulesetStore(realm, storage);
 
                 string? temp = TestResources.GetTestBeatmapForImport();
@@ -830,7 +832,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealmAsync(async (realm, storage) =>
             {
-                using var importer = new BeatmapImporter(realm, storage);
+                using var importer = new BeatmapImporter(storage, realm);
                 using var store = new RealmRulesetStore(realm, storage);
 
                 string? temp = TestResources.GetTestBeatmapForImport();
@@ -872,7 +874,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealmAsync(async (realm, storage) =>
             {
-                using var importer = new BeatmapImporter(realm, storage);
+                using var importer = new BeatmapImporter(storage, realm);
                 using var store = new RealmRulesetStore(realm, storage);
 
                 string? temp = TestResources.GetTestBeatmapForImport();
@@ -923,7 +925,7 @@ namespace osu.Game.Tests.Database
         {
             RunTestWithRealmAsync(async (realm, storage) =>
             {
-                using var importer = new BeatmapImporter(realm, storage);
+                using var importer = new BeatmapImporter(storage, realm);
                 using var store = new RealmRulesetStore(realm, storage);
 
                 string? temp = TestResources.GetTestBeatmapForImport();
diff --git a/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs b/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
index 915ad50d2b..c26d7937ad 100644
--- a/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
+++ b/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
@@ -220,7 +220,7 @@ namespace osu.Game.Tests.Online
                 private readonly TestBeatmapManager testBeatmapManager;
 
                 public TestBeatmapImporter(TestBeatmapManager testBeatmapManager, Storage storage, RealmAccess databaseAccess, BeatmapOnlineLookupQueue beatmapOnlineLookupQueue)
-                    : base(databaseAccess, storage, beatmapOnlineLookupQueue)
+                    : base(storage, databaseAccess, beatmapOnlineLookupQueue)
                 {
                     this.testBeatmapManager = testBeatmapManager;
                 }
diff --git a/osu.Game/Beatmaps/BeatmapImporter.cs b/osu.Game/Beatmaps/BeatmapImporter.cs
index eded4cf9d1..5e3aa434b8 100644
--- a/osu.Game/Beatmaps/BeatmapImporter.cs
+++ b/osu.Game/Beatmaps/BeatmapImporter.cs
@@ -32,7 +32,7 @@ namespace osu.Game.Beatmaps
     /// Handles the storage and retrieval of Beatmaps/WorkingBeatmaps.
     /// </summary>
     [ExcludeFromDynamicCompile]
-    public class BeatmapImporter : RealmArchiveModelManager<BeatmapSetInfo>, IDisposable
+    public class BeatmapImporter : RealmArchiveModelImporter<BeatmapSetInfo>, IDisposable
     {
         public override IEnumerable<string> HandledExtensions => new[] { ".osz" };
 
@@ -40,7 +40,7 @@ namespace osu.Game.Beatmaps
 
         private readonly BeatmapOnlineLookupQueue? onlineLookupQueue;
 
-        public BeatmapImporter(RealmAccess realm, Storage storage, BeatmapOnlineLookupQueue? onlineLookupQueue = null)
+        public BeatmapImporter(Storage storage, RealmAccess realm, BeatmapOnlineLookupQueue? onlineLookupQueue = null)
             : base(storage, realm)
         {
             this.onlineLookupQueue = onlineLookupQueue;
@@ -165,11 +165,6 @@ namespace osu.Game.Beatmaps
             existing.DateAdded = DateTimeOffset.UtcNow;
         }
 
-        public override bool IsAvailableLocally(BeatmapSetInfo model)
-        {
-            return Realm.Run(realm => realm.All<BeatmapSetInfo>().Any(s => s.OnlineID == model.OnlineID));
-        }
-
         public override string HumanisedModelName => "beatmap";
 
         protected override BeatmapSetInfo? CreateModel(ArchiveReader reader)
diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index a4ac161223..662931cd17 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -36,7 +36,7 @@ namespace osu.Game.Beatmaps
     /// Handles general operations related to global beatmap management.
     /// </summary>
     [ExcludeFromDynamicCompile]
-    public class BeatmapManager : IModelManager<BeatmapSetInfo>, IModelFileManager<BeatmapSetInfo, RealmNamedFileUsage>, IModelImporter<BeatmapSetInfo>, IWorkingBeatmapCache, IDisposable
+    public class BeatmapManager : ModelManager<BeatmapSetInfo>, IModelImporter<BeatmapSetInfo>, IWorkingBeatmapCache, IDisposable
     {
         public ITrackStore BeatmapTrackStore { get; }
 
@@ -49,6 +49,7 @@ namespace osu.Game.Beatmaps
 
         public BeatmapManager(Storage storage, RealmAccess realm, RulesetStore rulesets, IAPIProvider? api, AudioManager audioManager, IResourceStore<byte[]> gameResources, GameHost? host = null,
                               WorkingBeatmap? defaultBeatmap = null, bool performOnlineLookups = false)
+            : base(storage, realm)
         {
             this.realm = realm;
 
@@ -75,7 +76,7 @@ namespace osu.Game.Beatmaps
         }
 
         protected virtual BeatmapImporter CreateBeatmapImporter(Storage storage, RealmAccess realm, RulesetStore rulesets, BeatmapOnlineLookupQueue? onlineLookupQueue) =>
-            new BeatmapImporter(realm, storage, onlineLookupQueue);
+            new BeatmapImporter(storage, realm, onlineLookupQueue);
 
         /// <summary>
         /// Create a new beatmap set, backed by a <see cref="BeatmapSetInfo"/> model,
@@ -272,15 +273,6 @@ namespace osu.Game.Beatmaps
         /// </summary>
         public IWorkingBeatmap DefaultBeatmap => workingBeatmapCache.DefaultBeatmap;
 
-        /// <summary>
-        /// Fired when a notification should be presented to the user.
-        /// </summary>
-        public Action<Notification>? PostNotification
-        {
-            get => beatmapImporter.PostNotification;
-            set => beatmapImporter.PostNotification = value;
-        }
-
         /// <summary>
         /// Saves an <see cref="IBeatmap"/> file against a given <see cref="BeatmapInfo"/>.
         /// </summary>
@@ -356,7 +348,7 @@ namespace osu.Game.Beatmaps
                 if (filter != null)
                     items = items.Where(filter);
 
-                beatmapImporter.Delete(items.ToList(), silent);
+                Delete(items.ToList(), silent);
             });
         }
 
@@ -407,23 +399,9 @@ namespace osu.Game.Beatmaps
 
         public void UndeleteAll()
         {
-            realm.Run(r => beatmapImporter.Undelete(r.All<BeatmapSetInfo>().Where(s => s.DeletePending).ToList()));
+            realm.Run(r => Undelete(r.All<BeatmapSetInfo>().Where(s => s.DeletePending).ToList()));
         }
 
-        #region Implementation of IModelManager<BeatmapSetInfo>
-
-        public bool IsAvailableLocally(BeatmapSetInfo model) => beatmapImporter.IsAvailableLocally(model);
-
-        public bool Delete(BeatmapSetInfo item) => beatmapImporter.Delete(item);
-
-        public void Delete(List<BeatmapSetInfo> items, bool silent = false) => beatmapImporter.Delete(items, silent);
-
-        public void Undelete(List<BeatmapSetInfo> items, bool silent = false) => beatmapImporter.Undelete(items, silent);
-
-        public void Undelete(BeatmapSetInfo item) => beatmapImporter.Undelete(item);
-
-        #endregion
-
         #region Implementation of ICanAcceptFiles
 
         public Task Import(params string[] paths) => beatmapImporter.Import(paths);
@@ -479,25 +457,6 @@ namespace osu.Game.Beatmaps
 
         #endregion
 
-        #region Implementation of IModelFileManager<in BeatmapSetInfo,in BeatmapSetFileInfo>
-
-        public void ReplaceFile(BeatmapSetInfo model, RealmNamedFileUsage file, Stream contents)
-        {
-            beatmapImporter.ReplaceFile(model, file, contents);
-        }
-
-        public void DeleteFile(BeatmapSetInfo model, RealmNamedFileUsage file)
-        {
-            beatmapImporter.DeleteFile(model, file);
-        }
-
-        public void AddFile(BeatmapSetInfo model, Stream contents, string filename)
-        {
-            beatmapImporter.AddFile(model, contents, filename);
-        }
-
-        #endregion
-
         #region Implementation of IDisposable
 
         public void Dispose()
diff --git a/osu.Game/Database/ImportTask.cs b/osu.Game/Database/ImportTask.cs
index 41ce0339a1..e34b4c76a9 100644
--- a/osu.Game/Database/ImportTask.cs
+++ b/osu.Game/Database/ImportTask.cs
@@ -12,7 +12,7 @@ using SharpCompress.Common;
 namespace osu.Game.Database
 {
     /// <summary>
-    /// An encapsulated import task to be imported to an <see cref="RealmArchiveModelManager{TModel}"/>.
+    /// An encapsulated import task to be imported to an <see cref="RealmArchiveModelImporter{TModel}"/>.
     /// </summary>
     public class ImportTask
     {
diff --git a/osu.Game/Database/RealmArchiveModelManager.cs b/osu.Game/Database/RealmArchiveModelManager.cs
index 371b9be575..5056b0d49f 100644
--- a/osu.Game/Database/RealmArchiveModelManager.cs
+++ b/osu.Game/Database/RealmArchiveModelManager.cs
@@ -15,18 +15,17 @@ using Realms;
 
 namespace osu.Game.Database
 {
-    /// <summary>
-    /// Class which adds all the missing pieces bridging the gap between <see cref="RealmArchiveModelImporter{TModel}"/> and (legacy) ArchiveModelManager.
-    /// </summary>
-    public abstract class RealmArchiveModelManager<TModel> : RealmArchiveModelImporter<TModel>, IModelManager<TModel>, IModelFileManager<TModel, RealmNamedFileUsage>
+    public class ModelManager<TModel> : IModelManager<TModel>, IModelFileManager<TModel, RealmNamedFileUsage>
         where TModel : RealmObject, IHasRealmFiles, IHasGuidPrimaryKey, ISoftDelete
     {
+        protected RealmAccess Realm;
+
         private readonly RealmFileStore realmFileStore;
 
-        protected RealmArchiveModelManager(Storage storage, RealmAccess realm)
-            : base(storage, realm)
+        public ModelManager(Storage storage, RealmAccess realm)
         {
             realmFileStore = new RealmFileStore(realm, storage);
+            Realm = realm;
         }
 
         public void DeleteFile(TModel item, RealmNamedFileUsage file) =>
@@ -62,7 +61,7 @@ namespace osu.Game.Database
         /// <summary>
         /// Delete a file from within an ongoing realm transaction.
         /// </summary>
-        protected void DeleteFile(TModel item, RealmNamedFileUsage file, Realm realm)
+        public void DeleteFile(TModel item, RealmNamedFileUsage file, Realm realm)
         {
             item.Files.Remove(file);
         }
@@ -70,7 +69,7 @@ namespace osu.Game.Database
         /// <summary>
         /// Replace a file from within an ongoing realm transaction.
         /// </summary>
-        protected void ReplaceFile(RealmNamedFileUsage file, Stream contents, Realm realm)
+        public void ReplaceFile(RealmNamedFileUsage file, Stream contents, Realm realm)
         {
             file.File = realmFileStore.Add(contents, realm);
         }
@@ -78,7 +77,7 @@ namespace osu.Game.Database
         /// <summary>
         /// Add a file from within an ongoing realm transaction. If the file already exists, it is overwritten.
         /// </summary>
-        protected void AddFile(TModel item, Stream contents, string filename, Realm realm)
+        public void AddFile(TModel item, Stream contents, string filename, Realm realm)
         {
             var existing = item.Files.FirstOrDefault(f => string.Equals(f.Filename, filename, StringComparison.OrdinalIgnoreCase));
 
@@ -200,6 +199,9 @@ namespace osu.Game.Database
             });
         }
 
-        public abstract bool IsAvailableLocally(TModel model);
+        // TODO: implement
+        public virtual bool IsAvailableLocally(TModel model) => true;
+        public Action<Notification>? PostNotification { get; set; }
+        public string HumanisedModelName { get; set; } = "wang";
     }
 }
diff --git a/osu.Game/Scoring/ScoreImporter.cs b/osu.Game/Scoring/ScoreImporter.cs
index 76c43ba2e2..7d1aa4b01d 100644
--- a/osu.Game/Scoring/ScoreImporter.cs
+++ b/osu.Game/Scoring/ScoreImporter.cs
@@ -19,7 +19,7 @@ using Realms;
 
 namespace osu.Game.Scoring
 {
-    public class ScoreImporter : RealmArchiveModelManager<ScoreInfo>
+    public class ScoreImporter : RealmArchiveModelImporter<ScoreInfo>
     {
         public override IEnumerable<string> HandledExtensions => new[] { ".osr" };
 
@@ -70,10 +70,5 @@ namespace osu.Game.Scoring
             if (string.IsNullOrEmpty(model.StatisticsJson))
                 model.StatisticsJson = JsonConvert.SerializeObject(model.Statistics);
         }
-
-        public override bool IsAvailableLocally(ScoreInfo model)
-        {
-            return Realm.Run(realm => realm.All<ScoreInfo>().Any(s => s.OnlineID == model.OnlineID));
-        }
     }
 }
diff --git a/osu.Game/Scoring/ScoreManager.cs b/osu.Game/Scoring/ScoreManager.cs
index 125746d5dd..da77b0bc6c 100644
--- a/osu.Game/Scoring/ScoreManager.cs
+++ b/osu.Game/Scoring/ScoreManager.cs
@@ -22,7 +22,7 @@ using osu.Game.Rulesets.Scoring;
 
 namespace osu.Game.Scoring
 {
-    public class ScoreManager : IModelManager<ScoreInfo>, IModelImporter<ScoreInfo>
+    public class ScoreManager : ModelManager<ScoreInfo>, IModelImporter<ScoreInfo>
     {
         private readonly RealmAccess realm;
         private readonly Scheduler scheduler;
@@ -32,6 +32,7 @@ namespace osu.Game.Scoring
 
         public ScoreManager(RulesetStore rulesets, Func<BeatmapManager> beatmaps, Storage storage, RealmAccess realm, Scheduler scheduler,
                             Func<BeatmapDifficultyCache> difficulties = null, OsuConfigManager configManager = null)
+            : base(storage, realm)
         {
             this.realm = realm;
             this.scheduler = scheduler;
@@ -227,22 +228,6 @@ namespace osu.Game.Scoring
             }
         }
 
-        #region Implementation of IPostNotifications
-
-        public Action<Notification> PostNotification
-        {
-            set => scoreImporter.PostNotification = value;
-        }
-
-        #endregion
-
-        #region Implementation of IModelManager<ScoreInfo>
-
-        public bool Delete(ScoreInfo item)
-        {
-            return scoreImporter.Delete(item);
-        }
-
         public void Delete([CanBeNull] Expression<Func<ScoreInfo, bool>> filter = null, bool silent = false)
         {
             realm.Run(r =>
@@ -253,7 +238,7 @@ namespace osu.Game.Scoring
                 if (filter != null)
                     items = items.Where(filter);
 
-                scoreImporter.Delete(items.ToList(), silent);
+                Delete(items.ToList(), silent);
             });
         }
 
@@ -262,16 +247,10 @@ namespace osu.Game.Scoring
             realm.Run(r =>
             {
                 var beatmapScores = r.Find<BeatmapInfo>(beatmap.ID).Scores.ToList();
-                scoreImporter.Delete(beatmapScores, silent);
+                Delete(beatmapScores, silent);
             });
         }
 
-        public void Delete(List<ScoreInfo> items, bool silent = false) => scoreImporter.Delete(items, silent);
-
-        public void Undelete(List<ScoreInfo> items, bool silent = false) => scoreImporter.Undelete(items, silent);
-
-        public void Undelete(ScoreInfo item) => scoreImporter.Undelete(item);
-
         public Task Import(params string[] paths) => scoreImporter.Import(paths);
 
         public Task Import(params ImportTask[] tasks) => scoreImporter.Import(tasks);
@@ -282,10 +261,6 @@ namespace osu.Game.Scoring
 
         public Live<ScoreInfo> Import(ScoreInfo item, ArchiveReader archive = null, bool batchImport = false, CancellationToken cancellationToken = default) => scoreImporter.Import(item, archive, batchImport, cancellationToken);
 
-        public bool IsAvailableLocally(ScoreInfo model) => scoreImporter.IsAvailableLocally(model);
-
-        #endregion
-
         #region Implementation of IPresentImports<ScoreInfo>
 
         public Action<IEnumerable<Live<ScoreInfo>>> PostImport
diff --git a/osu.Game/Skinning/SkinImporter.cs b/osu.Game/Skinning/SkinImporter.cs
index 67626a45a8..7b82655dca 100644
--- a/osu.Game/Skinning/SkinImporter.cs
+++ b/osu.Game/Skinning/SkinImporter.cs
@@ -20,17 +20,21 @@ using Realms;
 
 namespace osu.Game.Skinning
 {
-    public class SkinImporter : RealmArchiveModelManager<SkinInfo>
+    public class SkinImporter : RealmArchiveModelImporter<SkinInfo>
     {
         private const string skin_info_file = "skininfo.json";
 
         private readonly IStorageResourceProvider skinResources;
 
+        private readonly ModelManager<SkinInfo> modelManager;
+
         public SkinImporter(Storage storage, RealmAccess realm, IStorageResourceProvider skinResources)
             : base(storage, realm)
         {
             this.skinResources = skinResources;
 
+            modelManager = new ModelManager<SkinInfo>(storage, realm);
+
             // can be removed 20220420.
             populateMissingHashes();
         }
@@ -154,7 +158,7 @@ namespace osu.Game.Skinning
                             sw.WriteLine(line);
                     }
 
-                    ReplaceFile(existingFile, stream, realm);
+                    modelManager.ReplaceFile(existingFile, stream, realm);
 
                     // can be removed 20220502.
                     if (!ensureIniWasUpdated(item))
@@ -184,7 +188,7 @@ namespace osu.Game.Skinning
                             sw.WriteLine(line);
                     }
 
-                    AddFile(item, stream, @"skin.ini", realm);
+                    modelManager.AddFile(item, stream, @"skin.ini", realm);
                 }
 
                 item.Hash = ComputeHash(item);
@@ -216,7 +220,7 @@ namespace osu.Game.Skinning
                     }
                     catch (Exception e)
                     {
-                        Delete(skin);
+                        modelManager.Delete(skin);
                         Logger.Error(e, $"Existing skin {skin} has been deleted during hash recomputation due to being invalid");
                     }
                 }
@@ -234,7 +238,7 @@ namespace osu.Game.Skinning
 
                 using (var streamContent = new MemoryStream(Encoding.UTF8.GetBytes(skinInfoJson)))
                 {
-                    AddFile(s, streamContent, skin_info_file, s.Realm);
+                    modelManager.AddFile(s, streamContent, skin_info_file, s.Realm);
                 }
 
                 // Then serialise each of the drawable component groups into respective files.
@@ -249,16 +253,14 @@ namespace osu.Game.Skinning
                         var oldFile = s.Files.FirstOrDefault(f => f.Filename == filename);
 
                         if (oldFile != null)
-                            ReplaceFile(oldFile, streamContent, s.Realm);
+                            modelManager.ReplaceFile(oldFile, streamContent, s.Realm);
                         else
-                            AddFile(s, streamContent, filename, s.Realm);
+                            modelManager.AddFile(s, streamContent, filename, s.Realm);
                     }
                 }
 
                 s.Hash = ComputeHash(s);
             });
         }
-
-        public override bool IsAvailableLocally(SkinInfo model) => true; // skins do not have online download support yet.
     }
 }
diff --git a/osu.Game/Skinning/SkinManager.cs b/osu.Game/Skinning/SkinManager.cs
index f244657ea3..491de0c152 100644
--- a/osu.Game/Skinning/SkinManager.cs
+++ b/osu.Game/Skinning/SkinManager.cs
@@ -3,7 +3,6 @@
 
 using System;
 using System.Collections.Generic;
-using System.IO;
 using System.Linq;
 using System.Linq.Expressions;
 using System.Threading;
@@ -24,7 +23,6 @@ using osu.Game.Audio;
 using osu.Game.Database;
 using osu.Game.IO;
 using osu.Game.IO.Archives;
-using osu.Game.Models;
 using osu.Game.Overlays.Notifications;
 using osu.Game.Utils;
 
@@ -38,7 +36,7 @@ namespace osu.Game.Skinning
     /// For gameplay components, see <see cref="RulesetSkinProvidingContainer"/> which adds extra legacy and toggle logic that may affect the lookup process.
     /// </remarks>
     [ExcludeFromDynamicCompile]
-    public class SkinManager : ISkinSource, IStorageResourceProvider, IModelImporter<SkinInfo>, IModelManager<SkinInfo>, IModelFileManager<SkinInfo, RealmNamedFileUsage>
+    public class SkinManager : ModelManager<SkinInfo>, ISkinSource, IStorageResourceProvider, IModelImporter<SkinInfo>
     {
         private readonly AudioManager audio;
 
@@ -71,6 +69,7 @@ namespace osu.Game.Skinning
         public Skin DefaultLegacySkin { get; }
 
         public SkinManager(Storage storage, RealmAccess realm, GameHost host, IResourceStore<byte[]> resources, AudioManager audio, Scheduler scheduler)
+            : base(storage, realm)
         {
             this.realm = realm;
             this.audio = audio;
@@ -258,11 +257,6 @@ namespace osu.Game.Skinning
 
         #region Implementation of IModelImporter<SkinInfo>
 
-        public Action<Notification> PostNotification
-        {
-            set => skinImporter.PostNotification = value;
-        }
-
         public Action<IEnumerable<Live<SkinInfo>>> PostImport
         {
             set => skinImporter.PostImport = value;
@@ -283,8 +277,6 @@ namespace osu.Game.Skinning
 
         #endregion
 
-        #region Implementation of IModelManager<SkinInfo>
-
         public void Delete([CanBeNull] Expression<Func<SkinInfo, bool>> filter = null, bool silent = false)
         {
             realm.Run(r =>
@@ -300,26 +292,8 @@ namespace osu.Game.Skinning
                 if (items.Any(s => s.ID == currentUserSkin))
                     scheduler.Add(() => CurrentSkinInfo.Value = Skinning.DefaultSkin.CreateInfo().ToLiveUnmanaged());
 
-                skinImporter.Delete(items.ToList(), silent);
+                Delete(items.ToList(), silent);
             });
         }
-
-        public bool Delete(SkinInfo item) => skinImporter.Delete(item);
-
-        public void Delete(List<SkinInfo> items, bool silent = false) => skinImporter.Delete(items, silent);
-
-        public void Undelete(List<SkinInfo> items, bool silent = false) => skinImporter.Undelete(items, silent);
-
-        public void Undelete(SkinInfo item) => skinImporter.Undelete(item);
-
-        public bool IsAvailableLocally(SkinInfo model) => skinImporter.IsAvailableLocally(model);
-
-        public void ReplaceFile(SkinInfo model, RealmNamedFileUsage file, Stream contents) => skinImporter.ReplaceFile(model, file, contents);
-
-        public void DeleteFile(SkinInfo model, RealmNamedFileUsage file) => skinImporter.DeleteFile(model, file);
-
-        public void AddFile(SkinInfo model, Stream contents, string filename) => skinImporter.AddFile(model, contents, filename);
-
-        #endregion
     }
 }

From 72c5b9009d6743a4aab0666a5ef919d21e91ccaa Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 16 Jun 2022 18:56:53 +0900
Subject: [PATCH 5499/5547] Remove local `realm` fields in manager classes

---
 osu.Game/Beatmaps/BeatmapManager.cs           | 26 ++++++++-----------
 osu.Game/Database/RealmArchiveModelManager.cs |  2 +-
 osu.Game/Scoring/ScoreManager.cs              |  8 +++---
 osu.Game/Skinning/SkinManager.cs              | 14 +++++-----
 4 files changed, 21 insertions(+), 29 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index 662931cd17..33e8cea380 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -45,14 +45,10 @@ namespace osu.Game.Beatmaps
         private readonly WorkingBeatmapCache workingBeatmapCache;
         private readonly BeatmapOnlineLookupQueue? onlineBeatmapLookupQueue;
 
-        private readonly RealmAccess realm;
-
         public BeatmapManager(Storage storage, RealmAccess realm, RulesetStore rulesets, IAPIProvider? api, AudioManager audioManager, IResourceStore<byte[]> gameResources, GameHost? host = null,
                               WorkingBeatmap? defaultBeatmap = null, bool performOnlineLookups = false)
             : base(storage, realm)
         {
-            this.realm = realm;
-
             if (performOnlineLookups)
             {
                 if (api == null)
@@ -192,7 +188,7 @@ namespace osu.Game.Beatmaps
         /// <param name="beatmapInfo">The beatmap difficulty to hide.</param>
         public void Hide(BeatmapInfo beatmapInfo)
         {
-            realm.Run(r =>
+            Realm.Run(r =>
             {
                 using (var transaction = r.BeginWrite())
                 {
@@ -211,7 +207,7 @@ namespace osu.Game.Beatmaps
         /// <param name="beatmapInfo">The beatmap difficulty to restore.</param>
         public void Restore(BeatmapInfo beatmapInfo)
         {
-            realm.Run(r =>
+            Realm.Run(r =>
             {
                 using (var transaction = r.BeginWrite())
                 {
@@ -226,7 +222,7 @@ namespace osu.Game.Beatmaps
 
         public void RestoreAll()
         {
-            realm.Run(r =>
+            Realm.Run(r =>
             {
                 using (var transaction = r.BeginWrite())
                 {
@@ -244,7 +240,7 @@ namespace osu.Game.Beatmaps
         /// <returns>A list of available <see cref="BeatmapSetInfo"/>.</returns>
         public List<BeatmapSetInfo> GetAllUsableBeatmapSets()
         {
-            return realm.Run(r =>
+            return Realm.Run(r =>
             {
                 r.Refresh();
                 return r.All<BeatmapSetInfo>().Where(b => !b.DeletePending).Detach();
@@ -258,7 +254,7 @@ namespace osu.Game.Beatmaps
         /// <returns>The first result for the provided query, or null if no results were found.</returns>
         public Live<BeatmapSetInfo>? QueryBeatmapSet(Expression<Func<BeatmapSetInfo, bool>> query)
         {
-            return realm.Run(r => r.All<BeatmapSetInfo>().FirstOrDefault(query)?.ToLive(realm));
+            return Realm.Run(r => r.All<BeatmapSetInfo>().FirstOrDefault(query)?.ToLive(Realm));
         }
 
         /// <summary>
@@ -266,7 +262,7 @@ namespace osu.Game.Beatmaps
         /// </summary>
         /// <param name="query">The query.</param>
         /// <returns>The first result for the provided query, or null if no results were found.</returns>
-        public BeatmapInfo? QueryBeatmap(Expression<Func<BeatmapInfo, bool>> query) => realm.Run(r => r.All<BeatmapInfo>().FirstOrDefault(query)?.Detach());
+        public BeatmapInfo? QueryBeatmap(Expression<Func<BeatmapInfo, bool>> query) => Realm.Run(r => r.All<BeatmapInfo>().FirstOrDefault(query)?.Detach());
 
         /// <summary>
         /// A default representation of a WorkingBeatmap to use when no beatmap is available.
@@ -318,7 +314,7 @@ namespace osu.Game.Beatmaps
 
                 AddFile(setInfo, stream, createBeatmapFilenameFromMetadata(beatmapInfo));
 
-                realm.Write(r => setInfo.CopyChangesToRealm(r.Find<BeatmapSetInfo>(setInfo.ID)));
+                Realm.Write(r => setInfo.CopyChangesToRealm(r.Find<BeatmapSetInfo>(setInfo.ID)));
             }
 
             workingBeatmapCache.Invalidate(beatmapInfo);
@@ -332,7 +328,7 @@ namespace osu.Game.Beatmaps
 
         public void DeleteAllVideos()
         {
-            realm.Write(r =>
+            Realm.Write(r =>
             {
                 var items = r.All<BeatmapSetInfo>().Where(s => !s.DeletePending && !s.Protected);
                 DeleteVideos(items.ToList());
@@ -341,7 +337,7 @@ namespace osu.Game.Beatmaps
 
         public void Delete(Expression<Func<BeatmapSetInfo, bool>>? filter = null, bool silent = false)
         {
-            realm.Run(r =>
+            Realm.Run(r =>
             {
                 var items = r.All<BeatmapSetInfo>().Where(s => !s.DeletePending && !s.Protected);
 
@@ -399,7 +395,7 @@ namespace osu.Game.Beatmaps
 
         public void UndeleteAll()
         {
-            realm.Run(r => Undelete(r.All<BeatmapSetInfo>().Where(s => s.DeletePending).ToList()));
+            Realm.Run(r => Undelete(r.All<BeatmapSetInfo>().Where(s => s.DeletePending).ToList()));
         }
 
         #region Implementation of ICanAcceptFiles
@@ -431,7 +427,7 @@ namespace osu.Game.Beatmaps
             // If we seem to be missing files, now is a good time to re-fetch.
             if (importedBeatmap?.BeatmapSet?.Files.Count == 0)
             {
-                realm.Run(r =>
+                Realm.Run(r =>
                 {
                     var refetch = r.Find<BeatmapInfo>(importedBeatmap.ID)?.Detach();
 
diff --git a/osu.Game/Database/RealmArchiveModelManager.cs b/osu.Game/Database/RealmArchiveModelManager.cs
index 5056b0d49f..bf4a8ca969 100644
--- a/osu.Game/Database/RealmArchiveModelManager.cs
+++ b/osu.Game/Database/RealmArchiveModelManager.cs
@@ -18,7 +18,7 @@ namespace osu.Game.Database
     public class ModelManager<TModel> : IModelManager<TModel>, IModelFileManager<TModel, RealmNamedFileUsage>
         where TModel : RealmObject, IHasRealmFiles, IHasGuidPrimaryKey, ISoftDelete
     {
-        protected RealmAccess Realm;
+        protected RealmAccess Realm { get; }
 
         private readonly RealmFileStore realmFileStore;
 
diff --git a/osu.Game/Scoring/ScoreManager.cs b/osu.Game/Scoring/ScoreManager.cs
index da77b0bc6c..2b13b5cf4e 100644
--- a/osu.Game/Scoring/ScoreManager.cs
+++ b/osu.Game/Scoring/ScoreManager.cs
@@ -24,7 +24,6 @@ namespace osu.Game.Scoring
 {
     public class ScoreManager : ModelManager<ScoreInfo>, IModelImporter<ScoreInfo>
     {
-        private readonly RealmAccess realm;
         private readonly Scheduler scheduler;
         private readonly Func<BeatmapDifficultyCache> difficulties;
         private readonly OsuConfigManager configManager;
@@ -34,7 +33,6 @@ namespace osu.Game.Scoring
                             Func<BeatmapDifficultyCache> difficulties = null, OsuConfigManager configManager = null)
             : base(storage, realm)
         {
-            this.realm = realm;
             this.scheduler = scheduler;
             this.difficulties = difficulties;
             this.configManager = configManager;
@@ -51,7 +49,7 @@ namespace osu.Game.Scoring
         /// <returns>The first result for the provided query, or null if no results were found.</returns>
         public ScoreInfo Query(Expression<Func<ScoreInfo, bool>> query)
         {
-            return realm.Run(r => r.All<ScoreInfo>().FirstOrDefault(query)?.Detach());
+            return Realm.Run(r => r.All<ScoreInfo>().FirstOrDefault(query)?.Detach());
         }
 
         /// <summary>
@@ -230,7 +228,7 @@ namespace osu.Game.Scoring
 
         public void Delete([CanBeNull] Expression<Func<ScoreInfo, bool>> filter = null, bool silent = false)
         {
-            realm.Run(r =>
+            Realm.Run(r =>
             {
                 var items = r.All<ScoreInfo>()
                              .Where(s => !s.DeletePending);
@@ -244,7 +242,7 @@ namespace osu.Game.Scoring
 
         public void Delete(BeatmapInfo beatmap, bool silent = false)
         {
-            realm.Run(r =>
+            Realm.Run(r =>
             {
                 var beatmapScores = r.Find<BeatmapInfo>(beatmap.ID).Scores.ToList();
                 Delete(beatmapScores, silent);
diff --git a/osu.Game/Skinning/SkinManager.cs b/osu.Game/Skinning/SkinManager.cs
index 491de0c152..33af46bc1c 100644
--- a/osu.Game/Skinning/SkinManager.cs
+++ b/osu.Game/Skinning/SkinManager.cs
@@ -54,7 +54,6 @@ namespace osu.Game.Skinning
         };
 
         private readonly SkinImporter skinImporter;
-        private readonly RealmAccess realm;
 
         private readonly IResourceStore<byte[]> userFiles;
 
@@ -71,7 +70,6 @@ namespace osu.Game.Skinning
         public SkinManager(Storage storage, RealmAccess realm, GameHost host, IResourceStore<byte[]> resources, AudioManager audio, Scheduler scheduler)
             : base(storage, realm)
         {
-            this.realm = realm;
             this.audio = audio;
             this.scheduler = scheduler;
             this.host = host;
@@ -114,7 +112,7 @@ namespace osu.Game.Skinning
 
         public void SelectRandomSkin()
         {
-            realm.Run(r =>
+            Realm.Run(r =>
             {
                 // choose from only user skins, removing the current selection to ensure a new one is chosen.
                 var randomChoices = r.All<SkinInfo>().Where(s => !s.DeletePending && s.ID != CurrentSkinInfo.Value.ID).ToArray();
@@ -127,7 +125,7 @@ namespace osu.Game.Skinning
 
                 var chosen = randomChoices.ElementAt(RNG.Next(0, randomChoices.Length));
 
-                CurrentSkinInfo.Value = chosen.ToLive(realm);
+                CurrentSkinInfo.Value = chosen.ToLive(Realm);
             });
         }
 
@@ -152,7 +150,7 @@ namespace osu.Game.Skinning
                 if (!s.Protected)
                     return false;
 
-                string[] existingSkinNames = realm.Run(r => r.All<SkinInfo>()
+                string[] existingSkinNames = Realm.Run(r => r.All<SkinInfo>()
                                                              .Where(skin => !skin.DeletePending)
                                                              .AsEnumerable()
                                                              .Select(skin => skin.Name).ToArray());
@@ -195,7 +193,7 @@ namespace osu.Game.Skinning
         /// <returns>The first result for the provided query, or null if no results were found.</returns>
         public Live<SkinInfo> Query(Expression<Func<SkinInfo, bool>> query)
         {
-            return realm.Run(r => r.All<SkinInfo>().FirstOrDefault(query)?.ToLive(realm));
+            return Realm.Run(r => r.All<SkinInfo>().FirstOrDefault(query)?.ToLive(Realm));
         }
 
         public event Action SourceChanged;
@@ -250,7 +248,7 @@ namespace osu.Game.Skinning
         AudioManager IStorageResourceProvider.AudioManager => audio;
         IResourceStore<byte[]> IStorageResourceProvider.Resources => resources;
         IResourceStore<byte[]> IStorageResourceProvider.Files => userFiles;
-        RealmAccess IStorageResourceProvider.RealmAccess => realm;
+        RealmAccess IStorageResourceProvider.RealmAccess => Realm;
         IResourceStore<TextureUpload> IStorageResourceProvider.CreateTextureLoaderStore(IResourceStore<byte[]> underlyingStore) => host.CreateTextureLoaderStore(underlyingStore);
 
         #endregion
@@ -279,7 +277,7 @@ namespace osu.Game.Skinning
 
         public void Delete([CanBeNull] Expression<Func<SkinInfo, bool>> filter = null, bool silent = false)
         {
-            realm.Run(r =>
+            Realm.Run(r =>
             {
                 var items = r.All<SkinInfo>()
                              .Where(s => !s.Protected && !s.DeletePending);

From a635664a86de13d2f46d04daa2bbd8d27f0db238 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 16 Jun 2022 12:01:53 +0200
Subject: [PATCH 5500/5547] Fix invalid method reference in comment

`BeatmapModelManager.Save()` was moved to `BeatmapManager`, not to
`BeatmapImporter`.
---
 osu.Game/Beatmaps/BeatmapManager.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index a4ac161223..ea804dea72 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -174,7 +174,7 @@ namespace osu.Game.Beatmaps
         private WorkingBeatmap addDifficultyToSet(BeatmapSetInfo targetBeatmapSet, IBeatmap newBeatmap, ISkin beatmapSkin)
         {
             // populate circular beatmap set info <-> beatmap info references manually.
-            // several places like `BeatmapImporter.Save()` or `GetWorkingBeatmap()`
+            // several places like `Save()` or `GetWorkingBeatmap()`
             // rely on them being freely traversable in both directions for correct operation.
             targetBeatmapSet.Beatmaps.Add(newBeatmap.BeatmapInfo);
             newBeatmap.BeatmapInfo.BeatmapSet = targetBeatmapSet;

From ce3d3a967c6e5a13e34578c8c122a7a81ef5a357 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 16 Jun 2022 19:05:25 +0900
Subject: [PATCH 5501/5547] Reimplement missing methods

---
 osu.Game/Beatmaps/BeatmapManager.cs           | 10 +++++++---
 osu.Game/Database/RealmArchiveModelManager.cs |  5 +++--
 osu.Game/Scoring/ScoreManager.cs              |  5 ++++-
 3 files changed, 14 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index 33e8cea380..778829cba8 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -359,7 +359,7 @@ namespace osu.Game.Beatmaps
             var notification = new ProgressNotification
             {
                 Progress = 0,
-                Text = $"Preparing to delete all {beatmapImporter.HumanisedModelName} videos...",
+                Text = $"Preparing to delete all {HumanisedModelName} videos...",
                 CompletionText = "No videos found to delete!",
                 State = ProgressNotificationState.Active,
             };
@@ -382,10 +382,10 @@ namespace osu.Game.Beatmaps
                 {
                     DeleteFile(b, video);
                     deleted++;
-                    notification.CompletionText = $"Deleted {deleted} {beatmapImporter.HumanisedModelName} video(s)!";
+                    notification.CompletionText = $"Deleted {deleted} {HumanisedModelName} video(s)!";
                 }
 
-                notification.Text = $"Deleting videos from {beatmapImporter.HumanisedModelName}s ({deleted} deleted)";
+                notification.Text = $"Deleting videos from {HumanisedModelName}s ({deleted} deleted)";
 
                 notification.Progress = (float)++i / items.Count;
             }
@@ -451,6 +451,8 @@ namespace osu.Game.Beatmaps
         void IWorkingBeatmapCache.Invalidate(BeatmapSetInfo beatmapSetInfo) => workingBeatmapCache.Invalidate(beatmapSetInfo);
         void IWorkingBeatmapCache.Invalidate(BeatmapInfo beatmapInfo) => workingBeatmapCache.Invalidate(beatmapInfo);
 
+        public override bool IsAvailableLocally(BeatmapSetInfo model) => Realm.Run(realm => realm.All<BeatmapSetInfo>().Any(s => s.OnlineID == model.OnlineID));
+
         #endregion
 
         #region Implementation of IDisposable
@@ -470,5 +472,7 @@ namespace osu.Game.Beatmaps
         }
 
         #endregion
+
+        public override string HumanisedModelName => "beatmap";
     }
 }
diff --git a/osu.Game/Database/RealmArchiveModelManager.cs b/osu.Game/Database/RealmArchiveModelManager.cs
index bf4a8ca969..795647e94c 100644
--- a/osu.Game/Database/RealmArchiveModelManager.cs
+++ b/osu.Game/Database/RealmArchiveModelManager.cs
@@ -199,9 +199,10 @@ namespace osu.Game.Database
             });
         }
 
-        // TODO: implement
         public virtual bool IsAvailableLocally(TModel model) => true;
+
         public Action<Notification>? PostNotification { get; set; }
-        public string HumanisedModelName { get; set; } = "wang";
+
+        public virtual string HumanisedModelName => $"{typeof(TModel).Name.Replace(@"Info", "").ToLower()}";
     }
 }
diff --git a/osu.Game/Scoring/ScoreManager.cs b/osu.Game/Scoring/ScoreManager.cs
index 2b13b5cf4e..9b5eab96e8 100644
--- a/osu.Game/Scoring/ScoreManager.cs
+++ b/osu.Game/Scoring/ScoreManager.cs
@@ -253,11 +253,14 @@ namespace osu.Game.Scoring
 
         public Task Import(params ImportTask[] tasks) => scoreImporter.Import(tasks);
 
+        public override bool IsAvailableLocally(ScoreInfo model) => Realm.Run(realm => realm.All<ScoreInfo>().Any(s => s.OnlineID == model.OnlineID));
+
         public IEnumerable<string> HandledExtensions => scoreImporter.HandledExtensions;
 
         public Task<IEnumerable<Live<ScoreInfo>>> Import(ProgressNotification notification, params ImportTask[] tasks) => scoreImporter.Import(notification, tasks);
 
-        public Live<ScoreInfo> Import(ScoreInfo item, ArchiveReader archive = null, bool batchImport = false, CancellationToken cancellationToken = default) => scoreImporter.Import(item, archive, batchImport, cancellationToken);
+        public Live<ScoreInfo> Import(ScoreInfo item, ArchiveReader archive = null, bool batchImport = false, CancellationToken cancellationToken = default) =>
+            scoreImporter.Import(item, archive, batchImport, cancellationToken);
 
         #region Implementation of IPresentImports<ScoreInfo>
 

From 3860f0b3e5b8e3105501cd89dfddaa6da874334b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 16 Jun 2022 19:08:59 +0900
Subject: [PATCH 5502/5547] Remove unused `GetWorkingBetamap` method

---
 osu.Game/Beatmaps/BeatmapManager.cs | 9 ---------
 1 file changed, 9 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index 778829cba8..583594b152 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -439,15 +439,6 @@ namespace osu.Game.Beatmaps
             return workingBeatmapCache.GetWorkingBeatmap(importedBeatmap);
         }
 
-        public WorkingBeatmap GetWorkingBeatmap(Live<BeatmapInfo>? importedBeatmap)
-        {
-            WorkingBeatmap working = workingBeatmapCache.GetWorkingBeatmap(null);
-
-            importedBeatmap?.PerformRead(b => working = workingBeatmapCache.GetWorkingBeatmap(b));
-
-            return working;
-        }
-
         void IWorkingBeatmapCache.Invalidate(BeatmapSetInfo beatmapSetInfo) => workingBeatmapCache.Invalidate(beatmapSetInfo);
         void IWorkingBeatmapCache.Invalidate(BeatmapInfo beatmapInfo) => workingBeatmapCache.Invalidate(beatmapInfo);
 

From 448eee051ad5e727c4c2436c116e3fa61eb62860 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 16 Jun 2022 19:41:14 +0900
Subject: [PATCH 5503/5547] Update filename to match new class name

---
 .../Database/{RealmArchiveModelManager.cs => ModelManager.cs}     | 0
 1 file changed, 0 insertions(+), 0 deletions(-)
 rename osu.Game/Database/{RealmArchiveModelManager.cs => ModelManager.cs} (100%)

diff --git a/osu.Game/Database/RealmArchiveModelManager.cs b/osu.Game/Database/ModelManager.cs
similarity index 100%
rename from osu.Game/Database/RealmArchiveModelManager.cs
rename to osu.Game/Database/ModelManager.cs

From e66ccfd980e55027a3cd8ae40cd9689babddf401 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 16 Jun 2022 19:48:18 +0900
Subject: [PATCH 5504/5547] Add back missing notification flow

---
 osu.Game/Beatmaps/BeatmapManager.cs | 2 ++
 osu.Game/Scoring/ScoreManager.cs    | 5 ++++-
 osu.Game/Skinning/SkinManager.cs    | 5 ++++-
 3 files changed, 10 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index 583594b152..fcc78bc34d 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -62,6 +62,8 @@ namespace osu.Game.Beatmaps
             BeatmapTrackStore = audioManager.GetTrackStore(userResources);
 
             beatmapImporter = CreateBeatmapImporter(storage, realm, rulesets, onlineBeatmapLookupQueue);
+            beatmapImporter.PostNotification = obj => PostNotification?.Invoke(obj);
+
             workingBeatmapCache = CreateWorkingBeatmapCache(audioManager, gameResources, userResources, defaultBeatmap, host);
         }
 
diff --git a/osu.Game/Scoring/ScoreManager.cs b/osu.Game/Scoring/ScoreManager.cs
index 9b5eab96e8..4627ca414a 100644
--- a/osu.Game/Scoring/ScoreManager.cs
+++ b/osu.Game/Scoring/ScoreManager.cs
@@ -37,7 +37,10 @@ namespace osu.Game.Scoring
             this.difficulties = difficulties;
             this.configManager = configManager;
 
-            scoreImporter = new ScoreImporter(rulesets, beatmaps, storage, realm);
+            scoreImporter = new ScoreImporter(rulesets, beatmaps, storage, realm)
+            {
+                PostNotification = obj => PostNotification?.Invoke(obj)
+            };
         }
 
         public Score GetScore(ScoreInfo score) => scoreImporter.GetScore(score);
diff --git a/osu.Game/Skinning/SkinManager.cs b/osu.Game/Skinning/SkinManager.cs
index 33af46bc1c..813ed3e066 100644
--- a/osu.Game/Skinning/SkinManager.cs
+++ b/osu.Game/Skinning/SkinManager.cs
@@ -77,7 +77,10 @@ namespace osu.Game.Skinning
 
             userFiles = new StorageBackedResourceStore(storage.GetStorageForDirectory("files"));
 
-            skinImporter = new SkinImporter(storage, realm, this);
+            skinImporter = new SkinImporter(storage, realm, this)
+            {
+                PostNotification = obj => PostNotification?.Invoke(obj),
+            };
 
             var defaultSkins = new[]
             {

From 7b0fad6461342948385a75166d68df24b175d18c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 16 Jun 2022 23:29:33 +0900
Subject: [PATCH 5505/5547] Null disposal token after use

---
 osu.Game/Database/EFToRealmMigrator.cs | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Database/EFToRealmMigrator.cs b/osu.Game/Database/EFToRealmMigrator.cs
index d2f52fa635..aa25c76943 100644
--- a/osu.Game/Database/EFToRealmMigrator.cs
+++ b/osu.Game/Database/EFToRealmMigrator.cs
@@ -133,6 +133,8 @@ namespace osu.Game.Database
             Task.Factory.StartNew(() =>
             {
                 realm.CreateBackup(Path.Combine(backup_folder, $"client.{backupSuffix}.realm"), realmBlockOperations);
+                realmBlockOperations = null;
+
                 efContextFactory.CreateBackup(Path.Combine(backup_folder, $"client.{backupSuffix}.db"));
 
                 using (var ef = efContextFactory.Get())
@@ -218,7 +220,7 @@ namespace osu.Game.Database
                 // If we were to not do this, the migration would run another time the next time the user starts the game.
                 deletePreRealmData();
 
-                realmBlockOperations.Dispose();
+                realmBlockOperations?.Dispose();
 
                 migrationCompleted.SetResult(true);
                 efContextFactory.SetMigrationCompletion();

From 7809566f166e847b80723bf2bab3bc9f6a190f40 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 16 Jun 2022 23:31:38 +0900
Subject: [PATCH 5506/5547] Add explanatory comments

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

diff --git a/osu.Game/Database/EFToRealmMigrator.cs b/osu.Game/Database/EFToRealmMigrator.cs
index aa25c76943..74a3edc3ee 100644
--- a/osu.Game/Database/EFToRealmMigrator.cs
+++ b/osu.Game/Database/EFToRealmMigrator.cs
@@ -133,6 +133,9 @@ namespace osu.Game.Database
             Task.Factory.StartNew(() =>
             {
                 realm.CreateBackup(Path.Combine(backup_folder, $"client.{backupSuffix}.realm"), realmBlockOperations);
+
+                // Above call will dispose of the blocking token when done.
+                // Clean up here so we don't accidentally dispose twice.
                 realmBlockOperations = null;
 
                 efContextFactory.CreateBackup(Path.Combine(backup_folder, $"client.{backupSuffix}.db"));
@@ -220,6 +223,7 @@ namespace osu.Game.Database
                 // If we were to not do this, the migration would run another time the next time the user starts the game.
                 deletePreRealmData();
 
+                // If something went wrong and the disposal token wasn't invoked above, ensure it is here.
                 realmBlockOperations?.Dispose();
 
                 migrationCompleted.SetResult(true);

From bf6c6682bcf05ae241bb41d4f60de4960d29acb4 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 16 Jun 2022 23:37:24 +0900
Subject: [PATCH 5507/5547] Move null to finally

---
 osu.Game/Database/EFToRealmMigrator.cs | 15 ++++++++++-----
 1 file changed, 10 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Database/EFToRealmMigrator.cs b/osu.Game/Database/EFToRealmMigrator.cs
index 74a3edc3ee..2486071c01 100644
--- a/osu.Game/Database/EFToRealmMigrator.cs
+++ b/osu.Game/Database/EFToRealmMigrator.cs
@@ -132,11 +132,16 @@ namespace osu.Game.Database
 
             Task.Factory.StartNew(() =>
             {
-                realm.CreateBackup(Path.Combine(backup_folder, $"client.{backupSuffix}.realm"), realmBlockOperations);
-
-                // Above call will dispose of the blocking token when done.
-                // Clean up here so we don't accidentally dispose twice.
-                realmBlockOperations = null;
+                try
+                {
+                    realm.CreateBackup(Path.Combine(backup_folder, $"client.{backupSuffix}.realm"), realmBlockOperations);
+                }
+                finally
+                {
+                    // Above call will dispose of the blocking token when done.
+                    // Clean up here so we don't accidentally dispose twice.
+                    realmBlockOperations = null;
+                }
 
                 efContextFactory.CreateBackup(Path.Combine(backup_folder, $"client.{backupSuffix}.db"));
 

From f1081db953887ba597675c772772d5a8ca94acff Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 16 Jun 2022 18:48:32 +0300
Subject: [PATCH 5508/5547] Fix background/track implicitly renamed on initial
 load

---
 .../Screens/Edit/Setup/ResourcesSection.cs    | 35 ++++++++++---------
 1 file changed, 19 insertions(+), 16 deletions(-)

diff --git a/osu.Game/Screens/Edit/Setup/ResourcesSection.cs b/osu.Game/Screens/Edit/Setup/ResourcesSection.cs
index 2471886d9b..5054f7a393 100644
--- a/osu.Game/Screens/Edit/Setup/ResourcesSection.cs
+++ b/osu.Game/Screens/Edit/Setup/ResourcesSection.cs
@@ -59,8 +59,10 @@ namespace osu.Game.Screens.Edit.Setup
             if (!string.IsNullOrEmpty(working.Value.Metadata.AudioFile))
                 audioTrackChooser.Current.Value = new FileInfo(working.Value.Metadata.AudioFile);
 
-            backgroundChooser.Current.BindValueChanged(backgroundChanged, true);
-            audioTrackChooser.Current.BindValueChanged(audioTrackChanged, true);
+            backgroundChooser.Current.BindValueChanged(backgroundChanged);
+            audioTrackChooser.Current.BindValueChanged(audioTrackChanged);
+
+            updatePlaceholderText();
         }
 
         public bool ChangeBackgroundImage(FileInfo source)
@@ -121,28 +123,29 @@ namespace osu.Game.Screens.Edit.Setup
 
         private void backgroundChanged(ValueChangedEvent<FileInfo> file)
         {
-            backgroundChooser.Text = file.NewValue == null
-                ? "Click to select a background image"
-                : "Click to replace the background image";
+            if (!ChangeBackgroundImage(file.NewValue))
+                backgroundChooser.Current.Value = file.OldValue;
 
-            if (file.NewValue != file.OldValue)
-            {
-                if (!ChangeBackgroundImage(file.NewValue))
-                    backgroundChooser.Current.Value = file.OldValue;
-            }
+            updatePlaceholderText();
         }
 
         private void audioTrackChanged(ValueChangedEvent<FileInfo> file)
         {
-            audioTrackChooser.Text = file.NewValue == null
+            if (!ChangeAudioTrack(file.NewValue))
+                audioTrackChooser.Current.Value = file.OldValue;
+
+            updatePlaceholderText();
+        }
+
+        private void updatePlaceholderText()
+        {
+            audioTrackChooser.Text = audioTrackChooser.Current.Value == null
                 ? "Click to select a track"
                 : "Click to replace the track";
 
-            if (file.NewValue != file.OldValue)
-            {
-                if (!ChangeAudioTrack(file.NewValue))
-                    audioTrackChooser.Current.Value = file.OldValue;
-            }
+            backgroundChooser.Text = backgroundChooser.Current.Value == null
+                ? "Click to select a background image"
+                : "Click to replace the background image";
         }
     }
 }

From 6aee6895863be43435e648161c0c3e831cae5507 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 16 Jun 2022 18:50:28 +0300
Subject: [PATCH 5509/5547] Fix previous file lookup not using metadata
 properties

---
 osu.Game/Screens/Edit/Setup/ResourcesSection.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/Edit/Setup/ResourcesSection.cs b/osu.Game/Screens/Edit/Setup/ResourcesSection.cs
index 5054f7a393..1a37f539e8 100644
--- a/osu.Game/Screens/Edit/Setup/ResourcesSection.cs
+++ b/osu.Game/Screens/Edit/Setup/ResourcesSection.cs
@@ -76,7 +76,7 @@ namespace osu.Game.Screens.Edit.Setup
 
             // remove the previous background for now.
             // in the future we probably want to check if this is being used elsewhere (other difficulties?)
-            var oldFile = set.Files.FirstOrDefault(f => Path.GetFileNameWithoutExtension(f.Filename) == destination.Name);
+            var oldFile = set.Files.FirstOrDefault(f => f.Filename == working.Value.Metadata.BackgroundFile);
 
             using (var stream = source.OpenRead())
             {
@@ -103,7 +103,7 @@ namespace osu.Game.Screens.Edit.Setup
 
             // remove the previous audio track for now.
             // in the future we probably want to check if this is being used elsewhere (other difficulties?)
-            var oldFile = set.Files.FirstOrDefault(f => Path.GetFileNameWithoutExtension(f.Filename) == destination.Name);
+            var oldFile = set.Files.FirstOrDefault(f => f.Filename == working.Value.Metadata.AudioFile);
 
             using (var stream = source.OpenRead())
             {

From 52538dc7083f2063149c8f08a249921c3c429acc Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 16 Jun 2022 19:46:04 +0300
Subject: [PATCH 5510/5547] Refactor `LatencyCursorContainer` to become a
 cursor container

---
 .../LatencyCursorContainer.cs                 | 48 +++++++++----------
 1 file changed, 22 insertions(+), 26 deletions(-)

diff --git a/osu.Game/Screens/Utility/SampleComponents/LatencyCursorContainer.cs b/osu.Game/Screens/Utility/SampleComponents/LatencyCursorContainer.cs
index e4c2b504cb..ecd3837512 100644
--- a/osu.Game/Screens/Utility/SampleComponents/LatencyCursorContainer.cs
+++ b/osu.Game/Screens/Utility/SampleComponents/LatencyCursorContainer.cs
@@ -2,55 +2,51 @@
 // See the LICENCE file in the repository root for full licence text.
 
 #nullable enable
-using osu.Framework.Allocation;
+
 using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.Cursor;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Input.Events;
 using osu.Framework.Input.States;
-using osu.Game.Overlays;
 using osuTK;
 using osuTK.Input;
 
 namespace osu.Game.Screens.Utility.SampleComponents
 {
-    public class LatencyCursorContainer : LatencySampleComponent
+    public class LatencyCursorContainer : CursorContainer
     {
-        private Circle cursor = null!;
+        protected override Drawable CreateCursor() => new LatencyCursor();
 
-        [Resolved]
-        private OverlayColourProvider overlayColourProvider { get; set; } = null!;
+        public override bool IsPresent => base.IsPresent || Scheduler.HasPendingTasks;
 
         public LatencyCursorContainer()
         {
-            Masking = true;
+            State.Value = Visibility.Hidden;
         }
 
-        protected override void LoadComplete()
+        protected override bool OnMouseMove(MouseMoveEvent e)
         {
-            base.LoadComplete();
-
-            InternalChild = cursor = new Circle
-            {
-                Size = new Vector2(40),
-                Origin = Anchor.Centre,
-                Colour = overlayColourProvider.Colour2,
-            };
+            // CursorContainer implements IRequireHighFrequencyMousePosition, which bypasses limited rate updating, therefore scheduling is required.
+            // We can alternatively solve this by a PassThroughInputManager layer inside LatencyArea,
+            // but that would mean including input lag to this test, which may not be desired.
+            Schedule(() => base.OnMouseMove(e));
+            return false;
         }
 
-        protected override bool OnHover(HoverEvent e) => false;
-
-        protected override void UpdateAtLimitedRate(InputState inputState)
+        private class LatencyCursor : LatencySampleComponent
         {
-            cursor.Colour = inputState.Mouse.IsPressed(MouseButton.Left) ? overlayColourProvider.Content1 : overlayColourProvider.Colour2;
-
-            if (IsActive.Value)
+            public LatencyCursor()
             {
-                cursor.Position = ToLocalSpace(inputState.Mouse.Position);
-                cursor.Alpha = 1;
+                AutoSizeAxes = Axes.Both;
+                Origin = Anchor.Centre;
+
+                InternalChild = new Circle { Size = new Vector2(40) };
             }
-            else
+
+            protected override void UpdateAtLimitedRate(InputState inputState)
             {
-                cursor.Alpha = 0;
+                Colour = inputState.Mouse.IsPressed(MouseButton.Left) ? OverlayColourProvider.Content1 : OverlayColourProvider.Colour2;
             }
         }
     }

From ed6817ae6a68b2385b8f0591453367d88a423459 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 16 Jun 2022 19:46:31 +0300
Subject: [PATCH 5511/5547] Allow switching between latency and menu cursor
 using `IProvideCursor`

---
 osu.Game/Screens/Utility/LatencyArea.cs            | 14 ++++++++++----
 osu.Game/Screens/Utility/LatencyCertifierScreen.cs |  2 --
 2 files changed, 10 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Screens/Utility/LatencyArea.cs b/osu.Game/Screens/Utility/LatencyArea.cs
index 21688f0b0c..86cdbd39b9 100644
--- a/osu.Game/Screens/Utility/LatencyArea.cs
+++ b/osu.Game/Screens/Utility/LatencyArea.cs
@@ -8,8 +8,10 @@ using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.Cursor;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Input.Events;
+using osu.Game.Graphics.Cursor;
 using osu.Game.Overlays;
 using osu.Game.Screens.Utility.SampleComponents;
 using osuTK.Input;
@@ -17,7 +19,7 @@ using osuTK.Input;
 namespace osu.Game.Screens.Utility
 {
     [Cached]
-    public class LatencyArea : CompositeDrawable
+    public class LatencyArea : CompositeDrawable, IProvideCursor
     {
         [Resolved]
         private OverlayColourProvider overlayColourProvider { get; set; } = null!;
@@ -36,6 +38,10 @@ namespace osu.Game.Screens.Utility
 
         public readonly Bindable<LatencyVisualMode> VisualMode = new Bindable<LatencyVisualMode>();
 
+        public CursorContainer? Cursor { get; private set; }
+
+        public bool ProvidingUserCursor => IsActiveArea.Value;
+
         public LatencyArea(Key key, int? targetFrameRate)
         {
             this.key = key;
@@ -87,7 +93,7 @@ namespace osu.Game.Screens.Utility
                             {
                                 RelativeSizeAxes = Axes.Both,
                             },
-                            new LatencyCursorContainer
+                            Cursor = new LatencyCursorContainer
                             {
                                 RelativeSizeAxes = Axes.Both,
                             },
@@ -101,7 +107,7 @@ namespace osu.Game.Screens.Utility
                             {
                                 RelativeSizeAxes = Axes.Both,
                             },
-                            new LatencyCursorContainer
+                            Cursor = new LatencyCursorContainer
                             {
                                 RelativeSizeAxes = Axes.Both,
                             },
@@ -115,7 +121,7 @@ namespace osu.Game.Screens.Utility
                             {
                                 RelativeSizeAxes = Axes.Both,
                             },
-                            new LatencyCursorContainer
+                            Cursor = new LatencyCursorContainer
                             {
                                 RelativeSizeAxes = Axes.Both,
                             },
diff --git a/osu.Game/Screens/Utility/LatencyCertifierScreen.cs b/osu.Game/Screens/Utility/LatencyCertifierScreen.cs
index 8210e6825a..f8587e166c 100644
--- a/osu.Game/Screens/Utility/LatencyCertifierScreen.cs
+++ b/osu.Game/Screens/Utility/LatencyCertifierScreen.cs
@@ -41,8 +41,6 @@ namespace osu.Game.Screens.Utility
 
         public override bool HideOverlaysOnEnter => true;
 
-        public override bool CursorVisible => mainArea.Count == 0;
-
         public override float BackgroundParallaxAmount => 0;
 
         private readonly LinkFlowContainer explanatoryText;

From beb03316400ddbffecdf84943fb5e6f0a486d165 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 16 Jun 2022 19:56:56 +0300
Subject: [PATCH 5512/5547] Let latency certifier buttons steal hover from area

---
 osu.Game/Screens/Utility/ButtonWithKeyBind.cs | 2 ++
 osu.Game/Screens/Utility/LatencyArea.cs       | 8 ++++----
 2 files changed, 6 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Screens/Utility/ButtonWithKeyBind.cs b/osu.Game/Screens/Utility/ButtonWithKeyBind.cs
index ef87e0bca7..ad60baafab 100644
--- a/osu.Game/Screens/Utility/ButtonWithKeyBind.cs
+++ b/osu.Game/Screens/Utility/ButtonWithKeyBind.cs
@@ -38,6 +38,8 @@ namespace osu.Game.Screens.Utility
             return base.OnKeyDown(e);
         }
 
+        protected override bool OnHover(HoverEvent e) => true;
+
         [Resolved]
         private OverlayColourProvider overlayColourProvider { get; set; } = null!;
 
diff --git a/osu.Game/Screens/Utility/LatencyArea.cs b/osu.Game/Screens/Utility/LatencyArea.cs
index 86cdbd39b9..da37cab334 100644
--- a/osu.Game/Screens/Utility/LatencyArea.cs
+++ b/osu.Game/Screens/Utility/LatencyArea.cs
@@ -62,6 +62,10 @@ namespace osu.Game.Screens.Utility
                     Colour = overlayColourProvider.Background6,
                     RelativeSizeAxes = Axes.Both,
                 },
+                visualContent = new Container
+                {
+                    RelativeSizeAxes = Axes.Both,
+                },
                 new ButtonWithKeyBind(key)
                 {
                     Text = "Feels better",
@@ -71,10 +75,6 @@ namespace osu.Game.Screens.Utility
                     Origin = Anchor.TopCentre,
                     Action = () => ReportUserBest?.Invoke(),
                 },
-                visualContent = new Container
-                {
-                    RelativeSizeAxes = Axes.Both,
-                },
             };
 
             IsActiveArea.BindValueChanged(active =>

From 8e088140b2c7709a8e5a49aa1efcec8c19815db9 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 16 Jun 2022 20:09:10 +0300
Subject: [PATCH 5513/5547] Reword comment since
 `IRequireHighFrequencyMousePosition` isn't the issue

---
 .../Screens/Utility/SampleComponents/LatencyCursorContainer.cs  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Utility/SampleComponents/LatencyCursorContainer.cs b/osu.Game/Screens/Utility/SampleComponents/LatencyCursorContainer.cs
index ecd3837512..656aa6a8b3 100644
--- a/osu.Game/Screens/Utility/SampleComponents/LatencyCursorContainer.cs
+++ b/osu.Game/Screens/Utility/SampleComponents/LatencyCursorContainer.cs
@@ -27,7 +27,7 @@ namespace osu.Game.Screens.Utility.SampleComponents
 
         protected override bool OnMouseMove(MouseMoveEvent e)
         {
-            // CursorContainer implements IRequireHighFrequencyMousePosition, which bypasses limited rate updating, therefore scheduling is required.
+            // Scheduling is required to ensure updating of cursor position happens in limited rate.
             // We can alternatively solve this by a PassThroughInputManager layer inside LatencyArea,
             // but that would mean including input lag to this test, which may not be desired.
             Schedule(() => base.OnMouseMove(e));

From 42378dbb88b4ec81863c978e5b27595577341bc8 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 16 Jun 2022 20:22:56 +0300
Subject: [PATCH 5514/5547] Improve test coverage to ensure volume is
 unaffected when mouse is away

---
 .../Visual/Menus/TestSceneToolbar.cs          | 26 +++++++++++++++++++
 1 file changed, 26 insertions(+)

diff --git a/osu.Game.Tests/Visual/Menus/TestSceneToolbar.cs b/osu.Game.Tests/Visual/Menus/TestSceneToolbar.cs
index f230e48b11..0b99c781ef 100644
--- a/osu.Game.Tests/Visual/Menus/TestSceneToolbar.cs
+++ b/osu.Game.Tests/Visual/Menus/TestSceneToolbar.cs
@@ -17,6 +17,7 @@ using osu.Game.Overlays;
 using osu.Game.Overlays.Notifications;
 using osu.Game.Overlays.Toolbar;
 using osu.Game.Rulesets;
+using osuTK;
 using osuTK.Graphics;
 using osuTK.Input;
 
@@ -153,11 +154,23 @@ namespace osu.Game.Tests.Visual.Menus
             AddStep("hover toolbar music button", () => InputManager.MoveMouseTo(this.ChildrenOfType<ToolbarMusicButton>().Single()));
 
             AddStep("reset volume", () => Audio.Volume.Value = 1);
+            AddStep("hide volume overlay", () => volumeOverlay.Hide());
 
             AddRepeatStep("scroll down", () => InputManager.ScrollVerticalBy(-10), 5);
             AddAssert("volume lowered down", () => Audio.Volume.Value < 1);
             AddRepeatStep("scroll up", () => InputManager.ScrollVerticalBy(10), 5);
             AddAssert("volume raised up", () => Audio.Volume.Value == 1);
+
+            AddStep("move mouse away", () => InputManager.MoveMouseTo(Vector2.Zero));
+            AddAssert("button not hovered", () => !this.ChildrenOfType<ToolbarMusicButton>().Single().IsHovered);
+
+            AddStep("set volume to 0.5", () => Audio.Volume.Value = 0.5);
+            AddStep("hide volume overlay", () => volumeOverlay.Hide());
+
+            AddRepeatStep("scroll down", () => InputManager.ScrollVerticalBy(-10), 5);
+            AddAssert("volume not changed", () => Audio.Volume.Value == 0.5);
+            AddRepeatStep("scroll up", () => InputManager.ScrollVerticalBy(10), 5);
+            AddAssert("volume not changed", () => Audio.Volume.Value == 0.5);
         }
 
         [Test]
@@ -166,11 +179,24 @@ namespace osu.Game.Tests.Visual.Menus
             AddStep("hover toolbar music button", () => InputManager.MoveMouseTo(this.ChildrenOfType<ToolbarMusicButton>().Single()));
 
             AddStep("reset volume", () => Audio.Volume.Value = 1);
+            AddStep("hide volume overlay", () => volumeOverlay.Hide());
 
             AddRepeatStep("arrow down", () => InputManager.Key(Key.Down), 5);
             AddAssert("volume lowered down", () => Audio.Volume.Value < 1);
             AddRepeatStep("arrow up", () => InputManager.Key(Key.Up), 5);
             AddAssert("volume raised up", () => Audio.Volume.Value == 1);
+
+            AddStep("hide volume overlay", () => volumeOverlay.Hide());
+            AddStep("move mouse away", () => InputManager.MoveMouseTo(Vector2.Zero));
+            AddAssert("button not hovered", () => !this.ChildrenOfType<ToolbarMusicButton>().Single().IsHovered);
+
+            AddStep("set volume", () => Audio.Volume.Value = 0.5);
+            AddStep("hide volume overlay", () => volumeOverlay.Hide());
+
+            AddRepeatStep("arrow down", () => InputManager.Key(Key.Down), 5);
+            AddAssert("volume not changed", () => Audio.Volume.Value == 0.5);
+            AddRepeatStep("arrow up", () => InputManager.Key(Key.Up), 5);
+            AddAssert("volume not changed", () => Audio.Volume.Value == 0.5);
         }
 
         public class TestToolbar : Toolbar

From e4ddf03ad637f99f581903793bbee45715477f7c Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 16 Jun 2022 20:22:25 +0300
Subject: [PATCH 5515/5547] Fix toolbar music button handling keys while not
 hovered

---
 osu.Game/Overlays/Toolbar/ToolbarMusicButton.cs | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/osu.Game/Overlays/Toolbar/ToolbarMusicButton.cs b/osu.Game/Overlays/Toolbar/ToolbarMusicButton.cs
index d59127d61f..9590c1aa3b 100644
--- a/osu.Game/Overlays/Toolbar/ToolbarMusicButton.cs
+++ b/osu.Game/Overlays/Toolbar/ToolbarMusicButton.cs
@@ -81,6 +81,9 @@ namespace osu.Game.Overlays.Toolbar
 
         protected override bool OnKeyDown(KeyDownEvent e)
         {
+            if (!IsHovered)
+                return false;
+
             switch (e.Key)
             {
                 case Key.Up:

From f7a27b412a18e8db958266e49df116c3ebfb8d7f Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 16 Jun 2022 20:35:30 +0300
Subject: [PATCH 5516/5547] Revert "Let latency certifier buttons steal hover
 from area"

This reverts commit beb03316400ddbffecdf84943fb5e6f0a486d165.
---
 osu.Game/Screens/Utility/ButtonWithKeyBind.cs | 2 --
 osu.Game/Screens/Utility/LatencyArea.cs       | 8 ++++----
 2 files changed, 4 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Screens/Utility/ButtonWithKeyBind.cs b/osu.Game/Screens/Utility/ButtonWithKeyBind.cs
index ad60baafab..ef87e0bca7 100644
--- a/osu.Game/Screens/Utility/ButtonWithKeyBind.cs
+++ b/osu.Game/Screens/Utility/ButtonWithKeyBind.cs
@@ -38,8 +38,6 @@ namespace osu.Game.Screens.Utility
             return base.OnKeyDown(e);
         }
 
-        protected override bool OnHover(HoverEvent e) => true;
-
         [Resolved]
         private OverlayColourProvider overlayColourProvider { get; set; } = null!;
 
diff --git a/osu.Game/Screens/Utility/LatencyArea.cs b/osu.Game/Screens/Utility/LatencyArea.cs
index da37cab334..86cdbd39b9 100644
--- a/osu.Game/Screens/Utility/LatencyArea.cs
+++ b/osu.Game/Screens/Utility/LatencyArea.cs
@@ -62,10 +62,6 @@ namespace osu.Game.Screens.Utility
                     Colour = overlayColourProvider.Background6,
                     RelativeSizeAxes = Axes.Both,
                 },
-                visualContent = new Container
-                {
-                    RelativeSizeAxes = Axes.Both,
-                },
                 new ButtonWithKeyBind(key)
                 {
                     Text = "Feels better",
@@ -75,6 +71,10 @@ namespace osu.Game.Screens.Utility
                     Origin = Anchor.TopCentre,
                     Action = () => ReportUserBest?.Invoke(),
                 },
+                visualContent = new Container
+                {
+                    RelativeSizeAxes = Axes.Both,
+                },
             };
 
             IsActiveArea.BindValueChanged(active =>

From db02cb81c5aac24b82f08986d8c43a28ad24d208 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 16 Jun 2022 20:48:17 +0300
Subject: [PATCH 5517/5547] Fix file chooser path not opening home directory
 initially

---
 osu.Game/Screens/Edit/Setup/LabelledFileChooser.cs | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Screens/Edit/Setup/LabelledFileChooser.cs b/osu.Game/Screens/Edit/Setup/LabelledFileChooser.cs
index 6c56320666..ab83c2a2e4 100644
--- a/osu.Game/Screens/Edit/Setup/LabelledFileChooser.cs
+++ b/osu.Game/Screens/Edit/Setup/LabelledFileChooser.cs
@@ -36,6 +36,8 @@ namespace osu.Game.Screens.Edit.Setup
         [Resolved]
         private OsuGameBase game { get; set; } = null!;
 
+        private string? chooserPath;
+
         private readonly BindableWithCurrent<FileInfo?> current = new BindableWithCurrent<FileInfo?>();
 
         public Bindable<FileInfo?> Current
@@ -73,6 +75,8 @@ namespace osu.Game.Screens.Edit.Setup
         {
             if (file.NewValue != null)
                 this.HidePopover();
+
+            chooserPath = file.NewValue?.DirectoryName;
         }
 
         Task ICanAcceptFiles.Import(params string[] paths)
@@ -100,16 +104,16 @@ namespace osu.Game.Screens.Edit.Setup
             OnFocused = this.ShowPopover,
         };
 
-        public Popover GetPopover() => new FileChooserPopover(handledExtensions, Current);
+        public Popover GetPopover() => new FileChooserPopover(handledExtensions, Current, chooserPath);
 
         private class FileChooserPopover : OsuPopover
         {
-            public FileChooserPopover(string[] handledExtensions, Bindable<FileInfo?> currentFile)
+            public FileChooserPopover(string[] handledExtensions, Bindable<FileInfo?> currentFile, string? chooserPath)
             {
                 Child = new Container
                 {
                     Size = new Vector2(600, 400),
-                    Child = new OsuFileSelector(currentFile.Value?.DirectoryName, handledExtensions)
+                    Child = new OsuFileSelector(chooserPath, handledExtensions)
                     {
                         RelativeSizeAxes = Axes.Both,
                         CurrentFile = { BindTarget = currentFile }

From 9141a7a907377fd0f005e4f7b30ccc8d9ab27265 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 16 Jun 2022 20:45:55 +0200
Subject: [PATCH 5518/5547] Revert Xamarin regression workaround in Android CI
 build definition

This commit is a revert of 53e52d2c4b8f32eb7ce07cb7c2ed8a8cae05c5a3.
Partially done because the workaround is no longer needed, partially
because macOS images have begun to fail after a new image rollout with
bumped NuGet versions.
---
 .github/workflows/ci.yml | 15 ++++-----------
 1 file changed, 4 insertions(+), 11 deletions(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 6281357648..8dd6ae8197 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -96,27 +96,20 @@ jobs:
 
   build-only-android:
     name: Build only (Android)
-    runs-on: macos-latest
+    runs-on: windows-latest
     timeout-minutes: 60
     steps:
       - name: Checkout
         uses: actions/checkout@v2
 
-      # Pin Xamarin.Android version to 11.2 for now to avoid build failures caused by a Xamarin-side regression.
-      # See: https://github.com/xamarin/xamarin-android/issues/6284
-      # This can be removed/reverted when the fix makes it to upstream and is deployed on github runners.
-      - name: Set default Xamarin SDK version
-        run: |
-            $VM_ASSETS/select-xamarin-sdk-v2.sh --mono=6.12 --android=11.2
-
       - name: Install .NET 6.0.x
         uses: actions/setup-dotnet@v1
         with:
           dotnet-version: "6.0.x"
 
-      # Contrary to seemingly any other msbuild, msbuild running on macOS/Mono
-      # cannot accept .sln(f) files as arguments.
-      # Build just the main game for now.
+      - name: Setup MSBuild
+        uses: microsoft/setup-msbuild@v1
+
       - name: Build
         run: msbuild osu.Android/osu.Android.csproj /restore /p:Configuration=Debug
 

From 6ff6a3f5b3395e32288bc04bab964410eb260dbf Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 16 Jun 2022 21:51:31 +0200
Subject: [PATCH 5519/5547] Rename and document `chooserPath`

---
 osu.Game/Screens/Edit/Setup/LabelledFileChooser.cs | 14 +++++++++++---
 1 file changed, 11 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Screens/Edit/Setup/LabelledFileChooser.cs b/osu.Game/Screens/Edit/Setup/LabelledFileChooser.cs
index ab83c2a2e4..5a2ac7424c 100644
--- a/osu.Game/Screens/Edit/Setup/LabelledFileChooser.cs
+++ b/osu.Game/Screens/Edit/Setup/LabelledFileChooser.cs
@@ -17,6 +17,7 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Cursor;
 using osu.Framework.Graphics.UserInterface;
 using osu.Framework.Localisation;
+using osu.Framework.Platform;
 using osu.Game.Database;
 using osu.Game.Graphics.UserInterfaceV2;
 using osuTK;
@@ -36,7 +37,14 @@ namespace osu.Game.Screens.Edit.Setup
         [Resolved]
         private OsuGameBase game { get; set; } = null!;
 
-        private string? chooserPath;
+        /// <summary>
+        /// The initial path to use when displaying the <see cref="FileChooserPopover"/>.
+        /// </summary>
+        /// <remarks>
+        /// Uses a <see langword="null"/> value before the first selection is made
+        /// to ensure that the first selection starts at <see cref="GameHost.InitialFileSelectorPath"/>.
+        /// </remarks>
+        private string? initialChooserPath;
 
         private readonly BindableWithCurrent<FileInfo?> current = new BindableWithCurrent<FileInfo?>();
 
@@ -76,7 +84,7 @@ namespace osu.Game.Screens.Edit.Setup
             if (file.NewValue != null)
                 this.HidePopover();
 
-            chooserPath = file.NewValue?.DirectoryName;
+            initialChooserPath = file.NewValue?.DirectoryName;
         }
 
         Task ICanAcceptFiles.Import(params string[] paths)
@@ -104,7 +112,7 @@ namespace osu.Game.Screens.Edit.Setup
             OnFocused = this.ShowPopover,
         };
 
-        public Popover GetPopover() => new FileChooserPopover(handledExtensions, Current, chooserPath);
+        public Popover GetPopover() => new FileChooserPopover(handledExtensions, Current, initialChooserPath);
 
         private class FileChooserPopover : OsuPopover
         {

From 968640c95176f4a771ab6208234045f40e4ca281 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 17 Jun 2022 16:34:09 +0900
Subject: [PATCH 5520/5547] Enable NRT by default

---
 Directory.Build.props | 1 +
 1 file changed, 1 insertion(+)

diff --git a/Directory.Build.props b/Directory.Build.props
index 73a150d3e3..dbc84fb88f 100644
--- a/Directory.Build.props
+++ b/Directory.Build.props
@@ -3,6 +3,7 @@
   <PropertyGroup Label="C#">
     <LangVersion>8.0</LangVersion>
     <TreatWarningsAsErrors>true</TreatWarningsAsErrors>
+    <Nullable>enable</Nullable>
   </PropertyGroup>
   <PropertyGroup>
     <ApplicationManifest>$(MSBuildThisFileDirectory)app.manifest</ApplicationManifest>

From f8830c6850128456266c82de83273204f8b74ac0 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 17 Jun 2022 16:37:17 +0900
Subject: [PATCH 5521/5547] Automated #nullable processing

---
 osu.Android/GameplayScreenRotationLocker.cs                   | 2 ++
 osu.Android/OsuGameActivity.cs                                | 2 ++
 osu.Android/OsuGameAndroid.cs                                 | 2 ++
 osu.Android/Properties/AssemblyInfo.cs                        | 2 ++
 osu.Desktop/DiscordRichPresence.cs                            | 2 ++
 .../LegacyIpc/LegacyIpcDifficultyCalculationRequest.cs        | 2 ++
 .../LegacyIpc/LegacyIpcDifficultyCalculationResponse.cs       | 2 ++
 osu.Desktop/LegacyIpc/LegacyIpcMessage.cs                     | 2 ++
 osu.Desktop/LegacyIpc/LegacyTcpIpcProvider.cs                 | 2 --
 osu.Desktop/OsuGameDesktop.cs                                 | 2 ++
 osu.Desktop/Program.cs                                        | 2 ++
 osu.Desktop/Security/ElevatedPrivilegesChecker.cs             | 2 ++
 osu.Desktop/Updater/SquirrelUpdateManager.cs                  | 2 ++
 osu.Desktop/Windows/GameplayWinKeyBlocker.cs                  | 2 ++
 osu.Desktop/Windows/WindowsKey.cs                             | 2 ++
 osu.Game.Benchmarks/BenchmarkBeatmapParsing.cs                | 2 ++
 osu.Game.Benchmarks/BenchmarkMod.cs                           | 2 ++
 osu.Game.Benchmarks/BenchmarkRealmReads.cs                    | 2 ++
 osu.Game.Benchmarks/BenchmarkRuleset.cs                       | 2 ++
 osu.Game.Benchmarks/BenchmarkTest.cs                          | 2 ++
 osu.Game.Benchmarks/Program.cs                                | 2 ++
 osu.Game.Rulesets.Catch.Tests.Android/MainActivity.cs         | 2 ++
 osu.Game.Rulesets.Catch.Tests.iOS/AppDelegate.cs              | 2 ++
 osu.Game.Rulesets.Catch.Tests.iOS/Application.cs              | 2 ++
 osu.Game.Rulesets.Catch.Tests/CatchBeatmapConversionTest.cs   | 2 ++
 .../CatchDifficultyCalculatorTest.cs                          | 2 ++
 osu.Game.Rulesets.Catch.Tests/CatchLegacyModConversionTest.cs | 2 ++
 osu.Game.Rulesets.Catch.Tests/CatchSkinColourDecodingTest.cs  | 2 ++
 osu.Game.Rulesets.Catch.Tests/CatchSkinnableTestScene.cs      | 2 ++
 .../Editor/CatchEditorTestSceneContainer.cs                   | 2 ++
 .../Editor/CatchPlacementBlueprintTestScene.cs                | 2 ++
 .../Editor/CatchSelectionBlueprintTestScene.cs                | 2 ++
 .../Editor/Checks/TestCheckBananaShowerGap.cs                 | 2 ++
 .../Editor/TestSceneBananaShowerPlacementBlueprint.cs         | 2 ++
 .../Editor/TestSceneCatchDistanceSnapGrid.cs                  | 2 ++
 osu.Game.Rulesets.Catch.Tests/Editor/TestSceneEditor.cs       | 2 ++
 .../Editor/TestSceneFruitPlacementBlueprint.cs                | 2 ++
 .../Editor/TestSceneJuiceStreamPlacementBlueprint.cs          | 2 ++
 .../Editor/TestSceneJuiceStreamSelectionBlueprint.cs          | 2 ++
 osu.Game.Rulesets.Catch.Tests/JuiceStreamPathTest.cs          | 2 ++
 osu.Game.Rulesets.Catch.Tests/Mods/CatchModMirrorTest.cs      | 2 ++
 .../Mods/TestSceneCatchModNoScope.cs                          | 2 ++
 .../Mods/TestSceneCatchModPerfect.cs                          | 2 ++
 osu.Game.Rulesets.Catch.Tests/Mods/TestSceneCatchModRelax.cs  | 2 ++
 osu.Game.Rulesets.Catch.Tests/TestSceneAutoJuiceStream.cs     | 2 ++
 osu.Game.Rulesets.Catch.Tests/TestSceneBananaShower.cs        | 2 ++
 osu.Game.Rulesets.Catch.Tests/TestSceneCatchModHidden.cs      | 2 ++
 osu.Game.Rulesets.Catch.Tests/TestSceneCatchPlayer.cs         | 2 ++
 .../TestSceneCatchPlayerLegacySkin.cs                         | 2 ++
 osu.Game.Rulesets.Catch.Tests/TestSceneCatchReplay.cs         | 2 ++
 .../TestSceneCatchSkinConfiguration.cs                        | 2 ++
 osu.Game.Rulesets.Catch.Tests/TestSceneCatchStacker.cs        | 2 ++
 osu.Game.Rulesets.Catch.Tests/TestSceneCatcher.cs             | 2 ++
 osu.Game.Rulesets.Catch.Tests/TestSceneCatcherArea.cs         | 2 ++
 osu.Game.Rulesets.Catch.Tests/TestSceneComboCounter.cs        | 2 ++
 osu.Game.Rulesets.Catch.Tests/TestSceneDrawableHitObjects.cs  | 2 ++
 .../TestSceneDrawableHitObjectsHidden.cs                      | 2 ++
 osu.Game.Rulesets.Catch.Tests/TestSceneFruitObjects.cs        | 2 ++
 osu.Game.Rulesets.Catch.Tests/TestSceneFruitRandomness.cs     | 2 ++
 osu.Game.Rulesets.Catch.Tests/TestSceneFruitVisualChange.cs   | 2 ++
 osu.Game.Rulesets.Catch.Tests/TestSceneHyperDash.cs           | 2 ++
 osu.Game.Rulesets.Catch.Tests/TestSceneHyperDashColouring.cs  | 2 ++
 osu.Game.Rulesets.Catch.Tests/TestSceneJuiceStream.cs         | 2 ++
 osu.Game.Rulesets.Catch.Tests/TestSceneLegacyBeatmapSkin.cs   | 2 ++
 osu.Game.Rulesets.Catch/Beatmaps/CatchBeatmap.cs              | 2 ++
 osu.Game.Rulesets.Catch/Beatmaps/CatchBeatmapConverter.cs     | 2 ++
 osu.Game.Rulesets.Catch/Beatmaps/CatchBeatmapProcessor.cs     | 2 ++
 osu.Game.Rulesets.Catch/CatchInputManager.cs                  | 2 ++
 osu.Game.Rulesets.Catch/CatchRuleset.cs                       | 2 ++
 osu.Game.Rulesets.Catch/CatchSkinComponent.cs                 | 2 ++
 osu.Game.Rulesets.Catch/CatchSkinComponents.cs                | 2 ++
 .../Difficulty/CatchDifficultyAttributes.cs                   | 2 ++
 .../Difficulty/CatchDifficultyCalculator.cs                   | 2 ++
 .../Difficulty/CatchPerformanceAttributes.cs                  | 2 ++
 .../Difficulty/CatchPerformanceCalculator.cs                  | 2 ++
 .../Difficulty/Preprocessing/CatchDifficultyHitObject.cs      | 2 ++
 osu.Game.Rulesets.Catch/Difficulty/Skills/Movement.cs         | 2 ++
 osu.Game.Rulesets.Catch/Edit/BananaShowerCompositionTool.cs   | 2 ++
 .../Edit/Blueprints/BananaShowerPlacementBlueprint.cs         | 2 ++
 .../Edit/Blueprints/BananaShowerSelectionBlueprint.cs         | 2 ++
 .../Edit/Blueprints/CatchPlacementBlueprint.cs                | 2 ++
 .../Edit/Blueprints/CatchSelectionBlueprint.cs                | 2 ++
 .../Edit/Blueprints/Components/EditablePath.cs                | 2 ++
 .../Edit/Blueprints/Components/FruitOutline.cs                | 2 ++
 .../Edit/Blueprints/Components/NestedOutlineContainer.cs      | 2 ++
 .../Edit/Blueprints/Components/PlacementEditablePath.cs       | 2 ++
 .../Edit/Blueprints/Components/ScrollingPath.cs               | 2 ++
 .../Edit/Blueprints/Components/SelectionEditablePath.cs       | 2 ++
 .../Edit/Blueprints/Components/TimeSpanOutline.cs             | 2 ++
 .../Edit/Blueprints/Components/VertexPiece.cs                 | 2 ++
 .../Edit/Blueprints/Components/VertexState.cs                 | 2 --
 .../Edit/Blueprints/FruitPlacementBlueprint.cs                | 2 ++
 .../Edit/Blueprints/FruitSelectionBlueprint.cs                | 2 ++
 .../Edit/Blueprints/JuiceStreamPlacementBlueprint.cs          | 2 ++
 .../Edit/Blueprints/JuiceStreamSelectionBlueprint.cs          | 2 ++
 osu.Game.Rulesets.Catch/Edit/CatchBeatmapVerifier.cs          | 2 ++
 osu.Game.Rulesets.Catch/Edit/CatchBlueprintContainer.cs       | 2 ++
 osu.Game.Rulesets.Catch/Edit/CatchDistanceSnapGrid.cs         | 2 ++
 osu.Game.Rulesets.Catch/Edit/CatchEditorPlayfield.cs          | 2 ++
 osu.Game.Rulesets.Catch/Edit/CatchHitObjectComposer.cs        | 2 ++
 osu.Game.Rulesets.Catch/Edit/CatchHitObjectUtils.cs           | 2 ++
 osu.Game.Rulesets.Catch/Edit/CatchSelectionHandler.cs         | 2 ++
 osu.Game.Rulesets.Catch/Edit/Checks/CheckBananaShowerGap.cs   | 2 ++
 osu.Game.Rulesets.Catch/Edit/DrawableCatchEditorRuleset.cs    | 2 ++
 osu.Game.Rulesets.Catch/Edit/FruitCompositionTool.cs          | 2 ++
 osu.Game.Rulesets.Catch/Edit/JuiceStreamCompositionTool.cs    | 2 ++
 osu.Game.Rulesets.Catch/Edit/PositionRange.cs                 | 2 --
 osu.Game.Rulesets.Catch/Judgements/CatchBananaJudgement.cs    | 2 ++
 osu.Game.Rulesets.Catch/Judgements/CatchDropletJudgement.cs   | 2 ++
 osu.Game.Rulesets.Catch/Judgements/CatchJudgement.cs          | 2 ++
 osu.Game.Rulesets.Catch/Judgements/CatchJudgementResult.cs    | 2 ++
 .../Judgements/CatchTinyDropletJudgement.cs                   | 2 ++
 osu.Game.Rulesets.Catch/Mods/CatchModAutoplay.cs              | 2 ++
 osu.Game.Rulesets.Catch/Mods/CatchModCinema.cs                | 2 ++
 osu.Game.Rulesets.Catch/Mods/CatchModClassic.cs               | 2 ++
 osu.Game.Rulesets.Catch/Mods/CatchModDaycore.cs               | 2 ++
 osu.Game.Rulesets.Catch/Mods/CatchModDifficultyAdjust.cs      | 2 ++
 osu.Game.Rulesets.Catch/Mods/CatchModDoubleTime.cs            | 2 ++
 osu.Game.Rulesets.Catch/Mods/CatchModEasy.cs                  | 2 ++
 osu.Game.Rulesets.Catch/Mods/CatchModFlashlight.cs            | 2 ++
 osu.Game.Rulesets.Catch/Mods/CatchModFloatingFruits.cs        | 2 ++
 osu.Game.Rulesets.Catch/Mods/CatchModHalfTime.cs              | 2 ++
 osu.Game.Rulesets.Catch/Mods/CatchModHardRock.cs              | 2 ++
 osu.Game.Rulesets.Catch/Mods/CatchModHidden.cs                | 2 ++
 osu.Game.Rulesets.Catch/Mods/CatchModMirror.cs                | 2 ++
 osu.Game.Rulesets.Catch/Mods/CatchModMuted.cs                 | 2 ++
 osu.Game.Rulesets.Catch/Mods/CatchModNightcore.cs             | 2 ++
 osu.Game.Rulesets.Catch/Mods/CatchModNoFail.cs                | 2 ++
 osu.Game.Rulesets.Catch/Mods/CatchModNoScope.cs               | 2 ++
 osu.Game.Rulesets.Catch/Mods/CatchModPerfect.cs               | 2 ++
 osu.Game.Rulesets.Catch/Mods/CatchModRelax.cs                 | 2 ++
 osu.Game.Rulesets.Catch/Mods/CatchModSuddenDeath.cs           | 2 ++
 osu.Game.Rulesets.Catch/Objects/Banana.cs                     | 2 --
 osu.Game.Rulesets.Catch/Objects/BananaShower.cs               | 2 ++
 osu.Game.Rulesets.Catch/Objects/CatchHitObject.cs             | 2 ++
 osu.Game.Rulesets.Catch/Objects/Drawables/CaughtBanana.cs     | 2 ++
 osu.Game.Rulesets.Catch/Objects/Drawables/CaughtDroplet.cs    | 2 ++
 osu.Game.Rulesets.Catch/Objects/Drawables/CaughtFruit.cs      | 2 ++
 osu.Game.Rulesets.Catch/Objects/Drawables/CaughtObject.cs     | 2 ++
 osu.Game.Rulesets.Catch/Objects/Drawables/DrawableBanana.cs   | 2 ++
 .../Objects/Drawables/DrawableBananaShower.cs                 | 2 ++
 .../Objects/Drawables/DrawableCatchHitObject.cs               | 2 ++
 osu.Game.Rulesets.Catch/Objects/Drawables/DrawableDroplet.cs  | 2 ++
 osu.Game.Rulesets.Catch/Objects/Drawables/DrawableFruit.cs    | 2 ++
 .../Objects/Drawables/DrawableJuiceStream.cs                  | 2 ++
 .../Objects/Drawables/DrawablePalpableCatchHitObject.cs       | 2 ++
 .../Objects/Drawables/DrawableTinyDroplet.cs                  | 2 ++
 .../Objects/Drawables/IHasCatchObjectState.cs                 | 2 ++
 osu.Game.Rulesets.Catch/Objects/Droplet.cs                    | 2 ++
 osu.Game.Rulesets.Catch/Objects/Fruit.cs                      | 2 ++
 osu.Game.Rulesets.Catch/Objects/FruitVisualRepresentation.cs  | 2 ++
 osu.Game.Rulesets.Catch/Objects/JuiceStream.cs                | 2 ++
 osu.Game.Rulesets.Catch/Objects/JuiceStreamPath.cs            | 2 --
 osu.Game.Rulesets.Catch/Objects/JuiceStreamPathVertex.cs      | 2 --
 osu.Game.Rulesets.Catch/Objects/PalpableCatchHitObject.cs     | 2 ++
 osu.Game.Rulesets.Catch/Objects/TinyDroplet.cs                | 2 ++
 osu.Game.Rulesets.Catch/Properties/AssemblyInfo.cs            | 2 ++
 osu.Game.Rulesets.Catch/Replays/CatchAutoGenerator.cs         | 2 ++
 .../Replays/CatchFramedReplayInputHandler.cs                  | 2 ++
 osu.Game.Rulesets.Catch/Replays/CatchReplayFrame.cs           | 2 ++
 osu.Game.Rulesets.Catch/Scoring/CatchScoreProcessor.cs        | 2 ++
 osu.Game.Rulesets.Catch/Skinning/CatchSkinColour.cs           | 2 ++
 osu.Game.Rulesets.Catch/Skinning/CatchSkinConfiguration.cs    | 2 ++
 osu.Game.Rulesets.Catch/Skinning/Default/BananaPiece.cs       | 2 ++
 .../Skinning/Default/BananaPulpFormation.cs                   | 2 ++
 osu.Game.Rulesets.Catch/Skinning/Default/BorderPiece.cs       | 2 ++
 .../Skinning/Default/CatchHitObjectPiece.cs                   | 2 ++
 osu.Game.Rulesets.Catch/Skinning/Default/DefaultCatcher.cs    | 2 ++
 .../Skinning/Default/DefaultHitExplosion.cs                   | 2 ++
 osu.Game.Rulesets.Catch/Skinning/Default/DropletPiece.cs      | 2 ++
 osu.Game.Rulesets.Catch/Skinning/Default/FruitPiece.cs        | 2 ++
 .../Skinning/Default/FruitPulpFormation.cs                    | 2 ++
 osu.Game.Rulesets.Catch/Skinning/Default/HyperBorderPiece.cs  | 2 ++
 .../Skinning/Default/HyperDropletBorderPiece.cs               | 2 ++
 osu.Game.Rulesets.Catch/Skinning/Default/Pulp.cs              | 2 ++
 osu.Game.Rulesets.Catch/Skinning/Default/PulpFormation.cs     | 2 ++
 .../Skinning/Legacy/CatchLegacySkinTransformer.cs             | 2 ++
 osu.Game.Rulesets.Catch/Skinning/Legacy/LegacyBananaPiece.cs  | 2 ++
 .../Skinning/Legacy/LegacyCatchComboCounter.cs                | 2 ++
 .../Skinning/Legacy/LegacyCatchHitObjectPiece.cs              | 2 ++
 osu.Game.Rulesets.Catch/Skinning/Legacy/LegacyCatcherNew.cs   | 2 ++
 osu.Game.Rulesets.Catch/Skinning/Legacy/LegacyCatcherOld.cs   | 2 ++
 osu.Game.Rulesets.Catch/Skinning/Legacy/LegacyDropletPiece.cs | 2 ++
 osu.Game.Rulesets.Catch/Skinning/Legacy/LegacyFruitPiece.cs   | 2 ++
 osu.Game.Rulesets.Catch/Skinning/Legacy/LegacyHitExplosion.cs | 2 ++
 osu.Game.Rulesets.Catch/UI/CatchComboDisplay.cs               | 2 ++
 osu.Game.Rulesets.Catch/UI/CatchPlayfield.cs                  | 2 ++
 .../UI/CatchPlayfieldAdjustmentContainer.cs                   | 2 ++
 osu.Game.Rulesets.Catch/UI/CatchReplayRecorder.cs             | 2 ++
 osu.Game.Rulesets.Catch/UI/Catcher.cs                         | 2 ++
 osu.Game.Rulesets.Catch/UI/CatcherAnimationState.cs           | 2 ++
 osu.Game.Rulesets.Catch/UI/CatcherArea.cs                     | 2 ++
 osu.Game.Rulesets.Catch/UI/CatcherTrail.cs                    | 2 ++
 osu.Game.Rulesets.Catch/UI/CatcherTrailAnimation.cs           | 2 ++
 osu.Game.Rulesets.Catch/UI/CatcherTrailDisplay.cs             | 2 ++
 osu.Game.Rulesets.Catch/UI/CatcherTrailEntry.cs               | 2 ++
 osu.Game.Rulesets.Catch/UI/Direction.cs                       | 2 ++
 osu.Game.Rulesets.Catch/UI/DrawableCatchRuleset.cs            | 2 ++
 osu.Game.Rulesets.Catch/UI/DroppedObjectContainer.cs          | 2 ++
 osu.Game.Rulesets.Catch/UI/HitExplosion.cs                    | 2 --
 osu.Game.Rulesets.Catch/UI/HitExplosionContainer.cs           | 2 ++
 osu.Game.Rulesets.Catch/UI/HitExplosionEntry.cs               | 2 --
 osu.Game.Rulesets.Catch/UI/ICatchComboCounter.cs              | 2 ++
 osu.Game.Rulesets.Catch/UI/IHitExplosion.cs                   | 2 --
 osu.Game.Rulesets.Catch/UI/SkinnableCatcher.cs                | 2 ++
 osu.Game.Rulesets.Mania.Tests.Android/MainActivity.cs         | 2 ++
 osu.Game.Rulesets.Mania.Tests.iOS/AppDelegate.cs              | 2 ++
 osu.Game.Rulesets.Mania.Tests.iOS/Application.cs              | 2 ++
 .../Editor/ManiaPlacementBlueprintTestScene.cs                | 2 ++
 .../Editor/ManiaSelectionBlueprintTestScene.cs                | 2 ++
 osu.Game.Rulesets.Mania.Tests/Editor/TestSceneEditor.cs       | 2 ++
 .../Editor/TestSceneHoldNotePlacementBlueprint.cs             | 2 ++
 .../Editor/TestSceneHoldNoteSelectionBlueprint.cs             | 2 ++
 .../Editor/TestSceneManiaBeatSnapGrid.cs                      | 2 ++
 .../Editor/TestSceneManiaComposeScreen.cs                     | 2 ++
 .../Editor/TestSceneManiaHitObjectComposer.cs                 | 2 ++
 .../Editor/TestSceneNotePlacementBlueprint.cs                 | 2 ++
 .../Editor/TestSceneNoteSelectionBlueprint.cs                 | 2 ++
 osu.Game.Rulesets.Mania.Tests/ManiaBeatmapConversionTest.cs   | 2 ++
 .../ManiaBeatmapSampleConversionTest.cs                       | 2 ++
 osu.Game.Rulesets.Mania.Tests/ManiaColumnTypeTest.cs          | 2 ++
 .../ManiaDifficultyCalculatorTest.cs                          | 2 ++
 osu.Game.Rulesets.Mania.Tests/ManiaInputTestScene.cs          | 2 ++
 osu.Game.Rulesets.Mania.Tests/ManiaLegacyModConversionTest.cs | 2 ++
 osu.Game.Rulesets.Mania.Tests/ManiaLegacyReplayTest.cs        | 2 ++
 .../Mods/TestSceneManiaModConstantSpeed.cs                    | 2 ++
 .../Mods/TestSceneManiaModHoldOff.cs                          | 2 ++
 osu.Game.Rulesets.Mania.Tests/Mods/TestSceneManiaModInvert.cs | 2 ++
 .../Mods/TestSceneManiaModPerfect.cs                          | 2 ++
 osu.Game.Rulesets.Mania.Tests/Skinning/ColumnTestContainer.cs | 2 ++
 .../Skinning/ManiaHitObjectTestScene.cs                       | 2 ++
 .../Skinning/ManiaSkinnableTestScene.cs                       | 2 ++
 .../Skinning/TestSceneColumnBackground.cs                     | 2 ++
 .../Skinning/TestSceneColumnHitObjectArea.cs                  | 2 ++
 .../Skinning/TestSceneDrawableJudgement.cs                    | 2 ++
 .../Skinning/TestSceneHitExplosion.cs                         | 2 ++
 osu.Game.Rulesets.Mania.Tests/Skinning/TestSceneHoldNote.cs   | 2 ++
 osu.Game.Rulesets.Mania.Tests/Skinning/TestSceneKeyArea.cs    | 2 ++
 osu.Game.Rulesets.Mania.Tests/Skinning/TestSceneNote.cs       | 2 ++
 osu.Game.Rulesets.Mania.Tests/Skinning/TestScenePlayfield.cs  | 2 ++
 osu.Game.Rulesets.Mania.Tests/Skinning/TestSceneStage.cs      | 2 ++
 .../Skinning/TestSceneStageBackground.cs                      | 2 ++
 .../Skinning/TestSceneStageForeground.cs                      | 2 ++
 osu.Game.Rulesets.Mania.Tests/TestSceneAutoGeneration.cs      | 2 ++
 osu.Game.Rulesets.Mania.Tests/TestSceneColumn.cs              | 2 ++
 .../TestSceneDrawableManiaHitObject.cs                        | 2 ++
 osu.Game.Rulesets.Mania.Tests/TestSceneHoldNoteInput.cs       | 2 ++
 .../TestSceneManiaHitObjectSamples.cs                         | 2 ++
 osu.Game.Rulesets.Mania.Tests/TestSceneManiaPlayer.cs         | 2 ++
 osu.Game.Rulesets.Mania.Tests/TestSceneNotes.cs               | 2 ++
 osu.Game.Rulesets.Mania.Tests/TestSceneOutOfOrderHits.cs      | 2 ++
 .../TestScenePlayfieldCoveringContainer.cs                    | 2 ++
 osu.Game.Rulesets.Mania.Tests/TestSceneStage.cs               | 2 ++
 .../TestSceneTimingBasedNoteColouring.cs                      | 2 ++
 osu.Game.Rulesets.Mania/Beatmaps/ColumnType.cs                | 2 ++
 osu.Game.Rulesets.Mania/Beatmaps/ManiaBeatmap.cs              | 2 ++
 osu.Game.Rulesets.Mania/Beatmaps/ManiaBeatmapConverter.cs     | 2 ++
 .../Patterns/Legacy/DistanceObjectPatternGenerator.cs         | 2 ++
 .../Beatmaps/Patterns/Legacy/EndTimeObjectPatternGenerator.cs | 2 ++
 .../Beatmaps/Patterns/Legacy/HitObjectPatternGenerator.cs     | 2 ++
 .../Beatmaps/Patterns/Legacy/PatternGenerator.cs              | 2 ++
 .../Beatmaps/Patterns/Legacy/PatternType.cs                   | 2 ++
 osu.Game.Rulesets.Mania/Beatmaps/Patterns/Pattern.cs          | 2 ++
 osu.Game.Rulesets.Mania/Beatmaps/Patterns/PatternGenerator.cs | 2 ++
 osu.Game.Rulesets.Mania/Beatmaps/StageDefinition.cs           | 2 ++
 .../Configuration/ManiaRulesetConfigManager.cs                | 2 ++
 .../Difficulty/ManiaDifficultyAttributes.cs                   | 2 ++
 .../Difficulty/ManiaDifficultyCalculator.cs                   | 2 ++
 .../Difficulty/ManiaPerformanceAttributes.cs                  | 2 ++
 .../Difficulty/ManiaPerformanceCalculator.cs                  | 2 ++
 .../Difficulty/Preprocessing/ManiaDifficultyHitObject.cs      | 2 ++
 osu.Game.Rulesets.Mania/Difficulty/Skills/Strain.cs           | 2 ++
 osu.Game.Rulesets.Mania/DualStageVariantGenerator.cs          | 2 ++
 .../Edit/Blueprints/Components/EditBodyPiece.cs               | 2 ++
 .../Edit/Blueprints/Components/EditNotePiece.cs               | 2 ++
 .../Edit/Blueprints/HoldNotePlacementBlueprint.cs             | 2 ++
 .../Edit/Blueprints/HoldNoteSelectionBlueprint.cs             | 2 ++
 .../Edit/Blueprints/ManiaPlacementBlueprint.cs                | 2 ++
 .../Edit/Blueprints/ManiaSelectionBlueprint.cs                | 2 ++
 .../Edit/Blueprints/NotePlacementBlueprint.cs                 | 2 ++
 .../Edit/Blueprints/NoteSelectionBlueprint.cs                 | 2 ++
 osu.Game.Rulesets.Mania/Edit/DrawableManiaEditorRuleset.cs    | 2 ++
 osu.Game.Rulesets.Mania/Edit/HoldNoteCompositionTool.cs       | 2 ++
 osu.Game.Rulesets.Mania/Edit/ManiaBeatSnapGrid.cs             | 2 ++
 osu.Game.Rulesets.Mania/Edit/ManiaBlueprintContainer.cs       | 2 ++
 osu.Game.Rulesets.Mania/Edit/ManiaEditorPlayfield.cs          | 2 ++
 osu.Game.Rulesets.Mania/Edit/ManiaHitObjectComposer.cs        | 2 ++
 osu.Game.Rulesets.Mania/Edit/ManiaSelectionHandler.cs         | 2 ++
 osu.Game.Rulesets.Mania/Edit/NoteCompositionTool.cs           | 2 ++
 osu.Game.Rulesets.Mania/Edit/Setup/ManiaSetupSection.cs       | 2 ++
 osu.Game.Rulesets.Mania/Judgements/HoldNoteTickJudgement.cs   | 2 ++
 osu.Game.Rulesets.Mania/Judgements/ManiaJudgement.cs          | 2 ++
 osu.Game.Rulesets.Mania/ManiaFilterCriteria.cs                | 2 ++
 osu.Game.Rulesets.Mania/ManiaInputManager.cs                  | 2 ++
 osu.Game.Rulesets.Mania/ManiaRuleset.cs                       | 2 ++
 osu.Game.Rulesets.Mania/ManiaSettingsSubsection.cs            | 2 ++
 osu.Game.Rulesets.Mania/ManiaSkinComponent.cs                 | 2 ++
 osu.Game.Rulesets.Mania/MathUtils/LegacySortHelper.cs         | 2 ++
 osu.Game.Rulesets.Mania/Mods/IPlayfieldTypeMod.cs             | 2 ++
 osu.Game.Rulesets.Mania/Mods/ManiaKeyMod.cs                   | 2 ++
 osu.Game.Rulesets.Mania/Mods/ManiaModAutoplay.cs              | 2 ++
 osu.Game.Rulesets.Mania/Mods/ManiaModCinema.cs                | 2 ++
 osu.Game.Rulesets.Mania/Mods/ManiaModClassic.cs               | 2 ++
 osu.Game.Rulesets.Mania/Mods/ManiaModConstantSpeed.cs         | 2 ++
 osu.Game.Rulesets.Mania/Mods/ManiaModDaycore.cs               | 2 ++
 osu.Game.Rulesets.Mania/Mods/ManiaModDifficultyAdjust.cs      | 2 ++
 osu.Game.Rulesets.Mania/Mods/ManiaModDoubleTime.cs            | 2 ++
 osu.Game.Rulesets.Mania/Mods/ManiaModDualStages.cs            | 2 ++
 osu.Game.Rulesets.Mania/Mods/ManiaModEasy.cs                  | 2 ++
 osu.Game.Rulesets.Mania/Mods/ManiaModFadeIn.cs                | 2 ++
 osu.Game.Rulesets.Mania/Mods/ManiaModFlashlight.cs            | 2 ++
 osu.Game.Rulesets.Mania/Mods/ManiaModHalfTime.cs              | 2 ++
 osu.Game.Rulesets.Mania/Mods/ManiaModHardRock.cs              | 2 ++
 osu.Game.Rulesets.Mania/Mods/ManiaModHidden.cs                | 2 ++
 osu.Game.Rulesets.Mania/Mods/ManiaModHoldOff.cs               | 2 ++
 osu.Game.Rulesets.Mania/Mods/ManiaModInvert.cs                | 2 ++
 osu.Game.Rulesets.Mania/Mods/ManiaModKey1.cs                  | 2 ++
 osu.Game.Rulesets.Mania/Mods/ManiaModKey10.cs                 | 2 ++
 osu.Game.Rulesets.Mania/Mods/ManiaModKey2.cs                  | 2 ++
 osu.Game.Rulesets.Mania/Mods/ManiaModKey3.cs                  | 2 ++
 osu.Game.Rulesets.Mania/Mods/ManiaModKey4.cs                  | 2 ++
 osu.Game.Rulesets.Mania/Mods/ManiaModKey5.cs                  | 2 ++
 osu.Game.Rulesets.Mania/Mods/ManiaModKey6.cs                  | 2 ++
 osu.Game.Rulesets.Mania/Mods/ManiaModKey7.cs                  | 2 ++
 osu.Game.Rulesets.Mania/Mods/ManiaModKey8.cs                  | 2 ++
 osu.Game.Rulesets.Mania/Mods/ManiaModKey9.cs                  | 2 ++
 osu.Game.Rulesets.Mania/Mods/ManiaModMirror.cs                | 2 ++
 osu.Game.Rulesets.Mania/Mods/ManiaModMuted.cs                 | 2 ++
 osu.Game.Rulesets.Mania/Mods/ManiaModNightcore.cs             | 2 ++
 osu.Game.Rulesets.Mania/Mods/ManiaModNoFail.cs                | 2 ++
 osu.Game.Rulesets.Mania/Mods/ManiaModPerfect.cs               | 2 ++
 osu.Game.Rulesets.Mania/Mods/ManiaModPlayfieldCover.cs        | 2 ++
 osu.Game.Rulesets.Mania/Mods/ManiaModRandom.cs                | 2 ++
 osu.Game.Rulesets.Mania/Mods/ManiaModSuddenDeath.cs           | 2 ++
 osu.Game.Rulesets.Mania/Objects/BarLine.cs                    | 2 ++
 osu.Game.Rulesets.Mania/Objects/Drawables/DrawableBarLine.cs  | 2 ++
 osu.Game.Rulesets.Mania/Objects/Drawables/DrawableHoldNote.cs | 2 ++
 .../Objects/Drawables/DrawableHoldNoteHead.cs                 | 2 ++
 .../Objects/Drawables/DrawableHoldNoteTail.cs                 | 2 ++
 .../Objects/Drawables/DrawableHoldNoteTick.cs                 | 2 ++
 .../Objects/Drawables/DrawableManiaHitObject.cs               | 2 ++
 osu.Game.Rulesets.Mania/Objects/Drawables/DrawableNote.cs     | 2 ++
 osu.Game.Rulesets.Mania/Objects/HeadNote.cs                   | 2 ++
 osu.Game.Rulesets.Mania/Objects/HoldNote.cs                   | 2 ++
 osu.Game.Rulesets.Mania/Objects/HoldNoteTick.cs               | 2 ++
 osu.Game.Rulesets.Mania/Objects/ManiaHitObject.cs             | 2 ++
 osu.Game.Rulesets.Mania/Objects/Note.cs                       | 2 ++
 osu.Game.Rulesets.Mania/Objects/TailNote.cs                   | 2 ++
 osu.Game.Rulesets.Mania/Properties/AssemblyInfo.cs            | 2 ++
 osu.Game.Rulesets.Mania/Replays/ManiaAutoGenerator.cs         | 2 ++
 .../Replays/ManiaFramedReplayInputHandler.cs                  | 2 ++
 osu.Game.Rulesets.Mania/Replays/ManiaReplayFrame.cs           | 2 ++
 osu.Game.Rulesets.Mania/Scoring/ManiaHealthProcessor.cs       | 2 ++
 osu.Game.Rulesets.Mania/Scoring/ManiaHitWindows.cs            | 2 ++
 osu.Game.Rulesets.Mania/Scoring/ManiaScoreProcessor.cs        | 2 ++
 osu.Game.Rulesets.Mania/SingleStageVariantGenerator.cs        | 2 ++
 osu.Game.Rulesets.Mania/Skinning/Default/DefaultBodyPiece.cs  | 2 ++
 osu.Game.Rulesets.Mania/Skinning/Default/DefaultNotePiece.cs  | 2 ++
 osu.Game.Rulesets.Mania/Skinning/Default/IHoldNoteBody.cs     | 2 ++
 .../Skinning/Legacy/HitTargetInsetContainer.cs                | 2 ++
 osu.Game.Rulesets.Mania/Skinning/Legacy/LegacyBodyPiece.cs    | 2 ++
 .../Skinning/Legacy/LegacyColumnBackground.cs                 | 2 ++
 osu.Game.Rulesets.Mania/Skinning/Legacy/LegacyHitExplosion.cs | 2 ++
 osu.Game.Rulesets.Mania/Skinning/Legacy/LegacyHitTarget.cs    | 2 ++
 .../Skinning/Legacy/LegacyHoldNoteHeadPiece.cs                | 2 ++
 .../Skinning/Legacy/LegacyHoldNoteTailPiece.cs                | 2 ++
 osu.Game.Rulesets.Mania/Skinning/Legacy/LegacyKeyArea.cs      | 2 ++
 .../Skinning/Legacy/LegacyManiaColumnElement.cs               | 2 ++
 .../Skinning/Legacy/LegacyManiaJudgementPiece.cs              | 2 ++
 osu.Game.Rulesets.Mania/Skinning/Legacy/LegacyNotePiece.cs    | 2 ++
 .../Skinning/Legacy/LegacyStageBackground.cs                  | 2 ++
 .../Skinning/Legacy/LegacyStageForeground.cs                  | 2 ++
 .../Skinning/Legacy/ManiaLegacySkinTransformer.cs             | 2 ++
 osu.Game.Rulesets.Mania/Skinning/ManiaSkinConfigExtensions.cs | 2 ++
 .../Skinning/ManiaSkinConfigurationLookup.cs                  | 2 ++
 osu.Game.Rulesets.Mania/UI/Column.cs                          | 2 ++
 osu.Game.Rulesets.Mania/UI/ColumnFlow.cs                      | 2 ++
 osu.Game.Rulesets.Mania/UI/Components/ColumnBackground.cs     | 2 ++
 osu.Game.Rulesets.Mania/UI/Components/ColumnHitObjectArea.cs  | 2 ++
 .../UI/Components/DefaultColumnBackground.cs                  | 2 ++
 osu.Game.Rulesets.Mania/UI/Components/DefaultHitTarget.cs     | 2 ++
 osu.Game.Rulesets.Mania/UI/Components/DefaultKeyArea.cs       | 2 ++
 .../UI/Components/DefaultStageBackground.cs                   | 2 ++
 osu.Game.Rulesets.Mania/UI/Components/HitObjectArea.cs        | 2 ++
 osu.Game.Rulesets.Mania/UI/DefaultHitExplosion.cs             | 2 ++
 osu.Game.Rulesets.Mania/UI/DrawableManiaJudgement.cs          | 2 ++
 osu.Game.Rulesets.Mania/UI/DrawableManiaRuleset.cs            | 2 ++
 osu.Game.Rulesets.Mania/UI/IHitExplosion.cs                   | 2 ++
 osu.Game.Rulesets.Mania/UI/ManiaPlayfield.cs                  | 2 ++
 .../UI/ManiaPlayfieldAdjustmentContainer.cs                   | 2 ++
 osu.Game.Rulesets.Mania/UI/ManiaReplayRecorder.cs             | 2 ++
 osu.Game.Rulesets.Mania/UI/ManiaScrollingDirection.cs         | 2 ++
 osu.Game.Rulesets.Mania/UI/OrderedHitPolicy.cs                | 2 ++
 osu.Game.Rulesets.Mania/UI/PlayfieldCoveringWrapper.cs        | 2 ++
 osu.Game.Rulesets.Mania/UI/PoolableHitExplosion.cs            | 2 ++
 osu.Game.Rulesets.Mania/UI/Stage.cs                           | 2 ++
 osu.Game.Rulesets.Mania/VariantMappingGenerator.cs            | 2 ++
 osu.Game.Rulesets.Osu.Tests.Android/MainActivity.cs           | 2 ++
 osu.Game.Rulesets.Osu.Tests.iOS/AppDelegate.cs                | 2 ++
 osu.Game.Rulesets.Osu.Tests.iOS/Application.cs                | 2 ++
 .../Editor/Checks/CheckLowDiffOverlapsTest.cs                 | 2 ++
 .../Editor/Checks/CheckOffscreenObjectsTest.cs                | 2 ++
 .../Editor/Checks/CheckTimeDistanceEqualityTest.cs            | 2 ++
 .../Editor/Checks/CheckTooShortSlidersTest.cs                 | 2 ++
 .../Editor/Checks/CheckTooShortSpinnersTest.cs                | 2 ++
 .../Editor/TestSceneHitCirclePlacementBlueprint.cs            | 2 ++
 .../Editor/TestSceneHitCircleSelectionBlueprint.cs            | 2 ++
 osu.Game.Rulesets.Osu.Tests/Editor/TestSceneObjectBeatSnap.cs | 2 ++
 .../Editor/TestSceneObjectObjectSnap.cs                       | 2 ++
 .../Editor/TestSceneOsuDistanceSnapGrid.cs                    | 2 ++
 osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuEditor.cs      | 2 ++
 osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuEditorGrids.cs | 2 ++
 .../Editor/TestSceneOsuEditorSelectInvalidPath.cs             | 2 ++
 .../Editor/TestScenePathControlPointVisualiser.cs             | 2 ++
 .../Editor/TestSceneSliderControlPointPiece.cs                | 2 ++
 .../Editor/TestSceneSliderLengthValidity.cs                   | 2 ++
 .../Editor/TestSceneSliderPlacementBlueprint.cs               | 2 ++
 .../Editor/TestSceneSliderSelectionBlueprint.cs               | 2 ++
 osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderSnapping.cs | 2 ++
 .../Editor/TestSceneSliderStreamConversion.cs                 | 2 ++
 .../Editor/TestSceneSliderVelocityAdjust.cs                   | 2 ++
 .../Editor/TestSceneSpinnerPlacementBlueprint.cs              | 2 ++
 .../Editor/TestSceneSpinnerSelectionBlueprint.cs              | 2 ++
 osu.Game.Rulesets.Osu.Tests/Editor/TestSliderScaling.cs       | 2 ++
 osu.Game.Rulesets.Osu.Tests/LegacyMainCirclePieceTest.cs      | 2 --
 osu.Game.Rulesets.Osu.Tests/Mods/OsuModTestScene.cs           | 2 ++
 osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModAlternate.cs  | 2 ++
 osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModAutoplay.cs   | 2 ++
 .../Mods/TestSceneOsuModDifficultyAdjust.cs                   | 2 ++
 osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModDoubleTime.cs | 2 ++
 osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModHidden.cs     | 2 ++
 osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModMagnetised.cs | 2 ++
 osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModMuted.cs      | 2 ++
 osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModNoScope.cs    | 2 ++
 osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModPerfect.cs    | 2 ++
 osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModSpunOut.cs    | 2 ++
 osu.Game.Rulesets.Osu.Tests/OsuBeatmapConversionTest.cs       | 2 ++
 osu.Game.Rulesets.Osu.Tests/OsuDifficultyCalculatorTest.cs    | 2 ++
 osu.Game.Rulesets.Osu.Tests/OsuLegacyModConversionTest.cs     | 2 ++
 osu.Game.Rulesets.Osu.Tests/OsuSkinnableTestScene.cs          | 2 ++
 osu.Game.Rulesets.Osu.Tests/StackingTest.cs                   | 2 ++
 osu.Game.Rulesets.Osu.Tests/TestPlayfieldBorder.cs            | 2 ++
 osu.Game.Rulesets.Osu.Tests/TestSceneAccuracyHeatmap.cs       | 2 ++
 osu.Game.Rulesets.Osu.Tests/TestSceneCursorParticles.cs       | 2 ++
 osu.Game.Rulesets.Osu.Tests/TestSceneCursorTrail.cs           | 2 ++
 osu.Game.Rulesets.Osu.Tests/TestSceneDrawableJudgement.cs     | 2 ++
 osu.Game.Rulesets.Osu.Tests/TestSceneFollowPoints.cs          | 2 ++
 osu.Game.Rulesets.Osu.Tests/TestSceneGameplayCursor.cs        | 2 ++
 osu.Game.Rulesets.Osu.Tests/TestSceneHitCircle.cs             | 2 ++
 osu.Game.Rulesets.Osu.Tests/TestSceneHitCircleApplication.cs  | 2 ++
 osu.Game.Rulesets.Osu.Tests/TestSceneHitCircleArea.cs         | 2 ++
 osu.Game.Rulesets.Osu.Tests/TestSceneHitCircleComboChange.cs  | 2 ++
 osu.Game.Rulesets.Osu.Tests/TestSceneHitCircleHidden.cs       | 2 ++
 osu.Game.Rulesets.Osu.Tests/TestSceneHitCircleKiai.cs         | 2 ++
 osu.Game.Rulesets.Osu.Tests/TestSceneHitCircleLongCombo.cs    | 2 ++
 osu.Game.Rulesets.Osu.Tests/TestSceneLegacyBeatmapSkin.cs     | 2 ++
 .../TestSceneMissHitWindowJudgements.cs                       | 2 ++
 osu.Game.Rulesets.Osu.Tests/TestSceneNoSpinnerStacking.cs     | 2 ++
 .../TestSceneObjectOrderedHitPolicy.cs                        | 2 ++
 osu.Game.Rulesets.Osu.Tests/TestSceneOsuFlashlight.cs         | 2 ++
 osu.Game.Rulesets.Osu.Tests/TestSceneOsuHitObjectSamples.cs   | 2 ++
 osu.Game.Rulesets.Osu.Tests/TestSceneOsuPlayer.cs             | 2 ++
 osu.Game.Rulesets.Osu.Tests/TestSceneResumeOverlay.cs         | 2 ++
 osu.Game.Rulesets.Osu.Tests/TestSceneShaking.cs               | 2 ++
 osu.Game.Rulesets.Osu.Tests/TestSceneSkinFallbacks.cs         | 2 ++
 osu.Game.Rulesets.Osu.Tests/TestSceneSlider.cs                | 2 ++
 osu.Game.Rulesets.Osu.Tests/TestSceneSliderApplication.cs     | 2 ++
 osu.Game.Rulesets.Osu.Tests/TestSceneSliderComboChange.cs     | 2 ++
 osu.Game.Rulesets.Osu.Tests/TestSceneSliderHidden.cs          | 2 ++
 osu.Game.Rulesets.Osu.Tests/TestSceneSliderInput.cs           | 2 ++
 osu.Game.Rulesets.Osu.Tests/TestSceneSliderSnaking.cs         | 2 ++
 osu.Game.Rulesets.Osu.Tests/TestSceneSpinner.cs               | 2 ++
 osu.Game.Rulesets.Osu.Tests/TestSceneSpinnerApplication.cs    | 2 ++
 osu.Game.Rulesets.Osu.Tests/TestSceneSpinnerHidden.cs         | 2 ++
 osu.Game.Rulesets.Osu.Tests/TestSceneSpinnerRotation.cs       | 2 ++
 .../TestSceneStartTimeOrderedHitPolicy.cs                     | 2 ++
 osu.Game.Rulesets.Osu/Beatmaps/OsuBeatmap.cs                  | 2 ++
 osu.Game.Rulesets.Osu/Beatmaps/OsuBeatmapConverter.cs         | 2 ++
 osu.Game.Rulesets.Osu/Beatmaps/OsuBeatmapProcessor.cs         | 2 ++
 .../Configuration/OsuRulesetConfigManager.cs                  | 2 ++
 osu.Game.Rulesets.Osu/Difficulty/Evaluators/AimEvaluator.cs   | 2 ++
 .../Difficulty/Evaluators/FlashlightEvaluator.cs              | 2 ++
 .../Difficulty/Evaluators/RhythmEvaluator.cs                  | 2 ++
 osu.Game.Rulesets.Osu/Difficulty/Evaluators/SpeedEvaluator.cs | 2 ++
 osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyAttributes.cs   | 2 ++
 osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs   | 2 ++
 osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceAttributes.cs  | 2 ++
 osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs  | 2 ++
 .../Difficulty/Preprocessing/OsuDifficultyHitObject.cs        | 2 ++
 osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs                | 2 ++
 osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs         | 2 ++
 osu.Game.Rulesets.Osu/Difficulty/Skills/OsuStrainSkill.cs     | 2 ++
 osu.Game.Rulesets.Osu/Difficulty/Skills/Speed.cs              | 2 ++
 osu.Game.Rulesets.Osu/Edit/Blueprints/BlueprintPiece.cs       | 2 ++
 .../HitCircles/Components/HitCircleOverlapMarker.cs           | 2 ++
 .../Edit/Blueprints/HitCircles/Components/HitCirclePiece.cs   | 2 ++
 .../Edit/Blueprints/HitCircles/HitCirclePlacementBlueprint.cs | 2 ++
 .../Edit/Blueprints/HitCircles/HitCircleSelectionBlueprint.cs | 2 ++
 .../Edit/Blueprints/OsuSelectionBlueprint.cs                  | 2 ++
 .../Sliders/Components/PathControlPointConnectionPiece.cs     | 2 ++
 .../Blueprints/Sliders/Components/PathControlPointPiece.cs    | 2 ++
 .../Sliders/Components/PathControlPointVisualiser.cs          | 2 ++
 .../Edit/Blueprints/Sliders/Components/SliderBodyPiece.cs     | 2 ++
 .../Edit/Blueprints/Sliders/SliderCircleOverlay.cs            | 2 ++
 .../Edit/Blueprints/Sliders/SliderPlacementBlueprint.cs       | 2 ++
 .../Edit/Blueprints/Sliders/SliderPosition.cs                 | 2 ++
 .../Edit/Blueprints/Sliders/SliderSelectionBlueprint.cs       | 2 ++
 .../Edit/Blueprints/Spinners/Components/SpinnerPiece.cs       | 2 ++
 .../Edit/Blueprints/Spinners/SpinnerPlacementBlueprint.cs     | 2 ++
 .../Edit/Blueprints/Spinners/SpinnerSelectionBlueprint.cs     | 2 ++
 osu.Game.Rulesets.Osu/Edit/Checks/CheckLowDiffOverlaps.cs     | 2 ++
 osu.Game.Rulesets.Osu/Edit/Checks/CheckOffscreenObjects.cs    | 2 ++
 .../Edit/Checks/CheckTimeDistanceEquality.cs                  | 2 ++
 osu.Game.Rulesets.Osu/Edit/Checks/CheckTooShortSliders.cs     | 2 ++
 osu.Game.Rulesets.Osu/Edit/Checks/CheckTooShortSpinners.cs    | 2 ++
 osu.Game.Rulesets.Osu/Edit/DrawableOsuEditorRuleset.cs        | 2 ++
 osu.Game.Rulesets.Osu/Edit/HitCircleCompositionTool.cs        | 2 ++
 osu.Game.Rulesets.Osu/Edit/OsuBeatmapVerifier.cs              | 2 ++
 osu.Game.Rulesets.Osu/Edit/OsuBlueprintContainer.cs           | 2 ++
 osu.Game.Rulesets.Osu/Edit/OsuDistanceSnapGrid.cs             | 2 ++
 osu.Game.Rulesets.Osu/Edit/OsuHitObjectComposer.cs            | 2 ++
 osu.Game.Rulesets.Osu/Edit/OsuRectangularPositionSnapGrid.cs  | 2 ++
 osu.Game.Rulesets.Osu/Edit/OsuSelectionHandler.cs             | 2 --
 osu.Game.Rulesets.Osu/Edit/Setup/OsuSetupSection.cs           | 2 ++
 osu.Game.Rulesets.Osu/Edit/SliderCompositionTool.cs           | 2 ++
 osu.Game.Rulesets.Osu/Edit/SpinnerCompositionTool.cs          | 2 ++
 osu.Game.Rulesets.Osu/Judgements/ComboResult.cs               | 2 ++
 .../Judgements/OsuHitCircleJudgementResult.cs                 | 2 ++
 osu.Game.Rulesets.Osu/Judgements/OsuIgnoreJudgement.cs        | 2 ++
 osu.Game.Rulesets.Osu/Judgements/OsuJudgement.cs              | 2 ++
 osu.Game.Rulesets.Osu/Judgements/OsuJudgementResult.cs        | 2 ++
 osu.Game.Rulesets.Osu/Judgements/OsuSpinnerJudgementResult.cs | 2 ++
 osu.Game.Rulesets.Osu/Judgements/SliderTickJudgement.cs       | 2 ++
 osu.Game.Rulesets.Osu/Mods/IHidesApproachCircles.cs           | 2 ++
 osu.Game.Rulesets.Osu/Mods/IRequiresApproachCircles.cs        | 2 ++
 osu.Game.Rulesets.Osu/Mods/OsuModAlternate.cs                 | 2 ++
 osu.Game.Rulesets.Osu/Mods/OsuModApproachDifferent.cs         | 2 ++
 osu.Game.Rulesets.Osu/Mods/OsuModAutopilot.cs                 | 2 ++
 osu.Game.Rulesets.Osu/Mods/OsuModAutoplay.cs                  | 2 ++
 osu.Game.Rulesets.Osu/Mods/OsuModBarrelRoll.cs                | 2 ++
 osu.Game.Rulesets.Osu/Mods/OsuModBlinds.cs                    | 2 ++
 osu.Game.Rulesets.Osu/Mods/OsuModCinema.cs                    | 2 ++
 osu.Game.Rulesets.Osu/Mods/OsuModClassic.cs                   | 2 ++
 osu.Game.Rulesets.Osu/Mods/OsuModDaycore.cs                   | 2 ++
 osu.Game.Rulesets.Osu/Mods/OsuModDeflate.cs                   | 2 ++
 osu.Game.Rulesets.Osu/Mods/OsuModDifficultyAdjust.cs          | 2 ++
 osu.Game.Rulesets.Osu/Mods/OsuModDoubleTime.cs                | 2 ++
 osu.Game.Rulesets.Osu/Mods/OsuModEasy.cs                      | 2 ++
 osu.Game.Rulesets.Osu/Mods/OsuModFlashlight.cs                | 2 ++
 osu.Game.Rulesets.Osu/Mods/OsuModGrow.cs                      | 2 ++
 osu.Game.Rulesets.Osu/Mods/OsuModHalfTime.cs                  | 2 ++
 osu.Game.Rulesets.Osu/Mods/OsuModHardRock.cs                  | 2 ++
 osu.Game.Rulesets.Osu/Mods/OsuModHidden.cs                    | 2 ++
 osu.Game.Rulesets.Osu/Mods/OsuModMagnetised.cs                | 2 ++
 osu.Game.Rulesets.Osu/Mods/OsuModMirror.cs                    | 2 ++
 osu.Game.Rulesets.Osu/Mods/OsuModMuted.cs                     | 2 ++
 osu.Game.Rulesets.Osu/Mods/OsuModNightcore.cs                 | 2 ++
 osu.Game.Rulesets.Osu/Mods/OsuModNoFail.cs                    | 2 ++
 osu.Game.Rulesets.Osu/Mods/OsuModNoScope.cs                   | 2 ++
 osu.Game.Rulesets.Osu/Mods/OsuModObjectScaleTween.cs          | 2 ++
 osu.Game.Rulesets.Osu/Mods/OsuModPerfect.cs                   | 2 ++
 osu.Game.Rulesets.Osu/Mods/OsuModRandom.cs                    | 2 --
 osu.Game.Rulesets.Osu/Mods/OsuModRelax.cs                     | 2 ++
 osu.Game.Rulesets.Osu/Mods/OsuModSpinIn.cs                    | 2 ++
 osu.Game.Rulesets.Osu/Mods/OsuModSpunOut.cs                   | 2 ++
 osu.Game.Rulesets.Osu/Mods/OsuModStrictTracking.cs            | 2 ++
 osu.Game.Rulesets.Osu/Mods/OsuModSuddenDeath.cs               | 2 ++
 osu.Game.Rulesets.Osu/Mods/OsuModTarget.cs                    | 2 ++
 osu.Game.Rulesets.Osu/Mods/OsuModTouchDevice.cs               | 2 ++
 osu.Game.Rulesets.Osu/Mods/OsuModTraceable.cs                 | 2 ++
 osu.Game.Rulesets.Osu/Mods/OsuModTransform.cs                 | 2 ++
 osu.Game.Rulesets.Osu/Mods/OsuModWiggle.cs                    | 2 ++
 .../Objects/Drawables/Connections/FollowPoint.cs              | 2 ++
 .../Objects/Drawables/Connections/FollowPointConnection.cs    | 2 ++
 .../Objects/Drawables/Connections/FollowPointLifetimeEntry.cs | 2 --
 .../Objects/Drawables/Connections/FollowPointRenderer.cs      | 2 ++
 osu.Game.Rulesets.Osu/Objects/Drawables/DrawableHitCircle.cs  | 2 ++
 .../Objects/Drawables/DrawableOsuHitObject.cs                 | 2 ++
 .../Objects/Drawables/DrawableOsuJudgement.cs                 | 2 ++
 osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSlider.cs     | 2 ++
 osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSliderHead.cs | 2 ++
 .../Objects/Drawables/DrawableSliderRepeat.cs                 | 2 ++
 osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSliderTail.cs | 2 ++
 osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSliderTick.cs | 2 ++
 osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSpinner.cs    | 2 ++
 .../Objects/Drawables/DrawableSpinnerBonusTick.cs             | 2 ++
 .../Objects/Drawables/DrawableSpinnerTick.cs                  | 2 ++
 osu.Game.Rulesets.Osu/Objects/Drawables/IRequireTracking.cs   | 2 ++
 osu.Game.Rulesets.Osu/Objects/Drawables/ITrackSnaking.cs      | 2 ++
 osu.Game.Rulesets.Osu/Objects/Drawables/SkinnableLighting.cs  | 2 ++
 osu.Game.Rulesets.Osu/Objects/HitCircle.cs                    | 2 ++
 osu.Game.Rulesets.Osu/Objects/ISliderProgress.cs              | 2 ++
 osu.Game.Rulesets.Osu/Objects/OsuHitObject.cs                 | 2 ++
 osu.Game.Rulesets.Osu/Objects/Slider.cs                       | 2 ++
 osu.Game.Rulesets.Osu/Objects/SliderEndCircle.cs              | 2 ++
 osu.Game.Rulesets.Osu/Objects/SliderHeadCircle.cs             | 2 ++
 osu.Game.Rulesets.Osu/Objects/SliderRepeat.cs                 | 2 ++
 osu.Game.Rulesets.Osu/Objects/SliderTailCircle.cs             | 2 ++
 osu.Game.Rulesets.Osu/Objects/SliderTick.cs                   | 2 ++
 osu.Game.Rulesets.Osu/Objects/Spinner.cs                      | 2 ++
 osu.Game.Rulesets.Osu/Objects/SpinnerBonusTick.cs             | 2 ++
 osu.Game.Rulesets.Osu/Objects/SpinnerTick.cs                  | 2 ++
 osu.Game.Rulesets.Osu/OsuInputManager.cs                      | 2 ++
 osu.Game.Rulesets.Osu/OsuRuleset.cs                           | 2 ++
 osu.Game.Rulesets.Osu/OsuSkinComponent.cs                     | 2 ++
 osu.Game.Rulesets.Osu/OsuSkinComponents.cs                    | 2 ++
 osu.Game.Rulesets.Osu/Properties/AssemblyInfo.cs              | 2 ++
 osu.Game.Rulesets.Osu/Replays/OsuAutoGenerator.cs             | 2 ++
 osu.Game.Rulesets.Osu/Replays/OsuAutoGeneratorBase.cs         | 2 ++
 osu.Game.Rulesets.Osu/Replays/OsuFramedReplayInputHandler.cs  | 2 ++
 osu.Game.Rulesets.Osu/Replays/OsuReplayFrame.cs               | 2 ++
 osu.Game.Rulesets.Osu/Scoring/OsuHitWindows.cs                | 2 ++
 osu.Game.Rulesets.Osu/Scoring/OsuScoreProcessor.cs            | 2 ++
 osu.Game.Rulesets.Osu/Skinning/Default/CirclePiece.cs         | 2 ++
 .../Skinning/Default/DefaultApproachCircle.cs                 | 2 ++
 osu.Game.Rulesets.Osu/Skinning/Default/DefaultSpinner.cs      | 2 ++
 osu.Game.Rulesets.Osu/Skinning/Default/DefaultSpinnerDisc.cs  | 2 ++
 osu.Game.Rulesets.Osu/Skinning/Default/DrawableSliderPath.cs  | 2 ++
 osu.Game.Rulesets.Osu/Skinning/Default/ExplodePiece.cs        | 2 ++
 osu.Game.Rulesets.Osu/Skinning/Default/FlashPiece.cs          | 2 ++
 osu.Game.Rulesets.Osu/Skinning/Default/GlowPiece.cs           | 2 ++
 osu.Game.Rulesets.Osu/Skinning/Default/IHasMainCirclePiece.cs | 2 ++
 osu.Game.Rulesets.Osu/Skinning/Default/KiaiFlash.cs           | 2 ++
 osu.Game.Rulesets.Osu/Skinning/Default/MainCirclePiece.cs     | 2 ++
 osu.Game.Rulesets.Osu/Skinning/Default/ManualSliderBody.cs    | 2 ++
 osu.Game.Rulesets.Osu/Skinning/Default/NumberPiece.cs         | 2 ++
 osu.Game.Rulesets.Osu/Skinning/Default/PlaySliderBody.cs      | 2 ++
 osu.Game.Rulesets.Osu/Skinning/Default/ReverseArrowPiece.cs   | 2 ++
 osu.Game.Rulesets.Osu/Skinning/Default/RingPiece.cs           | 2 ++
 osu.Game.Rulesets.Osu/Skinning/Default/SliderBall.cs          | 2 ++
 osu.Game.Rulesets.Osu/Skinning/Default/SliderBody.cs          | 2 ++
 osu.Game.Rulesets.Osu/Skinning/Default/SnakingSliderBody.cs   | 2 ++
 .../Skinning/Default/SpinnerBackgroundLayer.cs                | 2 ++
 osu.Game.Rulesets.Osu/Skinning/Default/SpinnerCentreLayer.cs  | 2 ++
 osu.Game.Rulesets.Osu/Skinning/Default/SpinnerFill.cs         | 2 ++
 .../Skinning/Default/SpinnerRotationTracker.cs                | 2 ++
 .../Skinning/Default/SpinnerSpmCalculator.cs                  | 2 ++
 osu.Game.Rulesets.Osu/Skinning/Default/SpinnerTicks.cs        | 2 ++
 osu.Game.Rulesets.Osu/Skinning/Default/TrianglesPiece.cs      | 2 ++
 osu.Game.Rulesets.Osu/Skinning/IHasApproachCircle.cs          | 2 ++
 osu.Game.Rulesets.Osu/Skinning/Legacy/KiaiFlashingDrawable.cs | 2 --
 osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyApproachCircle.cs | 2 ++
 osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyCursor.cs         | 2 ++
 .../Skinning/Legacy/LegacyCursorParticles.cs                  | 2 ++
 osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyCursorTrail.cs    | 2 ++
 .../Skinning/Legacy/LegacyMainCirclePiece.cs                  | 2 --
 .../Skinning/Legacy/LegacyNewStyleSpinner.cs                  | 2 ++
 .../Skinning/Legacy/LegacyOldStyleSpinner.cs                  | 2 ++
 osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyReverseArrow.cs   | 2 ++
 osu.Game.Rulesets.Osu/Skinning/Legacy/LegacySliderBall.cs     | 2 ++
 osu.Game.Rulesets.Osu/Skinning/Legacy/LegacySliderBody.cs     | 2 ++
 .../Skinning/Legacy/LegacySliderHeadHitCircle.cs              | 2 ++
 osu.Game.Rulesets.Osu/Skinning/Legacy/LegacySpinner.cs        | 2 ++
 .../Skinning/Legacy/OsuLegacySkinTransformer.cs               | 2 ++
 osu.Game.Rulesets.Osu/Skinning/NonPlayfieldSprite.cs          | 2 ++
 osu.Game.Rulesets.Osu/Skinning/OsuSkinColour.cs               | 2 ++
 osu.Game.Rulesets.Osu/Skinning/OsuSkinConfiguration.cs        | 2 ++
 osu.Game.Rulesets.Osu/Statistics/AccuracyHeatmap.cs           | 2 ++
 osu.Game.Rulesets.Osu/UI/AnyOrderHitPolicy.cs                 | 2 ++
 osu.Game.Rulesets.Osu/UI/Cursor/CursorTrail.cs                | 2 ++
 osu.Game.Rulesets.Osu/UI/Cursor/OsuCursor.cs                  | 2 ++
 osu.Game.Rulesets.Osu/UI/Cursor/OsuCursorContainer.cs         | 2 ++
 osu.Game.Rulesets.Osu/UI/Cursor/OsuCursorSprite.cs            | 2 ++
 osu.Game.Rulesets.Osu/UI/DrawableOsuRuleset.cs                | 2 ++
 osu.Game.Rulesets.Osu/UI/IHitPolicy.cs                        | 2 ++
 osu.Game.Rulesets.Osu/UI/ObjectOrderedHitPolicy.cs            | 2 ++
 osu.Game.Rulesets.Osu/UI/OsuPlayfield.cs                      | 2 ++
 osu.Game.Rulesets.Osu/UI/OsuPlayfieldAdjustmentContainer.cs   | 2 ++
 osu.Game.Rulesets.Osu/UI/OsuReplayRecorder.cs                 | 2 ++
 osu.Game.Rulesets.Osu/UI/OsuResumeOverlay.cs                  | 2 ++
 osu.Game.Rulesets.Osu/UI/OsuSettingsSubsection.cs             | 2 ++
 osu.Game.Rulesets.Osu/UI/StartTimeOrderedHitPolicy.cs         | 2 ++
 osu.Game.Rulesets.Osu/Utils/OsuHitObjectGenerationUtils.cs    | 2 ++
 .../Utils/OsuHitObjectGenerationUtils_Reposition.cs           | 2 --
 osu.Game.Rulesets.Taiko.Tests.Android/MainActivity.cs         | 2 ++
 osu.Game.Rulesets.Taiko.Tests.iOS/AppDelegate.cs              | 2 ++
 osu.Game.Rulesets.Taiko.Tests.iOS/Application.cs              | 2 ++
 .../DrawableTaikoRulesetTestScene.cs                          | 2 ++
 osu.Game.Rulesets.Taiko.Tests/DrawableTestHit.cs              | 2 ++
 osu.Game.Rulesets.Taiko.Tests/DrawableTestStrongHit.cs        | 2 ++
 osu.Game.Rulesets.Taiko.Tests/Editor/TestSceneEditor.cs       | 2 ++
 .../Editor/TestSceneTaikoEditorSaving.cs                      | 2 ++
 .../Editor/TestSceneTaikoHitObjectComposer.cs                 | 2 ++
 .../HitObjectApplicationTestScene.cs                          | 2 ++
 osu.Game.Rulesets.Taiko.Tests/Mods/TaikoModTestScene.cs       | 2 ++
 osu.Game.Rulesets.Taiko.Tests/Mods/TestSceneTaikoModHidden.cs | 2 ++
 .../Mods/TestSceneTaikoModPerfect.cs                          | 2 ++
 .../Skinning/TaikoSkinnableTestScene.cs                       | 2 ++
 .../Skinning/TestSceneDrawableBarLine.cs                      | 2 ++
 .../Skinning/TestSceneDrawableDrumRoll.cs                     | 2 ++
 .../Skinning/TestSceneDrawableHit.cs                          | 2 ++
 .../Skinning/TestSceneDrawableTaikoMascot.cs                  | 2 ++
 .../Skinning/TestSceneHitExplosion.cs                         | 2 ++
 osu.Game.Rulesets.Taiko.Tests/Skinning/TestSceneInputDrum.cs  | 2 ++
 .../Skinning/TestSceneKiaiHitExplosion.cs                     | 2 ++
 .../Skinning/TestSceneTaikoPlayfield.cs                       | 2 ++
 .../Skinning/TestSceneTaikoScroller.cs                        | 2 ++
 osu.Game.Rulesets.Taiko.Tests/TaikoBeatmapConversionTest.cs   | 2 ++
 .../TaikoDifficultyCalculatorTest.cs                          | 2 ++
 osu.Game.Rulesets.Taiko.Tests/TaikoLegacyModConversionTest.cs | 2 ++
 osu.Game.Rulesets.Taiko.Tests/TestSceneBarLineApplication.cs  | 2 ++
 osu.Game.Rulesets.Taiko.Tests/TestSceneDrumRollApplication.cs | 2 ++
 osu.Game.Rulesets.Taiko.Tests/TestSceneDrumRollJudgements.cs  | 2 ++
 osu.Game.Rulesets.Taiko.Tests/TestSceneFlyingHits.cs          | 2 ++
 osu.Game.Rulesets.Taiko.Tests/TestSceneHitApplication.cs      | 2 ++
 osu.Game.Rulesets.Taiko.Tests/TestSceneHits.cs                | 2 ++
 osu.Game.Rulesets.Taiko.Tests/TestSceneSampleOutput.cs        | 2 ++
 osu.Game.Rulesets.Taiko.Tests/TestSceneSwellJudgements.cs     | 2 ++
 .../TestSceneTaikoHitObjectSamples.cs                         | 2 ++
 osu.Game.Rulesets.Taiko.Tests/TestSceneTaikoPlayer.cs         | 2 ++
 osu.Game.Rulesets.Taiko.Tests/TestSceneTaikoSuddenDeath.cs    | 2 ++
 osu.Game.Rulesets.Taiko/Beatmaps/TaikoBeatmap.cs              | 2 ++
 osu.Game.Rulesets.Taiko/Beatmaps/TaikoBeatmapConverter.cs     | 2 ++
 .../Difficulty/Preprocessing/TaikoDifficultyHitObject.cs      | 2 ++
 .../Preprocessing/TaikoDifficultyHitObjectRhythm.cs           | 2 ++
 osu.Game.Rulesets.Taiko/Difficulty/Skills/Colour.cs           | 2 ++
 osu.Game.Rulesets.Taiko/Difficulty/Skills/Rhythm.cs           | 2 ++
 osu.Game.Rulesets.Taiko/Difficulty/Skills/SingleKeyStamina.cs | 2 ++
 osu.Game.Rulesets.Taiko/Difficulty/Skills/Stamina.cs          | 2 ++
 .../Difficulty/TaikoDifficultyAttributes.cs                   | 2 ++
 .../Difficulty/TaikoDifficultyCalculator.cs                   | 2 ++
 .../Difficulty/TaikoPerformanceAttributes.cs                  | 2 ++
 .../Difficulty/TaikoPerformanceCalculator.cs                  | 2 ++
 .../Edit/Blueprints/DrumRollPlacementBlueprint.cs             | 2 ++
 osu.Game.Rulesets.Taiko/Edit/Blueprints/HitPiece.cs           | 2 ++
 .../Edit/Blueprints/HitPlacementBlueprint.cs                  | 2 ++
 osu.Game.Rulesets.Taiko/Edit/Blueprints/LengthPiece.cs        | 2 ++
 .../Edit/Blueprints/SwellPlacementBlueprint.cs                | 2 ++
 .../Edit/Blueprints/TaikoSelectionBlueprint.cs                | 2 ++
 .../Edit/Blueprints/TaikoSpanPlacementBlueprint.cs            | 2 ++
 osu.Game.Rulesets.Taiko/Edit/DrumRollCompositionTool.cs       | 2 ++
 osu.Game.Rulesets.Taiko/Edit/HitCompositionTool.cs            | 2 ++
 osu.Game.Rulesets.Taiko/Edit/SwellCompositionTool.cs          | 2 ++
 osu.Game.Rulesets.Taiko/Edit/TaikoBlueprintContainer.cs       | 2 ++
 osu.Game.Rulesets.Taiko/Edit/TaikoHitObjectComposer.cs        | 2 ++
 osu.Game.Rulesets.Taiko/Edit/TaikoSelectionHandler.cs         | 2 ++
 osu.Game.Rulesets.Taiko/Judgements/TaikoDrumRollJudgement.cs  | 2 ++
 .../Judgements/TaikoDrumRollTickJudgement.cs                  | 2 ++
 osu.Game.Rulesets.Taiko/Judgements/TaikoJudgement.cs          | 2 ++
 osu.Game.Rulesets.Taiko/Judgements/TaikoStrongJudgement.cs    | 2 ++
 osu.Game.Rulesets.Taiko/Judgements/TaikoSwellJudgement.cs     | 2 ++
 osu.Game.Rulesets.Taiko/Mods/TaikoModAutoplay.cs              | 2 ++
 osu.Game.Rulesets.Taiko/Mods/TaikoModCinema.cs                | 2 ++
 osu.Game.Rulesets.Taiko/Mods/TaikoModClassic.cs               | 2 ++
 osu.Game.Rulesets.Taiko/Mods/TaikoModDaycore.cs               | 2 ++
 osu.Game.Rulesets.Taiko/Mods/TaikoModDifficultyAdjust.cs      | 2 ++
 osu.Game.Rulesets.Taiko/Mods/TaikoModDoubleTime.cs            | 2 ++
 osu.Game.Rulesets.Taiko/Mods/TaikoModEasy.cs                  | 2 ++
 osu.Game.Rulesets.Taiko/Mods/TaikoModFlashlight.cs            | 2 ++
 osu.Game.Rulesets.Taiko/Mods/TaikoModHalfTime.cs              | 2 ++
 osu.Game.Rulesets.Taiko/Mods/TaikoModHardRock.cs              | 2 ++
 osu.Game.Rulesets.Taiko/Mods/TaikoModHidden.cs                | 2 ++
 osu.Game.Rulesets.Taiko/Mods/TaikoModMuted.cs                 | 2 ++
 osu.Game.Rulesets.Taiko/Mods/TaikoModNightcore.cs             | 2 ++
 osu.Game.Rulesets.Taiko/Mods/TaikoModNoFail.cs                | 2 ++
 osu.Game.Rulesets.Taiko/Mods/TaikoModPerfect.cs               | 2 ++
 osu.Game.Rulesets.Taiko/Mods/TaikoModRandom.cs                | 2 ++
 osu.Game.Rulesets.Taiko/Mods/TaikoModRelax.cs                 | 2 ++
 osu.Game.Rulesets.Taiko/Mods/TaikoModSuddenDeath.cs           | 2 ++
 osu.Game.Rulesets.Taiko/Mods/TaikoModSwap.cs                  | 2 ++
 osu.Game.Rulesets.Taiko/Objects/BarLine.cs                    | 2 ++
 osu.Game.Rulesets.Taiko/Objects/Drawables/DrawableBarLine.cs  | 2 ++
 osu.Game.Rulesets.Taiko/Objects/Drawables/DrawableDrumRoll.cs | 2 ++
 .../Objects/Drawables/DrawableDrumRollTick.cs                 | 2 ++
 .../Objects/Drawables/DrawableFlyingHit.cs                    | 2 ++
 osu.Game.Rulesets.Taiko/Objects/Drawables/DrawableHit.cs      | 2 ++
 .../Objects/Drawables/DrawableStrongNestedHit.cs              | 2 ++
 osu.Game.Rulesets.Taiko/Objects/Drawables/DrawableSwell.cs    | 2 ++
 .../Objects/Drawables/DrawableSwellTick.cs                    | 2 ++
 .../Objects/Drawables/DrawableTaikoHitObject.cs               | 2 ++
 .../Objects/Drawables/DrawableTaikoStrongableHitObject.cs     | 2 ++
 osu.Game.Rulesets.Taiko/Objects/DrumRoll.cs                   | 2 ++
 osu.Game.Rulesets.Taiko/Objects/DrumRollTick.cs               | 2 ++
 osu.Game.Rulesets.Taiko/Objects/Hit.cs                        | 2 ++
 osu.Game.Rulesets.Taiko/Objects/HitType.cs                    | 2 ++
 osu.Game.Rulesets.Taiko/Objects/IgnoreHit.cs                  | 2 ++
 osu.Game.Rulesets.Taiko/Objects/StrongNestedHitObject.cs      | 2 ++
 osu.Game.Rulesets.Taiko/Objects/Swell.cs                      | 2 ++
 osu.Game.Rulesets.Taiko/Objects/SwellTick.cs                  | 2 ++
 osu.Game.Rulesets.Taiko/Objects/TaikoHitObject.cs             | 2 ++
 osu.Game.Rulesets.Taiko/Objects/TaikoStrongableHitObject.cs   | 2 ++
 osu.Game.Rulesets.Taiko/Properties/AssemblyInfo.cs            | 2 ++
 osu.Game.Rulesets.Taiko/Replays/TaikoAutoGenerator.cs         | 2 ++
 .../Replays/TaikoFramedReplayInputHandler.cs                  | 2 ++
 osu.Game.Rulesets.Taiko/Replays/TaikoReplayFrame.cs           | 2 ++
 osu.Game.Rulesets.Taiko/Scoring/TaikoHealthProcessor.cs       | 2 ++
 osu.Game.Rulesets.Taiko/Scoring/TaikoHitWindows.cs            | 2 ++
 osu.Game.Rulesets.Taiko/Scoring/TaikoScoreProcessor.cs        | 2 ++
 .../Skinning/Default/CentreHitCirclePiece.cs                  | 2 ++
 osu.Game.Rulesets.Taiko/Skinning/Default/CirclePiece.cs       | 2 ++
 .../Skinning/Default/ElongatedCirclePiece.cs                  | 2 ++
 osu.Game.Rulesets.Taiko/Skinning/Default/RimHitCirclePiece.cs | 2 ++
 osu.Game.Rulesets.Taiko/Skinning/Default/SwellSymbolPiece.cs  | 2 ++
 osu.Game.Rulesets.Taiko/Skinning/Default/TickPiece.cs         | 2 ++
 osu.Game.Rulesets.Taiko/Skinning/Legacy/LegacyBarLine.cs      | 2 ++
 osu.Game.Rulesets.Taiko/Skinning/Legacy/LegacyCirclePiece.cs  | 2 ++
 osu.Game.Rulesets.Taiko/Skinning/Legacy/LegacyDrumRoll.cs     | 2 ++
 osu.Game.Rulesets.Taiko/Skinning/Legacy/LegacyHit.cs          | 2 ++
 osu.Game.Rulesets.Taiko/Skinning/Legacy/LegacyHitExplosion.cs | 2 ++
 osu.Game.Rulesets.Taiko/Skinning/Legacy/LegacyInputDrum.cs    | 2 ++
 .../Skinning/Legacy/LegacyTaikoScroller.cs                    | 2 ++
 .../Skinning/Legacy/TaikoLegacyHitTarget.cs                   | 2 ++
 .../Skinning/Legacy/TaikoLegacyPlayfieldBackgroundRight.cs    | 2 ++
 .../Skinning/Legacy/TaikoLegacySkinTransformer.cs             | 2 ++
 osu.Game.Rulesets.Taiko/TaikoInputManager.cs                  | 2 ++
 osu.Game.Rulesets.Taiko/TaikoRuleset.cs                       | 2 ++
 osu.Game.Rulesets.Taiko/TaikoSkinComponent.cs                 | 2 ++
 osu.Game.Rulesets.Taiko/TaikoSkinComponents.cs                | 2 ++
 osu.Game.Rulesets.Taiko/UI/BarLinePlayfield.cs                | 2 ++
 osu.Game.Rulesets.Taiko/UI/DefaultHitExplosion.cs             | 2 ++
 osu.Game.Rulesets.Taiko/UI/DefaultKiaiHitExplosion.cs         | 2 ++
 osu.Game.Rulesets.Taiko/UI/DrawableTaikoJudgement.cs          | 2 ++
 osu.Game.Rulesets.Taiko/UI/DrawableTaikoMascot.cs             | 2 ++
 osu.Game.Rulesets.Taiko/UI/DrawableTaikoRuleset.cs            | 2 ++
 osu.Game.Rulesets.Taiko/UI/DrumRollHitContainer.cs            | 2 ++
 osu.Game.Rulesets.Taiko/UI/DrumSampleTriggerSource.cs         | 2 ++
 osu.Game.Rulesets.Taiko/UI/HitExplosion.cs                    | 2 ++
 osu.Game.Rulesets.Taiko/UI/HitExplosionPool.cs                | 2 ++
 osu.Game.Rulesets.Taiko/UI/IAnimatableHitExplosion.cs         | 2 ++
 osu.Game.Rulesets.Taiko/UI/InputDrum.cs                       | 2 ++
 osu.Game.Rulesets.Taiko/UI/KiaiHitExplosion.cs                | 2 ++
 osu.Game.Rulesets.Taiko/UI/PlayfieldBackgroundLeft.cs         | 2 ++
 osu.Game.Rulesets.Taiko/UI/PlayfieldBackgroundRight.cs        | 2 ++
 osu.Game.Rulesets.Taiko/UI/TaikoHitTarget.cs                  | 2 ++
 osu.Game.Rulesets.Taiko/UI/TaikoMascotAnimation.cs            | 2 ++
 osu.Game.Rulesets.Taiko/UI/TaikoMascotAnimationState.cs       | 2 ++
 osu.Game.Rulesets.Taiko/UI/TaikoPlayfield.cs                  | 2 ++
 .../UI/TaikoPlayfieldAdjustmentContainer.cs                   | 2 ++
 osu.Game.Rulesets.Taiko/UI/TaikoReplayRecorder.cs             | 2 ++
 osu.Game.Tests.Android/MainActivity.cs                        | 2 ++
 osu.Game.Tests.iOS/AppDelegate.cs                             | 2 ++
 osu.Game.Tests.iOS/Application.cs                             | 2 ++
 osu.Game.Tests/Audio/SampleInfoEqualityTest.cs                | 2 ++
 osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs   | 2 ++
 osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapEncoderTest.cs   | 2 ++
 osu.Game.Tests/Beatmaps/Formats/LegacyDecoderTest.cs          | 2 ++
 osu.Game.Tests/Beatmaps/Formats/LegacyScoreDecoderTest.cs     | 2 ++
 .../Beatmaps/Formats/LegacyStoryboardDecoderTest.cs           | 2 ++
 osu.Game.Tests/Beatmaps/Formats/OsuJsonDecoderTest.cs         | 2 ++
 osu.Game.Tests/Beatmaps/Formats/ParsingTest.cs                | 2 ++
 osu.Game.Tests/Beatmaps/IO/BeatmapImportHelper.cs             | 2 ++
 osu.Game.Tests/Beatmaps/IO/LineBufferedReaderTest.cs          | 2 ++
 osu.Game.Tests/Beatmaps/IO/OszArchiveReaderTest.cs            | 2 ++
 osu.Game.Tests/Beatmaps/SliderEventGenerationTest.cs          | 2 ++
 osu.Game.Tests/Beatmaps/TestSceneBeatmapDifficultyCache.cs    | 2 ++
 osu.Game.Tests/Beatmaps/TestSceneEditorBeatmap.cs             | 2 ++
 osu.Game.Tests/Beatmaps/ToStringFormattingTest.cs             | 2 ++
 osu.Game.Tests/Beatmaps/WorkingBeatmapTest.cs                 | 2 ++
 osu.Game.Tests/Chat/MessageFormatterTests.cs                  | 2 ++
 osu.Game.Tests/Chat/TestSceneChannelManager.cs                | 2 ++
 osu.Game.Tests/Collections/IO/ImportCollectionsTest.cs        | 2 ++
 osu.Game.Tests/Database/BeatmapImporterTests.cs               | 2 --
 osu.Game.Tests/Database/FileStoreTests.cs                     | 2 --
 osu.Game.Tests/Database/GeneralUsageTests.cs                  | 2 --
 osu.Game.Tests/Database/LegacyBeatmapImporterTest.cs          | 2 ++
 osu.Game.Tests/Database/RealmLiveTests.cs                     | 2 --
 osu.Game.Tests/Database/RealmSubscriptionRegistrationTests.cs | 2 --
 osu.Game.Tests/Database/RealmTest.cs                          | 2 --
 osu.Game.Tests/Database/RulesetStoreTests.cs                  | 2 ++
 osu.Game.Tests/Database/TestRealmKeyBindingStore.cs           | 2 ++
 osu.Game.Tests/Editing/Checks/CheckAudioInVideoTest.cs        | 2 ++
 osu.Game.Tests/Editing/Checks/CheckAudioQualityTest.cs        | 2 ++
 osu.Game.Tests/Editing/Checks/CheckBackgroundQualityTest.cs   | 2 ++
 osu.Game.Tests/Editing/Checks/CheckConcurrentObjectsTest.cs   | 2 ++
 osu.Game.Tests/Editing/Checks/CheckFewHitsoundsTest.cs        | 2 ++
 osu.Game.Tests/Editing/Checks/CheckFilePresenceTest.cs        | 2 ++
 osu.Game.Tests/Editing/Checks/CheckMutedObjectsTest.cs        | 2 ++
 osu.Game.Tests/Editing/Checks/CheckTestHelpers.cs             | 2 ++
 osu.Game.Tests/Editing/Checks/CheckTooShortAudioFilesTest.cs  | 2 ++
 osu.Game.Tests/Editing/Checks/CheckUnsnappedObjectsTest.cs    | 2 ++
 osu.Game.Tests/Editing/Checks/CheckZeroByteFilesTest.cs       | 2 ++
 osu.Game.Tests/Editing/Checks/CheckZeroLengthObjectsTest.cs   | 2 ++
 osu.Game.Tests/Editing/Checks/MockNestableHitObject.cs        | 2 ++
 osu.Game.Tests/Editing/EditorChangeHandlerTest.cs             | 2 ++
 osu.Game.Tests/Editing/LegacyEditorBeatmapPatcherTest.cs      | 2 ++
 .../Editing/TestSceneHitObjectComposerDistanceSnapping.cs     | 2 ++
 .../Editing/TestSceneHitObjectContainerEventBuffer.cs         | 2 ++
 osu.Game.Tests/Editing/TransactionalCommitComponentTest.cs    | 2 ++
 osu.Game.Tests/Gameplay/TestSceneDrainingHealthProcessor.cs   | 2 ++
 osu.Game.Tests/Gameplay/TestSceneDrawableHitObject.cs         | 2 ++
 osu.Game.Tests/Gameplay/TestSceneHitObjectAccentColour.cs     | 2 ++
 osu.Game.Tests/Gameplay/TestSceneHitObjectContainer.cs        | 2 ++
 osu.Game.Tests/Gameplay/TestSceneHitObjectSamples.cs          | 2 ++
 .../Gameplay/TestSceneMasterGameplayClockContainer.cs         | 2 ++
 osu.Game.Tests/Gameplay/TestSceneProxyContainer.cs            | 2 ++
 osu.Game.Tests/Gameplay/TestSceneScoreProcessor.cs            | 2 ++
 osu.Game.Tests/Gameplay/TestSceneStoryboardSamples.cs         | 2 ++
 osu.Game.Tests/ImportTest.cs                                  | 2 ++
 osu.Game.Tests/Input/ConfineMouseTrackerTest.cs               | 2 ++
 .../Localisation/BeatmapMetadataRomanisationTest.cs           | 2 ++
 osu.Game.Tests/Models/DisplayStringTest.cs                    | 2 --
 osu.Game.Tests/Mods/ModDifficultyAdjustTest.cs                | 2 ++
 osu.Game.Tests/Mods/ModSettingsEqualityComparison.cs          | 2 ++
 osu.Game.Tests/Mods/ModSettingsTest.cs                        | 2 ++
 osu.Game.Tests/Mods/ModUtilsTest.cs                           | 2 ++
 osu.Game.Tests/Mods/MultiModIncompatibilityTest.cs            | 2 ++
 osu.Game.Tests/Mods/SettingsSourceAttributeTest.cs            | 2 ++
 osu.Game.Tests/Mods/TestCustomisableModRuleset.cs             | 2 ++
 osu.Game.Tests/NonVisual/BarLineGeneratorTest.cs              | 2 ++
 osu.Game.Tests/NonVisual/BeatmapSetInfoEqualityTest.cs        | 2 ++
 osu.Game.Tests/NonVisual/ClosestBeatDivisorTest.cs            | 2 ++
 osu.Game.Tests/NonVisual/ControlPointInfoTest.cs              | 2 ++
 osu.Game.Tests/NonVisual/CustomDataDirectoryTest.cs           | 2 ++
 .../NonVisual/DifficultyAdjustmentModCombinationsTest.cs      | 2 ++
 osu.Game.Tests/NonVisual/Filtering/FilterMatchingTest.cs      | 2 ++
 osu.Game.Tests/NonVisual/Filtering/FilterQueryParserTest.cs   | 2 ++
 osu.Game.Tests/NonVisual/FirstAvailableHitWindowsTest.cs      | 2 ++
 osu.Game.Tests/NonVisual/FormatUtilsTest.cs                   | 2 ++
 osu.Game.Tests/NonVisual/FramedReplayInputHandlerTest.cs      | 2 ++
 osu.Game.Tests/NonVisual/GameplayClockTest.cs                 | 2 ++
 osu.Game.Tests/NonVisual/LimitedCapacityQueueTest.cs          | 2 ++
 .../NonVisual/Multiplayer/StatefulMultiplayerClientTest.cs    | 2 ++
 osu.Game.Tests/NonVisual/OngoingOperationTrackerTest.cs       | 2 ++
 osu.Game.Tests/NonVisual/PeriodTrackerTest.cs                 | 2 ++
 osu.Game.Tests/NonVisual/Ranking/UnstableRateTest.cs          | 2 ++
 osu.Game.Tests/NonVisual/ReverseQueueTest.cs                  | 2 ++
 osu.Game.Tests/NonVisual/RulesetInfoOrderingTest.cs           | 2 ++
 osu.Game.Tests/NonVisual/ScoreInfoTest.cs                     | 2 ++
 osu.Game.Tests/NonVisual/SessionStaticsTest.cs                | 2 ++
 osu.Game.Tests/NonVisual/Skinning/LegacySkinAnimationTest.cs  | 2 ++
 .../NonVisual/Skinning/LegacySkinTextureFallbackTest.cs       | 2 ++
 osu.Game.Tests/NonVisual/TaskChainTest.cs                     | 2 ++
 osu.Game.Tests/NonVisual/TimeDisplayExtensionTest.cs          | 2 ++
 osu.Game.Tests/Online/Chat/MessageNotifierTest.cs             | 2 ++
 osu.Game.Tests/Online/TestAPIModJsonSerialization.cs          | 2 ++
 osu.Game.Tests/Online/TestAPIModMessagePackSerialization.cs   | 2 ++
 osu.Game.Tests/Online/TestDummyAPIRequestHandling.cs          | 2 ++
 .../Online/TestMultiplayerMessagePackSerialization.cs         | 2 ++
 osu.Game.Tests/Online/TestSceneBeatmapDownloading.cs          | 2 ++
 .../Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs   | 2 ++
 .../Online/TestSubmittableScoreJsonSerialization.cs           | 2 ++
 osu.Game.Tests/OnlinePlay/PlaylistExtensionsTest.cs           | 2 ++
 osu.Game.Tests/OnlinePlay/TestSceneCatchUpSyncManager.cs      | 2 ++
 osu.Game.Tests/Resources/TestResources.cs                     | 2 ++
 osu.Game.Tests/Rulesets/Mods/ModTimeRampTest.cs               | 2 ++
 osu.Game.Tests/Rulesets/Scoring/ScoreProcessorTest.cs         | 2 ++
 .../Rulesets/TestSceneDrawableRulesetDependencies.cs          | 2 ++
 .../Rulesets/TestSceneRulesetSkinProvidingContainer.cs        | 2 ++
 osu.Game.Tests/Scores/IO/ImportScoreTest.cs                   | 2 ++
 osu.Game.Tests/Scores/IO/TestScoreEquality.cs                 | 2 ++
 osu.Game.Tests/ScrollAlgorithms/ConstantScrollTest.cs         | 2 ++
 osu.Game.Tests/ScrollAlgorithms/OverlappingScrollTest.cs      | 2 ++
 osu.Game.Tests/ScrollAlgorithms/SequentialScrollTest.cs       | 2 ++
 osu.Game.Tests/Skins/IO/ImportSkinTest.cs                     | 2 ++
 osu.Game.Tests/Skins/LegacyManiaSkinDecoderTest.cs            | 2 ++
 osu.Game.Tests/Skins/LegacySkinDecoderTest.cs                 | 2 ++
 osu.Game.Tests/Skins/TestSceneBeatmapSkinLookupDisables.cs    | 2 ++
 osu.Game.Tests/Skins/TestSceneBeatmapSkinResources.cs         | 2 ++
 osu.Game.Tests/Skins/TestSceneSkinConfigurationLookup.cs      | 2 ++
 osu.Game.Tests/Skins/TestSceneSkinProvidingContainer.cs       | 2 ++
 osu.Game.Tests/Skins/TestSceneSkinResources.cs                | 2 ++
 osu.Game.Tests/Testing/TestSceneRulesetDependencies.cs        | 2 ++
 osu.Game.Tests/Utils/NamingUtilsTest.cs                       | 2 ++
 osu.Game.Tests/Visual/Audio/TestSceneAudioFilter.cs           | 2 ++
 .../Visual/Background/TestSceneBackgroundScreenDefault.cs     | 2 ++
 .../Visual/Background/TestSceneSeasonalBackgroundLoader.cs    | 2 ++
 .../Visual/Background/TestSceneUserDimBackgrounds.cs          | 2 ++
 osu.Game.Tests/Visual/Background/TestSceneUserDimContainer.cs | 2 ++
 osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs        | 2 ++
 .../Visual/Beatmaps/TestSceneBeatmapCardDifficultyList.cs     | 2 ++
 .../Visual/Beatmaps/TestSceneBeatmapCardDownloadButton.cs     | 2 ++
 .../Visual/Beatmaps/TestSceneBeatmapCardFavouriteButton.cs    | 2 ++
 .../Visual/Beatmaps/TestSceneBeatmapCardThumbnail.cs          | 2 ++
 .../Visual/Beatmaps/TestSceneBeatmapSetOnlineStatusPill.cs    | 2 ++
 .../Visual/Beatmaps/TestSceneDifficultySpectrumDisplay.cs     | 2 ++
 .../Visual/Collections/TestSceneManageCollectionsDialog.cs    | 2 ++
 .../Visual/Colours/TestSceneStarDifficultyColours.cs          | 2 ++
 osu.Game.Tests/Visual/Components/TestSceneIdleTracker.cs      | 2 ++
 osu.Game.Tests/Visual/Components/TestScenePollingComponent.cs | 2 ++
 .../Visual/Components/TestScenePreviewTrackManager.cs         | 2 ++
 osu.Game.Tests/Visual/Editing/TestSceneBeatDivisorControl.cs  | 2 ++
 osu.Game.Tests/Visual/Editing/TestSceneBlueprintOrdering.cs   | 2 ++
 osu.Game.Tests/Visual/Editing/TestSceneComposeScreen.cs       | 2 ++
 osu.Game.Tests/Visual/Editing/TestSceneComposeSelectBox.cs    | 2 ++
 osu.Game.Tests/Visual/Editing/TestSceneComposerSelection.cs   | 2 ++
 osu.Game.Tests/Visual/Editing/TestSceneDesignSection.cs       | 2 ++
 osu.Game.Tests/Visual/Editing/TestSceneDifficultySwitching.cs | 2 ++
 osu.Game.Tests/Visual/Editing/TestSceneDistanceSnapGrid.cs    | 2 ++
 .../Visual/Editing/TestSceneEditorBeatmapCreation.cs          | 2 ++
 osu.Game.Tests/Visual/Editing/TestSceneEditorChangeStates.cs  | 2 ++
 osu.Game.Tests/Visual/Editing/TestSceneEditorClipboard.cs     | 2 ++
 osu.Game.Tests/Visual/Editing/TestSceneEditorClock.cs         | 2 ++
 .../Visual/Editing/TestSceneEditorComposeRadioButtons.cs      | 2 ++
 osu.Game.Tests/Visual/Editing/TestSceneEditorMenuBar.cs       | 2 ++
 .../Visual/Editing/TestSceneEditorSamplePlayback.cs           | 2 ++
 osu.Game.Tests/Visual/Editing/TestSceneEditorSaving.cs        | 2 ++
 osu.Game.Tests/Visual/Editing/TestSceneEditorScreenModes.cs   | 2 ++
 osu.Game.Tests/Visual/Editing/TestSceneEditorSeekSnapping.cs  | 2 ++
 osu.Game.Tests/Visual/Editing/TestSceneEditorSeeking.cs       | 2 ++
 .../Visual/Editing/TestSceneEditorSummaryTimeline.cs          | 2 ++
 osu.Game.Tests/Visual/Editing/TestSceneEditorTestGameplay.cs  | 2 ++
 osu.Game.Tests/Visual/Editing/TestSceneHitObjectComposer.cs   | 2 ++
 .../Editing/TestSceneHitObjectDifficultyPointAdjustments.cs   | 2 ++
 .../Editing/TestSceneHitObjectSamplePointAdjustments.cs       | 2 ++
 .../Visual/Editing/TestSceneLabelledTimeSignature.cs          | 2 ++
 osu.Game.Tests/Visual/Editing/TestSceneMetadataSection.cs     | 2 ++
 osu.Game.Tests/Visual/Editing/TestScenePlaybackControl.cs     | 2 ++
 .../Visual/Editing/TestSceneRectangularPositionSnapGrid.cs    | 2 ++
 osu.Game.Tests/Visual/Editing/TestSceneSetupScreen.cs         | 2 ++
 osu.Game.Tests/Visual/Editing/TestSceneTapButton.cs           | 2 ++
 osu.Game.Tests/Visual/Editing/TestSceneTapTimingControl.cs    | 2 ++
 .../Visual/Editing/TestSceneTimelineBlueprintContainer.cs     | 2 ++
 .../Visual/Editing/TestSceneTimelineHitObjectBlueprint.cs     | 2 ++
 osu.Game.Tests/Visual/Editing/TestSceneTimelineSelection.cs   | 2 ++
 osu.Game.Tests/Visual/Editing/TestSceneTimelineTickDisplay.cs | 2 ++
 osu.Game.Tests/Visual/Editing/TestSceneTimelineZoom.cs        | 2 ++
 osu.Game.Tests/Visual/Editing/TestSceneTimingScreen.cs        | 2 ++
 osu.Game.Tests/Visual/Editing/TestSceneWaveform.cs            | 2 ++
 .../Visual/Editing/TestSceneZoomableScrollContainer.cs        | 2 ++
 osu.Game.Tests/Visual/Editing/TimelineTestScene.cs            | 2 ++
 osu.Game.Tests/Visual/Gameplay/OsuPlayerTestScene.cs          | 2 ++
 .../Visual/Gameplay/SkinnableHUDComponentTestScene.cs         | 2 ++
 osu.Game.Tests/Visual/Gameplay/TestSceneAllRulesetPlayers.cs  | 2 ++
 osu.Game.Tests/Visual/Gameplay/TestSceneAutoplay.cs           | 2 ++
 .../Visual/Gameplay/TestSceneBeatmapOffsetControl.cs          | 2 ++
 .../Visual/Gameplay/TestSceneBeatmapSkinFallbacks.cs          | 2 ++
 osu.Game.Tests/Visual/Gameplay/TestSceneBreakTracker.cs       | 2 ++
 .../Visual/Gameplay/TestSceneCompletionCancellation.cs        | 2 ++
 .../Visual/Gameplay/TestSceneDrawableScrollingRuleset.cs      | 2 ++
 .../Visual/Gameplay/TestSceneDrawableStoryboardSprite.cs      | 2 ++
 osu.Game.Tests/Visual/Gameplay/TestSceneFailAnimation.cs      | 2 ++
 osu.Game.Tests/Visual/Gameplay/TestSceneFailJudgement.cs      | 2 ++
 osu.Game.Tests/Visual/Gameplay/TestSceneFailingLayer.cs       | 2 ++
 .../Visual/Gameplay/TestSceneFrameStabilityContainer.cs       | 2 ++
 .../Visual/Gameplay/TestSceneGameplayLeaderboard.cs           | 2 ++
 .../Visual/Gameplay/TestSceneGameplayMenuOverlay.cs           | 2 ++
 osu.Game.Tests/Visual/Gameplay/TestSceneGameplayRewinding.cs  | 2 ++
 .../Visual/Gameplay/TestSceneGameplaySamplePlayback.cs        | 2 ++
 .../Visual/Gameplay/TestSceneGameplaySampleTriggerSource.cs   | 2 ++
 osu.Game.Tests/Visual/Gameplay/TestSceneHUDOverlay.cs         | 2 ++
 osu.Game.Tests/Visual/Gameplay/TestSceneHitErrorMeter.cs      | 2 ++
 osu.Game.Tests/Visual/Gameplay/TestSceneHoldForMenuButton.cs  | 2 ++
 osu.Game.Tests/Visual/Gameplay/TestSceneKeyBindings.cs        | 2 ++
 osu.Game.Tests/Visual/Gameplay/TestSceneKeyCounter.cs         | 2 ++
 osu.Game.Tests/Visual/Gameplay/TestSceneLeadIn.cs             | 2 ++
 osu.Game.Tests/Visual/Gameplay/TestSceneMedalOverlay.cs       | 2 ++
 .../Visual/Gameplay/TestSceneNightcoreBeatContainer.cs        | 2 ++
 osu.Game.Tests/Visual/Gameplay/TestSceneOverlayActivation.cs  | 2 ++
 osu.Game.Tests/Visual/Gameplay/TestSceneParticleExplosion.cs  | 2 ++
 osu.Game.Tests/Visual/Gameplay/TestSceneParticleSpewer.cs     | 2 ++
 osu.Game.Tests/Visual/Gameplay/TestScenePause.cs              | 2 ++
 osu.Game.Tests/Visual/Gameplay/TestScenePauseWhenInactive.cs  | 2 ++
 .../Visual/Gameplay/TestScenePerformancePointsCounter.cs      | 2 ++
 osu.Game.Tests/Visual/Gameplay/TestScenePlayerLoader.cs       | 2 ++
 .../Visual/Gameplay/TestScenePlayerReferenceLeaking.cs        | 2 ++
 .../Visual/Gameplay/TestScenePlayerScoreSubmission.cs         | 2 ++
 osu.Game.Tests/Visual/Gameplay/TestScenePoolingRuleset.cs     | 2 ++
 osu.Game.Tests/Visual/Gameplay/TestSceneReplay.cs             | 2 ++
 .../Visual/Gameplay/TestSceneReplayDownloadButton.cs          | 2 ++
 osu.Game.Tests/Visual/Gameplay/TestSceneReplayPlayer.cs       | 2 ++
 osu.Game.Tests/Visual/Gameplay/TestSceneReplayRecorder.cs     | 2 ++
 .../Visual/Gameplay/TestSceneScrollingHitObjects.cs           | 2 ++
 osu.Game.Tests/Visual/Gameplay/TestSceneSkinEditor.cs         | 2 ++
 .../Visual/Gameplay/TestSceneSkinEditorComponentsList.cs      | 2 ++
 .../Visual/Gameplay/TestSceneSkinEditorMultipleSkins.cs       | 2 ++
 .../Visual/Gameplay/TestSceneSkinnableAccuracyCounter.cs      | 2 ++
 .../Visual/Gameplay/TestSceneSkinnableComboCounter.cs         | 2 ++
 osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableDrawable.cs  | 2 ++
 .../Visual/Gameplay/TestSceneSkinnableHUDOverlay.cs           | 2 ++
 .../Visual/Gameplay/TestSceneSkinnableHealthDisplay.cs        | 2 ++
 .../Visual/Gameplay/TestSceneSkinnableScoreCounter.cs         | 2 ++
 osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableSound.cs     | 2 ++
 osu.Game.Tests/Visual/Gameplay/TestSceneSkipOverlay.cs        | 2 ++
 osu.Game.Tests/Visual/Gameplay/TestSceneSliderPath.cs         | 2 ++
 osu.Game.Tests/Visual/Gameplay/TestSceneSongProgress.cs       | 2 ++
 osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs          | 2 ++
 osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorHost.cs      | 2 ++
 osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorPlayback.cs  | 2 ++
 osu.Game.Tests/Visual/Gameplay/TestSceneStarCounter.cs        | 2 ++
 osu.Game.Tests/Visual/Gameplay/TestSceneStoryboard.cs         | 2 ++
 .../Visual/Gameplay/TestSceneStoryboardSamplePlayback.cs      | 2 ++
 .../Visual/Gameplay/TestSceneStoryboardWithOutro.cs           | 2 ++
 osu.Game.Tests/Visual/Gameplay/TestSceneUnknownMod.cs         | 2 ++
 .../Visual/Gameplay/TestSceneUnstableRateCounter.cs           | 2 ++
 osu.Game.Tests/Visual/Menus/IntroTestScene.cs                 | 2 ++
 osu.Game.Tests/Visual/Menus/TestSceneDisclaimer.cs            | 2 ++
 osu.Game.Tests/Visual/Menus/TestSceneIntroCircles.cs          | 2 ++
 osu.Game.Tests/Visual/Menus/TestSceneIntroTriangles.cs        | 2 ++
 osu.Game.Tests/Visual/Menus/TestSceneIntroWelcome.cs          | 2 ++
 osu.Game.Tests/Visual/Menus/TestSceneLoader.cs                | 2 ++
 osu.Game.Tests/Visual/Menus/TestSceneLoginPanel.cs            | 2 ++
 osu.Game.Tests/Visual/Menus/TestSceneMusicActionHandling.cs   | 2 ++
 osu.Game.Tests/Visual/Menus/TestSceneSideOverlays.cs          | 2 ++
 osu.Game.Tests/Visual/Menus/TestSceneSongTicker.cs            | 2 ++
 osu.Game.Tests/Visual/Menus/TestSceneToolbar.cs               | 2 ++
 osu.Game.Tests/Visual/Menus/TestSceneToolbarClock.cs          | 2 ++
 osu.Game.Tests/Visual/Mods/TestSceneModFailCondition.cs       | 2 ++
 .../Multiplayer/MultiplayerGameplayLeaderboardTestScene.cs    | 2 ++
 osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs       | 2 ++
 .../Visual/Multiplayer/TestSceneAllPlayersQueueMode.cs        | 2 --
 .../Multiplayer/TestSceneCreateMultiplayerMatchButton.cs      | 2 ++
 .../Visual/Multiplayer/TestSceneDrawableLoungeRoom.cs         | 2 ++
 osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoom.cs    | 2 ++
 .../Multiplayer/TestSceneDrawableRoomParticipantsList.cs      | 2 ++
 .../Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs       | 2 ++
 .../Visual/Multiplayer/TestSceneFreeModSelectOverlay.cs       | 2 ++
 .../Visual/Multiplayer/TestSceneGameplayChatDisplay.cs        | 2 ++
 .../Visual/Multiplayer/TestSceneHostOnlyQueueMode.cs          | 2 ++
 .../Visual/Multiplayer/TestSceneLoungeRoomsContainer.cs       | 2 ++
 .../Visual/Multiplayer/TestSceneMatchBeatmapDetailArea.cs     | 2 ++
 .../Visual/Multiplayer/TestSceneMatchLeaderboard.cs           | 2 ++
 .../Visual/Multiplayer/TestSceneMatchStartControl.cs          | 2 ++
 osu.Game.Tests/Visual/Multiplayer/TestSceneMultiHeader.cs     | 2 ++
 .../Visual/Multiplayer/TestSceneMultiSpectatorLeaderboard.cs  | 2 ++
 .../Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs       | 2 ++
 osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs     | 2 ++
 .../Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs    | 2 ++
 .../TestSceneMultiplayerGameplayLeaderboardTeams.cs           | 2 ++
 .../Visual/Multiplayer/TestSceneMultiplayerLoungeSubScreen.cs | 2 ++
 .../Visual/Multiplayer/TestSceneMultiplayerMatchFooter.cs     | 2 ++
 .../Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs | 2 ++
 .../Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs  | 2 ++
 .../Multiplayer/TestSceneMultiplayerParticipantsList.cs       | 2 ++
 .../Visual/Multiplayer/TestSceneMultiplayerPlayer.cs          | 2 ++
 .../Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs        | 2 ++
 .../Visual/Multiplayer/TestSceneMultiplayerQueueList.cs       | 2 ++
 .../Visual/Multiplayer/TestSceneMultiplayerResults.cs         | 2 ++
 .../Visual/Multiplayer/TestSceneMultiplayerSpectateButton.cs  | 2 ++
 .../Multiplayer/TestSceneMultiplayerSpectatorPlayerGrid.cs    | 2 ++
 .../Visual/Multiplayer/TestSceneMultiplayerTeamResults.cs     | 2 ++
 .../Multiplayer/TestScenePlaylistsRoomSettingsPlaylist.cs     | 2 ++
 .../Visual/Multiplayer/TestScenePlaylistsSongSelect.cs        | 2 ++
 osu.Game.Tests/Visual/Multiplayer/TestSceneRankRangePill.cs   | 2 ++
 .../Visual/Multiplayer/TestSceneStarRatingRangeDisplay.cs     | 2 ++
 osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs      | 2 ++
 osu.Game.Tests/Visual/Navigation/TestEFToRealmMigration.cs    | 2 ++
 .../Visual/Navigation/TestSceneButtonSystemNavigation.cs      | 2 ++
 .../Navigation/TestSceneChangeAndUseGameplayBindings.cs       | 2 ++
 osu.Game.Tests/Visual/Navigation/TestSceneEditDefaultSkin.cs  | 2 ++
 osu.Game.Tests/Visual/Navigation/TestSceneFirstRunGame.cs     | 2 ++
 .../Visual/Navigation/TestSceneMouseWheelVolumeAdjust.cs      | 2 ++
 osu.Game.Tests/Visual/Navigation/TestSceneOsuGame.cs          | 2 ++
 .../Visual/Navigation/TestScenePerformFromScreen.cs           | 2 ++
 osu.Game.Tests/Visual/Navigation/TestScenePresentBeatmap.cs   | 2 ++
 osu.Game.Tests/Visual/Navigation/TestScenePresentScore.cs     | 2 ++
 osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs | 2 ++
 .../Visual/Navigation/TestSceneSkinEditorNavigation.cs        | 2 ++
 .../Visual/Navigation/TestSceneStartupBeatmapDisplay.cs       | 2 ++
 .../Visual/Navigation/TestSceneStartupBeatmapSetDisplay.cs    | 2 ++
 osu.Game.Tests/Visual/Navigation/TestSceneStartupImport.cs    | 2 ++
 osu.Game.Tests/Visual/Navigation/TestSceneStartupRuleset.cs   | 2 ++
 osu.Game.Tests/Visual/Navigation/TestSettingsMigration.cs     | 2 ++
 .../Visual/Online/TestSceneAccountCreationOverlay.cs          | 2 ++
 osu.Game.Tests/Visual/Online/TestSceneBeatmapAvailability.cs  | 2 ++
 .../Visual/Online/TestSceneBeatmapDownloadButton.cs           | 2 ++
 .../Visual/Online/TestSceneBeatmapListingOverlay.cs           | 2 ++
 .../Visual/Online/TestSceneBeatmapRulesetSelector.cs          | 2 ++
 osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlay.cs    | 2 ++
 .../Visual/Online/TestSceneBeatmapSetOverlayDetails.cs        | 2 ++
 .../Visual/Online/TestSceneBeatmapSetOverlaySuccessRate.cs    | 2 ++
 .../Visual/Online/TestSceneBundledBeatmapDownloader.cs        | 2 ++
 osu.Game.Tests/Visual/Online/TestSceneChangelogOverlay.cs     | 2 ++
 .../Visual/Online/TestSceneChangelogSupporterPromo.cs         | 2 ++
 osu.Game.Tests/Visual/Online/TestSceneChannelList.cs          | 2 ++
 osu.Game.Tests/Visual/Online/TestSceneChannelListing.cs       | 2 ++
 osu.Game.Tests/Visual/Online/TestSceneChatLineTruncation.cs   | 2 ++
 osu.Game.Tests/Visual/Online/TestSceneChatLink.cs             | 2 ++
 osu.Game.Tests/Visual/Online/TestSceneChatOverlay.cs          | 2 ++
 osu.Game.Tests/Visual/Online/TestSceneChatTextBox.cs          | 2 ++
 osu.Game.Tests/Visual/Online/TestSceneCommentsContainer.cs    | 2 ++
 osu.Game.Tests/Visual/Online/TestSceneCommentsHeader.cs       | 2 ++
 .../Visual/Online/TestSceneCurrentlyPlayingDisplay.cs         | 2 ++
 osu.Game.Tests/Visual/Online/TestSceneDashboardOverlay.cs     | 2 ++
 osu.Game.Tests/Visual/Online/TestSceneDrawableComment.cs      | 2 ++
 osu.Game.Tests/Visual/Online/TestSceneExternalLinkButton.cs   | 2 ++
 osu.Game.Tests/Visual/Online/TestSceneFavouriteButton.cs      | 2 ++
 osu.Game.Tests/Visual/Online/TestSceneFriendDisplay.cs        | 2 ++
 osu.Game.Tests/Visual/Online/TestSceneFullscreenOverlay.cs    | 2 ++
 osu.Game.Tests/Visual/Online/TestSceneGraph.cs                | 2 ++
 osu.Game.Tests/Visual/Online/TestSceneHistoricalSection.cs    | 2 ++
 osu.Game.Tests/Visual/Online/TestSceneHomeNewsPanel.cs        | 2 ++
 osu.Game.Tests/Visual/Online/TestSceneKudosuHistory.cs        | 2 ++
 .../Visual/Online/TestSceneLeaderboardModSelector.cs          | 2 ++
 .../Visual/Online/TestSceneLeaderboardScopeSelector.cs        | 2 ++
 osu.Game.Tests/Visual/Online/TestSceneMessageNotifier.cs      | 2 ++
 osu.Game.Tests/Visual/Online/TestSceneNewsCard.cs             | 2 ++
 osu.Game.Tests/Visual/Online/TestSceneNewsHeader.cs           | 2 ++
 osu.Game.Tests/Visual/Online/TestSceneNewsOverlay.cs          | 2 ++
 osu.Game.Tests/Visual/Online/TestSceneNewsSidebar.cs          | 2 ++
 osu.Game.Tests/Visual/Online/TestSceneNowPlayingCommand.cs    | 2 ++
 .../Visual/Online/TestSceneOfflineCommentsContainer.cs        | 2 ++
 .../Visual/Online/TestSceneOnlineBeatmapListingOverlay.cs     | 2 ++
 .../Visual/Online/TestSceneOnlineBeatmapSetOverlay.cs         | 2 ++
 osu.Game.Tests/Visual/Online/TestSceneOnlineViewContainer.cs  | 2 ++
 .../Visual/Online/TestScenePlayHistorySubsection.cs           | 2 ++
 .../Visual/Online/TestSceneProfileRulesetSelector.cs          | 2 ++
 osu.Game.Tests/Visual/Online/TestSceneRankGraph.cs            | 2 ++
 .../Visual/Online/TestSceneRankingsCountryFilter.cs           | 2 ++
 osu.Game.Tests/Visual/Online/TestSceneRankingsHeader.cs       | 2 ++
 osu.Game.Tests/Visual/Online/TestSceneRankingsOverlay.cs      | 2 ++
 .../Visual/Online/TestSceneRankingsSpotlightSelector.cs       | 2 ++
 osu.Game.Tests/Visual/Online/TestSceneRankingsTables.cs       | 2 ++
 osu.Game.Tests/Visual/Online/TestSceneScoreboardTime.cs       | 2 ++
 osu.Game.Tests/Visual/Online/TestSceneScoresContainer.cs      | 2 ++
 osu.Game.Tests/Visual/Online/TestSceneShowMoreButton.cs       | 2 ++
 osu.Game.Tests/Visual/Online/TestSceneSpotlightsLayout.cs     | 2 ++
 .../Visual/Online/TestSceneStandAloneChatDisplay.cs           | 2 ++
 osu.Game.Tests/Visual/Online/TestSceneTotalCommentsCounter.cs | 2 ++
 osu.Game.Tests/Visual/Online/TestSceneUserHistoryGraph.cs     | 2 ++
 osu.Game.Tests/Visual/Online/TestSceneUserPanel.cs            | 2 ++
 osu.Game.Tests/Visual/Online/TestSceneUserProfileHeader.cs    | 2 ++
 osu.Game.Tests/Visual/Online/TestSceneUserProfileOverlay.cs   | 2 ++
 .../Visual/Online/TestSceneUserProfilePreviousUsernames.cs    | 2 ++
 .../Visual/Online/TestSceneUserProfileRecentSection.cs        | 2 ++
 osu.Game.Tests/Visual/Online/TestSceneUserProfileScores.cs    | 2 ++
 osu.Game.Tests/Visual/Online/TestSceneUserRanks.cs            | 2 ++
 osu.Game.Tests/Visual/Online/TestSceneUserRequest.cs          | 2 ++
 osu.Game.Tests/Visual/Online/TestSceneVotePill.cs             | 2 ++
 osu.Game.Tests/Visual/Online/TestSceneWikiHeader.cs           | 2 ++
 osu.Game.Tests/Visual/Online/TestSceneWikiMainPage.cs         | 2 ++
 .../Visual/Online/TestSceneWikiMarkdownContainer.cs           | 2 ++
 osu.Game.Tests/Visual/Online/TestSceneWikiOverlay.cs          | 2 ++
 osu.Game.Tests/Visual/Online/TestSceneWikiSidebar.cs          | 2 ++
 .../Visual/Playlists/TestScenePlaylistsLoungeSubScreen.cs     | 2 ++
 .../Playlists/TestScenePlaylistsMatchSettingsOverlay.cs       | 2 ++
 .../Visual/Playlists/TestScenePlaylistsParticipantsList.cs    | 2 ++
 .../Visual/Playlists/TestScenePlaylistsResultsScreen.cs       | 2 ++
 .../Visual/Playlists/TestScenePlaylistsRoomCreation.cs        | 2 ++
 osu.Game.Tests/Visual/Playlists/TestScenePlaylistsScreen.cs   | 2 ++
 osu.Game.Tests/Visual/Ranking/TestSceneAccuracyCircle.cs      | 2 ++
 .../Visual/Ranking/TestSceneContractedPanelMiddleContent.cs   | 2 ++
 .../Visual/Ranking/TestSceneExpandedPanelMiddleContent.cs     | 2 ++
 .../Visual/Ranking/TestSceneExpandedPanelTopContent.cs        | 2 ++
 .../Ranking/TestSceneHitEventTimingDistributionGraph.cs       | 2 ++
 osu.Game.Tests/Visual/Ranking/TestSceneResultsScreen.cs       | 2 ++
 osu.Game.Tests/Visual/Ranking/TestSceneScorePanel.cs          | 2 ++
 osu.Game.Tests/Visual/Ranking/TestSceneScorePanelList.cs      | 2 ++
 .../Visual/Ranking/TestSceneSimpleStatisticTable.cs           | 2 ++
 osu.Game.Tests/Visual/Ranking/TestSceneStatisticsPanel.cs     | 2 ++
 osu.Game.Tests/Visual/Settings/TestSceneDirectorySelector.cs  | 2 ++
 osu.Game.Tests/Visual/Settings/TestSceneFileSelector.cs       | 2 ++
 osu.Game.Tests/Visual/Settings/TestSceneKeyBindingPanel.cs    | 2 ++
 .../Visual/Settings/TestSceneLatencyCertifierScreen.cs        | 2 --
 osu.Game.Tests/Visual/Settings/TestSceneMigrationScreens.cs   | 2 ++
 .../Visual/Settings/TestSceneRestoreDefaultValueButton.cs     | 2 ++
 osu.Game.Tests/Visual/Settings/TestSceneSettingsItem.cs       | 2 ++
 osu.Game.Tests/Visual/Settings/TestSceneSettingsNumberBox.cs  | 2 ++
 osu.Game.Tests/Visual/Settings/TestSceneSettingsPanel.cs      | 2 ++
 osu.Game.Tests/Visual/Settings/TestSceneSettingsSource.cs     | 2 ++
 osu.Game.Tests/Visual/Settings/TestSceneTabletSettings.cs     | 2 ++
 osu.Game.Tests/Visual/SongSelect/TestSceneAdvancedStats.cs    | 2 ++
 osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs  | 2 ++
 osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapDetails.cs   | 2 ++
 osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapInfoWedge.cs | 2 ++
 .../Visual/SongSelect/TestSceneBeatmapLeaderboard.cs          | 2 ++
 .../Visual/SongSelect/TestSceneBeatmapMetadataDisplay.cs      | 2 ++
 .../Visual/SongSelect/TestSceneBeatmapOptionsOverlay.cs       | 2 ++
 .../Visual/SongSelect/TestSceneBeatmapRecommendations.cs      | 2 ++
 osu.Game.Tests/Visual/SongSelect/TestSceneFilterControl.cs    | 2 ++
 osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs   | 2 ++
 osu.Game.Tests/Visual/SongSelect/TestSceneSongSelectFooter.cs | 2 ++
 osu.Game.Tests/Visual/SongSelect/TestSceneTopLocalRank.cs     | 2 ++
 .../Visual/SongSelect/TestSceneUserTopScoreContainer.cs       | 2 ++
 osu.Game.Tests/Visual/TestMultiplayerComponents.cs            | 2 ++
 osu.Game.Tests/Visual/TestSceneOsuScreenStack.cs              | 2 ++
 osu.Game.Tests/Visual/UserInterface/TestSceneBackButton.cs    | 2 ++
 .../Visual/UserInterface/TestSceneBeatSyncedContainer.cs      | 2 ++
 .../TestSceneBeatmapListingCardSizeTabControl.cs              | 2 ++
 .../UserInterface/TestSceneBeatmapListingSearchControl.cs     | 2 ++
 .../UserInterface/TestSceneBeatmapListingSortTabControl.cs    | 2 ++
 .../Visual/UserInterface/TestSceneBeatmapSearchFilter.cs      | 2 ++
 .../Visual/UserInterface/TestSceneBreadcrumbControl.cs        | 2 ++
 .../Visual/UserInterface/TestSceneBreadcrumbControlHeader.cs  | 2 ++
 osu.Game.Tests/Visual/UserInterface/TestSceneButtonSystem.cs  | 2 ++
 osu.Game.Tests/Visual/UserInterface/TestSceneColourPicker.cs  | 2 ++
 osu.Game.Tests/Visual/UserInterface/TestSceneCommentEditor.cs | 2 ++
 .../Visual/UserInterface/TestSceneCommentRepliesButton.cs     | 2 ++
 osu.Game.Tests/Visual/UserInterface/TestSceneContextMenu.cs   | 2 ++
 osu.Game.Tests/Visual/UserInterface/TestSceneCursors.cs       | 2 ++
 .../Visual/UserInterface/TestSceneDashboardBeatmapListing.cs  | 2 ++
 .../Visual/UserInterface/TestSceneDeleteLocalScore.cs         | 2 ++
 osu.Game.Tests/Visual/UserInterface/TestSceneDialogOverlay.cs | 2 ++
 .../UserInterface/TestSceneDifficultyMultiplierDisplay.cs     | 2 ++
 osu.Game.Tests/Visual/UserInterface/TestSceneDrawableDate.cs  | 2 ++
 osu.Game.Tests/Visual/UserInterface/TestSceneEditorSidebar.cs | 2 ++
 osu.Game.Tests/Visual/UserInterface/TestSceneExpandingBar.cs  | 2 ++
 .../Visual/UserInterface/TestSceneExpandingContainer.cs       | 2 ++
 .../Visual/UserInterface/TestSceneFirstRunScreenBehaviour.cs  | 2 ++
 .../UserInterface/TestSceneFirstRunScreenBundledBeatmaps.cs   | 2 ++
 .../UserInterface/TestSceneFirstRunScreenImportFromStable.cs  | 2 ++
 .../Visual/UserInterface/TestSceneFirstRunScreenUIScale.cs    | 2 ++
 .../Visual/UserInterface/TestSceneFirstRunSetupOverlay.cs     | 2 ++
 .../Visual/UserInterface/TestSceneFooterButtonMods.cs         | 2 ++
 .../UserInterface/TestSceneFriendsOnlineStatusControl.cs      | 2 ++
 .../Visual/UserInterface/TestSceneHoldToConfirmOverlay.cs     | 2 ++
 osu.Game.Tests/Visual/UserInterface/TestSceneIconButton.cs    | 2 ++
 .../Visual/UserInterface/TestSceneLabelledColourPalette.cs    | 2 ++
 .../Visual/UserInterface/TestSceneLabelledDrawable.cs         | 2 ++
 .../Visual/UserInterface/TestSceneLabelledDropdown.cs         | 2 ++
 .../Visual/UserInterface/TestSceneLabelledSliderBar.cs        | 2 ++
 .../Visual/UserInterface/TestSceneLabelledSwitchButton.cs     | 2 ++
 .../Visual/UserInterface/TestSceneLabelledTextBox.cs          | 2 ++
 osu.Game.Tests/Visual/UserInterface/TestSceneLoadingLayer.cs  | 2 ++
 .../Visual/UserInterface/TestSceneLoadingSpinner.cs           | 2 ++
 osu.Game.Tests/Visual/UserInterface/TestSceneLogoAnimation.cs | 2 ++
 .../Visual/UserInterface/TestSceneLogoTrackingContainer.cs    | 2 ++
 osu.Game.Tests/Visual/UserInterface/TestSceneModColumn.cs     | 2 --
 .../UserInterface/TestSceneModDifficultyAdjustSettings.cs     | 2 ++
 osu.Game.Tests/Visual/UserInterface/TestSceneModDisplay.cs    | 2 ++
 .../Visual/UserInterface/TestSceneModFlowDisplay.cs           | 2 ++
 osu.Game.Tests/Visual/UserInterface/TestSceneModIcon.cs       | 2 ++
 osu.Game.Tests/Visual/UserInterface/TestSceneModPanel.cs      | 2 ++
 .../Visual/UserInterface/TestSceneModSelectOverlay.cs         | 2 ++
 .../Visual/UserInterface/TestSceneModSettingsArea.cs          | 2 ++
 .../Visual/UserInterface/TestSceneModSwitchSmall.cs           | 2 ++
 osu.Game.Tests/Visual/UserInterface/TestSceneModSwitchTiny.cs | 2 ++
 .../Visual/UserInterface/TestSceneNotificationOverlay.cs      | 2 ++
 .../Visual/UserInterface/TestSceneNowPlayingOverlay.cs        | 2 ++
 .../Visual/UserInterface/TestSceneOnScreenDisplay.cs          | 2 ++
 .../Visual/UserInterface/TestSceneOsuAnimatedButton.cs        | 2 ++
 osu.Game.Tests/Visual/UserInterface/TestSceneOsuButton.cs     | 2 ++
 osu.Game.Tests/Visual/UserInterface/TestSceneOsuDropdown.cs   | 2 ++
 osu.Game.Tests/Visual/UserInterface/TestSceneOsuFont.cs       | 2 ++
 .../Visual/UserInterface/TestSceneOsuHoverContainer.cs        | 2 ++
 osu.Game.Tests/Visual/UserInterface/TestSceneOsuIcon.cs       | 2 ++
 osu.Game.Tests/Visual/UserInterface/TestSceneOsuLogo.cs       | 2 ++
 .../Visual/UserInterface/TestSceneOsuMarkdownContainer.cs     | 2 ++
 osu.Game.Tests/Visual/UserInterface/TestSceneOsuMenu.cs       | 2 ++
 osu.Game.Tests/Visual/UserInterface/TestSceneOsuPopover.cs    | 2 ++
 osu.Game.Tests/Visual/UserInterface/TestSceneOsuTextBox.cs    | 2 ++
 osu.Game.Tests/Visual/UserInterface/TestSceneOverlayHeader.cs | 2 ++
 .../Visual/UserInterface/TestSceneOverlayHeaderBackground.cs  | 2 ++
 .../Visual/UserInterface/TestSceneOverlayRulesetSelector.cs   | 2 ++
 .../Visual/UserInterface/TestSceneOverlayScrollContainer.cs   | 2 ++
 osu.Game.Tests/Visual/UserInterface/TestScenePageSelector.cs  | 2 ++
 .../Visual/UserInterface/TestSceneParallaxContainer.cs        | 2 ++
 .../Visual/UserInterface/TestScenePlaylistOverlay.cs          | 2 ++
 osu.Game.Tests/Visual/UserInterface/TestScenePopupDialog.cs   | 2 ++
 .../Visual/UserInterface/TestSceneProfileSubsectionHeader.cs  | 2 ++
 .../Visual/UserInterface/TestSceneRankingsSortTabControl.cs   | 2 ++
 osu.Game.Tests/Visual/UserInterface/TestSceneRoundedButton.cs | 2 ++
 .../Visual/UserInterface/TestSceneSafeAreaHandling.cs         | 2 ++
 .../Visual/UserInterface/TestSceneScalingContainer.cs         | 2 ++
 .../Visual/UserInterface/TestSceneScreenBreadcrumbControl.cs  | 2 ++
 .../Visual/UserInterface/TestSceneSectionsContainer.cs        | 2 ++
 .../Visual/UserInterface/TestSceneSettingsCheckbox.cs         | 2 ++
 .../Visual/UserInterface/TestSceneSettingsToolboxGroup.cs     | 2 ++
 .../Visual/UserInterface/TestSceneShearedButtons.cs           | 2 ++
 .../Visual/UserInterface/TestSceneShearedOverlayContainer.cs  | 2 ++
 .../Visual/UserInterface/TestSceneShearedOverlayHeader.cs     | 2 ++
 .../Visual/UserInterface/TestSceneShearedSearchTextBox.cs     | 2 ++
 .../Visual/UserInterface/TestSceneStarRatingDisplay.cs        | 2 ++
 .../Visual/UserInterface/TestSceneStatefulMenuItem.cs         | 2 ++
 osu.Game.Tests/Visual/UserInterface/TestSceneSwitchButton.cs  | 2 ++
 osu.Game.Tests/Visual/UserInterface/TestSceneTabControl.cs    | 2 ++
 .../Visual/UserInterface/TestSceneToggleMenuItem.cs           | 2 ++
 .../Visual/UserInterface/TestSceneToolbarRulesetSelector.cs   | 2 ++
 .../Visual/UserInterface/TestSceneTwoLayerButton.cs           | 2 ++
 .../TestSceneUpdateableBeatmapBackgroundSprite.cs             | 2 ++
 .../UserInterface/TestSceneUpdateableBeatmapSetCover.cs       | 2 ++
 .../Visual/UserInterface/TestSceneUserListToolbar.cs          | 2 ++
 osu.Game.Tests/Visual/UserInterface/TestSceneVolumeOverlay.cs | 2 ++
 osu.Game.Tests/Visual/UserInterface/TestSceneVolumePieces.cs  | 2 ++
 osu.Game.Tests/Visual/UserInterface/TestSceneWaveContainer.cs | 2 ++
 .../Visual/UserInterface/ThemeComparisonTestScene.cs          | 2 ++
 osu.Game.Tests/WaveformTestBeatmap.cs                         | 2 ++
 osu.Game.Tournament.Tests/Components/TestSceneDateTextBox.cs  | 2 ++
 .../Components/TestSceneDrawableTournamentMatch.cs            | 2 ++
 .../Components/TestSceneDrawableTournamentTeam.cs             | 2 ++
 osu.Game.Tournament.Tests/Components/TestSceneMatchHeader.cs  | 2 ++
 .../Components/TestSceneMatchScoreDisplay.cs                  | 2 ++
 osu.Game.Tournament.Tests/Components/TestSceneRoundDisplay.cs | 2 ++
 osu.Game.Tournament.Tests/Components/TestSceneSongBar.cs      | 2 ++
 .../Components/TestSceneTournamentBeatmapPanel.cs             | 2 ++
 .../Components/TestSceneTournamentMatchChatDisplay.cs         | 2 ++
 .../Components/TestSceneTournamentModDisplay.cs               | 2 ++
 .../NonVisual/CustomTourneyDirectoryTest.cs                   | 2 ++
 osu.Game.Tournament.Tests/NonVisual/DataLoadTest.cs           | 2 ++
 osu.Game.Tournament.Tests/NonVisual/IPCLocationTest.cs        | 2 ++
 .../NonVisual/LadderInfoSerialisationTest.cs                  | 2 ++
 osu.Game.Tournament.Tests/NonVisual/TournamentHostTest.cs     | 2 ++
 osu.Game.Tournament.Tests/Screens/TestSceneDrawingsScreen.cs  | 2 ++
 osu.Game.Tournament.Tests/Screens/TestSceneGameplayScreen.cs  | 2 ++
 .../Screens/TestSceneLadderEditorScreen.cs                    | 2 ++
 osu.Game.Tournament.Tests/Screens/TestSceneLadderScreen.cs    | 2 ++
 osu.Game.Tournament.Tests/Screens/TestSceneMapPoolScreen.cs   | 2 ++
 .../Screens/TestSceneRoundEditorScreen.cs                     | 2 ++
 osu.Game.Tournament.Tests/Screens/TestSceneScheduleScreen.cs  | 2 ++
 .../Screens/TestSceneSeedingEditorScreen.cs                   | 2 ++
 osu.Game.Tournament.Tests/Screens/TestSceneSeedingScreen.cs   | 2 ++
 osu.Game.Tournament.Tests/Screens/TestSceneSetupScreen.cs     | 2 ++
 osu.Game.Tournament.Tests/Screens/TestSceneShowcaseScreen.cs  | 2 ++
 .../Screens/TestSceneStablePathSelectScreen.cs                | 2 ++
 .../Screens/TestSceneTeamEditorScreen.cs                      | 2 ++
 osu.Game.Tournament.Tests/Screens/TestSceneTeamIntroScreen.cs | 2 ++
 osu.Game.Tournament.Tests/Screens/TestSceneTeamWinScreen.cs   | 2 ++
 osu.Game.Tournament.Tests/TestSceneTournamentSceneManager.cs  | 2 ++
 osu.Game.Tournament.Tests/TournamentTestBrowser.cs            | 2 ++
 osu.Game.Tournament.Tests/TournamentTestRunner.cs             | 2 ++
 osu.Game.Tournament.Tests/TournamentTestScene.cs              | 2 ++
 osu.Game.Tournament/Components/ControlPanel.cs                | 2 ++
 osu.Game.Tournament/Components/DateTextBox.cs                 | 2 ++
 osu.Game.Tournament/Components/DrawableTeamFlag.cs            | 2 ++
 osu.Game.Tournament/Components/DrawableTeamHeader.cs          | 2 ++
 osu.Game.Tournament/Components/DrawableTeamTitle.cs           | 2 ++
 osu.Game.Tournament/Components/DrawableTeamTitleWithHeader.cs | 2 ++
 osu.Game.Tournament/Components/DrawableTeamWithPlayers.cs     | 2 ++
 .../Components/DrawableTournamentHeaderLogo.cs                | 2 ++
 .../Components/DrawableTournamentHeaderText.cs                | 2 ++
 osu.Game.Tournament/Components/DrawableTournamentTeam.cs      | 2 ++
 osu.Game.Tournament/Components/IPCErrorDialog.cs              | 2 ++
 osu.Game.Tournament/Components/RoundDisplay.cs                | 2 ++
 osu.Game.Tournament/Components/SongBar.cs                     | 2 ++
 osu.Game.Tournament/Components/TournamentBeatmapPanel.cs      | 2 ++
 osu.Game.Tournament/Components/TournamentMatchChatDisplay.cs  | 2 ++
 osu.Game.Tournament/Components/TournamentModIcon.cs           | 2 ++
 .../Components/TournamentSpriteTextWithBackground.cs          | 2 ++
 osu.Game.Tournament/Components/TourneyVideo.cs                | 2 ++
 osu.Game.Tournament/Configuration/TournamentStorageManager.cs | 2 ++
 osu.Game.Tournament/IO/TournamentStorage.cs                   | 2 ++
 osu.Game.Tournament/IO/TournamentVideoResourceStore.cs        | 2 ++
 osu.Game.Tournament/IPC/FileBasedIPC.cs                       | 2 ++
 osu.Game.Tournament/IPC/MatchIPCInfo.cs                       | 2 ++
 osu.Game.Tournament/IPC/TourneyState.cs                       | 2 ++
 osu.Game.Tournament/JsonPointConverter.cs                     | 2 ++
 osu.Game.Tournament/Models/BeatmapChoice.cs                   | 2 ++
 osu.Game.Tournament/Models/LadderEditorInfo.cs                | 2 ++
 osu.Game.Tournament/Models/LadderInfo.cs                      | 2 ++
 osu.Game.Tournament/Models/RoundBeatmap.cs                    | 2 ++
 osu.Game.Tournament/Models/SeedingBeatmap.cs                  | 2 ++
 osu.Game.Tournament/Models/SeedingResult.cs                   | 2 ++
 osu.Game.Tournament/Models/StableInfo.cs                      | 2 ++
 osu.Game.Tournament/Models/TournamentMatch.cs                 | 2 ++
 osu.Game.Tournament/Models/TournamentProgression.cs           | 2 ++
 osu.Game.Tournament/Models/TournamentRound.cs                 | 2 ++
 osu.Game.Tournament/Models/TournamentTeam.cs                  | 2 ++
 osu.Game.Tournament/Properties/AssemblyInfo.cs                | 2 ++
 osu.Game.Tournament/Screens/BeatmapInfoScreen.cs              | 2 ++
 .../Screens/Drawings/Components/DrawingsConfigManager.cs      | 2 ++
 osu.Game.Tournament/Screens/Drawings/Components/Group.cs      | 2 ++
 .../Screens/Drawings/Components/GroupContainer.cs             | 2 ++
 osu.Game.Tournament/Screens/Drawings/Components/GroupTeam.cs  | 2 ++
 osu.Game.Tournament/Screens/Drawings/Components/ITeamList.cs  | 2 ++
 .../Screens/Drawings/Components/ScrollingTeamContainer.cs     | 2 ++
 .../Screens/Drawings/Components/StorageBackedTeamList.cs      | 2 ++
 .../Screens/Drawings/Components/VisualiserContainer.cs        | 2 ++
 osu.Game.Tournament/Screens/Drawings/DrawingsScreen.cs        | 2 ++
 osu.Game.Tournament/Screens/Editors/IModelBacked.cs           | 2 ++
 osu.Game.Tournament/Screens/Editors/LadderEditorScreen.cs     | 2 ++
 osu.Game.Tournament/Screens/Editors/RoundEditorScreen.cs      | 2 ++
 osu.Game.Tournament/Screens/Editors/SeedingEditorScreen.cs    | 2 ++
 osu.Game.Tournament/Screens/Editors/TeamEditorScreen.cs       | 2 ++
 osu.Game.Tournament/Screens/Editors/TournamentEditorScreen.cs | 2 ++
 .../Screens/Gameplay/Components/MatchHeader.cs                | 2 ++
 .../Screens/Gameplay/Components/MatchRoundDisplay.cs          | 2 ++
 .../Screens/Gameplay/Components/TeamDisplay.cs                | 2 ++
 osu.Game.Tournament/Screens/Gameplay/Components/TeamScore.cs  | 2 ++
 .../Screens/Gameplay/Components/TeamScoreDisplay.cs           | 2 ++
 .../Gameplay/Components/TournamentMatchScoreDisplay.cs        | 2 ++
 osu.Game.Tournament/Screens/Gameplay/GameplayScreen.cs        | 2 ++
 osu.Game.Tournament/Screens/IProvideVideo.cs                  | 2 ++
 .../Screens/Ladder/Components/ConditionalTournamentMatch.cs   | 2 ++
 .../Screens/Ladder/Components/DrawableMatchTeam.cs            | 2 ++
 .../Screens/Ladder/Components/DrawableTournamentMatch.cs      | 2 ++
 .../Screens/Ladder/Components/DrawableTournamentRound.cs      | 2 ++
 .../Screens/Ladder/Components/LadderEditorSettings.cs         | 2 ++
 .../Screens/Ladder/Components/ProgressionPath.cs              | 2 ++
 .../Screens/Ladder/Components/SettingsTeamDropdown.cs         | 2 ++
 osu.Game.Tournament/Screens/Ladder/LadderDragContainer.cs     | 2 ++
 osu.Game.Tournament/Screens/Ladder/LadderScreen.cs            | 2 ++
 osu.Game.Tournament/Screens/MapPool/MapPoolScreen.cs          | 2 ++
 osu.Game.Tournament/Screens/Schedule/ScheduleScreen.cs        | 2 ++
 osu.Game.Tournament/Screens/Setup/ActionableInfo.cs           | 2 ++
 osu.Game.Tournament/Screens/Setup/ResolutionSelector.cs       | 2 ++
 osu.Game.Tournament/Screens/Setup/SetupScreen.cs              | 2 ++
 osu.Game.Tournament/Screens/Setup/StablePathSelectScreen.cs   | 2 ++
 osu.Game.Tournament/Screens/Setup/TournamentSwitcher.cs       | 2 ++
 osu.Game.Tournament/Screens/Showcase/ShowcaseScreen.cs        | 2 ++
 osu.Game.Tournament/Screens/Showcase/TournamentLogo.cs        | 2 ++
 osu.Game.Tournament/Screens/TeamIntro/SeedingScreen.cs        | 2 ++
 osu.Game.Tournament/Screens/TeamIntro/TeamIntroScreen.cs      | 2 ++
 osu.Game.Tournament/Screens/TeamWin/TeamWinScreen.cs          | 2 ++
 osu.Game.Tournament/Screens/TournamentMatchScreen.cs          | 2 ++
 osu.Game.Tournament/Screens/TournamentScreen.cs               | 2 ++
 osu.Game.Tournament/TournamentGame.cs                         | 2 ++
 osu.Game.Tournament/TournamentGameBase.cs                     | 2 ++
 osu.Game.Tournament/TournamentSceneManager.cs                 | 2 ++
 osu.Game.Tournament/TournamentSpriteText.cs                   | 2 ++
 osu.Game.Tournament/TourneyButton.cs                          | 2 ++
 osu.Game.Tournament/WarningBox.cs                             | 2 ++
 osu.Game/Audio/Effects/AudioFilter.cs                         | 2 ++
 osu.Game/Audio/Effects/ITransformableFilter.cs                | 2 ++
 osu.Game/Audio/HitSampleInfo.cs                               | 2 --
 osu.Game/Audio/IPreviewTrackOwner.cs                          | 2 ++
 osu.Game/Audio/ISampleInfo.cs                                 | 2 ++
 osu.Game/Audio/ISamplePlaybackDisabler.cs                     | 2 ++
 osu.Game/Audio/PreviewTrack.cs                                | 2 ++
 osu.Game/Audio/PreviewTrackManager.cs                         | 2 ++
 osu.Game/Audio/SampleInfo.cs                                  | 2 ++
 osu.Game/Beatmaps/APIFailTimes.cs                             | 2 ++
 osu.Game/Beatmaps/Beatmap.cs                                  | 2 ++
 osu.Game/Beatmaps/BeatmapConverter.cs                         | 2 ++
 osu.Game/Beatmaps/BeatmapDifficulty.cs                        | 2 --
 osu.Game/Beatmaps/BeatmapDifficultyCache.cs                   | 2 ++
 osu.Game/Beatmaps/BeatmapImporter.cs                          | 2 --
 osu.Game/Beatmaps/BeatmapInfo.cs                              | 2 --
 osu.Game/Beatmaps/BeatmapInfoExtensions.cs                    | 2 ++
 osu.Game/Beatmaps/BeatmapManager.cs                           | 2 --
 osu.Game/Beatmaps/BeatmapMetadata.cs                          | 2 --
 osu.Game/Beatmaps/BeatmapMetadataInfoExtensions.cs            | 2 ++
 osu.Game/Beatmaps/BeatmapModelDownloader.cs                   | 2 ++
 osu.Game/Beatmaps/BeatmapOnlineLookupQueue.cs                 | 2 ++
 osu.Game/Beatmaps/BeatmapOnlineStatus.cs                      | 2 ++
 osu.Game/Beatmaps/BeatmapProcessor.cs                         | 2 ++
 osu.Game/Beatmaps/BeatmapSetFileInfo.cs                       | 2 ++
 osu.Game/Beatmaps/BeatmapSetHypeStatus.cs                     | 2 ++
 osu.Game/Beatmaps/BeatmapSetInfo.cs                           | 2 --
 osu.Game/Beatmaps/BeatmapSetNominationStatus.cs               | 2 ++
 osu.Game/Beatmaps/BeatmapSetOnlineAvailability.cs             | 2 ++
 osu.Game/Beatmaps/BeatmapSetOnlineCovers.cs                   | 2 ++
 osu.Game/Beatmaps/BeatmapSetOnlineGenre.cs                    | 2 ++
 osu.Game/Beatmaps/BeatmapSetOnlineLanguage.cs                 | 2 ++
 osu.Game/Beatmaps/BeatmapStatistic.cs                         | 2 ++
 osu.Game/Beatmaps/BeatmapStatisticIcon.cs                     | 2 ++
 osu.Game/Beatmaps/BeatmapUserSettings.cs                      | 1 -
 osu.Game/Beatmaps/ControlPoints/ControlPoint.cs               | 2 ++
 osu.Game/Beatmaps/ControlPoints/ControlPointGroup.cs          | 2 ++
 osu.Game/Beatmaps/ControlPoints/ControlPointInfo.cs           | 2 ++
 osu.Game/Beatmaps/ControlPoints/DifficultyControlPoint.cs     | 2 ++
 osu.Game/Beatmaps/ControlPoints/EffectControlPoint.cs         | 2 ++
 osu.Game/Beatmaps/ControlPoints/SampleControlPoint.cs         | 2 ++
 osu.Game/Beatmaps/ControlPoints/TimingControlPoint.cs         | 2 --
 osu.Game/Beatmaps/CountdownType.cs                            | 2 ++
 osu.Game/Beatmaps/DifficultyRating.cs                         | 2 ++
 osu.Game/Beatmaps/DifficultyRecommender.cs                    | 2 ++
 osu.Game/Beatmaps/Drawables/BeatmapBackgroundSprite.cs        | 2 ++
 osu.Game/Beatmaps/Drawables/BeatmapDownloadButton.cs          | 2 ++
 osu.Game/Beatmaps/Drawables/BeatmapSetOnlineStatusPill.cs     | 2 --
 osu.Game/Beatmaps/Drawables/BundledBeatmapDownloader.cs       | 2 ++
 osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs              | 2 --
 osu.Game/Beatmaps/Drawables/Cards/BeatmapCardContent.cs       | 2 --
 .../Beatmaps/Drawables/Cards/BeatmapCardContentBackground.cs  | 2 --
 .../Beatmaps/Drawables/Cards/BeatmapCardDifficultyList.cs     | 2 ++
 .../Drawables/Cards/BeatmapCardDownloadProgressBar.cs         | 2 ++
 osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtra.cs         | 2 --
 osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtraInfoRow.cs  | 2 --
 osu.Game/Beatmaps/Drawables/Cards/BeatmapCardNormal.cs        | 2 --
 osu.Game/Beatmaps/Drawables/Cards/BeatmapCardSize.cs          | 2 ++
 osu.Game/Beatmaps/Drawables/Cards/BeatmapCardThumbnail.cs     | 2 ++
 osu.Game/Beatmaps/Drawables/Cards/BeatmapSetFavouriteState.cs | 2 ++
 .../Beatmaps/Drawables/Cards/Buttons/BeatmapCardIconButton.cs | 2 ++
 osu.Game/Beatmaps/Drawables/Cards/Buttons/DownloadButton.cs   | 2 --
 osu.Game/Beatmaps/Drawables/Cards/Buttons/FavouriteButton.cs  | 2 ++
 .../Beatmaps/Drawables/Cards/Buttons/GoToBeatmapButton.cs     | 2 --
 osu.Game/Beatmaps/Drawables/Cards/Buttons/PlayButton.cs       | 2 --
 .../Beatmaps/Drawables/Cards/CollapsibleButtonContainer.cs    | 2 --
 .../Drawables/Cards/ExpandedContentScrollContainer.cs         | 2 ++
 osu.Game/Beatmaps/Drawables/Cards/HoverHandlingContainer.cs   | 2 --
 osu.Game/Beatmaps/Drawables/Cards/IconPill.cs                 | 2 ++
 .../Drawables/Cards/Statistics/BeatmapCardDateStatistic.cs    | 2 --
 .../Drawables/Cards/Statistics/BeatmapCardStatistic.cs        | 2 ++
 .../Drawables/Cards/Statistics/FavouritesStatistic.cs         | 2 ++
 .../Beatmaps/Drawables/Cards/Statistics/HypesStatistic.cs     | 2 --
 .../Drawables/Cards/Statistics/NominationsStatistic.cs        | 2 --
 .../Beatmaps/Drawables/Cards/Statistics/PlayCountStatistic.cs | 2 ++
 osu.Game/Beatmaps/Drawables/Cards/StoryboardIconPill.cs       | 2 ++
 osu.Game/Beatmaps/Drawables/Cards/VideoIconPill.cs            | 2 ++
 osu.Game/Beatmaps/Drawables/DifficultyIcon.cs                 | 2 ++
 osu.Game/Beatmaps/Drawables/DifficultyIconTooltip.cs          | 2 ++
 osu.Game/Beatmaps/Drawables/DifficultySpectrumDisplay.cs      | 2 ++
 osu.Game/Beatmaps/Drawables/DownloadProgressBar.cs            | 2 ++
 osu.Game/Beatmaps/Drawables/GroupedDifficultyIcon.cs          | 2 ++
 osu.Game/Beatmaps/Drawables/OnlineBeatmapSetCover.cs          | 2 ++
 osu.Game/Beatmaps/Drawables/StarRatingDisplay.cs              | 2 ++
 .../Beatmaps/Drawables/UpdateableBeatmapBackgroundSprite.cs   | 2 ++
 .../Beatmaps/Drawables/UpdateableOnlineBeatmapSetCover.cs     | 2 ++
 osu.Game/Beatmaps/DummyWorkingBeatmap.cs                      | 2 ++
 osu.Game/Beatmaps/EFBeatmapDifficulty.cs                      | 2 ++
 osu.Game/Beatmaps/EFBeatmapInfo.cs                            | 2 ++
 osu.Game/Beatmaps/EFBeatmapMetadata.cs                        | 2 --
 osu.Game/Beatmaps/EFBeatmapSetInfo.cs                         | 2 ++
 osu.Game/Beatmaps/FlatFileWorkingBeatmap.cs                   | 2 ++
 osu.Game/Beatmaps/Formats/Decoder.cs                          | 2 ++
 osu.Game/Beatmaps/Formats/IHasComboColours.cs                 | 2 ++
 osu.Game/Beatmaps/Formats/IHasCustomColours.cs                | 2 ++
 osu.Game/Beatmaps/Formats/JsonBeatmapDecoder.cs               | 2 ++
 osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs             | 2 ++
 osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs             | 2 ++
 osu.Game/Beatmaps/Formats/LegacyDecoder.cs                    | 2 ++
 .../Formats/LegacyDifficultyCalculatorBeatmapDecoder.cs       | 2 ++
 osu.Game/Beatmaps/Formats/LegacyStoryboardDecoder.cs          | 2 ++
 osu.Game/Beatmaps/Formats/Parsing.cs                          | 2 ++
 osu.Game/Beatmaps/IBeatSyncProvider.cs                        | 2 --
 osu.Game/Beatmaps/IBeatmap.cs                                 | 2 ++
 osu.Game/Beatmaps/IBeatmapConverter.cs                        | 2 ++
 osu.Game/Beatmaps/IBeatmapDifficultyInfo.cs                   | 2 --
 osu.Game/Beatmaps/IBeatmapInfo.cs                             | 2 --
 osu.Game/Beatmaps/IBeatmapMetadataInfo.cs                     | 2 --
 osu.Game/Beatmaps/IBeatmapOnlineInfo.cs                       | 2 --
 osu.Game/Beatmaps/IBeatmapProcessor.cs                        | 2 ++
 osu.Game/Beatmaps/IBeatmapResourceProvider.cs                 | 2 ++
 osu.Game/Beatmaps/IBeatmapSetInfo.cs                          | 2 --
 osu.Game/Beatmaps/IBeatmapSetOnlineInfo.cs                    | 2 --
 osu.Game/Beatmaps/IWorkingBeatmap.cs                          | 2 ++
 osu.Game/Beatmaps/IWorkingBeatmapCache.cs                     | 2 ++
 osu.Game/Beatmaps/Legacy/LegacyControlPointInfo.cs            | 2 ++
 osu.Game/Beatmaps/Legacy/LegacyEffectFlags.cs                 | 2 ++
 osu.Game/Beatmaps/Legacy/LegacyEventType.cs                   | 2 ++
 osu.Game/Beatmaps/Legacy/LegacyHitObjectType.cs               | 2 ++
 osu.Game/Beatmaps/Legacy/LegacyHitSoundType.cs                | 2 ++
 osu.Game/Beatmaps/Legacy/LegacyMods.cs                        | 2 ++
 osu.Game/Beatmaps/Legacy/LegacyOrigins.cs                     | 2 ++
 osu.Game/Beatmaps/Legacy/LegacySampleBank.cs                  | 2 ++
 osu.Game/Beatmaps/Legacy/LegacyStoryLayer.cs                  | 2 ++
 osu.Game/Beatmaps/MetadataUtils.cs                            | 2 --
 osu.Game/Beatmaps/StarDifficulty.cs                           | 2 ++
 osu.Game/Beatmaps/Timing/BreakPeriod.cs                       | 2 ++
 osu.Game/Beatmaps/Timing/TimeSignature.cs                     | 2 ++
 osu.Game/Beatmaps/Timing/TimeSignatures.cs                    | 2 ++
 osu.Game/Beatmaps/WorkingBeatmap.cs                           | 2 ++
 osu.Game/Beatmaps/WorkingBeatmapCache.cs                      | 2 ++
 osu.Game/Collections/BeatmapCollection.cs                     | 2 ++
 osu.Game/Collections/CollectionFilterDropdown.cs              | 2 ++
 osu.Game/Collections/CollectionFilterMenuItem.cs              | 2 ++
 osu.Game/Collections/CollectionManager.cs                     | 2 ++
 osu.Game/Collections/DeleteCollectionDialog.cs                | 2 ++
 osu.Game/Collections/DrawableCollectionList.cs                | 2 ++
 osu.Game/Collections/DrawableCollectionListItem.cs            | 2 ++
 osu.Game/Collections/ManageCollectionsDialog.cs               | 2 ++
 osu.Game/Configuration/BackgroundSource.cs                    | 2 ++
 osu.Game/Configuration/DatabasedSetting.cs                    | 2 ++
 osu.Game/Configuration/DevelopmentOsuConfigManager.cs         | 2 ++
 osu.Game/Configuration/DiscordRichPresenceMode.cs             | 2 ++
 osu.Game/Configuration/HUDVisibilityMode.cs                   | 2 ++
 osu.Game/Configuration/InMemoryConfigManager.cs               | 2 ++
 osu.Game/Configuration/IntroSequence.cs                       | 2 ++
 osu.Game/Configuration/ModSettingChangeTracker.cs             | 2 ++
 osu.Game/Configuration/OsuConfigManager.cs                    | 2 ++
 osu.Game/Configuration/RandomSelectAlgorithm.cs               | 2 ++
 osu.Game/Configuration/RealmRulesetSetting.cs                 | 2 --
 osu.Game/Configuration/ReleaseStream.cs                       | 2 ++
 osu.Game/Configuration/ScalingMode.cs                         | 2 ++
 osu.Game/Configuration/ScreenshotFormat.cs                    | 2 ++
 osu.Game/Configuration/ScrollVisualisationMethod.cs           | 2 ++
 osu.Game/Configuration/SeasonalBackgroundMode.cs              | 2 ++
 osu.Game/Configuration/SessionStatics.cs                      | 2 ++
 osu.Game/Configuration/SettingSourceAttribute.cs              | 2 --
 osu.Game/Configuration/SettingsStore.cs                       | 2 ++
 osu.Game/Configuration/StorageConfigManager.cs                | 2 ++
 osu.Game/Configuration/ToolbarClockDisplayMode.cs             | 2 ++
 osu.Game/Database/BeatmapLookupCache.cs                       | 2 ++
 osu.Game/Database/DatabaseContextFactory.cs                   | 2 ++
 osu.Game/Database/DatabaseWriteUsage.cs                       | 2 ++
 osu.Game/Database/EFToRealmMigrator.cs                        | 2 --
 osu.Game/Database/EmptyRealmSet.cs                            | 2 --
 osu.Game/Database/ICanAcceptFiles.cs                          | 2 ++
 osu.Game/Database/IDatabaseContextFactory.cs                  | 2 ++
 osu.Game/Database/IHasFiles.cs                                | 2 ++
 osu.Game/Database/IHasGuidPrimaryKey.cs                       | 2 ++
 osu.Game/Database/IHasNamedFiles.cs                           | 2 ++
 osu.Game/Database/IHasOnlineID.cs                             | 2 --
 osu.Game/Database/IHasPrimaryKey.cs                           | 2 ++
 osu.Game/Database/IHasRealmFiles.cs                           | 2 --
 osu.Game/Database/IModelDownloader.cs                         | 2 ++
 osu.Game/Database/IModelFileManager.cs                        | 2 ++
 osu.Game/Database/IModelImporter.cs                           | 2 --
 osu.Game/Database/IModelManager.cs                            | 2 ++
 osu.Game/Database/INamedFile.cs                               | 2 --
 osu.Game/Database/INamedFileInfo.cs                           | 2 ++
 osu.Game/Database/INamedFileUsage.cs                          | 2 --
 osu.Game/Database/IPostImports.cs                             | 2 --
 osu.Game/Database/IPostNotifications.cs                       | 2 ++
 osu.Game/Database/ISoftDelete.cs                              | 2 ++
 osu.Game/Database/ImportProgressNotification.cs               | 2 ++
 osu.Game/Database/ImportTask.cs                               | 2 --
 osu.Game/Database/LegacyBeatmapExporter.cs                    | 2 ++
 osu.Game/Database/LegacyBeatmapImporter.cs                    | 2 ++
 osu.Game/Database/LegacyExporter.cs                           | 2 ++
 osu.Game/Database/LegacyImportManager.cs                      | 2 ++
 osu.Game/Database/LegacyModelImporter.cs                      | 2 ++
 osu.Game/Database/LegacyScoreExporter.cs                      | 2 ++
 osu.Game/Database/LegacyScoreImporter.cs                      | 2 ++
 osu.Game/Database/LegacySkinExporter.cs                       | 2 ++
 osu.Game/Database/LegacySkinImporter.cs                       | 2 ++
 osu.Game/Database/Live.cs                                     | 2 --
 osu.Game/Database/MemoryCachingComponent.cs                   | 2 ++
 osu.Game/Database/ModelDownloader.cs                          | 2 ++
 osu.Game/Database/ModelManager.cs                             | 2 --
 osu.Game/Database/OnlineLookupCache.cs                        | 2 ++
 osu.Game/Database/OsuDbContext.cs                             | 2 ++
 osu.Game/Database/RealmAccess.cs                              | 2 --
 osu.Game/Database/RealmArchiveModelImporter.cs                | 2 --
 osu.Game/Database/RealmExtensions.cs                          | 2 --
 osu.Game/Database/RealmFileStore.cs                           | 2 --
 osu.Game/Database/RealmLive.cs                                | 2 --
 osu.Game/Database/RealmLiveUnmanaged.cs                       | 2 --
 osu.Game/Database/RealmObjectExtensions.cs                    | 2 --
 osu.Game/Database/UserLookupCache.cs                          | 2 ++
 osu.Game/Extensions/CollectionExtensions.cs                   | 2 ++
 osu.Game/Extensions/DrawableExtensions.cs                     | 2 ++
 osu.Game/Extensions/LanguageExtensions.cs                     | 2 ++
 osu.Game/Extensions/ModelExtensions.cs                        | 2 --
 osu.Game/Extensions/TaskExtensions.cs                         | 2 --
 osu.Game/Extensions/TimeDisplayExtensions.cs                  | 2 ++
 osu.Game/Extensions/TypeExtensions.cs                         | 2 ++
 osu.Game/Extensions/WebRequestExtensions.cs                   | 2 ++
 osu.Game/Graphics/Backgrounds/Background.cs                   | 2 ++
 osu.Game/Graphics/Backgrounds/BeatmapBackground.cs            | 2 ++
 .../Graphics/Backgrounds/BeatmapBackgroundWithStoryboard.cs   | 2 --
 osu.Game/Graphics/Backgrounds/SeasonalBackgroundLoader.cs     | 2 ++
 osu.Game/Graphics/Backgrounds/SkinBackground.cs               | 2 ++
 osu.Game/Graphics/Backgrounds/Triangles.cs                    | 2 ++
 osu.Game/Graphics/Containers/BeatSyncedContainer.cs           | 2 ++
 osu.Game/Graphics/Containers/ConstrainedIconContainer.cs      | 2 ++
 osu.Game/Graphics/Containers/ExpandingButtonContainer.cs      | 2 ++
 osu.Game/Graphics/Containers/ExpandingContainer.cs            | 2 ++
 osu.Game/Graphics/Containers/HoldToConfirmContainer.cs        | 2 ++
 osu.Game/Graphics/Containers/IExpandable.cs                   | 2 ++
 osu.Game/Graphics/Containers/IExpandingContainer.cs           | 2 ++
 osu.Game/Graphics/Containers/LinkFlowContainer.cs             | 2 ++
 osu.Game/Graphics/Containers/LogoTrackingContainer.cs         | 2 ++
 osu.Game/Graphics/Containers/Markdown/OsuMarkdownContainer.cs | 2 ++
 .../Containers/Markdown/OsuMarkdownFencedCodeBlock.cs         | 2 ++
 osu.Game/Graphics/Containers/Markdown/OsuMarkdownHeading.cs   | 2 ++
 osu.Game/Graphics/Containers/Markdown/OsuMarkdownImage.cs     | 2 ++
 osu.Game/Graphics/Containers/Markdown/OsuMarkdownLinkText.cs  | 2 ++
 osu.Game/Graphics/Containers/Markdown/OsuMarkdownListItem.cs  | 2 ++
 .../Containers/Markdown/OsuMarkdownOrderedListItem.cs         | 2 ++
 .../Graphics/Containers/Markdown/OsuMarkdownQuoteBlock.cs     | 2 ++
 osu.Game/Graphics/Containers/Markdown/OsuMarkdownSeparator.cs | 2 ++
 osu.Game/Graphics/Containers/Markdown/OsuMarkdownTable.cs     | 2 ++
 osu.Game/Graphics/Containers/Markdown/OsuMarkdownTableCell.cs | 2 ++
 .../Containers/Markdown/OsuMarkdownTextFlowContainer.cs       | 2 ++
 .../Containers/Markdown/OsuMarkdownUnorderedListItem.cs       | 2 ++
 osu.Game/Graphics/Containers/OsuClickableContainer.cs         | 2 ++
 osu.Game/Graphics/Containers/OsuFocusedOverlayContainer.cs    | 2 ++
 osu.Game/Graphics/Containers/OsuHoverContainer.cs             | 2 ++
 osu.Game/Graphics/Containers/OsuRearrangeableListContainer.cs | 2 ++
 osu.Game/Graphics/Containers/OsuRearrangeableListItem.cs      | 2 ++
 osu.Game/Graphics/Containers/OsuScrollContainer.cs            | 2 --
 osu.Game/Graphics/Containers/OsuTextFlowContainer.cs          | 2 ++
 osu.Game/Graphics/Containers/ParallaxContainer.cs             | 2 ++
 .../Graphics/Containers/ReverseChildIDFillFlowContainer.cs    | 2 ++
 osu.Game/Graphics/Containers/ScalingContainer.cs              | 2 ++
 osu.Game/Graphics/Containers/SectionsContainer.cs             | 2 ++
 .../Graphics/Containers/SelectionCycleFillFlowContainer.cs    | 2 ++
 osu.Game/Graphics/Containers/ShakeContainer.cs                | 2 ++
 osu.Game/Graphics/Containers/UserDimContainer.cs              | 2 ++
 osu.Game/Graphics/Containers/UserTrackingScrollContainer.cs   | 2 ++
 osu.Game/Graphics/Containers/WaveContainer.cs                 | 2 ++
 osu.Game/Graphics/Cursor/IProvideCursor.cs                    | 2 ++
 osu.Game/Graphics/Cursor/MenuCursor.cs                        | 2 ++
 osu.Game/Graphics/Cursor/MenuCursorContainer.cs               | 2 ++
 osu.Game/Graphics/Cursor/OsuContextMenuContainer.cs           | 2 ++
 osu.Game/Graphics/Cursor/OsuTooltipContainer.cs               | 2 ++
 osu.Game/Graphics/DateTooltip.cs                              | 2 ++
 osu.Game/Graphics/DrawableDate.cs                             | 2 ++
 osu.Game/Graphics/ErrorTextFlowContainer.cs                   | 2 ++
 osu.Game/Graphics/IHasAccentColour.cs                         | 2 ++
 osu.Game/Graphics/InputBlockingContainer.cs                   | 1 -
 osu.Game/Graphics/OpenGL/Vertices/PositionAndColourVertex.cs  | 2 ++
 osu.Game/Graphics/OsuColour.cs                                | 2 ++
 osu.Game/Graphics/OsuFont.cs                                  | 2 ++
 osu.Game/Graphics/OsuIcon.cs                                  | 2 ++
 osu.Game/Graphics/ParticleExplosion.cs                        | 2 ++
 osu.Game/Graphics/ParticleSpewer.cs                           | 2 ++
 osu.Game/Graphics/ScreenshotManager.cs                        | 2 ++
 osu.Game/Graphics/Sprites/GlowingSpriteText.cs                | 2 ++
 osu.Game/Graphics/Sprites/LogoAnimation.cs                    | 2 ++
 osu.Game/Graphics/Sprites/OsuSpriteText.cs                    | 2 ++
 osu.Game/Graphics/UserInterface/BackButton.cs                 | 2 ++
 osu.Game/Graphics/UserInterface/Bar.cs                        | 2 ++
 osu.Game/Graphics/UserInterface/BarGraph.cs                   | 2 ++
 osu.Game/Graphics/UserInterface/BasicSearchTextBox.cs         | 4 +++-
 osu.Game/Graphics/UserInterface/BreadcrumbControl.cs          | 2 ++
 osu.Game/Graphics/UserInterface/CommaSeparatedScoreCounter.cs | 2 ++
 osu.Game/Graphics/UserInterface/DangerousTriangleButton.cs    | 2 ++
 osu.Game/Graphics/UserInterface/DialogButton.cs               | 2 ++
 osu.Game/Graphics/UserInterface/DownloadButton.cs             | 2 ++
 osu.Game/Graphics/UserInterface/DrawableOsuMenuItem.cs        | 2 ++
 osu.Game/Graphics/UserInterface/DrawableStatefulMenuItem.cs   | 2 ++
 osu.Game/Graphics/UserInterface/ExpandableSlider.cs           | 2 ++
 osu.Game/Graphics/UserInterface/ExpandingBar.cs               | 2 ++
 osu.Game/Graphics/UserInterface/ExternalLinkButton.cs         | 2 ++
 osu.Game/Graphics/UserInterface/FocusedTextBox.cs             | 2 --
 osu.Game/Graphics/UserInterface/GradientLineTabControl.cs     | 2 ++
 osu.Game/Graphics/UserInterface/GrayButton.cs                 | 2 ++
 osu.Game/Graphics/UserInterface/HoverClickSounds.cs           | 2 ++
 .../Graphics/UserInterface/HoverSampleDebounceComponent.cs    | 2 ++
 osu.Game/Graphics/UserInterface/HoverSampleSet.cs             | 2 ++
 osu.Game/Graphics/UserInterface/HoverSounds.cs                | 2 ++
 osu.Game/Graphics/UserInterface/IconButton.cs                 | 2 ++
 osu.Game/Graphics/UserInterface/LineGraph.cs                  | 2 ++
 osu.Game/Graphics/UserInterface/LoadingButton.cs              | 2 ++
 osu.Game/Graphics/UserInterface/LoadingLayer.cs               | 2 ++
 osu.Game/Graphics/UserInterface/LoadingSpinner.cs             | 2 ++
 osu.Game/Graphics/UserInterface/MenuItemType.cs               | 2 ++
 osu.Game/Graphics/UserInterface/Nub.cs                        | 2 ++
 osu.Game/Graphics/UserInterface/OsuAnimatedButton.cs          | 2 ++
 osu.Game/Graphics/UserInterface/OsuButton.cs                  | 2 ++
 osu.Game/Graphics/UserInterface/OsuCheckbox.cs                | 2 ++
 osu.Game/Graphics/UserInterface/OsuContextMenu.cs             | 2 ++
 osu.Game/Graphics/UserInterface/OsuContextMenuSamples.cs      | 2 ++
 osu.Game/Graphics/UserInterface/OsuDropdown.cs                | 2 --
 osu.Game/Graphics/UserInterface/OsuEnumDropdown.cs            | 2 ++
 osu.Game/Graphics/UserInterface/OsuMenu.cs                    | 2 ++
 osu.Game/Graphics/UserInterface/OsuMenuItem.cs                | 2 ++
 osu.Game/Graphics/UserInterface/OsuNumberBox.cs               | 2 ++
 osu.Game/Graphics/UserInterface/OsuPasswordTextBox.cs         | 2 ++
 osu.Game/Graphics/UserInterface/OsuSliderBar.cs               | 2 ++
 osu.Game/Graphics/UserInterface/OsuTabControl.cs              | 2 ++
 osu.Game/Graphics/UserInterface/OsuTabControlCheckbox.cs      | 2 ++
 osu.Game/Graphics/UserInterface/OsuTabDropdown.cs             | 2 ++
 osu.Game/Graphics/UserInterface/OsuTextBox.cs                 | 2 --
 osu.Game/Graphics/UserInterface/PageSelector/PageEllipsis.cs  | 2 ++
 osu.Game/Graphics/UserInterface/PageSelector/PageSelector.cs  | 2 ++
 .../Graphics/UserInterface/PageSelector/PageSelectorButton.cs | 2 ++
 .../UserInterface/PageSelector/PageSelectorPageButton.cs      | 2 ++
 .../UserInterface/PageSelector/PageSelectorPrevNextButton.cs  | 2 ++
 osu.Game/Graphics/UserInterface/PageTabControl.cs             | 2 ++
 osu.Game/Graphics/UserInterface/PercentageCounter.cs          | 2 ++
 osu.Game/Graphics/UserInterface/ProgressBar.cs                | 2 ++
 osu.Game/Graphics/UserInterface/RollingCounter.cs             | 2 ++
 osu.Game/Graphics/UserInterface/ScoreCounter.cs               | 2 ++
 osu.Game/Graphics/UserInterface/ScreenBreadcrumbControl.cs    | 2 ++
 osu.Game/Graphics/UserInterface/SearchTextBox.cs              | 2 ++
 osu.Game/Graphics/UserInterface/SeekLimitedSearchTextBox.cs   | 2 ++
 osu.Game/Graphics/UserInterface/SelectionState.cs             | 2 ++
 osu.Game/Graphics/UserInterface/ShearedButton.cs              | 1 -
 osu.Game/Graphics/UserInterface/ShearedOverlayHeader.cs       | 2 --
 osu.Game/Graphics/UserInterface/ShearedSearchTextBox.cs       | 2 ++
 osu.Game/Graphics/UserInterface/ShearedToggleButton.cs        | 2 --
 osu.Game/Graphics/UserInterface/ShowMoreButton.cs             | 2 ++
 osu.Game/Graphics/UserInterface/SlimEnumDropdown.cs           | 2 ++
 osu.Game/Graphics/UserInterface/StarCounter.cs                | 2 ++
 osu.Game/Graphics/UserInterface/StatefulMenuItem.cs           | 2 ++
 osu.Game/Graphics/UserInterface/TernaryState.cs               | 2 ++
 osu.Game/Graphics/UserInterface/TernaryStateMenuItem.cs       | 2 ++
 osu.Game/Graphics/UserInterface/TernaryStateRadioMenuItem.cs  | 2 ++
 osu.Game/Graphics/UserInterface/TernaryStateToggleMenuItem.cs | 2 ++
 osu.Game/Graphics/UserInterface/TimeSlider.cs                 | 2 ++
 osu.Game/Graphics/UserInterface/ToggleMenuItem.cs             | 2 ++
 osu.Game/Graphics/UserInterface/TriangleButton.cs             | 2 ++
 osu.Game/Graphics/UserInterface/TwoLayerButton.cs             | 2 ++
 osu.Game/Graphics/UserInterfaceV2/ColourDisplay.cs            | 2 ++
 osu.Game/Graphics/UserInterfaceV2/ColourPalette.cs            | 2 ++
 osu.Game/Graphics/UserInterfaceV2/LabelledColourPalette.cs    | 2 ++
 osu.Game/Graphics/UserInterfaceV2/LabelledComponent.cs        | 2 ++
 osu.Game/Graphics/UserInterfaceV2/LabelledDrawable.cs         | 2 --
 osu.Game/Graphics/UserInterfaceV2/LabelledDropdown.cs         | 2 ++
 osu.Game/Graphics/UserInterfaceV2/LabelledEnumDropdown.cs     | 2 ++
 osu.Game/Graphics/UserInterfaceV2/LabelledNumberBox.cs        | 2 ++
 osu.Game/Graphics/UserInterfaceV2/LabelledSliderBar.cs        | 2 ++
 osu.Game/Graphics/UserInterfaceV2/LabelledSwitchButton.cs     | 2 ++
 osu.Game/Graphics/UserInterfaceV2/LabelledTextBox.cs          | 2 ++
 osu.Game/Graphics/UserInterfaceV2/OsuColourPicker.cs          | 2 ++
 osu.Game/Graphics/UserInterfaceV2/OsuDirectorySelector.cs     | 2 ++
 .../UserInterfaceV2/OsuDirectorySelectorBreadcrumbDisplay.cs  | 2 ++
 .../Graphics/UserInterfaceV2/OsuDirectorySelectorDirectory.cs | 2 ++
 .../UserInterfaceV2/OsuDirectorySelectorParentDirectory.cs    | 2 ++
 osu.Game/Graphics/UserInterfaceV2/OsuFileSelector.cs          | 2 ++
 osu.Game/Graphics/UserInterfaceV2/OsuHSVColourPicker.cs       | 2 ++
 osu.Game/Graphics/UserInterfaceV2/OsuHexColourPicker.cs       | 2 ++
 osu.Game/Graphics/UserInterfaceV2/OsuPopover.cs               | 2 ++
 osu.Game/Graphics/UserInterfaceV2/RoundedButton.cs            | 2 ++
 osu.Game/Graphics/UserInterfaceV2/SwitchButton.cs             | 2 --
 osu.Game/IO/Archives/ArchiveReader.cs                         | 2 ++
 osu.Game/IO/Archives/LegacyByteArrayReader.cs                 | 2 ++
 osu.Game/IO/Archives/LegacyDirectoryArchiveReader.cs          | 2 ++
 osu.Game/IO/Archives/LegacyFileArchiveReader.cs               | 2 ++
 osu.Game/IO/Archives/ZipArchiveReader.cs                      | 2 ++
 osu.Game/IO/FileAbstraction/StreamFileAbstraction.cs          | 2 ++
 osu.Game/IO/FileInfo.cs                                       | 2 ++
 osu.Game/IO/IFileInfo.cs                                      | 2 --
 osu.Game/IO/IStorageResourceProvider.cs                       | 2 ++
 osu.Game/IO/Legacy/ILegacySerializable.cs                     | 2 ++
 osu.Game/IO/Legacy/SerializationReader.cs                     | 2 ++
 osu.Game/IO/Legacy/SerializationWriter.cs                     | 2 ++
 osu.Game/IO/LineBufferedReader.cs                             | 2 ++
 osu.Game/IO/MigratableStorage.cs                              | 2 ++
 osu.Game/IO/OsuStorage.cs                                     | 2 ++
 .../Serialization/Converters/SnakeCaseStringEnumConverter.cs  | 2 ++
 osu.Game/IO/Serialization/Converters/TypedListConverter.cs    | 2 ++
 osu.Game/IO/Serialization/JsonSerializableExtensions.cs       | 2 ++
 osu.Game/IO/Serialization/SnakeCaseKeyContractResolver.cs     | 2 ++
 osu.Game/IO/StableStorage.cs                                  | 2 ++
 osu.Game/IO/WrappedStorage.cs                                 | 2 ++
 osu.Game/IPC/ArchiveImportIPCChannel.cs                       | 2 ++
 osu.Game/Input/Bindings/DatabasedKeyBindingContainer.cs       | 2 ++
 osu.Game/Input/Bindings/GlobalActionContainer.cs              | 2 ++
 osu.Game/Input/Bindings/RealmKeyBinding.cs                    | 2 --
 osu.Game/Input/ConfineMouseTracker.cs                         | 2 ++
 osu.Game/Input/GameIdleTracker.cs                             | 2 ++
 osu.Game/Input/Handlers/ReplayInputHandler.cs                 | 2 ++
 osu.Game/Input/IdleTracker.cs                                 | 2 ++
 osu.Game/Input/OsuConfineMouseMode.cs                         | 2 ++
 osu.Game/Input/OsuUserInputManager.cs                         | 2 ++
 osu.Game/Input/RealmKeyBindingStore.cs                        | 2 --
 osu.Game/Localisation/AudioSettingsStrings.cs                 | 2 ++
 osu.Game/Localisation/BeatmapOffsetControlStrings.cs          | 2 ++
 osu.Game/Localisation/BindingSettingsStrings.cs               | 2 ++
 osu.Game/Localisation/ButtonSystemStrings.cs                  | 2 ++
 osu.Game/Localisation/ChatStrings.cs                          | 2 ++
 osu.Game/Localisation/CommonStrings.cs                        | 4 +++-
 osu.Game/Localisation/DebugLocalisationStore.cs               | 2 ++
 osu.Game/Localisation/DebugSettingsStrings.cs                 | 2 ++
 osu.Game/Localisation/DifficultyMultiplierDisplayStrings.cs   | 4 +++-
 .../FirstRunOverlayImportFromStableScreenStrings.cs           | 2 ++
 osu.Game/Localisation/FirstRunSetupBeatmapScreenStrings.cs    | 2 ++
 osu.Game/Localisation/FirstRunSetupOverlayStrings.cs          | 2 ++
 osu.Game/Localisation/GameplaySettingsStrings.cs              | 2 ++
 osu.Game/Localisation/GeneralSettingsStrings.cs               | 2 ++
 osu.Game/Localisation/GlobalActionKeyBindingStrings.cs        | 2 ++
 osu.Game/Localisation/GraphicsSettingsStrings.cs              | 2 ++
 osu.Game/Localisation/InputSettingsStrings.cs                 | 2 ++
 osu.Game/Localisation/JoystickSettingsStrings.cs              | 2 ++
 osu.Game/Localisation/Language.cs                             | 2 ++
 osu.Game/Localisation/LayoutSettingsStrings.cs                | 2 ++
 osu.Game/Localisation/LeaderboardStrings.cs                   | 2 ++
 osu.Game/Localisation/MaintenanceSettingsStrings.cs           | 2 ++
 osu.Game/Localisation/ModSelectOverlayStrings.cs              | 2 ++
 osu.Game/Localisation/MouseSettingsStrings.cs                 | 2 ++
 osu.Game/Localisation/MultiplayerTeamResultsScreenStrings.cs  | 4 +++-
 osu.Game/Localisation/NamedOverlayComponentStrings.cs         | 2 ++
 osu.Game/Localisation/NotificationsStrings.cs                 | 2 ++
 osu.Game/Localisation/NowPlayingStrings.cs                    | 2 ++
 osu.Game/Localisation/OnlineSettingsStrings.cs                | 2 ++
 osu.Game/Localisation/ResourceManagerLocalisationStore.cs     | 2 ++
 osu.Game/Localisation/RulesetSettingsStrings.cs               | 2 ++
 osu.Game/Localisation/SettingsStrings.cs                      | 2 ++
 osu.Game/Localisation/SkinSettingsStrings.cs                  | 2 ++
 osu.Game/Localisation/TabletSettingsStrings.cs                | 4 +++-
 osu.Game/Localisation/ToastStrings.cs                         | 2 ++
 osu.Game/Localisation/UserInterfaceStrings.cs                 | 2 ++
 osu.Game/Migrations/20171019041408_InitialCreate.Designer.cs  | 2 ++
 osu.Game/Migrations/20171019041408_InitialCreate.cs           | 2 ++
 .../20171025071459_AddMissingIndexRules.Designer.cs           | 2 ++
 osu.Game/Migrations/20171025071459_AddMissingIndexRules.cs    | 2 ++
 ...71119065731_AddBeatmapOnlineIDUniqueConstraint.Designer.cs | 2 ++
 .../20171119065731_AddBeatmapOnlineIDUniqueConstraint.cs      | 2 ++
 .../20171209034410_AddRulesetInfoShortName.Designer.cs        | 2 ++
 osu.Game/Migrations/20171209034410_AddRulesetInfoShortName.cs | 2 ++
 osu.Game/Migrations/20180125143340_Settings.Designer.cs       | 2 ++
 osu.Game/Migrations/20180125143340_Settings.cs                | 2 ++
 osu.Game/Migrations/20180131154205_AddMuteBinding.cs          | 2 ++
 osu.Game/Migrations/20180219060912_AddSkins.Designer.cs       | 2 ++
 osu.Game/Migrations/20180219060912_AddSkins.cs                | 2 ++
 .../20180529055154_RemoveUniqueHashConstraints.Designer.cs    | 2 ++
 .../Migrations/20180529055154_RemoveUniqueHashConstraints.cs  | 2 ++
 .../20180621044111_UpdateTaikoDefaultBindings.Designer.cs     | 2 ++
 .../Migrations/20180621044111_UpdateTaikoDefaultBindings.cs   | 2 ++
 .../20180628011956_RemoveNegativeSetIDs.Designer.cs           | 2 ++
 osu.Game/Migrations/20180628011956_RemoveNegativeSetIDs.cs    | 2 ++
 osu.Game/Migrations/20180913080842_AddRankStatus.Designer.cs  | 2 ++
 osu.Game/Migrations/20180913080842_AddRankStatus.cs           | 2 ++
 .../Migrations/20181007180454_StandardizePaths.Designer.cs    | 2 ++
 osu.Game/Migrations/20181007180454_StandardizePaths.cs        | 2 ++
 .../Migrations/20181128100659_AddSkinInfoHash.Designer.cs     | 2 ++
 osu.Game/Migrations/20181128100659_AddSkinInfoHash.cs         | 2 ++
 .../Migrations/20181130113755_AddScoreInfoTables.Designer.cs  | 2 ++
 osu.Game/Migrations/20181130113755_AddScoreInfoTables.cs      | 2 ++
 .../Migrations/20190225062029_AddUserIDColumn.Designer.cs     | 2 ++
 osu.Game/Migrations/20190225062029_AddUserIDColumn.cs         | 2 ++
 osu.Game/Migrations/20190525060824_SkinSettings.Designer.cs   | 2 ++
 osu.Game/Migrations/20190525060824_SkinSettings.cs            | 2 ++
 .../20190605091246_AddDateAddedColumnToBeatmapSet.Designer.cs | 2 ++
 .../20190605091246_AddDateAddedColumnToBeatmapSet.cs          | 2 ++
 .../20190708070844_AddBPMAndLengthColumns.Designer.cs         | 2 ++
 osu.Game/Migrations/20190708070844_AddBPMAndLengthColumns.cs  | 2 ++
 .../Migrations/20190913104727_AddBeatmapVideo.Designer.cs     | 2 ++
 osu.Game/Migrations/20190913104727_AddBeatmapVideo.cs         | 2 ++
 .../20200302094919_RefreshVolumeBindings.Designer.cs          | 2 ++
 osu.Game/Migrations/20200302094919_RefreshVolumeBindings.cs   | 2 ++
 .../Migrations/20201019224408_AddEpilepsyWarning.Designer.cs  | 2 ++
 osu.Game/Migrations/20201019224408_AddEpilepsyWarning.cs      | 2 ++
 .../20210412045700_RefreshVolumeBindingsAgain.Designer.cs     | 2 ++
 .../Migrations/20210412045700_RefreshVolumeBindingsAgain.cs   | 2 ++
 .../20210511060743_AddSkinInstantiationInfo.Designer.cs       | 2 ++
 .../Migrations/20210511060743_AddSkinInstantiationInfo.cs     | 2 ++
 .../20210514062639_AddAuthorIdToBeatmapMetadata.Designer.cs   | 2 ++
 .../Migrations/20210514062639_AddAuthorIdToBeatmapMetadata.cs | 2 ++
 .../20210824185035_AddCountdownSettings.Designer.cs           | 2 ++
 osu.Game/Migrations/20210824185035_AddCountdownSettings.cs    | 2 ++
 .../20210912144011_AddSamplesMatchPlaybackRate.Designer.cs    | 2 ++
 .../Migrations/20210912144011_AddSamplesMatchPlaybackRate.cs  | 2 ++
 osu.Game/Migrations/20211020081609_ResetSkinHashes.cs         | 2 ++
 osu.Game/Migrations/OsuDbContextModelSnapshot.cs              | 2 ++
 osu.Game/Models/RealmFile.cs                                  | 2 --
 osu.Game/Models/RealmNamedFileUsage.cs                        | 2 --
 osu.Game/Models/RealmUser.cs                                  | 2 ++
 osu.Game/Online/API/APIAccess.cs                              | 2 ++
 osu.Game/Online/API/APIDownloadRequest.cs                     | 2 ++
 osu.Game/Online/API/APIException.cs                           | 2 ++
 osu.Game/Online/API/APIMessagesRequest.cs                     | 2 ++
 osu.Game/Online/API/APIMod.cs                                 | 2 ++
 osu.Game/Online/API/APIRequest.cs                             | 2 ++
 osu.Game/Online/API/APIRequestCompletionState.cs              | 2 ++
 osu.Game/Online/API/ArchiveDownloadRequest.cs                 | 2 ++
 osu.Game/Online/API/DummyAPIAccess.cs                         | 2 ++
 osu.Game/Online/API/IAPIProvider.cs                           | 2 --
 osu.Game/Online/API/ModSettingsDictionaryFormatter.cs         | 2 ++
 osu.Game/Online/API/OAuth.cs                                  | 2 ++
 osu.Game/Online/API/OAuthToken.cs                             | 2 ++
 osu.Game/Online/API/OsuJsonWebRequest.cs                      | 2 ++
 osu.Game/Online/API/OsuWebRequest.cs                          | 2 ++
 osu.Game/Online/API/RegistrationRequest.cs                    | 2 ++
 osu.Game/Online/API/Requests/CommentVoteRequest.cs            | 2 ++
 osu.Game/Online/API/Requests/CreateChannelRequest.cs          | 2 ++
 .../Online/API/Requests/CreateNewPrivateMessageRequest.cs     | 2 ++
 .../Online/API/Requests/CreateNewPrivateMessageResponse.cs    | 2 ++
 osu.Game/Online/API/Requests/Cursor.cs                        | 2 ++
 osu.Game/Online/API/Requests/DownloadBeatmapSetRequest.cs     | 2 ++
 osu.Game/Online/API/Requests/DownloadReplayRequest.cs         | 2 ++
 osu.Game/Online/API/Requests/GetBeatmapRequest.cs             | 2 --
 osu.Game/Online/API/Requests/GetBeatmapSetRequest.cs          | 2 ++
 osu.Game/Online/API/Requests/GetBeatmapsRequest.cs            | 2 ++
 osu.Game/Online/API/Requests/GetBeatmapsResponse.cs           | 2 ++
 osu.Game/Online/API/Requests/GetChangelogBuildRequest.cs      | 2 ++
 osu.Game/Online/API/Requests/GetChangelogRequest.cs           | 2 ++
 osu.Game/Online/API/Requests/GetCommentsRequest.cs            | 2 ++
 osu.Game/Online/API/Requests/GetCountriesResponse.cs          | 2 ++
 osu.Game/Online/API/Requests/GetCountryRankingsRequest.cs     | 2 ++
 osu.Game/Online/API/Requests/GetFriendsRequest.cs             | 2 ++
 osu.Game/Online/API/Requests/GetMessagesRequest.cs            | 2 ++
 osu.Game/Online/API/Requests/GetNewsRequest.cs                | 2 ++
 osu.Game/Online/API/Requests/GetNewsResponse.cs               | 2 ++
 osu.Game/Online/API/Requests/GetRankingsRequest.cs            | 2 ++
 osu.Game/Online/API/Requests/GetScoresRequest.cs              | 2 ++
 osu.Game/Online/API/Requests/GetSeasonalBackgroundsRequest.cs | 2 ++
 osu.Game/Online/API/Requests/GetSpotlightRankingsRequest.cs   | 2 ++
 osu.Game/Online/API/Requests/GetSpotlightRankingsResponse.cs  | 2 ++
 osu.Game/Online/API/Requests/GetSpotlightsRequest.cs          | 2 ++
 osu.Game/Online/API/Requests/GetTopUsersRequest.cs            | 2 ++
 osu.Game/Online/API/Requests/GetTopUsersResponse.cs           | 2 ++
 osu.Game/Online/API/Requests/GetUpdatesRequest.cs             | 2 ++
 osu.Game/Online/API/Requests/GetUpdatesResponse.cs            | 2 ++
 osu.Game/Online/API/Requests/GetUserBeatmapsRequest.cs        | 2 ++
 osu.Game/Online/API/Requests/GetUserKudosuHistoryRequest.cs   | 2 ++
 .../Online/API/Requests/GetUserMostPlayedBeatmapsRequest.cs   | 2 ++
 osu.Game/Online/API/Requests/GetUserRankingsRequest.cs        | 2 ++
 .../Online/API/Requests/GetUserRecentActivitiesRequest.cs     | 2 ++
 osu.Game/Online/API/Requests/GetUserRequest.cs                | 2 ++
 osu.Game/Online/API/Requests/GetUserScoresRequest.cs          | 2 ++
 osu.Game/Online/API/Requests/GetUsersRequest.cs               | 2 ++
 osu.Game/Online/API/Requests/GetUsersResponse.cs              | 2 ++
 osu.Game/Online/API/Requests/GetWikiRequest.cs                | 2 ++
 osu.Game/Online/API/Requests/JoinChannelRequest.cs            | 2 ++
 osu.Game/Online/API/Requests/LeaveChannelRequest.cs           | 2 ++
 osu.Game/Online/API/Requests/ListChannelsRequest.cs           | 2 ++
 osu.Game/Online/API/Requests/MarkChannelAsReadRequest.cs      | 2 ++
 osu.Game/Online/API/Requests/PaginatedAPIRequest.cs           | 2 ++
 osu.Game/Online/API/Requests/PaginationParameters.cs          | 2 ++
 osu.Game/Online/API/Requests/PostBeatmapFavouriteRequest.cs   | 2 ++
 osu.Game/Online/API/Requests/PostMessageRequest.cs            | 2 ++
 osu.Game/Online/API/Requests/ResponseWithCursor.cs            | 2 ++
 osu.Game/Online/API/Requests/Responses/APIBeatmap.cs          | 2 --
 osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs       | 2 --
 osu.Game/Online/API/Requests/Responses/APIChangelogBuild.cs   | 2 ++
 osu.Game/Online/API/Requests/Responses/APIChangelogEntry.cs   | 2 ++
 osu.Game/Online/API/Requests/Responses/APIChangelogIndex.cs   | 2 ++
 osu.Game/Online/API/Requests/Responses/APIChangelogUser.cs    | 2 ++
 osu.Game/Online/API/Requests/Responses/APIChatChannel.cs      | 2 ++
 osu.Game/Online/API/Requests/Responses/APIKudosuHistory.cs    | 2 ++
 osu.Game/Online/API/Requests/Responses/APINewsPost.cs         | 2 ++
 osu.Game/Online/API/Requests/Responses/APINewsSidebar.cs      | 2 ++
 osu.Game/Online/API/Requests/Responses/APIPlayStyle.cs        | 2 ++
 osu.Game/Online/API/Requests/Responses/APIRankHistory.cs      | 2 ++
 osu.Game/Online/API/Requests/Responses/APIRecentActivity.cs   | 2 ++
 osu.Game/Online/API/Requests/Responses/APIScore.cs            | 2 ++
 .../Online/API/Requests/Responses/APIScoreWithPosition.cs     | 2 ++
 osu.Game/Online/API/Requests/Responses/APIScoresCollection.cs | 2 ++
 .../Online/API/Requests/Responses/APISeasonalBackgrounds.cs   | 2 ++
 osu.Game/Online/API/Requests/Responses/APISpotlight.cs        | 2 ++
 osu.Game/Online/API/Requests/Responses/APIUpdateStream.cs     | 2 ++
 osu.Game/Online/API/Requests/Responses/APIUser.cs             | 2 ++
 osu.Game/Online/API/Requests/Responses/APIUserAchievement.cs  | 2 ++
 osu.Game/Online/API/Requests/Responses/APIUserContainer.cs    | 2 ++
 osu.Game/Online/API/Requests/Responses/APIUserHistoryCount.cs | 2 ++
 .../Online/API/Requests/Responses/APIUserMostPlayedBeatmap.cs | 2 ++
 .../Online/API/Requests/Responses/APIUserScoreAggregate.cs    | 2 ++
 osu.Game/Online/API/Requests/Responses/APIWikiPage.cs         | 2 ++
 osu.Game/Online/API/Requests/Responses/Comment.cs             | 2 ++
 osu.Game/Online/API/Requests/Responses/CommentBundle.cs       | 2 ++
 osu.Game/Online/API/Requests/SearchBeatmapSetsRequest.cs      | 2 ++
 osu.Game/Online/API/Requests/SearchBeatmapSetsResponse.cs     | 2 ++
 osu.Game/Online/BeatmapDownloadTracker.cs                     | 2 --
 osu.Game/Online/Chat/Channel.cs                               | 2 ++
 osu.Game/Online/Chat/ChannelManager.cs                        | 2 ++
 osu.Game/Online/Chat/ChannelType.cs                           | 2 ++
 osu.Game/Online/Chat/DrawableLinkCompiler.cs                  | 2 ++
 osu.Game/Online/Chat/ErrorMessage.cs                          | 2 ++
 osu.Game/Online/Chat/ExternalLinkOpener.cs                    | 2 ++
 osu.Game/Online/Chat/IChannelPostTarget.cs                    | 2 ++
 osu.Game/Online/Chat/InfoMessage.cs                           | 2 ++
 osu.Game/Online/Chat/LocalEchoMessage.cs                      | 2 ++
 osu.Game/Online/Chat/LocalMessage.cs                          | 2 ++
 osu.Game/Online/Chat/Message.cs                               | 2 ++
 osu.Game/Online/Chat/MessageFormatter.cs                      | 2 --
 osu.Game/Online/Chat/MessageNotifier.cs                       | 2 ++
 osu.Game/Online/Chat/NowPlayingCommand.cs                     | 2 ++
 osu.Game/Online/Chat/StandAloneChatDisplay.cs                 | 2 ++
 osu.Game/Online/DevelopmentEndpointConfiguration.cs           | 2 ++
 osu.Game/Online/DownloadState.cs                              | 2 ++
 osu.Game/Online/DownloadTracker.cs                            | 2 --
 osu.Game/Online/EndpointConfiguration.cs                      | 2 ++
 osu.Game/Online/HubClientConnector.cs                         | 2 --
 osu.Game/Online/IHubClientConnector.cs                        | 2 --
 osu.Game/Online/Leaderboards/DrawableRank.cs                  | 2 ++
 osu.Game/Online/Leaderboards/Leaderboard.cs                   | 2 ++
 osu.Game/Online/Leaderboards/LeaderboardScore.cs              | 2 ++
 osu.Game/Online/Leaderboards/LeaderboardScoreTooltip.cs       | 2 --
 osu.Game/Online/Leaderboards/LeaderboardState.cs              | 2 ++
 osu.Game/Online/Leaderboards/UpdateableRank.cs                | 2 ++
 osu.Game/Online/Leaderboards/UserTopScoreContainer.cs         | 2 ++
 .../Online/Multiplayer/Countdown/CountdownChangedEvent.cs     | 2 --
 .../Multiplayer/Countdown/StartMatchCountdownRequest.cs       | 2 --
 osu.Game/Online/Multiplayer/Countdown/StopCountdownRequest.cs | 2 --
 osu.Game/Online/Multiplayer/ForceGameplayStartCountdown.cs    | 2 ++
 osu.Game/Online/Multiplayer/IMultiplayerClient.cs             | 2 ++
 osu.Game/Online/Multiplayer/IMultiplayerLoungeServer.cs       | 2 ++
 osu.Game/Online/Multiplayer/IMultiplayerRoomServer.cs         | 2 ++
 osu.Game/Online/Multiplayer/IMultiplayerServer.cs             | 2 ++
 osu.Game/Online/Multiplayer/InvalidPasswordException.cs       | 2 ++
 osu.Game/Online/Multiplayer/InvalidStateChangeException.cs    | 2 ++
 osu.Game/Online/Multiplayer/InvalidStateException.cs          | 2 ++
 osu.Game/Online/Multiplayer/MatchRoomState.cs                 | 2 --
 osu.Game/Online/Multiplayer/MatchServerEvent.cs               | 2 --
 osu.Game/Online/Multiplayer/MatchStartCountdown.cs            | 2 --
 .../Multiplayer/MatchTypes/TeamVersus/ChangeTeamRequest.cs    | 2 --
 .../Multiplayer/MatchTypes/TeamVersus/MultiplayerTeam.cs      | 2 --
 .../Multiplayer/MatchTypes/TeamVersus/TeamVersusRoomState.cs  | 2 --
 .../Multiplayer/MatchTypes/TeamVersus/TeamVersusUserState.cs  | 2 --
 osu.Game/Online/Multiplayer/MatchUserRequest.cs               | 2 ++
 osu.Game/Online/Multiplayer/MatchUserState.cs                 | 2 --
 osu.Game/Online/Multiplayer/MultiplayerClient.cs              | 2 --
 osu.Game/Online/Multiplayer/MultiplayerClientExtensions.cs    | 2 --
 osu.Game/Online/Multiplayer/MultiplayerCountdown.cs           | 2 --
 osu.Game/Online/Multiplayer/MultiplayerRoom.cs                | 2 --
 osu.Game/Online/Multiplayer/MultiplayerRoomSettings.cs        | 2 --
 osu.Game/Online/Multiplayer/MultiplayerRoomState.cs           | 2 --
 osu.Game/Online/Multiplayer/MultiplayerRoomUser.cs            | 2 --
 osu.Game/Online/Multiplayer/MultiplayerUserState.cs           | 2 ++
 osu.Game/Online/Multiplayer/NotHostException.cs               | 2 ++
 osu.Game/Online/Multiplayer/NotJoinedRoomException.cs         | 2 ++
 osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs        | 2 --
 osu.Game/Online/Multiplayer/QueueMode.cs                      | 2 ++
 osu.Game/Online/OnlineViewContainer.cs                        | 2 ++
 osu.Game/Online/Placeholders/ClickablePlaceholder.cs          | 2 ++
 osu.Game/Online/Placeholders/LoginPlaceholder.cs              | 2 ++
 osu.Game/Online/Placeholders/MessagePlaceholder.cs            | 2 ++
 osu.Game/Online/Placeholders/Placeholder.cs                   | 2 ++
 osu.Game/Online/PollingComponent.cs                           | 2 ++
 osu.Game/Online/ProductionEndpointConfiguration.cs            | 2 ++
 osu.Game/Online/Rooms/APICreatedRoom.cs                       | 2 ++
 osu.Game/Online/Rooms/APILeaderboard.cs                       | 2 ++
 osu.Game/Online/Rooms/APIScoreToken.cs                        | 2 ++
 osu.Game/Online/Rooms/BeatmapAvailability.cs                  | 2 ++
 osu.Game/Online/Rooms/CreateRoomRequest.cs                    | 2 ++
 osu.Game/Online/Rooms/CreateRoomScoreRequest.cs               | 2 ++
 osu.Game/Online/Rooms/GetRoomLeaderboardRequest.cs            | 2 ++
 osu.Game/Online/Rooms/GetRoomRequest.cs                       | 2 ++
 osu.Game/Online/Rooms/GetRoomsRequest.cs                      | 2 ++
 osu.Game/Online/Rooms/IndexPlaylistScoresRequest.cs           | 2 ++
 osu.Game/Online/Rooms/IndexScoresParams.cs                    | 2 ++
 osu.Game/Online/Rooms/IndexedMultiplayerScores.cs             | 2 ++
 osu.Game/Online/Rooms/ItemAttemptsCount.cs                    | 2 ++
 osu.Game/Online/Rooms/JoinRoomRequest.cs                      | 2 ++
 osu.Game/Online/Rooms/MatchType.cs                            | 2 ++
 osu.Game/Online/Rooms/MultiplayerPlaylistItem.cs              | 2 --
 osu.Game/Online/Rooms/MultiplayerScore.cs                     | 2 ++
 osu.Game/Online/Rooms/MultiplayerScores.cs                    | 2 ++
 osu.Game/Online/Rooms/MultiplayerScoresAround.cs              | 2 ++
 osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs | 2 ++
 osu.Game/Online/Rooms/PartRoomRequest.cs                      | 2 ++
 osu.Game/Online/Rooms/PlaylistAggregateScore.cs               | 2 ++
 osu.Game/Online/Rooms/PlaylistExtensions.cs                   | 2 --
 osu.Game/Online/Rooms/PlaylistItem.cs                         | 2 --
 osu.Game/Online/Rooms/Room.cs                                 | 2 ++
 osu.Game/Online/Rooms/RoomAvailability.cs                     | 2 ++
 osu.Game/Online/Rooms/RoomCategory.cs                         | 2 ++
 osu.Game/Online/Rooms/RoomStatus.cs                           | 2 ++
 osu.Game/Online/Rooms/RoomStatuses/RoomStatusEnded.cs         | 2 ++
 osu.Game/Online/Rooms/RoomStatuses/RoomStatusOpen.cs          | 2 ++
 osu.Game/Online/Rooms/RoomStatuses/RoomStatusPlaying.cs       | 2 ++
 osu.Game/Online/Rooms/ShowPlaylistUserScoreRequest.cs         | 2 ++
 osu.Game/Online/Rooms/SubmitRoomScoreRequest.cs               | 2 ++
 osu.Game/Online/Rooms/SubmitScoreRequest.cs                   | 2 ++
 osu.Game/Online/ScoreDownloadTracker.cs                       | 2 --
 osu.Game/Online/SignalRDerivedTypeWorkaroundJsonConverter.cs  | 1 -
 osu.Game/Online/SignalRUnionWorkaroundResolver.cs             | 2 ++
 osu.Game/Online/SignalRWorkaroundTypes.cs                     | 2 ++
 osu.Game/Online/Solo/CreateSoloScoreRequest.cs                | 2 ++
 osu.Game/Online/Solo/SubmitSoloScoreRequest.cs                | 2 ++
 osu.Game/Online/Solo/SubmittableScore.cs                      | 2 ++
 osu.Game/Online/Spectator/FrameDataBundle.cs                  | 2 --
 osu.Game/Online/Spectator/FrameHeader.cs                      | 2 --
 osu.Game/Online/Spectator/ISpectatorClient.cs                 | 2 ++
 osu.Game/Online/Spectator/ISpectatorServer.cs                 | 2 ++
 osu.Game/Online/Spectator/OnlineSpectatorClient.cs            | 2 --
 osu.Game/Online/Spectator/SpectatedUserState.cs               | 2 ++
 osu.Game/Online/Spectator/SpectatorClient.cs                  | 2 --
 osu.Game/Online/Spectator/SpectatorScoreProcessor.cs          | 2 --
 osu.Game/Online/Spectator/SpectatorState.cs                   | 2 ++
 osu.Game/OsuGame.cs                                           | 2 ++
 osu.Game/OsuGameBase.cs                                       | 2 ++
 osu.Game/OsuGameBase_Importing.cs                             | 2 ++
 .../Overlays/AccountCreation/AccountCreationBackground.cs     | 2 ++
 osu.Game/Overlays/AccountCreation/AccountCreationScreen.cs    | 2 ++
 osu.Game/Overlays/AccountCreation/ScreenEntry.cs              | 2 ++
 osu.Game/Overlays/AccountCreation/ScreenWarning.cs            | 2 ++
 osu.Game/Overlays/AccountCreation/ScreenWelcome.cs            | 2 ++
 osu.Game/Overlays/AccountCreationOverlay.cs                   | 2 ++
 .../BeatmapListing/BeatmapListingCardSizeTabControl.cs        | 2 ++
 .../Overlays/BeatmapListing/BeatmapListingFilterControl.cs    | 2 ++
 osu.Game/Overlays/BeatmapListing/BeatmapListingHeader.cs      | 2 ++
 .../Overlays/BeatmapListing/BeatmapListingSearchControl.cs    | 2 ++
 .../Overlays/BeatmapListing/BeatmapListingSortTabControl.cs   | 2 ++
 osu.Game/Overlays/BeatmapListing/BeatmapSearchFilterRow.cs    | 2 ++
 .../Overlays/BeatmapListing/BeatmapSearchGeneralFilterRow.cs  | 2 ++
 .../BeatmapListing/BeatmapSearchMultipleSelectionFilterRow.cs | 2 ++
 .../Overlays/BeatmapListing/BeatmapSearchRulesetFilterRow.cs  | 2 ++
 .../Overlays/BeatmapListing/BeatmapSearchScoreFilterRow.cs    | 2 ++
 osu.Game/Overlays/BeatmapListing/FilterTabItem.cs             | 2 ++
 osu.Game/Overlays/BeatmapListing/SearchCategory.cs            | 2 ++
 osu.Game/Overlays/BeatmapListing/SearchExplicit.cs            | 2 ++
 osu.Game/Overlays/BeatmapListing/SearchExtra.cs               | 2 ++
 osu.Game/Overlays/BeatmapListing/SearchGeneral.cs             | 2 ++
 osu.Game/Overlays/BeatmapListing/SearchGenre.cs               | 2 ++
 osu.Game/Overlays/BeatmapListing/SearchLanguage.cs            | 2 ++
 osu.Game/Overlays/BeatmapListing/SearchPlayed.cs              | 2 ++
 osu.Game/Overlays/BeatmapListing/SortCriteria.cs              | 2 ++
 osu.Game/Overlays/BeatmapListingOverlay.cs                    | 2 ++
 osu.Game/Overlays/BeatmapSet/AuthorInfo.cs                    | 2 ++
 osu.Game/Overlays/BeatmapSet/BasicStats.cs                    | 2 ++
 osu.Game/Overlays/BeatmapSet/BeatmapAvailability.cs           | 2 ++
 osu.Game/Overlays/BeatmapSet/BeatmapBadge.cs                  | 2 --
 osu.Game/Overlays/BeatmapSet/BeatmapPicker.cs                 | 2 ++
 osu.Game/Overlays/BeatmapSet/BeatmapRulesetSelector.cs        | 2 ++
 osu.Game/Overlays/BeatmapSet/BeatmapRulesetTabItem.cs         | 2 ++
 osu.Game/Overlays/BeatmapSet/BeatmapSetHeader.cs              | 2 ++
 osu.Game/Overlays/BeatmapSet/BeatmapSetHeaderContent.cs       | 2 ++
 osu.Game/Overlays/BeatmapSet/BeatmapSetLayoutSection.cs       | 2 ++
 osu.Game/Overlays/BeatmapSet/Buttons/FavouriteButton.cs       | 2 ++
 osu.Game/Overlays/BeatmapSet/Buttons/HeaderButton.cs          | 2 ++
 osu.Game/Overlays/BeatmapSet/Buttons/HeaderDownloadButton.cs  | 2 ++
 osu.Game/Overlays/BeatmapSet/Buttons/PlayButton.cs            | 2 ++
 osu.Game/Overlays/BeatmapSet/Buttons/PreviewButton.cs         | 2 ++
 osu.Game/Overlays/BeatmapSet/Details.cs                       | 2 ++
 osu.Game/Overlays/BeatmapSet/ExplicitContentBeatmapBadge.cs   | 2 --
 osu.Game/Overlays/BeatmapSet/FeaturedArtistBeatmapBadge.cs    | 2 --
 osu.Game/Overlays/BeatmapSet/Info.cs                          | 2 ++
 osu.Game/Overlays/BeatmapSet/LeaderboardModSelector.cs        | 2 ++
 osu.Game/Overlays/BeatmapSet/LeaderboardScopeSelector.cs      | 2 ++
 osu.Game/Overlays/BeatmapSet/MetadataSection.cs               | 2 ++
 osu.Game/Overlays/BeatmapSet/MetadataType.cs                  | 2 ++
 osu.Game/Overlays/BeatmapSet/Scores/DrawableTopScore.cs       | 2 ++
 osu.Game/Overlays/BeatmapSet/Scores/NoScoresPlaceholder.cs    | 2 ++
 .../Overlays/BeatmapSet/Scores/NotSupporterPlaceholder.cs     | 2 ++
 osu.Game/Overlays/BeatmapSet/Scores/ScoreTable.cs             | 2 ++
 .../Overlays/BeatmapSet/Scores/ScoreTableRowBackground.cs     | 2 ++
 osu.Game/Overlays/BeatmapSet/Scores/ScoreboardTime.cs         | 2 ++
 osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.cs        | 2 ++
 .../Overlays/BeatmapSet/Scores/TopScoreStatisticsSection.cs   | 2 ++
 osu.Game/Overlays/BeatmapSet/Scores/TopScoreUserSection.cs    | 2 ++
 osu.Game/Overlays/BeatmapSet/SpotlightBeatmapBadge.cs         | 2 --
 osu.Game/Overlays/BeatmapSet/SuccessRate.cs                   | 2 ++
 osu.Game/Overlays/BeatmapSetOverlay.cs                        | 2 ++
 osu.Game/Overlays/BreadcrumbControlOverlayHeader.cs           | 2 ++
 osu.Game/Overlays/Changelog/ChangelogBuild.cs                 | 2 ++
 osu.Game/Overlays/Changelog/ChangelogContent.cs               | 2 ++
 osu.Game/Overlays/Changelog/ChangelogEntry.cs                 | 2 ++
 osu.Game/Overlays/Changelog/ChangelogHeader.cs                | 2 ++
 osu.Game/Overlays/Changelog/ChangelogListing.cs               | 2 ++
 osu.Game/Overlays/Changelog/ChangelogSingleBuild.cs           | 2 ++
 osu.Game/Overlays/Changelog/ChangelogSupporterPromo.cs        | 2 ++
 osu.Game/Overlays/Changelog/ChangelogUpdateStreamControl.cs   | 2 ++
 osu.Game/Overlays/Changelog/ChangelogUpdateStreamItem.cs      | 2 ++
 osu.Game/Overlays/ChangelogOverlay.cs                         | 2 ++
 osu.Game/Overlays/Chat/ChannelList/ChannelList.cs             | 2 --
 osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs         | 2 --
 .../Overlays/Chat/ChannelList/ChannelListItemCloseButton.cs   | 2 --
 .../Overlays/Chat/ChannelList/ChannelListItemMentionPill.cs   | 2 --
 osu.Game/Overlays/Chat/ChannelScrollContainer.cs              | 2 ++
 osu.Game/Overlays/Chat/ChatLine.cs                            | 2 --
 osu.Game/Overlays/Chat/ChatOverlayTopBar.cs                   | 2 --
 osu.Game/Overlays/Chat/ChatTextBar.cs                         | 2 --
 osu.Game/Overlays/Chat/ChatTextBox.cs                         | 2 --
 osu.Game/Overlays/Chat/DaySeparator.cs                        | 2 --
 osu.Game/Overlays/Chat/DrawableChannel.cs                     | 2 ++
 osu.Game/Overlays/Chat/ExternalLinkDialog.cs                  | 2 ++
 osu.Game/Overlays/Chat/Listing/ChannelListing.cs              | 2 --
 osu.Game/Overlays/Chat/Listing/ChannelListingItem.cs          | 2 --
 osu.Game/Overlays/ChatOverlay.cs                              | 2 --
 osu.Game/Overlays/Comments/Buttons/ChevronButton.cs           | 2 ++
 osu.Game/Overlays/Comments/Buttons/CommentRepliesButton.cs    | 2 ++
 osu.Game/Overlays/Comments/Buttons/LoadRepliesButton.cs       | 2 ++
 osu.Game/Overlays/Comments/Buttons/ShowMoreRepliesButton.cs   | 2 ++
 osu.Game/Overlays/Comments/Buttons/ShowRepliesButton.cs       | 2 ++
 osu.Game/Overlays/Comments/CancellableCommentEditor.cs        | 2 ++
 osu.Game/Overlays/Comments/CommentEditor.cs                   | 2 ++
 osu.Game/Overlays/Comments/CommentMarkdownContainer.cs        | 2 ++
 osu.Game/Overlays/Comments/CommentsContainer.cs               | 2 ++
 osu.Game/Overlays/Comments/CommentsHeader.cs                  | 2 ++
 osu.Game/Overlays/Comments/CommentsShowMoreButton.cs          | 2 ++
 osu.Game/Overlays/Comments/DeletedCommentsCounter.cs          | 2 ++
 osu.Game/Overlays/Comments/DrawableComment.cs                 | 2 ++
 osu.Game/Overlays/Comments/HeaderButton.cs                    | 2 ++
 osu.Game/Overlays/Comments/TotalCommentsCounter.cs            | 2 ++
 osu.Game/Overlays/Comments/VotePill.cs                        | 2 ++
 osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs        | 2 ++
 osu.Game/Overlays/Dashboard/DashboardOverlayHeader.cs         | 2 ++
 osu.Game/Overlays/Dashboard/Friends/FriendDisplay.cs          | 2 ++
 .../Overlays/Dashboard/Friends/FriendOnlineStreamControl.cs   | 2 ++
 osu.Game/Overlays/Dashboard/Friends/FriendStream.cs           | 2 ++
 .../Overlays/Dashboard/Friends/FriendsOnlineStatusItem.cs     | 2 ++
 osu.Game/Overlays/Dashboard/Friends/OnlineStatus.cs           | 2 ++
 osu.Game/Overlays/Dashboard/Friends/UserListToolbar.cs        | 2 ++
 osu.Game/Overlays/Dashboard/Friends/UserSortTabControl.cs     | 2 ++
 osu.Game/Overlays/Dashboard/Home/DashboardBeatmapListing.cs   | 2 ++
 osu.Game/Overlays/Dashboard/Home/DashboardBeatmapPanel.cs     | 2 ++
 osu.Game/Overlays/Dashboard/Home/DashboardNewBeatmapPanel.cs  | 2 ++
 .../Overlays/Dashboard/Home/DashboardPopularBeatmapPanel.cs   | 2 ++
 osu.Game/Overlays/Dashboard/Home/DrawableBeatmapList.cs       | 2 ++
 osu.Game/Overlays/Dashboard/Home/DrawableNewBeatmapList.cs    | 2 ++
 .../Overlays/Dashboard/Home/DrawablePopularBeatmapList.cs     | 2 ++
 osu.Game/Overlays/Dashboard/Home/HomePanel.cs                 | 2 ++
 .../Overlays/Dashboard/Home/News/FeaturedNewsItemPanel.cs     | 2 ++
 osu.Game/Overlays/Dashboard/Home/News/NewsGroupItem.cs        | 2 ++
 osu.Game/Overlays/Dashboard/Home/News/NewsItemGroupPanel.cs   | 2 ++
 osu.Game/Overlays/Dashboard/Home/News/NewsTitleLink.cs        | 2 ++
 osu.Game/Overlays/Dashboard/Home/News/ShowMoreNewsPanel.cs    | 2 ++
 osu.Game/Overlays/DashboardOverlay.cs                         | 2 ++
 osu.Game/Overlays/Dialog/ConfirmDialog.cs                     | 2 ++
 osu.Game/Overlays/Dialog/PopupDialog.cs                       | 2 ++
 osu.Game/Overlays/Dialog/PopupDialogButton.cs                 | 2 ++
 osu.Game/Overlays/Dialog/PopupDialogCancelButton.cs           | 2 ++
 osu.Game/Overlays/Dialog/PopupDialogDangerousButton.cs        | 2 ++
 osu.Game/Overlays/Dialog/PopupDialogOkButton.cs               | 2 ++
 osu.Game/Overlays/DialogOverlay.cs                            | 2 ++
 osu.Game/Overlays/FirstRunSetup/FirstRunSetupScreen.cs        | 2 ++
 osu.Game/Overlays/FirstRunSetup/ProgressRoundedButton.cs      | 1 -
 osu.Game/Overlays/FirstRunSetup/ScreenBeatmaps.cs             | 2 --
 osu.Game/Overlays/FirstRunSetup/ScreenBehaviour.cs            | 2 ++
 osu.Game/Overlays/FirstRunSetup/ScreenImportFromStable.cs     | 2 --
 osu.Game/Overlays/FirstRunSetup/ScreenUIScale.cs              | 2 ++
 osu.Game/Overlays/FirstRunSetup/ScreenWelcome.cs              | 2 ++
 osu.Game/Overlays/FirstRunSetupOverlay.cs                     | 2 --
 osu.Game/Overlays/FullscreenOverlay.cs                        | 2 ++
 osu.Game/Overlays/HoldToConfirmOverlay.cs                     | 2 ++
 osu.Game/Overlays/IDialogOverlay.cs                           | 2 --
 osu.Game/Overlays/INamedOverlayComponent.cs                   | 2 ++
 osu.Game/Overlays/INotificationOverlay.cs                     | 2 ++
 osu.Game/Overlays/IOverlayManager.cs                          | 2 ++
 osu.Game/Overlays/Login/LoginForm.cs                          | 2 ++
 osu.Game/Overlays/Login/LoginPanel.cs                         | 2 ++
 osu.Game/Overlays/Login/UserAction.cs                         | 4 +++-
 osu.Game/Overlays/Login/UserDropdown.cs                       | 2 ++
 osu.Game/Overlays/LoginOverlay.cs                             | 2 ++
 osu.Game/Overlays/MedalOverlay.cs                             | 2 ++
 osu.Game/Overlays/MedalSplash/DrawableMedal.cs                | 2 ++
 osu.Game/Overlays/Mods/DeselectAllModsButton.cs               | 2 ++
 osu.Game/Overlays/Mods/DifficultyMultiplierDisplay.cs         | 2 ++
 osu.Game/Overlays/Mods/IncompatibilityDisplayingModPanel.cs   | 2 ++
 osu.Game/Overlays/Mods/IncompatibilityDisplayingTooltip.cs    | 2 ++
 osu.Game/Overlays/Mods/ModButtonTooltip.cs                    | 2 ++
 osu.Game/Overlays/Mods/ModColumn.cs                           | 2 --
 osu.Game/Overlays/Mods/ModPanel.cs                            | 2 --
 osu.Game/Overlays/Mods/ModSelectOverlay.cs                    | 2 --
 osu.Game/Overlays/Mods/ModSettingsArea.cs                     | 2 ++
 osu.Game/Overlays/Mods/ModState.cs                            | 2 ++
 osu.Game/Overlays/Mods/SelectAllModsButton.cs                 | 2 ++
 osu.Game/Overlays/Mods/ShearedOverlayContainer.cs             | 2 ++
 osu.Game/Overlays/Mods/UserModSelectOverlay.cs                | 2 ++
 osu.Game/Overlays/Music/CollectionDropdown.cs                 | 2 ++
 osu.Game/Overlays/Music/FilterControl.cs                      | 2 ++
 osu.Game/Overlays/Music/FilterCriteria.cs                     | 2 ++
 osu.Game/Overlays/Music/MusicKeyBindingHandler.cs             | 2 ++
 osu.Game/Overlays/Music/Playlist.cs                           | 2 ++
 osu.Game/Overlays/Music/PlaylistItem.cs                       | 2 ++
 osu.Game/Overlays/Music/PlaylistOverlay.cs                    | 2 ++
 osu.Game/Overlays/MusicController.cs                          | 2 ++
 osu.Game/Overlays/News/Displays/ArticleListing.cs             | 2 ++
 osu.Game/Overlays/News/NewsCard.cs                            | 2 ++
 osu.Game/Overlays/News/NewsHeader.cs                          | 2 ++
 osu.Game/Overlays/News/NewsPostBackground.cs                  | 2 ++
 osu.Game/Overlays/News/Sidebar/MonthSection.cs                | 2 ++
 osu.Game/Overlays/News/Sidebar/NewsSidebar.cs                 | 2 ++
 osu.Game/Overlays/News/Sidebar/YearsPanel.cs                  | 2 ++
 osu.Game/Overlays/NewsOverlay.cs                              | 2 ++
 osu.Game/Overlays/NotificationOverlay.cs                      | 2 --
 osu.Game/Overlays/Notifications/IHasCompletionTarget.cs       | 2 ++
 osu.Game/Overlays/Notifications/Notification.cs               | 2 ++
 osu.Game/Overlays/Notifications/NotificationSection.cs        | 2 ++
 .../Overlays/Notifications/ProgressCompletionNotification.cs  | 2 ++
 osu.Game/Overlays/Notifications/ProgressNotification.cs       | 2 ++
 osu.Game/Overlays/Notifications/SimpleErrorNotification.cs    | 2 ++
 osu.Game/Overlays/Notifications/SimpleNotification.cs         | 2 ++
 osu.Game/Overlays/NowPlayingOverlay.cs                        | 2 ++
 osu.Game/Overlays/OSD/Toast.cs                                | 2 ++
 osu.Game/Overlays/OSD/TrackedSettingToast.cs                  | 2 ++
 osu.Game/Overlays/OnScreenDisplay.cs                          | 2 ++
 osu.Game/Overlays/OnlineOverlay.cs                            | 2 ++
 osu.Game/Overlays/OverlayActivation.cs                        | 2 ++
 osu.Game/Overlays/OverlayColourProvider.cs                    | 2 ++
 osu.Game/Overlays/OverlayHeader.cs                            | 2 ++
 osu.Game/Overlays/OverlayHeaderBackground.cs                  | 2 ++
 osu.Game/Overlays/OverlayPanelDisplayStyleControl.cs          | 2 ++
 osu.Game/Overlays/OverlayRulesetSelector.cs                   | 2 ++
 osu.Game/Overlays/OverlayRulesetTabItem.cs                    | 2 ++
 osu.Game/Overlays/OverlayScrollContainer.cs                   | 2 ++
 osu.Game/Overlays/OverlaySidebar.cs                           | 2 ++
 osu.Game/Overlays/OverlaySortTabControl.cs                    | 2 ++
 osu.Game/Overlays/OverlayStreamControl.cs                     | 2 ++
 osu.Game/Overlays/OverlayStreamItem.cs                        | 2 ++
 osu.Game/Overlays/OverlayTabControl.cs                        | 2 ++
 osu.Game/Overlays/OverlayTitle.cs                             | 2 ++
 osu.Game/Overlays/OverlayView.cs                              | 2 ++
 osu.Game/Overlays/Profile/Header/BottomHeaderContainer.cs     | 2 ++
 osu.Game/Overlays/Profile/Header/CentreHeaderContainer.cs     | 2 ++
 osu.Game/Overlays/Profile/Header/Components/DrawableBadge.cs  | 2 ++
 .../Overlays/Profile/Header/Components/ExpandDetailsButton.cs | 2 ++
 .../Overlays/Profile/Header/Components/FollowersButton.cs     | 2 ++
 osu.Game/Overlays/Profile/Header/Components/LevelBadge.cs     | 2 ++
 .../Overlays/Profile/Header/Components/LevelProgressBar.cs    | 2 ++
 .../Profile/Header/Components/MappingSubscribersButton.cs     | 2 ++
 .../Overlays/Profile/Header/Components/MessageUserButton.cs   | 2 ++
 .../Profile/Header/Components/OverlinedInfoContainer.cs       | 2 ++
 .../Profile/Header/Components/OverlinedTotalPlayTime.cs       | 2 ++
 .../Overlays/Profile/Header/Components/PreviousUsernames.cs   | 2 ++
 .../Overlays/Profile/Header/Components/ProfileHeaderButton.cs | 2 ++
 .../Header/Components/ProfileHeaderStatisticsButton.cs        | 2 ++
 .../Profile/Header/Components/ProfileRulesetSelector.cs       | 2 ++
 .../Profile/Header/Components/ProfileRulesetTabItem.cs        | 2 ++
 osu.Game/Overlays/Profile/Header/Components/RankGraph.cs      | 2 ++
 osu.Game/Overlays/Profile/Header/Components/SupporterIcon.cs  | 2 ++
 osu.Game/Overlays/Profile/Header/DetailHeaderContainer.cs     | 2 ++
 osu.Game/Overlays/Profile/Header/MedalHeaderContainer.cs      | 2 ++
 osu.Game/Overlays/Profile/Header/TopHeaderContainer.cs        | 2 ++
 osu.Game/Overlays/Profile/ProfileHeader.cs                    | 2 ++
 osu.Game/Overlays/Profile/ProfileSection.cs                   | 2 ++
 osu.Game/Overlays/Profile/Sections/AboutSection.cs            | 2 ++
 .../Overlays/Profile/Sections/BeatmapMetadataContainer.cs     | 2 ++
 .../Profile/Sections/Beatmaps/PaginatedBeatmapContainer.cs    | 2 ++
 osu.Game/Overlays/Profile/Sections/BeatmapsSection.cs         | 2 ++
 osu.Game/Overlays/Profile/Sections/CounterPill.cs             | 2 ++
 .../Profile/Sections/Historical/ChartProfileSubsection.cs     | 2 ++
 .../Profile/Sections/Historical/DrawableMostPlayedBeatmap.cs  | 2 ++
 .../Historical/PaginatedMostPlayedBeatmapContainer.cs         | 2 ++
 .../Profile/Sections/Historical/PlayHistorySubsection.cs      | 2 ++
 .../Overlays/Profile/Sections/Historical/ProfileLineChart.cs  | 2 ++
 .../Overlays/Profile/Sections/Historical/ReplaysSubsection.cs | 2 ++
 .../Overlays/Profile/Sections/Historical/UserHistoryGraph.cs  | 2 ++
 osu.Game/Overlays/Profile/Sections/HistoricalSection.cs       | 2 ++
 .../Profile/Sections/Kudosu/DrawableKudosuHistoryItem.cs      | 2 ++
 osu.Game/Overlays/Profile/Sections/Kudosu/KudosuInfo.cs       | 2 ++
 .../Sections/Kudosu/PaginatedKudosuHistoryContainer.cs        | 2 ++
 osu.Game/Overlays/Profile/Sections/KudosuSection.cs           | 2 ++
 osu.Game/Overlays/Profile/Sections/MedalsSection.cs           | 2 ++
 .../Overlays/Profile/Sections/PaginatedProfileSubsection.cs   | 2 ++
 osu.Game/Overlays/Profile/Sections/ProfileItemContainer.cs    | 2 ++
 osu.Game/Overlays/Profile/Sections/ProfileSubsection.cs       | 2 ++
 osu.Game/Overlays/Profile/Sections/ProfileSubsectionHeader.cs | 2 ++
 .../Overlays/Profile/Sections/Ranks/DrawableProfileScore.cs   | 2 ++
 .../Profile/Sections/Ranks/DrawableProfileWeightedScore.cs    | 2 ++
 .../Profile/Sections/Ranks/PaginatedScoreContainer.cs         | 2 ++
 osu.Game/Overlays/Profile/Sections/RanksSection.cs            | 2 ++
 .../Profile/Sections/Recent/DrawableRecentActivity.cs         | 2 ++
 osu.Game/Overlays/Profile/Sections/Recent/MedalIcon.cs        | 2 ++
 .../Sections/Recent/PaginatedRecentActivityContainer.cs       | 2 ++
 osu.Game/Overlays/Profile/Sections/RecentSection.cs           | 2 ++
 osu.Game/Overlays/Profile/UserGraph.cs                        | 2 ++
 osu.Game/Overlays/Rankings/CountryFilter.cs                   | 2 ++
 osu.Game/Overlays/Rankings/CountryPill.cs                     | 2 ++
 osu.Game/Overlays/Rankings/RankingsOverlayHeader.cs           | 2 ++
 osu.Game/Overlays/Rankings/RankingsScope.cs                   | 2 ++
 osu.Game/Overlays/Rankings/RankingsSortTabControl.cs          | 2 ++
 osu.Game/Overlays/Rankings/SpotlightSelector.cs               | 2 ++
 osu.Game/Overlays/Rankings/SpotlightsLayout.cs                | 2 ++
 osu.Game/Overlays/Rankings/Tables/CountriesTable.cs           | 2 ++
 osu.Game/Overlays/Rankings/Tables/PerformanceTable.cs         | 2 ++
 osu.Game/Overlays/Rankings/Tables/RankingsTable.cs            | 2 ++
 osu.Game/Overlays/Rankings/Tables/ScoresTable.cs              | 2 ++
 osu.Game/Overlays/Rankings/Tables/TableRowBackground.cs       | 2 ++
 osu.Game/Overlays/Rankings/Tables/UserBasedTable.cs           | 2 ++
 osu.Game/Overlays/RankingsOverlay.cs                          | 2 ++
 osu.Game/Overlays/RestoreDefaultValueButton.cs                | 2 ++
 osu.Game/Overlays/Settings/DangerousSettingsButton.cs         | 2 ++
 osu.Game/Overlays/Settings/ISettingsItem.cs                   | 2 ++
 osu.Game/Overlays/Settings/OutlinedTextBox.cs                 | 2 ++
 osu.Game/Overlays/Settings/RulesetSettingsSubsection.cs       | 2 ++
 .../Overlays/Settings/Sections/Audio/AudioDevicesSettings.cs  | 2 ++
 osu.Game/Overlays/Settings/Sections/Audio/OffsetSettings.cs   | 2 ++
 osu.Game/Overlays/Settings/Sections/Audio/VolumeSettings.cs   | 2 ++
 osu.Game/Overlays/Settings/Sections/AudioSection.cs           | 2 ++
 osu.Game/Overlays/Settings/Sections/DebugSection.cs           | 2 ++
 .../Settings/Sections/DebugSettings/GeneralSettings.cs        | 2 ++
 .../Settings/Sections/DebugSettings/MemorySettings.cs         | 2 ++
 osu.Game/Overlays/Settings/Sections/Gameplay/AudioSettings.cs | 2 ++
 .../Overlays/Settings/Sections/Gameplay/BackgroundSettings.cs | 2 ++
 .../Overlays/Settings/Sections/Gameplay/BeatmapSettings.cs    | 2 ++
 .../Overlays/Settings/Sections/Gameplay/GeneralSettings.cs    | 2 ++
 osu.Game/Overlays/Settings/Sections/Gameplay/HUDSettings.cs   | 2 ++
 osu.Game/Overlays/Settings/Sections/Gameplay/InputSettings.cs | 2 ++
 osu.Game/Overlays/Settings/Sections/Gameplay/ModsSettings.cs  | 2 ++
 osu.Game/Overlays/Settings/Sections/GameplaySection.cs        | 2 ++
 .../Overlays/Settings/Sections/General/LanguageSettings.cs    | 2 ++
 osu.Game/Overlays/Settings/Sections/General/UpdateSettings.cs | 2 ++
 osu.Game/Overlays/Settings/Sections/GeneralSection.cs         | 2 ++
 .../Overlays/Settings/Sections/Graphics/LayoutSettings.cs     | 2 ++
 .../Overlays/Settings/Sections/Graphics/RendererSettings.cs   | 2 ++
 .../Overlays/Settings/Sections/Graphics/ScreenshotSettings.cs | 2 ++
 osu.Game/Overlays/Settings/Sections/Graphics/VideoSettings.cs | 2 ++
 osu.Game/Overlays/Settings/Sections/GraphicsSection.cs        | 2 ++
 osu.Game/Overlays/Settings/Sections/Input/BindingSettings.cs  | 2 ++
 .../Settings/Sections/Input/GlobalKeyBindingsSection.cs       | 2 ++
 osu.Game/Overlays/Settings/Sections/Input/JoystickSettings.cs | 2 ++
 osu.Game/Overlays/Settings/Sections/Input/KeyBindingPanel.cs  | 2 ++
 osu.Game/Overlays/Settings/Sections/Input/KeyBindingRow.cs    | 2 ++
 .../Overlays/Settings/Sections/Input/KeyBindingsSubsection.cs | 2 ++
 osu.Game/Overlays/Settings/Sections/Input/MouseSettings.cs    | 2 ++
 .../Overlays/Settings/Sections/Input/RotationPresetButtons.cs | 2 ++
 .../Settings/Sections/Input/RulesetBindingsSection.cs         | 2 ++
 .../Overlays/Settings/Sections/Input/TabletAreaSelection.cs   | 2 ++
 osu.Game/Overlays/Settings/Sections/Input/TabletSettings.cs   | 2 ++
 .../Settings/Sections/Input/VariantBindingsSubsection.cs      | 2 ++
 osu.Game/Overlays/Settings/Sections/InputSection.cs           | 2 ++
 .../Settings/Sections/Maintenance/DirectorySelectScreen.cs    | 2 ++
 .../Overlays/Settings/Sections/Maintenance/GeneralSettings.cs | 2 ++
 .../Sections/Maintenance/MassDeleteConfirmationDialog.cs      | 2 ++
 .../Sections/Maintenance/MassVideoDeleteConfirmationDialog.cs | 2 ++
 .../Settings/Sections/Maintenance/MigrationRunScreen.cs       | 2 ++
 .../Settings/Sections/Maintenance/MigrationSelectScreen.cs    | 2 ++
 .../Sections/Maintenance/StableDirectoryLocationDialog.cs     | 2 ++
 .../Sections/Maintenance/StableDirectorySelectScreen.cs       | 2 ++
 osu.Game/Overlays/Settings/Sections/MaintenanceSection.cs     | 2 ++
 .../Settings/Sections/Online/AlertsAndPrivacySettings.cs      | 2 ++
 .../Overlays/Settings/Sections/Online/IntegrationSettings.cs  | 2 ++
 osu.Game/Overlays/Settings/Sections/Online/WebSettings.cs     | 2 ++
 osu.Game/Overlays/Settings/Sections/OnlineSection.cs          | 2 ++
 osu.Game/Overlays/Settings/Sections/RulesetSection.cs         | 2 ++
 osu.Game/Overlays/Settings/Sections/SizeSlider.cs             | 2 ++
 osu.Game/Overlays/Settings/Sections/SkinSection.cs            | 2 ++
 .../Settings/Sections/UserInterface/GeneralSettings.cs        | 2 ++
 .../Settings/Sections/UserInterface/MainMenuSettings.cs       | 2 ++
 .../Settings/Sections/UserInterface/SongSelectSettings.cs     | 2 ++
 osu.Game/Overlays/Settings/Sections/UserInterfaceSection.cs   | 2 ++
 osu.Game/Overlays/Settings/SettingsButton.cs                  | 2 ++
 osu.Game/Overlays/Settings/SettingsCheckbox.cs                | 2 ++
 osu.Game/Overlays/Settings/SettingsDropdown.cs                | 2 ++
 osu.Game/Overlays/Settings/SettingsEnumDropdown.cs            | 2 ++
 osu.Game/Overlays/Settings/SettingsFooter.cs                  | 2 ++
 osu.Game/Overlays/Settings/SettingsHeader.cs                  | 2 ++
 osu.Game/Overlays/Settings/SettingsItem.cs                    | 2 ++
 osu.Game/Overlays/Settings/SettingsNumberBox.cs               | 2 ++
 osu.Game/Overlays/Settings/SettingsSection.cs                 | 2 ++
 osu.Game/Overlays/Settings/SettingsSidebar.cs                 | 2 ++
 osu.Game/Overlays/Settings/SettingsSlider.cs                  | 2 ++
 osu.Game/Overlays/Settings/SettingsSubsection.cs              | 2 ++
 osu.Game/Overlays/Settings/SettingsTextBox.cs                 | 2 ++
 osu.Game/Overlays/Settings/SidebarButton.cs                   | 2 ++
 osu.Game/Overlays/Settings/SidebarIconButton.cs               | 2 ++
 osu.Game/Overlays/SettingsOverlay.cs                          | 2 ++
 osu.Game/Overlays/SettingsPanel.cs                            | 2 ++
 osu.Game/Overlays/SettingsSubPanel.cs                         | 2 ++
 osu.Game/Overlays/SettingsToolboxGroup.cs                     | 2 ++
 osu.Game/Overlays/SortDirection.cs                            | 2 ++
 osu.Game/Overlays/TabControlOverlayHeader.cs                  | 2 ++
 osu.Game/Overlays/TabbableOnlineOverlay.cs                    | 2 ++
 osu.Game/Overlays/Toolbar/AnalogClockDisplay.cs               | 2 ++
 osu.Game/Overlays/Toolbar/ClockDisplay.cs                     | 2 ++
 osu.Game/Overlays/Toolbar/DigitalClockDisplay.cs              | 2 ++
 osu.Game/Overlays/Toolbar/Toolbar.cs                          | 2 ++
 osu.Game/Overlays/Toolbar/ToolbarBeatmapListingButton.cs      | 2 ++
 osu.Game/Overlays/Toolbar/ToolbarButton.cs                    | 2 ++
 osu.Game/Overlays/Toolbar/ToolbarChangelogButton.cs           | 2 ++
 osu.Game/Overlays/Toolbar/ToolbarChatButton.cs                | 2 ++
 osu.Game/Overlays/Toolbar/ToolbarClock.cs                     | 2 ++
 osu.Game/Overlays/Toolbar/ToolbarHomeButton.cs                | 2 ++
 osu.Game/Overlays/Toolbar/ToolbarMusicButton.cs               | 2 ++
 osu.Game/Overlays/Toolbar/ToolbarNewsButton.cs                | 2 ++
 osu.Game/Overlays/Toolbar/ToolbarNotificationButton.cs        | 2 ++
 osu.Game/Overlays/Toolbar/ToolbarOverlayToggleButton.cs       | 2 ++
 osu.Game/Overlays/Toolbar/ToolbarRankingsButton.cs            | 2 ++
 osu.Game/Overlays/Toolbar/ToolbarRulesetSelector.cs           | 2 ++
 osu.Game/Overlays/Toolbar/ToolbarRulesetTabButton.cs          | 2 ++
 osu.Game/Overlays/Toolbar/ToolbarSettingsButton.cs            | 2 ++
 osu.Game/Overlays/Toolbar/ToolbarSocialButton.cs              | 2 ++
 osu.Game/Overlays/Toolbar/ToolbarUserButton.cs                | 2 ++
 osu.Game/Overlays/Toolbar/ToolbarWikiButton.cs                | 2 ++
 osu.Game/Overlays/UserProfileOverlay.cs                       | 2 ++
 osu.Game/Overlays/VersionManager.cs                           | 2 ++
 osu.Game/Overlays/Volume/MuteButton.cs                        | 2 ++
 osu.Game/Overlays/Volume/VolumeControlReceptor.cs             | 2 ++
 osu.Game/Overlays/Volume/VolumeMeter.cs                       | 2 ++
 osu.Game/Overlays/VolumeOverlay.cs                            | 2 ++
 osu.Game/Overlays/WaveOverlayContainer.cs                     | 2 ++
 osu.Game/Overlays/Wiki/Markdown/WikiMarkdownContainer.cs      | 2 ++
 osu.Game/Overlays/Wiki/Markdown/WikiMarkdownImage.cs          | 2 ++
 osu.Game/Overlays/Wiki/Markdown/WikiMarkdownImageBlock.cs     | 2 ++
 osu.Game/Overlays/Wiki/Markdown/WikiNoticeContainer.cs        | 2 ++
 osu.Game/Overlays/Wiki/WikiArticlePage.cs                     | 2 ++
 osu.Game/Overlays/Wiki/WikiHeader.cs                          | 2 ++
 osu.Game/Overlays/Wiki/WikiMainPage.cs                        | 2 ++
 osu.Game/Overlays/Wiki/WikiPanelContainer.cs                  | 2 ++
 osu.Game/Overlays/Wiki/WikiSidebar.cs                         | 2 ++
 osu.Game/Overlays/Wiki/WikiTableOfContents.cs                 | 2 ++
 osu.Game/Overlays/WikiOverlay.cs                              | 2 ++
 osu.Game/PerformFromMenuRunner.cs                             | 2 ++
 osu.Game/Performance/HighPerformanceSession.cs                | 2 ++
 osu.Game/Properties/AssemblyInfo.cs                           | 2 ++
 osu.Game/Replays/Legacy/LegacyReplayFrame.cs                  | 2 ++
 osu.Game/Replays/Legacy/ReplayButtonState.cs                  | 2 ++
 osu.Game/Replays/Replay.cs                                    | 2 ++
 osu.Game/Rulesets/AssemblyRulesetStore.cs                     | 2 --
 osu.Game/Rulesets/Configuration/IRulesetConfigManager.cs      | 2 ++
 osu.Game/Rulesets/Configuration/RulesetConfigManager.cs       | 2 ++
 osu.Game/Rulesets/Difficulty/DifficultyAttributes.cs          | 2 ++
 osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs          | 2 ++
 osu.Game/Rulesets/Difficulty/PerformanceAttributes.cs         | 2 ++
 osu.Game/Rulesets/Difficulty/PerformanceBreakdown.cs          | 2 ++
 .../Rulesets/Difficulty/PerformanceBreakdownCalculator.cs     | 2 ++
 osu.Game/Rulesets/Difficulty/PerformanceCalculator.cs         | 2 ++
 osu.Game/Rulesets/Difficulty/PerformanceDisplayAttribute.cs   | 2 ++
 .../Rulesets/Difficulty/Preprocessing/DifficultyHitObject.cs  | 2 ++
 osu.Game/Rulesets/Difficulty/Skills/Skill.cs                  | 2 ++
 osu.Game/Rulesets/Difficulty/Skills/StrainDecaySkill.cs       | 2 ++
 osu.Game/Rulesets/Difficulty/Skills/StrainSkill.cs            | 2 ++
 osu.Game/Rulesets/Difficulty/TimedDifficultyAttributes.cs     | 2 ++
 osu.Game/Rulesets/Difficulty/Utils/LimitedCapacityQueue.cs    | 2 ++
 osu.Game/Rulesets/Difficulty/Utils/ReverseQueue.cs            | 2 ++
 osu.Game/Rulesets/EFRulesetInfo.cs                            | 2 ++
 osu.Game/Rulesets/Edit/BeatmapVerifier.cs                     | 2 ++
 osu.Game/Rulesets/Edit/BeatmapVerifierContext.cs              | 2 --
 osu.Game/Rulesets/Edit/Checks/CheckAudioInVideo.cs            | 2 ++
 osu.Game/Rulesets/Edit/Checks/CheckAudioPresence.cs           | 2 ++
 osu.Game/Rulesets/Edit/Checks/CheckAudioQuality.cs            | 2 ++
 osu.Game/Rulesets/Edit/Checks/CheckBackgroundPresence.cs      | 2 ++
 osu.Game/Rulesets/Edit/Checks/CheckBackgroundQuality.cs       | 2 ++
 osu.Game/Rulesets/Edit/Checks/CheckConcurrentObjects.cs       | 2 ++
 osu.Game/Rulesets/Edit/Checks/CheckFewHitsounds.cs            | 2 ++
 osu.Game/Rulesets/Edit/Checks/CheckFilePresence.cs            | 2 ++
 osu.Game/Rulesets/Edit/Checks/CheckMutedObjects.cs            | 2 ++
 osu.Game/Rulesets/Edit/Checks/CheckTooShortAudioFiles.cs      | 2 ++
 osu.Game/Rulesets/Edit/Checks/CheckUnsnappedObjects.cs        | 2 ++
 osu.Game/Rulesets/Edit/Checks/CheckZeroByteFiles.cs           | 2 ++
 osu.Game/Rulesets/Edit/Checks/CheckZeroLengthObjects.cs       | 2 ++
 osu.Game/Rulesets/Edit/Checks/Components/CheckCategory.cs     | 2 ++
 osu.Game/Rulesets/Edit/Checks/Components/CheckMetadata.cs     | 2 ++
 osu.Game/Rulesets/Edit/Checks/Components/ICheck.cs            | 2 ++
 osu.Game/Rulesets/Edit/Checks/Components/Issue.cs             | 2 ++
 osu.Game/Rulesets/Edit/Checks/Components/IssueTemplate.cs     | 2 ++
 osu.Game/Rulesets/Edit/Checks/Components/IssueType.cs         | 2 ++
 osu.Game/Rulesets/Edit/DistancedHitObjectComposer.cs          | 2 ++
 osu.Game/Rulesets/Edit/DrawableEditorRulesetWrapper.cs        | 2 ++
 osu.Game/Rulesets/Edit/EditorToolboxGroup.cs                  | 2 ++
 osu.Game/Rulesets/Edit/ExpandingToolboxContainer.cs           | 2 ++
 osu.Game/Rulesets/Edit/HitObjectComposer.cs                   | 2 ++
 osu.Game/Rulesets/Edit/HitObjectSelectionBlueprint.cs         | 2 ++
 osu.Game/Rulesets/Edit/IBeatSnapProvider.cs                   | 2 ++
 osu.Game/Rulesets/Edit/IBeatmapVerifier.cs                    | 2 ++
 osu.Game/Rulesets/Edit/IDistanceSnapProvider.cs               | 2 ++
 osu.Game/Rulesets/Edit/IPositionSnapProvider.cs               | 2 ++
 osu.Game/Rulesets/Edit/PlacementBlueprint.cs                  | 2 ++
 osu.Game/Rulesets/Edit/SelectionBlueprint.cs                  | 2 ++
 osu.Game/Rulesets/Edit/SnapResult.cs                          | 2 ++
 osu.Game/Rulesets/Edit/SnapType.cs                            | 2 ++
 osu.Game/Rulesets/Edit/Tools/HitObjectCompositionTool.cs      | 2 ++
 osu.Game/Rulesets/Edit/Tools/SelectTool.cs                    | 2 ++
 osu.Game/Rulesets/Filter/IRulesetFilterCriteria.cs            | 2 ++
 osu.Game/Rulesets/ILegacyRuleset.cs                           | 2 ++
 osu.Game/Rulesets/IRulesetConfigCache.cs                      | 2 --
 osu.Game/Rulesets/IRulesetInfo.cs                             | 2 --
 osu.Game/Rulesets/IRulesetStore.cs                            | 2 --
 osu.Game/Rulesets/Judgements/DefaultJudgementPiece.cs         | 2 ++
 osu.Game/Rulesets/Judgements/DrawableJudgement.cs             | 2 ++
 osu.Game/Rulesets/Judgements/IAnimatableJudgement.cs          | 2 ++
 osu.Game/Rulesets/Judgements/IgnoreJudgement.cs               | 2 ++
 osu.Game/Rulesets/Judgements/Judgement.cs                     | 2 ++
 osu.Game/Rulesets/Judgements/JudgementResult.cs               | 2 ++
 osu.Game/Rulesets/Mods/DifficultyAdjustSettingsControl.cs     | 2 ++
 osu.Game/Rulesets/Mods/DifficultyBindable.cs                  | 2 ++
 osu.Game/Rulesets/Mods/IApplicableAfterBeatmapConversion.cs   | 2 ++
 osu.Game/Rulesets/Mods/IApplicableFailOverride.cs             | 2 ++
 osu.Game/Rulesets/Mods/IApplicableMod.cs                      | 2 ++
 osu.Game/Rulesets/Mods/IApplicableToAudio.cs                  | 2 ++
 osu.Game/Rulesets/Mods/IApplicableToBeatmap.cs                | 2 ++
 osu.Game/Rulesets/Mods/IApplicableToBeatmapConverter.cs       | 2 ++
 osu.Game/Rulesets/Mods/IApplicableToBeatmapProcessor.cs       | 2 ++
 osu.Game/Rulesets/Mods/IApplicableToDifficulty.cs             | 2 ++
 osu.Game/Rulesets/Mods/IApplicableToDrawableHitObject.cs      | 2 ++
 osu.Game/Rulesets/Mods/IApplicableToDrawableHitObjects.cs     | 2 ++
 osu.Game/Rulesets/Mods/IApplicableToDrawableRuleset.cs        | 2 ++
 osu.Game/Rulesets/Mods/IApplicableToHUD.cs                    | 2 ++
 osu.Game/Rulesets/Mods/IApplicableToHealthProcessor.cs        | 2 ++
 osu.Game/Rulesets/Mods/IApplicableToHitObject.cs              | 2 ++
 osu.Game/Rulesets/Mods/IApplicableToPlayer.cs                 | 2 ++
 osu.Game/Rulesets/Mods/IApplicableToRate.cs                   | 2 ++
 osu.Game/Rulesets/Mods/IApplicableToSample.cs                 | 2 ++
 osu.Game/Rulesets/Mods/IApplicableToScoreProcessor.cs         | 2 ++
 osu.Game/Rulesets/Mods/IApplicableToTrack.cs                  | 2 ++
 osu.Game/Rulesets/Mods/ICreateReplay.cs                       | 2 ++
 osu.Game/Rulesets/Mods/ICreateReplayData.cs                   | 2 ++
 osu.Game/Rulesets/Mods/IHasSeed.cs                            | 2 ++
 osu.Game/Rulesets/Mods/IMod.cs                                | 2 ++
 osu.Game/Rulesets/Mods/IReadFromConfig.cs                     | 2 ++
 osu.Game/Rulesets/Mods/IUpdatableByPlayfield.cs               | 2 ++
 osu.Game/Rulesets/Mods/MetronomeBeat.cs                       | 2 ++
 osu.Game/Rulesets/Mods/Mod.cs                                 | 2 ++
 osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs                    | 2 ++
 osu.Game/Rulesets/Mods/ModAutoplay.cs                         | 2 ++
 osu.Game/Rulesets/Mods/ModBarrelRoll.cs                       | 2 ++
 osu.Game/Rulesets/Mods/ModBlockFail.cs                        | 2 ++
 osu.Game/Rulesets/Mods/ModCinema.cs                           | 2 ++
 osu.Game/Rulesets/Mods/ModClassic.cs                          | 2 ++
 osu.Game/Rulesets/Mods/ModDaycore.cs                          | 2 ++
 osu.Game/Rulesets/Mods/ModDifficultyAdjust.cs                 | 2 ++
 osu.Game/Rulesets/Mods/ModDoubleTime.cs                       | 2 ++
 osu.Game/Rulesets/Mods/ModEasy.cs                             | 2 ++
 osu.Game/Rulesets/Mods/ModEasyWithExtraLives.cs               | 2 ++
 osu.Game/Rulesets/Mods/ModExtensions.cs                       | 2 ++
 osu.Game/Rulesets/Mods/ModFailCondition.cs                    | 2 ++
 osu.Game/Rulesets/Mods/ModFlashlight.cs                       | 2 ++
 osu.Game/Rulesets/Mods/ModHalfTime.cs                         | 2 ++
 osu.Game/Rulesets/Mods/ModHardRock.cs                         | 2 ++
 osu.Game/Rulesets/Mods/ModHidden.cs                           | 2 ++
 osu.Game/Rulesets/Mods/ModMirror.cs                           | 2 ++
 osu.Game/Rulesets/Mods/ModMuted.cs                            | 2 ++
 osu.Game/Rulesets/Mods/ModNightcore.cs                        | 2 ++
 osu.Game/Rulesets/Mods/ModNoFail.cs                           | 2 ++
 osu.Game/Rulesets/Mods/ModNoMod.cs                            | 2 ++
 osu.Game/Rulesets/Mods/ModNoScope.cs                          | 2 ++
 osu.Game/Rulesets/Mods/ModPerfect.cs                          | 2 ++
 osu.Game/Rulesets/Mods/ModRandom.cs                           | 2 ++
 osu.Game/Rulesets/Mods/ModRateAdjust.cs                       | 2 ++
 osu.Game/Rulesets/Mods/ModRelax.cs                            | 2 ++
 osu.Game/Rulesets/Mods/ModSuddenDeath.cs                      | 2 ++
 osu.Game/Rulesets/Mods/ModTimeRamp.cs                         | 2 ++
 osu.Game/Rulesets/Mods/ModType.cs                             | 2 ++
 osu.Game/Rulesets/Mods/ModWindDown.cs                         | 2 ++
 osu.Game/Rulesets/Mods/ModWindUp.cs                           | 2 ++
 osu.Game/Rulesets/Mods/ModWithVisibilityAdjustment.cs         | 2 ++
 osu.Game/Rulesets/Mods/MultiMod.cs                            | 2 ++
 osu.Game/Rulesets/Mods/UnknownMod.cs                          | 2 ++
 osu.Game/Rulesets/Objects/BarLineGenerator.cs                 | 2 ++
 osu.Game/Rulesets/Objects/Drawables/ArmedState.cs             | 2 ++
 osu.Game/Rulesets/Objects/Drawables/DrawableHitObject.cs      | 2 ++
 osu.Game/Rulesets/Objects/HitObject.cs                        | 2 ++
 osu.Game/Rulesets/Objects/HitObjectLifetimeEntry.cs           | 2 ++
 osu.Game/Rulesets/Objects/HitObjectParser.cs                  | 2 ++
 osu.Game/Rulesets/Objects/IBarLine.cs                         | 2 ++
 osu.Game/Rulesets/Objects/Legacy/Catch/ConvertHit.cs          | 2 ++
 .../Rulesets/Objects/Legacy/Catch/ConvertHitObjectParser.cs   | 2 ++
 osu.Game/Rulesets/Objects/Legacy/Catch/ConvertSlider.cs       | 2 ++
 osu.Game/Rulesets/Objects/Legacy/Catch/ConvertSpinner.cs      | 2 ++
 osu.Game/Rulesets/Objects/Legacy/ConvertHitObject.cs          | 2 ++
 osu.Game/Rulesets/Objects/Legacy/ConvertSlider.cs             | 2 ++
 osu.Game/Rulesets/Objects/Legacy/Mania/ConvertHit.cs          | 2 ++
 .../Rulesets/Objects/Legacy/Mania/ConvertHitObjectParser.cs   | 2 ++
 osu.Game/Rulesets/Objects/Legacy/Mania/ConvertHold.cs         | 2 ++
 osu.Game/Rulesets/Objects/Legacy/Mania/ConvertSlider.cs       | 2 ++
 osu.Game/Rulesets/Objects/Legacy/Mania/ConvertSpinner.cs      | 2 ++
 osu.Game/Rulesets/Objects/Legacy/Osu/ConvertHit.cs            | 2 ++
 .../Rulesets/Objects/Legacy/Osu/ConvertHitObjectParser.cs     | 2 ++
 osu.Game/Rulesets/Objects/Legacy/Osu/ConvertSlider.cs         | 2 ++
 osu.Game/Rulesets/Objects/Legacy/Osu/ConvertSpinner.cs        | 2 ++
 osu.Game/Rulesets/Objects/Legacy/Taiko/ConvertHit.cs          | 2 ++
 .../Rulesets/Objects/Legacy/Taiko/ConvertHitObjectParser.cs   | 2 ++
 osu.Game/Rulesets/Objects/Legacy/Taiko/ConvertSlider.cs       | 2 ++
 osu.Game/Rulesets/Objects/Legacy/Taiko/ConvertSpinner.cs      | 2 ++
 osu.Game/Rulesets/Objects/PathControlPoint.cs                 | 2 ++
 .../Rulesets/Objects/Pooling/PoolableDrawableWithLifetime.cs  | 2 --
 .../Objects/Pooling/PooledDrawableWithLifetimeContainer.cs    | 2 --
 osu.Game/Rulesets/Objects/SliderEventGenerator.cs             | 2 ++
 osu.Game/Rulesets/Objects/SliderPath.cs                       | 2 ++
 osu.Game/Rulesets/Objects/SliderPathExtensions.cs             | 2 --
 osu.Game/Rulesets/Objects/SyntheticHitObjectEntry.cs          | 2 ++
 osu.Game/Rulesets/Objects/Types/IHasColumn.cs                 | 2 ++
 osu.Game/Rulesets/Objects/Types/IHasCombo.cs                  | 2 ++
 osu.Game/Rulesets/Objects/Types/IHasComboInformation.cs       | 2 ++
 osu.Game/Rulesets/Objects/Types/IHasDisplayColour.cs          | 2 ++
 osu.Game/Rulesets/Objects/Types/IHasDistance.cs               | 2 ++
 osu.Game/Rulesets/Objects/Types/IHasDuration.cs               | 2 ++
 osu.Game/Rulesets/Objects/Types/IHasHold.cs                   | 2 ++
 osu.Game/Rulesets/Objects/Types/IHasLegacyLastTickOffset.cs   | 2 ++
 osu.Game/Rulesets/Objects/Types/IHasPath.cs                   | 2 ++
 osu.Game/Rulesets/Objects/Types/IHasPathWithRepeats.cs        | 2 ++
 osu.Game/Rulesets/Objects/Types/IHasPosition.cs               | 2 ++
 osu.Game/Rulesets/Objects/Types/IHasRepeats.cs                | 2 ++
 osu.Game/Rulesets/Objects/Types/IHasXPosition.cs              | 2 ++
 osu.Game/Rulesets/Objects/Types/IHasYPosition.cs              | 2 ++
 osu.Game/Rulesets/Objects/Types/PathType.cs                   | 2 ++
 osu.Game/Rulesets/RealmRulesetStore.cs                        | 2 --
 osu.Game/Rulesets/Replays/AutoGenerator.cs                    | 2 ++
 osu.Game/Rulesets/Replays/FramedReplayInputHandler.cs         | 2 --
 osu.Game/Rulesets/Replays/ReplayFrame.cs                      | 2 --
 osu.Game/Rulesets/Replays/Types/IConvertibleReplayFrame.cs    | 2 ++
 osu.Game/Rulesets/Ruleset.cs                                  | 2 ++
 osu.Game/Rulesets/RulesetConfigCache.cs                       | 2 ++
 osu.Game/Rulesets/RulesetInfo.cs                              | 2 --
 osu.Game/Rulesets/RulesetLoadException.cs                     | 2 ++
 osu.Game/Rulesets/RulesetSelector.cs                          | 2 ++
 osu.Game/Rulesets/RulesetStore.cs                             | 2 --
 osu.Game/Rulesets/Scoring/AccumulatingHealthProcessor.cs      | 2 ++
 osu.Game/Rulesets/Scoring/DrainingHealthProcessor.cs          | 2 ++
 osu.Game/Rulesets/Scoring/HealthProcessor.cs                  | 2 --
 osu.Game/Rulesets/Scoring/HitEvent.cs                         | 2 ++
 osu.Game/Rulesets/Scoring/HitEventExtensions.cs               | 2 ++
 osu.Game/Rulesets/Scoring/HitResult.cs                        | 2 ++
 osu.Game/Rulesets/Scoring/HitWindows.cs                       | 2 ++
 osu.Game/Rulesets/Scoring/JudgementProcessor.cs               | 2 --
 osu.Game/Rulesets/Scoring/ScoreProcessor.cs                   | 2 --
 osu.Game/Rulesets/Timing/MultiplierControlPoint.cs            | 2 ++
 osu.Game/Rulesets/UI/DrawableRuleset.cs                       | 2 ++
 osu.Game/Rulesets/UI/DrawableRulesetDependencies.cs           | 2 ++
 osu.Game/Rulesets/UI/FrameStabilityContainer.cs               | 2 ++
 osu.Game/Rulesets/UI/GameplayCursorContainer.cs               | 2 ++
 osu.Game/Rulesets/UI/GameplaySampleTriggerSource.cs           | 2 ++
 osu.Game/Rulesets/UI/HitObjectContainer.cs                    | 2 ++
 osu.Game/Rulesets/UI/IFrameStableClock.cs                     | 2 ++
 osu.Game/Rulesets/UI/IHitObjectContainer.cs                   | 2 ++
 osu.Game/Rulesets/UI/IPooledHitObjectProvider.cs              | 2 ++
 osu.Game/Rulesets/UI/JudgementContainer.cs                    | 2 ++
 osu.Game/Rulesets/UI/ModIcon.cs                               | 2 ++
 osu.Game/Rulesets/UI/ModSwitchSmall.cs                        | 2 --
 osu.Game/Rulesets/UI/ModSwitchTiny.cs                         | 2 --
 osu.Game/Rulesets/UI/Playfield.cs                             | 2 ++
 osu.Game/Rulesets/UI/PlayfieldAdjustmentContainer.cs          | 2 ++
 osu.Game/Rulesets/UI/PlayfieldBorder.cs                       | 2 ++
 osu.Game/Rulesets/UI/PlayfieldBorderStyle.cs                  | 2 ++
 osu.Game/Rulesets/UI/ReplayRecorder.cs                        | 2 ++
 osu.Game/Rulesets/UI/RulesetInputManager.cs                   | 2 ++
 .../UI/Scrolling/Algorithms/ConstantScrollAlgorithm.cs        | 2 ++
 osu.Game/Rulesets/UI/Scrolling/Algorithms/IScrollAlgorithm.cs | 2 ++
 .../UI/Scrolling/Algorithms/OverlappingScrollAlgorithm.cs     | 2 ++
 .../UI/Scrolling/Algorithms/SequentialScrollAlgorithm.cs      | 2 ++
 osu.Game/Rulesets/UI/Scrolling/DrawableScrollingRuleset.cs    | 2 ++
 osu.Game/Rulesets/UI/Scrolling/IScrollingInfo.cs              | 2 ++
 osu.Game/Rulesets/UI/Scrolling/ScrollingDirection.cs          | 2 ++
 osu.Game/Rulesets/UI/Scrolling/ScrollingHitObjectContainer.cs | 2 ++
 osu.Game/Rulesets/UI/Scrolling/ScrollingPlayfield.cs          | 2 ++
 osu.Game/Scoring/EFScoreInfo.cs                               | 2 ++
 osu.Game/Scoring/HitResultDisplayStatistic.cs                 | 2 ++
 osu.Game/Scoring/IScoreInfo.cs                                | 2 ++
 osu.Game/Scoring/Legacy/DatabasedLegacyScoreDecoder.cs        | 2 ++
 osu.Game/Scoring/Legacy/LegacyScoreDecoder.cs                 | 2 ++
 osu.Game/Scoring/Legacy/LegacyScoreEncoder.cs                 | 2 --
 osu.Game/Scoring/Legacy/ScoreInfoExtensions.cs                | 2 ++
 osu.Game/Scoring/LegacyDatabasedScore.cs                      | 2 ++
 osu.Game/Scoring/Score.cs                                     | 2 ++
 osu.Game/Scoring/ScoreFileInfo.cs                             | 2 ++
 osu.Game/Scoring/ScoreImporter.cs                             | 2 --
 osu.Game/Scoring/ScoreInfo.cs                                 | 2 --
 osu.Game/Scoring/ScoreInfoExtensions.cs                       | 2 ++
 osu.Game/Scoring/ScoreManager.cs                              | 2 ++
 osu.Game/Scoring/ScoreModelDownloader.cs                      | 2 ++
 osu.Game/Scoring/ScorePerformanceCache.cs                     | 2 ++
 osu.Game/Scoring/ScoreRank.cs                                 | 2 ++
 osu.Game/Scoring/ScoringValues.cs                             | 2 ++
 osu.Game/Screens/BackgroundScreen.cs                          | 2 ++
 osu.Game/Screens/BackgroundScreenStack.cs                     | 2 ++
 osu.Game/Screens/Backgrounds/BackgroundScreenBeatmap.cs       | 2 ++
 osu.Game/Screens/Backgrounds/BackgroundScreenBlack.cs         | 2 ++
 osu.Game/Screens/Backgrounds/BackgroundScreenCustom.cs        | 2 ++
 osu.Game/Screens/Backgrounds/BackgroundScreenDefault.cs       | 2 ++
 osu.Game/Screens/Edit/BindableBeatDivisor.cs                  | 2 ++
 osu.Game/Screens/Edit/BottomBar.cs                            | 2 ++
 osu.Game/Screens/Edit/ClipboardContent.cs                     | 2 ++
 osu.Game/Screens/Edit/Components/BottomBarContainer.cs        | 2 ++
 osu.Game/Screens/Edit/Components/CircularButton.cs            | 2 ++
 osu.Game/Screens/Edit/Components/EditorSidebar.cs             | 2 ++
 osu.Game/Screens/Edit/Components/EditorSidebarSection.cs      | 2 ++
 osu.Game/Screens/Edit/Components/Menus/DifficultyMenuItem.cs  | 2 ++
 osu.Game/Screens/Edit/Components/Menus/EditorMenuBar.cs       | 2 ++
 osu.Game/Screens/Edit/Components/Menus/EditorMenuItem.cs      | 2 ++
 .../Screens/Edit/Components/Menus/EditorMenuItemSpacer.cs     | 2 ++
 .../Edit/Components/Menus/EditorScreenSwitcherControl.cs      | 2 ++
 osu.Game/Screens/Edit/Components/PlaybackControl.cs           | 2 ++
 .../Screens/Edit/Components/RadioButtons/EditorRadioButton.cs | 2 ++
 .../Components/RadioButtons/EditorRadioButtonCollection.cs    | 2 ++
 osu.Game/Screens/Edit/Components/RadioButtons/RadioButton.cs  | 2 ++
 .../Edit/Components/TernaryButtons/DrawableTernaryButton.cs   | 2 ++
 .../Screens/Edit/Components/TernaryButtons/TernaryButton.cs   | 2 ++
 osu.Game/Screens/Edit/Components/TimeInfoContainer.cs         | 2 ++
 .../Edit/Components/Timelines/Summary/Parts/BookmarkPart.cs   | 2 ++
 .../Edit/Components/Timelines/Summary/Parts/BreakPart.cs      | 2 ++
 .../Components/Timelines/Summary/Parts/ControlPointPart.cs    | 2 ++
 .../Timelines/Summary/Parts/ControlPointVisualisation.cs      | 2 ++
 .../Timelines/Summary/Parts/EffectPointVisualisation.cs       | 2 ++
 .../Components/Timelines/Summary/Parts/GroupVisualisation.cs  | 2 ++
 .../Timelines/Summary/Parts/IControlPointVisualisation.cs     | 2 ++
 .../Edit/Components/Timelines/Summary/Parts/MarkerPart.cs     | 2 ++
 .../Edit/Components/Timelines/Summary/Parts/TimelinePart.cs   | 2 ++
 .../Edit/Components/Timelines/Summary/SummaryTimeline.cs      | 2 ++
 .../Edit/Components/Timelines/Summary/TestGameplayButton.cs   | 2 ++
 .../Timelines/Summary/Visualisations/DurationVisualisation.cs | 2 ++
 .../Timelines/Summary/Visualisations/PointVisualisation.cs    | 2 ++
 .../Screens/Edit/Compose/Components/BeatDivisorControl.cs     | 2 ++
 .../Edit/Compose/Components/BeatDivisorPresetCollection.cs    | 2 ++
 osu.Game/Screens/Edit/Compose/Components/BeatDivisorType.cs   | 2 ++
 .../Screens/Edit/Compose/Components/BlueprintContainer.cs     | 2 ++
 .../Edit/Compose/Components/CircularDistanceSnapGrid.cs       | 2 ++
 .../Edit/Compose/Components/ComposeBlueprintContainer.cs      | 2 ++
 osu.Game/Screens/Edit/Compose/Components/DistanceSnapGrid.cs  | 2 ++
 osu.Game/Screens/Edit/Compose/Components/DragBox.cs           | 2 ++
 .../Edit/Compose/Components/EditorBlueprintContainer.cs       | 2 ++
 .../Screens/Edit/Compose/Components/EditorSelectionHandler.cs | 2 ++
 .../Compose/Components/HitObjectOrderedSelectionContainer.cs  | 2 ++
 .../Screens/Edit/Compose/Components/MoveSelectionEvent.cs     | 2 ++
 .../Edit/Compose/Components/RectangularPositionSnapGrid.cs    | 2 ++
 osu.Game/Screens/Edit/Compose/Components/SelectionBox.cs      | 2 ++
 .../Screens/Edit/Compose/Components/SelectionBoxButton.cs     | 2 ++
 .../Screens/Edit/Compose/Components/SelectionBoxControl.cs    | 2 ++
 .../Screens/Edit/Compose/Components/SelectionBoxDragHandle.cs | 2 ++
 .../Compose/Components/SelectionBoxDragHandleContainer.cs     | 2 ++
 .../Edit/Compose/Components/SelectionBoxRotationHandle.cs     | 2 ++
 .../Edit/Compose/Components/SelectionBoxScaleHandle.cs        | 2 ++
 osu.Game/Screens/Edit/Compose/Components/SelectionHandler.cs  | 2 ++
 .../Screens/Edit/Compose/Components/Timeline/CentreMarker.cs  | 2 ++
 .../Edit/Compose/Components/Timeline/DifficultyPointPiece.cs  | 2 ++
 .../Edit/Compose/Components/Timeline/HitObjectPointPiece.cs   | 2 ++
 .../Edit/Compose/Components/Timeline/SamplePointPiece.cs      | 2 --
 osu.Game/Screens/Edit/Compose/Components/Timeline/Timeline.cs | 2 ++
 .../Screens/Edit/Compose/Components/Timeline/TimelineArea.cs  | 2 ++
 .../Compose/Components/Timeline/TimelineBlueprintContainer.cs | 2 ++
 .../Edit/Compose/Components/Timeline/TimelineButton.cs        | 2 ++
 .../Components/Timeline/TimelineControlPointDisplay.cs        | 2 ++
 .../Compose/Components/Timeline/TimelineControlPointGroup.cs  | 2 ++
 .../Edit/Compose/Components/Timeline/TimelineDragBox.cs       | 2 ++
 .../Compose/Components/Timeline/TimelineHitObjectBlueprint.cs | 2 ++
 .../Compose/Components/Timeline/TimelineSelectionHandler.cs   | 2 ++
 .../Edit/Compose/Components/Timeline/TimelineTickDisplay.cs   | 2 ++
 .../Edit/Compose/Components/Timeline/TimingPointPiece.cs      | 2 ++
 .../Screens/Edit/Compose/Components/Timeline/TopPointPiece.cs | 2 ++
 .../Compose/Components/Timeline/ZoomableScrollContainer.cs    | 2 ++
 osu.Game/Screens/Edit/Compose/ComposeScreen.cs                | 2 ++
 osu.Game/Screens/Edit/Compose/HitObjectUsageEventBuffer.cs    | 2 ++
 osu.Game/Screens/Edit/Compose/IPlacementHandler.cs            | 2 ++
 osu.Game/Screens/Edit/CreateNewDifficultyDialog.cs            | 2 ++
 osu.Game/Screens/Edit/Design/DesignScreen.cs                  | 2 ++
 osu.Game/Screens/Edit/Editor.cs                               | 2 ++
 osu.Game/Screens/Edit/EditorBeatmap.cs                        | 2 ++
 osu.Game/Screens/Edit/EditorBeatmapSkin.cs                    | 2 ++
 osu.Game/Screens/Edit/EditorChangeHandler.cs                  | 2 ++
 osu.Game/Screens/Edit/EditorClipboard.cs                      | 2 ++
 osu.Game/Screens/Edit/EditorClock.cs                          | 2 ++
 osu.Game/Screens/Edit/EditorLoader.cs                         | 2 ++
 osu.Game/Screens/Edit/EditorRoundedScreenSettings.cs          | 2 ++
 osu.Game/Screens/Edit/EditorRoundedScreenSettingsSection.cs   | 2 ++
 osu.Game/Screens/Edit/EditorScreen.cs                         | 2 ++
 osu.Game/Screens/Edit/EditorScreenMode.cs                     | 2 ++
 osu.Game/Screens/Edit/EditorScreenWithTimeline.cs             | 2 ++
 osu.Game/Screens/Edit/EditorSkinProvidingContainer.cs         | 2 --
 osu.Game/Screens/Edit/EditorState.cs                          | 2 --
 osu.Game/Screens/Edit/EditorTable.cs                          | 2 ++
 osu.Game/Screens/Edit/GameplayTest/EditorPlayer.cs            | 2 ++
 osu.Game/Screens/Edit/GameplayTest/EditorPlayerLoader.cs      | 2 ++
 .../Screens/Edit/GameplayTest/SaveBeforeGameplayTestDialog.cs | 2 ++
 osu.Game/Screens/Edit/HitAnimationsMenuItem.cs                | 2 ++
 osu.Game/Screens/Edit/IEditorChangeHandler.cs                 | 2 ++
 osu.Game/Screens/Edit/LegacyEditorBeatmapPatcher.cs           | 2 ++
 osu.Game/Screens/Edit/PromptForSaveDialog.cs                  | 2 ++
 osu.Game/Screens/Edit/Setup/ColoursSection.cs                 | 2 ++
 osu.Game/Screens/Edit/Setup/DesignSection.cs                  | 2 ++
 osu.Game/Screens/Edit/Setup/DifficultySection.cs              | 2 ++
 osu.Game/Screens/Edit/Setup/FileChooserLabelledTextBox.cs     | 2 --
 osu.Game/Screens/Edit/Setup/LabelledRomanisedTextBox.cs       | 2 ++
 osu.Game/Screens/Edit/Setup/LabelledTextBoxWithPopover.cs     | 2 ++
 osu.Game/Screens/Edit/Setup/MetadataSection.cs                | 2 ++
 osu.Game/Screens/Edit/Setup/ResourcesSection.cs               | 2 ++
 osu.Game/Screens/Edit/Setup/RulesetSetupSection.cs            | 2 ++
 osu.Game/Screens/Edit/Setup/SetupScreen.cs                    | 2 ++
 osu.Game/Screens/Edit/Setup/SetupScreenHeader.cs              | 2 ++
 osu.Game/Screens/Edit/Setup/SetupScreenHeaderBackground.cs    | 2 ++
 osu.Game/Screens/Edit/Setup/SetupSection.cs                   | 2 ++
 osu.Game/Screens/Edit/Timing/ControlPointSettings.cs          | 2 ++
 osu.Game/Screens/Edit/Timing/ControlPointTable.cs             | 2 ++
 osu.Game/Screens/Edit/Timing/EffectSection.cs                 | 2 ++
 osu.Game/Screens/Edit/Timing/GroupSection.cs                  | 2 ++
 .../Edit/Timing/IndeterminateSliderWithTextBoxInput.cs        | 2 ++
 osu.Game/Screens/Edit/Timing/LabelledTimeSignature.cs         | 2 ++
 osu.Game/Screens/Edit/Timing/MetronomeDisplay.cs              | 2 ++
 osu.Game/Screens/Edit/Timing/RepeatingButtonBehaviour.cs      | 2 ++
 osu.Game/Screens/Edit/Timing/RowAttribute.cs                  | 2 ++
 .../Screens/Edit/Timing/RowAttributes/AttributeProgressBar.cs | 2 ++
 osu.Game/Screens/Edit/Timing/RowAttributes/AttributeText.cs   | 2 ++
 .../Edit/Timing/RowAttributes/DifficultyRowAttribute.cs       | 2 ++
 .../Screens/Edit/Timing/RowAttributes/EffectRowAttribute.cs   | 2 ++
 .../Screens/Edit/Timing/RowAttributes/SampleRowAttribute.cs   | 2 ++
 .../Screens/Edit/Timing/RowAttributes/TimingRowAttribute.cs   | 2 ++
 osu.Game/Screens/Edit/Timing/Section.cs                       | 2 ++
 osu.Game/Screens/Edit/Timing/SliderWithTextBoxInput.cs        | 2 ++
 osu.Game/Screens/Edit/Timing/TapButton.cs                     | 2 --
 osu.Game/Screens/Edit/Timing/TapTimingControl.cs              | 2 --
 osu.Game/Screens/Edit/Timing/TimingAdjustButton.cs            | 2 ++
 osu.Game/Screens/Edit/Timing/TimingScreen.cs                  | 2 ++
 osu.Game/Screens/Edit/Timing/TimingSection.cs                 | 2 ++
 osu.Game/Screens/Edit/Timing/WaveformComparisonDisplay.cs     | 2 --
 osu.Game/Screens/Edit/TransactionalCommitComponent.cs         | 2 ++
 osu.Game/Screens/Edit/Verify/InterpretationSection.cs         | 2 ++
 osu.Game/Screens/Edit/Verify/IssueList.cs                     | 2 ++
 osu.Game/Screens/Edit/Verify/IssueSettings.cs                 | 2 ++
 osu.Game/Screens/Edit/Verify/IssueTable.cs                    | 2 ++
 osu.Game/Screens/Edit/Verify/VerifyScreen.cs                  | 2 ++
 osu.Game/Screens/Edit/Verify/VisibilitySection.cs             | 2 ++
 osu.Game/Screens/Edit/WaveformOpacityMenuItem.cs              | 2 ++
 osu.Game/Screens/IHandlePresentBeatmap.cs                     | 2 ++
 osu.Game/Screens/IHasSubScreenStack.cs                        | 2 ++
 osu.Game/Screens/IOsuScreen.cs                                | 2 ++
 osu.Game/Screens/IPerformFromScreenRunner.cs                  | 2 ++
 osu.Game/Screens/Import/FileImportScreen.cs                   | 2 ++
 osu.Game/Screens/Loader.cs                                    | 2 ++
 osu.Game/Screens/Menu/ButtonArea.cs                           | 2 ++
 osu.Game/Screens/Menu/ButtonSystem.cs                         | 2 ++
 osu.Game/Screens/Menu/ConfirmExitDialog.cs                    | 2 ++
 osu.Game/Screens/Menu/Disclaimer.cs                           | 2 ++
 osu.Game/Screens/Menu/ExitConfirmOverlay.cs                   | 2 ++
 osu.Game/Screens/Menu/FlowContainerWithOrigin.cs              | 2 ++
 osu.Game/Screens/Menu/IntroCircles.cs                         | 2 ++
 osu.Game/Screens/Menu/IntroScreen.cs                          | 2 ++
 osu.Game/Screens/Menu/IntroSequence.cs                        | 2 ++
 osu.Game/Screens/Menu/IntroTriangles.cs                       | 2 ++
 osu.Game/Screens/Menu/IntroWelcome.cs                         | 2 ++
 osu.Game/Screens/Menu/LogoVisualisation.cs                    | 2 ++
 osu.Game/Screens/Menu/MainMenu.cs                             | 2 ++
 osu.Game/Screens/Menu/MainMenuButton.cs                       | 2 ++
 osu.Game/Screens/Menu/MenuLogoVisualisation.cs                | 2 ++
 osu.Game/Screens/Menu/MenuSideFlashes.cs                      | 2 ++
 osu.Game/Screens/Menu/OsuLogo.cs                              | 2 ++
 osu.Game/Screens/Menu/SongTicker.cs                           | 2 ++
 osu.Game/Screens/Menu/StorageErrorDialog.cs                   | 2 ++
 .../OnlinePlay/Components/BeatmapDetailAreaPlaylistTabItem.cs | 2 ++
 osu.Game/Screens/OnlinePlay/Components/BeatmapTitle.cs        | 2 ++
 .../Screens/OnlinePlay/Components/DisableableTabControl.cs    | 2 ++
 osu.Game/Screens/OnlinePlay/Components/DrawableGameType.cs    | 2 ++
 .../Screens/OnlinePlay/Components/ListingPollingComponent.cs  | 2 ++
 .../Screens/OnlinePlay/Components/MatchBeatmapDetailArea.cs   | 2 ++
 osu.Game/Screens/OnlinePlay/Components/ModeTypeInfo.cs        | 2 ++
 .../OnlinePlay/Components/OnlinePlayBackgroundScreen.cs       | 2 --
 .../OnlinePlay/Components/OnlinePlayBackgroundSprite.cs       | 2 ++
 osu.Game/Screens/OnlinePlay/Components/OverlinedHeader.cs     | 2 ++
 .../Screens/OnlinePlay/Components/OverlinedPlaylistHeader.cs  | 2 ++
 .../Screens/OnlinePlay/Components/ParticipantCountDisplay.cs  | 2 ++
 osu.Game/Screens/OnlinePlay/Components/ParticipantsDisplay.cs | 2 ++
 osu.Game/Screens/OnlinePlay/Components/ParticipantsList.cs    | 2 ++
 .../Screens/OnlinePlay/Components/PlaylistItemBackground.cs   | 2 --
 osu.Game/Screens/OnlinePlay/Components/ReadyButton.cs         | 2 ++
 osu.Game/Screens/OnlinePlay/Components/RoomLocalUserInfo.cs   | 2 ++
 osu.Game/Screens/OnlinePlay/Components/RoomManager.cs         | 2 ++
 .../Screens/OnlinePlay/Components/RoomPollingComponent.cs     | 2 ++
 .../OnlinePlay/Components/SelectionPollingComponent.cs        | 2 ++
 .../Screens/OnlinePlay/Components/StarRatingRangeDisplay.cs   | 2 ++
 .../Screens/OnlinePlay/Components/StatusColouredContainer.cs  | 2 ++
 osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs           | 2 ++
 osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs       | 2 ++
 osu.Game/Screens/OnlinePlay/FooterButtonFreeMods.cs           | 2 ++
 osu.Game/Screens/OnlinePlay/FreeModSelectOverlay.cs           | 2 ++
 osu.Game/Screens/OnlinePlay/Header.cs                         | 2 ++
 osu.Game/Screens/OnlinePlay/IOnlinePlaySubScreen.cs           | 2 ++
 osu.Game/Screens/OnlinePlay/IRoomManager.cs                   | 2 --
 osu.Game/Screens/OnlinePlay/Lounge/Components/DrawableRoom.cs | 2 ++
 .../Lounge/Components/DrawableRoomParticipantsList.cs         | 2 ++
 osu.Game/Screens/OnlinePlay/Lounge/Components/EndDateInfo.cs  | 2 ++
 .../Screens/OnlinePlay/Lounge/Components/FilterCriteria.cs    | 2 ++
 .../Screens/OnlinePlay/Lounge/Components/MatchTypePill.cs     | 2 ++
 .../Screens/OnlinePlay/Lounge/Components/PillContainer.cs     | 2 ++
 .../Screens/OnlinePlay/Lounge/Components/PlaylistCountPill.cs | 2 ++
 .../Screens/OnlinePlay/Lounge/Components/QueueModePill.cs     | 2 ++
 .../Screens/OnlinePlay/Lounge/Components/RankRangePill.cs     | 2 ++
 .../OnlinePlay/Lounge/Components/RoomSpecialCategoryPill.cs   | 2 ++
 .../Screens/OnlinePlay/Lounge/Components/RoomStatusFilter.cs  | 2 ++
 .../Screens/OnlinePlay/Lounge/Components/RoomStatusPill.cs    | 2 ++
 .../Screens/OnlinePlay/Lounge/Components/RoomsContainer.cs    | 2 ++
 osu.Game/Screens/OnlinePlay/Lounge/DrawableLoungeRoom.cs      | 2 ++
 osu.Game/Screens/OnlinePlay/Lounge/LoungeBackgroundScreen.cs  | 2 --
 osu.Game/Screens/OnlinePlay/Lounge/LoungeSubScreen.cs         | 2 ++
 .../Screens/OnlinePlay/Match/Components/CreateRoomButton.cs   | 2 ++
 .../Screens/OnlinePlay/Match/Components/MatchChatDisplay.cs   | 2 ++
 .../Screens/OnlinePlay/Match/Components/MatchLeaderboard.cs   | 2 ++
 .../OnlinePlay/Match/Components/MatchLeaderboardScore.cs      | 2 ++
 .../Screens/OnlinePlay/Match/Components/MatchTypePicker.cs    | 2 ++
 .../OnlinePlay/Match/Components/PurpleTriangleButton.cs       | 2 ++
 .../OnlinePlay/Match/Components/RoomAvailabilityPicker.cs     | 2 ++
 .../OnlinePlay/Match/Components/RoomSettingsOverlay.cs        | 2 ++
 osu.Game/Screens/OnlinePlay/Match/DrawableMatchRoom.cs        | 2 ++
 osu.Game/Screens/OnlinePlay/Match/RoomBackgroundScreen.cs     | 2 ++
 osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs            | 2 ++
 .../OnlinePlay/Multiplayer/CreateMultiplayerMatchButton.cs    | 2 ++
 .../Screens/OnlinePlay/Multiplayer/GameplayChatDisplay.cs     | 2 ++
 .../OnlinePlay/Multiplayer/GameplayMatchScoreDisplay.cs       | 2 ++
 .../Screens/OnlinePlay/Multiplayer/Match/MatchStartControl.cs | 2 ++
 .../Multiplayer/Match/MultiplayerCountdownButton.cs           | 2 ++
 .../OnlinePlay/Multiplayer/Match/MultiplayerMatchFooter.cs    | 2 ++
 .../Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs      | 2 ++
 .../OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs    | 2 ++
 .../OnlinePlay/Multiplayer/Match/MultiplayerSpectateButton.cs | 2 ++
 .../Multiplayer/Match/Playlist/MultiplayerHistoryList.cs      | 2 ++
 .../Multiplayer/Match/Playlist/MultiplayerPlaylist.cs         | 2 ++
 .../Match/Playlist/MultiplayerPlaylistDisplayMode.cs          | 2 ++
 .../Match/Playlist/MultiplayerPlaylistTabControl.cs           | 2 ++
 .../Multiplayer/Match/Playlist/MultiplayerQueueList.cs        | 2 ++
 osu.Game/Screens/OnlinePlay/Multiplayer/Multiplayer.cs        | 2 ++
 .../OnlinePlay/Multiplayer/MultiplayerLoungeSubScreen.cs      | 2 ++
 .../OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs      | 2 ++
 .../OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs       | 2 ++
 osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayer.cs  | 2 ++
 .../Screens/OnlinePlay/Multiplayer/MultiplayerPlayerLoader.cs | 2 ++
 .../OnlinePlay/Multiplayer/MultiplayerResultsScreen.cs        | 2 ++
 .../OnlinePlay/Multiplayer/MultiplayerRoomComposite.cs        | 2 ++
 .../Screens/OnlinePlay/Multiplayer/MultiplayerRoomManager.cs  | 2 ++
 .../Screens/OnlinePlay/Multiplayer/MultiplayerRoomSounds.cs   | 2 ++
 .../OnlinePlay/Multiplayer/MultiplayerTeamResultsScreen.cs    | 2 ++
 .../OnlinePlay/Multiplayer/Participants/ParticipantPanel.cs   | 2 ++
 .../OnlinePlay/Multiplayer/Participants/ParticipantsList.cs   | 2 ++
 .../Multiplayer/Participants/ParticipantsListHeader.cs        | 2 ++
 .../OnlinePlay/Multiplayer/Participants/StateDisplay.cs       | 2 ++
 .../OnlinePlay/Multiplayer/Participants/TeamDisplay.cs        | 2 ++
 .../Multiplayer/Spectate/CatchUpSpectatorPlayerClock.cs       | 2 --
 .../OnlinePlay/Multiplayer/Spectate/CatchUpSyncManager.cs     | 2 ++
 .../OnlinePlay/Multiplayer/Spectate/ISpectatorPlayerClock.cs  | 2 ++
 .../Screens/OnlinePlay/Multiplayer/Spectate/ISyncManager.cs   | 2 ++
 .../OnlinePlay/Multiplayer/Spectate/MasterClockState.cs       | 2 ++
 .../Multiplayer/Spectate/MultiSpectatorLeaderboard.cs         | 2 ++
 .../OnlinePlay/Multiplayer/Spectate/MultiSpectatorPlayer.cs   | 2 ++
 .../Multiplayer/Spectate/MultiSpectatorPlayerLoader.cs        | 2 ++
 .../OnlinePlay/Multiplayer/Spectate/MultiSpectatorScreen.cs   | 2 ++
 .../Screens/OnlinePlay/Multiplayer/Spectate/PlayerArea.cs     | 2 ++
 .../Screens/OnlinePlay/Multiplayer/Spectate/PlayerGrid.cs     | 2 ++
 .../OnlinePlay/Multiplayer/Spectate/PlayerGrid_Cell.cs        | 2 ++
 .../OnlinePlay/Multiplayer/Spectate/PlayerGrid_Facade.cs      | 2 ++
 osu.Game/Screens/OnlinePlay/OngoingOperationTracker.cs        | 2 ++
 osu.Game/Screens/OnlinePlay/OnlinePlayComposite.cs            | 2 ++
 osu.Game/Screens/OnlinePlay/OnlinePlayScreen.cs               | 2 ++
 osu.Game/Screens/OnlinePlay/OnlinePlaySongSelect.cs           | 2 ++
 osu.Game/Screens/OnlinePlay/OnlinePlaySubScreen.cs            | 2 ++
 osu.Game/Screens/OnlinePlay/OnlinePlaySubScreenStack.cs       | 2 ++
 .../Screens/OnlinePlay/Playlists/CreatePlaylistsRoomButton.cs | 2 ++
 osu.Game/Screens/OnlinePlay/Playlists/Playlists.cs            | 2 ++
 .../Screens/OnlinePlay/Playlists/PlaylistsLoungeSubScreen.cs  | 2 ++
 osu.Game/Screens/OnlinePlay/Playlists/PlaylistsPlayer.cs      | 2 ++
 osu.Game/Screens/OnlinePlay/Playlists/PlaylistsReadyButton.cs | 2 ++
 .../Screens/OnlinePlay/Playlists/PlaylistsResultsScreen.cs    | 2 ++
 osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomFooter.cs  | 2 ++
 .../OnlinePlay/Playlists/PlaylistsRoomSettingsOverlay.cs      | 2 ++
 .../OnlinePlay/Playlists/PlaylistsRoomSettingsPlaylist.cs     | 2 ++
 .../Screens/OnlinePlay/Playlists/PlaylistsRoomSubScreen.cs    | 2 ++
 osu.Game/Screens/OnlinePlay/Playlists/PlaylistsSongSelect.cs  | 2 ++
 osu.Game/Screens/OsuScreen.cs                                 | 2 ++
 osu.Game/Screens/OsuScreenDependencies.cs                     | 2 ++
 osu.Game/Screens/OsuScreenStack.cs                            | 2 ++
 osu.Game/Screens/Play/BeatmapMetadataDisplay.cs               | 2 ++
 osu.Game/Screens/Play/Break/BlurredIcon.cs                    | 2 ++
 osu.Game/Screens/Play/Break/BreakArrows.cs                    | 2 ++
 osu.Game/Screens/Play/Break/BreakInfo.cs                      | 2 ++
 osu.Game/Screens/Play/Break/BreakInfoLine.cs                  | 2 ++
 osu.Game/Screens/Play/Break/GlowIcon.cs                       | 2 ++
 osu.Game/Screens/Play/Break/LetterboxOverlay.cs               | 2 ++
 osu.Game/Screens/Play/Break/RemainingTimeCounter.cs           | 2 ++
 osu.Game/Screens/Play/BreakOverlay.cs                         | 2 ++
 osu.Game/Screens/Play/BreakTracker.cs                         | 2 ++
 osu.Game/Screens/Play/ComboEffects.cs                         | 2 ++
 osu.Game/Screens/Play/DimmableStoryboard.cs                   | 2 ++
 osu.Game/Screens/Play/EpilepsyWarning.cs                      | 2 ++
 osu.Game/Screens/Play/FailAnimation.cs                        | 2 ++
 osu.Game/Screens/Play/FailOverlay.cs                          | 2 ++
 osu.Game/Screens/Play/GameplayClock.cs                        | 2 ++
 osu.Game/Screens/Play/GameplayClockContainer.cs               | 2 ++
 osu.Game/Screens/Play/GameplayMenuOverlay.cs                  | 2 ++
 osu.Game/Screens/Play/GameplayState.cs                        | 2 --
 osu.Game/Screens/Play/HUD/DefaultAccuracyCounter.cs           | 2 ++
 osu.Game/Screens/Play/HUD/DefaultComboCounter.cs              | 2 ++
 osu.Game/Screens/Play/HUD/DefaultHealthDisplay.cs             | 2 ++
 osu.Game/Screens/Play/HUD/DefaultScoreCounter.cs              | 2 ++
 osu.Game/Screens/Play/HUD/FailingLayer.cs                     | 2 ++
 osu.Game/Screens/Play/HUD/GameplayAccuracyCounter.cs          | 2 ++
 osu.Game/Screens/Play/HUD/GameplayLeaderboard.cs              | 2 ++
 osu.Game/Screens/Play/HUD/GameplayLeaderboardScore.cs         | 2 ++
 osu.Game/Screens/Play/HUD/GameplayScoreCounter.cs             | 2 ++
 osu.Game/Screens/Play/HUD/HealthDisplay.cs                    | 2 ++
 osu.Game/Screens/Play/HUD/HitErrorMeters/BarHitErrorMeter.cs  | 2 ++
 .../Screens/Play/HUD/HitErrorMeters/ColourHitErrorMeter.cs    | 2 ++
 osu.Game/Screens/Play/HUD/HitErrorMeters/HitErrorMeter.cs     | 2 ++
 osu.Game/Screens/Play/HUD/HoldForMenuButton.cs                | 2 ++
 osu.Game/Screens/Play/HUD/ILeaderboardScore.cs                | 2 ++
 osu.Game/Screens/Play/HUD/LegacyComboCounter.cs               | 2 ++
 osu.Game/Screens/Play/HUD/MatchScoreDisplay.cs                | 2 ++
 osu.Game/Screens/Play/HUD/ModDisplay.cs                       | 2 ++
 osu.Game/Screens/Play/HUD/ModFlowDisplay.cs                   | 2 ++
 osu.Game/Screens/Play/HUD/MultiplayerGameplayLeaderboard.cs   | 2 ++
 osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs         | 2 ++
 osu.Game/Screens/Play/HUD/PlayerSettingsOverlay.cs            | 2 ++
 osu.Game/Screens/Play/HUD/SkinnableInfo.cs                    | 2 ++
 osu.Game/Screens/Play/HUD/UnstableRateCounter.cs              | 2 ++
 osu.Game/Screens/Play/HUDOverlay.cs                           | 2 ++
 osu.Game/Screens/Play/HotkeyExitOverlay.cs                    | 2 ++
 osu.Game/Screens/Play/HotkeyRetryOverlay.cs                   | 2 ++
 osu.Game/Screens/Play/ILocalUserPlayInfo.cs                   | 2 ++
 osu.Game/Screens/Play/KeyCounter.cs                           | 2 ++
 osu.Game/Screens/Play/KeyCounterAction.cs                     | 2 ++
 osu.Game/Screens/Play/KeyCounterDisplay.cs                    | 2 ++
 osu.Game/Screens/Play/KeyCounterKeyboard.cs                   | 2 ++
 osu.Game/Screens/Play/KeyCounterMouse.cs                      | 2 ++
 osu.Game/Screens/Play/KeyCounterState.cs                      | 2 ++
 osu.Game/Screens/Play/MasterGameplayClockContainer.cs         | 2 ++
 osu.Game/Screens/Play/PauseOverlay.cs                         | 2 ++
 osu.Game/Screens/Play/Player.cs                               | 2 ++
 osu.Game/Screens/Play/PlayerConfiguration.cs                  | 2 ++
 osu.Game/Screens/Play/PlayerLoader.cs                         | 2 --
 osu.Game/Screens/Play/PlayerSettings/AudioSettings.cs         | 2 ++
 osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs  | 2 --
 osu.Game/Screens/Play/PlayerSettings/DiscussionSettings.cs    | 2 ++
 osu.Game/Screens/Play/PlayerSettings/InputSettings.cs         | 2 ++
 osu.Game/Screens/Play/PlayerSettings/PlaybackSettings.cs      | 2 ++
 osu.Game/Screens/Play/PlayerSettings/PlayerCheckbox.cs        | 2 ++
 osu.Game/Screens/Play/PlayerSettings/PlayerSettingsGroup.cs   | 2 ++
 osu.Game/Screens/Play/PlayerSettings/PlayerSliderBar.cs       | 2 ++
 osu.Game/Screens/Play/PlayerSettings/VisualSettings.cs        | 2 ++
 osu.Game/Screens/Play/ReplayPlayer.cs                         | 2 ++
 osu.Game/Screens/Play/ReplayPlayerLoader.cs                   | 2 ++
 osu.Game/Screens/Play/ResumeOverlay.cs                        | 2 ++
 osu.Game/Screens/Play/RoomSubmittingPlayer.cs                 | 2 ++
 osu.Game/Screens/Play/ScreenSuspensionHandler.cs              | 2 ++
 osu.Game/Screens/Play/ScreenWithBeatmapBackground.cs          | 2 ++
 osu.Game/Screens/Play/SkipOverlay.cs                          | 2 ++
 osu.Game/Screens/Play/SoloPlayer.cs                           | 2 ++
 osu.Game/Screens/Play/SoloSpectator.cs                        | 2 ++
 osu.Game/Screens/Play/SoloSpectatorPlayer.cs                  | 2 ++
 osu.Game/Screens/Play/SongProgress.cs                         | 2 ++
 osu.Game/Screens/Play/SongProgressBar.cs                      | 2 ++
 osu.Game/Screens/Play/SongProgressGraph.cs                    | 2 ++
 osu.Game/Screens/Play/SongProgressInfo.cs                     | 2 ++
 osu.Game/Screens/Play/SpectatorPlayer.cs                      | 2 ++
 osu.Game/Screens/Play/SpectatorPlayerLoader.cs                | 2 ++
 osu.Game/Screens/Play/SpectatorResultsScreen.cs               | 2 ++
 osu.Game/Screens/Play/SquareGraph.cs                          | 2 ++
 osu.Game/Screens/Play/SubmittingPlayer.cs                     | 2 ++
 osu.Game/Screens/Ranking/AspectContainer.cs                   | 2 ++
 .../Ranking/Contracted/ContractedPanelMiddleContent.cs        | 2 ++
 .../Screens/Ranking/Contracted/ContractedPanelTopContent.cs   | 2 ++
 osu.Game/Screens/Ranking/Expanded/Accuracy/AccuracyCircle.cs  | 2 ++
 osu.Game/Screens/Ranking/Expanded/Accuracy/RankBadge.cs       | 2 ++
 osu.Game/Screens/Ranking/Expanded/Accuracy/RankNotch.cs       | 2 ++
 osu.Game/Screens/Ranking/Expanded/Accuracy/RankText.cs        | 2 ++
 .../Ranking/Expanded/Accuracy/SmoothCircularProgress.cs       | 2 ++
 .../Screens/Ranking/Expanded/ExpandedPanelMiddleContent.cs    | 2 ++
 osu.Game/Screens/Ranking/Expanded/ExpandedPanelTopContent.cs  | 2 ++
 .../Screens/Ranking/Expanded/Statistics/AccuracyStatistic.cs  | 2 ++
 .../Screens/Ranking/Expanded/Statistics/ComboStatistic.cs     | 2 ++
 .../Screens/Ranking/Expanded/Statistics/CounterStatistic.cs   | 2 ++
 .../Screens/Ranking/Expanded/Statistics/HitResultStatistic.cs | 2 ++
 .../Ranking/Expanded/Statistics/PerformanceStatistic.cs       | 2 ++
 .../Screens/Ranking/Expanded/Statistics/StatisticCounter.cs   | 2 ++
 .../Screens/Ranking/Expanded/Statistics/StatisticDisplay.cs   | 2 ++
 osu.Game/Screens/Ranking/Expanded/TotalScoreCounter.cs        | 2 ++
 osu.Game/Screens/Ranking/PanelState.cs                        | 2 ++
 osu.Game/Screens/Ranking/ReplayDownloadButton.cs              | 2 ++
 osu.Game/Screens/Ranking/ResultsScreen.cs                     | 2 ++
 osu.Game/Screens/Ranking/RetryButton.cs                       | 2 ++
 osu.Game/Screens/Ranking/ScorePanel.cs                        | 2 ++
 osu.Game/Screens/Ranking/ScorePanelList.cs                    | 2 ++
 osu.Game/Screens/Ranking/ScorePanelTrackingContainer.cs       | 2 ++
 osu.Game/Screens/Ranking/SoloResultsScreen.cs                 | 2 ++
 osu.Game/Screens/Ranking/Statistics/AverageHitError.cs        | 2 ++
 .../Ranking/Statistics/HitEventTimingDistributionGraph.cs     | 2 ++
 .../Screens/Ranking/Statistics/PerformanceBreakdownChart.cs   | 2 ++
 osu.Game/Screens/Ranking/Statistics/SimpleStatisticItem.cs    | 2 ++
 osu.Game/Screens/Ranking/Statistics/SimpleStatisticTable.cs   | 2 ++
 osu.Game/Screens/Ranking/Statistics/StatisticContainer.cs     | 2 ++
 osu.Game/Screens/Ranking/Statistics/StatisticItem.cs          | 2 ++
 osu.Game/Screens/Ranking/Statistics/StatisticRow.cs           | 2 ++
 osu.Game/Screens/Ranking/Statistics/StatisticsPanel.cs        | 2 ++
 osu.Game/Screens/Ranking/Statistics/UnstableRate.cs           | 2 ++
 osu.Game/Screens/ScorePresentType.cs                          | 2 ++
 osu.Game/Screens/ScreenWhiteBox.cs                            | 2 ++
 osu.Game/Screens/Select/BeatmapCarousel.cs                    | 2 ++
 osu.Game/Screens/Select/BeatmapClearScoresDialog.cs           | 2 ++
 osu.Game/Screens/Select/BeatmapDeleteDialog.cs                | 2 ++
 osu.Game/Screens/Select/BeatmapDetailArea.cs                  | 2 ++
 osu.Game/Screens/Select/BeatmapDetailAreaDetailTabItem.cs     | 2 ++
 .../Screens/Select/BeatmapDetailAreaLeaderboardTabItem.cs     | 2 ++
 osu.Game/Screens/Select/BeatmapDetailAreaTabControl.cs        | 2 ++
 osu.Game/Screens/Select/BeatmapDetailAreaTabItem.cs           | 2 ++
 osu.Game/Screens/Select/BeatmapDetails.cs                     | 2 ++
 osu.Game/Screens/Select/BeatmapInfoWedge.cs                   | 2 ++
 osu.Game/Screens/Select/BeatmapInfoWedgeBackground.cs         | 2 ++
 osu.Game/Screens/Select/Carousel/CarouselBeatmap.cs           | 2 ++
 osu.Game/Screens/Select/Carousel/CarouselBeatmapSet.cs        | 2 ++
 osu.Game/Screens/Select/Carousel/CarouselGroup.cs             | 2 --
 osu.Game/Screens/Select/Carousel/CarouselGroupEagerSelect.cs  | 2 ++
 osu.Game/Screens/Select/Carousel/CarouselHeader.cs            | 2 ++
 osu.Game/Screens/Select/Carousel/CarouselItem.cs              | 2 ++
 osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmap.cs   | 2 ++
 .../Screens/Select/Carousel/DrawableCarouselBeatmapSet.cs     | 2 ++
 osu.Game/Screens/Select/Carousel/DrawableCarouselItem.cs      | 2 ++
 osu.Game/Screens/Select/Carousel/FilterableDifficultyIcon.cs  | 2 ++
 .../Select/Carousel/FilterableGroupedDifficultyIcon.cs        | 2 ++
 osu.Game/Screens/Select/Carousel/SetPanelBackground.cs        | 2 ++
 osu.Game/Screens/Select/Carousel/SetPanelContent.cs           | 2 ++
 osu.Game/Screens/Select/Carousel/TopLocalRank.cs              | 2 ++
 osu.Game/Screens/Select/Details/AdvancedStats.cs              | 2 ++
 osu.Game/Screens/Select/Details/FailRetryGraph.cs             | 2 ++
 osu.Game/Screens/Select/Details/UserRatings.cs                | 2 ++
 osu.Game/Screens/Select/Filter/GroupMode.cs                   | 2 ++
 osu.Game/Screens/Select/Filter/Operator.cs                    | 2 ++
 osu.Game/Screens/Select/Filter/SortMode.cs                    | 2 ++
 osu.Game/Screens/Select/FilterControl.cs                      | 2 ++
 osu.Game/Screens/Select/FilterCriteria.cs                     | 2 ++
 osu.Game/Screens/Select/FilterQueryParser.cs                  | 2 ++
 osu.Game/Screens/Select/Footer.cs                             | 2 ++
 osu.Game/Screens/Select/FooterButton.cs                       | 2 ++
 osu.Game/Screens/Select/FooterButtonMods.cs                   | 2 ++
 osu.Game/Screens/Select/FooterButtonOptions.cs                | 2 ++
 osu.Game/Screens/Select/FooterButtonRandom.cs                 | 2 ++
 osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs    | 2 ++
 .../Screens/Select/Leaderboards/BeatmapLeaderboardScope.cs    | 2 ++
 osu.Game/Screens/Select/LocalScoreDeleteDialog.cs             | 2 ++
 osu.Game/Screens/Select/NoResultsPlaceholder.cs               | 2 --
 osu.Game/Screens/Select/Options/BeatmapOptionsButton.cs       | 2 ++
 osu.Game/Screens/Select/Options/BeatmapOptionsOverlay.cs      | 2 ++
 osu.Game/Screens/Select/PlayBeatmapDetailArea.cs              | 2 ++
 osu.Game/Screens/Select/PlaySongSelect.cs                     | 2 ++
 osu.Game/Screens/Select/SkinDeleteDialog.cs                   | 2 ++
 osu.Game/Screens/Select/SongSelect.cs                         | 2 ++
 osu.Game/Screens/Select/WedgeBackground.cs                    | 2 ++
 osu.Game/Screens/Spectate/SpectatorGameplayState.cs           | 2 ++
 osu.Game/Screens/Spectate/SpectatorScreen.cs                  | 2 ++
 osu.Game/Screens/StartupScreen.cs                             | 2 ++
 osu.Game/Screens/Utility/ButtonWithKeyBind.cs                 | 1 -
 osu.Game/Screens/Utility/CircleGameplay.cs                    | 2 --
 osu.Game/Screens/Utility/LatencyArea.cs                       | 2 --
 osu.Game/Screens/Utility/LatencyCertifierScreen.cs            | 2 --
 osu.Game/Screens/Utility/LatencyVisualMode.cs                 | 1 -
 .../Utility/SampleComponents/LatencyCursorContainer.cs        | 1 -
 .../Screens/Utility/SampleComponents/LatencyMovableBox.cs     | 2 --
 .../Utility/SampleComponents/LatencySampleComponent.cs        | 2 --
 osu.Game/Screens/Utility/ScrollingGameplay.cs                 | 1 -
 osu.Game/Skinning/BeatmapSkinProvidingContainer.cs            | 2 ++
 osu.Game/Skinning/Components/BigBlackBox.cs                   | 2 ++
 osu.Game/Skinning/DefaultLegacySkin.cs                        | 2 ++
 osu.Game/Skinning/DefaultSkin.cs                              | 2 ++
 osu.Game/Skinning/EFSkinInfo.cs                               | 2 ++
 osu.Game/Skinning/Editor/SkinBlueprint.cs                     | 2 ++
 osu.Game/Skinning/Editor/SkinBlueprintContainer.cs            | 2 ++
 osu.Game/Skinning/Editor/SkinComponentToolbox.cs              | 2 ++
 osu.Game/Skinning/Editor/SkinEditor.cs                        | 2 ++
 osu.Game/Skinning/Editor/SkinEditorOverlay.cs                 | 2 ++
 osu.Game/Skinning/Editor/SkinEditorSceneLibrary.cs            | 2 ++
 osu.Game/Skinning/Editor/SkinSelectionHandler.cs              | 2 ++
 osu.Game/Skinning/Editor/SkinSettingsToolbox.cs               | 2 ++
 osu.Game/Skinning/GameplaySkinComponent.cs                    | 2 ++
 osu.Game/Skinning/GlobalSkinColours.cs                        | 2 ++
 osu.Game/Skinning/HUDSkinComponents.cs                        | 2 ++
 osu.Game/Skinning/IAnimationTimeReference.cs                  | 2 ++
 osu.Game/Skinning/IPooledSampleProvider.cs                    | 2 ++
 osu.Game/Skinning/ISkin.cs                                    | 2 --
 osu.Game/Skinning/ISkinComponent.cs                           | 2 ++
 osu.Game/Skinning/ISkinSource.cs                              | 2 ++
 osu.Game/Skinning/ISkinnableDrawable.cs                       | 2 ++
 osu.Game/Skinning/ISkinnableTarget.cs                         | 2 ++
 osu.Game/Skinning/LegacyAccuracyCounter.cs                    | 2 ++
 osu.Game/Skinning/LegacyBeatmapSkin.cs                        | 2 --
 osu.Game/Skinning/LegacyColourCompatibility.cs                | 2 ++
 osu.Game/Skinning/LegacyFont.cs                               | 2 ++
 osu.Game/Skinning/LegacyHealthDisplay.cs                      | 2 ++
 osu.Game/Skinning/LegacyJudgementPieceNew.cs                  | 2 ++
 osu.Game/Skinning/LegacyJudgementPieceOld.cs                  | 2 ++
 osu.Game/Skinning/LegacyManiaSkinConfiguration.cs             | 2 ++
 osu.Game/Skinning/LegacyManiaSkinConfigurationLookup.cs       | 2 ++
 osu.Game/Skinning/LegacyManiaSkinDecoder.cs                   | 2 ++
 osu.Game/Skinning/LegacyRollingCounter.cs                     | 2 ++
 osu.Game/Skinning/LegacyScoreCounter.cs                       | 2 ++
 osu.Game/Skinning/LegacySkin.cs                               | 2 --
 osu.Game/Skinning/LegacySkinDecoder.cs                        | 2 ++
 osu.Game/Skinning/LegacySkinExtensions.cs                     | 2 --
 osu.Game/Skinning/LegacySkinTransformer.cs                    | 2 ++
 osu.Game/Skinning/LegacySpriteText.cs                         | 2 ++
 osu.Game/Skinning/PausableSkinnableSound.cs                   | 2 ++
 osu.Game/Skinning/PoolableSkinnableSample.cs                  | 2 ++
 osu.Game/Skinning/RealmBackedResourceStore.cs                 | 2 --
 osu.Game/Skinning/ResourceStoreBackedSkin.cs                  | 2 --
 osu.Game/Skinning/RulesetSkinProvidingContainer.cs            | 2 ++
 osu.Game/Skinning/Skin.cs                                     | 2 --
 osu.Game/Skinning/SkinComboColourLookup.cs                    | 2 ++
 osu.Game/Skinning/SkinConfigManager.cs                        | 2 ++
 osu.Game/Skinning/SkinConfiguration.cs                        | 2 ++
 osu.Game/Skinning/SkinCustomColourLookup.cs                   | 2 ++
 osu.Game/Skinning/SkinFileInfo.cs                             | 2 ++
 osu.Game/Skinning/SkinImporter.cs                             | 2 --
 osu.Game/Skinning/SkinInfo.cs                                 | 2 --
 osu.Game/Skinning/SkinManager.cs                              | 2 ++
 osu.Game/Skinning/SkinProvidingContainer.cs                   | 2 ++
 osu.Game/Skinning/SkinReloadableDrawable.cs                   | 2 ++
 osu.Game/Skinning/SkinUtils.cs                                | 2 ++
 osu.Game/Skinning/SkinnableDrawable.cs                        | 2 ++
 osu.Game/Skinning/SkinnableSound.cs                           | 2 ++
 osu.Game/Skinning/SkinnableSprite.cs                          | 2 ++
 osu.Game/Skinning/SkinnableSpriteText.cs                      | 2 ++
 osu.Game/Skinning/SkinnableTarget.cs                          | 2 ++
 osu.Game/Skinning/SkinnableTargetComponent.cs                 | 2 ++
 osu.Game/Skinning/SkinnableTargetComponentsContainer.cs       | 2 ++
 osu.Game/Skinning/SkinnableTargetContainer.cs                 | 2 ++
 osu.Game/Skinning/UnsupportedSkinComponentException.cs        | 2 ++
 osu.Game/Storyboards/CommandLoop.cs                           | 2 ++
 osu.Game/Storyboards/CommandTimeline.cs                       | 2 ++
 osu.Game/Storyboards/CommandTimelineGroup.cs                  | 2 ++
 osu.Game/Storyboards/CommandTrigger.cs                        | 2 ++
 osu.Game/Storyboards/Drawables/DrawableStoryboard.cs          | 2 ++
 osu.Game/Storyboards/Drawables/DrawableStoryboardAnimation.cs | 2 ++
 osu.Game/Storyboards/Drawables/DrawableStoryboardLayer.cs     | 2 ++
 osu.Game/Storyboards/Drawables/DrawableStoryboardSample.cs    | 2 ++
 osu.Game/Storyboards/Drawables/DrawableStoryboardSprite.cs    | 2 ++
 osu.Game/Storyboards/Drawables/DrawableStoryboardVideo.cs     | 2 ++
 osu.Game/Storyboards/Drawables/DrawablesExtensions.cs         | 2 ++
 osu.Game/Storyboards/Drawables/IFlippable.cs                  | 2 ++
 osu.Game/Storyboards/Drawables/IVectorScalable.cs             | 2 ++
 osu.Game/Storyboards/IStoryboardElement.cs                    | 2 ++
 osu.Game/Storyboards/IStoryboardElementWithDuration.cs        | 2 ++
 osu.Game/Storyboards/Storyboard.cs                            | 2 ++
 osu.Game/Storyboards/StoryboardAnimation.cs                   | 2 ++
 osu.Game/Storyboards/StoryboardExtensions.cs                  | 2 ++
 osu.Game/Storyboards/StoryboardLayer.cs                       | 2 ++
 osu.Game/Storyboards/StoryboardSample.cs                      | 2 ++
 osu.Game/Storyboards/StoryboardSprite.cs                      | 2 ++
 osu.Game/Storyboards/StoryboardVideo.cs                       | 2 ++
 osu.Game/Storyboards/StoryboardVideoLayer.cs                  | 2 ++
 osu.Game/Tests/Beatmaps/BeatmapConversionTest.cs              | 2 ++
 osu.Game/Tests/Beatmaps/DifficultyCalculatorTest.cs           | 2 ++
 osu.Game/Tests/Beatmaps/HitObjectSampleTest.cs                | 2 ++
 osu.Game/Tests/Beatmaps/LegacyBeatmapSkinColourTest.cs        | 2 ++
 osu.Game/Tests/Beatmaps/LegacyModConversionTest.cs            | 2 ++
 osu.Game/Tests/Beatmaps/TestBeatmap.cs                        | 2 ++
 osu.Game/Tests/Beatmaps/TestWorkingBeatmap.cs                 | 2 ++
 osu.Game/Tests/CleanRunHeadlessGameHost.cs                    | 2 ++
 osu.Game/Tests/Gameplay/TestGameplayState.cs                  | 2 --
 osu.Game/Tests/OsuTestBrowser.cs                              | 2 ++
 osu.Game/Tests/Rulesets/TestRulesetConfigCache.cs             | 2 ++
 osu.Game/Tests/Visual/DependencyProvidingContainer.cs         | 2 ++
 osu.Game/Tests/Visual/EditorClockTestScene.cs                 | 2 ++
 osu.Game/Tests/Visual/EditorSavingTestScene.cs                | 2 ++
 osu.Game/Tests/Visual/EditorTestScene.cs                      | 2 ++
 osu.Game/Tests/Visual/LegacySkinPlayerTestScene.cs            | 2 ++
 osu.Game/Tests/Visual/ModPerfectTestScene.cs                  | 2 ++
 osu.Game/Tests/Visual/ModTestScene.cs                         | 2 ++
 .../Visual/Multiplayer/IMultiplayerTestSceneDependencies.cs   | 2 ++
 osu.Game/Tests/Visual/Multiplayer/MultiplayerTestScene.cs     | 2 ++
 .../Visual/Multiplayer/MultiplayerTestSceneDependencies.cs    | 2 ++
 osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs    | 2 --
 .../Tests/Visual/Multiplayer/TestMultiplayerRoomManager.cs    | 2 ++
 .../Visual/OnlinePlay/IOnlinePlayTestSceneDependencies.cs     | 2 ++
 osu.Game/Tests/Visual/OnlinePlay/OnlinePlayTestScene.cs       | 2 ++
 .../Visual/OnlinePlay/OnlinePlayTestSceneDependencies.cs      | 2 ++
 osu.Game/Tests/Visual/OnlinePlay/TestRoomManager.cs           | 2 ++
 osu.Game/Tests/Visual/OnlinePlay/TestRoomRequestsHandler.cs   | 2 ++
 osu.Game/Tests/Visual/OsuGameTestScene.cs                     | 2 ++
 osu.Game/Tests/Visual/OsuGridTestScene.cs                     | 2 ++
 osu.Game/Tests/Visual/OsuManualInputManagerTestScene.cs       | 2 ++
 osu.Game/Tests/Visual/OsuTestScene.cs                         | 2 ++
 osu.Game/Tests/Visual/PlacementBlueprintTestScene.cs          | 2 ++
 osu.Game/Tests/Visual/PlayerTestScene.cs                      | 2 ++
 osu.Game/Tests/Visual/RateAdjustedBeatmapTestScene.cs         | 2 ++
 osu.Game/Tests/Visual/ScreenTestScene.cs                      | 2 ++
 osu.Game/Tests/Visual/ScrollingTestContainer.cs               | 2 ++
 osu.Game/Tests/Visual/SelectionBlueprintTestScene.cs          | 2 ++
 osu.Game/Tests/Visual/SkinnableTestScene.cs                   | 2 ++
 osu.Game/Tests/Visual/Spectator/TestSpectatorClient.cs        | 2 --
 osu.Game/Tests/Visual/TestPlayer.cs                           | 2 ++
 osu.Game/Tests/Visual/TestReplayPlayer.cs                     | 2 ++
 osu.Game/Tests/Visual/TestUserLookupCache.cs                  | 2 ++
 osu.Game/Tests/VisualTestRunner.cs                            | 2 ++
 osu.Game/Updater/GitHubAsset.cs                               | 2 ++
 osu.Game/Updater/GitHubRelease.cs                             | 2 ++
 osu.Game/Updater/NoActionUpdateManager.cs                     | 2 ++
 osu.Game/Updater/SimpleUpdateManager.cs                       | 2 ++
 osu.Game/Updater/UpdateManager.cs                             | 2 ++
 osu.Game/Users/Badge.cs                                       | 2 ++
 osu.Game/Users/Country.cs                                     | 2 ++
 osu.Game/Users/CountryStatistics.cs                           | 2 ++
 osu.Game/Users/Drawables/ClickableAvatar.cs                   | 2 ++
 osu.Game/Users/Drawables/DrawableAvatar.cs                    | 2 ++
 osu.Game/Users/Drawables/DrawableFlag.cs                      | 2 ++
 osu.Game/Users/Drawables/UpdateableAvatar.cs                  | 2 ++
 osu.Game/Users/Drawables/UpdateableFlag.cs                    | 2 ++
 osu.Game/Users/ExtendedUserPanel.cs                           | 2 ++
 osu.Game/Users/IUser.cs                                       | 2 --
 osu.Game/Users/Medal.cs                                       | 2 ++
 osu.Game/Users/UserActivity.cs                                | 2 ++
 osu.Game/Users/UserBrickPanel.cs                              | 2 ++
 osu.Game/Users/UserCoverBackground.cs                         | 2 ++
 osu.Game/Users/UserGridPanel.cs                               | 2 ++
 osu.Game/Users/UserListPanel.cs                               | 2 ++
 osu.Game/Users/UserPanel.cs                                   | 2 ++
 osu.Game/Users/UserStatistics.cs                              | 2 ++
 osu.Game/Users/UserStatus.cs                                  | 2 ++
 osu.Game/Utils/BatteryInfo.cs                                 | 2 ++
 osu.Game/Utils/ColourUtils.cs                                 | 2 ++
 osu.Game/Utils/FormatUtils.cs                                 | 2 ++
 osu.Game/Utils/HumanizerUtils.cs                              | 2 ++
 osu.Game/Utils/IDeepCloneable.cs                              | 2 ++
 osu.Game/Utils/LegacyRandom.cs                                | 2 ++
 osu.Game/Utils/LegacyUtils.cs                                 | 2 ++
 osu.Game/Utils/ModUtils.cs                                    | 2 --
 osu.Game/Utils/NamingUtils.cs                                 | 2 ++
 osu.Game/Utils/Optional.cs                                    | 2 --
 osu.Game/Utils/PeriodTracker.cs                               | 2 ++
 osu.Game/Utils/SentryLogger.cs                                | 2 --
 osu.Game/Utils/StatelessRNG.cs                                | 2 ++
 osu.Game/Utils/TaskChain.cs                                   | 2 --
 osu.Game/Utils/ZipUtils.cs                                    | 2 ++
 osu.iOS/AppDelegate.cs                                        | 2 ++
 osu.iOS/Application.cs                                        | 2 ++
 osu.iOS/OsuGameIOS.cs                                         | 2 ++
 3500 files changed, 6556 insertions(+), 447 deletions(-)

diff --git a/osu.Android/GameplayScreenRotationLocker.cs b/osu.Android/GameplayScreenRotationLocker.cs
index 2e83f784d3..9e849bdc7c 100644
--- a/osu.Android/GameplayScreenRotationLocker.cs
+++ b/osu.Android/GameplayScreenRotationLocker.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.
 
+#nullable disable
+
 using Android.Content.PM;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Android/OsuGameActivity.cs b/osu.Android/OsuGameActivity.cs
index eebd079f68..be40db7508 100644
--- a/osu.Android/OsuGameActivity.cs
+++ b/osu.Android/OsuGameActivity.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.IO;
diff --git a/osu.Android/OsuGameAndroid.cs b/osu.Android/OsuGameAndroid.cs
index 050bf2b787..1edb867e05 100644
--- a/osu.Android/OsuGameAndroid.cs
+++ b/osu.Android/OsuGameAndroid.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.
 
+#nullable disable
+
 using System;
 using Android.App;
 using Android.OS;
diff --git a/osu.Android/Properties/AssemblyInfo.cs b/osu.Android/Properties/AssemblyInfo.cs
index c0ba324d6e..f65b1b239f 100644
--- a/osu.Android/Properties/AssemblyInfo.cs
+++ b/osu.Android/Properties/AssemblyInfo.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.
 
+#nullable disable
+
 using Android;
 using Android.App;
 
diff --git a/osu.Desktop/DiscordRichPresence.cs b/osu.Desktop/DiscordRichPresence.cs
index 43acac4f3e..f2531c1cae 100644
--- a/osu.Desktop/DiscordRichPresence.cs
+++ b/osu.Desktop/DiscordRichPresence.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.
 
+#nullable disable
+
 using System;
 using System.Text;
 using DiscordRPC;
diff --git a/osu.Desktop/LegacyIpc/LegacyIpcDifficultyCalculationRequest.cs b/osu.Desktop/LegacyIpc/LegacyIpcDifficultyCalculationRequest.cs
index d6ef390a8f..7b0bd69363 100644
--- a/osu.Desktop/LegacyIpc/LegacyIpcDifficultyCalculationRequest.cs
+++ b/osu.Desktop/LegacyIpc/LegacyIpcDifficultyCalculationRequest.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.
 
+#nullable disable
+
 namespace osu.Desktop.LegacyIpc
 {
     /// <summary>
diff --git a/osu.Desktop/LegacyIpc/LegacyIpcDifficultyCalculationResponse.cs b/osu.Desktop/LegacyIpc/LegacyIpcDifficultyCalculationResponse.cs
index 7b9fae5797..6d36cbc4b6 100644
--- a/osu.Desktop/LegacyIpc/LegacyIpcDifficultyCalculationResponse.cs
+++ b/osu.Desktop/LegacyIpc/LegacyIpcDifficultyCalculationResponse.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.
 
+#nullable disable
+
 namespace osu.Desktop.LegacyIpc
 {
     /// <summary>
diff --git a/osu.Desktop/LegacyIpc/LegacyIpcMessage.cs b/osu.Desktop/LegacyIpc/LegacyIpcMessage.cs
index 0fa60e2068..4df477191d 100644
--- a/osu.Desktop/LegacyIpc/LegacyIpcMessage.cs
+++ b/osu.Desktop/LegacyIpc/LegacyIpcMessage.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.
 
+#nullable disable
+
 using osu.Framework.Platform;
 using Newtonsoft.Json.Linq;
 
diff --git a/osu.Desktop/LegacyIpc/LegacyTcpIpcProvider.cs b/osu.Desktop/LegacyIpc/LegacyTcpIpcProvider.cs
index 10761bc315..5d950eef55 100644
--- a/osu.Desktop/LegacyIpc/LegacyTcpIpcProvider.cs
+++ b/osu.Desktop/LegacyIpc/LegacyTcpIpcProvider.cs
@@ -15,8 +15,6 @@ using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Taiko;
 
-#nullable enable
-
 namespace osu.Desktop.LegacyIpc
 {
     /// <summary>
diff --git a/osu.Desktop/OsuGameDesktop.cs b/osu.Desktop/OsuGameDesktop.cs
index be8159a7cc..6713136343 100644
--- a/osu.Desktop/OsuGameDesktop.cs
+++ b/osu.Desktop/OsuGameDesktop.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Diagnostics;
diff --git a/osu.Desktop/Program.cs b/osu.Desktop/Program.cs
index f95348aa3f..4ba9cc6a90 100644
--- a/osu.Desktop/Program.cs
+++ b/osu.Desktop/Program.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.
 
+#nullable disable
+
 using System;
 using System.IO;
 using System.Runtime.Versioning;
diff --git a/osu.Desktop/Security/ElevatedPrivilegesChecker.cs b/osu.Desktop/Security/ElevatedPrivilegesChecker.cs
index ba37a14442..f0d95ba194 100644
--- a/osu.Desktop/Security/ElevatedPrivilegesChecker.cs
+++ b/osu.Desktop/Security/ElevatedPrivilegesChecker.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.
 
+#nullable disable
+
 using System;
 using System.Security.Principal;
 using osu.Framework;
diff --git a/osu.Desktop/Updater/SquirrelUpdateManager.cs b/osu.Desktop/Updater/SquirrelUpdateManager.cs
index c09cce1235..59bc2dabb2 100644
--- a/osu.Desktop/Updater/SquirrelUpdateManager.cs
+++ b/osu.Desktop/Updater/SquirrelUpdateManager.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.
 
+#nullable disable
+
 using System;
 using System.Runtime.Versioning;
 using System.Threading.Tasks;
diff --git a/osu.Desktop/Windows/GameplayWinKeyBlocker.cs b/osu.Desktop/Windows/GameplayWinKeyBlocker.cs
index 4acaf61cea..0cb4ba9c04 100644
--- a/osu.Desktop/Windows/GameplayWinKeyBlocker.cs
+++ b/osu.Desktop/Windows/GameplayWinKeyBlocker.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Desktop/Windows/WindowsKey.cs b/osu.Desktop/Windows/WindowsKey.cs
index fdca2028d3..c69cce6200 100644
--- a/osu.Desktop/Windows/WindowsKey.cs
+++ b/osu.Desktop/Windows/WindowsKey.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.
 
+#nullable disable
+
 using System;
 using System.Runtime.InteropServices;
 
diff --git a/osu.Game.Benchmarks/BenchmarkBeatmapParsing.cs b/osu.Game.Benchmarks/BenchmarkBeatmapParsing.cs
index 1d207d04c7..07ffda4030 100644
--- a/osu.Game.Benchmarks/BenchmarkBeatmapParsing.cs
+++ b/osu.Game.Benchmarks/BenchmarkBeatmapParsing.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.
 
+#nullable disable
+
 using System.IO;
 using BenchmarkDotNet.Attributes;
 using osu.Framework.IO.Stores;
diff --git a/osu.Game.Benchmarks/BenchmarkMod.cs b/osu.Game.Benchmarks/BenchmarkMod.cs
index c5375e9f09..a1d92d9a67 100644
--- a/osu.Game.Benchmarks/BenchmarkMod.cs
+++ b/osu.Game.Benchmarks/BenchmarkMod.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.
 
+#nullable disable
+
 using System;
 using BenchmarkDotNet.Attributes;
 using osu.Game.Rulesets.Osu.Mods;
diff --git a/osu.Game.Benchmarks/BenchmarkRealmReads.cs b/osu.Game.Benchmarks/BenchmarkRealmReads.cs
index 615e2e964d..bdc24315bf 100644
--- a/osu.Game.Benchmarks/BenchmarkRealmReads.cs
+++ b/osu.Game.Benchmarks/BenchmarkRealmReads.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.
 
+#nullable disable
+
 using System.Linq;
 using System.Threading;
 using BenchmarkDotNet.Attributes;
diff --git a/osu.Game.Benchmarks/BenchmarkRuleset.cs b/osu.Game.Benchmarks/BenchmarkRuleset.cs
index 2835ec9499..de8cb13773 100644
--- a/osu.Game.Benchmarks/BenchmarkRuleset.cs
+++ b/osu.Game.Benchmarks/BenchmarkRuleset.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.
 
+#nullable disable
+
 using BenchmarkDotNet.Attributes;
 using BenchmarkDotNet.Engines;
 using osu.Game.Online.API;
diff --git a/osu.Game.Benchmarks/BenchmarkTest.cs b/osu.Game.Benchmarks/BenchmarkTest.cs
index 34f5edd084..140696e4a4 100644
--- a/osu.Game.Benchmarks/BenchmarkTest.cs
+++ b/osu.Game.Benchmarks/BenchmarkTest.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.
 
+#nullable disable
+
 using BenchmarkDotNet.Attributes;
 using BenchmarkDotNet.Running;
 using NUnit.Framework;
diff --git a/osu.Game.Benchmarks/Program.cs b/osu.Game.Benchmarks/Program.cs
index 439ced53ab..603d8aa1b9 100644
--- a/osu.Game.Benchmarks/Program.cs
+++ b/osu.Game.Benchmarks/Program.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.
 
+#nullable disable
+
 using BenchmarkDotNet.Configs;
 using BenchmarkDotNet.Running;
 
diff --git a/osu.Game.Rulesets.Catch.Tests.Android/MainActivity.cs b/osu.Game.Rulesets.Catch.Tests.Android/MainActivity.cs
index d8b729576d..64c71c9ecd 100644
--- a/osu.Game.Rulesets.Catch.Tests.Android/MainActivity.cs
+++ b/osu.Game.Rulesets.Catch.Tests.Android/MainActivity.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.
 
+#nullable disable
+
 using Android.App;
 using osu.Framework.Android;
 using osu.Game.Tests;
diff --git a/osu.Game.Rulesets.Catch.Tests.iOS/AppDelegate.cs b/osu.Game.Rulesets.Catch.Tests.iOS/AppDelegate.cs
index 39fe3dac25..64ff3f7151 100644
--- a/osu.Game.Rulesets.Catch.Tests.iOS/AppDelegate.cs
+++ b/osu.Game.Rulesets.Catch.Tests.iOS/AppDelegate.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.
 
+#nullable disable
+
 using Foundation;
 using osu.Framework.iOS;
 using osu.Game.Tests;
diff --git a/osu.Game.Rulesets.Catch.Tests.iOS/Application.cs b/osu.Game.Rulesets.Catch.Tests.iOS/Application.cs
index e44868e133..71d943ece1 100644
--- a/osu.Game.Rulesets.Catch.Tests.iOS/Application.cs
+++ b/osu.Game.Rulesets.Catch.Tests.iOS/Application.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.
 
+#nullable disable
+
 using osu.Framework.iOS;
 using UIKit;
 
diff --git a/osu.Game.Rulesets.Catch.Tests/CatchBeatmapConversionTest.cs b/osu.Game.Rulesets.Catch.Tests/CatchBeatmapConversionTest.cs
index baca8166d1..b6cb351c1e 100644
--- a/osu.Game.Rulesets.Catch.Tests/CatchBeatmapConversionTest.cs
+++ b/osu.Game.Rulesets.Catch.Tests/CatchBeatmapConversionTest.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using Newtonsoft.Json;
diff --git a/osu.Game.Rulesets.Catch.Tests/CatchDifficultyCalculatorTest.cs b/osu.Game.Rulesets.Catch.Tests/CatchDifficultyCalculatorTest.cs
index 48d46636df..cf030f6e13 100644
--- a/osu.Game.Rulesets.Catch.Tests/CatchDifficultyCalculatorTest.cs
+++ b/osu.Game.Rulesets.Catch.Tests/CatchDifficultyCalculatorTest.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Catch.Difficulty;
diff --git a/osu.Game.Rulesets.Catch.Tests/CatchLegacyModConversionTest.cs b/osu.Game.Rulesets.Catch.Tests/CatchLegacyModConversionTest.cs
index eae07daa3d..c65c9df9f9 100644
--- a/osu.Game.Rulesets.Catch.Tests/CatchLegacyModConversionTest.cs
+++ b/osu.Game.Rulesets.Catch.Tests/CatchLegacyModConversionTest.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.
 
+#nullable disable
+
 using System;
 using NUnit.Framework;
 using osu.Game.Beatmaps.Legacy;
diff --git a/osu.Game.Rulesets.Catch.Tests/CatchSkinColourDecodingTest.cs b/osu.Game.Rulesets.Catch.Tests/CatchSkinColourDecodingTest.cs
index bb3a724b91..f30b216d8d 100644
--- a/osu.Game.Rulesets.Catch.Tests/CatchSkinColourDecodingTest.cs
+++ b/osu.Game.Rulesets.Catch.Tests/CatchSkinColourDecodingTest.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.IO.Stores;
 using osu.Game.Rulesets.Catch.Skinning;
diff --git a/osu.Game.Rulesets.Catch.Tests/CatchSkinnableTestScene.cs b/osu.Game.Rulesets.Catch.Tests/CatchSkinnableTestScene.cs
index 378772fea3..be6622f06e 100644
--- a/osu.Game.Rulesets.Catch.Tests/CatchSkinnableTestScene.cs
+++ b/osu.Game.Rulesets.Catch.Tests/CatchSkinnableTestScene.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.
 
+#nullable disable
+
 using osu.Game.Tests.Visual;
 
 namespace osu.Game.Rulesets.Catch.Tests
diff --git a/osu.Game.Rulesets.Catch.Tests/Editor/CatchEditorTestSceneContainer.cs b/osu.Game.Rulesets.Catch.Tests/Editor/CatchEditorTestSceneContainer.cs
index 158c8edba5..78f56b4937 100644
--- a/osu.Game.Rulesets.Catch.Tests/Editor/CatchEditorTestSceneContainer.cs
+++ b/osu.Game.Rulesets.Catch.Tests/Editor/CatchEditorTestSceneContainer.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game.Rulesets.Catch.Tests/Editor/CatchPlacementBlueprintTestScene.cs b/osu.Game.Rulesets.Catch.Tests/Editor/CatchPlacementBlueprintTestScene.cs
index 1d30ae34cd..9060fa5aa0 100644
--- a/osu.Game.Rulesets.Catch.Tests/Editor/CatchPlacementBlueprintTestScene.cs
+++ b/osu.Game.Rulesets.Catch.Tests/Editor/CatchPlacementBlueprintTestScene.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using NUnit.Framework;
diff --git a/osu.Game.Rulesets.Catch.Tests/Editor/CatchSelectionBlueprintTestScene.cs b/osu.Game.Rulesets.Catch.Tests/Editor/CatchSelectionBlueprintTestScene.cs
index 88fd3b36ba..ea17fa400c 100644
--- a/osu.Game.Rulesets.Catch.Tests/Editor/CatchSelectionBlueprintTestScene.cs
+++ b/osu.Game.Rulesets.Catch.Tests/Editor/CatchSelectionBlueprintTestScene.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game.Rulesets.Catch.Tests/Editor/Checks/TestCheckBananaShowerGap.cs b/osu.Game.Rulesets.Catch.Tests/Editor/Checks/TestCheckBananaShowerGap.cs
index 055c8429d7..16361d12c6 100644
--- a/osu.Game.Rulesets.Catch.Tests/Editor/Checks/TestCheckBananaShowerGap.cs
+++ b/osu.Game.Rulesets.Catch.Tests/Editor/Checks/TestCheckBananaShowerGap.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Rulesets.Catch.Tests/Editor/TestSceneBananaShowerPlacementBlueprint.cs b/osu.Game.Rulesets.Catch.Tests/Editor/TestSceneBananaShowerPlacementBlueprint.cs
index fec253924f..d08acc90cd 100644
--- a/osu.Game.Rulesets.Catch.Tests/Editor/TestSceneBananaShowerPlacementBlueprint.cs
+++ b/osu.Game.Rulesets.Catch.Tests/Editor/TestSceneBananaShowerPlacementBlueprint.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Testing;
diff --git a/osu.Game.Rulesets.Catch.Tests/Editor/TestSceneCatchDistanceSnapGrid.cs b/osu.Game.Rulesets.Catch.Tests/Editor/TestSceneCatchDistanceSnapGrid.cs
index 2be0b7e9b2..405bab971c 100644
--- a/osu.Game.Rulesets.Catch.Tests/Editor/TestSceneCatchDistanceSnapGrid.cs
+++ b/osu.Game.Rulesets.Catch.Tests/Editor/TestSceneCatchDistanceSnapGrid.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game.Rulesets.Catch.Tests/Editor/TestSceneEditor.cs b/osu.Game.Rulesets.Catch.Tests/Editor/TestSceneEditor.cs
index 161c685043..9ecfd5f5c5 100644
--- a/osu.Game.Rulesets.Catch.Tests/Editor/TestSceneEditor.cs
+++ b/osu.Game.Rulesets.Catch.Tests/Editor/TestSceneEditor.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Game.Tests.Visual;
 
diff --git a/osu.Game.Rulesets.Catch.Tests/Editor/TestSceneFruitPlacementBlueprint.cs b/osu.Game.Rulesets.Catch.Tests/Editor/TestSceneFruitPlacementBlueprint.cs
index 4b1c45ae2f..94574b564d 100644
--- a/osu.Game.Rulesets.Catch.Tests/Editor/TestSceneFruitPlacementBlueprint.cs
+++ b/osu.Game.Rulesets.Catch.Tests/Editor/TestSceneFruitPlacementBlueprint.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Utils;
diff --git a/osu.Game.Rulesets.Catch.Tests/Editor/TestSceneJuiceStreamPlacementBlueprint.cs b/osu.Game.Rulesets.Catch.Tests/Editor/TestSceneJuiceStreamPlacementBlueprint.cs
index b1adc4901c..691ebc7efc 100644
--- a/osu.Game.Rulesets.Catch.Tests/Editor/TestSceneJuiceStreamPlacementBlueprint.cs
+++ b/osu.Game.Rulesets.Catch.Tests/Editor/TestSceneJuiceStreamPlacementBlueprint.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Rulesets.Catch.Tests/Editor/TestSceneJuiceStreamSelectionBlueprint.cs b/osu.Game.Rulesets.Catch.Tests/Editor/TestSceneJuiceStreamSelectionBlueprint.cs
index 22a839d847..8635a88d79 100644
--- a/osu.Game.Rulesets.Catch.Tests/Editor/TestSceneJuiceStreamSelectionBlueprint.cs
+++ b/osu.Game.Rulesets.Catch.Tests/Editor/TestSceneJuiceStreamSelectionBlueprint.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Rulesets.Catch.Tests/JuiceStreamPathTest.cs b/osu.Game.Rulesets.Catch.Tests/JuiceStreamPathTest.cs
index 5248d5a96a..54d26a0f3d 100644
--- a/osu.Game.Rulesets.Catch.Tests/JuiceStreamPathTest.cs
+++ b/osu.Game.Rulesets.Catch.Tests/JuiceStreamPathTest.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game.Rulesets.Catch.Tests/Mods/CatchModMirrorTest.cs b/osu.Game.Rulesets.Catch.Tests/Mods/CatchModMirrorTest.cs
index fbbfee6b60..19321a48b9 100644
--- a/osu.Game.Rulesets.Catch.Tests/Mods/CatchModMirrorTest.cs
+++ b/osu.Game.Rulesets.Catch.Tests/Mods/CatchModMirrorTest.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using NUnit.Framework;
 using osu.Framework.Utils;
diff --git a/osu.Game.Rulesets.Catch.Tests/Mods/TestSceneCatchModNoScope.cs b/osu.Game.Rulesets.Catch.Tests/Mods/TestSceneCatchModNoScope.cs
index bbe543e73e..ffc5734f01 100644
--- a/osu.Game.Rulesets.Catch.Tests/Mods/TestSceneCatchModNoScope.cs
+++ b/osu.Game.Rulesets.Catch.Tests/Mods/TestSceneCatchModNoScope.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using NUnit.Framework;
 using osu.Framework.Utils;
diff --git a/osu.Game.Rulesets.Catch.Tests/Mods/TestSceneCatchModPerfect.cs b/osu.Game.Rulesets.Catch.Tests/Mods/TestSceneCatchModPerfect.cs
index 3e06e78dba..886822f9a5 100644
--- a/osu.Game.Rulesets.Catch.Tests/Mods/TestSceneCatchModPerfect.cs
+++ b/osu.Game.Rulesets.Catch.Tests/Mods/TestSceneCatchModPerfect.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Game.Rulesets.Catch.Mods;
 using osu.Game.Rulesets.Catch.Objects;
diff --git a/osu.Game.Rulesets.Catch.Tests/Mods/TestSceneCatchModRelax.cs b/osu.Game.Rulesets.Catch.Tests/Mods/TestSceneCatchModRelax.cs
index c01aff0aa0..3209be12d5 100644
--- a/osu.Game.Rulesets.Catch.Tests/Mods/TestSceneCatchModRelax.cs
+++ b/osu.Game.Rulesets.Catch.Tests/Mods/TestSceneCatchModRelax.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Rulesets.Catch.Tests/TestSceneAutoJuiceStream.cs b/osu.Game.Rulesets.Catch.Tests/TestSceneAutoJuiceStream.cs
index 1014158fc1..202228c9e7 100644
--- a/osu.Game.Rulesets.Catch.Tests/TestSceneAutoJuiceStream.cs
+++ b/osu.Game.Rulesets.Catch.Tests/TestSceneAutoJuiceStream.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using osu.Game.Audio;
diff --git a/osu.Game.Rulesets.Catch.Tests/TestSceneBananaShower.cs b/osu.Game.Rulesets.Catch.Tests/TestSceneBananaShower.cs
index 96ac5c4bf2..0ddc58eb25 100644
--- a/osu.Game.Rulesets.Catch.Tests/TestSceneBananaShower.cs
+++ b/osu.Game.Rulesets.Catch.Tests/TestSceneBananaShower.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Catch.Objects;
diff --git a/osu.Game.Rulesets.Catch.Tests/TestSceneCatchModHidden.cs b/osu.Game.Rulesets.Catch.Tests/TestSceneCatchModHidden.cs
index 09362929d2..7e1c39f6a8 100644
--- a/osu.Game.Rulesets.Catch.Tests/TestSceneCatchModHidden.cs
+++ b/osu.Game.Rulesets.Catch.Tests/TestSceneCatchModHidden.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Rulesets.Catch.Tests/TestSceneCatchPlayer.cs b/osu.Game.Rulesets.Catch.Tests/TestSceneCatchPlayer.cs
index 31d0831fae..16942f3f35 100644
--- a/osu.Game.Rulesets.Catch.Tests/TestSceneCatchPlayer.cs
+++ b/osu.Game.Rulesets.Catch.Tests/TestSceneCatchPlayer.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Game.Tests.Visual;
 
diff --git a/osu.Game.Rulesets.Catch.Tests/TestSceneCatchPlayerLegacySkin.cs b/osu.Game.Rulesets.Catch.Tests/TestSceneCatchPlayerLegacySkin.cs
index b7cd6737b1..731cb4e135 100644
--- a/osu.Game.Rulesets.Catch.Tests/TestSceneCatchPlayerLegacySkin.cs
+++ b/osu.Game.Rulesets.Catch.Tests/TestSceneCatchPlayerLegacySkin.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Extensions.IEnumerableExtensions;
diff --git a/osu.Game.Rulesets.Catch.Tests/TestSceneCatchReplay.cs b/osu.Game.Rulesets.Catch.Tests/TestSceneCatchReplay.cs
index a10371b0f7..6e12dacf29 100644
--- a/osu.Game.Rulesets.Catch.Tests/TestSceneCatchReplay.cs
+++ b/osu.Game.Rulesets.Catch.Tests/TestSceneCatchReplay.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.ControlPoints;
diff --git a/osu.Game.Rulesets.Catch.Tests/TestSceneCatchSkinConfiguration.cs b/osu.Game.Rulesets.Catch.Tests/TestSceneCatchSkinConfiguration.cs
index 8ae2bcca0e..6ecbf58a52 100644
--- a/osu.Game.Rulesets.Catch.Tests/TestSceneCatchSkinConfiguration.cs
+++ b/osu.Game.Rulesets.Catch.Tests/TestSceneCatchSkinConfiguration.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Bindables;
diff --git a/osu.Game.Rulesets.Catch.Tests/TestSceneCatchStacker.cs b/osu.Game.Rulesets.Catch.Tests/TestSceneCatchStacker.cs
index 0a4ef49e19..1405e0018d 100644
--- a/osu.Game.Rulesets.Catch.Tests/TestSceneCatchStacker.cs
+++ b/osu.Game.Rulesets.Catch.Tests/TestSceneCatchStacker.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Catch.Objects;
diff --git a/osu.Game.Rulesets.Catch.Tests/TestSceneCatcher.cs b/osu.Game.Rulesets.Catch.Tests/TestSceneCatcher.cs
index 4f527e9a0f..956d0e0c14 100644
--- a/osu.Game.Rulesets.Catch.Tests/TestSceneCatcher.cs
+++ b/osu.Game.Rulesets.Catch.Tests/TestSceneCatcher.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game.Rulesets.Catch.Tests/TestSceneCatcherArea.cs b/osu.Game.Rulesets.Catch.Tests/TestSceneCatcherArea.cs
index 7cae9b18b9..150c1f8406 100644
--- a/osu.Game.Rulesets.Catch.Tests/TestSceneCatcherArea.cs
+++ b/osu.Game.Rulesets.Catch.Tests/TestSceneCatcherArea.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Rulesets.Catch.Tests/TestSceneComboCounter.cs b/osu.Game.Rulesets.Catch.Tests/TestSceneComboCounter.cs
index b720ab1e97..7f513728af 100644
--- a/osu.Game.Rulesets.Catch.Tests/TestSceneComboCounter.cs
+++ b/osu.Game.Rulesets.Catch.Tests/TestSceneComboCounter.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Rulesets.Catch.Tests/TestSceneDrawableHitObjects.cs b/osu.Game.Rulesets.Catch.Tests/TestSceneDrawableHitObjects.cs
index 4b8fede369..94c870a444 100644
--- a/osu.Game.Rulesets.Catch.Tests/TestSceneDrawableHitObjects.cs
+++ b/osu.Game.Rulesets.Catch.Tests/TestSceneDrawableHitObjects.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Rulesets.Catch.Tests/TestSceneDrawableHitObjectsHidden.cs b/osu.Game.Rulesets.Catch.Tests/TestSceneDrawableHitObjectsHidden.cs
index 62fe5dca2c..868f498e8c 100644
--- a/osu.Game.Rulesets.Catch.Tests/TestSceneDrawableHitObjectsHidden.cs
+++ b/osu.Game.Rulesets.Catch.Tests/TestSceneDrawableHitObjectsHidden.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Game.Rulesets.Catch.Mods;
 
diff --git a/osu.Game.Rulesets.Catch.Tests/TestSceneFruitObjects.cs b/osu.Game.Rulesets.Catch.Tests/TestSceneFruitObjects.cs
index 12b98dc93c..7d72633e34 100644
--- a/osu.Game.Rulesets.Catch.Tests/TestSceneFruitObjects.cs
+++ b/osu.Game.Rulesets.Catch.Tests/TestSceneFruitObjects.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game.Rulesets.Catch.Tests/TestSceneFruitRandomness.cs b/osu.Game.Rulesets.Catch.Tests/TestSceneFruitRandomness.cs
index c888dc0a65..c7d130b440 100644
--- a/osu.Game.Rulesets.Catch.Tests/TestSceneFruitRandomness.cs
+++ b/osu.Game.Rulesets.Catch.Tests/TestSceneFruitRandomness.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Game.Rulesets.Catch.Objects;
 using osu.Game.Rulesets.Catch.Objects.Drawables;
diff --git a/osu.Game.Rulesets.Catch.Tests/TestSceneFruitVisualChange.cs b/osu.Game.Rulesets.Catch.Tests/TestSceneFruitVisualChange.cs
index 9446e864a1..f7abd8d519 100644
--- a/osu.Game.Rulesets.Catch.Tests/TestSceneFruitVisualChange.cs
+++ b/osu.Game.Rulesets.Catch.Tests/TestSceneFruitVisualChange.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.
 
+#nullable disable
+
 using osu.Framework.Bindables;
 using osu.Game.Rulesets.Catch.Objects;
 using osu.Game.Rulesets.Catch.Objects.Drawables;
diff --git a/osu.Game.Rulesets.Catch.Tests/TestSceneHyperDash.cs b/osu.Game.Rulesets.Catch.Tests/TestSceneHyperDash.cs
index a5b44dc605..655edf7e08 100644
--- a/osu.Game.Rulesets.Catch.Tests/TestSceneHyperDash.cs
+++ b/osu.Game.Rulesets.Catch.Tests/TestSceneHyperDash.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Rulesets.Catch.Tests/TestSceneHyperDashColouring.cs b/osu.Game.Rulesets.Catch.Tests/TestSceneHyperDashColouring.cs
index 14a4d02396..cf49b7fe12 100644
--- a/osu.Game.Rulesets.Catch.Tests/TestSceneHyperDashColouring.cs
+++ b/osu.Game.Rulesets.Catch.Tests/TestSceneHyperDashColouring.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Rulesets.Catch.Tests/TestSceneJuiceStream.cs b/osu.Game.Rulesets.Catch.Tests/TestSceneJuiceStream.cs
index 4601234669..81589459c4 100644
--- a/osu.Game.Rulesets.Catch.Tests/TestSceneJuiceStream.cs
+++ b/osu.Game.Rulesets.Catch.Tests/TestSceneJuiceStream.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using NUnit.Framework;
 using osu.Game.Beatmaps;
diff --git a/osu.Game.Rulesets.Catch.Tests/TestSceneLegacyBeatmapSkin.cs b/osu.Game.Rulesets.Catch.Tests/TestSceneLegacyBeatmapSkin.cs
index bc3daca16f..786353bb00 100644
--- a/osu.Game.Rulesets.Catch.Tests/TestSceneLegacyBeatmapSkin.cs
+++ b/osu.Game.Rulesets.Catch.Tests/TestSceneLegacyBeatmapSkin.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Rulesets.Catch/Beatmaps/CatchBeatmap.cs b/osu.Game.Rulesets.Catch/Beatmaps/CatchBeatmap.cs
index f009c10a9c..ac39b91f00 100644
--- a/osu.Game.Rulesets.Catch/Beatmaps/CatchBeatmap.cs
+++ b/osu.Game.Rulesets.Catch/Beatmaps/CatchBeatmap.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using osu.Game.Beatmaps;
diff --git a/osu.Game.Rulesets.Catch/Beatmaps/CatchBeatmapConverter.cs b/osu.Game.Rulesets.Catch/Beatmaps/CatchBeatmapConverter.cs
index 7774a7da09..9f5d007114 100644
--- a/osu.Game.Rulesets.Catch/Beatmaps/CatchBeatmapConverter.cs
+++ b/osu.Game.Rulesets.Catch/Beatmaps/CatchBeatmapConverter.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.
 
+#nullable disable
+
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Catch.Objects;
 using System.Collections.Generic;
diff --git a/osu.Game.Rulesets.Catch/Beatmaps/CatchBeatmapProcessor.cs b/osu.Game.Rulesets.Catch/Beatmaps/CatchBeatmapProcessor.cs
index ab61b14ac4..835f7c2d27 100644
--- a/osu.Game.Rulesets.Catch/Beatmaps/CatchBeatmapProcessor.cs
+++ b/osu.Game.Rulesets.Catch/Beatmaps/CatchBeatmapProcessor.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game.Rulesets.Catch/CatchInputManager.cs b/osu.Game.Rulesets.Catch/CatchInputManager.cs
index 021d7a7efe..86f35c8cee 100644
--- a/osu.Game.Rulesets.Catch/CatchInputManager.cs
+++ b/osu.Game.Rulesets.Catch/CatchInputManager.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.
 
+#nullable disable
+
 using System.ComponentModel;
 using osu.Framework.Input.Bindings;
 using osu.Game.Rulesets.UI;
diff --git a/osu.Game.Rulesets.Catch/CatchRuleset.cs b/osu.Game.Rulesets.Catch/CatchRuleset.cs
index 80b9436b2c..f832d99807 100644
--- a/osu.Game.Rulesets.Catch/CatchRuleset.cs
+++ b/osu.Game.Rulesets.Catch/CatchRuleset.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.
 
+#nullable disable
+
 using osu.Game.Beatmaps;
 using osu.Game.Graphics;
 using osu.Game.Rulesets.Catch.Mods;
diff --git a/osu.Game.Rulesets.Catch/CatchSkinComponent.cs b/osu.Game.Rulesets.Catch/CatchSkinComponent.cs
index 8bf53e53e3..0fcdd34ca3 100644
--- a/osu.Game.Rulesets.Catch/CatchSkinComponent.cs
+++ b/osu.Game.Rulesets.Catch/CatchSkinComponent.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.
 
+#nullable disable
+
 using osu.Game.Skinning;
 
 namespace osu.Game.Rulesets.Catch
diff --git a/osu.Game.Rulesets.Catch/CatchSkinComponents.cs b/osu.Game.Rulesets.Catch/CatchSkinComponents.cs
index 371e901c69..7587de5803 100644
--- a/osu.Game.Rulesets.Catch/CatchSkinComponents.cs
+++ b/osu.Game.Rulesets.Catch/CatchSkinComponents.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.
 
+#nullable disable
+
 namespace osu.Game.Rulesets.Catch
 {
     public enum CatchSkinComponents
diff --git a/osu.Game.Rulesets.Catch/Difficulty/CatchDifficultyAttributes.cs b/osu.Game.Rulesets.Catch/Difficulty/CatchDifficultyAttributes.cs
index 8e069d7d16..9951d736c3 100644
--- a/osu.Game.Rulesets.Catch/Difficulty/CatchDifficultyAttributes.cs
+++ b/osu.Game.Rulesets.Catch/Difficulty/CatchDifficultyAttributes.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using Newtonsoft.Json;
 using osu.Game.Rulesets.Difficulty;
diff --git a/osu.Game.Rulesets.Catch/Difficulty/CatchDifficultyCalculator.cs b/osu.Game.Rulesets.Catch/Difficulty/CatchDifficultyCalculator.cs
index 8140ea6eaa..b64d860417 100644
--- a/osu.Game.Rulesets.Catch/Difficulty/CatchDifficultyCalculator.cs
+++ b/osu.Game.Rulesets.Catch/Difficulty/CatchDifficultyCalculator.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game.Rulesets.Catch/Difficulty/CatchPerformanceAttributes.cs b/osu.Game.Rulesets.Catch/Difficulty/CatchPerformanceAttributes.cs
index 1335fc2d23..ccdfd30200 100644
--- a/osu.Game.Rulesets.Catch/Difficulty/CatchPerformanceAttributes.cs
+++ b/osu.Game.Rulesets.Catch/Difficulty/CatchPerformanceAttributes.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Difficulty;
 
 namespace osu.Game.Rulesets.Catch.Difficulty
diff --git a/osu.Game.Rulesets.Catch/Difficulty/CatchPerformanceCalculator.cs b/osu.Game.Rulesets.Catch/Difficulty/CatchPerformanceCalculator.cs
index b30b85be2d..2a07b8019e 100644
--- a/osu.Game.Rulesets.Catch/Difficulty/CatchPerformanceCalculator.cs
+++ b/osu.Game.Rulesets.Catch/Difficulty/CatchPerformanceCalculator.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game.Rulesets.Catch/Difficulty/Preprocessing/CatchDifficultyHitObject.cs b/osu.Game.Rulesets.Catch/Difficulty/Preprocessing/CatchDifficultyHitObject.cs
index 3bcfce3a56..c44480776f 100644
--- a/osu.Game.Rulesets.Catch/Difficulty/Preprocessing/CatchDifficultyHitObject.cs
+++ b/osu.Game.Rulesets.Catch/Difficulty/Preprocessing/CatchDifficultyHitObject.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using osu.Game.Rulesets.Catch.Objects;
diff --git a/osu.Game.Rulesets.Catch/Difficulty/Skills/Movement.cs b/osu.Game.Rulesets.Catch/Difficulty/Skills/Movement.cs
index cfb3fe40be..827c28f7de 100644
--- a/osu.Game.Rulesets.Catch/Difficulty/Skills/Movement.cs
+++ b/osu.Game.Rulesets.Catch/Difficulty/Skills/Movement.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.
 
+#nullable disable
+
 using System;
 using osu.Game.Rulesets.Catch.Difficulty.Preprocessing;
 using osu.Game.Rulesets.Difficulty.Preprocessing;
diff --git a/osu.Game.Rulesets.Catch/Edit/BananaShowerCompositionTool.cs b/osu.Game.Rulesets.Catch/Edit/BananaShowerCompositionTool.cs
index 31075db7d1..e64a51f03a 100644
--- a/osu.Game.Rulesets.Catch/Edit/BananaShowerCompositionTool.cs
+++ b/osu.Game.Rulesets.Catch/Edit/BananaShowerCompositionTool.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Catch.Edit.Blueprints;
diff --git a/osu.Game.Rulesets.Catch/Edit/Blueprints/BananaShowerPlacementBlueprint.cs b/osu.Game.Rulesets.Catch/Edit/Blueprints/BananaShowerPlacementBlueprint.cs
index 039008f901..86fdf09a72 100644
--- a/osu.Game.Rulesets.Catch/Edit/Blueprints/BananaShowerPlacementBlueprint.cs
+++ b/osu.Game.Rulesets.Catch/Edit/Blueprints/BananaShowerPlacementBlueprint.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Input.Events;
 using osu.Game.Rulesets.Catch.Edit.Blueprints.Components;
diff --git a/osu.Game.Rulesets.Catch/Edit/Blueprints/BananaShowerSelectionBlueprint.cs b/osu.Game.Rulesets.Catch/Edit/Blueprints/BananaShowerSelectionBlueprint.cs
index 9132b1a9e8..7e4aca180c 100644
--- a/osu.Game.Rulesets.Catch/Edit/Blueprints/BananaShowerSelectionBlueprint.cs
+++ b/osu.Game.Rulesets.Catch/Edit/Blueprints/BananaShowerSelectionBlueprint.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Catch.Objects;
 
 namespace osu.Game.Rulesets.Catch.Edit.Blueprints
diff --git a/osu.Game.Rulesets.Catch/Edit/Blueprints/CatchPlacementBlueprint.cs b/osu.Game.Rulesets.Catch/Edit/Blueprints/CatchPlacementBlueprint.cs
index 5a32d241ad..8a1ced7eea 100644
--- a/osu.Game.Rulesets.Catch/Edit/Blueprints/CatchPlacementBlueprint.cs
+++ b/osu.Game.Rulesets.Catch/Edit/Blueprints/CatchPlacementBlueprint.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Game.Rulesets.Catch.Objects;
 using osu.Game.Rulesets.Edit;
diff --git a/osu.Game.Rulesets.Catch/Edit/Blueprints/CatchSelectionBlueprint.cs b/osu.Game.Rulesets.Catch/Edit/Blueprints/CatchSelectionBlueprint.cs
index 7e566c810c..e7c04cd132 100644
--- a/osu.Game.Rulesets.Catch/Edit/Blueprints/CatchSelectionBlueprint.cs
+++ b/osu.Game.Rulesets.Catch/Edit/Blueprints/CatchSelectionBlueprint.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Game.Rulesets.Catch.Objects;
 using osu.Game.Rulesets.Edit;
diff --git a/osu.Game.Rulesets.Catch/Edit/Blueprints/Components/EditablePath.cs b/osu.Game.Rulesets.Catch/Edit/Blueprints/Components/EditablePath.cs
index e038562b4b..44d14ec330 100644
--- a/osu.Game.Rulesets.Catch/Edit/Blueprints/Components/EditablePath.cs
+++ b/osu.Game.Rulesets.Catch/Edit/Blueprints/Components/EditablePath.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Diagnostics;
diff --git a/osu.Game.Rulesets.Catch/Edit/Blueprints/Components/FruitOutline.cs b/osu.Game.Rulesets.Catch/Edit/Blueprints/Components/FruitOutline.cs
index 0c03068e26..86006a99fc 100644
--- a/osu.Game.Rulesets.Catch/Edit/Blueprints/Components/FruitOutline.cs
+++ b/osu.Game.Rulesets.Catch/Edit/Blueprints/Components/FruitOutline.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game.Rulesets.Catch/Edit/Blueprints/Components/NestedOutlineContainer.cs b/osu.Game.Rulesets.Catch/Edit/Blueprints/Components/NestedOutlineContainer.cs
index cf916b27a4..431ba331ac 100644
--- a/osu.Game.Rulesets.Catch/Edit/Blueprints/Components/NestedOutlineContainer.cs
+++ b/osu.Game.Rulesets.Catch/Edit/Blueprints/Components/NestedOutlineContainer.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Rulesets.Catch/Edit/Blueprints/Components/PlacementEditablePath.cs b/osu.Game.Rulesets.Catch/Edit/Blueprints/Components/PlacementEditablePath.cs
index 511aec5e5d..27df064be4 100644
--- a/osu.Game.Rulesets.Catch/Edit/Blueprints/Components/PlacementEditablePath.cs
+++ b/osu.Game.Rulesets.Catch/Edit/Blueprints/Components/PlacementEditablePath.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.
 
+#nullable disable
+
 using System;
 using osu.Game.Rulesets.Catch.Objects;
 using osuTK;
diff --git a/osu.Game.Rulesets.Catch/Edit/Blueprints/Components/ScrollingPath.cs b/osu.Game.Rulesets.Catch/Edit/Blueprints/Components/ScrollingPath.cs
index cfaca2f9a4..3a62b07816 100644
--- a/osu.Game.Rulesets.Catch/Edit/Blueprints/Components/ScrollingPath.cs
+++ b/osu.Game.Rulesets.Catch/Edit/Blueprints/Components/ScrollingPath.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Rulesets.Catch/Edit/Blueprints/Components/SelectionEditablePath.cs b/osu.Game.Rulesets.Catch/Edit/Blueprints/Components/SelectionEditablePath.cs
index b4c353313c..4576e9f8ee 100644
--- a/osu.Game.Rulesets.Catch/Edit/Blueprints/Components/SelectionEditablePath.cs
+++ b/osu.Game.Rulesets.Catch/Edit/Blueprints/Components/SelectionEditablePath.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game.Rulesets.Catch/Edit/Blueprints/Components/TimeSpanOutline.cs b/osu.Game.Rulesets.Catch/Edit/Blueprints/Components/TimeSpanOutline.cs
index 65dfce0493..2586a81ef5 100644
--- a/osu.Game.Rulesets.Catch/Edit/Blueprints/Components/TimeSpanOutline.cs
+++ b/osu.Game.Rulesets.Catch/Edit/Blueprints/Components/TimeSpanOutline.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Rulesets.Catch/Edit/Blueprints/Components/VertexPiece.cs b/osu.Game.Rulesets.Catch/Edit/Blueprints/Components/VertexPiece.cs
index 5ef86b6074..236d27753a 100644
--- a/osu.Game.Rulesets.Catch/Edit/Blueprints/Components/VertexPiece.cs
+++ b/osu.Game.Rulesets.Catch/Edit/Blueprints/Components/VertexPiece.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Rulesets.Catch/Edit/Blueprints/Components/VertexState.cs b/osu.Game.Rulesets.Catch/Edit/Blueprints/Components/VertexState.cs
index 3f240c7944..1ddffc10a5 100644
--- a/osu.Game.Rulesets.Catch/Edit/Blueprints/Components/VertexState.cs
+++ b/osu.Game.Rulesets.Catch/Edit/Blueprints/Components/VertexState.cs
@@ -3,8 +3,6 @@
 
 using osu.Game.Rulesets.Catch.Objects;
 
-#nullable enable
-
 namespace osu.Game.Rulesets.Catch.Edit.Blueprints.Components
 {
     /// <summary>
diff --git a/osu.Game.Rulesets.Catch/Edit/Blueprints/FruitPlacementBlueprint.cs b/osu.Game.Rulesets.Catch/Edit/Blueprints/FruitPlacementBlueprint.cs
index e169e3b75c..686840ae55 100644
--- a/osu.Game.Rulesets.Catch/Edit/Blueprints/FruitPlacementBlueprint.cs
+++ b/osu.Game.Rulesets.Catch/Edit/Blueprints/FruitPlacementBlueprint.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.
 
+#nullable disable
+
 using osu.Framework.Input.Events;
 using osu.Game.Rulesets.Catch.Edit.Blueprints.Components;
 using osu.Game.Rulesets.Catch.Objects;
diff --git a/osu.Game.Rulesets.Catch/Edit/Blueprints/FruitSelectionBlueprint.cs b/osu.Game.Rulesets.Catch/Edit/Blueprints/FruitSelectionBlueprint.cs
index 150297badb..b5a25dbf62 100644
--- a/osu.Game.Rulesets.Catch/Edit/Blueprints/FruitSelectionBlueprint.cs
+++ b/osu.Game.Rulesets.Catch/Edit/Blueprints/FruitSelectionBlueprint.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Catch.Edit.Blueprints.Components;
 using osu.Game.Rulesets.Catch.Objects;
 
diff --git a/osu.Game.Rulesets.Catch/Edit/Blueprints/JuiceStreamPlacementBlueprint.cs b/osu.Game.Rulesets.Catch/Edit/Blueprints/JuiceStreamPlacementBlueprint.cs
index b5dcb62543..fcdd055b56 100644
--- a/osu.Game.Rulesets.Catch/Edit/Blueprints/JuiceStreamPlacementBlueprint.cs
+++ b/osu.Game.Rulesets.Catch/Edit/Blueprints/JuiceStreamPlacementBlueprint.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Input;
 using osu.Framework.Input.Events;
diff --git a/osu.Game.Rulesets.Catch/Edit/Blueprints/JuiceStreamSelectionBlueprint.cs b/osu.Game.Rulesets.Catch/Edit/Blueprints/JuiceStreamSelectionBlueprint.cs
index 12054a1d16..fc2b5e08fe 100644
--- a/osu.Game.Rulesets.Catch/Edit/Blueprints/JuiceStreamSelectionBlueprint.cs
+++ b/osu.Game.Rulesets.Catch/Edit/Blueprints/JuiceStreamSelectionBlueprint.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using JetBrains.Annotations;
diff --git a/osu.Game.Rulesets.Catch/Edit/CatchBeatmapVerifier.cs b/osu.Game.Rulesets.Catch/Edit/CatchBeatmapVerifier.cs
index c7a41a4e22..6570a19a92 100644
--- a/osu.Game.Rulesets.Catch/Edit/CatchBeatmapVerifier.cs
+++ b/osu.Game.Rulesets.Catch/Edit/CatchBeatmapVerifier.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using osu.Game.Rulesets.Catch.Edit.Checks;
diff --git a/osu.Game.Rulesets.Catch/Edit/CatchBlueprintContainer.cs b/osu.Game.Rulesets.Catch/Edit/CatchBlueprintContainer.cs
index 7f2782a474..58f493b4b8 100644
--- a/osu.Game.Rulesets.Catch/Edit/CatchBlueprintContainer.cs
+++ b/osu.Game.Rulesets.Catch/Edit/CatchBlueprintContainer.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Catch.Edit.Blueprints;
 using osu.Game.Rulesets.Catch.Objects;
 using osu.Game.Rulesets.Edit;
diff --git a/osu.Game.Rulesets.Catch/Edit/CatchDistanceSnapGrid.cs b/osu.Game.Rulesets.Catch/Edit/CatchDistanceSnapGrid.cs
index 9a78c7ff86..718c76abfc 100644
--- a/osu.Game.Rulesets.Catch/Edit/CatchDistanceSnapGrid.cs
+++ b/osu.Game.Rulesets.Catch/Edit/CatchDistanceSnapGrid.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game.Rulesets.Catch/Edit/CatchEditorPlayfield.cs b/osu.Game.Rulesets.Catch/Edit/CatchEditorPlayfield.cs
index 046ba0ebce..b9a875fe8a 100644
--- a/osu.Game.Rulesets.Catch/Edit/CatchEditorPlayfield.cs
+++ b/osu.Game.Rulesets.Catch/Edit/CatchEditorPlayfield.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.
 
+#nullable disable
+
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Catch.UI;
 
diff --git a/osu.Game.Rulesets.Catch/Edit/CatchHitObjectComposer.cs b/osu.Game.Rulesets.Catch/Edit/CatchHitObjectComposer.cs
index 6f59b3e543..01156ab021 100644
--- a/osu.Game.Rulesets.Catch/Edit/CatchHitObjectComposer.cs
+++ b/osu.Game.Rulesets.Catch/Edit/CatchHitObjectComposer.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using JetBrains.Annotations;
diff --git a/osu.Game.Rulesets.Catch/Edit/CatchHitObjectUtils.cs b/osu.Game.Rulesets.Catch/Edit/CatchHitObjectUtils.cs
index b059926668..4390234b59 100644
--- a/osu.Game.Rulesets.Catch/Edit/CatchHitObjectUtils.cs
+++ b/osu.Game.Rulesets.Catch/Edit/CatchHitObjectUtils.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using osu.Game.Rulesets.Catch.Objects;
diff --git a/osu.Game.Rulesets.Catch/Edit/CatchSelectionHandler.cs b/osu.Game.Rulesets.Catch/Edit/CatchSelectionHandler.cs
index dd5835b4ed..319cb1bfc9 100644
--- a/osu.Game.Rulesets.Catch/Edit/CatchSelectionHandler.cs
+++ b/osu.Game.Rulesets.Catch/Edit/CatchSelectionHandler.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game.Rulesets.Catch/Edit/Checks/CheckBananaShowerGap.cs b/osu.Game.Rulesets.Catch/Edit/Checks/CheckBananaShowerGap.cs
index 4b2933c0e1..00fd74c9a8 100644
--- a/osu.Game.Rulesets.Catch/Edit/Checks/CheckBananaShowerGap.cs
+++ b/osu.Game.Rulesets.Catch/Edit/Checks/CheckBananaShowerGap.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using osu.Game.Beatmaps;
diff --git a/osu.Game.Rulesets.Catch/Edit/DrawableCatchEditorRuleset.cs b/osu.Game.Rulesets.Catch/Edit/DrawableCatchEditorRuleset.cs
index 9a7528d90c..c81afafae5 100644
--- a/osu.Game.Rulesets.Catch/Edit/DrawableCatchEditorRuleset.cs
+++ b/osu.Game.Rulesets.Catch/Edit/DrawableCatchEditorRuleset.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Catch.UI;
diff --git a/osu.Game.Rulesets.Catch/Edit/FruitCompositionTool.cs b/osu.Game.Rulesets.Catch/Edit/FruitCompositionTool.cs
index f776fe39c1..5c13692b51 100644
--- a/osu.Game.Rulesets.Catch/Edit/FruitCompositionTool.cs
+++ b/osu.Game.Rulesets.Catch/Edit/FruitCompositionTool.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Catch.Edit.Blueprints;
diff --git a/osu.Game.Rulesets.Catch/Edit/JuiceStreamCompositionTool.cs b/osu.Game.Rulesets.Catch/Edit/JuiceStreamCompositionTool.cs
index cb66e2952e..85cf89f700 100644
--- a/osu.Game.Rulesets.Catch/Edit/JuiceStreamCompositionTool.cs
+++ b/osu.Game.Rulesets.Catch/Edit/JuiceStreamCompositionTool.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Catch.Edit.Blueprints;
diff --git a/osu.Game.Rulesets.Catch/Edit/PositionRange.cs b/osu.Game.Rulesets.Catch/Edit/PositionRange.cs
index e61603e5e6..482295a357 100644
--- a/osu.Game.Rulesets.Catch/Edit/PositionRange.cs
+++ b/osu.Game.Rulesets.Catch/Edit/PositionRange.cs
@@ -3,8 +3,6 @@
 
 using System;
 
-#nullable enable
-
 namespace osu.Game.Rulesets.Catch.Edit
 {
     /// <summary>
diff --git a/osu.Game.Rulesets.Catch/Judgements/CatchBananaJudgement.cs b/osu.Game.Rulesets.Catch/Judgements/CatchBananaJudgement.cs
index b919102215..15f6e4a64d 100644
--- a/osu.Game.Rulesets.Catch/Judgements/CatchBananaJudgement.cs
+++ b/osu.Game.Rulesets.Catch/Judgements/CatchBananaJudgement.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Judgements;
 using osu.Game.Rulesets.Scoring;
 
diff --git a/osu.Game.Rulesets.Catch/Judgements/CatchDropletJudgement.cs b/osu.Game.Rulesets.Catch/Judgements/CatchDropletJudgement.cs
index 8fd7b93e4c..90aa6f41a1 100644
--- a/osu.Game.Rulesets.Catch/Judgements/CatchDropletJudgement.cs
+++ b/osu.Game.Rulesets.Catch/Judgements/CatchDropletJudgement.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Scoring;
 
 namespace osu.Game.Rulesets.Catch.Judgements
diff --git a/osu.Game.Rulesets.Catch/Judgements/CatchJudgement.cs b/osu.Game.Rulesets.Catch/Judgements/CatchJudgement.cs
index ccafe0abc4..e5d6429660 100644
--- a/osu.Game.Rulesets.Catch/Judgements/CatchJudgement.cs
+++ b/osu.Game.Rulesets.Catch/Judgements/CatchJudgement.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Judgements;
 using osu.Game.Rulesets.Objects.Types;
 using osu.Game.Rulesets.Scoring;
diff --git a/osu.Game.Rulesets.Catch/Judgements/CatchJudgementResult.cs b/osu.Game.Rulesets.Catch/Judgements/CatchJudgementResult.cs
index c09355d59c..6cc79f9619 100644
--- a/osu.Game.Rulesets.Catch/Judgements/CatchJudgementResult.cs
+++ b/osu.Game.Rulesets.Catch/Judgements/CatchJudgementResult.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.
 
+#nullable disable
+
 using JetBrains.Annotations;
 using osu.Game.Rulesets.Catch.UI;
 using osu.Game.Rulesets.Judgements;
diff --git a/osu.Game.Rulesets.Catch/Judgements/CatchTinyDropletJudgement.cs b/osu.Game.Rulesets.Catch/Judgements/CatchTinyDropletJudgement.cs
index d957d4171b..c9052e3c39 100644
--- a/osu.Game.Rulesets.Catch/Judgements/CatchTinyDropletJudgement.cs
+++ b/osu.Game.Rulesets.Catch/Judgements/CatchTinyDropletJudgement.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Scoring;
 
 namespace osu.Game.Rulesets.Catch.Judgements
diff --git a/osu.Game.Rulesets.Catch/Mods/CatchModAutoplay.cs b/osu.Game.Rulesets.Catch/Mods/CatchModAutoplay.cs
index 50e48101d3..c5ca595fd6 100644
--- a/osu.Game.Rulesets.Catch/Mods/CatchModAutoplay.cs
+++ b/osu.Game.Rulesets.Catch/Mods/CatchModAutoplay.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Catch.Replays;
diff --git a/osu.Game.Rulesets.Catch/Mods/CatchModCinema.cs b/osu.Game.Rulesets.Catch/Mods/CatchModCinema.cs
index 7eda6b37d3..10a0809e05 100644
--- a/osu.Game.Rulesets.Catch/Mods/CatchModCinema.cs
+++ b/osu.Game.Rulesets.Catch/Mods/CatchModCinema.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Catch.Objects;
diff --git a/osu.Game.Rulesets.Catch/Mods/CatchModClassic.cs b/osu.Game.Rulesets.Catch/Mods/CatchModClassic.cs
index 9624e84018..904656993e 100644
--- a/osu.Game.Rulesets.Catch/Mods/CatchModClassic.cs
+++ b/osu.Game.Rulesets.Catch/Mods/CatchModClassic.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Mods;
 
 namespace osu.Game.Rulesets.Catch.Mods
diff --git a/osu.Game.Rulesets.Catch/Mods/CatchModDaycore.cs b/osu.Game.Rulesets.Catch/Mods/CatchModDaycore.cs
index cae19e9468..8d4b57c244 100644
--- a/osu.Game.Rulesets.Catch/Mods/CatchModDaycore.cs
+++ b/osu.Game.Rulesets.Catch/Mods/CatchModDaycore.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Mods;
 
 namespace osu.Game.Rulesets.Catch.Mods
diff --git a/osu.Game.Rulesets.Catch/Mods/CatchModDifficultyAdjust.cs b/osu.Game.Rulesets.Catch/Mods/CatchModDifficultyAdjust.cs
index e59a0a0431..6927d7953f 100644
--- a/osu.Game.Rulesets.Catch/Mods/CatchModDifficultyAdjust.cs
+++ b/osu.Game.Rulesets.Catch/Mods/CatchModDifficultyAdjust.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.
 
+#nullable disable
+
 using System.Linq;
 using osu.Framework.Bindables;
 using osu.Game.Beatmaps;
diff --git a/osu.Game.Rulesets.Catch/Mods/CatchModDoubleTime.cs b/osu.Game.Rulesets.Catch/Mods/CatchModDoubleTime.cs
index 178909387f..4db0a53005 100644
--- a/osu.Game.Rulesets.Catch/Mods/CatchModDoubleTime.cs
+++ b/osu.Game.Rulesets.Catch/Mods/CatchModDoubleTime.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Mods;
 
 namespace osu.Game.Rulesets.Catch.Mods
diff --git a/osu.Game.Rulesets.Catch/Mods/CatchModEasy.cs b/osu.Game.Rulesets.Catch/Mods/CatchModEasy.cs
index 16ef56d845..bea9b094fa 100644
--- a/osu.Game.Rulesets.Catch/Mods/CatchModEasy.cs
+++ b/osu.Game.Rulesets.Catch/Mods/CatchModEasy.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Mods;
 
 namespace osu.Game.Rulesets.Catch.Mods
diff --git a/osu.Game.Rulesets.Catch/Mods/CatchModFlashlight.cs b/osu.Game.Rulesets.Catch/Mods/CatchModFlashlight.cs
index d576ea3df8..e05932ca03 100644
--- a/osu.Game.Rulesets.Catch/Mods/CatchModFlashlight.cs
+++ b/osu.Game.Rulesets.Catch/Mods/CatchModFlashlight.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.
 
+#nullable disable
+
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Game.Configuration;
diff --git a/osu.Game.Rulesets.Catch/Mods/CatchModFloatingFruits.cs b/osu.Game.Rulesets.Catch/Mods/CatchModFloatingFruits.cs
index 63203dd57c..1fe892c9b5 100644
--- a/osu.Game.Rulesets.Catch/Mods/CatchModFloatingFruits.cs
+++ b/osu.Game.Rulesets.Catch/Mods/CatchModFloatingFruits.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Sprites;
 using osu.Game.Rulesets.Catch.Objects;
diff --git a/osu.Game.Rulesets.Catch/Mods/CatchModHalfTime.cs b/osu.Game.Rulesets.Catch/Mods/CatchModHalfTime.cs
index ce06b841aa..0c7886be10 100644
--- a/osu.Game.Rulesets.Catch/Mods/CatchModHalfTime.cs
+++ b/osu.Game.Rulesets.Catch/Mods/CatchModHalfTime.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Mods;
 
 namespace osu.Game.Rulesets.Catch.Mods
diff --git a/osu.Game.Rulesets.Catch/Mods/CatchModHardRock.cs b/osu.Game.Rulesets.Catch/Mods/CatchModHardRock.cs
index 68b6ce96a3..7db9bf2dfd 100644
--- a/osu.Game.Rulesets.Catch/Mods/CatchModHardRock.cs
+++ b/osu.Game.Rulesets.Catch/Mods/CatchModHardRock.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Mods;
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Catch.Beatmaps;
diff --git a/osu.Game.Rulesets.Catch/Mods/CatchModHidden.cs b/osu.Game.Rulesets.Catch/Mods/CatchModHidden.cs
index 4b6f79df88..c02eedf936 100644
--- a/osu.Game.Rulesets.Catch/Mods/CatchModHidden.cs
+++ b/osu.Game.Rulesets.Catch/Mods/CatchModHidden.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.
 
+#nullable disable
+
 using System.Linq;
 using osu.Framework.Graphics;
 using osu.Game.Rulesets.Catch.Objects;
diff --git a/osu.Game.Rulesets.Catch/Mods/CatchModMirror.cs b/osu.Game.Rulesets.Catch/Mods/CatchModMirror.cs
index a97e940a64..89fc40356d 100644
--- a/osu.Game.Rulesets.Catch/Mods/CatchModMirror.cs
+++ b/osu.Game.Rulesets.Catch/Mods/CatchModMirror.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.
 
+#nullable disable
+
 using System.Linq;
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Catch.Beatmaps;
diff --git a/osu.Game.Rulesets.Catch/Mods/CatchModMuted.cs b/osu.Game.Rulesets.Catch/Mods/CatchModMuted.cs
index 6d2565440a..6b28d1a127 100644
--- a/osu.Game.Rulesets.Catch/Mods/CatchModMuted.cs
+++ b/osu.Game.Rulesets.Catch/Mods/CatchModMuted.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Catch.Objects;
 using osu.Game.Rulesets.Mods;
 
diff --git a/osu.Game.Rulesets.Catch/Mods/CatchModNightcore.cs b/osu.Game.Rulesets.Catch/Mods/CatchModNightcore.cs
index c07087efaf..365d987794 100644
--- a/osu.Game.Rulesets.Catch/Mods/CatchModNightcore.cs
+++ b/osu.Game.Rulesets.Catch/Mods/CatchModNightcore.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Catch.Objects;
 using osu.Game.Rulesets.Mods;
 
diff --git a/osu.Game.Rulesets.Catch/Mods/CatchModNoFail.cs b/osu.Game.Rulesets.Catch/Mods/CatchModNoFail.cs
index 3c02646e99..89e7e4bcd6 100644
--- a/osu.Game.Rulesets.Catch/Mods/CatchModNoFail.cs
+++ b/osu.Game.Rulesets.Catch/Mods/CatchModNoFail.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Mods;
 
 namespace osu.Game.Rulesets.Catch.Mods
diff --git a/osu.Game.Rulesets.Catch/Mods/CatchModNoScope.cs b/osu.Game.Rulesets.Catch/Mods/CatchModNoScope.cs
index a24a6227fe..385d4c50c0 100644
--- a/osu.Game.Rulesets.Catch/Mods/CatchModNoScope.cs
+++ b/osu.Game.Rulesets.Catch/Mods/CatchModNoScope.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Bindables;
 using osu.Game.Rulesets.Mods;
diff --git a/osu.Game.Rulesets.Catch/Mods/CatchModPerfect.cs b/osu.Game.Rulesets.Catch/Mods/CatchModPerfect.cs
index fb92399102..0a74ee4fbb 100644
--- a/osu.Game.Rulesets.Catch/Mods/CatchModPerfect.cs
+++ b/osu.Game.Rulesets.Catch/Mods/CatchModPerfect.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Mods;
 
 namespace osu.Game.Rulesets.Catch.Mods
diff --git a/osu.Game.Rulesets.Catch/Mods/CatchModRelax.cs b/osu.Game.Rulesets.Catch/Mods/CatchModRelax.cs
index d0a94767d1..f4d6fb9ab3 100644
--- a/osu.Game.Rulesets.Catch/Mods/CatchModRelax.cs
+++ b/osu.Game.Rulesets.Catch/Mods/CatchModRelax.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Input;
 using osu.Framework.Input.Bindings;
diff --git a/osu.Game.Rulesets.Catch/Mods/CatchModSuddenDeath.cs b/osu.Game.Rulesets.Catch/Mods/CatchModSuddenDeath.cs
index 68e01391ce..d98829137c 100644
--- a/osu.Game.Rulesets.Catch/Mods/CatchModSuddenDeath.cs
+++ b/osu.Game.Rulesets.Catch/Mods/CatchModSuddenDeath.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Mods;
 
 namespace osu.Game.Rulesets.Catch.Mods
diff --git a/osu.Game.Rulesets.Catch/Objects/Banana.cs b/osu.Game.Rulesets.Catch/Objects/Banana.cs
index e5a36d08db..af03c9acab 100644
--- a/osu.Game.Rulesets.Catch/Objects/Banana.cs
+++ b/osu.Game.Rulesets.Catch/Objects/Banana.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 enable
-
 using System;
 using System.Collections.Generic;
 using osu.Game.Audio;
diff --git a/osu.Game.Rulesets.Catch/Objects/BananaShower.cs b/osu.Game.Rulesets.Catch/Objects/BananaShower.cs
index b45f95a8e6..e5541e49c1 100644
--- a/osu.Game.Rulesets.Catch/Objects/BananaShower.cs
+++ b/osu.Game.Rulesets.Catch/Objects/BananaShower.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.
 
+#nullable disable
+
 using System.Threading;
 using osu.Game.Rulesets.Judgements;
 using osu.Game.Rulesets.Objects.Types;
diff --git a/osu.Game.Rulesets.Catch/Objects/CatchHitObject.cs b/osu.Game.Rulesets.Catch/Objects/CatchHitObject.cs
index ee10cf9711..f5a3426305 100644
--- a/osu.Game.Rulesets.Catch/Objects/CatchHitObject.cs
+++ b/osu.Game.Rulesets.Catch/Objects/CatchHitObject.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.
 
+#nullable disable
+
 using Newtonsoft.Json;
 using osu.Framework.Bindables;
 using osu.Game.Beatmaps;
diff --git a/osu.Game.Rulesets.Catch/Objects/Drawables/CaughtBanana.cs b/osu.Game.Rulesets.Catch/Objects/Drawables/CaughtBanana.cs
index 8a91f82437..31a27b6047 100644
--- a/osu.Game.Rulesets.Catch/Objects/Drawables/CaughtBanana.cs
+++ b/osu.Game.Rulesets.Catch/Objects/Drawables/CaughtBanana.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Catch.Skinning.Default;
 
 namespace osu.Game.Rulesets.Catch.Objects.Drawables
diff --git a/osu.Game.Rulesets.Catch/Objects/Drawables/CaughtDroplet.cs b/osu.Game.Rulesets.Catch/Objects/Drawables/CaughtDroplet.cs
index 4a3397feff..6d5dd0ed25 100644
--- a/osu.Game.Rulesets.Catch/Objects/Drawables/CaughtDroplet.cs
+++ b/osu.Game.Rulesets.Catch/Objects/Drawables/CaughtDroplet.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Catch.Skinning.Default;
 
 namespace osu.Game.Rulesets.Catch.Objects.Drawables
diff --git a/osu.Game.Rulesets.Catch/Objects/Drawables/CaughtFruit.cs b/osu.Game.Rulesets.Catch/Objects/Drawables/CaughtFruit.cs
index 7c88090a20..89757748ab 100644
--- a/osu.Game.Rulesets.Catch/Objects/Drawables/CaughtFruit.cs
+++ b/osu.Game.Rulesets.Catch/Objects/Drawables/CaughtFruit.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Catch.Skinning.Default;
 
 namespace osu.Game.Rulesets.Catch.Objects.Drawables
diff --git a/osu.Game.Rulesets.Catch/Objects/Drawables/CaughtObject.cs b/osu.Game.Rulesets.Catch/Objects/Drawables/CaughtObject.cs
index d8bce9bb6d..fd0ffbd032 100644
--- a/osu.Game.Rulesets.Catch/Objects/Drawables/CaughtObject.cs
+++ b/osu.Game.Rulesets.Catch/Objects/Drawables/CaughtObject.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game.Rulesets.Catch/Objects/Drawables/DrawableBanana.cs b/osu.Game.Rulesets.Catch/Objects/Drawables/DrawableBanana.cs
index c1b41a7afc..b46a452bd0 100644
--- a/osu.Game.Rulesets.Catch/Objects/Drawables/DrawableBanana.cs
+++ b/osu.Game.Rulesets.Catch/Objects/Drawables/DrawableBanana.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.
 
+#nullable disable
+
 using JetBrains.Annotations;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Rulesets.Catch/Objects/Drawables/DrawableBananaShower.cs b/osu.Game.Rulesets.Catch/Objects/Drawables/DrawableBananaShower.cs
index 9b2f95e221..f061f206ff 100644
--- a/osu.Game.Rulesets.Catch/Objects/Drawables/DrawableBananaShower.cs
+++ b/osu.Game.Rulesets.Catch/Objects/Drawables/DrawableBananaShower.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.
 
+#nullable disable
+
 using JetBrains.Annotations;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game.Rulesets.Catch/Objects/Drawables/DrawableCatchHitObject.cs b/osu.Game.Rulesets.Catch/Objects/Drawables/DrawableCatchHitObject.cs
index 0c065948ef..23264edf3d 100644
--- a/osu.Game.Rulesets.Catch/Objects/Drawables/DrawableCatchHitObject.cs
+++ b/osu.Game.Rulesets.Catch/Objects/Drawables/DrawableCatchHitObject.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.
 
+#nullable disable
+
 using System;
 using JetBrains.Annotations;
 using osu.Framework.Bindables;
diff --git a/osu.Game.Rulesets.Catch/Objects/Drawables/DrawableDroplet.cs b/osu.Game.Rulesets.Catch/Objects/Drawables/DrawableDroplet.cs
index 2dce9507a5..d367ad0a00 100644
--- a/osu.Game.Rulesets.Catch/Objects/Drawables/DrawableDroplet.cs
+++ b/osu.Game.Rulesets.Catch/Objects/Drawables/DrawableDroplet.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.
 
+#nullable disable
+
 using JetBrains.Annotations;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Rulesets.Catch/Objects/Drawables/DrawableFruit.cs b/osu.Game.Rulesets.Catch/Objects/Drawables/DrawableFruit.cs
index 0af7ee6c30..ce4c7e5aff 100644
--- a/osu.Game.Rulesets.Catch/Objects/Drawables/DrawableFruit.cs
+++ b/osu.Game.Rulesets.Catch/Objects/Drawables/DrawableFruit.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.
 
+#nullable disable
+
 using JetBrains.Annotations;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Rulesets.Catch/Objects/Drawables/DrawableJuiceStream.cs b/osu.Game.Rulesets.Catch/Objects/Drawables/DrawableJuiceStream.cs
index a496a35842..12a44c909e 100644
--- a/osu.Game.Rulesets.Catch/Objects/Drawables/DrawableJuiceStream.cs
+++ b/osu.Game.Rulesets.Catch/Objects/Drawables/DrawableJuiceStream.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.
 
+#nullable disable
+
 using JetBrains.Annotations;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game.Rulesets.Catch/Objects/Drawables/DrawablePalpableCatchHitObject.cs b/osu.Game.Rulesets.Catch/Objects/Drawables/DrawablePalpableCatchHitObject.cs
index 27cd7ed2bc..5de372852b 100644
--- a/osu.Game.Rulesets.Catch/Objects/Drawables/DrawablePalpableCatchHitObject.cs
+++ b/osu.Game.Rulesets.Catch/Objects/Drawables/DrawablePalpableCatchHitObject.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.
 
+#nullable disable
+
 using JetBrains.Annotations;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game.Rulesets.Catch/Objects/Drawables/DrawableTinyDroplet.cs b/osu.Game.Rulesets.Catch/Objects/Drawables/DrawableTinyDroplet.cs
index 8f5a04dfda..8c48b62c7e 100644
--- a/osu.Game.Rulesets.Catch/Objects/Drawables/DrawableTinyDroplet.cs
+++ b/osu.Game.Rulesets.Catch/Objects/Drawables/DrawableTinyDroplet.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.
 
+#nullable disable
+
 using JetBrains.Annotations;
 
 namespace osu.Game.Rulesets.Catch.Objects.Drawables
diff --git a/osu.Game.Rulesets.Catch/Objects/Drawables/IHasCatchObjectState.cs b/osu.Game.Rulesets.Catch/Objects/Drawables/IHasCatchObjectState.cs
index be0ee2821e..93c80b09db 100644
--- a/osu.Game.Rulesets.Catch/Objects/Drawables/IHasCatchObjectState.cs
+++ b/osu.Game.Rulesets.Catch/Objects/Drawables/IHasCatchObjectState.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.
 
+#nullable disable
+
 using osu.Framework.Bindables;
 using osuTK;
 using osuTK.Graphics;
diff --git a/osu.Game.Rulesets.Catch/Objects/Droplet.cs b/osu.Game.Rulesets.Catch/Objects/Droplet.cs
index 9c1004a04b..ecaa4bfaf4 100644
--- a/osu.Game.Rulesets.Catch/Objects/Droplet.cs
+++ b/osu.Game.Rulesets.Catch/Objects/Droplet.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Catch.Judgements;
 using osu.Game.Rulesets.Judgements;
 
diff --git a/osu.Game.Rulesets.Catch/Objects/Fruit.cs b/osu.Game.Rulesets.Catch/Objects/Fruit.cs
index 4818fe2cad..bdf8b3f28d 100644
--- a/osu.Game.Rulesets.Catch/Objects/Fruit.cs
+++ b/osu.Game.Rulesets.Catch/Objects/Fruit.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Catch.Judgements;
 using osu.Game.Rulesets.Judgements;
 
diff --git a/osu.Game.Rulesets.Catch/Objects/FruitVisualRepresentation.cs b/osu.Game.Rulesets.Catch/Objects/FruitVisualRepresentation.cs
index 7ec7050245..e5d013dafc 100644
--- a/osu.Game.Rulesets.Catch/Objects/FruitVisualRepresentation.cs
+++ b/osu.Game.Rulesets.Catch/Objects/FruitVisualRepresentation.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.
 
+#nullable disable
+
 namespace osu.Game.Rulesets.Catch.Objects
 {
     public enum FruitVisualRepresentation
diff --git a/osu.Game.Rulesets.Catch/Objects/JuiceStream.cs b/osu.Game.Rulesets.Catch/Objects/JuiceStream.cs
index d34452cdbb..311e15116e 100644
--- a/osu.Game.Rulesets.Catch/Objects/JuiceStream.cs
+++ b/osu.Game.Rulesets.Catch/Objects/JuiceStream.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game.Rulesets.Catch/Objects/JuiceStreamPath.cs b/osu.Game.Rulesets.Catch/Objects/JuiceStreamPath.cs
index 61f4c580ae..0633151ddd 100644
--- a/osu.Game.Rulesets.Catch/Objects/JuiceStreamPath.cs
+++ b/osu.Game.Rulesets.Catch/Objects/JuiceStreamPath.cs
@@ -9,8 +9,6 @@ using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Objects.Types;
 using osuTK;
 
-#nullable enable
-
 namespace osu.Game.Rulesets.Catch.Objects
 {
     /// <summary>
diff --git a/osu.Game.Rulesets.Catch/Objects/JuiceStreamPathVertex.cs b/osu.Game.Rulesets.Catch/Objects/JuiceStreamPathVertex.cs
index afef2e637f..96ed82bca3 100644
--- a/osu.Game.Rulesets.Catch/Objects/JuiceStreamPathVertex.cs
+++ b/osu.Game.Rulesets.Catch/Objects/JuiceStreamPathVertex.cs
@@ -3,8 +3,6 @@
 
 using System;
 
-#nullable enable
-
 namespace osu.Game.Rulesets.Catch.Objects
 {
     /// <summary>
diff --git a/osu.Game.Rulesets.Catch/Objects/PalpableCatchHitObject.cs b/osu.Game.Rulesets.Catch/Objects/PalpableCatchHitObject.cs
index 4001a4ea76..1ededa1438 100644
--- a/osu.Game.Rulesets.Catch/Objects/PalpableCatchHitObject.cs
+++ b/osu.Game.Rulesets.Catch/Objects/PalpableCatchHitObject.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.
 
+#nullable disable
+
 using Newtonsoft.Json;
 using osu.Framework.Bindables;
 using osu.Game.Rulesets.Objects.Types;
diff --git a/osu.Game.Rulesets.Catch/Objects/TinyDroplet.cs b/osu.Game.Rulesets.Catch/Objects/TinyDroplet.cs
index 1bf160b5a6..6bd5f0ac2a 100644
--- a/osu.Game.Rulesets.Catch/Objects/TinyDroplet.cs
+++ b/osu.Game.Rulesets.Catch/Objects/TinyDroplet.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Catch.Judgements;
 using osu.Game.Rulesets.Judgements;
 
diff --git a/osu.Game.Rulesets.Catch/Properties/AssemblyInfo.cs b/osu.Game.Rulesets.Catch/Properties/AssemblyInfo.cs
index 26f20b223a..6c7f0478a7 100644
--- a/osu.Game.Rulesets.Catch/Properties/AssemblyInfo.cs
+++ b/osu.Game.Rulesets.Catch/Properties/AssemblyInfo.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.
 
+#nullable disable
+
 using System.Runtime.CompilerServices;
 
 // We publish our internal attributes to other sub-projects of the framework.
diff --git a/osu.Game.Rulesets.Catch/Replays/CatchAutoGenerator.cs b/osu.Game.Rulesets.Catch/Replays/CatchAutoGenerator.cs
index 7c84cb24f3..86c249a7c1 100644
--- a/osu.Game.Rulesets.Catch/Replays/CatchAutoGenerator.cs
+++ b/osu.Game.Rulesets.Catch/Replays/CatchAutoGenerator.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using osu.Framework.Utils;
diff --git a/osu.Game.Rulesets.Catch/Replays/CatchFramedReplayInputHandler.cs b/osu.Game.Rulesets.Catch/Replays/CatchFramedReplayInputHandler.cs
index b6af88a771..64a573149f 100644
--- a/osu.Game.Rulesets.Catch/Replays/CatchFramedReplayInputHandler.cs
+++ b/osu.Game.Rulesets.Catch/Replays/CatchFramedReplayInputHandler.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using osu.Framework.Input.StateChanges;
diff --git a/osu.Game.Rulesets.Catch/Replays/CatchReplayFrame.cs b/osu.Game.Rulesets.Catch/Replays/CatchReplayFrame.cs
index 1a80adb584..5cf03e4706 100644
--- a/osu.Game.Rulesets.Catch/Replays/CatchReplayFrame.cs
+++ b/osu.Game.Rulesets.Catch/Replays/CatchReplayFrame.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Game.Beatmaps;
 using osu.Game.Replays.Legacy;
diff --git a/osu.Game.Rulesets.Catch/Scoring/CatchScoreProcessor.cs b/osu.Game.Rulesets.Catch/Scoring/CatchScoreProcessor.cs
index 51b1ccaaba..ba3d529212 100644
--- a/osu.Game.Rulesets.Catch/Scoring/CatchScoreProcessor.cs
+++ b/osu.Game.Rulesets.Catch/Scoring/CatchScoreProcessor.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Scoring;
 
 namespace osu.Game.Rulesets.Catch.Scoring
diff --git a/osu.Game.Rulesets.Catch/Skinning/CatchSkinColour.cs b/osu.Game.Rulesets.Catch/Skinning/CatchSkinColour.cs
index 4506111498..d038ccb31c 100644
--- a/osu.Game.Rulesets.Catch/Skinning/CatchSkinColour.cs
+++ b/osu.Game.Rulesets.Catch/Skinning/CatchSkinColour.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.
 
+#nullable disable
+
 namespace osu.Game.Rulesets.Catch.Skinning
 {
     public enum CatchSkinColour
diff --git a/osu.Game.Rulesets.Catch/Skinning/CatchSkinConfiguration.cs b/osu.Game.Rulesets.Catch/Skinning/CatchSkinConfiguration.cs
index ea8d742b1a..65d6acd88d 100644
--- a/osu.Game.Rulesets.Catch/Skinning/CatchSkinConfiguration.cs
+++ b/osu.Game.Rulesets.Catch/Skinning/CatchSkinConfiguration.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.
 
+#nullable disable
+
 namespace osu.Game.Rulesets.Catch.Skinning
 {
     public enum CatchSkinConfiguration
diff --git a/osu.Game.Rulesets.Catch/Skinning/Default/BananaPiece.cs b/osu.Game.Rulesets.Catch/Skinning/Default/BananaPiece.cs
index 8da18a668a..27252594af 100644
--- a/osu.Game.Rulesets.Catch/Skinning/Default/BananaPiece.cs
+++ b/osu.Game.Rulesets.Catch/Skinning/Default/BananaPiece.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 
 namespace osu.Game.Rulesets.Catch.Skinning.Default
diff --git a/osu.Game.Rulesets.Catch/Skinning/Default/BananaPulpFormation.cs b/osu.Game.Rulesets.Catch/Skinning/Default/BananaPulpFormation.cs
index ee1cc68f7d..ffeed80615 100644
--- a/osu.Game.Rulesets.Catch/Skinning/Default/BananaPulpFormation.cs
+++ b/osu.Game.Rulesets.Catch/Skinning/Default/BananaPulpFormation.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.
 
+#nullable disable
+
 using osuTK;
 
 namespace osu.Game.Rulesets.Catch.Skinning.Default
diff --git a/osu.Game.Rulesets.Catch/Skinning/Default/BorderPiece.cs b/osu.Game.Rulesets.Catch/Skinning/Default/BorderPiece.cs
index 8d8ee49af7..60a13bee59 100644
--- a/osu.Game.Rulesets.Catch/Skinning/Default/BorderPiece.cs
+++ b/osu.Game.Rulesets.Catch/Skinning/Default/BorderPiece.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Shapes;
 using osu.Game.Rulesets.Catch.Objects;
diff --git a/osu.Game.Rulesets.Catch/Skinning/Default/CatchHitObjectPiece.cs b/osu.Game.Rulesets.Catch/Skinning/Default/CatchHitObjectPiece.cs
index 2db3bae034..6cc5220699 100644
--- a/osu.Game.Rulesets.Catch/Skinning/Default/CatchHitObjectPiece.cs
+++ b/osu.Game.Rulesets.Catch/Skinning/Default/CatchHitObjectPiece.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.
 
+#nullable disable
+
 using System;
 using JetBrains.Annotations;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Rulesets.Catch/Skinning/Default/DefaultCatcher.cs b/osu.Game.Rulesets.Catch/Skinning/Default/DefaultCatcher.cs
index e423f21b98..4148fed11c 100644
--- a/osu.Game.Rulesets.Catch/Skinning/Default/DefaultCatcher.cs
+++ b/osu.Game.Rulesets.Catch/Skinning/Default/DefaultCatcher.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game.Rulesets.Catch/Skinning/Default/DefaultHitExplosion.cs b/osu.Game.Rulesets.Catch/Skinning/Default/DefaultHitExplosion.cs
index f6b3c3d665..7ea99b3ed9 100644
--- a/osu.Game.Rulesets.Catch/Skinning/Default/DefaultHitExplosion.cs
+++ b/osu.Game.Rulesets.Catch/Skinning/Default/DefaultHitExplosion.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Rulesets.Catch/Skinning/Default/DropletPiece.cs b/osu.Game.Rulesets.Catch/Skinning/Default/DropletPiece.cs
index 8b1052dfe2..6b7f25eed1 100644
--- a/osu.Game.Rulesets.Catch/Skinning/Default/DropletPiece.cs
+++ b/osu.Game.Rulesets.Catch/Skinning/Default/DropletPiece.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Game.Rulesets.Catch.Objects;
 using osuTK;
diff --git a/osu.Game.Rulesets.Catch/Skinning/Default/FruitPiece.cs b/osu.Game.Rulesets.Catch/Skinning/Default/FruitPiece.cs
index cfe0df0c97..8fb5c8f84a 100644
--- a/osu.Game.Rulesets.Catch/Skinning/Default/FruitPiece.cs
+++ b/osu.Game.Rulesets.Catch/Skinning/Default/FruitPiece.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.
 
+#nullable disable
+
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Game.Rulesets.Catch.Objects;
diff --git a/osu.Game.Rulesets.Catch/Skinning/Default/FruitPulpFormation.cs b/osu.Game.Rulesets.Catch/Skinning/Default/FruitPulpFormation.cs
index f097361d2a..db51195f11 100644
--- a/osu.Game.Rulesets.Catch/Skinning/Default/FruitPulpFormation.cs
+++ b/osu.Game.Rulesets.Catch/Skinning/Default/FruitPulpFormation.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.
 
+#nullable disable
+
 using osu.Framework.Bindables;
 using osu.Game.Rulesets.Catch.Objects;
 using osuTK;
diff --git a/osu.Game.Rulesets.Catch/Skinning/Default/HyperBorderPiece.cs b/osu.Game.Rulesets.Catch/Skinning/Default/HyperBorderPiece.cs
index c8895f32f4..42b0b85495 100644
--- a/osu.Game.Rulesets.Catch/Skinning/Default/HyperBorderPiece.cs
+++ b/osu.Game.Rulesets.Catch/Skinning/Default/HyperBorderPiece.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Game.Rulesets.Catch.UI;
 
diff --git a/osu.Game.Rulesets.Catch/Skinning/Default/HyperDropletBorderPiece.cs b/osu.Game.Rulesets.Catch/Skinning/Default/HyperDropletBorderPiece.cs
index 53a487b97f..29cb339625 100644
--- a/osu.Game.Rulesets.Catch/Skinning/Default/HyperDropletBorderPiece.cs
+++ b/osu.Game.Rulesets.Catch/Skinning/Default/HyperDropletBorderPiece.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.
 
+#nullable disable
+
 namespace osu.Game.Rulesets.Catch.Skinning.Default
 {
     public class HyperDropletBorderPiece : HyperBorderPiece
diff --git a/osu.Game.Rulesets.Catch/Skinning/Default/Pulp.cs b/osu.Game.Rulesets.Catch/Skinning/Default/Pulp.cs
index 96c6233b41..8ea54617d9 100644
--- a/osu.Game.Rulesets.Catch/Skinning/Default/Pulp.cs
+++ b/osu.Game.Rulesets.Catch/Skinning/Default/Pulp.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.
 
+#nullable disable
+
 using osu.Framework.Bindables;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Rulesets.Catch/Skinning/Default/PulpFormation.cs b/osu.Game.Rulesets.Catch/Skinning/Default/PulpFormation.cs
index 8753aa4077..aa5ef5fb66 100644
--- a/osu.Game.Rulesets.Catch/Skinning/Default/PulpFormation.cs
+++ b/osu.Game.Rulesets.Catch/Skinning/Default/PulpFormation.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Rulesets.Catch/Skinning/Legacy/CatchLegacySkinTransformer.cs b/osu.Game.Rulesets.Catch/Skinning/Legacy/CatchLegacySkinTransformer.cs
index 04b522b404..c5e5e59dd2 100644
--- a/osu.Game.Rulesets.Catch/Skinning/Legacy/CatchLegacySkinTransformer.cs
+++ b/osu.Game.Rulesets.Catch/Skinning/Legacy/CatchLegacySkinTransformer.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.
 
+#nullable disable
+
 using System.Linq;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Rulesets.Catch/Skinning/Legacy/LegacyBananaPiece.cs b/osu.Game.Rulesets.Catch/Skinning/Legacy/LegacyBananaPiece.cs
index 5bd5b0d4bb..9f64a2129e 100644
--- a/osu.Game.Rulesets.Catch/Skinning/Legacy/LegacyBananaPiece.cs
+++ b/osu.Game.Rulesets.Catch/Skinning/Legacy/LegacyBananaPiece.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.
 
+#nullable disable
+
 using osu.Framework.Graphics.Textures;
 
 namespace osu.Game.Rulesets.Catch.Skinning.Legacy
diff --git a/osu.Game.Rulesets.Catch/Skinning/Legacy/LegacyCatchComboCounter.cs b/osu.Game.Rulesets.Catch/Skinning/Legacy/LegacyCatchComboCounter.cs
index b4d29988d9..b2dd29841b 100644
--- a/osu.Game.Rulesets.Catch/Skinning/Legacy/LegacyCatchComboCounter.cs
+++ b/osu.Game.Rulesets.Catch/Skinning/Legacy/LegacyCatchComboCounter.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Rulesets.Catch.UI;
diff --git a/osu.Game.Rulesets.Catch/Skinning/Legacy/LegacyCatchHitObjectPiece.cs b/osu.Game.Rulesets.Catch/Skinning/Legacy/LegacyCatchHitObjectPiece.cs
index f78724615a..5a5288105d 100644
--- a/osu.Game.Rulesets.Catch/Skinning/Legacy/LegacyCatchHitObjectPiece.cs
+++ b/osu.Game.Rulesets.Catch/Skinning/Legacy/LegacyCatchHitObjectPiece.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Rulesets.Catch/Skinning/Legacy/LegacyCatcherNew.cs b/osu.Game.Rulesets.Catch/Skinning/Legacy/LegacyCatcherNew.cs
index 9df87c92ea..93d79f00d3 100644
--- a/osu.Game.Rulesets.Catch/Skinning/Legacy/LegacyCatcherNew.cs
+++ b/osu.Game.Rulesets.Catch/Skinning/Legacy/LegacyCatcherNew.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game.Rulesets.Catch/Skinning/Legacy/LegacyCatcherOld.cs b/osu.Game.Rulesets.Catch/Skinning/Legacy/LegacyCatcherOld.cs
index 3e679171b2..736e9cfddf 100644
--- a/osu.Game.Rulesets.Catch/Skinning/Legacy/LegacyCatcherOld.cs
+++ b/osu.Game.Rulesets.Catch/Skinning/Legacy/LegacyCatcherOld.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game.Rulesets.Catch/Skinning/Legacy/LegacyDropletPiece.cs b/osu.Game.Rulesets.Catch/Skinning/Legacy/LegacyDropletPiece.cs
index 2c5cbe1e41..f99cedab3f 100644
--- a/osu.Game.Rulesets.Catch/Skinning/Legacy/LegacyDropletPiece.cs
+++ b/osu.Game.Rulesets.Catch/Skinning/Legacy/LegacyDropletPiece.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.
 
+#nullable disable
+
 using osu.Framework.Graphics.Textures;
 using osuTK;
 
diff --git a/osu.Game.Rulesets.Catch/Skinning/Legacy/LegacyFruitPiece.cs b/osu.Game.Rulesets.Catch/Skinning/Legacy/LegacyFruitPiece.cs
index f002bab219..125a96a446 100644
--- a/osu.Game.Rulesets.Catch/Skinning/Legacy/LegacyFruitPiece.cs
+++ b/osu.Game.Rulesets.Catch/Skinning/Legacy/LegacyFruitPiece.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Catch.Objects;
 
 namespace osu.Game.Rulesets.Catch.Skinning.Legacy
diff --git a/osu.Game.Rulesets.Catch/Skinning/Legacy/LegacyHitExplosion.cs b/osu.Game.Rulesets.Catch/Skinning/Legacy/LegacyHitExplosion.cs
index c262b0a4ac..0630de9156 100644
--- a/osu.Game.Rulesets.Catch/Skinning/Legacy/LegacyHitExplosion.cs
+++ b/osu.Game.Rulesets.Catch/Skinning/Legacy/LegacyHitExplosion.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Rulesets.Catch/UI/CatchComboDisplay.cs b/osu.Game.Rulesets.Catch/UI/CatchComboDisplay.cs
index ad344ff2dd..e9c289e46a 100644
--- a/osu.Game.Rulesets.Catch/UI/CatchComboDisplay.cs
+++ b/osu.Game.Rulesets.Catch/UI/CatchComboDisplay.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.
 
+#nullable disable
+
 using JetBrains.Annotations;
 using osu.Game.Rulesets.Catch.Objects.Drawables;
 using osu.Game.Rulesets.Judgements;
diff --git a/osu.Game.Rulesets.Catch/UI/CatchPlayfield.cs b/osu.Game.Rulesets.Catch/UI/CatchPlayfield.cs
index df32d917ce..dad22fbe69 100644
--- a/osu.Game.Rulesets.Catch/UI/CatchPlayfield.cs
+++ b/osu.Game.Rulesets.Catch/UI/CatchPlayfield.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Game.Beatmaps;
diff --git a/osu.Game.Rulesets.Catch/UI/CatchPlayfieldAdjustmentContainer.cs b/osu.Game.Rulesets.Catch/UI/CatchPlayfieldAdjustmentContainer.cs
index efc1b24ed5..82b85f54e4 100644
--- a/osu.Game.Rulesets.Catch/UI/CatchPlayfieldAdjustmentContainer.cs
+++ b/osu.Game.Rulesets.Catch/UI/CatchPlayfieldAdjustmentContainer.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Rulesets.UI;
diff --git a/osu.Game.Rulesets.Catch/UI/CatchReplayRecorder.cs b/osu.Game.Rulesets.Catch/UI/CatchReplayRecorder.cs
index a7879846df..c118c14e3f 100644
--- a/osu.Game.Rulesets.Catch/UI/CatchReplayRecorder.cs
+++ b/osu.Game.Rulesets.Catch/UI/CatchReplayRecorder.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Game.Rulesets.Catch.Replays;
 using osu.Game.Rulesets.Replays;
diff --git a/osu.Game.Rulesets.Catch/UI/Catcher.cs b/osu.Game.Rulesets.Catch/UI/Catcher.cs
index 04708c8796..6a3ec336d1 100644
--- a/osu.Game.Rulesets.Catch/UI/Catcher.cs
+++ b/osu.Game.Rulesets.Catch/UI/Catcher.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using JetBrains.Annotations;
diff --git a/osu.Game.Rulesets.Catch/UI/CatcherAnimationState.cs b/osu.Game.Rulesets.Catch/UI/CatcherAnimationState.cs
index 566e9d1911..82591eb47f 100644
--- a/osu.Game.Rulesets.Catch/UI/CatcherAnimationState.cs
+++ b/osu.Game.Rulesets.Catch/UI/CatcherAnimationState.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.
 
+#nullable disable
+
 namespace osu.Game.Rulesets.Catch.UI
 {
     public enum CatcherAnimationState
diff --git a/osu.Game.Rulesets.Catch/UI/CatcherArea.cs b/osu.Game.Rulesets.Catch/UI/CatcherArea.cs
index 37002d1051..a0279b5c83 100644
--- a/osu.Game.Rulesets.Catch/UI/CatcherArea.cs
+++ b/osu.Game.Rulesets.Catch/UI/CatcherArea.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game.Rulesets.Catch/UI/CatcherTrail.cs b/osu.Game.Rulesets.Catch/UI/CatcherTrail.cs
index 6d2ac7e488..afaa037574 100644
--- a/osu.Game.Rulesets.Catch/UI/CatcherTrail.cs
+++ b/osu.Game.Rulesets.Catch/UI/CatcherTrail.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Timing;
 using osu.Game.Rulesets.Objects.Pooling;
diff --git a/osu.Game.Rulesets.Catch/UI/CatcherTrailAnimation.cs b/osu.Game.Rulesets.Catch/UI/CatcherTrailAnimation.cs
index 0a5281cd10..02bc5be863 100644
--- a/osu.Game.Rulesets.Catch/UI/CatcherTrailAnimation.cs
+++ b/osu.Game.Rulesets.Catch/UI/CatcherTrailAnimation.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.
 
+#nullable disable
+
 namespace osu.Game.Rulesets.Catch.UI
 {
     public enum CatcherTrailAnimation
diff --git a/osu.Game.Rulesets.Catch/UI/CatcherTrailDisplay.cs b/osu.Game.Rulesets.Catch/UI/CatcherTrailDisplay.cs
index 0f2530e56a..6ab6a59293 100644
--- a/osu.Game.Rulesets.Catch/UI/CatcherTrailDisplay.cs
+++ b/osu.Game.Rulesets.Catch/UI/CatcherTrailDisplay.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Rulesets.Catch/UI/CatcherTrailEntry.cs b/osu.Game.Rulesets.Catch/UI/CatcherTrailEntry.cs
index 3a40ab26cc..78d6979b78 100644
--- a/osu.Game.Rulesets.Catch/UI/CatcherTrailEntry.cs
+++ b/osu.Game.Rulesets.Catch/UI/CatcherTrailEntry.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.
 
+#nullable disable
+
 using osu.Framework.Graphics.Performance;
 using osuTK;
 
diff --git a/osu.Game.Rulesets.Catch/UI/Direction.cs b/osu.Game.Rulesets.Catch/UI/Direction.cs
index 65f064b7fb..15e4aed86b 100644
--- a/osu.Game.Rulesets.Catch/UI/Direction.cs
+++ b/osu.Game.Rulesets.Catch/UI/Direction.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.
 
+#nullable disable
+
 namespace osu.Game.Rulesets.Catch.UI
 {
     public enum Direction
diff --git a/osu.Game.Rulesets.Catch/UI/DrawableCatchRuleset.cs b/osu.Game.Rulesets.Catch/UI/DrawableCatchRuleset.cs
index a8ec9f1d2f..b6cea92173 100644
--- a/osu.Game.Rulesets.Catch/UI/DrawableCatchRuleset.cs
+++ b/osu.Game.Rulesets.Catch/UI/DrawableCatchRuleset.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Framework.Input;
 using osu.Game.Beatmaps;
diff --git a/osu.Game.Rulesets.Catch/UI/DroppedObjectContainer.cs b/osu.Game.Rulesets.Catch/UI/DroppedObjectContainer.cs
index b44b0caae4..1e4da479d2 100644
--- a/osu.Game.Rulesets.Catch/UI/DroppedObjectContainer.cs
+++ b/osu.Game.Rulesets.Catch/UI/DroppedObjectContainer.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Rulesets.Catch.Objects.Drawables;
diff --git a/osu.Game.Rulesets.Catch/UI/HitExplosion.cs b/osu.Game.Rulesets.Catch/UI/HitExplosion.cs
index 955b1e6edb..1ea188d463 100644
--- a/osu.Game.Rulesets.Catch/UI/HitExplosion.cs
+++ b/osu.Game.Rulesets.Catch/UI/HitExplosion.cs
@@ -6,8 +6,6 @@ using osu.Game.Rulesets.Catch.Skinning.Default;
 using osu.Game.Rulesets.Objects.Pooling;
 using osu.Game.Skinning;
 
-#nullable enable
-
 namespace osu.Game.Rulesets.Catch.UI
 {
     public class HitExplosion : PoolableDrawableWithLifetime<HitExplosionEntry>
diff --git a/osu.Game.Rulesets.Catch/UI/HitExplosionContainer.cs b/osu.Game.Rulesets.Catch/UI/HitExplosionContainer.cs
index 6df13e52ef..2004c971ad 100644
--- a/osu.Game.Rulesets.Catch/UI/HitExplosionContainer.cs
+++ b/osu.Game.Rulesets.Catch/UI/HitExplosionContainer.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Pooling;
 using osu.Game.Rulesets.Objects.Pooling;
diff --git a/osu.Game.Rulesets.Catch/UI/HitExplosionEntry.cs b/osu.Game.Rulesets.Catch/UI/HitExplosionEntry.cs
index 88871c77f6..f265da149a 100644
--- a/osu.Game.Rulesets.Catch/UI/HitExplosionEntry.cs
+++ b/osu.Game.Rulesets.Catch/UI/HitExplosionEntry.cs
@@ -6,8 +6,6 @@ using osu.Game.Rulesets.Catch.Objects;
 using osu.Game.Rulesets.Judgements;
 using osuTK.Graphics;
 
-#nullable enable
-
 namespace osu.Game.Rulesets.Catch.UI
 {
     public class HitExplosionEntry : LifetimeEntry
diff --git a/osu.Game.Rulesets.Catch/UI/ICatchComboCounter.cs b/osu.Game.Rulesets.Catch/UI/ICatchComboCounter.cs
index cfb6879067..5d027edbaa 100644
--- a/osu.Game.Rulesets.Catch/UI/ICatchComboCounter.cs
+++ b/osu.Game.Rulesets.Catch/UI/ICatchComboCounter.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osuTK.Graphics;
 
diff --git a/osu.Game.Rulesets.Catch/UI/IHitExplosion.cs b/osu.Game.Rulesets.Catch/UI/IHitExplosion.cs
index c744c00d9a..4a9d7e8ac0 100644
--- a/osu.Game.Rulesets.Catch/UI/IHitExplosion.cs
+++ b/osu.Game.Rulesets.Catch/UI/IHitExplosion.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 enable
-
 namespace osu.Game.Rulesets.Catch.UI
 {
     /// <summary>
diff --git a/osu.Game.Rulesets.Catch/UI/SkinnableCatcher.cs b/osu.Game.Rulesets.Catch/UI/SkinnableCatcher.cs
index 8d707a4beb..25bbc814bf 100644
--- a/osu.Game.Rulesets.Catch/UI/SkinnableCatcher.cs
+++ b/osu.Game.Rulesets.Catch/UI/SkinnableCatcher.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Rulesets.Mania.Tests.Android/MainActivity.cs b/osu.Game.Rulesets.Mania.Tests.Android/MainActivity.cs
index 518071fd49..789fc9e22d 100644
--- a/osu.Game.Rulesets.Mania.Tests.Android/MainActivity.cs
+++ b/osu.Game.Rulesets.Mania.Tests.Android/MainActivity.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.
 
+#nullable disable
+
 using Android.App;
 using osu.Framework.Android;
 using osu.Game.Tests;
diff --git a/osu.Game.Rulesets.Mania.Tests.iOS/AppDelegate.cs b/osu.Game.Rulesets.Mania.Tests.iOS/AppDelegate.cs
index 9cd1e47023..a528634f3b 100644
--- a/osu.Game.Rulesets.Mania.Tests.iOS/AppDelegate.cs
+++ b/osu.Game.Rulesets.Mania.Tests.iOS/AppDelegate.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.
 
+#nullable disable
+
 using Foundation;
 using osu.Framework.iOS;
 using osu.Game.Tests;
diff --git a/osu.Game.Rulesets.Mania.Tests.iOS/Application.cs b/osu.Game.Rulesets.Mania.Tests.iOS/Application.cs
index ec3db17e97..2d1015387a 100644
--- a/osu.Game.Rulesets.Mania.Tests.iOS/Application.cs
+++ b/osu.Game.Rulesets.Mania.Tests.iOS/Application.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.
 
+#nullable disable
+
 using osu.Framework.iOS;
 using UIKit;
 
diff --git a/osu.Game.Rulesets.Mania.Tests/Editor/ManiaPlacementBlueprintTestScene.cs b/osu.Game.Rulesets.Mania.Tests/Editor/ManiaPlacementBlueprintTestScene.cs
index 94f385bbf1..6e6e83f9cf 100644
--- a/osu.Game.Rulesets.Mania.Tests/Editor/ManiaPlacementBlueprintTestScene.cs
+++ b/osu.Game.Rulesets.Mania.Tests/Editor/ManiaPlacementBlueprintTestScene.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Rulesets.Mania.Tests/Editor/ManiaSelectionBlueprintTestScene.cs b/osu.Game.Rulesets.Mania.Tests/Editor/ManiaSelectionBlueprintTestScene.cs
index 124e1a35f9..679a15e8cb 100644
--- a/osu.Game.Rulesets.Mania.Tests/Editor/ManiaSelectionBlueprintTestScene.cs
+++ b/osu.Game.Rulesets.Mania.Tests/Editor/ManiaSelectionBlueprintTestScene.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneEditor.cs b/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneEditor.cs
index 5300747633..99850f33b8 100644
--- a/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneEditor.cs
+++ b/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneEditor.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneHoldNotePlacementBlueprint.cs b/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneHoldNotePlacementBlueprint.cs
index 87c74a12cf..ddec1f3432 100644
--- a/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneHoldNotePlacementBlueprint.cs
+++ b/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneHoldNotePlacementBlueprint.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Edit;
 using osu.Game.Rulesets.Mania.Edit.Blueprints;
 using osu.Game.Rulesets.Mania.Objects;
diff --git a/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneHoldNoteSelectionBlueprint.cs b/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneHoldNoteSelectionBlueprint.cs
index 9953b8e3c0..b70d4e4fa6 100644
--- a/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneHoldNoteSelectionBlueprint.cs
+++ b/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneHoldNoteSelectionBlueprint.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.
 
+#nullable disable
+
 using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.ControlPoints;
 using osu.Game.Rulesets.Mania.Edit.Blueprints;
diff --git a/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneManiaBeatSnapGrid.cs b/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneManiaBeatSnapGrid.cs
index 6130a80bb4..ec96205067 100644
--- a/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneManiaBeatSnapGrid.cs
+++ b/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneManiaBeatSnapGrid.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneManiaComposeScreen.cs b/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneManiaComposeScreen.cs
index 746bdae02e..15b38b39ba 100644
--- a/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneManiaComposeScreen.cs
+++ b/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneManiaComposeScreen.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneManiaHitObjectComposer.cs b/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneManiaHitObjectComposer.cs
index 9788dfe844..4ad27348fc 100644
--- a/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneManiaHitObjectComposer.cs
+++ b/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneManiaHitObjectComposer.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneNotePlacementBlueprint.cs b/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneNotePlacementBlueprint.cs
index a162c5ec44..28c002eef8 100644
--- a/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneNotePlacementBlueprint.cs
+++ b/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneNotePlacementBlueprint.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Extensions.IEnumerableExtensions;
diff --git a/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneNoteSelectionBlueprint.cs b/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneNoteSelectionBlueprint.cs
index 3586eecc44..f61d416e3b 100644
--- a/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneNoteSelectionBlueprint.cs
+++ b/osu.Game.Rulesets.Mania.Tests/Editor/TestSceneNoteSelectionBlueprint.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.
 
+#nullable disable
+
 using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.ControlPoints;
 using osu.Game.Rulesets.Mania.Edit.Blueprints;
diff --git a/osu.Game.Rulesets.Mania.Tests/ManiaBeatmapConversionTest.cs b/osu.Game.Rulesets.Mania.Tests/ManiaBeatmapConversionTest.cs
index 837474ad9e..ef6dca620a 100644
--- a/osu.Game.Rulesets.Mania.Tests/ManiaBeatmapConversionTest.cs
+++ b/osu.Game.Rulesets.Mania.Tests/ManiaBeatmapConversionTest.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using NUnit.Framework;
diff --git a/osu.Game.Rulesets.Mania.Tests/ManiaBeatmapSampleConversionTest.cs b/osu.Game.Rulesets.Mania.Tests/ManiaBeatmapSampleConversionTest.cs
index 9c690f360a..51f35d3c3d 100644
--- a/osu.Game.Rulesets.Mania.Tests/ManiaBeatmapSampleConversionTest.cs
+++ b/osu.Game.Rulesets.Mania.Tests/ManiaBeatmapSampleConversionTest.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game.Rulesets.Mania.Tests/ManiaColumnTypeTest.cs b/osu.Game.Rulesets.Mania.Tests/ManiaColumnTypeTest.cs
index 66fe6d8cc5..e53deb5269 100644
--- a/osu.Game.Rulesets.Mania.Tests/ManiaColumnTypeTest.cs
+++ b/osu.Game.Rulesets.Mania.Tests/ManiaColumnTypeTest.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Game.Rulesets.Mania.Beatmaps;
 using NUnit.Framework;
diff --git a/osu.Game.Rulesets.Mania.Tests/ManiaDifficultyCalculatorTest.cs b/osu.Game.Rulesets.Mania.Tests/ManiaDifficultyCalculatorTest.cs
index a5bd126782..9e4db1f1c9 100644
--- a/osu.Game.Rulesets.Mania.Tests/ManiaDifficultyCalculatorTest.cs
+++ b/osu.Game.Rulesets.Mania.Tests/ManiaDifficultyCalculatorTest.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Difficulty;
diff --git a/osu.Game.Rulesets.Mania.Tests/ManiaInputTestScene.cs b/osu.Game.Rulesets.Mania.Tests/ManiaInputTestScene.cs
index 9049bb3a82..eb380c07a6 100644
--- a/osu.Game.Rulesets.Mania.Tests/ManiaInputTestScene.cs
+++ b/osu.Game.Rulesets.Mania.Tests/ManiaInputTestScene.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Input.Bindings;
diff --git a/osu.Game.Rulesets.Mania.Tests/ManiaLegacyModConversionTest.cs b/osu.Game.Rulesets.Mania.Tests/ManiaLegacyModConversionTest.cs
index a28c188051..accae29ffe 100644
--- a/osu.Game.Rulesets.Mania.Tests/ManiaLegacyModConversionTest.cs
+++ b/osu.Game.Rulesets.Mania.Tests/ManiaLegacyModConversionTest.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.
 
+#nullable disable
+
 using System;
 using NUnit.Framework;
 using osu.Game.Beatmaps.Legacy;
diff --git a/osu.Game.Rulesets.Mania.Tests/ManiaLegacyReplayTest.cs b/osu.Game.Rulesets.Mania.Tests/ManiaLegacyReplayTest.cs
index 40bb83aece..b64006316e 100644
--- a/osu.Game.Rulesets.Mania.Tests/ManiaLegacyReplayTest.cs
+++ b/osu.Game.Rulesets.Mania.Tests/ManiaLegacyReplayTest.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Game.Rulesets.Mania.Beatmaps;
 using osu.Game.Rulesets.Mania.Replays;
diff --git a/osu.Game.Rulesets.Mania.Tests/Mods/TestSceneManiaModConstantSpeed.cs b/osu.Game.Rulesets.Mania.Tests/Mods/TestSceneManiaModConstantSpeed.cs
index 60363aaeef..538c8b13d1 100644
--- a/osu.Game.Rulesets.Mania.Tests/Mods/TestSceneManiaModConstantSpeed.cs
+++ b/osu.Game.Rulesets.Mania.Tests/Mods/TestSceneManiaModConstantSpeed.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Rulesets.Mania.Tests/Mods/TestSceneManiaModHoldOff.cs b/osu.Game.Rulesets.Mania.Tests/Mods/TestSceneManiaModHoldOff.cs
index 7970d5b594..4222be0359 100644
--- a/osu.Game.Rulesets.Mania.Tests/Mods/TestSceneManiaModHoldOff.cs
+++ b/osu.Game.Rulesets.Mania.Tests/Mods/TestSceneManiaModHoldOff.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Game.Beatmaps;
diff --git a/osu.Game.Rulesets.Mania.Tests/Mods/TestSceneManiaModInvert.cs b/osu.Game.Rulesets.Mania.Tests/Mods/TestSceneManiaModInvert.cs
index f2cc254e38..4c97f65b07 100644
--- a/osu.Game.Rulesets.Mania.Tests/Mods/TestSceneManiaModInvert.cs
+++ b/osu.Game.Rulesets.Mania.Tests/Mods/TestSceneManiaModInvert.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Game.Rulesets.Mania.Mods;
 using osu.Game.Tests.Visual;
diff --git a/osu.Game.Rulesets.Mania.Tests/Mods/TestSceneManiaModPerfect.cs b/osu.Game.Rulesets.Mania.Tests/Mods/TestSceneManiaModPerfect.cs
index 2e3b21aed7..9612543483 100644
--- a/osu.Game.Rulesets.Mania.Tests/Mods/TestSceneManiaModPerfect.cs
+++ b/osu.Game.Rulesets.Mania.Tests/Mods/TestSceneManiaModPerfect.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Game.Rulesets.Mania.Mods;
 using osu.Game.Rulesets.Mania.Objects;
diff --git a/osu.Game.Rulesets.Mania.Tests/Skinning/ColumnTestContainer.cs b/osu.Game.Rulesets.Mania.Tests/Skinning/ColumnTestContainer.cs
index 8ba58e3af3..1a3513d46c 100644
--- a/osu.Game.Rulesets.Mania.Tests/Skinning/ColumnTestContainer.cs
+++ b/osu.Game.Rulesets.Mania.Tests/Skinning/ColumnTestContainer.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game.Rulesets.Mania.Tests/Skinning/ManiaHitObjectTestScene.cs b/osu.Game.Rulesets.Mania.Tests/Skinning/ManiaHitObjectTestScene.cs
index 68cf3b67df..fd82041ad8 100644
--- a/osu.Game.Rulesets.Mania.Tests/Skinning/ManiaHitObjectTestScene.cs
+++ b/osu.Game.Rulesets.Mania.Tests/Skinning/ManiaHitObjectTestScene.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game.Rulesets.Mania.Tests/Skinning/ManiaSkinnableTestScene.cs b/osu.Game.Rulesets.Mania.Tests/Skinning/ManiaSkinnableTestScene.cs
index ddfd057cd8..9f235689b4 100644
--- a/osu.Game.Rulesets.Mania.Tests/Skinning/ManiaSkinnableTestScene.cs
+++ b/osu.Game.Rulesets.Mania.Tests/Skinning/ManiaSkinnableTestScene.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game.Rulesets.Mania.Tests/Skinning/TestSceneColumnBackground.cs b/osu.Game.Rulesets.Mania.Tests/Skinning/TestSceneColumnBackground.cs
index 106b2d188d..cd26e2a9de 100644
--- a/osu.Game.Rulesets.Mania.Tests/Skinning/TestSceneColumnBackground.cs
+++ b/osu.Game.Rulesets.Mania.Tests/Skinning/TestSceneColumnBackground.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game.Rulesets.Mania.Tests/Skinning/TestSceneColumnHitObjectArea.cs b/osu.Game.Rulesets.Mania.Tests/Skinning/TestSceneColumnHitObjectArea.cs
index 8034341d15..1fb9d448a9 100644
--- a/osu.Game.Rulesets.Mania.Tests/Skinning/TestSceneColumnHitObjectArea.cs
+++ b/osu.Game.Rulesets.Mania.Tests/Skinning/TestSceneColumnHitObjectArea.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game.Rulesets.Mania.Tests/Skinning/TestSceneDrawableJudgement.cs b/osu.Game.Rulesets.Mania.Tests/Skinning/TestSceneDrawableJudgement.cs
index d033676ec7..8b12d37fe9 100644
--- a/osu.Game.Rulesets.Mania.Tests/Skinning/TestSceneDrawableJudgement.cs
+++ b/osu.Game.Rulesets.Mania.Tests/Skinning/TestSceneDrawableJudgement.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using osu.Framework.Extensions;
diff --git a/osu.Game.Rulesets.Mania.Tests/Skinning/TestSceneHitExplosion.cs b/osu.Game.Rulesets.Mania.Tests/Skinning/TestSceneHitExplosion.cs
index 9e6e0a7776..744721f1a3 100644
--- a/osu.Game.Rulesets.Mania.Tests/Skinning/TestSceneHitExplosion.cs
+++ b/osu.Game.Rulesets.Mania.Tests/Skinning/TestSceneHitExplosion.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Rulesets.Mania.Tests/Skinning/TestSceneHoldNote.cs b/osu.Game.Rulesets.Mania.Tests/Skinning/TestSceneHoldNote.cs
index e88ff8e2ac..0947ddfeb0 100644
--- a/osu.Game.Rulesets.Mania.Tests/Skinning/TestSceneHoldNote.cs
+++ b/osu.Game.Rulesets.Mania.Tests/Skinning/TestSceneHoldNote.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Rulesets.Mania.Tests/Skinning/TestSceneKeyArea.cs b/osu.Game.Rulesets.Mania.Tests/Skinning/TestSceneKeyArea.cs
index 7564bd84ad..bbbd7edb7b 100644
--- a/osu.Game.Rulesets.Mania.Tests/Skinning/TestSceneKeyArea.cs
+++ b/osu.Game.Rulesets.Mania.Tests/Skinning/TestSceneKeyArea.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game.Rulesets.Mania.Tests/Skinning/TestSceneNote.cs b/osu.Game.Rulesets.Mania.Tests/Skinning/TestSceneNote.cs
index bc3bdf0bcb..85995e6994 100644
--- a/osu.Game.Rulesets.Mania.Tests/Skinning/TestSceneNote.cs
+++ b/osu.Game.Rulesets.Mania.Tests/Skinning/TestSceneNote.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.
 
+#nullable disable
+
 using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.ControlPoints;
 using osu.Game.Rulesets.Mania.Objects;
diff --git a/osu.Game.Rulesets.Mania.Tests/Skinning/TestScenePlayfield.cs b/osu.Game.Rulesets.Mania.Tests/Skinning/TestScenePlayfield.cs
index c7dc5fc8b5..62dadbc3dd 100644
--- a/osu.Game.Rulesets.Mania.Tests/Skinning/TestScenePlayfield.cs
+++ b/osu.Game.Rulesets.Mania.Tests/Skinning/TestScenePlayfield.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using NUnit.Framework;
 using osu.Game.Beatmaps;
diff --git a/osu.Game.Rulesets.Mania.Tests/Skinning/TestSceneStage.cs b/osu.Game.Rulesets.Mania.Tests/Skinning/TestSceneStage.cs
index 7804261906..f3f1b9416f 100644
--- a/osu.Game.Rulesets.Mania.Tests/Skinning/TestSceneStage.cs
+++ b/osu.Game.Rulesets.Mania.Tests/Skinning/TestSceneStage.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Game.Rulesets.Mania.Beatmaps;
 using osu.Game.Rulesets.Mania.UI;
diff --git a/osu.Game.Rulesets.Mania.Tests/Skinning/TestSceneStageBackground.cs b/osu.Game.Rulesets.Mania.Tests/Skinning/TestSceneStageBackground.cs
index 410a43fc73..687b3a747d 100644
--- a/osu.Game.Rulesets.Mania.Tests/Skinning/TestSceneStageBackground.cs
+++ b/osu.Game.Rulesets.Mania.Tests/Skinning/TestSceneStageBackground.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Game.Rulesets.Mania.Beatmaps;
diff --git a/osu.Game.Rulesets.Mania.Tests/Skinning/TestSceneStageForeground.cs b/osu.Game.Rulesets.Mania.Tests/Skinning/TestSceneStageForeground.cs
index 27e97152bc..6cbc172755 100644
--- a/osu.Game.Rulesets.Mania.Tests/Skinning/TestSceneStageForeground.cs
+++ b/osu.Game.Rulesets.Mania.Tests/Skinning/TestSceneStageForeground.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Game.Rulesets.Mania.Beatmaps;
diff --git a/osu.Game.Rulesets.Mania.Tests/TestSceneAutoGeneration.cs b/osu.Game.Rulesets.Mania.Tests/TestSceneAutoGeneration.cs
index cffec3dfd5..21ec85bbe6 100644
--- a/osu.Game.Rulesets.Mania.Tests/TestSceneAutoGeneration.cs
+++ b/osu.Game.Rulesets.Mania.Tests/TestSceneAutoGeneration.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Testing;
diff --git a/osu.Game.Rulesets.Mania.Tests/TestSceneColumn.cs b/osu.Game.Rulesets.Mania.Tests/TestSceneColumn.cs
index d9b1ad22fa..2922d18713 100644
--- a/osu.Game.Rulesets.Mania.Tests/TestSceneColumn.cs
+++ b/osu.Game.Rulesets.Mania.Tests/TestSceneColumn.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using NUnit.Framework;
diff --git a/osu.Game.Rulesets.Mania.Tests/TestSceneDrawableManiaHitObject.cs b/osu.Game.Rulesets.Mania.Tests/TestSceneDrawableManiaHitObject.cs
index 92c95b8fde..223f8dae44 100644
--- a/osu.Game.Rulesets.Mania.Tests/TestSceneDrawableManiaHitObject.cs
+++ b/osu.Game.Rulesets.Mania.Tests/TestSceneDrawableManiaHitObject.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Graphics;
 using osu.Framework.Input.Events;
diff --git a/osu.Game.Rulesets.Mania.Tests/TestSceneHoldNoteInput.cs b/osu.Game.Rulesets.Mania.Tests/TestSceneHoldNoteInput.cs
index f973cb5ed3..8f776ff507 100644
--- a/osu.Game.Rulesets.Mania.Tests/TestSceneHoldNoteInput.cs
+++ b/osu.Game.Rulesets.Mania.Tests/TestSceneHoldNoteInput.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Rulesets.Mania.Tests/TestSceneManiaHitObjectSamples.cs b/osu.Game.Rulesets.Mania.Tests/TestSceneManiaHitObjectSamples.cs
index ea57e51d1c..00f0fcefd9 100644
--- a/osu.Game.Rulesets.Mania.Tests/TestSceneManiaHitObjectSamples.cs
+++ b/osu.Game.Rulesets.Mania.Tests/TestSceneManiaHitObjectSamples.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.
 
+#nullable disable
+
 using System.Reflection;
 using NUnit.Framework;
 using osu.Framework.IO.Stores;
diff --git a/osu.Game.Rulesets.Mania.Tests/TestSceneManiaPlayer.cs b/osu.Game.Rulesets.Mania.Tests/TestSceneManiaPlayer.cs
index a399b90585..9abedc22f9 100644
--- a/osu.Game.Rulesets.Mania.Tests/TestSceneManiaPlayer.cs
+++ b/osu.Game.Rulesets.Mania.Tests/TestSceneManiaPlayer.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.
 
+#nullable disable
+
 using osu.Game.Tests.Visual;
 
 namespace osu.Game.Rulesets.Mania.Tests
diff --git a/osu.Game.Rulesets.Mania.Tests/TestSceneNotes.cs b/osu.Game.Rulesets.Mania.Tests/TestSceneNotes.cs
index 706268e478..df831d8c9f 100644
--- a/osu.Game.Rulesets.Mania.Tests/TestSceneNotes.cs
+++ b/osu.Game.Rulesets.Mania.Tests/TestSceneNotes.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Rulesets.Mania.Tests/TestSceneOutOfOrderHits.cs b/osu.Game.Rulesets.Mania.Tests/TestSceneOutOfOrderHits.cs
index 89e13acad6..a563dc3106 100644
--- a/osu.Game.Rulesets.Mania.Tests/TestSceneOutOfOrderHits.cs
+++ b/osu.Game.Rulesets.Mania.Tests/TestSceneOutOfOrderHits.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game.Rulesets.Mania.Tests/TestScenePlayfieldCoveringContainer.cs b/osu.Game.Rulesets.Mania.Tests/TestScenePlayfieldCoveringContainer.cs
index 8698ba3abd..64e7eafb1b 100644
--- a/osu.Game.Rulesets.Mania.Tests/TestScenePlayfieldCoveringContainer.cs
+++ b/osu.Game.Rulesets.Mania.Tests/TestScenePlayfieldCoveringContainer.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Shapes;
diff --git a/osu.Game.Rulesets.Mania.Tests/TestSceneStage.cs b/osu.Game.Rulesets.Mania.Tests/TestSceneStage.cs
index 7376a90f17..cf8947c1ed 100644
--- a/osu.Game.Rulesets.Mania.Tests/TestSceneStage.cs
+++ b/osu.Game.Rulesets.Mania.Tests/TestSceneStage.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game.Rulesets.Mania.Tests/TestSceneTimingBasedNoteColouring.cs b/osu.Game.Rulesets.Mania.Tests/TestSceneTimingBasedNoteColouring.cs
index 4c688520ef..e84d02775a 100644
--- a/osu.Game.Rulesets.Mania.Tests/TestSceneTimingBasedNoteColouring.cs
+++ b/osu.Game.Rulesets.Mania.Tests/TestSceneTimingBasedNoteColouring.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Rulesets.Mania/Beatmaps/ColumnType.cs b/osu.Game.Rulesets.Mania/Beatmaps/ColumnType.cs
index 8f904530bc..0114987e3c 100644
--- a/osu.Game.Rulesets.Mania/Beatmaps/ColumnType.cs
+++ b/osu.Game.Rulesets.Mania/Beatmaps/ColumnType.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.
 
+#nullable disable
+
 namespace osu.Game.Rulesets.Mania.Beatmaps
 {
     public enum ColumnType
diff --git a/osu.Game.Rulesets.Mania/Beatmaps/ManiaBeatmap.cs b/osu.Game.Rulesets.Mania/Beatmaps/ManiaBeatmap.cs
index 0058f6f884..4879ce6748 100644
--- a/osu.Game.Rulesets.Mania/Beatmaps/ManiaBeatmap.cs
+++ b/osu.Game.Rulesets.Mania/Beatmaps/ManiaBeatmap.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using osu.Game.Beatmaps;
diff --git a/osu.Game.Rulesets.Mania/Beatmaps/ManiaBeatmapConverter.cs b/osu.Game.Rulesets.Mania/Beatmaps/ManiaBeatmapConverter.cs
index 207c6907c8..2b4f497785 100644
--- a/osu.Game.Rulesets.Mania/Beatmaps/ManiaBeatmapConverter.cs
+++ b/osu.Game.Rulesets.Mania/Beatmaps/ManiaBeatmapConverter.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Mania.Objects;
 using System;
 using System.Linq;
diff --git a/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Legacy/DistanceObjectPatternGenerator.cs b/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Legacy/DistanceObjectPatternGenerator.cs
index dafe65f415..2bdd0e16ad 100644
--- a/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Legacy/DistanceObjectPatternGenerator.cs
+++ b/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Legacy/DistanceObjectPatternGenerator.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Diagnostics;
diff --git a/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Legacy/EndTimeObjectPatternGenerator.cs b/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Legacy/EndTimeObjectPatternGenerator.cs
index 2265d3d347..630fdf7ae2 100644
--- a/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Legacy/EndTimeObjectPatternGenerator.cs
+++ b/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Legacy/EndTimeObjectPatternGenerator.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Objects.Types;
diff --git a/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Legacy/HitObjectPatternGenerator.cs b/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Legacy/HitObjectPatternGenerator.cs
index 41d4c9322b..912cac4fe4 100644
--- a/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Legacy/HitObjectPatternGenerator.cs
+++ b/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Legacy/HitObjectPatternGenerator.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Legacy/PatternGenerator.cs b/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Legacy/PatternGenerator.cs
index d5689c047a..308238d87a 100644
--- a/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Legacy/PatternGenerator.cs
+++ b/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Legacy/PatternGenerator.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using JetBrains.Annotations;
diff --git a/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Legacy/PatternType.cs b/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Legacy/PatternType.cs
index e4a28167ec..bf54dc3179 100644
--- a/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Legacy/PatternType.cs
+++ b/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Legacy/PatternType.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.
 
+#nullable disable
+
 using System;
 
 namespace osu.Game.Rulesets.Mania.Beatmaps.Patterns.Legacy
diff --git a/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Pattern.cs b/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Pattern.cs
index 828f2ec393..4b3902657f 100644
--- a/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Pattern.cs
+++ b/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Pattern.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using osu.Game.Rulesets.Mania.Objects;
diff --git a/osu.Game.Rulesets.Mania/Beatmaps/Patterns/PatternGenerator.cs b/osu.Game.Rulesets.Mania/Beatmaps/Patterns/PatternGenerator.cs
index 71b3f6ecf2..b2e89c3410 100644
--- a/osu.Game.Rulesets.Mania/Beatmaps/Patterns/PatternGenerator.cs
+++ b/osu.Game.Rulesets.Mania/Beatmaps/Patterns/PatternGenerator.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using osu.Game.Rulesets.Objects;
diff --git a/osu.Game.Rulesets.Mania/Beatmaps/StageDefinition.cs b/osu.Game.Rulesets.Mania/Beatmaps/StageDefinition.cs
index 3052fc7d34..54e2d4686f 100644
--- a/osu.Game.Rulesets.Mania/Beatmaps/StageDefinition.cs
+++ b/osu.Game.Rulesets.Mania/Beatmaps/StageDefinition.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.
 
+#nullable disable
+
 using System;
 using osu.Game.Rulesets.Mania.UI;
 
diff --git a/osu.Game.Rulesets.Mania/Configuration/ManiaRulesetConfigManager.cs b/osu.Game.Rulesets.Mania/Configuration/ManiaRulesetConfigManager.cs
index 8e09a01469..35ad21442e 100644
--- a/osu.Game.Rulesets.Mania/Configuration/ManiaRulesetConfigManager.cs
+++ b/osu.Game.Rulesets.Mania/Configuration/ManiaRulesetConfigManager.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Configuration.Tracking;
 using osu.Game.Configuration;
diff --git a/osu.Game.Rulesets.Mania/Difficulty/ManiaDifficultyAttributes.cs b/osu.Game.Rulesets.Mania/Difficulty/ManiaDifficultyAttributes.cs
index c35a3dcdc2..8a5161be79 100644
--- a/osu.Game.Rulesets.Mania/Difficulty/ManiaDifficultyAttributes.cs
+++ b/osu.Game.Rulesets.Mania/Difficulty/ManiaDifficultyAttributes.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using Newtonsoft.Json;
 using osu.Game.Rulesets.Difficulty;
diff --git a/osu.Game.Rulesets.Mania/Difficulty/ManiaDifficultyCalculator.cs b/osu.Game.Rulesets.Mania/Difficulty/ManiaDifficultyCalculator.cs
index e90feaf4b4..8002410f70 100644
--- a/osu.Game.Rulesets.Mania/Difficulty/ManiaDifficultyCalculator.cs
+++ b/osu.Game.Rulesets.Mania/Difficulty/ManiaDifficultyCalculator.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game.Rulesets.Mania/Difficulty/ManiaPerformanceAttributes.cs b/osu.Game.Rulesets.Mania/Difficulty/ManiaPerformanceAttributes.cs
index 17c864a268..f5abb465c4 100644
--- a/osu.Game.Rulesets.Mania/Difficulty/ManiaPerformanceAttributes.cs
+++ b/osu.Game.Rulesets.Mania/Difficulty/ManiaPerformanceAttributes.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using Newtonsoft.Json;
 using osu.Game.Rulesets.Difficulty;
diff --git a/osu.Game.Rulesets.Mania/Difficulty/ManiaPerformanceCalculator.cs b/osu.Game.Rulesets.Mania/Difficulty/ManiaPerformanceCalculator.cs
index b347cc9ae2..eb58eb7f21 100644
--- a/osu.Game.Rulesets.Mania/Difficulty/ManiaPerformanceCalculator.cs
+++ b/osu.Game.Rulesets.Mania/Difficulty/ManiaPerformanceCalculator.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game.Rulesets.Mania/Difficulty/Preprocessing/ManiaDifficultyHitObject.cs b/osu.Game.Rulesets.Mania/Difficulty/Preprocessing/ManiaDifficultyHitObject.cs
index 1c4204145b..df95654319 100644
--- a/osu.Game.Rulesets.Mania/Difficulty/Preprocessing/ManiaDifficultyHitObject.cs
+++ b/osu.Game.Rulesets.Mania/Difficulty/Preprocessing/ManiaDifficultyHitObject.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Game.Rulesets.Difficulty.Preprocessing;
 using osu.Game.Rulesets.Mania.Objects;
diff --git a/osu.Game.Rulesets.Mania/Difficulty/Skills/Strain.cs b/osu.Game.Rulesets.Mania/Difficulty/Skills/Strain.cs
index 626f1bebbd..c2e532430c 100644
--- a/osu.Game.Rulesets.Mania/Difficulty/Skills/Strain.cs
+++ b/osu.Game.Rulesets.Mania/Difficulty/Skills/Strain.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Utils;
 using osu.Game.Rulesets.Difficulty.Preprocessing;
diff --git a/osu.Game.Rulesets.Mania/DualStageVariantGenerator.cs b/osu.Game.Rulesets.Mania/DualStageVariantGenerator.cs
index 8d39e08b26..262247e244 100644
--- a/osu.Game.Rulesets.Mania/DualStageVariantGenerator.cs
+++ b/osu.Game.Rulesets.Mania/DualStageVariantGenerator.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using osu.Framework.Input.Bindings;
diff --git a/osu.Game.Rulesets.Mania/Edit/Blueprints/Components/EditBodyPiece.cs b/osu.Game.Rulesets.Mania/Edit/Blueprints/Components/EditBodyPiece.cs
index f5067ea366..52995b73f4 100644
--- a/osu.Game.Rulesets.Mania/Edit/Blueprints/Components/EditBodyPiece.cs
+++ b/osu.Game.Rulesets.Mania/Edit/Blueprints/Components/EditBodyPiece.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Game.Graphics;
diff --git a/osu.Game.Rulesets.Mania/Edit/Blueprints/Components/EditNotePiece.cs b/osu.Game.Rulesets.Mania/Edit/Blueprints/Components/EditNotePiece.cs
index 9c9273de3a..23475ef924 100644
--- a/osu.Game.Rulesets.Mania/Edit/Blueprints/Components/EditNotePiece.cs
+++ b/osu.Game.Rulesets.Mania/Edit/Blueprints/Components/EditNotePiece.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Graphics;
diff --git a/osu.Game.Rulesets.Mania/Edit/Blueprints/HoldNotePlacementBlueprint.cs b/osu.Game.Rulesets.Mania/Edit/Blueprints/HoldNotePlacementBlueprint.cs
index 093a8da24f..7c720b30aa 100644
--- a/osu.Game.Rulesets.Mania/Edit/Blueprints/HoldNotePlacementBlueprint.cs
+++ b/osu.Game.Rulesets.Mania/Edit/Blueprints/HoldNotePlacementBlueprint.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Rulesets.Mania/Edit/Blueprints/HoldNoteSelectionBlueprint.cs b/osu.Game.Rulesets.Mania/Edit/Blueprints/HoldNoteSelectionBlueprint.cs
index 35889aea0c..f76f170af0 100644
--- a/osu.Game.Rulesets.Mania/Edit/Blueprints/HoldNoteSelectionBlueprint.cs
+++ b/osu.Game.Rulesets.Mania/Edit/Blueprints/HoldNoteSelectionBlueprint.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game.Rulesets.Mania/Edit/Blueprints/ManiaPlacementBlueprint.cs b/osu.Game.Rulesets.Mania/Edit/Blueprints/ManiaPlacementBlueprint.cs
index 7a99565e8a..7c7c802111 100644
--- a/osu.Game.Rulesets.Mania/Edit/Blueprints/ManiaPlacementBlueprint.cs
+++ b/osu.Game.Rulesets.Mania/Edit/Blueprints/ManiaPlacementBlueprint.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Input.Events;
 using osu.Game.Rulesets.Edit;
diff --git a/osu.Game.Rulesets.Mania/Edit/Blueprints/ManiaSelectionBlueprint.cs b/osu.Game.Rulesets.Mania/Edit/Blueprints/ManiaSelectionBlueprint.cs
index 955336db57..5aa3b44f0d 100644
--- a/osu.Game.Rulesets.Mania/Edit/Blueprints/ManiaSelectionBlueprint.cs
+++ b/osu.Game.Rulesets.Mania/Edit/Blueprints/ManiaSelectionBlueprint.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Game.Rulesets.Edit;
diff --git a/osu.Game.Rulesets.Mania/Edit/Blueprints/NotePlacementBlueprint.cs b/osu.Game.Rulesets.Mania/Edit/Blueprints/NotePlacementBlueprint.cs
index 3db89c8ae6..e3cb830b80 100644
--- a/osu.Game.Rulesets.Mania/Edit/Blueprints/NotePlacementBlueprint.cs
+++ b/osu.Game.Rulesets.Mania/Edit/Blueprints/NotePlacementBlueprint.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Input.Events;
 using osu.Game.Rulesets.Edit;
diff --git a/osu.Game.Rulesets.Mania/Edit/Blueprints/NoteSelectionBlueprint.cs b/osu.Game.Rulesets.Mania/Edit/Blueprints/NoteSelectionBlueprint.cs
index e7a03905d2..929fdc29e0 100644
--- a/osu.Game.Rulesets.Mania/Edit/Blueprints/NoteSelectionBlueprint.cs
+++ b/osu.Game.Rulesets.Mania/Edit/Blueprints/NoteSelectionBlueprint.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Game.Rulesets.Mania.Edit.Blueprints.Components;
 using osu.Game.Rulesets.Mania.Objects;
diff --git a/osu.Game.Rulesets.Mania/Edit/DrawableManiaEditorRuleset.cs b/osu.Game.Rulesets.Mania/Edit/DrawableManiaEditorRuleset.cs
index b0af8c503b..a3a9591964 100644
--- a/osu.Game.Rulesets.Mania/Edit/DrawableManiaEditorRuleset.cs
+++ b/osu.Game.Rulesets.Mania/Edit/DrawableManiaEditorRuleset.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Framework.Graphics;
 using osuTK;
diff --git a/osu.Game.Rulesets.Mania/Edit/HoldNoteCompositionTool.cs b/osu.Game.Rulesets.Mania/Edit/HoldNoteCompositionTool.cs
index a5f10ed436..960a08eeeb 100644
--- a/osu.Game.Rulesets.Mania/Edit/HoldNoteCompositionTool.cs
+++ b/osu.Game.Rulesets.Mania/Edit/HoldNoteCompositionTool.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Edit;
diff --git a/osu.Game.Rulesets.Mania/Edit/ManiaBeatSnapGrid.cs b/osu.Game.Rulesets.Mania/Edit/ManiaBeatSnapGrid.cs
index 1aa20f4737..b0019d8b6e 100644
--- a/osu.Game.Rulesets.Mania/Edit/ManiaBeatSnapGrid.cs
+++ b/osu.Game.Rulesets.Mania/Edit/ManiaBeatSnapGrid.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game.Rulesets.Mania/Edit/ManiaBlueprintContainer.cs b/osu.Game.Rulesets.Mania/Edit/ManiaBlueprintContainer.cs
index c5a109a6d1..ad75afff8e 100644
--- a/osu.Game.Rulesets.Mania/Edit/ManiaBlueprintContainer.cs
+++ b/osu.Game.Rulesets.Mania/Edit/ManiaBlueprintContainer.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Edit;
 using osu.Game.Rulesets.Mania.Edit.Blueprints;
 using osu.Game.Rulesets.Mania.Objects;
diff --git a/osu.Game.Rulesets.Mania/Edit/ManiaEditorPlayfield.cs b/osu.Game.Rulesets.Mania/Edit/ManiaEditorPlayfield.cs
index 186d50716e..6683ab6bdc 100644
--- a/osu.Game.Rulesets.Mania/Edit/ManiaEditorPlayfield.cs
+++ b/osu.Game.Rulesets.Mania/Edit/ManiaEditorPlayfield.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Mania.Beatmaps;
 using osu.Game.Rulesets.Mania.UI;
 using System.Collections.Generic;
diff --git a/osu.Game.Rulesets.Mania/Edit/ManiaHitObjectComposer.cs b/osu.Game.Rulesets.Mania/Edit/ManiaHitObjectComposer.cs
index c389e1bced..3585fd4e8c 100644
--- a/osu.Game.Rulesets.Mania/Edit/ManiaHitObjectComposer.cs
+++ b/osu.Game.Rulesets.Mania/Edit/ManiaHitObjectComposer.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Rulesets.Mania/Edit/ManiaSelectionHandler.cs b/osu.Game.Rulesets.Mania/Edit/ManiaSelectionHandler.cs
index 9fe1eb7932..7b9742a706 100644
--- a/osu.Game.Rulesets.Mania/Edit/ManiaSelectionHandler.cs
+++ b/osu.Game.Rulesets.Mania/Edit/ManiaSelectionHandler.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Rulesets.Mania/Edit/NoteCompositionTool.cs b/osu.Game.Rulesets.Mania/Edit/NoteCompositionTool.cs
index 9f54152596..179f920c2f 100644
--- a/osu.Game.Rulesets.Mania/Edit/NoteCompositionTool.cs
+++ b/osu.Game.Rulesets.Mania/Edit/NoteCompositionTool.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Edit;
diff --git a/osu.Game.Rulesets.Mania/Edit/Setup/ManiaSetupSection.cs b/osu.Game.Rulesets.Mania/Edit/Setup/ManiaSetupSection.cs
index a206aafb8a..b602a67baa 100644
--- a/osu.Game.Rulesets.Mania/Edit/Setup/ManiaSetupSection.cs
+++ b/osu.Game.Rulesets.Mania/Edit/Setup/ManiaSetupSection.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Game.Graphics.UserInterfaceV2;
diff --git a/osu.Game.Rulesets.Mania/Judgements/HoldNoteTickJudgement.cs b/osu.Game.Rulesets.Mania/Judgements/HoldNoteTickJudgement.cs
index ee6cbbc828..4b94198c4d 100644
--- a/osu.Game.Rulesets.Mania/Judgements/HoldNoteTickJudgement.cs
+++ b/osu.Game.Rulesets.Mania/Judgements/HoldNoteTickJudgement.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Scoring;
 
 namespace osu.Game.Rulesets.Mania.Judgements
diff --git a/osu.Game.Rulesets.Mania/Judgements/ManiaJudgement.cs b/osu.Game.Rulesets.Mania/Judgements/ManiaJudgement.cs
index d28b7bdf58..32f9689d7e 100644
--- a/osu.Game.Rulesets.Mania/Judgements/ManiaJudgement.cs
+++ b/osu.Game.Rulesets.Mania/Judgements/ManiaJudgement.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Judgements;
 using osu.Game.Rulesets.Scoring;
 
diff --git a/osu.Game.Rulesets.Mania/ManiaFilterCriteria.cs b/osu.Game.Rulesets.Mania/ManiaFilterCriteria.cs
index c8832dfdfb..58aef4dbf8 100644
--- a/osu.Game.Rulesets.Mania/ManiaFilterCriteria.cs
+++ b/osu.Game.Rulesets.Mania/ManiaFilterCriteria.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.
 
+#nullable disable
+
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Filter;
 using osu.Game.Rulesets.Mania.Beatmaps;
diff --git a/osu.Game.Rulesets.Mania/ManiaInputManager.cs b/osu.Game.Rulesets.Mania/ManiaInputManager.cs
index 14ca27a11a..e8e90d198a 100644
--- a/osu.Game.Rulesets.Mania/ManiaInputManager.cs
+++ b/osu.Game.Rulesets.Mania/ManiaInputManager.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.
 
+#nullable disable
+
 using System.ComponentModel;
 using osu.Framework.Allocation;
 using osu.Framework.Input.Bindings;
diff --git a/osu.Game.Rulesets.Mania/ManiaRuleset.cs b/osu.Game.Rulesets.Mania/ManiaRuleset.cs
index bd6a67bf67..98a492450e 100644
--- a/osu.Game.Rulesets.Mania/ManiaRuleset.cs
+++ b/osu.Game.Rulesets.Mania/ManiaRuleset.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.
 
+#nullable disable
+
 using System;
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Mania.Mods;
diff --git a/osu.Game.Rulesets.Mania/ManiaSettingsSubsection.cs b/osu.Game.Rulesets.Mania/ManiaSettingsSubsection.cs
index bd3b8c3b10..43d4aa77a2 100644
--- a/osu.Game.Rulesets.Mania/ManiaSettingsSubsection.cs
+++ b/osu.Game.Rulesets.Mania/ManiaSettingsSubsection.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Localisation;
diff --git a/osu.Game.Rulesets.Mania/ManiaSkinComponent.cs b/osu.Game.Rulesets.Mania/ManiaSkinComponent.cs
index 9aebf51576..b709f85523 100644
--- a/osu.Game.Rulesets.Mania/ManiaSkinComponent.cs
+++ b/osu.Game.Rulesets.Mania/ManiaSkinComponent.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Mania.Beatmaps;
 using osu.Game.Rulesets.Mania.UI;
 using osu.Game.Skinning;
diff --git a/osu.Game.Rulesets.Mania/MathUtils/LegacySortHelper.cs b/osu.Game.Rulesets.Mania/MathUtils/LegacySortHelper.cs
index 5c595323c3..1a67117c03 100644
--- a/osu.Game.Rulesets.Mania/MathUtils/LegacySortHelper.cs
+++ b/osu.Game.Rulesets.Mania/MathUtils/LegacySortHelper.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Diagnostics.Contracts;
diff --git a/osu.Game.Rulesets.Mania/Mods/IPlayfieldTypeMod.cs b/osu.Game.Rulesets.Mania/Mods/IPlayfieldTypeMod.cs
index 410386c9d5..0bae893810 100644
--- a/osu.Game.Rulesets.Mania/Mods/IPlayfieldTypeMod.cs
+++ b/osu.Game.Rulesets.Mania/Mods/IPlayfieldTypeMod.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Mods;
 
 namespace osu.Game.Rulesets.Mania.Mods
diff --git a/osu.Game.Rulesets.Mania/Mods/ManiaKeyMod.cs b/osu.Game.Rulesets.Mania/Mods/ManiaKeyMod.cs
index 050b302bd8..8f8b7cb091 100644
--- a/osu.Game.Rulesets.Mania/Mods/ManiaKeyMod.cs
+++ b/osu.Game.Rulesets.Mania/Mods/ManiaKeyMod.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using osu.Game.Beatmaps;
diff --git a/osu.Game.Rulesets.Mania/Mods/ManiaModAutoplay.cs b/osu.Game.Rulesets.Mania/Mods/ManiaModAutoplay.cs
index d444c9b634..f9c51bf6a2 100644
--- a/osu.Game.Rulesets.Mania/Mods/ManiaModAutoplay.cs
+++ b/osu.Game.Rulesets.Mania/Mods/ManiaModAutoplay.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Mania.Beatmaps;
diff --git a/osu.Game.Rulesets.Mania/Mods/ManiaModCinema.cs b/osu.Game.Rulesets.Mania/Mods/ManiaModCinema.cs
index f0db742eac..8d54923e7b 100644
--- a/osu.Game.Rulesets.Mania/Mods/ManiaModCinema.cs
+++ b/osu.Game.Rulesets.Mania/Mods/ManiaModCinema.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Mania.Beatmaps;
diff --git a/osu.Game.Rulesets.Mania/Mods/ManiaModClassic.cs b/osu.Game.Rulesets.Mania/Mods/ManiaModClassic.cs
index 073dda9de8..603d096ed7 100644
--- a/osu.Game.Rulesets.Mania/Mods/ManiaModClassic.cs
+++ b/osu.Game.Rulesets.Mania/Mods/ManiaModClassic.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Mods;
 
 namespace osu.Game.Rulesets.Mania.Mods
diff --git a/osu.Game.Rulesets.Mania/Mods/ManiaModConstantSpeed.cs b/osu.Game.Rulesets.Mania/Mods/ManiaModConstantSpeed.cs
index 614ef76a3b..20dfc14f09 100644
--- a/osu.Game.Rulesets.Mania/Mods/ManiaModConstantSpeed.cs
+++ b/osu.Game.Rulesets.Mania/Mods/ManiaModConstantSpeed.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.
 
+#nullable disable
+
 using osu.Framework.Graphics.Sprites;
 using osu.Game.Configuration;
 using osu.Game.Rulesets.Mania.Objects;
diff --git a/osu.Game.Rulesets.Mania/Mods/ManiaModDaycore.cs b/osu.Game.Rulesets.Mania/Mods/ManiaModDaycore.cs
index bec0a6a1d3..b166f3ebc3 100644
--- a/osu.Game.Rulesets.Mania/Mods/ManiaModDaycore.cs
+++ b/osu.Game.Rulesets.Mania/Mods/ManiaModDaycore.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Mods;
 
 namespace osu.Game.Rulesets.Mania.Mods
diff --git a/osu.Game.Rulesets.Mania/Mods/ManiaModDifficultyAdjust.cs b/osu.Game.Rulesets.Mania/Mods/ManiaModDifficultyAdjust.cs
index 0817f8f9fc..d053e64315 100644
--- a/osu.Game.Rulesets.Mania/Mods/ManiaModDifficultyAdjust.cs
+++ b/osu.Game.Rulesets.Mania/Mods/ManiaModDifficultyAdjust.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Mods;
 
 namespace osu.Game.Rulesets.Mania.Mods
diff --git a/osu.Game.Rulesets.Mania/Mods/ManiaModDoubleTime.cs b/osu.Game.Rulesets.Mania/Mods/ManiaModDoubleTime.cs
index a302f95966..66627e6ed3 100644
--- a/osu.Game.Rulesets.Mania/Mods/ManiaModDoubleTime.cs
+++ b/osu.Game.Rulesets.Mania/Mods/ManiaModDoubleTime.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Mods;
 
 namespace osu.Game.Rulesets.Mania.Mods
diff --git a/osu.Game.Rulesets.Mania/Mods/ManiaModDualStages.cs b/osu.Game.Rulesets.Mania/Mods/ManiaModDualStages.cs
index c78bf72979..f25a77278b 100644
--- a/osu.Game.Rulesets.Mania/Mods/ManiaModDualStages.cs
+++ b/osu.Game.Rulesets.Mania/Mods/ManiaModDualStages.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.
 
+#nullable disable
+
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Mania.Beatmaps;
 using osu.Game.Rulesets.Mods;
diff --git a/osu.Game.Rulesets.Mania/Mods/ManiaModEasy.cs b/osu.Game.Rulesets.Mania/Mods/ManiaModEasy.cs
index 4093aeb2a7..ff236d33bf 100644
--- a/osu.Game.Rulesets.Mania/Mods/ManiaModEasy.cs
+++ b/osu.Game.Rulesets.Mania/Mods/ManiaModEasy.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Mods;
 
 namespace osu.Game.Rulesets.Mania.Mods
diff --git a/osu.Game.Rulesets.Mania/Mods/ManiaModFadeIn.cs b/osu.Game.Rulesets.Mania/Mods/ManiaModFadeIn.cs
index f80c9e1f7c..ddbd7c5d6a 100644
--- a/osu.Game.Rulesets.Mania/Mods/ManiaModFadeIn.cs
+++ b/osu.Game.Rulesets.Mania/Mods/ManiaModFadeIn.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using osu.Game.Rulesets.Mania.UI;
diff --git a/osu.Game.Rulesets.Mania/Mods/ManiaModFlashlight.cs b/osu.Game.Rulesets.Mania/Mods/ManiaModFlashlight.cs
index 8ef5bfd94c..58005df561 100644
--- a/osu.Game.Rulesets.Mania/Mods/ManiaModFlashlight.cs
+++ b/osu.Game.Rulesets.Mania/Mods/ManiaModFlashlight.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Rulesets.Mania/Mods/ManiaModHalfTime.cs b/osu.Game.Rulesets.Mania/Mods/ManiaModHalfTime.cs
index 014954dd60..87c81c2866 100644
--- a/osu.Game.Rulesets.Mania/Mods/ManiaModHalfTime.cs
+++ b/osu.Game.Rulesets.Mania/Mods/ManiaModHalfTime.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Mods;
 
 namespace osu.Game.Rulesets.Mania.Mods
diff --git a/osu.Game.Rulesets.Mania/Mods/ManiaModHardRock.cs b/osu.Game.Rulesets.Mania/Mods/ManiaModHardRock.cs
index d9de06a811..380edca515 100644
--- a/osu.Game.Rulesets.Mania/Mods/ManiaModHardRock.cs
+++ b/osu.Game.Rulesets.Mania/Mods/ManiaModHardRock.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Mods;
 
 namespace osu.Game.Rulesets.Mania.Mods
diff --git a/osu.Game.Rulesets.Mania/Mods/ManiaModHidden.cs b/osu.Game.Rulesets.Mania/Mods/ManiaModHidden.cs
index e3ac624a6e..698555ddc4 100644
--- a/osu.Game.Rulesets.Mania/Mods/ManiaModHidden.cs
+++ b/osu.Game.Rulesets.Mania/Mods/ManiaModHidden.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using osu.Game.Rulesets.Mania.UI;
diff --git a/osu.Game.Rulesets.Mania/Mods/ManiaModHoldOff.cs b/osu.Game.Rulesets.Mania/Mods/ManiaModHoldOff.cs
index a65938184c..8c4fd0a8fc 100644
--- a/osu.Game.Rulesets.Mania/Mods/ManiaModHoldOff.cs
+++ b/osu.Game.Rulesets.Mania/Mods/ManiaModHoldOff.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using osu.Game.Beatmaps;
diff --git a/osu.Game.Rulesets.Mania/Mods/ManiaModInvert.cs b/osu.Game.Rulesets.Mania/Mods/ManiaModInvert.cs
index 4cbdaee323..f202b859b1 100644
--- a/osu.Game.Rulesets.Mania/Mods/ManiaModInvert.cs
+++ b/osu.Game.Rulesets.Mania/Mods/ManiaModInvert.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game.Rulesets.Mania/Mods/ManiaModKey1.cs b/osu.Game.Rulesets.Mania/Mods/ManiaModKey1.cs
index 948979505c..9ce4fb6a48 100644
--- a/osu.Game.Rulesets.Mania/Mods/ManiaModKey1.cs
+++ b/osu.Game.Rulesets.Mania/Mods/ManiaModKey1.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.
 
+#nullable disable
+
 namespace osu.Game.Rulesets.Mania.Mods
 {
     public class ManiaModKey1 : ManiaKeyMod
diff --git a/osu.Game.Rulesets.Mania/Mods/ManiaModKey10.cs b/osu.Game.Rulesets.Mania/Mods/ManiaModKey10.cs
index 684370fc3d..f378ce3435 100644
--- a/osu.Game.Rulesets.Mania/Mods/ManiaModKey10.cs
+++ b/osu.Game.Rulesets.Mania/Mods/ManiaModKey10.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.
 
+#nullable disable
+
 namespace osu.Game.Rulesets.Mania.Mods
 {
     public class ManiaModKey10 : ManiaKeyMod
diff --git a/osu.Game.Rulesets.Mania/Mods/ManiaModKey2.cs b/osu.Game.Rulesets.Mania/Mods/ManiaModKey2.cs
index de91902ca8..5812df80f5 100644
--- a/osu.Game.Rulesets.Mania/Mods/ManiaModKey2.cs
+++ b/osu.Game.Rulesets.Mania/Mods/ManiaModKey2.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.
 
+#nullable disable
+
 namespace osu.Game.Rulesets.Mania.Mods
 {
     public class ManiaModKey2 : ManiaKeyMod
diff --git a/osu.Game.Rulesets.Mania/Mods/ManiaModKey3.cs b/osu.Game.Rulesets.Mania/Mods/ManiaModKey3.cs
index 8575a96bde..4116ed5ceb 100644
--- a/osu.Game.Rulesets.Mania/Mods/ManiaModKey3.cs
+++ b/osu.Game.Rulesets.Mania/Mods/ManiaModKey3.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.
 
+#nullable disable
+
 namespace osu.Game.Rulesets.Mania.Mods
 {
     public class ManiaModKey3 : ManiaKeyMod
diff --git a/osu.Game.Rulesets.Mania/Mods/ManiaModKey4.cs b/osu.Game.Rulesets.Mania/Mods/ManiaModKey4.cs
index 54ea3afa07..9879fec686 100644
--- a/osu.Game.Rulesets.Mania/Mods/ManiaModKey4.cs
+++ b/osu.Game.Rulesets.Mania/Mods/ManiaModKey4.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.
 
+#nullable disable
+
 namespace osu.Game.Rulesets.Mania.Mods
 {
     public class ManiaModKey4 : ManiaKeyMod
diff --git a/osu.Game.Rulesets.Mania/Mods/ManiaModKey5.cs b/osu.Game.Rulesets.Mania/Mods/ManiaModKey5.cs
index e9a9bba5bd..646386b0d8 100644
--- a/osu.Game.Rulesets.Mania/Mods/ManiaModKey5.cs
+++ b/osu.Game.Rulesets.Mania/Mods/ManiaModKey5.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.
 
+#nullable disable
+
 namespace osu.Game.Rulesets.Mania.Mods
 {
     public class ManiaModKey5 : ManiaKeyMod
diff --git a/osu.Game.Rulesets.Mania/Mods/ManiaModKey6.cs b/osu.Game.Rulesets.Mania/Mods/ManiaModKey6.cs
index b9606d1cb5..56af9ed589 100644
--- a/osu.Game.Rulesets.Mania/Mods/ManiaModKey6.cs
+++ b/osu.Game.Rulesets.Mania/Mods/ManiaModKey6.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.
 
+#nullable disable
+
 namespace osu.Game.Rulesets.Mania.Mods
 {
     public class ManiaModKey6 : ManiaKeyMod
diff --git a/osu.Game.Rulesets.Mania/Mods/ManiaModKey7.cs b/osu.Game.Rulesets.Mania/Mods/ManiaModKey7.cs
index b80d794085..a0a7116ed7 100644
--- a/osu.Game.Rulesets.Mania/Mods/ManiaModKey7.cs
+++ b/osu.Game.Rulesets.Mania/Mods/ManiaModKey7.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.
 
+#nullable disable
+
 namespace osu.Game.Rulesets.Mania.Mods
 {
     public class ManiaModKey7 : ManiaKeyMod
diff --git a/osu.Game.Rulesets.Mania/Mods/ManiaModKey8.cs b/osu.Game.Rulesets.Mania/Mods/ManiaModKey8.cs
index 3462d634a4..fc8ecdb9ea 100644
--- a/osu.Game.Rulesets.Mania/Mods/ManiaModKey8.cs
+++ b/osu.Game.Rulesets.Mania/Mods/ManiaModKey8.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.
 
+#nullable disable
+
 namespace osu.Game.Rulesets.Mania.Mods
 {
     public class ManiaModKey8 : ManiaKeyMod
diff --git a/osu.Game.Rulesets.Mania/Mods/ManiaModKey9.cs b/osu.Game.Rulesets.Mania/Mods/ManiaModKey9.cs
index 83c505c048..c495a6c82f 100644
--- a/osu.Game.Rulesets.Mania/Mods/ManiaModKey9.cs
+++ b/osu.Game.Rulesets.Mania/Mods/ManiaModKey9.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.
 
+#nullable disable
+
 namespace osu.Game.Rulesets.Mania.Mods
 {
     public class ManiaModKey9 : ManiaKeyMod
diff --git a/osu.Game.Rulesets.Mania/Mods/ManiaModMirror.cs b/osu.Game.Rulesets.Mania/Mods/ManiaModMirror.cs
index 9c3744ea98..6e56981fc8 100644
--- a/osu.Game.Rulesets.Mania/Mods/ManiaModMirror.cs
+++ b/osu.Game.Rulesets.Mania/Mods/ManiaModMirror.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.
 
+#nullable disable
+
 using osu.Framework.Extensions.IEnumerableExtensions;
 using osu.Game.Rulesets.Mania.Objects;
 using osu.Game.Rulesets.Mods;
diff --git a/osu.Game.Rulesets.Mania/Mods/ManiaModMuted.cs b/osu.Game.Rulesets.Mania/Mods/ManiaModMuted.cs
index 33ebcf303a..076f634968 100644
--- a/osu.Game.Rulesets.Mania/Mods/ManiaModMuted.cs
+++ b/osu.Game.Rulesets.Mania/Mods/ManiaModMuted.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Mania.Objects;
 using osu.Game.Rulesets.Mods;
 
diff --git a/osu.Game.Rulesets.Mania/Mods/ManiaModNightcore.cs b/osu.Game.Rulesets.Mania/Mods/ManiaModNightcore.cs
index 4cc712060c..9ae664e1f6 100644
--- a/osu.Game.Rulesets.Mania/Mods/ManiaModNightcore.cs
+++ b/osu.Game.Rulesets.Mania/Mods/ManiaModNightcore.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Mania.Objects;
 using osu.Game.Rulesets.Mods;
 
diff --git a/osu.Game.Rulesets.Mania/Mods/ManiaModNoFail.cs b/osu.Game.Rulesets.Mania/Mods/ManiaModNoFail.cs
index e8988be548..487f32dc26 100644
--- a/osu.Game.Rulesets.Mania/Mods/ManiaModNoFail.cs
+++ b/osu.Game.Rulesets.Mania/Mods/ManiaModNoFail.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Mods;
 
 namespace osu.Game.Rulesets.Mania.Mods
diff --git a/osu.Game.Rulesets.Mania/Mods/ManiaModPerfect.cs b/osu.Game.Rulesets.Mania/Mods/ManiaModPerfect.cs
index 2e22e23dbd..2789a2a06e 100644
--- a/osu.Game.Rulesets.Mania/Mods/ManiaModPerfect.cs
+++ b/osu.Game.Rulesets.Mania/Mods/ManiaModPerfect.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Mods;
 
 namespace osu.Game.Rulesets.Mania.Mods
diff --git a/osu.Game.Rulesets.Mania/Mods/ManiaModPlayfieldCover.cs b/osu.Game.Rulesets.Mania/Mods/ManiaModPlayfieldCover.cs
index 3c24e91d54..5da29e5a1d 100644
--- a/osu.Game.Rulesets.Mania/Mods/ManiaModPlayfieldCover.cs
+++ b/osu.Game.Rulesets.Mania/Mods/ManiaModPlayfieldCover.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Rulesets.Mania/Mods/ManiaModRandom.cs b/osu.Game.Rulesets.Mania/Mods/ManiaModRandom.cs
index f5d1a34d73..c7c7a6003e 100644
--- a/osu.Game.Rulesets.Mania/Mods/ManiaModRandom.cs
+++ b/osu.Game.Rulesets.Mania/Mods/ManiaModRandom.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using osu.Framework.Extensions.IEnumerableExtensions;
diff --git a/osu.Game.Rulesets.Mania/Mods/ManiaModSuddenDeath.cs b/osu.Game.Rulesets.Mania/Mods/ManiaModSuddenDeath.cs
index ecc343ecaa..17759d718e 100644
--- a/osu.Game.Rulesets.Mania/Mods/ManiaModSuddenDeath.cs
+++ b/osu.Game.Rulesets.Mania/Mods/ManiaModSuddenDeath.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Mods;
 
 namespace osu.Game.Rulesets.Mania.Mods
diff --git a/osu.Game.Rulesets.Mania/Objects/BarLine.cs b/osu.Game.Rulesets.Mania/Objects/BarLine.cs
index 09a746042b..3f04a4fafe 100644
--- a/osu.Game.Rulesets.Mania/Objects/BarLine.cs
+++ b/osu.Game.Rulesets.Mania/Objects/BarLine.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Judgements;
 using osu.Game.Rulesets.Objects;
 
diff --git a/osu.Game.Rulesets.Mania/Objects/Drawables/DrawableBarLine.cs b/osu.Game.Rulesets.Mania/Objects/Drawables/DrawableBarLine.cs
index 074cbf6bd6..0e2d6bce21 100644
--- a/osu.Game.Rulesets.Mania/Objects/Drawables/DrawableBarLine.cs
+++ b/osu.Game.Rulesets.Mania/Objects/Drawables/DrawableBarLine.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Shapes;
 using osuTK;
diff --git a/osu.Game.Rulesets.Mania/Objects/Drawables/DrawableHoldNote.cs b/osu.Game.Rulesets.Mania/Objects/Drawables/DrawableHoldNote.cs
index 4e9781f336..19792086a7 100644
--- a/osu.Game.Rulesets.Mania/Objects/Drawables/DrawableHoldNote.cs
+++ b/osu.Game.Rulesets.Mania/Objects/Drawables/DrawableHoldNote.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game.Rulesets.Mania/Objects/Drawables/DrawableHoldNoteHead.cs b/osu.Game.Rulesets.Mania/Objects/Drawables/DrawableHoldNoteHead.cs
index 6722ad8ab8..d374e935ec 100644
--- a/osu.Game.Rulesets.Mania/Objects/Drawables/DrawableHoldNoteHead.cs
+++ b/osu.Game.Rulesets.Mania/Objects/Drawables/DrawableHoldNoteHead.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Input.Events;
 using osu.Game.Rulesets.Objects.Drawables;
diff --git a/osu.Game.Rulesets.Mania/Objects/Drawables/DrawableHoldNoteTail.cs b/osu.Game.Rulesets.Mania/Objects/Drawables/DrawableHoldNoteTail.cs
index 803685363c..a7bdcd047e 100644
--- a/osu.Game.Rulesets.Mania/Objects/Drawables/DrawableHoldNoteTail.cs
+++ b/osu.Game.Rulesets.Mania/Objects/Drawables/DrawableHoldNoteTail.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.
 
+#nullable disable
+
 using System.Diagnostics;
 using osu.Framework.Graphics;
 using osu.Framework.Input.Events;
diff --git a/osu.Game.Rulesets.Mania/Objects/Drawables/DrawableHoldNoteTick.cs b/osu.Game.Rulesets.Mania/Objects/Drawables/DrawableHoldNoteTick.cs
index cffa79322e..daec5ddbe7 100644
--- a/osu.Game.Rulesets.Mania/Objects/Drawables/DrawableHoldNoteTick.cs
+++ b/osu.Game.Rulesets.Mania/Objects/Drawables/DrawableHoldNoteTick.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.
 
+#nullable disable
+
 using System;
 using System.Diagnostics;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Rulesets.Mania/Objects/Drawables/DrawableManiaHitObject.cs b/osu.Game.Rulesets.Mania/Objects/Drawables/DrawableManiaHitObject.cs
index 9ac223a0d7..bcc10ab7bc 100644
--- a/osu.Game.Rulesets.Mania/Objects/Drawables/DrawableManiaHitObject.cs
+++ b/osu.Game.Rulesets.Mania/Objects/Drawables/DrawableManiaHitObject.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.
 
+#nullable disable
+
 using System;
 using JetBrains.Annotations;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Rulesets.Mania/Objects/Drawables/DrawableNote.cs b/osu.Game.Rulesets.Mania/Objects/Drawables/DrawableNote.cs
index 51727908c9..3c8b1b53b7 100644
--- a/osu.Game.Rulesets.Mania/Objects/Drawables/DrawableNote.cs
+++ b/osu.Game.Rulesets.Mania/Objects/Drawables/DrawableNote.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.
 
+#nullable disable
+
 using System.Diagnostics;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game.Rulesets.Mania/Objects/HeadNote.cs b/osu.Game.Rulesets.Mania/Objects/HeadNote.cs
index e69cc62aed..fb5c7b4ddd 100644
--- a/osu.Game.Rulesets.Mania/Objects/HeadNote.cs
+++ b/osu.Game.Rulesets.Mania/Objects/HeadNote.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.
 
+#nullable disable
+
 namespace osu.Game.Rulesets.Mania.Objects
 {
     public class HeadNote : Note
diff --git a/osu.Game.Rulesets.Mania/Objects/HoldNote.cs b/osu.Game.Rulesets.Mania/Objects/HoldNote.cs
index db0d3e2c5a..22fab15c1b 100644
--- a/osu.Game.Rulesets.Mania/Objects/HoldNote.cs
+++ b/osu.Game.Rulesets.Mania/Objects/HoldNote.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Threading;
 using osu.Game.Audio;
diff --git a/osu.Game.Rulesets.Mania/Objects/HoldNoteTick.cs b/osu.Game.Rulesets.Mania/Objects/HoldNoteTick.cs
index ac6697a6dc..9117c60dcd 100644
--- a/osu.Game.Rulesets.Mania/Objects/HoldNoteTick.cs
+++ b/osu.Game.Rulesets.Mania/Objects/HoldNoteTick.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Judgements;
 using osu.Game.Rulesets.Mania.Judgements;
 using osu.Game.Rulesets.Scoring;
diff --git a/osu.Game.Rulesets.Mania/Objects/ManiaHitObject.cs b/osu.Game.Rulesets.Mania/Objects/ManiaHitObject.cs
index 6289744df1..0efaeac026 100644
--- a/osu.Game.Rulesets.Mania/Objects/ManiaHitObject.cs
+++ b/osu.Game.Rulesets.Mania/Objects/ManiaHitObject.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.
 
+#nullable disable
+
 using osu.Framework.Bindables;
 using osu.Game.Rulesets.Mania.Scoring;
 using osu.Game.Rulesets.Objects;
diff --git a/osu.Game.Rulesets.Mania/Objects/Note.cs b/osu.Game.Rulesets.Mania/Objects/Note.cs
index 0035960c63..578b46a7aa 100644
--- a/osu.Game.Rulesets.Mania/Objects/Note.cs
+++ b/osu.Game.Rulesets.Mania/Objects/Note.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Judgements;
 using osu.Game.Rulesets.Mania.Judgements;
 
diff --git a/osu.Game.Rulesets.Mania/Objects/TailNote.cs b/osu.Game.Rulesets.Mania/Objects/TailNote.cs
index 5a30fd6a12..cda8e2fa31 100644
--- a/osu.Game.Rulesets.Mania/Objects/TailNote.cs
+++ b/osu.Game.Rulesets.Mania/Objects/TailNote.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Judgements;
 using osu.Game.Rulesets.Mania.Judgements;
 
diff --git a/osu.Game.Rulesets.Mania/Properties/AssemblyInfo.cs b/osu.Game.Rulesets.Mania/Properties/AssemblyInfo.cs
index ca1f7036c7..1bc20f7ef3 100644
--- a/osu.Game.Rulesets.Mania/Properties/AssemblyInfo.cs
+++ b/osu.Game.Rulesets.Mania/Properties/AssemblyInfo.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.
 
+#nullable disable
+
 using System.Runtime.CompilerServices;
 
 // We publish our internal attributes to other sub-projects of the framework.
diff --git a/osu.Game.Rulesets.Mania/Replays/ManiaAutoGenerator.cs b/osu.Game.Rulesets.Mania/Replays/ManiaAutoGenerator.cs
index efe144ac03..3814ad84f1 100644
--- a/osu.Game.Rulesets.Mania/Replays/ManiaAutoGenerator.cs
+++ b/osu.Game.Rulesets.Mania/Replays/ManiaAutoGenerator.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using osu.Game.Rulesets.Mania.Beatmaps;
diff --git a/osu.Game.Rulesets.Mania/Replays/ManiaFramedReplayInputHandler.cs b/osu.Game.Rulesets.Mania/Replays/ManiaFramedReplayInputHandler.cs
index aa164f95da..c786e1db61 100644
--- a/osu.Game.Rulesets.Mania/Replays/ManiaFramedReplayInputHandler.cs
+++ b/osu.Game.Rulesets.Mania/Replays/ManiaFramedReplayInputHandler.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using osu.Framework.Input.StateChanges;
diff --git a/osu.Game.Rulesets.Mania/Replays/ManiaReplayFrame.cs b/osu.Game.Rulesets.Mania/Replays/ManiaReplayFrame.cs
index dbab54d1d0..66edc87992 100644
--- a/osu.Game.Rulesets.Mania/Replays/ManiaReplayFrame.cs
+++ b/osu.Game.Rulesets.Mania/Replays/ManiaReplayFrame.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using osu.Game.Beatmaps;
diff --git a/osu.Game.Rulesets.Mania/Scoring/ManiaHealthProcessor.cs b/osu.Game.Rulesets.Mania/Scoring/ManiaHealthProcessor.cs
index 57c2ba9c6d..3f0491e53f 100644
--- a/osu.Game.Rulesets.Mania/Scoring/ManiaHealthProcessor.cs
+++ b/osu.Game.Rulesets.Mania/Scoring/ManiaHealthProcessor.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Judgements;
 using osu.Game.Rulesets.Scoring;
 
diff --git a/osu.Game.Rulesets.Mania/Scoring/ManiaHitWindows.cs b/osu.Game.Rulesets.Mania/Scoring/ManiaHitWindows.cs
index 289f8a00ef..c46a1b5ab6 100644
--- a/osu.Game.Rulesets.Mania/Scoring/ManiaHitWindows.cs
+++ b/osu.Game.Rulesets.Mania/Scoring/ManiaHitWindows.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Scoring;
 
 namespace osu.Game.Rulesets.Mania.Scoring
diff --git a/osu.Game.Rulesets.Mania/Scoring/ManiaScoreProcessor.cs b/osu.Game.Rulesets.Mania/Scoring/ManiaScoreProcessor.cs
index 02d62a090b..dbf3d02955 100644
--- a/osu.Game.Rulesets.Mania/Scoring/ManiaScoreProcessor.cs
+++ b/osu.Game.Rulesets.Mania/Scoring/ManiaScoreProcessor.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Scoring;
 
 namespace osu.Game.Rulesets.Mania.Scoring
diff --git a/osu.Game.Rulesets.Mania/SingleStageVariantGenerator.cs b/osu.Game.Rulesets.Mania/SingleStageVariantGenerator.cs
index 2069329d9a..765fd11dd5 100644
--- a/osu.Game.Rulesets.Mania/SingleStageVariantGenerator.cs
+++ b/osu.Game.Rulesets.Mania/SingleStageVariantGenerator.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Framework.Input.Bindings;
 
diff --git a/osu.Game.Rulesets.Mania/Skinning/Default/DefaultBodyPiece.cs b/osu.Game.Rulesets.Mania/Skinning/Default/DefaultBodyPiece.cs
index 7138421b91..7476af3c3c 100644
--- a/osu.Game.Rulesets.Mania/Skinning/Default/DefaultBodyPiece.cs
+++ b/osu.Game.Rulesets.Mania/Skinning/Default/DefaultBodyPiece.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.
 
+#nullable disable
+
 using System;
 using JetBrains.Annotations;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Rulesets.Mania/Skinning/Default/DefaultNotePiece.cs b/osu.Game.Rulesets.Mania/Skinning/Default/DefaultNotePiece.cs
index c9c3cff799..72bb05de49 100644
--- a/osu.Game.Rulesets.Mania/Skinning/Default/DefaultNotePiece.cs
+++ b/osu.Game.Rulesets.Mania/Skinning/Default/DefaultNotePiece.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.
 
+#nullable disable
+
 using JetBrains.Annotations;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game.Rulesets.Mania/Skinning/Default/IHoldNoteBody.cs b/osu.Game.Rulesets.Mania/Skinning/Default/IHoldNoteBody.cs
index 1f290f1f1c..9168a96b95 100644
--- a/osu.Game.Rulesets.Mania/Skinning/Default/IHoldNoteBody.cs
+++ b/osu.Game.Rulesets.Mania/Skinning/Default/IHoldNoteBody.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.
 
+#nullable disable
+
 namespace osu.Game.Rulesets.Mania.Skinning.Default
 {
     /// <summary>
diff --git a/osu.Game.Rulesets.Mania/Skinning/Legacy/HitTargetInsetContainer.cs b/osu.Game.Rulesets.Mania/Skinning/Legacy/HitTargetInsetContainer.cs
index 3c89e2c04a..362a265789 100644
--- a/osu.Game.Rulesets.Mania/Skinning/Legacy/HitTargetInsetContainer.cs
+++ b/osu.Game.Rulesets.Mania/Skinning/Legacy/HitTargetInsetContainer.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Rulesets.Mania/Skinning/Legacy/LegacyBodyPiece.cs b/osu.Game.Rulesets.Mania/Skinning/Legacy/LegacyBodyPiece.cs
index 31db08ce2f..4e6493ba18 100644
--- a/osu.Game.Rulesets.Mania/Skinning/Legacy/LegacyBodyPiece.cs
+++ b/osu.Game.Rulesets.Mania/Skinning/Legacy/LegacyBodyPiece.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.
 
+#nullable disable
+
 using System;
 using JetBrains.Annotations;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Rulesets.Mania/Skinning/Legacy/LegacyColumnBackground.cs b/osu.Game.Rulesets.Mania/Skinning/Legacy/LegacyColumnBackground.cs
index 54ddcbd5fe..f35cedab08 100644
--- a/osu.Game.Rulesets.Mania/Skinning/Legacy/LegacyColumnBackground.cs
+++ b/osu.Game.Rulesets.Mania/Skinning/Legacy/LegacyColumnBackground.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Rulesets.Mania/Skinning/Legacy/LegacyHitExplosion.cs b/osu.Game.Rulesets.Mania/Skinning/Legacy/LegacyHitExplosion.cs
index e4d466dca5..278cf0707c 100644
--- a/osu.Game.Rulesets.Mania/Skinning/Legacy/LegacyHitExplosion.cs
+++ b/osu.Game.Rulesets.Mania/Skinning/Legacy/LegacyHitExplosion.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game.Rulesets.Mania/Skinning/Legacy/LegacyHitTarget.cs b/osu.Game.Rulesets.Mania/Skinning/Legacy/LegacyHitTarget.cs
index 490a03d11a..611dac30b3 100644
--- a/osu.Game.Rulesets.Mania/Skinning/Legacy/LegacyHitTarget.cs
+++ b/osu.Game.Rulesets.Mania/Skinning/Legacy/LegacyHitTarget.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Rulesets.Mania/Skinning/Legacy/LegacyHoldNoteHeadPiece.cs b/osu.Game.Rulesets.Mania/Skinning/Legacy/LegacyHoldNoteHeadPiece.cs
index 1e75533442..a653e2ce36 100644
--- a/osu.Game.Rulesets.Mania/Skinning/Legacy/LegacyHoldNoteHeadPiece.cs
+++ b/osu.Game.Rulesets.Mania/Skinning/Legacy/LegacyHoldNoteHeadPiece.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Game.Skinning;
 
diff --git a/osu.Game.Rulesets.Mania/Skinning/Legacy/LegacyHoldNoteTailPiece.cs b/osu.Game.Rulesets.Mania/Skinning/Legacy/LegacyHoldNoteTailPiece.cs
index e6d4291d79..7511b008f0 100644
--- a/osu.Game.Rulesets.Mania/Skinning/Legacy/LegacyHoldNoteTailPiece.cs
+++ b/osu.Game.Rulesets.Mania/Skinning/Legacy/LegacyHoldNoteTailPiece.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.
 
+#nullable disable
+
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Game.Rulesets.UI.Scrolling;
diff --git a/osu.Game.Rulesets.Mania/Skinning/Legacy/LegacyKeyArea.cs b/osu.Game.Rulesets.Mania/Skinning/Legacy/LegacyKeyArea.cs
index 9c339345c4..dfd5af89c1 100644
--- a/osu.Game.Rulesets.Mania/Skinning/Legacy/LegacyKeyArea.cs
+++ b/osu.Game.Rulesets.Mania/Skinning/Legacy/LegacyKeyArea.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Rulesets.Mania/Skinning/Legacy/LegacyManiaColumnElement.cs b/osu.Game.Rulesets.Mania/Skinning/Legacy/LegacyManiaColumnElement.cs
index eb5514ba43..ab953ccfb9 100644
--- a/osu.Game.Rulesets.Mania/Skinning/Legacy/LegacyManiaColumnElement.cs
+++ b/osu.Game.Rulesets.Mania/Skinning/Legacy/LegacyManiaColumnElement.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game.Rulesets.Mania/Skinning/Legacy/LegacyManiaJudgementPiece.cs b/osu.Game.Rulesets.Mania/Skinning/Legacy/LegacyManiaJudgementPiece.cs
index 5d662c18d3..d09a73a693 100644
--- a/osu.Game.Rulesets.Mania/Skinning/Legacy/LegacyManiaJudgementPiece.cs
+++ b/osu.Game.Rulesets.Mania/Skinning/Legacy/LegacyManiaJudgementPiece.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Animations;
diff --git a/osu.Game.Rulesets.Mania/Skinning/Legacy/LegacyNotePiece.cs b/osu.Game.Rulesets.Mania/Skinning/Legacy/LegacyNotePiece.cs
index 321a87f8b1..f185c8b99d 100644
--- a/osu.Game.Rulesets.Mania/Skinning/Legacy/LegacyNotePiece.cs
+++ b/osu.Game.Rulesets.Mania/Skinning/Legacy/LegacyNotePiece.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.
 
+#nullable disable
+
 using JetBrains.Annotations;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game.Rulesets.Mania/Skinning/Legacy/LegacyStageBackground.cs b/osu.Game.Rulesets.Mania/Skinning/Legacy/LegacyStageBackground.cs
index fdacc75c92..740ccbfe27 100644
--- a/osu.Game.Rulesets.Mania/Skinning/Legacy/LegacyStageBackground.cs
+++ b/osu.Game.Rulesets.Mania/Skinning/Legacy/LegacyStageBackground.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game.Rulesets.Mania/Skinning/Legacy/LegacyStageForeground.cs b/osu.Game.Rulesets.Mania/Skinning/Legacy/LegacyStageForeground.cs
index 4e1952a670..f7c611d551 100644
--- a/osu.Game.Rulesets.Mania/Skinning/Legacy/LegacyStageForeground.cs
+++ b/osu.Game.Rulesets.Mania/Skinning/Legacy/LegacyStageForeground.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Rulesets.Mania/Skinning/Legacy/ManiaLegacySkinTransformer.cs b/osu.Game.Rulesets.Mania/Skinning/Legacy/ManiaLegacySkinTransformer.cs
index 315b4444c2..dd5baa8150 100644
--- a/osu.Game.Rulesets.Mania/Skinning/Legacy/ManiaLegacySkinTransformer.cs
+++ b/osu.Game.Rulesets.Mania/Skinning/Legacy/ManiaLegacySkinTransformer.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Diagnostics;
diff --git a/osu.Game.Rulesets.Mania/Skinning/ManiaSkinConfigExtensions.cs b/osu.Game.Rulesets.Mania/Skinning/ManiaSkinConfigExtensions.cs
index 2e17a6bef1..4d0c321116 100644
--- a/osu.Game.Rulesets.Mania/Skinning/ManiaSkinConfigExtensions.cs
+++ b/osu.Game.Rulesets.Mania/Skinning/ManiaSkinConfigExtensions.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.
 
+#nullable disable
+
 using osu.Framework.Bindables;
 using osu.Game.Skinning;
 
diff --git a/osu.Game.Rulesets.Mania/Skinning/ManiaSkinConfigurationLookup.cs b/osu.Game.Rulesets.Mania/Skinning/ManiaSkinConfigurationLookup.cs
index f07a5518b7..e9005a3da0 100644
--- a/osu.Game.Rulesets.Mania/Skinning/ManiaSkinConfigurationLookup.cs
+++ b/osu.Game.Rulesets.Mania/Skinning/ManiaSkinConfigurationLookup.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Mania.UI;
 using osu.Game.Skinning;
 
diff --git a/osu.Game.Rulesets.Mania/UI/Column.cs b/osu.Game.Rulesets.Mania/UI/Column.cs
index a04f5ef98e..deb1b155b5 100644
--- a/osu.Game.Rulesets.Mania/UI/Column.cs
+++ b/osu.Game.Rulesets.Mania/UI/Column.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.
 
+#nullable disable
+
 using osuTK.Graphics;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game.Rulesets.Mania/UI/ColumnFlow.cs b/osu.Game.Rulesets.Mania/UI/ColumnFlow.cs
index aef82d4c08..871ec9f1a3 100644
--- a/osu.Game.Rulesets.Mania/UI/ColumnFlow.cs
+++ b/osu.Game.Rulesets.Mania/UI/ColumnFlow.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Rulesets.Mania/UI/Components/ColumnBackground.cs b/osu.Game.Rulesets.Mania/UI/Components/ColumnBackground.cs
index 77ddc6fbbf..5bd2d3ab48 100644
--- a/osu.Game.Rulesets.Mania/UI/Components/ColumnBackground.cs
+++ b/osu.Game.Rulesets.Mania/UI/Components/ColumnBackground.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Extensions.Color4Extensions;
diff --git a/osu.Game.Rulesets.Mania/UI/Components/ColumnHitObjectArea.cs b/osu.Game.Rulesets.Mania/UI/Components/ColumnHitObjectArea.cs
index 51c138f5e1..b26b62f8a5 100644
--- a/osu.Game.Rulesets.Mania/UI/Components/ColumnHitObjectArea.cs
+++ b/osu.Game.Rulesets.Mania/UI/Components/ColumnHitObjectArea.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Rulesets.UI;
diff --git a/osu.Game.Rulesets.Mania/UI/Components/DefaultColumnBackground.cs b/osu.Game.Rulesets.Mania/UI/Components/DefaultColumnBackground.cs
index 807f6a77d9..39d17db6be 100644
--- a/osu.Game.Rulesets.Mania/UI/Components/DefaultColumnBackground.cs
+++ b/osu.Game.Rulesets.Mania/UI/Components/DefaultColumnBackground.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Extensions.Color4Extensions;
diff --git a/osu.Game.Rulesets.Mania/UI/Components/DefaultHitTarget.cs b/osu.Game.Rulesets.Mania/UI/Components/DefaultHitTarget.cs
index ec6c377a2e..53fa86125f 100644
--- a/osu.Game.Rulesets.Mania/UI/Components/DefaultHitTarget.cs
+++ b/osu.Game.Rulesets.Mania/UI/Components/DefaultHitTarget.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Extensions.Color4Extensions;
diff --git a/osu.Game.Rulesets.Mania/UI/Components/DefaultKeyArea.cs b/osu.Game.Rulesets.Mania/UI/Components/DefaultKeyArea.cs
index 15018b464f..5a0fab2ff4 100644
--- a/osu.Game.Rulesets.Mania/UI/Components/DefaultKeyArea.cs
+++ b/osu.Game.Rulesets.Mania/UI/Components/DefaultKeyArea.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Extensions.Color4Extensions;
diff --git a/osu.Game.Rulesets.Mania/UI/Components/DefaultStageBackground.cs b/osu.Game.Rulesets.Mania/UI/Components/DefaultStageBackground.cs
index f5b542d085..20d80580bf 100644
--- a/osu.Game.Rulesets.Mania/UI/Components/DefaultStageBackground.cs
+++ b/osu.Game.Rulesets.Mania/UI/Components/DefaultStageBackground.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game.Rulesets.Mania/UI/Components/HitObjectArea.cs b/osu.Game.Rulesets.Mania/UI/Components/HitObjectArea.cs
index b75b586ecf..7f4b8eacde 100644
--- a/osu.Game.Rulesets.Mania/UI/Components/HitObjectArea.cs
+++ b/osu.Game.Rulesets.Mania/UI/Components/HitObjectArea.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Rulesets.Mania/UI/DefaultHitExplosion.cs b/osu.Game.Rulesets.Mania/UI/DefaultHitExplosion.cs
index 562d7b04c4..e83cd10d2d 100644
--- a/osu.Game.Rulesets.Mania/UI/DefaultHitExplosion.cs
+++ b/osu.Game.Rulesets.Mania/UI/DefaultHitExplosion.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Extensions.Color4Extensions;
diff --git a/osu.Game.Rulesets.Mania/UI/DrawableManiaJudgement.cs b/osu.Game.Rulesets.Mania/UI/DrawableManiaJudgement.cs
index 8581f016b1..923fc6863c 100644
--- a/osu.Game.Rulesets.Mania/UI/DrawableManiaJudgement.cs
+++ b/osu.Game.Rulesets.Mania/UI/DrawableManiaJudgement.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Game.Rulesets.Judgements;
 using osu.Game.Rulesets.Objects.Drawables;
diff --git a/osu.Game.Rulesets.Mania/UI/DrawableManiaRuleset.cs b/osu.Game.Rulesets.Mania/UI/DrawableManiaRuleset.cs
index 28e970f397..ea3b438ec8 100644
--- a/osu.Game.Rulesets.Mania/UI/DrawableManiaRuleset.cs
+++ b/osu.Game.Rulesets.Mania/UI/DrawableManiaRuleset.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game.Rulesets.Mania/UI/IHitExplosion.cs b/osu.Game.Rulesets.Mania/UI/IHitExplosion.cs
index 3252dcc276..74ddceeeef 100644
--- a/osu.Game.Rulesets.Mania/UI/IHitExplosion.cs
+++ b/osu.Game.Rulesets.Mania/UI/IHitExplosion.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Judgements;
 
 namespace osu.Game.Rulesets.Mania.UI
diff --git a/osu.Game.Rulesets.Mania/UI/ManiaPlayfield.cs b/osu.Game.Rulesets.Mania/UI/ManiaPlayfield.cs
index 4cd6624ac6..99b36bd366 100644
--- a/osu.Game.Rulesets.Mania/UI/ManiaPlayfield.cs
+++ b/osu.Game.Rulesets.Mania/UI/ManiaPlayfield.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using System;
diff --git a/osu.Game.Rulesets.Mania/UI/ManiaPlayfieldAdjustmentContainer.cs b/osu.Game.Rulesets.Mania/UI/ManiaPlayfieldAdjustmentContainer.cs
index 30e0aafb7d..8020fcb3cc 100644
--- a/osu.Game.Rulesets.Mania/UI/ManiaPlayfieldAdjustmentContainer.cs
+++ b/osu.Game.Rulesets.Mania/UI/ManiaPlayfieldAdjustmentContainer.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Game.Rulesets.UI;
 
diff --git a/osu.Game.Rulesets.Mania/UI/ManiaReplayRecorder.cs b/osu.Game.Rulesets.Mania/UI/ManiaReplayRecorder.cs
index b502d1f9e5..87d6c25ac2 100644
--- a/osu.Game.Rulesets.Mania/UI/ManiaReplayRecorder.cs
+++ b/osu.Game.Rulesets.Mania/UI/ManiaReplayRecorder.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Game.Rulesets.Mania.Replays;
 using osu.Game.Rulesets.Replays;
diff --git a/osu.Game.Rulesets.Mania/UI/ManiaScrollingDirection.cs b/osu.Game.Rulesets.Mania/UI/ManiaScrollingDirection.cs
index 98165fedeb..44fe4b1b30 100644
--- a/osu.Game.Rulesets.Mania/UI/ManiaScrollingDirection.cs
+++ b/osu.Game.Rulesets.Mania/UI/ManiaScrollingDirection.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.UI.Scrolling;
 
 namespace osu.Game.Rulesets.Mania.UI
diff --git a/osu.Game.Rulesets.Mania/UI/OrderedHitPolicy.cs b/osu.Game.Rulesets.Mania/UI/OrderedHitPolicy.cs
index 961858b62b..c39e21bace 100644
--- a/osu.Game.Rulesets.Mania/UI/OrderedHitPolicy.cs
+++ b/osu.Game.Rulesets.Mania/UI/OrderedHitPolicy.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Framework.Extensions.IEnumerableExtensions;
 using osu.Game.Rulesets.Mania.Objects.Drawables;
diff --git a/osu.Game.Rulesets.Mania/UI/PlayfieldCoveringWrapper.cs b/osu.Game.Rulesets.Mania/UI/PlayfieldCoveringWrapper.cs
index 15d216e8c5..d397e7cc18 100644
--- a/osu.Game.Rulesets.Mania/UI/PlayfieldCoveringWrapper.cs
+++ b/osu.Game.Rulesets.Mania/UI/PlayfieldCoveringWrapper.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Extensions.Color4Extensions;
diff --git a/osu.Game.Rulesets.Mania/UI/PoolableHitExplosion.cs b/osu.Game.Rulesets.Mania/UI/PoolableHitExplosion.cs
index 9f4963b022..28509d1f4e 100644
--- a/osu.Game.Rulesets.Mania/UI/PoolableHitExplosion.cs
+++ b/osu.Game.Rulesets.Mania/UI/PoolableHitExplosion.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Pooling;
diff --git a/osu.Game.Rulesets.Mania/UI/Stage.cs b/osu.Game.Rulesets.Mania/UI/Stage.cs
index 94910bb410..c578bbb703 100644
--- a/osu.Game.Rulesets.Mania/UI/Stage.cs
+++ b/osu.Game.Rulesets.Mania/UI/Stage.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Rulesets.Mania/VariantMappingGenerator.cs b/osu.Game.Rulesets.Mania/VariantMappingGenerator.cs
index 878d1088a6..2742ee087b 100644
--- a/osu.Game.Rulesets.Mania/VariantMappingGenerator.cs
+++ b/osu.Game.Rulesets.Mania/VariantMappingGenerator.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Framework.Input.Bindings;
 
diff --git a/osu.Game.Rulesets.Osu.Tests.Android/MainActivity.cs b/osu.Game.Rulesets.Osu.Tests.Android/MainActivity.cs
index 46c60f06a5..9b4226d5b6 100644
--- a/osu.Game.Rulesets.Osu.Tests.Android/MainActivity.cs
+++ b/osu.Game.Rulesets.Osu.Tests.Android/MainActivity.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.
 
+#nullable disable
+
 using Android.App;
 using osu.Framework.Android;
 using osu.Game.Tests;
diff --git a/osu.Game.Rulesets.Osu.Tests.iOS/AppDelegate.cs b/osu.Game.Rulesets.Osu.Tests.iOS/AppDelegate.cs
index 01e635f09c..fa40a8536e 100644
--- a/osu.Game.Rulesets.Osu.Tests.iOS/AppDelegate.cs
+++ b/osu.Game.Rulesets.Osu.Tests.iOS/AppDelegate.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.
 
+#nullable disable
+
 using Foundation;
 using osu.Framework.iOS;
 using osu.Game.Tests;
diff --git a/osu.Game.Rulesets.Osu.Tests.iOS/Application.cs b/osu.Game.Rulesets.Osu.Tests.iOS/Application.cs
index be38a883d7..ad23f3ee33 100644
--- a/osu.Game.Rulesets.Osu.Tests.iOS/Application.cs
+++ b/osu.Game.Rulesets.Osu.Tests.iOS/Application.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.
 
+#nullable disable
+
 using osu.Framework.iOS;
 using UIKit;
 
diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/Checks/CheckLowDiffOverlapsTest.cs b/osu.Game.Rulesets.Osu.Tests/Editor/Checks/CheckLowDiffOverlapsTest.cs
index fd17d11d10..7a361b0821 100644
--- a/osu.Game.Rulesets.Osu.Tests/Editor/Checks/CheckLowDiffOverlapsTest.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Editor/Checks/CheckLowDiffOverlapsTest.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using Moq;
diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/Checks/CheckOffscreenObjectsTest.cs b/osu.Game.Rulesets.Osu.Tests/Editor/Checks/CheckOffscreenObjectsTest.cs
index a6873c6de9..a778b76c67 100644
--- a/osu.Game.Rulesets.Osu.Tests/Editor/Checks/CheckOffscreenObjectsTest.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Editor/Checks/CheckOffscreenObjectsTest.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/Checks/CheckTimeDistanceEqualityTest.cs b/osu.Game.Rulesets.Osu.Tests/Editor/Checks/CheckTimeDistanceEqualityTest.cs
index 49a6fd12fa..4e8be75779 100644
--- a/osu.Game.Rulesets.Osu.Tests/Editor/Checks/CheckTimeDistanceEqualityTest.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Editor/Checks/CheckTimeDistanceEqualityTest.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using Moq;
diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/Checks/CheckTooShortSlidersTest.cs b/osu.Game.Rulesets.Osu.Tests/Editor/Checks/CheckTooShortSlidersTest.cs
index 2eab5a4ce6..39a9d5e798 100644
--- a/osu.Game.Rulesets.Osu.Tests/Editor/Checks/CheckTooShortSlidersTest.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Editor/Checks/CheckTooShortSlidersTest.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/Checks/CheckTooShortSpinnersTest.cs b/osu.Game.Rulesets.Osu.Tests/Editor/Checks/CheckTooShortSpinnersTest.cs
index 1f3d4297f1..d044ae732a 100644
--- a/osu.Game.Rulesets.Osu.Tests/Editor/Checks/CheckTooShortSpinnersTest.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Editor/Checks/CheckTooShortSpinnersTest.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneHitCirclePlacementBlueprint.cs b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneHitCirclePlacementBlueprint.cs
index 7bccec6c97..4d84d3e79f 100644
--- a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneHitCirclePlacementBlueprint.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneHitCirclePlacementBlueprint.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Edit;
 using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Objects.Drawables;
diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneHitCircleSelectionBlueprint.cs b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneHitCircleSelectionBlueprint.cs
index 315493318d..fde62c7a53 100644
--- a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneHitCircleSelectionBlueprint.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneHitCircleSelectionBlueprint.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.ControlPoints;
diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneObjectBeatSnap.cs b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneObjectBeatSnap.cs
index a652fb32f4..a8829ef88c 100644
--- a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneObjectBeatSnap.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneObjectBeatSnap.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Testing;
diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneObjectObjectSnap.cs b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneObjectObjectSnap.cs
index 7bdf131e0d..6e8c7ff2bd 100644
--- a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneObjectObjectSnap.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneObjectObjectSnap.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Testing;
diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuDistanceSnapGrid.cs b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuDistanceSnapGrid.cs
index c50aec40a5..e54ce45ccc 100644
--- a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuDistanceSnapGrid.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuDistanceSnapGrid.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.
 
+#nullable disable
+
 using System;
 using NUnit.Framework;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuEditor.cs b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuEditor.cs
index e1ca3ddd61..859290dbec 100644
--- a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuEditor.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuEditor.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Game.Tests.Visual;
 
diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuEditorGrids.cs b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuEditorGrids.cs
index 47b2d3a098..1e73885540 100644
--- a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuEditorGrids.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuEditorGrids.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Testing;
diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuEditorSelectInvalidPath.cs b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuEditorSelectInvalidPath.cs
index d0348c1b6b..536739bd48 100644
--- a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuEditorSelectInvalidPath.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuEditorSelectInvalidPath.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Objects;
diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/TestScenePathControlPointVisualiser.cs b/osu.Game.Rulesets.Osu.Tests/Editor/TestScenePathControlPointVisualiser.cs
index 5a1aa42ed1..f196353f87 100644
--- a/osu.Game.Rulesets.Osu.Tests/Editor/TestScenePathControlPointVisualiser.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Editor/TestScenePathControlPointVisualiser.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderControlPointPiece.cs b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderControlPointPiece.cs
index e7bcd2cadc..a177079b8c 100644
--- a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderControlPointPiece.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderControlPointPiece.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.
 
+#nullable disable
+
 using System.Linq;
 using Humanizer;
 using NUnit.Framework;
diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderLengthValidity.cs b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderLengthValidity.cs
index ce529f2a88..31b593e816 100644
--- a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderLengthValidity.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderLengthValidity.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Testing;
diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderPlacementBlueprint.cs b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderPlacementBlueprint.cs
index e724015905..5c3c537541 100644
--- a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderPlacementBlueprint.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderPlacementBlueprint.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Utils;
 using osu.Game.Rulesets.Edit;
diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderSelectionBlueprint.cs b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderSelectionBlueprint.cs
index cc43eb3852..f84204f01c 100644
--- a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderSelectionBlueprint.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderSelectionBlueprint.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Utils;
 using osu.Game.Beatmaps;
diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderSnapping.cs b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderSnapping.cs
index b43b2b1461..a72f2031c9 100644
--- a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderSnapping.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderSnapping.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Input.Events;
diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderStreamConversion.cs b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderStreamConversion.cs
index 70a9c03e65..51871dd9e5 100644
--- a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderStreamConversion.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderStreamConversion.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Utils;
diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderVelocityAdjust.cs b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderVelocityAdjust.cs
index 4750c97566..3d9fe37e0f 100644
--- a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderVelocityAdjust.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderVelocityAdjust.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.
 
+#nullable disable
+
 using System.Diagnostics;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSpinnerPlacementBlueprint.cs b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSpinnerPlacementBlueprint.cs
index fa6c660b01..53ef675cb3 100644
--- a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSpinnerPlacementBlueprint.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSpinnerPlacementBlueprint.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Edit;
 using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Objects.Drawables;
diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSpinnerSelectionBlueprint.cs b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSpinnerSelectionBlueprint.cs
index 5007841805..a1b946dd4c 100644
--- a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSpinnerSelectionBlueprint.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSpinnerSelectionBlueprint.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Beatmaps;
diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/TestSliderScaling.cs b/osu.Game.Rulesets.Osu.Tests/Editor/TestSliderScaling.cs
index e29a67c770..efe195d872 100644
--- a/osu.Game.Rulesets.Osu.Tests/Editor/TestSliderScaling.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Editor/TestSliderScaling.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Testing;
diff --git a/osu.Game.Rulesets.Osu.Tests/LegacyMainCirclePieceTest.cs b/osu.Game.Rulesets.Osu.Tests/LegacyMainCirclePieceTest.cs
index d8c10b814d..2c4310202e 100644
--- a/osu.Game.Rulesets.Osu.Tests/LegacyMainCirclePieceTest.cs
+++ b/osu.Game.Rulesets.Osu.Tests/LegacyMainCirclePieceTest.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 enable
-
 using System;
 using System.Diagnostics;
 using System.Linq;
diff --git a/osu.Game.Rulesets.Osu.Tests/Mods/OsuModTestScene.cs b/osu.Game.Rulesets.Osu.Tests/Mods/OsuModTestScene.cs
index d3cb3bcf59..4f005a0c70 100644
--- a/osu.Game.Rulesets.Osu.Tests/Mods/OsuModTestScene.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Mods/OsuModTestScene.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.
 
+#nullable disable
+
 using osu.Game.Tests.Visual;
 
 namespace osu.Game.Rulesets.Osu.Tests.Mods
diff --git a/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModAlternate.cs b/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModAlternate.cs
index 5e46498aca..3d59e4fb51 100644
--- a/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModAlternate.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModAlternate.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using NUnit.Framework;
 using osu.Game.Beatmaps;
diff --git a/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModAutoplay.cs b/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModAutoplay.cs
index 37f1a846ad..378b71ccf7 100644
--- a/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModAutoplay.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModAutoplay.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Testing;
diff --git a/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModDifficultyAdjust.cs b/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModDifficultyAdjust.cs
index 9d06ff5801..80dc83d7dc 100644
--- a/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModDifficultyAdjust.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModDifficultyAdjust.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModDoubleTime.cs b/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModDoubleTime.cs
index 335ef31019..e1bed5153b 100644
--- a/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModDoubleTime.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModDoubleTime.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Utils;
 using osu.Game.Rulesets.Osu.Mods;
diff --git a/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModHidden.cs b/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModHidden.cs
index 71b575abe2..5ed25baca3 100644
--- a/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModHidden.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModHidden.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModMagnetised.cs b/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModMagnetised.cs
index 9b49e60363..1f1db04c24 100644
--- a/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModMagnetised.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModMagnetised.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Game.Rulesets.Osu.Mods;
 
diff --git a/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModMuted.cs b/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModMuted.cs
index e08d66fa31..99c9036ac0 100644
--- a/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModMuted.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModMuted.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Testing;
diff --git a/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModNoScope.cs b/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModNoScope.cs
index 44404ca245..47e7ad320c 100644
--- a/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModNoScope.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModNoScope.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModPerfect.cs b/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModPerfect.cs
index 985baa8cf5..b7669624ff 100644
--- a/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModPerfect.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModPerfect.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Objects.Types;
diff --git a/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModSpunOut.cs b/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModSpunOut.cs
index a8953c1a6f..fe8bba3ed8 100644
--- a/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModSpunOut.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModSpunOut.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game.Rulesets.Osu.Tests/OsuBeatmapConversionTest.cs b/osu.Game.Rulesets.Osu.Tests/OsuBeatmapConversionTest.cs
index 4c11efcc7c..bee46da1ba 100644
--- a/osu.Game.Rulesets.Osu.Tests/OsuBeatmapConversionTest.cs
+++ b/osu.Game.Rulesets.Osu.Tests/OsuBeatmapConversionTest.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using NUnit.Framework;
diff --git a/osu.Game.Rulesets.Osu.Tests/OsuDifficultyCalculatorTest.cs b/osu.Game.Rulesets.Osu.Tests/OsuDifficultyCalculatorTest.cs
index df577ea8d3..bb593c2fb3 100644
--- a/osu.Game.Rulesets.Osu.Tests/OsuDifficultyCalculatorTest.cs
+++ b/osu.Game.Rulesets.Osu.Tests/OsuDifficultyCalculatorTest.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Difficulty;
diff --git a/osu.Game.Rulesets.Osu.Tests/OsuLegacyModConversionTest.cs b/osu.Game.Rulesets.Osu.Tests/OsuLegacyModConversionTest.cs
index 51da5b85cd..db9872b152 100644
--- a/osu.Game.Rulesets.Osu.Tests/OsuLegacyModConversionTest.cs
+++ b/osu.Game.Rulesets.Osu.Tests/OsuLegacyModConversionTest.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.
 
+#nullable disable
+
 using System;
 using NUnit.Framework;
 using osu.Game.Beatmaps.Legacy;
diff --git a/osu.Game.Rulesets.Osu.Tests/OsuSkinnableTestScene.cs b/osu.Game.Rulesets.Osu.Tests/OsuSkinnableTestScene.cs
index 233aaf2ed9..415e4ebedd 100644
--- a/osu.Game.Rulesets.Osu.Tests/OsuSkinnableTestScene.cs
+++ b/osu.Game.Rulesets.Osu.Tests/OsuSkinnableTestScene.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Tests.Visual;
diff --git a/osu.Game.Rulesets.Osu.Tests/StackingTest.cs b/osu.Game.Rulesets.Osu.Tests/StackingTest.cs
index 871afdb09d..a2ab7b564c 100644
--- a/osu.Game.Rulesets.Osu.Tests/StackingTest.cs
+++ b/osu.Game.Rulesets.Osu.Tests/StackingTest.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.
 
+#nullable disable
+
 using System;
 using System.IO;
 using System.Linq;
diff --git a/osu.Game.Rulesets.Osu.Tests/TestPlayfieldBorder.cs b/osu.Game.Rulesets.Osu.Tests/TestPlayfieldBorder.cs
index 23d9d265be..106a7f499f 100644
--- a/osu.Game.Rulesets.Osu.Tests/TestPlayfieldBorder.cs
+++ b/osu.Game.Rulesets.Osu.Tests/TestPlayfieldBorder.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.
 
+#nullable disable
+
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game.Rulesets.Osu.Tests/TestSceneAccuracyHeatmap.cs b/osu.Game.Rulesets.Osu.Tests/TestSceneAccuracyHeatmap.cs
index 79150a1941..805f4e6567 100644
--- a/osu.Game.Rulesets.Osu.Tests/TestSceneAccuracyHeatmap.cs
+++ b/osu.Game.Rulesets.Osu.Tests/TestSceneAccuracyHeatmap.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Rulesets.Osu.Tests/TestSceneCursorParticles.cs b/osu.Game.Rulesets.Osu.Tests/TestSceneCursorParticles.cs
index bd39dead34..b5d1c4854c 100644
--- a/osu.Game.Rulesets.Osu.Tests/TestSceneCursorParticles.cs
+++ b/osu.Game.Rulesets.Osu.Tests/TestSceneCursorParticles.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Rulesets.Osu.Tests/TestSceneCursorTrail.cs b/osu.Game.Rulesets.Osu.Tests/TestSceneCursorTrail.cs
index 211b0e8145..c8d2d07be5 100644
--- a/osu.Game.Rulesets.Osu.Tests/TestSceneCursorTrail.cs
+++ b/osu.Game.Rulesets.Osu.Tests/TestSceneCursorTrail.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using NUnit.Framework;
diff --git a/osu.Game.Rulesets.Osu.Tests/TestSceneDrawableJudgement.cs b/osu.Game.Rulesets.Osu.Tests/TestSceneDrawableJudgement.cs
index 7821ae9cf0..cfa1841fb7 100644
--- a/osu.Game.Rulesets.Osu.Tests/TestSceneDrawableJudgement.cs
+++ b/osu.Game.Rulesets.Osu.Tests/TestSceneDrawableJudgement.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game.Rulesets.Osu.Tests/TestSceneFollowPoints.cs b/osu.Game.Rulesets.Osu.Tests/TestSceneFollowPoints.cs
index fe67b63252..305678bb62 100644
--- a/osu.Game.Rulesets.Osu.Tests/TestSceneFollowPoints.cs
+++ b/osu.Game.Rulesets.Osu.Tests/TestSceneFollowPoints.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Rulesets.Osu.Tests/TestSceneGameplayCursor.cs b/osu.Game.Rulesets.Osu.Tests/TestSceneGameplayCursor.cs
index 496d495b43..2edacee9ac 100644
--- a/osu.Game.Rulesets.Osu.Tests/TestSceneGameplayCursor.cs
+++ b/osu.Game.Rulesets.Osu.Tests/TestSceneGameplayCursor.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.
 
+#nullable disable
+
 using System;
 using NUnit.Framework;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Rulesets.Osu.Tests/TestSceneHitCircle.cs b/osu.Game.Rulesets.Osu.Tests/TestSceneHitCircle.cs
index f6e8a771ed..cc69054e23 100644
--- a/osu.Game.Rulesets.Osu.Tests/TestSceneHitCircle.cs
+++ b/osu.Game.Rulesets.Osu.Tests/TestSceneHitCircle.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Rulesets.Osu.Tests/TestSceneHitCircleApplication.cs b/osu.Game.Rulesets.Osu.Tests/TestSceneHitCircleApplication.cs
index 8b3fead366..0bc65ac8e6 100644
--- a/osu.Game.Rulesets.Osu.Tests/TestSceneHitCircleApplication.cs
+++ b/osu.Game.Rulesets.Osu.Tests/TestSceneHitCircleApplication.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Timing;
 using osu.Game.Beatmaps;
diff --git a/osu.Game.Rulesets.Osu.Tests/TestSceneHitCircleArea.cs b/osu.Game.Rulesets.Osu.Tests/TestSceneHitCircleArea.cs
index 07bbd6379a..0cf2ec6b7e 100644
--- a/osu.Game.Rulesets.Osu.Tests/TestSceneHitCircleArea.cs
+++ b/osu.Game.Rulesets.Osu.Tests/TestSceneHitCircleArea.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.
 
+#nullable disable
+
 using System;
 using NUnit.Framework;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Rulesets.Osu.Tests/TestSceneHitCircleComboChange.cs b/osu.Game.Rulesets.Osu.Tests/TestSceneHitCircleComboChange.cs
index ff600172d2..85951a95a2 100644
--- a/osu.Game.Rulesets.Osu.Tests/TestSceneHitCircleComboChange.cs
+++ b/osu.Game.Rulesets.Osu.Tests/TestSceneHitCircleComboChange.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.
 
+#nullable disable
+
 using osu.Framework.Bindables;
 using osu.Game.Rulesets.Osu.Objects;
 
diff --git a/osu.Game.Rulesets.Osu.Tests/TestSceneHitCircleHidden.cs b/osu.Game.Rulesets.Osu.Tests/TestSceneHitCircleHidden.cs
index 45125204b6..a469f3dd99 100644
--- a/osu.Game.Rulesets.Osu.Tests/TestSceneHitCircleHidden.cs
+++ b/osu.Game.Rulesets.Osu.Tests/TestSceneHitCircleHidden.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Game.Rulesets.Osu.Mods;
 
diff --git a/osu.Game.Rulesets.Osu.Tests/TestSceneHitCircleKiai.cs b/osu.Game.Rulesets.Osu.Tests/TestSceneHitCircleKiai.cs
index 2bce8fa7f2..e694871408 100644
--- a/osu.Game.Rulesets.Osu.Tests/TestSceneHitCircleKiai.cs
+++ b/osu.Game.Rulesets.Osu.Tests/TestSceneHitCircleKiai.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.ControlPoints;
diff --git a/osu.Game.Rulesets.Osu.Tests/TestSceneHitCircleLongCombo.cs b/osu.Game.Rulesets.Osu.Tests/TestSceneHitCircleLongCombo.cs
index 4e17c4c363..bcf2449e32 100644
--- a/osu.Game.Rulesets.Osu.Tests/TestSceneHitCircleLongCombo.cs
+++ b/osu.Game.Rulesets.Osu.Tests/TestSceneHitCircleLongCombo.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Osu.Objects;
diff --git a/osu.Game.Rulesets.Osu.Tests/TestSceneLegacyBeatmapSkin.cs b/osu.Game.Rulesets.Osu.Tests/TestSceneLegacyBeatmapSkin.cs
index 8b51225e98..1767d25e77 100644
--- a/osu.Game.Rulesets.Osu.Tests/TestSceneLegacyBeatmapSkin.cs
+++ b/osu.Game.Rulesets.Osu.Tests/TestSceneLegacyBeatmapSkin.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game.Rulesets.Osu.Tests/TestSceneMissHitWindowJudgements.cs b/osu.Game.Rulesets.Osu.Tests/TestSceneMissHitWindowJudgements.cs
index a9325f98f7..0c6afe6c3d 100644
--- a/osu.Game.Rulesets.Osu.Tests/TestSceneMissHitWindowJudgements.cs
+++ b/osu.Game.Rulesets.Osu.Tests/TestSceneMissHitWindowJudgements.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using NUnit.Framework;
 using osu.Game.Beatmaps;
diff --git a/osu.Game.Rulesets.Osu.Tests/TestSceneNoSpinnerStacking.cs b/osu.Game.Rulesets.Osu.Tests/TestSceneNoSpinnerStacking.cs
index 5e92bac986..9e524a1608 100644
--- a/osu.Game.Rulesets.Osu.Tests/TestSceneNoSpinnerStacking.cs
+++ b/osu.Game.Rulesets.Osu.Tests/TestSceneNoSpinnerStacking.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Osu.Objects;
diff --git a/osu.Game.Rulesets.Osu.Tests/TestSceneObjectOrderedHitPolicy.cs b/osu.Game.Rulesets.Osu.Tests/TestSceneObjectOrderedHitPolicy.cs
index d31e7a31f5..1665c40b40 100644
--- a/osu.Game.Rulesets.Osu.Tests/TestSceneObjectOrderedHitPolicy.cs
+++ b/osu.Game.Rulesets.Osu.Tests/TestSceneObjectOrderedHitPolicy.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game.Rulesets.Osu.Tests/TestSceneOsuFlashlight.cs b/osu.Game.Rulesets.Osu.Tests/TestSceneOsuFlashlight.cs
index 19736a7709..e0d1646cb0 100644
--- a/osu.Game.Rulesets.Osu.Tests/TestSceneOsuFlashlight.cs
+++ b/osu.Game.Rulesets.Osu.Tests/TestSceneOsuFlashlight.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Osu.Mods;
 using osu.Game.Tests.Visual;
diff --git a/osu.Game.Rulesets.Osu.Tests/TestSceneOsuHitObjectSamples.cs b/osu.Game.Rulesets.Osu.Tests/TestSceneOsuHitObjectSamples.cs
index e8d98ce3b8..3bc55278d9 100644
--- a/osu.Game.Rulesets.Osu.Tests/TestSceneOsuHitObjectSamples.cs
+++ b/osu.Game.Rulesets.Osu.Tests/TestSceneOsuHitObjectSamples.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.
 
+#nullable disable
+
 using System.Reflection;
 using NUnit.Framework;
 using osu.Framework.IO.Stores;
diff --git a/osu.Game.Rulesets.Osu.Tests/TestSceneOsuPlayer.cs b/osu.Game.Rulesets.Osu.Tests/TestSceneOsuPlayer.cs
index f5b28b36c0..6f378fc8b4 100644
--- a/osu.Game.Rulesets.Osu.Tests/TestSceneOsuPlayer.cs
+++ b/osu.Game.Rulesets.Osu.Tests/TestSceneOsuPlayer.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Game.Tests.Visual;
 
diff --git a/osu.Game.Rulesets.Osu.Tests/TestSceneResumeOverlay.cs b/osu.Game.Rulesets.Osu.Tests/TestSceneResumeOverlay.cs
index a7967c407a..e0d33c0e09 100644
--- a/osu.Game.Rulesets.Osu.Tests/TestSceneResumeOverlay.cs
+++ b/osu.Game.Rulesets.Osu.Tests/TestSceneResumeOverlay.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Cursor;
diff --git a/osu.Game.Rulesets.Osu.Tests/TestSceneShaking.cs b/osu.Game.Rulesets.Osu.Tests/TestSceneShaking.cs
index 43900c9a5c..dd767bf5e0 100644
--- a/osu.Game.Rulesets.Osu.Tests/TestSceneShaking.cs
+++ b/osu.Game.Rulesets.Osu.Tests/TestSceneShaking.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Diagnostics;
 using osu.Framework.Threading;
diff --git a/osu.Game.Rulesets.Osu.Tests/TestSceneSkinFallbacks.cs b/osu.Game.Rulesets.Osu.Tests/TestSceneSkinFallbacks.cs
index 0f362851a9..dd110662b2 100644
--- a/osu.Game.Rulesets.Osu.Tests/TestSceneSkinFallbacks.cs
+++ b/osu.Game.Rulesets.Osu.Tests/TestSceneSkinFallbacks.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game.Rulesets.Osu.Tests/TestSceneSlider.cs b/osu.Game.Rulesets.Osu.Tests/TestSceneSlider.cs
index 03b4254eed..a9ee276a9e 100644
--- a/osu.Game.Rulesets.Osu.Tests/TestSceneSlider.cs
+++ b/osu.Game.Rulesets.Osu.Tests/TestSceneSlider.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Framework.Graphics;
 using osu.Game.Audio;
diff --git a/osu.Game.Rulesets.Osu.Tests/TestSceneSliderApplication.cs b/osu.Game.Rulesets.Osu.Tests/TestSceneSliderApplication.cs
index a40ae611d8..2981f1164d 100644
--- a/osu.Game.Rulesets.Osu.Tests/TestSceneSliderApplication.cs
+++ b/osu.Game.Rulesets.Osu.Tests/TestSceneSliderApplication.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Rulesets.Osu.Tests/TestSceneSliderComboChange.cs b/osu.Game.Rulesets.Osu.Tests/TestSceneSliderComboChange.cs
index 13ced3019e..b48789a709 100644
--- a/osu.Game.Rulesets.Osu.Tests/TestSceneSliderComboChange.cs
+++ b/osu.Game.Rulesets.Osu.Tests/TestSceneSliderComboChange.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.
 
+#nullable disable
+
 using osu.Framework.Bindables;
 using osu.Game.Rulesets.Osu.Objects;
 using osu.Game.Rulesets.Osu.Objects.Drawables;
diff --git a/osu.Game.Rulesets.Osu.Tests/TestSceneSliderHidden.cs b/osu.Game.Rulesets.Osu.Tests/TestSceneSliderHidden.cs
index b2bd727c6a..f70bdf8aa2 100644
--- a/osu.Game.Rulesets.Osu.Tests/TestSceneSliderHidden.cs
+++ b/osu.Game.Rulesets.Osu.Tests/TestSceneSliderHidden.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Game.Rulesets.Osu.Mods;
 
diff --git a/osu.Game.Rulesets.Osu.Tests/TestSceneSliderInput.cs b/osu.Game.Rulesets.Osu.Tests/TestSceneSliderInput.cs
index 2368cc7365..e3cf5e9b05 100644
--- a/osu.Game.Rulesets.Osu.Tests/TestSceneSliderInput.cs
+++ b/osu.Game.Rulesets.Osu.Tests/TestSceneSliderInput.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Rulesets.Osu.Tests/TestSceneSliderSnaking.cs b/osu.Game.Rulesets.Osu.Tests/TestSceneSliderSnaking.cs
index a3aa84d0e7..be2e9c7cb5 100644
--- a/osu.Game.Rulesets.Osu.Tests/TestSceneSliderSnaking.cs
+++ b/osu.Game.Rulesets.Osu.Tests/TestSceneSliderSnaking.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game.Rulesets.Osu.Tests/TestSceneSpinner.cs b/osu.Game.Rulesets.Osu.Tests/TestSceneSpinner.cs
index 2dea9837f3..8dc8f82b86 100644
--- a/osu.Game.Rulesets.Osu.Tests/TestSceneSpinner.cs
+++ b/osu.Game.Rulesets.Osu.Tests/TestSceneSpinner.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Rulesets.Osu.Tests/TestSceneSpinnerApplication.cs b/osu.Game.Rulesets.Osu.Tests/TestSceneSpinnerApplication.cs
index 8c97c02049..14fa77245a 100644
--- a/osu.Game.Rulesets.Osu.Tests/TestSceneSpinnerApplication.cs
+++ b/osu.Game.Rulesets.Osu.Tests/TestSceneSpinnerApplication.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Timing;
 using osu.Game.Beatmaps;
diff --git a/osu.Game.Rulesets.Osu.Tests/TestSceneSpinnerHidden.cs b/osu.Game.Rulesets.Osu.Tests/TestSceneSpinnerHidden.cs
index 91b6a05fe3..b7bc36722a 100644
--- a/osu.Game.Rulesets.Osu.Tests/TestSceneSpinnerHidden.cs
+++ b/osu.Game.Rulesets.Osu.Tests/TestSceneSpinnerHidden.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Game.Rulesets.Osu.Mods;
 
diff --git a/osu.Game.Rulesets.Osu.Tests/TestSceneSpinnerRotation.cs b/osu.Game.Rulesets.Osu.Tests/TestSceneSpinnerRotation.cs
index de795241bf..d1796f2231 100644
--- a/osu.Game.Rulesets.Osu.Tests/TestSceneSpinnerRotation.cs
+++ b/osu.Game.Rulesets.Osu.Tests/TestSceneSpinnerRotation.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game.Rulesets.Osu.Tests/TestSceneStartTimeOrderedHitPolicy.cs b/osu.Game.Rulesets.Osu.Tests/TestSceneStartTimeOrderedHitPolicy.cs
index 53fa3624b8..96b26403e1 100644
--- a/osu.Game.Rulesets.Osu.Tests/TestSceneStartTimeOrderedHitPolicy.cs
+++ b/osu.Game.Rulesets.Osu.Tests/TestSceneStartTimeOrderedHitPolicy.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game.Rulesets.Osu/Beatmaps/OsuBeatmap.cs b/osu.Game.Rulesets.Osu/Beatmaps/OsuBeatmap.cs
index a5282877ee..df146a9511 100644
--- a/osu.Game.Rulesets.Osu/Beatmaps/OsuBeatmap.cs
+++ b/osu.Game.Rulesets.Osu/Beatmaps/OsuBeatmap.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using osu.Game.Beatmaps;
diff --git a/osu.Game.Rulesets.Osu/Beatmaps/OsuBeatmapConverter.cs b/osu.Game.Rulesets.Osu/Beatmaps/OsuBeatmapConverter.cs
index d82186fb52..e9518895be 100644
--- a/osu.Game.Rulesets.Osu/Beatmaps/OsuBeatmapConverter.cs
+++ b/osu.Game.Rulesets.Osu/Beatmaps/OsuBeatmapConverter.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.
 
+#nullable disable
+
 using osuTK;
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Objects;
diff --git a/osu.Game.Rulesets.Osu/Beatmaps/OsuBeatmapProcessor.cs b/osu.Game.Rulesets.Osu/Beatmaps/OsuBeatmapProcessor.cs
index f51f04bf87..da66669550 100644
--- a/osu.Game.Rulesets.Osu/Beatmaps/OsuBeatmapProcessor.cs
+++ b/osu.Game.Rulesets.Osu/Beatmaps/OsuBeatmapProcessor.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Graphics;
 using osu.Game.Beatmaps;
diff --git a/osu.Game.Rulesets.Osu/Configuration/OsuRulesetConfigManager.cs b/osu.Game.Rulesets.Osu/Configuration/OsuRulesetConfigManager.cs
index 9589fd576f..b8ad61e6dd 100644
--- a/osu.Game.Rulesets.Osu/Configuration/OsuRulesetConfigManager.cs
+++ b/osu.Game.Rulesets.Osu/Configuration/OsuRulesetConfigManager.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.
 
+#nullable disable
+
 using osu.Game.Configuration;
 using osu.Game.Rulesets.Configuration;
 using osu.Game.Rulesets.UI;
diff --git a/osu.Game.Rulesets.Osu/Difficulty/Evaluators/AimEvaluator.cs b/osu.Game.Rulesets.Osu/Difficulty/Evaluators/AimEvaluator.cs
index 6906c8af86..0694746cbf 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Evaluators/AimEvaluator.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Evaluators/AimEvaluator.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.
 
+#nullable disable
+
 using System;
 using osu.Game.Rulesets.Difficulty.Preprocessing;
 using osu.Game.Rulesets.Osu.Difficulty.Preprocessing;
diff --git a/osu.Game.Rulesets.Osu/Difficulty/Evaluators/FlashlightEvaluator.cs b/osu.Game.Rulesets.Osu/Difficulty/Evaluators/FlashlightEvaluator.cs
index 619560f0b3..3b0826394c 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Evaluators/FlashlightEvaluator.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Evaluators/FlashlightEvaluator.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.
 
+#nullable disable
+
 using System;
 using osu.Game.Rulesets.Difficulty.Preprocessing;
 using osu.Game.Rulesets.Osu.Difficulty.Preprocessing;
diff --git a/osu.Game.Rulesets.Osu/Difficulty/Evaluators/RhythmEvaluator.cs b/osu.Game.Rulesets.Osu/Difficulty/Evaluators/RhythmEvaluator.cs
index 345789b99d..3ffd45b588 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Evaluators/RhythmEvaluator.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Evaluators/RhythmEvaluator.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.
 
+#nullable disable
+
 using System;
 using osu.Game.Rulesets.Difficulty.Preprocessing;
 using osu.Game.Rulesets.Osu.Difficulty.Preprocessing;
diff --git a/osu.Game.Rulesets.Osu/Difficulty/Evaluators/SpeedEvaluator.cs b/osu.Game.Rulesets.Osu/Difficulty/Evaluators/SpeedEvaluator.cs
index 85203dd157..4b1e12d5c6 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Evaluators/SpeedEvaluator.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Evaluators/SpeedEvaluator.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Utils;
 using osu.Game.Rulesets.Difficulty.Preprocessing;
diff --git a/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyAttributes.cs b/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyAttributes.cs
index 3deed4ea3d..19217015c1 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyAttributes.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyAttributes.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using JetBrains.Annotations;
diff --git a/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs b/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs
index 0fa69c180a..3b5aaa8116 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/OsuDifficultyCalculator.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceAttributes.cs b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceAttributes.cs
index 0aeaf7669f..efb3ade220 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceAttributes.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceAttributes.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using Newtonsoft.Json;
 using osu.Game.Rulesets.Difficulty;
diff --git a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
index d046be9ccb..548a2b8f8a 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
index 20921dd282..c8646ec456 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Preprocessing/OsuDifficultyHitObject.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using osu.Game.Rulesets.Difficulty.Preprocessing;
diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
index df6a5e3d00..9b1fbf9a2e 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Aim.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.
 
+#nullable disable
+
 using System;
 using osu.Game.Rulesets.Difficulty.Preprocessing;
 using osu.Game.Rulesets.Mods;
diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
index 590ab6ea61..14d13ec785 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Flashlight.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using osu.Game.Rulesets.Difficulty.Preprocessing;
diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/OsuStrainSkill.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/OsuStrainSkill.cs
index dcd2c7d321..94b5727e3f 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/OsuStrainSkill.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/OsuStrainSkill.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using osu.Game.Rulesets.Difficulty.Skills;
diff --git a/osu.Game.Rulesets.Osu/Difficulty/Skills/Speed.cs b/osu.Game.Rulesets.Osu/Difficulty/Skills/Speed.cs
index 055e1cb66e..695bb2f8d0 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Skills/Speed.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Skills/Speed.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.
 
+#nullable disable
+
 using System;
 using osu.Game.Rulesets.Difficulty.Preprocessing;
 using osu.Game.Rulesets.Mods;
diff --git a/osu.Game.Rulesets.Osu/Edit/Blueprints/BlueprintPiece.cs b/osu.Game.Rulesets.Osu/Edit/Blueprints/BlueprintPiece.cs
index b9c77d3f56..55b7efc8af 100644
--- a/osu.Game.Rulesets.Osu/Edit/Blueprints/BlueprintPiece.cs
+++ b/osu.Game.Rulesets.Osu/Edit/Blueprints/BlueprintPiece.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.
 
+#nullable disable
+
 using osu.Framework.Graphics.Containers;
 using osu.Game.Rulesets.Osu.Objects;
 
diff --git a/osu.Game.Rulesets.Osu/Edit/Blueprints/HitCircles/Components/HitCircleOverlapMarker.cs b/osu.Game.Rulesets.Osu/Edit/Blueprints/HitCircles/Components/HitCircleOverlapMarker.cs
index ad4be2017e..71cdbc276e 100644
--- a/osu.Game.Rulesets.Osu/Edit/Blueprints/HitCircles/Components/HitCircleOverlapMarker.cs
+++ b/osu.Game.Rulesets.Osu/Edit/Blueprints/HitCircles/Components/HitCircleOverlapMarker.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Shapes;
diff --git a/osu.Game.Rulesets.Osu/Edit/Blueprints/HitCircles/Components/HitCirclePiece.cs b/osu.Game.Rulesets.Osu/Edit/Blueprints/HitCircles/Components/HitCirclePiece.cs
index 0cfc67cedb..984fbb83a8 100644
--- a/osu.Game.Rulesets.Osu/Edit/Blueprints/HitCircles/Components/HitCirclePiece.cs
+++ b/osu.Game.Rulesets.Osu/Edit/Blueprints/HitCircles/Components/HitCirclePiece.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Game.Graphics;
diff --git a/osu.Game.Rulesets.Osu/Edit/Blueprints/HitCircles/HitCirclePlacementBlueprint.cs b/osu.Game.Rulesets.Osu/Edit/Blueprints/HitCircles/HitCirclePlacementBlueprint.cs
index c45a04053f..ff4f61986f 100644
--- a/osu.Game.Rulesets.Osu/Edit/Blueprints/HitCircles/HitCirclePlacementBlueprint.cs
+++ b/osu.Game.Rulesets.Osu/Edit/Blueprints/HitCircles/HitCirclePlacementBlueprint.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.
 
+#nullable disable
+
 using osu.Framework.Input.Events;
 using osu.Game.Rulesets.Edit;
 using osu.Game.Rulesets.Osu.Edit.Blueprints.HitCircles.Components;
diff --git a/osu.Game.Rulesets.Osu/Edit/Blueprints/HitCircles/HitCircleSelectionBlueprint.cs b/osu.Game.Rulesets.Osu/Edit/Blueprints/HitCircles/HitCircleSelectionBlueprint.cs
index 3f9cfe21d4..73756d9326 100644
--- a/osu.Game.Rulesets.Osu/Edit/Blueprints/HitCircles/HitCircleSelectionBlueprint.cs
+++ b/osu.Game.Rulesets.Osu/Edit/Blueprints/HitCircles/HitCircleSelectionBlueprint.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Primitives;
 using osu.Game.Rulesets.Osu.Edit.Blueprints.HitCircles.Components;
diff --git a/osu.Game.Rulesets.Osu/Edit/Blueprints/OsuSelectionBlueprint.cs b/osu.Game.Rulesets.Osu/Edit/Blueprints/OsuSelectionBlueprint.cs
index 2d0c6fe81d..422287918e 100644
--- a/osu.Game.Rulesets.Osu/Edit/Blueprints/OsuSelectionBlueprint.cs
+++ b/osu.Game.Rulesets.Osu/Edit/Blueprints/OsuSelectionBlueprint.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Game.Rulesets.Edit;
 using osu.Game.Rulesets.Objects;
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 d66c9ea4bf..0b9ccc5c37 100644
--- a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointConnectionPiece.cs
+++ b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointConnectionPiece.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.
 
+#nullable disable
+
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
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 09759aa118..92d83d900e 100644
--- a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointPiece.cs
+++ b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointPiece.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
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 e71bde7357..0506e8ab8a 100644
--- a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointVisualiser.cs
+++ b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointVisualiser.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Collections.Specialized;
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 6e22c35ab3..bb967a0a76 100644
--- a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/SliderBodyPiece.cs
+++ b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/SliderBodyPiece.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Framework.Allocation;
 using osu.Game.Graphics;
diff --git a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/SliderCircleOverlay.cs b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/SliderCircleOverlay.cs
index d31d2aed97..d48d43d532 100644
--- a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/SliderCircleOverlay.cs
+++ b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/SliderCircleOverlay.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Rulesets.Osu.Edit.Blueprints.HitCircles.Components;
diff --git a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/SliderPlacementBlueprint.cs b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/SliderPlacementBlueprint.cs
index 501589987d..139bfe7dd3 100644
--- a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/SliderPlacementBlueprint.cs
+++ b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/SliderPlacementBlueprint.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.
 
+#nullable disable
+
 using System.Diagnostics;
 using System.Linq;
 using JetBrains.Annotations;
diff --git a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/SliderPosition.cs b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/SliderPosition.cs
index 616bb17e05..92071d4a57 100644
--- a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/SliderPosition.cs
+++ b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/SliderPosition.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.
 
+#nullable disable
+
 namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders
 {
     public enum SliderPosition
diff --git a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/SliderSelectionBlueprint.cs b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/SliderSelectionBlueprint.cs
index a019f2fb64..bd11cc826f 100644
--- a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/SliderSelectionBlueprint.cs
+++ b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/SliderSelectionBlueprint.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using JetBrains.Annotations;
diff --git a/osu.Game.Rulesets.Osu/Edit/Blueprints/Spinners/Components/SpinnerPiece.cs b/osu.Game.Rulesets.Osu/Edit/Blueprints/Spinners/Components/SpinnerPiece.cs
index 92961b40bc..28690ee0b7 100644
--- a/osu.Game.Rulesets.Osu/Edit/Blueprints/Spinners/Components/SpinnerPiece.cs
+++ b/osu.Game.Rulesets.Osu/Edit/Blueprints/Spinners/Components/SpinnerPiece.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game.Rulesets.Osu/Edit/Blueprints/Spinners/SpinnerPlacementBlueprint.cs b/osu.Game.Rulesets.Osu/Edit/Blueprints/Spinners/SpinnerPlacementBlueprint.cs
index cc4ed0eccf..97d53d8e95 100644
--- a/osu.Game.Rulesets.Osu/Edit/Blueprints/Spinners/SpinnerPlacementBlueprint.cs
+++ b/osu.Game.Rulesets.Osu/Edit/Blueprints/Spinners/SpinnerPlacementBlueprint.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Graphics;
 using osu.Framework.Input.Events;
diff --git a/osu.Game.Rulesets.Osu/Edit/Blueprints/Spinners/SpinnerSelectionBlueprint.cs b/osu.Game.Rulesets.Osu/Edit/Blueprints/Spinners/SpinnerSelectionBlueprint.cs
index ee573d1a01..5240c0bfeb 100644
--- a/osu.Game.Rulesets.Osu/Edit/Blueprints/Spinners/SpinnerSelectionBlueprint.cs
+++ b/osu.Game.Rulesets.Osu/Edit/Blueprints/Spinners/SpinnerSelectionBlueprint.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Osu.Edit.Blueprints.Spinners.Components;
 using osu.Game.Rulesets.Osu.Objects;
 using osuTK;
diff --git a/osu.Game.Rulesets.Osu/Edit/Checks/CheckLowDiffOverlaps.cs b/osu.Game.Rulesets.Osu/Edit/Checks/CheckLowDiffOverlaps.cs
index 084a3e5ea1..57e6a6ad1d 100644
--- a/osu.Game.Rulesets.Osu/Edit/Checks/CheckLowDiffOverlaps.cs
+++ b/osu.Game.Rulesets.Osu/Edit/Checks/CheckLowDiffOverlaps.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Edit;
diff --git a/osu.Game.Rulesets.Osu/Edit/Checks/CheckOffscreenObjects.cs b/osu.Game.Rulesets.Osu/Edit/Checks/CheckOffscreenObjects.cs
index a342c2a821..af3521c35c 100644
--- a/osu.Game.Rulesets.Osu/Edit/Checks/CheckOffscreenObjects.cs
+++ b/osu.Game.Rulesets.Osu/Edit/Checks/CheckOffscreenObjects.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Game.Rulesets.Edit;
 using osu.Game.Rulesets.Edit.Checks.Components;
diff --git a/osu.Game.Rulesets.Osu/Edit/Checks/CheckTimeDistanceEquality.cs b/osu.Game.Rulesets.Osu/Edit/Checks/CheckTimeDistanceEquality.cs
index 585bd35bd9..753ddba710 100644
--- a/osu.Game.Rulesets.Osu/Edit/Checks/CheckTimeDistanceEquality.cs
+++ b/osu.Game.Rulesets.Osu/Edit/Checks/CheckTimeDistanceEquality.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game.Rulesets.Osu/Edit/Checks/CheckTooShortSliders.cs b/osu.Game.Rulesets.Osu/Edit/Checks/CheckTooShortSliders.cs
index 159498c479..75eeb91918 100644
--- a/osu.Game.Rulesets.Osu/Edit/Checks/CheckTooShortSliders.cs
+++ b/osu.Game.Rulesets.Osu/Edit/Checks/CheckTooShortSliders.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Edit;
diff --git a/osu.Game.Rulesets.Osu/Edit/Checks/CheckTooShortSpinners.cs b/osu.Game.Rulesets.Osu/Edit/Checks/CheckTooShortSpinners.cs
index f0aade1b7f..6b4dc01ab1 100644
--- a/osu.Game.Rulesets.Osu/Edit/Checks/CheckTooShortSpinners.cs
+++ b/osu.Game.Rulesets.Osu/Edit/Checks/CheckTooShortSpinners.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Game.Rulesets.Edit;
 using osu.Game.Rulesets.Edit.Checks.Components;
diff --git a/osu.Game.Rulesets.Osu/Edit/DrawableOsuEditorRuleset.cs b/osu.Game.Rulesets.Osu/Edit/DrawableOsuEditorRuleset.cs
index 516b34d807..a5f7707cb3 100644
--- a/osu.Game.Rulesets.Osu/Edit/DrawableOsuEditorRuleset.cs
+++ b/osu.Game.Rulesets.Osu/Edit/DrawableOsuEditorRuleset.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Mods;
diff --git a/osu.Game.Rulesets.Osu/Edit/HitCircleCompositionTool.cs b/osu.Game.Rulesets.Osu/Edit/HitCircleCompositionTool.cs
index 5f7c8b77b0..69187875d7 100644
--- a/osu.Game.Rulesets.Osu/Edit/HitCircleCompositionTool.cs
+++ b/osu.Game.Rulesets.Osu/Edit/HitCircleCompositionTool.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Edit;
diff --git a/osu.Game.Rulesets.Osu/Edit/OsuBeatmapVerifier.cs b/osu.Game.Rulesets.Osu/Edit/OsuBeatmapVerifier.cs
index 221723e4cd..2c67f0bf97 100644
--- a/osu.Game.Rulesets.Osu/Edit/OsuBeatmapVerifier.cs
+++ b/osu.Game.Rulesets.Osu/Edit/OsuBeatmapVerifier.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using osu.Game.Rulesets.Edit;
diff --git a/osu.Game.Rulesets.Osu/Edit/OsuBlueprintContainer.cs b/osu.Game.Rulesets.Osu/Edit/OsuBlueprintContainer.cs
index dc8c3d6107..c0fb0ae7db 100644
--- a/osu.Game.Rulesets.Osu/Edit/OsuBlueprintContainer.cs
+++ b/osu.Game.Rulesets.Osu/Edit/OsuBlueprintContainer.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Edit;
 using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Osu.Edit.Blueprints.HitCircles;
diff --git a/osu.Game.Rulesets.Osu/Edit/OsuDistanceSnapGrid.cs b/osu.Game.Rulesets.Osu/Edit/OsuDistanceSnapGrid.cs
index b11929c1e8..23bf67ff29 100644
--- a/osu.Game.Rulesets.Osu/Edit/OsuDistanceSnapGrid.cs
+++ b/osu.Game.Rulesets.Osu/Edit/OsuDistanceSnapGrid.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.
 
+#nullable disable
+
 using JetBrains.Annotations;
 using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Osu.Objects;
diff --git a/osu.Game.Rulesets.Osu/Edit/OsuHitObjectComposer.cs b/osu.Game.Rulesets.Osu/Edit/OsuHitObjectComposer.cs
index b0d6170190..066a114f66 100644
--- a/osu.Game.Rulesets.Osu/Edit/OsuHitObjectComposer.cs
+++ b/osu.Game.Rulesets.Osu/Edit/OsuHitObjectComposer.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game.Rulesets.Osu/Edit/OsuRectangularPositionSnapGrid.cs b/osu.Game.Rulesets.Osu/Edit/OsuRectangularPositionSnapGrid.cs
index d1c81b51bc..35dad1a4fb 100644
--- a/osu.Game.Rulesets.Osu/Edit/OsuRectangularPositionSnapGrid.cs
+++ b/osu.Game.Rulesets.Osu/Edit/OsuRectangularPositionSnapGrid.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Input.Bindings;
diff --git a/osu.Game.Rulesets.Osu/Edit/OsuSelectionHandler.cs b/osu.Game.Rulesets.Osu/Edit/OsuSelectionHandler.cs
index 70c60ab635..4a6d94f303 100644
--- a/osu.Game.Rulesets.Osu/Edit/OsuSelectionHandler.cs
+++ b/osu.Game.Rulesets.Osu/Edit/OsuSelectionHandler.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 enable
-
 using System.Collections.Generic;
 using System.Linq;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Rulesets.Osu/Edit/Setup/OsuSetupSection.cs b/osu.Game.Rulesets.Osu/Edit/Setup/OsuSetupSection.cs
index 8cb778a2e1..d8471aca1a 100644
--- a/osu.Game.Rulesets.Osu/Edit/Setup/OsuSetupSection.cs
+++ b/osu.Game.Rulesets.Osu/Edit/Setup/OsuSetupSection.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Game.Graphics.UserInterfaceV2;
diff --git a/osu.Game.Rulesets.Osu/Edit/SliderCompositionTool.cs b/osu.Game.Rulesets.Osu/Edit/SliderCompositionTool.cs
index 596224e5c6..0a3fc176ad 100644
--- a/osu.Game.Rulesets.Osu/Edit/SliderCompositionTool.cs
+++ b/osu.Game.Rulesets.Osu/Edit/SliderCompositionTool.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Edit;
diff --git a/osu.Game.Rulesets.Osu/Edit/SpinnerCompositionTool.cs b/osu.Game.Rulesets.Osu/Edit/SpinnerCompositionTool.cs
index c5e90da3bd..3c0cf34010 100644
--- a/osu.Game.Rulesets.Osu/Edit/SpinnerCompositionTool.cs
+++ b/osu.Game.Rulesets.Osu/Edit/SpinnerCompositionTool.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Edit;
diff --git a/osu.Game.Rulesets.Osu/Judgements/ComboResult.cs b/osu.Game.Rulesets.Osu/Judgements/ComboResult.cs
index ad292b0439..9762c676c5 100644
--- a/osu.Game.Rulesets.Osu/Judgements/ComboResult.cs
+++ b/osu.Game.Rulesets.Osu/Judgements/ComboResult.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.
 
+#nullable disable
+
 using System.ComponentModel;
 
 namespace osu.Game.Rulesets.Osu.Judgements
diff --git a/osu.Game.Rulesets.Osu/Judgements/OsuHitCircleJudgementResult.cs b/osu.Game.Rulesets.Osu/Judgements/OsuHitCircleJudgementResult.cs
index 9b33e746b3..5f9faaceb2 100644
--- a/osu.Game.Rulesets.Osu/Judgements/OsuHitCircleJudgementResult.cs
+++ b/osu.Game.Rulesets.Osu/Judgements/OsuHitCircleJudgementResult.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Judgements;
 using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Osu.Objects;
diff --git a/osu.Game.Rulesets.Osu/Judgements/OsuIgnoreJudgement.cs b/osu.Game.Rulesets.Osu/Judgements/OsuIgnoreJudgement.cs
index 1999785efe..1bdb74cd3b 100644
--- a/osu.Game.Rulesets.Osu/Judgements/OsuIgnoreJudgement.cs
+++ b/osu.Game.Rulesets.Osu/Judgements/OsuIgnoreJudgement.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Scoring;
 
 namespace osu.Game.Rulesets.Osu.Judgements
diff --git a/osu.Game.Rulesets.Osu/Judgements/OsuJudgement.cs b/osu.Game.Rulesets.Osu/Judgements/OsuJudgement.cs
index 1a88e2a8b2..a5503d3273 100644
--- a/osu.Game.Rulesets.Osu/Judgements/OsuJudgement.cs
+++ b/osu.Game.Rulesets.Osu/Judgements/OsuJudgement.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Judgements;
 using osu.Game.Rulesets.Scoring;
 
diff --git a/osu.Game.Rulesets.Osu/Judgements/OsuJudgementResult.cs b/osu.Game.Rulesets.Osu/Judgements/OsuJudgementResult.cs
index 15444b847b..50d73fa19d 100644
--- a/osu.Game.Rulesets.Osu/Judgements/OsuJudgementResult.cs
+++ b/osu.Game.Rulesets.Osu/Judgements/OsuJudgementResult.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Judgements;
 using osu.Game.Rulesets.Objects;
 
diff --git a/osu.Game.Rulesets.Osu/Judgements/OsuSpinnerJudgementResult.cs b/osu.Game.Rulesets.Osu/Judgements/OsuSpinnerJudgementResult.cs
index 9f77175398..4229c87b58 100644
--- a/osu.Game.Rulesets.Osu/Judgements/OsuSpinnerJudgementResult.cs
+++ b/osu.Game.Rulesets.Osu/Judgements/OsuSpinnerJudgementResult.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Judgements;
 using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Osu.Objects;
diff --git a/osu.Game.Rulesets.Osu/Judgements/SliderTickJudgement.cs b/osu.Game.Rulesets.Osu/Judgements/SliderTickJudgement.cs
index a088696784..270c1f31fb 100644
--- a/osu.Game.Rulesets.Osu/Judgements/SliderTickJudgement.cs
+++ b/osu.Game.Rulesets.Osu/Judgements/SliderTickJudgement.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Scoring;
 
 namespace osu.Game.Rulesets.Osu.Judgements
diff --git a/osu.Game.Rulesets.Osu/Mods/IHidesApproachCircles.cs b/osu.Game.Rulesets.Osu/Mods/IHidesApproachCircles.cs
index 4a3b187e83..affc0bae6a 100644
--- a/osu.Game.Rulesets.Osu/Mods/IHidesApproachCircles.cs
+++ b/osu.Game.Rulesets.Osu/Mods/IHidesApproachCircles.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.
 
+#nullable disable
+
 namespace osu.Game.Rulesets.Osu.Mods
 {
     /// <summary>
diff --git a/osu.Game.Rulesets.Osu/Mods/IRequiresApproachCircles.cs b/osu.Game.Rulesets.Osu/Mods/IRequiresApproachCircles.cs
index 1458abfe05..a108f5fd14 100644
--- a/osu.Game.Rulesets.Osu/Mods/IRequiresApproachCircles.cs
+++ b/osu.Game.Rulesets.Osu/Mods/IRequiresApproachCircles.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.
 
+#nullable disable
+
 namespace osu.Game.Rulesets.Osu.Mods
 {
     /// <summary>
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModAlternate.cs b/osu.Game.Rulesets.Osu/Mods/OsuModAlternate.cs
index 0832cfb545..622d2df432 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModAlternate.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModAlternate.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModApproachDifferent.cs b/osu.Game.Rulesets.Osu/Mods/OsuModApproachDifferent.cs
index 8b323eefa6..3d4a26b3ff 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModApproachDifferent.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModApproachDifferent.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModAutopilot.cs b/osu.Game.Rulesets.Osu/Mods/OsuModAutopilot.cs
index aaf455e95f..4c9418726c 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModAutopilot.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModAutopilot.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModAutoplay.cs b/osu.Game.Rulesets.Osu/Mods/OsuModAutoplay.cs
index 507b3588bd..d562c37541 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModAutoplay.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModAutoplay.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModBarrelRoll.cs b/osu.Game.Rulesets.Osu/Mods/OsuModBarrelRoll.cs
index 9e71f657ce..71bdd98457 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModBarrelRoll.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModBarrelRoll.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Objects.Drawables;
 using osu.Game.Rulesets.Osu.Objects;
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModBlinds.cs b/osu.Game.Rulesets.Osu/Mods/OsuModBlinds.cs
index 7567c96b50..199c735787 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModBlinds.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModBlinds.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModCinema.cs b/osu.Game.Rulesets.Osu/Mods/OsuModCinema.cs
index 99d7535957..656cf95e77 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModCinema.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModCinema.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModClassic.cs b/osu.Game.Rulesets.Osu/Mods/OsuModClassic.cs
index 76ff361ce3..8a15d730cd 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModClassic.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModClassic.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using osu.Framework.Bindables;
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModDaycore.cs b/osu.Game.Rulesets.Osu/Mods/OsuModDaycore.cs
index 371dfe6a1a..c4cc0b4f48 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModDaycore.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModDaycore.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Mods;
 
 namespace osu.Game.Rulesets.Osu.Mods
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModDeflate.cs b/osu.Game.Rulesets.Osu/Mods/OsuModDeflate.cs
index ee6a7815e2..e95e61312e 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModDeflate.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModDeflate.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.
 
+#nullable disable
+
 using osu.Framework.Bindables;
 using osu.Framework.Graphics.Sprites;
 using osu.Game.Configuration;
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModDifficultyAdjust.cs b/osu.Game.Rulesets.Osu/Mods/OsuModDifficultyAdjust.cs
index 3a6b232f9f..be159523b7 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModDifficultyAdjust.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModDifficultyAdjust.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.
 
+#nullable disable
+
 using System.Linq;
 using osu.Game.Beatmaps;
 using osu.Game.Configuration;
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModDoubleTime.cs b/osu.Game.Rulesets.Osu/Mods/OsuModDoubleTime.cs
index 933c6cde1c..2d19305509 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModDoubleTime.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModDoubleTime.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Mods;
 
 namespace osu.Game.Rulesets.Osu.Mods
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModEasy.cs b/osu.Game.Rulesets.Osu/Mods/OsuModEasy.cs
index 06b5b6cfb8..90b22e8d9c 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModEasy.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModEasy.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Mods;
 
 namespace osu.Game.Rulesets.Osu.Mods
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModFlashlight.cs b/osu.Game.Rulesets.Osu/Mods/OsuModFlashlight.cs
index 44d72fae61..c082805a0e 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModFlashlight.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModFlashlight.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using osu.Framework.Bindables;
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModGrow.cs b/osu.Game.Rulesets.Osu/Mods/OsuModGrow.cs
index 182d6eeb4b..34840de983 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModGrow.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModGrow.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.
 
+#nullable disable
+
 using osu.Framework.Bindables;
 using osu.Framework.Graphics.Sprites;
 using osu.Game.Configuration;
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModHalfTime.cs b/osu.Game.Rulesets.Osu/Mods/OsuModHalfTime.cs
index 4769e7660b..54c5c56ca6 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModHalfTime.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModHalfTime.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Mods;
 
 namespace osu.Game.Rulesets.Osu.Mods
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModHardRock.cs b/osu.Game.Rulesets.Osu/Mods/OsuModHardRock.cs
index 007820b016..fdddfed4d5 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModHardRock.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModHardRock.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using osu.Game.Rulesets.Mods;
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModHidden.cs b/osu.Game.Rulesets.Osu/Mods/OsuModHidden.cs
index fc04e4d091..f9422e1ff9 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModHidden.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModHidden.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.
 
+#nullable disable
+
 using System;
 using System.Diagnostics;
 using System.Linq;
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModMagnetised.cs b/osu.Game.Rulesets.Osu/Mods/OsuModMagnetised.cs
index ca6e9cfb1d..cee40866b1 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModMagnetised.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModMagnetised.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics.Sprites;
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModMirror.cs b/osu.Game.Rulesets.Osu/Mods/OsuModMirror.cs
index 3faca0b01f..1d822a2d4c 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModMirror.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModMirror.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Bindables;
 using osu.Game.Configuration;
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModMuted.cs b/osu.Game.Rulesets.Osu/Mods/OsuModMuted.cs
index 5e3ee37b61..1d4650a379 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModMuted.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModMuted.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Osu.Objects;
 
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModNightcore.cs b/osu.Game.Rulesets.Osu/Mods/OsuModNightcore.cs
index 7780e23a26..e9be56fcc5 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModNightcore.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModNightcore.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Osu.Objects;
 
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModNoFail.cs b/osu.Game.Rulesets.Osu/Mods/OsuModNoFail.cs
index 9f707a5aa6..c20fcf0b1b 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModNoFail.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModNoFail.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using osu.Game.Rulesets.Mods;
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModNoScope.cs b/osu.Game.Rulesets.Osu/Mods/OsuModNoScope.cs
index 8e377ea632..fe415cb967 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModNoScope.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModNoScope.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using osu.Framework.Bindables;
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModObjectScaleTween.cs b/osu.Game.Rulesets.Osu/Mods/OsuModObjectScaleTween.cs
index 70c075276f..d96724929f 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModObjectScaleTween.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModObjectScaleTween.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModPerfect.cs b/osu.Game.Rulesets.Osu/Mods/OsuModPerfect.cs
index da462eb6e8..c5795177d0 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModPerfect.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModPerfect.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Mods;
 
 namespace osu.Game.Rulesets.Osu.Mods
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModRandom.cs b/osu.Game.Rulesets.Osu/Mods/OsuModRandom.cs
index 79ff222a89..4f83154728 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModRandom.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModRandom.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 enable
-
 using System;
 using System.Linq;
 using osu.Framework.Utils;
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModRelax.cs b/osu.Game.Rulesets.Osu/Mods/OsuModRelax.cs
index 5f37c6a0ae..2cf8c278ca 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModRelax.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModRelax.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Diagnostics;
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModSpinIn.cs b/osu.Game.Rulesets.Osu/Mods/OsuModSpinIn.cs
index 95e7d13ee7..16e7780af0 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModSpinIn.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModSpinIn.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Sprites;
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModSpunOut.cs b/osu.Game.Rulesets.Osu/Mods/OsuModSpunOut.cs
index d9ab749ad3..61028a1ee8 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModSpunOut.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModSpunOut.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Sprites;
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModStrictTracking.cs b/osu.Game.Rulesets.Osu/Mods/OsuModStrictTracking.cs
index 0b34ab28a3..565ff415be 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModStrictTracking.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModStrictTracking.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using System.Threading;
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModSuddenDeath.cs b/osu.Game.Rulesets.Osu/Mods/OsuModSuddenDeath.cs
index 429fe30fc5..4eb7659152 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModSuddenDeath.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModSuddenDeath.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using osu.Game.Rulesets.Mods;
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModTarget.cs b/osu.Game.Rulesets.Osu/Mods/OsuModTarget.cs
index c58c624f5c..4589a8eca1 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModTarget.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModTarget.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModTouchDevice.cs b/osu.Game.Rulesets.Osu/Mods/OsuModTouchDevice.cs
index 7276cc753c..f8c1e1639d 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModTouchDevice.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModTouchDevice.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Mods;
 
 namespace osu.Game.Rulesets.Osu.Mods
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModTraceable.cs b/osu.Game.Rulesets.Osu/Mods/OsuModTraceable.cs
index 07ce009cf8..6e5dd45a7a 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModTraceable.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModTraceable.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModTransform.cs b/osu.Game.Rulesets.Osu/Mods/OsuModTransform.cs
index 45ce4d555a..51994a3e1a 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModTransform.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModTransform.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Sprites;
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModWiggle.cs b/osu.Game.Rulesets.Osu/Mods/OsuModWiggle.cs
index 693a5bee0b..3fba2cefd2 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModWiggle.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModWiggle.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Sprites;
diff --git a/osu.Game.Rulesets.Osu/Objects/Drawables/Connections/FollowPoint.cs b/osu.Game.Rulesets.Osu/Objects/Drawables/Connections/FollowPoint.cs
index b989500066..36d8ba0189 100644
--- a/osu.Game.Rulesets.Osu/Objects/Drawables/Connections/FollowPoint.cs
+++ b/osu.Game.Rulesets.Osu/Objects/Drawables/Connections/FollowPoint.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.
 
+#nullable disable
+
 using osu.Framework.Bindables;
 using osuTK;
 using osuTK.Graphics;
diff --git a/osu.Game.Rulesets.Osu/Objects/Drawables/Connections/FollowPointConnection.cs b/osu.Game.Rulesets.Osu/Objects/Drawables/Connections/FollowPointConnection.cs
index e88d09e6d9..0306c99fd5 100644
--- a/osu.Game.Rulesets.Osu/Objects/Drawables/Connections/FollowPointConnection.cs
+++ b/osu.Game.Rulesets.Osu/Objects/Drawables/Connections/FollowPointConnection.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Pooling;
diff --git a/osu.Game.Rulesets.Osu/Objects/Drawables/Connections/FollowPointLifetimeEntry.cs b/osu.Game.Rulesets.Osu/Objects/Drawables/Connections/FollowPointLifetimeEntry.cs
index ad656d2085..cbec5efda7 100644
--- a/osu.Game.Rulesets.Osu/Objects/Drawables/Connections/FollowPointLifetimeEntry.cs
+++ b/osu.Game.Rulesets.Osu/Objects/Drawables/Connections/FollowPointLifetimeEntry.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 enable
-
 using System;
 using System.Diagnostics;
 using osu.Framework.Bindables;
diff --git a/osu.Game.Rulesets.Osu/Objects/Drawables/Connections/FollowPointRenderer.cs b/osu.Game.Rulesets.Osu/Objects/Drawables/Connections/FollowPointRenderer.cs
index 011e9fa85d..4949abccab 100644
--- a/osu.Game.Rulesets.Osu/Objects/Drawables/Connections/FollowPointRenderer.cs
+++ b/osu.Game.Rulesets.Osu/Objects/Drawables/Connections/FollowPointRenderer.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableHitCircle.cs b/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableHitCircle.cs
index f05aea0df4..23e5cb0ad7 100644
--- a/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableHitCircle.cs
+++ b/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableHitCircle.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.
 
+#nullable disable
+
 using System;
 using System.Diagnostics;
 using JetBrains.Annotations;
diff --git a/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableOsuHitObject.cs b/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableOsuHitObject.cs
index fa2d2ba38c..360b28f69f 100644
--- a/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableOsuHitObject.cs
+++ b/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableOsuHitObject.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableOsuJudgement.cs b/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableOsuJudgement.cs
index e4df41a4fe..e137a503a5 100644
--- a/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableOsuJudgement.cs
+++ b/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableOsuJudgement.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Game.Configuration;
diff --git a/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSlider.cs b/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSlider.cs
index c48ab998ba..9e3b762690 100644
--- a/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSlider.cs
+++ b/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSlider.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using JetBrains.Annotations;
diff --git a/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSliderHead.cs b/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSliderHead.cs
index 2b026e6840..70b1bd225f 100644
--- a/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSliderHead.cs
+++ b/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSliderHead.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.
 
+#nullable disable
+
 using System;
 using System.Diagnostics;
 using JetBrains.Annotations;
diff --git a/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSliderRepeat.cs b/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSliderRepeat.cs
index 673211ac6c..1bddc603ac 100644
--- a/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSliderRepeat.cs
+++ b/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSliderRepeat.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using JetBrains.Annotations;
diff --git a/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSliderTail.cs b/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSliderTail.cs
index 64964ed396..df3a12fe33 100644
--- a/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSliderTail.cs
+++ b/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSliderTail.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.
 
+#nullable disable
+
 using System.Diagnostics;
 using JetBrains.Annotations;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSliderTick.cs b/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSliderTick.cs
index c7bfdb02fb..3ffbe68b98 100644
--- a/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSliderTick.cs
+++ b/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSliderTick.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Game.Rulesets.Objects.Drawables;
diff --git a/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSpinner.cs b/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSpinner.cs
index fa095edafa..53f4d21975 100644
--- a/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSpinner.cs
+++ b/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSpinner.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using JetBrains.Annotations;
diff --git a/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSpinnerBonusTick.cs b/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSpinnerBonusTick.cs
index ffeb14b0a8..841f74b751 100644
--- a/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSpinnerBonusTick.cs
+++ b/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSpinnerBonusTick.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.
 
+#nullable disable
+
 namespace osu.Game.Rulesets.Osu.Objects.Drawables
 {
     public class DrawableSpinnerBonusTick : DrawableSpinnerTick
diff --git a/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSpinnerTick.cs b/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSpinnerTick.cs
index 39239c8233..6a15463a32 100644
--- a/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSpinnerTick.cs
+++ b/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSpinnerTick.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 
 namespace osu.Game.Rulesets.Osu.Objects.Drawables
diff --git a/osu.Game.Rulesets.Osu/Objects/Drawables/IRequireTracking.cs b/osu.Game.Rulesets.Osu/Objects/Drawables/IRequireTracking.cs
index b1815b23c9..55de5a0e8d 100644
--- a/osu.Game.Rulesets.Osu/Objects/Drawables/IRequireTracking.cs
+++ b/osu.Game.Rulesets.Osu/Objects/Drawables/IRequireTracking.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.
 
+#nullable disable
+
 namespace osu.Game.Rulesets.Osu.Objects.Drawables
 {
     public interface IRequireTracking
diff --git a/osu.Game.Rulesets.Osu/Objects/Drawables/ITrackSnaking.cs b/osu.Game.Rulesets.Osu/Objects/Drawables/ITrackSnaking.cs
index cae2a7c36d..9e8035a1ee 100644
--- a/osu.Game.Rulesets.Osu/Objects/Drawables/ITrackSnaking.cs
+++ b/osu.Game.Rulesets.Osu/Objects/Drawables/ITrackSnaking.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.
 
+#nullable disable
+
 using osuTK;
 
 namespace osu.Game.Rulesets.Osu.Objects.Drawables
diff --git a/osu.Game.Rulesets.Osu/Objects/Drawables/SkinnableLighting.cs b/osu.Game.Rulesets.Osu/Objects/Drawables/SkinnableLighting.cs
index c72080c9e5..4af4767a3e 100644
--- a/osu.Game.Rulesets.Osu/Objects/Drawables/SkinnableLighting.cs
+++ b/osu.Game.Rulesets.Osu/Objects/Drawables/SkinnableLighting.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Judgements;
 using osu.Game.Rulesets.Objects.Drawables;
 using osu.Game.Skinning;
diff --git a/osu.Game.Rulesets.Osu/Objects/HitCircle.cs b/osu.Game.Rulesets.Osu/Objects/HitCircle.cs
index d652db0fd4..5f43e57ed8 100644
--- a/osu.Game.Rulesets.Osu/Objects/HitCircle.cs
+++ b/osu.Game.Rulesets.Osu/Objects/HitCircle.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Judgements;
 using osu.Game.Rulesets.Osu.Judgements;
 
diff --git a/osu.Game.Rulesets.Osu/Objects/ISliderProgress.cs b/osu.Game.Rulesets.Osu/Objects/ISliderProgress.cs
index 7594f7c2e0..eddd251bda 100644
--- a/osu.Game.Rulesets.Osu/Objects/ISliderProgress.cs
+++ b/osu.Game.Rulesets.Osu/Objects/ISliderProgress.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.
 
+#nullable disable
+
 namespace osu.Game.Rulesets.Osu.Objects
 {
     public interface ISliderProgress
diff --git a/osu.Game.Rulesets.Osu/Objects/OsuHitObject.cs b/osu.Game.Rulesets.Osu/Objects/OsuHitObject.cs
index 8b7de9e109..387342b4a9 100644
--- a/osu.Game.Rulesets.Osu/Objects/OsuHitObject.cs
+++ b/osu.Game.Rulesets.Osu/Objects/OsuHitObject.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using osu.Framework.Bindables;
diff --git a/osu.Game.Rulesets.Osu/Objects/Slider.cs b/osu.Game.Rulesets.Osu/Objects/Slider.cs
index a698311bf7..dcb47347ef 100644
--- a/osu.Game.Rulesets.Osu/Objects/Slider.cs
+++ b/osu.Game.Rulesets.Osu/Objects/Slider.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.
 
+#nullable disable
+
 using osuTK;
 using osu.Game.Rulesets.Objects.Types;
 using System.Collections.Generic;
diff --git a/osu.Game.Rulesets.Osu/Objects/SliderEndCircle.cs b/osu.Game.Rulesets.Osu/Objects/SliderEndCircle.cs
index f893559548..35bec92354 100644
--- a/osu.Game.Rulesets.Osu/Objects/SliderEndCircle.cs
+++ b/osu.Game.Rulesets.Osu/Objects/SliderEndCircle.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.
 
+#nullable disable
+
 using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.ControlPoints;
 using osu.Game.Rulesets.Scoring;
diff --git a/osu.Game.Rulesets.Osu/Objects/SliderHeadCircle.cs b/osu.Game.Rulesets.Osu/Objects/SliderHeadCircle.cs
index 5672283230..2a84b04030 100644
--- a/osu.Game.Rulesets.Osu/Objects/SliderHeadCircle.cs
+++ b/osu.Game.Rulesets.Osu/Objects/SliderHeadCircle.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Judgements;
 using osu.Game.Rulesets.Osu.Judgements;
 
diff --git a/osu.Game.Rulesets.Osu/Objects/SliderRepeat.cs b/osu.Game.Rulesets.Osu/Objects/SliderRepeat.cs
index cca86361c2..7b9316f8ac 100644
--- a/osu.Game.Rulesets.Osu/Objects/SliderRepeat.cs
+++ b/osu.Game.Rulesets.Osu/Objects/SliderRepeat.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Judgements;
 using osu.Game.Rulesets.Osu.Judgements;
 using osu.Game.Rulesets.Scoring;
diff --git a/osu.Game.Rulesets.Osu/Objects/SliderTailCircle.cs b/osu.Game.Rulesets.Osu/Objects/SliderTailCircle.cs
index f9450062f4..87c8117b6b 100644
--- a/osu.Game.Rulesets.Osu/Objects/SliderTailCircle.cs
+++ b/osu.Game.Rulesets.Osu/Objects/SliderTailCircle.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Judgements;
 using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Osu.Judgements;
diff --git a/osu.Game.Rulesets.Osu/Objects/SliderTick.cs b/osu.Game.Rulesets.Osu/Objects/SliderTick.cs
index e7e64954e9..569e9b7c1c 100644
--- a/osu.Game.Rulesets.Osu/Objects/SliderTick.cs
+++ b/osu.Game.Rulesets.Osu/Objects/SliderTick.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.
 
+#nullable disable
+
 using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.ControlPoints;
 using osu.Game.Rulesets.Judgements;
diff --git a/osu.Game.Rulesets.Osu/Objects/Spinner.cs b/osu.Game.Rulesets.Osu/Objects/Spinner.cs
index 1a130e96b3..0e1fe56cea 100644
--- a/osu.Game.Rulesets.Osu/Objects/Spinner.cs
+++ b/osu.Game.Rulesets.Osu/Objects/Spinner.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game.Rulesets.Osu/Objects/SpinnerBonusTick.cs b/osu.Game.Rulesets.Osu/Objects/SpinnerBonusTick.cs
index 2c443cb96b..81cdf5755b 100644
--- a/osu.Game.Rulesets.Osu/Objects/SpinnerBonusTick.cs
+++ b/osu.Game.Rulesets.Osu/Objects/SpinnerBonusTick.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.
 
+#nullable disable
+
 using osu.Game.Audio;
 using osu.Game.Rulesets.Judgements;
 using osu.Game.Rulesets.Scoring;
diff --git a/osu.Game.Rulesets.Osu/Objects/SpinnerTick.cs b/osu.Game.Rulesets.Osu/Objects/SpinnerTick.cs
index d715b9a428..650d02c675 100644
--- a/osu.Game.Rulesets.Osu/Objects/SpinnerTick.cs
+++ b/osu.Game.Rulesets.Osu/Objects/SpinnerTick.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Judgements;
 using osu.Game.Rulesets.Osu.Judgements;
 using osu.Game.Rulesets.Scoring;
diff --git a/osu.Game.Rulesets.Osu/OsuInputManager.cs b/osu.Game.Rulesets.Osu/OsuInputManager.cs
index 5c6b907e42..12256e93d0 100644
--- a/osu.Game.Rulesets.Osu/OsuInputManager.cs
+++ b/osu.Game.Rulesets.Osu/OsuInputManager.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.ComponentModel;
 using osu.Framework.Input;
diff --git a/osu.Game.Rulesets.Osu/OsuRuleset.cs b/osu.Game.Rulesets.Osu/OsuRuleset.cs
index 207e7a4ab0..8b9dc71a8b 100644
--- a/osu.Game.Rulesets.Osu/OsuRuleset.cs
+++ b/osu.Game.Rulesets.Osu/OsuRuleset.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.
 
+#nullable disable
+
 using osu.Game.Beatmaps;
 using osu.Game.Graphics;
 using osu.Game.Rulesets.Mods;
diff --git a/osu.Game.Rulesets.Osu/OsuSkinComponent.cs b/osu.Game.Rulesets.Osu/OsuSkinComponent.cs
index 1d223f231b..82c4005c5e 100644
--- a/osu.Game.Rulesets.Osu/OsuSkinComponent.cs
+++ b/osu.Game.Rulesets.Osu/OsuSkinComponent.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.
 
+#nullable disable
+
 using osu.Game.Skinning;
 
 namespace osu.Game.Rulesets.Osu
diff --git a/osu.Game.Rulesets.Osu/OsuSkinComponents.cs b/osu.Game.Rulesets.Osu/OsuSkinComponents.cs
index 71657ed532..fcf079b6aa 100644
--- a/osu.Game.Rulesets.Osu/OsuSkinComponents.cs
+++ b/osu.Game.Rulesets.Osu/OsuSkinComponents.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.
 
+#nullable disable
+
 namespace osu.Game.Rulesets.Osu
 {
     public enum OsuSkinComponents
diff --git a/osu.Game.Rulesets.Osu/Properties/AssemblyInfo.cs b/osu.Game.Rulesets.Osu/Properties/AssemblyInfo.cs
index c842874635..7fffb1871f 100644
--- a/osu.Game.Rulesets.Osu/Properties/AssemblyInfo.cs
+++ b/osu.Game.Rulesets.Osu/Properties/AssemblyInfo.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.
 
+#nullable disable
+
 using System.Runtime.CompilerServices;
 
 // We publish our internal attributes to other sub-projects of the framework.
diff --git a/osu.Game.Rulesets.Osu/Replays/OsuAutoGenerator.cs b/osu.Game.Rulesets.Osu/Replays/OsuAutoGenerator.cs
index e231550e3e..27029afece 100644
--- a/osu.Game.Rulesets.Osu/Replays/OsuAutoGenerator.cs
+++ b/osu.Game.Rulesets.Osu/Replays/OsuAutoGenerator.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.
 
+#nullable disable
+
 using osuTK;
 using osu.Framework.Utils;
 using osu.Game.Beatmaps;
diff --git a/osu.Game.Rulesets.Osu/Replays/OsuAutoGeneratorBase.cs b/osu.Game.Rulesets.Osu/Replays/OsuAutoGeneratorBase.cs
index 1cb3208c30..b41d123380 100644
--- a/osu.Game.Rulesets.Osu/Replays/OsuAutoGeneratorBase.cs
+++ b/osu.Game.Rulesets.Osu/Replays/OsuAutoGeneratorBase.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.
 
+#nullable disable
+
 using osuTK;
 using osu.Game.Beatmaps;
 using System;
diff --git a/osu.Game.Rulesets.Osu/Replays/OsuFramedReplayInputHandler.cs b/osu.Game.Rulesets.Osu/Replays/OsuFramedReplayInputHandler.cs
index ea36ecc399..8857bfa32d 100644
--- a/osu.Game.Rulesets.Osu/Replays/OsuFramedReplayInputHandler.cs
+++ b/osu.Game.Rulesets.Osu/Replays/OsuFramedReplayInputHandler.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using osu.Framework.Input.StateChanges;
diff --git a/osu.Game.Rulesets.Osu/Replays/OsuReplayFrame.cs b/osu.Game.Rulesets.Osu/Replays/OsuReplayFrame.cs
index 3db81d70da..019d8035ed 100644
--- a/osu.Game.Rulesets.Osu/Replays/OsuReplayFrame.cs
+++ b/osu.Game.Rulesets.Osu/Replays/OsuReplayFrame.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Game.Beatmaps;
 using osu.Game.Replays.Legacy;
diff --git a/osu.Game.Rulesets.Osu/Scoring/OsuHitWindows.cs b/osu.Game.Rulesets.Osu/Scoring/OsuHitWindows.cs
index dafe63a6d1..05fbac625e 100644
--- a/osu.Game.Rulesets.Osu/Scoring/OsuHitWindows.cs
+++ b/osu.Game.Rulesets.Osu/Scoring/OsuHitWindows.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Scoring;
 
 namespace osu.Game.Rulesets.Osu.Scoring
diff --git a/osu.Game.Rulesets.Osu/Scoring/OsuScoreProcessor.cs b/osu.Game.Rulesets.Osu/Scoring/OsuScoreProcessor.cs
index ab0c0850dc..7a71ef6c65 100644
--- a/osu.Game.Rulesets.Osu/Scoring/OsuScoreProcessor.cs
+++ b/osu.Game.Rulesets.Osu/Scoring/OsuScoreProcessor.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Judgements;
 using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Osu.Judgements;
diff --git a/osu.Game.Rulesets.Osu/Skinning/Default/CirclePiece.cs b/osu.Game.Rulesets.Osu/Skinning/Default/CirclePiece.cs
index cb68d4b7a7..40e9f69963 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Default/CirclePiece.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Default/CirclePiece.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game.Rulesets.Osu/Skinning/Default/DefaultApproachCircle.cs b/osu.Game.Rulesets.Osu/Skinning/Default/DefaultApproachCircle.cs
index a522367fe6..251fd8d948 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Default/DefaultApproachCircle.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Default/DefaultApproachCircle.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Rulesets.Osu/Skinning/Default/DefaultSpinner.cs b/osu.Game.Rulesets.Osu/Skinning/Default/DefaultSpinner.cs
index df33bf52be..a215b3b1f0 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Default/DefaultSpinner.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Default/DefaultSpinner.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.
 
+#nullable disable
+
 using System;
 using System.Globalization;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Rulesets.Osu/Skinning/Default/DefaultSpinnerDisc.cs b/osu.Game.Rulesets.Osu/Skinning/Default/DefaultSpinnerDisc.cs
index 4ea0831627..ab14f939d4 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Default/DefaultSpinnerDisc.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Default/DefaultSpinnerDisc.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game.Rulesets.Osu/Skinning/Default/DrawableSliderPath.cs b/osu.Game.Rulesets.Osu/Skinning/Default/DrawableSliderPath.cs
index db077f009d..94f93807d4 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Default/DrawableSliderPath.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Default/DrawableSliderPath.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.
 
+#nullable disable
+
 using osu.Framework.Graphics.Lines;
 using osuTK.Graphics;
 
diff --git a/osu.Game.Rulesets.Osu/Skinning/Default/ExplodePiece.cs b/osu.Game.Rulesets.Osu/Skinning/Default/ExplodePiece.cs
index 510ed225a8..6ee8a12132 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Default/ExplodePiece.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Default/ExplodePiece.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game.Rulesets.Osu/Skinning/Default/FlashPiece.cs b/osu.Game.Rulesets.Osu/Skinning/Default/FlashPiece.cs
index 06ee64d8b3..98a8b39f6f 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Default/FlashPiece.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Default/FlashPiece.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
diff --git a/osu.Game.Rulesets.Osu/Skinning/Default/GlowPiece.cs b/osu.Game.Rulesets.Osu/Skinning/Default/GlowPiece.cs
index f5e01b802e..2360bc2238 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Default/GlowPiece.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Default/GlowPiece.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game.Rulesets.Osu/Skinning/Default/IHasMainCirclePiece.cs b/osu.Game.Rulesets.Osu/Skinning/Default/IHasMainCirclePiece.cs
index 8bb7629542..0ba7998d43 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Default/IHasMainCirclePiece.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Default/IHasMainCirclePiece.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.
 
+#nullable disable
+
 using osu.Game.Skinning;
 
 namespace osu.Game.Rulesets.Osu.Skinning.Default
diff --git a/osu.Game.Rulesets.Osu/Skinning/Default/KiaiFlash.cs b/osu.Game.Rulesets.Osu/Skinning/Default/KiaiFlash.cs
index 506f679836..a1cfd170a6 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Default/KiaiFlash.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Default/KiaiFlash.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Audio.Track;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Rulesets.Osu/Skinning/Default/MainCirclePiece.cs b/osu.Game.Rulesets.Osu/Skinning/Default/MainCirclePiece.cs
index d7ebe9333d..4acc406ae1 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Default/MainCirclePiece.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Default/MainCirclePiece.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Rulesets.Osu/Skinning/Default/ManualSliderBody.cs b/osu.Game.Rulesets.Osu/Skinning/Default/ManualSliderBody.cs
index d73c94eb9b..8d8d9e0d94 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Default/ManualSliderBody.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Default/ManualSliderBody.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osuTK;
 
diff --git a/osu.Game.Rulesets.Osu/Skinning/Default/NumberPiece.cs b/osu.Game.Rulesets.Osu/Skinning/Default/NumberPiece.cs
index 43d8d1e27f..f6759c1093 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Default/NumberPiece.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Default/NumberPiece.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.
 
+#nullable disable
+
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game.Rulesets.Osu/Skinning/Default/PlaySliderBody.cs b/osu.Game.Rulesets.Osu/Skinning/Default/PlaySliderBody.cs
index 8602ebc88b..83f7bb8904 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Default/PlaySliderBody.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Default/PlaySliderBody.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Game.Rulesets.Objects.Drawables;
diff --git a/osu.Game.Rulesets.Osu/Skinning/Default/ReverseArrowPiece.cs b/osu.Game.Rulesets.Osu/Skinning/Default/ReverseArrowPiece.cs
index 0009ffc586..8f682d02f6 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Default/ReverseArrowPiece.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Default/ReverseArrowPiece.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Audio.Track;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Rulesets.Osu/Skinning/Default/RingPiece.cs b/osu.Game.Rulesets.Osu/Skinning/Default/RingPiece.cs
index 7f10a7bf56..b941a86171 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Default/RingPiece.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Default/RingPiece.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
diff --git a/osu.Game.Rulesets.Osu/Skinning/Default/SliderBall.cs b/osu.Game.Rulesets.Osu/Skinning/Default/SliderBall.cs
index 710967b741..d2ea8f1660 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Default/SliderBall.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Default/SliderBall.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game.Rulesets.Osu/Skinning/Default/SliderBody.cs b/osu.Game.Rulesets.Osu/Skinning/Default/SliderBody.cs
index 7e6df759f8..9841cc7cdf 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Default/SliderBody.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Default/SliderBody.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Rulesets.Osu/Skinning/Default/SnakingSliderBody.cs b/osu.Game.Rulesets.Osu/Skinning/Default/SnakingSliderBody.cs
index 42d3840158..86dd5f5c74 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Default/SnakingSliderBody.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Default/SnakingSliderBody.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Rulesets.Osu/Skinning/Default/SpinnerBackgroundLayer.cs b/osu.Game.Rulesets.Osu/Skinning/Default/SpinnerBackgroundLayer.cs
index a1184a15cd..a9b7ddf86f 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Default/SpinnerBackgroundLayer.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Default/SpinnerBackgroundLayer.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 
diff --git a/osu.Game.Rulesets.Osu/Skinning/Default/SpinnerCentreLayer.cs b/osu.Game.Rulesets.Osu/Skinning/Default/SpinnerCentreLayer.cs
index 67b5ed5410..ef7b4c2c96 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Default/SpinnerCentreLayer.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Default/SpinnerCentreLayer.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Rulesets.Osu/Skinning/Default/SpinnerFill.cs b/osu.Game.Rulesets.Osu/Skinning/Default/SpinnerFill.cs
index f574ae589e..b7ec9e9799 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Default/SpinnerFill.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Default/SpinnerFill.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Effects;
diff --git a/osu.Game.Rulesets.Osu/Skinning/Default/SpinnerRotationTracker.cs b/osu.Game.Rulesets.Osu/Skinning/Default/SpinnerRotationTracker.cs
index 4313e99b13..f9ed8b8721 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Default/SpinnerRotationTracker.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Default/SpinnerRotationTracker.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game.Rulesets.Osu/Skinning/Default/SpinnerSpmCalculator.cs b/osu.Game.Rulesets.Osu/Skinning/Default/SpinnerSpmCalculator.cs
index a5205bbb8c..df72223214 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Default/SpinnerSpmCalculator.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Default/SpinnerSpmCalculator.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Rulesets.Osu/Skinning/Default/SpinnerTicks.cs b/osu.Game.Rulesets.Osu/Skinning/Default/SpinnerTicks.cs
index e518ae1da8..b66cbe41b6 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Default/SpinnerTicks.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Default/SpinnerTicks.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using osu.Framework.Extensions.Color4Extensions;
diff --git a/osu.Game.Rulesets.Osu/Skinning/Default/TrianglesPiece.cs b/osu.Game.Rulesets.Osu/Skinning/Default/TrianglesPiece.cs
index fa23c60d57..7399ddbd1b 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Default/TrianglesPiece.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Default/TrianglesPiece.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.
 
+#nullable disable
+
 using osu.Game.Graphics.Backgrounds;
 
 namespace osu.Game.Rulesets.Osu.Skinning.Default
diff --git a/osu.Game.Rulesets.Osu/Skinning/IHasApproachCircle.cs b/osu.Game.Rulesets.Osu/Skinning/IHasApproachCircle.cs
index 7fbc5b144b..8ebab97503 100644
--- a/osu.Game.Rulesets.Osu/Skinning/IHasApproachCircle.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/IHasApproachCircle.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 
 namespace osu.Game.Rulesets.Osu.Skinning
diff --git a/osu.Game.Rulesets.Osu/Skinning/Legacy/KiaiFlashingDrawable.cs b/osu.Game.Rulesets.Osu/Skinning/Legacy/KiaiFlashingDrawable.cs
index 4ee28d05b5..152ed5c3d9 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Legacy/KiaiFlashingDrawable.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Legacy/KiaiFlashingDrawable.cs
@@ -7,8 +7,6 @@ using osu.Framework.Graphics;
 using osu.Game.Beatmaps.ControlPoints;
 using osu.Game.Graphics.Containers;
 
-#nullable enable
-
 namespace osu.Game.Rulesets.Osu.Skinning.Legacy
 {
     internal class KiaiFlashingDrawable : BeatSyncedContainer
diff --git a/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyApproachCircle.cs b/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyApproachCircle.cs
index 6a2cb871b1..03406d37ff 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyApproachCircle.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyApproachCircle.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyCursor.cs b/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyCursor.cs
index b2ffc171be..4465f9c266 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyCursor.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyCursor.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Game.Rulesets.Osu.UI.Cursor;
diff --git a/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyCursorParticles.cs b/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyCursorParticles.cs
index b511444c44..ee75b8a857 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyCursorParticles.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyCursorParticles.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyCursorTrail.cs b/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyCursorTrail.cs
index 75d847d54d..e62754c6ce 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyCursorTrail.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyCursorTrail.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyMainCirclePiece.cs b/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyMainCirclePiece.cs
index dd6226e19b..1b2ab82044 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyMainCirclePiece.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyMainCirclePiece.cs
@@ -16,8 +16,6 @@ using osu.Game.Skinning;
 using osuTK;
 using osuTK.Graphics;
 
-#nullable enable
-
 namespace osu.Game.Rulesets.Osu.Skinning.Legacy
 {
     public class LegacyMainCirclePiece : CompositeDrawable
diff --git a/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyNewStyleSpinner.cs b/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyNewStyleSpinner.cs
index a58f62736b..e4ca0d2ea8 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyNewStyleSpinner.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyNewStyleSpinner.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyOldStyleSpinner.cs b/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyOldStyleSpinner.cs
index ea122d47bb..a5a765fc02 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyOldStyleSpinner.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyOldStyleSpinner.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyReverseArrow.cs b/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyReverseArrow.cs
index 7a071b5a03..ff384ee7fc 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyReverseArrow.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyReverseArrow.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.
 
+#nullable disable
+
 using System.Diagnostics;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacySliderBall.cs b/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacySliderBall.cs
index e4e1483665..07e60c82d0 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacySliderBall.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacySliderBall.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacySliderBody.cs b/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacySliderBody.cs
index 29a0745193..dbfec14eb2 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacySliderBody.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacySliderBody.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Game.Rulesets.Osu.Objects;
diff --git a/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacySliderHeadHitCircle.cs b/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacySliderHeadHitCircle.cs
index 7de2b8c7fa..ab39d7c6ef 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacySliderHeadHitCircle.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacySliderHeadHitCircle.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.
 
+#nullable disable
+
 using System.Diagnostics;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacySpinner.cs b/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacySpinner.cs
index 93aba608e6..004222ad7a 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacySpinner.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacySpinner.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.
 
+#nullable disable
+
 using System;
 using System.Globalization;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Rulesets.Osu/Skinning/Legacy/OsuLegacySkinTransformer.cs b/osu.Game.Rulesets.Osu/Skinning/Legacy/OsuLegacySkinTransformer.cs
index 572185e6e1..e7d28a9bd7 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Legacy/OsuLegacySkinTransformer.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Legacy/OsuLegacySkinTransformer.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Rulesets.Osu/Skinning/NonPlayfieldSprite.cs b/osu.Game.Rulesets.Osu/Skinning/NonPlayfieldSprite.cs
index 55257106e2..0b45c770ba 100644
--- a/osu.Game.Rulesets.Osu/Skinning/NonPlayfieldSprite.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/NonPlayfieldSprite.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.
 
+#nullable disable
+
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Graphics.Textures;
 using osu.Game.Rulesets.UI;
diff --git a/osu.Game.Rulesets.Osu/Skinning/OsuSkinColour.cs b/osu.Game.Rulesets.Osu/Skinning/OsuSkinColour.cs
index 24f9217a5f..5d8a2ff606 100644
--- a/osu.Game.Rulesets.Osu/Skinning/OsuSkinColour.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/OsuSkinColour.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.
 
+#nullable disable
+
 namespace osu.Game.Rulesets.Osu.Skinning
 {
     public enum OsuSkinColour
diff --git a/osu.Game.Rulesets.Osu/Skinning/OsuSkinConfiguration.cs b/osu.Game.Rulesets.Osu/Skinning/OsuSkinConfiguration.cs
index 7b9cf8e1d1..306a1e38b9 100644
--- a/osu.Game.Rulesets.Osu/Skinning/OsuSkinConfiguration.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/OsuSkinConfiguration.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.
 
+#nullable disable
+
 namespace osu.Game.Rulesets.Osu.Skinning
 {
     public enum OsuSkinConfiguration
diff --git a/osu.Game.Rulesets.Osu/Statistics/AccuracyHeatmap.cs b/osu.Game.Rulesets.Osu/Statistics/AccuracyHeatmap.cs
index 6c76da7925..acf32da73f 100644
--- a/osu.Game.Rulesets.Osu/Statistics/AccuracyHeatmap.cs
+++ b/osu.Game.Rulesets.Osu/Statistics/AccuracyHeatmap.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.
 
+#nullable disable
+
 using System;
 using System.Diagnostics;
 using System.Linq;
diff --git a/osu.Game.Rulesets.Osu/UI/AnyOrderHitPolicy.cs b/osu.Game.Rulesets.Osu/UI/AnyOrderHitPolicy.cs
index b4de91562b..afa54c2dfb 100644
--- a/osu.Game.Rulesets.Osu/UI/AnyOrderHitPolicy.cs
+++ b/osu.Game.Rulesets.Osu/UI/AnyOrderHitPolicy.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Objects.Drawables;
 using osu.Game.Rulesets.UI;
 
diff --git a/osu.Game.Rulesets.Osu/UI/Cursor/CursorTrail.cs b/osu.Game.Rulesets.Osu/UI/Cursor/CursorTrail.cs
index 62cab4d6d7..c1d518a843 100644
--- a/osu.Game.Rulesets.Osu/UI/Cursor/CursorTrail.cs
+++ b/osu.Game.Rulesets.Osu/UI/Cursor/CursorTrail.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.
 
+#nullable disable
+
 using System;
 using System.Diagnostics;
 using System.Runtime.InteropServices;
diff --git a/osu.Game.Rulesets.Osu/UI/Cursor/OsuCursor.cs b/osu.Game.Rulesets.Osu/UI/Cursor/OsuCursor.cs
index 0e7d7cdcf3..15ef7e538b 100644
--- a/osu.Game.Rulesets.Osu/UI/Cursor/OsuCursor.cs
+++ b/osu.Game.Rulesets.Osu/UI/Cursor/OsuCursor.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Rulesets.Osu/UI/Cursor/OsuCursorContainer.cs b/osu.Game.Rulesets.Osu/UI/Cursor/OsuCursorContainer.cs
index b60ea5da21..533db3ddfe 100644
--- a/osu.Game.Rulesets.Osu/UI/Cursor/OsuCursorContainer.cs
+++ b/osu.Game.Rulesets.Osu/UI/Cursor/OsuCursorContainer.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game.Rulesets.Osu/UI/Cursor/OsuCursorSprite.cs b/osu.Game.Rulesets.Osu/UI/Cursor/OsuCursorSprite.cs
index 573c408a78..03ef79a262 100644
--- a/osu.Game.Rulesets.Osu/UI/Cursor/OsuCursorSprite.cs
+++ b/osu.Game.Rulesets.Osu/UI/Cursor/OsuCursorSprite.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 
diff --git a/osu.Game.Rulesets.Osu/UI/DrawableOsuRuleset.cs b/osu.Game.Rulesets.Osu/UI/DrawableOsuRuleset.cs
index df3f7c64e4..5f430dc921 100644
--- a/osu.Game.Rulesets.Osu/UI/DrawableOsuRuleset.cs
+++ b/osu.Game.Rulesets.Osu/UI/DrawableOsuRuleset.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game.Rulesets.Osu/UI/IHitPolicy.cs b/osu.Game.Rulesets.Osu/UI/IHitPolicy.cs
index 5d8ea035a7..0dac3307c2 100644
--- a/osu.Game.Rulesets.Osu/UI/IHitPolicy.cs
+++ b/osu.Game.Rulesets.Osu/UI/IHitPolicy.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Objects.Drawables;
 using osu.Game.Rulesets.UI;
diff --git a/osu.Game.Rulesets.Osu/UI/ObjectOrderedHitPolicy.cs b/osu.Game.Rulesets.Osu/UI/ObjectOrderedHitPolicy.cs
index 83f205deac..fba225d464 100644
--- a/osu.Game.Rulesets.Osu/UI/ObjectOrderedHitPolicy.cs
+++ b/osu.Game.Rulesets.Osu/UI/ObjectOrderedHitPolicy.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using osu.Game.Rulesets.Objects;
diff --git a/osu.Game.Rulesets.Osu/UI/OsuPlayfield.cs b/osu.Game.Rulesets.Osu/UI/OsuPlayfield.cs
index bc1e80cd12..ad27428010 100644
--- a/osu.Game.Rulesets.Osu/UI/OsuPlayfield.cs
+++ b/osu.Game.Rulesets.Osu/UI/OsuPlayfield.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Diagnostics;
diff --git a/osu.Game.Rulesets.Osu/UI/OsuPlayfieldAdjustmentContainer.cs b/osu.Game.Rulesets.Osu/UI/OsuPlayfieldAdjustmentContainer.cs
index 0d1a5a8304..80f4eb3000 100644
--- a/osu.Game.Rulesets.Osu/UI/OsuPlayfieldAdjustmentContainer.cs
+++ b/osu.Game.Rulesets.Osu/UI/OsuPlayfieldAdjustmentContainer.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Rulesets.UI;
diff --git a/osu.Game.Rulesets.Osu/UI/OsuReplayRecorder.cs b/osu.Game.Rulesets.Osu/UI/OsuReplayRecorder.cs
index 1304dfe416..5964a9b9b6 100644
--- a/osu.Game.Rulesets.Osu/UI/OsuReplayRecorder.cs
+++ b/osu.Game.Rulesets.Osu/UI/OsuReplayRecorder.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Game.Rulesets.Osu.Replays;
 using osu.Game.Rulesets.Replays;
diff --git a/osu.Game.Rulesets.Osu/UI/OsuResumeOverlay.cs b/osu.Game.Rulesets.Osu/UI/OsuResumeOverlay.cs
index 4d4340936d..fc3f89a836 100644
--- a/osu.Game.Rulesets.Osu/UI/OsuResumeOverlay.cs
+++ b/osu.Game.Rulesets.Osu/UI/OsuResumeOverlay.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game.Rulesets.Osu/UI/OsuSettingsSubsection.cs b/osu.Game.Rulesets.Osu/UI/OsuSettingsSubsection.cs
index a638019e69..eff4b30362 100644
--- a/osu.Game.Rulesets.Osu/UI/OsuSettingsSubsection.cs
+++ b/osu.Game.Rulesets.Osu/UI/OsuSettingsSubsection.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Localisation;
diff --git a/osu.Game.Rulesets.Osu/UI/StartTimeOrderedHitPolicy.cs b/osu.Game.Rulesets.Osu/UI/StartTimeOrderedHitPolicy.cs
index 0173156246..edc3ba0818 100644
--- a/osu.Game.Rulesets.Osu/UI/StartTimeOrderedHitPolicy.cs
+++ b/osu.Game.Rulesets.Osu/UI/StartTimeOrderedHitPolicy.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using osu.Game.Rulesets.Objects;
diff --git a/osu.Game.Rulesets.Osu/Utils/OsuHitObjectGenerationUtils.cs b/osu.Game.Rulesets.Osu/Utils/OsuHitObjectGenerationUtils.cs
index 266f7d1251..5e827d4782 100644
--- a/osu.Game.Rulesets.Osu/Utils/OsuHitObjectGenerationUtils.cs
+++ b/osu.Game.Rulesets.Osu/Utils/OsuHitObjectGenerationUtils.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using osu.Framework.Extensions.IEnumerableExtensions;
diff --git a/osu.Game.Rulesets.Osu/Utils/OsuHitObjectGenerationUtils_Reposition.cs b/osu.Game.Rulesets.Osu/Utils/OsuHitObjectGenerationUtils_Reposition.cs
index a77d1f8b0f..c413226e63 100644
--- a/osu.Game.Rulesets.Osu/Utils/OsuHitObjectGenerationUtils_Reposition.cs
+++ b/osu.Game.Rulesets.Osu/Utils/OsuHitObjectGenerationUtils_Reposition.cs
@@ -10,8 +10,6 @@ using osu.Game.Rulesets.Osu.Objects;
 using osu.Game.Rulesets.Osu.UI;
 using osuTK;
 
-#nullable enable
-
 namespace osu.Game.Rulesets.Osu.Utils
 {
     public static partial class OsuHitObjectGenerationUtils
diff --git a/osu.Game.Rulesets.Taiko.Tests.Android/MainActivity.cs b/osu.Game.Rulesets.Taiko.Tests.Android/MainActivity.cs
index e4f4bbfd53..a55b461876 100644
--- a/osu.Game.Rulesets.Taiko.Tests.Android/MainActivity.cs
+++ b/osu.Game.Rulesets.Taiko.Tests.Android/MainActivity.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.
 
+#nullable disable
+
 using Android.App;
 using osu.Framework.Android;
 using osu.Game.Tests;
diff --git a/osu.Game.Rulesets.Taiko.Tests.iOS/AppDelegate.cs b/osu.Game.Rulesets.Taiko.Tests.iOS/AppDelegate.cs
index 567220f316..385ba48707 100644
--- a/osu.Game.Rulesets.Taiko.Tests.iOS/AppDelegate.cs
+++ b/osu.Game.Rulesets.Taiko.Tests.iOS/AppDelegate.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.
 
+#nullable disable
+
 using Foundation;
 using osu.Framework.iOS;
 using osu.Game.Tests;
diff --git a/osu.Game.Rulesets.Taiko.Tests.iOS/Application.cs b/osu.Game.Rulesets.Taiko.Tests.iOS/Application.cs
index 9fde65a074..1ebbd61a94 100644
--- a/osu.Game.Rulesets.Taiko.Tests.iOS/Application.cs
+++ b/osu.Game.Rulesets.Taiko.Tests.iOS/Application.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.
 
+#nullable disable
+
 using osu.Framework.iOS;
 using UIKit;
 
diff --git a/osu.Game.Rulesets.Taiko.Tests/DrawableTaikoRulesetTestScene.cs b/osu.Game.Rulesets.Taiko.Tests/DrawableTaikoRulesetTestScene.cs
index f5e7304c12..a9b7e04caf 100644
--- a/osu.Game.Rulesets.Taiko.Tests/DrawableTaikoRulesetTestScene.cs
+++ b/osu.Game.Rulesets.Taiko.Tests/DrawableTaikoRulesetTestScene.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Rulesets.Taiko.Tests/DrawableTestHit.cs b/osu.Game.Rulesets.Taiko.Tests/DrawableTestHit.cs
index 6d4cac0ebe..6a585b840d 100644
--- a/osu.Game.Rulesets.Taiko.Tests/DrawableTestHit.cs
+++ b/osu.Game.Rulesets.Taiko.Tests/DrawableTestHit.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.
 
+#nullable disable
+
 using osu.Framework.Input.Events;
 using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.ControlPoints;
diff --git a/osu.Game.Rulesets.Taiko.Tests/DrawableTestStrongHit.cs b/osu.Game.Rulesets.Taiko.Tests/DrawableTestStrongHit.cs
index ea877c9e17..7355e1dbca 100644
--- a/osu.Game.Rulesets.Taiko.Tests/DrawableTestStrongHit.cs
+++ b/osu.Game.Rulesets.Taiko.Tests/DrawableTestStrongHit.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.
 
+#nullable disable
+
 using System.Linq;
 using osu.Framework.Input.Events;
 using osu.Game.Rulesets.Scoring;
diff --git a/osu.Game.Rulesets.Taiko.Tests/Editor/TestSceneEditor.cs b/osu.Game.Rulesets.Taiko.Tests/Editor/TestSceneEditor.cs
index e3c1613bd9..5915b9fdfa 100644
--- a/osu.Game.Rulesets.Taiko.Tests/Editor/TestSceneEditor.cs
+++ b/osu.Game.Rulesets.Taiko.Tests/Editor/TestSceneEditor.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Game.Tests.Visual;
 
diff --git a/osu.Game.Rulesets.Taiko.Tests/Editor/TestSceneTaikoEditorSaving.cs b/osu.Game.Rulesets.Taiko.Tests/Editor/TestSceneTaikoEditorSaving.cs
index 33c2ba532e..06c06f6e28 100644
--- a/osu.Game.Rulesets.Taiko.Tests/Editor/TestSceneTaikoEditorSaving.cs
+++ b/osu.Game.Rulesets.Taiko.Tests/Editor/TestSceneTaikoEditorSaving.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Utils;
 using osu.Game.Rulesets.Taiko.Beatmaps;
diff --git a/osu.Game.Rulesets.Taiko.Tests/Editor/TestSceneTaikoHitObjectComposer.cs b/osu.Game.Rulesets.Taiko.Tests/Editor/TestSceneTaikoHitObjectComposer.cs
index 55eb2fa66b..16f17f4131 100644
--- a/osu.Game.Rulesets.Taiko.Tests/Editor/TestSceneTaikoHitObjectComposer.cs
+++ b/osu.Game.Rulesets.Taiko.Tests/Editor/TestSceneTaikoHitObjectComposer.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Rulesets.Taiko.Tests/HitObjectApplicationTestScene.cs b/osu.Game.Rulesets.Taiko.Tests/HitObjectApplicationTestScene.cs
index ac01508081..09a6a2f16c 100644
--- a/osu.Game.Rulesets.Taiko.Tests/HitObjectApplicationTestScene.cs
+++ b/osu.Game.Rulesets.Taiko.Tests/HitObjectApplicationTestScene.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Testing;
diff --git a/osu.Game.Rulesets.Taiko.Tests/Mods/TaikoModTestScene.cs b/osu.Game.Rulesets.Taiko.Tests/Mods/TaikoModTestScene.cs
index 3090facf8c..ca2f8102b7 100644
--- a/osu.Game.Rulesets.Taiko.Tests/Mods/TaikoModTestScene.cs
+++ b/osu.Game.Rulesets.Taiko.Tests/Mods/TaikoModTestScene.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.
 
+#nullable disable
+
 using osu.Game.Tests.Visual;
 
 namespace osu.Game.Rulesets.Taiko.Tests.Mods
diff --git a/osu.Game.Rulesets.Taiko.Tests/Mods/TestSceneTaikoModHidden.cs b/osu.Game.Rulesets.Taiko.Tests/Mods/TestSceneTaikoModHidden.cs
index 7abbb9d186..0b28bfee2e 100644
--- a/osu.Game.Rulesets.Taiko.Tests/Mods/TestSceneTaikoModHidden.cs
+++ b/osu.Game.Rulesets.Taiko.Tests/Mods/TestSceneTaikoModHidden.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Game.Rulesets.Taiko.Mods;
diff --git a/osu.Game.Rulesets.Taiko.Tests/Mods/TestSceneTaikoModPerfect.cs b/osu.Game.Rulesets.Taiko.Tests/Mods/TestSceneTaikoModPerfect.cs
index a83cc16413..917462c128 100644
--- a/osu.Game.Rulesets.Taiko.Tests/Mods/TestSceneTaikoModPerfect.cs
+++ b/osu.Game.Rulesets.Taiko.Tests/Mods/TestSceneTaikoModPerfect.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Game.Rulesets.Scoring;
 using osu.Game.Rulesets.Taiko.Mods;
diff --git a/osu.Game.Rulesets.Taiko.Tests/Skinning/TaikoSkinnableTestScene.cs b/osu.Game.Rulesets.Taiko.Tests/Skinning/TaikoSkinnableTestScene.cs
index 69250a14e1..82be26b422 100644
--- a/osu.Game.Rulesets.Taiko.Tests/Skinning/TaikoSkinnableTestScene.cs
+++ b/osu.Game.Rulesets.Taiko.Tests/Skinning/TaikoSkinnableTestScene.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.
 
+#nullable disable
+
 using osu.Game.Tests.Visual;
 
 namespace osu.Game.Rulesets.Taiko.Tests.Skinning
diff --git a/osu.Game.Rulesets.Taiko.Tests/Skinning/TestSceneDrawableBarLine.cs b/osu.Game.Rulesets.Taiko.Tests/Skinning/TestSceneDrawableBarLine.cs
index 16c4148d15..ad6f08dbd4 100644
--- a/osu.Game.Rulesets.Taiko.Tests/Skinning/TestSceneDrawableBarLine.cs
+++ b/osu.Game.Rulesets.Taiko.Tests/Skinning/TestSceneDrawableBarLine.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Rulesets.Taiko.Tests/Skinning/TestSceneDrawableDrumRoll.cs b/osu.Game.Rulesets.Taiko.Tests/Skinning/TestSceneDrawableDrumRoll.cs
index 26a4e85fe5..2d27e0e40e 100644
--- a/osu.Game.Rulesets.Taiko.Tests/Skinning/TestSceneDrawableDrumRoll.cs
+++ b/osu.Game.Rulesets.Taiko.Tests/Skinning/TestSceneDrawableDrumRoll.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Rulesets.Taiko.Tests/Skinning/TestSceneDrawableHit.cs b/osu.Game.Rulesets.Taiko.Tests/Skinning/TestSceneDrawableHit.cs
index c4ee68206c..d5a97f8f88 100644
--- a/osu.Game.Rulesets.Taiko.Tests/Skinning/TestSceneDrawableHit.cs
+++ b/osu.Game.Rulesets.Taiko.Tests/Skinning/TestSceneDrawableHit.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Rulesets.Taiko.Tests/Skinning/TestSceneDrawableTaikoMascot.cs b/osu.Game.Rulesets.Taiko.Tests/Skinning/TestSceneDrawableTaikoMascot.cs
index 920a7cd1a1..1bf6c0560a 100644
--- a/osu.Game.Rulesets.Taiko.Tests/Skinning/TestSceneDrawableTaikoMascot.cs
+++ b/osu.Game.Rulesets.Taiko.Tests/Skinning/TestSceneDrawableTaikoMascot.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using Humanizer;
diff --git a/osu.Game.Rulesets.Taiko.Tests/Skinning/TestSceneHitExplosion.cs b/osu.Game.Rulesets.Taiko.Tests/Skinning/TestSceneHitExplosion.cs
index 1cba6c9008..f87e0355ad 100644
--- a/osu.Game.Rulesets.Taiko.Tests/Skinning/TestSceneHitExplosion.cs
+++ b/osu.Game.Rulesets.Taiko.Tests/Skinning/TestSceneHitExplosion.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Extensions.IEnumerableExtensions;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Rulesets.Taiko.Tests/Skinning/TestSceneInputDrum.cs b/osu.Game.Rulesets.Taiko.Tests/Skinning/TestSceneInputDrum.cs
index 24db046748..ca3e12cfd5 100644
--- a/osu.Game.Rulesets.Taiko.Tests/Skinning/TestSceneInputDrum.cs
+++ b/osu.Game.Rulesets.Taiko.Tests/Skinning/TestSceneInputDrum.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Rulesets.Taiko.Tests/Skinning/TestSceneKiaiHitExplosion.cs b/osu.Game.Rulesets.Taiko.Tests/Skinning/TestSceneKiaiHitExplosion.cs
index 419e100296..e1a3c736fe 100644
--- a/osu.Game.Rulesets.Taiko.Tests/Skinning/TestSceneKiaiHitExplosion.cs
+++ b/osu.Game.Rulesets.Taiko.Tests/Skinning/TestSceneKiaiHitExplosion.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game.Rulesets.Taiko.Tests/Skinning/TestSceneTaikoPlayfield.cs b/osu.Game.Rulesets.Taiko.Tests/Skinning/TestSceneTaikoPlayfield.cs
index 6f2fcd08f1..52d24b567f 100644
--- a/osu.Game.Rulesets.Taiko.Tests/Skinning/TestSceneTaikoPlayfield.cs
+++ b/osu.Game.Rulesets.Taiko.Tests/Skinning/TestSceneTaikoPlayfield.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.IEnumerableExtensions;
diff --git a/osu.Game.Rulesets.Taiko.Tests/Skinning/TestSceneTaikoScroller.cs b/osu.Game.Rulesets.Taiko.Tests/Skinning/TestSceneTaikoScroller.cs
index 9882c7bc90..954b4be7f3 100644
--- a/osu.Game.Rulesets.Taiko.Tests/Skinning/TestSceneTaikoScroller.cs
+++ b/osu.Game.Rulesets.Taiko.Tests/Skinning/TestSceneTaikoScroller.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.
 
+#nullable disable
+
 using osu.Framework.Extensions.IEnumerableExtensions;
 using osu.Framework.Testing;
 using osu.Framework.Timing;
diff --git a/osu.Game.Rulesets.Taiko.Tests/TaikoBeatmapConversionTest.cs b/osu.Game.Rulesets.Taiko.Tests/TaikoBeatmapConversionTest.cs
index b3f6a733d3..796f5721bb 100644
--- a/osu.Game.Rulesets.Taiko.Tests/TaikoBeatmapConversionTest.cs
+++ b/osu.Game.Rulesets.Taiko.Tests/TaikoBeatmapConversionTest.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using NUnit.Framework;
diff --git a/osu.Game.Rulesets.Taiko.Tests/TaikoDifficultyCalculatorTest.cs b/osu.Game.Rulesets.Taiko.Tests/TaikoDifficultyCalculatorTest.cs
index 51332a1ece..579b461624 100644
--- a/osu.Game.Rulesets.Taiko.Tests/TaikoDifficultyCalculatorTest.cs
+++ b/osu.Game.Rulesets.Taiko.Tests/TaikoDifficultyCalculatorTest.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Difficulty;
diff --git a/osu.Game.Rulesets.Taiko.Tests/TaikoLegacyModConversionTest.cs b/osu.Game.Rulesets.Taiko.Tests/TaikoLegacyModConversionTest.cs
index a039e84106..3553cb27dc 100644
--- a/osu.Game.Rulesets.Taiko.Tests/TaikoLegacyModConversionTest.cs
+++ b/osu.Game.Rulesets.Taiko.Tests/TaikoLegacyModConversionTest.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.
 
+#nullable disable
+
 using System;
 using NUnit.Framework;
 using osu.Game.Beatmaps.Legacy;
diff --git a/osu.Game.Rulesets.Taiko.Tests/TestSceneBarLineApplication.cs b/osu.Game.Rulesets.Taiko.Tests/TestSceneBarLineApplication.cs
index f33c738b04..867ee13bea 100644
--- a/osu.Game.Rulesets.Taiko.Tests/TestSceneBarLineApplication.cs
+++ b/osu.Game.Rulesets.Taiko.Tests/TestSceneBarLineApplication.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Game.Rulesets.Taiko.Objects;
 using osu.Game.Rulesets.Taiko.Objects.Drawables;
diff --git a/osu.Game.Rulesets.Taiko.Tests/TestSceneDrumRollApplication.cs b/osu.Game.Rulesets.Taiko.Tests/TestSceneDrumRollApplication.cs
index c389a05566..eceeaf5083 100644
--- a/osu.Game.Rulesets.Taiko.Tests/TestSceneDrumRollApplication.cs
+++ b/osu.Game.Rulesets.Taiko.Tests/TestSceneDrumRollApplication.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Game.Rulesets.Taiko.Objects;
 using osu.Game.Rulesets.Taiko.Objects.Drawables;
diff --git a/osu.Game.Rulesets.Taiko.Tests/TestSceneDrumRollJudgements.cs b/osu.Game.Rulesets.Taiko.Tests/TestSceneDrumRollJudgements.cs
index 060c3c9443..82dfaecaa4 100644
--- a/osu.Game.Rulesets.Taiko.Tests/TestSceneDrumRollJudgements.cs
+++ b/osu.Game.Rulesets.Taiko.Tests/TestSceneDrumRollJudgements.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Game.Beatmaps;
diff --git a/osu.Game.Rulesets.Taiko.Tests/TestSceneFlyingHits.cs b/osu.Game.Rulesets.Taiko.Tests/TestSceneFlyingHits.cs
index 5c7e3954e8..c787683620 100644
--- a/osu.Game.Rulesets.Taiko.Tests/TestSceneFlyingHits.cs
+++ b/osu.Game.Rulesets.Taiko.Tests/TestSceneFlyingHits.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Testing;
diff --git a/osu.Game.Rulesets.Taiko.Tests/TestSceneHitApplication.cs b/osu.Game.Rulesets.Taiko.Tests/TestSceneHitApplication.cs
index c2f251fcb6..b337519c85 100644
--- a/osu.Game.Rulesets.Taiko.Tests/TestSceneHitApplication.cs
+++ b/osu.Game.Rulesets.Taiko.Tests/TestSceneHitApplication.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Game.Rulesets.Taiko.Objects;
 using osu.Game.Rulesets.Taiko.Objects.Drawables;
diff --git a/osu.Game.Rulesets.Taiko.Tests/TestSceneHits.cs b/osu.Game.Rulesets.Taiko.Tests/TestSceneHits.cs
index 87c936d386..5350a81f55 100644
--- a/osu.Game.Rulesets.Taiko.Tests/TestSceneHits.cs
+++ b/osu.Game.Rulesets.Taiko.Tests/TestSceneHits.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game.Rulesets.Taiko.Tests/TestSceneSampleOutput.cs b/osu.Game.Rulesets.Taiko.Tests/TestSceneSampleOutput.cs
index e5c9358c26..e6c28a532a 100644
--- a/osu.Game.Rulesets.Taiko.Tests/TestSceneSampleOutput.cs
+++ b/osu.Game.Rulesets.Taiko.Tests/TestSceneSampleOutput.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using osu.Framework.Testing;
diff --git a/osu.Game.Rulesets.Taiko.Tests/TestSceneSwellJudgements.cs b/osu.Game.Rulesets.Taiko.Tests/TestSceneSwellJudgements.cs
index 75049b7467..bd546b16f2 100644
--- a/osu.Game.Rulesets.Taiko.Tests/TestSceneSwellJudgements.cs
+++ b/osu.Game.Rulesets.Taiko.Tests/TestSceneSwellJudgements.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Game.Beatmaps;
diff --git a/osu.Game.Rulesets.Taiko.Tests/TestSceneTaikoHitObjectSamples.cs b/osu.Game.Rulesets.Taiko.Tests/TestSceneTaikoHitObjectSamples.cs
index 221d715a35..674ac5670f 100644
--- a/osu.Game.Rulesets.Taiko.Tests/TestSceneTaikoHitObjectSamples.cs
+++ b/osu.Game.Rulesets.Taiko.Tests/TestSceneTaikoHitObjectSamples.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.
 
+#nullable disable
+
 using System.Reflection;
 using NUnit.Framework;
 using osu.Framework.IO.Stores;
diff --git a/osu.Game.Rulesets.Taiko.Tests/TestSceneTaikoPlayer.cs b/osu.Game.Rulesets.Taiko.Tests/TestSceneTaikoPlayer.cs
index cd7511241a..5e984b19f8 100644
--- a/osu.Game.Rulesets.Taiko.Tests/TestSceneTaikoPlayer.cs
+++ b/osu.Game.Rulesets.Taiko.Tests/TestSceneTaikoPlayer.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.
 
+#nullable disable
+
 using osu.Game.Tests.Visual;
 
 namespace osu.Game.Rulesets.Taiko.Tests
diff --git a/osu.Game.Rulesets.Taiko.Tests/TestSceneTaikoSuddenDeath.cs b/osu.Game.Rulesets.Taiko.Tests/TestSceneTaikoSuddenDeath.cs
index eec88d7bf8..51772df4a7 100644
--- a/osu.Game.Rulesets.Taiko.Tests/TestSceneTaikoSuddenDeath.cs
+++ b/osu.Game.Rulesets.Taiko.Tests/TestSceneTaikoSuddenDeath.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Game.Beatmaps;
diff --git a/osu.Game.Rulesets.Taiko/Beatmaps/TaikoBeatmap.cs b/osu.Game.Rulesets.Taiko/Beatmaps/TaikoBeatmap.cs
index 41fe63a553..6ff5cdf7e5 100644
--- a/osu.Game.Rulesets.Taiko/Beatmaps/TaikoBeatmap.cs
+++ b/osu.Game.Rulesets.Taiko/Beatmaps/TaikoBeatmap.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using osu.Game.Beatmaps;
diff --git a/osu.Game.Rulesets.Taiko/Beatmaps/TaikoBeatmapConverter.cs b/osu.Game.Rulesets.Taiko/Beatmaps/TaikoBeatmapConverter.cs
index b1d8575de4..524565a863 100644
--- a/osu.Game.Rulesets.Taiko/Beatmaps/TaikoBeatmapConverter.cs
+++ b/osu.Game.Rulesets.Taiko/Beatmaps/TaikoBeatmapConverter.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.
 
+#nullable disable
+
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Objects.Types;
diff --git a/osu.Game.Rulesets.Taiko/Difficulty/Preprocessing/TaikoDifficultyHitObject.cs b/osu.Game.Rulesets.Taiko/Difficulty/Preprocessing/TaikoDifficultyHitObject.cs
index d9049c45ea..4c7b140832 100644
--- a/osu.Game.Rulesets.Taiko/Difficulty/Preprocessing/TaikoDifficultyHitObject.cs
+++ b/osu.Game.Rulesets.Taiko/Difficulty/Preprocessing/TaikoDifficultyHitObject.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game.Rulesets.Taiko/Difficulty/Preprocessing/TaikoDifficultyHitObjectRhythm.cs b/osu.Game.Rulesets.Taiko/Difficulty/Preprocessing/TaikoDifficultyHitObjectRhythm.cs
index ea6a224094..526d20e7d7 100644
--- a/osu.Game.Rulesets.Taiko/Difficulty/Preprocessing/TaikoDifficultyHitObjectRhythm.cs
+++ b/osu.Game.Rulesets.Taiko/Difficulty/Preprocessing/TaikoDifficultyHitObjectRhythm.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.
 
+#nullable disable
+
 namespace osu.Game.Rulesets.Taiko.Difficulty.Preprocessing
 {
     /// <summary>
diff --git a/osu.Game.Rulesets.Taiko/Difficulty/Skills/Colour.cs b/osu.Game.Rulesets.Taiko/Difficulty/Skills/Colour.cs
index 0c17ca66b9..3727c0e4b7 100644
--- a/osu.Game.Rulesets.Taiko/Difficulty/Skills/Colour.cs
+++ b/osu.Game.Rulesets.Taiko/Difficulty/Skills/Colour.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.
 
+#nullable disable
+
 using System;
 using osu.Game.Rulesets.Difficulty.Preprocessing;
 using osu.Game.Rulesets.Difficulty.Skills;
diff --git a/osu.Game.Rulesets.Taiko/Difficulty/Skills/Rhythm.cs b/osu.Game.Rulesets.Taiko/Difficulty/Skills/Rhythm.cs
index 46b24af903..4a2b97a4cb 100644
--- a/osu.Game.Rulesets.Taiko/Difficulty/Skills/Rhythm.cs
+++ b/osu.Game.Rulesets.Taiko/Difficulty/Skills/Rhythm.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.
 
+#nullable disable
+
 using System;
 using osu.Game.Rulesets.Difficulty.Preprocessing;
 using osu.Game.Rulesets.Difficulty.Skills;
diff --git a/osu.Game.Rulesets.Taiko/Difficulty/Skills/SingleKeyStamina.cs b/osu.Game.Rulesets.Taiko/Difficulty/Skills/SingleKeyStamina.cs
index cabfd231d8..c2e1dd4f82 100644
--- a/osu.Game.Rulesets.Taiko/Difficulty/Skills/SingleKeyStamina.cs
+++ b/osu.Game.Rulesets.Taiko/Difficulty/Skills/SingleKeyStamina.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Difficulty.Preprocessing;
 using osu.Game.Rulesets.Difficulty.Skills;
 
diff --git a/osu.Game.Rulesets.Taiko/Difficulty/Skills/Stamina.cs b/osu.Game.Rulesets.Taiko/Difficulty/Skills/Stamina.cs
index 61bcbfa59d..67b628a814 100644
--- a/osu.Game.Rulesets.Taiko/Difficulty/Skills/Stamina.cs
+++ b/osu.Game.Rulesets.Taiko/Difficulty/Skills/Stamina.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Difficulty.Preprocessing;
 using osu.Game.Rulesets.Difficulty.Skills;
 using osu.Game.Rulesets.Mods;
diff --git a/osu.Game.Rulesets.Taiko/Difficulty/TaikoDifficultyAttributes.cs b/osu.Game.Rulesets.Taiko/Difficulty/TaikoDifficultyAttributes.cs
index 3dc5438072..6c617a22a4 100644
--- a/osu.Game.Rulesets.Taiko/Difficulty/TaikoDifficultyAttributes.cs
+++ b/osu.Game.Rulesets.Taiko/Difficulty/TaikoDifficultyAttributes.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using Newtonsoft.Json;
 using osu.Game.Rulesets.Difficulty;
diff --git a/osu.Game.Rulesets.Taiko/Difficulty/TaikoDifficultyCalculator.cs b/osu.Game.Rulesets.Taiko/Difficulty/TaikoDifficultyCalculator.cs
index ce5b1d2236..228856cbe9 100644
--- a/osu.Game.Rulesets.Taiko/Difficulty/TaikoDifficultyCalculator.cs
+++ b/osu.Game.Rulesets.Taiko/Difficulty/TaikoDifficultyCalculator.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game.Rulesets.Taiko/Difficulty/TaikoPerformanceAttributes.cs b/osu.Game.Rulesets.Taiko/Difficulty/TaikoPerformanceAttributes.cs
index fa5c0202dd..68d0038b24 100644
--- a/osu.Game.Rulesets.Taiko/Difficulty/TaikoPerformanceAttributes.cs
+++ b/osu.Game.Rulesets.Taiko/Difficulty/TaikoPerformanceAttributes.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using Newtonsoft.Json;
 using osu.Game.Rulesets.Difficulty;
diff --git a/osu.Game.Rulesets.Taiko/Difficulty/TaikoPerformanceCalculator.cs b/osu.Game.Rulesets.Taiko/Difficulty/TaikoPerformanceCalculator.cs
index 8d99fd3b87..a9cde62f44 100644
--- a/osu.Game.Rulesets.Taiko/Difficulty/TaikoPerformanceCalculator.cs
+++ b/osu.Game.Rulesets.Taiko/Difficulty/TaikoPerformanceCalculator.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game.Rulesets.Taiko/Edit/Blueprints/DrumRollPlacementBlueprint.cs b/osu.Game.Rulesets.Taiko/Edit/Blueprints/DrumRollPlacementBlueprint.cs
index eb07ce7635..dfbcd1cce3 100644
--- a/osu.Game.Rulesets.Taiko/Edit/Blueprints/DrumRollPlacementBlueprint.cs
+++ b/osu.Game.Rulesets.Taiko/Edit/Blueprints/DrumRollPlacementBlueprint.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Taiko.Objects;
 
 namespace osu.Game.Rulesets.Taiko.Edit.Blueprints
diff --git a/osu.Game.Rulesets.Taiko/Edit/Blueprints/HitPiece.cs b/osu.Game.Rulesets.Taiko/Edit/Blueprints/HitPiece.cs
index b02e3aa9ba..86f32ca17c 100644
--- a/osu.Game.Rulesets.Taiko/Edit/Blueprints/HitPiece.cs
+++ b/osu.Game.Rulesets.Taiko/Edit/Blueprints/HitPiece.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
diff --git a/osu.Game.Rulesets.Taiko/Edit/Blueprints/HitPlacementBlueprint.cs b/osu.Game.Rulesets.Taiko/Edit/Blueprints/HitPlacementBlueprint.cs
index 0d0fd136a7..df1450bf77 100644
--- a/osu.Game.Rulesets.Taiko/Edit/Blueprints/HitPlacementBlueprint.cs
+++ b/osu.Game.Rulesets.Taiko/Edit/Blueprints/HitPlacementBlueprint.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.
 
+#nullable disable
+
 using osu.Framework.Input.Events;
 using osu.Game.Rulesets.Edit;
 using osu.Game.Rulesets.Taiko.Objects;
diff --git a/osu.Game.Rulesets.Taiko/Edit/Blueprints/LengthPiece.cs b/osu.Game.Rulesets.Taiko/Edit/Blueprints/LengthPiece.cs
index 6b651fd739..e201d58f7a 100644
--- a/osu.Game.Rulesets.Taiko/Edit/Blueprints/LengthPiece.cs
+++ b/osu.Game.Rulesets.Taiko/Edit/Blueprints/LengthPiece.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
diff --git a/osu.Game.Rulesets.Taiko/Edit/Blueprints/SwellPlacementBlueprint.cs b/osu.Game.Rulesets.Taiko/Edit/Blueprints/SwellPlacementBlueprint.cs
index 95fa82a0f2..1d08af47d3 100644
--- a/osu.Game.Rulesets.Taiko/Edit/Blueprints/SwellPlacementBlueprint.cs
+++ b/osu.Game.Rulesets.Taiko/Edit/Blueprints/SwellPlacementBlueprint.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Taiko.Objects;
 
 namespace osu.Game.Rulesets.Taiko.Edit.Blueprints
diff --git a/osu.Game.Rulesets.Taiko/Edit/Blueprints/TaikoSelectionBlueprint.cs b/osu.Game.Rulesets.Taiko/Edit/Blueprints/TaikoSelectionBlueprint.cs
index 01b90c4bca..4c67a37417 100644
--- a/osu.Game.Rulesets.Taiko/Edit/Blueprints/TaikoSelectionBlueprint.cs
+++ b/osu.Game.Rulesets.Taiko/Edit/Blueprints/TaikoSelectionBlueprint.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Game.Rulesets.Edit;
 using osu.Game.Rulesets.Objects;
diff --git a/osu.Game.Rulesets.Taiko/Edit/Blueprints/TaikoSpanPlacementBlueprint.cs b/osu.Game.Rulesets.Taiko/Edit/Blueprints/TaikoSpanPlacementBlueprint.cs
index 59249e6bf4..e49043e58e 100644
--- a/osu.Game.Rulesets.Taiko/Edit/Blueprints/TaikoSpanPlacementBlueprint.cs
+++ b/osu.Game.Rulesets.Taiko/Edit/Blueprints/TaikoSpanPlacementBlueprint.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Graphics;
 using osu.Framework.Input.Events;
diff --git a/osu.Game.Rulesets.Taiko/Edit/DrumRollCompositionTool.cs b/osu.Game.Rulesets.Taiko/Edit/DrumRollCompositionTool.cs
index 587a4efecb..acb17fc455 100644
--- a/osu.Game.Rulesets.Taiko/Edit/DrumRollCompositionTool.cs
+++ b/osu.Game.Rulesets.Taiko/Edit/DrumRollCompositionTool.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Edit;
diff --git a/osu.Game.Rulesets.Taiko/Edit/HitCompositionTool.cs b/osu.Game.Rulesets.Taiko/Edit/HitCompositionTool.cs
index 3e97b4e322..e52dae4b0c 100644
--- a/osu.Game.Rulesets.Taiko/Edit/HitCompositionTool.cs
+++ b/osu.Game.Rulesets.Taiko/Edit/HitCompositionTool.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Edit;
diff --git a/osu.Game.Rulesets.Taiko/Edit/SwellCompositionTool.cs b/osu.Game.Rulesets.Taiko/Edit/SwellCompositionTool.cs
index 918afde1dd..dd0ff61c10 100644
--- a/osu.Game.Rulesets.Taiko/Edit/SwellCompositionTool.cs
+++ b/osu.Game.Rulesets.Taiko/Edit/SwellCompositionTool.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Edit;
diff --git a/osu.Game.Rulesets.Taiko/Edit/TaikoBlueprintContainer.cs b/osu.Game.Rulesets.Taiko/Edit/TaikoBlueprintContainer.cs
index a465638779..6107c8009a 100644
--- a/osu.Game.Rulesets.Taiko/Edit/TaikoBlueprintContainer.cs
+++ b/osu.Game.Rulesets.Taiko/Edit/TaikoBlueprintContainer.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Edit;
 using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Taiko.Edit.Blueprints;
diff --git a/osu.Game.Rulesets.Taiko/Edit/TaikoHitObjectComposer.cs b/osu.Game.Rulesets.Taiko/Edit/TaikoHitObjectComposer.cs
index 161799c980..1c1a5c325f 100644
--- a/osu.Game.Rulesets.Taiko/Edit/TaikoHitObjectComposer.cs
+++ b/osu.Game.Rulesets.Taiko/Edit/TaikoHitObjectComposer.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Game.Rulesets.Edit;
 using osu.Game.Rulesets.Edit.Tools;
diff --git a/osu.Game.Rulesets.Taiko/Edit/TaikoSelectionHandler.cs b/osu.Game.Rulesets.Taiko/Edit/TaikoSelectionHandler.cs
index ab3b729307..80e4e8f406 100644
--- a/osu.Game.Rulesets.Taiko/Edit/TaikoSelectionHandler.cs
+++ b/osu.Game.Rulesets.Taiko/Edit/TaikoSelectionHandler.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Rulesets.Taiko/Judgements/TaikoDrumRollJudgement.cs b/osu.Game.Rulesets.Taiko/Judgements/TaikoDrumRollJudgement.cs
index 0d91002f4b..be128d85b5 100644
--- a/osu.Game.Rulesets.Taiko/Judgements/TaikoDrumRollJudgement.cs
+++ b/osu.Game.Rulesets.Taiko/Judgements/TaikoDrumRollJudgement.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Scoring;
 
 namespace osu.Game.Rulesets.Taiko.Judgements
diff --git a/osu.Game.Rulesets.Taiko/Judgements/TaikoDrumRollTickJudgement.cs b/osu.Game.Rulesets.Taiko/Judgements/TaikoDrumRollTickJudgement.cs
index 647ad7853d..5f2587a5d5 100644
--- a/osu.Game.Rulesets.Taiko/Judgements/TaikoDrumRollTickJudgement.cs
+++ b/osu.Game.Rulesets.Taiko/Judgements/TaikoDrumRollTickJudgement.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Scoring;
 
 namespace osu.Game.Rulesets.Taiko.Judgements
diff --git a/osu.Game.Rulesets.Taiko/Judgements/TaikoJudgement.cs b/osu.Game.Rulesets.Taiko/Judgements/TaikoJudgement.cs
index e272c1a4ef..f8e3303752 100644
--- a/osu.Game.Rulesets.Taiko/Judgements/TaikoJudgement.cs
+++ b/osu.Game.Rulesets.Taiko/Judgements/TaikoJudgement.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Judgements;
 using osu.Game.Rulesets.Scoring;
 
diff --git a/osu.Game.Rulesets.Taiko/Judgements/TaikoStrongJudgement.cs b/osu.Game.Rulesets.Taiko/Judgements/TaikoStrongJudgement.cs
index 06495ad9f4..f2397aba22 100644
--- a/osu.Game.Rulesets.Taiko/Judgements/TaikoStrongJudgement.cs
+++ b/osu.Game.Rulesets.Taiko/Judgements/TaikoStrongJudgement.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Scoring;
 
 namespace osu.Game.Rulesets.Taiko.Judgements
diff --git a/osu.Game.Rulesets.Taiko/Judgements/TaikoSwellJudgement.cs b/osu.Game.Rulesets.Taiko/Judgements/TaikoSwellJudgement.cs
index 4d61efd3ee..b2ac0b7f03 100644
--- a/osu.Game.Rulesets.Taiko/Judgements/TaikoSwellJudgement.cs
+++ b/osu.Game.Rulesets.Taiko/Judgements/TaikoSwellJudgement.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Scoring;
 
 namespace osu.Game.Rulesets.Taiko.Judgements
diff --git a/osu.Game.Rulesets.Taiko/Mods/TaikoModAutoplay.cs b/osu.Game.Rulesets.Taiko/Mods/TaikoModAutoplay.cs
index 4b74b4991e..6c01bae027 100644
--- a/osu.Game.Rulesets.Taiko/Mods/TaikoModAutoplay.cs
+++ b/osu.Game.Rulesets.Taiko/Mods/TaikoModAutoplay.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Mods;
diff --git a/osu.Game.Rulesets.Taiko/Mods/TaikoModCinema.cs b/osu.Game.Rulesets.Taiko/Mods/TaikoModCinema.cs
index fee0cb2744..d1c192f7fa 100644
--- a/osu.Game.Rulesets.Taiko/Mods/TaikoModCinema.cs
+++ b/osu.Game.Rulesets.Taiko/Mods/TaikoModCinema.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Mods;
diff --git a/osu.Game.Rulesets.Taiko/Mods/TaikoModClassic.cs b/osu.Game.Rulesets.Taiko/Mods/TaikoModClassic.cs
index 5a6f57bc36..6d1a18bb78 100644
--- a/osu.Game.Rulesets.Taiko/Mods/TaikoModClassic.cs
+++ b/osu.Game.Rulesets.Taiko/Mods/TaikoModClassic.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Taiko.Objects;
 using osu.Game.Rulesets.Taiko.UI;
diff --git a/osu.Game.Rulesets.Taiko/Mods/TaikoModDaycore.cs b/osu.Game.Rulesets.Taiko/Mods/TaikoModDaycore.cs
index 84aa5e6bba..873aa7f992 100644
--- a/osu.Game.Rulesets.Taiko/Mods/TaikoModDaycore.cs
+++ b/osu.Game.Rulesets.Taiko/Mods/TaikoModDaycore.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Mods;
 
 namespace osu.Game.Rulesets.Taiko.Mods
diff --git a/osu.Game.Rulesets.Taiko/Mods/TaikoModDifficultyAdjust.cs b/osu.Game.Rulesets.Taiko/Mods/TaikoModDifficultyAdjust.cs
index 99a064d35f..564d023c5a 100644
--- a/osu.Game.Rulesets.Taiko/Mods/TaikoModDifficultyAdjust.cs
+++ b/osu.Game.Rulesets.Taiko/Mods/TaikoModDifficultyAdjust.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.
 
+#nullable disable
+
 using System.Linq;
 using osu.Game.Beatmaps;
 using osu.Game.Configuration;
diff --git a/osu.Game.Rulesets.Taiko/Mods/TaikoModDoubleTime.cs b/osu.Game.Rulesets.Taiko/Mods/TaikoModDoubleTime.cs
index bc38213acc..01f1632ae2 100644
--- a/osu.Game.Rulesets.Taiko/Mods/TaikoModDoubleTime.cs
+++ b/osu.Game.Rulesets.Taiko/Mods/TaikoModDoubleTime.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Mods;
 
 namespace osu.Game.Rulesets.Taiko.Mods
diff --git a/osu.Game.Rulesets.Taiko/Mods/TaikoModEasy.cs b/osu.Game.Rulesets.Taiko/Mods/TaikoModEasy.cs
index ad6fdf59e2..a37e1c6f5c 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.
 
+#nullable disable
+
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Mods;
 
diff --git a/osu.Game.Rulesets.Taiko/Mods/TaikoModFlashlight.cs b/osu.Game.Rulesets.Taiko/Mods/TaikoModFlashlight.cs
index beec785fe8..2f9cccfe86 100644
--- a/osu.Game.Rulesets.Taiko/Mods/TaikoModFlashlight.cs
+++ b/osu.Game.Rulesets.Taiko/Mods/TaikoModFlashlight.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.
 
+#nullable disable
+
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Layout;
diff --git a/osu.Game.Rulesets.Taiko/Mods/TaikoModHalfTime.cs b/osu.Game.Rulesets.Taiko/Mods/TaikoModHalfTime.cs
index 68d6305fbf..ddfc2d1174 100644
--- a/osu.Game.Rulesets.Taiko/Mods/TaikoModHalfTime.cs
+++ b/osu.Game.Rulesets.Taiko/Mods/TaikoModHalfTime.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Mods;
 
 namespace osu.Game.Rulesets.Taiko.Mods
diff --git a/osu.Game.Rulesets.Taiko/Mods/TaikoModHardRock.cs b/osu.Game.Rulesets.Taiko/Mods/TaikoModHardRock.cs
index 8437dfe52e..7fcd925c04 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.
 
+#nullable disable
+
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Mods;
 
diff --git a/osu.Game.Rulesets.Taiko/Mods/TaikoModHidden.cs b/osu.Game.Rulesets.Taiko/Mods/TaikoModHidden.cs
index 7f565cb82d..69eace4302 100644
--- a/osu.Game.Rulesets.Taiko/Mods/TaikoModHidden.cs
+++ b/osu.Game.Rulesets.Taiko/Mods/TaikoModHidden.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Objects;
diff --git a/osu.Game.Rulesets.Taiko/Mods/TaikoModMuted.cs b/osu.Game.Rulesets.Taiko/Mods/TaikoModMuted.cs
index 0f1e0b2885..874e15406d 100644
--- a/osu.Game.Rulesets.Taiko/Mods/TaikoModMuted.cs
+++ b/osu.Game.Rulesets.Taiko/Mods/TaikoModMuted.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Taiko.Objects;
 
diff --git a/osu.Game.Rulesets.Taiko/Mods/TaikoModNightcore.cs b/osu.Game.Rulesets.Taiko/Mods/TaikoModNightcore.cs
index 5377eb1072..f2a57ecf88 100644
--- a/osu.Game.Rulesets.Taiko/Mods/TaikoModNightcore.cs
+++ b/osu.Game.Rulesets.Taiko/Mods/TaikoModNightcore.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Taiko.Objects;
 
diff --git a/osu.Game.Rulesets.Taiko/Mods/TaikoModNoFail.cs b/osu.Game.Rulesets.Taiko/Mods/TaikoModNoFail.cs
index bf1006f1aa..57ecf0224f 100644
--- a/osu.Game.Rulesets.Taiko/Mods/TaikoModNoFail.cs
+++ b/osu.Game.Rulesets.Taiko/Mods/TaikoModNoFail.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Mods;
 
 namespace osu.Game.Rulesets.Taiko.Mods
diff --git a/osu.Game.Rulesets.Taiko/Mods/TaikoModPerfect.cs b/osu.Game.Rulesets.Taiko/Mods/TaikoModPerfect.cs
index b107b14a03..c65dba243b 100644
--- a/osu.Game.Rulesets.Taiko/Mods/TaikoModPerfect.cs
+++ b/osu.Game.Rulesets.Taiko/Mods/TaikoModPerfect.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Mods;
 
 namespace osu.Game.Rulesets.Taiko.Mods
diff --git a/osu.Game.Rulesets.Taiko/Mods/TaikoModRandom.cs b/osu.Game.Rulesets.Taiko/Mods/TaikoModRandom.cs
index 307a37bf2e..f58f59aaf2 100644
--- a/osu.Game.Rulesets.Taiko/Mods/TaikoModRandom.cs
+++ b/osu.Game.Rulesets.Taiko/Mods/TaikoModRandom.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using osu.Framework.Utils;
diff --git a/osu.Game.Rulesets.Taiko/Mods/TaikoModRelax.cs b/osu.Game.Rulesets.Taiko/Mods/TaikoModRelax.cs
index 7be70d9ac3..a3a644ab99 100644
--- a/osu.Game.Rulesets.Taiko/Mods/TaikoModRelax.cs
+++ b/osu.Game.Rulesets.Taiko/Mods/TaikoModRelax.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Mods;
 
 namespace osu.Game.Rulesets.Taiko.Mods
diff --git a/osu.Game.Rulesets.Taiko/Mods/TaikoModSuddenDeath.cs b/osu.Game.Rulesets.Taiko/Mods/TaikoModSuddenDeath.cs
index 7a0f6c7cd1..037e376ad2 100644
--- a/osu.Game.Rulesets.Taiko/Mods/TaikoModSuddenDeath.cs
+++ b/osu.Game.Rulesets.Taiko/Mods/TaikoModSuddenDeath.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Mods;
 
 namespace osu.Game.Rulesets.Taiko.Mods
diff --git a/osu.Game.Rulesets.Taiko/Mods/TaikoModSwap.cs b/osu.Game.Rulesets.Taiko/Mods/TaikoModSwap.cs
index 3cb337c41d..c9cba59760 100644
--- a/osu.Game.Rulesets.Taiko/Mods/TaikoModSwap.cs
+++ b/osu.Game.Rulesets.Taiko/Mods/TaikoModSwap.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using osu.Game.Beatmaps;
diff --git a/osu.Game.Rulesets.Taiko/Objects/BarLine.cs b/osu.Game.Rulesets.Taiko/Objects/BarLine.cs
index bbfc02f975..382035119e 100644
--- a/osu.Game.Rulesets.Taiko/Objects/BarLine.cs
+++ b/osu.Game.Rulesets.Taiko/Objects/BarLine.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.
 
+#nullable disable
+
 using osu.Framework.Bindables;
 using osu.Game.Rulesets.Judgements;
 using osu.Game.Rulesets.Objects;
diff --git a/osu.Game.Rulesets.Taiko/Objects/Drawables/DrawableBarLine.cs b/osu.Game.Rulesets.Taiko/Objects/Drawables/DrawableBarLine.cs
index d653f01db6..e4806c4a12 100644
--- a/osu.Game.Rulesets.Taiko/Objects/Drawables/DrawableBarLine.cs
+++ b/osu.Game.Rulesets.Taiko/Objects/Drawables/DrawableBarLine.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.
 
+#nullable disable
+
 using JetBrains.Annotations;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game.Rulesets.Taiko/Objects/Drawables/DrawableDrumRoll.cs b/osu.Game.Rulesets.Taiko/Objects/Drawables/DrawableDrumRoll.cs
index b84db513f7..04ed6d0b87 100644
--- a/osu.Game.Rulesets.Taiko/Objects/Drawables/DrawableDrumRoll.cs
+++ b/osu.Game.Rulesets.Taiko/Objects/Drawables/DrawableDrumRoll.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using JetBrains.Annotations;
diff --git a/osu.Game.Rulesets.Taiko/Objects/Drawables/DrawableDrumRollTick.cs b/osu.Game.Rulesets.Taiko/Objects/Drawables/DrawableDrumRollTick.cs
index e24923e482..705a0a8047 100644
--- a/osu.Game.Rulesets.Taiko/Objects/Drawables/DrawableDrumRollTick.cs
+++ b/osu.Game.Rulesets.Taiko/Objects/Drawables/DrawableDrumRollTick.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.
 
+#nullable disable
+
 using System;
 using JetBrains.Annotations;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Rulesets.Taiko/Objects/Drawables/DrawableFlyingHit.cs b/osu.Game.Rulesets.Taiko/Objects/Drawables/DrawableFlyingHit.cs
index 3253c1ce5a..5ce72028e0 100644
--- a/osu.Game.Rulesets.Taiko/Objects/Drawables/DrawableFlyingHit.cs
+++ b/osu.Game.Rulesets.Taiko/Objects/Drawables/DrawableFlyingHit.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.
 
+#nullable disable
+
 using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.ControlPoints;
 
diff --git a/osu.Game.Rulesets.Taiko/Objects/Drawables/DrawableHit.cs b/osu.Game.Rulesets.Taiko/Objects/Drawables/DrawableHit.cs
index 863672b3fa..484f125a09 100644
--- a/osu.Game.Rulesets.Taiko/Objects/Drawables/DrawableHit.cs
+++ b/osu.Game.Rulesets.Taiko/Objects/Drawables/DrawableHit.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Diagnostics;
diff --git a/osu.Game.Rulesets.Taiko/Objects/Drawables/DrawableStrongNestedHit.cs b/osu.Game.Rulesets.Taiko/Objects/Drawables/DrawableStrongNestedHit.cs
index 9c22e34387..01ee91a5c7 100644
--- a/osu.Game.Rulesets.Taiko/Objects/Drawables/DrawableStrongNestedHit.cs
+++ b/osu.Game.Rulesets.Taiko/Objects/Drawables/DrawableStrongNestedHit.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.
 
+#nullable disable
+
 using JetBrains.Annotations;
 using osu.Game.Rulesets.Taiko.Judgements;
 
diff --git a/osu.Game.Rulesets.Taiko/Objects/Drawables/DrawableSwell.cs b/osu.Game.Rulesets.Taiko/Objects/Drawables/DrawableSwell.cs
index 77243218ce..2451c79772 100644
--- a/osu.Game.Rulesets.Taiko/Objects/Drawables/DrawableSwell.cs
+++ b/osu.Game.Rulesets.Taiko/Objects/Drawables/DrawableSwell.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using JetBrains.Annotations;
diff --git a/osu.Game.Rulesets.Taiko/Objects/Drawables/DrawableSwellTick.cs b/osu.Game.Rulesets.Taiko/Objects/Drawables/DrawableSwellTick.cs
index d4ea9ed29f..b2a54176fb 100644
--- a/osu.Game.Rulesets.Taiko/Objects/Drawables/DrawableSwellTick.cs
+++ b/osu.Game.Rulesets.Taiko/Objects/Drawables/DrawableSwellTick.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.
 
+#nullable disable
+
 using JetBrains.Annotations;
 using osu.Framework.Graphics;
 using osu.Framework.Input.Events;
diff --git a/osu.Game.Rulesets.Taiko/Objects/Drawables/DrawableTaikoHitObject.cs b/osu.Game.Rulesets.Taiko/Objects/Drawables/DrawableTaikoHitObject.cs
index eb64ba72f2..9bbd3670fa 100644
--- a/osu.Game.Rulesets.Taiko/Objects/Drawables/DrawableTaikoHitObject.cs
+++ b/osu.Game.Rulesets.Taiko/Objects/Drawables/DrawableTaikoHitObject.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using JetBrains.Annotations;
diff --git a/osu.Game.Rulesets.Taiko/Objects/Drawables/DrawableTaikoStrongableHitObject.cs b/osu.Game.Rulesets.Taiko/Objects/Drawables/DrawableTaikoStrongableHitObject.cs
index 70d4371e99..4b58cc60e6 100644
--- a/osu.Game.Rulesets.Taiko/Objects/Drawables/DrawableTaikoStrongableHitObject.cs
+++ b/osu.Game.Rulesets.Taiko/Objects/Drawables/DrawableTaikoStrongableHitObject.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.
 
+#nullable disable
+
 using JetBrains.Annotations;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game.Rulesets.Taiko/Objects/DrumRoll.cs b/osu.Game.Rulesets.Taiko/Objects/DrumRoll.cs
index 0e93ad7e73..e1619e2857 100644
--- a/osu.Game.Rulesets.Taiko/Objects/DrumRoll.cs
+++ b/osu.Game.Rulesets.Taiko/Objects/DrumRoll.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Objects.Types;
 using System;
 using System.Threading;
diff --git a/osu.Game.Rulesets.Taiko/Objects/DrumRollTick.cs b/osu.Game.Rulesets.Taiko/Objects/DrumRollTick.cs
index 9d0336441e..433fdab908 100644
--- a/osu.Game.Rulesets.Taiko/Objects/DrumRollTick.cs
+++ b/osu.Game.Rulesets.Taiko/Objects/DrumRollTick.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Judgements;
 using osu.Game.Rulesets.Scoring;
 using osu.Game.Rulesets.Taiko.Judgements;
diff --git a/osu.Game.Rulesets.Taiko/Objects/Hit.cs b/osu.Game.Rulesets.Taiko/Objects/Hit.cs
index 2038da9344..8bc0dc6df0 100644
--- a/osu.Game.Rulesets.Taiko/Objects/Hit.cs
+++ b/osu.Game.Rulesets.Taiko/Objects/Hit.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.
 
+#nullable disable
+
 using System.Linq;
 using osu.Framework.Bindables;
 using osu.Framework.Extensions.Color4Extensions;
diff --git a/osu.Game.Rulesets.Taiko/Objects/HitType.cs b/osu.Game.Rulesets.Taiko/Objects/HitType.cs
index 17b3fdbd04..eae7fa683a 100644
--- a/osu.Game.Rulesets.Taiko/Objects/HitType.cs
+++ b/osu.Game.Rulesets.Taiko/Objects/HitType.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.
 
+#nullable disable
+
 namespace osu.Game.Rulesets.Taiko.Objects
 {
     /// <summary>
diff --git a/osu.Game.Rulesets.Taiko/Objects/IgnoreHit.cs b/osu.Game.Rulesets.Taiko/Objects/IgnoreHit.cs
index 302f940ef4..18f47b7cff 100644
--- a/osu.Game.Rulesets.Taiko/Objects/IgnoreHit.cs
+++ b/osu.Game.Rulesets.Taiko/Objects/IgnoreHit.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Judgements;
 
 namespace osu.Game.Rulesets.Taiko.Objects
diff --git a/osu.Game.Rulesets.Taiko/Objects/StrongNestedHitObject.cs b/osu.Game.Rulesets.Taiko/Objects/StrongNestedHitObject.cs
index 3b427e48c5..628c41d878 100644
--- a/osu.Game.Rulesets.Taiko/Objects/StrongNestedHitObject.cs
+++ b/osu.Game.Rulesets.Taiko/Objects/StrongNestedHitObject.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Judgements;
 using osu.Game.Rulesets.Scoring;
 using osu.Game.Rulesets.Taiko.Judgements;
diff --git a/osu.Game.Rulesets.Taiko/Objects/Swell.cs b/osu.Game.Rulesets.Taiko/Objects/Swell.cs
index eeae6e79f8..cb91c46b4d 100644
--- a/osu.Game.Rulesets.Taiko/Objects/Swell.cs
+++ b/osu.Game.Rulesets.Taiko/Objects/Swell.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.
 
+#nullable disable
+
 using System.Threading;
 using osu.Game.Rulesets.Objects.Types;
 using osu.Game.Rulesets.Judgements;
diff --git a/osu.Game.Rulesets.Taiko/Objects/SwellTick.cs b/osu.Game.Rulesets.Taiko/Objects/SwellTick.cs
index bdc0478195..43830cb528 100644
--- a/osu.Game.Rulesets.Taiko/Objects/SwellTick.cs
+++ b/osu.Game.Rulesets.Taiko/Objects/SwellTick.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Judgements;
 using osu.Game.Rulesets.Scoring;
 
diff --git a/osu.Game.Rulesets.Taiko/Objects/TaikoHitObject.cs b/osu.Game.Rulesets.Taiko/Objects/TaikoHitObject.cs
index 1a1fde1990..3aba5c571b 100644
--- a/osu.Game.Rulesets.Taiko/Objects/TaikoHitObject.cs
+++ b/osu.Game.Rulesets.Taiko/Objects/TaikoHitObject.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Judgements;
 using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Scoring;
diff --git a/osu.Game.Rulesets.Taiko/Objects/TaikoStrongableHitObject.cs b/osu.Game.Rulesets.Taiko/Objects/TaikoStrongableHitObject.cs
index 6e0f6a3109..b7bdd98d2a 100644
--- a/osu.Game.Rulesets.Taiko/Objects/TaikoStrongableHitObject.cs
+++ b/osu.Game.Rulesets.Taiko/Objects/TaikoStrongableHitObject.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.
 
+#nullable disable
+
 using System.Linq;
 using System.Threading;
 using osu.Framework.Bindables;
diff --git a/osu.Game.Rulesets.Taiko/Properties/AssemblyInfo.cs b/osu.Game.Rulesets.Taiko/Properties/AssemblyInfo.cs
index ca7d04876e..5b66e18a6d 100644
--- a/osu.Game.Rulesets.Taiko/Properties/AssemblyInfo.cs
+++ b/osu.Game.Rulesets.Taiko/Properties/AssemblyInfo.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.
 
+#nullable disable
+
 using System.Runtime.CompilerServices;
 
 // We publish our internal attributes to other sub-projects of the framework.
diff --git a/osu.Game.Rulesets.Taiko/Replays/TaikoAutoGenerator.cs b/osu.Game.Rulesets.Taiko/Replays/TaikoAutoGenerator.cs
index 5fd281f9fa..f7f72df023 100644
--- a/osu.Game.Rulesets.Taiko/Replays/TaikoAutoGenerator.cs
+++ b/osu.Game.Rulesets.Taiko/Replays/TaikoAutoGenerator.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using osu.Game.Beatmaps;
diff --git a/osu.Game.Rulesets.Taiko/Replays/TaikoFramedReplayInputHandler.cs b/osu.Game.Rulesets.Taiko/Replays/TaikoFramedReplayInputHandler.cs
index 2f9b6c7f60..0090409443 100644
--- a/osu.Game.Rulesets.Taiko/Replays/TaikoFramedReplayInputHandler.cs
+++ b/osu.Game.Rulesets.Taiko/Replays/TaikoFramedReplayInputHandler.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Replays;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game.Rulesets.Taiko/Replays/TaikoReplayFrame.cs b/osu.Game.Rulesets.Taiko/Replays/TaikoReplayFrame.cs
index d2a7329a28..d8f88785db 100644
--- a/osu.Game.Rulesets.Taiko/Replays/TaikoReplayFrame.cs
+++ b/osu.Game.Rulesets.Taiko/Replays/TaikoReplayFrame.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Game.Beatmaps;
 using osu.Game.Replays.Legacy;
diff --git a/osu.Game.Rulesets.Taiko/Scoring/TaikoHealthProcessor.cs b/osu.Game.Rulesets.Taiko/Scoring/TaikoHealthProcessor.cs
index 0d6ce44255..a663817aa8 100644
--- a/osu.Game.Rulesets.Taiko/Scoring/TaikoHealthProcessor.cs
+++ b/osu.Game.Rulesets.Taiko/Scoring/TaikoHealthProcessor.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using osu.Game.Beatmaps;
diff --git a/osu.Game.Rulesets.Taiko/Scoring/TaikoHitWindows.cs b/osu.Game.Rulesets.Taiko/Scoring/TaikoHitWindows.cs
index cf806c0c97..896af24772 100644
--- a/osu.Game.Rulesets.Taiko/Scoring/TaikoHitWindows.cs
+++ b/osu.Game.Rulesets.Taiko/Scoring/TaikoHitWindows.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Scoring;
 
 namespace osu.Game.Rulesets.Taiko.Scoring
diff --git a/osu.Game.Rulesets.Taiko/Scoring/TaikoScoreProcessor.cs b/osu.Game.Rulesets.Taiko/Scoring/TaikoScoreProcessor.cs
index bacc22714e..3b0bb952dd 100644
--- a/osu.Game.Rulesets.Taiko/Scoring/TaikoScoreProcessor.cs
+++ b/osu.Game.Rulesets.Taiko/Scoring/TaikoScoreProcessor.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Scoring;
 
 namespace osu.Game.Rulesets.Taiko.Scoring
diff --git a/osu.Game.Rulesets.Taiko/Skinning/Default/CentreHitCirclePiece.cs b/osu.Game.Rulesets.Taiko/Skinning/Default/CentreHitCirclePiece.cs
index 25f895708f..b91d5cfe8d 100644
--- a/osu.Game.Rulesets.Taiko/Skinning/Default/CentreHitCirclePiece.cs
+++ b/osu.Game.Rulesets.Taiko/Skinning/Default/CentreHitCirclePiece.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game.Rulesets.Taiko/Skinning/Default/CirclePiece.cs b/osu.Game.Rulesets.Taiko/Skinning/Default/CirclePiece.cs
index f2452ad88c..a7ab1bcd4a 100644
--- a/osu.Game.Rulesets.Taiko/Skinning/Default/CirclePiece.cs
+++ b/osu.Game.Rulesets.Taiko/Skinning/Default/CirclePiece.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.
 
+#nullable disable
+
 using osu.Framework.Audio.Track;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Rulesets.Taiko/Skinning/Default/ElongatedCirclePiece.cs b/osu.Game.Rulesets.Taiko/Skinning/Default/ElongatedCirclePiece.cs
index 210841bca0..ba2679fe97 100644
--- a/osu.Game.Rulesets.Taiko/Skinning/Default/ElongatedCirclePiece.cs
+++ b/osu.Game.Rulesets.Taiko/Skinning/Default/ElongatedCirclePiece.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Game.Graphics;
diff --git a/osu.Game.Rulesets.Taiko/Skinning/Default/RimHitCirclePiece.cs b/osu.Game.Rulesets.Taiko/Skinning/Default/RimHitCirclePiece.cs
index c6165495d8..63269f1267 100644
--- a/osu.Game.Rulesets.Taiko/Skinning/Default/RimHitCirclePiece.cs
+++ b/osu.Game.Rulesets.Taiko/Skinning/Default/RimHitCirclePiece.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game.Rulesets.Taiko/Skinning/Default/SwellSymbolPiece.cs b/osu.Game.Rulesets.Taiko/Skinning/Default/SwellSymbolPiece.cs
index 2f59cac3ff..d19dc4c887 100644
--- a/osu.Game.Rulesets.Taiko/Skinning/Default/SwellSymbolPiece.cs
+++ b/osu.Game.Rulesets.Taiko/Skinning/Default/SwellSymbolPiece.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game.Rulesets.Taiko/Skinning/Default/TickPiece.cs b/osu.Game.Rulesets.Taiko/Skinning/Default/TickPiece.cs
index 09c8243aac..7d3268f777 100644
--- a/osu.Game.Rulesets.Taiko/Skinning/Default/TickPiece.cs
+++ b/osu.Game.Rulesets.Taiko/Skinning/Default/TickPiece.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
diff --git a/osu.Game.Rulesets.Taiko/Skinning/Legacy/LegacyBarLine.cs b/osu.Game.Rulesets.Taiko/Skinning/Legacy/LegacyBarLine.cs
index 2b528ae8ce..97e0a340dd 100644
--- a/osu.Game.Rulesets.Taiko/Skinning/Legacy/LegacyBarLine.cs
+++ b/osu.Game.Rulesets.Taiko/Skinning/Legacy/LegacyBarLine.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Sprites;
diff --git a/osu.Game.Rulesets.Taiko/Skinning/Legacy/LegacyCirclePiece.cs b/osu.Game.Rulesets.Taiko/Skinning/Legacy/LegacyCirclePiece.cs
index 2b6c14ca63..7f813e7b27 100644
--- a/osu.Game.Rulesets.Taiko/Skinning/Legacy/LegacyCirclePiece.cs
+++ b/osu.Game.Rulesets.Taiko/Skinning/Legacy/LegacyCirclePiece.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Animations;
diff --git a/osu.Game.Rulesets.Taiko/Skinning/Legacy/LegacyDrumRoll.cs b/osu.Game.Rulesets.Taiko/Skinning/Legacy/LegacyDrumRoll.cs
index ea6f813be8..80f139a66b 100644
--- a/osu.Game.Rulesets.Taiko/Skinning/Legacy/LegacyDrumRoll.cs
+++ b/osu.Game.Rulesets.Taiko/Skinning/Legacy/LegacyDrumRoll.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game.Rulesets.Taiko/Skinning/Legacy/LegacyHit.cs b/osu.Game.Rulesets.Taiko/Skinning/Legacy/LegacyHit.cs
index d93317f0e2..b4277f86bb 100644
--- a/osu.Game.Rulesets.Taiko/Skinning/Legacy/LegacyHit.cs
+++ b/osu.Game.Rulesets.Taiko/Skinning/Legacy/LegacyHit.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Game.Skinning;
 using osuTK.Graphics;
diff --git a/osu.Game.Rulesets.Taiko/Skinning/Legacy/LegacyHitExplosion.cs b/osu.Game.Rulesets.Taiko/Skinning/Legacy/LegacyHitExplosion.cs
index 21bd35ad22..87ed2e2e60 100644
--- a/osu.Game.Rulesets.Taiko/Skinning/Legacy/LegacyHitExplosion.cs
+++ b/osu.Game.Rulesets.Taiko/Skinning/Legacy/LegacyHitExplosion.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.
 
+#nullable disable
+
 using JetBrains.Annotations;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Rulesets.Taiko/Skinning/Legacy/LegacyInputDrum.cs b/osu.Game.Rulesets.Taiko/Skinning/Legacy/LegacyInputDrum.cs
index 43c5c07f80..f18d8f0537 100644
--- a/osu.Game.Rulesets.Taiko/Skinning/Legacy/LegacyInputDrum.cs
+++ b/osu.Game.Rulesets.Taiko/Skinning/Legacy/LegacyInputDrum.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Rulesets.Taiko/Skinning/Legacy/LegacyTaikoScroller.cs b/osu.Game.Rulesets.Taiko/Skinning/Legacy/LegacyTaikoScroller.cs
index fa49242675..bd4a2f8935 100644
--- a/osu.Game.Rulesets.Taiko/Skinning/Legacy/LegacyTaikoScroller.cs
+++ b/osu.Game.Rulesets.Taiko/Skinning/Legacy/LegacyTaikoScroller.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.
 
+#nullable disable
+
 using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game.Rulesets.Taiko/Skinning/Legacy/TaikoLegacyHitTarget.cs b/osu.Game.Rulesets.Taiko/Skinning/Legacy/TaikoLegacyHitTarget.cs
index c4657fcc49..a48cdf47f6 100644
--- a/osu.Game.Rulesets.Taiko/Skinning/Legacy/TaikoLegacyHitTarget.cs
+++ b/osu.Game.Rulesets.Taiko/Skinning/Legacy/TaikoLegacyHitTarget.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game.Rulesets.Taiko/Skinning/Legacy/TaikoLegacyPlayfieldBackgroundRight.cs b/osu.Game.Rulesets.Taiko/Skinning/Legacy/TaikoLegacyPlayfieldBackgroundRight.cs
index 02756d57a4..f425a410a4 100644
--- a/osu.Game.Rulesets.Taiko/Skinning/Legacy/TaikoLegacyPlayfieldBackgroundRight.cs
+++ b/osu.Game.Rulesets.Taiko/Skinning/Legacy/TaikoLegacyPlayfieldBackgroundRight.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Audio.Track;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Rulesets.Taiko/Skinning/Legacy/TaikoLegacySkinTransformer.cs b/osu.Game.Rulesets.Taiko/Skinning/Legacy/TaikoLegacySkinTransformer.cs
index af5921b0fb..888271f32d 100644
--- a/osu.Game.Rulesets.Taiko/Skinning/Legacy/TaikoLegacySkinTransformer.cs
+++ b/osu.Game.Rulesets.Taiko/Skinning/Legacy/TaikoLegacySkinTransformer.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using osu.Framework.Audio.Sample;
diff --git a/osu.Game.Rulesets.Taiko/TaikoInputManager.cs b/osu.Game.Rulesets.Taiko/TaikoInputManager.cs
index 058bec5111..1eab133725 100644
--- a/osu.Game.Rulesets.Taiko/TaikoInputManager.cs
+++ b/osu.Game.Rulesets.Taiko/TaikoInputManager.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.
 
+#nullable disable
+
 using System.ComponentModel;
 using osu.Framework.Input.Bindings;
 using osu.Game.Rulesets.UI;
diff --git a/osu.Game.Rulesets.Taiko/TaikoRuleset.cs b/osu.Game.Rulesets.Taiko/TaikoRuleset.cs
index 615fbf093f..223e268d7f 100644
--- a/osu.Game.Rulesets.Taiko/TaikoRuleset.cs
+++ b/osu.Game.Rulesets.Taiko/TaikoRuleset.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.
 
+#nullable disable
+
 using osu.Game.Beatmaps;
 using osu.Game.Graphics;
 using osu.Game.Rulesets.Mods;
diff --git a/osu.Game.Rulesets.Taiko/TaikoSkinComponent.cs b/osu.Game.Rulesets.Taiko/TaikoSkinComponent.cs
index e6e4bc0dd7..676a3d4bc3 100644
--- a/osu.Game.Rulesets.Taiko/TaikoSkinComponent.cs
+++ b/osu.Game.Rulesets.Taiko/TaikoSkinComponent.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.
 
+#nullable disable
+
 using osu.Game.Skinning;
 
 namespace osu.Game.Rulesets.Taiko
diff --git a/osu.Game.Rulesets.Taiko/TaikoSkinComponents.cs b/osu.Game.Rulesets.Taiko/TaikoSkinComponents.cs
index bf48898dd2..d231dc7e4f 100644
--- a/osu.Game.Rulesets.Taiko/TaikoSkinComponents.cs
+++ b/osu.Game.Rulesets.Taiko/TaikoSkinComponents.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.
 
+#nullable disable
+
 namespace osu.Game.Rulesets.Taiko
 {
     public enum TaikoSkinComponents
diff --git a/osu.Game.Rulesets.Taiko/UI/BarLinePlayfield.cs b/osu.Game.Rulesets.Taiko/UI/BarLinePlayfield.cs
index cb878e8ea0..071808a044 100644
--- a/osu.Game.Rulesets.Taiko/UI/BarLinePlayfield.cs
+++ b/osu.Game.Rulesets.Taiko/UI/BarLinePlayfield.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Game.Rulesets.Taiko.Objects;
 using osu.Game.Rulesets.Taiko.Objects.Drawables;
diff --git a/osu.Game.Rulesets.Taiko/UI/DefaultHitExplosion.cs b/osu.Game.Rulesets.Taiko/UI/DefaultHitExplosion.cs
index 91e844187a..687c8f788f 100644
--- a/osu.Game.Rulesets.Taiko/UI/DefaultHitExplosion.cs
+++ b/osu.Game.Rulesets.Taiko/UI/DefaultHitExplosion.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.
 
+#nullable disable
+
 using JetBrains.Annotations;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Rulesets.Taiko/UI/DefaultKiaiHitExplosion.cs b/osu.Game.Rulesets.Taiko/UI/DefaultKiaiHitExplosion.cs
index 7ce8b016d5..e91475d87b 100644
--- a/osu.Game.Rulesets.Taiko/UI/DefaultKiaiHitExplosion.cs
+++ b/osu.Game.Rulesets.Taiko/UI/DefaultKiaiHitExplosion.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.
 
+#nullable disable
+
 using osuTK;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Rulesets.Taiko/UI/DrawableTaikoJudgement.cs b/osu.Game.Rulesets.Taiko/UI/DrawableTaikoJudgement.cs
index 876fa207bf..264e4db54e 100644
--- a/osu.Game.Rulesets.Taiko/UI/DrawableTaikoJudgement.cs
+++ b/osu.Game.Rulesets.Taiko/UI/DrawableTaikoJudgement.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Game.Rulesets.Judgements;
 using osu.Game.Rulesets.Scoring;
diff --git a/osu.Game.Rulesets.Taiko/UI/DrawableTaikoMascot.cs b/osu.Game.Rulesets.Taiko/UI/DrawableTaikoMascot.cs
index 7ba2618a63..8bedca19d8 100644
--- a/osu.Game.Rulesets.Taiko/UI/DrawableTaikoMascot.cs
+++ b/osu.Game.Rulesets.Taiko/UI/DrawableTaikoMascot.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Framework.Allocation;
 using osu.Framework.Audio.Track;
diff --git a/osu.Game.Rulesets.Taiko/UI/DrawableTaikoRuleset.cs b/osu.Game.Rulesets.Taiko/UI/DrawableTaikoRuleset.cs
index 2efc4176f5..b4ea158320 100644
--- a/osu.Game.Rulesets.Taiko/UI/DrawableTaikoRuleset.cs
+++ b/osu.Game.Rulesets.Taiko/UI/DrawableTaikoRuleset.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Rulesets.Taiko/UI/DrumRollHitContainer.cs b/osu.Game.Rulesets.Taiko/UI/DrumRollHitContainer.cs
index ae37840825..e0d5a3c680 100644
--- a/osu.Game.Rulesets.Taiko/UI/DrumRollHitContainer.cs
+++ b/osu.Game.Rulesets.Taiko/UI/DrumRollHitContainer.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Taiko.Objects.Drawables;
 using osu.Game.Rulesets.UI.Scrolling;
 
diff --git a/osu.Game.Rulesets.Taiko/UI/DrumSampleTriggerSource.cs b/osu.Game.Rulesets.Taiko/UI/DrumSampleTriggerSource.cs
index 3279d128d3..ef5bd1d7f0 100644
--- a/osu.Game.Rulesets.Taiko/UI/DrumSampleTriggerSource.cs
+++ b/osu.Game.Rulesets.Taiko/UI/DrumSampleTriggerSource.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.
 
+#nullable disable
+
 using System;
 using osu.Game.Audio;
 using osu.Game.Rulesets.Taiko.Objects;
diff --git a/osu.Game.Rulesets.Taiko/UI/HitExplosion.cs b/osu.Game.Rulesets.Taiko/UI/HitExplosion.cs
index 8f5e9e54ab..046b3a6fd0 100644
--- a/osu.Game.Rulesets.Taiko/UI/HitExplosion.cs
+++ b/osu.Game.Rulesets.Taiko/UI/HitExplosion.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.
 
+#nullable disable
+
 using System;
 using JetBrains.Annotations;
 using osuTK;
diff --git a/osu.Game.Rulesets.Taiko/UI/HitExplosionPool.cs b/osu.Game.Rulesets.Taiko/UI/HitExplosionPool.cs
index badf34554c..8707f7e840 100644
--- a/osu.Game.Rulesets.Taiko/UI/HitExplosionPool.cs
+++ b/osu.Game.Rulesets.Taiko/UI/HitExplosionPool.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.
 
+#nullable disable
+
 using osu.Framework.Graphics.Pooling;
 using osu.Game.Rulesets.Scoring;
 
diff --git a/osu.Game.Rulesets.Taiko/UI/IAnimatableHitExplosion.cs b/osu.Game.Rulesets.Taiko/UI/IAnimatableHitExplosion.cs
index cf0f5f9fb6..6a9d43a0ab 100644
--- a/osu.Game.Rulesets.Taiko/UI/IAnimatableHitExplosion.cs
+++ b/osu.Game.Rulesets.Taiko/UI/IAnimatableHitExplosion.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Objects.Drawables;
 
 namespace osu.Game.Rulesets.Taiko.UI
diff --git a/osu.Game.Rulesets.Taiko/UI/InputDrum.cs b/osu.Game.Rulesets.Taiko/UI/InputDrum.cs
index 16be20f7f3..55e920ece2 100644
--- a/osu.Game.Rulesets.Taiko/UI/InputDrum.cs
+++ b/osu.Game.Rulesets.Taiko/UI/InputDrum.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Rulesets.Taiko/UI/KiaiHitExplosion.cs b/osu.Game.Rulesets.Taiko/UI/KiaiHitExplosion.cs
index 20900a9352..319d8979ae 100644
--- a/osu.Game.Rulesets.Taiko/UI/KiaiHitExplosion.cs
+++ b/osu.Game.Rulesets.Taiko/UI/KiaiHitExplosion.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game.Rulesets.Taiko/UI/PlayfieldBackgroundLeft.cs b/osu.Game.Rulesets.Taiko/UI/PlayfieldBackgroundLeft.cs
index 2a8890a95d..db1094e100 100644
--- a/osu.Game.Rulesets.Taiko/UI/PlayfieldBackgroundLeft.cs
+++ b/osu.Game.Rulesets.Taiko/UI/PlayfieldBackgroundLeft.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Rulesets.Taiko/UI/PlayfieldBackgroundRight.cs b/osu.Game.Rulesets.Taiko/UI/PlayfieldBackgroundRight.cs
index 44bfdacf37..43252e2e77 100644
--- a/osu.Game.Rulesets.Taiko/UI/PlayfieldBackgroundRight.cs
+++ b/osu.Game.Rulesets.Taiko/UI/PlayfieldBackgroundRight.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Rulesets.Taiko/UI/TaikoHitTarget.cs b/osu.Game.Rulesets.Taiko/UI/TaikoHitTarget.cs
index 6401c6d09f..f48ed2c941 100644
--- a/osu.Game.Rulesets.Taiko/UI/TaikoHitTarget.cs
+++ b/osu.Game.Rulesets.Taiko/UI/TaikoHitTarget.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.
 
+#nullable disable
+
 using osuTK;
 using osuTK.Graphics;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Rulesets.Taiko/UI/TaikoMascotAnimation.cs b/osu.Game.Rulesets.Taiko/UI/TaikoMascotAnimation.cs
index c496c05236..bacd9b41f8 100644
--- a/osu.Game.Rulesets.Taiko/UI/TaikoMascotAnimation.cs
+++ b/osu.Game.Rulesets.Taiko/UI/TaikoMascotAnimation.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Audio.Track;
diff --git a/osu.Game.Rulesets.Taiko/UI/TaikoMascotAnimationState.cs b/osu.Game.Rulesets.Taiko/UI/TaikoMascotAnimationState.cs
index 02bf245b7b..717f0d725a 100644
--- a/osu.Game.Rulesets.Taiko/UI/TaikoMascotAnimationState.cs
+++ b/osu.Game.Rulesets.Taiko/UI/TaikoMascotAnimationState.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.
 
+#nullable disable
+
 namespace osu.Game.Rulesets.Taiko.UI
 {
     public enum TaikoMascotAnimationState
diff --git a/osu.Game.Rulesets.Taiko/UI/TaikoPlayfield.cs b/osu.Game.Rulesets.Taiko/UI/TaikoPlayfield.cs
index 2dd332fc13..4e0c8029fb 100644
--- a/osu.Game.Rulesets.Taiko/UI/TaikoPlayfield.cs
+++ b/osu.Game.Rulesets.Taiko/UI/TaikoPlayfield.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game.Rulesets.Taiko/UI/TaikoPlayfieldAdjustmentContainer.cs b/osu.Game.Rulesets.Taiko/UI/TaikoPlayfieldAdjustmentContainer.cs
index 9cf530e903..8e99a82b1b 100644
--- a/osu.Game.Rulesets.Taiko/UI/TaikoPlayfieldAdjustmentContainer.cs
+++ b/osu.Game.Rulesets.Taiko/UI/TaikoPlayfieldAdjustmentContainer.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Rulesets.Taiko/UI/TaikoReplayRecorder.cs b/osu.Game.Rulesets.Taiko/UI/TaikoReplayRecorder.cs
index e6391d1386..a76adc495d 100644
--- a/osu.Game.Rulesets.Taiko/UI/TaikoReplayRecorder.cs
+++ b/osu.Game.Rulesets.Taiko/UI/TaikoReplayRecorder.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Game.Rulesets.Replays;
 using osu.Game.Rulesets.Taiko.Replays;
diff --git a/osu.Game.Tests.Android/MainActivity.cs b/osu.Game.Tests.Android/MainActivity.cs
index dbe74a10da..6c4f9bac58 100644
--- a/osu.Game.Tests.Android/MainActivity.cs
+++ b/osu.Game.Tests.Android/MainActivity.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.
 
+#nullable disable
+
 using Android.App;
 using osu.Framework.Android;
 
diff --git a/osu.Game.Tests.iOS/AppDelegate.cs b/osu.Game.Tests.iOS/AppDelegate.cs
index 1e703e0c0a..b13027459f 100644
--- a/osu.Game.Tests.iOS/AppDelegate.cs
+++ b/osu.Game.Tests.iOS/AppDelegate.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.
 
+#nullable disable
+
 using Foundation;
 using osu.Framework.iOS;
 
diff --git a/osu.Game.Tests.iOS/Application.cs b/osu.Game.Tests.iOS/Application.cs
index 585b495c96..cf36fea139 100644
--- a/osu.Game.Tests.iOS/Application.cs
+++ b/osu.Game.Tests.iOS/Application.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.
 
+#nullable disable
+
 using osu.Framework.iOS;
 using UIKit;
 
diff --git a/osu.Game.Tests/Audio/SampleInfoEqualityTest.cs b/osu.Game.Tests/Audio/SampleInfoEqualityTest.cs
index 149096608f..d05eb7994b 100644
--- a/osu.Game.Tests/Audio/SampleInfoEqualityTest.cs
+++ b/osu.Game.Tests/Audio/SampleInfoEqualityTest.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Game.Audio;
 
diff --git a/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs b/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs
index e2d9910b82..9acd3a6cab 100644
--- a/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs
+++ b/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.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.
 
+#nullable disable
+
 using System;
 using System.IO;
 using System.Linq;
diff --git a/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapEncoderTest.cs b/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapEncoderTest.cs
index 0d436c1ef7..09130ac57d 100644
--- a/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapEncoderTest.cs
+++ b/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapEncoderTest.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.
 
+#nullable disable
+
 using System;
 using System.Collections;
 using System.Collections.Generic;
diff --git a/osu.Game.Tests/Beatmaps/Formats/LegacyDecoderTest.cs b/osu.Game.Tests/Beatmaps/Formats/LegacyDecoderTest.cs
index 4334c4d7a2..c1c9e0d118 100644
--- a/osu.Game.Tests/Beatmaps/Formats/LegacyDecoderTest.cs
+++ b/osu.Game.Tests/Beatmaps/Formats/LegacyDecoderTest.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using NUnit.Framework;
 using osu.Game.Beatmaps.Formats;
diff --git a/osu.Game.Tests/Beatmaps/Formats/LegacyScoreDecoderTest.cs b/osu.Game.Tests/Beatmaps/Formats/LegacyScoreDecoderTest.cs
index 1474f2d277..aa6fc1f309 100644
--- a/osu.Game.Tests/Beatmaps/Formats/LegacyScoreDecoderTest.cs
+++ b/osu.Game.Tests/Beatmaps/Formats/LegacyScoreDecoderTest.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Globalization;
 using System.IO;
diff --git a/osu.Game.Tests/Beatmaps/Formats/LegacyStoryboardDecoderTest.cs b/osu.Game.Tests/Beatmaps/Formats/LegacyStoryboardDecoderTest.cs
index 560e2ef894..57dded8ee4 100644
--- a/osu.Game.Tests/Beatmaps/Formats/LegacyStoryboardDecoderTest.cs
+++ b/osu.Game.Tests/Beatmaps/Formats/LegacyStoryboardDecoderTest.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osuTK;
diff --git a/osu.Game.Tests/Beatmaps/Formats/OsuJsonDecoderTest.cs b/osu.Game.Tests/Beatmaps/Formats/OsuJsonDecoderTest.cs
index 2eb75259d9..3764467047 100644
--- a/osu.Game.Tests/Beatmaps/Formats/OsuJsonDecoderTest.cs
+++ b/osu.Game.Tests/Beatmaps/Formats/OsuJsonDecoderTest.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.
 
+#nullable disable
+
 using System.IO;
 using System.Linq;
 using DeepEqual.Syntax;
diff --git a/osu.Game.Tests/Beatmaps/Formats/ParsingTest.cs b/osu.Game.Tests/Beatmaps/Formats/ParsingTest.cs
index 669acc3202..f3673b0e7f 100644
--- a/osu.Game.Tests/Beatmaps/Formats/ParsingTest.cs
+++ b/osu.Game.Tests/Beatmaps/Formats/ParsingTest.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.
 
+#nullable disable
+
 using System;
 using System.Globalization;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/Beatmaps/IO/BeatmapImportHelper.cs b/osu.Game.Tests/Beatmaps/IO/BeatmapImportHelper.cs
index 9e440c6bce..055832d753 100644
--- a/osu.Game.Tests/Beatmaps/IO/BeatmapImportHelper.cs
+++ b/osu.Game.Tests/Beatmaps/IO/BeatmapImportHelper.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.
 
+#nullable disable
+
 using System;
 using System.Diagnostics;
 using System.IO;
diff --git a/osu.Game.Tests/Beatmaps/IO/LineBufferedReaderTest.cs b/osu.Game.Tests/Beatmaps/IO/LineBufferedReaderTest.cs
index 5e37f01c81..8f20fd7a68 100644
--- a/osu.Game.Tests/Beatmaps/IO/LineBufferedReaderTest.cs
+++ b/osu.Game.Tests/Beatmaps/IO/LineBufferedReaderTest.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.
 
+#nullable disable
+
 using System;
 using System.IO;
 using System.Text;
diff --git a/osu.Game.Tests/Beatmaps/IO/OszArchiveReaderTest.cs b/osu.Game.Tests/Beatmaps/IO/OszArchiveReaderTest.cs
index 810ea5dbd0..04eb9a3fa2 100644
--- a/osu.Game.Tests/Beatmaps/IO/OszArchiveReaderTest.cs
+++ b/osu.Game.Tests/Beatmaps/IO/OszArchiveReaderTest.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.
 
+#nullable disable
+
 using System.IO;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/Beatmaps/SliderEventGenerationTest.cs b/osu.Game.Tests/Beatmaps/SliderEventGenerationTest.cs
index 9fba0f1668..d30ab3dea1 100644
--- a/osu.Game.Tests/Beatmaps/SliderEventGenerationTest.cs
+++ b/osu.Game.Tests/Beatmaps/SliderEventGenerationTest.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Game.Rulesets.Objects;
diff --git a/osu.Game.Tests/Beatmaps/TestSceneBeatmapDifficultyCache.cs b/osu.Game.Tests/Beatmaps/TestSceneBeatmapDifficultyCache.cs
index f3456cf8e4..f87e5711a6 100644
--- a/osu.Game.Tests/Beatmaps/TestSceneBeatmapDifficultyCache.cs
+++ b/osu.Game.Tests/Beatmaps/TestSceneBeatmapDifficultyCache.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using System.Threading;
diff --git a/osu.Game.Tests/Beatmaps/TestSceneEditorBeatmap.cs b/osu.Game.Tests/Beatmaps/TestSceneEditorBeatmap.cs
index 153788c2cf..81d0e6f3ef 100644
--- a/osu.Game.Tests/Beatmaps/TestSceneEditorBeatmap.cs
+++ b/osu.Game.Tests/Beatmaps/TestSceneEditorBeatmap.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game.Tests/Beatmaps/ToStringFormattingTest.cs b/osu.Game.Tests/Beatmaps/ToStringFormattingTest.cs
index 10cac4ed9d..b4a205b478 100644
--- a/osu.Game.Tests/Beatmaps/ToStringFormattingTest.cs
+++ b/osu.Game.Tests/Beatmaps/ToStringFormattingTest.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Game.Beatmaps;
 using osu.Game.Models;
diff --git a/osu.Game.Tests/Beatmaps/WorkingBeatmapTest.cs b/osu.Game.Tests/Beatmaps/WorkingBeatmapTest.cs
index 5f70f08413..f4b1028c0e 100644
--- a/osu.Game.Tests/Beatmaps/WorkingBeatmapTest.cs
+++ b/osu.Game.Tests/Beatmaps/WorkingBeatmapTest.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Threading;
diff --git a/osu.Game.Tests/Chat/MessageFormatterTests.cs b/osu.Game.Tests/Chat/MessageFormatterTests.cs
index cea4d510c1..ebfa9bd8b7 100644
--- a/osu.Game.Tests/Chat/MessageFormatterTests.cs
+++ b/osu.Game.Tests/Chat/MessageFormatterTests.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Game.Online.Chat;
 
diff --git a/osu.Game.Tests/Chat/TestSceneChannelManager.cs b/osu.Game.Tests/Chat/TestSceneChannelManager.cs
index 2bb6459f20..e7eb06c795 100644
--- a/osu.Game.Tests/Chat/TestSceneChannelManager.cs
+++ b/osu.Game.Tests/Chat/TestSceneChannelManager.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/Collections/IO/ImportCollectionsTest.cs b/osu.Game.Tests/Collections/IO/ImportCollectionsTest.cs
index 41bc075803..7f466925a4 100644
--- a/osu.Game.Tests/Collections/IO/ImportCollectionsTest.cs
+++ b/osu.Game.Tests/Collections/IO/ImportCollectionsTest.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.
 
+#nullable disable
+
 using System;
 using System.IO;
 using System.Text;
diff --git a/osu.Game.Tests/Database/BeatmapImporterTests.cs b/osu.Game.Tests/Database/BeatmapImporterTests.cs
index 53d13f0d4e..f9cd75d8c3 100644
--- a/osu.Game.Tests/Database/BeatmapImporterTests.cs
+++ b/osu.Game.Tests/Database/BeatmapImporterTests.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 enable
-
 using System;
 using System.Collections.Generic;
 using System.Diagnostics;
diff --git a/osu.Game.Tests/Database/FileStoreTests.cs b/osu.Game.Tests/Database/FileStoreTests.cs
index 13af05bbbb..ab9b761b8f 100644
--- a/osu.Game.Tests/Database/FileStoreTests.cs
+++ b/osu.Game.Tests/Database/FileStoreTests.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 enable
-
 using System.Diagnostics;
 using System.IO;
 using System.Linq;
diff --git a/osu.Game.Tests/Database/GeneralUsageTests.cs b/osu.Game.Tests/Database/GeneralUsageTests.cs
index 8262ef18d4..d10ab2ad2b 100644
--- a/osu.Game.Tests/Database/GeneralUsageTests.cs
+++ b/osu.Game.Tests/Database/GeneralUsageTests.cs
@@ -8,8 +8,6 @@ using NUnit.Framework;
 using osu.Game.Beatmaps;
 using osu.Game.Database;
 
-#nullable enable
-
 namespace osu.Game.Tests.Database
 {
     [TestFixture]
diff --git a/osu.Game.Tests/Database/LegacyBeatmapImporterTest.cs b/osu.Game.Tests/Database/LegacyBeatmapImporterTest.cs
index 2af46374fe..1df3d336ee 100644
--- a/osu.Game.Tests/Database/LegacyBeatmapImporterTest.cs
+++ b/osu.Game.Tests/Database/LegacyBeatmapImporterTest.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.IO;
 using System.Linq;
diff --git a/osu.Game.Tests/Database/RealmLiveTests.cs b/osu.Game.Tests/Database/RealmLiveTests.cs
index 4bc1f5078a..416216062e 100644
--- a/osu.Game.Tests/Database/RealmLiveTests.cs
+++ b/osu.Game.Tests/Database/RealmLiveTests.cs
@@ -12,8 +12,6 @@ using osu.Game.Beatmaps;
 using osu.Game.Database;
 using Realms;
 
-#nullable enable
-
 namespace osu.Game.Tests.Database
 {
     public class RealmLiveTests : RealmTest
diff --git a/osu.Game.Tests/Database/RealmSubscriptionRegistrationTests.cs b/osu.Game.Tests/Database/RealmSubscriptionRegistrationTests.cs
index d99bcc092d..b8ce036da1 100644
--- a/osu.Game.Tests/Database/RealmSubscriptionRegistrationTests.cs
+++ b/osu.Game.Tests/Database/RealmSubscriptionRegistrationTests.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 enable
-
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game.Tests/Database/RealmTest.cs b/osu.Game.Tests/Database/RealmTest.cs
index 16072888b9..d6b3c1ff44 100644
--- a/osu.Game.Tests/Database/RealmTest.cs
+++ b/osu.Game.Tests/Database/RealmTest.cs
@@ -15,8 +15,6 @@ using osu.Game.IO;
 using osu.Game.Models;
 using osu.Game.Rulesets;
 
-#nullable enable
-
 namespace osu.Game.Tests.Database
 {
     [TestFixture]
diff --git a/osu.Game.Tests/Database/RulesetStoreTests.cs b/osu.Game.Tests/Database/RulesetStoreTests.cs
index f48b5cba11..795e90f543 100644
--- a/osu.Game.Tests/Database/RulesetStoreTests.cs
+++ b/osu.Game.Tests/Database/RulesetStoreTests.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Game.Rulesets;
diff --git a/osu.Game.Tests/Database/TestRealmKeyBindingStore.cs b/osu.Game.Tests/Database/TestRealmKeyBindingStore.cs
index 891801865f..362b37124d 100644
--- a/osu.Game.Tests/Database/TestRealmKeyBindingStore.cs
+++ b/osu.Game.Tests/Database/TestRealmKeyBindingStore.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.IO;
diff --git a/osu.Game.Tests/Editing/Checks/CheckAudioInVideoTest.cs b/osu.Game.Tests/Editing/Checks/CheckAudioInVideoTest.cs
index 614b9b4ac1..947e884494 100644
--- a/osu.Game.Tests/Editing/Checks/CheckAudioInVideoTest.cs
+++ b/osu.Game.Tests/Editing/Checks/CheckAudioInVideoTest.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.
 
+#nullable disable
+
 using System.IO;
 using System.Linq;
 using Moq;
diff --git a/osu.Game.Tests/Editing/Checks/CheckAudioQualityTest.cs b/osu.Game.Tests/Editing/Checks/CheckAudioQualityTest.cs
index e22dfa5f8b..9fdd49823e 100644
--- a/osu.Game.Tests/Editing/Checks/CheckAudioQualityTest.cs
+++ b/osu.Game.Tests/Editing/Checks/CheckAudioQualityTest.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.
 
+#nullable disable
+
 using System.Linq;
 using Moq;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/Editing/Checks/CheckBackgroundQualityTest.cs b/osu.Game.Tests/Editing/Checks/CheckBackgroundQualityTest.cs
index bb560054a3..af5588f509 100644
--- a/osu.Game.Tests/Editing/Checks/CheckBackgroundQualityTest.cs
+++ b/osu.Game.Tests/Editing/Checks/CheckBackgroundQualityTest.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.
 
+#nullable disable
+
 using System;
 using System.IO;
 using System.Linq;
diff --git a/osu.Game.Tests/Editing/Checks/CheckConcurrentObjectsTest.cs b/osu.Game.Tests/Editing/Checks/CheckConcurrentObjectsTest.cs
index 5adb91a22e..9c1dd2c1e8 100644
--- a/osu.Game.Tests/Editing/Checks/CheckConcurrentObjectsTest.cs
+++ b/osu.Game.Tests/Editing/Checks/CheckConcurrentObjectsTest.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using Moq;
diff --git a/osu.Game.Tests/Editing/Checks/CheckFewHitsoundsTest.cs b/osu.Game.Tests/Editing/Checks/CheckFewHitsoundsTest.cs
index cf5b3a42a4..82bb2e59c9 100644
--- a/osu.Game.Tests/Editing/Checks/CheckFewHitsoundsTest.cs
+++ b/osu.Game.Tests/Editing/Checks/CheckFewHitsoundsTest.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/Editing/Checks/CheckFilePresenceTest.cs b/osu.Game.Tests/Editing/Checks/CheckFilePresenceTest.cs
index 01baaadc7d..2f18720a5b 100644
--- a/osu.Game.Tests/Editing/Checks/CheckFilePresenceTest.cs
+++ b/osu.Game.Tests/Editing/Checks/CheckFilePresenceTest.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Game.Beatmaps;
diff --git a/osu.Game.Tests/Editing/Checks/CheckMutedObjectsTest.cs b/osu.Game.Tests/Editing/Checks/CheckMutedObjectsTest.cs
index 91d9a8753c..622386405a 100644
--- a/osu.Game.Tests/Editing/Checks/CheckMutedObjectsTest.cs
+++ b/osu.Game.Tests/Editing/Checks/CheckMutedObjectsTest.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/Editing/Checks/CheckTestHelpers.cs b/osu.Game.Tests/Editing/Checks/CheckTestHelpers.cs
index 9067714ff9..405738cd55 100644
--- a/osu.Game.Tests/Editing/Checks/CheckTestHelpers.cs
+++ b/osu.Game.Tests/Editing/Checks/CheckTestHelpers.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.
 
+#nullable disable
+
 using osu.Game.Models;
 
 namespace osu.Game.Tests.Editing.Checks
diff --git a/osu.Game.Tests/Editing/Checks/CheckTooShortAudioFilesTest.cs b/osu.Game.Tests/Editing/Checks/CheckTooShortAudioFilesTest.cs
index 53c85defae..7d33b92dbe 100644
--- a/osu.Game.Tests/Editing/Checks/CheckTooShortAudioFilesTest.cs
+++ b/osu.Game.Tests/Editing/Checks/CheckTooShortAudioFilesTest.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.
 
+#nullable disable
+
 using System.Diagnostics;
 using System.IO;
 using System.Linq;
diff --git a/osu.Game.Tests/Editing/Checks/CheckUnsnappedObjectsTest.cs b/osu.Game.Tests/Editing/Checks/CheckUnsnappedObjectsTest.cs
index 882baba8fa..f647bf8d8e 100644
--- a/osu.Game.Tests/Editing/Checks/CheckUnsnappedObjectsTest.cs
+++ b/osu.Game.Tests/Editing/Checks/CheckUnsnappedObjectsTest.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using Moq;
diff --git a/osu.Game.Tests/Editing/Checks/CheckZeroByteFilesTest.cs b/osu.Game.Tests/Editing/Checks/CheckZeroByteFilesTest.cs
index 79d00e6a60..793cc70a3f 100644
--- a/osu.Game.Tests/Editing/Checks/CheckZeroByteFilesTest.cs
+++ b/osu.Game.Tests/Editing/Checks/CheckZeroByteFilesTest.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.
 
+#nullable disable
+
 using System.IO;
 using System.Linq;
 using Moq;
diff --git a/osu.Game.Tests/Editing/Checks/CheckZeroLengthObjectsTest.cs b/osu.Game.Tests/Editing/Checks/CheckZeroLengthObjectsTest.cs
index 93b20cd166..1c1965ab56 100644
--- a/osu.Game.Tests/Editing/Checks/CheckZeroLengthObjectsTest.cs
+++ b/osu.Game.Tests/Editing/Checks/CheckZeroLengthObjectsTest.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using Moq;
diff --git a/osu.Game.Tests/Editing/Checks/MockNestableHitObject.cs b/osu.Game.Tests/Editing/Checks/MockNestableHitObject.cs
index 29938839d3..6c0306d63d 100644
--- a/osu.Game.Tests/Editing/Checks/MockNestableHitObject.cs
+++ b/osu.Game.Tests/Editing/Checks/MockNestableHitObject.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Threading;
 using osu.Game.Rulesets.Objects;
diff --git a/osu.Game.Tests/Editing/EditorChangeHandlerTest.cs b/osu.Game.Tests/Editing/EditorChangeHandlerTest.cs
index 2d61948a2a..e1accd5b5f 100644
--- a/osu.Game.Tests/Editing/EditorChangeHandlerTest.cs
+++ b/osu.Game.Tests/Editing/EditorChangeHandlerTest.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Osu.Beatmaps;
diff --git a/osu.Game.Tests/Editing/LegacyEditorBeatmapPatcherTest.cs b/osu.Game.Tests/Editing/LegacyEditorBeatmapPatcherTest.cs
index 44a908b756..5af0366e6e 100644
--- a/osu.Game.Tests/Editing/LegacyEditorBeatmapPatcherTest.cs
+++ b/osu.Game.Tests/Editing/LegacyEditorBeatmapPatcherTest.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.
 
+#nullable disable
+
 using System.IO;
 using System.Text;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/Editing/TestSceneHitObjectComposerDistanceSnapping.cs b/osu.Game.Tests/Editing/TestSceneHitObjectComposerDistanceSnapping.cs
index 82fc7a208b..c2df9e5e09 100644
--- a/osu.Game.Tests/Editing/TestSceneHitObjectComposerDistanceSnapping.cs
+++ b/osu.Game.Tests/Editing/TestSceneHitObjectComposerDistanceSnapping.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game.Tests/Editing/TestSceneHitObjectContainerEventBuffer.cs b/osu.Game.Tests/Editing/TestSceneHitObjectContainerEventBuffer.cs
index 592971dbaf..c3e171684c 100644
--- a/osu.Game.Tests/Editing/TestSceneHitObjectContainerEventBuffer.cs
+++ b/osu.Game.Tests/Editing/TestSceneHitObjectContainerEventBuffer.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.
 
+#nullable disable
+
 using System;
 using NUnit.Framework;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tests/Editing/TransactionalCommitComponentTest.cs b/osu.Game.Tests/Editing/TransactionalCommitComponentTest.cs
index 4ce9115ec4..3d7286c396 100644
--- a/osu.Game.Tests/Editing/TransactionalCommitComponentTest.cs
+++ b/osu.Game.Tests/Editing/TransactionalCommitComponentTest.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.
 
+#nullable disable
+
 using System;
 using NUnit.Framework;
 using osu.Game.Screens.Edit;
diff --git a/osu.Game.Tests/Gameplay/TestSceneDrainingHealthProcessor.cs b/osu.Game.Tests/Gameplay/TestSceneDrainingHealthProcessor.cs
index a354464a8e..f9c4985219 100644
--- a/osu.Game.Tests/Gameplay/TestSceneDrainingHealthProcessor.cs
+++ b/osu.Game.Tests/Gameplay/TestSceneDrainingHealthProcessor.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.
 
+#nullable disable
+
 using System.Threading;
 using NUnit.Framework;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tests/Gameplay/TestSceneDrawableHitObject.cs b/osu.Game.Tests/Gameplay/TestSceneDrawableHitObject.cs
index 58f4c4c8db..91e33b759c 100644
--- a/osu.Game.Tests/Gameplay/TestSceneDrawableHitObject.cs
+++ b/osu.Game.Tests/Gameplay/TestSceneDrawableHitObject.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Graphics;
 using osu.Framework.Testing;
diff --git a/osu.Game.Tests/Gameplay/TestSceneHitObjectAccentColour.cs b/osu.Game.Tests/Gameplay/TestSceneHitObjectAccentColour.cs
index 5553c67141..1e10fbb2bc 100644
--- a/osu.Game.Tests/Gameplay/TestSceneHitObjectAccentColour.cs
+++ b/osu.Game.Tests/Gameplay/TestSceneHitObjectAccentColour.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/Gameplay/TestSceneHitObjectContainer.cs b/osu.Game.Tests/Gameplay/TestSceneHitObjectContainer.cs
index f2bfccb6de..79e64ba2a2 100644
--- a/osu.Game.Tests/Gameplay/TestSceneHitObjectContainer.cs
+++ b/osu.Game.Tests/Gameplay/TestSceneHitObjectContainer.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.
 
+#nullable disable
+
 using JetBrains.Annotations;
 using NUnit.Framework;
 using osu.Framework.Testing;
diff --git a/osu.Game.Tests/Gameplay/TestSceneHitObjectSamples.cs b/osu.Game.Tests/Gameplay/TestSceneHitObjectSamples.cs
index 153d5b8e36..e25d08f98c 100644
--- a/osu.Game.Tests/Gameplay/TestSceneHitObjectSamples.cs
+++ b/osu.Game.Tests/Gameplay/TestSceneHitObjectSamples.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.IO.Stores;
 using osu.Game.Rulesets;
diff --git a/osu.Game.Tests/Gameplay/TestSceneMasterGameplayClockContainer.cs b/osu.Game.Tests/Gameplay/TestSceneMasterGameplayClockContainer.cs
index 5c04ac88a7..ced397921c 100644
--- a/osu.Game.Tests/Gameplay/TestSceneMasterGameplayClockContainer.cs
+++ b/osu.Game.Tests/Gameplay/TestSceneMasterGameplayClockContainer.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
diff --git a/osu.Game.Tests/Gameplay/TestSceneProxyContainer.cs b/osu.Game.Tests/Gameplay/TestSceneProxyContainer.cs
index 1264d575a4..1893e43f43 100644
--- a/osu.Game.Tests/Gameplay/TestSceneProxyContainer.cs
+++ b/osu.Game.Tests/Gameplay/TestSceneProxyContainer.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using NUnit.Framework;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tests/Gameplay/TestSceneScoreProcessor.cs b/osu.Game.Tests/Gameplay/TestSceneScoreProcessor.cs
index 97be1dcfaa..9e1d786d87 100644
--- a/osu.Game.Tests/Gameplay/TestSceneScoreProcessor.cs
+++ b/osu.Game.Tests/Gameplay/TestSceneScoreProcessor.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/Gameplay/TestSceneStoryboardSamples.cs b/osu.Game.Tests/Gameplay/TestSceneStoryboardSamples.cs
index e0a497cf24..a9c6bacc65 100644
--- a/osu.Game.Tests/Gameplay/TestSceneStoryboardSamples.cs
+++ b/osu.Game.Tests/Gameplay/TestSceneStoryboardSamples.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.IO;
 using System.Threading;
diff --git a/osu.Game.Tests/ImportTest.cs b/osu.Game.Tests/ImportTest.cs
index a658a0eaeb..32b6dc649c 100644
--- a/osu.Game.Tests/ImportTest.cs
+++ b/osu.Game.Tests/ImportTest.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.
 
+#nullable disable
+
 using System;
 using System.Threading;
 using System.Threading.Tasks;
diff --git a/osu.Game.Tests/Input/ConfineMouseTrackerTest.cs b/osu.Game.Tests/Input/ConfineMouseTrackerTest.cs
index 28937b2120..a91d4553de 100644
--- a/osu.Game.Tests/Input/ConfineMouseTrackerTest.cs
+++ b/osu.Game.Tests/Input/ConfineMouseTrackerTest.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Configuration;
diff --git a/osu.Game.Tests/Localisation/BeatmapMetadataRomanisationTest.cs b/osu.Game.Tests/Localisation/BeatmapMetadataRomanisationTest.cs
index 9926acf772..d01eaca714 100644
--- a/osu.Game.Tests/Localisation/BeatmapMetadataRomanisationTest.cs
+++ b/osu.Game.Tests/Localisation/BeatmapMetadataRomanisationTest.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Game.Beatmaps;
 
diff --git a/osu.Game.Tests/Models/DisplayStringTest.cs b/osu.Game.Tests/Models/DisplayStringTest.cs
index 2d0bda88e4..d585a0eb9f 100644
--- a/osu.Game.Tests/Models/DisplayStringTest.cs
+++ b/osu.Game.Tests/Models/DisplayStringTest.cs
@@ -10,8 +10,6 @@ using osu.Game.Rulesets;
 using osu.Game.Scoring;
 using osu.Game.Users;
 
-#nullable enable
-
 namespace osu.Game.Tests.Models
 {
     [TestFixture]
diff --git a/osu.Game.Tests/Mods/ModDifficultyAdjustTest.cs b/osu.Game.Tests/Mods/ModDifficultyAdjustTest.cs
index 85b4688eb9..a6f68b2836 100644
--- a/osu.Game.Tests/Mods/ModDifficultyAdjustTest.cs
+++ b/osu.Game.Tests/Mods/ModDifficultyAdjustTest.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using NUnit.Framework;
 using osu.Game.Beatmaps;
diff --git a/osu.Game.Tests/Mods/ModSettingsEqualityComparison.cs b/osu.Game.Tests/Mods/ModSettingsEqualityComparison.cs
index cd6879cf01..e94ee40acd 100644
--- a/osu.Game.Tests/Mods/ModSettingsEqualityComparison.cs
+++ b/osu.Game.Tests/Mods/ModSettingsEqualityComparison.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Game.Online.API;
 using osu.Game.Rulesets.Osu;
diff --git a/osu.Game.Tests/Mods/ModSettingsTest.cs b/osu.Game.Tests/Mods/ModSettingsTest.cs
index b9ea1f2567..607b585d33 100644
--- a/osu.Game.Tests/Mods/ModSettingsTest.cs
+++ b/osu.Game.Tests/Mods/ModSettingsTest.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Osu.Mods;
diff --git a/osu.Game.Tests/Mods/ModUtilsTest.cs b/osu.Game.Tests/Mods/ModUtilsTest.cs
index 6c9dddf51f..22be1a3f01 100644
--- a/osu.Game.Tests/Mods/ModUtilsTest.cs
+++ b/osu.Game.Tests/Mods/ModUtilsTest.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using Moq;
diff --git a/osu.Game.Tests/Mods/MultiModIncompatibilityTest.cs b/osu.Game.Tests/Mods/MultiModIncompatibilityTest.cs
index 312b939315..3c69adcb59 100644
--- a/osu.Game.Tests/Mods/MultiModIncompatibilityTest.cs
+++ b/osu.Game.Tests/Mods/MultiModIncompatibilityTest.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game.Tests/Mods/SettingsSourceAttributeTest.cs b/osu.Game.Tests/Mods/SettingsSourceAttributeTest.cs
index dd105787fa..f608d020d4 100644
--- a/osu.Game.Tests/Mods/SettingsSourceAttributeTest.cs
+++ b/osu.Game.Tests/Mods/SettingsSourceAttributeTest.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Bindables;
diff --git a/osu.Game.Tests/Mods/TestCustomisableModRuleset.cs b/osu.Game.Tests/Mods/TestCustomisableModRuleset.cs
index 3992d9abe6..08007503c6 100644
--- a/osu.Game.Tests/Mods/TestCustomisableModRuleset.cs
+++ b/osu.Game.Tests/Mods/TestCustomisableModRuleset.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using osu.Framework.Bindables;
diff --git a/osu.Game.Tests/NonVisual/BarLineGeneratorTest.cs b/osu.Game.Tests/NonVisual/BarLineGeneratorTest.cs
index 6ae8231deb..e7827a7398 100644
--- a/osu.Game.Tests/NonVisual/BarLineGeneratorTest.cs
+++ b/osu.Game.Tests/NonVisual/BarLineGeneratorTest.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using NUnit.Framework;
 using osu.Framework.Utils;
diff --git a/osu.Game.Tests/NonVisual/BeatmapSetInfoEqualityTest.cs b/osu.Game.Tests/NonVisual/BeatmapSetInfoEqualityTest.cs
index 1b6049fcb7..de23b012c1 100644
--- a/osu.Game.Tests/NonVisual/BeatmapSetInfoEqualityTest.cs
+++ b/osu.Game.Tests/NonVisual/BeatmapSetInfoEqualityTest.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.
 
+#nullable disable
+
 using System;
 using NUnit.Framework;
 using osu.Game.Beatmaps;
diff --git a/osu.Game.Tests/NonVisual/ClosestBeatDivisorTest.cs b/osu.Game.Tests/NonVisual/ClosestBeatDivisorTest.cs
index 08cd80dcfa..6f3fe875e3 100644
--- a/osu.Game.Tests/NonVisual/ClosestBeatDivisorTest.cs
+++ b/osu.Game.Tests/NonVisual/ClosestBeatDivisorTest.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using NUnit.Framework;
 using osu.Game.Beatmaps;
diff --git a/osu.Game.Tests/NonVisual/ControlPointInfoTest.cs b/osu.Game.Tests/NonVisual/ControlPointInfoTest.cs
index cfda4f6422..554473cf77 100644
--- a/osu.Game.Tests/NonVisual/ControlPointInfoTest.cs
+++ b/osu.Game.Tests/NonVisual/ControlPointInfoTest.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Game.Beatmaps.ControlPoints;
diff --git a/osu.Game.Tests/NonVisual/CustomDataDirectoryTest.cs b/osu.Game.Tests/NonVisual/CustomDataDirectoryTest.cs
index fd5691a9f4..7d5f0bcd0c 100644
--- a/osu.Game.Tests/NonVisual/CustomDataDirectoryTest.cs
+++ b/osu.Game.Tests/NonVisual/CustomDataDirectoryTest.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.
 
+#nullable disable
+
 using System;
 using System.IO;
 using System.Linq;
diff --git a/osu.Game.Tests/NonVisual/DifficultyAdjustmentModCombinationsTest.cs b/osu.Game.Tests/NonVisual/DifficultyAdjustmentModCombinationsTest.cs
index ae8eec2629..8d1c266473 100644
--- a/osu.Game.Tests/NonVisual/DifficultyAdjustmentModCombinationsTest.cs
+++ b/osu.Game.Tests/NonVisual/DifficultyAdjustmentModCombinationsTest.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game.Tests/NonVisual/Filtering/FilterMatchingTest.cs b/osu.Game.Tests/NonVisual/Filtering/FilterMatchingTest.cs
index 33204d33a7..2657468b03 100644
--- a/osu.Game.Tests/NonVisual/Filtering/FilterMatchingTest.cs
+++ b/osu.Game.Tests/NonVisual/Filtering/FilterMatchingTest.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets;
diff --git a/osu.Game.Tests/NonVisual/Filtering/FilterQueryParserTest.cs b/osu.Game.Tests/NonVisual/Filtering/FilterQueryParserTest.cs
index 460f89528b..500f3159e2 100644
--- a/osu.Game.Tests/NonVisual/Filtering/FilterQueryParserTest.cs
+++ b/osu.Game.Tests/NonVisual/Filtering/FilterQueryParserTest.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.
 
+#nullable disable
+
 using System;
 using NUnit.Framework;
 using osu.Game.Beatmaps;
diff --git a/osu.Game.Tests/NonVisual/FirstAvailableHitWindowsTest.cs b/osu.Game.Tests/NonVisual/FirstAvailableHitWindowsTest.cs
index 8386a10ebb..a779fae510 100644
--- a/osu.Game.Tests/NonVisual/FirstAvailableHitWindowsTest.cs
+++ b/osu.Game.Tests/NonVisual/FirstAvailableHitWindowsTest.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Diagnostics.CodeAnalysis;
diff --git a/osu.Game.Tests/NonVisual/FormatUtilsTest.cs b/osu.Game.Tests/NonVisual/FormatUtilsTest.cs
index d69822cdc5..4d2fc53bc3 100644
--- a/osu.Game.Tests/NonVisual/FormatUtilsTest.cs
+++ b/osu.Game.Tests/NonVisual/FormatUtilsTest.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Game.Utils;
 
diff --git a/osu.Game.Tests/NonVisual/FramedReplayInputHandlerTest.cs b/osu.Game.Tests/NonVisual/FramedReplayInputHandlerTest.cs
index 99d394b454..4a5bb6de46 100644
--- a/osu.Game.Tests/NonVisual/FramedReplayInputHandlerTest.cs
+++ b/osu.Game.Tests/NonVisual/FramedReplayInputHandlerTest.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game.Tests/NonVisual/GameplayClockTest.cs b/osu.Game.Tests/NonVisual/GameplayClockTest.cs
index 3fd7c364b7..5b8aacd281 100644
--- a/osu.Game.Tests/NonVisual/GameplayClockTest.cs
+++ b/osu.Game.Tests/NonVisual/GameplayClockTest.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using NUnit.Framework;
 using osu.Framework.Bindables;
diff --git a/osu.Game.Tests/NonVisual/LimitedCapacityQueueTest.cs b/osu.Game.Tests/NonVisual/LimitedCapacityQueueTest.cs
index e1eaf213d6..8cd26901c5 100644
--- a/osu.Game.Tests/NonVisual/LimitedCapacityQueueTest.cs
+++ b/osu.Game.Tests/NonVisual/LimitedCapacityQueueTest.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.
 
+#nullable disable
+
 using System;
 using NUnit.Framework;
 using osu.Game.Rulesets.Difficulty.Utils;
diff --git a/osu.Game.Tests/NonVisual/Multiplayer/StatefulMultiplayerClientTest.cs b/osu.Game.Tests/NonVisual/Multiplayer/StatefulMultiplayerClientTest.cs
index 4adb7002a0..9c8b977ad9 100644
--- a/osu.Game.Tests/NonVisual/Multiplayer/StatefulMultiplayerClientTest.cs
+++ b/osu.Game.Tests/NonVisual/Multiplayer/StatefulMultiplayerClientTest.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.
 
+#nullable disable
+
 using System.Linq;
 using Humanizer;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/NonVisual/OngoingOperationTrackerTest.cs b/osu.Game.Tests/NonVisual/OngoingOperationTrackerTest.cs
index 10216c3339..03ca3a0a1a 100644
--- a/osu.Game.Tests/NonVisual/OngoingOperationTrackerTest.cs
+++ b/osu.Game.Tests/NonVisual/OngoingOperationTrackerTest.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.
 
+#nullable disable
+
 using System;
 using NUnit.Framework;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Tests/NonVisual/PeriodTrackerTest.cs b/osu.Game.Tests/NonVisual/PeriodTrackerTest.cs
index 62c7732b66..b589f7c9f1 100644
--- a/osu.Game.Tests/NonVisual/PeriodTrackerTest.cs
+++ b/osu.Game.Tests/NonVisual/PeriodTrackerTest.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/NonVisual/Ranking/UnstableRateTest.cs b/osu.Game.Tests/NonVisual/Ranking/UnstableRateTest.cs
index 103831822c..27c8270f0f 100644
--- a/osu.Game.Tests/NonVisual/Ranking/UnstableRateTest.cs
+++ b/osu.Game.Tests/NonVisual/Ranking/UnstableRateTest.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/NonVisual/ReverseQueueTest.cs b/osu.Game.Tests/NonVisual/ReverseQueueTest.cs
index 808c8d14f0..d0ad2e22a4 100644
--- a/osu.Game.Tests/NonVisual/ReverseQueueTest.cs
+++ b/osu.Game.Tests/NonVisual/ReverseQueueTest.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.
 
+#nullable disable
+
 using System;
 using NUnit.Framework;
 using osu.Game.Rulesets.Difficulty.Utils;
diff --git a/osu.Game.Tests/NonVisual/RulesetInfoOrderingTest.cs b/osu.Game.Tests/NonVisual/RulesetInfoOrderingTest.cs
index ae999d08d5..8654abd49d 100644
--- a/osu.Game.Tests/NonVisual/RulesetInfoOrderingTest.cs
+++ b/osu.Game.Tests/NonVisual/RulesetInfoOrderingTest.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Game.Rulesets;
diff --git a/osu.Game.Tests/NonVisual/ScoreInfoTest.cs b/osu.Game.Tests/NonVisual/ScoreInfoTest.cs
index 41b08a9e98..dcc4f91dba 100644
--- a/osu.Game.Tests/NonVisual/ScoreInfoTest.cs
+++ b/osu.Game.Tests/NonVisual/ScoreInfoTest.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Game.Online.API;
 using osu.Game.Rulesets.Mania;
diff --git a/osu.Game.Tests/NonVisual/SessionStaticsTest.cs b/osu.Game.Tests/NonVisual/SessionStaticsTest.cs
index cd02f15adf..5c8254b947 100644
--- a/osu.Game.Tests/NonVisual/SessionStaticsTest.cs
+++ b/osu.Game.Tests/NonVisual/SessionStaticsTest.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.
 
+#nullable disable
+
 using System;
 using NUnit.Framework;
 using osu.Game.Configuration;
diff --git a/osu.Game.Tests/NonVisual/Skinning/LegacySkinAnimationTest.cs b/osu.Game.Tests/NonVisual/Skinning/LegacySkinAnimationTest.cs
index 4209f188cc..e21a3e636f 100644
--- a/osu.Game.Tests/NonVisual/Skinning/LegacySkinAnimationTest.cs
+++ b/osu.Game.Tests/NonVisual/Skinning/LegacySkinAnimationTest.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/NonVisual/Skinning/LegacySkinTextureFallbackTest.cs b/osu.Game.Tests/NonVisual/Skinning/LegacySkinTextureFallbackTest.cs
index 76c49edf78..efab884d37 100644
--- a/osu.Game.Tests/NonVisual/Skinning/LegacySkinTextureFallbackTest.cs
+++ b/osu.Game.Tests/NonVisual/Skinning/LegacySkinTextureFallbackTest.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.IO;
diff --git a/osu.Game.Tests/NonVisual/TaskChainTest.cs b/osu.Game.Tests/NonVisual/TaskChainTest.cs
index 3678279035..ad1a3fd63f 100644
--- a/osu.Game.Tests/NonVisual/TaskChainTest.cs
+++ b/osu.Game.Tests/NonVisual/TaskChainTest.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.
 
+#nullable disable
+
 using System.Threading;
 using System.Threading.Tasks;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/NonVisual/TimeDisplayExtensionTest.cs b/osu.Game.Tests/NonVisual/TimeDisplayExtensionTest.cs
index 97d7880def..861e342cdb 100644
--- a/osu.Game.Tests/NonVisual/TimeDisplayExtensionTest.cs
+++ b/osu.Game.Tests/NonVisual/TimeDisplayExtensionTest.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.
 
+#nullable disable
+
 using System;
 using NUnit.Framework;
 using osu.Game.Extensions;
diff --git a/osu.Game.Tests/Online/Chat/MessageNotifierTest.cs b/osu.Game.Tests/Online/Chat/MessageNotifierTest.cs
index 855de9b656..13f1ed5c57 100644
--- a/osu.Game.Tests/Online/Chat/MessageNotifierTest.cs
+++ b/osu.Game.Tests/Online/Chat/MessageNotifierTest.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Game.Online.Chat;
 
diff --git a/osu.Game.Tests/Online/TestAPIModJsonSerialization.cs b/osu.Game.Tests/Online/TestAPIModJsonSerialization.cs
index 0622514783..185f85513b 100644
--- a/osu.Game.Tests/Online/TestAPIModJsonSerialization.cs
+++ b/osu.Game.Tests/Online/TestAPIModJsonSerialization.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using Newtonsoft.Json;
diff --git a/osu.Game.Tests/Online/TestAPIModMessagePackSerialization.cs b/osu.Game.Tests/Online/TestAPIModMessagePackSerialization.cs
index 69e19826fd..a89d68bf15 100644
--- a/osu.Game.Tests/Online/TestAPIModMessagePackSerialization.cs
+++ b/osu.Game.Tests/Online/TestAPIModMessagePackSerialization.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using MessagePack;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/Online/TestDummyAPIRequestHandling.cs b/osu.Game.Tests/Online/TestDummyAPIRequestHandling.cs
index 91c6b6c008..61fdae0ca1 100644
--- a/osu.Game.Tests/Online/TestDummyAPIRequestHandling.cs
+++ b/osu.Game.Tests/Online/TestDummyAPIRequestHandling.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Testing;
 using osu.Game.Online.API;
diff --git a/osu.Game.Tests/Online/TestMultiplayerMessagePackSerialization.cs b/osu.Game.Tests/Online/TestMultiplayerMessagePackSerialization.cs
index 81475f2fbe..aea579a82d 100644
--- a/osu.Game.Tests/Online/TestMultiplayerMessagePackSerialization.cs
+++ b/osu.Game.Tests/Online/TestMultiplayerMessagePackSerialization.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.
 
+#nullable disable
+
 using MessagePack;
 using NUnit.Framework;
 using osu.Game.Online;
diff --git a/osu.Game.Tests/Online/TestSceneBeatmapDownloading.cs b/osu.Game.Tests/Online/TestSceneBeatmapDownloading.cs
index ad9ea79646..d0176da0e9 100644
--- a/osu.Game.Tests/Online/TestSceneBeatmapDownloading.cs
+++ b/osu.Game.Tests/Online/TestSceneBeatmapDownloading.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Testing;
diff --git a/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs b/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
index c26d7937ad..e502a71f34 100644
--- a/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.cs
+++ b/osu.Game.Tests/Online/TestSceneOnlinePlayBeatmapAvailabilityTracker.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Diagnostics;
diff --git a/osu.Game.Tests/Online/TestSubmittableScoreJsonSerialization.cs b/osu.Game.Tests/Online/TestSubmittableScoreJsonSerialization.cs
index 662660bce4..f0f6727393 100644
--- a/osu.Game.Tests/Online/TestSubmittableScoreJsonSerialization.cs
+++ b/osu.Game.Tests/Online/TestSubmittableScoreJsonSerialization.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.
 
+#nullable disable
+
 using Newtonsoft.Json;
 using NUnit.Framework;
 using osu.Game.IO.Serialization;
diff --git a/osu.Game.Tests/OnlinePlay/PlaylistExtensionsTest.cs b/osu.Game.Tests/OnlinePlay/PlaylistExtensionsTest.cs
index 9e7ea02101..73ed2bb868 100644
--- a/osu.Game.Tests/OnlinePlay/PlaylistExtensionsTest.cs
+++ b/osu.Game.Tests/OnlinePlay/PlaylistExtensionsTest.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.
 
+#nullable disable
+
 using System;
 using NUnit.Framework;
 using osu.Game.Online.API.Requests.Responses;
diff --git a/osu.Game.Tests/OnlinePlay/TestSceneCatchUpSyncManager.cs b/osu.Game.Tests/OnlinePlay/TestSceneCatchUpSyncManager.cs
index 6851df3832..6c639ee539 100644
--- a/osu.Game.Tests/OnlinePlay/TestSceneCatchUpSyncManager.cs
+++ b/osu.Game.Tests/OnlinePlay/TestSceneCatchUpSyncManager.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.
 
+#nullable disable
+
 using System;
 using NUnit.Framework;
 using osu.Framework.Bindables;
diff --git a/osu.Game.Tests/Resources/TestResources.cs b/osu.Game.Tests/Resources/TestResources.cs
index 81b624f908..91d4eb70e8 100644
--- a/osu.Game.Tests/Resources/TestResources.cs
+++ b/osu.Game.Tests/Resources/TestResources.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.IO;
diff --git a/osu.Game.Tests/Rulesets/Mods/ModTimeRampTest.cs b/osu.Game.Tests/Rulesets/Mods/ModTimeRampTest.cs
index 51163efd6a..2622db464f 100644
--- a/osu.Game.Tests/Rulesets/Mods/ModTimeRampTest.cs
+++ b/osu.Game.Tests/Rulesets/Mods/ModTimeRampTest.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Audio.Track;
 using osu.Framework.Timing;
diff --git a/osu.Game.Tests/Rulesets/Scoring/ScoreProcessorTest.cs b/osu.Game.Tests/Rulesets/Scoring/ScoreProcessorTest.cs
index 7ecd509193..ff282fff62 100644
--- a/osu.Game.Tests/Rulesets/Scoring/ScoreProcessorTest.cs
+++ b/osu.Game.Tests/Rulesets/Scoring/ScoreProcessorTest.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/Rulesets/TestSceneDrawableRulesetDependencies.cs b/osu.Game.Tests/Rulesets/TestSceneDrawableRulesetDependencies.cs
index 20439ac969..9f732be9e3 100644
--- a/osu.Game.Tests/Rulesets/TestSceneDrawableRulesetDependencies.cs
+++ b/osu.Game.Tests/Rulesets/TestSceneDrawableRulesetDependencies.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.IO;
diff --git a/osu.Game.Tests/Rulesets/TestSceneRulesetSkinProvidingContainer.cs b/osu.Game.Tests/Rulesets/TestSceneRulesetSkinProvidingContainer.cs
index 28ad7ed6a7..f1ecd3b526 100644
--- a/osu.Game.Tests/Rulesets/TestSceneRulesetSkinProvidingContainer.cs
+++ b/osu.Game.Tests/Rulesets/TestSceneRulesetSkinProvidingContainer.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.
 
+#nullable disable
+
 using System;
 using NUnit.Framework;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Tests/Scores/IO/ImportScoreTest.cs b/osu.Game.Tests/Scores/IO/ImportScoreTest.cs
index 8de9f0a292..892ceea185 100644
--- a/osu.Game.Tests/Scores/IO/ImportScoreTest.cs
+++ b/osu.Game.Tests/Scores/IO/ImportScoreTest.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.IO;
diff --git a/osu.Game.Tests/Scores/IO/TestScoreEquality.cs b/osu.Game.Tests/Scores/IO/TestScoreEquality.cs
index f898774ce6..d44fd786d7 100644
--- a/osu.Game.Tests/Scores/IO/TestScoreEquality.cs
+++ b/osu.Game.Tests/Scores/IO/TestScoreEquality.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.
 
+#nullable disable
+
 using System;
 using NUnit.Framework;
 using osu.Game.Scoring;
diff --git a/osu.Game.Tests/ScrollAlgorithms/ConstantScrollTest.cs b/osu.Game.Tests/ScrollAlgorithms/ConstantScrollTest.cs
index a6e8622b6f..0994803d83 100644
--- a/osu.Game.Tests/ScrollAlgorithms/ConstantScrollTest.cs
+++ b/osu.Game.Tests/ScrollAlgorithms/ConstantScrollTest.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Game.Rulesets.UI.Scrolling.Algorithms;
 
diff --git a/osu.Game.Tests/ScrollAlgorithms/OverlappingScrollTest.cs b/osu.Game.Tests/ScrollAlgorithms/OverlappingScrollTest.cs
index 1429d22c1a..c1f647cb07 100644
--- a/osu.Game.Tests/ScrollAlgorithms/OverlappingScrollTest.cs
+++ b/osu.Game.Tests/ScrollAlgorithms/OverlappingScrollTest.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Lists;
 using osu.Game.Rulesets.Timing;
diff --git a/osu.Game.Tests/ScrollAlgorithms/SequentialScrollTest.cs b/osu.Game.Tests/ScrollAlgorithms/SequentialScrollTest.cs
index bd578dcbc4..ca6ac63619 100644
--- a/osu.Game.Tests/ScrollAlgorithms/SequentialScrollTest.cs
+++ b/osu.Game.Tests/ScrollAlgorithms/SequentialScrollTest.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Lists;
 using osu.Game.Rulesets.Timing;
diff --git a/osu.Game.Tests/Skins/IO/ImportSkinTest.cs b/osu.Game.Tests/Skins/IO/ImportSkinTest.cs
index dde8715764..4db88cbe82 100644
--- a/osu.Game.Tests/Skins/IO/ImportSkinTest.cs
+++ b/osu.Game.Tests/Skins/IO/ImportSkinTest.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.
 
+#nullable disable
+
 using System;
 using System.IO;
 using System.Linq;
diff --git a/osu.Game.Tests/Skins/LegacyManiaSkinDecoderTest.cs b/osu.Game.Tests/Skins/LegacyManiaSkinDecoderTest.cs
index e811979aed..6da335a9b7 100644
--- a/osu.Game.Tests/Skins/LegacyManiaSkinDecoderTest.cs
+++ b/osu.Game.Tests/Skins/LegacyManiaSkinDecoderTest.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Game.IO;
 using osu.Game.Skinning;
diff --git a/osu.Game.Tests/Skins/LegacySkinDecoderTest.cs b/osu.Game.Tests/Skins/LegacySkinDecoderTest.cs
index cfc140ce39..419eb87b1a 100644
--- a/osu.Game.Tests/Skins/LegacySkinDecoderTest.cs
+++ b/osu.Game.Tests/Skins/LegacySkinDecoderTest.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using NUnit.Framework;
 using osu.Game.IO;
diff --git a/osu.Game.Tests/Skins/TestSceneBeatmapSkinLookupDisables.cs b/osu.Game.Tests/Skins/TestSceneBeatmapSkinLookupDisables.cs
index 0c1981b35d..77ceef6402 100644
--- a/osu.Game.Tests/Skins/TestSceneBeatmapSkinLookupDisables.cs
+++ b/osu.Game.Tests/Skins/TestSceneBeatmapSkinLookupDisables.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.
 
+#nullable disable
+
 using System;
 using NUnit.Framework;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Tests/Skins/TestSceneBeatmapSkinResources.cs b/osu.Game.Tests/Skins/TestSceneBeatmapSkinResources.cs
index fe0423dcfc..bd7e1f8ec5 100644
--- a/osu.Game.Tests/Skins/TestSceneBeatmapSkinResources.cs
+++ b/osu.Game.Tests/Skins/TestSceneBeatmapSkinResources.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Audio.Track;
diff --git a/osu.Game.Tests/Skins/TestSceneSkinConfigurationLookup.cs b/osu.Game.Tests/Skins/TestSceneSkinConfigurationLookup.cs
index d68398236a..5452bfc939 100644
--- a/osu.Game.Tests/Skins/TestSceneSkinConfigurationLookup.cs
+++ b/osu.Game.Tests/Skins/TestSceneSkinConfigurationLookup.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.IO;
diff --git a/osu.Game.Tests/Skins/TestSceneSkinProvidingContainer.cs b/osu.Game.Tests/Skins/TestSceneSkinProvidingContainer.cs
index ffb3d41d18..1229b63a90 100644
--- a/osu.Game.Tests/Skins/TestSceneSkinProvidingContainer.cs
+++ b/osu.Game.Tests/Skins/TestSceneSkinProvidingContainer.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/Skins/TestSceneSkinResources.cs b/osu.Game.Tests/Skins/TestSceneSkinResources.cs
index 0271198049..97588f4053 100644
--- a/osu.Game.Tests/Skins/TestSceneSkinResources.cs
+++ b/osu.Game.Tests/Skins/TestSceneSkinResources.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Extensions;
diff --git a/osu.Game.Tests/Testing/TestSceneRulesetDependencies.cs b/osu.Game.Tests/Testing/TestSceneRulesetDependencies.cs
index 330d3dd2ae..79b44c109a 100644
--- a/osu.Game.Tests/Testing/TestSceneRulesetDependencies.cs
+++ b/osu.Game.Tests/Testing/TestSceneRulesetDependencies.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/Utils/NamingUtilsTest.cs b/osu.Game.Tests/Utils/NamingUtilsTest.cs
index 62e688db90..2195933197 100644
--- a/osu.Game.Tests/Utils/NamingUtilsTest.cs
+++ b/osu.Game.Tests/Utils/NamingUtilsTest.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Game.Utils;
diff --git a/osu.Game.Tests/Visual/Audio/TestSceneAudioFilter.cs b/osu.Game.Tests/Visual/Audio/TestSceneAudioFilter.cs
index 99be72e958..15903b2074 100644
--- a/osu.Game.Tests/Visual/Audio/TestSceneAudioFilter.cs
+++ b/osu.Game.Tests/Visual/Audio/TestSceneAudioFilter.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.
 
+#nullable disable
+
 using ManagedBass.Fx;
 using NUnit.Framework;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Tests/Visual/Background/TestSceneBackgroundScreenDefault.cs b/osu.Game.Tests/Visual/Background/TestSceneBackgroundScreenDefault.cs
index 884e74346b..5aaaca2b2c 100644
--- a/osu.Game.Tests/Visual/Background/TestSceneBackgroundScreenDefault.cs
+++ b/osu.Game.Tests/Visual/Background/TestSceneBackgroundScreenDefault.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/Visual/Background/TestSceneSeasonalBackgroundLoader.cs b/osu.Game.Tests/Visual/Background/TestSceneSeasonalBackgroundLoader.cs
index 0bd1263076..a44ab41d03 100644
--- a/osu.Game.Tests/Visual/Background/TestSceneSeasonalBackgroundLoader.cs
+++ b/osu.Game.Tests/Visual/Background/TestSceneSeasonalBackgroundLoader.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game.Tests/Visual/Background/TestSceneUserDimBackgrounds.cs b/osu.Game.Tests/Visual/Background/TestSceneUserDimBackgrounds.cs
index ef115ab66b..aaccea09d4 100644
--- a/osu.Game.Tests/Visual/Background/TestSceneUserDimBackgrounds.cs
+++ b/osu.Game.Tests/Visual/Background/TestSceneUserDimBackgrounds.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.
 
+#nullable disable
+
 using System.Threading;
 using NUnit.Framework;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Tests/Visual/Background/TestSceneUserDimContainer.cs b/osu.Game.Tests/Visual/Background/TestSceneUserDimContainer.cs
index fede99f450..7cad6f504b 100644
--- a/osu.Game.Tests/Visual/Background/TestSceneUserDimContainer.cs
+++ b/osu.Game.Tests/Visual/Background/TestSceneUserDimContainer.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs
index 6cb171974a..6bcc45d97e 100644
--- a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.cs
+++ b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCard.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCardDifficultyList.cs b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCardDifficultyList.cs
index e6fb4372ff..b609b06921 100644
--- a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCardDifficultyList.cs
+++ b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCardDifficultyList.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCardDownloadButton.cs b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCardDownloadButton.cs
index 068d2bdcbd..3308ffe714 100644
--- a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCardDownloadButton.cs
+++ b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCardDownloadButton.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCardFavouriteButton.cs b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCardFavouriteButton.cs
index 77c9debef6..2fe2264348 100644
--- a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCardFavouriteButton.cs
+++ b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCardFavouriteButton.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCardThumbnail.cs b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCardThumbnail.cs
index a5b52f75f6..0af876bfe8 100644
--- a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCardThumbnail.cs
+++ b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCardThumbnail.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapSetOnlineStatusPill.cs b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapSetOnlineStatusPill.cs
index 8132fe6ab8..ada521f7f6 100644
--- a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapSetOnlineStatusPill.cs
+++ b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapSetOnlineStatusPill.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game.Tests/Visual/Beatmaps/TestSceneDifficultySpectrumDisplay.cs b/osu.Game.Tests/Visual/Beatmaps/TestSceneDifficultySpectrumDisplay.cs
index 4063fa1252..94b2d10fcf 100644
--- a/osu.Game.Tests/Visual/Beatmaps/TestSceneDifficultySpectrumDisplay.cs
+++ b/osu.Game.Tests/Visual/Beatmaps/TestSceneDifficultySpectrumDisplay.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tests/Visual/Collections/TestSceneManageCollectionsDialog.cs b/osu.Game.Tests/Visual/Collections/TestSceneManageCollectionsDialog.cs
index 602c7c84b8..3f30fa367c 100644
--- a/osu.Game.Tests/Visual/Collections/TestSceneManageCollectionsDialog.cs
+++ b/osu.Game.Tests/Visual/Collections/TestSceneManageCollectionsDialog.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Tests/Visual/Colours/TestSceneStarDifficultyColours.cs b/osu.Game.Tests/Visual/Colours/TestSceneStarDifficultyColours.cs
index c345320e28..13d7a33600 100644
--- a/osu.Game.Tests/Visual/Colours/TestSceneStarDifficultyColours.cs
+++ b/osu.Game.Tests/Visual/Colours/TestSceneStarDifficultyColours.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Tests/Visual/Components/TestSceneIdleTracker.cs b/osu.Game.Tests/Visual/Components/TestSceneIdleTracker.cs
index 86a9d555a3..9dd75b6e5e 100644
--- a/osu.Game.Tests/Visual/Components/TestSceneIdleTracker.cs
+++ b/osu.Game.Tests/Visual/Components/TestSceneIdleTracker.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game.Tests/Visual/Components/TestScenePollingComponent.cs b/osu.Game.Tests/Visual/Components/TestScenePollingComponent.cs
index cc8503589d..3c89267610 100644
--- a/osu.Game.Tests/Visual/Components/TestScenePollingComponent.cs
+++ b/osu.Game.Tests/Visual/Components/TestScenePollingComponent.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.
 
+#nullable disable
+
 using System;
 using System.Threading.Tasks;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/Visual/Components/TestScenePreviewTrackManager.cs b/osu.Game.Tests/Visual/Components/TestScenePreviewTrackManager.cs
index 82b6710a17..cb29475ba5 100644
--- a/osu.Game.Tests/Visual/Components/TestScenePreviewTrackManager.cs
+++ b/osu.Game.Tests/Visual/Components/TestScenePreviewTrackManager.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneBeatDivisorControl.cs b/osu.Game.Tests/Visual/Editing/TestSceneBeatDivisorControl.cs
index 073a228224..ecd7732862 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneBeatDivisorControl.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneBeatDivisorControl.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.
 
+#nullable disable
+
 using System;
 using System.Diagnostics;
 using System.Linq;
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneBlueprintOrdering.cs b/osu.Game.Tests/Visual/Editing/TestSceneBlueprintOrdering.cs
index 5d8a6dabd7..796a3cf9fc 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneBlueprintOrdering.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneBlueprintOrdering.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Testing;
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneComposeScreen.cs b/osu.Game.Tests/Visual/Editing/TestSceneComposeScreen.cs
index fa15c00cd4..6b5d9af7af 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneComposeScreen.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneComposeScreen.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneComposeSelectBox.cs b/osu.Game.Tests/Visual/Editing/TestSceneComposeSelectBox.cs
index 87dbb90138..52e44efb30 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneComposeSelectBox.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneComposeSelectBox.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneComposerSelection.cs b/osu.Game.Tests/Visual/Editing/TestSceneComposerSelection.cs
index 17ca9da8f8..31fc107892 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneComposerSelection.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneComposerSelection.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneDesignSection.cs b/osu.Game.Tests/Visual/Editing/TestSceneDesignSection.cs
index 10917df075..1ecbc24d90 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneDesignSection.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneDesignSection.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.
 
+#nullable disable
+
 using System;
 using System.Globalization;
 using System.Linq;
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneDifficultySwitching.cs b/osu.Game.Tests/Visual/Editing/TestSceneDifficultySwitching.cs
index 81cb286058..1f88fa8f35 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneDifficultySwitching.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneDifficultySwitching.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneDistanceSnapGrid.cs b/osu.Game.Tests/Visual/Editing/TestSceneDistanceSnapGrid.cs
index ef07c3e411..53b6db2277 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneDistanceSnapGrid.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneDistanceSnapGrid.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneEditorBeatmapCreation.cs b/osu.Game.Tests/Visual/Editing/TestSceneEditorBeatmapCreation.cs
index b109234fec..92f07af7b1 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneEditorBeatmapCreation.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneEditorBeatmapCreation.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.
 
+#nullable disable
+
 using System;
 using System.IO;
 using System.Linq;
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneEditorChangeStates.cs b/osu.Game.Tests/Visual/Editing/TestSceneEditorChangeStates.cs
index ab53f4fd93..109a49310a 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneEditorChangeStates.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneEditorChangeStates.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Objects;
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneEditorClipboard.cs b/osu.Game.Tests/Visual/Editing/TestSceneEditorClipboard.cs
index e41f8372b4..23e137865c 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneEditorClipboard.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneEditorClipboard.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Testing;
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneEditorClock.cs b/osu.Game.Tests/Visual/Editing/TestSceneEditorClock.cs
index 393d3886e7..3be6371f28 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneEditorClock.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneEditorClock.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneEditorComposeRadioButtons.cs b/osu.Game.Tests/Visual/Editing/TestSceneEditorComposeRadioButtons.cs
index 028509ccd4..56435c69a4 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneEditorComposeRadioButtons.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneEditorComposeRadioButtons.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Sprites;
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneEditorMenuBar.cs b/osu.Game.Tests/Visual/Editing/TestSceneEditorMenuBar.cs
index ad6fc55a32..913155aafb 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneEditorMenuBar.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneEditorMenuBar.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneEditorSamplePlayback.cs b/osu.Game.Tests/Visual/Editing/TestSceneEditorSamplePlayback.cs
index 2abc8a8dec..43a3cb1342 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneEditorSamplePlayback.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneEditorSamplePlayback.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Testing;
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneEditorSaving.cs b/osu.Game.Tests/Visual/Editing/TestSceneEditorSaving.cs
index e75c7f25a3..cf1246ef07 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneEditorSaving.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneEditorSaving.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneEditorScreenModes.cs b/osu.Game.Tests/Visual/Editing/TestSceneEditorScreenModes.cs
index 2efd125f81..962260e1bd 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneEditorScreenModes.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneEditorScreenModes.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneEditorSeekSnapping.cs b/osu.Game.Tests/Visual/Editing/TestSceneEditorSeekSnapping.cs
index 863f42520b..c8ca273db5 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneEditorSeekSnapping.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneEditorSeekSnapping.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneEditorSeeking.cs b/osu.Game.Tests/Visual/Editing/TestSceneEditorSeeking.cs
index da28387c4d..6f248f1247 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneEditorSeeking.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneEditorSeeking.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Utils;
 using osu.Game.Beatmaps;
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneEditorSummaryTimeline.cs b/osu.Game.Tests/Visual/Editing/TestSceneEditorSummaryTimeline.cs
index da0c83bb11..3657878075 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneEditorSummaryTimeline.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneEditorSummaryTimeline.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneEditorTestGameplay.cs b/osu.Game.Tests/Visual/Editing/TestSceneEditorTestGameplay.cs
index 79ea866efe..a5d115331d 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneEditorTestGameplay.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneEditorTestGameplay.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneHitObjectComposer.cs b/osu.Game.Tests/Visual/Editing/TestSceneHitObjectComposer.cs
index c9d44fdab7..adb495f3d3 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneHitObjectComposer.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneHitObjectComposer.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneHitObjectDifficultyPointAdjustments.cs b/osu.Game.Tests/Visual/Editing/TestSceneHitObjectDifficultyPointAdjustments.cs
index 7c05abc2cd..a429c6f58b 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneHitObjectDifficultyPointAdjustments.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneHitObjectDifficultyPointAdjustments.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.
 
+#nullable disable
+
 using System.Linq;
 using Humanizer;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneHitObjectSamplePointAdjustments.cs b/osu.Game.Tests/Visual/Editing/TestSceneHitObjectSamplePointAdjustments.cs
index 4501eea88e..6313842dfd 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneHitObjectSamplePointAdjustments.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneHitObjectSamplePointAdjustments.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.
 
+#nullable disable
+
 using System.Linq;
 using Humanizer;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneLabelledTimeSignature.cs b/osu.Game.Tests/Visual/Editing/TestSceneLabelledTimeSignature.cs
index b34974dfc7..328e41ebea 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneLabelledTimeSignature.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneLabelledTimeSignature.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneMetadataSection.cs b/osu.Game.Tests/Visual/Editing/TestSceneMetadataSection.cs
index 4ecfb0975b..d87bbd8a10 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneMetadataSection.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneMetadataSection.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Game.Beatmaps;
diff --git a/osu.Game.Tests/Visual/Editing/TestScenePlaybackControl.cs b/osu.Game.Tests/Visual/Editing/TestScenePlaybackControl.cs
index bf0a7876a9..78f650f0fa 100644
--- a/osu.Game.Tests/Visual/Editing/TestScenePlaybackControl.cs
+++ b/osu.Game.Tests/Visual/Editing/TestScenePlaybackControl.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneRectangularPositionSnapGrid.cs b/osu.Game.Tests/Visual/Editing/TestSceneRectangularPositionSnapGrid.cs
index 85a98eca47..7ad12c37bc 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneRectangularPositionSnapGrid.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneRectangularPositionSnapGrid.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.
 
+#nullable disable
+
 using System;
 using NUnit.Framework;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneSetupScreen.cs b/osu.Game.Tests/Visual/Editing/TestSceneSetupScreen.cs
index 2f6cf46b21..ddb458d570 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneSetupScreen.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneSetupScreen.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneTapButton.cs b/osu.Game.Tests/Visual/Editing/TestSceneTapButton.cs
index d8141619ab..f36524290a 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneTapButton.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneTapButton.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneTapTimingControl.cs b/osu.Game.Tests/Visual/Editing/TestSceneTapTimingControl.cs
index a1218aa3e7..7d881bc259 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneTapTimingControl.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneTapTimingControl.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneTimelineBlueprintContainer.cs b/osu.Game.Tests/Visual/Editing/TestSceneTimelineBlueprintContainer.cs
index 6b54bcb4f0..d2984728b0 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneTimelineBlueprintContainer.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneTimelineBlueprintContainer.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Graphics;
 using osu.Game.Screens.Edit.Compose.Components.Timeline;
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneTimelineHitObjectBlueprint.cs b/osu.Game.Tests/Visual/Editing/TestSceneTimelineHitObjectBlueprint.cs
index d55852ec43..603dbf4c67 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneTimelineHitObjectBlueprint.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneTimelineHitObjectBlueprint.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneTimelineSelection.cs b/osu.Game.Tests/Visual/Editing/TestSceneTimelineSelection.cs
index 81ab4712ab..7e0981ce69 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneTimelineSelection.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneTimelineSelection.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneTimelineTickDisplay.cs b/osu.Game.Tests/Visual/Editing/TestSceneTimelineTickDisplay.cs
index b78512e469..b02f0b09b4 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneTimelineTickDisplay.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneTimelineTickDisplay.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneTimelineZoom.cs b/osu.Game.Tests/Visual/Editing/TestSceneTimelineZoom.cs
index d726bd004e..fd103ff70f 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneTimelineZoom.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneTimelineZoom.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Graphics;
 using osu.Framework.Utils;
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneTimingScreen.cs b/osu.Game.Tests/Visual/Editing/TestSceneTimingScreen.cs
index a358166477..e262bd756a 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneTimingScreen.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneTimingScreen.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneWaveform.cs b/osu.Game.Tests/Visual/Editing/TestSceneWaveform.cs
index eb7e90f0a7..82b0d70cff 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneWaveform.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneWaveform.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.
 
+#nullable disable
+
 using System.Threading;
 using NUnit.Framework;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneZoomableScrollContainer.cs b/osu.Game.Tests/Visual/Editing/TestSceneZoomableScrollContainer.cs
index 43e3404d98..9dc403814b 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneZoomableScrollContainer.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneZoomableScrollContainer.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Colour;
diff --git a/osu.Game.Tests/Visual/Editing/TimelineTestScene.cs b/osu.Game.Tests/Visual/Editing/TimelineTestScene.cs
index 93bfb288d2..437f06c47f 100644
--- a/osu.Game.Tests/Visual/Editing/TimelineTestScene.cs
+++ b/osu.Game.Tests/Visual/Editing/TimelineTestScene.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
 using osu.Framework.Bindables;
diff --git a/osu.Game.Tests/Visual/Gameplay/OsuPlayerTestScene.cs b/osu.Game.Tests/Visual/Gameplay/OsuPlayerTestScene.cs
index cbf8515567..f173170da5 100644
--- a/osu.Game.Tests/Visual/Gameplay/OsuPlayerTestScene.cs
+++ b/osu.Game.Tests/Visual/Gameplay/OsuPlayerTestScene.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.
 
+#nullable disable
+
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Osu;
 
diff --git a/osu.Game.Tests/Visual/Gameplay/SkinnableHUDComponentTestScene.cs b/osu.Game.Tests/Visual/Gameplay/SkinnableHUDComponentTestScene.cs
index 6de9d7c478..3ecf560eb1 100644
--- a/osu.Game.Tests/Visual/Gameplay/SkinnableHUDComponentTestScene.cs
+++ b/osu.Game.Tests/Visual/Gameplay/SkinnableHUDComponentTestScene.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Graphics;
 using osu.Game.Rulesets;
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneAllRulesetPlayers.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneAllRulesetPlayers.cs
index e10ef57a25..a8d7148bd2 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneAllRulesetPlayers.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneAllRulesetPlayers.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Game.Configuration;
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneAutoplay.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneAutoplay.cs
index 346a88a2d5..019bfe322e 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneAutoplay.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneAutoplay.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.
 
+#nullable disable
+
 using System.ComponentModel;
 using System.Linq;
 using osu.Framework.Testing;
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneBeatmapOffsetControl.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneBeatmapOffsetControl.cs
index 8ca49837da..cfd282c404 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneBeatmapOffsetControl.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneBeatmapOffsetControl.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneBeatmapSkinFallbacks.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneBeatmapSkinFallbacks.cs
index e9aa85f4ce..d4f3d0f390 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneBeatmapSkinFallbacks.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneBeatmapSkinFallbacks.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneBreakTracker.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneBreakTracker.cs
index be17721b88..e31b325d54 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneBreakTracker.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneBreakTracker.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneCompletionCancellation.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneCompletionCancellation.cs
index 11bd701e19..6aedc64370 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneCompletionCancellation.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneCompletionCancellation.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneDrawableScrollingRuleset.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneDrawableScrollingRuleset.cs
index e1755b8fc3..f9a3695d65 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneDrawableScrollingRuleset.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneDrawableScrollingRuleset.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneDrawableStoryboardSprite.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneDrawableStoryboardSprite.cs
index b2f4fa2738..ca7d7b42d8 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneDrawableStoryboardSprite.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneDrawableStoryboardSprite.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneFailAnimation.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneFailAnimation.cs
index 83d7d769df..0b737f5110 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneFailAnimation.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneFailAnimation.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.
 
+#nullable disable
+
 using System;
 using NUnit.Framework;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneFailJudgement.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneFailJudgement.cs
index bf491db45a..90a4b536bb 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneFailJudgement.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneFailJudgement.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using osu.Game.Rulesets;
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneFailingLayer.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneFailingLayer.cs
index c335f7c99e..90e36ecae2 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneFailingLayer.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneFailingLayer.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneFrameStabilityContainer.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneFrameStabilityContainer.cs
index ae0decaee1..97ffbfc796 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneFrameStabilityContainer.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneFrameStabilityContainer.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneGameplayLeaderboard.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneGameplayLeaderboard.cs
index 74212de210..663e398c01 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneGameplayLeaderboard.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneGameplayLeaderboard.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Bindables;
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneGameplayMenuOverlay.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneGameplayMenuOverlay.cs
index abd43e7427..f3a6302da0 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneGameplayMenuOverlay.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneGameplayMenuOverlay.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneGameplayRewinding.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneGameplayRewinding.cs
index 814b41cdbc..0a32513834 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneGameplayRewinding.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneGameplayRewinding.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneGameplaySamplePlayback.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneGameplaySamplePlayback.cs
index 815cc09448..f1084bca5f 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneGameplaySamplePlayback.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneGameplaySamplePlayback.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneGameplaySampleTriggerSource.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneGameplaySampleTriggerSource.cs
index ac39395567..79e3cf000e 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneGameplaySampleTriggerSource.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneGameplaySampleTriggerSource.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Game.Audio;
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneHUDOverlay.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneHUDOverlay.cs
index 949f0f667b..dd0f965914 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneHUDOverlay.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneHUDOverlay.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneHitErrorMeter.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneHitErrorMeter.cs
index cbf9760e21..70d7f6a28b 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneHitErrorMeter.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneHitErrorMeter.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Diagnostics.CodeAnalysis;
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneHoldForMenuButton.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneHoldForMenuButton.cs
index ddb0872541..50fd1b2a51 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneHoldForMenuButton.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneHoldForMenuButton.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneKeyBindings.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneKeyBindings.cs
index 70a43fafb5..c690203f82 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneKeyBindings.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneKeyBindings.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using NUnit.Framework;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneKeyCounter.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneKeyCounter.cs
index 87ab42fe60..bfda6f50cb 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneKeyCounter.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneKeyCounter.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneLeadIn.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneLeadIn.cs
index b90bd93002..7f4276f819 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneLeadIn.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneLeadIn.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneMedalOverlay.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneMedalOverlay.cs
index 0ada3cf05f..3fd36d509d 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneMedalOverlay.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneMedalOverlay.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Game.Overlays;
 using osu.Game.Users;
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneNightcoreBeatContainer.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneNightcoreBeatContainer.cs
index 759e4fa4ec..966138c0b3 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneNightcoreBeatContainer.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneNightcoreBeatContainer.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.
 
+#nullable disable
+
 using System.Linq;
 using osu.Framework.Extensions.IEnumerableExtensions;
 using osu.Game.Beatmaps.Timing;
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneOverlayActivation.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneOverlayActivation.cs
index b308f3d7d8..3e637f1870 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneOverlayActivation.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneOverlayActivation.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Game.Overlays;
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneParticleExplosion.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneParticleExplosion.cs
index 82095cb809..bddf051871 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneParticleExplosion.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneParticleExplosion.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneParticleSpewer.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneParticleSpewer.cs
index ce5cd629e0..26706d9465 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneParticleSpewer.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneParticleSpewer.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.
 
+#nullable disable
+
 using System;
 using NUnit.Framework;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Tests/Visual/Gameplay/TestScenePause.cs b/osu.Game.Tests/Visual/Gameplay/TestScenePause.cs
index ab5d766609..5bd0a29308 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestScenePause.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestScenePause.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Bindables;
diff --git a/osu.Game.Tests/Visual/Gameplay/TestScenePauseWhenInactive.cs b/osu.Game.Tests/Visual/Gameplay/TestScenePauseWhenInactive.cs
index 49c1163c6c..e1c755b90c 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestScenePauseWhenInactive.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestScenePauseWhenInactive.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using NUnit.Framework;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Tests/Visual/Gameplay/TestScenePerformancePointsCounter.cs b/osu.Game.Tests/Visual/Gameplay/TestScenePerformancePointsCounter.cs
index aefe0db36a..a86e707400 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestScenePerformancePointsCounter.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestScenePerformancePointsCounter.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.
 
+#nullable disable
+
 using System;
 using System.Diagnostics;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/Visual/Gameplay/TestScenePlayerLoader.cs b/osu.Game.Tests/Visual/Gameplay/TestScenePlayerLoader.cs
index 950c755cc1..56588e4d4e 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestScenePlayerLoader.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestScenePlayerLoader.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game.Tests/Visual/Gameplay/TestScenePlayerReferenceLeaking.cs b/osu.Game.Tests/Visual/Gameplay/TestScenePlayerReferenceLeaking.cs
index 7c2f1c5bb2..ec0eea62d9 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestScenePlayerReferenceLeaking.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestScenePlayerReferenceLeaking.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Lists;
 using osu.Game.Beatmaps;
diff --git a/osu.Game.Tests/Visual/Gameplay/TestScenePlayerScoreSubmission.cs b/osu.Game.Tests/Visual/Gameplay/TestScenePlayerScoreSubmission.cs
index 58b5df2612..e0c8989389 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestScenePlayerScoreSubmission.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestScenePlayerScoreSubmission.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using System.Threading;
diff --git a/osu.Game.Tests/Visual/Gameplay/TestScenePoolingRuleset.cs b/osu.Game.Tests/Visual/Gameplay/TestScenePoolingRuleset.cs
index 911fffbe7f..1fa4885b7a 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestScenePoolingRuleset.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestScenePoolingRuleset.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneReplay.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneReplay.cs
index 8622fe8f53..faa6a429c5 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneReplay.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneReplay.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.
 
+#nullable disable
+
 using System;
 using System.ComponentModel;
 using System.Linq;
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneReplayDownloadButton.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneReplayDownloadButton.cs
index e89350de1a..10a6b196b0 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneReplayDownloadButton.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneReplayDownloadButton.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneReplayPlayer.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneReplayPlayer.cs
index fcd65eaff3..6319b91a38 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneReplayPlayer.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneReplayPlayer.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Osu;
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneReplayRecorder.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneReplayRecorder.cs
index 8362739d3b..54b2e66f2f 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneReplayRecorder.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneReplayRecorder.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneScrollingHitObjects.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneScrollingHitObjects.cs
index 283fe594ea..8a4818d2f8 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneScrollingHitObjects.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneScrollingHitObjects.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSkinEditor.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSkinEditor.cs
index 74ce9726e7..3bebf2b68b 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSkinEditor.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSkinEditor.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSkinEditorComponentsList.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSkinEditorComponentsList.cs
index 5385a9983b..f88b4be3d8 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSkinEditorComponentsList.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSkinEditorComponentsList.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSkinEditorMultipleSkins.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSkinEditorMultipleSkins.cs
index 5f838b8813..3eb92b3e97 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSkinEditorMultipleSkins.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSkinEditorMultipleSkins.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableAccuracyCounter.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableAccuracyCounter.cs
index 9c713b4616..1288f2a9f1 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableAccuracyCounter.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableAccuracyCounter.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableComboCounter.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableComboCounter.cs
index f507172931..eacab6d34f 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableComboCounter.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableComboCounter.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableDrawable.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableDrawable.cs
index 35130f3109..757a261de6 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableDrawable.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableDrawable.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Globalization;
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableHUDOverlay.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableHUDOverlay.cs
index 5f2d9ee9e8..ee2827122d 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableHUDOverlay.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableHUDOverlay.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableHealthDisplay.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableHealthDisplay.cs
index 057798c922..2d6ad28b90 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableHealthDisplay.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableHealthDisplay.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableScoreCounter.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableScoreCounter.cs
index a871e37ad4..1b3538cc21 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableScoreCounter.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableScoreCounter.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableSound.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableSound.cs
index 31abcb6748..36b07043dc 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableSound.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableSound.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSkipOverlay.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSkipOverlay.cs
index e08e03b789..e1fc65404d 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSkipOverlay.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSkipOverlay.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSliderPath.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSliderPath.cs
index 9750838433..7044ddad37 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSliderPath.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSliderPath.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSongProgress.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSongProgress.cs
index 733e8f4290..07efb25b46 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSongProgress.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSongProgress.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using NUnit.Framework;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs
index b5cdd61ee5..a42e86933f 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorHost.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorHost.cs
index 034519fbf8..c55e98c1a8 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorHost.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorHost.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Game.Online.API;
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorPlayback.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorPlayback.cs
index 2d2e05c4c9..1e517efef2 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorPlayback.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectatorPlayback.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneStarCounter.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneStarCounter.cs
index 717485bcc1..708a5e94de 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneStarCounter.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneStarCounter.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Graphics;
 using osu.Framework.Utils;
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboard.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboard.cs
index 014ccb1652..30c2790fb4 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboard.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboard.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboardSamplePlayback.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboardSamplePlayback.cs
index 909cab5e3d..079d459beb 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboardSamplePlayback.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboardSamplePlayback.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboardWithOutro.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboardWithOutro.cs
index b87183cbc7..68d024e63f 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboardWithOutro.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboardWithOutro.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using System.Threading.Tasks;
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneUnknownMod.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneUnknownMod.cs
index c0f1112905..a31347589b 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneUnknownMod.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneUnknownMod.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Mods;
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneUnstableRateCounter.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneUnstableRateCounter.cs
index ca8ecd490d..60b8691bfb 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneUnstableRateCounter.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneUnstableRateCounter.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tests/Visual/Menus/IntroTestScene.cs b/osu.Game.Tests/Visual/Menus/IntroTestScene.cs
index c68cd39c65..66e3612113 100644
--- a/osu.Game.Tests/Visual/Menus/IntroTestScene.cs
+++ b/osu.Game.Tests/Visual/Menus/IntroTestScene.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tests/Visual/Menus/TestSceneDisclaimer.cs b/osu.Game.Tests/Visual/Menus/TestSceneDisclaimer.cs
index db5891bd4e..57f16bbcce 100644
--- a/osu.Game.Tests/Visual/Menus/TestSceneDisclaimer.cs
+++ b/osu.Game.Tests/Visual/Menus/TestSceneDisclaimer.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests.Responses;
diff --git a/osu.Game.Tests/Visual/Menus/TestSceneIntroCircles.cs b/osu.Game.Tests/Visual/Menus/TestSceneIntroCircles.cs
index 7ad49b5dcd..85a3a51ddb 100644
--- a/osu.Game.Tests/Visual/Menus/TestSceneIntroCircles.cs
+++ b/osu.Game.Tests/Visual/Menus/TestSceneIntroCircles.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Game.Screens.Menu;
 
diff --git a/osu.Game.Tests/Visual/Menus/TestSceneIntroTriangles.cs b/osu.Game.Tests/Visual/Menus/TestSceneIntroTriangles.cs
index abe8936330..7ab04a22e5 100644
--- a/osu.Game.Tests/Visual/Menus/TestSceneIntroTriangles.cs
+++ b/osu.Game.Tests/Visual/Menus/TestSceneIntroTriangles.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Game.Screens.Menu;
 
diff --git a/osu.Game.Tests/Visual/Menus/TestSceneIntroWelcome.cs b/osu.Game.Tests/Visual/Menus/TestSceneIntroWelcome.cs
index 11cea25865..ae63022823 100644
--- a/osu.Game.Tests/Visual/Menus/TestSceneIntroWelcome.cs
+++ b/osu.Game.Tests/Visual/Menus/TestSceneIntroWelcome.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Utils;
 using osu.Game.Screens.Menu;
diff --git a/osu.Game.Tests/Visual/Menus/TestSceneLoader.cs b/osu.Game.Tests/Visual/Menus/TestSceneLoader.cs
index c44363d9ea..1f2eb57b79 100644
--- a/osu.Game.Tests/Visual/Menus/TestSceneLoader.cs
+++ b/osu.Game.Tests/Visual/Menus/TestSceneLoader.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.
 
+#nullable disable
+
 using System.Linq;
 using System.Threading;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/Visual/Menus/TestSceneLoginPanel.cs b/osu.Game.Tests/Visual/Menus/TestSceneLoginPanel.cs
index 642cc68de5..dbe7b9cc74 100644
--- a/osu.Game.Tests/Visual/Menus/TestSceneLoginPanel.cs
+++ b/osu.Game.Tests/Visual/Menus/TestSceneLoginPanel.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tests/Visual/Menus/TestSceneMusicActionHandling.cs b/osu.Game.Tests/Visual/Menus/TestSceneMusicActionHandling.cs
index 10a82089b3..14b2593fa7 100644
--- a/osu.Game.Tests/Visual/Menus/TestSceneMusicActionHandling.cs
+++ b/osu.Game.Tests/Visual/Menus/TestSceneMusicActionHandling.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/Visual/Menus/TestSceneSideOverlays.cs b/osu.Game.Tests/Visual/Menus/TestSceneSideOverlays.cs
index bbab6380ba..7a2b4d5ca5 100644
--- a/osu.Game.Tests/Visual/Menus/TestSceneSideOverlays.cs
+++ b/osu.Game.Tests/Visual/Menus/TestSceneSideOverlays.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/Visual/Menus/TestSceneSongTicker.cs b/osu.Game.Tests/Visual/Menus/TestSceneSongTicker.cs
index 4b22af38c5..ba73361566 100644
--- a/osu.Game.Tests/Visual/Menus/TestSceneSongTicker.cs
+++ b/osu.Game.Tests/Visual/Menus/TestSceneSongTicker.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Overlays;
diff --git a/osu.Game.Tests/Visual/Menus/TestSceneToolbar.cs b/osu.Game.Tests/Visual/Menus/TestSceneToolbar.cs
index 0b99c781ef..90e218675c 100644
--- a/osu.Game.Tests/Visual/Menus/TestSceneToolbar.cs
+++ b/osu.Game.Tests/Visual/Menus/TestSceneToolbar.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.
 
+#nullable disable
+
 using System.Linq;
 using JetBrains.Annotations;
 using Moq;
diff --git a/osu.Game.Tests/Visual/Menus/TestSceneToolbarClock.cs b/osu.Game.Tests/Visual/Menus/TestSceneToolbarClock.cs
index 87d836687f..d96f80df40 100644
--- a/osu.Game.Tests/Visual/Menus/TestSceneToolbarClock.cs
+++ b/osu.Game.Tests/Visual/Menus/TestSceneToolbarClock.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game.Tests/Visual/Mods/TestSceneModFailCondition.cs b/osu.Game.Tests/Visual/Mods/TestSceneModFailCondition.cs
index af874cec91..91fa09b414 100644
--- a/osu.Game.Tests/Visual/Mods/TestSceneModFailCondition.cs
+++ b/osu.Game.Tests/Visual/Mods/TestSceneModFailCondition.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game.Tests/Visual/Multiplayer/MultiplayerGameplayLeaderboardTestScene.cs b/osu.Game.Tests/Visual/Multiplayer/MultiplayerGameplayLeaderboardTestScene.cs
index a738debecc..43ca47778a 100644
--- a/osu.Game.Tests/Visual/Multiplayer/MultiplayerGameplayLeaderboardTestScene.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/MultiplayerGameplayLeaderboardTestScene.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Collections.Specialized;
diff --git a/osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs b/osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs
index bafc579134..074a92f5b0 100644
--- a/osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/QueueModeTestScene.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneAllPlayersQueueMode.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneAllPlayersQueueMode.cs
index 0785315b26..86da9dc33d 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneAllPlayersQueueMode.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneAllPlayersQueueMode.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 enable
-
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneCreateMultiplayerMatchButton.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneCreateMultiplayerMatchButton.cs
index 0674fc7a39..317e410f37 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneCreateMultiplayerMatchButton.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneCreateMultiplayerMatchButton.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.
 
+#nullable disable
+
 using System;
 using NUnit.Framework;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableLoungeRoom.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableLoungeRoom.cs
index ea895a23d2..fc3079cba0 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableLoungeRoom.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableLoungeRoom.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using System.Threading;
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoom.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoom.cs
index 3172a68b81..23ef440a4d 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoom.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoom.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomParticipantsList.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomParticipantsList.cs
index 60f47a01a9..0a59e0e858 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomParticipantsList.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomParticipantsList.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
index e2b4b2870f..757dfff2b7 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Diagnostics;
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneFreeModSelectOverlay.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneFreeModSelectOverlay.cs
index a8471edbf8..457af3e4af 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneFreeModSelectOverlay.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneFreeModSelectOverlay.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneGameplayChatDisplay.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneGameplayChatDisplay.cs
index c3487751b9..a08791ecff 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneGameplayChatDisplay.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneGameplayChatDisplay.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.
 
+#nullable disable
+
 using System.Linq;
 using Moq;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneHostOnlyQueueMode.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneHostOnlyQueueMode.cs
index c3ec7a5369..fe584fe3da 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneHostOnlyQueueMode.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneHostOnlyQueueMode.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneLoungeRoomsContainer.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneLoungeRoomsContainer.cs
index 93cd281bc5..171f8eea52 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneLoungeRoomsContainer.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneLoungeRoomsContainer.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchBeatmapDetailArea.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchBeatmapDetailArea.cs
index 6f43511e8a..8cdcdfdfdf 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchBeatmapDetailArea.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchBeatmapDetailArea.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Graphics;
 using osu.Game.Online.API;
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchLeaderboard.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchLeaderboard.cs
index 955710bd50..506d7541a7 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchLeaderboard.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchLeaderboard.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using NUnit.Framework;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.cs
index ff6c02c4e5..0cdc144b6a 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMatchStartControl.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using Moq;
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiHeader.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiHeader.cs
index 2244dcfc56..70c6271d24 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiHeader.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiHeader.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Graphics;
 using osu.Framework.Screens;
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorLeaderboard.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorLeaderboard.cs
index 60215dc8b3..80c356ec67 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorLeaderboard.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorLeaderboard.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs
index c048722804..877c986d61 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
index 8e45d99eae..d464527976 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayer.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.
 
+#nullable disable
+
 using System;
 using System.Diagnostics;
 using System.Linq;
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs
index cbbd535cee..95fd449dd3 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboard.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboardTeams.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboardTeams.cs
index c25884039f..93ccf3977b 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboardTeams.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerGameplayLeaderboardTeams.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.
 
+#nullable disable
+
 using System.Linq;
 using osu.Framework.Graphics;
 using osu.Game.Online.Multiplayer;
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerLoungeSubScreen.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerLoungeSubScreen.cs
index de3df754a2..1a3fefa603 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerLoungeSubScreen.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerLoungeSubScreen.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchFooter.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchFooter.cs
index 111f51675d..a98030e1e3 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchFooter.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchFooter.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs
index eacd80925d..285258d7c0 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSongSelect.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs
index 7ae81c9800..bb7587ac56 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerParticipantsList.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerParticipantsList.cs
index 8da077cd44..75e3da05d3 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerParticipantsList.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerParticipantsList.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlayer.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlayer.cs
index e05580fed6..042a9297eb 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlayer.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlayer.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Screens;
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs
index 1231866b36..5ee385810b 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerPlaylist.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs
index 117aaeba83..fcd6dd5bd2 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerQueueList.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerResults.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerResults.cs
index cc08135939..a638702ceb 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerResults.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerResults.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Game.Online.Rooms;
 using osu.Game.Rulesets.Osu;
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerSpectateButton.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerSpectateButton.cs
index 13917f4eb0..486da48449 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerSpectateButton.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerSpectateButton.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerSpectatorPlayerGrid.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerSpectatorPlayerGrid.cs
index c0958c7fe8..089b4a020d 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerSpectatorPlayerGrid.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerSpectatorPlayerGrid.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerTeamResults.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerTeamResults.cs
index 0237298fa1..56260941a8 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerTeamResults.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerTeamResults.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using NUnit.Framework;
 using osu.Framework.Bindables;
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsRoomSettingsPlaylist.cs b/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsRoomSettingsPlaylist.cs
index 98dc243ab5..bbccdb0d17 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsRoomSettingsPlaylist.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsRoomSettingsPlaylist.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsSongSelect.cs b/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsSongSelect.cs
index f8d62c9840..88afe1ce7c 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsSongSelect.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestScenePlaylistsSongSelect.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneRankRangePill.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneRankRangePill.cs
index b0a977dcbb..cb80fb56df 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneRankRangePill.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneRankRangePill.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using Moq;
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneStarRatingRangeDisplay.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneStarRatingRangeDisplay.cs
index 5e4013b0f1..321e0c2c89 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneStarRatingRangeDisplay.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneStarRatingRangeDisplay.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Graphics;
 using osu.Game.Beatmaps;
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs
index 19e1f62fd5..2e39449f64 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneTeamVersus.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/Visual/Navigation/TestEFToRealmMigration.cs b/osu.Game.Tests/Visual/Navigation/TestEFToRealmMigration.cs
index 2ea768b878..c3559589ed 100644
--- a/osu.Game.Tests/Visual/Navigation/TestEFToRealmMigration.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestEFToRealmMigration.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.
 
+#nullable disable
+
 using System.Linq;
 using System.Runtime.InteropServices;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneButtonSystemNavigation.cs b/osu.Game.Tests/Visual/Navigation/TestSceneButtonSystemNavigation.cs
index 8c96ec699f..bff30b83f9 100644
--- a/osu.Game.Tests/Visual/Navigation/TestSceneButtonSystemNavigation.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneButtonSystemNavigation.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Testing;
diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneChangeAndUseGameplayBindings.cs b/osu.Game.Tests/Visual/Navigation/TestSceneChangeAndUseGameplayBindings.cs
index b7a74dcd27..5bd879de14 100644
--- a/osu.Game.Tests/Visual/Navigation/TestSceneChangeAndUseGameplayBindings.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneChangeAndUseGameplayBindings.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneEditDefaultSkin.cs b/osu.Game.Tests/Visual/Navigation/TestSceneEditDefaultSkin.cs
index 06306ad197..4ca55e8744 100644
--- a/osu.Game.Tests/Visual/Navigation/TestSceneEditDefaultSkin.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneEditDefaultSkin.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneFirstRunGame.cs b/osu.Game.Tests/Visual/Navigation/TestSceneFirstRunGame.cs
index 18c6e84950..f4078676c9 100644
--- a/osu.Game.Tests/Visual/Navigation/TestSceneFirstRunGame.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneFirstRunGame.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Platform;
diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneMouseWheelVolumeAdjust.cs b/osu.Game.Tests/Visual/Navigation/TestSceneMouseWheelVolumeAdjust.cs
index 2662b3930c..2592936ab6 100644
--- a/osu.Game.Tests/Visual/Navigation/TestSceneMouseWheelVolumeAdjust.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneMouseWheelVolumeAdjust.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Extensions;
 using osu.Game.Configuration;
diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneOsuGame.cs b/osu.Game.Tests/Visual/Navigation/TestSceneOsuGame.cs
index e4871f611e..cf62c73ad4 100644
--- a/osu.Game.Tests/Visual/Navigation/TestSceneOsuGame.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneOsuGame.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/Visual/Navigation/TestScenePerformFromScreen.cs b/osu.Game.Tests/Visual/Navigation/TestScenePerformFromScreen.cs
index 2ce914ba3d..d1b1ce5c4b 100644
--- a/osu.Game.Tests/Visual/Navigation/TestScenePerformFromScreen.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestScenePerformFromScreen.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Tests/Visual/Navigation/TestScenePresentBeatmap.cs b/osu.Game.Tests/Visual/Navigation/TestScenePresentBeatmap.cs
index 63226de750..6469962b08 100644
--- a/osu.Game.Tests/Visual/Navigation/TestScenePresentBeatmap.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestScenePresentBeatmap.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/Visual/Navigation/TestScenePresentScore.cs b/osu.Game.Tests/Visual/Navigation/TestScenePresentScore.cs
index 6c32171b29..5e76fe1519 100644
--- a/osu.Game.Tests/Visual/Navigation/TestScenePresentScore.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestScenePresentScore.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs b/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
index 51bb27f93e..a61352f954 100644
--- a/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneSkinEditorNavigation.cs b/osu.Game.Tests/Visual/Navigation/TestSceneSkinEditorNavigation.cs
index 68c44f49cc..78ab7947a7 100644
--- a/osu.Game.Tests/Visual/Navigation/TestSceneSkinEditorNavigation.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneSkinEditorNavigation.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Extensions;
diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneStartupBeatmapDisplay.cs b/osu.Game.Tests/Visual/Navigation/TestSceneStartupBeatmapDisplay.cs
index 961b7dedc3..bd3dcb8597 100644
--- a/osu.Game.Tests/Visual/Navigation/TestSceneStartupBeatmapDisplay.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneStartupBeatmapDisplay.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneStartupBeatmapSetDisplay.cs b/osu.Game.Tests/Visual/Navigation/TestSceneStartupBeatmapSetDisplay.cs
index 1aa56896d3..1072508e33 100644
--- a/osu.Game.Tests/Visual/Navigation/TestSceneStartupBeatmapSetDisplay.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneStartupBeatmapSetDisplay.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneStartupImport.cs b/osu.Game.Tests/Visual/Navigation/TestSceneStartupImport.cs
index bd723eeed6..cd53bf3af5 100644
--- a/osu.Game.Tests/Visual/Navigation/TestSceneStartupImport.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneStartupImport.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Testing;
diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneStartupRuleset.cs b/osu.Game.Tests/Visual/Navigation/TestSceneStartupRuleset.cs
index 85dd501fd3..1aadff7a20 100644
--- a/osu.Game.Tests/Visual/Navigation/TestSceneStartupRuleset.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneStartupRuleset.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Development;
 using osu.Game.Configuration;
diff --git a/osu.Game.Tests/Visual/Navigation/TestSettingsMigration.cs b/osu.Game.Tests/Visual/Navigation/TestSettingsMigration.cs
index 7e3d8290be..f5c7ee2f19 100644
--- a/osu.Game.Tests/Visual/Navigation/TestSettingsMigration.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestSettingsMigration.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Utils;
 using osu.Game.Configuration;
diff --git a/osu.Game.Tests/Visual/Online/TestSceneAccountCreationOverlay.cs b/osu.Game.Tests/Visual/Online/TestSceneAccountCreationOverlay.cs
index 8f0da8d182..b9d800e6fd 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneAccountCreationOverlay.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneAccountCreationOverlay.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Tests/Visual/Online/TestSceneBeatmapAvailability.cs b/osu.Game.Tests/Visual/Online/TestSceneBeatmapAvailability.cs
index f94ae24a14..c78a36d2bd 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneBeatmapAvailability.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneBeatmapAvailability.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Game.Beatmaps;
 using osu.Game.Online.API.Requests.Responses;
diff --git a/osu.Game.Tests/Visual/Online/TestSceneBeatmapDownloadButton.cs b/osu.Game.Tests/Visual/Online/TestSceneBeatmapDownloadButton.cs
index 8d8879490d..ba600332bb 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneBeatmapDownloadButton.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneBeatmapDownloadButton.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Tests/Visual/Online/TestSceneBeatmapListingOverlay.cs b/osu.Game.Tests/Visual/Online/TestSceneBeatmapListingOverlay.cs
index 5999125013..8ef120d252 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneBeatmapListingOverlay.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneBeatmapListingOverlay.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game.Tests/Visual/Online/TestSceneBeatmapRulesetSelector.cs b/osu.Game.Tests/Visual/Online/TestSceneBeatmapRulesetSelector.cs
index c550c9afda..b73028be5b 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneBeatmapRulesetSelector.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneBeatmapRulesetSelector.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlay.cs b/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlay.cs
index c933e1a54e..416e8aebcc 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlay.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlay.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Game.Beatmaps;
diff --git a/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlayDetails.cs b/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlayDetails.cs
index 629c413d85..31cebc2f0b 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlayDetails.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlayDetails.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlaySuccessRate.cs b/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlaySuccessRate.cs
index 82b34c50c2..26e1e49ca3 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlaySuccessRate.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneBeatmapSetOverlaySuccessRate.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Tests/Visual/Online/TestSceneBundledBeatmapDownloader.cs b/osu.Game.Tests/Visual/Online/TestSceneBundledBeatmapDownloader.cs
index 2af1c9a0f0..08c6914f83 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneBundledBeatmapDownloader.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneBundledBeatmapDownloader.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Game.Beatmaps.Drawables;
 
diff --git a/osu.Game.Tests/Visual/Online/TestSceneChangelogOverlay.cs b/osu.Game.Tests/Visual/Online/TestSceneChangelogOverlay.cs
index 8f000afb91..4c39dc34d5 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneChangelogOverlay.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneChangelogOverlay.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game.Tests/Visual/Online/TestSceneChangelogSupporterPromo.cs b/osu.Game.Tests/Visual/Online/TestSceneChangelogSupporterPromo.cs
index 22220a7d9c..018d40d1bc 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneChangelogSupporterPromo.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneChangelogSupporterPromo.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game.Tests/Visual/Online/TestSceneChannelList.cs b/osu.Game.Tests/Visual/Online/TestSceneChannelList.cs
index 39a4f1a8a1..8e17c490b1 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneChannelList.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneChannelList.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game.Tests/Visual/Online/TestSceneChannelListing.cs b/osu.Game.Tests/Visual/Online/TestSceneChannelListing.cs
index e521db1c9d..214c05e64d 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneChannelListing.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneChannelListing.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/Visual/Online/TestSceneChatLineTruncation.cs b/osu.Game.Tests/Visual/Online/TestSceneChatLineTruncation.cs
index 444bd7e5fb..79dc17cfa6 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneChatLineTruncation.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneChatLineTruncation.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.
 
+#nullable disable
+
 using System;
 using NUnit.Framework;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Tests/Visual/Online/TestSceneChatLink.cs b/osu.Game.Tests/Visual/Online/TestSceneChatLink.cs
index 4d227af2cb..a537f0660c 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneChatLink.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneChatLink.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/Visual/Online/TestSceneChatOverlay.cs b/osu.Game.Tests/Visual/Online/TestSceneChatOverlay.cs
index e3792c0780..1fb0195368 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneChatOverlay.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneChatOverlay.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using System.Collections.Generic;
diff --git a/osu.Game.Tests/Visual/Online/TestSceneChatTextBox.cs b/osu.Game.Tests/Visual/Online/TestSceneChatTextBox.cs
index a241aa0517..5d28d553a0 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneChatTextBox.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneChatTextBox.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game.Tests/Visual/Online/TestSceneCommentsContainer.cs b/osu.Game.Tests/Visual/Online/TestSceneCommentsContainer.cs
index 31e5a9b86c..a94b9e61c0 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneCommentsContainer.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneCommentsContainer.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game.Tests/Visual/Online/TestSceneCommentsHeader.cs b/osu.Game.Tests/Visual/Online/TestSceneCommentsHeader.cs
index 03eac5d85b..95b718041e 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneCommentsHeader.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneCommentsHeader.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game.Tests/Visual/Online/TestSceneCurrentlyPlayingDisplay.cs b/osu.Game.Tests/Visual/Online/TestSceneCurrentlyPlayingDisplay.cs
index edee26c081..62f8f72929 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneCurrentlyPlayingDisplay.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneCurrentlyPlayingDisplay.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using System.Threading;
diff --git a/osu.Game.Tests/Visual/Online/TestSceneDashboardOverlay.cs b/osu.Game.Tests/Visual/Online/TestSceneDashboardOverlay.cs
index 960d3fa248..074fea0604 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneDashboardOverlay.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneDashboardOverlay.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Game.Overlays;
 
diff --git a/osu.Game.Tests/Visual/Online/TestSceneDrawableComment.cs b/osu.Game.Tests/Visual/Online/TestSceneDrawableComment.cs
index b26850feb2..cab0ffa3ba 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneDrawableComment.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneDrawableComment.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.
 
+#nullable disable
+
 using System;
 using NUnit.Framework;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Tests/Visual/Online/TestSceneExternalLinkButton.cs b/osu.Game.Tests/Visual/Online/TestSceneExternalLinkButton.cs
index 31bb276cd4..fdcde0f2a5 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneExternalLinkButton.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneExternalLinkButton.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.
 
+#nullable disable
+
 using osu.Game.Graphics.UserInterface;
 using osuTK;
 
diff --git a/osu.Game.Tests/Visual/Online/TestSceneFavouriteButton.cs b/osu.Game.Tests/Visual/Online/TestSceneFavouriteButton.cs
index 87458da578..3206640f9a 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneFavouriteButton.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneFavouriteButton.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Graphics;
 using osu.Framework.Testing;
diff --git a/osu.Game.Tests/Visual/Online/TestSceneFriendDisplay.cs b/osu.Game.Tests/Visual/Online/TestSceneFriendDisplay.cs
index 471d361c4e..c5c61cdd72 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneFriendDisplay.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneFriendDisplay.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/Visual/Online/TestSceneFullscreenOverlay.cs b/osu.Game.Tests/Visual/Online/TestSceneFullscreenOverlay.cs
index dc468bb62d..b7e918207f 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneFullscreenOverlay.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneFullscreenOverlay.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Shapes;
diff --git a/osu.Game.Tests/Visual/Online/TestSceneGraph.cs b/osu.Game.Tests/Visual/Online/TestSceneGraph.cs
index fa433571cf..2f3331b141 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneGraph.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneGraph.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tests/Visual/Online/TestSceneHistoricalSection.cs b/osu.Game.Tests/Visual/Online/TestSceneHistoricalSection.cs
index 2639a6506c..afc20dedff 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneHistoricalSection.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneHistoricalSection.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tests/Visual/Online/TestSceneHomeNewsPanel.cs b/osu.Game.Tests/Visual/Online/TestSceneHomeNewsPanel.cs
index a1251ca793..181b086b00 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneHomeNewsPanel.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneHomeNewsPanel.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.
 
+#nullable disable
+
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics;
 using osu.Game.Online.API.Requests.Responses;
diff --git a/osu.Game.Tests/Visual/Online/TestSceneKudosuHistory.cs b/osu.Game.Tests/Visual/Online/TestSceneKudosuHistory.cs
index 8bf2ef34f2..7f0a00c474 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneKudosuHistory.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneKudosuHistory.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.
 
+#nullable disable
+
 using osu.Game.Overlays.Profile.Sections.Kudosu;
 using System.Collections.Generic;
 using System;
diff --git a/osu.Game.Tests/Visual/Online/TestSceneLeaderboardModSelector.cs b/osu.Game.Tests/Visual/Online/TestSceneLeaderboardModSelector.cs
index aa442ded02..8ab8276b9c 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneLeaderboardModSelector.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneLeaderboardModSelector.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.
 
+#nullable disable
+
 using osu.Game.Overlays.BeatmapSet;
 using System.Collections.Specialized;
 using System.Linq;
diff --git a/osu.Game.Tests/Visual/Online/TestSceneLeaderboardScopeSelector.cs b/osu.Game.Tests/Visual/Online/TestSceneLeaderboardScopeSelector.cs
index afa559280c..8c38027df3 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneLeaderboardScopeSelector.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneLeaderboardScopeSelector.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.
 
+#nullable disable
+
 using osu.Game.Overlays.BeatmapSet;
 using osu.Framework.Graphics;
 using osu.Framework.Bindables;
diff --git a/osu.Game.Tests/Visual/Online/TestSceneMessageNotifier.cs b/osu.Game.Tests/Visual/Online/TestSceneMessageNotifier.cs
index c7ca3b4457..57514cdf37 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneMessageNotifier.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneMessageNotifier.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Diagnostics;
 using System.Linq;
diff --git a/osu.Game.Tests/Visual/Online/TestSceneNewsCard.cs b/osu.Game.Tests/Visual/Online/TestSceneNewsCard.cs
index 17675bfbc0..8d73165d99 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneNewsCard.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneNewsCard.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.
 
+#nullable disable
+
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics;
 using osu.Game.Overlays.News;
diff --git a/osu.Game.Tests/Visual/Online/TestSceneNewsHeader.cs b/osu.Game.Tests/Visual/Online/TestSceneNewsHeader.cs
index 994c4fce53..cad045623b 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneNewsHeader.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneNewsHeader.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Game.Overlays.News;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tests/Visual/Online/TestSceneNewsOverlay.cs b/osu.Game.Tests/Visual/Online/TestSceneNewsOverlay.cs
index f94c018b27..3e5dd91b2c 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneNewsOverlay.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneNewsOverlay.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/Visual/Online/TestSceneNewsSidebar.cs b/osu.Game.Tests/Visual/Online/TestSceneNewsSidebar.cs
index 382d76676a..f28eaf5ad0 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneNewsSidebar.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneNewsSidebar.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game.Tests/Visual/Online/TestSceneNowPlayingCommand.cs b/osu.Game.Tests/Visual/Online/TestSceneNowPlayingCommand.cs
index b689b85490..2df9089a8a 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneNowPlayingCommand.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneNowPlayingCommand.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tests/Visual/Online/TestSceneOfflineCommentsContainer.cs b/osu.Game.Tests/Visual/Online/TestSceneOfflineCommentsContainer.cs
index 0587e8884f..07ccfcec88 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneOfflineCommentsContainer.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneOfflineCommentsContainer.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game.Tests/Visual/Online/TestSceneOnlineBeatmapListingOverlay.cs b/osu.Game.Tests/Visual/Online/TestSceneOnlineBeatmapListingOverlay.cs
index fe1701a554..388c0a9d60 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneOnlineBeatmapListingOverlay.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneOnlineBeatmapListingOverlay.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.
 
+#nullable disable
+
 using osu.Game.Overlays;
 using NUnit.Framework;
 
diff --git a/osu.Game.Tests/Visual/Online/TestSceneOnlineBeatmapSetOverlay.cs b/osu.Game.Tests/Visual/Online/TestSceneOnlineBeatmapSetOverlay.cs
index 4e88570ca0..0d9c47db7b 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneOnlineBeatmapSetOverlay.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneOnlineBeatmapSetOverlay.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Game.Overlays;
 
diff --git a/osu.Game.Tests/Visual/Online/TestSceneOnlineViewContainer.cs b/osu.Game.Tests/Visual/Online/TestSceneOnlineViewContainer.cs
index ec183adbbc..b4bac5ee7e 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneOnlineViewContainer.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneOnlineViewContainer.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tests/Visual/Online/TestScenePlayHistorySubsection.cs b/osu.Game.Tests/Visual/Online/TestScenePlayHistorySubsection.cs
index a96fde6c20..118da682a7 100644
--- a/osu.Game.Tests/Visual/Online/TestScenePlayHistorySubsection.cs
+++ b/osu.Game.Tests/Visual/Online/TestScenePlayHistorySubsection.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.
 
+#nullable disable
+
 using osu.Game.Overlays.Profile.Sections.Historical;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tests/Visual/Online/TestSceneProfileRulesetSelector.cs b/osu.Game.Tests/Visual/Online/TestSceneProfileRulesetSelector.cs
index ae90872439..3068ba0185 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneProfileRulesetSelector.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneProfileRulesetSelector.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Game.Overlays.Profile.Header.Components;
 using osu.Game.Rulesets.Catch;
diff --git a/osu.Game.Tests/Visual/Online/TestSceneRankGraph.cs b/osu.Game.Tests/Visual/Online/TestSceneRankGraph.cs
index 61574a7f23..1b1a5c7c6a 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneRankGraph.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneRankGraph.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tests/Visual/Online/TestSceneRankingsCountryFilter.cs b/osu.Game.Tests/Visual/Online/TestSceneRankingsCountryFilter.cs
index 458ba80712..e7d799222a 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneRankingsCountryFilter.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneRankingsCountryFilter.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.
 
+#nullable disable
+
 using osu.Framework.Bindables;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Overlays.Rankings;
diff --git a/osu.Game.Tests/Visual/Online/TestSceneRankingsHeader.cs b/osu.Game.Tests/Visual/Online/TestSceneRankingsHeader.cs
index 677952681c..c8f08d70be 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneRankingsHeader.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneRankingsHeader.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Game.Overlays;
diff --git a/osu.Game.Tests/Visual/Online/TestSceneRankingsOverlay.cs b/osu.Game.Tests/Visual/Online/TestSceneRankingsOverlay.cs
index 027f17fff4..62dad7b458 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneRankingsOverlay.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneRankingsOverlay.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game.Tests/Visual/Online/TestSceneRankingsSpotlightSelector.cs b/osu.Game.Tests/Visual/Online/TestSceneRankingsSpotlightSelector.cs
index d60222fa0b..5aafcf3f6b 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneRankingsSpotlightSelector.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneRankingsSpotlightSelector.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/Visual/Online/TestSceneRankingsTables.cs b/osu.Game.Tests/Visual/Online/TestSceneRankingsTables.cs
index 35e219f839..e357b0fffc 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneRankingsTables.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneRankingsTables.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Overlays.Rankings.Tables;
diff --git a/osu.Game.Tests/Visual/Online/TestSceneScoreboardTime.cs b/osu.Game.Tests/Visual/Online/TestSceneScoreboardTime.cs
index 7e33b5240c..8f03f240f7 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneScoreboardTime.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneScoreboardTime.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game.Tests/Visual/Online/TestSceneScoresContainer.cs b/osu.Game.Tests/Visual/Online/TestSceneScoresContainer.cs
index 8a304110dd..16a34e996f 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneScoresContainer.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneScoresContainer.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game.Tests/Visual/Online/TestSceneShowMoreButton.cs b/osu.Game.Tests/Visual/Online/TestSceneShowMoreButton.cs
index d7fa5a1f6d..32262c18a8 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneShowMoreButton.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneShowMoreButton.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Game.Graphics.UserInterface;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Tests/Visual/Online/TestSceneSpotlightsLayout.cs b/osu.Game.Tests/Visual/Online/TestSceneSpotlightsLayout.cs
index 266dcb013b..d7feade128 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneSpotlightsLayout.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneSpotlightsLayout.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tests/Visual/Online/TestSceneStandAloneChatDisplay.cs b/osu.Game.Tests/Visual/Online/TestSceneStandAloneChatDisplay.cs
index 8d5eebd31f..292facab11 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneStandAloneChatDisplay.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneStandAloneChatDisplay.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Game.Online.Chat;
diff --git a/osu.Game.Tests/Visual/Online/TestSceneTotalCommentsCounter.cs b/osu.Game.Tests/Visual/Online/TestSceneTotalCommentsCounter.cs
index f168ae5035..d4355d2f11 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneTotalCommentsCounter.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneTotalCommentsCounter.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Bindables;
 using osu.Game.Overlays.Comments;
diff --git a/osu.Game.Tests/Visual/Online/TestSceneUserHistoryGraph.cs b/osu.Game.Tests/Visual/Online/TestSceneUserHistoryGraph.cs
index 3f4a5cd420..42a8462604 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneUserHistoryGraph.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneUserHistoryGraph.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tests/Visual/Online/TestSceneUserPanel.cs b/osu.Game.Tests/Visual/Online/TestSceneUserPanel.cs
index 6c3678b0d2..fff40b3c74 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneUserPanel.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneUserPanel.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.
 
+#nullable disable
+
 using System;
 using NUnit.Framework;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Tests/Visual/Online/TestSceneUserProfileHeader.cs b/osu.Game.Tests/Visual/Online/TestSceneUserProfileHeader.cs
index dda9543159..1abe06ed76 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneUserProfileHeader.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneUserProfileHeader.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/Visual/Online/TestSceneUserProfileOverlay.cs b/osu.Game.Tests/Visual/Online/TestSceneUserProfileOverlay.cs
index 78e2ceb45b..ad3215b1ef 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneUserProfileOverlay.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneUserProfileOverlay.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/Visual/Online/TestSceneUserProfilePreviousUsernames.cs b/osu.Game.Tests/Visual/Online/TestSceneUserProfilePreviousUsernames.cs
index 30774689a2..4260fff02d 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneUserProfilePreviousUsernames.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneUserProfilePreviousUsernames.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.
 
+#nullable disable
+
 using System;
 using NUnit.Framework;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tests/Visual/Online/TestSceneUserProfileRecentSection.cs b/osu.Game.Tests/Visual/Online/TestSceneUserProfileRecentSection.cs
index 0973076c40..163f0e62df 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneUserProfileRecentSection.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneUserProfileRecentSection.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/Visual/Online/TestSceneUserProfileScores.cs b/osu.Game.Tests/Visual/Online/TestSceneUserProfileScores.cs
index 7dfdca8276..fa28df3061 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneUserProfileScores.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneUserProfileScores.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tests/Visual/Online/TestSceneUserRanks.cs b/osu.Game.Tests/Visual/Online/TestSceneUserRanks.cs
index b9272e7294..d517aaa105 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneUserRanks.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneUserRanks.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tests/Visual/Online/TestSceneUserRequest.cs b/osu.Game.Tests/Visual/Online/TestSceneUserRequest.cs
index e7b6a94642..32d427ba6d 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneUserRequest.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneUserRequest.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game.Tests/Visual/Online/TestSceneVotePill.cs b/osu.Game.Tests/Visual/Online/TestSceneVotePill.cs
index a9fed7b302..fdc15af73d 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneVotePill.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneVotePill.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Graphics;
 using osu.Game.Overlays.Comments;
diff --git a/osu.Game.Tests/Visual/Online/TestSceneWikiHeader.cs b/osu.Game.Tests/Visual/Online/TestSceneWikiHeader.cs
index 27e989df76..99e301f3ba 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneWikiHeader.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneWikiHeader.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/Visual/Online/TestSceneWikiMainPage.cs b/osu.Game.Tests/Visual/Online/TestSceneWikiMainPage.cs
index 3a2bafb128..03b94aded7 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneWikiMainPage.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneWikiMainPage.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game.Tests/Visual/Online/TestSceneWikiMarkdownContainer.cs b/osu.Game.Tests/Visual/Online/TestSceneWikiMarkdownContainer.cs
index af2e4fc91a..39432ee059 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneWikiMarkdownContainer.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneWikiMarkdownContainer.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using Markdig.Syntax.Inlines;
diff --git a/osu.Game.Tests/Visual/Online/TestSceneWikiOverlay.cs b/osu.Game.Tests/Visual/Online/TestSceneWikiOverlay.cs
index 3506d459ce..8889cb3e37 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneWikiOverlay.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneWikiOverlay.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.
 
+#nullable disable
+
 using System.Net;
 using NUnit.Framework;
 using osu.Game.Online.API;
diff --git a/osu.Game.Tests/Visual/Online/TestSceneWikiSidebar.cs b/osu.Game.Tests/Visual/Online/TestSceneWikiSidebar.cs
index 862b3667b1..33e3ee7023 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneWikiSidebar.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneWikiSidebar.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.
 
+#nullable disable
+
 using Markdig.Parsers;
 using Markdig.Syntax;
 using Markdig.Syntax.Inlines;
diff --git a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsLoungeSubScreen.cs b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsLoungeSubScreen.cs
index 9ba0da1911..8ca37a241b 100644
--- a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsLoungeSubScreen.cs
+++ b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsLoungeSubScreen.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Bindables;
diff --git a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsMatchSettingsOverlay.cs b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsMatchSettingsOverlay.cs
index 666e32d1d0..e6882081dd 100644
--- a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsMatchSettingsOverlay.cs
+++ b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsMatchSettingsOverlay.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.
 
+#nullable disable
+
 using System;
 using NUnit.Framework;
 using osu.Framework.Bindables;
diff --git a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsParticipantsList.cs b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsParticipantsList.cs
index 1288b9e765..5961ed74ad 100644
--- a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsParticipantsList.cs
+++ b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsParticipantsList.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Graphics;
 using osu.Game.Online.API.Requests.Responses;
diff --git a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsResultsScreen.cs b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsResultsScreen.cs
index c532e8bc05..a46e675370 100644
--- a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsResultsScreen.cs
+++ b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsResultsScreen.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs
index 14f8c1d6d4..c0cd2d9157 100644
--- a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.cs
+++ b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsRoomCreation.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.
 
+#nullable disable
+
 using System;
 using System.Diagnostics;
 using System.Linq;
diff --git a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsScreen.cs b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsScreen.cs
index 63bd7c8068..af3d2d9d9a 100644
--- a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsScreen.cs
+++ b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsScreen.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.
 
+#nullable disable
+
 using NUnit.Framework;
 
 namespace osu.Game.Tests.Visual.Playlists
diff --git a/osu.Game.Tests/Visual/Ranking/TestSceneAccuracyCircle.cs b/osu.Game.Tests/Visual/Ranking/TestSceneAccuracyCircle.cs
index ac736086fd..3e2043cea5 100644
--- a/osu.Game.Tests/Visual/Ranking/TestSceneAccuracyCircle.cs
+++ b/osu.Game.Tests/Visual/Ranking/TestSceneAccuracyCircle.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.
 
+#nullable disable
+
 using System;
 using NUnit.Framework;
 using osu.Framework.Extensions.Color4Extensions;
diff --git a/osu.Game.Tests/Visual/Ranking/TestSceneContractedPanelMiddleContent.cs b/osu.Game.Tests/Visual/Ranking/TestSceneContractedPanelMiddleContent.cs
index 85306b9354..83242fe363 100644
--- a/osu.Game.Tests/Visual/Ranking/TestSceneContractedPanelMiddleContent.cs
+++ b/osu.Game.Tests/Visual/Ranking/TestSceneContractedPanelMiddleContent.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Tests/Visual/Ranking/TestSceneExpandedPanelMiddleContent.cs b/osu.Game.Tests/Visual/Ranking/TestSceneExpandedPanelMiddleContent.cs
index 2a31728f87..62e9adcf25 100644
--- a/osu.Game.Tests/Visual/Ranking/TestSceneExpandedPanelMiddleContent.cs
+++ b/osu.Game.Tests/Visual/Ranking/TestSceneExpandedPanelMiddleContent.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.
 
+#nullable disable
+
 using System.Linq;
 using JetBrains.Annotations;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/Visual/Ranking/TestSceneExpandedPanelTopContent.cs b/osu.Game.Tests/Visual/Ranking/TestSceneExpandedPanelTopContent.cs
index a2fa142896..94f6fa8839 100644
--- a/osu.Game.Tests/Visual/Ranking/TestSceneExpandedPanelTopContent.cs
+++ b/osu.Game.Tests/Visual/Ranking/TestSceneExpandedPanelTopContent.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.
 
+#nullable disable
+
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game.Tests/Visual/Ranking/TestSceneHitEventTimingDistributionGraph.cs b/osu.Game.Tests/Visual/Ranking/TestSceneHitEventTimingDistributionGraph.cs
index 7471b6acf2..44cb438a6b 100644
--- a/osu.Game.Tests/Visual/Ranking/TestSceneHitEventTimingDistributionGraph.cs
+++ b/osu.Game.Tests/Visual/Ranking/TestSceneHitEventTimingDistributionGraph.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game.Tests/Visual/Ranking/TestSceneResultsScreen.cs b/osu.Game.Tests/Visual/Ranking/TestSceneResultsScreen.cs
index 2a5fc050d3..89d6206fd7 100644
--- a/osu.Game.Tests/Visual/Ranking/TestSceneResultsScreen.cs
+++ b/osu.Game.Tests/Visual/Ranking/TestSceneResultsScreen.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game.Tests/Visual/Ranking/TestSceneScorePanel.cs b/osu.Game.Tests/Visual/Ranking/TestSceneScorePanel.cs
index 5dbeefd390..77fcd04fbd 100644
--- a/osu.Game.Tests/Visual/Ranking/TestSceneScorePanel.cs
+++ b/osu.Game.Tests/Visual/Ranking/TestSceneScorePanel.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Graphics;
 using osu.Game.Rulesets.Scoring;
diff --git a/osu.Game.Tests/Visual/Ranking/TestSceneScorePanelList.cs b/osu.Game.Tests/Visual/Ranking/TestSceneScorePanelList.cs
index c65587d433..871224f3e4 100644
--- a/osu.Game.Tests/Visual/Ranking/TestSceneScorePanelList.cs
+++ b/osu.Game.Tests/Visual/Ranking/TestSceneScorePanelList.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game.Tests/Visual/Ranking/TestSceneSimpleStatisticTable.cs b/osu.Game.Tests/Visual/Ranking/TestSceneSimpleStatisticTable.cs
index 07a0bcc8d8..57a3907b6e 100644
--- a/osu.Game.Tests/Visual/Ranking/TestSceneSimpleStatisticTable.cs
+++ b/osu.Game.Tests/Visual/Ranking/TestSceneSimpleStatisticTable.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.
 
+#nullable disable
+
 using System.Linq;
 using Humanizer;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/Visual/Ranking/TestSceneStatisticsPanel.cs b/osu.Game.Tests/Visual/Ranking/TestSceneStatisticsPanel.cs
index 1efe6d7380..8214c52edc 100644
--- a/osu.Game.Tests/Visual/Ranking/TestSceneStatisticsPanel.cs
+++ b/osu.Game.Tests/Visual/Ranking/TestSceneStatisticsPanel.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Threading;
diff --git a/osu.Game.Tests/Visual/Settings/TestSceneDirectorySelector.cs b/osu.Game.Tests/Visual/Settings/TestSceneDirectorySelector.cs
index 227bce0c60..4f05194e08 100644
--- a/osu.Game.Tests/Visual/Settings/TestSceneDirectorySelector.cs
+++ b/osu.Game.Tests/Visual/Settings/TestSceneDirectorySelector.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Game.Graphics.UserInterfaceV2;
diff --git a/osu.Game.Tests/Visual/Settings/TestSceneFileSelector.cs b/osu.Game.Tests/Visual/Settings/TestSceneFileSelector.cs
index 84a0fc6e4c..6f25012bfa 100644
--- a/osu.Game.Tests/Visual/Settings/TestSceneFileSelector.cs
+++ b/osu.Game.Tests/Visual/Settings/TestSceneFileSelector.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Graphics;
 using osu.Game.Graphics.UserInterfaceV2;
diff --git a/osu.Game.Tests/Visual/Settings/TestSceneKeyBindingPanel.cs b/osu.Game.Tests/Visual/Settings/TestSceneKeyBindingPanel.cs
index 1effe52608..d7d073e908 100644
--- a/osu.Game.Tests/Visual/Settings/TestSceneKeyBindingPanel.cs
+++ b/osu.Game.Tests/Visual/Settings/TestSceneKeyBindingPanel.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.
 
+#nullable disable
+
 using System.Diagnostics;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/Visual/Settings/TestSceneLatencyCertifierScreen.cs b/osu.Game.Tests/Visual/Settings/TestSceneLatencyCertifierScreen.cs
index fe14935479..caffc54d47 100644
--- a/osu.Game.Tests/Visual/Settings/TestSceneLatencyCertifierScreen.cs
+++ b/osu.Game.Tests/Visual/Settings/TestSceneLatencyCertifierScreen.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 enable
-
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Testing;
diff --git a/osu.Game.Tests/Visual/Settings/TestSceneMigrationScreens.cs b/osu.Game.Tests/Visual/Settings/TestSceneMigrationScreens.cs
index ac0956502e..e32757c6f6 100644
--- a/osu.Game.Tests/Visual/Settings/TestSceneMigrationScreens.cs
+++ b/osu.Game.Tests/Visual/Settings/TestSceneMigrationScreens.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.
 
+#nullable disable
+
 using System.IO;
 using System.Threading;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/Visual/Settings/TestSceneRestoreDefaultValueButton.cs b/osu.Game.Tests/Visual/Settings/TestSceneRestoreDefaultValueButton.cs
index 0c46fa439a..289969af3e 100644
--- a/osu.Game.Tests/Visual/Settings/TestSceneRestoreDefaultValueButton.cs
+++ b/osu.Game.Tests/Visual/Settings/TestSceneRestoreDefaultValueButton.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game.Tests/Visual/Settings/TestSceneSettingsItem.cs b/osu.Game.Tests/Visual/Settings/TestSceneSettingsItem.cs
index 3e679a7905..b3d1966511 100644
--- a/osu.Game.Tests/Visual/Settings/TestSceneSettingsItem.cs
+++ b/osu.Game.Tests/Visual/Settings/TestSceneSettingsItem.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Bindables;
diff --git a/osu.Game.Tests/Visual/Settings/TestSceneSettingsNumberBox.cs b/osu.Game.Tests/Visual/Settings/TestSceneSettingsNumberBox.cs
index 334a814688..53e1f0e0bf 100644
--- a/osu.Game.Tests/Visual/Settings/TestSceneSettingsNumberBox.cs
+++ b/osu.Game.Tests/Visual/Settings/TestSceneSettingsNumberBox.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Testing;
diff --git a/osu.Game.Tests/Visual/Settings/TestSceneSettingsPanel.cs b/osu.Game.Tests/Visual/Settings/TestSceneSettingsPanel.cs
index 97463b7466..abf65602f9 100644
--- a/osu.Game.Tests/Visual/Settings/TestSceneSettingsPanel.cs
+++ b/osu.Game.Tests/Visual/Settings/TestSceneSettingsPanel.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Tests/Visual/Settings/TestSceneSettingsSource.cs b/osu.Game.Tests/Visual/Settings/TestSceneSettingsSource.cs
index ffaa038930..98de712703 100644
--- a/osu.Game.Tests/Visual/Settings/TestSceneSettingsSource.cs
+++ b/osu.Game.Tests/Visual/Settings/TestSceneSettingsSource.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tests/Visual/Settings/TestSceneTabletSettings.cs b/osu.Game.Tests/Visual/Settings/TestSceneTabletSettings.cs
index dc5b0e0d77..d1d3748c26 100644
--- a/osu.Game.Tests/Visual/Settings/TestSceneTabletSettings.cs
+++ b/osu.Game.Tests/Visual/Settings/TestSceneTabletSettings.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneAdvancedStats.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneAdvancedStats.cs
index 8af70df48a..77670c38f3 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneAdvancedStats.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneAdvancedStats.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs
index 540b820250..66b9fa990a 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapDetails.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapDetails.cs
index bd15c40271..e33cfe280e 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapDetails.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapDetails.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapInfoWedge.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapInfoWedge.cs
index ef04baefa2..6490fd822e 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapInfoWedge.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapInfoWedge.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using JetBrains.Annotations;
diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
index 3b15ee9c45..1b9b59676b 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapLeaderboard.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapMetadataDisplay.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapMetadataDisplay.cs
index fb6d9a0b4b..27b485156c 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapMetadataDisplay.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapMetadataDisplay.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapOptionsOverlay.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapOptionsOverlay.cs
index e9742acdde..5ad82f1ffd 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapOptionsOverlay.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapOptionsOverlay.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.
 
+#nullable disable
+
 using System.ComponentModel;
 using osu.Framework.Graphics.Sprites;
 using osu.Game.Graphics;
diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapRecommendations.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapRecommendations.cs
index a78a8aa028..117515977e 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapRecommendations.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapRecommendations.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneFilterControl.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneFilterControl.cs
index b42ce3ff87..6807180640 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneFilterControl.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneFilterControl.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
index 77f5bd83d6..9fcd470d17 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneSongSelectFooter.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneSongSelectFooter.cs
index f27615eea5..cb78fbfe35 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneSongSelectFooter.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneSongSelectFooter.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Graphics;
 using osu.Game.Screens.Select;
diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneTopLocalRank.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneTopLocalRank.cs
index 7bef7c8fce..8f890b2383 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneTopLocalRank.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneTopLocalRank.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneUserTopScoreContainer.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneUserTopScoreContainer.cs
index c71e54e9a8..16966e489a 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneUserTopScoreContainer.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneUserTopScoreContainer.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game.Tests/Visual/TestMultiplayerComponents.cs b/osu.Game.Tests/Visual/TestMultiplayerComponents.cs
index 4ab201ef46..0458f41358 100644
--- a/osu.Game.Tests/Visual/TestMultiplayerComponents.cs
+++ b/osu.Game.Tests/Visual/TestMultiplayerComponents.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Screens;
diff --git a/osu.Game.Tests/Visual/TestSceneOsuScreenStack.cs b/osu.Game.Tests/Visual/TestSceneOsuScreenStack.cs
index 7729ad0ff3..7588546f42 100644
--- a/osu.Game.Tests/Visual/TestSceneOsuScreenStack.cs
+++ b/osu.Game.Tests/Visual/TestSceneOsuScreenStack.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneBackButton.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneBackButton.cs
index 2440911c11..9b84cf2a9e 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneBackButton.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneBackButton.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneBeatSyncedContainer.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneBeatSyncedContainer.cs
index 3cbb7daf51..27c107a2db 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneBeatSyncedContainer.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneBeatSyncedContainer.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Diagnostics;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneBeatmapListingCardSizeTabControl.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneBeatmapListingCardSizeTabControl.cs
index e3d47f08c6..bc846d8bcb 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneBeatmapListingCardSizeTabControl.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneBeatmapListingCardSizeTabControl.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneBeatmapListingSearchControl.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneBeatmapListingSearchControl.cs
index f17de75f5c..1107fad834 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneBeatmapListingSearchControl.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneBeatmapListingSearchControl.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.
 
+#nullable disable
+
 using System.Linq;
 using Humanizer;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneBeatmapListingSortTabControl.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneBeatmapListingSortTabControl.cs
index 5364f0bef5..3247461fba 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneBeatmapListingSortTabControl.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneBeatmapListingSortTabControl.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneBeatmapSearchFilter.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneBeatmapSearchFilter.cs
index 37b7b64615..ff1dce1a4e 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneBeatmapSearchFilter.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneBeatmapSearchFilter.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneBreadcrumbControl.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneBreadcrumbControl.cs
index 3967b62c95..a387148c2c 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneBreadcrumbControl.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneBreadcrumbControl.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneBreadcrumbControlHeader.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneBreadcrumbControlHeader.cs
index 7bc75f1c44..8e2502dad1 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneBreadcrumbControlHeader.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneBreadcrumbControlHeader.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneButtonSystem.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneButtonSystem.cs
index 1a879e2e70..cbd4c69180 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneButtonSystem.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneButtonSystem.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneColourPicker.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneColourPicker.cs
index fa9179443d..eba0e8cfed 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneColourPicker.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneColourPicker.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneCommentEditor.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneCommentEditor.cs
index 920b437f57..fd4ec2f3dc 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneCommentEditor.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneCommentEditor.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneCommentRepliesButton.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneCommentRepliesButton.cs
index c2ac5179c9..115833b034 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneCommentRepliesButton.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneCommentRepliesButton.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.
 
+#nullable disable
+
 using osu.Game.Overlays.Comments.Buttons;
 using osu.Framework.Graphics;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneContextMenu.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneContextMenu.cs
index 3b43f8485a..bd77c4725c 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneContextMenu.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneContextMenu.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneCursors.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneCursors.cs
index 5b74852259..0fa7c5303c 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneCursors.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneCursors.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Extensions.IEnumerableExtensions;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneDashboardBeatmapListing.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneDashboardBeatmapListing.cs
index 17ac812eb0..2b6a93143f 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneDashboardBeatmapListing.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneDashboardBeatmapListing.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.
 
+#nullable disable
+
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics;
 using osu.Game.Overlays.Dashboard.Home;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
index 1350052ae6..31406af87a 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneDialogOverlay.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneDialogOverlay.cs
index 54cdeaf956..a8e6142bab 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneDialogOverlay.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneDialogOverlay.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.
 
+#nullable disable
+
 using System;
 using System.Threading;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneDifficultyMultiplierDisplay.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneDifficultyMultiplierDisplay.cs
index cd84f8b380..984276b27e 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneDifficultyMultiplierDisplay.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneDifficultyMultiplierDisplay.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneDrawableDate.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneDrawableDate.cs
index 19097f33bb..59e85ae085 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneDrawableDate.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneDrawableDate.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneEditorSidebar.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneEditorSidebar.cs
index f2f475e063..ee07acef52 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneEditorSidebar.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneEditorSidebar.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneExpandingBar.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneExpandingBar.cs
index f92aae43d2..2d97513206 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneExpandingBar.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneExpandingBar.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneExpandingContainer.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneExpandingContainer.cs
index 2bb6e58448..704185b117 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneExpandingContainer.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneExpandingContainer.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunScreenBehaviour.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunScreenBehaviour.cs
index 9747b5cc53..8fa4f7ec0e 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunScreenBehaviour.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunScreenBehaviour.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Screens;
 using osu.Game.Overlays;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunScreenBundledBeatmaps.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunScreenBundledBeatmaps.cs
index 51065939f0..6cc4ac709b 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunScreenBundledBeatmaps.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunScreenBundledBeatmaps.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Screens;
 using osu.Game.Overlays;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunScreenImportFromStable.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunScreenImportFromStable.cs
index 081b240795..3c3d5933e4 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunScreenImportFromStable.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunScreenImportFromStable.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.
 
+#nullable disable
+
 using System.Threading;
 using System.Threading.Tasks;
 using Moq;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunScreenUIScale.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunScreenUIScale.cs
index 64ad4ff119..98ad77fbae 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunScreenUIScale.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunScreenUIScale.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Screens;
 using osu.Game.Overlays;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunSetupOverlay.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunSetupOverlay.cs
index d09efdc925..a3ae55670a 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunSetupOverlay.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneFirstRunSetupOverlay.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneFooterButtonMods.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneFooterButtonMods.cs
index 0631059d1a..a4b5faae26 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneFooterButtonMods.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneFooterButtonMods.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneFriendsOnlineStatusControl.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneFriendsOnlineStatusControl.cs
index ea3cfbd497..ad5e498c8b 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneFriendsOnlineStatusControl.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneFriendsOnlineStatusControl.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneHoldToConfirmOverlay.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneHoldToConfirmOverlay.cs
index cea91d422e..235dbc1fcb 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneHoldToConfirmOverlay.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneHoldToConfirmOverlay.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneIconButton.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneIconButton.cs
index c80b3e6297..35d250c7ac 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneIconButton.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneIconButton.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneLabelledColourPalette.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneLabelledColourPalette.cs
index e1ea02ba67..d7a69616f3 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneLabelledColourPalette.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneLabelledColourPalette.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneLabelledDrawable.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneLabelledDrawable.cs
index d5dda6f6cd..f717bb4dee 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneLabelledDrawable.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneLabelledDrawable.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Extensions.IEnumerableExtensions;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneLabelledDropdown.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneLabelledDropdown.cs
index a9aaefdf6c..cd14d6bde3 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneLabelledDropdown.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneLabelledDropdown.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Game.Beatmaps;
 using osu.Game.Graphics.UserInterfaceV2;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneLabelledSliderBar.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneLabelledSliderBar.cs
index 1b7f65f9a0..8ccfe2ee9c 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneLabelledSliderBar.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneLabelledSliderBar.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneLabelledSwitchButton.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneLabelledSwitchButton.cs
index 903f1242b4..03434ff0a1 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneLabelledSwitchButton.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneLabelledSwitchButton.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneLabelledTextBox.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneLabelledTextBox.cs
index c11ba0aa59..3f93e60773 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneLabelledTextBox.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneLabelledTextBox.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneLoadingLayer.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneLoadingLayer.cs
index d426723f0b..2fc6405b88 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneLoadingLayer.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneLoadingLayer.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneLoadingSpinner.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneLoadingSpinner.cs
index 47f5bdfe17..8c9b9186b1 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneLoadingSpinner.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneLoadingSpinner.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Shapes;
 using osu.Game.Graphics.UserInterface;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneLogoAnimation.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneLogoAnimation.cs
index 155d043bf9..b565cb359b 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneLogoAnimation.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneLogoAnimation.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneLogoTrackingContainer.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneLogoTrackingContainer.cs
index b46d35a84d..558ea01a49 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneLogoTrackingContainer.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneLogoTrackingContainer.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneModColumn.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneModColumn.cs
index 331509e10f..50817bf804 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneModColumn.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneModColumn.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 enable
-
 using System;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneModDifficultyAdjustSettings.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneModDifficultyAdjustSettings.cs
index 8e1f426f7b..72e503dc33 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneModDifficultyAdjustSettings.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneModDifficultyAdjustSettings.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneModDisplay.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneModDisplay.cs
index b8f5ee5e86..c65d1f8c5e 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneModDisplay.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneModDisplay.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Graphics;
 using osu.Game.Rulesets.Mods;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneModFlowDisplay.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneModFlowDisplay.cs
index 10eab148de..c45ea3a40c 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneModFlowDisplay.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneModFlowDisplay.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneModIcon.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneModIcon.cs
index 513eb2fafc..0a0415789a 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneModIcon.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneModIcon.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Game.Rulesets.Osu;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneModPanel.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneModPanel.cs
index f56d9c8a91..9c0b36073b 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneModPanel.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneModPanel.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.
 
+#nullable disable
+
 using System;
 using NUnit.Framework;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectOverlay.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectOverlay.cs
index 9bb02c3e75..31061dc109 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectOverlay.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectOverlay.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneModSettingsArea.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneModSettingsArea.cs
index ddc1c8c128..a9c3872643 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneModSettingsArea.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneModSettingsArea.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.
 
+#nullable disable
+
 using System;
 using NUnit.Framework;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneModSwitchSmall.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneModSwitchSmall.cs
index 447352b7a6..ff9cc09806 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneModSwitchSmall.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneModSwitchSmall.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneModSwitchTiny.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneModSwitchTiny.cs
index dbde7ce425..ddb5845df8 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneModSwitchTiny.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneModSwitchTiny.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneNotificationOverlay.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneNotificationOverlay.cs
index a2aa0499d2..cf069a9e34 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneNotificationOverlay.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneNotificationOverlay.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneNowPlayingOverlay.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneNowPlayingOverlay.cs
index 475ab0c414..f7f35b8361 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneNowPlayingOverlay.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneNowPlayingOverlay.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneOnScreenDisplay.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneOnScreenDisplay.cs
index 544581082e..2d8d7a5de3 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneOnScreenDisplay.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneOnScreenDisplay.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Configuration;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneOsuAnimatedButton.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneOsuAnimatedButton.cs
index 2eb5a8014e..28599c740e 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneOsuAnimatedButton.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneOsuAnimatedButton.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.
 
+#nullable disable
+
 using System;
 using NUnit.Framework;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneOsuButton.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneOsuButton.cs
index 9d086cce5c..0e31a133ac 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneOsuButton.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneOsuButton.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.
 
+#nullable disable
+
 using System;
 using NUnit.Framework;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneOsuDropdown.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneOsuDropdown.cs
index cce0295413..2cda95bda4 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneOsuDropdown.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneOsuDropdown.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Game.Beatmaps;
 using osu.Game.Graphics.UserInterface;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneOsuFont.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneOsuFont.cs
index eedafce271..f534fc0fac 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneOsuFont.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneOsuFont.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneOsuHoverContainer.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneOsuHoverContainer.cs
index 396bec51b6..d4b15c06c5 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneOsuHoverContainer.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneOsuHoverContainer.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Colour;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneOsuIcon.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneOsuIcon.cs
index 0bc4ac12d6..1e1c3b3282 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneOsuIcon.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneOsuIcon.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.
 
+#nullable disable
+
 using System.Diagnostics;
 using System.Reflection;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneOsuLogo.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneOsuLogo.cs
index 8b91339479..e23a960a7e 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneOsuLogo.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneOsuLogo.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Graphics;
 using osu.Game.Screens.Menu;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneOsuMarkdownContainer.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneOsuMarkdownContainer.cs
index 82e26cb87d..cdccb817b9 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneOsuMarkdownContainer.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneOsuMarkdownContainer.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneOsuMenu.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneOsuMenu.cs
index 387deea76c..5349a1b8a0 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneOsuMenu.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneOsuMenu.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneOsuPopover.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneOsuPopover.cs
index 1848cf6a5e..6cc89a6df8 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneOsuPopover.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneOsuPopover.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Extensions;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneOsuTextBox.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneOsuTextBox.cs
index 353f84c546..cc510f007b 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneOsuTextBox.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneOsuTextBox.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneOverlayHeader.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneOverlayHeader.cs
index 2a76b8e265..a5493559d6 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneOverlayHeader.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneOverlayHeader.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.
 
+#nullable disable
+
 using osu.Framework.Graphics.Containers;
 using osu.Game.Overlays;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneOverlayHeaderBackground.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneOverlayHeaderBackground.cs
index db414d23a0..11507e561f 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneOverlayHeaderBackground.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneOverlayHeaderBackground.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.
 
+#nullable disable
+
 using osu.Framework.Graphics.Containers;
 using osu.Game.Overlays;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneOverlayRulesetSelector.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneOverlayRulesetSelector.cs
index f4fa41a3b7..5a1ce9e791 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneOverlayRulesetSelector.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneOverlayRulesetSelector.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Game.Rulesets.Catch;
 using osu.Game.Rulesets.Mania;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneOverlayScrollContainer.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneOverlayScrollContainer.cs
index 7fa730e02b..7b3e82ff6d 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneOverlayScrollContainer.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneOverlayScrollContainer.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.
 
+#nullable disable
+
 using osu.Framework.Graphics.Containers;
 using osu.Game.Overlays;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestScenePageSelector.cs b/osu.Game.Tests/Visual/UserInterface/TestScenePageSelector.cs
index c99ac52cb1..1907a56735 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestScenePageSelector.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestScenePageSelector.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneParallaxContainer.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneParallaxContainer.cs
index 588b25c02d..6ab69f32ef 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneParallaxContainer.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneParallaxContainer.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Screens;
 using osu.Game.Graphics.Containers;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestScenePlaylistOverlay.cs b/osu.Game.Tests/Visual/UserInterface/TestScenePlaylistOverlay.cs
index 84a06d97df..4c35ec40b5 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestScenePlaylistOverlay.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestScenePlaylistOverlay.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Bindables;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestScenePopupDialog.cs b/osu.Game.Tests/Visual/UserInterface/TestScenePopupDialog.cs
index b5f2544071..218677fd03 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestScenePopupDialog.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestScenePopupDialog.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Sprites;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneProfileSubsectionHeader.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneProfileSubsectionHeader.cs
index 4ce684d5af..9738ff33c3 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneProfileSubsectionHeader.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneProfileSubsectionHeader.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Game.Overlays.Profile.Sections;
 using osu.Framework.Testing;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneRankingsSortTabControl.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneRankingsSortTabControl.cs
index 24bc0dbc97..a95ae190dd 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneRankingsSortTabControl.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneRankingsSortTabControl.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Game.Overlays;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneRoundedButton.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneRoundedButton.cs
index 454a71e6d2..2587960275 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneRoundedButton.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneRoundedButton.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Bindables;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneSafeAreaHandling.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneSafeAreaHandling.cs
index 8b4e3f6d3a..2ba0fa36c3 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneSafeAreaHandling.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneSafeAreaHandling.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneScalingContainer.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneScalingContainer.cs
index 5d554719a5..67c47492b0 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneScalingContainer.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneScalingContainer.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneScreenBreadcrumbControl.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneScreenBreadcrumbControl.cs
index 77a7d819a9..b3ee0af78b 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneScreenBreadcrumbControl.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneScreenBreadcrumbControl.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneSectionsContainer.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneSectionsContainer.cs
index 1f3736bd9b..f71d797363 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneSectionsContainer.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneSectionsContainer.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Extensions.Color4Extensions;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneSettingsCheckbox.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneSettingsCheckbox.cs
index fb04c5bad0..466c83b1ac 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneSettingsCheckbox.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneSettingsCheckbox.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneSettingsToolboxGroup.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneSettingsToolboxGroup.cs
index 8ef24e58a0..50e506f82b 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneSettingsToolboxGroup.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneSettingsToolboxGroup.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneShearedButtons.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneShearedButtons.cs
index 5a4eeef4d9..ba9e1c6366 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneShearedButtons.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneShearedButtons.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneShearedOverlayContainer.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneShearedOverlayContainer.cs
index 4dd64c6536..c0fb315e03 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneShearedOverlayContainer.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneShearedOverlayContainer.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneShearedOverlayHeader.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneShearedOverlayHeader.cs
index ef2b25cd92..09292ee92b 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneShearedOverlayHeader.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneShearedOverlayHeader.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneShearedSearchTextBox.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneShearedSearchTextBox.cs
index e1dbf04133..78e06f7e32 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneShearedSearchTextBox.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneShearedSearchTextBox.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneStarRatingDisplay.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneStarRatingDisplay.cs
index 2806e6d347..1f65b6ec7f 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneStarRatingDisplay.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneStarRatingDisplay.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneStatefulMenuItem.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneStatefulMenuItem.cs
index 18ec631f37..11acb31fef 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneStatefulMenuItem.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneStatefulMenuItem.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.
 
+#nullable disable
+
 using System;
 using NUnit.Framework;
 using osu.Framework.Bindables;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneSwitchButton.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneSwitchButton.cs
index 37fab75aee..4d90a11405 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneSwitchButton.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneSwitchButton.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneTabControl.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneTabControl.cs
index a884741ff8..b868abcc45 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneTabControl.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneTabControl.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.
 
+#nullable disable
+
 using System.ComponentModel;
 using osu.Framework.Graphics;
 using osu.Game.Graphics.Sprites;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneToggleMenuItem.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneToggleMenuItem.cs
index 9fb8e747f3..92cfeef369 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneToggleMenuItem.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneToggleMenuItem.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Game.Graphics.UserInterface;
 
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneToolbarRulesetSelector.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneToolbarRulesetSelector.cs
index cdfbb14cba..de67b85c7d 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneToolbarRulesetSelector.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneToolbarRulesetSelector.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.
 
+#nullable disable
+
 using osu.Framework.Graphics.Containers;
 using osu.Game.Overlays.Toolbar;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneTwoLayerButton.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneTwoLayerButton.cs
index 849577186d..a11efb69bd 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneTwoLayerButton.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneTwoLayerButton.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.
 
+#nullable disable
+
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics.Sprites;
 using osu.Game.Graphics.UserInterface;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneUpdateableBeatmapBackgroundSprite.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneUpdateableBeatmapBackgroundSprite.cs
index 7109a55e7e..32f47d77e1 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneUpdateableBeatmapBackgroundSprite.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneUpdateableBeatmapBackgroundSprite.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneUpdateableBeatmapSetCover.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneUpdateableBeatmapSetCover.cs
index 7b6774a6b2..8176871481 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneUpdateableBeatmapSetCover.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneUpdateableBeatmapSetCover.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneUserListToolbar.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneUserListToolbar.cs
index 8f7140ed7c..5e2e2ccff6 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneUserListToolbar.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneUserListToolbar.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneVolumeOverlay.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneVolumeOverlay.cs
index 64708c4858..b5b4542eac 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneVolumeOverlay.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneVolumeOverlay.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Game.Overlays;
 using osu.Game.Overlays.Volume;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneVolumePieces.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneVolumePieces.cs
index c8478c8eca..9ce71a5347 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneVolumePieces.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneVolumePieces.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Game.Overlays.Volume;
 using osuTK;
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneWaveContainer.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneWaveContainer.cs
index 5b130b9224..6a4934cf47 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneWaveContainer.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneWaveContainer.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.Color4Extensions;
diff --git a/osu.Game.Tests/Visual/UserInterface/ThemeComparisonTestScene.cs b/osu.Game.Tests/Visual/UserInterface/ThemeComparisonTestScene.cs
index 7986f14d1d..8fb0fd84a1 100644
--- a/osu.Game.Tests/Visual/UserInterface/ThemeComparisonTestScene.cs
+++ b/osu.Game.Tests/Visual/UserInterface/ThemeComparisonTestScene.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Tests/WaveformTestBeatmap.cs b/osu.Game.Tests/WaveformTestBeatmap.cs
index ab7bf7fb73..5e41392560 100644
--- a/osu.Game.Tests/WaveformTestBeatmap.cs
+++ b/osu.Game.Tests/WaveformTestBeatmap.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.
 
+#nullable disable
+
 using System;
 using System.IO;
 using System.Linq;
diff --git a/osu.Game.Tournament.Tests/Components/TestSceneDateTextBox.cs b/osu.Game.Tournament.Tests/Components/TestSceneDateTextBox.cs
index 33165d385a..0e6e8f54bd 100644
--- a/osu.Game.Tournament.Tests/Components/TestSceneDateTextBox.cs
+++ b/osu.Game.Tournament.Tests/Components/TestSceneDateTextBox.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Game.Tests.Visual;
 using osu.Game.Tournament.Components;
diff --git a/osu.Game.Tournament.Tests/Components/TestSceneDrawableTournamentMatch.cs b/osu.Game.Tournament.Tests/Components/TestSceneDrawableTournamentMatch.cs
index f98f55dfbc..66093b80a1 100644
--- a/osu.Game.Tournament.Tests/Components/TestSceneDrawableTournamentMatch.cs
+++ b/osu.Game.Tournament.Tests/Components/TestSceneDrawableTournamentMatch.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Tournament.Models;
diff --git a/osu.Game.Tournament.Tests/Components/TestSceneDrawableTournamentTeam.cs b/osu.Game.Tournament.Tests/Components/TestSceneDrawableTournamentTeam.cs
index bb47683be1..9ade9965c5 100644
--- a/osu.Game.Tournament.Tests/Components/TestSceneDrawableTournamentTeam.cs
+++ b/osu.Game.Tournament.Tests/Components/TestSceneDrawableTournamentTeam.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.
 
+#nullable disable
+
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Game.Online.API.Requests.Responses;
diff --git a/osu.Game.Tournament.Tests/Components/TestSceneMatchHeader.cs b/osu.Game.Tournament.Tests/Components/TestSceneMatchHeader.cs
index b29e4964b6..55d58fef6e 100644
--- a/osu.Game.Tournament.Tests/Components/TestSceneMatchHeader.cs
+++ b/osu.Game.Tournament.Tests/Components/TestSceneMatchHeader.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Graphics;
diff --git a/osu.Game.Tournament.Tests/Components/TestSceneMatchScoreDisplay.cs b/osu.Game.Tournament.Tests/Components/TestSceneMatchScoreDisplay.cs
index 11b5cc7556..53301c34d4 100644
--- a/osu.Game.Tournament.Tests/Components/TestSceneMatchScoreDisplay.cs
+++ b/osu.Game.Tournament.Tests/Components/TestSceneMatchScoreDisplay.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Utils;
diff --git a/osu.Game.Tournament.Tests/Components/TestSceneRoundDisplay.cs b/osu.Game.Tournament.Tests/Components/TestSceneRoundDisplay.cs
index 13bca7bea1..514a797068 100644
--- a/osu.Game.Tournament.Tests/Components/TestSceneRoundDisplay.cs
+++ b/osu.Game.Tournament.Tests/Components/TestSceneRoundDisplay.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Game.Tournament.Components;
 using osu.Game.Tournament.Models;
diff --git a/osu.Game.Tournament.Tests/Components/TestSceneSongBar.cs b/osu.Game.Tournament.Tests/Components/TestSceneSongBar.cs
index b6004c651b..f90269ae60 100644
--- a/osu.Game.Tournament.Tests/Components/TestSceneSongBar.cs
+++ b/osu.Game.Tournament.Tests/Components/TestSceneSongBar.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tournament.Tests/Components/TestSceneTournamentBeatmapPanel.cs b/osu.Game.Tournament.Tests/Components/TestSceneTournamentBeatmapPanel.cs
index b678f69b8f..1030aae903 100644
--- a/osu.Game.Tournament.Tests/Components/TestSceneTournamentBeatmapPanel.cs
+++ b/osu.Game.Tournament.Tests/Components/TestSceneTournamentBeatmapPanel.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Game.Online.API;
diff --git a/osu.Game.Tournament.Tests/Components/TestSceneTournamentMatchChatDisplay.cs b/osu.Game.Tournament.Tests/Components/TestSceneTournamentMatchChatDisplay.cs
index 05989566c3..4a4def10b5 100644
--- a/osu.Game.Tournament.Tests/Components/TestSceneTournamentMatchChatDisplay.cs
+++ b/osu.Game.Tournament.Tests/Components/TestSceneTournamentMatchChatDisplay.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tournament.Tests/Components/TestSceneTournamentModDisplay.cs b/osu.Game.Tournament.Tests/Components/TestSceneTournamentModDisplay.cs
index 9feef36a02..fdd5578228 100644
--- a/osu.Game.Tournament.Tests/Components/TestSceneTournamentModDisplay.cs
+++ b/osu.Game.Tournament.Tests/Components/TestSceneTournamentModDisplay.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game.Tournament.Tests/NonVisual/CustomTourneyDirectoryTest.cs b/osu.Game.Tournament.Tests/NonVisual/CustomTourneyDirectoryTest.cs
index 26fb03bed4..d314f40c30 100644
--- a/osu.Game.Tournament.Tests/NonVisual/CustomTourneyDirectoryTest.cs
+++ b/osu.Game.Tournament.Tests/NonVisual/CustomTourneyDirectoryTest.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.
 
+#nullable disable
+
 using System.IO;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Tournament.Tests/NonVisual/DataLoadTest.cs b/osu.Game.Tournament.Tests/NonVisual/DataLoadTest.cs
index e5c539bbf1..ad776622be 100644
--- a/osu.Game.Tournament.Tests/NonVisual/DataLoadTest.cs
+++ b/osu.Game.Tournament.Tests/NonVisual/DataLoadTest.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.
 
+#nullable disable
+
 using System;
 using System.IO;
 using System.Threading.Tasks;
diff --git a/osu.Game.Tournament.Tests/NonVisual/IPCLocationTest.cs b/osu.Game.Tournament.Tests/NonVisual/IPCLocationTest.cs
index 80cc9be5c1..1bbbcc3661 100644
--- a/osu.Game.Tournament.Tests/NonVisual/IPCLocationTest.cs
+++ b/osu.Game.Tournament.Tests/NonVisual/IPCLocationTest.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.
 
+#nullable disable
+
 using System.IO;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game.Tournament.Tests/NonVisual/LadderInfoSerialisationTest.cs b/osu.Game.Tournament.Tests/NonVisual/LadderInfoSerialisationTest.cs
index 8bdf909af3..f1e0966293 100644
--- a/osu.Game.Tournament.Tests/NonVisual/LadderInfoSerialisationTest.cs
+++ b/osu.Game.Tournament.Tests/NonVisual/LadderInfoSerialisationTest.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.
 
+#nullable disable
+
 using Newtonsoft.Json;
 using NUnit.Framework;
 using osu.Game.Tournament.Models;
diff --git a/osu.Game.Tournament.Tests/NonVisual/TournamentHostTest.cs b/osu.Game.Tournament.Tests/NonVisual/TournamentHostTest.cs
index bf99f69b2a..8dc0946432 100644
--- a/osu.Game.Tournament.Tests/NonVisual/TournamentHostTest.cs
+++ b/osu.Game.Tournament.Tests/NonVisual/TournamentHostTest.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.
 
+#nullable disable
+
 using System;
 using System.Threading;
 using System.Threading.Tasks;
diff --git a/osu.Game.Tournament.Tests/Screens/TestSceneDrawingsScreen.cs b/osu.Game.Tournament.Tests/Screens/TestSceneDrawingsScreen.cs
index 0e38c777ba..e0c6aaf834 100644
--- a/osu.Game.Tournament.Tests/Screens/TestSceneDrawingsScreen.cs
+++ b/osu.Game.Tournament.Tests/Screens/TestSceneDrawingsScreen.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.
 
+#nullable disable
+
 using System.IO;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tournament.Tests/Screens/TestSceneGameplayScreen.cs b/osu.Game.Tournament.Tests/Screens/TestSceneGameplayScreen.cs
index 6879a71f1d..842324d03d 100644
--- a/osu.Game.Tournament.Tests/Screens/TestSceneGameplayScreen.cs
+++ b/osu.Game.Tournament.Tests/Screens/TestSceneGameplayScreen.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Tournament.Tests/Screens/TestSceneLadderEditorScreen.cs b/osu.Game.Tournament.Tests/Screens/TestSceneLadderEditorScreen.cs
index bceb3e6b74..7aade4fb82 100644
--- a/osu.Game.Tournament.Tests/Screens/TestSceneLadderEditorScreen.cs
+++ b/osu.Game.Tournament.Tests/Screens/TestSceneLadderEditorScreen.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Game.Graphics.Cursor;
diff --git a/osu.Game.Tournament.Tests/Screens/TestSceneLadderScreen.cs b/osu.Game.Tournament.Tests/Screens/TestSceneLadderScreen.cs
index c4c100d506..1f817a1b22 100644
--- a/osu.Game.Tournament.Tests/Screens/TestSceneLadderScreen.cs
+++ b/osu.Game.Tournament.Tests/Screens/TestSceneLadderScreen.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Game.Graphics.Cursor;
diff --git a/osu.Game.Tournament.Tests/Screens/TestSceneMapPoolScreen.cs b/osu.Game.Tournament.Tests/Screens/TestSceneMapPoolScreen.cs
index f732c5582b..e0f91cc359 100644
--- a/osu.Game.Tournament.Tests/Screens/TestSceneMapPoolScreen.cs
+++ b/osu.Game.Tournament.Tests/Screens/TestSceneMapPoolScreen.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Tournament.Tests/Screens/TestSceneRoundEditorScreen.cs b/osu.Game.Tournament.Tests/Screens/TestSceneRoundEditorScreen.cs
index 5c2b59df3a..656663ece7 100644
--- a/osu.Game.Tournament.Tests/Screens/TestSceneRoundEditorScreen.cs
+++ b/osu.Game.Tournament.Tests/Screens/TestSceneRoundEditorScreen.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.
 
+#nullable disable
+
 using osu.Game.Tournament.Screens.Editors;
 
 namespace osu.Game.Tournament.Tests.Screens
diff --git a/osu.Game.Tournament.Tests/Screens/TestSceneScheduleScreen.cs b/osu.Game.Tournament.Tests/Screens/TestSceneScheduleScreen.cs
index bd1bacd549..6061314796 100644
--- a/osu.Game.Tournament.Tests/Screens/TestSceneScheduleScreen.cs
+++ b/osu.Game.Tournament.Tests/Screens/TestSceneScheduleScreen.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.
 
+#nullable disable
+
 using System;
 using NUnit.Framework;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Tournament.Tests/Screens/TestSceneSeedingEditorScreen.cs b/osu.Game.Tournament.Tests/Screens/TestSceneSeedingEditorScreen.cs
index 2722021216..94321e708f 100644
--- a/osu.Game.Tournament.Tests/Screens/TestSceneSeedingEditorScreen.cs
+++ b/osu.Game.Tournament.Tests/Screens/TestSceneSeedingEditorScreen.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Game.Tournament.Models;
 using osu.Game.Tournament.Screens.Editors;
diff --git a/osu.Game.Tournament.Tests/Screens/TestSceneSeedingScreen.cs b/osu.Game.Tournament.Tests/Screens/TestSceneSeedingScreen.cs
index a18e73e38f..2581ed4b7e 100644
--- a/osu.Game.Tournament.Tests/Screens/TestSceneSeedingScreen.cs
+++ b/osu.Game.Tournament.Tests/Screens/TestSceneSeedingScreen.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Tournament.Tests/Screens/TestSceneSetupScreen.cs b/osu.Game.Tournament.Tests/Screens/TestSceneSetupScreen.cs
index 70b260c84c..9070590b15 100644
--- a/osu.Game.Tournament.Tests/Screens/TestSceneSetupScreen.cs
+++ b/osu.Game.Tournament.Tests/Screens/TestSceneSetupScreen.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Game.Tournament.Screens.Setup;
 
diff --git a/osu.Game.Tournament.Tests/Screens/TestSceneShowcaseScreen.cs b/osu.Game.Tournament.Tests/Screens/TestSceneShowcaseScreen.cs
index 8c43e25416..44e7c48887 100644
--- a/osu.Game.Tournament.Tests/Screens/TestSceneShowcaseScreen.cs
+++ b/osu.Game.Tournament.Tests/Screens/TestSceneShowcaseScreen.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Game.Tournament.Screens.Showcase;
 
diff --git a/osu.Game.Tournament.Tests/Screens/TestSceneStablePathSelectScreen.cs b/osu.Game.Tournament.Tests/Screens/TestSceneStablePathSelectScreen.cs
index b422227788..27e5c59600 100644
--- a/osu.Game.Tournament.Tests/Screens/TestSceneStablePathSelectScreen.cs
+++ b/osu.Game.Tournament.Tests/Screens/TestSceneStablePathSelectScreen.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.
 
+#nullable disable
+
 using osu.Game.Tournament.Screens.Setup;
 
 namespace osu.Game.Tournament.Tests.Screens
diff --git a/osu.Game.Tournament.Tests/Screens/TestSceneTeamEditorScreen.cs b/osu.Game.Tournament.Tests/Screens/TestSceneTeamEditorScreen.cs
index fc6574ec8a..b38430ece5 100644
--- a/osu.Game.Tournament.Tests/Screens/TestSceneTeamEditorScreen.cs
+++ b/osu.Game.Tournament.Tests/Screens/TestSceneTeamEditorScreen.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.
 
+#nullable disable
+
 using osu.Game.Tournament.Screens.Editors;
 
 namespace osu.Game.Tournament.Tests.Screens
diff --git a/osu.Game.Tournament.Tests/Screens/TestSceneTeamIntroScreen.cs b/osu.Game.Tournament.Tests/Screens/TestSceneTeamIntroScreen.cs
index e89aac73fa..fccc09c14e 100644
--- a/osu.Game.Tournament.Tests/Screens/TestSceneTeamIntroScreen.cs
+++ b/osu.Game.Tournament.Tests/Screens/TestSceneTeamIntroScreen.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.
 
+#nullable disable
+
 using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tournament.Tests/Screens/TestSceneTeamWinScreen.cs b/osu.Game.Tournament.Tests/Screens/TestSceneTeamWinScreen.cs
index d07cc4c431..3b48c2eee5 100644
--- a/osu.Game.Tournament.Tests/Screens/TestSceneTeamWinScreen.cs
+++ b/osu.Game.Tournament.Tests/Screens/TestSceneTeamWinScreen.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tournament.Tests/TestSceneTournamentSceneManager.cs b/osu.Game.Tournament.Tests/TestSceneTournamentSceneManager.cs
index 53591da07b..e961a3c670 100644
--- a/osu.Game.Tournament.Tests/TestSceneTournamentSceneManager.cs
+++ b/osu.Game.Tournament.Tests/TestSceneTournamentSceneManager.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 
 namespace osu.Game.Tournament.Tests
diff --git a/osu.Game.Tournament.Tests/TournamentTestBrowser.cs b/osu.Game.Tournament.Tests/TournamentTestBrowser.cs
index 50bdcd86c5..1adbe07709 100644
--- a/osu.Game.Tournament.Tests/TournamentTestBrowser.cs
+++ b/osu.Game.Tournament.Tests/TournamentTestBrowser.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.
 
+#nullable disable
+
 using osu.Framework.Testing;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Backgrounds;
diff --git a/osu.Game.Tournament.Tests/TournamentTestRunner.cs b/osu.Game.Tournament.Tests/TournamentTestRunner.cs
index 229ab41a1e..f95fcbf487 100644
--- a/osu.Game.Tournament.Tests/TournamentTestRunner.cs
+++ b/osu.Game.Tournament.Tests/TournamentTestRunner.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.
 
+#nullable disable
+
 using System;
 using osu.Framework;
 using osu.Framework.Platform;
diff --git a/osu.Game.Tournament.Tests/TournamentTestScene.cs b/osu.Game.Tournament.Tests/TournamentTestScene.cs
index 8c05b4e915..d631d028bb 100644
--- a/osu.Game.Tournament.Tests/TournamentTestScene.cs
+++ b/osu.Game.Tournament.Tests/TournamentTestScene.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.
 
+#nullable disable
+
 using System.Linq;
 using System.Threading;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Tournament/Components/ControlPanel.cs b/osu.Game.Tournament/Components/ControlPanel.cs
index ef8c8767e0..f43d494d5a 100644
--- a/osu.Game.Tournament/Components/ControlPanel.cs
+++ b/osu.Game.Tournament/Components/ControlPanel.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
diff --git a/osu.Game.Tournament/Components/DateTextBox.cs b/osu.Game.Tournament/Components/DateTextBox.cs
index 2237e389d7..8eccb9e0e0 100644
--- a/osu.Game.Tournament/Components/DateTextBox.cs
+++ b/osu.Game.Tournament/Components/DateTextBox.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Bindables;
 using osu.Game.Graphics.UserInterface;
diff --git a/osu.Game.Tournament/Components/DrawableTeamFlag.cs b/osu.Game.Tournament/Components/DrawableTeamFlag.cs
index f8c2612d71..6e9c1120e4 100644
--- a/osu.Game.Tournament/Components/DrawableTeamFlag.cs
+++ b/osu.Game.Tournament/Components/DrawableTeamFlag.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.
 
+#nullable disable
+
 using JetBrains.Annotations;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game.Tournament/Components/DrawableTeamHeader.cs b/osu.Game.Tournament/Components/DrawableTeamHeader.cs
index 3d9e8a6e00..ceaf8d5e6e 100644
--- a/osu.Game.Tournament/Components/DrawableTeamHeader.cs
+++ b/osu.Game.Tournament/Components/DrawableTeamHeader.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.
 
+#nullable disable
+
 using osu.Game.Tournament.Models;
 using osuTK;
 
diff --git a/osu.Game.Tournament/Components/DrawableTeamTitle.cs b/osu.Game.Tournament/Components/DrawableTeamTitle.cs
index 6732eb152f..b7e936026c 100644
--- a/osu.Game.Tournament/Components/DrawableTeamTitle.cs
+++ b/osu.Game.Tournament/Components/DrawableTeamTitle.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.
 
+#nullable disable
+
 using JetBrains.Annotations;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game.Tournament/Components/DrawableTeamTitleWithHeader.cs b/osu.Game.Tournament/Components/DrawableTeamTitleWithHeader.cs
index ceffe3d315..dbc9fa7f16 100644
--- a/osu.Game.Tournament/Components/DrawableTeamTitleWithHeader.cs
+++ b/osu.Game.Tournament/Components/DrawableTeamTitleWithHeader.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Tournament.Models;
diff --git a/osu.Game.Tournament/Components/DrawableTeamWithPlayers.cs b/osu.Game.Tournament/Components/DrawableTeamWithPlayers.cs
index 4d9afc23ac..21de2bb0eb 100644
--- a/osu.Game.Tournament/Components/DrawableTeamWithPlayers.cs
+++ b/osu.Game.Tournament/Components/DrawableTeamWithPlayers.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.
 
+#nullable disable
+
 using System.Linq;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game.Tournament/Components/DrawableTournamentHeaderLogo.cs b/osu.Game.Tournament/Components/DrawableTournamentHeaderLogo.cs
index 3f5ab42fd7..9f5b825e30 100644
--- a/osu.Game.Tournament/Components/DrawableTournamentHeaderLogo.cs
+++ b/osu.Game.Tournament/Components/DrawableTournamentHeaderLogo.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game.Tournament/Components/DrawableTournamentHeaderText.cs b/osu.Game.Tournament/Components/DrawableTournamentHeaderText.cs
index 99d914fed4..67eeee7de4 100644
--- a/osu.Game.Tournament/Components/DrawableTournamentHeaderText.cs
+++ b/osu.Game.Tournament/Components/DrawableTournamentHeaderText.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game.Tournament/Components/DrawableTournamentTeam.cs b/osu.Game.Tournament/Components/DrawableTournamentTeam.cs
index 367e447947..84cae92a39 100644
--- a/osu.Game.Tournament/Components/DrawableTournamentTeam.cs
+++ b/osu.Game.Tournament/Components/DrawableTournamentTeam.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.
 
+#nullable disable
+
 using JetBrains.Annotations;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game.Tournament/Components/IPCErrorDialog.cs b/osu.Game.Tournament/Components/IPCErrorDialog.cs
index dc039cd3bc..a32e01fb48 100644
--- a/osu.Game.Tournament/Components/IPCErrorDialog.cs
+++ b/osu.Game.Tournament/Components/IPCErrorDialog.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.
 
+#nullable disable
+
 using osu.Framework.Graphics.Sprites;
 using osu.Game.Overlays.Dialog;
 
diff --git a/osu.Game.Tournament/Components/RoundDisplay.cs b/osu.Game.Tournament/Components/RoundDisplay.cs
index c0002e6804..98ef09aa58 100644
--- a/osu.Game.Tournament/Components/RoundDisplay.cs
+++ b/osu.Game.Tournament/Components/RoundDisplay.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Graphics;
diff --git a/osu.Game.Tournament/Components/SongBar.cs b/osu.Game.Tournament/Components/SongBar.cs
index a45582a7c0..ecc655da99 100644
--- a/osu.Game.Tournament/Components/SongBar.cs
+++ b/osu.Game.Tournament/Components/SongBar.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tournament/Components/TournamentBeatmapPanel.cs b/osu.Game.Tournament/Components/TournamentBeatmapPanel.cs
index b064d3dd79..6416abe8a9 100644
--- a/osu.Game.Tournament/Components/TournamentBeatmapPanel.cs
+++ b/osu.Game.Tournament/Components/TournamentBeatmapPanel.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Specialized;
 using System.Linq;
diff --git a/osu.Game.Tournament/Components/TournamentMatchChatDisplay.cs b/osu.Game.Tournament/Components/TournamentMatchChatDisplay.cs
index c30250c86a..6a8e4aa951 100644
--- a/osu.Game.Tournament/Components/TournamentMatchChatDisplay.cs
+++ b/osu.Game.Tournament/Components/TournamentMatchChatDisplay.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.
 
+#nullable disable
+
 using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game.Tournament/Components/TournamentModIcon.cs b/osu.Game.Tournament/Components/TournamentModIcon.cs
index 57a0390ac2..6697a993c3 100644
--- a/osu.Game.Tournament/Components/TournamentModIcon.cs
+++ b/osu.Game.Tournament/Components/TournamentModIcon.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game.Tournament/Components/TournamentSpriteTextWithBackground.cs b/osu.Game.Tournament/Components/TournamentSpriteTextWithBackground.cs
index d92b9eb605..0fc3646585 100644
--- a/osu.Game.Tournament/Components/TournamentSpriteTextWithBackground.cs
+++ b/osu.Game.Tournament/Components/TournamentSpriteTextWithBackground.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
diff --git a/osu.Game.Tournament/Components/TourneyVideo.cs b/osu.Game.Tournament/Components/TourneyVideo.cs
index 2709580385..c6bbb54f9a 100644
--- a/osu.Game.Tournament/Components/TourneyVideo.cs
+++ b/osu.Game.Tournament/Components/TourneyVideo.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Colour;
diff --git a/osu.Game.Tournament/Configuration/TournamentStorageManager.cs b/osu.Game.Tournament/Configuration/TournamentStorageManager.cs
index e3d0a9e75c..0b9a556296 100644
--- a/osu.Game.Tournament/Configuration/TournamentStorageManager.cs
+++ b/osu.Game.Tournament/Configuration/TournamentStorageManager.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.
 
+#nullable disable
+
 using osu.Framework.Configuration;
 using osu.Framework.Platform;
 
diff --git a/osu.Game.Tournament/IO/TournamentStorage.cs b/osu.Game.Tournament/IO/TournamentStorage.cs
index b4859d0c91..bd52b6dfed 100644
--- a/osu.Game.Tournament/IO/TournamentStorage.cs
+++ b/osu.Game.Tournament/IO/TournamentStorage.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.IO;
 using osu.Framework.Bindables;
diff --git a/osu.Game.Tournament/IO/TournamentVideoResourceStore.cs b/osu.Game.Tournament/IO/TournamentVideoResourceStore.cs
index 964d03220d..ba584f1d3e 100644
--- a/osu.Game.Tournament/IO/TournamentVideoResourceStore.cs
+++ b/osu.Game.Tournament/IO/TournamentVideoResourceStore.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.
 
+#nullable disable
+
 using osu.Framework.IO.Stores;
 using osu.Framework.Platform;
 
diff --git a/osu.Game.Tournament/IPC/FileBasedIPC.cs b/osu.Game.Tournament/IPC/FileBasedIPC.cs
index 5278d538d2..77af3e9b58 100644
--- a/osu.Game.Tournament/IPC/FileBasedIPC.cs
+++ b/osu.Game.Tournament/IPC/FileBasedIPC.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.
 
+#nullable disable
+
 using System;
 using System.IO;
 using System.Linq;
diff --git a/osu.Game.Tournament/IPC/MatchIPCInfo.cs b/osu.Game.Tournament/IPC/MatchIPCInfo.cs
index fa7079b824..ef1e36f871 100644
--- a/osu.Game.Tournament/IPC/MatchIPCInfo.cs
+++ b/osu.Game.Tournament/IPC/MatchIPCInfo.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.
 
+#nullable disable
+
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Game.Beatmaps.Legacy;
diff --git a/osu.Game.Tournament/IPC/TourneyState.cs b/osu.Game.Tournament/IPC/TourneyState.cs
index ef1c612a53..2c7253dc10 100644
--- a/osu.Game.Tournament/IPC/TourneyState.cs
+++ b/osu.Game.Tournament/IPC/TourneyState.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.
 
+#nullable disable
+
 namespace osu.Game.Tournament.IPC
 {
     public enum TourneyState
diff --git a/osu.Game.Tournament/JsonPointConverter.cs b/osu.Game.Tournament/JsonPointConverter.cs
index 32bbe2dc18..db48c36c99 100644
--- a/osu.Game.Tournament/JsonPointConverter.cs
+++ b/osu.Game.Tournament/JsonPointConverter.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.
 
+#nullable disable
+
 using System;
 using System.Diagnostics;
 using System.Drawing;
diff --git a/osu.Game.Tournament/Models/BeatmapChoice.cs b/osu.Game.Tournament/Models/BeatmapChoice.cs
index 384b349b24..ddd4597722 100644
--- a/osu.Game.Tournament/Models/BeatmapChoice.cs
+++ b/osu.Game.Tournament/Models/BeatmapChoice.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.
 
+#nullable disable
+
 using System;
 using Newtonsoft.Json;
 using Newtonsoft.Json.Converters;
diff --git a/osu.Game.Tournament/Models/LadderEditorInfo.cs b/osu.Game.Tournament/Models/LadderEditorInfo.cs
index 70fd115e25..84ebeff3db 100644
--- a/osu.Game.Tournament/Models/LadderEditorInfo.cs
+++ b/osu.Game.Tournament/Models/LadderEditorInfo.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.
 
+#nullable disable
+
 using osu.Framework.Bindables;
 
 namespace osu.Game.Tournament.Models
diff --git a/osu.Game.Tournament/Models/LadderInfo.cs b/osu.Game.Tournament/Models/LadderInfo.cs
index 7794019437..0f73b60774 100644
--- a/osu.Game.Tournament/Models/LadderInfo.cs
+++ b/osu.Game.Tournament/Models/LadderInfo.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using Newtonsoft.Json;
diff --git a/osu.Game.Tournament/Models/RoundBeatmap.cs b/osu.Game.Tournament/Models/RoundBeatmap.cs
index 2fd79546f1..90e31ba352 100644
--- a/osu.Game.Tournament/Models/RoundBeatmap.cs
+++ b/osu.Game.Tournament/Models/RoundBeatmap.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.
 
+#nullable disable
+
 using Newtonsoft.Json;
 using osu.Game.Online.API.Requests.Responses;
 
diff --git a/osu.Game.Tournament/Models/SeedingBeatmap.cs b/osu.Game.Tournament/Models/SeedingBeatmap.cs
index 26f3016ac8..c854488319 100644
--- a/osu.Game.Tournament/Models/SeedingBeatmap.cs
+++ b/osu.Game.Tournament/Models/SeedingBeatmap.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.
 
+#nullable disable
+
 using Newtonsoft.Json;
 using osu.Framework.Bindables;
 using osu.Game.Online.API.Requests.Responses;
diff --git a/osu.Game.Tournament/Models/SeedingResult.cs b/osu.Game.Tournament/Models/SeedingResult.cs
index d37c967762..71e52b3324 100644
--- a/osu.Game.Tournament/Models/SeedingResult.cs
+++ b/osu.Game.Tournament/Models/SeedingResult.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Framework.Bindables;
 
diff --git a/osu.Game.Tournament/Models/StableInfo.cs b/osu.Game.Tournament/Models/StableInfo.cs
index c835b11a4d..1ae80d4596 100644
--- a/osu.Game.Tournament/Models/StableInfo.cs
+++ b/osu.Game.Tournament/Models/StableInfo.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.
 
+#nullable disable
+
 using System;
 using System.IO;
 using Newtonsoft.Json;
diff --git a/osu.Game.Tournament/Models/TournamentMatch.cs b/osu.Game.Tournament/Models/TournamentMatch.cs
index bdfb1728f3..2f72dc9257 100644
--- a/osu.Game.Tournament/Models/TournamentMatch.cs
+++ b/osu.Game.Tournament/Models/TournamentMatch.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Collections.ObjectModel;
diff --git a/osu.Game.Tournament/Models/TournamentProgression.cs b/osu.Game.Tournament/Models/TournamentProgression.cs
index 5575b4c29e..6c3ba1922a 100644
--- a/osu.Game.Tournament/Models/TournamentProgression.cs
+++ b/osu.Game.Tournament/Models/TournamentProgression.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.
 
+#nullable disable
+
 using System;
 
 namespace osu.Game.Tournament.Models
diff --git a/osu.Game.Tournament/Models/TournamentRound.cs b/osu.Game.Tournament/Models/TournamentRound.cs
index ab39605d07..480d6c37c3 100644
--- a/osu.Game.Tournament/Models/TournamentRound.cs
+++ b/osu.Game.Tournament/Models/TournamentRound.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using Newtonsoft.Json;
diff --git a/osu.Game.Tournament/Models/TournamentTeam.cs b/osu.Game.Tournament/Models/TournamentTeam.cs
index 24dee3b372..051f1a6d80 100644
--- a/osu.Game.Tournament/Models/TournamentTeam.cs
+++ b/osu.Game.Tournament/Models/TournamentTeam.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using Newtonsoft.Json;
diff --git a/osu.Game.Tournament/Properties/AssemblyInfo.cs b/osu.Game.Tournament/Properties/AssemblyInfo.cs
index 70e42bcafb..2eb8c3e1d6 100644
--- a/osu.Game.Tournament/Properties/AssemblyInfo.cs
+++ b/osu.Game.Tournament/Properties/AssemblyInfo.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.
 
+#nullable disable
+
 using System.Runtime.CompilerServices;
 
 // We publish our internal attributes to other sub-projects of the framework.
diff --git a/osu.Game.Tournament/Screens/BeatmapInfoScreen.cs b/osu.Game.Tournament/Screens/BeatmapInfoScreen.cs
index 77b816d24c..296267a4bc 100644
--- a/osu.Game.Tournament/Screens/BeatmapInfoScreen.cs
+++ b/osu.Game.Tournament/Screens/BeatmapInfoScreen.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tournament/Screens/Drawings/Components/DrawingsConfigManager.cs b/osu.Game.Tournament/Screens/Drawings/Components/DrawingsConfigManager.cs
index 1a2f5a1ff4..ac1d599851 100644
--- a/osu.Game.Tournament/Screens/Drawings/Components/DrawingsConfigManager.cs
+++ b/osu.Game.Tournament/Screens/Drawings/Components/DrawingsConfigManager.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.
 
+#nullable disable
+
 using osu.Framework.Configuration;
 using osu.Framework.Platform;
 
diff --git a/osu.Game.Tournament/Screens/Drawings/Components/Group.cs b/osu.Game.Tournament/Screens/Drawings/Components/Group.cs
index ece1c431e2..f50abd6e58 100644
--- a/osu.Game.Tournament/Screens/Drawings/Components/Group.cs
+++ b/osu.Game.Tournament/Screens/Drawings/Components/Group.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using System.Text;
diff --git a/osu.Game.Tournament/Screens/Drawings/Components/GroupContainer.cs b/osu.Game.Tournament/Screens/Drawings/Components/GroupContainer.cs
index b9a19090df..62b3c4e8ff 100644
--- a/osu.Game.Tournament/Screens/Drawings/Components/GroupContainer.cs
+++ b/osu.Game.Tournament/Screens/Drawings/Components/GroupContainer.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game.Tournament/Screens/Drawings/Components/GroupTeam.cs b/osu.Game.Tournament/Screens/Drawings/Components/GroupTeam.cs
index cd252392ba..80bdad8b7b 100644
--- a/osu.Game.Tournament/Screens/Drawings/Components/GroupTeam.cs
+++ b/osu.Game.Tournament/Screens/Drawings/Components/GroupTeam.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Graphics;
diff --git a/osu.Game.Tournament/Screens/Drawings/Components/ITeamList.cs b/osu.Game.Tournament/Screens/Drawings/Components/ITeamList.cs
index 09208818a9..7e0ac89c83 100644
--- a/osu.Game.Tournament/Screens/Drawings/Components/ITeamList.cs
+++ b/osu.Game.Tournament/Screens/Drawings/Components/ITeamList.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Game.Tournament.Models;
 
diff --git a/osu.Game.Tournament/Screens/Drawings/Components/ScrollingTeamContainer.cs b/osu.Game.Tournament/Screens/Drawings/Components/ScrollingTeamContainer.cs
index f1022a0402..52c611d323 100644
--- a/osu.Game.Tournament/Screens/Drawings/Components/ScrollingTeamContainer.cs
+++ b/osu.Game.Tournament/Screens/Drawings/Components/ScrollingTeamContainer.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Diagnostics;
diff --git a/osu.Game.Tournament/Screens/Drawings/Components/StorageBackedTeamList.cs b/osu.Game.Tournament/Screens/Drawings/Components/StorageBackedTeamList.cs
index 5d035a4028..c230607343 100644
--- a/osu.Game.Tournament/Screens/Drawings/Components/StorageBackedTeamList.cs
+++ b/osu.Game.Tournament/Screens/Drawings/Components/StorageBackedTeamList.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.IO;
diff --git a/osu.Game.Tournament/Screens/Drawings/Components/VisualiserContainer.cs b/osu.Game.Tournament/Screens/Drawings/Components/VisualiserContainer.cs
index f21f5c9460..15edbb76c1 100644
--- a/osu.Game.Tournament/Screens/Drawings/Components/VisualiserContainer.cs
+++ b/osu.Game.Tournament/Screens/Drawings/Components/VisualiserContainer.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Tournament/Screens/Drawings/DrawingsScreen.cs b/osu.Game.Tournament/Screens/Drawings/DrawingsScreen.cs
index 53ac93afea..58ba3c1e8b 100644
--- a/osu.Game.Tournament/Screens/Drawings/DrawingsScreen.cs
+++ b/osu.Game.Tournament/Screens/Drawings/DrawingsScreen.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.IO;
diff --git a/osu.Game.Tournament/Screens/Editors/IModelBacked.cs b/osu.Game.Tournament/Screens/Editors/IModelBacked.cs
index ed94bd7f45..ca59afa2cb 100644
--- a/osu.Game.Tournament/Screens/Editors/IModelBacked.cs
+++ b/osu.Game.Tournament/Screens/Editors/IModelBacked.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.
 
+#nullable disable
+
 namespace osu.Game.Tournament.Screens.Editors
 {
     /// <summary>
diff --git a/osu.Game.Tournament/Screens/Editors/LadderEditorScreen.cs b/osu.Game.Tournament/Screens/Editors/LadderEditorScreen.cs
index ca46c3b050..6052bcdeb7 100644
--- a/osu.Game.Tournament/Screens/Editors/LadderEditorScreen.cs
+++ b/osu.Game.Tournament/Screens/Editors/LadderEditorScreen.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.
 
+#nullable disable
+
 using System;
 using System.Drawing;
 using System.Linq;
diff --git a/osu.Game.Tournament/Screens/Editors/RoundEditorScreen.cs b/osu.Game.Tournament/Screens/Editors/RoundEditorScreen.cs
index 5c12d83d1c..214ae65289 100644
--- a/osu.Game.Tournament/Screens/Editors/RoundEditorScreen.cs
+++ b/osu.Game.Tournament/Screens/Editors/RoundEditorScreen.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.
 
+#nullable disable
+
 using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game.Tournament/Screens/Editors/SeedingEditorScreen.cs b/osu.Game.Tournament/Screens/Editors/SeedingEditorScreen.cs
index 5cdfe7dc08..1377c11225 100644
--- a/osu.Game.Tournament/Screens/Editors/SeedingEditorScreen.cs
+++ b/osu.Game.Tournament/Screens/Editors/SeedingEditorScreen.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.
 
+#nullable disable
+
 using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game.Tournament/Screens/Editors/TeamEditorScreen.cs b/osu.Game.Tournament/Screens/Editors/TeamEditorScreen.cs
index 6adddb5204..005d8f36bb 100644
--- a/osu.Game.Tournament/Screens/Editors/TeamEditorScreen.cs
+++ b/osu.Game.Tournament/Screens/Editors/TeamEditorScreen.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Diagnostics;
 using System.IO;
diff --git a/osu.Game.Tournament/Screens/Editors/TournamentEditorScreen.cs b/osu.Game.Tournament/Screens/Editors/TournamentEditorScreen.cs
index a5a2c5c15f..8af5bbe513 100644
--- a/osu.Game.Tournament/Screens/Editors/TournamentEditorScreen.cs
+++ b/osu.Game.Tournament/Screens/Editors/TournamentEditorScreen.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.
 
+#nullable disable
+
 using System.Collections.Specialized;
 using System.Linq;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Tournament/Screens/Gameplay/Components/MatchHeader.cs b/osu.Game.Tournament/Screens/Gameplay/Components/MatchHeader.cs
index 8048425ce1..91a75bf86f 100644
--- a/osu.Game.Tournament/Screens/Gameplay/Components/MatchHeader.cs
+++ b/osu.Game.Tournament/Screens/Gameplay/Components/MatchHeader.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game.Tournament/Screens/Gameplay/Components/MatchRoundDisplay.cs b/osu.Game.Tournament/Screens/Gameplay/Components/MatchRoundDisplay.cs
index 2f0e4b5e87..78206c6d47 100644
--- a/osu.Game.Tournament/Screens/Gameplay/Components/MatchRoundDisplay.cs
+++ b/osu.Game.Tournament/Screens/Gameplay/Components/MatchRoundDisplay.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Game.Tournament.Components;
diff --git a/osu.Game.Tournament/Screens/Gameplay/Components/TeamDisplay.cs b/osu.Game.Tournament/Screens/Gameplay/Components/TeamDisplay.cs
index 33658115cc..bb187c9e67 100644
--- a/osu.Game.Tournament/Screens/Gameplay/Components/TeamDisplay.cs
+++ b/osu.Game.Tournament/Screens/Gameplay/Components/TeamDisplay.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.
 
+#nullable disable
+
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game.Tournament/Screens/Gameplay/Components/TeamScore.cs b/osu.Game.Tournament/Screens/Gameplay/Components/TeamScore.cs
index 36c78c5ac1..3fa06c16b4 100644
--- a/osu.Game.Tournament/Screens/Gameplay/Components/TeamScore.cs
+++ b/osu.Game.Tournament/Screens/Gameplay/Components/TeamScore.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.
 
+#nullable disable
+
 using osu.Framework.Bindables;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tournament/Screens/Gameplay/Components/TeamScoreDisplay.cs b/osu.Game.Tournament/Screens/Gameplay/Components/TeamScoreDisplay.cs
index da55ba53ea..ed11f097ed 100644
--- a/osu.Game.Tournament/Screens/Gameplay/Components/TeamScoreDisplay.cs
+++ b/osu.Game.Tournament/Screens/Gameplay/Components/TeamScoreDisplay.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tournament/Screens/Gameplay/Components/TournamentMatchScoreDisplay.cs b/osu.Game.Tournament/Screens/Gameplay/Components/TournamentMatchScoreDisplay.cs
index db15a46fc8..7454d22aa2 100644
--- a/osu.Game.Tournament/Screens/Gameplay/Components/TournamentMatchScoreDisplay.cs
+++ b/osu.Game.Tournament/Screens/Gameplay/Components/TournamentMatchScoreDisplay.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game.Tournament/Screens/Gameplay/GameplayScreen.cs b/osu.Game.Tournament/Screens/Gameplay/GameplayScreen.cs
index f900dd7eac..86b2c2a4e9 100644
--- a/osu.Game.Tournament/Screens/Gameplay/GameplayScreen.cs
+++ b/osu.Game.Tournament/Screens/Gameplay/GameplayScreen.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tournament/Screens/IProvideVideo.cs b/osu.Game.Tournament/Screens/IProvideVideo.cs
index 61989d8448..aa67a5211f 100644
--- a/osu.Game.Tournament/Screens/IProvideVideo.cs
+++ b/osu.Game.Tournament/Screens/IProvideVideo.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.
 
+#nullable disable
+
 namespace osu.Game.Tournament.Screens
 {
     /// <summary>
diff --git a/osu.Game.Tournament/Screens/Ladder/Components/ConditionalTournamentMatch.cs b/osu.Game.Tournament/Screens/Ladder/Components/ConditionalTournamentMatch.cs
index 16224a7fb4..04155fcb89 100644
--- a/osu.Game.Tournament/Screens/Ladder/Components/ConditionalTournamentMatch.cs
+++ b/osu.Game.Tournament/Screens/Ladder/Components/ConditionalTournamentMatch.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.
 
+#nullable disable
+
 using osu.Game.Tournament.Models;
 
 namespace osu.Game.Tournament.Screens.Ladder.Components
diff --git a/osu.Game.Tournament/Screens/Ladder/Components/DrawableMatchTeam.cs b/osu.Game.Tournament/Screens/Ladder/Components/DrawableMatchTeam.cs
index ea453a53ca..c005e11efe 100644
--- a/osu.Game.Tournament/Screens/Ladder/Components/DrawableMatchTeam.cs
+++ b/osu.Game.Tournament/Screens/Ladder/Components/DrawableMatchTeam.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game.Tournament/Screens/Ladder/Components/DrawableTournamentMatch.cs b/osu.Game.Tournament/Screens/Ladder/Components/DrawableTournamentMatch.cs
index 5729e779c4..5204edf3be 100644
--- a/osu.Game.Tournament/Screens/Ladder/Components/DrawableTournamentMatch.cs
+++ b/osu.Game.Tournament/Screens/Ladder/Components/DrawableTournamentMatch.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Drawing;
diff --git a/osu.Game.Tournament/Screens/Ladder/Components/DrawableTournamentRound.cs b/osu.Game.Tournament/Screens/Ladder/Components/DrawableTournamentRound.cs
index cad0b827c0..ac196130d6 100644
--- a/osu.Game.Tournament/Screens/Ladder/Components/DrawableTournamentRound.cs
+++ b/osu.Game.Tournament/Screens/Ladder/Components/DrawableTournamentRound.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.
 
+#nullable disable
+
 using JetBrains.Annotations;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tournament/Screens/Ladder/Components/LadderEditorSettings.cs b/osu.Game.Tournament/Screens/Ladder/Components/LadderEditorSettings.cs
index cf4466a2e3..f0eda5672a 100644
--- a/osu.Game.Tournament/Screens/Ladder/Components/LadderEditorSettings.cs
+++ b/osu.Game.Tournament/Screens/Ladder/Components/LadderEditorSettings.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Collections.Specialized;
 using System.Linq;
diff --git a/osu.Game.Tournament/Screens/Ladder/Components/ProgressionPath.cs b/osu.Game.Tournament/Screens/Ladder/Components/ProgressionPath.cs
index 960c4f41cc..c5f8c3bb51 100644
--- a/osu.Game.Tournament/Screens/Ladder/Components/ProgressionPath.cs
+++ b/osu.Game.Tournament/Screens/Ladder/Components/ProgressionPath.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.
 
+#nullable disable
+
 using System.Linq;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Lines;
diff --git a/osu.Game.Tournament/Screens/Ladder/Components/SettingsTeamDropdown.cs b/osu.Game.Tournament/Screens/Ladder/Components/SettingsTeamDropdown.cs
index 6604e3a313..74424783c6 100644
--- a/osu.Game.Tournament/Screens/Ladder/Components/SettingsTeamDropdown.cs
+++ b/osu.Game.Tournament/Screens/Ladder/Components/SettingsTeamDropdown.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Collections.Specialized;
 using System.Linq;
diff --git a/osu.Game.Tournament/Screens/Ladder/LadderDragContainer.cs b/osu.Game.Tournament/Screens/Ladder/LadderDragContainer.cs
index f98bfd087d..6fae44de35 100644
--- a/osu.Game.Tournament/Screens/Ladder/LadderDragContainer.cs
+++ b/osu.Game.Tournament/Screens/Ladder/LadderDragContainer.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game.Tournament/Screens/Ladder/LadderScreen.cs b/osu.Game.Tournament/Screens/Ladder/LadderScreen.cs
index ad6e304c80..f274503894 100644
--- a/osu.Game.Tournament/Screens/Ladder/LadderScreen.cs
+++ b/osu.Game.Tournament/Screens/Ladder/LadderScreen.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.
 
+#nullable disable
+
 using System.Collections.Specialized;
 using System.Linq;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Tournament/Screens/MapPool/MapPoolScreen.cs b/osu.Game.Tournament/Screens/MapPool/MapPoolScreen.cs
index 3ae007f955..7ac4510ae5 100644
--- a/osu.Game.Tournament/Screens/MapPool/MapPoolScreen.cs
+++ b/osu.Game.Tournament/Screens/MapPool/MapPoolScreen.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.
 
+#nullable disable
+
 using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game.Tournament/Screens/Schedule/ScheduleScreen.cs b/osu.Game.Tournament/Screens/Schedule/ScheduleScreen.cs
index 84f38170ea..7a11e26794 100644
--- a/osu.Game.Tournament/Screens/Schedule/ScheduleScreen.cs
+++ b/osu.Game.Tournament/Screens/Schedule/ScheduleScreen.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Tournament/Screens/Setup/ActionableInfo.cs b/osu.Game.Tournament/Screens/Setup/ActionableInfo.cs
index cfdf9c99ae..a9ac21284e 100644
--- a/osu.Game.Tournament/Screens/Setup/ActionableInfo.cs
+++ b/osu.Game.Tournament/Screens/Setup/ActionableInfo.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game.Tournament/Screens/Setup/ResolutionSelector.cs b/osu.Game.Tournament/Screens/Setup/ResolutionSelector.cs
index e53110651b..a387341d66 100644
--- a/osu.Game.Tournament/Screens/Setup/ResolutionSelector.cs
+++ b/osu.Game.Tournament/Screens/Setup/ResolutionSelector.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Graphics;
 using osu.Game.Graphics.UserInterface;
diff --git a/osu.Game.Tournament/Screens/Setup/SetupScreen.cs b/osu.Game.Tournament/Screens/Setup/SetupScreen.cs
index f6d28c15e0..42eff3565f 100644
--- a/osu.Game.Tournament/Screens/Setup/SetupScreen.cs
+++ b/osu.Game.Tournament/Screens/Setup/SetupScreen.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.
 
+#nullable disable
+
 using System.Drawing;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game.Tournament/Screens/Setup/StablePathSelectScreen.cs b/osu.Game.Tournament/Screens/Setup/StablePathSelectScreen.cs
index fb9ca46c2d..fac488fcf5 100644
--- a/osu.Game.Tournament/Screens/Setup/StablePathSelectScreen.cs
+++ b/osu.Game.Tournament/Screens/Setup/StablePathSelectScreen.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.
 
+#nullable disable
+
 using System.IO;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tournament/Screens/Setup/TournamentSwitcher.cs b/osu.Game.Tournament/Screens/Setup/TournamentSwitcher.cs
index f0aa857769..fb33b3662a 100644
--- a/osu.Game.Tournament/Screens/Setup/TournamentSwitcher.cs
+++ b/osu.Game.Tournament/Screens/Setup/TournamentSwitcher.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Game.Graphics.UserInterface;
diff --git a/osu.Game.Tournament/Screens/Showcase/ShowcaseScreen.cs b/osu.Game.Tournament/Screens/Showcase/ShowcaseScreen.cs
index 32d458e191..082aa99b0e 100644
--- a/osu.Game.Tournament/Screens/Showcase/ShowcaseScreen.cs
+++ b/osu.Game.Tournament/Screens/Showcase/ShowcaseScreen.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tournament/Screens/Showcase/TournamentLogo.cs b/osu.Game.Tournament/Screens/Showcase/TournamentLogo.cs
index bd5aa2f5d9..07a632ec72 100644
--- a/osu.Game.Tournament/Screens/Showcase/TournamentLogo.cs
+++ b/osu.Game.Tournament/Screens/Showcase/TournamentLogo.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game.Tournament/Screens/TeamIntro/SeedingScreen.cs b/osu.Game.Tournament/Screens/TeamIntro/SeedingScreen.cs
index 0003e213e7..b9559015d6 100644
--- a/osu.Game.Tournament/Screens/TeamIntro/SeedingScreen.cs
+++ b/osu.Game.Tournament/Screens/TeamIntro/SeedingScreen.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tournament/Screens/TeamIntro/TeamIntroScreen.cs b/osu.Game.Tournament/Screens/TeamIntro/TeamIntroScreen.cs
index ef6f0b32ff..98dfaa7487 100644
--- a/osu.Game.Tournament/Screens/TeamIntro/TeamIntroScreen.cs
+++ b/osu.Game.Tournament/Screens/TeamIntro/TeamIntroScreen.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tournament/Screens/TeamWin/TeamWinScreen.cs b/osu.Game.Tournament/Screens/TeamWin/TeamWinScreen.cs
index 11db7bfad9..50207547cd 100644
--- a/osu.Game.Tournament/Screens/TeamWin/TeamWinScreen.cs
+++ b/osu.Game.Tournament/Screens/TeamWin/TeamWinScreen.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game.Tournament/Screens/TournamentMatchScreen.cs b/osu.Game.Tournament/Screens/TournamentMatchScreen.cs
index 5f00036653..585cdd09c1 100644
--- a/osu.Game.Tournament/Screens/TournamentMatchScreen.cs
+++ b/osu.Game.Tournament/Screens/TournamentMatchScreen.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.
 
+#nullable disable
+
 using osu.Framework.Bindables;
 using osu.Game.Tournament.Models;
 
diff --git a/osu.Game.Tournament/Screens/TournamentScreen.cs b/osu.Game.Tournament/Screens/TournamentScreen.cs
index 5da7c7a5d2..b4641fa45d 100644
--- a/osu.Game.Tournament/Screens/TournamentScreen.cs
+++ b/osu.Game.Tournament/Screens/TournamentScreen.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game.Tournament/TournamentGame.cs b/osu.Game.Tournament/TournamentGame.cs
index 7967f54b49..c2c6c271cb 100644
--- a/osu.Game.Tournament/TournamentGame.cs
+++ b/osu.Game.Tournament/TournamentGame.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.
 
+#nullable disable
+
 using System.Drawing;
 using System.Linq;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Tournament/TournamentGameBase.cs b/osu.Game.Tournament/TournamentGameBase.cs
index 6ae0312cce..2d6d5a01e4 100644
--- a/osu.Game.Tournament/TournamentGameBase.cs
+++ b/osu.Game.Tournament/TournamentGameBase.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.
 
+#nullable disable
+
 using System;
 using System.IO;
 using System.Linq;
diff --git a/osu.Game.Tournament/TournamentSceneManager.cs b/osu.Game.Tournament/TournamentSceneManager.cs
index 98338244e4..afbfc2d368 100644
--- a/osu.Game.Tournament/TournamentSceneManager.cs
+++ b/osu.Game.Tournament/TournamentSceneManager.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using osu.Framework.Allocation;
diff --git a/osu.Game.Tournament/TournamentSpriteText.cs b/osu.Game.Tournament/TournamentSpriteText.cs
index e550dfbfae..166a8dfaf0 100644
--- a/osu.Game.Tournament/TournamentSpriteText.cs
+++ b/osu.Game.Tournament/TournamentSpriteText.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.
 
+#nullable disable
+
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
 
diff --git a/osu.Game.Tournament/TourneyButton.cs b/osu.Game.Tournament/TourneyButton.cs
index 12872d3197..f5a82771f5 100644
--- a/osu.Game.Tournament/TourneyButton.cs
+++ b/osu.Game.Tournament/TourneyButton.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.
 
+#nullable disable
+
 using osu.Game.Graphics.UserInterface;
 
 namespace osu.Game.Tournament
diff --git a/osu.Game.Tournament/WarningBox.cs b/osu.Game.Tournament/WarningBox.cs
index 814482aea4..123e78113a 100644
--- a/osu.Game.Tournament/WarningBox.cs
+++ b/osu.Game.Tournament/WarningBox.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
diff --git a/osu.Game/Audio/Effects/AudioFilter.cs b/osu.Game/Audio/Effects/AudioFilter.cs
index 9446967173..5c318eb957 100644
--- a/osu.Game/Audio/Effects/AudioFilter.cs
+++ b/osu.Game/Audio/Effects/AudioFilter.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.
 
+#nullable disable
+
 using System.Diagnostics;
 using ManagedBass.Fx;
 using osu.Framework.Audio.Mixing;
diff --git a/osu.Game/Audio/Effects/ITransformableFilter.cs b/osu.Game/Audio/Effects/ITransformableFilter.cs
index fb6a924f68..02149b362c 100644
--- a/osu.Game/Audio/Effects/ITransformableFilter.cs
+++ b/osu.Game/Audio/Effects/ITransformableFilter.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Transforms;
 
diff --git a/osu.Game/Audio/HitSampleInfo.cs b/osu.Game/Audio/HitSampleInfo.cs
index 3d90dd0189..6aaf3d5cc2 100644
--- a/osu.Game/Audio/HitSampleInfo.cs
+++ b/osu.Game/Audio/HitSampleInfo.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 enable
-
 using System;
 using System.Collections.Generic;
 using Newtonsoft.Json;
diff --git a/osu.Game/Audio/IPreviewTrackOwner.cs b/osu.Game/Audio/IPreviewTrackOwner.cs
index 8ab93257a5..6a3acc2059 100644
--- a/osu.Game/Audio/IPreviewTrackOwner.cs
+++ b/osu.Game/Audio/IPreviewTrackOwner.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.
 
+#nullable disable
+
 namespace osu.Game.Audio
 {
     /// <summary>
diff --git a/osu.Game/Audio/ISampleInfo.cs b/osu.Game/Audio/ISampleInfo.cs
index 4f81d37e78..8f58415587 100644
--- a/osu.Game/Audio/ISampleInfo.cs
+++ b/osu.Game/Audio/ISampleInfo.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 
 namespace osu.Game.Audio
diff --git a/osu.Game/Audio/ISamplePlaybackDisabler.cs b/osu.Game/Audio/ISamplePlaybackDisabler.cs
index 4167316780..250e004b05 100644
--- a/osu.Game/Audio/ISamplePlaybackDisabler.cs
+++ b/osu.Game/Audio/ISamplePlaybackDisabler.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Game.Skinning;
diff --git a/osu.Game/Audio/PreviewTrack.cs b/osu.Game/Audio/PreviewTrack.cs
index 5df656e1e0..8ff8cd5c54 100644
--- a/osu.Game/Audio/PreviewTrack.cs
+++ b/osu.Game/Audio/PreviewTrack.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Audio.Track;
diff --git a/osu.Game/Audio/PreviewTrackManager.cs b/osu.Game/Audio/PreviewTrackManager.cs
index 6d56d152f1..d19fdbd94c 100644
--- a/osu.Game/Audio/PreviewTrackManager.cs
+++ b/osu.Game/Audio/PreviewTrackManager.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
 using osu.Framework.Audio.Track;
diff --git a/osu.Game/Audio/SampleInfo.cs b/osu.Game/Audio/SampleInfo.cs
index 5d8240204e..54b380f23a 100644
--- a/osu.Game/Audio/SampleInfo.cs
+++ b/osu.Game/Audio/SampleInfo.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.
 
+#nullable disable
+
 using System;
 using System.Collections;
 using System.Collections.Generic;
diff --git a/osu.Game/Beatmaps/APIFailTimes.cs b/osu.Game/Beatmaps/APIFailTimes.cs
index 7218906b38..441d30d06b 100644
--- a/osu.Game/Beatmaps/APIFailTimes.cs
+++ b/osu.Game/Beatmaps/APIFailTimes.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.
 
+#nullable disable
+
 using System;
 using Newtonsoft.Json;
 
diff --git a/osu.Game/Beatmaps/Beatmap.cs b/osu.Game/Beatmaps/Beatmap.cs
index 2fa5a56042..c499bccb68 100644
--- a/osu.Game/Beatmaps/Beatmap.cs
+++ b/osu.Game/Beatmaps/Beatmap.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.
 
+#nullable disable
+
 using System;
 using osu.Game.Beatmaps.Timing;
 using osu.Game.Rulesets.Objects;
diff --git a/osu.Game/Beatmaps/BeatmapConverter.cs b/osu.Game/Beatmaps/BeatmapConverter.cs
index 627e54c803..4419791e43 100644
--- a/osu.Game/Beatmaps/BeatmapConverter.cs
+++ b/osu.Game/Beatmaps/BeatmapConverter.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Beatmaps/BeatmapDifficulty.cs b/osu.Game/Beatmaps/BeatmapDifficulty.cs
index 7e0462f1e8..f4bc5e7b77 100644
--- a/osu.Game/Beatmaps/BeatmapDifficulty.cs
+++ b/osu.Game/Beatmaps/BeatmapDifficulty.cs
@@ -4,8 +4,6 @@
 using osu.Framework.Testing;
 using Realms;
 
-#nullable enable
-
 namespace osu.Game.Beatmaps
 {
     [ExcludeFromDynamicCompile]
diff --git a/osu.Game/Beatmaps/BeatmapDifficultyCache.cs b/osu.Game/Beatmaps/BeatmapDifficultyCache.cs
index f102daeef5..69488277f1 100644
--- a/osu.Game/Beatmaps/BeatmapDifficultyCache.cs
+++ b/osu.Game/Beatmaps/BeatmapDifficultyCache.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Diagnostics;
diff --git a/osu.Game/Beatmaps/BeatmapImporter.cs b/osu.Game/Beatmaps/BeatmapImporter.cs
index 5e3aa434b8..e463492e2b 100644
--- a/osu.Game/Beatmaps/BeatmapImporter.cs
+++ b/osu.Game/Beatmaps/BeatmapImporter.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 enable
-
 using System;
 using System.Collections.Generic;
 using System.IO;
diff --git a/osu.Game/Beatmaps/BeatmapInfo.cs b/osu.Game/Beatmaps/BeatmapInfo.cs
index 5925dd7064..346bf86818 100644
--- a/osu.Game/Beatmaps/BeatmapInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapInfo.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 enable
-
 using System;
 using System.Linq;
 using JetBrains.Annotations;
diff --git a/osu.Game/Beatmaps/BeatmapInfoExtensions.cs b/osu.Game/Beatmaps/BeatmapInfoExtensions.cs
index eab66b9857..e7ff07fa5d 100644
--- a/osu.Game/Beatmaps/BeatmapInfoExtensions.cs
+++ b/osu.Game/Beatmaps/BeatmapInfoExtensions.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.
 
+#nullable disable
+
 using System.Linq;
 using osu.Framework.Localisation;
 
diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index 192ef0d37d..1dd3f82426 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.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 enable
-
 using System;
 using System.Collections.Generic;
 using System.Diagnostics;
diff --git a/osu.Game/Beatmaps/BeatmapMetadata.cs b/osu.Game/Beatmaps/BeatmapMetadata.cs
index 3a24c4808f..feb9d34f44 100644
--- a/osu.Game/Beatmaps/BeatmapMetadata.cs
+++ b/osu.Game/Beatmaps/BeatmapMetadata.cs
@@ -10,8 +10,6 @@ using osu.Game.Users;
 using osu.Game.Utils;
 using Realms;
 
-#nullable enable
-
 namespace osu.Game.Beatmaps
 {
     [ExcludeFromDynamicCompile]
diff --git a/osu.Game/Beatmaps/BeatmapMetadataInfoExtensions.cs b/osu.Game/Beatmaps/BeatmapMetadataInfoExtensions.cs
index 7e7d1babf0..738bdb0839 100644
--- a/osu.Game/Beatmaps/BeatmapMetadataInfoExtensions.cs
+++ b/osu.Game/Beatmaps/BeatmapMetadataInfoExtensions.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.
 
+#nullable disable
+
 using System.Linq;
 using osu.Framework.Localisation;
 
diff --git a/osu.Game/Beatmaps/BeatmapModelDownloader.cs b/osu.Game/Beatmaps/BeatmapModelDownloader.cs
index d31730ca15..74d583fe7e 100644
--- a/osu.Game/Beatmaps/BeatmapModelDownloader.cs
+++ b/osu.Game/Beatmaps/BeatmapModelDownloader.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.
 
+#nullable disable
+
 using osu.Game.Database;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests;
diff --git a/osu.Game/Beatmaps/BeatmapOnlineLookupQueue.cs b/osu.Game/Beatmaps/BeatmapOnlineLookupQueue.cs
index 44fa8092fb..a2eb76cafa 100644
--- a/osu.Game/Beatmaps/BeatmapOnlineLookupQueue.cs
+++ b/osu.Game/Beatmaps/BeatmapOnlineLookupQueue.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.
 
+#nullable disable
+
 using System;
 using System.Diagnostics;
 using System.IO;
diff --git a/osu.Game/Beatmaps/BeatmapOnlineStatus.cs b/osu.Game/Beatmaps/BeatmapOnlineStatus.cs
index 7ac25b7b75..ced85e0908 100644
--- a/osu.Game/Beatmaps/BeatmapOnlineStatus.cs
+++ b/osu.Game/Beatmaps/BeatmapOnlineStatus.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.
 
+#nullable disable
+
 using osu.Framework.Localisation;
 using osu.Game.Resources.Localisation.Web;
 
diff --git a/osu.Game/Beatmaps/BeatmapProcessor.cs b/osu.Game/Beatmaps/BeatmapProcessor.cs
index cdeaab06ed..8f3d0b7445 100644
--- a/osu.Game/Beatmaps/BeatmapProcessor.cs
+++ b/osu.Game/Beatmaps/BeatmapProcessor.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.
 
+#nullable disable
+
 using System.Linq;
 using osu.Game.Rulesets.Objects.Types;
 
diff --git a/osu.Game/Beatmaps/BeatmapSetFileInfo.cs b/osu.Game/Beatmaps/BeatmapSetFileInfo.cs
index 3d41f59b3d..051366fb99 100644
--- a/osu.Game/Beatmaps/BeatmapSetFileInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapSetFileInfo.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.
 
+#nullable disable
+
 using System.ComponentModel.DataAnnotations;
 using osu.Game.Database;
 using osu.Game.IO;
diff --git a/osu.Game/Beatmaps/BeatmapSetHypeStatus.cs b/osu.Game/Beatmaps/BeatmapSetHypeStatus.cs
index 8a576e396a..b2d4cac210 100644
--- a/osu.Game/Beatmaps/BeatmapSetHypeStatus.cs
+++ b/osu.Game/Beatmaps/BeatmapSetHypeStatus.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.
 
+#nullable disable
+
 using Newtonsoft.Json;
 
 namespace osu.Game.Beatmaps
diff --git a/osu.Game/Beatmaps/BeatmapSetInfo.cs b/osu.Game/Beatmaps/BeatmapSetInfo.cs
index 9a4207d5cf..96d95b1a12 100644
--- a/osu.Game/Beatmaps/BeatmapSetInfo.cs
+++ b/osu.Game/Beatmaps/BeatmapSetInfo.cs
@@ -12,8 +12,6 @@ using osu.Game.Extensions;
 using osu.Game.Models;
 using Realms;
 
-#nullable enable
-
 namespace osu.Game.Beatmaps
 {
     [ExcludeFromDynamicCompile]
diff --git a/osu.Game/Beatmaps/BeatmapSetNominationStatus.cs b/osu.Game/Beatmaps/BeatmapSetNominationStatus.cs
index 6a19616a97..cea0063814 100644
--- a/osu.Game/Beatmaps/BeatmapSetNominationStatus.cs
+++ b/osu.Game/Beatmaps/BeatmapSetNominationStatus.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.
 
+#nullable disable
+
 using Newtonsoft.Json;
 
 namespace osu.Game.Beatmaps
diff --git a/osu.Game/Beatmaps/BeatmapSetOnlineAvailability.cs b/osu.Game/Beatmaps/BeatmapSetOnlineAvailability.cs
index 14a63f3279..12424b797c 100644
--- a/osu.Game/Beatmaps/BeatmapSetOnlineAvailability.cs
+++ b/osu.Game/Beatmaps/BeatmapSetOnlineAvailability.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.
 
+#nullable disable
+
 using Newtonsoft.Json;
 
 namespace osu.Game.Beatmaps
diff --git a/osu.Game/Beatmaps/BeatmapSetOnlineCovers.cs b/osu.Game/Beatmaps/BeatmapSetOnlineCovers.cs
index aad31befa8..b76496b145 100644
--- a/osu.Game/Beatmaps/BeatmapSetOnlineCovers.cs
+++ b/osu.Game/Beatmaps/BeatmapSetOnlineCovers.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.
 
+#nullable disable
+
 using Newtonsoft.Json;
 
 namespace osu.Game.Beatmaps
diff --git a/osu.Game/Beatmaps/BeatmapSetOnlineGenre.cs b/osu.Game/Beatmaps/BeatmapSetOnlineGenre.cs
index e727e2c37f..ad2e994d3e 100644
--- a/osu.Game/Beatmaps/BeatmapSetOnlineGenre.cs
+++ b/osu.Game/Beatmaps/BeatmapSetOnlineGenre.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.
 
+#nullable disable
+
 namespace osu.Game.Beatmaps
 {
     public struct BeatmapSetOnlineGenre
diff --git a/osu.Game/Beatmaps/BeatmapSetOnlineLanguage.cs b/osu.Game/Beatmaps/BeatmapSetOnlineLanguage.cs
index 658e5a4005..c71c279086 100644
--- a/osu.Game/Beatmaps/BeatmapSetOnlineLanguage.cs
+++ b/osu.Game/Beatmaps/BeatmapSetOnlineLanguage.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.
 
+#nullable disable
+
 namespace osu.Game.Beatmaps
 {
     public struct BeatmapSetOnlineLanguage
diff --git a/osu.Game/Beatmaps/BeatmapStatistic.cs b/osu.Game/Beatmaps/BeatmapStatistic.cs
index 94ebb56a5c..13e0e4ad5e 100644
--- a/osu.Game/Beatmaps/BeatmapStatistic.cs
+++ b/osu.Game/Beatmaps/BeatmapStatistic.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Graphics;
 using osu.Framework.Localisation;
diff --git a/osu.Game/Beatmaps/BeatmapStatisticIcon.cs b/osu.Game/Beatmaps/BeatmapStatisticIcon.cs
index 181fb540df..58d13a3172 100644
--- a/osu.Game/Beatmaps/BeatmapStatisticIcon.cs
+++ b/osu.Game/Beatmaps/BeatmapStatisticIcon.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.
 
+#nullable disable
+
 using Humanizer;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics.Sprites;
diff --git a/osu.Game/Beatmaps/BeatmapUserSettings.cs b/osu.Game/Beatmaps/BeatmapUserSettings.cs
index 5c71bf34b1..1d993e6d67 100644
--- a/osu.Game/Beatmaps/BeatmapUserSettings.cs
+++ b/osu.Game/Beatmaps/BeatmapUserSettings.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.
 
-#nullable enable
 using Realms;
 
 namespace osu.Game.Beatmaps
diff --git a/osu.Game/Beatmaps/ControlPoints/ControlPoint.cs b/osu.Game/Beatmaps/ControlPoints/ControlPoint.cs
index 4079a0cd5f..5f06e03509 100644
--- a/osu.Game/Beatmaps/ControlPoints/ControlPoint.cs
+++ b/osu.Game/Beatmaps/ControlPoints/ControlPoint.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.
 
+#nullable disable
+
 using System;
 using Newtonsoft.Json;
 using osu.Game.Graphics;
diff --git a/osu.Game/Beatmaps/ControlPoints/ControlPointGroup.cs b/osu.Game/Beatmaps/ControlPoints/ControlPointGroup.cs
index cb73ce884e..9df38b01ee 100644
--- a/osu.Game/Beatmaps/ControlPoints/ControlPointGroup.cs
+++ b/osu.Game/Beatmaps/ControlPoints/ControlPointGroup.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Beatmaps/ControlPoints/ControlPointInfo.cs b/osu.Game/Beatmaps/ControlPoints/ControlPointInfo.cs
index af03d639be..eda7ef0bcc 100644
--- a/osu.Game/Beatmaps/ControlPoints/ControlPointInfo.cs
+++ b/osu.Game/Beatmaps/ControlPoints/ControlPointInfo.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Beatmaps/ControlPoints/DifficultyControlPoint.cs b/osu.Game/Beatmaps/ControlPoints/DifficultyControlPoint.cs
index bf7ed8e6f5..8b3d755fb6 100644
--- a/osu.Game/Beatmaps/ControlPoints/DifficultyControlPoint.cs
+++ b/osu.Game/Beatmaps/ControlPoints/DifficultyControlPoint.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.
 
+#nullable disable
+
 using osu.Framework.Bindables;
 using osu.Game.Graphics;
 using osuTK.Graphics;
diff --git a/osu.Game/Beatmaps/ControlPoints/EffectControlPoint.cs b/osu.Game/Beatmaps/ControlPoints/EffectControlPoint.cs
index 7f550a52fc..35425972da 100644
--- a/osu.Game/Beatmaps/ControlPoints/EffectControlPoint.cs
+++ b/osu.Game/Beatmaps/ControlPoints/EffectControlPoint.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.
 
+#nullable disable
+
 using osu.Framework.Bindables;
 using osu.Game.Graphics;
 using osuTK.Graphics;
diff --git a/osu.Game/Beatmaps/ControlPoints/SampleControlPoint.cs b/osu.Game/Beatmaps/ControlPoints/SampleControlPoint.cs
index fb489f73b1..bed499ef3f 100644
--- a/osu.Game/Beatmaps/ControlPoints/SampleControlPoint.cs
+++ b/osu.Game/Beatmaps/ControlPoints/SampleControlPoint.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.
 
+#nullable disable
+
 using osu.Framework.Bindables;
 using osu.Game.Audio;
 using osu.Game.Graphics;
diff --git a/osu.Game/Beatmaps/ControlPoints/TimingControlPoint.cs b/osu.Game/Beatmaps/ControlPoints/TimingControlPoint.cs
index 3a7c8b2ec0..922439fcb8 100644
--- a/osu.Game/Beatmaps/ControlPoints/TimingControlPoint.cs
+++ b/osu.Game/Beatmaps/ControlPoints/TimingControlPoint.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 enable
-
 using osu.Framework.Bindables;
 using osu.Game.Beatmaps.Timing;
 using osu.Game.Graphics;
diff --git a/osu.Game/Beatmaps/CountdownType.cs b/osu.Game/Beatmaps/CountdownType.cs
index 73f85bf701..7fb3de74fb 100644
--- a/osu.Game/Beatmaps/CountdownType.cs
+++ b/osu.Game/Beatmaps/CountdownType.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.
 
+#nullable disable
+
 using System.ComponentModel;
 
 namespace osu.Game.Beatmaps
diff --git a/osu.Game/Beatmaps/DifficultyRating.cs b/osu.Game/Beatmaps/DifficultyRating.cs
index f0ee0ad705..478c0e36df 100644
--- a/osu.Game/Beatmaps/DifficultyRating.cs
+++ b/osu.Game/Beatmaps/DifficultyRating.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.
 
+#nullable disable
+
 namespace osu.Game.Beatmaps
 {
     public enum DifficultyRating
diff --git a/osu.Game/Beatmaps/DifficultyRecommender.cs b/osu.Game/Beatmaps/DifficultyRecommender.cs
index 4629b20569..ed2d6cd3a8 100644
--- a/osu.Game/Beatmaps/DifficultyRecommender.cs
+++ b/osu.Game/Beatmaps/DifficultyRecommender.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Beatmaps/Drawables/BeatmapBackgroundSprite.cs b/osu.Game/Beatmaps/Drawables/BeatmapBackgroundSprite.cs
index 916df429a4..4ba16839f5 100644
--- a/osu.Game/Beatmaps/Drawables/BeatmapBackgroundSprite.cs
+++ b/osu.Game/Beatmaps/Drawables/BeatmapBackgroundSprite.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics.Sprites;
diff --git a/osu.Game/Beatmaps/Drawables/BeatmapDownloadButton.cs b/osu.Game/Beatmaps/Drawables/BeatmapDownloadButton.cs
index 6ab92a2ba2..4dd3a56244 100644
--- a/osu.Game/Beatmaps/Drawables/BeatmapDownloadButton.cs
+++ b/osu.Game/Beatmaps/Drawables/BeatmapDownloadButton.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Beatmaps/Drawables/BeatmapSetOnlineStatusPill.cs b/osu.Game/Beatmaps/Drawables/BeatmapSetOnlineStatusPill.cs
index 19026638ba..88d4991c5d 100644
--- a/osu.Game/Beatmaps/Drawables/BeatmapSetOnlineStatusPill.cs
+++ b/osu.Game/Beatmaps/Drawables/BeatmapSetOnlineStatusPill.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 enable
-
 using osu.Framework.Allocation;
 using osu.Framework.Extensions;
 using osu.Framework.Extensions.LocalisationExtensions;
diff --git a/osu.Game/Beatmaps/Drawables/BundledBeatmapDownloader.cs b/osu.Game/Beatmaps/Drawables/BundledBeatmapDownloader.cs
index 5ebdee0b09..9b97df906b 100644
--- a/osu.Game/Beatmaps/Drawables/BundledBeatmapDownloader.cs
+++ b/osu.Game/Beatmaps/Drawables/BundledBeatmapDownloader.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Diagnostics;
diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
index 08aaa8da42..b9e0a4e6cb 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCard.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 enable
-
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardContent.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardContent.cs
index 1aaa72f5f0..bfec391b1d 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardContent.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardContent.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 enable
-
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardContentBackground.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardContentBackground.cs
index 392f5d1bfa..64a28c5394 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardContentBackground.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardContentBackground.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 enable
-
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardDifficultyList.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardDifficultyList.cs
index eeb86f4702..9489116530 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardDifficultyList.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardDifficultyList.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.
 
+#nullable disable
+
 using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardDownloadProgressBar.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardDownloadProgressBar.cs
index ffb4e0c540..d55622d7aa 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardDownloadProgressBar.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardDownloadProgressBar.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtra.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtra.cs
index 7826d64296..4b9e5d9ae4 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtra.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtra.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 enable
-
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtraInfoRow.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtraInfoRow.cs
index 2d411ad344..7ba677e5dc 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtraInfoRow.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtraInfoRow.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 enable
-
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardNormal.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardNormal.cs
index c1ba521925..d9ce64879f 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardNormal.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardNormal.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 enable
-
 using System.Collections.Generic;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardSize.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardSize.cs
index 098265506d..1f6538a890 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardSize.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardSize.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.
 
+#nullable disable
+
 namespace osu.Game.Beatmaps.Drawables.Cards
 {
     /// <summary>
diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardThumbnail.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardThumbnail.cs
index f11a5916e1..55d3f0b969 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardThumbnail.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardThumbnail.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapSetFavouriteState.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapSetFavouriteState.cs
index 82523cc865..8f8a47c199 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapSetFavouriteState.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapSetFavouriteState.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.
 
+#nullable disable
+
 using osu.Game.Beatmaps.Drawables.Cards.Buttons;
 using osu.Game.Beatmaps.Drawables.Cards.Statistics;
 
diff --git a/osu.Game/Beatmaps/Drawables/Cards/Buttons/BeatmapCardIconButton.cs b/osu.Game/Beatmaps/Drawables/Cards/Buttons/BeatmapCardIconButton.cs
index e362e3abeb..c5b251cc2b 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/Buttons/BeatmapCardIconButton.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/Buttons/BeatmapCardIconButton.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Beatmaps/Drawables/Cards/Buttons/DownloadButton.cs b/osu.Game/Beatmaps/Drawables/Cards/Buttons/DownloadButton.cs
index c94e335e8f..fdb43cb47e 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/Buttons/DownloadButton.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/Buttons/DownloadButton.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 enable
-
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Beatmaps/Drawables/Cards/Buttons/FavouriteButton.cs b/osu.Game/Beatmaps/Drawables/Cards/Buttons/FavouriteButton.cs
index 9fed2fde6f..78481ac27a 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/Buttons/FavouriteButton.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/Buttons/FavouriteButton.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics.Sprites;
diff --git a/osu.Game/Beatmaps/Drawables/Cards/Buttons/GoToBeatmapButton.cs b/osu.Game/Beatmaps/Drawables/Cards/Buttons/GoToBeatmapButton.cs
index 9a6a3c01b7..127c5bd903 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/Buttons/GoToBeatmapButton.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/Buttons/GoToBeatmapButton.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 enable
-
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Beatmaps/Drawables/Cards/Buttons/PlayButton.cs b/osu.Game/Beatmaps/Drawables/Cards/Buttons/PlayButton.cs
index f7bab26666..18eab09465 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/Buttons/PlayButton.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/Buttons/PlayButton.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 enable
-
 using System.Collections.Generic;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Beatmaps/Drawables/Cards/CollapsibleButtonContainer.cs b/osu.Game/Beatmaps/Drawables/Cards/CollapsibleButtonContainer.cs
index 3a2cb80a8d..107c126eb5 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/CollapsibleButtonContainer.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/CollapsibleButtonContainer.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 enable
-
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Beatmaps/Drawables/Cards/ExpandedContentScrollContainer.cs b/osu.Game/Beatmaps/Drawables/Cards/ExpandedContentScrollContainer.cs
index adde72d1e8..a80a7998a5 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/ExpandedContentScrollContainer.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/ExpandedContentScrollContainer.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Graphics;
 using osu.Framework.Input.Events;
diff --git a/osu.Game/Beatmaps/Drawables/Cards/HoverHandlingContainer.cs b/osu.Game/Beatmaps/Drawables/Cards/HoverHandlingContainer.cs
index fe37616755..7d70f3c4cd 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/HoverHandlingContainer.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/HoverHandlingContainer.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 enable
-
 using System;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Input.Events;
diff --git a/osu.Game/Beatmaps/Drawables/Cards/IconPill.cs b/osu.Game/Beatmaps/Drawables/Cards/IconPill.cs
index 1b2c5d3ffc..aad71610a5 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/IconPill.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/IconPill.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Cursor;
diff --git a/osu.Game/Beatmaps/Drawables/Cards/Statistics/BeatmapCardDateStatistic.cs b/osu.Game/Beatmaps/Drawables/Cards/Statistics/BeatmapCardDateStatistic.cs
index 9dbe5a9114..f6fc3070aa 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/Statistics/BeatmapCardDateStatistic.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/Statistics/BeatmapCardDateStatistic.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 enable
-
 using System;
 using osu.Framework.Extensions.LocalisationExtensions;
 using osu.Framework.Graphics.Cursor;
diff --git a/osu.Game/Beatmaps/Drawables/Cards/Statistics/BeatmapCardStatistic.cs b/osu.Game/Beatmaps/Drawables/Cards/Statistics/BeatmapCardStatistic.cs
index f46926284f..89a4687500 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/Statistics/BeatmapCardStatistic.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/Statistics/BeatmapCardStatistic.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Beatmaps/Drawables/Cards/Statistics/FavouritesStatistic.cs b/osu.Game/Beatmaps/Drawables/Cards/Statistics/FavouritesStatistic.cs
index d924fd938b..cef1f630ed 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/Statistics/FavouritesStatistic.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/Statistics/FavouritesStatistic.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.
 
+#nullable disable
+
 using Humanizer;
 using osu.Framework.Bindables;
 using osu.Framework.Extensions.LocalisationExtensions;
diff --git a/osu.Game/Beatmaps/Drawables/Cards/Statistics/HypesStatistic.cs b/osu.Game/Beatmaps/Drawables/Cards/Statistics/HypesStatistic.cs
index 521d1a5f21..26b90ba0c0 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/Statistics/HypesStatistic.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/Statistics/HypesStatistic.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 enable
-
 using osu.Framework.Extensions.LocalisationExtensions;
 using osu.Framework.Graphics.Sprites;
 using osu.Game.Resources.Localisation.Web;
diff --git a/osu.Game/Beatmaps/Drawables/Cards/Statistics/NominationsStatistic.cs b/osu.Game/Beatmaps/Drawables/Cards/Statistics/NominationsStatistic.cs
index 23bd6ef0a9..4f3605c138 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/Statistics/NominationsStatistic.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/Statistics/NominationsStatistic.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 enable
-
 using osu.Framework.Extensions.LocalisationExtensions;
 using osu.Framework.Graphics.Sprites;
 using osu.Game.Resources.Localisation.Web;
diff --git a/osu.Game/Beatmaps/Drawables/Cards/Statistics/PlayCountStatistic.cs b/osu.Game/Beatmaps/Drawables/Cards/Statistics/PlayCountStatistic.cs
index d8f0c36bd9..f66d51de5d 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/Statistics/PlayCountStatistic.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/Statistics/PlayCountStatistic.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.
 
+#nullable disable
+
 using Humanizer;
 using osu.Framework.Extensions.LocalisationExtensions;
 using osu.Framework.Graphics.Sprites;
diff --git a/osu.Game/Beatmaps/Drawables/Cards/StoryboardIconPill.cs b/osu.Game/Beatmaps/Drawables/Cards/StoryboardIconPill.cs
index 2ebf9107f5..dcb2c3c760 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/StoryboardIconPill.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/StoryboardIconPill.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.
 
+#nullable disable
+
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Localisation;
 using osu.Game.Resources.Localisation.Web;
diff --git a/osu.Game/Beatmaps/Drawables/Cards/VideoIconPill.cs b/osu.Game/Beatmaps/Drawables/Cards/VideoIconPill.cs
index b81e18b0dd..9ca1e5c4c4 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/VideoIconPill.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/VideoIconPill.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.
 
+#nullable disable
+
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Localisation;
 using osu.Game.Resources.Localisation.Web;
diff --git a/osu.Game/Beatmaps/Drawables/DifficultyIcon.cs b/osu.Game/Beatmaps/Drawables/DifficultyIcon.cs
index 82be0559a7..a1b0f04aae 100644
--- a/osu.Game/Beatmaps/Drawables/DifficultyIcon.cs
+++ b/osu.Game/Beatmaps/Drawables/DifficultyIcon.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Threading;
diff --git a/osu.Game/Beatmaps/Drawables/DifficultyIconTooltip.cs b/osu.Game/Beatmaps/Drawables/DifficultyIconTooltip.cs
index 5479644772..4732de6e79 100644
--- a/osu.Game/Beatmaps/Drawables/DifficultyIconTooltip.cs
+++ b/osu.Game/Beatmaps/Drawables/DifficultyIconTooltip.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Beatmaps/Drawables/DifficultySpectrumDisplay.cs b/osu.Game/Beatmaps/Drawables/DifficultySpectrumDisplay.cs
index 5b467d67e2..22ca0a9037 100644
--- a/osu.Game/Beatmaps/Drawables/DifficultySpectrumDisplay.cs
+++ b/osu.Game/Beatmaps/Drawables/DifficultySpectrumDisplay.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Beatmaps/Drawables/DownloadProgressBar.cs b/osu.Game/Beatmaps/Drawables/DownloadProgressBar.cs
index ad0ff876e8..50bd7ad48e 100644
--- a/osu.Game/Beatmaps/Drawables/DownloadProgressBar.cs
+++ b/osu.Game/Beatmaps/Drawables/DownloadProgressBar.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Beatmaps/Drawables/GroupedDifficultyIcon.cs b/osu.Game/Beatmaps/Drawables/GroupedDifficultyIcon.cs
index 799a02579e..15ca4c60d4 100644
--- a/osu.Game/Beatmaps/Drawables/GroupedDifficultyIcon.cs
+++ b/osu.Game/Beatmaps/Drawables/GroupedDifficultyIcon.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Beatmaps/Drawables/OnlineBeatmapSetCover.cs b/osu.Game/Beatmaps/Drawables/OnlineBeatmapSetCover.cs
index 0b19c27022..063990c89c 100644
--- a/osu.Game/Beatmaps/Drawables/OnlineBeatmapSetCover.cs
+++ b/osu.Game/Beatmaps/Drawables/OnlineBeatmapSetCover.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics.Sprites;
diff --git a/osu.Game/Beatmaps/Drawables/StarRatingDisplay.cs b/osu.Game/Beatmaps/Drawables/StarRatingDisplay.cs
index dde7680989..44bccd69d0 100644
--- a/osu.Game/Beatmaps/Drawables/StarRatingDisplay.cs
+++ b/osu.Game/Beatmaps/Drawables/StarRatingDisplay.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Extensions.Color4Extensions;
diff --git a/osu.Game/Beatmaps/Drawables/UpdateableBeatmapBackgroundSprite.cs b/osu.Game/Beatmaps/Drawables/UpdateableBeatmapBackgroundSprite.cs
index 636c568bd0..f37771a74d 100644
--- a/osu.Game/Beatmaps/Drawables/UpdateableBeatmapBackgroundSprite.cs
+++ b/osu.Game/Beatmaps/Drawables/UpdateableBeatmapBackgroundSprite.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Beatmaps/Drawables/UpdateableOnlineBeatmapSetCover.cs b/osu.Game/Beatmaps/Drawables/UpdateableOnlineBeatmapSetCover.cs
index 4a6a1b888e..236bb63e24 100644
--- a/osu.Game/Beatmaps/Drawables/UpdateableOnlineBeatmapSetCover.cs
+++ b/osu.Game/Beatmaps/Drawables/UpdateableOnlineBeatmapSetCover.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Beatmaps/DummyWorkingBeatmap.cs b/osu.Game/Beatmaps/DummyWorkingBeatmap.cs
index 6e879d09d5..9610dbcc78 100644
--- a/osu.Game/Beatmaps/DummyWorkingBeatmap.cs
+++ b/osu.Game/Beatmaps/DummyWorkingBeatmap.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.IO;
diff --git a/osu.Game/Beatmaps/EFBeatmapDifficulty.cs b/osu.Game/Beatmaps/EFBeatmapDifficulty.cs
index 38371d3b38..8bcac24ca1 100644
--- a/osu.Game/Beatmaps/EFBeatmapDifficulty.cs
+++ b/osu.Game/Beatmaps/EFBeatmapDifficulty.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.
 
+#nullable disable
+
 using System;
 using System.ComponentModel.DataAnnotations.Schema;
 using osu.Game.Database;
diff --git a/osu.Game/Beatmaps/EFBeatmapInfo.cs b/osu.Game/Beatmaps/EFBeatmapInfo.cs
index 740adfd1c7..34311448eb 100644
--- a/osu.Game/Beatmaps/EFBeatmapInfo.cs
+++ b/osu.Game/Beatmaps/EFBeatmapInfo.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.ComponentModel.DataAnnotations;
diff --git a/osu.Game/Beatmaps/EFBeatmapMetadata.cs b/osu.Game/Beatmaps/EFBeatmapMetadata.cs
index 7c27863a7f..c0588f128c 100644
--- a/osu.Game/Beatmaps/EFBeatmapMetadata.cs
+++ b/osu.Game/Beatmaps/EFBeatmapMetadata.cs
@@ -10,8 +10,6 @@ using osu.Game.Database;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Users;
 
-#nullable enable
-
 namespace osu.Game.Beatmaps
 {
     [ExcludeFromDynamicCompile]
diff --git a/osu.Game/Beatmaps/EFBeatmapSetInfo.cs b/osu.Game/Beatmaps/EFBeatmapSetInfo.cs
index 12235abce0..1f41d3727c 100644
--- a/osu.Game/Beatmaps/EFBeatmapSetInfo.cs
+++ b/osu.Game/Beatmaps/EFBeatmapSetInfo.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.ComponentModel.DataAnnotations.Schema;
diff --git a/osu.Game/Beatmaps/FlatFileWorkingBeatmap.cs b/osu.Game/Beatmaps/FlatFileWorkingBeatmap.cs
index cd8aa31ead..02fcde5257 100644
--- a/osu.Game/Beatmaps/FlatFileWorkingBeatmap.cs
+++ b/osu.Game/Beatmaps/FlatFileWorkingBeatmap.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.
 
+#nullable disable
+
 using System;
 using System.IO;
 using osu.Framework.Audio.Track;
diff --git a/osu.Game/Beatmaps/Formats/Decoder.cs b/osu.Game/Beatmaps/Formats/Decoder.cs
index c1537d7240..aad29f46fb 100644
--- a/osu.Game/Beatmaps/Formats/Decoder.cs
+++ b/osu.Game/Beatmaps/Formats/Decoder.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.IO;
diff --git a/osu.Game/Beatmaps/Formats/IHasComboColours.cs b/osu.Game/Beatmaps/Formats/IHasComboColours.cs
index 853a590595..d5e96da246 100644
--- a/osu.Game/Beatmaps/Formats/IHasComboColours.cs
+++ b/osu.Game/Beatmaps/Formats/IHasComboColours.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using osuTK.Graphics;
diff --git a/osu.Game/Beatmaps/Formats/IHasCustomColours.cs b/osu.Game/Beatmaps/Formats/IHasCustomColours.cs
index dba3a37545..b651ef9515 100644
--- a/osu.Game/Beatmaps/Formats/IHasCustomColours.cs
+++ b/osu.Game/Beatmaps/Formats/IHasCustomColours.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osuTK.Graphics;
 
diff --git a/osu.Game/Beatmaps/Formats/JsonBeatmapDecoder.cs b/osu.Game/Beatmaps/Formats/JsonBeatmapDecoder.cs
index 0d5c48f64d..2f11c18993 100644
--- a/osu.Game/Beatmaps/Formats/JsonBeatmapDecoder.cs
+++ b/osu.Game/Beatmaps/Formats/JsonBeatmapDecoder.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.
 
+#nullable disable
+
 using osu.Game.IO;
 using osu.Game.IO.Serialization;
 
diff --git a/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs b/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
index 3a893a1238..89d3465ab6 100644
--- a/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
+++ b/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.IO;
diff --git a/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs b/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs
index 3b4200e7a9..984e88d3a9 100644
--- a/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs
+++ b/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Globalization;
diff --git a/osu.Game/Beatmaps/Formats/LegacyDecoder.cs b/osu.Game/Beatmaps/Formats/LegacyDecoder.cs
index ff13e61360..f2c5b494de 100644
--- a/osu.Game/Beatmaps/Formats/LegacyDecoder.cs
+++ b/osu.Game/Beatmaps/Formats/LegacyDecoder.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using osu.Framework.Extensions;
diff --git a/osu.Game/Beatmaps/Formats/LegacyDifficultyCalculatorBeatmapDecoder.cs b/osu.Game/Beatmaps/Formats/LegacyDifficultyCalculatorBeatmapDecoder.cs
index 3420fcf260..bf69100361 100644
--- a/osu.Game/Beatmaps/Formats/LegacyDifficultyCalculatorBeatmapDecoder.cs
+++ b/osu.Game/Beatmaps/Formats/LegacyDifficultyCalculatorBeatmapDecoder.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.
 
+#nullable disable
+
 using System.Linq;
 
 namespace osu.Game.Beatmaps.Formats
diff --git a/osu.Game/Beatmaps/Formats/LegacyStoryboardDecoder.cs b/osu.Game/Beatmaps/Formats/LegacyStoryboardDecoder.cs
index 90a96e2ac8..3021688aaf 100644
--- a/osu.Game/Beatmaps/Formats/LegacyStoryboardDecoder.cs
+++ b/osu.Game/Beatmaps/Formats/LegacyStoryboardDecoder.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.IO;
diff --git a/osu.Game/Beatmaps/Formats/Parsing.cs b/osu.Game/Beatmaps/Formats/Parsing.cs
index 4d512fdeed..ce04f27020 100644
--- a/osu.Game/Beatmaps/Formats/Parsing.cs
+++ b/osu.Game/Beatmaps/Formats/Parsing.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.
 
+#nullable disable
+
 using System;
 using System.Globalization;
 
diff --git a/osu.Game/Beatmaps/IBeatSyncProvider.cs b/osu.Game/Beatmaps/IBeatSyncProvider.cs
index cc1cfc3cb5..362f02f2dd 100644
--- a/osu.Game/Beatmaps/IBeatSyncProvider.cs
+++ b/osu.Game/Beatmaps/IBeatSyncProvider.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 enable
-
 using osu.Framework.Allocation;
 using osu.Framework.Audio.Track;
 using osu.Framework.Timing;
diff --git a/osu.Game/Beatmaps/IBeatmap.cs b/osu.Game/Beatmaps/IBeatmap.cs
index dec1ef4294..25b147c267 100644
--- a/osu.Game/Beatmaps/IBeatmap.cs
+++ b/osu.Game/Beatmaps/IBeatmap.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Game.Beatmaps.ControlPoints;
 using osu.Game.Beatmaps.Timing;
diff --git a/osu.Game/Beatmaps/IBeatmapConverter.cs b/osu.Game/Beatmaps/IBeatmapConverter.cs
index 2833af8ca2..f84188c5e2 100644
--- a/osu.Game/Beatmaps/IBeatmapConverter.cs
+++ b/osu.Game/Beatmaps/IBeatmapConverter.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Threading;
diff --git a/osu.Game/Beatmaps/IBeatmapDifficultyInfo.cs b/osu.Game/Beatmaps/IBeatmapDifficultyInfo.cs
index 339364d442..dad9bbbd0b 100644
--- a/osu.Game/Beatmaps/IBeatmapDifficultyInfo.cs
+++ b/osu.Game/Beatmaps/IBeatmapDifficultyInfo.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 enable
-
 namespace osu.Game.Beatmaps
 {
     /// <summary>
diff --git a/osu.Game/Beatmaps/IBeatmapInfo.cs b/osu.Game/Beatmaps/IBeatmapInfo.cs
index ab096b8897..4f2c08f63d 100644
--- a/osu.Game/Beatmaps/IBeatmapInfo.cs
+++ b/osu.Game/Beatmaps/IBeatmapInfo.cs
@@ -5,8 +5,6 @@ using System;
 using osu.Game.Database;
 using osu.Game.Rulesets;
 
-#nullable enable
-
 namespace osu.Game.Beatmaps
 {
     /// <summary>
diff --git a/osu.Game/Beatmaps/IBeatmapMetadataInfo.cs b/osu.Game/Beatmaps/IBeatmapMetadataInfo.cs
index 61adc0ac34..9c96aba85b 100644
--- a/osu.Game/Beatmaps/IBeatmapMetadataInfo.cs
+++ b/osu.Game/Beatmaps/IBeatmapMetadataInfo.cs
@@ -4,8 +4,6 @@
 using System;
 using osu.Game.Users;
 
-#nullable enable
-
 namespace osu.Game.Beatmaps
 {
     /// <summary>
diff --git a/osu.Game/Beatmaps/IBeatmapOnlineInfo.cs b/osu.Game/Beatmaps/IBeatmapOnlineInfo.cs
index 385646eeaa..160b7cf0ae 100644
--- a/osu.Game/Beatmaps/IBeatmapOnlineInfo.cs
+++ b/osu.Game/Beatmaps/IBeatmapOnlineInfo.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 enable
-
 namespace osu.Game.Beatmaps
 {
     /// <summary>
diff --git a/osu.Game/Beatmaps/IBeatmapProcessor.cs b/osu.Game/Beatmaps/IBeatmapProcessor.cs
index 014dccf5e3..0a4a98c606 100644
--- a/osu.Game/Beatmaps/IBeatmapProcessor.cs
+++ b/osu.Game/Beatmaps/IBeatmapProcessor.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.
 
+#nullable disable
+
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Objects;
 
diff --git a/osu.Game/Beatmaps/IBeatmapResourceProvider.cs b/osu.Game/Beatmaps/IBeatmapResourceProvider.cs
index dfea0c7a30..22ff7ce8c8 100644
--- a/osu.Game/Beatmaps/IBeatmapResourceProvider.cs
+++ b/osu.Game/Beatmaps/IBeatmapResourceProvider.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.
 
+#nullable disable
+
 using osu.Framework.Audio.Track;
 using osu.Framework.Graphics.Textures;
 using osu.Game.IO;
diff --git a/osu.Game/Beatmaps/IBeatmapSetInfo.cs b/osu.Game/Beatmaps/IBeatmapSetInfo.cs
index 9755120457..2ecd16cb75 100644
--- a/osu.Game/Beatmaps/IBeatmapSetInfo.cs
+++ b/osu.Game/Beatmaps/IBeatmapSetInfo.cs
@@ -5,8 +5,6 @@ using System;
 using System.Collections.Generic;
 using osu.Game.Database;
 
-#nullable enable
-
 namespace osu.Game.Beatmaps
 {
     /// <summary>
diff --git a/osu.Game/Beatmaps/IBeatmapSetOnlineInfo.cs b/osu.Game/Beatmaps/IBeatmapSetOnlineInfo.cs
index 33d8929008..3f50b4eaf3 100644
--- a/osu.Game/Beatmaps/IBeatmapSetOnlineInfo.cs
+++ b/osu.Game/Beatmaps/IBeatmapSetOnlineInfo.cs
@@ -3,8 +3,6 @@
 
 using System;
 
-#nullable enable
-
 namespace osu.Game.Beatmaps
 {
     /// <summary>
diff --git a/osu.Game/Beatmaps/IWorkingBeatmap.cs b/osu.Game/Beatmaps/IWorkingBeatmap.cs
index 3e2868470a..2188bd6a2b 100644
--- a/osu.Game/Beatmaps/IWorkingBeatmap.cs
+++ b/osu.Game/Beatmaps/IWorkingBeatmap.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.IO;
 using System.Threading;
diff --git a/osu.Game/Beatmaps/IWorkingBeatmapCache.cs b/osu.Game/Beatmaps/IWorkingBeatmapCache.cs
index 3eb33f10d6..ad9cac6957 100644
--- a/osu.Game/Beatmaps/IWorkingBeatmapCache.cs
+++ b/osu.Game/Beatmaps/IWorkingBeatmapCache.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.
 
+#nullable disable
+
 namespace osu.Game.Beatmaps
 {
     public interface IWorkingBeatmapCache
diff --git a/osu.Game/Beatmaps/Legacy/LegacyControlPointInfo.cs b/osu.Game/Beatmaps/Legacy/LegacyControlPointInfo.cs
index 2b0a2e7a4d..19432f0c58 100644
--- a/osu.Game/Beatmaps/Legacy/LegacyControlPointInfo.cs
+++ b/osu.Game/Beatmaps/Legacy/LegacyControlPointInfo.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using JetBrains.Annotations;
 using Newtonsoft.Json;
diff --git a/osu.Game/Beatmaps/Legacy/LegacyEffectFlags.cs b/osu.Game/Beatmaps/Legacy/LegacyEffectFlags.cs
index 5bf80c34d7..b3717c81dc 100644
--- a/osu.Game/Beatmaps/Legacy/LegacyEffectFlags.cs
+++ b/osu.Game/Beatmaps/Legacy/LegacyEffectFlags.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.
 
+#nullable disable
+
 using System;
 
 namespace osu.Game.Beatmaps.Legacy
diff --git a/osu.Game/Beatmaps/Legacy/LegacyEventType.cs b/osu.Game/Beatmaps/Legacy/LegacyEventType.cs
index 32a7122978..42d21d14f6 100644
--- a/osu.Game/Beatmaps/Legacy/LegacyEventType.cs
+++ b/osu.Game/Beatmaps/Legacy/LegacyEventType.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.
 
+#nullable disable
+
 namespace osu.Game.Beatmaps.Legacy
 {
     internal enum LegacyEventType
diff --git a/osu.Game/Beatmaps/Legacy/LegacyHitObjectType.cs b/osu.Game/Beatmaps/Legacy/LegacyHitObjectType.cs
index ec9839b893..ec947c6dc2 100644
--- a/osu.Game/Beatmaps/Legacy/LegacyHitObjectType.cs
+++ b/osu.Game/Beatmaps/Legacy/LegacyHitObjectType.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.
 
+#nullable disable
+
 using System;
 
 namespace osu.Game.Beatmaps.Legacy
diff --git a/osu.Game/Beatmaps/Legacy/LegacyHitSoundType.cs b/osu.Game/Beatmaps/Legacy/LegacyHitSoundType.cs
index d7743565f8..d1782ec862 100644
--- a/osu.Game/Beatmaps/Legacy/LegacyHitSoundType.cs
+++ b/osu.Game/Beatmaps/Legacy/LegacyHitSoundType.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.
 
+#nullable disable
+
 using System;
 
 namespace osu.Game.Beatmaps.Legacy
diff --git a/osu.Game/Beatmaps/Legacy/LegacyMods.cs b/osu.Game/Beatmaps/Legacy/LegacyMods.cs
index 0e517ea3df..27b2e313ec 100644
--- a/osu.Game/Beatmaps/Legacy/LegacyMods.cs
+++ b/osu.Game/Beatmaps/Legacy/LegacyMods.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.
 
+#nullable disable
+
 using System;
 
 namespace osu.Game.Beatmaps.Legacy
diff --git a/osu.Game/Beatmaps/Legacy/LegacyOrigins.cs b/osu.Game/Beatmaps/Legacy/LegacyOrigins.cs
index 31f67d6dfd..62b0edc384 100644
--- a/osu.Game/Beatmaps/Legacy/LegacyOrigins.cs
+++ b/osu.Game/Beatmaps/Legacy/LegacyOrigins.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.
 
+#nullable disable
+
 namespace osu.Game.Beatmaps.Legacy
 {
     internal enum LegacyOrigins
diff --git a/osu.Game/Beatmaps/Legacy/LegacySampleBank.cs b/osu.Game/Beatmaps/Legacy/LegacySampleBank.cs
index 8cac29cb87..f8a57c3ac9 100644
--- a/osu.Game/Beatmaps/Legacy/LegacySampleBank.cs
+++ b/osu.Game/Beatmaps/Legacy/LegacySampleBank.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.
 
+#nullable disable
+
 namespace osu.Game.Beatmaps.Legacy
 {
     internal enum LegacySampleBank
diff --git a/osu.Game/Beatmaps/Legacy/LegacyStoryLayer.cs b/osu.Game/Beatmaps/Legacy/LegacyStoryLayer.cs
index ea23c49c4a..69d0c96b57 100644
--- a/osu.Game/Beatmaps/Legacy/LegacyStoryLayer.cs
+++ b/osu.Game/Beatmaps/Legacy/LegacyStoryLayer.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.
 
+#nullable disable
+
 namespace osu.Game.Beatmaps.Legacy
 {
     internal enum LegacyStoryLayer
diff --git a/osu.Game/Beatmaps/MetadataUtils.cs b/osu.Game/Beatmaps/MetadataUtils.cs
index b27c59b4de..89c821c16c 100644
--- a/osu.Game/Beatmaps/MetadataUtils.cs
+++ b/osu.Game/Beatmaps/MetadataUtils.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 enable
-
 using System.Linq;
 using System.Text;
 
diff --git a/osu.Game/Beatmaps/StarDifficulty.cs b/osu.Game/Beatmaps/StarDifficulty.cs
index f438b6f0bc..91bc3aacf6 100644
--- a/osu.Game/Beatmaps/StarDifficulty.cs
+++ b/osu.Game/Beatmaps/StarDifficulty.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.
 
+#nullable disable
+
 using JetBrains.Annotations;
 using osu.Game.Rulesets.Difficulty;
 
diff --git a/osu.Game/Beatmaps/Timing/BreakPeriod.cs b/osu.Game/Beatmaps/Timing/BreakPeriod.cs
index 4c90b16745..274b56a862 100644
--- a/osu.Game/Beatmaps/Timing/BreakPeriod.cs
+++ b/osu.Game/Beatmaps/Timing/BreakPeriod.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.
 
+#nullable disable
+
 using osu.Game.Screens.Play;
 
 namespace osu.Game.Beatmaps.Timing
diff --git a/osu.Game/Beatmaps/Timing/TimeSignature.cs b/osu.Game/Beatmaps/Timing/TimeSignature.cs
index eebbcc34cd..7499a725dc 100644
--- a/osu.Game/Beatmaps/Timing/TimeSignature.cs
+++ b/osu.Game/Beatmaps/Timing/TimeSignature.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.
 
+#nullable disable
+
 using System;
 
 namespace osu.Game.Beatmaps.Timing
diff --git a/osu.Game/Beatmaps/Timing/TimeSignatures.cs b/osu.Game/Beatmaps/Timing/TimeSignatures.cs
index d783d3f9ec..95c971eebf 100644
--- a/osu.Game/Beatmaps/Timing/TimeSignatures.cs
+++ b/osu.Game/Beatmaps/Timing/TimeSignatures.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.
 
+#nullable disable
+
 using System;
 using System.ComponentModel;
 
diff --git a/osu.Game/Beatmaps/WorkingBeatmap.cs b/osu.Game/Beatmaps/WorkingBeatmap.cs
index 09072ec897..16464932e0 100644
--- a/osu.Game/Beatmaps/WorkingBeatmap.cs
+++ b/osu.Game/Beatmaps/WorkingBeatmap.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Diagnostics;
diff --git a/osu.Game/Beatmaps/WorkingBeatmapCache.cs b/osu.Game/Beatmaps/WorkingBeatmapCache.cs
index bc810ee35e..4495fb8318 100644
--- a/osu.Game/Beatmaps/WorkingBeatmapCache.cs
+++ b/osu.Game/Beatmaps/WorkingBeatmapCache.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.
 
+#nullable disable
+
 using System;
 using System.IO;
 using System.Linq;
diff --git a/osu.Game/Collections/BeatmapCollection.cs b/osu.Game/Collections/BeatmapCollection.cs
index cf95c74b46..23b2ef60dd 100644
--- a/osu.Game/Collections/BeatmapCollection.cs
+++ b/osu.Game/Collections/BeatmapCollection.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Bindables;
 using osu.Game.Beatmaps;
diff --git a/osu.Game/Collections/CollectionFilterDropdown.cs b/osu.Game/Collections/CollectionFilterDropdown.cs
index 100074d186..46d90b930c 100644
--- a/osu.Game/Collections/CollectionFilterDropdown.cs
+++ b/osu.Game/Collections/CollectionFilterDropdown.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.
 
+#nullable disable
+
 using System.Collections.Specialized;
 using System.Diagnostics;
 using System.Linq;
diff --git a/osu.Game/Collections/CollectionFilterMenuItem.cs b/osu.Game/Collections/CollectionFilterMenuItem.cs
index 0617996872..031f05c0b4 100644
--- a/osu.Game/Collections/CollectionFilterMenuItem.cs
+++ b/osu.Game/Collections/CollectionFilterMenuItem.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.
 
+#nullable disable
+
 using System;
 using JetBrains.Annotations;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Collections/CollectionManager.cs b/osu.Game/Collections/CollectionManager.cs
index 104ec4beb2..c6e52a1b75 100644
--- a/osu.Game/Collections/CollectionManager.cs
+++ b/osu.Game/Collections/CollectionManager.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Collections.Specialized;
diff --git a/osu.Game/Collections/DeleteCollectionDialog.cs b/osu.Game/Collections/DeleteCollectionDialog.cs
index e59adb14a6..1da2870913 100644
--- a/osu.Game/Collections/DeleteCollectionDialog.cs
+++ b/osu.Game/Collections/DeleteCollectionDialog.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.
 
+#nullable disable
+
 using System;
 using Humanizer;
 using osu.Framework.Graphics.Sprites;
diff --git a/osu.Game/Collections/DrawableCollectionList.cs b/osu.Game/Collections/DrawableCollectionList.cs
index 3c664a11d9..4fe5733c2f 100644
--- a/osu.Game/Collections/DrawableCollectionList.cs
+++ b/osu.Game/Collections/DrawableCollectionList.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.
 
+#nullable disable
+
 using System.Linq;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Collections/DrawableCollectionListItem.cs b/osu.Game/Collections/DrawableCollectionListItem.cs
index 5064041737..4596fc0e52 100644
--- a/osu.Game/Collections/DrawableCollectionListItem.cs
+++ b/osu.Game/Collections/DrawableCollectionListItem.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Collections/ManageCollectionsDialog.cs b/osu.Game/Collections/ManageCollectionsDialog.cs
index cb350bca33..a9d699bc9f 100644
--- a/osu.Game/Collections/ManageCollectionsDialog.cs
+++ b/osu.Game/Collections/ManageCollectionsDialog.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Configuration/BackgroundSource.cs b/osu.Game/Configuration/BackgroundSource.cs
index 18e0603860..b4a1fd78c3 100644
--- a/osu.Game/Configuration/BackgroundSource.cs
+++ b/osu.Game/Configuration/BackgroundSource.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.
 
+#nullable disable
+
 using System.ComponentModel;
 
 namespace osu.Game.Configuration
diff --git a/osu.Game/Configuration/DatabasedSetting.cs b/osu.Game/Configuration/DatabasedSetting.cs
index 65d9f7799d..0c1b4021a1 100644
--- a/osu.Game/Configuration/DatabasedSetting.cs
+++ b/osu.Game/Configuration/DatabasedSetting.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.
 
+#nullable disable
+
 using System.ComponentModel.DataAnnotations.Schema;
 using osu.Game.Database;
 
diff --git a/osu.Game/Configuration/DevelopmentOsuConfigManager.cs b/osu.Game/Configuration/DevelopmentOsuConfigManager.cs
index ff19dd874c..dda30c1d00 100644
--- a/osu.Game/Configuration/DevelopmentOsuConfigManager.cs
+++ b/osu.Game/Configuration/DevelopmentOsuConfigManager.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.
 
+#nullable disable
+
 using osu.Framework.Platform;
 using osu.Framework.Testing;
 
diff --git a/osu.Game/Configuration/DiscordRichPresenceMode.cs b/osu.Game/Configuration/DiscordRichPresenceMode.cs
index 2e58e3554b..935619920a 100644
--- a/osu.Game/Configuration/DiscordRichPresenceMode.cs
+++ b/osu.Game/Configuration/DiscordRichPresenceMode.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.
 
+#nullable disable
+
 using System.ComponentModel;
 
 namespace osu.Game.Configuration
diff --git a/osu.Game/Configuration/HUDVisibilityMode.cs b/osu.Game/Configuration/HUDVisibilityMode.cs
index 10f3f65355..ec54bfcb71 100644
--- a/osu.Game/Configuration/HUDVisibilityMode.cs
+++ b/osu.Game/Configuration/HUDVisibilityMode.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.
 
+#nullable disable
+
 using System.ComponentModel;
 
 namespace osu.Game.Configuration
diff --git a/osu.Game/Configuration/InMemoryConfigManager.cs b/osu.Game/Configuration/InMemoryConfigManager.cs
index ccf697f680..d8879daa3f 100644
--- a/osu.Game/Configuration/InMemoryConfigManager.cs
+++ b/osu.Game/Configuration/InMemoryConfigManager.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Configuration;
 
diff --git a/osu.Game/Configuration/IntroSequence.cs b/osu.Game/Configuration/IntroSequence.cs
index 5672c44bbe..8327ea2f57 100644
--- a/osu.Game/Configuration/IntroSequence.cs
+++ b/osu.Game/Configuration/IntroSequence.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.
 
+#nullable disable
+
 namespace osu.Game.Configuration
 {
     public enum IntroSequence
diff --git a/osu.Game/Configuration/ModSettingChangeTracker.cs b/osu.Game/Configuration/ModSettingChangeTracker.cs
index e2ade7dc6a..0061746425 100644
--- a/osu.Game/Configuration/ModSettingChangeTracker.cs
+++ b/osu.Game/Configuration/ModSettingChangeTracker.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Configuration/OsuConfigManager.cs b/osu.Game/Configuration/OsuConfigManager.cs
index 20d555c16c..a0e1d9ddc4 100644
--- a/osu.Game/Configuration/OsuConfigManager.cs
+++ b/osu.Game/Configuration/OsuConfigManager.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Diagnostics;
diff --git a/osu.Game/Configuration/RandomSelectAlgorithm.cs b/osu.Game/Configuration/RandomSelectAlgorithm.cs
index b22f2ae485..9a02aaee60 100644
--- a/osu.Game/Configuration/RandomSelectAlgorithm.cs
+++ b/osu.Game/Configuration/RandomSelectAlgorithm.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.
 
+#nullable disable
+
 using System.ComponentModel;
 
 namespace osu.Game.Configuration
diff --git a/osu.Game/Configuration/RealmRulesetSetting.cs b/osu.Game/Configuration/RealmRulesetSetting.cs
index 3fea35ee9d..2e8ccc6b0c 100644
--- a/osu.Game/Configuration/RealmRulesetSetting.cs
+++ b/osu.Game/Configuration/RealmRulesetSetting.cs
@@ -3,8 +3,6 @@
 
 using Realms;
 
-#nullable enable
-
 namespace osu.Game.Configuration
 {
     [MapTo(@"RulesetSetting")]
diff --git a/osu.Game/Configuration/ReleaseStream.cs b/osu.Game/Configuration/ReleaseStream.cs
index ed0bee1dd8..9cdd91bfd0 100644
--- a/osu.Game/Configuration/ReleaseStream.cs
+++ b/osu.Game/Configuration/ReleaseStream.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.
 
+#nullable disable
+
 namespace osu.Game.Configuration
 {
     public enum ReleaseStream
diff --git a/osu.Game/Configuration/ScalingMode.cs b/osu.Game/Configuration/ScalingMode.cs
index 0bcc908f71..25c3692a1a 100644
--- a/osu.Game/Configuration/ScalingMode.cs
+++ b/osu.Game/Configuration/ScalingMode.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.
 
+#nullable disable
+
 using System.ComponentModel;
 
 namespace osu.Game.Configuration
diff --git a/osu.Game/Configuration/ScreenshotFormat.cs b/osu.Game/Configuration/ScreenshotFormat.cs
index 6d4c96bfa9..57c08538b8 100644
--- a/osu.Game/Configuration/ScreenshotFormat.cs
+++ b/osu.Game/Configuration/ScreenshotFormat.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.
 
+#nullable disable
+
 using System.ComponentModel;
 
 namespace osu.Game.Configuration
diff --git a/osu.Game/Configuration/ScrollVisualisationMethod.cs b/osu.Game/Configuration/ScrollVisualisationMethod.cs
index 5f48fe8bfd..111bb95e67 100644
--- a/osu.Game/Configuration/ScrollVisualisationMethod.cs
+++ b/osu.Game/Configuration/ScrollVisualisationMethod.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.
 
+#nullable disable
+
 using System.ComponentModel;
 
 namespace osu.Game.Configuration
diff --git a/osu.Game/Configuration/SeasonalBackgroundMode.cs b/osu.Game/Configuration/SeasonalBackgroundMode.cs
index 6ef835ce5f..909798fe97 100644
--- a/osu.Game/Configuration/SeasonalBackgroundMode.cs
+++ b/osu.Game/Configuration/SeasonalBackgroundMode.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.
 
+#nullable disable
+
 namespace osu.Game.Configuration
 {
     public enum SeasonalBackgroundMode
diff --git a/osu.Game/Configuration/SessionStatics.cs b/osu.Game/Configuration/SessionStatics.cs
index 837ee7e634..12a30a0c84 100644
--- a/osu.Game/Configuration/SessionStatics.cs
+++ b/osu.Game/Configuration/SessionStatics.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.
 
+#nullable disable
+
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays;
diff --git a/osu.Game/Configuration/SettingSourceAttribute.cs b/osu.Game/Configuration/SettingSourceAttribute.cs
index 89f0e73f4f..21e67363c3 100644
--- a/osu.Game/Configuration/SettingSourceAttribute.cs
+++ b/osu.Game/Configuration/SettingSourceAttribute.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 enable
-
 using System;
 using System.Collections.Concurrent;
 using System.Collections.Generic;
diff --git a/osu.Game/Configuration/SettingsStore.cs b/osu.Game/Configuration/SettingsStore.cs
index e5d2d572c8..fda7193fea 100644
--- a/osu.Game/Configuration/SettingsStore.cs
+++ b/osu.Game/Configuration/SettingsStore.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.
 
+#nullable disable
+
 using osu.Game.Database;
 
 namespace osu.Game.Configuration
diff --git a/osu.Game/Configuration/StorageConfigManager.cs b/osu.Game/Configuration/StorageConfigManager.cs
index 90ea42b638..c8781918e1 100644
--- a/osu.Game/Configuration/StorageConfigManager.cs
+++ b/osu.Game/Configuration/StorageConfigManager.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.
 
+#nullable disable
+
 using osu.Framework.Configuration;
 using osu.Framework.Platform;
 
diff --git a/osu.Game/Configuration/ToolbarClockDisplayMode.cs b/osu.Game/Configuration/ToolbarClockDisplayMode.cs
index 2f42f7a9b5..682e221ef8 100644
--- a/osu.Game/Configuration/ToolbarClockDisplayMode.cs
+++ b/osu.Game/Configuration/ToolbarClockDisplayMode.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.
 
+#nullable disable
+
 namespace osu.Game.Configuration
 {
     public enum ToolbarClockDisplayMode
diff --git a/osu.Game/Database/BeatmapLookupCache.cs b/osu.Game/Database/BeatmapLookupCache.cs
index 06edc3e2da..53cb7d72fc 100644
--- a/osu.Game/Database/BeatmapLookupCache.cs
+++ b/osu.Game/Database/BeatmapLookupCache.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using System.Threading;
diff --git a/osu.Game/Database/DatabaseContextFactory.cs b/osu.Game/Database/DatabaseContextFactory.cs
index d222aec6b3..8af649fbfa 100644
--- a/osu.Game/Database/DatabaseContextFactory.cs
+++ b/osu.Game/Database/DatabaseContextFactory.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.
 
+#nullable disable
+
 using System;
 using System.IO;
 using System.Linq;
diff --git a/osu.Game/Database/DatabaseWriteUsage.cs b/osu.Game/Database/DatabaseWriteUsage.cs
index 84c39e3532..b5f25eae20 100644
--- a/osu.Game/Database/DatabaseWriteUsage.cs
+++ b/osu.Game/Database/DatabaseWriteUsage.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 
diff --git a/osu.Game/Database/EFToRealmMigrator.cs b/osu.Game/Database/EFToRealmMigrator.cs
index 2486071c01..896d111989 100644
--- a/osu.Game/Database/EFToRealmMigrator.cs
+++ b/osu.Game/Database/EFToRealmMigrator.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 enable
-
 using System;
 using System.IO;
 using System.Linq;
diff --git a/osu.Game/Database/EmptyRealmSet.cs b/osu.Game/Database/EmptyRealmSet.cs
index b7f27ba035..7db946d79f 100644
--- a/osu.Game/Database/EmptyRealmSet.cs
+++ b/osu.Game/Database/EmptyRealmSet.cs
@@ -9,8 +9,6 @@ using System.ComponentModel;
 using Realms;
 using Realms.Schema;
 
-#nullable enable
-
 namespace osu.Game.Database
 {
     public class EmptyRealmSet<T> : IRealmCollection<T>
diff --git a/osu.Game/Database/ICanAcceptFiles.cs b/osu.Game/Database/ICanAcceptFiles.cs
index 3cec3b8a8e..3ce343249b 100644
--- a/osu.Game/Database/ICanAcceptFiles.cs
+++ b/osu.Game/Database/ICanAcceptFiles.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Threading.Tasks;
 
diff --git a/osu.Game/Database/IDatabaseContextFactory.cs b/osu.Game/Database/IDatabaseContextFactory.cs
index 72b70a208f..bddabad586 100644
--- a/osu.Game/Database/IDatabaseContextFactory.cs
+++ b/osu.Game/Database/IDatabaseContextFactory.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.
 
+#nullable disable
+
 namespace osu.Game.Database
 {
     public interface IDatabaseContextFactory
diff --git a/osu.Game/Database/IHasFiles.cs b/osu.Game/Database/IHasFiles.cs
index 3f6531832f..9f8ce05218 100644
--- a/osu.Game/Database/IHasFiles.cs
+++ b/osu.Game/Database/IHasFiles.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using JetBrains.Annotations;
 
diff --git a/osu.Game/Database/IHasGuidPrimaryKey.cs b/osu.Game/Database/IHasGuidPrimaryKey.cs
index f52dc5c8ef..9cf7cf0683 100644
--- a/osu.Game/Database/IHasGuidPrimaryKey.cs
+++ b/osu.Game/Database/IHasGuidPrimaryKey.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.
 
+#nullable disable
+
 using System;
 using Newtonsoft.Json;
 using Realms;
diff --git a/osu.Game/Database/IHasNamedFiles.cs b/osu.Game/Database/IHasNamedFiles.cs
index 08906aaa08..3524eb4c99 100644
--- a/osu.Game/Database/IHasNamedFiles.cs
+++ b/osu.Game/Database/IHasNamedFiles.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 
 namespace osu.Game.Database
diff --git a/osu.Game/Database/IHasOnlineID.cs b/osu.Game/Database/IHasOnlineID.cs
index 7a720989cd..e703ce58b8 100644
--- a/osu.Game/Database/IHasOnlineID.cs
+++ b/osu.Game/Database/IHasOnlineID.cs
@@ -3,8 +3,6 @@
 
 using System;
 
-#nullable enable
-
 namespace osu.Game.Database
 {
     public interface IHasOnlineID<out T>
diff --git a/osu.Game/Database/IHasPrimaryKey.cs b/osu.Game/Database/IHasPrimaryKey.cs
index 51a49948fe..84709ccd26 100644
--- a/osu.Game/Database/IHasPrimaryKey.cs
+++ b/osu.Game/Database/IHasPrimaryKey.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.
 
+#nullable disable
+
 using System.ComponentModel.DataAnnotations.Schema;
 using Newtonsoft.Json;
 
diff --git a/osu.Game/Database/IHasRealmFiles.cs b/osu.Game/Database/IHasRealmFiles.cs
index 024d9f2a89..2adfe73d1e 100644
--- a/osu.Game/Database/IHasRealmFiles.cs
+++ b/osu.Game/Database/IHasRealmFiles.cs
@@ -4,8 +4,6 @@
 using System.Collections.Generic;
 using osu.Game.Models;
 
-#nullable enable
-
 namespace osu.Game.Database
 {
     /// <summary>
diff --git a/osu.Game/Database/IModelDownloader.cs b/osu.Game/Database/IModelDownloader.cs
index 81fba14244..6f30dd207e 100644
--- a/osu.Game/Database/IModelDownloader.cs
+++ b/osu.Game/Database/IModelDownloader.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.
 
+#nullable disable
+
 using System;
 using osu.Game.Online.API;
 
diff --git a/osu.Game/Database/IModelFileManager.cs b/osu.Game/Database/IModelFileManager.cs
index 390be4a69d..c40b57f663 100644
--- a/osu.Game/Database/IModelFileManager.cs
+++ b/osu.Game/Database/IModelFileManager.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.
 
+#nullable disable
+
 using System.IO;
 
 namespace osu.Game.Database
diff --git a/osu.Game/Database/IModelImporter.cs b/osu.Game/Database/IModelImporter.cs
index b59636e88d..bf9f2f9c75 100644
--- a/osu.Game/Database/IModelImporter.cs
+++ b/osu.Game/Database/IModelImporter.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 enable
-
 using System.Collections.Generic;
 using System.Threading.Tasks;
 using osu.Game.Overlays.Notifications;
diff --git a/osu.Game/Database/IModelManager.cs b/osu.Game/Database/IModelManager.cs
index 187ac86a59..988178818d 100644
--- a/osu.Game/Database/IModelManager.cs
+++ b/osu.Game/Database/IModelManager.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 
 namespace osu.Game.Database
diff --git a/osu.Game/Database/INamedFile.cs b/osu.Game/Database/INamedFile.cs
index 2bd45d4e42..5378d15a75 100644
--- a/osu.Game/Database/INamedFile.cs
+++ b/osu.Game/Database/INamedFile.cs
@@ -3,8 +3,6 @@
 
 using osu.Game.Models;
 
-#nullable enable
-
 namespace osu.Game.Database
 {
     /// <summary>
diff --git a/osu.Game/Database/INamedFileInfo.cs b/osu.Game/Database/INamedFileInfo.cs
index d95f228440..9df4a0869c 100644
--- a/osu.Game/Database/INamedFileInfo.cs
+++ b/osu.Game/Database/INamedFileInfo.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.
 
+#nullable disable
+
 using osu.Game.IO;
 
 namespace osu.Game.Database
diff --git a/osu.Game/Database/INamedFileUsage.cs b/osu.Game/Database/INamedFileUsage.cs
index e558ffe0fb..e2721f17bf 100644
--- a/osu.Game/Database/INamedFileUsage.cs
+++ b/osu.Game/Database/INamedFileUsage.cs
@@ -3,8 +3,6 @@
 
 using osu.Game.IO;
 
-#nullable enable
-
 namespace osu.Game.Database
 {
     /// <summary>
diff --git a/osu.Game/Database/IPostImports.cs b/osu.Game/Database/IPostImports.cs
index 6f047098da..83a211f6e6 100644
--- a/osu.Game/Database/IPostImports.cs
+++ b/osu.Game/Database/IPostImports.cs
@@ -4,8 +4,6 @@
 using System;
 using System.Collections.Generic;
 
-#nullable enable
-
 namespace osu.Game.Database
 {
     public interface IPostImports<TModel>
diff --git a/osu.Game/Database/IPostNotifications.cs b/osu.Game/Database/IPostNotifications.cs
index d4fd64e79e..8bb2c54945 100644
--- a/osu.Game/Database/IPostNotifications.cs
+++ b/osu.Game/Database/IPostNotifications.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.
 
+#nullable disable
+
 using System;
 using osu.Game.Overlays.Notifications;
 
diff --git a/osu.Game/Database/ISoftDelete.cs b/osu.Game/Database/ISoftDelete.cs
index afa42c2002..b07c8db2de 100644
--- a/osu.Game/Database/ISoftDelete.cs
+++ b/osu.Game/Database/ISoftDelete.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.
 
+#nullable disable
+
 namespace osu.Game.Database
 {
     /// <summary>
diff --git a/osu.Game/Database/ImportProgressNotification.cs b/osu.Game/Database/ImportProgressNotification.cs
index aaee3e117f..46f9936bc2 100644
--- a/osu.Game/Database/ImportProgressNotification.cs
+++ b/osu.Game/Database/ImportProgressNotification.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.
 
+#nullable disable
+
 using osu.Game.Overlays.Notifications;
 
 namespace osu.Game.Database
diff --git a/osu.Game/Database/ImportTask.cs b/osu.Game/Database/ImportTask.cs
index e34b4c76a9..0643300fc5 100644
--- a/osu.Game/Database/ImportTask.cs
+++ b/osu.Game/Database/ImportTask.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 enable
-
 using System.IO;
 using osu.Framework.Extensions;
 using osu.Game.IO.Archives;
diff --git a/osu.Game/Database/LegacyBeatmapExporter.cs b/osu.Game/Database/LegacyBeatmapExporter.cs
index fb8ee8f5f5..d064b9ed58 100644
--- a/osu.Game/Database/LegacyBeatmapExporter.cs
+++ b/osu.Game/Database/LegacyBeatmapExporter.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.
 
+#nullable disable
+
 using osu.Framework.Platform;
 using osu.Game.Beatmaps;
 
diff --git a/osu.Game/Database/LegacyBeatmapImporter.cs b/osu.Game/Database/LegacyBeatmapImporter.cs
index 3477312154..6805cb36b8 100644
--- a/osu.Game/Database/LegacyBeatmapImporter.cs
+++ b/osu.Game/Database/LegacyBeatmapImporter.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using osu.Framework.IO.Stores;
diff --git a/osu.Game/Database/LegacyExporter.cs b/osu.Game/Database/LegacyExporter.cs
index 992d1854e7..d9fdc40abc 100644
--- a/osu.Game/Database/LegacyExporter.cs
+++ b/osu.Game/Database/LegacyExporter.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.
 
+#nullable disable
+
 using System.IO;
 using osu.Framework.Platform;
 using osu.Game.Extensions;
diff --git a/osu.Game/Database/LegacyImportManager.cs b/osu.Game/Database/LegacyImportManager.cs
index af9db1b6ec..f40e0d33c2 100644
--- a/osu.Game/Database/LegacyImportManager.cs
+++ b/osu.Game/Database/LegacyImportManager.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Threading;
diff --git a/osu.Game/Database/LegacyModelImporter.cs b/osu.Game/Database/LegacyModelImporter.cs
index 9b2a54dada..df354a856e 100644
--- a/osu.Game/Database/LegacyModelImporter.cs
+++ b/osu.Game/Database/LegacyModelImporter.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using System.Threading.Tasks;
diff --git a/osu.Game/Database/LegacyScoreExporter.cs b/osu.Game/Database/LegacyScoreExporter.cs
index 336f50bc3d..6fa02b957d 100644
--- a/osu.Game/Database/LegacyScoreExporter.cs
+++ b/osu.Game/Database/LegacyScoreExporter.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.
 
+#nullable disable
+
 using System.IO;
 using System.Linq;
 using osu.Framework.Platform;
diff --git a/osu.Game/Database/LegacyScoreImporter.cs b/osu.Game/Database/LegacyScoreImporter.cs
index 131b4ffb0e..f61241141e 100644
--- a/osu.Game/Database/LegacyScoreImporter.cs
+++ b/osu.Game/Database/LegacyScoreImporter.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.IO;
diff --git a/osu.Game/Database/LegacySkinExporter.cs b/osu.Game/Database/LegacySkinExporter.cs
index 9432a1b5fc..1d5364fb8d 100644
--- a/osu.Game/Database/LegacySkinExporter.cs
+++ b/osu.Game/Database/LegacySkinExporter.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.
 
+#nullable disable
+
 using osu.Framework.Platform;
 using osu.Game.Skinning;
 
diff --git a/osu.Game/Database/LegacySkinImporter.cs b/osu.Game/Database/LegacySkinImporter.cs
index 2f05ccae45..42b2f2e1d8 100644
--- a/osu.Game/Database/LegacySkinImporter.cs
+++ b/osu.Game/Database/LegacySkinImporter.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.
 
+#nullable disable
+
 using osu.Game.Skinning;
 
 namespace osu.Game.Database
diff --git a/osu.Game/Database/Live.cs b/osu.Game/Database/Live.cs
index 6256902e17..e9f99e1e44 100644
--- a/osu.Game/Database/Live.cs
+++ b/osu.Game/Database/Live.cs
@@ -3,8 +3,6 @@
 
 using System;
 
-#nullable enable
-
 namespace osu.Game.Database
 {
     /// <summary>
diff --git a/osu.Game/Database/MemoryCachingComponent.cs b/osu.Game/Database/MemoryCachingComponent.cs
index a1a1279d71..6e6d928dcc 100644
--- a/osu.Game/Database/MemoryCachingComponent.cs
+++ b/osu.Game/Database/MemoryCachingComponent.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.
 
+#nullable disable
+
 using System.Collections.Concurrent;
 using System.Threading;
 using System.Threading.Tasks;
diff --git a/osu.Game/Database/ModelDownloader.cs b/osu.Game/Database/ModelDownloader.cs
index 2fa3357b06..76717fd46f 100644
--- a/osu.Game/Database/ModelDownloader.cs
+++ b/osu.Game/Database/ModelDownloader.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Database/ModelManager.cs b/osu.Game/Database/ModelManager.cs
index 795647e94c..e0c3dccf57 100644
--- a/osu.Game/Database/ModelManager.cs
+++ b/osu.Game/Database/ModelManager.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 enable
-
 using System;
 using System.Collections.Generic;
 using System.IO;
diff --git a/osu.Game/Database/OnlineLookupCache.cs b/osu.Game/Database/OnlineLookupCache.cs
index 506103a2c0..317c37bbfb 100644
--- a/osu.Game/Database/OnlineLookupCache.cs
+++ b/osu.Game/Database/OnlineLookupCache.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Database/OsuDbContext.cs b/osu.Game/Database/OsuDbContext.cs
index 79183b6f0e..118a8ee469 100644
--- a/osu.Game/Database/OsuDbContext.cs
+++ b/osu.Game/Database/OsuDbContext.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.
 
+#nullable disable
+
 using System;
 using Microsoft.EntityFrameworkCore;
 using Microsoft.Extensions.Logging;
diff --git a/osu.Game/Database/RealmAccess.cs b/osu.Game/Database/RealmAccess.cs
index b144b70574..865a8b5021 100644
--- a/osu.Game/Database/RealmAccess.cs
+++ b/osu.Game/Database/RealmAccess.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 enable
-
 using System;
 using System.Collections.Generic;
 using System.ComponentModel;
diff --git a/osu.Game/Database/RealmArchiveModelImporter.cs b/osu.Game/Database/RealmArchiveModelImporter.cs
index 32e71c5521..c5e04a8a0f 100644
--- a/osu.Game/Database/RealmArchiveModelImporter.cs
+++ b/osu.Game/Database/RealmArchiveModelImporter.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 enable
-
 using System;
 using System.Collections.Generic;
 using System.IO;
diff --git a/osu.Game/Database/RealmExtensions.cs b/osu.Game/Database/RealmExtensions.cs
index 551b84f7b6..73e9f16d33 100644
--- a/osu.Game/Database/RealmExtensions.cs
+++ b/osu.Game/Database/RealmExtensions.cs
@@ -4,8 +4,6 @@
 using System;
 using Realms;
 
-#nullable enable
-
 namespace osu.Game.Database
 {
     public static class RealmExtensions
diff --git a/osu.Game/Database/RealmFileStore.cs b/osu.Game/Database/RealmFileStore.cs
index 94f04ff0f3..ecb152c45c 100644
--- a/osu.Game/Database/RealmFileStore.cs
+++ b/osu.Game/Database/RealmFileStore.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 enable
-
 using System;
 using System.IO;
 using System.Linq;
diff --git a/osu.Game/Database/RealmLive.cs b/osu.Game/Database/RealmLive.cs
index ecfececaa4..72de747807 100644
--- a/osu.Game/Database/RealmLive.cs
+++ b/osu.Game/Database/RealmLive.cs
@@ -7,8 +7,6 @@ using osu.Framework.Development;
 using osu.Framework.Statistics;
 using Realms;
 
-#nullable enable
-
 namespace osu.Game.Database
 {
     /// <summary>
diff --git a/osu.Game/Database/RealmLiveUnmanaged.cs b/osu.Game/Database/RealmLiveUnmanaged.cs
index 1080f3b8c7..5ab66cac7b 100644
--- a/osu.Game/Database/RealmLiveUnmanaged.cs
+++ b/osu.Game/Database/RealmLiveUnmanaged.cs
@@ -4,8 +4,6 @@
 using System;
 using Realms;
 
-#nullable enable
-
 namespace osu.Game.Database
 {
     /// <summary>
diff --git a/osu.Game/Database/RealmObjectExtensions.cs b/osu.Game/Database/RealmObjectExtensions.cs
index 6dc18df9e0..25416c7fa2 100644
--- a/osu.Game/Database/RealmObjectExtensions.cs
+++ b/osu.Game/Database/RealmObjectExtensions.cs
@@ -14,8 +14,6 @@ using osu.Game.Rulesets;
 using osu.Game.Scoring;
 using Realms;
 
-#nullable enable
-
 namespace osu.Game.Database
 {
     public static class RealmObjectExtensions
diff --git a/osu.Game/Database/UserLookupCache.cs b/osu.Game/Database/UserLookupCache.cs
index 5fdd80892d..87f08d36ae 100644
--- a/osu.Game/Database/UserLookupCache.cs
+++ b/osu.Game/Database/UserLookupCache.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using System.Threading;
diff --git a/osu.Game/Extensions/CollectionExtensions.cs b/osu.Game/Extensions/CollectionExtensions.cs
index 473dc4b8f4..c573d169f1 100644
--- a/osu.Game/Extensions/CollectionExtensions.cs
+++ b/osu.Game/Extensions/CollectionExtensions.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 
 namespace osu.Game.Extensions
diff --git a/osu.Game/Extensions/DrawableExtensions.cs b/osu.Game/Extensions/DrawableExtensions.cs
index d1aba2bfe3..c2c00e342b 100644
--- a/osu.Game/Extensions/DrawableExtensions.cs
+++ b/osu.Game/Extensions/DrawableExtensions.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.
 
+#nullable disable
+
 using Humanizer;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Extensions/LanguageExtensions.cs b/osu.Game/Extensions/LanguageExtensions.cs
index b67e7fb6fc..3b1e9c7719 100644
--- a/osu.Game/Extensions/LanguageExtensions.cs
+++ b/osu.Game/Extensions/LanguageExtensions.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.
 
+#nullable disable
+
 using System;
 using System.Globalization;
 using osu.Game.Localisation;
diff --git a/osu.Game/Extensions/ModelExtensions.cs b/osu.Game/Extensions/ModelExtensions.cs
index 13c25e45c8..b10071bb45 100644
--- a/osu.Game/Extensions/ModelExtensions.cs
+++ b/osu.Game/Extensions/ModelExtensions.cs
@@ -11,8 +11,6 @@ using osu.Game.Rulesets;
 using osu.Game.Scoring;
 using osu.Game.Users;
 
-#nullable enable
-
 namespace osu.Game.Extensions
 {
     public static class ModelExtensions
diff --git a/osu.Game/Extensions/TaskExtensions.cs b/osu.Game/Extensions/TaskExtensions.cs
index 17f1a491f8..5165ae59b5 100644
--- a/osu.Game/Extensions/TaskExtensions.cs
+++ b/osu.Game/Extensions/TaskExtensions.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 enable
-
 using System;
 using System.Threading;
 using System.Threading.Tasks;
diff --git a/osu.Game/Extensions/TimeDisplayExtensions.cs b/osu.Game/Extensions/TimeDisplayExtensions.cs
index 98633958ee..94871233ed 100644
--- a/osu.Game/Extensions/TimeDisplayExtensions.cs
+++ b/osu.Game/Extensions/TimeDisplayExtensions.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.
 
+#nullable disable
+
 using System;
 using Humanizer;
 using osu.Framework.Extensions.LocalisationExtensions;
diff --git a/osu.Game/Extensions/TypeExtensions.cs b/osu.Game/Extensions/TypeExtensions.cs
index 2e93c81758..6f160b0479 100644
--- a/osu.Game/Extensions/TypeExtensions.cs
+++ b/osu.Game/Extensions/TypeExtensions.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 
diff --git a/osu.Game/Extensions/WebRequestExtensions.cs b/osu.Game/Extensions/WebRequestExtensions.cs
index 50837a648d..79115c6023 100644
--- a/osu.Game/Extensions/WebRequestExtensions.cs
+++ b/osu.Game/Extensions/WebRequestExtensions.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.
 
+#nullable disable
+
 using System.Globalization;
 using Newtonsoft.Json.Linq;
 using osu.Framework.IO.Network;
diff --git a/osu.Game/Graphics/Backgrounds/Background.cs b/osu.Game/Graphics/Backgrounds/Background.cs
index b09ec1d9b9..2dd96bcb09 100644
--- a/osu.Game/Graphics/Backgrounds/Background.cs
+++ b/osu.Game/Graphics/Backgrounds/Background.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.
 
+#nullable disable
+
 using System;
 using System.Diagnostics;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Graphics/Backgrounds/BeatmapBackground.cs b/osu.Game/Graphics/Backgrounds/BeatmapBackground.cs
index e0c15dd52a..543bfe2bac 100644
--- a/osu.Game/Graphics/Backgrounds/BeatmapBackground.cs
+++ b/osu.Game/Graphics/Backgrounds/BeatmapBackground.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics.Textures;
 using osu.Game.Beatmaps;
diff --git a/osu.Game/Graphics/Backgrounds/BeatmapBackgroundWithStoryboard.cs b/osu.Game/Graphics/Backgrounds/BeatmapBackgroundWithStoryboard.cs
index 7aed442800..0dcfa4e9aa 100644
--- a/osu.Game/Graphics/Backgrounds/BeatmapBackgroundWithStoryboard.cs
+++ b/osu.Game/Graphics/Backgrounds/BeatmapBackgroundWithStoryboard.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 enable
-
 using System.Collections.Generic;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Graphics/Backgrounds/SeasonalBackgroundLoader.cs b/osu.Game/Graphics/Backgrounds/SeasonalBackgroundLoader.cs
index f01a26a3a8..f2caf10e91 100644
--- a/osu.Game/Graphics/Backgrounds/SeasonalBackgroundLoader.cs
+++ b/osu.Game/Graphics/Backgrounds/SeasonalBackgroundLoader.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Graphics/Backgrounds/SkinBackground.cs b/osu.Game/Graphics/Backgrounds/SkinBackground.cs
index 9266e7b17b..e4bf3b94c5 100644
--- a/osu.Game/Graphics/Backgrounds/SkinBackground.cs
+++ b/osu.Game/Graphics/Backgrounds/SkinBackground.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Game.Skinning;
 
diff --git a/osu.Game/Graphics/Backgrounds/Triangles.cs b/osu.Game/Graphics/Backgrounds/Triangles.cs
index 450c93f37c..b83df45bd7 100644
--- a/osu.Game/Graphics/Backgrounds/Triangles.cs
+++ b/osu.Game/Graphics/Backgrounds/Triangles.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Utils;
 using osuTK;
diff --git a/osu.Game/Graphics/Containers/BeatSyncedContainer.cs b/osu.Game/Graphics/Containers/BeatSyncedContainer.cs
index 953731244d..4146bbcc5e 100644
--- a/osu.Game/Graphics/Containers/BeatSyncedContainer.cs
+++ b/osu.Game/Graphics/Containers/BeatSyncedContainer.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.
 
+#nullable disable
+
 using System;
 using System.Diagnostics;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Graphics/Containers/ConstrainedIconContainer.cs b/osu.Game/Graphics/Containers/ConstrainedIconContainer.cs
index 9e1af1944c..f34a856707 100644
--- a/osu.Game/Graphics/Containers/ConstrainedIconContainer.cs
+++ b/osu.Game/Graphics/Containers/ConstrainedIconContainer.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Graphics/Containers/ExpandingButtonContainer.cs b/osu.Game/Graphics/Containers/ExpandingButtonContainer.cs
index 859850e771..f66afb27c4 100644
--- a/osu.Game/Graphics/Containers/ExpandingButtonContainer.cs
+++ b/osu.Game/Graphics/Containers/ExpandingButtonContainer.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.
 
+#nullable disable
+
 namespace osu.Game.Graphics.Containers
 {
     /// <summary>
diff --git a/osu.Game/Graphics/Containers/ExpandingContainer.cs b/osu.Game/Graphics/Containers/ExpandingContainer.cs
index b50e008362..debc068220 100644
--- a/osu.Game/Graphics/Containers/ExpandingContainer.cs
+++ b/osu.Game/Graphics/Containers/ExpandingContainer.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.
 
+#nullable disable
+
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Graphics/Containers/HoldToConfirmContainer.cs b/osu.Game/Graphics/Containers/HoldToConfirmContainer.cs
index 28afd082c3..7d38478b81 100644
--- a/osu.Game/Graphics/Containers/HoldToConfirmContainer.cs
+++ b/osu.Game/Graphics/Containers/HoldToConfirmContainer.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Graphics/Containers/IExpandable.cs b/osu.Game/Graphics/Containers/IExpandable.cs
index 593564a2f9..05d569775c 100644
--- a/osu.Game/Graphics/Containers/IExpandable.cs
+++ b/osu.Game/Graphics/Containers/IExpandable.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.
 
+#nullable disable
+
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 
diff --git a/osu.Game/Graphics/Containers/IExpandingContainer.cs b/osu.Game/Graphics/Containers/IExpandingContainer.cs
index eb186c96a8..dbd9274ae7 100644
--- a/osu.Game/Graphics/Containers/IExpandingContainer.cs
+++ b/osu.Game/Graphics/Containers/IExpandingContainer.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics.Containers;
 
diff --git a/osu.Game/Graphics/Containers/LinkFlowContainer.cs b/osu.Game/Graphics/Containers/LinkFlowContainer.cs
index 1d286d3487..a67e5ae66f 100644
--- a/osu.Game/Graphics/Containers/LinkFlowContainer.cs
+++ b/osu.Game/Graphics/Containers/LinkFlowContainer.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.
 
+#nullable disable
+
 using osu.Game.Online.Chat;
 using System;
 using System.Linq;
diff --git a/osu.Game/Graphics/Containers/LogoTrackingContainer.cs b/osu.Game/Graphics/Containers/LogoTrackingContainer.cs
index f89f3a5e76..bf8d70a200 100644
--- a/osu.Game/Graphics/Containers/LogoTrackingContainer.cs
+++ b/osu.Game/Graphics/Containers/LogoTrackingContainer.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Graphics/Containers/Markdown/OsuMarkdownContainer.cs b/osu.Game/Graphics/Containers/Markdown/OsuMarkdownContainer.cs
index 296c600771..aa156efee9 100644
--- a/osu.Game/Graphics/Containers/Markdown/OsuMarkdownContainer.cs
+++ b/osu.Game/Graphics/Containers/Markdown/OsuMarkdownContainer.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.
 
+#nullable disable
+
 using Markdig;
 using Markdig.Extensions.AutoIdentifiers;
 using Markdig.Extensions.Tables;
diff --git a/osu.Game/Graphics/Containers/Markdown/OsuMarkdownFencedCodeBlock.cs b/osu.Game/Graphics/Containers/Markdown/OsuMarkdownFencedCodeBlock.cs
index 0d67849060..fc7401046f 100644
--- a/osu.Game/Graphics/Containers/Markdown/OsuMarkdownFencedCodeBlock.cs
+++ b/osu.Game/Graphics/Containers/Markdown/OsuMarkdownFencedCodeBlock.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.
 
+#nullable disable
+
 using Markdig.Syntax;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Graphics/Containers/Markdown/OsuMarkdownHeading.cs b/osu.Game/Graphics/Containers/Markdown/OsuMarkdownHeading.cs
index e4685a2935..0c70952222 100644
--- a/osu.Game/Graphics/Containers/Markdown/OsuMarkdownHeading.cs
+++ b/osu.Game/Graphics/Containers/Markdown/OsuMarkdownHeading.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.
 
+#nullable disable
+
 using Markdig.Syntax;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers.Markdown;
diff --git a/osu.Game/Graphics/Containers/Markdown/OsuMarkdownImage.cs b/osu.Game/Graphics/Containers/Markdown/OsuMarkdownImage.cs
index ce8a9c8f9f..9ad501fdff 100644
--- a/osu.Game/Graphics/Containers/Markdown/OsuMarkdownImage.cs
+++ b/osu.Game/Graphics/Containers/Markdown/OsuMarkdownImage.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.
 
+#nullable disable
+
 using Markdig.Syntax.Inlines;
 using osu.Framework.Graphics.Containers.Markdown;
 using osu.Framework.Graphics.Cursor;
diff --git a/osu.Game/Graphics/Containers/Markdown/OsuMarkdownLinkText.cs b/osu.Game/Graphics/Containers/Markdown/OsuMarkdownLinkText.cs
index 82e556f653..dca9e3de6e 100644
--- a/osu.Game/Graphics/Containers/Markdown/OsuMarkdownLinkText.cs
+++ b/osu.Game/Graphics/Containers/Markdown/OsuMarkdownLinkText.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using Markdig.Syntax.Inlines;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Graphics/Containers/Markdown/OsuMarkdownListItem.cs b/osu.Game/Graphics/Containers/Markdown/OsuMarkdownListItem.cs
index 8c4c3e1da2..153c4f9f93 100644
--- a/osu.Game/Graphics/Containers/Markdown/OsuMarkdownListItem.cs
+++ b/osu.Game/Graphics/Containers/Markdown/OsuMarkdownListItem.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Graphics/Containers/Markdown/OsuMarkdownOrderedListItem.cs b/osu.Game/Graphics/Containers/Markdown/OsuMarkdownOrderedListItem.cs
index 8fedb189b2..116a8e2872 100644
--- a/osu.Game/Graphics/Containers/Markdown/OsuMarkdownOrderedListItem.cs
+++ b/osu.Game/Graphics/Containers/Markdown/OsuMarkdownOrderedListItem.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Sprites;
 
diff --git a/osu.Game/Graphics/Containers/Markdown/OsuMarkdownQuoteBlock.cs b/osu.Game/Graphics/Containers/Markdown/OsuMarkdownQuoteBlock.cs
index 9935c81537..3ef67df7a9 100644
--- a/osu.Game/Graphics/Containers/Markdown/OsuMarkdownQuoteBlock.cs
+++ b/osu.Game/Graphics/Containers/Markdown/OsuMarkdownQuoteBlock.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.
 
+#nullable disable
+
 using Markdig.Syntax;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Graphics/Containers/Markdown/OsuMarkdownSeparator.cs b/osu.Game/Graphics/Containers/Markdown/OsuMarkdownSeparator.cs
index 28a87c9f21..abbc10a7e2 100644
--- a/osu.Game/Graphics/Containers/Markdown/OsuMarkdownSeparator.cs
+++ b/osu.Game/Graphics/Containers/Markdown/OsuMarkdownSeparator.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers.Markdown;
diff --git a/osu.Game/Graphics/Containers/Markdown/OsuMarkdownTable.cs b/osu.Game/Graphics/Containers/Markdown/OsuMarkdownTable.cs
index e0a1ab1220..ee851045f9 100644
--- a/osu.Game/Graphics/Containers/Markdown/OsuMarkdownTable.cs
+++ b/osu.Game/Graphics/Containers/Markdown/OsuMarkdownTable.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.
 
+#nullable disable
+
 using Markdig.Extensions.Tables;
 using osu.Framework.Graphics.Containers.Markdown;
 
diff --git a/osu.Game/Graphics/Containers/Markdown/OsuMarkdownTableCell.cs b/osu.Game/Graphics/Containers/Markdown/OsuMarkdownTableCell.cs
index ac7d07e283..3863beb133 100644
--- a/osu.Game/Graphics/Containers/Markdown/OsuMarkdownTableCell.cs
+++ b/osu.Game/Graphics/Containers/Markdown/OsuMarkdownTableCell.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.
 
+#nullable disable
+
 using Markdig.Extensions.Tables;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Graphics/Containers/Markdown/OsuMarkdownTextFlowContainer.cs b/osu.Game/Graphics/Containers/Markdown/OsuMarkdownTextFlowContainer.cs
index a7cd6b3905..db8abfb269 100644
--- a/osu.Game/Graphics/Containers/Markdown/OsuMarkdownTextFlowContainer.cs
+++ b/osu.Game/Graphics/Containers/Markdown/OsuMarkdownTextFlowContainer.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.
 
+#nullable disable
+
 using Markdig.Syntax.Inlines;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Graphics/Containers/Markdown/OsuMarkdownUnorderedListItem.cs b/osu.Game/Graphics/Containers/Markdown/OsuMarkdownUnorderedListItem.cs
index 5d1e114781..f8e8571557 100644
--- a/osu.Game/Graphics/Containers/Markdown/OsuMarkdownUnorderedListItem.cs
+++ b/osu.Game/Graphics/Containers/Markdown/OsuMarkdownUnorderedListItem.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Sprites;
 
diff --git a/osu.Game/Graphics/Containers/OsuClickableContainer.cs b/osu.Game/Graphics/Containers/OsuClickableContainer.cs
index bf397e4251..61ec9dfc24 100644
--- a/osu.Game/Graphics/Containers/OsuClickableContainer.cs
+++ b/osu.Game/Graphics/Containers/OsuClickableContainer.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Graphics/Containers/OsuFocusedOverlayContainer.cs b/osu.Game/Graphics/Containers/OsuFocusedOverlayContainer.cs
index 512602d120..e8a0c0cd25 100644
--- a/osu.Game/Graphics/Containers/OsuFocusedOverlayContainer.cs
+++ b/osu.Game/Graphics/Containers/OsuFocusedOverlayContainer.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
 using osu.Framework.Audio.Sample;
diff --git a/osu.Game/Graphics/Containers/OsuHoverContainer.cs b/osu.Game/Graphics/Containers/OsuHoverContainer.cs
index ac66fd658a..93205e0d03 100644
--- a/osu.Game/Graphics/Containers/OsuHoverContainer.cs
+++ b/osu.Game/Graphics/Containers/OsuHoverContainer.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.IEnumerableExtensions;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Graphics/Containers/OsuRearrangeableListContainer.cs b/osu.Game/Graphics/Containers/OsuRearrangeableListContainer.cs
index 1048fd094c..84d0d1eb32 100644
--- a/osu.Game/Graphics/Containers/OsuRearrangeableListContainer.cs
+++ b/osu.Game/Graphics/Containers/OsuRearrangeableListContainer.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.
 
+#nullable disable
+
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Graphics/Containers/OsuRearrangeableListItem.cs b/osu.Game/Graphics/Containers/OsuRearrangeableListItem.cs
index d43c3a608b..e6183ea837 100644
--- a/osu.Game/Graphics/Containers/OsuRearrangeableListItem.cs
+++ b/osu.Game/Graphics/Containers/OsuRearrangeableListItem.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Graphics/Containers/OsuScrollContainer.cs b/osu.Game/Graphics/Containers/OsuScrollContainer.cs
index 817b8409e6..7e5d5e53d3 100644
--- a/osu.Game/Graphics/Containers/OsuScrollContainer.cs
+++ b/osu.Game/Graphics/Containers/OsuScrollContainer.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 enable
-
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Graphics/Containers/OsuTextFlowContainer.cs b/osu.Game/Graphics/Containers/OsuTextFlowContainer.cs
index b8237832a3..5cdccee01d 100644
--- a/osu.Game/Graphics/Containers/OsuTextFlowContainer.cs
+++ b/osu.Game/Graphics/Containers/OsuTextFlowContainer.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Extensions.IEnumerableExtensions;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Graphics/Containers/ParallaxContainer.cs b/osu.Game/Graphics/Containers/ParallaxContainer.cs
index b501e68ba1..f70abc16dd 100644
--- a/osu.Game/Graphics/Containers/ParallaxContainer.cs
+++ b/osu.Game/Graphics/Containers/ParallaxContainer.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Graphics/Containers/ReverseChildIDFillFlowContainer.cs b/osu.Game/Graphics/Containers/ReverseChildIDFillFlowContainer.cs
index 6360e41bef..db265d6d64 100644
--- a/osu.Game/Graphics/Containers/ReverseChildIDFillFlowContainer.cs
+++ b/osu.Game/Graphics/Containers/ReverseChildIDFillFlowContainer.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 
diff --git a/osu.Game/Graphics/Containers/ScalingContainer.cs b/osu.Game/Graphics/Containers/ScalingContainer.cs
index 5c6e315225..5c8579a144 100644
--- a/osu.Game/Graphics/Containers/ScalingContainer.cs
+++ b/osu.Game/Graphics/Containers/ScalingContainer.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Graphics/Containers/SectionsContainer.cs b/osu.Game/Graphics/Containers/SectionsContainer.cs
index 6ad538959e..c04a5add89 100644
--- a/osu.Game/Graphics/Containers/SectionsContainer.cs
+++ b/osu.Game/Graphics/Containers/SectionsContainer.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.
 
+#nullable disable
+
 using System;
 using System.Diagnostics;
 using System.Linq;
diff --git a/osu.Game/Graphics/Containers/SelectionCycleFillFlowContainer.cs b/osu.Game/Graphics/Containers/SelectionCycleFillFlowContainer.cs
index 4ddaa09be6..94505d2310 100644
--- a/osu.Game/Graphics/Containers/SelectionCycleFillFlowContainer.cs
+++ b/osu.Game/Graphics/Containers/SelectionCycleFillFlowContainer.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.
 
+#nullable disable
+
 using System;
 using System.Diagnostics;
 using osu.Framework;
diff --git a/osu.Game/Graphics/Containers/ShakeContainer.cs b/osu.Game/Graphics/Containers/ShakeContainer.cs
index 8a0ce287db..7b6fc22cc0 100644
--- a/osu.Game/Graphics/Containers/ShakeContainer.cs
+++ b/osu.Game/Graphics/Containers/ShakeContainer.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.
 
+#nullable disable
+
 using osu.Framework.Graphics.Containers;
 using osu.Game.Extensions;
 
diff --git a/osu.Game/Graphics/Containers/UserDimContainer.cs b/osu.Game/Graphics/Containers/UserDimContainer.cs
index 4e555ac1eb..d52fb7c60a 100644
--- a/osu.Game/Graphics/Containers/UserDimContainer.cs
+++ b/osu.Game/Graphics/Containers/UserDimContainer.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Graphics/Containers/UserTrackingScrollContainer.cs b/osu.Game/Graphics/Containers/UserTrackingScrollContainer.cs
index 44afaf77ea..2bb9d7261d 100644
--- a/osu.Game/Graphics/Containers/UserTrackingScrollContainer.cs
+++ b/osu.Game/Graphics/Containers/UserTrackingScrollContainer.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 
 namespace osu.Game.Graphics.Containers
diff --git a/osu.Game/Graphics/Containers/WaveContainer.cs b/osu.Game/Graphics/Containers/WaveContainer.cs
index 8b87ddaa20..ba85ef0aab 100644
--- a/osu.Game/Graphics/Containers/WaveContainer.cs
+++ b/osu.Game/Graphics/Containers/WaveContainer.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Graphics/Cursor/IProvideCursor.cs b/osu.Game/Graphics/Cursor/IProvideCursor.cs
index 3a920ba976..9f01e5da6d 100644
--- a/osu.Game/Graphics/Cursor/IProvideCursor.cs
+++ b/osu.Game/Graphics/Cursor/IProvideCursor.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Cursor;
 
diff --git a/osu.Game/Graphics/Cursor/MenuCursor.cs b/osu.Game/Graphics/Cursor/MenuCursor.cs
index 03fad00e41..4544633318 100644
--- a/osu.Game/Graphics/Cursor/MenuCursor.cs
+++ b/osu.Game/Graphics/Cursor/MenuCursor.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.
 
+#nullable disable
+
 using osuTK;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Graphics/Cursor/MenuCursorContainer.cs b/osu.Game/Graphics/Cursor/MenuCursorContainer.cs
index 4c7f7957e9..746f1b5d5e 100644
--- a/osu.Game/Graphics/Cursor/MenuCursorContainer.cs
+++ b/osu.Game/Graphics/Cursor/MenuCursorContainer.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Cursor;
diff --git a/osu.Game/Graphics/Cursor/OsuContextMenuContainer.cs b/osu.Game/Graphics/Cursor/OsuContextMenuContainer.cs
index 171ad4ee65..fbaefe24b0 100644
--- a/osu.Game/Graphics/Cursor/OsuContextMenuContainer.cs
+++ b/osu.Game/Graphics/Cursor/OsuContextMenuContainer.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics.Cursor;
 using osu.Framework.Graphics.UserInterface;
diff --git a/osu.Game/Graphics/Cursor/OsuTooltipContainer.cs b/osu.Game/Graphics/Cursor/OsuTooltipContainer.cs
index 35d7b4e795..8bf4dfcd24 100644
--- a/osu.Game/Graphics/Cursor/OsuTooltipContainer.cs
+++ b/osu.Game/Graphics/Cursor/OsuTooltipContainer.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.
 
+#nullable disable
+
 using osuTK;
 using osuTK.Graphics;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Graphics/DateTooltip.cs b/osu.Game/Graphics/DateTooltip.cs
index 2dca8719e9..77bf78b213 100644
--- a/osu.Game/Graphics/DateTooltip.cs
+++ b/osu.Game/Graphics/DateTooltip.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Graphics/DrawableDate.cs b/osu.Game/Graphics/DrawableDate.cs
index 567a39b4f4..0008d0fcaa 100644
--- a/osu.Game/Graphics/DrawableDate.cs
+++ b/osu.Game/Graphics/DrawableDate.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Graphics/ErrorTextFlowContainer.cs b/osu.Game/Graphics/ErrorTextFlowContainer.cs
index dafc363973..0d47245e8c 100644
--- a/osu.Game/Graphics/ErrorTextFlowContainer.cs
+++ b/osu.Game/Graphics/ErrorTextFlowContainer.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Graphics.Containers;
diff --git a/osu.Game/Graphics/IHasAccentColour.cs b/osu.Game/Graphics/IHasAccentColour.cs
index af497da70f..fc722375ce 100644
--- a/osu.Game/Graphics/IHasAccentColour.cs
+++ b/osu.Game/Graphics/IHasAccentColour.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.
 
+#nullable disable
+
 using osuTK.Graphics;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Transforms;
diff --git a/osu.Game/Graphics/InputBlockingContainer.cs b/osu.Game/Graphics/InputBlockingContainer.cs
index d8387b1401..66caa57c1a 100644
--- a/osu.Game/Graphics/InputBlockingContainer.cs
+++ b/osu.Game/Graphics/InputBlockingContainer.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.
 
-#nullable enable
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Input.Events;
 
diff --git a/osu.Game/Graphics/OpenGL/Vertices/PositionAndColourVertex.cs b/osu.Game/Graphics/OpenGL/Vertices/PositionAndColourVertex.cs
index 8714138322..a53b665857 100644
--- a/osu.Game/Graphics/OpenGL/Vertices/PositionAndColourVertex.cs
+++ b/osu.Game/Graphics/OpenGL/Vertices/PositionAndColourVertex.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.
 
+#nullable disable
+
 using System;
 using System.Runtime.InteropServices;
 using osu.Framework.Graphics.OpenGL.Vertices;
diff --git a/osu.Game/Graphics/OsuColour.cs b/osu.Game/Graphics/OsuColour.cs
index 7fd94b57f3..0e411876d3 100644
--- a/osu.Game/Graphics/OsuColour.cs
+++ b/osu.Game/Graphics/OsuColour.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Game.Beatmaps;
diff --git a/osu.Game/Graphics/OsuFont.cs b/osu.Game/Graphics/OsuFont.cs
index 9d4e97b88e..038ea0f5d7 100644
--- a/osu.Game/Graphics/OsuFont.cs
+++ b/osu.Game/Graphics/OsuFont.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.
 
+#nullable disable
+
 using osu.Framework.Graphics.Sprites;
 
 namespace osu.Game.Graphics
diff --git a/osu.Game/Graphics/OsuIcon.cs b/osu.Game/Graphics/OsuIcon.cs
index e8267edab0..0a099f1fcc 100644
--- a/osu.Game/Graphics/OsuIcon.cs
+++ b/osu.Game/Graphics/OsuIcon.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.
 
+#nullable disable
+
 using osu.Framework.Graphics.Sprites;
 
 namespace osu.Game.Graphics
diff --git a/osu.Game/Graphics/ParticleExplosion.cs b/osu.Game/Graphics/ParticleExplosion.cs
index ec1077eb81..c6f9c1343b 100644
--- a/osu.Game/Graphics/ParticleExplosion.cs
+++ b/osu.Game/Graphics/ParticleExplosion.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Graphics/ParticleSpewer.cs b/osu.Game/Graphics/ParticleSpewer.cs
index 369a4b21c7..06c9882d72 100644
--- a/osu.Game/Graphics/ParticleSpewer.cs
+++ b/osu.Game/Graphics/ParticleSpewer.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Bindables;
 using osu.Framework.Extensions.EnumExtensions;
diff --git a/osu.Game/Graphics/ScreenshotManager.cs b/osu.Game/Graphics/ScreenshotManager.cs
index 53f7d5791b..7147f89dd0 100644
--- a/osu.Game/Graphics/ScreenshotManager.cs
+++ b/osu.Game/Graphics/ScreenshotManager.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.
 
+#nullable disable
+
 using System;
 using System.Threading;
 using System.Threading.Tasks;
diff --git a/osu.Game/Graphics/Sprites/GlowingSpriteText.cs b/osu.Game/Graphics/Sprites/GlowingSpriteText.cs
index 9c43383a29..dca6b7158b 100644
--- a/osu.Game/Graphics/Sprites/GlowingSpriteText.cs
+++ b/osu.Game/Graphics/Sprites/GlowingSpriteText.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.
 
+#nullable disable
+
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Colour;
diff --git a/osu.Game/Graphics/Sprites/LogoAnimation.cs b/osu.Game/Graphics/Sprites/LogoAnimation.cs
index 36fcd39b54..13733bb3ad 100644
--- a/osu.Game/Graphics/Sprites/LogoAnimation.cs
+++ b/osu.Game/Graphics/Sprites/LogoAnimation.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Graphics/Sprites/OsuSpriteText.cs b/osu.Game/Graphics/Sprites/OsuSpriteText.cs
index 76e46513ba..a46ed27b9b 100644
--- a/osu.Game/Graphics/Sprites/OsuSpriteText.cs
+++ b/osu.Game/Graphics/Sprites/OsuSpriteText.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.
 
+#nullable disable
+
 using osu.Framework.Graphics.Sprites;
 
 namespace osu.Game.Graphics.Sprites
diff --git a/osu.Game/Graphics/UserInterface/BackButton.cs b/osu.Game/Graphics/UserInterface/BackButton.cs
index 2b59ee0282..d2ed71dfc6 100644
--- a/osu.Game/Graphics/UserInterface/BackButton.cs
+++ b/osu.Game/Graphics/UserInterface/BackButton.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Graphics/UserInterface/Bar.cs b/osu.Game/Graphics/UserInterface/Bar.cs
index 0be928cf83..3c87b166ac 100644
--- a/osu.Game/Graphics/UserInterface/Bar.cs
+++ b/osu.Game/Graphics/UserInterface/Bar.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.
 
+#nullable disable
+
 using System;
 using osuTK;
 using osuTK.Graphics;
diff --git a/osu.Game/Graphics/UserInterface/BarGraph.cs b/osu.Game/Graphics/UserInterface/BarGraph.cs
index 407bf6a923..00ed6c1c92 100644
--- a/osu.Game/Graphics/UserInterface/BarGraph.cs
+++ b/osu.Game/Graphics/UserInterface/BarGraph.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.
 
+#nullable disable
+
 using osuTK;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Graphics/UserInterface/BasicSearchTextBox.cs b/osu.Game/Graphics/UserInterface/BasicSearchTextBox.cs
index aa101d7e08..e0efa1d81c 100644
--- a/osu.Game/Graphics/UserInterface/BasicSearchTextBox.cs
+++ b/osu.Game/Graphics/UserInterface/BasicSearchTextBox.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Sprites;
 using osuTK;
@@ -23,4 +25,4 @@ namespace osu.Game.Graphics.UserInterface
             TextFlow.Padding = new MarginPadding { Right = 35 };
         }
     }
-}
\ No newline at end of file
+}
diff --git a/osu.Game/Graphics/UserInterface/BreadcrumbControl.cs b/osu.Game/Graphics/UserInterface/BreadcrumbControl.cs
index d06c227d4b..b6ae4d6dc5 100644
--- a/osu.Game/Graphics/UserInterface/BreadcrumbControl.cs
+++ b/osu.Game/Graphics/UserInterface/BreadcrumbControl.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.
 
+#nullable disable
+
 using System;
 using osuTK;
 using osu.Framework;
diff --git a/osu.Game/Graphics/UserInterface/CommaSeparatedScoreCounter.cs b/osu.Game/Graphics/UserInterface/CommaSeparatedScoreCounter.cs
index 4e1c612f09..bec78c68d3 100644
--- a/osu.Game/Graphics/UserInterface/CommaSeparatedScoreCounter.cs
+++ b/osu.Game/Graphics/UserInterface/CommaSeparatedScoreCounter.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.
 
+#nullable disable
+
 using osu.Framework.Extensions.LocalisationExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Localisation;
diff --git a/osu.Game/Graphics/UserInterface/DangerousTriangleButton.cs b/osu.Game/Graphics/UserInterface/DangerousTriangleButton.cs
index 89a4c28c8c..1414979531 100644
--- a/osu.Game/Graphics/UserInterface/DangerousTriangleButton.cs
+++ b/osu.Game/Graphics/UserInterface/DangerousTriangleButton.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 
 namespace osu.Game.Graphics.UserInterface
diff --git a/osu.Game/Graphics/UserInterface/DialogButton.cs b/osu.Game/Graphics/UserInterface/DialogButton.cs
index 69fbd744c9..52ad5c6b80 100644
--- a/osu.Game/Graphics/UserInterface/DialogButton.cs
+++ b/osu.Game/Graphics/UserInterface/DialogButton.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.
 
+#nullable disable
+
 using System;
 using osu.Framework;
 using osu.Framework.Extensions.Color4Extensions;
diff --git a/osu.Game/Graphics/UserInterface/DownloadButton.cs b/osu.Game/Graphics/UserInterface/DownloadButton.cs
index af270f30ae..dfbe6bd44d 100644
--- a/osu.Game/Graphics/UserInterface/DownloadButton.cs
+++ b/osu.Game/Graphics/UserInterface/DownloadButton.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Graphics/UserInterface/DrawableOsuMenuItem.cs b/osu.Game/Graphics/UserInterface/DrawableOsuMenuItem.cs
index 4ecc543ffd..b469c21ab0 100644
--- a/osu.Game/Graphics/UserInterface/DrawableOsuMenuItem.cs
+++ b/osu.Game/Graphics/UserInterface/DrawableOsuMenuItem.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Graphics/UserInterface/DrawableStatefulMenuItem.cs b/osu.Game/Graphics/UserInterface/DrawableStatefulMenuItem.cs
index 3dc99f2dbe..5a7cf0d73e 100644
--- a/osu.Game/Graphics/UserInterface/DrawableStatefulMenuItem.cs
+++ b/osu.Game/Graphics/UserInterface/DrawableStatefulMenuItem.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.
 
+#nullable disable
+
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Sprites;
diff --git a/osu.Game/Graphics/UserInterface/ExpandableSlider.cs b/osu.Game/Graphics/UserInterface/ExpandableSlider.cs
index a05c0cfab0..92b0059157 100644
--- a/osu.Game/Graphics/UserInterface/ExpandableSlider.cs
+++ b/osu.Game/Graphics/UserInterface/ExpandableSlider.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Graphics/UserInterface/ExpandingBar.cs b/osu.Game/Graphics/UserInterface/ExpandingBar.cs
index 60cb35b4c4..b2ffb4da7d 100644
--- a/osu.Game/Graphics/UserInterface/ExpandingBar.cs
+++ b/osu.Game/Graphics/UserInterface/ExpandingBar.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Shapes;
 using osuTK;
diff --git a/osu.Game/Graphics/UserInterface/ExternalLinkButton.cs b/osu.Game/Graphics/UserInterface/ExternalLinkButton.cs
index 1730e1478f..ae286f5092 100644
--- a/osu.Game/Graphics/UserInterface/ExternalLinkButton.cs
+++ b/osu.Game/Graphics/UserInterface/ExternalLinkButton.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Graphics/UserInterface/FocusedTextBox.cs b/osu.Game/Graphics/UserInterface/FocusedTextBox.cs
index d3a76a0f1a..fce4221c87 100644
--- a/osu.Game/Graphics/UserInterface/FocusedTextBox.cs
+++ b/osu.Game/Graphics/UserInterface/FocusedTextBox.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 enable
-
 using osuTK.Graphics;
 using osu.Framework.Allocation;
 using osu.Framework.Input.Events;
diff --git a/osu.Game/Graphics/UserInterface/GradientLineTabControl.cs b/osu.Game/Graphics/UserInterface/GradientLineTabControl.cs
index 1d67c4e033..e16f1ee897 100644
--- a/osu.Game/Graphics/UserInterface/GradientLineTabControl.cs
+++ b/osu.Game/Graphics/UserInterface/GradientLineTabControl.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.
 
+#nullable disable
+
 using osu.Framework.Graphics.UserInterface;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Graphics/UserInterface/GrayButton.cs b/osu.Game/Graphics/UserInterface/GrayButton.cs
index 0a2c83d5a8..d95032bce6 100644
--- a/osu.Game/Graphics/UserInterface/GrayButton.cs
+++ b/osu.Game/Graphics/UserInterface/GrayButton.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Shapes;
diff --git a/osu.Game/Graphics/UserInterface/HoverClickSounds.cs b/osu.Game/Graphics/UserInterface/HoverClickSounds.cs
index ba253a7c71..dab4390ede 100644
--- a/osu.Game/Graphics/UserInterface/HoverClickSounds.cs
+++ b/osu.Game/Graphics/UserInterface/HoverClickSounds.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.
 
+#nullable disable
+
 using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
diff --git a/osu.Game/Graphics/UserInterface/HoverSampleDebounceComponent.cs b/osu.Game/Graphics/UserInterface/HoverSampleDebounceComponent.cs
index 34ab7626c9..20715309a2 100644
--- a/osu.Game/Graphics/UserInterface/HoverSampleDebounceComponent.cs
+++ b/osu.Game/Graphics/UserInterface/HoverSampleDebounceComponent.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Graphics/UserInterface/HoverSampleSet.cs b/osu.Game/Graphics/UserInterface/HoverSampleSet.cs
index 0bf44321dd..6358317e9d 100644
--- a/osu.Game/Graphics/UserInterface/HoverSampleSet.cs
+++ b/osu.Game/Graphics/UserInterface/HoverSampleSet.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.
 
+#nullable disable
+
 using System.ComponentModel;
 
 namespace osu.Game.Graphics.UserInterface
diff --git a/osu.Game/Graphics/UserInterface/HoverSounds.cs b/osu.Game/Graphics/UserInterface/HoverSounds.cs
index 7db1efc75f..dd03e83ab1 100644
--- a/osu.Game/Graphics/UserInterface/HoverSounds.cs
+++ b/osu.Game/Graphics/UserInterface/HoverSounds.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
 using osu.Framework.Audio.Sample;
diff --git a/osu.Game/Graphics/UserInterface/IconButton.cs b/osu.Game/Graphics/UserInterface/IconButton.cs
index 858f517985..e0b5999c4d 100644
--- a/osu.Game/Graphics/UserInterface/IconButton.cs
+++ b/osu.Game/Graphics/UserInterface/IconButton.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.
 
+#nullable disable
+
 using osuTK;
 using osuTK.Graphics;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Graphics/UserInterface/LineGraph.cs b/osu.Game/Graphics/UserInterface/LineGraph.cs
index 70db26c817..fe634390a2 100644
--- a/osu.Game/Graphics/UserInterface/LineGraph.cs
+++ b/osu.Game/Graphics/UserInterface/LineGraph.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Graphics/UserInterface/LoadingButton.cs b/osu.Game/Graphics/UserInterface/LoadingButton.cs
index a75cf0639c..8be50a4b43 100644
--- a/osu.Game/Graphics/UserInterface/LoadingButton.cs
+++ b/osu.Game/Graphics/UserInterface/LoadingButton.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Graphics/UserInterface/LoadingLayer.cs b/osu.Game/Graphics/UserInterface/LoadingLayer.cs
index 47ba5fce4d..407823fc2a 100644
--- a/osu.Game/Graphics/UserInterface/LoadingLayer.cs
+++ b/osu.Game/Graphics/UserInterface/LoadingLayer.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.
 
+#nullable disable
+
 using System;
 using JetBrains.Annotations;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Graphics/UserInterface/LoadingSpinner.cs b/osu.Game/Graphics/UserInterface/LoadingSpinner.cs
index 8174c4d5fe..864dd0a65e 100644
--- a/osu.Game/Graphics/UserInterface/LoadingSpinner.cs
+++ b/osu.Game/Graphics/UserInterface/LoadingSpinner.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
diff --git a/osu.Game/Graphics/UserInterface/MenuItemType.cs b/osu.Game/Graphics/UserInterface/MenuItemType.cs
index 0269f2cb57..1eb45d6b1c 100644
--- a/osu.Game/Graphics/UserInterface/MenuItemType.cs
+++ b/osu.Game/Graphics/UserInterface/MenuItemType.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.
 
+#nullable disable
+
 namespace osu.Game.Graphics.UserInterface
 {
     public enum MenuItemType
diff --git a/osu.Game/Graphics/UserInterface/Nub.cs b/osu.Game/Graphics/UserInterface/Nub.cs
index 8f0fed580f..249fa2fbb2 100644
--- a/osu.Game/Graphics/UserInterface/Nub.cs
+++ b/osu.Game/Graphics/UserInterface/Nub.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.
 
+#nullable disable
+
 using System;
 using JetBrains.Annotations;
 using osuTK;
diff --git a/osu.Game/Graphics/UserInterface/OsuAnimatedButton.cs b/osu.Game/Graphics/UserInterface/OsuAnimatedButton.cs
index 13b42c0f13..f720678a93 100644
--- a/osu.Game/Graphics/UserInterface/OsuAnimatedButton.cs
+++ b/osu.Game/Graphics/UserInterface/OsuAnimatedButton.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Graphics/UserInterface/OsuButton.cs b/osu.Game/Graphics/UserInterface/OsuButton.cs
index 08514d94c3..291ff644fd 100644
--- a/osu.Game/Graphics/UserInterface/OsuButton.cs
+++ b/osu.Game/Graphics/UserInterface/OsuButton.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Graphics/UserInterface/OsuCheckbox.cs b/osu.Game/Graphics/UserInterface/OsuCheckbox.cs
index da511d8212..bbd8f8ecea 100644
--- a/osu.Game/Graphics/UserInterface/OsuCheckbox.cs
+++ b/osu.Game/Graphics/UserInterface/OsuCheckbox.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
 using osu.Framework.Audio.Sample;
diff --git a/osu.Game/Graphics/UserInterface/OsuContextMenu.cs b/osu.Game/Graphics/UserInterface/OsuContextMenu.cs
index e0946fd9e1..cc5ce8f46d 100644
--- a/osu.Game/Graphics/UserInterface/OsuContextMenu.cs
+++ b/osu.Game/Graphics/UserInterface/OsuContextMenu.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.
 
+#nullable disable
+
 using osuTK.Graphics;
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.Color4Extensions;
diff --git a/osu.Game/Graphics/UserInterface/OsuContextMenuSamples.cs b/osu.Game/Graphics/UserInterface/OsuContextMenuSamples.cs
index 921fef7951..c329974e28 100644
--- a/osu.Game/Graphics/UserInterface/OsuContextMenuSamples.cs
+++ b/osu.Game/Graphics/UserInterface/OsuContextMenuSamples.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
 using osu.Framework.Audio.Sample;
diff --git a/osu.Game/Graphics/UserInterface/OsuDropdown.cs b/osu.Game/Graphics/UserInterface/OsuDropdown.cs
index 23e05c7ccc..ce2a690e92 100644
--- a/osu.Game/Graphics/UserInterface/OsuDropdown.cs
+++ b/osu.Game/Graphics/UserInterface/OsuDropdown.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 enable
-
 using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
diff --git a/osu.Game/Graphics/UserInterface/OsuEnumDropdown.cs b/osu.Game/Graphics/UserInterface/OsuEnumDropdown.cs
index 528d7d60f8..3d4a8cf359 100644
--- a/osu.Game/Graphics/UserInterface/OsuEnumDropdown.cs
+++ b/osu.Game/Graphics/UserInterface/OsuEnumDropdown.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.
 
+#nullable disable
+
 using System;
 
 namespace osu.Game.Graphics.UserInterface
diff --git a/osu.Game/Graphics/UserInterface/OsuMenu.cs b/osu.Game/Graphics/UserInterface/OsuMenu.cs
index a16adcbd57..a11bffd05d 100644
--- a/osu.Game/Graphics/UserInterface/OsuMenu.cs
+++ b/osu.Game/Graphics/UserInterface/OsuMenu.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
 using osu.Framework.Audio.Sample;
diff --git a/osu.Game/Graphics/UserInterface/OsuMenuItem.cs b/osu.Game/Graphics/UserInterface/OsuMenuItem.cs
index 1da60415ba..9d65d6b8b9 100644
--- a/osu.Game/Graphics/UserInterface/OsuMenuItem.cs
+++ b/osu.Game/Graphics/UserInterface/OsuMenuItem.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Graphics.UserInterface;
 using osu.Framework.Localisation;
diff --git a/osu.Game/Graphics/UserInterface/OsuNumberBox.cs b/osu.Game/Graphics/UserInterface/OsuNumberBox.cs
index 8a3b77d3c2..93d47792c8 100644
--- a/osu.Game/Graphics/UserInterface/OsuNumberBox.cs
+++ b/osu.Game/Graphics/UserInterface/OsuNumberBox.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.
 
+#nullable disable
+
 using osu.Framework.Extensions;
 
 namespace osu.Game.Graphics.UserInterface
diff --git a/osu.Game/Graphics/UserInterface/OsuPasswordTextBox.cs b/osu.Game/Graphics/UserInterface/OsuPasswordTextBox.cs
index b276159558..305b1b6687 100644
--- a/osu.Game/Graphics/UserInterface/OsuPasswordTextBox.cs
+++ b/osu.Game/Graphics/UserInterface/OsuPasswordTextBox.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.
 
+#nullable disable
+
 using osuTK;
 using osuTK.Graphics;
 using osuTK.Input;
diff --git a/osu.Game/Graphics/UserInterface/OsuSliderBar.cs b/osu.Game/Graphics/UserInterface/OsuSliderBar.cs
index 21c8dfcfa4..3356153e17 100644
--- a/osu.Game/Graphics/UserInterface/OsuSliderBar.cs
+++ b/osu.Game/Graphics/UserInterface/OsuSliderBar.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.
 
+#nullable disable
+
 using System;
 using System.Globalization;
 using JetBrains.Annotations;
diff --git a/osu.Game/Graphics/UserInterface/OsuTabControl.cs b/osu.Game/Graphics/UserInterface/OsuTabControl.cs
index 3572ea5c31..3cfe401bb9 100644
--- a/osu.Game/Graphics/UserInterface/OsuTabControl.cs
+++ b/osu.Game/Graphics/UserInterface/OsuTabControl.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using osuTK;
diff --git a/osu.Game/Graphics/UserInterface/OsuTabControlCheckbox.cs b/osu.Game/Graphics/UserInterface/OsuTabControlCheckbox.cs
index c6121dcd17..6e6296c24b 100644
--- a/osu.Game/Graphics/UserInterface/OsuTabControlCheckbox.cs
+++ b/osu.Game/Graphics/UserInterface/OsuTabControlCheckbox.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.
 
+#nullable disable
+
 using osuTK;
 using osuTK.Graphics;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Graphics/UserInterface/OsuTabDropdown.cs b/osu.Game/Graphics/UserInterface/OsuTabDropdown.cs
index b7e25ae4e7..d9d9a21401 100644
--- a/osu.Game/Graphics/UserInterface/OsuTabDropdown.cs
+++ b/osu.Game/Graphics/UserInterface/OsuTabDropdown.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.
 
+#nullable disable
+
 using osuTK;
 using osuTK.Graphics;
 using osu.Framework.Extensions.Color4Extensions;
diff --git a/osu.Game/Graphics/UserInterface/OsuTextBox.cs b/osu.Game/Graphics/UserInterface/OsuTextBox.cs
index 6db3068d84..1650d2b274 100644
--- a/osu.Game/Graphics/UserInterface/OsuTextBox.cs
+++ b/osu.Game/Graphics/UserInterface/OsuTextBox.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 enable
-
 using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
diff --git a/osu.Game/Graphics/UserInterface/PageSelector/PageEllipsis.cs b/osu.Game/Graphics/UserInterface/PageSelector/PageEllipsis.cs
index d73d9f5824..b750abcd2b 100644
--- a/osu.Game/Graphics/UserInterface/PageSelector/PageEllipsis.cs
+++ b/osu.Game/Graphics/UserInterface/PageSelector/PageEllipsis.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Graphics/UserInterface/PageSelector/PageSelector.cs b/osu.Game/Graphics/UserInterface/PageSelector/PageSelector.cs
index 5c6d087279..7c5d38b91b 100644
--- a/osu.Game/Graphics/UserInterface/PageSelector/PageSelector.cs
+++ b/osu.Game/Graphics/UserInterface/PageSelector/PageSelector.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Graphics/UserInterface/PageSelector/PageSelectorButton.cs b/osu.Game/Graphics/UserInterface/PageSelector/PageSelectorButton.cs
index a2c6e8532b..adeae4fc8d 100644
--- a/osu.Game/Graphics/UserInterface/PageSelector/PageSelectorButton.cs
+++ b/osu.Game/Graphics/UserInterface/PageSelector/PageSelectorButton.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.
 
+#nullable disable
+
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Graphics/UserInterface/PageSelector/PageSelectorPageButton.cs b/osu.Game/Graphics/UserInterface/PageSelector/PageSelectorPageButton.cs
index 247a003492..7696087195 100644
--- a/osu.Game/Graphics/UserInterface/PageSelector/PageSelectorPageButton.cs
+++ b/osu.Game/Graphics/UserInterface/PageSelector/PageSelectorPageButton.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Bindables;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Graphics/UserInterface/PageSelector/PageSelectorPrevNextButton.cs b/osu.Game/Graphics/UserInterface/PageSelector/PageSelectorPrevNextButton.cs
index 889917c397..a96cc892d4 100644
--- a/osu.Game/Graphics/UserInterface/PageSelector/PageSelectorPrevNextButton.cs
+++ b/osu.Game/Graphics/UserInterface/PageSelector/PageSelectorPrevNextButton.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.LocalisationExtensions;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Graphics/UserInterface/PageTabControl.cs b/osu.Game/Graphics/UserInterface/PageTabControl.cs
index a218c7bf52..13654fac85 100644
--- a/osu.Game/Graphics/UserInterface/PageTabControl.cs
+++ b/osu.Game/Graphics/UserInterface/PageTabControl.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.
 
+#nullable disable
+
 using System;
 using osuTK;
 using osuTK.Graphics;
diff --git a/osu.Game/Graphics/UserInterface/PercentageCounter.cs b/osu.Game/Graphics/UserInterface/PercentageCounter.cs
index 0ebf2849fe..e5b0f0cbee 100644
--- a/osu.Game/Graphics/UserInterface/PercentageCounter.cs
+++ b/osu.Game/Graphics/UserInterface/PercentageCounter.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Graphics;
 using osu.Framework.Localisation;
diff --git a/osu.Game/Graphics/UserInterface/ProgressBar.cs b/osu.Game/Graphics/UserInterface/ProgressBar.cs
index 50367e600e..774704223b 100644
--- a/osu.Game/Graphics/UserInterface/ProgressBar.cs
+++ b/osu.Game/Graphics/UserInterface/ProgressBar.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Shapes;
diff --git a/osu.Game/Graphics/UserInterface/RollingCounter.cs b/osu.Game/Graphics/UserInterface/RollingCounter.cs
index 16555075d1..2f8c8414e2 100644
--- a/osu.Game/Graphics/UserInterface/RollingCounter.cs
+++ b/osu.Game/Graphics/UserInterface/RollingCounter.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Sprites;
diff --git a/osu.Game/Graphics/UserInterface/ScoreCounter.cs b/osu.Game/Graphics/UserInterface/ScoreCounter.cs
index 25f19aa0a9..e46e2b31ac 100644
--- a/osu.Game/Graphics/UserInterface/ScoreCounter.cs
+++ b/osu.Game/Graphics/UserInterface/ScoreCounter.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.
 
+#nullable disable
+
 using osu.Framework.Bindables;
 using osu.Framework.Extensions.LocalisationExtensions;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Graphics/UserInterface/ScreenBreadcrumbControl.cs b/osu.Game/Graphics/UserInterface/ScreenBreadcrumbControl.cs
index d7bd7d7e01..edd705ca00 100644
--- a/osu.Game/Graphics/UserInterface/ScreenBreadcrumbControl.cs
+++ b/osu.Game/Graphics/UserInterface/ScreenBreadcrumbControl.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.
 
+#nullable disable
+
 using System.Linq;
 using osu.Framework.Extensions.IEnumerableExtensions;
 using osu.Framework.Graphics.UserInterface;
diff --git a/osu.Game/Graphics/UserInterface/SearchTextBox.cs b/osu.Game/Graphics/UserInterface/SearchTextBox.cs
index cc0bc2dc46..2c2597f149 100644
--- a/osu.Game/Graphics/UserInterface/SearchTextBox.cs
+++ b/osu.Game/Graphics/UserInterface/SearchTextBox.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.
 
+#nullable disable
+
 using osu.Framework.Input;
 using osu.Framework.Input.Events;
 using osu.Game.Resources.Localisation.Web;
diff --git a/osu.Game/Graphics/UserInterface/SeekLimitedSearchTextBox.cs b/osu.Game/Graphics/UserInterface/SeekLimitedSearchTextBox.cs
index 0b76ff658f..f64f455f6b 100644
--- a/osu.Game/Graphics/UserInterface/SeekLimitedSearchTextBox.cs
+++ b/osu.Game/Graphics/UserInterface/SeekLimitedSearchTextBox.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.
 
+#nullable disable
+
 namespace osu.Game.Graphics.UserInterface
 {
     /// <summary>
diff --git a/osu.Game/Graphics/UserInterface/SelectionState.cs b/osu.Game/Graphics/UserInterface/SelectionState.cs
index c85b2ad3ab..edabf0547b 100644
--- a/osu.Game/Graphics/UserInterface/SelectionState.cs
+++ b/osu.Game/Graphics/UserInterface/SelectionState.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.
 
+#nullable disable
+
 namespace osu.Game.Graphics.UserInterface
 {
     public enum SelectionState
diff --git a/osu.Game/Graphics/UserInterface/ShearedButton.cs b/osu.Game/Graphics/UserInterface/ShearedButton.cs
index 66c6eedd0c..259c0646f3 100644
--- a/osu.Game/Graphics/UserInterface/ShearedButton.cs
+++ b/osu.Game/Graphics/UserInterface/ShearedButton.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.
 
-#nullable enable
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Colour;
diff --git a/osu.Game/Graphics/UserInterface/ShearedOverlayHeader.cs b/osu.Game/Graphics/UserInterface/ShearedOverlayHeader.cs
index 452a1dd394..deb2374e88 100644
--- a/osu.Game/Graphics/UserInterface/ShearedOverlayHeader.cs
+++ b/osu.Game/Graphics/UserInterface/ShearedOverlayHeader.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 enable
-
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Graphics/UserInterface/ShearedSearchTextBox.cs b/osu.Game/Graphics/UserInterface/ShearedSearchTextBox.cs
index 0c34a04a65..d7e027b3f9 100644
--- a/osu.Game/Graphics/UserInterface/ShearedSearchTextBox.cs
+++ b/osu.Game/Graphics/UserInterface/ShearedSearchTextBox.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Graphics/UserInterface/ShearedToggleButton.cs b/osu.Game/Graphics/UserInterface/ShearedToggleButton.cs
index ee59da7279..50682ddfe0 100644
--- a/osu.Game/Graphics/UserInterface/ShearedToggleButton.cs
+++ b/osu.Game/Graphics/UserInterface/ShearedToggleButton.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 enable
-
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
diff --git a/osu.Game/Graphics/UserInterface/ShowMoreButton.cs b/osu.Game/Graphics/UserInterface/ShowMoreButton.cs
index 05dda324d4..ed64a31412 100644
--- a/osu.Game/Graphics/UserInterface/ShowMoreButton.cs
+++ b/osu.Game/Graphics/UserInterface/ShowMoreButton.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Graphics/UserInterface/SlimEnumDropdown.cs b/osu.Game/Graphics/UserInterface/SlimEnumDropdown.cs
index c01ee1a059..534fcf76e5 100644
--- a/osu.Game/Graphics/UserInterface/SlimEnumDropdown.cs
+++ b/osu.Game/Graphics/UserInterface/SlimEnumDropdown.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.UserInterface;
diff --git a/osu.Game/Graphics/UserInterface/StarCounter.cs b/osu.Game/Graphics/UserInterface/StarCounter.cs
index b66f371801..a8051a94d9 100644
--- a/osu.Game/Graphics/UserInterface/StarCounter.cs
+++ b/osu.Game/Graphics/UserInterface/StarCounter.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.
 
+#nullable disable
+
 using osuTK;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Graphics/UserInterface/StatefulMenuItem.cs b/osu.Game/Graphics/UserInterface/StatefulMenuItem.cs
index 0d7b36e51b..17266e876c 100644
--- a/osu.Game/Graphics/UserInterface/StatefulMenuItem.cs
+++ b/osu.Game/Graphics/UserInterface/StatefulMenuItem.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics.Sprites;
diff --git a/osu.Game/Graphics/UserInterface/TernaryState.cs b/osu.Game/Graphics/UserInterface/TernaryState.cs
index d4de28044f..effbe624c3 100644
--- a/osu.Game/Graphics/UserInterface/TernaryState.cs
+++ b/osu.Game/Graphics/UserInterface/TernaryState.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.
 
+#nullable disable
+
 namespace osu.Game.Graphics.UserInterface
 {
     /// <summary>
diff --git a/osu.Game/Graphics/UserInterface/TernaryStateMenuItem.cs b/osu.Game/Graphics/UserInterface/TernaryStateMenuItem.cs
index 5c623150b7..d2b6ff2dba 100644
--- a/osu.Game/Graphics/UserInterface/TernaryStateMenuItem.cs
+++ b/osu.Game/Graphics/UserInterface/TernaryStateMenuItem.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Graphics.Sprites;
 
diff --git a/osu.Game/Graphics/UserInterface/TernaryStateRadioMenuItem.cs b/osu.Game/Graphics/UserInterface/TernaryStateRadioMenuItem.cs
index 46eda06294..133362d3e6 100644
--- a/osu.Game/Graphics/UserInterface/TernaryStateRadioMenuItem.cs
+++ b/osu.Game/Graphics/UserInterface/TernaryStateRadioMenuItem.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.
 
+#nullable disable
+
 using System;
 
 namespace osu.Game.Graphics.UserInterface
diff --git a/osu.Game/Graphics/UserInterface/TernaryStateToggleMenuItem.cs b/osu.Game/Graphics/UserInterface/TernaryStateToggleMenuItem.cs
index ce951984fd..ec776f5cc4 100644
--- a/osu.Game/Graphics/UserInterface/TernaryStateToggleMenuItem.cs
+++ b/osu.Game/Graphics/UserInterface/TernaryStateToggleMenuItem.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.
 
+#nullable disable
+
 using System;
 
 namespace osu.Game.Graphics.UserInterface
diff --git a/osu.Game/Graphics/UserInterface/TimeSlider.cs b/osu.Game/Graphics/UserInterface/TimeSlider.cs
index 82b02f1b48..d45c6614aa 100644
--- a/osu.Game/Graphics/UserInterface/TimeSlider.cs
+++ b/osu.Game/Graphics/UserInterface/TimeSlider.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.
 
+#nullable disable
+
 using osu.Framework.Localisation;
 
 namespace osu.Game.Graphics.UserInterface
diff --git a/osu.Game/Graphics/UserInterface/ToggleMenuItem.cs b/osu.Game/Graphics/UserInterface/ToggleMenuItem.cs
index f9ff9859dd..9d1650c970 100644
--- a/osu.Game/Graphics/UserInterface/ToggleMenuItem.cs
+++ b/osu.Game/Graphics/UserInterface/ToggleMenuItem.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Graphics.Sprites;
 
diff --git a/osu.Game/Graphics/UserInterface/TriangleButton.cs b/osu.Game/Graphics/UserInterface/TriangleButton.cs
index 5ae6130039..60d1824e5a 100644
--- a/osu.Game/Graphics/UserInterface/TriangleButton.cs
+++ b/osu.Game/Graphics/UserInterface/TriangleButton.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Graphics/UserInterface/TwoLayerButton.cs b/osu.Game/Graphics/UserInterface/TwoLayerButton.cs
index 1f5d29571d..144b51d3e8 100644
--- a/osu.Game/Graphics/UserInterface/TwoLayerButton.cs
+++ b/osu.Game/Graphics/UserInterface/TwoLayerButton.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Sprites;
diff --git a/osu.Game/Graphics/UserInterfaceV2/ColourDisplay.cs b/osu.Game/Graphics/UserInterfaceV2/ColourDisplay.cs
index cec319f28e..93852f19c4 100644
--- a/osu.Game/Graphics/UserInterfaceV2/ColourDisplay.cs
+++ b/osu.Game/Graphics/UserInterfaceV2/ColourDisplay.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Graphics/UserInterfaceV2/ColourPalette.cs b/osu.Game/Graphics/UserInterfaceV2/ColourPalette.cs
index a966f61b74..001ccc7f87 100644
--- a/osu.Game/Graphics/UserInterfaceV2/ColourPalette.cs
+++ b/osu.Game/Graphics/UserInterfaceV2/ColourPalette.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Collections.Specialized;
diff --git a/osu.Game/Graphics/UserInterfaceV2/LabelledColourPalette.cs b/osu.Game/Graphics/UserInterfaceV2/LabelledColourPalette.cs
index 8970ef1115..7b9684e3ef 100644
--- a/osu.Game/Graphics/UserInterfaceV2/LabelledColourPalette.cs
+++ b/osu.Game/Graphics/UserInterfaceV2/LabelledColourPalette.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.
 
+#nullable disable
+
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 
diff --git a/osu.Game/Graphics/UserInterfaceV2/LabelledComponent.cs b/osu.Game/Graphics/UserInterfaceV2/LabelledComponent.cs
index dd6a902989..977ef5d7bc 100644
--- a/osu.Game/Graphics/UserInterfaceV2/LabelledComponent.cs
+++ b/osu.Game/Graphics/UserInterfaceV2/LabelledComponent.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.
 
+#nullable disable
+
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.UserInterface;
diff --git a/osu.Game/Graphics/UserInterfaceV2/LabelledDrawable.cs b/osu.Game/Graphics/UserInterfaceV2/LabelledDrawable.cs
index 2353d9e0e8..8c98a3e0a7 100644
--- a/osu.Game/Graphics/UserInterfaceV2/LabelledDrawable.cs
+++ b/osu.Game/Graphics/UserInterfaceV2/LabelledDrawable.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 enable
-
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Graphics/UserInterfaceV2/LabelledDropdown.cs b/osu.Game/Graphics/UserInterfaceV2/LabelledDropdown.cs
index 44f09f13eb..bfb009658d 100644
--- a/osu.Game/Graphics/UserInterfaceV2/LabelledDropdown.cs
+++ b/osu.Game/Graphics/UserInterfaceV2/LabelledDropdown.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Framework.Graphics;
 using osu.Game.Graphics.UserInterface;
diff --git a/osu.Game/Graphics/UserInterfaceV2/LabelledEnumDropdown.cs b/osu.Game/Graphics/UserInterfaceV2/LabelledEnumDropdown.cs
index b818c394ae..594f132154 100644
--- a/osu.Game/Graphics/UserInterfaceV2/LabelledEnumDropdown.cs
+++ b/osu.Game/Graphics/UserInterfaceV2/LabelledEnumDropdown.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.
 
+#nullable disable
+
 using System;
 using osu.Game.Graphics.UserInterface;
 
diff --git a/osu.Game/Graphics/UserInterfaceV2/LabelledNumberBox.cs b/osu.Game/Graphics/UserInterfaceV2/LabelledNumberBox.cs
index ca247ab679..cb032698ef 100644
--- a/osu.Game/Graphics/UserInterfaceV2/LabelledNumberBox.cs
+++ b/osu.Game/Graphics/UserInterfaceV2/LabelledNumberBox.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.
 
+#nullable disable
+
 using osu.Game.Graphics.UserInterface;
 
 namespace osu.Game.Graphics.UserInterfaceV2
diff --git a/osu.Game/Graphics/UserInterfaceV2/LabelledSliderBar.cs b/osu.Game/Graphics/UserInterfaceV2/LabelledSliderBar.cs
index cba94e314b..50b6834f01 100644
--- a/osu.Game/Graphics/UserInterfaceV2/LabelledSliderBar.cs
+++ b/osu.Game/Graphics/UserInterfaceV2/LabelledSliderBar.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Graphics;
 using osu.Game.Overlays.Settings;
diff --git a/osu.Game/Graphics/UserInterfaceV2/LabelledSwitchButton.cs b/osu.Game/Graphics/UserInterfaceV2/LabelledSwitchButton.cs
index c374d80830..99a1a98d5b 100644
--- a/osu.Game/Graphics/UserInterfaceV2/LabelledSwitchButton.cs
+++ b/osu.Game/Graphics/UserInterfaceV2/LabelledSwitchButton.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.
 
+#nullable disable
+
 namespace osu.Game.Graphics.UserInterfaceV2
 {
     public class LabelledSwitchButton : LabelledComponent<SwitchButton, bool>
diff --git a/osu.Game/Graphics/UserInterfaceV2/LabelledTextBox.cs b/osu.Game/Graphics/UserInterfaceV2/LabelledTextBox.cs
index 82b9fe559f..97bc845766 100644
--- a/osu.Game/Graphics/UserInterfaceV2/LabelledTextBox.cs
+++ b/osu.Game/Graphics/UserInterfaceV2/LabelledTextBox.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Graphics/UserInterfaceV2/OsuColourPicker.cs b/osu.Game/Graphics/UserInterfaceV2/OsuColourPicker.cs
index 5394e5d0aa..f4ae2f0fd7 100644
--- a/osu.Game/Graphics/UserInterfaceV2/OsuColourPicker.cs
+++ b/osu.Game/Graphics/UserInterfaceV2/OsuColourPicker.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.
 
+#nullable disable
+
 using osu.Framework.Graphics.UserInterface;
 
 namespace osu.Game.Graphics.UserInterfaceV2
diff --git a/osu.Game/Graphics/UserInterfaceV2/OsuDirectorySelector.cs b/osu.Game/Graphics/UserInterfaceV2/OsuDirectorySelector.cs
index 1ce4d97fdf..42e1073baf 100644
--- a/osu.Game/Graphics/UserInterfaceV2/OsuDirectorySelector.cs
+++ b/osu.Game/Graphics/UserInterfaceV2/OsuDirectorySelector.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.
 
+#nullable disable
+
 using System.IO;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Graphics/UserInterfaceV2/OsuDirectorySelectorBreadcrumbDisplay.cs b/osu.Game/Graphics/UserInterfaceV2/OsuDirectorySelectorBreadcrumbDisplay.cs
index cb5ff242a1..0833c7eb8b 100644
--- a/osu.Game/Graphics/UserInterfaceV2/OsuDirectorySelectorBreadcrumbDisplay.cs
+++ b/osu.Game/Graphics/UserInterfaceV2/OsuDirectorySelectorBreadcrumbDisplay.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.
 
+#nullable disable
+
 using System.IO;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Graphics/UserInterfaceV2/OsuDirectorySelectorDirectory.cs b/osu.Game/Graphics/UserInterfaceV2/OsuDirectorySelectorDirectory.cs
index 456bde6d1b..1896d7ee4d 100644
--- a/osu.Game/Graphics/UserInterfaceV2/OsuDirectorySelectorDirectory.cs
+++ b/osu.Game/Graphics/UserInterfaceV2/OsuDirectorySelectorDirectory.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.
 
+#nullable disable
+
 using System.IO;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Graphics/UserInterfaceV2/OsuDirectorySelectorParentDirectory.cs b/osu.Game/Graphics/UserInterfaceV2/OsuDirectorySelectorParentDirectory.cs
index 481d811adb..7d2b28e803 100644
--- a/osu.Game/Graphics/UserInterfaceV2/OsuDirectorySelectorParentDirectory.cs
+++ b/osu.Game/Graphics/UserInterfaceV2/OsuDirectorySelectorParentDirectory.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.
 
+#nullable disable
+
 using System.IO;
 using osu.Framework.Graphics.Sprites;
 
diff --git a/osu.Game/Graphics/UserInterfaceV2/OsuFileSelector.cs b/osu.Game/Graphics/UserInterfaceV2/OsuFileSelector.cs
index 7c88e12dd3..3e8b7dc209 100644
--- a/osu.Game/Graphics/UserInterfaceV2/OsuFileSelector.cs
+++ b/osu.Game/Graphics/UserInterfaceV2/OsuFileSelector.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.
 
+#nullable disable
+
 using System.IO;
 using System.Linq;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Graphics/UserInterfaceV2/OsuHSVColourPicker.cs b/osu.Game/Graphics/UserInterfaceV2/OsuHSVColourPicker.cs
index 0189b30aad..1a8fa435cb 100644
--- a/osu.Game/Graphics/UserInterfaceV2/OsuHSVColourPicker.cs
+++ b/osu.Game/Graphics/UserInterfaceV2/OsuHSVColourPicker.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.
 
+#nullable disable
+
 using JetBrains.Annotations;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Graphics/UserInterfaceV2/OsuHexColourPicker.cs b/osu.Game/Graphics/UserInterfaceV2/OsuHexColourPicker.cs
index 5368a800bc..12313791f0 100644
--- a/osu.Game/Graphics/UserInterfaceV2/OsuHexColourPicker.cs
+++ b/osu.Game/Graphics/UserInterfaceV2/OsuHexColourPicker.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.
 
+#nullable disable
+
 using JetBrains.Annotations;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Graphics/UserInterfaceV2/OsuPopover.cs b/osu.Game/Graphics/UserInterfaceV2/OsuPopover.cs
index 085541b3ef..e468e14f45 100644
--- a/osu.Game/Graphics/UserInterfaceV2/OsuPopover.cs
+++ b/osu.Game/Graphics/UserInterfaceV2/OsuPopover.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.
 
+#nullable disable
+
 using JetBrains.Annotations;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Graphics/UserInterfaceV2/RoundedButton.cs b/osu.Game/Graphics/UserInterfaceV2/RoundedButton.cs
index cb8c63371d..4477633da1 100644
--- a/osu.Game/Graphics/UserInterfaceV2/RoundedButton.cs
+++ b/osu.Game/Graphics/UserInterfaceV2/RoundedButton.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Graphics/UserInterfaceV2/SwitchButton.cs b/osu.Game/Graphics/UserInterfaceV2/SwitchButton.cs
index f483e67b27..b5c1c0a854 100644
--- a/osu.Game/Graphics/UserInterfaceV2/SwitchButton.cs
+++ b/osu.Game/Graphics/UserInterfaceV2/SwitchButton.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 enable
-
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
 using osu.Framework.Audio.Sample;
diff --git a/osu.Game/IO/Archives/ArchiveReader.cs b/osu.Game/IO/Archives/ArchiveReader.cs
index dab70eaf70..91165261b0 100644
--- a/osu.Game/IO/Archives/ArchiveReader.cs
+++ b/osu.Game/IO/Archives/ArchiveReader.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.IO;
 using System.Threading;
diff --git a/osu.Game/IO/Archives/LegacyByteArrayReader.cs b/osu.Game/IO/Archives/LegacyByteArrayReader.cs
index ea8ff3bbe0..e58dbb48ce 100644
--- a/osu.Game/IO/Archives/LegacyByteArrayReader.cs
+++ b/osu.Game/IO/Archives/LegacyByteArrayReader.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.IO;
 
diff --git a/osu.Game/IO/Archives/LegacyDirectoryArchiveReader.cs b/osu.Game/IO/Archives/LegacyDirectoryArchiveReader.cs
index dfae58aed7..e26f6af081 100644
--- a/osu.Game/IO/Archives/LegacyDirectoryArchiveReader.cs
+++ b/osu.Game/IO/Archives/LegacyDirectoryArchiveReader.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.IO;
 using System.Linq;
diff --git a/osu.Game/IO/Archives/LegacyFileArchiveReader.cs b/osu.Game/IO/Archives/LegacyFileArchiveReader.cs
index 72e5a21079..aee1add2f6 100644
--- a/osu.Game/IO/Archives/LegacyFileArchiveReader.cs
+++ b/osu.Game/IO/Archives/LegacyFileArchiveReader.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.IO;
 
diff --git a/osu.Game/IO/Archives/ZipArchiveReader.cs b/osu.Game/IO/Archives/ZipArchiveReader.cs
index ae2b85da51..1fca8aa055 100644
--- a/osu.Game/IO/Archives/ZipArchiveReader.cs
+++ b/osu.Game/IO/Archives/ZipArchiveReader.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.
 
+#nullable disable
+
 using System.Buffers;
 using System.Collections.Generic;
 using System.IO;
diff --git a/osu.Game/IO/FileAbstraction/StreamFileAbstraction.cs b/osu.Game/IO/FileAbstraction/StreamFileAbstraction.cs
index f5709b5158..8e6c3e5f3d 100644
--- a/osu.Game/IO/FileAbstraction/StreamFileAbstraction.cs
+++ b/osu.Game/IO/FileAbstraction/StreamFileAbstraction.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.
 
+#nullable disable
+
 using System;
 using System.IO;
 
diff --git a/osu.Game/IO/FileInfo.cs b/osu.Game/IO/FileInfo.cs
index 148afba40d..3d32e7fb6d 100644
--- a/osu.Game/IO/FileInfo.cs
+++ b/osu.Game/IO/FileInfo.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.
 
+#nullable disable
+
 using osu.Game.Database;
 
 namespace osu.Game.IO
diff --git a/osu.Game/IO/IFileInfo.cs b/osu.Game/IO/IFileInfo.cs
index 080d8e57f5..932ea31e25 100644
--- a/osu.Game/IO/IFileInfo.cs
+++ b/osu.Game/IO/IFileInfo.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 enable
-
 namespace osu.Game.IO
 {
     /// <summary>
diff --git a/osu.Game/IO/IStorageResourceProvider.cs b/osu.Game/IO/IStorageResourceProvider.cs
index b381ac70b0..1cb6509cac 100644
--- a/osu.Game/IO/IStorageResourceProvider.cs
+++ b/osu.Game/IO/IStorageResourceProvider.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.
 
+#nullable disable
+
 using osu.Framework.Audio;
 using osu.Framework.Graphics.Textures;
 using osu.Framework.IO.Stores;
diff --git a/osu.Game/IO/Legacy/ILegacySerializable.cs b/osu.Game/IO/Legacy/ILegacySerializable.cs
index 0124ea756a..f21e67a34b 100644
--- a/osu.Game/IO/Legacy/ILegacySerializable.cs
+++ b/osu.Game/IO/Legacy/ILegacySerializable.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.
 
+#nullable disable
+
 namespace osu.Game.IO.Legacy
 {
     public interface ILegacySerializable
diff --git a/osu.Game/IO/Legacy/SerializationReader.cs b/osu.Game/IO/Legacy/SerializationReader.cs
index 5423485c95..2d3d5bffd5 100644
--- a/osu.Game/IO/Legacy/SerializationReader.cs
+++ b/osu.Game/IO/Legacy/SerializationReader.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.IO;
diff --git a/osu.Game/IO/Legacy/SerializationWriter.cs b/osu.Game/IO/Legacy/SerializationWriter.cs
index c9fff05bcc..10572a6478 100644
--- a/osu.Game/IO/Legacy/SerializationWriter.cs
+++ b/osu.Game/IO/Legacy/SerializationWriter.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.IO;
diff --git a/osu.Game/IO/LineBufferedReader.cs b/osu.Game/IO/LineBufferedReader.cs
index a6b8c9492a..db435576bf 100644
--- a/osu.Game/IO/LineBufferedReader.cs
+++ b/osu.Game/IO/LineBufferedReader.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.IO;
diff --git a/osu.Game/IO/MigratableStorage.cs b/osu.Game/IO/MigratableStorage.cs
index e478144294..30e74adca4 100644
--- a/osu.Game/IO/MigratableStorage.cs
+++ b/osu.Game/IO/MigratableStorage.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.
 
+#nullable disable
+
 using System;
 using System.IO;
 using System.Linq;
diff --git a/osu.Game/IO/OsuStorage.cs b/osu.Game/IO/OsuStorage.cs
index c49365a9de..89bdd09f0d 100644
--- a/osu.Game/IO/OsuStorage.cs
+++ b/osu.Game/IO/OsuStorage.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.
 
+#nullable disable
+
 using System.Diagnostics;
 using System.Linq;
 using JetBrains.Annotations;
diff --git a/osu.Game/IO/Serialization/Converters/SnakeCaseStringEnumConverter.cs b/osu.Game/IO/Serialization/Converters/SnakeCaseStringEnumConverter.cs
index 1d82a5bc87..65283d0d82 100644
--- a/osu.Game/IO/Serialization/Converters/SnakeCaseStringEnumConverter.cs
+++ b/osu.Game/IO/Serialization/Converters/SnakeCaseStringEnumConverter.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.
 
+#nullable disable
+
 using Newtonsoft.Json.Converters;
 using Newtonsoft.Json.Serialization;
 
diff --git a/osu.Game/IO/Serialization/Converters/TypedListConverter.cs b/osu.Game/IO/Serialization/Converters/TypedListConverter.cs
index 715c83b07e..176e4e240d 100644
--- a/osu.Game/IO/Serialization/Converters/TypedListConverter.cs
+++ b/osu.Game/IO/Serialization/Converters/TypedListConverter.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using Newtonsoft.Json;
diff --git a/osu.Game/IO/Serialization/JsonSerializableExtensions.cs b/osu.Game/IO/Serialization/JsonSerializableExtensions.cs
index 68b2110ede..bdf42205d4 100644
--- a/osu.Game/IO/Serialization/JsonSerializableExtensions.cs
+++ b/osu.Game/IO/Serialization/JsonSerializableExtensions.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using Newtonsoft.Json;
 using osu.Framework.IO.Serialization;
diff --git a/osu.Game/IO/Serialization/SnakeCaseKeyContractResolver.cs b/osu.Game/IO/Serialization/SnakeCaseKeyContractResolver.cs
index 68cb66d0dc..4808ac1384 100644
--- a/osu.Game/IO/Serialization/SnakeCaseKeyContractResolver.cs
+++ b/osu.Game/IO/Serialization/SnakeCaseKeyContractResolver.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.
 
+#nullable disable
+
 using Humanizer;
 using Newtonsoft.Json.Serialization;
 
diff --git a/osu.Game/IO/StableStorage.cs b/osu.Game/IO/StableStorage.cs
index d4ff8fcdda..41c7495b42 100644
--- a/osu.Game/IO/StableStorage.cs
+++ b/osu.Game/IO/StableStorage.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.
 
+#nullable disable
+
 using System;
 using System.IO;
 using System.Linq;
diff --git a/osu.Game/IO/WrappedStorage.cs b/osu.Game/IO/WrappedStorage.cs
index 7205ea3adb..95ff26db6a 100644
--- a/osu.Game/IO/WrappedStorage.cs
+++ b/osu.Game/IO/WrappedStorage.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.IO;
diff --git a/osu.Game/IPC/ArchiveImportIPCChannel.cs b/osu.Game/IPC/ArchiveImportIPCChannel.cs
index f381aad39a..02b1f72700 100644
--- a/osu.Game/IPC/ArchiveImportIPCChannel.cs
+++ b/osu.Game/IPC/ArchiveImportIPCChannel.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.
 
+#nullable disable
+
 using System.Diagnostics;
 using System.IO;
 using System.Linq;
diff --git a/osu.Game/Input/Bindings/DatabasedKeyBindingContainer.cs b/osu.Game/Input/Bindings/DatabasedKeyBindingContainer.cs
index ba129b93e5..974abc4036 100644
--- a/osu.Game/Input/Bindings/DatabasedKeyBindingContainer.cs
+++ b/osu.Game/Input/Bindings/DatabasedKeyBindingContainer.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Input/Bindings/GlobalActionContainer.cs b/osu.Game/Input/Bindings/GlobalActionContainer.cs
index 3da5f3212e..21b49286ea 100644
--- a/osu.Game/Input/Bindings/GlobalActionContainer.cs
+++ b/osu.Game/Input/Bindings/GlobalActionContainer.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Input/Bindings/RealmKeyBinding.cs b/osu.Game/Input/Bindings/RealmKeyBinding.cs
index c941319ddb..4af0357535 100644
--- a/osu.Game/Input/Bindings/RealmKeyBinding.cs
+++ b/osu.Game/Input/Bindings/RealmKeyBinding.cs
@@ -7,8 +7,6 @@ using osu.Framework.Input.Bindings;
 using osu.Game.Database;
 using Realms;
 
-#nullable enable
-
 namespace osu.Game.Input.Bindings
 {
     [MapTo(nameof(KeyBinding))]
diff --git a/osu.Game/Input/ConfineMouseTracker.cs b/osu.Game/Input/ConfineMouseTracker.cs
index d2bf953dbc..7e8ace5693 100644
--- a/osu.Game/Input/ConfineMouseTracker.cs
+++ b/osu.Game/Input/ConfineMouseTracker.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Configuration;
diff --git a/osu.Game/Input/GameIdleTracker.cs b/osu.Game/Input/GameIdleTracker.cs
index 260be7e5c9..d82cc25851 100644
--- a/osu.Game/Input/GameIdleTracker.cs
+++ b/osu.Game/Input/GameIdleTracker.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.
 
+#nullable disable
+
 using osu.Framework.Input;
 
 namespace osu.Game.Input
diff --git a/osu.Game/Input/Handlers/ReplayInputHandler.cs b/osu.Game/Input/Handlers/ReplayInputHandler.cs
index 205a1ea1ac..712e0acb60 100644
--- a/osu.Game/Input/Handlers/ReplayInputHandler.cs
+++ b/osu.Game/Input/Handlers/ReplayInputHandler.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Input/IdleTracker.cs b/osu.Game/Input/IdleTracker.cs
index e2f13309cf..279cfb5a4e 100644
--- a/osu.Game/Input/IdleTracker.cs
+++ b/osu.Game/Input/IdleTracker.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Input/OsuConfineMouseMode.cs b/osu.Game/Input/OsuConfineMouseMode.cs
index a4a1c9eb46..2a93ac1cd6 100644
--- a/osu.Game/Input/OsuConfineMouseMode.cs
+++ b/osu.Game/Input/OsuConfineMouseMode.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.
 
+#nullable disable
+
 using System.ComponentModel;
 using osu.Framework.Input;
 
diff --git a/osu.Game/Input/OsuUserInputManager.cs b/osu.Game/Input/OsuUserInputManager.cs
index 621f1e1fc9..7a9002a004 100644
--- a/osu.Game/Input/OsuUserInputManager.cs
+++ b/osu.Game/Input/OsuUserInputManager.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.
 
+#nullable disable
+
 using osu.Framework.Input;
 using osuTK.Input;
 
diff --git a/osu.Game/Input/RealmKeyBindingStore.cs b/osu.Game/Input/RealmKeyBindingStore.cs
index 20971ffca5..10ad731037 100644
--- a/osu.Game/Input/RealmKeyBindingStore.cs
+++ b/osu.Game/Input/RealmKeyBindingStore.cs
@@ -10,8 +10,6 @@ using osu.Game.Input.Bindings;
 using osu.Game.Rulesets;
 using Realms;
 
-#nullable enable
-
 namespace osu.Game.Input
 {
     public class RealmKeyBindingStore
diff --git a/osu.Game/Localisation/AudioSettingsStrings.cs b/osu.Game/Localisation/AudioSettingsStrings.cs
index 0f0f560df9..0dc95da2f4 100644
--- a/osu.Game/Localisation/AudioSettingsStrings.cs
+++ b/osu.Game/Localisation/AudioSettingsStrings.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.
 
+#nullable disable
+
 using osu.Framework.Localisation;
 
 namespace osu.Game.Localisation
diff --git a/osu.Game/Localisation/BeatmapOffsetControlStrings.cs b/osu.Game/Localisation/BeatmapOffsetControlStrings.cs
index 632a1ad0ea..417cf335e0 100644
--- a/osu.Game/Localisation/BeatmapOffsetControlStrings.cs
+++ b/osu.Game/Localisation/BeatmapOffsetControlStrings.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.
 
+#nullable disable
+
 using osu.Framework.Localisation;
 
 namespace osu.Game.Localisation
diff --git a/osu.Game/Localisation/BindingSettingsStrings.cs b/osu.Game/Localisation/BindingSettingsStrings.cs
index ad4a650a1f..39b5ac0d21 100644
--- a/osu.Game/Localisation/BindingSettingsStrings.cs
+++ b/osu.Game/Localisation/BindingSettingsStrings.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.
 
+#nullable disable
+
 using osu.Framework.Localisation;
 
 namespace osu.Game.Localisation
diff --git a/osu.Game/Localisation/ButtonSystemStrings.cs b/osu.Game/Localisation/ButtonSystemStrings.cs
index ba4abf63a6..c71a99711b 100644
--- a/osu.Game/Localisation/ButtonSystemStrings.cs
+++ b/osu.Game/Localisation/ButtonSystemStrings.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.
 
+#nullable disable
+
 using osu.Framework.Localisation;
 
 namespace osu.Game.Localisation
diff --git a/osu.Game/Localisation/ChatStrings.cs b/osu.Game/Localisation/ChatStrings.cs
index 7bd284a94e..b07ed18f7b 100644
--- a/osu.Game/Localisation/ChatStrings.cs
+++ b/osu.Game/Localisation/ChatStrings.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.
 
+#nullable disable
+
 using osu.Framework.Localisation;
 
 namespace osu.Game.Localisation
diff --git a/osu.Game/Localisation/CommonStrings.cs b/osu.Game/Localisation/CommonStrings.cs
index 1fd677034d..39dc7cf518 100644
--- a/osu.Game/Localisation/CommonStrings.cs
+++ b/osu.Game/Localisation/CommonStrings.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.
 
+#nullable disable
+
 using osu.Framework.Localisation;
 
 namespace osu.Game.Localisation
@@ -91,4 +93,4 @@ namespace osu.Game.Localisation
 
         private static string getKey(string key) => $@"{prefix}:{key}";
     }
-}
\ No newline at end of file
+}
diff --git a/osu.Game/Localisation/DebugLocalisationStore.cs b/osu.Game/Localisation/DebugLocalisationStore.cs
index 2b114b1bd8..83ae4581a8 100644
--- a/osu.Game/Localisation/DebugLocalisationStore.cs
+++ b/osu.Game/Localisation/DebugLocalisationStore.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Globalization;
diff --git a/osu.Game/Localisation/DebugSettingsStrings.cs b/osu.Game/Localisation/DebugSettingsStrings.cs
index 74b2c8d892..e6de4ddee9 100644
--- a/osu.Game/Localisation/DebugSettingsStrings.cs
+++ b/osu.Game/Localisation/DebugSettingsStrings.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.
 
+#nullable disable
+
 using osu.Framework.Localisation;
 
 namespace osu.Game.Localisation
diff --git a/osu.Game/Localisation/DifficultyMultiplierDisplayStrings.cs b/osu.Game/Localisation/DifficultyMultiplierDisplayStrings.cs
index c281d90190..4bcbdcff7b 100644
--- a/osu.Game/Localisation/DifficultyMultiplierDisplayStrings.cs
+++ b/osu.Game/Localisation/DifficultyMultiplierDisplayStrings.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.
 
+#nullable disable
+
 using osu.Framework.Localisation;
 
 namespace osu.Game.Localisation
@@ -16,4 +18,4 @@ namespace osu.Game.Localisation
 
         private static string getKey(string key) => $@"{prefix}:{key}";
     }
-}
\ No newline at end of file
+}
diff --git a/osu.Game/Localisation/FirstRunOverlayImportFromStableScreenStrings.cs b/osu.Game/Localisation/FirstRunOverlayImportFromStableScreenStrings.cs
index deac7d8628..38f5860cc5 100644
--- a/osu.Game/Localisation/FirstRunOverlayImportFromStableScreenStrings.cs
+++ b/osu.Game/Localisation/FirstRunOverlayImportFromStableScreenStrings.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.
 
+#nullable disable
+
 using osu.Framework.Localisation;
 
 namespace osu.Game.Localisation
diff --git a/osu.Game/Localisation/FirstRunSetupBeatmapScreenStrings.cs b/osu.Game/Localisation/FirstRunSetupBeatmapScreenStrings.cs
index 3a7fe4bb12..331a8c6764 100644
--- a/osu.Game/Localisation/FirstRunSetupBeatmapScreenStrings.cs
+++ b/osu.Game/Localisation/FirstRunSetupBeatmapScreenStrings.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.
 
+#nullable disable
+
 using osu.Framework.Localisation;
 
 namespace osu.Game.Localisation
diff --git a/osu.Game/Localisation/FirstRunSetupOverlayStrings.cs b/osu.Game/Localisation/FirstRunSetupOverlayStrings.cs
index 91b427e2ca..0c73d7a85b 100644
--- a/osu.Game/Localisation/FirstRunSetupOverlayStrings.cs
+++ b/osu.Game/Localisation/FirstRunSetupOverlayStrings.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.
 
+#nullable disable
+
 using osu.Framework.Localisation;
 
 namespace osu.Game.Localisation
diff --git a/osu.Game/Localisation/GameplaySettingsStrings.cs b/osu.Game/Localisation/GameplaySettingsStrings.cs
index 8a0f773551..1719b7d6e8 100644
--- a/osu.Game/Localisation/GameplaySettingsStrings.cs
+++ b/osu.Game/Localisation/GameplaySettingsStrings.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.
 
+#nullable disable
+
 using osu.Framework.Localisation;
 
 namespace osu.Game.Localisation
diff --git a/osu.Game/Localisation/GeneralSettingsStrings.cs b/osu.Game/Localisation/GeneralSettingsStrings.cs
index 2aa91f5245..8cf26a930d 100644
--- a/osu.Game/Localisation/GeneralSettingsStrings.cs
+++ b/osu.Game/Localisation/GeneralSettingsStrings.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.
 
+#nullable disable
+
 using osu.Framework.Localisation;
 
 namespace osu.Game.Localisation
diff --git a/osu.Game/Localisation/GlobalActionKeyBindingStrings.cs b/osu.Game/Localisation/GlobalActionKeyBindingStrings.cs
index 82d03dbb5b..d45fba6f17 100644
--- a/osu.Game/Localisation/GlobalActionKeyBindingStrings.cs
+++ b/osu.Game/Localisation/GlobalActionKeyBindingStrings.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.
 
+#nullable disable
+
 using osu.Framework.Localisation;
 
 namespace osu.Game.Localisation
diff --git a/osu.Game/Localisation/GraphicsSettingsStrings.cs b/osu.Game/Localisation/GraphicsSettingsStrings.cs
index 38355d9041..a73d67067e 100644
--- a/osu.Game/Localisation/GraphicsSettingsStrings.cs
+++ b/osu.Game/Localisation/GraphicsSettingsStrings.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.
 
+#nullable disable
+
 using osu.Framework.Localisation;
 
 namespace osu.Game.Localisation
diff --git a/osu.Game/Localisation/InputSettingsStrings.cs b/osu.Game/Localisation/InputSettingsStrings.cs
index e46b4cecf3..a16dcd998a 100644
--- a/osu.Game/Localisation/InputSettingsStrings.cs
+++ b/osu.Game/Localisation/InputSettingsStrings.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.
 
+#nullable disable
+
 using osu.Framework.Localisation;
 
 namespace osu.Game.Localisation
diff --git a/osu.Game/Localisation/JoystickSettingsStrings.cs b/osu.Game/Localisation/JoystickSettingsStrings.cs
index 976ec1adde..efda1afd48 100644
--- a/osu.Game/Localisation/JoystickSettingsStrings.cs
+++ b/osu.Game/Localisation/JoystickSettingsStrings.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.
 
+#nullable disable
+
 using osu.Framework.Localisation;
 
 namespace osu.Game.Localisation
diff --git a/osu.Game/Localisation/Language.cs b/osu.Game/Localisation/Language.cs
index c13a1a10cb..f9094b9540 100644
--- a/osu.Game/Localisation/Language.cs
+++ b/osu.Game/Localisation/Language.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.
 
+#nullable disable
+
 using System.ComponentModel;
 
 namespace osu.Game.Localisation
diff --git a/osu.Game/Localisation/LayoutSettingsStrings.cs b/osu.Game/Localisation/LayoutSettingsStrings.cs
index b4326b8e39..1a0b015050 100644
--- a/osu.Game/Localisation/LayoutSettingsStrings.cs
+++ b/osu.Game/Localisation/LayoutSettingsStrings.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.
 
+#nullable disable
+
 using osu.Framework.Localisation;
 
 namespace osu.Game.Localisation
diff --git a/osu.Game/Localisation/LeaderboardStrings.cs b/osu.Game/Localisation/LeaderboardStrings.cs
index 8e53f8e88c..14bc5b7af4 100644
--- a/osu.Game/Localisation/LeaderboardStrings.cs
+++ b/osu.Game/Localisation/LeaderboardStrings.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.
 
+#nullable disable
+
 using osu.Framework.Localisation;
 
 namespace osu.Game.Localisation
diff --git a/osu.Game/Localisation/MaintenanceSettingsStrings.cs b/osu.Game/Localisation/MaintenanceSettingsStrings.cs
index 7a04bcd1ca..4cb514feb0 100644
--- a/osu.Game/Localisation/MaintenanceSettingsStrings.cs
+++ b/osu.Game/Localisation/MaintenanceSettingsStrings.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.
 
+#nullable disable
+
 using osu.Framework.Localisation;
 
 namespace osu.Game.Localisation
diff --git a/osu.Game/Localisation/ModSelectOverlayStrings.cs b/osu.Game/Localisation/ModSelectOverlayStrings.cs
index e9af7147e3..3d99075922 100644
--- a/osu.Game/Localisation/ModSelectOverlayStrings.cs
+++ b/osu.Game/Localisation/ModSelectOverlayStrings.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.
 
+#nullable disable
+
 using osu.Framework.Localisation;
 
 namespace osu.Game.Localisation
diff --git a/osu.Game/Localisation/MouseSettingsStrings.cs b/osu.Game/Localisation/MouseSettingsStrings.cs
index fd7225ad2e..563d6f7637 100644
--- a/osu.Game/Localisation/MouseSettingsStrings.cs
+++ b/osu.Game/Localisation/MouseSettingsStrings.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.
 
+#nullable disable
+
 using osu.Framework.Localisation;
 
 namespace osu.Game.Localisation
diff --git a/osu.Game/Localisation/MultiplayerTeamResultsScreenStrings.cs b/osu.Game/Localisation/MultiplayerTeamResultsScreenStrings.cs
index 111c068bbd..956d5195e7 100644
--- a/osu.Game/Localisation/MultiplayerTeamResultsScreenStrings.cs
+++ b/osu.Game/Localisation/MultiplayerTeamResultsScreenStrings.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.
 
+#nullable disable
+
 using osu.Framework.Localisation;
 
 namespace osu.Game.Localisation
@@ -21,4 +23,4 @@ namespace osu.Game.Localisation
 
         private static string getKey(string key) => $@"{prefix}:{key}";
     }
-}
\ No newline at end of file
+}
diff --git a/osu.Game/Localisation/NamedOverlayComponentStrings.cs b/osu.Game/Localisation/NamedOverlayComponentStrings.cs
index 475bea2a4a..f6a50460dc 100644
--- a/osu.Game/Localisation/NamedOverlayComponentStrings.cs
+++ b/osu.Game/Localisation/NamedOverlayComponentStrings.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.
 
+#nullable disable
+
 using osu.Framework.Localisation;
 
 namespace osu.Game.Localisation
diff --git a/osu.Game/Localisation/NotificationsStrings.cs b/osu.Game/Localisation/NotificationsStrings.cs
index 382e0d81f4..c60e5d3415 100644
--- a/osu.Game/Localisation/NotificationsStrings.cs
+++ b/osu.Game/Localisation/NotificationsStrings.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.
 
+#nullable disable
+
 using osu.Framework.Localisation;
 
 namespace osu.Game.Localisation
diff --git a/osu.Game/Localisation/NowPlayingStrings.cs b/osu.Game/Localisation/NowPlayingStrings.cs
index f334637338..75d9b28ea6 100644
--- a/osu.Game/Localisation/NowPlayingStrings.cs
+++ b/osu.Game/Localisation/NowPlayingStrings.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.
 
+#nullable disable
+
 using osu.Framework.Localisation;
 
 namespace osu.Game.Localisation
diff --git a/osu.Game/Localisation/OnlineSettingsStrings.cs b/osu.Game/Localisation/OnlineSettingsStrings.cs
index 6862f4ac2c..ebb21afeb7 100644
--- a/osu.Game/Localisation/OnlineSettingsStrings.cs
+++ b/osu.Game/Localisation/OnlineSettingsStrings.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.
 
+#nullable disable
+
 using osu.Framework.Localisation;
 
 namespace osu.Game.Localisation
diff --git a/osu.Game/Localisation/ResourceManagerLocalisationStore.cs b/osu.Game/Localisation/ResourceManagerLocalisationStore.cs
index 0fb85e4a19..d2ff783413 100644
--- a/osu.Game/Localisation/ResourceManagerLocalisationStore.cs
+++ b/osu.Game/Localisation/ResourceManagerLocalisationStore.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Globalization;
diff --git a/osu.Game/Localisation/RulesetSettingsStrings.cs b/osu.Game/Localisation/RulesetSettingsStrings.cs
index a356c9e20b..08901a641e 100644
--- a/osu.Game/Localisation/RulesetSettingsStrings.cs
+++ b/osu.Game/Localisation/RulesetSettingsStrings.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.
 
+#nullable disable
+
 using osu.Framework.Localisation;
 
 namespace osu.Game.Localisation
diff --git a/osu.Game/Localisation/SettingsStrings.cs b/osu.Game/Localisation/SettingsStrings.cs
index aa2e2740eb..5dcab39e10 100644
--- a/osu.Game/Localisation/SettingsStrings.cs
+++ b/osu.Game/Localisation/SettingsStrings.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.
 
+#nullable disable
+
 using osu.Framework.Localisation;
 
 namespace osu.Game.Localisation
diff --git a/osu.Game/Localisation/SkinSettingsStrings.cs b/osu.Game/Localisation/SkinSettingsStrings.cs
index 81035c5a5e..42b72fdbb8 100644
--- a/osu.Game/Localisation/SkinSettingsStrings.cs
+++ b/osu.Game/Localisation/SkinSettingsStrings.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.
 
+#nullable disable
+
 using osu.Framework.Localisation;
 
 namespace osu.Game.Localisation
diff --git a/osu.Game/Localisation/TabletSettingsStrings.cs b/osu.Game/Localisation/TabletSettingsStrings.cs
index 5bdca09e4a..8d2bc21652 100644
--- a/osu.Game/Localisation/TabletSettingsStrings.cs
+++ b/osu.Game/Localisation/TabletSettingsStrings.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.
 
+#nullable disable
+
 using osu.Framework.Localisation;
 
 namespace osu.Game.Localisation
@@ -56,4 +58,4 @@ namespace osu.Game.Localisation
 
         private static string getKey(string key) => $@"{prefix}:{key}";
     }
-}
\ No newline at end of file
+}
diff --git a/osu.Game/Localisation/ToastStrings.cs b/osu.Game/Localisation/ToastStrings.cs
index 52e75425bf..00a0031293 100644
--- a/osu.Game/Localisation/ToastStrings.cs
+++ b/osu.Game/Localisation/ToastStrings.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.
 
+#nullable disable
+
 using osu.Framework.Localisation;
 
 namespace osu.Game.Localisation
diff --git a/osu.Game/Localisation/UserInterfaceStrings.cs b/osu.Game/Localisation/UserInterfaceStrings.cs
index 4be403edb4..4e7af99ce9 100644
--- a/osu.Game/Localisation/UserInterfaceStrings.cs
+++ b/osu.Game/Localisation/UserInterfaceStrings.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.
 
+#nullable disable
+
 using osu.Framework.Localisation;
 
 namespace osu.Game.Localisation
diff --git a/osu.Game/Migrations/20171019041408_InitialCreate.Designer.cs b/osu.Game/Migrations/20171019041408_InitialCreate.Designer.cs
index c751530bf4..7104245d9e 100644
--- a/osu.Game/Migrations/20171019041408_InitialCreate.Designer.cs
+++ b/osu.Game/Migrations/20171019041408_InitialCreate.Designer.cs
@@ -1,5 +1,7 @@
 // <auto-generated />
 using Microsoft.EntityFrameworkCore;
+
+#nullable disable
 using Microsoft.EntityFrameworkCore.Infrastructure;
 using Microsoft.EntityFrameworkCore.Metadata;
 using Microsoft.EntityFrameworkCore.Migrations;
diff --git a/osu.Game/Migrations/20171019041408_InitialCreate.cs b/osu.Game/Migrations/20171019041408_InitialCreate.cs
index 08ab64fd08..f1c7c94638 100644
--- a/osu.Game/Migrations/20171019041408_InitialCreate.cs
+++ b/osu.Game/Migrations/20171019041408_InitialCreate.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.
 
+#nullable disable
+
 using Microsoft.EntityFrameworkCore.Migrations;
 
 namespace osu.Game.Migrations
diff --git a/osu.Game/Migrations/20171025071459_AddMissingIndexRules.Designer.cs b/osu.Game/Migrations/20171025071459_AddMissingIndexRules.Designer.cs
index 4cd234f2ef..b464c15ce2 100644
--- a/osu.Game/Migrations/20171025071459_AddMissingIndexRules.Designer.cs
+++ b/osu.Game/Migrations/20171025071459_AddMissingIndexRules.Designer.cs
@@ -1,5 +1,7 @@
 // <auto-generated />
 using Microsoft.EntityFrameworkCore;
+
+#nullable disable
 using Microsoft.EntityFrameworkCore.Infrastructure;
 using Microsoft.EntityFrameworkCore.Metadata;
 using Microsoft.EntityFrameworkCore.Migrations;
diff --git a/osu.Game/Migrations/20171025071459_AddMissingIndexRules.cs b/osu.Game/Migrations/20171025071459_AddMissingIndexRules.cs
index 4ec3952941..1d0164a1d9 100644
--- a/osu.Game/Migrations/20171025071459_AddMissingIndexRules.cs
+++ b/osu.Game/Migrations/20171025071459_AddMissingIndexRules.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.
 
+#nullable disable
+
 using Microsoft.EntityFrameworkCore.Migrations;
 
 namespace osu.Game.Migrations
diff --git a/osu.Game/Migrations/20171119065731_AddBeatmapOnlineIDUniqueConstraint.Designer.cs b/osu.Game/Migrations/20171119065731_AddBeatmapOnlineIDUniqueConstraint.Designer.cs
index 006acf12cd..53e8b887d8 100644
--- a/osu.Game/Migrations/20171119065731_AddBeatmapOnlineIDUniqueConstraint.Designer.cs
+++ b/osu.Game/Migrations/20171119065731_AddBeatmapOnlineIDUniqueConstraint.Designer.cs
@@ -1,5 +1,7 @@
 // <auto-generated />
 using Microsoft.EntityFrameworkCore;
+
+#nullable disable
 using Microsoft.EntityFrameworkCore.Infrastructure;
 using Microsoft.EntityFrameworkCore.Metadata;
 using Microsoft.EntityFrameworkCore.Migrations;
diff --git a/osu.Game/Migrations/20171119065731_AddBeatmapOnlineIDUniqueConstraint.cs b/osu.Game/Migrations/20171119065731_AddBeatmapOnlineIDUniqueConstraint.cs
index 6aba12f86f..765a6a5b58 100644
--- a/osu.Game/Migrations/20171119065731_AddBeatmapOnlineIDUniqueConstraint.cs
+++ b/osu.Game/Migrations/20171119065731_AddBeatmapOnlineIDUniqueConstraint.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.
 
+#nullable disable
+
 using Microsoft.EntityFrameworkCore.Migrations;
 
 namespace osu.Game.Migrations
diff --git a/osu.Game/Migrations/20171209034410_AddRulesetInfoShortName.Designer.cs b/osu.Game/Migrations/20171209034410_AddRulesetInfoShortName.Designer.cs
index fc2496bc24..4da20141bc 100644
--- a/osu.Game/Migrations/20171209034410_AddRulesetInfoShortName.Designer.cs
+++ b/osu.Game/Migrations/20171209034410_AddRulesetInfoShortName.Designer.cs
@@ -1,5 +1,7 @@
 // <auto-generated />
 using Microsoft.EntityFrameworkCore;
+
+#nullable disable
 using Microsoft.EntityFrameworkCore.Infrastructure;
 using Microsoft.EntityFrameworkCore.Metadata;
 using Microsoft.EntityFrameworkCore.Migrations;
diff --git a/osu.Game/Migrations/20171209034410_AddRulesetInfoShortName.cs b/osu.Game/Migrations/20171209034410_AddRulesetInfoShortName.cs
index 5688455f79..3379efa68e 100644
--- a/osu.Game/Migrations/20171209034410_AddRulesetInfoShortName.cs
+++ b/osu.Game/Migrations/20171209034410_AddRulesetInfoShortName.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.
 
+#nullable disable
+
 using Microsoft.EntityFrameworkCore.Migrations;
 
 namespace osu.Game.Migrations
diff --git a/osu.Game/Migrations/20180125143340_Settings.Designer.cs b/osu.Game/Migrations/20180125143340_Settings.Designer.cs
index 4bb599eec1..68054d6404 100644
--- a/osu.Game/Migrations/20180125143340_Settings.Designer.cs
+++ b/osu.Game/Migrations/20180125143340_Settings.Designer.cs
@@ -1,5 +1,7 @@
 // <auto-generated />
 using Microsoft.EntityFrameworkCore;
+
+#nullable disable
 using Microsoft.EntityFrameworkCore.Infrastructure;
 using Microsoft.EntityFrameworkCore.Metadata;
 using Microsoft.EntityFrameworkCore.Migrations;
diff --git a/osu.Game/Migrations/20180125143340_Settings.cs b/osu.Game/Migrations/20180125143340_Settings.cs
index 1feb37531f..8f7d0a6ed3 100644
--- a/osu.Game/Migrations/20180125143340_Settings.cs
+++ b/osu.Game/Migrations/20180125143340_Settings.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.
 
+#nullable disable
+
 using Microsoft.EntityFrameworkCore.Migrations;
 
 namespace osu.Game.Migrations
diff --git a/osu.Game/Migrations/20180131154205_AddMuteBinding.cs b/osu.Game/Migrations/20180131154205_AddMuteBinding.cs
index 8646d1d76b..3e97e78e61 100644
--- a/osu.Game/Migrations/20180131154205_AddMuteBinding.cs
+++ b/osu.Game/Migrations/20180131154205_AddMuteBinding.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.
 
+#nullable disable
+
 using Microsoft.EntityFrameworkCore.Migrations;
 using Microsoft.EntityFrameworkCore.Infrastructure;
 using osu.Game.Database;
diff --git a/osu.Game/Migrations/20180219060912_AddSkins.Designer.cs b/osu.Game/Migrations/20180219060912_AddSkins.Designer.cs
index cdc4ef2e66..7d95a702b8 100644
--- a/osu.Game/Migrations/20180219060912_AddSkins.Designer.cs
+++ b/osu.Game/Migrations/20180219060912_AddSkins.Designer.cs
@@ -1,5 +1,7 @@
 // <auto-generated />
 using Microsoft.EntityFrameworkCore;
+
+#nullable disable
 using Microsoft.EntityFrameworkCore.Infrastructure;
 using Microsoft.EntityFrameworkCore.Metadata;
 using Microsoft.EntityFrameworkCore.Migrations;
diff --git a/osu.Game/Migrations/20180219060912_AddSkins.cs b/osu.Game/Migrations/20180219060912_AddSkins.cs
index 319748bed6..df9d267a14 100644
--- a/osu.Game/Migrations/20180219060912_AddSkins.cs
+++ b/osu.Game/Migrations/20180219060912_AddSkins.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.
 
+#nullable disable
+
 using Microsoft.EntityFrameworkCore.Migrations;
 
 namespace osu.Game.Migrations
diff --git a/osu.Game/Migrations/20180529055154_RemoveUniqueHashConstraints.Designer.cs b/osu.Game/Migrations/20180529055154_RemoveUniqueHashConstraints.Designer.cs
index f28408bfb3..7e490c7833 100644
--- a/osu.Game/Migrations/20180529055154_RemoveUniqueHashConstraints.Designer.cs
+++ b/osu.Game/Migrations/20180529055154_RemoveUniqueHashConstraints.Designer.cs
@@ -1,5 +1,7 @@
 // <auto-generated />
 using Microsoft.EntityFrameworkCore;
+
+#nullable disable
 using Microsoft.EntityFrameworkCore.Infrastructure;
 using Microsoft.EntityFrameworkCore.Metadata;
 using Microsoft.EntityFrameworkCore.Migrations;
diff --git a/osu.Game/Migrations/20180529055154_RemoveUniqueHashConstraints.cs b/osu.Game/Migrations/20180529055154_RemoveUniqueHashConstraints.cs
index 91eabe8868..62c341b0c6 100644
--- a/osu.Game/Migrations/20180529055154_RemoveUniqueHashConstraints.cs
+++ b/osu.Game/Migrations/20180529055154_RemoveUniqueHashConstraints.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.
 
+#nullable disable
+
 using Microsoft.EntityFrameworkCore.Migrations;
 
 namespace osu.Game.Migrations
diff --git a/osu.Game/Migrations/20180621044111_UpdateTaikoDefaultBindings.Designer.cs b/osu.Game/Migrations/20180621044111_UpdateTaikoDefaultBindings.Designer.cs
index aaa11e88b6..a103cdad20 100644
--- a/osu.Game/Migrations/20180621044111_UpdateTaikoDefaultBindings.Designer.cs
+++ b/osu.Game/Migrations/20180621044111_UpdateTaikoDefaultBindings.Designer.cs
@@ -1,5 +1,7 @@
 // <auto-generated />
 using System;
+
+#nullable disable
 using Microsoft.EntityFrameworkCore;
 using Microsoft.EntityFrameworkCore.Infrastructure;
 using Microsoft.EntityFrameworkCore.Migrations;
diff --git a/osu.Game/Migrations/20180621044111_UpdateTaikoDefaultBindings.cs b/osu.Game/Migrations/20180621044111_UpdateTaikoDefaultBindings.cs
index d888ccd5a2..b08fa7a899 100644
--- a/osu.Game/Migrations/20180621044111_UpdateTaikoDefaultBindings.cs
+++ b/osu.Game/Migrations/20180621044111_UpdateTaikoDefaultBindings.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.
 
+#nullable disable
+
 using Microsoft.EntityFrameworkCore.Migrations;
 
 namespace osu.Game.Migrations
diff --git a/osu.Game/Migrations/20180628011956_RemoveNegativeSetIDs.Designer.cs b/osu.Game/Migrations/20180628011956_RemoveNegativeSetIDs.Designer.cs
index 7eeacd56d7..5b1734554a 100644
--- a/osu.Game/Migrations/20180628011956_RemoveNegativeSetIDs.Designer.cs
+++ b/osu.Game/Migrations/20180628011956_RemoveNegativeSetIDs.Designer.cs
@@ -1,5 +1,7 @@
 // <auto-generated />
 using System;
+
+#nullable disable
 using Microsoft.EntityFrameworkCore;
 using Microsoft.EntityFrameworkCore.Infrastructure;
 using Microsoft.EntityFrameworkCore.Migrations;
diff --git a/osu.Game/Migrations/20180628011956_RemoveNegativeSetIDs.cs b/osu.Game/Migrations/20180628011956_RemoveNegativeSetIDs.cs
index fdea636ac6..4ba0a4d0e6 100644
--- a/osu.Game/Migrations/20180628011956_RemoveNegativeSetIDs.cs
+++ b/osu.Game/Migrations/20180628011956_RemoveNegativeSetIDs.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.
 
+#nullable disable
+
 using Microsoft.EntityFrameworkCore.Migrations;
 
 namespace osu.Game.Migrations
diff --git a/osu.Game/Migrations/20180913080842_AddRankStatus.Designer.cs b/osu.Game/Migrations/20180913080842_AddRankStatus.Designer.cs
index 5ab43da046..ceef5b6948 100644
--- a/osu.Game/Migrations/20180913080842_AddRankStatus.Designer.cs
+++ b/osu.Game/Migrations/20180913080842_AddRankStatus.Designer.cs
@@ -1,5 +1,7 @@
 // <auto-generated />
 using System;
+
+#nullable disable
 using Microsoft.EntityFrameworkCore;
 using Microsoft.EntityFrameworkCore.Infrastructure;
 using Microsoft.EntityFrameworkCore.Migrations;
diff --git a/osu.Game/Migrations/20180913080842_AddRankStatus.cs b/osu.Game/Migrations/20180913080842_AddRankStatus.cs
index bb147dff84..ec82925b03 100644
--- a/osu.Game/Migrations/20180913080842_AddRankStatus.cs
+++ b/osu.Game/Migrations/20180913080842_AddRankStatus.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.
 
+#nullable disable
+
 using Microsoft.EntityFrameworkCore.Migrations;
 
 namespace osu.Game.Migrations
diff --git a/osu.Game/Migrations/20181007180454_StandardizePaths.Designer.cs b/osu.Game/Migrations/20181007180454_StandardizePaths.Designer.cs
index b387a45ecf..d1185ef186 100644
--- a/osu.Game/Migrations/20181007180454_StandardizePaths.Designer.cs
+++ b/osu.Game/Migrations/20181007180454_StandardizePaths.Designer.cs
@@ -1,5 +1,7 @@
 // <auto-generated />
 using System;
+
+#nullable disable
 using Microsoft.EntityFrameworkCore;
 using Microsoft.EntityFrameworkCore.Infrastructure;
 using Microsoft.EntityFrameworkCore.Migrations;
diff --git a/osu.Game/Migrations/20181007180454_StandardizePaths.cs b/osu.Game/Migrations/20181007180454_StandardizePaths.cs
index 30f27043a0..f9323c0b9b 100644
--- a/osu.Game/Migrations/20181007180454_StandardizePaths.cs
+++ b/osu.Game/Migrations/20181007180454_StandardizePaths.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.
 
+#nullable disable
+
 using Microsoft.EntityFrameworkCore.Migrations;
 
 namespace osu.Game.Migrations
diff --git a/osu.Game/Migrations/20181128100659_AddSkinInfoHash.Designer.cs b/osu.Game/Migrations/20181128100659_AddSkinInfoHash.Designer.cs
index 120674671a..0797090c7b 100644
--- a/osu.Game/Migrations/20181128100659_AddSkinInfoHash.Designer.cs
+++ b/osu.Game/Migrations/20181128100659_AddSkinInfoHash.Designer.cs
@@ -1,5 +1,7 @@
 // <auto-generated />
 using System;
+
+#nullable disable
 using Microsoft.EntityFrameworkCore;
 using Microsoft.EntityFrameworkCore.Infrastructure;
 using Microsoft.EntityFrameworkCore.Migrations;
diff --git a/osu.Game/Migrations/20181128100659_AddSkinInfoHash.cs b/osu.Game/Migrations/20181128100659_AddSkinInfoHash.cs
index ee825a1e9c..43689f2a3c 100644
--- a/osu.Game/Migrations/20181128100659_AddSkinInfoHash.cs
+++ b/osu.Game/Migrations/20181128100659_AddSkinInfoHash.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.
 
+#nullable disable
+
 using Microsoft.EntityFrameworkCore.Migrations;
 
 namespace osu.Game.Migrations
diff --git a/osu.Game/Migrations/20181130113755_AddScoreInfoTables.Designer.cs b/osu.Game/Migrations/20181130113755_AddScoreInfoTables.Designer.cs
index eee53182ce..3b70ad8d45 100644
--- a/osu.Game/Migrations/20181130113755_AddScoreInfoTables.Designer.cs
+++ b/osu.Game/Migrations/20181130113755_AddScoreInfoTables.Designer.cs
@@ -1,5 +1,7 @@
 // <auto-generated />
 using System;
+
+#nullable disable
 using Microsoft.EntityFrameworkCore;
 using Microsoft.EntityFrameworkCore.Infrastructure;
 using Microsoft.EntityFrameworkCore.Migrations;
diff --git a/osu.Game/Migrations/20181130113755_AddScoreInfoTables.cs b/osu.Game/Migrations/20181130113755_AddScoreInfoTables.cs
index 58980132f3..f52edacc7f 100644
--- a/osu.Game/Migrations/20181130113755_AddScoreInfoTables.cs
+++ b/osu.Game/Migrations/20181130113755_AddScoreInfoTables.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.
 
+#nullable disable
+
 using System;
 using Microsoft.EntityFrameworkCore.Migrations;
 
diff --git a/osu.Game/Migrations/20190225062029_AddUserIDColumn.Designer.cs b/osu.Game/Migrations/20190225062029_AddUserIDColumn.Designer.cs
index 8e1e3a59f3..51b63bd9eb 100644
--- a/osu.Game/Migrations/20190225062029_AddUserIDColumn.Designer.cs
+++ b/osu.Game/Migrations/20190225062029_AddUserIDColumn.Designer.cs
@@ -1,5 +1,7 @@
 // <auto-generated />
 using System;
+
+#nullable disable
 using Microsoft.EntityFrameworkCore;
 using Microsoft.EntityFrameworkCore.Infrastructure;
 using Microsoft.EntityFrameworkCore.Migrations;
diff --git a/osu.Game/Migrations/20190225062029_AddUserIDColumn.cs b/osu.Game/Migrations/20190225062029_AddUserIDColumn.cs
index f2eef600dc..00d807d5c4 100644
--- a/osu.Game/Migrations/20190225062029_AddUserIDColumn.cs
+++ b/osu.Game/Migrations/20190225062029_AddUserIDColumn.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.
 
+#nullable disable
+
 using Microsoft.EntityFrameworkCore.Migrations;
 
 namespace osu.Game.Migrations
diff --git a/osu.Game/Migrations/20190525060824_SkinSettings.Designer.cs b/osu.Game/Migrations/20190525060824_SkinSettings.Designer.cs
index 348c42adb9..9d6515e5c6 100644
--- a/osu.Game/Migrations/20190525060824_SkinSettings.Designer.cs
+++ b/osu.Game/Migrations/20190525060824_SkinSettings.Designer.cs
@@ -1,5 +1,7 @@
 // <auto-generated />
 using System;
+
+#nullable disable
 using Microsoft.EntityFrameworkCore;
 using Microsoft.EntityFrameworkCore.Infrastructure;
 using Microsoft.EntityFrameworkCore.Migrations;
diff --git a/osu.Game/Migrations/20190525060824_SkinSettings.cs b/osu.Game/Migrations/20190525060824_SkinSettings.cs
index 7779b55bb7..463d4fe1ad 100644
--- a/osu.Game/Migrations/20190525060824_SkinSettings.cs
+++ b/osu.Game/Migrations/20190525060824_SkinSettings.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.
 
+#nullable disable
+
 using Microsoft.EntityFrameworkCore.Migrations;
 
 namespace osu.Game.Migrations
diff --git a/osu.Game/Migrations/20190605091246_AddDateAddedColumnToBeatmapSet.Designer.cs b/osu.Game/Migrations/20190605091246_AddDateAddedColumnToBeatmapSet.Designer.cs
index 9477369aa0..1bc2e76ae5 100644
--- a/osu.Game/Migrations/20190605091246_AddDateAddedColumnToBeatmapSet.Designer.cs
+++ b/osu.Game/Migrations/20190605091246_AddDateAddedColumnToBeatmapSet.Designer.cs
@@ -1,5 +1,7 @@
 // <auto-generated />
 using System;
+
+#nullable disable
 using Microsoft.EntityFrameworkCore;
 using Microsoft.EntityFrameworkCore.Infrastructure;
 using Microsoft.EntityFrameworkCore.Migrations;
diff --git a/osu.Game/Migrations/20190605091246_AddDateAddedColumnToBeatmapSet.cs b/osu.Game/Migrations/20190605091246_AddDateAddedColumnToBeatmapSet.cs
index 0620a0624f..61925a4cb4 100644
--- a/osu.Game/Migrations/20190605091246_AddDateAddedColumnToBeatmapSet.cs
+++ b/osu.Game/Migrations/20190605091246_AddDateAddedColumnToBeatmapSet.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.
 
+#nullable disable
+
 using System;
 using Microsoft.EntityFrameworkCore.Migrations;
 
diff --git a/osu.Game/Migrations/20190708070844_AddBPMAndLengthColumns.Designer.cs b/osu.Game/Migrations/20190708070844_AddBPMAndLengthColumns.Designer.cs
index c5fcc16f84..c51b8739bc 100644
--- a/osu.Game/Migrations/20190708070844_AddBPMAndLengthColumns.Designer.cs
+++ b/osu.Game/Migrations/20190708070844_AddBPMAndLengthColumns.Designer.cs
@@ -1,5 +1,7 @@
 // <auto-generated />
 using System;
+
+#nullable disable
 using Microsoft.EntityFrameworkCore;
 using Microsoft.EntityFrameworkCore.Infrastructure;
 using Microsoft.EntityFrameworkCore.Migrations;
diff --git a/osu.Game/Migrations/20190708070844_AddBPMAndLengthColumns.cs b/osu.Game/Migrations/20190708070844_AddBPMAndLengthColumns.cs
index f8ce354aa1..19a2464157 100644
--- a/osu.Game/Migrations/20190708070844_AddBPMAndLengthColumns.cs
+++ b/osu.Game/Migrations/20190708070844_AddBPMAndLengthColumns.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.
 
+#nullable disable
+
 using Microsoft.EntityFrameworkCore.Migrations;
 
 namespace osu.Game.Migrations
diff --git a/osu.Game/Migrations/20190913104727_AddBeatmapVideo.Designer.cs b/osu.Game/Migrations/20190913104727_AddBeatmapVideo.Designer.cs
index 826233a2b0..95583e7587 100644
--- a/osu.Game/Migrations/20190913104727_AddBeatmapVideo.Designer.cs
+++ b/osu.Game/Migrations/20190913104727_AddBeatmapVideo.Designer.cs
@@ -1,5 +1,7 @@
 // <auto-generated />
 using System;
+
+#nullable disable
 using Microsoft.EntityFrameworkCore;
 using Microsoft.EntityFrameworkCore.Infrastructure;
 using Microsoft.EntityFrameworkCore.Migrations;
diff --git a/osu.Game/Migrations/20190913104727_AddBeatmapVideo.cs b/osu.Game/Migrations/20190913104727_AddBeatmapVideo.cs
index af82b4db20..c1208e0bf1 100644
--- a/osu.Game/Migrations/20190913104727_AddBeatmapVideo.cs
+++ b/osu.Game/Migrations/20190913104727_AddBeatmapVideo.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.
 
+#nullable disable
+
 using Microsoft.EntityFrameworkCore.Migrations;
 
 namespace osu.Game.Migrations
diff --git a/osu.Game/Migrations/20200302094919_RefreshVolumeBindings.Designer.cs b/osu.Game/Migrations/20200302094919_RefreshVolumeBindings.Designer.cs
index 22316b0380..3c7de0602b 100644
--- a/osu.Game/Migrations/20200302094919_RefreshVolumeBindings.Designer.cs
+++ b/osu.Game/Migrations/20200302094919_RefreshVolumeBindings.Designer.cs
@@ -1,5 +1,7 @@
 // <auto-generated />
 using System;
+
+#nullable disable
 using Microsoft.EntityFrameworkCore;
 using Microsoft.EntityFrameworkCore.Infrastructure;
 using Microsoft.EntityFrameworkCore.Migrations;
diff --git a/osu.Game/Migrations/20200302094919_RefreshVolumeBindings.cs b/osu.Game/Migrations/20200302094919_RefreshVolumeBindings.cs
index 3d2ddbf6fc..73cfb1725b 100644
--- a/osu.Game/Migrations/20200302094919_RefreshVolumeBindings.cs
+++ b/osu.Game/Migrations/20200302094919_RefreshVolumeBindings.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.
 
+#nullable disable
+
 using Microsoft.EntityFrameworkCore.Migrations;
 
 namespace osu.Game.Migrations
diff --git a/osu.Game/Migrations/20201019224408_AddEpilepsyWarning.Designer.cs b/osu.Game/Migrations/20201019224408_AddEpilepsyWarning.Designer.cs
index 1c05de832e..24acc3195f 100644
--- a/osu.Game/Migrations/20201019224408_AddEpilepsyWarning.Designer.cs
+++ b/osu.Game/Migrations/20201019224408_AddEpilepsyWarning.Designer.cs
@@ -1,5 +1,7 @@
 // <auto-generated />
 using System;
+
+#nullable disable
 using Microsoft.EntityFrameworkCore;
 using Microsoft.EntityFrameworkCore.Infrastructure;
 using Microsoft.EntityFrameworkCore.Migrations;
diff --git a/osu.Game/Migrations/20201019224408_AddEpilepsyWarning.cs b/osu.Game/Migrations/20201019224408_AddEpilepsyWarning.cs
index 58a35a7bf3..eaca8785f9 100644
--- a/osu.Game/Migrations/20201019224408_AddEpilepsyWarning.cs
+++ b/osu.Game/Migrations/20201019224408_AddEpilepsyWarning.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.
 
+#nullable disable
+
 using Microsoft.EntityFrameworkCore.Migrations;
 
 namespace osu.Game.Migrations
diff --git a/osu.Game/Migrations/20210412045700_RefreshVolumeBindingsAgain.Designer.cs b/osu.Game/Migrations/20210412045700_RefreshVolumeBindingsAgain.Designer.cs
index 2c100d39b9..704af354c9 100644
--- a/osu.Game/Migrations/20210412045700_RefreshVolumeBindingsAgain.Designer.cs
+++ b/osu.Game/Migrations/20210412045700_RefreshVolumeBindingsAgain.Designer.cs
@@ -1,5 +1,7 @@
 // <auto-generated />
 using System;
+
+#nullable disable
 using Microsoft.EntityFrameworkCore;
 using Microsoft.EntityFrameworkCore.Infrastructure;
 using Microsoft.EntityFrameworkCore.Migrations;
diff --git a/osu.Game/Migrations/20210412045700_RefreshVolumeBindingsAgain.cs b/osu.Game/Migrations/20210412045700_RefreshVolumeBindingsAgain.cs
index 4d3941dd20..7772c0e86b 100644
--- a/osu.Game/Migrations/20210412045700_RefreshVolumeBindingsAgain.cs
+++ b/osu.Game/Migrations/20210412045700_RefreshVolumeBindingsAgain.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.
 
+#nullable disable
+
 using Microsoft.EntityFrameworkCore.Migrations;
 
 namespace osu.Game.Migrations
diff --git a/osu.Game/Migrations/20210511060743_AddSkinInstantiationInfo.Designer.cs b/osu.Game/Migrations/20210511060743_AddSkinInstantiationInfo.Designer.cs
index b808c648da..097bd6a244 100644
--- a/osu.Game/Migrations/20210511060743_AddSkinInstantiationInfo.Designer.cs
+++ b/osu.Game/Migrations/20210511060743_AddSkinInstantiationInfo.Designer.cs
@@ -1,5 +1,7 @@
 // <auto-generated />
 using System;
+
+#nullable disable
 using Microsoft.EntityFrameworkCore;
 using Microsoft.EntityFrameworkCore.Infrastructure;
 using Microsoft.EntityFrameworkCore.Migrations;
diff --git a/osu.Game/Migrations/20210511060743_AddSkinInstantiationInfo.cs b/osu.Game/Migrations/20210511060743_AddSkinInstantiationInfo.cs
index 887635fa85..1cc9ab6120 100644
--- a/osu.Game/Migrations/20210511060743_AddSkinInstantiationInfo.cs
+++ b/osu.Game/Migrations/20210511060743_AddSkinInstantiationInfo.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.
 
+#nullable disable
+
 using Microsoft.EntityFrameworkCore.Migrations;
 
 namespace osu.Game.Migrations
diff --git a/osu.Game/Migrations/20210514062639_AddAuthorIdToBeatmapMetadata.Designer.cs b/osu.Game/Migrations/20210514062639_AddAuthorIdToBeatmapMetadata.Designer.cs
index 89bab3a0fa..ca9502422b 100644
--- a/osu.Game/Migrations/20210514062639_AddAuthorIdToBeatmapMetadata.Designer.cs
+++ b/osu.Game/Migrations/20210514062639_AddAuthorIdToBeatmapMetadata.Designer.cs
@@ -1,5 +1,7 @@
 // <auto-generated />
 using System;
+
+#nullable disable
 using Microsoft.EntityFrameworkCore;
 using Microsoft.EntityFrameworkCore.Infrastructure;
 using Microsoft.EntityFrameworkCore.Migrations;
diff --git a/osu.Game/Migrations/20210514062639_AddAuthorIdToBeatmapMetadata.cs b/osu.Game/Migrations/20210514062639_AddAuthorIdToBeatmapMetadata.cs
index 7b579e27b9..82c5b27769 100644
--- a/osu.Game/Migrations/20210514062639_AddAuthorIdToBeatmapMetadata.cs
+++ b/osu.Game/Migrations/20210514062639_AddAuthorIdToBeatmapMetadata.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.
 
+#nullable disable
+
 using Microsoft.EntityFrameworkCore.Migrations;
 
 namespace osu.Game.Migrations
diff --git a/osu.Game/Migrations/20210824185035_AddCountdownSettings.Designer.cs b/osu.Game/Migrations/20210824185035_AddCountdownSettings.Designer.cs
index afeb42130d..2a4e370649 100644
--- a/osu.Game/Migrations/20210824185035_AddCountdownSettings.Designer.cs
+++ b/osu.Game/Migrations/20210824185035_AddCountdownSettings.Designer.cs
@@ -1,5 +1,7 @@
 // <auto-generated />
 using System;
+
+#nullable disable
 using Microsoft.EntityFrameworkCore;
 using Microsoft.EntityFrameworkCore.Infrastructure;
 using Microsoft.EntityFrameworkCore.Migrations;
diff --git a/osu.Game/Migrations/20210824185035_AddCountdownSettings.cs b/osu.Game/Migrations/20210824185035_AddCountdownSettings.cs
index d1b09e2c1d..dd6fa23387 100644
--- a/osu.Game/Migrations/20210824185035_AddCountdownSettings.cs
+++ b/osu.Game/Migrations/20210824185035_AddCountdownSettings.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.
 
+#nullable disable
+
 using Microsoft.EntityFrameworkCore.Migrations;
 
 namespace osu.Game.Migrations
diff --git a/osu.Game/Migrations/20210912144011_AddSamplesMatchPlaybackRate.Designer.cs b/osu.Game/Migrations/20210912144011_AddSamplesMatchPlaybackRate.Designer.cs
index 6e53d7fae0..9e09f2c69e 100644
--- a/osu.Game/Migrations/20210912144011_AddSamplesMatchPlaybackRate.Designer.cs
+++ b/osu.Game/Migrations/20210912144011_AddSamplesMatchPlaybackRate.Designer.cs
@@ -1,5 +1,7 @@
 // <auto-generated />
 using System;
+
+#nullable disable
 using Microsoft.EntityFrameworkCore;
 using Microsoft.EntityFrameworkCore.Infrastructure;
 using Microsoft.EntityFrameworkCore.Migrations;
diff --git a/osu.Game/Migrations/20210912144011_AddSamplesMatchPlaybackRate.cs b/osu.Game/Migrations/20210912144011_AddSamplesMatchPlaybackRate.cs
index f6fc1f4420..0598a41f09 100644
--- a/osu.Game/Migrations/20210912144011_AddSamplesMatchPlaybackRate.cs
+++ b/osu.Game/Migrations/20210912144011_AddSamplesMatchPlaybackRate.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.
 
+#nullable disable
+
 using Microsoft.EntityFrameworkCore.Migrations;
 
 namespace osu.Game.Migrations
diff --git a/osu.Game/Migrations/20211020081609_ResetSkinHashes.cs b/osu.Game/Migrations/20211020081609_ResetSkinHashes.cs
index 6d53c019ec..0f7a2a5702 100644
--- a/osu.Game/Migrations/20211020081609_ResetSkinHashes.cs
+++ b/osu.Game/Migrations/20211020081609_ResetSkinHashes.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.
 
+#nullable disable
+
 using Microsoft.EntityFrameworkCore.Infrastructure;
 using Microsoft.EntityFrameworkCore.Migrations;
 using osu.Game.Database;
diff --git a/osu.Game/Migrations/OsuDbContextModelSnapshot.cs b/osu.Game/Migrations/OsuDbContextModelSnapshot.cs
index 036c26cb0a..7e38889fa6 100644
--- a/osu.Game/Migrations/OsuDbContextModelSnapshot.cs
+++ b/osu.Game/Migrations/OsuDbContextModelSnapshot.cs
@@ -1,5 +1,7 @@
 // <auto-generated />
 using System;
+
+#nullable disable
 using Microsoft.EntityFrameworkCore;
 using Microsoft.EntityFrameworkCore.Infrastructure;
 using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
diff --git a/osu.Game/Models/RealmFile.cs b/osu.Game/Models/RealmFile.cs
index 9e8da7cdc4..f96b717937 100644
--- a/osu.Game/Models/RealmFile.cs
+++ b/osu.Game/Models/RealmFile.cs
@@ -5,8 +5,6 @@ using osu.Framework.Testing;
 using osu.Game.IO;
 using Realms;
 
-#nullable enable
-
 namespace osu.Game.Models
 {
     [ExcludeFromDynamicCompile]
diff --git a/osu.Game/Models/RealmNamedFileUsage.cs b/osu.Game/Models/RealmNamedFileUsage.cs
index 17e32510a8..0f6f439d73 100644
--- a/osu.Game/Models/RealmNamedFileUsage.cs
+++ b/osu.Game/Models/RealmNamedFileUsage.cs
@@ -7,8 +7,6 @@ using osu.Game.Database;
 using osu.Game.IO;
 using Realms;
 
-#nullable enable
-
 namespace osu.Game.Models
 {
     [ExcludeFromDynamicCompile]
diff --git a/osu.Game/Models/RealmUser.cs b/osu.Game/Models/RealmUser.cs
index 18c849cf0a..58fd7ff2a3 100644
--- a/osu.Game/Models/RealmUser.cs
+++ b/osu.Game/Models/RealmUser.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.
 
+#nullable disable
+
 using System;
 using osu.Game.Database;
 using osu.Game.Users;
diff --git a/osu.Game/Online/API/APIAccess.cs b/osu.Game/Online/API/APIAccess.cs
index 62ddd49881..088dc56701 100644
--- a/osu.Game/Online/API/APIAccess.cs
+++ b/osu.Game/Online/API/APIAccess.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Diagnostics;
diff --git a/osu.Game/Online/API/APIDownloadRequest.cs b/osu.Game/Online/API/APIDownloadRequest.cs
index 11753e05ba..c48372278a 100644
--- a/osu.Game/Online/API/APIDownloadRequest.cs
+++ b/osu.Game/Online/API/APIDownloadRequest.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.
 
+#nullable disable
+
 using System;
 using System.IO;
 using osu.Framework.IO.Network;
diff --git a/osu.Game/Online/API/APIException.cs b/osu.Game/Online/API/APIException.cs
index 54d68d8f0d..21a9c761c7 100644
--- a/osu.Game/Online/API/APIException.cs
+++ b/osu.Game/Online/API/APIException.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.
 
+#nullable disable
+
 using System;
 
 namespace osu.Game.Online.API
diff --git a/osu.Game/Online/API/APIMessagesRequest.cs b/osu.Game/Online/API/APIMessagesRequest.cs
index 3ad6b1d7c8..5bb3e29621 100644
--- a/osu.Game/Online/API/APIMessagesRequest.cs
+++ b/osu.Game/Online/API/APIMessagesRequest.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Framework.IO.Network;
 using osu.Game.Online.Chat;
diff --git a/osu.Game/Online/API/APIMod.cs b/osu.Game/Online/API/APIMod.cs
index 524f7b7108..dc1db08174 100644
--- a/osu.Game/Online/API/APIMod.cs
+++ b/osu.Game/Online/API/APIMod.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Online/API/APIRequest.cs b/osu.Game/Online/API/APIRequest.cs
index 451ea117d5..dc6a3fe3d5 100644
--- a/osu.Game/Online/API/APIRequest.cs
+++ b/osu.Game/Online/API/APIRequest.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.
 
+#nullable disable
+
 using System;
 using System.Globalization;
 using JetBrains.Annotations;
diff --git a/osu.Game/Online/API/APIRequestCompletionState.cs b/osu.Game/Online/API/APIRequestCompletionState.cs
index 84c9974dd8..52eb669a7d 100644
--- a/osu.Game/Online/API/APIRequestCompletionState.cs
+++ b/osu.Game/Online/API/APIRequestCompletionState.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.
 
+#nullable disable
+
 namespace osu.Game.Online.API
 {
     public enum APIRequestCompletionState
diff --git a/osu.Game/Online/API/ArchiveDownloadRequest.cs b/osu.Game/Online/API/ArchiveDownloadRequest.cs
index 0bf238109e..ff96b39e08 100644
--- a/osu.Game/Online/API/ArchiveDownloadRequest.cs
+++ b/osu.Game/Online/API/ArchiveDownloadRequest.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.
 
+#nullable disable
+
 using System;
 
 namespace osu.Game.Online.API
diff --git a/osu.Game/Online/API/DummyAPIAccess.cs b/osu.Game/Online/API/DummyAPIAccess.cs
index d3707d977c..245760a00a 100644
--- a/osu.Game/Online/API/DummyAPIAccess.cs
+++ b/osu.Game/Online/API/DummyAPIAccess.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.
 
+#nullable disable
+
 using System;
 using System.Threading;
 using System.Threading.Tasks;
diff --git a/osu.Game/Online/API/IAPIProvider.cs b/osu.Game/Online/API/IAPIProvider.cs
index 470d46cd7f..812aa7f09f 100644
--- a/osu.Game/Online/API/IAPIProvider.cs
+++ b/osu.Game/Online/API/IAPIProvider.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 enable
-
 using System;
 using System.Threading.Tasks;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Online/API/ModSettingsDictionaryFormatter.cs b/osu.Game/Online/API/ModSettingsDictionaryFormatter.cs
index a7c63c17f9..df64984c7a 100644
--- a/osu.Game/Online/API/ModSettingsDictionaryFormatter.cs
+++ b/osu.Game/Online/API/ModSettingsDictionaryFormatter.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.
 
+#nullable disable
+
 using System.Buffers;
 using System.Collections.Generic;
 using System.Text;
diff --git a/osu.Game/Online/API/OAuth.cs b/osu.Game/Online/API/OAuth.cs
index 1feb3076d1..58306c1938 100644
--- a/osu.Game/Online/API/OAuth.cs
+++ b/osu.Game/Online/API/OAuth.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.
 
+#nullable disable
+
 using System;
 using System.Diagnostics;
 using System.Net.Http;
diff --git a/osu.Game/Online/API/OAuthToken.cs b/osu.Game/Online/API/OAuthToken.cs
index f103d0917d..63c88b875b 100644
--- a/osu.Game/Online/API/OAuthToken.cs
+++ b/osu.Game/Online/API/OAuthToken.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.
 
+#nullable disable
+
 using System;
 using System.Globalization;
 using Newtonsoft.Json;
diff --git a/osu.Game/Online/API/OsuJsonWebRequest.cs b/osu.Game/Online/API/OsuJsonWebRequest.cs
index 4a45a8b261..2d402edd3f 100644
--- a/osu.Game/Online/API/OsuJsonWebRequest.cs
+++ b/osu.Game/Online/API/OsuJsonWebRequest.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.
 
+#nullable disable
+
 using osu.Framework.IO.Network;
 
 namespace osu.Game.Online.API
diff --git a/osu.Game/Online/API/OsuWebRequest.cs b/osu.Game/Online/API/OsuWebRequest.cs
index 1d27899473..9a7cf45a2f 100644
--- a/osu.Game/Online/API/OsuWebRequest.cs
+++ b/osu.Game/Online/API/OsuWebRequest.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.
 
+#nullable disable
+
 using osu.Framework.IO.Network;
 
 namespace osu.Game.Online.API
diff --git a/osu.Game/Online/API/RegistrationRequest.cs b/osu.Game/Online/API/RegistrationRequest.cs
index f650e5c93b..6dc867481a 100644
--- a/osu.Game/Online/API/RegistrationRequest.cs
+++ b/osu.Game/Online/API/RegistrationRequest.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.
 
+#nullable disable
+
 using Newtonsoft.Json;
 
 namespace osu.Game.Online.API
diff --git a/osu.Game/Online/API/Requests/CommentVoteRequest.cs b/osu.Game/Online/API/Requests/CommentVoteRequest.cs
index 06a3b1126e..a835b0365c 100644
--- a/osu.Game/Online/API/Requests/CommentVoteRequest.cs
+++ b/osu.Game/Online/API/Requests/CommentVoteRequest.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.
 
+#nullable disable
+
 using osu.Framework.IO.Network;
 using osu.Game.Online.API.Requests.Responses;
 using System.Net.Http;
diff --git a/osu.Game/Online/API/Requests/CreateChannelRequest.cs b/osu.Game/Online/API/Requests/CreateChannelRequest.cs
index 041ad26267..130210b1c3 100644
--- a/osu.Game/Online/API/Requests/CreateChannelRequest.cs
+++ b/osu.Game/Online/API/Requests/CreateChannelRequest.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.
 
+#nullable disable
+
 using System.Linq;
 using System.Net.Http;
 using osu.Framework.IO.Network;
diff --git a/osu.Game/Online/API/Requests/CreateNewPrivateMessageRequest.cs b/osu.Game/Online/API/Requests/CreateNewPrivateMessageRequest.cs
index e5761149e7..dea94bfce2 100644
--- a/osu.Game/Online/API/Requests/CreateNewPrivateMessageRequest.cs
+++ b/osu.Game/Online/API/Requests/CreateNewPrivateMessageRequest.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.
 
+#nullable disable
+
 using System.Net.Http;
 using osu.Framework.IO.Network;
 using osu.Game.Online.API.Requests.Responses;
diff --git a/osu.Game/Online/API/Requests/CreateNewPrivateMessageResponse.cs b/osu.Game/Online/API/Requests/CreateNewPrivateMessageResponse.cs
index f749b27114..1af61770df 100644
--- a/osu.Game/Online/API/Requests/CreateNewPrivateMessageResponse.cs
+++ b/osu.Game/Online/API/Requests/CreateNewPrivateMessageResponse.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.
 
+#nullable disable
+
 using Newtonsoft.Json;
 using osu.Game.Online.Chat;
 
diff --git a/osu.Game/Online/API/Requests/Cursor.cs b/osu.Game/Online/API/Requests/Cursor.cs
index 3de8db770c..c7bb119bd8 100644
--- a/osu.Game/Online/API/Requests/Cursor.cs
+++ b/osu.Game/Online/API/Requests/Cursor.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using JetBrains.Annotations;
 using Newtonsoft.Json;
diff --git a/osu.Game/Online/API/Requests/DownloadBeatmapSetRequest.cs b/osu.Game/Online/API/Requests/DownloadBeatmapSetRequest.cs
index 5254dc3cf8..f190b6e821 100644
--- a/osu.Game/Online/API/Requests/DownloadBeatmapSetRequest.cs
+++ b/osu.Game/Online/API/Requests/DownloadBeatmapSetRequest.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.
 
+#nullable disable
+
 using osu.Framework.IO.Network;
 using osu.Game.Beatmaps;
 
diff --git a/osu.Game/Online/API/Requests/DownloadReplayRequest.cs b/osu.Game/Online/API/Requests/DownloadReplayRequest.cs
index 77174f0bb5..5635c4728e 100644
--- a/osu.Game/Online/API/Requests/DownloadReplayRequest.cs
+++ b/osu.Game/Online/API/Requests/DownloadReplayRequest.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.
 
+#nullable disable
+
 using osu.Game.Scoring;
 
 namespace osu.Game.Online.API.Requests
diff --git a/osu.Game/Online/API/Requests/GetBeatmapRequest.cs b/osu.Game/Online/API/Requests/GetBeatmapRequest.cs
index 671f543422..efecc0fc25 100644
--- a/osu.Game/Online/API/Requests/GetBeatmapRequest.cs
+++ b/osu.Game/Online/API/Requests/GetBeatmapRequest.cs
@@ -5,8 +5,6 @@ using osu.Framework.IO.Network;
 using osu.Game.Beatmaps;
 using osu.Game.Online.API.Requests.Responses;
 
-#nullable enable
-
 namespace osu.Game.Online.API.Requests
 {
     public class GetBeatmapRequest : APIRequest<APIBeatmap>
diff --git a/osu.Game/Online/API/Requests/GetBeatmapSetRequest.cs b/osu.Game/Online/API/Requests/GetBeatmapSetRequest.cs
index 158ae03b8d..f3690c934d 100644
--- a/osu.Game/Online/API/Requests/GetBeatmapSetRequest.cs
+++ b/osu.Game/Online/API/Requests/GetBeatmapSetRequest.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.
 
+#nullable disable
+
 using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Online.API.Requests
diff --git a/osu.Game/Online/API/Requests/GetBeatmapsRequest.cs b/osu.Game/Online/API/Requests/GetBeatmapsRequest.cs
index 22af022659..e118d1bddc 100644
--- a/osu.Game/Online/API/Requests/GetBeatmapsRequest.cs
+++ b/osu.Game/Online/API/Requests/GetBeatmapsRequest.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 
diff --git a/osu.Game/Online/API/Requests/GetBeatmapsResponse.cs b/osu.Game/Online/API/Requests/GetBeatmapsResponse.cs
index c450c3269c..c91aa5002c 100644
--- a/osu.Game/Online/API/Requests/GetBeatmapsResponse.cs
+++ b/osu.Game/Online/API/Requests/GetBeatmapsResponse.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using Newtonsoft.Json;
 using osu.Game.Online.API.Requests.Responses;
diff --git a/osu.Game/Online/API/Requests/GetChangelogBuildRequest.cs b/osu.Game/Online/API/Requests/GetChangelogBuildRequest.cs
index baa15c70c4..2d2d241b86 100644
--- a/osu.Game/Online/API/Requests/GetChangelogBuildRequest.cs
+++ b/osu.Game/Online/API/Requests/GetChangelogBuildRequest.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.
 
+#nullable disable
+
 using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Online.API.Requests
diff --git a/osu.Game/Online/API/Requests/GetChangelogRequest.cs b/osu.Game/Online/API/Requests/GetChangelogRequest.cs
index 97799ff66a..82ed42615f 100644
--- a/osu.Game/Online/API/Requests/GetChangelogRequest.cs
+++ b/osu.Game/Online/API/Requests/GetChangelogRequest.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.
 
+#nullable disable
+
 using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Online.API.Requests
diff --git a/osu.Game/Online/API/Requests/GetCommentsRequest.cs b/osu.Game/Online/API/Requests/GetCommentsRequest.cs
index 24dae4adf1..c63c574124 100644
--- a/osu.Game/Online/API/Requests/GetCommentsRequest.cs
+++ b/osu.Game/Online/API/Requests/GetCommentsRequest.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.
 
+#nullable disable
+
 using osu.Framework.IO.Network;
 using Humanizer;
 using osu.Game.Online.API.Requests.Responses;
diff --git a/osu.Game/Online/API/Requests/GetCountriesResponse.cs b/osu.Game/Online/API/Requests/GetCountriesResponse.cs
index 6624344b44..117993b98c 100644
--- a/osu.Game/Online/API/Requests/GetCountriesResponse.cs
+++ b/osu.Game/Online/API/Requests/GetCountriesResponse.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using Newtonsoft.Json;
 using osu.Game.Users;
diff --git a/osu.Game/Online/API/Requests/GetCountryRankingsRequest.cs b/osu.Game/Online/API/Requests/GetCountryRankingsRequest.cs
index d8a1198627..9d037ab116 100644
--- a/osu.Game/Online/API/Requests/GetCountryRankingsRequest.cs
+++ b/osu.Game/Online/API/Requests/GetCountryRankingsRequest.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.
 
+#nullable disable
+
 using osu.Game.Rulesets;
 
 namespace osu.Game.Online.API.Requests
diff --git a/osu.Game/Online/API/Requests/GetFriendsRequest.cs b/osu.Game/Online/API/Requests/GetFriendsRequest.cs
index 63a221d91a..640ddcbb9e 100644
--- a/osu.Game/Online/API/Requests/GetFriendsRequest.cs
+++ b/osu.Game/Online/API/Requests/GetFriendsRequest.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Game.Online.API.Requests.Responses;
 
diff --git a/osu.Game/Online/API/Requests/GetMessagesRequest.cs b/osu.Game/Online/API/Requests/GetMessagesRequest.cs
index 651f8a06c5..2f9879c63f 100644
--- a/osu.Game/Online/API/Requests/GetMessagesRequest.cs
+++ b/osu.Game/Online/API/Requests/GetMessagesRequest.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Game.Online.Chat;
 
diff --git a/osu.Game/Online/API/Requests/GetNewsRequest.cs b/osu.Game/Online/API/Requests/GetNewsRequest.cs
index 992ccc6d59..e1c9eefe30 100644
--- a/osu.Game/Online/API/Requests/GetNewsRequest.cs
+++ b/osu.Game/Online/API/Requests/GetNewsRequest.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.
 
+#nullable disable
+
 using osu.Framework.IO.Network;
 using osu.Game.Extensions;
 
diff --git a/osu.Game/Online/API/Requests/GetNewsResponse.cs b/osu.Game/Online/API/Requests/GetNewsResponse.cs
index 98f76d105c..b62d83557e 100644
--- a/osu.Game/Online/API/Requests/GetNewsResponse.cs
+++ b/osu.Game/Online/API/Requests/GetNewsResponse.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using Newtonsoft.Json;
 using osu.Game.Online.API.Requests.Responses;
diff --git a/osu.Game/Online/API/Requests/GetRankingsRequest.cs b/osu.Game/Online/API/Requests/GetRankingsRequest.cs
index ddc3298ca7..f42da69dcc 100644
--- a/osu.Game/Online/API/Requests/GetRankingsRequest.cs
+++ b/osu.Game/Online/API/Requests/GetRankingsRequest.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.
 
+#nullable disable
+
 using osu.Framework.IO.Network;
 using osu.Game.Rulesets;
 
diff --git a/osu.Game/Online/API/Requests/GetScoresRequest.cs b/osu.Game/Online/API/Requests/GetScoresRequest.cs
index 8e447390e6..a6cd9a52c7 100644
--- a/osu.Game/Online/API/Requests/GetScoresRequest.cs
+++ b/osu.Game/Online/API/Requests/GetScoresRequest.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.
 
+#nullable disable
+
 using System;
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets;
diff --git a/osu.Game/Online/API/Requests/GetSeasonalBackgroundsRequest.cs b/osu.Game/Online/API/Requests/GetSeasonalBackgroundsRequest.cs
index 941b47244a..0ecce90749 100644
--- a/osu.Game/Online/API/Requests/GetSeasonalBackgroundsRequest.cs
+++ b/osu.Game/Online/API/Requests/GetSeasonalBackgroundsRequest.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.
 
+#nullable disable
+
 using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Online.API.Requests
diff --git a/osu.Game/Online/API/Requests/GetSpotlightRankingsRequest.cs b/osu.Game/Online/API/Requests/GetSpotlightRankingsRequest.cs
index 20856c2768..75b0cf8027 100644
--- a/osu.Game/Online/API/Requests/GetSpotlightRankingsRequest.cs
+++ b/osu.Game/Online/API/Requests/GetSpotlightRankingsRequest.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.
 
+#nullable disable
+
 using osu.Framework.IO.Network;
 using osu.Game.Overlays.Rankings;
 using osu.Game.Rulesets;
diff --git a/osu.Game/Online/API/Requests/GetSpotlightRankingsResponse.cs b/osu.Game/Online/API/Requests/GetSpotlightRankingsResponse.cs
index 2259314a9f..5bc7bd5e08 100644
--- a/osu.Game/Online/API/Requests/GetSpotlightRankingsResponse.cs
+++ b/osu.Game/Online/API/Requests/GetSpotlightRankingsResponse.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using Newtonsoft.Json;
 using osu.Game.Online.API.Requests.Responses;
diff --git a/osu.Game/Online/API/Requests/GetSpotlightsRequest.cs b/osu.Game/Online/API/Requests/GetSpotlightsRequest.cs
index 6fafb3933c..93a63afcaa 100644
--- a/osu.Game/Online/API/Requests/GetSpotlightsRequest.cs
+++ b/osu.Game/Online/API/Requests/GetSpotlightsRequest.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using Newtonsoft.Json;
 using osu.Game.Online.API.Requests.Responses;
diff --git a/osu.Game/Online/API/Requests/GetTopUsersRequest.cs b/osu.Game/Online/API/Requests/GetTopUsersRequest.cs
index dbbd2119db..7f05cd5eab 100644
--- a/osu.Game/Online/API/Requests/GetTopUsersRequest.cs
+++ b/osu.Game/Online/API/Requests/GetTopUsersRequest.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.
 
+#nullable disable
+
 namespace osu.Game.Online.API.Requests
 {
     public class GetTopUsersRequest : APIRequest<GetTopUsersResponse>
diff --git a/osu.Game/Online/API/Requests/GetTopUsersResponse.cs b/osu.Game/Online/API/Requests/GetTopUsersResponse.cs
index b37b8b3499..6e0e8f11ae 100644
--- a/osu.Game/Online/API/Requests/GetTopUsersResponse.cs
+++ b/osu.Game/Online/API/Requests/GetTopUsersResponse.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using Newtonsoft.Json;
 using osu.Game.Users;
diff --git a/osu.Game/Online/API/Requests/GetUpdatesRequest.cs b/osu.Game/Online/API/Requests/GetUpdatesRequest.cs
index 488bb8bbf4..ce2689d262 100644
--- a/osu.Game/Online/API/Requests/GetUpdatesRequest.cs
+++ b/osu.Game/Online/API/Requests/GetUpdatesRequest.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.
 
+#nullable disable
+
 using JetBrains.Annotations;
 using osu.Framework.IO.Network;
 using osu.Game.Online.Chat;
diff --git a/osu.Game/Online/API/Requests/GetUpdatesResponse.cs b/osu.Game/Online/API/Requests/GetUpdatesResponse.cs
index 4ac806bedc..61f6a8664d 100644
--- a/osu.Game/Online/API/Requests/GetUpdatesResponse.cs
+++ b/osu.Game/Online/API/Requests/GetUpdatesResponse.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using Newtonsoft.Json;
 using osu.Game.Online.Chat;
diff --git a/osu.Game/Online/API/Requests/GetUserBeatmapsRequest.cs b/osu.Game/Online/API/Requests/GetUserBeatmapsRequest.cs
index 205fdc9f2b..3ec60cd06c 100644
--- a/osu.Game/Online/API/Requests/GetUserBeatmapsRequest.cs
+++ b/osu.Game/Online/API/Requests/GetUserBeatmapsRequest.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.
 
+#nullable disable
+
 using Humanizer;
 using System.Collections.Generic;
 using osu.Game.Online.API.Requests.Responses;
diff --git a/osu.Game/Online/API/Requests/GetUserKudosuHistoryRequest.cs b/osu.Game/Online/API/Requests/GetUserKudosuHistoryRequest.cs
index 67d3ad26b0..3d0ee23080 100644
--- a/osu.Game/Online/API/Requests/GetUserKudosuHistoryRequest.cs
+++ b/osu.Game/Online/API/Requests/GetUserKudosuHistoryRequest.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Game.Online.API.Requests.Responses;
 
diff --git a/osu.Game/Online/API/Requests/GetUserMostPlayedBeatmapsRequest.cs b/osu.Game/Online/API/Requests/GetUserMostPlayedBeatmapsRequest.cs
index bef3df42fb..e5e65415f7 100644
--- a/osu.Game/Online/API/Requests/GetUserMostPlayedBeatmapsRequest.cs
+++ b/osu.Game/Online/API/Requests/GetUserMostPlayedBeatmapsRequest.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Game.Online.API.Requests.Responses;
 
diff --git a/osu.Game/Online/API/Requests/GetUserRankingsRequest.cs b/osu.Game/Online/API/Requests/GetUserRankingsRequest.cs
index bccc3bc0c3..ab0cc3a56d 100644
--- a/osu.Game/Online/API/Requests/GetUserRankingsRequest.cs
+++ b/osu.Game/Online/API/Requests/GetUserRankingsRequest.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.
 
+#nullable disable
+
 using osu.Framework.IO.Network;
 using osu.Game.Rulesets;
 
diff --git a/osu.Game/Online/API/Requests/GetUserRecentActivitiesRequest.cs b/osu.Game/Online/API/Requests/GetUserRecentActivitiesRequest.cs
index 79f0549d4a..82cf0a508a 100644
--- a/osu.Game/Online/API/Requests/GetUserRecentActivitiesRequest.cs
+++ b/osu.Game/Online/API/Requests/GetUserRecentActivitiesRequest.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Game.Online.API.Requests.Responses;
 
diff --git a/osu.Game/Online/API/Requests/GetUserRequest.cs b/osu.Game/Online/API/Requests/GetUserRequest.cs
index 28da5222f9..ab45e8e48f 100644
--- a/osu.Game/Online/API/Requests/GetUserRequest.cs
+++ b/osu.Game/Online/API/Requests/GetUserRequest.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.
 
+#nullable disable
+
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets;
 
diff --git a/osu.Game/Online/API/Requests/GetUserScoresRequest.cs b/osu.Game/Online/API/Requests/GetUserScoresRequest.cs
index 7250929f11..9bd78b7be1 100644
--- a/osu.Game/Online/API/Requests/GetUserScoresRequest.cs
+++ b/osu.Game/Online/API/Requests/GetUserScoresRequest.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Framework.IO.Network;
 using osu.Game.Online.API.Requests.Responses;
diff --git a/osu.Game/Online/API/Requests/GetUsersRequest.cs b/osu.Game/Online/API/Requests/GetUsersRequest.cs
index 969d7fdba3..bbaf241384 100644
--- a/osu.Game/Online/API/Requests/GetUsersRequest.cs
+++ b/osu.Game/Online/API/Requests/GetUsersRequest.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.
 
+#nullable disable
+
 using System;
 
 namespace osu.Game.Online.API.Requests
diff --git a/osu.Game/Online/API/Requests/GetUsersResponse.cs b/osu.Game/Online/API/Requests/GetUsersResponse.cs
index 022050de5c..b49bef589a 100644
--- a/osu.Game/Online/API/Requests/GetUsersResponse.cs
+++ b/osu.Game/Online/API/Requests/GetUsersResponse.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using Newtonsoft.Json;
 using osu.Game.Online.API.Requests.Responses;
diff --git a/osu.Game/Online/API/Requests/GetWikiRequest.cs b/osu.Game/Online/API/Requests/GetWikiRequest.cs
index 09571ab0a8..e0f967ec15 100644
--- a/osu.Game/Online/API/Requests/GetWikiRequest.cs
+++ b/osu.Game/Online/API/Requests/GetWikiRequest.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.
 
+#nullable disable
+
 using osu.Game.Extensions;
 using osu.Game.Localisation;
 using osu.Game.Online.API.Requests.Responses;
diff --git a/osu.Game/Online/API/Requests/JoinChannelRequest.cs b/osu.Game/Online/API/Requests/JoinChannelRequest.cs
index 33eab7e355..30b8fafd57 100644
--- a/osu.Game/Online/API/Requests/JoinChannelRequest.cs
+++ b/osu.Game/Online/API/Requests/JoinChannelRequest.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.
 
+#nullable disable
+
 using System.Net.Http;
 using osu.Framework.IO.Network;
 using osu.Game.Online.Chat;
diff --git a/osu.Game/Online/API/Requests/LeaveChannelRequest.cs b/osu.Game/Online/API/Requests/LeaveChannelRequest.cs
index 7dfc9a0aed..4e77055e67 100644
--- a/osu.Game/Online/API/Requests/LeaveChannelRequest.cs
+++ b/osu.Game/Online/API/Requests/LeaveChannelRequest.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.
 
+#nullable disable
+
 using System.Net.Http;
 using osu.Framework.IO.Network;
 using osu.Game.Online.Chat;
diff --git a/osu.Game/Online/API/Requests/ListChannelsRequest.cs b/osu.Game/Online/API/Requests/ListChannelsRequest.cs
index 9660695c14..6f8fb427dc 100644
--- a/osu.Game/Online/API/Requests/ListChannelsRequest.cs
+++ b/osu.Game/Online/API/Requests/ListChannelsRequest.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Game.Online.Chat;
 
diff --git a/osu.Game/Online/API/Requests/MarkChannelAsReadRequest.cs b/osu.Game/Online/API/Requests/MarkChannelAsReadRequest.cs
index b24669e6d5..afdc8a47f4 100644
--- a/osu.Game/Online/API/Requests/MarkChannelAsReadRequest.cs
+++ b/osu.Game/Online/API/Requests/MarkChannelAsReadRequest.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.
 
+#nullable disable
+
 using System.Net.Http;
 using osu.Framework.IO.Network;
 using osu.Game.Online.Chat;
diff --git a/osu.Game/Online/API/Requests/PaginatedAPIRequest.cs b/osu.Game/Online/API/Requests/PaginatedAPIRequest.cs
index 3d719de958..4af1f58180 100644
--- a/osu.Game/Online/API/Requests/PaginatedAPIRequest.cs
+++ b/osu.Game/Online/API/Requests/PaginatedAPIRequest.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.
 
+#nullable disable
+
 using System.Globalization;
 using osu.Framework.IO.Network;
 
diff --git a/osu.Game/Online/API/Requests/PaginationParameters.cs b/osu.Game/Online/API/Requests/PaginationParameters.cs
index 3593a4fe83..6dacb009bd 100644
--- a/osu.Game/Online/API/Requests/PaginationParameters.cs
+++ b/osu.Game/Online/API/Requests/PaginationParameters.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.
 
+#nullable disable
+
 namespace osu.Game.Online.API.Requests
 {
     /// <summary>
diff --git a/osu.Game/Online/API/Requests/PostBeatmapFavouriteRequest.cs b/osu.Game/Online/API/Requests/PostBeatmapFavouriteRequest.cs
index 9fdc3382aa..1438c9c436 100644
--- a/osu.Game/Online/API/Requests/PostBeatmapFavouriteRequest.cs
+++ b/osu.Game/Online/API/Requests/PostBeatmapFavouriteRequest.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.
 
+#nullable disable
+
 using osu.Framework.IO.Network;
 using System.Net.Http;
 
diff --git a/osu.Game/Online/API/Requests/PostMessageRequest.cs b/osu.Game/Online/API/Requests/PostMessageRequest.cs
index 5d508a4cdf..7b20bd9ad5 100644
--- a/osu.Game/Online/API/Requests/PostMessageRequest.cs
+++ b/osu.Game/Online/API/Requests/PostMessageRequest.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.
 
+#nullable disable
+
 using System.Net.Http;
 using osu.Framework.IO.Network;
 using osu.Game.Online.Chat;
diff --git a/osu.Game/Online/API/Requests/ResponseWithCursor.cs b/osu.Game/Online/API/Requests/ResponseWithCursor.cs
index d52e999722..66e8094442 100644
--- a/osu.Game/Online/API/Requests/ResponseWithCursor.cs
+++ b/osu.Game/Online/API/Requests/ResponseWithCursor.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.
 
+#nullable disable
+
 using Newtonsoft.Json;
 
 namespace osu.Game.Online.API.Requests
diff --git a/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs b/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs
index f5795141c5..258708de2b 100644
--- a/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIBeatmap.cs
@@ -7,8 +7,6 @@ using osu.Game.Beatmaps;
 using osu.Game.Extensions;
 using osu.Game.Rulesets;
 
-#nullable enable
-
 namespace osu.Game.Online.API.Requests.Responses
 {
     public class APIBeatmap : IBeatmapInfo, IBeatmapOnlineInfo
diff --git a/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs b/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs
index 79c65fa79e..238f41e53d 100644
--- a/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIBeatmapSet.cs
@@ -9,8 +9,6 @@ using osu.Game.Database;
 using osu.Game.Extensions;
 using osu.Game.Models;
 
-#nullable enable
-
 namespace osu.Game.Online.API.Requests.Responses
 {
     public class APIBeatmapSet : IBeatmapSetOnlineInfo, IBeatmapSetInfo
diff --git a/osu.Game/Online/API/Requests/Responses/APIChangelogBuild.cs b/osu.Game/Online/API/Requests/Responses/APIChangelogBuild.cs
index 56005e15f8..38c727396a 100644
--- a/osu.Game/Online/API/Requests/Responses/APIChangelogBuild.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIChangelogBuild.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.
 
+#nullable disable
+
 using Newtonsoft.Json;
 using System;
 using System.Collections.Generic;
diff --git a/osu.Game/Online/API/Requests/Responses/APIChangelogEntry.cs b/osu.Game/Online/API/Requests/Responses/APIChangelogEntry.cs
index 1ff7523ba6..2355de8f3c 100644
--- a/osu.Game/Online/API/Requests/Responses/APIChangelogEntry.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIChangelogEntry.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.
 
+#nullable disable
+
 using System;
 using Newtonsoft.Json;
 
diff --git a/osu.Game/Online/API/Requests/Responses/APIChangelogIndex.cs b/osu.Game/Online/API/Requests/Responses/APIChangelogIndex.cs
index 778e8754fe..0728fc1c7e 100644
--- a/osu.Game/Online/API/Requests/Responses/APIChangelogIndex.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIChangelogIndex.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using Newtonsoft.Json;
 
diff --git a/osu.Game/Online/API/Requests/Responses/APIChangelogUser.cs b/osu.Game/Online/API/Requests/Responses/APIChangelogUser.cs
index 024e1ce048..071f9f8517 100644
--- a/osu.Game/Online/API/Requests/Responses/APIChangelogUser.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIChangelogUser.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.
 
+#nullable disable
+
 using Newtonsoft.Json;
 
 namespace osu.Game.Online.API.Requests.Responses
diff --git a/osu.Game/Online/API/Requests/Responses/APIChatChannel.cs b/osu.Game/Online/API/Requests/Responses/APIChatChannel.cs
index fc3b2a8e31..a04dc89986 100644
--- a/osu.Game/Online/API/Requests/Responses/APIChatChannel.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIChatChannel.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using Newtonsoft.Json;
 using osu.Game.Online.Chat;
diff --git a/osu.Game/Online/API/Requests/Responses/APIKudosuHistory.cs b/osu.Game/Online/API/Requests/Responses/APIKudosuHistory.cs
index d596ddc560..583def8eda 100644
--- a/osu.Game/Online/API/Requests/Responses/APIKudosuHistory.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIKudosuHistory.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using Newtonsoft.Json;
diff --git a/osu.Game/Online/API/Requests/Responses/APINewsPost.cs b/osu.Game/Online/API/Requests/Responses/APINewsPost.cs
index ced08f0bf2..ff12a83af2 100644
--- a/osu.Game/Online/API/Requests/Responses/APINewsPost.cs
+++ b/osu.Game/Online/API/Requests/Responses/APINewsPost.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.
 
+#nullable disable
+
 using Newtonsoft.Json;
 using System;
 using System.Net;
diff --git a/osu.Game/Online/API/Requests/Responses/APINewsSidebar.cs b/osu.Game/Online/API/Requests/Responses/APINewsSidebar.cs
index b8d6469a1d..a94dfbd923 100644
--- a/osu.Game/Online/API/Requests/Responses/APINewsSidebar.cs
+++ b/osu.Game/Online/API/Requests/Responses/APINewsSidebar.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.
 
+#nullable disable
+
 using Newtonsoft.Json;
 using System.Collections.Generic;
 
diff --git a/osu.Game/Online/API/Requests/Responses/APIPlayStyle.cs b/osu.Game/Online/API/Requests/Responses/APIPlayStyle.cs
index a9d66f3d6a..4a877f392a 100644
--- a/osu.Game/Online/API/Requests/Responses/APIPlayStyle.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIPlayStyle.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.
 
+#nullable disable
+
 using osu.Framework.Localisation;
 using osu.Game.Resources.Localisation.Web;
 
diff --git a/osu.Game/Online/API/Requests/Responses/APIRankHistory.cs b/osu.Game/Online/API/Requests/Responses/APIRankHistory.cs
index 064badcccb..b3af2e1a3e 100644
--- a/osu.Game/Online/API/Requests/Responses/APIRankHistory.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIRankHistory.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.
 
+#nullable disable
+
 using Newtonsoft.Json;
 
 namespace osu.Game.Online.API.Requests.Responses
diff --git a/osu.Game/Online/API/Requests/Responses/APIRecentActivity.cs b/osu.Game/Online/API/Requests/Responses/APIRecentActivity.cs
index 8695d09570..8fefe4d9c2 100644
--- a/osu.Game/Online/API/Requests/Responses/APIRecentActivity.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIRecentActivity.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.
 
+#nullable disable
+
 using System;
 using Humanizer;
 using Newtonsoft.Json;
diff --git a/osu.Game/Online/API/Requests/Responses/APIScore.cs b/osu.Game/Online/API/Requests/Responses/APIScore.cs
index d8f4ba835d..1b56362aec 100644
--- a/osu.Game/Online/API/Requests/Responses/APIScore.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIScore.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Online/API/Requests/Responses/APIScoreWithPosition.cs b/osu.Game/Online/API/Requests/Responses/APIScoreWithPosition.cs
index d3c9ba0c7e..8bd54f889d 100644
--- a/osu.Game/Online/API/Requests/Responses/APIScoreWithPosition.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIScoreWithPosition.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.
 
+#nullable disable
+
 using Newtonsoft.Json;
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets;
diff --git a/osu.Game/Online/API/Requests/Responses/APIScoresCollection.cs b/osu.Game/Online/API/Requests/Responses/APIScoresCollection.cs
index 283ebf2411..9c8a38c63a 100644
--- a/osu.Game/Online/API/Requests/Responses/APIScoresCollection.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIScoresCollection.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using Newtonsoft.Json;
 
diff --git a/osu.Game/Online/API/Requests/Responses/APISeasonalBackgrounds.cs b/osu.Game/Online/API/Requests/Responses/APISeasonalBackgrounds.cs
index 8e395f7397..c70dcc0e0b 100644
--- a/osu.Game/Online/API/Requests/Responses/APISeasonalBackgrounds.cs
+++ b/osu.Game/Online/API/Requests/Responses/APISeasonalBackgrounds.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using Newtonsoft.Json;
diff --git a/osu.Game/Online/API/Requests/Responses/APISpotlight.cs b/osu.Game/Online/API/Requests/Responses/APISpotlight.cs
index 4f63ebe3df..6eb51a0fb3 100644
--- a/osu.Game/Online/API/Requests/Responses/APISpotlight.cs
+++ b/osu.Game/Online/API/Requests/Responses/APISpotlight.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.
 
+#nullable disable
+
 using System;
 using Newtonsoft.Json;
 
diff --git a/osu.Game/Online/API/Requests/Responses/APIUpdateStream.cs b/osu.Game/Online/API/Requests/Responses/APIUpdateStream.cs
index 5af7d6a01c..76d1941d9d 100644
--- a/osu.Game/Online/API/Requests/Responses/APIUpdateStream.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIUpdateStream.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using Newtonsoft.Json;
diff --git a/osu.Game/Online/API/Requests/Responses/APIUser.cs b/osu.Game/Online/API/Requests/Responses/APIUser.cs
index 41f486c709..63aaa9b90e 100644
--- a/osu.Game/Online/API/Requests/Responses/APIUser.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIUser.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Online/API/Requests/Responses/APIUserAchievement.cs b/osu.Game/Online/API/Requests/Responses/APIUserAchievement.cs
index cfba9118c2..65001dd6cf 100644
--- a/osu.Game/Online/API/Requests/Responses/APIUserAchievement.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIUserAchievement.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.
 
+#nullable disable
+
 using System;
 using Newtonsoft.Json;
 
diff --git a/osu.Game/Online/API/Requests/Responses/APIUserContainer.cs b/osu.Game/Online/API/Requests/Responses/APIUserContainer.cs
index 9eb4a2a4e3..b2d544c71f 100644
--- a/osu.Game/Online/API/Requests/Responses/APIUserContainer.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIUserContainer.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.
 
+#nullable disable
+
 using Newtonsoft.Json;
 
 namespace osu.Game.Online.API.Requests.Responses
diff --git a/osu.Game/Online/API/Requests/Responses/APIUserHistoryCount.cs b/osu.Game/Online/API/Requests/Responses/APIUserHistoryCount.cs
index 1226c88c08..6eb3c8b8a4 100644
--- a/osu.Game/Online/API/Requests/Responses/APIUserHistoryCount.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIUserHistoryCount.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.
 
+#nullable disable
+
 using System;
 using Newtonsoft.Json;
 
diff --git a/osu.Game/Online/API/Requests/Responses/APIUserMostPlayedBeatmap.cs b/osu.Game/Online/API/Requests/Responses/APIUserMostPlayedBeatmap.cs
index 19c581bf95..6d5fd59f9c 100644
--- a/osu.Game/Online/API/Requests/Responses/APIUserMostPlayedBeatmap.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIUserMostPlayedBeatmap.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.
 
+#nullable disable
+
 using Newtonsoft.Json;
 
 namespace osu.Game.Online.API.Requests.Responses
diff --git a/osu.Game/Online/API/Requests/Responses/APIUserScoreAggregate.cs b/osu.Game/Online/API/Requests/Responses/APIUserScoreAggregate.cs
index a298a8625a..30433ab8cd 100644
--- a/osu.Game/Online/API/Requests/Responses/APIUserScoreAggregate.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIUserScoreAggregate.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.
 
+#nullable disable
+
 using System;
 using Newtonsoft.Json;
 using osu.Game.Rulesets.Mods;
diff --git a/osu.Game/Online/API/Requests/Responses/APIWikiPage.cs b/osu.Game/Online/API/Requests/Responses/APIWikiPage.cs
index 957396b17a..ea2457bf1b 100644
--- a/osu.Game/Online/API/Requests/Responses/APIWikiPage.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIWikiPage.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using Newtonsoft.Json;
 
diff --git a/osu.Game/Online/API/Requests/Responses/Comment.cs b/osu.Game/Online/API/Requests/Responses/Comment.cs
index 13379a40a6..500c0566e6 100644
--- a/osu.Game/Online/API/Requests/Responses/Comment.cs
+++ b/osu.Game/Online/API/Requests/Responses/Comment.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.
 
+#nullable disable
+
 using Newtonsoft.Json;
 using System;
 
diff --git a/osu.Game/Online/API/Requests/Responses/CommentBundle.cs b/osu.Game/Online/API/Requests/Responses/CommentBundle.cs
index 8436381090..ae8b850723 100644
--- a/osu.Game/Online/API/Requests/Responses/CommentBundle.cs
+++ b/osu.Game/Online/API/Requests/Responses/CommentBundle.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.
 
+#nullable disable
+
 using Newtonsoft.Json;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Online/API/Requests/SearchBeatmapSetsRequest.cs b/osu.Game/Online/API/Requests/SearchBeatmapSetsRequest.cs
index 736024b08b..73f6fce4f9 100644
--- a/osu.Game/Online/API/Requests/SearchBeatmapSetsRequest.cs
+++ b/osu.Game/Online/API/Requests/SearchBeatmapSetsRequest.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using Humanizer;
diff --git a/osu.Game/Online/API/Requests/SearchBeatmapSetsResponse.cs b/osu.Game/Online/API/Requests/SearchBeatmapSetsResponse.cs
index 3c4fb11ed1..abc30e18ea 100644
--- a/osu.Game/Online/API/Requests/SearchBeatmapSetsResponse.cs
+++ b/osu.Game/Online/API/Requests/SearchBeatmapSetsResponse.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using Newtonsoft.Json;
 using osu.Game.Online.API.Requests.Responses;
diff --git a/osu.Game/Online/BeatmapDownloadTracker.cs b/osu.Game/Online/BeatmapDownloadTracker.cs
index 9f795f007a..1e3add6201 100644
--- a/osu.Game/Online/BeatmapDownloadTracker.cs
+++ b/osu.Game/Online/BeatmapDownloadTracker.cs
@@ -8,8 +8,6 @@ using osu.Game.Beatmaps;
 using osu.Game.Database;
 using osu.Game.Online.API;
 
-#nullable enable
-
 namespace osu.Game.Online
 {
     public class BeatmapDownloadTracker : DownloadTracker<IBeatmapSetInfo>
diff --git a/osu.Game/Online/Chat/Channel.cs b/osu.Game/Online/Chat/Channel.cs
index a37d3084f0..f51ea3e8d6 100644
--- a/osu.Game/Online/Chat/Channel.cs
+++ b/osu.Game/Online/Chat/Channel.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Collections.ObjectModel;
diff --git a/osu.Game/Online/Chat/ChannelManager.cs b/osu.Game/Online/Chat/ChannelManager.cs
index c96e7c4cd3..4c762d002d 100644
--- a/osu.Game/Online/Chat/ChannelManager.cs
+++ b/osu.Game/Online/Chat/ChannelManager.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Online/Chat/ChannelType.cs b/osu.Game/Online/Chat/ChannelType.cs
index bd628e90c4..a864e20830 100644
--- a/osu.Game/Online/Chat/ChannelType.cs
+++ b/osu.Game/Online/Chat/ChannelType.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.
 
+#nullable disable
+
 namespace osu.Game.Online.Chat
 {
     public enum ChannelType
diff --git a/osu.Game/Online/Chat/DrawableLinkCompiler.cs b/osu.Game/Online/Chat/DrawableLinkCompiler.cs
index 3b0d049528..44e66c1a69 100644
--- a/osu.Game/Online/Chat/DrawableLinkCompiler.cs
+++ b/osu.Game/Online/Chat/DrawableLinkCompiler.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Online/Chat/ErrorMessage.cs b/osu.Game/Online/Chat/ErrorMessage.cs
index 87a65fb3f1..9cd91a0927 100644
--- a/osu.Game/Online/Chat/ErrorMessage.cs
+++ b/osu.Game/Online/Chat/ErrorMessage.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.
 
+#nullable disable
+
 namespace osu.Game.Online.Chat
 {
     public class ErrorMessage : InfoMessage
diff --git a/osu.Game/Online/Chat/ExternalLinkOpener.cs b/osu.Game/Online/Chat/ExternalLinkOpener.cs
index 20d8459132..e557b9933e 100644
--- a/osu.Game/Online/Chat/ExternalLinkOpener.cs
+++ b/osu.Game/Online/Chat/ExternalLinkOpener.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Online/Chat/IChannelPostTarget.cs b/osu.Game/Online/Chat/IChannelPostTarget.cs
index 5697e918f0..bd8648189a 100644
--- a/osu.Game/Online/Chat/IChannelPostTarget.cs
+++ b/osu.Game/Online/Chat/IChannelPostTarget.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 
 namespace osu.Game.Online.Chat
diff --git a/osu.Game/Online/Chat/InfoMessage.cs b/osu.Game/Online/Chat/InfoMessage.cs
index e97245df45..d98c67de34 100644
--- a/osu.Game/Online/Chat/InfoMessage.cs
+++ b/osu.Game/Online/Chat/InfoMessage.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.
 
+#nullable disable
+
 using System;
 using osu.Game.Online.API.Requests.Responses;
 
diff --git a/osu.Game/Online/Chat/LocalEchoMessage.cs b/osu.Game/Online/Chat/LocalEchoMessage.cs
index 8a39515575..b226fe6cad 100644
--- a/osu.Game/Online/Chat/LocalEchoMessage.cs
+++ b/osu.Game/Online/Chat/LocalEchoMessage.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.
 
+#nullable disable
+
 namespace osu.Game.Online.Chat
 {
     public class LocalEchoMessage : LocalMessage
diff --git a/osu.Game/Online/Chat/LocalMessage.cs b/osu.Game/Online/Chat/LocalMessage.cs
index 027edbcca5..5736f5cabf 100644
--- a/osu.Game/Online/Chat/LocalMessage.cs
+++ b/osu.Game/Online/Chat/LocalMessage.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.
 
+#nullable disable
+
 namespace osu.Game.Online.Chat
 {
     /// <summary>
diff --git a/osu.Game/Online/Chat/Message.cs b/osu.Game/Online/Chat/Message.cs
index ad004e2881..86562341eb 100644
--- a/osu.Game/Online/Chat/Message.cs
+++ b/osu.Game/Online/Chat/Message.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using Newtonsoft.Json;
diff --git a/osu.Game/Online/Chat/MessageFormatter.cs b/osu.Game/Online/Chat/MessageFormatter.cs
index b18daea453..7a040d9446 100644
--- a/osu.Game/Online/Chat/MessageFormatter.cs
+++ b/osu.Game/Online/Chat/MessageFormatter.cs
@@ -6,8 +6,6 @@ using System.Collections.Generic;
 using System.Linq;
 using System.Text.RegularExpressions;
 
-#nullable enable
-
 namespace osu.Game.Online.Chat
 {
     public static class MessageFormatter
diff --git a/osu.Game/Online/Chat/MessageNotifier.cs b/osu.Game/Online/Chat/MessageNotifier.cs
index fbc5ef79ef..3fc6a008e8 100644
--- a/osu.Game/Online/Chat/MessageNotifier.cs
+++ b/osu.Game/Online/Chat/MessageNotifier.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Collections.Specialized;
 using System.Linq;
diff --git a/osu.Game/Online/Chat/NowPlayingCommand.cs b/osu.Game/Online/Chat/NowPlayingCommand.cs
index 2bf35d7973..6a25ceb919 100644
--- a/osu.Game/Online/Chat/NowPlayingCommand.cs
+++ b/osu.Game/Online/Chat/NowPlayingCommand.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Online/Chat/StandAloneChatDisplay.cs b/osu.Game/Online/Chat/StandAloneChatDisplay.cs
index bbfffea6fd..76fcb80eb4 100644
--- a/osu.Game/Online/Chat/StandAloneChatDisplay.cs
+++ b/osu.Game/Online/Chat/StandAloneChatDisplay.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Online/DevelopmentEndpointConfiguration.cs b/osu.Game/Online/DevelopmentEndpointConfiguration.cs
index 69531dbe1b..83fd02512b 100644
--- a/osu.Game/Online/DevelopmentEndpointConfiguration.cs
+++ b/osu.Game/Online/DevelopmentEndpointConfiguration.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.
 
+#nullable disable
+
 namespace osu.Game.Online
 {
     public class DevelopmentEndpointConfiguration : EndpointConfiguration
diff --git a/osu.Game/Online/DownloadState.cs b/osu.Game/Online/DownloadState.cs
index a58c40d16a..3d389d45f9 100644
--- a/osu.Game/Online/DownloadState.cs
+++ b/osu.Game/Online/DownloadState.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.
 
+#nullable disable
+
 namespace osu.Game.Online
 {
     public enum DownloadState
diff --git a/osu.Game/Online/DownloadTracker.cs b/osu.Game/Online/DownloadTracker.cs
index 357c64b6a3..85af9abb33 100644
--- a/osu.Game/Online/DownloadTracker.cs
+++ b/osu.Game/Online/DownloadTracker.cs
@@ -4,8 +4,6 @@
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 
-#nullable enable
-
 namespace osu.Game.Online
 {
     public abstract class DownloadTracker<T> : Component
diff --git a/osu.Game/Online/EndpointConfiguration.cs b/osu.Game/Online/EndpointConfiguration.cs
index e347d3c653..af4e88a05c 100644
--- a/osu.Game/Online/EndpointConfiguration.cs
+++ b/osu.Game/Online/EndpointConfiguration.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.
 
+#nullable disable
+
 namespace osu.Game.Online
 {
     /// <summary>
diff --git a/osu.Game/Online/HubClientConnector.cs b/osu.Game/Online/HubClientConnector.cs
index 261724e315..f9000c01ef 100644
--- a/osu.Game/Online/HubClientConnector.cs
+++ b/osu.Game/Online/HubClientConnector.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 enable
-
 using System;
 using System.Collections.Generic;
 using System.Net;
diff --git a/osu.Game/Online/IHubClientConnector.cs b/osu.Game/Online/IHubClientConnector.cs
index b168e4669f..2afab9091b 100644
--- a/osu.Game/Online/IHubClientConnector.cs
+++ b/osu.Game/Online/IHubClientConnector.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 enable
-
 using System;
 using Microsoft.AspNetCore.SignalR.Client;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Online/Leaderboards/DrawableRank.cs b/osu.Game/Online/Leaderboards/DrawableRank.cs
index 4d41230799..35bdc4e31f 100644
--- a/osu.Game/Online/Leaderboards/DrawableRank.cs
+++ b/osu.Game/Online/Leaderboards/DrawableRank.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.
 
+#nullable disable
+
 using osu.Framework.Extensions;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Online/Leaderboards/Leaderboard.cs b/osu.Game/Online/Leaderboards/Leaderboard.cs
index c94a6d3361..58b1ea62aa 100644
--- a/osu.Game/Online/Leaderboards/Leaderboard.cs
+++ b/osu.Game/Online/Leaderboards/Leaderboard.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Diagnostics;
diff --git a/osu.Game/Online/Leaderboards/LeaderboardScore.cs b/osu.Game/Online/Leaderboards/LeaderboardScore.cs
index 93a42bffb0..e32bc63aa1 100644
--- a/osu.Game/Online/Leaderboards/LeaderboardScore.cs
+++ b/osu.Game/Online/Leaderboards/LeaderboardScore.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Online/Leaderboards/LeaderboardScoreTooltip.cs b/osu.Game/Online/Leaderboards/LeaderboardScoreTooltip.cs
index c26e9e6802..53a4719050 100644
--- a/osu.Game/Online/Leaderboards/LeaderboardScoreTooltip.cs
+++ b/osu.Game/Online/Leaderboards/LeaderboardScoreTooltip.cs
@@ -14,8 +14,6 @@ using osu.Game.Rulesets.Scoring;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.UI;
 
-#nullable enable
-
 namespace osu.Game.Online.Leaderboards
 {
     public class LeaderboardScoreTooltip : VisibilityContainer, ITooltip<ScoreInfo>
diff --git a/osu.Game/Online/Leaderboards/LeaderboardState.cs b/osu.Game/Online/Leaderboards/LeaderboardState.cs
index 6b07500a98..abc0ef4f19 100644
--- a/osu.Game/Online/Leaderboards/LeaderboardState.cs
+++ b/osu.Game/Online/Leaderboards/LeaderboardState.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.
 
+#nullable disable
+
 namespace osu.Game.Online.Leaderboards
 {
     public enum LeaderboardState
diff --git a/osu.Game/Online/Leaderboards/UpdateableRank.cs b/osu.Game/Online/Leaderboards/UpdateableRank.cs
index 8f74fd84fe..e4f5f72886 100644
--- a/osu.Game/Online/Leaderboards/UpdateableRank.cs
+++ b/osu.Game/Online/Leaderboards/UpdateableRank.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Scoring;
diff --git a/osu.Game/Online/Leaderboards/UserTopScoreContainer.cs b/osu.Game/Online/Leaderboards/UserTopScoreContainer.cs
index 3db497bd6a..df8717fe6d 100644
--- a/osu.Game/Online/Leaderboards/UserTopScoreContainer.cs
+++ b/osu.Game/Online/Leaderboards/UserTopScoreContainer.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.
 
+#nullable disable
+
 using System;
 using System.Threading;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Online/Multiplayer/Countdown/CountdownChangedEvent.cs b/osu.Game/Online/Multiplayer/Countdown/CountdownChangedEvent.cs
index b067f3b235..649e3c8389 100644
--- a/osu.Game/Online/Multiplayer/Countdown/CountdownChangedEvent.cs
+++ b/osu.Game/Online/Multiplayer/Countdown/CountdownChangedEvent.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 enable
-
 using MessagePack;
 
 namespace osu.Game.Online.Multiplayer.Countdown
diff --git a/osu.Game/Online/Multiplayer/Countdown/StartMatchCountdownRequest.cs b/osu.Game/Online/Multiplayer/Countdown/StartMatchCountdownRequest.cs
index 08eab26090..d0de69d3f4 100644
--- a/osu.Game/Online/Multiplayer/Countdown/StartMatchCountdownRequest.cs
+++ b/osu.Game/Online/Multiplayer/Countdown/StartMatchCountdownRequest.cs
@@ -4,8 +4,6 @@
 using System;
 using MessagePack;
 
-#nullable enable
-
 namespace osu.Game.Online.Multiplayer.Countdown
 {
     /// <summary>
diff --git a/osu.Game/Online/Multiplayer/Countdown/StopCountdownRequest.cs b/osu.Game/Online/Multiplayer/Countdown/StopCountdownRequest.cs
index 20a0e32734..bd0c381c0b 100644
--- a/osu.Game/Online/Multiplayer/Countdown/StopCountdownRequest.cs
+++ b/osu.Game/Online/Multiplayer/Countdown/StopCountdownRequest.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 enable
-
 using MessagePack;
 
 namespace osu.Game.Online.Multiplayer.Countdown
diff --git a/osu.Game/Online/Multiplayer/ForceGameplayStartCountdown.cs b/osu.Game/Online/Multiplayer/ForceGameplayStartCountdown.cs
index 4ec5019a07..7f5c0f0a05 100644
--- a/osu.Game/Online/Multiplayer/ForceGameplayStartCountdown.cs
+++ b/osu.Game/Online/Multiplayer/ForceGameplayStartCountdown.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.
 
+#nullable disable
+
 using MessagePack;
 
 namespace osu.Game.Online.Multiplayer
diff --git a/osu.Game/Online/Multiplayer/IMultiplayerClient.cs b/osu.Game/Online/Multiplayer/IMultiplayerClient.cs
index 2f454ea835..995bac1af5 100644
--- a/osu.Game/Online/Multiplayer/IMultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/IMultiplayerClient.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Threading.Tasks;
 using osu.Game.Online.API;
diff --git a/osu.Game/Online/Multiplayer/IMultiplayerLoungeServer.cs b/osu.Game/Online/Multiplayer/IMultiplayerLoungeServer.cs
index 0a618c8f5c..68bf3cfaec 100644
--- a/osu.Game/Online/Multiplayer/IMultiplayerLoungeServer.cs
+++ b/osu.Game/Online/Multiplayer/IMultiplayerLoungeServer.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.
 
+#nullable disable
+
 using System.Threading.Tasks;
 
 namespace osu.Game.Online.Multiplayer
diff --git a/osu.Game/Online/Multiplayer/IMultiplayerRoomServer.cs b/osu.Game/Online/Multiplayer/IMultiplayerRoomServer.cs
index 073d512f90..a2608f1564 100644
--- a/osu.Game/Online/Multiplayer/IMultiplayerRoomServer.cs
+++ b/osu.Game/Online/Multiplayer/IMultiplayerRoomServer.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Threading.Tasks;
 using osu.Game.Online.API;
diff --git a/osu.Game/Online/Multiplayer/IMultiplayerServer.cs b/osu.Game/Online/Multiplayer/IMultiplayerServer.cs
index d3a070af6d..cc7a474ce7 100644
--- a/osu.Game/Online/Multiplayer/IMultiplayerServer.cs
+++ b/osu.Game/Online/Multiplayer/IMultiplayerServer.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.
 
+#nullable disable
+
 namespace osu.Game.Online.Multiplayer
 {
     /// <summary>
diff --git a/osu.Game/Online/Multiplayer/InvalidPasswordException.cs b/osu.Game/Online/Multiplayer/InvalidPasswordException.cs
index 0441aea287..305c41e69b 100644
--- a/osu.Game/Online/Multiplayer/InvalidPasswordException.cs
+++ b/osu.Game/Online/Multiplayer/InvalidPasswordException.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.
 
+#nullable disable
+
 using System;
 using System.Runtime.Serialization;
 using Microsoft.AspNetCore.SignalR;
diff --git a/osu.Game/Online/Multiplayer/InvalidStateChangeException.cs b/osu.Game/Online/Multiplayer/InvalidStateChangeException.cs
index 69b6d4bc13..ab513e71ee 100644
--- a/osu.Game/Online/Multiplayer/InvalidStateChangeException.cs
+++ b/osu.Game/Online/Multiplayer/InvalidStateChangeException.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.
 
+#nullable disable
+
 using System;
 using System.Runtime.Serialization;
 using Microsoft.AspNetCore.SignalR;
diff --git a/osu.Game/Online/Multiplayer/InvalidStateException.cs b/osu.Game/Online/Multiplayer/InvalidStateException.cs
index 77a3533dd3..ba3b84ffe4 100644
--- a/osu.Game/Online/Multiplayer/InvalidStateException.cs
+++ b/osu.Game/Online/Multiplayer/InvalidStateException.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.
 
+#nullable disable
+
 using System;
 using System.Runtime.Serialization;
 using Microsoft.AspNetCore.SignalR;
diff --git a/osu.Game/Online/Multiplayer/MatchRoomState.cs b/osu.Game/Online/Multiplayer/MatchRoomState.cs
index 30d948f878..cae3aaf7d0 100644
--- a/osu.Game/Online/Multiplayer/MatchRoomState.cs
+++ b/osu.Game/Online/Multiplayer/MatchRoomState.cs
@@ -5,8 +5,6 @@ using System;
 using MessagePack;
 using osu.Game.Online.Multiplayer.MatchTypes.TeamVersus;
 
-#nullable enable
-
 namespace osu.Game.Online.Multiplayer
 {
     /// <summary>
diff --git a/osu.Game/Online/Multiplayer/MatchServerEvent.cs b/osu.Game/Online/Multiplayer/MatchServerEvent.cs
index 4ce55e424d..20bf9e5141 100644
--- a/osu.Game/Online/Multiplayer/MatchServerEvent.cs
+++ b/osu.Game/Online/Multiplayer/MatchServerEvent.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 enable
-
 using System;
 using MessagePack;
 using osu.Game.Online.Multiplayer.Countdown;
diff --git a/osu.Game/Online/Multiplayer/MatchStartCountdown.cs b/osu.Game/Online/Multiplayer/MatchStartCountdown.cs
index 6c1cdd97d3..5d3365c947 100644
--- a/osu.Game/Online/Multiplayer/MatchStartCountdown.cs
+++ b/osu.Game/Online/Multiplayer/MatchStartCountdown.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 enable
-
 using MessagePack;
 
 namespace osu.Game.Online.Multiplayer
diff --git a/osu.Game/Online/Multiplayer/MatchTypes/TeamVersus/ChangeTeamRequest.cs b/osu.Game/Online/Multiplayer/MatchTypes/TeamVersus/ChangeTeamRequest.cs
index a26a2b3fc2..4e425490ec 100644
--- a/osu.Game/Online/Multiplayer/MatchTypes/TeamVersus/ChangeTeamRequest.cs
+++ b/osu.Game/Online/Multiplayer/MatchTypes/TeamVersus/ChangeTeamRequest.cs
@@ -3,8 +3,6 @@
 
 using MessagePack;
 
-#nullable enable
-
 namespace osu.Game.Online.Multiplayer.MatchTypes.TeamVersus
 {
     [MessagePackObject]
diff --git a/osu.Game/Online/Multiplayer/MatchTypes/TeamVersus/MultiplayerTeam.cs b/osu.Game/Online/Multiplayer/MatchTypes/TeamVersus/MultiplayerTeam.cs
index f952dbc1b5..4ecdfb882f 100644
--- a/osu.Game/Online/Multiplayer/MatchTypes/TeamVersus/MultiplayerTeam.cs
+++ b/osu.Game/Online/Multiplayer/MatchTypes/TeamVersus/MultiplayerTeam.cs
@@ -4,8 +4,6 @@
 using System;
 using MessagePack;
 
-#nullable enable
-
 namespace osu.Game.Online.Multiplayer.MatchTypes.TeamVersus
 {
     [Serializable]
diff --git a/osu.Game/Online/Multiplayer/MatchTypes/TeamVersus/TeamVersusRoomState.cs b/osu.Game/Online/Multiplayer/MatchTypes/TeamVersus/TeamVersusRoomState.cs
index 91d1aa43d4..3758429643 100644
--- a/osu.Game/Online/Multiplayer/MatchTypes/TeamVersus/TeamVersusRoomState.cs
+++ b/osu.Game/Online/Multiplayer/MatchTypes/TeamVersus/TeamVersusRoomState.cs
@@ -4,8 +4,6 @@
 using System.Collections.Generic;
 using MessagePack;
 
-#nullable enable
-
 namespace osu.Game.Online.Multiplayer.MatchTypes.TeamVersus
 {
     [MessagePackObject]
diff --git a/osu.Game/Online/Multiplayer/MatchTypes/TeamVersus/TeamVersusUserState.cs b/osu.Game/Online/Multiplayer/MatchTypes/TeamVersus/TeamVersusUserState.cs
index 96a4e2ea99..ac3b9724cc 100644
--- a/osu.Game/Online/Multiplayer/MatchTypes/TeamVersus/TeamVersusUserState.cs
+++ b/osu.Game/Online/Multiplayer/MatchTypes/TeamVersus/TeamVersusUserState.cs
@@ -3,8 +3,6 @@
 
 using MessagePack;
 
-#nullable enable
-
 namespace osu.Game.Online.Multiplayer.MatchTypes.TeamVersus
 {
     public class TeamVersusUserState : MatchUserState
diff --git a/osu.Game/Online/Multiplayer/MatchUserRequest.cs b/osu.Game/Online/Multiplayer/MatchUserRequest.cs
index 888b55e428..7fc1790434 100644
--- a/osu.Game/Online/Multiplayer/MatchUserRequest.cs
+++ b/osu.Game/Online/Multiplayer/MatchUserRequest.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.
 
+#nullable disable
+
 using System;
 using MessagePack;
 using osu.Game.Online.Multiplayer.Countdown;
diff --git a/osu.Game/Online/Multiplayer/MatchUserState.cs b/osu.Game/Online/Multiplayer/MatchUserState.cs
index 665b64a8b4..92e8c501ed 100644
--- a/osu.Game/Online/Multiplayer/MatchUserState.cs
+++ b/osu.Game/Online/Multiplayer/MatchUserState.cs
@@ -5,8 +5,6 @@ using System;
 using MessagePack;
 using osu.Game.Online.Multiplayer.MatchTypes.TeamVersus;
 
-#nullable enable
-
 namespace osu.Game.Online.Multiplayer
 {
     /// <summary>
diff --git a/osu.Game/Online/Multiplayer/MultiplayerClient.cs b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
index c95f3fa579..22f474ed42 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerClient.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 enable
-
 using System;
 using System.Collections.Generic;
 using System.Diagnostics;
diff --git a/osu.Game/Online/Multiplayer/MultiplayerClientExtensions.cs b/osu.Game/Online/Multiplayer/MultiplayerClientExtensions.cs
index cda313bd0a..2083aa4e28 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerClientExtensions.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerClientExtensions.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 enable
-
 using System;
 using System.Diagnostics;
 using System.Threading.Tasks;
diff --git a/osu.Game/Online/Multiplayer/MultiplayerCountdown.cs b/osu.Game/Online/Multiplayer/MultiplayerCountdown.cs
index dbf2ab667b..621f9236fd 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerCountdown.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerCountdown.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 enable
-
 using System;
 using MessagePack;
 using osu.Game.Online.Multiplayer.Countdown;
diff --git a/osu.Game/Online/Multiplayer/MultiplayerRoom.cs b/osu.Game/Online/Multiplayer/MultiplayerRoom.cs
index e215498ff9..fb05c03256 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerRoom.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerRoom.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 enable
-
 using System;
 using System.Collections.Generic;
 using MessagePack;
diff --git a/osu.Game/Online/Multiplayer/MultiplayerRoomSettings.cs b/osu.Game/Online/Multiplayer/MultiplayerRoomSettings.cs
index 5c086066e6..356acb427c 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerRoomSettings.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerRoomSettings.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 enable
-
 using System;
 using MessagePack;
 using osu.Game.Online.Rooms;
diff --git a/osu.Game/Online/Multiplayer/MultiplayerRoomState.cs b/osu.Game/Online/Multiplayer/MultiplayerRoomState.cs
index 48f25d7ca2..8e28d958a7 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerRoomState.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerRoomState.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 enable
-
 namespace osu.Game.Online.Multiplayer
 {
     /// <summary>
diff --git a/osu.Game/Online/Multiplayer/MultiplayerRoomUser.cs b/osu.Game/Online/Multiplayer/MultiplayerRoomUser.cs
index 50e539e8a6..681a839b89 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerRoomUser.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerRoomUser.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 enable
-
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Online/Multiplayer/MultiplayerUserState.cs b/osu.Game/Online/Multiplayer/MultiplayerUserState.cs
index d1369a7970..0f7dc6b8cd 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerUserState.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerUserState.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.
 
+#nullable disable
+
 namespace osu.Game.Online.Multiplayer
 {
     public enum MultiplayerUserState
diff --git a/osu.Game/Online/Multiplayer/NotHostException.cs b/osu.Game/Online/Multiplayer/NotHostException.cs
index 051cde45a0..9f789f1e81 100644
--- a/osu.Game/Online/Multiplayer/NotHostException.cs
+++ b/osu.Game/Online/Multiplayer/NotHostException.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.
 
+#nullable disable
+
 using System;
 using System.Runtime.Serialization;
 using Microsoft.AspNetCore.SignalR;
diff --git a/osu.Game/Online/Multiplayer/NotJoinedRoomException.cs b/osu.Game/Online/Multiplayer/NotJoinedRoomException.cs
index 0e9902f002..c749e4615a 100644
--- a/osu.Game/Online/Multiplayer/NotJoinedRoomException.cs
+++ b/osu.Game/Online/Multiplayer/NotJoinedRoomException.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.
 
+#nullable disable
+
 using System;
 using System.Runtime.Serialization;
 using Microsoft.AspNetCore.SignalR;
diff --git a/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs b/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs
index a3423d4189..c061398209 100644
--- a/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.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 enable
-
 using System;
 using System.Collections.Generic;
 using System.Diagnostics;
diff --git a/osu.Game/Online/Multiplayer/QueueMode.cs b/osu.Game/Online/Multiplayer/QueueMode.cs
index 3d113c028e..a7bc4ae00a 100644
--- a/osu.Game/Online/Multiplayer/QueueMode.cs
+++ b/osu.Game/Online/Multiplayer/QueueMode.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.
 
+#nullable disable
+
 using System.ComponentModel;
 
 namespace osu.Game.Online.Multiplayer
diff --git a/osu.Game/Online/OnlineViewContainer.cs b/osu.Game/Online/OnlineViewContainer.cs
index 4955aa9058..7af1ac9d5d 100644
--- a/osu.Game/Online/OnlineViewContainer.cs
+++ b/osu.Game/Online/OnlineViewContainer.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Online/Placeholders/ClickablePlaceholder.cs b/osu.Game/Online/Placeholders/ClickablePlaceholder.cs
index 054a4a3c39..7f9e16399e 100644
--- a/osu.Game/Online/Placeholders/ClickablePlaceholder.cs
+++ b/osu.Game/Online/Placeholders/ClickablePlaceholder.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Localisation;
diff --git a/osu.Game/Online/Placeholders/LoginPlaceholder.cs b/osu.Game/Online/Placeholders/LoginPlaceholder.cs
index d03b3d8ffc..6a4065208e 100644
--- a/osu.Game/Online/Placeholders/LoginPlaceholder.cs
+++ b/osu.Game/Online/Placeholders/LoginPlaceholder.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Localisation;
diff --git a/osu.Game/Online/Placeholders/MessagePlaceholder.cs b/osu.Game/Online/Placeholders/MessagePlaceholder.cs
index 1676ba6cf2..451a4cba85 100644
--- a/osu.Game/Online/Placeholders/MessagePlaceholder.cs
+++ b/osu.Game/Online/Placeholders/MessagePlaceholder.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Localisation;
diff --git a/osu.Game/Online/Placeholders/Placeholder.cs b/osu.Game/Online/Placeholders/Placeholder.cs
index f58282bbd9..3a05ce1365 100644
--- a/osu.Game/Online/Placeholders/Placeholder.cs
+++ b/osu.Game/Online/Placeholders/Placeholder.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Graphics;
 using osu.Game.Graphics.Containers;
diff --git a/osu.Game/Online/PollingComponent.cs b/osu.Game/Online/PollingComponent.cs
index 5eddb3b49d..d54b8ca75d 100644
--- a/osu.Game/Online/PollingComponent.cs
+++ b/osu.Game/Online/PollingComponent.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.
 
+#nullable disable
+
 using System;
 using System.Diagnostics;
 using System.Threading.Tasks;
diff --git a/osu.Game/Online/ProductionEndpointConfiguration.cs b/osu.Game/Online/ProductionEndpointConfiguration.cs
index c6ddc03564..f431beac1c 100644
--- a/osu.Game/Online/ProductionEndpointConfiguration.cs
+++ b/osu.Game/Online/ProductionEndpointConfiguration.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.
 
+#nullable disable
+
 namespace osu.Game.Online
 {
     public class ProductionEndpointConfiguration : EndpointConfiguration
diff --git a/osu.Game/Online/Rooms/APICreatedRoom.cs b/osu.Game/Online/Rooms/APICreatedRoom.cs
index d1062b2306..ca1179efeb 100644
--- a/osu.Game/Online/Rooms/APICreatedRoom.cs
+++ b/osu.Game/Online/Rooms/APICreatedRoom.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.
 
+#nullable disable
+
 using Newtonsoft.Json;
 
 namespace osu.Game.Online.Rooms
diff --git a/osu.Game/Online/Rooms/APILeaderboard.cs b/osu.Game/Online/Rooms/APILeaderboard.cs
index c487123906..170cf3684b 100644
--- a/osu.Game/Online/Rooms/APILeaderboard.cs
+++ b/osu.Game/Online/Rooms/APILeaderboard.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using Newtonsoft.Json;
 using osu.Game.Online.API.Requests.Responses;
diff --git a/osu.Game/Online/Rooms/APIScoreToken.cs b/osu.Game/Online/Rooms/APIScoreToken.cs
index 6b559876de..58a633f3cf 100644
--- a/osu.Game/Online/Rooms/APIScoreToken.cs
+++ b/osu.Game/Online/Rooms/APIScoreToken.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.
 
+#nullable disable
+
 using Newtonsoft.Json;
 
 namespace osu.Game.Online.Rooms
diff --git a/osu.Game/Online/Rooms/BeatmapAvailability.cs b/osu.Game/Online/Rooms/BeatmapAvailability.cs
index a83327aad5..f2b981c075 100644
--- a/osu.Game/Online/Rooms/BeatmapAvailability.cs
+++ b/osu.Game/Online/Rooms/BeatmapAvailability.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.
 
+#nullable disable
+
 using System;
 using MessagePack;
 using Newtonsoft.Json;
diff --git a/osu.Game/Online/Rooms/CreateRoomRequest.cs b/osu.Game/Online/Rooms/CreateRoomRequest.cs
index f058eb9ba8..b22780490b 100644
--- a/osu.Game/Online/Rooms/CreateRoomRequest.cs
+++ b/osu.Game/Online/Rooms/CreateRoomRequest.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.
 
+#nullable disable
+
 using System.Net.Http;
 using Newtonsoft.Json;
 using osu.Framework.IO.Network;
diff --git a/osu.Game/Online/Rooms/CreateRoomScoreRequest.cs b/osu.Game/Online/Rooms/CreateRoomScoreRequest.cs
index d4303e77df..65731b2b68 100644
--- a/osu.Game/Online/Rooms/CreateRoomScoreRequest.cs
+++ b/osu.Game/Online/Rooms/CreateRoomScoreRequest.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.
 
+#nullable disable
+
 using System.Net.Http;
 using osu.Framework.IO.Network;
 using osu.Game.Online.API;
diff --git a/osu.Game/Online/Rooms/GetRoomLeaderboardRequest.cs b/osu.Game/Online/Rooms/GetRoomLeaderboardRequest.cs
index 67e2a2b27f..6b5ed2d024 100644
--- a/osu.Game/Online/Rooms/GetRoomLeaderboardRequest.cs
+++ b/osu.Game/Online/Rooms/GetRoomLeaderboardRequest.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.
 
+#nullable disable
+
 using osu.Game.Online.API;
 
 namespace osu.Game.Online.Rooms
diff --git a/osu.Game/Online/Rooms/GetRoomRequest.cs b/osu.Game/Online/Rooms/GetRoomRequest.cs
index 853873901e..237d427509 100644
--- a/osu.Game/Online/Rooms/GetRoomRequest.cs
+++ b/osu.Game/Online/Rooms/GetRoomRequest.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.
 
+#nullable disable
+
 using osu.Game.Online.API;
 
 namespace osu.Game.Online.Rooms
diff --git a/osu.Game/Online/Rooms/GetRoomsRequest.cs b/osu.Game/Online/Rooms/GetRoomsRequest.cs
index e45365797a..5ae9d58189 100644
--- a/osu.Game/Online/Rooms/GetRoomsRequest.cs
+++ b/osu.Game/Online/Rooms/GetRoomsRequest.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using Humanizer;
 using osu.Framework.IO.Network;
diff --git a/osu.Game/Online/Rooms/IndexPlaylistScoresRequest.cs b/osu.Game/Online/Rooms/IndexPlaylistScoresRequest.cs
index bd9f254e1a..1e50155623 100644
--- a/osu.Game/Online/Rooms/IndexPlaylistScoresRequest.cs
+++ b/osu.Game/Online/Rooms/IndexPlaylistScoresRequest.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.
 
+#nullable disable
+
 using System.Diagnostics;
 using JetBrains.Annotations;
 using osu.Framework.IO.Network;
diff --git a/osu.Game/Online/Rooms/IndexScoresParams.cs b/osu.Game/Online/Rooms/IndexScoresParams.cs
index 3df8c8e753..253caa13a1 100644
--- a/osu.Game/Online/Rooms/IndexScoresParams.cs
+++ b/osu.Game/Online/Rooms/IndexScoresParams.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using JetBrains.Annotations;
 using Newtonsoft.Json;
diff --git a/osu.Game/Online/Rooms/IndexedMultiplayerScores.cs b/osu.Game/Online/Rooms/IndexedMultiplayerScores.cs
index 2008d1aa52..459602f1b4 100644
--- a/osu.Game/Online/Rooms/IndexedMultiplayerScores.cs
+++ b/osu.Game/Online/Rooms/IndexedMultiplayerScores.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.
 
+#nullable disable
+
 using JetBrains.Annotations;
 using Newtonsoft.Json;
 
diff --git a/osu.Game/Online/Rooms/ItemAttemptsCount.cs b/osu.Game/Online/Rooms/ItemAttemptsCount.cs
index 298603d778..71f50b9898 100644
--- a/osu.Game/Online/Rooms/ItemAttemptsCount.cs
+++ b/osu.Game/Online/Rooms/ItemAttemptsCount.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.
 
+#nullable disable
+
 using Newtonsoft.Json;
 
 namespace osu.Game.Online.Rooms
diff --git a/osu.Game/Online/Rooms/JoinRoomRequest.cs b/osu.Game/Online/Rooms/JoinRoomRequest.cs
index 2a3480c992..0a687312e7 100644
--- a/osu.Game/Online/Rooms/JoinRoomRequest.cs
+++ b/osu.Game/Online/Rooms/JoinRoomRequest.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.
 
+#nullable disable
+
 using System.Net.Http;
 using osu.Framework.IO.Network;
 using osu.Game.Online.API;
diff --git a/osu.Game/Online/Rooms/MatchType.cs b/osu.Game/Online/Rooms/MatchType.cs
index 278f0693eb..fd2f583f83 100644
--- a/osu.Game/Online/Rooms/MatchType.cs
+++ b/osu.Game/Online/Rooms/MatchType.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.
 
+#nullable disable
+
 using osu.Framework.Localisation;
 using osu.Game.Resources.Localisation.Web;
 
diff --git a/osu.Game/Online/Rooms/MultiplayerPlaylistItem.cs b/osu.Game/Online/Rooms/MultiplayerPlaylistItem.cs
index 388a02f798..c45f703b05 100644
--- a/osu.Game/Online/Rooms/MultiplayerPlaylistItem.cs
+++ b/osu.Game/Online/Rooms/MultiplayerPlaylistItem.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 enable
-
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Online/Rooms/MultiplayerScore.cs b/osu.Game/Online/Rooms/MultiplayerScore.cs
index 85327be037..13f14bca5b 100644
--- a/osu.Game/Online/Rooms/MultiplayerScore.cs
+++ b/osu.Game/Online/Rooms/MultiplayerScore.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Online/Rooms/MultiplayerScores.cs b/osu.Game/Online/Rooms/MultiplayerScores.cs
index 3f970b2f8e..4c13579b3e 100644
--- a/osu.Game/Online/Rooms/MultiplayerScores.cs
+++ b/osu.Game/Online/Rooms/MultiplayerScores.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using Newtonsoft.Json;
 using osu.Game.Online.API.Requests;
diff --git a/osu.Game/Online/Rooms/MultiplayerScoresAround.cs b/osu.Game/Online/Rooms/MultiplayerScoresAround.cs
index a99439312a..eca242bb0c 100644
--- a/osu.Game/Online/Rooms/MultiplayerScoresAround.cs
+++ b/osu.Game/Online/Rooms/MultiplayerScoresAround.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.
 
+#nullable disable
+
 using JetBrains.Annotations;
 using Newtonsoft.Json;
 
diff --git a/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs b/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs
index 4ca6d79b19..032215f5d3 100644
--- a/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.cs
+++ b/osu.Game/Online/Rooms/OnlinePlayBeatmapAvailabilityTracker.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.
 
+#nullable disable
+
 using System;
 using System.Diagnostics;
 using System.Linq;
diff --git a/osu.Game/Online/Rooms/PartRoomRequest.cs b/osu.Game/Online/Rooms/PartRoomRequest.cs
index 2f036abc8c..da4e9a44c5 100644
--- a/osu.Game/Online/Rooms/PartRoomRequest.cs
+++ b/osu.Game/Online/Rooms/PartRoomRequest.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.
 
+#nullable disable
+
 using System.Net.Http;
 using osu.Framework.IO.Network;
 using osu.Game.Online.API;
diff --git a/osu.Game/Online/Rooms/PlaylistAggregateScore.cs b/osu.Game/Online/Rooms/PlaylistAggregateScore.cs
index 61e0951cd5..85e7b29a05 100644
--- a/osu.Game/Online/Rooms/PlaylistAggregateScore.cs
+++ b/osu.Game/Online/Rooms/PlaylistAggregateScore.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.
 
+#nullable disable
+
 using Newtonsoft.Json;
 
 namespace osu.Game.Online.Rooms
diff --git a/osu.Game/Online/Rooms/PlaylistExtensions.cs b/osu.Game/Online/Rooms/PlaylistExtensions.cs
index 34c93bd9e0..cd52a3c6e6 100644
--- a/osu.Game/Online/Rooms/PlaylistExtensions.cs
+++ b/osu.Game/Online/Rooms/PlaylistExtensions.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 enable
-
 using System.Collections.Generic;
 using System.Linq;
 using Humanizer;
diff --git a/osu.Game/Online/Rooms/PlaylistItem.cs b/osu.Game/Online/Rooms/PlaylistItem.cs
index 12091bae88..a0711d9ded 100644
--- a/osu.Game/Online/Rooms/PlaylistItem.cs
+++ b/osu.Game/Online/Rooms/PlaylistItem.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 enable
-
 using System;
 using System.Linq;
 using JetBrains.Annotations;
diff --git a/osu.Game/Online/Rooms/Room.cs b/osu.Game/Online/Rooms/Room.cs
index 1933267efd..3a24fa02a8 100644
--- a/osu.Game/Online/Rooms/Room.cs
+++ b/osu.Game/Online/Rooms/Room.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using Newtonsoft.Json;
diff --git a/osu.Game/Online/Rooms/RoomAvailability.cs b/osu.Game/Online/Rooms/RoomAvailability.cs
index 3aea0e5948..fada111826 100644
--- a/osu.Game/Online/Rooms/RoomAvailability.cs
+++ b/osu.Game/Online/Rooms/RoomAvailability.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.
 
+#nullable disable
+
 using System.ComponentModel;
 
 namespace osu.Game.Online.Rooms
diff --git a/osu.Game/Online/Rooms/RoomCategory.cs b/osu.Game/Online/Rooms/RoomCategory.cs
index bca4d78359..ba17fb2121 100644
--- a/osu.Game/Online/Rooms/RoomCategory.cs
+++ b/osu.Game/Online/Rooms/RoomCategory.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.
 
+#nullable disable
+
 using System.ComponentModel;
 
 namespace osu.Game.Online.Rooms
diff --git a/osu.Game/Online/Rooms/RoomStatus.cs b/osu.Game/Online/Rooms/RoomStatus.cs
index 87c5aa3fda..4b890b00b7 100644
--- a/osu.Game/Online/Rooms/RoomStatus.cs
+++ b/osu.Game/Online/Rooms/RoomStatus.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.
 
+#nullable disable
+
 using osu.Game.Graphics;
 using osuTK.Graphics;
 
diff --git a/osu.Game/Online/Rooms/RoomStatuses/RoomStatusEnded.cs b/osu.Game/Online/Rooms/RoomStatuses/RoomStatusEnded.cs
index 01f3ae368b..9aa6424592 100644
--- a/osu.Game/Online/Rooms/RoomStatuses/RoomStatusEnded.cs
+++ b/osu.Game/Online/Rooms/RoomStatuses/RoomStatusEnded.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.
 
+#nullable disable
+
 using osu.Game.Graphics;
 using osuTK.Graphics;
 
diff --git a/osu.Game/Online/Rooms/RoomStatuses/RoomStatusOpen.cs b/osu.Game/Online/Rooms/RoomStatuses/RoomStatusOpen.cs
index 686d4f4033..c37b93ea1b 100644
--- a/osu.Game/Online/Rooms/RoomStatuses/RoomStatusOpen.cs
+++ b/osu.Game/Online/Rooms/RoomStatuses/RoomStatusOpen.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.
 
+#nullable disable
+
 using osu.Game.Graphics;
 using osuTK.Graphics;
 
diff --git a/osu.Game/Online/Rooms/RoomStatuses/RoomStatusPlaying.cs b/osu.Game/Online/Rooms/RoomStatuses/RoomStatusPlaying.cs
index 83f1acf52a..9eb61a82ec 100644
--- a/osu.Game/Online/Rooms/RoomStatuses/RoomStatusPlaying.cs
+++ b/osu.Game/Online/Rooms/RoomStatuses/RoomStatusPlaying.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.
 
+#nullable disable
+
 using osu.Game.Graphics;
 using osuTK.Graphics;
 
diff --git a/osu.Game/Online/Rooms/ShowPlaylistUserScoreRequest.cs b/osu.Game/Online/Rooms/ShowPlaylistUserScoreRequest.cs
index ba3e3c6349..affb2846a2 100644
--- a/osu.Game/Online/Rooms/ShowPlaylistUserScoreRequest.cs
+++ b/osu.Game/Online/Rooms/ShowPlaylistUserScoreRequest.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.
 
+#nullable disable
+
 using osu.Game.Online.API;
 
 namespace osu.Game.Online.Rooms
diff --git a/osu.Game/Online/Rooms/SubmitRoomScoreRequest.cs b/osu.Game/Online/Rooms/SubmitRoomScoreRequest.cs
index 39193be1af..f4cadc3fde 100644
--- a/osu.Game/Online/Rooms/SubmitRoomScoreRequest.cs
+++ b/osu.Game/Online/Rooms/SubmitRoomScoreRequest.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.
 
+#nullable disable
+
 using osu.Game.Scoring;
 
 namespace osu.Game.Online.Rooms
diff --git a/osu.Game/Online/Rooms/SubmitScoreRequest.cs b/osu.Game/Online/Rooms/SubmitScoreRequest.cs
index b263262d2b..d681938da5 100644
--- a/osu.Game/Online/Rooms/SubmitScoreRequest.cs
+++ b/osu.Game/Online/Rooms/SubmitScoreRequest.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.
 
+#nullable disable
+
 using System.Net.Http;
 using Newtonsoft.Json;
 using osu.Framework.IO.Network;
diff --git a/osu.Game/Online/ScoreDownloadTracker.cs b/osu.Game/Online/ScoreDownloadTracker.cs
index ed1c566dbe..cab6bd0722 100644
--- a/osu.Game/Online/ScoreDownloadTracker.cs
+++ b/osu.Game/Online/ScoreDownloadTracker.cs
@@ -9,8 +9,6 @@ using osu.Game.Extensions;
 using osu.Game.Online.API;
 using osu.Game.Scoring;
 
-#nullable enable
-
 namespace osu.Game.Online
 {
     public class ScoreDownloadTracker : DownloadTracker<ScoreInfo>
diff --git a/osu.Game/Online/SignalRDerivedTypeWorkaroundJsonConverter.cs b/osu.Game/Online/SignalRDerivedTypeWorkaroundJsonConverter.cs
index ab04e046d3..a999cb47f8 100644
--- a/osu.Game/Online/SignalRDerivedTypeWorkaroundJsonConverter.cs
+++ b/osu.Game/Online/SignalRDerivedTypeWorkaroundJsonConverter.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.
 
-#nullable enable
 using System;
 using System.Linq;
 using Newtonsoft.Json;
diff --git a/osu.Game/Online/SignalRUnionWorkaroundResolver.cs b/osu.Game/Online/SignalRUnionWorkaroundResolver.cs
index c96f93df78..e58cd83477 100644
--- a/osu.Game/Online/SignalRUnionWorkaroundResolver.cs
+++ b/osu.Game/Online/SignalRUnionWorkaroundResolver.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Online/SignalRWorkaroundTypes.cs b/osu.Game/Online/SignalRWorkaroundTypes.cs
index d1f0ba725f..29e01e13ae 100644
--- a/osu.Game/Online/SignalRWorkaroundTypes.cs
+++ b/osu.Game/Online/SignalRWorkaroundTypes.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using osu.Game.Online.Multiplayer;
diff --git a/osu.Game/Online/Solo/CreateSoloScoreRequest.cs b/osu.Game/Online/Solo/CreateSoloScoreRequest.cs
index 0d2bea1f2a..e4612b6659 100644
--- a/osu.Game/Online/Solo/CreateSoloScoreRequest.cs
+++ b/osu.Game/Online/Solo/CreateSoloScoreRequest.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.
 
+#nullable disable
+
 using System.Globalization;
 using System.Net.Http;
 using osu.Framework.IO.Network;
diff --git a/osu.Game/Online/Solo/SubmitSoloScoreRequest.cs b/osu.Game/Online/Solo/SubmitSoloScoreRequest.cs
index 77fd7b813b..f387e61901 100644
--- a/osu.Game/Online/Solo/SubmitSoloScoreRequest.cs
+++ b/osu.Game/Online/Solo/SubmitSoloScoreRequest.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.
 
+#nullable disable
+
 using osu.Game.Online.Rooms;
 using osu.Game.Scoring;
 
diff --git a/osu.Game/Online/Solo/SubmittableScore.cs b/osu.Game/Online/Solo/SubmittableScore.cs
index 9b6da1844a..31f0cb1dfb 100644
--- a/osu.Game/Online/Solo/SubmittableScore.cs
+++ b/osu.Game/Online/Solo/SubmittableScore.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using JetBrains.Annotations;
diff --git a/osu.Game/Online/Spectator/FrameDataBundle.cs b/osu.Game/Online/Spectator/FrameDataBundle.cs
index a4c4972989..97ae468875 100644
--- a/osu.Game/Online/Spectator/FrameDataBundle.cs
+++ b/osu.Game/Online/Spectator/FrameDataBundle.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 enable
-
 using System;
 using System.Collections.Generic;
 using MessagePack;
diff --git a/osu.Game/Online/Spectator/FrameHeader.cs b/osu.Game/Online/Spectator/FrameHeader.cs
index adfcbcd95a..b6dcd8aaa5 100644
--- a/osu.Game/Online/Spectator/FrameHeader.cs
+++ b/osu.Game/Online/Spectator/FrameHeader.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 enable
-
 using System;
 using System.Collections.Generic;
 using MessagePack;
diff --git a/osu.Game/Online/Spectator/ISpectatorClient.cs b/osu.Game/Online/Spectator/ISpectatorClient.cs
index 3acc9b2282..ccba280001 100644
--- a/osu.Game/Online/Spectator/ISpectatorClient.cs
+++ b/osu.Game/Online/Spectator/ISpectatorClient.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.
 
+#nullable disable
+
 using System.Threading.Tasks;
 
 namespace osu.Game.Online.Spectator
diff --git a/osu.Game/Online/Spectator/ISpectatorServer.cs b/osu.Game/Online/Spectator/ISpectatorServer.cs
index af0196862a..25785f60a4 100644
--- a/osu.Game/Online/Spectator/ISpectatorServer.cs
+++ b/osu.Game/Online/Spectator/ISpectatorServer.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.
 
+#nullable disable
+
 using System.Threading.Tasks;
 
 namespace osu.Game.Online.Spectator
diff --git a/osu.Game/Online/Spectator/OnlineSpectatorClient.cs b/osu.Game/Online/Spectator/OnlineSpectatorClient.cs
index 0f77f723db..cd9f5233a2 100644
--- a/osu.Game/Online/Spectator/OnlineSpectatorClient.cs
+++ b/osu.Game/Online/Spectator/OnlineSpectatorClient.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 enable
-
 using System.Diagnostics;
 using System.Threading.Tasks;
 using Microsoft.AspNetCore.SignalR;
diff --git a/osu.Game/Online/Spectator/SpectatedUserState.cs b/osu.Game/Online/Spectator/SpectatedUserState.cs
index 0f0a3068b8..edf0859a33 100644
--- a/osu.Game/Online/Spectator/SpectatedUserState.cs
+++ b/osu.Game/Online/Spectator/SpectatedUserState.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.
 
+#nullable disable
+
 namespace osu.Game.Online.Spectator
 {
     public enum SpectatedUserState
diff --git a/osu.Game/Online/Spectator/SpectatorClient.cs b/osu.Game/Online/Spectator/SpectatorClient.cs
index 9bf49364f3..4a43aa6c66 100644
--- a/osu.Game/Online/Spectator/SpectatorClient.cs
+++ b/osu.Game/Online/Spectator/SpectatorClient.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 enable
-
 using System;
 using System.Collections.Generic;
 using System.Diagnostics;
diff --git a/osu.Game/Online/Spectator/SpectatorScoreProcessor.cs b/osu.Game/Online/Spectator/SpectatorScoreProcessor.cs
index a1e8715c8f..87f25874c5 100644
--- a/osu.Game/Online/Spectator/SpectatorScoreProcessor.cs
+++ b/osu.Game/Online/Spectator/SpectatorScoreProcessor.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 enable
-
 using System;
 using System.Collections.Generic;
 using System.Diagnostics;
diff --git a/osu.Game/Online/Spectator/SpectatorState.cs b/osu.Game/Online/Spectator/SpectatorState.cs
index 64e5f8b3a1..766b274e63 100644
--- a/osu.Game/Online/Spectator/SpectatorState.cs
+++ b/osu.Game/Online/Spectator/SpectatorState.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Diagnostics.CodeAnalysis;
diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index 200f7613a1..3041761a6b 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Diagnostics;
diff --git a/osu.Game/OsuGameBase.cs b/osu.Game/OsuGameBase.cs
index 4a249e8b44..9908697bf1 100644
--- a/osu.Game/OsuGameBase.cs
+++ b/osu.Game/OsuGameBase.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.IO;
diff --git a/osu.Game/OsuGameBase_Importing.cs b/osu.Game/OsuGameBase_Importing.cs
index d712da3553..e34e48f21d 100644
--- a/osu.Game/OsuGameBase_Importing.cs
+++ b/osu.Game/OsuGameBase_Importing.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.IO;
 using System.Linq;
diff --git a/osu.Game/Overlays/AccountCreation/AccountCreationBackground.cs b/osu.Game/Overlays/AccountCreation/AccountCreationBackground.cs
index 2e52ca74f3..2b372c18eb 100644
--- a/osu.Game/Overlays/AccountCreation/AccountCreationBackground.cs
+++ b/osu.Game/Overlays/AccountCreation/AccountCreationBackground.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Sprites;
diff --git a/osu.Game/Overlays/AccountCreation/AccountCreationScreen.cs b/osu.Game/Overlays/AccountCreation/AccountCreationScreen.cs
index 6aef358b2e..299a41f45b 100644
--- a/osu.Game/Overlays/AccountCreation/AccountCreationScreen.cs
+++ b/osu.Game/Overlays/AccountCreation/AccountCreationScreen.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Screens;
 
diff --git a/osu.Game/Overlays/AccountCreation/ScreenEntry.cs b/osu.Game/Overlays/AccountCreation/ScreenEntry.cs
index f4f958e4a4..2120f351a2 100644
--- a/osu.Game/Overlays/AccountCreation/ScreenEntry.cs
+++ b/osu.Game/Overlays/AccountCreation/ScreenEntry.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using System.Threading.Tasks;
diff --git a/osu.Game/Overlays/AccountCreation/ScreenWarning.cs b/osu.Game/Overlays/AccountCreation/ScreenWarning.cs
index 780a79f8f9..f8070788c2 100644
--- a/osu.Game/Overlays/AccountCreation/ScreenWarning.cs
+++ b/osu.Game/Overlays/AccountCreation/ScreenWarning.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Overlays/AccountCreation/ScreenWelcome.cs b/osu.Game/Overlays/AccountCreation/ScreenWelcome.cs
index f6ddb135ec..1936ad533a 100644
--- a/osu.Game/Overlays/AccountCreation/ScreenWelcome.cs
+++ b/osu.Game/Overlays/AccountCreation/ScreenWelcome.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Overlays/AccountCreationOverlay.cs b/osu.Game/Overlays/AccountCreationOverlay.cs
index a96aff2a5d..c51ed07c38 100644
--- a/osu.Game/Overlays/AccountCreationOverlay.cs
+++ b/osu.Game/Overlays/AccountCreationOverlay.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Extensions.Color4Extensions;
diff --git a/osu.Game/Overlays/BeatmapListing/BeatmapListingCardSizeTabControl.cs b/osu.Game/Overlays/BeatmapListing/BeatmapListingCardSizeTabControl.cs
index 1f9a63e3b9..13da9d335c 100644
--- a/osu.Game/Overlays/BeatmapListing/BeatmapListingCardSizeTabControl.cs
+++ b/osu.Game/Overlays/BeatmapListing/BeatmapListingCardSizeTabControl.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Overlays/BeatmapListing/BeatmapListingFilterControl.cs b/osu.Game/Overlays/BeatmapListing/BeatmapListingFilterControl.cs
index e4628e3723..4457705676 100644
--- a/osu.Game/Overlays/BeatmapListing/BeatmapListingFilterControl.cs
+++ b/osu.Game/Overlays/BeatmapListing/BeatmapListingFilterControl.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Overlays/BeatmapListing/BeatmapListingHeader.cs b/osu.Game/Overlays/BeatmapListing/BeatmapListingHeader.cs
index 3568fe9e4f..ccab810612 100644
--- a/osu.Game/Overlays/BeatmapListing/BeatmapListingHeader.cs
+++ b/osu.Game/Overlays/BeatmapListing/BeatmapListingHeader.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.
 
+#nullable disable
+
 using osu.Game.Localisation;
 using osu.Game.Resources.Localisation.Web;
 
diff --git a/osu.Game/Overlays/BeatmapListing/BeatmapListingSearchControl.cs b/osu.Game/Overlays/BeatmapListing/BeatmapListingSearchControl.cs
index eeaa31a013..86cf3b5588 100644
--- a/osu.Game/Overlays/BeatmapListing/BeatmapListingSearchControl.cs
+++ b/osu.Game/Overlays/BeatmapListing/BeatmapListingSearchControl.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Overlays/BeatmapListing/BeatmapListingSortTabControl.cs b/osu.Game/Overlays/BeatmapListing/BeatmapListingSortTabControl.cs
index 4c77a736ac..454f381c60 100644
--- a/osu.Game/Overlays/BeatmapListing/BeatmapListingSortTabControl.cs
+++ b/osu.Game/Overlays/BeatmapListing/BeatmapListingSortTabControl.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.
 
+#nullable disable
+
 using osu.Framework.Bindables;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Graphics.UserInterface;
diff --git a/osu.Game/Overlays/BeatmapListing/BeatmapSearchFilterRow.cs b/osu.Game/Overlays/BeatmapListing/BeatmapSearchFilterRow.cs
index 4c831543fe..8ae39aeaca 100644
--- a/osu.Game/Overlays/BeatmapListing/BeatmapSearchFilterRow.cs
+++ b/osu.Game/Overlays/BeatmapListing/BeatmapSearchFilterRow.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.
 
+#nullable disable
+
 using JetBrains.Annotations;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Overlays/BeatmapListing/BeatmapSearchGeneralFilterRow.cs b/osu.Game/Overlays/BeatmapListing/BeatmapSearchGeneralFilterRow.cs
index 51dad100c2..c01aa9a1c4 100644
--- a/osu.Game/Overlays/BeatmapListing/BeatmapSearchGeneralFilterRow.cs
+++ b/osu.Game/Overlays/BeatmapListing/BeatmapSearchGeneralFilterRow.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Game.Graphics;
 using osu.Game.Resources.Localisation.Web;
diff --git a/osu.Game/Overlays/BeatmapListing/BeatmapSearchMultipleSelectionFilterRow.cs b/osu.Game/Overlays/BeatmapListing/BeatmapSearchMultipleSelectionFilterRow.cs
index 461a06a634..cca75e9548 100644
--- a/osu.Game/Overlays/BeatmapListing/BeatmapSearchMultipleSelectionFilterRow.cs
+++ b/osu.Game/Overlays/BeatmapListing/BeatmapSearchMultipleSelectionFilterRow.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Overlays/BeatmapListing/BeatmapSearchRulesetFilterRow.cs b/osu.Game/Overlays/BeatmapListing/BeatmapSearchRulesetFilterRow.cs
index e2c84c537c..526c14511e 100644
--- a/osu.Game/Overlays/BeatmapListing/BeatmapSearchRulesetFilterRow.cs
+++ b/osu.Game/Overlays/BeatmapListing/BeatmapSearchRulesetFilterRow.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Localisation;
diff --git a/osu.Game/Overlays/BeatmapListing/BeatmapSearchScoreFilterRow.cs b/osu.Game/Overlays/BeatmapListing/BeatmapSearchScoreFilterRow.cs
index b39934b56f..118ddfb060 100644
--- a/osu.Game/Overlays/BeatmapListing/BeatmapSearchScoreFilterRow.cs
+++ b/osu.Game/Overlays/BeatmapListing/BeatmapSearchScoreFilterRow.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using osu.Framework.Extensions;
diff --git a/osu.Game/Overlays/BeatmapListing/FilterTabItem.cs b/osu.Game/Overlays/BeatmapListing/FilterTabItem.cs
index ff43170207..cc131ffc27 100644
--- a/osu.Game/Overlays/BeatmapListing/FilterTabItem.cs
+++ b/osu.Game/Overlays/BeatmapListing/FilterTabItem.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Extensions;
diff --git a/osu.Game/Overlays/BeatmapListing/SearchCategory.cs b/osu.Game/Overlays/BeatmapListing/SearchCategory.cs
index b52df6234f..b3e12d00a6 100644
--- a/osu.Game/Overlays/BeatmapListing/SearchCategory.cs
+++ b/osu.Game/Overlays/BeatmapListing/SearchCategory.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.
 
+#nullable disable
+
 using System.ComponentModel;
 using osu.Framework.Localisation;
 using osu.Game.Resources.Localisation.Web;
diff --git a/osu.Game/Overlays/BeatmapListing/SearchExplicit.cs b/osu.Game/Overlays/BeatmapListing/SearchExplicit.cs
index 80482b32a0..10fea6d5b2 100644
--- a/osu.Game/Overlays/BeatmapListing/SearchExplicit.cs
+++ b/osu.Game/Overlays/BeatmapListing/SearchExplicit.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.
 
+#nullable disable
+
 using osu.Framework.Localisation;
 using osu.Game.Resources.Localisation.Web;
 
diff --git a/osu.Game/Overlays/BeatmapListing/SearchExtra.cs b/osu.Game/Overlays/BeatmapListing/SearchExtra.cs
index e54632acd8..d307cd09eb 100644
--- a/osu.Game/Overlays/BeatmapListing/SearchExtra.cs
+++ b/osu.Game/Overlays/BeatmapListing/SearchExtra.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.
 
+#nullable disable
+
 using System.ComponentModel;
 using osu.Framework.Localisation;
 using osu.Game.Resources.Localisation.Web;
diff --git a/osu.Game/Overlays/BeatmapListing/SearchGeneral.cs b/osu.Game/Overlays/BeatmapListing/SearchGeneral.cs
index 34ff5b9840..ebcbef1ad9 100644
--- a/osu.Game/Overlays/BeatmapListing/SearchGeneral.cs
+++ b/osu.Game/Overlays/BeatmapListing/SearchGeneral.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.
 
+#nullable disable
+
 using System.ComponentModel;
 using osu.Framework.Localisation;
 using osu.Game.Resources.Localisation.Web;
diff --git a/osu.Game/Overlays/BeatmapListing/SearchGenre.cs b/osu.Game/Overlays/BeatmapListing/SearchGenre.cs
index 08855284cb..7746eb50d7 100644
--- a/osu.Game/Overlays/BeatmapListing/SearchGenre.cs
+++ b/osu.Game/Overlays/BeatmapListing/SearchGenre.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.
 
+#nullable disable
+
 using System.ComponentModel;
 using osu.Framework.Localisation;
 using osu.Game.Resources.Localisation.Web;
diff --git a/osu.Game/Overlays/BeatmapListing/SearchLanguage.cs b/osu.Game/Overlays/BeatmapListing/SearchLanguage.cs
index 7ffa0282b7..d52f923158 100644
--- a/osu.Game/Overlays/BeatmapListing/SearchLanguage.cs
+++ b/osu.Game/Overlays/BeatmapListing/SearchLanguage.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.
 
+#nullable disable
+
 using osu.Framework.Localisation;
 using osu.Framework.Utils;
 using osu.Game.Resources.Localisation.Web;
diff --git a/osu.Game/Overlays/BeatmapListing/SearchPlayed.cs b/osu.Game/Overlays/BeatmapListing/SearchPlayed.cs
index 3b04ac01ca..0c379b3825 100644
--- a/osu.Game/Overlays/BeatmapListing/SearchPlayed.cs
+++ b/osu.Game/Overlays/BeatmapListing/SearchPlayed.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.
 
+#nullable disable
+
 using osu.Framework.Localisation;
 using osu.Game.Resources.Localisation.Web;
 
diff --git a/osu.Game/Overlays/BeatmapListing/SortCriteria.cs b/osu.Game/Overlays/BeatmapListing/SortCriteria.cs
index 871b3c162b..ff6e62b274 100644
--- a/osu.Game/Overlays/BeatmapListing/SortCriteria.cs
+++ b/osu.Game/Overlays/BeatmapListing/SortCriteria.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.
 
+#nullable disable
+
 using osu.Framework.Localisation;
 using osu.Game.Resources.Localisation.Web;
 
diff --git a/osu.Game/Overlays/BeatmapListingOverlay.cs b/osu.Game/Overlays/BeatmapListingOverlay.cs
index 3476968ded..cfa53009ef 100644
--- a/osu.Game/Overlays/BeatmapListingOverlay.cs
+++ b/osu.Game/Overlays/BeatmapListingOverlay.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using System.Threading;
diff --git a/osu.Game/Overlays/BeatmapSet/AuthorInfo.cs b/osu.Game/Overlays/BeatmapSet/AuthorInfo.cs
index 9131f6f74c..2341997626 100644
--- a/osu.Game/Overlays/BeatmapSet/AuthorInfo.cs
+++ b/osu.Game/Overlays/BeatmapSet/AuthorInfo.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.Color4Extensions;
diff --git a/osu.Game/Overlays/BeatmapSet/BasicStats.cs b/osu.Game/Overlays/BeatmapSet/BasicStats.cs
index 8f848edf24..a8bbb9fe1c 100644
--- a/osu.Game/Overlays/BeatmapSet/BasicStats.cs
+++ b/osu.Game/Overlays/BeatmapSet/BasicStats.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.Color4Extensions;
diff --git a/osu.Game/Overlays/BeatmapSet/BeatmapAvailability.cs b/osu.Game/Overlays/BeatmapSet/BeatmapAvailability.cs
index b6e768d632..d893ef80d8 100644
--- a/osu.Game/Overlays/BeatmapSet/BeatmapAvailability.cs
+++ b/osu.Game/Overlays/BeatmapSet/BeatmapAvailability.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.
 
+#nullable disable
+
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Overlays/BeatmapSet/BeatmapBadge.cs b/osu.Game/Overlays/BeatmapSet/BeatmapBadge.cs
index a75fc8e888..52fed99431 100644
--- a/osu.Game/Overlays/BeatmapSet/BeatmapBadge.cs
+++ b/osu.Game/Overlays/BeatmapSet/BeatmapBadge.cs
@@ -10,8 +10,6 @@ using osu.Framework.Localisation;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
 
-#nullable enable
-
 namespace osu.Game.Overlays.BeatmapSet
 {
     public abstract class BeatmapBadge : CompositeDrawable
diff --git a/osu.Game/Overlays/BeatmapSet/BeatmapPicker.cs b/osu.Game/Overlays/BeatmapSet/BeatmapPicker.cs
index 031442814d..8d89bb3cc7 100644
--- a/osu.Game/Overlays/BeatmapSet/BeatmapPicker.cs
+++ b/osu.Game/Overlays/BeatmapSet/BeatmapPicker.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using osu.Framework;
diff --git a/osu.Game/Overlays/BeatmapSet/BeatmapRulesetSelector.cs b/osu.Game/Overlays/BeatmapSet/BeatmapRulesetSelector.cs
index 6564ca3d41..0f5eb18c4e 100644
--- a/osu.Game/Overlays/BeatmapSet/BeatmapRulesetSelector.cs
+++ b/osu.Game/Overlays/BeatmapSet/BeatmapRulesetSelector.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.
 
+#nullable disable
+
 using osu.Framework.Bindables;
 using osu.Framework.Graphics.UserInterface;
 using osu.Game.Rulesets;
diff --git a/osu.Game/Overlays/BeatmapSet/BeatmapRulesetTabItem.cs b/osu.Game/Overlays/BeatmapSet/BeatmapRulesetTabItem.cs
index e8cdc6913b..e9acca5bcd 100644
--- a/osu.Game/Overlays/BeatmapSet/BeatmapRulesetTabItem.cs
+++ b/osu.Game/Overlays/BeatmapSet/BeatmapRulesetTabItem.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.
 
+#nullable disable
+
 using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Overlays/BeatmapSet/BeatmapSetHeader.cs b/osu.Game/Overlays/BeatmapSet/BeatmapSetHeader.cs
index 102cddfa92..02da7812d1 100644
--- a/osu.Game/Overlays/BeatmapSet/BeatmapSetHeader.cs
+++ b/osu.Game/Overlays/BeatmapSet/BeatmapSetHeader.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Extensions.Color4Extensions;
diff --git a/osu.Game/Overlays/BeatmapSet/BeatmapSetHeaderContent.cs b/osu.Game/Overlays/BeatmapSet/BeatmapSetHeaderContent.cs
index e0fc7482f6..c9e97d5f2f 100644
--- a/osu.Game/Overlays/BeatmapSet/BeatmapSetHeaderContent.cs
+++ b/osu.Game/Overlays/BeatmapSet/BeatmapSetHeaderContent.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.
 
+#nullable disable
+
 using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Overlays/BeatmapSet/BeatmapSetLayoutSection.cs b/osu.Game/Overlays/BeatmapSet/BeatmapSetLayoutSection.cs
index e6d433f7bc..797b6716e7 100644
--- a/osu.Game/Overlays/BeatmapSet/BeatmapSetLayoutSection.cs
+++ b/osu.Game/Overlays/BeatmapSet/BeatmapSetLayoutSection.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.
 
+#nullable disable
+
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Overlays/BeatmapSet/Buttons/FavouriteButton.cs b/osu.Game/Overlays/BeatmapSet/Buttons/FavouriteButton.cs
index 28100e5fff..f7c8aa44ad 100644
--- a/osu.Game/Overlays/BeatmapSet/Buttons/FavouriteButton.cs
+++ b/osu.Game/Overlays/BeatmapSet/Buttons/FavouriteButton.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.
 
+#nullable disable
+
 using System.Diagnostics;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Overlays/BeatmapSet/Buttons/HeaderButton.cs b/osu.Game/Overlays/BeatmapSet/Buttons/HeaderButton.cs
index 99b0b2ed3b..25d11bd6d7 100644
--- a/osu.Game/Overlays/BeatmapSet/Buttons/HeaderButton.cs
+++ b/osu.Game/Overlays/BeatmapSet/Buttons/HeaderButton.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Overlays/BeatmapSet/Buttons/HeaderDownloadButton.cs b/osu.Game/Overlays/BeatmapSet/Buttons/HeaderDownloadButton.cs
index 74417b0ac6..c2de96f245 100644
--- a/osu.Game/Overlays/BeatmapSet/Buttons/HeaderDownloadButton.cs
+++ b/osu.Game/Overlays/BeatmapSet/Buttons/HeaderDownloadButton.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Overlays/BeatmapSet/Buttons/PlayButton.cs b/osu.Game/Overlays/BeatmapSet/Buttons/PlayButton.cs
index 63b7a0a062..e840d0e82c 100644
--- a/osu.Game/Overlays/BeatmapSet/Buttons/PlayButton.cs
+++ b/osu.Game/Overlays/BeatmapSet/Buttons/PlayButton.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Overlays/BeatmapSet/Buttons/PreviewButton.cs b/osu.Game/Overlays/BeatmapSet/Buttons/PreviewButton.cs
index 751299161d..8fc8927c4b 100644
--- a/osu.Game/Overlays/BeatmapSet/Buttons/PreviewButton.cs
+++ b/osu.Game/Overlays/BeatmapSet/Buttons/PreviewButton.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Overlays/BeatmapSet/Details.cs b/osu.Game/Overlays/BeatmapSet/Details.cs
index dfc8d5e680..6db54db811 100644
--- a/osu.Game/Overlays/BeatmapSet/Details.cs
+++ b/osu.Game/Overlays/BeatmapSet/Details.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Overlays/BeatmapSet/ExplicitContentBeatmapBadge.cs b/osu.Game/Overlays/BeatmapSet/ExplicitContentBeatmapBadge.cs
index 2a20d22b61..18dcfc0385 100644
--- a/osu.Game/Overlays/BeatmapSet/ExplicitContentBeatmapBadge.cs
+++ b/osu.Game/Overlays/BeatmapSet/ExplicitContentBeatmapBadge.cs
@@ -5,8 +5,6 @@ using osu.Framework.Allocation;
 using osu.Game.Graphics;
 using osu.Game.Resources.Localisation.Web;
 
-#nullable enable
-
 namespace osu.Game.Overlays.BeatmapSet
 {
     public class ExplicitContentBeatmapBadge : BeatmapBadge
diff --git a/osu.Game/Overlays/BeatmapSet/FeaturedArtistBeatmapBadge.cs b/osu.Game/Overlays/BeatmapSet/FeaturedArtistBeatmapBadge.cs
index 20ee11c7f6..a0ee0a18ec 100644
--- a/osu.Game/Overlays/BeatmapSet/FeaturedArtistBeatmapBadge.cs
+++ b/osu.Game/Overlays/BeatmapSet/FeaturedArtistBeatmapBadge.cs
@@ -5,8 +5,6 @@ using osu.Framework.Allocation;
 using osu.Game.Graphics;
 using osu.Game.Resources.Localisation.Web;
 
-#nullable enable
-
 namespace osu.Game.Overlays.BeatmapSet
 {
     public class FeaturedArtistBeatmapBadge : BeatmapBadge
diff --git a/osu.Game/Overlays/BeatmapSet/Info.cs b/osu.Game/Overlays/BeatmapSet/Info.cs
index 3ef52d718d..666ceff6cb 100644
--- a/osu.Game/Overlays/BeatmapSet/Info.cs
+++ b/osu.Game/Overlays/BeatmapSet/Info.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Overlays/BeatmapSet/LeaderboardModSelector.cs b/osu.Game/Overlays/BeatmapSet/LeaderboardModSelector.cs
index 25aed4c980..8311368da3 100644
--- a/osu.Game/Overlays/BeatmapSet/LeaderboardModSelector.cs
+++ b/osu.Game/Overlays/BeatmapSet/LeaderboardModSelector.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.
 
+#nullable disable
+
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics;
 using osu.Game.Rulesets.Mods;
diff --git a/osu.Game/Overlays/BeatmapSet/LeaderboardScopeSelector.cs b/osu.Game/Overlays/BeatmapSet/LeaderboardScopeSelector.cs
index 607355b7bf..db7d04f597 100644
--- a/osu.Game/Overlays/BeatmapSet/LeaderboardScopeSelector.cs
+++ b/osu.Game/Overlays/BeatmapSet/LeaderboardScopeSelector.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.
 
+#nullable disable
+
 using osu.Game.Screens.Select.Leaderboards;
 using osu.Game.Graphics.UserInterface;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Overlays/BeatmapSet/MetadataSection.cs b/osu.Game/Overlays/BeatmapSet/MetadataSection.cs
index f1b9f98528..c6bf94f507 100644
--- a/osu.Game/Overlays/BeatmapSet/MetadataSection.cs
+++ b/osu.Game/Overlays/BeatmapSet/MetadataSection.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.
 
+#nullable disable
+
 using osu.Framework.Extensions;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Overlays/BeatmapSet/MetadataType.cs b/osu.Game/Overlays/BeatmapSet/MetadataType.cs
index f992dca0ef..924e020641 100644
--- a/osu.Game/Overlays/BeatmapSet/MetadataType.cs
+++ b/osu.Game/Overlays/BeatmapSet/MetadataType.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.
 
+#nullable disable
+
 using osu.Framework.Localisation;
 using osu.Game.Resources.Localisation.Web;
 
diff --git a/osu.Game/Overlays/BeatmapSet/Scores/DrawableTopScore.cs b/osu.Game/Overlays/BeatmapSet/Scores/DrawableTopScore.cs
index 0ae8a8bef5..06bf9e1d50 100644
--- a/osu.Game/Overlays/BeatmapSet/Scores/DrawableTopScore.cs
+++ b/osu.Game/Overlays/BeatmapSet/Scores/DrawableTopScore.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Overlays/BeatmapSet/Scores/NoScoresPlaceholder.cs b/osu.Game/Overlays/BeatmapSet/Scores/NoScoresPlaceholder.cs
index 82ca3e030f..47690bab1f 100644
--- a/osu.Game/Overlays/BeatmapSet/Scores/NoScoresPlaceholder.cs
+++ b/osu.Game/Overlays/BeatmapSet/Scores/NoScoresPlaceholder.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Screens.Select.Leaderboards;
diff --git a/osu.Game/Overlays/BeatmapSet/Scores/NotSupporterPlaceholder.cs b/osu.Game/Overlays/BeatmapSet/Scores/NotSupporterPlaceholder.cs
index d1a0960a08..b83b4d6b26 100644
--- a/osu.Game/Overlays/BeatmapSet/Scores/NotSupporterPlaceholder.cs
+++ b/osu.Game/Overlays/BeatmapSet/Scores/NotSupporterPlaceholder.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
diff --git a/osu.Game/Overlays/BeatmapSet/Scores/ScoreTable.cs b/osu.Game/Overlays/BeatmapSet/Scores/ScoreTable.cs
index 4b3407ba4c..b2e5be6601 100644
--- a/osu.Game/Overlays/BeatmapSet/Scores/ScoreTable.cs
+++ b/osu.Game/Overlays/BeatmapSet/Scores/ScoreTable.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using System.Collections.Generic;
diff --git a/osu.Game/Overlays/BeatmapSet/Scores/ScoreTableRowBackground.cs b/osu.Game/Overlays/BeatmapSet/Scores/ScoreTableRowBackground.cs
index b6079b36ab..c17bb70bc2 100644
--- a/osu.Game/Overlays/BeatmapSet/Scores/ScoreTableRowBackground.cs
+++ b/osu.Game/Overlays/BeatmapSet/Scores/ScoreTableRowBackground.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Overlays/BeatmapSet/Scores/ScoreboardTime.cs b/osu.Game/Overlays/BeatmapSet/Scores/ScoreboardTime.cs
index 5018fb8c70..72aa221432 100644
--- a/osu.Game/Overlays/BeatmapSet/Scores/ScoreboardTime.cs
+++ b/osu.Game/Overlays/BeatmapSet/Scores/ScoreboardTime.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.
 
+#nullable disable
+
 using System;
 using osu.Game.Extensions;
 using osu.Game.Graphics;
diff --git a/osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.cs b/osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.cs
index ebfb8f124b..2ea94bb412 100644
--- a/osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.cs
+++ b/osu.Game/Overlays/BeatmapSet/Scores/ScoresContainer.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.
 
+#nullable disable
+
 using System.Diagnostics;
 using System.Linq;
 using System.Threading;
diff --git a/osu.Game/Overlays/BeatmapSet/Scores/TopScoreStatisticsSection.cs b/osu.Game/Overlays/BeatmapSet/Scores/TopScoreStatisticsSection.cs
index f528f54cdf..3b5ab811ae 100644
--- a/osu.Game/Overlays/BeatmapSet/Scores/TopScoreStatisticsSection.cs
+++ b/osu.Game/Overlays/BeatmapSet/Scores/TopScoreStatisticsSection.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Overlays/BeatmapSet/Scores/TopScoreUserSection.cs b/osu.Game/Overlays/BeatmapSet/Scores/TopScoreUserSection.cs
index 1c0fcf0e3c..f093c6b53f 100644
--- a/osu.Game/Overlays/BeatmapSet/Scores/TopScoreUserSection.cs
+++ b/osu.Game/Overlays/BeatmapSet/Scores/TopScoreUserSection.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Extensions.LocalisationExtensions;
diff --git a/osu.Game/Overlays/BeatmapSet/SpotlightBeatmapBadge.cs b/osu.Game/Overlays/BeatmapSet/SpotlightBeatmapBadge.cs
index 9c5378a967..44b3acea5f 100644
--- a/osu.Game/Overlays/BeatmapSet/SpotlightBeatmapBadge.cs
+++ b/osu.Game/Overlays/BeatmapSet/SpotlightBeatmapBadge.cs
@@ -5,8 +5,6 @@ using osu.Framework.Allocation;
 using osu.Game.Graphics;
 using osu.Game.Resources.Localisation.Web;
 
-#nullable enable
-
 namespace osu.Game.Overlays.BeatmapSet
 {
     public class SpotlightBeatmapBadge : BeatmapBadge
diff --git a/osu.Game/Overlays/BeatmapSet/SuccessRate.cs b/osu.Game/Overlays/BeatmapSet/SuccessRate.cs
index fed3d7ddaa..cbcef9fcec 100644
--- a/osu.Game/Overlays/BeatmapSet/SuccessRate.cs
+++ b/osu.Game/Overlays/BeatmapSet/SuccessRate.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.LocalisationExtensions;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Overlays/BeatmapSetOverlay.cs b/osu.Game/Overlays/BeatmapSetOverlay.cs
index bd63c997df..823d0023cf 100644
--- a/osu.Game/Overlays/BeatmapSetOverlay.cs
+++ b/osu.Game/Overlays/BeatmapSetOverlay.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.
 
+#nullable disable
+
 using System.Linq;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Overlays/BreadcrumbControlOverlayHeader.cs b/osu.Game/Overlays/BreadcrumbControlOverlayHeader.cs
index 0d383c374f..5b83f0e62e 100644
--- a/osu.Game/Overlays/BreadcrumbControlOverlayHeader.cs
+++ b/osu.Game/Overlays/BreadcrumbControlOverlayHeader.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.UserInterface;
diff --git a/osu.Game/Overlays/Changelog/ChangelogBuild.cs b/osu.Game/Overlays/Changelog/ChangelogBuild.cs
index c65eefdee4..575f1a398a 100644
--- a/osu.Game/Overlays/Changelog/ChangelogBuild.cs
+++ b/osu.Game/Overlays/Changelog/ChangelogBuild.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Sprites;
diff --git a/osu.Game/Overlays/Changelog/ChangelogContent.cs b/osu.Game/Overlays/Changelog/ChangelogContent.cs
index 49dd9bb835..1e49efb10e 100644
--- a/osu.Game/Overlays/Changelog/ChangelogContent.cs
+++ b/osu.Game/Overlays/Changelog/ChangelogContent.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Online.API.Requests.Responses;
diff --git a/osu.Game/Overlays/Changelog/ChangelogEntry.cs b/osu.Game/Overlays/Changelog/ChangelogEntry.cs
index da062ca617..fdeba3f304 100644
--- a/osu.Game/Overlays/Changelog/ChangelogEntry.cs
+++ b/osu.Game/Overlays/Changelog/ChangelogEntry.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.
 
+#nullable disable
+
 using System;
 using System.Net;
 using System.Text.RegularExpressions;
diff --git a/osu.Game/Overlays/Changelog/ChangelogHeader.cs b/osu.Game/Overlays/Changelog/ChangelogHeader.cs
index 49a33ee5d6..6ce6b82c8f 100644
--- a/osu.Game/Overlays/Changelog/ChangelogHeader.cs
+++ b/osu.Game/Overlays/Changelog/ChangelogHeader.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Overlays/Changelog/ChangelogListing.cs b/osu.Game/Overlays/Changelog/ChangelogListing.cs
index 9b74a8da6d..e848f26587 100644
--- a/osu.Game/Overlays/Changelog/ChangelogListing.cs
+++ b/osu.Game/Overlays/Changelog/ChangelogListing.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Overlays/Changelog/ChangelogSingleBuild.cs b/osu.Game/Overlays/Changelog/ChangelogSingleBuild.cs
index 93486274fc..e4f240f0e7 100644
--- a/osu.Game/Overlays/Changelog/ChangelogSingleBuild.cs
+++ b/osu.Game/Overlays/Changelog/ChangelogSingleBuild.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using System.Threading;
diff --git a/osu.Game/Overlays/Changelog/ChangelogSupporterPromo.cs b/osu.Game/Overlays/Changelog/ChangelogSupporterPromo.cs
index e84eee15be..d84ed3c807 100644
--- a/osu.Game/Overlays/Changelog/ChangelogSupporterPromo.cs
+++ b/osu.Game/Overlays/Changelog/ChangelogSupporterPromo.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.Color4Extensions;
diff --git a/osu.Game/Overlays/Changelog/ChangelogUpdateStreamControl.cs b/osu.Game/Overlays/Changelog/ChangelogUpdateStreamControl.cs
index aa36a5c8fd..1db2d2f172 100644
--- a/osu.Game/Overlays/Changelog/ChangelogUpdateStreamControl.cs
+++ b/osu.Game/Overlays/Changelog/ChangelogUpdateStreamControl.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.
 
+#nullable disable
+
 using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Overlays.Changelog
diff --git a/osu.Game/Overlays/Changelog/ChangelogUpdateStreamItem.cs b/osu.Game/Overlays/Changelog/ChangelogUpdateStreamItem.cs
index cb144defbf..974b283ccf 100644
--- a/osu.Game/Overlays/Changelog/ChangelogUpdateStreamItem.cs
+++ b/osu.Game/Overlays/Changelog/ChangelogUpdateStreamItem.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.
 
+#nullable disable
+
 using Humanizer;
 using osu.Framework.Localisation;
 using osu.Game.Graphics;
diff --git a/osu.Game/Overlays/ChangelogOverlay.cs b/osu.Game/Overlays/ChangelogOverlay.cs
index ab97ae950d..7e0d5e9432 100644
--- a/osu.Game/Overlays/ChangelogOverlay.cs
+++ b/osu.Game/Overlays/ChangelogOverlay.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Threading;
diff --git a/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs b/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs
index 47a2d234d1..b3814ca90c 100644
--- a/osu.Game/Overlays/Chat/ChannelList/ChannelList.cs
+++ b/osu.Game/Overlays/Chat/ChannelList/ChannelList.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 enable
-
 using System;
 using System.Linq;
 using System.Collections.Generic;
diff --git a/osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs b/osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs
index 9ab0c2792a..c18e9e11fa 100644
--- a/osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs
+++ b/osu.Game/Overlays/Chat/ChannelList/ChannelListItem.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 enable
-
 using System;
 using System.Linq;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Overlays/Chat/ChannelList/ChannelListItemCloseButton.cs b/osu.Game/Overlays/Chat/ChannelList/ChannelListItemCloseButton.cs
index 65b9c4a79b..46d70b2d67 100644
--- a/osu.Game/Overlays/Chat/ChannelList/ChannelListItemCloseButton.cs
+++ b/osu.Game/Overlays/Chat/ChannelList/ChannelListItemCloseButton.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 enable
-
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Sprites;
diff --git a/osu.Game/Overlays/Chat/ChannelList/ChannelListItemMentionPill.cs b/osu.Game/Overlays/Chat/ChannelList/ChannelListItemMentionPill.cs
index 5018c8cd64..2ead841f58 100644
--- a/osu.Game/Overlays/Chat/ChannelList/ChannelListItemMentionPill.cs
+++ b/osu.Game/Overlays/Chat/ChannelList/ChannelListItemMentionPill.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 enable
-
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Overlays/Chat/ChannelScrollContainer.cs b/osu.Game/Overlays/Chat/ChannelScrollContainer.cs
index 139c091f03..dee7730e2c 100644
--- a/osu.Game/Overlays/Chat/ChannelScrollContainer.cs
+++ b/osu.Game/Overlays/Chat/ChannelScrollContainer.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Game.Graphics.Containers;
 
diff --git a/osu.Game/Overlays/Chat/ChatLine.cs b/osu.Game/Overlays/Chat/ChatLine.cs
index 56e39f212d..5961298485 100644
--- a/osu.Game/Overlays/Chat/ChatLine.cs
+++ b/osu.Game/Overlays/Chat/ChatLine.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 enable
-
 using System;
 using System.Linq;
 using System.Collections.Generic;
diff --git a/osu.Game/Overlays/Chat/ChatOverlayTopBar.cs b/osu.Game/Overlays/Chat/ChatOverlayTopBar.cs
index 79f22b51f7..ad9ae412da 100644
--- a/osu.Game/Overlays/Chat/ChatOverlayTopBar.cs
+++ b/osu.Game/Overlays/Chat/ChatOverlayTopBar.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 enable
-
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Overlays/Chat/ChatTextBar.cs b/osu.Game/Overlays/Chat/ChatTextBar.cs
index 5100959eeb..73314c2e44 100644
--- a/osu.Game/Overlays/Chat/ChatTextBar.cs
+++ b/osu.Game/Overlays/Chat/ChatTextBar.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 enable
-
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Overlays/Chat/ChatTextBox.cs b/osu.Game/Overlays/Chat/ChatTextBox.cs
index 1ee0e8445f..ae8816b009 100644
--- a/osu.Game/Overlays/Chat/ChatTextBox.cs
+++ b/osu.Game/Overlays/Chat/ChatTextBox.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 enable
-
 using osu.Framework.Bindables;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Resources.Localisation.Web;
diff --git a/osu.Game/Overlays/Chat/DaySeparator.cs b/osu.Game/Overlays/Chat/DaySeparator.cs
index 9ae35b0c38..c7961d1a39 100644
--- a/osu.Game/Overlays/Chat/DaySeparator.cs
+++ b/osu.Game/Overlays/Chat/DaySeparator.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 enable
-
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Overlays/Chat/DrawableChannel.cs b/osu.Game/Overlays/Chat/DrawableChannel.cs
index c3a341bca4..c05f456a96 100644
--- a/osu.Game/Overlays/Chat/DrawableChannel.cs
+++ b/osu.Game/Overlays/Chat/DrawableChannel.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Diagnostics;
diff --git a/osu.Game/Overlays/Chat/ExternalLinkDialog.cs b/osu.Game/Overlays/Chat/ExternalLinkDialog.cs
index dbae091fb0..f0d39346e0 100644
--- a/osu.Game/Overlays/Chat/ExternalLinkDialog.cs
+++ b/osu.Game/Overlays/Chat/ExternalLinkDialog.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Graphics.Sprites;
 using osu.Game.Overlays.Dialog;
diff --git a/osu.Game/Overlays/Chat/Listing/ChannelListing.cs b/osu.Game/Overlays/Chat/Listing/ChannelListing.cs
index 8a5bc18cbf..44255eb754 100644
--- a/osu.Game/Overlays/Chat/Listing/ChannelListing.cs
+++ b/osu.Game/Overlays/Chat/Listing/ChannelListing.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 enable
-
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Overlays/Chat/Listing/ChannelListingItem.cs b/osu.Game/Overlays/Chat/Listing/ChannelListingItem.cs
index 2a21d30a4a..ffeab3b380 100644
--- a/osu.Game/Overlays/Chat/Listing/ChannelListingItem.cs
+++ b/osu.Game/Overlays/Chat/Listing/ChannelListingItem.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 enable
-
 using System;
 using System.Collections.Generic;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Overlays/ChatOverlay.cs b/osu.Game/Overlays/ChatOverlay.cs
index f04bf76c18..81a408598b 100644
--- a/osu.Game/Overlays/ChatOverlay.cs
+++ b/osu.Game/Overlays/ChatOverlay.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 enable
-
 using System.Collections.Generic;
 using System.Collections.Specialized;
 using System.Diagnostics;
diff --git a/osu.Game/Overlays/Comments/Buttons/ChevronButton.cs b/osu.Game/Overlays/Comments/Buttons/ChevronButton.cs
index 48f34e8f59..46a455cbb3 100644
--- a/osu.Game/Overlays/Comments/Buttons/ChevronButton.cs
+++ b/osu.Game/Overlays/Comments/Buttons/ChevronButton.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Game.Graphics.Containers;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Overlays/Comments/Buttons/CommentRepliesButton.cs b/osu.Game/Overlays/Comments/Buttons/CommentRepliesButton.cs
index 2f7f16dd6f..d24a0cd27b 100644
--- a/osu.Game/Overlays/Comments/Buttons/CommentRepliesButton.cs
+++ b/osu.Game/Overlays/Comments/Buttons/CommentRepliesButton.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Overlays/Comments/Buttons/LoadRepliesButton.cs b/osu.Game/Overlays/Comments/Buttons/LoadRepliesButton.cs
index 4bb5b9d66d..42aca2f4a3 100644
--- a/osu.Game/Overlays/Comments/Buttons/LoadRepliesButton.cs
+++ b/osu.Game/Overlays/Comments/Buttons/LoadRepliesButton.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Resources.Localisation.Web;
diff --git a/osu.Game/Overlays/Comments/Buttons/ShowMoreRepliesButton.cs b/osu.Game/Overlays/Comments/Buttons/ShowMoreRepliesButton.cs
index 4908e29b7d..6f3841d52e 100644
--- a/osu.Game/Overlays/Comments/Buttons/ShowMoreRepliesButton.cs
+++ b/osu.Game/Overlays/Comments/Buttons/ShowMoreRepliesButton.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Game.Graphics;
 using osu.Game.Graphics.UserInterface;
diff --git a/osu.Game/Overlays/Comments/Buttons/ShowRepliesButton.cs b/osu.Game/Overlays/Comments/Buttons/ShowRepliesButton.cs
index 04e7e25cc5..845a630d97 100644
--- a/osu.Game/Overlays/Comments/Buttons/ShowRepliesButton.cs
+++ b/osu.Game/Overlays/Comments/Buttons/ShowRepliesButton.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.
 
+#nullable disable
+
 using Humanizer;
 using osu.Framework.Bindables;
 using osu.Framework.Input.Events;
diff --git a/osu.Game/Overlays/Comments/CancellableCommentEditor.cs b/osu.Game/Overlays/Comments/CancellableCommentEditor.cs
index 74c221bd82..853171ea4a 100644
--- a/osu.Game/Overlays/Comments/CancellableCommentEditor.cs
+++ b/osu.Game/Overlays/Comments/CancellableCommentEditor.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Overlays/Comments/CommentEditor.cs b/osu.Game/Overlays/Comments/CommentEditor.cs
index 3ff4cfad4a..2e8080ba43 100644
--- a/osu.Game/Overlays/Comments/CommentEditor.cs
+++ b/osu.Game/Overlays/Comments/CommentEditor.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Overlays/Comments/CommentMarkdownContainer.cs b/osu.Game/Overlays/Comments/CommentMarkdownContainer.cs
index 3971a61363..e94a1b0147 100644
--- a/osu.Game/Overlays/Comments/CommentMarkdownContainer.cs
+++ b/osu.Game/Overlays/Comments/CommentMarkdownContainer.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.
 
+#nullable disable
+
 using Markdig.Syntax;
 using Markdig.Syntax.Inlines;
 using osu.Framework.Graphics.Containers.Markdown;
diff --git a/osu.Game/Overlays/Comments/CommentsContainer.cs b/osu.Game/Overlays/Comments/CommentsContainer.cs
index a28b13fc12..4ab6f4f88d 100644
--- a/osu.Game/Overlays/Comments/CommentsContainer.cs
+++ b/osu.Game/Overlays/Comments/CommentsContainer.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Online.API;
diff --git a/osu.Game/Overlays/Comments/CommentsHeader.cs b/osu.Game/Overlays/Comments/CommentsHeader.cs
index e7d9e72dcc..5684841c37 100644
--- a/osu.Game/Overlays/Comments/CommentsHeader.cs
+++ b/osu.Game/Overlays/Comments/CommentsHeader.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
 using osu.Framework.Audio.Sample;
diff --git a/osu.Game/Overlays/Comments/CommentsShowMoreButton.cs b/osu.Game/Overlays/Comments/CommentsShowMoreButton.cs
index b1ca39c3bf..84d1f67486 100644
--- a/osu.Game/Overlays/Comments/CommentsShowMoreButton.cs
+++ b/osu.Game/Overlays/Comments/CommentsShowMoreButton.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.
 
+#nullable disable
+
 using osu.Framework.Bindables;
 using osu.Framework.Extensions.LocalisationExtensions;
 using osu.Framework.Localisation;
diff --git a/osu.Game/Overlays/Comments/DeletedCommentsCounter.cs b/osu.Game/Overlays/Comments/DeletedCommentsCounter.cs
index 8c40d79f7a..2c7ed4f5b3 100644
--- a/osu.Game/Overlays/Comments/DeletedCommentsCounter.cs
+++ b/osu.Game/Overlays/Comments/DeletedCommentsCounter.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.
 
+#nullable disable
+
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics;
 using osu.Game.Graphics;
diff --git a/osu.Game/Overlays/Comments/DrawableComment.cs b/osu.Game/Overlays/Comments/DrawableComment.cs
index 3ec91c8e63..296320ec1b 100644
--- a/osu.Game/Overlays/Comments/DrawableComment.cs
+++ b/osu.Game/Overlays/Comments/DrawableComment.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.
 
+#nullable disable
+
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics;
 using osu.Game.Graphics;
diff --git a/osu.Game/Overlays/Comments/HeaderButton.cs b/osu.Game/Overlays/Comments/HeaderButton.cs
index 65172aa57c..186b892c4d 100644
--- a/osu.Game/Overlays/Comments/HeaderButton.cs
+++ b/osu.Game/Overlays/Comments/HeaderButton.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Overlays/Comments/TotalCommentsCounter.cs b/osu.Game/Overlays/Comments/TotalCommentsCounter.cs
index 221a745189..218d8383f6 100644
--- a/osu.Game/Overlays/Comments/TotalCommentsCounter.cs
+++ b/osu.Game/Overlays/Comments/TotalCommentsCounter.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.
 
+#nullable disable
+
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Shapes;
diff --git a/osu.Game/Overlays/Comments/VotePill.cs b/osu.Game/Overlays/Comments/VotePill.cs
index 093cdce66e..7a4b83cc48 100644
--- a/osu.Game/Overlays/Comments/VotePill.cs
+++ b/osu.Game/Overlays/Comments/VotePill.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.
 
+#nullable disable
+
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics;
 using osu.Game.Graphics;
diff --git a/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs b/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs
index 23f67a06cb..aae4932c22 100644
--- a/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.cs
+++ b/osu.Game/Overlays/Dashboard/CurrentlyPlayingDisplay.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Collections.Specialized;
 using System.Diagnostics;
diff --git a/osu.Game/Overlays/Dashboard/DashboardOverlayHeader.cs b/osu.Game/Overlays/Dashboard/DashboardOverlayHeader.cs
index 2c8db14950..370181a0cb 100644
--- a/osu.Game/Overlays/Dashboard/DashboardOverlayHeader.cs
+++ b/osu.Game/Overlays/Dashboard/DashboardOverlayHeader.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.
 
+#nullable disable
+
 using System.ComponentModel;
 using osu.Framework.Localisation;
 using osu.Game.Localisation;
diff --git a/osu.Game/Overlays/Dashboard/Friends/FriendDisplay.cs b/osu.Game/Overlays/Dashboard/Friends/FriendDisplay.cs
index 765f037d70..bfeaf50b53 100644
--- a/osu.Game/Overlays/Dashboard/Friends/FriendDisplay.cs
+++ b/osu.Game/Overlays/Dashboard/Friends/FriendDisplay.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using System.Threading;
diff --git a/osu.Game/Overlays/Dashboard/Friends/FriendOnlineStreamControl.cs b/osu.Game/Overlays/Dashboard/Friends/FriendOnlineStreamControl.cs
index 7275cdff7c..fc6158e747 100644
--- a/osu.Game/Overlays/Dashboard/Friends/FriendOnlineStreamControl.cs
+++ b/osu.Game/Overlays/Dashboard/Friends/FriendOnlineStreamControl.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using osu.Game.Online.API.Requests.Responses;
diff --git a/osu.Game/Overlays/Dashboard/Friends/FriendStream.cs b/osu.Game/Overlays/Dashboard/Friends/FriendStream.cs
index 4abece9a8d..3bb42ec953 100644
--- a/osu.Game/Overlays/Dashboard/Friends/FriendStream.cs
+++ b/osu.Game/Overlays/Dashboard/Friends/FriendStream.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.
 
+#nullable disable
+
 namespace osu.Game.Overlays.Dashboard.Friends
 {
     public class FriendStream
diff --git a/osu.Game/Overlays/Dashboard/Friends/FriendsOnlineStatusItem.cs b/osu.Game/Overlays/Dashboard/Friends/FriendsOnlineStatusItem.cs
index 11dcb93e6f..7e2ec3f442 100644
--- a/osu.Game/Overlays/Dashboard/Friends/FriendsOnlineStatusItem.cs
+++ b/osu.Game/Overlays/Dashboard/Friends/FriendsOnlineStatusItem.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Extensions;
 using osu.Framework.Localisation;
diff --git a/osu.Game/Overlays/Dashboard/Friends/OnlineStatus.cs b/osu.Game/Overlays/Dashboard/Friends/OnlineStatus.cs
index 853c94d8ae..21bc5b8203 100644
--- a/osu.Game/Overlays/Dashboard/Friends/OnlineStatus.cs
+++ b/osu.Game/Overlays/Dashboard/Friends/OnlineStatus.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.
 
+#nullable disable
+
 using osu.Framework.Localisation;
 using osu.Game.Resources.Localisation.Web;
 
diff --git a/osu.Game/Overlays/Dashboard/Friends/UserListToolbar.cs b/osu.Game/Overlays/Dashboard/Friends/UserListToolbar.cs
index fb4b938183..25ddb9e704 100644
--- a/osu.Game/Overlays/Dashboard/Friends/UserListToolbar.cs
+++ b/osu.Game/Overlays/Dashboard/Friends/UserListToolbar.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osuTK;
diff --git a/osu.Game/Overlays/Dashboard/Friends/UserSortTabControl.cs b/osu.Game/Overlays/Dashboard/Friends/UserSortTabControl.cs
index 7fee5f4668..466e36c1a9 100644
--- a/osu.Game/Overlays/Dashboard/Friends/UserSortTabControl.cs
+++ b/osu.Game/Overlays/Dashboard/Friends/UserSortTabControl.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.
 
+#nullable disable
+
 using System.ComponentModel;
 using osu.Framework.Localisation;
 using osu.Game.Resources.Localisation.Web;
diff --git a/osu.Game/Overlays/Dashboard/Home/DashboardBeatmapListing.cs b/osu.Game/Overlays/Dashboard/Home/DashboardBeatmapListing.cs
index c781aa0cfb..e9c7af3339 100644
--- a/osu.Game/Overlays/Dashboard/Home/DashboardBeatmapListing.cs
+++ b/osu.Game/Overlays/Dashboard/Home/DashboardBeatmapListing.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Overlays/Dashboard/Home/DashboardBeatmapPanel.cs b/osu.Game/Overlays/Dashboard/Home/DashboardBeatmapPanel.cs
index 9276e6ce80..1e4ba2ef05 100644
--- a/osu.Game/Overlays/Dashboard/Home/DashboardBeatmapPanel.cs
+++ b/osu.Game/Overlays/Dashboard/Home/DashboardBeatmapPanel.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Overlays/Dashboard/Home/DashboardNewBeatmapPanel.cs b/osu.Game/Overlays/Dashboard/Home/DashboardNewBeatmapPanel.cs
index 249b355be3..258fd56dd7 100644
--- a/osu.Game/Overlays/Dashboard/Home/DashboardNewBeatmapPanel.cs
+++ b/osu.Game/Overlays/Dashboard/Home/DashboardNewBeatmapPanel.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Graphics;
 using osu.Game.Graphics;
diff --git a/osu.Game/Overlays/Dashboard/Home/DashboardPopularBeatmapPanel.cs b/osu.Game/Overlays/Dashboard/Home/DashboardPopularBeatmapPanel.cs
index 4e50cce890..743bd5440f 100644
--- a/osu.Game/Overlays/Dashboard/Home/DashboardPopularBeatmapPanel.cs
+++ b/osu.Game/Overlays/Dashboard/Home/DashboardPopularBeatmapPanel.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Sprites;
diff --git a/osu.Game/Overlays/Dashboard/Home/DrawableBeatmapList.cs b/osu.Game/Overlays/Dashboard/Home/DrawableBeatmapList.cs
index 382bc00b1d..8f140facef 100644
--- a/osu.Game/Overlays/Dashboard/Home/DrawableBeatmapList.cs
+++ b/osu.Game/Overlays/Dashboard/Home/DrawableBeatmapList.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Overlays/Dashboard/Home/DrawableNewBeatmapList.cs b/osu.Game/Overlays/Dashboard/Home/DrawableNewBeatmapList.cs
index 331fff0aea..c6917b41fb 100644
--- a/osu.Game/Overlays/Dashboard/Home/DrawableNewBeatmapList.cs
+++ b/osu.Game/Overlays/Dashboard/Home/DrawableNewBeatmapList.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Framework.Localisation;
 using osu.Game.Online.API.Requests.Responses;
diff --git a/osu.Game/Overlays/Dashboard/Home/DrawablePopularBeatmapList.cs b/osu.Game/Overlays/Dashboard/Home/DrawablePopularBeatmapList.cs
index 154813dea1..9ff12623e0 100644
--- a/osu.Game/Overlays/Dashboard/Home/DrawablePopularBeatmapList.cs
+++ b/osu.Game/Overlays/Dashboard/Home/DrawablePopularBeatmapList.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Framework.Localisation;
 using osu.Game.Online.API.Requests.Responses;
diff --git a/osu.Game/Overlays/Dashboard/Home/HomePanel.cs b/osu.Game/Overlays/Dashboard/Home/HomePanel.cs
index ce053cd4ec..099e16cd55 100644
--- a/osu.Game/Overlays/Dashboard/Home/HomePanel.cs
+++ b/osu.Game/Overlays/Dashboard/Home/HomePanel.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Overlays/Dashboard/Home/News/FeaturedNewsItemPanel.cs b/osu.Game/Overlays/Dashboard/Home/News/FeaturedNewsItemPanel.cs
index 0d166eb858..8f5c942b6e 100644
--- a/osu.Game/Overlays/Dashboard/Home/News/FeaturedNewsItemPanel.cs
+++ b/osu.Game/Overlays/Dashboard/Home/News/FeaturedNewsItemPanel.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Overlays/Dashboard/Home/News/NewsGroupItem.cs b/osu.Game/Overlays/Dashboard/Home/News/NewsGroupItem.cs
index 77cfbc90b0..9b66e5524b 100644
--- a/osu.Game/Overlays/Dashboard/Home/News/NewsGroupItem.cs
+++ b/osu.Game/Overlays/Dashboard/Home/News/NewsGroupItem.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Overlays/Dashboard/Home/News/NewsItemGroupPanel.cs b/osu.Game/Overlays/Dashboard/Home/News/NewsItemGroupPanel.cs
index c1d5a87ef5..4456a292a5 100644
--- a/osu.Game/Overlays/Dashboard/Home/News/NewsItemGroupPanel.cs
+++ b/osu.Game/Overlays/Dashboard/Home/News/NewsItemGroupPanel.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Overlays/Dashboard/Home/News/NewsTitleLink.cs b/osu.Game/Overlays/Dashboard/Home/News/NewsTitleLink.cs
index d6a3a69fe0..e384c3e6e5 100644
--- a/osu.Game/Overlays/Dashboard/Home/News/NewsTitleLink.cs
+++ b/osu.Game/Overlays/Dashboard/Home/News/NewsTitleLink.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Overlays/Dashboard/Home/News/ShowMoreNewsPanel.cs b/osu.Game/Overlays/Dashboard/Home/News/ShowMoreNewsPanel.cs
index f6e966957e..9b1d77a8c2 100644
--- a/osu.Game/Overlays/Dashboard/Home/News/ShowMoreNewsPanel.cs
+++ b/osu.Game/Overlays/Dashboard/Home/News/ShowMoreNewsPanel.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Overlays/DashboardOverlay.cs b/osu.Game/Overlays/DashboardOverlay.cs
index 79d972bdcc..d919022dbb 100644
--- a/osu.Game/Overlays/DashboardOverlay.cs
+++ b/osu.Game/Overlays/DashboardOverlay.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.
 
+#nullable disable
+
 using System;
 using osu.Game.Overlays.Dashboard;
 using osu.Game.Overlays.Dashboard.Friends;
diff --git a/osu.Game/Overlays/Dialog/ConfirmDialog.cs b/osu.Game/Overlays/Dialog/ConfirmDialog.cs
index 58ce84e13a..8be865ee16 100644
--- a/osu.Game/Overlays/Dialog/ConfirmDialog.cs
+++ b/osu.Game/Overlays/Dialog/ConfirmDialog.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Graphics.Sprites;
 using osu.Game.Resources.Localisation.Web;
diff --git a/osu.Game/Overlays/Dialog/PopupDialog.cs b/osu.Game/Overlays/Dialog/PopupDialog.cs
index 5959fe656c..864120cc49 100644
--- a/osu.Game/Overlays/Dialog/PopupDialog.cs
+++ b/osu.Game/Overlays/Dialog/PopupDialog.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using osu.Framework.Extensions.Color4Extensions;
diff --git a/osu.Game/Overlays/Dialog/PopupDialogButton.cs b/osu.Game/Overlays/Dialog/PopupDialogButton.cs
index 9ee1018651..e1cc31da82 100644
--- a/osu.Game/Overlays/Dialog/PopupDialogButton.cs
+++ b/osu.Game/Overlays/Dialog/PopupDialogButton.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.
 
+#nullable disable
+
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Game.Graphics.UserInterface;
 
diff --git a/osu.Game/Overlays/Dialog/PopupDialogCancelButton.cs b/osu.Game/Overlays/Dialog/PopupDialogCancelButton.cs
index 186099ce23..f23a40b7ab 100644
--- a/osu.Game/Overlays/Dialog/PopupDialogCancelButton.cs
+++ b/osu.Game/Overlays/Dialog/PopupDialogCancelButton.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Game.Graphics;
 using osu.Game.Graphics.UserInterface;
diff --git a/osu.Game/Overlays/Dialog/PopupDialogDangerousButton.cs b/osu.Game/Overlays/Dialog/PopupDialogDangerousButton.cs
index d145a1c7da..bd7cb4ed33 100644
--- a/osu.Game/Overlays/Dialog/PopupDialogDangerousButton.cs
+++ b/osu.Game/Overlays/Dialog/PopupDialogDangerousButton.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
 using osu.Framework.Audio.Sample;
diff --git a/osu.Game/Overlays/Dialog/PopupDialogOkButton.cs b/osu.Game/Overlays/Dialog/PopupDialogOkButton.cs
index 1ac8dd0db6..3496627c89 100644
--- a/osu.Game/Overlays/Dialog/PopupDialogOkButton.cs
+++ b/osu.Game/Overlays/Dialog/PopupDialogOkButton.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Game.Graphics;
 using osu.Game.Graphics.UserInterface;
diff --git a/osu.Game/Overlays/DialogOverlay.cs b/osu.Game/Overlays/DialogOverlay.cs
index 5a69562e82..a07cf1608d 100644
--- a/osu.Game/Overlays/DialogOverlay.cs
+++ b/osu.Game/Overlays/DialogOverlay.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Overlays.Dialog;
diff --git a/osu.Game/Overlays/FirstRunSetup/FirstRunSetupScreen.cs b/osu.Game/Overlays/FirstRunSetup/FirstRunSetupScreen.cs
index b043f05bd8..cef1f1c869 100644
--- a/osu.Game/Overlays/FirstRunSetup/FirstRunSetupScreen.cs
+++ b/osu.Game/Overlays/FirstRunSetup/FirstRunSetupScreen.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Extensions;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Overlays/FirstRunSetup/ProgressRoundedButton.cs b/osu.Game/Overlays/FirstRunSetup/ProgressRoundedButton.cs
index ee2db1f3d4..95ebb256c4 100644
--- a/osu.Game/Overlays/FirstRunSetup/ProgressRoundedButton.cs
+++ b/osu.Game/Overlays/FirstRunSetup/ProgressRoundedButton.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.
 
-#nullable enable
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Overlays/FirstRunSetup/ScreenBeatmaps.cs b/osu.Game/Overlays/FirstRunSetup/ScreenBeatmaps.cs
index ddcee7c040..82f49e0aef 100644
--- a/osu.Game/Overlays/FirstRunSetup/ScreenBeatmaps.cs
+++ b/osu.Game/Overlays/FirstRunSetup/ScreenBeatmaps.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 enable
-
 using System;
 using System.Linq;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Overlays/FirstRunSetup/ScreenBehaviour.cs b/osu.Game/Overlays/FirstRunSetup/ScreenBehaviour.cs
index 1a88e6a842..9573b4859f 100644
--- a/osu.Game/Overlays/FirstRunSetup/ScreenBehaviour.cs
+++ b/osu.Game/Overlays/FirstRunSetup/ScreenBehaviour.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.
 
+#nullable disable
+
 using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Overlays/FirstRunSetup/ScreenImportFromStable.cs b/osu.Game/Overlays/FirstRunSetup/ScreenImportFromStable.cs
index 62b517d982..43d68653ad 100644
--- a/osu.Game/Overlays/FirstRunSetup/ScreenImportFromStable.cs
+++ b/osu.Game/Overlays/FirstRunSetup/ScreenImportFromStable.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 enable
-
 using System;
 using System.Collections.Generic;
 using System.IO;
diff --git a/osu.Game/Overlays/FirstRunSetup/ScreenUIScale.cs b/osu.Game/Overlays/FirstRunSetup/ScreenUIScale.cs
index f09a26a527..58bfced3ed 100644
--- a/osu.Game/Overlays/FirstRunSetup/ScreenUIScale.cs
+++ b/osu.Game/Overlays/FirstRunSetup/ScreenUIScale.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Overlays/FirstRunSetup/ScreenWelcome.cs b/osu.Game/Overlays/FirstRunSetup/ScreenWelcome.cs
index 420d630857..20ff8f21c8 100644
--- a/osu.Game/Overlays/FirstRunSetup/ScreenWelcome.cs
+++ b/osu.Game/Overlays/FirstRunSetup/ScreenWelcome.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Localisation;
diff --git a/osu.Game/Overlays/FirstRunSetupOverlay.cs b/osu.Game/Overlays/FirstRunSetupOverlay.cs
index a5bece0832..8c9ca7e35b 100644
--- a/osu.Game/Overlays/FirstRunSetupOverlay.cs
+++ b/osu.Game/Overlays/FirstRunSetupOverlay.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 enable
-
 using System;
 using System.Collections.Generic;
 using System.Diagnostics;
diff --git a/osu.Game/Overlays/FullscreenOverlay.cs b/osu.Game/Overlays/FullscreenOverlay.cs
index 58c41c4a4b..63a9ebc750 100644
--- a/osu.Game/Overlays/FullscreenOverlay.cs
+++ b/osu.Game/Overlays/FullscreenOverlay.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.
 
+#nullable disable
+
 using JetBrains.Annotations;
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.Color4Extensions;
diff --git a/osu.Game/Overlays/HoldToConfirmOverlay.cs b/osu.Game/Overlays/HoldToConfirmOverlay.cs
index cb6275bd7c..dd03206eab 100644
--- a/osu.Game/Overlays/HoldToConfirmOverlay.cs
+++ b/osu.Game/Overlays/HoldToConfirmOverlay.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Overlays/IDialogOverlay.cs b/osu.Game/Overlays/IDialogOverlay.cs
index 1c6a84cd64..6ddb71d5e3 100644
--- a/osu.Game/Overlays/IDialogOverlay.cs
+++ b/osu.Game/Overlays/IDialogOverlay.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 enable
-
 using osu.Framework.Allocation;
 using osu.Game.Overlays.Dialog;
 
diff --git a/osu.Game/Overlays/INamedOverlayComponent.cs b/osu.Game/Overlays/INamedOverlayComponent.cs
index ca0aea041e..e9d01a55e3 100644
--- a/osu.Game/Overlays/INamedOverlayComponent.cs
+++ b/osu.Game/Overlays/INamedOverlayComponent.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.
 
+#nullable disable
+
 using osu.Framework.Localisation;
 
 namespace osu.Game.Overlays
diff --git a/osu.Game/Overlays/INotificationOverlay.cs b/osu.Game/Overlays/INotificationOverlay.cs
index 1d8e33ea3a..b9ac466229 100644
--- a/osu.Game/Overlays/INotificationOverlay.cs
+++ b/osu.Game/Overlays/INotificationOverlay.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Game.Overlays.Notifications;
diff --git a/osu.Game/Overlays/IOverlayManager.cs b/osu.Game/Overlays/IOverlayManager.cs
index 940ee2d8db..0318b2b3a0 100644
--- a/osu.Game/Overlays/IOverlayManager.cs
+++ b/osu.Game/Overlays/IOverlayManager.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Overlays/Login/LoginForm.cs b/osu.Game/Overlays/Login/LoginForm.cs
index 502f0cd22e..08522b2921 100644
--- a/osu.Game/Overlays/Login/LoginForm.cs
+++ b/osu.Game/Overlays/Login/LoginForm.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.LocalisationExtensions;
diff --git a/osu.Game/Overlays/Login/LoginPanel.cs b/osu.Game/Overlays/Login/LoginPanel.cs
index 481abd48ab..1d8926b991 100644
--- a/osu.Game/Overlays/Login/LoginPanel.cs
+++ b/osu.Game/Overlays/Login/LoginPanel.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Overlays/Login/UserAction.cs b/osu.Game/Overlays/Login/UserAction.cs
index d216670a28..7a18e38109 100644
--- a/osu.Game/Overlays/Login/UserAction.cs
+++ b/osu.Game/Overlays/Login/UserAction.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.
 
+#nullable disable
+
 using System.ComponentModel;
 using osu.Framework.Localisation;
 using osu.Game.Resources.Localisation.Web;
@@ -21,4 +23,4 @@ namespace osu.Game.Overlays.Login
         [Description(@"Sign out")]
         SignOut,
     }
-}
\ No newline at end of file
+}
diff --git a/osu.Game/Overlays/Login/UserDropdown.cs b/osu.Game/Overlays/Login/UserDropdown.cs
index 5c3a41aec9..73ccfb3443 100644
--- a/osu.Game/Overlays/Login/UserDropdown.cs
+++ b/osu.Game/Overlays/Login/UserDropdown.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Overlays/LoginOverlay.cs b/osu.Game/Overlays/LoginOverlay.cs
index 9b2d7ca1ee..2362b2ad88 100644
--- a/osu.Game/Overlays/LoginOverlay.cs
+++ b/osu.Game/Overlays/LoginOverlay.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Overlays/MedalOverlay.cs b/osu.Game/Overlays/MedalOverlay.cs
index e15625a4b3..9b856014f9 100644
--- a/osu.Game/Overlays/MedalOverlay.cs
+++ b/osu.Game/Overlays/MedalOverlay.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.
 
+#nullable disable
+
 using osuTK;
 using osuTK.Graphics;
 using osu.Framework.Extensions.Color4Extensions;
diff --git a/osu.Game/Overlays/MedalSplash/DrawableMedal.cs b/osu.Game/Overlays/MedalSplash/DrawableMedal.cs
index 3cf7befb45..53e8452dd1 100644
--- a/osu.Game/Overlays/MedalSplash/DrawableMedal.cs
+++ b/osu.Game/Overlays/MedalSplash/DrawableMedal.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.
 
+#nullable disable
+
 using System;
 using osu.Framework;
 using osuTK;
diff --git a/osu.Game/Overlays/Mods/DeselectAllModsButton.cs b/osu.Game/Overlays/Mods/DeselectAllModsButton.cs
index 8288d34c95..61fca9e091 100644
--- a/osu.Game/Overlays/Mods/DeselectAllModsButton.cs
+++ b/osu.Game/Overlays/Mods/DeselectAllModsButton.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Overlays/Mods/DifficultyMultiplierDisplay.cs b/osu.Game/Overlays/Mods/DifficultyMultiplierDisplay.cs
index 4ccec0dd87..c8d55c213a 100644
--- a/osu.Game/Overlays/Mods/DifficultyMultiplierDisplay.cs
+++ b/osu.Game/Overlays/Mods/DifficultyMultiplierDisplay.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Extensions.LocalisationExtensions;
diff --git a/osu.Game/Overlays/Mods/IncompatibilityDisplayingModPanel.cs b/osu.Game/Overlays/Mods/IncompatibilityDisplayingModPanel.cs
index 34c4458a21..a6f412c00a 100644
--- a/osu.Game/Overlays/Mods/IncompatibilityDisplayingModPanel.cs
+++ b/osu.Game/Overlays/Mods/IncompatibilityDisplayingModPanel.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Overlays/Mods/IncompatibilityDisplayingTooltip.cs b/osu.Game/Overlays/Mods/IncompatibilityDisplayingTooltip.cs
index d8117c8f00..3f44e82d50 100644
--- a/osu.Game/Overlays/Mods/IncompatibilityDisplayingTooltip.cs
+++ b/osu.Game/Overlays/Mods/IncompatibilityDisplayingTooltip.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Overlays/Mods/ModButtonTooltip.cs b/osu.Game/Overlays/Mods/ModButtonTooltip.cs
index 2f50e38a5a..e19f24103f 100644
--- a/osu.Game/Overlays/Mods/ModButtonTooltip.cs
+++ b/osu.Game/Overlays/Mods/ModButtonTooltip.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Overlays/Mods/ModColumn.cs b/osu.Game/Overlays/Mods/ModColumn.cs
index 42f9daec4d..563e9a8d55 100644
--- a/osu.Game/Overlays/Mods/ModColumn.cs
+++ b/osu.Game/Overlays/Mods/ModColumn.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 enable
-
 using System;
 using System.Collections.Generic;
 using System.Diagnostics;
diff --git a/osu.Game/Overlays/Mods/ModPanel.cs b/osu.Game/Overlays/Mods/ModPanel.cs
index 358bdd3202..4d14a31189 100644
--- a/osu.Game/Overlays/Mods/ModPanel.cs
+++ b/osu.Game/Overlays/Mods/ModPanel.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 enable
-
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
diff --git a/osu.Game/Overlays/Mods/ModSelectOverlay.cs b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
index 4bad34d94f..ad02f079a5 100644
--- a/osu.Game/Overlays/Mods/ModSelectOverlay.cs
+++ b/osu.Game/Overlays/Mods/ModSelectOverlay.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 enable
-
 using System;
 using System.Collections.Generic;
 using System.Diagnostics;
diff --git a/osu.Game/Overlays/Mods/ModSettingsArea.cs b/osu.Game/Overlays/Mods/ModSettingsArea.cs
index f44e4bf07f..0932c2c832 100644
--- a/osu.Game/Overlays/Mods/ModSettingsArea.cs
+++ b/osu.Game/Overlays/Mods/ModSettingsArea.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Overlays/Mods/ModState.cs b/osu.Game/Overlays/Mods/ModState.cs
index 8fdd5db00b..79880b85a5 100644
--- a/osu.Game/Overlays/Mods/ModState.cs
+++ b/osu.Game/Overlays/Mods/ModState.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.
 
+#nullable disable
+
 using osu.Framework.Bindables;
 using osu.Game.Rulesets.Mods;
 
diff --git a/osu.Game/Overlays/Mods/SelectAllModsButton.cs b/osu.Game/Overlays/Mods/SelectAllModsButton.cs
index f7078b2fa5..fc24e99c7e 100644
--- a/osu.Game/Overlays/Mods/SelectAllModsButton.cs
+++ b/osu.Game/Overlays/Mods/SelectAllModsButton.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Overlays/Mods/ShearedOverlayContainer.cs b/osu.Game/Overlays/Mods/ShearedOverlayContainer.cs
index 92e88bfaaf..2585e44e05 100644
--- a/osu.Game/Overlays/Mods/ShearedOverlayContainer.cs
+++ b/osu.Game/Overlays/Mods/ShearedOverlayContainer.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Overlays/Mods/UserModSelectOverlay.cs b/osu.Game/Overlays/Mods/UserModSelectOverlay.cs
index 7100446730..b8f4b8a196 100644
--- a/osu.Game/Overlays/Mods/UserModSelectOverlay.cs
+++ b/osu.Game/Overlays/Mods/UserModSelectOverlay.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using JetBrains.Annotations;
diff --git a/osu.Game/Overlays/Music/CollectionDropdown.cs b/osu.Game/Overlays/Music/CollectionDropdown.cs
index 658eebe67b..c1ba16788e 100644
--- a/osu.Game/Overlays/Music/CollectionDropdown.cs
+++ b/osu.Game/Overlays/Music/CollectionDropdown.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.
 
+#nullable disable
+
 using osuTK;
 using osuTK.Graphics;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Overlays/Music/FilterControl.cs b/osu.Game/Overlays/Music/FilterControl.cs
index 46c66b4bae..eb12a62864 100644
--- a/osu.Game/Overlays/Music/FilterControl.cs
+++ b/osu.Game/Overlays/Music/FilterControl.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Graphics;
diff --git a/osu.Game/Overlays/Music/FilterCriteria.cs b/osu.Game/Overlays/Music/FilterCriteria.cs
index f15edff4d0..f435c4e6e4 100644
--- a/osu.Game/Overlays/Music/FilterCriteria.cs
+++ b/osu.Game/Overlays/Music/FilterCriteria.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.
 
+#nullable disable
+
 using JetBrains.Annotations;
 using osu.Game.Collections;
 
diff --git a/osu.Game/Overlays/Music/MusicKeyBindingHandler.cs b/osu.Game/Overlays/Music/MusicKeyBindingHandler.cs
index 6b33c9200e..8df465e075 100644
--- a/osu.Game/Overlays/Music/MusicKeyBindingHandler.cs
+++ b/osu.Game/Overlays/Music/MusicKeyBindingHandler.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Extensions.LocalisationExtensions;
diff --git a/osu.Game/Overlays/Music/Playlist.cs b/osu.Game/Overlays/Music/Playlist.cs
index ff8f3197f9..954c4de493 100644
--- a/osu.Game/Overlays/Music/Playlist.cs
+++ b/osu.Game/Overlays/Music/Playlist.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Overlays/Music/PlaylistItem.cs b/osu.Game/Overlays/Music/PlaylistItem.cs
index 82599d3ec9..b30ae095b1 100644
--- a/osu.Game/Overlays/Music/PlaylistItem.cs
+++ b/osu.Game/Overlays/Music/PlaylistItem.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Overlays/Music/PlaylistOverlay.cs b/osu.Game/Overlays/Music/PlaylistOverlay.cs
index ce816f84f0..3c25fc0421 100644
--- a/osu.Game/Overlays/Music/PlaylistOverlay.cs
+++ b/osu.Game/Overlays/Music/PlaylistOverlay.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Overlays/MusicController.cs b/osu.Game/Overlays/MusicController.cs
index aa09ff6b97..bce7e9b797 100644
--- a/osu.Game/Overlays/MusicController.cs
+++ b/osu.Game/Overlays/MusicController.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Overlays/News/Displays/ArticleListing.cs b/osu.Game/Overlays/News/Displays/ArticleListing.cs
index dc3b17b323..8465ebf07c 100644
--- a/osu.Game/Overlays/News/Displays/ArticleListing.cs
+++ b/osu.Game/Overlays/News/Displays/ArticleListing.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Overlays/News/NewsCard.cs b/osu.Game/Overlays/News/NewsCard.cs
index 5ce0b9df9c..69094a0df7 100644
--- a/osu.Game/Overlays/News/NewsCard.cs
+++ b/osu.Game/Overlays/News/NewsCard.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Overlays/News/NewsHeader.cs b/osu.Game/Overlays/News/NewsHeader.cs
index 35e3c7755d..d204dfcf2e 100644
--- a/osu.Game/Overlays/News/NewsHeader.cs
+++ b/osu.Game/Overlays/News/NewsHeader.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Overlays/News/NewsPostBackground.cs b/osu.Game/Overlays/News/NewsPostBackground.cs
index 386ef7f669..bddca8f7ec 100644
--- a/osu.Game/Overlays/News/NewsPostBackground.cs
+++ b/osu.Game/Overlays/News/NewsPostBackground.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Graphics.Textures;
diff --git a/osu.Game/Overlays/News/Sidebar/MonthSection.cs b/osu.Game/Overlays/News/Sidebar/MonthSection.cs
index e2ce25660e..894f8d5667 100644
--- a/osu.Game/Overlays/News/Sidebar/MonthSection.cs
+++ b/osu.Game/Overlays/News/Sidebar/MonthSection.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Overlays/News/Sidebar/NewsSidebar.cs b/osu.Game/Overlays/News/Sidebar/NewsSidebar.cs
index 829fc5b3eb..884e15c03b 100644
--- a/osu.Game/Overlays/News/Sidebar/NewsSidebar.cs
+++ b/osu.Game/Overlays/News/Sidebar/NewsSidebar.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Overlays/News/Sidebar/YearsPanel.cs b/osu.Game/Overlays/News/Sidebar/YearsPanel.cs
index 58c0f6ac82..915ed1817c 100644
--- a/osu.Game/Overlays/News/Sidebar/YearsPanel.cs
+++ b/osu.Game/Overlays/News/Sidebar/YearsPanel.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Overlays/NewsOverlay.cs b/osu.Game/Overlays/NewsOverlay.cs
index 12e3f81ca1..87b7ebbe89 100644
--- a/osu.Game/Overlays/NewsOverlay.cs
+++ b/osu.Game/Overlays/NewsOverlay.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.
 
+#nullable disable
+
 using System;
 using System.Threading;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Overlays/NotificationOverlay.cs b/osu.Game/Overlays/NotificationOverlay.cs
index d83839fa2c..281077bcf6 100644
--- a/osu.Game/Overlays/NotificationOverlay.cs
+++ b/osu.Game/Overlays/NotificationOverlay.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 enable
-
 using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
diff --git a/osu.Game/Overlays/Notifications/IHasCompletionTarget.cs b/osu.Game/Overlays/Notifications/IHasCompletionTarget.cs
index 603f53cb53..e4aeb4d6ce 100644
--- a/osu.Game/Overlays/Notifications/IHasCompletionTarget.cs
+++ b/osu.Game/Overlays/Notifications/IHasCompletionTarget.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.
 
+#nullable disable
+
 using System;
 
 namespace osu.Game.Overlays.Notifications
diff --git a/osu.Game/Overlays/Notifications/Notification.cs b/osu.Game/Overlays/Notifications/Notification.cs
index ec6e9e09b3..64bf3693c8 100644
--- a/osu.Game/Overlays/Notifications/Notification.cs
+++ b/osu.Game/Overlays/Notifications/Notification.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.Color4Extensions;
diff --git a/osu.Game/Overlays/Notifications/NotificationSection.cs b/osu.Game/Overlays/Notifications/NotificationSection.cs
index a4851ab365..b7e21822fa 100644
--- a/osu.Game/Overlays/Notifications/NotificationSection.cs
+++ b/osu.Game/Overlays/Notifications/NotificationSection.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Overlays/Notifications/ProgressCompletionNotification.cs b/osu.Game/Overlays/Notifications/ProgressCompletionNotification.cs
index 754f9bd600..cb9d54c14c 100644
--- a/osu.Game/Overlays/Notifications/ProgressCompletionNotification.cs
+++ b/osu.Game/Overlays/Notifications/ProgressCompletionNotification.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Game.Graphics;
 using osu.Framework.Graphics.Colour;
diff --git a/osu.Game/Overlays/Notifications/ProgressNotification.cs b/osu.Game/Overlays/Notifications/ProgressNotification.cs
index 4735fcb7c1..d76df5b1ed 100644
--- a/osu.Game/Overlays/Notifications/ProgressNotification.cs
+++ b/osu.Game/Overlays/Notifications/ProgressNotification.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.
 
+#nullable disable
+
 using System;
 using System.Threading;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Overlays/Notifications/SimpleErrorNotification.cs b/osu.Game/Overlays/Notifications/SimpleErrorNotification.cs
index faab4ed472..ffefcb033f 100644
--- a/osu.Game/Overlays/Notifications/SimpleErrorNotification.cs
+++ b/osu.Game/Overlays/Notifications/SimpleErrorNotification.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.
 
+#nullable disable
+
 using osu.Framework.Graphics.Sprites;
 
 namespace osu.Game.Overlays.Notifications
diff --git a/osu.Game/Overlays/Notifications/SimpleNotification.cs b/osu.Game/Overlays/Notifications/SimpleNotification.cs
index b9a1cc6d90..fc594902cf 100644
--- a/osu.Game/Overlays/Notifications/SimpleNotification.cs
+++ b/osu.Game/Overlays/Notifications/SimpleNotification.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Colour;
diff --git a/osu.Game/Overlays/NowPlayingOverlay.cs b/osu.Game/Overlays/NowPlayingOverlay.cs
index 4617a91885..6eddc7da83 100644
--- a/osu.Game/Overlays/NowPlayingOverlay.cs
+++ b/osu.Game/Overlays/NowPlayingOverlay.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.
 
+#nullable disable
+
 using System;
 using System.Threading.Tasks;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Overlays/OSD/Toast.cs b/osu.Game/Overlays/OSD/Toast.cs
index 12e30d8de2..a9fab0a23d 100644
--- a/osu.Game/Overlays/OSD/Toast.cs
+++ b/osu.Game/Overlays/OSD/Toast.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.
 
+#nullable disable
+
 using osu.Framework.Extensions.LocalisationExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Overlays/OSD/TrackedSettingToast.cs b/osu.Game/Overlays/OSD/TrackedSettingToast.cs
index 9939ba024e..c66811a3e9 100644
--- a/osu.Game/Overlays/OSD/TrackedSettingToast.cs
+++ b/osu.Game/Overlays/OSD/TrackedSettingToast.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
diff --git a/osu.Game/Overlays/OnScreenDisplay.cs b/osu.Game/Overlays/OnScreenDisplay.cs
index 6b3696ced9..f2836885ce 100644
--- a/osu.Game/Overlays/OnScreenDisplay.cs
+++ b/osu.Game/Overlays/OnScreenDisplay.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using osu.Framework.Configuration;
diff --git a/osu.Game/Overlays/OnlineOverlay.cs b/osu.Game/Overlays/OnlineOverlay.cs
index a610511398..424584fbcf 100644
--- a/osu.Game/Overlays/OnlineOverlay.cs
+++ b/osu.Game/Overlays/OnlineOverlay.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Overlays/OverlayActivation.cs b/osu.Game/Overlays/OverlayActivation.cs
index 68d7ee8ea9..354153734e 100644
--- a/osu.Game/Overlays/OverlayActivation.cs
+++ b/osu.Game/Overlays/OverlayActivation.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.
 
+#nullable disable
+
 namespace osu.Game.Overlays
 {
     public enum OverlayActivation
diff --git a/osu.Game/Overlays/OverlayColourProvider.cs b/osu.Game/Overlays/OverlayColourProvider.cs
index a4f6527024..d7581960f4 100644
--- a/osu.Game/Overlays/OverlayColourProvider.cs
+++ b/osu.Game/Overlays/OverlayColourProvider.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.
 
+#nullable disable
+
 using System;
 using osuTK;
 using osuTK.Graphics;
diff --git a/osu.Game/Overlays/OverlayHeader.cs b/osu.Game/Overlays/OverlayHeader.cs
index fed1e57686..ed8e3849d4 100644
--- a/osu.Game/Overlays/OverlayHeader.cs
+++ b/osu.Game/Overlays/OverlayHeader.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.
 
+#nullable disable
+
 using JetBrains.Annotations;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Overlays/OverlayHeaderBackground.cs b/osu.Game/Overlays/OverlayHeaderBackground.cs
index 2fef593285..c47f16272f 100644
--- a/osu.Game/Overlays/OverlayHeaderBackground.cs
+++ b/osu.Game/Overlays/OverlayHeaderBackground.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Overlays/OverlayPanelDisplayStyleControl.cs b/osu.Game/Overlays/OverlayPanelDisplayStyleControl.cs
index d7a3b052ae..14a99cd5bb 100644
--- a/osu.Game/Overlays/OverlayPanelDisplayStyleControl.cs
+++ b/osu.Game/Overlays/OverlayPanelDisplayStyleControl.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.
 
+#nullable disable
+
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Graphics.UserInterface;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Overlays/OverlayRulesetSelector.cs b/osu.Game/Overlays/OverlayRulesetSelector.cs
index 8c44157f78..a0efb197c2 100644
--- a/osu.Game/Overlays/OverlayRulesetSelector.cs
+++ b/osu.Game/Overlays/OverlayRulesetSelector.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.UserInterface;
diff --git a/osu.Game/Overlays/OverlayRulesetTabItem.cs b/osu.Game/Overlays/OverlayRulesetTabItem.cs
index 1f11b98881..ba0b81a514 100644
--- a/osu.Game/Overlays/OverlayRulesetTabItem.cs
+++ b/osu.Game/Overlays/OverlayRulesetTabItem.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.UserInterface;
diff --git a/osu.Game/Overlays/OverlayScrollContainer.cs b/osu.Game/Overlays/OverlayScrollContainer.cs
index 7fe188eb04..95b27665f4 100644
--- a/osu.Game/Overlays/OverlayScrollContainer.cs
+++ b/osu.Game/Overlays/OverlayScrollContainer.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.Color4Extensions;
diff --git a/osu.Game/Overlays/OverlaySidebar.cs b/osu.Game/Overlays/OverlaySidebar.cs
index 468b5b6eb3..62f3e1af13 100644
--- a/osu.Game/Overlays/OverlaySidebar.cs
+++ b/osu.Game/Overlays/OverlaySidebar.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.
 
+#nullable disable
+
 using JetBrains.Annotations;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Overlays/OverlaySortTabControl.cs b/osu.Game/Overlays/OverlaySortTabControl.cs
index 5f5cfce344..f02d2b388f 100644
--- a/osu.Game/Overlays/OverlaySortTabControl.cs
+++ b/osu.Game/Overlays/OverlaySortTabControl.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.
 
+#nullable disable
+
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.UserInterface;
diff --git a/osu.Game/Overlays/OverlayStreamControl.cs b/osu.Game/Overlays/OverlayStreamControl.cs
index 8b6aca6d5d..1bd244176e 100644
--- a/osu.Game/Overlays/OverlayStreamControl.cs
+++ b/osu.Game/Overlays/OverlayStreamControl.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Input.Events;
 using System.Collections.Generic;
diff --git a/osu.Game/Overlays/OverlayStreamItem.cs b/osu.Game/Overlays/OverlayStreamItem.cs
index 56502ff70f..3e09956480 100644
--- a/osu.Game/Overlays/OverlayStreamItem.cs
+++ b/osu.Game/Overlays/OverlayStreamItem.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Input.Events;
 using osu.Framework.Graphics.UserInterface;
diff --git a/osu.Game/Overlays/OverlayTabControl.cs b/osu.Game/Overlays/OverlayTabControl.cs
index 578cd703c7..35e073a3a1 100644
--- a/osu.Game/Overlays/OverlayTabControl.cs
+++ b/osu.Game/Overlays/OverlayTabControl.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Shapes;
diff --git a/osu.Game/Overlays/OverlayTitle.cs b/osu.Game/Overlays/OverlayTitle.cs
index d92979e8d4..f2c42034a3 100644
--- a/osu.Game/Overlays/OverlayTitle.cs
+++ b/osu.Game/Overlays/OverlayTitle.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Overlays/OverlayView.cs b/osu.Game/Overlays/OverlayView.cs
index c254cdf290..80df0c695f 100644
--- a/osu.Game/Overlays/OverlayView.cs
+++ b/osu.Game/Overlays/OverlayView.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Overlays/Profile/Header/BottomHeaderContainer.cs b/osu.Game/Overlays/Profile/Header/BottomHeaderContainer.cs
index a70d57661b..dcc8b19021 100644
--- a/osu.Game/Overlays/Profile/Header/BottomHeaderContainer.cs
+++ b/osu.Game/Overlays/Profile/Header/BottomHeaderContainer.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.
 
+#nullable disable
+
 using System;
 using Humanizer;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Overlays/Profile/Header/CentreHeaderContainer.cs b/osu.Game/Overlays/Profile/Header/CentreHeaderContainer.cs
index 00a866f1f4..b07817de46 100644
--- a/osu.Game/Overlays/Profile/Header/CentreHeaderContainer.cs
+++ b/osu.Game/Overlays/Profile/Header/CentreHeaderContainer.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Extensions.LocalisationExtensions;
diff --git a/osu.Game/Overlays/Profile/Header/Components/DrawableBadge.cs b/osu.Game/Overlays/Profile/Header/Components/DrawableBadge.cs
index 74f3ed846b..cf75818a0c 100644
--- a/osu.Game/Overlays/Profile/Header/Components/DrawableBadge.cs
+++ b/osu.Game/Overlays/Profile/Header/Components/DrawableBadge.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Overlays/Profile/Header/Components/ExpandDetailsButton.cs b/osu.Game/Overlays/Profile/Header/Components/ExpandDetailsButton.cs
index 4cfdf5cc86..62b228c285 100644
--- a/osu.Game/Overlays/Profile/Header/Components/ExpandDetailsButton.cs
+++ b/osu.Game/Overlays/Profile/Header/Components/ExpandDetailsButton.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
 using osu.Framework.Audio.Sample;
diff --git a/osu.Game/Overlays/Profile/Header/Components/FollowersButton.cs b/osu.Game/Overlays/Profile/Header/Components/FollowersButton.cs
index 1b21bfc982..6fbfff1dd7 100644
--- a/osu.Game/Overlays/Profile/Header/Components/FollowersButton.cs
+++ b/osu.Game/Overlays/Profile/Header/Components/FollowersButton.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics.Sprites;
diff --git a/osu.Game/Overlays/Profile/Header/Components/LevelBadge.cs b/osu.Game/Overlays/Profile/Header/Components/LevelBadge.cs
index e1302788da..fdf7478834 100644
--- a/osu.Game/Overlays/Profile/Header/Components/LevelBadge.cs
+++ b/osu.Game/Overlays/Profile/Header/Components/LevelBadge.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Overlays/Profile/Header/Components/LevelProgressBar.cs b/osu.Game/Overlays/Profile/Header/Components/LevelProgressBar.cs
index d8eb5b65ac..1ba391431f 100644
--- a/osu.Game/Overlays/Profile/Header/Components/LevelProgressBar.cs
+++ b/osu.Game/Overlays/Profile/Header/Components/LevelProgressBar.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Extensions.LocalisationExtensions;
diff --git a/osu.Game/Overlays/Profile/Header/Components/MappingSubscribersButton.cs b/osu.Game/Overlays/Profile/Header/Components/MappingSubscribersButton.cs
index 6d1024ff18..7bfc78cb2d 100644
--- a/osu.Game/Overlays/Profile/Header/Components/MappingSubscribersButton.cs
+++ b/osu.Game/Overlays/Profile/Header/Components/MappingSubscribersButton.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics.Sprites;
diff --git a/osu.Game/Overlays/Profile/Header/Components/MessageUserButton.cs b/osu.Game/Overlays/Profile/Header/Components/MessageUserButton.cs
index e3dc5f818a..46cb811846 100644
--- a/osu.Game/Overlays/Profile/Header/Components/MessageUserButton.cs
+++ b/osu.Game/Overlays/Profile/Header/Components/MessageUserButton.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Overlays/Profile/Header/Components/OverlinedInfoContainer.cs b/osu.Game/Overlays/Profile/Header/Components/OverlinedInfoContainer.cs
index 5ef8482b47..7ac472ee00 100644
--- a/osu.Game/Overlays/Profile/Header/Components/OverlinedInfoContainer.cs
+++ b/osu.Game/Overlays/Profile/Header/Components/OverlinedInfoContainer.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
diff --git a/osu.Game/Overlays/Profile/Header/Components/OverlinedTotalPlayTime.cs b/osu.Game/Overlays/Profile/Header/Components/OverlinedTotalPlayTime.cs
index 1ead2cd2f5..9e5a0f5962 100644
--- a/osu.Game/Overlays/Profile/Header/Components/OverlinedTotalPlayTime.cs
+++ b/osu.Game/Overlays/Profile/Header/Components/OverlinedTotalPlayTime.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Overlays/Profile/Header/Components/PreviousUsernames.cs b/osu.Game/Overlays/Profile/Header/Components/PreviousUsernames.cs
index 49744e885a..808c814928 100644
--- a/osu.Game/Overlays/Profile/Header/Components/PreviousUsernames.cs
+++ b/osu.Game/Overlays/Profile/Header/Components/PreviousUsernames.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Overlays/Profile/Header/Components/ProfileHeaderButton.cs b/osu.Game/Overlays/Profile/Header/Components/ProfileHeaderButton.cs
index cea63574cf..5bdf9c19e1 100644
--- a/osu.Game/Overlays/Profile/Header/Components/ProfileHeaderButton.cs
+++ b/osu.Game/Overlays/Profile/Header/Components/ProfileHeaderButton.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Overlays/Profile/Header/Components/ProfileHeaderStatisticsButton.cs b/osu.Game/Overlays/Profile/Header/Components/ProfileHeaderStatisticsButton.cs
index b098f9f840..3b3251fc4e 100644
--- a/osu.Game/Overlays/Profile/Header/Components/ProfileHeaderStatisticsButton.cs
+++ b/osu.Game/Overlays/Profile/Header/Components/ProfileHeaderStatisticsButton.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.
 
+#nullable disable
+
 using osu.Framework.Extensions.LocalisationExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Overlays/Profile/Header/Components/ProfileRulesetSelector.cs b/osu.Game/Overlays/Profile/Header/Components/ProfileRulesetSelector.cs
index 4d2290266c..3a47570cf7 100644
--- a/osu.Game/Overlays/Profile/Header/Components/ProfileRulesetSelector.cs
+++ b/osu.Game/Overlays/Profile/Header/Components/ProfileRulesetSelector.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.
 
+#nullable disable
+
 using osu.Framework.Bindables;
 using osu.Framework.Graphics.UserInterface;
 using osu.Game.Online.API.Requests.Responses;
diff --git a/osu.Game/Overlays/Profile/Header/Components/ProfileRulesetTabItem.cs b/osu.Game/Overlays/Profile/Header/Components/ProfileRulesetTabItem.cs
index 4a44e285bf..d75fe1ae84 100644
--- a/osu.Game/Overlays/Profile/Header/Components/ProfileRulesetTabItem.cs
+++ b/osu.Game/Overlays/Profile/Header/Components/ProfileRulesetTabItem.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Cursor;
 using osu.Framework.Graphics.Sprites;
diff --git a/osu.Game/Overlays/Profile/Header/Components/RankGraph.cs b/osu.Game/Overlays/Profile/Header/Components/RankGraph.cs
index d195babcbf..85fb5c4e5c 100644
--- a/osu.Game/Overlays/Profile/Header/Components/RankGraph.cs
+++ b/osu.Game/Overlays/Profile/Header/Components/RankGraph.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Overlays/Profile/Header/Components/SupporterIcon.cs b/osu.Game/Overlays/Profile/Header/Components/SupporterIcon.cs
index f450754c02..a05d8ba152 100644
--- a/osu.Game/Overlays/Profile/Header/Components/SupporterIcon.cs
+++ b/osu.Game/Overlays/Profile/Header/Components/SupporterIcon.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Overlays/Profile/Header/DetailHeaderContainer.cs b/osu.Game/Overlays/Profile/Header/DetailHeaderContainer.cs
index 79e553062d..d65691f531 100644
--- a/osu.Game/Overlays/Profile/Header/DetailHeaderContainer.cs
+++ b/osu.Game/Overlays/Profile/Header/DetailHeaderContainer.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Overlays/Profile/Header/MedalHeaderContainer.cs b/osu.Game/Overlays/Profile/Header/MedalHeaderContainer.cs
index 922f3832e4..deb675df1d 100644
--- a/osu.Game/Overlays/Profile/Header/MedalHeaderContainer.cs
+++ b/osu.Game/Overlays/Profile/Header/MedalHeaderContainer.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.
 
+#nullable disable
+
 using System.Threading;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Overlays/Profile/Header/TopHeaderContainer.cs b/osu.Game/Overlays/Profile/Header/TopHeaderContainer.cs
index 3b76dc01ee..9c957e387a 100644
--- a/osu.Game/Overlays/Profile/Header/TopHeaderContainer.cs
+++ b/osu.Game/Overlays/Profile/Header/TopHeaderContainer.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Extensions.Color4Extensions;
diff --git a/osu.Game/Overlays/Profile/ProfileHeader.cs b/osu.Game/Overlays/Profile/ProfileHeader.cs
index 44e0d9c37f..f84f829f7a 100644
--- a/osu.Game/Overlays/Profile/ProfileHeader.cs
+++ b/osu.Game/Overlays/Profile/ProfileHeader.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.
 
+#nullable disable
+
 using osu.Framework.Bindables;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Overlays/Profile/ProfileSection.cs b/osu.Game/Overlays/Profile/ProfileSection.cs
index fc6fce0d8e..67738943e8 100644
--- a/osu.Game/Overlays/Profile/ProfileSection.cs
+++ b/osu.Game/Overlays/Profile/ProfileSection.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Extensions.Color4Extensions;
diff --git a/osu.Game/Overlays/Profile/Sections/AboutSection.cs b/osu.Game/Overlays/Profile/Sections/AboutSection.cs
index d0d9362fd2..2b6ce732a2 100644
--- a/osu.Game/Overlays/Profile/Sections/AboutSection.cs
+++ b/osu.Game/Overlays/Profile/Sections/AboutSection.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.
 
+#nullable disable
+
 using osu.Framework.Localisation;
 using osu.Game.Resources.Localisation.Web;
 
diff --git a/osu.Game/Overlays/Profile/Sections/BeatmapMetadataContainer.cs b/osu.Game/Overlays/Profile/Sections/BeatmapMetadataContainer.cs
index 13465f3bf8..5d36537c3e 100644
--- a/osu.Game/Overlays/Profile/Sections/BeatmapMetadataContainer.cs
+++ b/osu.Game/Overlays/Profile/Sections/BeatmapMetadataContainer.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Overlays/Profile/Sections/Beatmaps/PaginatedBeatmapContainer.cs b/osu.Game/Overlays/Profile/Sections/Beatmaps/PaginatedBeatmapContainer.cs
index 8224cd5eb5..aaaed5ad0a 100644
--- a/osu.Game/Overlays/Profile/Sections/Beatmaps/PaginatedBeatmapContainer.cs
+++ b/osu.Game/Overlays/Profile/Sections/Beatmaps/PaginatedBeatmapContainer.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Overlays/Profile/Sections/BeatmapsSection.cs b/osu.Game/Overlays/Profile/Sections/BeatmapsSection.cs
index 6b93c24a78..e3cff5da05 100644
--- a/osu.Game/Overlays/Profile/Sections/BeatmapsSection.cs
+++ b/osu.Game/Overlays/Profile/Sections/BeatmapsSection.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.
 
+#nullable disable
+
 using osu.Framework.Localisation;
 using osu.Game.Online.API.Requests;
 using osu.Game.Overlays.Profile.Sections.Beatmaps;
diff --git a/osu.Game/Overlays/Profile/Sections/CounterPill.cs b/osu.Game/Overlays/Profile/Sections/CounterPill.cs
index bd6cb4d09b..e9b55f62ef 100644
--- a/osu.Game/Overlays/Profile/Sections/CounterPill.cs
+++ b/osu.Game/Overlays/Profile/Sections/CounterPill.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.
 
+#nullable disable
+
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Shapes;
diff --git a/osu.Game/Overlays/Profile/Sections/Historical/ChartProfileSubsection.cs b/osu.Game/Overlays/Profile/Sections/Historical/ChartProfileSubsection.cs
index 4edbdc31bd..f0819c4474 100644
--- a/osu.Game/Overlays/Profile/Sections/Historical/ChartProfileSubsection.cs
+++ b/osu.Game/Overlays/Profile/Sections/Historical/ChartProfileSubsection.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Overlays/Profile/Sections/Historical/DrawableMostPlayedBeatmap.cs b/osu.Game/Overlays/Profile/Sections/Historical/DrawableMostPlayedBeatmap.cs
index 3ed4bd9e50..70ab95b848 100644
--- a/osu.Game/Overlays/Profile/Sections/Historical/DrawableMostPlayedBeatmap.cs
+++ b/osu.Game/Overlays/Profile/Sections/Historical/DrawableMostPlayedBeatmap.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.
 
+#nullable disable
+
 using System.Diagnostics;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Overlays/Profile/Sections/Historical/PaginatedMostPlayedBeatmapContainer.cs b/osu.Game/Overlays/Profile/Sections/Historical/PaginatedMostPlayedBeatmapContainer.cs
index 06de0f62dc..34c9892f06 100644
--- a/osu.Game/Overlays/Profile/Sections/Historical/PaginatedMostPlayedBeatmapContainer.cs
+++ b/osu.Game/Overlays/Profile/Sections/Historical/PaginatedMostPlayedBeatmapContainer.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Overlays/Profile/Sections/Historical/PlayHistorySubsection.cs b/osu.Game/Overlays/Profile/Sections/Historical/PlayHistorySubsection.cs
index 51d704a6b0..73e39a2440 100644
--- a/osu.Game/Overlays/Profile/Sections/Historical/PlayHistorySubsection.cs
+++ b/osu.Game/Overlays/Profile/Sections/Historical/PlayHistorySubsection.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.
 
+#nullable disable
+
 using osu.Framework.Bindables;
 using osu.Framework.Localisation;
 using osu.Game.Online.API.Requests.Responses;
diff --git a/osu.Game/Overlays/Profile/Sections/Historical/ProfileLineChart.cs b/osu.Game/Overlays/Profile/Sections/Historical/ProfileLineChart.cs
index c049bff7b2..78a28a39d2 100644
--- a/osu.Game/Overlays/Profile/Sections/Historical/ProfileLineChart.cs
+++ b/osu.Game/Overlays/Profile/Sections/Historical/ProfileLineChart.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.
 
+#nullable disable
+
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics;
 using JetBrains.Annotations;
diff --git a/osu.Game/Overlays/Profile/Sections/Historical/ReplaysSubsection.cs b/osu.Game/Overlays/Profile/Sections/Historical/ReplaysSubsection.cs
index 22312afdc9..89e8f51338 100644
--- a/osu.Game/Overlays/Profile/Sections/Historical/ReplaysSubsection.cs
+++ b/osu.Game/Overlays/Profile/Sections/Historical/ReplaysSubsection.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.
 
+#nullable disable
+
 using osu.Framework.Bindables;
 using osu.Framework.Localisation;
 using osu.Game.Online.API.Requests.Responses;
diff --git a/osu.Game/Overlays/Profile/Sections/Historical/UserHistoryGraph.cs b/osu.Game/Overlays/Profile/Sections/Historical/UserHistoryGraph.cs
index f80167f9d3..48d75a4953 100644
--- a/osu.Game/Overlays/Profile/Sections/Historical/UserHistoryGraph.cs
+++ b/osu.Game/Overlays/Profile/Sections/Historical/UserHistoryGraph.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Overlays/Profile/Sections/HistoricalSection.cs b/osu.Game/Overlays/Profile/Sections/HistoricalSection.cs
index 203844b6b5..f1e1c44734 100644
--- a/osu.Game/Overlays/Profile/Sections/HistoricalSection.cs
+++ b/osu.Game/Overlays/Profile/Sections/HistoricalSection.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Localisation;
 using osu.Game.Online.API.Requests;
diff --git a/osu.Game/Overlays/Profile/Sections/Kudosu/DrawableKudosuHistoryItem.cs b/osu.Game/Overlays/Profile/Sections/Kudosu/DrawableKudosuHistoryItem.cs
index ce05beffd1..44f1af4b72 100644
--- a/osu.Game/Overlays/Profile/Sections/Kudosu/DrawableKudosuHistoryItem.cs
+++ b/osu.Game/Overlays/Profile/Sections/Kudosu/DrawableKudosuHistoryItem.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Overlays/Profile/Sections/Kudosu/KudosuInfo.cs b/osu.Game/Overlays/Profile/Sections/Kudosu/KudosuInfo.cs
index 79a06ecdd4..bb9d48c473 100644
--- a/osu.Game/Overlays/Profile/Sections/Kudosu/KudosuInfo.cs
+++ b/osu.Game/Overlays/Profile/Sections/Kudosu/KudosuInfo.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.
 
+#nullable disable
+
 using osu.Framework.Bindables;
 using osuTK;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Overlays/Profile/Sections/Kudosu/PaginatedKudosuHistoryContainer.cs b/osu.Game/Overlays/Profile/Sections/Kudosu/PaginatedKudosuHistoryContainer.cs
index 9af854e6b9..34e6866d25 100644
--- a/osu.Game/Overlays/Profile/Sections/Kudosu/PaginatedKudosuHistoryContainer.cs
+++ b/osu.Game/Overlays/Profile/Sections/Kudosu/PaginatedKudosuHistoryContainer.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Game.Online.API.Requests;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Overlays/Profile/Sections/KudosuSection.cs b/osu.Game/Overlays/Profile/Sections/KudosuSection.cs
index 5b749c78a8..517b4d92cf 100644
--- a/osu.Game/Overlays/Profile/Sections/KudosuSection.cs
+++ b/osu.Game/Overlays/Profile/Sections/KudosuSection.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Game.Overlays.Profile.Sections.Kudosu;
 using osu.Framework.Localisation;
diff --git a/osu.Game/Overlays/Profile/Sections/MedalsSection.cs b/osu.Game/Overlays/Profile/Sections/MedalsSection.cs
index cacdd44b61..a458bc4873 100644
--- a/osu.Game/Overlays/Profile/Sections/MedalsSection.cs
+++ b/osu.Game/Overlays/Profile/Sections/MedalsSection.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.
 
+#nullable disable
+
 using osu.Framework.Localisation;
 using osu.Game.Resources.Localisation.Web;
 
diff --git a/osu.Game/Overlays/Profile/Sections/PaginatedProfileSubsection.cs b/osu.Game/Overlays/Profile/Sections/PaginatedProfileSubsection.cs
index 33bd155d71..8ed1dc3676 100644
--- a/osu.Game/Overlays/Profile/Sections/PaginatedProfileSubsection.cs
+++ b/osu.Game/Overlays/Profile/Sections/PaginatedProfileSubsection.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using System.Threading;
diff --git a/osu.Game/Overlays/Profile/Sections/ProfileItemContainer.cs b/osu.Game/Overlays/Profile/Sections/ProfileItemContainer.cs
index afa6bd9f79..392e35ac05 100644
--- a/osu.Game/Overlays/Profile/Sections/ProfileItemContainer.cs
+++ b/osu.Game/Overlays/Profile/Sections/ProfileItemContainer.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Overlays/Profile/Sections/ProfileSubsection.cs b/osu.Game/Overlays/Profile/Sections/ProfileSubsection.cs
index fdf8cb19ff..8e43519a17 100644
--- a/osu.Game/Overlays/Profile/Sections/ProfileSubsection.cs
+++ b/osu.Game/Overlays/Profile/Sections/ProfileSubsection.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Overlays/Profile/Sections/ProfileSubsectionHeader.cs b/osu.Game/Overlays/Profile/Sections/ProfileSubsectionHeader.cs
index 408cb00770..f2770d81cd 100644
--- a/osu.Game/Overlays/Profile/Sections/ProfileSubsectionHeader.cs
+++ b/osu.Game/Overlays/Profile/Sections/ProfileSubsectionHeader.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Overlays/Profile/Sections/Ranks/DrawableProfileScore.cs b/osu.Game/Overlays/Profile/Sections/Ranks/DrawableProfileScore.cs
index 998f5d158e..54a262f6a6 100644
--- a/osu.Game/Overlays/Profile/Sections/Ranks/DrawableProfileScore.cs
+++ b/osu.Game/Overlays/Profile/Sections/Ranks/DrawableProfileScore.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.
 
+#nullable disable
+
 using System;
 using System.Diagnostics;
 using System.Linq;
diff --git a/osu.Game/Overlays/Profile/Sections/Ranks/DrawableProfileWeightedScore.cs b/osu.Game/Overlays/Profile/Sections/Ranks/DrawableProfileWeightedScore.cs
index 78ae0a5634..f8f83883fc 100644
--- a/osu.Game/Overlays/Profile/Sections/Ranks/DrawableProfileWeightedScore.cs
+++ b/osu.Game/Overlays/Profile/Sections/Ranks/DrawableProfileWeightedScore.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.
 
+#nullable disable
+
 using osu.Framework.Extensions.LocalisationExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Overlays/Profile/Sections/Ranks/PaginatedScoreContainer.cs b/osu.Game/Overlays/Profile/Sections/Ranks/PaginatedScoreContainer.cs
index ef9f4b5ff3..15c7b8f042 100644
--- a/osu.Game/Overlays/Profile/Sections/Ranks/PaginatedScoreContainer.cs
+++ b/osu.Game/Overlays/Profile/Sections/Ranks/PaginatedScoreContainer.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.
 
+#nullable disable
+
 using osu.Framework.Graphics.Containers;
 using osu.Game.Online.API.Requests;
 using System;
diff --git a/osu.Game/Overlays/Profile/Sections/RanksSection.cs b/osu.Game/Overlays/Profile/Sections/RanksSection.cs
index f48e33dc12..581b6e1139 100644
--- a/osu.Game/Overlays/Profile/Sections/RanksSection.cs
+++ b/osu.Game/Overlays/Profile/Sections/RanksSection.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.
 
+#nullable disable
+
 using osu.Game.Overlays.Profile.Sections.Ranks;
 using osu.Game.Online.API.Requests;
 using osu.Framework.Localisation;
diff --git a/osu.Game/Overlays/Profile/Sections/Recent/DrawableRecentActivity.cs b/osu.Game/Overlays/Profile/Sections/Recent/DrawableRecentActivity.cs
index 7a27c6e4e1..943c105008 100644
--- a/osu.Game/Overlays/Profile/Sections/Recent/DrawableRecentActivity.cs
+++ b/osu.Game/Overlays/Profile/Sections/Recent/DrawableRecentActivity.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.
 
+#nullable disable
+
 using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Overlays/Profile/Sections/Recent/MedalIcon.cs b/osu.Game/Overlays/Profile/Sections/Recent/MedalIcon.cs
index 0c1f8b2e92..e3072f3420 100644
--- a/osu.Game/Overlays/Profile/Sections/Recent/MedalIcon.cs
+++ b/osu.Game/Overlays/Profile/Sections/Recent/MedalIcon.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Overlays/Profile/Sections/Recent/PaginatedRecentActivityContainer.cs b/osu.Game/Overlays/Profile/Sections/Recent/PaginatedRecentActivityContainer.cs
index 77008d5f34..2878e0e940 100644
--- a/osu.Game/Overlays/Profile/Sections/Recent/PaginatedRecentActivityContainer.cs
+++ b/osu.Game/Overlays/Profile/Sections/Recent/PaginatedRecentActivityContainer.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Game.Online.API.Requests;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Overlays/Profile/Sections/RecentSection.cs b/osu.Game/Overlays/Profile/Sections/RecentSection.cs
index 33d435aa1b..c20594f974 100644
--- a/osu.Game/Overlays/Profile/Sections/RecentSection.cs
+++ b/osu.Game/Overlays/Profile/Sections/RecentSection.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.
 
+#nullable disable
+
 using osu.Framework.Localisation;
 using osu.Game.Overlays.Profile.Sections.Recent;
 using osu.Game.Resources.Localisation.Web;
diff --git a/osu.Game/Overlays/Profile/UserGraph.cs b/osu.Game/Overlays/Profile/UserGraph.cs
index 182221eea7..a8a4de68ff 100644
--- a/osu.Game/Overlays/Profile/UserGraph.cs
+++ b/osu.Game/Overlays/Profile/UserGraph.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Overlays/Rankings/CountryFilter.cs b/osu.Game/Overlays/Rankings/CountryFilter.cs
index 9950f36141..9ba2018522 100644
--- a/osu.Game/Overlays/Rankings/CountryFilter.cs
+++ b/osu.Game/Overlays/Rankings/CountryFilter.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Overlays/Rankings/CountryPill.cs b/osu.Game/Overlays/Rankings/CountryPill.cs
index 3878e2ea4e..90f8c85557 100644
--- a/osu.Game/Overlays/Rankings/CountryPill.cs
+++ b/osu.Game/Overlays/Rankings/CountryPill.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Overlays/Rankings/RankingsOverlayHeader.cs b/osu.Game/Overlays/Rankings/RankingsOverlayHeader.cs
index 417b33ddf6..9b0b75f663 100644
--- a/osu.Game/Overlays/Rankings/RankingsOverlayHeader.cs
+++ b/osu.Game/Overlays/Rankings/RankingsOverlayHeader.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.
 
+#nullable disable
+
 using osu.Framework.Bindables;
 using osu.Game.Localisation;
 using osu.Game.Resources.Localisation.Web;
diff --git a/osu.Game/Overlays/Rankings/RankingsScope.cs b/osu.Game/Overlays/Rankings/RankingsScope.cs
index e660c2898a..2644fee58b 100644
--- a/osu.Game/Overlays/Rankings/RankingsScope.cs
+++ b/osu.Game/Overlays/Rankings/RankingsScope.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.
 
+#nullable disable
+
 using osu.Framework.Localisation;
 using osu.Game.Resources.Localisation.Web;
 
diff --git a/osu.Game/Overlays/Rankings/RankingsSortTabControl.cs b/osu.Game/Overlays/Rankings/RankingsSortTabControl.cs
index f05795b2a2..905c0fae65 100644
--- a/osu.Game/Overlays/Rankings/RankingsSortTabControl.cs
+++ b/osu.Game/Overlays/Rankings/RankingsSortTabControl.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.
 
+#nullable disable
+
 using osu.Framework.Extensions.LocalisationExtensions;
 using osu.Framework.Localisation;
 using osu.Game.Resources.Localisation.Web;
diff --git a/osu.Game/Overlays/Rankings/SpotlightSelector.cs b/osu.Game/Overlays/Rankings/SpotlightSelector.cs
index c05c160463..234b91de66 100644
--- a/osu.Game/Overlays/Rankings/SpotlightSelector.cs
+++ b/osu.Game/Overlays/Rankings/SpotlightSelector.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Overlays/Rankings/SpotlightsLayout.cs b/osu.Game/Overlays/Rankings/SpotlightsLayout.cs
index 7f5d096fe2..c23b9711dd 100644
--- a/osu.Game/Overlays/Rankings/SpotlightsLayout.cs
+++ b/osu.Game/Overlays/Rankings/SpotlightsLayout.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.
 
+#nullable disable
+
 using System.Linq;
 using System.Threading;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Overlays/Rankings/Tables/CountriesTable.cs b/osu.Game/Overlays/Rankings/Tables/CountriesTable.cs
index a908380e95..53d10b3e53 100644
--- a/osu.Game/Overlays/Rankings/Tables/CountriesTable.cs
+++ b/osu.Game/Overlays/Rankings/Tables/CountriesTable.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using System;
diff --git a/osu.Game/Overlays/Rankings/Tables/PerformanceTable.cs b/osu.Game/Overlays/Rankings/Tables/PerformanceTable.cs
index 6c85ec2753..a77546d83f 100644
--- a/osu.Game/Overlays/Rankings/Tables/PerformanceTable.cs
+++ b/osu.Game/Overlays/Rankings/Tables/PerformanceTable.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Framework.Extensions.LocalisationExtensions;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Overlays/Rankings/Tables/RankingsTable.cs b/osu.Game/Overlays/Rankings/Tables/RankingsTable.cs
index 9658679067..56e318637a 100644
--- a/osu.Game/Overlays/Rankings/Tables/RankingsTable.cs
+++ b/osu.Game/Overlays/Rankings/Tables/RankingsTable.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using System.Collections.Generic;
diff --git a/osu.Game/Overlays/Rankings/Tables/ScoresTable.cs b/osu.Game/Overlays/Rankings/Tables/ScoresTable.cs
index 934da4501e..71c78baf3c 100644
--- a/osu.Game/Overlays/Rankings/Tables/ScoresTable.cs
+++ b/osu.Game/Overlays/Rankings/Tables/ScoresTable.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Framework.Extensions.LocalisationExtensions;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Overlays/Rankings/Tables/TableRowBackground.cs b/osu.Game/Overlays/Rankings/Tables/TableRowBackground.cs
index b49fec65db..fd9f6da749 100644
--- a/osu.Game/Overlays/Rankings/Tables/TableRowBackground.cs
+++ b/osu.Game/Overlays/Rankings/Tables/TableRowBackground.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Overlays/Rankings/Tables/UserBasedTable.cs b/osu.Game/Overlays/Rankings/Tables/UserBasedTable.cs
index 5d150c9535..2edd1b21ba 100644
--- a/osu.Game/Overlays/Rankings/Tables/UserBasedTable.cs
+++ b/osu.Game/Overlays/Rankings/Tables/UserBasedTable.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using osu.Framework.Extensions.LocalisationExtensions;
diff --git a/osu.Game/Overlays/RankingsOverlay.cs b/osu.Game/Overlays/RankingsOverlay.cs
index 80ce2e038d..a66b8cf2ba 100644
--- a/osu.Game/Overlays/RankingsOverlay.cs
+++ b/osu.Game/Overlays/RankingsOverlay.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Overlays/RestoreDefaultValueButton.cs b/osu.Game/Overlays/RestoreDefaultValueButton.cs
index afc4146199..a5da696f58 100644
--- a/osu.Game/Overlays/RestoreDefaultValueButton.cs
+++ b/osu.Game/Overlays/RestoreDefaultValueButton.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Extensions.Color4Extensions;
diff --git a/osu.Game/Overlays/Settings/DangerousSettingsButton.cs b/osu.Game/Overlays/Settings/DangerousSettingsButton.cs
index 4ca3ace8a1..bf7c9ccf2b 100644
--- a/osu.Game/Overlays/Settings/DangerousSettingsButton.cs
+++ b/osu.Game/Overlays/Settings/DangerousSettingsButton.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Game.Graphics;
 
diff --git a/osu.Game/Overlays/Settings/ISettingsItem.cs b/osu.Game/Overlays/Settings/ISettingsItem.cs
index 61191dcacf..509fc1ab0d 100644
--- a/osu.Game/Overlays/Settings/ISettingsItem.cs
+++ b/osu.Game/Overlays/Settings/ISettingsItem.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Graphics;
 
diff --git a/osu.Game/Overlays/Settings/OutlinedTextBox.cs b/osu.Game/Overlays/Settings/OutlinedTextBox.cs
index 93eaf74b77..de7fe75060 100644
--- a/osu.Game/Overlays/Settings/OutlinedTextBox.cs
+++ b/osu.Game/Overlays/Settings/OutlinedTextBox.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Input.Events;
diff --git a/osu.Game/Overlays/Settings/RulesetSettingsSubsection.cs b/osu.Game/Overlays/Settings/RulesetSettingsSubsection.cs
index 3945a410ab..76e75a5b3c 100644
--- a/osu.Game/Overlays/Settings/RulesetSettingsSubsection.cs
+++ b/osu.Game/Overlays/Settings/RulesetSettingsSubsection.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Game.Configuration;
 using osu.Game.Rulesets;
diff --git a/osu.Game/Overlays/Settings/Sections/Audio/AudioDevicesSettings.cs b/osu.Game/Overlays/Settings/Sections/Audio/AudioDevicesSettings.cs
index 858d555f06..7cb9efa1b9 100644
--- a/osu.Game/Overlays/Settings/Sections/Audio/AudioDevicesSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Audio/AudioDevicesSettings.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Overlays/Settings/Sections/Audio/OffsetSettings.cs b/osu.Game/Overlays/Settings/Sections/Audio/OffsetSettings.cs
index eaacb9293f..d25e9490b7 100644
--- a/osu.Game/Overlays/Settings/Sections/Audio/OffsetSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Audio/OffsetSettings.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Overlays/Settings/Sections/Audio/VolumeSettings.cs b/osu.Game/Overlays/Settings/Sections/Audio/VolumeSettings.cs
index 00c1cb8f43..cea8fdd733 100644
--- a/osu.Game/Overlays/Settings/Sections/Audio/VolumeSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Audio/VolumeSettings.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Overlays/Settings/Sections/AudioSection.cs b/osu.Game/Overlays/Settings/Sections/AudioSection.cs
index 7ffa0bd415..70c74cd77c 100644
--- a/osu.Game/Overlays/Settings/Sections/AudioSection.cs
+++ b/osu.Game/Overlays/Settings/Sections/AudioSection.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using osu.Framework.Localisation;
diff --git a/osu.Game/Overlays/Settings/Sections/DebugSection.cs b/osu.Game/Overlays/Settings/Sections/DebugSection.cs
index 2e23d8a22a..a02e28d33a 100644
--- a/osu.Game/Overlays/Settings/Sections/DebugSection.cs
+++ b/osu.Game/Overlays/Settings/Sections/DebugSection.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Localisation;
diff --git a/osu.Game/Overlays/Settings/Sections/DebugSettings/GeneralSettings.cs b/osu.Game/Overlays/Settings/Sections/DebugSettings/GeneralSettings.cs
index 2b845e9d6b..e79d27ad2a 100644
--- a/osu.Game/Overlays/Settings/Sections/DebugSettings/GeneralSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/DebugSettings/GeneralSettings.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Configuration;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Overlays/Settings/Sections/DebugSettings/MemorySettings.cs b/osu.Game/Overlays/Settings/Sections/DebugSettings/MemorySettings.cs
index f26326a220..77eede0e46 100644
--- a/osu.Game/Overlays/Settings/Sections/DebugSettings/MemorySettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/DebugSettings/MemorySettings.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.
 
+#nullable disable
+
 using System;
 using System.Threading;
 using System.Threading.Tasks;
diff --git a/osu.Game/Overlays/Settings/Sections/Gameplay/AudioSettings.cs b/osu.Game/Overlays/Settings/Sections/Gameplay/AudioSettings.cs
index e2e00813bd..d369c4470b 100644
--- a/osu.Game/Overlays/Settings/Sections/Gameplay/AudioSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Gameplay/AudioSettings.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Localisation;
diff --git a/osu.Game/Overlays/Settings/Sections/Gameplay/BackgroundSettings.cs b/osu.Game/Overlays/Settings/Sections/Gameplay/BackgroundSettings.cs
index 94e0c5e494..cc224a4f7f 100644
--- a/osu.Game/Overlays/Settings/Sections/Gameplay/BackgroundSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Gameplay/BackgroundSettings.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Localisation;
diff --git a/osu.Game/Overlays/Settings/Sections/Gameplay/BeatmapSettings.cs b/osu.Game/Overlays/Settings/Sections/Gameplay/BeatmapSettings.cs
index aaa60ce81b..becb7aa80f 100644
--- a/osu.Game/Overlays/Settings/Sections/Gameplay/BeatmapSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Gameplay/BeatmapSettings.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Localisation;
diff --git a/osu.Game/Overlays/Settings/Sections/Gameplay/GeneralSettings.cs b/osu.Game/Overlays/Settings/Sections/Gameplay/GeneralSettings.cs
index 5231ce1211..c16ee39191 100644
--- a/osu.Game/Overlays/Settings/Sections/Gameplay/GeneralSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Gameplay/GeneralSettings.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Localisation;
diff --git a/osu.Game/Overlays/Settings/Sections/Gameplay/HUDSettings.cs b/osu.Game/Overlays/Settings/Sections/Gameplay/HUDSettings.cs
index 0d31e70880..0893af7d3e 100644
--- a/osu.Game/Overlays/Settings/Sections/Gameplay/HUDSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Gameplay/HUDSettings.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Localisation;
diff --git a/osu.Game/Overlays/Settings/Sections/Gameplay/InputSettings.cs b/osu.Game/Overlays/Settings/Sections/Gameplay/InputSettings.cs
index 83ea655601..b5315d5268 100644
--- a/osu.Game/Overlays/Settings/Sections/Gameplay/InputSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Gameplay/InputSettings.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.
 
+#nullable disable
+
 using osu.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Overlays/Settings/Sections/Gameplay/ModsSettings.cs b/osu.Game/Overlays/Settings/Sections/Gameplay/ModsSettings.cs
index ed88d80570..53f7f52212 100644
--- a/osu.Game/Overlays/Settings/Sections/Gameplay/ModsSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Gameplay/ModsSettings.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Overlays/Settings/Sections/GameplaySection.cs b/osu.Game/Overlays/Settings/Sections/GameplaySection.cs
index 120e2d908c..48e76bfeb7 100644
--- a/osu.Game/Overlays/Settings/Sections/GameplaySection.cs
+++ b/osu.Game/Overlays/Settings/Sections/GameplaySection.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Localisation;
diff --git a/osu.Game/Overlays/Settings/Sections/General/LanguageSettings.cs b/osu.Game/Overlays/Settings/Sections/General/LanguageSettings.cs
index cdce187a35..63f0dec953 100644
--- a/osu.Game/Overlays/Settings/Sections/General/LanguageSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/General/LanguageSettings.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Configuration;
diff --git a/osu.Game/Overlays/Settings/Sections/General/UpdateSettings.cs b/osu.Game/Overlays/Settings/Sections/General/UpdateSettings.cs
index 5bc88b8692..b68a4fed48 100644
--- a/osu.Game/Overlays/Settings/Sections/General/UpdateSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/General/UpdateSettings.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.
 
+#nullable disable
+
 using System.Threading.Tasks;
 using osu.Framework;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Overlays/Settings/Sections/GeneralSection.cs b/osu.Game/Overlays/Settings/Sections/GeneralSection.cs
index ced3116728..59cbd8cd5a 100644
--- a/osu.Game/Overlays/Settings/Sections/GeneralSection.cs
+++ b/osu.Game/Overlays/Settings/Sections/GeneralSection.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Sprites;
diff --git a/osu.Game/Overlays/Settings/Sections/Graphics/LayoutSettings.cs b/osu.Game/Overlays/Settings/Sections/Graphics/LayoutSettings.cs
index 05890ad882..2c8e809379 100644
--- a/osu.Game/Overlays/Settings/Sections/Graphics/LayoutSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Graphics/LayoutSettings.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.
 
+#nullable disable
+
 using System;
 using System.Drawing;
 using System.Linq;
diff --git a/osu.Game/Overlays/Settings/Sections/Graphics/RendererSettings.cs b/osu.Game/Overlays/Settings/Sections/Graphics/RendererSettings.cs
index 5ba8e724cf..2e15172e46 100644
--- a/osu.Game/Overlays/Settings/Sections/Graphics/RendererSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Graphics/RendererSettings.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Configuration;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Overlays/Settings/Sections/Graphics/ScreenshotSettings.cs b/osu.Game/Overlays/Settings/Sections/Graphics/ScreenshotSettings.cs
index dbb9ddc1c1..7f88cc23d2 100644
--- a/osu.Game/Overlays/Settings/Sections/Graphics/ScreenshotSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Graphics/ScreenshotSettings.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Localisation;
diff --git a/osu.Game/Overlays/Settings/Sections/Graphics/VideoSettings.cs b/osu.Game/Overlays/Settings/Sections/Graphics/VideoSettings.cs
index 921eab63ed..56d0a6421b 100644
--- a/osu.Game/Overlays/Settings/Sections/Graphics/VideoSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Graphics/VideoSettings.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Configuration;
diff --git a/osu.Game/Overlays/Settings/Sections/GraphicsSection.cs b/osu.Game/Overlays/Settings/Sections/GraphicsSection.cs
index 8cd3b841c2..e094e0e051 100644
--- a/osu.Game/Overlays/Settings/Sections/GraphicsSection.cs
+++ b/osu.Game/Overlays/Settings/Sections/GraphicsSection.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Localisation;
diff --git a/osu.Game/Overlays/Settings/Sections/Input/BindingSettings.cs b/osu.Game/Overlays/Settings/Sections/Input/BindingSettings.cs
index 3227decc46..b92746a65a 100644
--- a/osu.Game/Overlays/Settings/Sections/Input/BindingSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Input/BindingSettings.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Localisation;
 using osu.Game.Localisation;
diff --git a/osu.Game/Overlays/Settings/Sections/Input/GlobalKeyBindingsSection.cs b/osu.Game/Overlays/Settings/Sections/Input/GlobalKeyBindingsSection.cs
index 3350ff4eaa..a2e07065f1 100644
--- a/osu.Game/Overlays/Settings/Sections/Input/GlobalKeyBindingsSection.cs
+++ b/osu.Game/Overlays/Settings/Sections/Input/GlobalKeyBindingsSection.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Localisation;
diff --git a/osu.Game/Overlays/Settings/Sections/Input/JoystickSettings.cs b/osu.Game/Overlays/Settings/Sections/Input/JoystickSettings.cs
index 60849cd6d4..34be846595 100644
--- a/osu.Game/Overlays/Settings/Sections/Input/JoystickSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Input/JoystickSettings.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Overlays/Settings/Sections/Input/KeyBindingPanel.cs b/osu.Game/Overlays/Settings/Sections/Input/KeyBindingPanel.cs
index 67f1bb8d3e..0830241f2b 100644
--- a/osu.Game/Overlays/Settings/Sections/Input/KeyBindingPanel.cs
+++ b/osu.Game/Overlays/Settings/Sections/Input/KeyBindingPanel.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Game.Input.Bindings;
diff --git a/osu.Game/Overlays/Settings/Sections/Input/KeyBindingRow.cs b/osu.Game/Overlays/Settings/Sections/Input/KeyBindingRow.cs
index 7312748435..9ff47578e9 100644
--- a/osu.Game/Overlays/Settings/Sections/Input/KeyBindingRow.cs
+++ b/osu.Game/Overlays/Settings/Sections/Input/KeyBindingRow.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Overlays/Settings/Sections/Input/KeyBindingsSubsection.cs b/osu.Game/Overlays/Settings/Sections/Input/KeyBindingsSubsection.cs
index 297af35fb5..628fe08607 100644
--- a/osu.Game/Overlays/Settings/Sections/Input/KeyBindingsSubsection.cs
+++ b/osu.Game/Overlays/Settings/Sections/Input/KeyBindingsSubsection.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Overlays/Settings/Sections/Input/MouseSettings.cs b/osu.Game/Overlays/Settings/Sections/Input/MouseSettings.cs
index 1511d53b6b..303fb79d16 100644
--- a/osu.Game/Overlays/Settings/Sections/Input/MouseSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Input/MouseSettings.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.
 
+#nullable disable
+
 using osu.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Overlays/Settings/Sections/Input/RotationPresetButtons.cs b/osu.Game/Overlays/Settings/Sections/Input/RotationPresetButtons.cs
index dbdf600002..2172dc175e 100644
--- a/osu.Game/Overlays/Settings/Sections/Input/RotationPresetButtons.cs
+++ b/osu.Game/Overlays/Settings/Sections/Input/RotationPresetButtons.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Overlays/Settings/Sections/Input/RulesetBindingsSection.cs b/osu.Game/Overlays/Settings/Sections/Input/RulesetBindingsSection.cs
index dae276c711..6f3127a377 100644
--- a/osu.Game/Overlays/Settings/Sections/Input/RulesetBindingsSection.cs
+++ b/osu.Game/Overlays/Settings/Sections/Input/RulesetBindingsSection.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.
 
+#nullable disable
+
 using System.Diagnostics;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Sprites;
diff --git a/osu.Game/Overlays/Settings/Sections/Input/TabletAreaSelection.cs b/osu.Game/Overlays/Settings/Sections/Input/TabletAreaSelection.cs
index 58abfab29c..cd6554e52d 100644
--- a/osu.Game/Overlays/Settings/Sections/Input/TabletAreaSelection.cs
+++ b/osu.Game/Overlays/Settings/Sections/Input/TabletAreaSelection.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Overlays/Settings/Sections/Input/TabletSettings.cs b/osu.Game/Overlays/Settings/Sections/Input/TabletSettings.cs
index 5d31c38ae7..271438ed14 100644
--- a/osu.Game/Overlays/Settings/Sections/Input/TabletSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Input/TabletSettings.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.
 
+#nullable disable
+
 using osu.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Overlays/Settings/Sections/Input/VariantBindingsSubsection.cs b/osu.Game/Overlays/Settings/Sections/Input/VariantBindingsSubsection.cs
index a0f069b3bb..23f91fba4b 100644
--- a/osu.Game/Overlays/Settings/Sections/Input/VariantBindingsSubsection.cs
+++ b/osu.Game/Overlays/Settings/Sections/Input/VariantBindingsSubsection.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.
 
+#nullable disable
+
 using osu.Framework.Localisation;
 using osu.Game.Rulesets;
 
diff --git a/osu.Game/Overlays/Settings/Sections/InputSection.cs b/osu.Game/Overlays/Settings/Sections/InputSection.cs
index d2c5d2fcf7..9a4a2ddb57 100644
--- a/osu.Game/Overlays/Settings/Sections/InputSection.cs
+++ b/osu.Game/Overlays/Settings/Sections/InputSection.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Sprites;
diff --git a/osu.Game/Overlays/Settings/Sections/Maintenance/DirectorySelectScreen.cs b/osu.Game/Overlays/Settings/Sections/Maintenance/DirectorySelectScreen.cs
index c7fd248842..1c9a758c6f 100644
--- a/osu.Game/Overlays/Settings/Sections/Maintenance/DirectorySelectScreen.cs
+++ b/osu.Game/Overlays/Settings/Sections/Maintenance/DirectorySelectScreen.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using System.IO;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Overlays/Settings/Sections/Maintenance/GeneralSettings.cs b/osu.Game/Overlays/Settings/Sections/Maintenance/GeneralSettings.cs
index 054de8dbd7..916c607c1c 100644
--- a/osu.Game/Overlays/Settings/Sections/Maintenance/GeneralSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Maintenance/GeneralSettings.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.
 
+#nullable disable
+
 using System.Threading.Tasks;
 using JetBrains.Annotations;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Overlays/Settings/Sections/Maintenance/MassDeleteConfirmationDialog.cs b/osu.Game/Overlays/Settings/Sections/Maintenance/MassDeleteConfirmationDialog.cs
index c481c80d82..526c096493 100644
--- a/osu.Game/Overlays/Settings/Sections/Maintenance/MassDeleteConfirmationDialog.cs
+++ b/osu.Game/Overlays/Settings/Sections/Maintenance/MassDeleteConfirmationDialog.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Graphics.Sprites;
 using osu.Game.Overlays.Dialog;
diff --git a/osu.Game/Overlays/Settings/Sections/Maintenance/MassVideoDeleteConfirmationDialog.cs b/osu.Game/Overlays/Settings/Sections/Maintenance/MassVideoDeleteConfirmationDialog.cs
index fc8c9d497b..e3870bc76a 100644
--- a/osu.Game/Overlays/Settings/Sections/Maintenance/MassVideoDeleteConfirmationDialog.cs
+++ b/osu.Game/Overlays/Settings/Sections/Maintenance/MassVideoDeleteConfirmationDialog.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.
 
+#nullable disable
+
 using System;
 
 namespace osu.Game.Overlays.Settings.Sections.Maintenance
diff --git a/osu.Game/Overlays/Settings/Sections/Maintenance/MigrationRunScreen.cs b/osu.Game/Overlays/Settings/Sections/Maintenance/MigrationRunScreen.cs
index b7b797936e..d565576d09 100644
--- a/osu.Game/Overlays/Settings/Sections/Maintenance/MigrationRunScreen.cs
+++ b/osu.Game/Overlays/Settings/Sections/Maintenance/MigrationRunScreen.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.
 
+#nullable disable
+
 using System.IO;
 using System.Threading.Tasks;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Overlays/Settings/Sections/Maintenance/MigrationSelectScreen.cs b/osu.Game/Overlays/Settings/Sections/Maintenance/MigrationSelectScreen.cs
index 3cb5521e51..7e6341cd1b 100644
--- a/osu.Game/Overlays/Settings/Sections/Maintenance/MigrationSelectScreen.cs
+++ b/osu.Game/Overlays/Settings/Sections/Maintenance/MigrationSelectScreen.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.
 
+#nullable disable
+
 using System;
 using System.IO;
 using System.Linq;
diff --git a/osu.Game/Overlays/Settings/Sections/Maintenance/StableDirectoryLocationDialog.cs b/osu.Game/Overlays/Settings/Sections/Maintenance/StableDirectoryLocationDialog.cs
index b16fd9a5a1..8aff4520b5 100644
--- a/osu.Game/Overlays/Settings/Sections/Maintenance/StableDirectoryLocationDialog.cs
+++ b/osu.Game/Overlays/Settings/Sections/Maintenance/StableDirectoryLocationDialog.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.
 
+#nullable disable
+
 using System.Threading.Tasks;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics.Sprites;
diff --git a/osu.Game/Overlays/Settings/Sections/Maintenance/StableDirectorySelectScreen.cs b/osu.Game/Overlays/Settings/Sections/Maintenance/StableDirectorySelectScreen.cs
index 86934ae514..047d589689 100644
--- a/osu.Game/Overlays/Settings/Sections/Maintenance/StableDirectorySelectScreen.cs
+++ b/osu.Game/Overlays/Settings/Sections/Maintenance/StableDirectorySelectScreen.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.
 
+#nullable disable
+
 using System.IO;
 using System.Linq;
 using System.Threading.Tasks;
diff --git a/osu.Game/Overlays/Settings/Sections/MaintenanceSection.cs b/osu.Game/Overlays/Settings/Sections/MaintenanceSection.cs
index 9410a87848..cfe1961bc1 100644
--- a/osu.Game/Overlays/Settings/Sections/MaintenanceSection.cs
+++ b/osu.Game/Overlays/Settings/Sections/MaintenanceSection.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Localisation;
diff --git a/osu.Game/Overlays/Settings/Sections/Online/AlertsAndPrivacySettings.cs b/osu.Game/Overlays/Settings/Sections/Online/AlertsAndPrivacySettings.cs
index 351a32c72e..529f1b5ee4 100644
--- a/osu.Game/Overlays/Settings/Sections/Online/AlertsAndPrivacySettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Online/AlertsAndPrivacySettings.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Localisation;
diff --git a/osu.Game/Overlays/Settings/Sections/Online/IntegrationSettings.cs b/osu.Game/Overlays/Settings/Sections/Online/IntegrationSettings.cs
index 0207f2fd01..17228d6359 100644
--- a/osu.Game/Overlays/Settings/Sections/Online/IntegrationSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Online/IntegrationSettings.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Localisation;
diff --git a/osu.Game/Overlays/Settings/Sections/Online/WebSettings.cs b/osu.Game/Overlays/Settings/Sections/Online/WebSettings.cs
index e864260cc6..ba707e2145 100644
--- a/osu.Game/Overlays/Settings/Sections/Online/WebSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Online/WebSettings.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Localisation;
diff --git a/osu.Game/Overlays/Settings/Sections/OnlineSection.cs b/osu.Game/Overlays/Settings/Sections/OnlineSection.cs
index 8b523b90b9..feb281f1b8 100644
--- a/osu.Game/Overlays/Settings/Sections/OnlineSection.cs
+++ b/osu.Game/Overlays/Settings/Sections/OnlineSection.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Localisation;
diff --git a/osu.Game/Overlays/Settings/Sections/RulesetSection.cs b/osu.Game/Overlays/Settings/Sections/RulesetSection.cs
index b9339d5299..2368459b4e 100644
--- a/osu.Game/Overlays/Settings/Sections/RulesetSection.cs
+++ b/osu.Game/Overlays/Settings/Sections/RulesetSection.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Overlays/Settings/Sections/SizeSlider.cs b/osu.Game/Overlays/Settings/Sections/SizeSlider.cs
index c8a46162af..28b4cd6418 100644
--- a/osu.Game/Overlays/Settings/Sections/SizeSlider.cs
+++ b/osu.Game/Overlays/Settings/Sections/SizeSlider.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.
 
+#nullable disable
+
 using System;
 using System.Globalization;
 using osu.Framework.Localisation;
diff --git a/osu.Game/Overlays/Settings/Sections/SkinSection.cs b/osu.Game/Overlays/Settings/Sections/SkinSection.cs
index b83600a16d..6494b59b09 100644
--- a/osu.Game/Overlays/Settings/Sections/SkinSection.cs
+++ b/osu.Game/Overlays/Settings/Sections/SkinSection.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Overlays/Settings/Sections/UserInterface/GeneralSettings.cs b/osu.Game/Overlays/Settings/Sections/UserInterface/GeneralSettings.cs
index dd1b9cc2a0..85cfdb33d5 100644
--- a/osu.Game/Overlays/Settings/Sections/UserInterface/GeneralSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/UserInterface/GeneralSettings.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Localisation;
diff --git a/osu.Game/Overlays/Settings/Sections/UserInterface/MainMenuSettings.cs b/osu.Game/Overlays/Settings/Sections/UserInterface/MainMenuSettings.cs
index fceffa09c5..7ca45bb6b8 100644
--- a/osu.Game/Overlays/Settings/Sections/UserInterface/MainMenuSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/UserInterface/MainMenuSettings.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Overlays/Settings/Sections/UserInterface/SongSelectSettings.cs b/osu.Game/Overlays/Settings/Sections/UserInterface/SongSelectSettings.cs
index b91b5c5243..8cec7bbb30 100644
--- a/osu.Game/Overlays/Settings/Sections/UserInterface/SongSelectSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/UserInterface/SongSelectSettings.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Overlays/Settings/Sections/UserInterfaceSection.cs b/osu.Game/Overlays/Settings/Sections/UserInterfaceSection.cs
index 6228c4c99a..b2711af612 100644
--- a/osu.Game/Overlays/Settings/Sections/UserInterfaceSection.cs
+++ b/osu.Game/Overlays/Settings/Sections/UserInterfaceSection.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Localisation;
diff --git a/osu.Game/Overlays/Settings/SettingsButton.cs b/osu.Game/Overlays/Settings/SettingsButton.cs
index 9e4dc763ec..5f2a416f58 100644
--- a/osu.Game/Overlays/Settings/SettingsButton.cs
+++ b/osu.Game/Overlays/Settings/SettingsButton.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using JetBrains.Annotations;
diff --git a/osu.Game/Overlays/Settings/SettingsCheckbox.cs b/osu.Game/Overlays/Settings/SettingsCheckbox.cs
index 8a8fed4d30..efe7fb6d9e 100644
--- a/osu.Game/Overlays/Settings/SettingsCheckbox.cs
+++ b/osu.Game/Overlays/Settings/SettingsCheckbox.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Localisation;
 using osu.Game.Graphics.UserInterface;
diff --git a/osu.Game/Overlays/Settings/SettingsDropdown.cs b/osu.Game/Overlays/Settings/SettingsDropdown.cs
index 3c10c084ab..347ef03b42 100644
--- a/osu.Game/Overlays/Settings/SettingsDropdown.cs
+++ b/osu.Game/Overlays/Settings/SettingsDropdown.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Overlays/Settings/SettingsEnumDropdown.cs b/osu.Game/Overlays/Settings/SettingsEnumDropdown.cs
index 199ba14b48..9408e4a9ce 100644
--- a/osu.Game/Overlays/Settings/SettingsEnumDropdown.cs
+++ b/osu.Game/Overlays/Settings/SettingsEnumDropdown.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Graphics;
 using osu.Game.Graphics.UserInterface;
diff --git a/osu.Game/Overlays/Settings/SettingsFooter.cs b/osu.Game/Overlays/Settings/SettingsFooter.cs
index 263f2f4829..2f182d537f 100644
--- a/osu.Game/Overlays/Settings/SettingsFooter.cs
+++ b/osu.Game/Overlays/Settings/SettingsFooter.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Framework.Allocation;
 using osu.Framework.Development;
diff --git a/osu.Game/Overlays/Settings/SettingsHeader.cs b/osu.Game/Overlays/Settings/SettingsHeader.cs
index f9ee8df0bd..56360fc4a1 100644
--- a/osu.Game/Overlays/Settings/SettingsHeader.cs
+++ b/osu.Game/Overlays/Settings/SettingsHeader.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Overlays/Settings/SettingsItem.cs b/osu.Game/Overlays/Settings/SettingsItem.cs
index ea076b77ac..c34964fa96 100644
--- a/osu.Game/Overlays/Settings/SettingsItem.cs
+++ b/osu.Game/Overlays/Settings/SettingsItem.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Overlays/Settings/SettingsNumberBox.cs b/osu.Game/Overlays/Settings/SettingsNumberBox.cs
index d931c53e73..4f98954289 100644
--- a/osu.Game/Overlays/Settings/SettingsNumberBox.cs
+++ b/osu.Game/Overlays/Settings/SettingsNumberBox.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.
 
+#nullable disable
+
 using osu.Framework.Bindables;
 using osu.Framework.Extensions;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Overlays/Settings/SettingsSection.cs b/osu.Game/Overlays/Settings/SettingsSection.cs
index da596e4d9d..dfdc850ed8 100644
--- a/osu.Game/Overlays/Settings/SettingsSection.cs
+++ b/osu.Game/Overlays/Settings/SettingsSection.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Diagnostics;
 using System.Linq;
diff --git a/osu.Game/Overlays/Settings/SettingsSidebar.cs b/osu.Game/Overlays/Settings/SettingsSidebar.cs
index 4e6a1eb914..ca6bcae6e4 100644
--- a/osu.Game/Overlays/Settings/SettingsSidebar.cs
+++ b/osu.Game/Overlays/Settings/SettingsSidebar.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Shapes;
diff --git a/osu.Game/Overlays/Settings/SettingsSlider.cs b/osu.Game/Overlays/Settings/SettingsSlider.cs
index b95b0af11c..43f007f201 100644
--- a/osu.Game/Overlays/Settings/SettingsSlider.cs
+++ b/osu.Game/Overlays/Settings/SettingsSlider.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.UserInterface;
diff --git a/osu.Game/Overlays/Settings/SettingsSubsection.cs b/osu.Game/Overlays/Settings/SettingsSubsection.cs
index 21391d5ccf..72788c55cd 100644
--- a/osu.Game/Overlays/Settings/SettingsSubsection.cs
+++ b/osu.Game/Overlays/Settings/SettingsSubsection.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.
 
+#nullable disable
+
 using osuTK;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Overlays/Settings/SettingsTextBox.cs b/osu.Game/Overlays/Settings/SettingsTextBox.cs
index a724003183..4d0f4253eb 100644
--- a/osu.Game/Overlays/Settings/SettingsTextBox.cs
+++ b/osu.Game/Overlays/Settings/SettingsTextBox.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Overlays/Settings/SidebarButton.cs b/osu.Game/Overlays/Settings/SidebarButton.cs
index 1a34143e1f..c6a4cbbcaa 100644
--- a/osu.Game/Overlays/Settings/SidebarButton.cs
+++ b/osu.Game/Overlays/Settings/SidebarButton.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Input.Events;
 using osu.Game.Graphics.UserInterface;
diff --git a/osu.Game/Overlays/Settings/SidebarIconButton.cs b/osu.Game/Overlays/Settings/SidebarIconButton.cs
index 6f3d3d5d52..b32337eb2e 100644
--- a/osu.Game/Overlays/Settings/SidebarIconButton.cs
+++ b/osu.Game/Overlays/Settings/SidebarIconButton.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.
 
+#nullable disable
+
 using osuTK;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Overlays/SettingsOverlay.cs b/osu.Game/Overlays/SettingsOverlay.cs
index 7cd8fc6d66..b28ac4ab8b 100644
--- a/osu.Game/Overlays/SettingsOverlay.cs
+++ b/osu.Game/Overlays/SettingsOverlay.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Overlays/SettingsPanel.cs b/osu.Game/Overlays/SettingsPanel.cs
index a5a6f9bce7..eb457032ea 100644
--- a/osu.Game/Overlays/SettingsPanel.cs
+++ b/osu.Game/Overlays/SettingsPanel.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Overlays/SettingsSubPanel.cs b/osu.Game/Overlays/SettingsSubPanel.cs
index d55c609d3f..4548cdfb5d 100644
--- a/osu.Game/Overlays/SettingsSubPanel.cs
+++ b/osu.Game/Overlays/SettingsSubPanel.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Overlays/SettingsToolboxGroup.cs b/osu.Game/Overlays/SettingsToolboxGroup.cs
index 077762c0d0..548d75c9a9 100644
--- a/osu.Game/Overlays/SettingsToolboxGroup.cs
+++ b/osu.Game/Overlays/SettingsToolboxGroup.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.
 
+#nullable disable
+
 using osu.Framework.Bindables;
 using osu.Framework.Caching;
 using osu.Framework.Extensions.EnumExtensions;
diff --git a/osu.Game/Overlays/SortDirection.cs b/osu.Game/Overlays/SortDirection.cs
index 3af9614972..98ac31103f 100644
--- a/osu.Game/Overlays/SortDirection.cs
+++ b/osu.Game/Overlays/SortDirection.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.
 
+#nullable disable
+
 namespace osu.Game.Overlays
 {
     public enum SortDirection
diff --git a/osu.Game/Overlays/TabControlOverlayHeader.cs b/osu.Game/Overlays/TabControlOverlayHeader.cs
index 1b0bd658d9..4e32afb86f 100644
--- a/osu.Game/Overlays/TabControlOverlayHeader.cs
+++ b/osu.Game/Overlays/TabControlOverlayHeader.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.
 
+#nullable disable
+
 using System;
 using JetBrains.Annotations;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Overlays/TabbableOnlineOverlay.cs b/osu.Game/Overlays/TabbableOnlineOverlay.cs
index 9ceab12d3d..a99be4cc18 100644
--- a/osu.Game/Overlays/TabbableOnlineOverlay.cs
+++ b/osu.Game/Overlays/TabbableOnlineOverlay.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.
 
+#nullable disable
+
 using System.Threading;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Overlays/Toolbar/AnalogClockDisplay.cs b/osu.Game/Overlays/Toolbar/AnalogClockDisplay.cs
index 9228900e99..477991f599 100644
--- a/osu.Game/Overlays/Toolbar/AnalogClockDisplay.cs
+++ b/osu.Game/Overlays/Toolbar/AnalogClockDisplay.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Overlays/Toolbar/ClockDisplay.cs b/osu.Game/Overlays/Toolbar/ClockDisplay.cs
index c1befbb198..0711341445 100644
--- a/osu.Game/Overlays/Toolbar/ClockDisplay.cs
+++ b/osu.Game/Overlays/Toolbar/ClockDisplay.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Graphics.Containers;
 
diff --git a/osu.Game/Overlays/Toolbar/DigitalClockDisplay.cs b/osu.Game/Overlays/Toolbar/DigitalClockDisplay.cs
index ac6f563336..5592590fd9 100644
--- a/osu.Game/Overlays/Toolbar/DigitalClockDisplay.cs
+++ b/osu.Game/Overlays/Toolbar/DigitalClockDisplay.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Overlays/Toolbar/Toolbar.cs b/osu.Game/Overlays/Toolbar/Toolbar.cs
index 1e21e7e16c..82fa20aa9c 100644
--- a/osu.Game/Overlays/Toolbar/Toolbar.cs
+++ b/osu.Game/Overlays/Toolbar/Toolbar.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Overlays/Toolbar/ToolbarBeatmapListingButton.cs b/osu.Game/Overlays/Toolbar/ToolbarBeatmapListingButton.cs
index bfe36a6a0f..a2de186488 100644
--- a/osu.Game/Overlays/Toolbar/ToolbarBeatmapListingButton.cs
+++ b/osu.Game/Overlays/Toolbar/ToolbarBeatmapListingButton.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Game.Input.Bindings;
diff --git a/osu.Game/Overlays/Toolbar/ToolbarButton.cs b/osu.Game/Overlays/Toolbar/ToolbarButton.cs
index b2b80f0e05..96d4da1112 100644
--- a/osu.Game/Overlays/Toolbar/ToolbarButton.cs
+++ b/osu.Game/Overlays/Toolbar/ToolbarButton.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.
 
+#nullable disable
+
 using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.Color4Extensions;
diff --git a/osu.Game/Overlays/Toolbar/ToolbarChangelogButton.cs b/osu.Game/Overlays/Toolbar/ToolbarChangelogButton.cs
index 86bc73361a..5ce6387196 100644
--- a/osu.Game/Overlays/Toolbar/ToolbarChangelogButton.cs
+++ b/osu.Game/Overlays/Toolbar/ToolbarChangelogButton.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 
diff --git a/osu.Game/Overlays/Toolbar/ToolbarChatButton.cs b/osu.Game/Overlays/Toolbar/ToolbarChatButton.cs
index 2d3b33e9bc..86f87deabd 100644
--- a/osu.Game/Overlays/Toolbar/ToolbarChatButton.cs
+++ b/osu.Game/Overlays/Toolbar/ToolbarChatButton.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Game.Input.Bindings;
diff --git a/osu.Game/Overlays/Toolbar/ToolbarClock.cs b/osu.Game/Overlays/Toolbar/ToolbarClock.cs
index 12529da07f..c5add6eee2 100644
--- a/osu.Game/Overlays/Toolbar/ToolbarClock.cs
+++ b/osu.Game/Overlays/Toolbar/ToolbarClock.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Extensions.Color4Extensions;
diff --git a/osu.Game/Overlays/Toolbar/ToolbarHomeButton.cs b/osu.Game/Overlays/Toolbar/ToolbarHomeButton.cs
index 76fbd40d66..f170ec84ac 100644
--- a/osu.Game/Overlays/Toolbar/ToolbarHomeButton.cs
+++ b/osu.Game/Overlays/Toolbar/ToolbarHomeButton.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Game.Input.Bindings;
 
diff --git a/osu.Game/Overlays/Toolbar/ToolbarMusicButton.cs b/osu.Game/Overlays/Toolbar/ToolbarMusicButton.cs
index 9590c1aa3b..bd56c60582 100644
--- a/osu.Game/Overlays/Toolbar/ToolbarMusicButton.cs
+++ b/osu.Game/Overlays/Toolbar/ToolbarMusicButton.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Overlays/Toolbar/ToolbarNewsButton.cs b/osu.Game/Overlays/Toolbar/ToolbarNewsButton.cs
index 9b2573ad07..286cfa20f0 100644
--- a/osu.Game/Overlays/Toolbar/ToolbarNewsButton.cs
+++ b/osu.Game/Overlays/Toolbar/ToolbarNewsButton.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 
diff --git a/osu.Game/Overlays/Toolbar/ToolbarNotificationButton.cs b/osu.Game/Overlays/Toolbar/ToolbarNotificationButton.cs
index 313a2bc3f4..265eb044e0 100644
--- a/osu.Game/Overlays/Toolbar/ToolbarNotificationButton.cs
+++ b/osu.Game/Overlays/Toolbar/ToolbarNotificationButton.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Overlays/Toolbar/ToolbarOverlayToggleButton.cs b/osu.Game/Overlays/Toolbar/ToolbarOverlayToggleButton.cs
index 0dea71cc08..03c365e49e 100644
--- a/osu.Game/Overlays/Toolbar/ToolbarOverlayToggleButton.cs
+++ b/osu.Game/Overlays/Toolbar/ToolbarOverlayToggleButton.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.
 
+#nullable disable
+
 using osu.Framework.Bindables;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Overlays/Toolbar/ToolbarRankingsButton.cs b/osu.Game/Overlays/Toolbar/ToolbarRankingsButton.cs
index 312fc41aab..1bda6da419 100644
--- a/osu.Game/Overlays/Toolbar/ToolbarRankingsButton.cs
+++ b/osu.Game/Overlays/Toolbar/ToolbarRankingsButton.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 
diff --git a/osu.Game/Overlays/Toolbar/ToolbarRulesetSelector.cs b/osu.Game/Overlays/Toolbar/ToolbarRulesetSelector.cs
index 6e5fbf6efb..1ca492f81a 100644
--- a/osu.Game/Overlays/Toolbar/ToolbarRulesetSelector.cs
+++ b/osu.Game/Overlays/Toolbar/ToolbarRulesetSelector.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Overlays/Toolbar/ToolbarRulesetTabButton.cs b/osu.Game/Overlays/Toolbar/ToolbarRulesetTabButton.cs
index a70a0d8a71..31c6802fda 100644
--- a/osu.Game/Overlays/Toolbar/ToolbarRulesetTabButton.cs
+++ b/osu.Game/Overlays/Toolbar/ToolbarRulesetTabButton.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.
 
+#nullable disable
+
 using osu.Framework.Graphics.Effects;
 using osu.Framework.Graphics.UserInterface;
 using osu.Game.Rulesets;
diff --git a/osu.Game/Overlays/Toolbar/ToolbarSettingsButton.cs b/osu.Game/Overlays/Toolbar/ToolbarSettingsButton.cs
index c53f4a55d9..c3d48bc60e 100644
--- a/osu.Game/Overlays/Toolbar/ToolbarSettingsButton.cs
+++ b/osu.Game/Overlays/Toolbar/ToolbarSettingsButton.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Game.Input.Bindings;
 
diff --git a/osu.Game/Overlays/Toolbar/ToolbarSocialButton.cs b/osu.Game/Overlays/Toolbar/ToolbarSocialButton.cs
index 1e00afc5fd..f8ee39d56e 100644
--- a/osu.Game/Overlays/Toolbar/ToolbarSocialButton.cs
+++ b/osu.Game/Overlays/Toolbar/ToolbarSocialButton.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Game.Input.Bindings;
diff --git a/osu.Game/Overlays/Toolbar/ToolbarUserButton.cs b/osu.Game/Overlays/Toolbar/ToolbarUserButton.cs
index d8ba07dc3b..a93ba17c5b 100644
--- a/osu.Game/Overlays/Toolbar/ToolbarUserButton.cs
+++ b/osu.Game/Overlays/Toolbar/ToolbarUserButton.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Extensions.Color4Extensions;
diff --git a/osu.Game/Overlays/Toolbar/ToolbarWikiButton.cs b/osu.Game/Overlays/Toolbar/ToolbarWikiButton.cs
index a521219b4f..5511902fa8 100644
--- a/osu.Game/Overlays/Toolbar/ToolbarWikiButton.cs
+++ b/osu.Game/Overlays/Toolbar/ToolbarWikiButton.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 
diff --git a/osu.Game/Overlays/UserProfileOverlay.cs b/osu.Game/Overlays/UserProfileOverlay.cs
index 518a2bf9c8..c0ca63bbd9 100644
--- a/osu.Game/Overlays/UserProfileOverlay.cs
+++ b/osu.Game/Overlays/UserProfileOverlay.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Overlays/VersionManager.cs b/osu.Game/Overlays/VersionManager.cs
index fe6613fba2..a1cfdf4594 100644
--- a/osu.Game/Overlays/VersionManager.cs
+++ b/osu.Game/Overlays/VersionManager.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Development;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Overlays/Volume/MuteButton.cs b/osu.Game/Overlays/Volume/MuteButton.cs
index e9d3b31207..744b2bafbd 100644
--- a/osu.Game/Overlays/Volume/MuteButton.cs
+++ b/osu.Game/Overlays/Volume/MuteButton.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Overlays/Volume/VolumeControlReceptor.cs b/osu.Game/Overlays/Volume/VolumeControlReceptor.cs
index c601ce4130..f2b637c104 100644
--- a/osu.Game/Overlays/Volume/VolumeControlReceptor.cs
+++ b/osu.Game/Overlays/Volume/VolumeControlReceptor.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Input;
diff --git a/osu.Game/Overlays/Volume/VolumeMeter.cs b/osu.Game/Overlays/Volume/VolumeMeter.cs
index 24d9f785f2..e01890ddc2 100644
--- a/osu.Game/Overlays/Volume/VolumeMeter.cs
+++ b/osu.Game/Overlays/Volume/VolumeMeter.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.
 
+#nullable disable
+
 using System;
 using System.Globalization;
 using osu.Framework;
diff --git a/osu.Game/Overlays/VolumeOverlay.cs b/osu.Game/Overlays/VolumeOverlay.cs
index 46ea45491e..4cedd87eac 100644
--- a/osu.Game/Overlays/VolumeOverlay.cs
+++ b/osu.Game/Overlays/VolumeOverlay.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Overlays/WaveOverlayContainer.cs b/osu.Game/Overlays/WaveOverlayContainer.cs
index 52ae4dbdbb..faf2cca8cf 100644
--- a/osu.Game/Overlays/WaveOverlayContainer.cs
+++ b/osu.Game/Overlays/WaveOverlayContainer.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.
 
+#nullable disable
+
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics;
 using osu.Game.Graphics.Containers;
diff --git a/osu.Game/Overlays/Wiki/Markdown/WikiMarkdownContainer.cs b/osu.Game/Overlays/Wiki/Markdown/WikiMarkdownContainer.cs
index 789ed457a4..7754c1d450 100644
--- a/osu.Game/Overlays/Wiki/Markdown/WikiMarkdownContainer.cs
+++ b/osu.Game/Overlays/Wiki/Markdown/WikiMarkdownContainer.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.
 
+#nullable disable
+
 using System.Linq;
 using Markdig.Extensions.Yaml;
 using Markdig.Syntax;
diff --git a/osu.Game/Overlays/Wiki/Markdown/WikiMarkdownImage.cs b/osu.Game/Overlays/Wiki/Markdown/WikiMarkdownImage.cs
index 27d1fe9b2f..1c7a08930b 100644
--- a/osu.Game/Overlays/Wiki/Markdown/WikiMarkdownImage.cs
+++ b/osu.Game/Overlays/Wiki/Markdown/WikiMarkdownImage.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.
 
+#nullable disable
+
 using Markdig.Syntax.Inlines;
 using osu.Game.Graphics.Containers.Markdown;
 
diff --git a/osu.Game/Overlays/Wiki/Markdown/WikiMarkdownImageBlock.cs b/osu.Game/Overlays/Wiki/Markdown/WikiMarkdownImageBlock.cs
index 501e00bc00..5ce3f179a4 100644
--- a/osu.Game/Overlays/Wiki/Markdown/WikiMarkdownImageBlock.cs
+++ b/osu.Game/Overlays/Wiki/Markdown/WikiMarkdownImageBlock.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.
 
+#nullable disable
+
 using Markdig.Syntax.Inlines;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Overlays/Wiki/Markdown/WikiNoticeContainer.cs b/osu.Game/Overlays/Wiki/Markdown/WikiNoticeContainer.cs
index 11cab80a57..64d7e20d9b 100644
--- a/osu.Game/Overlays/Wiki/Markdown/WikiNoticeContainer.cs
+++ b/osu.Game/Overlays/Wiki/Markdown/WikiNoticeContainer.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.
 
+#nullable disable
+
 using Markdig.Extensions.Yaml;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Overlays/Wiki/WikiArticlePage.cs b/osu.Game/Overlays/Wiki/WikiArticlePage.cs
index 0061bff8ea..f4ba0a4d8d 100644
--- a/osu.Game/Overlays/Wiki/WikiArticlePage.cs
+++ b/osu.Game/Overlays/Wiki/WikiArticlePage.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.
 
+#nullable disable
+
 using System;
 using Markdig.Syntax;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Overlays/Wiki/WikiHeader.cs b/osu.Game/Overlays/Wiki/WikiHeader.cs
index 3e81d2cffe..fc8df03892 100644
--- a/osu.Game/Overlays/Wiki/WikiHeader.cs
+++ b/osu.Game/Overlays/Wiki/WikiHeader.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Overlays/Wiki/WikiMainPage.cs b/osu.Game/Overlays/Wiki/WikiMainPage.cs
index 9416ec77f1..67e4bdf2e5 100644
--- a/osu.Game/Overlays/Wiki/WikiMainPage.cs
+++ b/osu.Game/Overlays/Wiki/WikiMainPage.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Diagnostics;
 using System.Linq;
diff --git a/osu.Game/Overlays/Wiki/WikiPanelContainer.cs b/osu.Game/Overlays/Wiki/WikiPanelContainer.cs
index 7e7e005586..552770f098 100644
--- a/osu.Game/Overlays/Wiki/WikiPanelContainer.cs
+++ b/osu.Game/Overlays/Wiki/WikiPanelContainer.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.
 
+#nullable disable
+
 using System;
 using Markdig.Syntax;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Overlays/Wiki/WikiSidebar.cs b/osu.Game/Overlays/Wiki/WikiSidebar.cs
index da96885fb5..78ce9c8a24 100644
--- a/osu.Game/Overlays/Wiki/WikiSidebar.cs
+++ b/osu.Game/Overlays/Wiki/WikiSidebar.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.
 
+#nullable disable
+
 using Markdig.Syntax;
 using Markdig.Syntax.Inlines;
 using osu.Framework.Extensions.LocalisationExtensions;
diff --git a/osu.Game/Overlays/Wiki/WikiTableOfContents.cs b/osu.Game/Overlays/Wiki/WikiTableOfContents.cs
index c0615dce1f..d60d728aca 100644
--- a/osu.Game/Overlays/Wiki/WikiTableOfContents.cs
+++ b/osu.Game/Overlays/Wiki/WikiTableOfContents.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Overlays/WikiOverlay.cs b/osu.Game/Overlays/WikiOverlay.cs
index 4015d8e196..3c5cb82a88 100644
--- a/osu.Game/Overlays/WikiOverlay.cs
+++ b/osu.Game/Overlays/WikiOverlay.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using System.Threading;
diff --git a/osu.Game/PerformFromMenuRunner.cs b/osu.Game/PerformFromMenuRunner.cs
index ae9879fb5a..eae13fe5d0 100644
--- a/osu.Game/PerformFromMenuRunner.cs
+++ b/osu.Game/PerformFromMenuRunner.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Performance/HighPerformanceSession.cs b/osu.Game/Performance/HighPerformanceSession.cs
index 3ef0e0bf93..dd5de03077 100644
--- a/osu.Game/Performance/HighPerformanceSession.cs
+++ b/osu.Game/Performance/HighPerformanceSession.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Properties/AssemblyInfo.cs b/osu.Game/Properties/AssemblyInfo.cs
index 1b77e45891..dde1af6461 100644
--- a/osu.Game/Properties/AssemblyInfo.cs
+++ b/osu.Game/Properties/AssemblyInfo.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.
 
+#nullable disable
+
 using System.Runtime.CompilerServices;
 
 // We publish our internal attributes to other sub-projects of the framework.
diff --git a/osu.Game/Replays/Legacy/LegacyReplayFrame.cs b/osu.Game/Replays/Legacy/LegacyReplayFrame.cs
index f6abf259e8..d0574d65ab 100644
--- a/osu.Game/Replays/Legacy/LegacyReplayFrame.cs
+++ b/osu.Game/Replays/Legacy/LegacyReplayFrame.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.
 
+#nullable disable
+
 using MessagePack;
 using Newtonsoft.Json;
 using osu.Framework.Extensions.EnumExtensions;
diff --git a/osu.Game/Replays/Legacy/ReplayButtonState.cs b/osu.Game/Replays/Legacy/ReplayButtonState.cs
index 4b02cf2cd5..7788918ba9 100644
--- a/osu.Game/Replays/Legacy/ReplayButtonState.cs
+++ b/osu.Game/Replays/Legacy/ReplayButtonState.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.
 
+#nullable disable
+
 using System;
 
 namespace osu.Game.Replays.Legacy
diff --git a/osu.Game/Replays/Replay.cs b/osu.Game/Replays/Replay.cs
index 30e176b5c7..4903f8c47f 100644
--- a/osu.Game/Replays/Replay.cs
+++ b/osu.Game/Replays/Replay.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using osu.Game.Rulesets.Replays;
diff --git a/osu.Game/Rulesets/AssemblyRulesetStore.cs b/osu.Game/Rulesets/AssemblyRulesetStore.cs
index 7313a77aa5..03554ef2db 100644
--- a/osu.Game/Rulesets/AssemblyRulesetStore.cs
+++ b/osu.Game/Rulesets/AssemblyRulesetStore.cs
@@ -7,8 +7,6 @@ using System.Linq;
 using osu.Framework.Extensions.ObjectExtensions;
 using osu.Framework.Platform;
 
-#nullable enable
-
 namespace osu.Game.Rulesets
 {
     /// <summary>
diff --git a/osu.Game/Rulesets/Configuration/IRulesetConfigManager.cs b/osu.Game/Rulesets/Configuration/IRulesetConfigManager.cs
index 5a3ad5e786..af315bfb28 100644
--- a/osu.Game/Rulesets/Configuration/IRulesetConfigManager.cs
+++ b/osu.Game/Rulesets/Configuration/IRulesetConfigManager.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Configuration.Tracking;
 
diff --git a/osu.Game/Rulesets/Configuration/RulesetConfigManager.cs b/osu.Game/Rulesets/Configuration/RulesetConfigManager.cs
index 30bb95ba72..6c56f3a912 100644
--- a/osu.Game/Rulesets/Configuration/RulesetConfigManager.cs
+++ b/osu.Game/Rulesets/Configuration/RulesetConfigManager.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Rulesets/Difficulty/DifficultyAttributes.cs b/osu.Game/Rulesets/Difficulty/DifficultyAttributes.cs
index ec3d22b67a..e0844a5c8a 100644
--- a/osu.Game/Rulesets/Difficulty/DifficultyAttributes.cs
+++ b/osu.Game/Rulesets/Difficulty/DifficultyAttributes.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using Newtonsoft.Json;
diff --git a/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs b/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs
index b030c0c560..9c58a53b97 100644
--- a/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs
+++ b/osu.Game/Rulesets/Difficulty/DifficultyCalculator.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Rulesets/Difficulty/PerformanceAttributes.cs b/osu.Game/Rulesets/Difficulty/PerformanceAttributes.cs
index e8c4c71913..15b90e5147 100644
--- a/osu.Game/Rulesets/Difficulty/PerformanceAttributes.cs
+++ b/osu.Game/Rulesets/Difficulty/PerformanceAttributes.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using Newtonsoft.Json;
 
diff --git a/osu.Game/Rulesets/Difficulty/PerformanceBreakdown.cs b/osu.Game/Rulesets/Difficulty/PerformanceBreakdown.cs
index 273d8613c5..bd971db476 100644
--- a/osu.Game/Rulesets/Difficulty/PerformanceBreakdown.cs
+++ b/osu.Game/Rulesets/Difficulty/PerformanceBreakdown.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.
 
+#nullable disable
+
 namespace osu.Game.Rulesets.Difficulty
 {
     /// <summary>
diff --git a/osu.Game/Rulesets/Difficulty/PerformanceBreakdownCalculator.cs b/osu.Game/Rulesets/Difficulty/PerformanceBreakdownCalculator.cs
index 1e5dda253f..4465f1a328 100644
--- a/osu.Game/Rulesets/Difficulty/PerformanceBreakdownCalculator.cs
+++ b/osu.Game/Rulesets/Difficulty/PerformanceBreakdownCalculator.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using System.Threading;
diff --git a/osu.Game/Rulesets/Difficulty/PerformanceCalculator.cs b/osu.Game/Rulesets/Difficulty/PerformanceCalculator.cs
index 4c55249661..38a35ddb3b 100644
--- a/osu.Game/Rulesets/Difficulty/PerformanceCalculator.cs
+++ b/osu.Game/Rulesets/Difficulty/PerformanceCalculator.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.
 
+#nullable disable
+
 using osu.Game.Beatmaps;
 using osu.Game.Scoring;
 
diff --git a/osu.Game/Rulesets/Difficulty/PerformanceDisplayAttribute.cs b/osu.Game/Rulesets/Difficulty/PerformanceDisplayAttribute.cs
index 7958bc174e..76dfca3db7 100644
--- a/osu.Game/Rulesets/Difficulty/PerformanceDisplayAttribute.cs
+++ b/osu.Game/Rulesets/Difficulty/PerformanceDisplayAttribute.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.
 
+#nullable disable
+
 namespace osu.Game.Rulesets.Difficulty
 {
     /// <summary>
diff --git a/osu.Game/Rulesets/Difficulty/Preprocessing/DifficultyHitObject.cs b/osu.Game/Rulesets/Difficulty/Preprocessing/DifficultyHitObject.cs
index 5a2a40e241..9ce0906dea 100644
--- a/osu.Game/Rulesets/Difficulty/Preprocessing/DifficultyHitObject.cs
+++ b/osu.Game/Rulesets/Difficulty/Preprocessing/DifficultyHitObject.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using osu.Game.Rulesets.Objects;
diff --git a/osu.Game/Rulesets/Difficulty/Skills/Skill.cs b/osu.Game/Rulesets/Difficulty/Skills/Skill.cs
index 770754f304..44abbaaf41 100644
--- a/osu.Game/Rulesets/Difficulty/Skills/Skill.cs
+++ b/osu.Game/Rulesets/Difficulty/Skills/Skill.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Game.Rulesets.Difficulty.Preprocessing;
 using osu.Game.Rulesets.Mods;
diff --git a/osu.Game/Rulesets/Difficulty/Skills/StrainDecaySkill.cs b/osu.Game/Rulesets/Difficulty/Skills/StrainDecaySkill.cs
index 3f3d57938b..6abde64eb7 100644
--- a/osu.Game/Rulesets/Difficulty/Skills/StrainDecaySkill.cs
+++ b/osu.Game/Rulesets/Difficulty/Skills/StrainDecaySkill.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.
 
+#nullable disable
+
 using System;
 using osu.Game.Rulesets.Difficulty.Preprocessing;
 using osu.Game.Rulesets.Mods;
diff --git a/osu.Game/Rulesets/Difficulty/Skills/StrainSkill.cs b/osu.Game/Rulesets/Difficulty/Skills/StrainSkill.cs
index 0b327046b3..4beba22e05 100644
--- a/osu.Game/Rulesets/Difficulty/Skills/StrainSkill.cs
+++ b/osu.Game/Rulesets/Difficulty/Skills/StrainSkill.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Rulesets/Difficulty/TimedDifficultyAttributes.cs b/osu.Game/Rulesets/Difficulty/TimedDifficultyAttributes.cs
index c07d1cd46e..a07827d50b 100644
--- a/osu.Game/Rulesets/Difficulty/TimedDifficultyAttributes.cs
+++ b/osu.Game/Rulesets/Difficulty/TimedDifficultyAttributes.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.
 
+#nullable disable
+
 using System;
 
 namespace osu.Game.Rulesets.Difficulty
diff --git a/osu.Game/Rulesets/Difficulty/Utils/LimitedCapacityQueue.cs b/osu.Game/Rulesets/Difficulty/Utils/LimitedCapacityQueue.cs
index bc0eb8af88..d20eb5e885 100644
--- a/osu.Game/Rulesets/Difficulty/Utils/LimitedCapacityQueue.cs
+++ b/osu.Game/Rulesets/Difficulty/Utils/LimitedCapacityQueue.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.
 
+#nullable disable
+
 using System;
 using System.Collections;
 using System.Collections.Generic;
diff --git a/osu.Game/Rulesets/Difficulty/Utils/ReverseQueue.cs b/osu.Game/Rulesets/Difficulty/Utils/ReverseQueue.cs
index 57db9df3ca..3dc2d133ba 100644
--- a/osu.Game/Rulesets/Difficulty/Utils/ReverseQueue.cs
+++ b/osu.Game/Rulesets/Difficulty/Utils/ReverseQueue.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.
 
+#nullable disable
+
 using System;
 using System.Collections;
 using System.Collections.Generic;
diff --git a/osu.Game/Rulesets/EFRulesetInfo.cs b/osu.Game/Rulesets/EFRulesetInfo.cs
index 4174aa773c..3c671496de 100644
--- a/osu.Game/Rulesets/EFRulesetInfo.cs
+++ b/osu.Game/Rulesets/EFRulesetInfo.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.
 
+#nullable disable
+
 using System;
 using System.ComponentModel.DataAnnotations.Schema;
 using System.Diagnostics.CodeAnalysis;
diff --git a/osu.Game/Rulesets/Edit/BeatmapVerifier.cs b/osu.Game/Rulesets/Edit/BeatmapVerifier.cs
index 6ed91e983a..a89a0e76a9 100644
--- a/osu.Game/Rulesets/Edit/BeatmapVerifier.cs
+++ b/osu.Game/Rulesets/Edit/BeatmapVerifier.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using osu.Game.Rulesets.Edit.Checks;
diff --git a/osu.Game/Rulesets/Edit/BeatmapVerifierContext.cs b/osu.Game/Rulesets/Edit/BeatmapVerifierContext.cs
index 6feee82bda..53bdf3140c 100644
--- a/osu.Game/Rulesets/Edit/BeatmapVerifierContext.cs
+++ b/osu.Game/Rulesets/Edit/BeatmapVerifierContext.cs
@@ -3,8 +3,6 @@
 
 using osu.Game.Beatmaps;
 
-#nullable enable
-
 namespace osu.Game.Rulesets.Edit
 {
     /// <summary>
diff --git a/osu.Game/Rulesets/Edit/Checks/CheckAudioInVideo.cs b/osu.Game/Rulesets/Edit/Checks/CheckAudioInVideo.cs
index a285979fd2..93fb7b9ab8 100644
--- a/osu.Game/Rulesets/Edit/Checks/CheckAudioInVideo.cs
+++ b/osu.Game/Rulesets/Edit/Checks/CheckAudioInVideo.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.IO;
 using osu.Game.IO.FileAbstraction;
diff --git a/osu.Game/Rulesets/Edit/Checks/CheckAudioPresence.cs b/osu.Game/Rulesets/Edit/Checks/CheckAudioPresence.cs
index 94c48c300a..fa3e114c55 100644
--- a/osu.Game/Rulesets/Edit/Checks/CheckAudioPresence.cs
+++ b/osu.Game/Rulesets/Edit/Checks/CheckAudioPresence.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.
 
+#nullable disable
+
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Edit.Checks.Components;
 
diff --git a/osu.Game/Rulesets/Edit/Checks/CheckAudioQuality.cs b/osu.Game/Rulesets/Edit/Checks/CheckAudioQuality.cs
index ec2ff68aad..96254ba6fd 100644
--- a/osu.Game/Rulesets/Edit/Checks/CheckAudioQuality.cs
+++ b/osu.Game/Rulesets/Edit/Checks/CheckAudioQuality.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Game.Rulesets.Edit.Checks.Components;
 
diff --git a/osu.Game/Rulesets/Edit/Checks/CheckBackgroundPresence.cs b/osu.Game/Rulesets/Edit/Checks/CheckBackgroundPresence.cs
index 067800b409..96840fd344 100644
--- a/osu.Game/Rulesets/Edit/Checks/CheckBackgroundPresence.cs
+++ b/osu.Game/Rulesets/Edit/Checks/CheckBackgroundPresence.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.
 
+#nullable disable
+
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Edit.Checks.Components;
 
diff --git a/osu.Game/Rulesets/Edit/Checks/CheckBackgroundQuality.cs b/osu.Game/Rulesets/Edit/Checks/CheckBackgroundQuality.cs
index 1f65752fa6..b15a9f5331 100644
--- a/osu.Game/Rulesets/Edit/Checks/CheckBackgroundQuality.cs
+++ b/osu.Game/Rulesets/Edit/Checks/CheckBackgroundQuality.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.IO;
 using osu.Game.Rulesets.Edit.Checks.Components;
diff --git a/osu.Game/Rulesets/Edit/Checks/CheckConcurrentObjects.cs b/osu.Game/Rulesets/Edit/Checks/CheckConcurrentObjects.cs
index ba5fbcf58d..02579b675d 100644
--- a/osu.Game/Rulesets/Edit/Checks/CheckConcurrentObjects.cs
+++ b/osu.Game/Rulesets/Edit/Checks/CheckConcurrentObjects.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Game.Rulesets.Edit.Checks.Components;
 using osu.Game.Rulesets.Objects;
diff --git a/osu.Game/Rulesets/Edit/Checks/CheckFewHitsounds.cs b/osu.Game/Rulesets/Edit/Checks/CheckFewHitsounds.cs
index 3358e81d5f..b25abb0cfc 100644
--- a/osu.Game/Rulesets/Edit/Checks/CheckFewHitsounds.cs
+++ b/osu.Game/Rulesets/Edit/Checks/CheckFewHitsounds.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using osu.Game.Audio;
diff --git a/osu.Game/Rulesets/Edit/Checks/CheckFilePresence.cs b/osu.Game/Rulesets/Edit/Checks/CheckFilePresence.cs
index a1605a11d0..67d480c28c 100644
--- a/osu.Game/Rulesets/Edit/Checks/CheckFilePresence.cs
+++ b/osu.Game/Rulesets/Edit/Checks/CheckFilePresence.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Edit.Checks.Components;
diff --git a/osu.Game/Rulesets/Edit/Checks/CheckMutedObjects.cs b/osu.Game/Rulesets/Edit/Checks/CheckMutedObjects.cs
index a4ff921b7e..cb6c4a9928 100644
--- a/osu.Game/Rulesets/Edit/Checks/CheckMutedObjects.cs
+++ b/osu.Game/Rulesets/Edit/Checks/CheckMutedObjects.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Rulesets/Edit/Checks/CheckTooShortAudioFiles.cs b/osu.Game/Rulesets/Edit/Checks/CheckTooShortAudioFiles.cs
index 6015d0a1b2..a461f63d2d 100644
--- a/osu.Game/Rulesets/Edit/Checks/CheckTooShortAudioFiles.cs
+++ b/osu.Game/Rulesets/Edit/Checks/CheckTooShortAudioFiles.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.IO;
 using System.Linq;
diff --git a/osu.Game/Rulesets/Edit/Checks/CheckUnsnappedObjects.cs b/osu.Game/Rulesets/Edit/Checks/CheckUnsnappedObjects.cs
index ded1bb54ca..a3c52cf547 100644
--- a/osu.Game/Rulesets/Edit/Checks/CheckUnsnappedObjects.cs
+++ b/osu.Game/Rulesets/Edit/Checks/CheckUnsnappedObjects.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using osu.Game.Rulesets.Edit.Checks.Components;
diff --git a/osu.Game/Rulesets/Edit/Checks/CheckZeroByteFiles.cs b/osu.Game/Rulesets/Edit/Checks/CheckZeroByteFiles.cs
index 75cb08002f..987711188e 100644
--- a/osu.Game/Rulesets/Edit/Checks/CheckZeroByteFiles.cs
+++ b/osu.Game/Rulesets/Edit/Checks/CheckZeroByteFiles.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.IO;
 using osu.Game.Extensions;
diff --git a/osu.Game/Rulesets/Edit/Checks/CheckZeroLengthObjects.cs b/osu.Game/Rulesets/Edit/Checks/CheckZeroLengthObjects.cs
index b9be94736b..3b30fab934 100644
--- a/osu.Game/Rulesets/Edit/Checks/CheckZeroLengthObjects.cs
+++ b/osu.Game/Rulesets/Edit/Checks/CheckZeroLengthObjects.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Game.Rulesets.Edit.Checks.Components;
 using osu.Game.Rulesets.Objects;
diff --git a/osu.Game/Rulesets/Edit/Checks/Components/CheckCategory.cs b/osu.Game/Rulesets/Edit/Checks/Components/CheckCategory.cs
index ae943cfda9..3e2150fe0b 100644
--- a/osu.Game/Rulesets/Edit/Checks/Components/CheckCategory.cs
+++ b/osu.Game/Rulesets/Edit/Checks/Components/CheckCategory.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.
 
+#nullable disable
+
 namespace osu.Game.Rulesets.Edit.Checks.Components
 {
     /// <summary>
diff --git a/osu.Game/Rulesets/Edit/Checks/Components/CheckMetadata.cs b/osu.Game/Rulesets/Edit/Checks/Components/CheckMetadata.cs
index cebb2f5455..5c9021ba61 100644
--- a/osu.Game/Rulesets/Edit/Checks/Components/CheckMetadata.cs
+++ b/osu.Game/Rulesets/Edit/Checks/Components/CheckMetadata.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.
 
+#nullable disable
+
 namespace osu.Game.Rulesets.Edit.Checks.Components
 {
     public class CheckMetadata
diff --git a/osu.Game/Rulesets/Edit/Checks/Components/ICheck.cs b/osu.Game/Rulesets/Edit/Checks/Components/ICheck.cs
index 141de55f1d..333ec0a810 100644
--- a/osu.Game/Rulesets/Edit/Checks/Components/ICheck.cs
+++ b/osu.Game/Rulesets/Edit/Checks/Components/ICheck.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 
 namespace osu.Game.Rulesets.Edit.Checks.Components
diff --git a/osu.Game/Rulesets/Edit/Checks/Components/Issue.cs b/osu.Game/Rulesets/Edit/Checks/Components/Issue.cs
index 2bc9930e8f..b3f227f364 100644
--- a/osu.Game/Rulesets/Edit/Checks/Components/Issue.cs
+++ b/osu.Game/Rulesets/Edit/Checks/Components/Issue.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Rulesets/Edit/Checks/Components/IssueTemplate.cs b/osu.Game/Rulesets/Edit/Checks/Components/IssueTemplate.cs
index 97df79ecd8..9101d83fa7 100644
--- a/osu.Game/Rulesets/Edit/Checks/Components/IssueTemplate.cs
+++ b/osu.Game/Rulesets/Edit/Checks/Components/IssueTemplate.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.
 
+#nullable disable
+
 using Humanizer;
 using osu.Framework.Graphics;
 using osuTK.Graphics;
diff --git a/osu.Game/Rulesets/Edit/Checks/Components/IssueType.cs b/osu.Game/Rulesets/Edit/Checks/Components/IssueType.cs
index 1f708209fe..a957cbc296 100644
--- a/osu.Game/Rulesets/Edit/Checks/Components/IssueType.cs
+++ b/osu.Game/Rulesets/Edit/Checks/Components/IssueType.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.
 
+#nullable disable
+
 namespace osu.Game.Rulesets.Edit.Checks.Components
 {
     /// <summary>
diff --git a/osu.Game/Rulesets/Edit/DistancedHitObjectComposer.cs b/osu.Game/Rulesets/Edit/DistancedHitObjectComposer.cs
index aaee15eae8..4726211666 100644
--- a/osu.Game/Rulesets/Edit/DistancedHitObjectComposer.cs
+++ b/osu.Game/Rulesets/Edit/DistancedHitObjectComposer.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Extensions;
diff --git a/osu.Game/Rulesets/Edit/DrawableEditorRulesetWrapper.cs b/osu.Game/Rulesets/Edit/DrawableEditorRulesetWrapper.cs
index 392a5db9da..9588a092a8 100644
--- a/osu.Game/Rulesets/Edit/DrawableEditorRulesetWrapper.cs
+++ b/osu.Game/Rulesets/Edit/DrawableEditorRulesetWrapper.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.
 
+#nullable disable
+
 using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Rulesets/Edit/EditorToolboxGroup.cs b/osu.Game/Rulesets/Edit/EditorToolboxGroup.cs
index bde426f56a..7dcc90b16d 100644
--- a/osu.Game/Rulesets/Edit/EditorToolboxGroup.cs
+++ b/osu.Game/Rulesets/Edit/EditorToolboxGroup.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Game.Overlays;
 
diff --git a/osu.Game/Rulesets/Edit/ExpandingToolboxContainer.cs b/osu.Game/Rulesets/Edit/ExpandingToolboxContainer.cs
index c6cc09a16c..d3371d3543 100644
--- a/osu.Game/Rulesets/Edit/ExpandingToolboxContainer.cs
+++ b/osu.Game/Rulesets/Edit/ExpandingToolboxContainer.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Input.Events;
 using osu.Game.Graphics.Containers;
diff --git a/osu.Game/Rulesets/Edit/HitObjectComposer.cs b/osu.Game/Rulesets/Edit/HitObjectComposer.cs
index f6fdb228ce..37c66037eb 100644
--- a/osu.Game/Rulesets/Edit/HitObjectComposer.cs
+++ b/osu.Game/Rulesets/Edit/HitObjectComposer.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Collections.Specialized;
diff --git a/osu.Game/Rulesets/Edit/HitObjectSelectionBlueprint.cs b/osu.Game/Rulesets/Edit/HitObjectSelectionBlueprint.cs
index 77dc55c6ef..c74fb83d58 100644
--- a/osu.Game/Rulesets/Edit/HitObjectSelectionBlueprint.cs
+++ b/osu.Game/Rulesets/Edit/HitObjectSelectionBlueprint.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.
 
+#nullable disable
+
 using osu.Framework.Graphics.Primitives;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Rulesets.Objects;
diff --git a/osu.Game/Rulesets/Edit/IBeatSnapProvider.cs b/osu.Game/Rulesets/Edit/IBeatSnapProvider.cs
index 616f854cd7..dbad407b75 100644
--- a/osu.Game/Rulesets/Edit/IBeatSnapProvider.cs
+++ b/osu.Game/Rulesets/Edit/IBeatSnapProvider.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.
 
+#nullable disable
+
 namespace osu.Game.Rulesets.Edit
 {
     public interface IBeatSnapProvider
diff --git a/osu.Game/Rulesets/Edit/IBeatmapVerifier.cs b/osu.Game/Rulesets/Edit/IBeatmapVerifier.cs
index 06f0abedb0..826bffef5f 100644
--- a/osu.Game/Rulesets/Edit/IBeatmapVerifier.cs
+++ b/osu.Game/Rulesets/Edit/IBeatmapVerifier.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Game.Rulesets.Edit.Checks.Components;
 
diff --git a/osu.Game/Rulesets/Edit/IDistanceSnapProvider.cs b/osu.Game/Rulesets/Edit/IDistanceSnapProvider.cs
index b12e1437dc..5ad1cc78ff 100644
--- a/osu.Game/Rulesets/Edit/IDistanceSnapProvider.cs
+++ b/osu.Game/Rulesets/Edit/IDistanceSnapProvider.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Game.Beatmaps;
diff --git a/osu.Game/Rulesets/Edit/IPositionSnapProvider.cs b/osu.Game/Rulesets/Edit/IPositionSnapProvider.cs
index a6a6e39e23..ad129e068d 100644
--- a/osu.Game/Rulesets/Edit/IPositionSnapProvider.cs
+++ b/osu.Game/Rulesets/Edit/IPositionSnapProvider.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osuTK;
 
diff --git a/osu.Game/Rulesets/Edit/PlacementBlueprint.cs b/osu.Game/Rulesets/Edit/PlacementBlueprint.cs
index 0c0c5990d1..26dd6db016 100644
--- a/osu.Game/Rulesets/Edit/PlacementBlueprint.cs
+++ b/osu.Game/Rulesets/Edit/PlacementBlueprint.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.
 
+#nullable disable
+
 using System.Threading;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Rulesets/Edit/SelectionBlueprint.cs b/osu.Game/Rulesets/Edit/SelectionBlueprint.cs
index 5e5bc9036d..fc24b55d21 100644
--- a/osu.Game/Rulesets/Edit/SelectionBlueprint.cs
+++ b/osu.Game/Rulesets/Edit/SelectionBlueprint.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.
 
+#nullable disable
+
 using System;
 using osu.Framework;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Rulesets/Edit/SnapResult.cs b/osu.Game/Rulesets/Edit/SnapResult.cs
index 31dd2b9496..9a1405b97c 100644
--- a/osu.Game/Rulesets/Edit/SnapResult.cs
+++ b/osu.Game/Rulesets/Edit/SnapResult.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.UI;
 using osuTK;
 
diff --git a/osu.Game/Rulesets/Edit/SnapType.cs b/osu.Game/Rulesets/Edit/SnapType.cs
index 6761356331..6eb46457c8 100644
--- a/osu.Game/Rulesets/Edit/SnapType.cs
+++ b/osu.Game/Rulesets/Edit/SnapType.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.
 
+#nullable disable
+
 using System;
 
 namespace osu.Game.Rulesets.Edit
diff --git a/osu.Game/Rulesets/Edit/Tools/HitObjectCompositionTool.cs b/osu.Game/Rulesets/Edit/Tools/HitObjectCompositionTool.cs
index 0a01ac4320..707645edeb 100644
--- a/osu.Game/Rulesets/Edit/Tools/HitObjectCompositionTool.cs
+++ b/osu.Game/Rulesets/Edit/Tools/HitObjectCompositionTool.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 
 namespace osu.Game.Rulesets.Edit.Tools
diff --git a/osu.Game/Rulesets/Edit/Tools/SelectTool.cs b/osu.Game/Rulesets/Edit/Tools/SelectTool.cs
index c050766b23..9640830a09 100644
--- a/osu.Game/Rulesets/Edit/Tools/SelectTool.cs
+++ b/osu.Game/Rulesets/Edit/Tools/SelectTool.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Sprites;
 
diff --git a/osu.Game/Rulesets/Filter/IRulesetFilterCriteria.cs b/osu.Game/Rulesets/Filter/IRulesetFilterCriteria.cs
index dd2ad2cbfa..fa44f81df3 100644
--- a/osu.Game/Rulesets/Filter/IRulesetFilterCriteria.cs
+++ b/osu.Game/Rulesets/Filter/IRulesetFilterCriteria.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.
 
+#nullable disable
+
 using osu.Game.Beatmaps;
 using osu.Game.Screens.Select;
 using osu.Game.Screens.Select.Filter;
diff --git a/osu.Game/Rulesets/ILegacyRuleset.cs b/osu.Game/Rulesets/ILegacyRuleset.cs
index f4b03baccd..a8cfed4866 100644
--- a/osu.Game/Rulesets/ILegacyRuleset.cs
+++ b/osu.Game/Rulesets/ILegacyRuleset.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.
 
+#nullable disable
+
 namespace osu.Game.Rulesets
 {
     public interface ILegacyRuleset
diff --git a/osu.Game/Rulesets/IRulesetConfigCache.cs b/osu.Game/Rulesets/IRulesetConfigCache.cs
index b946b43905..3943a62e59 100644
--- a/osu.Game/Rulesets/IRulesetConfigCache.cs
+++ b/osu.Game/Rulesets/IRulesetConfigCache.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 enable
-
 using osu.Game.Rulesets.Configuration;
 
 namespace osu.Game.Rulesets
diff --git a/osu.Game/Rulesets/IRulesetInfo.cs b/osu.Game/Rulesets/IRulesetInfo.cs
index 60a02212fc..5af6ef07cf 100644
--- a/osu.Game/Rulesets/IRulesetInfo.cs
+++ b/osu.Game/Rulesets/IRulesetInfo.cs
@@ -4,8 +4,6 @@
 using System;
 using osu.Game.Database;
 
-#nullable enable
-
 namespace osu.Game.Rulesets
 {
     /// <summary>
diff --git a/osu.Game/Rulesets/IRulesetStore.cs b/osu.Game/Rulesets/IRulesetStore.cs
index 08d907810b..f4895118e3 100644
--- a/osu.Game/Rulesets/IRulesetStore.cs
+++ b/osu.Game/Rulesets/IRulesetStore.cs
@@ -3,8 +3,6 @@
 
 using System.Collections.Generic;
 
-#nullable enable
-
 namespace osu.Game.Rulesets
 {
     public interface IRulesetStore
diff --git a/osu.Game/Rulesets/Judgements/DefaultJudgementPiece.cs b/osu.Game/Rulesets/Judgements/DefaultJudgementPiece.cs
index 29b771a81d..c2b27d4ce8 100644
--- a/osu.Game/Rulesets/Judgements/DefaultJudgementPiece.cs
+++ b/osu.Game/Rulesets/Judgements/DefaultJudgementPiece.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Extensions;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Rulesets/Judgements/DrawableJudgement.cs b/osu.Game/Rulesets/Judgements/DrawableJudgement.cs
index d25d46c6e2..0d8b8429d8 100644
--- a/osu.Game/Rulesets/Judgements/DrawableJudgement.cs
+++ b/osu.Game/Rulesets/Judgements/DrawableJudgement.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.
 
+#nullable disable
+
 using System;
 using System.Diagnostics;
 using JetBrains.Annotations;
diff --git a/osu.Game/Rulesets/Judgements/IAnimatableJudgement.cs b/osu.Game/Rulesets/Judgements/IAnimatableJudgement.cs
index b38b83b534..2bc5a62983 100644
--- a/osu.Game/Rulesets/Judgements/IAnimatableJudgement.cs
+++ b/osu.Game/Rulesets/Judgements/IAnimatableJudgement.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.
 
+#nullable disable
+
 using JetBrains.Annotations;
 using osu.Framework.Graphics;
 
diff --git a/osu.Game/Rulesets/Judgements/IgnoreJudgement.cs b/osu.Game/Rulesets/Judgements/IgnoreJudgement.cs
index d2a434058d..f08b43e72a 100644
--- a/osu.Game/Rulesets/Judgements/IgnoreJudgement.cs
+++ b/osu.Game/Rulesets/Judgements/IgnoreJudgement.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Scoring;
 
 namespace osu.Game.Rulesets.Judgements
diff --git a/osu.Game/Rulesets/Judgements/Judgement.cs b/osu.Game/Rulesets/Judgements/Judgement.cs
index 99dce82ec2..770f656e8f 100644
--- a/osu.Game/Rulesets/Judgements/Judgement.cs
+++ b/osu.Game/Rulesets/Judgements/Judgement.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Scoring;
 
diff --git a/osu.Game/Rulesets/Judgements/JudgementResult.cs b/osu.Game/Rulesets/Judgements/JudgementResult.cs
index e3b2501cdc..2685cb4e2a 100644
--- a/osu.Game/Rulesets/Judgements/JudgementResult.cs
+++ b/osu.Game/Rulesets/Judgements/JudgementResult.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.
 
+#nullable disable
+
 using JetBrains.Annotations;
 using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Objects.Drawables;
diff --git a/osu.Game/Rulesets/Mods/DifficultyAdjustSettingsControl.cs b/osu.Game/Rulesets/Mods/DifficultyAdjustSettingsControl.cs
index c8e7284f5d..9307e36b99 100644
--- a/osu.Game/Rulesets/Mods/DifficultyAdjustSettingsControl.cs
+++ b/osu.Game/Rulesets/Mods/DifficultyAdjustSettingsControl.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Rulesets/Mods/DifficultyBindable.cs b/osu.Game/Rulesets/Mods/DifficultyBindable.cs
index 6cfae0b085..eb5f97bcf7 100644
--- a/osu.Game/Rulesets/Mods/DifficultyBindable.cs
+++ b/osu.Game/Rulesets/Mods/DifficultyBindable.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Bindables;
 using osu.Game.Beatmaps;
diff --git a/osu.Game/Rulesets/Mods/IApplicableAfterBeatmapConversion.cs b/osu.Game/Rulesets/Mods/IApplicableAfterBeatmapConversion.cs
index d45311675d..9286f682d1 100644
--- a/osu.Game/Rulesets/Mods/IApplicableAfterBeatmapConversion.cs
+++ b/osu.Game/Rulesets/Mods/IApplicableAfterBeatmapConversion.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.
 
+#nullable disable
+
 using osu.Game.Beatmaps;
 
 namespace osu.Game.Rulesets.Mods
diff --git a/osu.Game/Rulesets/Mods/IApplicableFailOverride.cs b/osu.Game/Rulesets/Mods/IApplicableFailOverride.cs
index 8c99d739cb..d0b54f835b 100644
--- a/osu.Game/Rulesets/Mods/IApplicableFailOverride.cs
+++ b/osu.Game/Rulesets/Mods/IApplicableFailOverride.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.
 
+#nullable disable
+
 namespace osu.Game.Rulesets.Mods
 {
     /// <summary>
diff --git a/osu.Game/Rulesets/Mods/IApplicableMod.cs b/osu.Game/Rulesets/Mods/IApplicableMod.cs
index 8ca1a3f8a5..7675bd89ef 100644
--- a/osu.Game/Rulesets/Mods/IApplicableMod.cs
+++ b/osu.Game/Rulesets/Mods/IApplicableMod.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.
 
+#nullable disable
+
 namespace osu.Game.Rulesets.Mods
 {
     /// <summary>
diff --git a/osu.Game/Rulesets/Mods/IApplicableToAudio.cs b/osu.Game/Rulesets/Mods/IApplicableToAudio.cs
index 901da7af55..de76790aee 100644
--- a/osu.Game/Rulesets/Mods/IApplicableToAudio.cs
+++ b/osu.Game/Rulesets/Mods/IApplicableToAudio.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.
 
+#nullable disable
+
 namespace osu.Game.Rulesets.Mods
 {
     public interface IApplicableToAudio : IApplicableToTrack, IApplicableToSample
diff --git a/osu.Game/Rulesets/Mods/IApplicableToBeatmap.cs b/osu.Game/Rulesets/Mods/IApplicableToBeatmap.cs
index cff669bf53..278b4794c5 100644
--- a/osu.Game/Rulesets/Mods/IApplicableToBeatmap.cs
+++ b/osu.Game/Rulesets/Mods/IApplicableToBeatmap.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.
 
+#nullable disable
+
 using osu.Game.Beatmaps;
 
 namespace osu.Game.Rulesets.Mods
diff --git a/osu.Game/Rulesets/Mods/IApplicableToBeatmapConverter.cs b/osu.Game/Rulesets/Mods/IApplicableToBeatmapConverter.cs
index 8cefb02904..a5ccea1873 100644
--- a/osu.Game/Rulesets/Mods/IApplicableToBeatmapConverter.cs
+++ b/osu.Game/Rulesets/Mods/IApplicableToBeatmapConverter.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.
 
+#nullable disable
+
 using osu.Game.Beatmaps;
 
 namespace osu.Game.Rulesets.Mods
diff --git a/osu.Game/Rulesets/Mods/IApplicableToBeatmapProcessor.cs b/osu.Game/Rulesets/Mods/IApplicableToBeatmapProcessor.cs
index e23a5d8d99..c653a674ef 100644
--- a/osu.Game/Rulesets/Mods/IApplicableToBeatmapProcessor.cs
+++ b/osu.Game/Rulesets/Mods/IApplicableToBeatmapProcessor.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.
 
+#nullable disable
+
 using osu.Game.Beatmaps;
 
 namespace osu.Game.Rulesets.Mods
diff --git a/osu.Game/Rulesets/Mods/IApplicableToDifficulty.cs b/osu.Game/Rulesets/Mods/IApplicableToDifficulty.cs
index 42b520ab26..1447511de9 100644
--- a/osu.Game/Rulesets/Mods/IApplicableToDifficulty.cs
+++ b/osu.Game/Rulesets/Mods/IApplicableToDifficulty.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.
 
+#nullable disable
+
 using osu.Game.Beatmaps;
 
 namespace osu.Game.Rulesets.Mods
diff --git a/osu.Game/Rulesets/Mods/IApplicableToDrawableHitObject.cs b/osu.Game/Rulesets/Mods/IApplicableToDrawableHitObject.cs
index c8a9ff2f9a..f559ed04d7 100644
--- a/osu.Game/Rulesets/Mods/IApplicableToDrawableHitObject.cs
+++ b/osu.Game/Rulesets/Mods/IApplicableToDrawableHitObject.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Objects.Drawables;
 
 namespace osu.Game.Rulesets.Mods
diff --git a/osu.Game/Rulesets/Mods/IApplicableToDrawableHitObjects.cs b/osu.Game/Rulesets/Mods/IApplicableToDrawableHitObjects.cs
index 7f926dd8b8..8bf2c3810e 100644
--- a/osu.Game/Rulesets/Mods/IApplicableToDrawableHitObjects.cs
+++ b/osu.Game/Rulesets/Mods/IApplicableToDrawableHitObjects.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using osu.Framework.Extensions.IEnumerableExtensions;
diff --git a/osu.Game/Rulesets/Mods/IApplicableToDrawableRuleset.cs b/osu.Game/Rulesets/Mods/IApplicableToDrawableRuleset.cs
index b012beb0c0..ace3af62a1 100644
--- a/osu.Game/Rulesets/Mods/IApplicableToDrawableRuleset.cs
+++ b/osu.Game/Rulesets/Mods/IApplicableToDrawableRuleset.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.UI;
 
diff --git a/osu.Game/Rulesets/Mods/IApplicableToHUD.cs b/osu.Game/Rulesets/Mods/IApplicableToHUD.cs
index 4fb535a0b3..b5fe299b24 100644
--- a/osu.Game/Rulesets/Mods/IApplicableToHUD.cs
+++ b/osu.Game/Rulesets/Mods/IApplicableToHUD.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.
 
+#nullable disable
+
 using osu.Game.Screens.Play;
 
 namespace osu.Game.Rulesets.Mods
diff --git a/osu.Game/Rulesets/Mods/IApplicableToHealthProcessor.cs b/osu.Game/Rulesets/Mods/IApplicableToHealthProcessor.cs
index 2676060efa..a58f8640fd 100644
--- a/osu.Game/Rulesets/Mods/IApplicableToHealthProcessor.cs
+++ b/osu.Game/Rulesets/Mods/IApplicableToHealthProcessor.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Scoring;
 
 namespace osu.Game.Rulesets.Mods
diff --git a/osu.Game/Rulesets/Mods/IApplicableToHitObject.cs b/osu.Game/Rulesets/Mods/IApplicableToHitObject.cs
index f7f81c92c0..d9fa993393 100644
--- a/osu.Game/Rulesets/Mods/IApplicableToHitObject.cs
+++ b/osu.Game/Rulesets/Mods/IApplicableToHitObject.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Objects;
 
 namespace osu.Game.Rulesets.Mods
diff --git a/osu.Game/Rulesets/Mods/IApplicableToPlayer.cs b/osu.Game/Rulesets/Mods/IApplicableToPlayer.cs
index bf78428470..c28935607f 100644
--- a/osu.Game/Rulesets/Mods/IApplicableToPlayer.cs
+++ b/osu.Game/Rulesets/Mods/IApplicableToPlayer.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.
 
+#nullable disable
+
 using osu.Game.Screens.Play;
 
 namespace osu.Game.Rulesets.Mods
diff --git a/osu.Game/Rulesets/Mods/IApplicableToRate.cs b/osu.Game/Rulesets/Mods/IApplicableToRate.cs
index f613867132..c66c8f49a1 100644
--- a/osu.Game/Rulesets/Mods/IApplicableToRate.cs
+++ b/osu.Game/Rulesets/Mods/IApplicableToRate.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.
 
+#nullable disable
+
 namespace osu.Game.Rulesets.Mods
 {
     /// <summary>
diff --git a/osu.Game/Rulesets/Mods/IApplicableToSample.cs b/osu.Game/Rulesets/Mods/IApplicableToSample.cs
index efd88f2399..97ed0fbf7e 100644
--- a/osu.Game/Rulesets/Mods/IApplicableToSample.cs
+++ b/osu.Game/Rulesets/Mods/IApplicableToSample.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.
 
+#nullable disable
+
 using osu.Framework.Audio;
 
 namespace osu.Game.Rulesets.Mods
diff --git a/osu.Game/Rulesets/Mods/IApplicableToScoreProcessor.cs b/osu.Game/Rulesets/Mods/IApplicableToScoreProcessor.cs
index b93e50921f..24c1ac9afe 100644
--- a/osu.Game/Rulesets/Mods/IApplicableToScoreProcessor.cs
+++ b/osu.Game/Rulesets/Mods/IApplicableToScoreProcessor.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Scoring;
 using osu.Game.Scoring;
 
diff --git a/osu.Game/Rulesets/Mods/IApplicableToTrack.cs b/osu.Game/Rulesets/Mods/IApplicableToTrack.cs
index deecd4bf1f..358ef71cc0 100644
--- a/osu.Game/Rulesets/Mods/IApplicableToTrack.cs
+++ b/osu.Game/Rulesets/Mods/IApplicableToTrack.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.
 
+#nullable disable
+
 using osu.Framework.Audio;
 
 namespace osu.Game.Rulesets.Mods
diff --git a/osu.Game/Rulesets/Mods/ICreateReplay.cs b/osu.Game/Rulesets/Mods/ICreateReplay.cs
index 1e5eeca92c..e77f4c49b9 100644
--- a/osu.Game/Rulesets/Mods/ICreateReplay.cs
+++ b/osu.Game/Rulesets/Mods/ICreateReplay.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using osu.Game.Beatmaps;
diff --git a/osu.Game/Rulesets/Mods/ICreateReplayData.cs b/osu.Game/Rulesets/Mods/ICreateReplayData.cs
index 7d208e9000..6058380eb3 100644
--- a/osu.Game/Rulesets/Mods/ICreateReplayData.cs
+++ b/osu.Game/Rulesets/Mods/ICreateReplayData.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Game.Beatmaps;
 using osu.Game.Online.API.Requests.Responses;
diff --git a/osu.Game/Rulesets/Mods/IHasSeed.cs b/osu.Game/Rulesets/Mods/IHasSeed.cs
index 001a9d214c..fd2161ac09 100644
--- a/osu.Game/Rulesets/Mods/IHasSeed.cs
+++ b/osu.Game/Rulesets/Mods/IHasSeed.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.
 
+#nullable disable
+
 using osu.Framework.Bindables;
 
 namespace osu.Game.Rulesets.Mods
diff --git a/osu.Game/Rulesets/Mods/IMod.cs b/osu.Game/Rulesets/Mods/IMod.cs
index 30fa1ea8cb..349cc7dd5a 100644
--- a/osu.Game/Rulesets/Mods/IMod.cs
+++ b/osu.Game/Rulesets/Mods/IMod.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Graphics.Sprites;
 
diff --git a/osu.Game/Rulesets/Mods/IReadFromConfig.cs b/osu.Game/Rulesets/Mods/IReadFromConfig.cs
index d66fabce70..ee6fb6364f 100644
--- a/osu.Game/Rulesets/Mods/IReadFromConfig.cs
+++ b/osu.Game/Rulesets/Mods/IReadFromConfig.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.
 
+#nullable disable
+
 using osu.Game.Configuration;
 
 namespace osu.Game.Rulesets.Mods
diff --git a/osu.Game/Rulesets/Mods/IUpdatableByPlayfield.cs b/osu.Game/Rulesets/Mods/IUpdatableByPlayfield.cs
index 7cf480a11b..3aad858af5 100644
--- a/osu.Game/Rulesets/Mods/IUpdatableByPlayfield.cs
+++ b/osu.Game/Rulesets/Mods/IUpdatableByPlayfield.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.UI;
 
 namespace osu.Game.Rulesets.Mods
diff --git a/osu.Game/Rulesets/Mods/MetronomeBeat.cs b/osu.Game/Rulesets/Mods/MetronomeBeat.cs
index 149af1e30a..b26052a37e 100644
--- a/osu.Game/Rulesets/Mods/MetronomeBeat.cs
+++ b/osu.Game/Rulesets/Mods/MetronomeBeat.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.
 
+#nullable disable
+
 using osu.Framework.Audio;
 using osu.Framework.Audio.Track;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Rulesets/Mods/Mod.cs b/osu.Game/Rulesets/Mods/Mod.cs
index af1550f8a9..17093e3033 100644
--- a/osu.Game/Rulesets/Mods/Mod.cs
+++ b/osu.Game/Rulesets/Mods/Mod.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs b/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs
index fb291fe10f..2f5707562e 100644
--- a/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.cs
+++ b/osu.Game/Rulesets/Mods/ModAdaptiveSpeed.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Rulesets/Mods/ModAutoplay.cs b/osu.Game/Rulesets/Mods/ModAutoplay.cs
index 0ebe11b393..6d786fc8e2 100644
--- a/osu.Game/Rulesets/Mods/ModAutoplay.cs
+++ b/osu.Game/Rulesets/Mods/ModAutoplay.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using osu.Framework.Graphics.Sprites;
diff --git a/osu.Game/Rulesets/Mods/ModBarrelRoll.cs b/osu.Game/Rulesets/Mods/ModBarrelRoll.cs
index bacb953f76..bd0f2bfe59 100644
--- a/osu.Game/Rulesets/Mods/ModBarrelRoll.cs
+++ b/osu.Game/Rulesets/Mods/ModBarrelRoll.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Bindables;
 using osu.Framework.Extensions;
diff --git a/osu.Game/Rulesets/Mods/ModBlockFail.cs b/osu.Game/Rulesets/Mods/ModBlockFail.cs
index 8a9b0cddc8..a6a8244480 100644
--- a/osu.Game/Rulesets/Mods/ModBlockFail.cs
+++ b/osu.Game/Rulesets/Mods/ModBlockFail.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.
 
+#nullable disable
+
 using osu.Framework.Bindables;
 using osu.Game.Configuration;
 using osu.Game.Screens.Play;
diff --git a/osu.Game/Rulesets/Mods/ModCinema.cs b/osu.Game/Rulesets/Mods/ModCinema.cs
index 99c4e71d1f..6e7bd6350e 100644
--- a/osu.Game/Rulesets/Mods/ModCinema.cs
+++ b/osu.Game/Rulesets/Mods/ModCinema.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using osu.Framework.Graphics.Sprites;
diff --git a/osu.Game/Rulesets/Mods/ModClassic.cs b/osu.Game/Rulesets/Mods/ModClassic.cs
index 1159955e11..b4885ff16e 100644
--- a/osu.Game/Rulesets/Mods/ModClassic.cs
+++ b/osu.Game/Rulesets/Mods/ModClassic.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.
 
+#nullable disable
+
 using osu.Framework.Graphics.Sprites;
 
 namespace osu.Game.Rulesets.Mods
diff --git a/osu.Game/Rulesets/Mods/ModDaycore.cs b/osu.Game/Rulesets/Mods/ModDaycore.cs
index 9e8e44229e..262aeb07ac 100644
--- a/osu.Game/Rulesets/Mods/ModDaycore.cs
+++ b/osu.Game/Rulesets/Mods/ModDaycore.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.
 
+#nullable disable
+
 using osu.Framework.Audio;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics.Sprites;
diff --git a/osu.Game/Rulesets/Mods/ModDifficultyAdjust.cs b/osu.Game/Rulesets/Mods/ModDifficultyAdjust.cs
index eefa1531c4..c0e2c75aca 100644
--- a/osu.Game/Rulesets/Mods/ModDifficultyAdjust.cs
+++ b/osu.Game/Rulesets/Mods/ModDifficultyAdjust.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Rulesets/Mods/ModDoubleTime.cs b/osu.Game/Rulesets/Mods/ModDoubleTime.cs
index 1c71f5d055..389d0db261 100644
--- a/osu.Game/Rulesets/Mods/ModDoubleTime.cs
+++ b/osu.Game/Rulesets/Mods/ModDoubleTime.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.
 
+#nullable disable
+
 using osu.Framework.Bindables;
 using osu.Framework.Graphics.Sprites;
 using osu.Game.Configuration;
diff --git a/osu.Game/Rulesets/Mods/ModEasy.cs b/osu.Game/Rulesets/Mods/ModEasy.cs
index 0f51e2a6d5..bc5988174b 100644
--- a/osu.Game/Rulesets/Mods/ModEasy.cs
+++ b/osu.Game/Rulesets/Mods/ModEasy.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Graphics.Sprites;
 using osu.Game.Beatmaps;
diff --git a/osu.Game/Rulesets/Mods/ModEasyWithExtraLives.cs b/osu.Game/Rulesets/Mods/ModEasyWithExtraLives.cs
index 2ac0f59d84..984892de51 100644
--- a/osu.Game/Rulesets/Mods/ModEasyWithExtraLives.cs
+++ b/osu.Game/Rulesets/Mods/ModEasyWithExtraLives.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.
 
+#nullable disable
+
 using Humanizer;
 using osu.Framework.Bindables;
 using osu.Game.Beatmaps;
diff --git a/osu.Game/Rulesets/Mods/ModExtensions.cs b/osu.Game/Rulesets/Mods/ModExtensions.cs
index b22030414b..ad61404972 100644
--- a/osu.Game/Rulesets/Mods/ModExtensions.cs
+++ b/osu.Game/Rulesets/Mods/ModExtensions.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Game.Beatmaps;
 using osu.Game.Online.API.Requests.Responses;
diff --git a/osu.Game/Rulesets/Mods/ModFailCondition.cs b/osu.Game/Rulesets/Mods/ModFailCondition.cs
index 4425ece513..e24746ebd9 100644
--- a/osu.Game/Rulesets/Mods/ModFailCondition.cs
+++ b/osu.Game/Rulesets/Mods/ModFailCondition.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Bindables;
 using osu.Game.Configuration;
diff --git a/osu.Game/Rulesets/Mods/ModFlashlight.cs b/osu.Game/Rulesets/Mods/ModFlashlight.cs
index b449f3f64d..649d5480bf 100644
--- a/osu.Game/Rulesets/Mods/ModFlashlight.cs
+++ b/osu.Game/Rulesets/Mods/ModFlashlight.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Rulesets/Mods/ModHalfTime.cs b/osu.Game/Rulesets/Mods/ModHalfTime.cs
index 13d89e30d6..48fa7c13b4 100644
--- a/osu.Game/Rulesets/Mods/ModHalfTime.cs
+++ b/osu.Game/Rulesets/Mods/ModHalfTime.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.
 
+#nullable disable
+
 using osu.Framework.Bindables;
 using osu.Framework.Graphics.Sprites;
 using osu.Game.Configuration;
diff --git a/osu.Game/Rulesets/Mods/ModHardRock.cs b/osu.Game/Rulesets/Mods/ModHardRock.cs
index 0a5348a8cf..030520fccc 100644
--- a/osu.Game/Rulesets/Mods/ModHardRock.cs
+++ b/osu.Game/Rulesets/Mods/ModHardRock.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Graphics.Sprites;
 using osu.Game.Beatmaps;
diff --git a/osu.Game/Rulesets/Mods/ModHidden.cs b/osu.Game/Rulesets/Mods/ModHidden.cs
index 5a8226115f..35107762aa 100644
--- a/osu.Game/Rulesets/Mods/ModHidden.cs
+++ b/osu.Game/Rulesets/Mods/ModHidden.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.
 
+#nullable disable
+
 using osu.Game.Graphics;
 using osu.Framework.Graphics.Sprites;
 using osu.Game.Rulesets.Scoring;
diff --git a/osu.Game/Rulesets/Mods/ModMirror.cs b/osu.Game/Rulesets/Mods/ModMirror.cs
index 3c4b7d0c60..00a1d4a9c6 100644
--- a/osu.Game/Rulesets/Mods/ModMirror.cs
+++ b/osu.Game/Rulesets/Mods/ModMirror.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.
 
+#nullable disable
+
 namespace osu.Game.Rulesets.Mods
 {
     public abstract class ModMirror : Mod
diff --git a/osu.Game/Rulesets/Mods/ModMuted.cs b/osu.Game/Rulesets/Mods/ModMuted.cs
index 84341faab7..88e49f41b0 100644
--- a/osu.Game/Rulesets/Mods/ModMuted.cs
+++ b/osu.Game/Rulesets/Mods/ModMuted.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.
 
+#nullable disable
+
 using System.Linq;
 using osu.Framework.Audio;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Rulesets/Mods/ModNightcore.cs b/osu.Game/Rulesets/Mods/ModNightcore.cs
index 7997204450..7c2201cd98 100644
--- a/osu.Game/Rulesets/Mods/ModNightcore.cs
+++ b/osu.Game/Rulesets/Mods/ModNightcore.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
 using osu.Framework.Audio.Track;
diff --git a/osu.Game/Rulesets/Mods/ModNoFail.cs b/osu.Game/Rulesets/Mods/ModNoFail.cs
index 5ebae17228..27dbb53e6c 100644
--- a/osu.Game/Rulesets/Mods/ModNoFail.cs
+++ b/osu.Game/Rulesets/Mods/ModNoFail.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Graphics.Sprites;
 using osu.Game.Graphics;
diff --git a/osu.Game/Rulesets/Mods/ModNoMod.cs b/osu.Game/Rulesets/Mods/ModNoMod.cs
index 1009c5bc42..cc0b38cbc0 100644
--- a/osu.Game/Rulesets/Mods/ModNoMod.cs
+++ b/osu.Game/Rulesets/Mods/ModNoMod.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.
 
+#nullable disable
+
 using osu.Framework.Graphics.Sprites;
 
 namespace osu.Game.Rulesets.Mods
diff --git a/osu.Game/Rulesets/Mods/ModNoScope.cs b/osu.Game/Rulesets/Mods/ModNoScope.cs
index 7a935eb38f..c43ac33b3f 100644
--- a/osu.Game/Rulesets/Mods/ModNoScope.cs
+++ b/osu.Game/Rulesets/Mods/ModNoScope.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Rulesets/Mods/ModPerfect.cs b/osu.Game/Rulesets/Mods/ModPerfect.cs
index 9016a24f8d..b6daf54fa0 100644
--- a/osu.Game/Rulesets/Mods/ModPerfect.cs
+++ b/osu.Game/Rulesets/Mods/ModPerfect.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using osu.Framework.Graphics.Sprites;
diff --git a/osu.Game/Rulesets/Mods/ModRandom.cs b/osu.Game/Rulesets/Mods/ModRandom.cs
index 1f7742b075..6654bff04b 100644
--- a/osu.Game/Rulesets/Mods/ModRandom.cs
+++ b/osu.Game/Rulesets/Mods/ModRandom.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.
 
+#nullable disable
+
 using osu.Framework.Bindables;
 using osu.Framework.Graphics.Sprites;
 using osu.Game.Configuration;
diff --git a/osu.Game/Rulesets/Mods/ModRateAdjust.cs b/osu.Game/Rulesets/Mods/ModRateAdjust.cs
index 7b55ba4ad0..643280623c 100644
--- a/osu.Game/Rulesets/Mods/ModRateAdjust.cs
+++ b/osu.Game/Rulesets/Mods/ModRateAdjust.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Audio;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Rulesets/Mods/ModRelax.cs b/osu.Game/Rulesets/Mods/ModRelax.cs
index e5995ff180..4829d10ddb 100644
--- a/osu.Game/Rulesets/Mods/ModRelax.cs
+++ b/osu.Game/Rulesets/Mods/ModRelax.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Graphics.Sprites;
 using osu.Game.Graphics;
diff --git a/osu.Game/Rulesets/Mods/ModSuddenDeath.cs b/osu.Game/Rulesets/Mods/ModSuddenDeath.cs
index c8b835f78a..48ab888a90 100644
--- a/osu.Game/Rulesets/Mods/ModSuddenDeath.cs
+++ b/osu.Game/Rulesets/Mods/ModSuddenDeath.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using osu.Framework.Graphics.Sprites;
diff --git a/osu.Game/Rulesets/Mods/ModTimeRamp.cs b/osu.Game/Rulesets/Mods/ModTimeRamp.cs
index 98abda872b..a1aad3a6b9 100644
--- a/osu.Game/Rulesets/Mods/ModTimeRamp.cs
+++ b/osu.Game/Rulesets/Mods/ModTimeRamp.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using osu.Framework.Audio;
diff --git a/osu.Game/Rulesets/Mods/ModType.cs b/osu.Game/Rulesets/Mods/ModType.cs
index e3c82e42f5..5a405b7632 100644
--- a/osu.Game/Rulesets/Mods/ModType.cs
+++ b/osu.Game/Rulesets/Mods/ModType.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.
 
+#nullable disable
+
 namespace osu.Game.Rulesets.Mods
 {
     public enum ModType
diff --git a/osu.Game/Rulesets/Mods/ModWindDown.cs b/osu.Game/Rulesets/Mods/ModWindDown.cs
index 08bd44f7bd..2150264a0c 100644
--- a/osu.Game/Rulesets/Mods/ModWindDown.cs
+++ b/osu.Game/Rulesets/Mods/ModWindDown.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Rulesets/Mods/ModWindUp.cs b/osu.Game/Rulesets/Mods/ModWindUp.cs
index df8f781148..d9ee561ef8 100644
--- a/osu.Game/Rulesets/Mods/ModWindUp.cs
+++ b/osu.Game/Rulesets/Mods/ModWindUp.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Rulesets/Mods/ModWithVisibilityAdjustment.cs b/osu.Game/Rulesets/Mods/ModWithVisibilityAdjustment.cs
index b58ee5ff36..d84695fff8 100644
--- a/osu.Game/Rulesets/Mods/ModWithVisibilityAdjustment.cs
+++ b/osu.Game/Rulesets/Mods/ModWithVisibilityAdjustment.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Framework.Bindables;
 using osu.Game.Beatmaps;
diff --git a/osu.Game/Rulesets/Mods/MultiMod.cs b/osu.Game/Rulesets/Mods/MultiMod.cs
index 1c41c6b8b3..d62dc34d3b 100644
--- a/osu.Game/Rulesets/Mods/MultiMod.cs
+++ b/osu.Game/Rulesets/Mods/MultiMod.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 
diff --git a/osu.Game/Rulesets/Mods/UnknownMod.cs b/osu.Game/Rulesets/Mods/UnknownMod.cs
index 72de0ad653..e058fba566 100644
--- a/osu.Game/Rulesets/Mods/UnknownMod.cs
+++ b/osu.Game/Rulesets/Mods/UnknownMod.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.
 
+#nullable disable
+
 namespace osu.Game.Rulesets.Mods
 {
     public class UnknownMod : Mod
diff --git a/osu.Game/Rulesets/Objects/BarLineGenerator.cs b/osu.Game/Rulesets/Objects/BarLineGenerator.cs
index d71a499119..dec81d9bbd 100644
--- a/osu.Game/Rulesets/Objects/BarLineGenerator.cs
+++ b/osu.Game/Rulesets/Objects/BarLineGenerator.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Rulesets/Objects/Drawables/ArmedState.cs b/osu.Game/Rulesets/Objects/Drawables/ArmedState.cs
index b2d9f50602..4faf0920d1 100644
--- a/osu.Game/Rulesets/Objects/Drawables/ArmedState.cs
+++ b/osu.Game/Rulesets/Objects/Drawables/ArmedState.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.
 
+#nullable disable
+
 namespace osu.Game.Rulesets.Objects.Drawables
 {
     public enum ArmedState
diff --git a/osu.Game/Rulesets/Objects/Drawables/DrawableHitObject.cs b/osu.Game/Rulesets/Objects/Drawables/DrawableHitObject.cs
index 2e573a7f85..39ccaa2e5d 100644
--- a/osu.Game/Rulesets/Objects/Drawables/DrawableHitObject.cs
+++ b/osu.Game/Rulesets/Objects/Drawables/DrawableHitObject.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Collections.Specialized;
diff --git a/osu.Game/Rulesets/Objects/HitObject.cs b/osu.Game/Rulesets/Objects/HitObject.cs
index 57b897e5b5..30b8fe965a 100644
--- a/osu.Game/Rulesets/Objects/HitObject.cs
+++ b/osu.Game/Rulesets/Objects/HitObject.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Collections.Immutable;
diff --git a/osu.Game/Rulesets/Objects/HitObjectLifetimeEntry.cs b/osu.Game/Rulesets/Objects/HitObjectLifetimeEntry.cs
index 096dad88bd..9af4cf3544 100644
--- a/osu.Game/Rulesets/Objects/HitObjectLifetimeEntry.cs
+++ b/osu.Game/Rulesets/Objects/HitObjectLifetimeEntry.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.
 
+#nullable disable
+
 using osu.Framework.Bindables;
 using osu.Framework.Graphics.Performance;
 using osu.Game.Rulesets.Judgements;
diff --git a/osu.Game/Rulesets/Objects/HitObjectParser.cs b/osu.Game/Rulesets/Objects/HitObjectParser.cs
index d3c29d90ce..9728a4393b 100644
--- a/osu.Game/Rulesets/Objects/HitObjectParser.cs
+++ b/osu.Game/Rulesets/Objects/HitObjectParser.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.
 
+#nullable disable
+
 namespace osu.Game.Rulesets.Objects
 {
     public abstract class HitObjectParser
diff --git a/osu.Game/Rulesets/Objects/IBarLine.cs b/osu.Game/Rulesets/Objects/IBarLine.cs
index 14df80e3b9..8cdead6776 100644
--- a/osu.Game/Rulesets/Objects/IBarLine.cs
+++ b/osu.Game/Rulesets/Objects/IBarLine.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.
 
+#nullable disable
+
 namespace osu.Game.Rulesets.Objects
 {
     /// <summary>
diff --git a/osu.Game/Rulesets/Objects/Legacy/Catch/ConvertHit.cs b/osu.Game/Rulesets/Objects/Legacy/Catch/ConvertHit.cs
index 12b4812824..9facfec96f 100644
--- a/osu.Game/Rulesets/Objects/Legacy/Catch/ConvertHit.cs
+++ b/osu.Game/Rulesets/Objects/Legacy/Catch/ConvertHit.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Objects.Types;
 using osuTK;
 
diff --git a/osu.Game/Rulesets/Objects/Legacy/Catch/ConvertHitObjectParser.cs b/osu.Game/Rulesets/Objects/Legacy/Catch/ConvertHitObjectParser.cs
index 2beb6bdbf2..4861e8b3f7 100644
--- a/osu.Game/Rulesets/Objects/Legacy/Catch/ConvertHitObjectParser.cs
+++ b/osu.Game/Rulesets/Objects/Legacy/Catch/ConvertHitObjectParser.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.
 
+#nullable disable
+
 using osuTK;
 using osu.Game.Audio;
 using System.Collections.Generic;
diff --git a/osu.Game/Rulesets/Objects/Legacy/Catch/ConvertSlider.cs b/osu.Game/Rulesets/Objects/Legacy/Catch/ConvertSlider.cs
index fb1afed3b4..62726019bb 100644
--- a/osu.Game/Rulesets/Objects/Legacy/Catch/ConvertSlider.cs
+++ b/osu.Game/Rulesets/Objects/Legacy/Catch/ConvertSlider.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Objects.Types;
 using osuTK;
 
diff --git a/osu.Game/Rulesets/Objects/Legacy/Catch/ConvertSpinner.cs b/osu.Game/Rulesets/Objects/Legacy/Catch/ConvertSpinner.cs
index 014494ec54..cccb66d92b 100644
--- a/osu.Game/Rulesets/Objects/Legacy/Catch/ConvertSpinner.cs
+++ b/osu.Game/Rulesets/Objects/Legacy/Catch/ConvertSpinner.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Objects.Types;
 
 namespace osu.Game.Rulesets.Objects.Legacy.Catch
diff --git a/osu.Game/Rulesets/Objects/Legacy/ConvertHitObject.cs b/osu.Game/Rulesets/Objects/Legacy/ConvertHitObject.cs
index e3b0d8a498..d95f97624d 100644
--- a/osu.Game/Rulesets/Objects/Legacy/ConvertHitObject.cs
+++ b/osu.Game/Rulesets/Objects/Legacy/ConvertHitObject.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Judgements;
 using osu.Game.Rulesets.Scoring;
 
diff --git a/osu.Game/Rulesets/Objects/Legacy/ConvertSlider.cs b/osu.Game/Rulesets/Objects/Legacy/ConvertSlider.cs
index 9ff92fcc75..bd2713a7d1 100644
--- a/osu.Game/Rulesets/Objects/Legacy/ConvertSlider.cs
+++ b/osu.Game/Rulesets/Objects/Legacy/ConvertSlider.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Objects.Types;
 using System.Collections.Generic;
 using Newtonsoft.Json;
diff --git a/osu.Game/Rulesets/Objects/Legacy/Mania/ConvertHit.cs b/osu.Game/Rulesets/Objects/Legacy/Mania/ConvertHit.cs
index 0b69817c13..639cacb128 100644
--- a/osu.Game/Rulesets/Objects/Legacy/Mania/ConvertHit.cs
+++ b/osu.Game/Rulesets/Objects/Legacy/Mania/ConvertHit.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Objects.Types;
 
 namespace osu.Game.Rulesets.Objects.Legacy.Mania
diff --git a/osu.Game/Rulesets/Objects/Legacy/Mania/ConvertHitObjectParser.cs b/osu.Game/Rulesets/Objects/Legacy/Mania/ConvertHitObjectParser.cs
index 386eb8d3ee..6f1968b41d 100644
--- a/osu.Game/Rulesets/Objects/Legacy/Mania/ConvertHitObjectParser.cs
+++ b/osu.Game/Rulesets/Objects/Legacy/Mania/ConvertHitObjectParser.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.
 
+#nullable disable
+
 using osuTK;
 using osu.Game.Audio;
 using System.Collections.Generic;
diff --git a/osu.Game/Rulesets/Objects/Legacy/Mania/ConvertHold.cs b/osu.Game/Rulesets/Objects/Legacy/Mania/ConvertHold.cs
index 2fa4766c1d..b6594d0206 100644
--- a/osu.Game/Rulesets/Objects/Legacy/Mania/ConvertHold.cs
+++ b/osu.Game/Rulesets/Objects/Legacy/Mania/ConvertHold.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Objects.Types;
 
 namespace osu.Game.Rulesets.Objects.Legacy.Mania
diff --git a/osu.Game/Rulesets/Objects/Legacy/Mania/ConvertSlider.cs b/osu.Game/Rulesets/Objects/Legacy/Mania/ConvertSlider.cs
index 84cde5fa95..330ebf72c7 100644
--- a/osu.Game/Rulesets/Objects/Legacy/Mania/ConvertSlider.cs
+++ b/osu.Game/Rulesets/Objects/Legacy/Mania/ConvertSlider.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Objects.Types;
 
 namespace osu.Game.Rulesets.Objects.Legacy.Mania
diff --git a/osu.Game/Rulesets/Objects/Legacy/Mania/ConvertSpinner.cs b/osu.Game/Rulesets/Objects/Legacy/Mania/ConvertSpinner.cs
index c05aaceb9c..dcbaf22c51 100644
--- a/osu.Game/Rulesets/Objects/Legacy/Mania/ConvertSpinner.cs
+++ b/osu.Game/Rulesets/Objects/Legacy/Mania/ConvertSpinner.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Objects.Types;
 
 namespace osu.Game.Rulesets.Objects.Legacy.Mania
diff --git a/osu.Game/Rulesets/Objects/Legacy/Osu/ConvertHit.cs b/osu.Game/Rulesets/Objects/Legacy/Osu/ConvertHit.cs
index 069366bad3..33b390e3ba 100644
--- a/osu.Game/Rulesets/Objects/Legacy/Osu/ConvertHit.cs
+++ b/osu.Game/Rulesets/Objects/Legacy/Osu/ConvertHit.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Objects.Types;
 using osuTK;
 
diff --git a/osu.Game/Rulesets/Objects/Legacy/Osu/ConvertHitObjectParser.cs b/osu.Game/Rulesets/Objects/Legacy/Osu/ConvertHitObjectParser.cs
index cb98721be5..7a88a31bd5 100644
--- a/osu.Game/Rulesets/Objects/Legacy/Osu/ConvertHitObjectParser.cs
+++ b/osu.Game/Rulesets/Objects/Legacy/Osu/ConvertHitObjectParser.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.
 
+#nullable disable
+
 using osuTK;
 using System.Collections.Generic;
 using osu.Game.Audio;
diff --git a/osu.Game/Rulesets/Objects/Legacy/Osu/ConvertSlider.cs b/osu.Game/Rulesets/Objects/Legacy/Osu/ConvertSlider.cs
index e947690668..2f8e9dd352 100644
--- a/osu.Game/Rulesets/Objects/Legacy/Osu/ConvertSlider.cs
+++ b/osu.Game/Rulesets/Objects/Legacy/Osu/ConvertSlider.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Objects.Types;
 using osuTK;
 
diff --git a/osu.Game/Rulesets/Objects/Legacy/Osu/ConvertSpinner.cs b/osu.Game/Rulesets/Objects/Legacy/Osu/ConvertSpinner.cs
index e9e5ca8c94..d49e9fe9db 100644
--- a/osu.Game/Rulesets/Objects/Legacy/Osu/ConvertSpinner.cs
+++ b/osu.Game/Rulesets/Objects/Legacy/Osu/ConvertSpinner.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Objects.Types;
 using osuTK;
 
diff --git a/osu.Game/Rulesets/Objects/Legacy/Taiko/ConvertHit.cs b/osu.Game/Rulesets/Objects/Legacy/Taiko/ConvertHit.cs
index cb5178ce48..980d37ccd5 100644
--- a/osu.Game/Rulesets/Objects/Legacy/Taiko/ConvertHit.cs
+++ b/osu.Game/Rulesets/Objects/Legacy/Taiko/ConvertHit.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.
 
+#nullable disable
+
 namespace osu.Game.Rulesets.Objects.Legacy.Taiko
 {
     /// <summary>
diff --git a/osu.Game/Rulesets/Objects/Legacy/Taiko/ConvertHitObjectParser.cs b/osu.Game/Rulesets/Objects/Legacy/Taiko/ConvertHitObjectParser.cs
index 1eafc4e68b..d62e8cd04c 100644
--- a/osu.Game/Rulesets/Objects/Legacy/Taiko/ConvertHitObjectParser.cs
+++ b/osu.Game/Rulesets/Objects/Legacy/Taiko/ConvertHitObjectParser.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.
 
+#nullable disable
+
 using osuTK;
 using System.Collections.Generic;
 using osu.Game.Audio;
diff --git a/osu.Game/Rulesets/Objects/Legacy/Taiko/ConvertSlider.cs b/osu.Game/Rulesets/Objects/Legacy/Taiko/ConvertSlider.cs
index 821554f7ee..a391c8cb43 100644
--- a/osu.Game/Rulesets/Objects/Legacy/Taiko/ConvertSlider.cs
+++ b/osu.Game/Rulesets/Objects/Legacy/Taiko/ConvertSlider.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.
 
+#nullable disable
+
 namespace osu.Game.Rulesets.Objects.Legacy.Taiko
 {
     /// <summary>
diff --git a/osu.Game/Rulesets/Objects/Legacy/Taiko/ConvertSpinner.cs b/osu.Game/Rulesets/Objects/Legacy/Taiko/ConvertSpinner.cs
index 1d5ecb1ef3..ec8d7971ec 100644
--- a/osu.Game/Rulesets/Objects/Legacy/Taiko/ConvertSpinner.cs
+++ b/osu.Game/Rulesets/Objects/Legacy/Taiko/ConvertSpinner.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Objects.Types;
 
 namespace osu.Game.Rulesets.Objects.Legacy.Taiko
diff --git a/osu.Game/Rulesets/Objects/PathControlPoint.cs b/osu.Game/Rulesets/Objects/PathControlPoint.cs
index 53eb430fa3..ae9fa08085 100644
--- a/osu.Game/Rulesets/Objects/PathControlPoint.cs
+++ b/osu.Game/Rulesets/Objects/PathControlPoint.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.
 
+#nullable disable
+
 using System;
 using Newtonsoft.Json;
 using osu.Game.Rulesets.Objects.Types;
diff --git a/osu.Game/Rulesets/Objects/Pooling/PoolableDrawableWithLifetime.cs b/osu.Game/Rulesets/Objects/Pooling/PoolableDrawableWithLifetime.cs
index 9c6097a048..8dc588da9e 100644
--- a/osu.Game/Rulesets/Objects/Pooling/PoolableDrawableWithLifetime.cs
+++ b/osu.Game/Rulesets/Objects/Pooling/PoolableDrawableWithLifetime.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 enable
-
 using System;
 using System.Diagnostics;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Rulesets/Objects/Pooling/PooledDrawableWithLifetimeContainer.cs b/osu.Game/Rulesets/Objects/Pooling/PooledDrawableWithLifetimeContainer.cs
index d35933dba8..07a80895e6 100644
--- a/osu.Game/Rulesets/Objects/Pooling/PooledDrawableWithLifetimeContainer.cs
+++ b/osu.Game/Rulesets/Objects/Pooling/PooledDrawableWithLifetimeContainer.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 enable
-
 using System.Collections.Generic;
 using System.Diagnostics;
 using System.Linq;
diff --git a/osu.Game/Rulesets/Objects/SliderEventGenerator.cs b/osu.Game/Rulesets/Objects/SliderEventGenerator.cs
index bae5a5e8d9..d32a7cb16d 100644
--- a/osu.Game/Rulesets/Objects/SliderEventGenerator.cs
+++ b/osu.Game/Rulesets/Objects/SliderEventGenerator.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Rulesets/Objects/SliderPath.cs b/osu.Game/Rulesets/Objects/SliderPath.cs
index e0c62fe359..2285715564 100644
--- a/osu.Game/Rulesets/Objects/SliderPath.cs
+++ b/osu.Game/Rulesets/Objects/SliderPath.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Collections.Specialized;
diff --git a/osu.Game/Rulesets/Objects/SliderPathExtensions.cs b/osu.Game/Rulesets/Objects/SliderPathExtensions.cs
index dd418a1b7b..92a3b570fb 100644
--- a/osu.Game/Rulesets/Objects/SliderPathExtensions.cs
+++ b/osu.Game/Rulesets/Objects/SliderPathExtensions.cs
@@ -6,8 +6,6 @@ using osu.Game.Rulesets.Edit;
 using osu.Game.Rulesets.Objects.Types;
 using osuTK;
 
-#nullable enable
-
 namespace osu.Game.Rulesets.Objects
 {
     public static class SliderPathExtensions
diff --git a/osu.Game/Rulesets/Objects/SyntheticHitObjectEntry.cs b/osu.Game/Rulesets/Objects/SyntheticHitObjectEntry.cs
index 76f9eaf25a..ee860e82e2 100644
--- a/osu.Game/Rulesets/Objects/SyntheticHitObjectEntry.cs
+++ b/osu.Game/Rulesets/Objects/SyntheticHitObjectEntry.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Objects.Drawables;
 
 namespace osu.Game.Rulesets.Objects
diff --git a/osu.Game/Rulesets/Objects/Types/IHasColumn.cs b/osu.Game/Rulesets/Objects/Types/IHasColumn.cs
index dc07cfbb6a..3978a7e765 100644
--- a/osu.Game/Rulesets/Objects/Types/IHasColumn.cs
+++ b/osu.Game/Rulesets/Objects/Types/IHasColumn.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.
 
+#nullable disable
+
 namespace osu.Game.Rulesets.Objects.Types
 {
     /// <summary>
diff --git a/osu.Game/Rulesets/Objects/Types/IHasCombo.cs b/osu.Game/Rulesets/Objects/Types/IHasCombo.cs
index d1a4683a1d..d02b97a3e4 100644
--- a/osu.Game/Rulesets/Objects/Types/IHasCombo.cs
+++ b/osu.Game/Rulesets/Objects/Types/IHasCombo.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.
 
+#nullable disable
+
 namespace osu.Game.Rulesets.Objects.Types
 {
     /// <summary>
diff --git a/osu.Game/Rulesets/Objects/Types/IHasComboInformation.cs b/osu.Game/Rulesets/Objects/Types/IHasComboInformation.cs
index 29a56fc625..b45ea989f3 100644
--- a/osu.Game/Rulesets/Objects/Types/IHasComboInformation.cs
+++ b/osu.Game/Rulesets/Objects/Types/IHasComboInformation.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.
 
+#nullable disable
+
 using osu.Framework.Bindables;
 using osu.Game.Skinning;
 using osuTK.Graphics;
diff --git a/osu.Game/Rulesets/Objects/Types/IHasDisplayColour.cs b/osu.Game/Rulesets/Objects/Types/IHasDisplayColour.cs
index 8807b802d8..89ee5022bf 100644
--- a/osu.Game/Rulesets/Objects/Types/IHasDisplayColour.cs
+++ b/osu.Game/Rulesets/Objects/Types/IHasDisplayColour.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.
 
+#nullable disable
+
 using osu.Framework.Bindables;
 using osuTK.Graphics;
 
diff --git a/osu.Game/Rulesets/Objects/Types/IHasDistance.cs b/osu.Game/Rulesets/Objects/Types/IHasDistance.cs
index b497ca5da3..549abc046a 100644
--- a/osu.Game/Rulesets/Objects/Types/IHasDistance.cs
+++ b/osu.Game/Rulesets/Objects/Types/IHasDistance.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.
 
+#nullable disable
+
 namespace osu.Game.Rulesets.Objects.Types
 {
     /// <summary>
diff --git a/osu.Game/Rulesets/Objects/Types/IHasDuration.cs b/osu.Game/Rulesets/Objects/Types/IHasDuration.cs
index ca734da5ad..06ed8eba76 100644
--- a/osu.Game/Rulesets/Objects/Types/IHasDuration.cs
+++ b/osu.Game/Rulesets/Objects/Types/IHasDuration.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.
 
+#nullable disable
+
 namespace osu.Game.Rulesets.Objects.Types
 {
     /// <summary>
diff --git a/osu.Game/Rulesets/Objects/Types/IHasHold.cs b/osu.Game/Rulesets/Objects/Types/IHasHold.cs
index 469b8b7892..91b05dc3fd 100644
--- a/osu.Game/Rulesets/Objects/Types/IHasHold.cs
+++ b/osu.Game/Rulesets/Objects/Types/IHasHold.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.
 
+#nullable disable
+
 namespace osu.Game.Rulesets.Objects.Types
 {
     /// <summary>
diff --git a/osu.Game/Rulesets/Objects/Types/IHasLegacyLastTickOffset.cs b/osu.Game/Rulesets/Objects/Types/IHasLegacyLastTickOffset.cs
index caf22c3023..dfc526383a 100644
--- a/osu.Game/Rulesets/Objects/Types/IHasLegacyLastTickOffset.cs
+++ b/osu.Game/Rulesets/Objects/Types/IHasLegacyLastTickOffset.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.
 
+#nullable disable
+
 namespace osu.Game.Rulesets.Objects.Types
 {
     /// <summary>
diff --git a/osu.Game/Rulesets/Objects/Types/IHasPath.cs b/osu.Game/Rulesets/Objects/Types/IHasPath.cs
index 567c24a4a2..46834a55dd 100644
--- a/osu.Game/Rulesets/Objects/Types/IHasPath.cs
+++ b/osu.Game/Rulesets/Objects/Types/IHasPath.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.
 
+#nullable disable
+
 namespace osu.Game.Rulesets.Objects.Types
 {
     public interface IHasPath : IHasDistance
diff --git a/osu.Game/Rulesets/Objects/Types/IHasPathWithRepeats.cs b/osu.Game/Rulesets/Objects/Types/IHasPathWithRepeats.cs
index 279946b44e..536707e95f 100644
--- a/osu.Game/Rulesets/Objects/Types/IHasPathWithRepeats.cs
+++ b/osu.Game/Rulesets/Objects/Types/IHasPathWithRepeats.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.
 
+#nullable disable
+
 using osuTK;
 
 namespace osu.Game.Rulesets.Objects.Types
diff --git a/osu.Game/Rulesets/Objects/Types/IHasPosition.cs b/osu.Game/Rulesets/Objects/Types/IHasPosition.cs
index 8948fe59a9..281f619ba5 100644
--- a/osu.Game/Rulesets/Objects/Types/IHasPosition.cs
+++ b/osu.Game/Rulesets/Objects/Types/IHasPosition.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.
 
+#nullable disable
+
 using osuTK;
 
 namespace osu.Game.Rulesets.Objects.Types
diff --git a/osu.Game/Rulesets/Objects/Types/IHasRepeats.cs b/osu.Game/Rulesets/Objects/Types/IHasRepeats.cs
index 2a4215b960..821a6de520 100644
--- a/osu.Game/Rulesets/Objects/Types/IHasRepeats.cs
+++ b/osu.Game/Rulesets/Objects/Types/IHasRepeats.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.
 
+#nullable disable
+
 using osu.Game.Audio;
 using System.Collections.Generic;
 
diff --git a/osu.Game/Rulesets/Objects/Types/IHasXPosition.cs b/osu.Game/Rulesets/Objects/Types/IHasXPosition.cs
index 7e55b21050..f688c783e1 100644
--- a/osu.Game/Rulesets/Objects/Types/IHasXPosition.cs
+++ b/osu.Game/Rulesets/Objects/Types/IHasXPosition.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.
 
+#nullable disable
+
 namespace osu.Game.Rulesets.Objects.Types
 {
     /// <summary>
diff --git a/osu.Game/Rulesets/Objects/Types/IHasYPosition.cs b/osu.Game/Rulesets/Objects/Types/IHasYPosition.cs
index d2561b10a7..3c0cc595fb 100644
--- a/osu.Game/Rulesets/Objects/Types/IHasYPosition.cs
+++ b/osu.Game/Rulesets/Objects/Types/IHasYPosition.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.
 
+#nullable disable
+
 namespace osu.Game.Rulesets.Objects.Types
 {
     /// <summary>
diff --git a/osu.Game/Rulesets/Objects/Types/PathType.cs b/osu.Game/Rulesets/Objects/Types/PathType.cs
index 923ce9eba4..266a3de6ec 100644
--- a/osu.Game/Rulesets/Objects/Types/PathType.cs
+++ b/osu.Game/Rulesets/Objects/Types/PathType.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.
 
+#nullable disable
+
 namespace osu.Game.Rulesets.Objects.Types
 {
     public enum PathType
diff --git a/osu.Game/Rulesets/RealmRulesetStore.cs b/osu.Game/Rulesets/RealmRulesetStore.cs
index f42bf06da4..62a7a13c07 100644
--- a/osu.Game/Rulesets/RealmRulesetStore.cs
+++ b/osu.Game/Rulesets/RealmRulesetStore.cs
@@ -9,8 +9,6 @@ using osu.Framework.Logging;
 using osu.Framework.Platform;
 using osu.Game.Database;
 
-#nullable enable
-
 namespace osu.Game.Rulesets
 {
     public class RealmRulesetStore : RulesetStore
diff --git a/osu.Game/Rulesets/Replays/AutoGenerator.cs b/osu.Game/Rulesets/Replays/AutoGenerator.cs
index 83e85146d4..7fab84eba8 100644
--- a/osu.Game/Rulesets/Replays/AutoGenerator.cs
+++ b/osu.Game/Rulesets/Replays/AutoGenerator.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using JetBrains.Annotations;
diff --git a/osu.Game/Rulesets/Replays/FramedReplayInputHandler.cs b/osu.Game/Rulesets/Replays/FramedReplayInputHandler.cs
index f889d15485..09a090483d 100644
--- a/osu.Game/Rulesets/Replays/FramedReplayInputHandler.cs
+++ b/osu.Game/Rulesets/Replays/FramedReplayInputHandler.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 enable
-
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Rulesets/Replays/ReplayFrame.cs b/osu.Game/Rulesets/Replays/ReplayFrame.cs
index 2b67b60d8f..433be6e4b7 100644
--- a/osu.Game/Rulesets/Replays/ReplayFrame.cs
+++ b/osu.Game/Rulesets/Replays/ReplayFrame.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 enable
-
 using MessagePack;
 using osu.Game.Online.Spectator;
 
diff --git a/osu.Game/Rulesets/Replays/Types/IConvertibleReplayFrame.cs b/osu.Game/Rulesets/Replays/Types/IConvertibleReplayFrame.cs
index d9aa615c6e..6753a23bca 100644
--- a/osu.Game/Rulesets/Replays/Types/IConvertibleReplayFrame.cs
+++ b/osu.Game/Rulesets/Replays/Types/IConvertibleReplayFrame.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.
 
+#nullable disable
+
 using osu.Game.Beatmaps;
 using osu.Game.Replays.Legacy;
 
diff --git a/osu.Game/Rulesets/Ruleset.cs b/osu.Game/Rulesets/Ruleset.cs
index 9dec6984ea..8bde71dcd7 100644
--- a/osu.Game/Rulesets/Ruleset.cs
+++ b/osu.Game/Rulesets/Ruleset.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Concurrent;
 using System.Collections.Generic;
diff --git a/osu.Game/Rulesets/RulesetConfigCache.cs b/osu.Game/Rulesets/RulesetConfigCache.cs
index c4f1933cd8..017214df61 100644
--- a/osu.Game/Rulesets/RulesetConfigCache.cs
+++ b/osu.Game/Rulesets/RulesetConfigCache.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Rulesets/RulesetInfo.cs b/osu.Game/Rulesets/RulesetInfo.cs
index 88e3988431..b5e5fa1561 100644
--- a/osu.Game/Rulesets/RulesetInfo.cs
+++ b/osu.Game/Rulesets/RulesetInfo.cs
@@ -6,8 +6,6 @@ using JetBrains.Annotations;
 using osu.Framework.Testing;
 using Realms;
 
-#nullable enable
-
 namespace osu.Game.Rulesets
 {
     [ExcludeFromDynamicCompile]
diff --git a/osu.Game/Rulesets/RulesetLoadException.cs b/osu.Game/Rulesets/RulesetLoadException.cs
index 7c3a4bb75d..6fee8f446b 100644
--- a/osu.Game/Rulesets/RulesetLoadException.cs
+++ b/osu.Game/Rulesets/RulesetLoadException.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.
 
+#nullable disable
+
 using System;
 
 namespace osu.Game.Rulesets
diff --git a/osu.Game/Rulesets/RulesetSelector.cs b/osu.Game/Rulesets/RulesetSelector.cs
index 8e6ec556d2..35244eb86e 100644
--- a/osu.Game/Rulesets/RulesetSelector.cs
+++ b/osu.Game/Rulesets/RulesetSelector.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.
 
+#nullable disable
+
 using osu.Framework.Graphics.UserInterface;
 using osu.Framework.Allocation;
 
diff --git a/osu.Game/Rulesets/RulesetStore.cs b/osu.Game/Rulesets/RulesetStore.cs
index 6f88d97a58..6b3e43cc1c 100644
--- a/osu.Game/Rulesets/RulesetStore.cs
+++ b/osu.Game/Rulesets/RulesetStore.cs
@@ -10,8 +10,6 @@ using osu.Framework;
 using osu.Framework.Logging;
 using osu.Framework.Platform;
 
-#nullable enable
-
 namespace osu.Game.Rulesets
 {
     public abstract class RulesetStore : IDisposable, IRulesetStore
diff --git a/osu.Game/Rulesets/Scoring/AccumulatingHealthProcessor.cs b/osu.Game/Rulesets/Scoring/AccumulatingHealthProcessor.cs
index 5dfb5167f4..c6b9d227af 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.
 
+#nullable disable
+
 namespace osu.Game.Rulesets.Scoring
 {
     /// <summary>
diff --git a/osu.Game/Rulesets/Scoring/DrainingHealthProcessor.cs b/osu.Game/Rulesets/Scoring/DrainingHealthProcessor.cs
index e7bb6d79f8..65af161393 100644
--- a/osu.Game/Rulesets/Scoring/DrainingHealthProcessor.cs
+++ b/osu.Game/Rulesets/Scoring/DrainingHealthProcessor.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Rulesets/Scoring/HealthProcessor.cs b/osu.Game/Rulesets/Scoring/HealthProcessor.cs
index 0f51560476..0a1e6b729f 100644
--- a/osu.Game/Rulesets/Scoring/HealthProcessor.cs
+++ b/osu.Game/Rulesets/Scoring/HealthProcessor.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 enable
-
 using System;
 using osu.Framework.Bindables;
 using osu.Framework.Utils;
diff --git a/osu.Game/Rulesets/Scoring/HitEvent.cs b/osu.Game/Rulesets/Scoring/HitEvent.cs
index 0ebbec62ba..cabbf40a7d 100644
--- a/osu.Game/Rulesets/Scoring/HitEvent.cs
+++ b/osu.Game/Rulesets/Scoring/HitEvent.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.
 
+#nullable disable
+
 using JetBrains.Annotations;
 using osu.Game.Rulesets.Objects;
 using osuTK;
diff --git a/osu.Game/Rulesets/Scoring/HitEventExtensions.cs b/osu.Game/Rulesets/Scoring/HitEventExtensions.cs
index fea13cf4b6..2fde73d5a2 100644
--- a/osu.Game/Rulesets/Scoring/HitEventExtensions.cs
+++ b/osu.Game/Rulesets/Scoring/HitEventExtensions.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Rulesets/Scoring/HitResult.cs b/osu.Game/Rulesets/Scoring/HitResult.cs
index 9f03c381ee..bfa256fc20 100644
--- a/osu.Game/Rulesets/Scoring/HitResult.cs
+++ b/osu.Game/Rulesets/Scoring/HitResult.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.
 
+#nullable disable
+
 using System;
 using System.ComponentModel;
 using System.Diagnostics;
diff --git a/osu.Game/Rulesets/Scoring/HitWindows.cs b/osu.Game/Rulesets/Scoring/HitWindows.cs
index 2d008b58ba..99129fcf96 100644
--- a/osu.Game/Rulesets/Scoring/HitWindows.cs
+++ b/osu.Game/Rulesets/Scoring/HitWindows.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Diagnostics;
diff --git a/osu.Game/Rulesets/Scoring/JudgementProcessor.cs b/osu.Game/Rulesets/Scoring/JudgementProcessor.cs
index bfa67b8c45..12fe0056bb 100644
--- a/osu.Game/Rulesets/Scoring/JudgementProcessor.cs
+++ b/osu.Game/Rulesets/Scoring/JudgementProcessor.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 enable
-
 using System;
 using osu.Framework.Bindables;
 using osu.Framework.Extensions.ObjectExtensions;
diff --git a/osu.Game/Rulesets/Scoring/ScoreProcessor.cs b/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
index df094ddb7c..56bbe031e6 100644
--- a/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
+++ b/osu.Game/Rulesets/Scoring/ScoreProcessor.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 enable
-
 using System;
 using System.Collections.Generic;
 using System.Diagnostics;
diff --git a/osu.Game/Rulesets/Timing/MultiplierControlPoint.cs b/osu.Game/Rulesets/Timing/MultiplierControlPoint.cs
index 23325bcd13..1e80bd165b 100644
--- a/osu.Game/Rulesets/Timing/MultiplierControlPoint.cs
+++ b/osu.Game/Rulesets/Timing/MultiplierControlPoint.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.
 
+#nullable disable
+
 using System;
 using osu.Game.Beatmaps.ControlPoints;
 
diff --git a/osu.Game/Rulesets/UI/DrawableRuleset.cs b/osu.Game/Rulesets/UI/DrawableRuleset.cs
index be1105e7ff..95cb02c477 100644
--- a/osu.Game/Rulesets/UI/DrawableRuleset.cs
+++ b/osu.Game/Rulesets/UI/DrawableRuleset.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Rulesets/UI/DrawableRulesetDependencies.cs b/osu.Game/Rulesets/UI/DrawableRulesetDependencies.cs
index 53996b6b84..6a7369a150 100644
--- a/osu.Game/Rulesets/UI/DrawableRulesetDependencies.cs
+++ b/osu.Game/Rulesets/UI/DrawableRulesetDependencies.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.IO;
diff --git a/osu.Game/Rulesets/UI/FrameStabilityContainer.cs b/osu.Game/Rulesets/UI/FrameStabilityContainer.cs
index f2dbb1a23f..dcd7141419 100644
--- a/osu.Game/Rulesets/UI/FrameStabilityContainer.cs
+++ b/osu.Game/Rulesets/UI/FrameStabilityContainer.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Rulesets/UI/GameplayCursorContainer.cs b/osu.Game/Rulesets/UI/GameplayCursorContainer.cs
index ae5f9c6111..3149b7f890 100644
--- a/osu.Game/Rulesets/UI/GameplayCursorContainer.cs
+++ b/osu.Game/Rulesets/UI/GameplayCursorContainer.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.
 
+#nullable disable
+
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Cursor;
 
diff --git a/osu.Game/Rulesets/UI/GameplaySampleTriggerSource.cs b/osu.Game/Rulesets/UI/GameplaySampleTriggerSource.cs
index 6b5cdc4ddf..fd8fcfddab 100644
--- a/osu.Game/Rulesets/UI/GameplaySampleTriggerSource.cs
+++ b/osu.Game/Rulesets/UI/GameplaySampleTriggerSource.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.
 
+#nullable disable
+
 using System.Linq;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Audio;
diff --git a/osu.Game/Rulesets/UI/HitObjectContainer.cs b/osu.Game/Rulesets/UI/HitObjectContainer.cs
index fee77af0ba..589b585643 100644
--- a/osu.Game/Rulesets/UI/HitObjectContainer.cs
+++ b/osu.Game/Rulesets/UI/HitObjectContainer.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Rulesets/UI/IFrameStableClock.cs b/osu.Game/Rulesets/UI/IFrameStableClock.cs
index 569ef5e06c..132605adaf 100644
--- a/osu.Game/Rulesets/UI/IFrameStableClock.cs
+++ b/osu.Game/Rulesets/UI/IFrameStableClock.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.
 
+#nullable disable
+
 using osu.Framework.Bindables;
 using osu.Framework.Timing;
 
diff --git a/osu.Game/Rulesets/UI/IHitObjectContainer.cs b/osu.Game/Rulesets/UI/IHitObjectContainer.cs
index 4c784132e8..74fd7dee81 100644
--- a/osu.Game/Rulesets/UI/IHitObjectContainer.cs
+++ b/osu.Game/Rulesets/UI/IHitObjectContainer.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Game.Rulesets.Objects.Drawables;
 
diff --git a/osu.Game/Rulesets/UI/IPooledHitObjectProvider.cs b/osu.Game/Rulesets/UI/IPooledHitObjectProvider.cs
index 2d700076d6..b842e708b0 100644
--- a/osu.Game/Rulesets/UI/IPooledHitObjectProvider.cs
+++ b/osu.Game/Rulesets/UI/IPooledHitObjectProvider.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.
 
+#nullable disable
+
 using JetBrains.Annotations;
 using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Objects.Drawables;
diff --git a/osu.Game/Rulesets/UI/JudgementContainer.cs b/osu.Game/Rulesets/UI/JudgementContainer.cs
index f1a68a0323..4336977aa8 100644
--- a/osu.Game/Rulesets/UI/JudgementContainer.cs
+++ b/osu.Game/Rulesets/UI/JudgementContainer.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Rulesets.Judgements;
diff --git a/osu.Game/Rulesets/UI/ModIcon.cs b/osu.Game/Rulesets/UI/ModIcon.cs
index 79bada0490..0f21a497b0 100644
--- a/osu.Game/Rulesets/UI/ModIcon.cs
+++ b/osu.Game/Rulesets/UI/ModIcon.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.
 
+#nullable disable
+
 using System;
 using osuTK.Graphics;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Rulesets/UI/ModSwitchSmall.cs b/osu.Game/Rulesets/UI/ModSwitchSmall.cs
index 676bbac95c..1b777f3e88 100644
--- a/osu.Game/Rulesets/UI/ModSwitchSmall.cs
+++ b/osu.Game/Rulesets/UI/ModSwitchSmall.cs
@@ -13,8 +13,6 @@ using osu.Game.Rulesets.Mods;
 using osuTK;
 using osuTK.Graphics;
 
-#nullable enable
-
 namespace osu.Game.Rulesets.UI
 {
     public class ModSwitchSmall : CompositeDrawable
diff --git a/osu.Game/Rulesets/UI/ModSwitchTiny.cs b/osu.Game/Rulesets/UI/ModSwitchTiny.cs
index b1d453f588..1bb0fe535f 100644
--- a/osu.Game/Rulesets/UI/ModSwitchTiny.cs
+++ b/osu.Game/Rulesets/UI/ModSwitchTiny.cs
@@ -14,8 +14,6 @@ using osu.Game.Rulesets.Mods;
 using osuTK;
 using osuTK.Graphics;
 
-#nullable enable
-
 namespace osu.Game.Rulesets.UI
 {
     public class ModSwitchTiny : CompositeDrawable
diff --git a/osu.Game/Rulesets/UI/Playfield.cs b/osu.Game/Rulesets/UI/Playfield.cs
index ea5ffb10c6..60d1555052 100644
--- a/osu.Game/Rulesets/UI/Playfield.cs
+++ b/osu.Game/Rulesets/UI/Playfield.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Diagnostics;
diff --git a/osu.Game/Rulesets/UI/PlayfieldAdjustmentContainer.cs b/osu.Game/Rulesets/UI/PlayfieldAdjustmentContainer.cs
index fff4a450e5..d0e79281a7 100644
--- a/osu.Game/Rulesets/UI/PlayfieldAdjustmentContainer.cs
+++ b/osu.Game/Rulesets/UI/PlayfieldAdjustmentContainer.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 
diff --git a/osu.Game/Rulesets/UI/PlayfieldBorder.cs b/osu.Game/Rulesets/UI/PlayfieldBorder.cs
index 458b88c6db..a129760ef3 100644
--- a/osu.Game/Rulesets/UI/PlayfieldBorder.cs
+++ b/osu.Game/Rulesets/UI/PlayfieldBorder.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.
 
+#nullable disable
+
 using System.Linq;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Rulesets/UI/PlayfieldBorderStyle.cs b/osu.Game/Rulesets/UI/PlayfieldBorderStyle.cs
index 0a0aad884e..a4a483e930 100644
--- a/osu.Game/Rulesets/UI/PlayfieldBorderStyle.cs
+++ b/osu.Game/Rulesets/UI/PlayfieldBorderStyle.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.
 
+#nullable disable
+
 namespace osu.Game.Rulesets.UI
 {
     public enum PlayfieldBorderStyle
diff --git a/osu.Game/Rulesets/UI/ReplayRecorder.cs b/osu.Game/Rulesets/UI/ReplayRecorder.cs
index dcd8f12028..b04807e475 100644
--- a/osu.Game/Rulesets/UI/ReplayRecorder.cs
+++ b/osu.Game/Rulesets/UI/ReplayRecorder.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Rulesets/UI/RulesetInputManager.cs b/osu.Game/Rulesets/UI/RulesetInputManager.cs
index b5390eb6e2..f1ed23bb21 100644
--- a/osu.Game/Rulesets/UI/RulesetInputManager.cs
+++ b/osu.Game/Rulesets/UI/RulesetInputManager.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Rulesets/UI/Scrolling/Algorithms/ConstantScrollAlgorithm.cs b/osu.Game/Rulesets/UI/Scrolling/Algorithms/ConstantScrollAlgorithm.cs
index ab6e07f424..0bd8aa64c9 100644
--- a/osu.Game/Rulesets/UI/Scrolling/Algorithms/ConstantScrollAlgorithm.cs
+++ b/osu.Game/Rulesets/UI/Scrolling/Algorithms/ConstantScrollAlgorithm.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.
 
+#nullable disable
+
 namespace osu.Game.Rulesets.UI.Scrolling.Algorithms
 {
     public class ConstantScrollAlgorithm : IScrollAlgorithm
diff --git a/osu.Game/Rulesets/UI/Scrolling/Algorithms/IScrollAlgorithm.cs b/osu.Game/Rulesets/UI/Scrolling/Algorithms/IScrollAlgorithm.cs
index c394a05bcc..d2fb9e3531 100644
--- a/osu.Game/Rulesets/UI/Scrolling/Algorithms/IScrollAlgorithm.cs
+++ b/osu.Game/Rulesets/UI/Scrolling/Algorithms/IScrollAlgorithm.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.
 
+#nullable disable
+
 namespace osu.Game.Rulesets.UI.Scrolling.Algorithms
 {
     public interface IScrollAlgorithm
diff --git a/osu.Game/Rulesets/UI/Scrolling/Algorithms/OverlappingScrollAlgorithm.cs b/osu.Game/Rulesets/UI/Scrolling/Algorithms/OverlappingScrollAlgorithm.cs
index 7b827e0c63..d41117bce8 100644
--- a/osu.Game/Rulesets/UI/Scrolling/Algorithms/OverlappingScrollAlgorithm.cs
+++ b/osu.Game/Rulesets/UI/Scrolling/Algorithms/OverlappingScrollAlgorithm.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Lists;
 using osu.Game.Rulesets.Timing;
diff --git a/osu.Game/Rulesets/UI/Scrolling/Algorithms/SequentialScrollAlgorithm.cs b/osu.Game/Rulesets/UI/Scrolling/Algorithms/SequentialScrollAlgorithm.cs
index 45d3b3bcd4..bfddc22573 100644
--- a/osu.Game/Rulesets/UI/Scrolling/Algorithms/SequentialScrollAlgorithm.cs
+++ b/osu.Game/Rulesets/UI/Scrolling/Algorithms/SequentialScrollAlgorithm.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Diagnostics;
diff --git a/osu.Game/Rulesets/UI/Scrolling/DrawableScrollingRuleset.cs b/osu.Game/Rulesets/UI/Scrolling/DrawableScrollingRuleset.cs
index 926f2fd539..d8a8a6ccd8 100644
--- a/osu.Game/Rulesets/UI/Scrolling/DrawableScrollingRuleset.cs
+++ b/osu.Game/Rulesets/UI/Scrolling/DrawableScrollingRuleset.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Rulesets/UI/Scrolling/IScrollingInfo.cs b/osu.Game/Rulesets/UI/Scrolling/IScrollingInfo.cs
index cd85932599..e00f0ffe5d 100644
--- a/osu.Game/Rulesets/UI/Scrolling/IScrollingInfo.cs
+++ b/osu.Game/Rulesets/UI/Scrolling/IScrollingInfo.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.
 
+#nullable disable
+
 using osu.Framework.Bindables;
 using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.UI.Scrolling.Algorithms;
diff --git a/osu.Game/Rulesets/UI/Scrolling/ScrollingDirection.cs b/osu.Game/Rulesets/UI/Scrolling/ScrollingDirection.cs
index 81e1a6c916..58bb80accd 100644
--- a/osu.Game/Rulesets/UI/Scrolling/ScrollingDirection.cs
+++ b/osu.Game/Rulesets/UI/Scrolling/ScrollingDirection.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.
 
+#nullable disable
+
 namespace osu.Game.Rulesets.UI.Scrolling
 {
     public enum ScrollingDirection
diff --git a/osu.Game/Rulesets/UI/Scrolling/ScrollingHitObjectContainer.cs b/osu.Game/Rulesets/UI/Scrolling/ScrollingHitObjectContainer.cs
index 3b15bc2cdf..0ed3ca1e63 100644
--- a/osu.Game/Rulesets/UI/Scrolling/ScrollingHitObjectContainer.cs
+++ b/osu.Game/Rulesets/UI/Scrolling/ScrollingHitObjectContainer.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Diagnostics;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Rulesets/UI/Scrolling/ScrollingPlayfield.cs b/osu.Game/Rulesets/UI/Scrolling/ScrollingPlayfield.cs
index 782255733f..078f06b745 100644
--- a/osu.Game/Rulesets/UI/Scrolling/ScrollingPlayfield.cs
+++ b/osu.Game/Rulesets/UI/Scrolling/ScrollingPlayfield.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Game.Rulesets.Objects.Drawables;
diff --git a/osu.Game/Scoring/EFScoreInfo.cs b/osu.Game/Scoring/EFScoreInfo.cs
index 4161336cfc..8a5bbbf0da 100644
--- a/osu.Game/Scoring/EFScoreInfo.cs
+++ b/osu.Game/Scoring/EFScoreInfo.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.ComponentModel.DataAnnotations.Schema;
diff --git a/osu.Game/Scoring/HitResultDisplayStatistic.cs b/osu.Game/Scoring/HitResultDisplayStatistic.cs
index d43d8bf0ba..4603ff053e 100644
--- a/osu.Game/Scoring/HitResultDisplayStatistic.cs
+++ b/osu.Game/Scoring/HitResultDisplayStatistic.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Scoring;
 
 namespace osu.Game.Scoring
diff --git a/osu.Game/Scoring/IScoreInfo.cs b/osu.Game/Scoring/IScoreInfo.cs
index b4ad183cd3..289679a724 100644
--- a/osu.Game/Scoring/IScoreInfo.cs
+++ b/osu.Game/Scoring/IScoreInfo.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.
 
+#nullable disable
+
 using System;
 using osu.Game.Beatmaps;
 using osu.Game.Database;
diff --git a/osu.Game/Scoring/Legacy/DatabasedLegacyScoreDecoder.cs b/osu.Game/Scoring/Legacy/DatabasedLegacyScoreDecoder.cs
index 03e13455f0..8908163646 100644
--- a/osu.Game/Scoring/Legacy/DatabasedLegacyScoreDecoder.cs
+++ b/osu.Game/Scoring/Legacy/DatabasedLegacyScoreDecoder.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.
 
+#nullable disable
+
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets;
 
diff --git a/osu.Game/Scoring/Legacy/LegacyScoreDecoder.cs b/osu.Game/Scoring/Legacy/LegacyScoreDecoder.cs
index 754ace82c5..f64e730c06 100644
--- a/osu.Game/Scoring/Legacy/LegacyScoreDecoder.cs
+++ b/osu.Game/Scoring/Legacy/LegacyScoreDecoder.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.
 
+#nullable disable
+
 using System;
 using System.IO;
 using System.Linq;
diff --git a/osu.Game/Scoring/Legacy/LegacyScoreEncoder.cs b/osu.Game/Scoring/Legacy/LegacyScoreEncoder.cs
index ae9afbf32e..85cf463a13 100644
--- a/osu.Game/Scoring/Legacy/LegacyScoreEncoder.cs
+++ b/osu.Game/Scoring/Legacy/LegacyScoreEncoder.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 enable
-
 using System;
 using System.IO;
 using System.Linq;
diff --git a/osu.Game/Scoring/Legacy/ScoreInfoExtensions.cs b/osu.Game/Scoring/Legacy/ScoreInfoExtensions.cs
index a11cd5fcbd..0219111e5c 100644
--- a/osu.Game/Scoring/Legacy/ScoreInfoExtensions.cs
+++ b/osu.Game/Scoring/Legacy/ScoreInfoExtensions.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Scoring;
 
 namespace osu.Game.Scoring.Legacy
diff --git a/osu.Game/Scoring/LegacyDatabasedScore.cs b/osu.Game/Scoring/LegacyDatabasedScore.cs
index ac444c1bf3..de35cb5faf 100644
--- a/osu.Game/Scoring/LegacyDatabasedScore.cs
+++ b/osu.Game/Scoring/LegacyDatabasedScore.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using osu.Framework.IO.Stores;
diff --git a/osu.Game/Scoring/Score.cs b/osu.Game/Scoring/Score.cs
index 83e4389dc8..06bc3edd37 100644
--- a/osu.Game/Scoring/Score.cs
+++ b/osu.Game/Scoring/Score.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.
 
+#nullable disable
+
 using osu.Game.Replays;
 using osu.Game.Utils;
 
diff --git a/osu.Game/Scoring/ScoreFileInfo.cs b/osu.Game/Scoring/ScoreFileInfo.cs
index 8acc98eff6..6c3509bccd 100644
--- a/osu.Game/Scoring/ScoreFileInfo.cs
+++ b/osu.Game/Scoring/ScoreFileInfo.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.
 
+#nullable disable
+
 using System.ComponentModel.DataAnnotations;
 using osu.Game.Database;
 using osu.Game.IO;
diff --git a/osu.Game/Scoring/ScoreImporter.cs b/osu.Game/Scoring/ScoreImporter.cs
index 7d1aa4b01d..f59ffc7c94 100644
--- a/osu.Game/Scoring/ScoreImporter.cs
+++ b/osu.Game/Scoring/ScoreImporter.cs
@@ -15,8 +15,6 @@ using osu.Game.Rulesets;
 using osu.Game.Scoring.Legacy;
 using Realms;
 
-#nullable enable
-
 namespace osu.Game.Scoring
 {
     public class ScoreImporter : RealmArchiveModelImporter<ScoreInfo>
diff --git a/osu.Game/Scoring/ScoreInfo.cs b/osu.Game/Scoring/ScoreInfo.cs
index d7185a1677..cbe9615380 100644
--- a/osu.Game/Scoring/ScoreInfo.cs
+++ b/osu.Game/Scoring/ScoreInfo.cs
@@ -20,8 +20,6 @@ using osu.Game.Users;
 using osu.Game.Utils;
 using Realms;
 
-#nullable enable
-
 namespace osu.Game.Scoring
 {
     [ExcludeFromDynamicCompile]
diff --git a/osu.Game/Scoring/ScoreInfoExtensions.cs b/osu.Game/Scoring/ScoreInfoExtensions.cs
index 2279337fef..7979ca8aaa 100644
--- a/osu.Game/Scoring/ScoreInfoExtensions.cs
+++ b/osu.Game/Scoring/ScoreInfoExtensions.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.
 
+#nullable disable
+
 using osu.Game.Beatmaps;
 
 namespace osu.Game.Scoring
diff --git a/osu.Game/Scoring/ScoreManager.cs b/osu.Game/Scoring/ScoreManager.cs
index 4627ca414a..7ccf7a58b8 100644
--- a/osu.Game/Scoring/ScoreManager.cs
+++ b/osu.Game/Scoring/ScoreManager.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Scoring/ScoreModelDownloader.cs b/osu.Game/Scoring/ScoreModelDownloader.cs
index 514b7a57de..8625c6c5d0 100644
--- a/osu.Game/Scoring/ScoreModelDownloader.cs
+++ b/osu.Game/Scoring/ScoreModelDownloader.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.
 
+#nullable disable
+
 using osu.Game.Database;
 using osu.Game.Extensions;
 using osu.Game.Online.API;
diff --git a/osu.Game/Scoring/ScorePerformanceCache.cs b/osu.Game/Scoring/ScorePerformanceCache.cs
index e15d59e648..f51fb41497 100644
--- a/osu.Game/Scoring/ScorePerformanceCache.cs
+++ b/osu.Game/Scoring/ScorePerformanceCache.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.
 
+#nullable disable
+
 using System;
 using System.Threading;
 using System.Threading.Tasks;
diff --git a/osu.Game/Scoring/ScoreRank.cs b/osu.Game/Scoring/ScoreRank.cs
index 64f7da9ba3..9de8561b4a 100644
--- a/osu.Game/Scoring/ScoreRank.cs
+++ b/osu.Game/Scoring/ScoreRank.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.
 
+#nullable disable
+
 using System.ComponentModel;
 using osu.Framework.Localisation;
 using osu.Game.Resources.Localisation.Web;
diff --git a/osu.Game/Scoring/ScoringValues.cs b/osu.Game/Scoring/ScoringValues.cs
index d31cd7c68b..9bc4e6e12a 100644
--- a/osu.Game/Scoring/ScoringValues.cs
+++ b/osu.Game/Scoring/ScoringValues.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.
 
+#nullable disable
+
 using MessagePack;
 using osu.Game.Rulesets.Judgements;
 using osu.Game.Rulesets.Objects;
diff --git a/osu.Game/Screens/BackgroundScreen.cs b/osu.Game/Screens/BackgroundScreen.cs
index 6084ec4b01..8e1fd63040 100644
--- a/osu.Game/Screens/BackgroundScreen.cs
+++ b/osu.Game/Screens/BackgroundScreen.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Screens;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Screens/BackgroundScreenStack.cs b/osu.Game/Screens/BackgroundScreenStack.cs
index 9f562a618e..bafd1ff348 100644
--- a/osu.Game/Screens/BackgroundScreenStack.cs
+++ b/osu.Game/Screens/BackgroundScreenStack.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Framework.Graphics;
 using osu.Framework.Screens;
diff --git a/osu.Game/Screens/Backgrounds/BackgroundScreenBeatmap.cs b/osu.Game/Screens/Backgrounds/BackgroundScreenBeatmap.cs
index 65bc9cfaea..ca05c8af46 100644
--- a/osu.Game/Screens/Backgrounds/BackgroundScreenBeatmap.cs
+++ b/osu.Game/Screens/Backgrounds/BackgroundScreenBeatmap.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.
 
+#nullable disable
+
 using System;
 using System.Threading;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Screens/Backgrounds/BackgroundScreenBlack.cs b/osu.Game/Screens/Backgrounds/BackgroundScreenBlack.cs
index d946fd41d9..4b0f262ab1 100644
--- a/osu.Game/Screens/Backgrounds/BackgroundScreenBlack.cs
+++ b/osu.Game/Screens/Backgrounds/BackgroundScreenBlack.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Screens;
diff --git a/osu.Game/Screens/Backgrounds/BackgroundScreenCustom.cs b/osu.Game/Screens/Backgrounds/BackgroundScreenCustom.cs
index 49c7934ed9..3dd72685e9 100644
--- a/osu.Game/Screens/Backgrounds/BackgroundScreenCustom.cs
+++ b/osu.Game/Screens/Backgrounds/BackgroundScreenCustom.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.
 
+#nullable disable
+
 using osu.Game.Graphics.Backgrounds;
 
 namespace osu.Game.Screens.Backgrounds
diff --git a/osu.Game/Screens/Backgrounds/BackgroundScreenDefault.cs b/osu.Game/Screens/Backgrounds/BackgroundScreenDefault.cs
index 452f033dcc..95bcb2ab29 100644
--- a/osu.Game/Screens/Backgrounds/BackgroundScreenDefault.cs
+++ b/osu.Game/Screens/Backgrounds/BackgroundScreenDefault.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.
 
+#nullable disable
+
 using System.Threading;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Screens/Edit/BindableBeatDivisor.cs b/osu.Game/Screens/Edit/BindableBeatDivisor.cs
index 8f430dce77..a7faf961cf 100644
--- a/osu.Game/Screens/Edit/BindableBeatDivisor.cs
+++ b/osu.Game/Screens/Edit/BindableBeatDivisor.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.
 
+#nullable disable
+
 using System.Linq;
 using osu.Framework.Bindables;
 using osu.Game.Graphics;
diff --git a/osu.Game/Screens/Edit/BottomBar.cs b/osu.Game/Screens/Edit/BottomBar.cs
index 62caaced89..444911cf2d 100644
--- a/osu.Game/Screens/Edit/BottomBar.cs
+++ b/osu.Game/Screens/Edit/BottomBar.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Screens/Edit/ClipboardContent.cs b/osu.Game/Screens/Edit/ClipboardContent.cs
index 0348a7c15d..a39b24e7bb 100644
--- a/osu.Game/Screens/Edit/ClipboardContent.cs
+++ b/osu.Game/Screens/Edit/ClipboardContent.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using Newtonsoft.Json;
diff --git a/osu.Game/Screens/Edit/Components/BottomBarContainer.cs b/osu.Game/Screens/Edit/Components/BottomBarContainer.cs
index 3c63da3a4a..482a0bbe5f 100644
--- a/osu.Game/Screens/Edit/Components/BottomBarContainer.cs
+++ b/osu.Game/Screens/Edit/Components/BottomBarContainer.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Audio.Track;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Screens/Edit/Components/CircularButton.cs b/osu.Game/Screens/Edit/Components/CircularButton.cs
index 40b5ac663a..74e4162102 100644
--- a/osu.Game/Screens/Edit/Components/CircularButton.cs
+++ b/osu.Game/Screens/Edit/Components/CircularButton.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.
 
+#nullable disable
+
 using osu.Game.Graphics.UserInterface;
 using osuTK;
 
diff --git a/osu.Game/Screens/Edit/Components/EditorSidebar.cs b/osu.Game/Screens/Edit/Components/EditorSidebar.cs
index 4e9b1d5222..da15512cdc 100644
--- a/osu.Game/Screens/Edit/Components/EditorSidebar.cs
+++ b/osu.Game/Screens/Edit/Components/EditorSidebar.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Screens/Edit/Components/EditorSidebarSection.cs b/osu.Game/Screens/Edit/Components/EditorSidebarSection.cs
index 3871720562..6782b2f357 100644
--- a/osu.Game/Screens/Edit/Components/EditorSidebarSection.cs
+++ b/osu.Game/Screens/Edit/Components/EditorSidebarSection.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Screens/Edit/Components/Menus/DifficultyMenuItem.cs b/osu.Game/Screens/Edit/Components/Menus/DifficultyMenuItem.cs
index f17fe4c3ce..ec1e621491 100644
--- a/osu.Game/Screens/Edit/Components/Menus/DifficultyMenuItem.cs
+++ b/osu.Game/Screens/Edit/Components/Menus/DifficultyMenuItem.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Graphics.Sprites;
 using osu.Game.Beatmaps;
diff --git a/osu.Game/Screens/Edit/Components/Menus/EditorMenuBar.cs b/osu.Game/Screens/Edit/Components/Menus/EditorMenuBar.cs
index 20b8bba6da..8321fde171 100644
--- a/osu.Game/Screens/Edit/Components/Menus/EditorMenuBar.cs
+++ b/osu.Game/Screens/Edit/Components/Menus/EditorMenuBar.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.UserInterface;
diff --git a/osu.Game/Screens/Edit/Components/Menus/EditorMenuItem.cs b/osu.Game/Screens/Edit/Components/Menus/EditorMenuItem.cs
index 0a2c073dcd..1085f2c277 100644
--- a/osu.Game/Screens/Edit/Components/Menus/EditorMenuItem.cs
+++ b/osu.Game/Screens/Edit/Components/Menus/EditorMenuItem.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.
 
+#nullable disable
+
 using System;
 using osu.Game.Graphics.UserInterface;
 
diff --git a/osu.Game/Screens/Edit/Components/Menus/EditorMenuItemSpacer.cs b/osu.Game/Screens/Edit/Components/Menus/EditorMenuItemSpacer.cs
index 4e75a92e19..6af3b99017 100644
--- a/osu.Game/Screens/Edit/Components/Menus/EditorMenuItemSpacer.cs
+++ b/osu.Game/Screens/Edit/Components/Menus/EditorMenuItemSpacer.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.
 
+#nullable disable
+
 namespace osu.Game.Screens.Edit.Components.Menus
 {
     public class EditorMenuItemSpacer : EditorMenuItem
diff --git a/osu.Game/Screens/Edit/Components/Menus/EditorScreenSwitcherControl.cs b/osu.Game/Screens/Edit/Components/Menus/EditorScreenSwitcherControl.cs
index 8b868a4649..0bba5a79ab 100644
--- a/osu.Game/Screens/Edit/Components/Menus/EditorScreenSwitcherControl.cs
+++ b/osu.Game/Screens/Edit/Components/Menus/EditorScreenSwitcherControl.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Shapes;
diff --git a/osu.Game/Screens/Edit/Components/PlaybackControl.cs b/osu.Game/Screens/Edit/Components/PlaybackControl.cs
index d1a999c2d1..30316cb12c 100644
--- a/osu.Game/Screens/Edit/Components/PlaybackControl.cs
+++ b/osu.Game/Screens/Edit/Components/PlaybackControl.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.
 
+#nullable disable
+
 using System.Linq;
 using osuTK;
 using osuTK.Graphics;
diff --git a/osu.Game/Screens/Edit/Components/RadioButtons/EditorRadioButton.cs b/osu.Game/Screens/Edit/Components/RadioButtons/EditorRadioButton.cs
index d66856ebd8..82e94dc862 100644
--- a/osu.Game/Screens/Edit/Components/RadioButtons/EditorRadioButton.cs
+++ b/osu.Game/Screens/Edit/Components/RadioButtons/EditorRadioButton.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.Color4Extensions;
diff --git a/osu.Game/Screens/Edit/Components/RadioButtons/EditorRadioButtonCollection.cs b/osu.Game/Screens/Edit/Components/RadioButtons/EditorRadioButtonCollection.cs
index 6a7b0c9ef7..b8d1cca061 100644
--- a/osu.Game/Screens/Edit/Components/RadioButtons/EditorRadioButtonCollection.cs
+++ b/osu.Game/Screens/Edit/Components/RadioButtons/EditorRadioButtonCollection.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Framework.Extensions.IEnumerableExtensions;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Screens/Edit/Components/RadioButtons/RadioButton.cs b/osu.Game/Screens/Edit/Components/RadioButtons/RadioButton.cs
index ca79dd15d7..03745ce19d 100644
--- a/osu.Game/Screens/Edit/Components/RadioButtons/RadioButton.cs
+++ b/osu.Game/Screens/Edit/Components/RadioButtons/RadioButton.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Screens/Edit/Components/TernaryButtons/DrawableTernaryButton.cs b/osu.Game/Screens/Edit/Components/TernaryButtons/DrawableTernaryButton.cs
index c43561eaa7..82a9db956a 100644
--- a/osu.Game/Screens/Edit/Components/TernaryButtons/DrawableTernaryButton.cs
+++ b/osu.Game/Screens/Edit/Components/TernaryButtons/DrawableTernaryButton.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Screens/Edit/Components/TernaryButtons/TernaryButton.cs b/osu.Game/Screens/Edit/Components/TernaryButtons/TernaryButton.cs
index 7f64695bde..8eb781c947 100644
--- a/osu.Game/Screens/Edit/Components/TernaryButtons/TernaryButton.cs
+++ b/osu.Game/Screens/Edit/Components/TernaryButtons/TernaryButton.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Screens/Edit/Components/TimeInfoContainer.cs b/osu.Game/Screens/Edit/Components/TimeInfoContainer.cs
index bd5377e578..7051dd226c 100644
--- a/osu.Game/Screens/Edit/Components/TimeInfoContainer.cs
+++ b/osu.Game/Screens/Edit/Components/TimeInfoContainer.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Game.Graphics.Sprites;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/BookmarkPart.cs b/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/BookmarkPart.cs
index 8298cf4773..058aa83b97 100644
--- a/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/BookmarkPart.cs
+++ b/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/BookmarkPart.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Game.Graphics;
 using osu.Game.Screens.Edit.Components.Timelines.Summary.Visualisations;
diff --git a/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/BreakPart.cs b/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/BreakPart.cs
index 3d535ec915..4dbec880dc 100644
--- a/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/BreakPart.cs
+++ b/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/BreakPart.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Game.Beatmaps.Timing;
 using osu.Game.Graphics;
diff --git a/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/ControlPointPart.cs b/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/ControlPointPart.cs
index f1edb7dc7e..4e2c018330 100644
--- a/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/ControlPointPart.cs
+++ b/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/ControlPointPart.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Specialized;
 using System.Linq;
diff --git a/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/ControlPointVisualisation.cs b/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/ControlPointVisualisation.cs
index 41716f9c23..89c0309222 100644
--- a/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/ControlPointVisualisation.cs
+++ b/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/ControlPointVisualisation.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Game.Beatmaps.ControlPoints;
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 7c14152b3d..b2007273e8 100644
--- a/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/EffectPointVisualisation.cs
+++ b/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/EffectPointVisualisation.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.
 
+#nullable disable
+
 using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/GroupVisualisation.cs b/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/GroupVisualisation.cs
index 88587399f2..cccb646ba4 100644
--- a/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/GroupVisualisation.cs
+++ b/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/GroupVisualisation.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.
 
+#nullable disable
+
 using System.Linq;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/IControlPointVisualisation.cs b/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/IControlPointVisualisation.cs
index c81f1828f7..b9e2a969a5 100644
--- a/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/IControlPointVisualisation.cs
+++ b/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/IControlPointVisualisation.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.
 
+#nullable disable
+
 using osu.Game.Beatmaps.ControlPoints;
 
 namespace osu.Game.Screens.Edit.Components.Timelines.Summary.Parts
diff --git a/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/MarkerPart.cs b/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/MarkerPart.cs
index d551333616..c00ebb32bc 100644
--- a/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/MarkerPart.cs
+++ b/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/MarkerPart.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/TimelinePart.cs b/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/TimelinePart.cs
index 5aba81aa7d..c1ae2ff8d1 100644
--- a/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/TimelinePart.cs
+++ b/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/TimelinePart.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Audio.Track;
diff --git a/osu.Game/Screens/Edit/Components/Timelines/Summary/SummaryTimeline.cs b/osu.Game/Screens/Edit/Components/Timelines/Summary/SummaryTimeline.cs
index 1706c47c96..afaedee0a9 100644
--- a/osu.Game/Screens/Edit/Components/Timelines/Summary/SummaryTimeline.cs
+++ b/osu.Game/Screens/Edit/Components/Timelines/Summary/SummaryTimeline.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Screens/Edit/Components/Timelines/Summary/TestGameplayButton.cs b/osu.Game/Screens/Edit/Components/Timelines/Summary/TestGameplayButton.cs
index 99cdc014aa..d38596b9be 100644
--- a/osu.Game/Screens/Edit/Components/Timelines/Summary/TestGameplayButton.cs
+++ b/osu.Game/Screens/Edit/Components/Timelines/Summary/TestGameplayButton.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Sprites;
diff --git a/osu.Game/Screens/Edit/Components/Timelines/Summary/Visualisations/DurationVisualisation.cs b/osu.Game/Screens/Edit/Components/Timelines/Summary/Visualisations/DurationVisualisation.cs
index ec68bf9c00..88e40cb305 100644
--- a/osu.Game/Screens/Edit/Components/Timelines/Summary/Visualisations/DurationVisualisation.cs
+++ b/osu.Game/Screens/Edit/Components/Timelines/Summary/Visualisations/DurationVisualisation.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Shapes;
 
diff --git a/osu.Game/Screens/Edit/Components/Timelines/Summary/Visualisations/PointVisualisation.cs b/osu.Game/Screens/Edit/Components/Timelines/Summary/Visualisations/PointVisualisation.cs
index a4b6b0c392..b8e55c8db8 100644
--- a/osu.Game/Screens/Edit/Components/Timelines/Summary/Visualisations/PointVisualisation.cs
+++ b/osu.Game/Screens/Edit/Components/Timelines/Summary/Visualisations/PointVisualisation.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Shapes;
 
diff --git a/osu.Game/Screens/Edit/Compose/Components/BeatDivisorControl.cs b/osu.Game/Screens/Edit/Compose/Components/BeatDivisorControl.cs
index bf4d70baa6..6a94fce78a 100644
--- a/osu.Game/Screens/Edit/Compose/Components/BeatDivisorControl.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/BeatDivisorControl.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.
 
+#nullable disable
+
 using System;
 using System.Diagnostics;
 using System.Linq;
diff --git a/osu.Game/Screens/Edit/Compose/Components/BeatDivisorPresetCollection.cs b/osu.Game/Screens/Edit/Compose/Components/BeatDivisorPresetCollection.cs
index 4616669c6d..67b346fb64 100644
--- a/osu.Game/Screens/Edit/Compose/Components/BeatDivisorPresetCollection.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/BeatDivisorPresetCollection.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Screens/Edit/Compose/Components/BeatDivisorType.cs b/osu.Game/Screens/Edit/Compose/Components/BeatDivisorType.cs
index 4a25144881..ebdb030e76 100644
--- a/osu.Game/Screens/Edit/Compose/Components/BeatDivisorType.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/BeatDivisorType.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.
 
+#nullable disable
+
 namespace osu.Game.Screens.Edit.Compose.Components
 {
     public enum BeatDivisorType
diff --git a/osu.Game/Screens/Edit/Compose/Components/BlueprintContainer.cs b/osu.Game/Screens/Edit/Compose/Components/BlueprintContainer.cs
index fbec80a63b..c7bf23865b 100644
--- a/osu.Game/Screens/Edit/Compose/Components/BlueprintContainer.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/BlueprintContainer.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Collections.Specialized;
diff --git a/osu.Game/Screens/Edit/Compose/Components/CircularDistanceSnapGrid.cs b/osu.Game/Screens/Edit/Compose/Components/CircularDistanceSnapGrid.cs
index 771612fcf1..98079116cd 100644
--- a/osu.Game/Screens/Edit/Compose/Components/CircularDistanceSnapGrid.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/CircularDistanceSnapGrid.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.Color4Extensions;
diff --git a/osu.Game/Screens/Edit/Compose/Components/ComposeBlueprintContainer.cs b/osu.Game/Screens/Edit/Compose/Components/ComposeBlueprintContainer.cs
index 0be2cb4462..ba43704a5f 100644
--- a/osu.Game/Screens/Edit/Compose/Components/ComposeBlueprintContainer.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/ComposeBlueprintContainer.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using Humanizer;
diff --git a/osu.Game/Screens/Edit/Compose/Components/DistanceSnapGrid.cs b/osu.Game/Screens/Edit/Compose/Components/DistanceSnapGrid.cs
index 1f64a50c02..69c7fc2775 100644
--- a/osu.Game/Screens/Edit/Compose/Components/DistanceSnapGrid.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/DistanceSnapGrid.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Screens/Edit/Compose/Components/DragBox.cs b/osu.Game/Screens/Edit/Compose/Components/DragBox.cs
index ecbac82db0..838562719d 100644
--- a/osu.Game/Screens/Edit/Compose/Components/DragBox.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/DragBox.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.
 
+#nullable disable
+
 using System;
 using osu.Framework;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Screens/Edit/Compose/Components/EditorBlueprintContainer.cs b/osu.Game/Screens/Edit/Compose/Components/EditorBlueprintContainer.cs
index 22b211f257..6a4fe27f04 100644
--- a/osu.Game/Screens/Edit/Compose/Components/EditorBlueprintContainer.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/EditorBlueprintContainer.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Screens/Edit/Compose/Components/EditorSelectionHandler.cs b/osu.Game/Screens/Edit/Compose/Components/EditorSelectionHandler.cs
index 7f693996a4..1c9faadda1 100644
--- a/osu.Game/Screens/Edit/Compose/Components/EditorSelectionHandler.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/EditorSelectionHandler.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Screens/Edit/Compose/Components/HitObjectOrderedSelectionContainer.cs b/osu.Game/Screens/Edit/Compose/Components/HitObjectOrderedSelectionContainer.cs
index 3fc26fa974..06af232111 100644
--- a/osu.Game/Screens/Edit/Compose/Components/HitObjectOrderedSelectionContainer.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/HitObjectOrderedSelectionContainer.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Screens/Edit/Compose/Components/MoveSelectionEvent.cs b/osu.Game/Screens/Edit/Compose/Components/MoveSelectionEvent.cs
index 2b71bb2f16..46d948f8b6 100644
--- a/osu.Game/Screens/Edit/Compose/Components/MoveSelectionEvent.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/MoveSelectionEvent.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Edit;
 using osuTK;
 
diff --git a/osu.Game/Screens/Edit/Compose/Components/RectangularPositionSnapGrid.cs b/osu.Game/Screens/Edit/Compose/Components/RectangularPositionSnapGrid.cs
index f0d26c7b6a..64fb2ccaba 100644
--- a/osu.Game/Screens/Edit/Compose/Components/RectangularPositionSnapGrid.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/RectangularPositionSnapGrid.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Screens/Edit/Compose/Components/SelectionBox.cs b/osu.Game/Screens/Edit/Compose/Components/SelectionBox.cs
index cda986c7cd..2c4c220ad0 100644
--- a/osu.Game/Screens/Edit/Compose/Components/SelectionBox.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/SelectionBox.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Screens/Edit/Compose/Components/SelectionBoxButton.cs b/osu.Game/Screens/Edit/Compose/Components/SelectionBoxButton.cs
index 346bb2b508..3d6dacc95e 100644
--- a/osu.Game/Screens/Edit/Compose/Components/SelectionBoxButton.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/SelectionBoxButton.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Screens/Edit/Compose/Components/SelectionBoxControl.cs b/osu.Game/Screens/Edit/Compose/Components/SelectionBoxControl.cs
index 8f22e67922..c4675685f6 100644
--- a/osu.Game/Screens/Edit/Compose/Components/SelectionBoxControl.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/SelectionBoxControl.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Screens/Edit/Compose/Components/SelectionBoxDragHandle.cs b/osu.Game/Screens/Edit/Compose/Components/SelectionBoxDragHandle.cs
index c37fefeed4..308d0cc893 100644
--- a/osu.Game/Screens/Edit/Compose/Components/SelectionBoxDragHandle.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/SelectionBoxDragHandle.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Input.Events;
 
diff --git a/osu.Game/Screens/Edit/Compose/Components/SelectionBoxDragHandleContainer.cs b/osu.Game/Screens/Edit/Compose/Components/SelectionBoxDragHandleContainer.cs
index 397158b9f6..5c7debf57e 100644
--- a/osu.Game/Screens/Edit/Compose/Components/SelectionBoxDragHandleContainer.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/SelectionBoxDragHandleContainer.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using JetBrains.Annotations;
diff --git a/osu.Game/Screens/Edit/Compose/Components/SelectionBoxRotationHandle.cs b/osu.Game/Screens/Edit/Compose/Components/SelectionBoxRotationHandle.cs
index f13ed0456a..761cd118bf 100644
--- a/osu.Game/Screens/Edit/Compose/Components/SelectionBoxRotationHandle.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/SelectionBoxRotationHandle.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Screens/Edit/Compose/Components/SelectionBoxScaleHandle.cs b/osu.Game/Screens/Edit/Compose/Components/SelectionBoxScaleHandle.cs
index 1f82f28380..bd1e2f4649 100644
--- a/osu.Game/Screens/Edit/Compose/Components/SelectionBoxScaleHandle.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/SelectionBoxScaleHandle.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Screens/Edit/Compose/Components/SelectionHandler.cs b/osu.Game/Screens/Edit/Compose/Components/SelectionHandler.cs
index e5020afcde..96bd352cf9 100644
--- a/osu.Game/Screens/Edit/Compose/Components/SelectionHandler.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/SelectionHandler.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/CentreMarker.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/CentreMarker.cs
index 8c8b38d9ea..6c545f8f78 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/CentreMarker.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/CentreMarker.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/DifficultyPointPiece.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/DifficultyPointPiece.cs
index eaaa663fe7..b028f67ba1 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/DifficultyPointPiece.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/DifficultyPointPiece.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.
 
+#nullable disable
+
 using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/HitObjectPointPiece.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/HitObjectPointPiece.cs
index 6b62459c97..1091afe226 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/HitObjectPointPiece.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/HitObjectPointPiece.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/SamplePointPiece.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/SamplePointPiece.cs
index 9abea73f6b..847c96b762 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/SamplePointPiece.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/SamplePointPiece.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 enable
-
 using System.Collections.Generic;
 using System.Linq;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/Timeline.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/Timeline.cs
index 89e9fb2404..37fc4b03b2 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/Timeline.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/Timeline.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Audio.Track;
diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineArea.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineArea.cs
index 4cffebc57c..97dc04b9fa 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineArea.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineArea.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineBlueprintContainer.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineBlueprintContainer.cs
index 1c0c2fb215..138e28fa06 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineBlueprintContainer.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineBlueprintContainer.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineButton.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineButton.cs
index e0b21b2e22..0832dc02a9 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineButton.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineButton.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Overlays;
diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineControlPointDisplay.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineControlPointDisplay.cs
index 8520567fa9..5d5681ea2b 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineControlPointDisplay.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineControlPointDisplay.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.
 
+#nullable disable
+
 using System.Collections.Specialized;
 using System.Linq;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineControlPointGroup.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineControlPointGroup.cs
index 9610f6424c..4017a745e1 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineControlPointGroup.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineControlPointGroup.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.
 
+#nullable disable
+
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineDragBox.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineDragBox.cs
index 8aad8aa6dc..c026c169d6 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineDragBox.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineDragBox.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineHitObjectBlueprint.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineHitObjectBlueprint.cs
index 33ea137d51..34abe81ae2 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineHitObjectBlueprint.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineHitObjectBlueprint.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.
 
+#nullable disable
+
 using System;
 using JetBrains.Annotations;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineSelectionHandler.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineSelectionHandler.cs
index da12ab521f..d91b95888b 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineSelectionHandler.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineSelectionHandler.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Diagnostics;
diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineTickDisplay.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineTickDisplay.cs
index 9904d91653..076ce224f0 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineTickDisplay.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineTickDisplay.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimingPointPiece.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimingPointPiece.cs
index 2df4ef001c..cf62707839 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimingPointPiece.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimingPointPiece.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Game.Beatmaps.ControlPoints;
diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/TopPointPiece.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/TopPointPiece.cs
index 60a9e1ed66..28ae77c931 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/TopPointPiece.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/TopPointPiece.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/ZoomableScrollContainer.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/ZoomableScrollContainer.cs
index bc6c66625c..80cdef38e9 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/ZoomableScrollContainer.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/ZoomableScrollContainer.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Screens/Edit/Compose/ComposeScreen.cs b/osu.Game/Screens/Edit/Compose/ComposeScreen.cs
index 2cde962b12..ef670c9fcf 100644
--- a/osu.Game/Screens/Edit/Compose/ComposeScreen.cs
+++ b/osu.Game/Screens/Edit/Compose/ComposeScreen.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.
 
+#nullable disable
+
 using System.Diagnostics;
 using System.Linq;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Screens/Edit/Compose/HitObjectUsageEventBuffer.cs b/osu.Game/Screens/Edit/Compose/HitObjectUsageEventBuffer.cs
index 621c901fb9..3df5139924 100644
--- a/osu.Game/Screens/Edit/Compose/HitObjectUsageEventBuffer.cs
+++ b/osu.Game/Screens/Edit/Compose/HitObjectUsageEventBuffer.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Screens/Edit/Compose/IPlacementHandler.cs b/osu.Game/Screens/Edit/Compose/IPlacementHandler.cs
index 59eb13cae5..46d9555e0c 100644
--- a/osu.Game/Screens/Edit/Compose/IPlacementHandler.cs
+++ b/osu.Game/Screens/Edit/Compose/IPlacementHandler.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Game.Rulesets.Objects;
 
diff --git a/osu.Game/Screens/Edit/CreateNewDifficultyDialog.cs b/osu.Game/Screens/Edit/CreateNewDifficultyDialog.cs
index aa6ca280ee..36c4e397a7 100644
--- a/osu.Game/Screens/Edit/CreateNewDifficultyDialog.cs
+++ b/osu.Game/Screens/Edit/CreateNewDifficultyDialog.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.
 
+#nullable disable
+
 using osu.Framework.Graphics.Sprites;
 using osu.Game.Overlays.Dialog;
 
diff --git a/osu.Game/Screens/Edit/Design/DesignScreen.cs b/osu.Game/Screens/Edit/Design/DesignScreen.cs
index f15639733c..546a07f17d 100644
--- a/osu.Game/Screens/Edit/Design/DesignScreen.cs
+++ b/osu.Game/Screens/Edit/Design/DesignScreen.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.
 
+#nullable disable
+
 namespace osu.Game.Screens.Edit.Design
 {
     public class DesignScreen : EditorScreen
diff --git a/osu.Game/Screens/Edit/Editor.cs b/osu.Game/Screens/Edit/Editor.cs
index 1fbc1b4bd6..d0d4c0ba1e 100644
--- a/osu.Game/Screens/Edit/Editor.cs
+++ b/osu.Game/Screens/Edit/Editor.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Diagnostics;
diff --git a/osu.Game/Screens/Edit/EditorBeatmap.cs b/osu.Game/Screens/Edit/EditorBeatmap.cs
index c9449f3259..fa3cb51473 100644
--- a/osu.Game/Screens/Edit/EditorBeatmap.cs
+++ b/osu.Game/Screens/Edit/EditorBeatmap.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.
 
+#nullable disable
+
 using System;
 using System.Collections;
 using System.Collections.Generic;
diff --git a/osu.Game/Screens/Edit/EditorBeatmapSkin.cs b/osu.Game/Screens/Edit/EditorBeatmapSkin.cs
index f650ffa5a3..244fd5f1e9 100644
--- a/osu.Game/Screens/Edit/EditorBeatmapSkin.cs
+++ b/osu.Game/Screens/Edit/EditorBeatmapSkin.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using osu.Framework.Audio.Sample;
diff --git a/osu.Game/Screens/Edit/EditorChangeHandler.cs b/osu.Game/Screens/Edit/EditorChangeHandler.cs
index 333c518d3a..1a93f3f101 100644
--- a/osu.Game/Screens/Edit/EditorChangeHandler.cs
+++ b/osu.Game/Screens/Edit/EditorChangeHandler.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.IO;
diff --git a/osu.Game/Screens/Edit/EditorClipboard.cs b/osu.Game/Screens/Edit/EditorClipboard.cs
index f6f0c09e00..f749f4bad6 100644
--- a/osu.Game/Screens/Edit/EditorClipboard.cs
+++ b/osu.Game/Screens/Edit/EditorClipboard.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.
 
+#nullable disable
+
 using osu.Framework.Bindables;
 
 namespace osu.Game.Screens.Edit
diff --git a/osu.Game/Screens/Edit/EditorClock.cs b/osu.Game/Screens/Edit/EditorClock.cs
index 86e5729196..c7df36be77 100644
--- a/osu.Game/Screens/Edit/EditorClock.cs
+++ b/osu.Game/Screens/Edit/EditorClock.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using osu.Framework.Audio.Track;
diff --git a/osu.Game/Screens/Edit/EditorLoader.cs b/osu.Game/Screens/Edit/EditorLoader.cs
index 0a2b8437fa..702e22a272 100644
--- a/osu.Game/Screens/Edit/EditorLoader.cs
+++ b/osu.Game/Screens/Edit/EditorLoader.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.
 
+#nullable disable
+
 using System;
 using JetBrains.Annotations;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Screens/Edit/EditorRoundedScreenSettings.cs b/osu.Game/Screens/Edit/EditorRoundedScreenSettings.cs
index 94a83a82aa..013971960b 100644
--- a/osu.Game/Screens/Edit/EditorRoundedScreenSettings.cs
+++ b/osu.Game/Screens/Edit/EditorRoundedScreenSettings.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Screens/Edit/EditorRoundedScreenSettingsSection.cs b/osu.Game/Screens/Edit/EditorRoundedScreenSettingsSection.cs
index 25d7dfbb4a..be1545cac8 100644
--- a/osu.Game/Screens/Edit/EditorRoundedScreenSettingsSection.cs
+++ b/osu.Game/Screens/Edit/EditorRoundedScreenSettingsSection.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Screens/Edit/EditorScreen.cs b/osu.Game/Screens/Edit/EditorScreen.cs
index 31c34edd7c..92709484ff 100644
--- a/osu.Game/Screens/Edit/EditorScreen.cs
+++ b/osu.Game/Screens/Edit/EditorScreen.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Screens/Edit/EditorScreenMode.cs b/osu.Game/Screens/Edit/EditorScreenMode.cs
index ecd39f9b57..81fcf23cdf 100644
--- a/osu.Game/Screens/Edit/EditorScreenMode.cs
+++ b/osu.Game/Screens/Edit/EditorScreenMode.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.
 
+#nullable disable
+
 using System.ComponentModel;
 
 namespace osu.Game.Screens.Edit
diff --git a/osu.Game/Screens/Edit/EditorScreenWithTimeline.cs b/osu.Game/Screens/Edit/EditorScreenWithTimeline.cs
index 0b80af68f2..b3aafb9730 100644
--- a/osu.Game/Screens/Edit/EditorScreenWithTimeline.cs
+++ b/osu.Game/Screens/Edit/EditorScreenWithTimeline.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.
 
+#nullable disable
+
 using JetBrains.Annotations;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Screens/Edit/EditorSkinProvidingContainer.cs b/osu.Game/Screens/Edit/EditorSkinProvidingContainer.cs
index 694d0253e0..d4387a0263 100644
--- a/osu.Game/Screens/Edit/EditorSkinProvidingContainer.cs
+++ b/osu.Game/Screens/Edit/EditorSkinProvidingContainer.cs
@@ -3,8 +3,6 @@
 
 using osu.Game.Skinning;
 
-#nullable enable
-
 namespace osu.Game.Screens.Edit
 {
     /// <summary>
diff --git a/osu.Game/Screens/Edit/EditorState.cs b/osu.Game/Screens/Edit/EditorState.cs
index 4690074e3d..1751de4d3e 100644
--- a/osu.Game/Screens/Edit/EditorState.cs
+++ b/osu.Game/Screens/Edit/EditorState.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 enable
-
 namespace osu.Game.Screens.Edit
 {
     /// <summary>
diff --git a/osu.Game/Screens/Edit/EditorTable.cs b/osu.Game/Screens/Edit/EditorTable.cs
index 26819dcfe7..8765dae384 100644
--- a/osu.Game/Screens/Edit/EditorTable.cs
+++ b/osu.Game/Screens/Edit/EditorTable.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.LocalisationExtensions;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Screens/Edit/GameplayTest/EditorPlayer.cs b/osu.Game/Screens/Edit/GameplayTest/EditorPlayer.cs
index f7e450b0e2..87e640badc 100644
--- a/osu.Game/Screens/Edit/GameplayTest/EditorPlayer.cs
+++ b/osu.Game/Screens/Edit/GameplayTest/EditorPlayer.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Screens;
 using osu.Game.Beatmaps;
diff --git a/osu.Game/Screens/Edit/GameplayTest/EditorPlayerLoader.cs b/osu.Game/Screens/Edit/GameplayTest/EditorPlayerLoader.cs
index c16bb8677c..d3260f1e7d 100644
--- a/osu.Game/Screens/Edit/GameplayTest/EditorPlayerLoader.cs
+++ b/osu.Game/Screens/Edit/GameplayTest/EditorPlayerLoader.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Screens;
diff --git a/osu.Game/Screens/Edit/GameplayTest/SaveBeforeGameplayTestDialog.cs b/osu.Game/Screens/Edit/GameplayTest/SaveBeforeGameplayTestDialog.cs
index 9334c74706..37e1c99d98 100644
--- a/osu.Game/Screens/Edit/GameplayTest/SaveBeforeGameplayTestDialog.cs
+++ b/osu.Game/Screens/Edit/GameplayTest/SaveBeforeGameplayTestDialog.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Graphics.Sprites;
 using osu.Game.Overlays.Dialog;
diff --git a/osu.Game/Screens/Edit/HitAnimationsMenuItem.cs b/osu.Game/Screens/Edit/HitAnimationsMenuItem.cs
index fb7ab39f7a..3e1e0c4cfe 100644
--- a/osu.Game/Screens/Edit/HitAnimationsMenuItem.cs
+++ b/osu.Game/Screens/Edit/HitAnimationsMenuItem.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.
 
+#nullable disable
+
 using JetBrains.Annotations;
 using osu.Framework.Bindables;
 using osu.Game.Graphics.UserInterface;
diff --git a/osu.Game/Screens/Edit/IEditorChangeHandler.cs b/osu.Game/Screens/Edit/IEditorChangeHandler.cs
index 0283421b8c..e7abc1c43d 100644
--- a/osu.Game/Screens/Edit/IEditorChangeHandler.cs
+++ b/osu.Game/Screens/Edit/IEditorChangeHandler.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.
 
+#nullable disable
+
 using System;
 using osu.Game.Rulesets.Objects;
 
diff --git a/osu.Game/Screens/Edit/LegacyEditorBeatmapPatcher.cs b/osu.Game/Screens/Edit/LegacyEditorBeatmapPatcher.cs
index 3ed2a7efe2..4e3b6e0aee 100644
--- a/osu.Game/Screens/Edit/LegacyEditorBeatmapPatcher.cs
+++ b/osu.Game/Screens/Edit/LegacyEditorBeatmapPatcher.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Diagnostics;
diff --git a/osu.Game/Screens/Edit/PromptForSaveDialog.cs b/osu.Game/Screens/Edit/PromptForSaveDialog.cs
index 4f70491ade..59a697d91c 100644
--- a/osu.Game/Screens/Edit/PromptForSaveDialog.cs
+++ b/osu.Game/Screens/Edit/PromptForSaveDialog.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Graphics.Sprites;
 using osu.Game.Overlays.Dialog;
diff --git a/osu.Game/Screens/Edit/Setup/ColoursSection.cs b/osu.Game/Screens/Edit/Setup/ColoursSection.cs
index 05d9855a24..621abf5580 100644
--- a/osu.Game/Screens/Edit/Setup/ColoursSection.cs
+++ b/osu.Game/Screens/Edit/Setup/ColoursSection.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Localisation;
diff --git a/osu.Game/Screens/Edit/Setup/DesignSection.cs b/osu.Game/Screens/Edit/Setup/DesignSection.cs
index d5d93db050..12a6843067 100644
--- a/osu.Game/Screens/Edit/Setup/DesignSection.cs
+++ b/osu.Game/Screens/Edit/Setup/DesignSection.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.
 
+#nullable disable
+
 using System;
 using System.Globalization;
 using System.Linq;
diff --git a/osu.Game/Screens/Edit/Setup/DifficultySection.cs b/osu.Game/Screens/Edit/Setup/DifficultySection.cs
index e799081115..5ce5d05d64 100644
--- a/osu.Game/Screens/Edit/Setup/DifficultySection.cs
+++ b/osu.Game/Screens/Edit/Setup/DifficultySection.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.
 
+#nullable disable
+
 using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Screens/Edit/Setup/FileChooserLabelledTextBox.cs b/osu.Game/Screens/Edit/Setup/FileChooserLabelledTextBox.cs
index fd916894ea..c13026a891 100644
--- a/osu.Game/Screens/Edit/Setup/FileChooserLabelledTextBox.cs
+++ b/osu.Game/Screens/Edit/Setup/FileChooserLabelledTextBox.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 enable
-
 using System;
 using System.Collections.Generic;
 using System.IO;
diff --git a/osu.Game/Screens/Edit/Setup/LabelledRomanisedTextBox.cs b/osu.Game/Screens/Edit/Setup/LabelledRomanisedTextBox.cs
index c39b4d6f41..a9cf5357c8 100644
--- a/osu.Game/Screens/Edit/Setup/LabelledRomanisedTextBox.cs
+++ b/osu.Game/Screens/Edit/Setup/LabelledRomanisedTextBox.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.
 
+#nullable disable
+
 using osu.Game.Beatmaps;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Graphics.UserInterfaceV2;
diff --git a/osu.Game/Screens/Edit/Setup/LabelledTextBoxWithPopover.cs b/osu.Game/Screens/Edit/Setup/LabelledTextBoxWithPopover.cs
index 799311dd2d..0eb74df575 100644
--- a/osu.Game/Screens/Edit/Setup/LabelledTextBoxWithPopover.cs
+++ b/osu.Game/Screens/Edit/Setup/LabelledTextBoxWithPopover.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Extensions;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Screens/Edit/Setup/MetadataSection.cs b/osu.Game/Screens/Edit/Setup/MetadataSection.cs
index 6262b4c18b..854dec2001 100644
--- a/osu.Game/Screens/Edit/Setup/MetadataSection.cs
+++ b/osu.Game/Screens/Edit/Setup/MetadataSection.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.
 
+#nullable disable
+
 using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics.UserInterface;
diff --git a/osu.Game/Screens/Edit/Setup/ResourcesSection.cs b/osu.Game/Screens/Edit/Setup/ResourcesSection.cs
index 1e97218074..7c487d3bf8 100644
--- a/osu.Game/Screens/Edit/Setup/ResourcesSection.cs
+++ b/osu.Game/Screens/Edit/Setup/ResourcesSection.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.
 
+#nullable disable
+
 using System.IO;
 using System.Linq;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Screens/Edit/Setup/RulesetSetupSection.cs b/osu.Game/Screens/Edit/Setup/RulesetSetupSection.cs
index 935842ff99..db0641feba 100644
--- a/osu.Game/Screens/Edit/Setup/RulesetSetupSection.cs
+++ b/osu.Game/Screens/Edit/Setup/RulesetSetupSection.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.
 
+#nullable disable
+
 using osu.Framework.Localisation;
 using osu.Game.Rulesets;
 
diff --git a/osu.Game/Screens/Edit/Setup/SetupScreen.cs b/osu.Game/Screens/Edit/Setup/SetupScreen.cs
index e0fc5f1aff..036202a503 100644
--- a/osu.Game/Screens/Edit/Setup/SetupScreen.cs
+++ b/osu.Game/Screens/Edit/Setup/SetupScreen.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Screens/Edit/Setup/SetupScreenHeader.cs b/osu.Game/Screens/Edit/Setup/SetupScreenHeader.cs
index 2412f1c4ed..c531f1da90 100644
--- a/osu.Game/Screens/Edit/Setup/SetupScreenHeader.cs
+++ b/osu.Game/Screens/Edit/Setup/SetupScreenHeader.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Screens/Edit/Setup/SetupScreenHeaderBackground.cs b/osu.Game/Screens/Edit/Setup/SetupScreenHeaderBackground.cs
index 17fb97d41f..5680d75f4e 100644
--- a/osu.Game/Screens/Edit/Setup/SetupScreenHeaderBackground.cs
+++ b/osu.Game/Screens/Edit/Setup/SetupScreenHeaderBackground.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Screens/Edit/Setup/SetupSection.cs b/osu.Game/Screens/Edit/Setup/SetupSection.cs
index 02bb05d227..727a94a590 100644
--- a/osu.Game/Screens/Edit/Setup/SetupSection.cs
+++ b/osu.Game/Screens/Edit/Setup/SetupSection.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Screens/Edit/Timing/ControlPointSettings.cs b/osu.Game/Screens/Edit/Timing/ControlPointSettings.cs
index 938c7f9cf0..1f95156aba 100644
--- a/osu.Game/Screens/Edit/Timing/ControlPointSettings.cs
+++ b/osu.Game/Screens/Edit/Timing/ControlPointSettings.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Framework.Graphics;
 
diff --git a/osu.Game/Screens/Edit/Timing/ControlPointTable.cs b/osu.Game/Screens/Edit/Timing/ControlPointTable.cs
index 77d875b67f..88c738c1d2 100644
--- a/osu.Game/Screens/Edit/Timing/ControlPointTable.cs
+++ b/osu.Game/Screens/Edit/Timing/ControlPointTable.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Screens/Edit/Timing/EffectSection.cs b/osu.Game/Screens/Edit/Timing/EffectSection.cs
index c9f73411f1..f7e59a75f1 100644
--- a/osu.Game/Screens/Edit/Timing/EffectSection.cs
+++ b/osu.Game/Screens/Edit/Timing/EffectSection.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Screens/Edit/Timing/GroupSection.cs b/osu.Game/Screens/Edit/Timing/GroupSection.cs
index f613488aae..e78cd18024 100644
--- a/osu.Game/Screens/Edit/Timing/GroupSection.cs
+++ b/osu.Game/Screens/Edit/Timing/GroupSection.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.
 
+#nullable disable
+
 using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Screens/Edit/Timing/IndeterminateSliderWithTextBoxInput.cs b/osu.Game/Screens/Edit/Timing/IndeterminateSliderWithTextBoxInput.cs
index 16a04982f5..ea6c6f31e4 100644
--- a/osu.Game/Screens/Edit/Timing/IndeterminateSliderWithTextBoxInput.cs
+++ b/osu.Game/Screens/Edit/Timing/IndeterminateSliderWithTextBoxInput.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.
 
+#nullable disable
+
 using System;
 using System.Globalization;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Screens/Edit/Timing/LabelledTimeSignature.cs b/osu.Game/Screens/Edit/Timing/LabelledTimeSignature.cs
index 51b58bd3dc..d05777e793 100644
--- a/osu.Game/Screens/Edit/Timing/LabelledTimeSignature.cs
+++ b/osu.Game/Screens/Edit/Timing/LabelledTimeSignature.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Screens/Edit/Timing/MetronomeDisplay.cs b/osu.Game/Screens/Edit/Timing/MetronomeDisplay.cs
index 2ecd66a05f..270d544dcf 100644
--- a/osu.Game/Screens/Edit/Timing/MetronomeDisplay.cs
+++ b/osu.Game/Screens/Edit/Timing/MetronomeDisplay.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
diff --git a/osu.Game/Screens/Edit/Timing/RepeatingButtonBehaviour.cs b/osu.Game/Screens/Edit/Timing/RepeatingButtonBehaviour.cs
index 3b78402f8a..cd3ced53da 100644
--- a/osu.Game/Screens/Edit/Timing/RepeatingButtonBehaviour.cs
+++ b/osu.Game/Screens/Edit/Timing/RepeatingButtonBehaviour.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
diff --git a/osu.Game/Screens/Edit/Timing/RowAttribute.cs b/osu.Game/Screens/Edit/Timing/RowAttribute.cs
index 46bb62c9e0..e73a343583 100644
--- a/osu.Game/Screens/Edit/Timing/RowAttribute.cs
+++ b/osu.Game/Screens/Edit/Timing/RowAttribute.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Screens/Edit/Timing/RowAttributes/AttributeProgressBar.cs b/osu.Game/Screens/Edit/Timing/RowAttributes/AttributeProgressBar.cs
index 6f7e790489..a8d2172f58 100644
--- a/osu.Game/Screens/Edit/Timing/RowAttributes/AttributeProgressBar.cs
+++ b/osu.Game/Screens/Edit/Timing/RowAttributes/AttributeProgressBar.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Game.Beatmaps.ControlPoints;
diff --git a/osu.Game/Screens/Edit/Timing/RowAttributes/AttributeText.cs b/osu.Game/Screens/Edit/Timing/RowAttributes/AttributeText.cs
index d0a51f9faa..d65ef1799a 100644
--- a/osu.Game/Screens/Edit/Timing/RowAttributes/AttributeText.cs
+++ b/osu.Game/Screens/Edit/Timing/RowAttributes/AttributeText.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Game.Beatmaps.ControlPoints;
diff --git a/osu.Game/Screens/Edit/Timing/RowAttributes/DifficultyRowAttribute.cs b/osu.Game/Screens/Edit/Timing/RowAttributes/DifficultyRowAttribute.cs
index a8de476d67..17f8b01d07 100644
--- a/osu.Game/Screens/Edit/Timing/RowAttributes/DifficultyRowAttribute.cs
+++ b/osu.Game/Screens/Edit/Timing/RowAttributes/DifficultyRowAttribute.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Screens/Edit/Timing/RowAttributes/EffectRowAttribute.cs b/osu.Game/Screens/Edit/Timing/RowAttributes/EffectRowAttribute.cs
index 1b33fd62aa..ef682dd3ad 100644
--- a/osu.Game/Screens/Edit/Timing/RowAttributes/EffectRowAttribute.cs
+++ b/osu.Game/Screens/Edit/Timing/RowAttributes/EffectRowAttribute.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Screens/Edit/Timing/RowAttributes/SampleRowAttribute.cs b/osu.Game/Screens/Edit/Timing/RowAttributes/SampleRowAttribute.cs
index ac0797dba1..e06f6b7bfb 100644
--- a/osu.Game/Screens/Edit/Timing/RowAttributes/SampleRowAttribute.cs
+++ b/osu.Game/Screens/Edit/Timing/RowAttributes/SampleRowAttribute.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Screens/Edit/Timing/RowAttributes/TimingRowAttribute.cs b/osu.Game/Screens/Edit/Timing/RowAttributes/TimingRowAttribute.cs
index 8a07088545..0b498650d4 100644
--- a/osu.Game/Screens/Edit/Timing/RowAttributes/TimingRowAttribute.cs
+++ b/osu.Game/Screens/Edit/Timing/RowAttributes/TimingRowAttribute.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Extensions;
diff --git a/osu.Game/Screens/Edit/Timing/Section.cs b/osu.Game/Screens/Edit/Timing/Section.cs
index 17147c21f4..02789c0cbf 100644
--- a/osu.Game/Screens/Edit/Timing/Section.cs
+++ b/osu.Game/Screens/Edit/Timing/Section.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.
 
+#nullable disable
+
 using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Screens/Edit/Timing/SliderWithTextBoxInput.cs b/osu.Game/Screens/Edit/Timing/SliderWithTextBoxInput.cs
index 9f036f0215..6a804c7e3e 100644
--- a/osu.Game/Screens/Edit/Timing/SliderWithTextBoxInput.cs
+++ b/osu.Game/Screens/Edit/Timing/SliderWithTextBoxInput.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.
 
+#nullable disable
+
 using System;
 using System.Globalization;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Screens/Edit/Timing/TapButton.cs b/osu.Game/Screens/Edit/Timing/TapButton.cs
index a6227cbe27..151c3cea2e 100644
--- a/osu.Game/Screens/Edit/Timing/TapButton.cs
+++ b/osu.Game/Screens/Edit/Timing/TapButton.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 enable
-
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Screens/Edit/Timing/TapTimingControl.cs b/osu.Game/Screens/Edit/Timing/TapTimingControl.cs
index 9b5574d3cb..53c92bac20 100644
--- a/osu.Game/Screens/Edit/Timing/TapTimingControl.cs
+++ b/osu.Game/Screens/Edit/Timing/TapTimingControl.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 enable
-
 using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Screens/Edit/Timing/TimingAdjustButton.cs b/osu.Game/Screens/Edit/Timing/TimingAdjustButton.cs
index 8aa0a88c3b..16dea328da 100644
--- a/osu.Game/Screens/Edit/Timing/TimingAdjustButton.cs
+++ b/osu.Game/Screens/Edit/Timing/TimingAdjustButton.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Screens/Edit/Timing/TimingScreen.cs b/osu.Game/Screens/Edit/Timing/TimingScreen.cs
index f498aa917e..60cb263a79 100644
--- a/osu.Game/Screens/Edit/Timing/TimingScreen.cs
+++ b/osu.Game/Screens/Edit/Timing/TimingScreen.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Screens/Edit/Timing/TimingSection.cs b/osu.Game/Screens/Edit/Timing/TimingSection.cs
index 1a97058d73..8413409d84 100644
--- a/osu.Game/Screens/Edit/Timing/TimingSection.cs
+++ b/osu.Game/Screens/Edit/Timing/TimingSection.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Screens/Edit/Timing/WaveformComparisonDisplay.cs b/osu.Game/Screens/Edit/Timing/WaveformComparisonDisplay.cs
index 0745187e43..67b7abb25b 100644
--- a/osu.Game/Screens/Edit/Timing/WaveformComparisonDisplay.cs
+++ b/osu.Game/Screens/Edit/Timing/WaveformComparisonDisplay.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 enable
-
 using System;
 using System.Linq;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Screens/Edit/TransactionalCommitComponent.cs b/osu.Game/Screens/Edit/TransactionalCommitComponent.cs
index 3d3539ee2f..78d052702a 100644
--- a/osu.Game/Screens/Edit/TransactionalCommitComponent.cs
+++ b/osu.Game/Screens/Edit/TransactionalCommitComponent.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Graphics;
 
diff --git a/osu.Game/Screens/Edit/Verify/InterpretationSection.cs b/osu.Game/Screens/Edit/Verify/InterpretationSection.cs
index 9548f8aaa9..276c2a3ea9 100644
--- a/osu.Game/Screens/Edit/Verify/InterpretationSection.cs
+++ b/osu.Game/Screens/Edit/Verify/InterpretationSection.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Game.Beatmaps;
diff --git a/osu.Game/Screens/Edit/Verify/IssueList.cs b/osu.Game/Screens/Edit/Verify/IssueList.cs
index 84b2609a61..7ce70b4b5f 100644
--- a/osu.Game/Screens/Edit/Verify/IssueList.cs
+++ b/osu.Game/Screens/Edit/Verify/IssueList.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Screens/Edit/Verify/IssueSettings.cs b/osu.Game/Screens/Edit/Verify/IssueSettings.cs
index ae3ef7e0b0..70065f6f0d 100644
--- a/osu.Game/Screens/Edit/Verify/IssueSettings.cs
+++ b/osu.Game/Screens/Edit/Verify/IssueSettings.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Framework.Graphics;
 
diff --git a/osu.Game/Screens/Edit/Verify/IssueTable.cs b/osu.Game/Screens/Edit/Verify/IssueTable.cs
index b38a62d838..f1a76dcbf5 100644
--- a/osu.Game/Screens/Edit/Verify/IssueTable.cs
+++ b/osu.Game/Screens/Edit/Verify/IssueTable.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Screens/Edit/Verify/VerifyScreen.cs b/osu.Game/Screens/Edit/Verify/VerifyScreen.cs
index 56e16bb746..d5b32760c9 100644
--- a/osu.Game/Screens/Edit/Verify/VerifyScreen.cs
+++ b/osu.Game/Screens/Edit/Verify/VerifyScreen.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Screens/Edit/Verify/VisibilitySection.cs b/osu.Game/Screens/Edit/Verify/VisibilitySection.cs
index 0bdc8c0efd..fbf6982984 100644
--- a/osu.Game/Screens/Edit/Verify/VisibilitySection.cs
+++ b/osu.Game/Screens/Edit/Verify/VisibilitySection.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Screens/Edit/WaveformOpacityMenuItem.cs b/osu.Game/Screens/Edit/WaveformOpacityMenuItem.cs
index 7e095f526e..3d3f67e70e 100644
--- a/osu.Game/Screens/Edit/WaveformOpacityMenuItem.cs
+++ b/osu.Game/Screens/Edit/WaveformOpacityMenuItem.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics.UserInterface;
diff --git a/osu.Game/Screens/IHandlePresentBeatmap.cs b/osu.Game/Screens/IHandlePresentBeatmap.cs
index 60801fb3eb..62cd2c3d3e 100644
--- a/osu.Game/Screens/IHandlePresentBeatmap.cs
+++ b/osu.Game/Screens/IHandlePresentBeatmap.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.
 
+#nullable disable
+
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets;
 
diff --git a/osu.Game/Screens/IHasSubScreenStack.cs b/osu.Game/Screens/IHasSubScreenStack.cs
index c5e2015109..325702313b 100644
--- a/osu.Game/Screens/IHasSubScreenStack.cs
+++ b/osu.Game/Screens/IHasSubScreenStack.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.
 
+#nullable disable
+
 using osu.Framework.Screens;
 
 namespace osu.Game.Screens
diff --git a/osu.Game/Screens/IOsuScreen.cs b/osu.Game/Screens/IOsuScreen.cs
index 910a0c7d61..7d8657a3df 100644
--- a/osu.Game/Screens/IOsuScreen.cs
+++ b/osu.Game/Screens/IOsuScreen.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.
 
+#nullable disable
+
 using osu.Framework.Bindables;
 using osu.Framework.Screens;
 using osu.Game.Beatmaps;
diff --git a/osu.Game/Screens/IPerformFromScreenRunner.cs b/osu.Game/Screens/IPerformFromScreenRunner.cs
index 655bebdeb0..c12a52a784 100644
--- a/osu.Game/Screens/IPerformFromScreenRunner.cs
+++ b/osu.Game/Screens/IPerformFromScreenRunner.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Screens/Import/FileImportScreen.cs b/osu.Game/Screens/Import/FileImportScreen.cs
index 32ce54aa29..e3d8de2dfd 100644
--- a/osu.Game/Screens/Import/FileImportScreen.cs
+++ b/osu.Game/Screens/Import/FileImportScreen.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.
 
+#nullable disable
+
 using System.IO;
 using System.Linq;
 using System.Threading.Tasks;
diff --git a/osu.Game/Screens/Loader.cs b/osu.Game/Screens/Loader.cs
index 52e83c9e98..dbb1278d76 100644
--- a/osu.Game/Screens/Loader.cs
+++ b/osu.Game/Screens/Loader.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Screens/Menu/ButtonArea.cs b/osu.Game/Screens/Menu/ButtonArea.cs
index d59996a4eb..bf6e0cee83 100644
--- a/osu.Game/Screens/Menu/ButtonArea.cs
+++ b/osu.Game/Screens/Menu/ButtonArea.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.
 
+#nullable disable
+
 using System;
 using osu.Framework;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Screens/Menu/ButtonSystem.cs b/osu.Game/Screens/Menu/ButtonSystem.cs
index b48aef330a..74be02728f 100644
--- a/osu.Game/Screens/Menu/ButtonSystem.cs
+++ b/osu.Game/Screens/Menu/ButtonSystem.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Screens/Menu/ConfirmExitDialog.cs b/osu.Game/Screens/Menu/ConfirmExitDialog.cs
index 6488a2fd63..734ff6b23f 100644
--- a/osu.Game/Screens/Menu/ConfirmExitDialog.cs
+++ b/osu.Game/Screens/Menu/ConfirmExitDialog.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Graphics.Sprites;
 using osu.Game.Overlays.Dialog;
diff --git a/osu.Game/Screens/Menu/Disclaimer.cs b/osu.Game/Screens/Menu/Disclaimer.cs
index 24412cd85e..b004b025d6 100644
--- a/osu.Game/Screens/Menu/Disclaimer.cs
+++ b/osu.Game/Screens/Menu/Disclaimer.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Screens/Menu/ExitConfirmOverlay.cs b/osu.Game/Screens/Menu/ExitConfirmOverlay.cs
index a90b83c5fe..f82a6c9736 100644
--- a/osu.Game/Screens/Menu/ExitConfirmOverlay.cs
+++ b/osu.Game/Screens/Menu/ExitConfirmOverlay.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.
 
+#nullable disable
+
 using osu.Framework.Input.Bindings;
 using osu.Framework.Input.Events;
 using osu.Game.Input.Bindings;
diff --git a/osu.Game/Screens/Menu/FlowContainerWithOrigin.cs b/osu.Game/Screens/Menu/FlowContainerWithOrigin.cs
index 8310ab06eb..24a365ffd1 100644
--- a/osu.Game/Screens/Menu/FlowContainerWithOrigin.cs
+++ b/osu.Game/Screens/Menu/FlowContainerWithOrigin.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osuTK;
diff --git a/osu.Game/Screens/Menu/IntroCircles.cs b/osu.Game/Screens/Menu/IntroCircles.cs
index 00e2de62f0..faa9a267ce 100644
--- a/osu.Game/Screens/Menu/IntroCircles.cs
+++ b/osu.Game/Screens/Menu/IntroCircles.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.
 
+#nullable disable
+
 using System;
 using JetBrains.Annotations;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Screens/Menu/IntroScreen.cs b/osu.Game/Screens/Menu/IntroScreen.cs
index c9b9bb344d..766b5bf2a4 100644
--- a/osu.Game/Screens/Menu/IntroScreen.cs
+++ b/osu.Game/Screens/Menu/IntroScreen.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using JetBrains.Annotations;
diff --git a/osu.Game/Screens/Menu/IntroSequence.cs b/osu.Game/Screens/Menu/IntroSequence.cs
index 3a5cd6857a..bc5aa83503 100644
--- a/osu.Game/Screens/Menu/IntroSequence.cs
+++ b/osu.Game/Screens/Menu/IntroSequence.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.
 
+#nullable disable
+
 using System.Linq;
 using osuTK;
 using osuTK.Graphics;
diff --git a/osu.Game/Screens/Menu/IntroTriangles.cs b/osu.Game/Screens/Menu/IntroTriangles.cs
index ba8314f103..d59a07a350 100644
--- a/osu.Game/Screens/Menu/IntroTriangles.cs
+++ b/osu.Game/Screens/Menu/IntroTriangles.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using JetBrains.Annotations;
diff --git a/osu.Game/Screens/Menu/IntroWelcome.cs b/osu.Game/Screens/Menu/IntroWelcome.cs
index 9a6c949cad..031c8d7902 100644
--- a/osu.Game/Screens/Menu/IntroWelcome.cs
+++ b/osu.Game/Screens/Menu/IntroWelcome.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.
 
+#nullable disable
+
 using System;
 using JetBrains.Annotations;
 using osuTK;
diff --git a/osu.Game/Screens/Menu/LogoVisualisation.cs b/osu.Game/Screens/Menu/LogoVisualisation.cs
index 34f1d46067..c66bd3639a 100644
--- a/osu.Game/Screens/Menu/LogoVisualisation.cs
+++ b/osu.Game/Screens/Menu/LogoVisualisation.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.
 
+#nullable disable
+
 using osuTK;
 using osuTK.Graphics;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Screens/Menu/MainMenu.cs b/osu.Game/Screens/Menu/MainMenu.cs
index bcd4baa818..6a74a6bd6e 100644
--- a/osu.Game/Screens/Menu/MainMenu.cs
+++ b/osu.Game/Screens/Menu/MainMenu.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.
 
+#nullable disable
+
 using System;
 using System.Diagnostics;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Screens/Menu/MainMenuButton.cs b/osu.Game/Screens/Menu/MainMenuButton.cs
index c07ada9419..f2b57b185e 100644
--- a/osu.Game/Screens/Menu/MainMenuButton.cs
+++ b/osu.Game/Screens/Menu/MainMenuButton.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.
 
+#nullable disable
+
 using System;
 using osu.Framework;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Screens/Menu/MenuLogoVisualisation.cs b/osu.Game/Screens/Menu/MenuLogoVisualisation.cs
index f461136022..4324f02c84 100644
--- a/osu.Game/Screens/Menu/MenuLogoVisualisation.cs
+++ b/osu.Game/Screens/Menu/MenuLogoVisualisation.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.
 
+#nullable disable
+
 using osuTK.Graphics;
 using osu.Game.Skinning;
 using osu.Game.Online.API;
diff --git a/osu.Game/Screens/Menu/MenuSideFlashes.cs b/osu.Game/Screens/Menu/MenuSideFlashes.cs
index cd0c75c1a1..5214d87ee9 100644
--- a/osu.Game/Screens/Menu/MenuSideFlashes.cs
+++ b/osu.Game/Screens/Menu/MenuSideFlashes.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.
 
+#nullable disable
+
 using osuTK.Graphics;
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.Color4Extensions;
diff --git a/osu.Game/Screens/Menu/OsuLogo.cs b/osu.Game/Screens/Menu/OsuLogo.cs
index f5743c7d5a..ddeb544bc5 100644
--- a/osu.Game/Screens/Menu/OsuLogo.cs
+++ b/osu.Game/Screens/Menu/OsuLogo.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
diff --git a/osu.Game/Screens/Menu/SongTicker.cs b/osu.Game/Screens/Menu/SongTicker.cs
index 237fe43168..6574c9a696 100644
--- a/osu.Game/Screens/Menu/SongTicker.cs
+++ b/osu.Game/Screens/Menu/SongTicker.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Screens/Menu/StorageErrorDialog.cs b/osu.Game/Screens/Menu/StorageErrorDialog.cs
index f4c77d5d8f..28ef413179 100644
--- a/osu.Game/Screens/Menu/StorageErrorDialog.cs
+++ b/osu.Game/Screens/Menu/StorageErrorDialog.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics.Sprites;
diff --git a/osu.Game/Screens/OnlinePlay/Components/BeatmapDetailAreaPlaylistTabItem.cs b/osu.Game/Screens/OnlinePlay/Components/BeatmapDetailAreaPlaylistTabItem.cs
index fb927411e6..7c48fc0871 100644
--- a/osu.Game/Screens/OnlinePlay/Components/BeatmapDetailAreaPlaylistTabItem.cs
+++ b/osu.Game/Screens/OnlinePlay/Components/BeatmapDetailAreaPlaylistTabItem.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.
 
+#nullable disable
+
 using osu.Game.Screens.Select;
 
 namespace osu.Game.Screens.OnlinePlay.Components
diff --git a/osu.Game/Screens/OnlinePlay/Components/BeatmapTitle.cs b/osu.Game/Screens/OnlinePlay/Components/BeatmapTitle.cs
index 7cbe1a9017..1dc05def0f 100644
--- a/osu.Game/Screens/OnlinePlay/Components/BeatmapTitle.cs
+++ b/osu.Game/Screens/OnlinePlay/Components/BeatmapTitle.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.
 
+#nullable disable
+
 using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Screens/OnlinePlay/Components/DisableableTabControl.cs b/osu.Game/Screens/OnlinePlay/Components/DisableableTabControl.cs
index 2b596da361..22839ab4d4 100644
--- a/osu.Game/Screens/OnlinePlay/Components/DisableableTabControl.cs
+++ b/osu.Game/Screens/OnlinePlay/Components/DisableableTabControl.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.
 
+#nullable disable
+
 using osu.Framework.Bindables;
 using osu.Framework.Graphics.UserInterface;
 using osu.Framework.Input.Events;
diff --git a/osu.Game/Screens/OnlinePlay/Components/DrawableGameType.cs b/osu.Game/Screens/OnlinePlay/Components/DrawableGameType.cs
index f360a80599..c97e52c247 100644
--- a/osu.Game/Screens/OnlinePlay/Components/DrawableGameType.cs
+++ b/osu.Game/Screens/OnlinePlay/Components/DrawableGameType.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Extensions;
 using osu.Framework.Extensions.Color4Extensions;
diff --git a/osu.Game/Screens/OnlinePlay/Components/ListingPollingComponent.cs b/osu.Game/Screens/OnlinePlay/Components/ListingPollingComponent.cs
index 666d425f62..1ea84b60b9 100644
--- a/osu.Game/Screens/OnlinePlay/Components/ListingPollingComponent.cs
+++ b/osu.Game/Screens/OnlinePlay/Components/ListingPollingComponent.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.
 
+#nullable disable
+
 using System.Linq;
 using System.Threading.Tasks;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Screens/OnlinePlay/Components/MatchBeatmapDetailArea.cs b/osu.Game/Screens/OnlinePlay/Components/MatchBeatmapDetailArea.cs
index 89842e933b..bed55e8a79 100644
--- a/osu.Game/Screens/OnlinePlay/Components/MatchBeatmapDetailArea.cs
+++ b/osu.Game/Screens/OnlinePlay/Components/MatchBeatmapDetailArea.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Screens/OnlinePlay/Components/ModeTypeInfo.cs b/osu.Game/Screens/OnlinePlay/Components/ModeTypeInfo.cs
index 8402619ebc..641776a9e8 100644
--- a/osu.Game/Screens/OnlinePlay/Components/ModeTypeInfo.cs
+++ b/osu.Game/Screens/OnlinePlay/Components/ModeTypeInfo.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.
 
+#nullable disable
+
 using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Screens/OnlinePlay/Components/OnlinePlayBackgroundScreen.cs b/osu.Game/Screens/OnlinePlay/Components/OnlinePlayBackgroundScreen.cs
index 9e964de31e..8c65649cc6 100644
--- a/osu.Game/Screens/OnlinePlay/Components/OnlinePlayBackgroundScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Components/OnlinePlayBackgroundScreen.cs
@@ -13,8 +13,6 @@ using osu.Game.Online.Rooms;
 using osuTK;
 using osuTK.Graphics;
 
-#nullable enable
-
 namespace osu.Game.Screens.OnlinePlay.Components
 {
     public abstract class OnlinePlayBackgroundScreen : BackgroundScreen
diff --git a/osu.Game/Screens/OnlinePlay/Components/OnlinePlayBackgroundSprite.cs b/osu.Game/Screens/OnlinePlay/Components/OnlinePlayBackgroundSprite.cs
index 2faa46e622..795f776496 100644
--- a/osu.Game/Screens/OnlinePlay/Components/OnlinePlayBackgroundSprite.cs
+++ b/osu.Game/Screens/OnlinePlay/Components/OnlinePlayBackgroundSprite.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Game.Beatmaps.Drawables;
diff --git a/osu.Game/Screens/OnlinePlay/Components/OverlinedHeader.cs b/osu.Game/Screens/OnlinePlay/Components/OverlinedHeader.cs
index f667a3c1d2..b953136fdd 100644
--- a/osu.Game/Screens/OnlinePlay/Components/OverlinedHeader.cs
+++ b/osu.Game/Screens/OnlinePlay/Components/OverlinedHeader.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Screens/OnlinePlay/Components/OverlinedPlaylistHeader.cs b/osu.Game/Screens/OnlinePlay/Components/OverlinedPlaylistHeader.cs
index 45b822d20a..43ad5e97ec 100644
--- a/osu.Game/Screens/OnlinePlay/Components/OverlinedPlaylistHeader.cs
+++ b/osu.Game/Screens/OnlinePlay/Components/OverlinedPlaylistHeader.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.
 
+#nullable disable
+
 using osu.Game.Online.Rooms;
 
 namespace osu.Game.Screens.OnlinePlay.Components
diff --git a/osu.Game/Screens/OnlinePlay/Components/ParticipantCountDisplay.cs b/osu.Game/Screens/OnlinePlay/Components/ParticipantCountDisplay.cs
index 53821da8fd..71b33bf247 100644
--- a/osu.Game/Screens/OnlinePlay/Components/ParticipantCountDisplay.cs
+++ b/osu.Game/Screens/OnlinePlay/Components/ParticipantCountDisplay.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Screens/OnlinePlay/Components/ParticipantsDisplay.cs b/osu.Game/Screens/OnlinePlay/Components/ParticipantsDisplay.cs
index c36d1a2e76..c66ae8b6d5 100644
--- a/osu.Game/Screens/OnlinePlay/Components/ParticipantsDisplay.cs
+++ b/osu.Game/Screens/OnlinePlay/Components/ParticipantsDisplay.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Screens/OnlinePlay/Components/ParticipantsList.cs b/osu.Game/Screens/OnlinePlay/Components/ParticipantsList.cs
index 1d5552fa7d..d8515d2bd2 100644
--- a/osu.Game/Screens/OnlinePlay/Components/ParticipantsList.cs
+++ b/osu.Game/Screens/OnlinePlay/Components/ParticipantsList.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Screens/OnlinePlay/Components/PlaylistItemBackground.cs b/osu.Game/Screens/OnlinePlay/Components/PlaylistItemBackground.cs
index 7e31591389..d882b3d97f 100644
--- a/osu.Game/Screens/OnlinePlay/Components/PlaylistItemBackground.cs
+++ b/osu.Game/Screens/OnlinePlay/Components/PlaylistItemBackground.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 enable
-
 using osu.Framework.Allocation;
 using osu.Framework.Graphics.Textures;
 using osu.Game.Beatmaps;
diff --git a/osu.Game/Screens/OnlinePlay/Components/ReadyButton.cs b/osu.Game/Screens/OnlinePlay/Components/ReadyButton.cs
index cdaa39d2be..0871fc9a72 100644
--- a/osu.Game/Screens/OnlinePlay/Components/ReadyButton.cs
+++ b/osu.Game/Screens/OnlinePlay/Components/ReadyButton.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics.Cursor;
diff --git a/osu.Game/Screens/OnlinePlay/Components/RoomLocalUserInfo.cs b/osu.Game/Screens/OnlinePlay/Components/RoomLocalUserInfo.cs
index 3bad6cb183..cc517ca080 100644
--- a/osu.Game/Screens/OnlinePlay/Components/RoomLocalUserInfo.cs
+++ b/osu.Game/Screens/OnlinePlay/Components/RoomLocalUserInfo.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.
 
+#nullable disable
+
 using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Screens/OnlinePlay/Components/RoomManager.cs b/osu.Game/Screens/OnlinePlay/Components/RoomManager.cs
index 4242886e66..35dc251e4d 100644
--- a/osu.Game/Screens/OnlinePlay/Components/RoomManager.cs
+++ b/osu.Game/Screens/OnlinePlay/Components/RoomManager.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Diagnostics;
diff --git a/osu.Game/Screens/OnlinePlay/Components/RoomPollingComponent.cs b/osu.Game/Screens/OnlinePlay/Components/RoomPollingComponent.cs
index cd224a7347..039e1d92b7 100644
--- a/osu.Game/Screens/OnlinePlay/Components/RoomPollingComponent.cs
+++ b/osu.Game/Screens/OnlinePlay/Components/RoomPollingComponent.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Game.Online;
 using osu.Game.Online.API;
diff --git a/osu.Game/Screens/OnlinePlay/Components/SelectionPollingComponent.cs b/osu.Game/Screens/OnlinePlay/Components/SelectionPollingComponent.cs
index e05bdf8c8e..3b8ba739d9 100644
--- a/osu.Game/Screens/OnlinePlay/Components/SelectionPollingComponent.cs
+++ b/osu.Game/Screens/OnlinePlay/Components/SelectionPollingComponent.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.
 
+#nullable disable
+
 using System.Threading.Tasks;
 using osu.Game.Online.Rooms;
 
diff --git a/osu.Game/Screens/OnlinePlay/Components/StarRatingRangeDisplay.cs b/osu.Game/Screens/OnlinePlay/Components/StarRatingRangeDisplay.cs
index 7425e46bd3..4cf785ce60 100644
--- a/osu.Game/Screens/OnlinePlay/Components/StarRatingRangeDisplay.cs
+++ b/osu.Game/Screens/OnlinePlay/Components/StarRatingRangeDisplay.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Screens/OnlinePlay/Components/StatusColouredContainer.cs b/osu.Game/Screens/OnlinePlay/Components/StatusColouredContainer.cs
index a7ea32ee7c..6122e7ec5e 100644
--- a/osu.Game/Screens/OnlinePlay/Components/StatusColouredContainer.cs
+++ b/osu.Game/Screens/OnlinePlay/Components/StatusColouredContainer.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs
index 2a72fc6eb1..489bf128e8 100644
--- a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.cs
+++ b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylist.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
index 39853a5c45..53519b8b00 100644
--- a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
+++ b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Screens/OnlinePlay/FooterButtonFreeMods.cs b/osu.Game/Screens/OnlinePlay/FooterButtonFreeMods.cs
index 834e82fcfd..9e589b362b 100644
--- a/osu.Game/Screens/OnlinePlay/FooterButtonFreeMods.cs
+++ b/osu.Game/Screens/OnlinePlay/FooterButtonFreeMods.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Screens/OnlinePlay/FreeModSelectOverlay.cs b/osu.Game/Screens/OnlinePlay/FreeModSelectOverlay.cs
index 7c9184cc0f..c27b78642a 100644
--- a/osu.Game/Screens/OnlinePlay/FreeModSelectOverlay.cs
+++ b/osu.Game/Screens/OnlinePlay/FreeModSelectOverlay.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.
 
+#nullable disable
+
 using System;
 using osu.Game.Overlays;
 using System.Collections.Generic;
diff --git a/osu.Game/Screens/OnlinePlay/Header.cs b/osu.Game/Screens/OnlinePlay/Header.cs
index 2d4b5cc527..06befe0971 100644
--- a/osu.Game/Screens/OnlinePlay/Header.cs
+++ b/osu.Game/Screens/OnlinePlay/Header.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.
 
+#nullable disable
+
 using Humanizer;
 using JetBrains.Annotations;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Screens/OnlinePlay/IOnlinePlaySubScreen.cs b/osu.Game/Screens/OnlinePlay/IOnlinePlaySubScreen.cs
index a4762292a9..f32ead5a11 100644
--- a/osu.Game/Screens/OnlinePlay/IOnlinePlaySubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/IOnlinePlaySubScreen.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.
 
+#nullable disable
+
 namespace osu.Game.Screens.OnlinePlay
 {
     public interface IOnlinePlaySubScreen : IOsuScreen
diff --git a/osu.Game/Screens/OnlinePlay/IRoomManager.cs b/osu.Game/Screens/OnlinePlay/IRoomManager.cs
index 6e1ffbda74..ed4fb7b15e 100644
--- a/osu.Game/Screens/OnlinePlay/IRoomManager.cs
+++ b/osu.Game/Screens/OnlinePlay/IRoomManager.cs
@@ -6,8 +6,6 @@ using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Game.Online.Rooms;
 
-#nullable enable
-
 namespace osu.Game.Screens.OnlinePlay
 {
     [Cached(typeof(IRoomManager))]
diff --git a/osu.Game/Screens/OnlinePlay/Lounge/Components/DrawableRoom.cs b/osu.Game/Screens/OnlinePlay/Lounge/Components/DrawableRoom.cs
index 772232f6b4..7e39a52c0a 100644
--- a/osu.Game/Screens/OnlinePlay/Lounge/Components/DrawableRoom.cs
+++ b/osu.Game/Screens/OnlinePlay/Lounge/Components/DrawableRoom.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Threading;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Screens/OnlinePlay/Lounge/Components/DrawableRoomParticipantsList.cs b/osu.Game/Screens/OnlinePlay/Lounge/Components/DrawableRoomParticipantsList.cs
index 10bd534b89..995a0d3397 100644
--- a/osu.Game/Screens/OnlinePlay/Lounge/Components/DrawableRoomParticipantsList.cs
+++ b/osu.Game/Screens/OnlinePlay/Lounge/Components/DrawableRoomParticipantsList.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.
 
+#nullable disable
+
 using System.Collections.Specialized;
 using System.Linq;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Screens/OnlinePlay/Lounge/Components/EndDateInfo.cs b/osu.Game/Screens/OnlinePlay/Lounge/Components/EndDateInfo.cs
index 3207d373db..d951b42854 100644
--- a/osu.Game/Screens/OnlinePlay/Lounge/Components/EndDateInfo.cs
+++ b/osu.Game/Screens/OnlinePlay/Lounge/Components/EndDateInfo.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Screens/OnlinePlay/Lounge/Components/FilterCriteria.cs b/osu.Game/Screens/OnlinePlay/Lounge/Components/FilterCriteria.cs
index 488af5d4de..67e805986a 100644
--- a/osu.Game/Screens/OnlinePlay/Lounge/Components/FilterCriteria.cs
+++ b/osu.Game/Screens/OnlinePlay/Lounge/Components/FilterCriteria.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.
 
+#nullable disable
+
 using osu.Game.Rulesets;
 
 namespace osu.Game.Screens.OnlinePlay.Lounge.Components
diff --git a/osu.Game/Screens/OnlinePlay/Lounge/Components/MatchTypePill.cs b/osu.Game/Screens/OnlinePlay/Lounge/Components/MatchTypePill.cs
index d104ede8f7..b2e527766a 100644
--- a/osu.Game/Screens/OnlinePlay/Lounge/Components/MatchTypePill.cs
+++ b/osu.Game/Screens/OnlinePlay/Lounge/Components/MatchTypePill.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Extensions;
diff --git a/osu.Game/Screens/OnlinePlay/Lounge/Components/PillContainer.cs b/osu.Game/Screens/OnlinePlay/Lounge/Components/PillContainer.cs
index 109851a16b..b17873b1c8 100644
--- a/osu.Game/Screens/OnlinePlay/Lounge/Components/PillContainer.cs
+++ b/osu.Game/Screens/OnlinePlay/Lounge/Components/PillContainer.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
diff --git a/osu.Game/Screens/OnlinePlay/Lounge/Components/PlaylistCountPill.cs b/osu.Game/Screens/OnlinePlay/Lounge/Components/PlaylistCountPill.cs
index a6bbcd548d..5bdd24221c 100644
--- a/osu.Game/Screens/OnlinePlay/Lounge/Components/PlaylistCountPill.cs
+++ b/osu.Game/Screens/OnlinePlay/Lounge/Components/PlaylistCountPill.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.
 
+#nullable disable
+
 using System.Linq;
 using Humanizer;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Screens/OnlinePlay/Lounge/Components/QueueModePill.cs b/osu.Game/Screens/OnlinePlay/Lounge/Components/QueueModePill.cs
index 7501f0237b..85177ee32c 100644
--- a/osu.Game/Screens/OnlinePlay/Lounge/Components/QueueModePill.cs
+++ b/osu.Game/Screens/OnlinePlay/Lounge/Components/QueueModePill.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Extensions;
diff --git a/osu.Game/Screens/OnlinePlay/Lounge/Components/RankRangePill.cs b/osu.Game/Screens/OnlinePlay/Lounge/Components/RankRangePill.cs
index 42fe0bfecd..fa531a0d14 100644
--- a/osu.Game/Screens/OnlinePlay/Lounge/Components/RankRangePill.cs
+++ b/osu.Game/Screens/OnlinePlay/Lounge/Components/RankRangePill.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.
 
+#nullable disable
+
 using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Screens/OnlinePlay/Lounge/Components/RoomSpecialCategoryPill.cs b/osu.Game/Screens/OnlinePlay/Lounge/Components/RoomSpecialCategoryPill.cs
index 539af2ebaf..0f9bfb22e8 100644
--- a/osu.Game/Screens/OnlinePlay/Lounge/Components/RoomSpecialCategoryPill.cs
+++ b/osu.Game/Screens/OnlinePlay/Lounge/Components/RoomSpecialCategoryPill.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Extensions;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Screens/OnlinePlay/Lounge/Components/RoomStatusFilter.cs b/osu.Game/Screens/OnlinePlay/Lounge/Components/RoomStatusFilter.cs
index 0c8dc8832b..463b883f11 100644
--- a/osu.Game/Screens/OnlinePlay/Lounge/Components/RoomStatusFilter.cs
+++ b/osu.Game/Screens/OnlinePlay/Lounge/Components/RoomStatusFilter.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.
 
+#nullable disable
+
 using System.ComponentModel;
 
 namespace osu.Game.Screens.OnlinePlay.Lounge.Components
diff --git a/osu.Game/Screens/OnlinePlay/Lounge/Components/RoomStatusPill.cs b/osu.Game/Screens/OnlinePlay/Lounge/Components/RoomStatusPill.cs
index 1d43f2dc65..f37ec9d9d4 100644
--- a/osu.Game/Screens/OnlinePlay/Lounge/Components/RoomStatusPill.cs
+++ b/osu.Game/Screens/OnlinePlay/Lounge/Components/RoomStatusPill.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Screens/OnlinePlay/Lounge/Components/RoomsContainer.cs b/osu.Game/Screens/OnlinePlay/Lounge/Components/RoomsContainer.cs
index 0fd9290880..2c3a2997cc 100644
--- a/osu.Game/Screens/OnlinePlay/Lounge/Components/RoomsContainer.cs
+++ b/osu.Game/Screens/OnlinePlay/Lounge/Components/RoomsContainer.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Collections.Specialized;
diff --git a/osu.Game/Screens/OnlinePlay/Lounge/DrawableLoungeRoom.cs b/osu.Game/Screens/OnlinePlay/Lounge/DrawableLoungeRoom.cs
index 0015cf8bf9..9784e5aace 100644
--- a/osu.Game/Screens/OnlinePlay/Lounge/DrawableLoungeRoom.cs
+++ b/osu.Game/Screens/OnlinePlay/Lounge/DrawableLoungeRoom.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
diff --git a/osu.Game/Screens/OnlinePlay/Lounge/LoungeBackgroundScreen.cs b/osu.Game/Screens/OnlinePlay/Lounge/LoungeBackgroundScreen.cs
index 52a902f5da..d81fee24e0 100644
--- a/osu.Game/Screens/OnlinePlay/Lounge/LoungeBackgroundScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Lounge/LoungeBackgroundScreen.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 enable
-
 using osu.Framework.Bindables;
 using osu.Framework.Screens;
 using osu.Game.Online.Rooms;
diff --git a/osu.Game/Screens/OnlinePlay/Lounge/LoungeSubScreen.cs b/osu.Game/Screens/OnlinePlay/Lounge/LoungeSubScreen.cs
index b1c10f4a4a..f7f3c27ede 100644
--- a/osu.Game/Screens/OnlinePlay/Lounge/LoungeSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Lounge/LoungeSubScreen.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.
 
+#nullable disable
+
 using System;
 using System.Diagnostics;
 using System.Collections.Generic;
diff --git a/osu.Game/Screens/OnlinePlay/Match/Components/CreateRoomButton.cs b/osu.Game/Screens/OnlinePlay/Match/Components/CreateRoomButton.cs
index 81e1cb2406..3d0c181d9d 100644
--- a/osu.Game/Screens/OnlinePlay/Match/Components/CreateRoomButton.cs
+++ b/osu.Game/Screens/OnlinePlay/Match/Components/CreateRoomButton.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Input;
 using osu.Framework.Input.Bindings;
diff --git a/osu.Game/Screens/OnlinePlay/Match/Components/MatchChatDisplay.cs b/osu.Game/Screens/OnlinePlay/Match/Components/MatchChatDisplay.cs
index 0396562959..880bba895a 100644
--- a/osu.Game/Screens/OnlinePlay/Match/Components/MatchChatDisplay.cs
+++ b/osu.Game/Screens/OnlinePlay/Match/Components/MatchChatDisplay.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Game.Online.Chat;
diff --git a/osu.Game/Screens/OnlinePlay/Match/Components/MatchLeaderboard.cs b/osu.Game/Screens/OnlinePlay/Match/Components/MatchLeaderboard.cs
index b92c197f5a..64644be965 100644
--- a/osu.Game/Screens/OnlinePlay/Match/Components/MatchLeaderboard.cs
+++ b/osu.Game/Screens/OnlinePlay/Match/Components/MatchLeaderboard.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.
 
+#nullable disable
+
 using System.Threading;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Screens/OnlinePlay/Match/Components/MatchLeaderboardScore.cs b/osu.Game/Screens/OnlinePlay/Match/Components/MatchLeaderboardScore.cs
index 799983342b..5bd8f9e066 100644
--- a/osu.Game/Screens/OnlinePlay/Match/Components/MatchLeaderboardScore.cs
+++ b/osu.Game/Screens/OnlinePlay/Match/Components/MatchLeaderboardScore.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics.Sprites;
diff --git a/osu.Game/Screens/OnlinePlay/Match/Components/MatchTypePicker.cs b/osu.Game/Screens/OnlinePlay/Match/Components/MatchTypePicker.cs
index 216734e55e..91477879c6 100644
--- a/osu.Game/Screens/OnlinePlay/Match/Components/MatchTypePicker.cs
+++ b/osu.Game/Screens/OnlinePlay/Match/Components/MatchTypePicker.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Screens/OnlinePlay/Match/Components/PurpleTriangleButton.cs b/osu.Game/Screens/OnlinePlay/Match/Components/PurpleTriangleButton.cs
index 28e8961a9a..5c751f238f 100644
--- a/osu.Game/Screens/OnlinePlay/Match/Components/PurpleTriangleButton.cs
+++ b/osu.Game/Screens/OnlinePlay/Match/Components/PurpleTriangleButton.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Game.Graphics.UserInterface;
diff --git a/osu.Game/Screens/OnlinePlay/Match/Components/RoomAvailabilityPicker.cs b/osu.Game/Screens/OnlinePlay/Match/Components/RoomAvailabilityPicker.cs
index 677a5be0d9..408742d8e1 100644
--- a/osu.Game/Screens/OnlinePlay/Match/Components/RoomAvailabilityPicker.cs
+++ b/osu.Game/Screens/OnlinePlay/Match/Components/RoomAvailabilityPicker.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Extensions;
 using osu.Framework.Extensions.Color4Extensions;
diff --git a/osu.Game/Screens/OnlinePlay/Match/Components/RoomSettingsOverlay.cs b/osu.Game/Screens/OnlinePlay/Match/Components/RoomSettingsOverlay.cs
index c15b5b443a..c295e9f85e 100644
--- a/osu.Game/Screens/OnlinePlay/Match/Components/RoomSettingsOverlay.cs
+++ b/osu.Game/Screens/OnlinePlay/Match/Components/RoomSettingsOverlay.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Screens/OnlinePlay/Match/DrawableMatchRoom.cs b/osu.Game/Screens/OnlinePlay/Match/DrawableMatchRoom.cs
index 1828a072f8..7c444b9bbd 100644
--- a/osu.Game/Screens/OnlinePlay/Match/DrawableMatchRoom.cs
+++ b/osu.Game/Screens/OnlinePlay/Match/DrawableMatchRoom.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.
 
+#nullable disable
+
 using System;
 using JetBrains.Annotations;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Screens/OnlinePlay/Match/RoomBackgroundScreen.cs b/osu.Game/Screens/OnlinePlay/Match/RoomBackgroundScreen.cs
index 2e5f25370f..74c37b865c 100644
--- a/osu.Game/Screens/OnlinePlay/Match/RoomBackgroundScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Match/RoomBackgroundScreen.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.
 
+#nullable disable
+
 using osu.Framework.Bindables;
 using osu.Game.Online.Rooms;
 using osu.Game.Screens.OnlinePlay.Components;
diff --git a/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs b/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
index a612b6a0e6..e7d31fbdde 100644
--- a/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Diagnostics;
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/CreateMultiplayerMatchButton.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/CreateMultiplayerMatchButton.cs
index e80923ed47..fd535f979d 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/CreateMultiplayerMatchButton.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/CreateMultiplayerMatchButton.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Game.Online.Multiplayer;
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/GameplayChatDisplay.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/GameplayChatDisplay.cs
index d08a63e21f..270f15a98d 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/GameplayChatDisplay.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/GameplayChatDisplay.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.
 
+#nullable disable
+
 using JetBrains.Annotations;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/GameplayMatchScoreDisplay.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/GameplayMatchScoreDisplay.cs
index 20a88545c5..c7fb6a82d5 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/GameplayMatchScoreDisplay.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/GameplayMatchScoreDisplay.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.
 
+#nullable disable
+
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Game.Screens.Play.HUD;
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MatchStartControl.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MatchStartControl.cs
index d048676872..501c76f65b 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MatchStartControl.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MatchStartControl.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.
 
+#nullable disable
+
 using System;
 using System.Diagnostics;
 using System.Linq;
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerCountdownButton.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerCountdownButton.cs
index 1a51aebb76..14bf1a8375 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerCountdownButton.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerCountdownButton.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.
 
+#nullable disable
+
 using System;
 using Humanizer;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchFooter.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchFooter.cs
index a07c95bca8..c28bd4892a 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchFooter.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchFooter.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs
index a103d71120..3aa879dde0 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.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.
 
+#nullable disable
+
 using System;
 using System.ComponentModel;
 using System.Diagnostics;
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
index 62310bcaac..20762b2f22 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerReadyButton.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using JetBrains.Annotations;
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerSpectateButton.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerSpectateButton.cs
index d939fbf400..b5bb4a766f 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerSpectateButton.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerSpectateButton.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerHistoryList.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerHistoryList.cs
index 32d355d149..3def73accb 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerHistoryList.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerHistoryList.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylist.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylist.cs
index 41f548a630..bc96bd61d7 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylist.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylist.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylistDisplayMode.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylistDisplayMode.cs
index cc3dca6a34..1672f98637 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylistDisplayMode.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylistDisplayMode.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.
 
+#nullable disable
+
 namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match.Playlist
 {
     /// <summary>
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylistTabControl.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylistTabControl.cs
index 583a05839f..9877c15f2f 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylistTabControl.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerPlaylistTabControl.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.
 
+#nullable disable
+
 using osu.Framework.Bindables;
 using osu.Framework.Graphics.UserInterface;
 using osu.Game.Graphics.UserInterface;
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerQueueList.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerQueueList.cs
index d72ce5e960..04342788db 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerQueueList.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/Playlist/MultiplayerQueueList.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Multiplayer.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Multiplayer.cs
index 53d081a108..03a2f00c0d 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Multiplayer.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Multiplayer.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.
 
+#nullable disable
+
 using System.Diagnostics;
 using osu.Framework.Allocation;
 using osu.Framework.Logging;
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerLoungeSubScreen.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerLoungeSubScreen.cs
index a05f248d3a..ae65e1d969 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerLoungeSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerLoungeSubScreen.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.
 
+#nullable disable
+
 using System.Threading.Tasks;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs
index 929c3ee321..495d3f94e1 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.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.
 
+#nullable disable
+
 using System.Linq;
 using System.Threading.Tasks;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
index dc78cb10ef..869548c948 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSubScreen.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Diagnostics;
 using System.Linq;
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayer.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayer.cs
index 43b128b971..df0f94688b 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayer.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayer.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.
 
+#nullable disable
+
 using System;
 using System.Diagnostics;
 using System.Linq;
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayerLoader.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayerLoader.cs
index e9bf5339a9..f79af664d8 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayerLoader.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayerLoader.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.
 
+#nullable disable
+
 using System;
 using System.Threading.Tasks;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerResultsScreen.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerResultsScreen.cs
index 140b3c45d8..d98b837883 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerResultsScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerResultsScreen.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.
 
+#nullable disable
+
 using osu.Game.Online.Rooms;
 using osu.Game.Scoring;
 using osu.Game.Screens.OnlinePlay.Playlists;
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerRoomComposite.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerRoomComposite.cs
index f6f815a3cb..1f80c47d13 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerRoomComposite.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerRoomComposite.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.
 
+#nullable disable
+
 using JetBrains.Annotations;
 using osu.Framework.Allocation;
 using osu.Game.Online.Multiplayer;
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerRoomManager.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerRoomManager.cs
index 2d94b2328d..7e83d72c77 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerRoomManager.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerRoomManager.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.
 
+#nullable disable
+
 using System;
 using System.Diagnostics;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerRoomSounds.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerRoomSounds.cs
index 49b5b7fed9..1aafcea20c 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerRoomSounds.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerRoomSounds.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
 using osu.Framework.Audio.Sample;
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerTeamResultsScreen.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerTeamResultsScreen.cs
index 3f0f3e043c..6fbed03e44 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerTeamResultsScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerTeamResultsScreen.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantPanel.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantPanel.cs
index 498a7d9972..f632951f41 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantPanel.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantPanel.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantsList.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantsList.cs
index 14b930f115..cda86c74bf 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantsList.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantsList.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.
 
+#nullable disable
+
 using System.Linq;
 using JetBrains.Annotations;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantsListHeader.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantsListHeader.cs
index ef84c4b4fa..b0acda03df 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantsListHeader.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/ParticipantsListHeader.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Resources.Localisation.Web;
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/StateDisplay.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/StateDisplay.cs
index 658fc43e8d..9c05c19d1b 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/StateDisplay.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/StateDisplay.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.
 
+#nullable disable
+
 using System;
 using System.Diagnostics;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/TeamDisplay.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/TeamDisplay.cs
index aca2c6073a..5500d96eea 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/TeamDisplay.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Participants/TeamDisplay.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.
 
+#nullable disable
+
 using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/CatchUpSpectatorPlayerClock.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/CatchUpSpectatorPlayerClock.cs
index 48d0b063ff..34388bf9b1 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/CatchUpSpectatorPlayerClock.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/CatchUpSpectatorPlayerClock.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 enable
-
 using System;
 using osu.Framework.Bindables;
 using osu.Framework.Timing;
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/CatchUpSyncManager.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/CatchUpSyncManager.cs
index b0fdeddd56..663025923c 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/CatchUpSyncManager.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/CatchUpSyncManager.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Diagnostics;
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/ISpectatorPlayerClock.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/ISpectatorPlayerClock.cs
index b2ecb105c2..194a3bdcc2 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/ISpectatorPlayerClock.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/ISpectatorPlayerClock.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.
 
+#nullable disable
+
 using osu.Framework.Bindables;
 using osu.Framework.Timing;
 
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/ISyncManager.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/ISyncManager.cs
index 3c644ccb78..577100d4ba 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/ISyncManager.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/ISyncManager.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Bindables;
 using osu.Framework.Timing;
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MasterClockState.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MasterClockState.cs
index 8982d1669d..92dbde9f08 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MasterClockState.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MasterClockState.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.
 
+#nullable disable
+
 namespace osu.Game.Screens.OnlinePlay.Multiplayer.Spectate
 {
     public enum MasterClockState
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorLeaderboard.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorLeaderboard.cs
index 4e9ab07e4c..c7af87a91d 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorLeaderboard.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorLeaderboard.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Timing;
 using osu.Game.Online.Multiplayer;
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorPlayer.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorPlayer.cs
index 29afaf00d8..a0558f97a9 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorPlayer.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorPlayer.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.
 
+#nullable disable
+
 using JetBrains.Annotations;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorPlayerLoader.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorPlayerLoader.cs
index 14bd8fa6dc..36a6487289 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorPlayerLoader.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorPlayerLoader.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.
 
+#nullable disable
+
 using System;
 using JetBrains.Annotations;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorScreen.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorScreen.cs
index d9c19cdfdd..e048c12686 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorScreen.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using JetBrains.Annotations;
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/PlayerArea.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/PlayerArea.cs
index 4979bd906b..5bae4f9ea5 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/PlayerArea.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/PlayerArea.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using JetBrains.Annotations;
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/PlayerGrid.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/PlayerGrid.cs
index 6638d47dca..82d4cf5caf 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/PlayerGrid.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/PlayerGrid.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/PlayerGrid_Cell.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/PlayerGrid_Cell.cs
index 2df05cb5ed..ee213f7be1 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/PlayerGrid_Cell.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/PlayerGrid_Cell.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.
 
+#nullable disable
+
 using System;
 using JetBrains.Annotations;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/PlayerGrid_Facade.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/PlayerGrid_Facade.cs
index 6b363c6040..f7b8d48d0a 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/PlayerGrid_Facade.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/PlayerGrid_Facade.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 
 namespace osu.Game.Screens.OnlinePlay.Multiplayer.Spectate
diff --git a/osu.Game/Screens/OnlinePlay/OngoingOperationTracker.cs b/osu.Game/Screens/OnlinePlay/OngoingOperationTracker.cs
index aabeafe460..c87cf32c73 100644
--- a/osu.Game/Screens/OnlinePlay/OngoingOperationTracker.cs
+++ b/osu.Game/Screens/OnlinePlay/OngoingOperationTracker.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Screens/OnlinePlay/OnlinePlayComposite.cs b/osu.Game/Screens/OnlinePlay/OnlinePlayComposite.cs
index 88354c8646..1d9ea5f77d 100644
--- a/osu.Game/Screens/OnlinePlay/OnlinePlayComposite.cs
+++ b/osu.Game/Screens/OnlinePlay/OnlinePlayComposite.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Screens/OnlinePlay/OnlinePlayScreen.cs b/osu.Game/Screens/OnlinePlay/OnlinePlayScreen.cs
index ff4225e155..61ea7d68ee 100644
--- a/osu.Game/Screens/OnlinePlay/OnlinePlayScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/OnlinePlayScreen.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.
 
+#nullable disable
+
 using System.Diagnostics;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Screens/OnlinePlay/OnlinePlaySongSelect.cs b/osu.Game/Screens/OnlinePlay/OnlinePlaySongSelect.cs
index fb18a33d66..1552811c74 100644
--- a/osu.Game/Screens/OnlinePlay/OnlinePlaySongSelect.cs
+++ b/osu.Game/Screens/OnlinePlay/OnlinePlaySongSelect.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Screens/OnlinePlay/OnlinePlaySubScreen.cs b/osu.Game/Screens/OnlinePlay/OnlinePlaySubScreen.cs
index 07e0f60011..5c0a158c97 100644
--- a/osu.Game/Screens/OnlinePlay/OnlinePlaySubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/OnlinePlaySubScreen.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Screens;
diff --git a/osu.Game/Screens/OnlinePlay/OnlinePlaySubScreenStack.cs b/osu.Game/Screens/OnlinePlay/OnlinePlaySubScreenStack.cs
index 7f2a0980c1..ae6988f0d6 100644
--- a/osu.Game/Screens/OnlinePlay/OnlinePlaySubScreenStack.cs
+++ b/osu.Game/Screens/OnlinePlay/OnlinePlaySubScreenStack.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.
 
+#nullable disable
+
 using osu.Framework.Screens;
 
 namespace osu.Game.Screens.OnlinePlay
diff --git a/osu.Game/Screens/OnlinePlay/Playlists/CreatePlaylistsRoomButton.cs b/osu.Game/Screens/OnlinePlay/Playlists/CreatePlaylistsRoomButton.cs
index a9826a72eb..8cdae954ce 100644
--- a/osu.Game/Screens/OnlinePlay/Playlists/CreatePlaylistsRoomButton.cs
+++ b/osu.Game/Screens/OnlinePlay/Playlists/CreatePlaylistsRoomButton.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Game.Screens.OnlinePlay.Match.Components;
 
diff --git a/osu.Game/Screens/OnlinePlay/Playlists/Playlists.cs b/osu.Game/Screens/OnlinePlay/Playlists/Playlists.cs
index 1edeef77df..b84079b955 100644
--- a/osu.Game/Screens/OnlinePlay/Playlists/Playlists.cs
+++ b/osu.Game/Screens/OnlinePlay/Playlists/Playlists.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.
 
+#nullable disable
+
 using osu.Game.Screens.OnlinePlay.Lounge;
 
 namespace osu.Game.Screens.OnlinePlay.Playlists
diff --git a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsLoungeSubScreen.cs b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsLoungeSubScreen.cs
index b36e162e3d..0827e2031d 100644
--- a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsLoungeSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsLoungeSubScreen.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.ComponentModel;
 using System.Linq;
diff --git a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsPlayer.cs b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsPlayer.cs
index 5cba8676c5..282c1db585 100644
--- a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsPlayer.cs
+++ b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsPlayer.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.
 
+#nullable disable
+
 using System;
 using System.Diagnostics;
 using System.Linq;
diff --git a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsReadyButton.cs b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsReadyButton.cs
index 24f112ef0c..b8ab514721 100644
--- a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsReadyButton.cs
+++ b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsReadyButton.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsResultsScreen.cs b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsResultsScreen.cs
index 1e6722d51e..53b38962ac 100644
--- a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsResultsScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsResultsScreen.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Diagnostics;
diff --git a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomFooter.cs b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomFooter.cs
index 3eb1cde0a4..b1b400713f 100644
--- a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomFooter.cs
+++ b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomFooter.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSettingsOverlay.cs b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSettingsOverlay.cs
index 6674a37c3c..1e565e298e 100644
--- a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSettingsOverlay.cs
+++ b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSettingsOverlay.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Specialized;
 using System.Linq;
diff --git a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSettingsPlaylist.cs b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSettingsPlaylist.cs
index 2fe215eef2..80f38d0cd8 100644
--- a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSettingsPlaylist.cs
+++ b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSettingsPlaylist.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.
 
+#nullable disable
+
 using System.Linq;
 using osu.Framework.Extensions.IEnumerableExtensions;
 
diff --git a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSubScreen.cs b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSubScreen.cs
index 338a9c856f..ff657e16fb 100644
--- a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSubScreen.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.
 
+#nullable disable
+
 using System.Diagnostics;
 using System.Linq;
 using JetBrains.Annotations;
diff --git a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsSongSelect.cs b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsSongSelect.cs
index 86591c1d6d..65a27a9261 100644
--- a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsSongSelect.cs
+++ b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsSongSelect.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.
 
+#nullable disable
+
 using System.Linq;
 using osu.Framework.Screens;
 using osu.Game.Online.API;
diff --git a/osu.Game/Screens/OsuScreen.cs b/osu.Game/Screens/OsuScreen.cs
index 810aadffad..0678a90f71 100644
--- a/osu.Game/Screens/OsuScreen.cs
+++ b/osu.Game/Screens/OsuScreen.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using JetBrains.Annotations;
diff --git a/osu.Game/Screens/OsuScreenDependencies.cs b/osu.Game/Screens/OsuScreenDependencies.cs
index 8d54829d49..66176685fd 100644
--- a/osu.Game/Screens/OsuScreenDependencies.cs
+++ b/osu.Game/Screens/OsuScreenDependencies.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Screens/OsuScreenStack.cs b/osu.Game/Screens/OsuScreenStack.cs
index 18b16ba865..49f1255ec7 100644
--- a/osu.Game/Screens/OsuScreenStack.cs
+++ b/osu.Game/Screens/OsuScreenStack.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Screens;
diff --git a/osu.Game/Screens/Play/BeatmapMetadataDisplay.cs b/osu.Game/Screens/Play/BeatmapMetadataDisplay.cs
index e8021d4065..dca9401872 100644
--- a/osu.Game/Screens/Play/BeatmapMetadataDisplay.cs
+++ b/osu.Game/Screens/Play/BeatmapMetadataDisplay.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Diagnostics;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Screens/Play/Break/BlurredIcon.cs b/osu.Game/Screens/Play/Break/BlurredIcon.cs
index 1e974ec916..97eafa01fa 100644
--- a/osu.Game/Screens/Play/Break/BlurredIcon.cs
+++ b/osu.Game/Screens/Play/Break/BlurredIcon.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Screens/Play/Break/BreakArrows.cs b/osu.Game/Screens/Play/Break/BreakArrows.cs
index 4b96fa666a..f2feda4d76 100644
--- a/osu.Game/Screens/Play/Break/BreakArrows.cs
+++ b/osu.Game/Screens/Play/Break/BreakArrows.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Sprites;
diff --git a/osu.Game/Screens/Play/Break/BreakInfo.cs b/osu.Game/Screens/Play/Break/BreakInfo.cs
index ead41a826a..5aed8b7df1 100644
--- a/osu.Game/Screens/Play/Break/BreakInfo.cs
+++ b/osu.Game/Screens/Play/Break/BreakInfo.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Graphics;
diff --git a/osu.Game/Screens/Play/Break/BreakInfoLine.cs b/osu.Game/Screens/Play/Break/BreakInfoLine.cs
index 4cae90e50f..690d7c7e63 100644
--- a/osu.Game/Screens/Play/Break/BreakInfoLine.cs
+++ b/osu.Game/Screens/Play/Break/BreakInfoLine.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Screens/Play/Break/GlowIcon.cs b/osu.Game/Screens/Play/Break/GlowIcon.cs
index 2810389619..9222e8f890 100644
--- a/osu.Game/Screens/Play/Break/GlowIcon.cs
+++ b/osu.Game/Screens/Play/Break/GlowIcon.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Screens/Play/Break/LetterboxOverlay.cs b/osu.Game/Screens/Play/Break/LetterboxOverlay.cs
index 2d7163b5fe..3eb58da469 100644
--- a/osu.Game/Screens/Play/Break/LetterboxOverlay.cs
+++ b/osu.Game/Screens/Play/Break/LetterboxOverlay.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Colour;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Screens/Play/Break/RemainingTimeCounter.cs b/osu.Game/Screens/Play/Break/RemainingTimeCounter.cs
index 2f5e43aebf..4b84f7c69e 100644
--- a/osu.Game/Screens/Play/Break/RemainingTimeCounter.cs
+++ b/osu.Game/Screens/Play/Break/RemainingTimeCounter.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.UserInterface;
diff --git a/osu.Game/Screens/Play/BreakOverlay.cs b/osu.Game/Screens/Play/BreakOverlay.cs
index 1665ee83ae..492c9c27ff 100644
--- a/osu.Game/Screens/Play/BreakOverlay.cs
+++ b/osu.Game/Screens/Play/BreakOverlay.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Screens/Play/BreakTracker.cs b/osu.Game/Screens/Play/BreakTracker.cs
index 8441b7657e..8679db01a0 100644
--- a/osu.Game/Screens/Play/BreakTracker.cs
+++ b/osu.Game/Screens/Play/BreakTracker.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Screens/Play/ComboEffects.cs b/osu.Game/Screens/Play/ComboEffects.cs
index 5041d07e5d..77681401bb 100644
--- a/osu.Game/Screens/Play/ComboEffects.cs
+++ b/osu.Game/Screens/Play/ComboEffects.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Screens/Play/DimmableStoryboard.cs b/osu.Game/Screens/Play/DimmableStoryboard.cs
index 5a3ef1e9d3..ae43d3d70d 100644
--- a/osu.Game/Screens/Play/DimmableStoryboard.cs
+++ b/osu.Game/Screens/Play/DimmableStoryboard.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Screens/Play/EpilepsyWarning.cs b/osu.Game/Screens/Play/EpilepsyWarning.cs
index ccb2870d78..4f87853158 100644
--- a/osu.Game/Screens/Play/EpilepsyWarning.cs
+++ b/osu.Game/Screens/Play/EpilepsyWarning.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Screens/Play/FailAnimation.cs b/osu.Game/Screens/Play/FailAnimation.cs
index 17a3e5eb71..ca485aa8ea 100644
--- a/osu.Game/Screens/Play/FailAnimation.cs
+++ b/osu.Game/Screens/Play/FailAnimation.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.
 
+#nullable disable
+
 using osu.Framework.Audio;
 using osu.Framework.Bindables;
 using osu.Game.Rulesets.UI;
diff --git a/osu.Game/Screens/Play/FailOverlay.cs b/osu.Game/Screens/Play/FailOverlay.cs
index b67f45c4f2..1a31b0f462 100644
--- a/osu.Game/Screens/Play/FailOverlay.cs
+++ b/osu.Game/Screens/Play/FailOverlay.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.
 
+#nullable disable
+
 using osu.Game.Graphics;
 using osuTK.Graphics;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Screens/Play/GameplayClock.cs b/osu.Game/Screens/Play/GameplayClock.cs
index 54aa395f5f..e6248014c5 100644
--- a/osu.Game/Screens/Play/GameplayClock.cs
+++ b/osu.Game/Screens/Play/GameplayClock.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Screens/Play/GameplayClockContainer.cs b/osu.Game/Screens/Play/GameplayClockContainer.cs
index 721abc66f8..6403943a53 100644
--- a/osu.Game/Screens/Play/GameplayClockContainer.cs
+++ b/osu.Game/Screens/Play/GameplayClockContainer.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Screens/Play/GameplayMenuOverlay.cs b/osu.Game/Screens/Play/GameplayMenuOverlay.cs
index 9e3400b09d..99b9362700 100644
--- a/osu.Game/Screens/Play/GameplayMenuOverlay.cs
+++ b/osu.Game/Screens/Play/GameplayMenuOverlay.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Screens/Play/GameplayState.cs b/osu.Game/Screens/Play/GameplayState.cs
index 586cdcda51..9fb62106f3 100644
--- a/osu.Game/Screens/Play/GameplayState.cs
+++ b/osu.Game/Screens/Play/GameplayState.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 enable
-
 using System;
 using System.Collections.Generic;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Screens/Play/HUD/DefaultAccuracyCounter.cs b/osu.Game/Screens/Play/HUD/DefaultAccuracyCounter.cs
index 06b53e8426..018720510c 100644
--- a/osu.Game/Screens/Play/HUD/DefaultAccuracyCounter.cs
+++ b/osu.Game/Screens/Play/HUD/DefaultAccuracyCounter.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Game.Graphics;
 using osu.Game.Skinning;
diff --git a/osu.Game/Screens/Play/HUD/DefaultComboCounter.cs b/osu.Game/Screens/Play/HUD/DefaultComboCounter.cs
index 52f86d2bc3..1f14811169 100644
--- a/osu.Game/Screens/Play/HUD/DefaultComboCounter.cs
+++ b/osu.Game/Screens/Play/HUD/DefaultComboCounter.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Screens/Play/HUD/DefaultHealthDisplay.cs b/osu.Game/Screens/Play/HUD/DefaultHealthDisplay.cs
index 4f93868a66..37e1d2fb84 100644
--- a/osu.Game/Screens/Play/HUD/DefaultHealthDisplay.cs
+++ b/osu.Game/Screens/Play/HUD/DefaultHealthDisplay.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.Color4Extensions;
diff --git a/osu.Game/Screens/Play/HUD/DefaultScoreCounter.cs b/osu.Game/Screens/Play/HUD/DefaultScoreCounter.cs
index 6af89404e0..4450ad53d8 100644
--- a/osu.Game/Screens/Play/HUD/DefaultScoreCounter.cs
+++ b/osu.Game/Screens/Play/HUD/DefaultScoreCounter.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Game.Graphics;
diff --git a/osu.Game/Screens/Play/HUD/FailingLayer.cs b/osu.Game/Screens/Play/HUD/FailingLayer.cs
index ceb81f6b8d..10c1d418ee 100644
--- a/osu.Game/Screens/Play/HUD/FailingLayer.cs
+++ b/osu.Game/Screens/Play/HUD/FailingLayer.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Screens/Play/HUD/GameplayAccuracyCounter.cs b/osu.Game/Screens/Play/HUD/GameplayAccuracyCounter.cs
index 7a63084812..afb6749436 100644
--- a/osu.Game/Screens/Play/HUD/GameplayAccuracyCounter.cs
+++ b/osu.Game/Screens/Play/HUD/GameplayAccuracyCounter.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Rulesets.Scoring;
diff --git a/osu.Game/Screens/Play/HUD/GameplayLeaderboard.cs b/osu.Game/Screens/Play/HUD/GameplayLeaderboard.cs
index 638b2c395f..f21ce5e36a 100644
--- a/osu.Game/Screens/Play/HUD/GameplayLeaderboard.cs
+++ b/osu.Game/Screens/Play/HUD/GameplayLeaderboard.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using JetBrains.Annotations;
diff --git a/osu.Game/Screens/Play/HUD/GameplayLeaderboardScore.cs b/osu.Game/Screens/Play/HUD/GameplayLeaderboardScore.cs
index 773ee4a036..0f007cd1cb 100644
--- a/osu.Game/Screens/Play/HUD/GameplayLeaderboardScore.cs
+++ b/osu.Game/Screens/Play/HUD/GameplayLeaderboardScore.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.
 
+#nullable disable
+
 using JetBrains.Annotations;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Screens/Play/HUD/GameplayScoreCounter.cs b/osu.Game/Screens/Play/HUD/GameplayScoreCounter.cs
index e05eff5f3e..7a6292ccbf 100644
--- a/osu.Game/Screens/Play/HUD/GameplayScoreCounter.cs
+++ b/osu.Game/Screens/Play/HUD/GameplayScoreCounter.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Screens/Play/HUD/HealthDisplay.cs b/osu.Game/Screens/Play/HUD/HealthDisplay.cs
index 94f1b99b37..569b37aea5 100644
--- a/osu.Game/Screens/Play/HUD/HealthDisplay.cs
+++ b/osu.Game/Screens/Play/HUD/HealthDisplay.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Screens/Play/HUD/HitErrorMeters/BarHitErrorMeter.cs b/osu.Game/Screens/Play/HUD/HitErrorMeters/BarHitErrorMeter.cs
index dca50c07ad..747f4d4a8a 100644
--- a/osu.Game/Screens/Play/HUD/HitErrorMeters/BarHitErrorMeter.cs
+++ b/osu.Game/Screens/Play/HUD/HitErrorMeters/BarHitErrorMeter.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Screens/Play/HUD/HitErrorMeters/ColourHitErrorMeter.cs b/osu.Game/Screens/Play/HUD/HitErrorMeters/ColourHitErrorMeter.cs
index 9948b968d1..335d956e39 100644
--- a/osu.Game/Screens/Play/HUD/HitErrorMeters/ColourHitErrorMeter.cs
+++ b/osu.Game/Screens/Play/HUD/HitErrorMeters/ColourHitErrorMeter.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Screens/Play/HUD/HitErrorMeters/HitErrorMeter.cs b/osu.Game/Screens/Play/HUD/HitErrorMeters/HitErrorMeter.cs
index e7aaee9fa1..26befd659c 100644
--- a/osu.Game/Screens/Play/HUD/HitErrorMeters/HitErrorMeter.cs
+++ b/osu.Game/Screens/Play/HUD/HitErrorMeters/HitErrorMeter.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Graphics;
diff --git a/osu.Game/Screens/Play/HUD/HoldForMenuButton.cs b/osu.Game/Screens/Play/HUD/HoldForMenuButton.cs
index 2ba76d0896..aa9a2ab242 100644
--- a/osu.Game/Screens/Play/HUD/HoldForMenuButton.cs
+++ b/osu.Game/Screens/Play/HUD/HoldForMenuButton.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Screens/Play/HUD/ILeaderboardScore.cs b/osu.Game/Screens/Play/HUD/ILeaderboardScore.cs
index 83b6f6621b..20bf7045b8 100644
--- a/osu.Game/Screens/Play/HUD/ILeaderboardScore.cs
+++ b/osu.Game/Screens/Play/HUD/ILeaderboardScore.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.
 
+#nullable disable
+
 using osu.Framework.Bindables;
 
 namespace osu.Game.Screens.Play.HUD
diff --git a/osu.Game/Screens/Play/HUD/LegacyComboCounter.cs b/osu.Game/Screens/Play/HUD/LegacyComboCounter.cs
index eaca623e39..6e36ffb54e 100644
--- a/osu.Game/Screens/Play/HUD/LegacyComboCounter.cs
+++ b/osu.Game/Screens/Play/HUD/LegacyComboCounter.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Screens/Play/HUD/MatchScoreDisplay.cs b/osu.Game/Screens/Play/HUD/MatchScoreDisplay.cs
index 2129000268..00dc586448 100644
--- a/osu.Game/Screens/Play/HUD/MatchScoreDisplay.cs
+++ b/osu.Game/Screens/Play/HUD/MatchScoreDisplay.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Screens/Play/HUD/ModDisplay.cs b/osu.Game/Screens/Play/HUD/ModDisplay.cs
index b4a3eb209a..0badc063ce 100644
--- a/osu.Game/Screens/Play/HUD/ModDisplay.cs
+++ b/osu.Game/Screens/Play/HUD/ModDisplay.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Screens/Play/HUD/ModFlowDisplay.cs b/osu.Game/Screens/Play/HUD/ModFlowDisplay.cs
index ff3ca6460f..86fece84fa 100644
--- a/osu.Game/Screens/Play/HUD/ModFlowDisplay.cs
+++ b/osu.Game/Screens/Play/HUD/ModFlowDisplay.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Screens/Play/HUD/MultiplayerGameplayLeaderboard.cs b/osu.Game/Screens/Play/HUD/MultiplayerGameplayLeaderboard.cs
index 5ee6000cf0..ac58325060 100644
--- a/osu.Game/Screens/Play/HUD/MultiplayerGameplayLeaderboard.cs
+++ b/osu.Game/Screens/Play/HUD/MultiplayerGameplayLeaderboard.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Collections.Specialized;
diff --git a/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs b/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs
index bdc98e53f9..97a120f9bd 100644
--- a/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs
+++ b/osu.Game/Screens/Play/HUD/PerformancePointsCounter.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.IO;
diff --git a/osu.Game/Screens/Play/HUD/PlayerSettingsOverlay.cs b/osu.Game/Screens/Play/HUD/PlayerSettingsOverlay.cs
index 807b4989c7..5f6f040959 100644
--- a/osu.Game/Screens/Play/HUD/PlayerSettingsOverlay.cs
+++ b/osu.Game/Screens/Play/HUD/PlayerSettingsOverlay.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Input.Events;
diff --git a/osu.Game/Screens/Play/HUD/SkinnableInfo.cs b/osu.Game/Screens/Play/HUD/SkinnableInfo.cs
index 1f659fd5bf..f045ab661e 100644
--- a/osu.Game/Screens/Play/HUD/SkinnableInfo.cs
+++ b/osu.Game/Screens/Play/HUD/SkinnableInfo.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Screens/Play/HUD/UnstableRateCounter.cs b/osu.Game/Screens/Play/HUD/UnstableRateCounter.cs
index a71b661965..0ba88c549e 100644
--- a/osu.Game/Screens/Play/HUD/UnstableRateCounter.cs
+++ b/osu.Game/Screens/Play/HUD/UnstableRateCounter.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Screens/Play/HUDOverlay.cs b/osu.Game/Screens/Play/HUDOverlay.cs
index 89329bfc65..fe27e1fc24 100644
--- a/osu.Game/Screens/Play/HUDOverlay.cs
+++ b/osu.Game/Screens/Play/HUDOverlay.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Screens/Play/HotkeyExitOverlay.cs b/osu.Game/Screens/Play/HotkeyExitOverlay.cs
index 9fe7d17cc7..07595a43c4 100644
--- a/osu.Game/Screens/Play/HotkeyExitOverlay.cs
+++ b/osu.Game/Screens/Play/HotkeyExitOverlay.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.
 
+#nullable disable
+
 using osu.Framework.Input.Bindings;
 using osu.Framework.Input.Events;
 using osu.Game.Input.Bindings;
diff --git a/osu.Game/Screens/Play/HotkeyRetryOverlay.cs b/osu.Game/Screens/Play/HotkeyRetryOverlay.cs
index 2812df8bbe..94c0f0a89d 100644
--- a/osu.Game/Screens/Play/HotkeyRetryOverlay.cs
+++ b/osu.Game/Screens/Play/HotkeyRetryOverlay.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.
 
+#nullable disable
+
 using osu.Framework.Input.Bindings;
 using osu.Framework.Input.Events;
 using osu.Game.Input.Bindings;
diff --git a/osu.Game/Screens/Play/ILocalUserPlayInfo.cs b/osu.Game/Screens/Play/ILocalUserPlayInfo.cs
index 9a2259b12f..e4328b2c78 100644
--- a/osu.Game/Screens/Play/ILocalUserPlayInfo.cs
+++ b/osu.Game/Screens/Play/ILocalUserPlayInfo.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 
diff --git a/osu.Game/Screens/Play/KeyCounter.cs b/osu.Game/Screens/Play/KeyCounter.cs
index 98df73a5e6..1e5ada5295 100644
--- a/osu.Game/Screens/Play/KeyCounter.cs
+++ b/osu.Game/Screens/Play/KeyCounter.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Screens/Play/KeyCounterAction.cs b/osu.Game/Screens/Play/KeyCounterAction.cs
index 00eddcc776..f636796436 100644
--- a/osu.Game/Screens/Play/KeyCounterAction.cs
+++ b/osu.Game/Screens/Play/KeyCounterAction.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 
 namespace osu.Game.Screens.Play
diff --git a/osu.Game/Screens/Play/KeyCounterDisplay.cs b/osu.Game/Screens/Play/KeyCounterDisplay.cs
index 66a44e5314..ef28632d76 100644
--- a/osu.Game/Screens/Play/KeyCounterDisplay.cs
+++ b/osu.Game/Screens/Play/KeyCounterDisplay.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Screens/Play/KeyCounterKeyboard.cs b/osu.Game/Screens/Play/KeyCounterKeyboard.cs
index 187dcc1264..1005de4ea4 100644
--- a/osu.Game/Screens/Play/KeyCounterKeyboard.cs
+++ b/osu.Game/Screens/Play/KeyCounterKeyboard.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.
 
+#nullable disable
+
 using osu.Framework.Input.Events;
 using osuTK.Input;
 
diff --git a/osu.Game/Screens/Play/KeyCounterMouse.cs b/osu.Game/Screens/Play/KeyCounterMouse.cs
index e55525c5e8..0dc2830665 100644
--- a/osu.Game/Screens/Play/KeyCounterMouse.cs
+++ b/osu.Game/Screens/Play/KeyCounterMouse.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.
 
+#nullable disable
+
 using osu.Framework.Input.Events;
 using osuTK.Input;
 using osuTK;
diff --git a/osu.Game/Screens/Play/KeyCounterState.cs b/osu.Game/Screens/Play/KeyCounterState.cs
index 0bceae9f85..45d027e5ec 100644
--- a/osu.Game/Screens/Play/KeyCounterState.cs
+++ b/osu.Game/Screens/Play/KeyCounterState.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.
 
+#nullable disable
+
 namespace osu.Game.Screens.Play
 {
     public class KeyCounterState
diff --git a/osu.Game/Screens/Play/MasterGameplayClockContainer.cs b/osu.Game/Screens/Play/MasterGameplayClockContainer.cs
index d87d57ec49..0994a7d9bb 100644
--- a/osu.Game/Screens/Play/MasterGameplayClockContainer.cs
+++ b/osu.Game/Screens/Play/MasterGameplayClockContainer.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Screens/Play/PauseOverlay.cs b/osu.Game/Screens/Play/PauseOverlay.cs
index e0b7e5c941..cb98fefcfe 100644
--- a/osu.Game/Screens/Play/PauseOverlay.cs
+++ b/osu.Game/Screens/Play/PauseOverlay.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Screens/Play/Player.cs b/osu.Game/Screens/Play/Player.cs
index 33a20ff190..4a8460ff46 100644
--- a/osu.Game/Screens/Play/Player.cs
+++ b/osu.Game/Screens/Play/Player.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.
 
+#nullable disable
+
 using System;
 using System.IO;
 using System.Linq;
diff --git a/osu.Game/Screens/Play/PlayerConfiguration.cs b/osu.Game/Screens/Play/PlayerConfiguration.cs
index 3aa424e5d5..d11825baee 100644
--- a/osu.Game/Screens/Play/PlayerConfiguration.cs
+++ b/osu.Game/Screens/Play/PlayerConfiguration.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.
 
+#nullable disable
+
 namespace osu.Game.Screens.Play
 {
     public class PlayerConfiguration
diff --git a/osu.Game/Screens/Play/PlayerLoader.cs b/osu.Game/Screens/Play/PlayerLoader.cs
index f3b22c3355..5d7319c51f 100644
--- a/osu.Game/Screens/Play/PlayerLoader.cs
+++ b/osu.Game/Screens/Play/PlayerLoader.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 enable
-
 using System;
 using System.Diagnostics;
 using System.Threading.Tasks;
diff --git a/osu.Game/Screens/Play/PlayerSettings/AudioSettings.cs b/osu.Game/Screens/Play/PlayerSettings/AudioSettings.cs
index 90caf6f0f3..606b5c198c 100644
--- a/osu.Game/Screens/Play/PlayerSettings/AudioSettings.cs
+++ b/osu.Game/Screens/Play/PlayerSettings/AudioSettings.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs b/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
index 1662ca399f..75da8e7b9d 100644
--- a/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.cs
+++ b/osu.Game/Screens/Play/PlayerSettings/BeatmapOffsetControl.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 enable
-
 using System;
 using System.Diagnostics;
 using System.Linq;
diff --git a/osu.Game/Screens/Play/PlayerSettings/DiscussionSettings.cs b/osu.Game/Screens/Play/PlayerSettings/DiscussionSettings.cs
index ac040774ee..afbd5caef3 100644
--- a/osu.Game/Screens/Play/PlayerSettings/DiscussionSettings.cs
+++ b/osu.Game/Screens/Play/PlayerSettings/DiscussionSettings.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Game.Configuration;
diff --git a/osu.Game/Screens/Play/PlayerSettings/InputSettings.cs b/osu.Game/Screens/Play/PlayerSettings/InputSettings.cs
index b1063966da..04cf79873c 100644
--- a/osu.Game/Screens/Play/PlayerSettings/InputSettings.cs
+++ b/osu.Game/Screens/Play/PlayerSettings/InputSettings.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Game.Configuration;
diff --git a/osu.Game/Screens/Play/PlayerSettings/PlaybackSettings.cs b/osu.Game/Screens/Play/PlayerSettings/PlaybackSettings.cs
index 16e29ac3c8..12646d656a 100644
--- a/osu.Game/Screens/Play/PlayerSettings/PlaybackSettings.cs
+++ b/osu.Game/Screens/Play/PlayerSettings/PlaybackSettings.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.
 
+#nullable disable
+
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Screens/Play/PlayerSettings/PlayerCheckbox.cs b/osu.Game/Screens/Play/PlayerSettings/PlayerCheckbox.cs
index 26887327cd..dc09676254 100644
--- a/osu.Game/Screens/Play/PlayerSettings/PlayerCheckbox.cs
+++ b/osu.Game/Screens/Play/PlayerSettings/PlayerCheckbox.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Game.Graphics;
 using osu.Game.Graphics.UserInterface;
diff --git a/osu.Game/Screens/Play/PlayerSettings/PlayerSettingsGroup.cs b/osu.Game/Screens/Play/PlayerSettings/PlayerSettingsGroup.cs
index 0bbe6902f4..6c6f62a8ac 100644
--- a/osu.Game/Screens/Play/PlayerSettings/PlayerSettingsGroup.cs
+++ b/osu.Game/Screens/Play/PlayerSettings/PlayerSettingsGroup.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.
 
+#nullable disable
+
 using osu.Framework.Input.Events;
 using osu.Game.Overlays;
 
diff --git a/osu.Game/Screens/Play/PlayerSettings/PlayerSliderBar.cs b/osu.Game/Screens/Play/PlayerSettings/PlayerSliderBar.cs
index 3f1a5bc0ac..063056e83e 100644
--- a/osu.Game/Screens/Play/PlayerSettings/PlayerSliderBar.cs
+++ b/osu.Game/Screens/Play/PlayerSettings/PlayerSliderBar.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Screens/Play/PlayerSettings/VisualSettings.cs b/osu.Game/Screens/Play/PlayerSettings/VisualSettings.cs
index a999b32cb4..e55af0bba7 100644
--- a/osu.Game/Screens/Play/PlayerSettings/VisualSettings.cs
+++ b/osu.Game/Screens/Play/PlayerSettings/VisualSettings.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Game.Configuration;
diff --git a/osu.Game/Screens/Play/ReplayPlayer.cs b/osu.Game/Screens/Play/ReplayPlayer.cs
index 617374b4fd..2a5e356df8 100644
--- a/osu.Game/Screens/Play/ReplayPlayer.cs
+++ b/osu.Game/Screens/Play/ReplayPlayer.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Screens/Play/ReplayPlayerLoader.cs b/osu.Game/Screens/Play/ReplayPlayerLoader.cs
index e78f700af2..a961f90d00 100644
--- a/osu.Game/Screens/Play/ReplayPlayerLoader.cs
+++ b/osu.Game/Screens/Play/ReplayPlayerLoader.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Screens;
 using osu.Game.Scoring;
diff --git a/osu.Game/Screens/Play/ResumeOverlay.cs b/osu.Game/Screens/Play/ResumeOverlay.cs
index 641d5358ba..2be1f93f80 100644
--- a/osu.Game/Screens/Play/ResumeOverlay.cs
+++ b/osu.Game/Screens/Play/ResumeOverlay.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Screens/Play/RoomSubmittingPlayer.cs b/osu.Game/Screens/Play/RoomSubmittingPlayer.cs
index fc96dfa965..3eb659664a 100644
--- a/osu.Game/Screens/Play/RoomSubmittingPlayer.cs
+++ b/osu.Game/Screens/Play/RoomSubmittingPlayer.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.
 
+#nullable disable
+
 using System.Diagnostics;
 using osu.Game.Online.API;
 using osu.Game.Online.Rooms;
diff --git a/osu.Game/Screens/Play/ScreenSuspensionHandler.cs b/osu.Game/Screens/Play/ScreenSuspensionHandler.cs
index 30ca15c311..59b92a1b97 100644
--- a/osu.Game/Screens/Play/ScreenSuspensionHandler.cs
+++ b/osu.Game/Screens/Play/ScreenSuspensionHandler.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.
 
+#nullable disable
+
 using System;
 using JetBrains.Annotations;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Screens/Play/ScreenWithBeatmapBackground.cs b/osu.Game/Screens/Play/ScreenWithBeatmapBackground.cs
index 88dab88d42..7152fb7473 100644
--- a/osu.Game/Screens/Play/ScreenWithBeatmapBackground.cs
+++ b/osu.Game/Screens/Play/ScreenWithBeatmapBackground.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.
 
+#nullable disable
+
 using System;
 using osu.Game.Screens.Backgrounds;
 
diff --git a/osu.Game/Screens/Play/SkipOverlay.cs b/osu.Game/Screens/Play/SkipOverlay.cs
index 84d5507dce..3e2cf9a756 100644
--- a/osu.Game/Screens/Play/SkipOverlay.cs
+++ b/osu.Game/Screens/Play/SkipOverlay.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.
 
+#nullable disable
+
 using System;
 using osu.Framework;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Screens/Play/SoloPlayer.cs b/osu.Game/Screens/Play/SoloPlayer.cs
index a935ce49eb..b65602e7a8 100644
--- a/osu.Game/Screens/Play/SoloPlayer.cs
+++ b/osu.Game/Screens/Play/SoloPlayer.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.
 
+#nullable disable
+
 using System;
 using System.Diagnostics;
 using osu.Game.Beatmaps;
diff --git a/osu.Game/Screens/Play/SoloSpectator.cs b/osu.Game/Screens/Play/SoloSpectator.cs
index 202527f308..7eaba40640 100644
--- a/osu.Game/Screens/Play/SoloSpectator.cs
+++ b/osu.Game/Screens/Play/SoloSpectator.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.
 
+#nullable disable
+
 using System.Diagnostics;
 using JetBrains.Annotations;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Screens/Play/SoloSpectatorPlayer.cs b/osu.Game/Screens/Play/SoloSpectatorPlayer.cs
index 5b601083c2..5aa310750b 100644
--- a/osu.Game/Screens/Play/SoloSpectatorPlayer.cs
+++ b/osu.Game/Screens/Play/SoloSpectatorPlayer.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Screens;
 using osu.Game.Online.Spectator;
diff --git a/osu.Game/Screens/Play/SongProgress.cs b/osu.Game/Screens/Play/SongProgress.cs
index b38dcb937d..d1510d10c2 100644
--- a/osu.Game/Screens/Play/SongProgress.cs
+++ b/osu.Game/Screens/Play/SongProgress.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Screens/Play/SongProgressBar.cs b/osu.Game/Screens/Play/SongProgressBar.cs
index 5052b32335..67923f4b6a 100644
--- a/osu.Game/Screens/Play/SongProgressBar.cs
+++ b/osu.Game/Screens/Play/SongProgressBar.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.
 
+#nullable disable
+
 using System;
 using osuTK;
 using osuTK.Graphics;
diff --git a/osu.Game/Screens/Play/SongProgressGraph.cs b/osu.Game/Screens/Play/SongProgressGraph.cs
index f96de149ba..c742df67ce 100644
--- a/osu.Game/Screens/Play/SongProgressGraph.cs
+++ b/osu.Game/Screens/Play/SongProgressGraph.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.
 
+#nullable disable
+
 using System.Linq;
 using System.Collections.Generic;
 using System.Diagnostics;
diff --git a/osu.Game/Screens/Play/SongProgressInfo.cs b/osu.Game/Screens/Play/SongProgressInfo.cs
index 7a458cdde0..40759c3a3b 100644
--- a/osu.Game/Screens/Play/SongProgressInfo.cs
+++ b/osu.Game/Screens/Play/SongProgressInfo.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Screens/Play/SpectatorPlayer.cs b/osu.Game/Screens/Play/SpectatorPlayer.cs
index 09bec9b89f..d5aec055fc 100644
--- a/osu.Game/Screens/Play/SpectatorPlayer.cs
+++ b/osu.Game/Screens/Play/SpectatorPlayer.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Screens;
diff --git a/osu.Game/Screens/Play/SpectatorPlayerLoader.cs b/osu.Game/Screens/Play/SpectatorPlayerLoader.cs
index 9ca5475ee4..6b664a4f96 100644
--- a/osu.Game/Screens/Play/SpectatorPlayerLoader.cs
+++ b/osu.Game/Screens/Play/SpectatorPlayerLoader.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Screens;
 using osu.Game.Scoring;
diff --git a/osu.Game/Screens/Play/SpectatorResultsScreen.cs b/osu.Game/Screens/Play/SpectatorResultsScreen.cs
index fd7af3af85..3d320bd294 100644
--- a/osu.Game/Screens/Play/SpectatorResultsScreen.cs
+++ b/osu.Game/Screens/Play/SpectatorResultsScreen.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Screens;
 using osu.Game.Online.Spectator;
diff --git a/osu.Game/Screens/Play/SquareGraph.cs b/osu.Game/Screens/Play/SquareGraph.cs
index a7d4454701..00d6ede3bf 100644
--- a/osu.Game/Screens/Play/SquareGraph.cs
+++ b/osu.Game/Screens/Play/SquareGraph.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Screens/Play/SubmittingPlayer.cs b/osu.Game/Screens/Play/SubmittingPlayer.cs
index b62dc1e5a6..1cc0d1853d 100644
--- a/osu.Game/Screens/Play/SubmittingPlayer.cs
+++ b/osu.Game/Screens/Play/SubmittingPlayer.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using System.Threading.Tasks;
diff --git a/osu.Game/Screens/Ranking/AspectContainer.cs b/osu.Game/Screens/Ranking/AspectContainer.cs
index 84329d2a04..1c93d08474 100644
--- a/osu.Game/Screens/Ranking/AspectContainer.cs
+++ b/osu.Game/Screens/Ranking/AspectContainer.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 
diff --git a/osu.Game/Screens/Ranking/Contracted/ContractedPanelMiddleContent.cs b/osu.Game/Screens/Ranking/Contracted/ContractedPanelMiddleContent.cs
index bb286f41c0..7b8b4ce608 100644
--- a/osu.Game/Screens/Ranking/Contracted/ContractedPanelMiddleContent.cs
+++ b/osu.Game/Screens/Ranking/Contracted/ContractedPanelMiddleContent.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.
 
+#nullable disable
+
 using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.Color4Extensions;
diff --git a/osu.Game/Screens/Ranking/Contracted/ContractedPanelTopContent.cs b/osu.Game/Screens/Ranking/Contracted/ContractedPanelTopContent.cs
index beff509dc6..74b2f4ef93 100644
--- a/osu.Game/Screens/Ranking/Contracted/ContractedPanelTopContent.cs
+++ b/osu.Game/Screens/Ranking/Contracted/ContractedPanelTopContent.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Screens/Ranking/Expanded/Accuracy/AccuracyCircle.cs b/osu.Game/Screens/Ranking/Expanded/Accuracy/AccuracyCircle.cs
index b9248bd67e..a1879c5c9b 100644
--- a/osu.Game/Screens/Ranking/Expanded/Accuracy/AccuracyCircle.cs
+++ b/osu.Game/Screens/Ranking/Expanded/Accuracy/AccuracyCircle.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Screens/Ranking/Expanded/Accuracy/RankBadge.cs b/osu.Game/Screens/Ranking/Expanded/Accuracy/RankBadge.cs
index d0b79aa4c7..80415dbbc2 100644
--- a/osu.Game/Screens/Ranking/Expanded/Accuracy/RankBadge.cs
+++ b/osu.Game/Screens/Ranking/Expanded/Accuracy/RankBadge.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.Color4Extensions;
diff --git a/osu.Game/Screens/Ranking/Expanded/Accuracy/RankNotch.cs b/osu.Game/Screens/Ranking/Expanded/Accuracy/RankNotch.cs
index 894790b5b6..573833932f 100644
--- a/osu.Game/Screens/Ranking/Expanded/Accuracy/RankNotch.cs
+++ b/osu.Game/Screens/Ranking/Expanded/Accuracy/RankNotch.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Screens/Ranking/Expanded/Accuracy/RankText.cs b/osu.Game/Screens/Ranking/Expanded/Accuracy/RankText.cs
index 5aea0184ee..2d9c1f9d07 100644
--- a/osu.Game/Screens/Ranking/Expanded/Accuracy/RankText.cs
+++ b/osu.Game/Screens/Ranking/Expanded/Accuracy/RankText.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Screens/Ranking/Expanded/Accuracy/SmoothCircularProgress.cs b/osu.Game/Screens/Ranking/Expanded/Accuracy/SmoothCircularProgress.cs
index 106af31cae..b4f41e0f39 100644
--- a/osu.Game/Screens/Ranking/Expanded/Accuracy/SmoothCircularProgress.cs
+++ b/osu.Game/Screens/Ranking/Expanded/Accuracy/SmoothCircularProgress.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.
 
+#nullable disable
+
 using osu.Framework.Bindables;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Screens/Ranking/Expanded/ExpandedPanelMiddleContent.cs b/osu.Game/Screens/Ranking/Expanded/ExpandedPanelMiddleContent.cs
index b924fbd5df..5b8777d2a4 100644
--- a/osu.Game/Screens/Ranking/Expanded/ExpandedPanelMiddleContent.cs
+++ b/osu.Game/Screens/Ranking/Expanded/ExpandedPanelMiddleContent.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Screens/Ranking/Expanded/ExpandedPanelTopContent.cs b/osu.Game/Screens/Ranking/Expanded/ExpandedPanelTopContent.cs
index bf06bc2227..d2b2a842b8 100644
--- a/osu.Game/Screens/Ranking/Expanded/ExpandedPanelTopContent.cs
+++ b/osu.Game/Screens/Ranking/Expanded/ExpandedPanelTopContent.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Screens/Ranking/Expanded/Statistics/AccuracyStatistic.cs b/osu.Game/Screens/Ranking/Expanded/Statistics/AccuracyStatistic.cs
index 25a644d8d9..824156598c 100644
--- a/osu.Game/Screens/Ranking/Expanded/Statistics/AccuracyStatistic.cs
+++ b/osu.Game/Screens/Ranking/Expanded/Statistics/AccuracyStatistic.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Localisation;
 using osu.Game.Graphics;
diff --git a/osu.Game/Screens/Ranking/Expanded/Statistics/ComboStatistic.cs b/osu.Game/Screens/Ranking/Expanded/Statistics/ComboStatistic.cs
index cb25736f6e..5d7b04743e 100644
--- a/osu.Game/Screens/Ranking/Expanded/Statistics/ComboStatistic.cs
+++ b/osu.Game/Screens/Ranking/Expanded/Statistics/ComboStatistic.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.
 
+#nullable disable
+
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Colour;
diff --git a/osu.Game/Screens/Ranking/Expanded/Statistics/CounterStatistic.cs b/osu.Game/Screens/Ranking/Expanded/Statistics/CounterStatistic.cs
index b1c72173da..17a12a76a5 100644
--- a/osu.Game/Screens/Ranking/Expanded/Statistics/CounterStatistic.cs
+++ b/osu.Game/Screens/Ranking/Expanded/Statistics/CounterStatistic.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Localisation;
diff --git a/osu.Game/Screens/Ranking/Expanded/Statistics/HitResultStatistic.cs b/osu.Game/Screens/Ranking/Expanded/Statistics/HitResultStatistic.cs
index ada8dfabf0..c23a5e668d 100644
--- a/osu.Game/Screens/Ranking/Expanded/Statistics/HitResultStatistic.cs
+++ b/osu.Game/Screens/Ranking/Expanded/Statistics/HitResultStatistic.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Game.Graphics;
 using osu.Game.Rulesets.Scoring;
diff --git a/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatistic.cs b/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatistic.cs
index c681946a2f..332215e15d 100644
--- a/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatistic.cs
+++ b/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatistic.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.
 
+#nullable disable
+
 using System;
 using System.Threading;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Screens/Ranking/Expanded/Statistics/StatisticCounter.cs b/osu.Game/Screens/Ranking/Expanded/Statistics/StatisticCounter.cs
index bbcfc43dc8..36d6d6fa7c 100644
--- a/osu.Game/Screens/Ranking/Expanded/Statistics/StatisticCounter.cs
+++ b/osu.Game/Screens/Ranking/Expanded/Statistics/StatisticCounter.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
diff --git a/osu.Game/Screens/Ranking/Expanded/Statistics/StatisticDisplay.cs b/osu.Game/Screens/Ranking/Expanded/Statistics/StatisticDisplay.cs
index c034abc916..0d8dcda895 100644
--- a/osu.Game/Screens/Ranking/Expanded/Statistics/StatisticDisplay.cs
+++ b/osu.Game/Screens/Ranking/Expanded/Statistics/StatisticDisplay.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Extensions.LocalisationExtensions;
diff --git a/osu.Game/Screens/Ranking/Expanded/TotalScoreCounter.cs b/osu.Game/Screens/Ranking/Expanded/TotalScoreCounter.cs
index c54bca9e3a..0b06dedc44 100644
--- a/osu.Game/Screens/Ranking/Expanded/TotalScoreCounter.cs
+++ b/osu.Game/Screens/Ranking/Expanded/TotalScoreCounter.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Localisation;
 using osu.Game.Graphics;
diff --git a/osu.Game/Screens/Ranking/PanelState.cs b/osu.Game/Screens/Ranking/PanelState.cs
index 94e2c7cef4..3af74fe0f3 100644
--- a/osu.Game/Screens/Ranking/PanelState.cs
+++ b/osu.Game/Screens/Ranking/PanelState.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.
 
+#nullable disable
+
 namespace osu.Game.Screens.Ranking
 {
     public enum PanelState
diff --git a/osu.Game/Screens/Ranking/ReplayDownloadButton.cs b/osu.Game/Screens/Ranking/ReplayDownloadButton.cs
index 0c9c909395..954a5159b9 100644
--- a/osu.Game/Screens/Ranking/ReplayDownloadButton.cs
+++ b/osu.Game/Screens/Ranking/ReplayDownloadButton.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Screens/Ranking/ResultsScreen.cs b/osu.Game/Screens/Ranking/ResultsScreen.cs
index 98514cd846..2f8868c06d 100644
--- a/osu.Game/Screens/Ranking/ResultsScreen.cs
+++ b/osu.Game/Screens/Ranking/ResultsScreen.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Screens/Ranking/RetryButton.cs b/osu.Game/Screens/Ranking/RetryButton.cs
index 59b69bc949..a0ddc98943 100644
--- a/osu.Game/Screens/Ranking/RetryButton.cs
+++ b/osu.Game/Screens/Ranking/RetryButton.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Shapes;
diff --git a/osu.Game/Screens/Ranking/ScorePanel.cs b/osu.Game/Screens/Ranking/ScorePanel.cs
index bc6eb9e366..babdd4b149 100644
--- a/osu.Game/Screens/Ranking/ScorePanel.cs
+++ b/osu.Game/Screens/Ranking/ScorePanel.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.
 
+#nullable disable
+
 using System;
 using osu.Framework;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Screens/Ranking/ScorePanelList.cs b/osu.Game/Screens/Ranking/ScorePanelList.cs
index a5341242e2..4f9e61a4a1 100644
--- a/osu.Game/Screens/Ranking/ScorePanelList.cs
+++ b/osu.Game/Screens/Ranking/ScorePanelList.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Diagnostics;
diff --git a/osu.Game/Screens/Ranking/ScorePanelTrackingContainer.cs b/osu.Game/Screens/Ranking/ScorePanelTrackingContainer.cs
index c8010d1c32..e55c4530b4 100644
--- a/osu.Game/Screens/Ranking/ScorePanelTrackingContainer.cs
+++ b/osu.Game/Screens/Ranking/ScorePanelTrackingContainer.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Graphics.Containers;
 
diff --git a/osu.Game/Screens/Ranking/SoloResultsScreen.cs b/osu.Game/Screens/Ranking/SoloResultsScreen.cs
index 2ec6c38287..4813cd65db 100644
--- a/osu.Game/Screens/Ranking/SoloResultsScreen.cs
+++ b/osu.Game/Screens/Ranking/SoloResultsScreen.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Screens/Ranking/Statistics/AverageHitError.cs b/osu.Game/Screens/Ranking/Statistics/AverageHitError.cs
index d0e70251e7..a0a9c1c1e2 100644
--- a/osu.Game/Screens/Ranking/Statistics/AverageHitError.cs
+++ b/osu.Game/Screens/Ranking/Statistics/AverageHitError.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using osu.Game.Rulesets.Scoring;
diff --git a/osu.Game/Screens/Ranking/Statistics/HitEventTimingDistributionGraph.cs b/osu.Game/Screens/Ranking/Statistics/HitEventTimingDistributionGraph.cs
index f7c9d36cc4..db69e270f6 100644
--- a/osu.Game/Screens/Ranking/Statistics/HitEventTimingDistributionGraph.cs
+++ b/osu.Game/Screens/Ranking/Statistics/HitEventTimingDistributionGraph.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Screens/Ranking/Statistics/PerformanceBreakdownChart.cs b/osu.Game/Screens/Ranking/Statistics/PerformanceBreakdownChart.cs
index 5b42554716..3462a85e1c 100644
--- a/osu.Game/Screens/Ranking/Statistics/PerformanceBreakdownChart.cs
+++ b/osu.Game/Screens/Ranking/Statistics/PerformanceBreakdownChart.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Screens/Ranking/Statistics/SimpleStatisticItem.cs b/osu.Game/Screens/Ranking/Statistics/SimpleStatisticItem.cs
index 6fe7e4eda8..ecff631c7e 100644
--- a/osu.Game/Screens/Ranking/Statistics/SimpleStatisticItem.cs
+++ b/osu.Game/Screens/Ranking/Statistics/SimpleStatisticItem.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Graphics;
diff --git a/osu.Game/Screens/Ranking/Statistics/SimpleStatisticTable.cs b/osu.Game/Screens/Ranking/Statistics/SimpleStatisticTable.cs
index 8b503cc04e..f1eb16ca80 100644
--- a/osu.Game/Screens/Ranking/Statistics/SimpleStatisticTable.cs
+++ b/osu.Game/Screens/Ranking/Statistics/SimpleStatisticTable.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Screens/Ranking/Statistics/StatisticContainer.cs b/osu.Game/Screens/Ranking/Statistics/StatisticContainer.cs
index 79f813ef64..078ca97737 100644
--- a/osu.Game/Screens/Ranking/Statistics/StatisticContainer.cs
+++ b/osu.Game/Screens/Ranking/Statistics/StatisticContainer.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.
 
+#nullable disable
+
 using System.Diagnostics.CodeAnalysis;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Screens/Ranking/Statistics/StatisticItem.cs b/osu.Game/Screens/Ranking/Statistics/StatisticItem.cs
index b43fbbdeee..0e5cce59f8 100644
--- a/osu.Game/Screens/Ranking/Statistics/StatisticItem.cs
+++ b/osu.Game/Screens/Ranking/Statistics/StatisticItem.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.
 
+#nullable disable
+
 using System;
 using JetBrains.Annotations;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Screens/Ranking/Statistics/StatisticRow.cs b/osu.Game/Screens/Ranking/Statistics/StatisticRow.cs
index e1ca9799a3..9f5f44918e 100644
--- a/osu.Game/Screens/Ranking/Statistics/StatisticRow.cs
+++ b/osu.Game/Screens/Ranking/Statistics/StatisticRow.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.
 
+#nullable disable
+
 using JetBrains.Annotations;
 
 namespace osu.Game.Screens.Ranking.Statistics
diff --git a/osu.Game/Screens/Ranking/Statistics/StatisticsPanel.cs b/osu.Game/Screens/Ranking/Statistics/StatisticsPanel.cs
index 898bd69b2c..384f4c4d4f 100644
--- a/osu.Game/Screens/Ranking/Statistics/StatisticsPanel.cs
+++ b/osu.Game/Screens/Ranking/Statistics/StatisticsPanel.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using System.Threading;
diff --git a/osu.Game/Screens/Ranking/Statistics/UnstableRate.cs b/osu.Game/Screens/Ranking/Statistics/UnstableRate.cs
index 0d23490f40..4ab085fa23 100644
--- a/osu.Game/Screens/Ranking/Statistics/UnstableRate.cs
+++ b/osu.Game/Screens/Ranking/Statistics/UnstableRate.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Game.Rulesets.Scoring;
 
diff --git a/osu.Game/Screens/ScorePresentType.cs b/osu.Game/Screens/ScorePresentType.cs
index 3216f92091..24105467f1 100644
--- a/osu.Game/Screens/ScorePresentType.cs
+++ b/osu.Game/Screens/ScorePresentType.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.
 
+#nullable disable
+
 namespace osu.Game.Screens
 {
     public enum ScorePresentType
diff --git a/osu.Game/Screens/ScreenWhiteBox.cs b/osu.Game/Screens/ScreenWhiteBox.cs
index 3a9e7b8f18..550fda5480 100644
--- a/osu.Game/Screens/ScreenWhiteBox.cs
+++ b/osu.Game/Screens/ScreenWhiteBox.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using osu.Framework.Screens;
diff --git a/osu.Game/Screens/Select/BeatmapCarousel.cs b/osu.Game/Screens/Select/BeatmapCarousel.cs
index e62b285966..87a1fb4ccb 100644
--- a/osu.Game/Screens/Select/BeatmapCarousel.cs
+++ b/osu.Game/Screens/Select/BeatmapCarousel.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Diagnostics;
diff --git a/osu.Game/Screens/Select/BeatmapClearScoresDialog.cs b/osu.Game/Screens/Select/BeatmapClearScoresDialog.cs
index 4a16be4a3a..84426d230b 100644
--- a/osu.Game/Screens/Select/BeatmapClearScoresDialog.cs
+++ b/osu.Game/Screens/Select/BeatmapClearScoresDialog.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.
 
+#nullable disable
+
 using System;
 using System.Threading.Tasks;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Screens/Select/BeatmapDeleteDialog.cs b/osu.Game/Screens/Select/BeatmapDeleteDialog.cs
index b156c2485b..e3b83d5780 100644
--- a/osu.Game/Screens/Select/BeatmapDeleteDialog.cs
+++ b/osu.Game/Screens/Select/BeatmapDeleteDialog.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics.Sprites;
 using osu.Game.Beatmaps;
diff --git a/osu.Game/Screens/Select/BeatmapDetailArea.cs b/osu.Game/Screens/Select/BeatmapDetailArea.cs
index 72c2ba708b..dfcd43189b 100644
--- a/osu.Game/Screens/Select/BeatmapDetailArea.cs
+++ b/osu.Game/Screens/Select/BeatmapDetailArea.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Screens/Select/BeatmapDetailAreaDetailTabItem.cs b/osu.Game/Screens/Select/BeatmapDetailAreaDetailTabItem.cs
index 7376cb4708..d6b076f30b 100644
--- a/osu.Game/Screens/Select/BeatmapDetailAreaDetailTabItem.cs
+++ b/osu.Game/Screens/Select/BeatmapDetailAreaDetailTabItem.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.
 
+#nullable disable
+
 namespace osu.Game.Screens.Select
 {
     public class BeatmapDetailAreaDetailTabItem : BeatmapDetailAreaTabItem
diff --git a/osu.Game/Screens/Select/BeatmapDetailAreaLeaderboardTabItem.cs b/osu.Game/Screens/Select/BeatmapDetailAreaLeaderboardTabItem.cs
index 066944e9d2..6efadc77b3 100644
--- a/osu.Game/Screens/Select/BeatmapDetailAreaLeaderboardTabItem.cs
+++ b/osu.Game/Screens/Select/BeatmapDetailAreaLeaderboardTabItem.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.
 
+#nullable disable
+
 using System;
 
 namespace osu.Game.Screens.Select
diff --git a/osu.Game/Screens/Select/BeatmapDetailAreaTabControl.cs b/osu.Game/Screens/Select/BeatmapDetailAreaTabControl.cs
index 0fd39db97c..3c0d621abe 100644
--- a/osu.Game/Screens/Select/BeatmapDetailAreaTabControl.cs
+++ b/osu.Game/Screens/Select/BeatmapDetailAreaTabControl.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using osuTK.Graphics;
diff --git a/osu.Game/Screens/Select/BeatmapDetailAreaTabItem.cs b/osu.Game/Screens/Select/BeatmapDetailAreaTabItem.cs
index f28e5a7c22..7b7a93d6ee 100644
--- a/osu.Game/Screens/Select/BeatmapDetailAreaTabItem.cs
+++ b/osu.Game/Screens/Select/BeatmapDetailAreaTabItem.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.
 
+#nullable disable
+
 using System;
 
 namespace osu.Game.Screens.Select
diff --git a/osu.Game/Screens/Select/BeatmapDetails.cs b/osu.Game/Screens/Select/BeatmapDetails.cs
index 9ff1574fe4..fdc0d4efdd 100644
--- a/osu.Game/Screens/Select/BeatmapDetails.cs
+++ b/osu.Game/Screens/Select/BeatmapDetails.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.
 
+#nullable disable
+
 using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.Color4Extensions;
diff --git a/osu.Game/Screens/Select/BeatmapInfoWedge.cs b/osu.Game/Screens/Select/BeatmapInfoWedge.cs
index d98238f518..3ee9a11b24 100644
--- a/osu.Game/Screens/Select/BeatmapInfoWedge.cs
+++ b/osu.Game/Screens/Select/BeatmapInfoWedge.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Screens/Select/BeatmapInfoWedgeBackground.cs b/osu.Game/Screens/Select/BeatmapInfoWedgeBackground.cs
index d9b8a20846..68f0c92097 100644
--- a/osu.Game/Screens/Select/BeatmapInfoWedgeBackground.cs
+++ b/osu.Game/Screens/Select/BeatmapInfoWedgeBackground.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.
 
+#nullable disable
+
 using osuTK.Graphics;
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.Color4Extensions;
diff --git a/osu.Game/Screens/Select/Carousel/CarouselBeatmap.cs b/osu.Game/Screens/Select/Carousel/CarouselBeatmap.cs
index c3f6b3ad83..c57cbcfba4 100644
--- a/osu.Game/Screens/Select/Carousel/CarouselBeatmap.cs
+++ b/osu.Game/Screens/Select/Carousel/CarouselBeatmap.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using osu.Game.Beatmaps;
diff --git a/osu.Game/Screens/Select/Carousel/CarouselBeatmapSet.cs b/osu.Game/Screens/Select/Carousel/CarouselBeatmapSet.cs
index fc4b6c27f3..36ec536780 100644
--- a/osu.Game/Screens/Select/Carousel/CarouselBeatmapSet.cs
+++ b/osu.Game/Screens/Select/Carousel/CarouselBeatmapSet.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Screens/Select/Carousel/CarouselGroup.cs b/osu.Game/Screens/Select/Carousel/CarouselGroup.cs
index 6ebe314072..1cd9674b72 100644
--- a/osu.Game/Screens/Select/Carousel/CarouselGroup.cs
+++ b/osu.Game/Screens/Select/Carousel/CarouselGroup.cs
@@ -4,8 +4,6 @@
 using System.Collections.Generic;
 using System.Linq;
 
-#nullable enable
-
 namespace osu.Game.Screens.Select.Carousel
 {
     /// <summary>
diff --git a/osu.Game/Screens/Select/Carousel/CarouselGroupEagerSelect.cs b/osu.Game/Screens/Select/Carousel/CarouselGroupEagerSelect.cs
index aac0e4ed82..4805c7e2a4 100644
--- a/osu.Game/Screens/Select/Carousel/CarouselGroupEagerSelect.cs
+++ b/osu.Game/Screens/Select/Carousel/CarouselGroupEagerSelect.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Screens/Select/Carousel/CarouselHeader.cs b/osu.Game/Screens/Select/Carousel/CarouselHeader.cs
index ed3aea3445..5cde5f7d5a 100644
--- a/osu.Game/Screens/Select/Carousel/CarouselHeader.cs
+++ b/osu.Game/Screens/Select/Carousel/CarouselHeader.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
 using osu.Framework.Audio.Sample;
diff --git a/osu.Game/Screens/Select/Carousel/CarouselItem.cs b/osu.Game/Screens/Select/Carousel/CarouselItem.cs
index 4bd477412d..a901f72dad 100644
--- a/osu.Game/Screens/Select/Carousel/CarouselItem.cs
+++ b/osu.Game/Screens/Select/Carousel/CarouselItem.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Bindables;
 
diff --git a/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmap.cs b/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmap.cs
index 065a29b53c..1bea689e7c 100644
--- a/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmap.cs
+++ b/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmap.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmapSet.cs b/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmapSet.cs
index 80f1231454..fc29f509ad 100644
--- a/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmapSet.cs
+++ b/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmapSet.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Diagnostics;
diff --git a/osu.Game/Screens/Select/Carousel/DrawableCarouselItem.cs b/osu.Game/Screens/Select/Carousel/DrawableCarouselItem.cs
index 75bcdedec4..c92a0ac4ac 100644
--- a/osu.Game/Screens/Select/Carousel/DrawableCarouselItem.cs
+++ b/osu.Game/Screens/Select/Carousel/DrawableCarouselItem.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.
 
+#nullable disable
+
 using System.Diagnostics;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Screens/Select/Carousel/FilterableDifficultyIcon.cs b/osu.Game/Screens/Select/Carousel/FilterableDifficultyIcon.cs
index ce0cec837b..b0841caa47 100644
--- a/osu.Game/Screens/Select/Carousel/FilterableDifficultyIcon.cs
+++ b/osu.Game/Screens/Select/Carousel/FilterableDifficultyIcon.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.
 
+#nullable disable
+
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Input.Events;
diff --git a/osu.Game/Screens/Select/Carousel/FilterableGroupedDifficultyIcon.cs b/osu.Game/Screens/Select/Carousel/FilterableGroupedDifficultyIcon.cs
index acffdd9f64..f883740fd7 100644
--- a/osu.Game/Screens/Select/Carousel/FilterableGroupedDifficultyIcon.cs
+++ b/osu.Game/Screens/Select/Carousel/FilterableGroupedDifficultyIcon.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Screens/Select/Carousel/SetPanelBackground.cs b/osu.Game/Screens/Select/Carousel/SetPanelBackground.cs
index 2a37969be1..2a435e084c 100644
--- a/osu.Game/Screens/Select/Carousel/SetPanelBackground.cs
+++ b/osu.Game/Screens/Select/Carousel/SetPanelBackground.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Colour;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Screens/Select/Carousel/SetPanelContent.cs b/osu.Game/Screens/Select/Carousel/SetPanelContent.cs
index a000cfd5fc..73a835d67f 100644
--- a/osu.Game/Screens/Select/Carousel/SetPanelContent.cs
+++ b/osu.Game/Screens/Select/Carousel/SetPanelContent.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Screens/Select/Carousel/TopLocalRank.cs b/osu.Game/Screens/Select/Carousel/TopLocalRank.cs
index e1f9c1b508..a948e5b0bd 100644
--- a/osu.Game/Screens/Select/Carousel/TopLocalRank.cs
+++ b/osu.Game/Screens/Select/Carousel/TopLocalRank.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Screens/Select/Details/AdvancedStats.cs b/osu.Game/Screens/Select/Details/AdvancedStats.cs
index a6f2520472..59eb3fa607 100644
--- a/osu.Game/Screens/Select/Details/AdvancedStats.cs
+++ b/osu.Game/Screens/Select/Details/AdvancedStats.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.
 
+#nullable disable
+
 using osuTK.Graphics;
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.Color4Extensions;
diff --git a/osu.Game/Screens/Select/Details/FailRetryGraph.cs b/osu.Game/Screens/Select/Details/FailRetryGraph.cs
index 312c55b242..6fa6d50217 100644
--- a/osu.Game/Screens/Select/Details/FailRetryGraph.cs
+++ b/osu.Game/Screens/Select/Details/FailRetryGraph.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Screens/Select/Details/UserRatings.cs b/osu.Game/Screens/Select/Details/UserRatings.cs
index c2be3528fc..39cb9c3d15 100644
--- a/osu.Game/Screens/Select/Details/UserRatings.cs
+++ b/osu.Game/Screens/Select/Details/UserRatings.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.
 
+#nullable disable
+
 using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.LocalisationExtensions;
diff --git a/osu.Game/Screens/Select/Filter/GroupMode.cs b/osu.Game/Screens/Select/Filter/GroupMode.cs
index d794c215a3..8e2b9271b0 100644
--- a/osu.Game/Screens/Select/Filter/GroupMode.cs
+++ b/osu.Game/Screens/Select/Filter/GroupMode.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.
 
+#nullable disable
+
 using System.ComponentModel;
 
 namespace osu.Game.Screens.Select.Filter
diff --git a/osu.Game/Screens/Select/Filter/Operator.cs b/osu.Game/Screens/Select/Filter/Operator.cs
index 706daf631f..a6a53f0c3e 100644
--- a/osu.Game/Screens/Select/Filter/Operator.cs
+++ b/osu.Game/Screens/Select/Filter/Operator.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.
 
+#nullable disable
+
 namespace osu.Game.Screens.Select.Filter
 {
     /// <summary>
diff --git a/osu.Game/Screens/Select/Filter/SortMode.cs b/osu.Game/Screens/Select/Filter/SortMode.cs
index 3dd3381059..48f774393e 100644
--- a/osu.Game/Screens/Select/Filter/SortMode.cs
+++ b/osu.Game/Screens/Select/Filter/SortMode.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.
 
+#nullable disable
+
 using System.ComponentModel;
 using osu.Framework.Localisation;
 using osu.Game.Resources.Localisation.Web;
diff --git a/osu.Game/Screens/Select/FilterControl.cs b/osu.Game/Screens/Select/FilterControl.cs
index 65dde146bb..da764223a3 100644
--- a/osu.Game/Screens/Select/FilterControl.cs
+++ b/osu.Game/Screens/Select/FilterControl.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Screens/Select/FilterCriteria.cs b/osu.Game/Screens/Select/FilterCriteria.cs
index 1f6e99f0c6..c7e6e8496a 100644
--- a/osu.Game/Screens/Select/FilterCriteria.cs
+++ b/osu.Game/Screens/Select/FilterCriteria.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Screens/Select/FilterQueryParser.cs b/osu.Game/Screens/Select/FilterQueryParser.cs
index 94df8addb3..92f707ae3e 100644
--- a/osu.Game/Screens/Select/FilterQueryParser.cs
+++ b/osu.Game/Screens/Select/FilterQueryParser.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.
 
+#nullable disable
+
 using System;
 using System.Globalization;
 using System.Linq;
diff --git a/osu.Game/Screens/Select/Footer.cs b/osu.Game/Screens/Select/Footer.cs
index ee13ebda44..86fe76c0c6 100644
--- a/osu.Game/Screens/Select/Footer.cs
+++ b/osu.Game/Screens/Select/Footer.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using osuTK;
diff --git a/osu.Game/Screens/Select/FooterButton.cs b/osu.Game/Screens/Select/FooterButton.cs
index 1587f43258..c251e94ef2 100644
--- a/osu.Game/Screens/Select/FooterButton.cs
+++ b/osu.Game/Screens/Select/FooterButton.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.
 
+#nullable disable
+
 using System;
 using osuTK;
 using osuTK.Graphics;
diff --git a/osu.Game/Screens/Select/FooterButtonMods.cs b/osu.Game/Screens/Select/FooterButtonMods.cs
index 5bbca5ca1a..2732b5baa8 100644
--- a/osu.Game/Screens/Select/FooterButtonMods.cs
+++ b/osu.Game/Screens/Select/FooterButtonMods.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.
 
+#nullable disable
+
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Game.Screens.Play.HUD;
diff --git a/osu.Game/Screens/Select/FooterButtonOptions.cs b/osu.Game/Screens/Select/FooterButtonOptions.cs
index e549656785..764f56e79c 100644
--- a/osu.Game/Screens/Select/FooterButtonOptions.cs
+++ b/osu.Game/Screens/Select/FooterButtonOptions.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Game.Graphics;
diff --git a/osu.Game/Screens/Select/FooterButtonRandom.cs b/osu.Game/Screens/Select/FooterButtonRandom.cs
index f855b80f75..1f56915f62 100644
--- a/osu.Game/Screens/Select/FooterButtonRandom.cs
+++ b/osu.Game/Screens/Select/FooterButtonRandom.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.Color4Extensions;
diff --git a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
index 8d1654eb1d..f1f11518ee 100644
--- a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.cs
+++ b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboard.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboardScope.cs b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboardScope.cs
index 5bcb4c27a7..b8840b124a 100644
--- a/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboardScope.cs
+++ b/osu.Game/Screens/Select/Leaderboards/BeatmapLeaderboardScope.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.
 
+#nullable disable
+
 using System.ComponentModel;
 using osu.Framework.Localisation;
 using osu.Game.Resources.Localisation.Web;
diff --git a/osu.Game/Screens/Select/LocalScoreDeleteDialog.cs b/osu.Game/Screens/Select/LocalScoreDeleteDialog.cs
index cb96e3f23e..3c05a1fa5a 100644
--- a/osu.Game/Screens/Select/LocalScoreDeleteDialog.cs
+++ b/osu.Game/Screens/Select/LocalScoreDeleteDialog.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Game.Overlays.Dialog;
 using osu.Game.Scoring;
diff --git a/osu.Game/Screens/Select/NoResultsPlaceholder.cs b/osu.Game/Screens/Select/NoResultsPlaceholder.cs
index 28a0541a22..e1a8e3e060 100644
--- a/osu.Game/Screens/Select/NoResultsPlaceholder.cs
+++ b/osu.Game/Screens/Select/NoResultsPlaceholder.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 enable
-
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Screens/Select/Options/BeatmapOptionsButton.cs b/osu.Game/Screens/Select/Options/BeatmapOptionsButton.cs
index df7dd47ef3..69800c4e86 100644
--- a/osu.Game/Screens/Select/Options/BeatmapOptionsButton.cs
+++ b/osu.Game/Screens/Select/Options/BeatmapOptionsButton.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.
 
+#nullable disable
+
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Screens/Select/Options/BeatmapOptionsOverlay.cs b/osu.Game/Screens/Select/Options/BeatmapOptionsOverlay.cs
index 1a8b69d859..8785dac0aa 100644
--- a/osu.Game/Screens/Select/Options/BeatmapOptionsOverlay.cs
+++ b/osu.Game/Screens/Select/Options/BeatmapOptionsOverlay.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Screens/Select/PlayBeatmapDetailArea.cs b/osu.Game/Screens/Select/PlayBeatmapDetailArea.cs
index 09f75b7658..4d3c844753 100644
--- a/osu.Game/Screens/Select/PlayBeatmapDetailArea.cs
+++ b/osu.Game/Screens/Select/PlayBeatmapDetailArea.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Screens/Select/PlaySongSelect.cs b/osu.Game/Screens/Select/PlaySongSelect.cs
index ec8b2e029a..c24ca9a7cf 100644
--- a/osu.Game/Screens/Select/PlaySongSelect.cs
+++ b/osu.Game/Screens/Select/PlaySongSelect.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Screens/Select/SkinDeleteDialog.cs b/osu.Game/Screens/Select/SkinDeleteDialog.cs
index 4262118658..8defd6347a 100644
--- a/osu.Game/Screens/Select/SkinDeleteDialog.cs
+++ b/osu.Game/Screens/Select/SkinDeleteDialog.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics.Sprites;
 using osu.Game.Skinning;
diff --git a/osu.Game/Screens/Select/SongSelect.cs b/osu.Game/Screens/Select/SongSelect.cs
index 3bfdc845ab..a17e7823a6 100644
--- a/osu.Game/Screens/Select/SongSelect.cs
+++ b/osu.Game/Screens/Select/SongSelect.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
 using osu.Framework.Audio.Sample;
diff --git a/osu.Game/Screens/Select/WedgeBackground.cs b/osu.Game/Screens/Select/WedgeBackground.cs
index f1337a8119..4a5b9d8911 100644
--- a/osu.Game/Screens/Select/WedgeBackground.cs
+++ b/osu.Game/Screens/Select/WedgeBackground.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.
 
+#nullable disable
+
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Screens/Spectate/SpectatorGameplayState.cs b/osu.Game/Screens/Spectate/SpectatorGameplayState.cs
index 6ca1ac9a0a..498363adef 100644
--- a/osu.Game/Screens/Spectate/SpectatorGameplayState.cs
+++ b/osu.Game/Screens/Spectate/SpectatorGameplayState.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.
 
+#nullable disable
+
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets;
 using osu.Game.Scoring;
diff --git a/osu.Game/Screens/Spectate/SpectatorScreen.cs b/osu.Game/Screens/Spectate/SpectatorScreen.cs
index 9eb374f0f7..0c1fe56eb6 100644
--- a/osu.Game/Screens/Spectate/SpectatorScreen.cs
+++ b/osu.Game/Screens/Spectate/SpectatorScreen.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Diagnostics;
diff --git a/osu.Game/Screens/StartupScreen.cs b/osu.Game/Screens/StartupScreen.cs
index be217d6b1f..89761d80de 100644
--- a/osu.Game/Screens/StartupScreen.cs
+++ b/osu.Game/Screens/StartupScreen.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.
 
+#nullable disable
+
 using osu.Game.Overlays;
 
 namespace osu.Game.Screens
diff --git a/osu.Game/Screens/Utility/ButtonWithKeyBind.cs b/osu.Game/Screens/Utility/ButtonWithKeyBind.cs
index ef87e0bca7..7df9a22ce4 100644
--- a/osu.Game/Screens/Utility/ButtonWithKeyBind.cs
+++ b/osu.Game/Screens/Utility/ButtonWithKeyBind.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.
 
-#nullable enable
 using osu.Framework.Allocation;
 using osu.Framework.Input.Events;
 using osu.Framework.Localisation;
diff --git a/osu.Game/Screens/Utility/CircleGameplay.cs b/osu.Game/Screens/Utility/CircleGameplay.cs
index dd59721a65..1ee5567c43 100644
--- a/osu.Game/Screens/Utility/CircleGameplay.cs
+++ b/osu.Game/Screens/Utility/CircleGameplay.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 enable
-
 using System;
 using System.Collections.Generic;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Screens/Utility/LatencyArea.cs b/osu.Game/Screens/Utility/LatencyArea.cs
index 21688f0b0c..61a97d92b0 100644
--- a/osu.Game/Screens/Utility/LatencyArea.cs
+++ b/osu.Game/Screens/Utility/LatencyArea.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 enable
-
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Screens/Utility/LatencyCertifierScreen.cs b/osu.Game/Screens/Utility/LatencyCertifierScreen.cs
index 8210e6825a..8675078a5e 100644
--- a/osu.Game/Screens/Utility/LatencyCertifierScreen.cs
+++ b/osu.Game/Screens/Utility/LatencyCertifierScreen.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 enable
-
 using System;
 using System.Diagnostics;
 using System.Linq;
diff --git a/osu.Game/Screens/Utility/LatencyVisualMode.cs b/osu.Game/Screens/Utility/LatencyVisualMode.cs
index cc15f79be8..c4022d09b2 100644
--- a/osu.Game/Screens/Utility/LatencyVisualMode.cs
+++ b/osu.Game/Screens/Utility/LatencyVisualMode.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.
 
-#nullable enable
 namespace osu.Game.Screens.Utility
 {
     public enum LatencyVisualMode
diff --git a/osu.Game/Screens/Utility/SampleComponents/LatencyCursorContainer.cs b/osu.Game/Screens/Utility/SampleComponents/LatencyCursorContainer.cs
index e4c2b504cb..40911684f8 100644
--- a/osu.Game/Screens/Utility/SampleComponents/LatencyCursorContainer.cs
+++ b/osu.Game/Screens/Utility/SampleComponents/LatencyCursorContainer.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.
 
-#nullable enable
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Shapes;
diff --git a/osu.Game/Screens/Utility/SampleComponents/LatencyMovableBox.cs b/osu.Game/Screens/Utility/SampleComponents/LatencyMovableBox.cs
index a7da05fbb1..8b6841caf0 100644
--- a/osu.Game/Screens/Utility/SampleComponents/LatencyMovableBox.cs
+++ b/osu.Game/Screens/Utility/SampleComponents/LatencyMovableBox.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 enable
-
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Input.Events;
diff --git a/osu.Game/Screens/Utility/SampleComponents/LatencySampleComponent.cs b/osu.Game/Screens/Utility/SampleComponents/LatencySampleComponent.cs
index c3233d5aa5..834865d237 100644
--- a/osu.Game/Screens/Utility/SampleComponents/LatencySampleComponent.cs
+++ b/osu.Game/Screens/Utility/SampleComponents/LatencySampleComponent.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 enable
-
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Screens/Utility/ScrollingGameplay.cs b/osu.Game/Screens/Utility/ScrollingGameplay.cs
index a32fd3b37f..1f40514cd5 100644
--- a/osu.Game/Screens/Utility/ScrollingGameplay.cs
+++ b/osu.Game/Screens/Utility/ScrollingGameplay.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.
 
-#nullable enable
 using System;
 using System.Collections.Generic;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Skinning/BeatmapSkinProvidingContainer.cs b/osu.Game/Skinning/BeatmapSkinProvidingContainer.cs
index 2ba301deed..abc7b61036 100644
--- a/osu.Game/Skinning/BeatmapSkinProvidingContainer.cs
+++ b/osu.Game/Skinning/BeatmapSkinProvidingContainer.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Skinning/Components/BigBlackBox.cs b/osu.Game/Skinning/Components/BigBlackBox.cs
index 373e6467e8..5bdee827ca 100644
--- a/osu.Game/Skinning/Components/BigBlackBox.cs
+++ b/osu.Game/Skinning/Components/BigBlackBox.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.
 
+#nullable disable
+
 using JetBrains.Annotations;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Skinning/DefaultLegacySkin.cs b/osu.Game/Skinning/DefaultLegacySkin.cs
index f7b415e886..2ebcc98c53 100644
--- a/osu.Game/Skinning/DefaultLegacySkin.cs
+++ b/osu.Game/Skinning/DefaultLegacySkin.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using JetBrains.Annotations;
 using osu.Framework.IO.Stores;
diff --git a/osu.Game/Skinning/DefaultSkin.cs b/osu.Game/Skinning/DefaultSkin.cs
index fb24084659..43b3cb0aa4 100644
--- a/osu.Game/Skinning/DefaultSkin.cs
+++ b/osu.Game/Skinning/DefaultSkin.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using JetBrains.Annotations;
diff --git a/osu.Game/Skinning/EFSkinInfo.cs b/osu.Game/Skinning/EFSkinInfo.cs
index 50588563be..4204364c50 100644
--- a/osu.Game/Skinning/EFSkinInfo.cs
+++ b/osu.Game/Skinning/EFSkinInfo.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.ComponentModel.DataAnnotations.Schema;
diff --git a/osu.Game/Skinning/Editor/SkinBlueprint.cs b/osu.Game/Skinning/Editor/SkinBlueprint.cs
index 1860c6006c..ecf1de89da 100644
--- a/osu.Game/Skinning/Editor/SkinBlueprint.cs
+++ b/osu.Game/Skinning/Editor/SkinBlueprint.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.Color4Extensions;
diff --git a/osu.Game/Skinning/Editor/SkinBlueprintContainer.cs b/osu.Game/Skinning/Editor/SkinBlueprintContainer.cs
index ebf3c9c319..46f5c1e67f 100644
--- a/osu.Game/Skinning/Editor/SkinBlueprintContainer.cs
+++ b/osu.Game/Skinning/Editor/SkinBlueprintContainer.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Collections.Specialized;
 using System.Linq;
diff --git a/osu.Game/Skinning/Editor/SkinComponentToolbox.cs b/osu.Game/Skinning/Editor/SkinComponentToolbox.cs
index 756f229927..7de9cd5108 100644
--- a/osu.Game/Skinning/Editor/SkinComponentToolbox.cs
+++ b/osu.Game/Skinning/Editor/SkinComponentToolbox.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.
 
+#nullable disable
+
 using System;
 using System.Diagnostics;
 using System.Linq;
diff --git a/osu.Game/Skinning/Editor/SkinEditor.cs b/osu.Game/Skinning/Editor/SkinEditor.cs
index 095763de18..f41cd63f2d 100644
--- a/osu.Game/Skinning/Editor/SkinEditor.cs
+++ b/osu.Game/Skinning/Editor/SkinEditor.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.IO;
diff --git a/osu.Game/Skinning/Editor/SkinEditorOverlay.cs b/osu.Game/Skinning/Editor/SkinEditorOverlay.cs
index a3110ced24..de33d49941 100644
--- a/osu.Game/Skinning/Editor/SkinEditorOverlay.cs
+++ b/osu.Game/Skinning/Editor/SkinEditorOverlay.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.
 
+#nullable disable
+
 using System.Diagnostics;
 using JetBrains.Annotations;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Skinning/Editor/SkinEditorSceneLibrary.cs b/osu.Game/Skinning/Editor/SkinEditorSceneLibrary.cs
index dc5a8aefc0..4efbf58881 100644
--- a/osu.Game/Skinning/Editor/SkinEditorSceneLibrary.cs
+++ b/osu.Game/Skinning/Editor/SkinEditorSceneLibrary.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using JetBrains.Annotations;
diff --git a/osu.Game/Skinning/Editor/SkinSelectionHandler.cs b/osu.Game/Skinning/Editor/SkinSelectionHandler.cs
index 943425e099..2e2122f7c2 100644
--- a/osu.Game/Skinning/Editor/SkinSelectionHandler.cs
+++ b/osu.Game/Skinning/Editor/SkinSelectionHandler.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Skinning/Editor/SkinSettingsToolbox.cs b/osu.Game/Skinning/Editor/SkinSettingsToolbox.cs
index d2823ed0e4..3e19fc3afe 100644
--- a/osu.Game/Skinning/Editor/SkinSettingsToolbox.cs
+++ b/osu.Game/Skinning/Editor/SkinSettingsToolbox.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.
 
+#nullable disable
+
 using System.Linq;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Skinning/GameplaySkinComponent.cs b/osu.Game/Skinning/GameplaySkinComponent.cs
index 80f6efc07a..cdd3638375 100644
--- a/osu.Game/Skinning/GameplaySkinComponent.cs
+++ b/osu.Game/Skinning/GameplaySkinComponent.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.
 
+#nullable disable
+
 using System.Linq;
 
 namespace osu.Game.Skinning
diff --git a/osu.Game/Skinning/GlobalSkinColours.cs b/osu.Game/Skinning/GlobalSkinColours.cs
index f889371b98..e2b5799048 100644
--- a/osu.Game/Skinning/GlobalSkinColours.cs
+++ b/osu.Game/Skinning/GlobalSkinColours.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.
 
+#nullable disable
+
 namespace osu.Game.Skinning
 {
     public enum GlobalSkinColours
diff --git a/osu.Game/Skinning/HUDSkinComponents.cs b/osu.Game/Skinning/HUDSkinComponents.cs
index ea39c98635..586882d790 100644
--- a/osu.Game/Skinning/HUDSkinComponents.cs
+++ b/osu.Game/Skinning/HUDSkinComponents.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.
 
+#nullable disable
+
 namespace osu.Game.Skinning
 {
     public enum HUDSkinComponents
diff --git a/osu.Game/Skinning/IAnimationTimeReference.cs b/osu.Game/Skinning/IAnimationTimeReference.cs
index f627379a57..dcb9e9bbb9 100644
--- a/osu.Game/Skinning/IAnimationTimeReference.cs
+++ b/osu.Game/Skinning/IAnimationTimeReference.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics.OpenGL.Textures;
diff --git a/osu.Game/Skinning/IPooledSampleProvider.cs b/osu.Game/Skinning/IPooledSampleProvider.cs
index 40193d1a1a..46cd824e95 100644
--- a/osu.Game/Skinning/IPooledSampleProvider.cs
+++ b/osu.Game/Skinning/IPooledSampleProvider.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.
 
+#nullable disable
+
 using JetBrains.Annotations;
 using osu.Game.Audio;
 
diff --git a/osu.Game/Skinning/ISkin.cs b/osu.Game/Skinning/ISkin.cs
index 414a316dec..431fc1c0b8 100644
--- a/osu.Game/Skinning/ISkin.cs
+++ b/osu.Game/Skinning/ISkin.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 enable
-
 using osu.Framework.Audio.Sample;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Skinning/ISkinComponent.cs b/osu.Game/Skinning/ISkinComponent.cs
index 4bd9f21b6b..34922b98b6 100644
--- a/osu.Game/Skinning/ISkinComponent.cs
+++ b/osu.Game/Skinning/ISkinComponent.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.
 
+#nullable disable
+
 namespace osu.Game.Skinning
 {
     public interface ISkinComponent
diff --git a/osu.Game/Skinning/ISkinSource.cs b/osu.Game/Skinning/ISkinSource.cs
index a5ed0fc990..94940fd549 100644
--- a/osu.Game/Skinning/ISkinSource.cs
+++ b/osu.Game/Skinning/ISkinSource.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using JetBrains.Annotations;
diff --git a/osu.Game/Skinning/ISkinnableDrawable.cs b/osu.Game/Skinning/ISkinnableDrawable.cs
index 3fc6a2fdd8..ca643af17a 100644
--- a/osu.Game/Skinning/ISkinnableDrawable.cs
+++ b/osu.Game/Skinning/ISkinnableDrawable.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Bindables;
 using osu.Framework.Extensions.TypeExtensions;
diff --git a/osu.Game/Skinning/ISkinnableTarget.cs b/osu.Game/Skinning/ISkinnableTarget.cs
index 8d4f4dd0c3..17279ef178 100644
--- a/osu.Game/Skinning/ISkinnableTarget.cs
+++ b/osu.Game/Skinning/ISkinnableTarget.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Skinning/LegacyAccuracyCounter.cs b/osu.Game/Skinning/LegacyAccuracyCounter.cs
index bdcb85456a..ffb463faae 100644
--- a/osu.Game/Skinning/LegacyAccuracyCounter.cs
+++ b/osu.Game/Skinning/LegacyAccuracyCounter.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Screens.Play.HUD;
diff --git a/osu.Game/Skinning/LegacyBeatmapSkin.cs b/osu.Game/Skinning/LegacyBeatmapSkin.cs
index 70f5b35d00..43ae0a2252 100644
--- a/osu.Game/Skinning/LegacyBeatmapSkin.cs
+++ b/osu.Game/Skinning/LegacyBeatmapSkin.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 enable
-
 using osu.Framework.Audio.Sample;
 using osu.Framework.Bindables;
 using osu.Framework.Extensions.ObjectExtensions;
diff --git a/osu.Game/Skinning/LegacyColourCompatibility.cs b/osu.Game/Skinning/LegacyColourCompatibility.cs
index 38e43432ce..0673d0a8d3 100644
--- a/osu.Game/Skinning/LegacyColourCompatibility.cs
+++ b/osu.Game/Skinning/LegacyColourCompatibility.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osuTK.Graphics;
 
diff --git a/osu.Game/Skinning/LegacyFont.cs b/osu.Game/Skinning/LegacyFont.cs
index d1971cb84c..f738caf3f3 100644
--- a/osu.Game/Skinning/LegacyFont.cs
+++ b/osu.Game/Skinning/LegacyFont.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.
 
+#nullable disable
+
 namespace osu.Game.Skinning
 {
     /// <summary>
diff --git a/osu.Game/Skinning/LegacyHealthDisplay.cs b/osu.Game/Skinning/LegacyHealthDisplay.cs
index b1cd1f86c0..236e9c355e 100644
--- a/osu.Game/Skinning/LegacyHealthDisplay.cs
+++ b/osu.Game/Skinning/LegacyHealthDisplay.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Skinning/LegacyJudgementPieceNew.cs b/osu.Game/Skinning/LegacyJudgementPieceNew.cs
index e76f251ce5..b87fc9acb5 100644
--- a/osu.Game/Skinning/LegacyJudgementPieceNew.cs
+++ b/osu.Game/Skinning/LegacyJudgementPieceNew.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Animations;
diff --git a/osu.Game/Skinning/LegacyJudgementPieceOld.cs b/osu.Game/Skinning/LegacyJudgementPieceOld.cs
index 5d74ab9ae3..c47f46ed2b 100644
--- a/osu.Game/Skinning/LegacyJudgementPieceOld.cs
+++ b/osu.Game/Skinning/LegacyJudgementPieceOld.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Animations;
diff --git a/osu.Game/Skinning/LegacyManiaSkinConfiguration.cs b/osu.Game/Skinning/LegacyManiaSkinConfiguration.cs
index 77d390875b..5ed2ddc73c 100644
--- a/osu.Game/Skinning/LegacyManiaSkinConfiguration.cs
+++ b/osu.Game/Skinning/LegacyManiaSkinConfiguration.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Skinning/LegacyManiaSkinConfigurationLookup.cs b/osu.Game/Skinning/LegacyManiaSkinConfigurationLookup.cs
index 9db6c8bf66..45454be4a5 100644
--- a/osu.Game/Skinning/LegacyManiaSkinConfigurationLookup.cs
+++ b/osu.Game/Skinning/LegacyManiaSkinConfigurationLookup.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.
 
+#nullable disable
+
 namespace osu.Game.Skinning
 {
     public class LegacyManiaSkinConfigurationLookup
diff --git a/osu.Game/Skinning/LegacyManiaSkinDecoder.cs b/osu.Game/Skinning/LegacyManiaSkinDecoder.cs
index 7214c847a7..2aaf0ba18e 100644
--- a/osu.Game/Skinning/LegacyManiaSkinDecoder.cs
+++ b/osu.Game/Skinning/LegacyManiaSkinDecoder.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Diagnostics;
diff --git a/osu.Game/Skinning/LegacyRollingCounter.cs b/osu.Game/Skinning/LegacyRollingCounter.cs
index b531ae1e6f..fd17b06a21 100644
--- a/osu.Game/Skinning/LegacyRollingCounter.cs
+++ b/osu.Game/Skinning/LegacyRollingCounter.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.
 
+#nullable disable
+
 using System;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.UserInterface;
diff --git a/osu.Game/Skinning/LegacyScoreCounter.cs b/osu.Game/Skinning/LegacyScoreCounter.cs
index 0c9a82074f..aee594454f 100644
--- a/osu.Game/Skinning/LegacyScoreCounter.cs
+++ b/osu.Game/Skinning/LegacyScoreCounter.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Screens.Play.HUD;
diff --git a/osu.Game/Skinning/LegacySkin.cs b/osu.Game/Skinning/LegacySkin.cs
index 9524d3f615..34219722a1 100644
--- a/osu.Game/Skinning/LegacySkin.cs
+++ b/osu.Game/Skinning/LegacySkin.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 enable
-
 using System;
 using System.Collections.Generic;
 using System.Diagnostics;
diff --git a/osu.Game/Skinning/LegacySkinDecoder.cs b/osu.Game/Skinning/LegacySkinDecoder.cs
index aac343d710..e5f87b3230 100644
--- a/osu.Game/Skinning/LegacySkinDecoder.cs
+++ b/osu.Game/Skinning/LegacySkinDecoder.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.
 
+#nullable disable
+
 using System.Globalization;
 using osu.Game.Beatmaps.Formats;
 
diff --git a/osu.Game/Skinning/LegacySkinExtensions.cs b/osu.Game/Skinning/LegacySkinExtensions.cs
index 514a06a4ee..5a537dd57d 100644
--- a/osu.Game/Skinning/LegacySkinExtensions.cs
+++ b/osu.Game/Skinning/LegacySkinExtensions.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 enable
-
 using System;
 using System.Collections.Generic;
 using System.Diagnostics;
diff --git a/osu.Game/Skinning/LegacySkinTransformer.cs b/osu.Game/Skinning/LegacySkinTransformer.cs
index 34714b9dc5..da7da759fc 100644
--- a/osu.Game/Skinning/LegacySkinTransformer.cs
+++ b/osu.Game/Skinning/LegacySkinTransformer.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.
 
+#nullable disable
+
 using System;
 using JetBrains.Annotations;
 using osu.Framework.Audio.Sample;
diff --git a/osu.Game/Skinning/LegacySpriteText.cs b/osu.Game/Skinning/LegacySpriteText.cs
index 94383834fc..c5d65cb0c7 100644
--- a/osu.Game/Skinning/LegacySpriteText.cs
+++ b/osu.Game/Skinning/LegacySpriteText.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.
 
+#nullable disable
+
 using System.Threading.Tasks;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics.Sprites;
diff --git a/osu.Game/Skinning/PausableSkinnableSound.cs b/osu.Game/Skinning/PausableSkinnableSound.cs
index b34351d4e7..ebcaeaa3ff 100644
--- a/osu.Game/Skinning/PausableSkinnableSound.cs
+++ b/osu.Game/Skinning/PausableSkinnableSound.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using JetBrains.Annotations;
diff --git a/osu.Game/Skinning/PoolableSkinnableSample.cs b/osu.Game/Skinning/PoolableSkinnableSample.cs
index 5db4f00b46..49bc71064c 100644
--- a/osu.Game/Skinning/PoolableSkinnableSample.cs
+++ b/osu.Game/Skinning/PoolableSkinnableSample.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using JetBrains.Annotations;
diff --git a/osu.Game/Skinning/RealmBackedResourceStore.cs b/osu.Game/Skinning/RealmBackedResourceStore.cs
index 7fa24284ee..0cc90f1dcb 100644
--- a/osu.Game/Skinning/RealmBackedResourceStore.cs
+++ b/osu.Game/Skinning/RealmBackedResourceStore.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 enable
-
 using System;
 using System.Collections.Generic;
 using System.Diagnostics;
diff --git a/osu.Game/Skinning/ResourceStoreBackedSkin.cs b/osu.Game/Skinning/ResourceStoreBackedSkin.cs
index 48286bff59..597eef99d4 100644
--- a/osu.Game/Skinning/ResourceStoreBackedSkin.cs
+++ b/osu.Game/Skinning/ResourceStoreBackedSkin.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 enable
-
 using System;
 using osu.Framework.Audio;
 using osu.Framework.Audio.Sample;
diff --git a/osu.Game/Skinning/RulesetSkinProvidingContainer.cs b/osu.Game/Skinning/RulesetSkinProvidingContainer.cs
index b884794739..937cf20bc6 100644
--- a/osu.Game/Skinning/RulesetSkinProvidingContainer.cs
+++ b/osu.Game/Skinning/RulesetSkinProvidingContainer.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Diagnostics;
 using System.Linq;
diff --git a/osu.Game/Skinning/Skin.cs b/osu.Game/Skinning/Skin.cs
index b9f9d3bd10..d6aa9cdaad 100644
--- a/osu.Game/Skinning/Skin.cs
+++ b/osu.Game/Skinning/Skin.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 enable
-
 using System;
 using System.Collections.Generic;
 using System.Diagnostics;
diff --git a/osu.Game/Skinning/SkinComboColourLookup.cs b/osu.Game/Skinning/SkinComboColourLookup.cs
index 33e35a96fb..2eb4af6289 100644
--- a/osu.Game/Skinning/SkinComboColourLookup.cs
+++ b/osu.Game/Skinning/SkinComboColourLookup.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.
 
+#nullable disable
+
 using osu.Game.Rulesets.Objects.Types;
 
 namespace osu.Game.Skinning
diff --git a/osu.Game/Skinning/SkinConfigManager.cs b/osu.Game/Skinning/SkinConfigManager.cs
index 682138a2e9..8a34ab3db4 100644
--- a/osu.Game/Skinning/SkinConfigManager.cs
+++ b/osu.Game/Skinning/SkinConfigManager.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Configuration;
 
diff --git a/osu.Game/Skinning/SkinConfiguration.cs b/osu.Game/Skinning/SkinConfiguration.cs
index f71f6811e8..0b1159f8fd 100644
--- a/osu.Game/Skinning/SkinConfiguration.cs
+++ b/osu.Game/Skinning/SkinConfiguration.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Game.Beatmaps.Formats;
 using osuTK.Graphics;
diff --git a/osu.Game/Skinning/SkinCustomColourLookup.cs b/osu.Game/Skinning/SkinCustomColourLookup.cs
index b8e5ac9b53..319b071bf5 100644
--- a/osu.Game/Skinning/SkinCustomColourLookup.cs
+++ b/osu.Game/Skinning/SkinCustomColourLookup.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.
 
+#nullable disable
+
 namespace osu.Game.Skinning
 {
     public class SkinCustomColourLookup
diff --git a/osu.Game/Skinning/SkinFileInfo.cs b/osu.Game/Skinning/SkinFileInfo.cs
index 4f1bf68e51..f3243d3f24 100644
--- a/osu.Game/Skinning/SkinFileInfo.cs
+++ b/osu.Game/Skinning/SkinFileInfo.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.
 
+#nullable disable
+
 using System.ComponentModel.DataAnnotations;
 using osu.Game.Database;
 using osu.Game.IO;
diff --git a/osu.Game/Skinning/SkinImporter.cs b/osu.Game/Skinning/SkinImporter.cs
index 7b82655dca..1b5de9abb5 100644
--- a/osu.Game/Skinning/SkinImporter.cs
+++ b/osu.Game/Skinning/SkinImporter.cs
@@ -16,8 +16,6 @@ using osu.Game.IO;
 using osu.Game.IO.Archives;
 using Realms;
 
-#nullable enable
-
 namespace osu.Game.Skinning
 {
     public class SkinImporter : RealmArchiveModelImporter<SkinInfo>
diff --git a/osu.Game/Skinning/SkinInfo.cs b/osu.Game/Skinning/SkinInfo.cs
index a89725e466..bf3cf77257 100644
--- a/osu.Game/Skinning/SkinInfo.cs
+++ b/osu.Game/Skinning/SkinInfo.cs
@@ -12,8 +12,6 @@ using osu.Game.IO;
 using osu.Game.Models;
 using Realms;
 
-#nullable enable
-
 namespace osu.Game.Skinning
 {
     [ExcludeFromDynamicCompile]
diff --git a/osu.Game/Skinning/SkinManager.cs b/osu.Game/Skinning/SkinManager.cs
index 813ed3e066..be6528db3f 100644
--- a/osu.Game/Skinning/SkinManager.cs
+++ b/osu.Game/Skinning/SkinManager.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Skinning/SkinProvidingContainer.cs b/osu.Game/Skinning/SkinProvidingContainer.cs
index 24198254a3..d7399b0141 100644
--- a/osu.Game/Skinning/SkinProvidingContainer.cs
+++ b/osu.Game/Skinning/SkinProvidingContainer.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Skinning/SkinReloadableDrawable.cs b/osu.Game/Skinning/SkinReloadableDrawable.cs
index dec546b82d..c6332fc4d2 100644
--- a/osu.Game/Skinning/SkinReloadableDrawable.cs
+++ b/osu.Game/Skinning/SkinReloadableDrawable.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics.Pooling;
diff --git a/osu.Game/Skinning/SkinUtils.cs b/osu.Game/Skinning/SkinUtils.cs
index e3bc5e28b8..8e01bd2853 100644
--- a/osu.Game/Skinning/SkinUtils.cs
+++ b/osu.Game/Skinning/SkinUtils.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.
 
+#nullable disable
+
 using osu.Framework.Bindables;
 
 namespace osu.Game.Skinning
diff --git a/osu.Game/Skinning/SkinnableDrawable.cs b/osu.Game/Skinning/SkinnableDrawable.cs
index 45409694b5..480d66c557 100644
--- a/osu.Game/Skinning/SkinnableDrawable.cs
+++ b/osu.Game/Skinning/SkinnableDrawable.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Caching;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Skinning/SkinnableSound.cs b/osu.Game/Skinning/SkinnableSound.cs
index c9e55c09aa..c2696c56f3 100644
--- a/osu.Game/Skinning/SkinnableSound.cs
+++ b/osu.Game/Skinning/SkinnableSound.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Skinning/SkinnableSprite.cs b/osu.Game/Skinning/SkinnableSprite.cs
index 21b34fcd27..57beb6e803 100644
--- a/osu.Game/Skinning/SkinnableSprite.cs
+++ b/osu.Game/Skinning/SkinnableSprite.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Skinning/SkinnableSpriteText.cs b/osu.Game/Skinning/SkinnableSpriteText.cs
index 2bde3c4180..3e9462b83e 100644
--- a/osu.Game/Skinning/SkinnableSpriteText.cs
+++ b/osu.Game/Skinning/SkinnableSpriteText.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Localisation;
diff --git a/osu.Game/Skinning/SkinnableTarget.cs b/osu.Game/Skinning/SkinnableTarget.cs
index 09de8a5d71..bca0d499f7 100644
--- a/osu.Game/Skinning/SkinnableTarget.cs
+++ b/osu.Game/Skinning/SkinnableTarget.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.
 
+#nullable disable
+
 namespace osu.Game.Skinning
 {
     public enum SkinnableTarget
diff --git a/osu.Game/Skinning/SkinnableTargetComponent.cs b/osu.Game/Skinning/SkinnableTargetComponent.cs
index a17aafe6e7..51af1c23c9 100644
--- a/osu.Game/Skinning/SkinnableTargetComponent.cs
+++ b/osu.Game/Skinning/SkinnableTargetComponent.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.
 
+#nullable disable
+
 namespace osu.Game.Skinning
 {
     public class SkinnableTargetComponent : ISkinComponent
diff --git a/osu.Game/Skinning/SkinnableTargetComponentsContainer.cs b/osu.Game/Skinning/SkinnableTargetComponentsContainer.cs
index 67114de948..dd7290a858 100644
--- a/osu.Game/Skinning/SkinnableTargetComponentsContainer.cs
+++ b/osu.Game/Skinning/SkinnableTargetComponentsContainer.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.
 
+#nullable disable
+
 using System;
 using Newtonsoft.Json;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Skinning/SkinnableTargetContainer.cs b/osu.Game/Skinning/SkinnableTargetContainer.cs
index 20c2fcc075..341a881789 100644
--- a/osu.Game/Skinning/SkinnableTargetContainer.cs
+++ b/osu.Game/Skinning/SkinnableTargetContainer.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using System.Threading;
diff --git a/osu.Game/Skinning/UnsupportedSkinComponentException.cs b/osu.Game/Skinning/UnsupportedSkinComponentException.cs
index 7f0dd51d5b..3713b7c200 100644
--- a/osu.Game/Skinning/UnsupportedSkinComponentException.cs
+++ b/osu.Game/Skinning/UnsupportedSkinComponentException.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.
 
+#nullable disable
+
 using System;
 
 namespace osu.Game.Skinning
diff --git a/osu.Game/Storyboards/CommandLoop.cs b/osu.Game/Storyboards/CommandLoop.cs
index 0713cb8670..0f26ed2c66 100644
--- a/osu.Game/Storyboards/CommandLoop.cs
+++ b/osu.Game/Storyboards/CommandLoop.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 
diff --git a/osu.Game/Storyboards/CommandTimeline.cs b/osu.Game/Storyboards/CommandTimeline.cs
index 8ded3ee975..4d0da9597b 100644
--- a/osu.Game/Storyboards/CommandTimeline.cs
+++ b/osu.Game/Storyboards/CommandTimeline.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using System;
 using System.Collections.Generic;
diff --git a/osu.Game/Storyboards/CommandTimelineGroup.cs b/osu.Game/Storyboards/CommandTimelineGroup.cs
index e7de135ce8..20232012f6 100644
--- a/osu.Game/Storyboards/CommandTimelineGroup.cs
+++ b/osu.Game/Storyboards/CommandTimelineGroup.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.
 
+#nullable disable
+
 using System;
 using osuTK;
 using osuTK.Graphics;
diff --git a/osu.Game/Storyboards/CommandTrigger.cs b/osu.Game/Storyboards/CommandTrigger.cs
index 011f345df2..50f3f0ef49 100644
--- a/osu.Game/Storyboards/CommandTrigger.cs
+++ b/osu.Game/Storyboards/CommandTrigger.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.
 
+#nullable disable
+
 namespace osu.Game.Storyboards
 {
     public class CommandTrigger : CommandTimelineGroup
diff --git a/osu.Game/Storyboards/Drawables/DrawableStoryboard.cs b/osu.Game/Storyboards/Drawables/DrawableStoryboard.cs
index 0a5d51f62e..be98ca9a46 100644
--- a/osu.Game/Storyboards/Drawables/DrawableStoryboard.cs
+++ b/osu.Game/Storyboards/Drawables/DrawableStoryboard.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Storyboards/Drawables/DrawableStoryboardAnimation.cs b/osu.Game/Storyboards/Drawables/DrawableStoryboardAnimation.cs
index 8a14b8b183..9822f36620 100644
--- a/osu.Game/Storyboards/Drawables/DrawableStoryboardAnimation.cs
+++ b/osu.Game/Storyboards/Drawables/DrawableStoryboardAnimation.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.
 
+#nullable disable
+
 using System;
 using System.IO;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Storyboards/Drawables/DrawableStoryboardLayer.cs b/osu.Game/Storyboards/Drawables/DrawableStoryboardLayer.cs
index 1085b52d65..13f116af24 100644
--- a/osu.Game/Storyboards/Drawables/DrawableStoryboardLayer.cs
+++ b/osu.Game/Storyboards/Drawables/DrawableStoryboardLayer.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.
 
+#nullable disable
+
 using System.Threading;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Storyboards/Drawables/DrawableStoryboardSample.cs b/osu.Game/Storyboards/Drawables/DrawableStoryboardSample.cs
index 4e3f72512c..2e7ca31fe9 100644
--- a/osu.Game/Storyboards/Drawables/DrawableStoryboardSample.cs
+++ b/osu.Game/Storyboards/Drawables/DrawableStoryboardSample.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Storyboards/Drawables/DrawableStoryboardSprite.cs b/osu.Game/Storyboards/Drawables/DrawableStoryboardSprite.cs
index a6f2b8fcbd..28ed2e65e3 100644
--- a/osu.Game/Storyboards/Drawables/DrawableStoryboardSprite.cs
+++ b/osu.Game/Storyboards/Drawables/DrawableStoryboardSprite.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Storyboards/Drawables/DrawableStoryboardVideo.cs b/osu.Game/Storyboards/Drawables/DrawableStoryboardVideo.cs
index 0625ddaffd..23b1004e74 100644
--- a/osu.Game/Storyboards/Drawables/DrawableStoryboardVideo.cs
+++ b/osu.Game/Storyboards/Drawables/DrawableStoryboardVideo.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Storyboards/Drawables/DrawablesExtensions.cs b/osu.Game/Storyboards/Drawables/DrawablesExtensions.cs
index bbc55a336d..779c8384c5 100644
--- a/osu.Game/Storyboards/Drawables/DrawablesExtensions.cs
+++ b/osu.Game/Storyboards/Drawables/DrawablesExtensions.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Transforms;
 
diff --git a/osu.Game/Storyboards/Drawables/IFlippable.cs b/osu.Game/Storyboards/Drawables/IFlippable.cs
index 165b3d97cc..aceb5c041c 100644
--- a/osu.Game/Storyboards/Drawables/IFlippable.cs
+++ b/osu.Game/Storyboards/Drawables/IFlippable.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Transforms;
 
diff --git a/osu.Game/Storyboards/Drawables/IVectorScalable.cs b/osu.Game/Storyboards/Drawables/IVectorScalable.cs
index fcc407d460..3b43a35a90 100644
--- a/osu.Game/Storyboards/Drawables/IVectorScalable.cs
+++ b/osu.Game/Storyboards/Drawables/IVectorScalable.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Transforms;
 using osuTK;
diff --git a/osu.Game/Storyboards/IStoryboardElement.cs b/osu.Game/Storyboards/IStoryboardElement.cs
index 9a059991e6..7e83f8b692 100644
--- a/osu.Game/Storyboards/IStoryboardElement.cs
+++ b/osu.Game/Storyboards/IStoryboardElement.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 
 namespace osu.Game.Storyboards
diff --git a/osu.Game/Storyboards/IStoryboardElementWithDuration.cs b/osu.Game/Storyboards/IStoryboardElementWithDuration.cs
index 55f163ee07..c8daeb3b3d 100644
--- a/osu.Game/Storyboards/IStoryboardElementWithDuration.cs
+++ b/osu.Game/Storyboards/IStoryboardElementWithDuration.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.
 
+#nullable disable
+
 namespace osu.Game.Storyboards
 {
     /// <summary>
diff --git a/osu.Game/Storyboards/Storyboard.cs b/osu.Game/Storyboards/Storyboard.cs
index 1d21b5dce2..f30c3f7f94 100644
--- a/osu.Game/Storyboards/Storyboard.cs
+++ b/osu.Game/Storyboards/Storyboard.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Storyboards/StoryboardAnimation.cs b/osu.Game/Storyboards/StoryboardAnimation.cs
index 1a4b6bb923..16deac8e9e 100644
--- a/osu.Game/Storyboards/StoryboardAnimation.cs
+++ b/osu.Game/Storyboards/StoryboardAnimation.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.
 
+#nullable disable
+
 using osuTK;
 using osu.Framework.Graphics;
 using osu.Game.Storyboards.Drawables;
diff --git a/osu.Game/Storyboards/StoryboardExtensions.cs b/osu.Game/Storyboards/StoryboardExtensions.cs
index 4e8251c9e7..e5cafc152b 100644
--- a/osu.Game/Storyboards/StoryboardExtensions.cs
+++ b/osu.Game/Storyboards/StoryboardExtensions.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.
 
+#nullable disable
+
 using osu.Framework.Extensions.EnumExtensions;
 using osu.Framework.Graphics;
 using osuTK;
diff --git a/osu.Game/Storyboards/StoryboardLayer.cs b/osu.Game/Storyboards/StoryboardLayer.cs
index fa9d4ebfea..2ab8d9fc2a 100644
--- a/osu.Game/Storyboards/StoryboardLayer.cs
+++ b/osu.Game/Storyboards/StoryboardLayer.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.
 
+#nullable disable
+
 using osu.Game.Storyboards.Drawables;
 using System.Collections.Generic;
 
diff --git a/osu.Game/Storyboards/StoryboardSample.cs b/osu.Game/Storyboards/StoryboardSample.cs
index 5d6ce215f5..752d086993 100644
--- a/osu.Game/Storyboards/StoryboardSample.cs
+++ b/osu.Game/Storyboards/StoryboardSample.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Framework.Graphics;
 using osu.Game.Audio;
diff --git a/osu.Game/Storyboards/StoryboardSprite.cs b/osu.Game/Storyboards/StoryboardSprite.cs
index ebd1a941a8..838dc618f2 100644
--- a/osu.Game/Storyboards/StoryboardSprite.cs
+++ b/osu.Game/Storyboards/StoryboardSprite.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Storyboards/StoryboardVideo.cs b/osu.Game/Storyboards/StoryboardVideo.cs
index 4652e45852..04ff941397 100644
--- a/osu.Game/Storyboards/StoryboardVideo.cs
+++ b/osu.Game/Storyboards/StoryboardVideo.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Game.Storyboards.Drawables;
 
diff --git a/osu.Game/Storyboards/StoryboardVideoLayer.cs b/osu.Game/Storyboards/StoryboardVideoLayer.cs
index 2a01c2274a..339e70d677 100644
--- a/osu.Game/Storyboards/StoryboardVideoLayer.cs
+++ b/osu.Game/Storyboards/StoryboardVideoLayer.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Game.Storyboards.Drawables;
 using osuTK;
diff --git a/osu.Game/Tests/Beatmaps/BeatmapConversionTest.cs b/osu.Game/Tests/Beatmaps/BeatmapConversionTest.cs
index 8d622955b7..c5f6f58b86 100644
--- a/osu.Game/Tests/Beatmaps/BeatmapConversionTest.cs
+++ b/osu.Game/Tests/Beatmaps/BeatmapConversionTest.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.IO;
diff --git a/osu.Game/Tests/Beatmaps/DifficultyCalculatorTest.cs b/osu.Game/Tests/Beatmaps/DifficultyCalculatorTest.cs
index ed00c7959b..c7441f68bd 100644
--- a/osu.Game/Tests/Beatmaps/DifficultyCalculatorTest.cs
+++ b/osu.Game/Tests/Beatmaps/DifficultyCalculatorTest.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.
 
+#nullable disable
+
 using System;
 using System.IO;
 using System.Reflection;
diff --git a/osu.Game/Tests/Beatmaps/HitObjectSampleTest.cs b/osu.Game/Tests/Beatmaps/HitObjectSampleTest.cs
index 4667a385b3..3ed3bb65c9 100644
--- a/osu.Game/Tests/Beatmaps/HitObjectSampleTest.cs
+++ b/osu.Game/Tests/Beatmaps/HitObjectSampleTest.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Diagnostics;
diff --git a/osu.Game/Tests/Beatmaps/LegacyBeatmapSkinColourTest.cs b/osu.Game/Tests/Beatmaps/LegacyBeatmapSkinColourTest.cs
index 597c5e9a2b..06600c4681 100644
--- a/osu.Game/Tests/Beatmaps/LegacyBeatmapSkinColourTest.cs
+++ b/osu.Game/Tests/Beatmaps/LegacyBeatmapSkinColourTest.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Tests/Beatmaps/LegacyModConversionTest.cs b/osu.Game/Tests/Beatmaps/LegacyModConversionTest.cs
index b7803f3420..921a039065 100644
--- a/osu.Game/Tests/Beatmaps/LegacyModConversionTest.cs
+++ b/osu.Game/Tests/Beatmaps/LegacyModConversionTest.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using NUnit.Framework;
diff --git a/osu.Game/Tests/Beatmaps/TestBeatmap.cs b/osu.Game/Tests/Beatmaps/TestBeatmap.cs
index ff670e1232..1aa99ceed9 100644
--- a/osu.Game/Tests/Beatmaps/TestBeatmap.cs
+++ b/osu.Game/Tests/Beatmaps/TestBeatmap.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.
 
+#nullable disable
+
 using System;
 using System.Diagnostics;
 using System.IO;
diff --git a/osu.Game/Tests/Beatmaps/TestWorkingBeatmap.cs b/osu.Game/Tests/Beatmaps/TestWorkingBeatmap.cs
index 19974701db..2306fd1c3e 100644
--- a/osu.Game/Tests/Beatmaps/TestWorkingBeatmap.cs
+++ b/osu.Game/Tests/Beatmaps/TestWorkingBeatmap.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.
 
+#nullable disable
+
 using System.IO;
 using osu.Framework.Audio;
 using osu.Framework.Audio.Track;
diff --git a/osu.Game/Tests/CleanRunHeadlessGameHost.cs b/osu.Game/Tests/CleanRunHeadlessGameHost.cs
index bdb171c528..d36168d3dd 100644
--- a/osu.Game/Tests/CleanRunHeadlessGameHost.cs
+++ b/osu.Game/Tests/CleanRunHeadlessGameHost.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.
 
+#nullable disable
+
 using System;
 using System.Runtime.CompilerServices;
 using osu.Framework;
diff --git a/osu.Game/Tests/Gameplay/TestGameplayState.cs b/osu.Game/Tests/Gameplay/TestGameplayState.cs
index f14f8c44ec..bb82335543 100644
--- a/osu.Game/Tests/Gameplay/TestGameplayState.cs
+++ b/osu.Game/Tests/Gameplay/TestGameplayState.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 enable
-
 using System.Collections.Generic;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Mods;
diff --git a/osu.Game/Tests/OsuTestBrowser.cs b/osu.Game/Tests/OsuTestBrowser.cs
index 71b0b02fa6..064fdeee94 100644
--- a/osu.Game/Tests/OsuTestBrowser.cs
+++ b/osu.Game/Tests/OsuTestBrowser.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Platform;
 using osu.Framework.Screens;
diff --git a/osu.Game/Tests/Rulesets/TestRulesetConfigCache.cs b/osu.Game/Tests/Rulesets/TestRulesetConfigCache.cs
index 537bee6824..a80154c38e 100644
--- a/osu.Game/Tests/Rulesets/TestRulesetConfigCache.cs
+++ b/osu.Game/Tests/Rulesets/TestRulesetConfigCache.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.
 
+#nullable disable
+
 using System.Collections.Concurrent;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Configuration;
diff --git a/osu.Game/Tests/Visual/DependencyProvidingContainer.cs b/osu.Game/Tests/Visual/DependencyProvidingContainer.cs
index d1290fc5ac..8d9108f376 100644
--- a/osu.Game/Tests/Visual/DependencyProvidingContainer.cs
+++ b/osu.Game/Tests/Visual/DependencyProvidingContainer.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Tests/Visual/EditorClockTestScene.cs b/osu.Game/Tests/Visual/EditorClockTestScene.cs
index 15e4fc4d8f..91284ae499 100644
--- a/osu.Game/Tests/Visual/EditorClockTestScene.cs
+++ b/osu.Game/Tests/Visual/EditorClockTestScene.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Tests/Visual/EditorSavingTestScene.cs b/osu.Game/Tests/Visual/EditorSavingTestScene.cs
index cc39ead1de..3b7b6780b1 100644
--- a/osu.Game/Tests/Visual/EditorSavingTestScene.cs
+++ b/osu.Game/Tests/Visual/EditorSavingTestScene.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.
 
+#nullable disable
+
 using System.Linq;
 using osu.Framework.Input;
 using osu.Framework.Testing;
diff --git a/osu.Game/Tests/Visual/EditorTestScene.cs b/osu.Game/Tests/Visual/EditorTestScene.cs
index d4a624f26a..3f5fee5768 100644
--- a/osu.Game/Tests/Visual/EditorTestScene.cs
+++ b/osu.Game/Tests/Visual/EditorTestScene.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.
 
+#nullable disable
+
 using System.Linq;
 using JetBrains.Annotations;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Tests/Visual/LegacySkinPlayerTestScene.cs b/osu.Game/Tests/Visual/LegacySkinPlayerTestScene.cs
index d74be70df8..f6b5d861be 100644
--- a/osu.Game/Tests/Visual/LegacySkinPlayerTestScene.cs
+++ b/osu.Game/Tests/Visual/LegacySkinPlayerTestScene.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.
 
+#nullable disable
+
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Tests/Visual/ModPerfectTestScene.cs b/osu.Game/Tests/Visual/ModPerfectTestScene.cs
index 93b38a149c..f1ad2656cd 100644
--- a/osu.Game/Tests/Visual/ModPerfectTestScene.cs
+++ b/osu.Game/Tests/Visual/ModPerfectTestScene.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.
 
+#nullable disable
+
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Mods;
diff --git a/osu.Game/Tests/Visual/ModTestScene.cs b/osu.Game/Tests/Visual/ModTestScene.cs
index 2505864d59..28778f1ac3 100644
--- a/osu.Game/Tests/Visual/ModTestScene.cs
+++ b/osu.Game/Tests/Visual/ModTestScene.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using JetBrains.Annotations;
diff --git a/osu.Game/Tests/Visual/Multiplayer/IMultiplayerTestSceneDependencies.cs b/osu.Game/Tests/Visual/Multiplayer/IMultiplayerTestSceneDependencies.cs
index 62d1c9ceca..0570c4e2f2 100644
--- a/osu.Game/Tests/Visual/Multiplayer/IMultiplayerTestSceneDependencies.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/IMultiplayerTestSceneDependencies.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.
 
+#nullable disable
+
 using osu.Game.Screens.OnlinePlay;
 using osu.Game.Tests.Visual.OnlinePlay;
 using osu.Game.Tests.Visual.Spectator;
diff --git a/osu.Game/Tests/Visual/Multiplayer/MultiplayerTestScene.cs b/osu.Game/Tests/Visual/Multiplayer/MultiplayerTestScene.cs
index a26c6f9be9..5ea98bdbb1 100644
--- a/osu.Game/Tests/Visual/Multiplayer/MultiplayerTestScene.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/MultiplayerTestScene.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.
 
+#nullable disable
+
 using NUnit.Framework;
 using osu.Game.Online.Rooms;
 using osu.Game.Tests.Beatmaps;
diff --git a/osu.Game/Tests/Visual/Multiplayer/MultiplayerTestSceneDependencies.cs b/osu.Game/Tests/Visual/Multiplayer/MultiplayerTestSceneDependencies.cs
index 6b4e01b673..0f286475bd 100644
--- a/osu.Game/Tests/Visual/Multiplayer/MultiplayerTestSceneDependencies.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/MultiplayerTestSceneDependencies.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.
 
+#nullable disable
+
 using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Spectator;
 using osu.Game.Screens.OnlinePlay;
diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
index 725499d0e5..e5a1236abf 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerClient.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 enable
-
 using System;
 using System.Collections.Generic;
 using System.Diagnostics;
diff --git a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerRoomManager.cs b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerRoomManager.cs
index 296db3152d..b2283af9e7 100644
--- a/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerRoomManager.cs
+++ b/osu.Game/Tests/Visual/Multiplayer/TestMultiplayerRoomManager.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using osu.Game.Online.API.Requests.Responses;
diff --git a/osu.Game/Tests/Visual/OnlinePlay/IOnlinePlayTestSceneDependencies.cs b/osu.Game/Tests/Visual/OnlinePlay/IOnlinePlayTestSceneDependencies.cs
index c94e288e11..12d1846ece 100644
--- a/osu.Game/Tests/Visual/OnlinePlay/IOnlinePlayTestSceneDependencies.cs
+++ b/osu.Game/Tests/Visual/OnlinePlay/IOnlinePlayTestSceneDependencies.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.
 
+#nullable disable
+
 using osu.Framework.Bindables;
 using osu.Game.Database;
 using osu.Game.Online.Rooms;
diff --git a/osu.Game/Tests/Visual/OnlinePlay/OnlinePlayTestScene.cs b/osu.Game/Tests/Visual/OnlinePlay/OnlinePlayTestScene.cs
index df3974664e..282312c9c1 100644
--- a/osu.Game/Tests/Visual/OnlinePlay/OnlinePlayTestScene.cs
+++ b/osu.Game/Tests/Visual/OnlinePlay/OnlinePlayTestScene.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.
 
+#nullable disable
+
 using System;
 using System.Threading.Tasks;
 using NUnit.Framework;
diff --git a/osu.Game/Tests/Visual/OnlinePlay/OnlinePlayTestSceneDependencies.cs b/osu.Game/Tests/Visual/OnlinePlay/OnlinePlayTestSceneDependencies.cs
index 7c8bc2d535..35bdba0038 100644
--- a/osu.Game/Tests/Visual/OnlinePlay/OnlinePlayTestSceneDependencies.cs
+++ b/osu.Game/Tests/Visual/OnlinePlay/OnlinePlayTestSceneDependencies.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Tests/Visual/OnlinePlay/TestRoomManager.cs b/osu.Game/Tests/Visual/OnlinePlay/TestRoomManager.cs
index 3de4e7afd9..f905eb26d3 100644
--- a/osu.Game/Tests/Visual/OnlinePlay/TestRoomManager.cs
+++ b/osu.Game/Tests/Visual/OnlinePlay/TestRoomManager.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.
 
+#nullable disable
+
 using System;
 using osu.Game.Beatmaps;
 using osu.Game.Online.API.Requests.Responses;
diff --git a/osu.Game/Tests/Visual/OnlinePlay/TestRoomRequestsHandler.cs b/osu.Game/Tests/Visual/OnlinePlay/TestRoomRequestsHandler.cs
index 8fea77833e..e7c83ca1f9 100644
--- a/osu.Game/Tests/Visual/OnlinePlay/TestRoomRequestsHandler.cs
+++ b/osu.Game/Tests/Visual/OnlinePlay/TestRoomRequestsHandler.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Diagnostics;
diff --git a/osu.Game/Tests/Visual/OsuGameTestScene.cs b/osu.Game/Tests/Visual/OsuGameTestScene.cs
index 5995b30b60..df0bdb0a50 100644
--- a/osu.Game/Tests/Visual/OsuGameTestScene.cs
+++ b/osu.Game/Tests/Visual/OsuGameTestScene.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Tests/Visual/OsuGridTestScene.cs b/osu.Game/Tests/Visual/OsuGridTestScene.cs
index 48f85be6ba..f9a609f663 100644
--- a/osu.Game/Tests/Visual/OsuGridTestScene.cs
+++ b/osu.Game/Tests/Visual/OsuGridTestScene.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.
 
+#nullable disable
+
 using osu.Framework.Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Tests/Visual/OsuManualInputManagerTestScene.cs b/osu.Game/Tests/Visual/OsuManualInputManagerTestScene.cs
index 2deb8686cc..eccd2efa96 100644
--- a/osu.Game/Tests/Visual/OsuManualInputManagerTestScene.cs
+++ b/osu.Game/Tests/Visual/OsuManualInputManagerTestScene.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.
 
+#nullable disable
+
 using System.Linq;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Tests/Visual/OsuTestScene.cs b/osu.Game/Tests/Visual/OsuTestScene.cs
index 1582bdfca4..c13cdff820 100644
--- a/osu.Game/Tests/Visual/OsuTestScene.cs
+++ b/osu.Game/Tests/Visual/OsuTestScene.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Diagnostics;
diff --git a/osu.Game/Tests/Visual/PlacementBlueprintTestScene.cs b/osu.Game/Tests/Visual/PlacementBlueprintTestScene.cs
index b981a31bd1..797e8363c3 100644
--- a/osu.Game/Tests/Visual/PlacementBlueprintTestScene.cs
+++ b/osu.Game/Tests/Visual/PlacementBlueprintTestScene.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Tests/Visual/PlayerTestScene.cs b/osu.Game/Tests/Visual/PlayerTestScene.cs
index b34f7e2d5f..521fd8f21a 100644
--- a/osu.Game/Tests/Visual/PlayerTestScene.cs
+++ b/osu.Game/Tests/Visual/PlayerTestScene.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using JetBrains.Annotations;
diff --git a/osu.Game/Tests/Visual/RateAdjustedBeatmapTestScene.cs b/osu.Game/Tests/Visual/RateAdjustedBeatmapTestScene.cs
index 1034f208a9..a4f768800c 100644
--- a/osu.Game/Tests/Visual/RateAdjustedBeatmapTestScene.cs
+++ b/osu.Game/Tests/Visual/RateAdjustedBeatmapTestScene.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.
 
+#nullable disable
+
 namespace osu.Game.Tests.Visual
 {
     /// <summary>
diff --git a/osu.Game/Tests/Visual/ScreenTestScene.cs b/osu.Game/Tests/Visual/ScreenTestScene.cs
index 0fa2f3e786..9adf6458cd 100644
--- a/osu.Game/Tests/Visual/ScreenTestScene.cs
+++ b/osu.Game/Tests/Visual/ScreenTestScene.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Tests/Visual/ScrollingTestContainer.cs b/osu.Game/Tests/Visual/ScrollingTestContainer.cs
index 994f23577d..cf7fe6e45d 100644
--- a/osu.Game/Tests/Visual/ScrollingTestContainer.cs
+++ b/osu.Game/Tests/Visual/ScrollingTestContainer.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Tests/Visual/SelectionBlueprintTestScene.cs b/osu.Game/Tests/Visual/SelectionBlueprintTestScene.cs
index 5448783f6d..66d79cad1c 100644
--- a/osu.Game/Tests/Visual/SelectionBlueprintTestScene.cs
+++ b/osu.Game/Tests/Visual/SelectionBlueprintTestScene.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.
 
+#nullable disable
+
 using JetBrains.Annotations;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Tests/Visual/SkinnableTestScene.cs b/osu.Game/Tests/Visual/SkinnableTestScene.cs
index 296ed80e37..2e5d0534f6 100644
--- a/osu.Game/Tests/Visual/SkinnableTestScene.cs
+++ b/osu.Game/Tests/Visual/SkinnableTestScene.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Text.RegularExpressions;
diff --git a/osu.Game/Tests/Visual/Spectator/TestSpectatorClient.cs b/osu.Game/Tests/Visual/Spectator/TestSpectatorClient.cs
index ac7cb43e02..fc29c5aac5 100644
--- a/osu.Game/Tests/Visual/Spectator/TestSpectatorClient.cs
+++ b/osu.Game/Tests/Visual/Spectator/TestSpectatorClient.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 enable
-
 using System;
 using System.Collections.Generic;
 using System.Diagnostics;
diff --git a/osu.Game/Tests/Visual/TestPlayer.cs b/osu.Game/Tests/Visual/TestPlayer.cs
index 66a956ca3d..e2ddd1734d 100644
--- a/osu.Game/Tests/Visual/TestPlayer.cs
+++ b/osu.Game/Tests/Visual/TestPlayer.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Tests/Visual/TestReplayPlayer.cs b/osu.Game/Tests/Visual/TestReplayPlayer.cs
index bacb2427b0..a33a6763af 100644
--- a/osu.Game/Tests/Visual/TestReplayPlayer.cs
+++ b/osu.Game/Tests/Visual/TestReplayPlayer.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Tests/Visual/TestUserLookupCache.cs b/osu.Game/Tests/Visual/TestUserLookupCache.cs
index ce1bbd5f15..414166fdd8 100644
--- a/osu.Game/Tests/Visual/TestUserLookupCache.cs
+++ b/osu.Game/Tests/Visual/TestUserLookupCache.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.
 
+#nullable disable
+
 using System.Threading;
 using System.Threading.Tasks;
 using osu.Game.Database;
diff --git a/osu.Game/Tests/VisualTestRunner.cs b/osu.Game/Tests/VisualTestRunner.cs
index 6aa75ec147..bd98482768 100644
--- a/osu.Game/Tests/VisualTestRunner.cs
+++ b/osu.Game/Tests/VisualTestRunner.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.
 
+#nullable disable
+
 using System;
 using osu.Framework;
 using osu.Framework.Platform;
diff --git a/osu.Game/Updater/GitHubAsset.cs b/osu.Game/Updater/GitHubAsset.cs
index 4783161859..a5dfd9e1ac 100644
--- a/osu.Game/Updater/GitHubAsset.cs
+++ b/osu.Game/Updater/GitHubAsset.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.
 
+#nullable disable
+
 using Newtonsoft.Json;
 
 namespace osu.Game.Updater
diff --git a/osu.Game/Updater/GitHubRelease.cs b/osu.Game/Updater/GitHubRelease.cs
index 363b2b628f..effabdbc04 100644
--- a/osu.Game/Updater/GitHubRelease.cs
+++ b/osu.Game/Updater/GitHubRelease.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using Newtonsoft.Json;
 
diff --git a/osu.Game/Updater/NoActionUpdateManager.cs b/osu.Game/Updater/NoActionUpdateManager.cs
index 8f9c4c6f16..8a96cdb968 100644
--- a/osu.Game/Updater/NoActionUpdateManager.cs
+++ b/osu.Game/Updater/NoActionUpdateManager.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.
 
+#nullable disable
+
 using System.Linq;
 using System.Threading.Tasks;
 using osu.Framework.Allocation;
diff --git a/osu.Game/Updater/SimpleUpdateManager.cs b/osu.Game/Updater/SimpleUpdateManager.cs
index c57a7c768e..fb5794d92e 100644
--- a/osu.Game/Updater/SimpleUpdateManager.cs
+++ b/osu.Game/Updater/SimpleUpdateManager.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.
 
+#nullable disable
+
 using System;
 using System.Linq;
 using System.Runtime.InteropServices;
diff --git a/osu.Game/Updater/UpdateManager.cs b/osu.Game/Updater/UpdateManager.cs
index c17d8304b9..d60f2e4a4b 100644
--- a/osu.Game/Updater/UpdateManager.cs
+++ b/osu.Game/Updater/UpdateManager.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.
 
+#nullable disable
+
 using System.Threading.Tasks;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Users/Badge.cs b/osu.Game/Users/Badge.cs
index 9d46a1992b..c191c25895 100644
--- a/osu.Game/Users/Badge.cs
+++ b/osu.Game/Users/Badge.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.
 
+#nullable disable
+
 using System;
 using Newtonsoft.Json;
 
diff --git a/osu.Game/Users/Country.cs b/osu.Game/Users/Country.cs
index a9fcd69286..b38600fa1b 100644
--- a/osu.Game/Users/Country.cs
+++ b/osu.Game/Users/Country.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.
 
+#nullable disable
+
 using System;
 using Newtonsoft.Json;
 
diff --git a/osu.Game/Users/CountryStatistics.cs b/osu.Game/Users/CountryStatistics.cs
index 000553c32b..e784630d56 100644
--- a/osu.Game/Users/CountryStatistics.cs
+++ b/osu.Game/Users/CountryStatistics.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.
 
+#nullable disable
+
 using Newtonsoft.Json;
 
 namespace osu.Game.Users
diff --git a/osu.Game/Users/Drawables/ClickableAvatar.cs b/osu.Game/Users/Drawables/ClickableAvatar.cs
index d85648c078..62e966c48f 100644
--- a/osu.Game/Users/Drawables/ClickableAvatar.cs
+++ b/osu.Game/Users/Drawables/ClickableAvatar.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Users/Drawables/DrawableAvatar.cs b/osu.Game/Users/Drawables/DrawableAvatar.cs
index e6d7bb692d..483106d3f4 100644
--- a/osu.Game/Users/Drawables/DrawableAvatar.cs
+++ b/osu.Game/Users/Drawables/DrawableAvatar.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Sprites;
diff --git a/osu.Game/Users/Drawables/DrawableFlag.cs b/osu.Game/Users/Drawables/DrawableFlag.cs
index aea40a01ae..e5ac8fa257 100644
--- a/osu.Game/Users/Drawables/DrawableFlag.cs
+++ b/osu.Game/Users/Drawables/DrawableFlag.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics.Cursor;
diff --git a/osu.Game/Users/Drawables/UpdateableAvatar.cs b/osu.Game/Users/Drawables/UpdateableAvatar.cs
index 8ce6ce3460..dab3dc59f9 100644
--- a/osu.Game/Users/Drawables/UpdateableAvatar.cs
+++ b/osu.Game/Users/Drawables/UpdateableAvatar.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Effects;
diff --git a/osu.Game/Users/Drawables/UpdateableFlag.cs b/osu.Game/Users/Drawables/UpdateableFlag.cs
index d0ef760e59..fd59bf305d 100644
--- a/osu.Game/Users/Drawables/UpdateableFlag.cs
+++ b/osu.Game/Users/Drawables/UpdateableFlag.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Users/ExtendedUserPanel.cs b/osu.Game/Users/ExtendedUserPanel.cs
index 6733ff8b05..7d475c545a 100644
--- a/osu.Game/Users/ExtendedUserPanel.cs
+++ b/osu.Game/Users/ExtendedUserPanel.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.
 
+#nullable disable
+
 using osuTK;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
diff --git a/osu.Game/Users/IUser.cs b/osu.Game/Users/IUser.cs
index d9a352872f..7a233b5d8b 100644
--- a/osu.Game/Users/IUser.cs
+++ b/osu.Game/Users/IUser.cs
@@ -4,8 +4,6 @@
 using System;
 using osu.Game.Database;
 
-#nullable enable
-
 namespace osu.Game.Users
 {
     public interface IUser : IHasOnlineID<int>, IEquatable<IUser>
diff --git a/osu.Game/Users/Medal.cs b/osu.Game/Users/Medal.cs
index 2e4f6de1d7..75718e714b 100644
--- a/osu.Game/Users/Medal.cs
+++ b/osu.Game/Users/Medal.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.
 
+#nullable disable
+
 namespace osu.Game.Users
 {
     public class Medal
diff --git a/osu.Game/Users/UserActivity.cs b/osu.Game/Users/UserActivity.cs
index 2f945d6e1c..6de797ca3a 100644
--- a/osu.Game/Users/UserActivity.cs
+++ b/osu.Game/Users/UserActivity.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.
 
+#nullable disable
+
 using osu.Game.Beatmaps;
 using osu.Game.Graphics;
 using osu.Game.Online.Rooms;
diff --git a/osu.Game/Users/UserBrickPanel.cs b/osu.Game/Users/UserBrickPanel.cs
index 3debdb6e72..a214b72795 100644
--- a/osu.Game/Users/UserBrickPanel.cs
+++ b/osu.Game/Users/UserBrickPanel.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Users/UserCoverBackground.cs b/osu.Game/Users/UserCoverBackground.cs
index 3f1f838b27..c799bbb1ea 100644
--- a/osu.Game/Users/UserCoverBackground.cs
+++ b/osu.Game/Users/UserCoverBackground.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.Color4Extensions;
diff --git a/osu.Game/Users/UserGridPanel.cs b/osu.Game/Users/UserGridPanel.cs
index c37eeb1cbf..38d8f6fb33 100644
--- a/osu.Game/Users/UserGridPanel.cs
+++ b/osu.Game/Users/UserGridPanel.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.
 
+#nullable disable
+
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
diff --git a/osu.Game/Users/UserListPanel.cs b/osu.Game/Users/UserListPanel.cs
index f06e412315..6d45481dbe 100644
--- a/osu.Game/Users/UserListPanel.cs
+++ b/osu.Game/Users/UserListPanel.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.
 
+#nullable disable
+
 using osu.Framework.Graphics;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics.Colour;
diff --git a/osu.Game/Users/UserPanel.cs b/osu.Game/Users/UserPanel.cs
index 40d70ca406..d150b38c45 100644
--- a/osu.Game/Users/UserPanel.cs
+++ b/osu.Game/Users/UserPanel.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
diff --git a/osu.Game/Users/UserStatistics.cs b/osu.Game/Users/UserStatistics.cs
index f8d26fe421..918a1b6968 100644
--- a/osu.Game/Users/UserStatistics.cs
+++ b/osu.Game/Users/UserStatistics.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.
 
+#nullable disable
+
 using System;
 using Newtonsoft.Json;
 using osu.Framework.Localisation;
diff --git a/osu.Game/Users/UserStatus.cs b/osu.Game/Users/UserStatus.cs
index 7f275b3b2a..075463c1e0 100644
--- a/osu.Game/Users/UserStatus.cs
+++ b/osu.Game/Users/UserStatus.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.
 
+#nullable disable
+
 using osu.Framework.Localisation;
 using osuTK.Graphics;
 using osu.Game.Graphics;
diff --git a/osu.Game/Utils/BatteryInfo.cs b/osu.Game/Utils/BatteryInfo.cs
index dd9b695e1f..be12671b84 100644
--- a/osu.Game/Utils/BatteryInfo.cs
+++ b/osu.Game/Utils/BatteryInfo.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.
 
+#nullable disable
+
 namespace osu.Game.Utils
 {
     /// <summary>
diff --git a/osu.Game/Utils/ColourUtils.cs b/osu.Game/Utils/ColourUtils.cs
index 515963971d..7e665fd9a7 100644
--- a/osu.Game/Utils/ColourUtils.cs
+++ b/osu.Game/Utils/ColourUtils.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using osu.Framework.Utils;
 using osuTK.Graphics;
diff --git a/osu.Game/Utils/FormatUtils.cs b/osu.Game/Utils/FormatUtils.cs
index 799dc75ca9..07a1879267 100644
--- a/osu.Game/Utils/FormatUtils.cs
+++ b/osu.Game/Utils/FormatUtils.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.
 
+#nullable disable
+
 using System;
 using Humanizer;
 using osu.Framework.Extensions.LocalisationExtensions;
diff --git a/osu.Game/Utils/HumanizerUtils.cs b/osu.Game/Utils/HumanizerUtils.cs
index 5b7c3630d9..27d3317b80 100644
--- a/osu.Game/Utils/HumanizerUtils.cs
+++ b/osu.Game/Utils/HumanizerUtils.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.
 
+#nullable disable
+
 using System;
 using System.Globalization;
 using Humanizer;
diff --git a/osu.Game/Utils/IDeepCloneable.cs b/osu.Game/Utils/IDeepCloneable.cs
index 6877f346c4..a0a2548f6c 100644
--- a/osu.Game/Utils/IDeepCloneable.cs
+++ b/osu.Game/Utils/IDeepCloneable.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.
 
+#nullable disable
+
 namespace osu.Game.Utils
 {
     /// <summary>A generic interface for a deeply cloneable type.</summary>
diff --git a/osu.Game/Utils/LegacyRandom.cs b/osu.Game/Utils/LegacyRandom.cs
index cf731aa91f..ace8f8f65c 100644
--- a/osu.Game/Utils/LegacyRandom.cs
+++ b/osu.Game/Utils/LegacyRandom.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Utils;
 
diff --git a/osu.Game/Utils/LegacyUtils.cs b/osu.Game/Utils/LegacyUtils.cs
index 64306adf50..400d3b3865 100644
--- a/osu.Game/Utils/LegacyUtils.cs
+++ b/osu.Game/Utils/LegacyUtils.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.
 
+#nullable disable
+
 using System;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Transforms;
diff --git a/osu.Game/Utils/ModUtils.cs b/osu.Game/Utils/ModUtils.cs
index ea092a8ca3..edf9cc80da 100644
--- a/osu.Game/Utils/ModUtils.cs
+++ b/osu.Game/Utils/ModUtils.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 enable
-
 using System;
 using System.Collections.Generic;
 using System.Diagnostics.CodeAnalysis;
diff --git a/osu.Game/Utils/NamingUtils.cs b/osu.Game/Utils/NamingUtils.cs
index 482e3d0954..6b1be8885d 100644
--- a/osu.Game/Utils/NamingUtils.cs
+++ b/osu.Game/Utils/NamingUtils.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.
 
+#nullable disable
+
 using System.Collections.Generic;
 using System.Text.RegularExpressions;
 
diff --git a/osu.Game/Utils/Optional.cs b/osu.Game/Utils/Optional.cs
index fdb7623be5..301767ba08 100644
--- a/osu.Game/Utils/Optional.cs
+++ b/osu.Game/Utils/Optional.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 enable
-
 namespace osu.Game.Utils
 {
     /// <summary>
diff --git a/osu.Game/Utils/PeriodTracker.cs b/osu.Game/Utils/PeriodTracker.cs
index ba77702247..d8251f49ca 100644
--- a/osu.Game/Utils/PeriodTracker.cs
+++ b/osu.Game/Utils/PeriodTracker.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.
 
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Utils/SentryLogger.cs b/osu.Game/Utils/SentryLogger.cs
index c12fd607b4..33dc548e9a 100644
--- a/osu.Game/Utils/SentryLogger.cs
+++ b/osu.Game/Utils/SentryLogger.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 enable
-
 using System;
 using System.Diagnostics;
 using System.IO;
diff --git a/osu.Game/Utils/StatelessRNG.cs b/osu.Game/Utils/StatelessRNG.cs
index 3db632fc42..548aaa887f 100644
--- a/osu.Game/Utils/StatelessRNG.cs
+++ b/osu.Game/Utils/StatelessRNG.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.
 
+#nullable disable
+
 using System;
 
 namespace osu.Game.Utils
diff --git a/osu.Game/Utils/TaskChain.cs b/osu.Game/Utils/TaskChain.cs
index df28faf9fb..7e7d26aa5d 100644
--- a/osu.Game/Utils/TaskChain.cs
+++ b/osu.Game/Utils/TaskChain.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 enable
-
 using System;
 using System.Threading;
 using System.Threading.Tasks;
diff --git a/osu.Game/Utils/ZipUtils.cs b/osu.Game/Utils/ZipUtils.cs
index eb2d2d3b80..d6ad3e132e 100644
--- a/osu.Game/Utils/ZipUtils.cs
+++ b/osu.Game/Utils/ZipUtils.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.
 
+#nullable disable
+
 using System;
 using System.IO;
 using SharpCompress.Archives.Zip;
diff --git a/osu.iOS/AppDelegate.cs b/osu.iOS/AppDelegate.cs
index 14e3627752..1d29d59fff 100644
--- a/osu.iOS/AppDelegate.cs
+++ b/osu.iOS/AppDelegate.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.
 
+#nullable disable
+
 using System.Threading.Tasks;
 using Foundation;
 using osu.Framework.iOS;
diff --git a/osu.iOS/Application.cs b/osu.iOS/Application.cs
index ffabdb4698..c5b2d0b451 100644
--- a/osu.iOS/Application.cs
+++ b/osu.iOS/Application.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.
 
+#nullable disable
+
 using osu.Framework.iOS;
 using UIKit;
 
diff --git a/osu.iOS/OsuGameIOS.cs b/osu.iOS/OsuGameIOS.cs
index 9c1795e45e..053bce1618 100644
--- a/osu.iOS/OsuGameIOS.cs
+++ b/osu.iOS/OsuGameIOS.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.
 
+#nullable disable
+
 using System;
 using Foundation;
 using osu.Framework.Graphics;

From fd9902e8162526b93dd2e33bf148a1d104fe2acf Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 17 Jun 2022 16:38:35 +0900
Subject: [PATCH 5522/5547] Manual #nullable processing

---
 osu.Game.Tests/Rulesets/TestSceneBrokenRulesetHandling.cs  | 2 --
 osu.Game/Rulesets/Objects/Legacy/ConvertHitObjectParser.cs | 2 ++
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Rulesets/TestSceneBrokenRulesetHandling.cs b/osu.Game.Tests/Rulesets/TestSceneBrokenRulesetHandling.cs
index 243a93b4e5..ecc4b3ec63 100644
--- a/osu.Game.Tests/Rulesets/TestSceneBrokenRulesetHandling.cs
+++ b/osu.Game.Tests/Rulesets/TestSceneBrokenRulesetHandling.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 enable
-
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/osu.Game/Rulesets/Objects/Legacy/ConvertHitObjectParser.cs b/osu.Game/Rulesets/Objects/Legacy/ConvertHitObjectParser.cs
index d3d1196eae..b289299a63 100644
--- a/osu.Game/Rulesets/Objects/Legacy/ConvertHitObjectParser.cs
+++ b/osu.Game/Rulesets/Objects/Legacy/ConvertHitObjectParser.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.
 
+#nullable disable
+
 using osuTK;
 using osu.Game.Rulesets.Objects.Types;
 using System;

From 11bd87045ef7f18bd7cb5cf88fbd327b15f65257 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 17 Jun 2022 16:49:53 +0900
Subject: [PATCH 5523/5547] Add automated commit to git-blame-ignore-revs

---
 .git-blame-ignore-revs | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/.git-blame-ignore-revs b/.git-blame-ignore-revs
index 8be6479043..39fa0f9f6c 100644
--- a/.git-blame-ignore-revs
+++ b/.git-blame-ignore-revs
@@ -1,2 +1,4 @@
 # Normalize all the line endings
 32a74f95a5c80a0ed18e693f13a47522099df5c3
+# Enabled NRT globally
+f8830c6850128456266c82de83273204f8b74ac0

From e51babdb96f64cf1a75266d69a2814f8653c3175 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 17 Jun 2022 17:01:11 +0900
Subject: [PATCH 5524/5547] Change heart animation flow to be more correct

---
 osu.Game/Screens/Menu/Disclaimer.cs | 13 ++++++-------
 1 file changed, 6 insertions(+), 7 deletions(-)

diff --git a/osu.Game/Screens/Menu/Disclaimer.cs b/osu.Game/Screens/Menu/Disclaimer.cs
index 3482b171a3..17064e5abc 100644
--- a/osu.Game/Screens/Menu/Disclaimer.cs
+++ b/osu.Game/Screens/Menu/Disclaimer.cs
@@ -146,16 +146,17 @@ namespace osu.Game.Screens.Menu
                     supportFlow.AddText(" to help support osu!'s development", formatSemiBold);
                 }
 
-                heart = supportFlow.AddIcon(FontAwesome.Solid.Heart, t =>
+                supportFlow.AddIcon(FontAwesome.Solid.Heart, t =>
                 {
+                    heart = t;
+
                     t.Padding = new MarginPadding { Left = 5, Top = 3 };
                     t.Font = t.Font.With(size: 20);
                     t.Origin = Anchor.Centre;
                     t.Colour = colours.Pink;
-                }).Drawables.First();
 
-                if (IsLoaded)
-                    animateHeart();
+                    Schedule(animateHeart);
+                });
 
                 if (supportFlow.IsPresent)
                     supportFlow.FadeInFromZero(500);
@@ -214,8 +215,6 @@ namespace osu.Game.Screens.Menu
             foreach (var c in textFlow.Children)
                 c.FadeTo(0.001f).Delay(delay += 20).FadeIn(500);
 
-            animateHeart();
-
             this
                 .FadeInFromZero(500)
                 .Then(5500)
@@ -255,7 +254,7 @@ namespace osu.Game.Screens.Menu
 
         private void animateHeart()
         {
-            heart.FlashColour(Color4.White, 750, Easing.OutQuint).Loop();
+            heart?.FlashColour(Color4.White, 750, Easing.OutQuint).Loop();
         }
     }
 }

From 869db5254019fcb924ac7bfb8578beb0e02bac20 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 17 Jun 2022 16:55:35 +0900
Subject: [PATCH 5525/5547] Tie loading layer to ongoing operation state

---
 .../Multiplayer/OnlineMultiplayerClient.cs    |  8 +++---
 .../Multiplayer/MultiplayerMatchSongSelect.cs | 26 +++++++++++++++----
 2 files changed, 26 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs b/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs
index a3423d4189..ae1ac5fa47 100644
--- a/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs
@@ -202,14 +202,16 @@ namespace osu.Game.Online.Multiplayer
             return connection.InvokeAsync(nameof(IMultiplayerServer.AddPlaylistItem), item);
         }
 
-        public override Task EditPlaylistItem(MultiplayerPlaylistItem item)
+        public override async Task EditPlaylistItem(MultiplayerPlaylistItem item)
         {
             if (!IsConnected.Value)
-                return Task.CompletedTask;
+                return;
 
             Debug.Assert(connection != null);
 
-            return connection.InvokeAsync(nameof(IMultiplayerServer.EditPlaylistItem), item);
+            await Task.Delay(10000);
+
+            await connection.InvokeAsync(nameof(IMultiplayerServer.EditPlaylistItem), item);
         }
 
         public override Task RemovePlaylistItem(long playlistItemId)
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs
index b2355a9021..10479054e3 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs
@@ -7,6 +7,7 @@ using System;
 using System.Linq;
 using System.Threading.Tasks;
 using osu.Framework.Allocation;
+using osu.Framework.Bindables;
 using osu.Framework.Screens;
 using osu.Game.Beatmaps;
 using osu.Game.Graphics.UserInterface;
@@ -26,6 +27,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
         [Resolved]
         private OngoingOperationTracker operationTracker { get; set; } = null!;
 
+        private readonly IBindable<bool> operationInProgress = new Bindable<bool>();
         private readonly long? itemToEdit;
 
         private LoadingLayer loadingLayer = null!;
@@ -59,16 +61,33 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
             AddInternal(loadingLayer = new LoadingLayer(true));
         }
 
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            operationInProgress.BindTo(operationTracker.InProgress);
+            operationInProgress.BindValueChanged(_ => updateLoadingLayer(), true);
+        }
+
+        private void updateLoadingLayer()
+        {
+            if (operationInProgress.Value)
+                loadingLayer.Show();
+            else
+                loadingLayer.Hide();
+        }
+
         protected override void SelectItem(PlaylistItem item)
         {
+            if (operationInProgress.Value)
+                return;
+
             // If the client is already in a room, update via the client.
             // Otherwise, update the playlist directly in preparation for it to be submitted to the API on match creation.
             if (client.Room != null)
             {
                 selectionOperation = operationTracker.BeginOperation();
 
-                loadingLayer.Show();
-
                 var multiplayerItem = new MultiplayerPlaylistItem
                 {
                     ID = itemToEdit ?? 0,
@@ -87,8 +106,6 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
 
                     Schedule(() =>
                     {
-                        loadingLayer.Hide();
-
                         // If an error or server side trigger occurred this screen may have already exited by external means.
                         if (this.IsCurrentScreen())
                             this.Exit();
@@ -99,7 +116,6 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
 
                     Schedule(() =>
                     {
-                        loadingLayer.Hide();
                         Carousel.AllowSelection = true;
                     });
                 });

From 1900480d51ed5cb47d5f9ac4355e5e055df7fcaf Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 17 Jun 2022 17:06:06 +0900
Subject: [PATCH 5526/5547] Inline animation method

---
 osu.Game/Screens/Menu/Disclaimer.cs | 7 +------
 1 file changed, 1 insertion(+), 6 deletions(-)

diff --git a/osu.Game/Screens/Menu/Disclaimer.cs b/osu.Game/Screens/Menu/Disclaimer.cs
index 17064e5abc..7a6d845bf1 100644
--- a/osu.Game/Screens/Menu/Disclaimer.cs
+++ b/osu.Game/Screens/Menu/Disclaimer.cs
@@ -155,7 +155,7 @@ namespace osu.Game.Screens.Menu
                     t.Origin = Anchor.Centre;
                     t.Colour = colours.Pink;
 
-                    Schedule(animateHeart);
+                    Schedule(() => heart?.FlashColour(Color4.White, 750, Easing.OutQuint).Loop());
                 });
 
                 if (supportFlow.IsPresent)
@@ -251,10 +251,5 @@ namespace osu.Game.Screens.Menu
 
             return tips[RNG.Next(0, tips.Length)];
         }
-
-        private void animateHeart()
-        {
-            heart?.FlashColour(Color4.White, 750, Easing.OutQuint).Loop();
-        }
     }
 }

From 42c97baa9787fbc3041891cd0176d1ddbb53e3e3 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 17 Jun 2022 17:55:58 +0900
Subject: [PATCH 5527/5547] Cache bust on more files

---
 .github/workflows/ci.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 8dd6ae8197..ef729a779f 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -31,7 +31,7 @@ jobs:
         uses: actions/cache@v3
         with:
           path: ${{ github.workspace }}/inspectcode
-          key: inspectcode-${{ hashFiles('.config/dotnet-tools.json', '.github/workflows/ci.yml', 'osu.sln*', '.editorconfig', '.globalconfig', 'CodeAnalysis/*') }}
+          key: inspectcode-${{ hashFiles('.config/dotnet-tools.json', '.github/workflows/ci.yml', 'osu.sln*', 'osu*.slnf', '.editorconfig', '.globalconfig', 'CodeAnalysis/*', '**/*.csproj', '**/*.props') }}
 
       - name: Dotnet code style
         run: dotnet build -c Debug -warnaserror osu.Desktop.slnf -p:EnforceCodeStyleInBuild=true

From f3793c880911c8049ab645c02e0e38607ec2f5b0 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 17 Jun 2022 21:02:18 +0300
Subject: [PATCH 5528/5547] Add lightweight `TournamentPlayer` model

---
 .../Models/TournamentPlayer.cs                | 59 +++++++++++++++++++
 1 file changed, 59 insertions(+)
 create mode 100644 osu.Game.Tournament/Models/TournamentPlayer.cs

diff --git a/osu.Game.Tournament/Models/TournamentPlayer.cs b/osu.Game.Tournament/Models/TournamentPlayer.cs
new file mode 100644
index 0000000000..6fd2f178e1
--- /dev/null
+++ b/osu.Game.Tournament/Models/TournamentPlayer.cs
@@ -0,0 +1,59 @@
+// 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.Game.Database;
+using osu.Game.Online.API.Requests.Responses;
+using osu.Game.Users;
+
+namespace osu.Game.Tournament.Models
+{
+    /// <summary>
+    /// A tournament player, containing simple information about the player.
+    /// </summary>
+    [Serializable]
+    public class TournamentPlayer : IUser
+    {
+        public int Id { get; set; }
+
+        public string Username { get; set; } = string.Empty;
+
+        /// <summary>
+        /// The player's country.
+        /// </summary>
+        public Country? Country { get; set; }
+
+        /// <summary>
+        /// The player's global rank, or null if not available.
+        /// </summary>
+        public int? Rank { get; set; }
+
+        /// <summary>
+        /// A URL to the player's profile cover.
+        /// </summary>
+        public string CoverUrl { get; set; } = string.Empty;
+
+        public APIUser ToUser()
+        {
+            var user = new APIUser
+            {
+                Id = Id,
+                Username = Username,
+                Country = Country,
+                CoverUrl = CoverUrl,
+            };
+
+            user.Statistics = new UserStatistics
+            {
+                User = user,
+                GlobalRank = Rank
+            };
+
+            return user;
+        }
+
+        int IHasOnlineID<int>.OnlineID => Id;
+
+        bool IUser.IsBot => false;
+    }
+}

From b977ce79959fbda38114cc5da3e1703c95eba7e7 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 17 Jun 2022 21:03:33 +0300
Subject: [PATCH 5529/5547] Replace tournament player storage type with
 lightweight model

---
 .../TestSceneDrawableTournamentTeam.cs        | 15 ++++-----
 .../TestSceneTournamentMatchChatDisplay.cs    | 14 ++++----
 .../TournamentTestScene.cs                    | 22 ++++++-------
 .../Components/DrawableTeamWithPlayers.cs     |  3 +-
 osu.Game.Tournament/Models/TournamentTeam.cs  |  5 ++-
 .../Screens/Editors/TeamEditorScreen.cs       | 33 +++++++++----------
 .../Screens/TeamIntro/SeedingScreen.cs        |  2 +-
 osu.Game.Tournament/TournamentGameBase.cs     | 23 ++++++-------
 8 files changed, 54 insertions(+), 63 deletions(-)

diff --git a/osu.Game.Tournament.Tests/Components/TestSceneDrawableTournamentTeam.cs b/osu.Game.Tournament.Tests/Components/TestSceneDrawableTournamentTeam.cs
index 9ade9965c5..3cf65b1990 100644
--- a/osu.Game.Tournament.Tests/Components/TestSceneDrawableTournamentTeam.cs
+++ b/osu.Game.Tournament.Tests/Components/TestSceneDrawableTournamentTeam.cs
@@ -5,7 +5,6 @@
 
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
-using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Tests.Visual;
 using osu.Game.Tournament.Components;
 using osu.Game.Tournament.Models;
@@ -26,13 +25,13 @@ namespace osu.Game.Tournament.Tests.Components
                 FullName = { Value = "Australia" },
                 Players =
                 {
-                    new APIUser { Username = "ASecretBox" },
-                    new APIUser { Username = "Dereban" },
-                    new APIUser { Username = "mReKk" },
-                    new APIUser { Username = "uyghti" },
-                    new APIUser { Username = "Parkes" },
-                    new APIUser { Username = "Shiroha" },
-                    new APIUser { Username = "Jordan The Bear" },
+                    new TournamentPlayer { Username = "ASecretBox" },
+                    new TournamentPlayer { Username = "Dereban" },
+                    new TournamentPlayer { Username = "mReKk" },
+                    new TournamentPlayer { Username = "uyghti" },
+                    new TournamentPlayer { Username = "Parkes" },
+                    new TournamentPlayer { Username = "Shiroha" },
+                    new TournamentPlayer { Username = "Jordan The Bear" },
                 }
             };
 
diff --git a/osu.Game.Tournament.Tests/Components/TestSceneTournamentMatchChatDisplay.cs b/osu.Game.Tournament.Tests/Components/TestSceneTournamentMatchChatDisplay.cs
index 4a4def10b5..3eac240be5 100644
--- a/osu.Game.Tournament.Tests/Components/TestSceneTournamentMatchChatDisplay.cs
+++ b/osu.Game.Tournament.Tests/Components/TestSceneTournamentMatchChatDisplay.cs
@@ -27,13 +27,13 @@ namespace osu.Game.Tournament.Tests.Components
             Colour = "f2ca34"
         };
 
-        private readonly APIUser redUser = new APIUser
+        private readonly TournamentPlayer redPlayer = new TournamentPlayer
         {
             Username = "BanchoBot",
             Id = 3,
         };
 
-        private readonly APIUser blueUser = new APIUser
+        private readonly TournamentPlayer bluePlayer = new TournamentPlayer
         {
             Username = "Zallius",
             Id = 4,
@@ -59,11 +59,11 @@ namespace osu.Game.Tournament.Tests.Components
             {
                 Team1 =
                 {
-                    Value = new TournamentTeam { Players = new BindableList<APIUser> { redUser } }
+                    Value = new TournamentTeam { Players = new BindableList<TournamentPlayer> { redPlayer } }
                 },
                 Team2 =
                 {
-                    Value = new TournamentTeam { Players = new BindableList<APIUser> { blueUser } }
+                    Value = new TournamentTeam { Players = new BindableList<TournamentPlayer> { bluePlayer } }
                 }
             };
 
@@ -82,19 +82,19 @@ namespace osu.Game.Tournament.Tests.Components
 
             AddStep("message from team red", () => testChannel.AddNewMessages(new Message(nextMessageId())
             {
-                Sender = redUser,
+                Sender = redPlayer.ToUser(),
                 Content = "I am team red."
             }));
 
             AddStep("message from team red", () => testChannel.AddNewMessages(new Message(nextMessageId())
             {
-                Sender = redUser,
+                Sender = redPlayer.ToUser(),
                 Content = "I plan to win!"
             }));
 
             AddStep("message from team blue", () => testChannel.AddNewMessages(new Message(nextMessageId())
             {
-                Sender = blueUser,
+                Sender = bluePlayer.ToUser(),
                 Content = "Not on my watch. Prepare to eat saaaaaaaaaand. Lots and lots of saaaaaaand."
             }));
 
diff --git a/osu.Game.Tournament.Tests/TournamentTestScene.cs b/osu.Game.Tournament.Tests/TournamentTestScene.cs
index d631d028bb..47ab3023e4 100644
--- a/osu.Game.Tournament.Tests/TournamentTestScene.cs
+++ b/osu.Game.Tournament.Tests/TournamentTestScene.cs
@@ -15,8 +15,6 @@ using osu.Game.Tests.Visual;
 using osu.Game.Tournament.IO;
 using osu.Game.Tournament.IPC;
 using osu.Game.Tournament.Models;
-using osu.Game.Users;
-using APIUser = osu.Game.Online.API.Requests.Responses.APIUser;
 
 namespace osu.Game.Tournament.Tests
 {
@@ -123,11 +121,11 @@ namespace osu.Game.Tournament.Tests
                     },
                     Players =
                     {
-                        new APIUser { Username = "Hello", Statistics = new UserStatistics { GlobalRank = 12 } },
-                        new APIUser { Username = "Hello", Statistics = new UserStatistics { GlobalRank = 16 } },
-                        new APIUser { Username = "Hello", Statistics = new UserStatistics { GlobalRank = 20 } },
-                        new APIUser { Username = "Hello", Statistics = new UserStatistics { GlobalRank = 24 } },
-                        new APIUser { Username = "Hello", Statistics = new UserStatistics { GlobalRank = 30 } },
+                        new TournamentPlayer { Username = "Hello", Rank = 12 },
+                        new TournamentPlayer { Username = "Hello", Rank = 16 },
+                        new TournamentPlayer { Username = "Hello", Rank = 20 },
+                        new TournamentPlayer { Username = "Hello", Rank = 24 },
+                        new TournamentPlayer { Username = "Hello", Rank = 30 },
                     }
                 }
             },
@@ -140,11 +138,11 @@ namespace osu.Game.Tournament.Tests
                     FullName = { Value = "United States" },
                     Players =
                     {
-                        new APIUser { Username = "Hello" },
-                        new APIUser { Username = "Hello" },
-                        new APIUser { Username = "Hello" },
-                        new APIUser { Username = "Hello" },
-                        new APIUser { Username = "Hello" },
+                        new TournamentPlayer { Username = "Hello" },
+                        new TournamentPlayer { Username = "Hello" },
+                        new TournamentPlayer { Username = "Hello" },
+                        new TournamentPlayer { Username = "Hello" },
+                        new TournamentPlayer { Username = "Hello" },
                     }
                 }
             },
diff --git a/osu.Game.Tournament/Components/DrawableTeamWithPlayers.cs b/osu.Game.Tournament/Components/DrawableTeamWithPlayers.cs
index 21de2bb0eb..fd62c53741 100644
--- a/osu.Game.Tournament/Components/DrawableTeamWithPlayers.cs
+++ b/osu.Game.Tournament/Components/DrawableTeamWithPlayers.cs
@@ -7,7 +7,6 @@ using System.Linq;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Graphics;
-using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Tournament.Models;
 using osuTK;
 using osuTK.Graphics;
@@ -56,7 +55,7 @@ namespace osu.Game.Tournament.Components
                 },
             };
 
-            TournamentSpriteText createPlayerText(APIUser p) =>
+            TournamentSpriteText createPlayerText(TournamentPlayer p) =>
                 new TournamentSpriteText
                 {
                     Text = p.Username,
diff --git a/osu.Game.Tournament/Models/TournamentTeam.cs b/osu.Game.Tournament/Models/TournamentTeam.cs
index 051f1a6d80..420b47da66 100644
--- a/osu.Game.Tournament/Models/TournamentTeam.cs
+++ b/osu.Game.Tournament/Models/TournamentTeam.cs
@@ -7,7 +7,6 @@ using System;
 using System.Linq;
 using Newtonsoft.Json;
 using osu.Framework.Bindables;
-using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Tournament.Models
 {
@@ -38,7 +37,7 @@ namespace osu.Game.Tournament.Models
         {
             get
             {
-                int[] ranks = Players.Select(p => p.Statistics?.GlobalRank)
+                int[] ranks = Players.Select(p => p.Rank)
                                      .Where(i => i.HasValue)
                                      .Select(i => i.Value)
                                      .ToArray();
@@ -59,7 +58,7 @@ namespace osu.Game.Tournament.Models
         };
 
         [JsonProperty]
-        public BindableList<APIUser> Players { get; set; } = new BindableList<APIUser>();
+        public BindableList<TournamentPlayer> Players { get; set; } = new BindableList<TournamentPlayer>();
 
         public TournamentTeam()
         {
diff --git a/osu.Game.Tournament/Screens/Editors/TeamEditorScreen.cs b/osu.Game.Tournament/Screens/Editors/TeamEditorScreen.cs
index 005d8f36bb..942f861770 100644
--- a/osu.Game.Tournament/Screens/Editors/TeamEditorScreen.cs
+++ b/osu.Game.Tournament/Screens/Editors/TeamEditorScreen.cs
@@ -15,7 +15,6 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
 using osu.Game.Graphics;
 using osu.Game.Online.API;
-using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays.Settings;
 using osu.Game.Tournament.Components;
 using osu.Game.Tournament.Models;
@@ -202,14 +201,14 @@ namespace osu.Game.Tournament.Screens.Editors
 
                 public void CreateNew()
                 {
-                    var user = new APIUser();
-                    team.Players.Add(user);
-                    flow.Add(new PlayerRow(team, user));
+                    var player = new TournamentPlayer();
+                    team.Players.Add(player);
+                    flow.Add(new PlayerRow(team, player));
                 }
 
                 public class PlayerRow : CompositeDrawable
                 {
-                    private readonly APIUser user;
+                    private readonly TournamentPlayer player;
 
                     [Resolved]
                     protected IAPIProvider API { get; private set; }
@@ -217,13 +216,13 @@ namespace osu.Game.Tournament.Screens.Editors
                     [Resolved]
                     private TournamentGameBase game { get; set; }
 
-                    private readonly Bindable<int?> userId = new Bindable<int?>();
+                    private readonly Bindable<int?> playerId = new Bindable<int?>();
 
                     private readonly Container drawableContainer;
 
-                    public PlayerRow(TournamentTeam team, APIUser user)
+                    public PlayerRow(TournamentTeam team, TournamentPlayer player)
                     {
-                        this.user = user;
+                        this.player = player;
 
                         Margin = new MarginPadding(10);
 
@@ -254,7 +253,7 @@ namespace osu.Game.Tournament.Screens.Editors
                                         LabelText = "User ID",
                                         RelativeSizeAxes = Axes.None,
                                         Width = 200,
-                                        Current = userId,
+                                        Current = playerId,
                                     },
                                     drawableContainer = new Container
                                     {
@@ -272,7 +271,7 @@ namespace osu.Game.Tournament.Screens.Editors
                                 Action = () =>
                                 {
                                     Expire();
-                                    team.Players.Remove(user);
+                                    team.Players.Remove(player);
                                 },
                             }
                         };
@@ -281,27 +280,27 @@ namespace osu.Game.Tournament.Screens.Editors
                     [BackgroundDependencyLoader]
                     private void load()
                     {
-                        userId.Value = user.Id;
-                        userId.BindValueChanged(id =>
+                        playerId.Value = player.Id;
+                        playerId.BindValueChanged(id =>
                         {
-                            user.Id = id.NewValue ?? 0;
+                            player.Id = id.NewValue ?? 0;
 
                             if (id.NewValue != id.OldValue)
-                                user.Username = string.Empty;
+                                player.Username = string.Empty;
 
-                            if (!string.IsNullOrEmpty(user.Username))
+                            if (!string.IsNullOrEmpty(player.Username))
                             {
                                 updatePanel();
                                 return;
                             }
 
-                            game.PopulateUser(user, updatePanel, updatePanel);
+                            game.PopulatePlayer(player, updatePanel, updatePanel);
                         }, true);
                     }
 
                     private void updatePanel()
                     {
-                        drawableContainer.Child = new UserGridPanel(user) { Width = 300 };
+                        drawableContainer.Child = new UserGridPanel(player.ToUser()) { Width = 300 };
                     }
                 }
             }
diff --git a/osu.Game.Tournament/Screens/TeamIntro/SeedingScreen.cs b/osu.Game.Tournament/Screens/TeamIntro/SeedingScreen.cs
index b9559015d6..df6e8e816e 100644
--- a/osu.Game.Tournament/Screens/TeamIntro/SeedingScreen.cs
+++ b/osu.Game.Tournament/Screens/TeamIntro/SeedingScreen.cs
@@ -257,7 +257,7 @@ namespace osu.Game.Tournament.Screens.TeamIntro
                 };
 
                 foreach (var p in team.Players)
-                    fill.Add(new RowDisplay(p.Username, p.Statistics?.GlobalRank?.ToString("\\##,0") ?? "-"));
+                    fill.Add(new RowDisplay(p.Username, p.Rank?.ToString("\\##,0") ?? "-"));
             }
 
             internal class RowDisplay : CompositeDrawable
diff --git a/osu.Game.Tournament/TournamentGameBase.cs b/osu.Game.Tournament/TournamentGameBase.cs
index 2d6d5a01e4..3fa6bca0be 100644
--- a/osu.Game.Tournament/TournamentGameBase.cs
+++ b/osu.Game.Tournament/TournamentGameBase.cs
@@ -22,7 +22,6 @@ using osu.Game.Tournament.IO;
 using osu.Game.Tournament.IPC;
 using osu.Game.Tournament.Models;
 using osuTK.Input;
-using APIUser = osu.Game.Online.API.Requests.Responses.APIUser;
 
 namespace osu.Game.Tournament
 {
@@ -187,9 +186,7 @@ namespace osu.Game.Tournament
         {
             var playersRequiringPopulation = ladder.Teams
                                                    .SelectMany(t => t.Players)
-                                                   .Where(p => string.IsNullOrEmpty(p.Username)
-                                                               || p.Statistics?.GlobalRank == null
-                                                               || p.Statistics?.CountryRank == null).ToList();
+                                                   .Where(p => string.IsNullOrEmpty(p.Username) || p.Rank == null).ToList();
 
             if (playersRequiringPopulation.Count == 0)
                 return false;
@@ -197,7 +194,7 @@ namespace osu.Game.Tournament
             for (int i = 0; i < playersRequiringPopulation.Count; i++)
             {
                 var p = playersRequiringPopulation[i];
-                PopulateUser(p, immediate: true);
+                PopulatePlayer(p, immediate: true);
                 updateLoadProgressMessage($"Populating user stats ({i} / {playersRequiringPopulation.Count})");
             }
 
@@ -259,9 +256,9 @@ namespace osu.Game.Tournament
 
         private void updateLoadProgressMessage(string s) => Schedule(() => initialisationText.Text = s);
 
-        public void PopulateUser(APIUser user, Action success = null, Action failure = null, bool immediate = false)
+        public void PopulatePlayer(TournamentPlayer player, Action success = null, Action failure = null, bool immediate = false)
         {
-            var req = new GetUserRequest(user.Id, ladder.Ruleset.Value);
+            var req = new GetUserRequest(player.Id, ladder.Ruleset.Value);
 
             if (immediate)
             {
@@ -273,7 +270,7 @@ namespace osu.Game.Tournament
                 req.Success += res => { populate(); };
                 req.Failure += _ =>
                 {
-                    user.Id = 1;
+                    player.Id = 1;
                     failure?.Invoke();
                 };
 
@@ -287,12 +284,12 @@ namespace osu.Game.Tournament
                 if (res == null)
                     return;
 
-                user.Id = res.Id;
+                player.Id = res.Id;
 
-                user.Username = res.Username;
-                user.Statistics = res.Statistics;
-                user.Country = res.Country;
-                user.Cover = res.Cover;
+                player.Username = res.Username;
+                player.CoverUrl = res.CoverUrl;
+                player.Country = res.Country;
+                player.Rank = res.Statistics?.GlobalRank;
 
                 success?.Invoke();
             }

From c4d69405bfd5e38d348cabe89112489b14d51c5b Mon Sep 17 00:00:00 2001
From: apollo-dw <83023433+apollo-dw@users.noreply.github.com>
Date: Fri, 17 Jun 2022 21:18:16 +0100
Subject: [PATCH 5530/5547] Adjust speed ratio fraction to avoid division by 0

---
 osu.Game.Rulesets.Osu/Difficulty/Evaluators/SpeedEvaluator.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Evaluators/SpeedEvaluator.cs b/osu.Game.Rulesets.Osu/Difficulty/Evaluators/SpeedEvaluator.cs
index 3be4d621eb..7782aa90f3 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Evaluators/SpeedEvaluator.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Evaluators/SpeedEvaluator.cs
@@ -42,7 +42,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Evaluators
                 double currDeltaTime = Math.Max(1, osuCurrObj.DeltaTime);
                 double nextDeltaTime = Math.Max(1, osuNextObj.DeltaTime);
                 double deltaDifference = Math.Abs(nextDeltaTime - currDeltaTime);
-                double speedRatio = Math.Min(1, currDeltaTime / deltaDifference);
+                double speedRatio = currDeltaTime / Math.Max(currDeltaTime, deltaDifference);
                 double windowRatio = Math.Pow(Math.Min(1, currDeltaTime / greatWindowFull), 2);
                 doubletapness = Math.Pow(speedRatio, 1 - windowRatio);
             }

From 200b23c6894b35d5a13b90c62f1ffc82c573be45 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sat, 18 Jun 2022 01:30:54 +0300
Subject: [PATCH 5531/5547] Add lightweight `TournamentBeatmap` model

---
 .../Models/TournamentBeatmap.cs               | 99 +++++++++++++++++++
 1 file changed, 99 insertions(+)
 create mode 100644 osu.Game.Tournament/Models/TournamentBeatmap.cs

diff --git a/osu.Game.Tournament/Models/TournamentBeatmap.cs b/osu.Game.Tournament/Models/TournamentBeatmap.cs
new file mode 100644
index 0000000000..274fddc490
--- /dev/null
+++ b/osu.Game.Tournament/Models/TournamentBeatmap.cs
@@ -0,0 +1,99 @@
+// 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.Extensions.ObjectExtensions;
+using osu.Game.Beatmaps;
+using osu.Game.Extensions;
+using osu.Game.Online.API.Requests.Responses;
+using osu.Game.Rulesets;
+
+namespace osu.Game.Tournament.Models
+{
+    public class TournamentBeatmap : IBeatmapInfo, IBeatmapSetOnlineInfo
+    {
+        public int OnlineID { get; set; }
+
+        public string DifficultyName { get; set; } = string.Empty;
+
+        public double BPM { get; set; }
+
+        public double Length { get; set; }
+
+        public double StarRating { get; set; }
+
+        public IBeatmapMetadataInfo Metadata { get; set; } = new BeatmapMetadata();
+
+        public IBeatmapDifficultyInfo Difficulty { get; set; } = new BeatmapDifficulty();
+
+        public BeatmapSetOnlineCovers Covers { get; set; }
+
+        public TournamentBeatmap()
+        {
+        }
+
+        public TournamentBeatmap(APIBeatmap beatmap)
+        {
+            OnlineID = beatmap.OnlineID;
+            DifficultyName = beatmap.DifficultyName;
+            BPM = beatmap.BPM;
+            Length = beatmap.Length;
+            StarRating = beatmap.StarRating;
+            Metadata = beatmap.Metadata;
+            Difficulty = beatmap.Difficulty;
+            Covers = beatmap.BeatmapSet.AsNonNull().Covers;
+        }
+
+        public bool Equals(IBeatmapInfo? other) => other is TournamentBeatmap b && this.MatchesOnlineID(b);
+
+        #region IBeatmapInfo/IBeatmapSetOnlineInfo explicit implementation
+
+        IBeatmapSetInfo IBeatmapInfo.BeatmapSet => throw new NotImplementedException();
+
+        string IBeatmapSetOnlineInfo.Preview => throw new NotImplementedException();
+
+        double IBeatmapSetOnlineInfo.BPM => throw new NotImplementedException();
+
+        int IBeatmapSetOnlineInfo.PlayCount => throw new NotImplementedException();
+
+        int IBeatmapSetOnlineInfo.FavouriteCount => throw new NotImplementedException();
+
+        bool IBeatmapSetOnlineInfo.HasFavourited => throw new NotImplementedException();
+
+        BeatmapSetOnlineAvailability IBeatmapSetOnlineInfo.Availability => throw new NotImplementedException();
+
+        BeatmapSetOnlineGenre IBeatmapSetOnlineInfo.Genre => throw new NotImplementedException();
+
+        BeatmapSetOnlineLanguage IBeatmapSetOnlineInfo.Language => throw new NotImplementedException();
+
+        int? IBeatmapSetOnlineInfo.TrackId => throw new NotImplementedException();
+
+        int[] IBeatmapSetOnlineInfo.Ratings => throw new NotImplementedException();
+
+        BeatmapSetHypeStatus IBeatmapSetOnlineInfo.HypeStatus => throw new NotImplementedException();
+
+        BeatmapSetNominationStatus IBeatmapSetOnlineInfo.NominationStatus => throw new NotImplementedException();
+
+        string IBeatmapInfo.Hash => throw new NotImplementedException();
+
+        string IBeatmapInfo.MD5Hash => throw new NotImplementedException();
+
+        IRulesetInfo IBeatmapInfo.Ruleset => throw new NotImplementedException();
+
+        DateTimeOffset IBeatmapSetOnlineInfo.Submitted => throw new NotImplementedException();
+
+        DateTimeOffset? IBeatmapSetOnlineInfo.Ranked => throw new NotImplementedException();
+
+        DateTimeOffset? IBeatmapSetOnlineInfo.LastUpdated => throw new NotImplementedException();
+
+        BeatmapOnlineStatus IBeatmapSetOnlineInfo.Status => throw new NotImplementedException();
+
+        bool IBeatmapSetOnlineInfo.HasExplicitContent => throw new NotImplementedException();
+
+        bool IBeatmapSetOnlineInfo.HasVideo => throw new NotImplementedException();
+
+        bool IBeatmapSetOnlineInfo.HasStoryboard => throw new NotImplementedException();
+
+        #endregion
+    }
+}

From 9f97d1a7db59e119adca33449f960794f1bed0a2 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sat, 18 Jun 2022 01:34:09 +0300
Subject: [PATCH 5532/5547] Replace tournament beatmap storage type with
 lightweight model

---
 osu.Game.Tournament.Tests/Components/TestSceneSongBar.cs  | 2 +-
 .../Components/TestSceneTournamentBeatmapPanel.cs         | 3 ++-
 .../Components/TestSceneTournamentModDisplay.cs           | 3 ++-
 osu.Game.Tournament.Tests/TournamentTestScene.cs          | 8 ++++----
 osu.Game.Tournament/Components/SongBar.cs                 | 6 +++---
 osu.Game.Tournament/Components/TournamentBeatmapPanel.cs  | 7 +++----
 osu.Game.Tournament/IPC/FileBasedIPC.cs                   | 2 +-
 osu.Game.Tournament/IPC/MatchIPCInfo.cs                   | 4 ++--
 osu.Game.Tournament/Models/RoundBeatmap.cs                | 3 +--
 osu.Game.Tournament/Models/SeedingBeatmap.cs              | 3 +--
 osu.Game.Tournament/Screens/BeatmapInfoScreen.cs          | 4 ++--
 osu.Game.Tournament/Screens/Editors/RoundEditorScreen.cs  | 2 +-
 .../Screens/Editors/SeedingEditorScreen.cs                | 2 +-
 osu.Game.Tournament/Screens/MapPool/MapPoolScreen.cs      | 3 +--
 osu.Game.Tournament/TournamentGameBase.cs                 | 8 ++++----
 15 files changed, 29 insertions(+), 31 deletions(-)

diff --git a/osu.Game.Tournament.Tests/Components/TestSceneSongBar.cs b/osu.Game.Tournament.Tests/Components/TestSceneSongBar.cs
index f90269ae60..992baa48a3 100644
--- a/osu.Game.Tournament.Tests/Components/TestSceneSongBar.cs
+++ b/osu.Game.Tournament.Tests/Components/TestSceneSongBar.cs
@@ -42,7 +42,7 @@ namespace osu.Game.Tournament.Tests.Components
                 beatmap.Length = 123456;
                 beatmap.BPM = 133;
 
-                songBar.Beatmap = beatmap;
+                songBar.Beatmap = new TournamentBeatmap(beatmap);
             });
             AddStep("set mods to HR", () => songBar.Mods = LegacyMods.HardRock);
             AddStep("set mods to DT", () => songBar.Mods = LegacyMods.DoubleTime);
diff --git a/osu.Game.Tournament.Tests/Components/TestSceneTournamentBeatmapPanel.cs b/osu.Game.Tournament.Tests/Components/TestSceneTournamentBeatmapPanel.cs
index 1030aae903..adfe048ce4 100644
--- a/osu.Game.Tournament.Tests/Components/TestSceneTournamentBeatmapPanel.cs
+++ b/osu.Game.Tournament.Tests/Components/TestSceneTournamentBeatmapPanel.cs
@@ -10,6 +10,7 @@ using osu.Game.Online.API.Requests;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Tests.Visual;
 using osu.Game.Tournament.Components;
+using osu.Game.Tournament.Models;
 
 namespace osu.Game.Tournament.Tests.Components
 {
@@ -32,7 +33,7 @@ namespace osu.Game.Tournament.Tests.Components
 
         private void success(APIBeatmap beatmap)
         {
-            Add(new TournamentBeatmapPanel(beatmap)
+            Add(new TournamentBeatmapPanel(new TournamentBeatmap(beatmap))
             {
                 Anchor = Anchor.Centre,
                 Origin = Anchor.Centre
diff --git a/osu.Game.Tournament.Tests/Components/TestSceneTournamentModDisplay.cs b/osu.Game.Tournament.Tests/Components/TestSceneTournamentModDisplay.cs
index fdd5578228..263617ddf7 100644
--- a/osu.Game.Tournament.Tests/Components/TestSceneTournamentModDisplay.cs
+++ b/osu.Game.Tournament.Tests/Components/TestSceneTournamentModDisplay.cs
@@ -11,6 +11,7 @@ using osu.Game.Online.API.Requests;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets;
 using osu.Game.Tournament.Components;
+using osu.Game.Tournament.Models;
 using osuTK;
 
 namespace osu.Game.Tournament.Tests.Components
@@ -53,7 +54,7 @@ namespace osu.Game.Tournament.Tests.Components
 
             foreach (var mod in mods)
             {
-                fillFlow.Add(new TournamentBeatmapPanel(beatmap, mod.Acronym)
+                fillFlow.Add(new TournamentBeatmapPanel(new TournamentBeatmap(beatmap), mod.Acronym)
                 {
                     Anchor = Anchor.Centre,
                     Origin = Anchor.Centre
diff --git a/osu.Game.Tournament.Tests/TournamentTestScene.cs b/osu.Game.Tournament.Tests/TournamentTestScene.cs
index d631d028bb..c30496812f 100644
--- a/osu.Game.Tournament.Tests/TournamentTestScene.cs
+++ b/osu.Game.Tournament.Tests/TournamentTestScene.cs
@@ -9,7 +9,7 @@ using osu.Framework.Allocation;
 using osu.Framework.Platform;
 using osu.Framework.Testing;
 using osu.Framework.Utils;
-using osu.Game.Online.API.Requests.Responses;
+using osu.Game.Beatmaps;
 using osu.Game.Rulesets;
 using osu.Game.Tests.Visual;
 using osu.Game.Tournament.IO;
@@ -154,10 +154,10 @@ namespace osu.Game.Tournament.Tests
             }
         };
 
-        public static APIBeatmap CreateSampleBeatmap() =>
-            new APIBeatmap
+        public static TournamentBeatmap CreateSampleBeatmap() =>
+            new TournamentBeatmap
             {
-                BeatmapSet = new APIBeatmapSet
+                Metadata = new BeatmapMetadata
                 {
                     Title = "Test Title",
                     Artist = "Test Artist",
diff --git a/osu.Game.Tournament/Components/SongBar.cs b/osu.Game.Tournament/Components/SongBar.cs
index ecc655da99..a9056166be 100644
--- a/osu.Game.Tournament/Components/SongBar.cs
+++ b/osu.Game.Tournament/Components/SongBar.cs
@@ -14,9 +14,9 @@ using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.Legacy;
 using osu.Game.Extensions;
 using osu.Game.Graphics;
-using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets;
 using osu.Game.Screens.Menu;
+using osu.Game.Tournament.Models;
 using osuTK;
 using osuTK.Graphics;
 
@@ -24,14 +24,14 @@ namespace osu.Game.Tournament.Components
 {
     public class SongBar : CompositeDrawable
     {
-        private APIBeatmap beatmap;
+        private TournamentBeatmap beatmap;
 
         public const float HEIGHT = 145 / 2f;
 
         [Resolved]
         private IBindable<RulesetInfo> ruleset { get; set; }
 
-        public APIBeatmap Beatmap
+        public TournamentBeatmap Beatmap
         {
             set
             {
diff --git a/osu.Game.Tournament/Components/TournamentBeatmapPanel.cs b/osu.Game.Tournament/Components/TournamentBeatmapPanel.cs
index 6416abe8a9..462743cc3d 100644
--- a/osu.Game.Tournament/Components/TournamentBeatmapPanel.cs
+++ b/osu.Game.Tournament/Components/TournamentBeatmapPanel.cs
@@ -14,7 +14,6 @@ using osu.Framework.Graphics.Shapes;
 using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.Drawables;
 using osu.Game.Graphics;
-using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Tournament.Models;
 using osuTK.Graphics;
 
@@ -22,7 +21,7 @@ namespace osu.Game.Tournament.Components
 {
     public class TournamentBeatmapPanel : CompositeDrawable
     {
-        public readonly APIBeatmap Beatmap;
+        public readonly TournamentBeatmap Beatmap;
 
         private readonly string mod;
 
@@ -31,7 +30,7 @@ namespace osu.Game.Tournament.Components
         private readonly Bindable<TournamentMatch> currentMatch = new Bindable<TournamentMatch>();
         private Box flash;
 
-        public TournamentBeatmapPanel(APIBeatmap beatmap, string mod = null)
+        public TournamentBeatmapPanel(TournamentBeatmap beatmap, string mod = null)
         {
             if (beatmap == null) throw new ArgumentNullException(nameof(beatmap));
 
@@ -61,7 +60,7 @@ namespace osu.Game.Tournament.Components
                 {
                     RelativeSizeAxes = Axes.Both,
                     Colour = OsuColour.Gray(0.5f),
-                    OnlineInfo = Beatmap.BeatmapSet,
+                    OnlineInfo = Beatmap,
                 },
                 new FillFlowContainer
                 {
diff --git a/osu.Game.Tournament/IPC/FileBasedIPC.cs b/osu.Game.Tournament/IPC/FileBasedIPC.cs
index 77af3e9b58..ad564c58c3 100644
--- a/osu.Game.Tournament/IPC/FileBasedIPC.cs
+++ b/osu.Game.Tournament/IPC/FileBasedIPC.cs
@@ -96,7 +96,7 @@ namespace osu.Game.Tournament.IPC
                                     else
                                     {
                                         beatmapLookupRequest = new GetBeatmapRequest(new APIBeatmap { OnlineID = beatmapId });
-                                        beatmapLookupRequest.Success += b => Beatmap.Value = b;
+                                        beatmapLookupRequest.Success += b => Beatmap.Value = new TournamentBeatmap(b);
                                         API.Queue(beatmapLookupRequest);
                                     }
                                 }
diff --git a/osu.Game.Tournament/IPC/MatchIPCInfo.cs b/osu.Game.Tournament/IPC/MatchIPCInfo.cs
index ef1e36f871..f438923803 100644
--- a/osu.Game.Tournament/IPC/MatchIPCInfo.cs
+++ b/osu.Game.Tournament/IPC/MatchIPCInfo.cs
@@ -6,13 +6,13 @@
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Game.Beatmaps.Legacy;
-using osu.Game.Online.API.Requests.Responses;
+using osu.Game.Tournament.Models;
 
 namespace osu.Game.Tournament.IPC
 {
     public class MatchIPCInfo : Component
     {
-        public Bindable<APIBeatmap> Beatmap { get; } = new Bindable<APIBeatmap>();
+        public Bindable<TournamentBeatmap> Beatmap { get; } = new Bindable<TournamentBeatmap>();
         public Bindable<LegacyMods> Mods { get; } = new Bindable<LegacyMods>();
         public Bindable<TourneyState> State { get; } = new Bindable<TourneyState>();
         public Bindable<string> ChatChannel { get; } = new Bindable<string>();
diff --git a/osu.Game.Tournament/Models/RoundBeatmap.cs b/osu.Game.Tournament/Models/RoundBeatmap.cs
index 90e31ba352..65ef77e53d 100644
--- a/osu.Game.Tournament/Models/RoundBeatmap.cs
+++ b/osu.Game.Tournament/Models/RoundBeatmap.cs
@@ -4,7 +4,6 @@
 #nullable disable
 
 using Newtonsoft.Json;
-using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Tournament.Models
 {
@@ -14,6 +13,6 @@ namespace osu.Game.Tournament.Models
         public string Mods;
 
         [JsonProperty("BeatmapInfo")]
-        public APIBeatmap Beatmap;
+        public TournamentBeatmap Beatmap;
     }
 }
diff --git a/osu.Game.Tournament/Models/SeedingBeatmap.cs b/osu.Game.Tournament/Models/SeedingBeatmap.cs
index c854488319..03beb7ca9a 100644
--- a/osu.Game.Tournament/Models/SeedingBeatmap.cs
+++ b/osu.Game.Tournament/Models/SeedingBeatmap.cs
@@ -5,7 +5,6 @@
 
 using Newtonsoft.Json;
 using osu.Framework.Bindables;
-using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Tournament.Models
 {
@@ -14,7 +13,7 @@ namespace osu.Game.Tournament.Models
         public int ID;
 
         [JsonProperty("BeatmapInfo")]
-        public APIBeatmap Beatmap;
+        public TournamentBeatmap Beatmap;
 
         public long Score;
 
diff --git a/osu.Game.Tournament/Screens/BeatmapInfoScreen.cs b/osu.Game.Tournament/Screens/BeatmapInfoScreen.cs
index 296267a4bc..763f576afe 100644
--- a/osu.Game.Tournament/Screens/BeatmapInfoScreen.cs
+++ b/osu.Game.Tournament/Screens/BeatmapInfoScreen.cs
@@ -7,9 +7,9 @@ using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Game.Beatmaps.Legacy;
-using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Tournament.Components;
 using osu.Game.Tournament.IPC;
+using osu.Game.Tournament.Models;
 
 namespace osu.Game.Tournament.Screens
 {
@@ -39,7 +39,7 @@ namespace osu.Game.Tournament.Screens
             SongBar.Mods = mods.NewValue;
         }
 
-        private void beatmapChanged(ValueChangedEvent<APIBeatmap> beatmap)
+        private void beatmapChanged(ValueChangedEvent<TournamentBeatmap> beatmap)
         {
             SongBar.FadeInFromZero(300, Easing.OutQuint);
             SongBar.Beatmap = beatmap.NewValue;
diff --git a/osu.Game.Tournament/Screens/Editors/RoundEditorScreen.cs b/osu.Game.Tournament/Screens/Editors/RoundEditorScreen.cs
index 214ae65289..1b670f4b69 100644
--- a/osu.Game.Tournament/Screens/Editors/RoundEditorScreen.cs
+++ b/osu.Game.Tournament/Screens/Editors/RoundEditorScreen.cs
@@ -239,7 +239,7 @@ namespace osu.Game.Tournament.Screens.Editors
 
                             req.Success += res =>
                             {
-                                Model.Beatmap = res;
+                                Model.Beatmap = new TournamentBeatmap(res);
                                 updatePanel();
                             };
 
diff --git a/osu.Game.Tournament/Screens/Editors/SeedingEditorScreen.cs b/osu.Game.Tournament/Screens/Editors/SeedingEditorScreen.cs
index 1377c11225..1bc929604d 100644
--- a/osu.Game.Tournament/Screens/Editors/SeedingEditorScreen.cs
+++ b/osu.Game.Tournament/Screens/Editors/SeedingEditorScreen.cs
@@ -241,7 +241,7 @@ namespace osu.Game.Tournament.Screens.Editors
 
                             req.Success += res =>
                             {
-                                Model.Beatmap = res;
+                                Model.Beatmap = new TournamentBeatmap(res);
                                 updatePanel();
                             };
 
diff --git a/osu.Game.Tournament/Screens/MapPool/MapPoolScreen.cs b/osu.Game.Tournament/Screens/MapPool/MapPoolScreen.cs
index 7ac4510ae5..5eb2142fae 100644
--- a/osu.Game.Tournament/Screens/MapPool/MapPoolScreen.cs
+++ b/osu.Game.Tournament/Screens/MapPool/MapPoolScreen.cs
@@ -11,7 +11,6 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Input.Events;
 using osu.Framework.Threading;
 using osu.Game.Graphics.UserInterface;
-using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Tournament.Components;
 using osu.Game.Tournament.IPC;
 using osu.Game.Tournament.Models;
@@ -107,7 +106,7 @@ namespace osu.Game.Tournament.Screens.MapPool
             ipc.Beatmap.BindValueChanged(beatmapChanged);
         }
 
-        private void beatmapChanged(ValueChangedEvent<APIBeatmap> beatmap)
+        private void beatmapChanged(ValueChangedEvent<TournamentBeatmap> beatmap)
         {
             if (CurrentMatch.Value == null || CurrentMatch.Value.PicksBans.Count(p => p.Type == ChoiceType.Ban) < 2)
                 return;
diff --git a/osu.Game.Tournament/TournamentGameBase.cs b/osu.Game.Tournament/TournamentGameBase.cs
index 2d6d5a01e4..eb04d098f7 100644
--- a/osu.Game.Tournament/TournamentGameBase.cs
+++ b/osu.Game.Tournament/TournamentGameBase.cs
@@ -211,7 +211,7 @@ namespace osu.Game.Tournament
         {
             var beatmapsRequiringPopulation = ladder.Rounds
                                                     .SelectMany(r => r.Beatmaps)
-                                                    .Where(b => string.IsNullOrEmpty(b.Beatmap?.BeatmapSet?.Title) && b.ID > 0).ToList();
+                                                    .Where(b => b.Beatmap?.OnlineID == 0 && b.ID > 0).ToList();
 
             if (beatmapsRequiringPopulation.Count == 0)
                 return false;
@@ -222,7 +222,7 @@ namespace osu.Game.Tournament
 
                 var req = new GetBeatmapRequest(new APIBeatmap { OnlineID = b.ID });
                 API.Perform(req);
-                b.Beatmap = req.Response ?? new APIBeatmap();
+                b.Beatmap = new TournamentBeatmap(req.Response ?? new APIBeatmap());
 
                 updateLoadProgressMessage($"Populating round beatmaps ({i} / {beatmapsRequiringPopulation.Count})");
             }
@@ -238,7 +238,7 @@ namespace osu.Game.Tournament
             var beatmapsRequiringPopulation = ladder.Teams
                                                     .SelectMany(r => r.SeedingResults)
                                                     .SelectMany(r => r.Beatmaps)
-                                                    .Where(b => string.IsNullOrEmpty(b.Beatmap?.BeatmapSet?.Title) && b.ID > 0).ToList();
+                                                    .Where(b => b.Beatmap?.OnlineID == 0 && b.ID > 0).ToList();
 
             if (beatmapsRequiringPopulation.Count == 0)
                 return false;
@@ -249,7 +249,7 @@ namespace osu.Game.Tournament
 
                 var req = new GetBeatmapRequest(new APIBeatmap { OnlineID = b.ID });
                 API.Perform(req);
-                b.Beatmap = req.Response ?? new APIBeatmap();
+                b.Beatmap = new TournamentBeatmap(req.Response ?? new APIBeatmap());
 
                 updateLoadProgressMessage($"Populating seeding beatmaps ({i} / {beatmapsRequiringPopulation.Count})");
             }

From 60903be566c46aeb0481f2b10c1fd5096e8887ac Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sat, 18 Jun 2022 01:46:37 +0300
Subject: [PATCH 5533/5547] Standardise naming for online ID

Rather than continuing with `ID` or `Id`, this should follow the new
standards and use `OnlineID` instead. Only updating this since it's a
newly introduced class.
---
 .../Components/TestSceneTournamentMatchChatDisplay.cs    | 4 ++--
 osu.Game.Tournament/Models/TournamentPlayer.cs           | 9 ++++-----
 osu.Game.Tournament/Screens/Editors/TeamEditorScreen.cs  | 4 ++--
 osu.Game.Tournament/TournamentGameBase.cs                | 6 +++---
 4 files changed, 11 insertions(+), 12 deletions(-)

diff --git a/osu.Game.Tournament.Tests/Components/TestSceneTournamentMatchChatDisplay.cs b/osu.Game.Tournament.Tests/Components/TestSceneTournamentMatchChatDisplay.cs
index 3eac240be5..a95ae4b8ba 100644
--- a/osu.Game.Tournament.Tests/Components/TestSceneTournamentMatchChatDisplay.cs
+++ b/osu.Game.Tournament.Tests/Components/TestSceneTournamentMatchChatDisplay.cs
@@ -30,13 +30,13 @@ namespace osu.Game.Tournament.Tests.Components
         private readonly TournamentPlayer redPlayer = new TournamentPlayer
         {
             Username = "BanchoBot",
-            Id = 3,
+            OnlineID = 3,
         };
 
         private readonly TournamentPlayer bluePlayer = new TournamentPlayer
         {
             Username = "Zallius",
-            Id = 4,
+            OnlineID = 4,
         };
 
         [Cached]
diff --git a/osu.Game.Tournament/Models/TournamentPlayer.cs b/osu.Game.Tournament/Models/TournamentPlayer.cs
index 6fd2f178e1..976936ab07 100644
--- a/osu.Game.Tournament/Models/TournamentPlayer.cs
+++ b/osu.Game.Tournament/Models/TournamentPlayer.cs
@@ -2,7 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
-using osu.Game.Database;
+using Newtonsoft.Json;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Users;
 
@@ -14,7 +14,8 @@ namespace osu.Game.Tournament.Models
     [Serializable]
     public class TournamentPlayer : IUser
     {
-        public int Id { get; set; }
+        [JsonProperty(@"id")]
+        public int OnlineID { get; set; }
 
         public string Username { get; set; } = string.Empty;
 
@@ -37,7 +38,7 @@ namespace osu.Game.Tournament.Models
         {
             var user = new APIUser
             {
-                Id = Id,
+                Id = OnlineID,
                 Username = Username,
                 Country = Country,
                 CoverUrl = CoverUrl,
@@ -52,8 +53,6 @@ namespace osu.Game.Tournament.Models
             return user;
         }
 
-        int IHasOnlineID<int>.OnlineID => Id;
-
         bool IUser.IsBot => false;
     }
 }
diff --git a/osu.Game.Tournament/Screens/Editors/TeamEditorScreen.cs b/osu.Game.Tournament/Screens/Editors/TeamEditorScreen.cs
index 942f861770..f29c45c949 100644
--- a/osu.Game.Tournament/Screens/Editors/TeamEditorScreen.cs
+++ b/osu.Game.Tournament/Screens/Editors/TeamEditorScreen.cs
@@ -280,10 +280,10 @@ namespace osu.Game.Tournament.Screens.Editors
                     [BackgroundDependencyLoader]
                     private void load()
                     {
-                        playerId.Value = player.Id;
+                        playerId.Value = player.OnlineID;
                         playerId.BindValueChanged(id =>
                         {
-                            player.Id = id.NewValue ?? 0;
+                            player.OnlineID = id.NewValue ?? 0;
 
                             if (id.NewValue != id.OldValue)
                                 player.Username = string.Empty;
diff --git a/osu.Game.Tournament/TournamentGameBase.cs b/osu.Game.Tournament/TournamentGameBase.cs
index 3fa6bca0be..f53e36a61e 100644
--- a/osu.Game.Tournament/TournamentGameBase.cs
+++ b/osu.Game.Tournament/TournamentGameBase.cs
@@ -258,7 +258,7 @@ namespace osu.Game.Tournament
 
         public void PopulatePlayer(TournamentPlayer player, Action success = null, Action failure = null, bool immediate = false)
         {
-            var req = new GetUserRequest(player.Id, ladder.Ruleset.Value);
+            var req = new GetUserRequest(player.OnlineID, ladder.Ruleset.Value);
 
             if (immediate)
             {
@@ -270,7 +270,7 @@ namespace osu.Game.Tournament
                 req.Success += res => { populate(); };
                 req.Failure += _ =>
                 {
-                    player.Id = 1;
+                    player.OnlineID = 1;
                     failure?.Invoke();
                 };
 
@@ -284,7 +284,7 @@ namespace osu.Game.Tournament
                 if (res == null)
                     return;
 
-                player.Id = res.Id;
+                player.OnlineID = res.Id;
 
                 player.Username = res.Username;
                 player.CoverUrl = res.CoverUrl;

From 4c47996130de73ed0d4f87be47c4e65c064111ed Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sat, 18 Jun 2022 02:33:26 +0300
Subject: [PATCH 5534/5547] `TournamentPlayer` -> `TournamentUser`

---
 .../TestSceneDrawableTournamentTeam.cs        | 14 ++++++------
 .../TestSceneTournamentMatchChatDisplay.cs    | 14 ++++++------
 .../TournamentTestScene.cs                    | 20 ++++++++---------
 .../Components/DrawableTeamWithPlayers.cs     |  2 +-
 osu.Game.Tournament/Models/TournamentTeam.cs  |  2 +-
 ...{TournamentPlayer.cs => TournamentUser.cs} |  6 ++---
 .../Screens/Editors/TeamEditorScreen.cs       | 22 +++++++++----------
 osu.Game.Tournament/TournamentGameBase.cs     | 16 +++++++-------
 8 files changed, 48 insertions(+), 48 deletions(-)
 rename osu.Game.Tournament/Models/{TournamentPlayer.cs => TournamentUser.cs} (89%)

diff --git a/osu.Game.Tournament.Tests/Components/TestSceneDrawableTournamentTeam.cs b/osu.Game.Tournament.Tests/Components/TestSceneDrawableTournamentTeam.cs
index 3cf65b1990..4ea7e8008a 100644
--- a/osu.Game.Tournament.Tests/Components/TestSceneDrawableTournamentTeam.cs
+++ b/osu.Game.Tournament.Tests/Components/TestSceneDrawableTournamentTeam.cs
@@ -25,13 +25,13 @@ namespace osu.Game.Tournament.Tests.Components
                 FullName = { Value = "Australia" },
                 Players =
                 {
-                    new TournamentPlayer { Username = "ASecretBox" },
-                    new TournamentPlayer { Username = "Dereban" },
-                    new TournamentPlayer { Username = "mReKk" },
-                    new TournamentPlayer { Username = "uyghti" },
-                    new TournamentPlayer { Username = "Parkes" },
-                    new TournamentPlayer { Username = "Shiroha" },
-                    new TournamentPlayer { Username = "Jordan The Bear" },
+                    new TournamentUser { Username = "ASecretBox" },
+                    new TournamentUser { Username = "Dereban" },
+                    new TournamentUser { Username = "mReKk" },
+                    new TournamentUser { Username = "uyghti" },
+                    new TournamentUser { Username = "Parkes" },
+                    new TournamentUser { Username = "Shiroha" },
+                    new TournamentUser { Username = "Jordan The Bear" },
                 }
             };
 
diff --git a/osu.Game.Tournament.Tests/Components/TestSceneTournamentMatchChatDisplay.cs b/osu.Game.Tournament.Tests/Components/TestSceneTournamentMatchChatDisplay.cs
index a95ae4b8ba..eb8b0dfbe6 100644
--- a/osu.Game.Tournament.Tests/Components/TestSceneTournamentMatchChatDisplay.cs
+++ b/osu.Game.Tournament.Tests/Components/TestSceneTournamentMatchChatDisplay.cs
@@ -27,13 +27,13 @@ namespace osu.Game.Tournament.Tests.Components
             Colour = "f2ca34"
         };
 
-        private readonly TournamentPlayer redPlayer = new TournamentPlayer
+        private readonly TournamentUser redUser = new TournamentUser
         {
             Username = "BanchoBot",
             OnlineID = 3,
         };
 
-        private readonly TournamentPlayer bluePlayer = new TournamentPlayer
+        private readonly TournamentUser blueUser = new TournamentUser
         {
             Username = "Zallius",
             OnlineID = 4,
@@ -59,11 +59,11 @@ namespace osu.Game.Tournament.Tests.Components
             {
                 Team1 =
                 {
-                    Value = new TournamentTeam { Players = new BindableList<TournamentPlayer> { redPlayer } }
+                    Value = new TournamentTeam { Players = new BindableList<TournamentUser> { redUser } }
                 },
                 Team2 =
                 {
-                    Value = new TournamentTeam { Players = new BindableList<TournamentPlayer> { bluePlayer } }
+                    Value = new TournamentTeam { Players = new BindableList<TournamentUser> { blueUser } }
                 }
             };
 
@@ -82,19 +82,19 @@ namespace osu.Game.Tournament.Tests.Components
 
             AddStep("message from team red", () => testChannel.AddNewMessages(new Message(nextMessageId())
             {
-                Sender = redPlayer.ToUser(),
+                Sender = redUser.ToAPIUser(),
                 Content = "I am team red."
             }));
 
             AddStep("message from team red", () => testChannel.AddNewMessages(new Message(nextMessageId())
             {
-                Sender = redPlayer.ToUser(),
+                Sender = redUser.ToAPIUser(),
                 Content = "I plan to win!"
             }));
 
             AddStep("message from team blue", () => testChannel.AddNewMessages(new Message(nextMessageId())
             {
-                Sender = bluePlayer.ToUser(),
+                Sender = blueUser.ToAPIUser(),
                 Content = "Not on my watch. Prepare to eat saaaaaaaaaand. Lots and lots of saaaaaaand."
             }));
 
diff --git a/osu.Game.Tournament.Tests/TournamentTestScene.cs b/osu.Game.Tournament.Tests/TournamentTestScene.cs
index 47ab3023e4..ea7d6e7827 100644
--- a/osu.Game.Tournament.Tests/TournamentTestScene.cs
+++ b/osu.Game.Tournament.Tests/TournamentTestScene.cs
@@ -121,11 +121,11 @@ namespace osu.Game.Tournament.Tests
                     },
                     Players =
                     {
-                        new TournamentPlayer { Username = "Hello", Rank = 12 },
-                        new TournamentPlayer { Username = "Hello", Rank = 16 },
-                        new TournamentPlayer { Username = "Hello", Rank = 20 },
-                        new TournamentPlayer { Username = "Hello", Rank = 24 },
-                        new TournamentPlayer { Username = "Hello", Rank = 30 },
+                        new TournamentUser { Username = "Hello", Rank = 12 },
+                        new TournamentUser { Username = "Hello", Rank = 16 },
+                        new TournamentUser { Username = "Hello", Rank = 20 },
+                        new TournamentUser { Username = "Hello", Rank = 24 },
+                        new TournamentUser { Username = "Hello", Rank = 30 },
                     }
                 }
             },
@@ -138,11 +138,11 @@ namespace osu.Game.Tournament.Tests
                     FullName = { Value = "United States" },
                     Players =
                     {
-                        new TournamentPlayer { Username = "Hello" },
-                        new TournamentPlayer { Username = "Hello" },
-                        new TournamentPlayer { Username = "Hello" },
-                        new TournamentPlayer { Username = "Hello" },
-                        new TournamentPlayer { Username = "Hello" },
+                        new TournamentUser { Username = "Hello" },
+                        new TournamentUser { Username = "Hello" },
+                        new TournamentUser { Username = "Hello" },
+                        new TournamentUser { Username = "Hello" },
+                        new TournamentUser { Username = "Hello" },
                     }
                 }
             },
diff --git a/osu.Game.Tournament/Components/DrawableTeamWithPlayers.cs b/osu.Game.Tournament/Components/DrawableTeamWithPlayers.cs
index fd62c53741..0bb35d534c 100644
--- a/osu.Game.Tournament/Components/DrawableTeamWithPlayers.cs
+++ b/osu.Game.Tournament/Components/DrawableTeamWithPlayers.cs
@@ -55,7 +55,7 @@ namespace osu.Game.Tournament.Components
                 },
             };
 
-            TournamentSpriteText createPlayerText(TournamentPlayer p) =>
+            TournamentSpriteText createPlayerText(TournamentUser p) =>
                 new TournamentSpriteText
                 {
                     Text = p.Username,
diff --git a/osu.Game.Tournament/Models/TournamentTeam.cs b/osu.Game.Tournament/Models/TournamentTeam.cs
index 420b47da66..9dbe23b4b3 100644
--- a/osu.Game.Tournament/Models/TournamentTeam.cs
+++ b/osu.Game.Tournament/Models/TournamentTeam.cs
@@ -58,7 +58,7 @@ namespace osu.Game.Tournament.Models
         };
 
         [JsonProperty]
-        public BindableList<TournamentPlayer> Players { get; set; } = new BindableList<TournamentPlayer>();
+        public BindableList<TournamentUser> Players { get; set; } = new BindableList<TournamentUser>();
 
         public TournamentTeam()
         {
diff --git a/osu.Game.Tournament/Models/TournamentPlayer.cs b/osu.Game.Tournament/Models/TournamentUser.cs
similarity index 89%
rename from osu.Game.Tournament/Models/TournamentPlayer.cs
rename to osu.Game.Tournament/Models/TournamentUser.cs
index 976936ab07..80e58538e5 100644
--- a/osu.Game.Tournament/Models/TournamentPlayer.cs
+++ b/osu.Game.Tournament/Models/TournamentUser.cs
@@ -9,10 +9,10 @@ using osu.Game.Users;
 namespace osu.Game.Tournament.Models
 {
     /// <summary>
-    /// A tournament player, containing simple information about the player.
+    /// A tournament player user, containing simple information about the player.
     /// </summary>
     [Serializable]
-    public class TournamentPlayer : IUser
+    public class TournamentUser : IUser
     {
         [JsonProperty(@"id")]
         public int OnlineID { get; set; }
@@ -34,7 +34,7 @@ namespace osu.Game.Tournament.Models
         /// </summary>
         public string CoverUrl { get; set; } = string.Empty;
 
-        public APIUser ToUser()
+        public APIUser ToAPIUser()
         {
             var user = new APIUser
             {
diff --git a/osu.Game.Tournament/Screens/Editors/TeamEditorScreen.cs b/osu.Game.Tournament/Screens/Editors/TeamEditorScreen.cs
index f29c45c949..11db37c8b7 100644
--- a/osu.Game.Tournament/Screens/Editors/TeamEditorScreen.cs
+++ b/osu.Game.Tournament/Screens/Editors/TeamEditorScreen.cs
@@ -201,14 +201,14 @@ namespace osu.Game.Tournament.Screens.Editors
 
                 public void CreateNew()
                 {
-                    var player = new TournamentPlayer();
+                    var player = new TournamentUser();
                     team.Players.Add(player);
                     flow.Add(new PlayerRow(team, player));
                 }
 
                 public class PlayerRow : CompositeDrawable
                 {
-                    private readonly TournamentPlayer player;
+                    private readonly TournamentUser user;
 
                     [Resolved]
                     protected IAPIProvider API { get; private set; }
@@ -220,9 +220,9 @@ namespace osu.Game.Tournament.Screens.Editors
 
                     private readonly Container drawableContainer;
 
-                    public PlayerRow(TournamentTeam team, TournamentPlayer player)
+                    public PlayerRow(TournamentTeam team, TournamentUser user)
                     {
-                        this.player = player;
+                        this.user = user;
 
                         Margin = new MarginPadding(10);
 
@@ -271,7 +271,7 @@ namespace osu.Game.Tournament.Screens.Editors
                                 Action = () =>
                                 {
                                     Expire();
-                                    team.Players.Remove(player);
+                                    team.Players.Remove(user);
                                 },
                             }
                         };
@@ -280,27 +280,27 @@ namespace osu.Game.Tournament.Screens.Editors
                     [BackgroundDependencyLoader]
                     private void load()
                     {
-                        playerId.Value = player.OnlineID;
+                        playerId.Value = user.OnlineID;
                         playerId.BindValueChanged(id =>
                         {
-                            player.OnlineID = id.NewValue ?? 0;
+                            user.OnlineID = id.NewValue ?? 0;
 
                             if (id.NewValue != id.OldValue)
-                                player.Username = string.Empty;
+                                user.Username = string.Empty;
 
-                            if (!string.IsNullOrEmpty(player.Username))
+                            if (!string.IsNullOrEmpty(user.Username))
                             {
                                 updatePanel();
                                 return;
                             }
 
-                            game.PopulatePlayer(player, updatePanel, updatePanel);
+                            game.PopulatePlayer(user, updatePanel, updatePanel);
                         }, true);
                     }
 
                     private void updatePanel()
                     {
-                        drawableContainer.Child = new UserGridPanel(player.ToUser()) { Width = 300 };
+                        drawableContainer.Child = new UserGridPanel(user.ToAPIUser()) { Width = 300 };
                     }
                 }
             }
diff --git a/osu.Game.Tournament/TournamentGameBase.cs b/osu.Game.Tournament/TournamentGameBase.cs
index f53e36a61e..a8d4abc5f4 100644
--- a/osu.Game.Tournament/TournamentGameBase.cs
+++ b/osu.Game.Tournament/TournamentGameBase.cs
@@ -256,9 +256,9 @@ namespace osu.Game.Tournament
 
         private void updateLoadProgressMessage(string s) => Schedule(() => initialisationText.Text = s);
 
-        public void PopulatePlayer(TournamentPlayer player, Action success = null, Action failure = null, bool immediate = false)
+        public void PopulatePlayer(TournamentUser user, Action success = null, Action failure = null, bool immediate = false)
         {
-            var req = new GetUserRequest(player.OnlineID, ladder.Ruleset.Value);
+            var req = new GetUserRequest(user.OnlineID, ladder.Ruleset.Value);
 
             if (immediate)
             {
@@ -270,7 +270,7 @@ namespace osu.Game.Tournament
                 req.Success += res => { populate(); };
                 req.Failure += _ =>
                 {
-                    player.OnlineID = 1;
+                    user.OnlineID = 1;
                     failure?.Invoke();
                 };
 
@@ -284,12 +284,12 @@ namespace osu.Game.Tournament
                 if (res == null)
                     return;
 
-                player.OnlineID = res.Id;
+                user.OnlineID = res.Id;
 
-                player.Username = res.Username;
-                player.CoverUrl = res.CoverUrl;
-                player.Country = res.Country;
-                player.Rank = res.Statistics?.GlobalRank;
+                user.Username = res.Username;
+                user.CoverUrl = res.CoverUrl;
+                user.Country = res.Country;
+                user.Rank = res.Statistics?.GlobalRank;
 
                 success?.Invoke();
             }

From 14cdb01fd8f90ce77ceedc45d412049457d3b6ce Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Sat, 18 Jun 2022 08:49:48 +0900
Subject: [PATCH 5535/5547] Revert unintended change

---
 osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs | 8 +++-----
 1 file changed, 3 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs b/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs
index ae1ac5fa47..a3423d4189 100644
--- a/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/OnlineMultiplayerClient.cs
@@ -202,16 +202,14 @@ namespace osu.Game.Online.Multiplayer
             return connection.InvokeAsync(nameof(IMultiplayerServer.AddPlaylistItem), item);
         }
 
-        public override async Task EditPlaylistItem(MultiplayerPlaylistItem item)
+        public override Task EditPlaylistItem(MultiplayerPlaylistItem item)
         {
             if (!IsConnected.Value)
-                return;
+                return Task.CompletedTask;
 
             Debug.Assert(connection != null);
 
-            await Task.Delay(10000);
-
-            await connection.InvokeAsync(nameof(IMultiplayerServer.EditPlaylistItem), item);
+            return connection.InvokeAsync(nameof(IMultiplayerServer.EditPlaylistItem), item);
         }
 
         public override Task RemovePlaylistItem(long playlistItemId)

From 8a1d11fefb58e51e27c98e1d31c6d785dfac263b Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sat, 18 Jun 2022 04:07:21 +0300
Subject: [PATCH 5536/5547] Cancel previous metronome sound playback on pause

---
 osu.Game/Screens/Edit/Timing/MetronomeDisplay.cs | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Edit/Timing/MetronomeDisplay.cs b/osu.Game/Screens/Edit/Timing/MetronomeDisplay.cs
index 270d544dcf..181f1ecb47 100644
--- a/osu.Game/Screens/Edit/Timing/MetronomeDisplay.cs
+++ b/osu.Game/Screens/Edit/Timing/MetronomeDisplay.cs
@@ -4,6 +4,7 @@
 #nullable disable
 
 using System;
+using JetBrains.Annotations;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
 using osu.Framework.Audio.Sample;
@@ -14,6 +15,7 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Colour;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
+using osu.Framework.Threading;
 using osu.Framework.Timing;
 using osu.Framework.Utils;
 using osu.Game.Beatmaps.ControlPoints;
@@ -37,6 +39,9 @@ namespace osu.Game.Screens.Edit.Timing
 
         private Sample clunk;
 
+        [CanBeNull]
+        private ScheduledDelegate clunkDelegate;
+
         [Resolved]
         private OverlayColourProvider overlayColourProvider { get; set; }
 
@@ -258,6 +263,9 @@ namespace osu.Game.Screens.Edit.Timing
                 }
 
                 isSwinging = false;
+
+                clunkDelegate?.Cancel();
+                clunkDelegate = null;
             }
         }
 
@@ -283,7 +291,7 @@ namespace osu.Game.Screens.Edit.Timing
                 {
                     stick.FlashColour(overlayColourProvider.Content1, beatLength, Easing.OutQuint);
 
-                    Schedule(() =>
+                    clunkDelegate = Schedule(() =>
                     {
                         if (!EnableClicking)
                             return;

From bd5037fcad4c94cd5511f4f3146d43f2f3b76c56 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 18 Jun 2022 13:49:57 +0900
Subject: [PATCH 5537/5547] Fix new hitobject placements not taking on the
 existing sample settings

Similar to velocity / difficulty points, a user expectation is that
volume and sample settings will be transferred to newly placed objects
from the most recent one.

Closes https://github.com/ppy/osu/issues/18742.
---
 osu.Game/Rulesets/Edit/PlacementBlueprint.cs | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/osu.Game/Rulesets/Edit/PlacementBlueprint.cs b/osu.Game/Rulesets/Edit/PlacementBlueprint.cs
index 26dd6db016..3e93e576ba 100644
--- a/osu.Game/Rulesets/Edit/PlacementBlueprint.cs
+++ b/osu.Game/Rulesets/Edit/PlacementBlueprint.cs
@@ -3,6 +3,7 @@
 
 #nullable disable
 
+using System.Linq;
 using System.Threading;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
@@ -73,6 +74,10 @@ namespace osu.Game.Rulesets.Edit
         /// <param name="commitStart">Whether this call is committing a value for HitObject.StartTime and continuing with further adjustments.</param>
         protected void BeginPlacement(bool commitStart = false)
         {
+            var nearestSampleControlPoint = beatmap.HitObjects.LastOrDefault(h => h.GetEndTime() < HitObject.StartTime)?.SampleControlPoint?.DeepClone() as SampleControlPoint;
+
+            HitObject.SampleControlPoint = nearestSampleControlPoint ?? new SampleControlPoint();
+
             placementHandler.BeginPlacement(HitObject);
             if (commitStart)
                 PlacementActive = PlacementState.Active;

From 77e7e4ecb21a67ae685491507959f3e5491f499a Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Sat, 18 Jun 2022 14:28:25 +0900
Subject: [PATCH 5538/5547] Fix selection being blocked after early return

---
 .../Multiplayer/MultiplayerMatchSongSelect.cs      |  6 ++++--
 .../Screens/OnlinePlay/OnlinePlaySongSelect.cs     | 14 +++++++++-----
 .../OnlinePlay/Playlists/PlaylistsSongSelect.cs    |  3 ++-
 3 files changed, 15 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs
index 1f27a831ca..0f589a8b35 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerMatchSongSelect.cs
@@ -75,10 +75,10 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
                 loadingLayer.Hide();
         }
 
-        protected override void SelectItem(PlaylistItem item)
+        protected override bool SelectItem(PlaylistItem item)
         {
             if (operationInProgress.Value)
-                return;
+                return false;
 
             // If the client is already in a room, update via the client.
             // Otherwise, update the playlist directly in preparation for it to be submitted to the API on match creation.
@@ -124,6 +124,8 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
                 Playlist.Add(item);
                 this.Exit();
             }
+
+            return true;
         }
 
         protected override BeatmapDetailArea CreateBeatmapDetailArea() => new PlayBeatmapDetailArea();
diff --git a/osu.Game/Screens/OnlinePlay/OnlinePlaySongSelect.cs b/osu.Game/Screens/OnlinePlay/OnlinePlaySongSelect.cs
index 1552811c74..f26480909e 100644
--- a/osu.Game/Screens/OnlinePlay/OnlinePlaySongSelect.cs
+++ b/osu.Game/Screens/OnlinePlay/OnlinePlaySongSelect.cs
@@ -118,8 +118,6 @@ namespace osu.Game.Screens.OnlinePlay
 
         protected sealed override bool OnStart()
         {
-            itemSelected = true;
-
             var item = new PlaylistItem(Beatmap.Value.BeatmapInfo)
             {
                 RulesetID = Ruleset.Value.OnlineID,
@@ -127,15 +125,21 @@ namespace osu.Game.Screens.OnlinePlay
                 AllowedMods = FreeMods.Value.Select(m => new APIMod(m)).ToArray()
             };
 
-            SelectItem(item);
-            return true;
+            if (SelectItem(item))
+            {
+                itemSelected = true;
+                return true;
+            }
+
+            return false;
         }
 
         /// <summary>
         /// Invoked when the user has requested a selection of a beatmap.
         /// </summary>
         /// <param name="item">The resultant <see cref="PlaylistItem"/>. This item has not yet been added to the <see cref="Room"/>'s.</param>
-        protected abstract void SelectItem(PlaylistItem item);
+        /// <returns><c>true</c> if a selection occurred.</returns>
+        protected abstract bool SelectItem(PlaylistItem item);
 
         public override bool OnBackButton()
         {
diff --git a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsSongSelect.cs b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsSongSelect.cs
index 65a27a9261..73765fc661 100644
--- a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsSongSelect.cs
+++ b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsSongSelect.cs
@@ -24,7 +24,7 @@ namespace osu.Game.Screens.OnlinePlay.Playlists
             CreateNewItem = createNewItem
         };
 
-        protected override void SelectItem(PlaylistItem item)
+        protected override bool SelectItem(PlaylistItem item)
         {
             switch (Playlist.Count)
             {
@@ -39,6 +39,7 @@ namespace osu.Game.Screens.OnlinePlay.Playlists
             }
 
             this.Exit();
+            return true;
         }
 
         private void createNewItem()

From 56abe54fe6331f88c014baf7e34128bc070e8cec Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 18 Jun 2022 22:59:19 +0900
Subject: [PATCH 5539/5547] Redirect graceful exiting to standard exit flow

Rather than doing a completely forced exit as we were, this will now
follow a more standard flow with the ability for the user to abort along
the way. This is more in line with how I wanted this to work.

Note that this means a confirmation is now shown. It has been discussed
in the past that this confirmation should only show when there's an
ongoing action implies the user may want to cancel the exit. For now I
think this is fine.

Addresses
https://github.com/ppy/osu/discussions/18399#discussioncomment-2811311
---
 osu.Game/OsuGame.cs     | 6 ++++++
 osu.Game/OsuGameBase.cs | 2 +-
 2 files changed, 7 insertions(+), 1 deletion(-)

diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index 3041761a6b..06ade5a3c9 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -637,6 +637,12 @@ namespace osu.Game
             Add(performFromMainMenuTask = new PerformFromMenuRunner(action, validScreens, () => ScreenStack.CurrentScreen));
         }
 
+        public override void GracefullyExit()
+        {
+            // Using PerformFromScreen gives the user a chance to interrupt the exit process if needed.
+            PerformFromScreen(menu => menu.Exit());
+        }
+
         /// <summary>
         /// Wait for the game (and target component) to become loaded and then run an action.
         /// </summary>
diff --git a/osu.Game/OsuGameBase.cs b/osu.Game/OsuGameBase.cs
index 9908697bf1..dc7513d3c8 100644
--- a/osu.Game/OsuGameBase.cs
+++ b/osu.Game/OsuGameBase.cs
@@ -419,7 +419,7 @@ namespace osu.Game
         /// Use to programatically exit the game as if the user was triggering via alt-f4.
         /// Will keep persisting until an exit occurs (exit may be blocked multiple times).
         /// </summary>
-        public void GracefullyExit()
+        public virtual void GracefullyExit()
         {
             if (!OnExiting())
                 Exit();

From a5e5172b916a1798f3b131731e48ff1b5a1a965e Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sat, 18 Jun 2022 18:28:36 +0300
Subject: [PATCH 5540/5547] Fix `BlueprintContainer` eating input from skin
 editor buttons

---
 .../Screens/Edit/Compose/Components/BlueprintContainer.cs  | 7 -------
 .../Edit/Compose/Components/ComposeBlueprintContainer.cs   | 6 ++++++
 .../Screens/Edit/Compose/Components/SelectionHandler.cs    | 4 +++-
 .../Components/Timeline/TimelineBlueprintContainer.cs      | 6 ++++++
 4 files changed, 15 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Screens/Edit/Compose/Components/BlueprintContainer.cs b/osu.Game/Screens/Edit/Compose/Components/BlueprintContainer.cs
index c7bf23865b..d38aac1173 100644
--- a/osu.Game/Screens/Edit/Compose/Components/BlueprintContainer.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/BlueprintContainer.cs
@@ -108,13 +108,6 @@ namespace osu.Game.Screens.Edit.Compose.Components
         /// </summary>
         protected virtual bool AllowDeselectionDuringDrag => true;
 
-        /// <remarks>
-        /// Positional input must be received outside the container's bounds,
-        /// in order to handle blueprints which are partially offscreen.
-        /// </remarks>
-        /// <seealso cref="SelectionHandler{T}.ReceivePositionalInputAt"/>
-        public override bool ReceivePositionalInputAt(Vector2 screenSpacePos) => true;
-
         protected override bool OnMouseDown(MouseDownEvent e)
         {
             bool selectionPerformed = performMouseDownActions(e);
diff --git a/osu.Game/Screens/Edit/Compose/Components/ComposeBlueprintContainer.cs b/osu.Game/Screens/Edit/Compose/Components/ComposeBlueprintContainer.cs
index ba43704a5f..4c37d200bc 100644
--- a/osu.Game/Screens/Edit/Compose/Components/ComposeBlueprintContainer.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/ComposeBlueprintContainer.cs
@@ -39,6 +39,12 @@ namespace osu.Game.Screens.Edit.Compose.Components
         private PlacementBlueprint currentPlacement;
         private InputManager inputManager;
 
+        /// <remarks>
+        /// Positional input must be received outside the container's bounds,
+        /// in order to handle composer blueprints which are partially offscreen.
+        /// </remarks>
+        public override bool ReceivePositionalInputAt(Vector2 screenSpacePos) => true;
+
         public ComposeBlueprintContainer(HitObjectComposer composer)
             : base(composer)
         {
diff --git a/osu.Game/Screens/Edit/Compose/Components/SelectionHandler.cs b/osu.Game/Screens/Edit/Compose/Components/SelectionHandler.cs
index 96bd352cf9..91af3fde16 100644
--- a/osu.Game/Screens/Edit/Compose/Components/SelectionHandler.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/SelectionHandler.cs
@@ -21,6 +21,7 @@ using osu.Game.Graphics.UserInterface;
 using osu.Game.Input.Bindings;
 using osu.Game.Resources.Localisation.Web;
 using osu.Game.Rulesets.Edit;
+using osu.Game.Screens.Edit.Compose.Components.Timeline;
 using osuTK;
 using osuTK.Input;
 
@@ -103,7 +104,8 @@ namespace osu.Game.Screens.Edit.Compose.Components
         /// Positional input must be received outside the container's bounds,
         /// in order to handle blueprints which are partially offscreen.
         /// </remarks>
-        /// <seealso cref="BlueprintContainer{T}.ReceivePositionalInputAt"/>
+        /// <seealso cref="ComposeBlueprintContainer.ReceivePositionalInputAt"/>
+        /// <seealso cref="TimelineBlueprintContainer.ReceivePositionalInputAt"/>
         public override bool ReceivePositionalInputAt(Vector2 screenSpacePos) => true;
 
         /// <summary>
diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineBlueprintContainer.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineBlueprintContainer.cs
index 138e28fa06..742e16d5a9 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineBlueprintContainer.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineBlueprintContainer.cs
@@ -35,6 +35,12 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
         private Bindable<HitObject> placement;
         private SelectionBlueprint<HitObject> placementBlueprint;
 
+        /// <remarks>
+        /// Positional input must be received outside the container's bounds,
+        /// in order to handle timeline blueprints which are stacked offscreen.
+        /// </remarks>
+        public override bool ReceivePositionalInputAt(Vector2 screenSpacePos) => timeline.ReceivePositionalInputAt(screenSpacePos);
+
         public TimelineBlueprintContainer(HitObjectComposer composer)
             : base(composer)
         {

From 47ce087694fc9c2d0fa3ec81442ed5a171b016f8 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sat, 18 Jun 2022 18:32:02 +0300
Subject: [PATCH 5541/5547] Actually click the gameplay scene button than
 `TriggerClick`

---
 .../Visual/Navigation/TestSceneSkinEditorNavigation.cs      | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneSkinEditorNavigation.cs b/osu.Game.Tests/Visual/Navigation/TestSceneSkinEditorNavigation.cs
index 78ab7947a7..7d9c08d3d2 100644
--- a/osu.Game.Tests/Visual/Navigation/TestSceneSkinEditorNavigation.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneSkinEditorNavigation.cs
@@ -148,7 +148,11 @@ namespace osu.Game.Tests.Visual.Navigation
 
         private void switchToGameplayScene()
         {
-            AddStep("Click gameplay scene button", () => skinEditor.ChildrenOfType<SkinEditorSceneLibrary.SceneButton>().First(b => b.Text == "Gameplay").TriggerClick());
+            AddStep("Click gameplay scene button", () =>
+            {
+                InputManager.MoveMouseTo(skinEditor.ChildrenOfType<SkinEditorSceneLibrary.SceneButton>().First(b => b.Text == "Gameplay"));
+                InputManager.Click(MouseButton.Left);
+            });
 
             AddUntilStep("wait for player", () =>
             {

From b2663d9399fd5b9fd75fef0a4bdf13a33ae29632 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 19 Jun 2022 01:14:48 +0900
Subject: [PATCH 5542/5547] Update xmldoc to suggest that `GracefullyExit` may
 be overridden

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

diff --git a/osu.Game/OsuGameBase.cs b/osu.Game/OsuGameBase.cs
index dc7513d3c8..4a9f74d195 100644
--- a/osu.Game/OsuGameBase.cs
+++ b/osu.Game/OsuGameBase.cs
@@ -417,7 +417,7 @@ namespace osu.Game
 
         /// <summary>
         /// Use to programatically exit the game as if the user was triggering via alt-f4.
-        /// Will keep persisting until an exit occurs (exit may be blocked multiple times).
+        /// By default, will keep persisting until an exit occurs (exit may be blocked multiple times).
         /// </summary>
         public virtual void GracefullyExit()
         {

From 3902dc64f0fee5a49def28062b769ef370187d0e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 19 Jun 2022 01:34:58 +0900
Subject: [PATCH 5543/5547] Fix adjusting offset via button seeking to timing
 point's offset unexpectedly

This was added with the intention of tracking the offset when already at
the start (the most common case when you're using the tap timing
wizard), but was also seeking when the user may be much further beyond
or before it.

Addresses https://github.com/ppy/osu/discussions/18741#discussioncomment-2975051.
---
 osu.Game/Screens/Edit/Timing/TapTimingControl.cs | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Edit/Timing/TapTimingControl.cs b/osu.Game/Screens/Edit/Timing/TapTimingControl.cs
index 53c92bac20..abc73851e4 100644
--- a/osu.Game/Screens/Edit/Timing/TapTimingControl.cs
+++ b/osu.Game/Screens/Edit/Timing/TapTimingControl.cs
@@ -195,6 +195,8 @@ namespace osu.Game.Screens.Edit.Timing
 
         private void adjustOffset(double adjust)
         {
+            bool wasAtStart = editorClock.CurrentTimeAccurate == selectedGroup.Value.Time;
+
             // VERY TEMPORARY
             var currentGroupItems = selectedGroup.Value.ControlPoints.ToArray();
 
@@ -208,7 +210,7 @@ namespace osu.Game.Screens.Edit.Timing
             // the control point might not necessarily exist yet, if currentGroupItems was empty.
             selectedGroup.Value = beatmap.ControlPointInfo.GroupAt(newOffset, true);
 
-            if (!editorClock.IsRunning)
+            if (!editorClock.IsRunning && wasAtStart)
                 editorClock.Seek(newOffset);
         }
 

From 50e40756c462318ddebb812fe317c57ec1a4de70 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 19 Jun 2022 12:34:14 +0900
Subject: [PATCH 5544/5547] Rename `GracefullyExit` to `AttemptExit`

---
 osu.Desktop/Updater/SquirrelUpdateManager.cs                 | 2 +-
 osu.Game.Tournament/Screens/Setup/TournamentSwitcher.cs      | 2 +-
 osu.Game/OsuGame.cs                                          | 2 +-
 osu.Game/OsuGameBase.cs                                      | 5 +++--
 .../Settings/Sections/Maintenance/MigrationSelectScreen.cs   | 2 +-
 5 files changed, 7 insertions(+), 6 deletions(-)

diff --git a/osu.Desktop/Updater/SquirrelUpdateManager.cs b/osu.Desktop/Updater/SquirrelUpdateManager.cs
index 59bc2dabb2..4e5f8d37b1 100644
--- a/osu.Desktop/Updater/SquirrelUpdateManager.cs
+++ b/osu.Desktop/Updater/SquirrelUpdateManager.cs
@@ -154,7 +154,7 @@ namespace osu.Desktop.Updater
                 Activated = () =>
                 {
                     updateManager.PrepareUpdateAsync()
-                                 .ContinueWith(_ => updateManager.Schedule(() => game?.GracefullyExit()));
+                                 .ContinueWith(_ => updateManager.Schedule(() => game?.AttemptExit()));
                     return true;
                 };
             }
diff --git a/osu.Game.Tournament/Screens/Setup/TournamentSwitcher.cs b/osu.Game.Tournament/Screens/Setup/TournamentSwitcher.cs
index fb33b3662a..447d6f44ce 100644
--- a/osu.Game.Tournament/Screens/Setup/TournamentSwitcher.cs
+++ b/osu.Game.Tournament/Screens/Setup/TournamentSwitcher.cs
@@ -27,7 +27,7 @@ namespace osu.Game.Tournament.Screens.Setup
             dropdown.Items = storage.ListTournaments();
             dropdown.Current.BindValueChanged(v => Button.Enabled.Value = v.NewValue != startupTournament, true);
 
-            Action = () => game.GracefullyExit();
+            Action = () => game.AttemptExit();
             folderButton.Action = () => storage.PresentExternally();
 
             ButtonText = "Close osu!";
diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index 06ade5a3c9..97476358b1 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -637,7 +637,7 @@ namespace osu.Game
             Add(performFromMainMenuTask = new PerformFromMenuRunner(action, validScreens, () => ScreenStack.CurrentScreen));
         }
 
-        public override void GracefullyExit()
+        public override void AttemptExit()
         {
             // Using PerformFromScreen gives the user a chance to interrupt the exit process if needed.
             PerformFromScreen(menu => menu.Exit());
diff --git a/osu.Game/OsuGameBase.cs b/osu.Game/OsuGameBase.cs
index 4a9f74d195..1385c06640 100644
--- a/osu.Game/OsuGameBase.cs
+++ b/osu.Game/OsuGameBase.cs
@@ -418,13 +418,14 @@ namespace osu.Game
         /// <summary>
         /// Use to programatically exit the game as if the user was triggering via alt-f4.
         /// By default, will keep persisting until an exit occurs (exit may be blocked multiple times).
+        /// May be interrupted (see <see cref="OsuGame"/>'s override.
         /// </summary>
-        public virtual void GracefullyExit()
+        public virtual void AttemptExit()
         {
             if (!OnExiting())
                 Exit();
             else
-                Scheduler.AddDelayed(GracefullyExit, 2000);
+                Scheduler.AddDelayed(AttemptExit, 2000);
         }
 
         public bool Migrate(string path)
diff --git a/osu.Game/Overlays/Settings/Sections/Maintenance/MigrationSelectScreen.cs b/osu.Game/Overlays/Settings/Sections/Maintenance/MigrationSelectScreen.cs
index 7e6341cd1b..c51a4db71a 100644
--- a/osu.Game/Overlays/Settings/Sections/Maintenance/MigrationSelectScreen.cs
+++ b/osu.Game/Overlays/Settings/Sections/Maintenance/MigrationSelectScreen.cs
@@ -56,7 +56,7 @@ namespace osu.Game.Overlays.Settings.Sections.Maintenance
                                 dialogOverlay.Push(new ConfirmDialog("To complete this operation, osu! will close. Please open it again to use the new data location.", () =>
                                 {
                                     (storage as OsuStorage)?.ChangeDataPath(target.FullName);
-                                    game.GracefullyExit();
+                                    game.AttemptExit();
                                 }, () => { }));
                             },
                             () => { }));

From de61b9e4109e693b96041f2ba0add55fe4e09394 Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Fri, 17 Jun 2022 22:03:04 -0700
Subject: [PATCH 5545/5547] Revert "Add automated commit to
 git-blame-ignore-revs"

This reverts commit 11bd87045ef7f18bd7cb5cf88fbd327b15f65257.
---
 .git-blame-ignore-revs | 2 --
 1 file changed, 2 deletions(-)

diff --git a/.git-blame-ignore-revs b/.git-blame-ignore-revs
index 39fa0f9f6c..8be6479043 100644
--- a/.git-blame-ignore-revs
+++ b/.git-blame-ignore-revs
@@ -1,4 +1,2 @@
 # Normalize all the line endings
 32a74f95a5c80a0ed18e693f13a47522099df5c3
-# Enabled NRT globally
-f8830c6850128456266c82de83273204f8b74ac0

From 6515b249ec92964ac2e6c7711f3d336daf3ecc69 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 19 Jun 2022 12:39:58 +0900
Subject: [PATCH 5546/5547] Change data migration to do an immediate exit,
 rather than attempted exit

---
 .../Settings/Sections/Maintenance/MigrationSelectScreen.cs      | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/Settings/Sections/Maintenance/MigrationSelectScreen.cs b/osu.Game/Overlays/Settings/Sections/Maintenance/MigrationSelectScreen.cs
index c51a4db71a..0d32e33d87 100644
--- a/osu.Game/Overlays/Settings/Sections/Maintenance/MigrationSelectScreen.cs
+++ b/osu.Game/Overlays/Settings/Sections/Maintenance/MigrationSelectScreen.cs
@@ -56,7 +56,7 @@ namespace osu.Game.Overlays.Settings.Sections.Maintenance
                                 dialogOverlay.Push(new ConfirmDialog("To complete this operation, osu! will close. Please open it again to use the new data location.", () =>
                                 {
                                     (storage as OsuStorage)?.ChangeDataPath(target.FullName);
-                                    game.AttemptExit();
+                                    game.Exit();
                                 }, () => { }));
                             },
                             () => { }));

From 495d747da55eab3cbfcc8331ffe5f6e73c6e3618 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 19 Jun 2022 13:42:45 +0200
Subject: [PATCH 5547/5547] Fix mismatching braces in comment

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

diff --git a/osu.Game/OsuGameBase.cs b/osu.Game/OsuGameBase.cs
index 1385c06640..f0f364314c 100644
--- a/osu.Game/OsuGameBase.cs
+++ b/osu.Game/OsuGameBase.cs
@@ -418,7 +418,7 @@ namespace osu.Game
         /// <summary>
         /// Use to programatically exit the game as if the user was triggering via alt-f4.
         /// By default, will keep persisting until an exit occurs (exit may be blocked multiple times).
-        /// May be interrupted (see <see cref="OsuGame"/>'s override.
+        /// May be interrupted (see <see cref="OsuGame"/>'s override).
         /// </summary>
         public virtual void AttemptExit()
         {